Owning Palette: Output Express VIs
Requires: Base Development System
Writes data to text-based measurement files (.lvm), binary measurement files (.tdm or .tdms), or Microsoft Excel files (.xlsx).
Use the Read From Measurement File Express VI to read data from the generated measurement file.
Dialog Box Options |
Block Diagram Inputs |
Block Diagram Outputs |
Add to the block diagram | Find on the palette |
Parameter | Description | ||||
---|---|---|---|---|---|
Filename | Displays the full path to the file to which you want to write data. The Express VI writes data to the file that this parameter specifies only if the Filename input is unwired. If you wire the Filename input, the VI writes data to the file that this input specifies instead. | ||||
File Format | Contains the following options:
| ||||
Action | Contains the following options:
| ||||
If a file already exists | This section is available only when you select the Save to one file option from the Action section. Contains the following options:
| ||||
Segment Headers | This section is unavailable when you select the Microsoft Excel (.xlsx) option from the File Format section. Contains the following options:
| ||||
X Value Columns | Contains the following options:
| ||||
Delimiter | Contains the following options:
| ||||
File Description | Contains the description of the measurement file. LabVIEW appends the text you enter in this text box to the header of the file. This text box is unavailable when you select the Microsoft Excel (.xlsx) option from the File Format section.
|
Parameter | Description | ||
---|---|---|---|
Reset | Specifies whether you want to reset the data file when you run this Express VI iteratively. LabVIEW ignores this input when you run this Express VI in the first iteration. During the second and subsequent iterations, if the value is FALSE, this Express VI appends data to a file if the file already exists. Depending on your configuration for this Express VI, if the value is TRUE, this Express VI renames, overwrites, or skips a file if the file already exists. The default is FALSE. | ||
Enable | Enables or disables the Express VI. The default is ON or TRUE. | ||
new_file | If TRUE, stops writing to the current file, creates the next file in the series, and writes to that file instead. This input is available only when you select the Save to series of files (multiple files) option. | ||
error in | Describes error conditions that occur before this node runs. | ||
DAQmx Task | Specifies the DAQmx task to use to populate data on the DAQmx Properties page of the Configure User Defined Properties dialog box. | ||
Comment | Appends a comment to each data set written to the measurement file. This input is unavailable when you select the Microsoft Excel (.xlsx) option from the File Format section. | ||
Filename | Specifies the name of the file to which you want to write data. If Filename is not wired, the VI uses the Filename specified in the configuration dialog box. | ||
Signals | Contains the input signal or signals. If you wire two or more signals with the same name to the Signals input, LabVIEW appends an integer to the end of the names written in the file, which enforces unique channel names. For example, if you wire two signals named Sine to the Signals input, LabVIEW writes the names as Sine and Sine 1.
| ||
Flush? | Specifies whether LabVIEW writes data to the Microsoft Excel file each time after this Express VI runs. If the value is FALSE, LabVIEW does not write the data to the Microsoft Excel file. Instead, LabVIEW stores the data in a temporary file. If the value is TRUE, LabVIEW writes the data from the temporary file to the Excel file and then purges the temporary file. The default is TRUE.
|
Parameter | Description |
---|---|
Filename Out | Returns the name of the file. |
Saving Data | Indicates if the Express VI is saving the data. |
error out | Contains error information. This output provides standard error out functionality. |
Note The behavior of this VI changes depending upon the target. If the current target does not or might not have a host computer connected, the configuration dialog box displays warnings next to options that are invalid without a host. If you configure this VI to prompt for input and run the VI on a target with no user interface, such as the Real-Time Module with no host computer connected, this VI returns an error. |
You can also use the Storage/DataPlugin VIs to read from and write to .tdm files, or you can use the TDM Streaming functions to read from and write to .tdms files.
This Express VI operates similarly to the following VIs and functions:
Open/Create/Replace File
Write to Text File
Write to Binary File
Write To Spreadsheet File
File Dialog
Format Into File
Refer to the following VIs for examples of using the Write To Measurement File Express VI: