RU Гистограмма - Mingun/d3 GitHub Wiki

Вики ▸ Справка по API ▸ Компоновки ▸ Гистограмма
English | Русский

Гистограмма показывает распределение данных, группируя отдельные точки данных в корзины. Смотрите bl.ock 3048450 для примера использования.

# d3.layout.histogram()

Конструирует новую гистограмму с функциями доступа по умолчанию к значению, диапазону и корзинке. По умолчанию гистограмма возвращает частоты. Возвращённый объект компоновки является одновременно объектом и функцией. Это значит, что вы можете вызвать компоновку как и любую другую функцию и в тоже время компоновка имеет дополнительные методы, изменяющие её поведение. Подобно другим классам в D3, компоновки следуют шаблону цепочечных методов, по которому методы-установщики возвращают саму компоновку, что позволяет выполнять несколько сеттеров в лаконичном выражении.

# histogram(values[, index])

Вычисляет функцию гистограммы на указанном массиве значений values. Может быть указан необязательный параметр index, который будет передаваться в функции, определяющие диапазон и корзины. Возвращаемое значение является массивом массивов: каждый элемент во внешнем массиве представляет корзину, а каждая корзина содержит ассоциированные элементы из входного массива values. Кроме того, каждая корзина имеет три атрибута:

• x — нижняя граница корзины (включительно).
• dx — ширина корзины; x + dx является верхней границей (верхняя граница в корзину не включается).
• y — количество (если параметр frequency установлен в true) или вероятность (если параметр frequency установлен в false).

Обратите внимание, что значение атрибута y совпадает со значением атрибута length в частотном режиме.

# histogram.value([accessor])

Определяет, как извлекать значения из ассоциированных данных; параметр accessor является функцией, которая вызывается для каждого входного значения, переданного в функцию histogram, это эквивалентно вызову values.map(accessor) перед вычислением гистограммы. Функция доступа к значению по умолчанию — это встроенный объект Number, который подобен единичной функции. Если параметр accessor не указан, возвращает текущую функцию доступа к значению.

# histogram.range([range])

Определяет диапазон гистограммы. Значения за пределами указанного диапазона будут проигнорированы. Параметр range может быть как двухэлементным массивом, представляющим минимальное и максимальное значения диапазона, так и функцией, возвращающей диапазон по переданому в гистограмму массиву значений values и текущему индесу index. Диапазон по умолчанию является размером (минимумом и максимумом) значений. Если параметр range не указан, возвращает текущую функцию доступа к диапазону.

# histogram.bins()
# histogram.bins(count)
# histogram.bins(thresholds)
# histogram.bins(function)

Определяет значения корзин гистограммы. Если не указано ни одного аргумента, возвращается текущая функция разбиения на корзины, которая по умолчанию реализует правило Стёрджеса, которое делит значения на корзины, используя равномерно распределённые значения. Если указан параметр count, значение диапазона равномерно поделится на указанное количество корзин.

Если указан массив границ thresholds, он будет определять пороговые значения, используемые корзинами, начиная с самого левого (наименьшего) значения и заканчивая самым правым (наибольшим) значением. n + 1 границ определяют n корзин. Любые значения, меньшие чем thresholds[1] будут помещены в первую корзину; точно также любые значения больше, либо равные thresholds[thresholds.length - 2] будут помещены в последнюю корзину. Таким образом, хотя первая и последняя граница не используются для присваивания значениям корзин, они всё ещё необходимы для определения свойства x первой корзины и свойства dx последней корзины.

Наконец, если указана функция доступа к корзинам function, она вызывается при передаче в компоновку данных с параметрами: текущим диапазоном, массивом значений и текущим индексом, переданным в функцию histogram. Эта функция должна возвращать массив thresholds, описанный в предыдущем абзаце.

# histogram.frequency([frequency])

Определяет, содержит ли значение y гистограммы количество (частоту) или вероятность (плотность); значение по умолчанию — частота. Если параметр frequency не указан, возвращает текущий признак частоты.