This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision Last revision Both sides next revision | ||
pipeline:movie:sxunblur [2018/02/16 10:11] 127.0.0.1 external edit |
pipeline:movie:sxunblur [2019/04/02 10:13] lusnig |
||
---|---|---|---|
Line 1: | Line 1: | ||
~~NOTOC~~ | ~~NOTOC~~ | ||
- | ====== sxunblur ====== | + | ===== sp_unblur |
- | Micrograph movie alignment: align micrograph movies with Unblur. | + | Unblur cisTEM: Align frames of micrograph movies with [[https://cistem.org/|Unblur]]. |
\\ | \\ | ||
- | ====== Usage ====== | + | ===== Usage ===== |
Usage in command line | Usage in command line | ||
- | | + | |
\\ | \\ | ||
- | ====== Typical usage ====== | + | ===== Typical usage ===== |
- | Just shift data with dose filter. | + | |
- | sxunblur.py directory_to_unblur directory/ | + | sp_unblur exists in both MPI and non-MPI versions (Running MPI version does not require |
- | Shift data with aligned sum files, and aligned frames without | + | Run unblur |
- | sxunblur.py directory_to_unblur directory/prefix*suffix.mrc output_directory --nr_frames=25 | + | mpirun -np 12 sp_unblur.py |
- | Dose filter and Expert Options and aligned frames | ||
- | sxunblur.py directory_to_unblur directory/prefix*suffix.mrc output_directory --nr_frames=25 | + | Run unblur with dose adjustment and gain reference file |
+ | |||
+ | mpirun -np 12 sp_unblur.py | ||
+ | |||
+ | |||
+ | Run unblur without dose adjustment | ||
+ | |||
+ | mpirun | ||
+ | |||
+ | Run unblur without dose adjustment and in addition with dose adjustment | ||
+ | |||
+ | mpirun | ||
\\ | \\ | ||
- | ====== Input ====== | + | ===== Input ===== |
=== Main Parameters === | === Main Parameters === | ||
- | ; input_micrograph_list_file | + | ; unblur_path |
- | ; unblur : Path to unblur executable: | + | ; input_micrograph_pattern |
- | ; input_mrc_micrograph | + | ; output_directory |
- | ; output | + | |
- | ; nr_threads | + | ; %%--%%selection_file |
- | ; nr_frames : Number of frames: | + | |
- | ; pixel_size : Pixel size [A]: (default | + | ; %%--%%pixel_size : Pixel size [A]: The pixel size of input micrographs. |
- | ; exposure_per_frame | + | ; %%--%%bin_factor |
- | ; voltage : Microscope voltage [kV]: (default 300.0) | + | |
- | ; pre_exposure : Pre exposure [e/A^2]: (default 0.0) | + | ; %%--%%voltage : Microscope voltage [kV]: The acceleration voltage of microscope used for imaging. |
+ | ; %%--%%exposure_per_frame : Per frame exposure [e/A^2]: The electron dose per frame in e/A^2. (default 1.0) : %%--%%skip_dose_adjustment==True | ||
+ | ; %%--%%pre_exposure : Pre-exposure [e/ | ||
+ | ; %%--%%additional_dose_unadjusted : Create unadjusted sums in addition: Run unblur twice to also create dose unadjusted sums. (default False) : %%--%%skip_dose_adjustment==True | ||
+ | ; %%--%%gain_file : Gain file : Gain file in case of gain uncorrected movies. (default none) | ||
\\ | \\ | ||
=== Advanced Parameters === | === Advanced Parameters === | ||
- | ; save_frames | + | ; %%--%%skip_dose_adjustment |
- | ; skip_dose_filter : Skip the dose filter | + | |
- | ; expert_mode : Set expert mode: Requires the options initial shift, shift radius, b-factor, fourier_vertical, | + | ; %%--%%min_shift_initial |
- | ; shift_initial | + | ; %%--%%outer_radius |
- | ; shift_radius | + | ; %%--%%b_factor : Apply B-factor to images [A^2]: |
- | ; b_factor : *EXPERT* | + | ; %%--%%half_width_vert : Vertical Fourier central mask size: The half-width of central vertical line of Fourier |
- | ; fourier_vertical | + | ; %%--%%half_width_hor |
- | ; fourier_horizontal | + | ; %%--%%termination |
- | ; shift_threshold | + | ; %%--%%max_iterations |
- | ; iterations | + | ; %%--%%dont_restore_noise_power |
- | ; dont_restore_noise | + | ; %%--%%first_frame |
- | ; verbose | + | ; %%--%%last_frame : Last frame: Last frame to use for sum. (default 0) |
+ | ; %%--%%distortion_angle : Distortion Angle [deg]: Distortion Angle in degrees. (default 0.0) | ||
+ | ; %%--%%major_scale : Major scale : Major scale. (default 1.0) | ||
+ | ; %%--%%minor_scale : Minor scale: Minor scale. (default 1.0) | ||
\\ | \\ | ||
- | ====== Output | + | ===== Output ===== |
- | The program creates the directory automatically | + | The program |
- | Without dosefilter: | + | \\ __Run without dose-filtering__: |
- | Sum files will be written to the "corrsum" folder. | + | |
- | Log files will be written to the "logfiles" folder | + | |
- | Aligned frames will be written to the "corrsum" folder. | + | |
- | Shift files will be written to the "shift" folder. | + | |
- | FRC files will be written to the "frc" folder. | + | |
- | With dosefilter: As without | + | \\ __Run with dose-filtering (as without |
- | Dose filtered sum files will be written to the "corrsum_dose_filtered" folder. | + | |
- | Log files will be written to the "logfiles" folder | + | |
- | Dose filtered aligned frames will be written to the "corrsum_dose_filtered" folder. | + | |
- | Shift files will be written to the "shift" folder. | + | |
- | FRC files will be written to the "frc" folder. | + | |
\\ | \\ | ||
- | ======= | + | ===== Description |
- | --- | + | |
+ | \\ | ||
+ | ==== Method | ||
+ | |||
+ | \\ | ||
+ | ==== Reference ==== | ||
+ | [[http:// | ||
+ | |||
+ | \\ | ||
+ | ==== Developer Notes ==== | ||
\\ | \\ | ||
Line 85: | Line 112: | ||
\\ | \\ | ||
==== Files ==== | ==== Files ==== | ||
- | sxunblur.py | + | sparx/ |
\\ | \\ | ||
- | ==== See Also ==== | + | ==== See also ==== |
- | sxgui_unblur.py | + | [[pipeline: |
\\ | \\ | ||
==== Maturity ==== | ==== Maturity ==== | ||
- | No bugs known so far. | + | Beta:: Under evaluation and testing. Please let us know if there are any bugs. |
\\ | \\ | ||
+ | ==== Bugs ==== | ||
+ | There are no known bugs so far. | ||
+ | |||
+ | \\ | ||
+ |