| CI | |
|---|---|
| Docs | |
| Package | |
| License |
pythia-datasets
Data repository for with sample data for the Pythia Foundations book.
Sample data sets
These files are used as sample data in Pythia Foundations and are downloaded by pythia_datasets package:
NARR_19930313_0000.ncenso_data.csvjan-17-co-asos.txt.xzCESM2_sst_data.ncCESM2_grid_variables.ncdaymet_v4_precip_sept_2013.nc
Adding new datasets
The scope of this data collection is to serve examples for Pythia Foundations. If you are adding new content to Foundations that requires a new dataset file, please follow these steps:
- Add the dataset file to the
data/directory - From the command line, run
python make_registry.pyscript to update the registry file residing inpythia_datasets/registry.txt - Commit and push your changes to GitHub
Using datasets in notebooks and/or scripts
-
Ensure the
pythia_datasetspackage is installed in your environmentpython -m pip install pythia-datasets # or python -m pip install git+https://github.com/ProjectPythia/pythia-datasets
-
Import
DATASETSand inspect the registry to find out which datasets are availableIn [1]: from pythia_datasets import DATASETS In [2]: DATASETS.registry_files Out[2]: ['jan-17-co-asos.txt.xz', 'NARR_19930313_0000.nc']
-
To fetch a data file of interest, use the
.fetchmethod and provide the filename of the data file. This will- download and cache the file if it doesn't exist already.
- retrieve and return the local path
In [4]: filepath = DATASETS.fetch('jan-17-co-asos.txt.xz') In [5]: filepath Out[5]: '/Users/abanihi/Library/Caches/pythia-datasets/jan-17-co-asos.txt.xz'
-
Once you have access to the local filepath, you can then use it to load your dataset into pandas or xarray or your package of choice:
In [6]: df = pd.read_csv(filepath)
Changing the default data cache location
The default cache location (where the data are saved on your local system) is dependent on the operating system. You can use the locate() method to identify it:
from pythia_datasets import locate
locate()
The location can be overwritten by the PYTHIA_DATASETS_DIR environment
variable to the desired destination.
Metadata
Release files for pythia-datasets 2026.2.20
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| pythia_datasets-2026.2.20.tar.gz | 10.9 kB | Without provenance | Details for pythia_datasets-2026.2.20.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| pythia_datasets-2026.2.20-py3-none-any.whl | Python 3 | none | any | Details for pythia_datasets-2026.2.20-py3-none-any.whl |
Total release size: 20.3 kB
Release files / pythia_datasets-2026.2.20.tar.gz
| Download URL | pythia_datasets-2026.2.20.tar.gz |
|---|---|
| Size | 10.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
7ff7427d2ad99b6eca561104eac2c51f401584c380a96b6229599dd045f85be4
|
|
BLAKE2b-256 checksum How to use checksums |
63fff4b10f942bdc5e55f3fbe59c515640609349a4708f5be8c5d176e608b9d3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Release files / pythia_datasets-2026.2.20-py3-none-any.whl
| Download URL | pythia_datasets-2026.2.20-py3-none-any.whl |
|---|---|
| Size | 9.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
a7fd920967b555cfef45dde8536614027bb8f8230ec722e89e26fba980c1b1d1
|
|
BLAKE2b-256 checksum How to use checksums |
63d78f433d3ffff6e4194d0200f3c82ad1adc3f9eaf7906397b100304c5b9d61
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Security for pythia-datasets 2026.2.20
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.