Usage
gdal_rasterize(src_datasource, dst_filename, b, i, at, burn, a, threeD, l,
where, sql, of, a_srs, co, a_nodata, init, te, tr, tap, ts, ot, q,
additional_commands, output_Raster = FALSE, verbose = FALSE)
Arguments
src_datasource
Character. Any OGR supported
readable datasource.
dst_filename
Character. The GDAL supported output
file. Must support update mode access. Before GDAL 1.8.0,
gdal_rasterize could not create new output files.
b
Numeric. The band(s) to burn values into.
Multiple -b arguments may be used to burn into a list of
bands. The default is to burn into band 1.
i
Logical. Invert rasterization. Burn the fixed
burn value, or the burn value associated with the first
feature into all parts of the image not inside the
provided a polygon.
at
Logical. Enables the ALL_TOUCHED rasterization
option so that all pixels touched by lines or polygons
will be updated not just those one the line render path,
or whose center point is within the polygon. Defaults to
disabled for normal rendering r
burn
Numeric. A fixed value to burn into a band
for all objects. A vector of burn options can be
supplied, one per band being written to.
a
Character. Identifies an attribute field on the
features to be used for a burn in value. The value will
be burned into all output bands.
threeD
Logical. (GDAL parameter '3d') Indicates
that a burn value should be extracted from the "Z" values
of the feature. These values are adjusted by the burn
value given by "-burn value" or "-a attribute_name" if
provided. As of now, only points and li
l
Character. Indicates the layer(s) from the
datasource that will be used for input features. May be
specified multiple times, but at least one layer name or
a -sql option must be specified.
where
Character. An optional SQL WHERE style query
expression to be applied to select features to burn in
from the input layer(s).
sql
Character. An SQL statement to be evaluated
against the datasource to produce a virtual layer of
features to be burned in.
of
Character. (GDAL >= 1.8.0) Select the output
format. The default is GeoTIFF (GTiff). Use the short
format name.
a_nodata
Numeric. (GDAL >= 1.8.0) Assign a
specified nodata value to output bands.
init
Numeric. (GDAL >= 1.8.0) Pre-initialize the
output image bands with these values. However, it is not
marked as the nodata value in the output file. If only
one value is given, the same value is used in all the
bands.
a_srs
Character. (GDAL >= 1.8.0) Override the
projection for the output file. If not specified, the
projection of the input vector file will be used if
available. If incompatible projections between input and
output files, no attempt will be made to rep
co
Character. (GDAL >= 1.8.0) Passes a creation
option ("NAME=VALUE") to the output format driver.
Multiple -co options may be listed. See format specific
documentation for legal creation options for each
format.
te
Numeric. c(xmin,ymin,xmax,ymax) (GDAL >= 1.8.0)
set georeferenced extents. The values must be expressed
in georeferenced units. If not specified, the extent of
the output file will be the extent of the vector layers.
tr
Numeric. c(xres,yres) (GDAL >= 1.8.0) set
target resolution. The values must be expressed in
georeferenced units. Both must be positive values.
tap
Logical. (GDAL >= 1.8.0) (target aligned
pixels) align the coordinates of the extent of the output
file to the values of the -tr, such that the aligned
extent includes the minimum extent.
ts
Numeric. c(width,height) (GDAL >= 1.8.0) set
output file size in pixels and lines. Note that -ts
cannot be used with -tr
ot
Character. (GDAL >= 1.8.0) For the output bands
to be of the indicated data type. Defaults to Float64
q
Logical. (GDAL >= 1.8.0) Suppress progress
monitor and other non-error output.
additional_commands
Character. Additional commands
to pass directly to gdal_rasterize.
output_Raster
Logical. Return output dst_filename
as a RasterBrick?