# Data Directory

This folder is for local development data only. The primary data source is HuggingFace.

## Data Source

**Primary**: [hugging-science/isles24-stroke](https://huggingface.co/datasets/hugging-science/isles24-stroke)

The dataset is automatically downloaded and cached by HuggingFace when you run:

```python
from stroke_deepisles_demo.data import load_isles_dataset

# Loads from HuggingFace (default)
dataset = load_isles_dataset()

# Access cases
case = dataset.get_case(0)  # or dataset.get_case("sub-stroke0001")
```

## HuggingFace Cache Location

Data is cached at: `~/.cache/huggingface/datasets/hugging-science___isles24-stroke/`

## Dataset Contents

149 acute ischemic stroke cases with:
- **Imaging**: DWI, ADC, CT, CTA, perfusion maps (tmax, mtt, cbf, cbv)
- **Masks**: lesion_mask, lvo_mask, cow_segmentation
- **Clinical**: age, sex, nihss_admission, mrs_admission, mrs_3month

## Local Development (Optional)

For offline development, you can still use a local directory:

```python
dataset = load_isles_dataset("path/to/local/data", local_mode=True)
```

Expected structure for local mode:
```text
data/
├── Images-DWI/     # DWI volumes
├── Images-ADC/     # ADC maps
└── Masks/          # Ground truth lesion masks
```

## Notes

- All data files are gitignored
- On HuggingFace Spaces, data loads automatically from the HF cache
- See dataset card for citation requirements