VNA Master™Programming Manual : VNA Commands : :CALCulate:TRANsform Subsystem
 
:CALCulate:TRANsform Subsystem
Front panel soft keys that are related to distance measurements, such as the Additional Dist Setup soft key, appear in menus only when the Setup Domain is set up for distance.
Maximum Distance
:CALCulate:TRANsform:DISTance:MAXimum?
Description
This command returns the maximum distance in millimeters if the current distance unit is set to meter, and otherwise returns the maximum distance in feet. This value is set based on the number of data points, propagation velocity, and start and stop frequency.
Syntax
:CALCulate:TRANsform:DISTance:MAXimum?
Cmd Parameter
NA (query only)
Query Response
<NR3> (millimeters or feet)
Range
– 3000.0 m to + 3000.0 m
Default Unit
millimeters (mm)
Front Panel Access
Freq/Time/Dist, Additional Dist Setup, Distance Info
 
Distance Resolution
:CALCulate:TRANsform:DISTance:RESolution?
Description
This command returns the distance resolution in millimeters if the current distance unit is set to meter, and otherwise returns the resolution in feet. This value is set based on the propagation velocity, start and stop frequency.
Syntax
:CALCulate:TRANsform:DISTance:RESolution?
Cmd Parameter
NA (query only)
Query Response
<NR3> (millimeters or feet)
Range
– 3000.0 m to + 3000.0 m
Default Unit
millimeters (mm)
Front Panel Access
Freq/Time/Dist, Additional Dist Setup, Distance Info
 
Start Distance
:CALCulate:TRANsform:DISTance:STARt
Description
Sets the start distance for DTF measurements. The query version of this command returns the start distance in millimeters if the current distance unit is set to meter, and otherwise returns the start distance in feet.
Syntax
:CALCulate:TRANsform:DISTance:STARt
:CALCulate:TRANsform:DISTance:STARt?
Cmd Parameter
<NRf> (meters or feet)
Query Response
<NR3> (millimeters or feet)
Range
– 3000.0 m to + 3000.0 m
Default Value
0.0 mm
Default Unit
Meters (m) when setting, Millimeters (mm) for query
Example
To set the start distance to 5 meters:
:CALC:TRAN:DIST:STAR 5
To set the start distance to 6 millimeters:
:CALCulate:TRANsform:DISTance:STARt 6mm
Front Panel Access
Freq/Time/Dist, Start Dist
 
Stop Distance
:CALCulate:TRANsform:DISTance:STOP
Description
Sets the stop distance for DTF measurements. The query version of this command returns the stop distance in millimeters if the current distance unit is set to meter, and otherwise returns the stop distance in feet.
Syntax
:CALCulate:TRANsform:DISTance:STOP
:CALCulate:TRANsform:DISTance:STOP?
Cmd Parameter
<NRf> (meters or feet)
Query Response
<NR3> (millimeters or feet)
Range
– 3000.0 m to + 3000.0 m
Default Value
6850 mm
Default Unit
Meters (m) when setting, Millimeters (mm) for query
Front Panel Access
Freq/Time/Dist, Stop Dist
Distance Units
:CALCulate:TRANsform:DISTance:UNIT
Description
Sets the units to be used for DTF measurements. The query version of this command returns the string “METER” if the current distance unit is set to meter, and otherwise returns the string “FEET”.
Syntax
:CALCulate:TRANsform:DISTance:UNIT METers|FEET
:CALCulate:TRANsform:DISTance:UNIT?
Cmd Parameter
<char> METers|FEET
Query Response
<char> METER|FEET
Default Value
METers when setting, METER for query
Example
To set the distance unit to Meter:
:CALCulate:TRANsform:DISTance:UNIT METers
:CALC:TRAN:DIST:UNIT MET
To set the distance unit to Feet:
:CALC:TRAN:DIST:UNIT FEET
:CALCulate:TRANsform:DISTance:UNIT FEET
Front Panel Access
Shift 8 (System), Application Options, Units
 
Distance Domain Window Shape
:CALCulate:TRANsform:DISTance:WINDow
Description
Sets the distance domain window shape (used for pre‑processing the frequency domain data) for all traces. Setting the window to RECTangular sets the window shape to rectangular. Setting the window to NSL sets the window shape to Nominal Side Lobe view. Setting the window to LSL sets the window shape to Low Side Lobe view. Setting the window to MSL sets the window shape to Minimum Side Lobe.
This command performs the same function as the command :CALCulate:TRANsform:TIME:WINDow. Either command changes the window shape for both the time and distance domain traces.
The query version of this command returns RECT for Rectangular view, NSL for Nominal Side Lobe, LSL for Low Side Lobe, and MSL for Minimum Side Lobe view.
Syntax
:CALCulate:TRANsform:DISTance:WINDow RECTangular|NSL||LSL|MSL
:CALCulate:TRANsform:DISTance:WINDow?
Cmd Parameter
<char> RECTangular|NSL||LSL|MSL
Query Response
<char> RECT|NSL||LSL|MSL
Default Value
NSL
Example
To set the window to rectangular:
:CALC:TRAN:DIST:WIND RECT
OR:
:CALCulate:TRANsform:DISTance:WINDow RECTangular
Related Command
:CALCulate:TRANsform:TIME:WINDow
Front Panel Access
Freq/Time/Distance, Windowing
 
Maximum Time
:CALCulate:TRANsform:TIME:MAXimum?
Description
This command returns the maximum time in nanoseconds. This value is set based on the number of data points and the start and stop frequencies.
Syntax
:CALCulate:TRANsform:TIME:MAXimum?
Cmd Parameter
NA (query only)
Query Response
<NR3> nanoseconds
Range
– 100 ms to + 100 ms
Default Unit
nanoseconds (ns)
Front Panel Access
Freq/Time/Dist, Time Info
Time Resolution
:CALCulate:TRANsform:TIME:RESolution?
Description
This command returns the time resolution in nanoseconds. This value is set based on the start and stop frequencies.
Syntax
:CALCulate:TRANsform:TIME:RESolution?
Cmd Parameter
NA (query only)
Query Response
<NR3> nanoseconds
Range
– 100 ms to + 100 ms
Default Unit
nanoseconds (ns)
Front Panel Access
Freq/Time/Dist, Time Info
 
Start Time
:CALCulate:TRANsform:TIME:STARt
Description
Sets the start time. The query version returns the current start time in nanoseconds.
Syntax
:CALCulate:TRANsform:TIME:STARt
:CALCulate:TRANsform:TIME:STARt?
Cmd Parameter
<NRf> seconds
Query Response
<NR3> nanoseconds
Range
– 100 ms to + 100 ms
Default Value
0 ps
Default Unit
Seconds (s) when setting, nanoseconds (ns) for query
Example
To set the start time to 10 microseconds:
:CALC:TRAN:TIME:STAR 10us
To set the start time to 20 nanoseconds:
:CALCulate:TRANsform:TIME:STARt 20ns
Front Panel Access
Freq/Time/Dist, Start Time
Stop Time
:CALCulate:TRANsform:TIME:STOP
Description
Sets the stop time. The query version returns the current stop time in nanoseconds.
Syntax
:CALCulate:TRANsform:TIME:STOP
:CALCulate:TRANsform:TIME:STOP?
Cmd Parameter
<NRf> seconds
Query Response
<NR3> nanoseconds
Range
– 100 ms to + 100 ms
Default Value
20 ns
Default Unit
Seconds (s) when setting, nanoseconds (ns) for query
Front Panel Access
Freq/Time/Dist, Stop Time
 
Reflection Calculation for Time Domain
:CALCulate:TRANsform:TIME:TRIP
Description
Sets the trip length of the time transform for the reflection parameters (S11 or S22). For these reflection parameters, the x‑axis scale can either represent a one‑way path (the time required to reach the end of the DUT only – for example, the time to the end of the cable only) or a round‑trip path (total time traversed through the DUT – for example, the time to the end of the cable and back).
The query version of this command returns the string ONE if the current reflection calculation is set to one‑way and ROUND if set to round trip. Note that the distance transform always uses the one‑way path and is not impacted by this setting.
Syntax
:CALCulate:TRANsform:TIME:TRIP ONEway|ROUNDtrip
:CALCulate:TRANsform:TIME:TRIP?
Cmd Parameter
<char> ONEway|ROUNDtrip
Query Response
<char> ONE|ROUND
Default Value
ONE
Front Panel Access
Shift‑8 (System), Application Options, Time Domain, Reflection Calc in Time
 
Time Domain Processing Type
:CALCulate:TRANsform:TIME:TYPE?
Description
Queries the instrument to determine if the time domain processing currently being used is lowpass (query returns LPAS) or is bandpass (query returns BPAS).
Syntax
:CALCulate:TRANsform:TIME:TYPE?
Cmd Parameter
NA (query only)
Query Response
<char> LPAS|BPAS
Default Value
LPAS
Front Panel Access
NA
 
Time Domain Processing Mode
:CALCulate:TRANsform:TIME:TYPE:AUTO
Description
Sets the time domain transformation mode to either Auto (use parameters ON or 1) or bandpass only (use parameters OFF or 0). In Auto mode, the instrument uses lowpass time domain processing if the instrument settings allow that (which typically occurs when the sweep is a harmonic sweep). Otherwise, it uses bandpass processing. In bandpass only mode (Auto OFF), the instrument forces the processing to be always bandpass.
The query version of this command returns 1 if time domain processing is currently set to automatic, or returns a 0 if Auto mode is set to OFF (bandpass only mode).
Syntax
:CALCulate:TRANsform:TIME:TYPE:AUTO ON|OFF|1|0
:CALCulate:TRANsform:TIME:TYPE:AUTO?
Cmd Parameter
<boolean> OFF|ON|0|1
Query Response
<bNR1> 0|1
Default Value
1
Example
To set to Auto mode:
:CALCulate:TRANsform:TIME:TYPE:AUTO ON
Front Panel Access
Shift‑8 (System), Application Options, Time Domain, Domain Processing
 
 
Time Domain Window Shape
:CALCulate:TRANsform:TIME:WINDow
Description
Sets the time domain window shape (which is used for pre‑processing the frequency domain data) for all traces. Setting the window to RECTangular sets the window shape to rectangular. Setting the window to NSL sets the window shape to Nominal Side Lobe view. Setting the window to LSL sets the window shape to Low Side Lobe view. Setting the window to MSL sets the window shape to Minimum Side Lobe.
This command performs the same function as the command :CALCulate:TRANsform:DISTance:WINDow. Either command changes the window shape for both the time and distance domain traces.
The query version of this command returns RECT for Rectangular view, NSL for Nominal Side Lobe, LSL for Low Side Lobe, and MSL for Minimum Side Lobe view.
Syntax
:CALCulate:TRANsform:TIME:WINDow  RECTangular|NSL||LSL|MSL
:CALCulate:TRANsform:TIME:WINDow?
Cmd Parameter
<char> RECTangular|NSL||LSL|MSL
Query Response
<char> RECT|NSL||LSL|MSL
Default Value
NSL
Example
To set the window to rectangular:
:CALC:TRAN:TIME:WIND RECT
OR:
:CALCulate:TRANsform:TIME:WINDow RECTangular
Related Command
:CALCulate:TRANsform:DISTance:WINDow
Front Panel Access
Freq/Time/Distance, Windowing
 
 
Get Distance List
:CALCulate<Tr>:TRANsform:DISTance:DATA?
Description
Produces the distance list in meters for the given trace. <Tr> is the trace number in the range 1 to 8 (1 to 4 for Traces TR1 to TR4 and 5 to 8 for Memory M1 to M4). If no trace number is specified, then the <Tr> parameter defaults to trace number 1. The response begins with an ASCII header that specifies the number of data bytes. It appears in the format #AX, where A is the number of digits in X, and X is the number of bytes that follow the header. Each distance value is returned in scientific notation and separated by a comma delimiter.
Syntax
:CALCulate<Tr>:TRANsform:DISTance:DATA?
Cmd Parameter
NA (query only)
Query Response
<char> returns block data (meters)
Default Unit
Meters
Related Command
:CALCulate<Tr>:TRANsform:TIME:DATA?
:SENSe<Tr>:FREQuency:DATA?
Front Panel Access
NA
 
Band Pass Mode Response
:CALCulate<Tr>:TRANsform:TIME:BPASs:STIMulus
Description
Sets the response type to be used in the band pass transformation process for the given trace. The response type is set to either Standard or Phasor Impulse. <Tr> is the trace number in the range 1 to 4. If no trace number is specified, then the <Tr> parameter defaults to trace number 1. The query version of this command returns the string STAN for Standard (no phasor impulse) and PHAS for phasor impulse.
Syntax
:CALCulate<Tr>:TRANsform:TIME:BPASs:STIMulus
STANdard|PHASor
:CALCulate<Tr>:TRANsform:TIME:BPASs:STIMulus?
Cmd Parameter
<char> STANdard|PHASor
Query Response
<char> STAN|PHAS
Default Unit
STAN
Example
To Set Trace 1 to Phasor Impulse:
:CALCulate:TRANsform:TIME:BPASs:STIMulus PHASor
OR:
:CALC1:TRAN:TIME:BPAS:STIM PHAS
Related Command
:CALCulate:TRANsform:TIME:TYPE:AUTO
:CALCulate:TRANsform:TIME:TYPE?
Front Panel Access
Shift‑4 (Measure), Domain Selection, Band Pass Response
(Note that access via this key sequence requires that the domain processing be set to “Band Pass”.)
 
Get Time List
:CALCulate<Tr>:TRANsform:TIME:DATA?
Description
Produces the time list in nanoseconds for the given trace. <Tr> is the trace number in the range 1 to 8 (1 to 4 for Traces TR1 to TR4 and 5 to 8 for Memory M1 to M4). If no trace number is specified, then the <Tr> parameter defaults to trace number 1. The response begins with an ASCII header that specifies the number of data bytes. It appears in the format #AX, where A is the number of digits in X, and X is the number of bytes that follow the header. Each time value is returned in scientific notation and separated by a comma delimiter.
Syntax
:CALCulate<Tr>:TRANsform:TIME:DATA?
Cmd Parameter
NA (query only)
Query Response
<char> returns block data (nanoseconds)
Default Unit
Nanoseconds (ns)
Related Command
:CALCulate<Tr>:TRANsform:DISTance:DATA?
:SENSe<Tr>:FREQuency:DATA?
Front Panel Access
NA
 
Low Pass Mode Response
:CALCulate<Tr>:TRANsform:TIME:LPASs:STIMulus
Description
Sets the response type to be used in the low pass transformation process for the given trace. The response type is set to either Impulse or Step. <Tr> is the trace number in the range 1 to 4. If no trace number is specified, then the <Tr> parameter defaults to trace number 1. The query version of this command returns the string STEP for step response and IMP for impulse response.
Syntax
:CALCulate<Tr>:TRANsform:TIME:LPASs:STIMulus STEP|IMPulse
:CALCulate<Tr>:TRANsform:TIME:LPASs:STIMulus?
Cmd Parameter
<char> STEP|IMPulse
Query Response
<char> STEP|IMP
Default Unit
IMP
Example
To Set trace 1 to Step:
:CALCulate:TRANsform:TIME:LPASs:STIMulus STEP
OR:
:CALC1:TRAN:TIME:LPAS:STIM STEP
Related Command
:CALCulate:TRANsform:TIME:TYPE:AUTO
:CALCulate:TRANsform:TIME:TYPE?
Front Panel Access
Shift‑4 (Measure), Domain Selection, Low Pass Response
(Note that access via this key sequence requires that the domain processing be set to “Low Pass”.)