TDMSチャンネル情報を設定関数
- 更新日2025-07-30
- 7分で読める
指定された.tdmsファイルに書き込む未処理データのチャンネル情報を定義します。チャンネル情報には、データレイアウト、グループ名、チャンネル名、データタイプ、およびサンプル数が含まれます。
入力/出力
データレイアウト (0:インタリーブされていない)
—
データレイアウトは、.tdmsファイルにストリームしたいデータの配列方法を指定します。同じグループの各チャンネルには同じデータレイアウトを使用する必要があります。
TDMSファイル
—
グループ名 (名称未設定)
—
グループ名は、チャンネルのグループ名を指定します。この入力にデータが未配線の場合や空の文字列が配線されている場合、この関数はグループ名として名称未設定を使用します。 
チャンネル名
—
チャンネル名はチャンネルの名前を指定します。 
エラー入力 (エラーなし)
—
エラー入力は、このノードを実行する前に発生したエラーの状態を示します。この入力は、標準エラー入力として機能します。 
データタイプ
—
データタイプは、操作を実行するデータのタイプを指定します。この入力は、整数、浮動小数点整数、ブール、およびタイムスタンプを受け入れます。 メモ この入力には、以下の浮動小数点数を配線できる：
サンプル数/チャンネル
—
サンプル数/チャンネルは、各チャンネルに含まれるデータサンプルの数を指定します。 
TDMSファイル出力
—
エラー出力
—
エラー出力には、エラー情報が含まれます。この出力は、標準エラー出力として機能します。 |
以下の使用例は、「TDMSチャンネル情報を設定」関数が、データレイアウト入力に応じて、未処理データを配置する方法を示しています。
単一グループ、単一チャンネル (非インタリーブ)
ファイルのデータレイアウトはチャンネルごとの連続サンプルです。上図は、1つの16ビット数値 (I16) サンプルが別のI16サンプルに続き、それがまた別のI16サンプルに続くというパターンです。任意数のI16サンプルを書き込むことができます。たとえば、一度に100万個、200万個のI16サンプルを書き込むことができます。
単一グループ、複数チャンネル (非インタリーブ)
データレイアウトは、チャンネルごとの8つの連続サンプルです。上図のデータレイアウトは、ch0チャンネルのI16サンプル8つにch1チャンネルのI16サンプル8つが続きます。
単一グループ、複数チャンネル (インタリーブ)
上図のデータレイアウトは、ch0チャンネルのI16サンプル1つにch1チャンネルのI16サンプル1つが続きます。ファイル内でこのペアが繰り返されます。NI_ChannelLengthプロパティの合計ファイルサイズにより、ペアの繰り返し回数が決まります。
複数グループ、複数チャンネル (非インタリーブ)
データレイアウトは、グループまたはデバイスごとにサンプルが8つ連続します。上図のデータレイアウトでは、デバイス1のch0チャンネルのI16サンプル8つ、デバイス1のch1チャンネルのI16サンプル8つ、デバイス2のch0チャンネルのI16サンプル8つ、デバイス2のch1チャンネルのI16サンプル8つのパターンを繰り返します。
複数グループ、複数チャンネル (インタリーブ)
上図のデータレイアウトでは、デバイス1のch0チャンネルのI16サンプル1つとch1チャンネルのI16サンプル1つのペアが8つ入ります。8つのペアの次に、デバイス2のch0チャンネルのI16サンプル1つとch1チャンネルのI16サンプル1つのペアが8つ入ります。ファイル内でこのパターンが繰り返されます。
サンプルプログラム
LabVIEWに含まれている以下のサンプルファイルを参照してください。
- labview\examples\File IO\TDMS\Advanced Read and Write\Asynchronous Read and Write\TDMS Advanced Append Multiple Headers.vi