:CALCulate:PARameter:DEFine
Description
This command selects the measurement type, which should be performed. For more details about the different measurement types please refer to the general info page about measurements (Measurement Types).
Important
By calling this method, the input parameters (gain / attenuation / termination) are ALWAYS set to the default values. All the corresponding values, that have been set before, are overridden. Therefore, it is recommended that this should always be the first command to call when configuring a measurement.
| Syntax |
Parameter |
:CALCulate<ch>:PARameter<tr>:DEFine |
{ S11 | S21 | GAINphase | CH1 | CH2 | Z | R | T } |
| Parameters |
accepted format |
allowed suffixes |
possible Errors |
description |
<ch> |
{ 1 | empty } |
none |
Undefined header |
Currently only one channel is supported. Empty means 1 is used as default. |
<tr> |
{ 1 | empty } |
none |
Undefined header |
Currently only one trace is supported. Empty means 1 is used as default. |
{ S11 | S21 | GAINphase | CH1 | CH2 | Z | R | T } |
exactly the given options |
none |
Illegal parameter value |
The measurement to perform |
| Syntax |
Response |
:CALCulate<ch>:PARameter<tr>:DEFine? |
{ S11 | S21 | GAINphase | CH1 | CH2 | Z | R | T } |
| Parameters |
accepted format |
description |
<ch> |
{ 1 | empty } |
Currently only one channel is supported. Empty means 1 is used as default. |
<tr> |
{ 1 | empty } |
Currently only one trace is supported. Empty means 1 is used as default. |
| Response value |
description |
{ S11 | S21 | GAINphase | CH1 | CH2 | Z | R | T } |
The measurement type. |
Options
| Options |
Description |
CH1 |
Absolute measurement on channel 1. (VRMS) |
CH2 |
Absolute measurement on channel 2. (VRMS) |
GAINphase |
Gain - phase measurement. |
R |
Absolute measurement on channel R (Ch1). (VRMS) |
S11 |
S11 measurement. |
S21 |
S21 measurement. |
T |
Absolute measurement on channel T (Ch2). (VRMS) |
Z |
Impedance measurement (Series Thru, Shunt Thru and Port 1 Reflection as defined in: :SENSe:Z:METHod) |
Presets
| default value |
|
{ S11 | S21 | GAINphase | CH1 | CH2 | Z | R | T } |
S11 |
Sample usage
Configure and start a S21 measurement.
var visaSession = new TcpipSocket(VISA_RESOURCENAME);
visaSession.RawIO.Write(":SENS:FREQ:STAR 5kHz;STOP 50kHz\n");
visaSession.RawIO.Write(":CALC:PAR:DEF S21\n");
visaSession.RawIO.Write(":TRIG:SING\n");
// wait for the measurement to finish
visaSession.RawIO.Write("*OPC?\n");
visaSession.RawIO.ReadString();
visaSession.RawIO.Write(":SENS:FREQ:DATA?\n");
var frequencyValues = visaSession.RawIO.ReadString();
visaSession.RawIO.Write(":CALC:DATA:SDAT?\n");
var measurementValues = visaSession.RawIO.ReadString();
Input:
visaSession.write(':SENS:FREQ:STAR 5kHz;STOP 50kHz\n')
visaSession.write(':CALC:PAR:DEF S21\n')
visaSession.write(':TRIG:SING\n')
visaSession.query('*OPC?\n')
frequencyValues = visaSession.query(':SENS:FREQ:DATA?\n')
measurementValues = visaSession.query(':CALC:DATA:SDAT?\n')
:SENSe:FREQuency:STARt
:SENSe:FREQuency:STOP
CreateOnePortMeasurement()
CreateShuntThruMeasurement()
CreateSeriesThruMeasurement()
CreateS11OnePortMeasurement()
CreateS21Measurement()
CreateGainMeasurement()