User Manual

:MEASure Commands 20
Keysight InfiniiVision 1000 X-Series Oscilloscopes Programmer's Guide 365
:MEASure:PREShoot
(see page 782)
Command Syntax
:MEASure:PREShoot [<source>]
<source> ::= {CHANnel<n> | FUNCtion | MATH | WMEMory<r>}
<n> ::= 1 to (# analog channels) in NR1 format
<r> ::= 1-2 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 345
• ":MEASure:SOURce" on page 371
• ":MEASure:VMIN" on page 381
• ":MEASure:VMAX" on page 380
• ":MEASure:VTOP" on page 385
• ":MEASure:VBASe" on page 379