シグナル解析を始める
機能概要
Analyze Windowの「Signal Analysis」は、取得済みの通信ログをシグナル定義に従って変換し、値・波形・アラート発生箇所・元フレームを照合する機能です。監視中の値はSignal Window、フレーム単位の検索や統合はアナライズ機能の基本操作を使用します。
解析にはログと、それに対応する信号定義が必要です。信号の用語はSignal Catalogの役割と用語を参照してください。
関連する画面と操作の変更はVer.4.10の変更点を参照してください。
解析を始める
1.ログと定義を用意する
モニタリングを停止し、Analyze Windowで「Signal Analysis」を開きます。保存済みログを解析する場合は、機器の接続やライブ監視の開始は不要です。
- 直前のモニタリングを調べるときは、モニタリングを停止した後に「Signal Analysis」を開き、「Source: Monitor buffer」と表示されていることを確認します。
- 保存済みログを調べるときは「Open Log」からMicroPeckerXの通信ログCSVを開きます。表計算用のCSVや解析CSVは元ログとして使用できません。
図1 解析対象のSourceとログ概要を確認。
図1は直前の監視ログを使う例で、SourceはMonitor buffer、ログ概要はCH 1、records 14、duration 7.002 sです。trigger intervalsはログ内のトリガー区間数で、この例では0です。アラート条件の検出件数は手順5のAlertsで確認します。
「Open Log」を取り消した場合や、上限超過などで読み込めなかった場合は、直前のログと解析結果が保持されます。
新しいモニタリングを開始すると解析対象が監視ログに戻り、前回の解析結果が消去されます。必要な結果は開始前に出力してください。
2.解析対象のSignal Setを選ぶ
解析用の定義を用意する
保存済みログには解析用Catalogの定義を使います。取得時の定義で解析するには、ログと一緒に保管したMPXSIG(例:run.csv に対する run.mpxsig)を、Signal Analysis内の「Signal Catalog」の「Load」で読み込みます。
Monitor bufferを開いて最初に解析するときは、現在の共有Current Setを取り込みます。監視開始時の定義やCH割当との差異が表示された場合は、ログに対応する定義を選び直してください。
解析用の定義を選ぶ画面が表示された場合は、次のいずれかを選択します。
| 操作 | 使用する定義 |
|---|---|
| Use current Signal Set | 共有Current Setを保存済みのCH割当とともに解析用に取り込みます。ログのCHとの対応を確認します。 |
| Load Signal Set | 保存済みのMPXSIGを解析用に読み込みます。ログに対応する版を選択します。 |
| Cancel | 定義の選択を中止します。 |
解析用Catalogでは使用するSet・In Set・CHを確認します。現在の接続機器のCH番号ではなく、ログに記録されたCHと対応させてください。Protocol・ID・Direction・DLも照合します。派生信号を含む場合は入力信号と式も確認します。
図2 解析側のDefaultセットで信号の所属・CH・表示先を確認。
図2のタイトルはSignal Catalog - Analysis (next analysis)で、Default [Current]を選択しています。SpeedのIn SetがON、ProtocolがLIN、ID (Hex)が10(0x10)、MessageがSensorFrame、CHがCH1-1であることを確認します。波形を表示するSpeedはGraphがOn、Graph AreaがG1 / A1です。この例ではStateと派生信号Speed_mpsもSetへ追加しています。
次回の解析に使うSetを選ぶ
「Open Log」で「Log Analyze」が表示されたら、Set名と「Matched signals」を確認します。別のSetを選ぶか定義を変更する場合は、右上の「×」またはEscキーで「Log Analyze」を閉じます。開いたログは選択されたままです。
監視と解析が停止している状態で、必要な定義を用意し、Signal Analysis上部の「Signal Set」から対象のSetを選択します。上部の「Analyze」で解析を実行します。
解析が完了した後に別のSetを選ぶと、上部の「Signal Set」は次回の解析対象に切り替わり、波形やValuesには前回の結果が残ります。見出しは「Signal Set (next analysis):」(日本語表示では「次回の Set:」)に変わります。再解析が必要な間は「Export CSV」を選択できません。「Analyze」をクリックし、新しい結果に出力できるサンプルがあることを確認してください。
例:DefaultからSpeed Lineへ切り替える
図3~5は、保存済みの通信ログLN1_SpeedTrigger_1-1.csvを開いた状態で、解析対象をDefaultからSpeed Lineへ変更する例です。前後のMonitor bufferの例とは別の操作例です。
- 解析済みのDefaultを表示し、上部の「Signal Set」を開きます。図3ではDefaultとSpeed Lineを選択できます。表示中の波形はDefaultのStair表示です。
図3 Signal Setセレクタで次回の解析対象を選ぶ。
- 「Speed Line」を選択します。図4では次回の解析対象がSpeed Lineに変わっても、グラフには前回のDefaultのStair波形が残っています。「Export CSV」は無効です。セレクタのSet名だけで、表示中の波形も更新済みと判断しないでください。
図4 Set切替後の再解析待ち。前回結果を保持し、CSV出力を無効化。
- 「Analyze」をクリックします。完了後、図5のようにSpeed LineのLine表示へ更新され、出力できるサンプルがあれば「Export CSV」が有効になります。この画面例では再解析後に「Zoom In」を3回クリックし、Rangeを7.5 sにしています。縦軸の目盛り、信号名、ValuesやAlertsも、再解析後の結果と選択Setの設定に合わせて確認します。
図5 再解析完了後のLine表示とCSV出力の有効状態を確認。
3.解析を実行する
ログを開いた際に「Log Analyze」が表示された場合は、ログ、Signal Set、Matched signalsを確認します。一致する信号があれば「Analyze」をクリックします。対象CHと解析する時間範囲も確認してください。
すでに対象のログを選択している場合は、図6のSignal Analysis上部の「Analyze」を使用します。今回の例ではSourceがMonitor bufferとして選択されているため、解析側のDefaultセットを確認してから、このボタンで解析を実行します。
図6 選択済みのMonitor bufferをAnalyzeで解析。
Matched signalsが0の場合は「Open Signal Catalog」で解析用定義・Set・CH割当を見直します。ログ自体にフレームがない場合は別のログを選びます。
4.値と元フレームを照合する
解析後は、調べたい信号と時刻を選び、Valuesの値、グラフ、Frame Logのデータを照合します。画面構成と波形の確認に、各領域とマーカーの操作を説明しています。
図7ではFrame Logの+0000004.002580の行をダブルクリックしています。CH1-1、DirectionがTx、IDが10(16進数の0x10)、Lengthが2、Data (HEX)が「18 01」であることを確認します。右側のValuesのSpeedは同じ時刻で7 km/hです。先頭バイト0x18はRaw値24なので、24 × 0.5 − 5 = 7 km/hと一致します。緑のカーソルCの4.003 sは、秒を小数3桁に丸めた表示です。
図7 元フレーム・波形・Speedの値を同じ時刻で確認。
5.条件変更後に再解析する
| 開く場所 | 編集する設定と反映先 |
|---|---|
| メインツールバーのSignal Catalog | 監視・送信設定の準備に使用する共通定義です。モニタリング中や解析実行中は参照専用です。 |
| Signal Analysis内のSignal Catalog | 選択中のログに採用した解析用の設定です。モニタリングや解析の実行中は操作できません。ここで定義を変更しても監視用Catalogや送信データに書き戻されません。解析用Catalogを閉じた後、監視を再開する前にTrigger Windowで対象信号と有効状態を確認してください。 |
解析済みの定義を変更する場合は、Signal Analysis内で編集を確定してCatalogを閉じ、再度「Analyze」を実行します。完了結果を表示している状態でも、解析用Catalogで変更を準備できます。再解析が必要な間は旧結果が残るため、変更後の結果を比較・出力する前に解析を完了してください。旧結果を残す場合は、条件を変更する前にCSVや画像を出力します。
再解析後は、ValuesやAlertsが変更後の条件に対応していることを確認します。図8はSpeed High(上限10 km/h、Recovery margin 2)の結果で、Alerts (2)にRecoveredとActiveが1件ずつ表示されています。上段は12 km/hで発生して7 km/hで復帰し、下段は解析範囲の終端まで未復帰の例です。件数だけでなく、対象信号・条件名・発生と復帰の時刻・値を確認してください。詳しい読み方はアラート発生箇所の確認を参照してください。
図8 再解析後のAlertsで条件と検出結果を確認する例。
共通定義を編集する場合は、モニタリングを停止し、解析実行中なら終了を待ちます。解析結果を保持したまま編集できます。共通定義を変更しただけで、保持中の解析結果や送信データが更新されることはありません。
解析できない場合
| 状況 | 確認する内容 |
|---|---|
| Analyzeを選択できない | モニタリング停止、ログの選択、定義の準備、処理中でないことを確認します。 |
| Matched signalsが0 | Setの所属、ログのCH、Protocol、ID、Direction、データ長を確認します。 |
| 信号値がない、または無効 | 信号のビット範囲、変換、有効範囲、多重化条件、派生信号の入力を確認します。受信していない時点の値を0と解釈しないでください。 |
| 波形だけ表示されない | Graphの対象とGraph/Area割当を確認します。値の解析対象と波形の表示対象は区別します。 |
| 読み込み上限を超えた | 解析できるフレーム数は全CH合計で5,000,000件までです。「Open Log」で開くCSVは、400 MB(400,000,000バイト)かつヘッダーを除くデータ行が全CH合計で5,000,000行までです。上限を超えたログは分割・縮小して開き直してください。 |
解析画面内の再生は、解析結果を表示する時刻を移動する操作です。実際にバスへ送信するLog Replayとは用途が異なります。結果を残す場合は結果の記録・出力を参照してください。