From 6ffb671f78c13f0eae0db01c57c615cc173a642a Mon Sep 17 00:00:00 2001 From: DavidHerreros <40200657+DavidHerreros@users.noreply.github.com> Date: Thu, 27 Jun 2024 09:22:41 +0200 Subject: [PATCH] Update README.md --- README.md | 48 +++++++++++++++++++++++++++++++++++++----------- 1 file changed, 37 insertions(+), 11 deletions(-) diff --git a/README.md b/README.md index 48ecc20..a7ccf0b 100644 --- a/README.md +++ b/README.md @@ -1,23 +1,24 @@

Cryo-EM Heterogeniety Challenge

-This repository contains the code used to analyse the submissions for the [Inaugrural Flatirion Cryo-EM Heteorgeneity Challenge](https://www.simonsfoundation.org/flatiron/center-for-computational-biology/structural-and-molecular-biophysics-collaboration/heterogeneity-in-cryo-electron-microscopy/). +.. image:: https://img.shields.io/badge/Supported Python Versions-3.8 - 3.9 - 3.10 - 3.11) + :alt: Supported Python versions -## Scope +This repository contains the code used to analyse the submissions for the [Inaugrural Flatirion Cryo-EM Heteorgeneity Challenge](https://www.simonsfoundation.org/flatiron/center-for-computational-biology/structural-and-molecular-biophysics-collaboration/heterogeneity-in-cryo-electron-microscopy/). +# Scope This repository explains how to preprocess a submission (80 maps and corresponding probability distribution), and analyze it. Challenge participants can benchmark their submissions locally against the ground truth and other submissions that are available on the cloud via the Open Science Foundation project [The Inaugural Flatiron Institute Cryo-EM Heterogeneity Community Challenge](https://osf.io/8h6fz/). -## Warning - -This is a work in progress, while the code will probably not change, we are still writting better tutorials, documentation, and other ideas for analyzing the data. We are also in the process of making it easier for other people to contribute with their own metrics and methods. We are also in the process of distributiing the code to PyPi - - -## Accesing the data +# Warning +This is a work in progress, while the code will probably not change, we are still writting better tutorials, documentation, and other ideas for analyzing the data. We are also in the process of making it easier for other people to contribute with their own metrics and methods. We are also in the process of distributiing the code to PyPi. +# Accesing the data The data is available via the Open Science Foundation project [The Inaugural Flatiron Institute Cryo-EM Heterogeneity Community Challenge](https://osf.io/8h6fz/). You can download via a webbroswer, or programatically with wget as per [this script](https://github.com/flatironinstitute/Cryo-EM-Heterogeneity-Challenge-1/blob/main/tests/scripts/fetch_test_data.sh). +NOTE: We recommend downloadaing the data with the script and wget as the downloads from the web browser might be unstable. -## Installation +# Installation +## Stable installation Installing this repository is simply. We recommend creating a virtual environment (using conda or pyenv), since we have dependencies such as PyTorch or Aspire, which are better dealt with in an isolated environment. After creating your environment, make sure to activate it and run ```bash @@ -25,7 +26,25 @@ cd /path/to/Cryo-EM-Heterogeneity-Challenge-1 pip install . ``` -## Running +## Devel installation +If you are interested in testing the programs previously installed, please, install the repository in development mode with the following commands: + +```bash +cd /path/to/Cryo-EM-Heterogeneity-Challenge-1 +pip install .[dev] +``` + +The test included in the repo can be executed with PyTest as shown below: + +```bash +cd /path/to/Cryo-EM-Heterogeneity-Challenge-1 +pytest tests/test_preprocessing.py +pytest tests/test_svd.py +pytest tests/test_map_to_map.py +pytest tests/test_distribution_to_distribution.py +``` + +# Running If you want to run our code, please check the notebooks in the [tutorials folder](https://github.com/flatironinstitute/Cryo-EM-Heterogeneity-Challenge-1/tree/main/tutorials). The tutorials explain how to setup the config files, and run the commands @@ -36,6 +55,13 @@ cryo_challenge run_map2map_pipeline --config config_files/conf cryo_challenge run_distribution2distribution_pipeline --config config_files/config_distribution_to_distribution.yaml ``` -## Acknowledgements +# Contributing +If you find any bug or have a suggestion on the code feel free to open an issue [here]([https://www.simonsfoundation.org/flatiron/center-for-computational-biology/structural-and-molecular-biophysics-collaboration/heterogeneity-in-cryo-electron-microscopy/](https://github.com/flatironinstitute/Cryo-EM-Heterogeneity-Challenge-1/issues) + +We also welcome any help with the development of this repository. If you want to contribute with your own suggestions, code, or fixes, we recommend creating a fork of this repository to avoid any incompatibilities with newer versions of the software. Once you are happy with your new code, please, make a PR from your fork to this repository. + +We are also working on pipelines to simplify the exentension of the code with new metrics or functionalities, stay tuned! + +# Acknowledgements * Miro A. Astore, Geoffrey Woollard, David Silva-Sánchez, Wenda Zhao, Khanh Dao Duc, Nikolaus Grigorieff, Pilar Cossio, and Sonya M. Hanson. "The Inaugural Flatiron Institute Cryo-EM Heterogeneity Community Challenge". 9 June 2023. DOI:10.17605/OSF.IO/8H6FZ * [David Herreros](https://github.com/DavidHerreros) for testing and CI and debugging in this repo