Keysight P9241, Scpi Programmer'S Manual

Page: 463 / 1344

:MEASure Commands
21
Keysight P9241/42/43A Oscilloscopes SCPI Programmer's Guide 463
:MEASure:PREShoot
(see page 1196 )
Command Syntax
:MEASure:PREShoot [<source>]
<source> ::= {CHANnel<n> | FUNCtion<m> | MATH<m> | WMEMory<r>}
<n> ::= 1 to (# analog channels) in NR1 format
<r> ::= 1 to (# ref waveforms) in NR1 format
The :MEASure:PREShoot command installs a screen measurement and starts a
preshoot measurement. If the optional source parameter is specified, the current
source is modified.
Query Syntax
:MEASure:PREShoot? [<source>]
The :MEASure:PREShoot? query measures and returns the preshoot of the edge
closest to the trigger, displayed on the screen. The method used to determine
preshoot is to make three different vertical value measurements: Vtop, Vbase, and
either Vmin or Vmax, depending on whether the edge is rising or falling.
For a rising edge:
preshoot = ((Vmin-Vbase) / (Vtop-Vbase)) x 100
For a falling edge:
preshoot = ((Vmax-Vtop) / (Vtop-Vbase)) x 100
Vtop and Vbase are taken from the normal histogram of all waveform vertical
values. The extremum of Vmax or Vmin is taken from the waveform interval right
before the chosen edge, halfway back to the previous edge. This more restricted
definition is used instead of the normal one, because it is likely that a signal may
have more overshoot than preshoot, and the normal extremum would then be
dominated by the overshoot of the preceding edge.
Return Format
<value><NL>
<value> ::= the percent of preshoot of the selected waveform
in NR3 format
See Also • "Introduction to :MEASure Commands" on page 432
• ":MEASure:SOURce" on page 472
• ":MEASure:VMIN" on page 489
• ":MEASure:VMAX" on page 488
• ":MEASure:VTOP" on page 493
• ":MEASure:VBASe" on page 487