
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
Содержание 86100A
Страница 18: ...1 14 Introduction Status Reporting Figure 1 4 Status Reporting Data Structures...
Страница 19: ...1 15 Introduction Status Reporting Status Reporting Data Structures continued...
Страница 94: ...2 40 Sample Programs BASIC Programming Examples...
Страница 124: ...4 16 Root Level Commands VIEW...
Страница 125: ...5 DATE 5 2 DSP 5 2 ERRor 5 3 HEADer 5 4 LONGform 5 5 MODE 5 6 SETup 5 7 TIME 5 7 System Commands...
Страница 132: ...5 8 System Commands TIME...
Страница 140: ...6 8 Acquire Commands SWAVeform RESet...
Страница 152: ...7 12 Calibration Commands STATus...
Страница 192: ...11 12 Display Commands SSAVer...
Страница 202: ...12 10 Function Commands VERTical RANGe...
Страница 203: ...13 AREA 13 2 DPRinter 13 2 FACTors 13 3 IMAGe 13 3 PRINters 13 4 Hardcopy Commands...
Страница 316: ...21 12 TDR TDT Commands Rev A 05 00 and Below STIMulus...
Страница 332: ......
Страница 353: ...26 DISPlay 26 2 LOAD 26 2 SAVE 26 3 XOFFset 26 3 XRANge 26 3 YOFFset 26 3 YRANge 26 4 Waveform Memory Commands...