Syslab使用手册
⋮

# nicholsoptions

创建 Nichols 图绘制选项列表

函数库: TyControlSystems

# 描述

使用 nicholsoptions 来创建 NicholsOptions 对象以对 Nichols 图的外观进行自定义。还可以使用该命令覆盖 Nichols 绘图首选项设置。

# 语法

plotoptions = nicholsoptions()
plotoptions = nicholsoptions("cstprefs")

# 说明

plotoptions = nicholsoptions( ) 返回一组默认的 nicholsplot 绘制选项列表。使用此选项来自定义 Nichols 图的外观和属性。 示例

plotoptions = nicholsoptions("cstprefs") 初始化绘图选项，与传入的系统模型属性相适应。 示例

# 示例

使用绘图选项自定义 Nichols 图

使用自定义选项集绘制由以下传递函数表示的连续时间系统的 Nichols 图：

使用 nicholsoptions 创建一个自定义选项集。

using TyControlSystems
plotoptions = nicholsoptions()
plotoptions.FreqUnits = "Hz";
plotoptions.PhaseUnits = "rad";

TyControlSystems.NicholsOptions("rad/s", "auto", -Inf, "deg", "off", -180, "off", 0, 0)

使用指定的选项创建 Nichols 图。

sys = tf([2 5 1],[1 3 5]);
pic = nicholsplot(sys, plotoptions)
初始化 Nichols 图选项

对于此示例，绘制以下 SISO 动态系统的 Nichols，并初始化自动的绘图选项：

using TyControlSystems
H = tf([-4 48 -18 250 600],[1 30 282 525 60]);
plotoptions = nicholsoptions("cstprefs")

TyControlSystems.NicholsOptions("auto", "auto", 0, "deg", "off", -180, "off", 0, 0)

pic = nicholsplot(H, plotoptions);
nicholsgrid(true);

# 输出参数

plotoptions - 绘图选项
NicholsOptions 结构体

nicholsoptions 函数返回的结构体，包含绘图选项的信息。

数据类型： NicholsOptions 结构体

# 属性

FrequencyUnit - 频率单位

频率单位，指定为以下值之一：

  • "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"

默认： "rad/s"

MagLowerLimMode - 幅值下限模式

幅值下限模式，指定为自动（"auto"）或手动（"manual"）。

默认： "auto"

MagLowerLim - 下限幅值

下限幅值，指定为实数。

默认： -Inf

PhaseUnits - 相位单位

相位单位，指定为度（"deg"）或弧度（"rad"）。

默认： "deg"

PhaseWrapping - 使能相位处理

使能相位处理，指定为 " on " 或 " off "。当 phasewrap 设置为 " on " 时，绘图将按照 PhaseWrappingBranch 属性指定的值对累积相位进行处理。

默认： "off"

PhaseWrappingBranch - 相位缠绕值

相位缠绕值，当 PhaseWrapping 属性设置为 “ on ” 时，绘图对累积相位进行缠绕。缺省情况下，相位区间为 [-180°, 180°]。

默认： -180

PhaseMatching - 使能相位匹配

使能相位匹配，指定为 “ on ” 或 “ off ”。将 PhaseMatching 属性设置为 “ on ”，从而把 PhaseMatchingFreq 属性中指定的频率匹配到 PhaseMatchingValue 中指定的相位值。

默认： "off"

PhaseMatchingFreq - 相位匹配频率

相位匹配频率，指定为标量。

默认： 0

PhaseMatchingValue - 相位匹配响应值

相位匹配响应值，指定为标量。

默认： 0

提示

目前对于 NicholsOptions 只解析 FreqUnits、PhaseUnits 等部分参数。

# 另请参阅

nicholsplot