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

  • Библиотека:
  • 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.

Порты

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

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

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

Типы данных: single | double | int8 | int16 | int32 | uint8 | uint16 | uint32 | Boolean | enumerated | bus

Вывод

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

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

Зависимости

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

Типы данных: single | double | int8 | int16 | int32 | uint8 | uint16 | uint32 | Boolean | enumerated | bus

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

Зависимости

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

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

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

Зависимости

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

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

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

Зависимости

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

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

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

Зависимости

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

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

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

Зависимости

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

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

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

Зависимости

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

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

Параметры

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

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

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

Параметры блоков: ResourceName
Ввод: символьный вектор
Значения: имя ресурса
Значение по умолчанию: 'Resource1'

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

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

Параметры блоков: EnableOutput
Ввод: символьный вектор
Значения: 'on' | 'off'
Значение по умолчанию: 'off'

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

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

Параметры блоков: EntityFilter
Ввод: символьный вектор
Значения: 'on' | 'off'
Значение по умолчанию: 'off'

Используйте код 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;'

Задайте поведение сущности на определенных событиях. Например, действие 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
Значение по умолчанию: ''

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

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

Параметры блоков: NumberEntitiesDeparted
Ввод: символьный вектор
Значения: 'on' | 'off'
Значение по умолчанию: 'off'

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

Зависимости

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

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

Параметры блоков: NumberEntitiesDeparted
Ввод: символьный вектор
Значения: 'on' | 'off'
Значение по умолчанию: 'off'

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

Зависимости

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

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

Параметры блоков: NumberEntitiesInBlock
Ввод: символьный вектор
Значения: 'on' | 'off'
Значение по умолчанию: 'off'

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

Зависимости

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

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

Параметры блоков: AverageWait
Ввод: символьный вектор
Значения: 'on' | 'off'
Значение по умолчанию: 'off'

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

  1. Умножение размера очереди ее длительностью, чтобы вычислить взвешенный временем размер очереди

  2. Подведение итогов всех взвешенных временем размеров очереди и усреднение их за общее время

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

Зависимости

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

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

Параметры блоков: AverageStoreSize
Ввод: символьный вектор
Значения: 'on' | 'off'
Значение по умолчанию: 'off'

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

Зависимости

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

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

Параметры блоков: NumEntitiesExtracted
Ввод: символьный вектор
Значения: 'on' | 'off'
Значение по умолчанию: 'off'

Введенный в R2018b