How onera/maia works
Maia is a Python/C++ library for parallel algorithms and manipulations on CGNS meshes. Its core workflow is to represent mesh data as CGNS trees, partition or distribute those trees, apply mesh algorithms, and exchange or recover data across representations. The README identifies ParaDiGM as the parallel backend. The tree also shows substantial I/O, PyTree utilities, and mesh-checking capabilities. Several relationships below are documented at product level; sampled source gives more specific evidence for point search and transfer behavior, while unsampled internals are not assumed.
Main entry points: __init__.py Maia API · protocols.py Exchange protocols · geosearch.py Point localization · index_exchange.py Partition to block
Components 23
CGNS Trees
- PyTree model
maia/pytree/node/access.py - Tree search
maia/pytree/maia/search.py - Tree inspection
maia/pytree/maia/inspect.py - Tree traversal
maia/pytree/walk/node_walker.py - CGNS definitions
maia/pytree/sids/elements_utils.py
Mesh Distribution
- Mesh factories
maia/factory/dcube_generator.py - Mesh partitioning
maia/factory/partitioning/partitioning.py - Boundary orientation
maia/factory/partitioning/part_bound_orient.py - Tree recovery
maia/factory/dist_from_part.py
Mesh Algorithms
- Geometry tools
maia/algo/part/geometry/measures.py - Point cloud tools
maia/algo/part/point_cloud_utils.py - Isosurface extraction
maia/algo/part/isosurf.py - Point localization
maia/algo/geosearch.py
Parallel Transfer
- Exchange protocols
maia/transfer/protocols.py - Partition to block
maia/transfer/part_to_dist/index_exchange.py - Block to partition
maia/transfer/dist_to_part/data_exchange.py - Transfer utilities
maia/transfer/utils.py
I/O and Validation
- CGNS mesh I/O
maia/io - CGNS checking
bin/_cgns_check
Other components
- Library user
- Maia API
maia/__init__.py - ParaDiGM
- MPI runtime
Connections 12
- Library user → Maia API: uses
README.md - Maia API → PyTree model: exposes
maia/__init__.py - Maia API → Mesh factories: exposes
maia/__init__.py - Maia API → CGNS mesh I/O: exposes
maia/__init__.py - Maia API → Exchange protocols: exposes
maia/__init__.py - Point localization → PyTree model: reads trees
maia/algo/geosearch.py - Point localization → MPI runtime: uses communicator
- Partition to block → Exchange protocols: exchanges indices
maia/transfer/part_to_dist/index_exchange.py - Partition to block → Transfer utilities: uses numbering
maia/transfer/part_to_dist/index_exchange.py - Block to partition → Exchange protocols: uses protocols
maia/transfer/dist_to_part/data_exchange.py - Mesh factories → ParaDiGM: uses backend
- Maia API → ParaDiGM: uses backend
README.md