Сущность находит

Найдите сущности

Библиотека:
SimEvents

Описание

Блок Entity Find находит сущности, которые используют определенный ресурс. Блок получает триггерную сущность от своего входного порта. После получения триггерной сущности это инициирует поиск через все блоки в модели для сущностей с определенным ресурсом. Можно далее отфильтровать поиск нахождения сущностей путем добавления дополнительных условий фильтрации. Блок может управлять найденными сущностями этими способами.

Поисковые сущности, которые удовлетворяют особое условие через блоки в модели, чтобы найти и исследовать их.
Извлеките найденные сущности из модели, не изменяя их.
Измените атрибуты найденных сущностей в их местоположении в модели без экстракции.
В этом случае, чтобы настроить действия, когда сущность найдена, во вкладке Event actions, в поле On found action, вводят код MATLAB^®.
Извлеките и измените атрибуты сущности. Извлеченные сущности поставлены в очередь в блоке и перенаправлены через его выходной порт.
В этом случае, чтобы настроить действия, когда сущности входят, выйдите, или блокируются, вводят код MATLAB в Entry action, Exit action или поле Blocked action вкладки Event actions. Для получения дополнительной информации смотрите Действия События Записи для Устаревших Моделей.

Блок может извлечь сущности с Сервера Сущности, Очередь Сущности, Хранилище Сущности, Получателя Ресурса, Репликатор Сущности, Систему Конвейера, Селектор Сущности, Дискретную Систему событий MATLAB и блоки Дискретной Схемы событий.

Когда сущность извлечена, незаконченные события и статистика обновляются соответственно. Например, если сущность извлечена блоком Entity Find от блока Entity Server в сервисный период, остальная часть сервиса отменяется, и вывод статистики обновляются.

Примечание

Блок может найти только один тип сущности, который вы задаете в модели, и это не может найти или извлечь сущности через контуры модели - ссылки.

Для получения дополнительной информации об общих рабочих процессах, включающих блок Entity Find, смотрите, Находят и Сущности Извлечения в Моделях SimEvents.

Порты

Входной параметр

развернуть все

`Port_1` — Введите сущности, чтобы инициировать сущности открытия
скаляр | вектор | матрица

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

Вывод

развернуть все

`Port_1` — Выведите найденную сущность
скаляр | вектор | матрица

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

Зависимости

Чтобы включить этот порт, установите флажок Extract found entities.

`Port_f` — Количество сущностей найдено
скаляр

Количество сущностей, которые найдены блоком.

Зависимости

Чтобы включить этот порт, кликните по вкладке Statistics и выберите поле, маркировал Number of entities found, f.

Типы данных: double

`Port_d` — Количество сущностей, которые отбыли из блока
скаляр

Количество сущностей, которые отбыли из блока.

Зависимости

Чтобы включить этот порт, кликните по вкладке Statistics и выберите поле, маркировал Number of entities departed, d.

Типы данных: double

`Port_n` — Количество найденных сущностей, которые еще не отбыли из блока
скаляр

Количество найденных сущностей, которые еще не отбыли из блока.

Зависимости

Чтобы включить этот порт, кликните по вкладке Statistics и выберите поле, маркировал Number of found entities in block, n.

Типы данных: double

`Port_w` — Среднее время ожидания для найденных сущностей в блоке
скаляр

Среднее время ожидания для найденных сущностей в блоке.

Зависимости

Чтобы включить этот порт, кликните по вкладке Statistics и выберите поле, маркировал Average wait, w.

Типы данных: double

`Port_l` — Средняя длина найденной очереди сущности
скаляр

Выводит среднюю длину найденной очереди сущности.

Зависимости

Чтобы включить этот порт, кликните по вкладке Statistics и выберите поле, маркировал Average queue length, l.

Типы данных: double

`Port_ex` — Количество сущностей извлечено
скаляр

Количество сущностей, которые извлечены из этого блока.

Зависимости

Чтобы включить этот порт, кликните по вкладке Statistics и выберите поле, маркировал Number of entities extracted, ex.

Типы данных: double

Параметры

развернуть все

`Resource` — Задайте имя ссылочного ресурса использование сущностей
`Resource1` (значение по умолчанию) | вектор символов

Имя ссылочного ресурса, который используется сущностями, которые будут найдены блоком.

Программируемое использование

Параметры блоков: ResourceName

Ввод: символьный вектор

Значения: имя ресурса

Значение по умолчанию: 'Resource1'

`Extract found entities` — Извлеките и перенаправьте найденные сущности
`off` (значение по умолчанию) | `on`

Извлеките и выведите сущности, которые найдены в поиске.

Программируемое использование

Параметры блоков: EnableOutput

Ввод: символьный вектор

Значения: 'on' | 'off'

Значение по умолчанию: 'off'

`Additional filtering condition` — Добавьте дополнительное условие фильтрации
`off` (значение по умолчанию) | `on`

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

Программируемое использование

Параметры блоков: EntityFilter

Ввод: символьный вектор

Значения: 'on' | 'off'

Значение по умолчанию: 'off'

`Matching condition` — Задайте соответствующее условие
`match = true;` (значение по умолчанию)

Используйте код MATLAB, чтобы задать дополнительные условия соответствия для нахождения сущностей. Поиски блока для сущностей, таким образом, что значение логической переменной match становится true. Например, когда

match = isequal(trigger.Attribute1, entity.Attribute1);

блок находит сущности, которые имеют то же значение Attribute1 с триггерной сущностью, потому что только их равенство устанавливает match как true.

При авторской разработке дополнительных условий соответствия можно использовать эти переменные.

trigger — Используйте, чтобы получить доступ к триггерным атрибутам сущности.
entity — Используйте, чтобы получить доступ к атрибутам сущности, которая находится.
match — Используйте в качестве булева значения, которое будет возвращено соответствующим условием. Значение match инициализируется как false.

Зависимости

Этот флажок появляется, если флажок Additional filtering condition во вкладке Main устанавливается.

Программируемое использование

Параметры блоков: MatchingCondition

Ввод: символьный вектор

Значения: КОД MATLAB

Значение по умолчанию: '% match = isequal(trigger.Attribute1, entity.Attribute1);match = true;'

`Event actions` — Задайте действие события
`OnFound` (значение по умолчанию) | `Entry` | `Exit` | `Blocked`

Задайте поведение сущности на определенных событиях. Например, действие Entry называется, когда сущность вводит блок. Чтобы настроить действия, когда сущности входят, выйдите, или найдены или блокированы, вводят код MATLAB в Entry action, Exit action, On found action или поле Blocked action вкладки Event actions. Для получения дополнительной информации о действиях события, смотрите Действия События и События. Для примера смотрите, Управляют Сущностями Используя Действия События

Зависимости

On found action появляется, только если флажок Extract found entities не устанавливается.

Entry action, Exit action и Blocked action появляются, только если флажок Extract found entities устанавливается.

Программируемое использование

Параметры блоков: EntryAction, ExitAction, BlockedAction

Ввод: символьный вектор

Значения: КОД MATLAB

Значение по умолчанию: ''

`Number of entities found, f` — Выводит количество сущностей, которые найдены
`off` (значение по умолчанию) | `on`

Количество сущностей, которые найдены блоком во время симуляции.

Программируемое использование

Параметры блоков: NumberEntitiesDeparted

Ввод: символьный вектор

Значения: 'on' | 'off'

Значение по умолчанию: 'off'

`Number of entities departed, d` — Выводит количество сущностей, которые отбыли из блока
`off` (значение по умолчанию) | `on`

Количество сущностей, которые отбыли из блока.

Зависимости

Этот флажок появляется, если флажок Extract found entities во вкладке Main устанавливается.

Программируемое использование

Параметры блоков: NumberEntitiesDeparted

Ввод: символьный вектор

Значения: 'on' | 'off'

Значение по умолчанию: 'off'

`Number of found entities in block, n` — Выводит количество найденных сущностей, которые должны все же отбыть
`off` (значение по умолчанию) | `on`

Количество найденных сущностей, которые должны все же отбыть.

Зависимости

Этот флажок появляется, если флажок Extract found entities во вкладке Main устанавливается.

Программируемое использование

Параметры блоков: NumberEntitiesInBlock

Ввод: символьный вектор

Значения: 'on' | 'off'

Значение по умолчанию: 'off'

`Average wait, w` — Выводит среднее время ожидания
`off` (значение по умолчанию) | `on`

Сумма времени ожидания для сущностей, отбывая из блока, разделенного на их общее количество. Wait time является длительностью между Сущностью, Находят элемент блока и выход сущности. Для получения дополнительной информации смотрите, Интерпретируют Модели SimEvents Используя Статистический анализ.

Зависимости

Этот флажок появляется, если флажок Extract found entities во вкладке Main устанавливается.

Программируемое использование

Параметры блоков: AverageWait

Ввод: символьный вектор

Значения: 'on' | 'off'

Значение по умолчанию: 'off'

`Average queue length, l` — Выводит среднюю длину очереди сущности
`off` (значение по умолчанию) | `on`

Накопленный средневзвешенный временем размер очереди. Блок вычисляет это значение:

Умножение размера очереди ее длительностью, чтобы вычислить взвешенный временем размер очереди
Подведение итогов всех взвешенных временем размеров очереди и усреднение их за общее время

Для получения дополнительной информации смотрите, Интерпретируют Модели SimEvents Используя Статистический анализ.

Зависимости

Этот флажок появляется, если флажок Extract found entities во вкладке Main устанавливается.

Программируемое использование

Параметры блоков: AverageStoreSize

Ввод: символьный вектор

Значения: 'on' | 'off'

Значение по умолчанию: 'off'

`Number of entities extracted, ex` — Количество сущностей извлечено от этого блока
`off` (значение по умолчанию) | `on`

Выводит количество извлеченных сущностей.

Зависимости

Этот флажок появляется, если флажок Extract found entities во вкладке Main устанавливается.

Программируемое использование

Параметры блоков: NumEntitiesExtracted

Ввод: символьный вектор

Значения: 'on' | 'off'

Значение по умолчанию: 'off'

Документация

Сущность находит

Описание

Примечание

Порты

Входной параметр

Port_1 — Введите сущности, чтобы инициировать сущности открытия скаляр | вектор | матрица

Вывод

Port_1 — Выведите найденную сущность скаляр | вектор | матрица

Зависимости

Port_f — Количество сущностей найдено скаляр

Зависимости

Port_d — Количество сущностей, которые отбыли из блока скаляр

Зависимости

Port_n — Количество найденных сущностей, которые еще не отбыли из блока скаляр

Зависимости

Port_w — Среднее время ожидания для найденных сущностей в блоке скаляр

Зависимости

Port_l — Средняя длина найденной очереди сущности скаляр

Зависимости

Port_ex — Количество сущностей извлечено скаляр

Зависимости

Параметры

Resource — Задайте имя ссылочного ресурса использование сущностей Resource1 (значение по умолчанию) | вектор символов

Программируемое использование

Extract found entities — Извлеките и перенаправьте найденные сущности off (значение по умолчанию) | on

Программируемое использование

Additional filtering condition — Добавьте дополнительное условие фильтрации off (значение по умолчанию) | on

Программируемое использование

Matching condition — Задайте соответствующее условие match = true; (значение по умолчанию)

Зависимости

Программируемое использование

Event actions — Задайте действие события OnFound (значение по умолчанию) | Entry | Exit | Blocked

Зависимости

Программируемое использование

Number of entities found, f — Выводит количество сущностей, которые найдены off (значение по умолчанию) | on

Программируемое использование

Number of entities departed, d — Выводит количество сущностей, которые отбыли из блока off (значение по умолчанию) | on

Зависимости

Программируемое использование

Number of found entities in block, n — Выводит количество найденных сущностей, которые должны все же отбыть off (значение по умолчанию) | on

Зависимости

Программируемое использование

Average wait, w — Выводит среднее время ожидания off (значение по умолчанию) | on

Зависимости

Программируемое использование

Average queue length, l — Выводит среднюю длину очереди сущности off (значение по умолчанию) | on

Зависимости

Программируемое использование

Number of entities extracted, ex — Количество сущностей извлечено от этого блока off (значение по умолчанию) | on

Зависимости

Программируемое использование

Смотрите также

Темы

Введенный в R2018b

Документация SimEvents

Поддержка

`Port_1` — Введите сущности, чтобы инициировать сущности открытия
скаляр | вектор | матрица

`Port_1` — Выведите найденную сущность
скаляр | вектор | матрица

`Port_f` — Количество сущностей найдено
скаляр

`Port_d` — Количество сущностей, которые отбыли из блока
скаляр

`Port_n` — Количество найденных сущностей, которые еще не отбыли из блока
скаляр

`Port_w` — Среднее время ожидания для найденных сущностей в блоке
скаляр

`Port_l` — Средняя длина найденной очереди сущности
скаляр

`Port_ex` — Количество сущностей извлечено
скаляр

`Resource` — Задайте имя ссылочного ресурса использование сущностей
`Resource1` (значение по умолчанию) | вектор символов

`Extract found entities` — Извлеките и перенаправьте найденные сущности
`off` (значение по умолчанию) | `on`

`Additional filtering condition` — Добавьте дополнительное условие фильтрации
`off` (значение по умолчанию) | `on`

`Matching condition` — Задайте соответствующее условие
`match = true;` (значение по умолчанию)

`Event actions` — Задайте действие события
`OnFound` (значение по умолчанию) | `Entry` | `Exit` | `Blocked`

`Number of entities found, f` — Выводит количество сущностей, которые найдены
`off` (значение по умолчанию) | `on`

`Number of entities departed, d` — Выводит количество сущностей, которые отбыли из блока
`off` (значение по умолчанию) | `on`

`Number of found entities in block, n` — Выводит количество найденных сущностей, которые должны все же отбыть
`off` (значение по умолчанию) | `on`

`Average wait, w` — Выводит среднее время ожидания
`off` (значение по умолчанию) | `on`

`Average queue length, l` — Выводит среднюю длину очереди сущности
`off` (значение по умолчанию) | `on`

`Number of entities extracted, ex` — Количество сущностей извлечено от этого блока
`off` (значение по умолчанию) | `on`