Construit un VRT à partir d'une liste de jeu de données.

gdalbuildvrt [-tileindex field_name] [-resolution {highest|lowest|average|user}]
           [-tr xres yres] [-tap] [-separate] [-allow_projection_difference] [-q]
           [-te xmin ymin xmax ymax] [-addalpha] [-hidenodata]
           [-srcnodata "value [value...]"] [-vrtnodata "value [value...]"]
           [-input_file_list my_liste.txt] [-overwrite] output.vrt [gdalfile]*

Ce programme construit un fichier VRT (Jeu de données virtuel) qui est une mosaïque d'une liste de jeux de données de GDAL en entrée. La liste des jeux de données de GDAL en entrée peut être définie à la fin de la ligne de commande, ou placer dans un fichier texte (un nom de fichier par ligne) pour les listes importantes, ou cela peut être un index de tuile de MapServer (voir l'utilitaire gdaltindex). Dans ce dernier cas, toutes les entrées dans l'index de tuile seront ajoutées au VRT.

Avec l'option -separate, chaque fichiers est placé dans une bande séparée et empilée dans les bandes VRT. Autrement, les fichiers sont considéré comme des tuiles d'une mosaïque plus importante et le fichier VRT a autant de bande que ceux des fichiers en entrée.

Si un jeu de données de GDAL est réalisé à partir de plusieurs sous jeu de données et ne possède aucune bande raster, tous les sous jeux de données seront ajoutés au fichier VRT plutôt que le jeu de données lui-même.

gdalbuildvrt réalise quelques vérifications pour s'assurer que tous les fichiers qui seront mis dans le VRT ont des caractéristiques similaires : nombre de bandes, projection, interprétation de couleur… Sinon, les fichiers qui ne correspondent pas aux caractéristiques communes seront ignorés.

S'il y a un certain taux de recouvrement, ente les fichiers, l'ordre de superposition peut dépendre de l'ordre où ils sont insérés dans le fichier VRT, mais vous ne devez pas compter sur ce comportement.

Cette commande est en partie différente de la commande gdal_vrtmerge.py et est compilé par défaut à partir de GDAL 1.6.1.

• -tileindex : utilise la valeur définie comme champ d'index de tuile, au lieu de la valeur par défaut, 'location'.

• -resolution {highest|lowest|average|user} : Si la résolution de tous les fichiers en entrée n'est pas la même, l'option -resolution permet à l'utilisateur de contrôler la manière dont la résolution en sortie sera calculée. average est celle par défaut. 'highest' will pick the smallest values of pixel dimensions within the set of source rasters. 'lowest' will pick the largest values of pixel dimensions within the set of source rasters. 'average' will compute an average of pixel dimensions within the set of source rasters. 'user' is new in GDAL 1.7.0 and must be used in combination with the -tr option to specify the target resolution.

• -tr xres yres : (à partir de GDAL 1.7.0)

(starting with GDAL 1.7.0) set target resolution. The values must be expressed in georeferenced units. Both must be positive values. Specifying those values is of course incompatible with highest|lowest|average values for -resolution option.

• -tap :

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

• -te xmin ymin xmax ymax : (à partir de GDAL 1.7.0)

(starting with GDAL 1.7.0) set georeferenced extents of VRT file. The values must be expressed in georeferenced units. If not specified, the extent of the VRT is the minimum bounding box of the set of source rasters.

• -addalpha : (à partir de GDAL 1.7.0)

(starting with GDAL 1.7.0) Adds an alpha mask band to the VRT when the source raster have none. Mainly useful for RGB sources (or grey-level sources). The alpha band is filled on-the-fly with the value 0 in areas without any source raster, and with value 255 in areas with source raster. The effect is that a RGBA viewer will render the areas without source rasters as transparent and areas with source rasters as opaque. This option is not compatible with -separate.

• -hidenodata : (à partir de GDAL 1.7.0)

(starting with GDAL 1.7.0) Even if any band contains nodata value, giving this option makes the VRT band not report the NoData. Useful when you want to control the background color of the dataset. By using along with the -addalpha option, you can prepare a dataset which doesn't report nodata value but is transparent in areas with no data.

• -srcnodata value [value…] : (à partir de GDAL 1.7.0)

(starting with GDAL 1.7.0) Set nodata values for input bands (different values can be supplied for each band). If more than one value is supplied all values should be quoted to keep them together as a single operating system argument. If the option is not specified, the instrinsic nodata settings on the source datasets will be used (if they exist). The value set by this option is written in the NODATA element of each ComplexSource element. Use a value of None to ignore intrinsic nodata settings on the source datasets.

• -vrtnodata value [value…] : (à partir de GDAL 1.7.0)

(starting with GDAL 1.7.0) Set nodata values at the VRT band level (different values can be supplied for each band). If more than one value is supplied all values should be quoted to keep them together as a single operating system argument. If the option is not specified, instrinsic nodata settings on the first dataset will be used (if they exist). The value set by this option is written in the NoDataValue element of each VRTRasterBand element. Use a value of None to ignore intrinsic nodata settings on the source datasets.

• -separate : (à partir de GDAL 1.7.0) place chaque fichier en entré dans une bande séparée et empilée. Dans ce cas, seule la première bande de chaque jeu de données sera placé dans une nouvelle bande. Contrairement au mode par défaut, il ne nécessite pas que toutes les bandes aient le même type de données.

• -allow_projection_difference : (à partir de GDAL 1.7.0) quand cette option est définie, la commande acceptera de réaliser un VRT même si les jeux de données en entrée n'ont pas la même projection. Note : cela ne signifie pas qu'ils seront reprojeté. Leurs projections seront simplement ignoré.

• -input_file_list : pour définir un fichier texte avec un nom de fichier à chaque ligne.

• -q : (à partir de GDAL 1.7.0) pour désactiver la barre de progression dans la console.

• -overwrite : écrase le VRT s'il existe déjà.

Exemple :

gdalbuildvrt doq_index.vrt doq/*.tif
gdalbuildvrt -input_file_list my_liste.txt doq_index.vrt
gdalbuildvrt -separate rgb.vrt red.tif green.tif blue.tif
gdalbuildvrt -hidenodata -vrtnodata "0 0 255" doq_index.vrt doq/*.tif

— Yves Jacolin 2010/12/28 15:12 (Trunk 21324)