Skip to content

r.soils.texture

Define soil texture from sand and clay grid.

r.soils.texture sand=name clay=name scheme=name output=name [--overwrite] [--verbose] [--quiet] [--qq] [--ui]

Example:

r.soils.texture sand=name clay=name scheme=name output=name

grass.script.run_command("r.soils.texture", sand, clay, scheme, output, overwrite=None, verbose=None, quiet=None, superquiet=None)

Example:

gs.run_command("r.soils.texture", sand="name", clay="name", scheme="name", output="name")

grass.tools.Tools.r_soils_texture(sand, clay, scheme, output, overwrite=None, verbose=None, quiet=None, superquiet=None)

Example:

tools = Tools()
tools.r_soils_texture(sand="name", clay="name", scheme="name", output="name")

This grass.tools API is experimental in version 8.5 and expected to be stable in version 8.6.

Parameters

sand=name [required]
    Name of input sand map [0-100]
clay=name [required]
    Name of input clay map [0-100]
scheme=name [required]
    Text file with texture scheme
output=name [required]
    Name for output raster map
--overwrite
    Allow output files to overwrite existing files
--help
    Print usage summary
--verbose
    Verbose module output
--quiet
    Quiet module output
--qq
    Very quiet module output
--ui
    Force launching GUI dialog

sand : str, required
    Name of input sand map [0-100]
    Used as: input, raster, name
clay : str, required
    Name of input clay map [0-100]
    Used as: input, raster, name
scheme : str, required
    Text file with texture scheme
    Used as: input, file, name
output : str, required
    Name for output raster map
    Used as: output, raster, name
overwrite : bool, optional
    Allow output files to overwrite existing files
    Default: None
verbose : bool, optional
    Verbose module output
    Default: None
quiet : bool, optional
    Quiet module output
    Default: None
superquiet : bool, optional
    Very quiet module output
    Default: None

sand : str | np.ndarray, required
    Name of input sand map [0-100]
    Used as: input, raster, name
clay : str | np.ndarray, required
    Name of input clay map [0-100]
    Used as: input, raster, name
scheme : str | io.StringIO, required
    Text file with texture scheme
    Used as: input, file, name
output : str | type(np.ndarray) | type(np.array) | type(gs.array.array), required
    Name for output raster map
    Used as: output, raster, name
overwrite : bool, optional
    Allow output files to overwrite existing files
    Default: None
verbose : bool, optional
    Verbose module output
    Default: None
quiet : bool, optional
    Quiet module output
    Default: None
superquiet : bool, optional
    Very quiet module output
    Default: None

Returns:

result : grass.tools.support.ToolResult | np.ndarray | tuple[np.ndarray] | None
If the tool produces text as standard output, a ToolResult object will be returned. Otherwise, None will be returned. If an array type (e.g., np.ndarray) is used for one of the raster outputs, the result will be an array and will have the shape corresponding to the computational region. If an array type is used for more than one raster output, the result will be a tuple of arrays.

DESCRIPTION

r.soils.texture define soils texture from sand and clay distribution grid and a texture scheme definition.
Sand and clay grid are simple grid theme; scheme file is text ASCII file with *.dat extention like USDA.dat, FAO.dat and nternational.dat supplied with source code module in scheme directory. You can download *.dat files from the GRASS GIS addons repository

SEE ALSO

GRASS 8 Programmer's Manual

REFERENCES

Bourke P., 1987 Determining if a point lies on the interior of a polygon. Downloaded printed

Neteler M. and H. Mitasova 2004 Open Source GIS: A GRASS GIS Approach - Kluwer Academic Publisher/Springer, Boston, -Second edition ISBN: 1-4020-8064-6

Sanesi G., 2000 - Elementi di pedologia - Edagricole, Bologna

Texture AutoLookup (TAL) ver 4.2, 2002

Van Rossum G. - 2005 - Manuale di riferimento di python - Ed. Italiana, Fred L. Drake, Jr., editor

WATTON J. D., 1997 - Comparing C, Fortran, Lisp, java, python, perl, scheme (guile), and tcl using a floating point numerical test - point inside polygon. Applied mathematics and computer technology center alcoa technical center. Distribution documents.

AUTHOR

Gianluca Massei (g_massa@libero.it)

SOURCE CODE

Available at: r.soils.texture source code (history)
Latest change: Thursday Feb 20 13:02:26 2025 in commit 53de819