PMMoTo

The Porous Media Morphology and Topology (PMMoTo) toolkit is an open-source Python library for analyzing, modeling, and characterizing the structure of porous materials. Built with Cython and C++ and designed for distributed memory systems using MPI, PMMoTo includes parallelized implementations of connected components analysis, morphological operations (e.g., dilation and erosion), and Euclidean distance transforms. Unlike many tools that focus on image-based analysis, PMMoTo is specifically designed for synthetically generated porous media, such as sphere packings and molecular dynamics simulations.

Website

PMMoTo Website: https://tmweigand.github.io/PMMoTo/

Installation

PMMoTo requires MPI (see https://tmweigand.github.io/PMMoTo/user_guide/installation.html)

Standard

1. Clone the repository:

   git clone https://github.com/tmweigand/PMMoTo.git
   cd PMMoTo
   

2. Install the package:

   pip install .
   

Development - including testing

For detailed instructions, see https://tmweigand.github.io/PMMoTo/developer_guide/installation.html

1. Clone the repository:

   git clone https://github.com/tmweigand/PMMoTo.git
   cd PMMoTo
   

2. Install in editable mode with dev dependencies:

   pip install -e .[dev]
   

Citing

If you use PMMoTo in your research, please cite the relevant publication (too come).

Community Guidelines

Contributions and community feedback is welcomed!

Contributing

• Fork the repo and create a branch.
• Make your changes and submit a pull request.
• Ensure tests pass.

Reporting Issues

• Use GitHub Issues.
• Include details: steps to reproduce, expected vs. actual behavior, and system info.

Support

• See the docs and examples.
• For questions, open a discussion or file an issue.

License

This project is licensed under the MIT License. See LICENSE for details.

Contact

For questions, issues, or contributions, please open an issue or pull request on GitHub.