matplotlib._enums

Énumérations représentant des ensembles de chaînes que Matplotlib utilise comme paramètres d'entrée.

Matplotlib utilise souvent des types de données simples comme des chaînes ou des tuples pour définir un concept ; par exemple, le style de la ligne peut être spécifié comme 'butt', 'round' ou 'projecting'. Les classes de ce module sont utilisées en interne et servent à documenter formellement ces concepts.

En tant qu'utilisateur final, vous n'utiliserez pas ces classes directement, mais uniquement les valeurs qu'elles définissent.

classe matplotlib._enums. JoinStyle ( valeur )

Définissez comment la connexion entre deux segments de ligne est dessinée.

Pour une impression visuelle de chaque JoinStyle , ou run .view these docs onlineJoinStyle.demo

Les lignes dans Matplotlib sont généralement définies par un 1D Pathet un fini linewidth, où le 1D sous-jacent Pathreprésente le centre de la ligne tracée.

Par défaut, GraphicsContextBasedéfinit les limites d'une ligne tracée comme étant simplement chaque point dans un certain rayon, linewidth/2, loin de tout point de la ligne centrale. Cependant, cela se traduit par des coins apparaissant "arrondis", ce qui peut ne pas être le comportement souhaité si vous dessinez, par exemple, un polygone ou une étoile pointue.

Valeurs prises en charge :

'mitre'

le style "pointe de flèche". Chaque limite de la zone remplie s'étendra sur une ligne droite parallèle au vecteur tangent de la ligne centrale au point où elle rencontre le coin, jusqu'à ce qu'elles se rencontrent en un point aigu.

'tour'

attise chaque point dans un rayon des linewidth/2lignes médianes.

'biseau'

le style "au carré". Il peut être considéré comme un coin arrondi où la partie "circulaire" du coin a été coupée.

Noter

Les pointes d'onglet très longues sont coupées (pour former un biseau ) après une limite dépendante du backend appelée "limite d'onglet", qui spécifie le rapport maximal autorisé entre la longueur d'onglet et la largeur de ligne. Par exemple, le backend PDF utilise la valeur par défaut de 10 spécifiée par la norme PDF, tandis que le backend SVG ne spécifie même pas la limite d'onglet, ce qui donne une valeur par défaut de 4 selon la spécification SVG. Matplotlib ne permet pas actuellement à l'utilisateur d'ajuster ce paramètre.

Une description plus détaillée de l'effet d'une limite d'onglet peut être trouvée dans les Mozilla Developer Docs

( Code source , png )

démo statique ( )

Montrez à quoi ressemble chaque JoinStyle pour différents angles de jointure.

classe matplotlib._enums. CapStyle ( valeur )

Définissez comment les deux extrémités (bouchons) d'une ligne non fermée sont dessinées.

La façon de dessiner les points de départ et d'arrivée des lignes qui représentent une courbe fermée (c'est-à-dire qui se terminent par un CLOSEPOLY) est contrôlée par le JoinStyle. Pour toutes les autres lignes, la façon dont les points de début et de fin sont dessinés est contrôlée par CapStyle .

Pour une impression visuelle de chaque CapStyle , ou run .view these docs onlineCapStyle.demo

Par défaut, GraphicsContextBasedessine une ligne tracée au carré à ses extrémités.

Valeurs prises en charge :

'bout'

la ligne est quadrillée à son extrémité.

'en saillie'

la ligne est carrée comme dans butt , mais la zone remplie s'étend au-delà de l'extrémité sur une distance de linewidth/2.

'tour'

comme butt , mais un capuchon semi-circulaire est ajouté à la fin de la ligne, de rayon linewidth/2.

( Code source , png )

démo statique ( )

Montrez comment chaque CapStyle recherche un segment de ligne épaisse.