Точка

{
  "data": ... ,
  "mark": "point",
  "encoding": ... ,
  ...
}

Примитив point отображает каждую запись данных отдельным символом. Чаще всего точки используют в диаграммах рассеяния.

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

Свойства точки

// Спецификация одиночного представления
{
  ...,
  "mark": {
    "type": "point",
    ...
  },
  "encoding": ... ,
  ...
}

Помимо общих свойств примитивов, точка поддерживает:

Свойство Тип Описание
shape SymbolShape, string, ExprRef Форма точек. Поддерживаются:
• обычные символы "circle", "square", "cross", "diamond", "triangle-up", "triangle-down", "triangle-right", "triangle-left";
• линейный символ "stroke";
• центрированные направленные фигуры "arrow", "wedge", "triangle";
• собственная строка пути SVG. Для правильного размера путь должен помещаться в квадрат с координатами от −1 до 1 по X и Y.

По умолчанию: "circle".
size number, ExprRef Размер примитива по умолчанию, неотрицательный.

• Для point, circle, square — площадь символа в квадратных пикселях. Длина стороны растёт пропорционально квадратному корню из этого значения.
• Для bar — ширина полосы столбца в пикселях.
• Для text — размер шрифта в пикселях.

По умолчанию: 30 для point, circle, square; step - 2 для столбцов с дискретным измерением (шаг ширины или высоты минус 2 пикселя); 5 для столбцов с непрерывным измерением; 11 для текста.

Примеры

Точечная диаграмма

Если поле данных сопоставлено только с каналом x или только с y, получается одномерная точечная диаграмма:

Диаграмма рассеяния

Сопоставление полей одновременно с x и y создаёт диаграмму рассеяния:

По умолчанию точка прозрачна внутри и имеет только обводку. Для заливки задайте filled: true:

Пузырьковая диаграмма

Сопоставив третье поле с каналом size диаграммы рассеяния, можно получить пузырьковую диаграмму.

Цвет и форма

Поля диаграммы рассеяния также можно кодировать каналами color и shape. В этом примере поле Origin одновременно определяет цвет и форму точек:

Случайное смещение точек

На дискретной шкале точки могут накладываться друг на друга. Небольшое случайное смещение позволяет показать плотность записей:

Векторы ветра

Точки с кодированием угла позволяют создать карту векторов ветра.

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

Каналы longitude и latitude вместе с географической проекцией размещают точки по координатам. Здесь показаны крупные аэропорты США:

Настройка точек

// Спецификация представления верхнего уровня
{
  ...,
  "config": {
    "point": ...,
    ...
  }
}

Свойство point объекта config верхнего уровня задаёт значения по умолчанию для всех точек. Каналы свойств примитива переопределяют эти значения.

Конфигурация может содержать любые свойства точек, кроме type, style и clip.