Repository navigation
BrainSpace 0.3.0 adds portable surface reports and contour overlays, and completes the current issue and pull-request maintenance cycle.
New plotting features
- Export self-contained HTML surface reports with map selection, rotation, pan, and zoom, including
plot_hemispheres(..., backend="html")(#166, #168). - Export bundled or custom surface maps through the optional threemica bridge. BrainSpace does not vendor threemica viewer code; threemica remains a separately installed dependency under its own license.
- Add contour lines and optional region fill through
plot_hemispheres,build_plotter,make_contour_actor, andadd_contours_to_plotter(#165). Overlays follow each surface actor's transformation across supported views and layouts.
Fixes and guidance
- Adopt the symmetric generalized MATLAB diffusion eigenproblem solver from @magnesium2400 (#164), preserving input symmetry validation and adding numerical equivalence tests.
- Fix single-map grid plots and layouts containing empty cells.
- Validate HTML surface geometry, hemisphere array lengths, and color ranges; reject unsupported VTK-only options explicitly.
- Preserve existing files when creating temporary threemica exports and clean temporary inputs after failed exports.
- Document normalized-angle affinity construction, gradient ordering, reference/template choices, and Fisher-transform handling (#167, #169).
Packaging and validation
- Make the README compatible with PyPI rendering and add distribution validation to CI.
- Validate release tags and attach distributions to the versioned GitHub release.
- Local validation: 205 Python tests passed, 1 expected failure; wheel and source archive passed metadata checks; installed-wheel VTK-free export passed; documentation built successfully with existing warnings.
- CI covers Python 3.9–3.13 on Linux, macOS and Windows, plus MATLAB and package validation. The MATLAB suite includes the new solver equivalence and invalid-input regressions; its Conte69 dataset test is skipped when the optional GIFTI library is unavailable.
See #170 for the complete maintenance change.