# Waveform Content Windows

SCPI Introduction

- Quick Start
- LAN and USB Connections
- Starting a Program
- Common Child Commands
- SCPI Basics
- File Path Substitution Strings
- Definite-Length Block Response Data
- Indefinite-Length Block Response Data
- Waveform Content Windows
- SCPI Security in Infiniium
- Concepts

Waveforms are displayed in one of eight different types of content windows depending on the type of waveform. The following table lists these windows along with the waveform types that they can contain.

All content windows can show multiple waveforms of the same type. However, in the Waveform content window, multiple waveforms can each have different Y-axis scaling. In all other content windows, multiple waveforms displayed within the same window have the same scaling.

Possible Content Window Names
Argument | Selected Content Window
--- | ---
TIME{1:4} | Waveform 1 through 4.
DBH{1:4} | Decibels (Hz) 1 through 4. Show the output of an FFT function with a display set to dBV or dBm.
DHER{1:4} | Degrees (Hz) 1 through 4. Show the output of an FFT function with a display set to Phase.
SHER{1:4} | Seconds (Hz) 1 through 4. Show the output of an FFT function with a display set to Group Delay.
IRES{1:4} | Impulse Response 1 through 4. Added by the S-Parameter/Transfer Function Viewer.
SRES{1:4} | Step Response 1 through 4. Added by the S-Parameter/Transfer Function Viewer.
PROT{1:4} | Protocol 1 through 4. Added by setting up protocol decodes.
RES | Results window for measurement results.
DOUT | Reserved for future use.
MTES{1:4} | Mask Test 1 through 4 for added mask test results.
MARK | Markers window for markers results.
HRES{1:4} | W-Hist Stats 1 through 4 for waveform histogram statistics.
MHIS{1:4} | Meas Hist N 1 through 4 for the measurement histogram statistics and plot.
JITT{1:4} | Jitter 1 through 4 for jitter measurement results and plots.
NOIS{1:4} | Noise 1 through 4 for noise measurement results and plots.
FPR{1:64} | FFT Peaks 1 through 64 for FFT peak detection results.
PNO | Phase Noise analysis results.
PNMW | Phase Noise Markers results.
LLTRs | Limit Lines test results.
ECR | Eye Contours results.

## Assigning Waveforms to Content Windows

When created, waveforms are automatically displayed in content window number 1 for the correct type. As shown in the above table, multiple content windows (up to four total) are available for some types. To move a waveform to an additional content window use the SCPI commands shown in the table. If the additional content window does not exist, it will be automatically created.

Although there are no direct front-panel controls to create additional Waveform, Decibels (Hz), Degrees (Hz), and Seconds (Hz) content window, you can assign existing waveforms to new windows by using the front panel Interactive SCPI Command Tree.

## Axis Scaling

The :TIMebase Subsystem, :GRAPh Subsystem, and :NETWorks Subsystem are used to create and scale content windows and their waveforms as shown in the following table. All time-domain content windows share the same X-axis time scales, which are configured in the :TIMebase subsystem. This includes the Waveform, Time-Ohms, Time-Volts, and Time-% content windows. The Y-axis for time-domain content windows and both axis in frequency domain content windows, are all scaled using commands in the :GRAPh subsystem.

Traces contain the waveform data that is displayed in graphs. In the `:NETWorks:TRACe` subsystem, the x-axis and y-axis values can only be queried, because they are set by the x-axis and y-axis values of their assigned graph.

Use the `:NETWorks:TRACe` subsystem to perform the following tasks:

- Create a trace.
- Assign an S-parameter to the trace.
- Change a trace's color.
- Define the trace amplitude levels for measurements.

Use the `:GRAPh` subsystem to perform the following tasks:

- Scale both axis of frequency-domain graphs.
- Scale the Y-axis only of time-domain graphs.

Commands and Queries for Axis Scaling
Graph Axis | :TIMebase Subsystem | :GRAPh Subsystem | :NETWorks:TRACe Subsystem
--- | --- | --- | ---
NOTES: | Bold Text: Commands that set axis values. Normal Text: Queries that read axis values. Example time values are provided as aid in understanding commands.
Frequency Domain Content Windows (for S-parameters and FFT operator)
X-Axis | — | :X:AUToscale | —
— | :X:STARt (Hz) | :XLEFt?
— | :X:SPAN (Hz) | —
— | — | :XSCale?
— | :X:STOP (Hz) | :XRIGht?
— | :X:CENTer (Hz) | :XPOSition? (always at center of axis)
Y-Axis | — | :Y:AUToscale | —
— | :Y:OFFSet | :YOFFset?
— | :Y:SCALe | :YSCale?
— | — | :YTOP?
— | — | :YBOTtom?
Time Domain Content Windows (for time-domain parameters)
X-Axis | :POSition (100 ps) (with timebase reference set to left) | :X:STARt (100 ps) | :XLEFt? (100 ps)
:XRANge (2000 ps) | :X:SPAN (2000 ps) | —
:SCALe (200 ps/div) | — | :XSCale? (200 ps/div)
— | :X:STOP (2100 ps) | :XRIGht? (2100 ps)
— | :X:CENTer (1100 ps) | :XPOSition? (1100 ps) (always at center of axis)
Y-Axis | — | :Y:AUToscale | —
— | :Y:OFFSet | :YOFFset?
— | :Y:SCALe | :YSCale?
— | — | :YTOP?
— | — | :YBOTtom?
Waveform Content Window (Channels, Memories, Functions, …)
X-Axis | :POSition (100 ps) (with timebase reference set to left) | — | —
:XRANge (2000 ps) | — | —
:SCALe (200 ps/div) | — | —
Y-Axis | Y-axis values set in :CHANnel, :DIFF, :WMEMory, and etc subsystems.

## Example of Using Content Windows

This example creates four FFT functions and assigns the output of functions 1 and 2 to Seconds (Hz) content window 1 and functions 3 and 4 to Seconds (Hz) window 2.

      // Configure first FFT function.
    :FUNCtion1:FOPerator FFT  // Create an FFT function.
    :FUNCtion1:OPERand1 CHAN1_1  // Assign input waveform.
    :FUNCtion1:PARameters:FFT:DISPlay SHERtz  // Select output waveform type.
    :FUNCtion1:CWINdow GDELay1  // Assign output waveform to content window.
      // Configure second FFT function.
    :FUNCtion2:FOPerator FFT
    :FUNCtion2:OPERand1 CHAN1_2
    :FUNCtion2:PARameters:FFT:DISPlay SHERtz
    :FUNCtion2:CWINdow GDELay1
      // Configure third FFT function.
    :FUNCtion3:FOPerator FFT
    :FUNCtion3:OPERand1 CHAN2_1
    :FUNCtion3:PARameters:FFT:DISPlay SHERtz
    :FUNCtion3:CWINdow GDELay2
      // Configure fourth FFT function.
    :FUNCtion4:FOPerator FFT
    :FUNCtion4:OPERand1 CHAN2_2
    :FUNCtion4:PARameters:FFT:DISPlay SHERtz
    :FUNCtion4:CWINdow GDELay2
    // Configure content windows to be tab tiled.
    :DISPlay:WINDow:SHERtz1:DMODe TTILed
    :DISPlay:WINDow:SHERtz2:DMODe TTILed
    // Select the waveform to be displayed in the tab-tiled Seconds (Hz) content window.
    :DISPlay:WINDow:SHERtz1:TOPMost FUNCtion1  // View function 1 waveform.
    :DISPlay:WINDow:SHERtz2:TOPMost FUNCtion3  // View function 3 waveform.
    // Autoscale waveforms in each Seconds (Hz) content window.
    :GRAPh:SHERtz1:X:AUToscale
    :GRAPh:SHERtz1:Y:AUToscale