CSET

M9370A / M9371A / M9372A / M9374A / M9375A

CSET:Fixture Commands


Manages several aspects of Cal Sets.

CSET:

     | CATalog?

     | COPY

     | DALL

     | DATE?

     | DELete

     | EXISts?

     | ETERm:

          | CATalog?

          | [:DATA]

     | FIXTure:

          | CASCade

          | CHARacterize

          | DEEMbed

          | EMBed

     | TIME?

Click on a keyword to view the command details.

Note: There is no user-interface equivalent for some of these commands.

See Also


CSET:CATalog?

This command replaces SENS:CORR:CSET:CAT?

(Read-only) Returns the names of Cal Sets stored on the PNA.

Parameters

None

Examples

CSET:CAT?

Returns:

"CalSet_0913,CalSet_1,CalSet_2,CalSet_3,CalSet_4,CH1_CALREG,CH31_CALR

EG,MyCalAll_SMC_002,MyCalAll_STD_001"

Return Type

Comma-separated string of names

Default

Not Applicable


CSET:COPY <string>,<string>

(Write-only) Creates a new Cal Set and copies the current Cal Set data into it.  Use this command to manipulate data on a Cal Set without corrupting the original cal data.

Parameters

 

<string>,<string>

The first string is the name of the current Cal Set. The second string is the name of the new Cal Set copy.

Examples

CSET:COPY 'My2Port','My2PortCopy'

Query Syntax

Not Applicable

Default

Not Applicable


CSET:DALL

(Write-only) Deletes ALL Cal Sets from the PNA, including phase reference and Global Delta Match Cal Sets.

Parameters

None

Examples

CSET:DALL

Query Syntax

Not Applicable

Default

Not Applicable


CSET:DATE? <string>

(Read-only) Returns the (year, month, day) that the specified Cal Set was last saved.  

See Also

MMEM:DATE?

MMEM:TIME?

CSET:TIME?

Parameters

 

<string>

Cal Set name.

Examples

CSET:DATE? "CalSet_11"

'Returns:

+2013,+5,+1

Return Type

Comma-separated integers.

Default

Not Applicable


CSET:DEL <string>

This command replaces SENS:CORR:CSET:DELete

(Write-only) Deletes the specified Cal Set from the PNA.

  • If the Cal Set is currently being used by a channel, the Cal Set is deleted and correction for the channel is turned off.

  • If the Cal Set is not found, no error is returned.

Parameters

 

<string>

Name of the Cal Set to delete. Not case-sensitive.

Examples

CSET:DEL "MyCalSet"

Query Syntax

Not Applicable

Default

Not Applicable


CSET:EXISts? <string>

(Read-only) Returns whether or not the specified Cal Set exists on the PNA.

Parameters

 

<string>

Name or GUID of the Cal Set enclosed in quotes.

The GUID must also be enclosed in curly brackets.

Examples

dim check

check = CSET:EXISts? "MyCalSet"

check = CSET:EXISts? "{7C4EEA5E-40D2-4D70-A048-33BFFE704163}"

Return Type

Boolean

ON or 1 - Cal Set exists.

OFF or 0 - Cal Set does NOT exist.

Default

Not Applicable


CSET:ETERm:CATalog? <CSET Name>[,<errorTermFilter>]

(Read-only) Returns a list of error term names for the given Cal Set.

Parameters

 

<CSET Name>

(String) Name of Cal Set to query.

<errorTermFilter>

(Optional argument) CSET:ETER:CAT? <CSETName>, “<errorTermFilter>” will return only the error term names with the filter string in them. For example, if it is a full 2-port cal, then CSET:ETER:CAT? <CSETName>, “cross” would return all “Crosstalk(n,n)” error terms. (Note that the filter is not case sensitive.)

Entering CSET:ETER:CAT? <CSETName> "" or  CSET:ETER:CAT? <CSETName> will return all error terms for the given Cal Set.

Examples

CSET:ETER:CAT? "CalSet_1"

CSET:ETER:CAT? "CalSet_1", "trans"

Return Type

Variant

Default

Not Applicable


CSET:ETERm[:DATA] <CSET Name>,<ETerm Name>,<data>

(Read-Write) Sets and returns the error term data (real, imaginary pairs) for the given Cal Set and error term name.

Parameters

 

<CSET Name>

(String) Name of Cal Set to manipulate.

<ETerm Name>

(String)  Name used to identify an error term in the Cal Set.

<data>

(Block) Error term data - a real/imaginary data pair for each data point.

Examples

CSET:ETER "CalSet_1","Directivity(1,1)", 0.237,-1.422, 0.513, 0.895
CSET:ETER? "CalSet_1","Directivity(1,1)"  'read

Query Syntax

CSET:ETERm:DATA? <CSET Name>,<ETerm Name>

Return Type

Block data

Default

Not Applicable


CSET:FIXTure:CASCade <s2p1>,<s2p2>,<s2pResult>,<char>

(Write-only) Combines the losses and phase shift of two S2P files into a single S2P file.  Learn more.

Parameters

 

<s2p1>

(String)  Path and filename of one of the S2P files to be combined.

<s2p2>

(String)  Path and filename of the other S2P file to be combined.

<s2pResult>

(String) Path and filename of the combined S2P file.

<char>

(Character) Format. Choose from:

  • REIM - Real, imaginary data pairs

  • LOG - Log magnitude, phase

  • LINear - Linear magnitude, phase

Examples

CSET:FIXT:CASC "C:\Users\Public\Documents\Network Analyzer\CPM\a.s2p","C:\Users\Public\Documents\Network Analyzer\CPM\b.s2p","C:\Users\Public\Documents\Network Analyzer\CPM\c.s2p",LOG

Query Syntax

Not Applicable

Default

Not Applicable


CSET:FIXTure:CHARacterize <cs1>,<cs2>,<port>,<s2p>,<char>[,<pivot>]

(Write-only) Characterizes a fixture based on two Cal Sets. The stimulus settings of the two Cal Sets do NOT have to be identical, but they MUST have a common frequency range for interpolation. A new S2P file is created.  Learn more about Cal Plane Manager.

Parameters

 

<cs1>

(String)  Name of an existing Cal Set 1 which describes the cal closest to the PNA. The Cal Set must reside on the PNA.

<cs2>

(String)  Name of an existing Cal Set 2 which describes the cal closest to the DUT. The Cal Set must reside on the PNA.

<port>

(Numeric) Port number described in the Cal Sets.

<s2p>

(String) Name of the S2P file containing the adapter/fixture characterization.

<char>

(Character) Format. Choose from:

  • REIM - Real, imaginary data pairs

  • LOG - Log magnitude, phase

  • LINear - Linear magnitude, phase

[<pivot>]

(Numeric) Optional argument. Phase value for the specified port.

Examples

CSET:FIXT:CHAR "CalSet1","CalSet2",1,"Fixture.s2p"

cset:fixture:characterize "CalSet1","CalSet2",2,"Fixture.s2p",90

Query Syntax

Not Applicable

Default

Not Applicable


CSET:FIXTure:DEEMbed <cs1>,<cs2>,<s2p>,<port>, <compPwr>[,extrap]

(Write-only) De-embeds a fixture from an existing Cal Set based on an S2P file. A new Cal Set is created with the effects of the fixture removed.

When the new Cal Set is applied to a channel, the effects of fixturing are removed from the measurement data. Do NOT enable fixturing. The effects of the fixture are removed when the new Cal Set is selected and correction is turned ON.

Parameters

 

<cs1>

(String)  Name of an existing Cal Set which resides on the PNA.

<cs2>

(String)  Name of new Cal Set which contains updated error terms with fixture de-embedded.

<s2p>

(String) Name of the S2P file which characterizes the adapter/fixture.

<port>

(Numeric) Port number from which fixture will be de-embedded.

<compPwr>

(Boolean)

ON (1) - When the Cal Set contains a power correction array for the fixture port, that array will be compensated for the fixture loss.  

Warning: enabling power compensation can result in an increase in test port power and consequently, increased power to the DUT. Use with caution.

OFF (0) - Do not compensate for loss in source power through the fixture.

[extrap]

(Boolean) Optional argument.

ON (1) -Applies a simple extrapolation when the S2P file has a narrower frequency range than the Cal Set. The values for the first and last data points are extended in either direction to cover the frequency range of the Cal Set.

OFF (0) - Extrapolation is NOT performed (default setting).

Examples

CSET:FIXT:DEEM "MyCalSet","MyNewCalSet","Fixture.s2p",1,1

cset:fixture:deembed "MyCalSet","MyNewCalSet","Fixture.s2p",1,1,1 'extrapolation is performed if the s2p frequency range is narrower than that of the Cal Set.

Query Syntax

Not Applicable

Default

Not Applicable


CSET:FIXTure:EMBed <cs1>,<cs2>,<s2p>,<port>, <compPwr>[,extrap]

(Write-only) Embeds a fixture (usually a matching network) into an existing Cal Set based on an S2P file. A new Cal Set is created with the effects of the matching network included in the correction data.

When the new Cal Set is applied to a channel, the effects of the fixture are included in the measurement data. Do NOT enable  fixturing. The effects of the matching network are included when the new Cal Set is selected and correction is turned ON.

Parameters

 

<cs1>

(String)  Name of an existing Cal Set which resides on the PNA.

<cs2>

(String)  Name of new Cal Set which contains updated error terms with fixture embedded.

<s2p>

(String) Name of the S2P file which characterizes the fixture / matching network.

<port>

(Numeric) Port number to which fixture will be added.

<compPwr>

(Boolean)

ON (1) - Increase the source power to compensate for the loss through the fixture. The result is that the specified power level will be correct at the DUT input.

Warning: enabling power compensation can result in an increase in test port power and consequently, increased power to the DUT. Use with caution.

OFF (0) - Do not compensate for loss in source power through the matching network.

[extrap]

(Boolean) Optional argument.

ON (1) -Applies a simple extrapolation when the S2P file has a narrower frequency range than the Cal Set. The values for the first and last data points are extended in either direction to cover the frequency range of the Cal Set.

OFF (0) - Extrapolation is NOT performed (default setting).

Examples

CSET:FIXT:EMB "MyCalSet","MyNewCalSet","Fixture.s2p",1,1

cset:fixture:embed "MyCalSet","MyNewCalSet","Fixture.s2p",1,1,1 'extrapolation is performed if the s2p frequency range is narrower than that of the Cal Set.

Query Syntax

Not Applicable

Default

Not Applicable


CSET:TIME? <string>

(Read-only) Returns the (hour, minute, second) that the specified Cal Set was last saved. The time is returned in local time as setup in the PNA operating system.  

See Also

CSET:DATE?

MMEM:DATE?

MMEM:TIME?

Parameters

 

<string>

Cal Set name.

Examples

CSET:TIME? "CalSet_11"

'Returns:

+13,+6,+1

Return Type

Comma-separated integers.

Default

Not Applicable