-
Notifications
You must be signed in to change notification settings - Fork 0
Home
This wiki holds the long-form context that doesn't fit in the API docs or the README: when to use which classification, what the pedotransfer functions actually compute, how to wire the library into a GeoTIFF pipeline, and how it stacks up against alternatives.
If you're new, start with the README — it's enough to classify your first sample. Then come back here when one of the following questions shows up:
| If you want to… | Read |
|---|---|
| See the kind of maps pedotri actually produces | Examples-gallery |
| Pick the right classification for your region | Classifications & when to use them |
| Understand why classifications conflict and how pedotri tries to help | Classification-challenges |
| Classify with SoilGrids-style Q05/Q95 uncertainty and get class probabilities | Uncertainty-aware classification |
| Aggregate a region (village / commune / farm) into a posterior — incl. SOC stock | Regional aggregation & SOC stock |
| Align mismatched-resolution rasters (SoilGrids 250 m + WorldCover 10 m + UTM DEM) | Reprojection & target grids |
| Propagate spatially-correlated uncertainty (not the lower-bound independent-pixel mode) | Spatial correlation |
| Compute slope / aspect / curvature / TWI from a DEM | DEM-derived indices |
| Document an LCA pipeline with ISO 14040 / 14044 traceability | ISO 14040 auditability |
| Classify the same sample under USDA + FAO + regional schemes at once | Classifications & when to use them |
| Convert sand/silt/clay between USDA, ISSS, KA5 | Soil-conversions |
| Predict water retention, Kₛ, bulk density | Pedotransfer-functions |
Plug lab reports (g/kg, organic carbon) into pedotri |
Units-and-organic-matter |
| Classify a whole GeoTIFF (e.g. SoilGrids) | GeoTIFF-and-SoilGrids |
| Build a soil-texture map (regional grids or sparse field samples) | Map-products-and-field-sampling |
See how pedotri compares to soiltexture
|
Benchmark-vs-soiltexture |
| Add a custom regional classification | Custom-classifications-in-practice |
The mkdocs site is the reference manual: function signatures, argument tables, the canonical class list. This wiki is the field guide — worked examples, tradeoffs, and the why-do-it-this-way explanations that age faster than the API does. Pages here can ship snippets, quote the literature loosely, and link out to data sources without adding maintenance load to the main docs.
Wiki pages target the latest minor release on PyPI. Where an example
depends on a feature that landed in a specific version (e.g.
pedotri.raster arrived in 0.2.0), the page calls that out explicitly.
Concepts
- Classifications & when to use them
- Classification-challenges
- Uncertainty-aware classification
- Regional aggregation & SOC stock
- Reprojection & target grids
- Spatial correlation
- DEM-derived indices
- Soil-conversions
- Pedotransfer-functions
- Units-and-organic-matter
Compliance
Use cases
- Examples-gallery
- GeoTIFF-and-SoilGrids
- Map-products-and-field-sampling
- Benchmark-vs-soiltexture
- Custom-classifications-in-practice
Development
External