# Mirror Fish: Lightning Pose Keypoint Dataset of Weakly Electric Mormyrid Fish (Gnathonemus petersii) Filmed with Mirrors at 300 Hz (Columbia University)

## Facts

- Provider: Sawtell Lab and Paninski Lab, Columbia University
- License: CC-BY-4.0 (https://api.figshare.com/v2/articles/24993363)
- Size: 2,473 files
- Format: CSV, PNG (in sampled files)
- Stored at: Hugging Face, https://huggingface.co/datasets/paninski-lab/mirror-fish
- Access: public, readable without an account
- DOI: https://doi.org/10.6084/m9.figshare.24993363
- Category: Neuroscience
- Source: https://huggingface.co/datasets/paninski-lab/mirror-fish
- Page: https://scigantic.com/archive/8e6d4775-2dec-5c19-a3f2-4ce70b9ed9c9
- Keywords: Neuroscience, CSV, PNG, Hugging Face

## About

A labeled animal pose estimation dataset of weakly electric mormyrid fish (elephantnose fish, Gnathonemus petersii) swimming freely and capturing worms, recorded in the Sawtell Lab at Columbia University by Federico Pedraja, David Ehrlich and Dillon Noone. A single camera at 300 Hz sees a direct view plus two 45 degree mirror views (top and side), so each frame is labeled with 51 keypoints: 17 body parts (chin, head, pectoral fins, dorsal and anal fins, caudal fin, fork) in three views. 373 in-distribution frames from 28 sessions and 94 out-of-distribution frames from 10 different sessions and animals. Packaged by the Paninski Lab for Lightning Pose: labeled-data/ PNG frames with context frames, CollectedData.csv and CollectedData_test.csv (DeepLabCut-style 2D labels), videos, 51-frame clips around each test frame for the Ensemble Kalman Smoother, a training config and project.yaml. Source archive: Lightning Pose dataset mirror-fish, DOI 10.6084/m9.figshare.24993363, CC BY 4.0. Cite that record and the Lightning Pose paper (Biderman et al., Nature Methods 2024).

## Load the data

```python
import pandas as pd
df = pd.read_csv("hf://datasets/paninski-lab/mirror-fish/CollectedData.csv")
df.head()
```

## Data structure

File types in sampled files: CSV, PNG

Example file: `CollectedData.csv`

## Open it

- In a hosted notebook with the data mounted: https://scigantic.com/archive/8e6d4775-2dec-5c19-a3f2-4ce70b9ed9c9
- Full record as JSON (schema card included): https://api.scigantic.com/api/archives/8e6d4775-2dec-5c19-a3f2-4ce70b9ed9c9
- Over MCP: `get_schema_card` with id `8e6d4775-2dec-5c19-a3f2-4ce70b9ed9c9` at https://api.scigantic.com/mcp

## Related topics

- [Neuroscience datasets](https://scigantic.com/topics/neuroscience)
- [CSV datasets](https://scigantic.com/topics/csv)
- [PNG datasets](https://scigantic.com/topics/png)
