# The Well: PlanetSWE, Forced Rotating Shallow Water on a Sphere

## Facts

- Provider: Polymathic AI (The Well); Michael McCabe
- License: CC-BY-4.0 (https://arxiv.org/html/2412.00568)
- Size: 137 files
- Format: HDF5 (in sampled files)
- Stored at: Hugging Face, https://huggingface.co/datasets/polymathic-ai/planetswe
- Access: public, readable without an account
- Category: Physics
- Source: https://arxiv.org/abs/2306.10619
- Page: https://scigantic.com/archive/d63753b8-26ea-5dae-b43d-1c56df7904e8
- Keywords: Physics, HDF5, Hugging Face

## About

Forced, hyperviscous rotating shallow water equations on a sphere with Earth-like topography and daily and annual periodic forcing, a simplified stand-in for a single pressure level of an atmospheric model. The shallow water equations are a depth-integrated form of incompressible Navier-Stokes for flows whose horizontal scales far exceed vertical ones. Solved with Dedalus on an equiangular 256 by 512 grid; each trajectory runs 3,024 steps (24 steps per model day, 1,008 per model year) for 3 model years. Fields are height and velocity. The datasheet lists 40 trajectories from different initial conditions. Listing data/ (measured 2026-11-13) shows train/ (96 files, 154 GB, 1.6 GB per file, one per initial condition and year segment), valid/ and test/ (12 files, 19.2 GB each); about 192 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/planetswe", filename="data/test/planetswe_IC36_s1.hdf5", repo_type="dataset")
print(path)
```

## Data structure

File types in sampled files: HDF5

Example file: `data/test/planetswe_IC36_s1.hdf5`

## Open it

- In a hosted notebook with the data mounted: https://scigantic.com/archive/d63753b8-26ea-5dae-b43d-1c56df7904e8
- Full record as JSON (schema card included): https://api.scigantic.com/api/archives/d63753b8-26ea-5dae-b43d-1c56df7904e8
- Over MCP: `get_schema_card` with id `d63753b8-26ea-5dae-b43d-1c56df7904e8` at https://api.scigantic.com/mcp

## Related topics

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