В этом документе описывается, как создавать круговые диаграммы с помощью API диаграмм.
Оглавление
Особенности диаграммы
| Стандартные функции
|
Обзор
Круговые диаграммы хороши для отображения простой пропорциональной информации от части к целому. Вы можете создать круговую диаграмму с одной серией, где каждая серия состоит из нескольких срезов, или концентрические диаграммы с несколькими сериями.
Каждая серия описывает одну круговую диаграмму, а каждое значение данных указывает один срез. При использовании вложенных круговых диаграмм (описанных ниже) используйте несколько рядов.
Чтобы отобразить текст, связанный с фрагментом, вам придется использовать либо метки круговой диаграммы , либо легенду диаграммы . Метки круговой диаграммы представляют собой текст вокруг диаграммы с линиями, направленными к срезу. Легенды — это текст, связанный цветом.
Этикетки | Легенда | Этикетки и легенда |
---|---|---|
chl=January|February|March|April | chdl=January|February|March|April | chl=January|February|March|April |
Значения отображаются относительно друг друга: поэтому диаграмма со значениями 1,2,3 будет выглядеть так же, как диаграмма со значениями 100,200,300. Однако при использовании данных текстового формата значения больше 100 обрезаются до 100, поэтому вам нужно будет использовать текстовый формат с пользовательским масштабированием для правильного отображения фрагментов больше 100 (используйте параметр chds
с минимальными/максимальными значениями chds=0,< max-slice-size >
).
Отрицательные значения отображаются как пустые фрагменты соответствующего размера.
Типы диаграмм
Существует три основных типа круговых диаграмм, которые вы можете создать: плоские, концентрические и трехмерные. Укажите круговую диаграмму со следующим синтаксисом:
Синтаксис
cht=<chart_type>
Где < chart_type >
— один из следующих типов:
Параметр | Описание | Пример |
---|---|---|
| Двумерная круговая диаграмма. Предоставляйте только один ряд данных; последующие серии данных игнорируются. По умолчанию цвета сегментов диаграммы интерполируются от темно-оранжевого до бледно-желтого. Укажите другие цвета, как описано в разделе «Цвета серии» . Укажите метки с помощью API Google Chart вычисляет радиус круга по минимальному значению ширины и высоты, указанному в параметре размера диаграммы ( | |
| Трехмерная круговая диаграмма. Укажите данные и форматирование так же, как для двумерных круговых диаграмм выше. Если вы включаете метки в трехмерную круговую диаграмму, вам, вероятно, потребуется указать размер ширины, в 2,5 раза превышающий размер высоты, чтобы гарантировать, что ваши метки будут полностью видны. | |
| Концентрическая круговая диаграмма. Предоставьте два или более ряда данных. | |
Все типы | Отрицательные числа в данных вызывают «пустые» срезы. | cht=pc |
Серия Цвета chco
Вы можете указать цвета всех значений, каждого значения или некоторых значений, используя параметр chco
.
Синтаксис
chco=<slice_1>|<slice_2>|<slice_n>,<series_color_1>,...,<series_color_n>
- < цвет >
- Цвета срезов в шестнадцатеричном формате RRGGBB . Укажите один цвет серии, и все фрагменты в этой серии будут окрашены в градации этого цвета от самого темного (первый элемент данных) до самого светлого (последний элемент данных). Укажите два или более цветов, разделенных символом | для описания отдельных цветов срезов. Если у вас есть несколько серий (то есть диаграмма с концентрическими кольцами), вы можете указать значения для разных серий, разделяя значения запятой. Если задано меньше цветов срезов/серий, чем отображается срезов/серий, диаграмма будет циклически перемещаться от начала списка срезов для серии или списка серий для диаграммы. Вы не можете указать отдельный градиент для каждой серии на диаграмме с несколькими сериями.
Описание | Пример |
---|---|
Укажите один цвет, чтобы иметь градации от самого темного (первый фрагмент) до самого светлого (последний фрагмент). | |
Определение градиента; здесь от желтого к красному. |
|
Определение отдельных цветов срезов; укажите один цвет для каждого фрагмента. | chd=t:10,20,30 |
На этой диаграмме есть два ряда данных, но цвет указан как один градиент на всех срезах от желтого до красного (BBBB00–BB0000). | chco=BBBB00,BB0000 |
Вот концентрическая диаграмма, которая включает в себя как цвета серий, так и цвета отдельных срезов. Диаграмма содержит два концентрических ряда данных. В удобочитаемой форме цвета: chco=зеленый|красный,синий|желтый. Запятая разбивает это на две серии:
| chd=s:eYY,ORVM |
Ярлыки круговой диаграммы chl
Вы можете указать метки для отдельных фрагментов круговой диаграммы, используя параметр chl
. Вы также можете отображать легенду с одинаковыми или разными значениями, по одной записи легенды для каждого среза.
Примечание о строковых значениях. В строках меток разрешены только символы, безопасные для URL. В целях безопасности вам следует закодировать URL-адресом все строки, содержащие символы, не входящие в набор символов 0-9a-zA-Z
. Кодировщик URL-адресов можно найти здесь .
Синтаксис
chl= <label_value>| ... <label_value>
- <значение_метки >
- Строковое значение, применяемое к срезу. Метки последовательно применяются к точкам данных в
chd
. Если у вас есть несколько рядов (например, для концентрической круговой диаграммы), метки применяются ко всем точкам во всех последовательностях в порядке, указанном вchd
. Используйте разделитель вертикальной черты (|
) между каждой меткой. Укажите недостающее промежуточное значение, используя два последовательных символа вертикальной черты без пробела между ними:||
. Вам не нужно маркировать все срезы.
Примеры
Описание | Пример |
---|---|
Метки для трехмерной круговой диаграммы. | |
Указывая размер диаграммы с помощью Как правило, для правильного отображения меток ширина двумерной круговой диаграммы должна быть примерно в два раза шире ее высоты, а ширина трехмерной круговой диаграммы должна быть примерно в два с половиной раза шире ее высоты. В первом примере метки отображаются лишь частично, поскольку диаграмма недостаточно широка. Второй пример показывает, что для полного отображения меток диаграмме необходима ширина 280 пикселей. (Границы добавлены явно к элементу | |
Ротация круговой диаграммы chp
По умолчанию первая серия рисуется начиная с 3:00 и продолжается по часовой стрелке вокруг диаграммы, но вы можете указать собственное вращение с помощью параметра chp
.
Синтаксис
chp=<radians>
- <радианы >
- Значение с плавающей запятой, описывающее, на сколько радиан нужно повернуть диаграмму по часовой стрелке. Один полный оборот составляет 2 π (2 пи — около 6,28) радиан.
Примеры
Описание | Пример |
---|---|
Чтобы изменить ориентацию круговой диаграммы, используйте | |
Вот еще один пример вращения круговой диаграммы. Их можно комбинировать с маркерами формы диаграммы для создания интересных эффектов . |
Стандартные функции
Остальные функции на этой странице являются стандартными функциями диаграмм.
Название графика chtt
, chts
[ Все графики ]
Вы можете указать текст заголовка, цвет и размер шрифта для диаграммы.
Синтаксис
chtt=<chart_title> chts=<color>,<font_size>,<opt_alignment>
chtt
— указывает заголовок диаграммы.
- < название_диаграммы >
- Название для отображения диаграммы. Вы не можете указать, где это будет отображаться, но при желании вы можете указать размер и цвет шрифта. Используйте знак + для обозначения пробелов и символ вертикальной черты (
|
) для обозначения разрывов строк.
chts
[ Необязательно ] — цвета и размер шрифта для параметра chtt
.
- <цвет >
- Цвет заголовка в шестнадцатеричном формате RRGGBB . Цвет по умолчанию — черный.
- <размер_шрифта >
- Размер шрифта заголовка, в пунктах.
- <opt_alignment>
- [ Необязательно ] Выравнивание заголовка. Выберите одно из следующих строковых значений с учетом регистра: «l» (слева), «c» (по центру), «r» (справа). По умолчанию — «с».
Примеры
Описание | Пример |
---|---|
Диаграмма с заголовком, в которой используется цвет и размер шрифта по умолчанию. Укажите пробел со знаком плюс ( Используйте символ вертикальной черты ( | 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. - <метка_1> | ... |< метка_n >
- Одна или несколько меток, которые можно разместить вдоль этой оси. Это могут быть строковые или числовые значения; строки не обязательно должны быть в кавычках. label_1 отображается в самой нижней позиции на оси, а label_n отображается в самой высокой позиции. Дополнительные метки располагаются между ними равномерно. Пробелы обозначайте знаком +. Невозможно указать разрыв строки в метке. Отдельные метки с помощью вертикальной черты. Примечание. Не размещайте трубку после последней метки в параметре
chxl
.
Примеры
Описание | Пример |
---|---|
На этой диаграмме показано, как добавлять пользовательские метки к двум осям. Обратите внимание, что значения расположены равномерно и что последнее значение | chxt=x,y |
Этот пример включает метки осей на левой и правой осях Y ( |
|
Этот пример включает метки осей на левой и правой осях Y ( В этом примере используются значения по умолчанию для меток оси на левой оси Y. |
|
Если вы хотите добавить общую метку для описания всей оси (например, чтобы пометить одну ось «стоимость», а другую — «студент»), используйте свойство | chxt=x,x,y,y |
Позиции меток осей 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 и так далее. - < 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>
- < индекс_оси >
- Ось, к которой это относится. Это индекс, начинающийся с нуля, в параметре
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 зависит от типа диаграммы: поэкспериментируйте с диаграммой, чтобы определить, что они означают. По умолчанию — «y» .
-
-
< following_text >
— буквенный текст, следующий за каждым значением.
-
- <opt_label_color>
- Цвет, применяемый к тексту оси (но не к линии оси) в шестнадцатеричном формате RRGGBB . Цвет линии оси указывается отдельно с помощью opt_axis_color . По умолчанию серый.
- < opt_font_size >
- [ Необязательно ] указывает размер шрифта в пикселях. Этот параметр является необязательным.
- <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 (январь, февраль, март). | |
Размер, цвет и выравнивание шрифта указаны для правой оси 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= |
Функции данных chfd
[ все диаграммы chd
]
Вы можете указать пользовательскую функцию для запуска данных диаграммы, используя синтаксис функции Muparser . Данные, используемые в функции, могут поступать из одного из двух источников:
- Серия данных из
chd
- данные получены из указанной серии вchd
. - Диапазон значений, объявленных в самом параметре
chfd
- вы объявляете запуск, остановку и шаг значения для произвольного диапазона данных.
Важно отметить, что во всех случаях вы должны назначить вывод существующей серии в chd
; Эта серия будет перезаписана выходом функции. Диаграмма отображается только после того, как все функции были процессами, поэтому, если вы назначаете несколько функций для вывода в одну и ту же серию данных, функции будут выполнены в данном порядке, но только вывод окончательной функции будет нанесен на график. . Обратите внимание, что вы можете цепорить функции, чтобы одна функция мог принять в качестве ввода серию, которая была выведена по предыдущей функции.
Чтобы присвоить цвета или маркеры chm
в линию функции, назначьте цвета или маркеры для серии функций. Обратите внимание, что маркеры размещаются в соответствии с данными после того, как они манипулировали функцией.
Синтаксис
chfd= <output_series_index>,<function_data>,<function_string> |...| <output_series_index>,<function_data>,<function_string>
- <put_series_index>
- Основной индекс серии данных в
chd
, в который будет записан выход функции. Любые существующие данные будут полностью перезаписаны выходом функции. Если серия не используется в качестве входных данных для функции, лучшая практика заключается в назначении одного фиктивного значения этой серии. - <faction_data>
- Переменные и данные для построения. Данные могут быть из диапазона, который вы определяете, или из одной из серий данных
chd
. Вы можете указать несколько переменных для каждой функции, используя; (полуколон) разделитель для нескольких переменных. Обратите внимание, что если вы определяете несколько переменных для одной функции, и эти переменные имеют различное количество точек, функция остановится, когда она достигнет первой конечной точки. Например, если функция определяет как x = 1—5 Шаг 1, так и y = 1—10 Шаг 1, функция закончится, когда она достигнет пятой точки.
< variable_name >,< input_series_index >
ИЛИ
< variable_name >,< start >,< end >,< step >
- variable_name - произвольное имя строки для переменной. Используйте это в функции, определенной Function_string .
- input_series_index - индекс серии данных
chd
для использования в качестве входных данных. - Start - числовое начало начала диапазона.
- Конец - числовое конечное значение диапазона.
- Шаг - числовое значение шага от начала до конца . Может быть положительным или отрицательным, но не может быть нулю.
x,0,100,1
объявляет переменную с именемx
со значениями 0, 1, 2, ... 100.x,0,100,1;r,0,3.1,.1
объявляет ту же переменнуюx
плюс переменная с именемr
с Значения 0, 0,1, 0,2, ..., 3,0, 3,1.x,0
объявляет переменную с именем x, которая использует данные из первой серииchd
. Эти переменные будут использоваться Function_String . Они не будут нанесены на график, если вы не указате их в function_string . Чем меньше шаг, тем более гладкий ваш график. - <faction_string>
- Ваша функция, написанная в синтаксисе Muparser . Функция применяется к переменным и данным, указанным в variable_data . Вы можете ссылаться только на переменные, объявленные в этом локальном наборе функций, а не в другом наборе параметров
chfd
. Резюме функции Muparser не поддерживаются (Min, Max Sum, AVG). Важно: не забудьте использовать%2B
вместо+
в ваших функциях!
Примеры
Описание | Пример |
---|---|
Простая синусоидальная волна. Некоторые вещи, которые нужно заметить:
| cht=lc |
Эта строка использует данные из chd -параметра. | chd=t:5,10 |
Смесь функции и нефункциональных линий. Обратите внимание, как цвета определяются с помощью параметра CHCO серии Обратите внимание на размещение маркеров на вывод функции; Точки данных рассчитываются из начала , конца и шага , поэтому, если ваш диапазон составляет 0–11 шаг 0.1, точка 0 равен 0, точка 1 составляет 0,1 и т. Д., До точки 110, что составляет 11. | chd=t: |
Чтобы определить функцию в двух измерениях, используйте диаграмму
| cht=lxy |
Параметр Попробуйте щелкнуть эти изображения, чтобы открыть и поиграть с ними на детской площадке; Вы получите подключение! |