User Tools

Site Tools


pipeline:utilities:sxpipe_restacking

Differences

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

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
Last revision Both sides next revision
pipeline:utilities:sxpipe_restacking [2018/08/22 11:39]
fmerino
pipeline:utilities:sxpipe_restacking [2019/04/02 10:59]
lusnig [Output]
Line 1: Line 1:
 ~~NOTOC~~ ~~NOTOC~~
  
-===== sxpipe restacking =====+===== sp_pipe restacking =====
 Restacking: Generate all necessary information to restack the input stack (i.e., particle image ID list, CTF parameters list, projection parameters list) while appling micrograph selection list. Optionally, the command can directly output the virtual stack.  In addition, this command can be used to generate all parameters files for reboxing (i.e. original/centered particle coordinates list files, CTF parameters list, original/centered projection parameters list as well as micrograph selection file). Optionally, user can provided a 3D shift to recenter the projection parameters and so the particle coordinates. Restacking: Generate all necessary information to restack the input stack (i.e., particle image ID list, CTF parameters list, projection parameters list) while appling micrograph selection list. Optionally, the command can directly output the virtual stack.  In addition, this command can be used to generate all parameters files for reboxing (i.e. original/centered particle coordinates list files, CTF parameters list, original/centered projection parameters list as well as micrograph selection file). Optionally, user can provided a 3D shift to recenter the projection parameters and so the particle coordinates.
  
Line 9: Line 9:
 Usage in command line Usage in command line
  
-  sxpipe.py  restacking  input_bdb_stack_path  output_directory  --selection_list=FILE_PATH  --shift3d_x=SHIFT3D_X  --shift3d_y=SHIFT3D_Y  --shift3d_z=SHIFT3D_Z  --save_vstack  --sv_vstack_basename=BASENAME  --reboxing  --rb_box_size=BOX_SIZE+  sp_pipe.py  restacking  input_bdb_stack_path  output_directory  --selection_list=FILE_PATH  --shift3d_x=SHIFT3D_X  --shift3d_y=SHIFT3D_Y  --shift3d_z=SHIFT3D_Z  --save_vstack  --sv_vstack_basename=BASENAME  --reboxing  --rb_box_size=BOX_SIZE
  
 \\ \\
 ===== Typical usage ===== ===== Typical usage =====
  
-sxpipe restacking does not support MPI. +sp_pipe restacking does not support MPI. 
  
 Do restacking to generate the virtual stack of only particle images associated to the micrographs in the selection list. Do restacking to generate the virtual stack of only particle images associated to the micrographs in the selection list.
  
-  sxpipe.py restacking 'bdb:outdir_window#data' 'outdir_pipe_restacking' --selection_list='micrograph_selection_list.txt' --save_vstack --sv_vstack_basename='vstack_selected'+  sp_pipe.py restacking 'bdb:outdir_window#data' 'outdir_pipe_restacking' --selection_list='micrograph_selection_list.txt' --save_vstack --sv_vstack_basename='vstack_selected'
  
 Generate the reboxing information of all particle images in the input stack. Generate the reboxing information of all particle images in the input stack.
  
-  sxpipe.py restacking 'bdb:outdir_window#data' 'outdir_pipe_restacking' --shift3d_z=20 --reboxing --rb_box_size=352+  sp_pipe.py restacking 'bdb:outdir_window#data' 'outdir_pipe_restacking' --shift3d_z=20 --reboxing --rb_box_size=352
  
 Generate the reboxing information of only particle images associated to the micrographs in the selection list. Generate the reboxing information of only particle images associated to the micrographs in the selection list.
  
-  sxpipe.py restacking 'bdb:outdir_window#data' 'outdir_pipe_restacking' --selection_list='micrograph_selection_list.txt' --shift3d_z=20 --reboxing --rb_box_size=352+  sp_pipe.py restacking 'bdb:outdir_window#data' 'outdir_pipe_restacking' --selection_list='micrograph_selection_list.txt' --shift3d_z=20 --reboxing --rb_box_size=352
  
 Do both restacking and reboxing to generate both the virtual stack and reboxing information of only particle images associated to the micrographs in the selection list. Do both restacking and reboxing to generate both the virtual stack and reboxing information of only particle images associated to the micrographs in the selection list.
  
-  sxpipe.py restacking 'bdb:outdir_window#data' 'outdir_pipe_restacking' --selection_list='micrograph_selection_list.txt' --save_vstack --sv_vstack_basename='vstack_selected' --shift3d_z=20 --reboxing --rb_box_size=352+  sp_pipe.py restacking 'bdb:outdir_window#data' 'outdir_pipe_restacking' --selection_list='micrograph_selection_list.txt' --save_vstack --sv_vstack_basename='vstack_selected' --shift3d_z=20 --reboxing --rb_box_size=352
  
 \\ \\
Line 43: Line 43:
   ; %%--%%shift3d_z : 3D z-shift [Pixels]: 3D z-shift value. (default 0)   ; %%--%%shift3d_z : 3D z-shift [Pixels]: 3D z-shift value. (default 0)
   ; %%--%%save_vstack : Save virtual stack: Use this option to save the virtual stack. By default, the virtual stack will not be generated. (default False)   ; %%--%%save_vstack : Save virtual stack: Use this option to save the virtual stack. By default, the virtual stack will not be generated. (default False)
-  ; %%--%%sv_vstack_basename : Virtual stack basename: For %%--%%save_vstack, specify the basename of output virtual stack file. It cannot be empty string or only white spaces. (default vstack)+  ; %%--%%sv_vstack_basename : Virtual stack basename: For %%--%%save_vstack, specify the basename of output virtual stack file. It cannot be empty string or only white spaces. (default vstack) : %%--%%save_vstack==True
   ; %%--%%reboxing : Generate reboxing information: Prepare reboxing by extracting coordinates from the input stack headers, then center them according to projection parameters in the header and user-provided 3D shift. If the headers do not contain projection parameters, the program assumes the prjection parameters are all zeros (null alignment). (default False)   ; %%--%%reboxing : Generate reboxing information: Prepare reboxing by extracting coordinates from the input stack headers, then center them according to projection parameters in the header and user-provided 3D shift. If the headers do not contain projection parameters, the program assumes the prjection parameters are all zeros (null alignment). (default False)
-  ; %%--%%rb_box_size : Particle box size [Pixels]: For %%--%%reboxing option, specify the x and y dimensions of square area to be windowed. (default 0)+  ; %%--%%rb_box_size : Particle box size [Pixels]: For %%--%%reboxing option, specify the x and y dimensions of square area to be windowed. (default 0) : %%--%%reboxing==True
  
 \\ \\
Line 54: Line 54:
 === List of output Files === === List of output Files ===
 || **File Name** || **Discription** || || **File Name** || **Discription** ||
-|| micrographs_in_input_stack.txt || Micrograph selection text file containing the list of micrograph basenames extracted from the input stack. This file can be used as micrograph selection text file of [[pipeline:cter:sxcter|sxcter]], [[pipeline:cter:sxgui_cter|sxgui_cter]], [[pipeline:window:sxwindow|sxwindow]], and [[pipeline:utilities:sxpipe_organize_micrographs|sxpipe organize_micrographs]]. || +|| micrographs_in_input_stack.txt || Micrograph selection text file containing the list of micrograph basenames extracted from the input stack. This file can be used as micrograph selection text file of [[pipeline:cter:sxcter|sp_cter]], [[pipeline:cter:sxgui_cter|sp_gui_cter]], [[pipeline:window:sxwindow|sp_window]], and [[pipeline:utilities:sxpipe_organize_micrographs|sp_pipe organize_micrographs]]. || 
-|| micrographs_in_output_dataset.txt || Micrograph selection text file containing the list of micrograph in the output dataset. This file can be used as micrograph selection text file of [[pipeline:cter:sxcter|sxcter]], [[pipeline:cter:sxgui_cter|sxgui_cter]], [[pipeline:window:sxwindow|sxwindow]], and [[pipeline:utilities:sxpipe_organize_micrographs|sxpipe organize_micrographs]]. ||+|| micrographs_in_output_dataset.txt || Micrograph selection text file containing the list of micrograph in the output dataset. This file can be used as micrograph selection text file of [[pipeline:cter:sxcter|sp_cter]], [[pipeline:cter:sxgui_cter|sp_gui_cter]], [[pipeline:window:sxwindow|sp_window]], and [[pipeline:utilities:sxpipe_organize_micrographs|sp_pipe organize_micrographs]]. ||
 || input_stack_particle_id_for_output_dataset.txt || Particle selection text file containing the list of particle image IDs used for generating the output dataset from the input stack. This file can be used as particle selection list text file of [[pipeline:utilities:e2bdb|e2bdb]]. || || input_stack_particle_id_for_output_dataset.txt || Particle selection text file containing the list of particle image IDs used for generating the output dataset from the input stack. This file can be used as particle selection list text file of [[pipeline:utilities:e2bdb|e2bdb]]. ||
-|| ctf_params_for_output_dataset.txt || CTF parameters text file containing CTF parameters of all particle images in the output dateset. This projection parameters can be used as inputs of [[pipeline:window:sxwindow|sxwindow]] or imported to the reboxed stack using [[pipeline:utilities:sxheader|sxheader]]. || +|| ctf_params_for_output_dataset.txt || CTF parameters text file containing CTF parameters of all particle images in the output dateset. This projection parameters can be used as inputs of [[pipeline:window:sp_window|sp_window]] or imported to the reboxed stack using [[pipeline:utilities:sp_header|sp_header]]. || 
-|| original_proj_params_for_output_dataset.txt || Projection parameters text file containing **original** projection parameters of all particle images in the output dateset. This projection parameters can be imported to the reboxed stack using [[pipeline:utilities:sxheader|sxheader]]. || +|| original_proj_params_for_output_dataset.txt || Projection parameters text file containing **original** projection parameters of all particle images in the output dateset. This projection parameters can be imported to the reboxed stack using [[pipeline:utilities:sp_header|sp_header]]. || 
-|| centered_proj_params_for_output_dataset.txt || Projection parameters text file containing **centered** projection parameters of all particle images in the output dateset. This projection parameters can be imported to the reboxed stack using [[pipeline:utilities:sxheader|sxheader]]. || +|| centered_proj_params_for_output_dataset.txt || Projection parameters text file containing **centered** projection parameters of all particle images in the output dateset. This projection parameters can be imported to the reboxed stack using [[pipeline:utilities:sp_header|sp_header]]. || 
-|| original/${MICROGRAPH_ROOTNAME}_original.box || The list of original coordinates stored in the headers of particle images in the stack. These files can be used as inputs of [[pipeline:window:sxwindow|sxwindow]]. || +|| original/${MICROGRAPH_ROOTNAME}_original.box || The list of original coordinates stored in the headers of particle images in the stack. These files can be used as inputs of [[pipeline:window:sp_window|sp_window]]. || 
-|| centered/${MICROGRAPH_ROOTNAME}_centered.box || The list of centered (or transformed) coordinates. These files can be used as inputs of [[pipeline:window:sxwindow|sxwindow]]. || +|| centered/${MICROGRAPH_ROOTNAME}_centered.box || The list of centered (or transformed) coordinates. These files can be used as inputs of [[pipeline:window:sp_window|sp_window]]. || 
-|| EMAN2DB/${VSTACK_BASENAME}.dbd || The output virtual stack. This stack can be directly used as input stack of [[pipeline:meridien:sxmeridien|sxmeridien]] local refinement. ||+|| EMAN2DB/${VSTACK_BASENAME}.dbd || The output virtual stack. This stack can be directly used as input stack of [[pipeline:meridien:sp_meridien|sp_meridien]] local refinement. ||
  
 \\ \\
Line 106: Line 106:
 \\ \\
 ==== Files ==== ==== Files ====
-sparx/bin/sxpipe.py+sparx/bin/sp_pipe.py
  
 \\ \\
 ==== See also ==== ==== See also ====
-[[pipeline:window:sxwindow|sxwindow]], [[pipeline:cter:sxcter|sxcter]], [[pipeline:cter:sxgui_cter|sxgui_cter]], [[pipeline:utilities:sxpipe_organize_micrographs|sxpipe organize_micrographs]], [[pipeline:utilities:e2bdb|e2bdb]], and [[pipeline:meridien:sxmeridien|sxmeridien]].+[[pipeline:window:sxwindow|sp_window]], [[pipeline:cter:sxcter|sp_cter]], [[pipeline:cter:sxgui_cter|sp_gui_cter]], [[pipeline:utilities:sxpipe_organize_micrographs|sxpipe organize_micrographs]], [[pipeline:utilities:e2bdb|e2bdb]], and [[pipeline:meridien:sxmeridien|sp_meridien]].
  
 \\ \\
Line 121: Line 121:
  
 \\ \\
 +
pipeline/utilities/sxpipe_restacking.txt · Last modified: 2019/04/02 10:59 by lusnig