poulet_py.hardware.stimulator package

class Arduino(ports=None)

Bases: object

__init__(ports=None)

Initialize the Arduino class with the given ports.

Args:

ports (list): List of serial port addresses.

close_port()

Close all serial connections.

log_error(error_message)

read_data(data_parser=<class 'float'>)

Read data from the Arduino and parse it.

Args:

data_parser (callable): Function to parse the data read from the Arduino.

Defaults to float.

Sets:

self.parsed_data: Parsed data from Arduino.

save_data(data)

Save the data to a CSV file.

Args:

timestamp: The timestamp to be saved.

set_error_log_path(folder_path, error_file_name)

Set the error log path for the Arduino.

Args:

folder_path (str): Path to the folder where the error log will be stored. error_file_name (str): Name of the error log file.

set_output_file(path, extra_name, data_columns=['data'], base_file_name='arduino')

Set the output file for the Arduino.

Args:

path (str): Path to the folder where the output file will be saved. extra_name (str): An additional name to be added to the base file name. base_file_name (str): Base name of the output file. Defaults to ‘arduino’.

set_timer(start_time)

Sets the timer for the camera.

Args:

start_time (float): The time at which the camera recording started.

class JulaboChiller(port=None, baudrate=9600, timeout=1)

Bases: object

Class to interact with a Julabo water chiller via serial port.

__init__(port=None, baudrate=9600, timeout=1)

Initialize the JulaboChiller with the given serial port configuration.

Args:

port (str): The serial port (e.g., ‘COM12’). baudrate (int, optional): The baud rate for the serial communication. Default is 9600. timeout (int or float, optional): The read timeout value. Default is 1 second.

check_started()

Check whether the chiller has started.

Returns:

str: The started status.

check_status()

Check the status of the chiller.

Returns:

str: The status information.

check_version()

Check the version of the chiller.

Returns:

str: The version information.

close_port()

Close the serial port connection.

get_target_temperature()

Get the target temperature set point.

Returns:

str: The target temperature.

get_temperature()

Get the current temperature from the chiller.

Returns:

str: The current temperature reported by the chiller.

read()

Read data from the chiller.

Returns:

str: The response from the chiller, or None if no data is available.

save_temperature(timestamp, temperature)

Save the temperature to a CSV file.

Args:

timestamp: The timestamp to be saved. temperature: The temperature to be saved.

set_error_log_path(path, file_name)

Sets the path for the error log file.

Args:

path (str): The directory where the error log file will be saved.

set_output_file(path, extra_name, base_file_name='julabo_chiller')

Sets the output file for recording the video.

Args:

path (str): The directory where the output file will be saved.

set_temperature(temperature)

Set the temperature of the chiller.

Args:

temperature (float): The temperature to set (in Celsius).

set_timer(start_time)

Set the timer for the chiller.

Args:

start_time (float): The start time of the experiment.

start()

Turn on the chiller.

stop()

Turn off the chiller.

write(command)

Write a command to the chiller.

Args:

command (str): The command to send to the chiller.

class TCS(port, *, maximum_temperature=40.0, beep=False, trigger_out_channel=255, read_timeout=2.0, response_timeout=2.0, stimulus_trigger=None)

Bases: object

Interface for communicating with a TCS thermal stimulator.

Parameters:

• port (str) – Serial port to which the device is connected.

• maximum_temperature (float, optional) – Maximum allowed temperature in °C (default: 40).

• beep (bool, optional) – Whether to enable audible beeps (default: False).

• trigger_out_channel (int, optional) – Output channel for trigger signals (default: 255).

• read_timeout (float, optional) – Timeout for read operations in seconds (default: 2).

• response_timeout (float, optional) – Timeout for device responses in seconds (default: 2).

• stimulus_trigger (BaseTrigger, optional) – A Trigger found in poulet_py/hardware/triggers to trigger the next stimulus.

init() → None

Initialize the TCS connection and verify communication.

close() → None

Close the connection and clean up resources.

info() → str

Get device information including firmware version and probe details.

reset() → None

Reset the TCS device to its default state.

trigger() → None

Execute the configured stimulation.

get_readings() → dict

Get current temperature readings from all sensors.

Examples

>>> with TCS(port="/dev/ttyUSB0") as tcs:
>>>     tcs.init()
>>>     stimulus = TCSStimulus(surface=1, target=35.0)
>>>     tcs.stimulus = stimulus
>>>     tcs.trigger()
>>>     readings = tcs.get_readings()
>>>     print(readings)

__init__(port, *, maximum_temperature=40.0, beep=False, trigger_out_channel=255, read_timeout=2.0, response_timeout=2.0, stimulus_trigger=None)

close()

Close the connection and clean up resources.

execute_command(command, *args, expected_pattern=None)

Execute a command and optionally wait for a response.

Parameters:

• command (TCSCommand) – The command to execute

• *args – Arguments to format into the command

• expected_pattern (Pattern | None) – Regex pattern to match against the response

Returns:

If expected_pattern provided, returns (timestamp, match) tuple

Return type:

tuple[int, Match[str]]] | None

Examples

>>> tcs.execute_command(TCSCommand.READ_INFO, expected_pattern=compile(r"Firmware:(.*)"))

get_readings()

Get current temperature readings from all sensors.

Returns:

Dictionary containing temperatures for neutral and all surfaces, plus a timestamp key.

Return type:

Dict[str, float]

Raises:

RuntimeError – If reading temperatures fails

info()

Get device information including firmware version and probe details.

Returns:

Device information string

Return type:

str

Raises:

RuntimeError – If the info command fails or times out

init()

Initialize the TCS connection and verify communication.

Raises:

RuntimeError – If initialization fails

reset()

Reset the TCS device to its default state.

property stimulus: TCSStimulus

trigger()

Execute the configured stimulation.

Raises:

RuntimeError – If stimulation fails to trigger

write(command)

Write a command to the TCS device.

Parameters:

command (bytes) – The command to send

Returns:

Number of bytes written

Return type:

int

Raises:

RuntimeError – If the write operation fails

class TCSCommand(*values)

Bases: bytes, Enum

Enumeration of all available TCS commands with their byte representations.

Each command includes formatting capability for parameterized commands.

Examples

>>> TCSCommand.READ_TEMPERATURES
<TCSCommand.READ_TEMPERATURES: b'E'>
>>> TCSCommand.BASELINE_TEMPERATURE.format(300)
b'N300'

format(*args)

Format the command with the given arguments.

Parameters:

*args (int, float) – Arguments to format into the command string

Returns:

Formatted command string

Return type:

bytes

Raises:

ValueError – If arguments don’t match the command’s format requirements

Examples

>>> TCSCommand.TARGET_TEMPERATURE.format(1, 350)
b'C1350'

READ_INFO = b'H'

READ_TEMPERATURES = b'E'

READ_STIMULATION_VALUES = b'P'

READ_BUTTON_STATUS = b'K'

READ_BATTERY = b'B'

READ_ERRORS = b'Q'

DISPLAY_TEMPERATURES_BETWEEN_STIMULATION = b'Oa'

DISPLAY_TEMPERATURES_DURING_STIMULATION = b'Ob'

RESET = b'Oc'

SET_MAX_TEMPERATURE = b'Om%03d'

AUTOMATIC_CALIBRATION = b'G'

DEACTIVATE_DISPLAY = b'F'

TRIGGER_STIMULATION = b'L'

HALT_STIMULATION = b'A'

BASELINE_TEMPERATURE = b'N%03d'

SURFACE_SELECTION = b'S%05d'

TARGET_TEMPERATURE = b'C%d%03d'

STIMULATION_RATE = b'V%d%04d'

RETURN_SPEED = b'R%d%04d'

STIMULATION_DURATION = b'D%d%05d'

TRIGGER_CHANNEL_DURATION = b'T%03d%03d'

BUZZER = b'Z%03d%03d'

class TCSStimulus(**data)

Bases: BaseModel

Configuration for thermal stimulation parameters.

surface

Target surface (0-5, where 0 means all surfaces).

Type:

int

baseline

Baseline temperature in °C (20-45).

Type:

float

target

Target temperature in °C (0-60).

Type:

float

rise_rate

Temperature rise rate in °C/s (0.1-999.9).

Type:

float

return_speed

Temperature return speed in °C/s (0.1-999.9).

Type:

float

duration

Stimulation duration in ms (10-99999).

Type:

int

commands() → list

Generate the sequence of commands needed to configure this stimulus.

Examples

>>> stimulus = TCSStimulus(surface=1)
>>> stimulus.commands()
[b'S10000', b'N300', b'C1000', b'V10010', b'D100100', b'R10010']

commands()

Generate the sequence of commands needed to configure this stimulus.

Returns:

Sequence of formatted command strings

Return type:

list

Examples

>>> stimulus = TCSStimulus(surface=1)
>>> stimulus.commands()
[b'S10000', b'N300', b'C1000', b'V10010', b'D100100', b'R10010']

model_config: ClassVar[ConfigDict] = {}

Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].

surface: int

baseline: float

target: float

rise_rate: float

return_speed: float

duration: int

Submodules

• poulet_py.hardware.stimulator.arduino module
  • Arduino
    • Arduino.__init__()
    • Arduino.read_data()
    • Arduino.set_error_log_path()
    • Arduino.set_output_file()
    • Arduino.save_data()
    • Arduino.set_timer()
    • Arduino.close_port()
    • Arduino.log_error()
• poulet_py.hardware.stimulator.julabo module
  • JulaboChiller
    • JulaboChiller.__init__()
    • JulaboChiller.set_timer()
    • JulaboChiller.set_error_log_path()
    • JulaboChiller.set_output_file()
    • JulaboChiller.save_temperature()
    • JulaboChiller.read()
    • JulaboChiller.write()
    • JulaboChiller.close_port()
    • JulaboChiller.set_temperature()
    • JulaboChiller.get_temperature()
    • JulaboChiller.start()
    • JulaboChiller.stop()
    • JulaboChiller.check_version()
    • JulaboChiller.check_status()
    • JulaboChiller.check_started()
    • JulaboChiller.get_target_temperature()
• poulet_py.hardware.stimulator.qst module
  • TCSCommand
    • TCSCommand.READ_INFO
    • TCSCommand.READ_TEMPERATURES
    • TCSCommand.READ_STIMULATION_VALUES
    • TCSCommand.READ_BUTTON_STATUS
    • TCSCommand.READ_BATTERY
    • TCSCommand.READ_ERRORS
    • TCSCommand.DISPLAY_TEMPERATURES_BETWEEN_STIMULATION
    • TCSCommand.DISPLAY_TEMPERATURES_DURING_STIMULATION
    • TCSCommand.RESET
    • TCSCommand.SET_MAX_TEMPERATURE
    • TCSCommand.AUTOMATIC_CALIBRATION
    • TCSCommand.DEACTIVATE_DISPLAY
    • TCSCommand.TRIGGER_STIMULATION
    • TCSCommand.HALT_STIMULATION
    • TCSCommand.BASELINE_TEMPERATURE
    • TCSCommand.SURFACE_SELECTION
    • TCSCommand.TARGET_TEMPERATURE
    • TCSCommand.STIMULATION_RATE
    • TCSCommand.RETURN_SPEED
    • TCSCommand.STIMULATION_DURATION
    • TCSCommand.TRIGGER_CHANNEL_DURATION
    • TCSCommand.BUZZER
    • TCSCommand.format()
  • TCSStimulus
    • TCSStimulus.surface
    • TCSStimulus.baseline
    • TCSStimulus.target
    • TCSStimulus.rise_rate
    • TCSStimulus.return_speed
    • TCSStimulus.duration
    • TCSStimulus.commands()
    • TCSStimulus.surface
    • TCSStimulus.baseline
    • TCSStimulus.target
    • TCSStimulus.rise_rate
    • TCSStimulus.return_speed
    • TCSStimulus.duration
    • TCSStimulus.commands()
    • TCSStimulus.model_config
  • TCS
    • TCS.init()
    • TCS.close()
    • TCS.info()
    • TCS.reset()
    • TCS.trigger()
    • TCS.get_readings()
    • TCS.__init__()
    • TCS.stimulus
    • TCS.write()
    • TCS.execute_command()
    • TCS.init()
    • TCS.close()
    • TCS.info()
    • TCS.reset()
    • TCS.trigger()
    • TCS.get_readings()