labware 0.1.1__py3-none-any.whl

labware/__init__.py

@@ -0,0 +1,24 @@
+import importlib.resources
+
+from ._version import __version__
+from .schema import AlignmentReference, Labware, OuterDimensions, WellDimensions
+
+__all__ = [
+    'AlignmentReference',
+    'Labware',
+    'OuterDimensions',
+    'WellDimensions',
+    '__version__',
+    'load_labware',
+]
+
+
+def load_labware() -> dict[str, Labware]:
+    """Return every labware definition, keyed by its file name without ``.json``."""
+    definitions = {}
+    for entry in (importlib.resources.files(__name__) / 'definitions').iterdir():
+        if entry.name.endswith('.json'):
+            definitions[entry.name.removesuffix('.json')] = (
+                Labware.model_validate_json_file(entry)
+            )
+    return definitions

labware/_static_version.py

@@ -0,0 +1,2 @@
+# This file has been created by setup.py.
+version = '0.1.1'

labware/_version.py

@@ -0,0 +1,184 @@
+# -*- coding: utf-8 -*-
+# This file is part of 'miniver': https://github.com/jbweston/miniver
+#
+import os
+from collections import namedtuple
+
+Version = namedtuple("Version", ("release", "dev", "labels"))
+
+# No public API
+__all__ = []
+
+package_root = os.path.dirname(os.path.realpath(__file__))
+package_name = os.path.basename(package_root)
+
+STATIC_VERSION_FILE = "_static_version.py"
+
+
+def get_version(version_file=STATIC_VERSION_FILE):
+    version_info = get_static_version_info(version_file)
+    version = version_info["version"]
+    if version == "__use_git__":
+        version = get_version_from_git()
+        if not version:
+            version = get_version_from_git_archive(version_info)
+        if not version:
+            version = Version("unknown", None, None)
+        return pep440_format(version)
+    else:
+        return version
+
+
+def get_static_version_info(version_file=STATIC_VERSION_FILE):
+    version_info = {}
+    with open(os.path.join(package_root, version_file), "rb") as f:
+        exec(f.read(), {}, version_info)
+    return version_info
+
+
+def version_is_from_git(version_file=STATIC_VERSION_FILE):
+    return get_static_version_info(version_file)["version"] == "__use_git__"
+
+
+def pep440_format(version_info):
+    release, dev, labels = version_info
+
+    version_parts = [release]
+    if dev:
+        # prefer PEP440 over strict adhesion to semver
+        version_parts.append(".post{}".format(dev))
+
+    if labels:
+        version_parts.append("+")
+        version_parts.append(".".join(labels))
+
+    return "".join(version_parts)
+
+
+def get_version_from_git():
+    import subprocess
+
+    # The '--long' flag gets us the 'dev' version and
+    # The '--dirty' flag helps identify if files have been modified
+    # git hash, '--always' returns the git hash even if there are no tags.
+    for opts in [[]]:
+        try:
+            p = subprocess.Popen(
+                ["git", "describe", "--long", "--always", "--dirty", "--tags"] + opts,
+                cwd=package_root,
+                stdout=subprocess.PIPE,
+                stderr=subprocess.PIPE,
+            )
+        except OSError:
+            return
+        if p.wait() == 0:
+            break
+    else:
+        return
+
+    description = (
+        p.communicate()[0]
+        .decode()
+        .lstrip("v")  # Tags can have a leading 'v', but the version should not
+        .rstrip("\n")
+        .split("-")  # Split the latest tag, commits since tag, and hash
+    )
+
+    try:
+        release, dev, git = description[:3]
+    except ValueError:  # No tags, only the git hash
+        # prepend 'g' to match with format returned by 'git describe'
+        git = "g{}".format(*description)
+        release = "unknown"
+        dev = None
+
+    labels = []
+    if dev == "0":
+        dev = None
+    else:
+        labels.append(git)
+
+    if description[-1] == "dirty":
+        labels.append("dirty")
+
+    return Version(release, dev, labels)
+
+
+# TODO: change this logic when there is a git pretty-format
+#       that gives the same output as 'git describe'.
+#       Currently we can only tell the tag the current commit is
+#       pointing to, or its hash (with no version info)
+#       if it is not tagged.
+def get_version_from_git_archive(version_info):
+    try:
+        refnames = version_info["refnames"]
+        git_hash = version_info["git_hash"]
+    except KeyError:
+        # These fields are not present if we are running from an sdist.
+        # Execution should never reach here, though
+        return None
+
+    if git_hash.startswith("$Format") or refnames.startswith("$Format"):
+        # variables not expanded during 'git archive'
+        return None
+
+    VTAG = "tag: v"
+    refs = set(r.strip() for r in refnames.split(","))
+    version_tags = set(r[len(VTAG):] for r in refs if r.startswith(VTAG))
+    if version_tags:
+        release, *_ = sorted(version_tags)  # prefer e.g. "2.0" over "2.0rc1"
+        return Version(release, dev=None, labels=None)
+    else:
+        return Version("unknown", dev=None, labels=["g{}".format(git_hash)])
+
+
+__version__ = get_version()
+
+
+# The following section defines a 'get_cmdclass' function
+# that can be used from setup.py. The '__version__' module
+# global is used (but not modified).
+
+
+def _write_version(fname):
+    # This could be a hard link, so try to delete it first.  Is there any way
+    # to do this atomically together with opening?
+    try:
+        os.remove(fname)
+    except OSError:
+        pass
+    with open(fname, "w", encoding='utf-8') as f:
+        f.write(
+            "# This file has been created by setup.py.\n"
+            "version = '{}'\n".format(__version__)
+        )
+
+
+def get_cmdclass(pkg_source_path):
+    from setuptools.command.build_py import build_py as build_py_orig
+    from setuptools.command.sdist import sdist as sdist_orig
+
+    class _build_py(build_py_orig):
+        def run(self):
+            super().run()
+
+            src_marker = "".join(["src", os.path.sep])
+
+            if pkg_source_path.startswith(src_marker):
+                path = pkg_source_path[len(src_marker):]
+            else:
+                path = pkg_source_path
+            _write_version(
+                os.path.join(
+                    self.build_lib, path, STATIC_VERSION_FILE
+                )
+            )
+
+    class _sdist(sdist_orig):
+        def make_release_tree(self, base_dir, files):
+            super().make_release_tree(base_dir, files)
+            _write_version(
+                os.path.join(base_dir, pkg_source_path, STATIC_VERSION_FILE)
+            )
+
+    return dict(sdist=_sdist, build_py=_build_py)

labware/definitions/Akura_384_spheroid_microplate.json

@@ -0,0 +1,65 @@
+{
+    "$schema": "https://raw.githubusercontent.com/ramonaoptics/labware/main/labware/labware.v1.schema.json",
+    "name": "Akura 384 Spheroid Microplate",
+    "number_of_wells": 384,
+    "manufacturer": "InSphero AG",
+    "author": "InSphero AG",
+    "last_updated": "2026-09-28T11:25:03Z",
+    "part_number": "CS-PC24",
+    "web_reference": "https://insphero.com/3d-cell-culture-tools/akura-384-spheroid-microplate/",
+    "drawing_reference": "https://insphero.com/wp-content/uploads/2025/10/Technical-Specifications-Akura-384-Spheroid-Microplate_Oct-2025.pdf",
+    "applications": [
+        "3D culture",
+        "spheroids",
+        "organoids",
+        "tumor",
+        "imaging",
+        "fluorescence",
+        "high-content screening",
+        "high-throughput screening"
+    ],
+
+    "outer_plate_dimensions": {
+        "length": 0.12776,
+        "width": 0.08548,
+        "height": 0.01435,
+        "skirt_height": 0.00252
+    },
+
+    "well_dimensions": {
+        "pitch": 0.0045,
+        "rows": 16,
+        "columns": 24,
+        "shape": "circle",
+        "top_shape": "square",
+        "diameter": 0.001,
+        "diameter_top": 0.00365,
+        "depth": 0.01171,
+        "working_volume_min": 4e-05,
+        "working_volume_max": 5e-05,
+
+        "bottom_shape": "flat",
+        "bottom_color": "clear",
+        "bottom_material": "polystyrene",
+        "bottom_thickness": 0.000125,
+        "bottom_refractive_index": 1.58,
+        "bottom_elevation": 0.00252,
+        "floor_height": 0.002645,
+        "wall_material": "polystyrene",
+        "wall_color": "black",
+        "surface_treatments": [
+            "ultra-low attachment"
+        ]
+    },
+
+    "alignment_reference": {
+        "origin_reference": "A1 well center",
+        "offset_from_left_edge": 0.01205,
+        "offset_from_top_edge": 0.00989,
+        "top_offset_from_left_edge": 0.01205,
+        "top_offset_from_top_edge": 0.00899,
+        "z_reference": "top surface of plate"
+    },
+
+    "notes": "InSphero Akura 384 Spheroid Microplate, article CS-PC24, black-walled polystyrene bonded to a transparent 0.125 mm polystyrene membrane (refractive index 1.58), ULA coated, with lid. Every dimension is from InSphero's Technical Specifications SPEC007, October 2025 (drawing_reference), which supersedes the 2023 editions (plate height 14.80, well height 11.93, skirt 2.77, A1 to side 12.13 there). WELL SHAPE: a 3.65 x 3.65 mm square opening at the top (Figure 1B; diameter_top is its side, top_shape square) narrowing to a round 1.00 mm spheroid observation cavity with a flat optically clear base (Detail D, Figure 3; diameter, shape circle, bottom_shape flat). Height of well 11.71, plate height 14.35 (skirt 2.52 plus membrane 0.125 plus well 11.71). WALLS AND BOTTOM: black polystyrene walls (walls; no wall thickness is published) bonded to a transparent, continuous 0.125 mm polystyrene membrane of refractive index 1.58 (bottom), whose underside sits 2.52 mm above the plane the plate rests on (bottom_elevation). SKIRT: SPEC007 prints 'Skirt height: 2.52 mm' and defines it as the distance between the plate bottom and the rim (Figure 2C), the membrane's underside (Figure 5); Section A-A (Figure 2B) shows the outer wall ending in a foot at the base whose top, scaled off that low-resolution figure against the printed 14.35 mm, sits about 2.3 mm (+/-0.3) above the base, level with the membrane within what the figure resolves, so skirt_height records the printed 2.52 mm. No flange width is printed, so skirt_thickness is not recorded. CAVITY OFFSET: the cavity is not centred under the square; its centre sits 0.90 mm further from the top edge than the square's (Figure 4: 9.89 mm to the cavity centre, 8.99 mm to the square's centre). offset_from_top_edge is 9.89, the cavity centre, so the grid points at the spheroid; top_offset_from_top_edge is 8.99, the centre of the square opening 0.90 mm above it, on the standard 384-well row (top_offset_from_left_edge 12.05, the same column as the cavity). offset_from_left_edge 12.05, pitch 4.50 mm. Working volume 40-50 uL. Dimensions are in meters."
+}

labware/definitions/Akura_96_spheroid_microplate.json

@@ -0,0 +1,62 @@
+{
+    "$schema": "https://raw.githubusercontent.com/ramonaoptics/labware/main/labware/labware.v1.schema.json",
+    "name": "Akura 96 Spheroid Microplate",
+    "number_of_wells": 96,
+    "manufacturer": "InSphero AG",
+    "author": "Ramona Optics",
+    "last_updated": "2026-09-27T00:18:31Z",
+    "part_number": "CS-PB13/15",
+    "web_reference": "https://insphero.com/3d-cell-culture-tools/akura-96-spheroid-microplate/",
+    "drawing_reference": "https://insphero.com/wp-content/uploads/2023/09/Akura%E2%84%A2-96-Spheroid-Microplate-Technical-Specifications.pdf",
+    "applications": [
+        "3D culture",
+        "spheroids",
+        "organoids",
+        "tumor",
+        "liver",
+        "imaging"
+    ],
+
+    "outer_plate_dimensions": {
+        "length": 0.12776,
+        "width": 0.08548,
+        "height": 0.01435,
+        "height_with_lid": 0.01535,
+        "skirt_height": 0.0025
+    },
+
+    "well_dimensions": {
+        "pitch": 0.009,
+        "rows": 8,
+        "columns": 12,
+        "shape": "circle",
+        "top_shape": "circle",
+        "diameter": 0.001,
+        "diameter_top": 0.0067,
+        "depth": 0.01295,
+        "working_volume_min": 7e-05,
+        "working_volume_max": 8e-05,
+        "bottom_shape": "flat",
+        "bottom_color": "clear",
+        "bottom_material": "cyclo_olefin",
+        "bottom_thickness": 0.0008,
+        "bottom_elevation": 0.0004,
+        "floor_height": 0.0012,
+        "wall_material": "cyclo_olefin",
+        "wall_color": "clear",
+        "surface_treatments": [
+            "ultra-low attachment"
+        ]
+    },
+
+    "alignment_reference": {
+        "origin_reference": "A1 well center",
+        "offset_from_left_edge": 0.01438,
+        "offset_from_top_edge": 0.01124,
+        "top_offset_from_left_edge": 0.01438,
+        "top_offset_from_top_edge": 0.01124,
+        "z_reference": "top surface of plate"
+    },
+
+    "notes": "InSphero Akura 96 Spheroid Microplate, article CS-PB13 (5 plates) / CS-PB15 (20 plates): COP (cyclo-olefin polymer) plate with a polystyrene lid, ULA coated, sterile. Every dimension is from InSphero's Technical Specifications SPEC001, July 2023 (drawing_reference); the June 2023 edition of SPEC001 is the same plate but its table prints the well height as 12.75 mm, against 12.95 mm on its own drawing (Figure 4) and in the July table, so 12.95 is used. WELL SHAPE: a round 6.70 mm opening at the top ('Diameter well opening'; diameter_top, top_shape circle) narrowing in steps to a round 1.00 mm cavity with a flat, optically clear base ('Diameter well bottom', Figure 1B: 'the well diameter is exactly 1 mm'; diameter, shape circle, bottom_shape flat), for spheroids up to 750 um. The drawing shows the cavity centred under the opening, so the opening's centre (top_offset_from_left_edge, top_offset_from_top_edge) is the same as A1's, recorded explicitly. Height of well 12.95 mm (depth), plate height 14.35 mm (15.35 mm with the lid), skirt 0.4 mm, well bottom 0.8 mm thick; 0.4 + 0.8 + 12.95 = 14.15, 0.2 mm short of the plate height, and each value is recorded as printed. A1 centre 14.38 mm from the left edge and 11.24 mm from the top edge, pitch 9.00 mm (Figure 2). WALLS AND BOTTOM: the plate, walls and bottom alike, is clear COP (walls, bottom; the lid is polystyrene); bottom 0.8 mm thick, its underside 0.4 mm above the plane the plate rests on (the skirt height, bottom_elevation). No refractive index or wall thickness is published. SureXchange tip position: 1.71 mm horizontal offset, 9.86 mm below the plate top. Working volume 70-80 uL. Skirt height 2.50 mm from the side view in InSphero's specification (Figure 2); InSphero's own 'skirt height' of 0.4 mm is the well bottom's height above the resting plane, not the flange. Dimensions are in meters."
+}

labware/definitions/Axion_M768-SPH-48B_48_well_plate.json

@@ -0,0 +1,35 @@
+{
+    "$schema": "https://raw.githubusercontent.com/ramonaoptics/labware/main/labware/labware.v1.schema.json",
+    "name": "Axion SpheroGuide MEA M768-SPH-48B 48 well",
+    "number_of_wells": 48,
+    "manufacturer": "Axion BioSystems",
+    "author": "Ramona Optics",
+    "last_updated": "2026-08-31T00:00:00Z",
+    "part_number": "M768-SPH-48B",
+    "web_reference": "https://www.axionbiosystems.com/sites/default/files/resources/M768-SPH-48B%20DATASHEET%20v2.pdf",
+
+    "outer_plate_dimensions": {
+        "length": 0.12776,
+        "width": 0.08548,
+        "height": 0.01435
+    },
+
+    "well_dimensions": {
+        "pitch": 0.01308,
+        "rows": 6,
+        "columns": 8,
+        "shape": "circle",
+        "diameter": 0.007,
+        "depth": 0.0132,
+        "bottom_shape": "flat"
+    },
+
+    "alignment_reference": {
+        "origin_reference": "A1 well center",
+        "offset_from_left_edge": 0.0181,
+        "offset_from_top_edge": 0.01004,
+        "z_reference": "top surface of plate"
+    },
+
+    "notes": "Axion BioSystems SpheroGuide MEA 48, black-walled microelectrode array plate with a transparent well bottom, for spheroid and organoid MEA assays on Maestro Pro / Maestro Edge. Single catalogue number M768-SPH-48B; Axion lists no other well count or colour variant of the SpheroGuide line as of 2026-08. Units in meters. All dimensions from the Axion datasheet 'SPHEROGUIDE MEA 48 DATASHEET', document M768-SPH-48B DATASHEET v2: plate length (A) 127.76 mm, plate width (B) 85.48 mm, A1 offset row (C) 10.04 mm, A1 offset column (D) 18.10 mm, well-to-well distance (E) 13.08 mm, well top diameter (F) 7.0 mm, well bottom diameter (G) 2.5 mm, well height (H) 13.2 mm, well bottom elevation (I) 1.15 mm, base thickness (J) 150 um, well volume 435 uL, working volume 300 uL. Grid is 6 rows x 8 columns, read from the datasheet plan view. Axion's 'A1 Offset (Row) (C)' is measured from the top edge and 'A1 Offset (Column) (D)' from the left edge, confirmed against the dimensioned plan view; both are exactly the centred values, (85.48 - 5 x 13.08) / 2 = 10.04 and (127.76 - 7 x 13.08) / 2 = 18.10. Plate height is NOT published by Axion; the 14.35 mm here is derived as well bottom elevation + well height (1.15 + 13.2), which coincides with the usual ANSI/SLAS 1-2004 plate height - it is unverified against a physical plate. Well cross-section is a cylindrical upper bore of 7.0 mm tapering through the SpheroGuide placement funnel to a flat 2.5 mm transparent recording floor; 'diameter' is the top diameter and 'bottom_shape' flat describes that floor, so the funnel wall is not represented by the schema. The frustum volume of a pure 7.0 -> 2.5 mm cone over 13.2 mm is only about 251 uL against the stated 435 uL, which is consistent with the funnel occupying just the lower part of the well rather than the whole depth. Base thickness 150 um is the working-distance number. Each well carries 16 PEDOT electrodes (50 um diameter, 350 um spacing) on SU-8 insulation over an 1.1 x 1.1 mm recording area centred in the well floor; these sit in the imaging field. Axion publishes no plate material, no lid dimension and no tolerances. The Axion CytoView MEA 48 (M768-tMEA-48B / -48W) shares this footprint, pitch and both A1 offsets but is a different mould - 10.35 mm top diameter, 5.30 mm bottom, 12.15 mm well height - so do not use this definition for a CytoView plate."
+}

labware/definitions/CellVis_24_well_plate.json

@@ -0,0 +1,36 @@
+{
+    "$schema": "https://raw.githubusercontent.com/ramonaoptics/labware/main/labware/labware.v1.schema.json",
+    "name": "CellVis 24 well",
+    "number_of_wells": 24,
+    "manufacturer": "CellVis",
+    "author": "CellVis",
+    "last_updated": "2025-08-07T00:00:00Z",
+    "part_number": "P24-1.5H-N",
+    "web_reference": "https://www.cellvis.com/_24-well-glass-bottom-plate-with-number-0-cover-glass-(0.085-0.115-mm)_/product_detail.php?product_id=56",
+
+    "outer_plate_dimensions": {
+        "length": 0.1275,
+        "width": 0.08525,
+        "height": 0.0225
+    },
+
+    "well_dimensions": {
+        "pitch": 0.0193,
+        "rows": 4,
+        "columns": 6,
+        "shape": "circle",
+        "diameter": 0.01554,
+        "depth": 0.020,
+
+        "bottom_shape": "flat"
+    },
+
+    "alignment_reference": {
+        "origin_reference": "A1 well center",
+        "offset_from_left_edge": 0.01705,
+        "offset_from_top_edge": 0.01367,
+        "z_reference": "top surface of plate"
+    },
+
+    "notes": "Dimensions are in meters per ANSI/SLAS 1-2004 standard. Use 'well_pitch' and origin reference to compute all well centers."
+}

labware/definitions/Corning_3335_6_well_plate.json

@@ -0,0 +1,35 @@
+{
+    "$schema": "https://raw.githubusercontent.com/ramonaoptics/labware/main/labware/labware.v1.schema.json",
+    "name": "Corning Costar 3335 6 well",
+    "number_of_wells": 6,
+    "manufacturer": "Corning Life Sciences (Corning Incorporated)",
+    "author": "Ramona Optics",
+    "last_updated": "2026-08-28T00:00:00Z",
+    "part_number": "3335",
+    "web_reference": "https://www.corning.com/catalog/cls/documents/drawings/DWG00673.PDF",
+
+    "outer_plate_dimensions": {
+        "length": 0.12776,
+        "width": 0.08547,
+        "height": 0.02027
+    },
+
+    "well_dimensions": {
+        "pitch": 0.03912,
+        "rows": 2,
+        "columns": 3,
+        "shape": "circle",
+        "diameter": 0.03543,
+        "depth": 0.01740,
+        "bottom_shape": "flat"
+    },
+
+    "alignment_reference": {
+        "origin_reference": "A1 well center",
+        "offset_from_left_edge": 0.02476,
+        "offset_from_top_edge": 0.02316,
+        "z_reference": "top surface of plate"
+    },
+
+    "notes": "Corning Costar 6 well cell culture multiple well plate, cat# 3335, CellBIND surface, clear virgin polystyrene (meets USP Class VI), flat-bottom round wells, sterile, with lid. SURFACE: 3335 is the CellBIND-treated item; the identical mould is also sold as 3506 (standard TC-treated), 3516 and 3471 - Corning's cell culture dimension sheet lists 3335, 3506, 3516 and 3471 on a single row with one set of dimensions, so this definition covers all four. Surface chemistry does not change any geometry in this file. CONTROLLING DOCUMENT: Corning customer drawing DWG00673 Rev D, 'COSTAR 6 WELL PLATE WITH COVER', drawn CBL 10/03/96, rev D dated 6/22/18, prod code 144. The drawing's own revision block ties it to catalogue 3506 ('REVISED PER CO# 05780 WAS 144-3506'), not to 3335; it is used for 3335 because the dimension sheet puts 3335 and 3506 on the same mould row and because the per-catalogue Product Description for 3335 (rev 9, 2 Feb 2026, certs-ecatalog.corning.com/life-sciences/product-descriptions/3335.pdf) reproduces the drawing exactly - plate 5.030 x 3.365 in (127.76 x 85.47 mm), well top diameter 1.395 in (35.43 mm), well bottom diameter 1.370 in (34.80 mm), well depth 0.685 in (17.40 mm). The drawing is vector with no text layer and was read as a 100 dpi render, with the section view re-cropped at 300 dpi. Every dimension in this file is a millimetre value in parentheses on that drawing: plate length 127.76 mm, plate width 85.47 mm, plate height without cover 20.27 mm (the .798 in dimension on the section view; the base-plus-cover stack view gives 22.63 mm WITH the cover on, matching the Product Description's 'Height with lid 0.891 in' - the lid is not modelled here, so the lid-off 20.27 mm is used). Well center-to-center 39.12 mm, marked 'Typ.' and dimensioned on both the horizontal and the vertical run. Well top inside diameter 35.43 mm, recorded in 'diameter' per the top-diameter convention; well bottom inside diameter 34.80 mm. Well depth 17.40 mm. Grid is 2 rows (A-B) x 3 columns (1-3) with A1 top-left, as drawn and as numbered 1-6 on the top view. A1 well center offsets are dimensioned directly on the drawing's top view: 24.76 mm from the left edge and 23.16 mm from the top edge - nothing derived, and they agree with Corning's convention that 'A1 Column Offset' is measured from the left and 'A1 Row Offset' from the top. Bottom thickness 1.27 mm and well bottom elevation above the plate underside 2.54 mm (the working-distance numbers; neither is a field in this schema). Well volume 16.8 mL, working volume 5 mL per the Product Description, growth/bottom area 9.5 cm^2, flange/skirt height 13.74 mm. VENDOR ARITHMETIC: the drawing's own vertical dimensions do not close - well depth 17.40 + bottom thickness 1.27 + well bottom elevation 2.54 = 21.21 mm against the stated plate height of 20.27 mm. The identical 0.94 mm gap appears on the 12 well sheet DWG00674 (17.53 + 1.27 + 2.16 = 20.96 vs 20.02), so it is a datum convention on Corning's sheets rather than a misread; each value is recorded here as printed. Drawing tolerances are 'nominal for reference only'; the Product Description states +/- 0.050 in on its dimensions. CROSS-CHECK: Corning's family sheet 'Microplate Dimensions for Corning Cell Culture Microplates' dated 1/16/2019 (footer 'Corning Restricted'; no longer served from corning.com and read from the Internet Archive snapshot web.archive.org/web/20240119081431if_/https://www.corning.com/catalog/cls/documents/drawings/MD_Microplate_Dimension_Sheets_Multiple_Well.pdf) agrees with the drawing on every value in this file, including both A1 offsets. Note that www.corning.com returns 403 to a bare curl and to a browser user-agent alone; a full browser header set including Referer and Sec-Fetch-* is needed to download DWG00673. Units in meters. Use 'pitch' and origin reference to compute all well centers."
+}

labware/definitions/Corning_351146_6_well_plate.json

@@ -0,0 +1,35 @@
+{
+    "$schema": "https://raw.githubusercontent.com/ramonaoptics/labware/main/labware/labware.v1.schema.json",
+    "name": "Corning Falcon 351146 6 well",
+    "number_of_wells": 6,
+    "manufacturer": "Corning Life Sciences (Corning Incorporated)",
+    "author": "Ramona Optics",
+    "last_updated": "2026-08-25T00:00:00Z",
+    "part_number": "351146",
+    "web_reference": "https://pdf.dutscher.com/doc/3/35/351/351146/351146_FTen.pdf",
+
+    "outer_plate_dimensions": {
+        "length": 0.12763,
+        "width": 0.08547,
+        "height": 0.02019
+    },
+
+    "well_dimensions": {
+        "pitch": 0.03924,
+        "rows": 2,
+        "columns": 3,
+        "shape": "circle",
+        "diameter": 0.03571,
+        "depth": 0.01765,
+        "bottom_shape": "flat"
+    },
+
+    "alignment_reference": {
+        "origin_reference": "A1 well center",
+        "offset_from_left_edge": 0.024575,
+        "offset_from_top_edge": 0.023115,
+        "z_reference": "top surface of plate"
+    },
+
+    "notes": "Corning Falcon 6 well multiwell cell culture plate, clear crystal-grade polystyrene, flat-bottom round wells, low-evaporation lid, sterile (gamma irradiated). Cat# 351146 is the non-treated item, registered here; the same mould (one Corning technical data sheet covers all of them) is sold as 353046 (TC-treated, 1/tray), 353224 (TC-treated, 6/bag), 353934 (TC-treated, 10/tray), 353846 (Primaria) and 353502 (notched TC plate for inserts) - any of these can use this definition. Dimensions are from the Corning Life Sciences 'Customer Technical Data Sheet - Multiwell TC Plates - 6 Well', document LSR00001; rev 5 (2018) was read from the 353046 copy hosted by Dutscher (pdf.dutscher.com/doc/3/35/353/353046/353046_FTen.pdf) and rev 4 (2013) from the 351146 copy at web_reference; the two revisions carry identical numbers. Corning's own site links this sheet from the product page's Documents tab but refuses non-browser downloads, hence the distributor-hosted copy is cited. Units in meters. Plate (without lid) length D = 127.63 mm, width E = 85.47 mm, height F = 20.19 mm; height with lid on is 21.43 mm; the lid (127.20 x 85.14 x 10.03 mm) is not modeled. Well top internal diameter 35.71 mm, recorded in 'diameter' per the top-diameter convention; bottom internal diameter 35.00 mm; depth 17.65 mm; growth area 9.619 cm^2; center-to-center 39.24 mm (assumed equal in both directions, the sheet gives one value); bottom thickness 1.52 mm. Media working volume 2.5-3.0 mL. DERIVED: Corning does not publish the A1 well center position on this sheet. The offsets here place the 2x3 grid centered on the plate footprint: offset_from_left_edge = (127.63 - 2 x 39.24) / 2 = 24.575 mm, offset_from_top_edge = (85.47 - 39.24) / 2 = 23.115 mm. This is consistent with Corning's Costar 6 well drawing DWG00673 (24.76 / 23.16 mm at 39.12 mm pitch on a 127.76 x 85.47 mm footprint, i.e. also centered to within 0.1 mm) but has not been checked against a physical Falcon plate. Use 'pitch' and origin reference to compute all well centers."
+}

labware/definitions/Corning_3512_12_well_plate.json

@@ -0,0 +1,35 @@
+{
+    "$schema": "https://raw.githubusercontent.com/ramonaoptics/labware/main/labware/labware.v1.schema.json",
+    "name": "Corning Costar 3512 12 well",
+    "number_of_wells": 12,
+    "manufacturer": "Corning Life Sciences (Corning Incorporated)",
+    "author": "Ramona Optics",
+    "last_updated": "2026-08-28T00:00:00Z",
+    "part_number": "3512",
+    "web_reference": "https://www.corning.com/catalog/cls/documents/drawings/DWG00674.PDF",
+
+    "outer_plate_dimensions": {
+        "length": 0.12789,
+        "width": 0.08560,
+        "height": 0.02002
+    },
+
+    "well_dimensions": {
+        "pitch": 0.02601,
+        "rows": 3,
+        "columns": 4,
+        "shape": "circle",
+        "diameter": 0.02273,
+        "depth": 0.01753,
+        "bottom_shape": "flat"
+    },
+
+    "alignment_reference": {
+        "origin_reference": "A1 well center",
+        "offset_from_left_edge": 0.02494,
+        "offset_from_top_edge": 0.01679,
+        "z_reference": "top surface of plate"
+    },
+
+    "notes": "Corning Costar 12 well cell culture multiple well plate, clear virgin polystyrene (meets USP Class VI), flat-bottom round wells, TC-treated, sterile, with lid. Cat# 3512 is the bulk-pack item (5/pack, 100/case), registered here; the identical mould is also sold as 3513 (individually wrapped) and 3336 - Corning's dimension sheet lists 3336/3512/3513 on a single row and the Product Descriptions for 3512 (rev 11) and 3513 (rev 13) are dimensionally identical line for line, so any of these can use this definition. The non-treated 12 well equivalent is 3737 and was not checked against this drawing. CONTROLLING DOCUMENT: Corning customer drawing DWG00674 Rev C, 'COSTAR 12 WELL PLATE WITH COVER', drawn CBL 10/03/96, rev C dated 6/22/18, prod code 144; its Rev B note ('REVISED PER CO# 05780 WAS 144-3512') is what ties this drawing to catalogue number 3512. The drawing is vector with no text layer and was read as a 100 dpi render. Every dimension in this file is a millimetre value in parentheses on that drawing: plate length 127.89 mm, plate width 85.60 mm, plate height without cover 20.02 mm (the drawing's .788 in / 20.02 dimension on the section view; the separate base+cover stack view gives 22.61 mm WITH the cover on, and the Product Description's 'Height with lid 0.890 in' is that same lid-on number - the lid is not modeled here, so the lid-off 20.02 mm is used). Well center-to-center 26.01 mm, marked 'Typ.' and identical in both axes. Well top inside diameter 22.73 mm, recorded in 'diameter' per the top-diameter convention; well bottom inside diameter 22.11 mm. Well depth 17.53 mm. Grid is 3 rows (A-C) x 4 columns (1-4) with A1 top-left, as drawn. A1 well center offsets are dimensioned directly on the drawing's top view: 24.94 mm from the left edge and 16.79 mm from the top edge - no derivation was needed, and they agree with Corning's convention that 'A1 Column Offset' is measured from the left and 'A1 Row Offset' from the top. Bottom thickness 1.27 mm and well bottom elevation above the plate underside 2.16 mm (working-distance numbers; not fields in this schema). Well volume 6.90 mL, working volume 3 mL per the Product Description, growth/bottom area 3.83 cm^2, flange/skirt height 13.72 mm. Drawing tolerances are 'nominal for reference only'; the Product Description states +/- 0.050 in on its dimensions. CROSS-CHECK: Corning's family sheet 'Microplate Dimensions for Corning Cell Culture Microplates' dated 1/16/2019 (footer 'Corning Restricted'; no longer served from corning.com and read from the Internet Archive snapshot web.archive.org/web/20240119081431if_/https://www.corning.com/catalog/cls/documents/drawings/MD_Microplate_Dimension_Sheets_Multiple_Well.pdf) agrees with the drawing on every value except well depth, where it rounds 17.53 to 17.5; the per-catalogue drawing wins. Product Description read from certs-ecatalog.corning.com/life-sciences/product-descriptions/3512.pdf. Note that www.corning.com returns 403 to a bare curl and to a browser user-agent alone; a full browser header set including Referer and Sec-Fetch-* is needed to download DWG00674. Units in meters. Use 'pitch' and origin reference to compute all well centers."
+}

labware/definitions/Corning_3527_24_well_plate.json

@@ -0,0 +1,35 @@
+{
+    "$schema": "https://raw.githubusercontent.com/ramonaoptics/labware/main/labware/labware.v1.schema.json",
+    "name": "Corning Costar 3527 24 well",
+    "number_of_wells": 24,
+    "manufacturer": "Corning Life Sciences",
+    "author": "Ramona Optics",
+    "last_updated": "2026-08-27T00:00:00Z",
+    "part_number": "3527",
+    "web_reference": "https://www.corning.com/catalog/cls/documents/drawings/DWG01261.PDF",
+
+    "outer_plate_dimensions": {
+        "length": 0.12776,
+        "width": 0.08547,
+        "height": 0.02027
+    },
+
+    "well_dimensions": {
+        "pitch": 0.019304,
+        "rows": 4,
+        "columns": 6,
+        "shape": "circle",
+        "diameter": 0.01626,
+        "depth": 0.01740,
+        "bottom_shape": "flat"
+    },
+
+    "alignment_reference": {
+        "origin_reference": "A1 well center",
+        "offset_from_left_edge": 0.01748,
+        "offset_from_top_edge": 0.01377,
+        "z_reference": "top surface of plate"
+    },
+
+    "notes": "Corning Costar 24-well clear TC-treated multiple well plate, bulk pack, sterile, flat bottom, with lid. Every dimension here is read from the Corning Life Sciences customer drawing DWG01261 Rev B (revised 2018-06-22 per CC-08532; Rev A released 1999-09-13), titled '24 WELL PLATE AND COVER', prod code 144. That drawing carries no catalogue number: it is the mould drawing for the whole Costar 24-well cell culture family. Corning's dimension sheet 'Microplate Dimensions for Corning Cell Culture Microplates' (2019-01-16, https://csmedia2.corning.com/lifesciences/media/equipment_compatibility/MD_Microplate_Dimension_Sheets_Multiple_Well.pdf) lists cat. 3337, 3524, 3526, 3527 and 3473 on one row with one set of dimensions, which is what ties 3527 to this drawing. Sibling part numbers on the same mould: 3524 (individually wrapped, TC-treated), 3526 (non-treated), 3337, 3473 (ultra-low attachment). 3527 differs from 3524 only in packaging (bulk pack), so the geometry is identical to the existing Corning_costar_24_well_plate.json entry; this file exists so the plate is findable by its own catalogue number. Footprint 127.76 x 85.47 mm from the drawing (Corning's assay-plate selection guide CLS-C-DL-MP-014REV9 quotes 85.48 mm width for its ANSI/SBS statement; the 0.01 mm difference is below anything the instrument resolves). Height 20.27 mm is the base WITHOUT the lid, per the drawing's .798 dimension; the drawing's .891 (22.63 mm) is base plus cover and is NOT used here, because z_reference is the top surface of the plate. Pitch 19.304 mm (.760 TYP) in both axes. A1 centre 17.48 mm from the left edge and 13.77 mm from the top edge, both off the drawing; the dimension sheet independently gives 17.46 and 13.78. Note the grid is centred in the short axis (13.77 vs a centred 13.78) but sits 1.86 mm to the right of centre in the long axis (17.48 vs a centred 15.62) - this asymmetry is what both Corning documents say and it is unlike Corning's 6-, 12- and 48-well plates, which are centred in both axes; it is also visible in the drawing's plan view, so it was not read from the wrong datum. Well diameter 16.26 mm is the TOP diameter (drawing, .640 DIA); the bottom diameter is 15.62 mm (dimension sheet), which is the figure Corning's catalogue page quotes as '15.6 mm'. Well depth 17.40 mm (.685). Well bottom elevation above the plate's underside 2.54 mm (.100). BOTTOM THICKNESS 1.27 mm (.050) of clear polystyrene - this is the working-distance number. Total well volume 3.47 mL (dimension sheet) / 3.4 mL (catalogue), working volume 0.38-0.57 mL, growth area 1.93 cm2, flange height 13.74 mm. Clear polystyrene, TC-treated, gamma sterilised, non-pyrogenic, non-reversible lid with condensation rings. Dimensions in metres."
+}

labware/definitions/Corning_353502_6_well_plate.json

@@ -0,0 +1,35 @@
+{
+    "$schema": "https://raw.githubusercontent.com/ramonaoptics/labware/main/labware/labware.v1.schema.json",
+    "name": "Corning Falcon 353502 6 well",
+    "number_of_wells": 6,
+    "manufacturer": "Corning Life Sciences (Corning Incorporated)",
+    "author": "Ramona Optics",
+    "last_updated": "2026-08-28T00:00:00Z",
+    "part_number": "353502",
+    "web_reference": "https://www.corning.com/catalog/cls/documents/drawings/LSR00001.pdf",
+
+    "outer_plate_dimensions": {
+        "length": 0.12763,
+        "width": 0.08547,
+        "height": 0.02019
+    },
+
+    "well_dimensions": {
+        "pitch": 0.03924,
+        "rows": 2,
+        "columns": 3,
+        "shape": "circle",
+        "diameter": 0.03571,
+        "depth": 0.01765,
+        "bottom_shape": "flat"
+    },
+
+    "alignment_reference": {
+        "origin_reference": "A1 well center",
+        "offset_from_left_edge": 0.024575,
+        "offset_from_top_edge": 0.023115,
+        "z_reference": "top surface of plate"
+    },
+
+    "notes": "Corning Falcon 6 well multiwell cell culture plate, cat# 353502, the NOTCHED tissue-culture-treated plate sold for use with cell culture inserts (Falcon permeable supports). Clear crystal-grade polystyrene, flat-bottom round wells, TC-treated by vacuum gas plasma, low-evaporation lid, sterile (gamma irradiated), 1/tray, 50/case. CONTROLLING DOCUMENT: Corning Life Sciences 'Customer Technical Data Sheet - Multiwell TC Plates - 6 Well', document LSR00001 Rev 5 (c) 2013-2018, read from Corning's own copy at web_reference. That one sheet covers the whole 6 well Falcon mould and names each variant in its catalogue table: 353046 (TC surface), 351146 (non-treated) and 353502 (this part, 'Notched TC Plate, used w/inserts'); Rev 4 of the same sheet also lists 353224 (6/bag), 353934 (10/RS tray) and 353846 (Primaria). Corning publishes ONE set of dimensions for all of them, so the geometry here is the family geometry and is identical to Corning_351146_6_well_plate.json - the two files differ only in part number, name and provenance. The notch itself is a rim/flange feature for seating inserts and is NOT dimensioned on the sheet; it does not change the footprint, the pitch or the well bore as published, and it is not modelled here. Rev 4 was cross-read from the distributor-hosted copies at pdf.dutscher.com/doc/3/35/353/353502/353502_FTen.pdf and .../353046/353046_FTen.pdf; the dimension block is character-for-character identical across Rev 4 and Rev 5. Units in meters. Plate without lid: length D = 127.63 mm, width E = 85.47 mm, height F = 20.19 mm; height with the lid on is 21.43 mm; the lid (127.20 x 85.14 x 10.03 mm) is not modelled. Well top internal diameter 35.71 mm, recorded in 'diameter' per the top-diameter convention; well bottom internal diameter 35.00 mm; well depth 17.65 mm; bottom (growth) area 9.619 cm^2; center-to-center 39.24 mm, the sheet gives a single value which is used for both axes; bottom thickness 1.52 mm - that is the working-distance number and has no field in this schema. Media working volume 2.5-3.0 mL per well. DERIVED: Corning does not publish the A1 well center position on LSR00001, and there is no per-catalogue drawing or Product Description for 353502 (certs-ecatalog.corning.com returns 404 for this catalogue number). The offsets here place the 2x3 grid centered on the plate footprint: offset_from_left_edge = (127.63 - 2 x 39.24) / 2 = 24.575 mm, offset_from_top_edge = (85.47 - 39.24) / 2 = 23.115 mm. This matches the value used for the same mould in Corning_351146_6_well_plate.json and is consistent with Corning's Costar 6 well drawing DWG00673, which dimensions A1 directly at 24.76 / 23.16 mm on a 39.12 mm pitch and a 127.76 x 85.47 mm footprint, i.e. also centered to within 0.1 mm. It has NOT been checked against a physical Falcon plate. Note that www.corning.com refuses a bare curl and a plain browser user-agent; LSR00001.pdf downloads with the full browser header set (Accept, Referer, Sec-Fetch-*). Use 'pitch' and origin reference to compute all well centers."
+}