unitelabs.labware.tips.tip_spot

Attributes

  • Name
    T
    Type
    Value

    = typing.TypeVar('T', bound=Tip)

    Description

Classes

  • TipSpot

    Optionally hold a tip at a predefined location on a tip rack.

    MRO
    Bases
    Spot[T]
    Decorators
    dataclasses.dataclass

    Methods

    • __init__(self, children : collections.abc.Sequence[T]) -> None

      Parameters

      • Name
        self
        Type
        Default
        Description

      • Name
        children
        Type
        collections.abc.Sequence[T]
        Default
        Description

    • @typing_extensions.override

      can_assign(
        self,
        resource : Tip,
        **kwargs
      ) -> typing_extensions.TypeGuard[T]

      Parameters

      • Name
        self
        Type
        Default
        Description

      • Name
        resource
        Type
        Tip
        Default
        Description

      • Name
        **kwargs
        Type
        Default
        = {}
        Description

      Response

      Type
      typing_extensions.TypeGuard[T]
      Description

    • @typing_extensions.override

      assign(
        self,
        resource : typing.Optional[Tip],
        **kwargs
      ) -> None

      Parameters

      • Name
        self
        Type
        Default
        Description

      • Name
        resource
        Type
        typing.Optional[Tip]
        Default
        Description

      • Name
        **kwargs
        Type
        Default
        = {}
        Description

    • get(self) -> typing.Optional[T]

      Access the labware in the spot. Returns None if the spot is empty.

      Response

      Type
      typing.Optional[T]
      Description

    • add(self, labware : typing.Optional[T]) -> None

      Assign the labware to this spot.

      Parameters

      • Name
        self
        Type
        Default
        Description

      • Name
        labware
        Type
        typing.Optional[T]
        Default
        Description

        The labware to assign.

    • remove(self) -> typing.Optional[T]

      Remove the resource in this spot.

      Response

      Type
      typing.Optional[T]
      Description

      The resource that was removed from this spot, if available.

    • can_unassign(
        self,
        **kwargs
      ) -> typing_extensions.TypeGuard[T]

      Verify whether the given resource can be unassigned from this group.

      Parameters

      • Name
        self
        Type
        Default
        Description

      • Name
        resource
        Type
        typing.Optional[Resource]
        Default
        = None
        Description

        The resource to unassign from this group.

      • Name
        **kwargs
        Type
        Default
        = {}
        Description

        Additional arguments for the group.

      Response

      Type
      typing_extensions.TypeGuard[T]
      Description

      True if the resource can be unassigned, otherwise raise an error.

    • unassign(
        self,
        **kwargs
      ) -> None

      Unassign the given resource from this group.

      Parameters

      • Name
        self
        Type
        Default
        Description

      • Name
        resource
        Type
        typing.Optional[Resource]
        Default
        = None
        Description

        The resource to unassign from this group.

      • Name
        **kwargs
        Type
        Default
        = {}
        Description

        Additional arguments for the group.

    • reassign(
        self,
        **kwargs
      ) -> None

      Unassign the given resource from this group and assign it another one.

      Parameters

      • Name
        self
        Type
        Default
        Description

      • Name
        to
        Type
        Spot
        Default
        Description

        The target group to which to assign the resource to.

      • Name
        resource
        Type
        typing.Optional[Resource]
        Default
        = None
        Description

        The resource to reassign from this group to the other one.

      • Name
        **kwargs
        Type
        Default
        = {}
        Description

        Additional arguments for the group.

    • __post_init__(self, *kwargs) -> None

      Parameters

      • Name
        self
        Type
        Default
        Description

      • Name
        *kwargs
        Type
        Default
        = ()
        Description

    • __init_subclass__(cls) -> None

      Parameters

      • Name
        cls
        Type
        Default
        Description

    • @typing_extensions.override

      rotate_by(self, angle : int) -> None

      Parameters

      • Name
        self
        Type
        Default
        Description

      • Name
        angle
        Type
        int
        Default
        Description

    • find(self, identifier) -> None

      Parameters

      • Name
        self
        Type
        Default
        Description

      • Name
        identifier
        Type
        Default
        Description

    • __contains__(self, item : typing.Any) -> bool

      Parameters

      • Name
        self
        Type
        Default
        Description

      • Name
        item
        Type
        typing.Any
        Default
        Description

      Response

      Type
      bool
      Description

    • __getitem__(self, key : typing.Union[int, str, slice]) -> typing.Union[T, collections.abc.Sequence[T]]

      Parameters

      • Name
        self
        Type
        Default
        Description

      • Name
        key
        Type
        typing.Union[int, str, slice]
        Default
        Description

      Response

      Type
      typing.Union[T, collections.abc.Sequence[T]]
      Description

    • __len__(self) -> int

      The number of children in this group.

      Response

      Type
      int
      Description

      The number of children in this group.

    • __iter__(self) -> collections.abc.Iterator[T]

      Iterate over the children of this group.

      Response

      Type
      collections.abc.Iterator[T]
      Description

      An iterator to iterate over all children in this group.

    • _index(self, key : typing.Union[int, str, slice]) -> typing.Union[int, slice]

      Parameters

      • Name
        self
        Type
        Default
        Description

      • Name
        key
        Type
        typing.Union[int, str, slice]
        Default
        Description

      Response

      Type
      typing.Union[int, slice]
      Description

    • copy(self, **changes) -> None

      Parameters

      • Name
        self
        Type
        Default
        Description

      • Name
        **changes
        Type
        Default
        = {}
        Description

    • serialize(self) -> JsonSchema

      Response

      Type
      JsonSchema
      Description

    • assign_to(self, parent : Group) -> None

      Set the parent of this resource to the given group.

      Parameters

      • Name
        self
        Type
        Default
        Description

      • Name
        parent
        Type
        Group
        Default
        Description

        The group to which this resource is assigned to.

    • @deprecation.deprecated(deprecated_in='0.1.20', removed_in='0.2.0', current_version=__version__, details='Use `rotate_by` instead.')

      rotate(self, angle : int) -> None

      Parameters

      • Name
        self
        Type
        Default
        Description

      • Name
        angle
        Type
        int
        Default
        Description

    • rotate_to(self, angle : int) -> None

      Rotate to the given absolute angle in degrees.

      Parameters

      • Name
        self
        Type
        Default
        Description

      • Name
        angle
        Type
        int
        Default
        Description

        The angle in degrees to rotate the resource. Must be a multiple of 90°.

    • @classmethod

      deserialize(cls, identifier : str, schema : JsonSchema) -> typing_extensions.Self

      Deserialize a JSON-like dictionary to a resource.

      Parameters

      • Name
        cls
        Type
        Default
        Description

      • Name
        identifier
        Type
        str
        Default
        Description

        The identifier of the resource to deserialize.

      • Name
        schema
        Type
        JsonSchema
        Default
        Description

        The JSON-like dictionary with the resource's data.

      Response

      Type
      typing_extensions.Self
      Description

      The newly created resource.

    • @classmethod

      subclass_by_name(cls, name : str) -> typing.Optional[type[Resource]]

      Recursively find a resource subclass with the given name.

      Parameters

      • Name
        cls
        Type
        Default
        Description

      • Name
        name
        Type
        str
        Default
        Description

        The name of the class to find.

      Response

      Type
      typing.Optional[type[Resource]]
      Description

      The class with the given name, or `None` if no such class exists.

      Exceptions

      Type
      TypeError
      Description
      If the name is not a valid class name.

    Attributes

    • Name
      children
      Type
      collections.abc.Sequence[typing.Optional[T]]
      Value

      = dataclasses.field(init=False, repr=False, default_factory=lambda: [None])

      Description

    • Name
      child
      Type
      typing.Optional[T]
      Value

      = None

      Description

      Request the resource in this spot or `None` if the spot is empty.

    • Name
      identifier
      Type
      str
      Value

      = dataclasses.field(default_factory=lambda: str(uuid.uuid4().hex[:8]))

      Description

    • Name
      rotation
      Type
      int
      Value

      = 0

      Description

    • Name
      dimensions
      Type
      Vector
      Value

      = dataclasses.field(default_factory=Vector)

      Description

    • Name
      location
      Type
      typing.Optional[Vector]
      Value

      = None

      Description

    • Name
      Schema
      Type
      type[marshmallow.Schema]
      Value

      = marshmallow.Schema

      Description

    • Name
      name
      Type
      str
      Value

      = None

      Description

      A human readable name to identify resources.

    • Name
      absolute_location
      Type
      Vector
      Value

      = None

      Description

      The absolute location of this resource.

    • Name
      width
      Type
      decimal.Decimal
      Value

      = None

      Description

      The size of the resource along the x-axis.

    • Name
      depth
      Type
      decimal.Decimal
      Value

      = None

      Description

      The size of the resource along the y-axis.

    • Name
      height
      Type
      decimal.Decimal
      Value

      = None

      Description

      The size of the resource along the z-axis.

    • Name
      center
      Type
      Vector
      Value

      = None

      Description

      The center base of this resource.

Copyright © 2024