Технологический процесс

В этом примере показано, как можно использовать встроенный режим сопоставления Simulink для выполнения максимально возможного количества сопоставлений. Затем он помечает корневые входы, которым не удалось назначить сигнал. Затем алгоритм переопределяет отмеченные сопоставления пользовательскими отображениями для отображения оставшихся сигналов. Для реализации такого решения создайте пользовательскую функцию сопоставления с помощью getSlRootInportMap.

В этом примере используется список входов с двумя видами сигналов:

Предположим, что используется следующий сценарий:

В этом примере используется режим сопоставления, аналогичный методу сопоставления имени блока Simulink.

Имена блоков ввода на корневом уровне:

Имена сигнальных переменных:

Для сопоставления входных данных с блоками ввода корневого уровня в этом сценарии необходима пользовательская функция сопоставления для инструмента сопоставления корневого ввода. В этом примере используется пользовательская функция сопоставления CharingBlockName.

В этом примере будет использоваться slexAutotransRootInportsExample для проверки пользовательской функции сопоставления.

Объявление пользовательской функции сопоставления

Объявите имя функции, входы и выходы. Чтобы сделать это, скопируйте и приклейте следующий фрагмент кода в файл MATLAB и сохраните файл как AlmostBlockName.m.

function inputMap = AlmostBlockName( modelName, signalNames, signals )

Получение сопоставления имени блока Simulink

Затем запланируйте все сигналы. Для этого сначала сопоставьте все сигналы в пределах допуска, используя режим отображения имени блока Simulink, а затем сопоставьте сигналы вне допуска.

Для отображения сигналов в пределах допуска на модель с использованием одного из режимов сопоставления Simulink используйте функцию getSlRootInportMap. Эта функция возвращает inputMap и вектор логических значений. Каждое логическое значение указывает на успешное или неуспешное отображение inputMap к сигналу. Чтобы отобразить по имени блока, вставьте следующие строки кода сразу после объявления функции.

inputMap = getRootInportMap('empty');
if ~bdIsLoaded(modelName)
   load_system(modelName);
end

[inputMap, hasASignal] = getSlRootInportMap('Model', modelName, ...
        'MappingMode','BlockName',...
        'signalName',signalNames, 'signalValue', signals);

Поиск отсутствующих входных сигналов

На предыдущем шаге было создано сопоставление с использованием режима сопоставления имен блоков. Теперь необходимо указать пустую учетную запись inputMap и для inputMap(s) которые не были связаны с сигналом в пределах допуска. Функция getSlRootInportMap пометил эти сигналы выходной переменной hasASignal. Для этого:

if ~isempty(inputMap)
    emptyIndex = ~hasASignal;
end

Фрагмент кода выполняет шаги 1 и 2.

Завершение сопоставления

На предыдущем шаге был создан логический вектор. emptyIndex чтобы увидеть, не связан ли какой-либо из объектов inputMap с сигналом. Если все элементы вектора empireIndex имеют значение false, выполняется полное сопоставление, и код, добавленный в этом разделе, не выполняется.

Если emptyIndex вектор содержит, по крайней мере, одно значение true, вы inputMap объекты, не связанные с сигналом. Вручную назначьте переменные сигналы этой карте inputMap. Затем переопределите inputMap с именем сигнала, которое соответствует имени ожидаемого сигнала:

if isa( signals{1}, 'Simulink.SimulationData.Dataset')
    signalNames = signals{1}.getElementNames';
end

idxEmpty = find(emptyIndex==true);
for kEmpty =1:length(idxEmpty)
    idxOfEmpty = idxEmpty(kEmpty);
    destBlockName = get(inputMap(idxOfEmpty),'BlockName');
    outSideToleranceSig = [destBlockName 'x'];
    isAMatch = strcmp(signalNames, outSideToleranceSig);
    if any(isAMatch)
        inputMap(idxOfEmpty) = getRootInportMap('InputMap', ...
            inputMap(idxOfEmpty),'SignalName',outSideToleranceSig);
    end
end

Пользовательский файл сопоставления

Когда вы закончите, файл SharingBlockName.m должен напоминать следующий код.

function inputMap = AlmostBlockName(modelName, signalNames, signals)
inputMap = getRootInportMap('empty');
if bdIsLoaded(modelName)

     [inputMap, hasASignal] = getSlRootInportMap('Model', modelName, ...
     'MappingMode','BlockName',...
     'signalName',signalNames, 'signalValue', signals);

     if ~isempty(inputMap)
        emptyIndex = ~hasASignal;
        idxEmpty = find(emptyIndex==1);

        if isa( signals{1}, 'Simulink.SimulationData.Dataset')
             signalNames = signals{1}.getElementNames';
        end

        for kEmpty =1:length(idxEmpty)
            idxOfEmpty = idxEmpty(kEmpty);
            destBlockName = get(inputMap(idxOfEmpty),'BlockName');
            nonNominalSig = [destBlockName 'x'];
            isAMatch = strcmp(signalNames, nonNominalSig);
            if any(isAMatch)
                inputMap(idxOfEmpty) = getRootInportMap('InputMap', ...
                    inputMap(idxOfEmpty),'SignalName',nonNominalSig);
            end
        end

     end
end

Проверка пользовательского сопоставления

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

modelName  = 'slexAutotransRootInportsExample';
Throttlex  = timeseries(zeros(10,1));
Brake      = timeseries(ones(10,1));
signalNames= {'Throttlex' ,'Brake'};
signals    = { Throttlex  , Brake };
open_system(modelName);
inputMap   = AlmostBlockName(modelName, signalNames, signals);
inputStr   = getInputString(inputMap,'base');
close_system(modelName);

После выполнения фрагмента кода переменная inputStr содержит строку «Throttlex, Brake».

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

modelName  = 'slexAutotransRootInportsExample';
Throttlex  = timeseries(zeros(10,1));
Brake      = timeseries(ones(10,1));
ds         = Simulink.SimulationData.Dataset;
ds         = ds.addElement( Throttlex, 'Throttlex' );
ds         = ds.addElement( Brake, 'Brake' );
signalNames= {'ds'};
signals    = { ds };
open_system(modelName);
inputMap   = AlmostBlockName(modelName, signalNames, signals);
inputStr   = getInputString(inputMap,'base');
close_system(modelName);

После выполнения фрагмента кода для сигналов в наборе Simulink.PaydData.Dataset переменная inputStr содержит строку «» ds.getElement ('Throttlex'), ds.getElement ('Brake') '.