SSA3000X Plus
Spectrum Analyzer
SSA3000X-R
Real-Time Spectrum Analyzer
SVA1000X
Spectrum & Vector Network
Analyzer
Programming Guide
PG0703P_E02B

Contents
1.

Programming Overview ....................................................................... 1

1.1

Remotely Operating the Analyzer ...................................................................... 1

1.2

Build Communication ......................................................................................... 3

1.3

Remote Control Capabilities .............................................................................. 6

2.

SCPI Overview .................................................................................... 10

2.1

Command Format ............................................................................................. 10

2.2

Symbol Instruction ............................................................................................ 10

2.3

Parameter Type ................................................................................................. 11

2.4

Command Abbreviation .................................................................................... 12

3.

Commands that are Common to All Modes ..................................... 13

3.1IEEE Common Commands .............................................................................. 13

3.2

System Subsystem .............................................................................................. 15

3.3

Memory Subsystem ........................................................................................... 22

3.4

Display Subsection ............................................................................................. 23

3.5

Mode Subsection ................................................................................................ 24

4.

Spectrum Analyzer ............................................................................. 25

4.1

Frequency Subsection ........................................................................................ 25

4.2

Amplitude Subsection ........................................................................................ 29

4.3

Sweep Subsection ............................................................................................... 35

4.4

Trigger Subsystem ............................................................................................. 39

4.5

Bandwidth Subsection ....................................................................................... 40

4.6

Trace Subsection ................................................................................................ 43

4.7

Marker Subsection............................................................................................. 48

4.8

Limit Subsection ............................................................................................... 60

4.9

Measurement Subsystem................................................................................... 66

4.10 TG Subsystem .................................................................................................... 85
4.11 Demod Subsystem .............................................................................................. 88

5.

Vector Network Analyzer .................................................................. 90

5.1

Frequency Subsection ........................................................................................ 90

5.2

Display Subsection ............................................................................................. 92

5.3

Bandwidth Subsection ....................................................................................... 93

5.4

Sweep Subsection ............................................................................................... 93

5.5

Trace Subsection ................................................................................................ 95

SIGLENT
5.6

Marker Subsection........................................................................................... 101

5.7

Calibration Subsystem .................................................................................... 106

5.8

Port Extensions ................................................................................................ 112

6.

Distance To Fault .............................................................................. 114

6.1

Frequency Subsection ...................................................................................... 114

6.2

Amplitude Subsection ...................................................................................... 115

6.3

Sweep Subsection ............................................................................................. 116

6.4

Trace Subsection .............................................................................................. 118

6.5

Marker Subsection........................................................................................... 119

6.6

Measurement Subsystem................................................................................. 122

7.

Modulation Analyzer ........................................................................ 128

7.1

Frequency Subsection ...................................................................................... 128

7.2

Amplitude Subsection ...................................................................................... 129

7.3

BW Subsection ................................................................................................. 131

7.4

Sweep Subsection ............................................................................................. 132

7.5

Trace Subsection .............................................................................................. 133

7.6

Marker Subsection........................................................................................... 136

7.7

Measurement Subsystem................................................................................. 138

7.8

Trigger Subsection ........................................................................................... 143

8.

Real Time Spectrum Analysis.......................................................... 145

8.1

Frequency Subsection ...................................................................................... 145

8.2

Amplitude Subsection ...................................................................................... 149

8.3

BW Subsection ................................................................................................. 151

8.4

Sweep Subsection ............................................................................................. 152

8.5

Trace Subsection .............................................................................................. 154

8.6

Marker Subsection........................................................................................... 158

8.7

Trigger Subsection ........................................................................................... 160

8.8

Meas Subsection ............................................................................................... 164

9.

EMI Measurement ............................................................................ 166

9.1

Frequency Subsection ...................................................................................... 166

9.2

Amplitude Subsection ...................................................................................... 168

9.3

Sweep Subsection ............................................................................................. 171

9.4

Bandwidth Subsection ..................................................................................... 174

9.5

Trace Subsection .............................................................................................. 175

9.6

Marker Subsection........................................................................................... 177

SIGLENT
9.7

Limit Subsection ............................................................................................. 182

9.8

Measurement Subsystem................................................................................. 186

10. Programming Examples ................................................................... 192
10.1 Examples of Using VISA ................................................................................. 192
10.2 Examples of Using Sockets/Telnet .................................................................. 202

SIGLENT

1.Programming Overview
The analyzer features LAN, USB Device, and SIGLENT GPIB_USB module interfaces. By using acomputer with these interfaces, and a suitable programming language (and/or NI-VISA software), users canremotely control the analyzer based on SCPI (Standard Commands for Programmable Instruments)
command set, Labview and IVI (Interchangeable Virtual Instrument), to interoperate with otherprogrammable instruments.
This chapter introduces how to build communication between the spectrum analyzer and a controller
computer with these interfaces.

1.1 Remotely Operating the Analyzer
The analyzer provides both the USB and LAN connection which allows you to set up a remote operation
environment with a controller computer. A controller computer could be a personal computer (PC) or aminicomputer. Some intelligent instruments also function as controllers.

1.1.1

USB: Connecting the Analyzer via the USB Device port

Refer to the following steps to finish the connection via USB-Device:1.

Install NI-VISA on your PC for USB-TMC driver.

2.

Connect the analyzer USB Device port to a PC with a USB A-B cable.

Figure 1-1 USB Device
3.

Switch on the analyzer.

The analyzer will be detected automatically as a new USB hardware.

1.1.2

LAN: Connecting the Analyzer via the LAN port

Refer to the following steps to finish the connection via LAN:
1.

Install NI-VISA on your PC for VXI driver. Or without NI-VISA, using socket in your PC’s
Operating System.

2.

Connect the analyzer to PC or the local area network with a LAN cable.

Programming Guide

1SIGLENT

Figure 1-2 LAN
3.

Switch on the analyzer.

4.

Press button on the front panel System →Interface→LAN to enter the LAN Config function
menu.

5.

Select the IP Config between Static and DHCP.

◆ DHCP: the DHCP server in the current network will assign the network parameters
automatically (IP address, subnet mask, gate way) for the analyzer.
◆ Static: you can set the IP address, subnet mask, gate way manually. Press Apply.

Figure 1-3 LAN Config
The analyzer will be detected automatically or manually as a new LAN point.

1.1.3

GPIB: Connecting the Analyzer via the USB Host port

Refer to the following steps to finish the connection via USB:
1.

Install NI-VISA on your PC for GPIB driver.

2.

Connect the analyzer USB Host port to a PC’s GPIB card port, with SIGLENT USB-GPIB
adaptor.

Figure 1-4 SIGLENT USB-GPIB Adaptor

2

3.

Switch on the analyzer.

4.

Press button on the front panel System→Interface→GPIB to enter the GPIB number.

Programming GuideSIGLENT
The analyzer will be detected automatically as a new GPIB point.

1.2 Build Communication
1.2.1

Build Communication Using VISA

NI-VISA includes a Run-Time Engine version and a Full version. The Run-Time Engine version provides
NI device drivers such as USB-TMC, VXI, GPIB, etc. The full version includes the Run-Time Engine and asoftware tool named NI MAX that provides a user interface to control the device.
You can get NI-VISA full version from:http://www.ni.com/download/.
After download you can follow the steps below to install it:a.Double click the visa_full.exe, dialog shown as below:

b.Click Unzip, the installation process will automatically launch after unzipping files. If your computer
needs to install .NET Framework 4, its setup process will auto start.

c.The NI-VISA installing dialog is shown above. Click Next to start the installation process.

Programming Guide

3

SIGLENT

Set the install path, default path is “C:\Program Files\National Instruments\”, you can change it. Click
Next, dialog shown as above.

d.Click Next twice, in the License Agreement dialog, select the “ I accept the above 2 License
Agreement(s).” ,and click Next, dialog shown as below:

e.Click Next to run installation.

4

Programming GuideSIGLENT

Now the installation is complete, reboot your PC.

1.2.2

Build Communication Using Sockets

Through the LAN interface, VXI-11, Sockets and Telnet protocols can be used to communicate with thespectrum analyzer. VXI-11 is provided in NI-VISA, while Sockets and Telnet are commonly included inPC’s OS initially.
Socket LAN is a method used to communicate with the spectrum analyzer over the LAN interface using theTransmission Control Protocol/Internet Protocol (TCP/IP). A socket is a fundamental technology used forcomputer networking and allows applications to communicate using standard mechanisms built into
network hardware and operating systems. The method accesses a port on the spectrum analyzer from whichbidirectional communication with a network computer can be established.
Before you can use sockets LAN, you must select the analyzer’s sockets port number to use:◆

Standard mode. Available on port 5025. Use this port for programming.

Programming Guide

5

SIGLENT

1.3 Remote Control Capabilities
1.3.1

User-defined Programming

Users can use SCPI commands to program and control the spectrum analyzer. For details, refer to theintroductions in “Programming Examples”.

1.3.2

Send SCPI Commands via NI MAX

Users can control the spectrum analyzer remotely by sending SCPI commands via NI-MAX software.
NI-MAX is National Instruments Measurement and Automation Explorer. It is an executable programthat enables easy communication to troubleshoot issues with instrumentation.

1.3.2.1 Using USB
Run NI MAX software.
1. Click “Device and Interface” at the upper left corner of the software;2.
Find the “USBTMC” device symbol.

3.
4.

Click “Open VISA Test Panel” option button, then the following interface will appear.
Click the “Input/Output” option button and click the “Query” option button in order to view theoperation information.

NOTE: The *IDN? command (known as the Identification Query) returns the instrument manufacturer,
instrument model, serial number, and other identification information.

1.3.2.2 Using LAN
Select, Add Network Device, and select VISA TCP/IP Resource as shown:
Run NI MAX software.
1. Click “Device and Interface” at the upper left corner of the software;
2. Find the “Network Devices” symbol, click “Add Network Device”;
6

Programming GuideSIGLENT

3.

Select Manual Entry of LAN instrument, select Next, and enter the IP address as shown. Click
Finish to establish the connection:

NOTE: Leave the LAN Device Name BLANK or the connection will fail.

4.

After a brief scan, the connection should be shown under Network Devices:

5.

Right-click on the product and select Open NI-VISA Test Panel:

Programming Guide

7

SIGLENT

6.

Click “Input/Output” option button and click “Query” option button. If everything is OK, you will
see the Read operation information returned as shown below.

1.3.3

EasySpectrum Software

Users can control the spectrum analyzer remotely by EasySpectrum. PC software EasySpectrum is aneasy-to-use, PC-Windows-based remote control tool for Siglent’s spectrum analyzer. You can download
it from Siglent’s website. To connect the analyzer via the USB/LAN port to a PC, you need install the NI
VISA first.
It is able to be used as:◆

A monitor to display and control the trace scans simultaneously with the analyzer;◆

A file maker to get user defined Limit/Correction files, and load them to the analyzer;◆

An EMI receiver to perform EMI Pre-compliance test including prescan, peak search, finalscan andreport generating.

For the further description of the software, please refer to the online help embedded in this software.

8

Programming GuideSIGLENT

1.3.4

Web Control

With the embedded web server, the analyzer can be controlled through LAN from a web browser* on PC
and mobile terminals, without any extra driver be installed. This provides remote controlling andmonitoring capabilities. Screenshot and firmware update are also supported.

*Web browser with HTML5 supported like Google Chrome or Firefox are recommended.

Programming Guide

9SIGLENT

2.SCPI Overview
2.1 Command Format
SCPI commands present a hierarchical tree structure containing multiple subsystems, each of thesubsystems is made up of a root keyword and several subkeywords. The command string usually starts with“:”, the keywords are separated by “:” and the followed parameter settings are separated by space. Query
commands add “?” at the end of the string.
For example::SENSe:FREQuency:CENTer <freq>:SENSe:FREQuency:CENTer?
SENSe is the root key of the command, FREQuency and CENTer are second and third keywords. The
command begins with “:”, and separates the keywords at the same time, <freq> separated by space andrepresents the parameter available for setting; “?” represents a query.

2.2 Symbol Instruction
The following four symbols are not the content of SCPI commands and cannot be sent with the commands,
but are usually used in the commands.

1. Triangle Brackets < >The parameter in the triangle brackets must be replaced by an effective value. For example:
Send the “:DEMod:VOLume <value>” command in “:DEMod:VOLume 5”.

2. Square Brackets [ ]The content in the square brackets can be ignored. When the parameter is ignored, the instrument will set
the parameter to its default. For example,
In the “[:SENSe]:POWer[:RF]:ATTenuation?” command, sending any of the four commands below cangenerate the same effect::POWer:ATTenuation?
:POWer:RF:ATTenuation?
:SENSe:POWer:ATTenuation?
:SENSe:POWer:RF:ATTenuation?

3. Vertical Bar |The vertical bar is used to separate multiple parameters and when sending the command, you can choose
one of the parameters. For example,
In the “[:SENSe]:FREQuency:CENTer:STEP:AUTO OFF|ON|0|1” command, the parameters available are“OFF”, “ON”, “0” or “1”.

10

Programming GuideSIGLENT
4. Braces { }The parameters in the braces are optional which can be ignored or set for one or more times. For example::CALCulate:LLINe[1]|2:DATA <x-axis>,<ampl>{,<x-axis>, <ampl>}, in the command, the {,<x-axis>,<ampl>} parameters can be ignored or set for one or more times.

2.3 Parameter TypeThe parameters in the commands introduced in this manual include 6 types: boolean, enumeration, integer,
float, discrete and string.

1.

Boolean

The parameters in the commands could be “OFF”, “ON”, “0” or “1”. For example:[:SENSe]:FREQuency:CENTer:STEP:AUTO OFF|ON|0|1

2. Enumeration
The parameter could be any of the values listed. For example:[:SENSe]:AVERage:TYPE LOGPower|POWer|VOLTage
The parameter is “OGPower”, “POWer” or “VOLTage”.

3. String
The parameter should be the combinations of ASCII characters. For example::SYSTem:COMMunicate:LAN:IPADdress <“xxx.xxx.xxx.xxx”>
The parameter can be set as “192.168.1.12” string.

4. Integer
Except other notes, the parameter can be any integer within the effective value range. For example:[:SENSe]:DEMod:VOLume <value>
The parameter < value > can be set to any integer between 0 and 10.

5. Float
The parameter could be any value within the effective value range according to the accuracy requirement(the default accuracy contains up to 9 digits after the decimal points). For example::CALCulate:BANDwidth:NDB <value>
The parameter < value > can be set to any real number between -100 and 100.

6. Discrete
The parameter could only be one of the specified values and these values are discontinuous. For example:[:SENSe]:BWIDth:VIDeo:RATio <number>
The parameter <number> could only be one of 0.001, 0.003, 0.01, 0.03, 0.1, 0.3, 1.0, 3.0, 10.0, 30.0, 100.0,

Programming Guide

11

SIGLENT
300.0, 1000.0.

2.4 Command Abbreviation
All of the commands are not case sensitive, so you can use any of them. But if abbreviation is used, all thecapital letters in the command must be written completely. For example::DISPlay:WINDow:TRACe:Y:DLINe:STATe?
Can be abbreviated to::DISP:WIND:TRAC:Y:DLIN:STAT?

12Programming GuideSIGLENT

3.Commands that are Common to All
ModesIEEE Common Commands
System Subsystem
Memory Subsystem
Display Subsection
Mode Subsection

3.1 IEEE Common Commands
*IDN
*RST
*CLS
*ESE
*ESR?
*OPC
*SRE
*STB?
*WAI
*TRG
*TST?

CommandFormatInstruction

Menu
Example*IDN?
Returns an instrument identification information string. The string will contain the
manufacturer, model number, serial number, software number, FPGA number and CPLD
number.
None*IDN?
Return: Siglent,SVA1015,1234567890,100.01.01.06.01

Programming Guide

13

SIGLENT
CommandFormatInstruction

*RST

Menu

This command presets the instrument to a factory defined condition that is appropriate forremote programming operation.
None

Example*RST

CommandFormatInstruction

*CLS

Menu

Clears the status byte register. It does this by emptying the error queue and clearing all bits
in all of the event registers. The status byte register summarizes the states of the otherregisters. It is also responsible for generating service requests.
None

Example*CLS

CommandFormatInstruction

Menu*ESE <number>*ESE?
Set the bits in the standard event status enable register. This register monitors I/O errors
and synchronization conditions such as operation complete, request control, query error,
device dependent error, execution error, command error and power on. A summary bit isgenerated on execution of the command.
The query returns the state of the standard event status enable register.
None

Example*ESE 16

CommandFormatInstruction

*ESR?

Menu

Queries and clears the standard event status event register. (This is a destructive read.) The
value returned reflects the current state (0/1) of all the bits in the register.
None

Example*ESR?

CommandFormatInstruction

Menu

*OPC
*OPC?
Set bit 0 in the standard event status register to “1” when all pending operations havefinished.
The query stops any new commands from being processed until the current processing iscomplete. Then it returns a “1”, and the program continues. This query can be used tosynchronize events of other instruments on the external bus.
Returns a “1” if the last processing is complete. Use this query when there’s a need tomonitor the command execution status, such as a sweep execution.
None

Example*OPC?

14

Programming GuideSIGLENT

CommandFormatInstruction

Menu*SRE <integer>*SRE?
This command enables the desired bits of the service request enable register.
The query returns the value of the register, indicating which bits are currently enabled. The
default value is 255.
None

Example*SRE 1

CommandFormatInstruction

*STB?

Menu

None

Example*STB?

CommandFormatInstruction*WAI

This query is used by some instruments for a self test.

Menu

This command causes the instrument to wait until all pending commands are completed
before executing any additional commands.
There is no query form to the command.
None

Example*WAI

CommandFormatInstruction

*TRG

Menu

None

Example*TRG

CommandFormatInstruction

*TST?

Menu

None

Example*TST?

Restarts the current sweep.

This query is used by some instruments for a self test.

3.2 System Subsystem:SYSTem:TIME:SYSTem:DATE

Programming Guide

15

SIGLENT:SYSTem:COMMunicate:LAN:IPADdress:SYSTem:COMMunicate:LAN:GATeway:SYSTem:COMMunicate:LAN:SMASk:SYSTem:COMMunicate:LAN:TYPE:SYSTem:LANGuage:SYSTem:PON:TYPE:SYSTem:RESTart:SYSTem:PRESet:SYSTem:PRESet:TYPE:SYSTem:PRESet:USER[1]|2|3|4|5|6|7:SAVE:SYSTem:PRESet:USER[1]|2|3|4|5|6|7:LOAD:SYSTem:FDEFault:SYSTem:LKEY:SYSTem:OPTions?
:SYSTem:POWer:OFF:SYSTem:CONFigure:SYSTem?

CommandFormatInstruction
Parameter
Type
Parameter
Range
Return:SYSTem:TIME <hhmmss>:SYSTem:TIME?
Sets System time.
Gets System time.
Stringhour(0~23), minute(0~59), second(0~59)
StringDefault

None

Menu

System > Date & Time

ExampleSets System time::SYSTem:TIME 182559
Gets System time::SYSTem:TIME?

CommandFormatInstruction:SYSTem:DATE <yyyymmdd>:SYSTem:DATE?
Sets system date.
Gets system date.
StringParameter
Type
Parameter
Range
Return16year(four digits), month(1~12), date(1~31)
String

Programming GuideSIGLENT
Default

None

Menu

System > Date & Time

ExampleSets System date::SYSTem:DATE 20050101
Gets System date::SYSTem:DATE?

CommandFormatInstruction:SYSTem:COMMunicate:LAN:IPADdress <“xxx.xxx.xxx.xxx”>:SYSTem:COMMunicate:LAN:IPADdress?
Sets a host name for the analyzer in network.
IP Address command will be effective after using this “APPLy” command.
Gets IP address.
StringParameter
Type
Parameter
Range
ReturnConform to the IP Sets standard(0-255:0-255:0-255:0-255)
IP address String

Default

None

Menu

System > Interface > LAN > IP Address

Example:SYSTem:COMMunicate:LAN:IPADdress “192.168.1.12”:SYSTem:COMMunicate:LAN:IPADdress?

CommandFormatInstruction:SYSTem:COMMunicate:LAN:GATeway <“xxx.xxx.xxx.xxx”>:SYSTem:COMMunicate:LAN:GATeway?
Sets the gateway for the analyzer in the network. The gateway will be fetched
automatically if the IP assignment is set to DHCP.
Gateway command will be effective after using this “APPLy” command.
Gets gateway.
StringParameter
Type
Parameter
Range
ReturnConform to the IP standard (0-255:0-255:0-255:0-255)
Gateway string.

Default

None

Menu

System > Interface > LAN > Gateway

Example:SYSTem:COMMunicate:LAN:GATeway “192.168.1.1”:SYSTem:COMMunicate:LAN:GATeway?

CommandFormatInstruction:SYSTem:COMMunicate:LAN:SMASk <“xxx.xxx.xxx.xxx”>:SYSTem:COMMunicate:LAN:SMASk?
Sets the subnet mask according to the PC network Settings. The subnet mask will be set
automatically if the IP assignment is set to DHCP.
Subnet Mask commands will be effective after using this “APPLy” command.
Gets Subnet Mask.
StringParameter
Type
Parameter
Range

Conform to the IP standard (0-255:0-255:0-255:0-255)

Programming Guide

17

SIGLENT
ReturnSubnet mask string

Default

None

Menu

System > Interface > LAN > Subnet Mask

Example:SYSTem:COMMunicate:LAN:SMASk?

CommandFormatInstruction:SYSTem:COMMunicate:LAN:TYPE STATIC|DHCP:SYSTem:COMMunicate:LAN:TYPE?
Toggles the IP assignment Setting between static (manual) and DHCP (dynamic
assignment) mode.
Gets IP config.
Enumeration

Parameter
Type
Parameter
Range
ReturnSTATIC|DHCP
Enumeration

Default

None

Menu

System > Interface > LAN > IP Config

Example:SYSTem:COMMunicate:LAN:TYPE DHCP
:SYSTem:COMMunicate:LAN:TYPE?

CommandFormatInstruction:SYSTem:LANGuage SCHINESE|ENGLISH:SYSTem:LANGuage?
Sets language.
Gets language.
Enumeration

Parameter
Type
Parameter
Range
ReturnSCHINESE: Chinese
ENGLISH: English
Enumeration

Default

None

Menu

System > Language

ExampleSets language:SYSTem:LANGuage SCHINESE
Gets language:SYSTem:LANGuage?

CommandFormatInstruction:SYSTem:PON:TYPE DFT|LAST|USER:SYSTem:PON:TYPE?
Uses command to set analyzer to power on in default, user, or last state.
Gets power on type.
Enumeration

Parameter
Type
Parameter
Range
Return18

DFT: Default
LAST: Last
USER: Custom Configuration
Enumeration

Programming GuideSIGLENT
Default

DFT

Menu

System > Pwr On/Preset > Power On

ExampleSYSTem:PON:TYPE DFT

CommandFormatInstruction:SYSTem:PRESet

Parameter
Type
Parameter
Range
ReturnUse this command to preset the instrument. The preset type is based on the Setting ofPreset Type: DFT, User or Last.
None
None
None

Default

None

Menu

None

Example:SYSTem:PRESet

CommandFormatInstruction:SYSTem:RESTart

Parameter
Type
Parameter
Range
ReturnNone

Default

None

Menu

None

Example:SYSTem:RESTart

CommandFormatInstruction:SYSTem:PRESet:TYPE DFT|LAST|USER:SYSTem:PRESet:TYPE?
Uses this command to preset the analyzer to default, user, or last state.
Gets preset type.
Enumeration

Parameter
Type
Parameter
Range

Use this command to restart the instrument (part of machine may not support).

None
None

ReturnDFT: Default
LAST: Last
USER: Custom Configuration
Enumeration

Default

DFT

Menu

System > Pwr On/Preset > Preset

Example:SYSTem:PRESet:TYPE DFTProgramming Guide

19

SIGLENT

CommandFormatInstruction:SYSTem:PRESet:USER[1]|2|3|4|5|6|7:SAVE

Parameter
Type
Parameter
Range
ReturnNone

Default

None

Menu

System > Pwr/Preset > User Config

Example:SYSTem:PRESet:USER7:SAVE

CommandFormatInstruction:SYSTem:PRESet:USER[1]|2|3|4|5|6|7:LOAD

Parameter
Type
Parameter
Range
ReturnNone

Default

None

Menu

System > Pwr On/Preset > User Config

Example:SYSTem:PRESet:USER6:LOAD

CommandFormatInstruction:SYSTem:FDEFault

Parameter
Type
Parameter
Range
ReturnNone

Default

None

Menu

System > Pwr On/Preset > Factory Reset

Example:SYSTem:FDEFault

CommandFormatInstruction:SYSTem:LKEY <“option”>,<“license key”>

20

Saves current setting to user config.

None
None

Loads user config.

None
None

Sets both the measure and setting parameters to factory preset parameters.

None
None

Uses this command to enable the specified option with the license key, please restart the
instrument to make license active.
Programming GuideSIGLENT
Parameter
Type
Parameter
Range
Return“option”: Enumeration“license key”: String“option”: Meas|EMI|TG|DMA|DTF|VNA“license key”: provided by Siglent Technologies, 16 bits String.
None

Default

None

Menu

System > System Info > Load Option

Example:SYSTem:LKEY EMI,fjbdajffnklmgwno

CommandFormatInstruction:SYSTem:OPTions?

Parameter
Type
Parameter
Range
ReturnNone

Default

None

Menu

System > System Info

Example:SYSTem:OPTions?

CommandFormatInstruction:SYSTem:POWer:OFF

Parameter
Type
Parameter
Range
ReturnNone

Default

None

Menu

None

Example:SYSTem:POWer:OFF

CommandFormatInstruction:SYSTem:CONFigure:SYSTem?

Parameter
Type
Parameter
Range
ReturnNoneThis command returns a list of the options that are installed.

None
Meas|EMI|TG|DMA|DTF|VNA

Uses this command to turn off the instrument.

None
None

Uses this command to query the system message of the instrument.

None
String

Programming Guide

21

SIGLENT
Default

None

Menu

System > System Info

Example:SYSTem:CONFigure:SYSTem?

3.3 Memory Subsystem:MMEMory:STORe:MMEMory:LOAD:MMEMory:DELete

CommandFormatInstruction:MMEMory:STORe STA|TRC|COR|CSV|LIM|JPG|BMP|PNG, ”<file>”

Parameter
Type
Parameter
Range
ReturnStringDefault

None

Menu

File > Save

Example:MMEMory:STORe STA,”ABC.sta”

CommandFormatInstruction:MMEMory:LOAD STA|TRC|COR|LIM, ”<file>”

Parameter
Type
Parameter
Range
ReturnStringDefault

None

Menu

File > Open/Load

Example:MMEMory:LOAD STA, ”ABC.sta”

CommandFormatInstruction:MMEMory:DELete ”<file>”

Parameter
Type
Parameter
Range

String

22

Stores file.

None
None

Loads file.

None
None

Deletes file or folder.

None

Programming GuideSIGLENT
ReturnNone

Default

None

Menu

File > Operate > Delete

Example:MMEMory:DELete ”ABC.sta”

3.4 Display Subsection:DISPlay:WINDow:TRACe:GRATicule:GRID:BRIGhtness:DISPlay:WINDow:TRACe:Y:DLINe:STATe:DISPlay:WINDow:TRACe:Y:DLINe

CommandFormatInstruction
Parameter
Type
Parameter
Range
Return:DISPlay:WINDow:TRACe:GRATicule:GRID:BRIGhtness <value>:DISPlay:WINDow:TRACe:GRATicule:GRID:BRIGhtness?
Sets grid brightness.
Gets grid brightness.
Integer0 ~ 100
Integer

Default

30%

Menu

Display > Grid Brightness

Example:DISPlay:WINDow:TRACe:GRATicule:GRID:BRIGhtness 50

CommandFormatInstruction:DISPlay:WINDow:TRACe:Y:DLINe:STATe OFF|ON|0|1:DISPlay:WINDow:TRACe:Y:DLINe:STATe?
Toggles the display line between on and off.
Gets the display line state.
Enumeration

Parameter
Type
Parameter
Range
ReturnOFF|ON|0|1
0|1

Default

OFF

Menu

Display > Display Line

Example:DISPlay:WINDow:TRACe:Y:DLINe:STATe ON

CommandFormatInstruction:DISPlay:WINDow:TRACe:Y:DLINe <value>:DISPlay:WINDow:TRACe:Y:DLINe?
Sets the amplitude value for the display line.
Gets the amplitude value for the display line.
Float, unit: dBm

Parameter

Programming Guide

23

SIGLENTType
Parameter
Range
ReturnRef Level ~ Ref Level - 100 dBm

Default

0 dBm

Menu

Display > Display Line

Example:DISPlay:WINDow:TRACe:Y:DLINe -10

Float, unit: dBm

3.5 Mode Subsection:INSTrument[:SELect]

CommandFormatInstruction:INSTrument[:SELect] SA|MA|DTF|VNA:INSTrument[:SELect]?
Sets instrument mode.

Parameter
Type
Parameter
Range

Enumeration

Return

SA: Spectrum Analyzer
MA: Modulation Analyzer
DTF: Distance To Fault
VNA: Vector Network Analyzer
Enumeration

Default

SA

Menu

mode

Example:INSTrument DTF

24

Programming GuideSIGLENT

4.Spectrum Analyzer
Frequency Subsection
Amplitude Subsection
Sweep Subsection
Trigger Subsystem
Bandwidth Subsection
Trace Subsection
Marker Subsection
Limit Subsection
Measurement Subsystem
TG Subsystem
Demod Subsystem

4.1 Frequency Subsection[:SENSe]:FREQuency:CENTer[:SENSe]:FREQuency:STARt[:SENSe]:FREQuency:STOP[:SENSe]:FREQuency:CENTer:STEP[:INCRement][:SENSe]:FREQuency:CENTer:STEP:AUTO[:SENSe]:FREQuency:CENTer:SET:STEP[:SENSe]:FREQuency:OFFSet[:SENSe]:FREQuency:SPAN[:SENSe]:FREQuency:SPAN:FULL[:SENSe]:FREQuency:SPAN:ZERO[:SENSe]:FREQuency:SPAN:PREVious[:SENSe]:FREQuency:SPAN:HALF[:SENSe]:FREQuency:SPAN:DOUBle

Programming Guide

25

SIGLENT
CommandFormatInstruction
Parameter
Type
Parameter
Range
Return[:SENSe]:FREQuency:CENTer <freq>[:SENSe]:FREQuency:CENTer?
Sets the center frequency of the spectrum analyzer.
Gets the center frequency.
Float, unit: Hz, kHz, MHz, GHz
50 Hz~3.199999950 GHz
Zero Span: 0 ~ 3.2 GHz
Float, unit: Hz

Default

1.6 GHz

Menu

Frequency > Center Freq

Example:FREQuency:CENTer 0.2 GHz

CommandFormatInstruction[:SENSe]:FREQuency:STARt <freq>[:SENSe]:FREQuency:STARt?
Sets the start frequency of the spectrum analyzer.
Gets the start Frequency.
Float, unit: Hz, kHz, MHz, GHz

Parameter
Type
Parameter
Range
Return0 Hz ~ 3.199999900 GHz
Zero Span: 0 ~ 3.2 GHz
Float, unit: Hz

Default

0 Hz

Menu

Frequency > Start Freq

Example:FREQuency:STARt 100 Hz

CommandFormatInstruction[:SENSe]:FREQuency:STOP <freq>[:SENSe]:FREQuency:STOP?
Sets the stop frequency of the spectrum analyzer.
Gets the stop frequency.
Float, unit: Hz, kHz, MHz, GHz

Parameter
Type
Parameter
Range
Return100 Hz ~ 3.2 GHz
Zero Span: 0 ~ 3.2 GHz
Float, unit: Hz

Default

1.5 GHz

Menu

Frequency > Stop Freq

Example:FREQuency:STOP 1.0 GHz

CommandFormatInstruction[:SENSe]:FREQuency:CENTer:STEP[:INCRement] <freq>[:SENSe]:FREQuency:CENTer:STEP[:INCRement]?
Specifies the center frequency step size.
Gets the center frequency step.
Float, unit: Hz, kHz, MHz, GHz

Parameter
Type
26

Programming GuideSIGLENT
Parameter
Range
Return1 Hz ~ 3.2 GHz

Default

320 MHz

Menu

Frequency > Freq Step

Example:FREQuency:CENTer:STEP 2 MHz

CommandFormatInstruction[:SENSe]:FREQuency:CENTer:STEP:AUTO OFF|ON|0|1[:SENSe]:FREQuency:CENTer:STEP:AUTO?
Specifies whether the step size is set automatically based on the span.
Gets center frequency step mode.
BooleanParameter
Type
Parameter
Range
ReturnFloat, unit: Hz

OFF|ON|0|1
0|1

DefaultON

Menu

Frequency > Freq Step

Example:FREQuency:CENTer:STEP:AUTO OFF

CommandFormatInstruction[:SENSe]:FREQuency:CENTer:SET:STEP

Parameter
Type
Parameter
Range
ReturnNone

Default

None

Menu

Frequency > CF→Step

Example:FREQuency:CENTer:SET:STEP

CommandFormatInstruction[:SENSe]:FREQuency:OFFSet <freq>[:SENSe]:FREQuency:OFFSet?
Sets the frequency offset of the spectrum analyzer.
Gets the frequency offset.
Float, unit: Hz, kHz, MHz, GHz

Parameter
Type
Parameter
Range
ReturnDefault

Sets step value equal to center frequency.

None
None

-100 GHz ~ 100 GHz
Float, unit: Hz
0 Hz

Programming Guide

27

SIGLENT
Menu

Frequency > Freq Offset

Example:FREQuency:OFFSet 1 GHz

CommandFormatInstruction[:SENSe]:FREQuency:SPAN <freq>[:SENSe]:FREQuency:SPAN?
Sets the frequency span. Setting the span to 0 Hz puts the analyzer into zero span.
Gets span value.
Float, unit: Hz, kHz, MHz, GHz

Parameter
Type
Parameter
Range
Return0 Hz, 100 Hz ~ 3.2GHz
Float, unit: Hz

Default

1.5 GHz

Menu

Span > Span

Example:FREQuency:SPAN 1 GHz

CommandFormatInstruction[:SENSe]:FREQuency:SPAN:FULL

Parameter
Type
Parameter
Range
ReturnNone

Default

None

Menu

Span > Full Span

Example:FREQuency:SPAN:FULL

CommandFormatInstruction[:SENSe]:FREQuency:SPAN:ZERO

Parameter
Type
Parameter
Range
ReturnNone

Default

None

Menu

Span > Zero Span

Example:FREQuency:SPAN:ZERO

28

Sets the frequency span to full scale.

None
None

Sets the frequency span to zero span.

None
None

Programming GuideSIGLENT
CommandFormatInstruction[:SENSe]:FREQuency:SPAN:PREVious

Parameter
Type
Parameter
Range
ReturnNone

Default

None

Menu

Span > Last Span

Example:FREQuency:SPAN:PREVious

CommandFormatInstruction[:SENSe]:FREQuency:SPAN:HALF

Parameter
Type
Parameter
Range
ReturnNone

Default

None

Menu

Span > Zoom In

Example:FREQuency:SPAN:HALF

CommandFormatInstruction[:SENSe]:FREQuency:SPAN:DOUBle

Parameter
Type
Parameter
Range
ReturnNone

Default

None

Menu

Span > Zoom Out

Example:FREQuency:SPAN:DOUBle

Sets the frequency span to the previous span setting.

None
None

Sets the frequency span to half of the current span setting.

None
None

Sets the frequency span to double the current span setting.

None
None

4.2 Amplitude Subsection:DISPlay:WINDow:TRACe:Y[:SCALe]:RLEVel[:SENSe]:POWer[:RF]:ATTenuation[:SENSe]:POWer[:RF]:ATTenuation:AUTO

Programming Guide

29

SIGLENT[:SENSe]:POWer[:RF]:GAIN[:STATe]:DISPlay:WINDow:TRACe:Y:SCALe:RLEVel:OFFSet:UNIT:POWer:DISPlay:WINDow:TRACe:Y[:SCALe]:SPACing:DISPlay:WINDow:TRACe:Y[:SCALe]:PDIVision[:SENSe]:CORRection:OFF[:SENSe]:CORRection:CSET:ALL[:STATe][:SENSe]:CORRection:CSET[1]|2|3|4[:STATe][:SENSe]:CORRection:CSET[1]|2|3|4:ADD[:SENSe]:CORRection:CSET[1]|2|3|4:DELete[:SENSe]:CORRection:CSET[1]|2|3|4:ALL:DELete[:SENSe]:CORRection:CSET[1]|2|3|4:DATA[:SENSe]:CORRection:IMPedance[:INPut][:MAGNitude]

CommandFormatInstruction
Parameter
Type
Parameter
Range:DISPlay:WINDow:TRACe:Y[:SCALe]:RLEVel <value>:DISPlay:WINDow:TRACe:Y[:SCALe]:RLEVel?
This command sets the reference level for the Y-axis.
Gets reference level.
Float, unit: dBm, dBmV, dBuV, dBuA, V, W

ReturnUnit is dBm: -100 dBm ~ 30 dBm
Unit is dBmV: -53.01 dBmV ~ 76.99 dBmV
Unit is dBuV: 6.99 dBuV ~ 136.99 dBuV
Unit is dBuA: -26.99 dBuA ~ 103.01 dBuA
Unit is Volts: 2.24 uV ~ 7.07 V
Unit is Watts: 100 fW ~ 1 W
Float, unit: dBm

Default

0 dBm

Menu

Amplitude > Ref Level

Example:DISPlay:WINDow:TRACe:Y:RLEVel 20 DBM

CommandFormatInstruction[:SENSe]:POWer[:RF]:ATTenuation <value>[:SENSe]:POWer[:RF]:ATTenuation?
Sets the input attenuator of the spectrum analyzer.
Gets the input attenuator.
IntegerParameter
Type
Parameter
Range
Return0 dB ~ 51 dB
Integer, unit: dB

Default

20 dB

Menu

Amplitude > Attenuator

30

Programming GuideSIGLENT
Example:POWer:ATTenuation 10

CommandFormatInstruction[:SENSe]:POWer[:RF]:ATTenuation:AUTO OFF|ON|0|1[:SENSe]:POWer[:RF]:ATTenuation:AUTO?
This command turns on/off auto input port attenuator state.
Gets input port attenuator state.
BooleanParameter
Type
Parameter
Range
ReturnOFF|ON|0|1
0|1

Default

ON

Menu

Amplitude > Attenuator

Example:POWer:ATTenuation:AUTO?

CommandFormatInstruction[:SENSe]:POWer[:RF]:GAIN[:STATe] OFF|ON|0|1[:SENSe]:POWer[:RF]:GAIN[:STATe]?
Turns the internal preamp on/off.
Gets preamp on-off state.
BooleanParameter
Type
Parameter
Range
ReturnOFF|ON|0|1
0|1

Default

OFF

Menu

Amplitude > Preamp

Example:POWer:GAIN ON

CommandFormatInstruction:DISPlay:WINDow:TRACe:Y:SCALe:RLEVel:OFFSet <value>:DISPlay:WINDow:TRACe:Y:SCALe:RLEVel:OFFSet?
Sets reference offsets.
Gets reference offsets.
Float

Parameter
Type
Parameter
Range
Return-100dB~100dB
Float, unit: dB

Default

0dB

Menu

Amplitude > Ref OffSets

Example:DISPlay:WINDow:TRACe:Y:SCALe:RLEVel:OFFSet 2

Programming Guide

31

SIGLENT
CommandFormatInstruction
Parameter
Type
Parameter
Range
Return:UNIT:POWer DBM|DBMV|DBUV|V|W:UNIT:POWer?
Specifies amplitude units for the input, output and display.
Gets amplitude units.
Enumeration
DBM|DBMV|DBUV|DBUA|V|W,
Enumeration

Default

DBM

Menu

Amplitude > Units

Example:UNIT:POWer DBMV

CommandFormatInstruction:DISPlay:WINDow:TRACe:Y[:SCALe]:SPACing LINear|LOGarithmic:DISPlay:WINDow:TRACe:Y[:SCALe]:SPACing?
Toggles the vertical graticule divisions between logarithmic unit and linear unit. The
default logarithmic unit is dBm, and the linear unit is V.
Gets scale type.
Enumeration

Parameter
Type
Parameter
Range
ReturnLINear|LOGarithmic
Enumeration

Default

LOGarithmic

Menu

Amplitude > Scale Type

Example:DISPlay:WINDow:TRACe:Y:SPACing LINear

CommandFormatInstruction:DISPlay:WINDow:TRACe:Y[:SCALe]:PDIVision <integer>:DISPlay:WINDow:TRACe:Y[:SCALe]:PDIVision?
This command sets the per-division display scaling for the y-axis when scale type of Y
axis is set to Log.
Gets Scale/Div when scale type of Y axis is set to Log.
Float

Parameter
Type
Parameter
Range
Return1 dB ~ 10 dB
Float, unit: dB

Default

10 dB

Menu

Amplitude > Scale/Div

Example:DISPlay:WINDow:TRACe:Y:PDIVision 10 dB

CommandFormatInstruction[:SENSe]:CORRection:OFF

32

Turns off the amplitude correction function off and all of the correction sets are off.

Programming GuideSIGLENT
Parameter
Type
Parameter
Range
ReturnNone

Default

None

Menu

None

Example:SENSe:CORRection:OFF

CommandFormatInstruction[:SENSe]:CORRection:CSET:ALL[:STATe] OFF|ON|0|1[:SENSe]:CORRection:CSET:ALL[:STATe]?
Turns on or off the amplitude corrections.
When turned on, only the correction sets that were turned on are enabled. When turned off,
all of the correction Sets are disabled. If there is no correction enabled, state cannot be set
to on.
BooleanParameter
Type
Parameter
Range
ReturnNone
None

OFF|ON|0|1
0|1

Default

OFF

Menu

Amplitude > Corrections > Apply Corrections

Example:SENSe:CORRection:CSET:ALL:STATe OFF

CommandFormatInstruction[:SENSe]:CORRection:CSET[1]|2|3|4[:STATe][:SENSe]:CORRection:CSET[1]|2|3|4[:STATe]?
Turns the amplitude correction function on/off.
Gets the amplitude correction function state.
None

Parameter
Type
Parameter
Range
ReturnNone
0|1

Default

OFF

Menu

Amplitude > Corrections > Correction1|2|3|4

Example:CORRection:CSET2:OFF

CommandFormatInstruction[:SENSe]:CORRection:CSET[1]|2|3|4:ADD <x1,y1,x2,y2;…>Parameter
Type
Parameter
Range

String<freq, ampl,freq, ampl,freq, ampl,……>Adds Correction Points.

None

Programming Guide

33

SIGLENT
ReturnDefault

None

Menu

Amplitude > Corrections > CorrectionX > Add Point

Example:CORRection:CSET2:ADD 10000000,-10,15000000,-12

CommandFormatInstruction[:SENSe]:CORRection:CSET[1]|2|3|4:DELete <index>

Parameter
Type
Parameter
Range
ReturnSerial number of Correction Points

Default

None

Menu

Amplitude > Corrections > CorrectionX > Del Point

Example:CORRection:CSET2: DELete 2

CommandFormatInstruction[:SENSe]:CORRection:CSET[1]|2|3|4:ALL:DELete

Parameter
Type
Parameter
Range
ReturnNone

Default

None

Menu

Amplitude > Corrections > CorrectionX > Del All

Example:CORRection:CSET2: ALL:DELete

CommandFormatInstruction[:SENSe]:CORRection:CSET[1]|2|3|4:DATA <x1,y1,x2,y2;…>[:SENSe]:CORRection:CSET[1]|2|3|4:DATA?
Sets correction X data.
Reads correction X data.
None

Parameter
Type
Parameter
Range
ReturnDefault

34

Deletes Correction Points.

None

Deletes All Correction Points.

None
None

None
String
None

Programming GuideSIGLENT
Menu

None

Example:CORRection:CSET2:DATA?

CommandFormatInstruction[:SENSe]:CORRection:IMPedance[:INPut][:MAGNitude] OHM50 |OHM75[:SENSe]:CORRection:IMPedance[:INPut][:MAGNitude]?
Sets the input impedance for voltage-to-power conversions.
Gets the input impedance.
Enumeration

Parameter
Type
Parameter
Range
Return

OHM50|OHM75
OHM50|OHM75

Default

OHM50

Menu

Amplitude > Corrections

ExampleCORRection:IMPedance?

4.3 Sweep Subsection[:SENSe]:SWEep:MODE[:SENSe]:SWEep:TIME[:SENSe]:SWEep:TIME:AUTO[:SENSe]:SWEep:SPEed[:SENSe]:SWEep:COUNt[:SENSe]:QPD:DWELl:TIME:INITiate[:IMMediate]:INITiate:RESTart:INITiate:CONTinuous:INITiate:Pause:INITiate:RESume
ABORt

CommandFormatInstruction
Parameter
Type
Parameter
Range
ReturnDefault[:SENSe]:SWEep:MODE AUTO|FFT|SWEep[:SENSe]:SWEep:MODE?
Sets sweep mode.
Gets sweep mode.
Enumeration
AUTO|FFT|SWEep
Enumeration
SWEep

Programming Guide

35

SIGLENT
Menu

Sweep

Example:SWEep:MODE SWEep

CommandFormatInstruction[:SENSe]:SWEep:TIME <time>[:SENSe]:SWEep:TIME?
Specifies the time in which the instrument sweeps the display. A span value of 0 Hz causes
the analyzer to enter zero span mode. In zero span the X-axis represents time rather thanfrequency.
Float, unit: ks, s, ms, us

Parameter
Type
Parameter
Range
Return450us ~ 1500 s
Float, unit: sDefault

312.416ms(216.288ms, 192.256ms, 168.224ms, 120.160ms)

Menu

Sweep > Sweep Time

Example:SWEep:TIME 5s

CommandFormatInstruction[:SENSe]:SWEep:TIME:AUTO OFF|ON|0|1[:SENSe]:SWEep:TIME:AUTO?
This command turns on/off auto sweep time state.

Parameter
Type
Parameter
Range
ReturnBooleanDefault

ON

Menu

Sweep > Sweep Time

Example:SWEep:TIME:AUTO ON

CommandFormatInstruction[:SENSe]:SWEep:SPEed NORMal|ACCUracy[:SENSe]:SWEep:SPEed?
Toggles the sweep speed between normal and accuracy.

Parameter
Type
Parameter
Range
ReturnEnumeration

Default

NORMalMenu

Sweep > Sweep Rule

Example:SWEep: SPEed NORMal

36

OFF|ON|0|1
0|1

ACCUracy|NORMal
Enumeration

Programming GuideSIGLENT

CommandFormatInstruction
Parameter
Type
Parameter
Range
Return[:SENSe]:SWEep:COUNt <integer>[:SENSe]:SWEep:COUNt?
Sets sweep numbers, when single sweep on.
Gets sweep numbers, when single sweep on.
Integer
1 ~ 99999
Integer

Default

1

Menu

Sweep > Numbers

Example:SWEep:COUNt 10

CommandFormatInstruction[:SENSe]:QPD:DWELl:TIME < time >[:SENSe]:QPD:DWELl:TIME?
Sets QPD Time.
Gets QPD Time.
Float, unit: s, ms, us

Parameter
Type
Parameter
Range
Return0 us ~ 10 s(qusai-peak: 900 us ~ 30 ks)
Float, unit: sDefault

50 ms

Menu

Sweep > QPD Time

Example:QPD:DWELl:TIME 10s

CommandFormatInstruction:INITiate[:IMMediate]Parameter
Type
Parameter
Range
ReturnNone

Default

None

Restarts the current sweep.

None
None

Menu
Example:INITiate:IMMediate

CommandFormatInstruction:INITiate:RESTart

Parameter

Restarts the current sweep.
:INITiate:RESTart and :INITiate:IMMediate perform exactly the same function.
None

Programming Guide

37

SIGLENTType
Parameter
Range
ReturnNone

Default

None

None

Menu
Example:INITiate:RESTart

CommandFormatInstruction:INITiate:CONTinuous OFF|ON|0|1:INITiate:CONTinuous?
Sets continuous sweep mode on-off.
Gets continuous sweep mode state.
BooleanParameter
Type
Parameter
Range
ReturnOFF|ON|0|1
0|1

Default

ON

Menu

Sweep > Sweep

Example:INITiate:CONTinuous OFF

CommandFormatInstruction:INITiate:Pause

Parameter
Type
Parameter
Range
ReturnNone

Default

None

Pause current sweeep(pause at the end of the current sweep).

None
None

Menu
Example:INITiate:Pause

CommandFormatInstruction:INITiate:RESume

Parameter
Type
Parameter
Range
ReturnNone

38

Resumes paused sweep.

None
None

Programming GuideSIGLENT
Default

None

Menu
Example:INITiate:RES

CommandFormatInstruction

ABORt
This command is used to stop the current measurement. It aborts the currentmeasurement
as quickly as possible, resets the sweep and trigger systems, and puts the measurement into
an "idle" state.
If the analyzer is set for Continuous measurement, it sets up the measurement and initiates
a new data measurement sequence with a new data acquisition (sweep) taken once thetrigger condition is met.

Parameter
Type
Parameter
Range
ReturnIf the analyzer is set for Single measurement, it remains in the "idle" state until
an :INIT:IMM command is received.
None
None
None

Default

None

Menu

None

Default

ABORt

4.4 Trigger Subsystem:TRIGger[:SEQuence]:SOURce:TRIGger[:SEQuence]:VIDeo:LEVel:TRIGger[:SEQuence]:RFBurst:SLOPe

CommandFormatInstruction
Parameter
Type
Parameter
Range:TRIGger[:SEQuence]:SOURce IMMediate|VIDeo|EXTernal:TRIGger[:SEQuence]:SOURce?
Specifies the source (or type) of triggering used to start a measurement.
Gets trigger type.
Enumeration

ReturnIMMediate: free-run triggering.
VIDeo: triggers on the video signal level.
EXTernal: allows you to connect an external trigger source.
Enumeration

Default

IMMediate

Menu

Trigger

Example:TRIGger:SOURce IMMediate

Programming Guide

39

SIGLENT

CommandFormatInstruction

Parameter
Type
Parameter
Range:TRIGger[:SEQuence]:VIDeo:LEVel <value>:TRIGger[:SEQuence]:VIDeo:LEVel?
Specifies the level at which a video trigger will occur. Video is adjusted using thiscommand, but must also be selected using the command.
Gets video Trigger Level.
Float, unit: dBm, dBmV, dBuV, dBuA, V, W

ReturnUnit is dBm: -300 dBm ~ 50 dBm
Unit is dBmV: -253.01 dBmV ~ 96.99 dBmV
Unit is dBuV: -193.01 dBuV ~ 156.99 dBuV
Unit is dBuA: -226.99 dBuA ~ 123.01 dBuA
Unit is Volts: 223E-16V ~ 70.71 V
Unit is Watts: 1.00E-33 W ~ 100 W
Float, unit: dBm

Default

0 dBm

Menu

Trigger > Video Level

Example:TRIGger:VIDeo:LEVel 0.5 dBm

CommandFormatInstruction:TRIGger[:SEQuence]:RFBurst:SLOPe POSitive|NEGative:TRIGger[:SEQuence]:RFBurst:SLOPe?
This command activates the trigger condition that allows the next sweep to start when theexternal voltage (connected to EXT TRIG IN connector) passes through approximately 1.5
volts. The external trigger signal must be a 0V to +5V TTL signal. This function only
controls the trigger polarity (for positive or negative-going signals).
Gets Trigger edge.
Enumeration

Parameter
Type
Parameter
Range
ReturnPOSitive: positive edge.
NEGative: negative edge.
Enumeration

Default

POSitive

Menu

Trigger > External Trigger

Example:TRIGger:RFBurst:SLOPe POSitive

4.5 Bandwidth Subsection[:SENSe]:BWIDth[:RESolution][:SENSe]:BWIDth[:RESolution]:AUTO[:SENSe]:BWIDth:VIDeo[:SENSe]:BWIDth:VIDeo:AUTO[:SENSe]:BWIDth:VIDeo:RATio[:SENSe]:BWIDth:VIDeo:RATio:CONfig?
[:SENSe]:FILTer:TYPE

40

Programming GuideSIGLENT

CommandFormatInstruction

Parameter
Type
Parameter
Range
Return[:SENSe]:BWIDth[:RESolution] <freq>[:SENSe]:BWIDth[:RESolution]?
Specifies the resolution bandwidth. For numeric entries, all RBW types choose the nearest(arithmetically, on a linear scale, rounding up) available RBW to the value entered.
Gets the resolution bandwidth.
Discrete
1Hz, 3Hz, 10 Hz, 30 Hz, 100 Hz, 300 Hz, 1 kHz, 3 kHz, 10 kHz, 30 kHz, 100 kHz, 300
kHz, 1 MHz
Float, unit: Hz

Default

1 MHz

Menu

BW > RBW

Example:BWIDth 1 kHz

CommandFormatInstruction[:SENSe]:BWIDth[:RESolution]:AUTO OFF|ON|0|1[:SENSe]:BWIDth[:RESolution]:AUTO?
Turns on/off auto resolution bandwidth state.
Gets the resolution bandwidth state.
BooleanParameter
Type
Parameter
Range
ReturnOFF|ON|0|1
0|1

DefaultON

Menu

BW > RBW

Example:BWID:AUTO On

CommandFormatInstruction[:SENSe]:BWIDth:VIDeo <freq>[:SENSe]:BWIDth:VIDeo?
Specifies the video bandwidth.
Gets the video bandwidth.
Discrete

Parameter
Type
Parameter
Range
Return1 Hz, 3 Hz, 10 Hz, 30 Hz, 100 Hz, 300 Hz, 1 kHz, 3 kHz, 10 kHz, 30 kHz, 100 kHz, 300
kHz, 1 MHz
Float, unit: Hz

Default

1 MHz

Menu

BW > VBWExample:BWIDth:VIDeo 10 KHZ

CommandFormatInstruction[:SENSe]:BWIDth:VIDeo:AUTO OFF|ON|0|1[:SENSe]:BWIDth:VIDeo:AUTO?
This command turns on/off auto video bandwidth state.
Gets the video bandwidth state.

Programming Guide

41

SIGLENT
Parameter
Type
Parameter
Range
ReturnBooleanDefaultON

Menu

BW > VBWExampleBWIDth:VIDeo:AUTO OFF

CommandFormatInstruction[:SENSe]:BWIDth:VIDeo:RATio <number>[:SENSe]:BWIDth:VIDeo:RATio?
Specifies the ratio of the video bandwidth to the resolution bandwidth.
Gets the ratio of the video bandwidth to the resolution bandwidth.
Discrete, Float

Parameter
Type
Parameter
Range
ReturnOFF|ON|0|1
0|1

0.001, 0.003, 0.01, 0.03, 0.1, 0.3, 1.0, 3.0, 10.0, 30.0, 100.0, 300.0, 1000.0
Float

Default

1.0

Menu

BW > VBW/RBW

Example:BWIDth:VIDeo:RATio 30

CommandFormatInstruction[:SENSe]:BWIDth:VIDeo:RATio:CONfig?

Parameter
Type
Parameter
Range
ReturnNone

Default

1

Menu

None

Example:BWIDth:VIDeo:RATio:CONfig?

CommandFormatInstruction[:SENSe]:FILTer:TYPE EMI|GAUSS[:SENSe]:FILTer:TYPE?
Sets filter type
Gets filter type
Enumeration

Parameter
Type
Parameter
Range
Return42

This command turns on/off auto video to resolution bandwidth ratio.

None
0|1

EMI|GAUSS
Enumeration

Programming GuideSIGLENT
Default

GAUSS

Menu

BW > Filter

Example:FILTer:TYPE EMI

4.6 Trace Subsection:TRACe[1]|2|3|4:MODE:TRACe[:DATA]?
:FORMat[:TRACe][:DATA]:CALCulate[:SELected]:MATH:FUNCtion:TRACe:MATH:X:TRACe:MATH:Y:TRACe:MATH:Z:TRACe:MATH:OFFSet[:SENSe]:FREQuency:TUNE:IMMediate[:SENSe]:DETector:TRACe[1]|2|3|4[:FUNCtion][:SENSe]:AVERage:TYPE[:SENSe]:AVERage:TRACe[1]|2|3|4:COUNt[:SENSe]:AVERage:TRACe[1]|2|3|4?
[:SENSe]:AVERage:TRACe[1]|2|3|4:CLEar

CommandFormatInstruction
Parameter
Type
Parameter
Range:TRACe[1]|2|3|4:MODE WRITe|MAXHold|MINHold|VIEW|BLANk|AVERage:TRACe[1]|2|3|4:MODE?
Selects the display mode for the selected trace.
Gets the display mode of the seletcted trace.
Enumeration

Return

WRITe: puts the trace in the normal mode, updating the data.
MAXHold: displays the highest measured trace value for all the data that has beenmeasured since the function was turned on.
MINHold: displays the lowest measured trace value for all the data that has been measured
since the function was turned on.
VIEW: turns on the trace data so that it can be viewed on the display.
BLANk: turns off the trace data so that it is not viewed on the display.
AVERage: averages the trace for test period.
Enumeration

Default

Trace1:WRITe, Trace2|3|4: BLANk

Menu

Trace

Example:TRAC1:MODE VIEW

Programming Guide

43

SIGLENT
CommandFormatInstruction

Parameter
Type
Parameter
Range
Return:TRACe[:DATA]? 1|2|3|4
This query command returns the current displayed data.
You can also add trace parameters directly after trace as:TRACe[1]|2|3|4[:DATA]?
Enumeration
1|2|3|4 or A|B|C|D or TRACE1| TRACE2| TRACE3| TRACE4
StringDefault

1

Menu

None

Example:TRACe:DATA? 1

CommandFormatInstruction:FORMat[:TRACe][:DATA] ASCii|REAL,32|REAL,64:FORMat[:TRACe][:DATA]?
Sets trace data type.
Gets trace data type.
Enumeration

Parameter
Type
Parameter
Range

ReturnASCii
REAL,32 Binary 32-bit real values in the current Y Axis Unit, in a definite
length block.
REAL,64 Binary 64-bit real values in the current Y Axis Unit, in a definite
length block.
You can also use the following parameters
REAL32: Binary 32-bit real values in the current Y Axis Unit, in a definite
length block.
REAL: Binary 64-bit real values in the current Y Axis Unit, in a definite
length block.
StringDefault

ASCii

Menu

None

Example:FORMat ASCii

CommandFormatInstruction:CALCulate[:SELected]:MATH:FUNCtion:CALCulate[:SELected]:MATH:FUNCtion?
Sets trace math function.
Gets trace data function.
Enumeration

Parameter
Type
Parameter
Range

ReturnOFF: Trace Math Off
PDIF : Power Diff
PSUM : Power Sum
LOFF : Log Offset
LDIF : Log Diff
Enumeration

Default

OFF

44

Programming GuideSIGLENT
Menu

Trace > Math

Example:CALCulate[:SELected]:MATH:FUNCtion?

CommandFormatInstruction:TRACe:MATH:X A|B|C|D:TRACe:MATH:X?
Sets trace math input X.
Gets trace math input X.
Enumeration

Parameter
Type
Parameter
Range
Return

A|B|C|D or TRACE1|TRACE2|TRACE3|TRACE4
Enumeration

Default

A

Menu

Trace > Math > Input X

Example:TRACe:MATH:X A

CommandFormatInstruction:TRACe:MATH:Y A|B|C|D:TRACe:MATH:Y?
Sets trace math input Y.
Gets trace math input Y.
Enumeration

Parameter
Type
Parameter
Range
Return

A|B|C|D or TRACE1|TRACE2|TRACE3|TRACE4
Enumeration

Default

A

Menu

Trace > Math > Input Y

Example:TRACe:MATH:Y A

CommandFormatInstruction:TRACe:MATH:Z A|B|C|D:TRACe:MATH:Z?
Sets trace math Output Z.
Gets trace math Output Z.
Enumeration

Parameter
Type
Parameter
Range
Return

A|B|C|D or TRACE1|TRACE2|TRACE3|TRACE4
Enumeration

Default

A

Menu

Trace > Math > Output Z

Example:TRACe:MATH:Z A

Programming Guide

45

SIGLENT
CommandFormatInstruction
Parameter
Type
Parameter
Range
Return:TRACe:MATH:OFFSet <const>:TRACe:MATH:OFFSet?
Sets trace math OFFSet.
Gets trace math OFFSet.
Float-100 dB ~100 dB
Float

Default

0.00 dB

Menu

Trace > Math

Example:TRACe:MATH:OFFSet 7

CommandFormatInstruction[:SENSe]:FREQuency:TUNE:IMMediate

Parameter
Type
Parameter
Range
ReturnNone

Default

None

Menu

Auto Tune

Example:FREQuency:TUNE:IMMediate

CommandFormat[:SENSe]:DETector:TRACe[1]|2|3|4[:FUNCtion]
NEGative|POSitive|SAMPle|AVERage|NORMAL|QUASi[:SENSe]:DETector:TRACe[1]|2|3|4[:FUNCtion]?
Specifies the detection mode. For each trace interval (bucket), average detection displays
the average of all the samples within the interval.
Gets the detection mode.
Enumeration

Instruction

Parameter
Type
Parameter
Range

46

Auto tune the spectrum analyzer parameter to display the main signal.

None
None

NEGative: Negative peak detection displays the lowest sample taken during the intervalbeing displayed.
POSitive: Positive peak detection displays the highest sample taken during the intervalbeing displayed.
SAMPle: Sample detection displays the sample taken during the interval being
displayed, and is used primarily to display noise or noise-like signals.
In sample mode, the instantaneous signal value at the present display point is placed intomemory. This detection should not be used to make the most accurate amplitude
measurement of non noise-like signals.
AVERage: Average detection is used when measuring the average value of theamplitude across each trace interval (bucket). The averaging method used by the average
detector is set to either video or power as appropriate when the average type is auto
coupled.
NORMAL: Normal detection selects the maximum and minimum video signal values
alternately. When selecting Normal detection,”Norm”appears in the upper-left corner.
QUASi: Quasipeak detection is a form of detection where a signal level is weighted
Programming GuideSIGLENT

Returnbased on the repetition frequency of the spectral components making up the signal. That
is to say, the result of a quasi-peak measurement depends on the repetition rate of thesignal.
Enumeration

Default

POSitive

Menu

DetectExample:DETector:TRACe QUAS

CommandFormatInstruction[:SENSe]:AVERage:TYPE LOGPower|POWer|VOLTage[:SENSe]:AVERage:TYPE?
Toggles the average type between Log power, power and voltage.

Parameter
Type
Parameter
Range
ReturnEnumeration

Default

LOGPower

Menu

BW > Avg Type

ExampleAVERage:TYPE VOLTage

CommandFormatInstruction[:SENSe]:AVERage:TRACe[1]|2|3|4:COUNt <integer>[:SENSe]:AVERage:TRACe[1]|2|3|4:COUNt?
Specifies the number of measurements that are combined.
Gets the number of measurements that are combined.
IntegerParameter
Type
Parameter
Range
ReturnLOGPower|POWer|VOLTage
Enumeration

1 ~ 999
Integer

Default

1

Menu

Trace > Average

Example:AVERage:TRACe1:COUNt 10

CommandFormatInstruction[:SENSe]:AVERage:TRACe[1]|2|3|4?

Parameter
Type
Parameter
Range
ReturnNone

Default

None

Get the current average number of traces.

None
None

Programming Guide

47

SIGLENT
Menu

None

Example:AVERage:TRACe?

CommandFormatInstruction[:SENSe]:AVERage:TRACe[1]|2|3|4:CLEar

Parameter
Type
Parameter
Range
ReturnNone

Default

None

Menu

None

Example:AVERage:TRAC1:CLEar

Restarts the trace average. This command is only available when average is on.

None
None

4.7 Marker Subsection:CALCulate:MARKer[1]|2|3|4|5|6|7|8:STATe:CALCulate:MARKer:AOFF:CALCulate:MARKer[1]|2|3|4|5|6|7|8:MODE:CALCulate:MARKer[1]|2|3|4|5|6|7|8:TRACe:CALCulate:MARKer[1]|2|3|4|5|6|7|8:RELative:TO:MARKer:CALCulate:MARKer[1]|2|3|4|5|6|7|8:X:CALCulate:MARKer[1]|2|3|4|5|6|7|8:Y?
:CALCulate:MARKer:TABLe:CALCulate:MARKer[1]|2|3|4|5|6|7|8[:SET]:START:CALCulate:MARKer[1]|2|3|4|5|6|7|8[:SET]:STOP:CALCulate:MARKer[1]|2|3|4|5|6|7|8[:SET]:CENTer:CALCulate:MARKer[1]|2|3|4|5|6|7|8[:SET]:STEP:CALCulate:MARKer[1]|2|3|4|5|6|7|8[:SET]:RLEVel:CALCulate:MARKer[1]|2|3|4|5|6|7|8:DELTa[:SET]:SPAN:CALCulate:MARKer[1]|2|3|4|5|6|7|8:DELTa[:SET]:CENTer:CALCulate:MARKer:PEAK:SEARch:MODE:CALCulate:MARKer:PEAK:SORT:CALCulate:MARKer:PEAK:THReshold:CALCulate:MARKer:PEAK:EXCursion:CALCulate:MARKer:PEAK:TABLe

48

Programming GuideSIGLENT:CALCulate:PEAK:TABLe?
:CALCulate:MARKer[1]|2|3|4|5|6|7|8:CPEak[:STATe]:CALCulate:MARKer[1]|2|3|4|5|6|7|8:MAXimum:CALCulate:MARKer[1]|2|3|4|5|6|7|8:MAXimum:NEXT:CALCulate:MARKer[1]|2|3|4|5|6|7|8:MAXimum:LEFT:CALCulate:MARKer[1]|2|3|4|5|6|7|8:MAXimum:RIGHt:CALCulate:MARKer[1]|2|3|4|5|6|7|8:CPSearch:CALCulate:MARKer[1]|2|3|4|5|6|7|8:FUNCtion:CALCulate:MARKer:FCOunt[:STATe]:CALCulate:MARKer:FCOunt:X?
:CALCulate:MARKer[1]|2|3|4|5|6|7|8:BANDwidth:RESult?
:CALCulate:MARKer[1]|2|3|4|5|6|7|8:BANDwidth:NDB:CALCulate:MARKer[1]|2|3|4|5|6|7|8:X:READout:CALCulate:MARKer:TRCKing[:STATe]CommandFormatInstruction
Parameter
Type
Parameter
Range
Return:CALCulate:MARKer[1]|2|3|4|5|6|7|8:STATe OFF|ON|0|1:CALCulate:MARKer[1]|2|3|4|5|6|7|8:STATe?
This command toggles the selected marker state between on and off.
Gets marker state.
Boolean
OFF|ON|0|1
0|1

Default

OFF

Menu

MarkerExample:CALCulate:MARK1:STATe ON

CommandFormatInstruction:CALCulate:MARKer:AOFF

Parameter
Type
Parameter
Range
ReturnNone

Default

None

Menu

None

Example:CALCulate:MARKer:AOFF

Turns all the markers off.

None
None

Programming Guide

49

SIGLENT

CommandFormatInstruction
Parameter
Type
Parameter
Range:CALCulate:MARKer[1]|2|3|4|5|6|7|8:MODE POSition|DELTa|FIXed|OFF:CALCulate:MARKer[1]|2|3|4|5|6|7|8:MODE?
Selects the type of the selected marker that you want to activate.
Gets the type of the selected marker.
Enumeration

ReturnPOSition: selects a normal marker that can be positioned on a trace and from which trace
information will be generated.
DELTa: activates a pair of markers, one of which is fixed at the current marker location.
The other marker can then be moved around on the trace. The marker readout shows themarker value which moves.
FIXed: Active marker fixed at current position.
OFF: turns the designated marker off. If a marker is not active when the mode is queried,“off” will be returned.
Enumeration

Default

OFF

Menu

MarkerExample:CALCulate:MARK1:MODE POSition

CommandFormatInstruction:CALCulate:MARKer[1]|2|3|4|5|6|7|8:TRACe 1|2|3|4:CALCulate:MARKer[1]|2|3|4|5|6|7|8:TRACe?
This command assigns the specified marker to the designated trace 1, 2, 3 or 4.
Gets the specified marker to which trace.
Enumeration

Parameter
Type
Parameter
Range
Return

MARKer:1|2|3|4|5|6|7|8
TRACe:1|2|3|4
Enumeration

Default

1

Menu

Marker > Select Trace

ExampleCALCulate:MARK1:TRAC 1

CommandFormatInstruction:CALCulate:MARKer[1]|2|3|4|5|6|7|8:RELative:TO:MARKer 1|2|3|4|5|6|7|8:CALCulate:MARKer[1]|2|3|4|5|6|7|8:RELative:TO:MARKer?
Sets marker relative to.
Gets marker relative to.
Enumeration

Parameter
Type
Parameter
Range
Return1|2|3|4|5|6|7|8
Enumeration

Default

1

Menu

Marker > Relative To

Example:CALCulate:MARKer1:RELative:TO:MARK 3

50

Programming GuideSIGLENT

CommandFormatInstruction

Parameter
Type
Parameter
Range
Return:CALCulate:MARKer[1]|2|3|4|5|6|7|8:X <para>:CALCulate:MARKer[1]|2|3|4|5|6|7|8:X?
This command positions the designated marker on its assigned trace at the specified trace
X value.
The value is in the X-axis units, which can be a frequency or time.
The query returns the current X value of the designated marker.
When the readout mode is frequency, the query returns the X value of the span of themarker in integer and the unit is “Hz”.
When the readout mode is time or period, the query returns the X value of the span of themarker in scientific notation and the unit is “s”.
Reference Command::CALCulate:MARKer[1]|2|3|4|5|6|7|8:X:READout
Frequency: Float, unit: Hz, kHz, MHz, GHz, Default “Hz”
Time: Float, unit: us, ms, s, ks, Default “s”
0 Hz ~ 1.5 GHz or 10 ms ~ 1000 s
Float

Default

750 MHz or 312.64 ms

Menu

Marker > Normal

Example:CALCulate:MARKer4:X 0.4 GHz:CALCulate:MARKer4:X 200 ms:CALCulate:MARKer4:X?

CommandFormatInstruction:CALCulate:MARKer[1]|2|3|4|5|6|7|8:Y?

Parameter
Type
Parameter
Range
ReturnThis command reads the current Y value for the designated marker.
This command can be used to read the results of noise marker.
Make sure that Marker is on, Reference Command::CALCulate:MARKer[1]|2|3|4|5|6|7|8:STATe:CALCulate:MARKer[1]|2|3|4|5|6|7|8:MODE
None
None
Float, unit: dBm

Default

None

Menu

None

Example:CALCulate:MARKer1:Y?
Return: -25

CommandFormatInstruction:CALCulate:MARKer:TABLe ON|OFF|0|1:CALCulate:MARKer:TABLe?
Toggles the marker table between on and off.
Gets the status of the marker table.
BooleanParameter
Type
Parameter
Range
ReturnON|OFF|0|1
0|1

Programming Guide

51

SIGLENT
Default

0

Menu

Marker > Marker Table

Example:CALCulate:MARKer:TABLe ON

CommandFormatInstruction:CALCulate:MARKer[1]|2|3|4|5|6|7|8[:SET]:START

Parameter
Type
Parameter
Range
ReturnSets the start frequency to the value of the specified marker frequency. This command is
not available in zero span.
If the specified Marker is OFF, it will set the marker on center.
None
None
None

Default

None

Menu

Marker→ > M→Start Freq

Example:CALCulate:MARKer1:START

CommandFormatInstruction:CALCulate:MARKer[1]|2|3|4|5|6|7|8[:SET]:STOP

Parameter
Type
Parameter
Range
ReturnSets the stop frequency to the value of the specified marker frequency. This command is
not available in zero span .
If the specified Marker is OFF, it will set the marker on center.
None
None
None

Default

None

Menu

Marker→ > M→Stop Freq

Example:CALCulate:MARKer1:STOP

CommandFormatInstruction:CALCulate:MARKer[1]|2|3|4|5|6|7|8[:SET]:CENTer

Parameter
Type
Parameter
Range
ReturnThis command sets the center frequency equal to the specified marker frequency, whichmoves the marker to the center of the screen. This command is not available in zero span.
If the specified Marker is OFF, it will set the marker on center.
None
None
None

Default

None

Menu

Marker→ > M→CF

52

Programming GuideSIGLENT
Example:CALCulate:MARKer1:CENTer

CommandFormatInstruction:CALCulate:MARKer[1]|2|3|4|5|6|7|8[:SET]:STEP

Parameter
Type
Parameter
Range
ReturnThis command sets the center frequency step equal to the specified marker frequency. This
command is not available in zero span.
If the specified Marker is OFF, it will set the marker on center.
None
None
None

Default

None

Menu

Marker→ > M→CF Step

Example:CALCulate:MARKer1:STEP

CommandFormatInstruction:CALCulate:MARKer[1]|2|3|4|5|6|7|8[:SET]:RLEVel

Parameter
Type
Parameter
Range
ReturnThis command sets the reference level equal to the specified marker frequency.
If the specified Marker is OFF, it will set the marker on center.
None
None
None

Default

None

Menu

Marker→ > M→Ref Level

Example:CALCulate:MARKer2:RLEVel

CommandFormatInstruction:CALCulate:MARKer[1]|2|3|4|5|6|7|8:DELTa[:SET]:SPAN

Parameter
Type
Parameter
Range
ReturnThis command sets the span equal to the specified delta marker frequency.
This command can be only used in DELTa marker mode,
Command:CALCulate:MARKer[1]|2|3|4|5|6|7|8:MODE
None

Reference

None
None

Default

None

Menu

Marker→ > △M→Span

Example:CALCulate:MARKer2:DELTa:SPAN

Programming Guide

53

SIGLENT

CommandFormatInstruction

Parameter
Type
Parameter
Range
Return:CALCulate:MARKer[1]|2|3|4|5|6|7|8:DELTa[:SET]:CENTer
This command sets the center frequency equal to the specified delta marker frequency.
This command can be only used in DELTa marker mode, Reference
Command:CALCulate:MARKer[1]|2|3|4|5|6|7|8:MODE
None
None
None

Default

None

Menu

Marker→ > △M→CFExample:CALCulate:MARKer3:DELTa:CENTer

CommandFormatInstruction:CALCulate:MARKer:PEAK:SEARch:MODE MAXimum|MINimum:CALCulate:MARKer:PEAK:SEARch:MODE?
This is for the analyzer’s internal peak identification routine to recognize a signal as a
peak.
Enumeration

Parameter
Type
Parameter
Range
ReturnMAXimum|MINimum
Enumeration

Default

MAXimum

Menu

Peak > Search Config > Peak Type

Example:CALCulate:MARKer:PEAK:SEARch:MODE MINimum

CommandFormatInstruction:CALCulate:MARKer:PEAK:SORT FREQuency |AMPLitude:CALCulate:MARKer:PEAK:SORT?
Sets the type of peak sort by.
Gets the type of peak sort by.
Enumeration

Parameter
Type
Parameter
Range
ReturnFREQuency: Frequency
AMPLitude: Amplitude
Enumeration: FREQ|AMPL

Default

AMPL

Menu

Peak > Search Config > Sort By

Example:CALCulate:MARKer:PEAK:SORT FREQ

CommandFormatInstruction:CALCulate:MARKer:PEAK:THReshold <value>:CALCulate:MARKer:PEAK:THReshold?
Specifies the minimum signal level for the analyzers internal peak identification routine torecognize a signal as a peak. This applies to all traces and all windows.

54

Programming GuideSIGLENT

Parameter
Type
Parameter
Range
ReturnGets the minimum signal level for the analyzers internal peak identification routine torecognize a signal as a peak.
Float, unit: dBm-200.0 dBm~ 200.0 dBm
Float, unit: dBm

Default-160.0 dBm

Menu

Peak > Search Config > Peak Threshold

Example:CALCulate:MARKer:PEAK:THReshold -50

CommandFormatInstruction:CALCulate:MARKer:PEAK:EXCursion <value>:CALCulate:MARKer:PEAK:EXCursion?
Specifies the minimum signal excursion above the threshold for the internal peakidentification routine to recognize a signal as a peak.
Float, unit: dB

Parameter
Type
Parameter
Range
Return0 ~ 200.0 dB
Float, unit: dB

Default

0 dB

Menu

Peak > Search Config > Peak Excursion

Example:CALCulate:MARKer:PEAK:EXCursion 10

CommandFormatInstruction:CALCulate:MARKer:PEAK:TABLe ON|OFF|0|1:CALCulate:MARKer:PEAK:TABLe?
Toggles the peak table between on and off.
Gets the status of the peak table.
BooleanParameter
Type
Parameter
Range
ReturnON|OFF|0|1
0|1

Default

0

Menu

Peak > Peak Table

CommandFormatInstruction:CALCulate:PEAK:TABLe?

Parameter
Type
Parameter
Range
ReturnNone

Gets peak table data.

None
String

Programming Guide

55

SIGLENT
Default

None

Menu

Peak > Peak Table

Example:CALCulate:PEAK:TABLe?

CommandFormatInstruction:CALCulate:MARKer[1]|2|3|4|5|6|7|8:CPEak[:STATe] OFF|ON|0|1:CALCulate:MARKer[1]|2|3|4|5|6|7|8:CPEak[:STATe]?
Toggles the continuous peak search function between on and off.
Gets the continuous peak search function state.
BooleanParameter
Type
Parameter
Range
ReturnOFF|ON|0|1
0|1

Default

None

Menu

Peak > Cont Peak

Example:CALCulate:MARKer1:CPEak ON

CommandFormatInstruction:CALCulate:MARKer[1]|2|3|4|5|6|7|8:MAXimum

Parameter
Type
Parameter
Range
ReturnPerforms a peak search based on the search mode settings.
(based on the search mode settings, include: peak search mode, peak threshold and peakexcursion, Reference Commands::CALCulate:MARKer:PEAK:SEARch:MODE:CALCulate:MARKer:PEAK:THReshold:CALCulate:MARKer:PEAK:EXCursion)
None
None
None

Default

None

Menu

Peak

Example:CALCulate:MARKer4:MAXimum

CommandFormatInstruction:CALCulate:MARKer[1]|2|3|4|5|6|7|8:MAXimum:NEXT

Parameter
Type
Parameter
Range
56

Places the selected marker on the next highest signal peak of the current marked peak.
(based on the search mode settings, include: peak search mode, peak threshold and peakexcursion, Reference Commands::CALCulate:MARKer:PEAK:SEARch:MODE:CALCulate:MARKer:PEAK:THReshold:CALCulate:MARKer:PEAK:EXCursion)
None
None

Programming GuideSIGLENT
ReturnNone

Default

None

Menu

Peak > Next Peak

Example:CALCulate:MARKer1:MAXimum:NEXT

CommandFormatInstruction:CALCulate:MARKer[1]|2|3|4|5|6|7|8:MAXimum:LEFT

Parameter
Type
Parameter
Range
ReturnPlaces the selected marker on the next highest signal peak to the left of the current marked
peak.
(based on the search mode settings, include: peak search mode, peak threshold and peakexcursion, Reference Commands::CALCulate:MARKer:PEAK:SEARch:MODE:CALCulate:MARKer:PEAK:THReshold:CALCulate:MARKer:PEAK:EXCursion)
None
None
None

Default

None

Menu

Peak > Left Peak

Example:CALCulate:MARKer1:MAXimum:LEFT

CommandFormatInstruction:CALCulate:MARKer[1]|2|3|4|5|6|7|8:MAXimum:RIGHt

Parameter
Type
Parameter
Range
ReturnPlaces the selected marker on the next highest signal peak to the right of the current
marked peak.
(based on the search mode settings, include: peak search mode, peak threshold and peakexcursion, Reference Commands::CALCulate:MARKer:PEAK:SEARch:MODE:CALCulate:MARKer:PEAK:THReshold:CALCulate:MARKer:PEAK:EXCursion)
None
None
None

Default

None

Menu

Peak > Right Peak

Example:CALCulate:MARKer1:MAXimum:RIGHt

CommandFormatInstruction:CALCulate:MARKer[1]|2|3|4|5|6|7|8:CPSearch
Positions a pair of delta markers on the highest and lowest points on the trace.

Programming Guide

57

SIGLENT
Parameter
Type
Parameter
Range
ReturnNone

Default

None

Menu

Peak > Peak Peak

Example:CALCulate:MARKer1:CPSearch

CommandFormatInstruction:CALCulate:MARKer[1]|2|3|4|5|6|7|8:FUNCtion OFF|FCOunt|NOISe|NDB:CALCulate:MARKer[1]|2|3|4|5|6|7|8:FUNCtion?
This command selects the marker function for the designated marker.
Gets the selected marker function for the designated marker.
Enumeration

Parameter
Type
Parameter
Range

None
None

ReturnOFF: refers to the normal function.
FCOunt: refers to the frequency counter function.
NOISe: refers to the noise measurement function.
NDB: refers to the N dB bandwidth function.
Enumeration

Default

OFF

Menu

Marker Fn

Example:CALCulate:MARK1:FUNCtion FCOunt

CommandFormatInstruction:CALCulate:MARKer:FCOunt[:STATe] ON|OFF|0|1

Parameter
Type
Parameter
Range
ReturnBooleanDefault

0

Menu

Marker Fn > Freq Counter

Example:CALCulate:MARK:FCOunt 1

CommandFormatInstruction:CALCulate:MARKer:FCOunt:X?

Parameter
Type
Parameter
Range

None

58

To set the frequency counter status.

ON|OFF|0|1
0|1

To query the frequency counter.

None

Programming GuideSIGLENT
ReturnNone

Default

None

Menu

Marker Fn > Freq Counter

Example:CALCulate:MARK:FCOunt:X?

CommandFormatInstruction:CALCulate:MARKer[1]|2|3|4|5|6|7|8:BANDwidth:RESult?

Parameter
Type
Parameter
Range
ReturnNone

Default

None

Menu

Marker Fn > N dB BW

Example:CALCulate:MARK1:BANDwidth:RESult?

CommandFormat:CALCulate:MARKer[1]|2|3|4|5|6|7|8:BANDwidth:NDB <value>:CALCulate:MARKer[1]|2|3|4|5|6|7|8:BANDwidth:NDB?
Sets the reference value of N dB bandwidth measurement.
Gets the reference value of N dB bandwidth measurement.
Float

Instruction
Parameter
Type
Parameter
Range
ReturnGets the result of N dB bandwidth measurement.

None
Float

-100dB ~ 100dB
Float

Default

-3 dB

Menu

Marker Fn > N dB BW

Example:CALCulate:MARK1:BANDwidth:NDB 10

CommandFormatInstruction:CALCulate:MARKer[1]|2|3|4|5|6|7|8:X:READout FREQuency|TIME|PERiod:CALCulate:MARKer[1]|2|3|4|5|6|7|8:X:READout?
Toggles the marker X-Axis readout between frequency, time and period.
Gets the marker X-Axis readout type.
Enumeration

Parameter
Type
Parameter
Range
ReturnFREQuency|TIME|PERiod
Enumeration

Default

FREQuency

Menu

Marker Fn > Read Out

Programming Guide

59

SIGLENT
Example:CALCulate:MARKer1:X:READout FREQuency

CommandFormatInstruction:CALCulate:MARKer:TRCKing[:STATe] OFF|ON|0|1:CALCulate:MARKer:TRCKing[:STATe]?
This command turns on/off signal track state.
Gets signal track state.
BooleanParameter
Type
Parameter
Range
ReturnOFF|ON|0|1
0|1

DefaultON

Menu

Frequency > Signal Track

Example:CALCulate:MARKer:TRCKing on

4.8 Limit Subsection:CALCulate:LLINe:TEST:STARt:CALCulate:LLINe:TEST:STOP:CALCulate:LLINe:TEST:STATe?
:CALCulate:LLINe[1]|2:STATe:CALCulate:LLINe[1]|2:TYPE:CALCulate:LLINe[1]|2:MODE:CALCulate:LLINe[1]|2:Y:CALCulate:LLINe[1]|2:DATA:CALCulate:LLINe[1]|2:ADD:CALCulate:LLINe[1]|2:DELete:CALCulate:LLINe[1]|2:ALL:DELete:CALCulate:LLINe:CONTrol:DOMain:CALCulate:LLINe:CONTrol:BEEP:CALCulate:LLINe:FAIL?
:CALCulate:LLINe:FAIL:STOP:CALCulate:LLINe1|2:OFFSet:X:CALCulate:LLINe1|2:OFFSet:Y
CommandFormatInstruction

60:CALCulate:LLINe:TEST:STARt
Sets limit test start.

Programming GuideSIGLENT
Parameter
Type
Parameter
Range
ReturnNone

Default

None

Menu

Limit > Test

Example:CALCulate:LLINe:TEST:STARt

CommandFormatInstruction:CALCulate:LLINe:TEST:STOP

Parameter
Type
Parameter
Range
ReturnNone

Default

None

Menu

Limit > Test

Example:CALCulate:LLINe:TEST:STOP

CommandFormatInstruction:CALCulate:LLINe:TEST:STATe?

Parameter
Type
Parameter
Range
ReturnNone

Default

OFF

Menu

Limit > Test

Example:CALCulate:LLINe:TEST:STAT?

CommandFormatInstruction:CALCulate:LLINe[1]|2:STATe OFF|ON|0|1:CALCulate:LLINe[1]|2:STATe?
Sets limit line state.
Gets limit line state.
BooleanParameter
Type
Parameter
Range
Return

None
None

Sets limit test stop.

None
None

Gets limit test state.

None
0|1

OFF|ON|0|1
0|1

Programming Guide

61

SIGLENT
Default

OFF

Menu

Limit > Limit1|2

Example:CALCulate:LLINe1:STATe OFF

CommandFormatInstruction:CALCulate:LLINe[1]|2:TYPE UPPer|LOWer:CALCulate:LLINe[1]|2:TYPE?
Mode sets a limit line to be either an upper or lower type limit line. An upper line will be
used as the maximum allowable value when comparing with the data.
Gets limit type.
Enumeration

Parameter
Type
Parameter
Range
ReturnUPPer|LOWer
Enumeration

Default

The default setting of LINe1 is UPPer, the default setting of LINe2 is LOWer

Menu

Limit > Limit1|2 Edit > Type

Example:CALCulate:LLINe1: TYPE LOWer

CommandFormatInstruction:CALCulate:LLINe[1]|2:MODE LINE|POINt:CALCulate:LLINe[1]|2:MODE?
Sets limit mode.
Gets limit mode.
Enumeration

Parameter
Type
Parameter
Range
ReturnLINE|POINt
Enumeration

Default

LINE

Menu

Limit > Limit1|2 Edit > Mode

Example:CALCulate:LLINe1: MODE POINt

CommandFormatInstruction:CALCulate:LLINe[1]|2:Y <value>:CALCulate:LLINe[1]|2:Y?
Sets the Y-axis value of a limit line. Limit line Y-axis value is set independently and is notaffected by the X-axis units.
Gets the Y-axis value of a limit line.
Float

Parameter
Type
Parameter
Range
Return-400 dBm ~ 330 dBm
Float

Default

0 dBm

Menu

Limit > Limit1|2 Edit > Amplitude

62

Programming GuideSIGLENT
Example:CALCulate:LLINe1:Y 5dBm

CommandFormatInstruction

Menu:CALCulate:LLINe[1]|2:DATA <x-axis>,<ampl>{,<x-axis>, <ampl>}:CALCulate:LLINe[1]|2:DATA?
Uses this command to define the limit points.
Gets the defined limit points.
X-axis: Float
Amplitude: Float
X-axis: 0 ~ 3.2GHz
Amplitude: -400 dBm ~ 330 dBm
X-axis: Float
Amplitude: Float
X-axis: -1 Hz
Amplitude: 0 dBm
Limit > Limit1|2 Edit

Example:CALC:LLINe1:DATA 10000000,-20,20000000,-30

CommandFormatInstruction:CALCulate:LLINe[1]|2:ADD <x-axis>,<ampl>

Parameter
Type
Parameter
Range
ReturnMenu

X-axis: Float
Amplitude: Float
X-axis: 0 ~ 3.2 G Hz
Amplitude: None
X-axis: Float
Amplitude: Float
X-axis: -1Hz
Amplitude: 0 dBm
Limit > Limit1|2 Edit

Example:CALCulate:LLINe1:ADD 10000000,-20

CommandFormatInstruction:CALCulate:LLINe[1]|2:DELete <number>

Parameter
Type
Parameter
Range
ReturnInteger

Default

None

Menu

Limit > Limit1|2 Edit > Del Point

Example:CALCulate:LLINe1:DELete 2

Parameter
Type
Parameter
Range
ReturnDefault

Default

Add limit point data

Uses this command to delete the assigned limit point.

None
None

Programming Guide

63

SIGLENT
CommandFormatInstruction:CALCulate:LLINe[1]|2:ALL:DELete

Parameter
Type
Parameter
Range
ReturnNone

Default

None

Menu

Limit > Limit1|2 Edit > Del All

Example:CALCulate:LLINe2:ALL:DELete

CommandFormatInstruction:CALCulate:LLINe1|2:OFFSet:X <value>:CALCulate:LLINe1|2:OFFSet:X?
Sets the X-axis offset value of a limit line.
Gets the X-axis offset value of a limit line.
Float

Parameter
Type
Parameter
Range
ReturnUses this command to define all the limits points.

None
None

Float

Default

0dBm

Menu

Limit > Limit1|2 Edit > X Offset

Example:CALCulate:LLINe1:OFFSet:X 200

CommandFormatInstruction:CALCulate:LLINe1|2:OFFSet:Y <value>:CALCulate:LLINe1|2:OFFSet:Y?
Sets the Y-axis offset value of a limit line.
Gets the Y-axis offset value of a limit line.
Float

Parameter
Type
Parameter
Range
Return-350 dBm ~ 380 dBm
Float

Default

0dBm

Menu

Limit > Limit1|2 Edit > Ampt Offset

Example:CALCulate:LLINe1:OFFSet:Y 5dBm

CommandFormatInstruction:CALCulate:LLINe:CONTrol:DOMain FREQuency|TIME:CALCulate:LLINe:CONTrol:DOMain?
Toggles the limit X-axis value between frequency and time.
Gets the limit X-axis unit.
Enumeration

ParameterType
64

Programming GuideSIGLENT
Parameter
Range
ReturnFREQuency|TIME

Default

FREQuency

Menu

Limit > Setup > X Axis

Example:CALCulate:LLINe:CONTrol:DOMain FREQuency

CommandFormatInstruction:CALCulate:LLINe:CONTrol:BEEP OFF|ON|0|1:CALCulate:LLINe:CONTrol:BEEP?
Use this command to turn on/off the limit beep status.
Gets limit beep state.
BooleanParameter
Type
Parameter
Range
ReturnEnumeration

OFF|ON|0|1
0|1

Default

ON

Menu

Limit > Setup > Buzzer

Example:CALCulate:LLINe:CONTrol:BEEP OFF

CommandFormatInstruction:CALCulate:LLINe:FAIL?

Parameter
Type
Parameter
Range
ReturnThis query returns the limits pass/failed result. If the test result fails, this command will get
result FAIL. If the test result passes, it will get result PASS.
None
None
PASS|FAIL

Default

None

Menu

None

Example:CALCulate:LLINe:FAIL?

CommandFormatInstruction:CALCulate:LLINe:FAIL:STOP OFF|ON|0|1:CALCulate:LLINe:FAIL:STOP?
Sets whether to stop the test if the test fails.
Gets whether to stop the test if the test fails.
BooleanParameter
Type
Parameter
Range
ReturnDefault

OFF|ON|0|1
0|1
OFF

Programming Guide

65

SIGLENT
Menu

Limit > Setup > Fail to stop

Example:CALCulate:LLINe:FAIL:STOP OFF

4.9 Measurement Subsystem
Reflection Subsection
Reflection Subsection
SSA series products support this function; SVA series products do not support this function.
[:SENSe]:CAT:RST[:SENSe]:CAT:FREFlect:TYPE[:SENSe]:CAT:FREFlect:OPEN[:SENSe]:CAT:FREFlect:SHORt[:SENSe]:CAT:FREFlect:LOAD[:SENSe]:MEASure:REFLction[1]|2|3|4|5|6|7|8:RETUrnloss?
[:SENSe]:MEASure:REFLction[1]|2|3|4|5|6|7|8:COEFficient?
[:SENSe]:MEASure:REFLction[1]|2|3|4|5|6|7|8:VSWR?

CommandFormatInstruction[:SENSe]:CAT:RST

Parameter
Type
Parameter
Range
ReturnNone

Default

None

Menu

Meas > Reflection > Meas Setup > Calibration > Reset

Example

INSTrument:MEASure REFL
:CAT:RST

CommandFormatInstruction[:SENSe]:CAT:FREFlect:TYPE[:SENSe]:CAT:FREFlect:TYPE?
Sets calibration type.
Gets calibration type.
Enumeration

Parameter
Type
Parameter
Range

Clears calibration data.

None
None

Return

OPEN:open
HOS:(open+short)/2
OL:open+load
Enumeration

Default

None

Menu

Meas > Reflection > Meas Setup > Calibration

66

Programming GuideSIGLENT
Example

INSTrument:MEASure REFL
:CAT:FREFlect:TYPE OL

CommandFormatInstruction[:SENSe]:CAT:FREFlect:OPEN

Parameter
Type
Parameter
Range
ReturnNone

Default

None

Menu

Meas > Reflection > Meas Setup > Calibration

Example

INSTrument:MEASure REFL
:CAT:FREFlect:OPEN

CommandFormatInstruction[:SENSe]:CAT:FREFlect:SHORt

Parameter
Type
Parameter
Range
ReturnNone

Default

None

Menu

Meas > Reflection > Meas Setup > Calibration

Example

INSTrument:MEASure REFL
:CAT:FREFlect:SHOR

CommandFormatInstruction[:SENSe]:CAT:FREFlect:LOAD

Parameter
Type
Parameter
Range
ReturnNone

Default

None

Menu

Meas > Reflection > Meas Setup > Calibration

Example

INSTrument:MEASure REFL
:CAT:FREFlect:LOAD

CommandFormatInstruction[:SENSe]:MEASure:REFLction[1]|2|3|4|5|6|7|8:RETUrnloss?

Calibration open circuit.

None
None

Calibration short circuit.

None
None

Calibration load circuit

None
None

Reads return loss of reflection measurement.

Programming Guide

67

SIGLENT
Parameter
Type
Parameter
Range
ReturnNone

Default

None

Menu

Meas > Reflection

Example:MEASure:REFLction2:RETUrnloss?

CommandFormatInstruction[:SENSe]:MEASure:REFLction[1]|2|3|4|5|6|7|8:COEFficient?

Parameter
Type
Parameter
Range
ReturnNone

Default

None

Menu

Meas > Reflection

Example:MEASure:REFLction2:COEF?

CommandFormatInstruction[:SENSe]:MEASure:REFLction[1]|2|3|4|5|6|7|8:VSWR?

Parameter
Type
Parameter
Range
ReturnNone

Default

None

Menu

Meas > Reflection

Example:MEASure:REFLction2:VSWR?

None
None

Reads Refl coefficient of reflection measurement.

None
None

Reads VSWR of reflection measurement.

None
None

ACPR
CHP
OBW
T-Power
SPECtrogram
TOI
CNR
Harmonics:INSTrument:MEASure

68

Programming GuideSIGLENT

CommandFormatInstruction
Parameter
Type
Parameter
Range:INSTrument:MEASure
OFF|ACPR|CHPower|OBW|TPOWer |SPECtrogram|TOI:INSTrument:MEASure?
Sets measure mode.
Gets measure mode.
Enumeration

ReturnOFF: measure off
REFLection: Reflection// SSA series products support this function;
ACPR: ACPR
CHPower: Channel Power
OBW: Occupied BW
TPOWer: T-POWer
SPECtrogram: Spectrogram Monitor
TOI: Third-order Intercept Point
HARMonics: Harmonic analysis
CNR: Carrier Noise Ratio
Enumeration

Default

OFF

Menu

MeasureExample:INSTrument:MEASure ACPR

4.9.1

Reflection Subsection

SSA series products support this function; SVA series products do not support this function.
[:SENSe]:CAT:RST[:SENSe]:CAT:FREFlect:TYPE[:SENSe]:CAT:FREFlect:OPEN[:SENSe]:CAT:FREFlect:SHORt[:SENSe]:CAT:FREFlect:LOAD[:SENSe]:MEASure:REFLction[1]|2|3|4|5|6|7|8:RETUrnloss?
[:SENSe]:MEASure:REFLction[1]|2|3|4|5|6|7|8:COEFficient?
[:SENSe]:MEASure:REFLction[1]|2|3|4|5|6|7|8:VSWR?

CommandFormatInstruction[:SENSe]:CAT:RST

Parameter
Type
Parameter
Range
ReturnNone

Default

None

Clears calibration data.

None
None

Programming Guide

69

SIGLENT
Menu

Meas > Reflection > Meas Setup > Calibration > Reset

Example

INSTrument:MEASure REFL
:CAT:RST

CommandFormatInstruction[:SENSe]:CAT:FREFlect:TYPE[:SENSe]:CAT:FREFlect:TYPE?
Sets calibration type.
Gets calibration type.
Enumeration

Parameter
Type
Parameter
Range
Return

OPEN:open
HOS:(open+short)/2
OL:open+load
Enumeration

Default

None

Menu

Meas > Reflection > Meas Setup > Calibration

Example

INSTrument:MEASure REFL
:CAT:FREFlect:TYPE OL

CommandFormatInstruction[:SENSe]:CAT:FREFlect:OPEN

Parameter
Type
Parameter
Range
ReturnNone

Default

None

Menu

Meas > Reflection > Meas Setup > Calibration

Example

INSTrument:MEASure REFL
:CAT:FREFlect:OPEN

CommandFormatInstruction[:SENSe]:CAT:FREFlect:SHORt

Parameter
Type
Parameter
Range
ReturnNone

Default

None

Menu

Meas > Reflection > Meas Setup > Calibration

Example

INSTrument:MEASure REFL
:CAT:FREFlect:SHOR

CommandFormat[:SENSe]:CAT:FREFlect:LOAD

70

Calibration open circuit.

None
None

Calibration short circuit.

None
None

Programming GuideSIGLENT
Instruction

Calibration load circuit

Parameter
Type
Parameter
Range
ReturnNone

Default

None

Menu

Meas > Reflection > Meas Setup > Calibration

Example

INSTrument:MEASure REFL
:CAT:FREFlect:LOAD

CommandFormatInstruction[:SENSe]:MEASure:REFLction[1]|2|3|4|5|6|7|8:RETUrnloss?

Parameter
Type
Parameter
Range
ReturnNone

Default

None

Menu

Meas > Reflection

Example:MEASure:REFLction2:RETUrnloss?

CommandFormatInstruction[:SENSe]:MEASure:REFLction[1]|2|3|4|5|6|7|8:COEFficient?

Parameter
Type
Parameter
Range
ReturnNone

Default

None

Menu

Meas > Reflection

Example:MEASure:REFLction2:COEF?

CommandFormatInstruction[:SENSe]:MEASure:REFLction[1]|2|3|4|5|6|7|8:VSWR?

Parameter
Type
Parameter
Range
ReturnNone

Default

None

None
None

Reads return loss of reflection measurement.

None
None

Reads Refl coefficient of reflection measurement.

None
None

Reads VSWR of reflection measurement.

None
None

Programming Guide

71

SIGLENT
Menu

Meas > Reflection

Example:MEASure:REFLction2:VSWR?

4.9.2

ACPR Subsection[:SENSe]:ACPRatio:BWIDth:INTegration[:SENSe]:ACPRatio:OFFSet:BWIDth[:INTegration][:SENSe]:ACPRatio:OFFSet[:FREQuency]:MEASure:ACPRatio:MAIN?
:MEASure:ACPRatio:LOWer:POWer?
:MEASure:ACPRatio:LOWer?
:MEASure:ACPRatio:UPPer:POWer?
:MEASure:ACPRatio:UPPer?

CommandFormatInstruction
Parameter
Type
Parameter
Range
Return[:SENSe]:ACPRatio:BWIDth:INTegration <freq>[:SENSe]:ACPRatio:BWIDth:INTegration?
Specifies the range of integration used in calculating the power in the main channel.
Gets the range of integration used in calculating the power in the main channel.
Float, unit: Hz, kHz, MHz, GHz
100 Hz ~ 1.5 GHz
Float, unit: Hz

Default

1MHz

Menu

Meas > ACPR > Meas Setup > Main Channel

Example

INSTrument:MEASure ACPR
:ACPRatio:BWIDth:INTegration 20 MHz

CommandFormatInstruction[:SENSe]:ACPRatio:OFFSet:BWIDth[:INTegration] <freq>[:SENSe]:ACPRatio:OFFSet:BWIDth[:INTegration]?
Specifies the bandwidth used in calculating the power in the adjacent channel.
Gets the bandwidth used in calculating the power in the adjacent channel.
Float, unit: Hz, kHz, MHz, GHz

Parameter
Type
Parameter
Range
Return100 Hz ~ 1.5 GHz
Float, unit: Hz

Default

1 MHz

Menu

Meas > ACPR > Meas Setup > Adjacent Chn

Example:ACPRatio:OFFSet:BWIDth 20 MHz

72

Programming GuideSIGLENT
CommandFormatInstruction

Parameter
Type
Parameter
Range
Return[:SENSe]:ACPRatio:OFFSet[:FREQuency] <freq>[:SENSe]:ACPRatio:OFFSet[:FREQuency]?
Sets the space value between the center frequency of main channel power and that of theadjacent channel power.
Gets adjacent channel space
Float, unit: Hz, kHz, MHz, GHz
100 Hz ~ 700 MHz
Float, unit: Hz

Default

3MHz

Menu

Meas > ACPR > Meas Setup > Adj Chn Space

Example:ACPRatio:OFFSets 20 MHz

CommandFormatInstruction:MEASure:ACPRatio:MAIN?

Parameter
Type
Parameter
Range
ReturnNone

Default

None

Menu

Meas > ACPR

Example:MEASure:ACPRatio:MAIN?

CommandFormatInstruction:MEASure:ACPRatio:LOWer:POWer?

Parameter
Type
Parameter
Range
ReturnNone

Default

None

Menu

Meas > ACPR

Example:MEASure:ACPRatio:LOWer:POWer?

CommandFormatInstruction:MEASure:ACPRatio:LOWer?

Parameter
Type

None

Returns the main channel power of ACPR measurement.

None
Float, unit: dBm

Returns the lower adjacent channel power of ACPR measurement.

None
Float, unit: dBm

Returns the lower adjacent channel power to main channel power ratio.

Programming Guide

73

SIGLENT
Parameter
Range
ReturnNone

Default

None

Menu

Meas > ACPR

Example:MEASure:ACPRatio:LOWer?

CommandFormatInstruction:MEASure:ACPRatio:UPPer:POWer?

Parameter
Type
Parameter
Range
ReturnNone

Default

None

Menu

Meas > ACPR

Example:MEASure:ACPRatio:UPPer:POWer?

CommandFormatInstruction:MEASure:ACPRatio:UPPer?

Parameter
Type
Parameter
Range
ReturnNone

Default

None

Menu

Meas > ACPR

Example:MEASure:ACPRatio:UPPer?

4.9.3

Float, unit: dBm

Returns the upper adjacent channel power of ACPR measurement.

None
Float, unit: dBm

Returns the upper adjacent channel power to main channel power ratio.

None
Float

CHP Subsection[:SENSe]:CHPower:BWIDth:INTegration[:SENSe]:CHPower:FREQuency:SPAN:POWer:MEASure:CHPower?
:MEASure:CHPower:CHPower?
:MEASure:CHPower:DENSity?

CommandFormat74[:SENSe]:CHPower:BWIDth:INTegration <freq>[:SENSe]:CHPower:BWIDth:INTegration?
Programming GuideSIGLENT
Instruction
Parameter
Type
Parameter
Range
ReturnSpecifies the integration bandwidth to calculate the power.
Gets the integration bandwidth.
Float, unit: Hz, kHz, MHz, GHz
100 Hz ~ 3.2 GHz
Float, unit: Hz

Default

2 MHz

Menu

Meas > Ch Power > Meas Setup > Integration BW

Example:CHPower:BWIDth:INTegration 1.0 GHz

CommandFormatInstruction[:SENSe]:CHPower:FREQuency:SPAN:POWer

Parameter
Type
Parameter
Range
ReturnSets the analyzer span for the channel power measurement. Be sure the span is set larger
than the integration bandwidth.
None
None
None

Default

None

Menu

Meas > Ch Power > Meas Setup > Span Power

Example:CHPower:FREQuency:SPAN:POWer

CommandFormatInstruction:MEASure:CHPower?

Parameter
Type
Parameter
Range
ReturnNoneThis command returns scalar results of main channel power, and power density.

None

Default

Float, Channel Power unit: dBm
Float, Density unit: dBm/Hz
None

Menu

Meas > Ch Power

Example:MEASure:CHPower?

CommandFormatInstruction:MEASure:CHPower:CHPower?

Parameter
Type
Parameter
Range

None

This command returns the value of the channel power in dBm units.

None

Programming Guide

75

SIGLENT
ReturnFloat

Default

None

Menu

Meas > Ch Power

Example:MEASure:CHPower:CHPower?

CommandFormatInstruction:MEASure:CHPower:DENSity?

Parameter
Type
Parameter
Range
ReturnNone

Default

None

Menu

Meas > Ch Power

Example:MEASure:CHPower:DENSity?

4.9.4

This command returns the value of the channel power density in dBm/Hz.

None
Float

OBW Subsection[:SENSe]:OBWidth:METHod[:SENSe]:OBWidth:PERCent[:SENSe]:OBWidth:XDB:MEASure:OBWidth?
:MEASure:OBWidth:OBWidth?
:MEASure:OBWidth:CENTroid?
:MEASure:OBWidth:OBWidth:FERRor?

CommandFormatInstruction
Parameter
Type
Parameter
Range
Return[:SENSe]:OBWidth:METHod PERCent|DBC[:SENSe]:OBWidth:METHod?
This command toggles the method of OBW measurement between percent and dBc.
Gets the method of OBW measurement.
Enumeration
PERCent|DBC
Enumeration

Default

PERCent

Menu

Meas > Occupied BW > Meas Setup > Method

Example:OBW:METHod PERCent76

Programming GuideSIGLENT
CommandFormatInstruction

Parameter
Type
Parameter
Range
Return[:SENSe]:OBWidth:PERCent <para>[:SENSe]:OBWidth:PERCent?
Edit the percentage of signal power used when determining the occupied bandwidth. Press{%} to set the percentage ranging from 10.00% to 99.99%.
Gets the percentage of signal power.
Float
10~99.99
Float

Default

99

Menu

Meas > Occupied BW > Meas Setup > %Example:OBW:PERCent 50

CommandFormatInstruction[:SENSe]:OBWidth:XDB <value>[:SENSe]:OBWidth:XDB?
Specify the power level used to determine the emission bandwidth as the number of dB
down from the highest signal point, within the occupied bandwidth span.
Gets dBc value.
Float

Parameter
Type
Parameter
Range
Return0.1 ~ 100
Float

Default

26

Menu

Meas > Occupied BW > Meas Setup > dBc

Example:OBWidth:XDB 3

CommandFormatInstruction:MEASure:OBWidth?

Parameter
Type
Parameter
Range
ReturnUses this command to query the occupied bandwidth and bandwidth centroid according to
the method you set.
None
None
Float, unit: Hz

Default

None

Menu

Meas > Occupied BW

Example:MEASure:OBW?

CommandFormatInstruction:MEASure:OBWidth:OBWidth?
Uses this command to query the occupied bandwidth according to the method you set.
Query Centroid Result.

Programming Guide

77

SIGLENT
Parameter
Type
Parameter
Range
ReturnNone

Default

None

Menu

Meas > Occupied BW

Example:MEASure:OBW:OBW?

CommandFormatInstruction:MEASure:OBWidth:CENTroid?

Parameter
Type
Parameter
Range
ReturnNone

Default

None

Menu

Meas > Occupied BW

Example: MEASure:OBW:CENTroid?

CommandFormatInstruction:MEASure:OBWidth:OBWidth:FERRor?

Parameter
Type
Parameter
Range
ReturnNone

Default

None

Menu

Meas > Occupied BW

Example:MEASure:OBWidth:OBWidth:FERRor?

4.9.5

SubsectionT-power(T-Power)

None
Float, unit: Hz

Uses this command to query the occupied bandwidth according to the method you set.

None
Float, unit: Hz

Uses this command to query transmit frequency error.

None
Float, unit: Hz[:SENSe]:TPOWer:FREQuency:CENTer[:SENSe]:TPOWer:LLIMit[:SENSe]:TPOWer:RLIMit:MEASure:TPOWer?

Command78[:SENSe]:TPOWer:FREQuency:CENTer <freq>

Programming GuideSIGLENT
Format[:SENSe]:TPOWer:FREQuency:CENTer?

Instruction

Sets T-power center frequency.
Gets T-power center frequency.
Float, unit: Hz, kHz, MHz, GHz

Parameter
Type
Parameter
Range
Return0 ~ 3.2 GHz
Float, unit: Hz

Default

1.5 GHz

Menu

Meas > T-power > Meas Setup > Center Freq

Example:TPOWer:FREQuency:CENTer 15kHz

CommandFormatInstruction[:SENSe]:TPOWer:LLIMit <time>[:SENSe]:TPOWer:LLIMit?
Sets T-power start line.
Gets T-power start line.
Float, unit: sParameter
Type
Parameter
Range
Return0 ~ 1000 s
Float, unit: sDefault

0

Menu

Meas > T-power > Meas Setup > Start Line

Example:TPOWer:LLIMit 0.01

CommandFormatInstruction[:SENSe]:TPOWer:RLIMit <time>[:SENSe]:TPOWer:RLIMit?
Sets T-power stop line.
Gets T-power stop line.
Float, unit: sParameter
Type
Parameter
Range
Return0 ~ 1000 s
Float, unit: sDefault

20 ms

Menu

Meas > T-power > Meas Setup > Stop Line

Example:TPOWer:RLIMit 0.02

CommandFormatInstruction:MEASure:TPOWer?

Parameter
Type

Float, unit: dBm

Querys the result of T-power measurement.

Programming Guide

79SIGLENT
Parameter
Range
ReturnNone

Default

None

Menu

Meas > T-power

Example:MEASure:TPOWer?

4.9.6

Float, unit: dBm

Spectrum Monitor(SPECtrogram)[:SENSe]:SPECtrogram:STATe[:SENSe]:SPECtrogram:RESTart

CommandFormatInstruction
Parameter
Type
Parameter
Range
Return[:SENSe]:SPECtrogram:STATe RUN|PAUSe[:SENSe]:SPECtrogram:STATe?
Sets spectrogram state.
Gets spectrogram state.
Enumeration
RUN: Start
PAUSe: Pause
RUN|PAUSe

Default

RUN

Menu

Meas > Spectrum Monitor > Meas Setup > Spectrogram

Example:SPECtrogram:STATe PAUSe

CommandFormatInstruction[:SENSe]:SPECtrogram:RESTart

Parameter
Type
Parameter
Range
ReturnNone

Default

None

Menu

Meas > Spectrum Monitor > Meas Setup > Restart

Example:SPECtrogram:RESTart

4.9.7

Restarts spectrogram.

None
None

Third-order Intercept Point(TOI):MEASure:TOI?
:MEASure:TOI:IP3?
CommandFormat80:MEASure:TOI?

Programming GuideSIGLENT
Instruction

Gets the result of Third-order Intercept Point.

Parameter
Type
Parameter
Range
ReturnNone

Default

None

Menu

Meas > TOI

Example:MEASure:TOI?

CommandFormatInstruction:MEASure:TOI:IP3?

Parameter
Type
Parameter
Range
ReturnNone

Default

None

Menu

Meas > TOI

Example:MEASure:TOI:IP3?

4.9.8

None
Float

Gets the min intercept of the Lower TOI(Lower 3rd) and the Upper TOI(Upper 3rd).

None
Float

Carrier Noise Ratio(CNR)[:SENSe]:CNRatio:BANDwidth:INTegration[:SENSe]:CNRatio:BANDwidth:NOISe[:SENSe]:CNRatio:OFFSet:MEASure:CNRatio?
:MEASure:CNRatio:CARRier?
:MEASure:CNRatio:NOISe?

CommandFormatInstruction
Parameter
Type
Parameter
Range
Return[:SENSe]:CNRatio:BANDwidth:INTegration <freq>[:SENSe]:CNRatio:BANDwidth:INTegration?
Sets Carrier BW.
Gets Carrier BW.
Float, Unit: Hz, kHz, MHz, GHz
100 Hz ~ 6.3999999 GHz
Float, Unit: Hz

Default

3 MHz

Menu

Meas > CNR > Carrier BW

Programming Guide

81

SIGLENT
Example:CNRatio:BANDwidth:INTegration 1.0 GHz

CommandFormatInstruction[:SENSe]:CNRatio:BANDwidth:NOISe <freq>[:SENSe]:CNRatio:BANDwidth:NOISe?
Sets Noise BW
Gets Noise BW
Float, Unit: Hz, kHz, MHz, GHz

Parameter
Type
Parameter
Range
Return100 Hz ~ 6.3999999 GHz
Float, Unit: Hz

Default

3 MHz

Menu

Meas > CNR > Noise BW

Example:CNRatio:BANDwidth:NOISe 1 MHz

CommandFormatInstruction[:SENSe]:CNRatio:OFFSet <freq>[:SENSe]:CNRatio:OFFSet?
Sets Freq Offset
Gets Freq Offset
Float, Unit: Hz, kHz, MHz, GHz

Parameter
Type
Parameter
Range
Return-3.1999999 GHz ~ 3.1999999 GHz
Float, Unit: Hz

Default

3 MHz

Menu

Meas > CNR > Freq Offset

Example:CNRatio:OFFSet 1 MHz

CommandFormatInstruction:MEASure:CNRatio?

Parameter
Type
Parameter
Range
ReturnNone

Default

None

Menu

Meas > CNR

Example:MEASure:TOI?

82

Query CNR

None
Float

Programming GuideSIGLENT
CommandFormatInstruction:MEASure:CNRatio:CARRier?

Parameter
Type
Parameter
Range
ReturnNone

Default

None

Menu

Meas > CNR

Example:MEASure:CNRatio:CARRier?

CommandFormatInstruction:MEASure:CNRatio:NOISe?

Parameter
Type
Parameter
Range
ReturnNone

Default

None

Menu

Meas > CNR

Example:MEASure:CNRatio:NOISe?

4.9.9

Harmonics(Harmonics)

Query Carrier Power

None
Float

Query Noise Power

None
Float

[:SENSe]:HARMonics:FREQuency:FUNDamental[:SENSe]:HARMonics:FREQuency:STEP[:INCRement][:SENSe]:HARMonics:FREQuency:FUNDamental:AUTO[:SENSe]:HARMonics:FREQuency:STEP[:INCRement]:AUTO[:SENSe]:HARMonics:NUMBer[:SENSe]:HARMonics:SELect

CommandFormatInstruction
Parameter
Type
Parameter
Range
Return[:SENSe]:HARMonics:FREQuency:FUNDamental <freq>[:SENSe]:HARMonics:FREQuency:FUNDamental?
Sets Fundamental Frequency.
Gets Fundamental Frequency.
Float, Unit: Hz, kHz, MHz, GHz
10 MHz ~ 1.6 GHz
Float, Unit: Hz

Default

Programming Guide

83

SIGLENT
Menu

Meas > Harmonics > Fundamental

Example:HARMonics:FREQuency:FUNDamental 1.0 GHz

CommandFormatInstruction[:SENSe]:HARMonics:FREQuency:STEP[:INCRement] <freq>[:SENSe]:HARMonics:FREQuency:STEP[:INCRement]?
Sets Frequency Step.
Gets Frequency Step.
Float, Unit: Hz, kHz, MHz, GHz

Parameter
Type
Parameter
Range
Return10 MHz ~ 3.19 GHz
Float, Unit:Hz

Default
Menu

Meas > Harmoniscs > Freq Step

Example:HARMonics:FREQuency:STEP 1 MHz

CommandFormatInstruction[:SENSe]:HARMonics:FREQuency:FUNDamental:AUTO[:SENSe]:HARMonics:FREQuency:FUNDamental:AUTO?
Sets Fundamental Freq State.
Gets Fundamental Freq State.
BooleanParameter
Type
Parameter
Range
ReturnOFF|ON|0|1
BooleanDefault

1

Menu

Meas > Harmonics > Fundamental

Example:HARMonics:FREQuency:FUNDamental:AUTO on

CommandFormatInstruction[:SENSe]:HARMonics:FREQuency:STEP[:INCRement]:AUTO[:SENSe]:HARMonics:FREQuency:STEP[:INCRement]:AUTO?
Sets Freq step State.
Gets Freq step State.
BooleanParameter
Type
Parameter
Range
ReturnOFF|ON|0|1
BooleanDefault

1

Menu

Meas > Harmonics > Freq Step

Example:HARMonics:FREQuency:STEP:AUTO on

84

Programming GuideSIGLENT
CommandFormatInstruction
Parameter
Type
Parameter
Range
Return[:SENSe]:HARMonics:NUMBer[:SENSe]:HARMonics:NUMBer?
Sets Harmonic Number.
Gets Harmonic Number.
Integer2 ~ 10Integer

Default

10

Menu

Meas > Harmonics > Harmonic Num

Example:HARMonics:NUMBer 2

CommandFormatInstruction[:SENSe]:HARMonics:SELect[:SENSe]:HARMonics:SELect?
Sets the Harmonic to be selected.
Gets the Harmonic which is selected.
Integer
It will set select all Harmonics when the parameter is 0.
0 ~ 10Parameter
Type
Parameter
Range
ReturnInteger

Default

0

Menu

Meas > Harmonics > Select Harmonic

Example:HARMonics:SELect 44.10 TG Subsystem:OUTPut[:STATe]:SOURce:POWer[:LEVel][:IMMediate][:AMPLitude]:SOURce:CORRection:OFFSet:CALCulate:NTData[:STATe]:DISPlay:WINDow:TRACe:Y[:SCALe]:NRLevel:DISPlay:WINDow:TRACe:Y[:SCALe]:NRPosition:TRACe:COPY:REF:DISPlay:WINDow:NTTRace[:STATe]CommandFormatInstruction
ParameterType:OUTPut[:STATe] OFF|ON|0|1:OUTPut[:STATe]?
Sets TG on or off.
Gets TG state.
BooleanProgramming Guide

85

SIGLENT
Parameter
Range
ReturnOFF|ON|0|1

Default

0

Menu

TG > TG

Example:OUTPut ON

CommandFormatInstruction:SOURce:POWer[:LEVel][:IMMediate][:AMPLitude] <value>:SOURce:POWer[:LEVel][:IMMediate][:AMPLitude]?
Sets TG level.
Gets TG level.
Float, unit: dBm

Parameter
Type
Parameter
Range
Return0|10 dBm ~ -20 dBm
Float

Default

0 dBm

Menu

TG > TG Level

Example:SOURce:POWer -20

CommandFormatInstruction:SOURce:CORRection:OFFSet <value>:SOURce:CORRection:OFFSet?
Sets TG level offsets.
Gets TG level offsets.
Float, unit: dBm

Parameter
Type
Parameter
Range
Return200 dBm ~ -200 dBm
Float

Default

0 dBm

Menu

TG > TG Level OffSet

Example:SOURce:CORRection:OFFSet 1

CommandFormatInstruction:CALCulate:NTData[:STATe] OFF|ON|0|1:CALCulate:NTData[:STATe]?
Sets TG normalize on-off.
Gets TG normalize state.
BooleanParameter
Type
Parameter
Range
ReturnDefault

86

OFF|ON|0|10|10Programming GuideSIGLENT
Menu

TG > Normalize

Example:CALCulate:NTData ON

CommandFormatInstruction:DISPlay:WINDow:TRACe:Y[:SCALe]:NRLevel <value>:DISPlay:WINDow:TRACe:Y[:SCALe]:NRLevel?
Sets TG normalize reference level.
Gets TG normalize reference level.
Float, unit: dB

Parameter
Type
Parameter
Range
Return-200 dB ~ 200 dB
Float, unit: dB

Default

0 dB

Menu

TG > Normal Ref Level

Example:DISPlay:WINDow:TRACe:Y:NRLevel 10

CommandFormatInstruction:DISPlay:WINDow:TRACe:Y[:SCALe]:NRPosition <integer>:DISPlay:WINDow:TRACe:Y[:SCALe]:NRPosition?
Sets TG normalize reference position.
Gets TG normalize reference position.
IntegerParameter
Type
Parameter
Range
Return0 ~ 100%
Float

Default

100%

Menu

TG > Normal Ref Pos

Example:DISPlay:WINDow:TRACe:Y:NRPosition 10

CommandFormatInstruction:TRACe:COPY:REF
Save trace A to Ref trace

Parameter
Type
Parameter
Range
ReturnDefault
Menu

TG > Store Ref

Example:TRACe:COPY:REF

Programming Guide

87

SIGLENT
CommandFormatInstruction
Parameter
Type
Parameter
Range
Return:DISPlay:WINDow:NTTRace[:STATe] OFF|ON|0|1:DISPlay:WINDow:NTTRace[:STATe]?
Sets TG normalize reference trace on or off.
Gets the state of TG normalize reference trace.
Boolean
OFF|ON|0|1
0|1

Default

0

Menu

TG > Ref Trace

Example:DISPlay:WINDow:NTTRace ON

4.11 Demod Subsystem[:SENSe]:DEMod[:SENSe]:DEMod:TIME[:SENSe]:DEMod:EPHone[:SENSe]:DEMod:VOLume

CommandFormatInstruction
Parameter
Type
Parameter
Range
Return[:SENSe]:DEMod AM|FM|OFF[:SENSe]:DEMod?
Sets demod mode.
Gets demod mode.
Enumeration
AM|FM|OFF
Enumeration

Default

OFF

Menu

Demod

Example:DEMod AM

CommandFormatInstruction[:SENSe]:DEMod:TIME <time>[:SENSe]:DEMod:TIME?
Sets demod time.
Gets demod time.
Float, unit: ms, us, sParameter
Type
Parameter
Range
Return5 ms ~1000 s
Float, unit: sDefault

5 ms

Menu

Demod

88

Programming GuideSIGLENT
ExampleDEMod:TIME 5 ms

CommandFormatInstruction[:SENSe]:DEMod:EPHone OFF|ON|0|1[:SENSe]:DEMod:EPHone?
Sets earphone on-off.
Gets earphone on-off.
BooleanParameter
Type
Parameter
Range
ReturnOFF|ON|0|1
0|1

DefaultOFF

Menu

Demod > Earphone

Example:DEMod:EPHone ON

CommandFormatInstruction[:SENSe]:DEMod:VOLume <value>[:SENSe]:DEMod:VOLume?
Sets volume value.
Gets volume value.
IntegerParameter
Type
Parameter
Range
Return0 ~ 10Integer

Default

6

Menu

Demod > Volume

Example:DEMod:EPHone ON

Programming Guide

89

SIGLENT

5.Vector Network Analyzer
The 'ch' in Command is a channel parameter in VNA mode, only supports 1, and can beomitted. That is used to be compatible with the command format of other companies. In
most cases, it can be ignored.
The Commands in this mode is compatible with Agilent Technologies E5071C series
network analyzer

Frequency Subsection
Display Subsection
Bandwidth Subsection
Sweep Subsection
Trace Subsection
Marker Subsection
Calibration Subsystem
Port Extensions

5.1 Frequency Subsection[:SENSe[ch]]:FREQuency:CENTer[:SENSe[ch]]:FREQuency:STARt[:SENSe[ch]]:FREQuency:STOP[:SENSe[ch]]:FREQuency:SPAN

CommandFormatInstruction
Parameter
Type
Parameter
Range
Return[:SENSe[ch]]:FREQuency:CENTer <freq>[:SENSe[ch]]:FREQuency:CENTer?
Sets the center frequency of VNA.
Gets the center frequency.
Float, unit: Hz, kHz, MHz, GHz
100.05 kHz ~ 3.199999950 GHz
Float, unit: Hz

Default

1.60005 GHz

Menu

Frequency > Center Freq

Example:FREQuency:CENTer 0.2 GHz

90

Programming GuideSIGLENT:SENSe1:FREQuency:CENTer 0.2 GHz:SENSe:FREQuency:CENTer 0.2 GHz

CommandFormatInstruction
Parameter
Type
Parameter
Range
Return[:SENSe[ch]]:FREQuency:STARt <freq>[:SENSe[ch]]:FREQuency:STARt?
Sets the start frequency of VNA.
Gets the start frequency.
Float, unit: Hz, kHz, MHz, GHz
100 kHz ~ 3.1999999 GHz
Float, unit: Hz

Default

100 kHz

Menu

Frequency > Start Freq

Example:FREQuency:STARt 10 MHz

CommandFormatInstruction[:SENSe[ch]]:FREQuency:STOP <freq>[:SENSe[ch]]:FREQuency:STOP?
Sets the stop frequency of VNA.
Gets the stop frequency.
Float, unit: Hz, kHz, MHz, GHz

Parameter
Type
Parameter
Range
Return100.01 kHz ~ 3.2 GHz
Float, unit: Hz

Default

3.2 GHz

Menu

Frequency > Stop Freq

Example:FREQuency:STOP 1.0 GHz

CommandFormatInstruction[:SENSe[ch]]:FREQuency:SPAN <freq>[:SENSe[ch]]:FREQuency:SPAN?
Sets the span of VNA.
Gets the span frequency.
Float, unit: Hz, kHz, MHz, GHz

Parameter
Type
Parameter
Range
Return100 Hz ~ 3.1999 GHz
Float, unit: Hz

Default

3.1999 GHz

Menu

Span > Span

Example:FREQuency:SPAN 1 GHz

Programming Guide

91

SIGLENT

5.2 Display Subsection:DISPlay:WINDow[ch]:TRACe[1]|2|3|4:Y[:SCALe]:AUTO:DISPlay:WINDow[ch]:TRACe[1]|2|3|4:Y[:SCALe]:RLEVel:DISPlay:WINDow[ch]:TRACe[1]|2|3|4:Y[:SCALe]:PDIVision:DISPlay:WINDow[ch]:TRACe[1]|2|3|4:Y[:SCALe]:RPOSition

CommandFormatInstruction:DISPlay:WINDow[ch]:TRACe[1]|2|3|4:Y[:SCALe]:AUTO

Parameter
Type
Parameter
Range
ReturnNone

Default

None

Menu

Amplitude > Auto Scale

Example:DISPlay:WINDow1:TRACe2:Y:SCALe:AUTO

CommandFormatInstruction:DISPlay:WINDow[ch]:TRACe[1]|2|3|4:Y[:SCALe]:RLEVel <value>:DISPlay:WINDow[ch]:TRACe[1]|2|3|4:Y[:SCALe]:RLEVel?
Sets reference level.
Gets reference level.
Float Unit: dB, time units(s, ms, us, ps)Parameter
Type
Parameter
Range
ReturnSets auto scale.

None
None

-1000 dB ~ 1000 dB
Float

Default

0 dBm

Menu

Amplitude > Ref Level

Example:DISPlay:WINDow:TRACe:Y:RLEVel 20 DB

CommandFormatInstruction
Parameter
Type
Parameter
Range
Return92:DISPlay:WINDow[ch]:TRACe[1]|2|3|4:Y[:SCALe]:PDIVision <integer>:DISPlay:WINDow[ch]:TRACe[1]|2|3|4:Y[:SCALe]:PDIVision?
This command sets the per-division display scaling for the y-axis.
Gets Scale/Div
Float, Unit: dB, time units (s, ms, us, ps)
0.1 dB ~ 1000 dB
Float

Programming GuideSIGLENT
Default

10 dB

Menu

Amplitude > Scale/Div

Example:DISPlay:WINDow:TRACe:Y:PDIVision 10 dB

CommandFormatInstruction:DISPlay:WINDow[ch]:TRACe[1]|2|3|4:Y[:SCALe]:RPOSition <integer>:DISPlay:WINDow[ch]:TRACe[1]|2|3|4:Y[:SCALe]:RPOSition?
Sets Reference Scale Position.
Gets Reference Scale Position.
IntegerParameter
Type
Parameter
Range
Return0 ~ 10Integer

Default

5

Menu

Amplitude > Ref Position

Example:DISPlay:WINDow:TRACe:Y:SCALe:RPOSition 10

5.3 Bandwidth Subsection[:SENSe[ch]]:BWIDth[:RESolution]?

CommandFormatInstruction[:SENSe[ch]]:BWIDth[:RESolution]?
Querys Intermediate Frequency Bandwidth.

Parameter
Type
Parameter
Range
ReturnNone

Default

10 kHzMenu

BW > IFBWExample:BWIDth?

None
Float, Unit: Hz

5.4 Sweep Subsection[:SENSe[ch]]:SWEep:POINts:INITiate[ch][:IMMediate]:INITiate[ch]:CONTinuous
ABORt

Programming Guide

93

SIGLENT
CommandFormatInstruction
Parameter
Type
Parameter
Range
Return[:SENSe[ch]]:SWEep:POINts <integer>[:SENSe[ch]]:SWEep:POINts?
Sets sweep points.
Gets sweep points.
Integer
101 ~ 751
Integer

Default

201

Menu

Sweep > Points

Example:SWEep:POINts?

CommandFormatInstruction:INITiate[ch][:IMMediate]Parameter
Type
Parameter
Range
ReturnDefault

Restarts the current sweep.
:INITiate:RESTart and :INITiate:IMMediate perform exactly the same function.
None
None
None
None

Menu
Example:INITiate:IMMediate

CommandFormatInstruction:INITiate[ch]:CONTinuous OFF|ON|0|1:INITiate[ch]:CONTinuous?
Sets continuous sweep mode on-off.
Gets continuous sweep mode state.
BooleanParameter
Type
Parameter
Range
ReturnOFF|ON|0|1
0|1

Default

ON

Menu

Sweep > Sweep

Example:INITiate:CONTinuous OFF

CommandFormatInstruction

ABORt

94

This command is used to stop the current measurement. It aborts the current measurement
as quickly as possible, resets the sweep and trigger systems, and puts the measurement into
an "idle" state.

Programming GuideSIGLENT
If the analyzer is set for Continuous measurement, it sets up the measurement and initiates
a new data measurement sequence with a new data acquisition (sweep) taken once thetrigger condition is met.

Parameter
Type
Parameter
Range
ReturnIf the analyzer is set for Single measurement, it remains in the "idle" state until
an :INIT:IMM command is received.
None
None
None

Default

None

Menu

None

ExampleABORt

5.5 Trace Subsection:CALCulate[ch]:PARameter[1]2|3|4:DEFine:CALCulate[ch][:SELected]:FORMat:CALCulate[ch]:PARameter[1]|2|3|4:SELect:CALCulate[ch]:PARameter:COUNt
DISP:WINDow[ch]:TRACe[1]|2|3|4:STATeDISP:WINDow[ch]:TRACe[1]|2|3|4:MEMory[:STATe]:TRACe[1]|2|3|4:HOLD:CALCulate[ch][:SELected]:MATH:MEMorize:CALCulate[ch][:SELected]:MATH:FUNCtion:CALCulate[ch][:SELected]:DATA:FDATa:CALCulate[ch][:SELected]:DATA:FMEMory:FORMat[:TRACe][:DATA][:SENSe]:AVERage:TRACe[1]|2|3|4:COUNt[:SENSe]:AVERage:TRACe1|2|3|4:STATe[:SENSe[ch]]:AVERage:COUNt[:SENSe[ch]]:AVERage:STATe

CommandFormatInstruction
Parameter
Type:CALCulate[ch]:PARameter[1]2|3|4:DEFine:CALCulate[ch]:PARameter[1]2|3|4:DEFine?
Sets Measurement parameter.
Gets Measurement parameter.
Enumeration

Programming Guide

95

SIGLENT
Parameter
Range
Return

S11
S21
Enumeration

Default

S11

Menu

Meas

Example:CALCulate1:PARameter2:DEFine S11

CommandFormatInstruction:CALCulate[ch][:SELected]:FORMat:CALCulate[ch][:SELected]:FORMat?
Sets displayed data format of VNA.
Querys displayed data format of VNA.
Enumeration

Parameter
Type
Parameter
Range

ReturnMLOGarithmic: Log magnitude
PHASe: Phase in degrees
GDELay: Group delay
SLINear: Smith chart (Lin/Phase)
SLOGarithmic: Smith chart (Log/Phase)
SCOMplex: Smith chart (Real/Imag)
SMITh: Smith chart (R+jX)
SADMittance: Smith chart (G+jB)
PLINear: Polar chart(Lin/Phase)
PLOGarithmic: Polar chart (Log/Phase)
POLar: Polar chart (Real/Imag)
MLINear: Linear magnitude
SWR: Standing Wave Ratio
Enumeration

Default

MLOGarithmic

Menu

Meas > Format

Example:CALCulate1:FORMat SWR

CommandFormatInstruction:CALCulate[ch]:PARameter[1]|2|3|4:SELect

Parameter
Type
Parameter
Range
ReturnNone

Default

None

Menu

Trace > Select Trace

Example:CALCulate:PARameter2:SELect

CommandFormatInstruction:CALCulate[ch]:PARameter:COUNt <integer>:CALCulate[ch]:PARameter:COUNt?
Sets trace number.

96

Sets the trace to the current

None
None

Programming GuideSIGLENT
Gets trace number.
Parameter
Type
Parameter
Range
ReturnInteger

Default

1

Menu

Trace > Num of Trace

Example:CALCulate:PARameter:COUNt 4

CommandFormatInstruction

DISP:WINDow[ch]:TRACe[1]|2|3|4:STATeDISP:WINDow[ch]:TRACe[1]|2|3|4:STATe?
Turns on/off trace data display state.
Gets trace data display state.
BooleanParameter
Type
Parameter
Range
Return1~4
None

OFF|ON|0|1
0|1

Default

ON

Menu

Trace > Display

Example

DISP:WINDow:TRACe2:STATe OFF

CommandFormatInstruction

DISP:WINDow[ch]:TRACe[1]|2|3|4:MEMory[:STATe]DISP:WINDow[ch]:TRACe[1]|2|3|4:MEMory[:STATe]?
Turn on/off trace memory display state.
Gets trace memory display state.
BooleanParameter
Type
Parameter
Range
ReturnOFF|ON|0|1
0|1

Default

0

Menu

Trace > Display

Example

DISP:WINDow[ch]:TRACe[ch]:MEMory OFFCommandFormatInstruction:TRACe[1]|2|3|4:HOLD:TRACe[1]|2|3|4:HOLD?
Sets trace hold type.
Gets trace hold type.
Enumeration

Parameter
Type
Parameter
Range

OFF: close trace hold
MAX: max hold

Programming Guide

97

SIGLENT
MIN: min hold
ReturnDefault

OFF
MAX
MIN
0

Menu

Trace > Trace Hold

Example:TRACe2:HOLD MAX

CommandFormatInstruction:CALCulate[ch][:SELected]:MATH:MEMorize

Parameter
Type
Parameter
Range
ReturnNone

Default

None

Menu

Trace> Data->Mem

Example:CALCulate1:SELected:MATH:MEMorize

CommandFormatInstruction:CALCulate[ch][:SELected]:MATH:FUNCtion:CALCulate[ch][:SELected]:MATH:FUNCtion?
Sets trace math type

Parameter
Type
Parameter
Range

Enumeration

Copies trace data to memory.

None
None

ReturnDIVide
MULtiply
SUBtract
ADD
OFF
Enumeration

Default

OFF

Menu

Trace > Math

Example:CALCulate1:SELected:MATH:MEMorize

CommandFormatInstruction:CALCulate[ch][:SELected]:DATA:FDATa:CALCulate[ch][:SELected]:DATA:FDATa?
Sets format trace data.
Querys format trace data.
Array data representing NOP (number of measurement points)*2 (formatted data array). N
is an integer between 1 and NOP.
• Data (n*2-2): Data from the nth measuring point (real part).
• Data (n*2-1): data from the nth measurement point (imaginary part).

Parameter
Type

98

Programming GuideSIGLENT•

Array index starts at 0

Parameter
Range
ReturnArray data

Default

None

Menu

None

Example:CALCulate:DATA:FDATa 1,0,0.5,1CommandFormatInstruction:CALCulate[ch][:SELected]:DATA:FMEMory:CALCulate[ch][:SELected]:DATA:FMEMory?
Sets format Memory data
Query format Memory data
Array data representing NOP (number of measurement points)*2 (formatted data array). N
is an integer between 1 and NOP.
• Data (n*2-2): Data from the nth measuring point (real part).
• Data (n*2-1): data from the nth measurement point (imaginary part).
• Array index starts at 0

Parameter
Type

Parameter
Range
ReturnMemory data

Default

None

Menu

None

Example:CALCulate:DATA: FMEMory 1,0,0.5,1CommandFormatInstruction:FORMat[:TRACe][:DATA] ASCii|REAL,64|REAL,32:FORMat[:TRACe][:DATA]?
Sets trace data type.
Gets trace data type.
Enumeration

Parameter
Type
Parameter
Range

ReturnASCii
REAL,32 Binary 32-bit real values in the current Y Axis Unit, in a definite
length block.
REAL,64 Binary 64-bit real values in the current Y Axis Unit, in a definite
length block.
You can also use the following parameters
REAL32: Binary 32-bit real values in the current Y Axis Unit, in a definite
length block.
REAL: Binary 64-bit real values in the current Y Axis Unit, in a definite
length block.
StringDefault

ASCii

Menu

None

Example:FORMat ASCii

Programming Guide

99

SIGLENT

CommandFormatInstruction
Parameter
Type
Parameter
Range
Return[:SENSe]:AVERage:TRACe[1]|2|3|4:COUNt <integer>[:SENSe]:AVERage:TRACe[1]|2|3|4:COUNt?
Sets trace average count.
Gets trace average count.
Integer
1 ~ 999
Integer

Default

100

Menu

Trace > Average

Example:AVERage:TRACe:COUNt 200

CommandFormatInstruction[:SENSe]:AVERage:TRACe1|2|3|4:STATe OFF|ON|0|1[:SENSe]:AVERage:TRACe1|2|3|4:STATe?
Sets trace average State.
Gets trace average State.
It will set the average state of all traces without trace parameters.
BooleanParameter
Type
Parameter
Range
ReturnOFF|ON|0|1
0|1

Default

OFF

Menu

Trace > Average

Example:AVERage:TRACe1:STATe ON

CommandFormatInstruction[:SENSe[ch]]:AVERage:COUNt <integer>[:SENSe[ch]]:AVERage:COUNt?
Sets trace average count.
Gets trace average count(Default Trace 1).
IntegerParameter
Type
Parameter
Range
Return1 ~ 999
Integer

Default

100

Menu

Trace > Average

Example:AVERage:COUNt 200

CommandFormatInstruction[:SENSe[ch]]:AVERage:STATe OFF|ON|0|1[:SENSe[ch]]:AVERage:STATe?
Sets all trace average State.
Gets all trace average State.

100

Programming GuideSIGLENT
Parameter
Type
Parameter
Range
ReturnBooleanDefault

OFF

Menu

Trace > Average

Example:AVERage:TRACe1:STATe ON

OFF|ON|0|1
0|1

5.6 Marker Subsection:CALCulate[ch]:MARKer[1]|2|3|4|5|6|7STATe:CALCulate[ch]:MARKer[1]|2|3|4|5|6|7:MODE:CALCulate[ch]:MARKer[1]|2|3|4|5|6|7:X:CALCulate[ch]:MARKer[1]|2|3|4|5|6|7:Y?
:CALCulate[ch][:SELected]:MARKer:REFerence[:STATe]:CALCulate[ch][:SELected]:MARKer:DISCrete:CALCulate:MARKer:AOFF:CALCulate[ch][:SELected]:MARKer:COUPle:CALCulate:MARKer[1]|2|3|4|5|6|7:MAXimum:CALCulate:MARKer[1]|2|3|4|5|6|7:MINimize:CALCulate:MARKer[1]|2|3|4|5|6|7:CPSearch[:STATe]:CALCulate:MARKer[1]|2|3|4|5|6|7:CVSearch[:STATe]:CALCulate:MARKer[1]|2|3|4|5|6|7[:SET]:START:CALCulate:MARKer[1]|2|3|4|5|6|7[:SET]:STOP:CALCulate:MARKer[1]|2|3|4|5|6|7[:SET]:CENTer:CALCulate:MARKer[1]|2|3|4|5|6|7:DELTa[:SET]:SPAN

CommandFormatInstruction
Parameter
Type
Parameter
Range
Return:CALCulate[ch]:MARKer[1]|2|3|4|5|6|7STATe OFF|ON|0|1:CALCulate[ch]:MARKer[1]|2|3|4|5|6|7:STATe?
Sets marker state.
Gets marker state.
Boolean
OFF|ON|0|1
0|1

Default

OFF

Menu

Marker

Programming Guide

101SIGLENT
Example:CALCulate:MARK1:STATe ON

CommandFormatInstruction:CALCulate[ch]:MARKer[1]|2|3|4|5|6|7:MODE POSition|DELTa|OFF:CALCulate[ch]:MARKer[1]|2|3|4|5|6|7:MODE?
Sets marker mode.
Gets marker mode.
Enumeration

Parameter
Type
Parameter
Range
ReturnPOSition
DELTa
OFF
POS|DELT|OFF

Default

OFF

Menu

MarkerExample:CALCulate:MARK1:MODE POSition

CommandFormatInstruction:CALCulate[ch]:MARKer[1]|2|3|4|5|6|7:X <para>:CALCulate[ch]:MARKer[1]|2|3|4|5|6|7:X?
Sets marker X value.
Gets marker X value.
This command only works when marker is not off.
Float, Unit: Hz, kHz, MHz, GHz

Parameter
Type
Parameter
Range
Return

100 kHz ~ 3.2 GHz

Default

1.60005 GHz

Menu

Marker > Normal

Example:CALCulate:MARKer4:X 0.4 GHz

CommandFormatInstruction:CALCulate[ch]:MARKer[1]|2|3|4|5|6|7:Y?

Parameter
Type
Parameter
Range
ReturnNone

Default

None

Gets marker Y value

None
Float

Menu
Example102:CALCulate:MARKer1:Y?

Programming GuideSIGLENT

CommandFormatInstruction

Parameter
Type
Parameter
Range
ReturnDefault:CALCulate[ch][:SELected]:MARKer:REFerence[:STATe]:CALCulate[ch][:SELected]:MARKer:REFerence[:STATe]?
Sets reference marker R state. When set to ON, the other open markers types are changed
to Delta, and when OFF, the open markers are set to Normal.
Gets reference marker R state.
Boolean
OFF|ON|0|1
0|1
OFF

Menu
Example:CALCulate:MARKer:REFerence ON

CommandFormatInstruction:CALCulate[ch][:SELected]:MARKer:DISCrete OFF|ON|0|1:CALCulate[ch][:SELected]:MARKer:DISCrete?
Sets Marker Discrete State (Patterns in which markers move only at measurement points).
Gets Marker Discrete State.
BooleanParameter
Type
Parameter
Range
ReturnOFF|ON|0|1
0|1

DefaultON

Menu

Marker > Discrete

Example:CALCulate:SELected:MARKer:DISCrete?

CommandFormatInstruction:CALCulate:MARKer:AOFF

Parameter
Type
Parameter
Range
ReturnNone

Default

None

Menu

None

Example:CALCulate:MARKer:AOFF

Close all markers of current trace.

None
None

Programming Guide

103

SIGLENT
CommandFormatInstruction
Parameter
Type
Parameter
Range
Return:CALCulate[ch][:SELected]:MARKer:COUPle OFF|ON|0|1:CALCulate[ch][:SELected]:MARKer:COUPle?
Sets marker couple state.
Gets marker couple state.
Boolean
OFF|ON|0|1
0|1

Default

OFF

Menu

Marker > Couple

Example:CALCulate:SELected:MARKer:COUPle?

CommandFormatInstruction:CALCulate:MARKer[1]|2|3|4|5|6|7:MAXimum

Parameter
Type
Parameter
Range
ReturnPerforms a peak search in current trace, you can select current trace byusing :CALCulate[ch]:PARameter[1]|2|3|4:SELect
None
None
None

Default

None

Menu

Peak > Peak

Example:CALCulate:MARKer4:MAXimum

CommandFormatInstruction:CALCulate:MARKer[1]|2|3|4|5|6|7:MINimize

Parameter
Type
Parameter
Range
ReturnPerforms a valley search in current trace, you can select current trace byusing :CALCulate[ch]:PARameter[1]|2|3|4:SELect
None
None
None

Default

None

Menu

Peak > Valley

Example:CALCulate:MARKer4: MINimize

CommandFormatInstruction:CALCulate:MARKer[1]|2|3|4|5|6|7:CPSearch[:STATe] OFF|ON|0|1:CALCulate:MARKer[1]|2|3|4|5|6|7:CPSearch[:STATe]?
Toggles the continuous peak search function between on and off.
Gets the continuous peak search function state.
BooleanParameter
Type

104

Programming GuideSIGLENT
Parameter
Range
ReturnOFF|ON|0|1

Default

None

Menu

Peak > Cont Peak

Example:CALCulate:MARKer1:CPSEarch ON

CommandFormatInstruction:CALCulate:MARKer[1]|2|3|4|5|6|7:CVSearch[:STATe] OFF|ON|0|1:CALCulate:MARKer[1]|2|3|4|5|6|7:CVSearch[:STATe]?
Toggles the continuous valley search function between on and off.
Gets the continuous valley search function state.
BooleanParameter
Type
Parameter
Range
Return0|1

OFF|ON|0|1
0|1

Default

None

Menu

Peak > Cont Valley

Example:CALCulate:MARKer1:CVSEarch ON

CommandFormatInstruction:CALCulate:MARKer[1]|2|3|4|5|6|7[:SET]:START

Parameter
Type
Parameter
Range
ReturnSets the start frequency to the value of the specified marker frequency.
This command is valid when the Marker is on.
None
None
None

Default

None

Menu

Marker→ > M→Start Freq

Example:CALCulate:MARKer1:START

CommandFormatInstruction:CALCulate:MARKer[1]|2|3|4|5|6|7[:SET]:STOP

Parameter
Type
Parameter
Range
ReturnDefault

Sets the stop frequency to the value of the specified marker frequency.
This command is valid when the Marker is on.
None
None
None
None

Programming Guide

105

SIGLENT
Menu

Marker→ > Marker→Stop Freq

Example:CALCulate:MARKer1:STOP

CommandFormatInstruction:CALCulate:MARKer[1]|2|3|4|5|6|7[:SET]:CENTer

Parameter
Type
Parameter
Range
ReturnThis command sets the center frequency equal to the specified marker frequency.
This command is valid when the Marker is on.
None
None
None

Default

None

Menu

Marker→ > M→CFExample:CALCulate:MARKer1:CENTer

CommandFormatInstruction:CALCulate:MARKer[1]|2|3|4|5|6|7:DELTa[:SET]:SPAN

Parameter
Type
Parameter
Range
ReturnThis command sets the span equal to the specified delta marker frequency.
This command can be only used in DELTa marker mode,
Command:CALCulate[ch]:MARKer[1]|2|3|4|5|6|7:MODE
None

Reference

None
None

Default

None

Menu

Marker→ > △M→Span

Example:CALCulate:MARKer2:DELTa:SPAN

5.7 Calibration Subsystem[:SENSe[ch]]:CORRection:RVELocity:COAX[:SENSe[ch]]:CORRection:COLLect[:ACQuire]:LOAD[:SENSe[ch]]:CORRection:COLLect[:ACQuire]:OPEN[:SENSe[ch]]:CORRection:COLLect[:ACQuire]:SHORt[:SENSe[ch]]:CORRection:COLLect[:ACQuire]:THRU[:SENSe[ch]]:CORRection:COLLect:CKIT:LABel[:SENSe]:CORRection:COLLect:CKIT:GENDer

106

Programming GuideSIGLENT[:SENSe[ch]]:CORRection:COLLect:CKIT:LABel:CATalog?
[:SENSe[ch]]:CORRection:COLLect:METHod:SOLT1[:SENSe[ch]]:CORRection:COLLect:METHod[:RESPonse]:THRU[:SENSe[ch]]:CORRection:COLLect:METHod:TYPE?
[:SENSe[ch]]:CORRection:COLLect:CLEar[:SENSe[ch]]:CORRection:COLLect:SAVE

CommandFormatInstruction[:SENSe[ch]]:CORRection:RVELocity:COAX[:SENSe[ch]]:CORRection:RVELocity:COAX?
Sets Velocity Factor.
Gets Velocity Factor.
Float

Parameter
Type
Parameter
Range
Return0.1 ~ 1
Float

Default

0.66

Menu

Meas > Calibration > Velocity Factor

Example:CORRection:RVELocity:COAX 0.5

CommandFormatInstruction[:SENSe[ch]]:CORRection:COLLect[:ACQuire]:LOAD

Parameter
Type
Parameter
Range
ReturnInteger

Default

None

Menu

Meas > Cailbration > Calibrate > 1-Port Cal

Example:CORRection:COLLect:LOAD 1

CommandFormatInstruction[:SENSe[ch]]:CORRection:COLLect[:ACQuire]:OPEN

Parameter
Type
Parameter
Range
ReturnInteger

Default

None

Measures the Load calibration standard that is connected to the specified port.

1 (meas port1)
None

Measures the OPEN calibration standard that is connected to the specified port.

1(meas port1)
None

Programming Guide

107

SIGLENT
Menu

Meas > Cailbration > Calibrate > 1-Port Cal

Example:CORRection:COLLect:OPEN 1

CommandFormatInstruction[:SENSe[ch]]:CORRection:COLLect[:ACQuire]:SHORt

Parameter
Type
Parameter
Range
ReturnInteger

Default

None

Menu

Meas > Cailbration > Calibrate > 1-Port Cal

Example:CORRection:COLLect:SHOR 1

CommandFormatInstruction[:SENSe[ch]]:CORRection:COLLect[:ACQuire]:THRU

Parameter
Type
Parameter
Range
ReturnInteger (Port1 and Port2)

Default

None

Menu

Meas > Cailbration > Calibrate > ResponseThroughExample:CORRection:COLLect:THRU 1,2

CommandFormatInstruction[:SENSe[ch]]:CORRection:COLLect:CKIT:LABel[:SENSe[ch]]:CORRection:COLLect:CKIT:LABel?
Sets the Cal Kit to use.
Gets the Cal Kit.
String(you should use “” when you input kits name)"F503ME", ”85032F”,” 85036B/E”,”User1”,”User2”

Parameter
Type
Parameter
Range
ReturnMeasures the Short calibration standard that is connected to the specified port.

1
None

Measures the THRU calibration standard that is connected between the specified ports.

1, 2
None

"F503ME", ”85032F”,” 85036B/E”, ”User1”,”User2”

Default"F503ME"

Menu

Meas > Cailbration > Cal Kit

Example:CORRection:COLLect:CKIT:LABel ”85032F”

108

Programming GuideSIGLENT
CommandFormatInstruction
Parameter
Type
Parameter
Range
Return[:SENSe]:CORRection:COLLect:CKIT:GENDer[:SENSe]:CORRection:COLLect:CKIT:GENDer？
Setsthe gender of Calibration Kits.
Gets the gender of Calibration Kits.
StringDefault

Male
FemaleMale
FemaleMale

Menu

Meas > Cailbration > Cal Kit

Example:CORRection:COLLect:CKIT:GENDer Female

CommandFormatInstruction[:SENSe[ch]]:CORRection:COLLect:CKIT:LABel:CATalog?

Parameter
Type
Parameter
Range
ReturnNone

Reads the available Cal Kits in the SVA1000.

None"F503ME", ”85032F”,” 85036B/E”

Default
Menu
Example:CORRection:COLLect:CKIT:LABel:CATalog?

CommandFormatInstruction[:SENSe[ch]]:CORRection:COLLect:METHod:SOLT1Parameter
Type
Parameter
Range
ReturnInteger

Default

None

Menu

Meas > Cailbration > Calibrate > 1-Port Cal

Example:CORRection:COLLect:METHod:SOLT1 1

CommandFormat[:SENSe[ch]]:CORRection:COLLect:METHod[:RESPonse]:THRU

Sets the Cal Method to 1-port SOLT calibration.

1
None

Programming Guide

109

SIGLENT
Instruction

Sets the Cal Method to 2-port TRL calibration.

Parameter
Type
Parameter
Range
ReturnInteger

Default

None

Menu

Meas > Cailbration > Calibrate > ResponseThroughExample:CORRection:COLLect:METHod:THRU 1,2

CommandFormatInstruction[:SENSe[ch]]:CORRection:COLLect:METHod:TYPE?

Parameter
Type
Parameter
Range
ReturnNone

Port(1, 2)
NoneQuerys Calibration type.

None"NONE", " SOLT1", " RESPT" (Enheneed Response Not added yet)

Default
Menu
Example:CORRection:COLLect:METHod:TYPE?

CommandFormatInstruction[:SENSe[ch]]:CORRection:COLLect:CLEar

Parameter
Type
Parameter
Range
ReturnNone

Default

None

Menu

None

Example:CORRection:COLLect:CLEar

CommandFormatInstruction[:SENSe[ch]]:CORRection:COLLect:SAVE

Parameter
Type
Parameter
Range

None

110

Clears Calibration Data.

None
None

Ends the calibration

None

Programming GuideSIGLENT
ReturnNone

Default

None

Menu

None

Example:CORRection:COLLect:SAVE

Programming Guide

111

SIGLENT

5.8 Port Extensions[:SENSe[ch]]:CORRection:EXTension[:STATe][:SENSe[ch]]:CORRection:EXTension:PORT[1]2:TIME[SENSe[Ch]]:CORRection:EXTension:AUTO:PORT

CommandFormatInstruction[:SENSe[ch]]:CORRection:EXTension[:STATe][:SENSe[ch]]:CORRection:EXTension[:STATe]?
Sets port extension state.
Gets port extension state.
BooleanParameter
Type
Parameter
Range
ReturnOFF|ON|0|1
0|1

Default

OFF

Menu

Meas > Cailbration > Port Extensions

Example:CORRection:EXTension ON

CommandFormatInstruction[:SENSe[ch]]:CORRection:EXTension:PORT[1]2:TIME[:SENSe[ch]]:CORRection:EXTension:PORT[1]2:TIME?
Sets extended port delay.
Gets extended port delay.
Float

Parameter
Type
Parameter
Range
ReturnFloat

Default

0

Menu

Meas > Cailbration > Port Extensions > Delay Port1|2

Example:CORRection:EXTension:PORT1:TIME

CommandFormatInstruction[SENSe[Ch]]:CORRection:EXTension:AUTO:PORT

Parameter
Type
Parameter
Range
ReturnBooleanDefault

None

Menu

Meas > Cailbration > Port Extensions > Auto Open Port1

112

At present, only automatic open port 1 is supported, and off is not processed

BooleanNone

Programming GuideSIGLENT
ExampleProgramming Guide:CORRection:EXTension:AUTO:PORT 1,ON

113

SIGLENT

6.Distance To Fault
Frequency Subsection
Amplitude Subsection
Sweep Subsection
Trace Subsection
Marker Subsection
Measurement Subsystem

6.1 Frequency Subsection[:SENSe]:FREQuency:CENTer[:SENSe]:FREQuency:STARt[:SENSe]:FREQuency:STOP[:SENSe]:FREQuency:SPAN

CommandFormatInstruction
Parameter
Type
Parameter
Range
Return[:SENSe]:FREQuency:CENTer <freq>[:SENSe]:FREQuency:CENTer?
Sets the center frequency.
Gets the center frequency.
Float, unit: Hz, kHz, MHz, GHz
100.05 kHz ~ 3.199999950 GHz
Float, unit: Hz

Default

1.60005 GHz

Menu

Frequency > Center Freq

Example:FREQuency:CENTer 0.2 GHz:SENSe:FREQuency:CENTer 0.2 GHz

CommandFormatInstruction[:SENSe]:FREQuency:STARt <freq>[:SENSe]:FREQuency:STARt?
Sets the start frequency.
Gets the start frequency.
Float, unit: Hz, kHz, MHz, GHz

Parameter
Type

114

Programming GuideSIGLENT
Parameter
Range
Return

100 kHz ~ 3.1999999 GHz

Default

100 kHz

Menu

Frequency > Start Freq

Example:FREQuency:STARt 10 MHz

CommandFormatInstruction[:SENSe]:FREQuency:STOP <freq>[:SENSe]:FREQuency:STOP?
Sets the stop frequency.
Gets the stop frequency.
Float, unit: Hz, kHz, MHz, GHz

Parameter
Type
Parameter
Range
ReturnFloat, unit: Hz

100.01 kHz ~ 3.2 GHz
Float, unit: Hz

Default

3.2 GHz

Menu

Frequency > Stop Freq

Example:FREQuency:STOP 1.0 GHz

CommandFormatInstruction[:SENSe]:FREQuency:SPAN <freq>[:SENSe]:FREQuency:SPAN?
Sets the span frequency.
Gets the span frequency.
Float, unit: Hz, kHz, MHz, GHz

Parameter
Type
Parameter
Range
Return100 Hz ~ 3.1999 GHz
Float, unit: Hz

Default

3.1999 GHz

Menu

Span > Span

Example:FREQuency:SPAN 1 GHz

6.2 Amplitude Subsection:DISPlay:WINDow:TRACe:Y[:SCALe]:AUTO:DISPlay:WINDow:TRACe:Y[:SCALe]:RLEVel:DISPlay:WINDow:TRACe:Y[:SCALe]:PDIVision

CommandFormatInstruction:DISPlay:WINDow:TRACe:Y[:SCALe]:AUTO
Sets auto scale.

Programming Guide

115

SIGLENT
Parameter
Type
Parameter
Range
ReturnNone

Default

None

Menu

Amplitude > Auto Scale

Example:DISPlay:WINDow:TRACe:Y:SCALe:AUTO

CommandFormatInstruction:DISPlay:WINDow:TRACe:Y[:SCALe]:RLEVel <value>:DISPlay:WINDow:TRACe:Y[:SCALe]:RLEVel?
Sets reference level.
Gets reference level.
Float

Parameter
Type
Parameter
Range
Return

None
None

When meas type is CAT: 0.5~100
When meas type is DTF: -10~10
Float

Default

1

Menu

Amplitude > Ref Level

Example:DISPlay:WINDow:TRACe:Y:RLEVel 2

CommandFormatInstruction:DISPlay:WINDow:TRACe:Y[:SCALe]:PDIVision <integer>:DISPlay:WINDow:TRACe:Y[:SCALe]:PDIVision?
This command sets the per-division display scaling for the y-axis.
Gets Scale/Div.
Float

Parameter
Type
Parameter
Range
ReturnDefault

When meas type is CAT: 0.1~10
When meas type is DTF: 0.01~10
Float

Menu

1
When meas type is CAT:1
When meas type is DTF:5
Amplitude > Scale/Div

Example:DISPlay:WINDow:TRACe:Y:PDIVision 2

6.3 Sweep Subsection:INITiate[:IMMediate]:INITiate:CONTinuous
ABORt

CommandFormat116:INITiate[:IMMediate]

Programming GuideSIGLENT
Instruction
Parameter
Type
Parameter
Range
ReturnDefault

Restarts the current sweep.
:INITiate:RESTart and :INITiate:IMMediate perform exactly the same function.
None
None
None
None

Menu
Example:INITiate:IMMediate

CommandFormatInstruction:INITiate:CONTinuous OFF|ON|0|1:INITiate:CONTinuous?
Sets continuous sweep mode on or off.
Gets continuous sweep mode state.
BooleanParameter
Type
Parameter
Range
ReturnOFF|ON|0|1
0|1

Default

ON

Menu

Sweep > Sweep

Example:INITiate:CONTinuous OFF

CommandFormatInstruction

ABORt
This command is used to stop the current measurement. It aborts the currentmeasurement
as quickly as possible, resets the sweep and trigger systems, and puts the measurement into
an "idle" state.
If the analyzer is set for Continuous measurement, it sets up the measurement and initiates
a new data measurement sequence with a new data acquisition (sweep) taken once thetrigger condition is met.

Parameter
Type
Parameter
Range
ReturnIf the analyzer is set for Single measurement, it remains in the "idle" state until
an :INIT:IMM command is received.
None
None
None

Default

None

Menu

None

Example

INIT;ABORt

Programming Guide

117

SIGLENT

6.4 Trace Subsection
DISP:WINDow:TRACe:STATeDISP:WINDow:TRACe:MEMory[:STATe]:CALCulate[:SELected]:MATH:MEMorize[:SENSe]:AVERage:COUNt[:SENSe]:AVERage:STATe

CommandFormatInstruction
Parameter
Type
Parameter
Range
ReturnDISP:WINDow:TRACe:STATeDISP:WINDow:TRACe:STATe?
Turns on oroff trace data display state.
Gets trace data display state.
Boolean
OFF|ON|0|1
0|1

Default

ON

Menu

Trace > Display

Example

DISP:WINDow:TRACe:STATe OFF

CommandFormatInstruction

DISP:WINDow:TRACe:MEMory[:STATe]DISP:WINDow:TRACe:MEMory[:STATe]?
Turns on oroff trace memory display state.
Gets trace memory display state.
BooleanParameter
Type
Parameter
Range
ReturnOFF|ON|0|1
0|1

Default

OFF

Menu

Trace > Display

Example

DISP:WINDow:TRACe: MEMory OFFCommandFormatInstruction:CALCulate[:SELected]:MATH:MEMorize

Parameter
Type
Parameter
Range
ReturnNone

118

Copies trace data to memory.

None
None

Programming GuideSIGLENT
Default

None

Menu

Trace > Data→Mem

Example:CALCulate:SELected:MATH:MEMorize

CommandFormatInstruction[:SENSe]:AVERage:COUNt <integer>[:SENSe]:AVERage:COUNt?
Sets trace average count.
Gets trace average count.
IntegerParameter
Type
Parameter
Range
Return1 ~ 999
Interger

Default

100

Menu

Trace > Average

Example:AVERage:TRACe:COUNt 200

CommandFormatInstruction[:SENSe]:AVERage:STATe OFF|ON|0|1[:SENSe]:AVERage:STATe?
Sets trace average states.
Gets trace average states.
BooleanParameter
Type
Parameter
Range
ReturnOFF|ON|0|1
0|1

Default

OFF

Menu

Trace > Average

Example:AVERage:TRACe:STATe ON

6.5 Marker Subsection:CALCulate:MARKer[1]|2|3|4|:STATe:CALCulate:MARKer[1]|2|3|4:MODE:CALCulate:MARKer[1]|2|3|4:X:CALCulate:MARKer[1]|2|3|4:Y?
:CALCulate:MARKer[1]|2|3|4:CPSearch[:STATe]:CALCulate:MARKer[1]|2|3|4:CVSearch[:STATe]:CALCulate[:SELected]:MARKer:AOFF:CALCulate:MARKer[1]|2|3|4:MAXimum

Programming Guide

119SIGLENT:CALCulate:MARKer[1]|2|3|4:MINimize

CommandFormatInstruction
Parameter
Type
Parameter
Range
Return:CALCulate:MARKer[1]|2|3|4|:STATe OFF|ON|0|1:CALCulate:MARKer[1]|2|3|4|:STATe?
Sets marker state
Gets marker state.
Boolean
OFF|ON|0|1
0|1

Default

OFF

Menu

MarkerExample:CALCulate:MARK1:STATe ON

CommandFormatInstruction:CALCulate:MARKer[1]|2|3|4:MODE POSition|DELTa|OFF:CALCulate:MARKer[1]|2|3|4:MODE?
Sets marker mode.
Gets marker mode.
Enumeration

Parameter
Type
Parameter
Range
ReturnPOSition
DELTa
OFF
Enumeration: POS|DELT|OFF

Default

OFF

Menu

MarkerExample:CALCulate:MARK1:MODE POSition

CommandFormatInstruction:CALCulate:MARKer[1]|2|3|4:X <para>:CALCulate:MARKer[1]|2|3|4:X?
Sets marker X value.
Gets marker X value.
This command only works when marker is not off.
Float, Unit: Hz, kHz, MHz, GHz，mParameter
Type
Parameter
Range
ReturnWhen meas type is CAT: 100 kHz ~ 3.2 GHz
When meas type is DTF: 0 m ~ 34 m
Float

Default

7.12m/1.59995GHz

Menu

Marker > Normal

Example:CALCulate:MARKer4:X 0.4 m:CALCulate:MARKer4:X?

120

Programming GuideSIGLENT
CommandFormatInstruction:CALCulate:MARKer[1]|2|3|4:Y?

Parameter
Type
Parameter
Range
ReturnNone

Default

None

Menu

Marker > Normal

Example:CALCulate:MARKer:Y?

CommandFormatInstruction:CALCulate:MARKer[1]|2|3|4:CPSearch[:STATe] OFF|ON|0|1:CALCulate:MARKer[1]|2|3|4:CPSearch[:STATe]?
Toggles the continuous peak search function between on and off.
Gets the continuous peak search function state.
BooleanParameter
Type
Parameter
Range
ReturnGets marker Y value.

None
Float

OFF|ON|0|1
0|1

Default

None

Menu

Marker > Cont Peak

Example:CALCulate:MARKer1:CPSEarch ON

CommandFormatInstruction:CALCulate:MARKer[1]|2|3|4:CVSearch[:STATe] OFF|ON|0|1:CALCulate:MARKer[1]|2|3|4:CVSearch[:STATe]?
Toggles the continuous valley search function between on and off.
Gets the continuous valley search function state.
BooleanParameter
Type
Parameter
Range
ReturnOFF|ON|0|1
0|1

Default

None

Menu

Marker > Cont Valley

Example:CALCulate:MARKer1:CVSEarch ON

CommandFormatInstruction:CALCulate[:SELected]:MARKer:AOFF

Parameter
Type

None

Close All Markers of current trace.

Programming Guide

121

SIGLENT
Parameter
Range
ReturnNone

Default

None

None

Menu
Example:CALCulate:MARKer:AOFF

CommandFormatInstruction:CALCulate:MARKer[1]|2|3|4:MAXimum

Parameter
Type
Parameter
Range
ReturnNone

Default

None

Menu

Peak > Peak

Example:CALCulate:MARKer4:MAXimum

CommandFormatInstruction:CALCulate:MARKer[1]|2|3|4:MINimize

Parameter
Type
Parameter
Range
ReturnNone

Default

None

Menu

Peak > Valley

Example:CALCulate:MARKer4:MINimize

Performs a peak search.

None
None

Performs a valley search.

None
None

6.6 Measurement Subsystem:CALCulate:PARameter:DEFine:CALCulate:TRANsform:DISTance:STARt:CALCulate:TRANsform:DISTance:STOP:CALCulate:TRANsform:DISTance:UNIT:CORRection:RVELocity:COAX:CORRection:LOSS:COAX

122

Programming GuideSIGLENT:CALCulate:TRANsform:DISTance:WINDow[:SENSe]:CORRection:COLLect:METHod:SOLT1[:SENSe]:CORRection:COLLect[:ACQuire]:LOAD[:SENSe]:CORRection:COLLect[:ACQuire]:OPEN[:SENSe]:CORRection:COLLect[:ACQuire]:SHORt[:SENSe]:CORRection:COLLect:METHod:TYPE?
[:SENSe]:CORRection:COLLect:CLEar[:SENSe]:CORRection:COLLect:SAVE

CommandFormatInstruction
Parameter
Type
Parameter
Range
Return:CALCulate:PARameter:DEFine DTF|CAT:CALCulate:PARameter:DEFine?
Sets meas type.
Gets meas type.
Enumeration
DTF
CAT
Enumeration: DTF|CAT

Default

REFLcoe

Menu

Meas

Example:CALCulate:PARameter:DEFine DTF

CommandFormatInstruction:CALCulate:TRANsform:DISTance:STARt <value>:CALCulate:TRANsform:DISTance:STARt?
Sets Start Distance.
Gets Start Distance.
Float, Unit: mParameter
Type
Parameter
Range
Return0 m ~ 33.8 m
Float

Default

0m

Menu

Meas > Start Distance

Example:CALCulate:TRANsform:DISTance:STARt 0.5 m

CommandFormatInstruction:CALCulate:TRANsform:DISTance:STOP <value>:CALCulate:TRANsform:DISTance:STOP?
Sets Start Distance.
Gets Start Distance.
Float, Unit: mParameter
Type
ParameterRange

0.2 m ~ 34 m

Programming Guide

123

SIGLENT
ReturnFloat

Default

30.6 mMenu

Meas > Stop Distance

Example:CALCulate:TRANsform:DISTance:STOP 32.5 m

CommandFormatInstruction:CALCulate:TRANsform:DISTance:UNIT METers|FEET:CALCulate:TRANsform:DISTance:UNIT?
Sets unit.
Gets unit.
Enumeration

Parameter
Type
Parameter
Range
ReturnMETersFEET
Enumeration: MET|FEET

Default

MET

Menu

Meas > Unit

Example:CALCulate:TRANsform:DISTance:UNIT FEET

CommandFormatInstruction:CORRection:RVELocity:COAX <value>:CORRection:RVELocity:COAX?
Sets velocity factor.
Gets velocity factor.
Float

Parameter
Type
Parameter
Range
Return10 ~ 100
Float

Default

66

Menu

Meas > Velocity Factor

Example:CORRection:RVELocity:COAX 12.34

CommandFormatInstruction:CORRection:LOSS:COAX <value>:CORRection:LOSS:COAX?
Sets cable atten.
Gets cable atten.
Float

Parameter
Type
Parameter
Range
Return-1000 ~ 10000
Float

Default

0

Menu

Meas > Cable Atten

124

Programming GuideSIGLENT
Example:CORRection:LOSS:COAX 12.34

CommandFormatInstruction:CALCulate:TRANsform:DISTance:WINDow OFF|RECT|HAMM:CALCulate:TRANsform:DISTance:WINDow?
Sets window.
Gets window.
Enumeration

Parameter
Type
Parameter
Range
Return

OFF
RECT
HAMM
Enumeration: OFF|RECT|HAMM

Default

HAMM

Menu

Meas > Window

Example:CALCulate:TRANsform:DISTance:WINDow RECT

CommandFormatInstruction[:SENSe]:CORRection:COLLect:METHod:SOLT1Parameter
Type
Parameter
Range
ReturnInteger

Default

None

Menu

Meas > Cailbration > Calibrate

Example:CORRection:COLLect:METHod:SOLT1 1

CommandFormatInstruction[:SENSe]:CORRection:COLLect[:ACQuire]:LOAD

Parameter
Type
Parameter
Range
ReturnInteger

Default

1

Sets the Cal Method to 1-port SOLT calibration.

1
None

Measures the Load calibration standard that is connected to the specified port.

1
None

Menu
Example:CORRection:COLLect:LOAD 1

Programming Guide

125

SIGLENT
CommandFormatInstruction[:SENSe]:CORRection:COLLect[:ACQuire]:OPEN

Parameter
Type
Parameter
Range
ReturnInteger

Default

1

Measures the Open calibration standard that is connected to the specified port.

1
None

Menu
Example:CORRection:COLLect:OPEN 1

CommandFormatInstruction[:SENSe]:CORRection:COLLect[:ACQuire]:SHORt

Parameter
Type
Parameter
Range
ReturnInteger

Default

1

Measures the Short calibration standard that is connected to the specified port.

1
None

Menu
Example:CORRection:COLLect:SHOR 1

CommandFormatInstruction[:SENSe]:CORRection:COLLect:METHod:TYPE?

Parameter
Type
Parameter
Range
ReturnNoneQuerys Calibration type.

None"NONE", " SOLT1", ” RESPT”

Default
Menu
Example:CORRection:COLLect:METHod:TYPE?

CommandFormatInstruction[:SENSe]:CORRection:COLLect:CLEar

Parameter
Type

None

126

Clears Calibration Data.

Programming GuideSIGLENT
Parameter
Range
ReturnNone

Default

None

None

Menu
Example:CORRection:COLLect:CLEar

CommandFormatInstruction[:SENSe]:CORRection:COLLect:SAVE

Parameter
Type
Parameter
Range
ReturnNone

Default

None

Ends the calibration.

None
None

Menu
Example:CORRection:COLLect:SAVE

Programming Guide

127

SIGLENT

7.Modulation Analyzer
Amplitude Subsection
BW Subsection
Sweep Subsection
Trace Subsection
Marker Subsection
Measurement Subsystem
Trigger Subsection

7.1 Frequency Subsection[:SENSe]:FREQuency:CENTer[:SENSe]:FREQuency:CENTer:STEP[:INCRement][:SENSe]:FREQuency:SPAN?

CommandFormatInstruction
Parameter
Type
Parameter
Range
Return[:SENSe]:FREQuency:CENTer <freq>[:SENSe]:FREQuency:CENTer?
Sets the center frequency.
Gets the center frequency.
Float, unit: Hz, kHz, MHz, GHz
0 Hz ~ 3.2 GHz
Float, unit: Hz

Default

100 MHz

Menu

Frequency > Center Freq

Example[:SENSe]:FREQuency:CENTer 300 MHz

CommandFormatInstruction[:SENSe]:FREQuency:CENTer:STEP[:INCRement] <freq>[:SENSe]:FREQuency:CENTer:STEP[:INCRement]?
Sets frequency step.
Gets frequency step.
Float, unit: Hz, kHz, MHz, GHz

Parameter
Type

128

Programming GuideSIGLENT
Parameter
Range
Return1 Hz ~ 100 MHz

Default

10 kHzMenu

Frequency > Freq Step

Example[:SENSe]:FREQuency:CENTer:STEP[:INCRement] 20 MHz

CommandFormatInstruction[:SENSe]:FREQuency:SPAN?

Parameter
Type
Parameter
Range
ReturnFloat, unit: Hz

Querys span.
The span of modulation analyzer mode is determined by multiple measurement parameters,
and can not be set directly.
None
None
Float, unit: Hz

Default

31.25 kHz

Menu

Span > Span

Example[:SENSe]:FREQuency:SPAN?

7.2 Amplitude Subsection[:SENSe]:POWer[:RF]:ATTenuation[:SENSe]:POWer[:RF]:ATTenuation:AUTO:TRACe1|2|3|4:Y[:SCALe]:RLEVel:TRACe1|2|3|4:Y[:SCALe]:PDIVision:TRACe1|2|3|4[:Y]:AUToscale

CommandFormatInstruction
Parameter
Type
Parameter
Range
Return[:SENSe]:POWer[:RF]:ATTenuation <value>[:SENSe]:POWer[:RF]:ATTenuation?
Sets the input attenuator.
Gets the input attenuator.
Integer, unit: dB
0 dB ~ 51 dB
Integer, unit: dB

Default

20 dB

Menu

Amplitude > Attenuator

Example[:SENSe]:POWer[:RF]:ATTenuation 30 dB

Programming Guide

129

SIGLENT

CommandFormatInstruction
Parameter
Type
Parameter
Range
Return[:SENSe]:POWer[:RF]:ATTenuation:AUTO OFF|ON|0|1[:SENSe]:POWer[:RF]:ATTenuation:AUTO?
Sets the input attenuator.
Gets the input attenuator.
Boolean
OFF|ON|0|1
0|1

Default

0

Menu

Amplitude > Attenuator

Example[:SENSe]:POWer[:RF]:ATTenuation:AUTO ON

CommandFormatInstruction:TRACe1|2|3|4:Y[:SCALe]:RLEVel <value>:TRACe1|2|3|4:Y[:SCALe]:RLEVel?
This command sets the reference level for the Y-axis.
Gets reference level.
The command is valid if the measurement mode is ASK, FSK, MSK, PSK, QAM and thedata format is not Syms/Errs.
Float

Parameter
Type
Parameter
Range

ReturnIf the display type is Log Mag: -1000 ~ 1000
If the display type is Lin Mag: -1000 ~ 1000
If the display type is Real: -1000 ~ 1000
If the display type is Imag: -1000 ~ 1000
If the display type is I-Q: -1000 ~ 1000
If the display type is Constellation: -1000 ~ 1000
If the display type is I-Eye: -1000 ~ 1000
If the display type is Q-Eye: -1000 ~ 1000
If the display type is Wrap Phase: -1000 ~ 1000
If the display type is Unwrap Phase: -1000 ~ 1000
If the display type is Trellis-Eye: -1e5 ~ 1e9
Float

Default
Menu

Amplitude > Ref Level

Example:TRACe4:Y:RLEVel 2

CommandFormatInstruction:TRACe1|2|3|4:Y[:SCALe]:PDIVision <value>:TRACe1|2|3|4:Y[:SCALe]:PDIVision?
This command sets the per-division display scaling for the y-axis.
Gets Scale/Div when scale type.
The command is valid if the measurement mode is ASK, FSK, MSK, PSK, QAM and thedata format is not Syms/Errs.
Float

Parameter
Type
Parameter
Range
Return130

Float

Programming GuideSIGLENT
Default
Menu

Amplitude > Scale/Div

Example:TRACe4:Y:PDIVision 2

CommandFormatInstruction:TRACe1|2|3|4[:Y]:AUToscale

Parameter
Type
Parameter
Range
ReturnNone

Default

None

Menu

Amplitude > Auto Scale

Example:TRACe2:AUToscale

Sets auto scale.

None
None

7.3 BW Subsection[:SENSe]:BWIDth[:RESolution]?
[:SENSe]:DDEMod:FFT:WINDow:TYPE

CommandFormatInstruction[:SENSe]:BWIDth[:RESolution]?
Querys equalization BW.

Parameter
Type
Parameter
Range
ReturnNone

Default

100 kHz

Menu

BW > EQBW

Example:BWIDth?

CommandFormatInstruction[:SENSe]:DDEMod:FFT:WINDow:TYPE[:SENSe]:DDEMod:FFT:WINDow:TYPE?
Sets FFT window function.
Gets FFT window function.
Enumeration
RECTangular
HAMMing :HANNing
FLATtop

Parameter
Type

None
Float, unit: Hz

Programming Guide

131

SIGLENT
BLACkmanParameter
Range
ReturnNone

Default

Enumeration RECT
HAMM
HANN
FLAT
BLAC
100 kHz

Menu

BW > Window

Example:DDEMod:FFT:WINDow:TYPE BLAC

7.4 Sweep Subsection:INITiat[:IMMediate]:INITiate:CONTinuous
ABORt

CommandFormatInstruction
Parameter
Type
Parameter
Range
ReturnDefault:INITiat[:IMMediate]
Restart the current sweep.
:INITiate:RESTart and :INITiate:IMMediate perform exactly the same function.
None
None
None
None

Menu
Example:INITiate:IMMediate

CommandFormatInstruction:INITiate:CONTinuous OFF|ON|0|1:INITiate:CONTinuous?
Sets continuous sweep mode on-off.
Gets continuous sweep mode state.
BooleanParameter
Type
Parameter
Range
ReturnOFF|ON|0|1
0|1

Default

ON

Menu

Sweep > Sweep

Example:INITiate:CONTinuous OFF

132

Programming GuideSIGLENT

CommandFormatInstruction

ABORt
This command is used to stop the current measurement. It aborts the currentmeasurement
as quickly as possible, resets the sweep and trigger systems, and puts the measurement into
an "idle" state.
If the analyzer is set for Continuous measurement, it sets up the measurement and initiates
a new data measurement sequence with a new data acquisition (sweep) taken once thetrigger condition is met.

Parameter
Type
Parameter
Range
ReturnIf the analyzer is set for Single measurement, it remains in the "idle" state until
an :INIT:IMM command is received.
None
None
None

Default

None

Menu

None

Example

INIT;ABORt

7.5 Trace Subsection:CALCulate:PARameter:COUNt:DISPlay:LAYout:TRACe[1]|2|3|4:DATA:NAME:TRACe[1]|2|3|4:FORMat[:Y]:TRACe:COPY:TRACe:DEMod:EYE:LENGth:TRACe:DEMod:TABLe:FORMat

CommandFormatInstruction
Parameter
Type
Parameter
Range
Return:CALCulate:PARameter:COUNt <integer>:CALCulate:PARameter:COUNt?
Sets trace number.
Gets trace number.
Integer
1~4Integer

Default

1

Menu

Trace > Num of Traces

Example:CALCulate:PARameter:COUNt 4

Programming Guide

133

SIGLENT

CommandFormatInstruction
Parameter
Type
Parameter
Range
Return:DISPlay:LAYout <integer,integer>
Sets trace layout on screen.
Currently, one row, two columns are not supported (1, 2)Integer (rows, columns)
rows 1 ~ 2columns 1 ~ 2

Default

two rows, two columns

Menu

Trace > Layout

Example:DISPlay:LAYout 2,2CommandFormatInstruction:TRACe[1]|2|3|4:DATA:NAME:TRACe[1]|2|3|4:DATA:NAME?
Sets trace format.
Gets trace format.
Enumeration

Parameter
Type
Parameter
Range

TIME: time
SPECtrum: spectrum
MTIMe: IQ meas time
MSPEctrum: IQ meas spectrum (FFT of IQ Meas Time.)
RTIMe: IQ Reference time (Reconstructed ideal time waveform to compare IQ Meas Timeagainst)
RSPEctrum: IQ Reference spectrum (FFT of IQ Reference time.)
MERRor: IQ Mag Err (Difference in length of the IQ Meas Time vector and IQ Ref Time
vectorat each point in time.)
PERRor: IQ Phase Err (Difference in phase of the IQ Meas Time vector and IQ Ref Time
vector at each point in time.)
EVTime: Error Time (Vector difference between IQ Meas Time and IQ Ref Time at eachpointin time.)
EVSPectrum: Error Vector Spec

ReturnSYMSerrs: Syms/Errs
Enumeration

Default
Menu

Trace > Format

Example:TRACe:DATA:NAME SYMS

134

Programming GuideSIGLENT

CommandFormatInstruction
Parameter
Type
Parameter
Range

Return:TRACe[1]|2|3|4:FORMat[:Y]:TRACe[1]|2|3|4:FORMat[:Y]?
Sets trace format
Gets trace format
Enumeration
MLOG: Log Mag
MLINear: Lin Mag
REAL: RealIMAGinary: Imag
IQ: I-Q
CONStln: Constellation
IEYE: I-Eye
QEYE: Q-Eye
WPHAse: Wrap Phase
UWPHase: Unwrap Phase
TRELlis: Trellis-Eye
MLOG
MLIN
REAL
IMAG
IQ
CONS
IEYE
QEYE
WPHA
UWPH
TREL

Default
Menu

Trace > Format

Example:TRACe:FORMat MLIN

CommandFormatInstruction:TRACe:COPY <from,to>Parameter
Type
Parameter
Range
ReturnEnumeration

Default

None

Menu

Trace > Copy To

Example:TRACe:COPY A,B:TRACe:COPY TRACE1,TRACE2

CommandFormatInstruction:TRACe:DEMod:EYE:LENGth <integer>:TRACe:DEMod:EYE:LENGth?
Sets eye length.
Gets eye length.

Copies trace data to another trace.

A|B|C|D orTRACE1| TRACE2| TRACE2| TRACE4
None

Programming Guide

135

SIGLENT
Parameter
Type
Parameter
Range
ReturnInteger

Default

2

Menu

Trace > Properties

Example:TRACe:DEMod:EYE:LENGth 4

CommandFormatInstruction:TRACe:DEMod:TABLe:FORMat:TRACe:DEMod:TABLe:FORMat?
Displays format of Symbol Table data.

Parameter
Type
Parameter
Range
ReturnEnumeration

Default

HEX

Menu

Trace > Properties

Example:TRACe:DEMod:TABLe:FORMat HEX

2 ~ 40Integer

BINary|HEXadecimal
Enumeration BIN|HEX

7.6 Marker Subsection:TRACe[1]|2|3|4:MARKer[1]|2|3|4:ENABle:TRACe[1]|2|3|4:MARKer[1]|2|3|4:TYPE:TRACe[1]|2|3|4:MARKer[1]|2|3|4:X:TRACe[1]|2|3|4:MARKer[1]|2|3|4:Y?
:TRACe[1]|2|3|4:MARKer[1]|2|3|4:REFerence:CALCulate[:SELected]:MARKer:COUPle:CALCulate:MARKer:AOFF

CommandFormatInstruction
Parameter
Type
Parameter
Range
Return:TRACe[1]|2|3|4:MARKer[1]|2|3|4:ENABle OFF|ON|0|1:TRACe[1]|2|3|4:MARKer[1]|2|3|4:ENABle?
Sets marker state.
Gets marker state.
Boolean
OFF|ON|0|1
0|1

Default

OFF

Menu

Marker136

Programming GuideSIGLENT
Example:TRACe1:MARKer1:ENABle ON

CommandFormatInstruction:TRACe[1]|2|3|4:MARKer[1]|2|3|4:TYPE POSition|DELTa|OFF:TRACe[1]|2|3|4:MARKer[1]|2|3|4:TYPE?
Sets marker mode.
Gets marker mode.
Enumeration

Parameter
Type
Parameter
Range
ReturnPOSition
DELTa
OFF
Enumeration: POS|DELT|OFF

Default

OFF

Menu

MarkerExample:TRACe:MARKer:TYPE POSition

CommandFormatInstruction:TRACe[1]|2|3|4:MARKer[1]|2|3|4:X <para>:TRACe[1]|2|3|4:MARKer[1]|2|3|4:X?
Sets marker X value.
Gets marker X value.
This command only works when marker is not off.
Float

Parameter
Type
Parameter
Range
ReturnFloat

Default
Menu

Marker > Normal

Example:TRACe:MARKer:X 200:TRACe:MARKer:X?

CommandFormatInstruction:TRACe[1]|2|3|4:MARKer[1]|2|3|4:Y?

Parameter
Type
Parameter
Range
ReturnNone

Default

None

Menu

None

Example:TRACe:MARKer:Y?

Gets marker Y value.

None
Float

Programming Guide

137

SIGLENT
CommandFormatInstruction

Parameter
Type
Parameter
Range
Return:TRACe[1]|2|3|4:MARKer[1]|2|3|4:REFerence <integer>:TRACe[1]|2|3|4:MARKer[1]|2|3|4:REFerence?
Sets reference marker.
Gets reference marker.
Cannot set the current marker to the reference marker.
Integer
1~4
1~4

Default

2

Menu

Marker > Relative To

Example:TRACe:MARKer:REFerence 3

CommandFormatInstruction:CALCulate[:SELected]:MARKer:COUPle OFF|ON|0|1:CALCulate[:SELected]:MARKer:COUPle?
Sets marker couple state.
Gets marker couple state.
BooleanParameter
Type
Parameter
Range
ReturnOFF|ON|0|1
0|1

Default

None

Menu

Marker > Couple

Example:CALCulate:MARKer:COUPle ON

CommandFormatInstruction:CALCulate:MARKer:AOFF

Parameter
Type
Parameter
Range
ReturnNone

Default

None

Menu

Marker > All Off

Example:CALCulate:MARKer:AOFF

Close all markers.

None
None

7.7 Measurement Subsystem[:SENSe]:DDEMod:MODulation[:SENSe]:ADEMod:STYLe

138

Programming GuideSIGLENT:DDEMod[:FORMat]:SRATe[:SENSe]:DDEMod[:FORMat]:SYMBol:POINts[:SENSe]:DDEMod[:FORMat]:RLENgth[:SENSe]:DDEMod:FILTer[:MEASurement][:SENSe]:DDEMod:FILTer:REFerence[:SENSe]:STATistic:STATe[:SENSe]:AVERage[:STATe][:SENSe]:AVERage:COUNt:CALCulate:RESTart:READ:DDEMod?

CommandFormatInstruction
Parameter
Type
Parameter
Range[:SENSe]:DDEMod:MODulation[:SENSe]:DDEMod:MODulation?
Sets Digital Demodulation Mode.
Gets Digital Demodulation Mode.
Enumeration

Return

ASK2
MSK
BPSK
QPSK
PSK8
DBPSK
DQPSK
DPSK8
OQPSK
PI4DQ
PI8D8
QAM16
QAM32
QAM64
QAM128
QAM256
FSK2
FSK4
FSK8
FSK16
Enumeration

Default

QAM16

Menu

Meas

Example:DDEMod:MODulation FSK8

CommandFormatInstruction[:SENSe]:ADEMod:STYLe[:SENSe]:ADEMod:STYLe?
Sets Analog Modulation Type.
Gets Analog Modulation Type.

Programming Guide

139

SIGLENT
Parameter
Type
Parameter
Range
ReturnEnumeration

Default

AM

Menu

Meas

Example:ADEMod:STYLe AM

CommandFormatInstruction:DDEMod[:FORMat]:SRATe <integer>:DDEMod[:FORMat]:SRATe?
Sets Symbol Rate.
Gets Symbol Rate.
IntegerParameter
Type
Parameter
Range
ReturnAM
FM
Enumeration: AM|FM1000 ~ 2500000
Integer

Default

10000

Menu

Meas > Symbol Rate

Example:DDEMod:SRATe 2000

CommandFormatInstruction[:SENSe]:DDEMod[:FORMat]:SYMBol:POINts <integer>[:SENSe]:DDEMod[:FORMat]:SYMBol:POINts?
Sets Points per Symbol.
Gets Points per Symbol.

Parameter
Type
Parameter
Range
ReturnDiscrete
4, 6, 8, 10, 12, 14, 16

Default

Discrete
4

Menu

Meas > Points/Symbol

ExampleDDEMod:SYMBol:POINts 14

CommandFormatInstruction[:SENSe]:DDEMod[:FORMat]:RLENgth <integer>[:SENSe]:DDEMod[:FORMat]:RLENgth?
Sets meas length.
Gets meas length.
IntegerParameter
Type
Parameter
Range
Return140

16 ~ 4096
Integer

Programming GuideSIGLENT
Default

128

Menu

Meas > Meas Length

Example:DDEMod:RLENgth 200

CommandFormatInstruction[:SENSe]:DDEMod:FILTer[:MEASurement][:SENSe]:DDEMod:FILTer[:MEASurement]?
Sets meas filter.
Gets meas filter.
Enumeration

Parameter
Type
Parameter
Range

ReturnDefault

OFF
RRCosine
RCOSineGAUSsian
HSIN
0|1

Menu

ASK, FSK, PSK, QAM Default is RCOSineMSK Default is OFF
Meas > Filter Setup > Meas Filter

Example:DDEMod:FILTer HSIN

CommandFormatInstruction[:SENSe]:DDEMod:FILTer:REFerence[:SENSe]:DDEMod:FILTer:REFerence?
Sets reference filter.
Gets reference filter.
Enumeration

Parameter
Type
Parameter
Range

ReturnDefault

OFF
RRCosine: Root Raised Cosine
RCOSine : Raised Cosine
GAUSsian
HSIN：Half Sine
Enumeration

Menu

ASK, FSK, PSK, QAM Default is RRC
MSK Default is GAUS
Meas > Ref Filter

Example:DDEMod:FILTer:REFerence OFF

CommandFormatInstruction[:SENSe]:STATistic:STATe[:SENSe]:STATistic:STATe?
Sets Meas Statistic State.
Gets Meas Statistic State.
BooleanParameter
Type
Parameter
Range

OFF|ON|0|1

Programming Guide

141

SIGLENT
ReturnEnumeration

Default

OFF

Menu

Meas > Statistic > Statistic

Example:STATistic:STATe ON

CommandFormatInstruction[:SENSe]:AVERage[:STATe][:SENSe]:AVERage[:STATe]?
Sets meas average state.
Gets meas average state.
BooleanParameter
Type
Parameter
Range
ReturnOFF|ON|0|1
BooleanDefault

OFF

Menu

Meas> Statistic > Avg

Example:AVERage ON

CommandFormatInstruction[:SENSe]:AVERage:COUNt[:SENSe]:AVERage:COUNt?
Sets meas average count.
Gets meas average count.
IntegerParameter
Type
Parameter
Range
Return1 ~ 1000
Integer

Default

10

Menu

Meas> Statistic > Avg

Example:AVERage:COUNt 20

CommandFormatInstruction:CALCulate:RESTart

Parameter
Type
Parameter
Range
ReturnNone

Default

None

Menu

Meas > Statistic > Restart Meas142

Restarts measurements.

None
None

Programming GuideSIGLENT
Example:CALCulate:RESTart

CommandFormatInstruction:READ:DDEMod?
Read digital demod result.
If demod type is ASK it will return:
1. ASK err rms (% rms)
2. ASK err peak (% pk)
3. symbol position of ASK err peak
4. carrier power
5. carrier offset
6. ASK depth
If demod type is FSK it will return:
1. FSK err rms (% rms)
2. FSK err peak (% pk)
3. symbol position of FSK err peak
4. carrier power
5. carrier offset
6. FSK deviation

Parameter
Type
Parameter
Range
ReturnDefault

If If demod type is MSK,PSK,QAM it will return:
1. EVM rms (% rms)
2. EVM peak (% pk)
3. symbol position of EVM peak
4. magnitude error rms (% rms).
5. magnitude error peak (% pk)
6. symbol position of magnitude error peak
7. phase error rms (deg)8. phase error peak (deg pk)
9. symbol position of phase error peak
10. frequency error (Hz)
11. IQ offset
12. SNR(MER) (dB)
13. quadrature error (deg)
14. gain imbalance (dB)
None
None
String
None

Menu
Example:READ:DDEMod?

7.8 Trigger Subsection:TRIGger[:SEQuence]:SOURce:TRIGger[:SEQuence]:RF:LEVel:TRIGger[:SEQuence]:RFBurst:SLOPe

Programming Guide

143

SIGLENT
CommandFormatInstruction

Parameter
Type
Parameter
Range:TRIGger[:SEQuence]:SOURce IMMediate| RFBurst |EXTernal:TRIGger[:SEQuence]:SOURce?
Specifies the source (or type) of triggering used to start a measurement.
Gets trigger type.
RFBurst is not supported if demod type is MSK, PSK, QAM.
Enumeration

ReturnIMMediate: free-run triggering.
RFBurst: triggers on the RF signal level.
EXTernal: allows you to connect an external trigger source.
Enumeration: IMM|EXT|RFB

Default

IMMediate

Menu

Trigger

Example:TRIGger:SOURce IMMediate

CommandFormatInstruction:TRIGger[:SEQuence]:RF:LEVel <value>:TRIGger[:SEQuence]:RF:LEVel?
Sets RF Trigger Level.
Gets RF Trigger Level.
Float, Unit: dBm

Parameter
Type
Parameter
Range
Return-300 dBm ~ 50 dBm
Float, Unit: dBm

Default

0 dBm

Menu

Trigger > RF Trigger

Example:TRIGger:RF:LEVel 0.5 dBm

CommandFormat:TRIGger[:SEQuence]:RFBurst:SLOPe POSitive|NEGative:TRIGger[:SEQuence]:RFBurst:SLOPe?

Instruction

Sets trigger edge.
Gets trigger edge.
Enumeration

Parameter
Type
Parameter
Range
ReturnPOSitive
NEGative
Enumeration: POS|NEG

Default

POSitive

Menu

Trigger > External

Example:TRIGger:RFBurst:SLOPe POSitive

144

Programming GuideSIGLENT

8.Real Time Spectrum Analysis
The model supported by real-time spectrum analysis is ssa3000X-R seriesFrequency Subsection
Amplitude Subsection
BW Subsection
Sweep Subsection
Trace Subsection
Marker Subsection
Trigger Subsection
Meas Subsection

8.1 Frequency Subsection[:SENSe]:FREQuency:CENTer[:SENSe]:FREQuency:CENTer:STEP[:INCRement][:SENSe]:FREQuency:STARt <freq>[:SENSe]:FREQuency:STOP <freq>[:SENSe]:FREQuency:CENTer:STEP:AUTO[:SENSe]:FREQuency:OFFSet[:SENSe]:FREQuency:SPAN[:SENSe]:FREQuency:SPAN:FULL[:SENSe]:FREQuency:SPAN:ZERO[:SENSe]:FREQuency:SPAN:PREVious[:SENSe]:FREQuency:SPAN:HALF[:SENSe]:FREQuency:SPAN:DOUBle
CommandFormatInstruction
Parameter
Type
Parameter
Range[:SENSe]:FREQuency:CENTer <freq>[:SENSe]:FREQuency:CENTer?
Sets the center frequency.
Gets the center frequency.
Float, unit: Hz, kHz, MHz, GHz
2.5 kHz ~ 7.4999975 GHz

Programming Guide

145

SIGLENT
ReturnFloat, unit: Hz

Default

20 MHzMenu

Frequency > Center Freq

Example[:SENSe]:FREQuency:CENTer 300 MHz

CommandFormatInstruction[:SENSe]:FREQuency:CENTer:STEP[:INCRement] <freq>[:SENSe]:FREQuency:CENTer:STEP[:INCRement]?
Sets frequency step.
Gets frequency step.
Float, unit: Hz, kHz, MHz, GHz

Parameter
Type
Parameter
Range
Return1 Hz ~ 999.999 kHz
Float, unit: Hz

Default

320 MHz

Menu

Frequency > Freq Step

Example[:SENSe]:FREQuency:CENTer:STEP[:INCRement] 20 MHz

CommandFormatInstruction[:SENSe]:FREQuency:STARt <freq>[:SENSe]:FREQuency:STARt?
Sets the start frequency.
Gets the start Frequency.
Float, unit: Hz, kHz, MHz, GHz

Parameter
Type
Parameter
Range
Return0 Hz ~ 7.499995 GHz
Float, unit: Hz

Default

0 Hz

Menu

Frequency > Start Freq

Example:FREQuency:STARt 100 Hz

CommandFormatInstruction[:SENSe]:FREQuency:STOP <freq>[:SENSe]:FREQuency:STOP?
Sets the stop frequency.
Gets the stop frequency.
Float, unit: Hz, kHz, MHz, GHz

Parameter
Type
Parameter
Range
Return5 kHz ~ 7.5 GHz
Float, unit: Hz

Default

40 MHzMenu

Frequency > Stop Freq

146

Programming GuideSIGLENT
Example:FREQuency:STOP 1.0 GHz

CommandFormatInstruction[:SENSe]:FREQuency:CENTer:STEP:AUTO OFF|ON|0|1[:SENSe]:FREQuency:CENTer:STEP:AUTO?
Specifies whether the step size is set automatically based on the span.
Gets center frequency step mode.
BooleanParameter
Type
Parameter
Range
ReturnOFF|ON|0|1
0|1

DefaultON

Menu

Frequency > Freq Step

Example:FREQuency:CENTer:STEP:AUTO OFF

CommandFormatInstruction[:SENSe]:FREQuency:OFFSet <freq>[:SENSe]:FREQuency:OFFSet?
Sets the frequency offset.
Gets the frequency offset.
Float, unit: Hz, kHz, MHz, GHz

Parameter
Type
Parameter
Range
Return-100 GHz ~ 100 GHz
Float, unit: Hz

Default

0 Hz

Menu

Frequency > Freq Offset

Example:FREQuency:OFFSet 1 GHz

CommandFormatInstruction[:SENSe]:FREQuency:SPAN <freq>[:SENSe]:FREQuency:SPAN?
Sets the span frequency.
Gets the span frequency..
Float, unit: Hz, kHz, MHz, GHz

Parameter
Type
Parameter
Range
Return5 kHz ~ 40 MHz
Float, unit: Hz

Default

40 MHz

Menu

Span > Span

Example:FREQuency:SPAN 1 GHz

Programming Guide

147

SIGLENT
CommandFormatInstruction[:SENSe]:FREQuency:SPAN:FULL

Parameter
Type
Parameter
Range
ReturnNone

Default

None

Menu

Span > Full Span

Example:FREQuency:SPAN:FULL

CommandFormatInstruction[:SENSe]:FREQuency:SPAN:ZERO

Parameter
Type
Parameter
Range
ReturnNone

Default

None

Menu

Span > Zero Span

Example:FREQuency:SPAN:ZERO

CommandFormatInstruction[:SENSe]:FREQuency:SPAN:PREVious

Parameter
Type
Parameter
Range
ReturnNone

Default

None

Menu

Span > Last Span

Example:FREQuency:SPAN:PREVious

CommandFormatInstruction[:SENSe]:FREQuency:SPAN:HALF

Parameter
Type

None

148

Sets the frequency span to full scale.

None
None

Sets the frequency span to zero span.

None
None

Sets the frequency span to the previous span setting.

None
None

Sets the frequency span to half of the current span setting.

Programming GuideSIGLENT
Parameter
Range
ReturnNone

Default

None

Menu

Span> Zoom In

Example:FREQuency:SPAN:HALF

CommandFormatInstruction[:SENSe]:FREQuency:SPAN:DOUBle

Parameter
Type
Parameter
Range
ReturnNone

Default

None

Menu

Span> Zoom Out

Example:FREQuency:SPAN:DOUBle

None

Sets the frequency span to double the current span setting.

None
None

8.2 Amplitude Subsection[:SENSe]:POWer[:RF]:ATTenuation[:SENSe]:POWer[:RF]:ATTenuation:AUTO:DISPlay:WINDow:TRACe:Y[:SCALe]:RLEVel:DISPlay:WINDow:TRACe:Y[:SCALe]:PDIVision[:SENSe]:POWer[:RF]:GAIN[:STATe] :UNIT:POWer

CommandFormatInstruction
Parameter
Type
Parameter
Range
Return[:SENSe]:POWer[:RF]:ATTenuation <value>[:SENSe]:POWer[:RF]:ATTenuation?
Sets the input attenuator.
Gets the input attenuator.
Integer, Unit: dB
0 dB ~ 50 dB
Integer, unit: dB

Default

20 dB

Menu

Amplitude > Attenuator

Example[:SENSe]:POWer[:RF]:ATTenuation 30 dB

Programming Guide

149

SIGLENT

CommandFormatInstruction
Parameter
Type
Parameter
Range
Return[:SENSe]:POWer[:RF]:ATTenuation:AUTO OFF|ON|0|1[:SENSe]:POWer[:RF]:ATTenuation:AUTO?
Sets the input attenuator.
Gets the input attenuator.
Boolean
OFF|ON|0|1
0|1

Default

0

Menu

Amplitude > Attenuator

Example[:SENSe]:POWer[:RF]:ATTenuation:AUTO ON

CommandFormatInstruction:DISPlay:WINDow:TRACe:Y[:SCALe]:RLEVel <value>:DISPlay:WINDow:TRACe:Y[:SCALe]:RLEVel?
This command sets the reference level for the Y-axis.
Gets reference level.
Float

Parameter
Type
Parameter
Range
Return-100 dBm ~ 30 dBm
Float

Default

0 dBm

Menu

Amplitude > Ref Level

Example:DISPlay:WINDow:TRACe:Y:RLEVel 20 DBM

CommandFormatInstruction:DISPlay:WINDow:TRACe:Y[:SCALe]:PDIVision <integer>:DISPlay:WINDow:TRACe:Y[:SCALe]:PDIVision?
This command sets the per-division display scaling for the y-axis.
Gets Scale/Div when scale type.
Float

Parameter
Type
Parameter
Range
Return1 dB ~ 20 dB
Float

Default

10 dB

Menu

Amplitude > Scale/Div

Example:DISPlay:WINDow:TRACe:Y:PDIVision 10 dB

CommandFormatInstruction[:SENSe]:POWer[:RF]:GAIN[:STATe] OFF|ON|0|1[:SENSe]:POWer[:RF]:GAIN[:STATe]?
Turns the internal preamp on/off.
Gets preampstate.

150

Programming GuideSIGLENT
Parameter
Type
Parameter
Range
ReturnBooleanDefault

OFF

Menu

Amplitude > Preamp

Example:POWer:GAIN ON

CommandFormatInstruction:UNIT:POWer DBM|DBMV|DBUV|V|W:UNIT:POWer?
Specifies amplitude units for the input, output and display.
Gets amplitude units.
Enumeration

Parameter
Type
Parameter
Range
ReturnOFF|ON|0|1
0|1

DBM|DBMV|DBUV|DBUA|V|W,
Enumeration

Default

DBM

Menu

Amplitude > Units

Example:UNIT:POWer DBMV

8.3 BW Subsection[:SENSe]:BWIDth[:RESolution][:SENSe]:BWIDth[:RESolution]:AUTO[:SENSe]:FILTer:TYPE
CommandFormatInstruction
Parameter
Type
Parameter
Range
Return[:SENSe]:BWIDth[:RESolution] <freq>[:SENSe]:BWIDth[:RESolution]?
Specifies the resolution bandwidth. For numeric entries, all RBW types choose the nearest(arithmetically, on a linear scale, rounding up) available RBW to the value entered.
None
None
Float, Unit: Hz

Default

1 MHz

Menu

BW > RBW

Example:BWIDth?

CommandFormat[:SENSe]:BWIDth[:RESolution]:AUTO OFF|ON|0|1[:SENSe]:BWIDth[:RESolution]:AUTO?

Programming Guide

151

SIGLENT
Instruction
Parameter
Type
Parameter
Range
ReturnTurns on/off auto resolution bandwidth state.
Gets the resolution bandwidth state.
Boolean
OFF|ON|0|1
0|1

DefaultON

Menu

BW > RBW

Example:BWID:AUTO On

CommandFormatInstruction[:SENSe]:FILTer:TYPE[:SENSe]:FILTer:TYPE?
Sets FFT window function.
Gets FFT window function.
Enumeration

Parameter
Type
Parameter
Range

ReturnKAISer
HANNing
FLATtop
GAUSsian
BHARris
RECTangular

Default

KAIS
HANN
FLAT
GAUS
BHAR
RECT
100 kHz

Menu

BW > Window

Example:FILT:TYPE KAIS

8.4 Sweep Subsection[:SENSe]:ACQuisition:TIME[:SENSe]:ACQuisition:TIME:AUTO:INITiate[:IMMediate]:INITiate:CONTinuous:INITiate:Pause:INITiate:RESume
CommandFormat152[:SENSe]:ACQuisition:TIME

Programming GuideSIGLENT[:SENSe]:ACQuisition:TIME？
Instruction
Parameter
Type
Parameter
Range
ReturnSets Acquisition time.
Gets Acquisition time.
Float, unit: ks, s, ms, us
29.998 ms ~ 40 s
Float, unit: sDefault

29.998ms

Menu

Sweep > Acq Time

Example:ACQuisition:TIME 2s

CommandFormatInstruction[:SENSe]:ACQuisition:TIME:AUTO[:SENSe]:ACQuisition:TIME:AUTO?
This command turns on/off auto sweep time state.
Gets sweep time state.
BooleanParameter
Type
Parameter
Range
ReturnOFF|ON|0|1
0|1

Default

ON

Menu

Sweep > Acq Time

Example:ACQuisition:TIME:AUTO on

CommandFormatInstruction:INITiate[:IMMediate]Parameter
Type
Parameter
Range
ReturnNone

Default

None

Restarts the current sweep.

None
None

Menu
Example:INITiate:IMMediate

CommandFormatInstruction:INITiate:CONTinuous OFF|ON|0|1:INITiate:CONTinuous?
Sets continuous sweep mode on-off.
Gets continuous sweep mode state.
BooleanParameter
Type

Programming Guide

153

SIGLENT
Parameter
Range
ReturnOFF|ON|0|1

Default

ON

Menu

Sweep > Sweep

Example:INITiate:CONTinuous OFF

CommandFormatInstruction:INITiate:Pause

Parameter
Type
Parameter
Range
ReturnNone

Default

None

Menu

Sweep > Pause

Example:INITiate:Pause

CommandFormatInstruction:INITiate:RESume

Parameter
Type
Parameter
Range
ReturnNone

Default

None

Menu

Sweep > Resume

Example:INITiate:RES

0|1

Pause current sweeep (pause at the end of the current sweep).

None
None

Resume paused sweep

None
None

8.5 Trace Subsection:TRACe[1]|2|3:MODE:TRACe1|2|3 [:DATA]?
:TRACe[:DATA]:SPECtrum?
:TRACe[:DATA]?:PVT?
:FORMat[:TRACe][:DATA][:SENSe]:DETector:TRACe[1]|2|3[:FUNCtion]
154

Programming GuideSIGLENT[:SENSe]:DETector:TRACe:SPECtrogram[:SENSe]:DETector:TRACe:PVTime[:SENSe]:AVERage:TRACe[1]|2|3:COUNt

CommandFormatInstruction:TRACe[1]|2|3:MODE WRITe|MAXHold|MINHold|VIEW|BLANk|AVERage:TRACe[1]|2|3:MODE?
Selects the display mode for the selected trace.

Parameter
Type
Parameter
Range

Enumeration

Return

WRITe: puts the trace in the normal mode, updating the data.
MAXHold: displays the highest measured trace value for all the data that has beenmeasured since the function was turned on.
MINHold: displays the lowest measured trace value for all the data that has been measured
since the function was turned on.
BLANk: turns off the trace data so that it is not viewed on the display.
AVERage: averages the trace for test period.
Enumeration

Default

Trace1: WRITe, Trace2|3|: BLANk

Menu

Trace

Example:TRAC1:MODE AVER

CommandFormatInstruction:TRACe1|2|3 [:DATA]?

Parameter
Type
Parameter
Range
ReturnNone

Default

1

Menu

None

Example:TRACe:DATA?

CommandFormatInstruction:TRACe[:DATA]:SPECtrum?

Parameter
Type
Parameter
Range
ReturnNone

Default

1

Menu

None

This query command returns the current displayed data.

None
StringThis query command returns the spectrum trace data.

None
String

Programming Guide

155

SIGLENT
Example:TRACe:SPEC?

CommandFormatInstruction:TRACe[:DATA]?:PVT?

Parameter
Type
Parameter
Range
ReturnNone

Default

1

Menu

None

Example:TRACe:PVT?

CommandFormatInstruction:FORMat[:TRACe][:DATA] ASCii|REAL,32|REAL,64:FORMat[:TRACe][:DATA]?
Sets trace data type.
Gets trace data type.
Enumeration

Parameter
Type
Parameter
Range

This query command returns the pvt trace data.

None
StringReturnASCii
REAL,32 Binary 32-bit real values in the current Y Axis Unit, in a definite
length block.
REAL,64 Binary 64-bit real values in the current Y Axis Unit, in a definite
length block.
You can also use the following parameters
REAL32: Binary 32-bit real values in the current Y Axis Unit, in a definite
length block.
REAL: Binary 64-bit real values in the current Y Axis Unit, in a definite
length block.
StringDefault

ASCii

Menu

None

Example:FORMat ASCii

CommandFormat[:SENSe]:DETector:TRACe[1]|2|3[:FUNCtion]
NEGative|POSitive|SAMPle|AVERage[:SENSe]:DETector:TRACe[1]|2|3[:FUNCtion]?
Specifies the detection mode. For each trace interval (bucket), average detection displays
the average of all the samples within the interval.
Enumeration

Instruction
Parameter
Type
Parameter
Range

156

NEGative: Negative peak detection displays the lowest sample taken during the intervalbeing displayed.
POSitive: Positive peak detection displays the highest sample taken during the intervalbeing displayed.

Programming GuideSIGLENT

ReturnSAMPle: Sample detection displays the sample taken during the interval being displayed,and is used primarily to display noise or noise-like signals.
In sample mode, the instantaneous signal value at the present display point is placed intomemory. This detection should not be used to make the most accurate amplitude
measurement of non noise-like signals.
AVERage: Average detection is used when measuring the average value of the amplitudeacross each trace interval (bucket). The averaging method used by the average detector isset to either video or power as appropriate when the average type is auto coupled.
Enumeration

Default

POSitive

Menu

DetectCommandFormatInstruction[:SENSe]:DETector:TRACe:SPECtrogram[:SENSe]:DETector:TRACe:SPECtrogram?
Sets the detect type of spectrogram.

Parameter
Type
Parameter
Range

Enumeration

ReturnNEGative
POSitive
SAMPleAVERage
Enumeration

Default

POS

Menu

DetectExample:DET:TRAC:SPEC POS

CommandFormatInstruction[:SENSe]:DETector:TRACe:PVTime[:SENSe]:DETector:TRACe:PVTime?
Sets the detect type of PVT.

Parameter
Type
Parameter
Range

Enumeration

ReturnNEGative
POSitive
SAMPleAVERage
Enumeration

Default

POS

Menu

DetectExample:DET:TRAC:PVT POS

CommandFormatInstruction[:SENSe]:AVERage:TRACe[1]|2|3:COUNt <integer>[:SENSe]:AVERage:TRACe[1]|2|3:COUNt?
Specifies the number of measurements that are combined.

Programming Guide

157

SIGLENT
Parameter
Type
Parameter
Range
ReturnInteger

Default

10

Menu

Trace > Average

Example:AVERage:TRACe1:COUNt 10

1 ~ 100
Integer

8.6 Marker Subsection:CALCulate:MARKer[1]|2|3|4|5|6|7|8:MODE:CALCulate:MARKer[1]|2|3|4|5|6|7|8:TRACe:CALCulate:MARKer[1]|2|3|4|5|6|7|8:REFerence:CALCulate:MARKer[1]|2|3|4|5|6|7|8:X:CALCulate:MARKer[1]|2|3|4|5|6|7|8:Y

CommandFormatInstruction
Parameter
Type
Parameter
Range:CALCulate:MARKer[1]|2|3|4|5|6|7|8:MODE POSition|DELTa|FIXed|OFF:CALCulate:MARKer[1]|2|3|4|5|6|7|8:MODE?
Selects the type of markers that you want to activate.
Gets the type of markers.
Enumeration
POSition
DELTa
FIXed
OFF

ReturnEnumeration

Default

OFF

Menu

MarkerExample:CALCulate:MARK1:MODE POSition

CommandFormatInstruction:CALCulate:MARKer[1]|2|3|4|5|6|7|8:TRACe 1|2|3|4|5:CALCulate:MARKer[1]|2|3|4|5|6|7|8:TRACe?
This command assigns the specified marker to the designated trace 1, 2, 3, 4 or 5.
Gets the specified marker to which trace.
Trace4|5 is display trace1|2.
Enumeration

Parameter
Type

158

Programming GuideSIGLENT
Parameter
Range
Return

MARKer:1|2|3|4|5|6|7|8
TRACe:1|2|3|4|5
Enumeration

Default

1

Menu

Marker > Select Trace

ExampleCALCulate:MARK1:TRAC 1

CommandFormatInstruction:CALCulate:MARKer[1]|2|3|4|5|6|7|8:REFerence 1|2|3|4|5|6|7|8:CALCulate:MARKer[1]|2|3|4|5|6|7|8:REFerence?
Sets marker relative to.
Gets marker relative to.
Enumeration

Parameter
Type
Parameter
Range
Return1|2|3|4|5|6|7|8
Enumeration

Default

1

Menu

Marker > Relative To

Example:CALCulate:MARKer1:REFerence 3

CommandFormatInstruction:CALCulate:MARKer[1]|2|3|4|5|6|7|8:X <para>:CALCulate:MARKer[1]|2|3|4|5|6|7|8:X?
This command positions the designated marker on its assigned trace at the specified trace
X value.
The value is in the X-axis units, which can be a frequency or time.
The query returns the current X value of the designated marker.

Parameter
Type
Parameter
Range
ReturnFrequency: Float, unit: Hz, kHz, MHz, GHz, Default “Hz”
Time: Float, unit: us, ms, s, ks, Default “s”
0~7.5GHz
Float

Default
Menu

Marker > Normal

Example:CALCulate:MARKer4:X 1 kHz:CALCulate:MARKer4:X?

CommandFormatInstruction:CALCulate:MARKer[1]|2|3|4|5|6|7|8:Y:CALCulate:MARKer[1]|2|3|4|5|6|7|8:Y?
This command reads the current Y value for the designated marker.
This command can be used to read the results of noise marker.
Make sure that Marker is on, Reference Command::CALCulate:MARKer[1]|2|3|4|5|6|7|8:MODE
None

Parameter
Type

Programming Guide

159

SIGLENT
Parameter
Range
ReturnNone

Default

None

Menu

Marker > Normal

Example:CALCulate:MARKer1:Y?

Float, unit: dBm

8.7 Trigger Subsection:TRIGger[:SEQuence]:SOURce IMMediate:TRIGger[:SEQuence]:LEVel:LEVel:TRIGger[:SEQuence]:LEVel:DELay:TRIGger[:SEQuence]:EXTernal:DELay:TRIGger[:SEQuence]:EXTernal:SLOPe:TRIGger[:SEQuence]:FMT:TCRiteria
TRIGger[:SEQuence]:FMT:MASK:BUILd:TRIGger[:SEQuence]:FMT:STATe:TRIGger[:SEQuence]:FMT:ACTion:TRIGger[:SEQuence]:EXTernal: TRACe:TRIGger[:SEQuence]:FMT:MASK:DELete:ALL
CommandFormatInstruction
Parameter
Type
Parameter
Range:TRIGger[:SEQuence]:SOURce IMMediate |LEVel|FMT|EXTernal:TRIGger[:SEQuence]:SOURce?
Specifies the source (or type) of triggering used to start a measurement.
Gets trigger type.
Enumeration

ReturnIMMediate
LEVel:
FMT
EXTernal
IMM|LEV|FMT|EXT

Default

IMMediate

Menu

Trigger

Example:TRIGger:SOURce IMMediate

CommandFormat:TRIGger[:SEQuence]:LEVel:LEVel <value>:TRIGger[:SEQuence]:LEVel:LEVel?

160

Programming GuideSIGLENT
Instruction

Parameter
Type
Parameter
Range
ReturnSpecifies the level at which a pvt trigger will occur. pvt is adjusted using this command,but must also be selected using the command.
Gets pvt Trigger Level.
Float, unit: dBm-300 dBm ~ 50 dBm
Float, unit: dBm

Default

0 dBm

Menu

Trigger > PVT > Trigger Level

Example:TRIGger:LEVel:LEVel 0.5 dBm

CommandFormatInstruction:TRIGger[:SEQuence]:LEVel:DELay <value>:TRIGger[:SEQuence]:LEVel:DELay?
Specifies the delay at which a pvt trigger will occur. pvt is adjusted using this command,but must also be selected using the command.
Gets pvt Trigger Delay.
Float, unit: ks, s, ms, us, ps, ns

Parameter
Type
Parameter
Range
Return0 ~ 25 s
Float

Default

0s

Menu

Trigger > PVT > Trigger Delay

Example:TRIGger:LEVel:DELay 0.5 dBm

CommandFormatInstruction:TRIGger[:SEQuence]:EXTernal:DELay<value>:TRIGger[:SEQuence]:EXTernal:DELay?
Specifies the delay at which an external trigger will occur. External is adjusted using thiscommand, but must also be selected using the command.
Gets external Trigger Delay.
Float, unit: ks,s,ms,us,ps,nsParameter
Type
Parameter
Range
Return0~25s
Float, unit: dBm

Default

0s

Menu

Trigger > PVT > Delay

Example:TRIGger[:SEQuence]: EXTernal: DELay 2

CommandFormatInstruction:TRIGger[:SEQuence]:EXTernal:SLOPe POSitive|NEGative:TRIGger[:SEQuence]:EXTernal:SLOPe?
Sets Trigger edge.
Gets Trigger edge.
Enumeration

Parameter
Type

Programming Guide

161

SIGLENT
Parameter
Range
ReturnPOSitive: positive edge.
NEGative: negative edge.
Enumeration

Default

POSitive

Menu

Trigger > External Trigger > Trigger edge

Example:TRIGger:EXTernal:SLOPe POSitive

CommandFormatInstruction:TRIGger[:SEQuence]:FMT:TCRiteria GTLower|LTLower|OUTSide|INSide:TRIGger[:SEQuence]:FMT:TCRiteria?
Sets FMT Trigger type.
Gets FMT Trigger type.
Enumeration

Parameter
Type
Parameter
Range

ReturnGTLower
LTLower
OUTSideINSideGTLower | LTLower| OUTSide| INSide

Default

GTL

Menu

Limit > Mask Edit > Mask Type

Example:TRIGger:FMT:TCRiteria INS

CommandFormatInstruction

TRIGger[:SEQuence]:FMT:MASK:BUILd

Parameter
Type
Parameter
Range
ReturnEnumeration

Default

None

Menu

Limit > Mask Edit > Build

ExampleTRIGger:FMT:MASK:BUILd

CommandFormatInstruction:TRIGger[:SEQuence]:FMT:STATe:TRIGger[:SEQuence]:FMT:STATe?
Sets FMT Trigger state,
Gets FMT Trigger state.
BoolParameter
Type
Parameter
Range
Return162

Auto creats a FMT MASK according to waveform shape.

None
None

ON|OFF|0|1
0|1

Programming GuideSIGLENT
Default

OFF

Menu

Limit > FMT Enable

Example:TRIGger:FMT:STATe on

CommandFormatInstruction:TRIGger[:SEQuence]:FMT:ACTion NORMal|BEEPer|STOP:TRIGger[:SEQuence]:FMT:ACTion?
Sets FMT Trigger action.
Gets FMT Trigger action.
Enumeration

Parameter
Type
Parameter
Range
ReturnNORMalBEEPer
STOP
Enumeration

Default

NORM

Menu

Limit > Action

Example:TRIGger[:SEQuence]:FMT:ACTion STOP

CommandFormatInstruction:TRIGger[:SEQuence]:EXTernal: TRACe:TRIGger[:SEQuence]:EXTernal: TRACe?
Sets FMT Trigger trace.
Gets FMT Trigger trace.
Interger

Parameter
Type
Parameter
Range
Return

1~3

Default

1

Menu

Limit > Mask Edit > Trace

Example:TRIGger:EXTernal: TRACe 2

CommandFormatInstruction:TRIGger[:SEQuence]:FMT:MASK:DELete:ALL

Parameter
Type
Parameter
Range
ReturnNone

Default

None

Menu

Limit > Mask Edit > Del All

Example:TRIGger:FMT:MASK:DELete:ALL

Deletes all FMT mask points.

None
None

Programming Guide

163

SIGLENT

8.8 Meas Subsection:DISPlay:VIEW:DENSity:PERSistence:INFinite:DISPlay:VIEW[:SELect]:DISPlay:VIEW:DENSity:PERSistence:DISPlay:VIEW:SPECtrogram:TRACe:NUMber
:DISPlay:VIEW:SPECtrogram:TRACe:STARt

CommandFormatInstruction
Parameter
Type
Parameter
Range
Return:DISPlay:VIEW:DENSity:PERSistence:INFinite:DISPlay:VIEW:DENSity:PERSistence:INFinite?
Turns on or off persistence infinite mode.
Querys the setting status of infinite persistence mode.
Boolean
ON|OFF|0|1
0|1

Default

OFF

Menu

Meas Setup > Persistence

Example:DISP:VIEW:DENS:PERS:INF ON

CommandFormatInstruction:DISPlay:VIEW[:SELect] <type>:DISPlay:VIEW[:SELect]?
Sets display type.
Gets display type.
Enumeration

Parameter
Type
Parameter
Range

ReturnDENSity
SSPectrumSPEC3D
SPECtrogram
PVT
DENS|SSP|SPEC3D|SPEC|PVT

Default

NORM

Menu

Meas

Example:DISP:VIEW DENS:DISP:VIEW?

CommandFormatInstruction:DISPlay:VIEW:DENSity:PERSistence:DISPlay:VIEW:DENSity:PERSistence?
Sets the Duration of persistence.

164

Programming GuideSIGLENT
Parameter
Type
Parameter
Range
ReturnFloat, unit: ks,s,ms,usDefault

0s

Menu

Meas Setup > Persistence

Example:DISP:VIEW:DENS:PERS 5s

CommandFormatInstruction:DISPlay:VIEW:SPECtrogram:TRACe:NUMber
:DISPlay:VIEW:SPECtrogram:TRACe:NUMber?
Sets the display trace.
Gets the display trace.
IntegerParameter
Type
Parameter
Range
Return0 s ~ 10 s
Float, unit: sInteger

Default

1

Menu

Meas Setup > Display Trace

Example:DISP:VIEW:SPEC:TRAC:NUM 50000:DISP:VIEW:SPEC:TRAC:NUM?

CommandFormatInstruction:DISPlay:VIEW:SPECtrogram:TRACe:STARt:DISPlay:VIEW:SPECtrogram:TRACe:STARt?
Sets the display trace start.
Gets the display trace start.
Float

Parameter
Type
Parameter
Range
ReturnFloat

Default
Menu

Meas Setup > Ogram View Stop

Example:DISP:VIEW:SPEC:TRAC:STAR 100:DISP:VIEW:SPEC:TRAC:STAR?

Programming Guide

165

SIGLENT

9.EMI Measurement
Frequency Subsection
Amplitude Subsection
Sweep Subsection
Bandwidth Subsection
Trace Subsection
Marker Subsection
Limit Subsection
Measurement Subsystem

9.1 Frequency Subsection[:SENSe]:FREQuency:CENTer[:SENSe]:FREQuency:MIDSpan[:SENSe]:FREQuency:STARt[:SENSe]:FREQuency:STOP[:SENSe]:FREQuency:SPAN:DISPlay:WINDow:TRACe:X[:SCALe]:SPACing[:SENSe]:FSCan:RANGe

CommandFormatInstruction
Parameter
Type
Parameter
Range
Return[:SENSe]:FREQuency:CENTer <freq>[:SENSe]:FREQuency:CENTer?
Sets the frequency of Meters in the Frequency Scan measurement.
Gets the frequency of Meters.
Float, unit: Hz, kHz, MHz, GHz
0 Hz ~ 7.5 GHz
Float, unit: Hz

Default

165 MHz

Menu

Frequency > Freq(Meter)

Example:FREQuency:CENTer 0.2 GHz:SENSe:FREQuency:CENTer 0.2 GHz

166

Programming GuideSIGLENT

CommandFormatInstruction[:SENSe]:FREQuency:MIDSpan <freq>[:SENSe]:FREQuency:MIDSpan?
Sets the frequency at the midspan of the EMI Measurement.
Gets the frequency at the midspan.
Float, unit: Hz, kHz, MHz, GHz

Parameter
Type
Parameter
Range
Return50 Hz ~ 7.49999995 GHz
Float, unit: Hz

Default

165 MHz

Menu

Frequency > Midspan Freq

Example:FREQuency:MIDSpan 0.2 GHz:SENSe:FREQuency:MIDSpan 0.2 GHz

CommandFormatInstruction[:SENSe]:FREQuency:STARt <freq>[:SENSe]:FREQuency:STARt?
Sets the frequency of the EMI Measurement.
Gets the frequency.
Float, unit: Hz, kHz, MHz, GHz

Parameter
Type
Parameter
Range
Return0 Hz ~ 7.4999999 GHz
Float, unit: Hz

Default

30 MHzMenu

Frequency > Start Freq

Example:FREQuency:STARt 10 MHz

CommandFormatInstruction[:SENSe]:FREQuency:STOP <freq>[:SENSe]:FREQuency:STOP?
Sets the frequency at the right side of the graticule display.
Gets the stop frequency.
Float, unit: Hz, kHz, MHz, GHz

Parameter
Type
Parameter
Range
Return100 Hz ~ 7.5 GHz
Float, unit: Hz

Default

300 MHz

Menu

Frequency > Stop Freq

Example:FREQuency:STOP 1.0 GHz

CommandFormat[:SENSe]:FREQuency:SPAN <freq>[:SENSe]:FREQuency:SPAN?

Programming Guide

167

SIGLENT
Instruction
Parameter
Type
Parameter
Range
ReturnSets the span of the EMI Measurement.
Gets the span frequency.
Float, unit: Hz, kHz, MHz, GHz
100 Hz ~ 7.5 GHz
Float, unit: Hz

Default

270 MHz

Menu

Span > Span

Example:FREQuency:SPAN 1 GHz

CommandFormatInstruction:DISPlay:WINDow:TRACe:X[:SCALe]:SPACing LOGarithmic|LINear:DISPlay:WINDow:TRACe:X[:SCALe]:SPACing?
Chooses a linear or logarithmic scaling for the frequency axis.

Parameter
Type
Parameter
Range
ReturnEnumeration

Default

LOG

Menu

Span > X Scale

Example:DISP:WIND:TRAC:X:SPAC LIN

CommandFormatInstruction[:SENSe]:FSCan:RANGe CISA|CISB|CISC|CISBC|CISD

Parameter
Type
Parameter
Range
ReturnEnumeration

Default

CISC

Menu

Span > CISPR Band

Example:FSC:RANG CISA

LOGarithmic|LINear
Enumeration

Selects the span range in CISPR standard.

CISA|CISB|CISC|CISBC|CISD
Enumeration

9.2 Amplitude Subsection:DISPlay:FSCan:VIEW:WINDow:TRACe:Y[:SCALe]:RLEVel[:SENSe]:POWer[:RF]:ATTenuation[:SENSe]:POWer[:RF]:ATTenuation:AUTO

168

Programming GuideSIGLENT[:SENSe]:POWer[:RF]:GAIN[:STATe]:UNIT:POWer:DISPlay:FSCan:VIEW:WINDow:TRACe:Y[:SCALe]:PDIVision:DISPlay:WINDow:TRACe:Y:SCALe:RLEVel:OFFSet:DISPlay:WINDow:TRACe:Y[:SCALe]:SPACing

CommandFormatInstruction
Parameter
Type
Parameter
Range:DISPlay:FSCan:VIEW:WINDow:TRACe:Y[:SCALe]:RLEVel <value>:DISPlay:FSCan:VIEW:WINDow:TRACe:Y[:SCALe]:RLEVel?
This command sets the reference level for the Y-axis.
Gets reference level.
Float, unit: dBm, dBmV, dBuV, V, W

ReturnUnit is dBm: -100 dBm ~ 30 dBm,
Unit is dBmV: -53.01 dBmV ~ 76.99 dBmV,
Unit is dBuV: 6.99 dBuV ~ 136.99 dBuV,
Unit is Volts: 2.24 uV ~ 7.07 V
Unit is Watts: 100 fW ~ 1 W.
Float, unit: dBm

Default

0 dBm

Menu

Amplitude > Ref Level

Example:DISPlay:WINDow:TRACe:Y:RLEVel 20 DBM

CommandFormatInstruction[:SENSe]:POWer[:RF]:ATTenuation[:SENSe]:POWer[:RF]:ATTenuation?
Sets the input attenuator of the EMI Measurement.
Gets the input attenuator.
IntegerParameter
Type
Parameter
Range
Return0 dB ~ 51 dB
Integer, unit: dB

Default

20 dB

Menu

Amplitude > Attenuator

Example:POWer:ATTenuation 10

CommandFormatInstruction[:SENSe]:POWer[:RF]:ATTenuation:AUTO OFF|ON|0|1[:SENSe]:POWer[:RF]:ATTenuation:AUTO?
This command turns on/off auto input port attenuator state.
Gets input port attenuator state.
BooleanParameter
Type
Parameter
Range
Programming Guide

OFF|ON|0|1

169

SIGLENT
Return0|1

Default

ON

Menu

Amplitude > Attenuator

Example:POWer:ATTenuation:AUTO?

CommandFormatInstruction[:SENSe]:POWer[:RF]:GAIN[:STATe] OFF|ON|0|1[:SENSe]:POWer[:RF]:GAIN[:STATe]?
Turns the internal preamp on/off.
Gets preamp on-off state.
BooleanParameter
Type
Parameter
Range
ReturnOFF|ON|0|1
0|1

Default

OFF

Menu

Amplitude > Preamp

Example:POWer:GAIN ON

CommandFormatInstruction:UNIT:POWer DBM|DBMV|DBUV|V|W:UNIT:POWer?
Specifies amplitude units for the input, output and display.
Gets amplitude units.
Enumeration

Parameter
Type
Parameter
Range
Return

DBM|DBMV|DBUV|DBUA|V|W,
Enumeration

Default

DBUV

Menu

Amplitude > Units

Example:UNIT:POWer DBMV

CommandFormatInstruction:DISPlay:FSCan:VIEW:WINDow:TRACe:Y[:SCALe]:PDIVision <integer>:DISPlay:FSCan:VIEW:WINDow:TRACe:Y[:SCALe]:PDIVision?
This command sets the per-division display scaling for the y-axis when scale type of Y
axis is set to Log.
Gets Scale/Div when scale type of Y axis is set to Log.
IntegerParameter
Type
Parameter
Range
Return170

1 dB ~ 10 dB
Float, unit: dB

Programming GuideSIGLENT
Default

10 dB

Menu

Amplitude > Scale/Div

Example:DISPlay:WINDow:TRACe:Y:PDIVision 10 dB

CommandFormatInstruction:DISPlay:WINDow:TRACe:Y:SCALe:RLEVel:OFFSet <value>:DISPlay:WINDow:TRACe:Y:SCALe:RLEVel:OFFSet?
Sets reference offsets.
Gets reference offsets.
Float

Parameter
Type
Parameter
Range
Return-100 dB ~ 100 dB
Float, unit: dB

Default

0dB

Menu

Amplitude > Ref Offset

Example:DISPlay:WINDow:TRACe:Y:SCALe:RLEVel:OFFSet 2

CommandFormatInstruction:DISPlay:WINDow:TRACe:Y[:SCALe]:SPACing LINear|LOGarithmic:DISPlay:WINDow:TRACe:Y[:SCALe]:SPACing?
Toggles the vertical graticule divisions between logarithmic unit and linear unit. The
default logarithmic unit is dBm, and the linear unit is V.
Gets scale type.
Enumeration

Parameter
Type
Parameter
Range
ReturnLINear|LOGarithmic
Enumeration

Default

LOGarithmic

Menu

Amplitude > Scale Type

Example:DISPlay:WINDow:TRACe:Y:SPACing LINear

9.3 Sweep Subsection
INITiate[:IMMediate]:INITiate2:CONTinuous[:SENSe]:SWEep:COUNt[:SENSe]:FSCan:SCAN:PRBW[:SENSe]:FSCan:SCAN:PRBW:AUTO[:SENSe]:FSCan:SCAN:POINts?

Programming Guide

171

SIGLENT:INITiate:CONTinuous

CommandFormatInstruction

INITiate[:IMMediate]Parameter Type

None

Parameter
Range
ReturnNone

Default

None

Restart the current sweep.

None

Menu
Example:INIT:IMM

CommandFormatInstruction:INITiate2:CONTinuous OFF|ON|0|1:INITiate2:CONTinuous?
This control determines whether the scan is continuous or a single scan. The scan
will not start until you manually initiate the scanning through the Start or Clear Listand Start functions.

Parameter Type

BooleanParameter
Range
ReturnOFF|ON|0|1

Default

ON

Menu

Sweep > Scan Mode

Example:INITiate2:CONTinuous OFF

CommandFormatInstruction
Parameter
Type
Parameter
Range
Return0|1[:SENSe]:SWEep:COUNt <integer>[:SENSe]:SWEep:COUNt?
Sets sweep numbers, when single sweep on.
Gets sweep numbers, when single sweep on.
Integer
1 ~ 99999
Integer

Default

1

Menu

Sweep > Numbers

Example:SWEep:COUNt 10

172

Programming GuideSIGLENT
CommandFormatInstruction
Parameter
Type
Parameter
Range
Return[:SENSe]:FSCan:SCAN:PRBW < Float >[:SENSe]:FSCan:SCAN:PRBW?
Sets RBW/Step.
Gets RBW/Step.
Discrete, Float
0.1, 0.3, 0.5, 1, 2, 3
Float

Default

1

Menu

Sweep > RBW/Step

Example:FSCan:SCAN:PRBW 2

CommandFormatInstruction[:SENSe]:FSCan:SCAN:PRBW:AUTO < Boolean >[:SENSe]:FSCan:SCAN:PRBW:AUTO?
Sets RBW/Step AUTO.

Parameter Type

BooleanParameter
Range
ReturnOFF|ON|0|1

Default

ON

Menu

Sweep > RBW/Step

Example:FSCan:SCAN:PRBW:AUTO 1

0|1

CommandFormatInstruction[:SENSe]:FSCan:SCAN:POINts?

Parameter
Type
Parameter
Range
ReturnNone

Default

2251

Menu

Sweep > Sweep Points

Example:FSC:SCAN:POINts?

CommandFormatInstruction
Parameter
Type
Parameter
Range

Programming Guide

Gets sweep points.

None
Integer:INITiate:CONTinuous OFF|ON|0|1:INITiate:CONTinuous?
Sets meter sweep mode.
Gets meter sweep mode.
Boolean
OFF|ON|0|1

173

SIGLENT
Return0|1

Default

ON

Menu

Sweep > Meter Mode

Example:INITiate:CONTinuous OFF

9.4 Bandwidth Subsection[:SENSe]:FSCan:SCAN:BWIDth[:RESolution][:SENSe]:FSCan:SCAN:BWIDth[:RESolution]:AUTO[:SENSe]:BWIDth[:RESolution[:SENSe]:BWIDth[:RESolution]:AUTO

CommandFormatInstruction
Parameter
Type
Parameter
Range
Return[:SENSe]:FSCan:SCAN:BWIDth[:RESolution] <freq>[:SENSe]:FSCan:SCAN:BWIDth[:RESolution]?
Specifies the resolution bandwidth of scan.
Gets resolution bandwidth of scan.
Discrete
100 Hz, 200 Hz, 300 Hz, 1 kHz, 3 kHz, 9 kHz, 10 kHz, 30 kHz, 100 kHz, 120 kHz, 300
kHz, 1 MHz
Float, unit: Hz

Default

120 kHz

Menu

BW > RBW(Scan)

Example:FSC:SCAN:BWID 9 kHz

CommandFormatInstruction[:SENSe]:FSCan:SCAN:BWIDth[:RESolution]:AUTO OFF|ON|0|1[:SENSe]:FSCan:SCAN:BWIDth[:RESolution]:AUTO?
Turns on/off auto resolution bandwidth state of scan.
Gets resolution bandwidth state of scan.
BooleanParameter
Type
Parameter
Range
ReturnOFF|ON|0|1
0|1

DefaultON

Menu

BW > RBW(Scan)

Example:FSC:SCAN:BWID:AUTO ON

174

Programming GuideSIGLENT
CommandFormatInstruction
Parameter
Type
Parameter
Range
Return[:SENSe]:BWIDth[:RESolution] <freq>[:SENSe]:BWIDth[:RESolution]?
Specifies the resolution bandwidth of meters.
Gets the resolution bandwidth of meters.
Discrete
200 Hz, 9 kHz, 120 kHz
Float, unit: Hz

Default

9 kHz

Menu

BW > RBW(Meter)

Example:BWID 120 kHz

Command Format

Parameter Type[:SENSe]:BWIDth[:RESolution]:AUTO OFF|ON|0|1[:SENSe]:BWIDth[:RESolution]:AUTO?
Turns on/off auto resolution bandwidth state of meters.
Gets resolution bandwidth state of meters.
BooleanParameter Range

OFF|ON|0|1

Return0|1

DefaultON

Menu

BW > RBW(Meter)

Example:BWID:AUTO ON

Instruction

9.5 Trace Subsection:TRACe[1]|2|3:FSCan:TYPE[:SENSe]:DETector:TRACe[1]|2|3[:FUNCtion][:SENSe]:AVERage:TRACe[1]|2|3:COUNt:TRACe1|2|3:FSCan [:DATA]?
:FORMat[:TRACe][:DATA]
CommandFormatInstruction
Parameter
Type
Parameter
Range

Programming Guide:TRACe[1]|2|3:FSCan:TYPE
WRITe|MAXHold|MINHold|VIEW|BLANk|AVERage:TRACe[1]|2|3:FSCan:TYPE?
Selects the display mode for the selected trace.
Gets the display mode for the selected trace.
Enumeration
WRITe: puts the trace in the normal mode, updating the data.
MAXHold: displays the highest measured trace value for all the data that has beenmeasured since the function was turned on.
MINHold: displays the lowest measured trace value for all the data that has beenmeasured since the function was turned on.
VIEW: turns on the trace data so that it can be viewed on the display.

175

SIGLENT

ReturnBLANk: turns off the trace data so that it is not viewed on the display.
AVERage: averages the trace for test period.
Enumeration

Default

Trace1: WRITe, Trace2|3: BLANk

Menu

Trace

ExampleTRAC1:FSC:TYPE VIEW

CommandFormatInstruction[:SENSe]:DETector:TRACe[1]|2|3[:FUNCtion] POSitive|QPEak|EAVerage[:SENSe]:DETector:TRACe[1]|2|3[:FUNCtion]?
Specifies the detection mode. For each trace interval (bucket), average detection
displays the average of all the samples within the interval.
Enumeration

Parameter
Type
Parameter
Range
ReturnPOSitive|QPEak|EAVerage
Enumeration

Default

Trace 1: POS, Trace 2: QPE, Trace 3: EAV

Menu

DetectExample:DET:TRAC2 POS

CommandFormatInstruction[:SENSe]:AVERage:TRACe[1]|2|3:COUNt <integer>[:SENSe]:AVERage:TRACe[1]|2|3:COUNt?
Specifies the number of measurements that are combined.

Parameter
Type
Parameter
Range
ReturnInteger

Default

1

Menu

Trace > Average

Example:AVERage:TRACe1:COUNt 10

CommandFormatInstruction:TRACe1|2|3:FSCan [:DATA]?

Parameter
Type
Parameter
Range
ReturnNone

Default

1176

1 ~ 999
IntegerThis query command returns the current displayed data.

None
String

Programming GuideSIGLENT
Menu

None

Example:TRACe:DATA?

CommandFormatInstruction:FORMat[:TRACe][:DATA] ASCii|REAL32,|REAL,64:FORMat[:TRACe][:DATA]?
Sets trace data type.
Gets trace data type.
Enumeration

Parameter
Type
Parameter
Range

ReturnASCii
REAL,32 Binary 32-bit real values in the current Y Axis Unit, in a definite
length block.
REAL,64 Binary 64-bit real values in the current Y Axis Unit, in a definite
length block.
You can also use the following parameters
REAL32: Binary 32-bit real values in the current Y Axis Unit, in a definite
length block.
REAL: Binary 64-bit real values in the current Y Axis Unit, in a definite
length block.
StringDefault

ASCii

Menu

None

Example:FORMat ASCii

9.6 Marker Subsection:CALCulate:FSCan:MARKer[1]|2|3|4|5|6:STATe:CALCulate:FSCan:MARKer[1]|2|3|4|5|6:MODE:CALCulate:FSCan:MARKer[1]|2|3|4|5|6:TRACe:CALCulate:FSCan:MARKer[1]|2|3|4|5|6:REFerence:CALCulate:FSCan:MARKer[1]|2|3|4|5|6:X:CALCulate:FSCan:MARKer[1]|2|3|4|5|6:Y?
:CALCulate:FSCan:MARKer[1]|2|3|4|5|6[:SET]:SLISt:CALCulate:FSCan:MARKer[1]|2|3|4|5|6[:SET]:METer:CALCulate:FSCan:MARKer[1]|2|3|4|5|6:TO:METer:CALCulate:FSCan:MARKer[1]|2|3|4|5|6:TO:METer:CALCulate:MARKer:PEAK:THReshold:CALCulate:MARKer:PEAK:EXCursion:CALCulate:FSCan:MARKer[1]|2|3|4|5|6:MAXimum:CALCulate:MARKer[1]|2|3|4|5|6:MAXimum:LEFT:CALCulate:MARKer[1]|2|3|4|5|6:MAXimum:RIGHt

Programming Guide

177SIGLENT
CommandFormatInstruction
Parameter
Type
Parameter
Range
Return:CALCulate:FSCan:MARKer[1]|2|3|4|5|6:STATe OFF|ON|0|1:CALCulate:FSCan:MARKer[1]|2|3|4|5|6:STATe?
This command toggles the selected marker status between on and off.
Gets marker state.
Boolean
OFF|ON|0|1
0|1

Default

OFF

Menu

MarkerExample:CALC:FSC:MARK1:STAT ON

CommandFormatInstruction:CALCulate:FSCan:MARKer[1]|2|3|4|5|6:MODE POSition|DELTa|OFF|FIXed:CALCulate:FSCan:MARKer[1]|2|3|4|5|6:MODE?
Selects the type of markers that you want to activate.
Gets the type of markers.
Enumeration

Parameter
Type
Parameter
Range

ReturnPOSition: selects a normal marker that can be positioned on a trace and from which trace
information will be generated.
DELTa: activates a pair of markers, one of which is fixed at the current marker location.
The other marker can then be moved around on the trace. The marker readout shows themarker value which moves.
FIXed: Active marker fixed at current position
OFF: turns the designated marker off. If a marker is not active when the mode is queried,“off” will be returned.
Enumeration

Default

OFF

Menu

MarkerExample:CALC:FSC:MARK1:MODE POSition

CommandFormatInstruction:CALCulate:FSCan:MARKer[1]|2|3|4|5|6:TRACe 1|2|3:CALCulate:FSCan:MARKer[1]|2|3|4|5|6:TRACe?
This command assigns the specified marker to the designated trace 1, 2 or 3.
Gets the specified marker to which trace.
Enumeration

Parameter
Type
Parameter
Range
Return

MARKer:1|2|3|4|5|6
TRACe:1|2|3
Enumeration

Default

1

Menu

Marker > Select Trace

Example:CALC:FSC:MARK1:TRAC 2

178

Programming GuideSIGLENT
CommandFormatInstruction
Parameter
Type
Parameter
Range
Return:CALCulate:FSCan:MARKer[1]|2|3|4|5|6:REFerence <integer>:CALCulate:FSCan:MARKer[1]|2|3|4|5|6:REFerence?
Sets marker relative to.
Gets marker relative to.
Enumeration
1|2|3|4|5|6
Enumeration

Default

1

Menu

Marker > Relative To

Example:CALC:FSC:MARK1:REF 2

CommandFormatInstruction:CALCulate:FSCan:MARKer[1]|2|3|4|5|6:X <para>:CALCulate:FSCan:MARKer[1]|2|3|4|5|6:X?
This command positions the designated marker on its assigned trace at the specified trace
X value.
Float, unit: Hz, kHz, MHz, GHz, Default “Hz”

Parameter
Type
Parameter
Range
Return0 Hz ~ 7.5 GHz
Float, unit: Hz

Default

165 MHz

Menu

Marker > Normal

Example:CALC:FSC:MARK1:X 0.4 GHz:CALC:FSC:MARK1:X?

CommandFormatInstruction:CALCulate:FSCan:MARKer[1]|2|3|4|5|6:Y?

Parameter
Type
Parameter
Range
ReturnNone

Default

None

Menu

Marker > Normal

Example:CALC:FSC:MARK1:Y?

CommandFormatInstruction:CALCulate:FSCan:MARKer[1]|2|3|4|5|6[:SET]:SLISt

Parameter
Type

None

Programming Guide

This command reads the current Y value for the designated marker.

None
Float, unit: dBm

Set marker frequency to signal list.

179

SIGLENT
Parameter
Range
ReturnNone

Default

None

Menu

Marker→ > M→List

Example:CALC:FSC:MARK1:SLIS

CommandFormatInstruction:CALCulate:FSCan:MARKer[1]|2|3|4|5|6[:SET]:METer

Parameter
Type
Parameter
Range
ReturnNone

Replaces the frequency of the selected marker with Frequency (Meters). If the Meters
frequency is out of the current span, an error is generated and the marker is not moved.
None
None
None

Default

None

Menu

Marker→ > M→Meter

Example:CALC:FSC:MARK1:MET

CommandFormatInstruction:CALCulate:FSCan:MARKer[1]|2|3|4|5|6:TO:METer

Parameter
Type
Parameter
Range
ReturnNone

Default

None

Menu

Marker→ > Meter→M

Example:CALC:FSC:MARK1:TO:MET

CommandFormatInstruction:CALCulate:MARKer:PEAK:THReshold <value>:CALCulate:MARKer:PEAK:THReshold?
Specifies the minimum signal level for the analyzers internal peak identification routine
to recognize a signal as a peak. This applies to all traces and all windows.
Gets the minimum signal level for the analyzers internal peak identification routine torecognize a signal as a peak.
Float, unit: dBm, dBmV, dBuV, dBuA, V, W

Parameter
Type
Parameter
Range
Return180

Replaces Frequency (Meters) with the frequency identified by the selected marker.

None
None

-200 dBm ~ 200 dBm
Float, unit: dBm

Programming GuideSIGLENT
Default-100 dBm

Menu

Peak > Search Config > Peak Threshold

Example:CALC:MARK:PEAK:THR -50

CommandFormatInstruction:CALCulate:MARKer:PEAK:EXCursion <value>:CALCulate:MARKer:PEAK:EXCursion?
Specifies the minimum signal excursion above the threshold for the internal peakidentification routine to recognize a signal as a peak.
Float, unit: dB

Parameter
Type
Parameter
Range
Return0 ~ 200.0dB
Float, unit: dB

Default

15 dB

Menu

Peak > Search Config > Peak Excursion

Example:CALC:MARK:PEAK:EXC 10

CommandFormatInstruction:CALCulate:FSCan:MARKer[1]|2|3|4|5|6:MAXimum

Parameter
Type
Parameter
Range
ReturnPerforms a peak search based on the search mode settings.
(based on the search mode settings, include: peak threshold and peak excursion,
Reference Commands::CALCulate:MARKer:PEAK:THReshold:CALCulate:MARKer:PEAK:EXCursion)
None
None
None

Default

None

Menu

Peak

Example:CALCulate:MARKer4:MAXimum

CommandFormatInstruction:CALCulate:MARKer[1]|2|3|4|5|6:MAXimum:LEFT

Parameter
Type
Parameter
Range

Programming Guide

Places the selected marker on the next highest signal peak to the left of the current
marked peak.
(based on the search mode settings, include: peak threshold and peak excursion,
Reference Commands::CALCulate:MARKer:PEAK:THReshold:CALCulate:MARKer:PEAK:EXCursion)
None
None

181

SIGLENT
ReturnNone

Default

None

Menu

Peak > Left Peak

Example:CALCulate:MARKer1:MAXimum:LEFT

CommandFormatInstruction:CALCulate:MARKer[1]|2|3|4|5|6:MAXimum:RIGHt

Parameter
Type
Parameter
Range
ReturnPlaces the selected marker on the next highest signal peak to the right of the current
marked peak.
(based on the search mode settings, include: peak threshold and peak excursion,
Reference Commands::CALCulate:MARKer:PEAK:THReshold:CALCulate:MARKer:PEAK:EXCursion)
None
None
None

Default

None

Menu

Peak > Right Peak

Example:CALCulate:MARKer1:MAXimum:RIGHt

9.7 Limit Subsection:CALCulate:LLINe:TEST:CALCulate:LLINe[1]|2|3:STATe:CALCulate:FSCan:LLINe[1]|2|3:MARGin:CALCulate:FSCan:LLINe[1]|2|3:MARGin:STATe:CALCulate:FSCan:LLINe[1]|2|3:TRACe:CALCulate:LLINe[1]|2:MODE:CALCulate:LLINe[1]|2|3:Y:CALCulate:LLINe[1]|2|3:DATA:CALCulate:LLINe[1]|2|3:ADD:CALCulate:LLINe[1]|2|3:DELete:CALCulate:LLINe[1]|2|3:ALL:DELete:CALCulate:LLINe:FAIL?

CommandFormatInstruction

182:CALCulate:LLINe:TEST OFF|ON|0|1:CALCulate:LLINe:TEST?
Sets limit test start or stop.

Programming GuideSIGLENT
Parameter
Type
Parameter
Range
ReturnBooleanDefault

0

Menu

Limit > Test

Example:CALCulate:LLINe:TEST ON

CommandFormatInstruction:CALCulate:LLINe[1]|2|3:STATe OFF|ON|0|1:CALCulate:LLINe[1]|2|3:STATe?
Sets limit line state.
Gets limit line state.
BooleanParameter
Type
Parameter
Range
ReturnOFF|ON|0|1
0|1

OFF|ON|0|1
0|1

Default

OFF

Menu

Limit > Limit1|2|3

Example:CALCulate:LLINe1:STATe OFF

CommandFormatInstruction:CALCulate:FSCan:LLINe[1]|2|3:MARGin <value>:CALCulate:FSCan:LLINe[1]|2|3:MARGin?
Sets limit margin value.
Gets limit margin value.
Float, units: dB

Parameter
Type
Parameter
Range
Return-40 dB ~ 0 dB
Float, units: dB

Default

-6 dB

Menu

Limit > Limit1|2|3 > Margin

Example:CALC:FSC:LLIN1:MARG 0 dB

CommandFormatInstruction:CALCulate:FSCan:LLINe[1]|2|3:MARGin:STATe OFF|ON|0|1:CALCulate:FSCan:LLINe[1]|2|3:MARGin:STATe?
Sets limit margin state.
Gets limit margin state.
BooleanParameter
Type
Parameter
Range
ReturnProgramming Guide

OFF|ON|0|1
0|1

183

SIGLENT
Default

0

Menu

Limit > Limit1|2|3 > Margin

Example:CALC:FSC:LLIN1:MARG:STAT OFF

CommandFormatInstruction:CALCulate:FSCan:LLINe[1]|2|3:TRACe 1|2| 3:CALCulate:FSCan:LLINe[1]|2|3:TRACe?
The Trace column selects the trace that you want the limit to test.

Parameter
Type
Parameter
Range
ReturnEnumeration

Default

1

Menu

Limit > Limit1|2|3 Setup > Test Trace

Example:CALC:FSC:LLIN1:TRAC 2

CommandFormatInstruction:CALCulate:LLINe[1]|2:MODE LINE|POINt:CALCulate:LLINe[1]|2:MODE?
Sets limit mode.
Gets limit mode
Enumeration

Parameter
Type
Parameter
Range
Return1|2|3
Enumeration

LINE|POINt
Enumeration

Default

LINE

Menu

Limit > Limit1|2 Edit > Mode

Example:CALC:LLIN1: MODE POINt

CommandFormatInstruction:CALCulate:LLINe[1]|2|3:Y <value>:CALCulate:LLINe[1]|2|3:Y?
Sets the Y-axis value of a limit line. Limit line Y-axis value is set independently and is
not affected by the X-axis units.
Gets the Y-axis value of a limit line.
Float, units: dBm, dBmV, dBuV, dBuA, V, W

Parameter
Type
Parameter
Range
ReturnFloat

Default

0

Menu

Limit > Limit1|2|3 Setup > Edit > Amplitude

Example:CALC:LLIN1:Y 5 dBm

184

Programming GuideSIGLENT

CommandFormatInstruction

Menu:CALCulate:LLINe[1]|2|3:DATA <x-axis>,<ampl>{,<x-axis>, <ampl>}:CALCulate:LLINe[1]|2|3:DATA?
Uses this command to define the limit points.
Gets the defined limit points.
X-axis: Float, unit: Hz, kHz, MHz, GHz
Amplitude: Float, unit: dBm, dBmV, dBuV, dBuA, V, W
X-axis: 0 ~ 7.5 GHz
Amplitude:
X-axis: Float
Amplitude: Float
X-axis: -1 Hz
Amplitude:
Limit > Limit1|2|3 Edit

Example:CALC:LLIN1:DATA 10000000,-20,20000000,-30

CommandFormatInstruction:CALCulate:LLINe[1]|2|3:ADD <x-axis>,<ampl>

Parameter
Type
Parameter
Range
ReturnMenu

X-axis: Float
Amplitude: Float
X-axis: 0 ~ 7.5 GHz
Amplitude: None
X-axis: Float
Amplitude: Float
X-axis: -1 Hz
Amplitude: 0 dBm
Limit > Limit1|2|3 Edit

Example:CALC:LLIN1:ADD 10000000,-20

CommandFormatInstruction:CALCulate:LLINe[1]|2|3:DELete <number>

Parameter
Type
Parameter
Range
ReturnInteger

Default

None

Menu

Limit > Limit1|2|3 Edit > Del Point

Example:CALC:LLIN1:DEL 2

CommandFormat:CALCulate:LLINe[1]|2|3:ALL:DELete

Parameter
Type
Parameter
Range
ReturnDefault

Default

Programming Guide

Adds limit point data.

Uses this command to delete the assigned limit point.

None
None

185

SIGLENT
Instruction

Uses this command to define all the limits points.

Parameter
Type
Parameter
Range
ReturnNone

Default

None

Menu

Limit > Limit1|2|3 Edit > Del All

Example:CALC:LLIN2:ALL:DELete

CommandFormatInstruction:CALCulate:LLINe:FAIL?

Parameter
Type
Parameter
Range
ReturnNone
None

This query command returns the limits pass/failed result. If the test result fails, thiscommand will get result FAIL. If the test result passes, it will get result PASS.
None
None
PASS|FAIL

Default

None

Menu

None

Example:CALC:LLIN:FAIL?

9.8 Measurement Subsystem[:SENSe]:FSCan:SEQuence[:SENSe]:FSCan:SCAN:TIME:DISPlay:METer[1]|2|3[:STATe][:SENSe]:METer[1]|2|3:DETector:DWELl [:SENSe]:METer[1]|2|3:DETector:CALCulate:METer[1]|2|3:LIMit[:DATA]:CALCulate:METer[1]|2|3:LIMit:STATe:CALCulate:METer[1]|2|3:LIMit:ULLine:CALCulate:SLISt:MARK:SIGNal:CALCulate:SLISt:MARK:CLEar:SIGNal:CALCulate:SLISt:MARK:ALL:CALCulate:SLISt:MARK:CLEar:ALL:CALCulate:SLISt:DELete:SIGNal:CALCulate:SLISt:DELete:ALL:CALCulate:SLISt:SORT:TYPE

186

Programming GuideSIGLENT:CALCulate:SLISt:SORT:ORDer

CommandFormatInstruction
Parameter
Type
Parameter
Range
Return[:SENSe]:FSCan:SEQuence
SCAN|SEARch|SSAMeasure|SASearch|SAMeasure|REMeasure[:SENSe]:FSCan:SEQuence?
Sets the sequence.
Gets the sequence.
Enumeration
SCAN | SEARch | SSAMeasure | SASearch | SAMeasure | REMeasure
Enumeration

Default

SCAN

Menu

Meas > Sequence

Example:FSC:SEQ SEAR

CommandFormatInstruction[:SENSe]:FSCan:SCAN:TIME <time>[:SENSe]:FSCan:SCAN:TIME?
Sets scan dwell time.
Gets scan dwell time.
Float, unit: ks, s, ms, us

Parameter
Type
Parameter
Range
Return1 ms ~ 10 s
Float, unit: sDefault
Menu

Meas > Scan Config > Dwell Time

Example:FSC:SCAN:TIME 100 ms

CommandFormatInstruction:DISPlay:METer[1]|2|3[:STATe] OFF|ON|0|1:DISPlay:METer[1]|2|3[:STATe]?
Sets meter state.
Gets meter state.
BooleanParameter
Type
Parameter
Range
ReturnOFF|ON|0|1
0|1

Default

1

Menu

Meas > Meter Config > Meter 1|2|3

Example:DISP:MET1 OFF

Programming Guide

187

SIGLENT
CommandFormatInstruction
Parameter
Type
Parameter
Range
Return[:SENSe]:METer[1]|2|3:DETector:DWELl <time>[:SENSe]:METer[1]|2|3:DETector:DWELl?
Sets meter dwell time.
Gets meter dwell time.
Float, unit: ks, s, ms, us
1 ms ~ 10 s
Float, unit: sDefault

0.01

Menu

Meas > Meter Config > Meter 1|2|3 > Dwell Time

Example

MET1:DET:DWEL 50 ms

CommandFormatInstruction[:SENSe]:METer[1]|2|3:DETector POSitive|QPEak|EAVerage[:SENSe]:METer[1]|2|3:DETector?
Sets meter detector.
Gets meter detector.
Enumeration

Parameter
Type
Parameter
Range
ReturnDefault

POSitive|QPEak|EAVerage
Enumeration

Menu

Meter1: POS
Meter2: QPE
Meter3: EAV
Meas > Meter Config > Meter 1|2|3 Detector

Example

MET1:DET EAVCommandFormatInstruction:CALCulate:METer[1]|2|3:LIMit[:DATA] <ampl>:CALCulate:METer[1]|2|3:LIMit[:DATA]?
Sets limit value of meter.
Gets limit value of meter.
Float, unit: dBm, dBmV, dBuV, dBuA, V, W

Parameter
Type
Parameter
Range
ReturnFloat

Default

0

Menu

Meas > Meter Config > Meter1|2|3 Limit > Value

Example:CALC:MET1:LIM 20 dBuVCommandFormatInstruction:CALCulate:METer[1]|2|3:LIMit:STATe OFF|ON|0|1:CALCulate:METer[1]|2|3:LIMit:STATe?
Sets meter limit state.
Gets meter limit state.

188

Programming GuideSIGLENT
Parameter
Type
Parameter
Range
ReturnBooleanDefault

0

Menu

Meas > Meter Config > Meter1|2|3 Limit > Limit

Example:CALC:MET1:LIM:STAT ON

CommandFormatInstruction:CALCulate:METer[1]|2|3:LIMit:ULLine LIMit1 | LIMit2 | LIMit3

Parameter
Type
Parameter
Range
ReturnEnumeration

OFF|ON|0|1
0|1

Sets limit to meter limit value, You can't abbreviate the parameter as LIM1.

Default
Menu

Meas > Meter Config > Meter Limit

Example:CALCulate:METer1:LIMit:ULLine LIMit1

CommandFormatInstruction:CALCulate:SLISt:MARK:SIGNal <integer>

Parameter
Type
Parameter
Range
ReturnInteger

Default

None

Menu

Meas > List Operation > Mark Signal

Example:CALC:SLIS:MARK:SIGN 1

CommandFormatInstruction:CALCulate:SLISt:MARK:CLEar:SIGNal <integer>

Parameter
Type
Parameter
Range
ReturnInteger

Programming Guide

Marks the selected signal in signal list.

None

Clears the mark from the selected signal.

None

189

SIGLENT
Default

None

Menu

Meas > List Operation > Clear Mark

Example:CALC:SLIS:MARK:CLE:SIGN 1

CommandFormatInstruction:CALCulate:SLISt:MARK:ALL

Parameter
Type
Parameter
Range
ReturnNone

Default

None

Menu

Meas > Mark All

Example:CALC:SLIS:MARK:ALL

CommandFormatInstruction:CALCulate:SLISt:MARK:CLEar:ALL

Parameter
Type
Parameter
Range
ReturnNone

Default

None

Menu

Meas > List Operation > Clear All Marks

Example:CALC:SLIS:MARK:CLE:ALL

CommandFormatInstruction:CALCulate:SLISt:DELete:SIGNal <integer>

Parameter
Type
Parameter
Range
ReturnInteger

Default

None

Menu

Meas > List Operation > Delete Signal

Example:CALC:SLIS:DEL:SIG 1

190

Marks all signals in signal list.

None
None

Clears all the marks from the signal list.

None
None

Deletes the selected signal.

None

Programming GuideSIGLENT

CommandFormatInstruction:CALCulate:SLISt:DELete:ALL

Parameter
Type
Parameter
Range
ReturnNone

Default

None

Menu

Meas > List Operation > Delete All

Example:CALC:SLIS:ALL

CommandFormatInstruction:CALCulate:SLISt:SORT:TYPE FREQuency | DAMPlitude | DLDelta | TIME

Parameter
Type
Parameter
Range
ReturnEnumeration

Default

None

Menu

Meas > List Operation > Sort By

Example:CALC:SLIS:SORT:TYPE FREQ

CommandFormatInstruction:CALCulate:SLISt:SORT:ORDer ASCending|DESCending:CALCulate:SLISt:SORT:ORDer?
Sets the sort order of signal list.
Gets the sort order of signal list.
Enumeration

Parameter
Type
Parameter
Range
ReturnDeletes all signals from signal list.

None
None

DAMPlitude and DLDelta corresponds to Det.1 and Det.1△

None

ASCending|DESCending
ASC|DESC

DefaultASC

Menu

Meas > List Operation > Sort Order

Example:CALC:SLIS:SORT:ORD DESC

Programming Guide

191

SIGLENT

10.Programming Examples
This chapter gives some examples for the programmer. In these examples you can see how to use the VISA
or sockets, in combination with the commands have been described above to control the spectrum analyzer.
By following these examples, you can develop many more applications.

10.1 Examples of Using VISA
10.1.1 Example of VC++
Environment: Win7 32bit system, Visual Studio
The functions of this example: use the NI-VISA, to control the device with USBTMC or TCP/IP access to
do a write and read.
Follow the steps to finish the example:
1、 Open Visual Studio, create a new VC++ win32 console project.
2、 Set the project environment to use the NI-VISA lib, there are two ways to use NI-VISA, static or
automatic:
1)

Static: find files: visa.h, visatype.h, visa32.lib in NI-VISA install path. Copy them to your project, andadd them into project. In the projectname.cpp file, add the follow two lines:#include "visa.h"#pragma comment(lib,"visa32.lib")
2)

Automatic:

Set the .h file include directory, the NI-VISA install path, in our computer we set the path is: C:\Program
Files\IVI Foundation \VISA\WinNT\include. Set this path to project---properties---c/c++---General--Additional Include Directories: See the picture.

Set lib path set lib file:
Set lib path: the NI-VISA install path, in our computer we set the path is: C:\Program Files\IVI
Foundation\VISA\WinNT\lib\msc. Set this path to project---properties---Linker---General---Additional Library Directories: as seen in
the pictures below.

192

Programming GuideSIGLENT

Set lib file:project---properties---Linker---Command Line---Additional Options: visa32.lib

Include visa.h file: In the projectname.cpp file:#include <visa.h>3、 Add codes:
1) USBTMC access code:
Write a function Usbtmc_test:
int Usbtmc_test(){/* This code demonstrates sending synchronous read & write commands *//* to an USB Test & Measurement Class (USBTMC) instrument using *//* NI-VISA*//* The example writes the "*IDN?\n" string to all the USBTMC *//* devices connected to the system and attempts to read back *//* results using the write and read functions.
*//* The general flow of the code is *//* Open Resource Manager *//* Open VISA Session to an Instrument*//* Write the Identification Query Using viPrintf *//* Try to Read a Response With viScanf *//* Close the VISA Session *//***********************************************************/ViSessiondefaultRM;
ViSessioninstr;
ViUInt32numInstrs;
ViFindListfindList;
ViStatus status;char instrResourceString[VI_FIND_BUFLEN];
unsigned char buffer[100];
int i;/** First we must call viOpenDefaultRM to get the manager* handle. We will store this handle in defaultRM.*/
status=viOpenDefaultRM (&defaultRM);
if (status<VI_SUCCESS){
printf ("Could not open a session to the VISA Resource Manager!\n");returnstatus;}
Programming Guide

193

SIGLENT/* Find all the USB TMC VISA resources in our system and store the number of resources in the system innumInstrs.*/
status = viFindRsrc (defaultRM, "USB?*INSTR", &findList, &numInstrs, instrResourceString);
if (status<VI_SUCCESS){
printf ("An error occurred while finding resources.\nPress 'Enter' to continue.");fflush(stdin);getchar();viClose (defaultRM);
returnstatus;}/** Now we will open VISA sessions to all USB TMC instruments.
* We must use the handle from viOpenDefaultRM and we must
* also use a string that indicates which instrument to open. This
* is called the instrument descriptor. The format for this string* can be found in the function panel by right clicking on the* descriptor parameter. After opening a session to the* device, we will get a handle to the instrument which we* will use in later VISA functions. The AccessMode and Timeout* parameters in this function are reserved for future* functionality. These two parameters are given the value VI_NULL.*/
for (i=0; i<int(numInstrs); i++){
if (i> 0){ viFindNext (findList, instrResourceString);} status = viOpen (defaultRM, instrResourceString, VI_NULL, VI_NULL, &instr);
if (status<VI_SUCCESS){
printf ("Cannot open a session to the device %d.\n", i+1);
continue;}/* * At this point we now have a session open to the USB TMC instrument.
* We will now use the viPrintf function to send the device the string "*IDN?\n",* asking for the device's identification. */char * cmmand ="*IDN?\n";status = viPrintf (instr, cmmand);if (status<VI_SUCCESS){
printf ("Error writing to the device %d.\n", i+1);
status = viClose (instr);
continue;}/** Now we will attempt to read back a response from the device to* the identification query that was sent. We will use the viScanf* function to acquire the data.
* After the data has been read the response is displayed.*/status = viScanf(instr, "%t", buffer);
if (status<VI_SUCCESS){ printf ("Error reading a response from the device %d.\n", i+1);} else{ printf ("\nDevice %d: %s\n", i+1, buffer);}status = viClose (instr);}/** Now we will close the session to the instrument using* viClose. This operation frees all system resources.
*/
status = viClose (defaultRM);
printf("Press 'Enter' to exit.");fflush(stdin);getchar();return 0;}
int _tmain(int argc, _TCHAR* argv[]){
Usbtmc_test();return 0;}

194

Programming GuideSIGLENT
2)

TCP/IP access code:

Write a function TCP_IP_Test:
int TCP_IP_Test(char *pIP){
char outputBuffer[VI_FIND_BUFLEN];
ViSessiondefaultRM, instr;
ViStatusstatus;/* First we will need to open the default resource manager. */status = viOpenDefaultRM (&defaultRM);
if (status<VI_SUCCESS){
printf("Could not open a session to the VISA Resource Manager!\n");}/* Now we will open a session via TCP/IP device */char head[256] ="TCPIP0::";char tail[] ="::INSTR";
strcat(head,pIP);
strcat(head,tail);
status = viOpen (defaultRM, head, VI_LOAD_CONFIG, VI_NULL, &instr);
if (status<VI_SUCCESS){
printf ("An error occurred opening the session\n");viClose(defaultRM);}
status = viPrintf(instr, "*idn?\n");status = viScanf(instr, "%t", outputBuffer);
if (status<VI_SUCCESS){
printf("viRead failed with error code: %x \n",status);
viClose(defaultRM);}else{ printf ("\nMesseage read from device: %*s\n", 0,outputBuffer);} status = viClose (instr);
status = viClose (defaultRM);
printf("Press 'Enter' to exit.");fflush(stdin);getchar();return 0;}
int _tmain(int argc, _TCHAR* argv[]){
printf("Please input IP address:");char ip[256];
fflush(stdin);gets(ip);
TCP_IP_Test(ip);return 0;}

10.1.2 Example of VB
Environment: Win7 32bit system, Microsoft Visual Basic 6.0
The function of this example: Use the NI-VISA, to control the device with USBTMC and TCP/IP accessto do a write and read.
Follow the steps to complete the example:
1、 Open Visual Basic, build a standard application program project (Standard EXE)
2、 Set the project environment to use the NI-VISA lib, Click the Existing tab of Project>>Add Existing
Item. Search for the visa32.bas file in the include folder under the NI-VISA installation path and add theProgramming Guide

195

SIGLENT
file.

This allows the VISA functions and VISA data types to be used in a program.
3、 Add codes:
1) USBTMC access code:
Write a function Usbtmc_test:
Private Function Usbtmc_test() As Long
' This code demonstrates sending synchronous read & write commands' to an USB Test & Measurement Class (USBTMC) instrument using' NI-VISA' The example writes the "*IDN?\n" string to all the USBTMC' devices connected to the system and attempts to read back' results using the write and read functions.
' The general flow of the code is' Open Resource Manager' Open VISA Session to an Instrument' Write the Identification Query Using viWrite' Try to Read a Response With viRead' Close the VISA Session
Const MAX_CNT = 200
Dim defaultRM As Long
Dim instrsesn As Long
Dim numlnstrs As Long
Dim findList As Long
Dim retCount As Long
Dim status As Long
Dim instrResourceString As String * VI_FIND_BUFLEN
Dim Buffer As String * MAX_CNT
Dim i As Integer' First we must call viOpenDefaultRM to get the manager' handle. We will store this handle in defaultRM.
status = viOpenDefaultRM(defaultRM)
If (status < VI_SUCCESS) Then
resultTxt.Text = "Could not open a session to the VISA Resource Manager!"
Usbtmc_test = status
Exit Function
End If' Find all the USB TMC VISA resources in our system and store the' number of resources in the system in numInstrs.
status = viFindRsrc(defaultRM, "USB?*INSTR", findList, numlnstrs, instrResourceString)If (status < VI_SUCCESS) Then
196

Programming GuideSIGLENT
resultTxt.Text = "An error occurred while finding resources."
viClose (defaultRM)
Usbtmc_test = status
Exit Function
End If' Now we will open VISA sessions to all USB TMC instruments.
' We must use the handle from viOpenDefaultRM and we must
' also use a string that indicates which instrument to open. This
' is called the instrument descriptor. The format for this string' can be found in the function panel by right clicking on the' descriptor parameter. After opening a session to the' device, we will get a handle to the instrument which we' will use in later VISA functions. The AccessMode and Timeout' parameters in this function are reserved for future' functionality. These two parameters are given the value VI_NULL.
For i = 0 To numInstrs
If (i > 0) Thenstatus = viFindNext(findList, instrResourceString)
End Ifstatus = viOpen(defaultRM, instrResourceString, VI_NULL, VI_NULL, instrsesn)
If (status < VI_SUCCESS) Then
resultTxt.Text = "Cannot open a session to the device " + CStr(i + 1)
GoTo NextFind
End If' At this point we now have a session open to the USB TMC instrument.
' We will now use the viWrite function to send the device the string "*IDN?",' asking for the device's identification.
status = viWrite(instrsesn, "*IDN?", 5, retCount)
If (status < VI_SUCCESS) Then
resultTxt.Text = "Error writing to the device."
status = viClose(instrsesn)
GoTo NextFind
End If' Now we will attempt to read back a response from the device to' the identification query that was sent. We will use the viRead' function to acquire the data.
' After the data has been read the response is displayed.
status = viRead(instrsesn, Buffer, MAX_CNT, retCount)
If (status < VI_SUCCESS) Then
resultTxt.Text = "Error reading a response from the device." + CStr(i + 1)
ElseresultTxt.Text = "Read from device: " + CStr(i + 1) + " " + Buffer
End Ifstatus = viClose(instrsesn)
Next i' Now we will close the session to the instrument using' viClose. This operation frees all system resources.
status = viClose(defaultRM)
Usbtmc_test = 0
End Function

2) TCP/IP access code:
Write a function TCP_IP_Test:
Private Function TCP_IP_Test(ByVal ip As String) As Long
Dim outputBuffer As String * VI_FIND_BUFLEN
Dim defaultRM As Long
Dim instrsesn As Long
Dim status As Long
Dim count As Long

Programming Guide

197

SIGLENT' First we will need to open the default resource manager.
status = viOpenDefaultRM (defaultRM)
If (status < VI_SUCCESS) Then
resultTxt.Text = "Could not open a session to the VISA Resource Manager!"
TCP_IP_Test = status
Exit Function
End If' Now we will open a session via TCP/IP device
status = viOpen(defaultRM, "TCPIP0::" + ip + "::INSTR", VI_LOAD_CONFIG, VI_NULL, instrsesn)
If (status < VI_SUCCESS) Then
resultTxt.Text = "An error occurred opening the session"viClose (defaultRM)
TCP_IP_Test = status
Exit Function
End Ifstatus = viWrite(instrsesn, "*IDN?", 5, count)
If (status < VI_SUCCESS) Then
resultTxt.Text = "Error writing to the device."
End Ifstatus = viRead(instrsesn, outputBuffer, VI_FIND_BUFLEN, count)
If (status < VI_SUCCESS) Then
resultTxt.Text = "Error reading a response from the device." + CStr(i + 1)
ElseresultTxt.Text = "read from device:" + outputBuffer
End Ifstatus = viClose(instrsesn)
status = viClose(defaultRM)
TCP_IP_Test = 0
End Function

3)

Button control code:
Private Sub exitBtn_Click()End
End Sub
Private Sub tcpipBtn_Click()Dim stat As Long
stat = TCP_IP_Test(ipTxt.Text)
If (stat < VI_SUCCESS) Then
resultTxt.Text = Hex(stat)
End IfEnd Sub
Private Sub usbBtn_Click()Dim stat As Long
stat = Usbtmc_test
If (stat < VI_SUCCESS) Then
resultTxt.Text = Hex(stat)
End IfEnd Sub

10.1.3 Example of MATLAB
Environment: Win7 32bit system, MATLAB R2013a
The function of this example: Use the NI-VISA, to control the device with USBTMC or TCP/IP access to
do a write and read.
Follow the steps to complete the example:
1、 Open MATLAB, modify the current directory. In this demo, the current directory is modified to
D:\USBTMC_TCPIP_Demo.
2、 Click File>>New>>Script in the Matlab interface to create an empty M file198

Programming GuideSIGLENT
3、 Add codes:
1) USBTMC access code :Write a function Usbtmc_test.
function USBTMC_test()% This code demonstrates sending synchronous read & write commands% to an USB Test & Measurement Class (USBTMC) instrument using% NI-VISA%Create a VISA-USB object connected to a USB instrument
vu = visa('ni','USB0::0xF4ED::0xEE3A::sdg2000x::INSTR');%Open the VISA object createdfopen(vu);%Send the string "*IDN?",asking for the device's identification.
fprintf(vu,'*IDN?');%Request the data
outputbuffer = fscanf(vu);disp(outputbuffer);%Close the VISA object
fclose(vu);delete(vu);clear vu;end

2)

TCP/IP access code:

Write a function TCP_IP_Test:
function TCP_IP_test()% This code demonstrates sending synchronous read & write commands% to an TCP/IP instrument using NI-VISA%Create a VISA-TCPIP object connected to an instrument%configured with IP address.
vt = visa('ni',['TCPIP0::','10.11.13.32','::INSTR']);%Open the VISA object createdfopen(vt);%Send the string "*IDN?",asking for the device's identification.
fprintf(vt,'*IDN?');%Request the data
outputbuffer = fscanf(vt);disp(outputbuffer);%Close the VISA object
fclose(vt);delete(vt);clear vt;
end

10.1.4 Example of LabVIEW
Environment: Win7 32bit system, LabVIEW 2011

Programming Guide

199

SIGLENT
The functions of this example: use the NI-VISA, to control the device with USBTMC and TCP/IP accessto do a write and read.
Follow the steps to complete the example:
1、 Open LabVIEW, create a VI file.
2、 Add controls. Right-click in the Front Panel interface, select and add VISA resource name, error in,error out and some indicators from the Controls column.
3、 Open the Block Diagram interface. Right-click on the VISA resource name and you can select andadd the following functions from VISA Palette from the pop-up menu: VISA Write, VISA Read, VISA
Open and VISA Close.
4、 Connect them as shown in the figure below

5、 Select the device resource from the VISA Resource Name list box and run the program.

In this example, the VI opens a VISA session to a USBTMC device, writes a command to the device, andreads back the response. In this example, the specific command being sent is the device ID query. Check
with your device manufacturer for the device command set. After all communication is complete, the VI
closes the VISA session.
6、 Communicating with the device via TCP/IP is similar to USBTMC. But you need to change VISA
Write and VISA Read Function to Synchronous I/O. The LabVIEW default is asynchronous I/O.
Right-click the node and select Synchronous I/O Mod>>Synchronous from the shortcut menu to write
or read data synchronously.
7、 Connect them as shown in the figure below

200

Programming GuideSIGLENT

8、 Input the IP address and run the program.

Programming Guide

201

SIGLENT

10.2 Examples of Using Sockets/Telnet
10.2.1 Example of Python
Python is an interpreted programming language that lets you work quickly and is very portable.Python has a
low-level networking module that provides access to the socket interface.Python scripts can be written forsockets to do a variety of test and measurements tasks.
Environment: Win7 32bit system, Python v2.7.5
The functions of this example: Open a socket, sends a query, and closes the socket. It does this loop 10
times.
Below is the code of the script:#!/usr/bin/env python#-*- coding:utf-8 –*#----------------------------------------------------------------------------# The short script is a example that open a socket, sends a query,# print the return message and closes the socket.
#----------------------------------------------------------------------------import socket # for sockets
import sys # for exit
import time # for sleep#----------------------------------------------------------------------------remote_ip = "10.11.13.32" # should match the instrument’s IP address
port = 5025 # the port number of the instrument service
count = 0
def SocketConnect():try:#create an AF_INET, STREAM socket (TCP)s = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
except socket.error:
print ('Failed to create socket.')sys.exit();try:#Connect to remote servers.connect((remote_ip , port))
info = s.recv(4096)
print (info)
except socket.error:
print ('failed to connect to ip ' + remote_ip)
return s
def SocketQuery(Sock, cmd):
try :#Send cmd string
Sock.sendall(cmd)Sock.sendall(b'\n')time.sleep(1)except socket.error:#Send failed
print ('Send failed')
sys.exit()
reply = Sock.recv(4096)
return reply
def SocketClose(Sock):#close the socket
Sock.close()time.sleep(.300)

202

Programming GuideSIGLENT
def main():global remote_ip
global port
global count# Body: send the SCPI commands *IDN? 10 times and print the return message
s = SocketConnect()for i in range(10):qStr = SocketQuery(s, b'*IDN?')
print (str(count) + ":: " + str(qStr))count = count + 1 SocketClose(s)input('Press "Enter" to exit')
if __name__ == '__main__':proc = main()

Run result:

Programming Guide

203