Документация
Грамматика визуализации Vega предоставляет базовые средства для создания разных визуализаций. Здесь описаны спецификации Vega в формате JSON и API JavaScript.
Чтобы познакомиться с Vega, рекомендуем сначала пройти вводный урок «Создадим столбчатую диаграмму» и изучить галерею примеров. Затем можно переходить к справочнику. Эти страницы описывают Vega версии 3.0 и новее. Если вы работали с Vega 2.x, начните с руководства по переходу с Vega 2.
Справочник по спецификации
Спецификация Vega — это объект JSON, описывающий интерактивную визуализацию. Спецификация содержит основные свойства, например ширину и высоту представления, а также определения данных, шкал, осей, легенд, картографических проекций, графических примитивов и сигналов. Сигналы позволяют обрабатывать действия пользователя и изменять визуализацию в ответ.
| Раздел | Описание |
|---|---|
| Спецификация | Общая структура спецификации Vega, размеры и метаданные. |
| Конфигурация | Значения по умолчанию для визуального кодирования. |
| Данные | Определение, загрузка и разбор данных. |
| Преобразования | Фильтрация, сортировка, агрегирование и размещение данных перед визуализацией. |
| Триггеры | Изменение наборов данных или свойств примитивов при изменении сигналов. |
| Проекции | Картографические проекции для координат долготы и широты. |
| Шкалы | Отображение значений данных в координаты, цвета и размеры. |
| Цветовые схемы | Палитры, используемые в диапазонах шкал. |
| Оси | Отображение пространственных шкал с помощью координатных осей. |
| Легенды | Отображение кодирования цветом, формой и размером. |
| Заголовок | Заголовок визуализации. |
| Примитивы | Графическое представление данных прямоугольниками, линиями, символами и другими объектами. |
| Сигналы | Динамические переменные для интерактивных обновлений. |
| Потоки событий | Определение событий ввода для взаимодействия. |
| Выражения | Пользовательские вычисления над данными и сигналами. |
| Размещение | Размещение групп примитивов в сетке. |
| Типы | Часто встречающиеся типы параметров. |
Справочник по API Vega
Vega также предоставляет API среды выполнения JavaScript. Этот API разбирает спецификации JSON и создаёт интерактивные представления на основе реактивного графа потока данных, состоящего из операторов обработки данных. Подробнее о подключении Vega читайте в разделе «Использование».
| Раздел | Описание |
|---|---|
| Парсер | Преобразование спецификаций Vega в описание потока данных. |
| Представление | Создание интерактивного представления из описания потока данных. |
| Локаль | Форматирование чисел и дат для выбранной локали. |
| Расширение | Добавление проекций, шкал, цветовых схем и преобразований данных. |
| Статистика | Статистические методы Vega. |
| Время | Вспомогательные методы для дат и времени. |
| Утилиты | Общие утилиты JavaScript. |
| Отладка | Поиск ошибок в визуализациях Vega во время выполнения. |