README.md

# pyIconeus test data

Test fixtures for [PyIconeus](https://github.com/Iconeus/PyIconeus), Iconeus' open-source
reader for functional ultrasound (fUS) data acquired with the Iconeus One preclinical system.

Formats covered: `.scan` (HDF5 + legacy binary), `.bps` (Brain-to-Lab transforms),
`.bri` (ROI meshes), `.raw`/`.hraw` (IQ data).

## Provenance

Mirror of **[10.5281/zenodo.22249523](https://doi.org/10.5281/zenodo.22249523)** —
*"pyIconeus test data"*, ICONEUS, v1.0 (2026-09-02), **CC-BY-4.0**.

Zenodo remains the citable archival record. This bucket is the working copy: same bytes,
fetched per file instead of as one 3.2 GB zip.

## Usage

```python
from huggingface_hub import download_bucket_files

download_bucket_files("Iconeus/pyiconeus-test-data", [("Mouse.bps", "Mouse.bps")])
```

```console
hf buckets cp hf://buckets/Iconeus/pyiconeus-test-data/Mouse.bps .
hf buckets ls hf://buckets/Iconeus/pyiconeus-test-data
```

## Citation

```bibtex
@dataset{iconeus_pyiconeus_test_data,
  author    = {ICONEUS},
  title     = {pyIconeus test data},
  year      = {2026},
  publisher = {Zenodo},
  version   = {1.0},
  doi       = {10.5281/zenodo.22249523}
}
```

## License

CC-BY-4.0, as on Zenodo. Attribution: ICONEUS.