Временной график

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

Временной график

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

 Чтобы добавить временной график

1. Перетащите элемент Временной график  из палитры Статистика в то место графического редактора, где Вы хотите нарисовать график.

Основные свойства

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

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

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

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

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

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

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

Набор данных – [Видно, если выше выбрана опция Набор данных] Имя набора данных, хранящего данные, которые Вы хотите визуализировать на этом графике.

Стиль маркера – Тип маркера, которым будут отмечаться на графике значения этого элемента данных (эти значения могут соединяться линиями согласно выбранному типу интерполяции).

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

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

Толщина линии – [Отображается, если установлен флажок Рисовать линию] Толщина линии, соединяющей значения элемента данных на графике.

Интерполяция – [Отображается, если установлен флажок Рисовать линию] Задает тип интерполяции графика, т.e. то, какие значения будут отрисовываться для набора данных на графике между двумя его соседними измеренными значениями. Поддерживается два типа интерполяции:

Линейная – два соседних значения элемента данных будут соединяться прямым отрезком линии. 
Ступенчатая – на всем интервале между двумя соседними значениями y-значение будет везде одно и то же и равно y-значению первой точки (с меньшим x-значением).

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

Временной диапазон - Здесь Вы можете задать диапазон временной оси диаграммы (количество единиц модельного времени (N), для которого будут отображаться измеренные значения набора данных). Диаграмма будет отображать график только для заданного временного интервала - последних N единиц модельного времени.

Вертикальная шкала - Здесь Вы можете выбрать режим масштабирования вертикальной шкалы диаграммы. Выберите режим автомасштабирования (Авто), либо же Фиксированный режим, при котором вертикальная шкала диаграммы будет иметь четко заданные минимум и максимум (задающиеся в полях От и до).

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

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

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

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

Дополнительные свойства

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

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

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

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

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

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

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

Динамические свойства

Имя	Тип	Описание
Количество	int	Количество экземпляров данной диаграммы. Если Вы оставите это поле пустым, то будет создана только одна такая диаграмма.
Видимость	boolean	Видимость диаграммы.  Диаграмма будет видна, если заданное здесь выражение будет истинно (true), в противном случае диаграмма отображаться не будет.
X	double	X-координата верхнего левого угла диаграммы.
Y	double	Y-координата верхнего левого угла диаграммы.
Ширина	int	Ширина диаграммы (в пикселах).
Высота	int	Высота диаграммы (в пикселах).
Действие при изменении выделения	-	Код, который будет выполняться, когда пользователь выделит на диаграмме какой-то один (или несколько) набор(ов) данных. Код будет вызываться как в том случае, если пользователь выделит наборы данных, щелкнув мышью по их заголовкам в легенде, так и в том случае, если он выделит  их программно путем вызова метода selectItem().  Вы можете использовать в этом коде две переменные: int[] selectedIndices - номера выделенных в текущий момент наборов данных. boolean programmatically - определяет, были ли наборы данных выделены программно (true) или нет (false).
Действие при удалении элемента	-	Код, который будет выполняться, когда пользователь удалит с диаграммы какой-то один (или несколько) набор(ов) данных. Код будет вызываться как в том случае, если пользователь удалит наборы данных из контекстного меню легенды диаграммы, так и в том случае, если он удалит  их программно путем вызова методов remove() и removeAll(). Вы можете использовать в этом коде две переменные: int removedIndex - номер только что удаленного набора данных. boolean programmatically - определяет, был ли набор данных удален программно (true) или нет (false).

Внешний вид

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

См. также

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