Query soil/climate data from USDA-NRCS SCAN Stations

SCAN_sensor_metadata(site.code)

SCAN_site_metadata(site.code = NULL)

fetchSCAN(site.code, year, report = "SCAN", ...)

Arguments

site.code

a vector of site codes. If NULL SCAN_site_metadata() returns metadata for all SCAN sites.

year

a vector of years

report

report name, single value only

...

additional arguments (not used)

Value

a data.frame object; NULL on bad request.

Details

Possible above and below ground sensor types include: 'SMS' (soil moisture), 'STO' (soil temperature), 'SAL' (salinity), 'TAVG' (daily average air temperature), 'TMIN' (daily minimum air temperature), 'TMAX' (daily maximum air temperature), 'PRCP' (daily precipitation), 'PREC' (daily precipitation), 'SNWD' (snow depth), 'WTEQ' (snow water equivalent),'WDIRV' (wind direction), 'WSPDV' (wind speed), 'LRADT' (solar radiation/langley total).

See the SCAN and SNOTEL FAQ for answers to common questions about these data.

See the fetchSCAN tutorial for additional usage and visualization examples.

References

https://www.nrcs.usda.gov/wps/portal/wcc/home/

Author

D.E. Beaudette, A.G. Brown

Examples


# \donttest{
if(requireNamespace("curl") &
    curl::has_internet()) {

    # get data
    x <- try(fetchSCAN(site.code=c(356, 2072), year=c(2015, 2016)))
    str(x)

    # get sensor metadata
    m <- SCAN_sensor_metadata(site.code=c(356, 2072))

    # get site metadata
    m <- SCAN_site_metadata(site.code=c(356, 2072))
}
#> 19334 records (0.83 Mb transferred)
#> List of 14
#>  $ SMS     :'data.frame':	5752 obs. of  7 variables:
#>   ..$ Site      : int [1:5752] 356 356 356 356 356 356 356 356 356 356 ...
#>   ..$ Date      : Date[1:5752], format: "2015-01-01" "2015-01-02" ...
#>   ..$ water_year: num [1:5752] 2015 2015 2015 2015 2015 ...
#>   ..$ water_day : int [1:5752] 93 94 95 96 97 98 99 100 101 102 ...
#>   ..$ value     : num [1:5752] 0 0 0 0 0 0 0 0 0 0 ...
#>   ..$ depth     : num [1:5752] 5 5 5 5 5 5 5 5 5 5 ...
#>   ..$ sensor.id : Factor w/ 5 levels "SMS.I_2","SMS.I_8",..: 1 1 1 1 1 1 1 1 1 1 ...
#>  $ STO     :'data.frame':	5843 obs. of  7 variables:
#>   ..$ Site      : int [1:5843] 356 356 356 356 356 356 356 356 356 356 ...
#>   ..$ Date      : Date[1:5843], format: "2015-01-01" "2015-01-02" ...
#>   ..$ water_year: num [1:5843] 2015 2015 2015 2015 2015 ...
#>   ..$ water_day : int [1:5843] 93 94 95 96 97 98 99 100 101 102 ...
#>   ..$ value     : num [1:5843] 1.4 1.4 1.3 1.3 1.3 1.3 1.3 1.4 1.4 1.4 ...
#>   ..$ depth     : num [1:5843] 5 5 5 5 5 5 5 5 5 5 ...
#>   ..$ sensor.id : Factor w/ 5 levels "STO.I_2","STO.I_8",..: 1 1 1 1 1 1 1 1 1 1 ...
#>  $ SAL     :'data.frame':	0 obs. of  0 variables
#>  $ TAVG    :'data.frame':	1460 obs. of  7 variables:
#>   ..$ Site      : int [1:1460] 356 356 356 356 356 356 356 356 356 356 ...
#>   ..$ Date      : Date[1:1460], format: "2015-01-01" "2015-01-02" ...
#>   ..$ water_year: num [1:1460] 2015 2015 2015 2015 2015 ...
#>   ..$ water_day : int [1:1460] 93 94 95 96 97 98 99 100 101 102 ...
#>   ..$ value     : num [1:1460] -13.1 -6.3 -4.6 -1.5 0.5 2 3 2.2 1.2 2.2 ...
#>   ..$ depth     : num [1:1460] NA NA NA NA NA NA NA NA NA NA ...
#>   ..$ sensor.id : Factor w/ 1 level "TAVG.D": 1 1 1 1 1 1 1 1 1 1 ...
#>  $ TMIN    :'data.frame':	1460 obs. of  7 variables:
#>   ..$ Site      : int [1:1460] 356 356 356 356 356 356 356 356 356 356 ...
#>   ..$ Date      : Date[1:1460], format: "2015-01-01" "2015-01-02" ...
#>   ..$ water_year: num [1:1460] 2015 2015 2015 2015 2015 ...
#>   ..$ water_day : int [1:1460] 93 94 95 96 97 98 99 100 101 102 ...
#>   ..$ value     : num [1:1460] -17 -10.9 -12.5 -8.1 -5.2 -4.2 -2.2 -3.8 -5.1 -1.4 ...
#>   ..$ depth     : num [1:1460] NA NA NA NA NA NA NA NA NA NA ...
#>   ..$ sensor.id : Factor w/ 1 level "TMIN.D": 1 1 1 1 1 1 1 1 1 1 ...
#>  $ TMAX    :'data.frame':	1460 obs. of  7 variables:
#>   ..$ Site      : int [1:1460] 356 356 356 356 356 356 356 356 356 356 ...
#>   ..$ Date      : Date[1:1460], format: "2015-01-01" "2015-01-02" ...
#>   ..$ water_year: num [1:1460] 2015 2015 2015 2015 2015 ...
#>   ..$ water_day : int [1:1460] 93 94 95 96 97 98 99 100 101 102 ...
#>   ..$ value     : num [1:1460] -8.9 2 7 9.2 8.1 11.3 13.8 12.5 10.3 6.4 ...
#>   ..$ depth     : num [1:1460] NA NA NA NA NA NA NA NA NA NA ...
#>   ..$ sensor.id : Factor w/ 1 level "TMAX.D": 1 1 1 1 1 1 1 1 1 1 ...
#>  $ PRCP    :'data.frame':	581 obs. of  7 variables:
#>   ..$ Site      : int [1:581] 2072 2072 2072 2072 2072 2072 2072 2072 2072 2072 ...
#>   ..$ Date      : Date[1:581], format: "2015-01-01" "2015-01-02" ...
#>   ..$ water_year: num [1:581] 2015 2015 2015 2015 2015 ...
#>   ..$ water_day : int [1:581] 93 94 95 96 97 98 99 100 101 102 ...
#>   ..$ value     : num [1:581] 0 0 0 0.08 0 0 0 0 0.23 0 ...
#>   ..$ depth     : num [1:581] NA NA NA NA NA NA NA NA NA NA ...
#>   ..$ sensor.id : Factor w/ 1 level "PRCP.D": 1 1 1 1 1 1 1 1 1 1 ...
#>  $ PREC    :'data.frame':	1316 obs. of  7 variables:
#>   ..$ Site      : int [1:1316] 356 356 356 356 356 356 356 356 356 356 ...
#>   ..$ Date      : Date[1:1316], format: "2015-01-01" "2015-01-02" ...
#>   ..$ water_year: num [1:1316] 2015 2015 2015 2015 2015 ...
#>   ..$ water_day : int [1:1316] 93 94 95 96 97 98 99 100 101 102 ...
#>   ..$ value     : num [1:1316] 9.1 9.1 9.1 9.1 9.1 9.1 9.1 9.1 9.1 9.1 ...
#>   ..$ depth     : num [1:1316] NA NA NA NA NA NA NA NA NA NA ...
#>   ..$ sensor.id : Factor w/ 1 level "PREC.I": 1 1 1 1 1 1 1 1 1 1 ...
#>  $ SNWD    :'data.frame':	731 obs. of  7 variables:
#>   ..$ Site      : int [1:731] 356 356 356 356 356 356 356 356 356 356 ...
#>   ..$ Date      : Date[1:731], format: "2015-01-01" "2015-01-02" ...
#>   ..$ water_year: num [1:731] 2015 2015 2015 2015 2015 ...
#>   ..$ water_day : int [1:731] 93 94 95 96 97 98 99 100 101 102 ...
#>   ..$ value     : num [1:731] 21 20 20 20 19 18 18 18 17 17 ...
#>   ..$ depth     : num [1:731] NA NA NA NA NA NA NA NA NA NA ...
#>   ..$ sensor.id : Factor w/ 1 level "SNWD.I": 1 1 1 1 1 1 1 1 1 1 ...
#>  $ WTEQ    :'data.frame':	731 obs. of  7 variables:
#>   ..$ Site      : int [1:731] 356 356 356 356 356 356 356 356 356 356 ...
#>   ..$ Date      : Date[1:731], format: "2015-01-01" "2015-01-02" ...
#>   ..$ water_year: num [1:731] 2015 2015 2015 2015 2015 ...
#>   ..$ water_day : int [1:731] 93 94 95 96 97 98 99 100 101 102 ...
#>   ..$ value     : num [1:731] 6.1 6.1 6.1 6.1 6.1 6.1 6.1 6.1 6.1 6.1 ...
#>   ..$ depth     : num [1:731] NA NA NA NA NA NA NA NA NA NA ...
#>   ..$ sensor.id : Factor w/ 1 level "WTEQ.I": 1 1 1 1 1 1 1 1 1 1 ...
#>  $ WDIRV   :'data.frame':	0 obs. of  0 variables
#>  $ WSPDV   :'data.frame':	0 obs. of  0 variables
#>  $ LRADT   :'data.frame':	0 obs. of  0 variables
#>  $ metadata:'data.frame':	2 obs. of  12 variables:
#>   ..$ Name         : chr [1:2] "Blue Lakes" "Eros Data Center"
#>   ..$ Site         : num [1:2] 356 2072
#>   ..$ State        : chr [1:2] "California" "South Dakota"
#>   ..$ Network      : chr [1:2] "SNOTEL" "SCAN"
#>   ..$ County       : chr [1:2] "Alpine" "Minnehaha"
#>   ..$ Elevation_ft : num [1:2] 8067 1602
#>   ..$ Latitude     : num [1:2] 38.6 43.7
#>   ..$ Longitude    : num [1:2] -119.9 -96.6
#>   ..$ HUC          : chr [1:2] "180400120101" "101702031402"
#>   ..$ climstanm    : chr [1:2] NA "Eros Data Center"
#>   ..$ upedonid     : chr [1:2] NA "S2003SD099001"
#>   ..$ pedlabsampnum: chr [1:2] NA "03N0688"
# }