Данные

Как и модель данных Vega, основная модель данных Vega-Lite использует табличные данные, похожие на электронную таблицу или таблицу базы данных. Набор данных состоит из записей; каждая запись может содержать любое число именованных полей.

Свойство data задаёт источник данных внутри спецификации. Можно передать записи прямо в спецификации через values, указать адрес файла через url или объявить именованный источник через name. Именованный источник можно создать пустым и заполнить во время выполнения либо через свойство верхнего уровня datasets.

Кроме того, Vega-Lite включает генераторы данных, которые создают наборы данных: например, числовые последовательности или географические объекты в формате GeoJSON — координатную сетку и сферу.

Содержание страницы

• Встроенные данные
• Данные по адресу URL
• Именованные источники
• Форматы файлов
  • JSON
  • CSV
  • TSV
  • DSV
  • TopoJSON
• Генераторы данных
  • Числовая последовательность
  • Географическая сетка
  • Сфера
• Наборы данных в datasets

Виды источников данных

Встроенные данные

Для встроенных данных укажите массив записей в values:

В следующей спецификации прямо записана таблица из девяти строк и двух столбцов — a и b:

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

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

Можно встроить и текстовую строку; её содержимое будет разобрано по указанному типу формата:

Данные по адресу URL

Свойство url указывает файл с данными. Тип входного файла можно уточнить через format.type; если формат не задан, Vega-Lite определяет его по расширению файла.

Следующий пример загружает cars.json. Формат "json" определяется автоматически:

Именованные источники данных

Данные можно добавить во время выполнения через API представления Vega. Задайте имя в data.name:

{
  "name": "myData"
}

Используйте API представления Vega, чтобы загрузить данные во время выполнения и обновить диаграмму. Вот пример с Vega-Embed:

vegaEmbed('#vis', spec).then((res) => {
  const data = [/* массив записей */];
  res.view.insert('myData', data).run();
});

Можно также изменять данные диаграммы через набор изменений (changeset), как в примере потоковой передачи данных.

Формат данных

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

JSON

Файл JSON обычно содержит массив объектов с именованными полями. Это формат по умолчанию, используемый при отсутствии свойства format. Если format указан, его свойство type должно иметь значение "json". Кроме того, поддерживается следующее свойство:

CSV

Загрузка файла со значениями, разделёнными запятыми (CSV). Дополнительные свойства не поддерживаются.

TSV

Загрузка файла со значениями, разделёнными табуляцией (TSV). Дополнительные свойства не поддерживаются.

DSV

Загрузка текстового файла с произвольным разделителем. Это обобщённый вариант CSV и TSV.

TopoJSON

Vega-Lite загружает корректный файл TopoJSON и преобразует его в GeoJSON. Выберите один из двух способов извлечения географических объектов:

Свойства feature и mesh взаимоисключающие.

Генераторы данных

Числовая последовательность

Генератор sequence создаёт числа от start до stop с шагом step. Верхняя граница не включается. По умолчанию каждое число помещается в поле data; свойство as меняет его имя.

Пример генерирует числовую область и строит синусоиду с помощью преобразования calculate:

Географическая сетка

Географическая сетка состоит из линий широты и долготы. Генератор graticule создаёт её в формате GeoJSON. Значение true использует настройки по умолчанию; объект позволяет задать параметры:

В примере пользовательская сетка показана с ортографической проекцией:

Сфера

Объект GeoJSON {"type": "Sphere"} обозначает весь земной шар. Генератор sphere добавляет набор данных с одной такой записью. Содержимое набора — [{"type": "Sphere"}]. Сфера может служить фоновым слоем карты, обозначающим поверхность Земли. Единственное свойство генератора задаётся значением true или пустым объектом {}.

Следующий пример строит карту из двух слоёв: светло-голубой сферы и чёрной географической сетки.

Наборы данных в datasets

Свойство верхнего уровня datasets хранит несколько встроенных наборов данных по именам. Это удобно, если один набор нужен в разных местах спецификации: определите его один раз и обращайтесь к нему через data.name.

    "datasets": {
      "somedata": [1,2,3]
    },
    "data": {
      "name": "somedata"
    }