Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[0.16.1] - 2024-12-29

Implemented a more efficient internal parametric transformation for Meshes.Tetrahedron, resulting in about an 80% integral performance improvement.

Fixed a bug where integral would default to diff_method=AutoEnzyme() even when the Enzyme extension isn't loaded.

Added a diff_method keyword argument to the integral API, allowing the user to specify which differentiation method should be used when calculating differential element magnitudes throughout the integration domain.
Implemented DifferentiationMethod types:
- FiniteDifference for finite-difference approximation.
- AutoEnzyme for using Enzyme.jl automatic differentiation (AD) via a package extension.
Added diff_method as an optional third argument to the jacobian and differential API.
Adds standardized support for integrating over Tetrahedron volumes.
Generalizes integrand functions to support any f::Any with a method defined for f(::Point).
Refactored specialization methods by implementing an internal _ParametricGeometry <: Meshes.Geometry to define geometries with custom parametric functions, standardizing support for BezierCurve, Line, Plane, Ray, Tetrahedron, and Triangle.
Significant performance improvements:
- Achieved an 80x improvement when integrating over BezierCurve.
- Achieved an up-to-4x improvement when integrating using HAdaptiveCubature.

Deprecated manual specification of GaussKronrod rules for surfaces, i.e. geometries where Meshes.paramdim(geometry) == 2. A warning is now generated recommending users switch to HAdaptiveCubature.

Refactored the unit test system.
- Standardized combinations.jl tests by constructing a TestableGeometry package and passing it to a @test generation function to provide more thorough and standardized test coverage.
- Reorganized @testsnippets to exist in same source file as relevant tests.
- Removed :extended tag from Tetrahedron now that performance is significantly improved.

MeshIntegrals.jl is now owned by the JuliaGeometry organization!

Tagged unit tests for Meshes.Box (4D) and Tetrahedron as :extended, removing them from automatic CI testing due to lengthy compute times.

Adds official support and unit testing for integrating new Meshes.ParametrizedCurve geometries.

Adds support for integrating geometries with any number of parametric dimensions by generalizing differential to n-dimensions via geometric algebra.
Adds official support and unit testing for integrating Meshes.Ellipsoid and Meshes.Hexahedron geometries.

Refactored the unit test system.
- Completed transition away from previous @test generation system which only tested unit integrands (i.e. f(point) = 1.0) using Meshes.measure as a benchmark.
- Used TestItems.jl to define independent @testitem packages, many with analytically-derived solutions.

Adds official support and unit testing for integrating Meshes.Quadrangle geometries.

Fixed a bug in differential finite-difference approximation that may have reduced accuracy of some integral calculations.
Made improvements to type stability with floating point type keyword argument FP.

Rename IntegrationAlgorithm to IntegrationRule and consolidate terminology around integration rules (versus "algorithms", "settings", etc).
Convert floating point precision option FP from an optional argument to a keyword argument.
Continued work transitioning away from previous @test generation system.

Remove derivative and unitdirection functions. All derivative functionality was merged into jacobian.