scatter

Diagrama de dispersión

• 

Sintaxis

scatter(x,y)

scatter(x,y,sz)

scatter(x,y,sz,c)

scatter(___,"filled")

scatter(___,mkr)

scatter(tbl,xvar,yvar)

scatter(tbl,xvar,yvar,"filled")

scatter(ax,___)

scatter(___,Name,Value)

s = scatter(___)

Descripción

Datos de vectores y matrices

scatter(x,y) crea un diagrama de dispersión con marcadores circulares en las ubicaciones especificadas por los vectores x e y.

• Para representar un grupo de coordenadas, especifique x e y como vectores de la misma longitud.

• Para representar múltiples grupos de coordenadas en el mismo conjunto de ejes, especifique al menos x o y como matriz.

scatter(x,y,sz) especifica el tamaño de los círculos. Para utilizar el mismo tamaño para todos los círculos, especifique sz como escalar. Para representar cada círculo con un tamaño diferente, especifique sz como vector o matriz.

scatter(x,y,sz,c) especifica los colores de los círculos. Puede especificar un color para todos los círculos o diferentes colores. Por ejemplo, puede representar todos los círculos en rojo, especificando c como "red".

scatter(___,"filled") rellena los círculos. Utilice la opción "filled" con cualquiera de las combinaciones de argumentos de entrada de las sintaxis anteriores.

scatter(___,mkr) especifica el tipo de marcador.

Datos de tabla

scatter(tbl,xvar,yvar) representa las variables xvar y yvar desde la tabla tbl. Para representar un conjunto de datos, especifique una variable para xvar y una variable para yvar. Para representar varios conjuntos de datos, especifique múltiples variables para xvar, yvar o ambas. Si ambos argumentos especifican múltiples variables, deben especificar el mismo número de variables. (Desde la versión R2021b)

scatter(tbl,xvar,yvar,"filled") representa las variables especificadas desde la tabla con los círculos rojos rellenos. (Desde la versión R2021b)

Otras opciones

scatter(ax,___) representa en los ejes que especifica ax en lugar de en los ejes actuales. La opción ax puede preceder a cualquiera de las combinaciones de argumentos de entrada de las sintaxis anteriores.

scatter(___,Name,Value) modifica el diagrama de dispersión utilizando uno o más argumentos nombre-valor para establecer las propiedades. Por ejemplo:

• scatter(x,y,"LineWidth",2) crea un diagrama de dispersión con contornos de marcadores de 2 puntos.

• scatter(tbl,"MyX","MyY","ColorVariable","MyColors") crea un diagrama de dispersión a partir de los datos de una tabla y personaliza los colores de los marcadores utilizando los datos de la tabla.

Para obtener una lista completa de las propiedades, consulte Scatter Properties.

s = scatter(___) devuelve el objeto Scatter o un arreglo de objetos Scatter. Use s para establecer las propiedades después de crear el diagrama. Para obtener una lista completa de las propiedades, consulte Scatter Properties.

Ejemplos

Crear diagrama de dispersión

Cree x como 200 valores equidistantes entre 0 y $$3\pi$$. Cree y como valores del coseno con ruido aleatorio. Después, cree un diagrama de dispersión.

x = linspace(0,3*pi,200);
y = cos(x) + rand(1,200);  
scatter(x,y)

Modificar el tamaño de los círculos

Cree un diagrama de dispersión usando círculos de diferentes tamaños. Especifique el tamaño en puntos cuadrados

x = linspace(0,3*pi,200);
y = cos(x) + rand(1,200);
sz = linspace(1,100,200);
scatter(x,y,sz)

Los elementos correspondientes en x, y y sz determinan la ubicación y el tamaño de cada círculo. Para representar todos los círculos con la misma área, especifique sz como escalar numérico.

Modificar el color de los círculos

Cree un diagrama de dispersión y modifique el color de los círculos.

x = linspace(0,3*pi,200);
y = cos(x) + rand(1,200);
c = linspace(1,10,length(x));
scatter(x,y,[],c)

Los elementos correspondientes en x, y y c determinan la ubicación y el color de cada círculo. La función scatter asigna los elementos en c a colores del mapa de colores actual.

Variar la paleta de colores

Desde R2023b

Las paletas de colores con nombre ofrecen una forma cómoda de cambiar los colores de una gráfica. Este ejemplo compara un diagrama de dispersión con tres paletas de colores diferentes.

Cree un diagrama de dispersión de números aleatorios usando la paleta predeterminada.

x = rand(50,5);
y = randn(50,5) + (5:5:25);
scatter(x,y,"filled")

Cambie la paleta de color a reef mediante la función colororder.

colororder("reef")

Cambie la paleta de color a meadow.

colororder("meadow")

Rellenar los marcadores

Cree un diagrama de dispersión y rellene los marcadores. scatter rellena cada marcador usando el color del borde de dicho marcador.

x = linspace(0,3*pi,200);
y = cos(x) + rand(1,200);
sz = 25;
c = linspace(1,10,length(x));
scatter(x,y,sz,c,'filled')

Especificar el símbolo de marcador

Cree vectores x e y como valores del seno y el coseno de con ruido aleatorio. Después, cree un diagrama de dispersión y utilice marcadores en forma de rombo con un área de 140 puntos cuadrados.

theta = linspace(0,2*pi,150);
x = sin(theta) + 0.75*rand(1,150);
y = cos(theta) + 0.75*rand(1,150);  
sz = 140;
scatter(x,y,sz,'d')

Cambiar el color del marcador y el ancho de línea

Cree vectores x e y como valores del seno y el coseno de con ruido aleatorio. Cree un diagrama de dispersión y establezca el color del borde del marcador, el color de la cara del marcador y el ancho de línea.

theta = linspace(0,2*pi,300);
x = sin(theta) + 0.75*rand(1,300);
y = cos(theta) + 0.75*rand(1,300);  
sz = 40;
scatter(x,y,sz,'MarkerEdgeColor',[0 .5 .5],...
              'MarkerFaceColor',[0 .7 .7],...
              'LineWidth',1.5)

Modificar la transparencia entre puntos de datos

Puede variar la transparencia de puntos dispersos estableciendo la propiedad AlphaData en un vector de diferentes valores de opacidad. Para garantizar que el diagrama de dispersión utiliza los valores AlphaData, establezca la propiedad MarkerFaceAlpha en 'flat'.

Cree un conjunto de números aleatorios distribuidos de manera normal. A continuación, cree un diagrama de dispersión de los datos con marcadores rellenos.

x = randn(1000,1);
y = randn(1000,1);
s = scatter(x,y,'filled');

Establezca la opacidad de cada punto en función de su distancia desde cero.

distfromzero = sqrt(x.^2 + y.^2);
s.AlphaData = distfromzero;
s.MarkerFaceAlpha = 'flat';

Representar datos desde una tabla

Desde la versión R2021b

Una forma práctica de representar datos desde una tabla es pasar la tabla a la función scatter y especificar las variables que se desea representar. Por ejemplo, lea patients.xls como tabla tbl. Represente la relación entre las variables Systolic y Diastolic pasando tbl como primer argumento a la función scatter seguido de los nombres de las variables. Observe que las etiquetas de los ejes coinciden con los nombres de las variables.

tbl = readtable('patients.xls');
scatter(tbl,'Systolic','Diastolic');

También se pueden representar múltiples variables al mismo tiempo. Por ejemplo, represente ambas variables de presión arterial frente a la variable Weight, especificando el argumento yvar como arreglo de celdas {'Systolic','Diastolic'}. Añada una leyenda y observe que las etiquetas de las leyendas coinciden con los nombres de las variables.

scatter(tbl,'Weight',{'Systolic','Diastolic'});
legend

Representar datos de tabla con colores y tamaños de marcador personalizados

Desde la versión R2021b

Una forma de representar los datos de una tabla y personalizar los colores y tamaños de los marcadores es establecer las propiedades ColorVariable y SizeData. Puede establecer estas propiedades como argumentos nombre-valor cuando llame a la función scatter, o puede establecerlas en el objeto Scatter más adelante.

Por ejemplo, lea patients.xls como tabla tbl. Represente la variable Height frente a la variable Weight con marcadores rellenos. Modifique los colores de los marcadores, especificando el argumento de par nombre-valor ColorVariable. Devuelva el objeto Scatter como s, de forma que pueda establecer otras propiedades más tarde.

tbl = readtable('patients.xls');
s = scatter(tbl,'Weight','Height','filled','ColorVariable','Diastolic');

Modifique el tamaño de los marcadores a 100 puntos, estableciendo la propiedad SizeData. A continuación, añada una barra de colores.

s.SizeData = 100;
colorbar

Especificar ejes objetivo y tipo de marcadores

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. Represente datos dispersos en cada eje. En el diagrama de dispersión inferior, especifique marcadores en forma de rombo rellenos.

x = linspace(0,3*pi,200);
y = cos(x) + rand(1,200);
tiledlayout(2,1)

% Top plot
ax1 = nexttile;
scatter(ax1,x,y)

% Bottom plot
ax2 = nexttile;
scatter(ax2,x,y,'filled','d')

Modificar series de dispersión después de crearlas

Cree un diagrama de dispersión y devuelva el objeto de serie de dispersión, s.

theta = linspace(0,1,500);
x = exp(theta).*sin(100*theta);
y = exp(theta).*cos(100*theta);
s = scatter(x,y);

Use s para consultar y establecer las propiedades de la serie de dispersión después de crearla. Establezca el ancho de línea en 0.6 puntos. Establezca el color del borde del marcador en azul. Establezca el color de la cara del marcador utilizando un color del triplete RGB.

s.LineWidth = 0.6;
s.MarkerEdgeColor = 'b';
s.MarkerFaceColor = [0 0.5 0.5];

Argumentos de entrada

x — Coordenadas x

escalar | vector | matriz

Coordenadas x, especificadas como escalar, vector o matriz. La forma y el tamaño de x dependen de la forma de los datos. Esta tabla describe las situaciones más habituales.

Tipo de gráfica	Cómo especificar las coordenadas
Punto único	Especifique x e y como escalares. Por ejemplo: scatter(1,2)
Un grupo de puntos	Especifique x e y como cualquier combinación de vectores fila o columna de la misma longitud. Por ejemplo: scatter([1 2 3],[4; 5; 6])
Múltiples grupos de puntos de diferentes colores	Si todos los grupos comparten las mismas coordenadas x o y, especifique las coordenadas compartidas como vector y las demás coordenadas, como matriz. La longitud del vector debe coincidir con una de las dimensiones de la matriz. Por ejemplo: scatter([1 2 3],[4 5 6; 7 8 9]) Si la matriz es cuadrada, scatter representa un grupo de puntos por cada columna de la matriz. De forma alternativa, especifique x e y como matrices del mismo tamaño. En este caso, scatter representa cada columna de y con respecto a la columna correspondiente de x. Por ejemplo: scatter([1 3 5; 2 4 6],[10 25 45; 20 40 60])

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

y — Coordenadas y

escalar | vector | matriz

Coordenadas y, especificadas como escalar, vector o matriz. La forma y el tamaño de y dependen de la forma de los datos. Esta tabla describe las situaciones más habituales.

Tipo de gráfica	Cómo especificar las coordenadas
Punto único	Especifique x e y como escalares. Por ejemplo: scatter(1,2)
Un grupo de puntos	Especifique x e y como cualquier combinación de vectores fila o columna de la misma longitud. Por ejemplo: scatter([1 2 3],[4; 5; 6])
Múltiples grupos de puntos de diferentes colores	Si todos los grupos comparten las mismas coordenadas x o y, especifique las coordenadas compartidas como vector y las demás coordenadas, como matriz. La longitud del vector debe coincidir con una de las dimensiones de la matriz. Por ejemplo: scatter([1 2 3],[4 5 6; 7 8 9]) Si la matriz es cuadrada, scatter representa un grupo de puntos por cada columna de la matriz. De forma alternativa, especifique x e y como matrices del mismo tamaño. En este caso, scatter representa cada columna de y con respecto a la columna correspondiente de x. Por ejemplo: scatter([1 3 5; 2 4 6],[10 25 45; 20 40 60])

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

sz — Tamaño del marcador

36 (predeterminado) | escalar numérico | vector fila o columna | matriz | []

Tamaño del marcador, especificado como escalar numérico, vector, matriz o arreglo vacío ([]). El tamaño controla el área de cada marcador en puntos cuadrados. Un arreglo vacío especifica el tamaño predeterminado de 36 puntos. La forma de especificar el tamaño depende de cómo especifique x e y, y de cómo desea que sea el diagrama. Esta tabla describe las situaciones más habituales.

Tamaños de marcador deseados	x y y	sz	Ejemplo
Mismo tamaño para todos los puntos	Cualquier combinación válida de vectores o matrices descritas para x e y.	Escalar	Especifique x como vector, y como matriz y sz como escalar. x = [1 2 3 4]; y = [1 6; 3 8; 2 7; 4 9]; scatter(x,y,100)
Tamaño diferente para cada punto	Vectores de la misma longitud	Un vector con la misma longitud que x e y. Una matriz con al menos una dimensión que coincide con las longitudes de x e y. Especificar una matriz resulta útil para mostrar múltiples marcadores con diferentes tamaños en cada ubicación (x,y).	Especifique x, y y sz como vectores. x = [1 2 3 4]; y = [1 3 2 4]; sz = [80 150 700 50]; scatter(x,y,sz) Especifique x e y como vectores y sz como una matriz. x = [1 2 3 4]; y = [1 3 2 4]; sz = [80 30; 150 900; 50 2000; 200 350]; scatter(x,y,sz)
Tamaño diferente para cada punto	Al menos uno de x o y es una matriz para representar múltiples conjuntos de datos	Un vector con el mismo número de elementos que puntos de cada conjunto de datos. Una matriz que tiene el mismo tamaño que la matriz x o y.	Especifique x como vector, y como matriz y sz como vector. x = [1 2 3 4]; y = [1 6; 3 8; 2 7; 4 9]; sz = [80 150 50 700]; scatter(x,y,sz) Especifique x como vector, y como matriz y sz como matriz del mismo tamaño que y. x = [1 2 3 4]; y = [1 6; 3 8; 2 7; 4 9]; sz = [80 30; 150 900; 50 2000; 200 350]; scatter(x,y,sz)

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

c — Color del marcador

nombre del color | Triplete RGB | matriz de tripletes RGB | vector de índices del mapa de colores

Color del marcador, especificado como nombre de color, triplete RGB, matriz de tripletes RGB o vector de índices del mapa de colores.

• Nombre del color: el nombre de un color como "red" o un nombre corto, como "r".

• Triplete RGB: 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]. Los tripletes RGB resultan útiles para crear colores personalizados.

• Matriz de tripletes RGB: matriz de tres columnas en la que cada fila es un triplete RGB.

• Vector de índices del mapa de colores: vector de valores numéricos que tiene la misma longitud que los vectores x e y.

La forma de especificar el color depende del esquema de colores deseado y de si representa un conjunto de coordenadas o varios conjuntos de coordenadas. Esta tabla describe las situaciones más habituales.

Esquema de colores	Cómo especificar el color	Ejemplo
Utilizar un color para todos los puntos.	Especifique un nombre de color o un nombre corto de la tabla siguiente, o especifique un triplete RGB.	Represente un conjunto de puntos y especifique el color como "red". scatter(1:4,[2 5 3 7],[],"red") Represente dos conjuntos de puntos y especifique el color como rojo, usando un triplete RGB. scatter(1:4,[2 5; 1 2; 8 4; 11 9],[],[1 0 0])
Asignar diferentes colores a cada punto utilizando un mapa de colores.	Especifique un vector fila o columna de números. Los números se asignan al arreglo del mapa de colores actual. El valor más pequeño se asigna a la primera fila del mapa de colores, mientras que el valor más grande se asigna a la última fila. Los valores intermedios se asignan de forma lineal a las filas intermedias. Si el diagrama tiene tres puntos, especifique un vector columna para asegurarse de que los valores se interpretan como índices del mapa de colores. Solo se puede utilizar este método cuando x, y y sz son vectores.	Cree un vector c que especifique cuatro índices del mapa de colores. Represente cuatro puntos utilizando los colores del mapa de colores actual. A continuación, cambie el mapa de colores a winter. c = 1:4; scatter(1:4,[2 5 3 7],[],c) colormap(gca,"winter")
Crear un color personalizado para cada punto.	Especifique una matriz de m por 3 de tripletes RGB, donde m es el número de puntos del diagrama. Solo se puede utilizar este método cuando x, y y sz son vectores.	Cree una matriz c que especifique los tripletes RGB para el verde, el rojo, el gris y el púrpura. A continuación, cree un diagrama de dispersión de cuatro puntos utilizando esos colores. c = [0 1 0; 1 0 0; 0.5 0.5 0.5; 0.6 0 1]; scatter(1:4,[2 5 3 7],[],c)
Crear un color diferente para cada conjunto de datos.	Especifique una matriz de n por 3 de tripletes RGB, donde n es el número de conjuntos de datos. Solo se puede utilizar este método cuando al menos uno de x, y o sz es una matriz.	Cree una matriz c que contenga dos tripletes RGB. A continuación, represente dos conjuntos de datos utilizando esos colores. c = [1 0 0; 0.6 0 1]; s = scatter(1:4,[2 5; 1 2; 8 4; 11 9],[],c)

Nombres de los colores y tripletes RGB para colores comunes

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"

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)).

mkr — Símbolo de marcador

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

Símbolo de marcador, especificado como uno de los valores enumerados en esta tabla.

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

"filled" — Opción para rellenar el interior de los marcadores

"filled"

Opción para rellenar el interior de los marcadores, especificada como "filled". Utilice esta opción con los marcadores que tienen una cara, por ejemplo, "o" o "square". Los marcadores que no tienen cara y solo contienen bordes no se dibujan ("+", "*", "." y "x").

La opción "filled" establece la propiedad MarkerFaceColor del objeto Scatter como "flat" y la propiedad MarkerEdgeColor como "none", de modo que las caras del marcador se dibujan, pero los bordes no.

tbl — Tabla de origen

tabla | horario

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

xvar — Variables de tabla que contienen coordenadas x

uno o más índices de variables de tabla

Variables de tabla que contienen las coordenadas x, especificadas como uno o más índices de variables de tabla.

Especificar índices de tabla

Utilice cualquiera de los siguientes esquemas de indexación para especificar la variable o variables deseadas.

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

Representar sus datos

Las variables de tabla que especifique pueden contener valores numéricos, categóricos, de fecha/hora y de duración.

Para representar un conjunto de datos, especifique una variable para xvar y una variable para yvar. Por ejemplo, lea Patients.xls en la tabla tbl. Represente la variable Diastolic frente a la variable Weight.

tbl = readtable("Patients.xls");
scatter(tbl,"Weight","Diastolic")

Para representar varios conjuntos de datos juntos, especifique múltiples variables para xvar, yvar o ambas. Si especifica múltiples variables para ambos argumentos, el número de variables debe ser el mismo.

Por ejemplo, represente las variables Systolic y Diastolic con respecto a la variable Weight.

scatter(tbl,"Weight",["Systolic","Diastolic"])

Puede utilizar diferentes esquemas de indexación para xvar e yvar. Por ejemplo, especifique xvar como nombre de variable e yvar como número de índice.

scatter(tbl,"Weight",9)

yvar — Variables de tabla que contienen coordenadas y

uno o más índices de variables de tabla

Variables de tabla que contienen las coordenadas y, especificadas como uno o más índices de variables de tabla.

Especificar índices de tabla

Utilice cualquiera de los siguientes esquemas de indexación para especificar la variable o variables deseadas.

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

Representar sus datos

Las variables de tabla que especifique pueden contener valores numéricos, categóricos, de fecha/hora y de duración.

Para representar un conjunto de datos, especifique una variable para xvar y una variable para yvar. Por ejemplo, lea Patients.xls en la tabla tbl. Represente la variable Diastolic frente a la variable Weight.

tbl = readtable("Patients.xls");
scatter(tbl,"Weight","Diastolic")

Para representar varios conjuntos de datos juntos, especifique múltiples variables para xvar, yvar o ambas. Si especifica múltiples variables para ambos argumentos, el número de variables debe ser el mismo.

Por ejemplo, represente las variables Systolic y Diastolic con respecto a la variable Weight.

scatter(tbl,"Weight",["Systolic","Diastolic"])

Puede utilizar diferentes esquemas de indexación para xvar e yvar. Por ejemplo, especifique xvar como nombre de variable e yvar como número de índice.

scatter(tbl,"Weight",9)

ax — Ejes objetivo

objeto Axes | objeto PolarAxes | objeto GeographicAxes

Ejes objetivo, especificados como objeto Axes, objeto PolarAxes u objeto GeographicAxes. Si no se especifican los ejes y el objeto de ejes actual es un eje cartesiano, la función scatter se representa en los ejes actuales.

Una forma práctica de crear diagramas de dispersión en coordenadas polares o geográficas es utilizar las funciones polarscatter o geoscatter.

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: "MarkerFaceColor","red" establece el color de la cara del marcador en rojo.

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

MarkerEdgeColor — Color del contorno del marcador

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

Color del contorno del marcador, especificado como "flat", triplete RGB, código de color hexadecimal, nombre de color o nombre corto. El valor predeterminado de "flat" utiliza colores de la propiedad CData.

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: [0.5 0.5 0.5]

Ejemplo: "blue"

Ejemplo: "#D2F9A7"

MarkerFaceColor — Color de relleno del marcador

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

Color de relleno del marcador, especificado como "flat", "auto", triplete RGB, código de color hexadecimal, nombre de color o nombre corto. La opción "flat" utiliza los valores CData. La opción "auto" utiliza el mismo color que la propiedad Color para los ejes.

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: [0.3 0.2 0.1]

Ejemplo: "green"

Ejemplo: "#D2F9A7"

LineWidth — Anchura del borde del marcador

0.5 (predeterminado) | valor positivo

Anchura del borde del marcador, especificada como valor positivo en unidades de punto.

Ejemplo: 0.75

ColorVariable — Variable de tabla que contiene datos de color

índice de variable de tabla

Variable de tabla que contiene los datos de color, especificada como índice de variable en la tabla de origen.

Especificar índice de tabla

Utilice cualquiera de los siguientes esquemas de indexación para especificar la variable deseada.

Esquema de indexación	Ejemplos
Nombre de la variable: Un escalar de cadena o vector de caracteres. Un objeto pattern. El objeto de patrón debe hacer referencia a una sola variable.	"A" o 'A': una variable llamada A "Var"+digitsPattern(1): variable con el nombre "Var" seguida 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 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 [false false true]: la tercera variable
Tipo de variable: Un subíndice vartype que selecciona una variable de tabla de un tipo especificado. El subíndice debe hacer referencia a una sola variable.	vartype("double"): la variable que contiene valores dobles

Especificar datos de color

Especificar la propiedad ColorVariable controla los colores de los marcadores. Los datos de la variable controlan el color de relleno del marcador cuando la propiedad MarkerFaceColor se establece en "flat". Los datos también pueden controlar el color del contorno del marcador, cuando MarkerEdgeColor se establece en "flat".

La variable de tabla que especifique puede contener valores de cualquier tipo numérico. Los valores pueden expresarse en cualquiera de los siguientes formatos:

• Una columna de números que se asignan de forma lineal al mapa de colores actual.

• Un arreglo de tres columnas de tripletes RGB. Los tripletes RGB son vectores de tres elementos cuyos valores especifican las intensidades de los componentes rojo, verde y azul de colores específicos. Las intensidades deben estar en el rango [0,1]. Por ejemplo, [0.5 0.7 1] especifica un tono azul claro.

Cuando se define la propiedad ColorVariable, MATLAB^® actualiza la propiedad CData.

Argumentos de salida

s — objeto Scatter

objeto Scatter | arreglo de objetos Scatter

Objeto Scatter o un arreglo de objetos Scatter. Utilice s para modificar las propiedades del diagrama de dispersión después de crearlo.

Capacidades ampliadas

Arreglos altos

Realice cálculos con arreglos que tienen más filas de las que caben en la memoria.

La función scatter es compatible con arreglos altos con las siguientes notas y limitaciones de uso:

• Las sintaxis admitidas para los arreglos altos X e Y son:

  • scatter(X,Y)

  • scatter(X,Y,sz)

  • scatter(X,Y,sz,c)

  • scatter(___,"filled")

  • scatter(___,mkr)

  • scatter(___,Name,Value)

  • scatter(ax,___)

• sz debe ser escalar o [] vacío.

• c debe ser escalar o triplete RGB.

• No se admiten entradas categóricas.

• Con los arreglos altos, la función scatter se representa en iteraciones, añadiendo progresivamente a la gráfica a medida que se leen más datos. Durante las actualizaciones, un indicador de progreso muestra la proporción de datos que se ha representado. Se pueden realizar las acciones de acercamiento o alejamiento y desplazamiento durante el proceso de actualización, antes de que se complete la gráfica. Para detener el proceso de actualización, pulse el botón de pausa del indicador de progreso.

Para obtener más información, consulte Visualization of Tall Arrays.

Arreglos GPU

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

La función scatter 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: Las gráficas creadas con tablas conservan los caracteres especiales en las etiquetas de ejes y de leyendas

Cuando pase una tabla y uno o más nombres de variables a la función scatter, las etiquetas de ejes y de leyendas pasan a muestran los caracteres especiales incluidos en los nombres de las variables de la tabla, como los guiones bajos. Anteriormente, los caracteres especiales se interpretaban como caracteres TeX o LaTeX.

Por ejemplo, si pasa una tabla con una variable llamada Sample_Number a la función scatter, el guion bajo aparece en las etiquetas de ejes y de leyendas. En la versión R2022a y en las anteriores, los guiones bajos se interpretan como subíndices.

Versión	Etiqueta para variable de tabla "Sample_Number"
R2022b
R2022a

Para mostrar las etiquetas de ejes y de leyendas con formato TeX o LaTeX, especifique las etiquetas manualmente. Por ejemplo, después de representar, llame a la función xlabel o legend con las cadenas de etiquetas que desee.

xlabel("Sample_Number")
legend(["Sample_Number" "Another_Legend_Label"])

R2021b: Pasar tablas directamente a scatter

Cree gráficas pasando una tabla a la función scatter 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

• hold | plot | scatter3 | bubblechart | swarmchart

Propiedades

• Scatter Properties

Temas

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

Sitios web externos

• Galería de gráficas de MATLAB