VNA Master™Programming Manual : VNA Commands : :CALCulate<Tr>:FILTer[:GATE]:TIME Subsystem
 
:CALCulate<Tr>:FILTer[:GATE]:TIME Subsystem
The commands in this subsystem define the gate configuration for the time domain.
Note 
All Front Panel Access sequences that are referenced in this subsytem require that the active trace domain is set to Time.
Gate Center Time
:CALCulate<Tr>:FILTer[:GATE]:TIME:CENTer
Description
Sets the gate center time 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 command returns the current gate center in nanoseconds. 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 time also sets the same gate center time 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]:DISTance:CENTer functions the same as this command. The only difference is that with this command, you must send the center in time units rather than distance units.
Syntax
:CALCulate<Tr>:FILTer[:GATE]:TIME:CENTer <center time>
:CALCulate<Tr>:FILTer[:GATE]:TIME:CENTer?
Cmd Parameter
<NRf> <center time>
Query Response
<NR3> <center time> (time returned in nanoseconds)
Range
– 100 ms to + 100 ms
Default Value
6 ns
Default Unit
Seconds (s) when setting, nanoseconds (ns) for query.
Example
To set the gate center time for trace number 2 to 15 ns:
:CALC2:FILT:TIME:CENT 15ns
Related Command
:CALCulate<Tr>:FILTer[:GATE]:DISTance:CENTer
Front Panel Access
Freq/Time/Dist, Gate, Center Gate
 
Time Domain Gate Notch State
:CALCulate<Tr>:FILTer[:GATE]:TIME: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. 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]:DIST:NOTC functions the same as this command.
Syntax
:CALCulate<Tr>:FILTer[:GATE]:TIME:NOTCh ON|OFF|1|0
:CALCulate<Tr>:FILTer[:GATE]:TIME:NOTCh?
Cmd Parameter
<boolean> ON|OFF|1|0
Query Response
<bNR1> 1|0
Default Value
0
Example
To set the gate notch for Trace 3 to OFF:
:CALC3:FILT:GATE:TIME:NOTC 0
OR
:CALC3:FILT:GATE:TIME:NOTC OFF
Related Command
:CALC<Tr>:FILT[:GATE]:DIST:NOTC
Front Panel Access
Freq/Time/Dist, Gate, Gate Notch
 
Time Domain Gate Shape
:CALCulate<Tr>:FILTer[:GATE]:TIME: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. Note that setting this also sets the given trace as the active trace if it is not already active. Also note that the command :CALC<Tr>:FILT[:GATE]:DIST:SHAP functions the same as this command.
Syntax
:CALCulate<Tr>:FILTer[:GATE]:TIME:SHAPe  MAXimum|WIDE|NORMal|MINimum
:CALCulate<Tr>:FILTer[:GATE]:TIME: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:TIME:SHAP MAX
Related Command
:CALC<Tr>:FILT[:GATE]:DIST:SHAP
Front Panel Access
Freq/Time/Dist, Gate, Gate Shape
 
Gate Span Time
:CALCulate<Tr>:FILTer[:GATE]:TIME:SPAN
Description
Sets the gate span time 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 command returns the current gate span in nanoseconds. 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]:DISTance:SPAN functions the same as this command. The only difference is that with this command, you must send the span in time units rather than distance units.
Syntax
:CALCulate<Tr>:FILTer[:GATE]:TIME:SPAN <span time>
:CALCulate<Tr>:FILTer[:GATE]:TIME:SPAN?
Cmd Parameter
<NRf> <span time>
Query Response
<NR3> <span time> (time returned in nanoseconds)
Range
0 ms to 2000 ns
Default Value
12 ns
Default Unit
Seconds (s) when setting, nanoseconds (ns) for query.
Example
To set the gate span time for Trace number 3 to 6 ns:
:CALC3:FILT:GATE:TIME:SPAN 6ns
Related Command
:CALCulate<Tr>:FILTer[:GATE]:DISTance:SPAN
Front Panel Access
Freq/Time/Dist, Gate, Span Gate
 
Gate Start Time
:CALCulate<Tr>:FILTer[:GATE]:TIME:STARt
Description
Sets the gate start time 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 command returns the current gate start time in nanoseconds. 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 time also sets the same gate start time 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]:DISTance:STARt functions the same as this command. The only difference is that with this command, you must send the start in time units rather than distance units.
Syntax
:CALCulate<Tr>:FILTer[:GATE]:TIME:STARt <start time>
:CALCulate<Tr>:FILTer[:GATE]:TIME:STARt?
Cmd Parameter
<NRf> <start time>
Query Response
<NR3> <start time> (time returned in nanoseconds)
Range
– 100 ms to + 100 ms
Default Value
4 ns
Default Unit
Seconds (s) when setting, nanoseconds (ns) for query.
Example
To set the gate start time for Trace 2 to 6 ns:
:CALC2:FILT:GATE:TIME:STAR 6ns
Related Command
:CALCulate<Tr>:FILTer[:GATE]:DISTance:STARt
Front Panel Access
Freq/Time/Dist, Gate, Start Gate
 
Time Domain Gate Display Setting
:CALCulate<Tr>:FILTer[:GATE]:TIME:STATe
Description
Sets the gate display settings for the given trace. The gate can be 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. Also note that the command :CALC<Tr>:FILT[:GATE]:DIST:STAT functions the same as this command.
Syntax
:CALCulate<Tr>:FILTer[:GATE]:TIME:STATe OFF|DISPlay|ON
:CALCulate<Tr>:FILTer[:GATE]:TIME: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:TIME:STAT DISP
Related Command
:CALC<Tr>:FILT[:GATE]:DIST:STAT
Front Panel Access
Freq/Time/Dist, Gate, Gate Function
 
Gate Stop Time
:CALCulate<Tr>:FILTer[:GATE]:TIME:STOP
Description
Sets the gate stop time 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 time in nanoseconds. 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 time also sets the same gate stop time 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]:DISTance:STOP functions the same as this command. The only difference is that with this command, you must send the stop in time units rather than distance units.
Syntax
:CALCulate<Tr>:FILTer[:GATE]:TIME:STOP <stop time>
:CALCulate<Tr>:FILTer[:GATE]:TIME:STOP?
Cmd Parameter
<NRf> <stop time>
Query Response
<NR3> <stop time> (time returned in nanoseconds)
Range
– 100 ms to + 100 ms
Default Value
16 ns
Default Unit
Seconds (s) when setting, nanoseconds (ns) for query.
Example
To set the gate stop time for Trace 2 to 6 ns:
:CALC2:FILT:GATE:TIME:STOP 6ns
Related Command
:CALCulate<Tr>:FILTer[:GATE]:DISTance:STOP
Front Panel Access
Freq/Time/Dist, Gate, Stop Gate