/ 
Weather-GHCN-Fetch-v0.0.011
River stage zero No dependents
/ Weather::GHCN::Fetch

NAME

Weather::GHCN::Fetch - Access the NOAA GHCN Global Historical Climatology Network repository

VERSION

version v0.0.011

DESCRIPTION

The Weather::GHCN module library provides classes that can be used to develop applications that access weather data collected by the U.S. National Oceanic and Atmospheric Administration. The modules enable the retrieval of the surface station weather data and metadata that NOAA publishes as the Global Historical Climatology Network (GHCN) data repository, which is fed by weather data sources from around the world.

NOAA GHCN DATA SOURCES

The main data sources are:

NOAA also provides a readme file here:

APPLICATION SCRIPTS

The Weather::GHCN::Fetch package includes fully functional application scripts that are based on Weather::GHCN::App modules. These are:

ghcn_fetch

Fetches station and/or weather data for reporting.

ghcn_extremes

Reports temperature extremes, including heatwaves and coldwaves, from station-level daily weather retrieved by ghcn_fetch.

ghcn_station_counts

Take a list of stations found by ghcn_fetch, examines the active date range, and produces a count of stations that were active in each year of the range.

The output from all scripts is tab-separated and designed for easy import into Excel (or similar) for analysis, reporting and charting. ghcn_extremes and ghcn_station_counts are designed to take the output from ghcn_fetch via pipeline.

Each script has a -help option that documents its features and options.

APPLICATION MODULES

The application scripts are mostly just a thin veneer over corresponding modules in the Weather::GHCN::App namespace. That and the POD necessary for -help and -usage.

The application scripts are built upon the API modules, primarily Weather::GHCN::StationTable.

API MODULES

The API modules are the heart of the package, encapsulating the logic necessary for accessing the GHCN repository, downloading station metadata and daily weather data, managing the plethora of options supported by the ghcn_fetch application, etc.

The modules are:

Weather::GHCN::StationTable
Weather::GHCN::Station
Weather::GHCN::Common
Weather::GHCN::CountryCodes
Weather::GHCN::Measures
Weather::GHCN::Options
Weather::GHCN::TimingStats

This module, Weather::GHCN::Fetch, is actually just a stub that provides documentation and a primary module name for the distribution.

EXAMPLES

The primary usefulness of this package comes from the application scripts. For example of the types of reports that can be generated, see the EXAMPLES section of the help documentation for ghcn_fetch.

AUTHOR

Gary Puckering (jgpuckering@rogers.com)

LICENSE AND COPYRIGHT

Copyright 2022, Gary Puckering