Figure.colorbar

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

Figure.colorbar(\*, frame=None, cmap=None, position=None, box=None,
truncate=None, shading=None, projection=None, equalsize=None,
region=None, verbose=None, scale=None, zfile=None, panel=None,
perspective=None, transparency=None, \**kwargs)

Utilité :

Afficher des barres de couleur sur les figures.

Les barres de couleur peuvent être placées horizontalement ou verticalement. Pour les tableaux de couleurs avec des couleurs graduelles (c’est-à-dire lorsque les limites inférieure et supérieure d’un intervalle ont des couleurs différentes), nous allons interpoler pour obtenir une échelle continue.

Les variations d’intensité dues à l’ombrage ou à l’illumination peuvent être affichées en définissant le paramètre de l’ombrage. Les couleurs peuvent être espacées selon une échelle linéaire, toutes de taille égale, ou en fournissant un fichier avec des largeurs de tuile individuelles.

Paramètres :

frame (str ou list) - Définit les attributs du cadre des limites, des étiquettes et des axes de la barre de couleur.

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

position (str) - [g|j|J|n|x]refpoint[+wlongueur[/largeur]][+e[b|f][longueur]][+h|v][+jjustification][+m[a|c|l| u]][+n[txt]][+odx[/dy]]. Définit le point de référence sur la carte pour l’échelle de couleur en utilisant l’un des quatre systèmes de coordonnées : (1) Utilisez g pour les coordonnées de la carte (utilisateur), (2) utilisez j ou J pour définir le point de référence via un code de justification à 2 caractères qui se réfère au rectangle de domaine de carte (invisible), (3) utilisez n pour des coordonnées normalisées (0-1), ou (4) utilisez x pour les coordonnées du graphique (pouces, cm, etc.). Sauf x, les régions et projections doivent être spécifiées. Ajoutez +w suivi de la longueur et de la largeur de la barre de couleur. Si la largeur n’est pas spécifiée, elle est définie à 4% de la longueur donnée. Utilisez une longueur négative pour inverser la barre d’échelle. Ajoutez +h pour obtenir une échelle horizontale [par défaut, verticale (+v)]. Par défaut, le point d’ancrage sur l’échelle est supposé être le coin inférieur gauche (BL), mais cela peut être modifié en ajoutant +j suivi d’un code de justification à 2 caractères.

box (bool ou str) - [+cclearances][+gfill][+i[[espacement/]stylo]][+p[stylo]][+r[rayon]][+s[[dx/dy/][ombrage]]]. Si défini sur True, trace une bordure rectangulaire autour de l’échelle de couleur. Vous pouvez également spécifier un autre stylo avec +ppen. Ajoutez +gfill pour remplir le panneau de l’échelle [par défaut, pas de remplissage]. Ajoutez +cclearance où l’espace libre est gap, xgap/ygap ou lgap/rgap/bgap/tgap, où ces éléments sont des espacements uniformes, séparés dans les directions x et y, ou des espacements individuels entre l’échelle et la bordure. Ajoutez +i pour tracer une bordure intérieure secondaire également. Nous utilisons un espacement uniforme entre les bordures de 2p et le stylo MAP_DEFAULTS_PEN, sauf si d’autres valeurs sont spécifiées. Ajoutez +r pour tracer des bordures rectangulaires arrondies, avec un rayon de coin de 6p. Vous pouvez remplacer ce rayon en ajoutant une autre valeur. Enfin, ajoutez +s pour dessiner une région d’arrière-plan décalée. Ici, dx/dy indique le décalage par rapport au cadre avant-plan [4p/-4p] et shade définit le style de remplissage à utiliser pour l’ombrage [par défaut, « gray50 »].

truncate (list ou str) - zlo/zhi. Tronque le CPT entrant afin que les niveaux z les plus bas et les plus élevés soient respectivement zlo et zhi. Si l’un de ces éléments est NaN, alors cette extrémité du CPT est laissée intacte. La troncature a lieu avant le tracé.

scale (float) - Multiplie toutes les valeurs z du CPT par l’échelle fournie. Par défaut, le CPT est utilisé tel quel.

shading (str, list ou bool) - Ajoute des effets d’illumination. Passer une seule valeur numérique définit la plage d’intensités de -valeur à +valeur. Si non spécifié, la valeur 1 est utilisée. Alternativement, définissez shading=[faible, élevé] pour spécifier une plage d’intensité asymétrique de faible à élevé. [Par défaut, pas d’illumination].

equalsize (int, float ou str) - [i][espacement]. Rectangles de couleur de taille égale. Par défaut, les rectangles sont ajustés en fonction de la plage z dans le CPT (voir aussi zfile). Si espacement est ajouté et que le CPT est discret, chaque annotation est centrée sur chaque rectangle, en utilisant la valeur de limite inférieure z pour l’annotation. Si i est ajouté, la plage d’intervalle est annotée à la place. Si shading est utilisé, chaque rectangle aura sa couleur constante modifiée par l’intensité spécifiée.

zfile (str) - Fichier avec la largeur de la barre de couleur pour chaque entrée de couleur. Par défaut, la largeur de l’entrée est ajustée à la plage de couleurs, c’est-à-dire que z = 0-100 donne une largeur deux fois plus grande que z = 100-150 (voir aussi equalsize). Remarque : les largeurs peuvent être en unités de distance de graphique ou données sous forme de fractions relatives, et elles seront automatiquement ajustées de manière à ce que la somme des largeurs corresponde à la longueur de la barre de couleur demandée.

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 (indique les temps d’exécution des algorithmes gourmands en temps)

i - Messages informatifs (identique à verbose=True)

c - Avertissements de compatibilité

d - Messages de débogage

panel (bool, int ou list) - [ligne, colonne | index]. Sélectionne un panneau de sous-tracé spécifique. Uniquement autorisé en mode subplot. 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 index qui dépend de l’ordre que vous avez défini via autolabel lorsque le subplot a été défini. Remarque : ligne, colonne et index commencent tous à 0.

perspective (list ou str) - [x|y|z]azim[/elev[/zlevel]][+wlon0/lat0[/z0]][+vx0/y0]. Sélectionne la vue en perspective et définis l’angle d’azimut et d’élévation du point de vue [par défaut, [180, 90]].

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 PDF ou raster. Seule la sélection du format PNG ajoute une couche de transparence à l’image (pour un traitement ultérieur).