Metadata-Version: 2.1
Name: scipion-em-fsc3d
Version: 3.2.2
Summary: Plugin to use 3DFSC within the Scipion framework
Home-page: https://github.com/scipion-em/scipion-em-fsc3d
Author: Grigory Sharov
Author-email: sharov.grigory@gmail.com
Project-URL: Bug Reports, https://github.com/scipion-em/scipion-em-fsc3d/issues
Project-URL: Source, https://github.com/scipion-em/scipion-em-fsc3d/
Keywords: scipion electron-microscopy cryo-em structural-biology image-processing scipion-3.0
Classifier: Development Status :: 5 - Production/Stable
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Programming Language :: Python :: 3
License-File: LICENSE
Requires-Dist: scipion-em

============
FSC3D plugin
============

This plugin provides a wrapper for `3DFSC <https://github.com/nysbc/Anisotropy/>`_ program developed at Salk Institute and NYSBC.

.. image:: https://img.shields.io/pypi/v/scipion-em-fsc3d.svg
        :target: https://pypi.python.org/pypi/scipion-em-fsc3d
        :alt: PyPI release

.. image:: https://img.shields.io/pypi/l/scipion-em-fsc3d.svg
        :target: https://pypi.python.org/pypi/scipion-em-fsc3d
        :alt: License

.. image:: https://img.shields.io/pypi/pyversions/scipion-em-fsc3d.svg
        :target: https://pypi.python.org/pypi/scipion-em-fsc3d
        :alt: Supported Python versions

.. image:: https://img.shields.io/sonar/quality_gate/scipion-em_scipion-em-fsc3d?server=https%3A%2F%2Fsonarcloud.io
        :target: https://sonarcloud.io/dashboard?id=scipion-em_scipion-em-fsc3d
        :alt: SonarCloud quality gate

.. image:: https://img.shields.io/pypi/dm/scipion-em-fsc3d
        :target: https://pypi.python.org/pypi/scipion-em-fsc3d
        :alt: Downloads


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-fsc3d

b) Developer's version

   * download repository

    .. code-block::

        git clone -b devel https://github.com/scipion-em/scipion-em-fsc3d.git

   * install

    .. code-block::

       scipion installp -p /path/to/scipion-em-fsc3d --devel

FSC3D software will be installed automatically with the plugin but you can also use an existing installation by providing *FSC3D_HOME* (see below).

**Important:** you need to have conda (miniconda3 or anaconda3) pre-installed to use this program.

Configuration variables
-----------------------
*CONDA_ACTIVATION_CMD*: If undefined, it will rely on conda command being in the
PATH (not recommended), which can lead to execution problems mixing scipion
python with conda ones. One example of this could can be seen bellow but
depending on your conda version and shell you will need something different:
CONDA_ACTIVATION_CMD = eval "$(/extra/miniconda3/bin/conda shell.bash hook)"

*FSC3D_HOME* (default = software/em/fsc3D-3.0):
Path where the 3DFSC is installed.

*FSC3D_ENV_ACTIVATION* (default = conda activate fsc3D-3.0):
Command to activate the 3DFSC environment.


Verifying
---------
To check the installation, simply run the following Scipion test:

``scipion test fsc3d.tests.test_protocols_3dfsc.Test3DFSC``

Supported versions
------------------

3.0 (modified for Scipion, see https://github.com/azazellochg/fsc3D)

Protocols
----------

* resolution estimation

References
-----------

1.  Yong Zi Tan, Philip R Baldwin, Joseph H Davis, James R Williamson, Clinton S Potter, Bridget Carragher & Dmitry Lyumkis. Addressing preferred specimen orientation in single-particle cryo-EM through tilting. Nature Methods volume 14, pages 793–796 (2017).
