User Tools

Site Tools


pipeline:window:cryolo:picking_filaments

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
pipeline:window:cryolo:picking_filaments [2019/09/18 10:19]
twagner [5. Picking]
pipeline:window:cryolo:picking_filaments [2020/06/05 09:04]
twagner
Line 1: Line 1:
 +<note important>
 +
 +**DOCUMENTATION OUTDATED**
 +
 +The documentation has moved to https://cryolo.readthedocs.io
 +
 +</note>
 +
 ===== Picking filaments - Using a model trained for your data ===== ===== Picking filaments - Using a model trained for your data =====
-When picking filaments, it is important to identify each filament individually. This allows to place the boxes a specific distance apart (i.e., the helical rise) to maximize the number of particles. crYOLO supports this method of picking filaments.+When picking filaments, it is important to identify each filament individually. This allows specific spacing of the boxes (i.e., the helical rise) to maximize the number of particles. CrYOLO supports this method of picking filaments.
  
 Filament mode on actin: Filament mode on actin:
Line 9: Line 17:
  
 {{:pipeline:window:filament_tracing_02.png?300|}}  {{:pipeline:window:filament_tracing_03.png?300|}} {{:pipeline:window:filament_tracing_02.png?300|}}  {{:pipeline:window:filament_tracing_03.png?300|}}
- 
-If you followed the installation instructions, you now have to activate the crYOLO virtual environment with 
- 
-<code> 
-source activate cryolo 
-</code> 
  
  
Line 22: Line 24:
 The first step is to create the training data for your model. Right now, you have to use the e2helixboxer.py for this: The first step is to create the training data for your model. Right now, you have to use the e2helixboxer.py for this:
 <code> <code>
-e2helixboxer.py --gui my_images/*.mrc+e2helixboxer.py --gui train_image/*.mrc
 </code> </code>
  
-After tracing your training data in e2helixboxer, export them using //File -> Save//. Make sure that you export particle coordinates, as this the only format supported right now (see screenshot). In the following example, it is expected that you exported into a folder called "train_annotation".+After tracing your training data in e2helixboxer, export them using //File -> Save//Unfortunately you have to do that with each image separately. 
 + 
 +<note important> 
 +**Adapt the file saving options** 
 + 
 +Make sure that you uncheck the boxes "Write Helices" and "Particle Images" and check the box "Particle Coordinates", as this the only format supported right now (see screenshot). Also remove the "_helix_ptcl_coords" suffix in the path field. The coordinate files have to have the same name as the micrographs. 
 +</note> 
 + 
 +In the following example, it is expected that you exported into a folder called "train_annot".
  
 For projects with roughly 20 filaments per image we successfully trained on 40 images (=> 800 filaments).  For projects with roughly 20 filaments per image we successfully trained on 40 images (=> 800 filaments). 
  
 ==== 2. Start crYOLO ==== ==== 2. Start crYOLO ====
 +If you followed the installation instructions, you now have to activate the crYOLO virtual environment with
 +
 +<code>
 +source activate cryolo
 +</code>
 +
 {{page>pipeline:window:cryolo:start_cryolo}} {{page>pipeline:window:cryolo:start_cryolo}}
  
Line 39: Line 55:
 <html> <html>
 <div style="background-color: #cfc ; padding: 10px; border: 1px solid green;">  <div style="background-color: #cfc ; padding: 10px; border: 1px solid green;"> 
-<b>&#9658; You can now press the [Start] button to create you configuration file. </b>+<b>&#9658; You can now press the [Start] button to create your configuration file. </b>
 </div> </div>
 </html> </html>
  
 +<html>
 +<div style="background-color: LightCyan ; padding: 10px; border: 1px solid Black;"> 
 +<b>Alternative: Create the configuration file using the command line </b>
 +</div>
 +</html>
  
 {{page>pipeline:window:cryolo:configuration_cmdl_normal}} {{page>pipeline:window:cryolo:configuration_cmdl_normal}}
 +<html>
 +<div style="background-color: LightCyan ; padding: 10px; border: 1px solid Black;"> 
 +<b> </b>
 +</div>
 +</html>
 +
 ==== 4. Training ==== ==== 4. Training ====
  
Line 50: Line 77:
 ==== 5. Picking ==== ==== 5. Picking ====
 Select the action prediction and fill all arguments in the “Required arguments” tab:  Select the action prediction and fill all arguments in the “Required arguments” tab: 
-{{ :pipeline:window:cryolo:cryolo_prediction.png?600 |}}+ 
 +{{ :pipeline:window:cryolo:cryolo_prediction_202003.png?700 |}}
  
 Now select the "Filament options" tab and check "Activate filament mode", specifiy the filament width (e.g. 100) and define the box distance (e.g. 20 for 90% overlap when using a box size if 200): Now select the "Filament options" tab and check "Activate filament mode", specifiy the filament width (e.g. 100) and define the box distance (e.g. 20 for 90% overlap when using a box size if 200):
  
-{{ :pipeline:window:cryolo_filament.png?700 |}}+{{ :pipeline:window:cryolo:cryolo_filament_202003.png?700 |}} 
 + 
 +The directory ''output_boxes'' will be created and all results are saved there. The format is the eman2 helix format with particle coordinates.  
 +<note info> 
 +**Import into Relion** 
 + 
 +You can find a detailed description [[:cryolo_filament_import_relion|how to import crYOLO filament coordinates into Relion here]]. 
 +</note>
  
  
Line 63: Line 98:
 </html> </html>
  
-The directory ''output_boxes'' will be created and all results are saved there. The format is the eman2 helix format with particle coordinates. +<html> 
 +<div style="background-color: LightCyan ; padding: 10px; border: 1px solid Black;">  
 +<b> Alternative: Run prediction in commmand line</b> 
 +</div> 
 +</html>
  
-You can find a detailed description [[:cryolo_filament_import_relion|how to import crYOLO filament coordinates into Relion here]]. +<hidden>
- +
-<hidden **Alternative:** Run prediction in commmand line>+
 Let's assume you want to pick a filament with a width of 100 pixels (-fw 100). The box size is 200x200 and you want a 90% overlap (-bd 20). Moreover, you wish that each filament has at least 6 boxes (-mn 6). The micrographs are in the ''full_data'' directory. Than the picking command would be: Let's assume you want to pick a filament with a width of 100 pixels (-fw 100). The box size is 200x200 and you want a 90% overlap (-bd 20). Moreover, you wish that each filament has at least 6 boxes (-mn 6). The micrographs are in the ''full_data'' directory. Than the picking command would be:
 <code> <code>
-cryolo_predict.py -c cryolo_config.json -w cryolo_model.h5 -i full_data --filament -fw 100 -bd 20 -o boxes/ -g 0 -mn 6+cryolo_predict.py -c config_cryolo.json -w cryolo_model.h5 -i full_data --filament -fw 100 -bd 20 -o boxes/ -g 0 -mn 6
 </code> </code>
 </hidden> </hidden>
 +<html>
 +<div style="background-color: LightCyan ; padding: 10px; border: 1px solid Black;"> 
 +<b> </b>
 +</div>
 +</html>
  
  
pipeline/window/cryolo/picking_filaments.txt · Last modified: 2020/06/05 09:04 by twagner