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

Рабочий процесс

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

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

Примите следующий сценарий:

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

Имена блока импорта корневого уровня:

Имена переменной сигнала:

Чтобы сопоставить входные параметры с корневым уровнем импортируют блоки в этом сценарии, вам нужна пользовательская функция отображения для инструмента Root Inport Mapper. Этот пример использует AlmostBlockName пользовательская функция отображения.

В данном примере вы будете использовать модель slexAutotransRootInportsExample, чтобы подтвердить вашу пользовательскую функцию отображения.

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

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

function inputMap = AlmostBlockName( modelName, signalNames, signals )

Получите отображение Simulink BlockName

Затем, сопоставьте все сигналы. Для этого сначала сопоставьте все сигналы в допуске с помощью блока 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

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

Завершите отображение

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

Если вектор emptyIndex содержит по крайней мере одно значение, которое верно, у вас есть объекты 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

Пользовательский файл карты

По окончании, файл, AlmostBlockName.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, Тормоз'.

Если ваши сигналы находятся в Simulink. SimulationData. Набор данных, чтобы видеть результаты вашей функции отображения, использует следующий фрагмент кода в Окне Команды 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. SimulationData. Набор данных, переменная inputStr содержит строку 'ds.getElement ('Throttlex'), ds.getElement ('Тормоз')'.