Преобразование kde
Преобразование kde ≥ 5.4 выполняет одномерную ядерную оценку плотности входного потока данных и создаёт равномерно расположенные выборки полученной плотности. В отличие от родственного преобразования density, оно поддерживает группировку и масштабирование плотности для отображения как вероятностей, так и сглаженных количеств.
Параметры преобразования
| Свойство | Тип | Описание |
|---|---|---|
| field | Field | Обязательно. Поле данных, для которого оценивается плотность. |
| groupby | Field[ ] | Поля для группировки. Если не заданы, все объекты данных образуют одну группу. |
| cumulative | Boolean | Выводить обычную оценку плотности (false, по умолчанию) или накопленную (true). |
| counts | Boolean | Выводить оценку вероятности (false, по умолчанию) или сглаженное количество (true). |
| bandwidth | Number | Необязательная ширина гауссова ядра. При 0 (по умолчанию) она автоматически оценивается по входным данным по правилу Скотта. |
| extent | Number[ ] | Диапазон [min, max], из которого берутся точки выборки распределения. Если не задан, определяется по минимальному и максимальному значениям наблюдаемого поля. |
| minsteps | Number | Минимальное число точек выборки вдоль диапазона extent для построения плотности (по умолчанию 25). |
| maxsteps | Number | Максимальное число точек выборки вдоль диапазона extent для построения плотности (по умолчанию 200). |
| resolve | String | Способ согласования параметров нескольких плотностей. При "independent" (по умолчанию) у каждой плотности могут быть свой диапазон extent и число точек steps. При "shared" для всех плотностей используются общие диапазон и шаг кривой, что позволяет складывать их. ≥ 5.5 |
| steps | Number | Точное число равномерных точек выборки вдоль диапазона extent. Переопределяет minsteps и maxsteps. Вместе с фиксированным диапазоном помогает получить одинаковые точки для плотностей с накоплением. |
| as | String[ ] | Имена выходных полей со значением выборки и соответствующей плотностью (по умолчанию ["value", "density"]). |
Использование
Оценивает плотность значений поля value с автоматически выбранной шириной ядра отдельно для групп, заданных полем key:
{
"type": "kde",
"groupby": ["key"],
"field": "value"
}