1gdal_rasterize(1)           General Commands Manual          gdal_rasterize(1)
2
3
4

NAME

6       gdal_rasterize - gdal_rasterize burns vector polygons into a raster
7

SYNOPSIS

9       Usage: gdal_rasterize [-b band]
10              [-burn value] | [-a attribute_name] | [-3d]
11              [-l layername]* [-where expression] [-sql select_statement]
12              <src_datasource> <dst_filename>
13

DESCRIPTION

15       This program burns vector polygons into the raster band(s) of a raster
16       image. Vectors are read from OGR supported vector formats.
17
18       -b band:
19           The band(s) to burn values into. Multiple -b arguments may be used
20           to burn into a list of bands. The default is to burn into band 1.
21
22       -burn value:
23           A fixed value to burn into a band for all objects. A list of -burn
24           options can be supplied, one per band being written to.
25
26       -a attribute_name:
27           Identifies an attribute field on the features to be used for a burn
28           in value. The value will be burned into all output bands.
29
30       -3d:
31           Indicates that a burn value should be extracted from the 'Z' values
32           of the feature (not yet implemented).
33
34       -l layername:
35           Indicates the layer(s) from the datasource that will be used for
36           input features. May be specified multiple times, but at least one
37           layer name or a -sql option must be specified.
38
39       -where expression:
40           An optional SQL WHERE style query expression to be applied to
41           select features to burn in from the input layer(s).
42
43       -sql select_statement:
44           An SQL statement to be evaluated against the datasource to produce
45           a virtual layer of features to be burned in.
46
47       src_datasource:
48           Any OGR supported readable datasource.
49
50       dst_filename:
51           The GDAL supported output file. Must support update mode access.
52           Currently gdal_rasterize cannot create new output files though that
53           may be added eventually.
54

EXAMPLE

56       The following would burn all polygons from mask.shp into the RGB TIFF
57       file work.tif with the color red (RGB = 255,0,0).
58
59       gdal_rasterize -b 1 -b 2 -b 3 -burn 255 -burn 0 -burn 0 -l mask mask.shp work.tif
60
61       The following would burn all 'class A' buildings into the output
62       elevation file, pulling the top elevation from the ROOF_H attribute.
63
64       gdal_rasterize -a ROOF_H -where 'class="A"' -l footprints footprints.shp city_dem.tif
65

AUTHORS

67       Frank Warmerdam <warmerdam@pobox.com>
68
69
70
71GDAL                              31 Jul 2007                gdal_rasterize(1)
Impressum