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