VNA Master™Programming Manual : VNA Commands : :CALCulate<Tr>:FILTer[:GATE]:DISTance Subsystem
 
:CALCulate<Tr>:FILTer[:GATE]:DISTance Subsystem
The commands in this subsystem define the gate configuration for the distance domain.
Note 
All Front Panel Access sequences that are referenced in this subsytem require that the active trace domain is set to Distance.
Gate Center Distance
:CALCulate<Tr>:FILTer[:GATE]:DISTance:CENTer
Description
Sets the gate center distance for the given trace. <Tr> is the trace number in the range of 1 to 4. If no trace number is specified, then the <Tr> parameter defaults to trace number 1. The query version of this commands returns the current gate center in millimeters. Note that setting this may also change the gate start, stop, and span for both time and distance gates. If gate coupling is on, then setting the gate center distance also sets the same gate center distance for all traces. Note that setting this also sets the given trace as the active trace if it is not already active.
Note that the command :CALCulate<Tr>:FILTer[:GATE]:TIME:CENTer functions the same as this command. The only difference is that with this command, you must send the center in distance units rather than time units.
Syntax
:CALCulate<Tr>:FILTer[:GATE]:DISTance:CENTer  <center distance>
:CALCulate<Tr>:FILTer[:GATE]:DISTance:CENTer?
Cmd Parameter
<NRf> <center distance>
Query Response
<NR3> <center distance> (returned in millimeters)
Range
– 3000.0 m to + 3000 m
Default Value
2055 mm
Default Unit
Meters (m) when setting. Millimeters (mm) for query. Note that if the distance unit is in feet, then both setting and query are in feet.
Gate Center Distance (continued)
Example
To set the gate center distance for Trace 4 to 12.5 m:
:CALCulate4:FILTer:GATE:DISTance:CENTer 12500 mm
or
:CALC4:FILT:GATE:DIST:CENT 12.5
After either of these two example commands, the following query:
:CALCulate4:FILTer:GATE:DISTance:CENTer?
Returns the result: 12500
To set the gate center distance for Trace 2 to 20.5 ft:
:CALCulate2:FILTer:GATE:DISTance:CENTer 20.5 ft
The query is:
CALCulate2:FILTer:GATE:DISTance:CENTer?
Return Value: 6248.4 (in units of mm, if instrument distance unit setting is meters)
Return Value: 20.5 (in units of ft, if instrument distance unit setting is feet)
Related Command
:CALCulate<Tr>:FILTer[:GATE]:TIME:CENTer
:CALCulate:TRANsform:DISTance:UNIT
Front Panel Access
Freq/Time/Dist, Gate, Center Gate
 
Distance Domain Gate Notch State
:CALCulate<Tr>:FILTer[:GATE]:DISTance:NOTCh
Description
Sets the gate into notch mode for the given trace. Setting the value to ON or to 1 turns on the gate into a notch (in other words, the gate suppresses rather than passes through the time domain data within the start/stop gate settings). Setting the value to OFF or to 0 turns off the gate notch mode. The query version of this command returns 1 if gate notch is on, otherwise returns 0 for off. Note that if gate coupling is on, then setting the gate notch of one trace also sets the gate notch of all other traces. Also note that setting this also sets the given trace as the active trace if it is not already active.
Note that the command :CALC<Tr>:FILT[:GATE]:TIME:NOTC functions the same as this command.
Syntax
:CALCulate<Tr>:FILTer[:GATE]:DISTance:NOTCh ON|OFF|1|0
:CALCulate<Tr>:FILTer[:GATE]:DISTance:NOTCh?
Cmd Parameter
<boolean> ON|OFF|1|0
Query Response
<bNR1> 1|0
Default Value
0
Example
To set the gate notch to ON for Trace 3:
:CALC3:FILT:GATE:DIST:NOTC ON
Related Command
:CALC<Tr>:FILT[:GATE]:TIME:NOTC
Front Panel Access
Freq/Time/Dist, Gate, Gate Notch
 
Distance Domain Gate Shape
:CALCulate<Tr>:FILTer[:GATE]:DISTance:SHAPe
Description
Sets the gate shape for the given trace. The query version of this command returns the string “MAX” if the current gate shape is set to maximum, “WIDE” if set to wide, “NORM” if set to nominal, and “MIN” if set to minimum. Note that if gate coupling is on, then setting the gate shape of one trace also sets the gate shape of all other traces. Also note that setting this also sets the given trace as the active trace if it is not already active.
Note that the command :CALC<Tr>:FILT[:GATE]:TIME:SHAP functions the same as this command.
Syntax
:CALCulate<Tr>:FILTer[:GATE]:DISTance:SHAPe  MAXimum|WIDE|NORMal|MINimum
:CALCulate<Tr>:FILTer[:GATE]:DISTance:SHAPe?
Cmd Parameter
<char> MAXimum|WIDE|NORMal|MINimum
Query Response
<char> MAX|WIDE|NORM|MIN
Default Value
NORM
Example
To set the gate shape to Maximum for Trace 1:
:CALC:FILT:DIST:SHAP MAX
Related Command
:CALC<Tr>:FILT[:GATE]:TIME:SHAP
Front Panel Access
Freq/Time/Dist, Gate, Gate Shape
 
Gate Span Distance
:CALCulate<Tr>:FILTer[:GATE]:DISTance:SPAN
Description
Sets the gate span distance for the given trace. <Tr> is the trace number in the range of 1 to 4. If no trace number is specified, then the <Tr> parameter defaults to trace number 1. The query version of this commands returns the current gate span in millimeters. Note that setting this may also change the gate start, stop, and center for both time and distance gates. If gate coupling is on, then setting the gate span also sets the same gate span for all traces. Note that setting this also sets the given trace as the active trace if it is not already active.
Note that the command :CALCulate<Tr>:FILTer[:GATE]:TIME:SPAN functions the same as this command. The only difference is that with this command, you must send the span in distance units rather than time units.
Syntax
:CALCulate<Tr>:FILTer[:GATE]:DISTance:SPAN <span distance>
:CALCulate<Tr>:FILTer[:GATE]:DISTance:SPAN?
Cmd Parameter
<NRf> <span distance>
Query Response
<NR3> <span distance>
Range
0 m to 3000 m
Default Value
4110 mm
Default Unit
Meters (m) when setting. Millimeters (mm) for query. Note that if the distance unit is in feet, then both setting and query are in feet.
Example
To set the gate span distance for Trace 3 to 7 m:
:CALC3:FILT:DIST:SPAN 7
Related Command
:CALCulate<Tr>:FILTer[:GATE]:TIME:SPAN
Front Panel Access
Freq/Time/Dist, Gate, Span Gate
 
Gate Start Distance
:CALCulate<Tr>:FILTer[:GATE]:DISTance:STARt
Description
Sets the gate start distance for the given trace. <Tr> is the trace number in the range of 1 to 4. If no trace number is specified, then the <Tr> parameter defaults to trace number 1. The query version of this commands returns the current gate start distance in millimeters. Note that setting this may also change the gate span, stop, and center for both time and distance gates. If gate coupling is on, then setting the gate start distance also sets the same gate start distance for all traces. Note that setting this also sets the given trace as the active trace if it is not already active.
Note that the command :CALCulate<Tr>:FILTer[:GATE]:TIME:STARt functions the same as this command. The only difference is that with this command, you must send the start in distance units rather than time units.
Syntax
:CALCulate<Tr>:FILTer[:GATE]:DISTance:STARt  <start distance>
:CALCulate<Tr>:FILTer[:GATE]:DISTance:STARt?
Cmd Parameter
<NRf> <start distance>
Query Response
<NR3> <start distance> (returned in millimeters)
Range
– 3000.0 m to + 3000 m
Default Value
1370 mm
Default Unit
Meters (m) when setting. Millimeters (mm) for query. Note that if the distance unit is in feet, then both setting and query are in feet.
Example
To set the gate start distance for Trace 1 to 2 meter:
:CALC:FILT:GATE:DIST:STAR 2
OR
:CALC:FILT:GATE:DIST:STAR 2000mm
Related Command
:CALCulate<Tr>:FILTer[:GATE]:TIME:STARt
Front Panel Access
Freq/Time/Dist, Gate, Start Gate
 
Distance Domain Gate Display Settings
:CALCulate<Tr>:FILTer[:GATE]:DISTance:STATe
Description
Sets the gate display settings for the given trace. The gate can be either OFF, in DISPlay mode, or ON. In DISPLay mode, the gate is shown on the trace but is not applied to the transform. When set to ON, the gate is shown and applied to the transform. <Tr> is the trace number in the range of 1 to 4. If no trace number is specified, then the <Tr> parameter defaults to trace number 1. Note that setting this also sets the given trace as the active trace if it is not already active.
Syntax
:CALCulate<Tr>:FILTer[:GATE]:DISTance:STATe  OFF|DISPlay|ON
:CALCulate<Tr>:FILTer[:GATE]:DISTance:STATe?
Cmd Parameter
<char> OFF|DISPlay|ON
Query Response
<char> OFF|DISP|ON
Default Value
OFF
Example
To set Trace 2 to DISPlay view:
:CALC2:FILT:GATE:DIST:STAT DISP
Front Panel Access
Freq/Time/Dist, Gate, Gate Function
 
Gate Stop Distance
:CALCulate<Tr>:FILTer[:GATE]:DISTance:STOP
Description
Sets the gate stop distance for the given trace. <Tr> is the trace number in the range of 1 to 4. If no trace number is specified, then the <Tr> parameter defaults to trace number 1. The query version of this commands returns the current gate stop distance in millimeters. Note that setting this may also change the gate span, start, and center for both time and distance gates. If gate coupling is on, then setting the gate stop distance also sets the same gate stop distance for all traces. Note that setting this also sets the given trace as the active trace if it is not already active.
Note that the command :CALCulate<Tr>:FILTer[:GATE]:TIME:STOP functions the same as this command. The only difference is that with this command, you must send the stop in distance units rather than time units.
Syntax
:CALCulate<Tr>:FILTer[:GATE]:DISTance:STOP  <stop distance>
:CALCulate<Tr>:FILTer[:GATE]:DISTance:STOP?
Cmd Parameter
<NRf> <stop distance>
Query Response
<NR3> <stop distance>> (returned in millimeters)
Range
– 3000.0 m to + 3000 m
Default Value
5480 mm
Default Unit
Meters (m) when setting. Millimeters (mm) for query. Note that if the distance unit is in feet, then both setting and query are in feet.
Example
To set the gate stop distance for Trace 4 to 10 meter:
:CALC4:FILT:GATE:DIST:STOP 10
Related Command
:CALCulate<Tr>:FILTer[:GATE]:TIME:STOP
Front Panel Access
Freq/Time/Dist, Gate, Stop Gate