Гистограмма

Гистограмма отображает данные, собранные объектом Данные гистограммы (на одной гистограмме могут одновременно отображаться данные сразу нескольких таких объектов). Ось X всегда масштабируется таким образом, чтобы вместить все данные.  Масштаб по оси Y также выбирается автоматически, таким образом, чтобы высота самого высокого столбца была равна высоте области диаграммы. 

Гистограмма

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

Функция плотности вероятности отображается в виде набора вертикальных столбцов, каждый из которых соответствует определенному интервалу. Высота столбца пропорциональна плотности (или количеству) значений, попавших в этот интервал.

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

Если объектом сбора данных гистограммы вычисляются процентили, и заданы значения как нижнего, так и верхнего доверительного интервалов, то столбцы, содержащие “рисковые значения” (значения, удовлетворяющие уравнению Интегральная функция распределения(значение) < нижний процентиль или Интегральная функция распределения(значение) > 100 – верхний процентиль) будут отрисовываться заданными цветами. 

 Чтобы добавить гистограмму
  1. Перетащите элемент Гистограмма  из палитры Статистика в то место графического редактора, где вы хотите нарисовать гистограмму.
  2. Перейдите в секцию Данные панели Свойства.
  3. Последовательно задайте те объекты сбора данных, которые вы хотите отображать на данной гистограмме. Чтобы добавить данные, щелкните мышью по кнопке  Добавить данные и задайте свойства этого объекта данных в появившейся ниже секции свойств. 
  4. Введите имя объекта сбора данных гистограммы в поле Данные
  5. В поле Заголовок введите текст, который будет отображаться в легенде гистограммы. 
  6. Если вы хотите, чтобы на гистограмме отображалась плотность вероятности данных, установите флажок Отображать плотность вер-ти и при необходимости измените Цвет плотности вер-ти.
  7. Если вы хотите, чтобы на гистограмме отображалась интегральная функция распределения установите флажок Отображать ф-ю распределения и при необходимости измените Цвет линии ф. распред..
  8. Если вы хотите, чтобы на гистограмме отображалась линия среднего значения, установите флажок Отображать среднее и при необходимости измените Цвет линии среднего.
  9. Если для каких-то данных вычисляются процентили, то вы можете изменить цвет плотности вероятности слева от нижнего и справа от верхнего процентиля в полях Цвет нижнего % и Цвет верхнего % соответственно.

Свойства

Основные

Имя – Имя гистограммы. По этому имени гистограмма будет доступна из кода.

Исключить – Если опция выбрана, то гистограмма будет исключена из модели.

Отображается на верхнем уровне – Если опция выбрана, то гистограмма будет видна на презентации типа агента, в который будет вложен данный агент.

Отображать плотность вер-ти – Если опция выбрана, то на гистограмме будет отображаться плотность вероятности.

Отображать ф-ю распределения – Если опция выбрана, то на гистограмме будет отображаться функция распределения.

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

Данные

 – С помощью этой кнопки вы можете добавить новый объект данных гистограммы на гистограмму. Щелкнув по ней, вы откроете новую секцию свойств, в которой вы должны будете задать свойства нового объекта данных: 

Заголовок – Заголовок этого объекта данных, который будет отображаться в легенде гистограммы. 

Данные – Имя этого объекта данных гистограммы.

Цвет плотности вер-ти – [Виден, если установлен флажок Отображать плотность вер-ти] Цвет, которым на гистограмме будет отображаться плотность вероятности.

Цвет линии ф. распред. – [Виден, если установлен флажок Отображать ф-ю распределения] Цвет, которым на гистограмме будет отображаться интегральная функция распределения.

Цвет линии среднего –  [Виден, если установлен флажок Отображать среднее] Цвет, которым на гистограмме будет отображаться линия среднего значения.

Толщина линии ф-ии распред. и среднего – [Виден, если установлен флажок Отображать ф-ю распределения или Отображать среднее] Толщина линии интегральной функции распределения и линии среднего значения.

Цвет нижнего % – Цвет, которым будет отображаться плотность вероятности слева от нижнего процентиля.

Цвет верхнего % – Цвет, которым будет отображаться плотность вероятности справа от верхнего процентиля.

Чтобы удалить объект данных с гистограммы, щелкните мышью по кнопке  внизу этой секции свойств. Используйте кнопки и , чтобы изменять порядок расположения элементов данных.

Обновление данных

Обновлять данные автоматически - Если опция выбрана, то гистограмма будет производить обновление значений отображаемых на ней объектов данных с периодичностью, указанной в поле Период. Так же здесь вы можете выбрать, хотите ли вы Использовать модельное время, чтобы задать Время первого обновления, или вы хотите Использовать календарные даты, чтобы задать Дату обновления

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

Внешний вид

Относительная ширина столбцов – С помощью данного бегунка вы можете задавать суммарную ширину оснований столбцов (в процентах, относительно соответствующей размерности гистограммы, 100% - максимум, 50% - половина и т.д.).

Метки по оси Y – С помощью данного выпадающего списка вы можете задать расположение меток, отображаемых для оси Y, относительно области гистограммы (Слева или Справа). Если вы не хотите, чтобы у оси Y отображались метки, выберите из списка Нет.

Цвет фона – Фоновый цвет диаграммы. 

Цвет границы – Цвет, которым будет отображаться граница диаграммы. 

Цвет меток – Цвет, которым будут отображаться метки по оси Y. Если вы не хотите, чтобы метки были видны, выберите Нет цвета.

Цвет сетки – Цвет, которым будет отображаться сетка гистограммы. Если вы не хотите, чтобы сетка была видна, выберите Нет заливки.

Местоположение и размер

X – X-координата верхнего левого угла диаграммы.

Y – Y-координата верхнего левого угла диаграммы.

Ширина – Ширина диаграммы (в пикселах).

Высота – Высота диаграммы (в пикселах).

Легенда

Легенда – Если опция выбрана, то у данной гистограммы будет отображаться легенда. Вы можете управлять местоположением легенды относительно области диаграммы с помощью группы кнопок Расположение. Размер области, выделенной под легенду, задается с помощью элемента управления Ширина (или Высота, в зависимости от того, какое задано Расположение легенды). Также вы можете изменить Цвет текста легенды.

Область диаграммы

Свойства, расположенные в секции Область диаграммы, задают визуальные свойства области диаграммы:

Смещение по оси X – Смещение области диаграммы по оси X относительно левой границы всей области, выделенной в графическом редакторе под диаграмму.

Смещение по оси Y – Смещение области диаграммы по оси Y относительно верхней границы всей области, выделенной в графическом редакторе под диаграмму.

Ширина – Ширина области диаграммы (в пикселах).

Высота – Высота области диаграммы (в пикселах).

Цвет фона – Фоновый цвет области диаграммы. 

Цвет границы – Цвет, которым будет отображаться граница области диаграммы. 

Специфические

Видимость – Видимость диаграммы.  Диаграмма будет видна, если заданное здесь выражение будет истинно (true), в противном случае диаграмма отображаться не будет.

Количество – Количество экземпляров данной диаграммы. Если вы оставите это поле пустым, то будет создана только одна такая диаграмма.

Действие при удалении элемента – Код, который будет выполняться, когда пользователь удалит с диаграммы какой-то один (или несколько) элемент(ов) данных. Код будет вызываться как в том случае, если пользователь удалит элементы из контекстного меню легенды диаграммы, так и в том случае, если он удалит  их программно путем вызова методов remove() и removeAll().
Вы можете использовать в этом коде две переменные:
int removedIndex - номер только что удаленного элемента данных.
boolean programmatically - определяет, был ли элемент удален программно (true) или нет (false).

Действие при изменении выделения – Код, который будет выполняться, когда пользователь выделит на диаграмме какой-то один (или несколько) элемент(ов) данных. Код будет вызываться как в том случае, если пользователь выделит элементы, щелкнув мышью по их заголовкам в легенде, так и в том случае, если он выделит  их программно путем вызова метода selectItem()
Вы можете использовать в этом коде две переменные:
int[] selectedIndices - номера выделенных в текущий момент элементов данных.
boolean programmatically - определяет, были ли элементы выделены программно (true) или нет (false).

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

Функции

Местоположение

Функция

Описание

double getX()

Возвращает координату X диаграммы (а именно, ее левого верхнего угла).

double getY()

Возвращает координату Y диаграммы (а именно, ее левого верхнего угла).

void setX(double x)

Задает координату X диаграммы.

Параметр:
x - новое значение координаты X

void setY(double y)

Задает координату Y диаграммы.

Параметр:
y - новое значение координаты Y

void setPos(double x, double y)

Задает новые координаты диаграммы.

Параметры:
x - новое значение координаты X
y - новое значение координаты Y

Размер

Функция

Описание

double getWidth()

Возвращает ширину диаграммы.

double getHeight()

Возвращает высоту  диаграммы.

void setWidth(double w)

Задает новую ширину диаграммы.

Параметр:
w - новое значение ширины диаграммы

void setHeight(double h)

Задает новую высоту диаграммы.

Параметр:
h - новое значение высоты диаграммы

Видимость

Функция

Описание

boolean isVisible()

Проверяет видимость диаграммы: если диаграмма отображается, то функция возвращает true, если не отображается - то false.

void setVisible(boolean v)

Устанавливает видимость диаграммы.

Параметр:
v - видимость: если true - диаграмма будет видимой, если false - невидимой.

Добавление и удаление элементов данных диаграммы

Функция

Описания

void addHistogram
(HistogramData hist,
String title,
Color colorLowPercent,
Color colorHighPercent,
Color colorPDF,
Color colorCDF,
float lineWidthCDF,
Color colorMean)

Добавляет на диаграмму объект данных гистограммы с заданным по умолчанию внешним видом.


Параметры:

hist - объект данных гистограммы для добавления

title - заголовок объекта данных

colorLowPercent - цвет для отображения столбиков плотности вероятности данных слева от нижнего процентиля

colorHighPercent - цвет для отображения столбиков плотности вероятности данных справа от верхнего процентиля

colorPDF - цвет для отображения столбиков плотности вероятности

colorCDF - цвет для отображения линии функции распределения

lineWidthCDF - толщина линии функции распределения, 0 соответствует самой  тонкой линии

colorMean - цвет для отображения линии среднего значения

int getCount()

Возвращает количество элементов данных, отображаемых этой диаграммой.

ChartItem get(int i)

Возвращает элемент данных гистограммы с заданным индексом i.

String getTitle(int i)

Возвращает заголовок элемента данных гистограммы с заданным индексом i.

void remove(int i)

Удаляет с диаграммы элемент данных гистограммы с заданным индексом i.

int remove(ChartItem ci)

Удаляет заданный элемент данных гистограммы с диаграммы.

void removeAll()

Удаляет все элементы с диаграммы.

Выделение элементов данных

Функция

Описание

void selectItem(int itemIndex, boolean selected)

Выделяет/снимает выделение (это зависит от значения параметра  selected) с элемента диаграммы с заданным индексом.

Параметры:
itemIndex - индекс элемента диаграммы
selected - если true, то выделяет элемент, если false, то снимает выделение

void setSelectedItemIndices(int[] selectedIndices)

Выделяет элементы диаграммы с заданными индексами. Если ранее были выделены какие-то другие элементы, то это выделение будет снято.

Параметр:
selectedIndices - массив индексов элементов диаграмм, которые будут выделены, может быть равен null - тогда выделение будет снято со всех элементов

int[] getSelectedItemIndices()

Возвращает количество элементов диаграммы, выделенных на диаграмме.

Ручное обновление данных диаграммы

Функция

Описание

void updateData()

Обновляет все элементы данных, отображаемые на этой диаграмме. 

Копирование данных диаграммы в буфер обмена

Функция

Описание

String copyToClipboard()

Копирует все данные диаграммы в системный буфер обмена. 

Функция возвращает текстовое представление всех данных диаграммы.


См. также

 Режимы масштабирования диаграмм

 Область диаграммы

 Легенда диаграммы

 Сетка и метки диаграммы

 Обновление диаграмм

 Динамическое изменение внешнего вида диаграммы

 Справочник классов: Класс Histogram