Skip to content

DriftlessMap 1.1.0

Choose a tag to compare

View all tags
@mohebial mohebial released this 27 Jul 15:56
· 11 commits to main since this release
v1.1.0
c31c24e

DriftlessMap 1.1.0

This is the first release under the DriftlessMap name—an independently maintained continuation of HERBS for histology registration and brain-atlas mapping.

Highlights

  • Renamed the application and Python distribution to DriftlessMap.
  • Added the driftlessmap command, python -m driftlessmap, and import driftlessmap API.
  • Moved the complete implementation into the driftlessmap Python namespace.
  • Removed the legacy herbs package and command from this distribution, allowing DriftlessMap and original HERBS to coexist in the same Python environment.
  • Added support for Python 3.10–3.14 and migrated the interface to PyQt6.
  • Improved probe reconstruction, contact mapping, anatomical-region reporting, and CSV exports.
  • Added safer, versioned project and object archives.
  • Added stricter validation for atlas files, images, layers, coordinates, meshes, and downloaded resources.
  • Added automated testing across supported Python versions and secure PyPI publishing.

File compatibility

DriftlessMap continues to read legacy HERBS files:

  • .herbs
  • .herbslayer
  • .herbsobj
  • .herbsslice
  • .herbstri

Newly saved files use the DriftlessMap formats:

  • .dmap
  • .dmaplayer
  • .dmapobj
  • .dmapslice
  • .dmaptri

The original HERBS application may not be able to open files newly written by DriftlessMap. Keep backups before converting important research projects.

Installation

Create a dedicated environment and install from PyPI:

conda create --name DriftlessMap python=3.14 -y
conda activate DriftlessMap
python -m pip install --upgrade pip
python -m pip install driftlessmap
driftlessmap

For optional Zeiss CZI support, use Python 3.13:

python -m pip install "driftlessmap[czi]"

Attribution

DriftlessMap began as a fork of HERBS and preserves the original project’s copyright notice, MIT License, Git history, authorship, and publication credit.

Original HERBS publication:

Fuglstad, J. G., Saldanha, P., Paglia, J., & Whitlock, J. R. (2023).
Histological E-data Registration in rodent Brain Spaces. eLife, 12, e83496.
https://doi.org/10.7554/eLife.83496

Current development and maintenance are led by:

DriftlessMap is independently maintained and is not affiliated with or endorsed by the original HERBS developers.

See the full release history and project origins for additional details.

Assets 2
Loading