stairs

Gráfica de escalones

• 

Sintaxis

stairs(Y)

stairs(X,Y)

stairs(___,LineSpec)

stairs(tbl,yvar)

stairs(tbl,xvar,yvar)

stairs(___,Name,Value)

stairs(ax,___)

h = stairs(___)

[xb,yb] = stairs(___)

Descripción

Datos de vectores y matrices

stairs(Y) dibuja una gráfica de escalones de los elementos de Y.

• Si Y es un vector, stairs dibuja una línea.

• Si Y es una matriz, stairs dibuja una línea por cada columna de la matriz.

stairs(X,Y) representa los elementos de Y en las ubicaciones especificadas por X. Las entradas X e Y deben ser vectores o matrices del mismo tamaño. Además, X puede ser un vector fila o columna e Y debe ser una matriz con length(X) filas.

stairs(___,LineSpec) especifica un estilo de línea, símbolo de marcador y color. Por ejemplo, ":*r" especifica una línea roja con marcadores de asterisco. Utilice esta opción con cualquiera de las combinaciones de argumentos de entrada de las sintaxis anteriores.

Datos de tabla

stairs(tbl,yvar) representa la variable especificada desde la tabla con respecto a los índices de fila de la tabla. Si la tabla es un horario, la variable especificada se representa con respecto a los tiempos de fila del horario. Para representar un conjunto de valores y, especifique una variable para yvar. Para representar múltiples conjuntos de valores y, especifique múltiples variables para yvar. (desde R2022b)

stairs(tbl,xvar,yvar) representa las variables xvar y yvar desde la tabla tbl. Puede especificar una o múltiples variables para xvar e yvar. Si ambos argumentos especifican múltiples variables, deben especificar el mismo número de variables. (desde R2022b)

Otras opciones

stairs(___,Name,Value) modifica la gráfica de escalones utilizando uno o más argumentos de par nombre-valor. Por ejemplo, "Marker","o","MarkerSize",8 especifica marcadores circulares de 8 puntos.

stairs(ax,___) representa en los ejes especificados por ax en lugar de en los ejes actuales (gca). La opción ax puede preceder a cualquiera de las combinaciones de argumentos de entrada de las sintaxis anteriores.

h = stairs(___) devuelve uno o más objetos Stair. Utilice h para hacer cambios en las propiedades de un objeto Stair específico después de crearlo.

[xb,yb] = stairs(___) no crea una gráfica, sino que devuelve las matrices xb e yb del mismo tamaño, de modo que plot(xb,yb) representa la gráfica de escalones.

Esta sintaxis no es compatible con los argumentos tabla y variables de tabla.

Ejemplos

Representar una única serie de datos

Cree una gráfica de escalones de seno evaluado en 40 valores equidistantes entre 0 y $$4\pi$$.

X = linspace(0,4*pi,40);
Y = sin(X);

figure
stairs(Y)

La longitud de Y determina automáticamente y genera la escala del eje x.

Representar múltiples series de datos

Cree una gráfica de escalones de dos funciones de coseno evaluadas en 50 valores equidistantes entre 0 y $$4\pi$$.

X = linspace(0,4*pi,50)';
Y = [0.5*cos(X), 2*cos(X)];

figure
stairs(Y)

El número de filas en Y determina automáticamente y genera la escala del eje x.

Representar una única serie de datos en valores x especificados

Cree una gráfica de escalones de una onda sinusoidal evaluada en valores equidistantes entre 0 y $$4\pi$$. Especifique el conjunto de valores x para la gráfica.

X = linspace(0,4*pi,40);
Y = sin(X);

figure
stairs(X,Y)

Las entradas de Y se representan con respecto a las entradas correspondientes de X.

Representar múltiples series de datos en valores x especificados

Cree una gráfica de escalones de dos ondas de coseno evaluadas en valores equidistantes entre 0 y $$4\pi$$. Especifique el conjunto de valores x para la gráfica.

X = linspace(0,4*pi,50)';
Y = [0.5*cos(X), 2*cos(X)];

figure
stairs(X,Y)

La primera entrada de vector, X, determina las posiciones del eje x para ambas series de datos.

Representar múltiples series de datos en conjuntos de valores x únicos

Cree una gráfica de escalones de dos ondas sinusoidales evaluadas en valores diferentes. Especifique un conjunto único de valores x para representar cada serie de datos.

x1 = linspace(0,2*pi)';
x2 = linspace(0,pi)';
X = [x1,x2];
Y = [sin(5*x1),exp(x2).*sin(5*x2)];

figure
stairs(X,Y)

Cada columna de X se representa con respecto a la columna correspondiente de Y.

Especificar estilos de línea, símbolos de marcador y colores

Cree una gráfica de escalones y establezca el estilo de línea en una línea discontinua, el símbolo de marcador en círculos y el color en rojo.

X = linspace(0,4*pi,20);
Y = sin(X);

figure
stairs(Y, '-.or')

Especificar opciones de estilo adicionales

Cree una gráfica de escalones y establezca la anchura de línea en 2, los símbolos de marcador en diamantes y el color de la cara del marcador en cian usando argumentos de par Name,Value.

X = linspace(0,4*pi,20);
Y = sin(X);

figure
stairs(Y,'LineWidth',2,'Marker','d','MarkerFaceColor','c')

Representar datos desde una tabla

Desde R2022b

Una forma práctica de representar datos desde una tabla es pasar la tabla a la función stairs y especificar las variables que se desea representar.

Lea las primeras 100 filas y 7 columnas de weather.csv como horario tbl. Después, muestre las primeras tres filas de la tabla.

tbl = readtimetable("weather.csv","Range",[1 1 101 7]);
head(tbl,3)

            Time            WindDirection    WindSpeed    Humidity    Temperature    RainInchesPerMinute    CumulativeRainfall
    ____________________    _____________    _________    ________    ___________    ___________________    __________________

    25-Oct-2021 00:00:09         46               1          84          49.2                 0                     0         
    25-Oct-2021 00:01:09         45             1.6          84          49.2                 0                     0         
    25-Oct-2021 00:02:09         36             2.2          84          49.2                 0                     0         

Represente la variable Time en el eje x y la variable CumulativeRainfall en el eje y. Después, utilice el comando axis padded para que la línea y el cuadro de la gráfica no se solapen.

Devuelva el objeto Stair como h. Observe que las etiquetas de los ejes coinciden con los nombres de las variables.

h = stairs(tbl,"Time","CumulativeRainfall");
axis padded

Modifique el color de la línea a morado configurando la propiedad Color.

h.Color = [0.5 0 0.8];

Representar múltiples variables de tabla en un eje

Desde R2022b

Cree los vectores x, y1 e y2 y utilícelos para crear una tabla. Represente las variables y1 e y2 con respecto a la variable x. Utilice el comando axis padded para que la línea y el cuadro de la gráfica no se solapen.

Añada una leyenda y observe que las etiquetas de las leyendas coinciden con los nombres de las variables.

x = linspace(0,6,20);
y1 = cos(x);
y2 = sin(x);
tbl = table(x,y1,y2);
stairs(tbl,"x",["y1","y2"]);

% Pad x- and y-axes, and add legend
axis padded
legend

También puede omitir la variable x y representar las variables y1 e y2 con respecto a los índices de fila de la tabla.

stairs(tbl,["y1","y2"]);
axis padded
legend

Especificar los ejes para una gráfica de escalones

Puede mostrar un mosaico de gráficas utilizando las funciones tiledlayout y nexttile. Llame a la función tiledlayout para crear un diseño de gráfica en mosaico de 2 por 1. Llame a la función nexttile para crear los objetos de ejes ax1 y ax2. Cree gráficas separadas de escalones en los ejes especificando el objeto de ejes como primer argumento en stairs.

x = linspace(0,2*pi);
y1 = 5*sin(x);
y2 = sin(5*x);
tiledlayout(2,1)

% Top plot
ax1 = nexttile;
stairs(ax1,x,y1)

% Bottom plot
ax2 = nexttile;  
stairs(ax2,x,y2)

Modificar una gráfica de escalones después de crearla

Cree una gráfica de escalones de dos series de datos y devuelva los dos objetos stair.

X = linspace(0,1,30)';
Y = [cos(10*X), exp(X).*sin(10*X)];
h = stairs(X,Y);

Utilice marcadores circulares pequeños para la primera serie de datos. Utilice círculos magenta rellenos para la segunda serie. Utilice la notación de puntos para establecer las propiedades.

h(1).Marker = 'o';
h(1).MarkerSize = 4;
h(2).Marker = 'o';
h(2).MarkerFaceColor = 'm';

Crear una gráfica de escalones con la función plot

Evalúe dos funciones de coseno en 50 valores equidistantes entre 0 y $$4\pi$$ y cree una gráfica de escalones con plot.

X = linspace(0,4*pi,50)';
Y = [0.5*cos(X), 2*cos(X)];
[xb,yb] = stairs(X,Y);

stairs devuelve dos matrices del mismo tamaño, xb e yb, pero ninguna gráfica.

Utilice plot para crear la gráfica de escalones con xb e yb.

figure
plot(xb,yb)

Argumentos de entrada

Y — valores y

vector o matriz

valores y, especificados como vector o matriz. Cuando Y es un vector, stairs crea un objeto stair. Cuando Y es una matriz, stairs dibuja una línea por cada columna de la matriz y crea un objeto stair separado para cada columna.

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

X — valores x

vector o matriz

valores x, especificados como vector o matriz. Cuando Y es un vector, X debe ser un vector del mismo tamaño. Cuando Y es una matriz, X debe ser una matriz del mismo tamaño, o un vector cuya longitud sea igual al número de filas en Y.

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

LineSpec — Estilo de línea, marcador y color

escalar de cadena | vector de caracteres

Estilo de línea, marcador y color, especificados como un escalar de cadena o un vector de caracteres 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). Por ejemplo, si se omite el estilo de línea y se especifica el marcador, la gráfica muestra solo el marcador y ninguna línea.

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]

tbl — Tabla de origen

tabla | horario

Tabla de origen que contiene los datos que se desea representar, especificada como tabla u horario.

yvar — Variables de tabla que contienen coordenadas y

arreglo de cadenas | vector de caracteres | arreglo de celdas | patrón | escalar numérico o vector | vector lógico | vartype()

Variables de tabla que contienen las coordenadas y, especificadas utilizando uno de los esquemas de indexación de la tabla.

Esquema de indexación	Ejemplos
Nombres de variables: Una cadena, vector de caracteres o arreglo de celdas. Un objeto pattern.	"A" o 'A': una variable llamada A ["A","B"] o {'A','B'}: dos variables llamadas A y B "Var"+digitsPattern(1): variables cuyo nombre empieza por "Var" seguido de un solo dígito
Índice de variable: Un número de índice que se refiere a la ubicación de una variable en la tabla. Un vector de números. Un vector lógico. Normalmente, este vector es de la misma longitud que el número de variables, pero puede omitir los valores 0 o false al final.	3: la tercera variable de la tabla [2 3]: la segunda y la tercera variable de la tabla [false false true]: la tercera variable
Tipo de variable: Un subíndice vartype que selecciona variables de un tipo especificado.	vartype("categorical"): todas las variables que contienen valores categóricos

Las variables de tabla que especifique pueden contener valores numéricos, categóricos, de fecha/hora y de duración. Si xvar e yvar especifican múltiples variables, el número de variables debe ser el mismo.

Ejemplo: stairs(tbl,"x",["y1","y2"]) especifica las variables de tabla llamadas y1 e y2 para las coordenadas y.

Ejemplo: stairs(tbl,"x",2) especifica la segunda variable para las coordenadas y.

Ejemplo: stairs(tbl,"x",vartype("numeric")) especifica todas las variables numéricas para las coordenadas y.

xvar — Variables de tabla que contienen coordenadas x

arreglo de cadenas | vector de caracteres | arreglo de celdas | patrón | escalar numérico o vector | vector lógico | vartype()

Variables de tabla que contienen las coordenadas x, especificadas utilizando uno de los esquemas de indexación de la tabla.

Esquema de indexación	Ejemplos
Nombres de variables: Una cadena, vector de caracteres o arreglo de celdas. Un objeto pattern.	"A" o 'A': una variable llamada A ["A","B"] o {'A','B'}: dos variables llamadas A y B "Var"+digitsPattern(1): variables cuyo nombre empieza por "Var" seguido de un solo dígito
Índice de variable: Un número de índice que se refiere a la ubicación de una variable en la tabla. Un vector de números. Un vector lógico. Normalmente, este vector es de la misma longitud que el número de variables, pero puede omitir los valores 0 o false al final.	3: la tercera variable de la tabla [2 3]: la segunda y la tercera variable de la tabla [false false true]: la tercera variable
Tipo de variable: Un subíndice vartype que selecciona variables de un tipo especificado.	vartype("categorical"): todas las variables que contienen valores categóricos

Las variables de tabla que especifique pueden contener valores numéricos, categóricos, de fecha/hora y de duración. Si xvar e yvar especifican múltiples variables, el número de variables debe ser el mismo.

Ejemplo: stairs(tbl,["x1","x2"],"y") especifica las variables de tabla llamadas x1 y x2 para las coordenadas x.

Ejemplo: stairs(tbl,2,"y") especifica la segunda variable para las coordenadas x.

Ejemplo: stairs(tbl,vartype("numeric"),"y") especifica todas las variables numéricas para las coordenadas x.

ax — objeto Axes

objeto Axes

Objeto Axes. Si no especifica los ejes, stairs 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: "Marker","s","MarkerFaceColor","red" representa la gráfica de escalones con marcadores cuadrados rojos.

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

LineStyle — Estilo de línea

"-" (predeterminado) | "--" | ":" | "-." | "none"

Estilo de línea, especificado como una de las opciones enumeradas en esta tabla.

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
"none"	Sin línea	Sin línea

LineWidth — Ancho de línea

0.5 (predeterminado) | valor positivo

Ancho de línea, especificado como valor positivo en puntos, donde 1 punto = 1/72 de pulgada (0,035 cm). Si la línea tiene marcadores, el ancho de línea también afecta a los bordes de los marcadores.

El ancho de línea no puede ser inferior al de un píxel. Si establece el ancho de línea en un valor inferior al ancho de un píxel en su sistema, la línea se muestra igual de ancha que un píxel.

Color — Color de línea

Triplete RGB | código de color hexadecimal | "r" | "g" | "b" | ...

Color de línea, especificado como triplete RGB, código de color hexadecimal, nombre de color o nombre corto.

Para definir un color personalizado, especifique un triplete RGB o un código de color hexadecimal.

• Un triplete RGB es un vector fila de tres elementos, cuyos elementos especifican las intensidades de los componentes rojo, verde y azul del color. Las intensidades deben estar en el rango [0,1], por ejemplo [0.4 0.6 0.7].

• Un código de color hexadecimal es un escalar de cadena o un vector de caracteres que comienza con el símbolo de almohadilla (#) seguido de tres o seis dígitos hexadecimales, que pueden oscilar entre 0 y F. Los valores no distinguen entre mayúsculas y minúsculas. Por lo tanto, los códigos de color "#FF8800", "#ff8800", "#F80" y "#f80" son equivalentes.

Como alternativa, puede especificar algunos colores frecuentes por su nombre. En esta tabla, se enumeran las opciones de color con su nombre, los tripletes RGB equivalentes y los códigos de color hexadecimales.

Nombre del color	Nombre corto	Triplete RGB	Código de color hexadecimal	Apariencia
"red"	"r"	[1 0 0]	"#FF0000"
"green"	"g"	[0 1 0]	"#00FF00"
"blue"	"b"	[0 0 1]	"#0000FF"
"cyan"	"c"	[0 1 1]	"#00FFFF"
"magenta"	"m"	[1 0 1]	"#FF00FF"
"yellow"	"y"	[1 1 0]	"#FFFF00"
"black"	"k"	[0 0 0]	"#000000"
"white"	"w"	[1 1 1]	"#FFFFFF"
"none"	No se aplica	No se aplica	No se aplica	Sin color

En esta tabla, se enumeran las paletas de colores predeterminados para las gráficas en los temas claro y oscuro.

Paleta	Colores de la paleta
"gem": tema claro predeterminado Antes de R2025a: La mayoría de las gráficas utilizan estos colores de forma predeterminada.
"glow": tema oscuro predeterminado

Puede obtener los tripletes RGB y los códigos de color hexadecimales de estas paletas usando las funciones orderedcolors y rgb2hex. Por ejemplo, puede obtener los tripletes RGB de la paleta "gem" y convertirlos en códigos de color hexadecimales.

RGB = orderedcolors("gem");
H = rgb2hex(RGB);

Antes de R2023b: Obtenga los tripletes RGB usando RGB = get(groot,"FactoryAxesColorOrder").

Antes de R2024a: Obtenga los códigos de color hexadecimales usando H = compose("#%02X%02X%02X",round(RGB*255)).

Ejemplo: "blue"

Ejemplo: [0 0 1]

Ejemplo: "#0000FF"

Marker — Símbolo de marcador

"none" (predeterminado) | "o" | "+" | "*" | "." | ...

Símbolo de marcador, especificado como uno de los valores enumerados en esta tabla. De forma predeterminada, el objeto no muestra marcadores. La especificación de un símbolo de marcador agrega marcadores en todos los puntos de datos o vértices.

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
"none"	Sin marcadores	No se aplica

MarkerSize — Tamaño del marcador

6 (predeterminado) | valor positivo

Tamaño del marcador, especificado como valor positivo en puntos, donde 1 punto = 1/72 de pulgada (0,035 cm).

MarkerEdgeColor — Color del contorno del marcador

"auto" (predeterminado) | Triplete RGB | código de color hexadecimal | "r" | "g" | "b" | ...

Color del contorno del marcador, especificado como "auto", triplete RGB, código de color hexadecimal, nombre de color o nombre corto. El valor predeterminado de "auto" utiliza el mismo color que la propiedad Color.

Para definir un color personalizado, especifique un triplete RGB o un código de color hexadecimal.

• Un triplete RGB es un vector fila de tres elementos, cuyos elementos especifican las intensidades de los componentes rojo, verde y azul del color. Las intensidades deben estar en el rango [0,1], por ejemplo [0.4 0.6 0.7].

• Un código de color hexadecimal es un escalar de cadena o un vector de caracteres que comienza con el símbolo de almohadilla (#) seguido de tres o seis dígitos hexadecimales, que pueden oscilar entre 0 y F. Los valores no distinguen entre mayúsculas y minúsculas. Por lo tanto, los códigos de color "#FF8800", "#ff8800", "#F80" y "#f80" son equivalentes.

Como alternativa, puede especificar algunos colores frecuentes por su nombre. En esta tabla, se enumeran las opciones de color con su nombre, los tripletes RGB equivalentes y los códigos de color hexadecimales.

Nombre del color	Nombre corto	Triplete RGB	Código de color hexadecimal	Apariencia
"red"	"r"	[1 0 0]	"#FF0000"
"green"	"g"	[0 1 0]	"#00FF00"
"blue"	"b"	[0 0 1]	"#0000FF"
"cyan"	"c"	[0 1 1]	"#00FFFF"
"magenta"	"m"	[1 0 1]	"#FF00FF"
"yellow"	"y"	[1 1 0]	"#FFFF00"
"black"	"k"	[0 0 0]	"#000000"
"white"	"w"	[1 1 1]	"#FFFFFF"
"none"	No se aplica	No se aplica	No se aplica	Sin color

En esta tabla, se enumeran las paletas de colores predeterminados para las gráficas en los temas claro y oscuro.

Paleta	Colores de la paleta
"gem": tema claro predeterminado Antes de R2025a: La mayoría de las gráficas utilizan estos colores de forma predeterminada.
"glow": tema oscuro predeterminado

Puede obtener los tripletes RGB y los códigos de color hexadecimales de estas paletas usando las funciones orderedcolors y rgb2hex. Por ejemplo, puede obtener los tripletes RGB de la paleta "gem" y convertirlos en códigos de color hexadecimales.

RGB = orderedcolors("gem");
H = rgb2hex(RGB);

Antes de R2023b: Obtenga los tripletes RGB usando RGB = get(groot,"FactoryAxesColorOrder").

Antes de R2024a: Obtenga los códigos de color hexadecimales usando H = compose("#%02X%02X%02X",round(RGB*255)).

MarkerFaceColor — Color de relleno del marcador

"none" (predeterminado) | "auto" | Triplete RGB | código de color hexadecimal | "r" | "g" | "b" | ...

Color de relleno del marcador, especificado como "auto", triplete RGB, código de color hexadecimal, nombre de color o nombre corto. La opción "auto" utiliza el mismo color que la propiedad Color de los ejes principales. Si se especifica "auto" y el cuadro de la gráfica de ejes es invisible, el color de relleno del marcador es el color de la figura.

Para definir un color personalizado, especifique un triplete RGB o un código de color hexadecimal.

• Un triplete RGB es un vector fila de tres elementos, cuyos elementos especifican las intensidades de los componentes rojo, verde y azul del color. Las intensidades deben estar en el rango [0,1], por ejemplo [0.4 0.6 0.7].

• Un código de color hexadecimal es un escalar de cadena o un vector de caracteres que comienza con el símbolo de almohadilla (#) seguido de tres o seis dígitos hexadecimales, que pueden oscilar entre 0 y F. Los valores no distinguen entre mayúsculas y minúsculas. Por lo tanto, los códigos de color "#FF8800", "#ff8800", "#F80" y "#f80" son equivalentes.

Como alternativa, puede especificar algunos colores frecuentes por su nombre. En esta tabla, se enumeran las opciones de color con su nombre, los tripletes RGB equivalentes y los códigos de color hexadecimales.

Nombre del color	Nombre corto	Triplete RGB	Código de color hexadecimal	Apariencia
"red"	"r"	[1 0 0]	"#FF0000"
"green"	"g"	[0 1 0]	"#00FF00"
"blue"	"b"	[0 0 1]	"#0000FF"
"cyan"	"c"	[0 1 1]	"#00FFFF"
"magenta"	"m"	[1 0 1]	"#FF00FF"
"yellow"	"y"	[1 1 0]	"#FFFF00"
"black"	"k"	[0 0 0]	"#000000"
"white"	"w"	[1 1 1]	"#FFFFFF"
"none"	No se aplica	No se aplica	No se aplica	Sin color

En esta tabla, se enumeran las paletas de colores predeterminados para las gráficas en los temas claro y oscuro.

Paleta	Colores de la paleta
"gem": tema claro predeterminado Antes de R2025a: La mayoría de las gráficas utilizan estos colores de forma predeterminada.
"glow": tema oscuro predeterminado

Puede obtener los tripletes RGB y los códigos de color hexadecimales de estas paletas usando las funciones orderedcolors y rgb2hex. Por ejemplo, puede obtener los tripletes RGB de la paleta "gem" y convertirlos en códigos de color hexadecimales.

RGB = orderedcolors("gem");
H = rgb2hex(RGB);

Antes de R2023b: Obtenga los tripletes RGB usando RGB = get(groot,"FactoryAxesColorOrder").

Antes de R2024a: Obtenga los códigos de color hexadecimales usando H = compose("#%02X%02X%02X",round(RGB*255)).

Argumentos de salida

h — objetos Stair

objetos Stair

objetos Stair. Son identificadores únicos que pueden utilizarse para consultar y modificar las propiedades de un objeto Stair concreto después de crearlo.

xb — valores x para su uso con plot

vector o matriz

valores x para su uso con plot, devueltos como vector o matriz. xb contiene los valores adecuados, de modo que plot(xb,yb) crea la gráfica de escalones.

yb — valores y para su uso con plot

vector o matriz

valores y para su uso con plot, devueltos como vector o matriz. yb contiene los valores adecuados, de modo que plot(xb,yb) crea la gráfica de escalones.

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 stairs 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

R2022b: Pasar tablas directamente a stairs

Cree gráficas pasando una tabla a la función stairs seguida de las variables que se desea representar. Cuando especifica los datos como una tabla, las etiquetas de los ejes y la leyenda (en su caso) se etiquetan automáticamente utilizando los nombres de las variables de la tabla.

Consulte también

Funciones

• bar | histogram | stem

Propiedades

• Stair Properties

Temas

• Plot Dates and Times
• Representar datos categóricos
• Plots That Support Tables