# :DISPlay:PERSistence:WAVeform

:DISPlay Persistence Commands

- :DISPlay:PERSistence:EYE
- :DISPlay:PERSistence:WAVeform
- :DISPlay:PERSistence:WAVeform:TIME

## Command Syntax

    :DISPlay:PERSistence:WAVeform {MINimum | INFinite | CGRade | GSCale | VARiable}

## Query Syntax

    :DISPlay:PERSistence:WAVeform?

## Description

Sets the type of waveform persistence (sample accumulation).

Persistence determines how long a data point is kept on the display before being erased from the display graticule. Persistence is a display memory function, therefore acquired waveforms are written only to display memory. Acquisition memory is where the current waveform data is stored. Therefore, only the last acquired waveform is held in acquisition memory. Display memory is what is seen on the display graticule.

The persistence control lets you view the extremes of a waveform's variation, such as the occurrence of jitter. Setting the persistence to the minimum amount of time allows for easiest viewing of variations in the acquired waveforms. Setting the persistence to the maximum amount of time (infinite) allows for a complete view of everything measured in the waveform.

- `MINimum` — sets the display time of each waveform data point to the minimum of 40 ms or one trigger cycle. You can use the minimum persistence mode to view the fastest display update rate. When the waveform acquisition is stopped, the last acquired data points are left on the display.

- `INFinite` — displays the sampled data points for an endless period of time. As sample points are acquired, the luminosity of the sample points changes in intensity. Newly acquired sample points are shown at full intensity while previously acquired points are displayed at half intensity. You can use this mode to measure the worst-case characterization of signal noise, jitter, signal drift, timing, and find infrequent events. In infinite persistence mode, all sampled data points are left on the display until one of the following is adjusted or executed: Clear Display, Auto Scale, Default Setup, operating mode changed, mask testing, vertical or horizontal settings, trigger settings, display source state (on or off), or acquisition settings.

- `CGRade` — color grade infinite persistence. In `CGRade` mode, density ranges are represented by separate colors.

  To change the colors used to show color grade persistence, use the `:DISPlay:CGSPectrum` command.

- `GSCale` — gray scale infinite persistence. In `GSCale` mode, density ranges are represented by shades of the same color (one hue with variations in saturation and luminosity).

  To change the colors used to show gray scale persistence, use the `:DISPlay:GSSPectrum` command.

- `VARiable` — lets you define the persistence time of the input waveform (see `:DISPlay:PERSistence:WAVeform:TIME`). Newly acquired sample points are displayed at full intensity (brightest) while the intensity of previously acquired sample points fade to black during the defined persistence time. You can use this mode to view infrequent events and rapidly changing waveforms. You can set the time a waveform sample point is displayed from 100 ms to 40s, with one digit resolution. The default setting is 300 ms. If one of the following is changed, the displayed waveform is redrawn and any accumulated waveforms are cleared: the vertical or horizontal scaling, the vertical or horizontal position, the offset, the trigger source or level, a clear display is executed, or an Auto Scale is executed.

  Persistence versus Resolution
  Persistence Time in Seconds | Resolution (Step Size)
  --- | ---
  0.1 - 0.9 | 0.1s steps
  1 - 10 | 1s steps
  10 - 40 | 10s steps

With the `CGRade` and `GSCale` options, overlaid waveform data is saved in a database that records "pixel" hits where waveforms cross small boxes of vertical range and time range. Overlaid waveform databases are displayed so that pixels with a higher numbers of hits use more "intense" colors.

With the `CGRade` and `GSCale` options, each time a specific display sample point is acquired (time and amplitude coordinate), a counter for that coordinate is incremented. The maximum count for each counter is 232. To display the data, coordinate counts are divided into density ranges.

Both the `CGRade` and `GSCale` options display sampled data points for an endless period of time. The peak density of data counts is represented by the brightest regions of the waveform. If these persistence modes are left on for a long time, the waveform becomes saturated with the color of highest hits.

## Child Commands

- `:DISPlay:PERSistence:WAVeform:TIME`