Function SCPI

M9370A / M9371A / M9372A / M9374A / M9375A

Calculate:Function Commands


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.


CALCulate<cnum>:FUNCtion:DATA?

(Read-only) Returns the trace statistic data for the selected statistic type for the specified channel. Select the type of statistic with CALC:FUNC:TYPE.

See Critical Note

Parameters

 

<cnum>

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

Return Type

Depends on FORM:DATA

Example

CALCulate2:FUNCtion:DATA?

Default

Not applicable


CALCulate<cnum>:FUNCtion:DOMain:USER[:RANGe] <range>

(Read-Write) Sets the range used to calculate trace statistics. Each channel has 16 user ranges. The x-axis range is specified with the CALC:FUNC:DOM:USER:START and STOP commands.

See Critical Note

Parameters

 

<cnum>

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

<range>

Range number. Choose from: 0 to 16

0 is Full Span of the current x-axis range

1 to 16 are user-specified ranges

Examples

CALC:FUNC:DOM:USER 4
calculate2:function:domain:user:range 0

Query Syntax

CALCulate<cnum>:FUNCtion:DOMain:USER[:RANGe]?

Return Type

Numeric

Default

0 - Full Span


CALCulate<cnum>:FUNCtion:DOMain:USER:STARt <range>, <start>

(Read-Write) Sets the start of the specified user-domain range.

To apply this range, use CALC:FUNC:DOM:USER

To set the stop of the range, use CALC:FUNC:DOM:USER:STOP.

See Critical Note

Note: This command does the same as CALC:MARK:FUNC:DOM:USER:STAR

Parameters

 

<cnum>

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

<range>

Range number that will receive the start value. Choose an integer between 1 and 16

<start>

Start value of the specified range. Choose a real number between:
the analyzer's
Minimum and Maximum x-axis value.

Examples

CALC:FUNC:DOM:USER:STAR 1,1e9
calculate2:function:domain:user:start 2,2e9

Query Syntax

CALCulate<cnum>:FUNCtion:DOMain:USER:STARt? <range>

Return Type

Numeric

Default

The analyzer's Minimum x-axis value


CALCulate<cnum>:FUNCtion:DOMain:USER:STOP <range>, <stop>

(Read-Write) Sets the stop value of the specified user-domain range.

To apply this range, use CALC:FUNC:DOM:USER.

To set the start of the range, use CALC:FUNC:DOM:USER:START

See Critical Note

Note: This command does the same as CALC:MARK:FUNC:DOM:USER:STOP

Parameters

 

<cnum>

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

<range>

Range number that will receive the stop value. Choose an integer between 1 and 16

<stop>

Stop value of the specified range. Choose a real number between:
the analyzer's
Minimum and Maximum x-axis value.

Examples

CALC:FUNC:DOM:USER:STOP 4,5e9
calculate2:function:domain:user:stop 3,8e9

Query Syntax

CALCulate<cnum>:FUNCtion:DOMain:USER:STOP? <range>

Return Type

Numeric

Default

The analyzer's Maximum x-axis value


CALCulate<cnum>:FUNCtion:EXECute

(Write-only) For the active trace of specified channel, executes the statistical analysis specified by the CALC:FUNC:TYPE command.

See Critical Note

Parameters

 

<cnum>

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

Examples

CALC:FUNC:EXEC
calculate2:function:execute

Query Syntax

Not Applicable

Default

Not Applicable


CALCulate<cnum>:FUNCtion:STATistics[:STATe] <ON|OFF>

(Read-Write) Displays and hides the trace statistics (peak-to-peak, mean, standard deviation) on the screen.

The analyzer will display either measurement statistics or Filter Bandwidth statistics; not both.

See Critical Note

Parameters

 

<cnum>

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

<ON|OFF>

ON - Displays trace statistics

OFF - Hides trace statistics

Examples

CALC:FUNC:STAT ON
calculate2:function:statistics:state off

Query Syntax

CALCulate<cnum>:FUNCtion:STATistics[:STATe]?

Return Type

Boolean (1 = ON, 0 = OFF)

Default

OFF (0)


CALCulate<cnum>:FUNCtion:TYPE <char>

(Read-Write) Sets statistic TYPE that you can then query using CALC:FUNCtion:DATA?.

Note: In PNA releases 4.2 and prior, this command applied the statistic type to all measurements. Now, this command affects only the selected measurement on the specified channel.

See Critical Note

Parameters

 

<cnum>

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

<char>

Choose from:

PTPeak - the difference between the max and min data points on the trace.

STDEV - standard deviation of all data points on the trace

MEAN - mean (average) of all data points on the trace

MIN - lowest data point on the trace

MAX - highest data point on the trace

Examples

CALC:FUNC:TYPE PTP
calculate2:function:type stdev

Query Syntax

CALCulate<cnum>:FUNCtion:TYPE?

Return Type

Character

Default

PTPeak