Main Content

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"

    入力引数

    すべて折りたたむ

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

    • Default — 信号の保存された単位を使用します。

    • SI — 信号の表示単位に SI 単位系の単位を使用します。

    • USCustomary — 信号の表示単位に米国慣用の単位系の単位を使用します。

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

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

    データ型: string

    バージョン履歴

    R2020b で導入

    参考

    オブジェクト

    関数

    トピック