Teledyne LeCroy WaveExpert series Automation Manual - Manual (Page 38)

A BOUT R ESULTS
INTRODUCTION
This section presents details on the rich ‘Result’ interfaces of the X-Stream DSO. These interfaces contain more
than just the basic results, such as waveform data and measurement values; it includes information about
horizontal and vertical resolution, event times, number of sweeps, histogram peaks, etc.
The properties that are available for readout depend on the type of result. The 7 different Results Interfaces are:
• Digital
• Histogram
• Param
• Persist
• Table
• Waveform
• XY
The following section describes each interface, followed be a detailed explanation of each property.
Interface Descriptions
Digital
The Digital interface is found when using one of the mixed-signal oscilloscope options to generate digital
(bi-state) waveforms. These waveforms are contained in the Digitalx trace name, where x = 1, 2, 3 etc.
Each Digitalx trace is a bus that may contain multiple digital lines, with a maximum number dependent on
the capabilities of the mixed-signal oscilloscope option. The key property in the Digital interface is the
DataArray
, which is a 2D array containing the value of each sample of each digital line in the bus.
Example paths to Digital Result interfaces:
app.LogicAnalyzer.Digital1.Out.Result
app.LogicAnalyzer.Digital2.Out.Result
Histogram
The Histogram interface is used for all histogram traces. Histograms can be configured on most
oscilloscopes as a math function (Fx). Histograms are also used in various analysis modes, especially on
Serial Data Analyzers, where the HTIE trace is the source data for the algorithm to calculate Total jitter
(Tj). The key property is BinPopulations, which is a 1D array of the bin populations. Example paths to
HTIE Result interfaces:
app.Math.F1.Out.Result (assuming that F1 is setup as a Histogram)
app.SDA.Htie.Out.Result
Param
The Parameter interface is used in the Measurement and Pass/Fail systems to hold both individual
results and result arrays. The key properties for the Parameter interface are Value and ValueArray.
Value holds the last measurement or P/F result, while ValueArray holds all measurements taken for the
last acquisition. Example paths to Param Result interfaces:
app.Measure.P1.Out.Result
app.Measure.P1.Sdev.Result
app.Measure.Measure("P1").Out.Result
2-2 916435 RevA