clim

Establecer los límites del mapa de colores (nombre modificado respecto a la versión R2022a, caxis)

Sintaxis

clim(limits)

clim("auto")

clim("manual")

clim(target,___)

lims = clim

Descripción

clim(limits) establece los límites del mapa de colores para los ejes actuales. limits es un vector de dos elementos con la forma [cmin cmax]. Todos los valores del arreglo de indexación del mapa de colores que son menores que o iguales a cmin se asignan a la primera fila del mapa de colores. Todos los valores que son mayores que o iguales a cmax se asignan a la última fila del mapa de colores. Todos los valores entre cmin y cmax se asignan de forma lineal a las filas intermedias del mapa de colores.

Nota

La función clim afecta únicamente a los objetos de gráficas cuya propiedad CDataMapping está establecida en "scaled". No afecta a los objetos de gráficas que usan color real o tienen CDataMapping establecido en "direct".

clim("auto") permite las actualizaciones automáticas de los límites cuando los valores del arreglo de indexación del mapa de colores cambian. Se trata del comportamiento predeterminado. El comando clim auto es una forma alternativa de esta sintaxis.

clim("manual") deshabilita las actualizaciones automáticas de los límites. El comando clim manual es una forma alternativa de esta sintaxis.

clim(target,___) establece los límites del mapa de colores para unos ejes específicos o una visualización independiente. Especifique target como primer argumento de entrada en cualquiera de las sintaxis anteriores.

lims = clim devuelve los límites actuales del mapa de colores como un vector con la forma [cmin cmax].

Ejemplos

Aumentar el límite inferior

Represente un paraboloide con una barra de colores.

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

Obtenga los límites actuales de color.

lims = clim

lims = 1×2

     0    50

Aumente el límite inferior hasta 20. Observe que todos los valores de Z que son menores que o iguales a 20 se asignan al primer color.

clim([20 50])

Mantener los límites de color para múltiples gráficas de superficie

Cree dos superficies paraboloides que estén desplazadas verticalmente.

[X,Y] = meshgrid(-5:.5:5);
Z1 = X.^2 + Y.^2;
Z2 = Z1 + 50;

Represente el primer paraboloide. Añada una barra de colores y mantenga los ejes para el segundo paraboloide.

surf(X,Y,Z1);
colorbar
hold on

Mantenga los límites actuales de color utilizando la opción "manual". Después, represente el segundo paraboloide.

clim("manual");
surf(X,Y,Z2);

Establecer límites de color en ejes específicos

Llame a la función tiledlayout para crear un diseño de gráfica en mosaico de 1 por 2. Llame a la función nexttile para crear los objetos de ejes ax1 y ax2. Represente un paraboloide en cada conjunto de ejes.

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

% Left plot
ax1 = nexttile;
surf(ax1,Z);

% Right plot
ax2 = nexttile;
surf(ax2,Z);

Aumente el límite inferior de color de los ejes de la derecha hasta 20.

clim(ax2,[20 50])

Argumentos de entrada

limits — Límites nuevos

vector con el formato [cmin cmax]

Límites nuevos, especificados como vector con el formato [cmin cmax]. El valor de cmin debe ser menor que cmax.

Tipos de datos: single | double

target — Objeto objetivo

cualquier tipo de objeto de ejes | visualización independiente | arreglo de ejes o visualizaciones independientes

Objeto objetivo, especificado como uno de los siguientes elementos:

• Cualquier tipo de objeto de ejes, como un objeto Axes, PolarAxes o GeographicAxes.

• Una visualización independiente que tiene una propiedad Colormap.

• Un arreglo de ejes o visualizaciones independientes que pertenecen a la misma clase. Para determinar la clase, use la función class.

Si no especifica el objeto objetivo, clim establece los límites del mapa de colores para los ejes actuales (gca).

Más acerca de

Arreglo de indexación del mapa de colores

Un arreglo que asigna elementos de datos en una gráfica a determinadas filas en el mapa de colores. MATLAB^® almacena el arreglo de indexación como una propiedad del objeto de gráficas.

Por ejemplo, la propiedad CData de un objeto Surface es un arreglo de indexación que asigna puntos de cuadrícula de la superficie a determinadas filas del mapa de colores.

Historial de versiones

Introducido antes de R2006a

R2024a: Establecer los límites del mapa de colores para múltiples ejes o gráficas a la vez

Establezca los límites del mapa de colores para múltiples ejes o gráficas a la vez especificando el argumento target como un arreglo de ejes o visualizaciones independientes.

R2022a: Nombre modificado de caxis

Para alinear el nombre de función con la propiedad de los ejes CLim, caxis ahora se denomina clim.

Consulte también

colormap | colorbar

Temas

• Controlar los límites de un mapa de colores