set

モデル プロパティの設定または変更

構文

set(sys,'Property',Value)
set(sys,'Property1',Value1,'Property2',Value2,...)
sysnew = set(___)
set(sys,'Property')


説明

set はプロパティ名とプロパティ値のペアを使用して動的システム モデルのプロパティを設定または変更するために使用されます。

set(sys,'Property',Value) は、値 Value をモデル sys のプロパティに割り当てます。'Property' はプロパティの完全な名前 (例 'UserData') または大文字、小文字を区別しない明白な省略形 (例 'user') のすべてを使用できます。指定プロパティは、モデル タイプと互換性がなければなりません。たとえば、sys が伝達関数である場合、Variable は有効なプロパティですが StateName は違います。線形モデル タイプの利用可能なシステム プロパティの完全なリストについては、そのモデル タイプのリファレンス ページを参照してください。この構文は、sys.Property = Value と等価です。

set(sys,'Property1',Value1,'Property2',Value2,...) は、複数のプロパティ値を 1 つのステートメントで設定します。各プロパティ名とプロパティ値の組み合わせは、1 つの特定のプロパティを更新します。

sysnew = set(___) は変更された動的システム モデルを返し、上記の任意の構文で使用できます。

set(sys,'Property') は、'Property' で指定されたプロパティのヘルプを表示します。

例

モデルのプロパティの指定

それぞれが 1、2、3、4 に等しい行列 A、B、C、D をもつ SISO 状態空間モデルを作成します。

sys = ss(1,2,3,4);

モデルのプロパティを変更します。0.1 秒の入力遅延を追加し、入力に torque のラベルを付け、行列 D を 0 に設定します。

set(sys,'InputDelay',0.1,'InputName','torque','D',0);

モデルのプロパティを表示して変更を確認します。

get(sys)

                A: 1
                B: 2
                C: 3
                D: 0
                E: []
          Offsets: []
           Scaled: 0
        StateName: {''}
        StatePath: {''}
        StateUnit: {''}
    InternalDelay: [0x1 double]
       InputDelay: 0.1000
      OutputDelay: 0
        InputName: {'torque'}
        InputUnit: {''}
       InputGroup: [1x1 struct]
       OutputName: {''}
       OutputUnit: {''}
      OutputGroup: [1x1 struct]
            Notes: [0x1 string]
         UserData: []
             Name: ''
               Ts: 0
         TimeUnit: 'seconds'
     SamplingGrid: [1x1 struct]

ヒント

離散時間伝達関数の場合、分子と分母を表現するために使用される表記は、変数の選択に応じて決まります (詳細は「tf」を参照)。tf と同様に、set の構文は、変数の選択に応じて整合性を維持するために変化します。たとえば、Variable プロパティは、'z' (既定値) に設定されて、

set(h,'num',[1 2],'den',[1 3 4])

伝達関数を生成します。

$$h\left(z\right)=\frac{z+2}{z^2+3z+4}$$

ただし、次を使用して Variable を 'z^-1' に変更すると

set(h,'Variable','z^-1'),

次の同じコマンド

set(h,'num',[1 2],'den',[1 3 4])

が今度は、行ベクトル [1 2] と [1 3 4] を多項式 1 + 2z⁻¹ および 1 + 3z⁻¹ + 4z⁻² と解釈し、以下を生成します。

$$\overline{h}\left(z^{-1}\right)=\frac{1+2z^{-1}}{1+3z^{-1}+4z^{-2}}=zh\left(z\right)$$

メモ

結果として得られる伝達関数は異なるので、変数の選択に一致する表記を使用してください。

バージョン履歴

R2006a より前に導入

参考

get | frd | ss | tf | zpk

トピック

• モデル データの格納と取得
• モデル オブジェクトとは