Перейти к содержанию

Язык описания диаграмм

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

  • Круговая диаграмма – это диаграмма в форме круга, которая разделена на сектора для иллюстрации числовой пропорции.
  • Линейная диаграмма – это диаграмма, построенная по значениям на осях абсцисс и ординат в виде линии.
  • Столбчатая диаграмма – это диаграмма, построенная по значениям на осях абсцисс и ординат в виде столбцов.

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

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

Синтаксис

Ключевое слово для создания этого типа диаграммы – pie (из-за внешнего сходства с нарезанным пирогом).

Общий вид описания:

pie tittle Название диаграммы
    "Название категории 1" : значение
    "Название категории 2" : значение
    "Название категории 3" : значение

Значение – обязательно положительное число. Если велечина не целая, то используется точка в качестве разделителя (до двух знаков после точки):

Правильно Неправильно
0.38
  • 0,38
  • -0.38

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

Пример

Создадим круговую диаграмму (pie):

  • Отобразим значения после текста легенды (showData);
  • Название диаграммы (title) – «Состав атмосферы Земли»;
  • Категории – "Азот", "Кислород" и "Другие газы".
pie showData
    title Состав атмосферы Земли
    "Азот" : 77
    "Кислород" : 20
    "Другие газы" : 3

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

Линейная диаграмма

Линейная диаграмма представляет собой ряд точек данных, соединенных линией.

Синтаксис

Ключевое слово для создания этого типа диаграммы – xychart-beta.

Общий вид описания: 

xychart-beta
    title "Название диаграммы"
    x-axis [категория_1, категория_2, категория_3, категория_4, категория_5]
    y-axis "Название оси Y" минимальное_значение --> макисмальное_значение
    bar [значение_x_1, значение_x_2, значение_x_3, значение_x_4, значение_x_5]
    line [значение_x_1, значение_x_2, значение_x_3, значение_x_4, значение_x_5]

Ось X и значения в bar и/или line взаимосвязаны: первое значение соответствует первой категории оси X.

Ориентация

По умолчанию ориентация диаграммы вертикальная (vertical) – ось Y располагается вертикально. При необходимости ось Y можно сделать горизонтальной: 

xychart-beta horizontal

Название

Команда title задаёт название диаграммы. Оно отображается сверху и представляет собой её краткое описание:

xychart-beta
    title "Название диаграммы"

Название можно дать не только диаграмме, но и осям: 

x-axis Название 
y-axis "Название оси Y"

Ось X

Ось X в основном отвечает за категориальные значения (текстовый тип):

x-axis [категория_1, "название категории 2", категория_3]

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

x-axis минимальное_значение --> макисмальное_значение

Ось Y

Ось Y используется только для представления числовых значений: 

y-axis минимальное_значение --> макисмальное_значение

Осям необязательно задавать диапазон или названия категорий: система автоматически подберёт их, согласно введённым значениям в line и/или bar.

Значения

Для ввода значений в линейной диаграмме используется команда line:

line [2.3, 45, .98, -3.4]

Столбчатая диаграмма

Столбчатая диаграмма представляет собой ряд точек данных в виде столбцов.

Синтаксис

Столбчатая и линейная диаграммы – это диаграммы вида XY, поэтому синтаксис их написания практически не отличается. Различие между ними заключается в команде ввода отображаемых значений:

Линейная диаграмма Столбчатая диаграмма
line [10, 20, 30, 40] bar [10, 20, 30, 40]

Подробный синтаксис Вы можете прочитать здесь.

Пример

Линейную и столбчатую диаграммы можно совместить: для этого необходимо задать значения и для line [], и для bar [].

Создадим диаграмму XY:

  • Название (title) – «Размер планет Солнечной системы» ;
  • Категории (x-axis []): "Меркурий", "Венера", "Нептун", "Сатурн", "Юпитер", "Уран", "Земля", "Марс";
  • Она содержит как линейную диаграмму (line []), так и столбчатую (bar []).
xychart-beta
    title "Размер планет Солнечной системы"
    x-axis ["Меркурий", "Венера", "Нептун", "Сатурн", "Юпитер", "Уран", "Земля", "Марс"]
    bar [2.4, 6, 25, 60, 70, 25.4, 6.4, 3.4]
    line [2.4, 6, 25, 60, 70, 25.4, 6.4, 3.4]

Диаграмма XY

К началу