Skip to content

DriftlessMap 1.2.0

Choose a tag to compare

View all tags
@mohebial mohebial released this 28 Jul 00:48
· 9 commits to main since this release
v1.2.0
3a0af62

DriftlessMap 1.2.0

DriftlessMap 1.2.0 introduces a versioned probe-localization export designed for downstream electrophysiology and NWB workflows.

Highlights

  • Adds labeled sampling along the complete reconstructed probe centerline.
  • Assigns Allen CCF coordinates and anatomical structures to each track sample.
  • Introduces probe-reconstruction export schema version 2.
  • Records atlas, software, coordinate-system, and probe-geometry provenance.
  • Enables downstream assignment of estimated unit depths to atlas coordinates and brain regions.

Four-file localization export

The Export probe localization files action now creates four companion CSV files:

  • *_contacts.csv — physical probe contacts, ordered deepest to shallowest, with atlas coordinates and anatomical assignments.
  • *_track.csv — labeled samples along the fitted probe centerline, ordered from insertion to tip and spaced no farther apart than one atlas voxel.
  • *_trajectory.csv — insertion and tip coordinates, trajectory angles, fit-quality metrics, atlas metadata, schema version, DriftlessMap version, and probe tip-to-contact offset.
  • *_regions.csv — anatomical-region summaries, including structure IDs, acronyms, names, contact counts, and reconstructed path lengths.

The new track table is the recommended input for assigning continuously estimated electrode or unit depths to anatomy.

Coordinate information

For recognized Allen Mouse CCFv3 atlases, exports include:

  • Allen CCF voxel coordinates
  • Physical atlas coordinates
  • Allen structure ID, acronym, and name
  • Distance from probe insertion
  • Distance from the geometric probe tip

Estimated Bregma-relative values remain clearly identified as estimates and should not be interpreted as a formal Paxinos atlas registration.

Upgrade notes

Existing probes should be unmerged and re-merged in DriftlessMap 1.2.0 before export. This regenerates the reconstruction using schema version 2 and adds the complete labeled centerline.

Downstream applications should:

  • Require reconstruction schema version 2 when unit-level localization is needed.
  • Use *_track.csv for interpolation and region assignment.
  • Use the tip-to-contact offset recorded in *_trajectory.csv.
  • Preserve the exported atlas and software provenance.

The previous contact, trajectory, and region files remain available, but the new track file is required for reliable localization of arbitrary depths along the probe.

Validation

This release includes expanded tests covering:

  • Centerline sampling and ordering
  • Atlas-region assignment
  • Four-file CSV generation
  • Schema and software provenance
  • Probe tip-to-contact metadata
  • Package version and release metadata
Assets 2
Loading