:MEASure:LLINe:FPOints?
Query Syntax
:MEASure:LLINeN:FPOints?
Where N identifies one of 64 {1:64} possible limit line tests. For example, :LLINe23.
Description
Queries the total number of failed data points for a specific Limit Line Test. This is the sum of all failed data points in all defined limit lines in the Limit Line Test. To query the number of failed data points in a specific limit line, use the :MEASure:LLINe:LINE:FPOints? query. To load and display a Limit Line Test, use the :LLINe:DISPlay command.
In the following picture, if both limit lines are defined in Limit Line Test 1, the :MEASure:LLINe1:FPOints? query would return the value 9. However, consider the situation where limit line 1 is defined in Limit Line Test 1 and limit line 2 is defined in Limit Line Test 2. In this case, the :MEASure:LLINe1:FPOints? query would return the value 3 and the :MEASure:LLINe2:FPOints? query would return the value 6.
To return the pass/fail margin for a Limit Line Test, use the :MEASuer:LLINe:MARGin? query. To return the time value for the data point where the pass/fail margin occurs, use the :MEASuer:LLINe:MLOCation? query.
Only displayed data points are analyzed. For example, if you zoom in on the waveform so that a portion of the Limit Line Test is off screen, any failed data point that exists off screen will not be counted.
Measurement Ready?
To confirm that the measurement is ready to read, you can query the measurement's status:
if ('CORR' in Flex.query(':STATus?')):
measurement = Flex.query('?')
If averaging is turned on (:ACQuire:AVERaging), you can also confirm if the measurement result is ready by comparing the number of specified averages (:ACQuire:ECOunt?) versus the number of measurement sweeps that have occurred (:COUNt?). The technique uses the :COUNt? common measurement query. For example,
if (Flex.query(':COUNt?') >= Flex.query(':ACQuire:ECOUNt?')):
measurement = Flex.query('?')
You can also use an acquisition limit lest to test that a number of waveform samples, or pattern acquisitions have completed before returning a measurement. Refer to the :LTESt:ACQuire:CTYPe command.
Common Measurement Child Queries
This command supports the use of the following common measurement queries: :LOCation?, :COUNt?, :MAXimum?, :MINimum?, :MEAN?, and :SDEViation?.