Rastérise un vecteur polygone dans un raster.

Usage :
Usage: gdal_rasterize [-b band]* [-i] [-at]

     [-burn value]* | [-a attribute_name] [-3d]
     [-l layername]* [-where expression] [-sql select_statement]
     [-of format] [-a_srs srs_def] [-co "NAME=VALUE"]*
     [-a_nodata value] [-init value]*
     [-te xmin ymin xmax ymax] [-tr xres yres] [-tap] [-ts width height]
     [-ot {Byte/Int16/UInt16/UInt32/Int32/Float32/Float64/
           CInt16/CInt32/CFloat32/CFloat64}] [-q]
     <src_datasource> <dst_filename>

Ce programme transforme des géométries vectorielles (points, lignes et polygones) dans des bande(s) raster d'une image raster. Les fichiers vecteurs sont lus à partir des formats vectoriels gérés par OGR.

Notez que les données vecteur doivent être dans le même système de coordonnées que les données raster ; la reprojection à la volée n'est pas possible.

Depuis GDAL 1.8.0, le fichier cible de GDAL peut être créé par gdal_rasterize. Une des options -tr ou -ts doit être utilisé dans ce cas.

• -b band : la bande dans laquelle placer les valeurs. Plusieurs arguments -b peuvent être utilisés pour transformer une liste de bandes. Par défaut, une seule bande est transformée.
• -i : inverse la rastérisation. Imposer la valeur de la brulure fixée ou la valeur de la brulure associée avec le premier objet dans toute l'image en dehors du polygone fournie.
• -at :

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 rules.

• -burn value : une valeur fixe à créer dans la bande pour tous les objets. Une liste d'options -burn peut être fournit, un par bande à écrire.
• -a attribute_name : définit un champ d'attribut à utiliser sur l'objet comme valeur finale. Cette valeur sera utilisée dans toutes les bandes en sortie.
• -3d : indique que la valeur finale doit être extraite à partir de la valeur « Z » de l'objet (pas encore implémenté). Ces valeurs sont adjustées par la valeur de rasterisation donnée par les options “-burn value” ou “-a attribute_name” si ceux-ci ont été fournie. Pour l'instant seuls les points et les lignes sont dessinés en 3D.
• -l layername : la ou les couche(s) de la source de données qui sera utilisée pour les objets en entrées. Peut être définie plusieurs fois, mais au moins une couche ou une option -sql doit être définie.
• -where expression : une requête SQL de style WHERE optionnel doit être appliqué pour sélectionner les objets à rastériser à partir d'une ou plusieurs couche(s).
• -sql select_statement : requête SQL à utilisée sur la source de données pour produire une couche virtuelle d'objets à rastériser.
• -of format : (GDAL >= 1.8.0)

(GDAL >= 1.8.0) Select the output format. The default is GeoTIFF (GTiff). Use the short format name.

• -a_nodata value : (GDAL >= 1.8.0)

(GDAL >= 1.8.0) Assign a specified nodata value to output bands.

• -init value : (GDAL >= 1.8.0)

(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 srs_def : (GDAL >= 1.8.0)

(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 reproject features. The srs_def may be any of the usual GDAL/OGR forms, complete WKT, PROJ.4, EPSG:n or a file containing the WKT.

• -co “NAME=VALUE” : (GDAL >= 1.8.0)

(GDAL >= 1.8.0) Passes a creation option to the output format driver. Multiple -co options may be listed. See format specific documentation for legal creation options for each format.

• -te xmin ymin xmax ymax : (GDAL >= 1.8.0)

(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 xres yres : (GDAL >= 1.8.0)

(GDAL >= 1.8.0) set target resolution. The values must be expressed in georeferenced units. Both must be positive values.

• -tap : (GDAL >= 1.8.0)

(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 width height : (GDAL >= 1.8.0)

(GDAL >= 1.8.0) set output file size in pixels and lines. Note that -ts cannot be used with -tr

• -ot type : (GDAL >= 1.8.0)

(GDAL >= 1.8.0) For the output bands to be of the indicated data type. Defaults to Float64

• -q : (GDAL >= 1.8.0)

(GDAL >= 1.8.0) Suppress progress monitor and other non-error output.

• src_datasource : n'importe quelle source de données supportée par OGR en lecture.
• dst_filename : le fichier de sortie supporté par GDAL. Doit supporter le mode d'accès de mise à jour. Avant la version 1.8.0 de GDAL, gdal_rasterize ne pouvait pas créer de nouveau fichier de sortie.

Exemples :

La commande suivante rastérisera tous les polygones à partir de mask.shp en un fichier RGB TIFF work.tif avec la couleur rouge (RGB = 255,0,0) :

gdal_rasterize -b 1 -b 2 -b 3 -burn 255 -burn 0 -burn 0 -l mask mask.shp work.tif

La commande suivante rastérisera tout les bâtiments « class A » dans le fichier d'élévation en sortie, en prenant l'élévation à partir de l'attribut ROOF_H :

gdal_rasterize -a ROOF_H -where 'class="A"' -l footprints footprints.shp city_dem.tif

— Yves Jacolin 2010/12/28 18:39 (Trunk r21324)