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

Когда настроить графики из командной строки

Можно настроить любой график отклика из командной строки. Командная строка является самым эффективным способом настроить большое количество графиков. Например, если у вас есть пакетное задание, которое производит много графиков, можно изменить модули оси X автоматически для всего графика со всего несколькими строками кода.

Как настроить графики из командной строки

Можно использовать прикладной программный интерфейс (API) Control System Toolbox™, чтобы настроить опции графического вывода для графиков отклика из командной строки.

Настроить графики из командной строки:

Измените модули диаграммы Боде из командной строки

В этом примере показано, как изменить модули Диаграммы Боде от rad/s до Гц.

Создайте систему и сгенерируйте Диаграмму Боде ответа системы. График использует модули по умолчанию, rad/s.

sys = tf(4,[1 0.5 4]);
h = bodeplot(sys);

bodeplot команда возвращает указатель графика, который можно использовать, чтобы изменить свойства графика.

Измените модули в Гц.

p = getoptions(h);
p.FreqUnits = 'Hz';
setoptions(h,p)

Метка оси X обновляется, чтобы отразить изменение модуля.

Для большего количества примеров настройки графиков из командной строки смотрите Примеры Настройки Графиков из Командной строки.

Обзор указателей опций графика

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

Получение указателя

getoptions функция получает указатель опций графика из указателя графика.

p=getoptions(h) % Returns plot options handle p for plot handle h.

Если вы задаете имя свойства как входной параметр, getoptions возвращает значение свойства, сопоставленное с именем свойства.

property_value=getoptions(h,PropertyName) % Returns a property 
                                          % value.

Создание указателя

Можно создать указатель опций графика по умолчанию при помощи функций в форме

<responseplot>options

Например,

p=bodeoptions;

инстанцирует указателя для Диаграмм Боде. См. Свойства и Ссылка Значений для списка значений по умолчанию.

Если вы хотите установить значения по умолчанию на значения по умолчанию Control System Toolbox, передайте cstprefs к функции. Например,

p = bodeoptions('cstprefs');

установите пары свойства/значения Диаграммы Боде на значения по умолчанию Control System Toolbox.

Эта таблица приводит функции, которые создают указатель опций графика.

Какие свойства можно изменить?

Использование

help <responseplot>options

видеть список доступных пар значения свойства, которые можно изменить. Например,

help bodeoptions

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

См. Свойства и Ссылка Значений для полного списка пар свойства/значения для графиков отклика.

Управление указателями опций графика

Существует два основных способа управлять указателями опции графика:

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

sys = tf(1,[1 1]);

Изменение модулей графика

Измените единицы частоты Диаграммы Боде от rad/s до Гц. Для этого извлеките опции p от указателя графика отредактируйте опции и присвойте их назад графику.

h = bodeplot(sys);
p = getoptions(h); 
p.FreqUnits = 'Hz'; 
setoptions(h,p)

В качестве альтернативы вместо того, чтобы извлечь p, установите опции h непосредственно.

setoptions(h,'FreqUnits','Hz')

Создайте графики Используя существующий указатель опций графика

Можно использовать существующий указатель опций графика, чтобы настроить второй график:

h1 = bodeplot(sys);
p1 = getoptions(h1);
h2 = bodeplot(sys,p1);

или

h1 = bodeplot(sys);
h2 = bodeplot(sys2);
setoptions(h2,getoptions(h1))

Создание указателя опций графика по умолчанию

Инстанцируйте указателя опций графика с этим кодом.

p = bodeoptions;

Измените единицы частоты и примените изменения в sys.

p.FreqUnits ='Hz';
h = bodeplot(sys,p);

Используя запись через точку как структура

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

h1 = bodeplot(sys);
p1 = getoptions(h1);
p1.FreqUnits = 'Hz';
p1.Title.String  =  'My Title';
setoptions(h1,p1)

Установка Пар Свойства в setoptions

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

h1 = bodeplot(sys)
setoptions(h1,'FreqUnits','Hz')

Проверьте, что модули изменились от rad/s до Гц.

getoptions(h1,'FreqUnits') % Returns frequency units for h1.

ans =

Hz

Пары свойства/Значения, Характерные для Всех Графиков отклика

Следующие таблицы обсуждают пары свойства/значения, характерные для всех графиков отклика.

Диаграммы Боде

Сингулярные значения Ганкеля

Графики Николса

Найквист строит диаграмму

Карты полюса/Нуля

Графики сигмы

Графики отклика времени