信号ログ設定のオーバーライド

信号ログを使用すると、モデルにブロックを追加することなくシミュレーションから信号データを取得できます。詳細については、信号ログを使用した信号データの保存を参照してください。

モデルを開発する際に、特定のシミュレーション実行用の信号ログ設定をオーバーライドする場合があります。信号ログセレクターまたはプログラムによるインターフェイスを使用して、Simulink^® エディターでモデルを変更することなく、信号ログプロパティをオーバーライドすることができます。信号ログ設定をオーバーライドすると、モデルの再コンパイルを回避し、メモリのオーバーヘッドを削減できます。

信号ログ設定をオーバーライドするには、次の 2 つの方法のいずれかまたは組み合わせを使用できます。

信号ログ設定をオーバーライドする利点

信号ログプロパティをオーバーライドすることは、次の項目を実行する際に役立ちます。

ログ記録用にマークが付けられたほとんどの信号のログを無効にして、いくつかの信号にのみ焦点を当てる。信号の上位集合をログ記録用にマークしてから、それらの信号のさまざまな部分集合をログ記録用に選択できます。
いくつかの信号を信号ログ出力から除外する。
信号の特定の信号ログプロパティ (間引きなど) をオーバーライドする。
複数のテストベクトルを実行する場合に必要なもののみを収集する。

信号ログ設定オーバーライドのスコープ

信号ログ設定をオーバーライドすると、指定したコンフィギュレーションがモデルに保存され、モデルのシミュレーション時にそれらのオーバーライド設定が使用されます。ただし、モデル内の各信号の [信号プロパティ] ダイアログボックスの信号ログ設定は変更されません。

信号をオーバーライドするようにログモードで設定したモデルでは、そのモデルを閉じて再度開くと、設定した信号ログオーバーライドが有効になります。モデルで信号ログインジケーターを表示している場合、オーバーライドしたログ信号も含めてすべてのログ信号のインジケーターが表示されます。

メモ

信号ログ記録用にマークされた信号を含むモデルがラピッドアクセラレータモードでシミュレートされている場合、信号ログ設定をオーバーライドし、モデルをラピッドアクセラレータモードで再度シミュレートすると、モデルがリビルドされます。

信号ログセレクターによる信号ログ設定のオーバーライド

信号ログセレクターを使用すると、信号ログ設定を対話形式で表示してオーバーライドできます。

信号ログセレクターを開きます。[モデル化] タブで [モデル設定] をクリックして [コンフィギュレーションパラメーター] ダイアログボックスを開きます。次に、[データのインポート/エクスポート] ペインで [ログを取るために信号を設定] をクリックします。

ヒント
[ログを取るために信号を設定] ボタンを有効にするには、[信号のログ] コンフィギュレーションパラメーターを選択します。
[ログモード] を [信号をオーバーライドする] に設定します。
信号ログセレクターでは、一部の信号ログ設定をオーバーライドしてから [ログモード] を [すべての信号をモデルで指定されたようにログを取る] に設定した場合、モデルで定義されているログ設定が信号ログセレクターに表示されます。オーバーライド設定はグレー表示され、これらの設定をオーバーライドできないことを示します。オーバーライド設定をもう一度有効にするには、[ログモード] を [信号をオーバーライドする] に設定します。特定の信号のログをオーバーライドするために信号ログセレクターを使用することは、その信号の信号ログインジケーターには影響しません。
メモ
[信号をオーバーライドする] 設定は、モデル階層のすべてのレベルに影響します。この設定により、階層全体のすべての信号のログ記録がオフになる場合があります。設定を確認するには、[モデルの階層構造] ペインで、適切なノードを選択します。
オーバーライドするログ信号を含むノードを表示します。必要に応じて、ノードを拡張するか、マスクサブシステムを表示するように [モデルの階層構造] ペインを構成します。信号ログセレクターを使用したログコンフィギュレーションの表示を参照してください。

信号ログ設定をオーバーライドします。

モデルに参照モデルが含まれる場合は、[モデルの階層構造] ペインのチェックボックスにノードに対応するモデルのオーバーライドコンフィギュレーションが示されます。

チェックボックス信号ログコンフィギュレーション

チェックボックス	信号ログコンフィギュレーション
	最上位モデルノードの場合、最上位モデルのすべてのログ信号のログが作成されます。 Model モデルブロックノードの場合、そのブロックのモデル参照階層のすべてのログ信号のログが作成されます。
	最上位モデルノードの場合、最上位モデルのすべてのログ信号のログの作成を無効にします。 Model ブロックノードの場合、そのブロックのモデル参照階層のすべての信号のログの作成を無効にします。
	最上位モデルノードの場合、`DataLogging` 設定が有効になっているすべてのログ信号のログを作成します。 Model ブロックノードの場合、`DataLogging` 設定が有効になっているブロックの、モデル参照階層のすべてのログ信号のログを作成します。

最上位モデルノードの場合、最上位モデルのすべてのログ信号のログが作成されます。

Model モデルブロックノードの場合、そのブロックのモデル参照階層のすべてのログ信号のログが作成されます。

最上位モデルノードの場合、最上位モデルのすべてのログ信号のログの作成を無効にします。

Model ブロックノードの場合、そのブロックのモデル参照階層のすべての信号のログの作成を無効にします。

最上位モデルノードの場合、DataLogging 設定が有効になっているすべてのログ信号のログを作成します。

Model ブロックノードの場合、DataLogging 設定が有効になっているブロックの、モデル参照階層のすべてのログ信号のログを作成します。

信号ログセレクターを使用してオーバーライド設定を適用するには、[ログモード] が [信号をオーバーライドする] に設定されていなければなりません。信号ログ設定をオーバーライドした後に [ログモード] を [すべての信号をモデルで指定されたようにログを取る] に設定した場合、オーバーライド設定は無視され、モデルで定義されているログ設定が信号ログセレクターに表示されます。オーバーライド設定をもう一度有効にするには、[ログモード] を [信号をオーバーライドする] に設定します。特定の信号のログをオーバーライドするために信号ログセレクターを使用することは、その信号の信号ログインジケーターには影響しません。

信号ログセレクターを使用して信号ログ設定をオーバーライドする方法の例については、Override Signal Logging Settingsを参照してください。

プログラムによる信号ログ設定のオーバーライド

MATLAB^® コマンドラインを使用すると、信号ログ設定をプログラムでオーバーライドできます。

信号ログオーバーライド設定をプログラムで構成するには、次のオブジェクトの関数とプロパティを使用します。

Simulink.SimulationData.ModelLoggingInfo — モデルのオーバーライド設定。このオブジェクトは、信号ログセレクターインターフェイス全体に対応します。
Simulink.SimulationData.SignalLoggingInfo — 特定の信号のオーバーライド設定。このオブジェクトは、信号ログセレクターのログプロパティの表にある行に対応します。
Simulink.SimulationData.LoggingInfo — Simulink.SimulationData.SignalLoggingInfo オブジェクトの LoggingInfo プロパティのオーバーライド設定。このオブジェクトは、信号ログセレクターのログプロパティの表にある行の編集可能な列に対応します。

モデルの信号ログオーバーライドステータスを照会するには、DataLoggingOverride モデルパラメーターを使用します。

get_param(mdl,"DataLoggingOverride")

信号ログオーバーライドコンフィギュレーションを適用するには、関数 set_param で DataLoggingOverride モデルパラメーターを使用します。

set_param(mdl,"DataLoggingOverride",mdlInfoObject)

ログ信号を含むシステムの種類を制御できます。既定では、Simulink.SimulationData.ModelLoggingInfo オブジェクトは以下のログ信号を含みます。

ライブラリ
マスクサブシステム
参照モデル
アクティブなバリアント

以下のセクションでは、一般的な信号ログコンフィギュレーションタスクをプログラムで実行する方法について説明しています。

その他の例については、以下を参照してください。

ログ信号を含むモデルログオーバーライドオブジェクトの作成

ライブスクリプトを開く

モデル sldemo_mdlref_bus のモデルログオーバーライドオブジェクトを作成し、そのオブジェクトにモデル内の各ログ信号を自動的に追加できます。モデル sldemo_mdlref_bus には、ログ記録用にマークされた信号が 4 つあります。

mdl = 'sldemo_mdlref_bus';
open_system(mdl)
mdlInfo = Simulink.SimulationData.ModelLoggingInfo.createFromModel(mdl)

mdlInfo = 
  ModelLoggingInfo with properties:

                     Model: 'sldemo_mdlref_bus'
               LoggingMode: 'OverrideSignals'
    LogAsSpecifiedByModels: {}
                   Signals: [1x4 Simulink.SimulationData.SignalLoggingInfo]

LoggingMode プロパティは 'OverrideSignals' に設定され、Signals プロパティで指定された信号に限定してログを作成するようモデルログオーバーライドオブジェクトを設定します。

モデルオーバーライドオブジェクト設定を適用します。モデルを保存すると設定が保存されます。

set_param(mdl,'DataLoggingOverride',mdlInfo);

モデルログオーバーライドオブジェクトのログモードの設定

ライブスクリプトを開く

関数 setLogAsSpecifiedInModel を使用して、モデルで指定されている信号ログ設定をオーバーライドできます。たとえば、モデルの階層構造内の最上位モデルのみや参照モデルのみをログに記録できます。モデル sldemo_mdlref_bus には、モデル sldemo_mdlref_counter_bus を参照する CounterA という名前の Model ブロックが含まれています。合計で 4 つの信号がログ記録用にマークされています。ログ記録用にマークされた信号のうち、COUNTERBUS、INCREMENTBUS、および OUTERDATA の 3 つは最上位モデルにあります。ログ記録用にマークされたもう 1 つの信号 INNERDATA は参照モデルにあります。

mdl = 'sldemo_mdlref_bus';
mdlInner = 'sldemo_mdlref_bus/CounterA';
open_system(mdl)

ログモードを Signals プロパティで指定したオーバーライド設定に設定したときにいずれの信号もログに記録しないように、空の Simulink.SimulationData.ModelLoggingInfo オブジェクトを作成します。

mdlInfo = Simulink.SimulationData.ModelLoggingInfo(mdl);

関数 setLogAsSpecifiedInModel を使用して、最上位モデルの信号のみをそのモデルで指定されているログ設定を使用してログに記録できます。モデルでの指定に従って信号をログに記録するように外側のモデルを設定します。さらに、オーバーライド設定を使用するように内側のモデルを設定します。Signals プロパティのベクトルが空であるため、オーバーライド設定が適用されているときはいずれの信号もログに記録されません。

mdlInfo = setLogAsSpecifiedInModel(mdlInfo,mdl,true);
mdlInfo = setLogAsSpecifiedInModel(mdlInfo,mdlInner,false);

関数 getLogAsSpecifiedInModel でログモードが返されます。

outerLogMode = getLogAsSpecifiedInModel(mdlInfo,mdl)

outerLogMode = logical
   1

innerLogMode = getLogAsSpecifiedInModel(mdlInfo,mdlInner)

innerLogMode = logical
   0

モデルオーバーライドオブジェクト設定を適用します。その後、モデルのシミュレーションを実行します。最上位モデルのログ記録用にマークされた信号のみがログに記録されます。

set_param(mdl,'DataLoggingOverride',mdlInfo);
sim(mdl);
topOut

topOut = 
Simulink.SimulationData.Dataset 'topOut' with 3 elements

                         Name          BlockPath                             
                         ____________  _____________________________________ 
    1  [1x1 Signal]      COUNTERBUS    sldemo_mdlref_bus/Concatenate        
    2  [1x1 Signal]      OUTERDATA     sldemo_mdlref_bus/CounterA           
    3  [1x1 Signal]      INCREMENTBUS  sldemo_mdlref_bus/IncrementBusCreator

  - Use braces { } to access, modify, or add elements using index.

また、関数 setLogAsSpecifiedInModel を使用して、参照モデルの信号のみをそのモデルで指定されているログ設定を使用してログに記録することもできます。オーバーライド設定を使用するように外側のモデルを設定します。さらに、モデルでの指定に従って信号をログに記録するように内側のモデルを設定します。

mdlInfo = setLogAsSpecifiedInModel(mdlInfo,mdl,false);
mdlInfo = setLogAsSpecifiedInModel(mdlInfo,mdlInner,true);

最上位モデルと内側のモデルのログモードが変更されたことを確認するには、関数 getLogAsSpecifiedInModel を使用します。

outerLogMode = getLogAsSpecifiedInModel(mdlInfo,mdl)

outerLogMode = logical
   0

innerLogMode = getLogAsSpecifiedInModel(mdlInfo,mdlInner)

innerLogMode = logical
   1

モデルオーバーライドオブジェクト設定を適用します。その後、モデルのシミュレーションを実行します。今回は INNERDATA 信号のみがログに記録されます。

set_param(mdl,'DataLoggingOverride',mdlInfo);
sim(mdl);
topOut

topOut = 
Simulink.SimulationData.Dataset 'topOut' with 1 element

                         Name       BlockPath                                
                         _________  ________________________________________ 
    1  [1x1 Signal]      INNERDATA  ...erA|sldemo_mdlref_counter_bus/COUNTER

  - Use braces { } to access, modify, or add elements using index.