478 Keysight InfiniiVision 3000T X-Series Oscilloscopes Programmer's Guide
22 :MEASure Commands
:MEASure:DUTYcycle
(see page 1276)
Command Syntax
:MEASure:DUTYcycle [<source>]
<source> ::= {<digital channels> | CHANnel<n> | FUNCtion<m> | MATH<m>
| WMEMory<r>}
<digital channels> ::= DIGital<d> for the MSO models
<d> ::= 0 to (# digital channels - 1) in NR1 format
<n> ::= 1 to (# of analog channels) in NR1 format
<m> ::= 1 to (# math functions) in NR1 format
<r> ::= 1 to (# ref waveforms) in NR1 format
The :MEASure:DUTYcycle command installs a screen measurement and starts a
positive 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 positive 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 458
• ":MEASure:PERiod" on page 488
• ":MEASure:PWIDth" on page 492
• ":MEASure:SOURce" on page 499
• ":MEASure:NDUTy" on page 481
Example Code • "Example Code" on page 500
The signal must be displayed to make the measurement. This command is not available if the
source is FFT (Fast Fourier Transform).