soil_world function documentation or file storage issue

[peetmate]

Issue Summary

The soil_world() function documentation contains inconsistencies between the var argument, the var details section, and the available dataset files in geodata. Additionally, stat values (uncertainty, Q0.05, Q0.5, Q0.95) that are referenced in the documentation but not present in the file store.

⸻

Problem Details

1. Inconsistencies in the var Argument Documentation
   • The function is documented to accept the following var values, including cec and ocs, but these variables are not actually listed in the var details section.
   • The details section references cec and ocs, but the var argument description does not include them.

2. Missing Uncertainty Data
   • The stat argument mentions the availability of:
   • "mean"
   • "uncertainty"
   • "Q0.05"
   • "Q0.5"
   • "Q0.95"
   • However, checking the geodata file store, only "mean" files are available.
   • There are no files for uncertainty or quantiles (Q0.05, Q0.5, Q0.95).

3. WRB Data Mentioned in Arguments but Missing in Details
   • The details table does not mention wrb (World Reference Base soil classification).
   • However, the function arguments suggest that wrb can be used, implying a missing description in the documentation.

4. CEC Data Missing from SoilGrids?
   • It seems strange that cec (Cation Exchange Capacity) is not available from soil_world, despite being a key soil property in most global soil datasets.
   • Could this be a data availability issue, or is it simply an omission in the function documentation?