v0.2.0: Major Revamp & Modernization #30

popersson · 2026-01-22T02:23:00Z

v0.2.0: Major Revamp, Modernization, and MIT License

Overview

Version 0.2.0 represents a major rewrite of DistMesh.jl, focusing on replicating the original 2D code but with better performance, native Julia implementations, and integration with the Makie/Plots ecosystems. This version is now fully MIT licensed.

⚠️ Breaking Changes & Legacy Support

The original N-dimensional meshing code port (legacy distmeshnd) has been retired to allow for a cleaner architecture and licensing model.

Removed: src/distmeshnd/ and bench/ directories.
Removed: Exports for distmeshnd, HUniform, and DistMeshSetup.
Action for Users: If you require the legacy functionality, please pin your package version to v0.1: ] add DistMesh@0.1

- Moved legacy 3D code to submodule `src/distmeshnd/` - Created `src/dmesh.jl` for new `DMesh` types and utilities - Updated `Project.toml`: - Bumped Julia compat to 1.10 - Added new dependencies - Updated tests to use `DistMeshND` alias for internal legacy functions

… examples/, and Literate.jl.

Live plotting support.

Fix triangule orientation of Delaunator's delaunay.

Default fig size 600x600 instead of 800x800.

Revert Makie figure size to default.

Updates the LICENSE file to the standard MIT License and adds the license metadata to Project.toml. This change is part of the package modernization to align DistMesh.jl with the broader Julia ecosystem. Note: This re-licensing covers legacy code copyrighted by Steve Kelly; the change is being coordinated with the authors and is pending final confirmation.

Version updates on Makie in Project.toml.

This commit officially retires the legacy `distmeshnd` module to establish a clean slate for version 0.2.0. Major Changes: - Removed `src/distmeshnd/` and `bench/` directories. - Removed legacy exports (`distmeshnd`, `HUniform`, `DistMeshSetup`) from the main module. - Cleaned `Project.toml` dependencies (removed packages used only by legacy code). - Updated `test/runtests.jl` to exclude legacy test suites. Documentation & Licensing: - Switched `LICENSE` to standard MIT (removed previous dual-copyright notices). - Updated `Project.toml` authors list. - Updated README.md with a "Legacy Support" notice advising users to pin v0.1 for old functionality. - Removed documentation pages and references related to the legacy implementation.

codecov · 2026-01-22T02:32:07Z

Codecov Report

❌ Patch coverage is 63.43612% with 83 lines in your changes missing coverage. Please review.
✅ Project coverage is 63.59%. Comparing base (8cf429a) to head (eb5a894).
⚠️ Report is 3 commits behind head on master.

Files with missing lines	Patch %	Lines
ext/DistMeshGLMakieExt.jl	0.00%	32 Missing ⚠️
src/meshutils.jl	62.00%	19 Missing ⚠️
src/dmesh.jl	22.72%	17 Missing ⚠️
ext/DistMeshCairoMakieExt.jl	54.54%	5 Missing ⚠️
ext/DistMeshPlotsExt.jl	0.00%	5 Missing ⚠️
src/distfuncs.jl	85.71%	5 Missing ⚠️

Additional details and impacted files

@@             Coverage Diff             @@
##           master      #30       +/-   ##
===========================================
- Coverage   86.84%   63.59%   -23.25%     
===========================================
  Files           8        8               
  Lines         380      228      -152     
===========================================
- Hits          330      145      -185     
- Misses         50       83       +33

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

…ion).

ViralBShah · 2026-01-22T23:25:24Z

Thanks @popersson. This looks amazing.

@oscardssmith Would you be able to take a quick look here and see if you like the dependencies being used (as in they are the well maintained ones). They look pretty solid to me. Any other comments you may have overall would be valuable.

@sjkelly We discussed this overhaul a while ago, and you may overall like seeing it. I think it should be ok to move the license to MIT since the entire codebase is overhauled, and it is by the original author of DistMesh anyways.

ViralBShah · 2026-01-22T23:56:18Z

I feel the best thing would be to merge this quickly and then iteratively fix on master with multiple small PRs.

oscardssmith · 2026-01-23T01:30:01Z

deps look reasonable to me.

ViralBShah · 2026-01-23T19:02:20Z

We should have a Project.toml in examples with all the dependencies so that it is easy to run them.

popersson · 2026-01-23T21:14:02Z

@ViralBShah Done! I’ve added a Project.toml and Manifest.toml to the examples/ directory.

It is set up to use GLMakie (since these are interactive examples) and points to the local DistMesh development version. I included the Manifest.toml so the environment is frozen and can be run immediately for anyone cloning the repo.

ViralBShah · 2026-01-24T11:59:20Z

In general, it is not a good idea to have a Manifest.toml checked in - and best to have the bounds you need in Project.toml. I suggest we keep only a Project.toml, and only check in a Manifest.toml later should things become too problematic to get running.

The top level project should generally be set up to run with Project.toml, so that dependencies can be resolved by Pkg when it is being used with other packages.

There is also a circle_mesh.png file that is checked in the project root directory. Is it required? If so, perhaps it should be moved to a subdirectory.

ViralBShah · 2026-01-24T12:02:28Z

With the Project.toml in examples, I am able to run both the examples. It feels quite snappy.

ViralBShah · 2026-01-24T12:17:49Z

@asinghvi17 Any thoughts on this revamp?

…to v0.2-revamp

Copilot

Pull request overview

This PR represents a major version bump (v0.1 → v0.2) that fundamentally restructures DistMesh.jl with a focus on 2D meshing. The package transitions from GPL v2 to MIT licensing and replaces the N-dimensional meshing implementation with a cleaner, more performant 2D-focused architecture.

Changes:

Complete rewrite of the 2D meshing algorithm using native Julia implementations with StaticArrays and Delaunator
Removal of legacy 3D/N-dimensional meshing code (distmeshnd, quality metrics, Hilbert sorting, TetGen integration)
New plotting integration via package extensions for Plots.jl, GLMakie, and CairoMakie
Comprehensive documentation overhaul with new examples and API reference
New mesh data structure (DMesh) with utility functions for mesh validation and cleanup

Reviewed changes

Copilot reviewed 34 out of 37 changed files in this pull request and generated 7 comments.

Show a summary per file

File	Description
LICENSE	Changed from GPL v2 to MIT license
Project.toml	Updated dependencies, added extensions for plotting backends, increased minimum Julia version to 1.10
README.md	Completely rewritten with quick start guide and migration notes for v0.1 users
src/DistMesh.jl	Streamlined module with new 2D-focused architecture
src/dmesh.jl	New `DMesh` type for mesh representation with iteration support
src/distmesh2d.jl	New 2D meshing implementation with improved algorithm
src/distfuncs.jl	Distance function library (circles, rectangles, polygons, CSG operations)
src/meshutils.jl	Mesh utilities including Delaunay wrapper, element quality/volume calculations, cleanup
src/{distmeshnd,quality,tetgen,diff,decompositions,hilbertsort,pointdistribution}.jl	Removed legacy 3D/ND code
ext/*.jl	New plotting extensions for Plots, GLMakie, and CairoMakie
test/runtests.jl	Replaced legacy 3D tests with 2D mesh validation and example execution tests
test/vals.jl	Removed legacy test data
docs/*	Complete documentation rewrite with examples and API reference
examples/*.jl	New example scripts for polygon and NACA airfoil meshing
bench/*	Removed all benchmark scripts
.github/workflows/ci.yml	Minor updates to CI configuration

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Copilot · 2026-01-24T12:35:36Z

src/meshutils.jl

+    scaling = maximum(norm.(p))
+    pp = [snap.(p1, scaling) for p1 in p]


Potential division by zero: If all nodes in the mesh are at the origin (or very close to it), maximum(norm.(p)) on line 157 could be zero or near-zero, leading to numerical issues in the snap function on line 158. Consider adding a check for this edge case or using a minimum threshold for scaling.

Copilot · 2026-01-24T12:35:37Z

src/distmesh2d.jl

+        d = project_nodes!(p, dfcn, deps)
+
+        # Terminate if small (interior) node movements
+        converged = maximum(norm.(dp[d.<-geps])) < dptol


Potential error on empty mesh: If dp[d.<-geps] results in an empty array (e.g., when all nodes are outside the domain in an iteration), maximum() will throw an error. Consider adding a check or using isempty() before calling maximum(), or provide a default value using maximum(...; init=0.0).

Suggested change

converged = maximum(norm.(dp[d.<-geps])) < dptol

converged = maximum(norm.(dp[d .< -geps]); init = 0.0) < dptol

Copilot · 2026-01-24T12:35:37Z

src/meshutils.jl

+        numerator = (b + c - a) * (c + a - b) * (a + b - c)
+        return 8 * (s - a) * (s - b) * (s - c) / (a * b * c) 


Inconsistent quality formula: The comment states "Quality = 2*r/R" but the implementation on line 97 calculates 8 * (s - a) * (s - b) * (s - c) / (a * b * c). While these may be equivalent formulas, the implementation doesn't match the simplified formula derivation shown in the comments. The numerator variable on line 96 is calculated but never used. Consider either removing the unused variable or clarifying the formula equivalence in the comments.

Copilot · 2026-01-24T12:35:37Z

src/meshutils.jl

+    elseif length(el) == 4 && length(el[1]) == 2 # Example: Quad (2D) logic check
+        # Quad logic
+        error("2D Quadrilaterals not yet implemented")


Unreachable code: The condition on line 59 elseif length(el) == 4 && length(el[1]) == 2 can never be reached because the previous condition on line 56 elseif length(el) == 4 will match first. If both 3D tetrahedra and 2D quads need to be distinguished, check the dimension of the first element before checking the element count, or reorder the conditions.

examples/002-naca_airfoil.jl

.github/workflows/ci.yml

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

This reverts commit 95a7f00.

popersson added 30 commits December 31, 2025 11:44

show function for DMesh

9e4858f

Default Int32

7ba3fa3

Major documentation update: New file structure, automated scripts for…

0ba197b

… examples/, and Literate.jl.

Plots extension, updated examples and docs.

07770b5

examples moved to the examples/ directory

6645d26

Rename obscure vector short-hands to more common Point2, Index2, Index3

22ad022

Fixed live-plotting with internal do-nothing function and warning.

86a9e07

CairoMakie and GLMakie support.

7f11857

Live plotting support.

Rename Point2 -> Point2d to be consistent with GeometryBasics

040ce74

Minor plotting tweaks.

dde65ad

Major Gemini pass on the doc strings

9344bb3

Various improvements of meshutils.

c35ba9e

Fix triangule orientation of Delaunator's delaunay.

Rewriting of README and first section of docs.

ed82a6a

Default fig size 600x600 instead of 800x800.

Minor docs update.

418025e

Revert Makie figure size to default.

Fix inconsistent figure sizes in docs.

7d72ef1

New subsection outlines.

a27569c

Added implicit function example.

70ffd4e

Remove CairoMakie from doc build.

a6ed80b

Run all scripts in examples/ as part of the unit tests.

d8be8e4

Added more unit tests for distmesh2d

eb38535

More docs and docstring examples.

a18446a

Many minor changes to docs and examples.

80d9f97

Another try on CairoMakie for all docs.

e14ef73

Version updates on Makie in Project.toml.

CI build docs on new dev branch.

6e9b036

Add Literate.jl dependency.

f5b09ce

Added StaticArrays dependency.

156c907

Resolve case-insensitive name conflict (for Windows/MacOS).

c563daa

Mesh utilities: Improvements, name changes, docstrings.

2db7d0b

popersson added 2 commits January 21, 2026 16:09

Figure size updates in docs.

ea0c1c5

popersson and others added 2 commits January 22, 2026 10:29

Adding back weak dependency on GeometryBasics (for the GLMakie extens…

1c0feb2

…ion).

Merge branch 'master' into v0.2-revamp

8ba401f

popersson added 2 commits January 23, 2026 13:03

Adding missing GeometryBasics dependency in main Project.toml.

dad2ad0

Add examples environment with frozen dependencies

f87eb49

ViralBShah and others added 3 commits January 24, 2026 07:24

Merge branch 'master' into v0.2-revamp

3c037f6

Use v1 of Documenter always.

6188528

Merge branch 'v0.2-revamp' of github.com:JuliaGeometry/DistMesh.jl in…

9626a63

…to v0.2-revamp

ViralBShah requested a review from Copilot January 24, 2026 12:30

Copilot started reviewing on behalf of ViralBShah January 24, 2026 12:31 View session

Copilot AI reviewed Jan 24, 2026

View reviewed changes

ViralBShah and others added 4 commits January 24, 2026 07:39

Update examples/002-naca_airfoil.jl

7d81f5a

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Update examples/002-naca_airfoil.jl

24a1c47

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Update .github/workflows/ci.yml

95a7f00

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Revert "Update .github/workflows/ci.yml"

eb5a894

This reverts commit 95a7f00.

		scaling = maximum(norm.(p))
		pp = [snap.(p1, scaling) for p1 in p]

	converged = maximum(norm.(dp[d.<-geps])) < dptol
	converged = maximum(norm.(dp[d .< -geps]); init = 0.0) < dptol

		numerator = (b + c - a) * (c + a - b) * (a + b - c)
		return 8 * (s - a) * (s - b) * (s - c) / (a * b * c)

v0.2.0: Major Revamp & Modernization #30

Are you sure you want to change the base?

v0.2.0: Major Revamp & Modernization #30

Uh oh!

Conversation

popersson commented Jan 22, 2026

v0.2.0: Major Revamp, Modernization, and MIT License

Overview

⚠️ Breaking Changes & Legacy Support

Uh oh!

codecov bot commented Jan 22, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Codecov Report

Uh oh!

ViralBShah commented Jan 22, 2026

Uh oh!

ViralBShah commented Jan 22, 2026

Uh oh!

oscardssmith commented Jan 23, 2026

Uh oh!

ViralBShah commented Jan 23, 2026

Uh oh!

popersson commented Jan 23, 2026

Uh oh!

ViralBShah commented Jan 24, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

ViralBShah commented Jan 24, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

ViralBShah commented Jan 24, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Copilot AI Jan 24, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Jan 24, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Jan 24, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Jan 24, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

codecov bot commented Jan 22, 2026 •

edited

Loading

ViralBShah commented Jan 24, 2026 •

edited

Loading

ViralBShah commented Jan 24, 2026 •

edited

Loading