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изображение] = 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 objects. Axes object 1 contains an object of type line. This object represents x1. Axes object 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 objects. Axes object 1 contains an object of type line. This object represents x2. Axes object 2 contains an object of type line. This object represents x1.

Входные параметры

свернуть все

Аргументы name-value

Задайте дополнительные разделенные запятой пары 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

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

Пример: '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