grd2cpt

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

pygmt.grd2cpt(grid, \*, transparency=None, cmap=None,background=None,
color_model=None, nlevels=None, truncate=None, output=None,
reverse=None, limit=None, overrule_bg=None, no_bg=None, log=None,
region=None, series=None, verbose=None, categorical=None,
cyclic=None, continuous=None, \**kwargs)

Utilité :

Créer des tables de couleurs GMT à partir d’un fichier de grille.

Cette fonction vous permet de générer des tables de couleurs statiques (CPT) à partir d’un fichier de grille. Par défaut, la CPT sera simplement enregistrée dans la session en cours, mais vous pouvez utiliser le paramètre output pour l’enregistrer dans un fichier. La CPT est basée sur une CPT maître dynamique existante de votre choix, et la correspondance entre les valeurs de données et les couleurs se fait à travers la fonction de distribution cumulative (CDF) des données. Ainsi, les couleurs sont égalisées selon l’histogramme. Si les grilles et la CPT résultante sont utilisées dans pygmt.Figure.grdimage avec une projection linéaire, les couleurs seront uniformément réparties sur le graphique. Soit z les valeurs de données dans la grille. On définit CDF(Z) = (nombre de z < Z) / (nombre de z dans la grille). (Les NaN sont ignorés). Ces valeurs z sont ensuite normalisées par rapport à la CPT maître et les couleurs sont échantillonnées à des intervalles souhaités.

La CPT comprend trois couleurs supplémentaires en dehors de la plage des valeurs z. Il s’agit de la couleur d’arrière-plan (B) assignée aux valeurs inférieures à la plus basse valeur z, de la couleur de premier plan (F) assignée aux valeurs supérieures à la plus haute valeur z, et de la couleur NaN (N) utilisée partout où les valeurs sont indéfinies. Pour des tables de couleurs personnalisées au-delà des offres standard GMT, vous pouvez visiter cpt-city et Scientific Colour-Maps.

Si la CPT maître comprend des entrées B, F et N, elles seront copiées dans le nouveau fichier maître. Sinon, les paramètres COLOR_BACKGROUND, COLOR_FOREGROUND et COLOR_NAN du fichier gmt.conf seront utilisés. Ce comportement par défaut peut être outrepassé en utilisant les paramètres background, overrule_bg ou no_bg.

Le modèle de couleur (RGB, HSV ou CMYK) de la palette créée par pygmt.grd2cpt sera identique à celui spécifié dans l’en-tête de la CPT maître. S’il n’y a pas d’entrée COLOR_MODEL dans la CPT maître, le COLOR_MODEL spécifié dans le fichier gmt.conf ou le paramètre color_model sera utilisé.

Paramètres :

grid (str ou xarray.DataArray) - Le nom du fichier de grille d’entrée ou la grille chargée en tant que DataArray.

transparency (int ou float ou str) - Définit un niveau constant de transparence (0-100) pour toutes les tranches de couleur. Ajoutez +a pour affecter également les couleurs d’avant-plan, d’arrière-plan et NaN [La valeur par défaut est une transparence nulle, c’est-à-dire 0 (opaque)].

cmap (str) - Sélectionne la table de couleurs (CPT) maître à utiliser pour l’interpolation. Une liste complète des tables de couleurs intégrées est disponible à l’adresse https://docs.generic-mapping-tools.org/latest/cookbook/cpts.html#built-in-color-palette-tables-cpt.

background (bool ou str) - Sélectionne les couleurs d’arrière-plan et de premier plan pour correspondre aux couleurs des valeurs z les plus basses et les plus élevées dans la CPT de sortie [Par défaut (background=True ou background= »o »), utilise les couleurs spécifiées dans le fichier maître ou celles définies par les paramètres COLOR_BACKGROUND, COLOR_FOREGROUND et COLOR_NAN]. Utilisez background= »i » pour correspondre aux couleurs des valeurs les plus basses et les plus élevées de l’entrée (au lieu de la sortie) CPT.

color_model - [R|r|h|c][+c[label]]. Force la CPT de sortie à être écrite avec les codes r/v/b, les valeurs d’échelle de gris ou le nom de couleur (R, par défaut), ou uniquement les codes r/v/b (r), ou les codes h/s/v (h), ou les codes c/m/j/n (c). En option ou en alternative, ajoutez +c pour écrire des palettes discrètes au format catégorique. Si un libellé est ajouté, nous créons des libellés pour chaque catégorie à utiliser lorsque la CPT est tracée. Le libellé peut être une liste de noms de catégorie séparés par des virgules (vous pouvez omettre une catégorie en ne donnant pas de nom) ou donnez start[-], où nous construisons automatiquement des libellés croissants à partir de start (une seule lettre ou un entier). Ajoutez - pour construire des plages start-start+1.

nlevels (bool ou int ou str) - Définissez sur True pour créer une table de couleurs linéaire en utilisant la plage z de la grille comme nouvelles limites dans la CPT. Sinon, définissez nlevels pour échantillonner la table de couleurs en tranches équidistantes nlevels.

series (list ou str) - [min/max/inc[+b|l|n]|file|list]. Définit la plage de la nouvelle CPT en spécifiant la valeur z la plus basse et la plus élevée (et éventuellement un intervalle). Si cela n’est pas spécifié, la plage existante dans la CPT maître sera utilisée intacte. Les valeurs produites définissent les limites des tranches de couleur. Si +n est utilisé, cela se réfère au nombre de ces limites et non au nombre de tranches. Pour plus de détails sur la création de tableaux, consultez https://docs.generic-mapping-tools.org/latest/makecpt.html#generate-1d-array.

truncate (list ou str) - zlo/zhi. Tronque la CPT d’entrée de manière à ce que les niveaux z les plus bas et les plus élevés correspondent à zlo et zhi. Si l’un de ces derniers est NaN, alors cette extrémité de la CPT est laissée intacte. La troncature a lieu avant toute rééchantillonnage. Voir aussi https://docs.generic-mapping-tools.org/latest/cookbook/features.html#manipulating-cpts.

output (str) - Paramètre facultatif pour définir le nom de fichier avec l’extension .cpt pour enregistrer le fichier CPT généré. Si non spécifié ou False [Par défaut], enregistre la CPT en tant que CPT de session actuelle.

reverse (str) - Définissez cette valeur sur True ou c [Par défaut] pour inverser le sens de progression des couleurs dans la CPT maître. Définissez cette valeur sur z pour inverser le signe des valeurs z dans la table de couleurs. Notez que ce changement de direction des valeurs z se produit avant l’utilisation des valeurs de troncature et de série, de sorte que ces dernières doivent être compatibles avec la plage modifiée de z. Voir aussi https://docs.generic-mapping-tools.org/latest/cookbook/features.html#manipulating-cpts.

overrule_bg (str) - Outrepasse les couleurs d’arrière-plan, de premier plan et NaN spécifiées dans la CPT maître avec les valeurs des paramètres COLOR_BACKGROUND, COLOR_FOREGROUND et COLOR_NAN spécifiés dans le fichier gmt.conf. Lorsqu’il est combiné avec background, seul COLOR_NAN est pris en compte.

no_bg (bool) - Ne pas écrire les champs de couleur d’arrière-plan, de premier plan et NaN [Par défaut, ils seront écrits, c’est-à-dire no_bg=False].

log (bool) - Pour le schéma d’interpolation logarithmique avec une entrée donnée sous forme de logarithmes. Attend les valeurs z d’entrée fournies via series pour être log10(z), attribue des couleurs et écrit les valeurs z.

continuous (bool) - Force une CPT continue lors de la création à partir d’une liste de couleurs et d’une liste de valeurs z [Par défaut, None, c’est-à-dire des valeurs discrètes].

categorical (bool) - N’effectue pas d’interpolation de la table de couleurs d’entrée, mais choisit les couleurs de sortie à partir du début de la table de couleurs, jusqu’à ce que les couleurs pour tous les intervalles soient attribuées. Cela est particulièrement utile en combinaison avec une table de couleurs catégorique, telle que cmap= »categorical ».

cyclic (bool) - Produit une table de couleurs enveloppante (cyclique) qui répète indéfiniment sa plage. Notez que cyclic=True ne peut pas être défini en même temps que categorical=True.

verbose (bool ou str) - Sélectionne 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, aucun message d’erreur fatal n’est produit

e - Messages d’erreur uniquement

w - Avertissements [Par défaut]

t - Chronométrages (indique les durées d’exécution des algorithmes intensifs en temps)

i - Messages informatifs (identique à verbose=True)

c - Avertissements de compatibilité

d - Messages de débogage