dodal.devices.oav.pin_image_recognition.PinTipDetection#

class dodal.devices.oav.pin_image_recognition.PinTipDetection[source]#

A device which will read from an on-axis view and calculate the location of the pin-tip (in pixels) of that frame.

Used for pin tip centring workflow.

Note that if the tip of the sample is off-screen, this class will return the tip as the “edge” of the image.

If no tip is found it will return {INVALID_POSITION}. However, it will also occasionally give incorrect data. Therefore, it is recommended that you trigger this device, which will attempt to find a pin within {validity_timeout} seconds if no tip is found after this time it will not error but instead return {INVALID_POSITION}.

Parameters:
  • prefix (str)

  • name (str, default: '')

Methods

trigger()

Monitors the camera data and updates the triggered_tip signal.

Attributes

INVALID_POSITION

trigger()[source]#

Monitors the camera data and updates the triggered_tip signal.

  • If a tip is found it will update the signal and stop monitoring

  • If no tip is found it will retry with the next monitored value, if this

    continues for {validity_timeout} seconds it will timeout.