Waveform Content Windows

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.

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