Opens a .tdms file for reading or writing in the byte order of the host computer. You also can use this function to create a new file or replace an existing file. Unlike the TDMS Open function, the TDMS Advanced Open function does not create a .tdms_index file. If you use this function to open an existing .tdms file that has a corresponding .tdms_index file, this function removes the .tdms_index file.


icon

Inputs/Outputs

  • cpath.png file path —

    file path specifies the absolute path to the file you want to open. If you use this function to create a new file, the file extension of the filename you specify in file path must be .tdms. Otherwise, this function automatically appends .tdms to the filename you specify. If you use this function to open or update an existing file, you do not have to ensure that the file extension is .tdms.

  • cenum.png operation (0:open) —

    operation specifies the operation to perform.

    0open (default)—Opens a .tdms file to write to.
    1open or create—Creates a new .tdms file or opens an existing .tdms file to configure.
    2create or replace—Creates a new .tdms file or replaces an existing .tdms file.
    3create—Creates a new .tdms file.
    4open (read-only)—Opens a read-only version of the .tdms file.
  • cerrcodeclst.png error in (no error) —

    error in describes error conditions that occur before this node runs. This input provides standard error in functionality.

  • cbool.png disable buffering? (T) —

    disable buffering? (Windows) specifies whether LabVIEW opens, creates, or replaces a .tdms file without system buffering. The default is TRUE, which means this function disables system buffering. If the value is TRUE, the size of data to read or write must be a multiple of the sector size of the hard disk.

    Disabling system buffering can speed up data transfers in certain situations. If you have a small amount of data to transfer, you might not notice a difference if you disable buffering. To read or write a data file to a Redundant Array of Independent Disks (RAID), consider opening the file without buffering to speed up data transfers. To read the same set of data repeatedly from the computer, consider enabling buffering.

  • cbool.png enable asynchronous? (T) —

    enable asynchronous? (Windows) specifies whether to enable asynchronous reads or writes for the .tdms file. Set the value to TRUE if you want to use the TDMS Advanced Asynchronous I/O or TDMS Advanced Data Reference I/O functions. Set the value to FALSE if you want to use the TDMS Advanced Synchronous I/O functions. The default is TRUE.

  • ignrn.png tdms file out —

    tdms file out returns a TDMS file reference to the .tdms file on which you performed the operation.

  • iu32.png sector size —

    sector size returns the sector size of the hard disk. (macOS/Linux/RT targets) sector size is not supported and returns a value of zero.

    Note Traditionally, the sector size of hard disks is 512 bytes. In recent years, the sector size is 4096 bytes for large hard disks and RAID arrays.
  • ierrcodeclst.png error out —

    error out contains error information. This output provides standard error out functionality.

    • The byte order, or endian format, specifies whether LabVIEW represents numeric values in memory from most significant byte to least significant byte or vice versa.

    Note Use this function to open a .tdms file with a file format version of 2.0. To open a version 1.0 file, use the TDMS Open function.

    Examples

    Refer to the following example files included with LabVIEW.

    • labview\examples\File IO\TDMS\Advanced Read and Write\Asynchronous Read and Write\TDMS Advanced Asynchronous Write.vi
    • labview\examples\File IO\TDMS\Advanced Read and Write\Asynchronous Read and Write\TDMS Advanced Basic Asynchronous Read.vi