Skip to content

Absorbance Plate Reader

AbsorbanceReaderContext

An object representing a connected Absorbance Plate Reader Module.

It should not be instantiated directly; instead, it should be created through ProtocolContext.load_module().

New in version 2.21

close_lid v2.21 

close_lid()

Use the Flex Gripper to close the lid of the Absorbance Plate Reader.

You must call this method before initializing the reader, even if the reader was in the closed position at the start of the protocol.

initialize v2.21 

initialize(mode, wavelengths, reference_wavelength=None)

Prepare the Absorbance Plate Reader to read a plate.

See Initialization for examples.

Parameters:

  • mode (ABSMeasureMode) –

    Either "single" or "multi".

    • In single measurement mode, read() uses one sample wavelength and an optional reference wavelength.
    • In multiple measurement mode, read() uses a list of up to six sample wavelengths.
  • wavelengths (List[int]) –

    A list of wavelengths, in nm, to measure.

    • In the default hardware configuration, each wavelength must be one of 450 (blue), 562 (green), 600 (orange), or 650 (red). In custom hardware configurations, the module may accept other integers between 350 and 1000.
    • The list must contain only one item when initializing a single measurement.
    • The list can contain one to six items when initializing a multiple measurement. reference_wavelength: An optional reference wavelength, in nm. If provided, read() will read at the reference wavelength and then subtract the reference wavelength values from the measurement wavelength values. Can only be used with single measurements.

is_lid_on v2.21 

is_lid_on()

Return True if the Absorbance Plate Reader's lid is currently closed.

labware property v2.0 

labware

The labware (if any) present on this module.

load_labware 

load_labware(name, label=None, namespace=None, version=None, adapter=None, lid=None, *, adapter_namespace=None, adapter_version=None, lid_namespace=None, lid_version=None)

Load a labware onto the module using its load parameters.

The parameters of this function behave like those of load_labware() (which loads labware directly onto the deck). Note that the parameter name here corresponds to load_name on the ProtocolContext function.

Returns:

  • Labware –

    The initialized and loaded labware object.

New in version 2.1: The label, namespace, and version parameters.

New in version 2.26: The adapter_namespace, adapter_version, lid_namespace, and lid_version parameters.

load_labware_by_name v2.1 

load_labware_by_name(name, label=None, namespace=None, version=None)

Deprecated in version 2.0: Use load_labware instead.

load_labware_from_definition v2.0 

load_labware_from_definition(definition, label=None)

Load a labware onto the module using an inline definition.

Parameters:

  • definition (LabwareDefinition) –

    The labware definition.

  • label (str, default: None ) –

    An optional special name to give the labware. If specified, this is the name the labware will appear as in the run log and the calibration view in the Opentrons app.

Returns:

  • Labware –

    The initialized and loaded labware object.

model property v2.14 

model

Get the module's model identifier.

open_lid v2.21 

open_lid()

Use the Flex Gripper to open the lid of the Absorbance Plate Reader.

parent property v2.14 

parent

The name of the slot the module is on.

On a Flex, this will be like "D1". On an OT-2, this will be like "1". See Deck Slots.

read v2.21 

read(export_filename=None)

Read a plate on the Absorbance Plate Reader.

This method always returns a dictionary of measurement data. It optionally will save a CSV file of the results to the Flex filesystem, which you can access from the Recent Protocol Runs screen in the Opentrons App. These files are only saved if you specify export_filename.

In simulation, the values for each well key in the dictionary are set to zero, and no files are written.

Note

Avoid divide-by-zero errors when simulating and using the results of this method later in the protocol. If you divide by any of the measurement values, use is_simulating() to use alternate dummy data or skip the division step.

Parameters:

  • export_filename (Optional[str], default: None ) –

    An optional file basename. If provided, this method will write a CSV file for each measurement in the read operation. File names will use the value of this parameter, the measurement wavelength supplied in initialize(), and a .csv extension. For example, when reading at wavelengths 450 and 562 with export_filename="my_data", there will be two output files: my_data_450.csv and my_data_562.csv.

    See CSV Data for information on working with these CSV files.

Returns:

  • Dict[int, Dict[str, float]] –

    A dictionary of wavelengths to dictionary of values ordered by well name.

serial_number property v2.21 

serial_number

Get the module's unique hardware serial number.

type property v2.14 

type

Get the module's general type identifier.