pygmt.Figure.histogram¶
Figure.histogram(data, *, horizontal=None, frame=None, cmap=None,
annotate=None, barwidth=None, center=None, fill=None, projection=None,
extreme=None, distribution=None, cumulative=None, region=None,
stairs=None, series=None, verbose=None, pen=None, histtype=None,
binary=None, panel=None, nodata=None, find=None, header=None,
incols=None, label=None, perspective=None, transparency=None,
wrap=None, **kwargs)
Paramètre¶
data ( str ou list ou numpy.ndarray ou pandas.DataFrame ou xarray.Dataset ou geopandas.GeoDataFrame ) – Transmettez soit un nom de fichier à une table de données ASCII, une liste Python, un 2-D numpy.ndarray, un pandas.DataFrame, un xarray.Dataset composé de Variables de données 1D xarray.DataArray ou a geopandas.GeoDataFrame contenant les données tabulaires.
projection ( str ) – Sélectionnez la projection cartographique .
region ( chaîne ou liste ) – xmin/xmax/ymin/ymax [ +r ][ +u unité ]. Spécifiez la région d’intérêt.
frame ( bool ou str ou list ) – Définit le cadre de délimitation de la carte et les attributs des axes .
cmap ( str ) – Nom de fichier d’un fichier CPT ou d’une série de couleurs séparées par des virgules (par exemple, color1 , color2 , color3 ) pour créer automatiquement un CPT linéaire continu à partir de ces couleurs.
fill ( str ) – Définit la couleur ou le motif des barres de remplissage [par défaut, pas de remplissage].
pen ( str ) – Définissez les attributs du stylo pour les lignes ou le contour des symboles.
panel ( bool ou int ou list ) – [ row,col | indice ]. Sélectionnez un panneau de sous-parcelle spécifique. Autorisé uniquement en mode sous-parcelle. Utilisez panel=True pour passer au panneau suivant dans l’ordre sélectionné. Au lieu de row,col, vous pouvez également donner un index de valeur scalaire qui dépend de l’ordre que vous autolabel avez défini lors de la définition de la sous-parcelle. Remarque : row , col et index commencent tous à 0.
annotate ( bool ou str ) – [ +b ][ +f font ][ +o off ][ +r ]. Annotez chaque barre avec le nombre qu’elle représente. Ajoutez l’un des modificateurs suivants : utilisez +b pour placer les étiquettes sous les barres plutôt qu’au-dessus ; utilisez +f pour passer à une autre police que la police d’annotation par défaut ; utilisez +o pour modifier le décalage entre la barre et l’étiquette [la valeur par défaut est « 6p »] ; utilisez +r pour faire pivoter les étiquettes de l’horizontale à la verticale.
barwidth ( int ou float ou str ) – width [ +o offset ]. Utilisez une autre largeur de barre d’histogramme que celle définie par défaut via series, et éventuellement décalez toutes les barres d’un décalage . Ici, width est soit une largeur alternative en unités de données, soit l’utilisateur peut ajouter une unité de dimension de tracé valide ( c | i | p ) pour une dimension fixe à la place. En option, tous les bacs peuvent être décalés le long de l’axe par décalage . Quant à la largeur , elle peut être donnée en unités de données d’unités de dimension de parcelle en ajoutant l’unité appropriée.
center ( bool ) – Centre bin sur chaque valeur. [La valeur par défaut est le bord gauche].
- distribution ( bool ou int ou float ou str ) – [ mode ][ +p pen]. Dessinez la distribution normale équivalente ; ajouter le stylet souhaité [la valeur par défaut est « 0.25p,black,solid »]. Le mode sélectionne l’emplacement central et l’échelle à utiliser :
0 = moyenne et écart type [par défaut] ;
1 = médiane et échelle L1 (1,4826 * écart absolu médian ; MAD) ;
2 = mode et échelle LMS (moins médian des carrés).
cumulative ( bool ou str ) – [ r ]. Dessinez un histogramme cumulatif en passant True. Utilisez r pour afficher un histogramme cumulatif inverse.
extreme ( str ) – l | h | b . Les modificateurs spécifient le traitement des valeurs extrêmes qui se situent en dehors de la plage définie par series. Par défaut, ces valeurs sont ignorées. Ajoutez b pour que ces valeurs soient incluses dans le premier ou le dernier bac. Pour inclure uniquement les valeurs extrêmes en dessous du premier bac dans le premier bac, utilisez l , et pour inclure uniquement les valeurs extrêmes au-dessus du dernier bac dans ce dernier bac, utilisez h.
stairs ( bool ) – Dessine un diagramme en escalier qui n’inclut pas les barres internes de l’histogramme par défaut.
horizontal ( bool ) – Tracez l’histogramme en utilisant des barres horizontales au lieu des barres verticales par défaut.
series ( int ou str ou list ) – [ min / max /] inc [ +n ]. Définissez l’intervalle pour la largeur de chaque barre dans l’histogramme.
- histtype ( int ou str ) – [ taper ][ +w ]. Choisissez entre 6 types d’histogrammes :
0 = compte [par défaut]
1 = fréquence_pourcentage
2 = journal (1,0 + compte)
3 = log (1,0 + fréquence_pourcentage)
4 = log10 (1,0 + comptage)
5 = log10 (1,0 + fréquence_pourcent).
Pour utiliser les pondérations fournies en tant que deuxième colonne de données au lieu de comptages purs, ajoutez +w .
- 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 - Des messages d’erreur silencieux, même fatals, ne sont pas générés
e - Messages d’erreur uniquement
w - Avertissements [par défaut]
t - Timings (temps d’exécution des rapports pour les algorithmes chronophages)
i - Messages d’information (comme verbose=True)
c - Avertissements de compatibilité
d - Messages de débogage
- binary ( bool ou str ) – i| o [ ncols ][ type ][ w ][ +l | b ]. Sélectionnez l’entrée binaire native (en utilisant binary= »i ») ou la sortie (en utilisant binary= »o »), où ncols est le nombre de colonnes de données de type , qui doit être l’une des suivantes :
c - int8_t (caractère signé 1 octet)
u - uint8_t (caractère non signé de 1 octet)
h - int16_t (entier signé sur 2 octets)
H - uint16_t (entier non signé sur 2 octets)
i - int32_t (entier signé sur 4 octets)
I - uint32_t (entier non signé de 4 octets)
l - int64_t (entier signé sur 8 octets)
L - uint64_t (entier non signé de 8 octets)
f - Flottant simple précision de 4 octets
d - Flottant double précision de 8 octets
x - utilisé pour ignorer les ncols n’importe où dans l’enregistrement
Pour les enregistrements avec des types mixtes, ajoutez des combinaisons supplémentaires séparées par des virgules de type ncols (sans espace). Les modificateurs suivants sont pris en charge :
w après n’importe quel élément pour forcer l’échange d’octets.
+l | b pour indiquer que l’ensemble du fichier de données doit être lu respectivement en petit ou gros boutien.
nodata ( str ) – a | o aucune donnée . Remplacez les valeurs spécifiques par NaN (pour les données tabulaires). Par exemple, nodata= »-9999 » remplacera toutes les valeurs égales à -9999 par NaN lors de l’entrée et toutes les valeurs NaN par -9999 lors de la sortie. Ajoutez i à la valeur nodata pour les colonnes d’entrée uniquement. Ajoutez o à la valeur nodata pour les colonnes de sortie uniquement.
find ( chaîne ) – [ ~ ] « motif » | [ ~ ]/ expression régulière /[ i ]. Ne transmettez que les enregistrements qui correspondent au modèle ou aux expressions régulières donnés [par défaut, traite tous les enregistrements]. Ajoutez ~ au motif ou à l’expression régulière pour ne transmettre que les expressions de données qui ne correspondent pas au motif. Ajoutez i pour une correspondance insensible à la casse. Cela ne s’applique pas aux en-têtes ou aux en-têtes de segment.
- header (str) – [i|o][n][+c][+d][+msegheader][+rremark][+ttitle]. Spécifiez que les fichiers d’entrée et/ou de sortie ont n enregistrements d’en-tête [la valeur par défaut est 0]. Préfixez i si seule l’entrée principale doit avoir des enregistrements d’en-tête. Préfixez o pour contrôler l’écriture des enregistrements d’en-tête, avec les modificateurs suivants pris en charge :
+d pour supprimer les enregistrements d’en-tête existants.
+c pour ajouter un commentaire d’en-tête avec des noms de colonne à la sortie [par défaut, aucun nom de colonne].
+m pour ajouter un en-tête de segment segheader à la sortie après le bloc d’en-tête [par défaut, pas d’en-tête de segment].
+r pour ajouter un commentaire de remarque à la sortie [par défaut, aucun commentaire]. La chaîne de remarque peut contenir n pour indiquer des sauts de ligne.
+t pour ajouter un commentaire de titre à la sortie [par défaut, pas de titre]. La chaîne de titre peut contenir n pour indiquer des sauts de ligne.
- incols ( str ou tableau 1-D ) – Spécifiez les colonnes de données pour l’entrée principale dans un ordre arbitraire. Les colonnes peuvent être répétées et les colonnes non répertoriées seront ignorées [par défaut, toutes les colonnes sont lues dans l’ordre, en commençant par la première (c’est-à-dire la colonne 0)].
Pour un tableau 1-D : spécifiez les colonnes individuelles dans l’ordre d’entrée (par exemple, incols=[1,0] pour la 2ème colonne suivie de la 1ère colonne).
- Pour str: spécifiez des colonnes individuelles ou des plages de colonnes au format start [: inc ]: stop , où inc prend par défaut la valeur 1 s’il n’est pas spécifié, avec des colonnes et/ou des plages de colonnes séparées par des virgules (par exemple, incols= »0:2,4+l » pour saisir les trois premières colonnes suivies du 5e colonne transformée en log). Pour lire à partir d’une colonne donnée jusqu’à la fin de l’enregistrement, laissez off stop lors de la spécification de la plage de colonnes. Pour lire le texte de fin, ajoutez la colonne t . Ajoutez le numéro de mot à t pour ingérer un seul mot du texte de fin. Au lieu de spécifier des colonnes, utilisez incols= »n » pour lire simplement l’entrée numérique et ignorer le texte de fin. Ajoutez éventuellement l’un des modificateurs suivants à n’importe quelle colonne ou plage de colonnes pour transformer les colonnes d’entrée :
+l pour prendre le log10 des valeurs d’entrée.
+d pour diviser les valeurs d’entrée par le facteur diviseur [la valeur par défaut est 1].
+s pour multiplier les valeurs d’entrée par l” échelle des facteurs [la valeur par défaut est 1].
+o pour ajouter le décalage donné aux valeurs d’entrée [la valeur par défaut est 0].
label ( str ) – Ajoutez une entrée de légende pour le symbole ou la ligne en cours de tracé.
perspective ( liste ou chaîne ) – [ x | y | z ] azim [/ elev [/ zlevel ]][ +w lon0 / lat0 [/ z0 ]][ +v x0 / 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]].
transparency ( int ou float ) – Définissez le niveau de transparence, dans la plage [0-100] pour cent [la valeur par défaut est 0, c’est-à-dire opaque]. Uniquement visible lorsque la sortie au format PDF ou raster est sélectionnée. Seule la sélection du format PNG ajoute une couche de transparence dans l’image (pour un traitement ultérieur).
- envelopper ( str ) – y | un | w | d | h | m | s | c période [/ phase ][ +c col ]. Convertissez la coordonnée x d’entrée en une coordonnée cyclique, ou une colonne différente si elle est sélectionnée via +c col . Les transformations de coordonnées cycliques suivantes sont prises en charge :
y - cycle annuel (normalisé)
a - cycle annuel (mensuel)
w - cycle hebdomadaire (jour)
d - cycle quotidien (heure)
h - cycle horaire (minute)
m - cycle minute (seconde)
s - deuxième cycle (seconde)
Exemple¶
import numpy as np
import pygmt
np.random.seed(100)
# Generate random elevation data from a normal distribution
mean = 100 # mean of distribution
stddev = 25 # standard deviation of distribution
data = mean + stddev * np.random.randn(521)
fig = pygmt.Figure()
fig.histogram(
data=data,
# Define the frame, add a title, and set the background color to
# "lightgray". Add labels to the x-axis and y-axis
frame=["WSne+tHistogram+glightgray", "x+lElevation (m)", "y+lCounts"],
# Generate evenly spaced bins by increments of 5
series=5,
# Use "red3" as color fill for the bars
fill="red3",
# Use the pen parameter to draw the outlines with a width of 1 point
pen="1p",
# Choose histogram type 0, i.e., counts [Default]
histtype=0,
)
fig.show()