Skip to content

TractEdit v3.0.1

Choose a tag to compare

@marcotag93 marcotag93 released this 23 Dec 16:28

TractEdit v3.0.1 (December 23, 2025)

MacOS Release

TractEdit is now available for macOS!
This release includes the first official DMG distribution, built natively for Apple Silicon with full feature parity with the Windows version.


Key Features

  • Core Architecture & Standard Workflow: Performed a comprehensive refactoring of the main code structure to support the full standard workflow: whole-brain tractogram analysis, FreeSurfer filtering, and sphere-based selection/refining. Added full support for .vtk and .vtp file formats.
  • Deep FreeSurfer Integration: Implemented loading for FreeSurfer parcellations with Numba-optimized intersection matrix computation. Added vectorized 3D visualization for connected regions with include/exclude filtering effects and input toggles.
  • Advanced Interactive ROIs: Introduced interactive Sphere and Rectangle ROI tools with full 2D/3D synchronization and modifier keys for precise resizing, moving, and placing. Users can now load existing ROIs, modify them using new drawing tools (pencil, rubber, brush), and save the changes.
  • Performance & Headless Operations: Added a "Faster Render" mode for massive speed increases during 3D movement and Numba-optimized algorithms for medoid calculation (10x speedup), narrow-phase ROI intersection, and sphere selection. Implemented a full suite of CLI flags (--convert-to, --density-map, --anat, --roi, --radius, --version, --help) for headless operations.

Minor Improvements

  • Added an HTML viewer export function with compressed streamlines.
  • Implemented a "Replace Bundle" functionality to swap datasets without clearing the T1w reference.
  • Added a hidden toolbar menu for sphere radius that appears only in sphere mode.
  • Enabled drag-and-drop interaction for 2D ROI elements and shortcuts (1-4) for tool selection.
  • Optimized format conversion during saving to maximize header preservation using T1w metadata.
  • Improved loading logic to allow T1w image loading before the bundle.
  • Massively improved the speed, accuracy, and stability of ROI movements.
  • Fixed rendering failures for specific bundles by casting TRX float16 streamlines to float32.
  • Fixed bottlenecks during ROI rasterization in high-resolution images.
  • Fixed ROI filtering issues in axial/coronal panels and data panel debouncing.
  • Fixed ROI loading representation as 3D contours and sphere resize/move interaction bugs.
  • Removed unused and debugging wrapper functions.