В этом документе описаны различные типы гистограмм, которые можно создать с помощью API диаграмм.
Оглавление
Особенности диаграммы
| Стандартные функции
|
Обзор
Вы можете создавать различные гистограммы, включая вертикальные, горизонтальные, сгруппированные, сложенные и перекрывающиеся версии каждой из них.
Гистограммы хороши для параллельного сравнения и выявления тенденций в небольшом количестве дискретных точек данных. Они являются хорошей альтернативой линейным диаграммам, когда у вас есть только несколько точек данных в серии.
Существует три основных способа отображения нескольких рядов на гистограмме:
Сгруппировано | Сложенный | Перекрывается |
cht=bvg | cht=bvs | cht=bvo |
Вы можете контролировать ширину и расстояние между полосами, используя параметр chbh
. Если вы не укажете chbh
, некоторые столбцы могут быть обрезаны.
Обратите внимание, что по умолчанию все серии отображаются одним цветом; если вы не укажете разные цвета для разных рядов, вам будет трудно отличить, что на вашей диаграмме имеется несколько рядов. Подробности см. в разделе «Цвета серии» .
По умолчанию гистограммы отображают хотя бы одну ось; если вы хотите скрыть какие-либо оси по умолчанию, используйте параметр chxs
и укажите подчеркивание для значения <axis_or_tick> .
Если вы используете простой текстовый формат в составных диаграммах, вам следует учитывать, что диаграмма будет обрезать все значения, превышающие 100, как общую высоту стопки , если вы не добавите пользовательское масштабирование, как показано здесь:
Без масштабирования средние три столбца превышают 100 и обрезаются в простой диаграмме данных в текстовом формате . | cht=bhs |
Если мы хотим отобразить полную длину столбца, мы должны либо использовать другую схему кодирования, либо использовать форматирование текста с пользовательским масштабированием . Максимальное значение масштаба должно быть относительно общей высоты сложенных брусков; в этом примере число достигает 160 (максимальное суммарное значение). | cht=bhs |
Типы диаграмм ( cht
)
Вы можете создать несколько различных типов гистограмм. Укажите гистограмму со следующим синтаксисом:
Синтаксис
cht=<chart_type>
Где < chart_type >
— один из следующих типов:
Тип диаграммы | Описание | Пример |
---|---|---|
| Горизонтальная гистограмма с расположенными столбцами. Первый пример (все столбцы темно-синего цвета) содержит один ряд данных. Второй пример (полосы темно- и бледно-голубого цвета) содержит две серии. (Он также масштабируется для отображения суммарного значения столбца, превышающего 100). Как видите, несколько серий объединены друг в друга. Если вы не укажете разные цвета серий , все цвета будут одинаковыми (и столбцы не будут выглядеть сложенными). Вы также можете указать цвет для каждой полосы в одной серии. |
cht=bhs |
| Вертикальная гистограмма с расположенными друг над другом столбцами. Этот пример состоит из двух серий и использует текстовый формат с настраиваемым масштабированием, чтобы гарантировать полную видимость всех сложенных значений. Обратите внимание: если вы переместите нулевую линию на графике | |
bvo | Вертикальная гистограмма, на которой столбцы расположены друг над другом, а не друг над другом. Высота каждого столбца — это его индивидуальное значение, а не суммарное значение. Столбцы будут отсортированы по высоте, чтобы все столбцы были видны. |
|
| Горизонтальные гистограммы с сгруппированными полосами. В верхней диаграмме используются значения интервала между группами по умолчанию; нижняя диаграмма использует параметр chbh для изменения ширины полосы по умолчанию и интервала между группами, чтобы сделать группы более заметными. |
|
| Вертикальная гистограмма с сгруппированными столбцами. |
|
Серия Цвета chco
Вы можете указать цвета отдельных столбцов, отдельных серий или нескольких серий, используя параметр chco
. Если вы не укажете разные цвета для каждой серии, все серии будут одного цвета.
Синтаксис
chco=<series_1_color>, ..., <series_n_color> or chco=<series_1_bar_1>|<series_1_bar_2>|...|<series_1_bar_n>,<series_2>,...,<series_n>
-
<color>
- Шестнадцатеричное число в формате RRGGBB, применяемое к серии или отдельному слитку. Чтобы применить цвет ко всей серии, его следует разделить запятыми. Чтобы применить цвет к отдельной полосе, она должна быть разделена вертикальной чертой. Вы можете смешивать эти два формата. Примеры см. в таблице ниже. Всякий раз, когда у вас меньше значений цвета, чем точек данных или серий, цвета снова будут циклически проходить по списку, начиная с первого цвета в этой группе.
Примеры
Описание | Пример |
---|---|
Один цвет в серии, цвета разделены запятыми. | |
Один цвет на значение, с цветами, разделенными вертикальной чертой. | |
Сочетание цветов серии и цветов отдельных полос. В этом примере показана гистограмма с двумя рядами. Первая серия полностью черная ( | |
В этом примере демонстрируется установка разных цветов для каждого столбца на многорядной диаграмме. | chco= |
Вы также можете указать заливки, чтобы раскрасить серию сплошными, полосатыми или градиентными цветами. Сплошная заливка выглядит так же, как при использовании chco , но полосы или градиенты создают уникальные эффекты. | chd= chd=t: |
Барные Этикетки
Гистограммы поддерживают стандартные метки осей , но метки вдоль основания столбцов назначаются отдельным столбцам, а не распределяются по гистограмме. (Чтобы равномерно распределить метки, используйте параметр chxp
, как описано ниже.) Если вы укажете метки осей, но не укажете пользовательские метки вдоль оси стержня, метками стержней будет порядковый номер каждого стержня или группы стержней. Вы можете настроить метки осей, используя параметр chxl
.
Описание | Пример |
---|---|
Гистограмма с метками оси X по умолчанию. | chxt=x,y |
Гистограмма с использованием пользовательских меток оси X. |
|
Если у вас разное количество меток и полос и вы хотите, чтобы метки располагались равномерно (а не под каждой полосой), используйте параметр
|
|
Ширина и интервал между полосами chbh
При желании вы можете указать собственные значения ширины стержней и расстояния между стержнями и группами. Вы можете указать только один набор значений ширины для всех полос. Если вы не укажете chbh
, все столбцы будут иметь ширину 23 пикселя. Это означает, что конечные столбцы могут быть обрезаны, если общая ширина столбца + пространство шире ширины диаграммы.
Синтаксис
chbh= <bar_width_or_scale>,<space_between_bars>,<space_between_groups>
- < ширина_бара_или_масштаб >
- Ширина планки. Вы можете указать ширину и интервал абсолютно или относительно, введя одно из следующих значений. Значение по умолчанию — 23 пикселя, абсолютное значение.
- ширина — ширина полосы в пикселях. Все значения интервалов также являются абсолютными значениями в пикселях. Столбцы можно обрезать, если диаграмма недостаточно широка.
-
a
– space_between_bars и space_between_groups задаются в абсолютных единицах (или абсолютных значениях по умолчанию, если не указано иное). Размер столбцов будет изменен так, чтобы все столбцы поместились на графике. -
r
— space_between_bars и space_between_groups задаются в относительных единицах (или относительных значениях по умолчанию, если не указано). Относительные единицы — это значения с плавающей запятой по сравнению с шириной полосы, где ширина полосы равна 1,0: например, 0,5 — это половина ширины полосы, 2,0. в два раза больше ширины полосы. Столбцы можно обрезать, если диаграмма недостаточно широка.
- < пробел_между_барами >
- [ Необязательно ] Пространство между столбцами в одной группе. Если размер абсолютный, это ширина в пикселях; если размер относительный, это значение с плавающей запятой, где 1,0 — ширина полосы. Значение по умолчанию — 4 пикселя для абсолютных значений или 4/23 для относительных значений.
- <пространство_между_группами>
- [ Необязательно ] Пространство между группами стержней в одной группе. Если размер абсолютный, это ширина в пикселях; если размер относительный, это значение с плавающей запятой, где 1,0 — ширина полосы. Значение по умолчанию — 8 пикселей для абсолютных значений или 8/23 для относительных значений.
Вы не можете опустить промежуточные необязательные параметры; вы должны закончить с указанным значением. Например: chbh=10,5,10
допустимо, chbh=10,,10
нет, chbh=10,5,
нет.
Описание | Пример |
---|---|
В этой диаграмме используется значение В первой диаграмме не указано расстояние между группами, поэтому группы не видны. На второй диаграмме добавлено некоторое расстояние (15 пикселей) между группами. |
|
В этой диаграмме значение | |
Первая диаграмма содержит пять значений в каждой серии, но диаграмма слишком мала, чтобы вместить все столбцы со значениями по умолчанию: 10*23 пикселя для баров + ...поэтому некоторые полосы обрезаны. На второй диаграмме указаны абсолютные значения столбцов и интервалов, соответствующие всем столбцам диаграммы. |
|
Нулевая линия chp
Вы можете указать собственную нулевую линию для своей диаграммы, используя параметр chp
или используя кодировку текста с масштабированием данных . Эти нулевые линии работают двумя разными способами:
- Масштабирование данных. Когда вы используете данные в текстовом формате с параметром масштабирования
chds
, нулевая линия будет сдвинута настолько вверх, насколько это необходимо, чтобы отобразить все отрицательные значения. - Параметр
chp
. Вы также можете переместить нулевую линию вручную в любом формате данных в любое место, используя параметрchp
. Фактически это создает искусственную нулевую линию и перерисовывает столбцы как разницу между значением данных и произвольным нулевым значением (то есть столбцы рисуются от нулевой линии до значения столбца). Это нельзя использовать в сочетании сchds
.
Синтаксис
chp= <zero_value_series_1>, ..., <zero_value_series_n>
- <zero_value_series_1 >
- Значение с плавающей запятой от 0,0 до 1,0 включительно, где 0,0 — нижняя часть оси, а 1,0 — верхняя часть оси. Столбцы будут перерисованы, чтобы показать разницу между этим значением и его значением.
Описание | Пример |
---|---|
Вот три копии гистограммы с одинаковыми данными:
|
|
В этом примере показана установка нулевой линии с использованием данных в текстовом формате с пользовательским масштабированием ( В примере указаны значения в диапазоне от -60 до 120. Масштаб установлен в пределах от -80 до 140, чтобы оставить пространство над и под полосами. | chd=t:30,-60,50,120,80 |
Составные диаграммы
Вы можете добавить линии, свечи и маркеры фигур в гистограмму, чтобы создать составную диаграмму. Более подробную информацию см. в разделе «Составные диаграммы» .
Маркеры на определенных столбцах (только cht=bvg
)
По умолчанию, когда вы рисуете маркер chm
на сгруппированной вертикальной диаграмме, он рисуется в той же серии, из которой он получает данные. Если данные представляют собой скрытую серию , по умолчанию маркер центрируется на группе столбцов.
Однако с помощью вертикально сгруппированных гистограмм (тип bvg
) вы можете указать серию размещения, отличную от серии данных маркера. Для этого укажите параметр < series_index >
(третий параметр), используя следующий синтаксис: < data_series_index >:< placement_series_index >
.
Обратите внимание: если вы укажете скрытую или несуществующую серию размещения , маркер будет расположен по центру группы по горизонтали.
Лучший способ использовать эту функцию — использовать скрытый ряд для данных маркера и поместить маркер в видимый ряд.
В следующих примерах показано поведение по умолчанию, при котором серии данных и серии размещения совпадают, а также расширенный синтаксис, указывающий разные серии данных и мест размещения.
Скрытые ряды данных, размещение маркера по умолчанию | Скрытые ряды данных, расширенное размещение маркеров |
---|---|
В этом примере базовый синтаксис указывает, что данные маркера и его размещение должны находиться в одной серии. Поскольку это скрытая серия, размещение по умолчанию расположено по центру каждой группы по вертикали. | В этом примере расширенный синтаксис указывает другой источник данных и серию размещения маркеров. Круги используют данные из скрытой серии 2 и размещаются в серии 0; квадраты используют данные из скрытой серии 3 и размещаются в серии 1. |
В следующем примере показано, как добавить несколько разных типов маркеров к отдельным столбцам сгруппированной гистограммы. Обратите внимание, что черный кружок центрируется вокруг групп, поскольку он указывает скрытые серии в качестве серии размещения.
chd=t4: // First four series are rendered as bars. Remaining data is hidden.
5,10,15,20,25,30 // Purple bar
10,20,30,40,50,60 // Blue bar
30,40,50,60,70,80 // Olive bar
5,5,5,5,5,5 // Black bar
0,15,25,30,45,55 // Hidden data: Purple circle, blue error bar start
15,30,40,45,55,65 // Hidden data: Blue error bar end
20,35,45,50,55,65 // Hidden data: Yellow error bar start
40,45,55,80,75,85 // Hidden data: Yellow error bar end
chm= // Markers:
o,D000D0,4:0,,10 // Purple circle: data series 4, placement series 0 (purple)
E,00D0D0,4:1,,1:10 // Blue error bars: data series 4, placement series 1 (blue)
E,D0D000,6:2,,1:10 // Yellow error bars: data series 6, placement series 2 (olive)
o,000000,3:4,,10 // Black circle: data series 3, placement 4 (hidden placement series, centered in group)
Стандартные функции
Остальные функции на этой странице являются стандартными функциями диаграммы изображений.
Описание | Пример |
---|---|
Диаграмма с заголовком, в которой используются цвет и размер шрифта по умолчанию. Укажите пробел со знаком плюс ( Используйте символ вертикальной черты ( | chtt=Site+visitors+by+month| |
Диаграмма с синим заголовком размером 20 пунктов, выровненным по правому краю. | chtt=Site+visitors |
Текст и стиль легенды диаграммы 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
- < опт_позиция >
- [ Необязательно ] Указывает положение легенды на диаграмме. Чтобы указать дополнительное отступы между легендой и областью диаграммы или границей изображения, используйте параметр
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 chdl=First|Second|Third |
На первой диаграмме показаны записи горизонтальной легенды ( | |
В этом примере показано изменение размера шрифта. | |
Поля диаграммы chma
[ Все диаграммы ]
Вы можете указать размер полей диаграммы в пикселях. Поля рассчитываются внутрь от указанного размера диаграммы ( chs
); Увеличение размера поля не увеличивает общий размер диаграммы, а, при необходимости, уменьшает ее область.
Поля по умолчанию — это все, что осталось после расчета размера диаграммы. Это значение по умолчанию зависит от типа диаграммы. Указанные вами поля являются минимальным значением; если в области диаграммы остается место для полей, размер поля будет таким же, как и оставшееся; вы не можете сжимать поля меньше, чем требуется для любых легенд и надписей. Вот диаграмма, показывающая основные части диаграммы:
Поля диаграммы включают метки осей и область легенды . Размер области легенды изменяется автоматически, чтобы точно соответствовать тексту, если вы не укажете большую ширину с помощью Совет: Если в гистограмме столбцы имеют фиксированный размер (по умолчанию), ширину области диаграммы нельзя уменьшить. Вы должны указать меньший или изменяемый размер полосы с помощью |
Синтаксис
chma= <left_margin>,<right_margin>,<top_margin>,<bottom_margin>|<opt_legend_width>,<opt_legend_height>
- < левое_поле >, < правое_поле >, < верхнее_поле >, < нижнее_поле >
- Минимальный размер поля вокруг области диаграммы в пикселях. Увеличьте это значение, чтобы включить некоторые отступы, чтобы метки осей не сталкивались с границами диаграммы.
- <opt_legend_width> , <opt_legend_height>
- [ Необязательно ] Ширина поля вокруг легенды в пикселях. Используйте это, чтобы легенда не сталкивалась с областью диаграммы или краями изображения.
Примеры
Описание | Пример |
---|---|
В этом примере диаграмма имеет минимальное поле в 30 пикселей с каждой стороны. Поскольку ширина легенды диаграммы превышает 30 пикселей, поле справа устанавливается на ширину легенды диаграммы и отличается от других полей. Метки осей находятся за пределами области графика и поэтому рисуются внутри поля. |
|
Чтобы добавить поле вокруг легенды, установите значение для параметров В этом примере ширина легенды составляет примерно 60 пикселей. Если вы установите для |
|
Стили и метки осей [ линия, полоса, Google-o-meter, радар, разброс ]
Вы можете указать, какие оси отображать на диаграмме, и присвоить им собственные метки и позиции, диапазоны и стили.
Не на всех диаграммах по умолчанию отображаются линии осей. Вы можете точно указать, какие оси должна отображать ваша диаграмма, используя параметр chxt
. На линиях оси по умолчанию не отображаются числа; вы должны указать ось в параметре chxt
, чтобы отображать числа.
Вы можете выбрать, чтобы на ваших осях отображались числа, отражающие значения данных, или вы можете указать собственные оси. По умолчанию отображаются числовые значения в диапазоне от 0 до 100. Однако вы можете изменить этот диапазон с помощью chxr
для отображения любого диапазона, а также стилизовать значения (например, для отображения символов валюты или десятичных знаков) с помощью chxs
.
Если вы решите использовать пользовательские значения, например: «Пн, вторник, среда», вы можете использовать параметр chxl
. Чтобы разместить эти метки в определенных местах вдоль оси, используйте параметр chxp
.
Наконец, вы можете использовать параметры chxs
и chxtc
для указания цвета, размера, выравнивания и других свойств как пользовательских, так и числовых меток осей.
Примечание о строковых значениях: в строках меток разрешены только символы, безопасные для URL. В целях безопасности вам следует закодировать URL-адресом все строки, содержащие символы, не входящие в набор символов 0-9a-zA-Z
. Кодировщик URL-адресов можно найти в документации по визуализации Google .
В этом разделе рассматриваются следующие темы:
- Видимые оси (
chxt
) — какие оси отображать. - Диапазон оси (
chxr
) — диапазон значений для каждой оси. - Пользовательские метки осей (
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 для всех осей. Обратите внимание, что по умолчанию верхняя и нижняя оси не имеют меток рядом с метками. |
|
Вы можете включить несколько наборов меток для каждой оси, включив одно и то же значение несколько раз. В этом примере показаны два набора осей X и два набора осей Y. Это не особенно полезно при использовании только меток осей по умолчанию, как показано здесь. Но вы можете указать собственные метки для каждой копии каждой оси, используя параметр chxl . | chxt=x,x,y,y chxt=x,x,y,y |
В этом примере показана горизонтальная гистограмма с осью X, осью Y, верхней осью T и правой осью R. Метки осей опущены, поэтому API диаграмм отображает диапазон от 0 до 100 для оси X и для оси T. Диапазон по оси Y и по оси R определяется количеством столбцов. В данном случае имеется пять столбцов, поэтому API диаграмм отображает диапазон от 0 до 4. Первая метка располагается по центру основания первого столбца, вторая метка — по центру основания второго столбца и т. д. . |
|
Вы можете отключить оси по умолчанию в линейной диаграмме, указав :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
. - < начальное_значение >
- Число, определяющее нижнее значение для этой оси.
- < конечное_значение >
- Число, определяющее максимальное значение для этой оси.
- <opt_step>
- [ Необязательно ] Шаг отсчета между делениями на оси. Не существует значения шага по умолчанию; шаг рассчитан так, чтобы попытаться показать набор хорошо расположенных меток.
Примеры
Описание | Пример |
---|---|
В этом примере показаны левая и правая оси Y ( Каждая ось имеет определенный диапазон. Поскольку метки или позиции не указаны, значения берутся из заданного диапазона и равномерно распределяются внутри этого диапазона. На линейном графике значения равномерно распределены по оси X. Направление оси меняется на противоположное для оси r (индекс |
|
В этом примере значения указаны для оси X. Метки осей равномерно расположены вдоль оси. Для параметра <opt_step> указано значение пять ( | |
Пользовательские метки осей 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. - <babel_1> | ... | <babel_n>
- Одна или несколько ярлыков, чтобы поместить вдоль этой оси. Это могут быть значения строки или числа; Строки не должны быть в цитатах. Label_1 отображается в самом низком положении на оси, а Label_n отображается в самом высоком положении. Дополнительные этикетки распределены равномерно между ними. Укажите места с отметкой +. Невозможно указать линейный разрыв на этикетке. Отдельные этикетки с характером трубы. ПРИМЕЧАНИЕ. Не размещайте трубу после окончательной метки в параметре
chxl
.
Примеры
Описание | Пример |
---|---|
На этой диаграмме показано, как добавить пользовательские метки к двум осям. Обратите внимание, как значения равномерно распределены, и как последнее значение | chxt=x,y |
Этот пример включает в себя метки оси слева и правые оси Y ( |
|
Этот пример включает в себя метки оси слева и правые оси Y ( В этом примере используются значения по умолчанию для меток оси на левой оси Y. |
|
Если вы хотите добавить общую метку для описания целой оси (например, чтобы пометить одну ось «стоимость» и другую «Студент»), используйте свойство | chxt=x,x,y,y |
Метка оси chxp
Вы можете указать, какие этикетки оси следует отображать, будь то использование меток по умолчанию или пользовательские метки, указанные с использованием chxl
. Если вы не указали точные позиции, используя этот параметр, этикетки будут разнесены равномерно и при значении шага по умолчанию вдоль осей. Если вы не указываете chxl
, то этикетками марки TATE будут значениями по умолчанию (обычно значения данных или номера полос в стержнях).
Синтаксис
Разделите несколько наборов позиционирования, используя символ трубы ( |
).
chxp= <axis_1_index>,<label_1_position>,...,<label_n_position> |...| <axis_m_index>,<label_1_position>,...,<label_n_position>
- <axis_index>
- Ось, для которой вы указываете позиции. Это индекс в массиве параметров
chxt
. Например, если у вас естьchxt=x,x,y,y
то индекс 0 был бы первой осью x, 1 будет второй оси x и так далее. - <label_1_position> , ..., <label_n_position>
- Положение метки вдоль оси. Это разделенный запятой список числовых значений, где каждое значение устанавливает положение соответствующей метки в массиве
chxl
: первая запись применяется к первой метке и т. Д. Положение является значением в диапазоне для этой оси . Обратите внимание, что это всегда будет 0—100, если вы не указали пользовательский диапазон с использованиемchxr
. У вас должно быть столько позиций, сколько у вас есть этикетки для этой оси.
Примеры
Описание | Пример |
---|---|
Этот пример включает в себя метки оси R в указанных позициях на графике. Текст метки указан с использованием параметра Метки с указанным положением Метки с указанным положением | |
Этот пример демонстрирует показ значений метки по умолчанию, но только в указанных местах. |
chxt=x,y 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>
- <axis_index>
- Ось, к которой это применяется. Это индекс на основе нуля в параметр
chxt
. - <pt_format_string>
- [ Необязательно ] Это необязательная строка формата, которая, если она используется, следует сразу после номера индекса оси без промежуточной запятой. Это начинается с буквальной буквы 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
-display данные из x- или y-координата, как указано. Значение X данных варьируется в зависимости от типа диаграммы: экспериментируйте с вашей диаграммой, чтобы определить, что это значит. По умолчанию «y» .
-
-
< following_text >
- буквальный текст, чтобы следовать каждому значению.
-
- <pt_label_color>
- Цвет, чтобы применить к тексту оси (но не линии оси), в шестнадцатеричном формате rrggbb . Цвет линии оси определяется отдельно с использованием opt_axis_color . По умолчанию серый.
- <pt_font_size>
- [ Необязательно ] указывает размер шрифта в пикселях. Этот параметр является необязательным.
- <pt_alenment>
- [ Необязательно ] Выравнивание метки. Для верхних или нижних оси описывается, как этикетка выравнивается с меткой выше или под ним; Для левых или правых оси описывается, как выравнивается внутри его ограничивающей коробки, которая касается оси. Укажите одно из следующих чисел:
-
-1
- Вверху или внизу : этикетки справа от клещей; Влево или вправо : этикетки в их районе выравниваются. По умолчанию для меток оси R. -
0
- сверху или внизу : этикетки центрируются на клещах; Влево или вправо : этикетки сосредоточены в их районе. По умолчанию для метки оси X и T. -
1
- Вверху или снизу : этикетки слева от клещей; Влево или вправо : этикетки выровнены правой стороны в их районе. По умолчанию для ярлыков оси Y.
-
- <pt_axis_or_tick>
- [ Необязательный; Не поддерживается в Google-O-Meter ], следует ли показывать отметки и/или линии оси для этой оси. Знаки клещей и линии оси доступны только для внутренних оси (например, они не поддерживаются для внешней части двух оси X). Используйте одно из следующих значений:
-
l
(нижний регистр 'l') - только линия оси нарисуйте. -
t
- нарисуйте только отметки. Знаки клещей - это маленькие линии рядом с этикетками Axis. -
lt
- [ по умолчанию ] Нарисуйте как линию оси, так и метки для всех лейблов. -
_
- (подчеркивается) Нарисуйте ни линии оси, ни метки. Если вы хотите скрыть линию оси, используйте это значение.
-
- <icke_color>
- [ Необязательный ; Не поддерживается в Google-O-Meter ] Цвет отметок в шестнадцатеричном формате RRGGBB . По умолчанию серый.
- <pt_axis_color>
- [ Необязательно ] Цвет этой линии оси, в шестнадцатеричном формате rrggbb . По умолчанию серый.
Примеры
Описание | Пример |
---|---|
Размер и цвет шрифта указаны для второй оси X (январь, февраль, март). | |
Размер шрифта, цвет и выравнивание указаны для правой оси Y. Знаки клещей, но без оси, нарисованы. | |
Эта диаграмма включает в себя три набора данных и показывает три набора меток оси, по одному на серию. Каждый набор меток форматируется с использованием пользовательской строки форматирования, как описано здесь:
Диапазоны метки оси устанавливаются с использованием параметра | chd=s: |
Axis Tick Mark Styles chxtc
Вы можете указать длинные отметки для определенных осей. Как правило, это используется для расширения отметки клещей по всей длине диаграммы. Используйте параметр chxs
чтобы изменить цвет отметки.
Значения для нескольких осей должны быть разделены с использованием символа трубы ( |
). Значения в серии должны быть разделены запятой.
Синтаксис
chxtc= <axis_index_1>,<tick_length_1>,...,<tick_length_n> |...| <axis_index_m>,<tick_length_1>,...,<tick_length_n>
- <axis_index>
- Ось, к которой это применяется. Это индекс на основе нуля в параметр
chxt
. Отдельные значения для разных осей с использованием брусного разделителя. - <icke_length_1> , ..., <tick_length_n>
- Длина отметок на этой оси, в пикселях. Если дано одно значение, оно будет применяться ко всем значениям; Если дано более одного значения, отметки оси пройдут через список значений для этой оси. Положительные значения вытягиваются за пределами области графика и обрезаны границами диаграммы. Максимальное положительное значение составляет 25. Отрицательные значения проводятся внутри площади графика и обрезаны границами диаграммы.
Примеры
Описание | Пример |
---|---|
Пример использования
| |
Эта диаграмма демонстрирует чередующуюся длину клещей. chxtc указывает два значения длины клещей для оси Y (5 и 15), а клещи, нарисованные на диаграмме, чередуются между двумя значениями. | chxt=x,y |
Фон заполняет chf
[ все диаграммы ]
Вы можете указать цвета заполнения и стили для области данных диаграммы и/или всего фона диаграммы. Типы заполнения включают в себя сплошные заполнения, полосатые наполнения и градиенты. Вы можете указать разные заливки для разных областей (например, вся область диаграммы или только область данных). Область диаграммы заполняет перезапись фоновой заполнения. Все заполнения указываются с использованием параметра chf
, и вы можете смешивать различные типы заполнения (твердые вещества, полосы, градиенты) в одной и той же диаграмме, разделяя значения с символом трубы (|). Область диаграммы заполняет перезапись фона карты.
Solid Fills chf
[ все диаграммы ]
Вы можете указать твердую заполнение для фона и/или области диаграммы или присвоить значение прозрачности на всю диаграмму. Вы можете указать несколько заполнений, используя символ трубы ( |
). (Карты: только фон).
Синтаксис
chf=<fill_type>,s,<color>|...
- <illy_type>
- Часть графика заполнена. Укажите одно из следующих значений:
-
bg
- фоновая заполнение -
c
- заполнение области диаграммы. Не поддерживается для карт карт. -
a
- Сделайте всю диаграмму (включая фон) прозрачной. Первые шесть цифр< color >
игнорируются, и только последние два (значение прозрачности) применяются ко всей диаграмме и все заполнения. -
b <index>
- сплошные наполнения (только сплоченные диаграммы). Замените <Index> на индекс серии стержней, чтобы заполнить сплошным цветом. Эффект аналогичен указаниюchco
в батонной диаграмме. См. Цвета серии барных карт для примера.
-
- с
- Указывает твердое или прозрачность заполнения.
- < цвет >
- Цвет заполнения в шестнадцатеричном формате Rrggbb . Для прозрачных пленок первые шесть цифр игнорируются, но все равно должны быть включены.
Примеры
Описание | Пример |
---|---|
Этот пример заполняет фон диаграммы бледно -серым ( | |
Этот пример заполняет фон диаграммы бледно -серым ( | |
Этот пример применяет 50% прозрачность ко всему графику (80 в шестнадцатеричном составляет 128, или около 50% прозрачности). Обратите внимание на фон таблицы ячейки, показывающий через диаграмму. | |
Градиент заполняет chf
[ Line, Bar, Google-O-Meter, Radar, Scatter, Venn ]
Вы можете применить одну или несколько градиентных заполнений для диаграммы областей или фонов. Градиентные заливки исчезают от одного цвета к другому цвету. (Пирог, диаграммы Google-O-Meter: только фон.)
Каждое градиентное заполнение указывает угол, а затем два или более цветов, закрепленных на указанном месте. Цвет варьируется, когда он перемещается от одного якоря к другому. У вас должно быть как минимум два цвета с разными значениями <lore_centerpoint> , чтобы один мог исчезнуть в другом. Каждый дополнительный градиент определяется парой <color> , <lolor_centerpoint> .
Синтаксис
chf=<fill_type>,lg,<angle>,<color_1>,<color_centerpoint_1> ,..., <color_n>,<color_centerpoint_n>
- <illy_type>
- Площадь графика для заполнения. Одно из следующих:
-
bg
- фоновая заполнение -
c
- заполнение области диаграммы. -
b <index>
- заполнение градиента стержня (только барные диаграммы). Замените <Index> на индекс серии стержней, чтобы заполнить градиентом. См. Цвета серии барных карт для примера.
-
- LG
- Определяет градиент.
- < угла >
- Число, указывающее угол градиента от 0 (горизонтальный) до 90 (по вертикали).
- < цвет >
- Цвет заполнения, в шестнадцатеричном формате rrggbb .
- <color_centerpoint>
- Указывает точку привязки для цвета. Цвет начнет исчезать с этого момента, когда он приближается к другому якорь. Диапазон значений составляет от 0,0 (нижний или левый край) до 1,0 (верхний или правый край), наклонен под углом, указанным под углом >.
Примеры
Описание | Пример |
---|---|
Площадь диаграммы имеет горизонтальный линейный градиент, указанный под углом нулевой градусы ( Цвета представляют собой персик ( Фон диаграммы нарисован в сером ( | |
Площадь диаграммы имеет диагональный (нижний левый к верхнему справа) линейный градиент, указанный под углом сорок пять градусов ( PEACH ( Синий ( Фон диаграммы нарисован в сером ( | |
Площадь диаграммы имеет вертикальный (сверху вниз) линейный градиент, указанный под углом девяносто градусов ( Blue ( Peach ( Фон диаграммы нарисован в сером ( | |
Полосы заполняют chf
[ Line, Bar, Google-O-Meter, Radar, Scatter, Venn ]
Вы можете указать полосатую фоновую заполнение для области диаграммы или всю диаграмму. (Пирог, диаграммы Google-O-Meter: только фон.)
Синтаксис
chf= <fill_type>,ls,<angle>,<color_1>,<width_1> ,..., <color_n>,<width_n>
- <illy_type>
- Площадь графика для заполнения. Одно из следующих:
-
bg
- фоновая заполнение -
c
- заполнение зоны диаграммы -
b <index>
- полосатые наполнения (только сплоченные диаграммы). Замените <Index> на индекс серии стержней, чтобы заполнить полосами. См. Цвета серии барных карт для примера.
-
- лауреат
- Определяет линейную полосовую заполнение.
- < угла >
- Угол всех полос относительно оси Y. Используйте
0
для вертикальных полос или90
для горизонтальных полос. - < цвет >
- Цвет для этой полосы, в шестнадцатеричном формате rrggbb . Повторите < цвет > и < ширина > для каждой дополнительной полосы. У вас должно быть как минимум две полосы. Полосы чередуются до тех пор, пока диаграмма не будет заполнена.
- < ширина >
- Ширина этой полосы, от
0
до1
, где1
- полная ширина диаграммы. Полосы повторяются до тех пор, пока диаграмма не будет заполнена. Повторите < цвет > и < ширина > для каждой дополнительной полосы. У вас должно быть как минимум две полосы. Полосы чередуются до тех пор, пока диаграмма не будет заполнена.
Примеры
Описание | Пример |
---|---|
| chf= |
| chf= |
Линия заполняет chm
[ Line, Radar ]
Вы можете заполнить область ниже линии данных с твердым цветом.
Вы можете объединить линейные заполнения с любыми другими параметрами chm
используя символ трубы ( |
), чтобы разделить параметры chm
.
Синтаксис
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>
- Должно ли заполнять дно диаграммы или только к следующей нижней линии.
- B - Заполните из
< start_line_index >
до нижней части диаграммы.< end_line_index >
поддерживает специальный синтаксис, чтобы позволить вам заполнить сегмент диаграммы. Это проще всего, если у вас есть таблица с одной линией, которую вы хотите заполнить. - B - Заполните между двумя линиями в многострочной диаграмме. Начальные и конечные строки указаны
< start_line_index >
и< end_line_index >
.
- B - Заполните из
- < цвет >
- Шестнадцатеричный номер формата rrggBB .
- <start_line_index>
- Индекс линии, с которой начинается заполнение. Первая серия данных, указанная в
chd
имеет индекс нулевого (0
), вторая серия данных имеет индекс1
и т. Д. - <end_line_index>
- Заполните тип 'B' - линия, на которой можно остановить заполнение. Эта линия должна быть ниже текущей линии.
- Заполните тип 'B' - один из следующих вариантов:
- Любое значение - любое единственное число в этом параметре игнорируется, и заполнение будет перенесено от указанной строки к основанию диаграммы
- Начало: End - Чтобы заполнить вертикальный срез под диаграммой, укажите начало: end , где это индексы точек данных, описывающие, с чего запустить и остановить заполнение. Оба значения не являются необязательными, и по умолчанию First_point : last_point . (См. Пример ниже.)
- <0>
- Зарезервировано - должно быть ноль.
Примеры
Описание | Пример |
---|---|
Для одной серии проще использовать Это единственный тип области заполнения, доступный для радиолокационных диаграмм. |
|
Вот диаграмма с двумя линиями и двумя заполнениями. Заполнение области под нижней линией и над верхней линией требует специальной техники, охваченной дальше. |
|
В многослойной диаграмме, чтобы заполнить из верхней части диаграммы к первой строке, включают серию, которая содержит две копии наивысшего значения данных для формата данных. Так, например, « Чтобы заполнить из последней строки до нижней части диаграммы, включите серию, которая содержит две копии самого низкого значения данных для формата данных. Так, например, AAAA для расширенного кодирования, 0,0 для основного текстового формата и так далее. Сами линии нарисованы в черном, используя | chd=e: (самое высокое значение) (нулевое значение)chm= (светло-синий)b,224499,1,2,0| (синий)b,FF0000,2,3,0| (красный)b,80C65A,3,4,0 (зеленый)chco=000000 |
Вот линейная диаграмма с вертикальными ломтиками заполнения. Это достигается путем указания начала : конец пары для <end_line_index> с линейным типом 'b'.
| chm= |
В этом примере показано использование линии на радиолокационной таблице. | chm= |
Сетка линии chg
[ Line, Bar, Radar, Scatter ]
Вы можете указать твердые или пунктирные линии сетки на вашей диаграмме, используя параметр chg
.
Этот параметр не позволяет вам указать толщину или цвет линий. Для получения дополнительных способов создания линий через вашу диаграмму см. Маркеры формы ( chm
Type H, H, V или V), маркеры диапазона ( chm
) и метки оси ( chxtc
).
Синтаксис
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>
- Используется для расчета, сколько линий сетки X или Y следует показать на графике. 100 / step_size = сколько линий сетки на графике. Итак: 20,25 будет означать 5 линий вертикальной сетки и 4 горизонтальных линии сетки.
- <pt_dash_length> , <pt_space_length>
- [ Необязательно ] Используется для определения пунктирных линий сетки. Первый параметр - это длина каждой черты линии, в пикселях. Второй параметр - это расстояние между тире, в пикселях. Укажите 0 для <pt_space_length> для сплошной линии. Значения по умолчанию 4,1.
- <pt_x_offset> , <pt_y_offset>
- [ Необязательно ] Количество единиц, согласно шкале диаграмм, чтобы компенсировать линии сетки X и Y, соответственно. Может быть положительные или отрицательные значения. Если вы указали это значение, вы также должны указать все предыдущие значения. Значения по умолчанию 0,0.
Примеры
Описание | Пример |
---|---|
Эти примеры используют только параметры | chg=20,50 chg=20,50 |
В этом примере используются более крупные пространства для отображения более легких линий сетки ( |
|
Чтобы отобразить твердую сетку, укажите Zero ( Эта диаграмма также определяет смещение оси X 10. | chg=20,50,1,0,10 |
Эта диаграмма демонстрирует смещение оси x 10, а ось AY-смещение 20. | chg=20,50,3,3,10,20 |
Динамические маркеры значков chem
, линия, радар, рассеяние ]
Создайте свою диаграмму и укажите один или несколько динамических значков в виде значений химии. Синтаксис chem
следующим образом. Все полуколонные предметы в Purple являются необязательными, и любой может быть полностью опущен в вашем URL. Вы можете включить несколько маркеров, включив несколько синтаксических струн, разграниченных | характер. Вы можете прочитать больше о динамических значках на странице динамических значков .
Вы также можете встроить диаграмму в другую диаграмму в качестве динамического значка. Смотрите подраздел встроенных диаграмм ниже.
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>
- Константа строкового маркера для динамического значка, со страницы динамического значка . Эта константа почти такая же, как у
chst
параметр для отдельно стоящих значков. Но где автономная строка значка начинается с «D_», вы должны удалить этот префикс, чтобы получить эквивалентный маркер динамического значка. Пример: отдельно стоящий значок:d_bubble_icon_text_small
; Эквивалентный динамический значок Маркер:bubble_icon_text_small
. - d = <marker_data_string>
- Данные, необходимые для этого конкретного типа маркера. Это содержит ту же строку, которая будет использоваться в параметре
chld
для эквивалентного отдельно стоящего значка, за исключением того, что все | Разделители должны быть заменены запятыми (не забудьте использовать запятые вместо маркеров труб для многослойного текста!). Обратите внимание, что в строке данных вы также должны избежать следующих символов с помощью @ mark: pipe (|), at ( @), equals (=), comma (,), semicolon (;). Примеры:hello@,+world
,5@@10+cents+each
. - ds = <what_series>
- [ Необязательно ] Индекс серии данных на основе нуля, к которому принадлежит этот маркер. Значение по умолчанию 0.
- dp = <what_points>
- [ Необязательно ] указывает, какие точки данных используются для рисования маркеров. Значение по умолчанию составляет 0 (первая точка в серии) . Используйте один из следующих форматов:
-
nd
- какие данные указывают на нарисование маркера, где ND является индексом на основе нуля в серии. Если вы укажете нецелое значение, то дробь указывает на рассчитанную промежуточную точку. Например, 3,5 означает середину между точкой 3 и точкой 4. -
range,< start >,< end >,< step >
- Нарисуйте маркер на каждой шаге точки данных в диапазоне от начала до конца , включительно. Начало и конец являются значениями индекса, и могут быть числа плавающей запятой, чтобы указать промежуточные значения. Все значения необязательны; по умолчанию: start = 0, end = последний элемент, step = 1. Если вы пропустите ценность, вы все равно должны включать промежуточные запятые, но вам не нужно включать пустые запятые в сцеплении. Примеры:dp=range,0,4
рисует маркер по элементам от 0 до 4;dp=range,5,10,2
рисует маркер по элементам 5, 7 и 9;dp=range,2
рисует точки на третьей точке, а затем;dp=range,3,,1.5
рисует маркеры на каждые 1,5 точки данных от четвертого элемента до последнего. -
all
- нарисуйте маркер на каждом элементе. Это эквивалентноrange,0, end_index
. Пример:dp=all
-
every,n
- нарисуйте маркер на каждом маркере . Пример:dp=every,2
рисует маркер на элементах 0, 2 и 4.
-
- py = <z_order>
- [ Необязательно ] Слой, на котором будет рисоваться маркер, по сравнению с другими маркерами и всеми остальными элементами диаграммы. Это число с плавающей запятой от -1,0 до 1,0 включительно, где -1,0 — низ, а 1,0 — верх. Элементы диаграммы (линии и стержни) чуть ниже нуля. Если два маркера имеют одинаковое значение, они отображаются в порядке, заданном URL-адресом. Значение по умолчанию — 0,0 (чуть выше элементов диаграммы).
- po = < x, y >
- [ Необязательно ] абсолютная позиция на графике, на которой можно нарисовать маркер. x и y - два номера с плавающей запятой, где 0,0,0,0 - нижний левый угол, а 1,0,1,0 - верхний правый угол.
- of = < x_offset, y_offset >
- [ Необязательно ] ряд пикселей, чтобы компенсировать значок из его нормального положения. X_OFFSET и Y_OFFSET являются положительными или отрицательными целыми числами. Важно указать это значение во встроенном динамическом значке, потому что маркер будет центрироваться по вертикали и горизонтально над точкой, что означает, что точка, вероятно, не будет соответствовать маркеру данных. Хорошее смещение для вертикального штифта
of=0,22
; Хорошее смещение для наклонного штифта составляет либоof=-12,20
илиof=12,20
в зависимости от направления уклона, но вам, возможно, придется экспериментировать. Значение по умолчанию составляет 0,0.
Примеры
Описание | Пример |
---|---|
Вот примеры того же динамического значка, созданного в качестве отдельно стоящего изображения, и используется в качестве маркера на линейной диаграмме. Диаграмма 1: Диаграмма 2: |
|
Обратите внимание, что динамический маркер значков будет сосредоточен на точке горизонтально и вертикально. Поэтому, если вы используете динамический значок с хвостом, хвост не будет на графике; Маркерный центр будет. Первый график сосредоточен на знаке на точке данных 3, которая фактически ставит хвост немного справа от отметки на линии. Вторая диаграмма использует | chem=y;
chem=y; |
To include multiple dynamic icons, repeat the syntax string, delimited by a | характер. 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= |
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; |
Встроенные диаграммы
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:
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):
Синтаксис
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:
- 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 .
- прокладка
- [ 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
. - Цвет заливки
- [ 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:
Заменять | С этим |
---|---|
%7C or %7c | | |
@ | @@ |
% | %25 |
, | @, |
| | @| |
; | @; |
& | %26 |
"=" | %3D |
2. Then replace all the &
and =
values in the parameter1=value1¶meter2=value2...
pairs with commas.
Маркеры формы chm
[ Пистолет, Линия, Радар, Разброс ]
Вы можете указать графические маркеры для всех или отдельных точек данных на диаграмме. Если два или более маркера занимают одну и ту же точку, маркеры рисуются в том порядке, в котором они указаны в параметре chm
. Вы также можете создавать текстовые маркеры для точек данных, которые описаны в разделе «Маркеры точек данных» .
Вы можете комбинировать маркеры формы с любыми другими параметрами chm
, используя символ вертикальной черты ( |
) для разделения параметров chm
.
Синтаксис
Укажите один набор следующих параметров для каждой серии, которую необходимо пометить. Чтобы отметить несколько серий, создайте дополнительные наборы параметров, разделенные вертикальной чертой. Вам не нужно размечать все серии. Если вы не назначите маркеры ряду данных, он не получит никаких маркеров.
Маркеры формы ведут себя несколько иначе на точечных диаграммах . Дополнительную информацию см. в этой документации.
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>
- @
- [ Необязательно ] Если перед типом маркера стоит необязательный символ @, то < opt_what_points > должен использовать формат x:y .
- <тип_маркера>
- Тип используемого маркера. Укажите один из следующих типов:
-
a
- Стрелка -
c
- Крест -
C
– Прямоугольник. Если это прямоугольный маркер, у вас должно быть как минимум две серии данных, где серия 0 указывает нижний край, а серия 1 — верхний край. < размер > определяет ширину прямоугольника в пикселях. -
d
- Алмаз -
E
- Маркер полосы ошибок ( ) Для создания этого маркера требуется два ряда данных: одно значение для нижнего уровня и соответствующая точка во втором ряду для верхнего. Он также предоставляет расширенный синтаксис <size> : line_thickness [: top_and_bottom_width ], где top_and_bottom_width является необязательным. См. примеры ниже. -
h
— горизонтальная линия на диаграмме на указанной высоте. ( Единственный допустимый формат для параметра <opt_that_points> — nd . ) -
H
— Горизонтальная линия, проходящая через указанный маркер данных. Поддерживается расширенный синтаксис <size> , который позволяет указать точную длину линии: line_thickness [: length ] где : length не является обязательным и по умолчанию соответствует полной ширине области диаграммы. -
o
- Круг -
s
- Квадрат -
v
— Вертикальная линия от оси X до точки данных. -
V
– Вертикальная линия регулируемой длины. Это поддерживает расширенный синтаксис значения <size> , который позволяет указать точную длину линии: line_thickness [: length ] где : length не является обязательным и по умолчанию соответствует полной высоте области диаграммы. Маркер располагается в центре точки данных. -
x
- Ан Х
-
- < цвет >
- Цвет маркеров для этой серии в шестнадцатеричном формате RRGGBB .
- < индекс_серии >
- Отсчитываемый от нуля индекс ряда данных, на котором будут рисоваться маркеры. Игнорируется для маркеров
h
и маркеров, которые указывают местоположение по положению x/y (начинаются с символа @). Вы можете использовать скрытые ряды данных в качестве источника маркеров; дополнительную информацию см. в разделе «Составные диаграммы» . Сгруппированные вертикальные гистограммы поддерживают специальный расширенный синтаксис для выравнивания маркеров по определенным столбцам. - < opt_what_points >
- [ Необязательно ] На каких точках рисовать маркеры. По умолчанию — все маркеры. Используйте одно из следующих значений:
-
nd
— Где нарисовать маркер. Значение зависит от типа маркера:- Все типы, кроме h — на какой точке данных рисовать маркер, где nd — это индекс в серии, отсчитываемый от нуля. Если вы укажете нецелое значение, то дробь указывает на рассчитанную промежуточную точку. Например, 3,5 означает середину между точкой 3 и точкой 4.
-
h
— число от 0,0 до 1,0, где 0,0 — низ диаграммы, а 1,0 — верх диаграммы.
-
-1
— Нарисуйте маркер на всех точках данных. Вы также можете оставить этот параметр пустым, чтобы использовать все точки данных. -
- n
- Нарисовать маркер на каждой n -й точке данных. Значение с плавающей запятой; если n меньше 1, график рассчитает для вас дополнительные промежуточные точки. Например, при значении -0,5 маркеров будет в два раза больше, чем точек данных. -
start:end:n
— рисует маркер на каждой n -й точке данных в диапазоне, от начального до конечного значения индекса включительно. Все параметры являются необязательными (могут отсутствовать), поэтому 3::1 будет от четвертого элемента до последнего, шаг 1, а полный пропуск этого параметра по умолчанию будет равен first : last :1. Все значения могут быть числами с плавающей запятой. начало и конец могут быть отрицательными, чтобы вести отсчет в обратном направлении от последнего значения. Если и начало , и конец отрицательны, убедитесь, что они указаны в возрастающем значении (например, -6:-1:1). Если значение шага n меньше 1, дополнительные точки данных будут рассчитаны путем интерполяции заданных значений данных. Значения по умолчанию: первый:последний:1. -
x : y
— Нарисуйте маркер в определенной точке x/y на графике. Эта точка не обязательно должна находиться на прямой. Чтобы использовать эту опцию, добавьте символ @ перед типом маркера. Укажите координаты в виде значений с плавающей запятой, где0:0
— левый нижний угол диаграммы, а1:1
— правый верхний угол диаграммы. Например, чтобы добавить красный ромб размером 15 пикселей в центр диаграммы, используйте@d,FF0000,0,0.5:0.5,15
.
-
- < размер >
- Размер маркера в пикселях. Большинство из них принимают для этого параметра одно числовое значение; Маркеры V, H и S поддерживают синтаксис < size >[: width ], где необязательная вторая часть указывает длину строки или маркера.
- < opt_z_order >
- [ Необязательно ] Слой, на котором будет рисоваться маркер, по сравнению с другими маркерами и всеми остальными элементами диаграммы. Это число с плавающей запятой от -1,0 до 1,0 включительно, где -1,0 — низ, а 1,0 — верх. Элементы диаграммы (линии и столбцы) чуть ниже нуля. Если два маркера имеют одинаковое значение, они отображаются в порядке, заданном URL-адресом. Значение по умолчанию — 0,0 (чуть выше элементов диаграммы).
- <opt_offset>
- [ Необязательно ] Позволяет указать горизонтальное и вертикальное смещение от указанного местоположения. Вот синтаксис, в котором используется : разделитель:
reserved :< horizontal_offset >:< vertical_offset >
. Если указано, вы можете включить пустое значение в строку параметраchm
для <opt_z_order> . Примеры:o,FF9900,0,4,12,, :10 o,FF9900,0,4,12.0,, :-10:20 o,FF9900,0,4,12,1, ::20
- зарезервировано – оставьте пустым.
-
< horizontal_offset >
— положительное или отрицательное число, определяющее горизонтальное смещение в пикселях. Необязательный; оставьте пустым, если не используется. -
< vertical_offset >
— положительное или отрицательное число, определяющее вертикальное смещение в пикселях. Необязательный; оставьте пустым, если не используется.
Примеры
Описание | Пример |
---|---|
Вот пример нескольких маркеров формы и линий.
| chm= |
Вот пример использования ромбов для одного ряда данных и кружков для другого ряда данных. Если два или более маркера занимают одну и ту же точку, маркеры рисуются в том порядке, в котором они указаны в параметре | chm= |
Вот линейный график с маркером на каждой второй точке данных (-2 означает каждую вторую точку). | chd=t: |
Вот линейный график, на котором маркеров в два раза больше, чем точек данных (-0,5 означает каждую половину точки). | chd=t: |
В этом примере показано, как использовать маркеры h и v для создания линий сетки произвольного цвета и толщины. Значение z-порядка (последнее значение) устанавливается равным -1, чтобы линии сетки рисовались под линией данных. | chm= |
На этой диаграмме к линейному графику добавляются вертикальные линии заливки:
| chm= |
В этом примере на диаграмму добавляется стрелка и текстовый маркер с использованием точных координат. Первый маркер D — это линия трассировки под столбиками. Второй маркер — это стрелка, а третий маркер — текст стрелки. | chm= |
Горизонтальная линия, привязанная к определенной точке данных ( H ), может быть полезна для отображения относительных значений или выделения высоты значения данных на диаграмме. | chm=H,FF0000,0,18,1 |
На этом графике показаны маркеры, которые могут указывать толщину и длину линии в параметре <size> .
| title="cht=lc&chd=s:2gounjqLaCf,jqLaCf2goun&chco=008000,00008033&chls=2.0,4.0,1.0&chs=250x150&chm=H,990066,1,2,5:50%7CV,3399CC,0,8,3:50% 7CE,000000,0,6,1:20" src="/chart/image/images/chart_95.png" />chm= |
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 .
Синтаксис
Укажите один набор следующих параметров для каждой серии, которую необходимо пометить. Чтобы отметить несколько серий, создайте дополнительные наборы параметров, разделенные вертикальной чертой. Вам не нужно размечать все серии. Если вы не назначите маркеры ряду данных, он не получит никаких маркеров.
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>
- <тип_маркера>
- Тип используемого маркера. 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 thechds
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 ofchds
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
ory
-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.
-
-
- < цвет >
- The color of the markers for this set, in RRGGBB hexadecimal format .
- < индекс_серии >
- Отсчитываемый от нуля индекс ряда данных, на котором будут рисоваться маркеры. 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_what_points >
- [ Необязательно ] На каких точках рисовать маркеры. По умолчанию — все маркеры. Используйте одно из следующих значений:
-
nd
- Which data point to draw the marker on, where nd is the zero-based index in the series. Если вы укажете нецелое значение, то дробь указывает на рассчитанную промежуточную точку. Например, 3,5 означает середину между точкой 3 и точкой 4. -
-1
— Нарисуйте маркер на всех точках данных. Вы также можете оставить этот параметр пустым, чтобы использовать все точки данных. -
-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. Все параметры являются необязательными (могут отсутствовать), поэтому 3::1 будет от четвертого элемента до последнего, шаг 1, а полный пропуск этого параметра по умолчанию будет равен first : last :1. Все значения могут быть числами с плавающей запятой. начало и конец могут быть отрицательными, чтобы вести отсчет в обратном направлении от последнего значения. Если и начало , и конец отрицательны, убедитесь, что они указаны в возрастающем значении (например, -6:-1:1). Если значение шага n меньше 1, дополнительные точки данных будут рассчитаны путем интерполяции заданных значений данных. Значения по умолчанию: первый:последний:1. -
x : y
- [ Not supported for N-type markers ] Draw a marker at a specific x/y point on the chart. Эта точка не обязательно должна находиться на прямой. Add the at character (@
) before the marker type to use this option. Specify the coordinates as floating point values, where0:0
is the bottom left corner of the chart,0.5:0.5
is the center of the chart, and1:1
is the top right corner of the chart. Например, чтобы добавить красный ромб размером 15 пикселей в центр диаграммы, используйте@d,FF0000,0,0.5:0.5,15
.
-
- < размер >
- 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 >
- [ Необязательно ] Слой, на котором будет рисоваться маркер, по сравнению с другими маркерами и всеми остальными элементами диаграммы. Это число с плавающей запятой от -1,0 до 1,0 включительно, где -1,0 — низ, а 1,0 — верх. Элементы диаграммы (линии и столбцы) чуть ниже нуля. Если два маркера имеют одинаковое значение, они отображаются в порядке, заданном URL-адресом. Значение по умолчанию — 0,0 (чуть выше элементов диаграммы).
- < 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 >
. Если указано, вы можете включить пустое значение в строку параметраchm
для <opt_z_order> . Examples:N,000000,0,1,10,,b
andN,000000,0,1,10,,lv
andN,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 ( The second chart ( |
| |
You can use the This example shows a chart with simple-encoded values of 46, 39, 29, 30, 43, 41. Simple encoding range is 0—61 . The | chd=s:underp | |
Here's an example of a chart with a text label at the minimum point and a flag label at the maximum point. |
| |
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= | |
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= | |
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. | chm=B,C5D4B5BB,0,0,0 | |
Another annotation marker example demonstrating city altitudes in Switzerland. |
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.
Синтаксис
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 andR
for a vertical range. - < цвет >
- 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, and1.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, and1.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, and1.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, and1.00
is the right of the chart.
Примеры
Описание | Пример |
---|---|
Range markers can be a thin line or a band of color.
|
|
This example shows the vertical range markers. The first marker is a red line ( |
|
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. | chm= |
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. |
|
Маркеры свечей chm=F
[ Bar, Line ]
Маркеры свечей указывают на дисперсию и изменение направления в ряду данных. Often they are used to show stock values during the course of a day. Маркер включает в себя сегменты, показывающие максимальное и минимальное значения, а также значения открытия и закрытия за определенный период времени (обычно день). Подробнее о свечных маркерах смотрите здесь .
Свечной маркер рисуется в виде прямоугольника, разделенного вертикальной линией пополам. Для рисования свечного маркера требуется четыре ряда данных; вот что указывает каждая серия:
- Ряды 1 и 4 определяют нижнюю и верхнюю часть вертикальной линии соответственно. Обычно они представляют собой минимальное и максимальное значения за день.
- Ряды 2 и 3 определяют вертикальные границы прямоугольника. Серия 2 — это значение открытия, а серия 3 — значение закрытия. Цвет прямоугольника зависит от того, что выше: когда значение открытия (серия 2) ниже значения закрытия (серия 3), цена выросла, и прямоугольник по умолчанию заполняется сплошным зеленым цветом; когда значение открытия (серия 2) выше значения закрытия (серия 3), цена снижается, и прямоугольник по умолчанию заполняется сплошным красным цветом. Для прямоугольника можно указать только цвет заливки с уменьшающимся значением. Когда вы это укажете, прямоугольник с увеличивающимся значением будет незаполненным (пустым). Обратите внимание, что серия 2 может быть либо верхней, либо нижней частью прямоугольника, в зависимости от того, выросла или упала цена.
Вы можете комбинировать маркеры свечей с любыми другими параметрами chm
, используя символ вертикальной черты ( |
) для разделения параметров chm
.
Примечание. Если вы не хотите, чтобы строки данных, используемые для рисования маркеров, отображались на диаграмме, необходимо добавить 0 после типа формата. Например: chd=t0:10,20,30,40
в строке данных текстового формата. Дополнительную информацию см. в разделе «Составные диаграммы» .
Вот пример, показывающий строки для каждой серии:
Синтаксис
chm= F,<opt_declining_color>,<data_series_index>,<opt_which_points>,<width>,<opt_z_order>
- Ф
- Indicates that this is a candlestick marker.
- <pt_declining_color>
- [ Необязательно ] Заполните цвет для прямоугольников при уменьшении значения (когда значение серии 2> Соответствующее значение серии 3). Это шестнадцатеричный номер формата RRGGBB . Когда значения увеличатся, прямоугольник будет пустым. По умолчанию является твердое зеленое для увеличения, сплошной красный для уменьшения (вы не можете указать пользовательский цвет заполнения для увеличения значений).
- <data_series_index>
- Индекс серии данных для использования в качестве первой серии для ваших маркеров подсвечника. Это индекс на основе нуля. Итак, если вы указали 1 здесь, и у вас есть шесть серий, вторая, третья, четвертая и пятая будут использованы для рисования маркеров подсвечника.
- <OPT_WHICH_POINTS>
- [ Необязательно ] указывает, какие точки данных используются для рисования маркеров. По умолчанию — все маркеры. Используйте один из следующих форматов:
-
nd
- Нарисуйте маркер в одной точке в серии, где ND является индексом точки в серии. Если вы укажете нецелое значение, то дробь указывает на рассчитанную промежуточную точку. Например, 3,5 означает середину между точкой 3 и точкой 4. -
-1
— Нарисуйте маркер на всех точках данных. Вы также можете оставить этот параметр пустым, чтобы нарисовать все маркеры. -
- n
- Нарисовать маркер на каждой n -й точке данных. -
start:end:n
— рисует маркер на каждой n -й точке данных в диапазоне, от начального до конечного значения индекса включительно. Все параметры являются необязательными (могут отсутствовать), поэтому 3::1 будет от четвертого элемента до последнего, шаг 1, а полный пропуск этого параметра по умолчанию будет равен first : last :1. Все значения могут быть числами с плавающей запятой. начало и конец могут быть отрицательными, чтобы вести отсчет в обратном направлении от последнего значения. Если и начало , и конец отрицательны, убедитесь, что они указаны в возрастающем значении (например, -6:-1:1). Если значение шага n меньше 1, дополнительные точки данных будут рассчитаны путем интерполяции заданных значений данных. Значения по умолчанию: первый:последний:1.
-
- <ширина>
- Ширина всех прямоугольников, в пикселях.
- <pt_z_order>
- [ Необязательно ] Слой, на котором будет рисоваться маркер, по сравнению с другими маркерами и всеми остальными элементами диаграммы. Это число с плавающей запятой от -1,0 до 1,0 включительно, где -1,0 — низ, а 1,0 — верх. Элементы диаграммы (линии и столбцы) чуть ниже нуля. Если два маркера имеют одинаковое значение, они отображаются в порядке, заданном URL-адресом. Значение по умолчанию — 0,0 (чуть выше элементов диаграммы).
Примеры
Описание | Пример |
---|---|
Вот пример маркеров подсвечника на линейной диаграмме с четырьмя сериями. Указан пользовательский цвет Первый и последний прямоугольник обрезается диаграммой. Чтобы устранить эти значения, вы можете указать 1: 4 для четвертого параметра CHM. Обратите внимание на ноль в строке данных, чтобы скрыть строки для серии: Параметр <what_point> является пустым, который привлекает подсвечники на всех точках данных. |
chd=t0: |
Вот пример того же диаграммы, используя цвета по умолчанию и удаление первого и последнего элемента. Это составная диаграмма: это комбинация линейной диаграммы (тип базовой диаграммы) и маркеров подсвечника. Значение 1 в |
|
Линейные маркеры chm=D
[ Бар, Свеча, Линия, Радар, Разброс ]
Вы можете добавить линию, которая отслеживает данные на диаграмме. Чаще всего это используется в составных диаграммах .
Чтобы добавить несколько строк (или объединить их с другими маркерами chm
), разделите наборы параметров chm с помощью разделителя вертикальной черты ( |
). С помощью этого параметра нельзя создать маркер пунктирной линии.
Синтаксис
chm= D,<color>,<series_index>,<which_points>,<width>,<opt_z_order>
- Д
- Указывает, что это линейный маркер.
- < цвет >
- Цвет линии в шестнадцатеричном формате RRGGBB .
- < индекс_серии >
- Индекс ряда данных, используемый для рисования линии. Индекс серии данных равен
0
для первой серии данных,1
для второй серии данных и т. д. - < какие_точки >
- Какие точки в серии использовать, чтобы провести линию. Используйте одно из следующих значений:
-
0
— использовать все точки серии. -
start:end
— использовать определенный диапазон точек в серии, от начала до конца включительно (индекс отсчитывается от нуля). Вы также можете использовать значения с плавающей запятой для указания промежуточных точек или оставить начало или конец пустыми, чтобы указать первую или последнюю точку данных соответственно. начало и конец могут быть отрицательными, как обратный индекс от последнего значения. Если и начало , и конец отрицательны, обязательно запишите их в возрастающем значении (например, -6:-1).
-
- < размер >
- Ширина линии в пикселях.
- < opt_z_order >
- [ Необязательно ] Слой, на котором будет рисоваться маркер, по сравнению с другими маркерами и всеми остальными элементами диаграммы. Это число с плавающей запятой от -1,0 до 1,0 включительно, где -1,0 — низ, а 1,0 — верх. Элементы диаграммы (линии и столбцы) чуть ниже нуля. Если два маркера имеют одинаковое значение, они отображаются в порядке, заданном URL-адресом. Значение по умолчанию — 0,0 (чуть выше элементов диаграммы).
Примеры
Описание | Пример |
---|---|
Это пример рисования линии-маркера на гистограмме. Для z-порядка установлено значение | chm=D,0033FF,0,0,5,1 |
Это та же гистограмма, но с дополнительным рядом данных только для линии. Это пример составной диаграммы. Составные диаграммы создаются путем добавления дополнительных рядов данных к параметру Дополнительную информацию см. в разделе «Составные диаграммы» . | chm=D,0033FF,1,0,5,1 |
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 inchd
. - 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.
Синтаксис
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 >
ИЛИ
< 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.
x,0,100,1
declares a variable namedx
with values 0, 1, 2, ... 100.x,0,100,1;r,0,3.1,.1
declares the samex
variable plus a variable namedr
with values 0, 0.1, 0.2, ..., 3.0, 3.1.x,0
declares a variable named x that uses the data from the firstchd
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!
Примеры
Описание | Пример |
---|---|
A simple sine wave. Some things to notice:
| cht=lc |
This line uses data from the chd parameter. | chd=t:5,10 |
A mix of function and non-function lines. Notice how the colors are specified by the series color parameter 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. | chd=t: |
To define a function in two dimensions, use an
| cht=lxy |
The Try clicking these images to open and play with them in the chart playground; you'll get hooked! |