Skip to main content

Generate reports for Ot2Rec

Project description

Ot2Rec Report

Automatic report generation for processing of cryo-electron tomography datasets

License Issues

Ot2Rec report is a tool to automatically generate reports of tomography reconstructions run in Ot2Rec.

The reports currently cover the following Ot2Rec plugins:

  • Motioncor2
  • IMOD alignment
  • IMOD reconstruction
  • AreTomo alignment
  • AreTomo reconstruction
  • Savu reconstruction

The following Ot2Rec plugins are also covered, but may be stubs or less stable:

  • CTFSim
  • CTFFind4
  • Richardson-Lucy deconvolution with RedlionFish.

If you have any ideas on what you'd like included in the reports, file an issue and we will do our best to add it. Or if you'd like to get involved, feel free to make a pull request.

Installation

We highly recommend using a virtual environment, e.g., conda

conda create -n ot2rec_report pip python=3.10
conda activate ot2rec_report

To install from PyPI:

pip install ot2rec-report

To install from source:

git clone https://github.com/rosalindfranklininstitute/ot2rec_report.git
conda create -n o2r_report
conda activate o2r_report
pip install -e .

If you encounter any issues with pydot, with your conda environment activated:

conda install -c conda-forge graphviz

Usage

In your terminal, navigate to the folder where your Ot2Rec processing has been done (hint: this is where the o2r_plugin.log files live.

Once you're there:

o2r.report.run

A GUI will pop up to capture your input:

  • Project name is the project name of your experiment, same as you'd have used for Ot2Rec. This is normally the first part of the filename, e.g. TS would be the project name for TS_001_0.0.mrc.
  • Choice of sections to include in the report. Hold down Ctrl to select more than one.
  • Export to html: If you'd like this Jupyter notebook without the code as a html report. Your report.html will be created in the same directory. You can print this as a pdf if you'd like to.
  • Export to slides: This creates a report.slides.html file which you can view and present in your browser.

By default, a Jupyter notebook report.ipynb is produced which contains the report.

Contributing

Contributions are very welcome, it does not have to be through code! If you have any suggestions, you can raise an issue. Pull requests are also welcome, though you may want to raise an issue first to make sure we're not duplicating effort.

Citing

If you have found Ot2Rec useful, please cite us:

Ot2Rec: A Semi-Automatic, Extensible, Multi-Software Tomographic Reconstruction Workflow Neville B.-y. Yee, Elaine M. L. Ho, Win Tun, Jake L. R. Smith, Maud Dumoux, Michael Grange, Michele C. Darrow, Mark Basham bioRxiv 2022.12.15.520632; doi: https://doi.org/10.1101/2022.12.15.520632

Funding

This project was funded as part of the Electrifying Life Sciences project at the Rosalind Franklin Institute.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ot2rec_report-0.1.0.post4.tar.gz (23.6 kB view details)

Uploaded Source

Built Distribution

ot2rec_report-0.1.0.post4-py3-none-any.whl (60.0 kB view details)

Uploaded Python 3

File details

Details for the file ot2rec_report-0.1.0.post4.tar.gz.

File metadata

  • Download URL: ot2rec_report-0.1.0.post4.tar.gz
  • Upload date:
  • Size: 23.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.9.16

File hashes

Hashes for ot2rec_report-0.1.0.post4.tar.gz
Algorithm Hash digest
SHA256 4a6eab50b9b9ab5c2eb8483c51a0cf7ab34247896aeee7283f33c546993b775c
MD5 6b3dd31795d782558c67131c53a90e98
BLAKE2b-256 93fd08be288026e5fbca6e951f9aa9e9003426854b8f355e4d89ea9dcaebd926

See more details on using hashes here.

File details

Details for the file ot2rec_report-0.1.0.post4-py3-none-any.whl.

File metadata

File hashes

Hashes for ot2rec_report-0.1.0.post4-py3-none-any.whl
Algorithm Hash digest
SHA256 5183c606d92f166478852046fa5c010a9aa88f6dbfd3f8296cfa3edeaa4de469
MD5 47d47716ba4e521d428472a63a1cc13a
BLAKE2b-256 5704de4cd48a4ca8a2f79bb86b2dde7e714649440cf1f75fe0b02bfd4937acb2

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page