Skip to content

TomoBEAR is a configurable and customizable modular pipeline for streamlined processing of cryo-electron tomographic data for subtomogram averaging.

License

Notifications You must be signed in to change notification settings

KudryashevLab/TomoBEAR

Repository files navigation

TomoBEAR

DOI

TomoBEAR is a configurable and customizable modular pipeline for streamlined processing of cryo-electron tomographic data and preliminary subtomogram averaging (StA) based on best practices in the scientific research group of Dr. Misha Kudryashev12.

TomoBEAR Social Media Logo Image

Implementation details and benchmarks you can find in our publication:
Balyschew N, Yushkevich A, Mikirtumov V, Sanchez RM, Sprink T, Kudryashev M. Streamlined Structure Determination by Cryo-Electron Tomography and Subtomogram Averaging using TomoBEAR. Nat Commun 14, 6543 (2023). doi: 10.1038/s41467-023-42085-w

Warning
This software is currently in pre-release state. New features may still appear and refactoring may still take place between all the current and future 0.x.y versions until 1.0.0 will be ready to be released. Binaries are not currently shipped.

Contents

Quick start

Video-tutorials

We have prepared a range of short (8-12 min) video-tutorials explaining setup, usage and example output of the TomoBEAR to help you get started with TomoBEAR based on the ribosome tutorial:

  • Video 1: how to get the latest TomoBEAR version and configure TomoBEAR and its dependencies;
  • Video 2: description of the project configuration file and the pipeline execution;
  • Video 3: additional configuration file parameters description, TomoBEAR-IMOD-TomoBEAR loop for checking tilt series alignment results and fiducials refinement (if needed);
  • Video 4: checking on further intermediate results (alignment, CTF-correction, reconstruction, template matching).

Pipeline structure

In the following picture you can see a flow chart of the main TomoBEAR processing steps. As the basic input data you can use raw frame movies or already assembled tilt stacks. More on input formats you can read here.

Schematic Pipeline Image

Blue boxes outline the steps that are performed fully automatically, green boxes may require human intervention. The steps encapsulated in the red frame represent the functionality of live data processing. More detailed diagram is located on wiki.

Note
Full MATLAB (source code) version of TomoBEAR supports workstations and single interactive nodes with GPUs on the computing clusters at the moment. We are also working towards enabling the support of binaries on the mentioned systems as well as support of both source code and binary versions of the TomoBEAR on HPC clusters.

Documentation and licensing

Detailed information on the installation, setup and usage as well as tutorials and example results can be found in the corresponding wiki.

Please, see the LICENSE file for the information about how the content of this repository is licensed.

Changes and releases

The CHANGELOG file contains all notable changes corresponding to the different TomoBEAR releases, which are available at the Releases page.

If you want to clone a specific TomoBEAR version, please refer to the Setup > Get source code and binary > Clone specific version section on the wiki page Installation and Setup.

Feedback and contribution

In case of any questions, issues or suggestions you may interact with us by one of the following ways:

If you wish to contribute, please, fork this repository and make a pull request back with your changes and a short description. For further details on contribution plase read our contribution guidelines.

Citation

If you use TomoBEAR or its parts in your research, please cite both TomoBEAR and all external software packages which you have used under TomoBEAR.

The TomoBEAR modules dependencies on third-party software are listed on the page Modules and the list of the corresponding references to cite is located on the page External Software.

Acknowledgements

We are grateful to the following organizations:

As well we are grateful to the structural biology scientific research group of Werner Kühlbrandt at the MPIBP (Max Planck Institute of Biophysics) and the MPIBP in Frankfurt (Hesse), Germany for support.

The authors thank as well the following people:

  • Dr. Daniel Castano-Diez, Dr. Kendra Leigh and Dr. Christoph Diebolder and Dr. Wolfgang Lugmayr for useful discussions;
  • Uljana Kravchenko, Xiaofeng Chu, Giulia Glorani for testing the developmental versions and providing feedback,
  • Ricardo Sanchez for producing MATLAB version of the SUSAN framework in order to be compatible with TomoBEAR;
  • Juan Castillo from the Max Planck Institute for Biophysics for the IT support at the Max Planck for Biophysics,
  • the high-performance computing team at the MDC for supporting our operation at the Max-Cluster.

We would like to acknowledge as well that TomoBEAR contains modified pieces of MATLAB source code of the Dynamo package developed by Dr. Daniel Castaño-Díez et al.: https://www.dynamo-em.org.

Contacts

  • Prof. Dr. Misha Kudryashev12 (e-mail) - TomoBEAR project leader, Principal Investigator;

  • Nikita Balyschew2 - TomoBEAR core version developer, alumni Ph.D. student.

  • Artsemi Yushkevich1 (e-mail) - TomoBEAR contributing developer, Ph.D. student.

  • Vasilii Mikirtumov1 (e-mail) - TomoBEAR application engineer, Ph.D. student.

Footnotes

  1. In situ Structural Biology Group at the MDCMM (Max Delbrück Center of Molecular Medicine) in Berlin, Germany. 2 3 4

  2. Independent Research Group (Sofja Kovaleskaja) at the Department of Structural Biology at MPIBP (Max Planck Institute of Biophysics) in Frankfurt (Hesse), Germany; 2 3