Двумерная гистограмма

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

Двумерная гистограмма

Когда двумерная гистограмма отображает ячейки, цвет каждой ячейки отображает значение плотности вероятности не относительно всей двумерной плоскости значений, а только относительно текущего интервала оси X.

 Чтобы добавить двумерную гистограмму

  1. Перетащите элемент Двумерная гистограмма  из палитры Статистика на графическую диаграмму.
  2. Перейдите в панель Свойства, и выберите, должна ли эта двумерная гистограмма Отображать вложения, или Отображать ячейки.
  3. Раскройте секцию свойств Данные, и выберите элемент данных двумерной гистограммы, который вы хотите отображать на данной гистограмме.

Свойства

Основные

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

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

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

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

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

Данные

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

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

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

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

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

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

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

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

Внешний вид

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

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

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

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

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

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

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

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

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

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

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

Легенда

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

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

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

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

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

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

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

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

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

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

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

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

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

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

 Чтобы изменить способ отображения данных на гистограмме

  1. Выделите гистограмму в графическом редакторе или в панели Проекты.
  2. Перейдите в панель Свойства.
  3. Если вы хотите отображать гистограмму в виде набора прямоугольников различного цвета (где интенсивность цвета соотвествует значению плотности вероятности в данной точке (X,Y)), выберите опцию  Отображать ячейки.
  4. Если же вы хотите отображать гистограмму в виде вложений, то выберите опцию Отображать вложения.

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

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

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

 Чтобы удалить объект сбора данных с гистограммы
  1. Выделите гистограмму в графическом редакторе или в панели Проекты.
  2. Перейдите в секцию Данные панели Свойства.
  3. Выделите элемент данных, который вы хотите удалить с данной гистаграммы, и щелкните мышью по кнопке  внизу секции Данные.

Функции

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

Функция

Описание

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 addHistogram2D
(Histogram2DData hist,
String title,
Color color)

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

Параметры:
hist - объект данных двумерной гистограммы
title - заголовок объекта данных
color - цвет, соответствующий наибольшей плотности вероятности данных.

int getCount()

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

ChartItem get(int i)

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

String getTitle(int i)

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

Color getColor(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()

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

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


См. также

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

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

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

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

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

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

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