mmcfilters

mmcfilters is an alpha research library for constructing and editing morphological hierarchies, computing node attributes, and applying connected filters and hierarchy operators. It provides a C++20 core and Python bindings.

The library represents hierarchies through a rooted connected-subset tree model. A morphological tree of partial partitions is the stricter case in which every node has a non-empty proper part. All supported image-domain trees use the same topology model, with an explicit smallest-node map and optional regular-grid geometry and adjacency.

Use mmcfilters for experiments that require mutable tree topology, direct ownership of hierarchy state, incremental attributes, residual hierarchies, or the filtering operators implemented by this project. For stable, general-purpose hierarchical image processing, Higra will often be the better choice.

Main capabilities

construction of max-trees, min-trees, trees of shapes, and self-dual residual trees;
generic rooted hierarchies with safe local and staged edits;
a broad catalog of node attributes organized into gray-level, shape, moment, boundary, and tree-topology groups;
a range of attribute-based filters and hierarchy operators, including pruning and non-pruning strategies;
pixel contours and ordered geometric contour traces;
import, export, and attribute projection for Higra-style hierarchies;
typed altitude handling in C++ and a focused np.uint8 Python API.

Requirements

Python 3.9–3.14 for the distributed Python package;
NumPy 1.23 or newer;
a C++20 compiler and CMake 3.20 or newer for source builds.

Installation

Install the Python package from PyPI:

python -m pip install mmcfilters

Install from a source checkout:

python -m pip install .

For a C++-only build and installation:

cmake -S . -B build -DMMCFILTERS_BUILD_PYTHON=OFF
cmake --build build
cmake --install build --prefix /path/to/prefix

The installed C++ package exports the mmcfilters::core target:

find_package(mmcfilters CONFIG REQUIRED)
target_link_libraries(my_target PRIVATE mmcfilters::core)

Quick start

import numpy as np
import mmcfilters

image = np.ascontiguousarray(
    [
        [3, 3, 2, 2],
        [3, 4, 4, 2],
        [1, 4, 5, 2],
        [1, 1, 5, 0],
    ],
    dtype=np.uint8,
)

# radius=1.5 selects 8-connectivity; use 1.0 for 4-connectivity.
tree = mmcfilters.MorphologicalTreeFactory.create_max_tree(image, radius=1.5)

root = tree.root
root_children = tree.children(root)

pixel = 10
smallest = tree.smallest_node(pixel)
support_pixels = list(tree.node_support(smallest))
component_mask = tree.reconstruct_node(smallest)

area = mmcfilters.Attribute.compute_single_topology_attribute(
    tree,
    mmcfilters.Attribute.AREA,
)
max_dist = mmcfilters.Attribute.compute_single_attribute(
    tree,
    mmcfilters.Attribute.MAX_DIST,
)
reconstructed_image = tree.reconstruct_from_node_altitudes()

Documentation

User guides

Goal	Guide
Understand the tree model and construct hierarchies	Morphological trees
Use the Python interface	Python API
Compute attributes	Attributes
Apply filtering and hierarchy operators	Filters
Compute hierarchy and shape-space saliency	Saliency maps
Edit a tree safely	Editing API
Extract pixel contours or geometric traces	Pixel contours and contour traces
Import from or export to Higra	Higra interoperability

References

Contributor guides

License

mmcfilters is distributed under the GNU General Public License v3.0.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mmcfilters-4.1.0.tar.gz (552.9 kB view details)

Uploaded Aug 17, 2026 Source

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

mmcfilters-4.1.0-cp314-cp314-win_amd64.whl (1.3 MB view details)

Uploaded Aug 17, 2026 CPython 3.14Windows x86-64

mmcfilters-4.1.0-cp314-cp314-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl (1.5 MB view details)

Uploaded Aug 17, 2026 CPython 3.14manylinux: glibc 2.27+ x86-64manylinux: glibc 2.28+ x86-64

mmcfilters-4.1.0-cp314-cp314-macosx_11_0_x86_64.whl (1.3 MB view details)

Uploaded Aug 17, 2026 CPython 3.14macOS 11.0+ x86-64

mmcfilters-4.1.0-cp314-cp314-macosx_11_0_arm64.whl (1.3 MB view details)

Uploaded Aug 17, 2026 CPython 3.14macOS 11.0+ ARM64

mmcfilters-4.1.0-cp313-cp313-win_amd64.whl (1.2 MB view details)

Uploaded Aug 17, 2026 CPython 3.13Windows x86-64

mmcfilters-4.1.0-cp313-cp313-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl (1.5 MB view details)

Uploaded Aug 17, 2026 CPython 3.13manylinux: glibc 2.27+ x86-64manylinux: glibc 2.28+ x86-64

mmcfilters-4.1.0-cp313-cp313-macosx_11_0_x86_64.whl (1.3 MB view details)

Uploaded Aug 17, 2026 CPython 3.13macOS 11.0+ x86-64

mmcfilters-4.1.0-cp313-cp313-macosx_11_0_arm64.whl (1.3 MB view details)

Uploaded Aug 17, 2026 CPython 3.13macOS 11.0+ ARM64

mmcfilters-4.1.0-cp312-cp312-win_amd64.whl (1.2 MB view details)

Uploaded Aug 17, 2026 CPython 3.12Windows x86-64

mmcfilters-4.1.0-cp312-cp312-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl (1.5 MB view details)

Uploaded Aug 17, 2026 CPython 3.12manylinux: glibc 2.27+ x86-64manylinux: glibc 2.28+ x86-64

mmcfilters-4.1.0-cp312-cp312-macosx_11_0_x86_64.whl (1.3 MB view details)

Uploaded Aug 17, 2026 CPython 3.12macOS 11.0+ x86-64

mmcfilters-4.1.0-cp312-cp312-macosx_11_0_arm64.whl (1.3 MB view details)

Uploaded Aug 17, 2026 CPython 3.12macOS 11.0+ ARM64

mmcfilters-4.1.0-cp311-cp311-win_amd64.whl (1.2 MB view details)

Uploaded Aug 17, 2026 CPython 3.11Windows x86-64

mmcfilters-4.1.0-cp311-cp311-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl (1.5 MB view details)

Uploaded Aug 17, 2026 CPython 3.11manylinux: glibc 2.27+ x86-64manylinux: glibc 2.28+ x86-64

mmcfilters-4.1.0-cp311-cp311-macosx_11_0_x86_64.whl (1.3 MB view details)

Uploaded Aug 17, 2026 CPython 3.11macOS 11.0+ x86-64

mmcfilters-4.1.0-cp311-cp311-macosx_11_0_arm64.whl (1.2 MB view details)

Uploaded Aug 17, 2026 CPython 3.11macOS 11.0+ ARM64

mmcfilters-4.1.0-cp310-cp310-win_amd64.whl (1.2 MB view details)

Uploaded Aug 17, 2026 CPython 3.10Windows x86-64

mmcfilters-4.1.0-cp310-cp310-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl (1.5 MB view details)

Uploaded Aug 17, 2026 CPython 3.10manylinux: glibc 2.27+ x86-64manylinux: glibc 2.28+ x86-64

mmcfilters-4.1.0-cp310-cp310-macosx_11_0_x86_64.whl (1.3 MB view details)

Uploaded Aug 17, 2026 CPython 3.10macOS 11.0+ x86-64

mmcfilters-4.1.0-cp310-cp310-macosx_11_0_arm64.whl (1.2 MB view details)

Uploaded Aug 17, 2026 CPython 3.10macOS 11.0+ ARM64

mmcfilters-4.1.0-cp39-cp39-win_amd64.whl (1.2 MB view details)

Uploaded Aug 17, 2026 CPython 3.9Windows x86-64

mmcfilters-4.1.0-cp39-cp39-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl (1.5 MB view details)

Uploaded Aug 17, 2026 CPython 3.9manylinux: glibc 2.27+ x86-64manylinux: glibc 2.28+ x86-64

mmcfilters-4.1.0-cp39-cp39-macosx_11_0_x86_64.whl (1.3 MB view details)

Uploaded Aug 17, 2026 CPython 3.9macOS 11.0+ x86-64

mmcfilters-4.1.0-cp39-cp39-macosx_11_0_arm64.whl (1.2 MB view details)

Uploaded Aug 17, 2026 CPython 3.9macOS 11.0+ ARM64

File details

Details for the file mmcfilters-4.1.0.tar.gz.

File metadata

Download URL: mmcfilters-4.1.0.tar.gz
Upload date: Aug 17, 2026
Size: 552.9 kB
Tags: Source
Uploaded using Trusted Publishing? No
Uploaded via: twine/7.0.0 CPython/3.14.6

File hashes

Hashes for mmcfilters-4.1.0.tar.gz
Algorithm	Hash digest
SHA256	`b474e968df835449453b2d18752b3330ed16fdbac7d7d67dbede8cb8d9c848c1`
MD5	`2207180bd6079aa9b04feceb1f4b4ace`
BLAKE2b-256	`7d628623590ec8a4b235bc868cc9503727b43256ce086a7fb36f32f07550e5ef`

Algorithm	Hash digest
SHA256	`ca34836060fd549180c16ba56d280da61f5e6a54cf376bb096c34adc21bd4cc7`
MD5	`016381993ccc8a7d0e85f69b5a9c16ec`
BLAKE2b-256	`002cc853a14222734295e308e0db86c3a7a6ecc0134da6652fb7ae48625d2f75`

Algorithm	Hash digest
SHA256	`2d18aa843b9d202f35d63b4522b1fc130c0483a91472cd7ce56d878f986029d9`
MD5	`5481288310d0e4cc6a372ed08cd4bf80`
BLAKE2b-256	`231c13184fd64adbb2fd9337ce5443d6328c112c7c049b8e2dd1d24746c2b4f1`

Algorithm	Hash digest
SHA256	`9b38115b4f65a69372334feabf3a6ebef489e36c30e67cebfec4526e37ba83d0`
MD5	`1a78822735b91baa2d55d39c6829021a`
BLAKE2b-256	`1e65c33af8c3975107f1c5846cfa6d473ac728a46534fdac859d1ac008f76aa0`

Algorithm	Hash digest
SHA256	`794ddf5c7628dcdd0be354470f67fad22d5b8472a02afab32b73b09c4f26b31e`
MD5	`e0f5b64dd72577eb851474f9712eec6a`
BLAKE2b-256	`e19db542771e65a85bfae39fd904b8ee11a0a80ab2277c87fed3706d18c33479`

Algorithm	Hash digest
SHA256	`4ef0637079f8a2017ab8b731dd93574a1211716ea75bc2365c778abbbd468d47`
MD5	`0b49b60fb3a4d00371f68ab4962e361c`
BLAKE2b-256	`abb1d486fe5dfae14c59da7db26cde1953d34731432d3dc9b182f99cff666a11`

Algorithm	Hash digest
SHA256	`e6fe683bdf13f7cf2dcc802056f1d20fb8f9af33661a6bec7d3ec8a27fd2f047`
MD5	`5730798a62a2f2d9ed339af240c2482c`
BLAKE2b-256	`2b2679c3b965761d0b7b8abe0e81c57573a0a881592431fef8232d565f2eabed`

Algorithm	Hash digest
SHA256	`b348e022629dd626dbb85a7c4549f2b41f4200693de4401b776968bdf17a171e`
MD5	`f078f38b6fdcbd6335a0b9d6343bfc3b`
BLAKE2b-256	`8169220635b571f95a13cb5012e5a30b0ee70958a7d009b889b12db35370278b`

Algorithm	Hash digest
SHA256	`1c60449a19be656a4ac97833f9e2f2d1acfb83e96a767b95aac35b557c6f9ef3`
MD5	`6d685e29174b48d8a5ee6f9ca14caf13`
BLAKE2b-256	`14e6683f0273ff96e598d62a5d4b8aefa21f7b6d92f567514b259086d53dfb87`

Algorithm	Hash digest
SHA256	`a3dcf85bc77a22fb9cf2eaa6ea1db4d5561a4aca8751dce6c2874df4c17f62ad`
MD5	`4b49856413a7488644ca4d610249478b`
BLAKE2b-256	`2ba9977f57fa031ba4e9fc8ad09dc8d4ba8b11552db3e0590421d3e186ad3a85`

Algorithm	Hash digest
SHA256	`fd65bf11210b92ab46cde68c72c41c480f87ed683b2cf56a54f60b3a9be8ea27`
MD5	`d189870a6432647799fa901bce0c1831`
BLAKE2b-256	`80d5b9989f67a827c6cb0734a4f4fb10af8914878cfff417c8168305d107254b`

Algorithm	Hash digest
SHA256	`11444d0213c78589505249a08aac26fb560deb50397dd7b91770ce181801131b`
MD5	`af815301e7720196ec4f91b34f9a4f30`
BLAKE2b-256	`1075bb078f125033c00eba02d5c25753215f27f5b5886e21e360b149649cd12c`

Algorithm	Hash digest
SHA256	`f5b8c13e94e137f6f29bbd0fdd189a96e156a24bf3038b7726124e021be663b6`
MD5	`828e5f619d29f5774058bcb0c48c7325`
BLAKE2b-256	`deeb44261c3bac1cf9cf987c1d2a77da8b1746e0eb3939f09d109d308801b6d9`

Algorithm	Hash digest
SHA256	`a45e0f01d90db675dc0de8997b3466d2d1d354829e6a54895dea4d66bd4e2095`
MD5	`65538f9e69b1a5877b1a68d388528e8f`
BLAKE2b-256	`cd9e58cd0aad73e82d91f041d40fee8a18b2b2dd85d220f1198abe2d2feeccdd`

Algorithm	Hash digest
SHA256	`0bb74760f8de4675094cb9e9f7f1a73a1c62c2880a736ab858953b8625ef572d`
MD5	`03cd3a8e1e70dfb203e650ecbbcaec7c`
BLAKE2b-256	`8ddf186492fd790217de00f7a8f4ffef1e956fd5d5afa61813046e2134fb7bd1`

Algorithm	Hash digest
SHA256	`b084d71f19288894d29186907379ae34495474b4dbdb9bcd3eda20ef81be2c47`
MD5	`b78d945bd08a050272995d055a1b0501`
BLAKE2b-256	`715e6f4e709a4476109098be05f9020c450d8b8b7a125bef07c3d0f2af1c661e`

Algorithm	Hash digest
SHA256	`c41430f7216ca4c35f5a4ea40748d4b56f25400f1540422de163f27d94607e4a`
MD5	`d5cc11e815187ae2b0437d02ad1445f5`
BLAKE2b-256	`9f75344d1838ce5dcfdc2428ba992e29a76589b24e21544d9dbe438e65a8b01a`

Algorithm	Hash digest
SHA256	`fa102ff2abc171e75aec367b2f455fd24712477d67c1896d7259b319edff3f7f`
MD5	`401bfc94dd86e8cf56f59010405d7011`
BLAKE2b-256	`43e0057f104cf9614ef6732879c9446fd218ad76d79b2847ca1ed58b2be43bba`

Algorithm	Hash digest
SHA256	`477f8c5294b4872de8db6823177e7d1c777075af9d05314fa60769444e007af7`
MD5	`8c4847ba336300443d2dc15268347341`
BLAKE2b-256	`0233129aea3ca5579ecbc488e0b6c76dc8373bba4d7a9b32ba6200416eec82bf`

Algorithm	Hash digest
SHA256	`393586ef50a62f0199d781168fbb28745ad8268751c23616738b1e07ddca6e85`
MD5	`b6f4e13604e64569a97a09f200e732dd`
BLAKE2b-256	`8776a5adcf2642b8a83108aade44b218a35c136acb015c3472251a65109ea39a`

Algorithm	Hash digest
SHA256	`d4d5debf17c598bb890d2590b5d08da8e0937e35a99f390e25513fb7083f8124`
MD5	`c304f8f0ac9e283b62c26bfff5d05840`
BLAKE2b-256	`a9f68dc1c4e0b1edf85a7cbe1e3965c768670a597882e0f716fe9fa135e024c0`

mmcfilters 4.1.0

mmcfilters

Main capabilities

Requirements

Installation

Quick start

Documentation

User guides

References

Contributor guides

License

Project links

Key dates

1 maintainer

Credits

License

Requires

Tags

Classifiers

Download files

Source Distribution

Built Distributions

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

Algorithm	Hash digest
SHA256	`78cedf1e63df19da4a94ae6e83a35a3231400a2d4aead8b15eb92c5e0c272b65`
MD5	`3544d3dc7c3b77b83e950c27d91aaf82`
BLAKE2b-256	`26832df0f4f9aabf691b91bfa4651ca3b8f7a4c88abfb4d1570a02a4291d2839`

Algorithm	Hash digest
SHA256	`d34f2a495a267de0a4709422f9f1cb84bb0419ce2eea73f637257e112433920d`
MD5	`38d85731c4e0d252610ce5fe4e00dfab`
BLAKE2b-256	`79682c077e5d96e901014039a5547d40fba07a9dfbca1d034ac94b91a343571e`

Algorithm	Hash digest
SHA256	`1a7a869f9626bdde71d8b67679cc59719b4106bb98be8690347285548f0a4865`
MD5	`c6b8e389c800d904394f1b26bb88e429`
BLAKE2b-256	`b5f0b319e6a4ff65cca6285cb400a05ffd846ffb52f3dbeef1507da5f0b1f4a9`

Algorithm	Hash digest
SHA256	`563151353a919c8d11002e1cca3bf3223be8d803a04575740bd8a9b84238830e`
MD5	`be9b31f46a18c908639d2061a344b128`
BLAKE2b-256	`d0f90b1a2a202ca6a147b1579d0816e714e2a40c69ae67948b681e18afe41695`