To File

データをファイルに書き込み

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

説明

To Fileブロックは入力信号データを MAT ファイルに書き込みます。ブロックは出力ファイルにインクリメンタルに書き込むため、シミュレーション中のメモリのオーバーヘッドは最小になります。シミュレーションを開始したときに出力ファイルが存在すると、ブロックはそのファイルを上書きします。ファイルは、シミュレーションを一時停止したとき、またはシミュレーションが完了したときに自動的に閉じられます。シミュレーションが正常終了しなかった場合は、To Fileブロックは異常終了した時点までに記録されたデータを保存します。

To Fileブロックのアイコンは、出力ファイル名を示します。

保存されるデータ量の制御

[コンフィギュレーション]、[データのインポート/エクスポート]、[ログ間隔]パラメーターでデータのログ間隔を指定した場合、To Fileブロックはこの間隔内のデータのみログ記録します。たとえば、間隔が空 ([]) の場合、ブロックはデータをログに記録しません。ブロックは、ログに記録したデータを[単一のシミュレーション出力]パラメーターでた変数，ブロックに付けたファイルに保存します。

可変ステップソルバー场合，To Fileブロックにできる量をするには，[コンフィギュレーション]、[データのインポート/エクスポート]、[追加パラメーター]、[出力]パラメーターを使用します。たとえば、複数のシミュレーションに対して同一の時点でデータを書き込む場合は、仅生产指定的输出オプションを選択します。

ブロックパラメーターした量の制御行い。。。間引き, Decimation間引きDecimationおよびサンプル時間, Sample timeサンプル時間Sample timeを参照してください。

シミュレーションの一時停止

シミュレーションを停止した，，To Fileブロックが书き込んでファイルは変更しでくださいくださいたとえばたとえば，そのようようななファイルファイルファイルを^®saveコマンドで保存しないでください。それらのファイルを変更すると、シミュレーションを再開したときにエラーが発生するおそれがあります。一時停止後にファイルを変更する場合は、変更するファイルをコピーして、コピーしたファイルに対して作業を行うようにしてください。

シミュレーションステッパー使用て停止した，，To Fileブロックが停止時点までのシミュレーションデータをキャプチャします。ステップを戻すと、To Fileデータファイルには、最後の出力から元に戻った時間より後のすべてのシミュレーションデータが含まれなくなります。

制限

To Fileブロックが参照モデル内に存在する場合は、そのモデルは、単一インスタンスモデルでなければなりません。そのようなモデルの 1 つのインスタンスのみがモデルの階層内に存在可能です。詳細については、モデルの再利用を参照してください。

端子

入力

すべて展开する

`Port_1`— 入力信号
スカラー|ベクトル| 行列 | N 次元配列

ファイルに格納する信号。各サンプルは、タイムスタンプと関連するデータ値で構成されています。データは配列形式または MATLABtimeseries形式で表さます。To Fileブロックは、語長が 32 ビットを超える固定小数点データを除いて、Simulink^®ソフトウェアが任意データ型の実数信号データを受け入れ。。

データ：：single|double|int8|INT16|INT32|int64|uint8|uint16|uint32|uint64|Boolean|固定点|枚举|bus

パラメーター

すべて展开する

`ファイル名`— パスまたはファイル名
`untitled.mat`（既定）|MAT ファイルのパスまたは名前

出力を格納する MAT ファイルのパスまたはファイル名を指定します。UNIX^®システムでは、ホームフォルダーを示すチルダ (~) 文字でパス名を始めることができます。ファイル名でパスの情報が指定されない場合、Simulink ソフトウェアは MATLAB 作業フォルダーにファイルを格納します (作業フォルダーを判定するには、MATLAB コマンドラインで「pwd」と入力します)。ファイルが存在する場合、Simulink ソフトウェアはそのファイルを上書きします。

プログラムでの使用

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

型:文字ベクトル

値:MAT ファイルのパスまたは名前

既定の：'untitled.mat'

`変数名`— 行列名
`Ans`（既定）|文字ベクトル

ファイルに含まれる行列の名前を指定します。

プログラムでの使用

ブロックパラメーター:MatrixName

型:文字ベクトル

値:文字ベクトル

既定の：'ans'

`保存形式`— データ形式
`时系列`（既定）|`配列`

To Fileブロックがデータの書き込みに使用するデータ形式を指定します。

ベクトル、double、非複素数の信号に対してのみ、[配列]形式を使用します。

[时]形式では、To Fileブロックによって次の操作が行われます。

データを MATLABtimeseriesオブジェクトに書き込みます。
多次元、実数または複素数の出力値の書き込みをサポートします。
任意の組み込みデータ型の出力値 (Boolean、列挙型 (enum），最最ビットのの点などなどなどなどなどのをサポートし。。
バーチャルまたは非バーチャルのバス入力信号に対して、バス階層に一致する MATLAB 構造体を作成します。構造体の各リーフは MATLABtimeseriesオブジェクトです。

[配列]形式では、To Fileブロックによって次の操作が行われます。

データを行がれいる行列书き込みます行列は以下のの形式をを。。。

$[\begin{matrix} t_{1} & t_{2} & \dots & t_{f i n a l} \\ u 1_{1} & u 1_{2} & \dots & u 1_{f i n a l} \\ \dots \\ u n_{1} & u n_{2} & \dots & u n_{f i n a l} \end{matrix}]$

金宝appsimulink simulinkソフトウェアは列各サンプルのに书き込みますの最初最初のの要素要素にに，，タイムスタンプがが含ま含まれてています。。。。のににはははは
1次元次元，非のの书き込みサポートし。。。

From Fileブロックは、To Fileブロックによって書き込まれたデータを変更や特別な準備なしで、任意の形式 (Timeseriesまたは大批) で利用することができます。

From Workspaceブロックは、大批形式のデータを読み取ることができ、To Fileブロックによって書き込まれたデータの転置が必要です。要求される形式を提供するには、MATLAB コマンドを使ってデータを MAT ファイルから読み込んで、転置します。

次の表は、各シミュレーションモードでサポートされる[保存形式]の値をまとめたものです。

シミュレーションモード	`时系列`	`配列`
ノーマル	サポートあり	サポートあり
アクセラレータ	サポートあり	サポートあり
ラピッドアクセラレータ	サポートあり	サポートあり
ソフトウェアインザループ（SIL）	サポートなし	MAT ファイルのログが有効になっている場合にサポート
プロセッサインザループ（PIL）	サポートなし	MAT ファイルのログが有効になっていて利用可能な場合にサポート
エクスターナル	サポートなし	MAT ファイルのログが有効になっている場合にサポート
RSim ターゲット	サポートあり	MAT ファイルのログが有効になっている場合にサポート

プログラムでの使用

ブロックパラメーター:SaveFormat

型:文字ベクトル

値:“Timeseries' | 'Array'

既定の：“Timeseries'

`間引き`— データを書き込むタイミングを決定する間引き係数
1（既定）|スカラー|ベクトル

データれるれるれるれる回回数数数数数指定指定しますます。。既既定値では，，このこのこのブロックブロックブロック

プログラムでの使用

ブロックパラメーター:Decimation

型:文字ベクトル

値:スカラー|ベクトル

既定の：'1'

`サンプル時間`— サンプリング周期とオフセット
-1（既定）|スカラー|ベクトル

点をサンプリングととを指定し。。この，，タイムタイムステップステップののの间隔间隔ががでないでない可変可変ステップステップソルバーソルバーを使用使用するする场合场合场合场合にににに既既定定定定定ます。サンプル時間の指定を参照してください。

プログラムでの使用

ブロックパラメーター:SampleTime

型:文字ベクトル

値:スカラー|ベクトル

既定の：'-1'

モデルの例

ブロックによるシミュレーションデータの出力

この例では、To Workspace ブロックがワークスペースに、To File ブロックがファイルにデータに書き込む方法を示します。

スクリプトを開く

ブロックの特性

データ型	`Boolean`\|`bus`\|`double`\|`枚举`\|`固定点^a`\|`整数`\|`single`
直接フィードスルー	`いいえ`
多次元信号	`はい`
可変サイズの信号	`いいえ`
ゼロクロッシング検出	`いいえ`
^a32 ビットまでの固定小数点データ型をサポートします。

ヒント

多くのタイムステップを含む長いシミュレーションで多数の信号のログを記録するときに MATLAB でメモリの問題が発生する場合は、永続ストレージへのログを検討してください。永続ストレージにログを記録すると、数据集形式のログデータが MAT ファイルに保存されます。永続ストレージへのログと比較した場合、To File ブロックを信号に接続すると、以下のようになります。
- 個々の信号に接続された複数のTo Fileブロックをもつモデルを煩雑化する可能性がある信号単位のアプローチになる。
- 1 つの MAT ファイルが使用される永続ストレージへのログとは対象的に、To File ブロックごとに異なる MAT ファイルが作成される。
详细については，永続ストレージへのデータの記録を参照してください。
リアルタイムでデータの圧縮のオーバーヘッドを回避するために、To File7.3版7.3版Matlabファイルのののののののファイルファイルファイルファイルファイルデータデータををを圧缩圧缩するするするするにには，，，，はははははでででででを読み込ん节省コマンドが MAT ファイル内のデータを圧縮するため、To Fileブロックが作成した元の MAT ファイルよりもサイズが小さくなります。

拡张机能

C/C ++コード生成
金宝appsimulink®编码器™を使用てc+ c ++コードを生成ます。。

产コード推奨さません。组み込みシステムでよく见见とメモリメモリにに关する关する关するリソースのとと制约制约に关连关连します。。生成さささコードコードはははメモリメモリメモリメモリメモリメモリメモリメモリメモリのおよび広范囲する时间が含まれるれるがありますますが十分十分ななな环境环境でではがが机能机能的的にに有效で全般的的ににににてて，，，，，，，小小小小あります，は量产コードににます。。ためため，量量产コードに适し适したブロックブロックブロックはは

RSim ターゲットのコード生成は、Simulink と同じサポートを提供します。その他のすべてのコード生成ターゲットは、時間形式の配列の double の 1 次元実信号のみをサポートします。

To Fileブロックのを生成する，，[コード生成]、[インターフェイス]ペインでコンフィギュレーションパラメーターMAT ファイルのログ(Simulink Coder)を選択します。

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

hdl，コードコード生成するサブでするにシミュレーションシミュレーション结果をを书き込む书き込むためため使用使用できますががが，，，ハードウェアハードウェア実行

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

固定小数点の変換
定点设计师™™をして小数点设计とシミュレーションを行い。。

32 ビットまでの固定小数点データ型をサポートします。

バージョン履歴

R2006Aよりに导入导入

参考

From File|记录|To Workspace|From Workspace

To File

説明

保存されるデータ量の制御

シミュレーションの一時停止

制限

端子

入力

Port_1— 入力信号スカラー|ベクトル| 行列 | N 次元配列

パラメーター

ファイル名— パスまたはファイル名untitled.mat（既定）|MAT ファイルのパスまたは名前

プログラムでの使用

変数名— 行列名Ans（既定）|文字ベクトル

プログラムでの使用

保存形式— データ形式时系列（既定）|配列

プログラムでの使用

間引き— データを書き込むタイミングを決定する間引き係数1（既定）|スカラー|ベクトル

プログラムでの使用

サンプル時間— サンプリング周期とオフセット-1（既定）|スカラー|ベクトル

プログラムでの使用

モデルの例

ブロックによるシミュレーション データの出力

ブロックの特性

ヒント

拡张机能

C/C ++コード生成金宝appsimulink®编码器™を使用てc+ c ++コードを生成ます。。

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

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

固定小数点の変換定点设计师™™をして小数点设计とシミュレーションを行い。。

バージョン履歴

参考

トピック

`Port_1`— 入力信号
スカラー|ベクトル| 行列 | N 次元配列

`ファイル名`— パスまたはファイル名
`untitled.mat`（既定）|MAT ファイルのパスまたは名前

`変数名`— 行列名
`Ans`（既定）|文字ベクトル

`保存形式`— データ形式
`时系列`（既定）|`配列`

`間引き`— データを書き込むタイミングを決定する間引き係数
1（既定）|スカラー|ベクトル

`サンプル時間`— サンプリング周期とオフセット
-1（既定）|スカラー|ベクトル

ブロックによるシミュレーションデータの出力

C/C ++コード生成
金宝appsimulink®编码器™を使用てc+ c ++コードを生成ます。。

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

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

固定小数点の変換
定点设计师™™をして小数点设计とシミュレーションを行い。。