Skip to main content

Membrain-Pick

Overview

Membrain-Pick is part of the MemBrain suite of tools for processing membranes in cryo-electron tomography. MemBrain-pick's main purpose is to localize membrane-associated particles in the tomograms. To this end, MemBrain-picks takes as input already existing membrane segmentations and processes these to limit the search space for membrane-associated particles. The output of MemBrain-pick is a set of coordinates that can be used for further analysis.

Use case

MemBrain-pick is most powerfully used when training data is still limited or still needs to be generated. By leveraging membrane segmentations, MemBrain-pick can focus the search for particles to the membrane vicinity, reducing the amount of data needed for training.

The inherently used data representation corresponds to the one also used in surforama , allowing for seamless integration between both tools. MemBrain-pick can be used to generate training data for membrane-associated particles, which can then be manually annotated in surforama. The trained model can then be used to predict particle locations in new tomograms.

MemBrain-pick is therefore also limited by what is visible in the surforama interface. For instance, if particles are not clearly visible in surforama, MemBrain-pick will also struggle to localize them. It cannot recover structures that are not visible to a human annotator A general recommendation is therefore to first inspect the membrane segmentations in surforama before training a first model.

Workflow

The workflow of MemBrain-pick is as follows:

  1. Input: Membrane segmentations in the form of a binary mask (.mrc). Ideally, these segmentations should depict single membrane instances.
  2. Mesh Generation: The membrane segmentations are converted into a mesh representation. At this stage, also tomogram densities are projected onto the membrane mesh.
  3. Ground Truth Generation: The membrane mesh can be loaded into surforama to manually annotate membrane-associated particles. These annotations can then be used to train a MemBrain-pick model.
  4. Training: The generated meshes, along with the annotations, are used to train a model that can predict the location of membrane-associated particles.
  5. Prediction: The trained model is used to predict the location of membrane-associated particles in the membrane segmentations.
  6. (Optional) Subtomogram averaging: The predicted particle locations and initial orientations can be used for subtomogram averaging. Here, we explain how to import them into RELION for this purpose.

Example notebook

For a quick start, you can walk through our example notebook. You can easily run it on Google Colab by clicking on the badge below:

Open In Colab

Key Functionalities

  • Mesh Conversion: Transform membrane segmentations into a mesh representation that can easily be processed by MemBrain-pick and surforama.
  • Model training: Train a model to predict the location of membrane-associated particles.
  • Prediction: Use the trained model to predict the location of membrane-associated particles in membrane segmentations.
  • Initial orientaton assignment: Given a set of positions, MemBrain-pick can assign initial orientations to the particles by aligning them with the membrane normal. -- integration with surforama: MemBrain-pick can be used in conjunction with surforama to manually annotate membrane-associated particles.

Jump to

MemBrain-pick is part of the MemBrain v2 [1] package and still under early development. If you have any questions or suggestions, please raise an issue on GitHub or contact the authors.

[1] Lamm, L., Zufferey, S., Righetto, R.D., Wietrzynski, W., Yamauchi, K.A., Burt, A., Liu, Y., Zhang, H., Martinez-Sanchez, A., Ziegler, S., Isensee, F., Schnabel, J.A., Engel, B.D., and Peng, T, 2024. MemBrain v2: an end-to-end tool for the analysis of membranes in cryo-electron tomography. bioRxiv, https://doi.org/10.1101/2024.01.05.574336

Metadata

Release files for membrain-pick 0.0.9

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for membrain-pick 0.0.9
File Size Uploaded
membrain_pick-0.0.9.tar.gz 249.6 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for membrain-pick 0.0.9
File Interpreter ABI Platform
membrain_pick-0.0.9-py3-none-any.whl Python 3 none any Details

Total release size: 335.4 kB

Release files / membrain_pick-0.0.9.tar.gz

Download URL membrain_pick-0.0.9.tar.gz
Size 249.6 kB
Tags Source
SHA-256 checksum
How to use checksums
3a6070dbd86d170bfe0fc7af0c8ea1d957c8ff616d3b513a44af0662f67dcbbb
BLAKE2b-256 checksum
How to use checksums
9cf73ad60610e841901260aa87ef80dc4bbe2b2a15f17fd3c22a5b758d91d4fd
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.10.19

Release files / membrain_pick-0.0.9-py3-none-any.whl

Download URL membrain_pick-0.0.9-py3-none-any.whl
Size 85.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
690b12077b78638c52adcbc361f0b10a25d33532a1029e4ee8080047e81a54d1
BLAKE2b-256 checksum
How to use checksums
dded9aae6812c34904744f2e498eb1362b6b3d95ca5f3e74dbc0230f30c47336
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.10.19

Release history Release notifications | RSS feed

This release

0.0.9 This release

2 release files

0.0.8

2 release files

0.0.7

2 release files

0.0.6

2 release files

0.0.5

2 release files

0.0.4

2 release files

0.0.3

2 release files

0.0.2

2 release files

0.0.1

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page