Differences
This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision | ||
eyes:logics:angularreconstitution [2017/06/08 16:28] vzinch [Modes] |
eyes:logics:angularreconstitution [2017/06/12 18:41] jschlie1 |
||
---|---|---|---|
Line 1: | Line 1: | ||
====== AngularReconstitution ====== | ====== AngularReconstitution ====== | ||
- | THIS position should be used for a brief introduction (max 2 sentences!) of the logic, stating WHAT and WHY it is doing something. | + | This logic determines Euler angles for a given set of input images based on the common line theorem. This is needed in order to correctly place images (2D projections) in 3D space prior to reconstruction. |
===== Usage ===== | ===== Usage ===== | ||
- | Here, a general/generic description of HOW the logic is USED should be given. Try to be as general as possible, but also mention prerequisites, restrictions, advantages, requirements which are specific of this logic. Basically everything the user needs to know to successfully use this logic. | + | The input of this logic - class averages - should be of high quality with enough visible structural features. Choosing more class averages for this logic is not always a good idea, since similar views will result in worse angular assignment. So ideally class averages chosen should represent all possible distinct views, but without overlapping. If symmetry of the particle is known in advance, it is recommended to try running reconstitution both with and without applying symmetry restraints. Most modes of this logic only require one input (a stack of images) and generate only one output. Therefore, only divergent I/O information is mentioned below. |
- | + | ||
- | ===== Example ==== | + | |
- | Here, a very specific example should be given/described. In the future, this can be supported by screenshots etc.. For the moment, give an example easy enough for the user to understand, but specific enough to elaborate why a given parameter is a good set for this very situation. | + | |
===== Modes ===== | ===== Modes ===== | ||
==== Euler ==== | ==== Euler ==== | ||
- | Here, a short introduction for the given mode should be placed. Again, state WHAT and WHY this mode us useful in not more than 2 sentences. | + | This mode is used for de-novo assignment of angles only from the input projections themselves. The output stack of images contains the assigned Euler angles as header values. |
|< 100% 30% >| | |< 100% 30% >| | ||
^ Parameters ^ Description ^ | ^ Parameters ^ Description ^ | ||
- | | Some changeable parameter | Description of this parameter | | + | | Sinograms | Gives options to read already generated sinograms or to write down sinograms for the images being processed | |
- | | -> and its sub-parameter | more description | | + | | Symmetry | Symmetry of the particle (if known) | |
- | | Next main parameter | and more more more | | + | |
- | | -> and its sub-parameter | ... descriptions | | + | |
- | + | ||
- | |< 100% 30% >| | + | |
- | ^ Input ^ Description ^ | + | |
- | | FirstInput | Input Description 1 | | + | |
- | | SecondInput | Input Description 2 | | + | |
- | | //ThirdInput// | Input Description 3: Optional Input in Italic | | + | |
- | + | ||
- | |< 100% 30% >| | + | |
- | ^ Output ^ Description ^ | + | |
- | | FirstOutput | Output Description | | + | |
- | + | ||
- | |< 100% 30% >| | + | |
- | ^ New/Changed Header Values ^ Description ^ | + | |
- | | headerValue1 | what does it say? how is it changed? | | + | |
- | | headerValue2 | what does it say? how is it changed? | | + | |
- | | headerValue3 | what does it say? how is it changed? | | + | |
- | | headerValue4 | what does it say? how is it changed? | | + | |
==== Anchor set ==== | ==== Anchor set ==== | ||
- | This logic determines the angles | + | This logic determines the angles of stack of projections if the set with known angular relations is available (e.g. 3D model from already performed angular reconstitution) |
|< 100% 30% >| | |< 100% 30% >| | ||
^ Parameters ^ Description ^ | ^ Parameters ^ Description ^ | ||
- | | Symmetry | Symmetry of the complex studied (if known) | | + | | Symmetry | Symmetry of the particle (if known) | |
|< 100% 30% >| | |< 100% 30% >| | ||
Line 47: | Line 24: | ||
| In | Image or stack of images (a set of class averages)| | | In | Image or stack of images (a set of class averages)| | ||
| Anchor set | Projection set with known angular relations (mostly projected 3D-model) | | | Anchor set | Projection set with known angular relations (mostly projected 3D-model) | | ||
- | |||
- | |< 100% 30% >| | ||
- | ^ Output ^ Description ^ | ||
- | | Out | The input projections with assigned Euler angles | | ||
- | |||
- | |< 100% 30% >| | ||
- | ^ New/Changed Header Values ^ Description ^ | ||
- | | headerValue1 | what does it say? how is it changed? | | ||
- | | headerValue2 | what does it say? how is it changed? | | ||
- | | headerValue3 | what does it say? how is it changed? | | ||
- | | headerValue4 | what does it say? how is it changed? | | ||
==== Add projection ==== | ==== Add projection ==== | ||
Line 64: | Line 30: | ||
|< 100% 30% >| | |< 100% 30% >| | ||
^ Parameters ^ Description ^ | ^ Parameters ^ Description ^ | ||
- | | Symmetry | Symmetry of the complex studied (if known) | | + | | Symmetry | Symmetry of the particle (if known) | |
|< 100% 30% >| | |< 100% 30% >| | ||
Line 70: | Line 36: | ||
| In | Image or stack of images (a set of class averages)| | | In | Image or stack of images (a set of class averages)| | ||
| Dataset | Stack of images (projections) with assigned Euler angles | | | Dataset | Stack of images (projections) with assigned Euler angles | | ||
- | |||
- | |< 100% 30% >| | ||
- | ^ Output ^ Description ^ | ||
- | | Out | The input dataset with added input projections with assigned Euler angles | | ||
- | |||
- | |< 100% 30% >| | ||
- | ^ New/Changed Header Values ^ Description ^ | ||
- | | headerValue1 | what does it say? how is it changed? | | ||
- | | headerValue2 | what does it say? how is it changed? | | ||
- | | headerValue3 | what does it say? how is it changed? | | ||
- | | headerValue4 | what does it say? how is it changed? | | ||
==== Sinograms ==== | ==== Sinograms ==== | ||
Line 87: | Line 42: | ||
|< 100% 30% >| | |< 100% 30% >| | ||
^ Parameters ^ Description ^ | ^ Parameters ^ Description ^ | ||
- | | Symmetry | Symmetry of the complex studied (if known) | | + | | Symmetry | Symmetry of the particle (if known) | |
- | |< 100% 30% >| | ||
- | ^ Input ^ Description ^ | ||
- | | In | Image or stack of images | | ||
- | |||
- | |< 100% 30% >| | ||
- | ^ Output ^ Description ^ | ||
- | | Out | Sinogram | | ||
- | |||
- | |< 100% 30% >| | ||
- | ^ New/Changed Header Values ^ Description ^ | ||
- | | headerValue1 | what does it say? how is it changed? | | ||
- | | headerValue2 | what does it say? how is it changed? | | ||
- | | headerValue3 | what does it say? how is it changed? | | ||
- | | headerValue4 | what does it say? how is it changed? | | ||
===== Concept ===== | ===== Concept ===== | ||
- | In this paragraph, the "HOW a logic works under the hood" and WHY someone should use it can be elaborated with higher detail. Describes a scenario in an image processing workflow where this logic can be used to solve the resulting problem. Also, wikipages, publications or anything else describing the theory behind an algorithm should be linked here, if applicable. | + | This logic is needed as an intermediate step to get from 2D images to a 3D volume. In order to reconstruct the full volume we need to know the relationship between the images (projections) we have - how they are located in 3D relative to each other. |
+ | In case any reference model for the particle is available, it can be used as 'anchor set' that would increase the precision of the output. | ||
+ | However, when no prior model is available for the particles of interest, determination of [[https://en.wikipedia.org/wiki/Euler_angles|Euler angles]] should be done de novo. This logic does it based on [[http://www.sciencedirect.com/science/article/pii/0304399187900787|Common line theorem]]. |