About

Project

MomaPy is a Python library for working with molecular maps. It supports SBGN PD and AF maps and CellDesigner maps, providing a unified API for reading, writing, inspecting, styling, and rendering them.

The project is developed at the University of Luxembourg.

Authors

• Adrien Rougny: lead developer (adrien.rougny@uni.lu)
• Guillaume Louis: documentation and visual design (guillaume.louis@uni.lu)

How to cite

If you use MomaPy in your work, please cite:

Adrien Rougny, Marek Ostaszewski, Venkata Satagopam. momapy: a Python library to work with molecular maps. Bioinformatics, 42(6), btag352, June 2026. https://doi.org/10.1093/bioinformatics/btag352

@article{rougny2026momapy,
  author  = {Rougny, Adrien and Ostaszewski, Marek and Satagopam, Venkata},
  title   = {momapy: a Python library to work with molecular maps},
  journal = {Bioinformatics},
  volume  = {42},
  number  = {6},
  pages   = {btag352},
  year    = {2026},
  month   = jun,
  doi     = {10.1093/bioinformatics/btag352},
  url     = {https://doi.org/10.1093/bioinformatics/btag352}
}

Contributing

Bug reports and feature requests are welcome via the GitHub issue tracker.

To contribute code:

1. Fork the repository on GitHub.
2. Create a feature branch.
3. Make your changes
4. Run the test suite: pytest tests/
5. Open a pull request against main.

All commits must follow Conventional Commits (enforced via commitlint). See CLAUDE.md for the list of valid types and examples.

Versioning

MomaPy loosely follows semantic versioning as a guideline, not a strict contract.

Below 1.0 the public API is not stable and may change in a breaking way in any release.

The public API is what the documentation and each subpackage's __all__ describe. Underscore-prefixed names are not public and may change at any time.

License

This code is distributed under the GPLv3 license.