:CALCulate[:SELected]:FORMat
Description
This command selects the format of the results data.
Syntax
:CALCulate<ch>[:SELected]:FORMat
| Command | Query | Query response |
|---|---|---|
| Yes | Yes | See Parameters below |
Parameters |
Accepted format |
Allowed suffixes |
Possible Errors |
Description |
|---|---|---|---|---|
{GDELay | IMAGinary | MLINear | MLOGarithmic | PHASe | REAL | UPHase | SWR | SMITh | SLINear | SLOGarithmic | SCOMplex | SADMittance } |
exactly the given options | none |
Illegal parameter value |
The results format |
To learn more about channels and traces, please refer to the SCPI command structure
Options
| Option | Description |
|---|---|
GDELay |
group delay |
IMAGinary |
imaginary part |
MLINear |
linear magnitude |
MLOGarithmic |
logarithmic magnitude |
PHASe |
phase (in degrees) |
REAL |
real part |
SWR |
standing wave ratio |
UPHase |
unwrapped phase |
SLINear |
linear magnitude + phase (deg) |
SLOGarithmic |
logarithmic magnitude + phase (deg) |
SCOMplex |
real part + imaginary part |
SMITh |
R + jX - (resistance + reactance) |
SADMittance |
G + jB - (conductance + susceptance) |
Important
Smith data types are only supported for S11, S21, GAINphase or Z measurements.
The S21 and GAINphase measurement does NOT support SMIT or SADM. If the selected format is not supported, a Settings Conflict error is raised.
Note
For S11 measurements SLIN, SLOG and SCOM return the reflection coefficient
while for S21, GAINphase measurements the transmission coefficient will be returned.
When perfomring Z measurements SLIN, SLOG and SCOM return the impedance (:CALC:SEL:ZPAR:DEF Z) respectively
the admittance (:CALC:SEL:ZPAR:DEF Y) or reflection (:CALC:SEL:ZPAR:DEF REFL) values.
SMIT returns always impedance while SADMittance returns always admittance values.
Note
The format selection DOES NOT influence the result, when performing an absolute measurement (CH1, CH2, R, T).
The only interesting value to obtain from an absolute measurement is the VRMS and therefore the VRMS value is returned, regardless of the format settings.
Sample usage
Configure and start an S21 measurement and get the logarithmic magnitude.
visaSession.write(':TRIG:SOUR BUS\n');
visaSession.write(':SENS:FREQ:STAR 5kHz;STOP 50kHz\n')
visaSession.write(':CALC:PAR:DEF S21\n')
visaSession.write(':CALC:FORM MLOG\n')
visaSession.write(':INIT\n');
visaSession.write(':TRIG:SING\n')
# wait for the measurement to finish
visaSession.query('*OPC?\n')
frequencyValues = visaSession.query(':SENS:FREQ:DATA?\n')
measurementValues = visaSession.query(':CALC:DATA:SDAT?\n')