Differences

This shows you the differences between two versions of the page.

--- eyes:logics:sharpen3d [2017/06/08 15:31]
nfische [Process]
+++ eyes:logics:sharpen3d [2017/06/13 15:17] (current)
lschult
@@ Line 2: / Line 2: @@
 Map sharpening allows to correct for the contrast loss at high resolution, resulting in better interpretable maps.
 =====Usage=====
-Use this module to sharpen and subsequently low-pass filter a 3d map. Sharpening helps in interpreting the map: dependent on resolution of the map domains, secondary structure elements or side-chains will be more clearly defined. Sharpening can be either performed using a standard curve from SAXS data ("Do not use custom experimental data"; generally more conservative) or using a reference curve from another 3d volume ("Use custom experimental data"), e.g. a theoretical density computed from an atomic model. In the latter case, the pixel size of the reference must be provided. Sharpening also increases the high-resolution noise, which may impede reliable interpretation, in particular in less-well resolved regions of the map. Therefore, for homogeneously well-resolved maps subsequent filtering can performed in global mode, i.e. every part of the map is low-pass filtered to the same resolution. Heterogeneously resolved maps should be filtered in local mode, i.e. individual regions are filtered according to the respective local resolution.
+Use this module to sharpen and subsequently low-pass filter a 3d map. Sharpening helps in interpreting the map: dependent on resolution of the map domains, secondary structure elements or side-chains will be more clearly defined. Sharpening can be either performed using a standard curve from SAXS data((Gabashvili, I.S., et al. (2001). Solution Structure of the E. coli 70S Ribosome at 11.5 Å Resolution. Cell, 100(5), 537-49.))
+ ("Do not use custom experimental data"; generally more conservative) or using a reference curve from a custom 3d volume ("Use custom experimental data"), e.g. a theoretical density computed from an atomic model. In the latter case, the pixel size of the reference must be provided. Sharpening also increases the high-resolution noise, which may impede reliable interpretation, in particular in less-well resolved regions of the map. Consequently, homogeneously well-resolved maps may subsequently be filtered in global mode, i.e. every part of the map is low-pass filtered to the same resolution. Heterogeneously resolved maps may be be filtered in local mode, i.e. individual regions are filtered according to the respective local resolution.
@@ Line 9: / Line 10: @@
 |< 100% 30% >|
 ^ Parameters                 ^ Description     ^
-| Use custom experimental data  - //Do not use// | Use standard curve for sharpening  |
+|Amplitude source  - //Simulated SAXS data from ribosome// | Use standard curve for sharpening  |
-| Use custom experimental data - //Use//| Use reference curve from custom 3d volume for sharpening  |
+| Amplitude source - //Custom experimental data//| Use reference curve from custom 3d volume for sharpening  |
 | -> Experimental sampling        | Pixel size of reference 3d volume in Å|
 | Filtering mode - //global// | Low-pass filter sharpened 3d volume everywhere to the same resolution level |
@@ Line 26: / Line 27: @@
 | //Optional experimental data//  | Custom 3d volume to be used as reference for sharpening |
 | //Resolution levels// | Local resolution values ("Resolution levels" output) from [[:eyes:logics:FourierShellCorrelation]] logic |
-| //ThirdInput//  | Local resolution map ("Fourier shell correlation" output) from [[:eyes:logics:FourierShellCorrelation]] logic  |
+| //Local resolution map//  | Local resolution map ("Fourier shell correlation" output) from [[:eyes:logics:FourierShellCorrelation]] logic  |
 |< 100% 30% >|
@@ Line 38: / Line 39: @@
 | pixelSize | Pixel size in Å |
-=====Parameters=====
-===Experimental Sampling [Å]===
-The pixel size of the input “Optional experimental data” [in Angstrom]. If no experimental data input is given, this value is not used.
-===Fill filter with zeros===
-Check this checkbox to fill the filter image with zeros at indexes that are outside the important diameter. Otherwise the filter image will be filled using constant extrapolation.
-===Normalize===
-Check this checkbox to normalize the corrected 3d volume to mean 0 and sigma 10.
-===Pixel size [Å]===
-The pixel size of the input “3d volume” [in Angstrom].
-===Resolution Cutoff [px]===
-Cut off resolution in pixel (from 0 to volume radius). 0 = no cutoff
-===Resolution level [Å]===
-The target resolution level [in Angstrom]
-=====Inputs=====
-===Optional experimental data===
-Provides a reference 3d structure which is used instead of the spider x-ray curve for correction
-===3d volume===
-Provides the 3d volume to be sharpened
-=====Outputs=====
-===1d rot avg of power spec===
-d curve showing the 1d averaged power spectrum of the input 3d volume
-===Enhancement curve===
-d curve showing the 1d representation of the output “Amplitude filter”.
-===Amplitude filter===
-d volume that shows the applied sharpening filter image.
-===Amplitude Corrected 3d volume===
-Contains the corrected output 3d volume.
-==Written Header Values==
-  * **resolutionLevel** Resolution where cut off was performed
-  * **pixelSize** Pixel size of the volume
 ===== Additional Information =====
 This logic is not computationally heavy but needs a lot of RAM for execution. The biggest tested dimensions were 1024x1024x1024 which occupied roughly 12gb of RAM. If not enough RAM is available, this logic will fail to execute.