# :DISK:WAVeform:SAVE:FTYPe

:DISK Waveform Commands

- :DISK:WAVeform:FNAMe
- :DISK:WAVeform:FNAMe:AUPDate
- :DISK:WAVeform:FNAMe:USTandard
- :DISK:WAVeform:HEADer
- :DISK:WAVeform:LINTerpolate
- :DISK:WAVeform:REGion
- :DISK:WAVeform:SAVE
- :DISK:WAVeform:SAVE:FTYPe
- :DISK:WAVeform:SAVE:SOURce
- :DISK:WAVeform:SCOMpressed

## Command Syntax

    :DISK:WAVeform:SAVE:FTYPe {WYValues | WXYValues | HDF5 | BIN | MAT}

## Query Syntax

    :DISK:WAVeform:SAVE:FTYPe?

## Query Response

     {WYV | WXYV | HDF5 | BIN | MAT}

## Description

Selects the file format for saving a waveform to a file. The actual file can be saved using the `:DISK:WAVeform:SAVE` parent command or as a result of a acquisition limit test or an eye mask limit test. The appropriate file name extension is appended to the file name that is specified using the `:DISK:WAVeform:FNAMe` command.

The following tables show the available waveform types for the different instrument modes.

Before you can select the proper waveform using the `:DISK:WAVeform:SAVE:FTYPe` command, the correct type of waveform must be displayed on Infiniium.

Available Waveform File Types
Waveform Type | Command Parameter | File Name Extension
--- | --- | ---
Waveform (Y-value) | `WYValues` | .txt
Waveform (XY-value) | `WXYValues` | .txt
HDF5 | `HDF5` | .h5
BIN | `BIN` | .bin
MAT | `MAT` | .mat

## Command Parameters

`WYValues`
  Y-value waveform files are ASCII files (.txt) comprised of a header followed by amplitude values for each data point. The ASCII amplitude values are in volts or Watts and are separated by a carriage return and line feed. This format is convenient for transferring data to other software applications, as you can import this file into many spreadsheet or word processing programs. Although the file does not include time values for each data point, proper X-axis scaling is achieved by `XOrg` (X-axis origin) and `XInc` (X-axis time increment) values contained in the preamble. Because individual time values are not included, this format creates smaller files than the XY-Values format. Y-value format is designed for waveforms in which the data points are separated by equal time increments. Do not use Y-value format for pattern waveforms, whenever a precision timebase is used, or the waveform is the output of the versus operator in a function. Use the XY-value format instead. To add linear interpolation to make equally spaced Y-values, use the `:DISK:WAVeform:LINTerpolate` command.
`WXYValues`
  XY-value waveform files are ASCII files (.txt) comprised of a header followed by voltage and time values for each data point. The ASCII amplitude values are in volts or Watts while the X-axis values are in time. Each value is separated by a carriage return and line feed. Like the Y-value format, this format can be imported into many spreadsheet or word processing programs. XY-value format is designed for waveforms that have been sampled using unequal time separations between adjacent data points. Unequal time separations occur for pattern waveforms, whenever a precision timebase is used, or the waveform is the output of the versus operator in a function. To add linear interpolation to make equally spaced Y-values, use the `:DISK:WAVeform:LINTerpolate` command.
`HDFS`
  Hierarchical Data Format version 5, commonly abbreviated HDF5, is a file format designed to store and organize large amount of numerical data. The HDF format and associated libraries are supported by the non-profit HDF Group who continue to develop and promote HDF5 technologies. The freely available HDF distribution includes the library, command-line utilities, test suite source, and APIs for several popular programming languages including C, C++, Java, Perl, Fortran, and F90. More information about the format specification as well as distribution and tutorial can be found at the HDF Group's website: www.hdfgroup.org.
  Waveform data stored in the .h5 format consists of a set of waveform attributes much like the header information used in the .bin and .csv formats, followed by the Y values of the waveform. The waveform can be reconstructed using the X and Y scaling values stored in the waveform attributes section.
`BIN`
  The Binary Data is a binary format that contains a header and data in the form of time and voltage pairs. The file header describes the waveform's horizontal (X) and vertical (Y) characteristics and contains other oscilloscope information.
  Because the data is in binary format, the size of the file is approximately 5 times smaller than the XY Values formats.
  If more than one source is on, you can save all displayed sources to a file. The only exception is functions that are using FFTs or versus operators.
  When the oscilloscope is in the Peak Detect acquisition mode, the minimum and maximum value waveform data points are saved to the file. The minimum value data points are saved first, followed by a blank line, and then the maximum value data points are saved.
`MAT`
  This is a MATLAB (.mat) format file saved in version 7.3 format, readable in MATLAB 2006b and newer.
  When you save waveform(s) to a .mat file, each waveform is saved to a separate MATLAB workspace variable. These variables are named according to the memory or channel they are saved from with any spaces replaced by underscores (for example: Memory_1).
  Waveform data variables have a structured format that contains information about the data (metadata or header information) and then the waveform data itself. Waveform data is encoded as single-precision floating-point values.
  In addition to the waveform data variable(s), one Frame variable per file is also saved. The Frame variable contains general information about the oscilloscope.