Getting Started¶

Requirements¶

Python 3.10 or later

Installation¶

Using uv (recommended)¶

uv handles virtual environments and dependencies automatically:

git clone https://github.com/m-beau/pixelmap.git
cd pixelmap
uv run pixelmap  # installs dependencies and launches the GUI

To install dependencies without launching the GUI:

uv sync

Using pip¶

Create a virtual environment first (e.g. with conda):

conda create -n pixelmap python=3.12
conda activate pixelmap
pip install .

Using Docker¶

Run without any local Python installation:

docker run --rm \
  --name channelmap-app \
  -p 5008:5008 \
  --pull=always \
  ghcr.io/m-beau/pixelmap:latest

The application will be available at http://localhost:5008.

Note

On Apple Silicon (M1/M2) or ARM Linux, add --platform linux/amd64 to the Docker command.

For production deployments, use Docker Compose — see the included docker-compose.yml in the repository.

Quick Start¶

Option 1: Browser GUI¶

Launch the GUI locally:

uv run pixelmap   # or just: pixelmap (if installed with pip)

Or use the online version directly — no installation required.

Select your probe type from the dropdown.
Choose a preset or select electrodes manually.
Download the .imro file once you’ve reached the target electrode count.
Load the .imro file in SpikeGLX via the IM-Setup tab.

Option 2: Python API¶

import pixelmap as cmg

# Generate a channel map using a preset
imro_list = cmg.generate_imro_channelmap(
    probe_type="2.0-4shanks",
    layout_preset="tips_all",
    wiring_file="wiring_maps/2.0-4shanks_wiring.csv"
)

# Save to file
cmg.save_to_imro_file(imro_list, "my_channelmap.imro")

See the Python API reference for full details and generate_channel_maps.ipynb in the repository for more examples.