Manages several aspects of Cal Sets.
|
CSET: | CATalog? | COPY | DALL | DATE? | DELete | EXISts? | ETERm: | CATalog? | [:DATA] | X:VALues | FIXTure: | CASCade | DEEMbed | EMBed | ZERO | ITEM: | CATalog? | DATA? | TIME? |
Click on a keyword to view the command details.
Note: There is no user-interface equivalent for some of these commands.
See Also
|
Applicable Models: All This command replaces SENS:CORR:CSET:CAT? (Read-only) Returns the names of Cal Sets stored on the VNA. |
|
|
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 |
|
Not Applicable |
|
|
Applicable Models: All (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 |
|
Not Applicable |
|
|
Applicable Models: All (Write-only) Deletes ALL Cal Sets from the VNA, including phase reference and Global Delta Match Cal Sets. |
|
|
Parameters |
None |
|
Examples |
CSET:DALL |
|
Query Syntax |
Not Applicable |
|
Not Applicable |
|
|
Applicable Models: All (Read-only) Returns the (year, month, day) that the specified Cal Set was last saved. See Also |
|
|
Parameters |
|
|
<string> |
Cal Set name. |
|
Examples |
CSET:DATE? "CalSet_11" 'Returns: +2013,+5,+1 |
|
Return Type |
Comma-separated integers. |
|
Not Applicable |
|
|
Applicable Models: All This command replaces SENS:CORR:CSET:DELete (Write-only) Deletes the specified Cal Set from the VNA.
|
|
|
Parameters |
|
|
<string> |
Name of the Cal Set to delete. Not case-sensitive. |
|
Examples |
CSET:DEL "MyCalSet" |
|
Query Syntax |
Not Applicable |
|
Not Applicable |
|
|
Applicable Models: All (Read-only) Returns whether or not the specified Cal Set exists on the VNA. |
|
|
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. |
|
Not Applicable |
|
|
Applicable Models: All (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 |
|
Not Applicable |
|
|
Applicable Models: All (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 |
|
Query Syntax |
CSET:ETERm:DATA? <CSET Name>,<ETerm Name> |
|
Return Type |
Block data |
|
Not Applicable |
|
|
Applicable Models: All (Read-Write) Sets and returns the x-axis frequencies for the given Cal Set and error term name. This command requires that the error term already be in existence either from a calibration session or having been created with CSET:ETER:DATA. This command requires that the frequency array length match the existing size of the error term. For example, if the error term is 3 buckets long (3 complex numbers), then the frequency list must be 3 values long. |
|
|
Parameters |
|
|
<CSET Name> |
(String) Name of Cal Set to manipulate. |
|
<ETerm Name> |
(String) Name used to identify an error term in the Cal Set. |
|
<freqlist> |
(Block) X-axis frequencies associated with the error term. |
|
Examples |
'Query error term data from calset named "Calset1" 'If needed, change or upload the data for the "Directivity" error term (example of a three point eterm) 'Query what the frequency values are for the error term 'If needed, change the frequency values for the error term |
|
Query Syntax |
CSET:ETERm:X:VALues? <CSET Name>,<ETerm Name> |
|
Return Type |
Block data |
|
Not Applicable |
|
|
Applicable Models: All (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:
|
|
Examples |
CSET:FIXT:CASC "D:\a.s2p","D:\b.s2p","D:\c.s2p",LOG |
|
Query Syntax |
Not Applicable |
|
Not Applicable |
|
|
Applicable Models: All (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 VNA. The Cal Set must reside on the VNA. |
|
<cs2> |
(String) Name of an existing Cal Set 2 which describes the cal closest to the DUT. The Cal Set must reside on the VNA. |
|
<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:
|
|
[<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 |
|
Not Applicable |
|
|
Applicable Models: All (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 VNA. |
|
<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 |
|
Not Applicable |
|
|
Applicable Models: All (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 VNA. |
|
<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 |
|
Not Applicable |
|
|
Applicable Models: All (Write-only) Generate a new ENR file by embedding an adapter to an existing ENR file. |
|
|
Parameters |
|
|
<inEnr> |
(String) Path and filename of original ENR file. |
|
<s2p> |
(String) Path and filename of the S2P file which characterizes the adapter/fixture network. |
|
<outEnr> |
(String) Path and filename of new ENR file to output |
|
Examples |
CSET:FIXT:EMB "D:\Original.enr","D:\adapter.s2p","D:\new.enr" |
|
Query Syntax |
Not Applicable |
|
Not Applicable |
|
|
Applicable Models: All (Write-only) Creates a new S4P file. |
|
|
Parameters |
|
|
<original_s4p> |
(String) Path and filename of the original S4P file. |
|
<result_s4p> |
(String) Path and filename of the new S4P file. |
|
<sparameters> |
(String) Comma-separated terms to zero-out. |
|
<complexformat> |
(Character) Format. Choose from:
|
|
Examples |
CSET:FIXT:ZERO "D:\originalFile.s4p","D:\newFile.s4p","S11,S21,S33",LOG |
|
Query Syntax |
Not Applicable |
|
Not Applicable |
|
|
Applicable Models: All (Read-only) The Cal Set mainly contains error term data for measurement correction purposes. But Cal Sets can also contain auxiliary information used to describe how the Cal Set was constructed. This information is stored as name value pairs and can be accessed by the item name. The catalog query returns a list of item names contained in the specific Cal Set being queried. |
|
|
Parameters |
|
|
<calset> |
(String) Name of the Cal Set item. |
|
Examples |
CSET:ITEM:CAT? "mycalset" |
|
Return Type |
String |
|
Not Applicable |
|
|
Applicable Models: All (Read-Write) Returns the VNA Measurement Class or Channel that created the specific Cal Set item. About Cal Set ItemsA Cal Set item is a named value. You can list the named values using CSET:ITEM:CATalog? or SENS:CORR:CSET:ITEM:CATalog? You can query the value of a specific item by asking for its data: CSET:ITEM:DATA? For example, one of the items added by the VNA firmware to every Cal Set is named 'Created By'. The value attached to this item is the name of the VNA Measurement Class or Channel that created the Cal Set. When an SMC cal is performed, you can query the Cal Set for the 'Create By' item, and it will return 'Scalar Mixer/Converter'. The same query on an NFx channel returns 'Noise Figure Converters'.CSET:ITEM:DATA? "mycalset","Created By" |
|
|
Parameters |
|
|
<cnum> |
Any existing channel number. If unspecified, value is set to 1 |
|
<calset> |
(String) Name of the Cal Set item. |
|
<itemName> |
(String) VNA Measurement Class or Channel that created the Cal Set. |
|
Examples |
SENS:CORR:CSET:ITEM? "mycalset","Created By" |
|
Return Type |
String |
|
Not Applicable |
|
|
Applicable Models: All (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 VNA operating system. See Also |
|
|
Parameters |
|
|
<string> |
Cal Set name. |
|
Examples |
CSET:TIME? "CalSet_11" 'Returns: +13,+6,+1 |
|
Return Type |
Comma-separated integers. |
|
Not Applicable |
|