Simulink.sdi.setUnitSystem

単位系を指定してシミュレーションデータインスペクターの信号の表示単位を定義する

R2020b 以降

ページ内をすべて折りたたむ

構文

Simulink.sdi.setUnitSystem(unitSystem)

Simulink.sdi.setUnitSystem(unitSystem,"Overrides",overrideUnits)

説明

例

Simulink.sdi.setUnitSystem(unitSystem) は、ログ記録された信号とインポートされた信号に対して、指定された単位系を使用して単位の表示を定義するようにシミュレーションデータインスペクターを構成します。

シミュレーションデータインスペクターは単位の表示を使用して信号をプロットします。信号の表示単位は、ディスクに保存されたデータの単位を示す保存された単位とは異なる可能性があります。シミュレーションデータインスペクターの基本設定で単位系を指定すると、指定された単位系で無効な単位を使用するログ記録された信号またはインポートされた信号に対して、シミュレーションデータインスペクターは自動的に単位の表示を調整します。

例

Simulink.sdi.setUnitSystem(unitSystem,"Overrides",overrideUnits) は指定されたオーバーライド単位を使用するようにシミュレーションデータインスペクターを構成します。シミュレーションデータインスペクター内のすべての信号に対して、長さなどの測定タイプに m または ft などの一貫性のある単位を使用する場合は、オーバーライド単位を指定します。

例

すべて折りたたむ

シミュレーションデータインスペクターで単位の基本設定を構成する

ライブスクリプトを開く

シミュレーションデータインスペクターで信号のプロットに使用する単位系を指定するには、関数 Simulink.sdi.setUnitSystem を使用します。SI または US Customary の単位系を使用して信号を表示すると、シミュレーションデータインスペクターは指定された単位系の一部ではない単位を使用するログ記録された信号またはインポートされた信号の [単位の表示] プロパティを自動的に変更します。ディスクに保存されている信号データは変更されません。信号には [保存された単位] プロパティもあり、[保存された単位] と [単位の表示] が異なる場合、シミュレーションデータインスペクターは信号をプロットするデータを変換します。

単位系の指定

既定では、シミュレーションデータインスペクターはシミュレーション中またはインポートしたデータ内の信号に割り当てられた単位を使用して信号を表示します。複数の信号とデータセットをまとめて解析しやすくするために、単位系を基本設定として指定できます。シミュレーションデータインスペクターは指定した単位系で無効な単位を使用するログ記録された信号またはインポートされた信号の [単位の表示] を自動的に更新します。たとえば、ft の単位を使用するモデルにログ記録された信号は、単位系が SI として指定されると m の単位を使用するように更新される可能性があります。

関数 Simulink.sdi.setUnitSystem を使用して、米国慣用の単位系の単位を使用する信号を表示するようにシミュレーションデータインスペクターを構成します。

Simulink.sdi.setUnitSystem('USCustomary');

オーバーライド単位の指定

同じ測定のタイプを表す信号すべてに同じ [単位の表示] を使用する場合、オーバーライド単位も指定できます。たとえば、ft の単位を使用して長さを表す信号をすべてプロットする場合は、ft をオーバーライド単位として指定します。

Simulink.sdi.setUnitSystem('USCustomary','Overrides',"ft");

単位の構成のチェック

関数 Simulink.sdi.getUnitSystem を使用して、シミュレーションデータインスペクターで構成されている現在の単位の基本設定をチェックします。

[unitSystem,overrideUnits] = Simulink.sdi.getUnitSystem

unitSystem = 
'USCustomary'

overrideUnits = 
"ft"

入力引数

すべて折りたたむ

`unitSystem` — 信号の表示単位を定義するために使用される単位系
`'Default'` (既定値) | `'SI'` | `'USCustomary'`

信号の表示単位を定義するために使用される単位系。'Default'、'SI'、または 'USCustomary' として指定します。

Default — 信号の保存された単位を使用します。
SI — 信号の表示単位に SI 単位系の単位を使用します。
USCustomary — 信号の表示単位に米国慣用の単位系の単位を使用します。

`overrideUnits` — 信号の表示単位をオーバーライドする単位
string | string 配列

信号の表示単位をオーバーライドする単位。string または string 配列として指定します。同じ測定タイプを表す信号すべてに一貫性のある単位を使用する場合は、オーバーライド単位を指定します。たとえば、ft のオーバーライド単位を指定して、ft の単位を使用して長さの測定を表す信号をすべて表示します。

例: "Overrides",["in","lb"]

データ型: string