advertisement
:CALCulate Commands
:CALCulate:MODE
Syntax
:CALCulate:MODE <mod>
:CALCulate:MODE?
Description
Set or query the math operation type.
Parameter
Name Type Range
<mod> Discrete {ADD|SUB|MULTiply|DIVision|FFT|LOGic|ADVanced|OFF}
Return Format
The query returns ADD, SUB, MULT, DIV, FFT, LOG, ADV or OFF.
RIGOL
Default
OFF
MSO2000A/DS2000A Programming Guide 2-47
RIGOL
:CALCulate:ADD
:CALCulate:ADD:SA
:CALCulate:ADD:SB
Syntax
:CALCulate:ADD:SA <source>
:CALCulate:ADD:SA?
:CALCulate:ADD:SB <source>
:CALCulate:ADD:SB?
Description
Set or query the channel source of signal source A or B of the addition operation.
Parameter
Name Type
<source> Discrete
Range
{CHANnel1|CHANnel2}
Default
CHANnel1
Return Format
The query returns CHAN1 or CHAN2.
:CALCulate:ADD:INVert
Syntax
:CALCulate:ADD:INVert <bool>
:CALCulate:ADD:INVert?
Description
Enable or disable the inverted display of the addition operation result; or query the current status of the inverted display of the addition operation result.
Parameter
Name
<bool>
Type
Bool
Return Format
The query returns 1 or 0.
Range
{{1|ON}|{0|OFF}}
Default
0|OFF
2-48 MSO2000A/DS2000A Programming Guide
RIGOL
:CALCulate:ADD:VSCale
Syntax
:CALCulate:ADD:VSCale <scale>
:CALCulate:ADD:VSCale?
Description
Set or query the vertical scale of the addition operation result. The unit is related to the amplitude unit of the signal source channel.
Parameter
Name Type Default
<scale> Real
Range
The default range is from 0.02 to 500.
The actual range is related to the vertical scale of the signal source channel.
2V
Note: For the channel vertical scale, refer to the :CHANnel<n>:SCALe command.
Return Format
The query returns the vertical scale of the addition operation result in scientific notation.
:CALCulate:ADD:VOFFset
Syntax
:CALCulate:ADD:VOFFset <offs>
:CALCulate:ADD:VOFFset?
Description
Set or query the vertical offset of the addition operation result. The unit is related to the amplitude unit of the signal source channel.
Parameter
Name Type
<offs> Real
Range
-40×VScale to 40×VScale
Default
0
Note: For the VScale (the vertical scale of MATH), refer to the :CALCulate:ADD:VSCale command.
Return Format
The query returns the vertical offset of the addition operation result in scientific notation.
MSO2000A/DS2000A Programming Guide 2-49
RIGOL
:CALCulate:SUB
:CALCulate:SUB:SA
:CALCulate:SUB:SB
Syntax
:CALCulate:SUB:SA <source>
:CALCulate:SUB:SA?
:CALCulate:SUB:SB <source>
:CALCulate:SUB:SB?
Description
Set or query the channel source of signal source A or B of the subtraction operation.
Parameter
Name Type
<source> Discrete
Range
{CHANnel1|CHANnel2}
Default
CHANnel1
Return Format
The query returns CHAN1 or CHAN2.
:CALCulate:SUB:INVert
Syntax
:CALCulate:SUB:INVert <bool>
:CALCulate:SUB:INVert?
Description
Enable or disable the inverted display of the subtraction operation result; or query the current status of the inverted display of the subtraction operation result.
Parameter
Name
<bool>
Type
Bool
Return Format
The query returns 1 or 0.
Range
{{1|ON}|{0|OFF}}
Default
0|OFF
2-50 MSO2000A/DS2000A Programming Guide
RIGOL
:CALCulate:SUB:VSCale
Syntax
:CALCulate:SUB:VSCale <scale>
:CALCulate:SUB:VSCale?
Description
Set or query the vertical scale of the subtraction operation result. The unit is related to the amplitude unit of the signal source channel.
Parameter
Name Type Default
<scale> Real
Range
The default range is from 1p to 200.
The actual range is related to the vertical scale of the signal source channel.
2V
Note: For the channel vertical scale, refer to the :CHANnel<n>:SCALe command.
Return Format
The query returns the vertical scale of the subtraction operation result in scientific notation.
:CALCulate:SUB:VOFFset
Syntax
:CALCulate:SUB:VOFFset <offs>
:CALCulate:SUB:VOFFset?
Description
Set or query the vertical offset of the subtraction operation result. The unit is related to the amplitude unit of the signal source channel.
Parameter
Name Type
<offs> Real
Range
-40×VScale to 40×VScale
Default
0
Note: For the VScale (the vertical scale of MATH), refer to the :CALCulate:SUB:VSCale command.
Return Format
The query returns the vertical offset of the subtraction operation result in scientific notation.
MSO2000A/DS2000A Programming Guide 2-51
RIGOL
:CALCulate:MULTiply
:CALCulate:MULTiply:SA
:CALCulate:MULTiply:SB
Syntax
:CALCulate:MULTiply:SA <source>
:CALCulate:MULTiply:SA?
:CALCulate:MULTiply:SB <source>
:CALCulate:MULTiply:SB?
Description
Set or query the channel source of signal source A or B of the multiplication operation.
Parameter
Name Type Range Default
<source> Discrete {CHANnel1|CHANnel2}
Return Format
The query returns CHAN1 or CHAN2.
:CALCulate:MULTiply:INVert
Syntax
:CALCulate:MULTiply:INVert <bool>
CHANnel1
:CALCulate:MULTiply:INVert?
Description
Enable or disable the inverted display of the multiplication operation result; or query the current status of the inverted display of the multiplication operation result.
Parameter
Name
<bool>
Type
Bool
Return Format
The query returns 1 or 0.
Range
{{1|ON}|{0|OFF}}
Default
0|OFF
2-52 MSO2000A/DS2000A Programming Guide
:CALCulate:MULTiply:VSCale
Syntax
:CALCulate:MULTiply:VSCale <scale>
:CALCulate:MULTiply:VSCale?
Description
Set or query the vertical scale of the multiplication operation result.
Parameter
Name Type
<scale> Real
Range
The default range is from 50nU to 10MU.
The actual range is related to the vertical scale of the signal source channel.
Default
2U
Note: For the channel vertical scale, refer to the :CHANnel<n>:SCALe command.
Return Format
The query returns the vertical scale of the multiplication operation result in scientific notation.
:CALCulate:MULTiply:VOFFset
Syntax
:CALCulate:MULTiply:VOFFset <offs>
:CALCulate:MULTiply:VOFFset?
Description
Set or query the vertical offset of the multiplication operation result.
Parameter
Name Type
<offs> Real
Range
-40×VScale to 40×VScale
Default
0
Note: For the VScale (the vertical scale of MATH), refer to the
:CALCulate:MULTiply:VSCale command.
Return Format
The query returns the vertical offset of the multiplication operation result in scientific notation.
RIGOL
MSO2000A/DS2000A Programming Guide 2-53
RIGOL
:CALCulate:DIVision
:CALCulate:DIVision:SA
:CALCulate:DIVision:SB
Syntax
:CALCulate:DIVision:SA <source>
:CALCulate:DIVision:SA?
:CALCulate:DIVision:SB <source>
:CALCulate:DIVision:SB?
Description
Set or query the channel source of signal source A or B of the division operation.
Parameter
Name Type
<source> Discrete
Range
{CHANnel1|CHANnel2}
Default
CHANnel1
Return Format
The query returns CHAN1 or CHAN2.
:CALCulate:DIVision:INVert
Syntax
:CALCulate:DIVision:INVert <bool>
:CALCulate:DIVision:INVert?
Description
Enable or disable the inverted display of the division operation result; or query the current status of the inverted display of the division operation result.
Parameter
Name
<bool>
Type
Bool
Return Format
The query returns 1 or 0.
Range
{{1|ON}|{0|OFF}}
Default
0|OFF
2-54 MSO2000A/DS2000A Programming Guide
:CALCulate:DIVision:VSCale
Syntax
:CALCulate:DIVision:VSCale <scale>
:CALCulate:DIVision:VSCale?
Description
Set or query the vertical scale of the division operation result.
Parameter
Name Type
<scale> Real
Range
The default range is from 50nU to 50MU.
The actual range is related to the vertical scale of the signal source channel.
Note: For the channel vertical scale, refer to the :CHANnel<n>:SCALe command.
Default
2U
Return Format
The query returns the vertical scale of the division operation result in scientific notation.
:CALCulate:DIVision:VOFFset
Syntax
:CALCulate:DIVision:VOFFset <offs>
:CALCulate:DIVision:VOFFset?
Description
Set or query the vertical offset of the division operation result.
Parameter
Name Type
<offs> Real
Range
-40×VScale to 40×VScale
Default
0
Note: For the VScale (the vertical scale of MATH), refer to the
:CALCulate:DIVision:VSCale command.
Return Format
The query returns the vertical offset of the division operation result in scientific notation.
RIGOL
MSO2000A/DS2000A Programming Guide 2-55
RIGOL
:CALCulate:FFT
:CALCulate:FFT:SOURce
Syntax
:CALCulate:FFT:SOURce <source>
:CALCulate:FFT:SOURce?
Description
Set or query the signal source of FFT operation.
Parameter
Name Type Range
<source> Discrete {CHANnel1|CHANnel2}
Return Format
The query returns CHAN1 or CHAN2.
Default
CHANnel1
2-56
MSO2000A/DS2000A Programming Guide
RIGOL
:CALCulate:FFT:WINDow
Syntax
:CALCulate:FFT:WINDow <window>
:CALCulate:FFT:WINDow?
Description
Set or query the window function of the FFT operation.
Parameter
Name
<window>
Type
Discrete
Range
{RECTangle|HANNing|HAMMing|BLACkman}
Explanation
The window function can effectively reduce the spectrum leakage effect.
Default
RECTangle
Different window function is suitable for measuring different waveform; therefore, please select the desired window function according to the waveform to be measured and its characteristics.
Return Format
The query returns RECT, HANN, HAMM or BLAC.
:CALCulate:FFT:SPLit
Syntax
:CALCulate:FFT:SPLit <bool>
:CALCulate:FFT:SPLit?
Description
Enable or disable the split display of the FFT operation; or query the current status of the split display of the FFT operation.
Parameter
Name
<bool>
Explanation
Type
Bool
Range
{{1|ON}|{0|OFF}}
Default
1|ON
ON: the signal source channel waveform and the FFT operation results are displayed separately. The time domain and frequency domain signals are displayed clearly.
OFF (Full Screen): the signal source channel waveform and the FFT operation results are displayed in the same window to view the frequency spectrum more clearly and to perform more precise measurement.
Return Format
The query returns 1 or 0.
MSO2000A/DS2000A Programming Guide 2-57
RIGOL
:CALCulate:FFT:VSMode
Syntax
:CALCulate:FFT:VSMode <vmode>
:CALCulate:FFT:VSMode?
Description
Set or query the vertical scale type of the FFT operation result.
Parameter
Name Type Range
<vmode> Discrete {VRMS|DB}
Default
DB
Return Format
The query returns VRMS or DB.
:CALCulate:FFT:VSCale
Syntax
:CALCulate:FFT:VSCale <vscale>
:CALCulate:FFT:VSCale?
Description
Set or query the vertical scale of the FFT operation result. The unit is related to the current vertical scale type of FFT operation and the amplitude unit of the signal source channel.
Parameter
Name Type Range Default
<vscale> Real
Related to the current vertical scale type of FFT operation: dB: 1 to 100
Vrms: the default range is from 0.01 to 200. The actual range is related to the vertical scale of the signal source channel.
20dB/div
<vscale> will be changed only after the MATH channel is re-activated.
Return Format
The query returns the vertical scale of the FFT operation result in scientific notation.
2-58 MSO2000A/DS2000A Programming Guide
RIGOL
:CALCulate:FFT:VOFFset
Syntax
:CALCulate:FFT:VOFFset <offs>
:CALCulate:FFT:VOFFset?
Description
Set or query the vertical offset of the FFT operation result. The unit is related to the current vertical scale type of FFT operation and the amplitude unit of the signal source channel.
Parameter
Name Type
<offs> Real
Range
-40×VScale to 40×VScale
Default
60dBV
Note: For the VScale (the vertical scale of MATH), refer to the :CALCulate:FFT:VSCale command.
Return Format
The query returns the vertical offset of the FFT operation result in scientifc notation.
MSO2000A/DS2000A Programming Guide 2-59
RIGOL
:CALCulate:FFT:HSCale
Syntax
:CALCulate:FFT:HSCale <hscale>
:CALCulate:FFT:HSCale?
Description
Set or query the horizontal coefficient of FFT operation. This command indirectly sets the horizontal scale of FFT operation.
Parameter
Name Type Range
<hscale> Discrete {1|2|3|4}
Default
2
Explanation
The FFT horizontal coefficient represents the relationship between the FFT horizontal scale (Hspan) and the current FFT sample rate of the screen (Sa).
1: Hspan=Sa/20
2: Hspan=Sa/40
3: Hspan=Sa/100
4: Hspan=Sa/200
The current FFT sample rate of the screen=the number of pixels per grid horizontally/the horizontal timebase. The number of pixels per grid horizontally is related to the on/off status of the aunti-aliasing function; it is 50 when the anti-aliasing function is disabled and 100 when the
anti-aliasing function is enabled. For the horizontal timebase, refer to the :TIMebase[:MAIN]:SCALe
command.
Return Format
The query returns 1, 2, 3 or 4.
2-60 MSO2000A/DS2000A Programming Guide
RIGOL
:CALCulate:FFT:HOFFset
Syntax
:CALCulate:FFT:HOFFset <offs>
:CALCulate:FFT:HOFFset?
Description
Set or query the horizontal offset of the FFT operation result. The unit is Hz.
Parameter
Name Type
<offs> Real
Range
Refer to the Explanation
Default
0
Explanation
The range of <offs> is related to the on/off status of the anti-aliasing function, the current FFT sample rate of the screen (Sa) and the current FFT horizontal scale (Hspan).
When the anti-aliasing function is disabled: max{-0.5*Sa, -14*Hspan} to 0.5*Sa
When the anti-aliasing function is enabled: max{-0.4*Sa, -14*Hspan} to 0.4*Sa
Note: max{A, B} means using the larger one of A and B.
The current FFT sample rate of the screen=the number of pixels per grid horizontally/the horizontal timebase. The number of pixels per grid horizontally is related to the on/off status of the FFT anti-aliasing function; it is 50 when the ainti-aliasing function is disabled and 100 when the
anti-aliasing function is enabled. For the horizontal timebase, refer to the :TIMebase[:MAIN]:SCALe
command.
The FFT horizontal scale is related to the current FFT sample rate of the screen and the FFT
horizontal coefficient. Please refer to the :CALCulate:FFT:HSPan command.
Return Format
The query returns the horizontal offset of the FFT operation result in scientific notation.
MSO2000A/DS2000A Programming Guide 2-61
RIGOL
:CALCulate:FFT:HSPan
Syntax
:CALCulate:FFT:HSPan <span>
:CALCulate:FFT:HSPan?
Description
Set or query the horizontal scale of the FFT operation result. The unit is Hz/div.
Parameter
Name Type Range
<span> Discrete Refer to the Explanation
Default
1.25MHz/div
Explanation
The FFT horizontal scale is related to the current FFT sample rate of the screen (Sa). It can be Sa/20,
Sa/40, Sa/100 and Sa/200.
The current FFT sample rate of the screen = the number of pixels per grid horizontally/the horizontal timebase. The number of pixels per grid horizontally is related to the on/off status of the FFT anti-aliasing function; it is 50 when the ainti-aliasing function is disabled and 100 when the
anti-aliasing function is enabled. For the horizontal timebase, refer to the :TIMebase[:MAIN]:SCALe
command.
You can set the horizontal scale of FFT operation indirectly by setting the FFT horizontal coefficient
( :CALCulate:FFT:HSCale ).
Return Format
The query returns the horizontal scale of the FFT operation result in scientific notation.
2-62 MSO2000A/DS2000A Programming Guide
RIGOL
:CALCulate:FFT:HCENter
Syntax
:CALCulate:FFT:HCENter <center>
:CALCulate:FFT:HCENter?
Description
Set or query the center frequency of the FFT operation result. The unit is Hz.
Parameter
Name Type Range
<center> Real
Horizontal offset of the operation result +7*the current horizontal scale
Default
8.75MHz
Note: For the horizontal offset, refer to the :CALCulate:FFT:HOFFset
command; for the horizontal scale, refer to
and :CALCulate:FFT:HSPan commands.
Return Format
The query returns the center frequency of the FFT operation result in scientific notation.
MSO2000A/DS2000A Programming Guide 2-63
RIGOL
:CALCulate:LOGic
:CALCulate:LOGic:SA
:CALCulate:LOGic:SB
Syntax
:CALCulate:LOGic:SA <source>
:CALCulate:LOGic:SA?
:CALCulate:LOGic:SB <source>
:CALCulate:LOGic:SB?
Description
Set or query the channel source of signal source A or B of the logic operation.
Parameter
Name Type
<source> Discrete
Range
{D0|D1|D2|D3|D4|D5|D6|D7|D8|D9|D10|
D11|D12|D13|D14|D15|CHANnel1|CHANnel2}
Default
CHANnel1
Explanation
If the current logic operation type is NOT, only use the :CALCulate:LOGic:SA command to specify the channel source of signal source A.
Return Format
The query returns D0, D1, D2, D3, D4, D5, D6, D7, D8, D9, D10, D11, D12, D13, D14, D15, CHAN1 or
CHAN2.
2-64 MSO2000A/DS2000A Programming Guide
RIGOL
:CALCulate:LOGic:INVert
Syntax
:CALCulate:LOGic:INVert <bool>
:CALCulate:LOGic:INVert?
Description
Enable or disable the inverted display of the logic operation result; or query the current status of the inverted display of the logic operation result.
Parameter
Name
<bool>
Type
Bool
Range
{{1|ON}|{0|OFF}}
Return Format
The query returns 1 or 0.
:CALCulate:LOGic:VSCale
Syntax
:CALCulate:LOGic:VSCale <scale>
:CALCulate:LOGic:VSCale?
Description
Set or query the vertical scale of the logic operation result.
Parameter
Name Type Range
Default
0|OFF
Default
<scale> Real 0.05U to 100U 1U
Return Format
The query returns the vertical scale of the logic operation result in scientific notation.
MSO2000A/DS2000A Programming Guide 2-65
RIGOL
:CALCulate:LOGic:VOFFset
Syntax
:CALCulate:LOGic:VOFFset <offs>
:CALCulate:LOGic:VOFFset?
Description
Set or query the vertical offset of the logic operation result.
Parameter
Name Type Range Default
<offs> Real -40×VScale to 40×VScale 0
Note: For the VScale (the vertical scale of MATH), refer to the
:CALCulate:LOGic:VSCale command.
Return Format
The query returns the vertical offset of the logic operation result in scientifc notation.
:CALCulate:LOGic:OPERator
Syntax
:CALCulate:LOGic:OPERator <oper>
:CALCulate:LOGic:OPERator?
Description
Set or query the operator of logic operation.
Parameter
Name Type Range Default
<oper> Discrete {AND|OR|NOT|XOR}
Return Format
The query returns AND, OR, NOT or XOR.
AND
2-66 MSO2000A/DS2000A Programming Guide
RIGOL
:CALCulate:LOGic:ATHReshold
:CALCulate:LOGic:BTHReshold
Syntax
:CALCulate:LOGic:ATHReshold <thre>
:CALCulate:LOGic:ATHReshold?
:CALCulate:LOGic:BTHReshold <thre>
:CALCulate:LOGic:BTHReshold?
Description
Set or query the threshold of signal source A or B of logic operation.
Parameter
Name Type Range
<thre> Real
Default
-4×VerticalScale-OFFSet to 4×VerticalScale-OFFSet 0
Note: For the VerticalScale, refer to the :CHANnel<n>:SCALe command. For the OFFSet, refer to
the :CHANnel<n>:OFFSet command.
Explanation
This command is only available when signal source A or B is CH1 or CH2.
If the current logic operation type is NOT, you only need to set the threshold of signal source A.
Return Format
The query returns the threshold of signal source A or B of logic operation in scientific notation.
MSO2000A/DS2000A Programming Guide 2-67
RIGOL
:CALCulate:ADVanced
:CALCulate:ADVanced:EXPRession
:CALCulate:ADVanced:EXPRession
Syntax
:CALCulate:ADVanced:EXPRession <expression>
:CALCulate:ADVanced:EXPRession?
Description
Set or query the expression of advanced operation.
Parameter
Name Type
<expression> ASCII string
Range
Refer to the Explanation
Default
CH1+CH2
Explanation
Input valid expressions using the characters as shown in the figure below.
Note: The length of the expression should be no greater than 64 bytes.
Return Format
The query returns the current expression in string.
2-68 MSO2000A/DS2000A Programming Guide
RIGOL
:CALCulate:ADVanced:INVert
Syntax
:CALCulate:ADVanced:INVert <bool>
:CALCulate:ADVanced:INVert?
Description
Enable or disable the inverted display of the advanced operation result; or query the current status of the inverted display of the advanced operation result.
Parameter
Name
<bool>
Type
Bool
Range
{{1|ON}|{0|OFF}}
Default
0|OFF
Return Format
The query returns 1 or 0.
:CALCulate:ADVanced:VARiable1
:CALCulate:ADVanced:VARiable2
Syntax
:CALCulate:ADVanced:VARiable1 <numeric_value>
:CALCulate:ADVanced:VARiable1?
:CALCulate:ADVanced:VARiable2 <numeric_value>
:CALCulate:ADVanced:VARiable2?
Description
Set or query the variable1 or variable2 in the advanced operation expression.
Parameter
Name Type
<numeric_value> Real
Explanation
Range
Refer to the Explanation
Default
0
The format of <numeric_value> is AeB. The range of A (mantissa) is from -9.9999 to 9.9999 (the minimum step is 0.0001; namely the number can contain at most 4 decimal places). B (exponent, its base is 10) is an integer from -9 to 9. For example, 1.2037e5 denotes setting the viariable to
1.2037×10 5 . <numeric_value> can also be expressed in decimal format; its range corresponds to that in AeB format.
This command sets the value of variable1 or variable2 which might be used in
the :CALCulate:ADVanced:EXPRession command.
Return Format
The query returns the value of variable1 or variable2 in the advanced operation expression in scientific notation.
MSO2000A/DS2000A Programming Guide 2-69
RIGOL
:CALCulate:ADVanced:VSCale
Syntax
:CALCulate:ADVanced:VSCale <numeric_value>
:CALCulate:ADVanced:VSCale?
Description
Set or query the vertical scale of the advanced operation result. The unit is related to the advanced operation expression.
Parameter
Default Name Type Range
<numeric_value> Real
The default range is from 0.02 to 500.
The actual range is related to the advanced operation expression.
2V
Note: For the advanced operation expression, refer to the :CALCulate:ADVanced:EXPRession
command. The expression might include CH1 or CH2; at this point, the actual range of <numeric_value> ia also related to the
channel vertical scale. For the channel vertical scale, refer to the :CHANnel<n>:SCALe command.
Return Format
The query returns the vertical scale of the advanced operation result in scientific notation.
:CALCulate:ADVanced:VOFFset
Syntax
:CALCulate:ADVanced:VOFFset <offs>
:CALCulate:ADVanced:VOFFset?
Description
Set or query the vertical offset of the advanced operation result. The unit is related to the advanced operation expression.
Parameter
Name Type Range Default
<offs> Real -40×VScale to 40×VScale 0
Note: For the VScale (the vertical scale of MATH), refer to the
:CALCulate:ADVanced:VSCale command.
Return Format
The query returns the vertical offset of the advanced operation result in scientific notation.
2-70 MSO2000A/DS2000A Programming Guide
advertisement
Related manuals
advertisement