指定した.tdmsファイルを読み取り、データタイプ入力で指定した形式でデータを返します。データにスケール情報が含まれる場合、このVIはデータを自動的にスケールします。カウントオフセットの各入力で、指定されたデータのサブセットを読み取ります。


icon

入力/出力

  • ci64.png カウント (-1: すべて)

    カウントは、各チャンネルの.tdmsファイルから読み取るデータ要素の最大数を指定します。デフォルトは–1 (使用できるすべての要素) です。

  • ci64.png オフセット (0)

    オフセットは、関数で.tdmsファイルの解析を開始する際に.tdmsファイルへのデータの要素数を指定します。デフォルトは0です。

  • cgnrn.png TDMSファイル

    tdms fileには 、操作を実行する .tdms ファイルへの 参照番号( )を指定する。Refnumを開くには、「TDMSを開く」関数を使用します。

  • cstr.png グループ名入力

    グループ名入力は操作を実行するチャンネルグループを指定します。

    この入力を配線しない場合、以下の動作が発生します。

    • LabVIEWは、ファイルの現在のグループからデータを読み取ります。現在のグループとは、この関数を最初に実行したときはファイル内の最初のグループで、複数サイクルを連続して実行した場合はn番目のサイクルのn番目のグループです。
    • 「TDMS読み取り」関数がグループを読み取る順序は、「TDMSの内容をリスト」関数がグループを返す順序と同じです。
    • LabVIEWが最後のグループに到達した後、「TDMS読み取り」関数が実行を試みると、LabVIEWはファイル末尾エラーを返します。
    メモ TDMS List Contents関数と TDMS Get Properties 関数は、現在のグループをファイルの最初のグループにリセットします。グループ名入力に配線しない場合、グループをファイル内の最初のグループにリセットすると、次の「TDMS読み取り」関数が読み取るグループに影響が出ます。
  • c1dstr.png チャンネル名入力

    チャンネル名入力は操作を実行するチャンネルを示します。データをこの入力を配線しない場合、同じグループのすべてのチャンネルのデータが読み取られます。波形データをデータタイプ入力に配線すると、波形名が使用されます。チャンネル名入力入力は、文字列または文字列の1D配列のデータタイプを受け入れます。データタイプは、データタイプ入力に配線するデータにより異なります。

    文字列文字列の1D配列

    アナログ波形

    以下を要素とする1D配列:

    • 符号付きまたは符号なし整数
    • 浮動小数点数
    • タイムスタンプ
    • ブール
    • NULL文字を含まない英数字文字列

    デジタル波形

    デジタルテーブル

    アナログ波形の1D配列

    以下を要素とする2D配列:

    • 符号付きまたは符号なし整数
    • 浮動小数点数
    • タイムスタンプ
    • ブール
    • NULL文字を含まない英数字文字列

    圧縮されたデジタルデータを含む完全なファイルまたはグループをロードすると、LabVIEWは自動的に圧縮チャンネル名を 配列のチャンネル 名に挿入します。 圧縮されたデジタルデータを含むファイルまたはグループのサブセットをロードする場合、圧縮チャンネルの名前を 配列のチャンネル名(複数可 )の最初のエントリとして入力する必要があります。

  • cerrcodeclst.png エラー入力 (エラーなし)

    エラー入力は、このノードを実行する前に発生したエラーの状態を示します。この入力は、標準エラー入力として機能します。

  • c1dmsdt.png データタイプ

    データタイプは、取得するデータのデータタイプです。

    この入力には以下のデータタイプを使用できます。
    • アナログ波形またはアナログ波形の1D配列
    • デジタル波形
    • デジタルテーブル
    • ダイナミックデータ
    • 次の1Dまたは2D配列:
      • 符号付きまたは符号なし整数
      • 以下のデータタイプを含む浮動小数点数
        • 単精度および倍精度の浮動小数点数
        • 単精度および倍精度の複素浮動小数点数
        • (Windows) 拡張精度浮動小数点数
      • タイムスタンプ
      • ブール
      • NULL文字を含まない英数字文字列
  • cbool.png ファイル順にチャンネルを返す? (F)

    ファイル順にチャンネルを返す?は、この関数から.tdmsファイルと同じ順番でデータチャンネルを返すかどうかを指定します。値がTRUEであるか、チャンネル名入力を指定しない場合、この関数はデータチャンネルを.tdmsファイルに存在している順序で返します。値がFALSEの場合は、チャンネル名入力で指定された順番でデータチャンネルが返されます。デフォルトはFALSEです。

  • ignrn.png TDMSファイル出力

    tdms file out は、操作を実行した .tdms ファイルへの TDMS ファイル参照を 返します。

  • istr.png グループ名出力

    グループ名出力は操作を実行するチャンネルグループ名を返します。

  • i1dstr.png チャンネル名出力

    チャンネル名出力は操作を実行するチャンネル名を返します。

  • i1dmsdt.png データ

    データには、指定したデータタイプでファイルから読み取られたデータが含まれます。これは、データタイプで指定するデータタイプ、およびカウントの設定方法に応じたデータタイプを構成します。

  • ierrcodeclst.png エラー出力

    エラー出力には、エラー情報が含まれます。この出力は、標準エラー出力として機能します。

  • ibool.png ファイルの終わり?

    ファイルの終わり?は、ファイルの終わりに到達したかを示します。

  • サンプルプログラム

    LabVIEWに含まれている以下のサンプルファイルを参照してください。

    • labview\examples\File IO\TDMS\Standard Read and Write\TDMS Read Events Data.vi
    • labview\examples\File IO\TDMS\Concurrent Access to TDMS File.vi