Agilent Technologies InfiniiVision 3000 X-Series, Programmer'S Manual

Page: 401 / 1232

:MEASure Commands
19
Agilent InfiniiVision 3000 X-Series Oscilloscopes Programmer's Guide 401
:MEASure:DUTYcycle
(see page 1088 )
Command Syntax
:MEASure:DUTYcycle [<source>]
<source> ::= {<digital channels> | CHANnel<n> | FUNCtion | MATH
| WMEMory<r>}
<digital channels> ::= DIGital<d> for the MSO models
<n> ::= 1 to (# of analog channels) in NR1 format
<r> ::= 1-2 in NR1 format
<d> ::= 0 to (# digital channels - 1) in NR1 format
The :MEASure:DUTYcycle command installs a screen measurement and
starts a duty cycle measurement on the current :MEASure:SOURce. If the
optional source parameter is specified, the current source is modified.
Query Syntax
:MEASure:DUTYcycle? [<source>]
The :MEASure:DUTYcycle? query measures and outputs the duty cycle of
the signal specified by the :MEASure:SOURce command. The value
returned for the duty cycle is the ratio of the positive pulse width to the
period. The positive pulse width and the period of the specified signal are
measured, then the duty cycle is calculated with the following formula:
duty cycle = (+pulse width/period)*100
Return Format
<value><NL>
<value> ::= ratio of positive pulse width to period in NR3 format
See Also
• "Introduction to :MEASure Commands" on page 388
• ":MEASure:PERiod" on page 410
• ":MEASure:PWIDth" on page 414
• ":MEASure:SOURce" on page 421
Example Code • "Example Code" on page 422
N O T E
The signal must be displayed to make the measurement. This command is not available if
the source is FFT (Fast Fourier Transform).