OT-2 Python API版本1¶
Opentrons API是一个简单的Python框架，旨在使编写自动化的生物实验室协议变得容易。
我们以一种我们希望拥有基本Python和wetlab技能的人都能理解的方式来设计它。作为一名实验室科学家，你应该能够以一种读起来像实验室笔记本的方式编写你的自动协议。
开始¶
新到Python吗?看看我们协议中使用Python在继续之前先翻一页。要了解脚本的典型结构，请查看我们的例子页面。
我们的API需要Python 3.7.6或更高版本。一旦在你的电脑上设置好，你就可以简单地使用皮普安装Opentrons包。
皮普安装opentrons
故障排除¶
如果您在使用我们的产品时遇到问题，请查看我们的产品支持文档或通过我们网站上的对讲机联系我们的团队www.panhunting.com。
概述¶
它看起来如何¶
Opentrons API的设计目标是使代码易于阅读和理解。例如，下面是一个简短的指令集从井转移“A1”到好“B1”连电脑都能理解
使用Opentrons API的实验设备和仪器叫做Opentrons协议教程和用于展示Opentrons API添加96板,并将其放在槽' 2 '机器人的甲板上添加一个200 ul提示架,并将其放在槽' 1 '机器人的甲板上添加一个单通道300 ul吸管离开了山,并告诉它使用提示架转移100 ul板是“A1”以及“B2”
如果我们用Opentrons API重写它，它会像下面这样:
#进口从opentrons进口实验室的器具,仪器#元数据元数据={“protocolName”:“我的协议”,“作者”:的名字< email@address.com > ',“描述”:'简单的协议开始使用OT2',}#实验室的器具板=实验室的器具。负载(“96 -平”,' 2 ')tiprack=实验室的器具。负载(“opentrons_96_tiprack_300ul”,' 1 ')#吸量管吸管=仪器。P300_Single(山=“左”,tip_racks=(tiprack])#命令吸管。转移(One hundred.,板。井(“A1”),板。井(“B2”))
它是如何组织的¶
当使用Opentrons API编写协议时，通常有五个部分:
进口¶
用Python编写时，必须始终在文件中包含Opentrons API。我们最常用的是实验室的器具和仪器API的部分。
从上面的例子中，“imports”部分是这样的:
从opentrons进口实验室的器具,仪器
元数据¶
元数据是一个由服务器读取并返回给客户端应用程序(如Opentrons应用程序)的数据字典。它不需要运行协议(并且是完全可选的)，但是如果有的话可以帮助客户端应用程序显示关于当前正在执行的协议的额外数据。
上面的字段(“protocolName”，“author”和“description”)是推荐的字段，但是元数据字典可以根据需要包含更少或更多的字段(尽管非标准字段可能不会被客户端呈现，这取决于它是如何设计的)。
您可能会在直接从Opentrons下载的协议中看到一个名为“source”的元数据字段。“source”字段用于匿名跟踪协议使用情况，如果您在Opentrons应用程序中选择进入分析。例如，Opentrons协议库中的协议可以将“source”设置为“Opentrons协议库”。您不应该在自己的协议中定义“源”。
实验室的器具¶
虽然导入部分通常是相同的协议，实验室部分是不同的取决于尖端架，井板，槽，或管道，你在机器人上使用。
每个实验器具都有一个类型(例如:“96 -平”)，它将被放置在机器人上的槽位上(例如:' 2 ')。
从上面的例子中，“labware”部分是这样的:
板=实验室的器具。负载(“96 -平”,' 2 ')tiprack=实验室的器具。负载(“opentrons_96_tiprack_300ul”,' 1 ')
吸量管¶
接下来，创建移液管，并连接到OT-2上的特定安装(“左”或“对”)。
移液器还有其他参数，但最重要的是它在实验过程中使用的尖端架。
从上面的例子中，“移液管”部分是这样的:
吸管=仪器。P300_Single(山=“左”,tip_racks=(tiprack])
命令¶
最后，最有趣的部分，实际的协议命令!最常见的命令是转移(),抽出物(),分发(),pick_up_tip (),drop_tip ()，以及更多。
相对于您的协议的复杂性，这一节可能会比较长。但是，通过更好地理解Python，您可以学习压缩和简化看起来最复杂的协议。
从上面的例子中，“commands”部分是这样的:
吸管。转移(One hundred.,板。井(“A1”),板。井(“B1”))
