Предупреждение. Этот API устарел в 2012 году и был отключен 18 марта 2019 года . Вместо этого используйте активно поддерживаемый API Google Charts .

Список функций диаграммы

Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.

На этой странице описаны все функции и параметры, поддерживаемые Chart API. Некоторые из этих параметров ведут себя по-разному в зависимости от типа диаграммы; в этом случае документация ссылается на соответствующую документацию по диаграммам.

Параметры

Это параметры, поддерживаемые Google Chart API.

Параметр Описание и синтаксис Типы диаграмм
чбх Ширина полосы и интервал

chbh=
< bar_width_or_scale >,
< space_between_bars >,
< space_between_groups>

Бар
ЧКО Цвета серии
chco=
< series_1_element_1 >|...|< series_1_element_n >, < series_2 >,...,< series_m >
Бар , Google-метр , Линия , Карта , Круговая диаграмма , Радар , Разброс , Венн
ЧД Строка данных диаграммы
chd=
t:s,e,r,i,e,s,1|s,e,r,i,e,s,2|...
или же
s:series1,series2,...
или же
e:series1,series2,...
Все графики
чдл, чдлп, чдлс Текст и стиль легенды диаграммы

chdl=
<data_series_1_label
>
|...|
< data_series_n_label >

chdlp=< opt_position >|< opt_label_order >

chdls=< color >,< font_size >

Бар , Подсвечник , Google-метр , Линия , Круговая диаграмма , Радар , Разброс , Венн
чдс Масштаб для текстового формата с пользовательским диапазоном
chds=
< series_1_min >,
< series_1_max >,...
Все карты, которые могут принимать chd
химия Динамические маркеры значков
chem=
y;s=< icon_string_constant >;
d=< marker_data_string >;
ds=< which_series >;
dp=< opt_which_points >;
py=< opt_z_order >;
po=< x,y >;
of=< x_offset,y_offset >
Бар , Подсвечник , Линия , Радар , Разброс
чф Градиентная заливка
chf=
< fill_type >,
lg,
< angle >,
< color >
Гистограмма , Подсвечник , Google-o-meter (только фон), Линия , Круговая диаграмма (только фон), Радар , Разброс , Венн
чф Полосатые заливки
chf=
< fill_type >,
ls,
< angle >,
< color_1 >,< width_1 >
,...,
< color_n >,< width_n >
Гистограмма , Подсвечник , Google-o-meter (только фон), Линия , Круговая диаграмма (только фон), Радар , Разброс , Венн
чф Сплошная заливка
chf=
< fill_type >,
s,
< color >
Бар , Подсвечник , Google-o-meter (только фон), Линия , Карта (только фон), Радар , Разброс , Венн , Круговая диаграмма
chfd Функции данных
chfd=
< series_index >,
< variable_data> ,
< function_string >
|...|
Все карты, которые могут принимать chd
изменить Линии сетки
chg=
< x_axis_step_size >,
< y_axis_step_size >,
< opt_dash_length >,
< opt_space_length >,
< x_offset >,
< y_offset>
Бар , Подсвечник , Линия , Радар , Разброс
чл Ярлыки круговых диаграмм , ярлык Google-o-meter
chl=< label >|...
Google-метр , пирог
ребенок Данные метки диаграммы (различные типы)
chld=< chart-specific_data >|< chart-specific_data >|...
Отдельно стоящие динамические значки
члс Стили линий
chls=
< line_1_thickness >,
< opt_dash_length >,
< opt_space_length >|...
Линия , Радар
chm=D Маркеры линий
chm=
D,
< color >,
< series_index >,
< which_points >,
< width >,
< opt_z_order >|...
Бар , Подсвечник , Линия , Радар , Разброс
chm=r|R Маркеры диапазона
chm=
< r_or_R >,
< color >,
0,
< start_point >,
< end_point >|...
Бар , Подсвечник , Линия , Радар , Разброс
чм=
а|с|С
д|Э|о|
ч|Ч|
с|С|
v|V|х
Маркеры формы
chm=
< marker_type >,
< color >,
< series_index >,
< opt_which_points >,
< size >,
< opt_z_order >,
< opt_offset >|...
Бар , Подсвечник , Линия , Радар , Разброс
чм=
ф|т|А|Н
Текстовые маркеры и маркеры значений данных
chm=
< marker_type >,
< color >,
< series_index >,
< opt_which_points >,
< size >,
< opt_z_order >|
< opt_placement > ...
Бар , Подсвечник , Линия , Радар , Разброс
чм=F Свечные маркеры
chm=
F,
< opt_declining_color >,
< data_series_index >,
< opt_which_points >,
< width >,
< opt_z_order >
Бар , Подсвечник , Линия
чм=б/б Заливка линий
chm=
< b_or_B >,
< color >,
< start_line_index >,
< end_line_index >,
< 0 >
Бар (только с линейными маркерами), Линия , Радар
чма Поля диаграммы
chma=
< left_margin >,
< right_margin >,
< top_margin >,
< bottom_margin >
|< opt_legend_width >,
< opt_legend_height >
Бар , Подсвечник , Google-метр , Линия , Карта , Круговая диаграмма , Радар , Разброс , Венн
чоф Выходной формат
chof=< format >
Все графики
чп Нулевая линия гистограммы, ориентация круговой диаграммы
chp=< zero_val >,...
Бар , пирог
чс Размер диаграммы
chs=< width >x< height >
Все графики
чст Тип динамического значка
chst=< icon_string_constant >
Отдельно стоящие динамические значки
чт Тип диаграммы
cht=< chart_type >
Все графики
чтм Географический район
chtm=< zoom_area >
карта
чтт, чтс Название и стиль диаграммы

chtt=< chart_title >

chts=< color >,< font_size >,< opt_alignment >

Бар , Подсвечник , Google-метр , Линия , Круговая диаграмма , Радар , Разброс , Венн
chxt Видимые оси
chxt=< axis_1 >,...
Бар , Подсвечник , Google-o-meter , Линия , Радар , Разброс
chxr Диапазоны осей
chxr=
< axis_index >,
< start_val >,
< end_val >,
< opt_step >|...
Бар , Подсвечник , Google-o-meter , Линия , Радар , Разброс
chxl Метки осей
chxl=
< axis_index >:|< label_1 >|...
Бар , Подсвечник , Google-o-meter , Линия , Радар , Разброс
chxp Позиции меток осей
chxp=
< axis_index >,
< label_1_position >,
...,< label_n_position >
|...
Бар , Подсвечник , Google-o-meter , Линия , Радар , Разброс
chxs Стили меток осей
chxs=
< axis_index >
< opt_format_string >,
< opt_label_color >,
< opt_font_size >,
< opt_alignment >,
< opt_axis_or_tick >,
< opt_tick_color >,
< opt_axis_color >|...
Бар , Подсвечник , Google-o-meter (ограничено), Линия , Радар , Разброс
chxtc Стили засечек осей
chxtc=
< axis_index_1 >,
< tick_length_1 >,...,< tick_length_n >
|...
Бар , Подсвечник , Линия , Радар , Разброс

Формат цвета

Укажите цвета, используя 6-символьную строку шестнадцатеричных значений, а также два дополнительных значения прозрачности в формате RRGGBB[ AA ] . Например:

  • FF0000 = красный
  • 00FF00 = зеленый
  • 0000FF = Синий
  • 000000 = черный
  • FFFFFF = белый

AA — это необязательное значение прозрачности, где 00 — полностью прозрачный, а FF — полностью непрозрачный. Например:

  • 0000FFFF = сплошной синий
  • 0000FF66 = Прозрачно-синий

Вернуться к вершине

Размер диаграммы chs [ Все диаграммы ]

Все диаграммы требуют указания размера. Этот параметр определяет общую ширину и высоту изображения диаграммы, включая легенды , поля и заголовки . Легенды, поля и заголовки обрезаются, чтобы соответствовать общему размеру диаграммы.

Максимальный размер диаграммы для всех диаграмм, кроме карт, составляет всего 300 000 пикселей, а максимальная ширина или длина — 1000 пикселей. Максимальный размер карт — 440x220.

Значения являются целыми числами.

Синтаксис

chs=<width>x<height>
< ширина >
Ширина в пикселях. Максимальное значение — 1000. Ширина x высота не может превышать 300 000.
< высота >
Высота в пикселях. Максимальное значение — 1000. Ширина x высота не может превышать 300 000.

Пример

Описание Пример

Диаграмма размером 250 x 100 пикселей.

Желтая круговая диаграмма
chs=250x100

Вернуться к вершине

Тип диаграммы cht [ Все, кроме динамических значков ]

Укажите тип диаграммы с помощью параметра cht . Список доступных типов диаграмм см. на страницах документации по отдельным диаграммам.

Синтаксис

cht=<type>[:nda]
< тип >
Одно из значений типа диаграммы .
: нда
[ Необязательно, только для линейных диаграмм ] Вы можете добавить :nda после типа диаграммы в линейных диаграммах, чтобы скрыть оси по умолчанию.

Примеры

Описание Пример

Круговая диаграмма

Желтая круговая диаграмма
cht=p
Диаграмма Венна Диаграмма Венна с тремя перекрывающимися кругами, один круг синий, остальные зеленые
cht=v
Линейный график с осями по умолчанию и без них.

Линейный график с осями по умолчаниюЛинейный график со скрытыми осями
cht=lc cht=lc:nda

Вернуться к вершине

Серия Colors chco [Все таблицы]

Вы можете указать цвета определенной серии или всех элементов серии, используя параметр chco . Точный синтаксис и значение могут различаться в зависимости от типа диаграммы; подробности см. в описании конкретного типа диаграммы.

Синтаксис

chco=
  <series_1_element_1>|...|<series_1_element_n>,<series_2>,...,<series_m>

Каждая запись в этой строке представляет собой шестнадцатеричное число в формате RRGGBB . Цвета, которые применяются ко всей серии, разделяются запятой, цвета, которые относятся к отдельным элементам в серии, разделяются чертой. Для большинства типов диаграмм можно смешивать цветовые описания для всей серии и отдельных элементов серии. Если на диаграмме больше рядов или элементов, чем цветов, указанных в вашей строке, API обычно циклически переключает цвета элементов с начала этого ряда (для элементов) или для цветов серий с начала списка рядов. Подробности см. в документации по вашей отдельной диаграмме.

Примеры

Описание Пример

Когда вы указываете один цвет для каждой серии на линейной диаграмме, каждой линии назначается соответствующий цвет. В этом примере указаны три ряда данных и три цвета.

Линейный график с одной красной, одной синей и одной зеленой линией

chco=FF0000,00FF00,0000FF

Эта линейная диаграмма также имеет три ряда данных, но указаны только два цвета. Поскольку цвет для третьей серии не указан, третья линия рисуется с использованием первого цвета (красного).

Линейный график с двумя красными линиями и одной синей линией

chco=FF0000,0000FF

В этом примере показано, как задать цвет для отдельных элементов ряда (в данном примере — столбцов).

Вертикальная гистограмма с двумя наборами данных: один набор данных окрашен в темно-синий цвет, а второй — бледно-голубым.

cht=bvs
chco=FFC6A5|FFFF42|DEF3BD|00A5C6|DEBDDE

Это демонстрирует указание как цветов серий, так и цветов отдельных элементов. Первая серия вся в черном цвете (000000). Вторая серия, отмеченная запятой, имеет отдельные присвоенные цвета, разделенные символом | персонажи.

Горизонтальная гистограмма с одной точкой данных, выделенной красным, второй — зеленым, а третьей — синим.

chco=000000,FF0000|00FF00|0000FF

Вернуться к вершине

Выходной формат chof [ Все графики ]

Вы можете выбрать выходной формат диаграммы, используя параметр chof. Этот параметр также можно использовать для отображения отладочной информации при разработке диаграммы. Обратите внимание, что некоторые форматы вывода являются графическими (например, PNG и GIF), а другие нет. Использование неграфического формата в качестве параметра src тега <img> приведет к повреждению изображения на вашей странице.

Синтаксис

chof=png|gif|json|validate.

Укажите одну из следующих строк:

  • 'png' — возвращает диаграмму в виде изображения PNG.
  • 'gif' — возвращает диаграмму в виде изображения GIF.
  • 'json' — возвращает данные карты изображения для диаграммы в виде строки JSON. Это можно использовать для создания карты изображения для диаграммы, чтобы сделать различные области кликабельными. Формат этой строки и дополнительную информацию о том, как ее использовать, см. в разделе «Создание карты изображения диаграммы ».
  • 'validate' — возвращает HTML-страницу со списком ошибок в URL-адресе диаграммы. Дополнительные советы по отладке см. в разделе Отладка .

Примеры

Описание Пример

Вот примеры одного и того же графика в формате PNG и GIF:

Вертикальная гистограмма с заголовком
chof=png
Вертикальная гистограмма с заголовком
chof=gif

Диаграмма с недопустимым URL: https://chart.googleapis.com/chart?cht=bvs&chd=s:YUVmw1&chco=0000FF&chs=180x150&chtt=Site+visitors&chts=0000FF,20,20&chbh=22,4&chof=validate (можете ли вы найти ошибка?)

Указание chof=validate возвращает HTML-страницу; здесь мы сделали его источником <iframe>, чтобы вы могли видеть страницу результатов.


Неверный пример URL с chof=validate

Вот HTML-код, возвращаемый для действительного URL-адреса, когда chof=validate .

https://chart.googleapis.com/chart?cht=bvs&chd=s:YUVmw1&chco=FF0000&chs=180x150&chtt=Site+visitors+by+month|January+to+July&chbh=22,4&chof=validate


Действительный URL диаграммы в <iframe>

Вернуться к вершине

Название диаграммы chtt , chts [ Все диаграммы ]

Вы можете указать текст заголовка, цвет и размер шрифта для диаграммы.

Синтаксис

chtt=<chart_title>
chts=<color>,<font_size>,<opt_alignment>

chtt — указывает заголовок диаграммы.

< название_диаграммы >
Заголовок для диаграммы. Вы не можете указать, где это появляется, но вы можете указать размер и цвет шрифта. Используйте знак + для обозначения пробелов и символ вертикальной черты ( | ) для обозначения разрывов строк.

chts [ Необязательный ] — Цвета и размер шрифта для параметра chtt .

<цвет >
Цвет заголовка в шестнадцатеричном формате RRGGBB . Цвет по умолчанию черный.
<размер_шрифта >
Размер шрифта заголовка в пунктах.
< opt_alignment >
[ Необязательно ] Выравнивание заголовка. Выберите одно из следующих строковых значений с учетом регистра: «l» (слева), «c» (по центру), «r» (справа). По умолчанию "с".

Примеры

Описание Пример

Диаграмма с заголовком, с использованием цвета и размера шрифта по умолчанию.

Укажите пробел со знаком плюс ( + ).

Используйте символ вертикальной черты ( | ), чтобы принудительно разорвать строку.

chts здесь не указывается.

Вертикальная гистограмма с заголовком
chtt=Site+visitors+by+month|
January+to+July

Диаграмма с выровненным по правому краю синим заголовком размером 20 пунктов.

Вертикальная гистограмма с синим цветом, 20 пикселей, заголовок
chtt=Site+visitors
chts=FF0000,20,r

Вернуться к вершине

Текст и стиль легенды диаграммы chdl , chdlp , chdls [ Все диаграммы ]

Легенда представляет собой боковую часть диаграммы, в которой дается небольшое текстовое описание каждой серии. Вы можете указать текст, связанный с каждой серией в этой легенде, и указать, где на диаграмме он должен появиться.

См. также chma , чтобы узнать, как установить поля вокруг легенды.

Примечание о строковых значениях. В строках меток разрешены только безопасные для URL символы. Чтобы быть в безопасности, вы должны URL-кодировать любые строки, содержащие символы, не входящие в набор символов 0-9a-zA-Z . Кодировщик URL можно найти в Документации по визуализации Google .

Синтаксис

chdl=<data_series_1_label>|...|<data_series_n_label>
chdlp=<opt_position>|<opt_label_order>
chdls=<color>,<size>

chdl — текст каждой серии для отображения в легенде.

< метка_серии_данных >
Текст для записей легенды. Каждая метка применяется к соответствующей серии в массиве chd . Используйте знак + для пробела. Если не указать этот параметр, диаграмма не получит легенду. Невозможно указать разрыв строки в метке. Легенда обычно расширяется, чтобы вместить текст легенды, а область диаграммы сжимается, чтобы вместить легенду.

chdlp - [ Необязательный ] Позиция легенды и порядок записей легенды. Вы можете указать < position > и/или < label_order >. Если вы укажете оба, разделите их чертой. Вы можете добавить 's' к любому значению, если вы хотите, чтобы пустые записи легенды в chdl были пропущены в легенде. Примеры: chdlp=bv , chdlp=r , chdlp=bv|r , chdlp=bvs|r

< opt_position >
[ Необязательный ] Указывает положение легенды на диаграмме. Чтобы указать дополнительное отступы между легендой и областью диаграммы или границей изображения, используйте параметр chma . Выберите одно из следующих значений:
  • b - Легенда внизу диаграммы, записи легенды в горизонтальном ряду.
  • bv — Легенда внизу диаграммы, записи легенды в вертикальной колонке.
  • t - легенда вверху диаграммы, записи легенды в горизонтальном ряду.
  • tv — Легенда вверху диаграммы, записи легенды в вертикальной колонке.
  • r - [ По умолчанию ] Легенда справа от диаграммы, записи легенды в вертикальном столбце.
  • l - Легенда слева от диаграммы, записи легенды в вертикальной колонке.
< opt_label_order >
[ Необязательный ] Порядок, в котором метки отображаются в легенде. Выберите одно из следующих значений:
  • l [ По умолчанию для вертикальных легенд ] Отображать метки в порядке, указанном в chdl .
  • r — отображать метки в порядке, обратном указанному в chdl . Это полезно в столбчатых диаграммах с накоплением для отображения легенды.
    в том же порядке, в котором появляются полосы.
  • a - [ По умолчанию для горизонтальных легенд ] Автоматический порядок: примерно означает сортировку по длине, сначала самая короткая, измеренная в 10-пиксельных блоках. Когда два элемента имеют одинаковую длину (разделенные на блоки по 10 пикселей), первым будет отображаться тот, который указан первым.
  • 0,1,2... - Пользовательский порядок меток. Это список отсчитываемых от нуля индексов меток из chdl , разделенных запятыми.

chdls — [ Необязательный ] Указывает цвет и размер шрифта текста легенды.

< цвет >
Цвет текста легенды в шестнадцатеричном формате RRGGBB .
< размер >
Размер текста легенды в пунктах.

Примеры

Описание Пример

Два примера легенд. Укажите текст легенды в том же порядке, что и ваш ряд данных.

Красная, синяя и зеленая линейная диаграмма с соответствующими легендами

chdl=NASDAQ|FTSE100|DOW
chco=FF0000,00FF00,0000FF

Диаграмма Венна с двумя меньшими кругами, окруженными большим кругом


chdl=First|Second|Third
chco=ff0000,00ff00,0000ff

Первая диаграмма демонстрирует горизонтальные записи легенды ( chdlp=t , макет по умолчанию горизонтальный), а вторая демонстрирует нижние вертикальные записи легенды ( chdlp=bv ).

Диаграмма Венна с двумя меньшими кругами, окруженными большим кругом
chdl=First|Second|Third
chco=ff0000,00ff00,0000ff
chdlp=t


Диаграмма Венна с двумя меньшими кругами, окруженными большим кругом
chdl=First|Second|Third
chco=ff0000,00ff00,0000ff
chdlp=bv

Этот пример демонстрирует изменение размера шрифта.

Диаграмма Венна с двумя меньшими кругами, окруженными большим кругом
chdls=0000CC,14

Вернуться к вершине

Поля диаграммы chma [ Все диаграммы ]

Вы можете указать размер полей диаграммы в пикселях. Поля рассчитываются внутрь от указанного размера диаграммы ( chs ); увеличение размера поля не увеличивает общий размер диаграммы, а, при необходимости, уменьшает область диаграммы.

Поля по умолчанию — это то, что осталось после расчета размера диаграммы. Это значение по умолчанию зависит от типа диаграммы. Указанные поля являются минимальным значением; если в области диаграммы остается место для полей, размер полей будет равен тому, что осталось; вы не можете сжимать поля меньше, чем требуется для любых легенд и надписей. Вот схема, показывающая основные части диаграммы:

Поле диаграммы, область легенды и область диаграммы

Поля диаграммы включают метки осей и область легенды . Размер области легенды изменяется автоматически, чтобы точно соответствовать тексту, если вы не укажете большую ширину с помощью chma , и в этом случае размер поля увеличится, сжимая область диаграммы. Вы не можете обрезать легенду, указав слишком маленький размер, но вы можете заставить ее занимать больше места, чем нужно.

Совет: Если в линейчатой ​​диаграмме столбцы имеют фиксированный размер (по умолчанию), ширину области диаграммы нельзя уменьшить. Вы должны указать меньший или изменяемый размер полосы с помощью chbh .

Синтаксис

chma=
  <left_margin>,<right_margin>,<top_margin>,<bottom_margin>|<opt_legend_width>,<opt_legend_height>
< левое_поле >, < правое_поле >, < верхнее_поле >, < нижнее_поле >
Минимальный размер поля вокруг области диаграммы в пикселях. Увеличьте это значение, чтобы включить некоторые отступы, чтобы метки осей не сталкивались с границами диаграммы.
< opt_legend_width >, < opt_legend_height >
[ Необязательно ] Ширина поля вокруг легенды в пикселях. Используйте это, чтобы легенда не натыкалась на область диаграммы или края изображения.

Примеры

Описание Пример

В этом примере диаграмма имеет минимальное поле 30 пикселей с каждой стороны. Так как легенда диаграммы имеет ширину более 30 пикселей, поле справа устанавливается равной ширине легенды диаграммы и отличается от других полей.

Метки осей находятся за пределами области графика и поэтому рисуются в пределах поля.

Линейная диаграмма с серым фоном и полями с каждой стороны.
chma=30,30,30,30

Чтобы добавить поле вокруг легенды, установите значение для параметров < opt_legend_width > и < opt_legend_height > .

В этом примере легенда имеет ширину примерно 60 пикселей. Если вы установите для параметра < opt_legend_width > значение 80 пикселей, поле выходит за пределы легенды на 20 пикселей.

Линейная диаграмма с серым фоном и полями с каждой стороны.
chma=20,20,20,30|80,20

Вернуться к вершине

Стили и метки осей [ линия, полоса, Google-метр, радар, точечный ]

Вы можете указать, какие оси отображать на диаграмме, и присвоить им пользовательские метки и позиции, диапазоны и стили.

Не на всех диаграммах по умолчанию отображаются осевые линии. Вы можете точно указать, какие оси должна отображать ваша диаграмма, используя параметр chxt . Линии осей по умолчанию не показывают числа; вы должны указать ось в параметре chxt для отображения чисел.

Вы можете выбрать, чтобы ваши оси отображали числа, отражающие значения данных, или вы можете указать пользовательские оси. По умолчанию отображаются числовые значения со значениями, масштабируемыми в диапазоне от 0 до 100. Однако вы можете изменить этот диапазон, используя chxr для отображения любого диапазона, и вы можете стилизовать значения (например, чтобы показать символы валюты или десятичные разряды) с помощью chxs .

Если вы решите использовать пользовательские значения, например: «Пн, Вт, Ср», вы можете использовать параметр chxl . Чтобы разместить эти метки в определенных местах вдоль оси, используйте параметр chxp .

Наконец, вы можете использовать параметры chxs и chxtc для указания цвета, размера, выравнивания и других свойств как настраиваемых, так и числовых меток осей.

Примечание о строковых значениях. В строках меток разрешены только безопасные для URL символы. Чтобы быть в безопасности, вы должны URL-кодировать любые строки, содержащие символы, не входящие в набор символов 0-9a-zA-Z . Кодировщик URL можно найти в Документации по визуализации Google .

В этом разделе рассматриваются следующие темы:

  • Видимые оси ( chxt ) — какие оси отображать.
  • Диапазон оси ( chxr ) — диапазон значений для каждой оси.
  • Custom Axis Labels ( chxl ) — пользовательские значения для отображения на оси.
  • Позиции меток осей ( chxp ) — размещение пользовательских меток вдоль каждой оси.
  • Стили меток осей ( chxs ) — цвет, размер, выравнивание и форматирование меток осей.
  • Стили засечек осей ( chxtc ) — длина засечек для определенной оси.

chxt оси

На линейчатых, линейных, лепестковых и точечных диаграммах по умолчанию отображаются одна или две осевые линии, но эти линии не содержат значений. Чтобы отобразить значения на линиях ваших осей или изменить отображаемые оси, вы должны использовать параметр chxt . По умолчанию значения оси находятся в диапазоне от 0 до 100, если только вы не масштабируете их явно с помощью свойства chxr . Чтобы скрыть все осевые линии в линейной диаграмме, укажите :nda после значения типа диаграммы в параметре cht (пример: cht= lc:nda ).

По умолчанию верхняя и нижняя оси не показывают метки рядом со значениями, а левая и правая оси показывают их. Вы можете изменить это поведение, используя параметр chxs .

Синтаксис

chxt=
  <axis_1>
    ,...,
  <axis_n>
< ось >
Ось для отображения на диаграмме. Доступные оси:
  • x - Нижняя ось x
  • t — верхняя ось X [ не поддерживается Google-o-Meter ]
  • y - левая ось Y
  • r — правая ось Y [ не поддерживается Google-o-Meter ]

Вы можете указать несколько осей одного типа, например: cht=x,x,y . Это совместит два набора осей X вдоль нижней части диаграммы. Это полезно при добавлении пользовательских меток вдоль оси, на которой отображаются числовые значения (см. пример ниже). Оси рисуются изнутри наружу, поэтому, если у вас есть x,x , первый x относится к самой внутренней копии, следующий x относится к следующей внешней копии и так далее.

Примеры

Описание Пример

В этом примере показана линейная диаграмма с осью X, осью Y, верхней осью (t) и правой осью (r).

Поскольку метки не указаны, для диаграммы по умолчанию используется диапазон от 0 до 100 для всех осей.

Обратите внимание, что по умолчанию верхняя и нижняя оси не имеют делений рядом с метками.

Линейная диаграмма с метками: 0, 20, 40, 60, 80 и 100 слева и справа и метками: 0, 25, 50, 75 и 100 сверху и снизу
chxt=x,y,r,t

Вы можете включить несколько наборов меток для каждой оси, включив одно и то же значение более одного раза. В этом примере показаны два набора осей x и два набора осей y. Это не особенно полезно при использовании только меток осей по умолчанию, как показано здесь. Но вы можете указать собственные метки для каждой копии каждой оси, используя параметр chxl .


chxt=x,x,y,y



chxt=x,x,y,y
chxl=
1:|Freezing|Hot|
3:|Low|High

В этом примере показана горизонтальная гистограмма с осью X, осью Y, верхней осью t и правой осью r.

Метки осей опущены, поэтому Chart API отображает диапазон от 0 до 100 для оси x и оси t.

Диапазон для оси Y и оси r определяется количеством столбцов. В этом случае имеется пять столбцов, поэтому Chart API отображает диапазон от 0 до 4. Первая метка располагается по центру у основания первого столбца, вторая — у основания второго столбца и т. д. .

Линейная диаграмма с метками: 0, 20, 40, 60, 80 и 100 слева и справа и метками: 0, 25, 50, 75 и 100 сверху и снизу
chxt=x,y,r,t

Вы можете скрыть оси по умолчанию в линейной диаграмме, указав :nda после типа диаграммы. Линейный график со скрытыми осями
cht=lc:nda

Вернуться к вершине

Диапазон chxr

Вы можете указать диапазон значений, которые появляются на каждой оси независимо, используя параметр chxr. Обратите внимание, что это не меняет масштаб элементов диаграммы, а только масштаб меток осей. Если вы хотите, чтобы номера осей описывали фактические значения данных, задайте для < start_val > и < end_val > нижнее и верхнее значения вашего диапазона формата данных соответственно. Дополнительную информацию см. в разделе « Масштабирование оси» .

Вы должны сделать ось видимой, используя параметр chxt , если хотите указать ее диапазон.

Чтобы указать пользовательские значения оси, используйте параметр chxl .

Синтаксис

Разделяйте диапазоны меток нескольких осей с помощью вертикальной черты ( | ).

chxr=
  <axis_index>,<start_val>,<end_val>,<opt_step>
    |...|
  <axis_index>,<start_val>,<end_val>,<opt_step>
<индекс_оси >
К какой оси применить метки. Это отсчитываемый от нуля индекс в массиве осей, заданном chxt . Например, ось r будет равна 1 в chxt=x,r,y .
< начальное_значение >
Число, определяющее нижнее значение для этой оси.
< конечное_значение >
Число, определяющее максимальное значение для этой оси.
< опт_шаг >
[ Необязательный ] Шаг счета между отметками на оси. Значение шага по умолчанию отсутствует; шаг рассчитывается так, чтобы попытаться отобразить набор хорошо расположенных меток.

Примеры

Описание Пример

В этом примере показаны левая и правая оси Y ( y и r ) и одна ось X ( x ).

Каждая ось имеет определенный диапазон. Поскольку метки или позиции не указаны, значения берутся из заданного диапазона и равномерно распределяются внутри этого диапазона. На линейной диаграмме значения равномерно распределены по оси x.

Направление оси изменяется на противоположное для оси r (индекс 2 ), потому что первое значение ( 1000 ) больше, чем последнее значение ( 0 ).


chxt=x,y,r
chxr=
0,0,500|
1,0,200|
2,1000,0

В этом примере значения указаны для оси x.

Метки осей равномерно распределены вдоль оси. Для параметра < opt_step > указано значение пять ( 5 ).

Гистограмма с 200, 300 и 400 по оси X chxt=x
chxr=0,10,50,5

Вернуться к вершине

Пользовательские метки chxl

Вы можете указать пользовательские строковые метки осей на любой оси, используя параметр chxl . Вы можете указать столько меток, сколько хотите. Если вы отображаете ось (используя параметр chxt ) и не указываете пользовательские метки, будут применяться стандартные числовые метки. Чтобы указать пользовательский числовой диапазон, используйте вместо этого параметр chxr .

Чтобы задать определенные места вдоль оси для ваших меток, используйте параметр chxp .

Синтаксис

Укажите один набор параметров для каждой оси, которую вы хотите пометить. Разделите несколько наборов меток с помощью вертикальной черты ( | ).

chxl=
  <axis_index>:|<label_1>|...|<label_n>
    |...|
  <axis_index>:|<label_1>|...|<label_n>
<индекс_оси >
К какой оси применить метки. Это индекс в массиве параметров chxt . Например, если у вас есть chxt=x,x,y,y то индекс 0 будет первой осью x, а 1 будет второй осью x.
<метка_1> | ... |< label_n >
Одна или несколько меток для размещения вдоль этой оси. Это могут быть строковые или числовые значения; строки не обязательно заключать в кавычки. label_1 отображается в самом нижнем положении на оси, а label_n отображается в самом верхнем положении. Дополнительные метки располагаются между ними через равные промежутки. Отметьте пробелы знаком +. Невозможно указать разрыв строки в метке. Разделяйте метки вертикальной чертой. Примечание. Не размещайте канал после последней метки в параметре chxl .

Примеры

Описание Пример

На этой диаграмме показано, как добавить пользовательские метки к двум осям. Обратите внимание, как равномерно распределены значения и что последнее значение chxl не заканчивается вертикальной чертой.

Линейная диаграмма с 0 и 100 слева, A, B и C справа, январь, июль, январь, июль и январь на оси x и 2005, 2006 и 2007 ниже
chxt=x,y
chxl=
0:|Jan|Feb|March|April|May|
1:|Min|Mid|Max

Этот пример включает метки осей на левой и правой осях Y ( y и r ). Он также включает два набора значений для оси x ( x ). Вы можете рассмотреть возможность добавления делений на оси Y с помощью chxs .

Линейная диаграмма с 0 и 100 слева, A, B и C справа, январь, июль, январь, июль и январь на оси x и 2005, 2006 и 2007 ниже
chxt=x,y,r,x
chxl=
0:|Jan|July|Jan|July|Jan|
1:|0|50|100|
2:|A|B|C|
3:|2005|2006|2007

Этот пример включает метки осей на левой и правой осях Y ( y и r ). Он также включает два набора значений для оси x ( x ). Обратите внимание на пустые метки для нижнего набора по оси X, используемые для разделения значений.

В этом примере используются значения по умолчанию для меток оси на левой оси Y.

Гистограмма с 0 и 100 слева, A, B и C справа, январь, июль, январь, июль и январь на оси x и 2005, 2006 и 2007 ниже
chxt=x,y,r,x
chxl=
0:|Jan|July|Jan|July|Jan|
2:|A|B|C|
3:|2005||2006||2007

Если вы хотите добавить общую метку для описания всей оси (например, пометить одну ось «затраты», а другую — «ученик»), используйте свойство chxt , чтобы добавить дополнительную ось с каждой стороны, а затем используйте chxl , чтобы добавить по одной пользовательской метке с каждой стороны и chxp , чтобы разместить ее посередине оси.


chxt=x,x,y,y
chxl=1:|Martinis|3:|Score
chxp=1,50|3,50

Вернуться к вершине

Положения меток осей chxp

Вы можете указать, какие метки осей отображать, используя метки по умолчанию или пользовательские метки, указанные с помощью chxl . Если вы не укажете точные положения с помощью этого параметра, метки будут располагаться равномерно и со значением шага по умолчанию по осям. Если вы не укажете chxl , метки делений будут значениями по умолчанию (обычно это значения данных или номера столбцов в гистограммах).

Синтаксис

Разделите несколько наборов позиционирования с помощью вертикальной черты ( | ).

chxp=
  <axis_1_index>,<label_1_position>,...,<label_n_position>
    |...|
  <axis_m_index>,<label_1_position>,...,<label_n_position>
<индекс_оси >
Ось, для которой вы указываете позиции. Это индекс в массиве параметров chxt . Например, если у вас есть chxt=x,x,y,y то индекс 0 будет первой осью x, 1 будет второй осью x и так далее.
< позиция_метки_1 >,...,< позиция_метки_n >
Положение метки по оси. Это список числовых значений, разделенных запятыми, где каждое значение задает положение соответствующей метки в массиве chxl : первая запись применяется к первой метке и так далее. Позиция — это значение в диапазоне для этой оси . Обратите внимание, что это значение всегда будет от 0 до 100, если только вы не указали собственный диапазон с помощью chxr . У вас должно быть столько позиций, сколько у вас есть меток для этой оси.

Примеры

Описание Пример

Этот пример включает метки оси r в указанных позициях на диаграмме. Текст метки указывается с помощью параметра chxl .

Метки с указанной позицией 0 размещаются внизу оси Y или R или слева от оси X или оси T.

Метки с указанной позицией 100 размещаются вверху оси Y или R или справа от оси X или оси T.

Линейная диаграмма с минимальным, средним и максимальным значением справа, 20, 40, 60, 80 и 100 слева и 0, 25, 50, 75 и 100 по оси X
chxt=x,y,r
chxl=2:|min|average|max
chxp=2,10,35,75

В этом примере показано отображение значений меток по умолчанию, но только в указанных местах.

chxp=1,10,35,75 — на оси Y должны отображаться только три метки: 10, 35 и 75. Поскольку текст пользовательской метки не указан, отображаются эти значения оси. Обратите внимание, что при использовании chxp метки не должны располагаться на одинаковом расстоянии друг от друга. Если бы здесь не было указано chxp , расстояние значения метки по умолчанию по оси Y составляло бы каждые 20 единиц, как показано на втором графике.

Линейная диаграмма с 10, 35 и 75 слева и 0, 25, 50, 75 и 100 по оси X
chxt=x,y
chxp=1,10,35,75

Линейная диаграмма с положениями осей по умолчанию.
chxt=x,y
chxp не указан

Вернуться к вершине

Стили меток оси chxs

Вы можете указать размер шрифта, цвет и выравнивание для меток осей, как пользовательских меток, так и значений меток по умолчанию. Все метки на одной оси имеют одинаковый формат. Если у вас есть несколько копий оси, вы можете отформатировать каждую из них по-разному. Вы также можете указать формат строки метки, например, чтобы отображались символы валюты или нули в конце.

По умолчанию верхняя и нижняя оси не показывают метки рядом со значениями, а левая и правая оси показывают их.

Синтаксис

Значения для нескольких осей должны быть разделены вертикальной чертой ( | ).

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>
< индекс_оси >
Ось, к которой это относится. Это отсчитываемый от нуля индекс в параметре chxt .
< оптимальная_строка >
[ Необязательный ] Это необязательная строка формата, которая, если используется, следует сразу после номера индекса оси без промежуточной запятой. Он начинается с буквальной буквы N, за которой следуют следующие значения, все необязательные: Синтаксис строки форматирования следующий:
N< preceding_text >*< number_type >< decimal_places >zs< x or y >*< following_text >
Вот значение каждого элемента:
  • <preceding_text> — буквальный текст перед каждым значением.
  • *...* — необязательный блок, заключенный в буквенные звездочки, в котором вы можете указать детали форматирования для чисел. Поддерживаются следующие значения, и все они являются необязательными:
    • <number_type> — числовой формат для числовых значений. Выберите один из следующих вариантов:
      • f - [ По умолчанию ] Формат с плавающей запятой. Также рассмотрите возможность указания точности с помощью значения < decimal_places >.
      • p - Процентный формат. Знак % добавляется автоматически. Примечание. При использовании этого формата значения данных от 0,0 до 1,0 отображаются в диапазоне от 0 до 100 % (например, 0,43 будет отображаться как 43 %).
      • e - Формат научной записи.
      • c< CUR > — форматирование числа в указанной валюте с соответствующим маркером валюты. Замените < CUR > трехбуквенным кодом валюты. Пример: cEUR для евро. Список кодов можно найти на веб-сайте ISO , хотя поддерживаются не все символы.
    • <decimal_places> — целое число, указывающее, сколько знаков после запятой следует отображать. Значение округляется (не усекается) до этой длины. По умолчанию 2.
    • z — отображать конечные нули. По умолчанию нет .
    • s - Показать разделители групп. По умолчанию нет .
    • x или y - Отображение данных по координате x или y, как указано. Значение данных x зависит от типа диаграммы: поэкспериментируйте с диаграммой, чтобы определить, что это означает. По умолчанию «у» .
  • < following_text > — литеральный текст, который следует за каждым значением.
< opt_label_color >
Цвет, применяемый к тексту оси (но не линии оси), в шестнадцатеричном формате RRGGBB . Цвет линии оси задается отдельно с помощью opt_axis_color . По умолчанию серый.
< опт_размер_шрифта >
[ Необязательный ] указывает размер шрифта в пикселях. Этот параметр является необязательным.
< opt_alignment >
[ Необязательно ] Выравнивание метки. Для верхней или нижней осей это описывает, как метка выравнивается по отметке над или под ней; для левой или правой осей это описывает, как выравнивается внутри своей ограничивающей рамки, которая касается оси. Укажите один из следующих номеров:
  • -1 - Верх или низ : метки справа от делений; Влево или вправо : метки выравниваются по левому краю в своей области. Значение по умолчанию для меток оси R.
  • 0 - Верх или низ : метки располагаются по центру делений; Слева или справа : метки располагаются по центру своей области. Значение по умолчанию для меток осей x и t.
  • 1 - Верх или низ : метки слева от делений; Влево или вправо : метки выравниваются по правому краю в своей области. Значение по умолчанию для меток оси Y.
< opt_axis_or_tick >
[ Необязательный; не поддерживается в Google-o-meter ] Показывать ли деления и/или линии осей для этой оси. Засечки и осевые линии доступны только для самых внутренних осей (например, они не поддерживаются для двух внешних осей X). Используйте одно из следующих значений:
  • l (строчная буква «L») — рисовать только осевую линию.
  • t - рисовать только деления. Засечки — это маленькие линии рядом с метками осей.
  • lt - [ По умолчанию ] Нарисуйте как линию оси, так и метки для всех меток.
  • _ - (Подчеркивание) Не рисовать ни оси, ни делений. Если вы хотите скрыть линию оси, используйте это значение.
< тик_цвет >
[ Необязательный ; не поддерживается в Google-o-meter ] Цвет деления в шестнадцатеричном формате RRGGBB . По умолчанию серый.
< opt_axis_color >
[ Необязательный ] Цвет линии этой оси в шестнадцатеричном формате RRGGBB . По умолчанию серый.

Примеры

Описание Пример

Размер и цвет шрифта указаны для второй оси X (январь, февраль, март).

Линейная диаграмма с минимальным, средним и максимальным значением слева, 0, 1, 2, 3 и 4 справа, от 0 до 100 по оси X и январь, февраль и март синим цветом внизу

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

Размер шрифта, цвет и выравнивание указаны для правой оси Y. Рисуются засечки, но не линия оси.

Линейная диаграмма с от 0 до 100 по оси x, январь, февраль, март внизу, от 0 до 4 по оси y и красные метки с синим текстом для минимума, среднего и максимума справа.

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

Эта диаграмма включает три набора данных и показывает три набора меток осей, по одному на серию. Каждый набор меток форматируется с использованием пользовательской строки форматирования, как описано здесь:

  • 0N*e,000000|
    • 0 означает первую серию данных
    • N означает строку форматирования
    • * означает начало спецификаторов формата
    • e означает научное обозначение
    • * означает конец спецификаторов формата
    • 000000 означает черный текст.
  • 1N*cUSD*Mil,FF0000|
    • 1 означает вторую серию
    • N означает строку форматирования
    • * means the start of the format specifiers
    • c means a currency marker
    • USD specifies the US dollar as the currency marker to use
    • * means the end of the format specifiers
    • Mil is a literal following string
    • FF0000 means red text.
  • 2N*sz2*,0000FF
    • 2 means the third series
    • N means a formatting string
    • * means the start of the format specifiers
    • s means to show grouping specifiers (in US English locale, that is a comma every three zeroes)
    • z2 means show two trailing zeroes
    • 0000FF means blue text.

The axis label ranges are set using the chxr parameter ( axis_index , start , end , step ). If not set, they would have been 0—100 by default.


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

Back to top

Axis Tick Mark Styles chxtc

You can specify long tick marks for specific axes. Typically this is used to extend a tick mark across the length of a chart. Use the chxs parameter to change the tick mark color.

Values for multiple axes should be separated using a pipe character ( | ). Values within a series should be separated by a comma.

Syntax

chxtc=
  <axis_index_1>,<tick_length_1>,...,<tick_length_n>
    |...|
  <axis_index_m>,<tick_length_1>,...,<tick_length_n>
< axis_index >
The axis to which this applies. This is a zero-based index into the chxt parameter. Separate values for different axes using a bar delimiter.
< tick_length_1 >,...,< tick_length_n >
Length of the tick marks on that axis, in pixels. If a single value is given, it will apply to all values; if more than one value is given, the axis tick marks will cycle through the list of values for that axis. Positive values are drawn outside the chart area and cropped by the chart borders. The maximum positive value is 25. Negative values are drawn inside the chart area and cropped by the chart area borders.

Examples

Описание Пример

Example of using chxtc to create long red tick marks. The tick mark length here exceeds the chart area width, but is cropped to fit within the chart.

  • chxt=x,y,r,x - Show a left axis, a right axis, and two bottom axes.
  • chxl =2:|min|average|max|3:|Jan|Feb|Mar - The label text assigned to the 'r' (right side) and outer x-axes.
  • chxp =2,10,35,95 - Custom label positions along the r-axis (index=2) for the three labels.
  • chxs=2,0000dd,13,-1,t,FF0000 - Axis label styles for the r-axis: text color, text size, left-aligned, with red tick marks.
  • chxtc=1,10|2,-180 - Axis tick lengths for the y- and r-axes. The first value specifies 10-pixel-long ticks, outside the axis. The second value specifies 180-pixel-long ticks inside the axis; the negative number means that the tick goes inside the axis, and the tick is cropped to fit inside the chart.

Line chart with 0 to 100 along the x-axis, Jan, Feb, Mar below, 0 to 4 on the y-axis, and long red tickmarks with blue text for min, average and max on the right.

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

This chart demonstrates alternating tick lengths. chxtc specifies two tick length values for the y-axis (5 and 15), and the ticks drawn on the chart alternate between the two values.
chxt=x,y
chxtc=
1,5,15

Back to top

Background Fills chf [ All charts ]

You can specify fill colors and styles for the chart data area and/or the whole chart background. Fill types include solid fills, striped fills, and gradients. You can specify different fills for different areas (for example, the whole chart area, or just the data area). The chart area fill overwrites the background fill. All fills are specified using the chf parameter, and you can mix different fill types (solids, stripes, gradients) in the same chart by separating values with pipe character ( | ). Chart area fills overwrite chart background fills.

Solid Fills chf [ All Charts ]

You can specify a solid fill for the background and/or chart area, or assign a transparency value to the whole chart. You can specify multiple fills using the pipe character ( | ). (Maps: background only).

Syntax

chf=<fill_type>,s,<color>|...
< fill_type >
The part of the chart being filled. Specify one of the following values:
  • bg - Background fill
  • c - Chart area fill. Not supported for map charts.
  • a - Make the whole chart (including backgrounds) transparent. The first six digits of < color > are ignored, and only the last two (the transparency value) are applied to the whole chart and all fills.
  • b <index> - Bar solid fills (bar charts only). Replace < index > with the series index of the bars to fill with a solid color. The effect is similar to specifying chco in a bar chart. See Bar Chart Series Colors for an example.
s
Indicates a solid or transparency fill.
< color >
The fill color, in RRGGBB hexadecimal format . For transparencies, the first six digits are ignored, but must be included anyway.

Examples

Описание Пример

This example fills the chart background with pale gray ( EFEFEF ).

Red line chart with black area fill.

chf=bg,s,EFEFEF

This example fills the chart background with pale gray ( EFEFEF ) and fills the chart area in black ( 000000 ).

Red line chart with black chart area and pale gray background.

chf=c,s,000000|
bg,s,EFEFEF

This example applies a 50% transparency to the whole chart (80 in hexadecimal is 128, or about 50% transparency). Notice the table cell background showing through the chart.

Scatter plot with points in blue, and a 50% transparency.

chf=a,s,00000080

Back to top

Gradient Fills chf [ Line, Bar, Google-o-meter, Radar, Scatter,Venn ]

You can apply one or more gradient fills to chart areas or backgrounds. Gradient fills are fades from a one color to another color. (Pie, Google-o-meter charts: background only.)

Each gradient fill specifies an angle, and then two or more colors anchored to a specified location. The color varies as it moves from one anchor to another. You must have at least two colors with different < color_centerpoint > values, so that one can fade into the other. Each additional gradient is specified by a < color >,< color_centerpoint > pair.

Syntax

chf=<fill_type>,lg,<angle>,<color_1>,<color_centerpoint_1>
    ,...,
  <color_n>,<color_centerpoint_n>
< fill_type >
The chart area to fill. One of the following:
  • bg - Background fill
  • c - Chart area fill.
  • b <index> - Bar gradient fills (bar charts only). Replace < index > with the series index of the bars to fill with a gradient. See Bar Chart Series Colors for an example.
lg
Specifies a gradient fill.
< angle >
A number specifying the angle of the gradient from 0 (horizontal) to 90 (vertical).
< color >
The color of the fill, in RRGGBB hexadecimal format .
< color_centerpoint >
Specifies the anchor point for the color. The color will start to fade from this point as it approaches another anchor. The value range is from 0.0 (bottom or left edge) to 1.0 (top or right edge), tilted at the angle specified by < angle >.

Examples

Описание Пример

Chart area has a horizontal linear gradient, specified with an angle of zero degrees ( 0 ).

The colors are peach ( FFE7C6 ), centered on the left side (position 0.0 ) and blue ( 76A4FB ) centered on the right side (position 1.0 ).

The chart background is drawn in gray ( EFEFEF ).

Dark gray line chart with pale gray background and chart area in a white to blue linear gradient from left to right

chf=
c,lg,0,
FFE7C6,0,
(peach)
76A4FB,1
(blue)

Chart area has a diagonal (bottom left to top right) linear gradient, specified with an angle of forty-five degrees ( 45 ).

Peach ( FFE7C6 ) is the first color specified. The bottom left of the chart is pure peach.

Blue ( 6A4FB ) is the second color specified. The top right of the chart is pure blue. Note how we specify an offset of 0.75, to provide a peak of blue that fades away towards the top right corner.

The chart background is drawn in gray ( EFEFEF ).

Dark gray line chart with pale gray background and chart area in a white to blue diagonal linear gradient from bottom left to top right

chf=
c,lg,45,
FFE7C6,0,
(peach)
76A4FB,0.75
(blue)

Chart area has a vertical (top to bottom) linear gradient, specified with an angle of ninety degrees ( 90 ).

Blue ( 76A4FB ) is the first color specified. The top of the chart is pure blue.

Peach ( FFE7C6 ) is the second color specified. The bottom of the chart is pure peach.

The chart background is drawn in gray ( EFEFEF ).

Dark gray line chart with pale gray background and chart area in a white to blue vertical linear gradient from bottom to top

chf=
c,lg,90,
FFE7C6,0,
(peach)
76A4FB,0.5
(blue)

Back to top

Striped fills chf [ Line, Bar, Google-o-meter, Radar, Scatter, Venn ]

You can specify a striped background fill for your chart area, or the whole chart. (Pie, Google-o-meter charts: background only.)

Syntax

chf=
  <fill_type>,ls,<angle>,<color_1>,<width_1>
    ,...,
  <color_n>,<width_n>
< fill_type >
The chart area to fill. One of the following:
  • bg - Background fill
  • c - Chart area fill
  • b <index> - Bar striped fills (bar charts only). Replace < index > with the series index of the bars to fill with stripes. See Bar Chart Series Colors for an example.
ls
Specifies linear stripe fill.
< angle >
The angle of all stripes, relative to the y-axis. Use 0 for vertical stripes or 90 for horizontal stripes.
< color >
The color for this stripe, in RRGGBB hexadecimal format . Repeat < color > and < width > for each additional stripe. You must have at least two stripes. Stripes alternate until the chart is filled.
< width >
The width of this stripe, from 0 to 1 , where 1 is the full width of the chart. Stripes are repeated until the chart is filled. Repeat < color > and < width > for each additional stripe. You must have at least two stripes. Stripes alternate until the chart is filled.

Examples

Описание Пример
  • bg,ls,0 - Background stripe fill with stripes at a zero degree angle to the y-axis (parallel to the y-axis). The stripes fill the chart background as well as the plot area.
  • CCCCCC,0.15 - The first stripe is dark gray, 15% as wide as the chart.
  • FFFFFF,0.1 - The second stripe is white, 10% as wide as the chart.
Blue line chart with alternating gray and white stripes from left to right
chf=
bg,ls,0,
CCCCCC,0.15,
FFFFFF,0.1
  • c,ls,90 - Chart area with horizontal stripes at an angle of ninety degrees from the y-axis. The stripes fill the plot area, but the chart background is omitted.
  • 999999,0.25 - The first stripe is dark gray, 25% as wide as the chart.
  • CCCCCC,0.25 - Same as the first stripe, but a lighter gray.
  • FFFFFF,0.25 - Same as the first stripe, but white.
Blue line chart with a dark gray, pale gray, white and dark gray stripes from bottom to top
chf=
c,ls,90,
999999,0.25,
CCCCCC,0.25,
FFFFFF,0.25

Back to top

Grid Lines chg [ Line, Bar, Radar, Scatter ]

You can specify solid or dotted grid lines on your chart using the chg parameter.

This parameter doesn't let you specify the thickness or color of the lines. For more ways to make lines across your chart, see shape markers ( chm type h, H, v, or V), range markers ( chm ), and axis tick marks ( chxtc ).

Syntax

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 >
Used to calculate how many x or y grid lines to show on the chart. 100 / step_size = how many grid lines on the chart. So: 20,25 would mean 5 vertical grid lines and 4 horizontal grid lines.
< opt_dash_length >, < opt_space_length >
[ Optional ] Used to define dashed grid lines. The first parameter is the length of each line dash, in pixels. The second parameter is the spacing between dashes, in pixels. Specify 0 for < opt_space_length> for a solid line. Default values are 4,1.
< opt_x_offset >,< opt_y_offset >
[ Optional ] The number of units, according to the chart scale, to offset the x and y grid lines, respectively. Can be positive or negative values. If you specify this value, you must also specify all preceding values. Default values are 0,0.

Examples

Описание Пример

These examples use only the < x_axis_step_size > and < y_axis_step_size > parameters. The Chart API displays a dashed grid line by default.

Line chart with 5 vertical and two horizontal pale gray dashed grid lines
chg=20,50
Line chart with 5 vertical and two horizontal pale gray dashed grid lines
chg=20,50

This example uses larger spaces to display lighter grid lines ( 1,5 ).

Line chart with 5 vertical and two horizontal faint, pale gray, dashed grid lines
chg=20,50,1,5

To display solid grid lines, specify zero ( 0 ) for the < opt_space_length > parameter.

This chart also specifies an x-axis offset of 10.

Line chart with 5 vertical and two horizontal pale gray, solid grid lines
chg=20,50,1,0,10

This chart demonstrates an x-axis offset of 10, and ay axis offset of 20.

Line chart with 5 vertical and two horizontal pale gray, solid grid lines
chg=20,50,3,3,10,20

Back to top

Line Styles chls [ Line, Radar ]

You can specify line thickness and solid/dashed style with the chls parameter. This parameter can only be used to style lines in line or radar charts; you cannot use it to style the line in a compound chart lines, unless the base type of the compound chart is a line chart.

Syntax

Separate multiple line styles by the pipe character ( | ); the first style applies to the first line, the second to the next, and so on. If you have fewer styles than lines, the default style is applied to all the unspecified lines.

chls=
  <line_1_thickness>,<opt_dash_length>,<opt_space_length>
    |...|
  <line_n_thickness>,<opt_dash_length>,<opt_space_length>
< line_1_thickness >
Thickness of the line, in pixels.
< opt_dash_length >, < opt_space_length >
[ Optional ] Used to define dashed grid lines. The first parameter is the length of each line dash, in pixels. The second parameter is the spacing between dashes, in pixels. For a solid line, specify neither value. If you only specify < opt_dash_length >, then < opt_space_length > will be set to < opt_dash_length >. Default is 1,0 (a solid line ).

Examples

Описание Пример

Here the dashed line is specified by 3,6,3 and the thicker, solid line is specified by 5 ..

Line chart with one solid line and one dashed line
chls=3,6,3|5

Back to top

Dynamic Icon Markers chem [ Bar, Line, Radar, Scatter ]

Create your chart, and specify one or more dynamic icons as chem values. The syntax of chem is as follows. All semicolon-delimited items in purple are optional, and any one can be omitted entirely in your URL. You can include multiple markers by including multiple syntax strings delimited by a | character. You can read more about dynamic icons on the dynamic icon page .

You can also embed a chart inside another chart as a dynamic icon. See the Embedded Charts subsection below.

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 >
A string marker constant for a dynamic icon, from the dynamic icon page . This constant is almost the same as the chst parameter for freestanding icons. But where the freestanding icon string starts with "d_", you should remove that prefix to get the equivalent dynamic icon marker. Example: freestanding icon: d_bubble_icon_text_small ; equivalent dynamic icon marker: bubble_icon_text_small .
d=< marker_data_string >
The data required for this particular marker type. This holds the same string that would be used in a chld parameter for an equivalent freestanding icon, except that all | delimiters should be replaced by commas (remember to use commas instead of pipe markers for multiline text!). Note that within the data string, you must also escape the following characters with a @ mark: pipe ( | ) , at ( @ ) , equals ( = ), comma ( , ), semicolon ( ; ). Examples: hello@,+world , 5@@10+cents+each .
ds=< which_series >
[ Optional ] The zero-based index of the data series that this marker belongs to. Default value is 0.
dp=< which_points >
[ Optional ] Specifies which data points are used to draw markers. Default value is 0 (first point in the series) . Use one of the following formats:
  • nd - Which data point to draw the marker on, where nd is the zero-based index in the series. If you specify a non-integer value, then the fraction indicates a calculated intermediate point. For example, 3.5 means halfway between point 3 and point 4.
  • range,< start >,< end >,< step > - Draw a marker on every step data point in a range from start to end , inclusive. start and end are index values, and can be floating point numbers to indicate intermediate values. All values are optional; defaults are: start=0, end=last item, step=1. If you skip a value, you must still include any intermediate commas, but you don't have to include empty trailing commas. Examples: dp=range,0,4 draws a marker on elements 0 through 4; dp=range,5,10,2 draws a marker on elements 5, 7, and 9; dp=range,2 draws points on the third point and later; dp=range,3,,1.5 draws markers on every 1.5 data points from the fourth item to the last.
  • all - Draw a marker on every element. This is equivalent to range,0, end_index . Example: dp=all
  • every,n - Draw a marker on every n th marker. Example: dp=every,2 draws a marker on items 0, 2, and 4.
py=< z_order >
[ Optional ] The layer on which to draw the marker, compared to other markers and all other chart elements. This is a floating point number from -1.0 to 1.0, inclusive, where -1.0 is the bottom and 1.0 is the top. Chart elements (lines and bars) are just below zero. If two markers have the same value, they are drawn in the order given by the URL. Default value is 0.0 (just above the chart elements).
po=< x,y >
[ Optional ] An absolute position on the chart at which to draw the marker. x and y are two floating point numbers, where 0.0,0.0 is the bottom left corner and 1.0,1.0 is the top right corner.
of=< x_offset,y_offset >
[ Optional ] A number of pixels to offset the icon from its normal position. x_offset and y_offset are positive or negative integers. It is important to specify this value in an embedded dynamic icon, because the marker will be centered vertically and horizontally over the point, which means that the point probably won't line up with the data marker. A good offset for an upright pin is of=0,22 ; a good offset for a slanted pin is either of=-12,20 or of=12,20 depending on the direction of the slant, but you might have to experiment. Default value is 0,0.

Examples

Описание Пример
Here are examples of the same dynamic icon created as a free-standing image, and used as a marker in a line chart.

Chart 1: https://chart.googleapis.com/chart?chs=300x140&cht=lc&chco=FF9900,224499&
chd=t:75,74,66,30,10,5,3,1&chls=1|1&
chem=y;s=bubble_icon_text_small;d=ski,bb,Wheeee!,FFFFFF;dp=2;ds=0&chm=v,ccccFF,0,::.2,2

Chart 2: https://chart.googleapis.com/chart?chst=d_bubble_icon_text_small&chld=ski|bb|Wheeee!|FFFFFF|000000

Line chart with dynamic icon marker.
chem=
y;s=bubble_icon_text_small;d=ski,bb,Wheeee!,FFFFFF;dp=2;ds=0


Same dynamic icon marker as standalone image.


chst=
d_bubble_icon_text_small
chld=
ski|bb|Wheeee!|FFFFFF|000000

Note that a dynamic icon marker will be centered on the point horizontally and vertically. So if you use a dynamic icon with a tail, the tail won't be on the chart point; the marker center will be. The first chart centers the mark on data point 3, which actually puts the tail a bit to the right of the mark on the line.

The second chart uses the of value to move the tail of the marker on top of the desired data point. A good offset for a slanted pin is -12,20.


chem=y;
s=map_xpin_letter;
d=pin_sleft,A,FF0000;
dp=3;
ds=1



chem=y;
s=map_xpin_letter;
d=pin_sleft,A,FF0000;
dp=3;
ds=1;
of=-12,0

To include multiple dynamic icons, repeat the syntax string, delimited by a | character.

This example shows a range, as well as two individual markers.

Note how the vertical pins are offset by of 0,22, and the slanted pin has an offset of 12,20 to make the pin points line up with the series that they describe.


chem=
y;s=map_xpin_letter;d=pin_sright,A,FF0000;dp=4;ds=0;py=1;of=12,20|
y;s=map_pin_icon;d=baby,FF5555;ds=1;dp=6;of=0,22|
y;s=map_pin_icon;d=camping,DEF763;ds=2;dp=range,2,5
This demonstrates a multiline text marker. The marker must be offset after adding the text, because the bubble resizes to fit the text, causing it to be re-centered on the chart. Note how newlines in the text are indicated by commas in the d data string.
chem=y;
s=bubble_texts_big;
d=bbbr,FFC6A5,000000,Outlier,Forgot+to+feed;
ds=0;
dp=13;
of=-120,2

Embedded Charts

You can embed one chart inside another using the dynamic icon syntax.

There are two styles of embedded chart markers: embedded charts in a bubble, and embedded charts with no bubble. Here are examples of both:

Bubble-less chart
Chart with bubble
Chart without bubble

Here are the specifics of the s=< icon_string_constant >;d=< marker_data_string > parameters, both for non-bubble and bubble-embedded charts (parameters covered above aren't described again here):

Syntax

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
[ Non-bubble only ] Which part of the bubble-less embedded chart is pinned to the data point. Choose one of the two-letter string constants in the following diagram: Alignment strings
chart_data
The data for the embedded chart. This is everything after https://chart.googleapis.com/chart? in the URL of the chart to embed. Use the tool below, or follow the rules listed below the tool.
frame_type
[ Bubble only ] One of the dynamic icon frame style constants .
padding
[ Bubble only ] Padding inside the bubble, in pixels.
frame_color
[ Bubble only ] Color of the frame, as a six-digit HTML color string without the # mark. Example: FF00FF .
fill_color
[ Bubble only ] Bubble fill color, as a six-digit HTML color string without the # mark. Example: FF00FF .

Embedded chart data

Use the following conversion tool to help generate your chart string, or else generate the chart string manually following the rules given after the tool.

Rules for manual conversion

1. First replace all the following characters in the parameter and value pairs with the following values, in the order shown:

Replace With this
%7C or %7c
|
@
@@
%
%25
,
@,
|
@|
;
@;
&
%26
=
%3D

2. Then replace all the & and = values in the parameter1=value1&parameter2=value2... pairs with commas.

Back to top

Line Fills chm [ Line, Radar ]

You can fill the area below a data line with a solid color.

You can combine line fills with any other chm parameters using a pipe character ( | ) to separate the chm parameters.

Syntax

chm=
  <b_or_B>,<color>,<start_line_index>,<end_line_index>,<0>
    |...|
  <b_or_B>,<color>,<start_line_index>,<end_line_index>,<0>
< b_or_B >
Whether to fill to the bottom of the chart, or just to the next lower line.
  • B - Fill from < start_line_index > to the bottom of the chart. < end_line_index > supports a special syntax to let you fill a segment of the chart. This is easiest if you have a chart with a single line that you want to fill.
  • b - Fill between two lines in a multi-line chart. Start and end lines are indicated by < start_line_index > and < end_line_index > .
< color >
An RRGGBB format hexadecimal number of the fill color.
< start_line_index >
The index of the line at which the fill starts. The first data series specified in chd has an index of zero ( 0 ), the second data series has an index of 1 , and so on.
< end_line_index >
  • Fill type 'b' - The line at which to stop the fill. This line must be below the current line.
  • Fill type 'B' - One of the following choices:
    • any value - Any single number in this parameter is ignored, and the fill will go from the specified line to the base of the chart
    • start:end - To fill a vertical slice below the chart, specify start:end , where these are data point indices describing where to start and stop the fill. Both values are optional, and default to first_point : last_point . (See example below.)
<0>
Reserved — must be zero.

Examples

Описание Пример

For a single series, it is simplest to use chm=B . This fills the entire area under the line.

This is the only fill area type available for radar charts. chm=b does not work with radar charts.

Single line on a chart with shading in blue from the bottom of the chart to the line
chm=B,76A4FB,0,0,0

Here's a chart with two lines and two fills. Filling the area below the bottom line and above the top line requires a special technique, covered next.

Three lines on a chart; chart no shading from bottom to first line, red from first to second line, dark blue from second to third line and no shading from third line to top of the chart. Lines are drawn in default yellow
chd=s:
cefhjkqwrlgYcfgc,
QSSVXXdkfZUMRTUQ,
HJJMOOUbVPKDHKLH,

chm=
b,224499,0,1,0| (blue)
b,FF0000,1,2,0| (red)

In a multi-line chart, to fill from the top of the chart to the first line, include a series that contains two copies of the highest data value for the data format. So, for example, " .... " for extended encoding, " 100,100 " for basic text format, and so on. Fill from this series to the topmost line.

To fill from the last line to the bottom of the chart, include a series that contains two copies of the lowest data value for the data format. So, for example, AAAA for extended encoding, 0,0 for basic text format, and so on.

The lines themselves are drawn in black, using chco .

Three lines on a chart; chart is shaded in green from bottom to first line, red from first to second line, dark blue from second to third line and pale blue from third line to top of the chart
chd=e:
....,
(highest value)
cefhjkqwrlgYcfgc,
QSSVXXdkfZUMRTUQ,
HJJMOOUbVPKDHKLH,
AAAA
(zero value)
chm=
b,76A4FB,0,1,0|
(light blue)
b,224499,1,2,0| (blue)
b,FF0000,2,3,0| (red)
b,80C65A,3,4,0 (green)
chco=000000

Here is a line chart with vertical fill slices. This is accomplished by specifying a start : end pair for < end_line_index > with line fill type 'B'.

  • B,76A4FB,0,0:3,0 - Blue vertical fill under line 0, bound by data points 0—3.
  • B,990000,0,7:10,0 - Red vertical fill under line 0, bound by data points 7—10.
  • B,DEDC06,0,12:,0 - Yellow vertical fill under line 0, from data point 12 through the end of the series.

chm=
B,76A4FB,0,0:3,0|
B,990000,0,7:10,0|
B,DEDC06,0,12:,0

This example shows using a line fill on a radar chart.

Radar chart
chm=
B,FF000080,0,1.0,5.0|
B,FF990080,1,1.0,5.0

Back to top

Shape Markers chm [ Bar, Line, Radar, Scatter ]

You can specify graphical markers for all or individual data points on a chart. If two or more markers occupy the same point, the markers are drawn in the order in which they appear in the chm parameter. You can also create text markers on data points, which is covered in Data Point Markers .

You can combine shape markers with any other chm parameters using a pipe character ( | ) to separate the chm parameters.

Syntax

Specify one set of the following parameters for each series that should be marked. To mark multiple series, create additional parameter sets, delimited by a pipe character. You do not need to mark up all series. If you do not assign markers to a data series, it will not get any markers.

Shape markers behave slightly differently in scatter charts . See that documentation for more information.

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>
@
[ Optional ] If you precede the marker type with the optional @ character, then < opt_which_points > should use the x:y format.
<marker_type>
The type of marker to use. Specify one of the following types:
  • a - Arrow
  • c - Cross
  • C - Rectangle. If a rectangle marker, you must have at least two data series, where series 0 specifies the bottom edge and series 1 specifies the top edge. < size > specifies the width of the rectangle, in pixels.
  • d - Diamond
  • E - Error-bar marker ( ) This marker requires two data series to create, one value for the bottom, and the corresponding point in the second series for the top. It also exposes an extended < size > syntax: line_thickness [: top_and_bottom_width ] where top_and_bottom_width is optional. See the examples below.
  • h - Horizontal line across the chart at a specified height. ( The only valid format for < opt_which_points > parameter is nd . )
  • H - Horizontal line through the specified data marker. This supports an extended < size > syntax that lets you specify an exact line length: line_thickness [: length ] where : length is optional, and defaults to the full chart area width.
  • o - Circle
  • s - Square
  • v - Vertical line from the x-axis to the data point
  • V - Vertical line of adjustable length. This supports an extended < size > value syntax that lets you specify an exact line length: line_thickness [: length ] where : length is optional, and defaults to the full chart area height. The marker is centered on the data point.
  • x - An X
< color >
The color of the markers for this series, in RRGGBB hexadecimal format .
< series_index >
The zero-based index of the data series on which to draw the markers. Ignored for h markers and markers that specify location by x/y position (start with the @ character). You can use hidden data series as a source for markers; see Compound Charts for more information. Grouped vertical bar charts support a special extended syntax to align markers with specific bars.
< opt_which_points >
[ Optional ] Which point(s) to draw markers on. Default is all markers. Use one of the following values:
  • nd - Where to draw the marker. The meaning depends on the marker type:
    • All types except h - Which data point to draw the marker on, where nd is the zero-based index in the series. If you specify a non-integer value, then the fraction indicates a calculated intermediate point. For example, 3.5 means halfway between point 3 and point 4.
    • h - A number from 0.0 to 1.0, where 0.0 is the bottom of the chart, and 1.0 is the top of the chart.
  • -1 - Draw a marker on all data points. You can also leave this parameter empty to draw on all data points.
  • - n - Draw a marker on every n -th data point. Floating point value; if n is less than 1 the chart will calculate additional intermediary points for you. For example, -0.5 will put twice as many markers as data points.
  • start:end:n - Draw a marker on every n -th data point in a range, from start to end index values, inclusive. All parameters are optional (may be absent), so 3::1 would be from the fourth element to the last, step 1, and omitting this parameter entirely would default to first : last :1. All values can be floating point numbers. start and end can be negative, to count backward from the last value. If both start and end are negative, be sure that they are listed in increasing value (for example, -6:-1:1). If the n step value is less than 1, it will calculate additional data points by interpolating the data values given. Default values are first:last:1
  • x : y - Draw a marker at a specific x/y point on the chart. This point does not have to be on a line. Add the @ character before the marker type to use this option. Specify the coordinates as floating point values, where 0:0 is the bottom left corner of the chart and 1:1 is the top right corner of the chart. For example, to add a red, 15-pixel diamond to the center of a chart, use @d,FF0000,0,0.5:0.5,15 .
< size >
The size of the marker, in pixels. Most take a single number value for this parameter; the V, H, and S markers support the syntax < size >[: width ] where the optional second part specifies the line or marker length.
< opt_z_order >
[ Optional ] The layer on which to draw the marker, compared to other markers and all other chart elements. This is a floating point number from -1.0 to 1.0, inclusive, where -1.0 is the bottom and 1.0 is the top. Chart elements (lines and bars) are just lower than zero. If two markers have the same value, they are drawn in the order given by the URL. Default value is 0.0 (just above the chart elements).
< opt_offset >
[ Optional ] Let you specify horizontal and vertical offsets from the specified location. Here is the syntax, which uses a : delimiter: reserved :< horizontal_offset >:< vertical_offset > . If specified, you can include an empty ,, value in the chm parameter string for < opt_z_order >. Examples: o,FF9900,0,4,12,, :10 o,FF9900,0,4,12.0,, :-10:20 o,FF9900,0,4,12,1, ::20
  • reserved - Leave blank.
  • < horizontal_offset > - A positive or negative number specifying the horizontal offset, in pixels. Optional; leave blank if not used.
  • < vertical_offset > - A positive or negative number specifying the vertical offset, in pixels. Optional; leave blank if not used.

Examples

Описание Пример

Here's an example of several of the shape and line markers.

  • a,990066,0,0.0,9.0 - Purple arrow, first series, first point, size 9.
  • c,FF0000,0,1.0,20.0 - Red cross, first series, second point, size 9.
  • d,80C65A,0,2,20.0 - Green diamond, first series, third point, size 9.
  • H,000000,0,3,1:40 - Black horizontal line, first series, data point 3, one pixel wide, forty pixels long.
  • o,FF9900,0,4.0,12.0 - Orange circle, first series, fifth point, size 12.
  • s,3399CC,0,5.0,11.0 - Blue square, first series, sixth point, size 11.
  • v,BBCCED,0,6.0,1.0 - Vertical line up to point, first series, seventh point, one pixel wide.
  • V,3399CC,0,7.0,1.0 - Vertical line bottom to top of chart, first series, eighth point, one pixel wide.
  • x,FFCC33,0,8.0,20.0 - Yellow 'X', first series, ninth point, size 20.
  • H,FFFF00,0,9,2 - Horizontal yellow line the width of the chart at data point 9.
  • h,FF0000,0,0.5,1 - Red horizontal line at designated height, first series, halfway up the chart, one pixel wide.
Line chart with markers
chm=
a,990066,0,0.0,9.0|
c,FF0000,0,1.0,20|
d,80C65A,0,2.0,20.0|
H,000000,0,3,1:40|
o,FF9900,0,4.0,12.0|
s,3399CC,0,5.0,11.0|
v,BBCCED,0,6,1.0|
V,3399CC,0,7,1.0|
x,FFCC33,0,8,20|
H,FFFF00,0,9,2|
h,FF0000,0,0.5,1

Here's an example using diamonds for one data series, and circles for the other data series.

If two or more markers occupy the same point, the markers are drawn in the order in which they appear in the chm parameter. Here, the circle is the first marker specified with chm , so it is drawn first. The diamond is specified and drawn second, which results in it being drawn on top of the circle.

Line chart, one line has 15 pixel circles on each data point the other line has 10 pixel diamonds. A diamond is drawn on the point that is common to both lines
chm=
o,FF9900,0,-1,15.0|
d,FF0000,1,-1,10.0

Here's a line chart with a marker on every second data point (-2 means every other point).

Line chart with marker on every second point
chd=t:
0,20,20,50,40,70,70,90,85,45,40,50
chm=
o,0066FF,0,-2,6
Here's a line chart with twice as many markers as data points (-0.5 means every half point). Line chart with marker on every second point
chd=t:
0,20,20,50,40,70,70,90,85,45,40,50
chm=
o,0066FF,0,-.5,6
This example shows how to use h and v markers to create grid lines with custom colors and thickness. The z-order value (the last value) is set to -1 so that the grid lines are drawn beneath the data line.
Line chart with marker on every second point
chm=
h,76A4FB,0,0:1:.2,2,-1|
V,76A4FB,0,::2,0.5,-1

This chart adds vertical fill lines to a line chart:

  • v - Vertical lines to the chart
  • FF0000 - Red lines
  • 0 - Series index
  • : :.5 - Range specifier: from start to end, every 0.5 points.
  • 2 - Thickness 2 pixels.
Line chart with marker on every second point
chm=
v,FF0000,0,::.5,2
This example adds an arrow and text marker to the chart using exact coordinates. The first D marker is the trace line under the bars. The second marker is the arrow, and the third marker is the arrow text.
chm=
D,003971,1,0,3|
@a,000000,0,.25:.75,7|
@tExpected,000000,0,.35:.85,10
A horizontal line fixed to a specific data point ( H ) can be useful for showing relative values, or emphasizing the height of a data value on a chart.
chm=H,FF0000,0,18,1

This graph demonstrates the markers that can specify line thickness and length in the < size > parameter.

  • E,000000,0,6,1:20 - Black error bar with 1 pixel wide lines, top and bottom bars 20 pixels long. The bottom is anchored to series 0 point 8, the top is anchored to series 1 point 8.
  • H,990066,1,2,5:50 - Purple, horizontal line five pixels wide, fifty pixels long centered on data point 2.
  • V,3399CC,0,8,3:50 - Blue, vertical line 3 pixels wide, fifty pixels long, centered on data point 8.

chm=
E,000000,0,6,1:20|
H,990066,1,2,5:50|
V,3399CC,0,8,3:50

Back to top

Text and Data Value Markers chm [ Bar, Line, Radar, Scatter ]

You can label specific points on your chart with custom text, or with formatted versions of the data at that point.

You can combine any chm markers using a pipe character ( | ) to separate the chm parameter sets.

A note on string values: Only URL-safe characters are permitted in label strings. To be safe, you should URL-encode any strings containing characters not in the character set 0-9a-zA-Z . You can find a URL encoder in the Google Visualization Documentation .

Syntax

Specify one set of the following parameters for each series that should be marked. To mark multiple series, create additional parameter sets, delimited by a pipe character. You do not need to mark up all series. If you do not assign markers to a data series, it will not get any markers.

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>
The type of marker to use. You can choose from the following types:
  • f<text> - A flag containing text. Specify the character 'f', followed by custom URL-encoded text. To escape commas in text markers, precede the comma by a \ mark. Example: fHello\,+World!
  • t<text> - A simple text marker. Specify the character 't' followed by custom URL-encoded text. To escape commas in text markers, precede the comma by a \ mark. Example: tHello\,+World!
  • A< text > - An annotation marker. This is similar to a flag marker, but markers will coordinate their position so that they do not overlap. The only valid format for < opt_which_points > is nd , to signify the index of a point in the series.
  • N< formatting_string > - The value of the data at this point, with optional formatting. If you do not use the chds parameter (custom scaling) it gives the exact encoded value; if you do use that parameter with any format type the value will be scaled to the range that you specify. See an example of chds with numeric markers below. With this marker type in a stacked bar chart , if you specify -1 for < series_index > you will get a marker that shows the sum of all values in this stacked bar. The formatting string syntax is as follows:
    < preceding_text >*< number_type >< decimal_places >zs< x or y >*< following_text > .
    All of these elements are optional. Here is the meaning of each element:
    • <preceding_text> - Text to precede each value.
    • *...* - An optional block wrapped in literal asterisks, in which you can specify formatting details for numbers. The following values are supported, and are all optional:
      • <number_type> - The number format, for numeric values. Choose one of the following:
        • f - [ Default ] Floating point format. Consider specifying precision as well with the < decimal_places > value.
        • p - Percentage format. A % sign is appended automatically. Note: When using this format, data values from 0.0 — 1.0 map to 0 — 100% (for example, 0.43 will be shown as 43%).
        • e - Scientific notation format.
        • c< CUR > - Format the number in the currency specified, with the appropriate currency marker. Replace < CUR > with a three-letter currency code. Example: cEUR for Euros. You can find a list of codes on the ISO web site , although not all symbols are supported.
      • <decimal_places> - An integer specifying how many decimal places to show. The value is rounded (not truncated) to this length. Default is 2.
      • z - Display trailing zeros. Default is no .
      • s - Display group separators. Default is no .
      • x or y -Display the data from the x- or y-coordinate, as specified. The meaning of x data varies by chart type: experiment with your chart to determine what it means. Default is 'y' .
    • < following_text > - Text to follow each value.
< color >
The color of the markers for this set, in RRGGBB hexadecimal format .
< series_index >
The zero-based index of the data series on which to draw the markers. If this is a stacked bar chart and the marker type is N (data point values), you can specify -1 to create a summed value marker for each stack of bars. See below for an example.
< opt_which_points >
[ Optional ] Which point(s) to draw markers on. Default is all markers. Use one of the following values:
  • nd - Which data point to draw the marker on, where nd is the zero-based index in the series. If you specify a non-integer value, then the fraction indicates a calculated intermediate point. For example, 3.5 means halfway between point 3 and point 4.
  • -1 - Draw a marker on all data points. You can also leave this parameter empty to draw on all data points.
  • -n - Draw a marker on every n -th data point.
  • start : end : n - Draw a marker on every n -th data point in a range, from start to end index values, inclusive. All parameters are optional (may be absent), so 3::1 would be from the fourth element to the last, step 1, and omitting this parameter entirely would default to first : last :1. All values can be floating point numbers. start and end can be negative, to count backward from the last value. If both start and end are negative, be sure that they are listed in increasing value (for example, -6:-1:1). If the n step value is less than 1, it will calculate additional data points by interpolating the data values given. Default values are first:last:1
  • x : y - [ Not supported for N-type markers ] Draw a marker at a specific x/y point on the chart. This point does not have to be on a line. Add the at character ( @ ) before the marker type to use this option. Specify the coordinates as floating point values, where 0:0 is the bottom left corner of the chart, 0.5:0.5 is the center of the chart, and 1:1 is the top right corner of the chart. For example, to add a red, 15-pixel diamond to the center of a chart, use @d,FF0000,0,0.5:0.5,15 .
< size >
The size of the marker in pixels. If this is a scatter chart with a third data series (used to specify point sizes), this value will be scaled by the data range. So if the data range is 0—100 and < size > is 30, a data value of 100 would be 30 pixels wide, a data value of 50 would be 15 pixels wide, and so on.
< opt_z_order >
[ Optional ] The layer on which to draw the marker, compared to other markers and all other chart elements. This is a floating point number from -1.0 to 1.0, inclusive, where -1.0 is the bottom and 1.0 is the top. Chart elements (lines and bars) are just lower than zero. If two markers have the same value, they are drawn in the order given by the URL. Default value is 0.0 (just above the chart elements).
< opt_placement >
[ Optional ] Additional placement details describing where to put this marker, in relation to the data point. You can specify horizontal and/or vertical relative positioning, as well as offsets. Placement syntax is a string with : delimiters as shown here. All elements are optional: < horizontal_and_vertical_justification >:< horizontal_offset >:< vertical_offset > . If specified, you can include an empty ,, value in the chm parameter string for < opt_z_order >. Examples: N,000000,0,1,10,,b and N,000000,0,1,10,,lv and N,000000,0,1,10,,r::10 .
horizontal_and_vertical_justification
The anchor point of the marker. This behaves opposite to justification, so a left anchor actually puts the marker to the right of the data point. You can choose a horizontal and/or vertical justifier from the following list:
  • Horizontal placement : 'l', 'h', or 'r' - Left, center, or right-anchored, horizontally. Default is 'l'.
  • Vertical placement : 'b', 'v', 't' - Bottom, middle, or top-anchored, vertically. Default is 'b'.
  • Bar-relative placement [ Bar charts only] : 's', 'c', 'e' - Base, center, or top of a bar. For stacked charts, this is relative to the section of the bar for each series, not for the whole bar. If the series index given is -1 (stack total) it is in relation to the whole bar. This can be combined with vertical placement values: for example, 'be' or 'vs'. Default value is 'e'.
horizontal_offset
A horizontal offset for this marker, in pixels. Default is 0.
vertical_offset
A vertical offset for this marker, in pixels. Non-bar chart default: 15; bar chart chart default: 2 .

Описание Пример

Here's an example of value labels on a bar chart.

The first chart ( N*p0* ) specifies a data value marker, with values shown as a percentage, rounded to zero decimal places, in black, on all values, in 11-point text. Note that the data values are all between 0.0 and 1.0, which, in percentage format, are moved up two decimal places.

The second chart ( N*cEUR1* ) shows the same values formatted as Euro values, one decimal place, in black, on all values, in 11-point text.

Bar chart with percentage labels above each bar
chm=
N*p0*,000000,0,-1,11
chd=t:
0.4356,0.3562,0.4834,0.575,0.673,0.6091


Bar chart with Euro labels above each bar


chm=
N*cEUR1*,000000,0,-1,11

You can use the chds parameter to scale the numeric value displayed. You can use chds for all data formats, including simple and extended encoding. This will not affect the bar size or the axis labels, but only the data marker value.

This example shows a chart with simple-encoded values of 46, 39, 29, 30, 43, 41. Simple encoding range is 0—61 . The chds parameter defines a custom marker scale of 0—1, so marker values are scaled to this range, but the bar heights are not affected (if this were text format data , the bars would be scaled as well).


chd=s:underp
chm=N,000000,0,-1,11
chds=0,1

Here's an example of a chart with a text label at the minimum point and a flag label at the maximum point.

Line chart with 10pt blue text label, and flag with 15pt red text, drawn on the data points of a dashed green line.
chm=
tMin,0000FF,0,1,10|
fMax,FF0000,0,3,15

This example shows a stacked chart with values for individual series, plus the series total. To show the stacked series values, we must use the 'c' positioning option; if we did not, the top bar value would overlap the sum value at the top of each bar.
chm=
N,FF0000,-1,,12|
N,000000,0,,12,,c|
N,000000,1,,12,,c|
N,ffffff,2,,12,,c
Some more demonstrations of how vertical and horizontal placement work. This example demonstrates various combinations of anchor values for bar charts (which use s, c,and e for vertical placement). Note how a right anchor moves a marker left, and a top anchor moves a marker down, and vice-versa. The red dots show the base, center, and top of each bar. The number is the data value, fixed using different anchor values for each bar.
chm=
N,000000,0,0,10,,rs
N,000000,0,1,10,,ls
N,000000,0,2,10,,c
N,000000,0,3,10,,e
N,000000,0,4,10,,e::15
N,000000,0,5,10,,e::-12
Annotation markers automatically adjust the label position so that they don't overlap. The first chm value is for the line fill, the following values are all annotation markers. Annotation marker.
chm=B,C5D4B5BB,0,0,0
AA,666666,0,3,15
AB,666666,0,5,15
AC,666666,0,24,15
AD,666666,0,25,15
AE,666666,0,26,15
AF,666666,0,51,15
AG,666666,0,60,15
AH,666666,0,73,15
AI,666666,0,80,15
AJ,666666,0,99,15
Another annotation marker example demonstrating city altitudes in Switzerland.

Back to top

Range Markers chm [ Bar, Candlestick, Line, Radar, Scatter ]

You can color horizontal or vertical bands of background fill to highlight specific areas of a chart.

You can combine any chm markers using a pipe character ( | ) to separate the chm parameter sets.

Syntax

Specify one set of the following parameters for each band to draw. To draw multiple bands, create additional parameter sets, delimited by a pipe character. Ranges are drawn in the order specified, so the last range drawn will be drawn on top of previous ranges.

chm=
  <direction>,<color>,0,<start_point>,<end_point>
    |...|
  <direction>,<color>,0,<start_point>,<end_point>
<direction>
Specifies horizontal or vertical shading. Use r for a horizontal range and R for a vertical range.
< color >
The range color as an RRGGBB format hexadecimal number .
0
Reserved — must be zero.
< start_point >
The start position of the range.
  • For horizontal range markers, this is a position on the y-axis, where 0.00 is the bottom of the chart, and 1.00 is the top of the chart.
  • For vertical range markers, this is a position on the x-axis, where 0.00 is the left of the chart, and 1.00 is the right of the chart.
< end_point >
The end position of the range.
  • For horizontal range markers, this is a position on the y-axis, where 0.00 is the bottom of the chart, and 1.00 is the top of the chart.
  • For vertical range markers, this is a position on the x-axis, where 0.00 is the left of the chart, and 1.00 is the right of the chart.

Examples

Описание Пример

Range markers can be a thin line or a band of color.

  • r,E5ECF9,0,0.75,0.25 - Range marker, pale blue, (reserved), 0.5 of the height of the chart.
  • r,000000,0,0.1,0.11 - Range marker, black, (reserved), starts at 0.1 of the way up the y-axis and ends at 0.11 of the way up the y-axis (a thin black line).
Line chart with a pale blue horizontal band stretching from 25 percent to 75 percent of the way up the y-axis and a thin horizontal line ten percent of the way up the y-axis
chm=
r,E5ECF9,0,0.75,0.25|
r,000000,0,0.1,0.11

This example shows the vertical range markers. The first marker is a red line ( FF0000 ), and the second is a pale blue band ( A0BAE9 ).

Line chart with a pale blue vertical band stretching from 25 percent to 75 percent of the way along the x-axis and a thin vertical line ten percent of the way along the x-axis
chm=
R,FF0000,0,0.1,0.11|
R,A0BAE9,0,0.75,0.25

Markers are drawn in the order specified. In this example, you can see that the vertical red marker was drawn before the pale blue horizontal marker.

Line chart with a blue vertical band and paler blue horizontal band stretching from 25 percent to 75 percent of the way along the x and y-axis respectively. Thin vertical red line and thin horizontal black line ten percent of the way along the x and y-axis respectively
chm=
R,FF0000,0,0.1,0.11|
R,A0BAE9,0,0.75,0.25|
r,E5ECF9,0,0.75,0.25|
r,000000,0,0.1,0.11

Here's an example of a line chart that uses range markers to draw faint horizontal lines across the chart at the zero line, midpoint line, and top.

Sparkline with single yellow line and three equally spaced horizontal lines
chm=
r,000000,0,0.499,0.501|
r,000000,0,0.998,1.0|
r,000000,0,0.0,0.002

Back to top

Candlestick Markers chm=F [ Bar, Line ]

Candlestick markers indicate variance and direction change in a data series. Often they are used to show stock values during the course of a day. The marker includes segments that show the high and low value, as well as the opening and closing value for a specific time period (typically a day). For more about candlestick markers, see here .

A candlestick marker is drawn as a rectangle bisected by a vertical line. It requires four data series to draw a candlestick marker; here is what each series specifies:

  • Series 1 and 4 specify the bottom and top of the vertical line, respectively. These typically represent the low and high values for the day.
  • Series 2 and 3 specify the vertical borders of the rectangle. Series 2 is the opening value, and series 3 is the closing value. The color of the rectangle depends on which is higher: when the opening value (series 2) is lower than the closing value (series 3), the price has increased, and the rectangle is filled with solid green by default; when the opening value (series 2) is higher than the closing value (series 3), the price has decreased, and the rectangle is filled with solid red by default. You can only specify a fill color for the rectangle with decreasing value. When you specify that, the rectangle with increasing value is unfilled (empty). Note that series 2 can be either the top or the bottom of the rectangle, depending on whether the price has gone up or down.

You can combine candlestick markers with any other chm parameters using a pipe character ( | ) to separate the chm parameters.

Note: If you do not want the lines for the data used to draw the markers to appear in the chart, you must include a 0 after the format type. For example: chd=t0:10,20,30,40 in a text format data string. See Compound Charts for more information.

Here's an example, showing the lines for each series:

Syntax

chm=
  F,<opt_declining_color>,<data_series_index>,<opt_which_points>,<width>,<opt_z_order>
F
Indicates that this is a candlestick marker.
<opt_declining_color>
[ Optional ] Fill color for the rectangles when the value is decreasing (when series 2 value > corresponding series 3 value). This is an RRGGBB format hexadecimal number . When the values increase, the rectangle will be empty. Default is solid green for increasing, solid red for decreasing (you cannot specify a custom fill color for increasing values).
< data_series_index >
The index of the data series to use as the first series for your candlestick markers. This is a zero-based index. So, if you specify 1 here, and you have six series, the second, third, fourth and fifth will be used to draw candlestick markers.
<opt_which_points>
[ Optional ] Specifies which data points are used to draw markers. Default is all markers. Use one of the following formats:
  • nd - Draw a marker on a single point in the series, where nd is the index of the point in the series. If you specify a non-integer value, then the fraction indicates a calculated intermediate point. For example, 3.5 means halfway between point 3 and point 4.
  • -1 - Draw a marker on all data points. You can also leave this parameter empty to draw on all markers.
  • - n - Draw a marker on every n -th data point.
  • start:end:n - Draw a marker on every n -th data point in a range, from start to end index values, inclusive. All parameters are optional (may be absent), so 3::1 would be from the fourth element to the last, step 1, and omitting this parameter entirely would default to first : last :1. All values can be floating point numbers. start and end can be negative, to count backward from the last value. If both start and end are negative, be sure that they are listed in increasing value (for example, -6:-1:1). If the n step value is less than 1, it will calculate additional data points by interpolating the data values given. Default values are first:last:1
<width>
The width of all rectangles, in pixels.
<opt_z_order>
[ Optional ] The layer on which to draw the marker, compared to other markers and all other chart elements. This is a floating point number from -1.0 to 1.0, inclusive, where -1.0 is the bottom and 1.0 is the top. Chart elements (lines and bars) are just lower than zero. If two markers have the same value, they are drawn in the order given by the URL. Default value is 0.0 (just above the chart elements).

Examples

Описание Пример

Here's an example of candlestick markers on a line chart with four series. The custom fill color 0000FF (blue) is specified, and this color is used to fill the rectangles when the point in series 3 is smaller than the equivalent point in series 2.

The first and last rectangle are trimmed by the chart. To eliminate these values, you could specify 1:4 for the fourth parameter of chm.

Note the zero in the data string, to hide the lines for the series: chd=t0 . This indicates that all chart data is to be used for markers.

The < which_point > parameter is blank, which draws candlesticks on all data points.

Line chart with four orange lines and four financial markers

chd=t0:
0, 5,10, 7,12, 6|
35,25,45,47,24,46|
15,40,30,27,39,54|
70,55,63,59,80,60
chm=F,0000FF,0,,20

Here's an example of the same chart, using the default colors, and removing the first and last item.

This is a compound chart: it is a combination of a line chart (the base chart type) and candlestick markers. The value of 1 in cht=t:1 means that all data series after the first should be hidden from the basic chart type (line chart). The first 1 in chm=F,, 1 ,1:4,20 means that the candlestick data comes from series 2, 3, 4, and 5 (the 1 is zero-based). See Compound Charts for more information on how to draw a compound chart like this.

Line chart with one orange line and four financial markers.
cht=lc
chm=
F,,1,1:4,20

chd=t1:
15,40,30,27,39,54|
...

Back to top

Line Markers chm=D [ Bar, Candlestick, Line, Radar, Scatter ]

You can add a line that traces data in your chart. Most often, this is used in compound charts .

To add multiple lines (or combine this with any other chm markers), separate the chm parameter sets using a pipe ( | ) delimiter. You cannot make a dashed line marker with this parameter.

Syntax

chm=
  D,<color>,<series_index>,<which_points>,<width>,<opt_z_order>
D
Indicates that this is a line marker.
< color >
The color of the line, in RRGGBB hexadecimal format .
< series_index >
The index of the data series used to draw the line. The data series index is 0 for the first data series, 1 for the second data series, and so on.
< which_points >
Which points in a series to use to draw the line. Use one of the following values:
  • 0 - Use all the points in the series.
  • start:end - Use a specific range of points in the series, from the start to end , inclusive (zero-based index). You can also use floating point values to specify intermediate points, or leave start or end blank to indicate the first or last data point, respectively. start and end can be negative, as a reverse index from the last value. If both start and end are negative, be sure to write them in increasing value (for example, -6:-1).
< size >
The width of the line in pixels.
< opt_z_order >
[ Optional ] The layer on which to draw the marker, compared to other markers and all other chart elements. This is a floating point number from -1.0 to 1.0, inclusive, where -1.0 is the bottom and 1.0 is the top. Chart elements (lines and bars) are just lower than zero. If two markers have the same value, they are drawn in the order given by the URL. Default value is 0.0 (just above the chart elements).

Examples

Описание Пример

This is an example of drawing a marker line on a bar chart. The z-order is set to 1 , so the line is drawn on top of the bars.

This example uses the same data for both the bars and the data line.
Bar chart with line marker
chm=D,0033FF,0,0,5,1
chd=s:1XQbnf4

This is the same bar chart, but with an additional data series just for the line. This is an example of a compound chart. Compound charts are drawn by adding additional data series to the chd parameter, plus a value to chd telling the chart to "ignore" the additional data series.

See Compound Charts for more information.

Bar chart with line marker
chm=D,0033FF,1,0,5,1
chd=s1:1XQbnf4,43ksfg6

Back to top

Data Functions chfd [ All chd charts ]

You can specify a custom function to run over chart data using muParser function syntax . The data used in the function can come from one of two sources:

  • A data series from chd - The data is pulled from the specified series in chd .
  • A range of values declared in the chfd parameter itself - You declare a start, stop, and step value for an arbitrary data range.

It is important to note that in all cases you must assign the output to an existing series in chd ; that series will be overwritten by the function output. The chart is rendered only after all functions have been processes, so if you assign multiple functions to output to the same data series, the functions will be run in the order given, but only the output of the final function will be plotted on the chart. Note that you can chain functions, so that one function can take as input a series that was output by a previous function.

To assign colors or chm markers to a function line, assign the colors or markers to the function's series index. Note that markers are placed according to the data after it has been manipulated by the function.

Syntax

chfd=
  <output_series_index>,<function_data>,<function_string>
    |...|
  <output_series_index>,<function_data>,<function_string>
< output_series_index >
Zero-based index of a data series in chd to which the function output will be written. Any existing data will be completely overwritten by the function output. If a series is not being used as input for a function, best practice is to assign a single dummy value to that series.
< function_data >
The variables and data to plot. The data can be from a range that you define, or from one of the chd data series. You can specify multiple variables for each function, using a ; (semicolon) delimiter for multiple variables. Note that if you define multiple variables for a single function, and these variables have a different number of points, the function will stop when it reaches the first endpoint. For example, if a function defines both x=1—5 step 1 and y=1—10 step 1, the function will end when it reaches the fifth point.
< variable_name >,< input_series_index >
OR
< variable_name >,< start >,< end >,< step >
  • variable_name - An arbitrary string name for the variable. Use this in the function defined by function_string .
  • input_series_index - The index of a chd data series to use as input data.
  • start - The numeric start value of a range.
  • end - The numeric end value of a range.
  • step - The numeric step value from start to end . Can be positive or negative, but cannot be zero.
Examples: x,0,100,1 declares a variable named x with values 0, 1, 2, ... 100. x,0,100,1;r,0,3.1,.1 declares the same x variable plus a variable named r with values 0, 0.1, 0.2, ..., 3.0, 3.1. x,0 declares a variable named x that uses the data from the first chd series. These variables will be used by function_string . They will not be plotted on the graph unless you specify them in function_string . The smaller the step, the smoother your graph.
< function_string >
Your function, written in the muParser syntax . The function is applied to the variables and data specified in variable_data . You can only reference the variables declared in this local function set, not in another piped set of chfd parameters. Summary muParser functions are not supported (min, max sum, avg). IMPORTANT: Remember to use %2B instead of + in your functions!

Examples

Описание Пример

A simple sine wave. Some things to notice:

  • chd=t:-1 - We use a dummy variable for the chart data, because our data is declared in the chfd parameter.
  • chco=FF0000 - Red is specified for the first series. Even though we don't use the data from chd , the corresponding color for that series will be used for that plotted function.
  • chfd=0,x,0,11,0.1,sin(x)*50%2B50 - We declare one variable, called x, with values 0—11, incremented by 0.1. It is assigned to the first series, which means it will get the first series color (FF0000). The function applied to x is sin(x) * 50 + 50. Note how we must encode the + in that function.

Sine wave specified by chfd
cht=lc
chd=t:-1
chco=FF0000
chfd=
0,x,0,11,0.1,sin(x)*50%2B50
chxt=x,y
This line uses data from the chd parameter. A function that runs over chd data.
chd=t:5,10
chfd=0,x,0,x*4

A mix of function and non-function lines.

Notice how the colors are specified by the series color parameter chco .

Notice the placement of markers on the function output; the data points are calculated from start , end , and step , so if your range is 0—11 step 0.1, point 0 is 0, point 1 is 0.1 and so on, until point 110, which has a value of 11.

One series using chfd, one using chd for its data.
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

To define a function in two dimensions, use an lxy chart, assign two dummy series, and assign a function to each.

  • 0,x,0,10,0.1,sin(x)*50%2B50 - Series 0 (the x-axis values) has a variable named x, with values from 0—10, step 0.1, and a function sin(x)*50 + 50
  • 0,y,0,10,0.1,sin(y)*50%2B50 - Series 0 (the y-axis values) has a variable named y, with values from 0—10, step 0.1, and a function sin(x)*50 + 50
A circle
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

The chfd parameter can really let you express your creativity.

Try clicking these images to open and play with them in the chart playground; you'll get hooked!



Back to top