This subsystem assigns names and measurement parameters to traces. The commands are device-specific.
Command tree: CALCulate<Ch>:PARameter
Returns the trace names and measurement parameters of all traces assigned to a particular channel.
<Ch> |
Channel number. If unspecified the numeric suffix is set to 1.
|
Response |
String parameter with comma-separated list of trace names and measurement parameters, e.g. 'CH4TR1,S11,CH4TR2,S12'. The measurement parameters are returned according to the naming convention of CALCulate<Ch>:PARameter:SDEFine. The order of traces in the list reflects their creation time: The oldest trace is the first, the newest trace is the last trace in the list.
|
*RST value |
–
|
SCPI, Command Types |
Device-specific, query only.
|
Example: |
CALC4:PAR:SDEF 'Ch4Tr1', 'S11' Create channel 4 and a trace named Ch4Tr1 to measure the input reflection coefficient S11. CALC4:PAR:CAT? Query the traces assigned to channel 4. If Ch4Tr1 is the only trace assigned to channel 4, the response is 'CH4TR1,S11'.
|
Creates a trace and assigns a channel number, a name and a measurement parameter to it. The trace is not displayed. To display a trace defined via CALCulate<Ch>:PARameter:DEFine, a window must be created (DISPlay:WINDow<Wnd>[:STATe] ON) and the trace must be assigned to this window (DISPlay:WINDow<Wnd>:TRACe:FEED); see example below.
Traces must be selected to become active traces; see CALCulate:PARameter:SELect.
This command has been implemented for compatibility reasons. The parameter names in this command differ from ZVB conventions; moreover the parameter list is not complete. The alternative command CALCulate<Ch>:PARameter:SDEFine uses a complete parameter list with compatible names.
<Ch> |
Channel number. <Ch> may be used to reference a previously defined channel. If <Ch> does not exist, it is generated with default channel settings.
|
'<string>' |
Trace name, e.g. 'Trc4'. See Rules for trace names in the Trace Manager description.
|
S11, ... R4R3 |
Measurement parameter; see list of parameters below. |
*RST value |
–
|
[<numeric_value>] |
Test port number, driving port for wave quantities and ratios, ignored for S-parameters. |
Range [def. unit] |
1 to 4 [–] (depending on instrument model) |
*RST value |
–
|
SCPI, Command Types |
Device-specific, no query. CALCulate<Ch>:PARameter:CATalog? returns a list of all defined traces.
|
Example: |
CALC4:PAR:DEF 'Ch4Tr1', S11 Create channel 4 and a trace named Ch4Tr1 to measure the input reflection coefficient S11. DISP:WIND:STAT ON Create diagram area no. 1. DISP:WIND:TRAC2:FEED 'CH4TR1' Display the generated trace in diagram area no. 1, assigning a trace number 2.
|
The measurement parameter is selected by means of the following keywords (the selection depends on the number of test ports of the analyzer, e.g. S44 is not available on 2-port analyzers):
S11 | S12 | S13 | S14 | S21 | S22 | S23 | S24 | S31 | S32 | S33 | S34 | S41 | S42 | S43 | S44 |
S-parameters |
A | B | C | D |
Wave quantities b1, b2, b3, b4 (received waves) |
R1 | R2 | R3 | R4 |
Wave quantities a1, a2, a3, a4 (reference waves) |
AB | AC | AD | BA | BC | BD | CA | CB | CD | DA | dB | DC |
Ratio of wave quantities b1/b2, b1/b3, ... , b4/b3 (received waves only) |
AR1 | AR2 | AR3 | AR4 | BR1 | BR2 | BR3 | BR4 | CR1 | CR2 | CR3 | CR4 | DR1 | DR2 | DR3 | DR4 | R1A | R1B | R1C | R1D | R2A | R2B | R2C | R2D | R3A | R3B | R3C | R3D | R4A | R4B | R4C | R4D |
Ratio of wave quantities b1/a1, b1/a2, ... , b4/a4, a1/b1, a1/b2, ..., A4/B4 (received waves to reference waves or reference waves to received waves) |
R1R2 | R1R3 | R1R4 | R2R1 | R2R3 | R2R4 | R3R1 | R3R2 | R3R4 | R4R1 | R4R2 | R4R3 |
Ratio of wave quantities a1/a2, a1/a3, ... , a4/a3 (reference waves only) |
Creates the traces for all S-parameters associated with a group of logical ports (S-parameter group). The traces can be queried using CALCulate<Ch>:DATA:SGRoup?
Traces must be selected to become active traces; see CALCulate:PARameter:SELect.
Each channel can contain a single S-parameter group only. Defining a new S-parameter group deletes the previous one. Use CALCulate<Ch>:PARameter:DEFine:SGRoup to delete the current S-group explicitly.
<Ch> |
Channel number. <Ch> may be used to reference a previously defined channel. If <Ch> does not exist, it is generated with default channel settings.
|
<log_port1>... |
Logical (balanced or unbalanced) port numbers. The port numbers must be in ascending order, their number is limited by the test ports of the analyzer. With n logical port numbers, the command generates n2 traces. The traces correspond to the following S-parameters: S<log_port1><log_port1>,
S<log_port1><log_port2>
... S<log_port1><log_port<n>>
The generated traces are assigned the following trace names: <Ch_name>_SG_S<log_port1><log_port1>, <Ch_name>_SG_S<log_port1><log_port2>
... <Ch_name>_SG_S<log_port1><log_port<n>> The trace names are displayed in the Trace Manager(DISPlay:MENU:KEY:EXECute 'Trace Manager')and Channel Managerdialogs where they can be changed manually. The <Ch_name> is defined via CONFigure:CHANnel<Ch>:NAME '<Ch_name>'. Trace names are important for referencing the generated traces; see program example below.
|
Range [def. unit] |
1 to 4 [–] (depending on instrument model) |
*RST value |
NONE (see below)
|
SCPI, Command Types |
Device-specific, with query. The query returns the port numbers of the current S-parameter group, NONE if no S-parameter group has been defined.
|
Example: |
CALC2:PAR:DEF:SGR 1,2 Create channel 2 and four traces to measure the two-port S-parameters S11, S12, S21, S22. The traces are not displayed. DISP:WIND:TRAC2:FEED 'Ch2_SG_S11' Display the four traces in the diagram area no. 1. INIT:CONT OFF Perform a complete speep to ensure the traces are completely "filled" with data. CALC2:DATA:SGR? SDAT Retrieve all four traces as unformatted data (real and imaginary part at each sweep point). The analyzer first returns the complete S11 trace, followed by the S12, S21, and S22 traces. CALC2:PAR:DEL:SGR 1,2 Delete the previously created port group.
|
Deletes a trace with a specified trace name and channel.
<Ch> |
Channel number.
|
'<trace>' |
Trace name, e.g. 'Trc4'. See Rules for trace names in the Trace Manager description.
|
*RST value |
–
|
SCPI, Command Types |
Device-specific, no query.
|
Example: |
CALC4:PAR:SDEF 'Ch4Tr1', 'S11' Create channel 4 and a trace named Ch4Tr1 to measure the input reflection coefficient S11. CALC4:PAR:CAT? Query the traces assigned to channel 4. If Ch4Tr1 is the only trace assigned to channel 4, the response is 'CH4TR1,S11'. CALC4:PAR:DEL 'CH4TR1' Delete the created trace.
|
Deletes a group of logical ports (S-parameter group), previously defined via CALCulate<Ch>:PARameter:DEFine:SGRoup.
<Ch> |
Channel number. <Ch> may be used to reference a previously defined channel. If <Ch> does not exist, it is generated with default channel settings.
|
*RST value |
– (no query form)
|
SCPI, Command Types |
Device-specific, no query.
|
Example: |
See CALCulate<Ch>:PARameter:DEFine:SGRoup
|
Assigns a measurement parameter to an existing trace.
Note: To create a new trace and at the same time assign the attributes, use CALCulate<Ch>:PARameter:SDEFine . To display the trace, create a window (DISPlay:WINDow<Wnd>[:STATe] ON) and assign the trace to this window (DISPlay:WINDow<Wnd>:TRACe:FEED); see example below.
Traces must be selected to become active traces; see CALCulate:PARameter:SELect. CALCulate<Ch>:PARameter:CATalog? returns a list of all defined traces. You can open the trace manager (DISPlay:MENU:KEY:EXECute 'Trace Manager') to obtain an overview of all channels and traces, including the traces that are not displayed.
<Ch> |
Channel number of an existing channel containing the referenced trace.
|
'<string>' |
Trace name, e.g. 'Trc4'. See Rules for trace names in the Trace Manager description.
|
'S11', ... |
Measurement parameter (string variable); see list of in
the CALCulate<Ch>:PARameter:SDEFine
command description. |
*RST value |
–
|
SCPI, Command Types |
Device-specific, with query (see 'S11',... parameter description above).
|
Example: |
CALC4:PAR:SDEF 'Ch4Tr1', 'S11' Create channel 4 and a trace named Ch4Tr1 to measure the input reflection coefficient S11. CALC4:PAR:MEAS 'Ch4Tr1', 'a1' Change the measurement parameter of the trace and measure the wave quantity a1. CALC4:PAR:MEAS? 'Ch4Tr1' Query the measured quantity. The response is 'A1D1SAM'.
|
Overwrites the current channel settings with the ones that were used during the active (previously performed) noise figure calibration. The referenced trace must show the noise figure of a device.
<Ch> |
Channel number.
|
'<trace>' |
Name of a noise figure trace, e.g. 'Trc4'. See Rules for trace names in the Trace Manager description.
|
*RST value |
–
|
SCPI, Command Types |
Device-specific, no query.
|
Example: |
See Noise Figure Measurement (condensed measurement example)
|
Creates a trace and assigns a channel number, a name and a measurement parameter to it. The trace becomes the active trace in the channel but is not displayed.
To display the trace defined via CALCulate<Ch>:PARameter:SDEFine, create a diagram area (DISPlay:WINDow<Wnd>[:STATe] ON) and assign the trace to this area (DISPlay:WINDow<Wnd>:TRACe:FEED); see example below. CALCulate<Ch>:PARameter:MEASure changes the measurement parameter of an existing trace.
To select an existing trace as the active trace, use CALCulate:PARameter:SELect. You can open the trace manager (DISPlay:MENU:KEY:EXECute 'Trace Manager') to obtain an overview of all channels and traces, including the traces that are not displayed.
In FW versions <V1.90, traces created with CALCulate<Ch>:PARameter:SDEFine must be selected explicitly (CALCulate:PARameter:SELect) in order to become active traces.
Use CALCulate<Ch>:PARameter:DEFine:SGRoup to create traces for all S-parameters associated with a group of logical ports.
<Ch> |
Channel number. <Ch> may be used to reference a previously defined channel. If <Ch> does not exist, it is generated with default channel settings.
|
'<trc_name>' |
Trace name, string variable, e.g. 'Trc4'. See Rules for trace names in the Trace Manager description. Trace names must be unique across all channels and diagram areas. If a trace with the selected trace name already exists, the analyzer behaves as follows:
|
'S11', ... |
Measurement parameter (string variable); see list of parameters below. |
*RST value |
–
|
SCPI, Command Types |
Device-specific, no query. CALCulate<Ch>:PARameter:MEASure? '<Trc_name>' queries the measurement parameter of the trace. CALCulate<Ch>:PARameter:CATalog? returns a list of all defined traces.
|
Example: |
CALC4:PAR:SDEF 'Ch4Tr1', 'S11' Create channel 4 and a trace named Ch4Tr1 to measure the input reflection coefficient S11. DISP:WIND2:STAT ON Create diagram area no. 2. DISP:WIND2:TRAC:FEED 'CH4TR1' Display the generated trace in diagram area no. 2.
|
The measurement parameter is selected by means of the following keywords (the selection depends on the number of test ports of the analyzer, e.g. S44 is not available on 2-port analyzers):
*)Selecting a parameter Y...<n><m> or Z...<n><m> sets the range of port numbers to be considered for the Y and Z-parameter measurement to <n>:<m>.
Selects an existing trace as the active trace of the channel. All trace commands without explicit reference to the trace name act on the active trace (e.g. CALCulate<Ch>:FORMat). CALCulate<Ch>:PARameter:SELect is also necessary if the active trace of a channel has been deleted.
<Ch> |
Channel number.
|
<string> |
Trace name, e.g. 'Trc4'. See Rules for trace names in the Trace Manager description.
|
*RST value |
–
|
SCPI, Command Types |
Device-specific, with query (returns the name of the active trace).
|
Example: |
CALC4:PAR:SDEF 'Ch4Tr1', 'S11' Create channel 4 and a trace named Ch4Tr1 to measure the input reflection coefficient S11. The trace is the active trace in channel 4. CALC4:PAR:SDEF 'Ch4Tr2', 'S22' Create another trace named Ch4Tr2 to measure the output reflection coefficient S22. Again this new trace becomes the active trace in channel 4. CALC4:PAR:SEL 'Ch4Tr1' Select the first trace Ch4Tr1 as the active trace. CALC4:FORM MLIN Calculate the magnitude of S11 and display it in a linearly scaled Cartesian diagram.
|