exponenta event banner

Simulink.sdi.snapshot

Захват содержимого графиков инспектора данных моделирования

Описание

fig = Simulink.sdi.snapshot создает фигуру области печати в открытом сеансе инспектора данных моделирования с помощью маркера изображения fig.

[fig,image] = Simulink.sdi.snapshot создает фигуру области печати в открытом сеансе инспектора данных моделирования с помощью маркера изображения fig и возвращает данные изображения в массиве, image.

Simulink.sdi.snapshot(Name,Value) захватывает изображение графика инспектора данных моделирования в соответствии с опциями, заданными парами «имя-значение».

пример

fig = Simulink.sdi.snapshot(Name,Value) захватывает изображение графика инспектора данных моделирования в соответствии с опциями, заданными парами «имя-значение». Этот синтаксис возвращает дескриптор фигуры, fig, если фигура создана.

[fig, image] = Simulink.sdi.snapshot(Name,Value) захватывает изображение графика инспектора данных моделирования в соответствии с опциями, заданными парами «имя-значение». Этот синтаксис возвращает дескриптор фигуры, figи массив данных изображения, image, если это необходимо для указанных параметров.

Примеры

свернуть все

В этом примере показано, как копировать параметры вида из одного прогона в другой и как создавать фигуры с помощью Simulink.sdi.CustomSnapshot объект.

Моделирование модели и получение объекта выполнения

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

load_system('vdp')
set_param('vdp','SaveFormat','Dataset','SaveOutput','on')
set_param('vdp/Mu','Gain','1');
sim('vdp');

Для доступа к данным прогона используется программный интерфейс «Инспектор данных моделирования».

runIndex = Simulink.sdi.getRunCount;
runID = Simulink.sdi.getRunIDByIndex(runIndex);
vdpRun = Simulink.sdi.getRun(runID);

Изменение настроек вида сигнала

Используйте Simulink.sdi.Run объект для доступа к сигналам в прогоне. Затем измените настройки вида сигнала. В этом примере указывается цвет и стиль линий для каждого сигнала. Параметры вида для прогона включают параметры вида для каждого сигнала и параметры вида, заданные для области печати.

sig1 = vdpRun.getSignalByIndex(1);
sig2 = vdpRun.getSignalByIndex(2);

sig1.LineColor = [0 0 1];
sig1.LineDashed = '-.';

sig2.LineColor = [1 0 0];
sig2.LineDashed = ':';

Захват снимка из инспектора данных моделирования

Создать Simulink.sdi.CustomSnapshot объект и используйте Simulink.sdi.snapshot функция для программного захвата снимка содержимого инспектора данных моделирования.

snap = Simulink.sdi.CustomSnapshot;

Можно использовать свойства Simulink.sdi.CustomSnapshot объект для настройки параметров печати, таких как компоновка вложенной печати и предельные значения осей, а также для печати сигналов. При использовании Simulink.sdi.CustomSnapshot для создания фигуры эти параметры печати не влияют на инспектор данных моделирования.

snap.Rows = 2;
snap.YRange = {[-2.25 2.25],[-3 3]};
snap.plotOnSubPlot(1,1,sig1,true)
snap.plotOnSubPlot(2,1,sig2,true)

Использовать Simulink.sdi.snapshot для создания фигуры, указанной в свойствах Simulink.sdi.CustomSnapshot объект.

fig = Simulink.sdi.snapshot("from","custom","to","figure","settings",snap);

Figure contains 2 axes. Axes 1 contains an object of type line. This object represents x1. Axes 2 contains an object of type line. This object represents x2.

Копирование параметров вида в новый прогон моделирования

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

set_param('vdp/Mu','Gain','5')
sim('vdp');

runIndex2 = Simulink.sdi.getRunCount;
runID2 = Simulink.sdi.getRunIDByIndex(runIndex2);
run2 = Simulink.sdi.getRun(runID2);

Чтобы создать график новых выходных данных, который выглядит как созданный на предыдущем шаге, можно скопировать параметры просмотра в прогон в одной строке кода с помощью Simulink.sdi.copyRunViewSettings. Simulink.sdi.copyRunViewSettings функция не обновляет параметры печати автоматически в Simulink.sdi.CustomSnapshot объекты, поэтому укажите plot ввод в качестве false.

sigIDs = Simulink.sdi.copyRunViewSettings(runID,runID2,false);

Захват снимка нового прогона моделирования

Используйте Simulink.sdi.CustomSnapshot для получения снимка нового прогона моделирования. Сначала очистите сигналы от вложенных графиков. Затем постройте график сигналов от нового прогона и захватите другой снимок.

snap.clearSignals
snap.YRange = {[-2.25 2.25],[-8 8]};
snap.plotOnSubPlot(1,1,sigIDs(1),true)
snap.plotOnSubPlot(2,1,sigIDs(2),true)

fig = snap.snapshot("to","figure");

Figure contains 2 axes. Axes 1 contains an object of type line. This object represents x2. Axes 2 contains an object of type line. This object represents x1.

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

свернуть все

Аргументы пары «имя-значение»

Укажите дополнительные пары, разделенные запятыми Name,Value аргументы. Name является именем аргумента и Value - соответствующее значение. Name должен отображаться внутри кавычек. Можно указать несколько аргументов пары имен и значений в любом порядке как Name1,Value1,...,NameN,ValueN.

Пример: 'to','figure','props',{'Name','My Data'}

Содержимое, включаемое в снимок.

  • 'opened' - Включить все вложенные графики в область графического просмотра открытой сессии Инспектора данных моделирования.

  • 'active' - Включить только активный (выбранный) вложенный график в открытую сессию Инспектора данных моделирования.

  • 'comparison' - включить графики сравнения для выбранного прогона сравнения или сигнала в открытую сессию инспектора данных моделирования.

  • 'custom' - Включить содержимое, указанное settings пара имя-значение Simulink.sdi.CustomSnapshot объект. Вы можете использовать 'from','custom' создание моментального снимка без открытия инспектора расчетных данных или влияния на открытую сессию инспектора расчетных данных. Включить settings пара имя-значение при указании 'from','custom'.

Пример: 'from','comparison'

Типы данных: char | string

Тип создаваемого снимка.

  • 'image' - создание фигуры и возврат дескриптора фигуры и массива данных изображения. При указании 'to','image', fig и image оба выхода имеют значение.

  • 'figure' - создать фигуру и вернуть маркер перемещения фигуры. При указании 'to','figure' fig выходной сигнал имеет значение, и image выход пуст.

  • 'file' - Сохранить в файл PNG с именем, указанным filename пара имя-значение. Если не указать filename пара имя-значение, имя файла plots.png. При указании 'to','file', fig и image оба выхода пусты.

  • 'clipboard' - Скопируйте графики в системный буфер обмена. Из буфера обмена можно вставить изображение в другую программу, например Microsoft ® Word. При указании'to','clipboard', fig и image оба выхода пусты.

Пример: 'to','file'

Типы данных: char | string

Имя файла изображения для хранения моментального снимка при указании 'to','file'.

Пример: 'filename','MyImage.png'

Типы данных: char | string

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

Пример: 'props',{'Name','MyData','NumberTitle','off'}

Типы данных: char | string

Simulink.sdi.CustomSnapshot объект, задающий пользовательские параметры моментального снимка. Вы можете использовать settings пара «имя-значение» для задания размеров изображения в пикселях, макета вложенной печати и пределов для осей x и y.

Пример: 'settings',customSnap

Типы данных: char | string

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

свернуть все

Ручка для фигуры. Если фигура не создана с указанными опциями, fig выход пуст.

Массив данных изображения. image вывод имеет значение при использовании Simulink.sdi.snapshot без каких-либо входных аргументов или без to пара имя-значение и при указании 'to','image'.

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