pylabrobot.liquid_handling.backends.hamilton.STAR_backend.STAR.request_presence_of_single_carrier_on_loading_tray

async STAR.request_presence_of_single_carrier_on_loading_tray(track: int) → bool

Check whether a specific loading-tray track contains a carrier.

This sends the C0:CT command, which instructs the autoload sled to move to the specified tray track and read its front-facing proximity sensor. Unlike request_presence_of_carriers_on_loading_tray, which scans all tray positions and returns a bitmask, this method queries only a single track and returns a boolean result.

Parameters:

track (int) – The loading-tray track number to query (1-54).

Returns:

bool – True if a carrier is detected at the given track; False otherwise.

Raises:

AssertionError – If track is outside the valid range (1-54).

Return type:

bool