GSODR: Global Surface Summary of the Day ('GSOD') Weather Data Client

Provides automated downloading, parsing, cleaning, unit conversion and formatting of Global Surface Summary of the Day ('GSOD') weather data from the from the USA National Centers for Environmental Information ('NCEI'). Units are converted from from United States Customary System ('USCS') units to International System of Units ('SI'). Stations may be individually checked for number of missing days defined by the user, where stations with too many missing observations are omitted. Only stations with valid reported latitude and longitude values are permitted in the final data. Additional useful elements, saturation vapour pressure ('es'), actual vapour pressure ('ea') and relative humidity ('RH') are calculated from the original data using the improved August-Roche-Magnus approximation (Alduchov & Eskridge 1996) and included in the final data set. The resulting metadata include station identification information, country, state, latitude, longitude, elevation, weather observations and associated flags. For information on the 'GSOD' data from 'NCEI', please see the 'GSOD' 'readme.txt' file available from, <>.

Version: 4.0.0
Depends: R (≥ 3.5.0)
Imports: countrycode, curl, data.table, R.utils, stats, utils
Suggests: dplyr, spelling, ggplot2, gridExtra, knitr, mapproj, maps, rmarkdown, testthat, tidyr, roxyglobals
Published: 2024-03-28
DOI: 10.32614/CRAN.package.GSODR
Author: Adam H. Sparks ORCID iD [aut, cre], Tomislav Hengl ORCID iD [aut], Andrew Nelson ORCID iD [aut], Hugh Parsonage ORCID iD [cph, ctb], Taras Kaduk [ctb] (Suggestion for handling bulk station downloads more efficiently), Gwenael Giboire [ctb] (Several bug reports in early versions and testing feedback), Ɓukasz Pawlik [ctb] (Reported bug in windspeed conversion calculation), Ross Darnell ORCID iD [ctb] (Reported bug in 'Windows OS' versions causing 'GSOD' data untarring to fail), Tyler Widdison [ctb] (Reported bug where `nearest_stations()` did not return stations in order of nearest to farthest), Curtin University [cph] (Supported the development of 'GSODR' through Adam H. Sparks's time.)
Maintainer: Adam H. Sparks <adamhsparks at>
License: MIT + file LICENSE
NeedsCompilation: no
Language: en-US
Citation: GSODR citation info
Materials: README NEWS
In views: Hydrology
CRAN checks: GSODR results


Reference manual: GSODR.pdf
Vignettes: GSODR


Package source: GSODR_4.0.0.tar.gz
Windows binaries: r-devel:, r-release:, r-oldrel:
macOS binaries: r-release (arm64): GSODR_4.0.0.tgz, r-oldrel (arm64): GSODR_4.0.0.tgz, r-release (x86_64): GSODR_4.0.0.tgz, r-oldrel (x86_64): GSODR_4.0.0.tgz
Old sources: GSODR archive

Reverse dependencies:

Reverse suggests: apsimx


Please use the canonical form to link to this page.