Skip to content

KosinskiLab/mosaic

Repository files navigation

Mosaic

Build Status PyPI License: GPL v2

Documentation | Installation

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.

Mosaic Workflow

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 refine membrane shapes using both your experimental density and physics. Send the result straight to GROMACS.

Mosaic GUI Interface

Mosaic interface

Once your workflow is dialed in, use the pipeline builder to scale it to large datasets:

mosaic-pipeline config.json

Installation

Mosaic requires Python 3.11 or higher. Install with pip:

pip install mosaic-gui
mosaic &

The graphical interface launches immediately. For advanced installation options see the installation guide.

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

About

Analyze and model biomembranes from 3D structural data.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Contributors 2

  •  
  •  

Languages