document and lazy-load BADM

modules/data.land/DESCRIPTION

@@ -66,5 +66,6 @@ Suggests:
     testthat (>= 1.0.2)
 License: BSD_3_clause + file LICENSE
 Copyright: Authors
+LazyData: true
 Encoding: UTF-8
 RoxygenNote: 7.2.3

modules/data.land/R/IC_BADM_Utilities.R

@@ -20,8 +20,7 @@ Read.IC.info.BADM <-function(lat, long){
   cov.factor <-1
   #Reading in the DB
   #
-  U.S.SB <-
-    load(system.file("data","BADM.rda", package = "PEcAn.data.land"))
+  U.S.SB <- PEcAn.data.land::BADM
 
 
   Regions <- EPA_ecoregion_finder(lat, long)

modules/data.land/R/data.R

@@ -0,0 +1,22 @@
+#' Biomass and soil data from FluxNet sites
+#'
+#' Contains data from 246 Fluxnet sites.
+#' Variables include aboveground and belowground biomass in various pools,
+#'   plus soil texture/chemistry/horizonation/C&N stocks.
+#'
+#' @format ## `BADM`
+#' A data frame with 12,300 rows and 13 columns:
+#' \describe{
+#'   \item{SITE_ID}{Fluxnet code for the site}
+#'   \item{LOCATION_ELEV, LOCATION_LAT, LOCATION_LON}{site coordinates}
+#'   \item{Date}{Measurement date}
+#'   \item{GROUP_ID}{TODO}
+#'   \item{VARIABLE_GROUP}{category, eg abovground biomass or soil chemistry}
+#'   \item{VARIABLE, DATAVALUE}{key and value for each measured variable}
+#'   \item{NA_L1CODE, NA_L1NAME, NA_L2CODE, NA_L2NAME}{
+#'		numeric IDs and names for the Level 1 and level 2 ecoregions where
+#'		this site is located}
+#' }
+#' @source Originally from Fluxnet <https://fluxnet.org/badm-data-product/>,
+#'  but the provenence and age of this specific file is not clear.
+"BADM"