setoptions

プロットオプションハンドルまたはプロットのオプションプロパティを設定する

構文

setoptions(h,p)

setoptions(h,'property1','value1',...,'propertyN','valueN')

setoptions(h,p,'property1','value1',...,'propertyN','valueN')

説明

setoptions を使用してプロットハンドルオプションまたはプロパティリストを設定し、それを使用して座標軸のラベル、座標軸の範囲、座標軸の単位の変更など、プロットをカスタマイズできます。各プロットタイプに使用可能なプロパティと値の一覧は、プロパティと値のリファレンス (Control System Toolbox)を参照してください。プロットハンドルを使用して既存のプロットをカスタマイズするには、次のようにします。

プロットハンドルを取得
getoptions を使用してオプションセットを取得
setoptions を使用してプロットを更新し、必要なオプションを変更

詳細については、コマンドラインからの応答プロットのカスタマイズ (Control System Toolbox)を参照してください。

setoptions(h,p) は、プロットハンドル h とプロットオプションについての情報を格納したプロットオプションハンドル p を使用して応答プロットの基本設定を設定します。

例

setoptions(h,'property1','value1',...,'propertyN','valueN') は、プロットオプションハンドル p を使用する代わりに、値をプロパティと値のペアに割り当てます。各プロットタイプに使用可能なプロパティと値の一覧は、プロパティと値のリファレンス (Control System Toolbox)を参照してください。

例

setoptions(h,p,'property1','value1',...,'propertyN','valueN') は、最初にプロットオプションハンドル p を使用してプロパティを割り当てます。次に、指定されたプロパティと値のペアで決まるプロパティをオーバーライドします。各プロットタイプに使用可能なプロパティと値の一覧は、プロパティと値のリファレンス (Control System Toolbox)を参照してください。

例

すべて折りたたむ

グリッド色を指定したインパルスプロット

ライブスクリプトを開く

この例では、3 つの入力、3 つの出力および 3 つの状態をもつ MIMO 状態空間モデルについて考えます。赤のグリッドラインをもつインパルスプロットを作成します。

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 = impulseplot(sys_mimo)

h =

	resppack.timeplot

p = getoptions(h)

p =

                   Normalize: 'off'
         SettleTimeThreshold: 0.0200
              RiseTimeLimits: [0.1000 0.9000]
                   TimeUnits: 'seconds'
    ConfidenceRegionNumberSD: 1
                  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,'Grid','on','GridColor',[1 0 0]);

setoptions を呼び出すと、インパルスプロットは自動的に更新されます。MIMO モデルの場合、impulseplot はプロットのグリッドを生成し、各プロットは 1 組の I/O のインパルス応答を表示します。

周波数スケールと単位を指定したボード線図

ライブスクリプトを開く

この例では、3 つの入力、3 つの出力および 3 つの状態をもつ MIMO 状態空間モデルについて考えます。線形周波数スケールを使ってボード線図を作成し、周波数単位を Hz に指定して、グリッドをオンにします。

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 = bodeplot(sys_mimo);
p = getoptions(h)

p =

                   FreqUnits: 'rad/s'
                   FreqScale: 'log'
                    MagUnits: 'dB'
                    MagScale: 'linear'
                  MagVisible: 'on'
             MagLowerLimMode: 'auto'
                  PhaseUnits: 'deg'
                PhaseVisible: 'on'
               PhaseWrapping: 'off'
               PhaseMatching: 'off'
           PhaseMatchingFreq: 0
    ConfidenceRegionNumberSD: 1
                 MagLowerLim: 0
          PhaseMatchingValue: 0
         PhaseWrappingBranch: -180
                  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: {6x1 cell}
                    XLimMode: {3x1 cell}
                    YLimMode: {6x1 cell}

setoptions を使用して必要なカスタマイズでプロットを更新します。

setoptions(h,'FreqScale','linear','FreqUnits','Hz','Grid','on');

setoptions を呼び出すと、ボード線図は自動的に更新されます。MIMO モデルの場合、bodeplot はボード線図の配列を生成し、各プロットは 1 組の I/O の周波数応答を表示します。

応答プロットの周波数単位の変更

この例では次を使用します。

Control System Toolbox Control System Toolbox

ライブスクリプトを開く

次の連続時間の伝達関数を作成します。

$H (s) = \frac{1}{s + 1}$

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

プロットハンドル h を使ってボード線図を作成します。

h = bodeplot(sys);

プロットオプションのハンドル p を作成します。

p = getoptions(h);

プロットの周波数単位を Hz に変更します。

p.FreqUnits = 'Hz';

プロットオプションをボード線図に適用します。

setoptions(h,p);

あるいは、setoptions(h,'FreqUnits','Hz') を使用します。

入力引数

すべて折りたたむ

`h` — プロットハンドル
プロットハンドルオブジェクト

プロットハンドル。プロットハンドルオブジェクトとして指定します。たとえば、h は、極-零点プロットまたは I/O 極-零点プロットの mpzplot オブジェクトです。

`p` — プロットオプションハンドル
プロットオプションハンドルオブジェクト

プロットオプションハンドル。プロットオプションハンドルオブジェクトとして指定します。たとえば、p は、極-零点プロットまたは I/O 極-零点プロットの PZMapOptions オブジェクトです。

プロットオプションハンドルを作成するには、2 つの方法があります。

関数 getoptions を使用する。これは、プロットハンドルを受け入れて、プロットオプションハンドルを返す。
```
p = getoptions(h)
```
次のいずれかのコマンドを使用して、既定のプロットオプションハンドルを作成する。
- bodeoptions — ボード線図
- hsvoptions (Control System Toolbox) - ハンケル特異値プロット
- nicholsoptions (Control System Toolbox) — ニコルス線図
- nyquistoptions (Control System Toolbox) — ナイキスト線図
- pzoptions — 極-零点プロット
- sigmaoptions (Control System Toolbox) - シグマプロット
- timeoptions — 時間対応プロット (ステップ、初期、インパルスなど)
以下に例を示します。
```
p = bodeoptions
```
ボード線図に対するプロットオプションハンドルが返されます。