:MEASure:MTESt:HRatio?

Meas. mode:
Eye
Flex Apps:
FlexDCA
FlexRT
Mask Test Hits Commands

Query Syntax

:MEASure:MTESt{N}:HRatio?

{N} identifies a specific mask and must be a value from 1 to 16. For example, :MTESt2: selects mask 2.

Description

Returns the Hit Ratio that is displayed in the Mask Test results table whenever automatic mask margins are based on a target hit ratio. Use the :MTESt:MARGin:AUTO:HRATio to actually enter the ratio.

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?.