nyquistoptions

Создайте список опций годографа Найквиста

Описание

Используйте nyquistoptions команда, чтобы создать NyquistPlotOptions объект настроить ваш внешний вид годографа Найквиста. Можно также использовать команду, чтобы заменить настройки настройки графика в MATLAB® сеанс, на котором вы создаете годографы Найквиста.

Создание

Описание

пример

plotoptions = nyquistoptions возвращает набор по умолчанию опций графика для использования с nyquistplot команда. Можно использовать эти опции, чтобы настроить внешний вид годографа Найквиста с помощью командной строки. Этот синтаксис полезен, когда это необходимо, чтобы записать скрипт, чтобы сгенерировать графики, которые выглядят одинаково независимо от настроек preference сеанса работы с MATLAB, в котором вы запускаете скрипт.

пример

plotoptions = nyquistoptions('cstprefs') инициализирует опции графика опциями, которые вы выбрали в Control System Toolbox™ и Редакторе Настроек System Identification Toolbox™. Для получения дополнительной информации о редакторе, см. Редактор Настроек Тулбокса. Этот синтаксис полезен, когда это необходимо, чтобы изменить несколько опций графика, но в противном случае использовать ваши настройки по умолчанию. Скрипт, который использует этот синтаксис, может сгенерировать результаты, которые выглядят по-другому, когда запущено на сеансе с различными настройками.

Свойства

развернуть все

Единицы частоты в виде одного из следующих значений:

  • 'Hz'

  • 'rad/second'

  • 'rpm'

  • 'kHz'

  • 'MHz'

  • 'GHz'

  • 'rad/nanosecond'

  • 'rad/microsecond'

  • 'rad/millisecond'

  • 'rad/minute'

  • 'rad/hour'

  • 'rad/day'

  • 'rad/week'

  • 'rad/month'

  • 'rad/year'

  • 'cycles/nanosecond'

  • 'cycles/microsecond'

  • 'cycles/millisecond'

  • 'cycles/hour'

  • 'cycles/day'

  • 'cycles/week'

  • 'cycles/month'

  • 'cycles/year'

Единицы величины в виде любого 'dB'или абсолютное значение 'abs'.

Модули фазы в виде любого 'deg'или 'rad'чтобы превратиться в степени или радианы, соответственно.

Переключите отображение ответа для отрицательных частот в виде любого 'on'или 'off'.

Количество стандартных отклонений, чтобы использовать, чтобы построить область доверия в виде скаляра. Это применимо к идентифицированным моделям только.

Частотный интервал замещающих знаков доверия, чтобы использовать, чтобы построить область доверия в виде скаляра. Это применимо к идентифицированным моделям только. Значением по умолчанию является 5, что означает, что замещающие знаки доверия показывают на каждой 5-й выборке частоты

Группировка ввода - вывода (ввод-вывод) пары в виде одного из следующего:

  • 'none''— Никакая группировка ввода - вывода.

  • 'inputs'— Группа только входные параметры.

  • Выходные параметры '— Группа только выходные параметры.

  • все'— Группа все пары ввода-вывода.

Введите стиль метки в виде структуры со следующими полями:

  • FontSize — Размер шрифта в виде скалярного значения, больше, чем нуль в модулях точки. Размер шрифта по умолчанию зависит от конкретной операционной системы и локали. Одна точка равняется 1/72 дюйм.

  • FontWeight — Символьная толщина в виде 'Normal'или 'bold'. MATLAB использует FontWeight свойство выбрать шрифт от доступных в вашей системе. Не все шрифты имеют полужирный вес. Поэтому определение полужирной толщины шрифта может все еще привести к обычной толщине шрифта.

  • FontAngle — Символьный наклон в виде 'Normal'или 'italic'. Не все шрифты имеют оба стиля шрифта. Поэтому курсивный шрифт может выглядеть одинаково как обычный шрифт.

  • Color — Цвет текста в виде триплета RGB. Цвет по умолчанию темно-сер с триплетом RGB [0.4,0.4,0.4].

  • Interpreter — Текстовый интерпретатор в виде одного из этих значений:

    • 'tex'— Интерпретируют символы с помощью подмножества разметки TeX. Это - значение по умолчанию Interpreter.

    • 'latex'— Интерпретируют символы, использующие разметку LATEX.

    • 'none''— буквенные символы Отображения.

Выведите стиль метки в виде структуры со следующими полями:

  • FontSize — Размер шрифта в виде скалярного значения, больше, чем нуль в модулях точки. Размер шрифта по умолчанию зависит от конкретной операционной системы и локали. Одна точка равняется 1/72 дюйм.

  • FontWeight — Символьная толщина в виде 'Normal'или 'bold'. MATLAB использует FontWeight свойство выбрать шрифт от доступных в вашей системе. Не все шрифты имеют полужирный вес. Поэтому определение полужирной толщины шрифта может все еще привести к обычной толщине шрифта.

  • FontAngle — Символьный наклон в виде 'Normal'или 'italic'. Не все шрифты имеют оба стиля шрифта. Поэтому курсивный шрифт может выглядеть одинаково как обычный шрифт.

  • Color — Цвет текста в виде триплета RGB. Цвет по умолчанию темно-сер с триплетом RGB [0.4,0.4,0.4].

  • Interpreter — Текстовый интерпретатор в виде одного из этих значений:

    • 'tex'— Интерпретируют символы с помощью подмножества разметки TeX. Это - значение по умолчанию Interpreter.

    • 'latex'— Интерпретируют символы, использующие разметку LATEX.

    • 'none''— буквенные символы Отображения.

Переключите отображение входных параметров в виде любого {'on'}off или массив ячеек с несколькими элементами.

Переключите отображение выходных параметров в виде любого {'on'}off или массив ячеек с несколькими элементами.

Текст заголовка и стиль в виде структуры со следующими полями:

  • String — Текст метки в виде вектора символов. По умолчанию графиком является названный 'Bode Diagram'.

  • FontSize — Размер шрифта в виде скалярного значения, больше, чем нуль в модулях точки. Размер шрифта по умолчанию зависит от конкретной операционной системы и локали. Одна точка равняется 1/72 дюйм.

  • FontWeight — Символьная толщина в виде 'Normal'или 'bold'. MATLAB использует FontWeight свойство выбрать шрифт от доступных в вашей системе. Не все шрифты имеют полужирный вес. Поэтому определение полужирной толщины шрифта может все еще привести к обычной толщине шрифта.

  • FontAngle — Символьный наклон в виде 'Normal'или 'italic'. Не все шрифты имеют оба стиля шрифта. Поэтому курсивный шрифт может выглядеть одинаково как обычный шрифт.

  • Color — Цвет текста в виде триплета RGB. Цвет по умолчанию черный заданный триплетом RGB [0,0,0].

  • Interpreter — Текстовый интерпретатор в виде одного из этих значений:

    • 'tex'— Интерпретируют символы с помощью подмножества разметки TeX. Это - значение по умолчанию Interpreter.

    • 'latex'— Интерпретируют символы, использующие разметку LATEX.

    • 'none''— буквенные символы Отображения.

Текст метки оси X и стиль в виде структуры со следующими полями:

  • String — Текст метки в виде вектора символов. По умолчанию осью является названный Real Axis.

  • FontSize — Размер шрифта в виде скалярного значения, больше, чем нуль в модулях точки. Размер шрифта по умолчанию зависит от конкретной операционной системы и локали. Одна точка равняется 1/72 дюйм.

  • FontWeight — Символьная толщина в виде 'Normal'или 'bold'. MATLAB использует FontWeight свойство выбрать шрифт от доступных в вашей системе. Не все шрифты имеют полужирный вес. Поэтому определение полужирной толщины шрифта может все еще привести к обычной толщине шрифта.

  • FontAngle — Символьный наклон в виде 'Normal'или 'italic'. Не все шрифты имеют оба стиля шрифта. Поэтому курсивный шрифт может выглядеть одинаково как обычный шрифт.

  • Color — Цвет текста в виде триплета RGB. Цвет по умолчанию черный заданный триплетом RGB [0,0,0].

  • Interpreter — Текстовый интерпретатор в виде одного из этих значений:

    • 'tex'— Интерпретируют символы с помощью подмножества разметки TeX. Это - значение по умолчанию Interpreter.

    • 'latex'— Интерпретируют символы, использующие разметку LATEX.

    • 'none''— буквенные символы Отображения.

Текст метки оси Y и стиль в виде структуры со следующими полями:

  • String — Текст метки в виде массива ячеек из символьных векторов. По умолчанию осью является названный Imaginary Axis.

  • FontSize — Размер шрифта в виде скалярного значения, больше, чем нуль в модулях точки. Размер шрифта по умолчанию зависит от конкретной операционной системы и локали. Одна точка равняется 1/72 дюйм.

  • FontWeight — Символьная толщина в виде 'Normal'или 'bold'. MATLAB использует FontWeight свойство выбрать шрифт от доступных в вашей системе. Не все шрифты имеют полужирный вес. Поэтому определение полужирной толщины шрифта может все еще привести к обычной толщине шрифта.

  • FontAngle — Символьный наклон в виде 'Normal'или 'italic'. Не все шрифты имеют оба стиля шрифта. Поэтому курсивный шрифт может выглядеть одинаково как обычный шрифт.

  • Color — Цвет текста в виде триплета RGB. Цвет по умолчанию черный заданный триплетом RGB [0,0,0].

  • Interpreter — Текстовый интерпретатор в виде одного из этих значений:

    • 'tex'— Интерпретируют символы с помощью подмножества разметки TeX. Это - значение по умолчанию Interpreter.

    • 'latex'— Интерпретируют символы, использующие разметку LATEX.

    • 'none''— буквенные символы Отображения.

Стиль метки в виде галочки в виде структуры со следующими полями:

  • FontSize — Размер шрифта в виде скалярного значения, больше, чем нуль в модулях точки. Размер шрифта по умолчанию зависит от конкретной операционной системы и локали. Одна точка равняется 1/72 дюйм.

  • FontWeight — Символьная толщина в виде 'Normal'или 'bold'. MATLAB использует FontWeight свойство выбрать шрифт от доступных в вашей системе. Не все шрифты имеют полужирный вес. Поэтому определение полужирной толщины шрифта может все еще привести к обычной толщине шрифта.

  • FontAngle — Символьный наклон в виде 'Normal'или 'italic'. Не все шрифты имеют оба стиля шрифта. Поэтому курсивный шрифт может выглядеть одинаково как обычный шрифт.

  • Color — Цвет текста в виде триплета RGB. Цвет по умолчанию черный заданный триплетом RGB [0,0,0].

Переключите отображение сетки на графике в виде любого 'off'или 'on'.

Цвет линий сетки в виде триплета RGB. Цвет по умолчанию светло-сер заданный триплетом RGB [0.15,0.15,0.15].

Режим выбора для оси X ограничивает в виде одного из этих значений:

  • 'auto''— Включают автоматический предельный выбор, который основан на общем промежутке отображенных на графике данных.

  • 'manual'— Вручную задают пределы по осям. Чтобы задать пределы по осям, установите XLim свойство.

Режим выбора для оси Y ограничивает в виде одного из этих значений:

  • 'auto''— Включают автоматический предельный выбор, который основан на общем промежутке отображенных на графике данных.

  • 'manual'— Вручную задают пределы по осям. Чтобы задать пределы по осям, установите YLim свойство.

Ось X ограничивает в виде массива ячеек двухэлементного вектора из формы [min,max].

Ось Y ограничивает в виде массива ячеек двухэлементного вектора из формы [min,max].

Функции объекта

nyquistplotГодограф Найквиста с дополнительными опциями настройки графика

Примеры

свернуть все

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

Сгенерируйте случайную модель в пространстве состояний с 5 состояниями и создайте схему Найквиста с указателем графика h.

rng("default")
sys = rss(5);
h = nyquistplot(sys);

Figure contains an axes object. The axes object contains an object of type line. This object represents sys.

Измените модули фазы в радианы и включите сетку. Для этого отредактируйте свойства указателя графика, h использование setoptions.

setoptions(h,'PhaseUnits','rad','Grid','on');

Figure contains an axes object. The axes object contains an object of type line. This object represents sys.

Годограф Найквиста автоматически обновляется, когда вы вызываете setoptions.

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

plotoptions = nyquistoptions('cstprefs');

Измените свойства опций, установленных путем установки модулей фазы на радианы и включения сетки.

plotoptions.PhaseUnits = 'rad';
plotoptions.Grid = 'on';
nyquistplot(sys,plotoptions);

Figure contains an axes object. The axes object contains an object of type line. This object represents sys.

Можно использовать тот же набор опции, чтобы создать несколько годографов Найквиста с той же индивидуальной настройкой. В зависимости от ваших собственных настроек тулбокса график, который вы получаете, может отличаться от этого графика. Только свойства, которые вы устанавливаете явным образом в этом примере PhaseUnits и Grid, замените настройки тулбокса.

Сравните частотные характеристики идентифицированных моделей в пространстве состояний порядка 2 и 6 наряду с их 1-std области доверия представляются на каждой 50-й выборке частоты.

Загрузите идентифицированные данные модели и оцените модели в пространстве состояний с помощью n4sid. Затем постройте схему Найквиста.

load iddata1
sys1 = n4sid(z1,2); 
sys2 = n4sid(z1,6);
w = linspace(10,10*pi,256);
h = nyquistplot(sys1,sys2,w);

Figure contains an axes object. The axes object with title From: u1 To: y1 contains 2 objects of type line. These objects represent sys1, sys2.

Обе модели производят приблизительно 76%-ю подгонку к данным. Однако sys2 показывает более высокую неопределенность в ее частотной характеристике, особенно близко к частоте Найквиста как показано графиком. Чтобы видеть это, покажите область доверия в подмножестве точек, в которых отображен ответ Найквиста.

setoptions(h,'ConfidenceRegionDisplaySpacing',50,...
             'ShowFullContour','off');

Figure contains an axes object. The axes object with title From: u1 To: y1 contains 2 objects of type line. These objects represent sys1, sys2.

Чтобы включить отображение области доверия, щелкните правой кнопкой по графику и выберите Characteristics> Confidence Region.

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

Создайте модель в пространстве состояний MIMO sys_mimo.

J = [8 -3 -3; -3 8 -3; -3 -3 8];
F = 0.2*eye(3);
A = -J\F;
B = inv(J);
C = eye(3);
D = 0;
sys_mimo = ss(A,B,C,D);
size(sys_mimo)
State-space model with 3 outputs, 3 inputs, and 3 states.

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

h = nyquistplot(sys_mimo);

Figure contains 9 axes objects. Axes object 1 with title From: In(1) contains an object of type line. This object represents sys\_mimo. Axes object 2 contains an object of type line. This object represents sys\_mimo. Axes object 3 contains an object of type line. This object represents sys\_mimo. Axes object 4 with title From: In(2) contains an object of type line. This object represents sys\_mimo. Axes object 5 contains an object of type line. This object represents sys\_mimo. Axes object 6 contains an object of type line. This object represents sys\_mimo. Axes object 7 with title From: In(3) contains an object of type line. This object represents sys\_mimo. Axes object 8 contains an object of type line. This object represents sys\_mimo. Axes object 9 contains an object of type line. This object represents sys\_mimo.

p = getoptions(h)
p =

                         FreqUnits: 'rad/s'
                          MagUnits: 'dB'
                        PhaseUnits: 'deg'
                   ShowFullContour: 'on'
          ConfidenceRegionNumberSD: 1
    ConfidenceRegionDisplaySpacing: 5
                        IOGrouping: 'none'
                       InputLabels: [1x1 struct]
                      OutputLabels: [1x1 struct]
                      InputVisible: {3x1 cell}
                     OutputVisible: {3x1 cell}
                             Title: [1x1 struct]
                            XLabel: [1x1 struct]
                            YLabel: [1x1 struct]
                         TickLabel: [1x1 struct]
                              Grid: 'off'
                         GridColor: [0.1500 0.1500 0.1500]
                              XLim: {3x1 cell}
                              YLim: {3x1 cell}
                          XLimMode: {3x1 cell}
                          YLimMode: {3x1 cell}

Используйте setoptions обновить график с требует индивидуальной настройки.

setoptions(h,'ShowFullContour','off','Grid','on');

Figure contains 9 axes objects. Axes object 1 with title From: In(1) contains an object of type line. This object represents sys\_mimo. Axes object 2 contains an object of type line. This object represents sys\_mimo. Axes object 3 contains an object of type line. This object represents sys\_mimo. Axes object 4 with title From: In(2) contains an object of type line. This object represents sys\_mimo. Axes object 5 contains an object of type line. This object represents sys\_mimo. Axes object 6 contains an object of type line. This object represents sys\_mimo. Axes object 7 with title From: In(3) contains an object of type line. This object represents sys\_mimo. Axes object 8 contains an object of type line. This object represents sys\_mimo. Axes object 9 contains an object of type line. This object represents sys\_mimo.

Годограф Найквиста автоматически обновляется, когда вы вызываете setoptions. Для моделей MIMO, nyquistplot производит массив схем Найквиста, каждого графика, отображающего частотную характеристику одной пары ввода-вывода.

Представленный в R2012a