Instructions
Table Of Contents
- Guaranty and Declaration
 - Document Overview
 - Programming Overview
 - Command System
- :CALCulate Commands
- :CALCulate:BANDwidth|BWIDth:NDB
 - :CALCulate:BANDwidth|BWIDth:RESult?
 - :CALCulate:BANDwidth|BWIDth:RLEFt?
 - :CALCulate:BANDwidth|BWIDth:RRIGht?
 - :CALCulate:BANDwidth|BWIDth [:STATe]
 - :CALCulate:LLINe:ALL:DELete
 - :CALCulate:LLINe:TEST
 - :CALCulate:LLINe
:AMPLitude:CMODe:RELative  - :CALCulate:LLINe
:BUILd  - :CALCulate:LLINe
:COPY  - :CALCulate:LLINe
:DATA  - :CALCulate:LLINe
:DELete  - :CALCulate:LLINe
:DISPlay  - :CALCulate:LLINe
:FAIL?  - :CALCulate:LLINe
:FREQuency:CMODe:RELative  - :CALCulate:LLINe
:MARGin  - :CALCulate:LLINe
:MARGin:STATe  - :CALCulate:LLINe
:TRACe  - :CALCulate:LLINe
:TYPE  - :CALCulate:MARKer:AOFF
 - :CALCulate:MARKer:COUPle[:STATe]
 - :CALCulate:MARKer:PEAK:EXCursion
 - :CALCulate:MARKer:PEAK:EXCursion:STATe
 - :CALCulate:MARKer:PEAK:SEARch:MODE
 - :CALCulate:MARKer:PEAK:SORT
 - :TRACe:MATH:PEAK:SORT
 - :CALCulate:MARKer:PEAK:TABLe:READout
 - :TRACe:MATH:PEAK:THReshold
 - :CALCulate:MARKer:PEAK:TABLe[:STATe]
 - :TRACe:MATH:PEAK:TABLe:STATe
 - :CALCulate:MARKer:PEAK:THReshold
 - :CALCulate:MARKer:PEAK:THReshold:STATe
 - :CALCulate:MARKer:TABLe[:STATe]
 - :CALCulate:MARKer:TRCKing[:STATe]
 - :CALCulate:MARKer
:CPSearch[:STATe]  - :CALCulate:MARKer
:FCOunt:GATetime  - :CALCulate:MARKer
:FCOunt:GATetime:AUTO  - :CALCulate:MARKer
:FCOunt[:STATe]  - :CALCulate:MARKer
:FCOunt:X?  - :CALCulate:MARKer
:FUNCtion  - :CALCulate:MARKer
:FUNCtion:BAND:LEFT  - :CALCulate:MARKer
:FUNCtion:BAND:RIGHt  - :CALCulate:MARKer
:FUNCtion:BAND:SPAN  - :CALCulate:MARKer
:FUNCtion:BAND:SPAN:AUTO  - :CALCulate:MARKer
:LINes[:STATe]  - :CALCulate:MARKer
:MAXimum:LEFT  - :CALCulate:MARKer
:MAXimum[:MAX]  - :CALCulate:MARKer
:MAXimum:NEXT  - :CALCulate:MARKer
:MAXimum:RIGHt  - :CALCulate:MARKer
:MINimum  - :CALCulate:MARKer
:MODE  - :CALCulate:MARKer
:PTPeak  - :CALCulate:MARKer
:REFerence  - :CALCulate:MARKer
[:SET]:CENTer  - :CALCulate:MARKer
[:SET]:DELTa:CENTer  - :CALCulate:MARKer
[:SET]:DELTa:SPAN  - :CALCulate:MARKer
[:SET]:RLEVel  - :CALCulate:MARKer
[:SET]:STARt  - :CALCulate:MARKer
[:SET]:STEP  - :CALCulate:MARKer
[:SET]:STOP  - :CALCulate:MARKer
:STATe  - :CALCulate:MARKer
:TRACe  - :CALCulate:MARKer
:TRACe:AUTO  - :CALCulate:MARKer
:X  - :CALCulate:MARKer
:X:READout  - :CALCulate:MARKer
:X:READout:AUTO  - :CALCulate:MARKer
:Y  - :CALCulate:MARKer
:Z:POSition  - :CALCulate:MATH
 - :CALCulate:NTData[:STATe]
 
 - :CALibration Commands
 - :CONFigure Commands
- :CONFigure?
 - :CONFigure:ACPower
 - :CONFigure:CNRatio
 - :CONFigure:DENSity
 - :CONFigure:DSPEctrogram
 - :CONFigure:EBWidth
 - :CONFigure:HDISt
 - :CONFigure:LPSTep
 - :CONFigure:MCHPower
 - :CONFigure:NORMal
 - :CONFigure:OBWidth
 - :CONFigure:PSGRam
 - :CONFigure:PSPectrum
 - :CONFigure:PVT
 - :CONFigure:SANalyzer
 - :CONFigure:SPECtrogram
 - :CONFigure:TOI
 - :CONFigure:TPOWer
 
 - :COUPle Commands
 - :DISPlay Commands
- :DISPlay:BACKlight
 - :DISPlay:ENABle
 - :DISPlay:GRATicule[:STATe]
 - :DISPlay:HDMI[:STATe]
 - :DISPlay:PVTime:WINDow:TRACe:X[:SCALe]:COUPle
 - :DISPlay:PVTime:WINDow:TRACe:X[:SCALe]:PDIVision
 - :DISPlay:PVTime:WINDow:TRACe:X[:SCALe]:RLEVel
 - :DISPlay:PVTime:WINDow:TRACe:X[:SCALe]:RPOSition
 - :DISPlay:PVTime:WINDow:TRACe:Y[:SCALe]:PDIVision
 - :DISPlay:PVTime:WINDow:TRACe:Y[:SCALe]:RLEVel 
 - :DISPlay:VIEW:DENSity:AADJust
 - :DISPlay:VIEW:DENSity:CNONlinear
 - :DISPlay:VIEW:DENSity:CPALettes
 - :DISPlay:VIEW:DENSity:HDHue
 - :DISPlay:VIEW:DENSity:LDHue
 - :DISPlay:VIEW:DENSity:PERSistence
 - :DISPlay:VIEW:DENSity:PERSistence:INFinite
 - :DISPlay:VIEW[:SELect]
 - :DISPlay:VIEW:SPECtrogram:AADJust
 - :DISPlay:VIEW:SPECtrogram:BOTTom
 - :DISPlay:VIEW:SPECtrogram:HUE
 - :DISPlay:VIEW:SPECtrogram:POSition
 - :DISPlay:VIEW:SPECtrogram:REFerence
 - :DISPlay:VIEW:SPECtrogram:TRACe:COUPle
 - :DISPlay:VIEW:SPECtrogram:TRACe:SELection
 - :DISPlay:WINDow:SELect
 - :DISPlay:WINDow:TRACe:Y:DLINe
 - :DISPlay:WINDow:TRACe:Y:DLINe:STATe
 - :DISPlay:WINDow:TRACe:Y[:SCALe]:NRLevel
 - :DISPlay:WINDow:TRACe:Y[:SCALe]:NRPosition
 - :DISPlay:WINDow:TRACe:Y[:SCALe]:PDIVision
 - :DISPlay:WINDow:TRACe:Y[:SCALe]:RLEVel
 - :DISPlay:WINDow:TRACe:Y[:SCALe]:RLEVel:OFFSet
 - :DISPlay:WINDow:TRACe:Y[:SCALe]:SPACing
 
 - :FETCh Commands
- :FETCh:ACPower?
 - :FETCh:ACPower:LOWer?
 - :FETCh:ACPower:MAIN?
 - :FETCh:ACPower:UPPer?
 - :FETCh:CNRatio?
 - :FETCh:CNRatio:CARRier?
 - :FETCh:CNRatio:CNRatio?
 - :FETCh:CNRatio:NOISe?
 - :FETCh:EBWidth?
 - :FETCh:HARMonics:AMPLitude:ALL?
 - :FETCh:HARMonics:AMPLitude? 
 - :FETCh:HARMonics[:DISTortion]?
 - :FETCh:HARMonics:FREQuency:ALL?
 - :FETCh:HARMonics:FREQuency? 
 - :FETCh:HARMonics:FUNDamental?
 - :FETCh:OBWidth?
 - :FETCh:OBWidth:OBWidth?
 - :FETCh:OBWidth:OBWidth:FERRor?
 - :FETCh:SANalyzer
?  - :FETCh:TOIntercept?
 - :FETCh:TOIntercept:IP3?
 - :FETCh:TPOWer?
 
 - :FORMat Commands
 - IEEE 488.2 Common Commands
 - :INITiate Commands
 - :INSTrument Commands
 - :MMEMory Commands
 - :OUTPut Commands
 - :READ Commands
- :READ:ACPower?
 - :READ:ACPower:LOWer?
 - :READ:ACPower:MAIN?
 - :READ:ACPower:UPPer?
 - :READ:CNRatio?
 - :READ:CNRatio:CARRier?
 - :READ:CNRatio:CNRatio?
 - :READ:CNRatio:NOISe?
 - :READ:EBWidth?
 - :READ:HARMonics:AMPLitude:ALL?
 - :READ:HARMonics:AMPLitude? 
 - :READ:HARMonics[:DISTortion]?
 - :READ:HARMonics:FREQuency:ALL?
 - :READ:HARMonics:FREQuency? 
 - :READ:HARMonics:FUNDamental?
 - :READ:OBWidth?
 - :READ:OBWidth:OBWidth?
 - :READ:OBWidth:OBWidth:FERRor?
 - :READ:SANalyzer
?  - :READ:TOIntercept?
 - :READ:TOIntercept:IP3?
 - :READ:TPOWer?
 
 - [:SENSe] Commands
- [:SENSe]:ACPower:AVERage:COUNt
 - [:SENSe]:ACPower:AVERage[:STATe]
 - [:SENSe]:ACPower:AVERage:TCONtrol
 - [:SENSe]:ACPower:BANDwidth:ACHannel
 - [:SENSe]:ACPower:BANDwidth:INTegration
 - [:SENSe]:ACPower:CSPacing
 - [:SENSe]:ACQuisition:TIME
 - [:SENSe]:ACQuisition:TIME:AUTO
 - [:SENSe]:ACQuisition:TIME:PVTime
 - [:SENSe]:ACQuisition:TIME:PVTime:AUTO
 - [:SENSe]:AVERage:COUNt
 - :TRACe:AVERage:COUNt
 - [:SENSe]:AVERage:COUNt:CURRent?
 - :TRACe:AVERage:COUNt:CURRent?
 - [:SENSe]:AVERage:TYPE
 - :TRACe
:AVERage:TYPE  - [:SENSe]:AVERage:TYPE:AUTO
 - [:SENSe]:BANDwidth|BWIDth:EMIFilter:STATe
 - [:SENSe]:BANDwidth|BWIDth[:RESolution]
 - [:SENSe]:BANDwidth|BWIDth[:RESolution]:AUTO
 - [:SENSe]:BANDwidth|BWIDth[:RESolution]:SELect
 - [:SENSe]:BANDwidth|BWIDth[:RESolution]:SELect:AUTO[:STATe]
 - [:SENSe]:BANDwidth|BWIDth:SHAPe
 - [:SENSe]:BANDwidth|BWIDth:VIDeo
 - [:SENSe]:BANDwidth|BWIDth:VIDeo:AUTO
 - [:SENSe]:BANDwidth|BWIDth:VIDeo:RATio
 - [:SENSe]:BANDwidth|BWIDth:VIDeo:RATio:AUTO
 - [:SENSe]:CNRatio:AVERage:COUNt
 - [:SENSe]:CNRatio:AVERage[:STATe]
 - [:SENSe]:CNRatio:AVERage:TCONtrol
 - [:SENSe]:CNRatio:BANDwidth:INTegration
 - [:SENSe]:CNRatio:BANDwidth:NOISe
 - [:SENSe]:CNRatio:OFFSet
 - :INPut:IMPedance
 - [:SENSe]:CORRection:IMPedance[:INPut][:MAGNitude]
 - [:SENSe]:CORRection:SA[:RF]:GAIN
 - [:SENSe]:DEMod
 - [:SENSe]:DEMod:GAIN:AUTO
 - [:SENSe]:DEMod:GAIN:INCRement
 - [:SENSe]:DEMod:STATe
 - [:SENSe]:DETector:TRACe:PVTime
 - [:SENSe]:DETector[:FUNCtion]
 - [:SENSe]:DETector:TRACe
 - [:SENSe]:DETector:TRACe
:AUTO  - [:SENSe]:EBWidth:AVERage:COUNt
 - [:SENSe]:EBWidth:AVERage[:STATe]
 - [:SENSe]:EBWidth:AVERage:TCONtrol
 - [:SENSe]:EBWidth:FREQuency:SPAN
 - [:SENSe]:EBWidth:MAXHold:STATe
 - [:SENSe]:EBWidth:XDB
 - [:SENSe]:FREQuency:CENTer
 - [:SENSe]:FREQuency:CENTer:STEP:AUTO
 - [:SENSe]:FREQuency:CENTer:STEP[:INCRement]
 - [:SENSe]:FREQuency:OFFSet
 - [:SENSe]:FREQuency:SPAN
 - [:SENSe]:FREQuency:SPAN:BANDwidth[:RESolution]:RATio
 - [:SENSe]:FREQuency:SPAN:BANDwidth[:RESolution]:RATio:AUTO
 - [:SENSe]:FREQuency:SPAN:FULL
 - [:SENSe]:FREQuency:SPAN:PREVious
 - [:SENSe]:FREQuency:SPAN:ZERO
 - [:SENSe]:FREQuency:STARt
 - [:SENSe]:FREQuency:STOP
 - [:SENSe]:FREQuency:TUNE:IMMediate
 - [:SENSe]:HDISt:AVERage:COUNt
 - [:SENSe]:HDISt:AVERage[:STATe]
 - [:SENSe]:HDISt:AVERage:TCONtrol
 - [:SENSe]:HDISt:NUMBers
 - [:SENSe]:HDISt:TIME
 - [:SENSe]:MCHPower:AVERage:COUNt
 - [:SENSe]:MCHPower:AVERage[:STATe]
 - [:SENSe]:MCHPower:AVERage:TCONtrol
 - [:SENSe]:OBWidth:AVERage:COUNt
 - [:SENSe]:OBWidth:AVERage[:STATe]
 - [:SENSe]:OBWidth:AVERage:TCONtrol
 - [:SENSe]:OBWidth:FREQuency:SPAN
 - [:SENSe]:OBWidth:MAXHold:STATe
 - [:SENSe]:OBWidth:PERCent
 - [:SENSe]:POWer[:RF]:ATTenuation
 - [:SENSe]:POWer[:RF]:ATTenuation:AUTO
 - [:SENSe]:POWer[:RF]:GAIN[:STATe]
 - [:SENSe]:POWer[:RF]:MIXer:RANGe[:UPPer]
 - [:SENSe]:SIGCapture:2FSK:AMPDown
 - [:SENSe]:SIGCapture:2FSK:AMPUp
 - [:SENSe]:SIGCapture:2FSK:MARK1:FREQ
 - [:SENSe]:SIGCapture:2FSK:MARK1:SWitch[:STATe]
 - [:SENSe]:SIGCapture:2FSK:MARK2:FREQ
 - [:SENSe]:SIGCapture:2FSK:MARK2:SWitch[:STATe]
 - [:SENSe]:SIGCapture:2FSK:MAXHold[:STATe]
 - [:SENSe]:SIGCapture:2FSK:PEAKAmp?
 - [:SENSe]:SIGCapture:2FSK:PEAKFreq?
 - [:SENSe]:SIGCapture:2FSK:PF?
 - [:SENSe]:SIGCapture:2FSK:PFSWitch[:STATe]
 - [:SENSe]:SIGCapture:2FSK:RESet
 - [:SENSe]:SIGCapture:2FSK:SIGNal
 - [:SENSe]:SWEep:POINts
 - [:SENSe]:SWEep:TIME
 - [:SENSe]:SWEep:TIME:AUTO
 - [:SENSe]:SWEep:TIME:AUTO:RULes
 - [:SENSe]:TOI:AVERage:COUNt
 - [:SENSe]:TOI:AVERage[:STATe]
 - [:SENSe]:TOI:AVERage:TCONtrol
 - [:SENSe]:TOI:FREQuency:SPAN
 - [:SENSe]:TPOWer:AVERage:COUNt
 - [:SENSe]:TPOWer:AVERage[:STATe]
 - [:SENSe]:TPOWer:AVERage:TCONtrol
 - [:SENSe]:TPOWer:LLIMit
 - [:SENSe]:TPOWer:MODE
 - [:SENSe]:TPOWer:RLIMit
 
 - :SOURce Commands
 - :STATus Commands
 - :SYSTem Commands
- :SYSTem:BEEPer:STATe
 - :SYSTem:COMMunicate:LAN[:SELF]:APPLy
 - :SYSTem:COMMunicate:LAN[:SELF]:AUToip:STATe
 - :SYSTem:COMMunicate:LAN[:SELF]:DHCP:STATe
 - :SYSTem:COMMunicate:LAN[:SELF]:IP:ADDRess
 - :SYSTem:COMMunicate:LAN[:SELF]:IP:DNS:AUTO[:STATe]
 - :SYSTem:COMMunicate:LAN[:SELF]:IP:DNSBack
 - :SYSTem:COMMunicate:LAN[:SELF]:IP:DNSPreferred
 - :SYSTem:COMMunicate:LAN[:SELF]:IP:DNSServer
 - :SYSTem:COMMunicate:LAN[:SELF]:IP:GATeway
 - :SYSTem:COMMunicate:LAN[:SELF]:IP:SUBMask
 - :SYSTem:COMMunicate:LAN[:SELF]:MANuip:STATe
 - :SYSTem:COMMunicate:LAN[:SELF]:MDNS:STATe
 - :SYSTem:COMMunicate:LAN[:SELF]:RESet
 - :SYSTem:CONFigure:INFormation?
 - :SYSTem:DATE
 - :SYSTem:FSWitch[:STATe]
 - :SYSTem:LANGuage
 - :SYSTem:LKEY
 - :SYSTem:OPTion:STATe?
 - :SYSTem:PON:TYPE
 - :SYSTem:PRESet
 - :SYSTem:PRESet:SAVE
 - :SYSTem:PRESet:TYPE
 - :SYSTem:PRESet:USER:SAVE
 - :SYSTem:SCPI:DISPlay
 - :SYSTem:SHOW
 - :SYSTem:TIME
 
 - :TRACe Commands
 - :TRIGger Commands
- :TRIGger[:SEQuence]:ATRigger
 - :TRIGger[:SEQuence]:ATRigger:STATe
 - :TRIGger[:SEQuence]:EXTernal
:DELay  - :TRIGger[:SEQuence]:EXTernal
:DELay:STATe  - :TRIGger[:SEQuence]:EXTernal
:SLOPe  - :TRIGger[:SEQuence]:FMT:APTRigger
 - :TRIGger[:SEQuence]:FMT:CRITeria
 - :TRIGger[:SEQuence]:FMT:DELay
 - :TRIGger[:SEQuence]:FMT:DELay:STATe
 - :TRIGger[:SEQuence]:FMT:MASK
 - :TRIGger[:SEQuence]:FMT:MASK:EDIT
 - :TRIGger[:SEQuence]:FMT:MASK:RELative:AMPLitude
 - :TRIGger[:SEQuence]:FMT:MASK:RELative:FREQuency
 - :TRIGger[:SEQuence]:FMT:MASK
:BUILd  - :TRIGger[:SEQuence]:FMT:MASK
:DATA  - :TRIGger[:SEQuence]:FMT:MASK
:DELete  - :TRIGger[:SEQuence]:FMT:MASK
:NEW  - :TRIGger[:SEQuence]:HOLDoff
 - :TRIGger[:SEQuence]:HOLDoff:STATe
 - :TRIGger[:SEQuence]:SOURce
 - :TRIGger[:SEQuence]:VIDeo:DELay
 - :TRIGger[:SEQuence]:VIDeo:DELay:STATe
 - :TRIGger[:SEQuence]:VIDeo:LEVel
 - :TRIGger[:SEQuence]:VIDeo:SLOPe
 - :TRIGger2:MODE
 
 - :UNIT Command
 
 - :CALCulate Commands
 - Programming Examples
 - Appendix
 

RIGOL  Chapter 2 Command System 
2-104  RSA5000 Programming Guide 
:READ:HARMonics:AMPLitude? <n> 
Syntax
:READ:HARMonics:AMPLitude? <n> 
Description
Executes one harmonic distortion measurement and returns the amplitude of the specified harmonic. 
Parameter
Name 
Type 
Range 
Default 
<n> 
Integer 
1 to 10 
—— 
Remarks
The amplitude unit of the return value is consistent with the current Y-axis unit. 
The query returns --- when the harmonic read does not have data. 
This command will select data from the latest measurement results, and then transmit the data to the 
output buffer. 
This command is only available for GPSA mode. 
Return Format
The query returns the amplitude of the specified harmonic in scientific notation. 
For example, -1.692102000e+01 
:READ:HARMonics[:DISTortion]? 
Syntax
:READ:HARMonics[:DISTortion]? 
Description
Executes one harmonic distortion measurement and returns the percentage of the total harmonic 
distortion. 
Remarks
This command will select data from the latest measurement results, and then transmit the data to the 
output buffer. 
This command is only available for GPSA mode. 
Return Format
Queries the percentage of the total harmonic distortion in scientific notation. For example, 
2.490393000e+02 










