From a6a65307cdf225c20b8457dd632a99269386ef20 Mon Sep 17 00:00:00 2001 From: Andrew Brown Date: Sat, 28 Jan 2023 17:30:35 -0800 Subject: [PATCH] Add ST_higher_taxa_codes_13th - still need integration of 13th into other datasets --- R/data-documentation.R | 16 +++++++++++++++- data-raw/package-datasets.R | 15 +++++++++------ data/ST_higher_taxa_codes_13th.rda | Bin 0 -> 16602 bytes data/ST_unique_list.rda | Bin 9660 -> 9677 bytes man/ST.Rd | 3 +++ man/ST_higher_taxa_codes_13th.Rd | 20 ++++++++++++++++++++ 6 files changed, 47 insertions(+), 7 deletions(-) create mode 100644 data/ST_higher_taxa_codes_13th.rda create mode 100644 man/ST_higher_taxa_codes_13th.Rd diff --git a/R/data-documentation.R b/R/data-documentation.R index e5376be..7df907f 100644 --- a/R/data-documentation.R +++ b/R/data-documentation.R @@ -2,7 +2,7 @@ #' @title Soil Taxonomy Hierarchy #' #' @description The first 4 levels of the US Soil Taxonomy hierarchy (soil order, suborder, greatgroup, subgroup), presented as a \code{data.frame} (denormalized) and a \code{list} of unique taxa. -#' +#' @details Ordered based on the unique letter codes denoting taxa from the 13th edition of the Keys to Soil Taxonomy. #' @usage data(ST) #' #' @references @@ -81,3 +81,17 @@ #' "ST_higher_taxa_codes_12th" +#' @title Letter Code Lookup Table for Position of Taxa within the Keys to Soil Taxonomy (13th Edition) +#' +#' @description A lookup table mapping unique taxonomic Order, Suborder, Great Group and Subgroups to letter codes that denote their logical position within the Keys. +#' +#' @references +#' +#' Soil Survey Staff. 2022. Keys to Soil Taxonomy, 13th ed. USDA-Natural Resources Conservation Service. +#' \url{https://www.nrcs.usda.gov/resources/guides-and-instructions/keys-to-soil-taxonomy} +#' +#' @usage data(ST_higher_taxa_codes_13th) +#' +#' @keywords datasets +#' +"ST_higher_taxa_codes_13th" diff --git a/data-raw/package-datasets.R b/data-raw/package-datasets.R index 580e930..314b8c6 100644 --- a/data-raw/package-datasets.R +++ b/data-raw/package-datasets.R @@ -63,20 +63,23 @@ write.csv(ST.family.classes, file='data-raw/ST-family-classes.csv', row.names=FA ST <- read.csv('data-raw/ST-full.csv', stringsAsFactors = FALSE) usethis::use_data(ST, overwrite = TRUE) -ST_logic <- cbind(ST, ) - ## unique taxa, sorted by appearance in the 'Keys ## as a list ST_unique_list <- list() -# requires codes / taxa list -load('data/ST_higher_taxa_codes_12th.rda') load('data/ST.rda') +# requires codes / taxa list +ST_higher_taxa_codes_13th <- jsonlite::fromJSON("https://raw.githubusercontent.com/ncss-tech/SoilKnowledgeBase/main/inst/extdata/KST/2022_KST_codes.json") +colnames(ST_higher_taxa_codes_13th) <- c("code", "taxon") +usethis::use_data(ST_higher_taxa_codes_13th, overwrite = TRUE) + +latest_taxa <- ST_higher_taxa_codes_13th + # re-arrange taxa according to letter codes in the 'Keys .uniqueTaxaLogicalOrdering <- function(x) { # find taxa in the letter code LUT - idx <- match(tolower(x), tolower(ST_higher_taxa_codes_12th$taxon)) + idx <- match(tolower(x), tolower(latest_taxa$taxon)) # missing taxa if (any(is.na(idx))) { @@ -84,7 +87,7 @@ load('data/ST.rda') } # sort taxa based on letter codes - res <- ST_higher_taxa_codes_12th$taxon[idx][order(ST_higher_taxa_codes_12th$code[idx])] + res <- latest_taxa$taxon[idx][order(latest_taxa$code[idx])] return(tolower(res)) } diff --git a/data/ST_higher_taxa_codes_13th.rda b/data/ST_higher_taxa_codes_13th.rda new file mode 100644 index 0000000000000000000000000000000000000000..e85bf415ff1097213c923b5e1261571aaff1b735 GIT binary patch literal 16602 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
;cpz=DKA6hqpo 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 delta 9392 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 qUvi@Uh^YX3kQr4O2_J$2C$gep@