Remote Spectrum Monitor User Guide : SCPI SPA Commands : :DISPlay Subsystem
 
:DISPlay Subsystem
This subsystem provides commands that modify the display of data for the user. They do not modify the way in which data are returned to the controller.
:DISPlay:POINtcount <number>
:DISPlay:POINtcount?
Title
Display Point Count
Description
Changes the number of display points the instrument currently measures. Increasing the number of display points can improve the resolution of measurements but will also increase the sweep time.
Parameters
<number>
Default Value
501
Range
10 to 4001
 
:DISPlay[:WINDow]:SWEep[:CURRent]:POINt?
Title
Current Display Point
Description
This command returns the newest display point index of current sweep. This index can be used to calculate the current sweep progress.
Parameters
none
:DISPlay:WINDow:TRACe:Y[:SCALe]:PDIVision <numeric_value>
:DISPlay:WINDow:TRACe:Y[:SCALe]:PDIVision?
Title
Scale Per Division
Description
Set or query the scale per division setting of trace graph. This command doesn't change any behavior in the backend, but will be included in save/recall operations.
Parameters
<numeric_value>
Default Value
10
Range
1 to 15
:DISPlay[:WINDow]:TRACe:Y:SCALe:RLEVel <number>
:DISPlay[:WINDow]:TRACe:Y:SCALe:RLEVel?
Title
Reference Level
Description
Sets the reference level amplitude value for the y-axis. This value is the display reference level, which means it has the reference level offset applied. It also means that a change to the reference level offset will change this setting (though the actual, unadjusted reference level will stay the same).
Note that this may cause a change in attenuation if the automatic input attenuation coupling is enabled. For the purpose of coupling, the actual reference level (without the offset applied) is used, though this command will always reflect the display value.
For example, suppose a starting reference level offset of 0 dB and a reference level of 10 dBm. If the offset is set to 20 dB, the display reference level will be set to 10 dBm - 20 dB = -10 dBm; no attenuation change will occur. Likewise, if the starting reference level offset is 20 dB and the (display) reference level is set to 0 dBm, the display reference level will remain at 0 dBm, though the (actual) reference level value used in auto attenuation coupling is 0 dBm + 20 dB = 20 dBm.
To obtain the actual reference level, either add in the reference level offset, or temporarily set the offset to 0 (in which case the display reference level will reflect the actual one).
Parameters
<number>
Default Value
10 dBm
Default Unit
dBm
Range
–150 dBm to 30 dBm
:DISPlay[:WINDow]:TRACe:Y[:SCALe]:RLEVel:AUTO[:IMMediate] <numeric_value> {DB}
Title
Automatic Reference Level
Description
This command causes the reference level to immediately be set to an automatically computed value that best displays the particular data. The reference level is set to a specified dB above the selected trace max value. This command is semantically equivalent to :DISPlay[:WINDow]:TRACe[:SCALe]:RLEVel <amplitude> with the computed value for amplitude.
Parameters
<numeric_value> {DB}
:DISPlay[:WINDow]:TRACe:Y[:SCALe]:RLEVel:OFFSet <relative amplitude>
:DISPlay[:WINDow]:TRACe:Y[:SCALe]:RLEVel:OFFSet?
Title
Reference Level Offset
Description
Sets the reference level offset value for the y-axis. This offset is used for display purposes only, and does not affect the actual reference level used for auto attenuation coupling, or any other settings that depend on reference level.
See DISP:WIND:TRAC:Y:SCAL:RLEV for details on the interaction between reference level offset and display reference level.
Parameters
<relative amplitude>
Default Value
0 dB
Default Unit
dB
Range
-99.9 dB to 99.9 dB