Figure.grdimage¶

Ici vous aurez des explications sur la commande et ses différents paramètres.

Figure.grdimage(grid, \*, img_out=None, frame=None, cmap=None,
img_in=None, dpi=None, bit_color=None, shading=None, projection=None
monochrome=None, no_clip=None, nan_transparent=None, region=None,
verbose=None, interpolation=None, panel=None, coltypes=None,
perspective=None, transparency=None, cores=None, \**kwargs)

Utilité :¶

Projet et traçage de grilles ou d’images.

Lit un fichier de grille 2D et produit une carte ombrée en niveaux de gris (ou en couleur) en construisant une image rectangulaire et en attribuant à chaque pixel une nuance de gris (ou une couleur) en fonction de la valeur z et du fichier CPT. En option, une illumination peut être ajoutée en fournissant un fichier avec des intensités dans la plage (-1,+1) ou des instructions pour dériver les intensités à partir de la grille de données d’entrée. Les valeurs en dehors de cette plage seront rognées. De tels fichiers d’intensité peuvent être créés à partir de la grille en utilisant pygmt.grdgradient et, éventuellement, modifiés par la fonction grdmath ou pygmt.grdhisteq. Si GMT est construit avec le support de GDAL, la grille peut être un fichier d’image (géoréférencé ou non). Dans ce cas, l’image peut éventuellement être illuminée avec le fichier fourni via le paramètre shading. Ici, si l’image n’a pas de coordonnées, celles du fichier d’intensité seront utilisées.

Lors de l’utilisation de projections cartographiques, la grille est d’abord rééchantillonnée sur une nouvelle grille rectangulaire avec les mêmes dimensions. Des images de résolution supérieure peuvent être obtenues en utilisant le paramètre dpi. Pour obtenir la valeur rééchantillonnée (et donc l’ombrage ou la couleur) de chaque pixel de la carte, sa position est projetée de manière inverse sur la grille d’entrée, après quoi une valeur est interpolée entre les valeurs de grille d’entrée environnantes. Par défaut, une interpolation bicubique est utilisée. L’aliasing est évité en projetant également les nœuds de la grille d’entrée. Si deux nœuds ou plus sont projetés sur le même pixel, leur moyenne dominera dans le calcul de la valeur du pixel. L’interpolation et l’aliasing sont contrôlés avec le paramètre interpolation.

Le paramètre region peut être utilisé pour sélectionner une région de carte plus grande ou plus petite que celle impliquée par l’étendue de la grille.

Paramètres :¶

grid (str ou xarray.DataArray) - Le nom du fichier ou une DataArray contenant l’ensemble de données de grille 2D d’entrée ou une image à tracer (Voir les FORMATS DE FICHIER DE GRILLE sur https://docs.generic-mapping-tools.org/latest/grdimage.html#grid-file-formats).

img_out (str) - out_img[=driver]. Enregistrer une image dans un format raster au lieu de PostScript. Utilisez l’extension .ppm pour un format Portable Pixel Map, le seul format raster nativement pris en charge par GMT. Pour les installations de GMT configurées avec le support de GDAL, il existe plus de choix : ajoutez out_img pour sélectionner le nom du fichier image et l’extension. Si l’extension est l’une des extensions .bmp, .gif, .jpg, .png ou .tif, aucune information sur le pilote n’est requise. Pour les autres formats de sortie, vous devez ajouter le pilote GDAL requis. Le pilote est le nom du code du pilote utilisé par GDAL ; consultez la documentation de votre installation GDAL pour connaître les pilotes disponibles. Ajoutez une chaîne +cargs où args est une liste d’un ou plusieurs nombres concaténés d’arguments GDAL -co. Par exemple, pour écrire un GeoPDF avec le format TerraGo, utilisez =PDF+cGEO_ENCODING=OGC_BP. Remarques : (1) Si un fichier tiff (.tif) est sélectionné, nous écrirons une image GeoTiff si la syntaxe de projection GMT se traduit par une syntaxe PROJ, sinon un fichier tiff simple est produit. (2) Tous les éléments vectoriels seront perdus.

frame (bool ou str ou list) - Définit les attributs du cadre et des axes de la limite de la carte.

cmap (str) - Nom du fichier CPT (Color Palette Table) ou une série de couleurs séparées par des virgules (par exemple, couleur1,couleur2,couleur3) pour construire automatiquement une CPT linéaire continue à partir de ces couleurs.

img_in (str) - [r]. GMT détectera automatiquement les fichiers d’image standard (Geotiff, TIFF, JPG, PNG, GIF, etc.) et les lira via GDAL. Pour les formats d’image très obscurs, vous devrez peut-être définir explicitement img_in, ce qui spécifie que la grille est en fait un fichier image à lire via GDAL. Ajoutez r pour attribuer la région spécifiée par region à l’image. Par exemple, si vous avez utilisé region= »d », l’image se verra attribuer un domaine global. Ce mode vous permet de projeter une image brute (une image sans coordonnées de référence).

dpi (int) - [i|dpi]. Définit la résolution de la grille projetée qui sera créée si une projection cartographique autre que linéaire ou Mercator est sélectionnée [La valeur par défaut est 100 dpi]. Par défaut, la grille projetée aura la même taille (nombre de lignes et de colonnes) que le fichier d’entrée. Spécifiez i pour utiliser l’opérateur d’image PostScript afin d’interpoler l’image à la résolution de l’appareil - bit_color (str) - couleur[+b|f]. Ce paramètre s’applique uniquement lorsque l’image résultante en niveaux de gris consisterait uniquement en deux couleurs : noir (0) et blanc (255). Si tel est le cas, ce paramètre utilisera plutôt l’image en tant que masque transparent et remplira le masque avec la couleur spécifiée. Ajoutez +b pour remplir les pixels d’arrière-plan (1) ou +f pour les pixels de premier plan [La valeur par défaut est +f].

shading (str ou xarray.DataArray) - [fichier_intensité|intensité|modificateurs]. Indiquez le nom d’un fichier de grille ou d’une DataArray contenant des intensités dans la plage (-1,+1), ou une intensité constante à appliquer partout (affecte la lumière ambiante). Alternativement, dérivez une grille d’intensité à partir de la grille de données d’entrée via un appel à pygmt.grdgradient ; ajoutez +aazimuth, +nargs et +mambient pour spécifier les arguments d’azimuth, d’intensité et d’ambiance pour cette fonction, ou donnez simplement +d pour sélectionner les arguments par défaut (+a-45+nt1+m0). Si vous souhaitez un scénario d’intensité plus spécifique, exécutez d’abord pygmt.grdgradient séparément. Si nous devons dériver les intensités d’un autre fichier que la grille, spécifiez le fichier avec les modificateurs appropriés [La valeur par défaut est aucune illumination]. Remarque : Si les données d’entrée sont une image, un fichier d’intensité ou une intensité constante doivent être fournis.

projection (str) - code_proj[params_proj/]largeur. Sélectionnez la projection cartographique.

monochrome (bool) - Force la conversion en image monochrome en utilisant la transformation YIQ (télévision). Ne peut pas être utilisé avec nan_transparent.

no_clip (bool) - Ne pas découper l’image aux limites du cadre (uniquement pertinent pour les cartes non rectangulaires) [La valeur par défaut est False].

nan_transparent (bool ou str) - [+valeur_z][couleur] Rendre transparents les nœuds de grille avec z = NaN, en utilisant la fonctionnalité de masquage des couleurs en PostScript Level 3 (le périphérique PS doit prendre en charge PS Level 3). Si l’entrée est une grille, utilisez +z avec une valeur pour sélectionner une autre valeur de grille que NaN. Si l’entrée est une image, ajoutez une couleur alternative pour sélectionner une autre valeur de pixel à rendre transparente [La valeur par défaut est « noir »].

region (str ou list) - xmin/xmax/ymin/ymax[+r][+uunit]. Spécifiez la région d’intérêt.

verbose (bool ou str) - Sélectionnez le niveau de verbosité [La valeur par défaut est w], qui module les messages écrits sur stderr. Choisissez parmi 7 niveaux de verbosité :

q - Silencieux, même les messages d’erreur fatals ne sont pas produits

e - Messages d’erreur uniquement

w - Avertissements [Par défaut]

t - Durées (rapports des temps d’exécution pour les algorithmes gourmands en temps)

i - Messages informatifs (identique à verbose=True)

c - Avertissements de compatibilité

d - Messages de débogage

panel (bool ou int ou list) - [ligne,colonne|indice]. Sélectionnez un panneau de sous-tracé spécifique. Uniquement autorisé en mode sous-tracé. Utilisez panel=True pour passer au panneau suivant dans l’ordre sélectionné. Au lieu de ligne,colonne, vous pouvez également donner une valeur scalaire d’indice qui dépend de l’ordre défini via autolabel lorsque le sous-tracé a été défini. Remarque : ligne, colonne et indice commencent tous à 0.

coltypes (str) - [i|o]colinfo. Spécifiez les types de données des colonnes d’entrée et/ou de sortie (données temporelles ou géographiques). La documentation complète se trouve sur https://docs.generic-mapping-tools.org/latest/gmt.html#f-full.

interpolation (str) - [b|c|l|n][+a][+bBC][+c][+tseuil]. Sélectionnez le mode d’interpolation pour les grilles. Vous pouvez sélectionner le type de spline utilisé :

b pour B-spline
c pour bicubique [Par défaut]
l pour bilinéaire
n pour plus proche voisin

perspective (list ou str) - [x|y|z]azim[/elev[/niveau_z]][+wlon0/lat0[/z0]][+vx0/y0]. Sélectionnez la vue en perspective et définissez l’azimut et l’angle d’élévation du point de vue [La valeur par défaut est [180, 90]]. La documentation complète se trouve sur https://docs.generic-mapping-tools.org/latest/gmt.html#perspective-full.

transparency (int ou float) - Définissez le niveau de transparence, dans la plage de pourcentage [0-100] [La valeur par défaut est 0, c’est-à-dire opaque]. Visible uniquement lorsque la sortie est au format PDF ou raster. Seule la sélection du format PNG ajoute une couche de transparence à l’image (pour un traitement ultérieur).

cores (bool ou int) - [[-]n]. Limitez le nombre de cœurs à utiliser dans les algorithmes multithread activés par OpenMP. Par défaut, nous essayons d’utiliser tous les cœurs disponibles. Définissez un nombre n pour n’utiliser que n cœurs (s’il est trop grand, il sera tronqué au nombre maximal de cœurs disponibles). Enfin, donnez un nombre négatif -n pour sélectionner (tous - n) cœurs (ou au moins 1 si n est égal ou supérieur à tous).