System Preferences Commands

Sets and reads the VNA Preferences settings.

SYSTem:PREFerences

| ITEM

| EDEV: DPOLicy

| GDELay:TWOPoint

| MARKer:BANDwidth:SEARch

| MARKer:SINGle

| OFFSet

| OPTimize:MEMory

| PRESet:CONFirm

| PRESet:POWer:STATe

| RECeivers

| OVERload:POWer

| RETRace:POWer

| SOFTkeys:NAVigation

Click on a keyword to view the command details.

See Also

SYSTem:PREFerences:ITEM:ASMRamp <bool>

Applicable Models: N522xB, N523xB, N524xB, E5080A (Read-Write) Set and return whether ramp sweep is used whenever possible when sweep mode is in Auto.
Parameters
<bool>	Choose from: ON (1) Enable ramp sweep. OFF (0) Disable ramp sweep.
Examples	SYST:PREF:ITEM:ASMR 1 system:preferences:item:asmramp OFF
Query Syntax	SYSTem:PREFerences:ITEM:ASMRamp?
Return Type	Boolean
Default	OFF

SYSTem:PREFerences:DEFault

Applicable Models: All (Write-only) Resets the VNA preferences to their default settings. Some default settings vary depending on the VNA Model. Learn more about VNA Preferences.
Examples	SYST:PREF:DEF system:preferences:default
Query Syntax	Not Applicable
Default	Not Applicable

SYSTem:PREFerences:ITEM:EDEV:DPOLicy <bool>

Applicable Models: All (Read-Write) Set and return whether External Devices remain activated or are de-activated when the VNA is Preset or when a Instrument State is recalled. This setting remains until changed again using this command, or until the hard drive is changed or reformatted.
Parameters
<bool>	Choose from: OFF (0) External devices remain active when the VNA is Preset or when a Instrument State is recalled. ON (1) External devices are de-activated (SYST:CONF:EDEV:STAT to OFF) when the VNA is Preset or when a Instrument State is recalled.
Examples	SYST:PREF:ITEM:EDEV:DPOL 1 system:preferences:item:edev:dpolicy OFF
Query Syntax	SYSTem:PREFerences:ITEM:EDEV:DPOLicy?
Return Type	Boolean
Default	ON or 1

SYSTem:PREFerences:ITEM:EEXTrapolate <bool>

Applicable Models: All (Read-Write) Sets whether a Swept IMD or IMDx calibration can exceed the stop frequency limit of an ECal module. Learn more.
Parameters
<bool>	Choose from: ON (1) Allow extrapolation. OFF (0) Do NOT allow extrapolation.
Examples	SYST:PREF:ITEM:EEXT 1 system:preferences:item:eextrapolate OFF
Query Syntax	SYSTem:PREFerences:ITEM:EEXTrapolate?
Return Type	Boolean
Default	OFF

SYSTem:PREFerences:ITEM:GDELay:TWOPoint <bool>

Applicable Models: All (Read-Write) Sets the default group delay aperture setting. Learn more about group delay aperture.
Parameters
<bool>	Choose from: ON (1) Sets default group delay aperture to 2 points. OFF (0) Sets default group delay aperture to 11 points.
Examples	SYST:PREF:ITEM:GDELay:TWOPoint 1 system:preferences:item:gdelay:twopoint OFF
Query Syntax	SYSTem:PREFerences:ITEM:GDELay:TWOPoint?
Return Type	Boolean
Default	OFF

SYSTem:PREFerences:ITEM:KEYS <bool>

Applicable Models: N522xB, N523xB, N524xB, M937xA, P937xA (Read-Write) Set and return whether the keys are displayed or not.
Parameters
<bool>	Choose from: ON (1) – Turn keys on. OFF (0) – Turn keys off.
Examples	SYST:PREF:ITEM:KEYS 1 system:preferences:item:keys OFF
Query Syntax	SYSTem:PREFerences:ITEM:KEYS?
Return Type	Boolean
Default	OFF (0)

SYSTem:PREFerences:ITEM:MARKer:BANDwidth:SEARch <bool>

Applicable Models: All (Read-Write) Sets the bandwidth search preference to start a bandwidth or notch search in either peak or marker mode.
Parameters
<bool>	Choose from: ON (1) Search starts at the x and y position of the active marker. OFF (0) Search starts at the maximum y-value of the full sweep of data.
Examples	SYST:PREF:ITEM:MARK:BAND:SEAR 1 system:preferences:item:marker:bandwidth:search OFF
Query Syntax	SYSTem:PREFerences:ITEM:MARKer:BANDwidth:SEARch?
Return Type	Boolean
Default	OFF

SYSTem:PREFerences:ITEM:MARKer:SINGle <bool>

Applicable Models:All (Read-Write) Set and return whether to use one marker for marker search. Enabled behavior: Only one marker is used for bandwidth, notch, PNOP, and PSAT marker searches. The points of interest are marked with a notational UI element, i.e. a small triangle. Bandwidth, notch, PNOP, and PSAT marker searches are always tracking. Tracking cannot be disabled. One basic search and one advanced search may be set per marker. The advanced search is enabled until the user disables the search or a multi-peak or multi-target search is executed. Disabled behavior: Bandwidth, notch, PSAT, and PNOP marker searches use multiple markers. One advanced marker search is allowed per trace. A marker may only perform a basic search or be part of an advanced search. Not both. If an advanced marker search is enabled on a trace and then the user performs a basic search, the advanced search is automatically disabled. Advanced searches may enable or disable tracking. Only one search may be tracked.
Parameters
<bool>	Choose from: ON (1) Enable single marker search. OFF (0) Disable single marker search.
Examples	SYST:PREF:ITEM:MARK:SING 1 system:preferences:item:marker:single OFF
Query Syntax	SYSTem:PREFerences:ITEM:MARKer:SINGle?
Return Type	Boolean
Default	ON

SYSTem:PREFerences:ITEM:MCControl <bool>

Applicable Models: All (Read-Write) Set and return whether the Coupled Markers setting controls the ON\|OFF state of markers that are coupled. Learn more about Coupled Markers. Refer also to CALC:MEAS:MARK:COUP:STATe ON.
Parameters
<bool>	Choose from: ON (1) – With Coupled Markers ON, when a marker is turned on, the same-numbered marker on all coupled traces will also be turned on. Likewise, turning off a marker will turn it off on all coupled traces. OFF (0) – Turning a marker on or off will have no effect on the markers on other traces.
Examples	SYST:PREF:ITEM:MCC 1 system:preferences:item:mccontrol OFF
Query Syntax	SYSTem:PREFerences:ITEM:MCControl?
Return Type	Boolean
Default	OFF (0)

SYSTem:PREFerences:ITEM:MCMethod <bool>

Applicable Models: All (Read-Write) Set and return whether Coupled Markers is set to Channel or All after Preset. Learn more about Coupled Markers. Refer also to CALC:MEAS:MARK:COUP:STATe ON and SYST:PREF:ITEM:MCPR ON.
Parameters
<bool>	Choose from: ON (1) – Marker Coupling Method is set to Channel after Preset. OFF (0) – Marker Coupling Method is set to ALL after Preset.
Examples	SYST:PREF:ITEM:MCM 1 system:preferences:item:mcmethod OFF
Query Syntax	SYSTem:PREFerences:ITEM:MCMethod?
Return Type	Boolean
Default	OFF (0)

SYSTem:PREFerences:ITEM:MCPRest <bool>

Applicable Models: All (Read-Write) Set and return whether Coupled Markers is set to ON or OFF after Preset. Learn more about Coupled Markers.
Parameters
<bool>	Choose from: OFF (0) – Coupled Markers is OFF after Preset. ON (1) – Coupled Markers is ON after Preset.
Examples	SYST:PREF:ITEM:MCPR 1 system:preferences:item:mcpreset OFF
Query Syntax	SYSTem:PREFerences:ITEM:MCPReset?
Return Type	Boolean
Default	OFF (0)

SYSTem:PREFerences:ITEM:MINTerpolate <bool>

Applicable Models: N522xB, N523xB, N524xB (Read-Write) Sets and reads the state of the memory data interpolation default preference. The PNA will return to the default interpolation state after a Preset, creating a new trace, or closing the PNA application. Learn more.
Parameters
<bool>	Choose from: 0 - OFF - Set memory interpolation to OFF as the default. 1 - ON - Set memory interpolation to ON as the default.
Examples	SYST:PREF:ITEM:MINT 1
Query Syntax	SYSTem:PREFerences:ITEM:MINTerpolate?
Return Type	Boolean
Default	0

SYSTem:PREFerences:ITEM:MRU <bool>

Applicable Models: All (Read-Write) Set and return whether to list files for recall on softkeys by most-recently used or alphabetically.
Parameters
<bool>	Choose from: ON (1) – Recall softkeys show most recently-used files. OFF (0) – Recall softkeys show alphabetically-ordered files.
Examples	SYST:PREF:ITEM:MRU 1 system:preferences:item:mru OFF
Query Syntax	SYSTem:PREFerences:ITEM:MRU?
Return Type	Boolean
Default	OFF (0)

SYSTem:PREFerences:ITEM:OFFSet:RCV <bool>

Applicable Models: All (Read-Write) Set and return whether to offset the test port receivers by the amount of receiver attenuation. Learn more. To send this command using the VNA front panel, open the GPIB Command Processor Console, then type either of the following examples at the command prompt. Then type the Query Syntax and press enter to be sure the VNA took the command. This setting remains until changed again using this command, or until the hard drive is changed or reformatted.
Parameters
<bool>	Choose from: ON (1) Offset the test port receivers OFF (0) Do NOT offset the test port receivers
Examples	SYST:PREF:ITEM:OFFS:RCV 1 system:preferences:item:offset:rcv OFF
Query Syntax	SYSTem:PREFerences:ITEM:OFFSet:RCV?
Return Type	Boolean
Default	PNA-L and E836xB: OFF (does NOT offset the display). PNA-X: ON (offsets the display).

SYSTem:PREFerences:ITEM:OFFSet:SRC <bool>

Applicable Models: All (Read-Write) Set and return whether to offset the reference receiver by the amount of source attenuation. Learn more. To send this command using the VNA front panel, open the GPIB Command Processor Console, then type either of the following examples at the command prompt. Then type the Query Syntax and press enter to be sure the VNA took the command. This setting remains until changed again using this command, or until the hard drive is changed or reformatted.
Parameters
<bool>	Choose from: ON (1) Offset the reference receivers. OFF (0) Do NOT Offset the reference receivers.
Examples	SYST:PREF:ITEM:OFFS:SRC 1 system:preferences:item:offset:src OFF
Query Syntax	SYSTem:PREFerences:ITEM:OFFSet:SRC?
Return Type	Boolean
Default	All models: ON (offset the display).

SYSTem:PREFerences:ITEM:OPTimize:MEMory <bool>

Applicable Models: M9485A (Read-Write) Set and return the memory optimization function status. This extends the maximum number of channel. However, this causes slow measurement.
Parameters
<bool>	Choose from: ON (1) Memory optimization on (more channesl, but slower speed) OFF (0) Memory optimization off
Examples	SYST:PREF:ITEM:OPT:MEM 1 system:preferences:item:optimize:memory OFF
Query Syntax	SYSTem:PREFerences:ITEM:OPTimize:MEMory?
Return Type	Boolean
Default	OFF

SYSTem:PREFerences:ITEM:PRESet:CONFirm <bool>

Applicable Models: All (Read-Write) Set and return preset confirmation. If preset confirmation is OFF, pressing the green PRESET key presets the instrument and opens the Preset softkey menu. If preset confirmation is ON, pressing the green PRESET causes the Preset menu to appear.
Parameters
<bool>	Choose from: ON (1) Enable preset confirmation. OFF (0) Disable preset confirmation.
Examples	SYST:PREF:ITEM:PRES:CONF 1 system:preferences:item:preset:confirm OFF
Query Syntax	SYSTem:PREFerences:ITEM:PRESet:CONFirm?
Return Type	Boolean
Default	ON

SYSTem:PREFerences:ITEM:PRESet:POWer[:STATe] <char>

Applicable Models: All (Read-Write) Set and return the Preset Power ON/OFF state. Learn more. This setting remains until changed again using this command, or until the hard drive is changed or reformatted.
Parameters
<char>	Choose from: ON - Instrument Preset always turns RF power ON. AUTO - When the current power setting is OFF, leave power OFF after Preset. When the current power setting is ON, turn power ON after Preset.
Examples	SYST:PREF:ITEM:PRE:POW ON system:preferences:item:preset:power:state auto
Query Syntax	SYSTem:PREFerences:ITEM:PREset:POWer[:STATe]?
Return Type	Character
Default	ON

SYSTem:PREFerences:ITEM:PSRTrace <char>

Applicable Models: All (Read-Write) At the end of a power sweep, while waiting to trigger the next sweep, maintain source power at either the start power level or at the stop power level. To send this command using the VNA front panel, open the GPIB Command Processor Console, then type either of the following examples at the command prompt. Then type the Query Syntax and press enter to be sure the VNA took the command. This setting remains until changed again using this command, or until the hard drive is changed or reformatted.
Parameters
<char>	Choose from: STARt - Maintain source power at the start power level. STOP - Maintain source power at the stop power level.
Examples	SYST:PREF:ITEM:PSRT STOP system:preferences:item:psrtrace start
Query Syntax	SYSTem:PREFerences:ITEM:PSRTrace?
Return Type	Character
Default	STARt

SYSTem:PREFerences:ITEM:QSTart <bool>

Applicable Models: All (Read-Write) This command controls the on/off state of the preference, "On PRESET show Quick Start dialog".
Parameters
<bool>	Choose from: ON (1) Display the Quick Start dialog on PRESET. OFF (0) Do not display the Quick Start dialog on PRESET.
Examples	SYST:PREF:ITEM:QST 1 system:preferences:item:qstart OFF
Query Syntax	SYSTem:PREFerences:ITEM:QST?
Return Type	Boolean
Default	OFF

SYSTem:PREFerences:ITEM:RECeivers:CERRor[:STATe] <bool>

Applicable Models: All (Read-Write) Set and return whether to display receiver overload warnings. Learn more.
Parameters
<bool>	Choose from: ON (1) Display overload warnings, OFF (0) Do NOT display overload warnings.
Examples	SYST:PREF:ITEM:REC:CERR 1 system:preferences:item:receivers:cerror:state OFF
Query Syntax	SYSTem:PREFerences:ITEM:RECeivers:CERRor[:STATe]?
Return Type	Boolean
Default	ON

SYSTem:PREFerences:ITEM:RECeivers:OVERload:POWer[:STATe] <bool>

Applicable Models: All (Read-Write) Set and return whether to turn source power OFF when a receiver is overloaded. Learn more.
Parameters
<bool>	Choose from: ON (1) Turn OFF source power to ALL ports when a receiver is overloaded. OFF (0) Power remains ON when a receiver is overloaded.
Examples	SYST:PREF:ITEM:REC:OVER:POW 1 system:preferences:item:receivers:overload:power:state OFF
Query Syntax	SYSTem:PREFerences:ITEM:RECeivers:OVERload:POWer[:STATe]?
Return Type	Boolean
Default	OFF (0)

SYSTem:PREFerences:ITEM:REDLimits <bool>

Applicable Models: N522xB, N523xB, N524xB, M937xA, P937xA (Read-Write) Set and return whether to draw limits lines in Red or the trace color.
Parameters
<bool>	Choose from: ON (1) All Limit lines are drawn in Red. OFF (0) Limit lines are drawn the same color as the trace.
Examples	SYST:PREF:ITEM:REDL 1 system:preferences:item:redlimits OFF
Query Syntax	SYSTem:PREFerences:ITEM:REDLimits?
Return Type	Boolean
Default	OFF

SYSTem:PREFerences:ITEM:REFMarker <bool>

Applicable Models: N522xB, N523xB, N524xB, M937xA, P937xA (Read-Write) Set and return whether to treat marker 10 as a reference marker. Learn more.
Parameters
<bool>	Choose from: ON (1) Marker 10 is always a reference marker (Pre A.10.40 behavior). OFF (0) Marker 10 is just another marker. See Reference Marker commands
Examples	SYST:PREF:ITEM:REFM 1 system:preferences:item:refmarker OFF
Query Syntax	SYSTem:PREFerences:ITEM:REFMarker?
Return Type	Boolean
Default	OFF

SYSTem:PREFerences:ITEM:RETRace:POWer <char>

Applicable Models: All (Read-Write) For single-band frequency or segment sweeps ONLY, specify whether to turn RF power ON or OFF during a retrace. Learn more about RF power during sweep retrace. To send this command using the VNA front panel, open the GPIB Command Processor Console, then type either of the following examples at the command prompt. Then type the Query Syntax and press enter to be sure the VNA took the command. This setting remains until changed using this command, or until the hard drive is changed or reformatted.
Parameters
<char>	Choose from: AUTO: Power is left ON during retrace of single-band frequency or segment sweeps ONLY. OFF: Power is turned OFF during retrace of single-band frequency or segment sweeps ONLY.
Examples	SYST:PREF:ITEM:RETR:POW OFF system:preferences:item:retrace:power auto
Query Syntax	SYSTem:PREFerences:ITEM:RETRace:POWer?
Return Type	Character
Default	AUTO

SYSTem:PREFerences:ITEM:RTOF <bool>

Applicable Models: All (Read-Write) Set and return whether to display limit line failures as red trace segments or red data points (dots). Learn more.
Parameters
<bool>	Choose from: ON (1) Display failures as red trace segments. (Red Trace On Fail). OFF (0) Display failures as red data points (dots).
Examples	SYST:PREF:ITEM:RTOF 1 system:preferences:item:rtof OFF
Query Syntax	SYSTem:PREFerences:ITEM:RTOF?
Return Type	Boolean
Default	OFF

SYSTem:PREFerences:ITEM:SOFTkeys:NAVigation <bool>

Applicable Models: N522xB, N523xB, N524xB, M937xA, P937xA (Read-Write) This command controls the on/off state of the preference, "Use keyboard to navigate softkeys".
Parameters
<bool>	Choose from: ON (1) Enable softkey navigation with keyboard. OFF (0) Disable softkey navigation with keyboard.
Examples	SYST:PREF:ITEM:SOFT:NAV 1 system:preferences:item:softkeys:navigation OFF
Query Syntax	SYSTem:PREFerences:ITEM:SOFTkeys:NAVigation?
Return Type	Boolean
Default	OFF

SYSTem:PREFerences:ITEM:SWITch:DEF <string>, <int>

Applicable Models: All (Read-Write) Sets the default setting for the Noise Tuner switch. This is the setting that occurs when a new channel is created. Learn more. This command will return an error on VNA models with a built-in Noise tuner. To send this command using the VNA front panel, open the GPIB Command Processor Console, then type either of the following examples at the command prompt. Then type the Query Syntax and press enter to be sure the VNA took the command. This setting remains until changed using this command, or until the hard drive is changed or reformatted.
Parameters
<string>	Name of the switch to set. Choose from: "Port1NoiseTuner"
<int>	Value to set. Choose from: 0 Sets the default (preset) to INTERNAL 1 Sets the default (preset) to EXTERNAL
Examples	SYST:PREF:ITEM:SWIT:DEF "Port1NoiseTuner" 1 'Write system:preferences:item:switch:def? "Port1NoiseTuner" 'Read
Query Syntax	SYSTem:PREFerences:ITEM:SWITch:DEF? <switch>
Return Type	Integer
Default	1 (External)