burns vector polygons into a raster
Usage:
Usage: gdal_rasterize [-b band]
[-burn value] | [-a attribute_name] | [-3d]
[-l layername]* [-where expression] [-sql select_statement]
<src_datasource> <dst_filename>
This program burns vector polygons into the raster band(s) of a raster image. Vectors are read from OGR supported vector formats.
- -b band:
- 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.
- -burn value:
- A fixed value to burn into a band for all objects. A list of -burn options can be supplied, one per band being written to.
- -a attribute_name:
- Identifies an attribute field on the features to be used for a burn in value. The value will be burned into all output bands.
- -3d:
- Indicates that a burn value should be extracted from the "Z" values of the feature (not yet implemented).
- -l layername:
- 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 expression:
- An optional SQL WHERE style query expression to be applied to select features to burn in from the input layer(s).
- -sql select_statement:
- An SQL statement to be evaluated against the datasource to produce a virtual layer of features to be burned in.
- src_datasource:
- Any OGR supported readable datasource.
- dst_filename:
- The GDAL supported output file. Must support update mode access. Currently gdal_rasterize cannot create new output files though that may be added eventually.
Example:
The following would burn all polygons from mask.shp into the RGB TIFF file work.tif with the color red (RGB = 255,0,0).
gdal_rasterize -b 1 -b 2 -b 3 -burn 255 -burn 0 -burn 0 -l mask mask.shp work.tif
The following would burn all "class A" buildings into the output elevation file, pulling the top elevation from the ROOF_H attribute.
gdal_rasterize -a ROOF_H -where 'class="A"' -l footprints footprints.shp city_dem.tif
Generated for GDAL by
1.4.7.