Main Content

sectorplotoptions

相対インデックス プロット オプションの一覧を作成する

このページをすべて展開する

    説明

    sectorplotoptions コマンドを使用して、SectorPlotOptions オブジェクトを作成し、セクター プロットの外観をカスタマイズします。また、このコマンドを使用して、セクター プロットを作成する MATLAB® セッションの [プロット基本設定] の設定をオーバーライドすることもできます。

    作成

    構文

    plotoptions = sectorplotoptions
    plotoptions = sectorplotptions('cstprefs')

    説明

    例

    plotoptions = sectorplotoptions は、passiveplot および sectorplot コマンドで使用するプロット オプションの既定のセットを返します。これらのオプションを使用して、コマンド ラインからプロットの外観をカスタマイズできます。同じ外観のプロットを生成するスクリプトを記述する場合、スクリプトを実行する MATLAB セッションの基本設定にかかわらず、この構文が有用です。

    例

    plotoptions = sectorplotptions('cstprefs') は、Control System Toolbox™ 基本設定エディターで選択したオプションでプロット オプションを初期化します。エディターの詳細については、ツールボックス基本設定を参照してください。プロット オプションを少しだけ変更し、その他は既定の基本設定を使用する場合、この構文が有用です。この構文を使用するスクリプトは、異なる基本設定のセッションで実行すると、異なる結果が生じる場合があります。

    プロパティ

    すべて展開する

    周波数単位。以下のいずれかの値として指定。

    • 'Hz'

    • 'rad/s'

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

    周波数スケール。'log' または 'linear' として指定します。

    インデックスのスケール。'log' または 'linear' として指定します。

    入出力 (I/O) ペアのグループ化。次のいずれかとして指定します。

    • 'none' — 入出力のグループ化は行われません。

    • 'inputs' — 入力のみをグループ化します。

    • 'outputs' — 出力のみをグループ化します。

    • 'all' — すべての I/O ペアをグループ化します。

    入力ラベルのスタイル。次のフィールドをもつ構造体として指定します。

    • FontSize — フォント サイズ。0 より大きいスカラー値としてポイント単位で指定します。既定のフォント サイズは、特定のオペレーティング システムとロケールによって異なります。1 ポイントは 1/72 インチです。

    • FontWeight — 文字の太さ。'Normal' または 'bold' として指定します。MATLAB は、FontWeight プロパティを使用して、システムで利用できるフォントから 1 つのフォントを選択します。すべてのフォントに太字があるとは限りません。そのため、太字フォントを指定しても標準フォントの太さと変わらない場合があります。

    • FontAngle — 文字の傾斜。'Normal' または 'italic' として指定します。すべてのフォントに両方のフォント スタイルがあるとは限りません。そのため、イタリック フォントでも標準フォントと見た目が変わらない場合があります。

    • Color — テキストの色。RGB 3 成分として指定します。既定の色は、RGB 3 成分 [0.4,0.4,0.4] を含む濃いグレーです。

    • Interpreter — テキスト インタープリター。次の値のいずれかとして指定します。

      • 'tex' — TeX マークアップのサブセットを使用して文字を解釈します。これは、Interpreter の既定値です。

      • 'latex' — LaTeX マークアップを使用して文字を解釈します。

      • 'none' — リテラル文字を表示します。

    出力ラベルのスタイル。次のフィールドをもつ構造体として指定します。

    • FontSize — フォント サイズ。0 より大きいスカラー値としてポイント単位で指定します。既定のフォント サイズは、特定のオペレーティング システムとロケールによって異なります。1 ポイントは 1/72 インチです。

    • FontWeight — 文字の太さ。'Normal' または 'bold' として指定します。MATLAB は、FontWeight プロパティを使用して、システムで利用できるフォントから 1 つのフォントを選択します。すべてのフォントに太字があるとは限りません。そのため、太字フォントを指定しても標準フォントの太さと変わらない場合があります。

    • FontAngle — 文字の傾斜。'Normal' または 'italic' として指定します。すべてのフォントに両方のフォント スタイルがあるとは限りません。そのため、イタリック フォントでも標準フォントと見た目が変わらない場合があります。

    • Color — テキストの色。RGB 3 成分として指定します。既定の色は、RGB 3 成分 [0.4,0.4,0.4] を含む濃いグレーです。

    • Interpreter — テキスト インタープリター。次の値のいずれかとして指定します。

      • 'tex' — TeX マークアップのサブセットを使用して文字を解釈します。これは、Interpreter の既定値です。

      • 'latex' — LaTeX マークアップを使用して文字を解釈します。

      • 'none' — リテラル文字を表示します。

    入力の表示の切り替え。{'on'}、{'off'} または複数の要素をもつ cell 配列として指定します。

    出力の表示の切り替え。{'on'}、{'off'} または複数の要素をもつ cell 配列として指定します。

    タイトルのテキストとスタイル。次のフィールドをもつ構造体として指定します。

    • String — ラベル テキスト。文字ベクトルとして指定します。既定では、プロットは 'Singular Values' というタイトルになります。

    • FontSize — フォント サイズ。0 より大きいスカラー値としてポイント単位で指定します。既定のフォント サイズは、特定のオペレーティング システムとロケールによって異なります。1 ポイントは 1/72 インチです。

    • FontWeight — 文字の太さ。'Normal' または 'bold' として指定します。MATLAB は、FontWeight プロパティを使用して、システムで利用できるフォントから 1 つのフォントを選択します。すべてのフォントに太字があるとは限りません。そのため、太字フォントを指定しても標準フォントの太さと変わらない場合があります。

    • FontAngle — 文字の傾斜。'Normal' または 'italic' として指定します。すべてのフォントに両方のフォント スタイルがあるとは限りません。そのため、イタリック フォントでも標準フォントと見た目が変わらない場合があります。

    • Color — テキストの色。RGB 3 成分として指定します。既定の色は、RGB 3 成分 [0,0,0] で指定された黒です。

    • Interpreter — テキスト インタープリター。次の値のいずれかとして指定します。

      • 'tex' — TeX マークアップのサブセットを使用して文字を解釈します。これは、Interpreter の既定値です。

      • 'latex' — LaTeX マークアップを使用して文字を解釈します。

      • 'none' — リテラル文字を表示します。

    X 軸のラベル テキストとスタイル。次のフィールドをもつ構造体として指定します。

    • String — ラベル テキスト。文字ベクトルとして指定します。既定では、軸は周波数単位 FreqUnits に基づいたタイトルになります。

    • FontSize — フォント サイズ。0 より大きいスカラー値としてポイント単位で指定します。既定のフォント サイズは、特定のオペレーティング システムとロケールによって異なります。1 ポイントは 1/72 インチです。

    • FontWeight — 文字の太さ。'Normal' または 'bold' として指定します。MATLAB は、FontWeight プロパティを使用して、システムで利用できるフォントから 1 つのフォントを選択します。すべてのフォントに太字があるとは限りません。そのため、太字フォントを指定しても標準フォントの太さと変わらない場合があります。

    • FontAngle — 文字の傾斜。'Normal' または 'italic' として指定します。すべてのフォントに両方のフォント スタイルがあるとは限りません。そのため、イタリック フォントでも標準フォントと見た目が変わらない場合があります。

    • Color — テキストの色。RGB 3 成分として指定します。既定の色は、RGB 3 成分 [0,0,0] で指定された黒です。

    • Interpreter — テキスト インタープリター。次の値のいずれかとして指定します。

      • 'tex' — TeX マークアップのサブセットを使用して文字を解釈します。これは、Interpreter の既定値です。

      • 'latex' — LaTeX マークアップを使用して文字を解釈します。

      • 'none' — リテラル文字を表示します。

    Y 軸のラベル テキストとスタイル。次のフィールドをもつ構造体として指定します。

    • String — ラベル テキスト。文字ベクトルの cell 配列として指定します。既定では、軸は振幅単位 MagUnits に基づいたタイトルになります。

    • FontSize — フォント サイズ。0 より大きいスカラー値としてポイント単位で指定します。既定のフォント サイズは、特定のオペレーティング システムとロケールによって異なります。1 ポイントは 1/72 インチです。

    • FontWeight — 文字の太さ。'Normal' または 'bold' として指定します。MATLAB は、FontWeight プロパティを使用して、システムで利用できるフォントから 1 つのフォントを選択します。すべてのフォントに太字があるとは限りません。そのため、太字フォントを指定しても標準フォントの太さと変わらない場合があります。

    • FontAngle — 文字の傾斜。'Normal' または 'italic' として指定します。すべてのフォントに両方のフォント スタイルがあるとは限りません。そのため、イタリック フォントでも標準フォントと見た目が変わらない場合があります。

    • Color — テキストの色。RGB 3 成分として指定します。既定の色は、RGB 3 成分 [0,0,0] で指定された黒です。

    • Interpreter — テキスト インタープリター。次の値のいずれかとして指定します。

      • 'tex' — TeX マークアップのサブセットを使用して文字を解釈します。これは、Interpreter の既定値です。

      • 'latex' — LaTeX マークアップを使用して文字を解釈します。

      • 'none' — リテラル文字を表示します。

    目盛りラベルのスタイル。次のフィールドをもつ構造体として指定。

    • FontSize — フォント サイズ。0 より大きいスカラー値としてポイント単位で指定します。既定のフォント サイズは、特定のオペレーティング システムとロケールによって異なります。1 ポイントは 1/72 インチです。

    • FontWeight — 文字の太さ。'Normal' または 'bold' として指定します。MATLAB は、FontWeight プロパティを使用して、システムで利用できるフォントから 1 つのフォントを選択します。すべてのフォントに太字があるとは限りません。そのため、太字フォントを指定しても標準フォントの太さと変わらない場合があります。

    • FontAngle — 文字の傾斜。'Normal' または 'italic' として指定します。すべてのフォントに両方のフォント スタイルがあるとは限りません。そのため、イタリック フォントでも標準フォントと見た目が変わらない場合があります。

    • Color — テキストの色。RGB 3 成分として指定します。既定の色は、RGB 3 成分 [0,0,0] で指定された黒です。

    プロットでのグリッド表示の切り替え。'off' または 'on' として指定します。

    グリッド ラインの色。RGB 3 成分として指定します。既定の色は、RGB 3 成分 [0.15,0.15,0.15] で指定された薄いグレーです。

    X 軸の範囲の選択モード。次のいずれかの値として指定します。

    • 'auto' — 自動範囲選択を有効にします。プロットされたデータの全範囲に基づきます。

    • 'manual' — 軸の範囲を手動で指定します。軸の範囲を指定するには、XLim プロパティを設定します。

    Y 軸の範囲の選択モード。次のいずれかの値として指定します。

    • 'auto' — 自動範囲選択を有効にします。プロットされたデータの全範囲に基づきます。

    • 'manual' — 軸の範囲を手動で指定します。軸の範囲を指定するには、YLim プロパティを設定します。

    X 軸の範囲。[min,max] 形式の 2 要素ベクトルを含む cell 配列として指定します。

    Y 軸の範囲。[min,max] 形式の 2 要素ベクトルを含む cell 配列として指定します。

    オブジェクト関数

    passiveplot受動性インデックスの周波数の関数としての計算またはプロット
    sectorplot周波数の関数としてのセクター インデックスの計算またはプロット

    例

    すべて折りたたむ

    ライブ スクリプトを開く

    この例では、タイトルに 15 ポイントの赤いテキストを使用する受動性インデックス プロットを作成します。このプロットは、それを生成する MATLAB® セッションの基本設定にかかわらず、外観が同じになります。

    最初に、sectorplotoptions を使用して既定のオプション セットを作成します。

    plotoptions = sectorplotoptions;

    次に、オプション セット plotoptions の必要なプロパティを変更します。

    plotoptions.Title.FontSize = 15;
plotoptions.Title.Color = [1 0 0];
plotoptions.FreqUnits = 'Hz';
plotoptions.Grid = 'on';

    次に、オプション セット plotoptions を使用して受動性インデックス プロットを作成します。

    G = tf(1,[1 1]);
passiveplot(G,plotoptions)

    plotoptions は固定のオプション セットで開始されるため、プロットの結果は現在の MATLAB セッションのツールボックス基本設定とは独立したものになります。

    ライブ スクリプトを開く

    この例では、複素係数をもつモデルの相対セクター プロットを作成します。次に、グリッドをオンにして、プロットの名前を変更し、周波数スケールを変更します。

    複素数データをもつ状態空間モデルを作成してセクターの形状を指定します。

    A = [-3.50,-1.25-0.25i;2,0];
B = [1;0];
C = [-0.75-0.5i,0.625-0.125i];
D = 0.5;
Hc = [ss(A,B,C,D);1];
Q = [1 0.1;0.1 -1];

    ツールボックス基本設定に基づいてオプション セットを作成します。

    plotoptions = sectorplotoptions('cstprefs');
plotoptions.Grid = 'on';
plotoptions.FreqScale = 'linear';
plotoptions.Title.String = 'Relative Sector Index Plot of Complex-Coefficient Model';

    ここで、カスタム オプション セット plotoptions を使用したセクター プロットを作成します。

    sectorplot(Hc,Q,plotoptions)

    バージョン履歴

    R2016a で導入

    参考

    |

    トピック