makecpt

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

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

Utilité :

Créez des tables de couleurs GMT.

Il s’agit d’une fonction qui vous permet de créer des tables de couleurs statiques (CPT). Par défaut, la CPT est simplement enregistrée dans la session en cours, mais vous pouvez utiliser l’option « output » pour l’enregistrer dans un fichier. Vous pouvez définir un ensemble de contours équidistants ou utiliser votre propre tableau ou liste de valeurs z, puis créer une nouvelle CPT basée sur une CPT maître existante (dynamique). La CPT résultante peut être inversée par rapport à la CPT maître et peut être continue ou discrète. Pour des tables de couleurs autres que celles proposées par défaut dans GMT, visitez cpt-city et Scientific Colour-Maps.

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 petite valeur z, de la couleur de premier plan (F) assignée aux valeurs supérieures à la plus grande valeur z, et de la couleur NaN (N) utilisée là où les valeurs sont indéfinies.

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 contourné 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.makecpt sera identique à celui spécifié dans l’en-tête de la CPT maître. En l’absence d’une entrée COLOR_MODEL dans la CPT maître, le COLOR_MODEL spécifié dans le fichier gmt.conf sera utilisé.

Paramètres :

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

cmap (str) - Sélectionne la table de couleurs principale (CPT) à utiliser dans 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 principal 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 dans la CPT d’entrée (au lieu de la CPT de sortie).

color_model - [R|r|h|c][+c[label]]. Force la CPT de sortie à être écrite avec des codes r/g/b, des valeurs en niveaux de gris ou des noms de couleur (R, par défaut) ou uniquement des codes r/g/b (r), ou des codes h-s-v (h), ou des codes c/m/y/k (c). Optionnellement ou alternativement, ajoutez +c pour écrire des palettes discrètes au format catégoriel. Si un label est ajouté, nous créons des étiquettes pour chaque catégorie à utiliser lors du tracé de la CPT. Le label peut être une liste de noms de catégories séparés par des virgules (vous pouvez omettre une catégorie en ne donnant pas de nom) ou donner start[-], où nous construisons automatiquement des étiquettes croissantes à partir de start (une seule lettre ou un entier). Ajoutez - pour construire des plages start-start+1 à la place.

series (liste ou str) - [min/max/inc[+b|l|n]|file|list]. Définit la plage de la nouvelle CPT en donnant la valeur z la plus basse et la plus élevée (et éventuellement un intervalle). Si cela n’est pas donné, la plage existante dans la CPT principale 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 d’un tableau, voir https://docs.generic-mapping-tools.org/latest/makecpt.html#generate-1d-array.

truncate (liste ou str) - zlow/zhigh. Tronque la CPT d’entrée afin que les niveaux de z les plus bas et les plus élevés soient zlow et zhigh. Si l’une de ces valeurs est NaN, nous laissons cette extrémité de la CPT intacte. La troncature a lieu avant toute resampling. Voir aussi https://docs.generic-mapping-tools.org/latest/cookbook/features.html#manipulating-cpts.

output (str) - Optionnel. 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 actuelle de la session.

reverse (str) - Définissez cette valeur sur True ou c [Par défaut] pour inverser le sens de la progression des couleurs dans la CPT principale. 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 z se produit avant l’utilisation des valeurs de troncature et de la série, donc ces dernières doivent être compatibles avec la plage de z modifiée. Voir aussi https://docs.generic-mapping-tools.org/latest/cookbook/features.html#manipulating-cpts.

overrule_bg (str) - Remplacez les couleurs d’arrière-plan, de premier plan et NaN spécifiées dans la CPT principale par 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, seule COLOR_NAN est prise en compte.

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

log (bool) - Pour un schéma d’interpolation logarithmique avec des valeurs z d’entrée données sous forme de logarithmes. Attend des valeurs z d’entrée fournies via series comme étant log10(z), attribue des couleurs et écrit 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, il s’agit de valeurs discrètes].

verbose (bool ou str) - Sélectionnez 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 (rapport des temps d’exécution pour les algorithmes longs) i - Messages informatifs (identique à verbose=True) c - Avertissements de compatibilité d - Messages de débogage

categorical (bool) - Ne pas interpoler la table de couleurs d’entrée, mais choisir les couleurs de sortie à partir du début de la table de couleurs, jusqu’à ce que les couleurs pour toutes les intervalles soient assignées. Cela est particulièrement utile en combinaison avec une table de couleurs catégorielle, comme cmap= »categorical ».

cyclic (bool) - Produire 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.