navigate.model.devices.filter_wheel.ludl.LUDLFilterWheel

class navigate.model.devices.filter_wheel.ludl.LUDLFilterWheel(device_connection, device_config)

Bases: FilterWheelBase

LUDLFilterWheel - Class for controlling LUDL Electronic Products Filter Wheels

Testing using MAC6000 controller over RS-232. USB or Ethernet not tested. Single filter wheel only, but MAC6000 can handle max 2. Would need to modify code.

Note

Code for class adapted from Dr. Fabian Voigt’s mesoSPIM code: https://github.com/ffvoigt/mesoSPIM-control/blob/master/mesoSPIM/src/mesoSPIM_FilterWheel.py

__init__(device_connection, device_config)

Initialize the LUDLFilterWheel class.

Parameters:

• device_connection (serial.Serial) – Serial port connection to the filter wheel.

• device_config (dict) – Dictionary of device configuration parameters.

Methods

__init__(device_connection, device_config)	Initialize the LUDLFilterWheel class.
check_if_filter_in_filter_dictionary(filter_name)	Checks if the filter designation (string) given exists in the filter dictionary
close()	Close the LUDLFilterWheel serial port.
set_filter(filter_name[, wait_until_done])	Set the filter wheel to a specific filter position.

Attributes

serial	Serial port connection to the filter wheel.
device_config	Configuration dictionary.
sio	Text I/O wrapper for the serial port.
wait_until_done_delay	Delay for filter wheel to change positions.

check_if_filter_in_filter_dictionary(filter_name: str) → bool

Checks if the filter designation (string) given exists in the filter dictionary

Parameters:

filter_name (str) – Name of filter.

Returns:

filter_exists – Flag if filter exists in the filter dictionary.

Return type:

bool

Raises:

ValueError – If filter name is not in the filter dictionary.

close()

Close the LUDLFilterWheel serial port.

Sets the filter wheel to the Empty-Alignment position and then closes the port.

set_filter(filter_name, wait_until_done=True)

Set the filter wheel to a specific filter position.

Parameters:

• filter_name (str) – Name of the filter position.

• wait_until_done (bool) – Wait until the filter wheel has changed positions.

device_config

Configuration dictionary.

Type:

dict

device_connection

Device connection object.

Type:

Any

filter_dictionary

Dictionary of filters available on the filter wheel.

Type:

dict

filter_wheel_number

index of filter wheel

Type:

int

serial

Serial port connection to the filter wheel.

Type:

obj

sio

Text I/O wrapper for the serial port.

Type:

io.TextIOWrapper

wait_until_done_delay

Delay for filter wheel to change positions.

Type:

float

wheel_position

Filter wheel position.

Type:

int