读取指定的.tdms文件并以数据类型输入端指定的格式返回数据。如数据包含缩放信息,VI可自动换算数据。总数偏移量输入端用于读取指定的数据子集。


icon

输入/输出

  • ci64.png 总数(-1:全部)

    总数指定每个通道从.tdms读取的最大元素数量。默认值为-1,所有元素。

  • ci64.png 偏移量(0)

    偏移量指定在.tdms文件中,函数对.tdms文件进行读取的起始数据元素数。默认值为0。

  • cgnrn.png tdms文件

    tdms 文件 指定了执行操作的 .tdms 文件的 参考号TDMS打开函数用于打开引用句柄。

  • cstr.png 组名称输入

    组名称输入指定要进行操作的通道组名。

    如不连线该输入端,将执行以下操作:

    • LabVIEW将从文件的当前组读取数据。首次运行该函数时,当前组为文件中的第一组;连续运行该函数多次时,当前组为第n个循环的第n组。
    • “TDMS读取”函数读取组的顺序与“TDMS列出内容”函数返回组的顺序一致。
    • LabVIEW到达最后一组后,如“TDMS读取”函数试图运行,LabVIEW将返回文件结束错误。
    注: TDMS List Contents( TDMS 列表内容)功能和 TDMS Get Properties(TDMS 获取属性 )功能会将当前组重置为文件中的第一个组。重置当前组为文件中的第一组且组名称输入未连线时,将影响下一个“TDMS读取”函数读取的组。
  • c1dstr.png 通道名称输入

    通道名输入表明要进行操作的通道。如该输入端未连线数据,LabVIEW可读取相同组中所有通道的数据。如连线波形至数据类型输入端,LabVIEW将使用波形名。通道名输入支持字符串或一维字符串数组输入。数据类型依据数据类型输入有所不同。

    字符串一维字符串数组

    模拟波形

    下列类型的一维数组:

    • 有符号或无符号整数
    • 浮点数
    • 时间标识
    • 布尔
    • 不包含空字符的由数字和字符组成的字符串

    数字波形

    数字表格

    一维模拟波形数组

    下列类型的二维数组:

    • 有符号或无符号整数
    • 浮点数
    • 时间标识
    • 布尔
    • 不包含空字符的由数字和字符组成的字符串

    如果加载包含 压缩数字数据的完整文件或组,LabVIEW 会自动在数组 中的通道名 中插入压缩 通道名 。如果加载包含 压缩数字数据的文件或组的子集,则必须将压缩通道的名称作为数组中 通道名称 的第一个条目输入。

  • cerrcodeclst.png 错误输入(无错误)

    错误输入表明该节点运行前发生的错误条件。该输入将提供标准错误输入功能。

  • c1dmsdt.png 数据类型

    数据类型是要数据包含的数据类型。

    该输入端接受以下数据类型:
    • 模拟波形或一维模拟波形数组
    • 数字波形
    • 数字表格
    • 动态数据
    • 一维或二维数组:
      • 有符号或无符号整数
      • 定点数,包括下列特定数据类型:
        • 单精度和双精度浮点数
        • 单精度和双精度浮点复数
        • (Windows)扩展精度浮点数
      • 时间标识
      • 布尔
      • 不包含空字符的由数字和字符组成的字符串
  • 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