Main Content

scatter3

Diagrama de dispersión 3D

  • Scatter plot

Descripción

Datos de vectores y matrices

ejemplo

scatter3(X,Y,Z) muestra círculos en las ubicaciones especificadas por X, Y y Z.

  • Para representar un grupo de coordenadas, especifique X, Y y Z como vectores de la misma longitud.

  • Para representar múltiples grupos de coordenadas en el mismo conjunto de ejes, especifique al menos uno de X, Y o Z como matriz. (Desde la versión R2022a)

ejemplo

scatter3(X,Y,Z,S) especifica el tamaño de los círculos.

  • Para modificar los tamaños de los círculos, especifique S como vector.

  • Para especificar diferentes tamaños en múltiples grupos de coordenadas, especifique una matriz. (Desde la versión R2022a)

ejemplo

scatter3(X,Y,Z,S,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".

ejemplo

scatter3(___,'filled') rellena los círculos utilizando cualquiera de las combinaciones de argumentos de entrada de las sintaxis anteriores.

ejemplo

scatter3(___,markertype) especifica el tipo de marcador.

Datos de tabla

ejemplo

scatter3(tbl,xvar,yvar,zvar) representa las variables xvar, yvar y zvar desde la tabla tbl. Para representar un conjunto de datos, especifique una variable para xvar, otra para yvar y otra para zvar. Para representar varios conjuntos de datos, especifique múltiples variables para, al menos, uno de esos argumentos. Los argumentos que especifican múltiples variables deben especificar el mismo número de variables. (Desde la versión R2021b)

ejemplo

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

Otras opciones

ejemplo

scatter3(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.

ejemplo

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

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

  • scatter3(tbl,'MyX','MyY','MyZ','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.

ejemplo

h = scatter3(___) devuelve el objeto Scatter. Utilice h para modificar las propiedades de la gráfica de dispersión después de crearla.

Ejemplos

contraer todo

Cree un diagrama de dispersión 3D. Utilice sphere para definir los vectores x, y y z.

figure
[X,Y,Z] = sphere(16);
x = [0.5*X(:); 0.75*X(:); X(:)];
y = [0.5*Y(:); 0.75*Y(:); Y(:)];
z = [0.5*Z(:); 0.75*Z(:); Z(:)];
scatter3(x,y,z)

Utilice sphere para definir los vectores x, y y z.

[X,Y,Z] = sphere(16);
x = [0.5*X(:); 0.75*X(:); X(:)];
y = [0.5*Y(:); 0.75*Y(:); Y(:)];
z = [0.5*Z(:); 0.75*Z(:); Z(:)];

Defina el vector s para especificar los tamaños del marcador.

S = repmat([100,50,5],numel(X),1);
s = S(:);

Cree un diagrama de dispersión 3D y utilice view para cambiar el ángulo de los ejes en la figura.

figure
scatter3(x,y,z,s)
view(40,35)

Las entradas correspondientes en x, y, z y s determinan la ubicación y el tamaño de cada marcador.

Utilice sphere para definir los vectores x, y y z.

[X,Y,Z] = sphere(16);
x = [0.5*X(:); 0.75*X(:); X(:)];
y = [0.5*Y(:); 0.75*Y(:); Y(:)];
z = [0.5*Z(:); 0.75*Z(:); Z(:)];

Defina los vectores s y c para especificar el tamaño y el color de cada marcador.

S = repmat([50,25,10],numel(X),1);
C = repmat([1,2,3],numel(X),1);
s = S(:);
c = C(:);

Cree un diagrama de dispersión 3D y utilice view para cambiar el ángulo de los ejes en la figura.

figure
scatter3(x,y,z,s,c)
view(40,35)

Las entradas correspondientes en x, y, z y c determinan la ubicación y el color de cada marcador.

Cree vectores x e y como valores del coseno y el seno con ruido aleatorio.

z = linspace(0,4*pi,250);
x = 2*cos(z) + rand(1,250);
y = 2*sin(z) + rand(1,250);

Cree un diagrama de dispersión 3D y rellene los marcadores. Utilice view para cambiar el ángulo de los ejes en la figura.

scatter3(x,y,z,'filled')
view(-30,10)

Inicialice el generador de números aleatorios para hacer que la salida de rand sea repetible. Defina vectores x e y como valores del coseno y el seno con ruido aleatorio.

rng default
z = linspace(0,4*pi,250);
x = 2*cos(z) + rand(1,250);
y = 2*sin(z) + rand(1,250);

Cree un diagrama de dispersión 3D y establezca el tipo de marcador. Utilice view para cambiar el ángulo de los ejes en la figura.

figure
scatter3(x,y,z,'*')
view(-30,10)

Inicialice el generador de números aleatorios para hacer que la salida de rand sea repetible. Defina vectores x e y como valores del coseno y el seno con ruido aleatorio.

rng default
z = linspace(0,4*pi,250);
x = 2*cos(z) + rand(1,250);
y = 2*sin(z) + rand(1,250);

Cree un diagrama de dispersión 3D y establezca el color del borde del marcador y el color de la cara del marcador. Utilice view para cambiar el ángulo de los ejes en la figura.

figure
scatter3(x,y,z,...
        'MarkerEdgeColor','k',...
        'MarkerFaceColor',[0 .75 .75])
view(-30,10)

Desde la versión R2021b

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

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

También se pueden representar múltiples variables al mismo tiempo. Por ejemplo, represente ambas variables de presión arterial en el eje x, especificando el argumento xvar como arreglo de celdas {'Systolic','Diastolic'}. Después, añada una leyenda. Las etiquetas de las leyendas coinciden con los nombres de las variables.

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

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 scatter3, o puede establecerlas en el objeto Scatter más adelante.

Por ejemplo, lea patients.xls como tabla tbl. Represente la relación entre las variables Systolic, Diastolic y 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 = scatter3(tbl,'Systolic','Diastolic','Weight','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

Desde la versión R2019b

Puede mostrar un mosaico de gráficas utilizando las funciones tiledlayout y nexttile.

Cargue el conjunto de datos seamount para obtener los vectores x, y y z. 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. Después, cree diagramas de dispersión separados en los ejes especificando el objeto de ejes como primer argumento en scatter3.

load seamount
tiledlayout(2,1)
ax1 = nexttile;
ax2 = nexttile;
scatter3(ax1,x,y,z,'MarkerFaceColor',[0 .75 .75])
scatter3(ax2,x,y,z,'*')

Use la función sphere para crear los vectores x, y y z.

[X,Y,Z] = sphere(16);
x = [0.5*X(:); 0.75*X(:); X(:)];
y = [0.5*Y(:); 0.75*Y(:); Y(:)];
z = [0.5*Z(:); 0.75*Z(:); Z(:)];

Cree los vectores s y c para especificar el tamaño y el color de cada marcador.

S = repmat([70,50,20],numel(X),1);
C = repmat([1,2,3],numel(X),1);
s = S(:);
c = C(:);

Cree un diagrama de dispersión 3D y devuelva el objeto de serie de dispersión.

h = scatter3(x,y,z,s,c);

Utilice un valor de color del triplete RGB para establecer el color de la cara del marcador. Utilice la notación de puntos para establecer las propiedades.

h.MarkerFaceColor = [0 0.5 0.5];

Argumentos de entrada

contraer todo

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áficaCómo especificar las coordenadas
Punto único

Especifique X, Y y Z como escalares. Por ejemplo:

scatter3(1,2,3)

Un grupo de puntos

Especifique X, Y y Z como cualquier combinación de vectores fila o columna de la misma longitud. Por ejemplo:

X = [1 2 3 4];
Y = [5; 6; 7; 8];
Z = [9 10 11 12];
scatter3(X,Y,Z)

Múltiples grupos de puntos de diferentes colores

Si todos los conjuntos de datos comparten las coordenadas en una o más dimensiones, especifique las coordenadas compartidas como vector y las demás coordenadas como matrices. La longitud del vector debe coincidir con una de las dimensiones de las matrices. Por ejemplo, represente dos conjuntos de datos que compartan las mismas coordenadas x.

X = [1 2 3 4];
Y = [4 5 6 7; 8 9 10 11];
Z = [10 11 12 13; 14 15 16 17];
scatter3(X,Y,Z)
Si las matrices son cuadradas, scatter3 representa un conjunto independiente de puntos por cada columna de las matrices.

De forma alternativa, especifique X, Y y Z como matrices del mismo tamaño. En este caso, scatter3 representa las columnas de las matrices. Por ejemplo, represente cuatro conjuntos de datos.

X = [1 3 5 6; 2 4 6 8];
Y = [10 25 45 61; 20 40 60 70];
Z = [12 5 6 8; 9 13 2 7];
scatter3(X,Y,Z)

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

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áficaCómo especificar las coordenadas
Punto único

Especifique X, Y y Z como escalares. Por ejemplo:

scatter3(1,2,3)

Un grupo de puntos

Especifique X, Y y Z como cualquier combinación de vectores fila o columna de la misma longitud. Por ejemplo:

X = [1 2 3 4];
Y = [5; 6; 7; 8];
Z = [9 10 11 12];
scatter3(X,Y,Z)

Múltiples grupos de puntos de diferentes colores

Si todos los conjuntos de datos comparten las coordenadas en una o más dimensiones, especifique las coordenadas compartidas como vector y las demás coordenadas como matrices. La longitud del vector debe coincidir con una de las dimensiones de las matrices. Por ejemplo, represente dos conjuntos de datos que compartan las mismas coordenadas x.

X = [1 2 3 4];
Y = [4 5 6 7; 8 9 10 11];
Z = [10 11 12 13; 14 15 16 17];
scatter3(X,Y,Z)
Si las matrices son cuadradas, scatter3 representa un conjunto independiente de puntos por cada columna de las matrices.

De forma alternativa, especifique X, Y y Z como matrices del mismo tamaño. En este caso, scatter3 representa las columnas de las matrices. Por ejemplo, represente cuatro conjuntos de datos.

X = [1 3 5 6; 2 4 6 8];
Y = [10 25 45 61; 20 40 60 70];
Z = [12 5 6 8; 9 13 2 7];
scatter3(X,Y,Z)

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

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

Tipo de gráficaCómo especificar las coordenadas
Punto único

Especifique X, Y y Z como escalares. Por ejemplo:

scatter3(1,2,3)

Un grupo de puntos

Especifique X, Y y Z como cualquier combinación de vectores fila o columna de la misma longitud. Por ejemplo:

X = [1 2 3 4];
Y = [5; 6; 7; 8];
Z = [9 10 11 12];
scatter3(X,Y,Z)

Múltiples grupos de puntos de diferentes colores

Si todos los conjuntos de datos comparten las coordenadas en una o más dimensiones, especifique las coordenadas compartidas como vector y las demás coordenadas como matrices. La longitud del vector debe coincidir con una de las dimensiones de las matrices. Por ejemplo, represente dos conjuntos de datos que compartan las mismas coordenadas x.

X = [1 2 3 4];
Y = [4 5 6 7; 8 9 10 11];
Z = [10 11 12 13; 14 15 16 17];
scatter3(X,Y,Z)
Si las matrices son cuadradas, scatter3 representa un conjunto independiente de puntos por cada columna de las matrices.

De forma alternativa, especifique X, Y y Z como matrices del mismo tamaño. En este caso, scatter3 representa las columnas de las matrices. Por ejemplo, represente cuatro conjuntos de datos.

X = [1 3 5 6; 2 4 6 8];
Y = [10 25 45 61; 20 40 60 70];
Z = [12 5 6 8; 9 13 2 7];
scatter3(X,Y,Z)

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

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, Y y Z, y de qué aspecto desea que tenga el diagrama. Esta tabla describe las situaciones más habituales.

Tamaño del marcadorX, Y y Z SEjemplo

Mismo tamaño para todos los puntos

Cualquier combinación válida de vectores o matrices descritas para X, Y y Z

Escalar

Especifique X como vector, Y y Z como matrices y S como escalar.

X = [1 2 3 4];
Y = [5 6 7 8; 9 10 11 12];
Z = [13 14 15 16; 17 18 19 20];
scatter3(X,Y,Z,100)

Tamaño diferente para cada punto

Vectores de la misma longitud

  • Un vector con la misma longitud que X, Y y Z.

  • Una matriz con al menos una dimensión que coincide con las longitudes de X, Y y Z. Especificar una matriz resulta útil para mostrar múltiples marcadores con diferentes tamaños en cada ubicación (x,y,z).

Especifique X, Y, Z y S como vectores.

X = [1 2 3 4];
Y = [4 5 6 7];
Z = [8 9 10 11];
S = [80 150 700 50];
scatter3(X,Y,Z,S)

Especifique X, Y y Z como vectores y S como matriz.

X = [1 2 3 4];
Y = [5 6 7 8];
Z = [9 10 11 12];
S = [80 30; 150 900; 50 500; 200 350];
scatter3(X,Y,Z,S)

Tamaño diferente para cada punto

Al menos uno de X, Y o Z 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, Y o Z.

Especifique X como vector, Y y Z como matrices y S como vector.

X = [1 2 3 4];
Y = [1 6; 3 8; 2 7; 4 9];
Z = [2 8; 3 10; 4 7; 4 12];
S = [80 150 200 350];
scatter3(X,Y,Z,S)

Especifique X como vector, Y, Z y S como matrices.

X = [1 2 3 4];
Y = [1 6; 3 8; 2 7; 4 9];
Z = [10 11; 12 13; 14 15; 16 17];
S = [80 30; 150 900; 50 2000; 200 350];
scatter3(X,Y,Z,S)

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

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, Y y Z.

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

Esquema de coloresCómo especificar el colorEjemplo

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

X = [1 2 3 4];
Y = [2 5 3 6];
Z = [10 6 4 7];
S = 50;
scatter3(X,Y,Z,S,"red")

Represente dos conjuntos de puntos y especifique el color como rojo usando el triplete RGB [1 0 0].

X = [1 2 3 4];
Y = [2 5 3 6];
Z = [2 5; 1 2; 8 4; 7 9];
S = 50;
scatter3(X,Y,Z,S,[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 Z son vectores y S es un vector o un escalar.

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 2 3 4];
X = [1 2 3 4];
Y = [1 0 6 2];
Z = [2 5 3 7];
S = 50;
scatter3(X,Y,Z,S,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 Z son vectores y S es un vector o un escalar.

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];
X = [1 2 3 4];
Y = [2 5 3 6];
Z = [10 6 4 7];
S = 50;
scatter3(X,Y,Z,S,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, Z o S 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];
X = [1 2 3 4];
Y = [5 6 7 8];
Z = [2 5; 1 2; 8 4; 11 9];
S = 50;
scatter3(X,Y,Z,S,C)

Nombres de los colores y tripletes RGB para colores comunes

Nombre del colorNombre cortoTriplete RGBCódigo de color hexadecimalApariencia
"red""r"[1 0 0]"#FF0000"

Sample of the color red

"green""g"[0 1 0]"#00FF00"

Sample of the color green

"blue""b"[0 0 1]"#0000FF"

Sample of the color blue

"cyan" "c"[0 1 1]"#00FFFF"

Sample of the color cyan

"magenta""m"[1 0 1]"#FF00FF"

Sample of the color magenta

"yellow""y"[1 1 0]"#FFFF00"

Sample of the color yellow

"black""k"[0 0 0]"#000000"

Sample of the color black

"white""w"[1 1 1]"#FFFFFF"

Sample of the color white

A continuación, se indican los tripletes RGB y los códigos de color hexadecimales de los colores predeterminados que MATLAB® utiliza en muchos tipos de gráficas.

Triplete RGBCódigo de color hexadecimalApariencia
[0 0.4470 0.7410]"#0072BD"

Sample of RGB triplet [0 0.4470 0.7410], which appears as dark blue

[0.8500 0.3250 0.0980]"#D95319"

Sample of RGB triplet [0.8500 0.3250 0.0980], which appears as dark orange

[0.9290 0.6940 0.1250]"#EDB120"

Sample of RGB triplet [0.9290 0.6940 0.1250], which appears as dark yellow

[0.4940 0.1840 0.5560]"#7E2F8E"

Sample of RGB triplet [0.4940 0.1840 0.5560], which appears as dark purple

[0.4660 0.6740 0.1880]"#77AC30"

Sample of RGB triplet [0.4660 0.6740 0.1880], which appears as medium green

[0.3010 0.7450 0.9330]"#4DBEEE"

Sample of RGB triplet [0.3010 0.7450 0.9330], which appears as light blue

[0.6350 0.0780 0.1840]"#A2142F"

Sample of RGB triplet [0.6350 0.0780 0.1840], which appears as dark red

Marcador, especificado como uno de los marcadores en esta tabla.

MarcadorDescripciónMarcador resultante
"o"Círculo

Sample of circle marker

"+"Signo más

Sample of plus sign marker

"*"Asterisco

Sample of asterisk marker

"."Punto

Sample of point marker

"x"Cruz

Sample of cross marker

"_"Línea horizontal

Sample of horizontal line marker

"|"Línea vertical

Sample of vertical line marker

"square"Cuadrado

Sample of square marker

"diamond"Rombo

Sample of diamond marker

"^"Triángulo hacia arriba

Sample of upward-pointing triangle marker

"v"Triángulo hacia abajo

Sample of downward-pointing triangle marker

">"Triángulo hacia la derecha

Sample of right-pointing triangle marker

"<"Triángulo hacia la izquierda

Sample of left-pointing triangle marker

"pentagram"Pentagrama

Sample of pentagram marker

"hexagram"Hexagrama

Sample of hexagram marker

"none"Sin marcadoresNo se aplica

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.

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

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ónEjemplos

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, una variable para yvar y una variable para zvar. Por ejemplo, lea Patients.xls en la tabla tbl. Represente las variables Height, Weight y Diastolic.

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

Para representar varios conjuntos de datos juntos, especifique múltiples variables para, al menos, uno de xvar, yvar o zvar. Si especifica múltiples variables para más de un argumento, el número de variables debe ser el mismo para cada uno de esos argumentos.

Por ejemplo, represente la variable Weight en el eje x, las variables Systolic y Diastolic en el eje y y la variable Age en el eje z.

scatter3(tbl,"Weight",["Systolic","Diastolic"],"Age")

Puede utilizar diferentes esquemas de indexación para xvar, yvar y zvar. Por ejemplo, especifique xvar como nombre de variable, yvar como número de índice y zvar como vector lógico.

scatter3(tbl,"Height",6,[false false true])

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ónEjemplos

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, una variable para yvar y una variable para zvar. Por ejemplo, lea Patients.xls en la tabla tbl. Represente las variables Height, Weight y Diastolic.

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

Para representar varios conjuntos de datos juntos, especifique múltiples variables para, al menos, uno de xvar, yvar o zvar. Si especifica múltiples variables para más de un argumento, el número de variables debe ser el mismo para cada uno de esos argumentos.

Por ejemplo, represente la variable Weight en el eje x, las variables Systolic y Diastolic en el eje y y la variable Age en el eje z.

scatter3(tbl,"Weight",["Systolic","Diastolic"],"Age")

Puede utilizar diferentes esquemas de indexación para xvar, yvar y zvar. Por ejemplo, especifique xvar como nombre de variable, yvar como número de índice y zvar como vector lógico.

scatter3(tbl,"Height",6,[false false true])

Variables de tabla que contienen las coordenadas z, 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ónEjemplos

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, una variable para yvar y una variable para zvar. Por ejemplo, lea Patients.xls en la tabla tbl. Represente las variables Height, Weight y Diastolic.

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

Para representar varios conjuntos de datos juntos, especifique múltiples variables para, al menos, uno de xvar, yvar o zvar. Si especifica múltiples variables para más de un argumento, el número de variables debe ser el mismo para cada uno de esos argumentos.

Por ejemplo, represente la variable Weight en el eje x, las variables Systolic y Diastolic en el eje y y la variable Age en el eje z.

scatter3(tbl,"Weight",["Systolic","Diastolic"],"Age")

Puede utilizar diferentes esquemas de indexación para xvar, yvar y zvar. Por ejemplo, especifique xvar como nombre de variable, yvar como número de índice y zvar como vector lógico.

scatter3(tbl,"Height",6,[false false true])

Objeto de ejes. Si no especifica los ejes, scatter3 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: 'MarkerFaceColor','red' establece el color de la cara del marcador en rojo.

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

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

Ejemplo: 0.75

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 colorNombre cortoTriplete RGBCódigo de color hexadecimalApariencia
"red""r"[1 0 0]"#FF0000"

Sample of the color red

"green""g"[0 1 0]"#00FF00"

Sample of the color green

"blue""b"[0 0 1]"#0000FF"

Sample of the color blue

"cyan" "c"[0 1 1]"#00FFFF"

Sample of the color cyan

"magenta""m"[1 0 1]"#FF00FF"

Sample of the color magenta

"yellow""y"[1 1 0]"#FFFF00"

Sample of the color yellow

"black""k"[0 0 0]"#000000"

Sample of the color black

"white""w"[1 1 1]"#FFFFFF"

Sample of the color white

"none"No se aplicaNo se aplicaNo se aplicaSin color

A continuación, se indican los tripletes RGB y los códigos de color hexadecimales de los colores predeterminados que MATLAB utiliza en muchos tipos de gráficas.

Triplete RGBCódigo de color hexadecimalApariencia
[0 0.4470 0.7410]"#0072BD"

Sample of RGB triplet [0 0.4470 0.7410], which appears as dark blue

[0.8500 0.3250 0.0980]"#D95319"

Sample of RGB triplet [0.8500 0.3250 0.0980], which appears as dark orange

[0.9290 0.6940 0.1250]"#EDB120"

Sample of RGB triplet [0.9290 0.6940 0.1250], which appears as dark yellow

[0.4940 0.1840 0.5560]"#7E2F8E"

Sample of RGB triplet [0.4940 0.1840 0.5560], which appears as dark purple

[0.4660 0.6740 0.1880]"#77AC30"

Sample of RGB triplet [0.4660 0.6740 0.1880], which appears as medium green

[0.3010 0.7450 0.9330]"#4DBEEE"

Sample of RGB triplet [0.3010 0.7450 0.9330], which appears as light blue

[0.6350 0.0780 0.1840]"#A2142F"

Sample of RGB triplet [0.6350 0.0780 0.1840], which appears as dark red

Ejemplo: [0.5 0.5 0.5]

Ejemplo: "blue"

Ejemplo: "#D2F9A7"

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 colorNombre cortoTriplete RGBCódigo de color hexadecimalApariencia
"red""r"[1 0 0]"#FF0000"

Sample of the color red

"green""g"[0 1 0]"#00FF00"

Sample of the color green

"blue""b"[0 0 1]"#0000FF"

Sample of the color blue

"cyan" "c"[0 1 1]"#00FFFF"

Sample of the color cyan

"magenta""m"[1 0 1]"#FF00FF"

Sample of the color magenta

"yellow""y"[1 1 0]"#FFFF00"

Sample of the color yellow

"black""k"[0 0 0]"#000000"

Sample of the color black

"white""w"[1 1 1]"#FFFFFF"

Sample of the color white

"none"No se aplicaNo se aplicaNo se aplicaSin color

A continuación, se indican los tripletes RGB y los códigos de color hexadecimales de los colores predeterminados que MATLAB utiliza en muchos tipos de gráficas.

Triplete RGBCódigo de color hexadecimalApariencia
[0 0.4470 0.7410]"#0072BD"

Sample of RGB triplet [0 0.4470 0.7410], which appears as dark blue

[0.8500 0.3250 0.0980]"#D95319"

Sample of RGB triplet [0.8500 0.3250 0.0980], which appears as dark orange

[0.9290 0.6940 0.1250]"#EDB120"

Sample of RGB triplet [0.9290 0.6940 0.1250], which appears as dark yellow

[0.4940 0.1840 0.5560]"#7E2F8E"

Sample of RGB triplet [0.4940 0.1840 0.5560], which appears as dark purple

[0.4660 0.6740 0.1880]"#77AC30"

Sample of RGB triplet [0.4660 0.6740 0.1880], which appears as medium green

[0.3010 0.7450 0.9330]"#4DBEEE"

Sample of RGB triplet [0.3010 0.7450 0.9330], which appears as light blue

[0.6350 0.0780 0.1840]"#A2142F"

Sample of RGB triplet [0.6350 0.0780 0.1840], which appears as dark red

Ejemplo: [0.3 0.2 0.1]

Ejemplo: "green"

Ejemplo: "#D2F9A7"

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ónEjemplos

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

contraer todo

Objeto Scatter. Es un identificador único que puede utilizarse para consultar y modificar las propiedades del objeto Scatter después de crearlo.

Capacidades ampliadas

Historial de versiones

Introducido antes de R2006a

expandir todo