The instruments module gives your protocol access to the pipette constructors, which is what you will be primarily using to create protocol commands.


Creating a Pipette

'''
Examples in this section require the following:
'''
from opentrons import instruments, robot

Pipette Model(s)

Currently in our API there are 7 pipette models to correspond with the offered pipette models on our website.

They are as follows: P10_Single (1 - 10 ul) P10_Multi (1 - 10ul) P50_Single (5 - 50ul) P50_Multi (5 - 50ul) P300_Single (30 - 300ul) P300_Mutli (30 - 300ul) P1000_Single (100 - 1000ul)

For every pipette type you are using in a protocol, you must use one of the model names specified above and call it out as instruments.(Model Name)

Mount

To create a pipette object, you must give it a mount. The mount can be either 'left' or 'right'. In this example, we are using a Single-Channel 300uL pipette.

pipette = instruments.P300_Single(mount='left')

Plunger Flow Rates

The speeds at which the pipette will aspirate and dispense can be set through aspirate_speed and dispense_speed. The values are in microliters/seconds, and have varying defaults depending on the model.

pipette = instruments.P300_Single(
    mount='right',
    aspirate_flow_rate=200,
    dispense_flow_rate=600)

Minimum and Maximum Volume

The minimum and maximum volume of the pipette may be set using min_volume and max_volume. The values are in microliters and have varying defaults depending on the model.

pipette = instruments.P10_Single(
    mount='right',
    min_volume=2,
    max_volume=8)

The given defaults for every pipette model is the following:

P10_Single

  • Aspirate Default: 5 μl/s
  • Dispense Default: 10 μl/s
  • Minimum Volume: 1 μl
  • Maximum Volume: 10 μl

P10_Multi

  • Aspirate Default: 5 μl/s
  • Dispense Default: 10 μl/s
  • Minimum Volume: 1 μl
  • Maximum Volume: 10 μl

P50_Single

  • Aspirate Default: 25 μl/s
  • Dispense Default: 50 μl/s
  • Minimum Volume: 5 μl
  • Maximum Volume: 50 μl

P50_Multi

  • Aspirate Default: 25 μl/s
  • Dispense Default: 50 μl/s
  • Minimum Volume: 5 μl
  • Maximum Volume: 50 μl

P300_Single

  • Aspirate Default: 150 μl/s
  • Dispense Default: 300 μl/s
  • Minimum Volume: 30 μl
  • Maximum Volume: 300 μl

P300_Multi

  • Aspirate Default: 150 μl/s
  • Dispense Default: 300 μl/s
  • Minimum Volume: 30 μl
  • Maximum Volume: 300 μl

P1000_Single

  • Aspirate Default: 500 μl/s
  • Dispense Default: 1000 μl/s
  • Minimum Volume: 100 μl
  • Maximum Volume: 1000 μl

Old Pipette Constructor

The Pipette constructor that was used directly in OT-One protocols is now an internal-only class. Its behavior is difficult to predict when not used through the public constructors mentioned above. Pipette constructor arguments are subject to change of their default values, behaviors, and parameters may be added or removed without warning or a major version increment.