Width
- Updated2023-02-17
- 4 minute(s) read
Width
Configures common properties for width triggering.
A width trigger occurs when a pulse that crosses a vertical threshold you specify and with a polarity you specify also has a duration that is either within or outside a duration range you specify.
Inputs/Outputs
width low threshold
The lower bound, in seconds, on the range of pulse durations that triggers the oscilloscope.
Default value: 0.0
trigger coupling
The method used to couple the trigger signal.
| AC | 0 | Couples the trigger signal with an AC current. |
| DC | 1 | Couples the trigger signal with a DC current. |
| HF Reject | 3 | Couples the trigger signal with a high frequency reject filter. |
| LF Reject | 4 | Couples the trigger signal with a low frequency reject filter. |
| AC Plus HF Reject | 1001 | Couples the trigger signal with an AC current and a high frequency reject filter. |
Default value: DC
polarity
Polarity of the pulses that trigger the oscilloscope.
| Positive | Triggers on pulses of positive polarity. |
| Negative | Triggers on pulses of negative polarity. |
| Either | Triggers on pulses of positive or negative polarity. |
Default value: Positive
session in
Handle that identifies the NI-SCOPE instrument session as previously allocated by Initialize With Options .
trigger source
The source you want the digitizer to monitor for a trigger.
| Channel 0 | Monitors Channel 0 for a trigger signal. |
| Channel 1 | Monitors Channel 1 for a trigger signal. |
| Channel 2 | Monitors Channel 2 for a trigger signal. |
| Channel 3 | Monitors Channel 3 for a trigger signal. |
| Channel 4 | Monitors Channel 4 for a trigger signal. |
| Channel 5 | Monitors Channel 5 for a trigger signal. |
| Channel 6 | Monitors Channel 6 for a trigger signal. |
| Channel 7 | Monitors Channel 7 for a trigger signal. |
| External TRIG | Monitors an external trigger input for a trigger signal. |
Default value: Channel 0
trigger level
The voltage threshold for the trigger.
Default value: 0.00
width condition
Whether the oscilloscope triggers on pulses of duration within or outside the range of pulse durations bounded by width low threshold and width high threshold.
| Within | Triggers on pulses within the specified duration. |
| Outside | Triggers on pulses outside the specified duration. |
Default value: Within
error in
Error conditions that occur before this node runs.
The node responds to this input according to standard error behavior.
Default value: No error
trigger holdoff
The length of time the digitizer waits after detecting a trigger before enabling NI-SCOPE to detect another trigger.
Default value: 0.00
trigger delay
The length of time the digitizer waits after it receives the trigger to start acquiring data.
width high threshold
The upper bound, in seconds, on the range of pulse durations that triggers the oscilloscope.
Default value: 0.0
session out
Reference to the NI-SCOPE instrument session to pass to the next node in the program.
error out
Error information.
The node produces this output according to standard error behavior.
Hardware Support
This node supports the following hardware:
- PXIe-5110
- PXIe-5111
- PXIe-5113
Trigger System Operation
When you initiate an acquisition, the trigger system operates in the following manner:
- The digitizer waits for the start trigger, which is configured through the Start Trigger Source property. The default value is immediate.
- Upon receiving the start trigger, the digitizer begins sampling pretrigger points.
- After the digitizer finishes sampling pretrigger points, the digitizer waits for a reference (stop) trigger that you specify with an instance of Configure Trigger.
- Upon receiving the reference trigger and then after completing posttrigger sampling, the digitizer finishes the acquisition.
You specify configuration parameters such as the trigger source and trigger delay with each Configure Trigger instance. Additionally, you can adjust the amount of pretrigger and posttrigger samples using reference position in Configure Horizontal Timing. The default is half the record length.
For multirecord acquisitions, all records after the first record are started based on the setting of the Advance Trigger Source property. The default value is immediate.