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'). The data were retired on
2025-08-29 and are no longer updated. 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,
<https://www.ncei.noaa.gov/pub/data/gsod/readme.txt>.
| Version: |
5.0.1 |
| Depends: |
R (≥ 3.5.0) |
| Imports: |
cli, curl, data.table (≥ 1.15.4), R.utils, stats, utils, withr |
| Suggests: |
bit64, dplyr, ggplot2, gridExtra, knitr, mapproj, maps, rmarkdown, roxyglobals, spelling, testthat, tidyr |
| Published: |
2026-02-28 |
| DOI: |
10.32614/CRAN.package.GSODR |
| Author: |
Adam H. Sparks 
[aut, cre],
Tomislav Hengl
[aut],
Andrew Nelson
[aut],
Hugh Parsonage
[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
[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),
Wenbo Lv [ctb] (Provided suggestions for improving documentation),
Curtin University  [fnd, cph]
(url: http://www.curtin.edu.au/) |
| Maintainer: |
Adam H. Sparks <adamhsparks at gmail.com> |
| BugReports: |
https://codeberg.org/ropensci/GSODR/issues |
| License: |
MIT + file LICENSE |
| URL: |
https://docs.ropensci.org/GSODR/,
https://codeberg.org/ropensci/GSODR |
| NeedsCompilation: |
no |
| Language: |
en-US |
| Citation: |
GSODR citation info |
| Materials: |
README, NEWS |
| In views: |
Hydrology |
| CRAN checks: |
GSODR results |
Documentation:
Downloads:
Reverse dependencies:
Linking:
Please use the canonical form
https://CRAN.R-project.org/package=GSODR
to link to this page.