Mosaic
Why Mosaic?
Biological membranes define cellular compartments and orchestrate signaling cascades, all while undergoing constant remodeling. We can resolve their structure from imaging data, but the analysis path is fragmented. One tool for segmentation, another for meshing, something else for protein localization, yet another for setting up physical simulations. Export, convert, hope nothing breaks.
Mosaic fixes that. One graphical interface for the entire workflow.
Ask questions and get answers immediately. What is the membrane curvature where proteins cluster? How does protein density vary across the surface? How would this system behave under different conditions? Explore interactively and transition seamlessly from observation to quantitative hypothesis testing to data-driven physical simulations of real geometries.
What You Can Do
Import tomograms, segment membranes, build surface meshes, localize proteins, measure geometry, export simulation-ready systems. Adjust parameters and watch results update in real time.
Complete influenza A virus analysis: from tomogram to simulation-ready model
See it work: The IAV tutorial walks through a real analysis start to finish. About 30 minutes hands-on.
Need to prep for MD? Export Martini-compatible coarse-grained systems with positioned proteins. Run HMFF to simulate biomembranes using both your experimental density and physics. Send the result straight to GROMACS.
Mosaic interface
Once your workflow is dialed in, use the pipeline builder to scale it to large datasets:
mosaic-pipeline config.json
Working on a remote server or composing custom workflows? The Mosaic shell exposes most GUI operations as commands you can run interactively or replay from a script:
mosaic-shell workflow.sh
Installation
Mosaic requires Python 3.11 or higher. Install with pip:
pip install mosaic-gui
mosaic &
The first launch takes a bit longer than subsequent starts. A short interactive tour then walks through the basics, about five minutes. Re-run any time with mosaic --onboard basics.
See the installation guide for full instructions.
Citation
If Mosaic contributes to your research, please cite:
@article{Maurer2025,
author = {Maurer, Valentin J. and Siggel, Marc and Jensen, Rasmus K. and
Mahamid, Julia and Kosinski, Jan and Pezeshkian, Weria},
title = {Helfrich Monte Carlo Flexible Fitting: physics-based,
data-driven cell-scale simulations},
journal = {bioRxiv},
year = {2025},
doi = {10.1101/2025.05.24.655915}
}
Mosaic and HMFF were developed jointly to bridge structural data and physical simulations. HMFF uniquely integrates experimental volumetric data into membrane simulations, enabling data and physics to jointly determine membrane conformation. HMFF is implemented in FreeDTS and integrated into Mosaic.
About
Mosaic is developed by the Kosinski Lab at the European Molecular Biology Laboratory (EMBL Hamburg).
License: GPL-2.0 (see LICENSE for details)
Links
- Documentation: https://kosinskilab.github.io/mosaic/
- PyPI Package: https://pypi.org/project/mosaic-gui/
- Source Code: https://github.com/KosinskiLab/mosaic
- Issues & Support: https://github.com/KosinskiLab/mosaic/issues
1 maintainer
Metadata
1 maintainer
Release files for mosaic-gui 1.3.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| mosaic_gui-1.3.2.tar.gz | 2.3 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| mosaic_gui-1.3.2-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 4.7 MB
Release files / mosaic_gui-1.3.2.tar.gz
| Download URL | mosaic_gui-1.3.2.tar.gz |
|---|---|
| Size | 2.3 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
59ce09417dbba088b7024d0a02744dabdfbb03a857842dac3dd97c7db54dd09f
|
|
BLAKE2b-256 checksum How to use checksums |
80d803a001f0f25daf1e6264eea56ee8aeaaaa65f74159d098026cebbbd38575
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/2.4.1 CPython/3.11.12 Darwin/25.5.0
|
Release files / mosaic_gui-1.3.2-py3-none-any.whl
| Download URL | mosaic_gui-1.3.2-py3-none-any.whl |
|---|---|
| Size | 2.4 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
6217d8941ec23b3786d8b42fecda77cd08e193d1dc3d9507a78357d947b180a7
|
|
BLAKE2b-256 checksum How to use checksums |
424e4db9805713b742390b59f062d637034825643cadafe66466d75692daf15e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/2.4.1 CPython/3.11.12 Darwin/25.5.0
|
