Rigol

RigolDS1000Series Oscilloscope

class instruments.rigol.RigolDS1000Series(filelike, *args, **kwargs)

The Rigol DS1000-series is a popular budget oriented oscilloscope that has featured wide adoption across hobbyist circles.

Warning

This instrument is not complete, and probably not even functional!

class AcquisitionType(*values)

Enum containing valid acquisition types for the Rigol DS1000

average = 'AVER'

normal = 'NORM'

peak_detect = 'PEAK'

class Channel(parent, idx)

Class representing a channel on the Rigol DS1000.

This class inherits from DataSource.

Warning

This class should NOT be manually created by the user. It is designed to be initialized by the RigolDS1000Series class.

class Coupling(*values)

Enum containing valid coupling modes for the Rigol DS1000

ac = 'AC'

dc = 'DC'

ground = 'GND'

query(cmd)

Passes a command from the Channel class to the parent RigolDS1000Series, appending the required channel identification.

Parameters:

cmd (str) – The command string to send to the instrument

Returns:

The result as returned by the instrument

Return type:

str

sendcmd(cmd)

Passes a command from the Channel class to the parent RigolDS1000Series, appending the required channel identification.

Parameters:

cmd (str) – The command string to send to the instrument

property bw_limit

property coupling

Gets/sets the coupling setting for the oscilloscope. This is an abstract method.

Type:

Enum

property display

property filter

property invert

property vernier

class DataSource(parent, name)

Class representing a data source (channel, math, or ref) on the Rigol DS1000

Warning

This class should NOT be manually created by the user. It is designed to be initialized by the RigolDS1000Series class.

read_waveform(bin_format=True)

Gets the waveform of the specified data source channel. This is an abstract property.

Parameters:

bin_format (bool) – If the waveform should be transfered in binary (True) or ASCII (False) formats.

Returns:

The waveform with both x and y components.

Return type:

numpy.ndarray

property name

Gets the name of the channel. This is an abstract property.

Type:

str

force_trigger()

Forces a trigger event to occur on the attached oscilloscope.

release_panel()

Releases any lockout of the local control panel.

run()

Starts running the oscilloscope trigger.

stop()

Stops running the oscilloscope trigger.

property acquire_averages

Gets/sets the number of averages the oscilloscope should take per acquisition.

Type:

int

property acquire_type

property channel

Gets an iterator or list for easy Pythonic access to the various channel objects on the oscilloscope instrument. Typically generated by the ProxyList helper.

property math

Gets an iterator or list for easy Pythonic access to the various math data sources objects on the oscilloscope instrument. Typically generated by the ProxyList helper.

property panel_locked

property ref

Gets an iterator or list for easy Pythonic access to the various ref data sources objects on the oscilloscope instrument. Typically generated by the ProxyList helper.