ライブラリチャート内のデータのログ

Simulink^® では、1 つ以上のモデルでブロックまたはサブシステムの機能を再利用する 1 つの方法として、独自のブロックライブラリを作成することができます。同様に、ライブラリチャートの機能をカプセル化することにより、Stateflow^® アルゴリズムの集合を再利用することもできます。

他の Simulink ブロックライブラリ同様、モデル内のチャートライブラリブロックの各インスタンスを特殊化して、さまざまなデータ型、サンプル時間、その他のプロパティを使用することができます。同じプロパティを継承するライブラリインスタンスでは生成コードを再利用できます。

Simulink ブロックライブラリの詳細は、カスタムライブラリ (Simulink)を参照してください。

ライブラリのログ設定がリンクされたインスタンスに与える影響

チャートインスタンスは、リンクされているライブラリチャートからログプロパティを継承します。インスタンスのログプロパティはオーバーライドできますが、ライブラリで選択した信号に対してのみ適用されます。インスタンスからログを作成する追加の信号を選択することはできません。

チャートインスタンスにおけるログプロパティのオーバーライド

チャートインスタンスでログ信号のプロパティをオーバーライドするには、以下のいずれかの方法を使用します。

アプローチ	使用方法
Simulink の [信号ログセレクター] ダイアログボックス	ログセレクターによるログプロパティのオーバーライドを参照してください。
コマンドラインインターフェイス	コマンドライン API によるログプロパティのオーバーライドを参照してください。

Atomic サブチャートにおけるログプロパティのオーバーライド

モデル sf_atomic_sensor_pair では、チャート RedundantSensors の Atomic サブチャート Sensor1 および Sensor2 として、冗長なセンサーの組み合わせをシミュレーションしています。各 Atomic サブチャートは、ライブラリチャート sf_atomic_sensor_lib のステート Fail、FailOnce、および OK のインスタンスを含んでいます。

ログセレクターによるログプロパティのオーバーライド

サンプルライブラリ sf_atomic_sensor_lib を開きます。

openExample("stateflow/ModelingARedundantSensorPairUsingAtomicSubchartExample", ...
    supportingFile="sf_atomic_sensor_lib");

ライブラリロックを解除。[シミュレーション] タブで、[ロックされたライブラリ] をクリックします。
Simulink エディターで、Stateflow SingleSensor チャートを選択します。[シミュレーション] タブで、[リストからのステートのログ] をクリックします。

[Stateflow 信号のログ] ダイアログボックスで、以下のプロパティを設定し、[OK] をクリックします。

対象	指定する内容
`Fail`	[信号データのログ] チェックボックスをオンにします。 [ログ名] をカスタム名の `LogFail` に変更します。 [適用] をクリックします。
`FailOnce`	[信号データのログ] チェックボックスをオンにします。 [ログ名] をカスタム名の `LogFailOnce` に変更します。 [適用] をクリックします。
`OK`	[信号データのログ] チェックボックスをオンにします。 [ログ名] をカスタム名の `LogOK` に変更します。 [適用] をクリックします。

モデル sf_atomic_sensor_pair を開きます。このモデルには、ライブラリチャートの 2 つのインスタンスが含まれています。
```
openExample("stateflow/ModelingARedundantSensorPairUsingAtomicSubchartExample")
```
[コンフィギュレーションパラメーター] ダイアログボックスを開きます。
[データのインポート/エクスポート] ペインで [ログを取るために信号を設定] をクリックして、Simulink 信号ログセレクターを開きます。
[モデルの階層構造] ペインで、RedundantSensors を展開し、Sensor1 と Sensor2 をクリックします。
各インスタンスは、ライブラリチャートからログプロパティを継承します。
Sensor1 の一部のログプロパティをオーバーライドします。
1. [モデルの階層構造] ペインで、Sensor1 を選択します。
2. [ログモード] を [信号をオーバーライドする] に変更します。
  モデルのすべての [DataLogging] チェックボックスがオフになります。
3. Sensor1 で Fail ステートと FailOnce ステートのログのみを有効にします。
  これらの 2 つの信号に対し、[DataLogging] を選択します。OK 信号に対しては、[DataLogging] をオフにします。
4. Fail と FailOnce のログ名にテキスト Sensor1 を追加します。
  信号 Fail と FailOnce のログ名をダブルクリックし、それぞれ LogFailSensor1 と LogFailOnceSensor1 に変更します。

コマンドライン API によるログプロパティのオーバーライド

サンプルライブラリ sf_atomic_sensor_lib を開きます。

openExample("stateflow/ModelingARedundantSensorPairUsingAtomicSubchartExample", ...
    supportingFile="sf_atomic_sensor_lib");

ライブラリロックを解除。

library = find(sfroot,"-isa","Stateflow.Machine", ...
    Name="sf_atomic_sensor_lib");
library.Locked = false;

次のコマンドを使用して、SingleSensor チャートで Fail、FailOnce、および OK の信号に対してログを作成します。
```
states = find(library,"-isa","Stateflow.State");

for i = 1: length(states)
   states(i).LoggingInfo.DataLogging = true;
end
```
モデル sf_atomic_sensor_pair を開きます。このモデルには、ライブラリチャートの 2 つのインスタンスが含まれています。
```
open_system("sf_atomic_sensor_pair")
```
モデルの ModelLoggingInfo オブジェクトを作成します。
このオブジェクトは、すべてのログ信号を保存する Signals ベクトルを含みます。
```
logInfo = Simulink.SimulationData.ModelLoggingInfo.createFromModel('sf_atomic_sensor_pair')
```
```
logInfo = 

  ModelLoggingInfo with properties:

                     Model: 'sf_atomic_sensor_pair'
               LoggingMode: 'OverrideSignals'
    LogAsSpecifiedByModels: {}
                   Signals: [1×6 Simulink.SimulationData.SignalLoggingInfo]
```
Signals ベクトルは、ライブラリチャートでログ作成がマークされた信号を含んでいます。
- Atomic サブチャート Sensor1 の Fail、FailOnce、および OK ステートのライブラリインスタンス
- Atomic サブチャート Sensor2 の Fail、FailOnce、および OK ステートのライブラリインスタンス
ログ信号で、そのプロパティをオーバーライドする信号へのブロックパスをそれぞれ作成します。
Stateflow チャート内部の信号にアクセスするには、Simulink.SimulationData.BlockPath(paths,subpath) を使用します。ここで subpath はチャート内の信号を表します。たとえば、RedundantSensors チャートの Atomic サブチャート Sensor1 にある信号 Fail、FailOnce、および OK のブロックパスを作成するには次のようにします。
```
failPath = Simulink.SimulationData.BlockPath( ...
    "sf_atomic_sensor_pair/RedundantSensors/Sensor1","Fail");
failOncePath = Simulink.SimulationData.BlockPath( ...
    "sf_atomic_sensor_pair/RedundantSensors/Sensor1","FailOnce");
OKPath = Simulink.SimulationData.BlockPath( ...
    "sf_atomic_sensor_pair/RedundantSensors/Sensor1","OK");
```

Simulink.SimulationData.BlockPath オブジェクト内の、各ログ信号のインデックスを取得します。

failidx = logInfo.findSignal(failPath);
failOnceidx = logInfo.findSignal(failOncePath);
OKidx = logInfo.findSignal(OKPath);

Sensor1 の信号の一部のログプロパティをオーバーライドします。

信号の OK のログを無効にします。

logInfo.Signals(OKidx).LoggingInfo.DataLogging = false;

Fail と FailOnce のログ名にテキスト Sensor1 を追加します。

% Enable custom naming
logInfo.Signals(failidx).LoggingInfo.NameMode = true;
logInfo.Signals(failOnceidx).LoggingInfo.NameMode = true;

% Enter the custom name
logInfo.Signals(failidx).LoggingInfo.LoggingName = "LogFailSensor1";
logInfo.Signals(failOnceidx).LoggingInfo.LoggingName = "LogFailOnceSensor1";

変更を適用します。

set_param(bdroot,DataLoggingOverride=logInfo);

参考

Simulink.SimulationData.ModelLoggingInfo (Simulink) | Simulink.SimulationData.BlockPath (Simulink)