Создание данных рабочей области

Сначала создайте данные рабочей области для импорта в Данные Моделирования Inspector с помощью пользовательского считывателя. Предположим, что вы храните каждый сигнал как структуру с полями для данных (d), значений времени (t) и имя сигнала (n).

time = 0:0.1:100;
time = time';
lineData = 1/4*time;
sineWave = sin((2*pi)/50*time);
squareWave = square((2*pi)/30*time);

mySineVar.d = sineWave;
mySineVar.t = time;
mySineVar.n = "Sine Wave";

myLineVar.d = lineData;
myLineVar.t = time;
myLineVar.n = "Line";

mySquareVar.d = squareWave;
mySquareVar.t = time;
mySquareVar.n = "Square Wave";

Напишите определение класса для пользовательского считывателя

Написание определения класса, которое задает, как пользовательский считыватель извлекает соответствующие данные и метаданные из переменных рабочей области. Сохраните файл определения класса в расположении на MATLAB™ пути.

Определение класса начинается с наследования от io.reader класс, за которым следуют определения свойств и методов. Пользовательский считыватель в этом примере задает свойство ChannelIndex. Можно использовать считыватель для импорта отдельных структур или массива структур из рабочей области. The ChannelIndex свойство используется при импорте массива структур.

classdef SimpleStructReader < io.reader

    properties
        ChannelIndex
    end

Каждый пользовательский считыватель должен задать getName, getTimeValues, и getDataValues методы. При написании пользовательского считывателя для импорта данных из рабочей области необходимо также задать supportsVariable способ. Читатель в этом примере также задает getChildren метод для поддержки импорта массива структур.

The supportsVariable метод проверяет, какие переменные в рабочей области поддерживаются читателем. В этом примере supportsVariable возвращает true когда:

function supported = supportsVariable(~, val)
    % Support structure with fields t (time), d (data), and n (name)
    supported = ...
        isstruct(val) && ...
        isfield(val,'t') && ...
        isfield(val,'d') && ...
        isfield(val,'n');
    if supported
        for idx = 1:numel(val)
            varName = val(idx).n;
            time = val(idx).t;
            varData = val(idx).d;
                    
            % Name must be string or character array
            if ~ischar(varName) && ~isstring(varName)
                supported = false;

            % Time must be double column vector
            elseif ~isa(time,'double') || ~iscolumn(time)
                supported = false;

            % Data size must match time size
            else
                timeSz = size(time);
                dataSz = size(varData);
                        
                if ~isnumeric(varData) || ~isequal(dataSz, timeSz)
                    supported = false;
                end
            end
        end
    end
end

The getChildren метод создает SimpleStructReader объект для каждой структуры в массиве структур. Когда импортируемая переменная не скаляром, getChildren метод присваивает значение ChannelIndex свойство добавлено к классу для пользовательского считывателя. The VariableValue свойство для каждого SimpleStructReader объект, возвращенный getChildren метод является массивом структур. Другие методы используют ChannelIndex свойство для извлечения соответствующего имени сигнала, данных сигнала и временных значений из каждого объекта.

function childObj = getChildren(obj)
    childObj = {};
    if ~isscalar(obj.VariableValue) && isempty(obj.ChannelIndex)
        numChannels = numel(obj.VariableValue);
        childObj = cell(numChannels,1);
        for idx = 1:numChannels
            childObj{idx} = SimpleStructReader;
            childObj{idx}.VariableName = sprintf('%s(%d)',obj.VariableName,idx);
            childObj{idx}.VariableValue = obj.VariableValue;
            childObj{idx}.ChannelIndex = idx;
        end
    end
end

The getName метод присваивает имя, хранящееся в n поле структуры к каждому импортированному сигналу. Когда импортированная переменная скаляром, метод получает имя от VariableValue свойство SimpleStructReader объект. Когда импортированные данные являются массивом структур, соответствующая структура извлекается из VariableValue свойство с использованием ChannelIndex свойство. Узел верхнего уровня массива имеет имя Signal Array.

function retName = getName(obj)
    if isscalar(obj.VariableValue)
        retName = char(obj.VariableValue.n);
    elseif ~isempty(obj.ChannelIndex)
        varVal = obj.VariableValue(obj.ChannelIndex);
        retName = char(varVal.n);
    else
        retName = 'Signal Array';
    end
end

The getTimeVals и getDataVals методы обрабатывают скалярные и нескалярные структуры, аналогичные тому, как getName метод делает. Для скалярной структуры оба метода извлекают соответствующее поле из VariableValue свойство SimpleStructReader объект. Для нескалярной структуры оба метода получают доступ к соответствующей структуре в VariableValue свойство с использованием ChannelIndex свойство. Наконец, для узла верхнего уровня массива время и данные возвращаются как пустые.

function timeVals = getTimeValues(obj)
    if isscalar(obj.VariableValue)
        timeVals = obj.VariableValue.t;
    elseif ~isempty(obj.ChannelIndex)
        varVal = obj.VariableValue(obj.ChannelIndex);
        timeVals = varVal.t;
    else
        timeVals = [];
    end
end
        
function dataVals = getDataValues(obj)
    if isscalar(obj.VariableValue)
        dataVals = obj.VariableValue.d;
    elseif ~isempty(obj.ChannelIndex)
        varVal = obj.VariableValue(obj.ChannelIndex);
        dataVals = varVal.d;
    else
        dataVals = [];
    end
end

Регистрация пользовательского считывателя

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

registerWorkspaceReader(SimpleStructReader);

Чтобы подтвердить, что считыватель зарегистрирован, используйте io.reader.getRegisteredWorkspaceReaders способ.

io.reader.getRegisteredWorkspaceReaders

ans = 
"SimpleStructReader"

Импорт данных рабочей области в пользовательский формат

После регистрации пользовательского устройства чтения данных рабочей области можно импортировать переменные рабочей области, сохраненные с использованием пользовательского формата, в Данные моделирования Inspector с помощью пользовательского интерфейса или Simulink.sdi.createRun функция.

Чтобы импортировать данные с помощью пользовательского интерфейса, откройте Данные моделирования Inspector. Можно использовать Simulink.sdi.view чтобы открыть Данные моделирования Inspector из Командного окна MATLAB. Затем выберите Import.

Диалоговое окно Import показывает данные в базовом рабочем пространстве, которые Данные Моделирования Inspector могут импортировать с помощью встроенных и зарегистрированных пользовательских считывателей. Поскольку пользовательский считыватель зарегистрирован, Line, Sine Wave, и Square Wave сигналы доступны для импорта, в то время как lineData, sineWave, и squareWave переменные. Выберите данные, которые вы хотите импортировать, и выберите Импортировать. Импорт данных в запуск под названием Imported_Data.

Чтобы импортировать данные из рабочей области программно, используйте Simulink.sdi.createRun функция.

Simulink.sdi.createRun('Custom Workspace Data Run','vars',myLineVar,mySineVar,mySquareVar);

Пользовательский считыватель в этом примере может также импортировать массив структур. Импорт массива переменных рабочей области вместо импорта их индивидуально группирует переменные при импорте данных в существующий запуск. Создайте массив, который содержит myLineVar, mySineVar, и mySquareVar структуры и импорт массива с помощью Simulink.sdi.createRun функция.

myVarArray = [myLineVar; mySineVar; mySquareVar];
Simulink.sdi.createRun('Workspace Array Run','vars',myVarArray);

Просмотр и анализ импортированных данных

После импорта данных можно использовать Simulation Data Inspector, чтобы проверить и проанализировать импортированные данные самостоятельно или вместе со связанными данными моделирования.