quiver

Gráfica de vectores o de campos vectoriales

• 

Sintaxis

quiver(X,Y,U,V)

quiver(U,V)

quiver(___,scale)

quiver(___,LineSpec)

quiver(___,LineSpec,'filled')

quiver(___,Name,Value)

quiver(ax,___)

q = quiver(___)

Descripción

quiver(X,Y,U,V) representa flechas con los componentes direccionales U y V en las coordenadas cartesianas especificadas por X e Y. Por ejemplo, la primera flecha se origina en el punto X(1) e Y(1), se extiende horizontalmente según U(1) y se extiende verticalmente según V(1). De forma predeterminada, la función quiver escala las longitudes de las flechas para que no se superpongan.

quiver(U,V) representa flechas con componentes direccionales especificados por U y V en puntos equidistantes.

• Si U y V son vectores, las coordenadas x de las flechas van de 1 al número de elementos en U y V, y las coordenadas y son todas 1.

• Si U y V son matrices, las coordenadas x de las flechas van de 1 al número de columnas en U y V, y las coordenadas y de las flechas van de 1 al número de filas en U y V.

quiver(___,scale) ajusta la longitud de las flechas:

• Si scale es un número positivo, la función quiver ajusta automáticamente las longitudes de las flechas para que no se superpongan y después las estira mediante un factor de scale. Por ejemplo, una scale de 2 dobla la longitud de las flechas y una scale de 0,5 divide por la mitad la longitud de las flechas.

• Si scale es 'off' o 0, como quiver(X,Y,U,V,'off'), se deshabilita el escalado automático.

quiver(___,LineSpec) define el estilo de la línea, el marcador y el color. Los marcadores aparecen en los puntos especificados por X e Y. Si especifica un marcador mediante LineSpec, quiver no muestra las puntas de las flechas. Para especificar un marcador y mostrar las puntas de las flechas, configure la propiedad Marker.

quiver(___,LineSpec,'filled') rellena los marcadores especificados mediante LineSpec.

quiver(___,Name,Value) especifica las propiedades de las gráficas de campos vectoriales mediante uno o más argumentos de par nombre-valor. Para obtener una lista de las propiedades, consulte Quiver Properties. Especifique los argumentos de par nombre-valor tras el resto de argumentos de entrada. Los argumentos de par nombre-valor se aplican a todas las flechas de la gráfica de campos vectoriales.

quiver(ax,___) crea la gráfica de campos vectoriales en los ejes especificados por ax en lugar de los ejes actuales (gca). El argumento ax puede preceder a cualquiera de las combinaciones de argumentos de entrada de las sintaxis anteriores.

q = quiver(___) devuelve un objeto Quiver. Este objeto es útil para controlar las propiedades de la gráfica de campos vectoriales después de crearla.

Ejemplos

Crear una gráfica de campos vectoriales

Cargue datos de muestra que representen las corrientes de aire de América del Norte. Seleccione para este ejemplo un subconjunto de los datos.

load('wind','x','y','u','v')
X = x(11:22,11:22,1);
Y = y(11:22,11:22,1);
U = u(11:22,11:22,1);
V = v(11:22,11:22,1);

Cree una gráfica de campos vectoriales del subconjunto que haya seleccionado. Los vectores X e Y representan la ubicación del origen de cada flecha, y U y V representan los componentes direccionales de cada flecha. De forma predeterminada, la función quiver acorta las flechas para que no se superpongan. Llame a axis equal para utilizar longitudes de unidades de datos iguales a lo largo de cada eje. De este modo, la punta de las flechas tendrá la orientación correcta.

quiver(X,Y,U,V)
axis equal

Deshabilitar el escalado automático

De forma predeterminada, la función quiver acorta las flechas para que no se superpongan. Deshabilite el escalado automático para que las longitudes de las flechas estén determinadas por U y V estableciendo el argumento scale en 0.

Por ejemplo, busque una cuadrícula de valores de X e Y mediante la función meshgrid. Especifique los componentes direccionales usando estos valores. A continuación, cree una gráfica de campos vectoriales sin escalado automático.

[X,Y] = meshgrid(0:6,0:6);
U = 0.25*X;
V = 0.5*Y;
quiver(X,Y,U,V,0)

Contornos y gradientes de la gráfica

Represente los contornos y el gradiente de la función $$z=x{e}^{-x^2-y^2}$$. Use la función quiver para representar el gradiente y la función contour para representar los contornos.

En primer lugar, cree una cuadrícula de valores de x e y a una distancia equidistante. Úselos para calcular z. A continuación, busque el gradiente de z especificando el espacio entre los puntos.

spacing = 0.2;
[X,Y] = meshgrid(-2:spacing:2);
Z = X.*exp(-X.^2 - Y.^2);
[DX,DY] = gradient(Z,spacing);

Muestre los vectores del gradiente como una gráfica de campos vectoriales. A continuación, muestre las líneas del contorno en los mismos ejes. Ajuste la visualización para que los vectores del gradiente aparezcan perpendicularmente a las líneas de contorno, llamando a axis equal.

quiver(X,Y,DX,DY)
hold on
contour(X,Y,Z)
axis equal
hold off

Especificar el color de las flechas

Cree una gráfica de campos vectoriales y especifique un color para las flechas.

[X,Y] = meshgrid(-pi:pi/8:pi,-pi:pi/8:pi);
U = sin(Y);
V = cos(X);
quiver(X,Y,U,V,'r')

Especificar ejes de una gráfica de campos vectoriales

Cree una cuadrícula de valores de X e Y y dos conjuntos de componentes direccionales de U y V.

[X,Y] = meshgrid(0:pi/8:pi,-pi:pi/8:pi);
U1 = sin(X);
V1 = cos(Y);
U2 = sin(Y);
V2 = cos(X); 

Cree un mosaico de gráficas con dos ejes, ax1 y ax2. Agregue una gráfica de campos vectoriales y un título a cada eje. (Antes de la versión R2019b, use subplot en lugar de tiledlayout y nexttile.)

tiledlayout(1,2)

ax1 = nexttile;
quiver(ax1,X,Y,U1,V1)
axis equal
title(ax1,'Left Plot')

ax2 = nexttile;
quiver(ax2,X,Y,U2,V2)
axis equal
title(ax2,'Right Plot')

Modificar una gráfica de campos vectoriales después de crearla

Cree una gráfica de campos vectoriales y devuelva el objeto quiver. A continuación, elimine la punta de las flechas y añada marcadores de puntos al final de cada origen.

[X,Y] = meshgrid(-pi:pi/8:pi,-pi:pi/8:pi);
U = sin(Y);
V = cos(X);

q = quiver(X,Y,U,V);
q.ShowArrowHead = 'off';
q.Marker = '.';

Argumentos de entrada

X — coordenadas x de los orígenes de las flechas

escalar | vector | matriz

Coordenadas x de los orígenes de las flechas, especificadas como escalar, vector o matriz.

Si X e Y son vectores, y U y V son matrices, quiver expande X e Y a matrices. En este caso, size(U) y size(V) deben ser iguales a [length(Y) length(X)]. Para obtener más información sobre la expansión de vectores a matrices, consulte meshgrid.

Si X e Y son matrices, X, Y, U y V deben tener el mismo tamaño.

Y — coordenadas y de los orígenes de las flechas

escalar | vector | matriz

Coordenadas x de los orígenes de las flechas, especificadas como escalar, vector o matriz.

Si X e Y son vectores, y U y V son matrices, quiver expande X e Y a matrices. En este caso, size(U) y size(V) deben ser iguales a [length(Y) length(X)]. Para obtener más información sobre la expansión de vectores a matrices, consulte meshgrid.

Si X e Y son matrices, X, Y, U y V deben tener el mismo tamaño.

U — Componentes x

escalar | vector | matriz

Componentes x de las flechas, especificados como escalar, vector o matriz.

Si X e Y son vectores, size(U) y size(V) deben ser iguales a [length(Y) length(X)].

Si X e Y son matrices, X, Y, U y V deben tener el mismo tamaño.

V — Componentes y

escalar | vector | matriz

Componentes y de flechas, especificados como escalar, vector o matriz.

Si X e Y son vectores, size(U) y size(V) deben ser iguales a [length(Y) length(X)].

Si X e Y son matrices, X, Y, U y V deben tener el mismo tamaño.

LineSpec — Estilo de línea, marcador y color

vector de caracteres | cadena

Estilo de línea, marcador y color, especificados como un vector de caracteres o cadena que contiene símbolos. Los símbolos pueden aparecer en cualquier orden. No es necesario especificar las tres características (estilo de línea, marcador y color).

Si especifica un marcador mediante LineSpec, quiver no muestra las puntas de las flechas. Para especificar un marcador y mostrar las puntas de las flechas, configure la propiedad Marker.

Ejemplo: '--or' es una línea discontinua roja con marcadores circulares

Estilo de línea	Descripción	Línea resultante
"-"	Línea continua
"--"	Línea discontinua
":"	Línea de puntos
"-."	Línea de puntos y rayas

Marcador	Descripción	Marcador resultante
"o"	Círculo
"+"	Signo más
"*"	Asterisco
"."	Punto
"x"	Cruz
"_"	Línea horizontal
"|"	Línea vertical
"square"	Cuadrado
"diamond"	Rombo
"^"	Triángulo hacia arriba
"v"	Triángulo hacia abajo
">"	Triángulo hacia la derecha
"<"	Triángulo hacia la izquierda
"pentagram"	Pentagrama
"hexagram"	Hexagrama

Nombre del color	Nombre corto	Triplete RGB	Apariencia
"red"	"r"	[1 0 0]
"green"	"g"	[0 1 0]
"blue"	"b"	[0 0 1]
"cyan"	"c"	[0 1 1]
"magenta"	"m"	[1 0 1]
"yellow"	"y"	[1 1 0]
"black"	"k"	[0 0 0]
"white"	"w"	[1 1 1]

scale — Factor de escalado de flecha

número no negativo | 'off'

Factor de escalado de flecha, especificado como número no negativo u 'off'. De forma predeterminada, la función quiver escala automáticamente las flechas para que no se superpongan. La función quiver aplica el factor de escalado después de escalar automáticamente las flechas.

Especificar scale es lo mismo que establecer la propiedad AutoScaleFactor del objeto de gráfica de campos vectoriales. Por ejemplo, especificar scale como 2 dobla la longitud de las flechas. Especificar scale como 0.5 reduce a la mitad la longitud de las flechas.

Para deshabilitar el escalado automático, especifique scale como 'off' o 0. Si especifica uno de estos valores, la propiedad AutoScale del objeto de gráfica de campos vectoriales se establece en 'off' y la longitud de la flecha se determina completamente mediante U y V.

ax — Ejes objetivo

objeto Axes

Ejes objetivo, especificados como objeto Axes. Si no especifica los ejes, la función quiver utiliza los ejes actuales.

Argumentos de par nombre-valor

Especifique pares opcionales de argumentos como Name1=Value1,...,NameN=ValueN, donde Name es el nombre del argumento y Value es el valor correspondiente. Los argumentos nombre-valor deben aparecer después de otros argumentos, pero el orden de los pares no importa.

En las versiones anteriores a R2021a, utilice comas para separar cada nombre y valor, y encierre Name entre comillas.

Ejemplo: 'Color','r','LineWidth',1

Nota

Las propiedades que se enumeran aquí son solo un subconjunto. Para obtener una lista completa, consulte Quiver Properties.

LineWidth — Anchura de las líneas de las flechas

0.5 (predeterminado) | valor positivo

Anchura de las líneas de las flechas, especificada como valor positivo en unidades de punto. Un punto equivale a 1/72 pulgadas. El valor predeterminado es 0.5 puntos.

ShowArrowHead — Visualización de la punta de la flecha

'on' (predeterminado) | valor lógico activado/desactivado

Visualización de la punta de la flecha, especificada como 'on' u 'off', o como 1 (true) o 0 (false) numérico o lógico. Un valor de 'on' equivale a true, y 'off' equivale a false. En consecuencia, puede utilizar el valor de esta propiedad como valor lógico. El valor se guarda como valor lógico activado/desactivado del tipo matlab.lang.OnOffSwitchState.

• 'on': muestra los vectores con puntas de flecha.

• 'off': muestra los vectores sin puntas de flecha.

AutoScale — Utilizar el factor de escalado automático

'on' (predeterminado) | valor lógico activado/desactivado

Utilice el factor de escalado automático para ajustar la longitud de las flechas, especificado como 'on' u 'off', o como 1 (true) o 0 (false) numérico o lógico. Un valor de 'on' equivale a true, y 'off' equivale a false. En consecuencia, puede utilizar el valor de esta propiedad como valor lógico. El valor se guarda como valor lógico activado/desactivado del tipo matlab.lang.OnOffSwitchState.

• 'on': utiliza el valor AutoScaleFactor como multiplicador secundario para escalar la longitud de las flechas para que se ajusten a los datos de las coordenadas definidos dentro de la cuadrícula, así como escalar las flechas para que no se superpongan.

• 'off': no escala la longitud de las flechas.

AutoScaleFactor — Factor de escalado automático

0.9 (predeterminado) | escalar

Factor de escalado automático, especificado como escalar. El factor de escalado automático es un multiplicador que ajusta las magnitudes de las flechas si la propiedad AutoScale es "on". Por ejemplo, un valor de 2 dobla la longitud de las flechas y un valor de 0.5 reduce a la mitad la longitud de las flechas.

Nota

• Esta propiedad no tiene efecto si la propiedad AutoScale se establece en "off".

• Ajustar la propiedad AutoScaleFactor actualiza la propiedad ScaleFactor.

Sugerencias

Para crear una gráfica de campos vectoriales usando coordenadas polares, conviértalas en primer lugar a coordenadas cartesianas mediante la función pol2cart.

Capacidades ampliadas

Arreglos GPU

Acelere código mediante la ejecución en una unidad de procesamiento gráfico (GPU) mediante Parallel Computing Toolbox™.

La función quiver es compatible con entradas de arreglos de GPU con estas notas y limitaciones de uso:

• Esta función acepta arreglos de GPU, pero no se ejecuta en una GPU.

Para obtener más información, consulte Run MATLAB Functions on a GPU (Parallel Computing Toolbox).

Arreglos distribuidos

Realice particiones de arreglos grandes por toda la memoria combinada de su cluster mediante Parallel Computing Toolbox™.

Notas y limitaciones de uso:

• Esta función opera sobre arreglos distribuidos, pero se ejecuta en el cliente MATLAB^®.

Para obtener más información, consulte Run MATLAB Functions with Distributed Arrays (Parallel Computing Toolbox).

Historial de versiones

Introducido antes de R2006a

Consulte también

Funciones

• contour | quiver3 | meshgrid

Propiedades

• Quiver Properties