pylabrobot.inheco.odtc.ODTC#

class pylabrobot.inheco.odtc.ODTC(name: str, odtc_ip: str, variant: Literal[96, 384] = 96, client_ip: str | None = None, *, odtc_port: int = 8080, callback_port: int = 0)#

Bases: object

An ODTC, its plate location, and its connection and thermal execution state.

Temperatures use degrees C, durations seconds, and sample volumes microliters. The plate holder’s position must be calibrated before using it for robotic transfers. Both 96- and 384-well implementations require hardware verification.

Attributes

door_open

Last command-confirmed door state; None means unknown, not a sensor reading.

Methods

__init__(name, odtc_ip[, variant, ...])

close_door()

Close the drawer and await command completion.

open_door()

Open the drawer and await command completion; remember only confirmed state.

prepare(temperature, lid_temperature, *[, ...])

Preheat before loading or running; return only after thermal preparation completes.

request_block_temperature()

Read the block's mount temperature in degrees C.

request_lid_temperature()

Read the heated lid temperature in degrees C.

request_method_set()

Retrieve the full stored methods, including native loops and PID settings.

request_progress()

Return the latest measured sample for this execution, or None before any data arrives.

request_protocol(name)

Retrieve a named compiled method, or None if it is absent.

request_status()

Read the current SiLA state from the device.

request_temperatures()

Read all physical temperature sensors, including during a run.

run_protocol(protocol, *, volume, ...[, ...])

Compile, upload, prepare, and await a complete temperature protocol.

run_stored_protocol(name, *[, timeout])

Prepare and execute an existing method using its stored thermal settings.

setup(*[, simulation_mode])

Connect, register callbacks, and initialize an idle or standby instrument.

stop()

Stop temperature control and close transports, even if stopping the device fails.

stop_protocol()

Stop a running method or an idle post-method hold and await acknowledgement.

upload_protocol(method, *[, overwrite])

Persist a compiled method.

wait_for_completion(*[, timeout])

Wait for the latest execution, retaining completed failures and shielding the device task.

Parameters:
  • name (str)

  • odtc_ip (str)

  • variant (ODTCVariant)

  • client_ip (str | None)

  • odtc_port (int)

  • callback_port (int)