User talk:Tnakane: Difference between revisions

From Relion
Jump to navigation Jump to search
No edit summary
No edit summary
Line 5: Line 5:


Transformation by orientations and translations brings the reference into observations (i.e. particle image).
Transformation by orientations and translations brings the reference into observations (i.e. particle image).
For developers, a good starting point for code reading is <code>ObservationModel::predictObservation()</code> in [https://github.com/3dem/relion/blob/ver3.1/src/jaz/obs_model.cpp src/jaz/obs_model.cpp].


== Coordinate system ==
== Coordinate system ==
Line 29: Line 31:
== Higher order aberrations ==
== Higher order aberrations ==


<code>rlnOddZernike</code> contains coefficients for asymmetric Zernike polynomials Z<sub>1</sub><sup>-1</sup>, Z<sub>1</sub><sup>1</sup>, Z<sub>3</sub><sup>-3</sup>, Z<sub>3</sub><sup>-1</sup>, Z<sub>3</sub><sup>1</sup>, Z<sub>3</sub><sup>3</sup>, etc in this order. <code>rlnEvenZernike</code> contains coefficients for symmetric Zernike polynomials Z<sub>0</sub><sup>0</sup>, Z<sub>2</sub><sup>-2</sup>, Z<sub>2</sub><sup>0</sup>, Z<sub>2</sub><sup>2</sup>, Z<sub>4</sub><sup>-4</sup>, Z<sub>4</sub><sup>-2</sup>, Z<sub>4</sub><sup>0</sup>, Z<sub>4</sub><sup>2</sup>, Z<sub>4</sub><sup>4</sup>, etc in this order. Thus, the 7-th item in the <code>rlnEvenZernike</code>, Z<sub>4</sub><sup>0</sup>, is related to an error in the spherical aberration coefficient.
<code>rlnOddZernike</code> contains coefficients for asymmetric (antisymmetric) Zernike polynomials Z<sub>1</sub><sup>-1</sup>, Z<sub>1</sub><sup>1</sup>, Z<sub>3</sub><sup>-3</sup>, Z<sub>3</sub><sup>-1</sup>, Z<sub>3</sub><sup>1</sup>, Z<sub>3</sub><sup>3</sup>, etc in this order. <code>rlnEvenZernike</code> contains coefficients for symmetric Zernike polynomials Z<sub>0</sub><sup>0</sup>, Z<sub>2</sub><sup>-2</sup>, Z<sub>2</sub><sup>0</sup>, Z<sub>2</sub><sup>2</sup>, Z<sub>4</sub><sup>-4</sup>, Z<sub>4</sub><sup>-2</sup>, Z<sub>4</sub><sup>0</sup>, Z<sub>4</sub><sup>2</sup>, Z<sub>4</sub><sup>4</sup>, etc in this order. Thus, the 7-th item in the <code>rlnEvenZernike</code>, Z<sub>4</sub><sup>0</sup>, is related to an error in the spherical aberration coefficient.


Look at the table in Wikipedia https://en.wikipedia.org/wiki/Zernike_polynomials#Zernike_polynomials but ignore square root terms, as the coefficients are not normalised in RELION. For example, Z<sub>3</sub><sup>-1</sup> = (3r<sup>3</sup> - 2r) sin θ = 3 (k<sub>x</sub><sup>2</sup> + k<sub>y</sub><sup>2</sup>) k<sub>y</sub> - 2 k<sub>y</sub>, where k<sub>x</sub> and k<sub>y</sub> are wave-numbers in the reciprocal space (1 / Å).
Look at the table in Wikipedia https://en.wikipedia.org/wiki/Zernike_polynomials#Zernike_polynomials but ignore square root terms, as the coefficients are not normalised in RELION. For example, Z<sub>3</sub><sup>-1</sup> = (3r<sup>3</sup> - 2r) sin θ = 3 (k<sub>x</sub><sup>2</sup> + k<sub>y</sub><sup>2</sup>) k<sub>y</sub> - 2 k<sub>y</sub>, where k<sub>x</sub> and k<sub>y</sub> are wave-numbers in the reciprocal space (1 / Å).
Line 35: Line 37:
= Anisotropic magnification corrections =
= Anisotropic magnification corrections =


Transformation by anisotropic magnification brings the reference into observations (i.e. particle image).  
Transformation by anisotropic magnification brings the reference into observations (i.e. particle images) in real space. Note that stretching in real space is shrinking in reciprocal space and vice versa.


<code>rlnMagMatrix_00</code> to <code>rlnMagMatrix_11</code> represent the matrix <code>M</code> in the section 2.4 of [https://www.biorxiv.org/content/10.1101/798066v2 our preprint]. The values become larger, when the observed particle in the real space <i>looks larger</i> than the reference projection at the nominal pixel size. This also means that the true pixel size is <i>actually smaller</i> than the nominal pixel size.
<code>rlnMagMatrix_00</code> to <code>rlnMagMatrix_11</code> represent the matrix <code>M</code> in the section 2.4 of [https://www.biorxiv.org/content/10.1101/798066v2 our preprint]. The values become larger when the observed particle in the real space <i>looks larger</i> than the reference projection at the nominal pixel size. This also means that the true pixel size is <i>actually smaller</i> than the nominal pixel size.


</div>
</div>

Revision as of 16:12, 22 November 2019

This page is for drafting. DO NOT TRUST information on this page.

Orientations

Transformation by orientations and translations brings the reference into observations (i.e. particle image).

For developers, a good starting point for code reading is ObservationModel::predictObservation() in src/jaz/obs_model.cpp.

Coordinate system

In compliance with the Heymann, Chagoyen and Belnap (2005) standard RELION uses a right-handed coordinate system with orthogonal axes X, Y and Z. Right-handed rotations are called positive.

Image center

The center of rotation of a 2D image of dimensions xdim x ydim is defined by ((int)xdim/2, (int)(ydim/2)) (with the first pixel in the upper left being (0,0). Note that for both xdim=ydim=65 and for xdim=ydim=64, the center will be at (32,32). This is the same convention as used in SPIDER and XMIPP. Origin offsets reported for individual images translate the image to its center and are to be applied BEFORE rotations. This is confusing, because stored rlnOriginX/Y are from the reference to particles and applied AFTER projection...

Euler angle definitions

Euler angle definitions are according to the Heymann, Chagoyen and Belnap (2005) standard:

* The first rotation is denoted by phi or rot and is around the Z-axis.
* The second rotation is called theta or tilt and is around the new Y-axis.
* The third rotation is denoted by psi and is around the new Z axis

As such, RELION uses the same Euler angles as XMIPP, SPIDER and FREALIGN.

Contrast Transfer Function

CTF parameters are defined as in CTFFIND3, also see the publication by Mindell et al (2003).

Higher order aberrations

rlnOddZernike contains coefficients for asymmetric (antisymmetric) Zernike polynomials Z1-1, Z11, Z3-3, Z3-1, Z31, Z33, etc in this order. rlnEvenZernike contains coefficients for symmetric Zernike polynomials Z00, Z2-2, Z20, Z22, Z4-4, Z4-2, Z40, Z42, Z44, etc in this order. Thus, the 7-th item in the rlnEvenZernike, Z40, is related to an error in the spherical aberration coefficient.

Look at the table in Wikipedia https://en.wikipedia.org/wiki/Zernike_polynomials#Zernike_polynomials but ignore square root terms, as the coefficients are not normalised in RELION. For example, Z3-1 = (3r3 - 2r) sin θ = 3 (kx2 + ky2) ky - 2 ky, where kx and ky are wave-numbers in the reciprocal space (1 / Å).

Anisotropic magnification corrections

Transformation by anisotropic magnification brings the reference into observations (i.e. particle images) in real space. Note that stretching in real space is shrinking in reciprocal space and vice versa.

rlnMagMatrix_00 to rlnMagMatrix_11 represent the matrix M in the section 2.4 of our preprint. The values become larger when the observed particle in the real space looks larger than the reference projection at the nominal pixel size. This also means that the true pixel size is actually smaller than the nominal pixel size.