![cht=s&chd=t:12,87,75,41,23,96,68,71,34,9|98,60,27,34,56,79,58,74,18,76|42,11,33,40,22,4FF5,30,45,32,4FF5,30,45,32,4FF5](https://developers.google.cn/static/chart/image/images/chart_291.png?authuser=1&hl=es)
En este documento, se describe cómo crear diagramas de dispersión con la API de Chart.
Índice
Funciones específicas del gráfico
|
Funciones estándares
|
Introducción
Un diagrama de dispersión (o diagrama de dispersión) es un conjunto de puntos individuales en un gráfico bidimensional. Si lo deseas, puedes especificar el tamaño de los puntos individuales. Un diagrama de dispersión solo puede aceptar una serie de datos. Los diagramas de dispersión son útiles para detectar agrupaciones o patrones en muchos datos que tienen dos variables (si solo tienes una variable, considera un gráfico de líneas).
Debes proporcionar al menos dos series de datos: la primera especifica coordenadas X y la segunda especifica coordenadas Y.
De manera opcional, puedes proporcionar una tercera serie para especificar tamaños de puntos individuales. Sin esta serie, todos los puntos tendrán 10 píxeles de ancho de manera predeterminada.
Ten en cuenta que, si usas chm
para modificar la forma o el color de los datos, estos se escalarán en relación con el tamaño proporcionado en chm
.
Tipos de gráficos (cht
)
Especifica un diagrama de dispersión con esta sintaxis:
Sintaxis
cht=s chd=<x_values>|<y_values>[|<optional_point_sizes>]
Descripción | Ejemplo |
---|---|
El marcador predeterminado para los puntos de datos es un círculo azul. Para usar otro color o forma, especifica los marcadores de forma con el parámetro Este gráfico varía la cantidad de puntos porque incluye una tercera serie de datos. |
|
Si deseas simular varias series con colores, usa el parámetro Este gráfico tiene tres series de datos: la primera corresponde a los valores X, la segunda son los valores Y correspondientes y la tercera es el tamaño de punto correspondiente. El valor La leyenda se asigna con el parámetro |
![]() chd=t: |
Para variar la forma de los puntos, usa marcadores de forma. Los marcadores de forma se comportan de manera ligeramente diferente en los diagramas de dispersión a otros gráficos, según su orden en el parámetro
Más sugerencias sobre el uso de marcadores de forma:
|
![]() chm=d,FF0000,0,-1,15 Establece la forma predeterminada en diamante (d) ![]() chm= La configuración predeterminada es un diamante ( d ), el índice del marcador 15 y las versiones posteriores son cuadrados (s ) superpuestos sobre los diamantes.![]() chd=t: |
También puedes agregar un marcador de línea (
|
![]() chd=t:
|
A continuación, se muestra cómo crear una línea de seguimiento a través de tus puntos sin depender de los puntos visibles:
Los diagramas de dispersión no se pueden usar como gráficos compuestos, por lo que no puedes agregar una serie adicional para describir la línea. No puedes especificar una línea punteada usando este método, pero sí puedes especificar el color y el grosor de la línea. |
Línea de seguimiento con puntos ocultos:chd=t: |
Colores de la serie chco
Especifica el color de los puntos mediante el parámetro chco
. Puedes especificar un solo color para todos los puntos, un gradiente o colores para puntos individuales.
Sintaxis
chco=<single_color> or chco=<point_1_color>|...|<point_n_color> or chco=<gradient_start>,...,<gradient_end> (only with third data series)
- <color>
- El color de los puntos, en formato hexadecimal RRRGGBB.
Existen diferentes formatos:
- Especifica un único color para aplicar a todos los puntos.
- Para aplicar colores individuales a puntos individuales, especifica un color por punto, con un delimitador de barra vertical.
- Si especificas colores de puntos individuales, pero tienes menos colores que puntos, cada n.o punto recibe el color n correspondiente n. Esta es la manera de crear un diagrama de dispersión de varias series.
- Para aplicar un gradiente de color, debes incluir una tercera serie de datos (que determina los tamaños de los puntos). Incluye dos o más colores separados por comas para aplicar un gradiente de color a los puntos según el tamaño del punto.
Funciones estándares
El resto de las funciones de esta página son funciones estándar del gráfico.
Título del gráfico chtt
, chts
[Todos los gráficos]
Puedes especificar el texto, el color y el tamaño de fuente del título para tu gráfico.
Sintaxis
chtt=<chart_title> chts=<color>,<font_size>,<opt_alignment>
chtt
: Especifica el título del gráfico.
- <chart_title>
- Título que se mostrará para el gráfico. No puedes especificar dónde aparece esta opción, pero sí puedes especificar el tamaño y el color de la fuente. Usa el signo + para indicar los espacios y un carácter de barra vertical (
|
) para indicar los saltos de línea.
chts
(opcional): Colores y tamaño de fuente del parámetro chtt
.
- <color>
- Es el color del título, en formato hexadecimal RRRGGBB. El color predeterminado es el negro.
- <font_size>
- Es el tamaño de la fuente del título, en puntos.
- <opt_alignment>
- [Opcional] Alineación del título Elige uno de los siguientes valores de cadena que distinguen mayúsculas de minúsculas: "l" (izquierda), "c" (centrado) "r" (derecha). La configuración predeterminada es “c”.
Ejemplos
Descripción | Ejemplo |
---|---|
Un gráfico con un título, con el color y el tamaño de fuente predeterminados. Especifica un espacio con un signo más ( Usa un carácter de barra vertical (
|
![]() chtt=Site+visitors+by+month| |
Un gráfico con un título azul de 20 puntos alineado a la derecha. |
![]() chtt=Site+visitors |
Estilo y texto de la leyenda del gráfico chdl
, chdlp
, chdls
[Todos los gráficos]
La leyenda es una sección lateral del gráfico que ofrece una pequeña descripción de texto de cada serie. Puedes especificar el texto asociado con cada serie de esta leyenda y especificar en qué lugar del gráfico debe aparecer.
Consulta también chma
para aprender a establecer los márgenes en tu leyenda.
Nota sobre los valores de cadena: Solo se permiten caracteres seguros para URL en las cadenas de etiquetas. Para estar seguro, debes codificar en formato URL las strings que contengan caracteres que no se encuentren en el grupo de caracteres 0-9a-zA-Z
.
Puedes encontrar un codificador de URL en la documentación de visualización de Google.
Sintaxis
chdl=<data_series_1_label>|...|<data_series_n_label> chdlp=<opt_position>|<opt_label_order> chdls=<color>,<size>
chdl
: Es el texto de cada serie que se mostrará en la leyenda.
- <data_series_label>
- Es el texto de las entradas de la leyenda. Cada etiqueta se aplica a la serie correspondiente en el array
chd
. Usa el signo + para agregar un espacio. Si no especificas este parámetro, el gráfico no tendrá una leyenda. No hay forma de especificar un salto de línea en una etiqueta. Por lo general, la leyenda se expandirá para conservar el texto de la leyenda, y el área del gráfico se reducirá para acomodar la leyenda.
chdlp
: [Opcional] La posición de la leyenda y el orden de las entradas de la leyenda. Puedes especificar <position> o <label_order>. Si especificas ambas, sepáralas con un carácter de barra. Puedes agregar una “s” a cualquier valor si deseas que las entradas de leyenda vacías de chdl
se omitan en la leyenda. Ejemplos: chdlp=bv
, chdlp=r
, chdlp=bv|r
, chdlp=bvs|r
- <opt_position>
- [Opcional] Especifica la posición de la leyenda en el gráfico. Para especificar un padding adicional entre la leyenda y el área del gráfico o el borde de la imagen, usa el parámetro
chma
. Elige uno de los siguientes valores:b
: Leyenda en la parte inferior del gráfico, entradas de leyenda en una fila horizontal.bv
: Leyenda en la parte inferior del gráfico, entradas de leyenda en una columna vertical.t
: Leyenda en la parte superior del gráfico, entradas de leyenda en una fila horizontal.tv
: Leyenda en la parte superior del gráfico, entradas de leyenda en una columna vertical.r
: [Predeterminado] Leyenda a la derecha del gráfico; entradas de leyenda en una columna vertical.l
: Leyenda a la izquierda del gráfico, entradas de leyenda en una columna vertical.
- <opt_label_order>
- (opcional)
Es el orden en el que se muestran las etiquetas en la leyenda.
Elige uno de los siguientes valores:
l
- [Predeterminado para leyendas verticales] Muestra las etiquetas en el orden asignado achdl
.r
: Muestra las etiquetas en el orden inverso, como se indica enchdl
. Esto es útil en los gráficos de barras apiladas para mostrar la leyenda
en el mismo orden en que aparecen las barras.a
: [Predeterminado para leyendas horizontales] Orden automático: Significa ordenar por longitud (el más corto primero), según la medición en bloques de 10 píxeles. Cuando dos elementos tienen la misma longitud (divididos en bloques de 10 píxeles), aparecerá primero el de la lista.0,1,2...
: Orden de etiquetas personalizado. Esta es una lista de índices de etiquetas basados en cero dechdl
, separados por comas.
chdls
: [opcional] especifica el color y el tamaño de la fuente del texto de la leyenda.
- <color>
- El color del texto de la leyenda, en formato hexadecimal RRRGGBB.
- <size>
- El tamaño de punto del texto de la leyenda.
Ejemplos
Descripción | Ejemplo |
---|---|
Dos ejemplos de leyendas. Especifica el texto de la leyenda en el mismo orden que tus series de datos. |
chdl=NASDAQ|FTSE100|DOW
chdl=First|Second|Third |
En el primer gráfico, se muestran las entradas de leyenda horizontales ( |
|
En este ejemplo, se muestra cómo cambiar el tamaño de fuente. |
|
Márgenes de gráficos chma
[todos
los gráficos]
Puedes especificar el tamaño en píxeles de los márgenes del gráfico. Los márgenes se calculan a partir del tamaño del gráfico especificado (chs
). Aumentar el tamaño del margen no aumenta el tamaño total del gráfico, sino que reduce el área del gráfico, si es necesario.
De forma predeterminada, los márgenes son los que quedan después de calcular el tamaño del gráfico. Este valor predeterminado varía según el tipo de gráfico. Los márgenes que especificas son un valor mínimo. Si el área del gráfico deja lugar para los márgenes, el tamaño del margen será el que quede. No puedes apretar los márgenes más pequeños de lo necesario para cualquier leyenda o etiqueta. A continuación, se incluye un diagrama en el que se muestran las partes básicas de un gráfico:
![]() |
Los márgenes del gráfico incluyen las etiquetas de ejes y el área de la leyenda. El área de la leyenda cambia su tamaño automáticamente para ajustarse al texto con exactitud, a menos que especifiques un ancho mayor con Sugerencia: En un gráfico de barras, si las barras tienen un tamaño fijo (el valor predeterminado), no se puede reducir el ancho del área del gráfico. Debes especificar un tamaño de barra más pequeño o que se pueda cambiar de tamaño con |
Sintaxis
chma= <left_margin>,<right_margin>,<top_margin>,<bottom_margin>|<opt_legend_width>,<opt_legend_height>
- <left_margin>, <right_margin>, <top_margin> y <bottom_margin>
- Tamaño de margen mínimo alrededor del área del gráfico, en píxeles Aumenta este valor para incluir algo de padding y evitar que las etiquetas de los ejes profundicen en los bordes del gráfico.
- <opt_legend_width>, <opt_legend_height>
- [Opcional] Es el ancho del margen alrededor de la leyenda, en píxeles. Usa esta opción para evitar que la leyenda aparezca sobre el área del gráfico o los bordes de la imagen.
Ejemplos
Descripción | Ejemplo |
---|---|
En este ejemplo, el gráfico tiene un margen mínimo de 30 píxeles por cada lado. Debido a que la leyenda del gráfico tiene más de 30 píxeles de ancho, el margen del lado derecho se establece en el ancho de la leyenda del gráfico y es diferente de los demás márgenes. Las etiquetas de los ejes están fuera del área de trazado y, por lo tanto, se dibujan dentro del espacio del margen. |
|
Para agregar un margen alrededor de la leyenda, establece un valor para los parámetros En este ejemplo, la leyenda tiene aproximadamente 60 píxeles de ancho. Si estableces |
|
Estilos y etiquetas de ejes [línea, barra, Google-o-meter, radar, dispersión]
Puedes especificar qué ejes mostrar en el gráfico y asignarles etiquetas y posiciones personalizadas, rangos y estilos.
No todos los gráficos muestran las líneas de los ejes de forma predeterminada. Puedes especificar exactamente qué ejes debe mostrar tu gráfico mediante el parámetro chxt
. Las líneas del eje predeterminadas no muestran números. Debes especificar un eje en el parámetro chxt
para que se muestren los números.
Puedes elegir que tus ejes muestren números que reflejen los valores de datos, o bien puedes especificar ejes personalizados.
La configuración predeterminada muestra valores numéricos,
con valores escalados en un rango de 0 a 100.
Sin embargo, puedes cambiar ese rango usando chxr
para mostrar cualquier rango y puedes aplicar diseño a los valores (por ejemplo, para mostrar símbolos de moneda o decimales) con chxs
.
Si eliges usar valores personalizados, por ejemplo, "Lun, Mar, Mié", puedes usar el parámetro chxl
.
Para colocar estas etiquetas en ubicaciones específicas a lo largo del eje, usa el parámetro chxp
.
Por último, puedes usar los parámetros chxs
y chxtc
para especificar el color, el tamaño, la alineación y otras propiedades de las etiquetas de eje personalizadas y numéricas.
Nota sobre los valores de cadena: Solo se permiten caracteres seguros para URL en las cadenas de etiquetas. Para estar seguro, debes codificar en formato URL las strings que contengan caracteres que no se encuentren en el grupo de caracteres 0-9a-zA-Z
.
Puedes encontrar un codificador de URL en la documentación de visualización de Google.
En esta sección, se abarcan los siguientes temas:
- Ejes visibles (
chxt
): Indica qué ejes mostrar. - Rango de eje (
chxr
): Es el rango de valores para cada eje. - Etiquetas de eje personalizadas (
chxl
): Valores personalizados para mostrar en el eje. - Posiciones de las etiquetas del eje (
chxp
): - Colocación de etiquetas personalizadas en cada eje. - Estilos de etiquetas de ejes (
chxs
): Color, tamaño, alineación y formato de las etiquetas de ejes. - Estilos de marcas de eje (
chxtc
): Es la longitud de las marcas de un eje específico.
Ejes visibles chxt
Los diagramas de barras, líneas, radares y dispersión muestran una o dos líneas de eje de forma predeterminada, pero estas líneas no incluyen valores.
Para mostrar valores en las líneas de tus ejes o cambiar los ejes que se muestran, debes usar el parámetro chxt
.
De forma predeterminada, los valores de los ejes varían de 0 a 100, a menos que los escales de forma explícita con la propiedad chxr
. Para ocultar todas las líneas del eje en un gráfico de líneas, especifica :nda
después del valor del tipo de gráfico en el parámetro cht
(por ejemplo: cht=lc:nda
).
De forma predeterminada, los ejes inferior y superior no muestran las marcas de los valores, mientras que los ejes izquierdo y derecho sí las muestran. Puedes cambiar este comportamiento con el parámetro chxs
.
Sintaxis
chxt= <axis_1> ,..., <axis_n>
- <axis>
- Un eje que se mostrará en el gráfico. Los ejes
disponibles son los siguientes:
x
- Eje X inferiort
: Eje x superior [no compatible con Google-o-Meter]y
Eje Y izquierdor
: Eje Y derecho [no compatible con Google-o-Meter]
Puedes especificar varios ejes del mismo tipo, por ejemplo: cht=x,x,y
. Esto apilará dos conjuntos de ejes X en la parte inferior del gráfico. Esto es útil cuando se agregan etiquetas personalizadas en un eje que muestra valores numéricos (consulta el siguiente ejemplo). Los ejes se dibujan de adentro hacia afuera, por lo tanto, si tienes x,x
, la primera x se refiere a la copia más interna, la siguiente x se refiere a la siguiente copia hacia afuera, y así sucesivamente.
Ejemplos
Descripción | Ejemplo |
---|---|
En este ejemplo, se muestra un gráfico de líneas con un eje X, un eje Y, un eje superior (t) y un eje derecho (r). Debido a que no se especifican etiquetas, el gráfico se establece de forma predeterminada en un rango de 0 a 100 para todos los ejes. Ten en cuenta que, de forma predeterminada, los ejes inferior y superior no muestran marcas junto a las etiquetas. |
|
Puedes incluir varios conjuntos de etiquetas para cada eje si incluyes el mismo valor más de una vez. En este ejemplo, se muestran dos conjuntos de x y dos conjuntos de ejes Y. Esto no es muy útil cuando se usan solo las etiquetas de eje predeterminadas, como se muestra aquí. Sin embargo, puedes especificar etiquetas personalizadas para cada copia de cada eje mediante el parámetro chxl . |
<img <code="" dir="ltr" src="/static/chart/image/images/chart_41.png" title="chxt=x,x,y,y&cht=lc&chd=s:cEAELFJHHHKUju9uuXUc&chco=76A4FB&chls=2.0&chs=200x1"translate="nox2" |
En este ejemplo, se muestra un gráfico de barras horizontales con un eje X, un eje Y, un eje T superior y un eje R derecho. Las etiquetas de los ejes se omiten, por lo que la API de Chart muestra un rango de 0 a 100 para el eje x y el t. El rango del eje y y del eje r está determinado por el número de barras. En este caso, hay cinco barras, por lo que la API de gráficos muestra un rango de 0 a 4. La primera etiqueta se centra en la base de la primera barra, la segunda etiqueta se centra en la base de la segunda barra y así sucesivamente. |
|
Para suprimir los ejes predeterminados en un gráfico de líneas, especifica :nda después del tipo de gráfico. |
![]() cht=lc:nda |
Rango del eje chxr
Puedes especificar el rango de valores que aparecen en cada eje de forma independiente, mediante el parámetro chxr. Ten en cuenta que esto no cambia la escala de los elementos del gráfico, solo la escala de las etiquetas del eje. Si deseas que los números de los ejes describan los valores de datos reales, configura <start_val> y <end_val> en los valores inferior y superior de tu rango de formato de datos, respectivamente. Consulta Escalamiento de eje para obtener más información.
Debes hacer que un eje sea visible con el parámetro chxt
si deseas especificar su rango.
Para especificar los valores del eje personalizado, usa el parámetro chxl
.
Sintaxis
Separa los rangos de etiquetas de varios ejes con el carácter de barra vertical ( |
).
chxr= <axis_index>,<start_val>,<end_val>,<opt_step> |...| <axis_index>,<start_val>,<end_val>,<opt_step>
- <axis_índice>
- Eje al que se aplicarán las etiquetas. Este es un índice basado en cero en el array de eje que especifica
chxt
. Por ejemplo, el eje r sería 1 enchxt=x,r,y
. - <start_val>
- Es un número que define el valor bajo para este eje.
- <end_val>
- Es un número que define el valor alto para este eje.
- <opt_step>
- [Opcional] Es el paso de recuento entre las marcas del eje. No hay un valor de paso predeterminado; el paso se calcula para intentar mostrar un conjunto de etiquetas bien espaciadas.
Ejemplos
Descripción | Ejemplo |
---|---|
En este ejemplo, se muestran los ejes Y izquierdo y derecho ( Cada eje tiene un rango definido. Debido a que no se especifican etiquetas ni posiciones, los valores se toman del rango especificado y se separan de forma uniforme dentro de ese rango. En el gráfico de líneas, los valores se extienden de manera uniforme a lo largo del eje X. La dirección del eje se invierte para el eje r (índice |
|
En este ejemplo, se especifican los valores para el eje X. Las etiquetas de los ejes están espaciadas uniformemente a lo largo del eje. Se especifica un valor de cinco ( |
|
Etiquetas personalizadas de los ejes chxl
Puedes especificar etiquetas de eje de string personalizadas en cualquier eje con el parámetro chxl
. Puedes especificar tantas etiquetas como desees. Si muestras un eje (con el parámetro chxt
) y no especificas etiquetas personalizadas, se aplicarán las etiquetas numéricas estándar.
Para especificar un rango numérico personalizado, usa el parámetro chxr
.
Para establecer ubicaciones específicas a lo largo del eje para tus etiquetas, usa el parámetro chxp
.
Sintaxis
Especifica un conjunto de parámetros para cada eje que deseas etiquetar. Separa varios conjuntos de etiquetas con el carácter de barra vertical (|
).
chxl= <axis_index>:|<label_1>|...|<label_n> |...| <axis_index>:|<label_1>|...|<label_n>
- <axis_índice>
- Eje al que se aplicarán las etiquetas. Este es un índice en el array de parámetros
chxt
. Por ejemplo, si tieneschxt=x,x,y,y
, el índice 0 sería el primer eje X, 1 sería el segundo eje X. - <label_1>| ... |<label_n>
- Una o más etiquetas para colocar a lo largo de este eje. Pueden ser valores numéricos o de cadena; no es necesario que las cadenas estén entre comillas. label_1 se muestra en la posición más baja del eje, y label_n se muestra en la posición más alta. Las etiquetas adicionales se separan de forma uniforme entre ellas.
Indica los espacios con un signo +. No hay forma de especificar un salto de línea en una etiqueta. Separa las etiquetas con un carácter de barra vertical. Nota: No coloques una canalización después de la etiqueta final en el parámetro
chxl
.
Ejemplos
Descripción | Ejemplo |
---|---|
En este gráfico, se muestra cómo agregar etiquetas personalizadas a dos ejes. Observa cómo los valores están espaciados de manera uniforme y que el último valor |
![]() chxt=x,y |
En este ejemplo, se incluyen etiquetas de eje en los ejes Y izquierdo y derecho ( |
|
En este ejemplo, se incluyen etiquetas de eje en los ejes Y izquierdo y derecho ( En este ejemplo, se usan valores predeterminados para las etiquetas del eje del eje Y de la izquierda. |
|
Si deseas agregar una etiqueta genérica para describir un eje completo (por ejemplo, para etiquetar un eje como "costo" y otro "estudiante"), usa la propiedad |
![]() chxt=x,x,y,y |
Posiciones de la etiqueta de eje chxp
Puedes especificar qué etiquetas de eje se mostrarán, ya sea con las etiquetas predeterminadas o las personalizadas especificadas con chxl
. Si no especificas posiciones exactas con este parámetro, las etiquetas se espacarán de manera uniforme y se establecerán en un valor de paso predeterminado a lo largo de los ejes. Si no especificas chxl
, las etiquetas de marca de verificación serán los valores predeterminados (por lo general, valores de datos o números de barras en los gráficos de barras).
Sintaxis
Separa varios conjuntos de posicionamiento con el carácter de barra vertical (|
).
chxp= <axis_1_index>,<label_1_position>,...,<label_n_position> |...| <axis_m_index>,<label_1_position>,...,<label_n_position>
- <axis_índice>
- Es el eje para el que especificas las posiciones. Este es un índice del array de parámetros
chxt
. Por ejemplo, si tieneschxt=x,x,y,y
, el índice 0 sería el primer eje X, 1 sería el segundo eje X, y así sucesivamente. - <label_1_position>,...,<label_n_position>
- : Es la posición de la etiqueta en el eje. Esta es una lista de valores numéricos separada por comas, en la que cada valor establece la posición de la etiqueta correspondiente en el array
chxl
: la primera entrada se aplica a la primera etiqueta y así sucesivamente. La posición es un valor en el rango de ese eje. Ten en cuenta que este valor siempre será de 0 a 100, a menos que hayas especificado un rango personalizado conchxr
. Debes tener tantas posiciones como etiquetas para ese eje.
Ejemplos
Descripción | Ejemplo |
---|---|
En este ejemplo, se incluyen etiquetas del eje R en posiciones especificadas del gráfico. El texto de la etiqueta se especifica con el parámetro Las etiquetas con una posición especificada de Las etiquetas con una posición especificada de |
|
En este ejemplo, se muestra cómo mostrar los valores predeterminados de las etiquetas, pero solo en ubicaciones específicas.
|
chxt=x,y
![]() chxt=x,y chxp no especificado |
Estilos de etiqueta de eje chxs
Puedes especificar el tamaño, el color y la alineación de la fuente para las etiquetas de ejes, tanto personalizadas como predeterminados. Todas las etiquetas en el mismo eje tienen el mismo formato. Si tienes varias copias de un eje, puedes formatear cada una de manera diferente. También puedes especificar el formato de una cadena de etiqueta, por ejemplo, para mostrar símbolos de moneda o ceros finales.
De forma predeterminada, los ejes inferior y superior no muestran las marcas de los valores, mientras que los ejes izquierdo y derecho sí las muestran.
Sintaxis
Los valores de varios ejes se deben separar con un carácter de barra vertical (|
).
chxs= <axis_index><opt_format_string>,<opt_label_color>,<opt_font_size>,<opt_alignment>,<opt_axis_or_tick>,<opt_tick_color>,<opt_axis_color> |...| <axis_index><opt_format_string>,<opt_label_color>,<opt_font_size>,<opt_alignment>,<opt_axis_or_tick>,<opt_tick_color>,<opt_axis_color>
- <axis_index>
- El eje al que se aplica esto. Este es un índice basado en cero en el parámetro
chxt
. - <opt_format_string>
- [Opcional] Esta es una string de formato opcional que, si se usa, sigue inmediatamente después del número de índice del eje sin una coma intermedia. Comienza
con una letra N literal seguida de los
siguientes valores (opcional):
N<preceding_text>*<number_type><decimal_places>zs<x or y>*<following_text>
Este es el significado de cada elemento:<preceding_text>
: Texto literal que antecede a cada valor.*...*
: Es un bloque opcional unido a asteriscos literales, en el que puedes especificar los detalles de formato de los números. Se admiten los siguientes valores y son opcionales:<number_type>
: Es el formato de número, para valores numéricos. Elige una de estas opciones:f
: Es el formato de punto flotante (predeterminado). Considera especificar también la precisión con el valor <decimal_places>.p
: formato de porcentaje. Se agregará un signo % automáticamente. Nota: Cuando usas este formato, los valores de los datos entre 0.0 y 1.0 se asignan a 0 - 100% (por ejemplo, 0.43 se mostrará como 43%).e
: formato de notación científica.c<CUR>
: Aplica al número el formato de la moneda especificada con el marcador de moneda correspondiente. Reemplaza<CUR>
por un código de moneda de tres letras. Ejemplo:cEUR
para euros Puedes encontrar una lista de códigos en el sitio web ISO, aunque no todos los símbolos son compatibles.
<decimal_places>
: Es un número entero que especifica cuántos decimales se mostrarán. El valor se redondea (no truncado) a esta longitud. El valor predeterminado es 2.z
: Muestra ceros finales. La configuración predeterminada es no.s
: Muestra separadores de grupo. La configuración predeterminada es no.x
oy
: Muestran los datos de las coordenadas X o Y, según lo especificado. El significado de los datos x varía según el tipo de gráfico: experimenta con tu gráfico para determinar qué significa. El valor predeterminado es "y".
<following_text>
: Texto literal que sigue a cada valor.
- <opt_label_color>
- Es el color que se aplica al texto del eje (pero no al de la línea del eje), en formato hexadecimal RRRGGBB. El color de la línea del eje se especifica por separado con opt_axis_color. La configuración predeterminada es el gris.
- <opt_font_size>
- [Opcional] especifica el tamaño de la fuente en píxeles. Este parámetro es opcional.
- <opt_alignment>
- [Opcional] Alineación de la etiqueta. En el caso de los ejes superior e inferior, esto describe cómo se alinea la etiqueta con la marca de verificación que está por encima o por debajo. Para los ejes izquierdo o derecho, esto describe cómo se alinea dentro de su cuadro delimitador, que toca el eje. Especifica uno de los siguientes números:
-1
: Parte superior o inferior: Las etiquetas están a la derecha de las marcas; izquierda o derecha: Las etiquetas están alineadas a la izquierda en su área. Predeterminado para etiquetas del eje r.0
: Parte superior o inferior: Las etiquetas están centradas en las marcas. Izquierda o derecha: Las etiquetas están centradas en su área. Predeterminado para etiquetas del eje x y t.1
: Parte superior o inferior: Las etiquetas están a la izquierda de las marcas; izquierda o derecha: Las etiquetas están alineadas a la derecha en su área. Predeterminado para etiquetas del eje y.
- <opt_axis_or_tick>
- [Opcional; no admitido en Google-o-meter] Indica si se deben mostrar marcas o líneas de eje para este eje. Las comillas simples y las líneas de los ejes solo están disponibles para los ejes más internos (por ejemplo, no se admiten para el exterior de dos ejes X). Usa uno de los siguientes valores:
l
(“L” minúscula): Dibuja solo la línea del eje.t
: Dibuja solo marcas. Las marcas de tilde son las pequeñas líneas que están junto a las etiquetas de eje.lt
: [Predeterminado] Dibuja una línea de eje y las marcas de verificación de todas las etiquetas._
: (guion bajo) no dibuja ninguna línea de eje ni marcas de verificación. Si deseas ocultar una línea de eje, usa este valor.
- <tick_color>
- [Opcional; no se admite en Google-o-meter] Es el color de la marca de verificación, en formato hexadecimal RRGGBB. La configuración predeterminada es el gris.
- <opt_axis_color>
- [Opcional] Es el color de esta línea del eje, en formato hexadecimal RRGGBB. La configuración predeterminada es el gris.
Ejemplos
Descripción | Ejemplo |
---|---|
El tamaño y el color de la fuente se especifican para el segundo eje x (enero, febrero y mar). |
|
El tamaño, el color y la alineación de la fuente se especifican para el eje Y derecho. Se dibujan las marcas de marca, pero no la línea de eje. |
|
En este gráfico, se incluyen tres conjuntos de datos y se muestran tres conjuntos de etiquetas de eje, uno por serie. Cada conjunto de etiquetas se formatea con una cadena de formato personalizado, como se describe a continuación:
Los rangos de etiquetas de eje se establecen usando el parámetro |
![]() chd=s: |
Estilos de marca de verificación de eje chxtc
Puedes especificar marcas largas para ejes específicos. Por lo general, se usa para extender una marca de verificación a lo largo de la longitud de un gráfico. Usa el parámetro chxs
para cambiar el color de la marca.
Los valores de varios ejes se deben separar con un carácter de barra vertical (|
). Los valores dentro de una serie deben separarse con una coma.
Sintaxis
chxtc= <axis_index_1>,<tick_length_1>,...,<tick_length_n> |...| <axis_index_m>,<tick_length_1>,...,<tick_length_n>
- <axis_index>
- El eje al que se aplica esto. Este es un índice basado en cero en el parámetro
chxt
. Separa los valores para diferentes ejes con un delimitador de barras. - <tick_length_1>,...,<tick_length_n>
- La longitud de las marcas de ese eje, en píxeles. Si se proporciona un solo valor, se aplicará a todos los valores. Si se proporciona más de un valor, las marcas de verificación del eje rotarán por la lista de valores para ese eje. Los valores positivos se dibujan fuera del área del gráfico y se recortan según los bordes del gráfico. El máximo valor positivo es 25. Los valores negativos se dibujan dentro del área del gráfico y se recortan según los bordes del área.
Ejemplos
Descripción | Ejemplo |
---|---|
Ejemplo del uso de
|
|
En este gráfico, se muestran longitudes de marcas alternas. chxtc especifica dos valores de longitud de marca para el eje y (5 y 15), y las marcas dibujadas en el gráfico alternan entre los dos valores. |
![]() chxt=x,y |
El fondo rellena chf
[todos los gráficos]
Puedes especificar colores de relleno y estilos para el área de datos o todo el fondo del gráfico. Los tipos de relleno incluyen rellenos sólidos, rellenos a rayas y gradientes.
Puedes especificar diferentes rellenos para distintas áreas (por ejemplo, toda el área del gráfico o solo el área de datos). El relleno del área del gráfico reemplaza el relleno del fondo. Todos los rellenos se especifican con el parámetro chf
y puedes mezclar diferentes tipos de relleno (sólidos, rayas, gradientes) en el mismo gráfico separando los valores con el carácter de barra vertical ( | ). Los rellenos del área del gráfico reemplazan los rellenos del fondo del gráfico.
Rellenos sólidos chf
[Todos los gráficos]
Puedes especificar un relleno sólido para el fondo o el área del gráfico, o bien asignar un valor de transparencia a todo el gráfico. Puedes especificar varios rellenos con el carácter de barra vertical (|
). (Maps: solo en segundo plano).
Sintaxis
chf=<fill_type>,s,<color>|...
- <fill_type>
- La parte del gráfico que se rellena. Especifica uno de los siguientes valores:
bg
: Relleno de fondoc
: Relleno del área del gráfico. No es compatible con los gráficos de mapas.a
: Haz que todo el gráfico (incluidos los fondos) sea transparente. Los primeros seis dígitos de<color>
se ignoran y solo los dos últimos (el valor de transparencia) se aplican a todo el gráfico y a todos los rellenos.b<index>
: Rellenos sólidos de barras (solo gráficos de barras). Reemplaza <index> por el índice de serie de las barras para rellenar con un color sólido. El efecto es similar al de especificarchco
en un gráfico de barras. Consulta Colores de la serie del gráfico de barras para ver un ejemplo.
- s
- Indica un relleno sólido o de transparencia.
- <color>
- Es el color de relleno, en formato hexadecimal RRRGGBB. En el caso de las transparencias, los primeros seis dígitos se ignoran, pero deben incluirse de todos modos.
Ejemplos
Descripción | Ejemplo |
---|---|
En este ejemplo, se rellena el fondo del gráfico con gris pálido ( |
|
En este ejemplo, se rellena el fondo del gráfico con gris pálido ( |
|
En este ejemplo, se aplica una transparencia del 50% a todo el gráfico (80 en hexadecimal es 128, o alrededor del 50% de transparencia). Observa el fondo de celda de la tabla que se muestra a través del gráfico. |
|
Rellenos de gradientes chf
[línea, barra, Google-o-meter, radar, dispersión,Venn]
Puedes aplicar uno o más rellenos de gradientes a áreas o fondos del gráfico. Los rellenos de gradientes son fundidos de un color a otro. (Gráficos circulares de Google-o-Meter: solo fondo).
Cada relleno de gradiente especifica un ángulo y, luego, dos o más colores fijados a una ubicación específica. El color varía a medida que se mueve de un ancla a otro. Debes tener al menos dos colores con diferentes valores de <color_centerpoint> para que uno pueda difuminarse en el otro. Cada gradiente adicional se especifica con un par <color>,<color_centerpoint>.
Sintaxis
chf=<fill_type>,lg,<angle>,<color_1>,<color_centerpoint_1> ,..., <color_n>,<color_centerpoint_n>
- <fill_type>
- El área del gráfico que se debe completar. Uno de los siguientes:
bg
: Relleno de fondoc
: Relleno del área del gráfico.b<index>
: Rellenos de gradientes de barras (solo gráficos de barras). Reemplaza <index> por el índice de serie de las barras para rellenar con un gradiente. Consulta Colores de la serie del gráfico de barras para ver un ejemplo.
- lg
- Especifica un relleno de gradiente.
- <angle>
- Es un número que especifica el ángulo del gradiente de 0 (horizontal) a 90 (vertical).
- <color>
- Es el color del relleno, en formato hexadecimal RRGGBB.
- <color_centerpoint>
- Especifica el punto de anclaje para el color. El color comenzará a desvanecerse a partir de este punto a medida que se acerque a otro ancla. El rango de valores va de 0.0 (borde inferior o izquierdo) a 1.0 (borde superior o derecho), inclinado en el ángulo especificado por <angle>.
Ejemplos
Descripción | Ejemplo |
---|---|
El área del gráfico tiene un gradiente lineal horizontal, especificado con un ángulo de cero grados ( Los colores son durazno ( El fondo del gráfico se dibuja en gris ( |
|
El área del gráfico tiene un gradiente lineal diagonal (de abajo a la izquierda a arriba a la derecha), especificado con un ángulo de cuarenta y cinco grados ( El primer color especificado es el durazno ( El azul ( El fondo del gráfico se dibuja en gris ( |
|
El área del gráfico tiene un gradiente lineal vertical (de arriba abajo), especificado con un ángulo de noventa grados ( El primer color especificado es azul ( El durazno ( El fondo del gráfico se dibuja en gris ( |
|
Rellenos a rayas chf
[Línea, Barra, Google-o-meter, Radar, Dispersión, Venn]
Puedes especificar un relleno de fondo a rayas para el área de tu gráfico o para todo el gráfico. (Gráficos circulares de Google-o-Meter: solo fondo).
Sintaxis
chf= <fill_type>,ls,<angle>,<color_1>,<width_1> ,..., <color_n>,<width_n>
- <fill_type>
- El área del gráfico que se debe completar. Uno de los siguientes:
bg
: Relleno de fondoc
: Relleno del área del gráficob<index>
: Rellenos a rayas de barras (solo gráficos de barras). Reemplaza <index> por el índice de serie de las barras para rellenar con rayas. Consulta Colores de la serie del gráfico de barras para ver un ejemplo.
- ls
- Especifica el relleno de franjas lineales.
- <angle>
- Es el ángulo de todas las rayas, en relación con el eje Y. Usa
0
para las rayas verticales o90
para las horizontales. - <color>
- Es el color de esta franja, en formato hexadecimal RRRGGBB. Repite los valores <color> y <width> para cada línea adicional. Debes tener al menos dos rayas. Las rayas se alternan hasta que se completa el gráfico.
- <width>
- El ancho de esta franja, de
0
a1
, donde1
es el ancho completo del gráfico. Las rayas se repiten hasta que se completa el gráfico. Repite los valores <color> y <width> para cada franja adicional. Debes tener al menos dos rayas. Las rayas se alternan hasta que se completa el gráfico.
Ejemplos
Descripción | Ejemplo |
---|---|
|
![]() chf= |
|
![]() chf= |
Líneas de cuadrícula chg
[Línea, barra, radar, dispersión]
Puedes especificar líneas de cuadrícula sólidas o de puntos en tu gráfico con el parámetro chg
.
Este parámetro no te permite especificar el grosor ni el color de las líneas. Para conocer otras formas de crear líneas en tu gráfico, consulta los marcadores de forma (chm
tipo h, H, v o V), los marcadores de rango (chm
) y las marcas de marcas de ejes (chxtc
).
Sintaxis
chg= <x_axis_step_size>,<y_axis_step_size>,<opt_dash_length>,<opt_space_length>,<opt_x_offset>,<opt_y_offset>
- <x_axis_step_size>, <y_axis_step_size>
- Se usa para calcular cuántas líneas de cuadrícula "x" e "y" se mostrarán en el gráfico. 100 / step_size = cuántas líneas de cuadrícula hay en el gráfico. Por lo tanto, 20,25 significaría 5 líneas de cuadrícula verticales y 4 líneas de cuadrícula horizontales.
- <opt_dash_length>, <opt_space_length>
- [Opcional] Se usa para definir líneas de cuadrícula punteadas. El primer parámetro es la longitud de cada línea punteada, en píxeles. El segundo parámetro es el espaciado entre guiones, en píxeles. Especifica 0 en <opt_space_length> para una línea continua. Los valores predeterminados son 4,1.
- <opt_x_offset>,<opt_y_offset>
- Opcional: Es la cantidad de unidades, según la escala del gráfico, para desplazar las líneas de cuadrícula x e y, respectivamente. Pueden ser valores positivos o negativos. Si especificas este valor, también debes especificar todos los valores anteriores. Los valores predeterminados son 0,0.
Ejemplos
Descripción | Ejemplo |
---|---|
En estos ejemplos, solo se usan los parámetros |
![]() chg=20,50 ![]() chg=20,50 |
En este ejemplo, se usan espacios más grandes para mostrar líneas de cuadrícula más claras ( |
![]()
|
Para mostrar líneas de cuadrícula sólidas, especifica cero ( Este gráfico también especifica un desplazamiento del eje X de 10. |
![]() chg=20,50,1,0,10 |
En este gráfico, se muestra un desplazamiento del eje X de 10 y un desplazamiento del eje Y de 20. |
![]() chg=20,50,3,3,10,20 |
Marcadores de íconos dinámicos chem
[barra, línea, radar, dispersión]
Crea tu gráfico y especifica uno o más íconos dinámicos como valores químicos. La sintaxis de chem
es la siguiente: Todos los elementos delimitados por punto y coma son opcionales
y se puede omitir cualquiera en la URL. Si deseas incluir varios marcadores, incluye varias cadenas de sintaxis delimitadas por un carácter |. Puedes obtener más información sobre los íconos dinámicos en la página de íconos dinámicos.
También puedes incorporar un gráfico dentro de otro gráfico como ícono dinámico. Consulta la subsección Gráficos incorporados a continuación.
chem= y;s=<icon_string_constant>;d=<marker_data_string>;ds=<which_series>;dp=<which_points>;py=<opt_z_order>;po=<x,y>;of=<x_offset,y_offset>
|...| y;s=<icon_string_constant>;d=<marker_data_string>;ds=<which_series>;dp=<which_points>;py=<opt_z_order>;po=<x,y>;of=<x_offset,y_offset>
- s=<icon_string_constant>
- Es una constante de marcador de cadena para un ícono dinámico de la página de ícono dinámico. Esta constante es casi la misma que el parámetro
chst
para los íconos independientes. Sin embargo, donde la string de ícono independiente comienza con "d_", debes quitar ese prefijo para obtener el marcador de ícono dinámico equivalente. Ejemplo: Ícono independiente:d_bubble_icon_text_small
; marcador de ícono dinámico equivalente:bubble_icon_text_small
. - d=<marker_data_string>
- Los datos necesarios para este tipo de marcador en particular. Esto contiene la misma cadena que se usaría en un parámetro
chld
para un ícono independiente equivalente, excepto que todos los delimitadores | deben reemplazarse por comas (recuerda usar comas en lugar de marcadores de barra vertical para el texto de varias líneas). Ten en cuenta que, dentro de la string de datos, también debes escapar los siguientes caracteres con una marca @: barra vertical ( | ) , en ( @ ), igual ( = ), coma ( , ) y punto y coma ( ). Ejemplos:hello@,+world
,5@@10+cents+each
. - ds=<which_series>
- [Opcional] Es el índice basado en cero de la serie de datos a la que pertenece este marcador. El valor predeterminado es 0.
- dp=<which_points>
- [Opcional] Especifica qué datos se usan para dibujar marcadores. El valor predeterminado es 0 (primer punto de la serie). Utiliza uno de los siguientes formatos:
n.d
: Es el dato sobre el que se dibujará el marcador, donde n.d es el índice basado en cero de la serie. Si especificas un valor que no es un número entero, la fracción indica un punto intermedio calculado. Por ejemplo, 3.5 significa a mitad de camino entre los puntos 3 y 4.range,<start>,<end>,<step>
: Dibuja un marcador en cada dato de paso en un rango de inicio a fin inclusive. El inicio y el fin son valores de índice y pueden ser números de punto flotante para indicar valores intermedios. Todos los valores son opcionales; las opciones predeterminadas son: start=0, end=last item, step=1. Si omites un valor, debes incluir las comas intermedias, pero no las comas finales vacías. Ejemplos:dp=range,0,4
dibuja un marcador en los elementos 0 a 4;dp=range,5,10,2
dibuja un marcador en los elementos 5, 7 y 9;dp=range,2
dibuja puntos en el tercer punto y en los posteriores;dp=range,3,,1.5
dibuja marcadores en cada 1.5 datos desde el cuarto elemento hasta el último.all
: Dibuja un marcador en cada elemento. Esto equivale arange,0,end_index
. Ejemplo:dp=all
every,n
: Dibuja un marcador en cada enésimo marcador. Ejemplo:dp=every,2
dibuja un marcador en los elementos 0, 2 y 4.
- py=<z_order>
- [Opcional] Es la capa en la que se dibuja el marcador, en comparación con otros marcadores y todos los demás elementos del gráfico. Este es un número de punto flotante de -1.0 a 1.0 inclusive, donde -1.0 es la parte inferior y 1.0 es la parte superior. Los elementos del gráfico (líneas y barras) se encuentran justo debajo de cero. Si dos marcadores tienen el mismo valor, se dibujan en el orden que establece la URL. El valor predeterminado es 0.0 (justo encima de los elementos del gráfico).
- po=<x,y>
- [Opcional] Posición absoluta en el gráfico en la que se debe dibujar el marcador. x e y son dos números de punto flotante, en los que 0.0,0.0 es la esquina inferior izquierda y 1.0,1.0 es la esquina superior derecha.
- of=<x_offset,y_offset>
- [Opcional] Cantidad de píxeles para desplazar el ícono de su posición normal. y_offset e y_offset son números enteros positivos o negativos. Es importante especificar este valor en un ícono dinámico incorporado, ya que el marcador se centrará de manera vertical y horizontal sobre el punto, lo que significa que es probable que este no se alinee con el marcador de datos. Un buen desplazamiento para un pin vertical es
of=0,22
; un buen desplazamiento para un pin inclinado esof=-12,20
oof=12,20
, según la dirección de la inclinación, pero es posible que debas experimentar. El valor predeterminado es 0,0.
Ejemplos
Descripción | Ejemplo |
---|---|
A continuación, se muestran ejemplos del mismo ícono dinámico creado como imagen independiente y usado como marcador en un gráfico de líneas.
Gráfico 1: Gráfico 2: |
|
Ten en cuenta que un marcador de ícono dinámico se centrará en el punto horizontal y vertical. Por lo tanto, si utilizas un ícono dinámico con una cola, esta no estará en el punto del gráfico, sino que lo estará el centro del marcador. El primer gráfico centra la marca en el punto de datos 3, que en realidad coloca la cola un poco a la derecha de la marca en la línea. El segundo gráfico utiliza el valor |
![]() chem=y;
chem=y; |
Para incluir varios íconos dinámicos, repite la string de sintaxis, delimitada por un carácter |. En este ejemplo, se muestra un rango y dos marcadores individuales. Observa cómo los pines verticales están desplazados en 0,22, y el inclinado tiene un desplazamiento de 12,20 para que los puntos se alineen con la serie que describen. |
![]() chem= |
Esto demuestra un marcador de texto de varias líneas. El marcador se debe desplazar después de agregar el texto, ya que la burbuja cambia de tamaño para adaptarse al texto y hacer que se vuelva a centrar en el gráfico. Ten en cuenta que las líneas nuevas del texto se indican con comas en la cadena de datos d . |
![]() chem=y; |
Gráficos incorporados
Puedes incorporar un gráfico dentro de otro con la sintaxis de íconos dinámicos.
Existen dos estilos de marcadores de gráficos incorporados: gráficos incorporados en una burbuja y gráficos incorporados sin burbuja. A continuación, se muestran ejemplos de ambos:
![]() |
![]() |
Gráfico con burbuja |
Gráfico sin burbuja |
A continuación, se presentan las características específicas de los parámetros s=<icon_string_constant>;d=<marker_data_string>
, tanto para los gráficos sin burbujas como para los gráficos integrados con burbujas (los parámetros mencionados anteriormente no se describen de nuevo aquí):
Sintaxis
Non-bubble: chem=y;s=ec;d=<alignment_string>,<chart_data>;ds=<which_series>;dp=<which_points>;py=<z_order>;po=<x,y>;of=<x_offset,y_offset> Bubble: chem=y;s=ecb;d=<frame_type>,<padding>,<frame_color>,<fill_color>,<chart_data>;ds=<which_series>;dp=<which_points>;py=<z_order>;po=<x,y>;of=<x_offset,y_offset>
- alignment_string
- [Solo en burbujas] Qué parte del gráfico incorporado sin burbujas se fija al punto de datos. Elige una de las constantes de cadena de dos letras del siguiente diagrama:
- chart_data
- Los datos del gráfico incorporado Es todo lo que aparece después de
https://chart.googleapis.com/chart?
en la URL del gráfico que se incorporará. Usa la herramienta que aparece a continuación o sigue las reglas que se indican debajo de ella. - frame_type
- [Solo burbuja] Una de las constantes de estilo de marco de los íconos dinámicos.
- padding
- [Solo burbuja] Padding dentro de la burbuja, en píxeles.
- frame_color
- [Solo burbuja] Color del marco, como una cadena de color HTML de seis dígitos sin la marca #. Ejemplo:
FF00FF
. - fill_color
- [Solo burbuja] Color de relleno de la burbuja, como una cadena de color HTML de seis dígitos sin el signo #. Ejemplo:
FF00FF
.
Datos de gráfico incorporados
Usa la siguiente herramienta de conversión para ayudarte a generar la cadena del gráfico, o bien genera la cadena de forma manual según las reglas que se establecen después de la herramienta.
Reglas para la conversión manual
1. Primero, reemplaza todos los caracteres siguientes en los pares de parámetros y valores por los siguientes valores, en el orden que se muestra:
Reemplazar | Con este |
---|---|
%7C o %7c |
| |
@ |
@@ |
% |
%25 |
, |
@, |
| |
@| |
; |
@; |
y |
%26 |
= |
%3D |
2. Luego, reemplaza todos los valores &
y =
de los pares parameter1=value1¶meter2=value2...
por comas.
Marcadores de forma chm
[Barra, línea, radar, dispersión]
Puedes especificar marcadores gráficos para todos los datos o para cada uno de ellos. Si dos o más marcadores ocupan el mismo punto, se dibujan en el orden en que aparecen en el parámetro chm
.
También puedes crear marcadores de texto en puntos de datos. Este tema se trata en la sección Marcadores de puntos de datos.
Puedes combinar marcadores de forma con cualquier otro parámetro chm
mediante un carácter de barra vertical ( |
) para separar los parámetros chm
.
Sintaxis
Especifica un conjunto de los siguientes parámetros para cada serie que se debe marcar. Para marcar varias series, crea conjuntos de parámetros adicionales, delimitados por un carácter de barra vertical. No es necesario que marques todas las series. Si no asignas marcadores a una serie de datos, no obtendrá ningún marcador.
Los marcadores de forma se comportan de manera ligeramente diferente en los gráficos de dispersión. Consulta esa documentación para obtener más información.
chm= [@]<marker_type>,<color>,<series_index>,<opt_which_points>,<size>,<opt_z_order>,<opt_offset> |...| [@]<marker_type>,<color>,<series_index>,<opt_which_points>,<size>,<opt_z_order>,<opt_offset>
- @
- (opcional) Si antecede el tipo de marcador con el carácter opcional @, entonces <opt_which_points> debe usar el formato x:y.
- <marker_type>
- Es el tipo de marcador que se usará. Especifica uno de los siguientes tipos:
a
: Flechac
- CruzC
: Rectángulo. Si se trata de un marcador rectangular, debes tener al menos dos series de datos, donde la serie 0 especifica el borde inferior y la serie 1 especifica el borde superior. <size> especifica el ancho del rectángulo en píxeles.d
: DiamanteE
: Marcador de barra de error (). Este marcador requiere que se creen dos series de datos, un valor para la parte inferior y el punto correspondiente de la segunda serie para la parte superior. También expone una sintaxis <size> extendida: line_thickness[:top_and_bottom_width], en la que top_and_bottom_width es opcional. Consulta los ejemplos que aparecen a continuación
h
: Es una línea horizontal del gráfico a una altura especificada. (El único formato válido para el parámetro <opt_which_points> es n.d).H
: Línea horizontal que atraviesa el marcador de datos especificado. Esto admite una sintaxis <size> extendida que te permite especificar una longitud de línea exacta: line_thickness[:length], en la que :length es opcional y se establece de forma predeterminada en el ancho completo del área del gráfico.o
: Círculos
: Cuadradov
: Línea vertical desde el eje x hasta el punto de datosV
: Línea vertical de longitud ajustable. Esto admite una sintaxis de valor <size> extendida que te permite especificar una longitud de línea exacta: line_thickness[:length], en la que :length es opcional y se establece de forma predeterminada en la altura del área completa del gráfico. El marcador se centra en el punto de datos.x
: Una X
- <color>
- Es el color de los marcadores de esta serie, en formato hexadecimal RRRGGBB.
- <series_index>
- : Es el índice basado en cero de la serie de datos en la que se dibujarán los marcadores. Se ignora para los marcadores
h
y los que especifican la ubicación por posición x/y (comienza con el carácter @). Puedes usar series de datos ocultos como fuente de marcadores. Consulta Gráficos compuestos para obtener más información. Los gráficos de barras verticales agrupadas admiten una sintaxis extendida especial para alinear marcadores con barras específicas. - <opt_which_points>
- [Opcional] En qué puntos se deben dibujar los marcadores. La configuración predeterminada es "Todos los marcadores". Usa uno de los siguientes valores:
n.d
: Indica dónde dibujar el marcador. El significado depende del tipo de marcador:- Todos los tipos excepto h: Es el punto de datos sobre el que se dibujará el marcador, donde n.d es el índice basado en cero de la serie. Si especificas un valor que no es un número entero, la fracción indica un punto intermedio calculado. Por ejemplo, 3.5 significa a mitad de camino entre los puntos 3 y 4.
h
: Es un número del 0.0 al 1.0, en el que 0.0 es la parte inferior y 1.0 es la parte superior.
-1
: Dibuja un marcador en todos los datos. También puedes dejar este parámetro vacío para dibujar en todos los datos.-n
: dibuja un marcador en cada dato n-ésimo. Es un valor de punto flotante. Si n es menor que 1, el gráfico calculará los puntos intermedios adicionales por ti. Por ejemplo, -0.5 colocará el doble de marcadores que los datos.start:end:n
: Dibuja un marcador en cada dato n-ésimo de un rango, desde los valores de índice start hasta end inclusive. Todos los parámetros son opcionales (es posible que no estén), por lo que 3::1 estaría desde el cuarto elemento al último, el paso 1, y si se omite este parámetro por completo, el valor predeterminado será first:last:1. Todos los valores pueden ser números de punto flotante. start y end pueden ser negativos, para contar hacia atrás desde el último valor. Si start y end son negativos, asegúrate de que aparezcan en valores crecientes (por ejemplo, -6:-1:1). Si el valor del paso n es menor que 1, se calcularán datos adicionales mediante la interpolación de los valores de datos proporcionados. Los valores predeterminados son first:last:1x:y
: Dibuja un marcador en un punto x/y específico del gráfico. No es necesario que este punto esté en una línea. Agrega el carácter @ antes del tipo de marcador para utilizar esta opción. Especifica las coordenadas como valores de punto flotante, en el que0:0
es la esquina inferior izquierda del gráfico y1:1
es la esquina superior derecha. Por ejemplo, para agregar un diamante rojo de 15 píxeles en el centro de un gráfico, usa@d,FF0000,0,0.5:0.5,15
.
- <size>
- El tamaño del marcador en píxeles. La mayoría toma un valor numérico único para este parámetro. Los marcadores V, H y S admiten la sintaxis <size>[:width], en la que la segunda parte opcional especifica la línea o la longitud del marcador.
- <opt_z_order>
- [Opcional] Es la capa en la que se dibuja el marcador en comparación con otros marcadores y todos los demás elementos del gráfico. Este es un número de punto flotante de -1.0 a 1.0 inclusive, donde -1.0 es la parte inferior y 1.0 es la parte superior. Los elementos del gráfico (líneas y barras) son solo inferiores a cero. Si dos marcadores tienen el mismo valor, se dibujan en el orden que establece la URL. El valor predeterminado es 0.0 (justo encima de los elementos del gráfico).
- <opt_offset>
- Opcional: Te permite especificar desplazamientos horizontales y verticales desde la ubicación especificada. Esta es la sintaxis, que usa un delimitador:
reserved:<horizontal_offset>:<vertical_offset>
. Si se especifica, puedes incluir un valor , vacío en la cadena del parámetrochm
para <opt_z_order>. Ejemplos:o,FF9900,0,4,12,,:10 o,FF9900,0,4,12.0,,:-10:20 o,FF9900,0,4,12,1,::20
- reservado: Deja este campo en blanco.
<horizontal_offset>
: Es un número positivo o negativo que especifica el desplazamiento horizontal en píxeles. Opcional; déjalo en blanco si no se usa.<vertical_offset>
: Es un número positivo o negativo que especifica el desplazamiento vertical, en píxeles. Opcional; déjalo en blanco si no se usa.
Ejemplos
Descripción | Ejemplo |
---|---|
A continuación, se muestra un ejemplo de varios de los marcadores de forma y línea.
|
![]() chm= |
A continuación, se muestra un ejemplo en el que se usan diamantes para una serie de datos y círculos para la otra. Si dos o más marcadores ocupan el mismo punto, se dibujan en el orden en que aparecen en el parámetro |
![]() chm= |
A continuación, se muestra un gráfico de líneas con un marcador cada segundo punto de datos (-2 significa cada dos puntos). |
![]() chd=t: |
Este es un gráfico de líneas con el doble de marcadores que los datos (-0.5 significa cada medio punto). | ![]() chd=t: |
En este ejemplo, se muestra cómo usar los marcadores h y v para crear líneas de cuadrícula con colores y grosores personalizados. El valor de orden z (el último valor) se establece en -1 para que las líneas de la cuadrícula se dibujen debajo de la línea de datos. |
![]() chm= |
En este gráfico, se agregan líneas de relleno verticales a un gráfico de líneas:
|
![]() chm= |
En este ejemplo, se agrega una flecha y un marcador de texto al gráfico con coordenadas exactas. El primer marcador D es la línea de trazado debajo de las barras. El segundo marcador es la flecha y el tercer marcador es el texto de la flecha. | ![]() chm= |
Una línea horizontal fijada a un dato específico (H ) puede ser útil para mostrar valores relativos o enfatizar la altura de un valor de datos en un gráfico. |
![]() chm=H,FF0000,0,18,1 |
En este gráfico, se muestran los marcadores que pueden especificar el grosor y la longitud de las líneas en el parámetro <size>.
|
title="cht=lc&chd=s:2gounjqLaCf,jqLaCf2goun&chco=008000,00008033&chls=2.0,4.0,1.0&chs=250x150&chm=H,990066,1,7,5:50%,990066,1,9,5:50%,990066,17:9:50%chm=
|
Marcadores de valores de datos y texto chm
[barras, líneas, radares, dispersión]
Puedes etiquetar puntos específicos del gráfico con texto personalizado o versiones de los datos con formato en esos puntos.
Puedes combinar cualquier marcador chm
utilizando un carácter de barra vertical ( |
) para separar los conjuntos de parámetros chm
.
Nota sobre los valores de cadena: Solo se permiten caracteres seguros para URL en las cadenas de etiquetas. Para estar seguro, debes codificar en formato URL las strings que contengan caracteres que no se encuentren en el grupo de caracteres 0-9a-zA-Z
.
Puedes encontrar un codificador de URL en la documentación de visualización de Google.
Sintaxis
Especifica un conjunto de los siguientes parámetros para cada serie que se debe marcar. Para marcar varias series, crea conjuntos de parámetros adicionales, delimitados por un carácter de barra vertical. No es necesario que marques todas las series. Si no asignas marcadores a una serie de datos, no obtendrá ningún marcador.
chm= <marker_type>,<color>,<series_index>,<opt_which_points>,<size>,<opt_z_order>,<opt_placement> |...| <marker_type>,<color>,<series_index>,<opt_which_points>,<size>,<opt_z_order>,<opt_placement>
- <marker_type>
- Es el tipo de marcador que se usará. Puedes elegir entre los siguientes tipos:
f<text>
: Es una marca que contiene texto. Especifica el carácter “f”, seguido del texto con codificación de URL personalizada. Para escapar las comas en los marcadores de texto, coloca la coma antes de ella con \. Ejemplo:fHello\,+World!
t<text>
: Es un marcador de texto simple. Especifica el carácter “t” seguido del texto codificado para URL personalizada. Para escapar las comas en los marcadores de texto, coloca la coma antes de ella con \. Ejemplo:tHello\,+World!
A<text>
: Es un marcador de anotación. Es similar a un marcador de marca, pero coordinará su posición para que no se superpongan. El único formato válido para <opt_which_points> es n.d, que indica el índice de un punto de la serie.N<formatting_string>
: Es el valor de los datos actuales, con formato opcional. Si no usas el parámetrochds
(ajuste de escala personalizado), se obtiene el valor codificado exacto. Si usas ese parámetro con cualquier tipo de formato, el valor se escalará al rango que especifiques. A continuación, puedes ver un ejemplo dechds
con marcadores numéricos. Con este tipo de marcador en un gráfico de barras apiladas, si especificas -1 para <series_index>, obtendrás un marcador que muestra la suma de todos los valores de esta barra apilada. La sintaxis de la cadena de formato es la siguiente:
<preceding_text>*<number_type><decimal_places>zs<x or y>*<following_text>
.
Todos estos elementos son opcionales. A continuación, se explica el significado de cada elemento:<preceding_text>
: Es el texto que antecede a cada valor.*...*
: Es un bloque opcional unido a asteriscos literales, en el que puedes especificar los detalles de formato de los números. Se admiten los siguientes valores y son opcionales:<number_type>
: Es el formato de número, para valores numéricos. Elige una de estas opciones:f
: Es el formato de punto flotante (predeterminado). Considera especificar también la precisión con el valor <decimal_places>.p
: formato de porcentaje. Se agregará un signo % automáticamente. Nota: Cuando usas este formato, los valores de los datos entre 0.0 y 1.0 se asignan a 0 - 100% (por ejemplo, 0.43 se mostrará como 43%).e
: formato de notación científica.c<CUR>
: Aplica al número el formato de la moneda especificada con el marcador de moneda correspondiente. Reemplaza<CUR>
por un código de moneda de tres letras. Ejemplo:cEUR
para euros Puedes encontrar una lista de códigos en el sitio web ISO, aunque no todos los símbolos se admiten.
<decimal_places>
: Es un número entero que especifica cuántos decimales se mostrarán. El valor se redondea (no truncado) a esta longitud. El valor predeterminado es 2.z
: Muestra ceros finales. La configuración predeterminada es no.s
: Muestra separadores de grupo. La configuración predeterminada es no.x
oy
: Muestran los datos de las coordenadas X o Y, según lo especificado. El significado de los datos x varía según el tipo de gráfico: experimenta con tu gráfico para determinar qué significa. El valor predeterminado es "y".
<following_text>
: Texto que sigue cada valor.
- <color>
- : Es el color de los marcadores de este conjunto, en formato hexadecimal RRRGGBB.
- <series_index>
- : Es el índice basado en cero de la serie de datos en la que se dibujarán los marcadores. Si se trata de un gráfico de barras apiladas y el tipo de marcador es N (valores de datos), puedes especificar -1 para crear un marcador de valor sumado para cada pila de barras. Consulta a continuación un ejemplo.
- <opt_which_points>
- [Opcional] En qué puntos se deben dibujar los marcadores. La configuración predeterminada es Todos los marcadores. Usa uno de los siguientes valores:
n.d
: Es el dato sobre el que se debe dibujar el marcador, donde n.d es el índice basado en cero de la serie. Si especificas un valor que no es un número entero, la fracción indica un punto intermedio calculado. Por ejemplo, 3.5 significa que está a mitad de camino entre los puntos 3 y 4.-1
: Dibuja un marcador en todos los datos. También puedes dejar este parámetro vacío para dibujar en todos los datos.-n
: dibuja un marcador en cada dato n-ésimo.start:end:n
: Dibuja un marcador en cada dato n-ésimo de un rango, desde los valores de índice start hasta end inclusive. Todos los parámetros son opcionales (es posible que no estén), por lo que 3::1 estaría desde el cuarto elemento al último, el paso 1, y si se omite este parámetro por completo, el valor predeterminado será first:last:1. Todos los valores pueden ser números de punto flotante. start y end pueden ser negativos, para contar hacia atrás desde el último valor. Si start y end son negativos, asegúrate de que aparezcan en valores crecientes (por ejemplo, -6:-1:1). Si el valor del paso n es menor que 1, se calcularán los datos adicionales mediante la interpolación de los valores de datos proporcionados. Los valores predeterminados son first:last:1x:y
- [No se admite para marcadores de tipo N] Dibuja un marcador en un punto x/y específico del gráfico. No es necesario que este punto esté en una línea. Para utilizar esta opción, agrega el carácter arroba (@
) antes del tipo de marcador. Especifica las coordenadas como valores de punto flotante, en el que0:0
es la esquina inferior izquierda del gráfico,0.5:0.5
es el centro y1:1
es la esquina superior derecha del gráfico. Por ejemplo, para agregar un diamante rojo de 15 píxeles en el centro de un gráfico, usa@d,FF0000,0,0.5:0.5,15
.
- <size>
- El tamaño del marcador en píxeles. Si se trata de un diagrama de dispersión con una tercera serie de datos (que se usa para especificar tamaños de puntos), este valor se escalará según el rango de datos. Por lo tanto, si el rango de datos es de 0 a 100 y <size> es 30, un valor de datos de 100 sería 30 píxeles de ancho, un valor de datos de 50 sería 15 píxeles de ancho, y así sucesivamente.
- <opt_z_order>
- [Opcional] Es la capa en la que se dibuja el marcador en comparación con otros marcadores y todos los demás elementos del gráfico. Este es un número de punto flotante de -1.0 a 1.0 inclusive, donde -1.0 es la parte inferior y 1.0 es la parte superior. Los elementos del gráfico (líneas y barras) son solo inferiores a cero. Si dos marcadores tienen el mismo valor, se dibujan en el orden que establece la URL. El valor predeterminado es 0.0 (justo por encima de los elementos del gráfico).
- <opt_placement>
- [Opcional] Son los detalles adicionales de la posición que describen dónde colocar este marcador en relación con el punto de datos. Puedes especificar la posición relativa horizontal o vertical, así como las compensaciones. La sintaxis de posición es una string con delimitadores
:, como se muestra aquí. Todos los elementos son opcionales:
<horizontal_and_vertical_justification>:<horizontal_offset>:<vertical_offset>
. Si se especifica, puedes incluir un valor , vacío en la cadena del parámetrochm
para <opt_z_order>. Ejemplos:N,000000,0,1,10,,b
,N,000000,0,1,10,,lv
yN,000000,0,1,10,,r::10
.- horizontal_and_vertical_justification
- Es el punto de anclaje del marcador. Este comportamiento es contrario a la justificación, de manera que un anclaje izquierdo en realidad coloca el marcador a la derecha del dato. Puedes elegir un justificador horizontal o vertical de la siguiente lista:
- Posición horizontal: “l”, “h” o “r”. Esta opción sirve para fijar objetos a la izquierda, en el centro o a la derecha, de forma horizontal. La configuración predeterminada es "l".
- Posición vertical: “b”, “v”, “t”. Anclado inferior, medio o superior, de forma vertical. La configuración predeterminada es "b".
- Posición relativa de barras [solo gráficos de barras]: “s”, “c”, “e”: Base, centro o parte superior de una barra. En el caso de los gráficos apilados, esto es relativo a la sección de la barra para cada serie, no para toda la barra. Si el índice de la serie dado es -1 (total de la pila), está en relación con toda la barra. Esto se puede combinar con valores de posición verticales, como "be" o "vs". El valor predeterminado es "e".
- horizontal_offset
- Es un desplazamiento horizontal para este marcador, en píxeles. El valor predeterminado es 0.
- vertical_offset
- Es un desplazamiento vertical para este marcador, en píxeles. Valor predeterminado del gráfico que no es de barras: 15; gráfico de barras predeterminado: 2.
Descripción | Ejemplo | |
---|---|---|
Este es un ejemplo de etiquetas de valor en un gráfico de barras. El primer gráfico ( En el segundo gráfico ( |
|
|
Puedes usar el parámetro En este ejemplo, se muestra un gráfico con valores de codificación simple de 46, 39, 29, 30, 43 y 41. El rango de codificación simple es de 0 a 61. El parámetro |
![]() chd=s:underp |
|
Este es un ejemplo de un gráfico con una etiqueta de texto en el punto mínimo y una etiqueta de marca en el punto máximo. |
|
|
En este ejemplo, se muestra un gráfico de barras apiladas con valores para series individuales, además del total de la serie. Para mostrar los valores de la serie apilada, debemos usar la opción de posicionamiento "c". Si no lo hicieran, el valor de la barra superior se superpondrá con el valor de suma en la parte superior de cada barra. | ![]() chm= |
|
Algunas demostraciones más de cómo funcionan las posiciones verticales y horizontales En este ejemplo, se muestran varias combinaciones de valores de anclaje para gráficos de barras (que usan s,c y e para la posición vertical). Observa cómo un anclaje derecho mueve un marcador hacia la izquierda, un ancla superior lo hace hacia abajo, y viceversa. Los puntos rojos muestran la base, el centro y la parte superior de cada barra. El número es el valor de los datos, fijado con diferentes valores de anclaje para cada barra. | ![]() chm= |
|
Los marcadores de anotaciones ajustan automáticamente la posición de la etiqueta para que no se superpongan. El primer valor de chm es para el relleno de línea. Los siguientes valores son todos marcadores de anotación. |
![]() chm=B,C5D4B5BB,0,0,0 |
|
Otro ejemplo de marcador de anotación que muestra la altitud de las ciudades en Suiza. | ![]() |
Marcadores de rango chm
[barra, vela, línea, radar, dispersión]
Puedes colorear bandas horizontales o verticales de relleno de fondo para resaltar áreas específicas de un gráfico.
Puedes combinar cualquier marcador chm
mediante un carácter de barra vertical ( |
) para separar los conjuntos de parámetros chm
.
Sintaxis
Especifica un conjunto de los siguientes parámetros para cada banda que se dibujará. Para dibujar varias bandas, crea conjuntos de parámetros adicionales, delimitados por un carácter de barra vertical. Los rangos se dibujan en el orden especificado; por lo tanto, el último rango dibujado se dibujará sobre los rangos anteriores.
chm= <direction>,<color>,0,<start_point>,<end_point> |...| <direction>,<color>,0,<start_point>,<end_point>
- <direction>
- Especifica el sombreado horizontal o vertical. Usa
r
para un rango horizontal yR
para un rango vertical. - <color>
- Es el color del rango como un número hexadecimal en formato RRGGBB.
- 0
- Reservado (debe ser cero)
- <start_point>
- Es la posición inicial del rango.
- En el caso de los marcadores de rango horizontales, esta es una posición en el eje y, donde
0.00
es la parte inferior del gráfico y1.00
es la parte superior. - En el caso de los marcadores de rango verticales, es una posición en el eje x, donde
0.00
es la izquierda del gráfico y1.00
es la derecha del gráfico.
- <end_point>
- La posición final del rango.
- En el caso de los marcadores de rango horizontales, esta es una posición en el eje y, donde
0.00
es la parte inferior del gráfico y1.00
es la parte superior. - En el caso de los marcadores de rango verticales, es una posición en el eje x, donde
0.00
es la izquierda del gráfico y1.00
es la derecha del gráfico.
Ejemplos
Descripción | Ejemplo |
---|---|
Los marcadores de rango pueden ser una línea fina o una banda de color.
|
![]()
|
En este ejemplo, se muestran los marcadores de rango vertical. El primer marcador es una línea roja ( |
![]()
|
Los marcadores se dibujan en el orden especificado. En este ejemplo, puedes ver que el marcador rojo vertical se dibujó antes que el marcador horizontal azul pálido. |
![]() chm= |
El siguiente es un ejemplo de un gráfico de líneas que usa marcadores de rango para dibujar líneas horizontales débiles en el gráfico en la línea cero, la línea de punto medio y la parte superior. |
![]()
|
Marcadores de línea chm=D
[Barra, vela, línea, radar, dispersión]
Puedes agregar una línea que realice un seguimiento de los datos en tu gráfico. En la mayoría de los casos, se usa en los gráficos compuestos.
Para agregar varias líneas (o combinar esto con cualquier otro marcador chm
), separa los conjuntos de parámetros chm con un delimitador de barra vertical ( |
). No se puede crear un marcador de línea punteada con este parámetro.
Sintaxis
chm= D,<color>,<series_index>,<which_points>,<width>,<opt_z_order>
- D
- Indica que se trata de un marcador de línea.
- <color>
- Es el color de la línea, en formato hexadecimal RRGGBB.
- <series_index>
- Es el índice de la serie de datos que se usa para trazar la línea. El índice de la serie de datos es
0
para la primera serie de datos,1
para la segunda serie de datos, y así sucesivamente. - <which_points>
- Qué puntos de una serie se deben usar para trazar la línea Usa uno de los siguientes valores:
0
: Usa todos los puntos de la serie.start:end
: Usa un rango específico de puntos en la serie, desde el inicio hasta el final, inclusive (índice basado en cero). También puedes usar valores de punto flotante para especificar puntos intermedios o dejar start o end en blanco para indicar el primer o el último dato, respectivamente. start y end pueden ser negativos, como índices inversos del último valor. Si start y end son negativos, asegúrate de escribirlos en un valor creciente (por ejemplo, -6:-1).
- <size>
- Es el ancho de la línea en píxeles.
- <opt_z_order>
- [Opcional] Es la capa en la que se dibuja el marcador en comparación con otros marcadores y todos los demás elementos del gráfico. Este es un número de punto flotante de -1.0 a 1.0 inclusive, donde -1.0 es la parte inferior y 1.0 es la parte superior. Los elementos del gráfico (líneas y barras) son solo inferiores a cero. Si dos marcadores tienen el mismo valor, se dibujan en el orden que establece la URL. El valor predeterminado es 0.0 (justo encima de los elementos del gráfico).
Ejemplos
Descripción | Ejemplo |
---|---|
A continuación, se muestra un ejemplo de cómo dibujar una línea de marcador en un gráfico de barras.
El orden z se establece en |
![]() chm=D,0033FF,0,0,5,1 |
Este es el mismo gráfico de barras, pero con una serie de datos adicional solo para la línea. Este es un ejemplo de un gráfico compuesto.
Los gráficos compuestos se dibujan agregando series de datos adicionales al parámetro Consulta los gráficos compuestos para obtener más información. |
![]() chm=D,0033FF,1,0,5,1 |
Funciones de datos chfd
[todos
chd
los gráficos]
Puedes especificar una función personalizada para que se ejecute en los datos del gráfico mediante la sintaxis de la función muParser. Los datos que se usan en la función pueden provenir de una de estas dos fuentes:
- Una serie de datos de
chd
: los datos se extraen de la serie especificada enchd
. - Un rango de valores declarados en el parámetro
chfd
. Debes declarar un valor de inicio, detención y paso para un rango de datos arbitrario.
Es importante tener en cuenta que, en todos los casos, debes asignar el resultado a una serie existente en chd
; esa serie se reemplazará por el resultado de la función. El gráfico se renderiza solo después de que se hayan procesado todas las funciones, por lo que, si asignas varias funciones para generar resultados a la misma serie de datos, las funciones se ejecutarán en el orden establecido, pero solo se trazará el resultado de la función final. Ten en cuenta que puedes encadenar funciones, de modo que una función pueda tomar como entrada una serie que generó una función anterior.
Para asignar colores o marcadores chm
a una línea de función, asigna los colores o marcadores al índice de serie de la función. Ten en cuenta que los marcadores se colocan de acuerdo con los datos después de que la función los manipuló.
Sintaxis
chfd= <output_series_index>,<function_data>,<function_string> |...| <output_series_index>,<function_data>,<function_string>
- <output_series_index>
- Índice basado en cero de una serie de datos en
chd
en la que se escribirá el resultado de la función. El resultado de la función reemplazará por completo los datos existentes. Si una serie no se usa como entrada para una función, la práctica recomendada es asignar un solo valor ficticio a esa serie. - <function_data>
- Las variables y los datos que se representarán. Los datos pueden pertenecer a un rango que definas o a una de las series de datos de
chd
. Puedes especificar múltiples variables para cada función con un delimitador (;) en varias variables. Ten en cuenta que si defines muchas variables para una sola función y estas tienen una cantidad de puntos diferente, la función se detendrá cuando alcance el primer extremo. Por ejemplo, si una función define tanto x=1-5 paso 1 como y=1-10 paso 1, la función finalizará cuando alcance el quinto punto.
<variable_name>,<input_series_index>
O
<variable_name>,<start>,<end>,<step>
- variable_name: Es un nombre de string arbitrario para la variable. Úsala en la función definida por function_string.
- input_series_index: Es el índice de una serie de datos
chd
que se usará como datos de entrada. - inicio: El valor inicial numérico de un rango.
- end: Valor final numérico de un rango.
- paso: El valor numérico del paso desde inicio hasta el final. Puede ser positivo o negativo, pero no puede ser cero.
x,0,100,1
declara una variable llamadax
con valores 0, 1, 2, ... 100.x,0,100,1;r,0,3.1,.1
declara la misma variablex
más una variable llamadar
con valores 0, 0.1, 0.2, ..., 3.0 y 3.1.x,0
declara una variable llamada x que usa los datos de la primera serie dechd
. function_string usará estas variables. No se trazarán en el gráfico a menos que los especifiques en function_string. Cuanto más pequeño sea el paso, más suave será el gráfico. - <function_string>
- Tu función, escrita en la sintaxis de muParser. La función se aplica a las variables y los datos especificados en variable_data.
Solo puedes hacer referencia a las variables declaradas en este conjunto de funciones locales, no en otro conjunto canalizado de parámetros
chfd
. No se admiten las funciones de resumen muParser (min, max sum, avg). IMPORTANTE: Recuerda usar%2B
en lugar de+
en tus funciones.
Ejemplos
Descripción | Ejemplo |
---|---|
Una onda sinusoidal simple. Debes tener en cuenta lo siguiente:
|
![]() cht=lc |
Esta línea usa datos del parámetro chd . |
![]() chd=t:5,10 |
Es una combinación de líneas funcionales y no funcionales. Observa cómo se especifican los colores con el parámetro de color de la serie Observa la ubicación de los marcadores en el resultado de la función; los datos se calculan desde start, end y step, por lo que si tu rango es de 0 a 11, paso 0.1, el punto 0 es 0, el punto 1 es 0.1 y así sucesivamente, hasta el punto 110, que tiene un valor de 11. |
![]() chd=t: |
Para definir una función en dos dimensiones, utiliza un gráfico
|
![]() cht=lxy |
El parámetro Haz clic en estas imágenes para abrirlas y jugar con ellas en la zona de pruebas. ¡Te atrapará! |