Trigger

src.trigger.trigger(oscope, sweep: str | None = None, noisereject: bool | None = None, mode: str | None = None, holdoff: float | None = None, coupling: str | None = None, source: int | str | None = None, slope: str | None = None, level: float | None = None, when: str | None = None, upper: float | None = None, lower: float | None = None, window: str | None = None, alevel: float | None = None, blevel: float | None = None, time: float | None = None)[source]

Send commands to control an oscilloscope’s triggering behavior. The EDGE, PULSe, and SLOPe trigger modes are supported. All arguments are optional. Depending on the triggering mode, only the applicable arguments are utilized by the relevant helper function.

Parameters:

  • sweep (str) – :TRIGger:SWEep

  • noisereject (bool) – :TRIGger:NREJect

  • mode (str) – :TRIGger:MODE

  • holdoff (float) – See trigger_edge.

  • coupling (str) – See trigger_edge.

  • source (int, str) – See helper functions.

  • slope (str) – See trigger_edge.

  • level (float) – See trigger_edge, trigger_pulse.

  • when (str) – See trigger_pulse, trigger_slope.

  • upper (float) – See trigger_pulse, trigger_slope.

  • lower (float) – See trigger_pulse, trigger_slope.

  • window (str) – See trigger_slope.

  • alevel (float) – See trigger_slope.

  • blevel (float) – See trigger_slope.

  • time (float) – See trigger_slope.

Returns:

A namedtuple with fields corresponding to the named arguments of this function. All fields applicable to the active mode are queried regardless of which arguments were initially provided; fields for other modes are None. The status field is additionally provided as a result of the query :TRIGger:STATus?.

src.trigger.trigger_edge(oscope, trigger_query, holdoff, coupling, source, slope, level)[source]

Helper function to configure edge-triggering, :TRIGger:MODE EDGE.

Parameters:

  • holdoff (float) – :TRIGger:HOLDoff

  • coupling (str) – :TRIGger:COUPling

  • source (int, str) – :TRIGger:EDGe:SOURce

  • slope (str) – :TRIGger:EDGe:SLOPe

  • level (float) – :TRIGger:EDGe:LEVel

src.trigger.trigger_pulse(oscope, trigger_query, source, when, level, upper, lower)[source]

Helper function to configure pulse-width triggering, :TRIGger:MODE PULSe.

Parameters:

  • source (int, str) – :TRIGger:PULSe:SOURce

  • when (str) – :TRIGger:PULSe:WHEN (e.g. PGReater, PLESs, PGLess).

  • level (float) – :TRIGger:PULSe:LEVel

  • upper (float) – :TRIGger:PULSe:UWIDth

  • lower (float) – :TRIGger:PULSe:LWIDth

src.trigger.trigger_slope(oscope, trigger_query, source, when, time, upper, lower, window, alevel, blevel)[source]

Helper function to configure slope (rise/fall time) triggering, :TRIGger:MODE SLOPe.

Parameters:

  • source (int, str) – :TRIGger:SLOPe:SOURce

  • when (str) – :TRIGger:SLOPe:WHEN (e.g. PGReater, PLESs, PGLess).

  • time (float) – :TRIGger:SLOPe:TIME

  • upper (float) – :TRIGger:SLOPe:TUPPer

  • lower (float) – :TRIGger:SLOPe:TLOWer

  • window (str) – :TRIGger:SLOPe:WINDow (TA, TB, or TAB).

  • alevel (float) – :TRIGger:SLOPe:ALEVel

  • blevel (float) – :TRIGger:SLOPe:BLEVel