Skip to main content

atmofetch

Python package to download in-situ meteorological data from publicly available repositories:

  • OGIMET (ogimet.com) — up-to-date SYNOP dataset (hourly & daily)
  • University of Wyoming (weather.uwyo.edu) — atmospheric vertical profiling (sounding) data
  • NOAA NCEI (ncei.noaa.gov) — Integrated Surface Hourly (ISH) meteorological data
  • NOAA GML (gml.noaa.gov) — Mauna Loa CO2 monthly measurements

Installation

pip install atmofetch

Or install from source:

pip install -e ".[dev]"

Quick Start

Download hourly NOAA ISH data

from atmofetch import meteo_noaa_hourly

df = meteo_noaa_hourly(station="037720-99999", year=2023)
print(df.head())

Download daily OGIMET data

from atmofetch import meteo_ogimet

df = meteo_ogimet(interval="daily", station=72503, coords=True)
print(df.head())

Download CO2 data from Mauna Loa

from atmofetch import meteo_noaa_co2

co2 = meteo_noaa_co2()
print(co2.tail())

Download atmospheric sounding

from atmofetch import sounding_wyoming

profile, metadata = sounding_wyoming(wmo_id=45004, yy=2023, mm=7, dd=17, hh=12)
print(profile.head())

Find nearest stations

from atmofetch import nearest_stations_noaa, nearest_stations_ogimet

# NOAA stations near London
noaa = nearest_stations_noaa(country="UNITED KINGDOM", point=(-0.1, 51.5))
print(noaa[["STATION NAME", "distance"]].head())

# OGIMET stations near Paris
ogimet = nearest_stations_ogimet(country="France", point=(2.35, 48.86))
print(ogimet.head())

Calculate distance between two points

from atmofetch import spheroid_dist

km = spheroid_dist((18.63, 54.37), (17.02, 54.47))
print(f"Distance: {km:.1f} km")

API Reference

Meteorological Data

Function Source Description
meteo_ogimet() OGIMET Hourly or daily SYNOP data
ogimet_hourly() OGIMET Hourly SYNOP data
ogimet_daily() OGIMET Daily SYNOP summaries
meteo_noaa_hourly() NOAA ISH Hourly data (some stations >100 years)
meteo_noaa_co2() NOAA GML Monthly CO2 from Mauna Loa
sounding_wyoming() U. Wyoming Vertical atmospheric profiles (TEMP/BUFR)

Station Discovery

Function Source Description
stations_ogimet() OGIMET List all stations for a country
nearest_stations_ogimet() OGIMET Find nearest OGIMET stations
nearest_stations_noaa() NOAA Find nearest NOAA ISH stations

Utilities

Function Description
spheroid_dist() Distance (km) between two (lon, lat) points

License

MIT

Metadata

Release files for atmofetch 0.1.0

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

Source distribution (sdist)

Source distribution for atmofetch 0.1.0
File Size Uploaded Provenance
atmofetch-0.1.0.tar.gz 14.9 kB Without provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for atmofetch 0.1.0
File Interpreter ABI Platform
atmofetch-0.1.0-py3-none-any.whl Python 3 none any Details

Total release size: 35.7 kB

Release files / atmofetch-0.1.0.tar.gz

Download URL atmofetch-0.1.0.tar.gz
Size 14.9 kB
Tags Source
SHA-256 checksum
How to use checksums
ea131ca8f5f9d1ce682c44d478c1cd4ad737d67ccee946e0ff75ffb5340a3fc4
BLAKE2b-256 checksum
How to use checksums
9fbc6994586747e8561bcbdd4138b628f2cbd42790868e1fea1b374f0dce972d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.13.12

Release files / atmofetch-0.1.0-py3-none-any.whl

Download URL atmofetch-0.1.0-py3-none-any.whl
Size 20.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
cf67f7f8fc1db10b749f8af167e8add0ba759b0877a5ab5dc2505f84180be7e8
BLAKE2b-256 checksum
How to use checksums
7d2781532e43e0c9f85031d68640147e67ccfaa2d5fff8bb7977d92c0284aa15
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.13.12

Security for atmofetch 0.1.0

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.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files No provenance

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