=============
Relion plugin
=============
This plugin provides wrappers for several programs of `RELION <https://relion.readthedocs.io/en/latest/index.html>`_ software suite.
.. image:: https://img.shields.io/pypi/v/scipion-em-relion.svg
:target: https://pypi.python.org/pypi/scipion-em-relion
:alt: PyPI release
.. image:: https://img.shields.io/pypi/l/scipion-em-relion.svg
:target: https://pypi.python.org/pypi/scipion-em-relion
:alt: License
.. image:: https://img.shields.io/pypi/pyversions/scipion-em-relion.svg
:target: https://pypi.python.org/pypi/scipion-em-relion
:alt: Supported Python versions
.. image:: https://img.shields.io/sonar/quality_gate/scipion-em_scipion-em-relion?server=https%3A%2F%2Fsonarcloud.io
:target: https://sonarcloud.io/dashboard?id=scipion-em_scipion-em-relion
:alt: SonarCloud quality gate
.. image:: https://img.shields.io/pypi/dm/scipion-em-relion
:target: https://pypi.python.org/pypi/scipion-em-relion
:alt: Downloads
**IMPORTANT NOTES!**
1. If you have imported movies with a gain file in **DM4** format, you need to **flip the gain reference upside-down** in the motion correction protocol! (`bug details <https://github.com/I2PC/xmippCore/issues/39>`_)
2. If you have provided a gain reference or defects file during movie import or motion correction and plan to run bayesian polishing, please **make sure to run first "assign optics groups" protocol for aligned movies**, specifying the gain file etc. Currently, Scipion has no other way of knowing if you have e.g. rotated the gain during motion correction. Output movies then can be used in the polishing protocol.
3. When importing EER movies, you should specify dose per single EER frame during import step. Pixel size should be the physical pixel size unless you plan to render EER on 8K grid. In the Motioncor protocol choose binning, EER fractionation and upsampling (default=1 is for 4K grid).
Installation
------------
You will need to use 3.0+ version of Scipion to be able to run these protocols. To install the plugin, you have two options:
a) Stable version
.. code-block::
scipion installp -p scipion-em-relion
b) Developer's version
* download repository
.. code-block::
git clone -b devel https://github.com/scipion-em/scipion-em-relion.git
* install
.. code-block::
scipion installp -p /path/to/scipion-em-relion --devel
- RELION sources will be downloaded and compiled automatically with the plugin, but you can also link an existing installation. Default installation path assumed is ``software/em/relion-4.0``, if you want to change it, set *RELION_HOME* in ``scipion.conf`` file to the folder where the RELION is installed.
- If you need to use CUDA different from the one used during Scipion installation (defined by *CUDA_LIB*), you can add *RELION_CUDA_LIB* variable to the config file. Optionally, you can also specify *RELION_CUDA_BIN* path for nvcc.
- If you have to use a MPI for Relion different from Scipion MPI, you can set *RELION_MPI_BIN* and *RELION_MPI_LIB* variables in the config file.
- If you want to use **2D class ranker** protocol, you need to set *RELION_ENV_ACTIVATION* that points to a conda environment which includes torch and numpy modules. Default = ``conda activate relion-python``
- If you want to use SIDESPLITTER, you need the `sidesplitter <https://github.com/scipion-em/scipion-em-sidesplitter>`_ plugin installed and *SIDESPLITTER_HOME* set properly. After that, you only need to add *--external_reconstruct* into Additional arguments field of a 3D auto-refine or multi-body job.
To check the installation, simply run one of the tests. A complete list of tests can be displayed by executing ``scipion test --show --grep relion``
Supported versions
------------------
3.1, 4.0
Protocols
---------
* 2D class ranker
* 2D classification
* 3D auto-refine
* 3D classification
* 3D initial model
* 3D multi-body
* assign optics groups
* auto-picking (reference-based)
* auto-picking LoG
* bayesian polishing
* calculate fsc
* center averages
* clean project
* compress movies
* create 3d mask
* crop / resize volumes
* ctf refinement
* estimate gain to compress
* expand symmetry
* export coordinates
* export ctf
* export particles
* import coordinates
* local resolution
* motion correction
* particles extraction
* post-processing
* preprocess particles
* reconstruct
* remove preferential views
* subtract projection
* symmetrize volume
References
----------
1. Scheres et al., JMB, 2012
2. Scheres et al., JSB, 2012
3. Kimanius et al., eLife, 2016
4. Zivanov et al., eLife, 2018
5. Kimanius et al., Biochemical Journal, 2021
Raw data
{
"_id": null,
"home_page": "https://github.com/scipion-em/scipion-em-relion",
"name": "scipion-em-relion",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "scipion electron-microscopy cryo-em structural-biology image-processing scipion-3.0",
"author": "Grigory Sharov, J.M. De la Rosa Trevin, Josue Gomez Blanco",
"author_email": "gsharov@mrc-lmb.cam.ac.uk, delarosatrevin@scilifelab.se, josue.gomez-blanco@mcgill.ca",
"download_url": "https://files.pythonhosted.org/packages/45/ee/f9474fdf21e689b4922e70333b1bb992952362a782942441ac34f037fc80/scipion-em-relion-4.0.19.tar.gz",
"platform": null,
"description": "=============\nRelion plugin\n=============\n\nThis plugin provides wrappers for several programs of `RELION <https://relion.readthedocs.io/en/latest/index.html>`_ software suite.\n\n.. image:: https://img.shields.io/pypi/v/scipion-em-relion.svg\n :target: https://pypi.python.org/pypi/scipion-em-relion\n :alt: PyPI release\n\n.. image:: https://img.shields.io/pypi/l/scipion-em-relion.svg\n :target: https://pypi.python.org/pypi/scipion-em-relion\n :alt: License\n\n.. image:: https://img.shields.io/pypi/pyversions/scipion-em-relion.svg\n :target: https://pypi.python.org/pypi/scipion-em-relion\n :alt: Supported Python versions\n\n.. image:: https://img.shields.io/sonar/quality_gate/scipion-em_scipion-em-relion?server=https%3A%2F%2Fsonarcloud.io\n :target: https://sonarcloud.io/dashboard?id=scipion-em_scipion-em-relion\n :alt: SonarCloud quality gate\n\n.. image:: https://img.shields.io/pypi/dm/scipion-em-relion\n :target: https://pypi.python.org/pypi/scipion-em-relion\n :alt: Downloads\n\n\n**IMPORTANT NOTES!**\n\n 1. If you have imported movies with a gain file in **DM4** format, you need to **flip the gain reference upside-down** in the motion correction protocol! (`bug details <https://github.com/I2PC/xmippCore/issues/39>`_)\n 2. If you have provided a gain reference or defects file during movie import or motion correction and plan to run bayesian polishing, please **make sure to run first \"assign optics groups\" protocol for aligned movies**, specifying the gain file etc. Currently, Scipion has no other way of knowing if you have e.g. rotated the gain during motion correction. Output movies then can be used in the polishing protocol.\n 3. When importing EER movies, you should specify dose per single EER frame during import step. Pixel size should be the physical pixel size unless you plan to render EER on 8K grid. In the Motioncor protocol choose binning, EER fractionation and upsampling (default=1 is for 4K grid).\n\nInstallation\n------------\n\nYou will need to use 3.0+ version of Scipion to be able to run these protocols. To install the plugin, you have two options:\n\na) Stable version\n\n .. code-block::\n\n scipion installp -p scipion-em-relion\n\nb) Developer's version\n\n * download repository\n\n .. code-block::\n\n git clone -b devel https://github.com/scipion-em/scipion-em-relion.git\n\n * install\n\n .. code-block::\n\n scipion installp -p /path/to/scipion-em-relion --devel\n\n- RELION sources will be downloaded and compiled automatically with the plugin, but you can also link an existing installation. Default installation path assumed is ``software/em/relion-4.0``, if you want to change it, set *RELION_HOME* in ``scipion.conf`` file to the folder where the RELION is installed.\n- If you need to use CUDA different from the one used during Scipion installation (defined by *CUDA_LIB*), you can add *RELION_CUDA_LIB* variable to the config file. Optionally, you can also specify *RELION_CUDA_BIN* path for nvcc.\n- If you have to use a MPI for Relion different from Scipion MPI, you can set *RELION_MPI_BIN* and *RELION_MPI_LIB* variables in the config file.\n- If you want to use **2D class ranker** protocol, you need to set *RELION_ENV_ACTIVATION* that points to a conda environment which includes torch and numpy modules. Default = ``conda activate relion-python``\n- If you want to use SIDESPLITTER, you need the `sidesplitter <https://github.com/scipion-em/scipion-em-sidesplitter>`_ plugin installed and *SIDESPLITTER_HOME* set properly. After that, you only need to add *--external_reconstruct* into Additional arguments field of a 3D auto-refine or multi-body job.\n\nTo check the installation, simply run one of the tests. A complete list of tests can be displayed by executing ``scipion test --show --grep relion``\n\nSupported versions\n------------------\n\n3.1, 4.0\n\nProtocols\n---------\n\n* 2D class ranker\n* 2D classification \n* 3D auto-refine \n* 3D classification \n* 3D initial model \n* 3D multi-body\n* assign optics groups\n* auto-picking (reference-based)\n* auto-picking LoG \n* bayesian polishing\n* calculate fsc\n* center averages\n* clean project\n* compress movies\n* create 3d mask\n* crop / resize volumes\n* ctf refinement\n* estimate gain to compress\n* expand symmetry\n* export coordinates\n* export ctf \n* export particles\n* import coordinates\n* local resolution \n* motion correction\n* particles extraction\n* post-processing \n* preprocess particles \n* reconstruct\n* remove preferential views\n* subtract projection\n* symmetrize volume\n\nReferences\n----------\n\n1. Scheres et al., JMB, 2012 \n2. Scheres et al., JSB, 2012 \n3. Kimanius et al., eLife, 2016 \n4. Zivanov et al., eLife, 2018\n5. Kimanius et al., Biochemical Journal, 2021\n\n\n",
"bugtrack_url": null,
"license": "",
"summary": "Plugin to use Relion programs within the Scipion framework",
"version": "4.0.19",
"project_urls": {
"Bug Reports": "https://github.com/scipion-em/scipion-em-relion/issues",
"Homepage": "https://github.com/scipion-em/scipion-em-relion",
"Source": "https://github.com/scipion-em/scipion-em-relion/"
},
"split_keywords": [
"scipion",
"electron-microscopy",
"cryo-em",
"structural-biology",
"image-processing",
"scipion-3.0"
],
"urls": [
{
"comment_text": "scipion-3.0",
"digests": {
"blake2b_256": "b3fd6ab88ac64afd011fa83aec6eb03fd9ead59251170afa2bd06abb52be7f49",
"md5": "ef56a737e7b7b226f4b432099e8f6556",
"sha256": "5cf1b229822c77d8ffb0767f828b9ff7e76f0832078aff8a9f80d1b4c4531bfa"
},
"downloads": -1,
"filename": "scipion_em_relion-4.0.19-py3-none-any.whl",
"has_sig": false,
"md5_digest": "ef56a737e7b7b226f4b432099e8f6556",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 318127,
"upload_time": "2024-02-26T11:32:07",
"upload_time_iso_8601": "2024-02-26T11:32:07.161530Z",
"url": "https://files.pythonhosted.org/packages/b3/fd/6ab88ac64afd011fa83aec6eb03fd9ead59251170afa2bd06abb52be7f49/scipion_em_relion-4.0.19-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "scipion-3.0",
"digests": {
"blake2b_256": "45eef9474fdf21e689b4922e70333b1bb992952362a782942441ac34f037fc80",
"md5": "e8a5678d5150bb077d5cedafa574aced",
"sha256": "6333e968115d8f34f6a5d08f90cde7de53dc78975101057fecd10b8bdd4b60f5"
},
"downloads": -1,
"filename": "scipion-em-relion-4.0.19.tar.gz",
"has_sig": false,
"md5_digest": "e8a5678d5150bb077d5cedafa574aced",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 264173,
"upload_time": "2024-02-26T11:32:09",
"upload_time_iso_8601": "2024-02-26T11:32:09.686377Z",
"url": "https://files.pythonhosted.org/packages/45/ee/f9474fdf21e689b4922e70333b1bb992952362a782942441ac34f037fc80/scipion-em-relion-4.0.19.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-02-26 11:32:09",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "scipion-em",
"github_project": "scipion-em-relion",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "scipion-em-relion"
}
JSON
