Logging Configuration Page

NI VeriStand 2018 Help

Edition Date: May 2018

Part Number: 372846M-01

»View Product Info
Download Help (Windows Only)

In the System Explorer window, expand a task section under the Waveform Tasks node and select Logging to display this page.

Use this page to configure how NI VeriStand performs data logging for the waveform acquisition task.

This page includes the following options:

  • Logging Settings—Includes the following components you can use to configure data logging options:
    • Allow TDMS logging—When TRUE, allows you to start and stop logging with the Logging Enabled channel. Note that this option does not toggle logging. To improve system performance, do not allow logging if you do not plan to log data from a task.

      When you allow logging, Logging Enabled and Start New File channels appear in the configuration tree.
    • Action on new acquisition—Contains the following options that determine how to log data when a new acquisition begins:
      • Create new group in current file—Log data in a new group in the file to which the system has been writing. If an acquisition has not yet occurred, NI VeriStand creates a new file.
      • Create new file—Creates a new TDMS file.
    • Logging group: Use task name—Specifies whether to use the task name as the group name that appears in the TDMS file. If you want to define a custom group name, remove the checkmark from this checkbox and enter the custom name in the textbox that appears.

      If the specified group already exists, NI VeriStand appends a number symbol and a number to the group name, incrementing that number until finding a group name that does not exist.
    • Group name—Specifies a custom group name to use in TDMS files if you remove the checkmark from the Use task name checkbox.
    • Logging mode—Contains the following options that determine whether to make data available to the NI VeriStand system as you log it:
      • Log and read—Logs data and allows waveforms in the system to read the data while logging occurs.
      • Log only—Logs data but prevents the system from reading the data as you log it. This option improves the performance of logging, but the data is not available to the rest of the system. For example, if you enable this option, a task cannot read waveform data from a waveform graph on the UI Manager or Workspace window as the graph plots it.
    • Span multiple files—Specifies whether to create a new file when you reach the Samples per file limit. When the file reaches the number of samples specified, a new file is created with the naming convention of <filename>_####.tdms, where #### starts at 0001 and increments automatically with each new file. For example, if the file specified is C:\data.tdms, the next filename used is C:\data_0001.tdms.
    • Samples per file—Specifies a limit to the number of samples per channel to log to the current file when Span multiple files contains a checkmark. This option is disabled if Span multiple files does not contain a checkmark because NI VeriStand logs to the current file without limiting the number of samples.
  • Log Filename—Includes the following components for controlling how NI VeriStand names log files:
    • Filename base: Use task name—Specifies whether to use the task name from the system definition as the base of log filenames. If you want to use a custom filename base, remove the checkmark from this checkbox and enter the name in the textbox that appears.
    • Custom filename—Specifies a custom string to use as the base of the log filename. This option is available only if Use task name does not contain a checkmark.
    • Log file directory—Specifies the location on disk where you want NI VeriStand to save log files.
    • Timestamp filename—Specifies whether to append a timestamp to the log filename.
    • Example log file path—Displays an example of how NI VeriStand will format log filenames given the current settings. Note that the Span multiple files option also affects filenames.

Related Links

Features for Logging Waveform Data to Disk

Waveform Task Channels

WAS THIS ARTICLE HELPFUL?

Not Helpful