Agilent Technologies 86100A, Programmer'S Manual, Page: 232 / 366

17-4
Mask Test Commands
COUNt:FAILures?
COUNt:FAILures?
Query :MTESt:COUNt:FAILures? {{POLYgon | REGion}{1:8}} [,{TOTal | MARGin | MASK}]
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 implement test-
ing 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. The integer, 1
through 8, designates the region for which you want to determine the failure count. The
TOTal ,
MARGin
, and
MASK
(default) arguments specifies which portion of the region to return fail-
ures (hits) for.
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 nega-
tive margins. If the query argument is ommited, the default argument used is
MASK
.
Restrictions
Software revision A.07.00 and above for
POLYgon
,
TOTal
,
MARGin
, and
MASK
arguments.
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?
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}
Returns the number of failed data points (or hits) that occurred when using margin 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