get

モデル プロパティ値にアクセスする

構文

Value = get(sys,'PropertyName')
Struct = get(sys)


説明

Value = get(sys,'PropertyName') は、モデル オブジェクト sys のプロパティ PropertyName の現在値を返します。'PropertyName' は完全なプロパティ名 ('UserData' など) または大文字、小文字を区別しない任意の明白な省略形 ('user' など) にできます。そのモデルで利用可能なプロパティのリストについては、個別のモデル オブジェクト タイプのリファレンス ページを参照してください。

Struct = get(sys) は TF、SS、ZPK オブジェクト sys を、フィールド名にプロパティ名、フィールドの値にプロパティ値をもつ標準的な MATLAB^® の構造体に変換します。

左辺引数がない場合、

get(sys)

には sys のすべてのプロパティおよびその値が表示されます。

例

モデルのプロパティ値の表示

次の離散時間 SISO 伝達関数モデルを作成します。

$$H(z)=\frac{1}{z+2}$$

サンプル時間を 0.1 秒に指定し、入力チャネル名を Voltage に指定します。

h = tf(1,[1 2],0.1,'InputName','Voltage')

h =
 
  From input "Voltage" to output:
    1
  -----
  z + 2
 
Sample time: 0.1 seconds
Discrete-time transfer function.
Model Properties

伝達関数のすべてのプロパティを表示します。

get(h)

       Numerator: {[0 1]}
     Denominator: {[1 2]}
        Variable: 'z'
         IODelay: 0
      InputDelay: 0
     OutputDelay: 0
       InputName: {'Voltage'}
       InputUnit: {''}
      InputGroup: [1×1 struct]
      OutputName: {''}
      OutputUnit: {''}
     OutputGroup: [1×1 struct]
           Notes: [0×1 string]
        UserData: []
            Name: ''
              Ts: 0.1000
        TimeUnit: 'seconds'
    SamplingGrid: [1×1 struct]

伝達関数のすべての分子を表示します。

num = get(h,'Numerator')

num = 1×1 cell array
    {[0 1]}

分子データは cell 配列として格納されるため、Numerator プロパティは行ベクトル [0 1] を含む cell 配列です。

num{1}

ans = 1×2

     0     1

伝達関数のサンプル時間 Ts を表示します。

get(h,'Ts')

ans = 
0.1000

あるいは、ドット表記を使用してプロパティ値にアクセスします。

h.Ts

ans = 
0.1000

ヒント

構文

Value = get(sys,'PropertyName')

を使用する代わりに、次の構造体に似た参照を使用できます。

Value = sys.PropertyName

以下に例を示します。

sys.Ts
sys.A
sys.user

はサンプル時間、行列 A、および (状態空間) モデル sys の UserData プロパティを返します。

バージョン履歴

R2006a より前に導入

参考

frdata | set | ssdata | tfdata | idssdata | polydata | getpvec | getcov