matplotlib.pyplot.quiver #

matplotlib.pyplot. carcaj ( * argumentos , datos = Ninguno , ** kwargs ) [fuente] #

Trace un campo 2D de flechas.

Firma de llamada:

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

X , Y definen las ubicaciones de las flechas, U , V definen las direcciones de las flechas y C opcionalmente establece el color.

Longitud de flecha

La configuración predeterminada escala automáticamente la longitud de las flechas a un tamaño razonable. Para cambiar este comportamiento, consulte los parámetros scale y scale_units .

forma de flecha

La forma de la flecha está determinada por el ancho , el ancho de la cabeza , la longitud de la cabeza y la longitud del eje de la cabeza . Consulte las notas a continuación.

Estilo de flecha

Cada flecha está representada internamente por un polígono relleno con un ancho de línea de borde predeterminado de 0. Como resultado, una flecha es más bien un área rellena, no una línea con cabeza, y PolyCollectionpropiedades como linewidth , edgecolor , facecolor , etc. actúan en consecuencia.

Parámetros :

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

Las coordenadas x e y de las ubicaciones de las flechas.

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 de dirección x e y de los vectores de flecha. La interpretación de estos componentes (en datos o en el espacio de la pantalla) depende de los ángulos .

U y V deben tener el mismo número de elementos, coincidiendo con el número de ubicaciones de flecha en X , Y . U y V pueden estar enmascarados. Las ubicaciones enmascaradas en cualquiera de U , V y C no se dibujarán.

C 1D o 2D tipo matriz, opcional

Datos numéricos que definen los colores de las flechas 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 el color en su lugar. El tamaño de C debe coincidir con el número de ubicaciones de flecha.

ángulos {'uv', 'xy'} o tipo matriz, por defecto: 'uv'

Método para determinar el ángulo de las flechas.

'uv': dirección de la flecha en las coordenadas de la pantalla. Use esto si las flechas simbolizan una cantidad que no se basa en las coordenadas de datos X , Y.

Si U == V , la orientación de la flecha en el gráfico es de 45 grados en sentido antihorario desde el eje horizontal (positivo a la derecha).
'xy': dirección de la flecha en coordenadas de datos, es decir, las flechas apuntan de (x, y) a (x+u, y+v). Utilice esto, por ejemplo, para trazar un campo de gradiente.
Los ángulos arbitrarios se pueden especificar explícitamente como una matriz de valores en grados, en sentido contrario a las agujas del reloj desde el eje horizontal.

En este caso U , V solo se usa para determinar la longitud de las flechas.

Nota: invertir un eje de datos invertirá correspondientemente las flechas solo con angles='xy'.

pivote {'cola', 'medio', 'medio', 'punta'}, predeterminado: 'cola'

La parte de la flecha que está anclada a la cuadrícula X , Y. La flecha gira alrededor de este punto.

'medio' es un sinónimo de 'medio'.

flotador de escala , opcional

Escala la longitud de la flecha inversamente.

Número de unidades de datos por unidad de longitud de flecha, por ejemplo, m/s por ancho de parcela; un parámetro de escala más pequeño hace que la flecha sea más larga. El valor predeterminado es Ninguno .

Si es None , se usa un algoritmo de escalado automático simple, basado en la longitud promedio del vector y el número de vectores. La unidad de longitud de flecha viene dada por el parámetro scale_units .

scale_units {'ancho', 'alto', 'puntos', 'pulgadas', 'x', 'y', 'xy'}, opcional

Si la escala kwarg es Ninguno , la unidad de longitud de flecha. El valor predeterminado es Ninguno .

por ejemplo , scale_units es 'pulgadas', scale es 2.0, y entonces el vector tendrá 0.5 pulgadas de largo.(u, v) = (1, 0)

Si scale_units es 'ancho' o 'alto', entonces el vector será la mitad del ancho/alto de los ejes.

Si scale_units es 'x', entonces el vector será de 0,5 unidades del eje x. Para trazar vectores en el plano xy, donde u y v tienen las mismas unidades que x e y, use .angles='xy', scale_units='xy', scale=1

unidades {'ancho', 'alto', 'puntos', 'pulgadas', 'x', 'y', 'xy'}, predeterminado: 'ancho'

Afecta el tamaño de la flecha (excepto la longitud). En particular, el ancho del eje se mide en múltiplos de esta unidad.

Los valores admitidos son:

'width', 'height': El ancho o la altura de los Ejes.
'puntos', 'pulgadas': Píxeles o pulgadas basados en la figura dpi.
'x', 'y', 'xy': X , Y o\(\sqrt{X^2 + Y^2}\)en unidades de datos.

La siguiente tabla resume cómo estos valores afectan el tamaño de la flecha visible al hacer zoom y cambiar el tamaño de la figura:

unidades	zoom	cambio de tamaño de figura
'x', 'y', 'xy'	escalas de tamaño de flecha
'ancho', 'alto'		escalas de tamaño de flecha
'puntos', 'pulgadas'

flotador ancho , opcional

Ancho del eje en unidades de flecha. Todos los parámetros de la cabeza son relativos al ancho .

El valor predeterminado depende de la elección de las unidades anteriores y del número de vectores; un valor inicial típico es aproximadamente 0,005 veces el ancho de la parcela.

ancho de cabeza flotante, predeterminado: 3

Ancho de la cabeza como múltiplo del ancho del eje . Consulte las notas a continuación.

flotante de longitud de cabeza , predeterminado: 5

Longitud de la cabeza como múltiplo del ancho del eje . Consulte las notas a continuación.

headaxislength float, predeterminado: 4.5

Longitud de la cabeza en la intersección del eje como múltiplo del ancho del eje . Consulte las notas a continuación.

flotador del eje mínimo , por defecto: 1

Longitud por debajo de la cual escala la flecha, en unidades de longitud de la cabeza. ¡No establezca esto en menos de 1, o las flechas pequeñas se verán terribles!

flotante de longitud mínima , predeterminado: 1

Longitud mínima como múltiplo del ancho del eje; si la longitud de una flecha es menor que esto, trace un punto (hexágono) de este diámetro en su lugar.

color color o secuencia de colores, opcional

Color(es) explícito(s) para las flechas. Si se ha configurado C , el color no tiene efecto.

Este es un sinónimo del parámetro facecolor .PolyCollection

Devoluciones :

Quiver

Otros parámetros :

objeto indexable de datos , opcional

Si se proporciona, todos los parámetros también aceptan una cadena s, que se interpreta como data[s](a menos que esto genere una excepción).

**propiedades de kwargs PolyCollection, opcional

Todos los demás argumentos de palabras clave se pasan a PolyCollection:

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
`antialiased`o aa o suavizado	bool o lista de bools
`array`	tipo matriz o ninguno
`capstyle`	`CapStyle`o {'trasero', 'proyectando', 'redondo'}
`clim`	(vmin: flotante, vmax: flotante)
`clip_box`	`Bbox`
`clip_on`	bool
`clip_path`	Parchear o (Ruta, Transformar) o Ninguno
`cmap`	`Colormap`o str o Ninguno
`color`	color o lista de tuplas rgba
`edgecolor`o ec o edgecolors	color o lista de colores o 'cara'
`facecolor`o colores de cara o fc	color o lista de colores
`figure`	`Figure`
`gid`	calle
`hatch`	{'/', '\', '\|', '-', '+', 'x', 'o', 'O', '.', '*'}
`in_layout`	bool
`joinstyle`	`JoinStyle`o {'inglete', 'redondo', 'bisel'}
`label`	objeto
`linestyle`o guiones o estilos de línea o ls	str o tuple o lista de los mismos
`linewidth`o anchos de línea o lw	flotador o lista de flotadores
`mouseover`	bool
`norm`	`Normalize`o str o Ninguno
`offset_transform`o 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

Ver también

Axes.quiverkey: Agrega una llave a un diagrama de carcaj.

notas

forma de flecha

La flecha se dibuja como un polígono usando los nodos como se muestra a continuación. Los valores headwidth , headlength y headaxislength están en unidades de ancho .

Los valores predeterminados muestran una flecha ligeramente inclinada hacia atrás. Aquí hay algunas pautas sobre cómo obtener otras formas de cabeza:

Para hacer que la cabeza sea un triángulo, haga que la longitud del eje de la cabeza sea igual a la longitud de la cabeza .
Para que la flecha sea más puntiaguda, reduzca el ancho de la cabeza o aumente la longitud de la cabeza y la longitud del eje de la cabeza .
Para hacer que la cabeza sea más pequeña en relación con el eje, reduzca proporcionalmente todos los parámetros de la cabeza.
Para quitar el cabezal por completo, establezca todos los parámetros del cabezal en 0.
Para obtener una cabeza con forma de diamante, haga que la longitud del eje de la cabeza sea mayor que la longitud de la cabeza .
Advertencia: Para la longitud del eje de la cabeza < ( longitud de la cabeza / ancho de la cabeza ), los nodos del "eje de la cabeza" (es decir, los que conectan la cabeza con el eje) sobresaldrán de la cabeza en dirección hacia adelante de modo que la punta de la flecha parezca rota.