matplotlib.quiver.Barbs

clase matplotlib.quiver. Barbs ( ax , * args , pivot = 'tip' , length = 7 , barbcolor = Ninguno , flagcolor = Ninguno , tamaños = Ninguno , fill_empty = False , barb_increments = None , rounding = True , flip_barb = False , ** kwargs )

Bases:PolyCollection

PolyCollection especializado para púas.

El único método API es set_UVC(), que se puede usar para cambiar el tamaño, la orientación y el color de las flechas. Las ubicaciones se cambian utilizando el set_offsets()método de recopilación. Posiblemente este método sea útil en animaciones.

Hay una función interna _find_tails()que encuentra exactamente lo que se debe poner en la lengüeta dada la magnitud del vector. A partir de ahí _make_barbs()se utiliza para encontrar los vértices del polígono para representar la lengüeta en base a esta información.

El constructor toma un argumento obligatorio, una instancia de Axes, seguido de los args y kwargs descritos en la siguiente documentación de la interfaz de pyplot:

Trace un campo 2D de púas.

Firma de llamada:

barbs([X, Y], U, V, [C], **kwargs)

Donde X , Y definen las ubicaciones de las púas, U , V definen las direcciones de las púas y C opcionalmente establece el color.

Todos los argumentos pueden ser 1D o 2D. U , V , C pueden ser matrices enmascaradas, pero las X e Y enmascaradas no se admiten en la actualidad.

Las púas se usan tradicionalmente en meteorología como una forma de trazar la velocidad y la dirección de las observaciones del viento, pero técnicamente se pueden usar para trazar cualquier cantidad vectorial bidimensional. A diferencia de las flechas, que dan la magnitud del vector por la longitud de la flecha, las púas brindan información más cuantitativa sobre la magnitud del vector al colocar líneas inclinadas o un triángulo para varios incrementos de magnitud, como se muestra esquemáticamente a continuación:

:                   /\    \
:                  /  \    \
:                 /    \    \    \
:                /      \    \    \
:               ------------------------------

El mayor incremento viene dado por un triángulo (o "bandera"). Después de esos vienen líneas completas (púas). El incremento más pequeño es media línea. Por supuesto, solo hay como máximo 1 media línea. Si la magnitud es pequeña y solo necesita una sola media línea y no líneas completas ni triángulos, la media línea se desplaza desde el final de la lengüeta para que pueda distinguirse fácilmente de las lengüetas con una sola línea completa. La magnitud de la lengüeta que se muestra arriba sería nominalmente 65, utilizando los incrementos estándar de 50, 10 y 5.

Consulte también https://en.wikipedia.org/wiki/Wind_barb .

Parámetros :

X, Y tipo matriz 1D o 2D, opcional

Las coordenadas x e y de las ubicaciones de las púas. Vea el pivote para ver cómo se dibujan las púas en las posiciones x, y.

Si no se proporcionan, se generarán como una malla de enteros uniforme basada en las dimensiones de U y V .

Si X e Y son 1D pero U , V son 2D, X , Y se expanden a 2D usando . En este caso , y debe coincidir con las dimensiones de columna y fila de U y V.X, Y = np.meshgrid(X, Y)len(X)len(Y)

U, V 1D o 2D tipo matriz

Los componentes x e y del eje dentado.

C 1D o 2D tipo matriz, opcional

Datos numéricos que definen los colores de las púas mediante el mapeo de colores a través de norm y cmap .

Esto no admite colores explícitos. Si desea establecer los colores directamente, utilice barbcolor en su lugar.

flotante de longitud , por defecto: 7

Longitud de la púa en puntos; las otras partes de la púa están escaladas contra esto.

pivotar {'tip', 'middle'} o float, por defecto: 'tip'

La parte de la flecha que está anclada a la cuadrícula X , Y. La lengüeta gira sobre este punto. Esto también puede ser un número, que desplaza el inicio de la lengüeta muchos puntos lejos del punto de cuadrícula.

color de púas o secuencia de colores

El color de todas las partes de la púa a excepción de las banderas. Este parámetro es análogo al parámetro edgecolor para polígonos, que se puede usar en su lugar. Sin embargo, este parámetro anulará el color de la cara.

color de la bandera color o secuencia de colores

El color de las banderas en la lengüeta. Este parámetro es análogo al parámetro facecolor para polígonos, que se puede usar en su lugar. Sin embargo, este parámetro anulará el color de la cara. Si esto no está configurado (y C tampoco), entonces el color de la bandera se configurará para que coincida con el color de la lengüeta para que la lengüeta tenga un color uniforme. Si se ha configurado C , flagcolor no tiene efecto.

dictado de tamaños , opcional

Un diccionario de coeficientes que especifica la relación de una característica determinada con la longitud de la lengüeta. Solo se deben incluir aquellos valores que uno desea anular. Estas características incluyen:

• 'espaciado' - espacio entre características (banderas, púas completas/medias)

• 'altura' - altura (distancia desde el eje hasta la parte superior) de una bandera o lengüeta completa

• 'ancho' - ancho de una bandera, el doble del ancho de una púa completa

• 'emptybarb' - radio del círculo utilizado para magnitudes bajas

fill_empty booleano , predeterminado: Falso

Si las púas vacías (círculos) que se dibujan deben rellenarse con el color de la bandera. Si no están llenos, el centro es transparente.

booleano de redondeo , predeterminado: verdadero

Si la magnitud del vector debe redondearse al asignar componentes de púas. Si es Verdadero, la magnitud se redondea al múltiplo más cercano del incremento de media lengüeta. Si es False, la magnitud simplemente se trunca al siguiente múltiplo más bajo.

dictamen barb_increments , opcional

Un diccionario de incrementos que especifica valores para asociar con diferentes partes de la púa. Solo se deben incluir aquellos valores que uno desea anular.

• 'mitad' - mitad de púas (el valor predeterminado es 5)

• 'full' - púas completas (el valor predeterminado es 10)

• 'bandera' - banderas (el valor predeterminado es 50)

flip_barb bool o similar a una matriz de bool, por defecto: Falso

Si las líneas y las banderas deben apuntar en dirección contraria a la normal. El comportamiento normal es que las púas y las líneas apunten hacia la derecha (proviene de púas de viento que tienen estas características que apuntan hacia la baja presión en el hemisferio norte).

Se aplica un único valor a todas las púas. Las púas individuales se pueden voltear pasando una matriz bool del mismo tamaño que U y V .

Devoluciones :

púasBarbs

Otros parámetros :

objeto indexable de datos , opcional

DATA_PARAMETER_PLACEHOLDER

**kwargs

Las púas se pueden personalizar aún más usando PolyCollectionargumentos de palabras clave:

Propiedad	Descripción
agg_filter	una función de filtro, que toma una matriz flotante (m, n, 3) y un valor de ppp, y devuelve una matriz (m, n, 3) y dos compensaciones desde la esquina inferior izquierda de la imagen
alpha	tipo matriz o escalar o ninguno
animated	bool
antialiasedo aa o suavizado	bool o lista de bools
array	tipo matriz o ninguno
capstyle	CapStyleo {'trasero', 'proyectando', 'redondo'}
clim	(vmin: flotante, vmax: flotante)
clip_box	Bbox
clip_on	bool
clip_path	Parchear o (Ruta, Transformar) o Ninguno
cmap	Colormapo str o Ninguno
color	color o lista de tuplas rgba
edgecoloro ec o edgecolors	color o lista de colores o 'cara'
facecoloro colores de cara o fc	color o lista de colores
figure	Figure
gid	calle
hatch	{'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'}
in_layout	bool
joinstyle	JoinStyleo {'inglete', 'redondo', 'bisel'}
label	objeto
linestyleo guiones o estilos de línea o ls	str o tuple o lista de los mismos
linewidtho anchos de línea o lw	flotador o lista de flotadores
mouseover	bool
norm	Normalizeo str o Ninguno
offset_transformo transOffset	desconocido
offsets	(N, 2) o (2,) en forma de matriz
path_effects	AbstractPathEffect
paths	lista de tipo matriz
picker	Ninguno o bool o flotante o invocable
pickradius	desconocido
rasterized	bool
sizes	ndarray o Ninguno
sketch_params	(escala: flotante, longitud: flotante, aleatoriedad: flotante)
snap	booleano o ninguno
transform	Transform
url	calle
urls	lista de str o Ninguno
verts	lista de tipo matriz
verts_and_codes	desconocido
visible	bool
zorder	flotar

barbs_doc = '\nTrazar un campo 2D de púas.\n\nIdentificación de llamada ::\n\n púas([X, Y], U, V, [C], **kwargs)\n\nDonde *X*, *Y* define las ubicaciones de las púas, * U*, *V* define las direcciones de las púas y *C* opcionalmente establece el color.\n\nTodos los argumentos pueden ser 1D o 2D. *U*, *V*, *C* pueden ser matrices enmascaradas , pero   enmascarado\n*X*, *Y* no son compatibles actualmente .\n\nLas púas se usan tradicionalmente en meteorología como una forma de trazar la velocidad\ny la dirección de las observaciones del viento , pero técnicamente se pueden usar para \ntrazar cualquier bidimensional cantidad vectorial . A diferencia de las flechas, que dan la magnitud del vector por la longitud del   flecha, las púas brindan más\ninformación cuantitativa sobre la magnitud del vector al colocar líneas\ninclinadas o un triángulo para varios incrementos en magnitud, como se muestra\nesquemáticamente a continuación::\n\n : /\\ \\\n : / \\ \\\n : / \\ \\ \\\n : / \\ \\ \\\n : ------------------------- -----\n\nEl mayor incremento es                                                                                                                                    dada por un triángulo (o "bandera"). Después de esas\nvienen líneas completas (púas). El incremento más pequeño es media línea . Hay sólo, por supuesto, como máximo 1 media línea . Si la magnitud es\npequeña y solo necesita una sola media línea y no líneas completas o\ntriángulos, la media línea se compensa     desde el final de la lengüeta para que \nse pueda distinguir fácilmente de las lengüetas con una sola línea completa . La\nmagnitud de la lengüeta que se muestra arriba sería nominalmente 65, usando los\nincrementos estándar de 50, 10 y 5.\n\nConsulte también https ://en.wikipedia.org/wiki/Wind_barb.\n\nParámetros\ n----------\nX, Y : 1D o 2D   tipo matriz, opcional\n     Las coordenadas x e y de las ubicaciones de las lengüetas . Consulte *pivote* para ver cómo se dibujan las\n púas en las posiciones x, y .\n\n Si no se proporcionan, se generarán como una malla de enteros uniforme basada \ n en las dimensiones de * U * y *V* .\n\n Si *X* e *Y* son                 1D pero *U*, *V* son 2D, *X*, *Y* se expanden a 2D\n     usando ``X, Y = np.meshgrid(X, Y)``. En este caso ``len(X)`` y ``len(Y)``\n     deben coincidir con las dimensiones de columna y fila de *U* y *V*.\n\nU, V : matriz 1D o 2D- like\n Los componentes x e y de la lengüeta     eje.\n\nC : tipo matriz 1D o 2D , opcional\n Datos numéricos que definen los colores de las púas mediante asignación de colores a través de *norma* y\n *cmap*.\n\n Esto no admite colores explícitos . Si desea establecer colores directamente ,\n use *barbcolor* en su lugar.\n\nlongitud : flotante, predeterminado: 7\n Longitud de la lengüeta en puntos;                     las otras partes de la púa\n     se escalan contra esto.\n\npivot : {\'tip\', \'middle\'} o float, por defecto: \'tip\'\n     La parte de la flecha que es anclado a la cuadrícula *X*, *Y* . La lengüeta\n gira alrededor de este punto. Esto también puede ser un número, que desplaza el\n inicio de la         lengüeta que está a muchos puntos del punto de cuadrícula .\n\nbarbcolor : color o secuencia de colores\n El color de todas las partes de la lengüeta excepto las banderas . Este parámetro\n es análogo al parámetro *edgecolor* para polígonos , que se puede usar\n en su lugar. Sin embargo , este parámetro anulará el color de la cara.\n\ncolor de la bandera              : color o secuencia de colores\n El color de cualquier bandera en la púa . Este parámetro es análogo al parámetro \n *facecolor* para polígonos , que se puede usar en su lugar. Sin embargo,\n este parámetro anulará el color de la cara. Si esto no está configurado (y *C* tampoco tiene\n ) , entonces *flagcolor *                    establecerse para que coincida con *barbcolor* para que la\n lengüeta tenga un color uniforme . Si se ha configurado *C* , *flagcolor* no tiene ningún efecto.\n\nsizes : dict, Optional \n Un diccionario de coeficientes que especifica la proporción de una característica dada\n con la longitud de la púa . Solo aquellos valores que uno desea \n                 Se debe incluir la anulación . Estas características incluyen:\n\n - \'espaciado\' : espacio entre características (banderas, lengüetas completas/medias )\n - \'altura\' - altura (distancia desde el eje hasta la parte superior) de una bandera o lengüeta completa \ n - \'width\' - ancho de una bandera, el doble del ancho de una lengüeta completa \n - \'emptybarb\'                   - radio del círculo utilizado para magnitudes bajas \n\nfill_empty : bool , predeterminado: False\n Si las púas vacías (círculos) que se dibujan deben rellenarse \n con el color de la bandera . Si no están llenos, el centro es transparente . \ n\nredondeo : booleano , predeterminado: Verdadero\n Si la magnitud del vector debe               redondearse al asignar componentes de lengüeta\n . Si es Verdadero, la magnitud se redondea al múltiplo\n más cercano del incremento de media lengüeta . Si es Falso, la magnitud simplemente se trunca\n al siguiente múltiplo más bajo .\n\nbarb_increments : dict, opcional\n Un diccionario de incrementos que especifica valores para asociar con\n                         diferentes partes de la púa. Solo se deben incluir los valores que uno desea \n     anular .\n\n - \'half\' - medias púas (el valor predeterminado es 5)\n - \'full\' - púas completas (el valor predeterminado es 10)\n - \'bandera\' - banderas (el valor predeterminado es 50)\n\nflip_barb : bool o similar a una matriz de bool, predeterminado: Falso\n Si                 las líneas y las banderas deben apuntar de forma opuesta a lo normal.\n El     comportamiento normal es que las púas y las líneas apunten a la derecha (proviene de púas \n de viento que tienen estas características que apuntan hacia la baja presión en el \n hemisferio norte).\n\n A se aplica un solo valor a todas las púas. Las púas individuales pueden ser             invertido \n     pasando una matriz booleana del mismo tamaño que *U* y *V*.\n\nDevuelve\n-------\nbarbs : ` ~matplotlib.quiver.Barbs`\n\nOtros parámetros \n----------------\ndatos : objeto indexable , opcional\n DATA_PARAMETER_PLACEHOLDER\n\n**kwargs\n Las púas se pueden personalizar aún más usando la palabra clave `.PolyCollection` \ n argumentos:\n\n \n .. table::\n :class: property-table\n\n                                   ================================================== ==================================================    _ ================================================== ================================================== ================================================== =====\n        Descripción de la propiedad                                                                                             \n ====================================== ================================================== ======== ========================================== ================================================== ================================================== ================\n :meth:`agg_filter <matplotlib.artist.Artist.set_agg_filter>` una función de filtro , que toma un (m, n,                                                                                                                                                                                                            3) matriz flotante y un valor de dpi , y devuelve una matriz (m, n, 3) y dos compensaciones desde la esquina inferior izquierda de la imagen\n :meth:`alpha <matplotlib.collections.Collection.set_alpha>` matriz- como o escalar o Ninguno \n :meth:`animated <matplotlib.artist.Artist.set_animated>` bool \n :meth:`antialiased <matplotlib.collections.Collection.set_antialiased>` o aa                                                                                                                                                                                                                                                                                                                                                                                                       o antialiased        bool o lista de booleanos                                                                                                                                          \n        :meth:`array <matplotlib.cm.ScalarMappable.set_array>`                                               similar a una matriz o Ninguno                                                                                                                                             \n        :meth:`capstyle <matplotlib.collections.Collection.set_capstyle>`                                    `.CapStyle` o {\'butt\', \'projecting\', \'round\'}                                                                                                                 \n        :meth:`clim <matplotlib.cm.ScalarMappable.set_clim>`                                                 (vmin: float, vmax: float)                                                                                                                                     \n        :meth :`clip_box <matplotlib.artist.Artist.set_clip_box>`                                             `.Bbox`                                                                                                                                                        \n        :meth:`clip_on <matplotlib.artist.Artist.set_clip_on>`                                               bool                                                                                                                                                           \n        :meth:`clip_path <matplotlib.artist.Artist.set_clip_path>`                                           Patch o (Ruta, Transformar) o Ninguno                                                                                                                             \n        :meth:`cmap <matplotlib.cm.ScalarMappable .set_cmap>`                                                 `.Colormap` o str o None                                                                                                                                     \n        :meth:`color <matplotlib.collections.Collection.set_color>`                                          color o lista de tuplas rgba \n :meth:`edgecolor <matplotlib.collections.Collection.set_edgecolor >` o ec o edgecolors color                                                                                                                                                      o lista de colores o \'face\'                                                                                                                              \n        :meth:`facecolor <matplotlib.collections.Collection.set_facecolor>` o facecolors o fc              color o lista de colores                                                                                                                                        \n        :meth:`figure <matplotlib.artist.Artist. set_figure>`                                                 `.Figura`                                                                                                                                                      \n        :meth:`gid <matplotlib.artist.Artist.set_gid>`                                                       str                                                                                                                                                            \n        :meth:`hatch <matplotlib.colecciones.Colección.set_hatch>`                                          {\'/\', \ '\\\\\', \'|\', \'-\', \'+\', \'x\', \'o\', \'O\', \'.\', \'*\'}                                                                                                            \n        :meth:`in_layout <matplotlib.artist.Artist.set_in_layout>`                                           bool                                                                                                                                                           \n        :meth:`joinstyle <matplotlib.collections.Collection.set_joinstyle>`                                  `.JoinStyle` o {\'miter \', \'round\', \'bevel\'}                                                                                                                    \n        :meth:`label <matplotlib.artist.Artist.set_label>`                                                   objeto                                                                                                                                                         \n        :meth:`linestyle <matplotlib.collections.Collection.set_linestyle>` o guiones o estilos de línea o ls    str o tupla o lista de los mismos                                                                                                                                   \n        :meth:`linewidth <matplotlib.collections.Collection.set_linewidth>` o linewidths o lw              float o lista de flotadores                                                                                                                                        \n        :meth:`mouseover <matplotlib.artist.Artist.set_mouseover>`                                           bool                                                                                                                                                           \n        :meth:`norm <matplotlib.cm.ScalarMappable .set_norm>`                                                 `.Normalize` o str o None                                                                                                                                    \n        :meth:`offset_transform <matplotlib.collections.Collection.set_offset_transform>` o transOffset     unknown                                                                                                                                                        \n        :meth:`offsets <matplotlib.collections.Collection.set_offsets>`                                      ( N, 2) o (2,)                                                                                                                                      \n        :meth:`path_effects < matplotlib.artist.Artist.set_path_effects>`                                     `.AbstractPathEffect`                                                                                                                                          \n        :meth:`paths <matplotlib.collections.PolyCollection.set_verts>`                                      lista de \ n :meth :`picker <matplotlib.artist.Artist.set_picker>` Ninguno o bool o float o invocable \n :meth:`pickradius <matplotlib.collections.Collection.set_pickradius>` desconocido \n :meth:`rasterizado <matplotlib.artist. Artist.set_rasterized>` bool \n :meth:`tamaños                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             <matplotlib.collections._CollectionWithSizes.set_sizes>`                                ndarray o Ninguno                                                                                                                                                \n        :meth:`sketch_params <matplotlib.artist.Artist.set_sketch_params>`                                   (escala: flotante, longitud: flotante, aleatoriedad: flotante)                                                                                                               \n        :meth:`snap <matplotlib.artist.Artist.set_snap>`                                                     bool o Ninguno                                                                                                                                                   \n        :meth:`transform <matplotlib.artist.Artist.set_transform>`                                           `.Transform`                                                                                                                                                   \n        :meth:`url <matplotlib.artist.Artist.set_url> `                                                       str                                                                                                                                                            \n        :meth:`urls <matplotlib.collections.Collection.set_urls>`                                            lista de str o Ninguno                                                                                                                                            \n        :meth:`verts <matplotlib.collections.PolyCollection.set_verts>`                                      lista de matrices                                                                                                                                             \n        :meth:`verts_and_codes <matplotlib.collections.PolyCollection.set_verts_and_codes>`                  desconocido                                                                                                                                                        \n        :meth:`visible < matplotlib.artist.Artist.set_visible>`                                               bool                                                                                                                                                           \n        :meth:`zorder <matplotlib.artist.Artist.set_zorder>`                                                 float                                                                                                                                                          \n        ==================== ================================================== ==================================================    _ ================================================== ================================================== ==================================\n\n'

set ( * , UVC=<UNSET> , agg_filter=<UNSET> , alpha=<UNSET> , animation =<UNSET> , antialiased=<UNSET> , array=<UNSET> , capstyle=<UNSET> , clim=<UNSET > , clip_box=<UNSET> , clip_on=<UNSET> , clip_path=<UNSET> , cmap=<UNSET> , color=<UNSET> , edgecolor=<UNSET> , facecolor=<UNSET> , gid=<UNSET> , hatch=<UNSET> , in_layout=<DESCONFIGURAR> , joinstyle=<DESCONFIGURAR>, label=<UNSET> , linestyle=<UNSET> , linewidth=<UNSET> , mouseover=<UNSET> , norm=<UNSET> , offset_transform=<UNSET> , offsets=<UNSET> , path_effects=<UNSET> , paths =<UNSET> , picker=<UNSET> , pickradius=<UNSET> , rasterized=<UNSET> , tamaños=<UNSET> , sketch_params=<UNSET> , snap=<UNSET> , transform=<UNSET> , url=< DESCONFIGURAR> , urls=<DESCONFIGURAR> ,verts=<DESCONFIGURAR> ,verts_and_codes=<UNSET> , visible=<UNSET> , zorder=<UNSET> )

Establece varias propiedades a la vez.

Las propiedades admitidas son

Propiedad	Descripción
UVC	desconocido
agg_filter	una función de filtro, que toma una matriz flotante (m, n, 3) y un valor de ppp, y devuelve una matriz (m, n, 3) y dos compensaciones desde la esquina inferior izquierda de la imagen
alpha	tipo matriz o escalar o ninguno
animated	bool
antialiasedo aa o suavizado	bool o lista de bools
array	tipo matriz o ninguno
capstyle	CapStyleo {'trasero', 'proyectando', 'redondo'}
clim	(vmin: flotante, vmax: flotante)
clip_box	Bbox
clip_on	bool
clip_path	Parchear o (Ruta, Transformar) o Ninguno
cmap	Colormapo str o Ninguno
color	color o lista de tuplas rgba
edgecoloro ec o edgecolors	color o lista de colores o 'cara'
facecoloro colores de cara o fc	color o lista de colores
figure	Figure
gid	calle
hatch	{'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'}
in_layout	bool
joinstyle	JoinStyleo {'inglete', 'redondo', 'bisel'}
label	objeto
linestyleo guiones o estilos de línea o ls	str o tuple o lista de los mismos
linewidtho anchos de línea o lw	flotador o lista de flotadores
mouseover	bool
norm	Normalizeo str o Ninguno
offset_transformo transOffset	desconocido
offsets	secuencia de pares de flotadores
path_effects	AbstractPathEffect
paths	lista de tipo matriz
picker	Ninguno o bool o flotante o invocable
pickradius	desconocido
rasterized	bool
sizes	ndarray o Ninguno
sketch_params	(escala: flotante, longitud: flotante, aleatoriedad: flotante)
snap	booleano o ninguno
transform	Transform
url	calle
urls	lista de str o Ninguno
verts	lista de tipo matriz
verts_and_codes	desconocido
visible	bool
zorder	flotar

set_UVC ( U , V , C = Ninguno )

set_offsets ( xy )

Establezca los desplazamientos para los polígonos de púas. Esto guarda las compensaciones pasadas y las enmascara según corresponda para los datos U/V existentes.

Parámetros :

secuencia xy de pares de flotadores