etlup 4.3.0__tar.gz → 4.3.2__tar.gz

{etlup-4.3.0 → etlup-4.3.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: etlup
-Version: 4.3.0
+Version: 4.3.2
 Summary: Test definitions, plotting and documentation for the CMS MTD ETL project
 Author: Hayden Swanson
 Author-email: Hayden Swanson <hayden.swanson@cern.ch>

{etlup-4.3.0 → etlup-4.3.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "etlup"
-version = "4.3.0"
+version = "4.3.2"
 description = "Test definitions, plotting and documentation for the CMS MTD ETL project"
 readme = "README.md"
 requires-python = ">=3.8"

etlup-4.3.2/src/etlup/hybrid/HybridVisualInspection.py

@@ -0,0 +1,96 @@
+from pydantic import ConfigDict, Field
+from typing_extensions import Annotated, Literal, Union, Optional
+
+from .. import base_model as bm, jinja_env
+from ..custom_types import Image
+from ..plot_utils import image_src
+
+# How much residue is left on the pads, from none at all to a lot of it.
+PadResidue = Literal['Clean', 'Light', 'Moderate', 'Heavy']
+
+# A 1x1 PNG, just enough for the example below to be a real image.
+_EXAMPLE_IMAGE = (
+    "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAAAAAA6fptVAAAACklEQVR4nGO4AAAA0gDR29kOtwAAAABJRU5ErkJggg=="
+)
+
+class HybridVisualInspectionV0(bm.ConstructionBase):
+    model_config = ConfigDict(json_schema_extra={
+        'examples': [
+            {
+                "component": "ET2.01-PT-NH21",
+                "name": "hybrid_visual_inspection",
+                "location": "KNU",
+                "user_created": "ypark",
+                "version": "v0",
+                "measurement_date": "2026-07-29T12:01:00+02:00",
+                "pad_residue": "Light",
+                "bump_damage": False,
+                "mechanical_damage": False,
+                "shifted_hybrids": False,
+                "image": _EXAMPLE_IMAGE,
+                "comment": "A little residue on the top left pads, otherwise fine.",
+                "passed": True,
+            },
+            {
+                "component": "ET2.01-PT-NH22",
+                "name": "hybrid_visual_inspection",
+                "location": "KNU",
+                "user_created": "ypark",
+                "version": "v0",
+                "measurement_date": "2026-07-29T12:05:00+02:00",
+                "mechanical_damage": True,
+                "passed": False,
+            },
+        ],
+        'table': 'test',
+        'category': 'Subassembly',
+        'component_types': [],
+        'module_types': [],
+        'description': (
+            'Visual inspection of a hybrid. Records how much residue is on the pads '
+            '(Clean, Light, Moderate or Heavy), whether there is bump damage, mechanical damage '
+            'or shifted hybrids, an overall passed verdict, and optionally a photograph, base64 '
+            'encoded, and a comment. Every field is optional, so only what was looked at needs to be sent.'
+        )
+    })
+
+    name: Literal['hybrid_visual_inspection'] = 'hybrid_visual_inspection'
+    version: Literal["v0"] = "v0"
+    component: str
+
+    # None means it was not looked at, not that it was fine.
+    pad_residue: Optional[PadResidue] = None
+    bump_damage: Optional[bool] = None
+    mechanical_damage: Optional[bool] = None
+    shifted_hybrids: Optional[bool] = None
+    image: Optional[Image] = None
+    comment: Optional[str] = None
+    passed: Optional[bool] = None  # None until somebody decides
+
+    def plot(self):
+        return None
+
+    def html_display(self) -> str:
+        display_data = {
+            "passed": self.passed,
+            "pad_residue": self.pad_residue,
+            "bump_damage": self.bump_damage,
+            "mechanical_damage": self.mechanical_damage,
+            "shifted_hybrids": self.shifted_hybrids,
+            "comment": self.comment,
+        }
+        if self.image is None:
+            img_html = "<p>No image was given with this inspection.</p>"
+        else:
+            img_html = (
+                f'<img src="{image_src(self.image)}" alt="{self.component} visual inspection" '
+                'style="width: clamp(300px, 75vw, 1000px); height: auto;">'
+            )
+        template = jinja_env.get_template('test_by_image.html')
+        return template.render(
+            display_data=display_data,
+            img_html=img_html
+        )
+
+
+HybridVisualInspectionType = Annotated[Union[HybridVisualInspectionV0], Field(discriminator="version")]

etlup-4.3.2/src/etlup/hybrid/ProbeCardI2CConnection.py

@@ -0,0 +1,73 @@
+from pydantic import ConfigDict, Field
+from typing_extensions import Annotated, Literal, Union, Optional
+
+from .. import base_model as bm, jinja_env
+
+class ProbeCardI2CConnectionV0(bm.ConstructionBase):
+    model_config = ConfigDict(json_schema_extra={
+        'examples': [
+            {
+                "component": "ET2.01-PT-NH21",
+                "name": "probe_card_i2c_connection",
+                "location": "KNU",
+                "user_created": "ypark",
+                "version": "v0",
+                "measurement_date": "2026-07-29T12:01:00+02:00",
+                "i2c_connection": True,
+                "current_digital": 0.12,
+                "current_analog": 0.35,
+                "comment": None,
+                "passed": True,
+            },
+            {
+                "component": "ET2.01-PT-NH22",
+                "name": "probe_card_i2c_connection",
+                "location": "KNU",
+                "user_created": "ypark",
+                "version": "v0",
+                "measurement_date": "2026-07-29T12:05:00+02:00",
+                "i2c_connection": False,
+                "comment": "No I2C response from the ETROC.",
+                "passed": False,
+            },
+        ],
+        'table': 'test',
+        'category': 'Subassembly',
+        'component_types': [],
+        'module_types': [],
+        'description': (
+            'Checks that a hybrid talks over I2C on the probe card. Records whether the I2C '
+            'connection was made, an overall passed verdict, and optionally the digital and analog '
+            'currents drawn and a comment.'
+        )
+    })
+
+    name: Literal['probe_card_i2c_connection'] = 'probe_card_i2c_connection'
+    version: Literal["v0"] = "v0"
+    component: str
+
+    i2c_connection: bool
+    current_digital: Optional[float] = None
+    current_analog: Optional[float] = None
+    comment: Optional[str] = None
+    passed: Optional[bool] = None  # None until somebody decides
+
+    def plot(self):
+        return None
+
+    def html_display(self) -> str:
+        display_data = {
+            "passed": self.passed,
+            "i2c_connection": self.i2c_connection,
+            "current_digital": self.current_digital,
+            "current_analog": self.current_analog,
+            "comment": self.comment,
+        }
+        template = jinja_env.get_template('test_by_image.html')
+        return template.render(
+            display_data=display_data,
+            img_html=""
+        )
+
+
+ProbeCardI2CConnectionType = Annotated[Union[ProbeCardI2CConnectionV0], Field(discriminator="version")]

{etlup-4.3.0 → etlup-4.3.2}/src/etlup/sensor/SensorIV.py

@@ -81,4 +81,32 @@ class SensorIVV0(base_model.ConstructionBase):
             display_data = display_data
         )
 
-SensorIVType = Annotated[Union[SensorIVV0], Field(discriminator="version")]
+class SensorIVV1(SensorIVV0):
+    model_config = ConfigDict(json_schema_extra={
+        'examples': [
+            {
+                "component": "FBK_LF1_ROL_054",
+                "name": "Sensor IV",
+                "measurement_date": "2023-01-01T12:00:00+01:00",
+                "location": "UT",
+                "user_created": "fsiviero",
+                "version": "v1",
+                "leakage_current_uA": 158.176,
+                "breakdown_voltage_V": 282.0,
+                "category": "BAD",
+                "gain_category": "BD3",
+                "current": [1.798e-9, 2.132e-9,2.389e-9,2.667e-9,2.991e-9,3.373e-9,3.882e-9,4.470e-9,5.163e-9,5.98e-9,6.888e-9,7.861e-9,8.972e-9,9.177e-9,1.135e-8,1.334e-8,1.591e-8,1.956e-8,2.418e-8,2.950e-8,4.237e-8,5.572e-6,0.0000257,0.0000342,0.0000405,0.0000441,0.0000454,0.0000519,0.0000652,0.0000757,0.00008891,0.0001137,0.000133,0.000151,0.000165,0.0001832,0.000201,0.000213,0.000224,0.000234,0.000245,0.000256,0.000271,0.000286,0.000301,0.000313,0.000325,0.000337,0.000349,0.000371],
+                "voltage": [0.0,2.0,4.0,6.0,8.0,10.0,12.0,14.0,16.0,18.0,20.0,22.0,23.0,25.0,26.0,28.0,30.0,32.0,34.0,36.0,38.0,40.0,41.0,43.0,45.0,47.0,49.0,50.0,55.0,60.0,65.0,70.0,75.0,80.0,85.0,90.0,95.0,100.0,105.0,110.0,115.0,120.0,125.0,130.0,135.0,140.0,145.0,150.0,155.0,160.0],
+            }
+        ],
+        'table': 'test',
+        'category': 'LGAD',
+        'component_types': [],
+        'module_types': [],
+        'description': 'IV curves and other QC info of the sensors recieved from a vendor and tested by ETL sensor experts'
+    })
+
+    version: Literal["v1"] = "v1"
+    gain_category: Union[None, Literal["BD1", "BD2", "BD3", "BD4", "BD5", "BD6", "BD7", "BD8", "BD9", "BD10"]] = Field(None, validation_alias=AliasChoices('gain_category','Gain Category'))
+
+SensorIVType = Annotated[Union[SensorIVV0, SensorIVV1], Field(discriminator="version")]