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

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

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

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

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

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

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

Новая гистограмма уже содержит элемент данных. Если вы хотите добавить еще один элемент данных, выполните следующие шаги:

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

Чтобы удалить объект сбора данных с гистограммы

  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).

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

Функции

Данные гистограммы

Функция

Описание

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)

Возвращает цвет элемента гистограммы (Histogram2DData) с заданным индексом.

Параметр:
i - индекс элемента гистограммы

void setColor(int i, Color c)

Задает новый цвет элемента гистограммы (Histogram2DData) с заданным индексом.

Параметры:
i - индекс элемента гистограммы;
c - новый цвет элемента гистограммы.

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

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


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

Функция

Описание

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 - невидимой.


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

Функция

Описание

String copyToClipboard()

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

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



См. также

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

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

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

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

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

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

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