CALCulate:SA:MARKer commands

Controls the marker settings used in the SA application.

CALCulate:SA:MARKer:

BNOise

       | DATA?

       | SPAN

       | [:STATe]

BPOWer

       | DATA?

       | SPAN

       | [:STATe]

OCCBand

        | CENTer?

        | PERCent

        | POWer?

        | SPAN?

        | [:STATe]

 

Click on a keyword to view the command details.

See Also

Critical Note: CALCulate commands act on the selected measurement. You can select one measurement for each channel using Calc:Par:MNUM or Calc:Par:Select. Learn more.

If you use Calc:Par:Cat? to return the list of current measurements, the returned string will be similar to ‘CH1_B_1,B’.

To select this measurement as a parameter for SA, you need to send Calc:Par:Sel ‘CH1_B_1’.

Moreover, most of the following commands will return ‘+202, “Parameter not valid” if they are called with marker number n, and marker number n is not currently turned ON.

Important: Learn about programming the reference marker.

 

Note: For all band power marker family (this includes BNOise, BPOWer, OCCBand markers) and when measuring wideband repetitive modulated signals, there is basically 2 approaches to get good measurements:

- Either run the coherent mode of SA if the modulated test signal repetition period or tone spacing is known and a frequency reference connection is made between the signal source and the PNA (usually the 10 MHz ref signal BNC). See SA Setup Coherence.

- Or make use of a RBW that is equal or smaller than 1/20 of the modulated test signal tone spacing (rule of thumb). The test signal tone spacing is 1/ the test signal duration. For example, if the ARB file that generates the test signal replays each 100 microseconds, it means the tone spacing is 10 kHz. So, we recommend to set the RBW to 500 Hz or below.


CALCulate<ch>:SA:MARKer<n>:BNOise:DATA?

(Read-only) Returns the band noise level in dBm/Hz from the band noise marker.

See Critical Note

Parameters

 

<ch>

Channel number of the measurement. There must be a selected measurement on that SA channel. If unspecified, <ch> is set to 1.

<n>

Band noise marker number. If unspecified, <n> is set to 1.

Examples

CALC:SA:MARK:BNO:DATA?

calculate2:sa:marker2:bnoise:data?

Default

Not applicable


CALCulate<ch>:SA:MARKer<n>:BNOise:SPAN <num>

(Read-Write) Sets and reads the frequency span of  the band noise marker. This area is marked by two vertical dotted lines on the screen and the marker's y-axis value is set to the measured power value. Noise and power on the same marker share the same span.

See Critical Note

Parameters

 

<ch>

Channel number of the measurement. There must be a selected measurement on that channel. If unspecified, <ch> is set to 1.

<n>

Marker number. If unspecified, <n> is set to 1.

<num>

Choose a frequency span within the frequency range of the analyzer.

Examples

CALC:SA:MARK:BNO:SPAN 1e6

Query Syntax

CALCulate<ch>:SA:MARKer<n>:BNOise:SPAN?

Return Type

Numeric

Default

1 MHz


CALCulate<ch>:SA:MARKer<n>:BNOise[:STATe] <bool>

(Read-Write) Sets and reads the state of the band noise marker. This command makes a band noise marker from a generic marker. The generic marker must first be created using: CALC:MARK:STATe

See Critical Note

Parameters

 

<ch>

Channel number of the measurement. There must be a selected measurement on that channel. If unspecified, <ch> is set to 1.

<n>

Marker number. If unspecified, <n> is set to 1.

<bool>

Choose from:

0 - OFF - Turn band noise marker OFF.

1 - ON - Turn band noise marker ON.

Examples

'Select the measurement

CALC2:PAR:SEL "M2SA_CH2_A"

'Create marker3 on that measurement

CALC2:MARK3 ON

'Make it a band noise marker

CALC:SA:MARK:BNO:STAT 1

Query Syntax

CALCulate<ch>:SA:MARKer<n>:BNOise?

Return Type

Boolean

Default

0


CALCulate<ch>:SA:MARKer<n>:BPOWer:DATA?

(Read-only) Returns the band power level from the band power marker.

See Critical Note

Parameters

 

<ch>

Channel number of the measurement. There must be a selected measurement on that SA channel. If unspecified, <ch> is set to 1.

<n>

Band power marker number. If unspecified, <n> is set to 1.

Examples

CALC:SA:MARK:BPOW:DATA?

calculate2:sa:marker2:bpower:data?

Default

Not applicable


CALCulate<ch>:SA:MARKer<n>:BPOWer:SPAN <num>

(Read-Write) Sets and reads the frequency span of  the band power marker. This area is marked by two vertical dotted lines on the screen and the marker's y-axis value is set to the measured power value. Noise and power on the same marker share the same span.

See Critical Note

Parameters

 

<ch>

Channel number of the measurement. There must be a selected measurement on that channel. If unspecified, <ch> is set to 1.

<n>

Marker number. If unspecified, <n> is set to 1.

<num>

Choose a frequency span within the frequency range of the analyzer.

Examples

CALC:SA:MARK:BPOW:SPAN 1e6

Query Syntax

CALCulate<ch>:SA:MARKer<n>:BPOWer:SPAN?

Return Type

Numeric

Default

1 MHz


CALCulate<ch>:SA:MARKer<n>:BPOWer[:STATe] <bool>

(Read-Write) Sets and reads the state of the band power marker. This command makes a band power marker from a generic marker. The generic marker must first be created using: CALC:MARK:STATe

See Critical Note

Parameters

 

<ch>

Channel number of the measurement. There must be a selected measurement on that channel. If unspecified, <ch> is set to 1.

<n>

Marker number. If unspecified, <n> is set to 1.

<bool>

Choose from:

0 - OFF - Turn band power marker OFF.

1 - ON - Turn band power marker ON.

Examples

'Select the measurement

CALC2:PAR:SEL "M2SA_CH2_A"

'Create marker3 on that measurement

CALC2:MARK3 ON

'Make it a band power marker

CALC:SA:MARK:BPOW:STAT 1

Query Syntax

CALCulate<ch>:SA:MARKer<n>:BPOWer?

Return Type

Boolean

Default

0


CALCulate<ch>:SA:MARKer<n>:OCCBand:CENTer?

(Read-only) Returns the occupied bandwidth center frequency.

See Critical Note

Parameters

 

<ch>

Channel number of the measurement. There must be a selected measurement on that SA channel. If unspecified, <ch> is set to 1.

<n>

Marker number. If unspecified, <n> is set to 1.

Examples

CALC:SA:MARK:OCCB:CENT?

calculate2:sa:marker2:occband:center?

Default

Not applicable


CALCulate<ch>:SA:MARKer<n>:OCCBand:PERCent <num>

(Read-Write) Sets and returns the percentage of the band power to search for.

See Critical Note

Parameters

 

<ch>

Channel number of the measurement. There must be a selected measurement on that channel. If unspecified, <ch> is set to 1.

<n>

Marker number.

<num>

Percentage value. If unspecified, <n> is set to 1.

Examples

CALC:SA:MARK:OCCB:PERC 99

calculate2:sa:marker2:occband:percent 99

Query Syntax

CALCulate<ch>:SA:MARKer<n>:OCCBand:PERCent?

Return Type

Numeric

Default

99.0


CALCulate<ch>:SA:MARKer<n>:OCCBand:POWer?

(Read-only) Returns the occupied bandwidth power.

See Critical Note

Parameters

 

<ch>

Channel number of the measurement. There must be a selected measurement on that SA channel. If unspecified, <ch> is set to 1.

<n>

Marker number. If unspecified, <n> is set to 1.

Examples

CALC:SA:MARK:OCCB:POW?

calculate2:sa:marker2:occband:power?

Default

Not applicable


CALCulate<ch>:SA:MARKer<n>:OCCBand:SPAN?

(Read-only) Returns the occupied bandwidth span.

See Critical Note

Parameters

 

<ch>

Channel number of the measurement. There must be a selected measurement on that SA channel. If unspecified, <ch> is set to 1.

<n>

Marker number. If unspecified, <n> is set to 1.

Examples

CALC:SA:MARK:OCCB:SPAN?

calculate2:sa:marker2:occband:span?

Default

Not applicable


CALCulate<ch>:SA:MARKer<n>:OCCBand[:STATe] <bool>

(Read-Write) Sets and returns the occupied bandwidth on/off state.

See Critical Note

Parameters

 

<ch>

Channel number of the measurement. There must be a selected measurement on that channel. If unspecified, <ch> is set to 1.

<n>

Marker number. If unspecified, <n> is set to 1.

<bool>

Choose from:

0 - OFF - Turns occupied bandwidth OFF.

1 - ON - Turns occupied bandwidth ON.

Examples

CALC:SA:MARK:OCCB:STAT 1

calculate2:sa:marker2:occband:state 1

Query Syntax

CALCulate<ch>:SA:MARKer<n>:OCCBand[:STATe]?

Return Type

Boolean

Default

0

Note: If occupied band state is turned ON, then Band Power or Band Noise is turned OFF.