В этом документе описывается, как создавать круговые диаграммы с помощью API диаграмм.

Оглавление

Обзор

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

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

Чтобы отобразить текст, связанный с фрагментом, вам придется использовать либо метки круговой диаграммы , либо легенду диаграммы . Метки круговой диаграммы представляют собой текст вокруг диаграммы с линиями, направленными к срезу. Легенды — это текст, связанный цветом.

Этикетки	Легенда	Этикетки и легенда
chl=January|February|March|April	chdl=January|February|March|April	chl=January|February|March|April chdl=30°|40°|50°|60°

Значения отображаются относительно друг друга: поэтому диаграмма со значениями 1,2,3 будет выглядеть так же, как диаграмма со значениями 100,200,300. Однако при использовании данных текстового формата значения больше 100 обрезаются до 100, поэтому вам нужно будет использовать текстовый формат с пользовательским масштабированием для правильного отображения фрагментов больше 100 (используйте параметр chds с минимальными/максимальными значениями chds=0,< max-slice-size > ).

Отрицательные значения отображаются как пустые фрагменты соответствующего размера.

Типы диаграмм

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

Синтаксис

cht=<chart_type>

Где < chart_type > — один из следующих типов:

Параметр	Описание	Пример
p	Двумерная круговая диаграмма. Предоставляйте только один ряд данных; последующие серии данных игнорируются. По умолчанию цвета сегментов диаграммы интерполируются от темно-оранжевого до бледно-желтого. Укажите другие цвета, как описано в разделе «Цвета серии» . Укажите метки с помощью chl , как описано в разделе Метки круговой диаграммы . API Google Chart вычисляет радиус круга по минимальному значению ширины и высоты, указанному в параметре размера диаграммы ( chs ). Если вы включаете метки, вам, вероятно, придется указать размер ширины, в два раза превышающий высоту, чтобы ваши метки были полностью видны.	cht=p chs=200x100
p3	Трехмерная круговая диаграмма. Укажите данные и форматирование так же, как для двумерных круговых диаграмм выше. Если вы включаете метки в трехмерную круговую диаграмму, вам, вероятно, потребуется указать размер ширины, в 2,5 раза превышающий размер высоты, чтобы гарантировать, что ваши метки будут полностью видны.	cht=p3 chs=250x100
pc	Концентрическая круговая диаграмма. Предоставьте два или более ряда данных.	cht=pc chd=s:Helo,Wrld
Все типы	Отрицательные числа в данных вызывают «пустые» срезы.	cht=pc chd=t: 10,-10,10,-10| 5,-5,5,-5,5,-5,5,-5,5,-5

Серия Цвета chco

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

Синтаксис

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

< цвет >

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

Описание	Пример
Укажите один цвет, чтобы иметь градации от самого темного (первый фрагмент) до самого светлого (последний фрагмент).	chco=0000FF
Определение градиента; здесь от желтого к красному.	chd=t:10,20,30,40,50 chco=FFFF10,FF0000
Определение отдельных цветов срезов; укажите один цвет для каждого фрагмента.	chd=t:10,20,30 chco=FF0000|00FF00|0000FF
На этой диаграмме есть два ряда данных, но цвет указан как один градиент на всех срезах от желтого до красного (BBBB00–BB0000).	chco=BBBB00,BB0000
Вот концентрическая диаграмма, которая включает в себя как цвета серий, так и цвета отдельных срезов. Диаграмма содержит два концентрических ряда данных. В удобочитаемой форме цвета: chco=зеленый|красный,синий|желтый. Запятая разбивает это на две серии: зеленый|красный — чередование зеленых и красных фрагментов. синий|желтый — чередующиеся синие и желтые кусочки.	chd=s:eYY,ORVM chco=008800|880000,000088|888800

Вернуться наверх

Ярлыки круговой диаграммы chl

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

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

Синтаксис

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

<значение_метки >

Строковое значение, применяемое к срезу. Метки последовательно применяются к точкам данных в chd . Если у вас есть несколько рядов (например, для концентрической круговой диаграммы), метки применяются ко всем точкам во всех последовательностях в порядке, указанном в chd . Используйте разделитель вертикальной черты ( | ) между каждой меткой. Укажите недостающее промежуточное значение, используя два последовательных символа вертикальной черты без пробела между ними: || . Вам не нужно маркировать все срезы.

Примеры

Вернуться наверх

Ротация круговой диаграммы chp

По умолчанию первая серия рисуется начиная с 3:00 и продолжается по часовой стрелке вокруг диаграммы, но вы можете указать собственное вращение с помощью параметра chp .

Синтаксис

chp=<radians>
  

<радианы >

Значение с плавающей запятой, описывающее, на сколько радиан нужно повернуть диаграмму по часовой стрелке. Один полный оборот составляет 2 π (2 пи — около 6,28) радиан.

Примеры

Описание	Пример
Чтобы изменить ориентацию круговой диаграммы, используйте chp=< angle_in_radians >	chd=t:20,80 chd=t:80,20 chp=0.628
Вот еще один пример вращения круговой диаграммы. Их можно комбинировать с маркерами формы диаграммы для создания интересных эффектов .

Вернуться наверх

Стандартные функции

Остальные функции на этой странице являются стандартными функциями диаграмм.

Название графика chtt , chts [ Все графики ]

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

Синтаксис

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

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

< название_диаграммы >

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

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

<цвет >

Цвет заголовка в шестнадцатеричном формате RRGGBB . Цвет по умолчанию — черный.

<размер_шрифта >

Размер шрифта заголовка, в пунктах.

<opt_alignment>

[ Необязательно ] Выравнивание заголовка. Выберите одно из следующих строковых значений с учетом регистра: «l» (слева), «c» (по центру), «r» (справа). По умолчанию — «с».

Примеры

Описание	Пример
Диаграмма с заголовком, в которой используется цвет и размер шрифта по умолчанию. Укажите пробел со знаком плюс ( + ). Используйте символ вертикальной черты ( | ), чтобы вызвать разрыв строки. chts здесь не указан.	chtt=Site+visitors+by+month| January+to+July
Диаграмма с синим заголовком размером 20 пунктов, выровненным по правому краю.	chtt=Site+visitors chts=FF0000,20,r

Вернуться наверх

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

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

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

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

Синтаксис

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

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

< метка_серии_данных >

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

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

< опт_позиция >

[ Необязательно ] Указывает положение легенды на диаграмме. Чтобы указать дополнительное отступы между легендой и областью диаграммы или границей изображения, используйте параметр chma . Выберите одно из следующих значений:

• b – Легенда внизу диаграммы, записи легенды располагаются в горизонтальном ряду.
• bv — легенда внизу диаграммы, записи легенды в вертикальном столбце.
• t — Легенда вверху диаграммы, записи легенды расположены в горизонтальном ряду.
• tv — Легенда вверху диаграммы, записи легенды в вертикальном столбце.
• r — [ по умолчанию ] Легенда справа от диаграммы, записи легенды в вертикальном столбце.
• l — Легенда слева от диаграммы, записи легенды в вертикальном столбце.

<opt_label_order>

[ Необязательно ] Порядок отображения меток в легенде. Выберите одно из следующих значений:

• l [ По умолчанию для вертикальных легенд ] Отображать метки в порядке, указанном в chdl .
• r — отображать метки в порядке, обратном заданному chdl . Это полезно в составных гистограммах, чтобы показать легенду.
  в том же порядке, в котором появляются полосы.
• a — [ По умолчанию для горизонтальных легенд ] Автоматическое упорядочение: примерно означает сортировку по длине, сначала самый короткий, измеряемый в блоках по 10 пикселей. Если два элемента имеют одинаковую длину (разделены на блоки по 10 пикселей), первым будет отображаться тот, который указан первым.
• 0,1,2... — Пользовательский порядок меток. Это список индексов меток, отсчитываемых от нуля, из chdl , разделенных запятыми.

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

< цвет >

Цвет текста легенды в шестнадцатеричном формате RRGGBB .

< размер >

Размер в пунктах текста легенды.

Примеры

Вернуться наверх

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

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

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

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

Синтаксис

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

< левое_поле >, < правое_поле >, < верхнее_поле >, < нижнее_поле >

Минимальный размер поля вокруг области диаграммы в пикселях. Увеличьте это значение, чтобы включить некоторые отступы, чтобы метки осей не сталкивались с границами диаграммы.

<opt_legend_width> , <opt_legend_height>

[ Необязательно ] Ширина поля вокруг легенды в пикселях. Используйте это, чтобы легенда не сталкивалась с областью диаграммы или краями изображения.

Примеры

Вернуться наверх

Стили и метки осей [ линия, полоса, 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 для всех осей. Обратите внимание, что по умолчанию верхняя и нижняя оси не имеют меток рядом с метками.	chxt=x,y,r,t
Вы можете включить несколько наборов меток для каждой оси, включив одно и то же значение несколько раз. В этом примере показаны два набора осей X и два набора осей Y. Это не особенно полезно при использовании только меток осей по умолчанию, как показано здесь. Но вы можете указать собственные метки для каждой копии каждой оси, используя параметр chxl .	chxt=x,x,y,y chxt=x,x,y,y chxl= 1:|Замерзание|Горячо| 3:|Низкий|Высокий
В этом примере показана горизонтальная гистограмма с осью X, осью Y, верхней осью T и правой осью R. Метки осей опущены, поэтому API диаграмм отображает диапазон от 0 до 100 для оси X и для оси T. Диапазон по оси Y и по оси R определяется количеством столбцов. В данном случае имеется пять столбцов, поэтому API диаграмм отображает диапазон от 0 до 4. Первая метка располагается по центру основания первого столбца, вторая метка — по центру основания второго столбца и т. д. .	chxt=x,y,r,t
Вы можете отключить оси по умолчанию в линейной диаграмме, указав :nda после типа диаграммы.	cht=lc:nda

Вернуться наверх

Диапазон оси chxr

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

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

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

Синтаксис

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

chxr=
  <axis_index>,<start_val>,<end_val>,<opt_step>
    |...|
  <axis_index>,<start_val>,<end_val>,<opt_step>

<индекс_оси >

К какой оси применять метки. Это индекс, начинающийся с нуля, в массиве осей, заданном chxt . Например, ось r будет равна 1 в chxt=x,r,y .

< начальное_значение >

Число, определяющее нижнее значение для этой оси.

< конечное_значение >

Число, определяющее максимальное значение для этой оси.

<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 .

Примеры

Описание	Пример
На этой диаграмме показано, как добавлять пользовательские метки к двум осям. Обратите внимание, что значения расположены равномерно и что последнее значение chxl не заканчивается вертикальной чертой.	chxt=x,y chxl= 0:|Jan|Feb|March|April|May| 1:|Min|Mid|Max
Этот пример включает метки осей на левой и правой осях Y ( y и r ). Он также включает два набора значений для оси X ( x ). Вы можете рассмотреть возможность добавления делений по оси Y с помощью chxs .	chxt=x,y,r,x chxl= 0:|Jan|July|Jan|July|Jan| 1:|0|50|100| 2:|A|B|C| 3:|2005|2006|2007
Этот пример включает метки осей на левой и правой осях Y ( y и r ). Он также включает два набора значений для оси X ( x ). Обратите внимание на пустые метки для нижнего набора осей X, используемые для разделения значений. В этом примере используются значения по умолчанию для меток оси на левой оси Y.	chxt=x,y,r,x chxl= 0:|Jan|July|Jan|July|Jan| 2:|A|B|C| 3:|2005||2006||2007
Если вы хотите добавить общую метку для описания всей оси (например, чтобы пометить одну ось «стоимость», а другую — «студент»), используйте свойство chxt , чтобы добавить дополнительную ось с каждой стороны, а затем используйте chxl , чтобы добавить по одной настраиваемой метке с каждой стороны и chxp , чтобы разместить ее посередине оси.	chxt=x,x,y,y chxl=1:|Martinis|3:|Score chxp=1,50|3,50

Вернуться наверх

Позиции меток осей chxp

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

Синтаксис

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

chxp=
  <axis_1_index>,<label_1_position>,...,<label_n_position>
    |...|
  <axis_m_index>,<label_1_position>,...,<label_n_position>

<индекс_оси >

Ось, для которой вы указываете позиции. Это индекс массива параметров chxt . Например, если у вас есть chxt=x,x,y,y то индекс 0 будет первой осью X, 1 — второй осью X и так далее.

< label_1_position >,...,< label_n_position >

Положение метки вдоль оси. Это список числовых значений, разделенных запятыми, где каждое значение задает положение соответствующей метки в массиве chxl : первая запись применяется к первой метке и так далее. Позиция — это значение в диапазоне для этой оси . Обратите внимание, что это всегда будет значение от 0 до 100, если вы не указали собственный диапазон с помощью chxr . У вас должно быть столько позиций, сколько меток для этой оси.

Примеры

Описание	Пример
Этот пример включает метки оси R в указанных позициях на диаграмме. Текст метки задается с помощью параметра chxl . Метки с указанной позицией 0 размещаются внизу оси Y или R или слева от оси X или T. Метки с указанной позицией 100 размещаются вверху оси Y или R или справа от оси X или T.	chxt=x,y,r chxl=2:|min|average|max chxp=2,10,35,75
В этом примере показано отображение значений меток по умолчанию, но только в указанных местах. chxp=1,10,35,75 — на оси Y должны отображаться только три метки: 10, 35 и 75. Поскольку текст пользовательской метки не указан, отображаются значения этих осей. Обратите внимание, что вам не нужно равномерно распределять метки при использовании chxp . Если бы chxp здесь не был указан, расстояние до значения метки по умолчанию по оси Y составляло бы каждые 20 единиц, как показано на втором графике.	chxt=x,y chxp=1,10,35,75 chxt=x,y chxp не указан

Вернуться наверх

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

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

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

Синтаксис

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

chxs=
 <axis_index><opt_format_string>,<opt_label_color>,<opt_font_size>,<opt_alignment>,<opt_axis_or_tick>,<opt_tick_color>,<opt_axis_color>
   |...|
 <axis_index><opt_format_string>,<opt_label_color>,<opt_font_size>,<opt_alignment>,<opt_axis_or_tick>,<opt_tick_color>,<opt_axis_color>

< индекс_оси >

Ось, к которой это относится. Это индекс, начинающийся с нуля, в параметре chxt .

< строка_опт_формата >

[ Необязательно ] Это необязательная строка формата, которая, если она используется, следует сразу после номера индекса оси без промежуточной запятой. Он начинается с буквы N, за которой следуют следующие значения (все необязательные): Синтаксис строки форматирования следующий:
N< preceding_text >*< number_type >< decimal_places >zs< x or y >*< following_text >
Вот значение каждого элемента:

• <preceding_text> — буквенный текст, предшествующий каждому значению.
• *...* — необязательный блок, заключенный в буквенные звездочки, в котором можно указать детали форматирования чисел. Следующие значения поддерживаются и являются необязательными:
  • <number_type> — числовой формат для числовых значений. Выберите один из следующих вариантов:
    • f - [ По умолчанию ] Формат с плавающей запятой. Также рассмотрите возможность указания точности с помощью значения < decimal_places >.
    • p — процентный формат. Знак % добавляется автоматически. Примечание. При использовании этого формата значения данных от 0,0 до 1,0 преобразуются в значения от 0 до 100 % (например, 0,43 будет отображаться как 43 %).
    • e - Формат научной записи.
    • c< CUR > — форматирует число в указанной валюте с соответствующим маркером валюты. Замените < CUR > трехбуквенным кодом валюты. Пример: cEUR для евро. Список кодов можно найти на веб-сайте ISO , хотя поддерживаются не все символы.
  • <decimal_places> — целое число, определяющее количество отображаемых десятичных знаков. Значение округляется (не усекается) до этой длины. По умолчанию — 2.
  • z — отображать конечные нули. По умолчанию нет .
  • s — Отобразить разделители групп. По умолчанию нет .
  • x или y — отображение данных по координатам x или y, как указано. Значение данных x зависит от типа диаграммы: поэкспериментируйте с диаграммой, чтобы определить, что они означают. По умолчанию — «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 (январь, февраль, март).	chxt=x,y,r,x chxr=2,0,4 chxl=3:|Jan|Feb|Mar| 1:|min|average|max chxp=1,10,35,75 chxs=3,0000DD,13,0,t
Размер, цвет и выравнивание шрифта указаны для правой оси Y. Отрисовываются деления, но не линия оси.	chxt=x,y,r,x chxl=3:|Jan|Feb|Mar| 2:|min|average|max chxp=2,10,35,95 chxs=2,0000DD,13,-1,t,FF0000
Эта диаграмма включает в себя три набора данных и показывает три набора меток оси, по одному на серию. Каждый набор меток форматируется с использованием пользовательской строки форматирования, как описано здесь: 0N*e,000000| 0 означает первую серию данных N означает форматирующую строку * означает начало спецификаторов формата e означает научную нотация * означает конец спецификаторов формата 000000 означает черный текст. 1N*cUSD*Mil,FF0000| 1 означает вторую серию N означает форматирующую строку * означает начало спецификаторов формата c означает валютный маркер USD указывает доллар США как валютный маркер для использования * означает конец спецификаторов формата Mil - буквальная следующая строка FF0000 означает красный текст. 2N*sz2*,0000FF 2 означает третью серию N означает форматирующую строку * означает начало спецификаторов формата s означает показать спецификаторы группы (в американском английском локале, это запятая каждые три нуля) z2 означает показать два сцепления 0000FF означает синий текст. Диапазоны метки оси устанавливаются с использованием параметра chxr ( axis_index , start , end , step ). Если бы не было установлено, они были бы 0—100 по умолчанию.	chd=s: 984sttvuvkQIBLKNCAIi, DEJPgq0uov17zwopQODS, AFLPTXaflptx159gsDrn chxr= 0,0,1000000,250000| 1,0,60| 2,0,5000 chxs= 0N*e,000000| 1N*cUSD*Mil,FF0000| 2N*sz2*,0000FF

Вернуться наверх

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 для создания длинных красных отметок. Длина отметки клещей здесь превышает ширину площади диаграммы, но обрезана, чтобы помещаться в диаграмму. chxt=x,y,r,x - показывают левую ось, правую ось и две нижние оси. chxl =2:|min|average|max|3:|Jan|Feb|Mar - текст ярлыка, назначенный 'r' (правая сторона) и внешние оси x. chxp =2,10,35,95 - Постоянные позиции метки вдоль оси R (index = 2) для трех меток. chxs=2,0000dd,13,-1,t,FF0000 -Стили метки оси для оси R: цвет текста, размер текста, выровненная левая, с красными отметками. chxtc=1,10|2,-180 длина клещей оси для оси y- и r. Первое значение определяет 10 пиксельных клещей за пределами оси. Второе значение указывает клещей длиной 180 пикселей внутри оси; Отрицательное число означает, что клеща проходит внутрь оси, а клеща обрезается, чтобы помещать в диаграмму.	chxt=x,y,r,x chxl= 2:|min|average|max| 3:|Jan|Feb|Mar chxp=2,10,35,95 chxs= 2,0000dd,13,-1,t,FF0000 chxtc=1,10|2,-180
Эта диаграмма демонстрирует чередующуюся длину клещей. chxtc указывает два значения длины клещей для оси Y (5 и 15), а клещи, нарисованные на диаграмме, чередуются между двумя значениями.	chxt=x,y chxtc= 1,5,15

Вернуться наверх

Фон заполняет chf [ все диаграммы ]

Вы можете указать цвета заполнения и стили для области данных диаграммы и/или всего фона диаграммы. Типы заполнения включают в себя сплошные заполнения, полосатые наполнения и градиенты. Вы можете указать разные заливки для разных областей (например, вся область диаграммы или только область данных). Область диаграммы заполняет перезапись фоновой заполнения. Все заполнения указываются с использованием параметра chf , и вы можете смешивать различные типы заполнения (твердые вещества, полосы, градиенты) в одной и той же диаграмме, разделяя значения с символом трубы (|). Область диаграммы заполняет перезапись фона карты.

Solid Fills chf [ все диаграммы ]

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

Синтаксис

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

<illy_type>

Часть графика заполнена. Укажите одно из следующих значений:

• bg - фоновая заполнение
• c - заполнение области диаграммы. Не поддерживается для карт карт.
• a - Сделайте всю диаграмму (включая фон) прозрачной. Первые шесть цифр < color > игнорируются, и только последние два (значение прозрачности) применяются ко всей диаграмме и все заполнения.
• b <index> - сплошные наполнения (только сплоченные диаграммы). Замените <Index> на индекс серии стержней, чтобы заполнить сплошным цветом. Эффект аналогичен указанию chco в батонной диаграмме. См. Цвета серии барных карт для примера.

с

Указывает твердое или прозрачность заполнения.

< цвет >

Цвет заполнения в шестнадцатеричном формате Rrggbb . Для прозрачных пленок первые шесть цифр игнорируются, но все равно должны быть включены.

Примеры

Вернуться наверх

Градиент заполняет 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 (верхний или правый край), наклонен под углом, указанным под углом >.

Примеры

Вернуться наверх

Полосы заполняют 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 - полная ширина диаграммы. Полосы повторяются до тех пор, пока диаграмма не будет заполнена. Повторите < цвет > и < ширина > для каждой дополнительной полосы. У вас должно быть как минимум две полосы. Полосы чередуются до тех пор, пока диаграмма не будет заполнена.

Примеры

Описание	Пример
bg,ls,0 -Фоновая полоса заполняется полосами под углом нулевой степени до оси Y (параллельно оси Y). Полосы заполняют фон графика, а также область сюжета. CCCCCC,0.15 - Первая полоса темно -серая, 15% шириной, чем диаграмма. FFFFFF,0.1 - Вторая полоса белая, 10% шириной, чем диаграмма.	chf= bg,ls,0, CCCCCC,0.15, FFFFFF,0.1
c,ls,90 - Область диаграммы с горизонтальными полосами под углом девяносто градусов от оси Y. Полосы заполняют область сюжета, но фон графика опущен. 999999,0.25 - Первая полоса темно -серая, 25% шириной, чем диаграмма. CCCCCC,0.25 - такая же, как первая полоса, но более легкая серая. FFFFFF,0.25 - то же самое, что и первая полоса, но белая.	chf= c,ls,90, 999999,0.25, CCCCCC,0.25, FFFFFF,0.25

Вернуться наверх

Функции данных 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 вместо + в ваших функциях!

Примеры

Описание	Пример
Простая синусоидальная волна. Некоторые вещи, которые нужно заметить: chd=t:-1 - Мы используем фиктивную переменную для данных диаграммы, потому что наши данные объявлены в параметре chfd . chco=FF0000 - Красный указан для первой серии. Несмотря на то, что мы не используем данные из chd , соответствующий цвет для этой серии будет использоваться для этой настроенной функции. chfd=0,x,0,11,0.1,sin(x)*50%2B50 - мы объявляем одну переменную, называемую x, со значениями 0—11, увеличенные на 0,1. Он назначен первой серии, что означает, что он получит цвет первой серии (FF0000). Функция, применяемая к x, - это sin (x) * 50 + 50. Обратите внимание, как мы должны кодировать + в этой функции.	cht=lc chd=t:-1 chco=FF0000 chfd= 0,x,0,11,0.1,sin(x)*50%2B50 chxt=x,y
Эта строка использует данные из chd -параметра.	chd=t:5,10 chfd=0,x,0,x*4
Смесь функции и нефункциональных линий. Обратите внимание, как цвета определяются с помощью параметра CHCO серии chco . Обратите внимание на размещение маркеров на вывод функции; Точки данных рассчитываются из начала , конца и шага , поэтому, если ваш диапазон составляет 0–11 шаг 0.1, точка 0 равен 0, точка 1 составляет 0,1 и т. Д., До точки 110, что составляет 11.	chd=t: -1 15,45 chco= FF0000,000000 chfd= 0,x,0,11,0.1,sin(x)*50%2B50 chm= c,00A5C6,0,110,10 a,00A5C6,0,60,10
Чтобы определить функцию в двух измерениях, используйте диаграмму lxy , назначьте две фиктивные серии и назначьте функцию каждому. 0,x,0,10,0.1,sin(x)*50%2B50 - series 0 (значения оси x) имеет переменную с именем x, со значениями от 0–10, шаг 0.1 и функция sin (x )*50 + 50 0,y,0,10,0.1,sin(y)*50%2B50 - series 0 (значения оси Y) имеет переменную с именем y, со значениями от 0–10, шаг 0.1 и функция sin (x )*50 + 50	cht=lxy chd=t:-1|-1 chfd= 0,x,0,10,0.1,sin(x)*50%2B50| 1,y,0,10,0.1,cos(y)*50%2B50
Параметр chfd действительно может позволить вам выразить ваше творчество. Попробуйте щелкнуть эти изображения, чтобы открыть и поиграть с ними на детской площадке; Вы получите подключение!

Вернуться наверх