Диаграммы Венна

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

Оглавление

Особенности диаграммы Введение Типы диаграмм ( cht ) Цвета серии ( chco )

Стандартные функции Название диаграммы ( chtt , chts ) Текст и стиль легенды диаграммы ( chdl , chdlp , chdls ) Поля диаграммы ( chma ) Фоновая заливка ( chf ) Сплошная заливка ( chf ) Градиентные заливки ( chf ) Полосатые заливки ( chf )

Введение

Диаграммы Венна представляют собой диаграммы с перекрывающимися кружками, которые показывают, сколько общего имеют разные группы. Charts поддерживает диаграммы Венна с двумя или тремя кругами. Вы указываете относительные размеры кругов и степень перекрытия между ними.

Типы диаграмм ( cht )

Задайте диаграмму Венна со следующим синтаксисом:

Синтаксис

cht=v

Строка данных представляет собой набор из семи элементов, разделенных разделителем, соответствующим вашему формату данных , как описано здесь:

• Первые три значения определяют размеры трех кругов: A, B и C. Для диаграммы только с двумя кругами укажите ноль для третьего значения.
• Четвертое значение определяет размер пересечения A и B.
• Пятое значение определяет размер пересечения A и C. Для диаграммы только с двумя кругами не указывайте здесь значение.
• Шестое значение определяет размер пересечения B и C. Для диаграммы только с двумя кругами не указывайте здесь значение.
• Седьмое значение определяет размер общего пересечения A, B и C. Для диаграммы только с двумя кругами не указывайте здесь значение.

Обратите внимание, что в диаграммах Венна все значения пропорциональны, а не абсолютны. Это означает, что диаграмма со значениями 10,20,30 будет выглядеть так же, как диаграмма со значениями 100,200,300 (если ваш тип кодировки принимает эти значения).

Описание	Пример
Трехкруговая диаграмма Венна.	cht=v chd=t:100,80,60,30,30,30,10
Чтобы указать диаграмму из двух кругов, укажите ноль для круга C и не указывайте значения перекрытия, включающие C.	cht=v chd=t:100,100,0,50

Серия Цвета chco

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

Синтаксис

chco=<color_1>,...,<color_n>

< цвет >

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

Описание	Пример
Разный цвет для каждого круга.	chco=FF6342,ADDE63,63C6DE
Если цветов меньше, чем кругов, повторяется последний указанный цвет. Однако это затрудняет чтение диаграммы.	chco=00FF00,0000FF

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

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

Цветовой формат

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

• FF0000 = Красный
• 00FF00 = Зеленый
• 0000FF = Синий
• 000000 = Черный
• FFFFFF = Белый

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

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

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

Название графика 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 .

< размер >

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

Примеры

Описание	Пример
Два примера легенд. Укажите текст легенды в том же порядке, что и ряд данных.	chdl=NASDAQ|FTSE100|DOW chco=FF0000,00FF00,0000FF chdl=First|Second|Third chco=ff0000,00ff00,0000ff
На первой диаграмме показаны записи горизонтальной легенды ( chdlp=t , макет по умолчанию — горизонтальный), а на второй — нижние записи вертикальной легенды ( chdlp=bv ).	chdl=First|Second|Third chco=ff0000,00ff00,0000ff chdlp=t chdl=First|Second|Third chco=ff0000,00ff00,0000ff chdlp=bv
В этом примере показано изменение размера шрифта.	chdls=0000CC,14

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

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

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

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

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

Синтаксис

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

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

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

<opt_legend_width> , <opt_legend_height>

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

Примеры

Описание	Пример
В этом примере диаграмма имеет минимальное поле в 30 пикселей с каждой стороны. Поскольку ширина легенды диаграммы превышает 30 пикселей, поле справа устанавливается на ширину легенды диаграммы и отличается от других полей. Метки осей находятся за пределами области графика и поэтому рисуются внутри поля.	chma=30,30,30,30
Чтобы добавить поле вокруг легенды, установите значение для параметров < opt_legend_width > и < opt_legend_height > . В этом примере ширина легенды составляет примерно 60 пикселей. Если вы установите для < opt_legend_width > значение 80 пикселей, поле расширится до 20 пикселей за пределами легенды.	chma=20,20,20,30|80,20

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

Фоновые заливки chf [ Все графики ]

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

Сплошные заливки chf [ Все графики ]

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

Синтаксис

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

< тип_заполнения >

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

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

с

Указывает сплошную или прозрачную заливку.

< цвет >

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

Примеры

Описание	Пример
В этом примере фон диаграммы заливается бледно-серым цветом ( EFEFEF ).	chf=bg,s,EFEFEF
В этом примере фон диаграммы заливается бледно-серым цветом ( EFEFEF ), а область диаграммы заливается черным ( 000000 ).	chf=c,s,000000| bg,s,EFEFEF
В этом примере ко всей диаграмме применяется прозрачность 50 % (80 в шестнадцатеричном формате равно 128, или прозрачность около 50 %). Обратите внимание на фон ячейки таблицы, просвечивающий через диаграмму.	chf=a,s,00000080

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

Градиентная заливка chf [ Линия, Столбец, Google-o-meter, Радар, Разброс, Венн ]

К областям диаграммы или фону можно применить одну или несколько градиентных заливок. Градиентная заливка — это переход от одного цвета к другому. (Круговые диаграммы Google-o-meter: только фон.)

Каждая градиентная заливка определяет угол, а затем два или более цветов, привязанных к указанному местоположению. Цвет меняется по мере перемещения от одного якоря к другому. У вас должно быть как минимум два цвета с разными значениями <color_centerpoint> , чтобы один мог плавно переходить в другой. Каждый дополнительный градиент определяется парой <color> , <color_centerpoint> .

Синтаксис

chf=<fill_type>,lg,<angle>,<color_1>,<color_centerpoint_1>
    ,...,
  <color_n>,<color_centerpoint_n>

< тип_заполнения >

Область диаграммы для заполнения. Одно из следующих:

• bg — заливка фона
• c - Заливка области диаграммы.
• b <index> — градиентная заливка столбцов (только гистограммы). Замените <index> индексом серии столбцов, которые нужно заполнить градиентом. Пример см. в разделе «Цвета серии гистограмм» .

LG

Определяет градиентную заливку.

< угол >

Число, определяющее угол градиента от 0 (по горизонтали) до 90 (по вертикали).

< цвет >

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

<color_centerpoint>

Указывает точку привязки для цвета. С этой точки цвет начнет тускнеть по мере приближения к другому якорю. Диапазон значений составляет от 0,0 (нижний или левый край) до 1,0 (верхний или правый край), наклоненный под углом, заданным < угол >.

Примеры

Описание	Пример
Область диаграммы имеет горизонтальный линейный градиент, заданный с углом в ноль градусов ( 0 ). Цвета: персиковый ( FFE7C6 ), центрированный слева (позиция 0.0 ), и синий ( 76A4FB ), центрированный справа (позиция 1.0 ). Фон диаграммы нарисован серым цветом ( EFEFEF ).	chf= c,lg,0, FFE7C6,0, (персик) 76A4FB,1 (синий)
Область диаграммы имеет диагональный линейный градиент (снизу слева направо) с углом в сорок пять градусов ( 45 ). Персиковый ( FFE7C6 ) — первый указанный цвет. Левый нижний угол диаграммы — чисто персиковый. Синий ( 6A4FB ) — второй указанный цвет. Правая верхняя часть диаграммы окрашена в чистый синий цвет. Обратите внимание, как мы указываем смещение 0,75, чтобы обеспечить пик синего цвета, который исчезает к верхнему правому углу. Фон диаграммы нарисован серым цветом ( EFEFEF ).	chf= c,lg,45, FFE7C6,0, (персик) 76A4FB,0.75 (синий)
Область диаграммы имеет вертикальный (сверху вниз) линейный градиент, заданный с углом девяносто градусов ( 90 ). Синий ( 76A4FB ) — это первый указанный цвет. Верхняя часть диаграммы чисто синего цвета. Персиковый ( FFE7C6 ) — второй указанный цвет. Нижняя часть диаграммы чисто персиковая. Фон диаграммы нарисован серым цветом ( EFEFEF ).	chf= c,lg,90, FFE7C6,0, (персик) 76A4FB,0.5 (синий)

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

Полосатая заливка chf [ Линия, Бар, Гугл-о-метр, Радар, Разброс, Венн ]

Вы можете указать полосатую фоновую заливку для области диаграммы или всей диаграммы. (Круговые диаграммы Google-o-meter: только фон.)

Синтаксис

chf=
  <fill_type>,ls,<angle>,<color_1>,<width_1>
    ,...,
  <color_n>,<width_n>

< тип_заполнения >

Область диаграммы для заполнения. Одно из следующих:

• bg — заливка фона
• c - Заполнение области диаграммы
• b <index> — полосатая заливка (только гистограммы). Замените <index> индексом серии столбцов, которые будут заполнены полосами. Пример см. в разделе «Цвета серии гистограмм» .

лс

Задает заливку линейными полосами.

< угол >

Угол всех полос относительно оси Y. Используйте 0 для вертикальных полос или 90 для горизонтальных полос.

< цвет >

Цвет этой полосы в шестнадцатеричном формате RRGGBB . Повторите < цвет > и < ширину > для каждой дополнительной полосы. У вас должно быть как минимум две полоски. Полосы чередуются, пока диаграмма не заполнится.

< ширина >

Ширина этой полосы от 0 до 1 , где 1 — полная ширина диаграммы. Полосы повторяются до тех пор, пока диаграмма не заполнится. Повторите < цвет > и < ширину > для каждой дополнительной полосы. У вас должно быть как минимум две полоски. Полосы чередуются, пока диаграмма не заполнится.

Примеры

Описание	Пример
bg,ls,0 — фоновая полоса заполняется полосами под углом 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

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