From 4461b75eb8730f913e0bee6c921cc289645ce866 Mon Sep 17 00:00:00 2001 From: Dylan Beaudette Date: Thu, 8 Mar 2018 15:21:25 -0800 Subject: [PATCH] starting to implement SCAN and SNOTEL basic metadata, #61 --- R/fetchSCAN.R | 26 + data/SCAN_SNOTEL_metadata.rda | Bin 0 -> 40006 bytes misc/make-scan-snotel-metadata-db.R | 16 + misc/scan-snotel-metadata.csv | 1088 +++++++++++++++++++++++++++ 4 files changed, 1130 insertions(+) create mode 100644 data/SCAN_SNOTEL_metadata.rda create mode 100644 misc/make-scan-snotel-metadata-db.R create mode 100644 misc/scan-snotel-metadata.csv diff --git a/R/fetchSCAN.R b/R/fetchSCAN.R index 6d10c699..965b05a2 100644 --- a/R/fetchSCAN.R +++ b/R/fetchSCAN.R @@ -29,6 +29,13 @@ ## https://github.com/gunnarleffler/getSnotel ## +## site images: +## https://www.wcc.nrcs.usda.gov/siteimages/462.jpg +## +## site notes: +## https://wcc.sc.egov.usda.gov/nwcc/sitenotes?sitenum=462 +## + ## TODO: this crashes on 32bit R / libraries # helper function for getting a single table of SCAN metadata @@ -95,6 +102,22 @@ SCAN_sensor_metadata <- function(site.code) { } +## implement this ! +## https://github.com/ncss-tech/soilDB/issues/61 +# site.code: vector of SCAN site codes +SCAN_site_metadata <- function(site.code) { + + # hack to please R CMD check + SCAN_SNOTEL_metadata <- NULL + + # cached copy available in soilDB::SCAN_SNOTEL_metadata + load(system.file("data/SCAN_SNOTEL_metadata.rda", package="soilDB")[1]) + + # finish this ... +} + + + # site.code: vector of site codes # year: vector of years # report: single report type @@ -147,6 +170,9 @@ fetchSCAN <- function(site.code, year, report='SCAN', req=NULL) { res.rows <- sum(sapply(res, nrow), na.rm=TRUE) message(paste(res.rows, ' records (', res.size, ' Mb transferred)', sep='')) + ## TODO combine site metadata into results + # m <- SCAN_site_metadata(site.code) + return(res) } diff --git a/data/SCAN_SNOTEL_metadata.rda b/data/SCAN_SNOTEL_metadata.rda new file mode 100644 index 0000000000000000000000000000000000000000..868ff98471b7a264f5eeb9dcf9f23cc2daa4b506 GIT binary patch literal 40006 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 m5LZ#_lS0ZWl*Z&bDJ)H05F~4fi~E!O_x}N`fs