Skip to content

Commit

Permalink
Prepare for new submission to CRAN
Browse files Browse the repository at this point in the history
  • Loading branch information
adamhsparks committed May 26, 2016
1 parent 07836d1 commit ff418d9
Show file tree
Hide file tree
Showing 7 changed files with 33 additions and 31 deletions.
37 changes: 16 additions & 21 deletions DESCRIPTION
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@ Package: GSODR
Type: Package
Title: Download, Clean and Generate New Variables from GSOD Data
Version: 0.1.6
Date: 2016-05-22
Date: 2016-05-26
Authors@R: c(person("Adam", "Sparks", role = c("aut", "cre"),
email = "[email protected]"),
person("Tomislav", "Hengl", role = "ctb",
Expand All @@ -28,27 +28,22 @@ Description: Download, clean, reformat and create new variables from the
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 and
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. 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
summarises each year by station and includes new variables: actual vapor
pressure, saturation vapor pressure and relative humidity are 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
<http://spatial-analyst.net/book/system/files/getGSOD.R> with enhancements
to be more cross-platform, faster and more flexible. Currently flags are
maintained for all of the columns except for MIN/MAX. In the original
MIN/MAX columns of the GSOD data, "blank indicates max temp was taken from
the explicit max temp report and not from the 'hourly' data. * indicates max
temp was derived from the hourly data (i.e., highest hourly or
synoptic-reported temperature).", GSOD readme.txt
<http://www1.ncdc.noaa.gov/pub/data/gsod/readme.txt>. For CSV files
resulting from GSODR the flags are stripped.
to be more cross-platform, faster and more flexible. See the GSOD readme.txt
<http://www1.ncdc.noaa.gov/pub/data/gsod/readme.txt>.
Depends:
R (>= 3.0.0)
License: GPL (>= 3)
Expand Down
7 changes: 7 additions & 0 deletions NEWS.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,10 @@
GSODR v0.1.6 (Release date: 2016-05-16)
==============
Changes
* Fix issue when reading .op files into R where temperature was incorrectly read causing negative values where T >= 100F, this issue caused RH values of >100% and incorrect TEMP values
* Spelling corrections
* Include MIN/MAX flag column
* Station data is now included in package rather than downloading from NCDC every time get_GSOD() is run, this data has some corrections where stations with missing LAT/LON values or elevation are omitted, this is **not** the original complete station list provided by NCDC

GSODR v0.1.5 (Release date: 2016-05-16)
==============
Expand Down
2 changes: 1 addition & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -32,7 +32,7 @@ Use `install_github("author/package")` to install this package.
See `?get_GSOD()` for the help file.

## Function description
This package consists of a single function, get_GSOD(), which generates a
This package consists of a single function, `get_GSOD()`, which generates a
.csv file in the respective year directory containing the following variables:
**STNID** - Station number (WMO/DATSAV3 number) for the location;
**WBAN** - number where applicable--this is the historical "Weather Bureau Air
Expand Down
10 changes: 5 additions & 5 deletions cran-comments.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,11 +9,11 @@ There were no ERRORs or WARNINGs.

## New minor release
This is a new minor release. In this version I have:
* Set values where MIN > MAX to NA
* Set more MIN/MAX/DEWP values to NA. GSOD README indicates that 999 indicates missing values in these columns, this does not appear to always be true. There are instances where 99 is the value recorded for missing data. While 99F is possible, the vast majority of these recorded values are missing data, thus the function now converts them to NA
* Fixed bug where YDAY not correctly calculated and reported in CSV file
* CSV files for station only queries now are names with the Station Identifier. Previously named same as Global data
* Likesise, CSV files for agroclimatology now are names with the Station Identifier. Previously named same as Global data
Changes
* Fixed an issue when reading .op files into R where temperature was incorrectly read causing negative values where T >= 100F, this issue caused RH values of >100% and incorrect TEMP values
* Made spelling corrections
* Included MIN/MAX flag columns
* Included station data in package rather than downloading from NCDC every time get_GSOD() is run

## Reverse dependencies

Expand Down
4 changes: 2 additions & 2 deletions revdep/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,13 +10,13 @@
|language |(EN) |
|collate |en_AU.UTF-8 |
|tz |Australia/Brisbane |
|date |2016-05-16 |
|date |2016-05-26 |

## Packages

|package |* |version |date |source |
|:-------|:--|:-------|:----------|:-------------------------|
|GSODR |* |0.1.5 |2016-05-16 |local (adamhsparks/GSODR) |
|GSODR |* |0.1.6 |2016-05-26 |local (adamhsparks/GSODR) |

# Check results
0 packages
Expand Down
Binary file modified revdep/checks.rds
Binary file not shown.
4 changes: 2 additions & 2 deletions revdep/problems.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,13 +10,13 @@
|language |(EN) |
|collate |en_AU.UTF-8 |
|tz |Australia/Brisbane |
|date |2016-05-16 |
|date |2016-05-26 |

## Packages

|package |* |version |date |source |
|:-------|:--|:-------|:----------|:-------------------------|
|GSODR |* |0.1.5 |2016-05-16 |local (adamhsparks/GSODR) |
|GSODR |* |0.1.6 |2016-05-26 |local (adamhsparks/GSODR) |

# Check results
0 packages with problems
Expand Down

0 comments on commit ff418d9

Please sign in to comment.