Calculate:Equation Commands


Controls Equation Editor capabilities.

CALCulate:EQUation:

LIBRary

    | FUNCtions

    | IMPort?

    | REMove

STATe

TEXT

VALid?

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:EQUation:LIBRary:FUNCtions <string>

(Read-only)  Returns the functions in the specified DLL.

Parameters

 

<string>

Full path and filename of the *.dll to be read.

Examples

functions = CALC:EQU:LIBR:FUNC “C:/Program Files/Keysight/Network Analyzer/UserFunctions/Expansion.dll”

Query Syntax

CALCulate:EQUation:LIBRary:FUNCtions?

Return Type

Comma delimited string of function names.

Default

Not Applicable


CALCulate:EQUation:LIBRary:IMPort <string>

(Read-Write)  Imports the functions in the specified DLL and returns whether the functions have been imported into the PNA.

Parameters

 

<string>

Full path and filename of the *.dll.

Examples

'Command - Imports functions

CALC:EQU:LIBR:IMPort “C:\Program Files(x86)\Keysight\Network Analyzer\UserFunctions\Expansion.dll”  

'Query if Imported successfully

success = CALC:EQU:LIBR:IMPort? “C:\Program Files(x86)\Keysight\Network Analyzer\UserFunctions\Expansion.dll”

1   'Returns 1 if successfully imported

Query Syntax

CALCulate:EQUation:LIBRary:IMPort?

Returns the following:

1 - Imported

0 - NOT imported

Return Type

Boolean

Default

Not Applicable


CALCulate:EQUation:LIBRary:REMove <string>

(Write-only)  Removes an imported an Equation Editor DLL from the PNA.

Parameters

 

<string>

Full path and filename of the *.dll.

Examples

CALC:EQU:LIBR:REM “C:/Program Files/Keysight/Network Analyzer/UserFunctions/Expansion.dll”  

Query Syntax

Not Applicable

Default

Not Applicable


CALCulate<cnum>:EQUation[:STATe] <bool>

(Read-Write)  Turns ON and OFF the equation on selected measurement for the specified channel. If the equation is not valid, then processing is not performed. Use CALC:EQUation:VALid? to ensure that the equation is valid.

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.

<bool>

ON (or 1) - turns equation ON.

OFF (or 0) - turns equation OFF.

Examples

CALC:EQU 1

calculate2:equation:state 0

Query Syntax

CALCulate<cnum>:EQUation[:STATe]?

Return Type

Boolean

Default

OFF (0)


CALCulate<cnum>:EQUation:TEXT <string>

(Read-Write)  Specifies an equation or expression to be used on the selected measurement for 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.

<string>

Any valid equation or expression. See Equation Editor.

Examples

'Equation (includes '=')

CALC:EQU:TEXT "foo=S11/S21"

'Expression
calculate2:equation:text "S11/S21"

Query Syntax

CALCulate<cnum>:EQUation:TEXT?

Return Type

String

Default

Not Applicable


CALCulate<cnum>:EQUation:VALid?

(Read-Only)  Returns a boolean value to indicate if the current equation on the selected measurement for the specified channel is valid. For equation processing to occur, the equation must be valid and ON (CALC:EQU:STAT 1).

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:EQU:VAL?

calculate2:equation:valid?

Return Type

Boolean

1 - equation is valid

0 - equation is NOT valid

Default

Not Applicable


Last Modified:

30-Jan-2014

Several edits to cnums

10-Jan-2011

New topic