Exponenta Banner
exponenta event banner

Поиск сущности

Поиск объектов

развернуть все на странице
  • Библиотека:

  • SimEvents

  • Entity Find block

Описание

Блок «Поиск объектов» находит объекты, использующие определенный ресурс. Блок получает объект триггера от своего входного порта. Получив объект триггера, он инициирует поиск по всем блокам в модели для объектов с определенным ресурсом. Для дальнейшей фильтрации поиска объектов можно добавить дополнительные условия фильтрации. Блок может манипулировать найденными объектами следующими способами.

  • Поиск объектов, удовлетворяющих определенному условию, по блокам в модели для их поиска и проверки.

  • Извлеките найденные объекты из модели без их изменения.

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

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

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

    В этом случае для настройки действий при входе, выходе или блокировке объектов введите код MATLAB в поле Entry action, Exit action, или Blocked action на вкладке Действия события. Дополнительные сведения см. в разделе Запись действий события для устаревших моделей.

Блок может извлекать объекты из серверов сущностей, очереди сущностей, хранилища сущностей, источника ресурсов, репликатора сущностей, конвейерной системы, селектора сущностей, системы дискретных событий MATLAB и блоков диаграммы дискретных событий.

При извлечении объекта ожидающие события и статистика соответствующим образом обновляются. Например, если сущность извлекается блоком «Поиск сущности» из блока «Сервер сущности» в течение периода обслуживания, остальная часть услуги отменяется, и выходные данные статистики обновляются.

Примечание

Блок может найти только один тип объекта, указанный в модели, и не может найти или извлечь объекты через границы привязки модели.

Дополнительные сведения об общих рабочих процессах с блоком «Поиск объектов» см. в разделе Поиск и извлечение объектов в моделях SimEvents.

Порты

Вход

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

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

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

Продукция

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

Выходной порт объекта для объектов, найденных блоком.

Зависимости

Чтобы включить этот порт, установите флажок Извлечь найденные сущности.

Типы данных: 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 leaded (Количество удаляемых объектов), 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 extructed), например.

Типы данных: 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.

Зависимости

Этот флажок появляется, если установлен флажок Дополнительное условие фильтрации на вкладке Главная.

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

Параметр блока: MatchingCondition
Текст: символьный вектор
Значения: код MATLAB
По умолчанию: '% match = isequal(trigger.Attribute1, entity.Attribute1);match = true;'

Действия с событиями

Укажите поведение объекта при определенных событиях. Например, действие Entry вызывается при входе объекта в блок. Чтобы настроить действия при входе, выходе или обнаружении или блокировке объектов, введите код MATLAB в Entry action, Exit action, On found action, или Blocked action на вкладке Действия события. Дополнительные сведения о действиях с событиями см. в разделе События и действия с событиями. Пример см. в разделе Управление сущностями с помощью действий с событиями

Зависимости

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'

Сумма времени ожидания для объектов, покидающих блок, деленная на их общее число. Время ожидания - это длительность между входом блока «Поиск сущности» и выходом сущности. Дополнительные сведения см. в разделе Интерпретация моделей 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'

Примеры модели

Find and Examine Entities

Поиск и проверка объектов

Используйте блок «Поиск объектов» для поиска и проверки объектов в их расположении. В этом примере блок находит объекты, помеченные ресурсом, из блока Пул ресурсов.

Inventory Management

Управление запасами

Создание простой системы управления запасами для розничного магазина. Этот пример включает в себя:

См. также

| |

Темы

Представлен в R2018b

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

Поддержка