obj.mpp 2025.10

Object/pattern detection using a Marked Point Process

Documentation

The documentation is available at https://src.koda.cnrs.fr/eric.debreuve/Obj.MPP/-/wikis/home.

Installation

This project is published on the Python Package Index (PyPI) at: https://pypi.org/project/obj.mpp/. It should be installable from Python distribution platforms or Integrated Development Environments (IDEs). Otherwise, it can be installed from a command console using pip:

	For all users (after acquiring administrative rights)	For the current user (no administrative rights required)
Installation	pip install obj.mpp	pip install --user obj.mpp
Update	pip install --upgrade obj.mpp	pip install --user --upgrade obj.mpp

Dependencies

The development relies on several packages:

• Mandatory: Pillow, babelwidget, imageio, matplotlib, networkx, numpy, platformdirs, rich, scikit-image, scipy

• Optional: None

The mandatory dependencies, if any, are installed automatically by pip, if they are not already, as part of the installation of Obj.MPP. Python distribution platforms or Integrated Development Environments (IDEs) should also take care of this. The optional dependencies, if any, must be installed independently by following the related instructions, for added functionalities of Obj.MPP.

Implementation notes

• The optional, periodic detection refinement step is not part of the original Marked Point Process object detection method (see the Gamal Eldin et al reference in the documentation). It is an heuristic addition.

• When using the refinement step, Xavier Descombes noticed that, after some iterations, each iteration was taking very long to complete. He hypothesized that the refinement step was applied in each iteration instead of happening with the specified period. He was right: the reset of the refinement-related counter after application had been forgotten.

Acknowledgments

The project is developed with PyCharm Community.

The code is formatted by Black, The Uncompromising Code Formatter.

The imports are ordered by isort… your imports, so you don’t have to.