Статистика потока

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

Вы можете считать пешеходов, пересекающих линию как в одном определенном направлении, так и в обоих направлениях - это задается настройками элемента.

С помощью функций объекта traffic() и intensity() вы можете узнать величину трафика пешеходов и интенсивности потока пешеходов соответственно.

Трафик - это общее количество пешеходов, пересекших заданную линию в заданном направлении в течение последнего времени, смотри описание ниже, в разделе Функции. Трафик измеряется в пешеходах/час.

Интенсивность рассчитывается как отношение величины трафика к длине линии (в метрах) и поэтому измеряется в пешеходах/(час*м).

Демо модель: Pedestrian Flow Statistics

Чтобы добавить линию элемента Статистика потока

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

Свойства

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

Имя – Имя фигуры.

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

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

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

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

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

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

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

УровеньУровень, которому принадлежит эта линия. Для этого уровня будет собрана статистика по всем пешеходам, которые пересекут этот элемент в заданном Направлении.

X – X-координата линии (ее начальная точка).

Y – Y-координата линии (ее начальная точка).

dX – X-координата конечной точки линии относительно начальной точки.

dY – Y-координата конечной точки линии относительно начальной точки.

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

Отображать в – Здесь вы можете выбрать, будет ли фигура отображаться В 2D и в 3D, Только в 2D или Только в 3D.

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

Функции

Статистика потока

Функция

Описание

long countPeds()

Возвращает общее количество пешеходов, пересекших заданную линию.

double traffic()

Возвращает величину трафика пешеходов (в пешеходах/час). Трафик - это общее количество пешеходов, пересекших заданную линию в определенном направлении (заданном настройками элемента) в течение последних пяти минут модельного времени. Чтобы получить значение трафика в пешеходах/час, это количество дополнительно умножается на 12.

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

double intensity()

Возвращает интенсивность потока пешеходов, в пешеходах/(час*м). Интенсивность рассчитывается как отношение величины трафика к длине линии (в метрах).

void reset()

Сбрасывает текущие значения трафика и интенсивности потока пешеходов.


Направление потока

Функция

Описание

FlowStatisticsDirection getDirection()

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

Возможные значения: FLOW_STATISTICS_LEFT, FLOW_STATISTICS_RIGHT, FLOW_STATISTICS_BOTH.

void setDirection
(FlowStatisticsDirection direction)

Задает направление потока, для которого этот элемент будет собирать статистику.

Параметр: direction - новое направление.

Возможные значения: FLOW_STATISTICS_LEFT, FLOW_STATISTICS_RIGHT, FLOW_STATISTICS_BOTH.


Цвет

Функция

Описание

Color getColor()

Возвращает цвет фигуры.

void setColor(Color color)

Задает новый цвет фигуры.

color - новый цвет.


Видимость

Функция

Описание

boolean isVisible()

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

Если функция возвращает true - значит, фигура отображается, если false - нет.

void setVisible(boolean v)

Задает видимость фигуры.

v - видимость. Если значение v равно true - то фигура будет отображаться, если равно false - то нет.


Уровень

Функция

Описание

Level getLevel()

Возвращает уровень, на котором находится эта фигура.



См. также

Разметка пространства для пешеходных моделей

Карта плотности

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