polarplot

Representar una línea en coordenadas polares

• 

×

Sintaxis

polarplot(theta,rho)

polarplot(theta,rho,LineSpec)

polarplot(theta1,rho1,...,thetaN,rhoN)

polarplot(theta1,rho1,LineSpec1,...,thetaN,rhoN,LineSpecN)

polarplot(rho)

polarplot(rho,LineSpec)

polarplot(Z)

polarplot(Z,LineSpec)

polarplot(tbl,thetavar,rhovar)

polarplot(tbl,rhovar)

polarplot(pax,___)

polarplot(___,Name,Value)

p = polarplot(___)

Descripción

Datos de vectores y matrices

polarplot(theta,rho) representa una línea en coordenadas polares con theta indicando el ángulo en radianes y rho indicando el valor del radio para cada punto. Las entradas deben ser vectores o matrices del mismo tamaño. Si las entradas son matrices, polarplot representa las columnas de rho frente a las columnas de theta. Como alternativa, una de las entradas puede ser un vector y la otra una matriz, siempre y cuando el vector sea de la misma longitud que una dimensión de la matriz.

polarplot(theta,rho,LineSpec) establece el estilo de línea, el símbolo de marcador y el color para la línea.

polarplot(theta1,rho1,...,thetaN,rhoN) representa varios pares rho,theta.

polarplot(theta1,rho1,LineSpec1,...,thetaN,rhoN,LineSpecN) especifica el estilo de línea, el símbolo de marcador y el color para cada línea.

polarplot(rho) representa los valores del radio en rho en ángulos equidistantes entre 0 y 2n.

polarplot(rho,LineSpec) establece el estilo de línea, el símbolo de marcador y el color para la línea.

polarplot(Z) representa los valores complejos en Z.

polarplot(Z,LineSpec) establece el estilo de línea, el símbolo de marcador y el color para la línea.

Datos de tabla

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

polarplot(tbl,rhovar) representa los valores del radio en rhovar en ángulos equidistantes entre 0 y 2n. Los horarios no son compatibles con esta sintaxis (desde la versión R2022a).

Otras opciones

polarplot(pax,___) utiliza el objeto PolarAxes especificado por pax en lugar de los ejes actuales.

polarplot(___,Name,Value) especifica las propiedades de la gráfica de líneas utilizando uno o más argumentos de par Name,Value. La configuración de las propiedades se aplica a todas las líneas. No puede especificar diferentes valores de propiedad para líneas diferentes utilizando pares Name,Value.

p = polarplot(___) devuelve uno o más objetos de línea de gráfica. Utilice p para configurar las propiedades de un objeto de línea de gráfica específico después de crearlo. Para obtener una lista de las propiedades, consulte Line Properties.

Ejemplos

Crear gráfica polar

Represente una línea en las coordenadas polares.

theta = 0:0.01:2*pi;
rho = sin(2*theta).*cos(2*theta);
polarplot(theta,rho)

En versiones anteriores a R2022a, los ejes polares no incluyen símbolos de grado de manera predeterminada. Para añadirlos, obtenga los ejes polares utilizando pax = gca. A continuación, modifique las etiquetas de marcas utilizando pax.ThetaTickLabel = string(pax.ThetaTickLabel) + char(176).

Convertir de grados a radianes antes de la representación

Cree los datos para la gráfica.

theta = linspace(0,360,50);
rho = 0.005*theta/10;

Convertir los valores en theta de grados a radianes. Después, represente los datos en coordenadas polares.

theta_radians = deg2rad(theta);
polarplot(theta_radians,rho)

Representar múltiples líneas en coordenadas polares

Represente dos líneas en coordenadas polares. Utilice una línea discontinua para la segunda línea.

theta = linspace(0,6*pi);
rho1 = theta/10;
polarplot(theta,rho1)

rho2 = theta/12;
hold on
polarplot(theta,rho2,'--')
hold off

Representar valores del radio en ángulos equidistantes

Especifique solo los valores del radio, sin especificar los valores del ángulo. polarplot representa los valores del radio en los ángulos equidistantes entre 0 y $$2\pi$$. Muestre un marcador circular en cada punto de datos.

rho = 10:5:70;
polarplot(rho,'-o')

Representar valores del radio negativos

Cree una representación polar utilizando valores negativos del radio. De forma predeterminada, polarplot refleja valores negativos a través del origen.

theta = linspace(0,2*pi);
rho = sin(theta);
polarplot(theta,rho)

Modifique los límites del eje r de forma que oscile entre -1 y 1.

rlim([-1 1])

Especificar el color de línea para una representación polar

Cree una gráfica polar utilizando una línea roja con marcadores circulares.

theta = linspace(0,2*pi,25);
rho = 2*theta;
polarplot(theta,rho,'r-o')

Especificar el color de línea después de crearla

Cree una gráfica polar y devuelva el objeto línea de gráfica.

theta = linspace(0,2*pi,25);
rho = 2*theta;
p = polarplot(theta,rho);

Cambie el color y ancho de la línea, y añada marcadores.

p.Color = 'magenta';
p.Marker = 'square';
p.MarkerSize = 8;

Crear una gráfica polar con valores complejos

Represente valores complejos en coordenadas polares. Muestre marcadores en cada punto sin una línea que los conecte.

Z = [2+3i 2 -1+4i 3-4i 5+2i -4-2i -2+3i -2 -3i 3i-2i];
polarplot(Z,'*')

Representar coordenadas desde una tabla

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

Cree una tabla con dos variables. Después, muestre las primeras tres filas de la tabla.

Angle = linspace(0,3*pi,50)';
Radius = (1:50)';
tbl = table(Angle,Radius);
head(tbl,3)

     Angle     Radius
    _______    ______

          0      1   
    0.19234      2   
    0.38468      3   

Represente las variables Angle y Radius. Devuelva el objeto Line como p.

p = polarplot(tbl,"Angle","Radius");

Para modificar aspectos de la línea, establezca las propiedades LineStyle, Color y Marker en el objeto Line. Por ejemplo, cambie la línea a una línea de puntos rojos con marcadores circulares.

p.LineStyle = ":";
p.Color = "red";
p.Marker = "o";

Representar múltiples conjuntos de datos de una tabla

Cree una tabla con tres variables. Después, muestre las primeras tres filas en la tabla.

Angle = linspace(0,3*pi,50)';
Radius1 = (1:50)';
Radius2 = Radius1/2;
tbl = table(Angle,Radius1,Radius2);
head(tbl,3)

     Angle     Radius1    Radius2
    _______    _______    _______

          0       1         0.5  
    0.19234       2           1  
    0.38468       3         1.5  

Represente las variables Radius1 y Radius2 con respecto a la variable Angle. Añada una leyenda. Observe que las etiquetas de las leyendas coinciden con los nombres de las variables.

polarplot(tbl,"Angle",["Radius1" "Radius2"])
legend

Argumentos de entrada

theta — Valores del ángulo

vector | matriz

Valores del ángulo, especificados como vector o matriz. Especifique los valores en radianes. Para convertir datos de grados a radianes, utilice deg2rad.

Para cambiar los límites del eje theta, utilice thetalim.

Ejemplo: [0 pi/2 pi 3*pi/2 2*pi]

rho — Valores del radio

vector | matriz

Valores del radio, especificados como vector o matriz. De forma predeterminada, los valores negativos se reflejan mediante 0. Un punto se refleja tomando el valor absoluto de su radio, y añadiendo 180 grados a su ángulo.

Para cambiar los límites del eje r, utilice rlim.

Ejemplo: [1 2 3 4 5]

Z — Valores complejos

vector | matriz

Valores complejos, especificados como vector o matriz donde cada elemento tiene el formato rho*e^i*theta, o x+iy, donde:

• rho = sqrt(x^2+y^2)

• theta = atan(y/x)

Ejemplo: [1+2i 3+4i 3i]

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.

thetavar — Variables de tabla que contienen valores theta

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 los valores theta, especificados 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 cualquier tipo de datos numéricos reales. Si thetavar e rhovar especifican múltiples variables, el número de variables debe ser el mismo.

Ejemplo: polarplot(tbl,["th1","th2"],"rho") especifica las variables de tabla llamadas th1 y th2 para las coordenadas theta.

Ejemplo: polarplot(tbl,2,"rho") especifica la segunda variable para las coordenadas theta.

Ejemplo: polarplot(tbl,vartype("numeric"),"rho") especifica todas las variables numéricas para las coordenadas theta.

rhovar — Variables de tabla que contienen valores rho

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 los valores rho, especificados 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 cualquier tipo de datos numéricos reales. Si thetavar e rhovar especifican múltiples variables, el número de variables debe ser el mismo.

Ejemplo: polarplot(tbl,"theta",["rho1","rho2"]) especifica las variables de tabla llamadas rho1 y rho2 para los valores del radio.

Ejemplo: polarplot(tbl,"theta",2) especifica la segunda variable para los valores del radio.

Ejemplo: polarplot(tbl,"theta",vartype("numeric")) especifica todas las variables numéricas para los valores del radio.

pax — objeto PolarAxes

objeto PolarAxes

Objeto PolarAxes. Puede modificar la apariencia y el comportamiento de un objeto PolarAxes configurando sus propiedades. Para obtener una lista de las propiedades, consulte PolarAxes Properties.

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: 'LineWidth',3

La configuración del par Name,Value se aplica a todas las líneas representadas. No puede especificar pares Name,Value diferentes para cada línea utilizando esta sintaxis. En su lugar, devuelva los objetos línea de gráfica y utilice la notación de puntos para establecer las propiedades para cada línea.

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

Color — Color de línea

[0 0.4470 0.7410] (predeterminado) | 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

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 RGB	Código de color hexadecimal	Apariencia
[0 0.4470 0.7410]	"#0072BD"
[0.8500 0.3250 0.0980]	"#D95319"
[0.9290 0.6940 0.1250]	"#EDB120"
[0.4940 0.1840 0.5560]	"#7E2F8E"
[0.4660 0.6740 0.1880]	"#77AC30"
[0.3010 0.7450 0.9330]	"#4DBEEE"
[0.6350 0.0780 0.1840]	"#A2142F"

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.

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

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

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 RGB	Código de color hexadecimal	Apariencia
[0 0.4470 0.7410]	"#0072BD"
[0.8500 0.3250 0.0980]	"#D95319"
[0.9290 0.6940 0.1250]	"#EDB120"
[0.4940 0.1840 0.5560]	"#7E2F8E"
[0.4660 0.6740 0.1880]	"#77AC30"
[0.3010 0.7450 0.9330]	"#4DBEEE"
[0.6350 0.0780 0.1840]	"#A2142F"

Sugerencias

• Para convertir datos de grados a radianes, utilice deg2rad. Para convertir un ángulo de radianes a grados, utilice rad2deg.

• Puede modificar las propiedades de los ejes polares para personalizar la gráfica. Para obtener una lista de las propiedades, consulte PolarAxes Properties.

• Para representar datos adicionales en los ejes polares, utilice el comando hold on. Sin embargo, no puede representar datos que requieran ejes cartesianos en una gráfica polar.

Historial de versiones

Introducido en R2016a

R2022b: Las gráficas creadas con tablas conservan los caracteres especiales en las etiquetas de leyendas

Cuando pase una tabla y uno o más nombres de variables a la función polarplot, las etiquetas de leyendas pasan a mostrar 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 polarplot y, a continuación, muestra una leyenda, el guion bajo aparece en la etiqueta de leyendas. En la versión R2022a y en las anteriores, el guion bajo se interpreta como subíndice.

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

Para mostrar las etiquetas de leyendas con formato TeX o LaTeX, llame a la función legend con las cadenas de etiquetas que desee después de representarlas. Por ejemplo:

legend(["Sample_Number" "Another_Legend_Label"])

R2022a: Pasar tablas directamente a polarplot

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

• deg2rad | rad2deg | rlim

Propiedades

• PolarAxes Properties | Line Properties

Temas

• Representación en coordenadas polares
• Plots That Support Tables