Данные

Определения наборов данных и преобразований задают, какие данные загружать и как их обрабатывать.

Основная модель данных Vega — таблица, похожая на электронную таблицу или таблицу базы данных. Набор данных состоит из записей («строк»). Каждая запись может содержать любое число именованных атрибутов — полей, или «столбцов». Записи представлены обычными объектами JavaScript.

Если входные данные — простой массив примитивных значений, Vega помещает каждое значение в свойство data нового объекта. Например, массив [5, 3, 8, 1] загружается так:

[ {"data": 5}, {"data": 3}, {"data": 8}, {"data": 1} ]

При загрузке Vega также присваивает каждому объекту данных уникальный идентификатор, доступный через специальный Symbol. Поэтому к свойству идентификатора нельзя обратиться по строковому ключу и оно не перечисляется при обходе объекта, хотя его значение можно увидеть при изучении данных в консоли JavaScript.

Набор данных можно задать непосредственно в спецификации или указать URL-адрес для его загрузки. Также данные можно связать с визуализацией динамически во время работы: передать их при создании графика или обновлять потоком через API представления. Загрузка по URL подчиняется правилам среды выполнения, например ограничениям на междоменные запросы.

Содержание

• Свойства набора данных
• Форматы данных
• Примеры

Свойства набора данных

Свойства, задающие набор данных. Из полей source, url и values можно указать не более одного.

Динамическая загрузка данных

≥ 4.2 Начиная с Vega 4.2 параметры данных url и format (если данные загружаются по URL) могут содержать ссылки на сигналы. Это позволяет во время работы динамически менять адрес источника или параметры формата и повторно загружать данные. Например, одна спецификация может выбирать набор данных по вводу пользователя или периодически опрашивать источник с помощью потока событий timer.

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

Формат

Объект format описывает формат данных и дополнительные правила разбора.

json

Загружает файл JavaScript Object Notation (JSON). Предполагается, что данные организованы по строкам, каждая из которых — объект с именованными атрибутами. Это формат по умолчанию, если параметр format не задан. При явном указании format его свойство type должно иметь значение "json". Дополнительно доступны следующие свойства:

csv

Загружает файл CSV со значениями, разделёнными запятыми.

tsv

Загружает файл TSV со значениями, разделёнными табуляцией.

dsv

Загружает текстовый файл с указанным пользователем разделителем.

topojson

Загружает файл JSON в формате TopoJSON. Входной файл должен содержать корректные данные TopoJSON. Для работы в Vega они преобразуются в GeoJSON. Процесс преобразования можно задать одним из двух взаимоисключающих свойств:

Примеры

Пример данных, заданных непосредственно в спецификации:

{"name": "table", "values": [12, 23, 47, 6, 52, 19]}

Данные также можно загрузить из внешнего файла, в данном случае JSON:

{"name": "points", "url": "data/points.json"}

Можно объявить набор данных без значений и передать их динамически при создании визуализации. Подробнее см. документацию API представления.

{"name": "table"}

Наконец, можно взять существующий набор и применить к нему преобразования. В этом примере новый набор "stats" создаётся путём вычисления агрегированных показателей для групп данных из исходного набора "table":

{
  "name": "stats",
  "source": "table",
  "transform": [
    {
      "type": "aggregate",
      "groupby": ["x"],
      "ops": ["average", "sum", "min", "max"],
      "fields": ["y", "y", "y", "y"]
    }
  ]
}