# The Well: Active Matter, Rod-like Active Particles in a Stokes Fluid

## Facts

- Provider: Polymathic AI (The Well); Suryanarayana Maddu, Flatiron Institute CCB
- License: CC-BY-4.0 (https://arxiv.org/html/2412.00568)
- Size: 88 files
- Format: HDF5 (in sampled files)
- Stored at: Hugging Face, https://huggingface.co/datasets/polymathic-ai/active_matter
- Access: public, readable without an account
- Category: Physics
- Source: https://arxiv.org/abs/2308.06675
- Page: https://scigantic.com/archive/9acfc291-cea2-57da-8822-e2e284828fa7
- Keywords: Physics, HDF5, Hugging Face

## About

Simulations of a continuum theory for the dynamics of N rod-like active particles immersed in a Stokes fluid, a model of biological active matter such as motor-driven filament suspensions. Each trajectory has 81 time steps of 256 by 256 images, stored every 0.25 s from 0 to 20 s on a periodic 10 by 10 domain. Fields are concentration, velocity, orientation tensor and strain-rate tensor. The datasheet lists 5 trajectories per parameter set, varying the active dipole strength alpha from -1 to -5 and the alignment parameter zeta, with beta fixed at 0.8. Listing data/ (measured 2026-11-13) shows train/ (45 files, 42.5 GB, one per parameter set), valid/ (16 files, 6.3 GB) and test/ (21 files, 7.0 GB); about 56 GB in the repository. Files are HDF5 in the common The Well format; open them with the_well package (WellDataModule with base path hf://datasets/polymathic-ai/) or directly with h5py. Part of The Well (Ohana et al., NeurIPS 2024 Datasets and Benchmarks, arXiv:2412.00568); released under CC-BY-4.0, cite The Well and the simulation's source papers.

## Load the data

```python
from huggingface_hub import hf_hub_download
path = hf_hub_download(repo_id="polymathic-ai/active_matter", filename="data/test/active_matter_L_10.0_zeta_1.0_alpha_-1.0.hdf5", repo_type="dataset")
print(path)
```

## Data structure

File types in sampled files: HDF5

Example file: `data/test/active_matter_L_10.0_zeta_1.0_alpha_-1.0.hdf5`

## Open it

- In a hosted notebook with the data mounted: https://scigantic.com/archive/9acfc291-cea2-57da-8822-e2e284828fa7
- Full record as JSON (schema card included): https://api.scigantic.com/api/archives/9acfc291-cea2-57da-8822-e2e284828fa7
- Over MCP: `get_schema_card` with id `9acfc291-cea2-57da-8822-e2e284828fa7` at https://api.scigantic.com/mcp

## Related topics

- [HDF5 datasets](https://scigantic.com/topics/hdf5)
- [Physics datasets](https://scigantic.com/topics/physics)
