Reads the AfSP DBase tables shipped inside AF-AfSP1.2.zip
(downloadable from
https://files.isric.org/public/afsp/AF-AfSP1.2.zip) and
converts each profile + its horizons to a soilKey
PedonRecord. Filters to profiles with a populated
WRB 2006 RSG code (i.e.\ classifiable; AfSP has ~7000 of these of
the total 18,533).
Usage
load_afsp_pedons(
afsp_dir,
max_n = NULL,
countries = NULL,
wrb_codes = NULL,
verbose = TRUE
)Arguments
- afsp_dir
Directory containing the extracted AfSP DBase tables (
AfSP012Qry_Profiles.dbf,AfSP012Qry_Layers.dbf).- max_n
Optional integer; take a random sample of this size from the classifiable profiles.
- countries
Optional character vector of ISO country codes to keep (e.g.\
c("MW", "ET", "TZ")).- wrb_codes
Optional character vector of WRB 2006 RSG codes to keep (e.g.\
c("VR", "FR", "AC")).- verbose
Print progress.
Value
A list of PedonRecord objects.
Details
The structure type, grade and size are AfSP class codes (FAO-ISRIC 1990,
FAO 2006). Since v0.9.312 they are read by the AfSP dictionary
(AfSP012Qry_DictioClassValues) into soilKey's words: a range of grades
by its lower end, a range of sizes with both ends, and a code the dictionary
does not define as not recorded. Each code goes to the provenance.
Since v0.9.397 the loader also reads, as recorded: Mottling into
mottles_present (Y TRUE, N FALSE; the amount and the
colours of the mottles are not recorded by AfSP), ClyMinera into
clay_mineralogy (montmorillonitic and SM as smectite, kaolinitic,
illitic, vermiculitic, interstratified; chloritic, sesquioxidic, allophane,
KA/IL and gibbsite have no clay_mineralogy word and are read as not
recorded; the value is an estimate, recorded with the provenance
inferred_prior, so the evidence grade of a result drops to C),
and Sticknss into stickiness (sticky as moderately sticky).
Since v0.9.399 it reads on the site Drain into
drainage_class, and ParMat and LndForm into
parent_material and landform by the words of the AfSP
dictionary when AfSP012Qry_DictioClassValues.dbf is in
afsp_dir: a parent material with the words of its ancestors
("volcanic rocks, acid"; "clayey, fluvial, calcareous"), the codes of the
unconsolidated deposits the dictionary does not list decoded by its
pattern; only the landforms that say something of the origin of the
material (depression, low-gradient footslope, valley floor).