Exponenta Banner
exponenta event banner

повторить

Класс: matlab. DiscreteEventSystem
Пакет: matlab

Действие события при итерации сущности

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

Синтаксис

[entity,events,next]=iterate(obj,storage,entity,tag,cur)
[entity,events,next,out1,...]=iterate(obj,storage,entity,tag,cur,in1,...)

Описание

[entity,events,next]=iterate(obj,storage,entity,tag,cur) указывает действия с событиями при обработке сущности как части итерационного события.

[entity,events,next,out1,...]=iterate(obj,storage,entity,tag,cur,in1,...) определяет такие действия события, когда блок имеет один или более входных сигнальных портов и/или выходных сигнальных портов.

Входные аргументы

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

Объект системы дискретных событий.

Индекс элемента хранения.

Объект, обрабатываемый в настоящее время. Сущность имеет следующие поля:

  • sys (MATLAB structure) - Имеет следующие поля:

    • id (double) - Идентификатор объекта

    • priority (double) - Приоритет объекта

  • data - Данные объекта

Тег события итерации текущей сущности.

Структура MATLAB, указывающая текущее состояние итерации. Структура имеет следующие поля:

  • size

    Общее количество объектов в хранилище

  • position

    Позиция текущего итерирующего объекта

Любые входные данные объекта. Эти входные аргументы существуют только в том случае, если объект имеет входные данные.

Выходные аргументы

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

Обрабатываемая сущность, возможно, с измененными данными.

События, запланированные после возврата метода. Использовать matlab.DiscreteEventSystem методы класса для создания событий. Каждое событие имеет следующие поля:

  • type (character vector) - Тип события

  • delay (double) - Задержка перед событием

  • priority (double) - Приоритет события

  • Storage (double) - Индекс элемента хранения

  • tag (character vector) - Тег события

  • location (MATLAB structure) - исходное или конечное расположение объекта;

  • Правда

    Продолжите обработку следующего объекта в элементе хранения.

  • Ложный

    Завершите событие итерации и оставьте остальные объекты элемента хранения необработанными.

Выходные данные объекта. Необходимо указать эти выходные аргументы, если объект имеет выходные данные.

Примеры

Пересылка первого объекта

Переслать первый объект с совпадающим значением данных на выходной порт 1 системы дискретных событий.

function [entity,events,next] = iterate(obj,storage,entity,tag,status)
    % Forward the first entity with matching data value to output
    % port 1 of the discrete-event system.
    disp(['Searching in storage element ' num2str(storage)]);
    disp(['    Total size = ' num2str(status.size)]);
    disp(['    Current position = ' num2str(status.position)]);
    if (entity.data == obj.dataToSearch)
        events = obj.eventForward('output', 1, 0);
        next = false;   % Found -- early terminate
    else
        events = [];
        next = true;    % Not yet found -- continue
    end
end

Блок хранилища настраиваемых сущностей с событием итерации

В этом примере пользовательский блок позволяет объектам входить в его элемент хранения через входной порт. Элемент хранения - это приоритетная очередь, которая сортирует объекты на основе их Diameter атрибут в порядке возрастания. Каждая запись объекта в хранилище блока вызывает событие итерации для отображения диаметра и положения каждого объекта в хранилище.

Дополнительные сведения см. в разделе Создание пользовательского блока хранилища сущностей с событием итерации.

classdef CustomEntityStorageBlockIteration < matlab.DiscreteEventSystem
    
    % A custom entity storage block with one input port and one storage element. 
    
    % Nontunable properties 
    properties (Nontunable)
        % Capacity
        Capacity = 5;
    end
    % Create the storage element with one input and one storage.
    methods (Access=protected)

        function num = getNumInputsImpl(obj)
            num = 1;
        end
        
        function num = getNumOutputsImpl(obj)
            num = 0;
        end
        
        function entityTypes = getEntityTypesImpl(obj)
            entityType1 = obj.entityType('Wheel');
            entityTypes = entityType1;
        end
        
        function [inputTypes,outputTypes] = getEntityPortsImpl(obj)
            inputTypes = {'Wheel'};
            outputTypes={};
            
        end
        
        function [storageSpecs, I, O] = getEntityStorageImpl(obj)
            storageSpecs = obj.queuePriority('Wheel',obj.Capacity, 'Diameter','ascending');
            I = 1;
            O = [];
            
        end
        
    end
    % Entity entry event action
    methods 

        function [entity, event] = WheelEntry(obj,storage,entity, source)
            % Entity entry invokes an iterate event.      
            event = obj.eventIterate(1, '');
        end

        % The itarate event action
        function [entity,event,next] = WheelIterate(obj,storage,entity,tag,cur)
            % Display wheel id, position in the storage, and diameter.
            coder.extrinsic('fprintf');
            fprintf('Wheel id %d, Current position %d, Diameter %d\n', ...
                entity.sys.id, cur.position, entity.data.Diameter);
            if cur.size == cur.position 
                fprintf('End of Iteration \n')
            end
            next = true;
            event=[];
        end
        
    end

end

См. также

| | | | | | | | | |

Темы

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

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

Поддержка