主要内容

このページの翻訳は最新ではありません。ここをクリックして,英語の最新版を参照してください。

从文件

小地毯ファイルからのデータの読み込み

  • ライブラリ:
  • 金宝app模型/来源

  • 从文件块

説明

从文件ブロックは、小地毯ファイルからモデルへデータを読み込み、データを信号として出力します。このデータは、一連のサンプルです。各サンプルは、タイム スタンプと関連するデータ値で構成されています。データは配列形式または MATLAB®timeseries形式で表されます。

从文件ブロックのアイコンには、データをブロックに提供する 小地毯ファイルの名前が表示されます。

同じ 小地毯ファイルからデータを読み込む从文件ブロックが複数あってもかまいません。

サポートされる垫ファイルのバージョンは以7.0版本前および7.3版本です。从文件ブロックは 版本7.3のファイルからデータを段階的に読み込みます。

データの読み込み方法として以下を指定できます。

  • サンプル時間

  • 欠損データ点のデータの処理方法

  • ゼロクロッシング検出を使用するかどうか

詳細については,从文件ブロックを使用したデータの読み込みを参照してください。

端子

出力

すべて展開する

垫ファイルデータ。一連のサンプルとして指定します。各サンプルは,タイムスタンプと関連するデータ値で構成されています。データは配列形式またはMATLABtimeseries形式で表されます。从文件ブロックを使用してtimeseriesデータを読み込む場合、時間データのデータ型はでなければなりません。

データ型:||int8|int16|int32|uint8|uint16|uint32|布尔|定点|枚举|公共汽车

パラメーター

すべて展開する

入力データを含んでいる垫ファイルのパスまたはファイル名。パスまたはファイル名は次のいずれかの方法で指定できます。

  • 有効な 小地毯ファイルがあるフォルダーを参照します。

    UNIX®システムでは,ホームフォルダーを意味するチルダ(~)文字でパス名を始めることができます。

  • テキスト ボックスにファイルのパスを入力します。

既定のファイル名は无标题です。ファイル名でパスの情報が指定されない場合、金宝app模拟®は現在のフォルダーまたは MATLABパスにあるファイルを読み込みます (現在のフォルダーを確認するには、MATLABコマンド プロンプトで松材线虫病と入力します)。

依存関係

RSimターゲットのコード生成は、模金宝app拟と同じサポートを提供します。その他のすべてのコード生成ターゲットは、時間形式の配列の 双重的の 1.次元実信号のみをサポートします。

ERT/GRTターゲットのビルドまたは SIL/PILシミュレーション モードの使用を含むコードを生成するには、小地毯ファイルに 2.行以上の空でない有限実数行列が含まれていなければなりません。

从文件ブロックを使用したC / c++コード生成の詳細については,コード生成を参照してください。

プログラムでの使用

ブロック パラメーター:文件名
型:文字ベクトル
値:垫ファイル名
既定の設定:“无标题。mat”

从文件ブロックが出力するデータのデータ型。非バス型の場合、[继承:自动]を使用して任意のデータ型検証をスキップできます。出力データ型を指定する場合,从文件ブロックはファイル内のデータが指定したデータ型と一致することを確認します。詳細については、信号のデータ型の制御を参照してください。

[出力データ型]をバスオブジェクトとして設定した場合,そのバスオブジェクトはモデルのコンパイル時に利用可能でなければなりません。バスデータの信号ごとに,从文件ブロックは、データ型、次元および実数/複素数がデータおよびバス オブジェクトと同じであるか検証します。

[データ型アシスタントを表示]ボタンをクリックして、データ型の属性の設定に役立つ[データ型アシスタント]を表示します。詳細については、データ型アシスタントを利用したデータ型の指定を参照してください。

プログラムでの使用

ブロック パラメーター:OutDataTypeStr
型:文字ベクトル
値:'继承:auto' | 'double' | 'single' | 'int8' | 'uint8' | 'int16' | 'uint16' | 'int32' | 'uint32' | 'boolean' | 'fixdt(1,16,0)' | 'fixdt(1,16,2^0,0)' | 'Enum: <类名>' | 'Bus: <对象名>' | '<数据类型表达式>'
既定の設定:'继承:自动'

サンプリング周期とオフセットを指定します。

从文件ブロックは、次のいずれかのサンプル時間を使用して 小地毯ファイルからデータを読み込みます。

  • 从文件ブロックに対して指定したサンプル時間。

  • 从文件ブロックがデータのフィード先のブロックから継承したサンプル時間。

既定のサンプル時間は0で,これは連続サンプル時間の指定となります。垫ファイルはモデルの基本レート(最速)で読み込まれます。詳細については,サンプル時間の指定を参照してください。

プログラムでの使用

ブロック パラメーター:取样时间
型:文字ベクトル
値:スカラー|ベクトル
既定の設定:'0'

小地毯ファイルの最初のタイム スタンプの前に発生するシミュレーション時間ヒットの外挿法。次の外挿法のいずれかを選択します。

メソッド 説明
線形外挿

(既定)

小地毯ファイルに 1.つのサンプルしか含まれていない場合は、从文件ブロックは対応するデータ値を出力します。

小地毯ファイルに 1.つを超えるサンプルが含まれている場合は、从文件ブロックは最初の 2.つのサンプルを使用して線形外挿します。

  • データの場合、最初の 2.つのサンプルを使用して値を線形外挿します

  • 布尔データの場合、最初のデータ値を出力します

  • または布尔以外の組み込みデータ型の場合,从文件ブロックは次を実行します。

    • データをにアップキャストする

    • 線形外挿を実行する (データの説明を参照)

    • 外挿データ値を元のデータ型にダウンキャストする

列挙型 (枚举) データでは、[線形外挿]オプションは使用できません。バス内のすべての信号は同じ外挿設定を使用します。バス内のすべての信号は枚举データを使用しているため、[線形外挿]オプションを使用できません。

最初の値をホールド

ファイル内の最初のデータ値を使用します

グラウンド値

小地毯ファイルのサンプル データ値のデータ型によって異なる値を使用します。

  • 固定小数点データ型 — グラウンド値を使用します

  • 固定小数点以外の数値型 —0を使用します

  • 布尔错误的を使用します

  • 列挙データ型 — 既定値を使用します

依存関係

ERT/GRTターゲットのビルドまたは SIL/PILシミュレーション モードの使用を含むコードを生成するには、このパラメーターを[線形外挿]に設定しなければなりません。从文件ブロックを使用したC / c++コード生成の詳細については,コード生成を参照してください。

プログラムでの使用

ブロック パラメーター:ExtrapolationBeforeFirstDataPoint
型:文字ベクトル
値:“线性外推”|“保持第一个值”|“基础值”
既定の設定:“线性外推”

金宝app仿真软件が垫ファイルの2つのタイムスタンプ間のシミュレーション時間ヒットに使用する内挿法。次のいずれかの内挿法を選択します。

メソッド 説明
線形内挿

(既定)

从文件ブロックは、2.つの対応する 小地毯ファイル サンプルを使用して内挿します。

  • データの場合、2.つの対応するサンプルを使用して値を線形内挿します

  • 布尔データの場合、最初の半分のサンプルに错误的を使用し、残りの半分に符合事实的を使用します

  • または布尔以外の組み込みデータ型の場合,从文件ブロックは次を実行します。

    • データをにアップキャストする

    • データの説明に従って線形内挿を実行する

    • 内挿値を元のデータ型にダウンキャストする

ゼロ次ホールド

2つのサンプルのうち最初のサンプルのデータを使用します

制限

列挙型 (枚举) データでは、[線形内挿]オプションは使用できません。バス内のすべての信号は同じ内挿設定を使用します。バス内のいずれかの信号が枚举データを使用する場合は,[線形内挿]オプションを使用できません。

依存関係

ERT/GRTターゲットのビルドまたは SIL/PILシミュレーション モードの使用を含むコードを生成するには、このパラメーターを[線形内挿]に設定しなければなりません。从文件ブロックを使用したC / c++コード生成の詳細については,コード生成を参照してください。

プログラムでの使用

ブロック パラメーター:InterpolationWithinTimeRange
型:文字ベクトル
値:'线性插值' | '零阶保持'
既定の設定:“线性插值”

小地毯ファイルの最後のタイム スタンプ後に発生するシミュレーション時間ヒットの外挿法。次のいずれかの外挿法を選択します。

メソッド 説明
線形外挿

(既定)

小地毯ファイルに 1.つのサンプルしか含まれていない場合は、从文件ブロックは対応するデータ値を出力します。

小地毯ファイルに 1.つを超えるサンプルが含まれている場合は、从文件ブロックは最後の 2.つのサンプルのデータ値を使用して線形外挿します。

  • データの場合,最後の2つのサンプルを使用して値を外挿する。

  • 布尔データの場合、最初のデータ値を出力する。

  • 双または布尔以外の組み込みデータ型の場合:

    • データをにアップキャストする

    • データの説明に従って線形外挿を実行する

    • 外挿値を元のデータ型にダウンキャストする

最後の値をホールド

ファイル内の最後のデータ値を使用します

グラウンド値

小地毯ファイルのサンプル データ値のデータ型によって異なる値を使用します。

  • 固定小数点データ型 — グラウンド値を使用します

  • 固定小数点以外の数値型 —0を使用します

  • 布尔错误的を使用します

  • 列挙データ型 — 既定値を使用します

制限

列挙型 (枚举) データでは、[線形外挿]オプションは使用できません。バス内のすべての信号は同じ外挿設定を使用します。バス内のすべての信号は枚举データを使用しているため、[線形外挿]オプションを使用できません。

依存関係

ERT/GRTターゲットのビルドまたは SIL/PILシミュレーション モードの使用を含むコードを生成するには、このパラメーターを[線形外挿]に設定しなければなりません。从文件ブロックを使用したC / c++コード生成の詳細については,コード生成を参照してください。

プログラムでの使用

ブロック パラメーター:推断最后一个数据点
型:文字ベクトル
値:'线性外推' | '保持最后值' | '底值'
既定の設定:“线性外推”

ゼロクロッシング検出を有効にします。

ゼロクロッシング検出パラメーターは、サンプル時間パラメーターが0(連続)に設定されている場合のみ適用されます。

金宝app模拟はゼロクロッシング検出という手法を使用して、過度に小さいタイム ステップを取ることなくタイム スタンプの不連続点を特定します。"ゼロクロッシング" は不連続を表します。

从文件ブロックの場合,ゼロクロッシング検出はファイル内のタイムスタンプのみで発生します。金宝app仿真软件はタイムスタンプのみを調べ,データ値は調べません。

バス信号の場合、金宝app模拟はすべてのリーフ バス要素にわたるゼロクロッシングを検出します。

入力配列に重複するタイム スタンプが含まれている (同一のタイム スタンプのエントリが 1.つを超える) 場合、金宝app模拟はそれらのタイム スタンプのゼロクロッシングを検出します。たとえば、入力配列に次のようなデータがあるとします。

时间:0 1 2 2 3信号:2 3 4 5 6

時間 2.に入力信号の不連続によるゼロクロッシングがあります。

重複しないタイム スタンプがある場合、ゼロクロッシング検出は次のパラメーターの設定によって変わります。

  • 最初のデータ点前のデータ外挿

  • 時間範囲内のデータ内挿

  • 最後のデータ点後のデータ外挿

ゼロクロッシングが発生するタイミングに関する从文件ブロックの判定は,タイムスタンプに応じて変わります。

タイム スタンプ 設定

1 次

[最初のデータ点前のデータ外挿][グラウンド値)に設定されます。

最初と最後の間

[時間範囲内のデータ内挿][ゼロ次ホールド]に設定されます。

最後

次の設定の両方またはどちらかが適用されます。

  • [最後のデータ点後のデータ外挿][グラウンド値)に設定されます。

  • [時間範囲内のデータ内挿][ゼロ次ホールド]に設定されます。

次の図は、次の設定になっている从文件ブロックによってアクセスされるデータのゼロクロッシング検出を示しています。

  • 最初のデータ点前のデータ外挿線形外挿

  • 時間範囲内のデータ内挿(内部点の場合) —ゼロ次ホールド

  • 最後のデータ点後のデータ外挿線形外挿

次の図は,从文件ブロックによってアクセスされるデータのゼロクロッシング検出の別の例を示しています。ブロックには,タイムスタンプ(点)用の次の設定があります。

  • 最初のデータ点前のデータ外挿最初の値をホールド

  • 時間範囲内のデータ内挿ゼロ次ホールド

  • 最後のデータ点後のデータ外挿最後の値をホールド

依存関係

ERT GRT /ターゲットのビルドまたはSIL /公益诉讼シミュレーションモードの使用を含むコードを生成するには,このチェックボックスをオフにします。从文件ブロックを使用したC / c++コード生成の詳細については,コード生成を参照してください。

プログラムでの使用

ブロック パラメーター:零交叉
: 文字ベクトル
:“关闭”|“开”
既定の設定:“开”

ブロックの特性

データ型

布尔|公共汽车||枚举|定点[A.]|整数|

直接フィードスルー

いいえ

多次元信号

はい

可変サイズの信号

いいえ

ゼロクロッシング検出

はい

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

拡張機能

R2006aより前に導入