Skip to main content

madis-data

madis-data is a Python toolkit to download, process, extract, interpolate, and plot Meteorological Assimilation Data Ingest System (MADIS) data. Currently, madis-data operates on the following publicly available MADIS Mesonet data:

  • 2 m temperature
  • 2 m dewpoint temperature
  • 10 m west-east and south-north wind speed
  • solar radiation

Workflow (using API)

The workflow is shown in the HowTo Jupyter notebook. The notebook performs the following tasks:

  1. download MESONET surface observations data files for January 2026 from the MADIS archive,
  2. extract January 2026 time series for stations in the state of Colorado of the following variables:
    • 2 m temperature,
    • 2 m dewpoint temperature,
    • 10 m west-east and south-north wind speed,
    • solar radiation,
  3. save the time series in a netCDF file,
  4. interpolate the time series to full-hourly time series,
  5. save the full-hourly time series in a netCDF file,
  6. plot the original and the full-hourly interpolated time series at an individual station over select time intervals,
  7. plot the stations in the state of Colorado on a US map.

Requirements

This notebook requires the Jupyter kernel madis-data, which is automaticaly installed as part of the madis-data conda development environment. The conda development environment can be installed from the root directory of the madis-data distribution with

make setup-dev-env

Installation

pip

pip install madis-data

conda / mamba

mamba install -c jan.kazil -c conda-forge madis-data

Development

Code Quality and Testing Commands

  • make fmt - Runs ruff format, which reformats Python files according to the style rules in pyproject.toml.
  • make lint - Runs ruff check --fix, which lints the code and auto-fixes what it can.
  • make check - Runs formatting and linting.
  • make type - Currently disabled. Intended to run mypy using the settings in pyproject.toml.
  • make test - Runs pytest with the test settings configured in pyproject.toml.

Disclaimers

The data accessed by this software are publicly available from NOAA's National Centers for Environmental Prediction (NCEP) and are subject to their terms of use. This project is not affiliated with or endorsed by NOAA.

This software uses U.S. Census Bureau and U.S. Energy Information Administration data, but is neither endorsed nor certified by the U.S. Census Bureau or the U.S. Energy Information Administration.

Author

Jan Kazil - jan.kazil.dev@gmail.com - github.com/jankazil/madis-data

License

BSD-3-Clause

Metadata

Release files for madis-data 0.0.7

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for madis-data 0.0.7
File Size Uploaded Provenance Actions
madis_data-0.0.7.tar.gz 22.1 MB Without provenance Details for madis_data-0.0.7.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for madis-data 0.0.7
File Interpreter ABI Platform Actions
madis_data-0.0.7-py3-none-any.whl Python 3 none any Details for madis_data-0.0.7-py3-none-any.whl

Total release size: 44.4 MB

Release files / madis_data-0.0.7.tar.gz

Download URL madis_data-0.0.7.tar.gz
Size 22.1 MB
Tags Source
SHA-256 checksum
How to use checksums
cdd5b4503e046de4fabe4b34661a782c53c89bc056172827331d8d6def8fb7c7
BLAKE2b-256 checksum
How to use checksums
bb2b35ecf0367c217402c58bbc5a0a06431492296c6fd763c1ef175c70aca5cd
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.13.13

Release files / madis_data-0.0.7-py3-none-any.whl

Download URL madis_data-0.0.7-py3-none-any.whl
Size 22.3 MB
Tags Python 3
SHA-256 checksum
How to use checksums
a462ee668204ede91a29439180cee711a19f2f69c9034f600749a7bb7e819599
BLAKE2b-256 checksum
How to use checksums
a743d68e8cd76805f2c28f0f130c6a4f69e98f4e9c1b7cf47e539e19c3a44d4b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.13.13

Security for madis-data 0.0.7

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.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page