GSODR: Download, Clean and Generate New Variables from GSOD Data

Download, clean, reformat and create new variables from the USA National Climatic Data Center (NCDC) Global Surface Summary of the Day (GSOD) weather stations data, <>. The function, get_GSOD(), retrieves data from the GSOD ftp site and reformats it from United States Customary System (USCS) units to International System of Units (SI). Stations are individually checked for number of missing days, as defined by the user, to assure data quality. Stations with too many missing observations are omitted from final file. Stations with missing latitude or longitude or values for both of 0 are omitted. Also omitted are stations with a latitude of < -90 or > 90 or longitude of < - 180 or > 180. Output is returned as a comma-separated values (CSV) file written to disk in a location selected by the user, which summarises each year by station and includes new variables: actual vapor pressure, saturation vapor pressure and relative humidity, calculated from the original GSOD data. The resulting files can be as large as 500mb depending on the user's stringency for missing data and geographic area of interest. Be sure to have sufficient RAM and disk space as well as a reasonably fast internet connection to use this package to perform this operation. However, for much smaller and more manageable data sets, an individual country of interest may be selected as well as only stations falling between -60/60 degrees latitude for agroclimatology work or individual stations if the station ID is known. The resulting files include station data (e.g., station name, country, latitude, longitude, elevation) for use in a geographic information system (GIS). The function was largely based on T. Hengl's 'getGSOD.R' script, available from <> with enhancements to be cross-platform, faster and more flexible. For information on the original data from NCDC, please see the GSOD readme.txt file available from, <>.

Version: 0.1.9
Depends: R (≥ 3.0.0)
Imports: curl, data.table, dplyr, doParallel, foreach, lubridate, iotools, iterators, parallel, raster, readr, rgdal, settings, sp, stats, stringr, utils
Published: 2016-07-15
Author: Adam Sparks [aut, cre], Tomislav Hengl [ctb], Andy Nelson [ctb], Kay Sumfleth [ctb]
Maintainer: Adam Sparks <adamhsparks at>
License: GPL (≥ 3)
NeedsCompilation: no
Citation: GSODR citation info
Materials: README NEWS
CRAN checks: GSODR results


Reference manual: GSODR.pdf
Package source: GSODR_0.1.9.tar.gz
Windows binaries: r-devel:, r-release:, r-oldrel:
OS X Mavericks binaries: r-release: GSODR_0.1.9.tgz, r-oldrel: GSODR_0.1.9.tgz
Old sources: GSODR archive