fixate.drivers.dso package¶
Submodules¶
fixate.drivers.dso.agilent_mso_x module¶
- class fixate.drivers.dso.agilent_mso_x.MSO_X_3000(instrument)¶
Bases:
DSO- INSTR_TYPE = 'VISA'¶
- REGEX_ID = '(KEYSIGHT|AGILENT) TECHNOLOGIES,[DM]SO-?X'¶
- acquire(acquire_type='normal', averaging_samples=0)¶
- :param channel
string indicating the channel eg. 1, 2, 3, 4, FUNC,(FUNC,includes MATH,functions)
- Parameters:
acquire_type – “normal” “averaging” “hresolution” - High Resolution “peak” - Peak Detect
averaging_samples – averaging_samples: number of samples used when acquire_type is set to averaging
- Returns:
- auto_scale()¶
- digitize(signals)¶
- get_identity() str¶
- Returns:
AGILENT TECHNOLOGIES,<model>,<serial number>,X.XX.XX <model> ::= the model number of the instrument <serial number> ::= the serial number of the instrument <X.XX.XX> ::= the software revision of the instrument
- load_setup(file_name)¶
- query(value)¶
- query_after_acquire(base_str, *args, **kwargs)¶
- query_ascii_value(value)¶
- query_ascii_values(value)¶
- query_binary_values(value)¶
- query_bool(value)¶
- query_value(base_str, *args, **kwargs)¶
- read_raw()¶
- reset()¶
- retrys_on_timeout = 1¶
- run()¶
- save_setup(file_name)¶
- single()¶
Sets up the oscilliscope for a single shot triggered measurement Does multiple steps to ensure that at the end of this call that the oscilloscope is primed for a trigger 1. Sets mode to stop to ensure that only one measurement will occur 2. Clears the status registers 3. Sets the mode to single 4. Monitors the registers until the trigger is armed :return:
- stop()¶
- store(store_dict, *args, **kwargs)¶
Store a dictionary of values in TestClass :param kwargs: Dictionary containing the parameters to store :return:
- store_and_write(params, *args, **kwargs)¶
- validate_signal(signal)¶
- Parameters:
signal – String ie. “1”, “2”, “3”, “4”, “func”, “math”
- Returns:
- wait_for_acquire()¶
- wait_for_trigger(timeout)¶
Waits for trigger for a set amount of time. If no trigger occurs, cancel the current measurement request Two options available: self._trigger_event(timeout) # Uses PyVisa Events self._trigger_poll(timeout) # Polls :TER? register :param timeout: timeout in seconds waiting for a trigger Exception raised on timeout :return:
- waveform_preamble()¶
- waveform_values(signal, file_name='', file_type='csv')¶
Retrieves currently present waveform data from the specified channel and optionally saves it to a file. The oscilliscope must be in the stopped state to retrive waveform data.
This method queries the instrument for raw data points, scales them using the waveform preamble (origin, increment, and reference values), and converts them into time and voltage arrays.
- Parameters:
signal (str|int) – The source channel (e.g., 1, “2”).
file_name (str, optional) – The path/name of the file to save data to. Defaults to “”, which skips file saving.
file_type (str, optional) – The format for the output file. Supported: “csv”. Defaults to “csv”.
- Returns:
A tuple containing (time_values, values) as lists of floats.
- Return type:
tuple
- Raises:
ValueError – If no data is available on the selected channel.
NotImplementedError – If an unsupported file_type is requested.
- write(base_str, *args, **kwargs)¶
fixate.drivers.dso.helper module¶
- class fixate.drivers.dso.helper.Acquire¶
Bases:
object- averaging(value: float | int)¶
- high_resolution()¶
- normal()¶
- peak_detect()¶
- class fixate.drivers.dso.helper.CallableBool¶
Bases:
object
- class fixate.drivers.dso.helper.CallableNoArgs¶
Bases:
object
- class fixate.drivers.dso.helper.ChannelBase(channel_name: str)¶
Bases:
CallableBool- bandwidth(value: float | int)¶
- bandwidth_limit(value: bool)¶
- impedance(value: float | int)¶
- invert(value: bool)¶
- offset(value: float | int)¶
- scale(value: float | int)¶
- class fixate.drivers.dso.helper.DSO(instrument)¶
Bases:
object- REGEX_ID = 'DSO'¶
- abstract acquire(acquire_type, averaging_samples)¶
- abstract auto_scale()¶
- abstract get_identity()¶
- init_api()¶
- abstract load_setup(file_name)¶
- offset(value: float | int)¶
- prepare_string(func, handler, base_str, *args, **kwargs)¶
- abstract reset()¶
- run()¶
- abstract save_setup(file_name)¶
- scale(value: float | int)¶
- single()¶
- stop()¶
- abstract waveform_values(source, filename)¶
- class fixate.drivers.dso.helper.Define¶
Bases:
object
- class fixate.drivers.dso.helper.Delay¶
Bases:
CallableNoArgs
- class fixate.drivers.dso.helper.Events¶
Bases:
object- trigger()¶
Indicates if a trigger event has occurred. Calls to this will clear the existing trigger events :return:
- class fixate.drivers.dso.helper.Measure¶
Bases:
object- vtime(time: float, channel: int)¶
Return the y value of a channel at the requested time.
- class fixate.drivers.dso.helper.MeasureAllSources¶
Bases:
SourcesCh,SourcesSpecial,SourcesWMem,SourcesDig,CallableNoArgs
- class fixate.drivers.dso.helper.MeasureInterval¶
Bases:
object
- class fixate.drivers.dso.helper.MeasureIntervalMultipleSources¶
Bases:
object
- class fixate.drivers.dso.helper.MeasureRMS¶
Bases:
object
- class fixate.drivers.dso.helper.MultiMeasureSources¶
Bases:
MeasureAllSources
- class fixate.drivers.dso.helper.MultiSlopes¶
Bases:
CallableNoArgs
- class fixate.drivers.dso.helper.SourcesDig¶
Bases:
object- d0()¶
- d1()¶
- d10()¶
- d11()¶
- d12()¶
- d13()¶
- d14()¶
- d15()¶
- d2()¶
- d3()¶
- d4()¶
- d5()¶
- d6()¶
- d7()¶
- d8()¶
- d9()¶
- class fixate.drivers.dso.helper.Threshold¶
Bases:
object- absolute(upper: float | int, middle: float | int, lower: float | int)¶
- Parameters:
upper – Upper Threshold
middle – Middle Threshold
lower – Lower Threshold
- Returns:
- percent(upper: float | int, middle: float | int, lower: float | int)¶
- Parameters:
upper – Upper Threshold
middle – Middle Threshold
lower – Lower Threshold
- Returns:
- class fixate.drivers.dso.helper.Timebase¶
Bases:
object- position(value: float | int)¶
- scale(value: float | int)¶
- class fixate.drivers.dso.helper.TrigEdge¶
Bases:
CallableNoArgs- level(value: float | int)¶
- class fixate.drivers.dso.helper.TrigLevel¶
Bases:
object- high(value: float | int)¶
- low(value: float | int)¶
- class fixate.drivers.dso.helper.TrigMode¶
Bases:
object
- class fixate.drivers.dso.helper.TrigSources¶
Bases:
SourcesCh,SourcesExt,SourcesDig