removeOpening

slLinearizer または slTuner インターフェイスの永続的なループ開始点のリストから開始点を削除

構文

removeOpening(s,op)

説明

removeOpening(s,op) は、slLinearizer または slTuner インターフェイス s の永続的な開始点のリストから、指定された開始点 op を削除します。op を指定して単一または複数の開始点を削除できます。

removeOpening によって、s に関連付けられたモデルが変更されることはありません。

例

信号名を使用した開始点の削除

scdcascade モデルの slLinearizer インターフェイスを作成します。

sllin = slLinearizer('scdcascade');

一般的には、解析ポイント、開始点、操作点およびパラメーター値を使ってインターフェイスを設定します。この例では、開始点のみをインターフェイスに追加します。

addOpening(sllin,{'y2m','y1m','u1'});

'y2m'、'y1m'、および 'u1' は、scdcascade モデルの信号の名前です。addOpening コマンドにより、これらの信号を sllin の永続的な開始点のリストに追加します。

sllin から開始点 'y1m' を削除します。

removeOpening(sllin,'y1m');

信号名を使用した複数の開始点の削除

scdcascade モデルの slLinearizer インターフェイスを作成します。

sllin = slLinearizer('scdcascade');

一般的には、解析ポイント、開始点、操作点およびパラメーター値を使ってインターフェイスを設定します。この例では、開始点のみをインターフェイスに追加します。

addOpening(sllin,{'y2m','y1m','u1'});

'y2m'、'y1m'、および 'u1' は、scdcascade モデルの信号の名前です。addOpening コマンドにより、これらの信号を sllin の永続的な開始点のリストに追加します。

sllin から開始点 'y1m' および 'y2m' を削除します。

removeOpening(sllin,{'y1m','y2m'});

インデックスを使用した開始点の削除

scdcascade モデルの slLinearizer インターフェイスを作成します。

sllin = slLinearizer('scdcascade');

一般的には、インターフェイスを解析ポイント、ループ開始点、操作点およびパラメーター値で設定します。この例では、開始点のみをインターフェイスに追加します。

addOpening(sllin,{'y2m','y1m','u1'});

'y2m'、'y1m'、および 'u1' は、scdcascade モデルの信号の名前です。addOpening コマンドにより、これらの信号を sllin の永続的な開始点のリストに追加します。

削除する開始点のインデックス番号を特定します。これを行うには、コマンド ウィンドウでインターフェイスの内容を表示します。これに、開始点のインデックス番号が含まれています。

この例では、sllin から開始点 'y1m' を削除します。

sllin

 
slLinearizer linearization interface for "scdcascade":

No analysis points. Use the addPoint command to add new points.
3 Permanent openings: 
--------------------------
Opening 1:
- Block: scdcascade/Sum3
- Port: 1
- Signal Name: y2m
Opening 2:
- Block: scdcascade/Sum
- Port: 1
- Signal Name: y1m
Opening 3:
- Block: scdcascade/C1
- Port: 1
- Signal Name: u1
 
Properties with dot notation get/set access:
      Parameters         : [] 
      OperatingPoints    : [] (model initial condition will be used.)
      BlockSubstitutions : []
      Options            : [1x1 linearize.LinearizeOptions]

表示には、'y1m' が sllin の 2 番目の開始点であることが示されています。

インターフェイスから開始点を削除します。

removeOpening(sllin,2);

インデックスを使用した複数の開始点の削除

scdcascade モデルの slLinearizer インターフェイスを作成します。

sllin = slLinearizer('scdcascade');

一般的には、解析ポイント、開始点、操作点およびパラメーター値を使ってインターフェイスを設定します。この例では、開始点のみをインターフェイスに追加します。

addOpening(sllin,{'y2m','y1m','u1'});

'y2m'、'y1m'、および 'u1' は、scdcascade モデルの信号の名前です。addOpening コマンドにより、これらの信号を sllin の永続的な開始点のリストに追加します。

削除する開始点のインデックス番号を特定します。これを行うには、コマンド ウィンドウでインターフェイスの内容を表示します。これに、開始点のインデックス番号が含まれています。

この例では、sllin から開始点 'y2m' および 'y1m' を削除します。

sllin

 
slLinearizer linearization interface for "scdcascade":

No analysis points. Use the addPoint command to add new points.
3 Permanent openings: 
--------------------------
Opening 1:
- Block: scdcascade/Sum3
- Port: 1
- Signal Name: y2m
Opening 2:
- Block: scdcascade/Sum
- Port: 1
- Signal Name: y1m
Opening 3:
- Block: scdcascade/C1
- Port: 1
- Signal Name: u1
 
Properties with dot notation get/set access:
      Parameters         : [] 
      OperatingPoints    : [] (model initial condition will be used.)
      BlockSubstitutions : []
      Options            : [1x1 linearize.LinearizeOptions]

表示には、'y2m' と 'y1m' が sllin の 1 番目と 2 番目の開始点であることが示されています。

インターフェイスから開始点を削除します。

removeOpening(sllin,[1 2]);

入力引数

s — Simulink^® モデルへのインターフェイス

slLinearizer インターフェイス | slTuner インターフェイス

Simulink モデルへのインターフェイス。slLinearizer インターフェイスまたは slTuner インターフェイスとして指定します。

op — 開始点

文字ベクトル | string | 文字ベクトルの cell 配列 | string 配列 | 正の整数 | 正の整数のベクトル

s の永続的な開始点のリストから削除する開始点。以下で指定します。

• 文字ベクトルまたは string — 開始点信号名。

  開始点に関連付けられた信号名を確認するには、s と入力します。MATLAB^® コマンド ウィンドウに s の内容が表示されます。これには、開始点の信号名、ブロック名および端子番号が含まれます。開始点に信号名がなく、ブロック名と端子番号のみがあるとします。ブロック名として op を指定できます。

  完全な信号名またはブロック名の一意的に一致する部分として op を指定できます。開始点の完全な信号名が 'LoadTorque' であるとします。'Torque' が s の他の開始点の信号名の一部でない限り、op を 'Torque' と指定できます。

  たとえば、op = 'y1m' とします。

• 文字ベクトルの cell 配列または string 配列 — 複数の開始点の名前を指定します。たとえば、op = {'y1m','y2m'} とします。

• 正の整数 — 開始点のインデックス。

  開始点のインデックスを確認するには、s と入力します。MATLAB コマンド ウィンドウに s の内容が表示されます。これには、開始点のインデックスが含まれます。たとえば、op = 1 とします。

• 正の整数のベクトル — 複数の開始点のインデックスを指定します。たとえば、op = [1 2] とします。

詳細

永続的な開始点

"永続的な開始点" とは、slLinearizer および slTuner インターフェイスで使用され、ソフトウェアがモデル内で信号の流れを中断する箇所を示します。線形化および調整時に、これらの開始点が強制的に適用されます。永続的な開始点は、ある特定のモデル コンポーネントを分離するために使用します。航空機のダイナミクスを取得する大規模なモデルがあり、機体にのみ線形解析を実行するとします。永続的な開始点を使用すれば、このモデルの他のコンポーネントをすべて除外できます。モデル内にカスケード式ループがあり、特定のループを解析する場合などにも使用できます。

"場所" とは、モデル内の特定のブロック出力端子を指します。便宜上、この端子から発信する信号の名前を使って開始点を示すことができます。

永続的な開始点は、slLinearizer または slTuner インターフェイス s に対して、インターフェイスの作成時に追加するか、addOpening コマンドを使用して追加できます。永続的な開始点のリストから場所を削除するには、removeOpening コマンドを使用します。

s のすべての開始点を表示するには、コマンド プロンプトで s と入力してインターフェイスの内容を表示します。s のそれぞれの永続的な開始点の表示には、ブロック名、端子番号、およびこの場所から発信される信号の名前が含まれます。getOpenings を使用して、すべての永続的なループ開始点のリストをプログラムで取得することもできます。

バージョン履歴

R2013b で導入

参考

slTuner | removeAllOpenings | addOpening | slLinearizer | removePoint