====================================
Scipion plugin for Relion Tomography
====================================
.. image:: https://img.shields.io/pypi/v/scipion-em-reliontomo.svg
:target: https://pypi.python.org/pypi/scipion-em-reliontomo
:alt: PyPI release
.. image:: https://img.shields.io/pypi/l/scipion-em-reliontomo.svg
:target: https://pypi.python.org/pypi/scipion-em-reliontomo
:alt: License
.. image:: https://img.shields.io/pypi/pyversions/scipion-em-reliontomo.svg
:target: https://pypi.python.org/pypi/scipion-em-reliontomo
:alt: Supported Python versions
.. image:: https://img.shields.io/pypi/dm/scipion-em-reliontomo
:target: https://pypi.python.org/pypi/scipion-em-reliontomo
:alt: Downloads
This plugin provide wrappers around several programs of `RELION <https://relion.readthedocs.io/en/release-5.0/index.html>`_ software suite for its use in Tomography.
Installation
------------
You will need to use `3.0 <https://scipion-em.github.io/docs/release-3.0.0/docs/scipion-modes/how-to-install.html>`_ version of Scipion to be able to run these protocols.
Protocols
-----------
VERSION 4.0:
* **Import coordinates 3D from a star file** : Protocol to import a set of 3D coordinates from a star file.
* **Import subtomograms from a star file** : Protocol to import a set of subtomograms from a star file.
* **3D Classification of subtomograms** : 3D Classification of subtomograms.
* **Tomo CTF refine** : Tomo CTF refine
* **De novo 3D initial model** : Generate a de novo 3D initial model from the pseudo-subtomograms.
* **Apply operation to Relion particles** : Operate on the particles star file.
* **Make pseudo-subtomograms** : Make pseudo-subtomograms.
* **Sharpen a 3D reference map** : Sharpen a 3D reference map and estimate the gold-standard FSC curves for subtomogram averaging.
* **Prepare data for Relion 4** : Prepare data for Relion 4
* **Reconstruct particle from tilt series** : Reconstruct particle from the original tilt series images.
* **Auto-refinement of subtomograms** : Auto-refinement of subtomograms.
* **Rec. particle averaging subtomograms** : This protocol reconstructs a volume using Relion. Reconstruct a volume from a given set of particles. The alignment parameters will be converted to a Relion star file and used as direction projections to reconstruct.
* **Tomo frame align** : Tomo frame align
* **Reconstruct tomograms from prepare data prot** : This protocol reconstructs a single tomogram using Relion. It is very useful to check if the protocol "Prepare data" has been applied correctly (in terms of flip options, for example).
VERSION 5.0:
* **Import subtomograms from a star file** : Protocol to import a set of subtomograms from a star file.
* **3D Classification of subtomograms** : 3D Classification of subtomograms.
* **Tomo CTF refine** : apply the refinement of the different parameters related to the CTF estimation.
* **De novo 3D initial model** : Generate a de novo 3D initial model from the pseudo-subtomograms.
* **Apply operation to Relion particles** : Operate on the particles star file: re-center and duplicates removal.
* **Sharpen a 3D reference map** : Sharpen a 3D reference map and estimate the gold-standard FSC curves for subtomogram averaging.
* **Extract subtomos** : extract the subtomograms from the tilt-series.
* **Reconstruct particle** : generate a reference map from a particle set by averaging the particles using their positions and orientations
* **Auto-refinement of subtomograms** : Auto-refinement of subtomograms.
* **Bayesian polishing** : refine the projections that map 3D space onto the images of the tilt series.
* **Tomogram reconstruction** : reconstruct tomograms.
* **Motion correction** : motion correction of the angular frame stacks using Relion's own implementation.
**Latest plugin versions**
==========================
If you want to check the latest version and release history go to `CHANGES <https://github.com/scipion-em-reliotomo/reliontomo/blob/master/CHANGES.txt>`_
**Installing the plugin**
=========================
In order to install the plugin follow these instructions:
.. code-block::
scipion installp -p scipion-em-reliontomo
or through the **plugin manager** by launching Scipion and following **Configuration** >> **Plugins**
**To install in development mode**
Clone or download the plugin repository
.. code-block::
git clone https://github.com/scipion-em/scipion-em-reliontomo.git
Install the plugin in developer mode.
.. code-block::
scipion installp -p local/path/to/scipion-em-reliontomo --devel
To check the installation, simply run one of the tests. A complete list of tests can be displayed by executing ``scipion3 tests --grep reliontomo --show``
Supported versions
------------------
Relion 3.0, 4.0
References
----------
1. Zivanov et al., eLife, 2022
2. Burt et al., bioRxiv, 2024
Buildbot status
---------------
Status devel version:
.. image:: http://scipion-test.cnb.csic.es:9980/badges/reliontomo_devel.svg
Status production version:
.. image:: http://scipion-test.cnb.csic.es:9980/badges/reliontomo_prod.svg
Raw data
{
"_id": null,
"home_page": "https://github.com/scipion-em/scipion-em-reliontomo",
"name": "scipion-em-reliontomo",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "scipion electron-tomography cryo-em structural-biology image-processing scipion-3.0",
"author": "CNB-CSIC",
"author_email": "jjimenez@cnb.csic.es, scipion-users@lists.sourceforge.net",
"download_url": "https://files.pythonhosted.org/packages/26/19/e86826f4ab6e3f66f5724cc7b74e6d093be8edafe84a2ec775ead36c75a2/scipion-em-reliontomo-4.0.0.tar.gz",
"platform": null,
"description": "====================================\nScipion plugin for Relion Tomography\n====================================\n\n.. image:: https://img.shields.io/pypi/v/scipion-em-reliontomo.svg\n :target: https://pypi.python.org/pypi/scipion-em-reliontomo\n :alt: PyPI release\n\n.. image:: https://img.shields.io/pypi/l/scipion-em-reliontomo.svg\n :target: https://pypi.python.org/pypi/scipion-em-reliontomo\n :alt: License\n\n.. image:: https://img.shields.io/pypi/pyversions/scipion-em-reliontomo.svg\n :target: https://pypi.python.org/pypi/scipion-em-reliontomo\n :alt: Supported Python versions\n\n.. image:: https://img.shields.io/pypi/dm/scipion-em-reliontomo\n :target: https://pypi.python.org/pypi/scipion-em-reliontomo\n :alt: Downloads\n\nThis plugin provide wrappers around several programs of `RELION <https://relion.readthedocs.io/en/release-5.0/index.html>`_ software suite for its use in Tomography.\n\n\nInstallation\n------------\n\nYou will need to use `3.0 <https://scipion-em.github.io/docs/release-3.0.0/docs/scipion-modes/how-to-install.html>`_ version of Scipion to be able to run these protocols.\n\n\nProtocols\n-----------\n\nVERSION 4.0:\n\n* **Import coordinates 3D from a star file** : Protocol to import a set of 3D coordinates from a star file.\n* **Import subtomograms from a star file** : Protocol to import a set of subtomograms from a star file.\n* **3D Classification of subtomograms** : 3D Classification of subtomograms.\n* **Tomo CTF refine** : Tomo CTF refine\n* **De novo 3D initial model** : Generate a de novo 3D initial model from the pseudo-subtomograms.\n* **Apply operation to Relion particles** : Operate on the particles star file.\n* **Make pseudo-subtomograms** : Make pseudo-subtomograms.\n* **Sharpen a 3D reference map** : Sharpen a 3D reference map and estimate the gold-standard FSC curves for subtomogram averaging.\n* **Prepare data for Relion 4** : Prepare data for Relion 4\n* **Reconstruct particle from tilt series** : Reconstruct particle from the original tilt series images.\n* **Auto-refinement of subtomograms** : Auto-refinement of subtomograms.\n* **Rec. particle averaging subtomograms** : This protocol reconstructs a volume using Relion. Reconstruct a volume from a given set of particles. The alignment parameters will be converted to a Relion star file and used as direction projections to reconstruct.\n* **Tomo frame align** : Tomo frame align\n* **Reconstruct tomograms from prepare data prot** : This protocol reconstructs a single tomogram using Relion. It is very useful to check if the protocol \"Prepare data\" has been applied correctly (in terms of flip options, for example).\n\nVERSION 5.0:\n\n* **Import subtomograms from a star file** : Protocol to import a set of subtomograms from a star file.\n* **3D Classification of subtomograms** : 3D Classification of subtomograms.\n* **Tomo CTF refine** : apply the refinement of the different parameters related to the CTF estimation.\n* **De novo 3D initial model** : Generate a de novo 3D initial model from the pseudo-subtomograms.\n* **Apply operation to Relion particles** : Operate on the particles star file: re-center and duplicates removal.\n* **Sharpen a 3D reference map** : Sharpen a 3D reference map and estimate the gold-standard FSC curves for subtomogram averaging.\n* **Extract subtomos** : extract the subtomograms from the tilt-series.\n* **Reconstruct particle** : generate a reference map from a particle set by averaging the particles using their positions and orientations\n* **Auto-refinement of subtomograms** : Auto-refinement of subtomograms.\n* **Bayesian polishing** : refine the projections that map 3D space onto the images of the tilt series.\n* **Tomogram reconstruction** : reconstruct tomograms.\n* **Motion correction** : motion correction of the angular frame stacks using Relion's own implementation.\n\n\n**Latest plugin versions**\n==========================\n\nIf you want to check the latest version and release history go to `CHANGES <https://github.com/scipion-em-reliotomo/reliontomo/blob/master/CHANGES.txt>`_\n\n\n**Installing the plugin**\n=========================\n\nIn order to install the plugin follow these instructions:\n\n.. code-block::\n\n scipion installp -p scipion-em-reliontomo\n\n\nor through the **plugin manager** by launching Scipion and following **Configuration** >> **Plugins**\n\n\n**To install in development mode**\n\nClone or download the plugin repository\n\n.. code-block::\n\n git clone https://github.com/scipion-em/scipion-em-reliontomo.git\n\nInstall the plugin in developer mode.\n\n.. code-block::\n\n scipion installp -p local/path/to/scipion-em-reliontomo --devel\n\n\nTo check the installation, simply run one of the tests. A complete list of tests can be displayed by executing ``scipion3 tests --grep reliontomo --show``\n\nSupported versions\n------------------\n\nRelion 3.0, 4.0\n\n\nReferences\n----------\n\n1. Zivanov et al., eLife, 2022\n2. Burt et al., bioRxiv, 2024\n\n\nBuildbot status\n---------------\n\nStatus devel version:\n\n.. image:: http://scipion-test.cnb.csic.es:9980/badges/reliontomo_devel.svg\n\n\nStatus production version:\n\n.. image:: http://scipion-test.cnb.csic.es:9980/badges/reliontomo_prod.svg\n\n\n\n",
"bugtrack_url": null,
"license": null,
"summary": "Plugin to use Relion programs for tomography within the Scipion framework",
"version": "4.0.0",
"project_urls": {
"Bug Reports": "https://github.com/scipion-em/scipion-em-reliontomo/issues",
"Homepage": "https://github.com/scipion-em/scipion-em-reliontomo",
"Source": "https://github.com/scipion-em/scipion-em-reliontomo/"
},
"split_keywords": [
"scipion",
"electron-tomography",
"cryo-em",
"structural-biology",
"image-processing",
"scipion-3.0"
],
"urls": [
{
"comment_text": "scipion-3.0",
"digests": {
"blake2b_256": "34f667bae301848783778f78890be04909c925a233298f57e59881cd5539ab0a",
"md5": "30e0d080fc49887b31d964eb61be58f7",
"sha256": "d29133670b699ca7358a368c08ae966152b0ff7c4479dc9b43675f708e689e07"
},
"downloads": -1,
"filename": "scipion_em_reliontomo-4.0.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "30e0d080fc49887b31d964eb61be58f7",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 182018,
"upload_time": "2024-10-03T14:02:55",
"upload_time_iso_8601": "2024-10-03T14:02:55.948431Z",
"url": "https://files.pythonhosted.org/packages/34/f6/67bae301848783778f78890be04909c925a233298f57e59881cd5539ab0a/scipion_em_reliontomo-4.0.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "scipion-3.0",
"digests": {
"blake2b_256": "2619e86826f4ab6e3f66f5724cc7b74e6d093be8edafe84a2ec775ead36c75a2",
"md5": "adcec0af3c0a4e4e15e82829fdeade77",
"sha256": "2f3ffc458ca585ed3d41f583a9c50e90cc806988045f8a97bb18f8aef6f23011"
},
"downloads": -1,
"filename": "scipion-em-reliontomo-4.0.0.tar.gz",
"has_sig": false,
"md5_digest": "adcec0af3c0a4e4e15e82829fdeade77",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 134274,
"upload_time": "2024-10-03T14:02:57",
"upload_time_iso_8601": "2024-10-03T14:02:57.463720Z",
"url": "https://files.pythonhosted.org/packages/26/19/e86826f4ab6e3f66f5724cc7b74e6d093be8edafe84a2ec775ead36c75a2/scipion-em-reliontomo-4.0.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-10-03 14:02:57",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "scipion-em",
"github_project": "scipion-em-reliontomo",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [],
"lcname": "scipion-em-reliontomo"
}