[{"data":1,"prerenderedAt":2544},["ShallowReactive",2],{"navigation":3,"\u002Fhow-to\u002Fautomate\u002Fbasic-error-handling":909,"\u002Fhow-to\u002Fautomate\u002Fbasic-error-handling-surround":2539},[4,59,188,271,445,591,760,791],{"title":5,"type":6,"device":6,"path":7,"stem":8,"children":9,"page":41},"Get Started",null,"\u002Fget-started\u002F","01.get-started",[10,15,42,47,51,55],{"title":11,"path":12,"stem":13,"type":14,"device":6},"Welcome to UniteLabs","\u002Fget-started\u002Fwelcome\u002F","01.get-started\u002F00.welcome","landing",{"title":16,"type":6,"device":6,"path":17,"stem":18,"children":19,"page":41},"Setup","\u002Fget-started\u002Fsetup\u002F","01.get-started\u002F01.setup",[20,25,29,33,37],{"title":21,"path":22,"stem":23,"type":24,"device":6},"Get access","\u002Fget-started\u002Fsetup\u002Fget-access\u002F","01.get-started\u002F01.setup\u002F00.get-access","howto",{"title":26,"path":27,"stem":28,"type":24,"device":6},"GroundControl","\u002Fget-started\u002Fsetup\u002Fgroundcontrol\u002F","01.get-started\u002F01.setup\u002F10.groundcontrol",{"title":30,"path":31,"stem":32,"type":24,"device":6},"Connect to Platform","\u002Fget-started\u002Fsetup\u002Fconnect-to-platform\u002F","01.get-started\u002F01.setup\u002F20.connect-to-platform",{"title":34,"path":35,"stem":36,"type":24,"device":6},"Set up your development machine","\u002Fget-started\u002Fsetup\u002Fdeveloper-machine\u002F","01.get-started\u002F01.setup\u002F30.developer-machine",{"title":38,"path":39,"stem":40,"type":24,"device":6},"SDK installation","\u002Fget-started\u002Fsetup\u002Fsdk-installation\u002F","01.get-started\u002F01.setup\u002F40.sdk-installation",false,{"title":43,"path":44,"stem":45,"type":46,"device":6},"Control a device","\u002Fget-started\u002Fcontrol-a-device\u002F","01.get-started\u002F02.control-a-device","tutorial",{"title":48,"path":49,"stem":50,"type":46,"device":6},"Liquid handling as code","\u002Fget-started\u002Fliquid-handling-as-code\u002F","01.get-started\u002F03.liquid-handling-as-code",{"title":52,"path":53,"stem":54,"type":46,"device":6},"Automate your workflows","\u002Fget-started\u002Fautomate-your-workflows\u002F","01.get-started\u002F04.automate-your-workflows",{"title":56,"path":57,"stem":58,"type":6,"device":6},"Self-Paced Setup Guide","\u002Fget-started\u002Fself-onboarding\u002F","01.get-started\u002F90.self-onboarding",{"title":60,"type":6,"device":6,"path":61,"stem":62,"children":63,"page":41},"How-to","\u002Fhow-to\u002F","02.how-to",[64,118,163,180],{"title":65,"type":6,"device":6,"path":66,"stem":67,"children":68,"page":41},"Connectors and devices","\u002Fhow-to\u002Fintegrate\u002F","02.how-to\u002F02.integrate",[69,102],{"title":70,"type":6,"device":6,"path":71,"stem":72,"children":73,"page":41},"Connect a device","\u002Fhow-to\u002Fintegrate\u002Fconnect-a-device\u002F","02.how-to\u002F02.integrate\u002F20.connect-a-device",[74,78,82,86,90,94,98],{"title":75,"path":76,"stem":77,"type":24,"device":6},"Connector Configuration","\u002Fhow-to\u002Fintegrate\u002Fconnect-a-device\u002Fconnector-configuration\u002F","02.how-to\u002F02.integrate\u002F20.connect-a-device\u002F10.connector-configuration",{"title":79,"path":80,"stem":81,"type":24,"device":6},"With an executable","\u002Fhow-to\u002Fintegrate\u002Fconnect-a-device\u002Fwith-an-executable\u002F","02.how-to\u002F02.integrate\u002F20.connect-a-device\u002F20.with-an-executable",{"title":83,"path":84,"stem":85,"type":24,"device":6},"From source","\u002Fhow-to\u002Fintegrate\u002Fconnect-a-device\u002Ffrom-source\u002F","02.how-to\u002F02.integrate\u002F20.connect-a-device\u002F30.from-source",{"title":87,"path":88,"stem":89,"type":24,"device":6},"Build your own","\u002Fhow-to\u002Fintegrate\u002Fconnect-a-device\u002Fbuild-yourself\u002F","02.how-to\u002F02.integrate\u002F20.connect-a-device\u002F40.build-yourself",{"title":91,"path":92,"stem":93,"type":24,"device":6},"Headless install","\u002Fhow-to\u002Fintegrate\u002Fconnect-a-device\u002Fheadless-install\u002F","02.how-to\u002F02.integrate\u002F20.connect-a-device\u002F50.headless-install",{"title":95,"path":96,"stem":97,"type":24,"device":6},"Raspberry Pi","\u002Fhow-to\u002Fintegrate\u002Fconnect-a-device\u002Fraspberry-pi\u002F","02.how-to\u002F02.integrate\u002F20.connect-a-device\u002F55.raspberry-pi",{"title":99,"path":100,"stem":101,"type":24,"device":6},"Multi-device Networking","\u002Fhow-to\u002Fintegrate\u002Fconnect-a-device\u002Fmultiple-devices\u002F","02.how-to\u002F02.integrate\u002F20.connect-a-device\u002F60.multiple-devices",{"title":103,"type":6,"device":6,"path":104,"stem":105,"children":106,"page":41},"Use a device","\u002Fhow-to\u002Fintegrate\u002Fuse-a-device\u002F","02.how-to\u002F02.integrate\u002F30.use-a-device",[107,110,114],{"title":26,"path":108,"stem":109,"type":24,"device":6},"\u002Fhow-to\u002Fintegrate\u002Fuse-a-device\u002Fgroundcontrol\u002F","02.how-to\u002F02.integrate\u002F30.use-a-device\u002F10.groundcontrol",{"title":111,"path":112,"stem":113,"type":24,"device":6},"Platform","\u002Fhow-to\u002Fintegrate\u002Fuse-a-device\u002Fplatform\u002F","02.how-to\u002F02.integrate\u002F30.use-a-device\u002F20.platform",{"title":115,"path":116,"stem":117,"type":24,"device":6},"UniteLabs SDK & REST API","\u002Fhow-to\u002Fintegrate\u002Fuse-a-device\u002Fpython\u002F","02.how-to\u002F02.integrate\u002F30.use-a-device\u002F30.python",{"title":119,"type":6,"device":6,"path":120,"stem":121,"children":122,"page":41},"Workflows","\u002Fhow-to\u002Fautomate\u002F","02.how-to\u002F07.automate",[123,127,131,135,139,143,147,151,155,159],{"title":124,"path":125,"stem":126,"type":24,"device":6},"Deploy a workflow","\u002Fhow-to\u002Fautomate\u002Fdeploy-a-workflow\u002F","02.how-to\u002F07.automate\u002F30.deploy-a-workflow",{"title":128,"path":129,"stem":130,"type":24,"device":6},"Run a workflow","\u002Fhow-to\u002Fautomate\u002Frun-a-workflow\u002F","02.how-to\u002F07.automate\u002F35.run-a-workflow",{"title":132,"path":133,"stem":134,"type":24,"device":6},"CI\u002FCD for workflows","\u002Fhow-to\u002Fautomate\u002Fcicd-for-workflows\u002F","02.how-to\u002F07.automate\u002F40.cicd-for-workflows",{"title":136,"path":137,"stem":138,"type":24,"device":6},"HITL basics","\u002Fhow-to\u002Fautomate\u002Fbasic-hitl\u002F","02.how-to\u002F07.automate\u002F50.basic-hitl",{"title":140,"path":141,"stem":142,"type":24,"device":6},"Slack notifications and operator confirmation","\u002Fhow-to\u002Fautomate\u002Fslack-notifications\u002F","02.how-to\u002F07.automate\u002F52.slack-notifications",{"title":144,"path":145,"stem":146,"type":24,"device":6},"Typed operator inputs","\u002Fhow-to\u002Fautomate\u002Ftyped-operator-inputs\u002F","02.how-to\u002F07.automate\u002F55.typed-operator-inputs",{"title":148,"path":149,"stem":150,"type":24,"device":6},"Pause and resume a run","\u002Fhow-to\u002Fautomate\u002Fpause-and-resume\u002F","02.how-to\u002F07.automate\u002F57.pause-and-resume",{"title":152,"path":153,"stem":154,"type":24,"device":6},"Error recovery","\u002Fhow-to\u002Fautomate\u002Fbasic-error-handling\u002F","02.how-to\u002F07.automate\u002F60.basic-error-handling",{"title":156,"path":157,"stem":158,"type":24,"device":6},"Advanced error handling","\u002Fhow-to\u002Fautomate\u002Fadvanced-error-handling\u002F","02.how-to\u002F07.automate\u002F70.advanced-error-handling",{"title":160,"path":161,"stem":162,"type":24,"device":6},"Emit lineage events","\u002Fhow-to\u002Fautomate\u002Femitting-lineage-events\u002F","02.how-to\u002F07.automate\u002F90.emitting-lineage-events",{"title":164,"type":6,"device":6,"path":165,"stem":166,"children":167,"page":41},"Data","\u002Fhow-to\u002Fobserve\u002F","02.how-to\u002F08.observe",[168,172,176],{"title":169,"path":170,"stem":171,"type":24,"device":6},"File System Connector","\u002Fhow-to\u002Fobserve\u002Ffilesystem-connector\u002F","02.how-to\u002F08.observe\u002F10.filesystem-connector",{"title":173,"path":174,"stem":175,"type":24,"device":6},"Building an ETL","\u002Fhow-to\u002Fobserve\u002Fbuilding-an-etl\u002F","02.how-to\u002F08.observe\u002F20.building-an-etl",{"title":177,"path":178,"stem":179,"type":24,"device":6},"Read lineage events","\u002Fhow-to\u002Fobserve\u002Freading-lineage-events\u002F","02.how-to\u002F08.observe\u002F30.reading-lineage-events",{"title":111,"type":6,"device":6,"path":181,"stem":182,"children":183,"page":41},"\u002Fhow-to\u002Fplatform\u002F","02.how-to\u002F09.platform",[184],{"title":185,"path":186,"stem":187,"type":24,"device":6},"UniteLabs Desktop","\u002Fhow-to\u002Fplatform\u002Funitelabs-desktop\u002F","02.how-to\u002F09.platform\u002F10.unitelabs-desktop",{"title":189,"type":6,"device":6,"path":190,"stem":191,"children":192},"Technical Reference","\u002Ftechnical-reference\u002F","03.technical-reference",[193,196,201,213,226,235,244,253,262],{"title":194,"path":190,"stem":195,"type":14,"device":6},"Overview","03.technical-reference\u002Findex",{"title":197,"path":198,"stem":199,"type":200,"device":6},"REST API","\u002Ftechnical-reference\u002Frest-api\u002F","03.technical-reference\u002F01.rest-api","reference",{"title":119,"type":6,"device":6,"path":202,"stem":203,"children":204,"page":41},"\u002Ftechnical-reference\u002Fautomate\u002F","03.technical-reference\u002F07.automate",[205,209],{"title":206,"path":207,"stem":208,"type":200,"device":6},"Workflow template","\u002Ftechnical-reference\u002Fautomate\u002Fworkflow-template\u002F","03.technical-reference\u002F07.automate\u002F05.workflow-template",{"title":210,"path":211,"stem":212,"type":200,"device":6},"Workflows REST API","\u002Ftechnical-reference\u002Fautomate\u002Fworkflows-api\u002F","03.technical-reference\u002F07.automate\u002F80.workflows-api",{"title":26,"type":6,"device":6,"path":214,"stem":215,"children":216},"\u002Ftechnical-reference\u002Fgroundcontrol\u002F","03.technical-reference\u002F10.groundcontrol\u002Findex",[217,218,222],{"title":194,"path":214,"stem":215,"type":14,"device":6},{"title":219,"path":220,"stem":221,"type":200,"device":6},"Network requirements","\u002Ftechnical-reference\u002Fgroundcontrol\u002Fnetwork-requirements\u002F","03.technical-reference\u002F10.groundcontrol\u002F10.network-requirements",{"title":223,"path":224,"stem":225,"type":200,"device":6},"Changelog","\u002Ftechnical-reference\u002Fgroundcontrol\u002Fchangelog\u002F","03.technical-reference\u002F10.groundcontrol\u002F20.changelog",{"title":227,"type":6,"device":6,"path":228,"stem":229,"children":230},"UniteLabs SDK","\u002Ftechnical-reference\u002Fpython-sdk\u002F","03.technical-reference\u002F20.python-sdk\u002Findex",[231,232],{"title":194,"path":228,"stem":229,"type":14,"device":6},{"title":223,"path":233,"stem":234,"type":200,"device":6},"\u002Ftechnical-reference\u002Fpython-sdk\u002Fchangelog\u002F","03.technical-reference\u002F20.python-sdk\u002F20.changelog",{"title":236,"type":6,"device":6,"path":237,"stem":238,"children":239},"Liquid Handling SDK","\u002Ftechnical-reference\u002Fpython-liquid-handling-sdk\u002F","03.technical-reference\u002F30.python-liquid-handling-sdk\u002Findex",[240,241],{"title":194,"path":237,"stem":238,"type":14,"device":6},{"title":223,"path":242,"stem":243,"type":200,"device":6},"\u002Ftechnical-reference\u002Fpython-liquid-handling-sdk\u002Fchangelog\u002F","03.technical-reference\u002F30.python-liquid-handling-sdk\u002F20.changelog",{"title":245,"type":6,"device":6,"path":246,"stem":247,"children":248},"Labware","\u002Ftechnical-reference\u002Flabware\u002F","03.technical-reference\u002F40.labware\u002Findex",[249,250],{"title":194,"path":246,"stem":247,"type":14,"device":6},{"title":223,"path":251,"stem":252,"type":200,"device":6},"\u002Ftechnical-reference\u002Flabware\u002Fchangelog\u002F","03.technical-reference\u002F40.labware\u002F20.changelog",{"title":254,"type":6,"device":6,"path":255,"stem":256,"children":257},"Python Omnibus","\u002Ftechnical-reference\u002Fpython-omnibus\u002F","03.technical-reference\u002F50.python-omnibus\u002Findex",[258,259],{"title":194,"path":255,"stem":256,"type":14,"device":6},{"title":223,"path":260,"stem":261,"type":200,"device":6},"\u002Ftechnical-reference\u002Fpython-omnibus\u002Fchangelog\u002F","03.technical-reference\u002F50.python-omnibus\u002F20.changelog",{"title":263,"type":6,"device":6,"path":264,"stem":265,"children":266},"Python CDK","\u002Ftechnical-reference\u002Fpython-cdk\u002F","03.technical-reference\u002F60.python-cdk\u002Findex",[267,268],{"title":194,"path":264,"stem":265,"type":14,"device":6},{"title":223,"path":269,"stem":270,"type":200,"device":6},"\u002Ftechnical-reference\u002Fpython-cdk\u002Fchangelog\u002F","03.technical-reference\u002F60.python-cdk\u002F20.changelog",{"title":272,"type":6,"device":6,"path":273,"stem":274,"children":275,"page":41},"Concepts","\u002Fconcepts\u002F","04.concepts",[276,315,339,383,422],{"title":277,"type":6,"device":6,"path":278,"stem":279,"children":280,"page":41},"Labs as code","\u002Fconcepts\u002Flabs-as-code\u002F","04.concepts\u002F01.labs-as-code",[281,286,290],{"title":282,"path":283,"stem":284,"type":285,"device":6},"Lab as Code","\u002Fconcepts\u002Flabs-as-code\u002Fwhy-code\u002F","04.concepts\u002F01.labs-as-code\u002F00.why-code","explanation",{"title":287,"path":288,"stem":289,"type":285,"device":6},"How it works","\u002Fconcepts\u002Flabs-as-code\u002Fhow-it-works\u002F","04.concepts\u002F01.labs-as-code\u002F01.how-it-works",{"title":291,"type":6,"device":6,"path":292,"stem":293,"children":294,"page":41},"Use Cases","\u002Fconcepts\u002Flabs-as-code\u002Fuse-cases\u002F","04.concepts\u002F01.labs-as-code\u002F02.use-cases",[295,299,303,307,311],{"title":296,"path":297,"stem":298,"type":285,"device":6},"Instrument Control","\u002Fconcepts\u002Flabs-as-code\u002Fuse-cases\u002Flow-level-instrument-control\u002F","04.concepts\u002F01.labs-as-code\u002F02.use-cases\u002F10.low-level-instrument-control",{"title":300,"path":301,"stem":302,"type":285,"device":6},"Multi-device Control","\u002Fconcepts\u002Flabs-as-code\u002Fuse-cases\u002Fmulti-device-control\u002F","04.concepts\u002F01.labs-as-code\u002F02.use-cases\u002F20.multi-device-control",{"title":304,"path":305,"stem":306,"type":285,"device":6},"Workflow Orchestration","\u002Fconcepts\u002Flabs-as-code\u002Fuse-cases\u002Fworkflow-orchestration\u002F","04.concepts\u002F01.labs-as-code\u002F02.use-cases\u002F30.workflow-orchestration",{"title":308,"path":309,"stem":310,"type":285,"device":6},"Custom Apps and LIMS Integration","\u002Fconcepts\u002Flabs-as-code\u002Fuse-cases\u002Fcustom-apps-lims\u002F","04.concepts\u002F01.labs-as-code\u002F02.use-cases\u002F40.custom-apps-lims",{"title":312,"path":313,"stem":314,"type":285,"device":6},"Scale and Fleet Management","\u002Fconcepts\u002Flabs-as-code\u002Fuse-cases\u002Fscale-and-fleet\u002F","04.concepts\u002F01.labs-as-code\u002F02.use-cases\u002F50.scale-and-fleet",{"title":65,"type":6,"device":6,"path":316,"stem":317,"children":318,"page":41},"\u002Fconcepts\u002Fintegrate\u002F","04.concepts\u002F02.integrate",[319,323,327,331,335],{"title":320,"path":321,"stem":322,"type":285,"device":6},"Device","\u002Fconcepts\u002Fintegrate\u002Fdevice\u002F","04.concepts\u002F02.integrate\u002F05.device",{"title":324,"path":325,"stem":326,"type":285,"device":6},"Connector","\u002Fconcepts\u002Fintegrate\u002Fconnector\u002F","04.concepts\u002F02.integrate\u002F10.connector",{"title":328,"path":329,"stem":330,"type":285,"device":6},"Module","\u002Fconcepts\u002Fintegrate\u002Fmodule\u002F","04.concepts\u002F02.integrate\u002F20.module",{"title":332,"path":333,"stem":334,"type":285,"device":6},"Action","\u002Fconcepts\u002Fintegrate\u002Faction\u002F","04.concepts\u002F02.integrate\u002F30.action",{"title":336,"path":337,"stem":338,"type":285,"device":6},"Subscription","\u002Fconcepts\u002Fintegrate\u002Fsubscription\u002F","04.concepts\u002F02.integrate\u002F40.subscription",{"title":340,"type":6,"device":6,"path":341,"stem":342,"children":343,"page":41},"Liquid handling and robots","\u002Fconcepts\u002Foperate\u002F","04.concepts\u002F03.operate",[344,348,352,356,359,363,367,371,375,379],{"title":345,"path":346,"stem":347,"type":285,"device":6},"Liquid Handling","\u002Fconcepts\u002Foperate\u002Fliquid-handling\u002F","04.concepts\u002F03.operate\u002F10.liquid-handling",{"title":349,"path":350,"stem":351,"type":285,"device":6},"Modules","\u002Fconcepts\u002Foperate\u002Fmodules\u002F","04.concepts\u002F03.operate\u002F20.modules",{"title":353,"path":354,"stem":355,"type":285,"device":6},"Deck","\u002Fconcepts\u002Foperate\u002Fdeck\u002F","04.concepts\u002F03.operate\u002F30.deck",{"title":245,"path":357,"stem":358,"type":285,"device":6},"\u002Fconcepts\u002Foperate\u002Flabware\u002F","04.concepts\u002F03.operate\u002F40.labware",{"title":360,"path":361,"stem":362,"type":285,"device":6},"Liquids","\u002Fconcepts\u002Foperate\u002Fliquids\u002F","04.concepts\u002F03.operate\u002F50.liquids",{"title":364,"path":365,"stem":366,"type":285,"device":6},"Liquid Classes","\u002Fconcepts\u002Foperate\u002Fliquid-classes\u002F","04.concepts\u002F03.operate\u002F60.liquid-classes",{"title":368,"path":369,"stem":370,"type":285,"device":6},"Parameter Sets","\u002Fconcepts\u002Foperate\u002Fparameter-sets\u002F","04.concepts\u002F03.operate\u002F65.parameter-sets",{"title":372,"path":373,"stem":374,"type":285,"device":6},"Tips and Tip Tracking","\u002Fconcepts\u002Foperate\u002Ftips\u002F","04.concepts\u002F03.operate\u002F70.tips",{"title":376,"path":377,"stem":378,"type":285,"device":6},"Simulation","\u002Fconcepts\u002Foperate\u002Fsimulation\u002F","04.concepts\u002F03.operate\u002F80.simulation",{"title":380,"path":381,"stem":382,"type":285,"device":6},"Error Handling","\u002Fconcepts\u002Foperate\u002Ferror-handling\u002F","04.concepts\u002F03.operate\u002F90.error-handling",{"title":119,"type":6,"device":6,"path":384,"stem":385,"children":386,"page":41},"\u002Fconcepts\u002Fautomate\u002F","04.concepts\u002F07.automate",[387,391,395,399,403,407,411,415,419],{"title":388,"path":389,"stem":390,"type":285,"device":6},"Workflow","\u002Fconcepts\u002Fautomate\u002Fworkflow\u002F","04.concepts\u002F07.automate\u002F10.workflow",{"title":392,"path":393,"stem":394,"type":285,"device":6},"Phase","\u002Fconcepts\u002Fautomate\u002Fphase\u002F","04.concepts\u002F07.automate\u002F20.phase",{"title":396,"path":397,"stem":398,"type":285,"device":6},"Step","\u002Fconcepts\u002Fautomate\u002Fstep\u002F","04.concepts\u002F07.automate\u002F30.step",{"title":400,"path":401,"stem":402,"type":285,"device":6},"Runs","\u002Fconcepts\u002Fautomate\u002Fruns\u002F","04.concepts\u002F07.automate\u002F40.runs",{"title":404,"path":405,"stem":406,"type":285,"device":6},"Input","\u002Fconcepts\u002Fautomate\u002Finput\u002F","04.concepts\u002F07.automate\u002F50.input",{"title":408,"path":409,"stem":410,"type":285,"device":6},"Artifacts","\u002Fconcepts\u002Fautomate\u002Fartifacts\u002F","04.concepts\u002F07.automate\u002F60.artifacts",{"title":412,"path":413,"stem":414,"type":285,"device":6},"Logs","\u002Fconcepts\u002Fautomate\u002Flogs\u002F","04.concepts\u002F07.automate\u002F70.logs",{"title":416,"path":417,"stem":418,"type":285,"device":6},"Human in the Loop","\u002Fconcepts\u002Fautomate\u002Fhuman-in-the-loop\u002F","04.concepts\u002F07.automate\u002F80.human-in-the-loop",{"title":380,"path":420,"stem":421,"type":285,"device":6},"\u002Fconcepts\u002Fautomate\u002Ferror-handling\u002F","04.concepts\u002F07.automate\u002F90.error-handling",{"title":164,"type":6,"device":6,"path":423,"stem":424,"children":425,"page":41},"\u002Fconcepts\u002Fobserve\u002F","04.concepts\u002F08.observe",[426,429,433,437,441],{"title":194,"path":427,"stem":428,"type":14,"device":6},"\u002Fconcepts\u002Fobserve\u002Foverview\u002F","04.concepts\u002F08.observe\u002F10.overview",{"title":430,"path":431,"stem":432,"type":285,"device":6},"Object Storage","\u002Fconcepts\u002Fobserve\u002Fstorage\u002F","04.concepts\u002F08.observe\u002F10.storage",{"title":434,"path":435,"stem":436,"type":285,"device":6},"Secrets","\u002Fconcepts\u002Fobserve\u002Fsecrets\u002F","04.concepts\u002F08.observe\u002F20.secrets",{"title":438,"path":439,"stem":440,"type":285,"device":6},"Data sources","\u002Fconcepts\u002Fobserve\u002Fdata-sources\u002F","04.concepts\u002F08.observe\u002F30.data-sources",{"title":442,"path":443,"stem":444,"type":285,"device":6},"Data lineage","\u002Fconcepts\u002Fobserve\u002Fdata-lineage\u002F","04.concepts\u002F08.observe\u002F40.data-lineage",{"title":446,"type":6,"device":6,"path":447,"stem":448,"children":449,"page":41},"Devices","\u002Fdevices\u002F","05.devices",[450,453,501,514,530,567],{"title":194,"path":451,"stem":452,"type":14,"device":6},"\u002Fdevices\u002Foverview\u002F","05.devices\u002F00.overview",{"title":454,"path":455,"page":41,"children":456},"Heater-shakers","\u002Fdevices\u002Fheater-shakers\u002F",[457,478,488],{"title":458,"path":459,"stem":460,"type":200,"device":461},"QInstruments BioShake","\u002Fdevices\u002Fqinstruments-bioshake\u002F","05.devices\u002F10.qinstruments-bioshake",{"slug":462,"vendor":463,"category":464,"connector":462,"package":465,"models":466,"communication":473,"vendor_software":6,"os":474},"qinstruments-bioshake","QInstruments","Plate Shakers & Temperature Control","unitelabs-qinstruments-bioshake",[467,468,469,470,471,472],"BioShake 3000 \u002F 3000 elm \u002F 3000 elm DWP","BioShake 3000-T \u002F 3000-T elm","BioShake 5000 elm","BioShake D30 \u002F D30 elm \u002F D30-T \u002F D30-T elm","BioShake Q1 \u002F Q1 (1.2 mm) \u002F Q1 (3.0 mm) \u002F Q2","HeatPlate","serial (RS-232 over USB)",[475,476,477],"windows","linux","macos",{"title":479,"path":480,"stem":481,"type":200,"device":482},"QInstruments ColdPlate","\u002Fdevices\u002Fqinstruments-coldplate\u002F","05.devices\u002F20.qinstruments-coldplate",{"slug":483,"vendor":463,"category":464,"connector":462,"package":465,"models":484,"communication":473,"vendor_software":6,"os":487},"qinstruments-coldplate",[485,486],"ColdPlate","ColdPlate slim",[475,476,477],{"title":489,"path":490,"stem":491,"type":200,"device":492},"Inheco Thermoshake","\u002Fdevices\u002Finheco-thermoshake\u002F","05.devices\u002F30.inheco-thermoshake",{"slug":493,"vendor":494,"category":464,"connector":495,"models":496},"inheco-thermoshake","Inheco","inheco-tec-controller",[497,498,499,500],"Thermoshake AC","Thermoshake AC LC","Thermoshake Classic","Thermoshake RM",{"title":502,"path":503,"page":41,"children":504},"Incubation","\u002Fdevices\u002Fincubation\u002F",[505],{"title":506,"path":507,"stem":508,"type":200,"device":509},"Inheco SCILA","\u002Fdevices\u002Finheco-scila\u002F","05.devices\u002F40.inheco-scila",{"slug":510,"vendor":494,"category":502,"connector":510,"models":511},"inheco-scila",[512,513],"SCILA","SCILA MIX 2-gas mixing device",{"title":515,"path":516,"page":41,"children":517},"Thermal cyclers","\u002Fdevices\u002Fthermal-cyclers\u002F",[518],{"title":519,"path":520,"stem":521,"type":200,"device":522},"Inheco ODTC","\u002Fdevices\u002Finheco-odtc\u002F","05.devices\u002F50.inheco-odtc",{"slug":523,"vendor":494,"category":524,"connector":523,"models":525},"inheco-odtc","Thermal Cycler",[526,527,528,529],"ODTC 96","ODTC 96XL","ODTC 384","ODTC 384XL",{"title":531,"path":532,"page":41,"children":533},"Readers","\u002Fdevices\u002Freaders\u002F",[534,543,552],{"title":535,"path":536,"stem":537,"type":200,"device":538},"Agilent Biotek Gen5","\u002Fdevices\u002Fbiotek-gen5\u002F","05.devices\u002F60.biotek-gen5",{"slug":539,"vendor":540,"category":541,"connector":542},"biotek-gen5","Agilent","Readers & Imagers","gen5",{"title":544,"path":545,"stem":546,"type":200,"device":547},"Biotek Synergy H1","\u002Fdevices\u002Fbiotek-synergy-h1\u002F","05.devices\u002F70.biotek-synergy-h1",{"slug":548,"vendor":540,"category":541,"connector":549,"models":550},"biotek-synergy-h1","agilent-synergy-h1",[551],"BioTek Synergy H1",{"title":553,"path":554,"stem":555,"type":200,"device":556},"Tecan Infinite 200","\u002Fdevices\u002Ftecan-infinite-200\u002F","05.devices\u002F75.tecan-infinite-200",{"slug":557,"vendor":558,"category":541,"connector":557,"package":559,"models":560,"communication":564,"vendor_software":565,"os":566},"tecan-infinite-200","Tecan","unitelabs-tecan-infinite-200",[561,562,563],"Infinite F200","Infinite M200","Infinite M200 Pro","USB","i-control on Windows only, for its USB driver",[475,476,477],{"title":568,"path":569,"page":41,"children":570},"Tilt & turn","\u002Fdevices\u002Ftilt-and-turn\u002F",[571,581],{"title":572,"path":573,"stem":574,"type":200,"device":575},"QInstruments TiltStation","\u002Fdevices\u002Fqinstruments-tiltstation\u002F","05.devices\u002F80.qinstruments-tiltstation",{"slug":576,"vendor":463,"category":577,"connector":462,"package":465,"models":578,"communication":473,"vendor_software":6,"os":580},"qinstruments-tiltstation","Plate Tilting",[579],"TiltStation",[475,476,477],{"title":582,"path":583,"stem":584,"type":200,"device":585},"QInstruments TurnStation","\u002Fdevices\u002Fqinstruments-turnstation\u002F","05.devices\u002F90.qinstruments-turnstation",{"slug":586,"vendor":463,"category":587,"connector":462,"package":465,"models":588,"communication":473,"vendor_software":6,"os":590},"qinstruments-turnstation","Plate Rotating",[589],"TurnStation",[475,476,477],{"title":592,"type":6,"device":6,"path":593,"stem":594,"children":595,"page":41},"Liquid Handling and Robots","\u002Fliquid-handling-and-robots\u002F","06.liquid-handling-and-robots",[596,599,611,635,638,679,704,721,738],{"title":194,"path":597,"stem":598,"type":14,"device":6},"\u002Fliquid-handling-and-robots\u002Foverview\u002F","06.liquid-handling-and-robots\u002F00.overview",{"title":353,"type":6,"device":6,"path":600,"stem":601,"children":602,"page":41},"\u002Fliquid-handling-and-robots\u002Fdeck\u002F","06.liquid-handling-and-robots\u002F10.deck",[603,607],{"title":604,"path":605,"stem":606,"type":24,"device":6},"Building a Deck","\u002Fliquid-handling-and-robots\u002Fdeck\u002Fbuilding-a-deck\u002F","06.liquid-handling-and-robots\u002F10.deck\u002F10.building-a-deck",{"title":608,"path":609,"stem":610,"type":24,"device":6},"Save\u002FLoad a Deck","\u002Fliquid-handling-and-robots\u002Fdeck\u002Fsave-load-deck\u002F","06.liquid-handling-and-robots\u002F10.deck\u002F20.save-load-deck",{"title":612,"type":6,"device":6,"path":613,"stem":614,"children":615,"page":41},"Pipetting","\u002Fliquid-handling-and-robots\u002Fpipetting\u002F","06.liquid-handling-and-robots\u002F20.pipetting",[616,620,624,628,631],{"title":617,"path":618,"stem":619,"type":24,"device":6},"Basic Pipetting","\u002Fliquid-handling-and-robots\u002Fpipetting\u002Fbasic-pipetting\u002F","06.liquid-handling-and-robots\u002F20.pipetting\u002F10.basic-pipetting",{"title":621,"path":622,"stem":623,"type":24,"device":6},"Advanced Pipetting","\u002Fliquid-handling-and-robots\u002Fpipetting\u002Fadvanced-pipetting\u002F","06.liquid-handling-and-robots\u002F20.pipetting\u002F20.advanced-pipetting",{"title":625,"path":626,"stem":627,"type":24,"device":6},"Tip Handling","\u002Fliquid-handling-and-robots\u002Fpipetting\u002Ftip-handling\u002F","06.liquid-handling-and-robots\u002F20.pipetting\u002F30.tip-handling",{"title":364,"path":629,"stem":630,"type":24,"device":6},"\u002Fliquid-handling-and-robots\u002Fpipetting\u002Fliquid-classes\u002F","06.liquid-handling-and-robots\u002F20.pipetting\u002F40.liquid-classes",{"title":632,"path":633,"stem":634,"type":24,"device":6},"Labware Transport","\u002Fliquid-handling-and-robots\u002Fpipetting\u002Flabware-transport\u002F","06.liquid-handling-and-robots\u002F20.pipetting\u002F50.labware-transport",{"title":376,"path":636,"stem":637,"type":24,"device":6},"\u002Fliquid-handling-and-robots\u002Fsimulation\u002F","06.liquid-handling-and-robots\u002F30.simulation",{"title":639,"type":6,"device":6,"path":640,"stem":641,"children":642,"page":41},"Hamilton STAR","\u002Fliquid-handling-and-robots\u002Fhamilton-star\u002F","06.liquid-handling-and-robots\u002F41.hamilton-star",[643,647,651,655,659,663,667,671,675],{"title":644,"path":645,"stem":646,"type":24,"device":6},"Positioning & Movement","\u002Fliquid-handling-and-robots\u002Fhamilton-star\u002Fpositioning\u002F","06.liquid-handling-and-robots\u002F41.hamilton-star\u002F10.positioning",{"title":648,"path":649,"stem":650,"type":24,"device":6},"Gripper Module","\u002Fliquid-handling-and-robots\u002Fhamilton-star\u002Fcore-gripper\u002F","06.liquid-handling-and-robots\u002F41.hamilton-star\u002F20.core-gripper",{"title":652,"path":653,"stem":654,"type":24,"device":6},"iSWAP Module","\u002Fliquid-handling-and-robots\u002Fhamilton-star\u002Fiswap\u002F","06.liquid-handling-and-robots\u002F41.hamilton-star\u002F30.iswap",{"title":656,"path":657,"stem":658,"type":24,"device":6},"Using TADM","\u002Fliquid-handling-and-robots\u002Fhamilton-star\u002Ftadm\u002F","06.liquid-handling-and-robots\u002F41.hamilton-star\u002F40.tadm",{"title":660,"path":661,"stem":662,"type":24,"device":6},"Autoload Module","\u002Fliquid-handling-and-robots\u002Fhamilton-star\u002Fautoload\u002F","06.liquid-handling-and-robots\u002F41.hamilton-star\u002F50.autoload",{"title":664,"path":665,"stem":666,"type":24,"device":6},"Waste Block","\u002Fliquid-handling-and-robots\u002Fhamilton-star\u002Fwaste-block\u002F","06.liquid-handling-and-robots\u002F41.hamilton-star\u002F60.waste-block",{"title":668,"path":669,"stem":670,"type":24,"device":6},"Complex Mixing","\u002Fliquid-handling-and-robots\u002Fhamilton-star\u002Fcomplex-mixing\u002F","06.liquid-handling-and-robots\u002F41.hamilton-star\u002F66.complex-mixing",{"title":672,"path":673,"stem":674,"type":24,"device":6},"Teaching Gripper Paddle Positions","\u002Fliquid-handling-and-robots\u002Fhamilton-star\u002Fgripper-positions\u002F","06.liquid-handling-and-robots\u002F41.hamilton-star\u002F70.gripper-positions",{"title":676,"path":677,"stem":678,"type":24,"device":6},"Training a Custom Deck Position With the iSWAP","\u002Fliquid-handling-and-robots\u002Fhamilton-star\u002Fcustom-deck-position\u002F","06.liquid-handling-and-robots\u002F41.hamilton-star\u002F75.custom-deck-position",{"title":680,"type":6,"device":6,"path":681,"stem":682,"children":683,"page":41},"Hamilton Vantage","\u002Fliquid-handling-and-robots\u002Fhamilton-vantage\u002F","06.liquid-handling-and-robots\u002F42.hamilton-vantage",[684,688,692,696,700],{"title":685,"path":686,"stem":687,"type":24,"device":6},"Waste Configuration","\u002Fliquid-handling-and-robots\u002Fhamilton-vantage\u002Fwaste-configuration\u002F","06.liquid-handling-and-robots\u002F42.hamilton-vantage\u002F05.waste-configuration",{"title":689,"path":690,"stem":691,"type":24,"device":6},"Covers and Lights","\u002Fliquid-handling-and-robots\u002Fhamilton-vantage\u002Fcovers-and-lights\u002F","06.liquid-handling-and-robots\u002F42.hamilton-vantage\u002F10.covers-and-lights",{"title":693,"path":694,"stem":695,"type":24,"device":6},"IDL Module","\u002Fliquid-handling-and-robots\u002Fhamilton-vantage\u002Fidl\u002F","06.liquid-handling-and-robots\u002F42.hamilton-vantage\u002F20.idl",{"title":697,"path":698,"stem":699,"type":24,"device":6},"IPG Module","\u002Fliquid-handling-and-robots\u002Fhamilton-vantage\u002Fipg\u002F","06.liquid-handling-and-robots\u002F42.hamilton-vantage\u002F30.ipg",{"title":701,"path":702,"stem":703,"type":24,"device":6},"XL Pipettes","\u002Fliquid-handling-and-robots\u002Fhamilton-vantage\u002Fxl-channels\u002F","06.liquid-handling-and-robots\u002F42.hamilton-vantage\u002F40.xl-channels",{"title":705,"type":6,"device":6,"path":706,"stem":707,"children":708,"page":41},"Agilent Bravo","\u002Fliquid-handling-and-robots\u002Fagilent-bravo\u002F","06.liquid-handling-and-robots\u002F43.agilent-bravo",[709,712,715,718],{"title":625,"path":710,"stem":711,"type":24,"device":6},"\u002Fliquid-handling-and-robots\u002Fagilent-bravo\u002Ftip-handling\u002F","06.liquid-handling-and-robots\u002F43.agilent-bravo\u002F10.tip-handling",{"title":617,"path":713,"stem":714,"type":24,"device":6},"\u002Fliquid-handling-and-robots\u002Fagilent-bravo\u002Fbasic-pipetting\u002F","06.liquid-handling-and-robots\u002F43.agilent-bravo\u002F20.basic-pipetting",{"title":364,"path":716,"stem":717,"type":24,"device":6},"\u002Fliquid-handling-and-robots\u002Fagilent-bravo\u002Fliquid-classes\u002F","06.liquid-handling-and-robots\u002F43.agilent-bravo\u002F25.liquid-classes",{"title":648,"path":719,"stem":720,"type":24,"device":6},"\u002Fliquid-handling-and-robots\u002Fagilent-bravo\u002Fusing-the-gripper\u002F","06.liquid-handling-and-robots\u002F43.agilent-bravo\u002F30.using-the-gripper",{"title":722,"type":6,"device":6,"path":723,"stem":724,"children":725,"page":41},"Tecan FluentControl","\u002Fliquid-handling-and-robots\u002Ftecan-fluentcontrol\u002F","06.liquid-handling-and-robots\u002F44.tecan-fluentcontrol",[726,730,734],{"title":727,"path":728,"stem":729,"type":24,"device":6},"Connect & Run a Method","\u002Fliquid-handling-and-robots\u002Ftecan-fluentcontrol\u002Fconnect-and-run\u002F","06.liquid-handling-and-robots\u002F44.tecan-fluentcontrol\u002F10.connect-and-run",{"title":731,"path":732,"stem":733,"type":24,"device":6},"Sending XML Commands","\u002Fliquid-handling-and-robots\u002Ftecan-fluentcontrol\u002Fsending-xml-commands\u002F","06.liquid-handling-and-robots\u002F44.tecan-fluentcontrol\u002F20.sending-xml-commands",{"title":735,"path":736,"stem":737,"type":24,"device":6},"Full Workflow Example","\u002Fliquid-handling-and-robots\u002Ftecan-fluentcontrol\u002Ffull-workflow-example\u002F","06.liquid-handling-and-robots\u002F44.tecan-fluentcontrol\u002F30.full-workflow-example",{"title":739,"type":6,"device":6,"path":740,"stem":741,"children":742,"page":41},"Tecan Freedom EVO","\u002Fliquid-handling-and-robots\u002Ftecan-freedom-evo\u002F","06.liquid-handling-and-robots\u002F45.tecan-freedom-evo",[743,747,750,753,757],{"title":744,"path":745,"stem":746,"type":24,"device":6},"Deck & Carriers","\u002Fliquid-handling-and-robots\u002Ftecan-freedom-evo\u002Fdeck-and-carriers\u002F","06.liquid-handling-and-robots\u002F45.tecan-freedom-evo\u002F10.deck-and-carriers",{"title":625,"path":748,"stem":749,"type":24,"device":6},"\u002Fliquid-handling-and-robots\u002Ftecan-freedom-evo\u002Ftip-handling\u002F","06.liquid-handling-and-robots\u002F45.tecan-freedom-evo\u002F20.tip-handling",{"title":617,"path":751,"stem":752,"type":24,"device":6},"\u002Fliquid-handling-and-robots\u002Ftecan-freedom-evo\u002Fbasic-pipetting\u002F","06.liquid-handling-and-robots\u002F45.tecan-freedom-evo\u002F30.basic-pipetting",{"title":754,"path":755,"stem":756,"type":24,"device":6},"Using the Gripper (RoMa)","\u002Fliquid-handling-and-robots\u002Ftecan-freedom-evo\u002Fusing-the-gripper\u002F","06.liquid-handling-and-robots\u002F45.tecan-freedom-evo\u002F40.using-the-gripper",{"title":364,"path":758,"stem":759,"type":24,"device":6},"\u002Fliquid-handling-and-robots\u002Ftecan-freedom-evo\u002Fliquid-classes\u002F","06.liquid-handling-and-robots\u002F45.tecan-freedom-evo\u002F50.liquid-classes",{"title":245,"type":6,"device":6,"path":761,"stem":762,"children":763,"page":41},"\u002Flabware\u002F","07.labware",[764,767,771,775,779,783,787],{"title":194,"path":765,"stem":766,"type":14,"device":6},"\u002Flabware\u002Foverview\u002F","07.labware\u002F00.overview",{"title":768,"path":769,"stem":770,"type":200,"device":6},"Standard Labware","\u002Flabware\u002Fstandard-labware\u002F","07.labware\u002F10.standard-labware",{"title":772,"path":773,"stem":774,"type":200,"device":6},"Plates","\u002Flabware\u002Fplates\u002F","07.labware\u002F20.plates",{"title":776,"path":777,"stem":778,"type":200,"device":6},"Tips and Tip Racks","\u002Flabware\u002Ftips-and-racks\u002F","07.labware\u002F30.tips-and-racks",{"title":780,"path":781,"stem":782,"type":200,"device":6},"Tubes and Tube Racks","\u002Flabware\u002Ftubes-and-tube-racks\u002F","07.labware\u002F40.tubes-and-tube-racks",{"title":784,"path":785,"stem":786,"type":200,"device":6},"Troughs","\u002Flabware\u002Ftroughs\u002F","07.labware\u002F50.troughs",{"title":788,"path":789,"stem":790,"type":200,"device":6},"Carriers and Adapters","\u002Flabware\u002Fcarriers-and-adapters\u002F","07.labware\u002F60.carriers-and-adapters",{"title":792,"type":6,"device":6,"path":793,"stem":794,"children":795},"Connector Development (CDK)","\u002Fconnector-development\u002F","20.connector-development",[796,798,822,855,863,903],{"title":194,"path":793,"stem":797,"type":14,"device":6},"20.connector-development\u002Findex",{"title":799,"path":800,"stem":801,"children":802,"page":41},"Getting Started","\u002Fconnector-development\u002Fgetting-started\u002F","20.connector-development\u002F10.getting-started",[803,806,810,814,818],{"title":194,"path":804,"stem":805,"type":285,"device":6},"\u002Fconnector-development\u002Fgetting-started\u002Foverview\u002F","20.connector-development\u002F10.getting-started\u002F10.overview",{"title":807,"path":808,"stem":809,"type":24,"device":6},"What's new","\u002Fconnector-development\u002Fgetting-started\u002Fwhats-new\u002F","20.connector-development\u002F10.getting-started\u002F20.whats-new",{"title":811,"path":812,"stem":813,"type":24,"device":6},"Installation","\u002Fconnector-development\u002Fgetting-started\u002Finstallation\u002F","20.connector-development\u002F10.getting-started\u002F30.installation",{"title":815,"path":816,"stem":817,"type":24,"device":6},"Python Environment and Project Management","\u002Fconnector-development\u002Fgetting-started\u002Fpython-environments\u002F","20.connector-development\u002F10.getting-started\u002F35.python-environments",{"title":819,"path":820,"stem":821,"type":24,"device":6},"Contributing","\u002Fconnector-development\u002Fgetting-started\u002Fcontributing\u002F","20.connector-development\u002F10.getting-started\u002F40.contributing",{"title":823,"path":824,"stem":825,"children":826,"page":41},"Tutorial","\u002Fconnector-development\u002Ftutorial\u002F","20.connector-development\u002F20.tutorial",[827,831,835,839,843,847,851],{"title":828,"path":829,"stem":830,"type":46,"device":6},"Walkthrough","\u002Fconnector-development\u002Ftutorial\u002Fwalkthrough\u002F","20.connector-development\u002F20.tutorial\u002F00.walkthrough",{"title":832,"path":833,"stem":834,"type":46,"device":6},"SiLA Endpoints","\u002Fconnector-development\u002Ftutorial\u002Fsila-endpoints\u002F","20.connector-development\u002F20.tutorial\u002F10.sila-endpoints",{"title":836,"path":837,"stem":838,"type":46,"device":6},"Data Endpoints","\u002Fconnector-development\u002Ftutorial\u002Fdata-endpoints\u002F","20.connector-development\u002F20.tutorial\u002F20.data-endpoints",{"title":840,"path":841,"stem":842,"type":46,"device":6},"Controls","\u002Fconnector-development\u002Ftutorial\u002Fcontrols\u002F","20.connector-development\u002F20.tutorial\u002F30.controls",{"title":844,"path":845,"stem":846,"type":46,"device":6},"SiLA Data Types","\u002Fconnector-development\u002Ftutorial\u002Fdata-types\u002F","20.connector-development\u002F20.tutorial\u002F40.data-types",{"title":848,"path":849,"stem":850,"type":46,"device":6},"Feature","\u002Fconnector-development\u002Ftutorial\u002Fconnector-structure\u002F","20.connector-development\u002F20.tutorial\u002F70.connector-structure",{"title":852,"path":853,"stem":854,"type":46,"device":6},"Hardware Communication","\u002Fconnector-development\u002Ftutorial\u002Fhardware-communication\u002F","20.connector-development\u002F20.tutorial\u002F90.hardware-communication",{"title":272,"type":6,"device":6,"path":856,"stem":857,"children":858,"page":41},"\u002Fconnector-development\u002Fconcepts\u002F","20.connector-development\u002F30.concepts",[859],{"title":860,"path":861,"stem":862,"type":285,"device":6},"SiLA","\u002Fconnector-development\u002Fconcepts\u002Fsila\u002F","20.connector-development\u002F30.concepts\u002Fsila",{"title":864,"path":865,"stem":866,"children":867,"page":41},"Guides","\u002Fconnector-development\u002Fguides\u002F","20.connector-development\u002F40.guides",[868,872,876,880,884,888,892,895,899],{"title":869,"path":870,"stem":871,"type":24,"device":6},"Configuration","\u002Fconnector-development\u002Fguides\u002Fconfiguration\u002F","20.connector-development\u002F40.guides\u002F20.configuration",{"title":873,"path":874,"stem":875,"type":24,"device":6},"Logging","\u002Fconnector-development\u002Fguides\u002Flogging\u002F","20.connector-development\u002F40.guides\u002F21.logging",{"title":877,"path":878,"stem":879,"type":24,"device":6},"Deployment","\u002Fconnector-development\u002Fguides\u002Fdeployment\u002F","20.connector-development\u002F40.guides\u002F30.deployment",{"title":881,"path":882,"stem":883,"type":24,"device":6},"Security","\u002Fconnector-development\u002Fguides\u002Fsecurity\u002F","20.connector-development\u002F40.guides\u002F40.security",{"title":885,"path":886,"stem":887,"type":24,"device":6},"Subscriptions","\u002Fconnector-development\u002Fguides\u002Fsubscriptions\u002F","20.connector-development\u002F40.guides\u002F45.subscriptions",{"title":889,"path":890,"stem":891,"type":24,"device":6},"Execution Modes","\u002Fconnector-development\u002Fguides\u002Fexecution-modes\u002F","20.connector-development\u002F40.guides\u002F46.execution-modes",{"title":380,"path":893,"stem":894,"type":24,"device":6},"\u002Fconnector-development\u002Fguides\u002Ferror-handling\u002F","20.connector-development\u002F40.guides\u002F50.error-handling",{"title":896,"path":897,"stem":898,"type":24,"device":6},"Serial Troubleshooting","\u002Fconnector-development\u002Fguides\u002Fserial-troubleshooting\u002F","20.connector-development\u002F40.guides\u002F70.serial-troubleshooting",{"title":900,"path":901,"stem":902,"type":24,"device":6},"Testing","\u002Fconnector-development\u002Fguides\u002Ftesting\u002F","20.connector-development\u002F40.guides\u002F80.testing",{"title":904,"path":905,"stem":906,"children":907,"type":6,"device":6},"References","\u002Fconnector-development\u002Freference\u002F","20.connector-development\u002F50.reference\u002Findex",[908],{"title":904,"path":905,"stem":906,"type":200,"device":6},{"id":910,"title":152,"body":911,"description":2533,"device":6,"extension":2534,"links":6,"meta":2535,"navigation":1011,"path":2536,"seo":2537,"stem":154,"type":24,"__hash__":2538},"docs\u002F02.how-to\u002F07.automate\u002F60.basic-error-handling.md",{"type":912,"value":913,"toc":2524},"minimark",[914,918,921,927,939,942,951,965,1253,1264,1268,1286,1473,1479,1588,1600,1604,1615,1922,1936,1940,1943,2296,2303,2305,2309,2312,2363,2496,2502,2506,2520],[915,916,917],"p",{},"In lab automation, an error mid-run can leave hardware in an inconsistent state — tips are still loaded, a plate is mid-transfer, a gripper is holding something. Error recovery means: clean up first, then decide whether to retry or abort.",[915,919,920],{},"This guide covers four practical patterns. They compose well — most real workflows use two or three of them together.",[915,922,923],{},[924,925,926],"strong",{},"Prerequisites",[928,929,930],"ul",{},[931,932,933,934,938],"li",{},"A working workflow (see ",[935,936,937],"a",{"href":53},"Build your first workflow",")",[940,941],"hr",{},[943,944,946,947],"h2",{"id":945},"pattern-1-guaranteed-cleanup-with-tryfinally","Pattern 1 — Guaranteed cleanup with ",[948,949,950],"code",{},"try\u002Ffinally",[915,952,953,954,956,957,960,961,964],{},"Use ",[948,955,950],{}," to ensure hardware is left in a safe state even when an operation fails. The ",[948,958,959],{},"finally"," block always executes — whether the ",[948,962,963],{},"try"," body succeeds, raises, or is cancelled.",[966,967,972],"pre",{"className":968,"code":969,"language":970,"meta":971,"style":971},"language-python shiki shiki-themes github-light-high-contrast github-light-high-contrast github-dark-default","from unitelabs.sdk import get_logger\nfrom unitelabs.sdk.automate import phase\n\n\n@phase(log_prints=True, name=\"Dispensing Phase\")\nasync def dispensing_phase(lh) -> dict:\n    logger = get_logger()\n    try:\n        lh = await distribute_colour(lh=lh, reservoir=\"ice\", volume=100.0)\n        lh = await distribute_colour(lh=lh, reservoir=\"orange\", volume=100.0)\n    finally:\n        # Always return tips to the rack — even if distribute raises.\n        # This runs on success, exception, and run cancellation.\n        lh = await return_tips(lh=lh)\n        logger.info(\"Tips returned.\")\n\n    return {\"lh\": lh, \"status\": \"success\"}\n","python","",[948,973,974,993,1006,1013,1018,1054,1075,1086,1094,1136,1170,1178,1185,1191,1210,1221,1226],{"__ignoreMap":971},[975,976,979,983,987,990],"span",{"class":977,"line":978},"line",1,[975,980,982],{"class":981},"sxkbv","from",[975,984,986],{"class":985},"sc-9e"," unitelabs.sdk ",[975,988,989],{"class":981},"import",[975,991,992],{"class":985}," get_logger\n",[975,994,996,998,1001,1003],{"class":977,"line":995},2,[975,997,982],{"class":981},[975,999,1000],{"class":985}," unitelabs.sdk.automate ",[975,1002,989],{"class":981},[975,1004,1005],{"class":985}," phase\n",[975,1007,1009],{"class":977,"line":1008},3,[975,1010,1012],{"emptyLinePlaceholder":1011},true,"\n",[975,1014,1016],{"class":977,"line":1015},4,[975,1017,1012],{"emptyLinePlaceholder":1011},[975,1019,1021,1025,1028,1032,1035,1039,1042,1045,1047,1051],{"class":977,"line":1020},5,[975,1022,1024],{"class":1023},"s4qFZ","@phase",[975,1026,1027],{"class":985},"(",[975,1029,1031],{"class":1030},"sNqAu","log_prints",[975,1033,1034],{"class":981},"=",[975,1036,1038],{"class":1037},"sOiAX","True",[975,1040,1041],{"class":985},", ",[975,1043,1044],{"class":1030},"name",[975,1046,1034],{"class":981},[975,1048,1050],{"class":1049},"sCx38","\"Dispensing Phase\"",[975,1052,1053],{"class":985},")\n",[975,1055,1057,1060,1063,1066,1069,1072],{"class":977,"line":1056},6,[975,1058,1059],{"class":981},"async",[975,1061,1062],{"class":981}," def",[975,1064,1065],{"class":1023}," dispensing_phase",[975,1067,1068],{"class":985},"(lh) -> ",[975,1070,1071],{"class":1037},"dict",[975,1073,1074],{"class":985},":\n",[975,1076,1078,1081,1083],{"class":977,"line":1077},7,[975,1079,1080],{"class":985},"    logger ",[975,1082,1034],{"class":981},[975,1084,1085],{"class":985}," get_logger()\n",[975,1087,1089,1092],{"class":977,"line":1088},8,[975,1090,1091],{"class":981},"    try",[975,1093,1074],{"class":985},[975,1095,1097,1100,1102,1105,1108,1111,1113,1116,1119,1121,1124,1126,1129,1131,1134],{"class":977,"line":1096},9,[975,1098,1099],{"class":985},"        lh ",[975,1101,1034],{"class":981},[975,1103,1104],{"class":981}," await",[975,1106,1107],{"class":985}," distribute_colour(",[975,1109,1110],{"class":1030},"lh",[975,1112,1034],{"class":981},[975,1114,1115],{"class":985},"lh, ",[975,1117,1118],{"class":1030},"reservoir",[975,1120,1034],{"class":981},[975,1122,1123],{"class":1049},"\"ice\"",[975,1125,1041],{"class":985},[975,1127,1128],{"class":1030},"volume",[975,1130,1034],{"class":981},[975,1132,1133],{"class":1037},"100.0",[975,1135,1053],{"class":985},[975,1137,1139,1141,1143,1145,1147,1149,1151,1153,1155,1157,1160,1162,1164,1166,1168],{"class":977,"line":1138},10,[975,1140,1099],{"class":985},[975,1142,1034],{"class":981},[975,1144,1104],{"class":981},[975,1146,1107],{"class":985},[975,1148,1110],{"class":1030},[975,1150,1034],{"class":981},[975,1152,1115],{"class":985},[975,1154,1118],{"class":1030},[975,1156,1034],{"class":981},[975,1158,1159],{"class":1049},"\"orange\"",[975,1161,1041],{"class":985},[975,1163,1128],{"class":1030},[975,1165,1034],{"class":981},[975,1167,1133],{"class":1037},[975,1169,1053],{"class":985},[975,1171,1173,1176],{"class":977,"line":1172},11,[975,1174,1175],{"class":981},"    finally",[975,1177,1074],{"class":985},[975,1179,1181],{"class":977,"line":1180},12,[975,1182,1184],{"class":1183},"sIsDC","        # Always return tips to the rack — even if distribute raises.\n",[975,1186,1188],{"class":977,"line":1187},13,[975,1189,1190],{"class":1183},"        # This runs on success, exception, and run cancellation.\n",[975,1192,1194,1196,1198,1200,1203,1205,1207],{"class":977,"line":1193},14,[975,1195,1099],{"class":985},[975,1197,1034],{"class":981},[975,1199,1104],{"class":981},[975,1201,1202],{"class":985}," return_tips(",[975,1204,1110],{"class":1030},[975,1206,1034],{"class":981},[975,1208,1209],{"class":985},"lh)\n",[975,1211,1213,1216,1219],{"class":977,"line":1212},15,[975,1214,1215],{"class":985},"        logger.info(",[975,1217,1218],{"class":1049},"\"Tips returned.\"",[975,1220,1053],{"class":985},[975,1222,1224],{"class":977,"line":1223},16,[975,1225,1012],{"emptyLinePlaceholder":1011},[975,1227,1229,1232,1235,1238,1241,1244,1247,1250],{"class":977,"line":1228},17,[975,1230,1231],{"class":981},"    return",[975,1233,1234],{"class":985}," {",[975,1236,1237],{"class":1049},"\"lh\"",[975,1239,1240],{"class":985},": lh, ",[975,1242,1243],{"class":1049},"\"status\"",[975,1245,1246],{"class":985},": ",[975,1248,1249],{"class":1049},"\"success\"",[975,1251,1252],{"class":985},"}\n",[915,1254,1255,1260,1261,1263],{},[924,1256,953,1257,1259],{},[948,1258,959],{}," for any action that must happen regardless of outcome:"," returning tips, closing connections, unlocking an instrument, setting a status flag. Do not use it for logic that should only run on success — put that in the ",[948,1262,963],{}," body.",[943,1265,1267],{"id":1266},"pattern-2-automatic-retry-with-delay","Pattern 2 — Automatic retry with delay",[915,1269,1270,1271,1274,1275,1278,1279,1281,1282,1285],{},"Add ",[948,1272,1273],{},"retries"," and ",[948,1276,1277],{},"retry_delay_seconds"," to a ",[948,1280,1024],{}," or ",[948,1283,1284],{},"@step"," to have the SDK automatically re-run it when an unhandled exception escapes. This is ideal for transient hardware failures — a gripper that occasionally mis-grips, a sensor that times out under load.",[966,1287,1289],{"className":968,"code":1288,"language":970,"meta":971,"style":971},"from unitelabs.sdk.automate import phase\n\n\n@phase(\n    log_prints=True,\n    name=\"Return Plate Phase\",\n    retries=1,\n    retry_delay_seconds=60,\n)\nasync def return_plate_phase(lh) -> dict:\n    \"\"\"\n    Move plate from working carrier back to storage.\n    If the gripper motion fails, the workflow engine retries once after 60 seconds.\n    The delay gives the instrument time to reset before the next attempt.\n    \"\"\"\n    lh = await gripper_move(\n        lh=lh,\n        source=\"working_carrier[1]\",\n        destination=\"storage_carrier[4]\",\n    )\n    return {\"lh\": lh}\n",[948,1290,1291,1301,1305,1309,1316,1328,1340,1352,1364,1368,1383,1388,1393,1398,1403,1407,1419,1429,1442,1455,1461],{"__ignoreMap":971},[975,1292,1293,1295,1297,1299],{"class":977,"line":978},[975,1294,982],{"class":981},[975,1296,1000],{"class":985},[975,1298,989],{"class":981},[975,1300,1005],{"class":985},[975,1302,1303],{"class":977,"line":995},[975,1304,1012],{"emptyLinePlaceholder":1011},[975,1306,1307],{"class":977,"line":1008},[975,1308,1012],{"emptyLinePlaceholder":1011},[975,1310,1311,1313],{"class":977,"line":1015},[975,1312,1024],{"class":1023},[975,1314,1315],{"class":985},"(\n",[975,1317,1318,1321,1323,1325],{"class":977,"line":1020},[975,1319,1320],{"class":1030},"    log_prints",[975,1322,1034],{"class":981},[975,1324,1038],{"class":1037},[975,1326,1327],{"class":985},",\n",[975,1329,1330,1333,1335,1338],{"class":977,"line":1056},[975,1331,1332],{"class":1030},"    name",[975,1334,1034],{"class":981},[975,1336,1337],{"class":1049},"\"Return Plate Phase\"",[975,1339,1327],{"class":985},[975,1341,1342,1345,1347,1350],{"class":977,"line":1077},[975,1343,1344],{"class":1030},"    retries",[975,1346,1034],{"class":981},[975,1348,1349],{"class":1037},"1",[975,1351,1327],{"class":985},[975,1353,1354,1357,1359,1362],{"class":977,"line":1088},[975,1355,1356],{"class":1030},"    retry_delay_seconds",[975,1358,1034],{"class":981},[975,1360,1361],{"class":1037},"60",[975,1363,1327],{"class":985},[975,1365,1366],{"class":977,"line":1096},[975,1367,1053],{"class":985},[975,1369,1370,1372,1374,1377,1379,1381],{"class":977,"line":1138},[975,1371,1059],{"class":981},[975,1373,1062],{"class":981},[975,1375,1376],{"class":1023}," return_plate_phase",[975,1378,1068],{"class":985},[975,1380,1071],{"class":1037},[975,1382,1074],{"class":985},[975,1384,1385],{"class":977,"line":1172},[975,1386,1387],{"class":1049},"    \"\"\"\n",[975,1389,1390],{"class":977,"line":1180},[975,1391,1392],{"class":1049},"    Move plate from working carrier back to storage.\n",[975,1394,1395],{"class":977,"line":1187},[975,1396,1397],{"class":1049},"    If the gripper motion fails, the workflow engine retries once after 60 seconds.\n",[975,1399,1400],{"class":977,"line":1193},[975,1401,1402],{"class":1049},"    The delay gives the instrument time to reset before the next attempt.\n",[975,1404,1405],{"class":977,"line":1212},[975,1406,1387],{"class":1049},[975,1408,1409,1412,1414,1416],{"class":977,"line":1223},[975,1410,1411],{"class":985},"    lh ",[975,1413,1034],{"class":981},[975,1415,1104],{"class":981},[975,1417,1418],{"class":985}," gripper_move(\n",[975,1420,1421,1424,1426],{"class":977,"line":1228},[975,1422,1423],{"class":1030},"        lh",[975,1425,1034],{"class":981},[975,1427,1428],{"class":985},"lh,\n",[975,1430,1432,1435,1437,1440],{"class":977,"line":1431},18,[975,1433,1434],{"class":1030},"        source",[975,1436,1034],{"class":981},[975,1438,1439],{"class":1049},"\"working_carrier[1]\"",[975,1441,1327],{"class":985},[975,1443,1445,1448,1450,1453],{"class":977,"line":1444},19,[975,1446,1447],{"class":1030},"        destination",[975,1449,1034],{"class":981},[975,1451,1452],{"class":1049},"\"storage_carrier[4]\"",[975,1454,1327],{"class":985},[975,1456,1458],{"class":977,"line":1457},20,[975,1459,1460],{"class":985},"    )\n",[975,1462,1464,1466,1468,1470],{"class":977,"line":1463},21,[975,1465,1231],{"class":981},[975,1467,1234],{"class":985},[975,1469,1237],{"class":1049},[975,1471,1472],{"class":985},": lh}\n",[915,1474,1475,1476,1478],{},"The same decorator works on ",[948,1477,1284],{},":",[966,1480,1482],{"className":968,"code":1481,"language":970,"meta":971,"style":971},"from unitelabs.sdk.automate import step\n\n\n@step(\n    log_prints=True,\n    name=\"Fetch Instrument Data\",\n    retries=3,\n    retry_delay_seconds=10,\n)\nasync def fetch_instrument_data_task(endpoint: str) -> dict:\n    # Retried up to 3 times on any exception, with 10s between attempts\n    ...\n",[948,1483,1484,1495,1499,1503,1509,1519,1530,1541,1552,1556,1578,1583],{"__ignoreMap":971},[975,1485,1486,1488,1490,1492],{"class":977,"line":978},[975,1487,982],{"class":981},[975,1489,1000],{"class":985},[975,1491,989],{"class":981},[975,1493,1494],{"class":985}," step\n",[975,1496,1497],{"class":977,"line":995},[975,1498,1012],{"emptyLinePlaceholder":1011},[975,1500,1501],{"class":977,"line":1008},[975,1502,1012],{"emptyLinePlaceholder":1011},[975,1504,1505,1507],{"class":977,"line":1015},[975,1506,1284],{"class":1023},[975,1508,1315],{"class":985},[975,1510,1511,1513,1515,1517],{"class":977,"line":1020},[975,1512,1320],{"class":1030},[975,1514,1034],{"class":981},[975,1516,1038],{"class":1037},[975,1518,1327],{"class":985},[975,1520,1521,1523,1525,1528],{"class":977,"line":1056},[975,1522,1332],{"class":1030},[975,1524,1034],{"class":981},[975,1526,1527],{"class":1049},"\"Fetch Instrument Data\"",[975,1529,1327],{"class":985},[975,1531,1532,1534,1536,1539],{"class":977,"line":1077},[975,1533,1344],{"class":1030},[975,1535,1034],{"class":981},[975,1537,1538],{"class":1037},"3",[975,1540,1327],{"class":985},[975,1542,1543,1545,1547,1550],{"class":977,"line":1088},[975,1544,1356],{"class":1030},[975,1546,1034],{"class":981},[975,1548,1549],{"class":1037},"10",[975,1551,1327],{"class":985},[975,1553,1554],{"class":977,"line":1096},[975,1555,1053],{"class":985},[975,1557,1558,1560,1562,1565,1568,1571,1574,1576],{"class":977,"line":1138},[975,1559,1059],{"class":981},[975,1561,1062],{"class":981},[975,1563,1564],{"class":1023}," fetch_instrument_data_task",[975,1566,1567],{"class":985},"(endpoint: ",[975,1569,1570],{"class":1037},"str",[975,1572,1573],{"class":985},") -> ",[975,1575,1071],{"class":1037},[975,1577,1074],{"class":985},[975,1579,1580],{"class":977,"line":1172},[975,1581,1582],{"class":1183},"    # Retried up to 3 times on any exception, with 10s between attempts\n",[975,1584,1585],{"class":977,"line":1180},[975,1586,1587],{"class":1037},"    ...\n",[1589,1590,1593],"callout",{"color":1591,"icon":1592},"warning","i-heroicons-exclamation-triangle",[915,1594,1595,1596,1599],{},"Only retry operations that are ",[924,1597,1598],{},"safe to repeat",". Retrying a dispense that partially succeeded will double-dispense already-filled wells. Retrying a plate move when the plate was already moved will crash. When in doubt, use Pattern 3 instead: pause and let a human decide.",[943,1601,1603],{"id":1602},"pattern-3-pause-and-retry-hitl-recovery","Pattern 3 — Pause-and-retry (HITL recovery)",[915,1605,1606,1607,1610,1611,1614],{},"When a failure requires human intervention before retrying — not just waiting — combine ",[948,1608,1609],{},"try\u002Fexcept"," with ",[948,1612,1613],{},"pause_flow_run()",". The operator fixes the physical issue, clicks Resume, and the flow retries from that point.",[966,1616,1618],{"className":968,"code":1617,"language":970,"meta":971,"style":971},"from unitelabs.sdk import get_logger, pause_flow_run\nfrom unitelabs.sdk.automate import phase\n\n\nclass PlateNotDetectedError(Exception):\n    pass\n\n\n@phase(log_prints=True, name=\"Detection Phase with Recovery\")\nasync def detection_phase(lh, carrier_id: str) -> dict:\n    logger = get_logger()\n\n    try:\n        result = await detect_plate(lh=lh, carrier_id=carrier_id)\n        logger.info(f\"Plate detected at slot {result['slot']}.\")\n    except PlateNotDetectedError:\n        # 1. Log a clear, operator-readable message before pausing\n        logger.warning(\n            f\"No plate detected at {carrier_id} slot 1. \"\n            \"Check that the plate is fully seated, then click Resume.\"\n        )\n        # 2. Suspend the run — no resources held while waiting\n        await pause_flow_run()\n        # 3. On resume, retry detection (plate is now in position)\n        logger.info(\"Operator resumed — retrying detection.\")\n        result = await detect_plate(lh=lh, carrier_id=carrier_id)\n\n    return {\"lh\": lh, \"target_slot\": result[\"slot\"]}\n",[948,1619,1620,1631,1641,1645,1649,1665,1670,1674,1678,1701,1721,1729,1733,1739,1765,1795,1803,1808,1813,1830,1835,1840,1846,1855,1861,1871,1894,1899],{"__ignoreMap":971},[975,1621,1622,1624,1626,1628],{"class":977,"line":978},[975,1623,982],{"class":981},[975,1625,986],{"class":985},[975,1627,989],{"class":981},[975,1629,1630],{"class":985}," get_logger, pause_flow_run\n",[975,1632,1633,1635,1637,1639],{"class":977,"line":995},[975,1634,982],{"class":981},[975,1636,1000],{"class":985},[975,1638,989],{"class":981},[975,1640,1005],{"class":985},[975,1642,1643],{"class":977,"line":1008},[975,1644,1012],{"emptyLinePlaceholder":1011},[975,1646,1647],{"class":977,"line":1015},[975,1648,1012],{"emptyLinePlaceholder":1011},[975,1650,1651,1654,1657,1659,1662],{"class":977,"line":1020},[975,1652,1653],{"class":981},"class",[975,1655,1656],{"class":1030}," PlateNotDetectedError",[975,1658,1027],{"class":985},[975,1660,1661],{"class":1037},"Exception",[975,1663,1664],{"class":985},"):\n",[975,1666,1667],{"class":977,"line":1056},[975,1668,1669],{"class":981},"    pass\n",[975,1671,1672],{"class":977,"line":1077},[975,1673,1012],{"emptyLinePlaceholder":1011},[975,1675,1676],{"class":977,"line":1088},[975,1677,1012],{"emptyLinePlaceholder":1011},[975,1679,1680,1682,1684,1686,1688,1690,1692,1694,1696,1699],{"class":977,"line":1096},[975,1681,1024],{"class":1023},[975,1683,1027],{"class":985},[975,1685,1031],{"class":1030},[975,1687,1034],{"class":981},[975,1689,1038],{"class":1037},[975,1691,1041],{"class":985},[975,1693,1044],{"class":1030},[975,1695,1034],{"class":981},[975,1697,1698],{"class":1049},"\"Detection Phase with Recovery\"",[975,1700,1053],{"class":985},[975,1702,1703,1705,1707,1710,1713,1715,1717,1719],{"class":977,"line":1138},[975,1704,1059],{"class":981},[975,1706,1062],{"class":981},[975,1708,1709],{"class":1023}," detection_phase",[975,1711,1712],{"class":985},"(lh, carrier_id: ",[975,1714,1570],{"class":1037},[975,1716,1573],{"class":985},[975,1718,1071],{"class":1037},[975,1720,1074],{"class":985},[975,1722,1723,1725,1727],{"class":977,"line":1172},[975,1724,1080],{"class":985},[975,1726,1034],{"class":981},[975,1728,1085],{"class":985},[975,1730,1731],{"class":977,"line":1180},[975,1732,1012],{"emptyLinePlaceholder":1011},[975,1734,1735,1737],{"class":977,"line":1187},[975,1736,1091],{"class":981},[975,1738,1074],{"class":985},[975,1740,1741,1744,1746,1748,1751,1753,1755,1757,1760,1762],{"class":977,"line":1193},[975,1742,1743],{"class":985},"        result ",[975,1745,1034],{"class":981},[975,1747,1104],{"class":981},[975,1749,1750],{"class":985}," detect_plate(",[975,1752,1110],{"class":1030},[975,1754,1034],{"class":981},[975,1756,1115],{"class":985},[975,1758,1759],{"class":1030},"carrier_id",[975,1761,1034],{"class":981},[975,1763,1764],{"class":985},"carrier_id)\n",[975,1766,1767,1769,1772,1775,1778,1781,1784,1787,1790,1793],{"class":977,"line":1212},[975,1768,1215],{"class":985},[975,1770,1771],{"class":981},"f",[975,1773,1774],{"class":1049},"\"Plate detected at slot ",[975,1776,1777],{"class":981},"{",[975,1779,1780],{"class":985},"result[",[975,1782,1783],{"class":1049},"'slot'",[975,1785,1786],{"class":985},"]",[975,1788,1789],{"class":981},"}",[975,1791,1792],{"class":1049},".\"",[975,1794,1053],{"class":985},[975,1796,1797,1800],{"class":977,"line":1223},[975,1798,1799],{"class":981},"    except",[975,1801,1802],{"class":985}," PlateNotDetectedError:\n",[975,1804,1805],{"class":977,"line":1228},[975,1806,1807],{"class":1183},"        # 1. Log a clear, operator-readable message before pausing\n",[975,1809,1810],{"class":977,"line":1431},[975,1811,1812],{"class":985},"        logger.warning(\n",[975,1814,1815,1818,1821,1823,1825,1827],{"class":977,"line":1444},[975,1816,1817],{"class":981},"            f",[975,1819,1820],{"class":1049},"\"No plate detected at ",[975,1822,1777],{"class":981},[975,1824,1759],{"class":985},[975,1826,1789],{"class":981},[975,1828,1829],{"class":1049}," slot 1. \"\n",[975,1831,1832],{"class":977,"line":1457},[975,1833,1834],{"class":1049},"            \"Check that the plate is fully seated, then click Resume.\"\n",[975,1836,1837],{"class":977,"line":1463},[975,1838,1839],{"class":985},"        )\n",[975,1841,1843],{"class":977,"line":1842},22,[975,1844,1845],{"class":1183},"        # 2. Suspend the run — no resources held while waiting\n",[975,1847,1849,1852],{"class":977,"line":1848},23,[975,1850,1851],{"class":981},"        await",[975,1853,1854],{"class":985}," pause_flow_run()\n",[975,1856,1858],{"class":977,"line":1857},24,[975,1859,1860],{"class":1183},"        # 3. On resume, retry detection (plate is now in position)\n",[975,1862,1864,1866,1869],{"class":977,"line":1863},25,[975,1865,1215],{"class":985},[975,1867,1868],{"class":1049},"\"Operator resumed — retrying detection.\"",[975,1870,1053],{"class":985},[975,1872,1874,1876,1878,1880,1882,1884,1886,1888,1890,1892],{"class":977,"line":1873},26,[975,1875,1743],{"class":985},[975,1877,1034],{"class":981},[975,1879,1104],{"class":981},[975,1881,1750],{"class":985},[975,1883,1110],{"class":1030},[975,1885,1034],{"class":981},[975,1887,1115],{"class":985},[975,1889,1759],{"class":1030},[975,1891,1034],{"class":981},[975,1893,1764],{"class":985},[975,1895,1897],{"class":977,"line":1896},27,[975,1898,1012],{"emptyLinePlaceholder":1011},[975,1900,1902,1904,1906,1908,1910,1913,1916,1919],{"class":977,"line":1901},28,[975,1903,1231],{"class":981},[975,1905,1234],{"class":985},[975,1907,1237],{"class":1049},[975,1909,1240],{"class":985},[975,1911,1912],{"class":1049},"\"target_slot\"",[975,1914,1915],{"class":985},": result[",[975,1917,1918],{"class":1049},"\"slot\"",[975,1920,1921],{"class":985},"]}\n",[915,1923,1924,1925,1928,1929,1932,1933,1935],{},"The run stays ",[948,1926,1927],{},"PAUSED"," until the operator acts. They can resume from the platform's run view or ",[935,1930,1931],{"href":137},"via the API",". See ",[935,1934,136],{"href":137}," for more on the pause mechanism.",[943,1937,1939],{"id":1938},"pattern-4-phase-tracking-for-partial-recovery","Pattern 4 — Phase tracking for partial recovery",[915,1941,1942],{},"Track which phases completed successfully in a list. Include it in every return value — success and error alike. This tells you exactly where a run failed, which phases are safe to skip on a re-run, and what to report to a LIMS.",[966,1944,1946],{"className":968,"code":1945,"language":970,"meta":971,"style":971},"from unitelabs.sdk import get_logger\nfrom unitelabs.sdk.automate import workflow\n\n\n@workflow(log_prints=True, name=\"Full Workflow\")\nasync def full_workflow(lh) -> dict:\n    logger = get_logger()\n    phases_completed: list[str] = []\n\n    # Phase 01\n    lh = await initialization_phase(lh=lh)\n    phases_completed.append(\"01_initialization\")\n\n    # Phase 02\n    result = await detection_phase(lh=lh)\n    lh = result[\"lh\"]\n    phases_completed.append(\"02_detection\")\n\n    # Phase 03 — dispensing can fail mid-run\n    try:\n        lh = await dispensing_phase(lh=lh)\n        phases_completed.append(\"03_dispensing\")\n    except Exception as e:\n        logger.error(f\"Dispensing failed: {e}\")\n        return {\n            \"status\": \"error\",\n            \"failed_phase\": \"03_dispensing\",\n            \"phases_completed\": phases_completed,\n            \"message\": str(e),\n        }\n\n    phases_completed.append(\"04_finalization\")\n    return {\"status\": \"success\", \"phases_completed\": phases_completed}\n",[948,1947,1948,1958,1969,1973,1977,2001,2016,2024,2039,2043,2048,2065,2075,2079,2084,2102,2116,2125,2129,2134,2140,2157,2167,2180,2202,2210,2222,2233,2241,2254,2260,2265,2275],{"__ignoreMap":971},[975,1949,1950,1952,1954,1956],{"class":977,"line":978},[975,1951,982],{"class":981},[975,1953,986],{"class":985},[975,1955,989],{"class":981},[975,1957,992],{"class":985},[975,1959,1960,1962,1964,1966],{"class":977,"line":995},[975,1961,982],{"class":981},[975,1963,1000],{"class":985},[975,1965,989],{"class":981},[975,1967,1968],{"class":985}," workflow\n",[975,1970,1971],{"class":977,"line":1008},[975,1972,1012],{"emptyLinePlaceholder":1011},[975,1974,1975],{"class":977,"line":1015},[975,1976,1012],{"emptyLinePlaceholder":1011},[975,1978,1979,1982,1984,1986,1988,1990,1992,1994,1996,1999],{"class":977,"line":1020},[975,1980,1981],{"class":1023},"@workflow",[975,1983,1027],{"class":985},[975,1985,1031],{"class":1030},[975,1987,1034],{"class":981},[975,1989,1038],{"class":1037},[975,1991,1041],{"class":985},[975,1993,1044],{"class":1030},[975,1995,1034],{"class":981},[975,1997,1998],{"class":1049},"\"Full Workflow\"",[975,2000,1053],{"class":985},[975,2002,2003,2005,2007,2010,2012,2014],{"class":977,"line":1056},[975,2004,1059],{"class":981},[975,2006,1062],{"class":981},[975,2008,2009],{"class":1023}," full_workflow",[975,2011,1068],{"class":985},[975,2013,1071],{"class":1037},[975,2015,1074],{"class":985},[975,2017,2018,2020,2022],{"class":977,"line":1077},[975,2019,1080],{"class":985},[975,2021,1034],{"class":981},[975,2023,1085],{"class":985},[975,2025,2026,2029,2031,2034,2036],{"class":977,"line":1088},[975,2027,2028],{"class":985},"    phases_completed: list[",[975,2030,1570],{"class":1037},[975,2032,2033],{"class":985},"] ",[975,2035,1034],{"class":981},[975,2037,2038],{"class":985}," []\n",[975,2040,2041],{"class":977,"line":1096},[975,2042,1012],{"emptyLinePlaceholder":1011},[975,2044,2045],{"class":977,"line":1138},[975,2046,2047],{"class":1183},"    # Phase 01\n",[975,2049,2050,2052,2054,2056,2059,2061,2063],{"class":977,"line":1172},[975,2051,1411],{"class":985},[975,2053,1034],{"class":981},[975,2055,1104],{"class":981},[975,2057,2058],{"class":985}," initialization_phase(",[975,2060,1110],{"class":1030},[975,2062,1034],{"class":981},[975,2064,1209],{"class":985},[975,2066,2067,2070,2073],{"class":977,"line":1180},[975,2068,2069],{"class":985},"    phases_completed.append(",[975,2071,2072],{"class":1049},"\"01_initialization\"",[975,2074,1053],{"class":985},[975,2076,2077],{"class":977,"line":1187},[975,2078,1012],{"emptyLinePlaceholder":1011},[975,2080,2081],{"class":977,"line":1193},[975,2082,2083],{"class":1183},"    # Phase 02\n",[975,2085,2086,2089,2091,2093,2096,2098,2100],{"class":977,"line":1212},[975,2087,2088],{"class":985},"    result ",[975,2090,1034],{"class":981},[975,2092,1104],{"class":981},[975,2094,2095],{"class":985}," detection_phase(",[975,2097,1110],{"class":1030},[975,2099,1034],{"class":981},[975,2101,1209],{"class":985},[975,2103,2104,2106,2108,2111,2113],{"class":977,"line":1223},[975,2105,1411],{"class":985},[975,2107,1034],{"class":981},[975,2109,2110],{"class":985}," result[",[975,2112,1237],{"class":1049},[975,2114,2115],{"class":985},"]\n",[975,2117,2118,2120,2123],{"class":977,"line":1228},[975,2119,2069],{"class":985},[975,2121,2122],{"class":1049},"\"02_detection\"",[975,2124,1053],{"class":985},[975,2126,2127],{"class":977,"line":1431},[975,2128,1012],{"emptyLinePlaceholder":1011},[975,2130,2131],{"class":977,"line":1444},[975,2132,2133],{"class":1183},"    # Phase 03 — dispensing can fail mid-run\n",[975,2135,2136,2138],{"class":977,"line":1457},[975,2137,1091],{"class":981},[975,2139,1074],{"class":985},[975,2141,2142,2144,2146,2148,2151,2153,2155],{"class":977,"line":1463},[975,2143,1099],{"class":985},[975,2145,1034],{"class":981},[975,2147,1104],{"class":981},[975,2149,2150],{"class":985}," dispensing_phase(",[975,2152,1110],{"class":1030},[975,2154,1034],{"class":981},[975,2156,1209],{"class":985},[975,2158,2159,2162,2165],{"class":977,"line":1842},[975,2160,2161],{"class":985},"        phases_completed.append(",[975,2163,2164],{"class":1049},"\"03_dispensing\"",[975,2166,1053],{"class":985},[975,2168,2169,2171,2174,2177],{"class":977,"line":1848},[975,2170,1799],{"class":981},[975,2172,2173],{"class":1037}," Exception",[975,2175,2176],{"class":981}," as",[975,2178,2179],{"class":985}," e:\n",[975,2181,2182,2185,2187,2190,2192,2195,2197,2200],{"class":977,"line":1857},[975,2183,2184],{"class":985},"        logger.error(",[975,2186,1771],{"class":981},[975,2188,2189],{"class":1049},"\"Dispensing failed: ",[975,2191,1777],{"class":981},[975,2193,2194],{"class":985},"e",[975,2196,1789],{"class":981},[975,2198,2199],{"class":1049},"\"",[975,2201,1053],{"class":985},[975,2203,2204,2207],{"class":977,"line":1863},[975,2205,2206],{"class":981},"        return",[975,2208,2209],{"class":985}," {\n",[975,2211,2212,2215,2217,2220],{"class":977,"line":1873},[975,2213,2214],{"class":1049},"            \"status\"",[975,2216,1246],{"class":985},[975,2218,2219],{"class":1049},"\"error\"",[975,2221,1327],{"class":985},[975,2223,2224,2227,2229,2231],{"class":977,"line":1896},[975,2225,2226],{"class":1049},"            \"failed_phase\"",[975,2228,1246],{"class":985},[975,2230,2164],{"class":1049},[975,2232,1327],{"class":985},[975,2234,2235,2238],{"class":977,"line":1901},[975,2236,2237],{"class":1049},"            \"phases_completed\"",[975,2239,2240],{"class":985},": phases_completed,\n",[975,2242,2244,2247,2249,2251],{"class":977,"line":2243},29,[975,2245,2246],{"class":1049},"            \"message\"",[975,2248,1246],{"class":985},[975,2250,1570],{"class":1037},[975,2252,2253],{"class":985},"(e),\n",[975,2255,2257],{"class":977,"line":2256},30,[975,2258,2259],{"class":985},"        }\n",[975,2261,2263],{"class":977,"line":2262},31,[975,2264,1012],{"emptyLinePlaceholder":1011},[975,2266,2268,2270,2273],{"class":977,"line":2267},32,[975,2269,2069],{"class":985},[975,2271,2272],{"class":1049},"\"04_finalization\"",[975,2274,1053],{"class":985},[975,2276,2278,2280,2282,2284,2286,2288,2290,2293],{"class":977,"line":2277},33,[975,2279,1231],{"class":981},[975,2281,1234],{"class":985},[975,2283,1243],{"class":1049},[975,2285,1246],{"class":985},[975,2287,1249],{"class":1049},[975,2289,1041],{"class":985},[975,2291,2292],{"class":1049},"\"phases_completed\"",[975,2294,2295],{"class":985},": phases_completed}\n",[915,2297,2298,2299,2302],{},"Knowing ",[948,2300,2301],{},"phases_completed = [\"01_initialization\", \"02_detection\"]"," means Phase 03 was the one that failed, Phases 01 and 02 do not need to be repeated, and the instrument state after Phase 02 is the starting point for a manual recovery.",[940,2304],{},[943,2306,2308],{"id":2307},"graceful-vs-fail-fast","Graceful vs fail-fast",[915,2310,2311],{},"For workflows triggered by external systems (a UI, a webhook, a scheduler), the response format matters:",[2313,2314,2315,2331],"table",{},[2316,2317,2318],"thead",{},[2319,2320,2321,2325,2328],"tr",{},[2322,2323,2324],"th",{},"Pattern",[2322,2326,2327],{},"Run status",[2322,2329,2330],{},"Use when",[2332,2333,2334,2350],"tbody",{},[2319,2335,2336,2342,2347],{},[2337,2338,2339,2341],"td",{},[948,2340,1609],{}," → return error dict",[2337,2343,2344],{},[948,2345,2346],{},"Completed",[2337,2348,2349],{},"Caller expects a structured response",[2319,2351,2352,2355,2360],{},[2337,2353,2354],{},"Let exception propagate",[2337,2356,2357],{},[948,2358,2359],{},"Failed",[2337,2361,2362],{},"You want failure alerts and on-call paging",[966,2364,2366],{"className":968,"code":2365,"language":970,"meta":971,"style":971},"# Graceful — caller sees {\"status\": \"error\", ...} instead of an exception\n@workflow(log_prints=True, name=\"Graceful Flow\")\nasync def graceful_flow(source: str) -> dict:\n    try:\n        result = await process(source=source)\n        return {\"status\": \"success\", **result}\n    except ValueError as e:\n        return {\"status\": \"error\", \"message\": str(e)}\n",[948,2367,2368,2373,2396,2416,2422,2441,2461,2472],{"__ignoreMap":971},[975,2369,2370],{"class":977,"line":978},[975,2371,2372],{"class":1183},"# Graceful — caller sees {\"status\": \"error\", ...} instead of an exception\n",[975,2374,2375,2377,2379,2381,2383,2385,2387,2389,2391,2394],{"class":977,"line":995},[975,2376,1981],{"class":1023},[975,2378,1027],{"class":985},[975,2380,1031],{"class":1030},[975,2382,1034],{"class":981},[975,2384,1038],{"class":1037},[975,2386,1041],{"class":985},[975,2388,1044],{"class":1030},[975,2390,1034],{"class":981},[975,2392,2393],{"class":1049},"\"Graceful Flow\"",[975,2395,1053],{"class":985},[975,2397,2398,2400,2402,2405,2408,2410,2412,2414],{"class":977,"line":1008},[975,2399,1059],{"class":981},[975,2401,1062],{"class":981},[975,2403,2404],{"class":1023}," graceful_flow",[975,2406,2407],{"class":985},"(source: ",[975,2409,1570],{"class":1037},[975,2411,1573],{"class":985},[975,2413,1071],{"class":1037},[975,2415,1074],{"class":985},[975,2417,2418,2420],{"class":977,"line":1015},[975,2419,1091],{"class":981},[975,2421,1074],{"class":985},[975,2423,2424,2426,2428,2430,2433,2436,2438],{"class":977,"line":1020},[975,2425,1743],{"class":985},[975,2427,1034],{"class":981},[975,2429,1104],{"class":981},[975,2431,2432],{"class":985}," process(",[975,2434,2435],{"class":1030},"source",[975,2437,1034],{"class":981},[975,2439,2440],{"class":985},"source)\n",[975,2442,2443,2445,2447,2449,2451,2453,2455,2458],{"class":977,"line":1056},[975,2444,2206],{"class":981},[975,2446,1234],{"class":985},[975,2448,1243],{"class":1049},[975,2450,1246],{"class":985},[975,2452,1249],{"class":1049},[975,2454,1041],{"class":985},[975,2456,2457],{"class":981},"**",[975,2459,2460],{"class":985},"result}\n",[975,2462,2463,2465,2468,2470],{"class":977,"line":1077},[975,2464,1799],{"class":981},[975,2466,2467],{"class":1037}," ValueError",[975,2469,2176],{"class":981},[975,2471,2179],{"class":985},[975,2473,2474,2476,2478,2480,2482,2484,2486,2489,2491,2493],{"class":977,"line":1088},[975,2475,2206],{"class":981},[975,2477,1234],{"class":985},[975,2479,1243],{"class":1049},[975,2481,1246],{"class":985},[975,2483,2219],{"class":1049},[975,2485,1041],{"class":985},[975,2487,2488],{"class":1049},"\"message\"",[975,2490,1246],{"class":985},[975,2492,1570],{"class":1037},[975,2494,2495],{"class":985},"(e)}\n",[915,2497,2498,2499,2501],{},"For a deeper treatment of structured error types and error codes, see ",[935,2500,156],{"href":157},".",[943,2503,2505],{"id":2504},"next-steps","Next steps",[928,2507,2508,2515],{},[931,2509,2510,1246,2512,2514],{},[935,2511,136],{"href":137},[948,2513,1613],{}," in depth",[931,2516,2517,2519],{},[935,2518,156],{"href":157},": typed error taxonomy with user-facing messages and error codes",[2521,2522,2523],"style",{},"html pre.shiki code .sxkbv, html code.shiki .sxkbv{--shiki-light:#A0111F;--shiki-default:#A0111F;--shiki-dark:#FF7B72}html pre.shiki code .sc-9e, html code.shiki .sc-9e{--shiki-light:#0E1116;--shiki-default:#0E1116;--shiki-dark:#E6EDF3}html pre.shiki code .s4qFZ, html code.shiki .s4qFZ{--shiki-light:#622CBC;--shiki-default:#622CBC;--shiki-dark:#D2A8FF}html pre.shiki code .sNqAu, html code.shiki .sNqAu{--shiki-light:#702C00;--shiki-default:#702C00;--shiki-dark:#FFA657}html pre.shiki code .sOiAX, html code.shiki .sOiAX{--shiki-light:#023B95;--shiki-default:#023B95;--shiki-dark:#79C0FF}html pre.shiki code .sCx38, html code.shiki .sCx38{--shiki-light:#032563;--shiki-default:#032563;--shiki-dark:#A5D6FF}html pre.shiki code .sIsDC, html code.shiki .sIsDC{--shiki-light:#66707B;--shiki-default:#66707B;--shiki-dark:#8B949E}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"title":971,"searchDepth":978,"depth":995,"links":2525},[2526,2528,2529,2530,2531,2532],{"id":945,"depth":995,"text":2527},"Pattern 1 — Guaranteed cleanup with try\u002Ffinally",{"id":1266,"depth":995,"text":1267},{"id":1602,"depth":995,"text":1603},{"id":1938,"depth":995,"text":1939},{"id":2307,"depth":995,"text":2308},{"id":2504,"depth":995,"text":2505},"Clean up hardware state, retry transient failures, and resume after operator intervention.","md",{},"\u002Fhow-to\u002Fautomate\u002Fbasic-error-handling",{"title":152,"description":2533},"OY0IF1pU6ITY-tNeur_Nd782_Jg6YjkqecRtKHIg2zw",[2540,2542],{"title":148,"description":2541,"path":149},"Hold a running workflow at its next step boundary so an operator can intervene, then continue from that point.",{"title":156,"description":2543,"path":157},"Build a structured error taxonomy with typed error codes, user-facing messages, and automatic exception classification.",1791294170876]