Module pyhamilton.oemerr

pyhamilton-specific exception definitions.

Expand source code 
"""`pyhamilton`-specific exception definitions.
"""
class HamiltonError(Exception):
    """
    Exceptions raised in package pyhamilton
    """
    pass

###########################################
### BEGIN HAMILTON DECK RESOURCE ERRORS ###
###########################################

class HamiltonDeckResourceError(HamiltonError):
    """
    Error with any deck object in interface with robot.
    """
    pass

class ResourceUnavailableError(HamiltonDeckResourceError):
    """
    Layout manager found deck resource type not present or all of this type assigned
    """
    pass

#######################################
### BEGIN HAMILTON INTERFACE ERRORS ###
#######################################

class HamiltonInterfaceError(HamiltonError):
    """
    Error in any phase of communication with robot.
    """
    pass

class HamiltonTimeoutError(HamiltonInterfaceError):
    """
    An asynchronous request to the Hamilton robot timed out.
    """
    pass

class InvalidErrCodeError(HamiltonInterfaceError):
    """
    Error code returned from instrument not known.
    """
    pass

class HamiltonReturnParseError(HamiltonInterfaceError):
    """
    Return string from instrument was malformed.
    """
    pass

########################################################
### BEGIN HAMILTON CODED STEP ERRORS, CODE MAP BELOW ###
########################################################

class HamiltonStepError(HamiltonError):
    """
    Errors in steps executed by VENUS software coded in the Hamilton error specification.
    """
    pass

class HamiltonSyntaxError(HamiltonStepError):
    """
    There is a wrong set of parameters or parameter ranges.
    """
    pass
 
class HardwareError(HamiltonStepError):
    """
    Steps lost on one or more hardware components, or component not initialized or not functioning.
    """
    pass
 
class NotExecutedError(HamiltonStepError):
    """
    There was an error in previous part command.
    """
    pass

class ClotError(HamiltonStepError):
    """
    Blood clot detected.
    """
    pass

class BarcodeError(HamiltonStepError):
    """
    Barcode could not be read or is missing.
    """
    pass

class InsufficientLiquidError(HamiltonStepError):
    """
    Not enough liquid available.
    """
    pass

class TipPresentError(HamiltonStepError):
    """
    A tip has already been picked up.
    """
    pass

class NoTipError(HamiltonStepError):
    """
    Tip is missing or not picked up.
    """
    pass

class NoCarrierError(HamiltonStepError):
    """
    No carrier present for loading.
    """
    pass

class ExecutionError(HamiltonStepError):
    """
    A step or a part of a step could not be processed.
    """
    pass

class PressureLLDError(HamiltonStepError):
    """
    A dispense with pressure liquid level detection is not allowed.
    """
    pass

class CalibrateError(HamiltonStepError):
    """
    No capacitive signal detected during carrier calibration procedure.
    """
    pass

class UnloadError(HamiltonStepError):
    """
    Not possible to unload the carrier due to occupied loading tray position.
    """
    pass

class PressureLLDError(HamiltonStepError):
    """
    Pressure liquid level detection in a consecutive aspiration is not allowed.
    """
    pass

class ParameterError(HamiltonStepError):
    """
    Dispense in jet mode with pressure liquid level detection is not allowed.
    """
    pass

class CoverOpenError(HamiltonStepError):
    """
    Cover not closed or can not be locked.
    """
    pass

class ImproperAspirationOrDispenseError(HamiltonStepError):
    """
    The pressure-based aspiration / dispensation control reported an error ( not enough liquid ).
    """
    pass

class WashLiquidError(HamiltonStepError):
    """
    Waste full or no more wash liquid available.
    """
    pass

class TemperatureError(HamiltonStepError):
    """
    Incubator temperature out of range.
    """
    pass

class TADMOvershotError(HamiltonStepError):
    """
    Overshot of limits during aspirate or dispense.

    Note:

    On aspirate this error is returned as main error 17.

    On dispense this error is returned as main error 4.
    """
    pass

class LabwareError(HamiltonStepError):
    """
    Labware not available.
    """
    pass

class LabwareGrippedError(HamiltonStepError):
    """
    Labware already gripped.
    """
    pass

class LabwareLostError(HamiltonStepError):
    """
    Labware lost during transport.
    """
    pass

class IllegalTargetPlatePositionError(HamiltonStepError):
    """
    Cannot place plate, plate was gripped in a wrong direction.
    """
    pass

class IllegalInterventionError(HamiltonStepError):
    """
    Cover was opened or a carrier was removed manually.
    """
    pass

class TADMUndershotError(HamiltonStepError):
    """
    Undershot of limits during aspirate or dispense.

    Note:

    On aspirate this error is returned as main error 4.

    On dispense this error is returned as main error 17.
    """
    pass

class PositionError(HamiltonStepError):
    """
    The position is out of range.
    """
    pass

class UnexpectedcLLDError(HamiltonStepError):
    """
    The cLLD detected a liquid level above start height of liquid level search.
    """
    pass

class AreaAlreadyOccupiedError(HamiltonStepError):
    """
    Instrument region already reserved.
    """
    pass

class ImpossibleToOccupyAreaError(HamiltonStepError):
    """
    A region on the instrument cannot be reserved.
    """
    pass

class AntiDropControlError(HamiltonStepError):
    """
    Anti drop controlling out of tolerance.
    """
    pass

class DecapperError(HamiltonStepError):
    """
    Decapper lock error while screw / unscrew a cap by twister channels.
    """
    pass

class DecapperHandlingError(HamiltonStepError):
    """
    Decapper station error while lock / unlock a cap.
    """
    pass

class SlaveError(HamiltonStepError):
    """
    Slave error.
    """
    pass

class WrongCarrierError(HamiltonStepError):
    """
    Wrong carrier barcode detected.
    """
    pass

class NoCarrierBarcodeError(HamiltonStepError):
    """
    Carrier barcode could not be read or is missing.
    """
    pass

class LiquidLevelError(HamiltonStepError):
    """
    Liquid surface not detected.

    This error is created from main / slave error 06/70, 06/73 and 06/87.
    """
    pass

class NotDetectedError(HamiltonStepError):
    """
    Carrier not detected at deck end position.
    """
    pass

class NotAspiratedError(HamiltonStepError):
    """
    Dispense volume exceeds the aspirated volume.

    This error is created from main / slave error 02/54.
    """
    pass

class ImproperDispensationError(HamiltonStepError):
    """
    The dispensed volume is out of tolerance (may only occur for Nano Pipettor Dispense steps). 

    This error is created from main / slave error 02/52 and 02/54.
    """
    pass

class NoLabwareError(HamiltonStepError):
    """
    The labware to be loaded was not detected by autoload module.

    Note:

    May only occur on a Reload Carrier step if the labware property 'MlStarCarPosAreRecognizable' is set to 1.
    """
    pass

class UnexpectedLabwareError(HamiltonStepError):
    """
    The labware contains unexpected barcode ( may only occur on a Reload Carrier step ).
    """
    pass

class WrongLabwareError(HamiltonStepError):
    """
    The labware to be reloaded contains wrong barcode ( may only occur on a Reload Carrier step ).
    """
    pass

class BarcodeMaskError(HamiltonStepError):
    """
    The barcode read doesn't match the barcode mask defined.
    """
    pass

class BarcodeNotUniqueError(HamiltonStepError):
    """
    The barcode read is not unique. Previously loaded labware with same barcode was loaded without unique barcode check.
    """
    pass

class BarcodeAlreadyUsedError(HamiltonStepError):
    """
    The barcode read is already loaded as unique barcode ( it's not possible to load the same barcode twice ).
    """
    pass

class KitLotExpiredError(HamiltonStepError):
    """
    Kit Lot expired.
    """
    pass

class DelimiterError(HamiltonStepError):
    """
    Barcode contains character which is used as delimiter in result string.
    """
    pass


HAMILTON_ERROR_MAP = { 
    1: HamiltonSyntaxError,
    2: HardwareError,
    3: NotExecutedError,
    4: ClotError,
    5: BarcodeError,
    6: InsufficientLiquidError,
    7: TipPresentError,
    8: NoTipError,
    9: NoCarrierError,
    10: ExecutionError,
    11: PressureLLDError,
    12: CalibrateError,
    13: UnloadError,
    14: PressureLLDError,
    15: ParameterError,
    16: CoverOpenError,
    17: ImproperAspirationOrDispenseError,
    18: WashLiquidError,
    19: TemperatureError,
    20: TADMOvershotError,
    21: LabwareError,
    22: LabwareGrippedError,
    23: LabwareLostError,
    24: IllegalTargetPlatePositionError,
    25: IllegalInterventionError,
    26: TADMUndershotError,
    27: PositionError,
    28: UnexpectedcLLDError,
    29: AreaAlreadyOccupiedError,
    30: ImpossibleToOccupyAreaError,
    31: AntiDropControlError,
    32: DecapperError,
    33: DecapperHandlingError,
    99: SlaveError,
    100: WrongCarrierError,
    101: NoCarrierBarcodeError,
    102: LiquidLevelError,
    103: NotDetectedError,
    104: NotAspiratedError,
    105: ImproperDispensationError,
    106: NoLabwareError,
    107: UnexpectedLabwareError,
    108: WrongLabwareError,
    109: BarcodeMaskError,
    110: BarcodeNotUniqueError,
    111: BarcodeAlreadyUsedError,
    112: KitLotExpiredError,
    113: DelimiterError
}
"""
Maps integer error codes from Hamilton step return data to the appropriate `pyhamilton` errors
"""

Global variables

var HAMILTON_ERROR_MAP

Maps integer error codes from Hamilton step return data to the appropriate pyhamilton errors

Classes

class AntiDropControlError (*args, **kwargs)

Anti drop controlling out of tolerance.

Expand source code 
class AntiDropControlError(HamiltonStepError):
    """
    Anti drop controlling out of tolerance.
    """
    pass

Ancestors

class AreaAlreadyOccupiedError (*args, **kwargs)

Instrument region already reserved.

Expand source code 
class AreaAlreadyOccupiedError(HamiltonStepError):
    """
    Instrument region already reserved.
    """
    pass

Ancestors

class BarcodeAlreadyUsedError (*args, **kwargs)

The barcode read is already loaded as unique barcode ( it's not possible to load the same barcode twice ).

Expand source code 
class BarcodeAlreadyUsedError(HamiltonStepError):
    """
    The barcode read is already loaded as unique barcode ( it's not possible to load the same barcode twice ).
    """
    pass

Ancestors

class BarcodeError (*args, **kwargs)

Barcode could not be read or is missing.

Expand source code 
class BarcodeError(HamiltonStepError):
    """
    Barcode could not be read or is missing.
    """
    pass

Ancestors

class BarcodeMaskError (*args, **kwargs)

The barcode read doesn't match the barcode mask defined.

Expand source code 
class BarcodeMaskError(HamiltonStepError):
    """
    The barcode read doesn't match the barcode mask defined.
    """
    pass

Ancestors

class BarcodeNotUniqueError (*args, **kwargs)

The barcode read is not unique. Previously loaded labware with same barcode was loaded without unique barcode check.

Expand source code 
class BarcodeNotUniqueError(HamiltonStepError):
    """
    The barcode read is not unique. Previously loaded labware with same barcode was loaded without unique barcode check.
    """
    pass

Ancestors

class CalibrateError (*args, **kwargs)

No capacitive signal detected during carrier calibration procedure.

Expand source code 
class CalibrateError(HamiltonStepError):
    """
    No capacitive signal detected during carrier calibration procedure.
    """
    pass

Ancestors

class ClotError (*args, **kwargs)

Blood clot detected.

Expand source code 
class ClotError(HamiltonStepError):
    """
    Blood clot detected.
    """
    pass

Ancestors

class CoverOpenError (*args, **kwargs)

Cover not closed or can not be locked.

Expand source code 
class CoverOpenError(HamiltonStepError):
    """
    Cover not closed or can not be locked.
    """
    pass

Ancestors

class DecapperError (*args, **kwargs)

Decapper lock error while screw / unscrew a cap by twister channels.

Expand source code 
class DecapperError(HamiltonStepError):
    """
    Decapper lock error while screw / unscrew a cap by twister channels.
    """
    pass

Ancestors

class DecapperHandlingError (*args, **kwargs)

Decapper station error while lock / unlock a cap.

Expand source code 
class DecapperHandlingError(HamiltonStepError):
    """
    Decapper station error while lock / unlock a cap.
    """
    pass

Ancestors

class DelimiterError (*args, **kwargs)

Barcode contains character which is used as delimiter in result string.

Expand source code 
class DelimiterError(HamiltonStepError):
    """
    Barcode contains character which is used as delimiter in result string.
    """
    pass

Ancestors

class ExecutionError (*args, **kwargs)

A step or a part of a step could not be processed.

Expand source code 
class ExecutionError(HamiltonStepError):
    """
    A step or a part of a step could not be processed.
    """
    pass

Ancestors

class HamiltonDeckResourceError (*args, **kwargs)

Error with any deck object in interface with robot.

Expand source code 
class HamiltonDeckResourceError(HamiltonError):
    """
    Error with any deck object in interface with robot.
    """
    pass

Ancestors

Subclasses

class HamiltonError (*args, **kwargs)

Exceptions raised in package pyhamilton

Expand source code 
class HamiltonError(Exception):
    """
    Exceptions raised in package pyhamilton
    """
    pass

Ancestors

  • builtins.Exception
  • builtins.BaseException

Subclasses

class HamiltonInterfaceError (*args, **kwargs)

Error in any phase of communication with robot.

Expand source code 
class HamiltonInterfaceError(HamiltonError):
    """
    Error in any phase of communication with robot.
    """
    pass

Ancestors

Subclasses

class HamiltonReturnParseError (*args, **kwargs)

Return string from instrument was malformed.

Expand source code 
class HamiltonReturnParseError(HamiltonInterfaceError):
    """
    Return string from instrument was malformed.
    """
    pass

Ancestors

class HamiltonStepError (*args, **kwargs)

Errors in steps executed by VENUS software coded in the Hamilton error specification.

Expand source code 
class HamiltonStepError(HamiltonError):
    """
    Errors in steps executed by VENUS software coded in the Hamilton error specification.
    """
    pass

Ancestors

Subclasses

class HamiltonSyntaxError (*args, **kwargs)

There is a wrong set of parameters or parameter ranges.

Expand source code 
class HamiltonSyntaxError(HamiltonStepError):
    """
    There is a wrong set of parameters or parameter ranges.
    """
    pass

Ancestors

class HamiltonTimeoutError (*args, **kwargs)

An asynchronous request to the Hamilton robot timed out.

Expand source code 
class HamiltonTimeoutError(HamiltonInterfaceError):
    """
    An asynchronous request to the Hamilton robot timed out.
    """
    pass

Ancestors

class HardwareError (*args, **kwargs)

Steps lost on one or more hardware components, or component not initialized or not functioning.

Expand source code 
class HardwareError(HamiltonStepError):
    """
    Steps lost on one or more hardware components, or component not initialized or not functioning.
    """
    pass

Ancestors

class IllegalInterventionError (*args, **kwargs)

Cover was opened or a carrier was removed manually.

Expand source code 
class IllegalInterventionError(HamiltonStepError):
    """
    Cover was opened or a carrier was removed manually.
    """
    pass

Ancestors

class IllegalTargetPlatePositionError (*args, **kwargs)

Cannot place plate, plate was gripped in a wrong direction.

Expand source code 
class IllegalTargetPlatePositionError(HamiltonStepError):
    """
    Cannot place plate, plate was gripped in a wrong direction.
    """
    pass

Ancestors

class ImpossibleToOccupyAreaError (*args, **kwargs)

A region on the instrument cannot be reserved.

Expand source code 
class ImpossibleToOccupyAreaError(HamiltonStepError):
    """
    A region on the instrument cannot be reserved.
    """
    pass

Ancestors

class ImproperAspirationOrDispenseError (*args, **kwargs)

The pressure-based aspiration / dispensation control reported an error ( not enough liquid ).

Expand source code 
class ImproperAspirationOrDispenseError(HamiltonStepError):
    """
    The pressure-based aspiration / dispensation control reported an error ( not enough liquid ).
    """
    pass

Ancestors

class ImproperDispensationError (*args, **kwargs)

The dispensed volume is out of tolerance (may only occur for Nano Pipettor Dispense steps).

This error is created from main / slave error 02/52 and 02/54.

Expand source code 
class ImproperDispensationError(HamiltonStepError):
    """
    The dispensed volume is out of tolerance (may only occur for Nano Pipettor Dispense steps). 

    This error is created from main / slave error 02/52 and 02/54.
    """
    pass

Ancestors

class InsufficientLiquidError (*args, **kwargs)

Not enough liquid available.

Expand source code 
class InsufficientLiquidError(HamiltonStepError):
    """
    Not enough liquid available.
    """
    pass

Ancestors

class InvalidErrCodeError (*args, **kwargs)

Error code returned from instrument not known.

Expand source code 
class InvalidErrCodeError(HamiltonInterfaceError):
    """
    Error code returned from instrument not known.
    """
    pass

Ancestors

class KitLotExpiredError (*args, **kwargs)

Kit Lot expired.

Expand source code 
class KitLotExpiredError(HamiltonStepError):
    """
    Kit Lot expired.
    """
    pass

Ancestors

class LabwareError (*args, **kwargs)

Labware not available.

Expand source code 
class LabwareError(HamiltonStepError):
    """
    Labware not available.
    """
    pass

Ancestors

class LabwareGrippedError (*args, **kwargs)

Labware already gripped.

Expand source code 
class LabwareGrippedError(HamiltonStepError):
    """
    Labware already gripped.
    """
    pass

Ancestors

class LabwareLostError (*args, **kwargs)

Labware lost during transport.

Expand source code 
class LabwareLostError(HamiltonStepError):
    """
    Labware lost during transport.
    """
    pass

Ancestors

class LiquidLevelError (*args, **kwargs)

Liquid surface not detected.

This error is created from main / slave error 06/70, 06/73 and 06/87.

Expand source code 
class LiquidLevelError(HamiltonStepError):
    """
    Liquid surface not detected.

    This error is created from main / slave error 06/70, 06/73 and 06/87.
    """
    pass

Ancestors

class NoCarrierBarcodeError (*args, **kwargs)

Carrier barcode could not be read or is missing.

Expand source code 
class NoCarrierBarcodeError(HamiltonStepError):
    """
    Carrier barcode could not be read or is missing.
    """
    pass

Ancestors

class NoCarrierError (*args, **kwargs)

No carrier present for loading.

Expand source code 
class NoCarrierError(HamiltonStepError):
    """
    No carrier present for loading.
    """
    pass

Ancestors

class NoLabwareError (*args, **kwargs)

The labware to be loaded was not detected by autoload module.

Note:

May only occur on a Reload Carrier step if the labware property 'MlStarCarPosAreRecognizable' is set to 1.

Expand source code 
class NoLabwareError(HamiltonStepError):
    """
    The labware to be loaded was not detected by autoload module.

    Note:

    May only occur on a Reload Carrier step if the labware property 'MlStarCarPosAreRecognizable' is set to 1.
    """
    pass

Ancestors

class NoTipError (*args, **kwargs)

Tip is missing or not picked up.

Expand source code 
class NoTipError(HamiltonStepError):
    """
    Tip is missing or not picked up.
    """
    pass

Ancestors

class NotAspiratedError (*args, **kwargs)

Dispense volume exceeds the aspirated volume.

This error is created from main / slave error 02/54.

Expand source code 
class NotAspiratedError(HamiltonStepError):
    """
    Dispense volume exceeds the aspirated volume.

    This error is created from main / slave error 02/54.
    """
    pass

Ancestors

class NotDetectedError (*args, **kwargs)

Carrier not detected at deck end position.

Expand source code 
class NotDetectedError(HamiltonStepError):
    """
    Carrier not detected at deck end position.
    """
    pass

Ancestors

class NotExecutedError (*args, **kwargs)

There was an error in previous part command.

Expand source code 
class NotExecutedError(HamiltonStepError):
    """
    There was an error in previous part command.
    """
    pass

Ancestors

class ParameterError (*args, **kwargs)

Dispense in jet mode with pressure liquid level detection is not allowed.

Expand source code 
class ParameterError(HamiltonStepError):
    """
    Dispense in jet mode with pressure liquid level detection is not allowed.
    """
    pass

Ancestors

class PositionError (*args, **kwargs)

The position is out of range.

Expand source code 
class PositionError(HamiltonStepError):
    """
    The position is out of range.
    """
    pass

Ancestors

class PressureLLDError (*args, **kwargs)

Pressure liquid level detection in a consecutive aspiration is not allowed.

Expand source code 
class PressureLLDError(HamiltonStepError):
    """
    A dispense with pressure liquid level detection is not allowed.
    """
    pass

Ancestors

class ResourceUnavailableError (*args, **kwargs)

Layout manager found deck resource type not present or all of this type assigned

Expand source code 
class ResourceUnavailableError(HamiltonDeckResourceError):
    """
    Layout manager found deck resource type not present or all of this type assigned
    """
    pass

Ancestors

class SlaveError (*args, **kwargs)

Slave error.

Expand source code 
class SlaveError(HamiltonStepError):
    """
    Slave error.
    """
    pass

Ancestors

class TADMOvershotError (*args, **kwargs)

Overshot of limits during aspirate or dispense.

Note:

On aspirate this error is returned as main error 17.

On dispense this error is returned as main error 4.

Expand source code 
class TADMOvershotError(HamiltonStepError):
    """
    Overshot of limits during aspirate or dispense.

    Note:

    On aspirate this error is returned as main error 17.

    On dispense this error is returned as main error 4.
    """
    pass

Ancestors

class TADMUndershotError (*args, **kwargs)

Undershot of limits during aspirate or dispense.

Note:

On aspirate this error is returned as main error 4.

On dispense this error is returned as main error 17.

Expand source code 
class TADMUndershotError(HamiltonStepError):
    """
    Undershot of limits during aspirate or dispense.

    Note:

    On aspirate this error is returned as main error 4.

    On dispense this error is returned as main error 17.
    """
    pass

Ancestors

class TemperatureError (*args, **kwargs)

Incubator temperature out of range.

Expand source code 
class TemperatureError(HamiltonStepError):
    """
    Incubator temperature out of range.
    """
    pass

Ancestors

class TipPresentError (*args, **kwargs)

A tip has already been picked up.

Expand source code 
class TipPresentError(HamiltonStepError):
    """
    A tip has already been picked up.
    """
    pass

Ancestors

class UnexpectedLabwareError (*args, **kwargs)

The labware contains unexpected barcode ( may only occur on a Reload Carrier step ).

Expand source code 
class UnexpectedLabwareError(HamiltonStepError):
    """
    The labware contains unexpected barcode ( may only occur on a Reload Carrier step ).
    """
    pass

Ancestors

class UnexpectedcLLDError (*args, **kwargs)

The cLLD detected a liquid level above start height of liquid level search.

Expand source code 
class UnexpectedcLLDError(HamiltonStepError):
    """
    The cLLD detected a liquid level above start height of liquid level search.
    """
    pass

Ancestors

class UnloadError (*args, **kwargs)

Not possible to unload the carrier due to occupied loading tray position.

Expand source code 
class UnloadError(HamiltonStepError):
    """
    Not possible to unload the carrier due to occupied loading tray position.
    """
    pass

Ancestors

class WashLiquidError (*args, **kwargs)

Waste full or no more wash liquid available.

Expand source code 
class WashLiquidError(HamiltonStepError):
    """
    Waste full or no more wash liquid available.
    """
    pass

Ancestors

class WrongCarrierError (*args, **kwargs)

Wrong carrier barcode detected.

Expand source code 
class WrongCarrierError(HamiltonStepError):
    """
    Wrong carrier barcode detected.
    """
    pass

Ancestors

class WrongLabwareError (*args, **kwargs)

The labware to be reloaded contains wrong barcode ( may only occur on a Reload Carrier step ).

Expand source code 
class WrongLabwareError(HamiltonStepError):
    """
    The labware to be reloaded contains wrong barcode ( may only occur on a Reload Carrier step ).
    """
    pass

Ancestors