@opentrons/shared-data 0.1.6-alpha.18 → 0.1.6-alpha.21

package/lib/labware/repository/schemas/1.json

@@ -1,81 +0,0 @@
-{
-    "$id": "opentronsLabwareRepositorySchemaV1",
-    "$schema": "http://json-schema.org/draft-07/schema#",
-    "type": "object",
-    "format": "This schema defines the labware repository interface. Labware entries must be keyed by labware def uri, with values representing each labware's data",
-    "properties": {
-        "metadata": {
-            "type": "object",
-            "properties": {
-                "name": {
-                    "type": "string",
-                    "description": "name of the labware repository"
-                },
-                "owner": {
-                    "type": "string",
-                    "description": "owner of the labware repository"
-                },
-                "lastModifiedDate": {
-                    "type": "string",
-                    "format": "date-time"
-                }
-            },
-            "required": ["name", "owner", "lastModifiedDate"]
-        }
-    },
-    "patternProperties": {
-        "^[0-9a-fA-F-]{36}$": {
-            "type": "object",
-            "properties": {
-                "labwareDefUri": {
-                    "type": "string",
-                    "format": "labware definition uri"
-                },
-                "definitionPath": {
-                    "type": "string",
-                    "description": "a path to the labware definition relative to the index file’s containing directory"
-                },
-                "additionalContent": {
-                    "type": "array",
-                    "description": "additional metadata for file contents for this labware",
-                    "items": {
-                        "type": "object",
-                        "properties": {
-                            "contentMimeType": {
-                                "type": "string"
-                            },
-                            "semanticType": {
-                                "type": "string",
-                                "enum": [
-                                    "orthographicViewImage",
-                                    "topViewImage",
-                                    "longSideViewImage",
-                                    "shortSideViewImage"
-                                ]
-                            },
-                            "contentPath": {
-                                "type": "string"
-                            }
-                        },
-                        "required": ["contentMimeType", "semanticType", "contentPath"]
-                    }
-                },
-                "lastEditTimestamp": {
-                    "type": "string",
-                    "format": "date-time"
-                },
-                "valid": {
-                    "type": "boolean"
-                }
-            },
-            "required": [
-                "labwareDefUri",
-                "definitionPath",
-                "additionalContent",
-                "lastEditTimestamp",
-                "valid"
-            ]
-        }
-    },
-    "additionalProperties": false
-}

package/lib/labware/schemas/2.json

@@ -1,389 +0,0 @@
-{
-    "$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"
-            ]
-        },
-        "safeString": {
-            "description": "a string safe to use for loadName / namespace. Lowercase-only.",
-            "type": "string",
-            "pattern": "^[a-z0-9._]+$"
-        },
-        "coordinates": {
-            "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/coordinates",
-                    "description": "Offset added to calculate pick-up coordinates."
-                },
-                "dropOffset": {
-                    "$ref": "#/definitions/coordinates",
-                    "description": "Offset added to calculate drop coordinates."
-                }
-            }
-        }
-    },
-    "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"
-                },
-                "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": {
-            "type": "object",
-            "additionalProperties": false,
-            "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.",
-            "required": ["x", "y", "z"],
-            "properties": {
-                "x": { "type": "number" },
-                "y": { "type": "number" },
-                "z": { "type": "number" }
-            }
-        },
-        "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]+": {
-                    "type": "object",
-                    "additionalProperties": false,
-                    "required": ["depth", "shape", "totalLiquidVolume", "x", "y", "z"],
-                    "oneOf": [
-                        { "required": ["xDimension", "yDimension"] },
-                        { "required": ["diameter"] }
-                    ],
-                    "not": {
-                        "anyOf": [
-                            { "required": ["diameter", "xDimension"] },
-                            { "required": ["diameter", "yDimension"] }
-                        ]
-                    },
-                    "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"
-                        },
-                        "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"
-                        },
-                        "totalLiquidVolume": {
-                            "description": "Total well, tube, or tip volume in microliters",
-                            "$ref": "#/definitions/positiveNumber"
-                        },
-                        "xDimension": {
-                            "description": "x dimension of rectangular wells",
-                            "$ref": "#/definitions/positiveNumber"
-                        },
-                        "yDimension": {
-                            "description": "y dimension of rectangular wells",
-                            "$ref": "#/definitions/positiveNumber"
-                        },
-                        "diameter": {
-                            "description": "diameter of circular wells",
-                            "$ref": "#/definitions/positiveNumber"
-                        },
-                        "shape": {
-                            "description": "If 'rectangular', use xDimension and yDimension; if 'circular' use diameter",
-                            "type": "string",
-                            "enum": ["rectangular", "circular"]
-                        }
-                    }
-                }
-            }
-        },
-        "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"]
-            }
-        },
-        "stackingOffsetWithLabware": {
-            "type": "object",
-            "description": "Supported labware that can be stacked upon, with overlap height between both labware.",
-            "additionalProperties": {
-                "$ref": "#/definitions/coordinates"
-            }
-        },
-        "stackingOffsetWithModule": {
-            "type": "object",
-            "description": "Supported module that can be stacked upon, with overlap height between labware and module.",
-            "additionalProperties": {
-                "$ref": "#/definitions/coordinates"
-            }
-        },
-        "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."
-        }
-    }
-}