Trend/Statistics Dialog

Trend/Statistics allows you to plot trend lines and statistical data from a variety of Data Sources within any measurement type. You can also configure trend/statistics plots within the Event-Based Actions utility.

Enable - Enables or disables the use of Trend/Statistics and Event-Based Actions.

Data Sources - Add one or more data source for trend/statistics. See Event-Based Actions for more information.

Metadata: allows you to trend the value of a data header key.  You can select an existing trace or you can choose a DataName (without needing to show it in a trace). 

This Data Source is helpful if you want to trend any of the Graph trace results (such as Delay or DeltaEVM), which are accessible through data header keys in the Graph trace.

Name - Enter a unique name for the data source.

Trace - Selects the trace that contains the header key to be used as the data source. When the Trace checkbox is selected, the Data Name parameter is grayed out and the Data name is derived from trace's currently selected trace type.

Data Name - Selects a data name (trace type) without having to display the data in a trace. Each data name contains a set of data headers.

Data Header Key - Specifies a data header key, which is an attribute of the selected Data Name. The data header value is used as the data source.

Display Units - Selects the display units.

Trace Marker: allows you to select a marker on a trace to be a data source.  Note that you cannot use markers from traces whose data is comes from a Trace Marker data source (e.g., you can’t trend a marker on a trace that is the trend line for another marker).

Name - Enter a unique name for the data source.

Trace - Select the trace that contains the marker to be used for the data source.

Marker - Specifies a marker on the selected trace.

Result Type - Specifies what result from the marker should be used as the value of the Data Source. Possible result types are: Y Position, Y Delta, Y Average (over Z-axis), X Position (Axis), X Position (Data), X Delta (Data), Z Position, Band Power).

Table Value: a value from a summary table is used as the data source.

Name - Enter a unique name for the data source.

Data Name - Selects the data name for the data source. Currently, only summary table traces (e.g., Frame Summary, Syms/Errs, etc.) can be used as valid Summary Value Data Sources. The available summary tables depend on the current measurement type.

Summary Name - Selects a summary name (data result) within the selected Data Name (summary table).

Trend Line Settings

The Trend Line Settings are common for all Data Sources defined in the Trend/Statistics and Event-Based Actions dialog.

Remove Mean - When enabled (checked), all Trend and Histogram trace results will be reported after first removing the accumulated Trend and Histogram statistical data set for the mean value computation. Remove Mean is computed based on the samples in the trend line (ignoring the time between points).

Remove Slope - When enabled (checked), all Trend and Histogram trace results will be reported after first removing the accumulated Trend and Histogram statistical data set for the first order linear slope best-fit computation. Remove Slope is computed based on the samples in the trend line (ignoring the time between points).

Remove Second Order - When enabled (checked), all Trend and Histogram trace results will be reported after first removing the accumulated Trend and Histogram statistical data set for the second order curve best-fit computation. Remove Second Order is computed based on the samples in the trend line (ignoring the time between points).

X-Axis Unit -Specifies either Seconds or Samples as the x-axis unit. Select Samples when the sequence is more important than the absolute time between points.

When the X-Axis Unit is set to Seconds, the Mean/Slope/Second order are still computed as if the x-axis is Samples.

Display Length - Specifies the number of points displayed within Trend trace results. If the available data exceeds Display Length points, the most recent “Display Length” amount of points are displayed, resulting in a scrolling trend display. If available data is less than display length, the available data is shown at the left of the trace and the remaining point's values are set to the first data point’s value.

Buffer Length - Specifies the maximum number of points used for Trend/Histogram/Cumulative Results data gathering and analysis. If the available data exceeds the Internal Buffer Length points, the most recent “Internal Buffer Length” points are retained and used for Trend/Histogram/Cumulative Results data gathering and analysis.

X-Y Graph - Click this button to create an X-Y plot of trended values. You will be prompted to choose whether to create a new trace or use the currently active trace.

Create New Trace - Creates a new trace, makes it the active trace, sets the trace’s data to Graph > Data Plot, and opens the X-Y Graph dialog (also available under Trace > Graph Settings...).

In the X-Y Graph dialog, select which trend line to place on the X and Y axes. The available X Data and Y Data choices come from the configured Data Sources.

Use Active Trace - Uses the currently active trace, sets the trace’s data to Graph > Data Plot, and opens the X-Y Graph dialog (also available under Trace > Graph Settings...).

In the X-Y Graph dialog, select which trend line to place on the X and Y axes. The available X Data and Y Data choices come from the configured Data Sources.

 

See Also

Event-Based Actions

Trend Line Traces

Histogram Traces

Utilities Menu