Computational Mesh Generation — Ecosystem
Automatic unstructured mesh generation for 2D shallow-water hydrodynamic models (ADCIRC), ported from research MATLAB to production Python. Origin: Mattioli, D. D. (2017). QuADMESH+: A Quadrangular ADvanced Mesh Generator for Hydrodynamic Models [Master's thesis, Ohio State University]. OhioLINK.
This site is the navigation, concepts, roadmap, and ecosystem layer. Each repository is the source of truth for its code, specs, and governance. If a page here contradicts a repo, the repo wins.
Projects
| Project | What it is | Links |
|---|---|---|
| ADMESH | Advanced, automatic unstructured triangular mesh generator for shallow-water domains; faithful Python port of the MATLAB ADMESH library with native ADCIRC fort.14 I/O |
docs + demo · PyPI admesh2D · source |
| ADMESH-Domains (Valence) | Federated registry of ADCIRC-compatible mesh domains: 13 domains, 40 meshes, TOML manifests with provenance tracking | registry · PyPI admesh-domains · source |
| CHILmesh | Mesh data structure and FEM smoother for 2D triangular, quadrilateral, and mixed-element meshes; C++ half-edge backend delivers a 46× initialization speedup over pure Python | PyPI chilmesh · source |
| QuADMESH+ | Quadrangular ADvanced MESH generator: layer-ordered triangle-to-quad conversion from the 2017 thesis, in active Python port | source |
Start here
| You want… | Look at… |
|---|---|
| Conceptual primer | Concepts — distmesh, size field, SDF, medial axis, BC types |
| End-to-end walkthrough | Pipeline — domain → triangulate → fort.14 → ADCIRC |
| Module map | Architecture overview |
| Where the project is going | Roadmap — 0.1.0 gate + post-v1 |
| How the projects fit together | Ecosystem — CHILmesh, MADMESHR, ADMESH-Domains, ADCIRC |
| Question that comes up often | FAQ |
| Contributing | Contributing |
fort.14 reference |
fort.14 cheat sheet |
Look at the repos for…
| Artifact | Path |
|---|---|
| Install + quickstart | ADMESH/README.md |
| Active feature spec | specs/002-size-field-defaults/ |
| Shipped foundation spec | specs/001-pythonize-and-fort14-integration/ |
| Active project plan | docs/governance/PROJECT_PLAN.md |
| Constitution + rules | docs/governance/CONSTITUTION.md |
| MATLAB → Python substitutions log | docs/PORTING_NOTES.md |
| Open issues | ADMESH issues |
What this site never duplicates
PR-reviewed, version-locked to the code — read in the repos only: governance constitutions, project plans, feature specs, porting notes, and session operational references.
Status
ADMESH 0.1.0 in progress. First PyPI tag follows when the Tier-2 / WNAT structural-validity gate is green and the three open release-blockers (#10, #11, #12) close. See Roadmap for detail.
Mattioli, D. D. — GitHub · Google Scholar