Repository navigation
QuADMESH v0.2.5
Pre-releaseDocumentation and metadata release, with one algorithm fix: the boundary layer is now routed as the thesis specifies.
Added
-
quadmesh-benchandquadmesh.benchmark: adapter harness comparing QuADMESH+ with other triangle-to-quad methods and, when the executables are installed, Gmsh Blossom-Quad and QuadriFlow (subprocess only, nothing vendored). Results for the bundled meshes are indocs/benchmarks/0.3.0/. -
n_concaveincompute_quality_statsandconcave=Ninformat_quality_report: count of quads with a reflex corner. -
docs/algorithm.md: one long-form document for the thesis algorithm, the port as implemented, a thesis-versus-port difference table, the experimental global-matching fallback, its relation to Blossom-Quad (Remacle et al. 2012), and MATLAB parity status. -
tests/test_release_metadata.py: guard test that fails whenCITATION.cfforREADME.mdnames a DOI other than the Zenodo concept DOI10.5281/zenodo.20350483. -
Ethan J. Kubatko (Ohio State University) as second author in
CITATION.cff. -
preserve_boundaryoption (defaultFalse) onrun_pipelineandpost_process_routine, plusprotected_pointsonpost_process_routineandcleanup_boundary_quads, and the CLI flag--preserve-boundary. With it on, boundary-quad cleanup skips any collapse that would delete an original boundary vertex and any shift that would move one. On the four bundled meshes this changes vertices lost from 12, 18, 4 and 2 to 0, at a cost of 1 to 9 extra elements and 0.001 to 0.011 mean skew. The default stays MATLAB-faithful.
Known limitations
- Some boundary-layer quads can be concave. Smoothing can push a wide pinned boundary corner past 180 degrees. Both are tracked for a later release.
Changed
- Test fixtures now come from the Valence API through
chilmesh.registry(VALENCE_TOKEN), pinned by SHA-256. The GitHub contents fetcher, theGITHUB_TOKENpath and the git-blob pins are removed.Mixed_Test.14left the registry (Valence#347), so its tests skip. - Dependency pin raised to
chilmesh>=1.5.5. - README opening states what the conversion keeps and adds, and links to
docs/algorithm.md. The status banner no longer carries a month stamp. CITATION.cffandREADME.mdcite the Zenodo concept DOI10.5281/zenodo.20350483in place of the version DOI10.5281/zenodo.20351165.- Version is 0.2.5 in
pyproject.toml,src/quadmesh/__init__.py, andCITATION.cff. scripts/dev_setup.shinstalls chilmesh from PyPI by default. SetQUADMESH_CHILMESH_SRC=<path>to editable-install a local CHILmesh checkout instead.
Fixed
- The per-layer sweep flagged the innermost layer (
n_layers - 1) as the boundary layer. It now flags layer 0, which is the boundary layer inchilmeshand inremoveTrianglesFun.m. Output keeps zero interior residual triangles, is quad-pure by default, and keeps every original boundary vertex. Mean skew on the bundledstructuredMesh1changes from 0.696 to 0.647, and the expected values in the quality tests were updated (spec 059). fem_smoothernow restores the exact coordinates of every boundary vertex after each pass.CHILmesh.direct_smootherpins the boundary with a penalty and left up to 2e-10 of drift (no fixed-vertices argument exists).tests/test_boundary_pinned_smoothing.pycovers all bundled triangular meshes. By defaultrun_pipelinecan still drop original boundary vertices, becausecleanup_boundary_quadscollapses boundary quads as the MATLAB code does; smoothing does not cause it. Passpreserve_boundary=True(CLI:--preserve-boundary) to keep all of them.AGENTS.mdandscripts/dev_setup.shstated that chilmesh is not on PyPI. It is (chilmesh>=1.2.1).
Removed
docs/algorithm_writeup.md. Its content is section 5 ofdocs/algorithm.md, relabelled as the experimental fallback path.
Roadmap at 0.2.5
- Now: boundary-layer quality, including the ENPAC2003 low-skew tail (#90); right-size the test suite (#109).
- Next: boundary-type-aware layer seeding (#77); a MATLAB parity oracle (#116); wire tri2quad(aggressive=) to CHILmesh merge_elements.
- Later: parallelization (#38); evaluate a C++ or Rust backend; formal integration with ADMESH and CHILmesh.
How to cite
Mattioli, D. O., & Kubatko, E. J. (2026). QuADMESH+: Quadrangular ADvanced Mesh generator (Version 0.2.5) [Computer software]. Zenodo. https://doi.org/10.5281/zenodo.20350483