write.raster: Function to export CHILD layers to raster.

In coffeemuggler/RCHILD: Functions for flexible use of the landscape evolution model CHILD

Description

This function interpolates layers created by a CHILD run (e.g. elevation) and writes the result into one of the following raster formats: *.tiff, *.img, *.asc.

Usage

write.raster(dataset, filename, timestep, layer = "elevation", 
    resolution, projection, method = "lin", upliftrate)

Arguments

dataset	(S4-object) CHILD model run to export.
filename	Filename of the output data set. The extension determines the data type and must be one of the following: "*.tiff" - geotiff, "*.img" - erdas image, "*.asc" - ESRI raster file.
timestep	(numeric scalar or vector) The time step for which a surface shall be created. If timestep is a scalar, the raster will either the surface of this time step (if layer = "elevation") or the erosion rate between this time step and its precursor (if layer = "erosion"). If timestep is a vector (t1, t0), the raster will either be the difference of the surfaces of the two time steps (t1 - t0, if layer = "elevation") or the erosion rate between the two time steps (t0 to t1, if layer = "erosion").
layer	The layer type to export. Must be one of the following: "elevation" - (surface elevation) and "erosion" (erosion rate).
resolution	The spatial resolution of the output file. If not specified the mean node distance of the CHILD TIN is used.
projection	The geographic projection of the output file. If not specified, the exported raster data set will not have any reference.
method	Interpolation method for raster generation, default is "lin" ( cf. TIN.raster).
upliftrate	(numeric vector or scalar) Optional uplift rate(s) for erosion rate calculation, default is zero.

Value

A raster data set of the specified file type, stored in the working directory path.

Author(s)

Michael Dietze

References

CSDMS website. http://csdms.colorado.edu/wiki/Model:CHILD.
Tucker, GE. 2010. CHILD Users Guide for version R9.4.1. http://csdms.colorado.edu/mediawiki/images/Child_users_guide.pdf
Tucker, GE., Lancaster, ST., Gasparini, NM., Bras, RL. 2001. The Channel-Hillslope Integrated Landscape Development (CHILD) Model. In Harmon, RS., Doe, W.W. III (eds). Landscape Erosion and Evolution Modeling. Kluwer Academic/Plenum Publishers, pp. 349-388.

See Also

display.surface

Examples

# load example data set
data(hillslope1)

# export elevation of model hillslope1 at time step 5 as geotiff
write.raster(dataset = hillslope1,
             filename = "hillslope1_5.tiff",
             timestep = c(5, 1),
             layer = "elevation",
             resolution = 2)

coffeemuggler/RCHILD documentation built on Dec. 31, 2020, 10:05 p.m.