opentrons-shared-data 8.8.0a10__py3-none-any.whl

opentrons_shared_data/data/labware/schemas/2.json

@@ -0,0 +1,755 @@
+{
+  "$id": "opentronsLabwareSchemaV2",
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "definitions": {
+    "positiveNumber": {
+      "type": "number",
+      "minimum": 0
+    },
+    "brandData": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["brand"],
+      "properties": {
+        "brand": {
+          "type": "string",
+          "description": "Brand/manufacturer name"
+        },
+        "brandId": {
+          "type": "array",
+          "description": "An array of manufacture numbers pertaining to a given labware",
+          "items": {
+            "type": "string"
+          }
+        },
+        "links": {
+          "type": "array",
+          "description": "URLs for manufacturer page(s)",
+          "items": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    "displayCategory": {
+      "type": "string",
+      "enum": [
+        "tipRack",
+        "tubeRack",
+        "reservoir",
+        "trash",
+        "wellPlate",
+        "aluminumBlock",
+        "adapter",
+        "other",
+        "lid",
+        "system"
+      ]
+    },
+    "safeString": {
+      "description": "a string safe to use for loadName / namespace. Lowercase-only.",
+      "type": "string",
+      "pattern": "^[a-z0-9._]+$"
+    },
+    "vector": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["x", "y", "z"],
+      "properties": {
+        "x": {
+          "type": "number"
+        },
+        "y": {
+          "type": "number"
+        },
+        "z": {
+          "type": "number"
+        }
+      }
+    },
+    "pickUpAndDropOffsets": {
+      "type": "object",
+      "required": ["pickUpOffset", "dropOffset"],
+      "properties": {
+        "pickUpOffset": {
+          "$ref": "#/definitions/vector",
+          "description": "Offset added to calculate pick-up coordinates."
+        },
+        "dropOffset": {
+          "$ref": "#/definitions/vector",
+          "description": "Offset added to calculate drop coordinates."
+        }
+      }
+    },
+    "well": {
+      "anyOf": [
+        { "$ref": "#/definitions/rectangularWell" },
+        { "$ref": "#/definitions/circularWell" }
+      ]
+    },
+    "rectangularWell": {
+      "type": "object",
+      "required": [
+        "shape",
+        "depth",
+        "totalLiquidVolume",
+        "x",
+        "y",
+        "z",
+        "xDimension",
+        "yDimension"
+      ],
+      "$comment": "The properties with a subschema of `true` ('always pass') are defined in wellCommon. They need to be mentioned here for additionalProperties to work right, until we have JSON Schema 2019-09 and we can switch to unevaluatedProperties.",
+      "properties": {
+        "shape": {
+          "const": "rectangular"
+        },
+        "depth": true,
+        "totalLiquidVolume": true,
+        "x": true,
+        "y": true,
+        "z": true,
+        "geometryDefinitionId": true,
+        "xDimension": {
+          "description": "x dimension of rectangular wells",
+          "$ref": "#/definitions/positiveNumber"
+        },
+        "yDimension": {
+          "description": "y dimension of rectangular wells",
+          "$ref": "#/definitions/positiveNumber"
+        }
+      },
+      "additionalProperties": false,
+      "allOf": [{ "$ref": "#/definitions/wellCommon" }]
+    },
+    "circularWell": {
+      "type": "object",
+      "required": [
+        "shape",
+        "depth",
+        "totalLiquidVolume",
+        "x",
+        "y",
+        "z",
+        "diameter"
+      ],
+      "$comment": "The properties with a subschema of `true` ('always pass') are defined in wellCommon. They need to be mentioned here for additionalProperties to work right, until we have JSON Schema 2019-09 and we can switch to unevaluatedProperties.",
+      "properties": {
+        "shape": {
+          "const": "circular"
+        },
+        "depth": true,
+        "totalLiquidVolume": true,
+        "x": true,
+        "y": true,
+        "z": true,
+        "geometryDefinitionId": true,
+        "diameter": {
+          "description": "diameter of circular wells",
+          "$ref": "#/definitions/positiveNumber"
+        }
+      },
+      "additionalProperties": false,
+      "allOf": [{ "$ref": "#/definitions/wellCommon" }]
+    },
+    "wellCommon": {
+      "$comment": "These properties need to stay in sync with rectangularWell and circularWell. See comments there.",
+      "properties": {
+        "depth": {
+          "description": "The distance between the top and bottom of this well. If the labware is a tip rack, this will be ignored in favor of tipLength, but the values should match.",
+          "$ref": "#/definitions/positiveNumber"
+        },
+        "totalLiquidVolume": {
+          "description": "Total well, tube, or tip volume in microliters",
+          "$ref": "#/definitions/positiveNumber"
+        },
+        "x": {
+          "description": "x location of center-bottom of well in reference to left-front-bottom of labware",
+          "$ref": "#/definitions/positiveNumber"
+        },
+        "y": {
+          "description": "y location of center-bottom of well in reference to left-front-bottom of labware",
+          "$ref": "#/definitions/positiveNumber"
+        },
+        "z": {
+          "description": "z location of center-bottom of well in reference to left-front-bottom of labware",
+          "$ref": "#/definitions/positiveNumber"
+        },
+        "geometryDefinitionId": {
+          "description": "string id of the well's corresponding innerWellGeometry",
+          "type": ["string", "null"]
+        }
+      }
+    },
+    "SphericalSegment": {
+      "type": "object",
+      "description": "A partial sphere shaped section at the bottom of the well.",
+      "additionalProperties": false,
+      "required": ["shape", "radiusOfCurvature", "topHeight", "bottomHeight"],
+      "properties": {
+        "shape": {
+          "type": "string",
+          "enum": ["spherical"]
+        },
+        "radiusOfCurvature": {
+          "type": "number",
+          "description": "radius of curvature of bottom subsection of wells"
+        },
+        "topHeight": {
+          "type": "number",
+          "description": "The depth of a spherical bottom of a well"
+        },
+        "bottomHeight": {
+          "type": "number",
+          "description": "Height of the bottom of the segment, must be 0.0"
+        },
+        "xCount": {
+          "type": "integer",
+          "description": "Number of instances of this shape in the stackup, used for wells that have multiple sub-wells"
+        },
+        "yCount": {
+          "type": "integer",
+          "description": "Number of instances of this shape in the stackup, used for wells that have multiple sub-wells"
+        }
+      }
+    },
+    "ConicalFrustum": {
+      "type": "object",
+      "description": "A cone or conical segment, bounded by two circles on the top and bottom.",
+      "required": [
+        "shape",
+        "bottomDiameter",
+        "topDiameter",
+        "topHeight",
+        "bottomHeight"
+      ],
+      "properties": {
+        "shape": {
+          "type": "string",
+          "enum": ["conical"]
+        },
+        "bottomDiameter": {
+          "type": "number",
+          "description": "The diameter at the bottom cross-section of a circular frustum"
+        },
+        "topDiameter": {
+          "type": "number",
+          "description": "The diameter at the top cross-section of a circular frustum"
+        },
+        "topHeight": {
+          "type": "number",
+          "description": "The height at the top of a bounded subsection of a well, relative to the bottom of the well"
+        },
+        "bottomHeight": {
+          "type": "number",
+          "description": "The height at the bottom of a bounded subsection of a well, relative to the bottom of the well"
+        },
+        "xCount": {
+          "type": "integer",
+          "description": "Number of instances of this shape in the stackup, used for wells that have multiple sub-wells"
+        },
+        "yCount": {
+          "type": "integer",
+          "description": "Number of instances of this shape in the stackup, used for wells that have multiple sub-wells"
+        }
+      }
+    },
+    "CuboidalFrustum": {
+      "type": "object",
+      "description": "A cuboidal shape bounded by two rectangles on the top and bottom",
+      "required": [
+        "shape",
+        "bottomXDimension",
+        "bottomYDimension",
+        "topXDimension",
+        "topYDimension",
+        "topHeight",
+        "bottomHeight"
+      ],
+      "properties": {
+        "shape": {
+          "type": "string",
+          "enum": ["cuboidal"]
+        },
+        "bottomXDimension": {
+          "type": "number",
+          "description": "x dimension of the bottom cross-section of a rectangular frustum"
+        },
+        "bottomYDimension": {
+          "type": "number",
+          "description": "y dimension of the bottom cross-section of a rectangular frustum"
+        },
+        "topXDimension": {
+          "type": "number",
+          "description": "x dimension of the top cross-section of a rectangular frustum"
+        },
+        "topYDimension": {
+          "type": "number",
+          "description": "y dimension of the top cross-section of a rectangular frustum"
+        },
+        "topHeight": {
+          "type": "number",
+          "description": "The height at the top of a bounded subsection of a well, relative to the bottom of the well"
+        },
+        "bottomHeight": {
+          "type": "number",
+          "description": "The height at the bottom of a bounded subsection of a well, relative to the bottom of the well"
+        },
+        "xCount": {
+          "type": "integer",
+          "description": "Number of instances of this shape in the stackup, used for wells that have multiple sub-wells"
+        },
+        "yCount": {
+          "type": "integer",
+          "description": "Number of instances of this shape in the stackup, used for wells that have multiple sub-wells"
+        }
+      }
+    },
+    "SquaredConeSegment": {
+      "type": "object",
+      "description": "The intersection of a pyramid and a cone that both share a central axis where one face is a circle and one face is a rectangle",
+      "required": [
+        "shape",
+        "bottomCrossSection",
+        "circleDiameter",
+        "rectangleXDimension",
+        "rectangleYDimension",
+        "topHeight",
+        "bottomHeight"
+      ],
+      "properties": {
+        "shape": {
+          "type": "string",
+          "enum": ["squaredcone"]
+        },
+        "bottomCrossSection": {
+          "type": "string",
+          "enum": ["circular", "rectangular"],
+          "description": "Denote if the shape is going from circular to rectangular or vise versa"
+        },
+        "circleDiameter": {
+          "type": "number",
+          "description": "diameter of the circular face of a truncated circular segment"
+        },
+        "rectangleXDimension": {
+          "type": "number",
+          "description": "x dimension of the rectangular face of a truncated circular segment"
+        },
+        "rectangleYDimension": {
+          "type": "number",
+          "description": "y dimension of the rectangular face of a truncated circular segment"
+        },
+        "topHeight": {
+          "type": "number",
+          "description": "The height at the top of a bounded subsection of a well, relative to the bottom of the well"
+        },
+        "bottomHeight": {
+          "type": "number",
+          "description": "The height at the bottom of a bounded subsection of a well, relative to the bottom of the well"
+        },
+        "xCount": {
+          "type": "integer",
+          "description": "Number of instances of this shape in the stackup, used for wells that have multiple sub-wells"
+        },
+        "yCount": {
+          "type": "integer",
+          "description": "Number of instances of this shape in the stackup, used for wells that have multiple sub-wells"
+        }
+      }
+    },
+    "RoundedCuboidSegment": {
+      "type": "object",
+      "description": "A cuboidal frustum where each corner is filleted out by circles with centers on the diagonals between opposite corners",
+      "required": [
+        "shape",
+        "bottomCrossSection",
+        "circleDiameter",
+        "rectangleXDimension",
+        "rectangleYDimension",
+        "topHeight",
+        "bottomHeight"
+      ],
+      "properties": {
+        "shape": {
+          "type": "string",
+          "enum": ["roundedcuboid"]
+        },
+        "bottomCrossSection": {
+          "type": "string",
+          "enum": ["circular", "rectangular"],
+          "description": "Denote if the shape is going from circular to rectangular or vise versa"
+        },
+        "circleDiameter": {
+          "type": "number",
+          "description": "diameter of the circular face of a rounded rectangular segment"
+        },
+        "rectangleXDimension": {
+          "type": "number",
+          "description": "x dimension of the rectangular face of a rounded rectangular segment"
+        },
+        "rectangleYDimension": {
+          "type": "number",
+          "description": "y dimension of the rectangular face of a rounded rectangular segment"
+        },
+        "topHeight": {
+          "type": "number",
+          "description": "The height at the top of a bounded subsection of a well, relative to the bottom"
+        },
+        "bottomHeight": {
+          "type": "number",
+          "description": "The height at the bottom of a bounded subsection of a well, relative to the bottom of the well"
+        },
+        "xCount": {
+          "type": "integer",
+          "description": "Number of instances of this shape in the stackup, used for wells that have multiple sub-wells"
+        },
+        "yCount": {
+          "type": "integer",
+          "description": "Number of instances of this shape in the stackup, used for wells that have multiple sub-wells"
+        }
+      }
+    },
+    "InnerWellGeometry": {
+      "type": "object",
+      "required": ["sections"],
+      "properties": {
+        "sections": {
+          "description": "A list of all of the sections of the well that have a contiguous shape. Must be ordered from top (highest z) to bottom (lowest z).",
+          "type": "array",
+          "minItems": 1,
+          "items": {
+            "oneOf": [
+              {
+                "$ref": "#/definitions/ConicalFrustum"
+              },
+              {
+                "$ref": "#/definitions/CuboidalFrustum"
+              },
+              {
+                "$ref": "#/definitions/SquaredConeSegment"
+              },
+              {
+                "$ref": "#/definitions/RoundedCuboidSegment"
+              },
+              {
+                "$ref": "#/definitions/SphericalSegment"
+              }
+            ]
+          }
+        }
+      }
+    },
+    "HeightVolumePair": {
+      "type": "object",
+      "required": ["height", "volume"],
+      "properties": {
+        "height": {
+          "description": "The height within a well at a user-defined volume.",
+          "type": "number"
+        },
+        "volume": {
+          "description": "A user-defined volume at a known height within a well.",
+          "type": "number"
+        }
+      }
+    },
+    "UserDefinedVolumes": {
+      "type": "object",
+      "required": ["heightToVolumeMap"],
+      "properties": {
+        "heightToVolumeMap": {
+          "description": "A list mapping heights to volumes [height, volume]. Must be ordered from top (highest z) to bottom (lowest z).",
+          "type": "array",
+          "minItems": 2,
+          "items": {
+            "$ref": "#/definitions/HeightVolumePair"
+          }
+        }
+      }
+    }
+  },
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "version",
+    "namespace",
+    "metadata",
+    "brand",
+    "parameters",
+    "cornerOffsetFromSlot",
+    "ordering",
+    "dimensions",
+    "wells",
+    "groups"
+  ],
+  "properties": {
+    "schemaVersion": {
+      "description": "Which schema version a labware is using",
+      "type": "number",
+      "enum": [2]
+    },
+    "version": {
+      "description": "Version of the labware definition itself (eg myPlate v1/v2/v3). An incrementing integer",
+      "type": "integer",
+      "minimum": 1
+    },
+    "namespace": {
+      "$ref": "#/definitions/safeString"
+    },
+    "metadata": {
+      "type": "object",
+      "description": "Properties used for search and display",
+      "additionalProperties": false,
+      "required": ["displayName", "displayCategory", "displayVolumeUnits"],
+      "properties": {
+        "displayName": {
+          "description": "Easy to remember name of labware",
+          "type": "string"
+        },
+        "displayCategory": {
+          "$ref": "#/definitions/displayCategory",
+          "description": "Label(s) used in UI to categorize labware"
+        },
+        "displayVolumeUnits": {
+          "description": "Volume units for display",
+          "type": "string",
+          "enum": ["µL", "mL", "L"]
+        },
+        "tags": {
+          "type": "array",
+          "description": "List of descriptions for a given labware",
+          "items": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    "brand": {
+      "$ref": "#/definitions/brandData",
+      "description": "Real-world labware that the definition is modeled from and/or compatible with"
+    },
+    "parameters": {
+      "type": "object",
+      "description": "Internal describers used to determine pipette movement to labware",
+      "additionalProperties": false,
+      "required": [
+        "format",
+        "isTiprack",
+        "loadName",
+        "isMagneticModuleCompatible"
+      ],
+      "properties": {
+        "format": {
+          "description": "Property to determine compatibility with multichannel pipette",
+          "type": "string",
+          "enum": ["96Standard", "384Standard", "trough", "irregular", "trash"]
+        },
+        "quirks": {
+          "description": "Property to classify a specific behavior this labware should have",
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "isTiprack": {
+          "description": "Flag marking whether this labware is a tip rack or not",
+          "type": "boolean"
+        },
+        "tipLength": {
+          "description": "Required if this labware is a tip rack. Specifies the total length of one of this rack's tips, from top to bottom, as specified by technical drawings or as measured with calipers.",
+          "$ref": "#/definitions/positiveNumber"
+        },
+        "tipOverlap": {
+          "description": "Required if this labware is a tip rack. Specifies how far one of this rack's tips is expected to overlap with the nozzle of a pipette. In other words: tipLength, minus the distance between the bottom of the pipette and the bottom of the tip. A robot's positional calibration may fine-tune this estimate.",
+          "$ref": "#/definitions/positiveNumber"
+        },
+        "loadName": {
+          "description": "Name used to reference a labware definition",
+          "$ref": "#/definitions/safeString"
+        },
+        "isMagneticModuleCompatible": {
+          "description": "Flag marking whether a labware is compatible by default with the Magnetic Module",
+          "type": "boolean"
+        },
+        "isDeckSlotCompatible": {
+          "description": "Flag marking whether a labware is compatible by with being placed or loaded in a base deck slot, defaults to true.",
+          "type": "boolean",
+          "default": true
+        },
+        "magneticModuleEngageHeight": {
+          "description": "Distance to move magnetic module magnets to engage",
+          "$ref": "#/definitions/positiveNumber"
+        }
+      }
+    },
+    "ordering": {
+      "type": "array",
+      "description": "Generated array that keeps track of how wells should be ordered in a labware",
+      "items": {
+        "type": "array",
+        "items": {
+          "type": "string"
+        }
+      }
+    },
+    "cornerOffsetFromSlot": {
+      "description": "Distance from left-front-bottom corner of slot to left-front-bottom corner of labware bounding box. Used for labware that spans multiple slots. For labware that does not span multiple slots, x/y/z should all be zero.",
+      "$ref": "#/definitions/vector"
+    },
+    "dimensions": {
+      "type": "object",
+      "additionalProperties": false,
+      "description": "Outer dimensions of a labware",
+      "required": ["xDimension", "yDimension", "zDimension"],
+      "properties": {
+        "yDimension": {
+          "$ref": "#/definitions/positiveNumber"
+        },
+        "zDimension": {
+          "$ref": "#/definitions/positiveNumber"
+        },
+        "xDimension": {
+          "$ref": "#/definitions/positiveNumber"
+        }
+      }
+    },
+    "wells": {
+      "type": "object",
+      "description": "Unordered object of well objects with position and dimensional information",
+      "additionalProperties": false,
+      "patternProperties": {
+        "[A-Z]+[0-9]+": {
+          "$ref": "#/definitions/well"
+        }
+      }
+    },
+    "groups": {
+      "type": "array",
+      "description": "Logical well groupings for metadata/display purposes; changes in groups do not affect protocol execution",
+      "items": {
+        "type": "object",
+        "required": ["wells", "metadata"],
+        "additionalProperties": false,
+        "properties": {
+          "wells": {
+            "type": "array",
+            "description": "An array of wells that contain the same metadata",
+            "items": {
+              "type": "string"
+            }
+          },
+          "metadata": {
+            "type": "object",
+            "description": "Metadata specific to a grid of wells in a labware",
+            "required": [],
+            "additionalProperties": false,
+            "properties": {
+              "displayName": {
+                "type": "string",
+                "description": "User-readable name for the well group"
+              },
+              "displayCategory": {
+                "$ref": "#/definitions/displayCategory",
+                "description": "Label(s) used in UI to categorize well groups"
+              },
+              "wellBottomShape": {
+                "type": "string",
+                "description": "Bottom shape of the well for UI purposes",
+                "enum": ["flat", "u", "v"]
+              }
+            }
+          },
+          "brand": {
+            "$ref": "#/definitions/brandData",
+            "description": "Brand data for the well group (e.g. for tubes)"
+          }
+        }
+      }
+    },
+    "allowedRoles": {
+      "type": "array",
+      "description": "Allowed behaviors and usage of a labware in a protocol.",
+      "items": {
+        "type": "string",
+        "enum": [
+          "labware",
+          "adapter",
+          "fixture",
+          "maintenance",
+          "lid",
+          "system"
+        ]
+      }
+    },
+    "stackingOffsetWithLabware": {
+      "type": "object",
+      "description": "Supported labware that this one can be stacked atop, with overlaps between both labware. x and y should always equal 0 to preserve intended behavior. z=0 means the bottom of this labware is at the top of the labware below it. +z moves this labware down.",
+      "additionalProperties": {
+        "$ref": "#/definitions/vector"
+      }
+    },
+    "stackingOffsetWithModule": {
+      "type": "object",
+      "description": "Supported module that can be stacked upon, with overlap height between labware and module.",
+      "additionalProperties": {
+        "$ref": "#/definitions/vector"
+      }
+    },
+    "gripperOffsets": {
+      "type": "object",
+      "description": "Offsets to add when picking up or dropping another labware stacked atop this one. Do not use this to adjust the position of the gripper paddles relative to this labware or the child labware; use `gripHeightFromLabwareBottom` on this definition or the child's definition for that.",
+      "additionalProperties": {
+        "$ref": "#/definitions/pickUpAndDropOffsets",
+        "description": "Properties here are named for, and matched based on, the deck slot that this labware is atop--or, if this labware is atop a module, the deck slot that that module is atop."
+      },
+      "properties": {
+        "default": {
+          "$ref": "#/definitions/pickUpAndDropOffsets",
+          "description": "The offsets to use if there's no slot-specific match in `additionalProperties`."
+        },
+        "lidOffsets": {
+          "$ref": "#/definitions/pickUpAndDropOffsets",
+          "description": "Additional offsets for gripping this labware, if this labware is a lid. Beware this property's placement: instead of affecting the labware stacked atop this labware, like the rest of the `gripperOffsets` properties, it affects this labware."
+        },
+        "lidDisposalOffsets": {
+          "$ref": "#/definitions/pickUpAndDropOffsets",
+          "description": "Additional offsets for gripping this labware, if this labware is a lid and it's being moved to a trash bin. Beware this property's placement: instead of affecting the labware stacked atop this labware, like the rest of the `gripperOffsets` properties, it affects this labware."
+        }
+      }
+    },
+    "gripForce": {
+      "type": "number",
+      "description": "Force, in Newtons, with which the gripper should grip the labware."
+    },
+    "gripHeightFromLabwareBottom": {
+      "type": "number",
+      "description": "Recommended Z-height, from labware bottom to the center of gripper pads, when gripping the labware."
+    },
+    "stackLimit": {
+      "type": "number",
+      "description": "The limit representing the maximum stack size for a given labware. Defaults to 1 when unspecified indicating a single labware with no labware below it."
+    },
+    "compatibleParentLabware": {
+      "type": "array",
+      "description": "Array of parent Labware on which a labware may be loaded, primarily the labware which owns a lid.",
+      "items": {
+        "type": "string"
+      }
+    },
+    "innerLabwareGeometry": {
+      "type": ["object", "null"],
+      "description": "A dictionary holding all unique inner well geometries in a labware.",
+      "additionalProperties": {
+        "oneOf": [
+          {
+            "$ref": "#/definitions/InnerWellGeometry"
+          },
+          {
+            "$ref": "#/definitions/UserDefinedVolumes"
+          }
+        ]
+      }
+    }
+  }
+}