Construit ou reconstruit les images d'aperçus.

Usage :

gdaladdo [-r {nearest,average,gauss,cubic,average_mp,average_magphase,mode}]
       [-ro] [-clean] [--help-general] filename levels

Le programme gdaladdo peut être utilisé pour construire ou reconstruire les images d'aperçu pour la plupart des formats supportés avec un ou plusieurs algorithmes.

• -r {nearest (default),average,gauss,cubic,average_mp,average_magphase,mode} : Sélectionne un algorithme de re-échantillonnage.
• -ro : (Disponible à partir de gdal 1.6.0) Ouvre le jeu de données en mode lecture seul, dans le but de générer un aperçu externe (notamment pour les GeoTIFF).
• -clean : (disponible à partir de GDAL 1.7.0) enlève les aperçues.
• filename : Le fichier pour lequel on veut construire les aperçus (ou dont les aperçues doivent être enlevés).
• levels : Une liste de niveaux d'aperçu à construire. Ignoré avec l'option -clean.

Le mode (disponible à partir de gdal 1.6.0) sélectionne la valeur de tous les points de l'échantillon qui apparaît le plus souvent. average_mp n'est pas utilisable. Average_magphase donne une moyenne des données complexes dans l'espace mag/phase. Nearest et average sont applicable aux données des images normales. Nearest applique un re-échantillonnage du plus proche voisin (échantillonnage simple), tandis que average calcul la moyenne de tous les pixels différents de NODATA. Le reéchantillonnage Cubic (disponible à partir de GDAL 1.7.0) applique un motif de convolution cubique approximativement de 4×4. Gauss resampling (disponible à partir de gdal 1.6.0) applique une transformation de Gaussian avant le calcul de l'aperçu ce qui peut améliorer les résultats par rapport à une moyenne simple dans le cas des bords nets avec un fort contraste ou avec du bruit. Les valeurs des niveaux conseillés devraient être 2, 4, 8 … afin qu'un ré-échantillonnage Guassien de 3×3 soit sélectionné.

gdaladdo will honour properly NODATA_VALUES tuples (special dataset metadata) so that only a given RGB triplet (in case of a RGB image) will be considered as the nodata value and not each value of the triplet independantly per band.

La sélection d'une valeur de niveau 2 entraîne le calcul d'un niveau d'aperçu de la moitié de la résolution (pour chaque dimension) de la couche de base. Si le fichier possède des niveaux de résolution au niveau sélectionné, ces niveaux seront recalculés et écrits de nouveau.

Certains pilotes de format ne supportent pas les aperçus. Plusieurs pilotes de formats rangent les aperçus dans un fichier secondaire avec l'extension .ovr qui est en réalité un format tiff. Par défaut le pilote GeoTIFF range les aperçus à l'intérieure du fichier utilisé (s'il peut être écrasé), sauf si l'option -ro est définie.

Most drivers also support an alternate overview format using Erdas Imagine format. To trigger this use the USE_RRD=YES configuration option. This will place the overviews in an associated .aux file suitable for direct use with Imagine or ArcGIS as well as GDAL applications. (eg –config USE_RRD YES)

Les aperçus créés dans un format TIFF peuvent être compressés en utilisant l'option de configuration COMPREES_OVERVIEW. Toutes les méthodes de compression, supportées par le pilote GeoTIFF, sont disponibles ici (par exemple –config COMPRESS_OVERVIEW DEFLATE). L'interprétation photométrique peut être définie avec –config PHOTOMETRIC_OVERVIEW {RGB,YCBCR,…} , et l'entrelacement avec –config INTERLEAVE_OVERVIEW {PIXEL|BAND}.

For JPEG compressed external overviews, the JPEG quality can be set with “–config JPEG_QUALITY_OVERVIEW value” (GDAL 1.7.0 or later).

For LZW or DEFLATE compressed external overviews, the predictor value can be set with “–config PREDICTOR_OVERVIEW 1|2|3” (GDAL 1.8.0 or later).

Pour produire des aperçus en JPEG dans TIFF le plus petit possible, vous devez utiliser :

  --config COMPRESS_OVERVIEW JPEG --config PHOTOMETRIC_OVERVIEW YCBCR --config INTERLEAVE_OVERVIEW PIXEL

À partir de GDAL 1.7.0, les aperçues externes peuvent être créé au format BigTIFF en utilisant l'option de configuration BIGTIFF_OVERVIEW : –config BIGTIFF_OVERVIEW {IF_NEEDED|IF_SAFER|YES|NO}. La valeur par défaut est IF_NEEDED. Le comportement de cette option est exactement le même que l'option de création BIGTIFF documentée dans la documentation du pilote GeoTIFF.

• YES force BigTIFF.
• NO force des TIFF classic.
• IF_NEEDED créera seulement un BigTIFF si cela est clairement nécessaire (non compressé, et des aperçues plus grande que 4Go).
• IF_SAFER créera un BigTIFF si le fichier résultant *pourrait* excéder 4Go.

See the documentation of the GeoTIFF driver for further explanations on all those options.

Exemple :

Crée des aperçus, inclus dans le fichier TIFF fournit :

gdaladdo -r average abc.tif 2 4 8 16

Créé un fichier d'aperçu externe en GeoTIFF compressé à partir du fichier ERDAS .IMG :

gdaladdo -ro --config COMPRESS_OVERVIEW DEFLATE erdas.img 2 4 8 16

Créer un fichier d'aperçu du GeoTIFF compressé en JPEG à partir d'un jeu de données RVB à 3 bandes (if the dataset is a writable GeoTIFF, you also need to add the -ro option to force the generation of external overview) :

gdaladdo --config COMPRESS_OVERVIEW JPEG --config PHOTOMETRIC_OVERVIEW YCBCR
       --config INTERLEAVE_OVERVIEW PIXEL rgb_dataset.ext 2 4 8 16

Créé des aperçus au format Erdas Imagine pour le fichier JPEG indiqué :

gdaladdo --config USE_RRD YES airphoto.jpg 3 9 27 81

— Yves Jacolin 2010/12/27 18:20 (Trunk 21320)