Filter
Top Products
17-4
Mask Test Commands
COUNt:FAILures?
COUNt:FAILures?
Query :MTESt:COUNt:FAILures? REGion<N>
The query returns the number of failures that occurred within a particular region. By defining
regions within regions, then counting the failures for each individual region, you can imple-
ment testing at different tolerance levels for a given waveform. The value 9.999E37 is
returned if mask testing is not enabled or if you specify a region number that is not used. <N>
is an integer, 1 through 8, designating the region for which you want to determine the failure
count.
Returned Format [:MTESt:COUNt:FAILures] <number_of_failures><NL>
<number_of_failures> is the number of failures that have occurred for the designated region.
Example 10 OUTPUT 707;”:SYSTEM:HEADER OFF”
20 OUTPUT 707;”:MTEST:COUNT:FAILURES? REGION3”
COUNt:FSAMples?
Query :MTESt:COUNt:FSAMples?
The query returns the total number of failed samples in the current mask test run. This count
is for all regions and all waveforms, so if you wish to determine failures by region number, use
the COUNt:FAILures? query. The count value returned is not the sum of the failure counts for
each region. For example, assume a region 2 enclosed completely by region 1. If region 1 has
100 failures, the value returned is 100, regardless of how many failures are in region 2.
Because region 2 is completely enclosed, the failure count for region 2 must be less than or
equal to 100 in this instance.
The value 9.999E37 is returned if mask testing is not enabled.
Returned Format [:MTESt:COUNt:FSAMples] <number_of_failed_samples><NL>
<number_of_failed _samples> is the total number of failed samples for the current test run.
Example 10 OUTPUT 707;”:SYSTEM:HEADER OFF”
20 OUTPUT 707;”:MTEST:COUNT:FSAMPLES?”
COUNt:HITS?
Query :MTESt:COUNt:HITS? {TOTal | MARGin | MASK}
This query returns the number of failed data points (or hits) that occurred when using mar-
gin mask testing. TOTal returns the total number of failed data points. For positive margins,
this is the sum of the MASK and MARGin counts. For negative margins, this is the same as the
MASK count. MARGin returns the number of data points that occurred between the margin
mask and the standard mask. This is the margin area. This definition is true for both positive
and negative margins. To determine a negative margin, increase the magnitude of the nega-
tive margin until the number of margin hits goes to zero. All data acquired since mask margin
testing was enabled will be compared to the margin. Sampled points acquired before the mar-
gin was activated, that fall into the margin region, will also show up as mask hits. MASK
Returns the number of data points that failed the standard mask.
Returned Format [:MTESt:COUNt:HITS] <number_of_hits><NL>