NAME Weather::GHCN::Fetch - Access the NOAA GHCN Global Historical Climatology Network repository VERSION version v0.0.010 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