Skip to content

Annual station climate

noaa:gsoy · Released · Included since usdata 0.10.

Global Summary of the Year.

At a glance

  • Files: CSV
  • Selection: Complete UTC calendar years touched by the query; station and element filters
  • Required inputs: Both dates; station IDs or a geographic query
  • Open locally: usdata[pandas] · Reader guide
  • Examples: annual climate

Usage and limitations

Available since v0.10.0 as noaa:gsoy. GSOY uses the anonymous NCEI Access Data Service dataset global-summary-of-the-year, reusing GHCN/GSOM station discovery, pagination, and 50-station CSV chunks. Require both dates and either stations or a location/bbox, not both. units is metric (default) or standard; unknown parameters and text queries are rejected.

Every UTC calendar year touched by the interval is selected in full: May 6–7 selects the whole year; December 31–January 1 selects both years. Search and data requests use January 1 through December 31, giving equivalent year selections identical URLs and asset IDs. Asset coverage labels complete years; the original query remains in the manifest. A timezone offset can change the selected UTC year.

CSV DATE is a four-digit year. Use item.open(dtype={"DATE": "string"}) to preserve it as text with the existing pandas reader. Common variables are PRCP (annual precipitation total, metric millimeters) and TAVG (annual mean temperature, metric degrees Celsius). CSV contains no units row; provenance retains the requested unit system. Variable availability depends on the station.

Some elements, including degree-day summaries, have hemisphere-dependent accumulation seasons. Annual record labels do not mean every element represents January–December observations. Consult the GSOY field documentation. Dataset metadata describes global GHCN-Daily-derived summaries and weekly updates. Revisions can change CSV bytes; retain the cache as well as the manifest and lockfile.

See the service research notes for dated upstream probes.

All NOAA datasets.

Catalog reference.

Catalog reference

  • Availability: since 0.10
  • Domain: Surface weather
  • Geographic bounds (WGS84): west -180°, south -90°, east 180°, north 90°
  • Coverage varies by station, product, and date; the range above does not guarantee observations.
  • Upstream documentation
  • License: US Government Work (public domain)
  • Transport: http
  • Adapter: usdata.providers.noaa.gsoy:GlobalSummaryYearly

All NOAA datasets.