This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision Next revision Both sides next revision | ||
pipeline:window:cryolo [2019/05/14 16:33] twagner [Training] |
pipeline:window:cryolo [2019/08/29 14:04] twagner |
||
---|---|---|---|
Line 9: | Line 9: | ||
* crYOLO makes training **tolerant** -- Don't worry if you miss quite a lot particles during creation of your training set. [[: | * crYOLO makes training **tolerant** -- Don't worry if you miss quite a lot particles during creation of your training set. [[: | ||
- | In this tutorial we explain our recommended configurations for single particle and filament projects. You can find more information about supported networks and about the config file in the following articles: | + | In this tutorial we explain our recommended configurations for single particle and filament projects. You can find more information |
+ | * [[https:// | ||
* [[: | * [[: | ||
* [[: | * [[: | ||
+ | |||
+ | |||
+ | < | ||
You can find more technical details in our paper: | You can find more technical details in our paper: | ||
- | [[https://www.biorxiv.org/content/10.1101/356584v2|SPHIRE-crYOLO: A fast and accurate fully automated particle picker for cryo-EM | + | [[https://doi.org/10.1038/s42003-019-0437-z|Wagner, T. et al. SPHIRE-crYOLO |
- | ]] | + | |
+ | ---- | ||
+ | |||
+ | We are also proud that crYOLO was recommended by F1000: | ||
+ | |||
+ | //" | ||
+ | < | ||
< | < | ||
- | <a href=" | + | <a href=" |
</ | </ | ||
+ | </ | ||
+ | |||
===== Installation ===== | ===== Installation ===== | ||
Line 30: | Line 41: | ||
==== Data preparation ==== | ==== Data preparation ==== | ||
CrYOLO supports MRC, TIF and JPG files. It can work with 32 bit data, 8 bit data and 16 bit data. | CrYOLO supports MRC, TIF and JPG files. It can work with 32 bit data, 8 bit data and 16 bit data. | ||
- | It will work on original MRC files, but it will probably improve when the data are filtered. Therefore you should low-pass filter them to a reasonable level. Since Version 1.2 crYOLO can automatically do that for you. You just have to add | + | It will work on original MRC files, but it will probably improve when the data are denoised. Therefore you should low-pass filter them to a reasonable level. Since Version 1.2 crYOLO can automatically do that for you. You just have to add |
< | < | ||
" | " | ||
</ | </ | ||
+ | |||
to the model section in your config file to filter your images down to an absolute frequency of 0.1. The filtered images are saved in folder '' | to the model section in your config file to filter your images down to an absolute frequency of 0.1. The filtered images are saved in folder '' | ||
+ | |||
+ | crYOLO will automatically check if an image in full_data is available in the '' | ||
+ | |||
+ | <hidden **Alternative: | ||
+ | < | ||
+ | Since crYOLO 1.4 you can also use neural network denoising with [[: | ||
+ | |||
+ | To use JANNI' | ||
+ | |||
+ | < | ||
+ | " | ||
+ | </ | ||
+ | |||
+ | I recommend to use denoising with JANNI only together with a GPU as it is rather slow (~ 1-2 seconds per micrograph on the GPU and 10 seconds per micrograph on the CPU) | ||
+ | |||
+ | < | ||
+ | </ | ||
+ | < | ||
If you followed the installation instructions, | If you followed the installation instructions, | ||
Line 124: | Line 154: | ||
</ | </ | ||
crYOLO will automatically check if an image in full_data is available in the '' | crYOLO will automatically check if an image in full_data is available in the '' | ||
+ | |||
+ | <note tip> | ||
+ | **Alternative: | ||
+ | |||
+ | Since crYOLO 1.4 you can also use neural network denoising with [[: | ||
+ | |||
+ | To use JANNI' | ||
+ | |||
+ | < | ||
+ | " | ||
+ | </ | ||
+ | |||
+ | I recommend to use denoising with JANNI only together with a GPU as it is rather slow (~ 1-2 seconds per micrograph on the GPU and 10 seconds per micrograph on the CPU) | ||
+ | |||
+ | </ | ||
Please note the wiki entry about the [[: | Please note the wiki entry about the [[: | ||
Line 184: | Line 229: | ||
[{{ : | [{{ : | ||
+ | <note warning> | ||
Right now, **this filtering does not yet work for filaments**. | Right now, **this filtering does not yet work for filaments**. | ||
+ | </ | ||
+ | |||
Line 201: | Line 249: | ||
There are two general **[[: | There are two general **[[: | ||
=== CryoEM images === | === CryoEM images === | ||
- | For the general **[[: | + | For the general **[[: |
+ | <hidden **config.json for low-pass filtered cryo-images**> | ||
<code json config.json> | <code json config.json> | ||
{ | { | ||
Line 214: | Line 263: | ||
} | } | ||
</ | </ | ||
- | Please | + | </ |
+ | < | ||
+ | For the general model trained with **neural-network denoised cryo images** (with JANNI' | ||
+ | <hidden **config.json for neural-network denoised cryo-images**> | ||
+ | <code json config.json> | ||
+ | { | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | } | ||
+ | } | ||
+ | </ | ||
+ | |||
+ | You can download the file '' | ||
+ | </ | ||
+ | < | ||
+ | In all cases please | ||
=== Negative stain images === | === Negative stain images === | ||
For the general model for **negative stain data** please use: | For the general model for **negative stain data** please use: | ||
+ | <hidden **config.json for negative stain images**> | ||
<code json config.json> | <code json config.json> | ||
{ | { | ||
Line 229: | Line 299: | ||
} | } | ||
</ | </ | ||
+ | </ | ||
Please set the value in the //" | Please set the value in the //" | ||
Line 385: | Line 456: | ||
===== Evaluate your results ===== | ===== Evaluate your results ===== | ||
- | + | <note warning> | |
- | The evaluation tool allows you, based on your validation data, to get statistics about your training. Unfortunately, | + | Unfortunately, |
+ | </ | ||
+ | The evaluation tool allows you, based on your validation data, to get statistics about your training. | ||
If you followed the tutorial, the validation data are selected randomly. With crYOLO 1.1.0 a run file for each training is created and saved into the folder runfiles/ in your project directory. This run file contains which files were selected for validation, and you can run your evaluation as follows: | If you followed the tutorial, the validation data are selected randomly. With crYOLO 1.1.0 a run file for each training is created and saved into the folder runfiles/ in your project directory. This run file contains which files were selected for validation, and you can run your evaluation as follows: | ||
< | < | ||
Line 429: | Line 502: | ||
* // | * // | ||
* // | * // | ||
+ | * //-sr SEARCH_RANGE_FACTOR//: | ||
===== Help ===== | ===== Help ===== |