Диаграмма распределения частот

Справочник API ▸ Макеты ▸ Диаграмма распределения частот

Диаграмма распределения частот отображает распределение данных путём группировки дискретных точек данных в интервалы. Пример использования см. на bl.ock 3048450.

d3.layout.histogram()

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

histogram(значения[, индекс])

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

• x - нижняя граница интервала (включительно).
• dx - ширина интервала; x + dx - верхняя граница (исключая).
• y - количество (если frequency - true), или вероятность (если frequency - false).

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

histogram.value([accessor])

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

histogram.range([range])

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

histogram.bins()
histogram.bins(количество)
histogram.bins(пороговые значения)
histogram.bins(функция)

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

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

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

histogram.frequency([frequency])

Указывает значение значений y сгенерированных интервалов. Если frequency равно true, что является значением по умолчанию, значение y представляет количество элементов в интервале. Если false, оно представляет вероятность того, что случайный элемент в выборке попадет в этот интервал. Обратите внимание, что это вероятность, а не плотность вероятности, поэтому для неправильных гистограмм необходимо нормализовать значение y на ширину интервала (bin.y / bin.dx) для того, чтобы площадь отображаемой полосы была пропорциональна вероятности. Если frequency не указан, возвращается текущее булево значение frequency.