Version 0.2.1

.github/workflows/main.yml

@@ -10,7 +10,7 @@ jobs:
     strategy:
       matrix:
         arch: [x86_64]
-        cw_build: ["cp39-*", "cp310-*", "cp311-*", "cp312-*", "cp313-*"]
+        cw_build: ["cp310-*", "cp311-*", "cp312-*", "cp313-*", "cp314-*"]
 
     steps:
     - uses: actions/checkout@v4
@@ -35,7 +35,7 @@ jobs:
     strategy:
       matrix:
         arch: [arm64]
-        cw_build: ["cp39-*", "cp310-*", "cp311-*", "cp312-*", "cp313-*"]
+        cw_build: ["cp310-*", "cp311-*", "cp312-*", "cp313-*", "cp314-*"]
 
     steps:
     - uses: actions/checkout@v4
@@ -60,7 +60,7 @@ jobs:
     strategy:
       matrix:
         arch: [x86_64]
-        cw_build: ["cp39*many*", "cp310*many*", "cp311*many*", "cp312*many*", "cp313*many*"]
+        cw_build: ["cp310*many*", "cp311*many*", "cp312*many*", "cp313*many*", "cp314*many*"]
 
     steps:
     - uses: actions/checkout@v4
@@ -85,7 +85,7 @@ jobs:
     strategy:
       matrix:
         arch: [AMD64]
-        cw_build: ["cp39-*", "cp310-*", "cp311-*", "cp312-*", "cp313-*"]
+        cw_build: ["cp310-*", "cp311-*", "cp312-*", "cp313-*", "cp314-*"]
 
     steps:
     - uses: actions/checkout@v4

.github/workflows/test_full.yml

@@ -18,7 +18,7 @@ jobs:
       SPLINEPY_GITHUB_ACTIONS_BUILD: True
     strategy:
       matrix:
-        python-version: [3.9, "3.10", "3.11", "3.12", "3.13"]
+        python-version: ["3.10", "3.11", "3.12", "3.13", "3.14"]
         os: [ubuntu-latest, macos-latest, windows-latest]
 
     steps:

.gitmodules

@@ -3,10 +3,10 @@
 	url = git@github.com:pybind/pybind11.git
 [submodule "third_party/napf"]
 	path = third_party/napf
-	url = git@github.com:tataratat/napf.git
+	url = git@github.com:isosuite/napf.git
 [submodule "third_party/BSplineLib"]
 	path = third_party/BSplineLib
-	url = git@github.com:tataratat/BSplineLib.git
+	url = git@github.com:isosuite/BSplineLib.git
 [submodule "third_party/bezman"]
 	path = third_party/bezman
-	url = git@github.com:tataratat/bezman.git
+	url = git@github.com:isosuite/bezman.git

.pre-commit-config.yaml

@@ -6,7 +6,8 @@
 
 # use default options for ci
 ci:
-  autoupdate_schedule: "weekly"
+  autoupdate_branch: 'develop'
+  autoupdate_schedule: "monthly"
   submodules: false
 
 repos:
@@ -24,24 +25,19 @@ repos:
   - id: check-yaml
   - id: debug-statements
   - id: end-of-file-fixer
+    exclude: '^tests/data/.*$'
   - id: mixed-line-ending
   - id: requirements-txt-fixer
   - id: trailing-whitespace
 
-- repo: https://github.com/psf/black-pre-commit-mirror
-  rev: "26.3.1"
-  hooks:
-  - id: black
-    additional_dependencies: [tomli]
-
 - repo: https://github.com/astral-sh/ruff-pre-commit
-  rev: v0.15.7
+  rev: v0.15.16
   hooks:
     - id: ruff
       args: [--fix, --exit-non-zero-on-fix]
 
 - repo: https://github.com/pre-commit/mirrors-clang-format
-  rev: v22.1.1
+  rev: v22.1.5
   hooks:
   - id: clang-format
     types_or: [c, c++]

CHANGELOG.md

@@ -0,0 +1,157 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.2.1] - 2026-06
+
+### Added
+
+#### Swept Surface/Solid Generation
+- New `splinepy.helpme.create.swept()` function for generating swept surfaces and solids by sweeping a cross-section along a trajectory spline ([examples/show_swept.py](examples/show_swept.py))
+  - Supports curve (1D) and surface (2D) cross-sections to produce surfaces and solids respectively
+  - Cross-section orientation uses the projection-normal method (Siltanen & Woodward), following [The NURBS Book](https://link.springer.com/book/10.1007/978-3-642-59223-2), Piegl & Tiller, 2nd ed., Chapter 10.4
+  - Supports closed trajectories with orientation correction (p. 483 of the NURBS book)
+  - `anchor` parameter controls which reference point of the cross-section is placed on the trajectory (`"parametric"`, `"control_box"`, `"geometry_box"`, or `"auto"`)
+  - `set_on_trajectory` parameter selects between placement at trajectory knot evaluation points or trajectory control points
+  - Optional `rotation_adaption` parameter for additional rotation of the cross-section around the trajectory tangent
+  - Added swept surface image to README and documentation
+
+#### IGA Assembly: `FieldIntegrator` and `Transformation`
+- New `Transformation` class in `splinepy.helpme.integrate` encapsulating all quadrature and geometry transformation data needed for IGA discretization:
+  - Precomputes quadrature points, supports, Jacobians, Jacobian inverses, and Jacobian determinants per element
+  - Configurable quadrature orders
+- New `FieldIntegrator` class in `splinepy.helpme.integrate` providing a high-level interface for PDE assembly:
+  - `assemble_matrix(function)` — assembles the global stiffness matrix
+  - `assemble_vector(function)` — assembles the global load vector
+  - `assemble_matrix_and_vector(function)` — assembles both simultaneously
+  - `L2_projection(function)` — computes the L2 projection of a function onto the spline space
+  - `compute_error(function, norm)` — computes the L2 or H1 error of the current solution
+  - `apply_homogeneous_dirichlet_boundary_conditions()` — enforces homogeneous Dirichlet BCs
+  - `apply_dirichlet_boundary_conditions(function)` — enforces inhomogeneous Dirichlet BCs from a given function
+  - `solve_linear_system()` — solves the assembled linear system using `scipy.sparse.linalg.spsolve`
+  - Uses sparse matrix assembly via `scipy.sparse.dok_matrix`
+
+#### Microstructure: Tile Parameter Handling and Sensitivities
+- Extended `TileBase` with standardised class attributes and properties for parameter validation and introspection:
+  - `_parameter_bounds` / `parameter_bounds` — bounds for each tile parameter
+  - `_parameters_shape` / `parameters_shape` — shape of the parameter array
+  - `_default_parameter_value` / `default_parameter_value` — default values for tile parameters
+  - `_sensitivities_implemented` / `sensitivities_implemented` — flag indicating whether parameter sensitivities are implemented
+  - `_closure_directions` / `closure_directions` — list of supported closure directions
+  - `check_params(parameters)` — validates user-supplied parameters against bounds
+  - `_process_input(parameters, parameter_sensitivities)` — shared input-processing logic
+  - `_check_custom_parameter(value, param_name, bounds)` — validates individual parameters
+- Derived tile classes now inherit common parameter-processing code from `TileBase`, reducing code duplication
+- Changed `evaluation_points`, `para_dim`, and `dim` from class methods to instance properties for consistency
+- Added `n_info_per_eval_point` property to `TileBase`
+- Derivatives (parameter sensitivities) implemented or fixed for:
+  - `HollowOctagon` (with and without closure)
+  - `HollowOctagonExtrude` (added working closure, with derivatives)
+  - `Armadillo`
+  - `Chi` tile (fixed)
+  - `InverseCross3D` (restructured and fixed)
+  - `CubeVoid` (fixed)
+  - `EllipsVoid` (fixed)
+- Fourth-order accurate finite-difference calculation for numerical verification of parameter sensitivities
+- Sensitivities calculation now outputs evaluation points when it fails for easier debugging
+- `Microstructure`: integers are now accepted as tile parameters alongside floats
+
+#### Multipatch
+- Added `Multipatch.set_interface_orientations(interface_orientations)` setter for manually specifying interface orientations, enabling export of scalar-field splines where automatic Jacobian-based orientation computation is not possible
+
+#### Examples
+- Added `examples/show_swept.py` demonstrating swept surface and solid construction
+- Added `examples/iga/galerkin_laplace_problem_field_integrator.py` demonstrating Galerkin IGA for the Laplace problem using `FieldIntegrator`
+- Added `examples/iga/collocation_stokes_problem_sparse.py` demonstrating IGA collocation for the Stokes problem using sparse matrices
+
+### Changed
+
+#### CI/CD and Python Support
+- Dropped Python 3.9 support; added Python 3.14 support (updated workflows and `pyproject.toml` classifiers)
+- Switched macOS CI runner from deprecated `macos-13` to `macos-15-intel` for continued x86_64 testing
+- Fixed wheel naming convention issue in CI
+
+#### Microstructure
+- Refactored all tile classes to use common functions from `TileBase`, reducing code duplication significantly
+- `TileBase`: removed class methods in favour of instance/class properties for `dim`, `para_dim`, and `evaluation_points`
+- `TileBase`: removed unneeded classmethods to simplify the class hierarchy
+- `Microstructure`: replaced bare `assert` statements with proper `raise` expressions for parameter validation; improved error messages
+- `Microstructure`: updated `zip` calls to use `strict=True` for stricter length checking (Python 3.10+)
+- `Chi` tile is now excluded from macro-sensitivity tests (analytical sensitivities not yet finalized)
+- `HollowOctagonExtrude` removed from the list of skipped test tiles
+
+#### Integration (`helpme/integrate.py`)
+- Extracted `_default_quadrature_orders(spline)` helper function (previously inlined in `_get_quadrature_information`)
+- Improved docstrings for `_get_integral_measure`, `_get_quadrature_information`, and related functions
+- Corrected typos in docstrings (`paramtric` → `parametric`, `Determinante` → `Determinant`)
+
+#### Gismo IO (`splinepy/io/gismo.py`)
+- Added helper functions for Gismo export
+- Fixed patch range text format for multi-patch exports
+
+#### IRIT IO (`splinepy/io/irit.py`)
+- Updated `zip` calls to use `strict=True`
+
+#### MFEM IO (`splinepy/io/mfem.py`)
+- Fixed test data for Cartesian 2D and 3D meshes
+
+#### PR Template
+- Updated pull request template to use `develop` as the default base branch
+
+### Fixed
+
+- **`helpme/create.py`**: Fixed error in rotation matrix calculation for e2 entries in swept surface generation; improved input validation and error messages throughout
+- **`helpme/integrate.py`**: Fixed typos and improved docstrings
+- **`microstructure/tiles`**: Fixed incorrect ordering in finite-difference sensitivity calculation; fixed derivative implementations for `Chi`, `CubeVoid`, `EllipsVoid`, `InverseCross3D`; fixed typo causing errors in `HollowOctagonExtrude`
+- **`microstructure/microstructure.py`**: Fixed typo in class docstring (`facilitatae` → `facilitate`)
+- **`multipatch.py`**: Added check to verify that Jacobians exist before computing interface orientations
+- **`bspline.py`**: Allow any negative number in the knot vector (previously restricted), fixing issue [#476](https://github.com/isosuite/splinepy/pull/476)
+- **`utils/data.py`**: Minor fixes
+- **Various IO modules**: Fixed miscellaneous issues and improved error handling
+
+### Tests
+
+- Added `tests/test_microtiles.py` with comprehensive parametrised tests for all microtile classes:
+  - All tiles lie within the unit cube for default parameters
+  - Tiles with non-default parameters
+  - Closure tests
+  - Tile derivative (sensitivity) tests, including closure derivatives
+  - Macro-sensitivity tests (finite-difference verification)
+- Added `tests/test_microstructure.py` with additional microstructure integration tests
+- Added test for `Transformation` class in `tests/helpme/test_integrate.py`
+- Extended `tests/helpme/test_create.py` with swept surface tests, including:
+  - Comparison of swept vs extruded surfaces
+  - Custom cross-section normal vector
+  - Anchor modes
+  - Derivative checks
+- Fixed RNG seed, sensitivity step size, and number of random test points for reproducible results
+- Updated various existing tests for compatibility with Python 3.10+ `zip(strict=True)` changes
+
+## [0.2.0] - 2025-06-01
+
+- Physical function integration in `helpme/integrate.py`
+- Gismo export helper functions
+- Python 3.13 support
+- Various bug fixes and CI/CD maintenance
+
+## [0.1.3] - 2024
+
+- Proximity / nearest-point query updates
+
+## [0.1.2] - 2024
+
+- MFEM 3D single-patch IO
+- Padding initializer for splines
+
+## [0.1.1] - 2024
+
+- Initial stable release series
+
+[0.2.1]: https://github.com/isosuite/splinepy/compare/v0.2.0...v0.2.1
+[0.2.0]: https://github.com/isosuite/splinepy/compare/v0.1.3...v0.2.0
+[0.1.3]: https://github.com/isosuite/splinepy/compare/v0.1.2...v0.1.3
+[0.1.2]: https://github.com/isosuite/splinepy/compare/v0.1.1...v0.1.2
+[0.1.1]: https://github.com/isosuite/splinepy/releases/tag/v0.1.1