Skip to main content

membrane segmentation in 3D for cryo-ET

Project description

MemBrain-Seg

License PyPI Python Version CI codecov

Membrain-Seg is a Python project developed by teamtomo for membrane segmentation in 3D for cryo-electron tomography (cryo-ET). This tool aims to provide researchers with an efficient and reliable method for segmenting membranes in 3D microscopic images. Membrain-Seg is currently under early development, so we may make breaking changes between releases.

Membrain-Seg is currently under early development, so we may make breaking changes between releases.

Overview

MemBrain-seg is a practical tool for membrane segmentation in cryo-electron tomograms. It's built on the U-Net architecture and makes use of a pre-trained model for efficient performance. The U-Net architecture and training parameters are largely inspired by nnUNet1.

Our current best model is available for download here. Please let us know how it works for you. If the given model does not work properly, you may want to try one of our previous versions:

Other (older) model versions:

If you wish, you can also train a new model using your own data, or combine it with our (soon to come!) publicly-available dataset.

To enhance segmentation, MemBrain-seg includes preprocessing functions. These help to adjust your tomograms so they're similar to the data our network was trained on, making the process smoother and more efficient.

Explore MemBrain-seg, use it for your needs, and let us know how it works for you!

Preliminary documentation is available, but far from perfect. Please let us know if you encounter any issues, and we are more than happy to help (and get feedback what does not work yet).

[1] Isensee, F., Jaeger, P.F., Kohl, S.A.A., Petersen, J., Maier-Hein, K.H., 2021. nnU-Net: a self-configuring method for deep learning-based biomedical image segmentation. Nature Methods 18, 203-211. https://doi.org/10.1038/s41592-020-01008-z

Installation

For detailed installation instructions, please look here.

Features

Segmentation

Segmenting the membranes in your tomograms is the main feature of this repository. Please find more detailed instructions here.

Preprocessing

Currently, we provide the following two preprocessing options:

  • Pixel size matching: Rescale your tomogram to match the training pixel sizes
  • Fourier amplitude matching: Scale Fourier components to match the "style" of different tomograms
  • Deconvolution: denoises the tomogram by applying the deconvolution filter from Warp

For more information, see the Preprocessing subsection.

Model training

It is also possible to use this package to train your own model. Instructions can be found here.

Patch annotations

In case you would like to train a model that works better for your tomograms, it may be beneficial to add some more patches from your tomograms to the training dataset. Recommendations on how to to this can be found here.

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

membrain_seg-0.0.1.tar.gz (65.5 kB view details)

Uploaded Source

Built Distribution

membrain_seg-0.0.1-py3-none-any.whl (72.4 kB view details)

Uploaded Python 3

File details

Details for the file membrain_seg-0.0.1.tar.gz.

File metadata

  • Download URL: membrain_seg-0.0.1.tar.gz
  • Upload date:
  • Size: 65.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.11.7

File hashes

Hashes for membrain_seg-0.0.1.tar.gz
Algorithm Hash digest
SHA256 17aff39b5e3e0b60fbb2e22a0953ea27758606f8cbfff9674474dcf72f6fc502
MD5 f604b9028b5864e5003453da8157e3b3
BLAKE2b-256 e67876b1d4749c43982c03738836e88abdbcff8861a8a6d040a0b0735dc0a9f8

See more details on using hashes here.

File details

Details for the file membrain_seg-0.0.1-py3-none-any.whl.

File metadata

  • Download URL: membrain_seg-0.0.1-py3-none-any.whl
  • Upload date:
  • Size: 72.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.11.7

File hashes

Hashes for membrain_seg-0.0.1-py3-none-any.whl
Algorithm Hash digest
SHA256 761f356f76c5f8e1095060468c1274007b0abb9cb61a6fcb28674fc8d645c35c
MD5 3d601223567f7681ceb923d13f60c633
BLAKE2b-256 18272789322dc5c295405b06e1a59f330163396d22b31c2278d007fd130c0d51

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