このページの内容は最新ではありません。最新版の英語を参照するには、ここをクリックします。

記録

データ ログのワークスペース、ファイル、またはその両方への記録

R2021a 以降

• 

×

ライブラリ:
Simulink / Sinks

記録 ブロックの代替構成:
XY Graph

説明

Record ブロックまたは XY Graph ブロックを使用すると、データをワークスペース、ファイル、またはワークスペースとファイルの両方に記録できます。データのログをファイルに記録する場合、記録先として MAT ファイル、MLDATX ファイル、または Excel^® ファイルを選択できます。Record ブロックに接続された信号は、常にシミュレーション データ インスペクターにログが記録されます。シミュレーション後にデータを保存する必要があると判断した場合、Record ブロックのデータをワークスペースまたはサポートされる任意のファイル タイプにエクスポートできます。

Record ブロックを使用して、接続された信号を可視化することもできます。Record ブロックに接続された信号のデータを表示するには、ブロックをダブルクリックします。[実行] ボタンなどのシミュレーション コントロールにアクセスできると同時に、Record ブロック内のデータが表示されます。

既定の設定では、Record ブロックは接続されたすべての信号をスパークライン プロットに表示します。接続された信号 1 つに対して 1 本のスパークラインが追加されます。スパークラインで表示域が一杯になったら、スクロールバーを使用することで信号のプロットを続行できます。

可視化の作成

Record ブロックは、シミュレーション データ インスペクターで利用可能なほとんどの可視化をサポートしています。データに別の可視化を使用することが望ましい場合、[レイアウト] オプションとプロット タイプ セレクター (既定のラベル名 [スパークライン]) を使用することでプロット レイアウトとプロット タイプを変更できます。サブプロットのレイアウトを選択するには、[レイアウト] リストを使用します。サブプロットのプロット タイプを変更するには、サブプロットを選択し、プロット タイプ セレクターから目的のプロット タイプを選択します。

詳細については、Log Data to the Workspace and a File Using the Record Blockを参照してください。各可視化タイプの使用方法を示す例については、以下を参照してください。

• スパークライン — View Many Signals Together Using Sparklines

• XY — XY プロットでのシミュレーション データの可視化およびXY プロットを使用したデータの解析

• マップ — マップ データの表示と再生

• 時間プロットとテキスト エディター — シミュレーション データ インスペクターを使用したプロットの作成

Record ブロックは、シミュレーション データ インスペクターで利用可能な配列の可視化をサポートしていません。Record ブロックは可変サイズの信号を含む多次元信号データのログ記録をサポートしていますが、多次元データの可視化はサポートしていません。Record ブロックを使用して多次元信号のデータを可視化するには、多次元のサンプル値をもつ信号を、それぞれがスカラーのサンプル値をもつ"チャネル" と呼ばれる一連の信号に変換します。詳細については、Analyze Multidimensional Signal Dataを参照してください。

例

Log Data to the Workspace and a File Using the Record Block

Use the Record block to log data to the workspace, to a file, or to both the workspace and a file.

モデルを開く

XY Graph ブロックを使用した円のプロット

XY Graph ブロックを使用した x と y のデータからの円のプロット。

ライブ スクリプトを開く

Load Data Using Playback Block

Load data from the workspace, a file, and the Simulation Data Inspector using the Playback block.

ライブ スクリプトを開く

端子

入力

Port_1 — 記録する信号

スカラー | ベクトル | 行列 | 配列 | バス

記録する信号です。Record ブロックに端子を追加するには、ラインをブロックの端にドラッグするか、[端子] パラメーターを使用します。

Record ブロックは可変サイズの信号のログ記録をサポートしていますが、可変サイズの信号の可視化はサポートしていません。

XY Graph ブロックは、XY プロット上の 2 つの入力端子に接続されているデータを可視化する Record ブロックの代替の構成です。1 番目の入力端子は XY プロットの x データを提供し、2 番目の入力端子は y データを提供します。

ヒント

• フレームベースのデータのログを取るには、フレームベースの信号を受け取る各端子に [入力処理] パラメーターを指定します。

• 非スカラー信号を XY Graph ブロックの入力端子に接続する場合は、XY プロットの x および y データを提供する非スカラー信号のチャネルまたは要素を手動で設定しなければなりません。

データ型: single | double | half | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | Boolean | fixed point | enumerated | bus | image
複素数のサポート: あり

パラメーター

Record ブロックのパラメーターを変更するには、プロパティ インスペクターを使用します。

メイン

入力端子の数 — 入力端子の数

1 (既定値) | [1,100] の範囲の整数

入力端子の数。1 以上 100 以下の整数として指定します。

XY Graph ブロックは、XY プロット上の 2 つの入力端子に接続されているデータを可視化する Record ブロックの代替の構成です。1 番目の入力端子は XY プロットの x データを提供し、2 番目の入力端子は y データを提供します。

プログラムでの使用

ブロック パラメーター: 'NumPorts'

型: integer | character vector

値: [1,100] の範囲の整数

既定の設定: 1

端子 — 入力処理モードを指定する端子

1 (既定値) | 整数

[端子] および [入力処理] パラメーターを併せて使用して、端子の入力処理モードを指定します。入力処理モードにより、Record ブロックが行列データをどのように解釈するかが決まります。

• サンプルベース — 行列の各要素が個別のチャネルです。

• フレームベース — 行列の各列が個別のチャネルです。

フレームベースの入力処理を使用するには、信号が離散サンプル時間をもち、サンプル値が固定次元の非スカラーでなければなりません。

既定の設定では、各端子は入力信号をサンプルベースとして処理します。

端子の入力処理モードを変更するには、以下を行います。

1. [端子] パラメーターを使用して端子番号を選択します。

2. [入力処理] パラメーターを使用して入力処理モードを選択します。

プログラムでの使用

FrameSettings パラメーターをブロック端子の数と同じ数の要素をもつ行ベクトルとして指定することにより、各端子の入力処理モードをプログラムで指定します。要素インデックスはブロックの端子番号に対応します。端子にフレームベースの入力処理を使用するには 1 を指定し、サンプルベースの処理を使用するには 0 を指定します。

ブロック パラメーター: 'FrameSettings'

型: logical 配列

値: 1 行 n 列の行ベクトル。ここで、n は端子の数と等しくなります。

既定の設定: 0

入力処理 — 選択した端子の入力処理モード

Elements as channels (sample-based) (既定値) | Columns as channels (frame-based)

[端子] および [入力処理] パラメーターを併せて使用して、端子の入力処理モードを指定します。入力処理モードにより、Record ブロックが行列データをどのように解釈するかが決まります。

• サンプルベース — 行列の各要素が個別のチャネルです。

• フレームベース — 行列の各列が個別のチャネルです。

フレームベースの入力処理を使用するには、信号が離散サンプル時間をもち、サンプル値が固定次元の非スカラーでなければなりません。

既定の設定では、各端子は入力信号をサンプルベースとして処理します。

端子の入力処理モードを変更するには、以下を行います。

1. [端子] パラメーターを使用して端子番号を選択します。

2. [入力処理] パラメーターを使用して入力処理モードを選択します。

プログラムでの使用

FrameSettings パラメーターをブロック端子の数と同じ数の要素をもつ行ベクトルとして指定することにより、各端子の入力処理モードをプログラムで指定します。要素インデックスはブロックの端子番号に対応します。端子にフレームベースの入力処理を使用するには 1 を指定し、サンプルベースの処理を使用するには 0 を指定します。

ブロック パラメーター: 'FrameSettings'

型: logical 配列

値: 1 行 n 列の行ベクトル。ここで、n は端子の数と等しくなります。

既定の設定: 0

記録

ワークスペースへ記録 — ワークスペースへログを記録するオプション

off (既定値) | on

ワークスペースにログを記録するオプションです。既定では、Record ブロックはデータのログをシミュレーション データ インスペクターのみに記録します。Record ブロックに接続された信号のログ データを Simulink.SimulationData.Dataset オブジェクトの MATLAB^® ワークスペースに記録するには、[ワークスペースへ記録] を選択します。

[ワークスペース変数名] パラメーターを使用して、ログに記録される Record ブロック データを含む Dataset オブジェクトの名前を指定します。

ヒント

• ログ データをワークスペースに記録する場合、データのアクセス方法はモデル コンフィギュレーションによって変わります。既定の設定では、モデルはすべてのログ データを Simulink.SimulationOutput オブジェクトとして単一の出力変数内に含めます。Record ブロック データにアクセスするには、関数 get を使用するか、Record ブロックのワークスペース変数名とドットを使用します。[単一のシミュレーション出力] オプションが無効になっている場合、ログ データはワークスペースの別々の変数に表示され、Record ブロックのデータには直接アクセスします。

• [ログ間隔] コンフィギュレーション パラメーターを使用して指定されたログ間隔は、Record ブロックを使用してワークスペースに記録されたデータに適用されます。

• 1 つの Record ブロックを使用することで、データのログをシミュレーション データ インスペクター、ワークスペース、およびファイルに記録できます。

プログラムでの使用

ブロック パラメーター: 'RecordToWorkspace'

型: 文字ベクトル | boolean | 数値

値: 'on' | 'off' | true または 1 | false または 0

既定の設定: 'off'

ワークスペース変数名 — ログに記録されるブロック データを含むワークスペース変数の名前

recordout (既定値) | 文字ベクトル | string

ログに記録されるブロック データを含むワークスペース変数の名前です。

依存関係

このパラメーターを有効にするには、[ワークスペースへ記録] パラメーターを選択します。

プログラムでの使用

ブロック パラメーター: 'VariableName'

型: 文字ベクトル | string

既定の設定: 'recordout'

ファイルへ記録 — ファイルへログを記録するオプション

off (既定値) | on

ファイルへログを記録するオプションです。既定では、Record ブロックはデータのログをシミュレーション データ インスペクターのみに記録します。Record ブロックに接続された信号のログ データをファイルに記録するには、[ファイルへ記録] を選択します。

ヒント

• [ファイル名] パラメーターを使用してファイルの名前を指定します。

• [ファイル タイプ] パラメーターを使用してログ データを MLDATX ファイル、MAT ファイル、Excel ファイルのどれに記録するか指定します。

• [ファイルの場所] パラメーターを使用してファイルのパスを指定します。

• [ログ間隔] コンフィギュレーション パラメーターを使用して指定されたログ間隔は、Record ブロックを使用してファイルに記録されたデータに適用されません。

プログラムでの使用

ブロック パラメーター: 'RecordToFile'

型: 文字ベクトル | boolean | 数値

値: 'on' | 'off' | true または 1 | false または 0

既定の設定: 'off'

ファイル名 — ログ データを含むファイルの名前

recording.mldatx (既定値) | 文字ベクトル | string

ログ データを含むファイルの名前です。名前にファイルの拡張子を含める必要はありません。名前にファイルの拡張子を含める場合は、指定した [ファイル タイプ] に対して有効な拡張子が使用されていることを確認してください。

ヒント

• ある実行から次の実行にログ記録するファイルの名前と場所を変更しない場合、Record ブロックはファイルに含まれる以前のデータを上書きします。

• 作業ディレクトリ以外の場所にファイルを保存するには、[ファイルの場所] パラメーターを使用して、ファイル保存先ディレクトリのパスを指定します。

依存関係

このパラメーターを有効にするには、[ファイルへ記録] パラメーターを選択します。

プログラムでの使用

FileName パラメーターは、[ファイル名]、[ファイル タイプ]、[ファイルの場所] パラメーターを指定するために使用します。set_param に渡す名前には必要なファイル タイプの拡張子を含めます。現在の作業ディレクトリ以外の場所にファイルを保存するには、ファイル名および拡張子を含むパスを指定します。

ブロック パラメーター: 'FileName'

型: 文字ベクトル | string

既定の設定: 'recording.mldatx'

ファイルの種類 — ログ データのファイルのタイプ

*.mldatx (既定値) | *.mat | *.xslx

[ファイル タイプ] パラメーターを使用してログ データを MLDATX ファイル、MAT ファイル、Excel ファイルのどれに記録するか指定します。

ヒント

• ログ データを Excel ファイルに記録する場合、データはMicrosoft Excel のインポート、エクスポート、ログ形式で説明する形式で記録されます。

• Excel ファイルにログ データを記録する場合、時間列を共有するかどうかを [時間] パラメーターを使用して指定できるほか、ログに記録する信号属性を [属性] パラメーターを使用して指定できます。

依存関係

このパラメーターを有効にするには、[ファイルへ記録] を選択します。

プログラムでの使用

FileName パラメーターは、[ファイル名]、[ファイル タイプ]、[ファイルの場所] パラメーターを指定するために使用します。set_param に渡す名前には必要なファイル タイプの拡張子を含めます。現在の作業ディレクトリ以外の場所にファイルを保存するには、ファイル名および拡張子を含むパスを指定します。

ブロック パラメーター: 'FileName'

型: 文字ベクトル | string

既定の設定: 'recording.mldatx'

ファイルの場所 — ログ データを含むファイルのパス

作業ディレクトリ (既定値) | 文字ベクトル | string

作業ディレクトリ以外の場所にファイルを保存する場合に、ログ データを含むファイルの保存場所を指定するには、[ファイルの場所] パラメーターを使用します。指定するディレクトリへの書き込み権限があることを確認してください。

依存関係

このパラメーターを有効にするには、[ファイルへ記録] を選択します。

プログラムでの使用

FileName パラメーターは、[ファイル名]、[ファイル タイプ]、[ファイルの場所] パラメーターを指定するために使用します。set_param に渡す名前には必要なファイル タイプの拡張子を含めます。現在の作業ディレクトリ以外の場所にファイルを保存するには、ファイル名および拡張子を含むパスを指定します。

ブロック パラメーター: 'FileName'

型: 文字ベクトル | string

既定の設定: 'recording.mldatx'

時間 — 時間データを Excel ファイルにエクスポートするためのオプション

共有の時間列 (既定値) | 個別の時間列

[時間] パラメーターは、Record ブロックのログ データを Excel ファイルに記録する場合に、信号の時間データのログ方法を指定するのに使用します。

• Shared Time Columns — 複数の信号間で時間データが同一の場合、ログ ファイル内の信号は単一の時間列を共有します。Record ブロックが独自の時間データをもつ信号のデータのログを記録している場合、ログ ファイルに複数の時間列が引き続き含まれることがあります。

• Individual Time Columns — 各ログ信号は、ログ ファイル内で常に独自の時間列をもちます。

依存関係

このパラメーターを有効にするには、[ファイルへ記録] を選択し、[ファイル タイプ] を [*.xlsx] に指定します。

属性 — Excel ファイルにエクスポートする信号属性

Data Type | Units | Port Index | Block Path | Interpolation

ログ データを Excel ファイルに記録する場合、ログ ファイルに含める 1 つ以上の信号属性オプションを選択します。選択した信号属性は、Microsoft Excel のインポート、エクスポート、ログ形式で説明する形式に従って、最初のデータ点の上の信号列に表示されます。

依存関係

このパラメーターを有効にするには、[ファイルへ記録] を選択し、[ファイル タイプ] を [*.xlsx] に指定します。

ブロックの特性

データ型	Boolean | bus | double | enumerated | fixed point | half | integer | single | string
直達	いいえ
多次元信号	はい
可変サイズの信号	はい
ゼロクロッシング検出	いいえ

代替構成

XY Graph — 2 つの入力信号をログ記録して XY プロットに可視化

Simulink^® Sinks ライブラリ内の XY Graph ブロックは、XY プロット上の 2 つの入力信号を可視化する Record ブロックの代替の構成です。1 番目の入力端子は XY プロットの x データを提供します。2 番目の入力端子は y データを提供します。

XY Graph ブロックは、非スカラー入力のデータのログ記録と可視化をサポートします。ただし、XY の可視化は多次元データをサポートしません。非スカラー信号を XY Graph ブロックに接続する場合は、XY プロットの x および y データを提供する非スカラー信号のチャネルまたは要素を手動で設定しなければなりません。

ライブラリ:
Simulink / Sinks
HDL Coder / Sinks

ヒント

• Record ブロックを新しいウィンドウで開くには、ブロックを右クリックし、[新規ウィンドウで開く] を選択します。

• Record ブロックを新しいタブで開くには、ブロックを右クリックし、[新しいタブで開く] を選択します。

拡張機能

C/C++ コード生成

Simulink® Coder™ を使用して C および C++ コードを生成します。

このブロックはコード生成時には無視されます。

HDL コード生成

HDL Coder™ を使用して FPGA 設計および ASIC 設計のための VHDL、Verilog および SystemVerilog のコードを生成します。

このブロックを使用して、HDL コードを生成するサブシステムでブロックを使用するときにシミュレーションのデータを記録できます。このブロックをハードウェア実行に含めることはできません。

PLC コード生成

Simulink® PLC Coder™ を使用して構造化テキスト コードを生成します。

このブロックはコード生成時には無視されます。

バージョン履歴

R2021a で導入

R2023b: 非有界の可変サイズの信号のログ記録

ノーマル モードとアクセラレータ モードのシミュレーションでは、Record ブロックでは非有界の可変サイズの信号のログ記録がサポートされていますが、非有界の可変サイズの信号の可視化はサポートされていません。非有界の可変サイズの信号が含まれている非バーチャル バスでは、ログ記録はサポートされていません。

R2023a: 可変サイズの信号を含んでいる非バーチャル バスのログ記録

ノーマル モードとアクセラレータ モードのシミュレーションでは、Record ブロックでは以下のログ記録がサポートされています。

• 可変サイズの信号を直接含んでいるか、入れ子のバスに含んでいる非バーチャル バス

• 可変サイズの信号を含んでいる非バーチャル バスが入れ子になっているバス

ノーマル モードのシミュレーションでのみ、Record ブロックでは以下のログ記録がサポートされています。

• 可変サイズの信号を含んでいる非バーチャル バスが含まれたバス配列

Record ブロックでは可変サイズの信号の可視化はサポートされません。

R2022b: 個々の信号のスケーリング

Record ブロックの個々の信号の表示スケールおよびオフセットを設定できます。

• 時間プロットおよびスパークライン — "y" 値の表示をスケーリングおよびオフセットします。

• XY プロット — "x" 値と "y" 値の表示を個別にスケーリングおよびオフセットします。

• マップ — 経度と緯度を個別にスケーリングおよびオフセットします。

カーソルはスケーリングされていない値を表示し続けます。

R2021b: Record ブロックの代替構成への XY Graph ブロックの置き換え

XY Graph ブロックが、2 つの入力信号を XY プロットに表示するように事前構成された Record ブロックに置き換えられています。更新された XY Graph ブロックを使用して以下を行うことができます。

• シミュレーション中に XY プロットでデータを表示する。

• XY プロットのデータをワークスペース、ファイル、またはワークスペースとファイルの両方に記録する。

• 再度シミュレートすることなく、ズーム、パン、ビューに合わせる操作、および XY プロットの軸の範囲の調整を行う。

• カーソルの使用およびトレンド ラインの追加によって XY トレースを解析する。

• 端子およびサブプロットをさらに追加し、時間プロット、マップ、追加の XY プロットなどの複数の可視化タイプで XY プロットと共に追加のシミュレーション データを可視化する。

• XY プロットで複数のトレースを可視化する。

シミュレーションを実行すると、XY Graph ブロックの以前のバージョンでは、新しいウィンドウが開いて、シミュレーション中に接続されている信号データが表示されていました。更新された XY Graph ブロックでデータを表示するには、モデル内のブロックをダブルクリックします。新しいウィンドウで XY プロットを表示するには、ブロックを右クリックし、[新規ウィンドウで開く] を選択します。

既存のモデル内の XY Graph ブロックは、新しい XY Graph ブロックに自動的に置き換えられます。XY Graph ビューアーも新しい XY Graph ブロックに置き換えられています。Goto ブロックおよび From ブロックは、XY Graph ビューアーを置き換える XY Graph ブロックに信号を接続します。

XY Graph ブロックに接続された信号は、常にシミュレーション データ インスペクターにストリーミングされます。

R2021a: [ログ間隔] コンフィギュレーション パラメーターは Record ブロックを使用してワークスペースにログ記録されたデータに適用される

[ログ間隔] コンフィギュレーション パラメーターは Record ブロックを使用してワークスペースにログ記録されたデータに適用されます。

[ログ間隔] パラメーターは、Record ブロックを使用してファイルにログ記録されたデータや、Record ブロックでの信号の表示方法には影響しません。シミュレーション データ インスペクターで、Record ブロックに接続されている信号の完全な信号データにアクセスすることもできます。

参考

ツール

• シミュレーション データ インスペクター

ブロック

• Outport | To Workspace | To File | Playback

モデル設定

• 単一のシミュレーション出力