ablelabs 0.0.66__tar.gz

ablelabs-0.0.66/PKG-INFO

@@ -0,0 +1,16 @@
+Metadata-Version: 2.1
+Name: ablelabs
+Version: 0.0.66
+Home-page: https://github.com/ABLE-Labs/ABLE-API
+Author: sypark
+Author-email: sy.park@ablelabsinc.com
+Keywords: ablelabs
+Classifier: Programming Language :: Python :: 3.10
+Requires-Python: >=3.10
+Requires-Dist: et-xmlfile>=1.1.0
+Requires-Dist: future>=1.0.0
+Requires-Dist: iso8601>=2.1.0
+Requires-Dist: loguru>=0.7.2
+Requires-Dist: openpyxl>=3.1.5
+Requires-Dist: pyserial>=3.5
+Requires-Dist: PyYAML>=6.0.1

ablelabs-0.0.66/ablelabs/neon/common/alma/constants.py

@@ -0,0 +1,13 @@
+DECK_COUNT: int = 12
+DECK_NUMBERS = [i + 1 for i in range(DECK_COUNT)]
+
+LID_HOLDER_COUNT: int = 4
+LID_HOLDER_NUMBERS = [i + 1 for i in range(LID_HOLDER_COUNT)]
+
+CHIP_HOLDER_COUNT: int = 8
+CHIP_HOLDER_NUMBERS = [i + 1 for i in range(CHIP_HOLDER_COUNT)]
+
+RESERVOIR_COUNT: int = 2
+RESERVOIR_NUMBERS = [i + 1 for i in range(RESERVOIR_COUNT)]
+
+CHIP_WELL_COUNT: int = 192

ablelabs-0.0.66/ablelabs/neon/common/alma/enums.py

@@ -0,0 +1,65 @@
+import sys, os
+
+sys.path.append(os.path.abspath(os.curdir))
+from ablelabs.neon.common.notable.enums import (
+    NUMBERING_ORDER,
+    Color,
+    RunStatus,
+    TaskStatus,
+    LabwareType,
+    Height,
+    Plunger,
+    LocationReference,
+)
+from ablelabs.neon.utils.enum_types import Enum, auto, StrEnum, ItemGetable
+
+
+class DioInput(StrEnum):
+    EMS = auto()
+    DOOR_LEFT = auto()
+    DOOR_RIGHT = auto()
+
+
+class DioPDO(StrEnum):
+    LED_LAMP = auto()
+
+
+class Axis(StrEnum):
+    X = auto()
+    Y = auto()
+    Z1 = auto()
+    Z2 = auto()
+    G = auto()
+    P = auto()
+
+    Z = ItemGetable[int](lambda number: Axis.from_str(f"{Axis.Z1[0]}{number}"))
+
+
+class LocationType(StrEnum):
+    READY = auto()
+    LID_HOLDER = auto()
+    INSPECTOR = auto()
+    DECK = auto()
+    CHIP_HOLDER = auto()
+    WASTE = auto()
+    TIP_RACK = auto()
+    RESERVOIR = auto()
+
+
+class ZGripper(StrEnum):
+    MOVE = auto()
+    PLATE_LID_UNGRIP = auto()
+    PLATE_LID_GRIP = auto()
+    LID_UNGRIP = auto()
+    LID_GRIP = auto()
+    FORK = auto()
+    UNDER_PLATE = auto()
+    PUSH = auto()
+
+
+class Gripper(StrEnum):
+    UNGRIP = auto()
+    PUSH = auto()
+    GRIP_LID = auto()
+    FORK = auto()
+    GRIP_PLATE = auto()

ablelabs-0.0.66/ablelabs/neon/common/alma/structs.py

@@ -0,0 +1,71 @@
+from dataclasses import dataclass
+from enum import Enum
+from typing import TypedDict
+
+import sys, os
+
+sys.path.append(os.path.abspath(os.curdir))
+from ablelabs.neon.common.notable.structs import Speed, FlowRate, LedBarParam
+from ablelabs.neon.common.alma.enums import LocationType, LocationReference
+
+
+@dataclass
+class Location:
+    location_type: LocationType
+    location_number: int = None
+    well: str = None
+    reference: LocationReference = None
+    offset: tuple[float, float, float] = (0, 0, 0)
+
+    def __str__(self):
+        # 필드값이 기본값과 다를 때만 표시
+        fields = []
+        if self.location_number == None:
+            fields.append(f"{self.location_type}")
+        else:
+            fields.append(f"{self.location_type}.{self.location_number}")
+        if self.well != None:
+            fields.append(f"well={self.well}")
+        if self.reference != None:
+            fields.append(f"reference={self.reference}")
+        if self.offset != (0, 0, 0):
+            fields.append(f"offset={self.offset}")
+        return f"Location({', '.join(fields)})"
+
+
+def location(
+    location_type: LocationType = LocationType.DECK,
+    location_number: int = None,
+    well: str = None,
+    reference: LocationReference = None,
+    offset: tuple[float] = (0, 0, 0),
+):
+    return Location(
+        location_type=location_type,
+        location_number=location_number,
+        well=well,
+        reference=reference,
+        offset=offset,
+    )
+
+
+class MeasurementTimeMode(Enum):
+    SHORT = "SHOR"
+    MEDIUM = "MED"
+    LONG = "LONG"
+
+
+@dataclass
+class LCRParam:
+    # preset value
+    data_format_long: bool = False
+    # function_impedance_type: FunctionImpedanceType = FunctionImpedanceType.CP_D
+    frequency: float = 1000
+    voltage_level: float = 1
+    measurement_time_mode: MeasurementTimeMode = MeasurementTimeMode.MEDIUM
+    averaging_rate: int = 1
+
+
+class HeaterData(TypedDict):
+    on: bool
+    temperature: float

ablelabs-0.0.66/ablelabs/neon/common/notable/constants.py

@@ -0,0 +1,13 @@
+import sys, os
+
+sys.path.append(os.path.abspath(os.curdir))
+from ablelabs.neon.common.suitable.enums import Axis
+
+PIPETTE_COUNT: int = 2
+DECK_COUNT: int = 12
+
+PIPETTE_NUMBERS = [i + 1 for i in range(PIPETTE_COUNT)]
+DECK_NUMBERS = [i + 1 for i in range(DECK_COUNT)]
+
+AXIS_ZS = [Axis.Z[n] for n in PIPETTE_NUMBERS]
+AXIS_PS = [Axis.P[n] for n in PIPETTE_NUMBERS]

ablelabs-0.0.66/ablelabs/neon/common/notable/enums.py

@@ -0,0 +1,105 @@
+import sys, os
+
+sys.path.append(os.path.abspath(os.curdir))
+from ablelabs.neon.utils.enum_types import StrEnum, auto, IntFlag, IntEnum, ItemGetable
+
+
+class NUMBERING_ORDER(StrEnum):
+    LTR_TTB = auto()  # Left to Right, Top to Bottom
+    LTR_BTT = auto()  # Left to Right, Bottom to Top
+    TTB_LTR = auto()  # Top to Bottom, Left to Right
+    BTT_LTR = auto()  # Bottom to Top, Left to Right
+
+
+class Color(IntFlag):
+    NONE = 0
+    RED = 1 << 0
+    GREEN = 1 << 1
+    BLUE = 1 << 2
+    WHITE = 1 << 3
+    CYAN = GREEN | BLUE
+    MAGENTA = RED | BLUE
+    YELLOW = RED | GREEN
+
+
+class RunStatus(IntEnum):
+    BOOT = auto()
+    SHUTDOWN = auto()
+    READY = auto()
+    DONE = auto()
+    INITIALIZE = auto()
+    RUN = auto()
+    PAUSE = auto()
+    # 의도한 상황
+    STOP = auto()
+    EMERGENCY = auto()
+    # 예기치 못한 상황
+    ERROR = auto()  # 일반적인 에러
+    TIMEOUT = auto()
+    FAULT = auto()
+
+
+class TaskStatus(StrEnum):
+    RUNNING = auto()
+    PAUSED = auto()
+    STOPPED = auto()
+
+
+class Axis(StrEnum):
+    X = auto()
+    Y = auto()
+    Z1 = auto()
+    Z2 = auto()
+    P1 = auto()
+    P2 = auto()
+
+    @staticmethod
+    def Z_(pipette_number: int):
+        return Axis.from_str(f"{Axis.Z1[0]}{pipette_number}")
+
+    @staticmethod
+    def P_(pipette_number: int):
+        return Axis.from_str(f"{Axis.P1[0]}{pipette_number}")
+
+    Z = ItemGetable[int](lambda number: Axis.from_str(f"{Axis.Z1[0]}{number}"))
+    P = ItemGetable[int](lambda number: Axis.from_str(f"{Axis.P1[0]}{number}"))
+
+
+class LabwareType(StrEnum):
+    TIP_RACK = auto()
+    WASTE = auto()
+    WELL_PLATE = auto()
+
+    def __eq__(self, __value: object) -> bool:
+        return super().__eq__(str(__value).upper())
+
+
+class Height(StrEnum):
+    UP = auto()
+    TOP = auto()
+    TOP_JUST = auto()
+    BOTTOM = auto()
+    BOTTOM_JUST = auto()
+    TIP_RACK_TOUCHED = auto()
+    TIP_RACK_PRESSED = auto()
+    WASTE_DROP_TIP = auto()
+    WASTE_BLOW_OUT = auto()
+
+
+class Plunger(StrEnum):
+    HOME_OFFSET = auto()
+    DROP_TIP = auto()
+    TOP = auto()
+    FIRST_STOP = auto()
+    SECOND_STOP = auto()
+
+
+class LocationType(StrEnum):
+    DECK = auto()
+
+
+class LocationReference(StrEnum):
+    TOP = auto()
+    TOP_JUST = auto()
+    BOTTOM = auto()
+    BOTTOM_JUST = auto()

ablelabs-0.0.66/ablelabs/neon/common/notable/kribb/structs.py

@@ -0,0 +1,33 @@
+from dataclasses import dataclass
+import cv2
+
+import sys, os
+
+sys.path.append(os.path.abspath(os.curdir))
+from ablelabs.neon.common.notable.structs import *
+
+
+@dataclass
+class LabelInfo:
+    index: int
+    width: int
+    height: int
+    area: int
+    centroid: tuple[float, float]
+    inscribed_center: tuple[float, float]
+    inscribed_radius: int
+    perimeter: float
+    circularity: float
+    brightness: float
+    color: tuple[float, float, float]
+    contours: list[cv2.Mat]
+
+
+@dataclass
+class ColonyInfo:
+    x_ratio: float
+    y_ratio: float
+    area: float
+    circularity: float
+    brightness: float
+    color: tuple[float, float, float]

ablelabs-0.0.66/ablelabs/neon/common/notable/structs.py

@@ -0,0 +1,149 @@
+from dataclasses import dataclass
+
+import sys, os
+
+sys.path.append(os.path.abspath(os.curdir))
+from ablelabs.neon.common.notable.enums import Color, LocationType, LocationReference
+from ablelabs.neon.utils.format_conversion import floor_precision
+
+
+@dataclass
+class Speed:
+    unit: str
+    unit_s: float = None
+    rate: float = None
+
+    def __str__(self) -> str:
+        result = []
+        if self.unit_s != None:
+            result.append(f"{self.unit_s}{self.unit}/s")
+        if self.rate != None:
+            result.append(f"{floor_precision(self.rate * 100, digit=3)}%")
+        return f"{' '.join(result)}"
+
+    def __repr__(self) -> str:
+        return self.__str__()
+
+    # None인 속성 제외
+    # def __repr__(self):
+    #     field_strings = []
+    #     for field in fields(self):
+    #         value = getattr(self, field.name)
+    #         if value is not None:
+    #             field_strings.append(f"{field.name}={repr(value)}")
+    #     field_string = ", ".join(field_strings)
+    #     return f"{self.__class__.__name__}({field_string})"
+
+    @staticmethod
+    def from_mm(mm: float):
+        return Speed(unit="mm", unit_s=mm)
+
+    @staticmethod
+    def from_rate(rate: float = 1.0):
+        return Speed(unit="mm", rate=rate)
+
+
+class FlowRate(Speed):
+    @staticmethod
+    def from_ul(ul: float):
+        return Speed(unit="ul", unit_s=ul)
+
+    @staticmethod
+    def from_rate(rate: float = 1.0):
+        return Speed(unit="ul", rate=rate)
+
+
+@dataclass
+class LedBarParam:
+    color: Color = Color.NONE
+    on_brightness_percent: int = None
+    off_brightness_percent: int = None
+    bar_percent: int = None
+    blink_time_ms: int = None
+
+
+@dataclass
+class Location:
+    location_type: LocationType
+    location_number: int
+    well: str
+    reference: LocationReference
+    offset: tuple[float] = (0, 0, 0)
+
+    # def to(
+    #     self,
+    #     location_number: int = None,
+    #     well: str = None,
+    #     reference: LocationReference = None,
+    #     offset: tuple[float] = None,
+    # ):
+    #     return Location(
+    #         location_type=self.location_type,
+    #         location_number=(
+    #             location_number if location_number else self.location_number
+    #         ),
+    #         well=well if well else self.well,
+    #         reference=reference if reference else self.reference,
+    #         offset=offset if offset else self.offset,
+    #     )
+
+    def __str__(self) -> str:
+        # inspect만으로는 원하는 형태로 만들기가 어려울 듯.
+        # result = " ".join(
+        #     [
+        #         f"{name}={value}"
+        #         for name, value in inspect.getmembers(self)
+        #         if "__" not in name and not inspect.isfunction(value)
+        #     ]
+        # )
+        # return result
+        result = f"{self.location_type}"
+        if self.location_number:
+            result += f".{self.location_number}"
+        if self.well:
+            result += f" well={self.well}"
+        if self.reference:
+            result += f" reference={self.reference}"
+        if self.offset and self.offset != (0, 0, 0):
+            result += f" offset={self.offset}"
+        return result
+
+    def __repr__(self) -> str:
+        return self.__str__()
+
+
+def location(
+    location_type: LocationType = LocationType.DECK,
+    location_number: int = None,
+    well: str = None,
+    reference: LocationReference = None,
+    offset: tuple[float] = (0, 0, 0),
+):
+    return Location(
+        location_type=location_type,
+        location_number=location_number,
+        well=well,
+        reference=reference,
+        offset=offset,
+    )
+
+
+if __name__ == "__main__":
+    flow_rate = FlowRate.from_rate()
+    print(flow_rate)
+    flow_rate = FlowRate.from_rate(0.12345)
+    print(flow_rate)
+    flow_rate = FlowRate.from_rate(0.012345)
+    print(flow_rate)
+
+    led_bar_param = LedBarParam()
+    print(led_bar_param)
+
+    loc = Location(
+        location_type=LocationType.DECK,
+        location_number=12,
+        well="a6",
+        reference=LocationReference.BOTTOM,
+        offset=(1, 2, 3),
+    )
+    print(loc)

ablelabs-0.0.66/ablelabs/neon/common/path.py

@@ -0,0 +1,72 @@
+import os
+import sys
+from loguru import logger
+
+REQUIRED_FILES = [
+    # "deck.json",
+    "region.json",
+    "pipette.json",
+    "tip.json",
+    "labware.json",
+    "setup_data.toml",
+    "driver_param.toml",
+]
+
+
+class Path:
+    def __init__(
+        self,
+        required_files: list[str] = REQUIRED_FILES,
+        required_dirs: list[str] = [],
+    ) -> None:
+        is_production = Path.is_production()
+        root_path = Path.get_root_path()
+        # print(f"root_path = {root_path}")
+        if is_production:
+            config_path = Path.get_config_path(root_path, required_files)
+        else:
+            config_path = Path.get_config_path(root_path, required_files, required_dirs)
+        self._config_path = config_path
+        logger.debug(f"root_path={root_path}  config_path={config_path}")
+        # sypark platform 의존성 주입에 따라 경로 설정 변경 필요.
+        # self.DECK_PATH = os.path.join(config_path, "deck.json")
+        self.REGION_PATH = os.path.join(config_path, "region.json")
+        self.PIPETTE_PATH = os.path.join(config_path, "pipette.json")
+        self.TIP_PATH = os.path.join(config_path, "tip.json")
+        self.DECK_MODULE_PATH = os.path.join(config_path, "deck_module.json")
+        self.LABWARE_PATH = os.path.join(config_path, "labware.json")
+        self.SETUP_DATA_PATH = os.path.join(config_path, "setup_data.toml")
+        self.DRIVER_PARAM_PATH = os.path.join(config_path, "driver_param.toml")
+        
+    @property
+    def config_path(self):
+        return self._config_path
+
+    @staticmethod
+    def is_production() -> bool:
+        """PyInstaller에 의해 배포되었는지 여부"""
+        # return getattr(sys, "_MEIPASS", False)
+        return getattr(
+            sys, "frozen", False
+        )  # cx_Freeze 같은 다른 패키징 도구에도 해당.
+
+    @staticmethod
+    def get_root_path() -> str:
+        if Path.is_production():
+            root_path = os.path.dirname(
+                os.path.abspath(sys.executable)
+            )  # 실행 파일 경로.
+        else:
+            root_path = os.path.abspath(os.curdir)  # 프로젝트 경로.
+        return root_path
+
+    @staticmethod
+    def get_config_path(
+        root_path: str, required_files: list[str], required_dirs: list[str] = []
+    ):
+        for dirpath, dirnames, filenames in os.walk(root_path):
+            if all(required_dir in dirpath for required_dir in required_dirs) and all(
+                required_file in filenames for required_file in required_files
+            ):
+                return dirpath
+        return None

ablelabs-0.0.66/ablelabs/neon/common/suitable/constants.py

@@ -0,0 +1,16 @@
+import sys, os
+
+sys.path.append(os.path.abspath(os.curdir))
+from ablelabs.neon.common.suitable.enums import Axis
+
+DI_COUNT: int = 8
+DO_COUNT: int = 8
+
+PIPETTE_COUNT: int = 8
+PIPETTE_NUMBERS = [i + 1 for i in range(PIPETTE_COUNT)]
+
+AXIS_YS = [Axis.Y[n] for n in PIPETTE_NUMBERS]
+AXIS_ZS = [Axis.Z[n] for n in PIPETTE_NUMBERS]
+AXIS_PS = [Axis.P[n] for n in PIPETTE_NUMBERS]
+
+Y_MIN_INTERVAL_MM = 9.0

ablelabs-0.0.66/ablelabs/neon/common/suitable/enums.py

@@ -0,0 +1,100 @@
+import sys, os
+
+sys.path.append(os.path.abspath(os.curdir))
+from ablelabs.neon.common.notable.enums import (
+    NUMBERING_ORDER,
+    Color,
+    RunStatus,
+    TaskStatus,
+    LabwareType,
+    Height,
+    Plunger,
+)
+from ablelabs.neon.utils.enum_types import Enum, auto, StrEnum, ItemGetable
+
+
+class LedLamp(Enum):
+    NONE = auto()
+    RED = auto()
+    GREEN = auto()
+    BLUE = auto()
+
+
+class Buzzer(Enum):
+    DONE = auto()
+    ERROR = auto()
+
+
+class Axis(StrEnum):
+    X = auto()
+    Y1 = auto()
+    Y2 = auto()
+    Y3 = auto()
+    Y4 = auto()
+    Y5 = auto()
+    Y6 = auto()
+    Y7 = auto()
+    Y8 = auto()
+    Z1 = auto()
+    Z2 = auto()
+    Z3 = auto()
+    Z4 = auto()
+    Z5 = auto()
+    Z6 = auto()
+    Z7 = auto()
+    Z8 = auto()
+    P1 = auto()
+    P2 = auto()
+    P3 = auto()
+    P4 = auto()
+    P5 = auto()
+    P6 = auto()
+    P7 = auto()
+    P8 = auto()
+
+    Y = ItemGetable[int](lambda number: Axis.from_str(f"{Axis.Y1[0]}{number}"))
+    Z = ItemGetable[int](lambda number: Axis.from_str(f"{Axis.Z1[0]}{number}"))
+    P = ItemGetable[int](lambda number: Axis.from_str(f"{Axis.P1[0]}{number}"))
+
+
+class LocationType(StrEnum):
+    READY = auto()
+    DECK = auto()
+    TUBE_384 = auto()
+    TEST_TUBE = auto()
+    BALANCE = auto()
+    WASTE = auto()
+
+
+class LocationReference(StrEnum):
+    TOP = auto()
+    TOP_JUST = auto()
+    BOTTOM = auto()
+    BOTTOM_JUST = auto()
+    LIQUID = auto()  # for LLD only when aspirate
+
+
+class AssignmentStatus(StrEnum):
+    NOT_ASSIGNED = auto()
+    ASSIGNING = auto()
+    ASSIGNED = auto()
+
+
+class MotionStr(StrEnum):
+    READY = auto()
+    INITIALIZE = auto()
+    PICK_UP_TIP = auto()
+    ASPIRATE = auto()
+    DISPENSE = auto()
+    DROP_TIP = auto()
+
+
+class PipetteCalibrationType(StrEnum):
+    Tip_1000_DW = auto()
+    Tip_1000_ACN = auto()
+    Tip_200_ACN = auto()
+
+
+if __name__ == "__main__":
+    y1 = Axis.Y[1]
+    print(y1)