Sense:Correction:Collect:Guided Commands
Performs and applies a SmartCal (Guided) calibration and other error correction features.
Important Notes:
To perform a Guided Calibration, use ONLY Sens:Corr:Coll:Guided commands. See the "Guided" example programs for clarification.
ALWAYS send ALL measurement setup commands BEFORE initializing a remote calibration.
SENSe:CORRection:COLLect:GUIDed: ADAPter | COUNt | ZERO | CREate? | DELay | PATHs CKIT | CATalog? | PORT | CATalog? | [SELect] CONNector | CATalog? | PORT | [SELect] ETERms | COMPute ISOLation | AVERage | PATHs ITERations | COUNt? | MINimum? | RESet PATH | CMEThod | TMEThod PREFerence | CSET |
Click on a keyword to view the command details.
Blue keywords are superseded commands.
See Also
- ECal Orientation commands
Examples using these commands.
SENSe<ch>:CORRection:COLLect:GUIDed:ABORt
(Write-only) Aborts the acquiring of a guided calibration that has been INITialized but has not yet been concluded using the SAVE command. If at least one Cal standard has already been measured, and the Calibration Window is being displayed, this command also closes the Calibration Window and re-tiles the other measurement windows. |
|
Parameters |
|
<ch> |
Channel being calibrated, depending on the CHAN:MODE setting. If unspecified, value is set to 1. |
Examples |
SENS:CORR:COLL:GUID:ABOR |
Query Syntax |
Not Applicable |
Not Applicable |
SENSe:<ch>CORRection:COLLect:GUIDed[:ACQuire] STAN<n>[,sync]
(Write-only) Initiates the measurement of the specified calibration standard. Executing this command with an unnecessary standard has no affect. The measured data is stored and used for subsequent calculations of error correction coefficients. All standards must be measured before a calibration can be completed. Any measurement can be repeated until the SENS:CORR:COLL:GUID:SAVE command is executed. Query the user prompt description using SENS:CORR:COLL:GUID:DESC? Query the required calibration steps using SENS:CORR:COLL:GUID:STEP? |
|
Parameters |
|
<ch> |
Channel being calibrated, depending on the CHAN:MODE setting. If unspecified, value is set to 1. |
STAN<n> |
Choose from:STAN1, STAN2, etc. through STANn where n is the number of cal standard connection steps for the calibration. Note: You do not necessarily have to invoke these connection steps in sequential order, but you must issue this command for all of the steps to be able to complete the calibration. |
[sync] |
Optional argument. Choose from: SYNChronous - blocks SCPI commands during standard measurement (default behavior). ASYNchronous - does NOT block SCPI commands during standard measurement. |
Examples |
SENS:CORR:COLL:GUID
STAN1 |
Query Syntax |
Not Applicable |
Not Applicable |
SENSe<ch>:CORRection:COLLect:GUIDed:ADAPter:CREate? <conn1>, <conn2>
(Read-only) Specifies the use of a THRU adapter to be used during the Guided Cal Unknown THRU and Adapter Removal Cal. Returns an adapter index <n> which is used to refer to the adapter in several related commands. See Cal Thru Methods. While the choice of which end of the adapter is <conn1> and <conn2> is arbitrary, it is necessary to remember which will be used on each test port. The settings for this command remain until Preset, or the command is sent using a different setting, or until the ZERO command is sent. |
|
Parameters |
|
<ch> |
Channel being calibrated, depending on the CHAN:MODE setting. If unspecified, value is set to 1. |
<conn1> |
Adapter port 1 connector type. Use SENS:CORR:COLL:GUID:CONN:CAT? to return a list of valid connector types. |
<conn2> |
Adapter port 2 connector type. |
Examples |
|
Return Type |
Numeric |
Not Applicable |
SENSe<ch>:CORRection:COLLect:GUIDed:ADAPter:COUNt?
(Read-Only) Returns the number of THRU adapters that have been created for this calibration using SENS:CORR:COLL:GUID:ADAP:CREate. |
|
Parameters |
|
<ch> |
Channel being calibrated, depending on the CHAN:MODE setting. If unspecified, value is set to 1. |
Examples |
|
Return Type |
Numeric |
Not Applicable |
SENSe:<ch>CORRection:COLLect:GUIDed:ADAPter:COUNt:ZERO
(Write-only) Removes all adapters that have been defined for calibrations on the specified channel using SENS:CORR:COLL:GUID:ADAP:CREate. |
|
Parameters |
|
<ch> |
Channel being calibrated, depending on the CHAN:MODE setting. If unspecified, value is set to 1. |
Examples |
SENS:CORR:COLL:GUID:ADAP:COUNt:ZERO |
Query Syntax |
Not Applicable |
Not Applicable |
SENSe<ch>:CORRection:COLLect:GUIDed:ADAPter<n>:DELay <coax>, [w phase, wdelay]
(Write-only) Specifies the adapter delay. and optionally waveguide delay and optional phase offset (degrees) of adapter <n>. The settings for this command remain until Preset, or the command is sent using a different setting, or until the ZERO command is sent. |
|
Parameters |
|
<ch> |
Channel being calibrated, depending on the CHAN:MODE setting. If unspecified, value is set to 1. |
<n> |
Adapter index number that was returned from SENS:CORR:COLL:GUID:ADAP:CREate? |
<coax> |
Delay value of coax adapter <n> in seconds. If the adapter has no coax connector, enter 0. |
<wphase> |
Waveguide phase offset in degrees. If the adapter has no waveguide connector, do not enter a value. |
<wdelay> |
Waveguide delay in seconds. If the adapter has no waveguide connector, do not enter a value. |
Examples |
|
Not Applicable |
SENSe<ch>:CORRection:COLLect:GUIDed:ADAPter<n>:DESCription <string>
(Write-only) Specifies the adapter description for use as the guided cal connection prompts. The settings for this command remain until Preset, or the command is sent using a different setting, or until the ZERO command is sent. |
|
Parameters |
|
<ch> |
Channel being calibrated, depending on the CHAN:MODE setting. If unspecified, value is set to 1. |
<n> |
Adapter index number that was returned from SENS:CORR:COLL:GUID:ADAP:CREate? |
<string> |
Adapter description. |
Examples |
|
Query Syntax |
Not Applicable |
Not Applicable |
SENSe<ch>:CORRection:COLLect:GUIDed:ADAPter<n>:PATHs <port pairs>
(Write-only) Specifies the port pairs for which the adapter will be used for a THRU connection. For example, for a 3-port cal on channel 1 using ports 1,2,and 3), to use adapter 1 between the ports (1 to 2) and (1 to 3) the following command is used: SENS1:CORR:COLL:GUID:ADAP1:PATH 1,2,1,3. The adapter must have the same DUT connectors as the ports that are already specified for these ports. The settings for this command remain until Preset, or the command is sent using a different setting, or until the ZERO command is sent. |
|
Parameters |
|
<ch> |
Channel being calibrated, depending on the CHAN:MODE setting. If unspecified, value is set to 1. |
<n> |
Adapter index number that was returned from SENS:CORR:COLL:GUID:ADAP:CREate? |
<port pair> |
Ports for which the adapter will be used. The orientation is not critical, as the PNA will align the connector types as necessary. The minimum number of Thru connections required is the number of ports to calibrated -1. |
Examples |
|
Query Syntax |
Not Applicable |
Not Applicable |
SENSe:CORRection:COLLect:GUIDed:CHANnel:MODE <bool>
(Read-Write) Determines whether or not to honor the channel <ch> argument in guided calibration SCPI commands. |
||||||||||||||||
Parameters |
|
|||||||||||||||
<bool> |
OFF (0) Honor all <ch> arguments. This means the <ch> channel is calibrated regardless of which channel is currently active. ON (1) Legacy behavior. Behavior is specified by the following table:
Learn about Standard vs Application channels. |
|||||||||||||||
Examples |
SENS:CORR:COLL:GUID:CHAN:MODE 0 sense:correction:collect:guided:channel:mode ON |
|||||||||||||||
Query Syntax |
SENSe:CORRection:COLLect:GUIDed:CHANnel:MODE? |
|||||||||||||||
Return Type |
Boolean |
|||||||||||||||
OFF - This is the default beginning with A.09.50 ON - Default before A.09.50 |
SENSe:CORRection:COLLect:GUIDed:CKIT:CATalog? <connector>
(Read-only) This command replaces SENS:CORR:COLL:GUID:CKIT:PORT:CAT? Returns a comma-separated list of valid kits that use the specified connector type. This includes mechanical cal kits, applicable characterizations found within ECal modules currently connected to the PNA, and all user characterizations stored in PNA disk memory. For ECal modules, the returned list includes the serial numbers. See ECal User Characterization commands. Use items in the list to select the kit to be used with the SENS:CORR:COLL:GUID:CKIT:PORT and SENSe<ch>:CORRection:COLLect:GUIDed:PSENsor<pnum>:CKIT commands. |
|
Parameters |
|
<conn> |
String. Connector type. Use SENS:CORR:COLL:GUID:CONN:CAT? to return a list of valid connector types. |
Examples |
SENSe:CORR:COLL:GUID:CKIT:CAT? "Type N (50) male" |
Return Type |
String |
Not Applicable |
SENSe:CORRection:COLLect:GUIDed:CKIT:PORT<pnum>:CATalog? Superseded
(Read-only) This command is replaced by SENSe:CORR:COLL:GUID:CKIT:CAT?. Returns a comma-separated list of valid kits for the specified PNA port. In addition to mechanical calibration kits, this will include applicable characterizations found within ECal modules currently connected to the PNA. Use items in the list to select the kit to be used with the SENS:CORR:COLL:GUID:CKIT:PORT command. Note: Beginning with PNA Rev 9.1, the serial number is returned for ALL ECal modules that are connected with the connector type of the specified port. Previously, the returned list would include the serial numbers to distinguish the ECal modules only when two or more identical ECal models were connected to the PNA. |
|
Parameters |
|
<pnum> |
Any existing port number. If unspecified, value is set to 1 |
Examples |
SENS:CORR:COLL:GUID:CKIT:PORT1:CAT? "85054D, 85032F" 'When two identical ECal modules are connected
for the connector type, "85092-60010 ECal 10675, 85092-60010 ECal 00758" |
Return Type |
String |
Not Applicable |
SENSe<ch>:CORRection:COLLect:GUIDed:CKIT:PORT<pnum>[:SELect] <kit>
(Read-Write) Specifies the calibration kit (mechanical or ECal) for each port to be used during a guided calibration. An unused port does NOT need to have a specified Cal Kit.
When using this command to specify the cal kit for the output of a VMC calibration mixer, specify port 3. If port 3 is already used for the output of the DUT mixer, then specify port 4. Learn more. |
|
Parameters |
|
<ch> |
Channel being calibrated, depending on the CHAN:MODE setting. If unspecified, value is set to 1. |
<pnum> |
Any existing port number. If unspecified, value is set to 1 |
<kit> |
Calibration kit to be used for the specified port. Case-sensitive. When using an ECal module, include the characterization name in the <kit> string. Use SENSe:CORR:COLL:GUID:CKIT:CAT? to read the list of characterizations available in the module and in PNA disk memory. If two or more identical ECal modules are connected to the PNA, the serial number must be included to distinguish the ECal modules. |
Examples |
'Note: All of the following examples specify port 1 only ' Mechanical Cal kit SENS:CORR:COLL:GUID:CKIT:PORT1 '85055A' ' Standard ECal modules SENS:CORR:COLL:GUID:CKIT:PORT1 "N4691-60004 ECal" ' Non-factory ECal characterizations are specified as follows: SENS:CORR:COLL:GUID:CKIT:PORT1 "N4691-60004 User 1 ECal" ' When two or more ECal modules with the same model number are ' connected, also specify the serial number as follows: SENS:CORR:COLL:GUID:CKIT:PORT1 "N4691-60004 ECal 01234" ' When Disk Memory ECal user characterizations are used, ' specify both the User char and the serial number as follows: SENS:CORR:COLL:GUID:CKIT:PORT1 "N4691-60004 MyDskChar ECal 01234" |
Query Syntax |
SENSe:CORRection:COLLect:GUIDed:CKIT:PORT<pnum>[:SELect]? |
Return Type |
String - If the <kit> parameter was incorrectly entered while writing, an error will be returned. |
Not Applicable |
SENSe:CORRection:COLLect:GUIDed:CONNector:CATalog?
(Read only) Returns a list of valid connectors based on the connector descriptions of the available cal kits. Use an item from the returned list to specify a connector for SENS:CORR:COLL:GUID:CONN:PORT Here are the more common connector types:
|
||||
Examples |
SENS:CORR:COLL:GUID:CONN:CAT? Type N (50) female, Type N (50) male, APC 7 (50), 3.5 mm (50) male, 3.5 mm (50) female, User Connector A |
|||
Return Type |
Comma separated string values |
|||
Not Applicable |
SENSe<ch>:CORRection:COLLect:GUIDed:CONNector:PORT<pnum>[:SELect] <conn>
(Read-Write) Specifies a DUT connector type for every port during the Guided Calibration procedure. Valid DUT connector names are stored within calibration kits. Some cal kits may include both male and female DUT connectors. Therefore, specifying the DUT connector gender may be required. The PNA remembers previous Guided Cal settings. Therefore, for completeness, unused ports can either be defined as "Not used" or use the SENS:CORR:COLL:GUID:ABORt command to clear all ports. The ABORt command is a more thorough approach and more convenient. See Guided Cal examples.
|
||
Parameters |
|
|
<ch> |
Channel being calibrated, depending on the CHAN:MODE setting. If unspecified, value is set to 1. |
|
<pnum> |
Any existing port number. If unspecified, value is set to 1. |
|
<conn> |
String - DUT connector type to connect with PNA port <pnum>. Case-sensitive. |
|
Examples |
'Specifying a 2-port cal (1 & 2) on a 4-port PNA SENS:CORR:COLL:GUID:CONN:PORT1
'Type N (50) female' |
|
Query Syntax |
SENSe:CORRection:COLLect:GUIDed:CONNector:PORT<pnum>[:SELect]? |
|
Return Type |
String |
|
Not Applicable |
SENSe<ch>:CORRection:COLLect:GUIDed:DESCription? <step>
(Read-only) Returns the connection description for the specified calibration step. |
|
Parameters |
|
<ch> |
Channel being calibrated, depending on the CHAN:MODE setting. If unspecified, value is set to 1. |
<step> |
A number from 1 to the number of steps required to complete the calibration (Use SENS:CORR:COLL:GUID:STEP? to query the number of steps ) |
Examples |
SENS:CORR:COLL:GUID:DESC? 10 'Returns: |
Return Type |
String |
Not Applicable |
SENSe<ch>:CORRection:COLLect:ETERms:COMPute [cal set name]
(Write-only) Computes the error correction terms, turns Correction ON, and saves the calibration to an existing, specified Cal Set. The cal acquisition process does not conclude as with the SAVE command. This command leaves the cal acquisition in memory to allow re-measuring/re-computing. To conclude the cal acquisition process, use the SENS:CORR:COLL:GUID:ABOR. command. Note: This command is NOT supported for application channels (Gain Compression, SMC/VMC, Noise Figure, IMD and so forth). Use SENS:CORR:COLL:GUID:SAVE and save to a cal register. You can then use SENS:CORR:CSET:COPY to copy the cal register to a named Cal Set.
For Calibrate All ChannelsWhen this command is used during a Cal All session, the <cal set name> argument sets the User Cal Set prefix. All generated Cal Sets will be preceded with this string name.
|
|
Parameters |
|
<ch> |
Channel being calibrated, depending on the CHAN:MODE setting. If unspecified, value is set to 1. |
<cal set name> |
String - Name of an existing Cal Set to be overwritten. See Calibrate All Channels note (above). |
Examples |
SENS:CORR:COLL:ETER:COMP "{2B893E7A-971A-11d5-8D6C-00108334AE96}" sense:correction:collect:eterms:compute "MyCalSet" |
Query Syntax |
Not Applicable |
Not Applicable |
SENSe<ch>:CORRection:COLLect:GUIDed:ETERms:LOAD[:CSET] <cset>,<calPort> [,csPort]
(Write-only) Loads 1-port error terms from a Cal Set into the current Guided Cal sequence. When the Cal steps are recomputed, connection steps are removed due to the loading of the error terms. This command must be sent after the INIT command. This command was implemented to facilitate calibrating a large matrix of external ports and most users will not need to use this command. |
|
Parameters |
|
<ch> |
Channel being calibrated, depending on the CHAN:MODE setting. If unspecified, value is set to 1. |
<cset> |
String Name of User Cal Set in which the error terms reside. |
<pnum> |
Integer Port number of the current cal to receive error terms. |
[csPort] |
Integer Optional argument. Port number associated with the error terms in the Cal Set. If unspecified, the same port number as <calPort> is used. |
Examples |
|
Query Syntax |
Not Applicable |
Not Applicable |
SENSe<ch>:CORRection:COLLect:GUIDed:INITiate[:IMMediate] [string][, bool][,char]
(Write-only) Initiates a guided calibration.
|
|
Parameters |
|
<ch> |
Channel to be calibrated, depending on the CHAN:MODE setting. If unspecified, value is set to 1. |
[string] |
Optional argument. Cal Set name or GUID enclosed in quotes. If NOT specified, behavior depends on the SENS:CORR:PREFerence:CSET:SAVE setting. If specified, choose an existing Cal Set, either by name or by GUID.
An error is reported if the Cal Set is not found. The Cal Set is either supplemented or overwritten depending on the method, connectors, and ports selected. Learn more about Cal Sets. |
[bool] |
Optional argument. To set this argument, also set the first optional argument. See example below. OFF (0) If Cal Set stimulus settings differ from the existing channel, do not change channel stimulus settings. The Cal Set is saved to the current setting of the SENS:CORR:PREF:CSET:SAVE command. This is the default setting if not specified. ON (1) If Cal Set stimulus settings differ from the existing channel, change the channel stimulus settings to match the Cal Set settings. |
[char] |
Optional argument. To set this argument, also set the first two optional arguments. See example below. SYNChronous - blocks further SCPI commands while processing this command.. (default setting). ASYNchronous - does NOT block further SCPI commands while processing this command. |
Examples |
SENS:CORR:COLL:GUID:INIT 'set first optional argument SENS:CORR:COLL:GUID:INIT "MyCalSet" 'set two optional arguments SENS:CORR:COLL:GUID:INIT " ",1 'set all optional arguments SENS:CORR:COLL:GUID:INIT "MyCalSet",1,ASYN |
Query Syntax |
Not Applicable |
Not Applicable |
SENSe<ch>:CORRection:COLLect:GUIDed:ISOLation:AVERage:INCRement <num>
(Read-Write) Specifies amount to increment (increase) the channels averaging factor during measurement of isolation standards in a guided calibration. Note: If the channel has averaging turned OFF and the value of <num> is greater than 1, averaging will be turned ON only during the isolation measurements and with the averaging factor equal to <num>. |
|
Parameters |
|
<ch> |
Channel being calibrated, depending on the CHAN:MODE setting. If unspecified, value is set to 1. |
<num> |
Amount to increment the averaging factor for the isolation measurement. The maximum averaging factor for the channel is 65536 (2^16). |
Examples |
'Measure isolation on all paths for the cal SENS:CORR:COLL:GUID:ISOL ALL 'Remove the port pairs 1-to-2 and 1-to-3 from the list of paths on which to measure isolation sense:correction:collect:guided:isolation:paths REMove,1,2,1,3 |
Query Syntax |
SENSe<ch>:CORRection:COLLect:GUIDed:ISOLation:AVERage:INCRement? |
Return Type |
Numeric |
8 - If this command is NOT sent, but isolation is measured, then averaging will be turned ON with factor set to 8 during the isolation measurements. |
SENSe<ch>:CORRection:COLLect:GUIDed:ISOLation[:PATHs] <char>[,<p1a, p1b, p2a, p2b]
(Read-Write) Specifies the paths (port pairs) to make isolation measurements on during a guided calibration. |
|
Parameters |
|
<ch> |
Channel being calibrated, depending on the CHAN:MODE setting. If unspecified, value is set to 1. |
<char> |
ALL Measure isolation on all pairings of the ports that are to be calibrated. NONE Do not measure isolation on any pairing of the ports to be calibrated. (Default behavior). ADD Add one or more specific pairings of ports to the list of port pairings for which isolation will be measured. REMove Remove one or more specific pairings of ports from the list of port pairings for which isolation will be measured. If many paths are to be measured, it may be easier to first send ALL, then REMove and specify the paths to remove. |
<p1a, p2a...> |
For use when <char> is ADD or REMove. Specify Port numbers in pairs:
p1a, p1b (Path1 - port A and port B) p2a, p2b (Path2 - port A and port B) p3a, p3b (Path3 - port A and port B) |
Examples |
'Measure isolation on all paths for the cal SENS:CORR:COLL:GUID:ISOL ALL 'Remove the port pairs 1-to-2 and 1-to-3 from the list of paths on which to measure isolation sense:correction:collect:guided:isolation:paths REMove,1,2,1,3 |
Query Syntax |
SENSe<ch>:CORRection:COLLect:GUIDed:ISOLation:PATHs? Note: if isolation is not be measured on any of the paths, the query returns 0 |
Return Type |
Numeric |
0 - Isolation not measured on any paths. |
SENSe<ch>:CORRection:COLLect:GUIDed:ITERations:COUNt? <step>
(Read-only) Designed to be used for an iterative cal standard such as a sliding load, this command returns the number of iterative measurement acquisitions that has been made for the specified step. Zero (0) is returned if the step has not yet been measured. For most cal steps that have already been measured, this command returns 1. Set SENS:CORR:COLL:GUID:PREF:SLID ITER to count acquisition steps. |
|
Parameters |
|
<ch> |
Channel being calibrated, depending on the CHAN:MODE setting. If unspecified, value is set to 1. |
<step> |
Guided Cal step number for which the acquisition number will be returned. Use SENS:CORR:COLL:GUID:STEP? to query the number of steps in the calibration. |
Examples |
SENS:CORR:COLL:GUID:ITER:COUN? 4 'Example return: 5 |
Return Type |
Numeric |
Not Applicable |
SENSe<ch>:CORRection:COLLect:GUIDed:ITERations:MINimum? <step>
(Read-only) Designed to be used for an iterative cal standard such as a sliding load, this command returns the minimum number of required iterative measurement acquisitions for the specified step. For most connection steps this will return 1, but for an iterative cal standard such as a sliding load, it will return a number such as 5. Set SENS:CORR:COLL:GUID:PREF:SLID ITER to count acquisition steps. |
|
Parameters |
|
<ch> |
Channel being calibrated, depending on the CHAN:MODE setting. If unspecified, value is set to 1. |
<step> |
Guided Cal step number for which to return the number of iterative measurement acquisitions that have been made. Use SENS:CORR:COLL:GUID:STEP? to query the number of steps in the calibration. |
Examples |
SENS:CORR:COLL:GUID:ITER:MIN? 4 'Example return: 5 |
Return Type |
Numeric |
Not Applicable |
SENSe<ch>:CORRection:COLLect:GUIDed:ITERations:RESet <step>
(Write-only) Resets the specified guided cal connection step as unmeasured. This clears all previous measurements made for that step. |
|
Parameters |
|
<ch> |
Channel being calibrated, depending on the CHAN:MODE setting. If unspecified, value is set to 1. |
<step> |
Guided Cal step number to reset. Use SENS:CORR:COLL:GUID:STEP? to query the number of steps in the calibration. |
Examples |
SENS:CORR:COLL:GUID:ITER:RESet? 4 |
Return Type |
Not Applicable |
Not Applicable |
SENSe:CORRection:COLLect:GUIDed:METHod <char> Superseded
This command is replaced with SENS:CORR:COLL:GUID:PATH:CMEThod and SENS:CORR:COLL:GUID:PATH:TMEThod. (Read-Write) Selects from one of several algorithms available for performing the THRU portion of a guided calibration. Learn more about THRU methods. |
|
Parameters |
|
<char> |
DEFAULT - Informs guided calibrations to use the default algorithm when computing the number of needed standards acquisition steps. (default selection if omitted.) ADAP - Use the adapter removal algorithm FLUSH - Use with insertable devices. UNKN - Use the Unknown THRU algorithm with calibrations for non-insertable devices. DEFined - Use the THRU definition that you stored in the cal kit file, or ECal module. TRL - Select TRL Cal Type for guided cals. Valid for "TRL ready" Cal Kits with properly assigned TRL cal classes. SOLT - Select SOLT Cal Type for guided cals. Valid for any kit with properly assigned SOLT cal classes. |
Examples |
SENS:CORR:COLL:GUID:METH
ADAP |
Query Syntax |
SENSe:CORRection:COLLect:GUIDed:METHod? |
Return Type |
Character |
DEFAULT |
SENSe<ch>:CORRection:COLLect:GUIDed:PACQuire STAN<n>
(Write-only) Show the Cal Window, and optionally one or more other specific windows before acquiring a Cal standard. This command will cause the Cal Window to display the specific measurements that are to be made for that particular Cal standard to facilitate the connection of standards. |
|
Parameters |
|
<ch> |
Channel being calibrated, depending on the CHAN:MODE setting. If unspecified, value is set to 1. |
STAN<n> |
Choose from:STAN1, STAN2, etc. through STANn where n is the number of cal standard connection steps for the calibration. Note: You do not necessarily have to invoke these connection steps in sequential order. |
Examples |
SENS:CORR:COLL:GUID:PACQuire STAN2 sense:correction:collect:guided:pacquire STAN5 |
Query Syntax |
Not Applicable |
Not Applicable |
SENSe<ch>:CORRection:COLLect:GUIDed:PATH:CMEThod <port1>,<port2>,<caltype1[,caltype2]>
Note: This command replaces SENS:CORR:COLL:GUID:METH. (Read-Write) Specifies the calibration method for each port pair. Note: Sending this command will overwrite the PNAs SmartCal determinations for the most accurate cal method for your connector settings and Cal Kits. Send this command ONLY if you have a deliberate reason for overwriting the SmartCal logic. You can send the query form of this command to learn the cal method determined by SmartCal. See Thru Pairs Sequence to learn how to send this and other Thru commands. After sending this command, send the query form to be sure that the command was accepted. If not, then the chosen Cal method is not compatible with the specified Thru method. For example, if the specified Thru method is Unknown Thru, an attempt to set Enhanced Response Cal should be rejected. |
|
Parameters |
|
<ch> |
Channel being calibrated, depending on the CHAN:MODE setting. If unspecified, value is set to 1. |
<port1> |
First port of the pair to be calibrated. |
<port2> |
Second port of the pair to be calibrated. |
<caltype1[caltype2]> |
(String) Cal type for the port pair, enclosed in a single pair of quotes. NOT case-sensitive. caltype1 Choose from:
For the last two arguments, replace N with the port to be used as the source port, which MUST be one of the port pair. caltype2 Optional argument. Use only when performing an adapter removal cal on the pair. This argument specifies the Cal type on the second port. Caltype1 then specifies the Cal type of the first port. Choose from the same arguments as caltype1. |
Examples |
SENS:CORR:COLL:GUID:PATH:CMEThod 2,3,"QSOLT2" sense:correction:collect:guided:path:cmethod 2,3,"solt,trl" |
Query Syntax |
SENSe<ch>:CORRection:COLLect:GUIDed:PATH:CMEThod? <port1>,<port2> If only one caltype is returned then its NOT adapter removal. |
Return Type |
String |
The most accurate Cal method for the current cal. |
SENSe<ch>:CORRection:COLLect:GUIDed:PATH:TMEThod <port1>,<port2>,<thruType1[,thruType2]>
Note: This command replaces SENS:CORR:COLL:GUID:METH. (Read-Write) Specifies the calibration THRU method for each port pair. Note: Sending this command will overwrite the PNAs SmartCal determination for the thru method. Send this command ONLY if you have a deliberate reason for overwriting the SmartCal logic. You can send the query form of this command to learn the THRU method determined by SmartCal. See Thru Pairs Sequence to learn how to send this and other Thru commands. |
|
Parameters |
|
<ch> |
Channel being calibrated, depending on the CHAN:MODE setting. If unspecified, value is set to 1. |
<port1> |
First port of the port pair to be calibrated. |
<port2> |
Second port of the port pair to be calibrated. |
<thruType1[,thruType2]> |
(String) Thru methods for port pair, enclosed in a single pair of quotes. NOT case-sensitive. thruType1 Calibration Thru method. Choose from:
thruType2 Optional argument. Use ONLY when Adapter Removal Cal is specified for the pair using SENS:CORR:COLL:GUID:PATH:CMEThod. When specifying ThruType2, this is the only valid argument: "Defined Thru, Defined Thru" |
Examples |
SENS:CORR:COLL:GUID:PATH:TMEThod
2,3,"Zero Thru" |
Query Syntax |
SENSe<ch>:CORRection:COLLect:GUIDed:PATH:TMEThod? <port1>,<port2> Always returns two parts: If the second part of the string is empty, adapter removal is NOT being performed. If the string is "Defined Thru, Defined Thru", adapter removal IS being performed. |
Return Type |
String |
The most accurate Thru method for the current cal. |
SENSe<ch>:CORRection:COLLect:GUIDed:PREFerence:SLIDingload <char>
(Read-Write) Specifies the behavior for guided cal steps that involve a sliding load in a cal that is about to be performed. Send this command BEFORE sending the Guided INIT command. Although the term 'Preference' is used in the command, this is NOT a PNA preference. This setting does NOT survive instrument preset or reboot. It remains ONLY for the duration of the Guided Cal. |
|
Parameters |
|
<char> |
Behavior when measurements of sliding load are acquired. Choose from: DIALog - The Sliding load dialog box appears when the acquire command is received for a sliding load step. All slide positions are measured (with a user-interface prompt) from a single invocation of the acquire command. ITERate - Each invocation of the acquire command for a sliding load step measures a single slide position and increments the slide position counter. No Move Sliding Load prompt is presented on the PNA screen. |
Examples |
SENS:CORR:COLL:GUID:PREF:SLID ITER |
Query Syntax |
SENSe<ch>:CORRection:COLLect:GUIDed:PREFerence:SLIDingload? |
Return Type |
Character |
DIALog |
SENSe<ch>:CORRection:COLLect:GUIDed:SAVE[:IMMediate] [bool]
(Write-only) Completes the guided cal by computing the error correction terms, turning Correction ON, and saving the calibration to a Cal Set. If all of the required standards have not been measured, the calibration will not complete properly. |
|
Parameters |
|
<ch> |
Channel being calibrated, depending on the CHAN:MODE setting. If unspecified, value is set to 1. |
[bool] |
Optional argument. If unspecified, the default behavior is the current PNA preference setting of SENSe:CORRection:PREFerence:CSET:SAVE. OFF (0) Save cal data ONLY to a Cal Register. ON (1) Save cal data to a Cal Register and a User Cal Set. The filename is automatically generated.
|
Examples |
SENS:CORR:COLL:GUID:SAVE |
Query Syntax |
Not Applicable |
Not Applicable |
SENSe<ch>:CORRection:COLLect:GUIDed:SAVE:CSET <cal set name or guid>
(Write-only) Completes the guided cal by computing the error correction terms, turning Correction ON, and saving the calibration to an existing, specified Cal Set. This command performs the same function as SENSe:CORRection:COLLect:GUIDed:SAVE, except this command allows the name or GUID of the Cal Set to be specified. Note: This command is NOT supported for application channels (Gain Compression, SMC/VMC, Noise Figure, IMD and so forth). Use SENS:CORR:COLL:GUID:SAVE and save to a cal register. You can then use SENS:CORR:CSET:COPY to copy the cal register to a named Cal Set.
For Calibrate All ChannelsWhen this command is used during a Cal All session, the <cal set name> argument sets the User Cal Set prefix. All generated Cal Sets will be preceded with this string name.
|
|
Parameters |
|
<ch> |
Channel being calibrated, depending on the CHAN:MODE setting. If unspecified, value is set to 1. |
<cal set name or guid> |
String - Name or GUID of an existing Cal Set to be overwritten. If specifying a GUID, curly brackets must be included. See Calibrate All Channels note (above). |
Examples |
SENS:CORR:COLL:GUID:SAVE:CSET "{2B893E7A-971A-11d5-8D6C-00108334AE96}" sense:correction:collect:guided:save:cset "MyCalSet" |
Query Syntax |
Not Applicable |
Not Applicable |
SENSe<ch>:CORRection:COLLect:GUIDed:STEPs?
(Read-only) Returns the number of measurement steps required to complete the current guided calibration. This command is sent after the SENS:CORR:COLL:GUID:INIT, SENS:CORR:COLL:GUID:CONN:PORT and SENS:CORR:COLL:GUID:CKIT:PORT commands. |
|
Parameters |
|
<ch> |
Any existing channel number. If unspecified, value is set to 1. |
Examples |
SENS:CORR:COLL:GUID:STEP? |
Return Type |
Numeric |
Not Applicable |
SENSe<ch>:CORRection:COLLect:GUIDed:THRU:PORTs <t1a, t1b, t2a, t2b, t3a, t3b...>
(Read-Write) For calibrating more than 2-ports ONLY. Specifies the port pairs for the Thru connections of the calibration. Send the query form of this command to learn the Thru pairs determined by SmartCal. Note: Sending this command will overwrite the PNAs SmartCal determinations for the thru ports. Send this command ONLY if you have a deliberate reason for overwriting the SmartCal logic. See Thru Pairs Sequence to learn how to send this and other Thru commands. |
|
Parameters |
|
<ch> |
Channel being calibrated, depending on the CHAN:MODE setting. If unspecified, value is set to 1. |
<t1a,t1b...> |
Always specify port numbers in pairs: For example: 1,2 or 1,2,1,3
|
Examples |
SENS:CORR:COLL:GUID:THRU:PORT 1,2,1,3,1,4 '4-port measurement sense:correction:collect:guided:thru:ports 1,2,2,3 '3-port measurement |
Query Syntax |
SENSe<ch>:CORRection:COLLect:GUIDed:THRU:PORTs? |
Return Type |
Numeric |
Port pairings that were used in the previous cal. |
THRU Pairs sequence
The SmartCal logic always determines the best calibration based on your specified connectors and ports.
The following three commands overwrite the SmartCal logic. Send these commands ONLY if you have a deliberate reason for overwriting the SmartCal logic.
sens:corr:coll:guid:thru:ports <p1, p2>
sens:corr:coll:guid:path:tmet <p1,p2, thrutype>
sens:corr:coll:guid:path:cmet <p1,p2, calmethod>
When sending one or more of these commands, they must be sent in the following sequence with the other commands listed here.
Note: The GUID:INIT command is sent before and after these commands.
sens:corr:coll:guid:thru:ports <p1, p2>
sens:corr:coll:guid:path:tmet <p1,p2, thrutype>
sens:corr:coll:guid:path:cmet <p1,p2, calmethod>
sens:corr:coll:guid:path:cmet? <p1,p2> (recommended)