Gráficos circulares

   

En este documento, se describe cómo crear gráficos circulares con la API de gráficos.

Índice

Funciones específicas de los gráficos Descripción general Tipos de gráficos (cht) Colores de la serie (chco) Etiquetas de gráfico circular (chl) Rotación de gráfico circular (chp)

Funciones estándar Título del gráfico (chtt, chts) Texto y estilo de la leyenda del gráfico (chdl, chdlp, chdls) Márgenes del gráfico (chma) Background Fills (chf) Solid Fills (chf) Rellenos de gradientes (chf) Striped Fills (chf) [Relleno rayado] Funciones de datos (chfd)

Descripción general

Los gráficos circulares son ideales para mostrar información proporcional simple entre las partes y el todo. Puedes crear un gráfico circular de una sola serie, en el que cada serie esté compuesta por varias porciones o gráficos concéntricos de varias series.

Cada serie describe un gráfico y cada valor de datos especifica un segmento. Cuando uses gráficos circulares anidados (que se describen a continuación), usa varias series.

Para mostrar el texto asociado con una porción, deberás usar etiquetas de gráfico circular o una leyenda del gráfico. Las etiquetas del gráfico circular son texto alrededor del gráfico con líneas que apuntan hacia la porción. Las leyendas son texto asociado por color.

Etiquetas	Leyenda	Etiquetas y leyenda
chl=January|February|March|April	chdl=January|February|March|April	chl=January|February|March|April chdl=30°|40°|50°|60°

Los valores se muestran uno respecto del otro, por lo que un gráfico con valores 1, 2, 3 tendrá el mismo aspecto que un gráfico con valores 100,200,300. Sin embargo, cuando se usan datos de formato de texto, los valores superiores a 100 se recortan a 100, por lo que tendrás que usar formato de texto con escalamiento personalizado para mostrar secciones mayores que 100 correctamente (usa el parámetro chds con valores mínimos y máximos de chds=0,<max-slice-size>).

Los valores negativos se muestran como porciones vacías del tamaño adecuado.

Tipos de gráficos

Existen tres tipos generales de gráficos circulares que puedes crear: planos, concéntricos o 3D. Especifica un gráfico circular con la siguiente sintaxis:

Sintaxis

cht=<chart_type>

En el ejemplo anterior, <chart_type> es uno de los siguientes tipos:

Parámetro	Descripción	Ejemplo
p	Gráfico circular bidimensional Proporciona una sola serie de datos; se ignorarán las siguientes. De forma predeterminada, los colores de los segmentos circulares se interpolan de naranja oscuro a amarillo pálido. Especifica otros colores como se describe en Colores de serie. Especifica etiquetas con chl como se describe en Etiquetas de gráfico circular. La API de Google Chart calcula el radio del círculo a partir del ancho y la altura mínimos especificados en el parámetro de tamaño del gráfico (chs). Si incluyes etiquetas, es probable que debas especificar que el tamaño del ancho sea el doble del alto, para asegurarte de que las etiquetas sean totalmente visibles.	cht=p chs=200x100
p3	Gráfico circular tridimensional Especifica los datos y el formato de la misma manera que para los gráficos circulares bidimensionales. Si incluyes etiquetas en un gráfico circular tridimensional, es probable que debas especificar que el tamaño del ancho sea 2.5 veces el alto, para asegurarte de que las etiquetas sean totalmente visibles.	cht=p3 chs=250x100
pc	Gráfico circular concéntrico Proporciona dos o más series de datos.	cht=pc chd=s:Helo,Wrld
Todos los tipos	Los números negativos en los datos generan porciones "en blanco".	cht=pc chd=t: 10,-10,10,-10| 5,-5,5,-5,5,-5,5,-5,5,-5

 

Colores de la serie chco

Puedes especificar los colores de todos los valores, cada valor o algunos valores mediante el parámetro chco.

Sintaxis

chco=<slice_1>|<slice_2>|<slice_n>,<series_color_1>,...,<series_color_n>

<color>

Selecciona los colores en formato hexadecimal RRGGBB. Especifica un solo color de serie, y todas las secciones de esa serie se colorearán en graduaciones de ese color, desde el más oscuro (primer miembro de datos) hasta el más claro (el último miembro de datos). Especifica dos o más colores delimitados por | para describir los colores individuales de las porciones. Cuando tienes varias series (es decir, un gráfico con anillos concéntricos), puedes especificar valores para diferentes series si los separas con una coma. Cuando se proporcionan menos colores de segmentos o series que los que se muestran, el gráfico pasará del principio de la lista de segmentos de la serie o de la lista de series del gráfico. No puedes especificar un gradiente distinto para cada serie en un gráfico de varias series.

Descripción	Ejemplo
Especifica un solo color para que tenga graduaciones del más oscuro (primer segmento) al más claro (última división).	chco=0000FF
Definición de gradiente: aquí, de amarillo a rojo.	chd=t:10,20,30,40,50 chco=FFFF10,FF0000
Definir colores de porción individuales; especificar un color por porción	chd=t:10,20,30 chco=FF0000|00FF00|0000FF
Este gráfico tiene dos series de datos, pero especifica el color como un único gradiente en todos los segmentos de amarillo a rojo (BBBB00-BB0000).	chco=BBBB00,BB0000
Este es un gráfico concéntrico que incluye colores de serie y colores de porciones individuales. El gráfico tiene dos series de datos concéntricas. En formato legible, los colores son chco=verde|rojo,azul|amarillo. La coma separa esto en dos series: verde|rojo: Rebanadas verdes y rojas alternas. azul|amarillo: Rebanadas azules y amarillas alternadas.	chd=s:eYY,ORVM chco=008800|880000,000088|888800

Volver al principio

Etiquetas de gráfico circular chl

Puedes especificar etiquetas para porciones individuales del gráfico circular con el parámetro chl. También puedes mostrar una leyenda con valores iguales o diferentes, una entrada de leyenda por porción.

Nota sobre los valores de string: Solo se permiten caracteres seguros para URL en las strings de etiqueta. Para estar seguro, debes codificar en formato URL todas las strings que contengan caracteres que no se encuentren en el grupo de caracteres 0-9a-zA-Z. Puedes encontrar un codificador de URL aquí.

Sintaxis

chl=
  <label_value>|
    ...
  <label_value>

<label_value>

Es un valor de string para aplicar a una porción. Las etiquetas se aplican de forma consecutiva a los datos de chd. Si tienes varias series (para un gráfico circular concéntrico, por ejemplo), las etiquetas se aplican a todos los puntos de todas las secuencias, en el orden especificado en chd. Usa una barra vertical ( |) entre cada etiqueta. Especifica un valor intermedio faltante mediante dos caracteres de barra vertical consecutivos sin espacio entre ellos: || . No es necesario que etiquetes todas las partes.

 

Ejemplos

Descripción	Ejemplo
Etiquetas para un gráfico circular tridimensional.	chl=May|Jun|Jul|Aug|Sep|Oct chs=220x100
Cuando especifiques el tamaño de tu gráfico con chs, considera cuánto espacio necesitarán tus etiquetas. En general, un gráfico circular bidimensional debe ser aproximadamente el doble de ancho que su alto, y un gráfico circular tridimensional debe ser aproximadamente dos veces y media más ancho que alto para mostrar las etiquetas correctamente. En el primer ejemplo, las etiquetas solo se muestran parcialmente porque el gráfico no es lo suficientemente ancho. En el segundo ejemplo, se muestra que el gráfico necesita un ancho de 280 píxeles para mostrar las etiquetas en su totalidad. (Los bordes se agregan de forma explícita al elemento <img>).	chl=May|June|July|August| September|October chs=220x100 chl=May|June|July|August| September|October chs=280x100

Volver al principio

Rotación del gráfico circular chp

De forma predeterminada, la primera serie se dibuja a partir del minuto 3:00 y continúa en el sentido de las manecillas del reloj alrededor del gráfico, pero puedes especificar una rotación personalizada mediante el parámetro chp.

Sintaxis

chp=<radians>
  

<radians>

Un valor de punto flotante que describe cuántos radianes debe rotar el gráfico en el sentido de las manecillas del reloj. Una vuelta completa equivale a 2π (2 pi, aproximadamente 6.28) radianes.

Ejemplos

Descripción	Ejemplo
Para cambiar la orientación de un gráfico circular, usa chp=<angle_in_radians>	chd=t:20,80 chd=t:80,20 chp=0.628
Este es otro ejemplo de rotaciones de gráfico circular. Se pueden combinar con los marcadores de forma del gráfico para crear algunos efectos interesantes.

 

Volver al principio

Funciones estándares

El resto de los atributos de esta página son atributos de gráficos estándar.

Título del gráfico chtt, chts [Todos los gráficos]

Puedes especificar el texto del título, el color y el tamaño de la fuente de 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 para mostrar en el gráfico. No puedes especificar dónde aparece, pero puedes indicar, de manera opcional, el tamaño y el color de la fuente. Usa el signo + para indicar espacios y un carácter de barra vertical ( |) para indicar los saltos de línea.

 

chts [Opcional]: Colores y tamaño de fuente para el parámetro chtt.

<color>

Es el color del título, en formato hexadecimal RRGGBB. 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). El valor predeterminado 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 (|) para forzar un salto de línea. chts no se especifica aquí.	chtt=Site+visitors+by+month| January+to+July
Un gráfico con un título azul de 20 puntos alineado a la derecha.	chtt=Site+visitors chts=FF0000,20,r

Volver al principio

Texto y estilo 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 textual de cada serie. Puedes especificar el texto asociado a cada serie en esta leyenda y especificar el lugar del gráfico donde debe aparecer.

Consulta también chma para aprender a establecer los márgenes en la leyenda.

Nota sobre los valores de string: Solo se permiten caracteres seguros para URL en las strings de etiqueta. Para estar seguro, debes codificar en formato URL todas 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>

El texto de las entradas de la leyenda. Cada etiqueta se aplica a la serie correspondiente en el array chd. Usa la marca + para indicar un espacio. Si no especificas este parámetro, el gráfico no obtendrá una leyenda. No hay forma de especificar un salto de línea en una etiqueta. Por lo general, la leyenda se expandirá para contener el texto de la leyenda, y el área del gráfico se reducirá para acomodarla.

chdlp : Opcional: Es la posición de la leyenda y el orden de las entradas de la leyenda. Puedes especificar <position> o <label_order>. Si especificas ambos, sepáralos con un carácter de barra. Puedes agregar una “s” a cualquier valor si deseas que las entradas de leyenda vacías en 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 que se encuentra a la izquierda del gráfico y 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 a chdl.
• r: Muestra las etiquetas en el orden inverso, según se indica a chdl. 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, más corto primero, medido en bloques de 10 píxeles. Cuando dos elementos tienen la misma longitud (divididos en bloques de 10 píxeles), el que se enumera primero aparecerá primero.
• 0,1,2...: Orden de las etiquetas personalizadas. Esta es una lista de índices de etiquetas basados en cero de chdl, separados por comas.

chdls: Especifica el color y el tamaño de la fuente del texto de la leyenda [opcional].

<color>

El color del texto de la leyenda, en formato hexadecimal RRGGBB.

<size>

El tamaño en puntos del texto de la leyenda.

 

Ejemplos

Descripción	Ejemplo
Dos ejemplos de leyendas. Especifica el texto de la leyenda en el mismo orden que las series de datos.	chdl=NASDAQ|FTSE100|DOW chco=FF0000,00FF00,0000FF chdl=First|Second|Third chco=ff0000,00ff00,0000ff
En el primer gráfico, se muestran las entradas de leyenda horizontal (chdlp=t, el diseño predeterminado es horizontal) y, en el segundo, se muestran las entradas de leyenda vertical inferiores (chdlp=bv).	chdl=First|Second|Third chco=ff0000,00ff00,0000ff chdlp=t chdl=First|Second|Third chco=ff0000,00ff00,0000ff chdlp=bv
En este ejemplo, se muestra cómo cambiar el tamaño de fuente.	chdls=0000CC,14

Volver al principio

Márgenes del gráfico chma [Todos los gráficos]

Puedes especificar el tamaño de los márgenes del gráfico en píxeles. Los márgenes se calculan hacia adentro a partir del tamaño de gráfico especificado (chs); aumentar el tamaño del margen no aumenta el tamaño total del gráfico, sino que se reduce el área del gráfico, si es necesario.

De forma predeterminada, los márgenes son los que restan 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 especifiques serán un valor mínimo. Si el área del gráfico deja espacio para los márgenes, el tamaño de los márgenes será el que quede. No puedes apretar los márgenes más pequeños que el requerido para las leyendas y las etiquetas. A continuación, se incluye un diagrama que muestra las partes básicas de un gráfico:

Los márgenes del gráfico incluyen las etiquetas del eje y el área de leyenda. El área de la leyenda cambia de tamaño automáticamente para adaptarse con exactitud al texto, a menos que especifiques un ancho más grande con chma. En ese caso, se expandirá el tamaño del margen y se reducirá el área del gráfico. No puedes recortar una leyenda especificando un tamaño demasiado pequeño, pero puedes hacer que ocupe más espacio del necesario. Sugerencia: En un gráfico de barras, si las barras tienen un tamaño fijo (el predeterminado), el ancho del área del gráfico no se puede reducir. Debes especificar un tamaño de barra más pequeño o que se pueda cambiar de tamaño con chbh.

 

Sintaxis

chma=
  <left_margin>,<right_margin>,<top_margin>,<bottom_margin>|<opt_legend_width>,<opt_legend_height>

<left_margin>, <right_margin>, <top_margin>, <bottom_margin>

Tamaño mínimo del margen alrededor del área del gráfico, en píxeles. Aumenta este valor para incluir padding a fin de evitar que las etiquetas de los ejes choquen contra los bordes del gráfico.

<opt_legend_width>, <opt_legend_height>

[Opcional] Ancho del margen alrededor de la leyenda, en píxeles. Usa esto para evitar que la leyenda sobresalga contra 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 en cada lado. Como 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.	chma=30,30,30,30
Para agregar un margen alrededor de la leyenda, establece un valor para los parámetros <opt_legend_width> y <opt_legend_height>. En este ejemplo, la leyenda tiene aproximadamente 60 píxeles de ancho. Si estableces <opt_legend_width> en 80 píxeles, el margen se extiende hasta 20 píxeles fuera de la leyenda.	chma=20,20,20,30|80,20

Volver al principio

Estilos y etiquetas de ejes [Línea, barra, Google-o-meter, radar, dispersión]

Puedes especificar qué ejes se mostrarán en el gráfico y asignarles etiquetas y posiciones personalizadas, rangos y estilos.

No todos los gráficos muestran líneas de ejes de forma predeterminada. Puedes especificar exactamente qué ejes debe mostrar tu gráfico con el parámetro chxt. Las líneas de eje predeterminadas no muestran números; debes especificar un eje en el parámetro chxt para mostrar números.

Puedes elegir que tus ejes muestren números que reflejen los valores de los datos, o bien puedes especificar ejes personalizados. La opción predeterminada es mostrar valores numéricos, con valores ajustados para un rango de 0 a 100. Sin embargo, puedes cambiar ese rango con chxr para mostrar cualquier rango y aplicar diseño a los valores (por ejemplo, para mostrar símbolos de moneda o lugares decimales) con chxs.

Si eliges usar valores personalizados, como "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 del eje personalizado y numérico.

Nota sobre los valores de string: Solo se permiten caracteres seguros para URL en las strings de etiqueta. Para estar seguro, debes codificar en formato URL todas 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 abordan los siguientes temas:

• Ejes visibles (chxt): Indica qué ejes se mostrarán.
• Rango de ejes (chxr): Rango de valores para cada eje.
• Etiquetas de eje personalizadas (chxl): Son los valores personalizados que se mostrarán en el eje.
• Posiciones de las etiquetas de los ejes (chxp): Posició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): Longitud de las marcas de un eje específico.

---

Ejes visibles chxt

Los gráficos de barras, de líneas, de radar y de dispersión muestran una o dos líneas de ejes de forma predeterminada, pero estas líneas no incluyen valores. Para mostrar valores en las líneas de los 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 de los ejes de 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, en los ejes inferior y superior no se muestran las marcas según los valores, mientras que en los ejes izquierdo y derecho sí se muestran. Puedes cambiar este comportamiento con el parámetro chxs.

Sintaxis

chxt=
  <axis_1>
    ,...,
  <axis_n>

<axis>

Es un eje que se mostrará en el gráfico. Los ejes disponibles son los siguientes:

• x: Eje x inferior
• t: Eje x superior [No compatible con Google-o-Meter]
• y: Eje Y izquierdo
• r: 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 a lo largo de un eje que muestra valores numéricos (consulta el siguiente ejemplo). Los ejes se dibujan de adentro hacia afuera, por lo que, si tienes x,x, la primera "x" hace referencia a la copia más interna, la siguiente "x" hace referencia a la siguiente copia externa, 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 predeterminado es un rango de 0 a 100 para todos los ejes. Ten en cuenta que, de forma predeterminada, en los ejes inferior y superior no se muestran marcas junto a las etiquetas.	chxt=x,y,r,t
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 ejes x y dos conjuntos de ejes y. Esto no es particularmente útil cuando se usan solo las etiquetas predeterminadas de los ejes, como se muestra aquí. Sin embargo, puedes especificar etiquetas personalizadas para cada copia de cada eje con 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=200xt,ych />" <img <code="" dir="ltr" src="/static/chart/image/images/chart_42.png" title="chxt=x,x,y,y&cht=lc&chd=s:cEAELFJHHHKUju9uuXUc&chco=76A4FB&chls=2.0&chs=200x125&Chs=200x125
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. Se omiten las etiquetas de ejes, por lo que la API de gráficos muestra un rango de 0 a 100 para el eje X y el eje t. El rango del eje y y el eje r está determinado por la cantidad 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 está centrada en la base de la primera barra, la segunda etiqueta está centrada en la base de la segunda barra y así sucesivamente.	chxt=x,y,r,t
Puedes suprimir los ejes predeterminados en un gráfico de líneas si especificas :nda después del tipo de gráfico.	cht=lc:nda

Volver al principio

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 de los ejes. Si quieres que los números del eje describan los valores de datos reales, establece <start_val> y <end_val> en los valores inferiores y superiores del rango de formato de tus datos, respectivamente. Consulta Escalamiento de ejes para obtener más información.

Debes hacer que un eje sea visible mediante el parámetro chxt si deseas especificar su rango.

Para especificar los valores personalizados del eje, usa el parámetro chxl.

Sintaxis

Separa varios rangos de etiquetas de eje 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_index>

A qué eje aplicar las etiquetas. Este es un índice basado en cero en el array de ejes especificado por chxt. Por ejemplo, el eje r sería 1 en chxt=x,r,y.

<start_val>

Es un número que define el valor bajo de este eje.

<end_val>

Es un número que define el valor alto de este eje.

<opt_step>

[Opcional] 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 con un espaciado correcto.

 

Ejemplos

Descripción	Ejemplo
En este ejemplo, se muestran los ejes Y de izquierda y derecha (y y r) y un eje X (x). Cada eje tiene un rango definido. Debido a que no se especifican etiquetas ni posiciones, los valores se toman del rango dado y se separan de manera uniforme dentro de ese rango. En el gráfico de líneas, los valores se distribuyen de manera uniforme a lo largo del eje x. La dirección del eje se invierte para el eje r (índice 2), ya que el primer valor (1000) es mayor que el último valor (0).	chxt=x,y,r chxr=   0,0,500|   1,0,200|   2,1000,0
En este ejemplo, se especifican 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 (5) para el parámetro <opt_step>.	chxt=x chxr=0,10,50,5

Volver al principio

Etiquetas de eje personalizadas chxl

Puedes especificar etiquetas personalizadas de ejes de strings en cualquier eje mediante el parámetro chxl. Puedes especificar tantas etiquetas como quieras. 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 en su lugar.

Si deseas establecer ubicaciones específicas a lo largo del eje de tus etiquetas, usa el parámetro chxp.

Sintaxis

Especifica un conjunto de parámetros para cada eje que desees 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_index>

A qué eje aplicar las etiquetas. Este es un índice en el array del parámetro chxt. Por ejemplo, si tienes chxt=x,x,y,y, el índice 0 sería el primer eje X y 1 sería el segundo.

<label_1>| ... |<label_n>

Una o más etiquetas para colocar a lo largo de este eje. Pueden ser valores numéricos o de string. No es necesario que las strings 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 están separadas de manera 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 cómo el último valor chxl no termina con una canalización.	chxt=x,y chxl= 0:|Jan|Feb|March|April|May| 1:|Min|Mid|Max
En este ejemplo, se incluyen las etiquetas de los ejes en los ejes Y izquierdo y derecho (y y r). También incluye dos conjuntos de valores para el eje X (x). Podrías considerar agregar marcas de verificación en el eje Y mediante chxs.	chxt=x,y,r,x chxl= 0:|Jan|July|Jan|July|Jan| 1:|0|50|100| 2:|A|B|C| 3:|2005|2006|2007
En este ejemplo, se incluyen las etiquetas de los ejes en los ejes y izquierdo y derecho (y y r). También se incluyen dos conjuntos de valores para el eje X (x). Observa las etiquetas vacías del conjunto de ejes X inferior, que se usan para separar los valores. En este ejemplo, se usan valores predeterminados para las etiquetas de los ejes del eje Y izquierdo.	chxt=x,y,r,x chxl= 0:|Jan|July|Jan|July|Jan| 2:|A|B|C| 3:|2005||2006||2007
Si deseas agregar una etiqueta genérica para describir un eje completo (por ejemplo, para etiquetar un eje como "costo" y otro "alumno"), usa la propiedad chxt a fin de agregar un eje adicional en cada lado. Luego, usa chxl para agregar una sola etiqueta personalizada a cada lado y chxp para espaciarla en el medio del eje.	chxt=x,x,y,y chxl=1:|Martinis|3:|Score chxp=1,50|3,50

Volver al principio

Posiciones de la etiqueta de eje chxp

Puedes especificar qué etiquetas de los ejes mostrar, ya sea mediante las etiquetas predeterminadas o las personalizadas especificadas con chxl. Si no especificas posiciones exactas con este parámetro, las etiquetas se espaciará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 marcas serán los valores predeterminados (por lo general, los valores de datos o los números de barra 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_index>

Eje para el que especificas posiciones. Este es un índice en el array del parámetro chxt. Por ejemplo, si tienes chxt=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 junto al eje. Esta es una lista de valores numéricos separados 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 para ese eje. Ten en cuenta que siempre será de 0 a 100, a menos que hayas especificado un rango personalizado con chxr. 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 chxl. Las etiquetas con una posición especificada de 0 se colocan en la parte inferior de los ejes "y" o "r", o bien a la izquierda de los ejes "x" o "t". Las etiquetas con una posición especificada de 100 se colocan en la parte superior del eje y o el r, o a la derecha de los ejes x o t.	chxt=x,y,r chxl=2:|min|average|max chxp=2,10,35,75
En este ejemplo, se muestra cómo mostrar los valores predeterminados de las etiquetas, pero solo en ubicaciones especificadas. chxp=1,10,35,75: El eje Y debe mostrar solo tres etiquetas: 10, 35 y 75. Debido a que no se especifica ningún texto de etiqueta personalizada, se muestran estos valores de los ejes. Observa que no tienes que espaciar las etiquetas de manera uniforme cuando usas chxp. Si no se especificara chxp aquí, la distancia predeterminada del valor de la etiqueta en el eje y sería cada 20 unidades, como se muestra en el segundo gráfico.	chxt=x,y chxp=1,10,35,75 chxt=x,y chxp sin especificar

Volver al principio

Estilos de etiquetas de eje chxs

Puedes especificar el tamaño de la fuente, el color y la alineación para las etiquetas de ejes, tanto para las etiquetas personalizadas como los valores predeterminados. Todas las etiquetas del 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 string de etiqueta, por ejemplo, para mostrar símbolos de moneda o ceros finales.

De forma predeterminada, en los ejes inferior y superior, no se muestran marcas junto a los valores, mientras que en los ejes izquierdo y derecho sí se muestran.

Sintaxis

Los valores de varios ejes deben separarse 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>

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, todos opcionales: La sintaxis de la string de formato es la siguiente:
       N<preceding_text>*<number_type><decimal_places>zs<x or y>*<following_text>
Este es el significado de cada elemento:

• <preceding_text>: Es el texto literal que antecede a cada valor.
• *...*: Es un bloque opcional encerrado entre 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 las siguientes opciones:
    • f: [Predeterminado] Formato de punto flotante. Considera especificar la precisión también con el valor <decimal_places>.
    • p: Formato de porcentaje. El signo % se agrega automáticamente. Nota: Cuando se usa este formato, los valores de datos de 0.0 a 1.0 se asignan a 0-100% (por ejemplo, 0.43 se mostrará como 43%).
    • e: Formato de notación científica.
    • c<CUR>: Da formato al número en la moneda especificada con el marcador de moneda adecuado. 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 de ISO, aunque no se admiten todos los símbolos.
  • <decimal_places>: Es un número entero que especifica cuántos decimales se muestran. El valor se redondea (no se trunca) a esta longitud. El valor predeterminado es 2.
  • z: Se muestran ceros finales. El valor predeterminado es no.
  • s: Muestra los separadores de grupo. El valor predeterminado es no.
  • x o y: Muestra los datos de la coordenada x o y, según se especifica. El significado de los datos de 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>: Es el texto literal que sigue a cada valor.

<opt_label_color>

Es el color que se aplicará al texto del eje (pero no a la línea del eje), en formato hexadecimal RRGGBB. El color de las líneas del eje se especifica por separado con opt_axis_color. El color predeterminado es 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 etiquetas. En el caso de los ejes superior o inferior, de esta forma se describe cómo se alinea la etiqueta con la marca de verificación que está encima o debajo de ella. En el caso de los ejes izquierdo o derecho, se 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 de los ejes 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 se admite en Google-o-meter] Indica si se deben mostrar las marcas o las líneas de los ejes para este eje. Las marcas y las líneas de los ejes solo están disponibles para los ejes más internos (por ejemplo, no son compatibles con el exterior de dos ejes x). Usa uno de los siguientes valores:

• l (mayúscula “L” en minúscula): Dibuja solo la línea del eje.
• t: Solo dibuja marcas. Las comillas simples son las pequeñas líneas junto a las etiquetas de los ejes.
• lt: [Predeterminado] Dibuja una línea de eje y marcas de verificación para todas las etiquetas.
• _: (guion bajo): No se dibuja la línea del eje ni las comillas simples. Si quieres ocultar una línea de eje, usa este valor.

<tick_color>

[Opcional; no se admite en Google-o-meter] El color de la marca de verificación, en formato hexadecimal RRGGBB. El color predeterminado es gris.

<opt_axis_color>

(opcional): Es el color de la línea del eje en formato hexadecimal RRGGBB. El color predeterminado es gris.

 

Ejemplos

Descripción	Ejemplo
El tamaño y el color de la fuente se especifican para el segundo eje X (ene, feb, mar).	chxt=x,y,r,x chxr=2,0,4 chxl=3:|Jan|Feb|Mar|      1:|min|average|max chxp=1,10,35,75 chxs=3,0000DD,13,0,t
El tamaño, el color y la alineación de la fuente se especifican para el eje Y derecho. Se dibujan marcas de verificación, pero no líneas de ejes.	chxt=x,y,r,x chxl=3:|Jan|Feb|Mar|      2:|min|average|max chxp=2,10,35,95 chxs=2,0000DD,13,-1,t,FF0000
En este gráfico, se incluyen tres conjuntos de datos y se muestran tres conjuntos de etiquetas de ejes, uno por serie. Cada conjunto de etiquetas se formatea con una string de formato personalizado, como se describe a continuación: 0N*e,000000| 0 significa que la primera serie de datos N significa una string de formato. * significa el inicio de los especificadores de formato. e significa notación científica * significa el final de los especificadores de formato. 000000 significa texto negro. 1N*cUSD*Mil,FF0000| 1 significa que la segunda serie N significa una string de formato. * significa el inicio de los especificadores de formato. c significa un marcador de moneda. USD especifica el dólar estadounidense como el marcador de moneda que se usará. * significa el final de los especificadores de formato. Mil es un literal que sigue a la string. FF0000 significa texto rojo. 2N*sz2*,0000FF 2 significa que la tercera serie N significa una string de formato. * significa el inicio de los especificadores de formato. s significa mostrar los especificadores de agrupación (en la configuración regional en inglés de EE.UU., es una coma cada tres ceros). z2 significa mostrar dos ceros finales. 0000FF significa texto azul. Los rangos de etiquetas del eje se configuran con el parámetro chxr (axis_index, start, end, step). Si no se hubiera establecido, habrían sido 0-100 de forma predeterminada.	chd=s:   984sttvuvkQIBLKNCAIi,   DEJPgq0uov17zwopQODS,   AFLPTXaflptx159gsDrn chxr=   0,0,1000000,250000|   1,0,60|   2,0,5000 chxs=   0N*e,000000|   1N*cUSD*Mil,FF0000|   2N*sz2*,0000FF

Volver al principio

Estilos de marcas de verificación de eje chxtc

Puedes especificar comillas largas para ejes específicos. Por lo general, se usa para extender una marca de verificación a lo largo de un gráfico. Usa el parámetro chxs para cambiar el color de la marca de verificación.

Los valores de varios ejes deben separarse 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>

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 especifica más de un valor, las marcas de los ejes recorrerán 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 valor positivo máximo es 25. Los valores negativos se dibujan dentro del área del gráfico y se recortan según los bordes del área del gráfico.

 

Ejemplos

Descripción	Ejemplo
Ejemplo del uso de chxtc para crear marcas rojas largas Aquí, la longitud de la marca de verificación supera el ancho del área del gráfico, pero se recorta para adaptarse al gráfico. chxt=x,y,r,x: Muestra un eje izquierdo, un eje derecho y dos ejes inferiores. chxl=2:|min|average|max|3:|Jan|Feb|Mar: Es el texto de la etiqueta asignado a la "r" (lado derecho) y los ejes externos. chxp=2,10,35,95: Las posiciones de las etiquetas personalizadas a lo largo del eje R (índice=2) para las tres etiquetas. chxs=2,0000dd,13,-1,t,FF0000: Estilos de etiquetas de ejes para el eje r: color de texto, tamaño del texto, alineado a la izquierda y con marcas rojas. chxtc=1,10|2,-180: longitudes de marcas de los ejes para los ejes y y r. El primer valor especifica marcas de 10 píxeles de longitud, fuera del eje. El segundo valor especifica marcas de 180 píxeles dentro del eje; el número negativo significa que la marca va dentro del eje y se recorta para adaptarse al gráfico.	chxt=x,y,r,x chxl=   2:|min|average|max|   3:|Jan|Feb|Mar chxp=2,10,35,95 chxs=   2,0000dd,13,-1,t,FF0000 chxtc=1,10|2,-180
En este gráfico, se muestran las 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 chxtc=   1,5,15

Volver al principio

Relleno de fondo chf [todos los gráficos]

Puedes especificar colores y estilos de relleno para el área de datos del gráfico 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, el área completa 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, franjas y gradientes) en el mismo gráfico si separas los valores con el carácter de barra vertical ( | ). Los rellenos del área del gráfico reemplazan los rellenos del fondo del gráfico.

Llenado continuo 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 fondo).

Sintaxis

chf=<fill_type>,s,<color>|...

<fill_type>.

Es la parte del gráfico que se va a completar. Especifica uno de los siguientes valores:

• bg: Relleno de fondo
• c: Relleno del área del gráfico. No es compatible con los gráficos de mapas.
• a: Hace que todo el gráfico (incluidos los fondos) sea transparente. Se ignoran los primeros seis dígitos de <color> y solo los dos últimos (el valor de transparencia) se aplican a todo el gráfico y a todos los rellenos.
• b<index>: Relleno sólido de barras (solo gráficos de barras). Reemplaza <index> por el índice de la serie de las barras para rellenar con un color sólido. El efecto es similar a especificar chco en un gráfico de barras. Consulta Colores de serie de gráficos de barras para ver un ejemplo.

s

Indica un relleno sólido o transparente.

<color>

El color de relleno, en formato hexadecimal RRGGBB. Para las transparencias, los primeros seis dígitos se ignoran, pero se deben incluir de todos modos.

 

Ejemplos

Descripción	Ejemplo
En este ejemplo, se rellena el fondo del gráfico con gris pálido (EFEFEF).	chf=bg,s,EFEFEF
En este ejemplo, se rellena el fondo del gráfico con gris pálido (EFEFEF) y el área del gráfico en negro (000000).	chf=c,s,000000| bg,s,EFEFEF
En este ejemplo, se aplica una transparencia del 50% a todo el gráfico (80 en hexadecimal es 128 o una transparencia de alrededor del 50%). Observa el fondo de la celda de la tabla que se muestra a través del gráfico.	chf=a,s,00000080

Volver al principio

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 gradientes son atenuaciones de un color a otro. (Gráficos circulares y de Google-O-Meter: solo en segundo plano).

Cada relleno de gradiente especifica un ángulo y, luego, dos o más colores anclados 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 valores <color_centerpoint> diferentes para que uno pueda aparecer en el otro. Cada gradiente adicional se especifica mediante 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 fondo
• c: Relleno del área del gráfico.
• b<index>: Relleno de gradiente de barras (solo gráficos de barras). Reemplaza <index> por el índice de la serie de las barras para rellenar con un gradiente. Consulta Colores de serie de gráficos de barras para ver un ejemplo.

lg

Especifica un relleno de gradientes.

<ángulo>

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 del color. El color comenzará a desvanecerse a partir de este punto a medida que se acerque a otro anclaje. 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 (0). Los colores son el durazno (FFE7C6), centrados en el lado izquierdo (posición 0.0) y azul (76A4FB) centrados en el lado derecho (posición 1.0). El fondo del gráfico está dibujado en gris (EFEFEF).	chf=   c,lg,0,   FFE7C6,0,(durazno)   76A4FB,1 (azul)
El área del gráfico tiene un gradiente lineal diagonal (de la parte inferior izquierda a la parte superior derecha), especificado con un ángulo de cuarenta y cinco grados (45). El durazno (FFE7C6) es el primer color especificado. La parte inferior izquierda del gráfico es de color durazno puro. El segundo color especificado es el azul (6A4FB). La parte superior derecha del gráfico es de color azul puro. Observa cómo especificamos un desplazamiento de 0.75 para proporcionar un pico de azul que se desvanece hacia la esquina superior derecha. El fondo del gráfico está dibujado en gris (EFEFEF).	chf=   c,lg,45,   FFE7C6,0, (durazno)   76A4FB,0.75 (azul)
El área del gráfico tiene un gradiente lineal vertical (de arriba abajo), especificado con un ángulo de noventa grados (90). El primer color especificado es el azul (76A4FB). La parte superior del gráfico es de color azul puro. El durazno (FFE7C6) es el segundo color especificado. La parte inferior del gráfico es de color durazno puro. El fondo del gráfico está dibujado en gris (EFEFEF).	chf=   c,lg,90,   FFE7C6,0, (durazno)   76A4FB,0.5 (azul)

Volver al principio

 

Relleno rayado chf [Line, Bar, Google-o-meter, Radar, Scatter, Venn]

Puedes especificar un relleno de fondo a rayas para el área del gráfico o para todo el gráfico. (Gráficos circulares y 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 fondo
• c: Relleno de área del gráfico
• b<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 serie de gráficos de barras para ver un ejemplo.

ls

Especifica el relleno de la franja lineal.

<ángulo>

El ángulo de todas las rayas, en relación con el eje Y. Usa 0 para rayas verticales o 90 para rayas horizontales.

<color>

Es el color de esta franja, en formato hexadecimal RRGGBB. Repite <color> y <width> para cada franja adicional. Debes tener al menos dos franjas. Las rayas se alternan hasta que se completa el gráfico.

<width>

El ancho de esta franja, desde 0 hasta 1, donde 1 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 franjas. Las rayas se alternan hasta que se completa el gráfico.

 

Ejemplos

Descripción	Ejemplo
bg,ls,0: Se completa el relleno de rayas en el fondo con rayas en un ángulo de cero grados respecto del eje Y (paralelo al eje Y). Las rayas cubren el fondo y el área de trazado. CCCCCC,0.15: La primera franja es gris oscuro, es un 15% tan ancha como el gráfico. FFFFFF,0.1: La segunda franja es blanca, un 10% más ancha que el gráfico.	chf=   bg,ls,0,   CCCCCC,0.15,   FFFFFF,0.1
c,ls,90: Área del gráfico con rayas horizontales en un ángulo de noventa grados respecto del eje Y. Las rayas cubren el área del trazado, pero se omite el fondo del gráfico. 999999,0.25: La primera franja es gris oscuro, es un 25% tan ancha como el gráfico. CCCCCC,0.25: Igual que la primera franja, pero de un gris más claro. FFFFFF,0.25: Igual que la primera franja, pero blanco.	chf=   c,ls,90,   999999,0.25,   CCCCCC,0.25,   FFFFFF,0.25

Volver al principio

Funciones de datos chfd [Todos los chd gráficos]

Puedes especificar una función personalizada para que se ejecute en los datos del gráfico con la sintaxis de la función muParser. Los datos usados en la función pueden provenir de una de dos fuentes:

• Una serie de datos de chd: Los datos se extraen de la serie especificada en chd.
• Un rango de valores declarado en el parámetro chfd: declaras un valor de inicio, parada 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 como resultado a la misma serie de datos, las funciones se ejecutarán en el orden dado, pero solo el resultado de la función final se representará en el gráfico. Ten en cuenta que puedes encadenar funciones, de modo que una función pueda tomar como entrada una serie que una función anterior generó.

Para asignar colores o marcadores chm a una línea de función, asígnalos al índice de serie de la función. Ten en cuenta que los marcadores se ubican según los datos después de que la función los haya manipulado.

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 todos 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 van a graficar. Los datos pueden pertenecer a un rango que definas o a una de las series de datos chd. Puedes especificar muchas variables para cada función mediante un delimitador ; (punto y coma) para múltiples variables. Ten en cuenta que si defines múltiples variables para una sola función y estas tienen una cantidad de puntos diferente, la función se detendrá cuando llegue al primer extremo. Por ejemplo, si una función define tanto x=1-5 paso 1 e 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: Un nombre de string arbitrario para la variable. Úsalo en la función definida por function_string.
• input_series_index: Es el índice de una serie de datos chd que se usa como datos de entrada.
• inicio: Valor numérico inicial de un rango.
• fin: Es el valor numérico final de un rango.
• step: Valor numérico del paso desde start hasta end. Puede ser positivo o negativo, pero no puede ser cero.

Ejemplos: x,0,100,1 declara una variable llamada x con valores 0, 1, 2, ... 100. x,0,100,1;r,0,3.1,.1 declara la misma variable x más una variable llamada r con valores 0, 0.1, 0.2, ..., 3.0, 3.1. x,0 declara una variable llamada x que usa los datos de la primera serie de chd. function_string usará estas variables. No se representarán en el gráfico, a menos que las especifiques en function_string. Cuanto más pequeño sea el paso, más fluido 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. Las funciones muParser de resumen no son compatibles (mínimo, suma máxima, promedio). IMPORTANTE: Recuerda usar %2B en lugar de + en tus funciones.

 

Ejemplos

Descripción	Ejemplo
Una onda sinusoidal simple. Debes tener en cuenta lo siguiente: chd=t:-1: Usamos una variable de prueba para los datos del gráfico porque nuestros datos se declaran en el parámetro chfd. chco=FF0000: Se especifica el rojo para la primera serie. Aunque no usamos los datos de chd, se usará el color correspondiente de esa serie para esa función trazada. chfd=0,x,0,11,0.1,sin(x)*50%2B50: Declaramos una variable, llamada x, con valores de 0 a 11, incrementados por 0.1. Se asigna a la primera serie, lo que significa que obtendrá el primer color de serie (FF0000). La función aplicada a x es sen(x) * 50 + 50. Observa cómo debemos codificar el signo + en esa función.	cht=lc chd=t:-1 chco=FF0000 chfd=   0,x,0,11,0.1,sin(x)*50%2B50 chxt=x,y
Esta línea usa datos del parámetro chd.	chd=t:5,10 chfd=0,x,0,x*4
Es una combinación de líneas de funciones y líneas que no son funcionales. Observa cómo el parámetro de color de la serie chco especifica los colores. Observa la posición de los marcadores en el resultado de la función. Los datos se calculan a partir del inicio, el final y el paso, de modo que si tu rango es del 0 al 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:   -1   15,45 chco=   FF0000,000000 chfd=   0,x,0,11,0.1,sin(x)*50%2B50 chm=   c,00A5C6,0,110,10   a,00A5C6,0,60,10
Para definir una función en dos dimensiones, usa un gráfico lxy, asigna dos series ficticias y una función a cada una. 0,x,0,10,0.1,sin(x)*50%2B50: La serie 0 (los valores del eje X) tiene una variable llamada x, con valores del 0 al 10, paso 0.1 y una función sen(x)*50 + 50. 0,y,0,10,0.1,sin(y)*50%2B50: La serie 0 (los valores del eje Y) tiene una variable llamada y, con valores del 0 al 10, paso 0.1, y una función sen(x)*50 + 50.	cht=lxy chd=t:-1|-1 chfd=   0,x,0,10,0.1,sin(x)*50%2B50|   1,y,0,10,0.1,cos(y)*50%2B50
El parámetro chfd realmente te permite expresar tu creatividad. Haz clic en estas imágenes para abrirlas y jugar con ellas en la zona de pruebas de gráficos. Quedarás atrapado.

Volver al principio