Metadata-Version: 2.4
Name: nsdget
Version: 0.0.0
Summary: Python API to easily download stimuli and fMRI data from Natural Scenes Dataset.
Author-email: xnought <drbertucci@hotmail.com>
Requires-Python: >=3.10
Requires-Dist: pillow>=11.1.0
Requires-Dist: wget>=3.2
Description-Content-Type: text/markdown

# 🧠🏞️ nsdget

**nsdget: Natural Scenes Dataset Getter via Python API.**

Quickly get a subset of stimuli (images shown to subject) and corresponding fMRI data from the [Natural Scenes Dataset](https://naturalscenesdataset.org/).

Not affiliated with Natural Scenes Dataset. I just wanted an easier and quicker way to download the data I needed from them (hence this package).

**Roadmap**

- [x] Functions to download stimuli (images) w/out downloading the 40gb total image object. Just download images directly from COCO.
- [ ] Function to download fMRI data  
- [ ] Document functions better
- [ ] Publish to PyPi

## Usage

- Download stimuli images (coco data) example in [`view_info.ipynb`](./notebooks/view_info.ipynb)

## Development

```bash
uv sync
make
```

## References

- https://naturalscenesdataset.org/
- https://cocodataset.org/#home
