MadrigalWeb - a python API to access the Madrigal database
MadrigalWeb is a pure python module to access data from any Madrigal database. See documentation here. For more data examples go to any Madrigal site such as https://cedar.openmadrigal.org
The easiest way to use the Madrigal python remote data access API is to simply let the web interface generate the command you need.
Installing MadrigalWeb
You need to install the madrigalWeb python package first. You can do that with
pip install madrigalweb
or you can download the source here.
MadrigalWeb command generator
When using the command generator, be sure to select python as the language you want to create the command with. You can choose to download files as they are in Madrigal in either column-delimited ascii, Hdf5, or netCDF4 formats, or you can choose the parameters yourself (including derived parameters), and optionally include filters on the data you get back.
This web interface will generate python commands using one of the following two Python scripts: globalDownload.py and globalIsprint.py. Use globalDownload.py if you want data as it is in Madrigal. Use globalIsprint.py to choose parameters and/or filters. You can also create a permanent citation to a group of Madrigal files with globalCitation.py.
Rules-of-the-Road
Use of Madrigal data is generally subject to the CEDAR Rules-of-the-Road . Prior permission to access the data is not required. However, the user is required to establish early contact with any organization whose data are involved in the project to discuss the intended usage. Data are often subject to limitations which are not immediately evident to new users. Before they are formally submitted, draft copies of all reports and publications must be sent to the contact scientist at all data-supplying organizations along with an offer of co-authorship to scientists who have provided data. This offer may be declined. The Database and the organizations that contributed data must be acknowledged in all reports and publications, and whenever this data is made available through another database.
For questions or comments, contact the Madrigal admin.
Contributing
madrigalWeb Github
We encourage all contributions. If you have a problem with the code or would like to see a new feature, please open an issue or send us an email. Or you can submit a pull request.
Release files for madrigalWeb 3.3.8
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| madrigalweb-3.3.8.tar.gz | 43.3 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| madrigalweb-3.3.8-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 110.0 kB
Release files / madrigalweb-3.3.8.tar.gz
| Download URL | madrigalweb-3.3.8.tar.gz |
|---|---|
| Size | 43.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
3eb5c621d0914980a5dc3e0885966f95bd8ae6ac82e694ff1c89afd004aa9b5d
|
|
BLAKE2b-256 checksum How to use checksums |
c06055094a3484110511bec64cab51fbd9a88a037855f0fbad71181557e41067
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.14
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 24, 2026.
Transparency logRelease files / madrigalweb-3.3.8-py3-none-any.whl
| Download URL | madrigalweb-3.3.8-py3-none-any.whl |
|---|---|
| Size | 66.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
421d2d45a186bc8233cebbdb57a25d2040545be7af14f76c8b3774aefe00b1f5
|
|
BLAKE2b-256 checksum How to use checksums |
513a3fbb386bb4b5b52985463e7abe9bce7c7e2f186e947e12883d085f310ad7
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.14
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 24, 2026.
Transparency log
