Entity Find

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

  • Entity Find block

Описание

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

  • Поисковые сущности, которые удовлетворяют особому условию через блоки в модели, чтобы найти и исследовать их.

  • Извлеките найденные сущности из модели, не изменяя их.

  • Измените атрибуты найденных сущностей в их местоположении в модели без экстракции.

    В этом случае, чтобы настроить действия, когда сущность найдена, во вкладке Event actions, в On found action поле вводит MATLAB® код.

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

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

Блок может извлечь сущности из Entity Server, Entity Queue, Entity Store, Resource Acquirer, Entity Replicator, Conveyor System, Entity Selector, MATLAB Discrete-Event System и блоков Discrete-Event Chart.

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

Примечание

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

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

Порты

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

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

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

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

Вывод

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

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

Зависимости

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

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

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

Зависимости

Чтобы включить этот порт, кликните по вкладке 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 является длительностью между элементом блока Entity Find и выходом сущности. Для получения дополнительной информации смотрите, Интерпретируют Модели 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