exponenta event banner

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 производит массив схем Найквиста, каждого графика, отображающего частотную характеристику одной пары ввода-вывода.

Введенный в R2011a