La traducción de esta página aún no se ha actualizado a la versión más reciente. Haga clic aquí para ver la última versión en inglés.

contour3

Diagrama de contorno en 3D

• 

×

Sintaxis

contour3(Z)

contour3(X,Y,Z)

contour3(___,levels)

contour3(___,LineSpec)

contour3(___,Name,Value)

contour3(ax,___)

M = contour3(___)

[M,c] = contour3(___)

Descripción

contour3(Z) crea un diagrama de contorno 3D que contiene las isolíneas de la matriz Z, donde Z contiene los valores de altura del plano x-y. MATLAB^® selecciona de forma automática las líneas de contorno que se van a mostrar. Los índices de columna y de fila de Z son las coordenadas x e y del plano, respectivamente.

contour3(X,Y,Z) especifica las coordenadas x e y para los valores de Z.

contour3(___,levels) especifica las líneas de contorno que se van a mostrar como último argumento en cualquiera de las sintaxis anteriores. Especifique levels como un valor escalar n para mostrar las líneas de contorno en n niveles (alturas) elegidos de forma automática. Para dibujar las líneas de contorno en alturas específicas, especifique levels como vector de valores que aumentan monotónicamente. Para dibujar los contornos en una altura (k), especifique levels como vector fila de dos elementos [k k].

contour3(___,LineSpec) especifica el estilo y el color de las líneas de contorno.

contour3(___,Name,Value) especifica opciones adicionales para el diagrama de contorno utilizando uno o más argumentos de par nombre-valor. Especifique las opciones después de todos los demás argumentos de entrada. Para obtener una lista de las propiedades, consulte Contour Properties.

contour3(ax,___) muestra el diagrama de contorno en los ejes objetivo. Especifique los ejes como el primer argumento en cualquiera de las sintaxis anteriores.

M = contour3(___) devuelve la matriz de contorno M, que contiene las coordenadas (x, y) de los vértices en cada nivel.

[M,c] = contour3(___) devuelve la matriz de contorno y el objeto de contorno c. Utilice c para establecer las propiedades después de mostrar el diagrama de contorno.

Ejemplos

Contornos de una esfera

Defina Z como una función de X y de Y. En este caso, llame a la función sphere para crear X, Y y Z. Después, represente los contornos de Z.

[X,Y,Z] = sphere(50);
contour3(X,Y,Z);

Contornos en 50 niveles

Defina Z como una función de dos variables, X e Y. Después, represente los contornos de Z. En este caso, deje que MATLAB® elija los contornos y los límites para los ejes x e y.

[X,Y] = meshgrid(-5:0.25:5);
Z = X.^2 + Y.^2;
contour3(Z)

Ahora, especifique los 50 niveles de contorno y muestre los resultados dentro de los límites x e y utilizados para calcular Z.

contour3(X,Y,Z,50)

Contornos en niveles específicos con etiquetas

Defina Z como una función de dos variables, X e Y. Después, represente los contornos en Z = [-.2 -.1 .1 .2]. Muestre las etiquetas de contorno estableciendo la propiedad ShowText en 'on'.

[X,Y] = meshgrid(-2:0.25:2);
Z = X.*exp(-X.^2-Y.^2);
contour3(X,Y,Z,[-.2 -.1 .1 .2],'ShowText','on')

Contornos en un nivel

Defina Z como una función de X y de Y. En este caso, llame a la función peaks para crear X, Y y Z. A continuación, muestre los contornos en Z = 2.

[X,Y,Z] = peaks;
contour3(X,Y,Z,[2 2]);

Ancho de línea personalizado

Defina Z como una función de dos variables, X e Y. Represente 30 contornos de Z y, a continuación, establezca el ancho de línea en 3.

[X,Y] = meshgrid(-2:0.0125:2);
Z = X.*exp(-X.^2-Y.^2);
[M,c] = contour3(X,Y,Z,30);
c.LineWidth = 3;

Argumentos de entrada

X — Coordenadas x

matriz | vector

Coordenadas x, especificadas como matriz del mismo tamaño que Z o como vector con una longitud n, en el que [m,n] = size(Z). El valor predeterminado de X es el vector (1:n).

Cuando X es una matriz, los valores deben ser estrictamente crecientes o decrecientes en una dimensión y mantenerse constantes en la otra. La dimensión que varía debe ser la opuesta a la dimensión que varía en Y. Puede usar la función meshgrid para crear matrices X e Y.

Cuando X es un vector, los valores deben ser estrictamente crecientes o decrecientes.

Ejemplo: X = 1:10

Ejemplo: X = [1 2 3; 1 2 3; 1 2 3]

Ejemplo: [X,Y] = meshgrid(1:10)

La propiedad XData del objeto Contour guarda las coordenadas x.

Tipos de datos: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

Y — Coordenadas y

matriz | vector

Coordenadas y, especificadas como matriz del mismo tamaño que Z o como vector con una longitud m, en el que [m,n] = size(Z). El valor predeterminado de Y es el vector (1:m).

Cuando Y es una matriz, los valores deben ser estrictamente crecientes o decrecientes en una dimensión y mantenerse constantes en la otra. La dimensión que varía debe ser la opuesta a la dimensión que varía en X. Puede usar la función meshgrid para crear las matrices X e Y.

Cuando Y es un vector, los valores deben ser estrictamente crecientes o decrecientes.

Ejemplo: Y = 1:10

Ejemplo: Y = [1 1 1; 2 2 2; 3 3 3]

Ejemplo: [X,Y] = meshgrid(1:10)

La propiedad YData del objeto Contour guarda las coordenadas y.

Tipos de datos: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

Z — Coordenadas z

matriz

Coordenadas z, especificadas como matriz. Esta matriz debe tener al menos dos filas y dos columnas, y debe contener al menos dos valores diferentes.

Ejemplo: Z = peaks(20)

La propiedad ZData del objeto Contour guarda las coordenadas z.

Tipos de datos: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

levels — Niveles

escalar | vector

Niveles de contorno, especificados como número entero escalar o como vector. Utilice este argumento para controlar el número y la ubicación de las líneas de contorno. Cuando no especifica los niveles, la función contour3 elige los niveles automáticamente.

• Para dibujar líneas de contorno en n alturas elegidas automáticamente, especifique levels como el valor escalar n.

• Para dibujar las líneas de contorno en alturas específicas, especifique levels como vector de valores que aumentan monotónicamente.

• Para dibujar líneas de contorno en una altura única k, especifique levels como vector fila de dos elementos [k k].

Ejemplo: contour3(peaks,10) dibuja líneas de contorno en 10 alturas elegidas automáticamente en la función peaks.

Ejemplo: contour3(peaks,[-4 0 4]) dibuja líneas de contorno en 3 alturas específicas en la función peaks: -4, 0 y 4.

Ejemplo: contour3(peaks,[3 3]) dibuja líneas de contorno para mostrar dónde la altura de la función peaks es 3.

Tipos de datos: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

LineSpec — Estilo de línea y color

vector de caracteres | escalar de cadena

Estilo de línea y color, especificado como vector de caracteres o escalar de cadena que contiene caracteres y símbolos. Los caracteres y los símbolos pueden aparecer en cualquier orden. Puede especificar el estilo de línea, el color de línea o ambos. Los símbolos de marcador, como 'o', se ignoran.

Ejemplo: '--g' es una línea verde discontinua.

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

Nombre del color	Nombre corto	Apariencia
'red'	'r'
'green'	'g'
'blue'	'b'
'cyan'	'c'
'magenta'	'm'
'yellow'	'y'
'black'	'k'
'white'	'w'

ax — Ejes objetivo

objeto Axes

Ejes objetivo, especificados como objeto Axes. Si no especifica los ejes, contour3 representa en 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: contour3(Z,'ShowText','on') representa las etiquetas de línea de contorno.

Nota

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

ShowText — Etiquetas de línea de contorno

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

Etiquetas de línea de contorno, especificadas como 'on' o como '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 valores de altura en las líneas de contorno.

• 'off': no etiqueta las líneas de contorno.

LineWidth — Ancho de línea

0.5 (predeterminado) | valor positivo

Ancho de línea, especificado como valor positivo en puntos. Un punto equivale a 1/72 pulgadas.

LabelSpacing — Espaciado de etiquetas

144 (predeterminado) | escalar

Espaciado de etiquetas en las líneas de contorno, especificado como valor escalar en puntos, donde un punto equivale a 1/72 pulgadas. Utilice esta propiedad para controlar el número de etiquetas de contorno en las líneas de contorno. Los valores más pequeños generan más etiquetas.

Debe establecer la propiedad ShowText en 'on' para que la propiedad LabelSpacing surta efecto.

Si utiliza la función clabel para mostrar las etiquetas, la propiedad LabelSpacing no surte ningún efecto y la gráfica muestra una etiqueta por línea.

Argumentos de salida

M — Matriz de contorno

matriz

Matriz de contorno, devuelta como matriz de dos filas con la siguiente forma.

Z1, x1,1, x1,2, ..., x1,N1, Z2, x2,1, x2,2, ..., x2,N2, Z3, ...
N1, y1,1, y1,2, ..., y1,N1, N2, y2,1, y2,2, ..., y2,N2, N3, ...

Las columnas de la matriz definen las líneas de contorno. Cada línea de contorno comienza con una columna que contiene valores Z y N:

• Zi: la altura de la i-ésima línea de contorno

• Ni: el número de vértices de la i-ésima línea de contorno

• (x_ij, y_ij): las coordenadas de los vértices para la i-ésima línea de contorno, donde j oscila entre 1 y Ni

c — Objeto de contorno

objeto Contour

Objeto Contour. Utilice este objeto para establecer las propiedades después de mostrar el diagrama de contorno.

Capacidades ampliadas

Arreglos GPU

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

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

• clabel | contourf | contourc | contour

Propiedades

• Contour Properties