Skip to content

v0.3.0

Latest

Choose a tag to compare

@zihuaihuai zihuaihuai released this 22 Oct 13:40
6ee2750

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, and add_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.