soil_grids: Global soil data

soil_worldR Documentation

Global soil data


Download global soils data. The data are derived from the SoilGRIDS database. The data were aggregated and transformed to a longitude/latitude coordinate reference system with 30-second spatial resolution.

See for more info.

data license: CC-BY 4.0


soil_world(var, depth, stat="mean", name="", path, ...)



character. Variables name. One of: "bdod", "cfvo", "clay", "nitrogen", "ocd", "ocs", "phh2o", "sand", "silt", "soc", "wrb". See Details


numeric. One of 5, 15, 30, 60, 100, 200. This is shorthand for the following depth ranges: 0-5, 5-15, 15-30, 30-60, 60-100, 100-200 cm. Ignored if var="wrb"


character. One of "mean", "uncertainty", "Q0.05", "Q0.5", "Q0.95". Ignored if var="wrb"


character. One of "Acrisols", "Albeluvisols", "Alisols", "Andosols", "Arenosols", "Calcisols", "Cambisols", "Chernozems", "Cryosols", "Durisols", "Ferralsols", "Fluvisols", "Gleysols", "Gypsisols", "Histosols", "Kastanozems", "Leptosols", "Lixisols", "Luvisols", "Nitisols", "Phaeozems", "Planosols", "Plinthosols", "Podzols", "Regosols", "Solonchaks", "Solonetz", "Stagnosols", "Umbrisols", "Vertisols". Only used when var="wrb"


character. Path for storing the downloaded data. See geodata_path


additional arguments passed to download.file


var description unit
bdod Bulk density of the fine earth fraction kg dm-3
cec Cation Exchange Capacity of the soil cmol(+) kg-1
cfvo Vol. fraction of coarse fragments (> 2 mm) %
nitrogen Total nitrogen (N) g kg-1
phh2o pH (H2O) -
sand Sand (> 0.05 mm) in fine earth %
silt Silt (0.002-0.05 mm) in fine earth %
clay Clay (< 0.002 mm) in fine earth %
soc Soil organic carbon in fine earth g kg-1
ocd Organic carbon density kg m-3
ocs Organic carbon stocks kg m-2




Poggio L., de Sousa L.M., Batjes N.H., Heuvelink G.B.M., Kempen B., Ribeiro E., Rossiter D., 2021. SoilGrids 2.0: producing soil information for the globe with quantified spatial uncertainty. Soil 7:217-240, 2021. doi:10.5194/soil-7-217-2021

See Also

For virtual access to the original data: soil_world_vsi For Africa: soil_af_isda, soil_af, soil_af_elements


# this downloads a large file 
gph <- soil_world(var="phh2o", depth=5, path=tempdir())

geodata documentation built on June 22, 2024, 10:30 a.m.