cryoet-deepfinder


Namecryoet-deepfinder JSON
Version 0.2.1 PyPI version JSON
download
home_pageNone
SummaryDeepFinder is an original deep learning approach to localize macromolecules in cryo electron tomography images. The method is based on image segmentation using a 3D convolutional neural network.
upload_time2024-06-11 13:46:55
maintainerNone
docs_urlNone
authorE. Moebel
requires_python>=3.9
licenseGPL-3.0
keywords
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # Deep Finder

The code in this repository is described in [this pre-print](https://www.biorxiv.org/content/10.1101/2020.04.15.042747v1). This paper has now been [published](https://doi.org/10.1038/s41592-021-01275-4) in Nature Methods.

**News**: (27/11/23) DeepFinder exists now as a Napari plugin

## Contents
- [System requirements](##System requirements)
- [Installation guide](##Installation guide)
- [Instructions for use](##Instructions for use)
- [Documentation](https://cryoet-deepfinder.readthedocs.io/en/latest/)
- [Google group](https://groups.google.com/g/deepfinder)

## System requirements
**Deep Finder** has been implemented using **Python 3** and is based on the **Tensorflow** package. It has been tested on Linux (Debian 10), and should also work on Mac OSX as well as Windows.

The algorithm needs an **Nvidia GPU** and **CUDA** to run at reasonable speed (in particular for training). The present code has been tested on Tesla K80 and M40 GPUs. For running on other GPUs, some parameter values (e.g. patch and batch sizes) may need to be changed to adapt to available memory.

### Package dependencies
Deep Finder depends on following packages. The package versions for which our software has been tested are displayed in brackets:
```
tensorflow   (2.11.1)
lxml         (4.9.3)
mrcfile      (1.4.3)
scikit-learn (1.3.2)
scikit-image (0.22.0)
matplotlib   (3.8.1)
PyQt5        (5.15.10)
pyqtgraph    (0.13.3)
openpyxl     (3.1.2)
pycm         (4.0)
```

## Installation guide
Before installation, you need a python environment on your machine. If this is not the case, we advise installing [Miniconda](https://docs.conda.io/en/latest/miniconda.html).

(Optional) Before installation, we recommend first creating a virtual environment that will contain your DeepFinder installation:
```
conda create --name dfinder python=3.9
conda activate dfinder
```

Now, you can install DeepFinder with pip:
```
pip install cryoet-deepfinder
```

Also, in order for Keras to work with your Nvidia GPU, you need to install CUDA. Once these steps have been achieved, the user should be able to run DeepFinder.

## Instructions for use
### Using the scripts
Instructions for using Deep Finder are contained in folder examples/. The scripts contain comments on how the toolbox should be used. To run a script, first place yourself in its folder. For example, to run the target generation script:
```
cd examples/training/
python step1_generate_target.py
```

### Using the GUI
The GUI (Graphical User Interface) should be more intuitive for those who are not used to work with script. Currently, 5 GUIs are available (tomogram annotation, target generation, training, segmentation, clustering) and allow the same functionalities as the scripts in example/. To run a GUI, first open a terminal. For example, to run the segmentation GUI:
```
segment
```

![Training GUI](./images/gui_segment.png)

==Important information:== Except for the training, the using of the GUI is depreciated. We advise using the [Napari plugin](https://github.com/deep-finder/napari-deepfinder) instead.

For more informations about how to use DeepFinder, please refer to the [documentation](https://cryoet-deepfinder.readthedocs.io/en/latest/).

__Notes:__ 
- working examples are contained in examples/analyze/, where Deep Finder processes the test tomogram from the [SHREC'19 challenge](http://www2.projects.science.uu.nl/shrec/cryo-et/2019/). 
- The script in examples/training/ will fail because the training data is not included in this Gitlab. 
- The evaluation script (examples/analyze/step3_launch_evaluation.py) is the one used in SHREC'19, which needs additional packages (pathlib and pycm, can be installed with pip). The performance of Deep Finder has been evaluated by an independent group, and the result of this evaluation has been published in Gubins & al., "SHREC'19 track: Classification in cryo-electron tomograms".

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "cryoet-deepfinder",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.9",
    "maintainer_email": null,
    "keywords": null,
    "author": "E. Moebel",
    "author_email": "emmanuel.moebel@gmail.com",
    "download_url": "https://files.pythonhosted.org/packages/c6/f9/eb80edc69d76964299886c117ad6198525a0744f9b8dd4243233c52ad648/cryoet_deepfinder-0.2.1.tar.gz",
    "platform": null,
    "description": "# Deep Finder\n\nThe code in this repository is described in [this pre-print](https://www.biorxiv.org/content/10.1101/2020.04.15.042747v1). This paper has now been [published](https://doi.org/10.1038/s41592-021-01275-4) in Nature Methods.\n\n**News**: (27/11/23) DeepFinder exists now as a Napari plugin\n\n## Contents\n- [System requirements](##System requirements)\n- [Installation guide](##Installation guide)\n- [Instructions for use](##Instructions for use)\n- [Documentation](https://cryoet-deepfinder.readthedocs.io/en/latest/)\n- [Google group](https://groups.google.com/g/deepfinder)\n\n## System requirements\n**Deep Finder** has been implemented using **Python 3** and is based on the **Tensorflow** package. It has been tested on Linux (Debian 10), and should also work on Mac OSX as well as Windows.\n\nThe algorithm needs an **Nvidia GPU** and **CUDA** to run at reasonable speed (in particular for training). The present code has been tested on Tesla K80 and M40 GPUs. For running on other GPUs, some parameter values (e.g. patch and batch sizes) may need to be changed to adapt to available memory.\n\n### Package dependencies\nDeep Finder depends on following packages. The package versions for which our software has been tested are displayed in brackets:\n```\ntensorflow   (2.11.1)\nlxml         (4.9.3)\nmrcfile      (1.4.3)\nscikit-learn (1.3.2)\nscikit-image (0.22.0)\nmatplotlib   (3.8.1)\nPyQt5        (5.15.10)\npyqtgraph    (0.13.3)\nopenpyxl     (3.1.2)\npycm         (4.0)\n```\n\n## Installation guide\nBefore installation, you need a python environment on your machine. If this is not the case, we advise installing [Miniconda](https://docs.conda.io/en/latest/miniconda.html).\n\n(Optional) Before installation, we recommend first creating a virtual environment that will contain your DeepFinder installation:\n```\nconda create --name dfinder python=3.9\nconda activate dfinder\n```\n\nNow, you can install DeepFinder with pip:\n```\npip install cryoet-deepfinder\n```\n\nAlso, in order for Keras to work with your Nvidia GPU, you need to install CUDA. Once these steps have been achieved, the user should be able to run DeepFinder.\n\n## Instructions for use\n### Using the scripts\nInstructions for using Deep Finder are contained in folder examples/. The scripts contain comments on how the toolbox should be used. To run a script, first place yourself in its folder. For example, to run the target generation script:\n```\ncd examples/training/\npython step1_generate_target.py\n```\n\n### Using the GUI\nThe GUI (Graphical User Interface) should be more intuitive for those who are not used to work with script. Currently, 5 GUIs are available (tomogram annotation, target generation, training, segmentation, clustering) and allow the same functionalities as the scripts in example/. To run a GUI, first open a terminal. For example, to run the segmentation GUI:\n```\nsegment\n```\n\n![Training GUI](./images/gui_segment.png)\n\n==Important information:== Except for the training, the using of the GUI is depreciated. We advise using the [Napari plugin](https://github.com/deep-finder/napari-deepfinder) instead.\n\nFor more informations about how to use DeepFinder, please refer to the [documentation](https://cryoet-deepfinder.readthedocs.io/en/latest/).\n\n__Notes:__ \n- working examples are contained in examples/analyze/, where Deep Finder processes the test tomogram from the [SHREC'19 challenge](http://www2.projects.science.uu.nl/shrec/cryo-et/2019/). \n- The script in examples/training/ will fail because the training data is not included in this Gitlab. \n- The evaluation script (examples/analyze/step3_launch_evaluation.py) is the one used in SHREC'19, which needs additional packages (pathlib and pycm, can be installed with pip). The performance of Deep Finder has been evaluated by an independent group, and the result of this evaluation has been published in Gubins & al., \"SHREC'19 track: Classification in cryo-electron tomograms\".\n",
    "bugtrack_url": null,
    "license": "GPL-3.0",
    "summary": "DeepFinder is an original deep learning approach to localize macromolecules in cryo electron tomography images. The method is based on image segmentation using a 3D convolutional neural network.",
    "version": "0.2.1",
    "project_urls": null,
    "split_keywords": [],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "c02f6bbc7fbe9d40a0dabbd7dc36f054e0bfb1974d12724fb212ff2cdd2f0316",
                "md5": "d7dbeb8d004379f40bf97a3e67f36f66",
                "sha256": "df425a68e835e232ec539bde675b4a2b68c4ee5c5492fc61c119d0c4919bcf47"
            },
            "downloads": -1,
            "filename": "cryoet_deepfinder-0.2.1-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "d7dbeb8d004379f40bf97a3e67f36f66",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.9",
            "size": 45647,
            "upload_time": "2024-06-11T13:46:54",
            "upload_time_iso_8601": "2024-06-11T13:46:54.669185Z",
            "url": "https://files.pythonhosted.org/packages/c0/2f/6bbc7fbe9d40a0dabbd7dc36f054e0bfb1974d12724fb212ff2cdd2f0316/cryoet_deepfinder-0.2.1-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "c6f9eb80edc69d76964299886c117ad6198525a0744f9b8dd4243233c52ad648",
                "md5": "2a768c897bc4ef34f9039547a1ddf0f8",
                "sha256": "e23ed6a3f9cc2be183b9723b6b9a916ae89d92f635901929ff9ea4cc410bfaf0"
            },
            "downloads": -1,
            "filename": "cryoet_deepfinder-0.2.1.tar.gz",
            "has_sig": false,
            "md5_digest": "2a768c897bc4ef34f9039547a1ddf0f8",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.9",
            "size": 43777,
            "upload_time": "2024-06-11T13:46:55",
            "upload_time_iso_8601": "2024-06-11T13:46:55.900199Z",
            "url": "https://files.pythonhosted.org/packages/c6/f9/eb80edc69d76964299886c117ad6198525a0744f9b8dd4243233c52ad648/cryoet_deepfinder-0.2.1.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-06-11 13:46:55",
    "github": false,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "lcname": "cryoet-deepfinder"
}
        
Elapsed time: 0.26636s