Figure.grdview

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

Figure.grdview(grid, \*, region=None, projection=None, zscale=None,
zsize=None, frame=None, cmap=None, drapegrid=None, plane=None,
surftype=None, contourpen=None, meshpen=None, facadepen=None,
shading=None, verbose=None, panel=None, coltypes=None,
interpolation=None, perspective=None, transparency=None, \**kwargs)

Utilité :

Crée une image ou un maillage en perspective 3D à partir d’une grille.

Lit un fichier de grille 2D et produit une représentation en perspective 3D en dessinant un maillage, en peignant une surface colorée ou en nuances de gris composée de polygones, ou en convertissant ces polygones en une image raster par scanline. Les options incluent le drapage d’un ensemble de données sur une surface, le tracé de contours sur la surface, et l’application d’une illumination artificielle basée sur des intensités fournies dans un fichier de grille distinct.

Paramètres :

grid (str ou xarray.DataArray) – Nom du fichier ou DataArray contenant la grille de relief en entrée.

region (str ou list) – xmin/xmax/ymin/ymax[+r][+uunit]. Spécifie la région d’intérêt. Lorsqu’il est utilisé avec la perspective, ajoutez éventuellement /zmin/zmax pour indiquer la plage à utiliser pour les axes 3D [Par défaut, utilise la région de la grille d’entrée].

projection (str) – projcode[projparams/]width. Sélectionne la projection cartographique.

zscale/zsize (float ou str) – Définit l’échelle de l’axe z ou la taille de l’axe z.

frame (bool, str ou list) – Définit les attributs de la bordure de la carte et des axes.

cmap (str) – Nom de la table de couleurs à utiliser.

drapegrid (str ou xarray.DataArray) – Nom du fichier ou DataArray de la grille d’image à draper sur le relief fourni par la grille. [Par défaut, détermine les couleurs à partir de la grille]. Notez que zscale et plane font toujours référence à la grille. La grille drapegrid ne fournit que les informations relatives aux couleurs, qui (si drapegrid est une grille) seront recherchées via la table de couleurs (voir cmap).

plane (float ou str) – level[+gfill]. Trace un plan à ce niveau z. Si la couleur facultative est fournie via le modificateur +g et que la projection n’est pas oblique, la façade frontale entre le plan et le périmètre des données est colorée.

surftype (str) – Spécifie le type de couverture de la grille. Sélectionnez l’une des options suivantes :

m - Tracé du maillage [Par défaut].

mx ou my - Tracés en cascade (profils de ligne ou de colonne).

s - Tracé de surface, et ajoutez éventuellement m pour dessiner des lignes de maillage par-dessus la surface.

i - Tracé d’image.

c - Identique à i mais rend les nœuds avec z = NaN transparents.

Pour l’une de ces options, vous pouvez forcer une image monochrome en ajoutant le modificateur +m.

contourpen (str) – Trace des lignes de contour par-dessus la surface ou le maillage (pas l’image). Ajoutez les attributs de style de trait utilisés pour les contours.

meshpen (str) – Définit les attributs de style de trait utilisés pour le maillage. Vous devez également sélectionner surftype m ou sm pour que les lignes de maillage soient dessinées.

facadepen (str) – Définit les attributs de style de trait utilisés pour la façade. Vous devez également sélectionner plane pour que le contour de la façade soit dessiné.

shading (str) – Fournit le nom d’un fichier de grille avec des intensités dans la plage (-1, +1), ou une intensité constante à appliquer partout (affecte la lumière ambiante). Vous pouvez également dériver une grille d’intensité à partir de la grille de reliefgrid des données d’entrée en appelant pygmt.grdgradient ; ajoutez +aazimuth, +nargs et + mambient pour spécifier les arguments d’azimut, d’intensité et d’ambiance pour cette fonction, ou donnez simplement +d pour sélectionner les arguments par défaut [Par défaut : +a-45+nt1+m0].

verbose (bool ou str) – Sélectionne le niveau de verbosité [Par défaut : w], qui module les messages écrits sur stderr. Choisissez parmi 7 niveaux de verbosité :

q - Silencieux, aucun message d’erreur fatal n’est produit

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 d’information (identique à verbose=True)

c - Avertissements de compatibilité

d - Messages de débogage

panel (bool, int ou list) – [row,col|index]. Sélectionne 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 row,col, vous pouvez également donner une valeur scalaire index qui dépend de l’ordre que vous avez défini via autolabel lorsque le sous-tracé a été défini. Note : row, col et index commencent tous à 0.

coltypes (str) – [i|o]colinfo. Spécifie 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 à l’adresse https://docs.generic-mapping-tools.org/latest/gmt.html#f-full.

interpolation (str) – [b|c|l|n][+a][+bBC][+c][+tthreshold]. Sélectionne le mode d’interpolation pour les grilles. Vous pouvez choisir 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[/zlevel]][+wlon0/lat0[/z0]][+vx0/y0]. Sélectionne la vue en perspective et définit l’azimut et l’angle d’élévation du point de vue [Par défaut : [180, 90]]. La documentation complète se trouve à l’adresse https://docs.generic-mapping-tools.org/latest/gmt.html#perspective-full.

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