gscatter

Gráfica de dispersión por grupo

Sintaxis

gscatter(x,y,g)

gscatter(x,y,g,clr,sym,siz)

gscatter(x,y,g,clr,sym,siz,doleg)

gscatter(x,y,g,clr,sym,siz,doleg,xnam,ynam)

gscatter(ax,___)

gscatter(___,"filled")

h = gscatter(___)

Descripción

gscatter(x,y,g) crea una gráfica de dispersión de x e y, agrupada por g. Los datos de entrada x e y son vectores del mismo tamaño.

gscatter(x,y,g,clr,sym,siz) indica el color del marcador clr, el símbolo sym y el tamaño siz de cada grupo.

gscatter(x,y,g,clr,sym,siz,doleg) controla la aparición de la leyenda en las gráficas. gscatter crea una leyenda de forma predeterminada.

gscatter(x,y,g,clr,sym,siz,doleg,xnam,ynam) indica los nombres que se usarán para las etiquetas del eje X y el eje Y. Si no proporciona xnam e ynam, y los datos de entrada de x e y son variables con nombres, gscatter etiquetará los ejes con los nombres de las variables.

gscatter(ax,___) usa los ejes de la gráfica especificados por el objeto de ejes ax. Especifique ax como primer argumento de entrada, seguido de cualquier combinación de argumentos de entrada de las sintaxis anteriores.

gscatter(___,"filled") rellena los interiores de los marcadores. gscatter ignora esta opción de los marcadores que no tienen interiores.

h = gscatter(___) devuelve los identificadores de las gráficas correspondientes a los grupos de g.

Puede pasar [] para clr, sym y siz para usar sus valores predeterminados.

Ejemplos

Gráfica de dispersión con configuración predeterminada

Cargue el conjunto de datos carsmall.

load carsmall

Represente los valores de Displacement en el eje X y los valores de Horsepower en el eje Y. gscatter usa los nombres de las variables como las etiquetas predeterminadas para los ejes. Agrupe los puntos de datos por Model_Year.

gscatter(Displacement,Horsepower,Model_Year)

Gráfica de dispersión con una variable de agrupación

Cargue el conjunto de datos discrim.

load discrim

El conjunto de datos contiene valoraciones de ciudades de acuerdo con nueve factores, como el clima, la vivienda, la educación y la salud. La matriz ratings contiene la información de las valoraciones.

Represente la relación entre las valoraciones del clima (primera columna) y la vivienda (segunda columna) agrupadas por el tamaño de la ciudad en la matriz group. Utilice colores y símbolos de gráfica diferentes para cada grupo.

gscatter(ratings(:,1),ratings(:,2),group,'br','xo')
xlabel('climate')
ylabel('housing')

Gráfica de dispersión con diferentes variables de agrupación

Cargue el conjunto de datos hospital.

load hospital

Represente las edades y el peso de los pacientes del hospital. Agrupe los pacientes de acuerdo con su género y sus hábitos tabáquicos. Use el símbolo o para representar a las personas no fumadoras y el símbolo * para las fumadoras.

x = hospital.Age;
y = hospital.Weight;
g = {hospital.Sex,hospital.Smoker};
gscatter(x,y,g,'rkgb','o*',8,'on','Age','Weight')
legend('Location','northeastoutside')

Especificar los ejes de una gráfica de dispersión

Cargue el conjunto de datos carsmall. Cree una figura con dos subgráficas y devuelva los objetos axes como ax1 y ax2. Cree una gráfica de dispersión en cada conjunto de ejes haciendo referencia al objeto Axes correspondiente. En la subgráfica izquierda, agrupe los datos usando la variable Model_Year. En la subgráfica derecha, agrupe los datos usando la variable Cylinders. Añada un título a cada gráfica pasando el objeto Axes correspondiente a la función title.

load carsmall
color = lines(6); % Generate color values

ax1 = subplot(1,2,1); % Left subplot
gscatter(ax1,Acceleration,MPG,Model_Year,color(1:3,:))
title(ax1,'Left Subplot (Model Year)')

ax2 = subplot(1,2,2); % Right subplot
gscatter(ax2,Acceleration,MPG,Cylinders,color(4:6,:))
title(ax2,'Right Subplot (Cylinders)')

Especificar colores de marcadores

Especifique los colores de marcadores usando el mapa de colores determinado por la función hsv.

Cargue el conjunto de datos de exploración de LiDAR que contiene las coordenadas de los objetos que rodean a un vehículo, almacenados como una colección de puntos en 3D.

load('lidar_subset.mat') 
loc = lidar_subset;

Para resaltar el entorno alrededor del vehículo, defina la región de interés de manera que se extienda 20 metros hacia la izquierda y la derecha del vehículo, 20 metros delante y detrás del vehículo y en el área encima de la superficie de la carretera.

xBound = 20; % in meters
yBound = 20; % in meters
zLowerBound = 0; % in meters

Recorte los datos para que contengan solo puntos dentro de la región especificada.

indices = loc(:,1) <= xBound & loc(:,1) >= -xBound ...
    & loc(:,2) <= yBound & loc(:,2) >= -yBound ...
    & loc(:,3) > zLowerBound;
loc = loc(indices,:);

Agrupe los datos usando dbscan con distancias en parejas.

D = pdist2(loc,loc);
idx = dbscan(D,2,50,'Distance','precomputed');

Visualice los grupos resultantes como una gráfica de dispersión de grupo en 2D usando la función gscatter. Por defecto, gscatter usa los siete colores predeterminados de MATLAB. Si el número de grupos únicos es mayor de siete, la función vuelve a aplicar los colores predeterminados según sea necesario. Busque el número de grupos y genere el número de colores correspondiente usando la función hsv. Especifique colores de marcadores para usar un color único para cada grupo.

numGroups = length(unique(idx));
clr = hsv(numGroups);
gscatter(loc(:,1),loc(:,2),idx,clr)
xlabel('x')
ylabel('y')

Crear y modificar una gráfica de dispersión

Cargue el conjunto de datos carbig.

load carbig

Cree una gráfica de dispersión comparando Acceleration con MPG. Agrupe los puntos de datos basados en Origin.

h = gscatter(Acceleration,MPG,Origin)

h = 
  7×1 Line array:

  Line    (USA)
  Line    (France)
  Line    (Japan)
  Line    (Germany)
  Line    (Sweden)
  Line    (Italy)
  Line    (England)

Muestre el objeto Line correspondiente al grupo etiquetado como (Japan).

jgroup = h(3)

jgroup = 
  Line (Japan) with properties:

              Color: [0.9294 0.6941 0.1255]
          LineStyle: 'none'
          LineWidth: 0.5000
             Marker: '.'
         MarkerSize: 12
    MarkerFaceColor: 'none'
              XData: [15 14.5000 14.5000 14 19 18 15.5000 13.5000 17 14.5000 16.5000 19 16.5000 13.5000 13.5000 19 21 16.5000 19 15 15.5000 16 13.5000 17 17.5000 17.4000 17 16.4000 15.5000 18.5000 16.8000 18.2000 16.4000 14.5000 13.5000 … ] (1×79 double)
              YData: [24 27 27 25 31 35 24 19 28 23 27 20 22 18 20 31 32 31 32 24 26 29 24 24 33 33 32 28 19 31.5000 33.5000 26 30 22 21.5000 32.8000 39.4000 36.1000 27.5000 27.2000 21.1000 23.9000 29.5000 34.1000 31.8000 38.1000 37.2000 … ] (1×79 double)

  Show all properties

Cambie el color del marcador del grupo Japan a negro.

jgroup.Color = 'k';

Argumentos de entrada

x — valores del eje X

vector numérico

valores del eje X, especificados como un vector numérico. x debe tener el mismo tamaño que y.

Tipos de datos: single | double

y — valores del eje Y

vector numérico

valores del eje Y, especificados como un vector numérico. y debe tener el mismo tamaño que x.

Tipos de datos: single | double

g — Variable de agrupación

vector categórico | vector lógico | vector numérico | arreglo de caracteres | arreglo de cadenas | arreglo de celdas de vectores de caracteres | arreglo de celdas

Variable de agrupación, especificada como un vector categórico, vector lógico, vector numérico, arreglo de caracteres, arreglo de cadenas o arreglo de celdas de vectores de caracteres. De manera alternativa, g puede ser un arreglo de celdas que contiene diferentes variables de agrupación (como {g1 g2 g3}). En este caso, las observaciones se colocarían en el mismo grupo si tienen valores comunes con todas las variables de agrupación. Los puntos del mismo grupo aparecen en la gráfica de dispersión con el mismo color de marcador, símbolo y tamaño.

El número de filas de g debe ser igual a la longitud de x.

Ejemplo: species

Ejemplo: {Cylinders,Origin}

Tipos de datos: categorical | logical | single | double | char | string | cell

clr — Colores de marcadores

colores predeterminados de MATLAB^® (predeterminado) | vector de caracteres o escalar de cadena de nombres de colores cortos | matriz de tripletes RGB

Colores de marcadores, especificados como un vector de caracteres o escalar de cadena de nombres de colores cortos o una matriz de tripletes RGB.

Para un color personalizado, especifique una matriz de tripletes RGB. 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].

Alternativamente, puede especificar algunos colores comunes por nombre. En esta tabla se enumeran las opciones de color nombradas y sus tripletes RGB equivalentes

Nombre corto	Triplete RGB	Apariencia
'r'	[1 0 0]
'g'	[0 1 0]
'b'	[0 0 1]
'c'	[0 1 1]
'm'	[1 0 1]
'y'	[1 1 0]
'k'	[0 0 0]
'w'	[1 1 1]

Estos son los códigos de colores de triplete RGB para los colores predeterminados que usa MATLAB en muchos tipos de gráficas.

Triplete RGB	Apariencia
[0 0.4470 0.7410]
[0.8500 0.3250 0.0980]
[0.9290 0.6940 0.1250]
[0.4940 0.1840 0.5560]
[0.4660 0.6740 0.1880]
[0.3010 0.7450 0.9330]
[0.6350 0.0780 0.1840]

El valor predeterminado de clr es la matriz de los tripletes RGB que contienen los colores predeterminados de MATLAB.

Si no especifica colores suficientes para todos los grupos únicos en g, entonces gscatter utilizará una estrategia cíclica usando los valores especificados en clr. Si usa valores predeterminados cuando el número de grupos únicos supera el número de colores predeterminados (7), entonces gscatter utilizará una estrategia cíclica usando los valores predeterminados según sea necesario.

Ejemplo: 'rgb'

Ejemplo: [0 0 1; 0 0 0]

Tipos de datos: char | string | single | double

sym — Símbolos de marcadores

'.' (predeterminado) | vector de caracteres o escalar de cadena de símbolos

Símbolos de marcadores, especificados como un vector de caracteres o escalar de cadena de los símbolos reconocidos por la función plot. Esta tabla muestra los símbolos de marcadores disponibles.

Valor	Descripción
'o'	Círculo
'+'	Signo de más
'*'	Asterisco
'.'	Punto
'x'	Cruz
's'	Cuadrado
'd'	Diamante
'^'	Triángulo hacia arriba
'v'	Triángulo hacia abajo
'>'	Triángulo hacia la derecha
'<'	Triángulo hacia la izquierda
'p'	Estrella de cinco puntas (pentagrama)
'h'	Estrella de seis puntas (hexagrama)
'n'	Sin marcadores

Si no especifica valores suficientes para todos los grupos, gscatter utilizará una estrategia cíclica usando los valores especificados según sea necesario.

Ejemplo: 'o+*v'

Tipos de datos: char | string

siz — Tamaño de los marcadores

vector numérico positivo

Tamaños de los marcadores, especificados como un vector numérico positivo en puntos. El valor predeterminado depende del número de observaciones. Si no especifica valores suficientes para todos los grupos, gscatter utilizará una estrategia cíclica usando los valores especificados según sea necesario.

Ejemplo: [6 12]

Tipos de datos: single | double

doleg — Opción para incluir leyenda

'on' (predeterminado) | 'off'

Opción para incluir una leyenda, especificada como 'on' o 'off'. De forma predeterminada, se muestra la leyenda en la gráfica.

xnam — etiqueta del eje X

nombre de la variable x (predeterminado) | vector de caracteres | escalar de cadena

eje X, especificado como un vector de caracteres o un escalar de cadena.

Tipos de datos: char | string

ynam — etiqueta del eje Y

nombre de la variable y (predeterminado) | vector de caracteres | escalar de cadena

etiqueta del eje Y, especificada como un vector de caracteres o un escalar de cadena.

Tipos de datos: char | string

"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 marcadores que tengan un interior, como "o" y "s". gscatter ignora "filled" para los marcadores que no tienen interior, como "." y "+".

Tipos de datos: string

ax — Ejes de la gráfica

objeto Axes | objeto UIAxes

Los ejes de la gráfica, especificados como un objeto Axes o UIAxes. Si no especifica ax, gscatter crea la gráfica utilizando los ejes actuales. Para obtener más información sobre la creación de un objeto de ejes, consulte axes y uiaxes.

Argumentos de salida

h — Identificadores de gráficas

arreglo de objetos Line

Identificadores de gráficas, devueltos como un arreglo de objetos Line. Cada objeto Line corresponde a uno de los grupos de g. Puede utilizar la notación de puntos para consultar y establecer las propiedades de los objetos de línea. Para ver una lista de las propiedades del objeto Line, consulte Line Properties.

Historial de versiones

Introducido antes de R2006a

R2025a: Crear gráfica con colores actualizados

Cuando la gráfica contiene hasta 12 colores, la función gscatter utiliza la paleta de colores gem12 en el modo claro y la paleta de colores glow12 en el modo oscuro. Cuando la gráfica contiene más de 12 colores, la función utiliza el mapa de colores hsv. Para obtener más información sobre paletas de colores para visualizar varias series de datos, consulte orderedcolors.

R2022a: gscatter usa el esquema de color predeterminado de MATLAB

A partir de la versión R2022a, la función gscatter usa el esquema de color predeterminado de MATLAB para determinar los colores de marcadores, siguiendo el orden especificado en la propiedad ColorOrder de los ejes.

En versiones anteriores, la función gscatter usa el mapa de colores devuelto por la función hsv. Si desea determinar los colores de marcadores usando el mapa de colores de hsv, especifique los colores de marcadores (cuarto argumento de entrada de gscatter) como hsv(numGroups), donde numGroups es el número de combinaciones de grupos únicas en las variables de agrupación.

Si usa el nuevo esquema de color predeterminado y el número de grupos únicos supera el número de colores predeterminados (7), entonces gscatter utilizará una estrategia cíclica usando los valores predeterminados según sea necesario. Si desea usar colores diferentes para los distintos grupos, especifique los colores de marcadores como hsv(numGroups). Para ver un ejemplo, consulte Especificar colores de marcadores.

Consulte también

gplotmatrix | grpstats | scatter

Temas

• Crear gráficas de dispersión con datos agrupados
• Perform Multivariate Analysis of Variance (MANOVA)
• Grouping Variables