ecl-logo Documentation

AbsorbanceSpectroscopy

AbsorbanceSpectroscopy[options]unitOperation

measures the absorbance spectroscopy data of the input samples.

    
Absorbance spectroscopy studies how much ultraviolet and visible light radiation the sample absorbs and transmits. Samples are exposed to light at a range of wavelengths, and the absorbance is measured by determining how much light at is transmitted through the sample across all these wavelengths. Because the absorbance of a substance at a given wavelength is directly proportional to its concentration, this experiment can be used to quantify how much of a substance is present in a given sample.
    

Experimental Principles

    Figure 1.1: Procedural overview of an AbsorbanceSpectroscopy experiment using a Lunatic plate reader. Step 1: Microfluidic chips are loaded with sample. Step 2: Samples are pumped into the large (1st) and small (2nd) cuvettes along the microfluidic flow path. Step 3: The absorbance spectrum is collected for each of the samples, using either the larger or smaller of the cuvettes depending on how strong the absorbance is. Step 4 (optional): The concentration of the samples is determined using the Beer-Lambert Law.
    Figure 1.2: Procedural overview of an AbsorbanceSpectroscopy experiment using the PHERAstar FS, FLUOstar Omega, or CLARIOstar plate readers. Step 1: Plate is loaded with sample. Step 2: The volume of each sample is measured ultrasonically to calculate path length. Step 3: The absorbance spectrum is collected for each of the samples. Step 4 (optional): The concentration of the samples is determined using the Beer-Lambert Law.

Instrumentation

    Lunatic

    Figure 2.1.1: In the Lunatic, a Xenon Flash Lamp sends photons through the large and small cuvettes of each microfluidic chip. The light that is not absorbed is then directed through a prism which splits the beam into wavelengths from 230 nm to 750 nm that are measured by the detector.

    CLARIOstar

    Figure 2.2.1: In the CLARIOstar, a Xenon Flash Lamp sends photons through each well of the plate. The light that is not absorbed is then directed through a prism which splits the beam into wavelengths from 220 nm to 1000 nm that are measured by the detector. The plate chamber can be heated up to 45°C and it can mix the plate at up to 700 RPM before the run. The reader has two 300μL syringe pump injectors which can be used for 0.5 - 300 μL injections of two unique samples prior to the run.

    FLUOstar Omega

    Figure 2.3.1: In the Omega, a Xenon Flash Lamp sends photons through each well of the plate. The light that is not absorbed is then directed through a prism which splits the beam into wavelengths from 220 nm to 1000 nm that are measured by the detector. The plate chamber can be heated up to 45°C and it can mix the plate at up to 700 RPM before the run. The reader has two 300μL syringe pump injectors which can be used for 0.5 - 300 μL injections of two unique samples prior to the run.

    PHERAstar FS

    Figure 2.4.1: In the PHERAstar, a Xenon Flash Lamp sends photons through each well of the plate. The light that is not absorbed is then directed through a prism which splits the beam into wavelengths from 220 nm to 1000 nm that are measured by the detector. The plate chamber can be heated up to 45°C and it can mix the plate at up to 700 RPM before the run. The reader has two 300μL syringe pump injectors which can be used for 0.5 - 300 μL injections of two unique samples prior to the run.

Experiment Options

    General

    Sample

    The samples that will be measured by the plate reader instrument.
    Default Value: Null
    Pattern: (ObjectP[{Object[Sample], Object[Container]}] | _String) | Null
    Index Matches to: Sample

    BlankLabel

    The label of the blank sample being used.
    Default Value: Automatic
    Pattern: ((Null | _String) | Automatic) | Null
    Index Matches to: Sample

    Instrument

    The plate reader used for this absorbance experiment.
    Default Value: Automatic
    Default Calculation: Automatically resolves to Model[Instrument, PlateReader, "FLUOstar Omega"] if Temperature, EquilibrationTime, or any of the PlateReaderMix options are specified, or Model[Instrument, PlateReader, "Lunatic"] otherwise.
    Pattern: ObjectP[{Model[Instrument, PlateReader], Object[Instrument, PlateReader]}] | Automatic

    Preparation

    Indicates if this unit operation is carried out primarily robotically or manually. Manual unit operations are executed by a laboratory operator and robotic unit operations are executed by a liquid handling work cell.
    Default Value: Automatic
    Pattern: PreparationMethodP | Automatic

    WorkCell

    Indicates the work cell that this primitive will be run on if Preparation->Robotic.
    Default Value: Automatic
    Default Calculation: Automatically set to STAR if Preparation->Robotic.
    Pattern: (WorkCellP | Automatic) | Null

    NumberOfReplicates

    The number of times to repeat absorbance reading on each provided sample. If Aliquot -> True, this also indicates the number of times each provided sample will be aliquoted. Note that when using the Lunatic, this indicates the number of independent times a 2 uL aliquot will be put into the Lunatic chips and read, and when using the BMG plate readers, this indicates the number of aliquots of the same sample that will be read.
    Default Value: Automatic
    Default Calculation: When using the BMG plate readers, automatically set to 3 if QuantifyConcentration is True for any experiment sample. When using the Lunatic, automatically set to 3 or 2 depending on the total number of the experiment samples and the blank samples if QuantifyConcentration is True. The total number of samples allowed in one Lunatic run is 94. Otherwise automatically set to Null.
    Pattern: (GreaterEqualP[2, 1] | Automatic) | Null

    Quantification

    QuantificationWavelength

    The wavelength at which quantification analysis should be performed to determine concentration.
    Default Value: Automatic
    Default Calculation: Automatically resolves to the shortest wavelength specified in the input samples' ExtinctionCoefficients field if QuantifyConcentration is True, and resolves to Null if QuantifyConcentration is False or Automatic.
    Pattern: ((Null | RangeP[0*Nanometer, 1000*Nanometer]) | Automatic) | Null
    Index Matches to: Sample

    QuantificationAnalyte

    The substance whose concentration should be determined during this experiment.
    Default Value: Automatic
    Default Calculation: Automatically set to the first value in the Analytes field of the input sample, or, if not populated, to the first analyte in the Composition field of the input sample.
    Pattern: ((Null | ObjectP[List @@ IdentityModelTypeP]) | Automatic) | Null
    Index Matches to: Sample

    QuantifyConcentration

    Indicates if the concentration of the samples should be determined.
    Default Value: Automatic
    Default Calculation: Automatically resolves to True if QuantificationWavelength is specified and calling ExperimentAbsorbanceSpectroscopy, and resolves to False if calling ExperimentAbsorbanceIntensity.
    Pattern: BooleanP | Automatic
    Index Matches to: Sample

    Injections

    PrimaryInjectionSample

    The sample to be injected in the first round of injections in order to introduce a time sensitive reagent/sample into the plate before/during absorbance measurement. The corresponding injection times and volumes can be set with PrimaryInjectionTime and PrimaryInjectionVolume.
    Default Value: Null
    Pattern: (Null | (ObjectP[{Object[Sample], Model[Sample]}] | _String)) | Null
    Index Matches to: Sample

    PrimaryInjectionVolume

    The amount of the primary sample injected in the first round of injections.
    Default Value: Null
    Pattern: (Null | RangeP[0.5*Microliter, 300*Microliter]) | Null
    Index Matches to: Sample

    SecondaryInjectionSample

    The sample to be injected in the second round of injections. Set the corresponding injection times and volumes with SecondaryInjectionTime and SecondaryInjectionVolume.
    Default Value: Null
    Pattern: (Null | (ObjectP[{Object[Sample], Model[Sample]}] | _String)) | Null
    Index Matches to: Sample

    SecondaryInjectionVolume

    The amount of the secondary sample injected in the second round of injections.
    Default Value: Null
    Pattern: (Null | RangeP[0.5*Microliter, 300*Microliter]) | Null
    Index Matches to: Sample

    PrimaryInjectionFlowRate

    The speed at which to transfer injection samples into the assay plate in the first round of injections.
    Default Value: Automatic
    Default Calculation: Defaults to 300 Microliter/Second if primary injections are specified.
    Pattern: (BMGFlowRateP | Automatic) | Null

    SecondaryInjectionFlowRate

    The speed at which to transfer injection samples into the assay plate in the second round of injections.
    Default Value: Automatic
    Default Calculation: Defaults to 300 Microliter/Second if secondary injections are specified.
    Pattern: (BMGFlowRateP | Automatic) | Null

    InjectionSampleStorageCondition

    The non-default conditions under which any injection samples used by this experiment are stored after the protocol is completed.
    Default Value: Null
    Pattern: (SampleStorageTypeP | Disposal) | Null

    Data Processing

    Blanks

    The source used to generate a blank sample whose absorbance is subtracted as background from the absorbance readings of the input sample.
    Default Value: Automatic
    Default Calculation: Automatically set to Null if BlankAbsorbance is False, and Model[Sample, "Milli-Q water"] if BlankAbsorbance is True.
    Pattern: ((Null | (ObjectP[{Model[Sample], Object[Sample]}] | _String)) | Automatic) | Null
    Index Matches to: Sample

    BlankVolumes

    The volume of the blank that should be transferred out and used for blank measurements. Set BlankVolumes to Null to indicate blanks should be read inside their current containers.
    Default Value: Automatic
    Default Calculation: If BlankAbsorbance is True, automatically set to match the maximum of the volume of each sample or the recommended fill volume of the container. Otherwise set to Null.
    Pattern: ((Null | RangeP[1*Microliter, 300*Microliter]) | Automatic) | Null
    Index Matches to: Sample

    BlankAbsorbance

    Indicates if blank samples are prepared to account for the background signal when reading absorbance of the assay samples.
    Default Value: True
    Pattern: BooleanP

    Post Experiment

    SamplesInStorageCondition

    The non-default conditions under which the SamplesIn of this experiment should be stored after the protocol is completed. If left unset, SamplesIn will be stored according to their current StorageCondition.
    Default Value: Null
    Pattern: (Null | (Alternatives[SampleStorageTypeP | Disposal])) | Null
    Index Matches to: Sample

    Sample Handling

    MicrofluidicChipLoading

    When using Lunatic, indicates if Lunatic Microfluidic Chips are loaded by a robotic liquid handler or manually.
    Default Value: Automatic
    Default Calculation: When using the Lunatic plate readers, automatically set to Robotic. When using the BMG plate reader, automatically set Null.
    Pattern: ((Robotic | Manual) | Automatic) | Null

    Temperature

    The temperature at which the plate reader chamber is held.
    Default Value: Automatic
    Default Calculation: Resolves to Ambient if a plate reader capable heating the plate chamber is selected.
    Pattern: (RangeP[$AmbientTemperature, 45*Celsius] | Ambient) | Automatic

    EquilibrationTime

    The length of time for which the assay plates equilibrate at the requested temperature in the plate reader before being read.
    Default Value: Automatic
    Default Calculation: If a plate reader capable heating the plate chamber is selected, resolves to 0 second when Temperature is set to Ambient or 5 minutes when Temperature is above Ambient.
    Pattern: (RangeP[0*Second, 24*Hour] | Automatic) | Null

    PlateReaderMix

    Indicates if samples should be mixed inside the plate reader chamber.
    Default Value: Automatic
    Default Calculation: Automatically set to True if any other plate reader mix options are specified.
    Pattern: BooleanP | Automatic

    PlateReaderMixTime

    The amount of time samples should be mixed inside the plate reader chamber.
    Default Value: Automatic
    Default Calculation: Automatically set to 30 second if any other plate reader mix options are specified.
    Pattern: (RangeP[1*Second, 1*Hour] | Automatic) | Null

    PlateReaderMixRate

    The rate at which the plate should be agitated inside the plate reader chamber.
    Default Value: Automatic
    Default Calculation: Automatically set to 700 RPM if any other plate reader mix options are specified.
    Pattern: (RangeP[100*RPM, 700*RPM] | Automatic) | Null

    PlateReaderMixMode

    The pattern of motion which should be employed to shake the plate.
    Default Value: Automatic
    Default Calculation: Automatically set to DoubleOrbital if any other plate reader mix options are specified.
    Pattern: (MechanicalShakingP | Automatic) | Null

    MoatSize

    Indicates the number of concentric perimeters of wells to fill with MoatBuffer in order to slow evaporation of inner assay samples.
    Figure 3.1: Use the moat options, MoatBuffer, MoatVolume and MoatSize to create an outer ring of wells filled with buffer. This has been shown to decrease evaporation during long reads.
    Default Value: Automatic
    Default Calculation: Automatically set to 1 if any other moat options are specified.
    Pattern: (GreaterP[0, 1] | Automatic) | Null

    MoatVolume

    Indicates the volume to add to to each moat well.
    Default Value: Automatic
    Default Calculation: Automatically set to the RecommendedFillVolume of the assay plate if informed, or 75% of the MaxVolume of the assay plate if not, if any other moat options are specified.
    Pattern: (RangeP[1*Microliter, 300*Microliter] | Automatic) | Null

    MoatBuffer

    Indicates the sample to use to fill each moat well.
    Default Value: Automatic
    Default Calculation: Automatically set to Milli-Q water if any other moat options are specified.
    Pattern: ((ObjectP[{Object[Sample], Model[Sample]}] | _String) | Automatic) | Null

    RetainCover

    Indicates if the plate seal or lid on the assay container should not be taken off during measurement to decrease evaporation. When this option is set to True, injections cannot be performed as it's not possible to inject samples through the cover.
    Default Value: False
    Pattern: BooleanP

    Absorbance Measurement

    NumberOfReadings

    Number of redundant readings taken by the detector to determine a single averaged absorbance reading.
    Default Value: Automatic
    Default Calculation: If a plate reader capable of adjusting NumberOfReadings is selected, resolves to 100. Otherwise resolves to Null
    Pattern: (RangeP[1, 200] | Automatic) | Null

    ReadDirection

    Indicate the plate path the instrument will follow as it measures absorbance in each well, for instance reading all wells in a row before continuing on to the next row (Row).
    Figure 3.2: Use the ReadDirection option to control how the plate reader scans the plate during each read cycle. Choosing a more efficient path will lead to a shorter DetectionInterval. Also note that you may want to consider dripping injectors if you're working with low viscosity injection samples.
    Default Value: Automatic
    Default Calculation: Resolves to Row if a plate reader capable of adjusting read direction is selected.
    Pattern: (ReadDirectionP | Automatic) | Null

    Sampling

    SamplingDistance

    Indicates the length of the region over which sampling measurements are taken.
    Default Value: Automatic
    Default Calculation: Automatically resolves to Null if SamplingPattern is set to Center otherwise resolves to 80% of the diameter of the well.
    Pattern: (RangeP[1*Millimeter, 6*Millimeter] | Automatic) | Null

    SamplingDimension

    Specifies the size of the grid used for Matrix sampling. For example SamplingDimension->5 will scan a 5 x 5 grid.
    Default Value: Automatic
    Default Calculation: If the SamplingPattern is set to Matrix, SamplingDimension will be set to 3.
    Pattern: (RangeP[2, 30] | Automatic) | Null

    SamplingPattern

    Indicates where in the well measurements are taken.
    Figure 3.3: Ring sampling allows multiple measurements over a band with a specified diameter. The specified number of flashes will be equally divided over the ring and a higher number will yield to increased sampling (as seen in A). The average value of all measurements will be returned as a single data point. Spiral sampling follows the same principle as ring sampling, but covers a larger part of the well as it takes spiraling inward measurements. Again the number of flashes determines if the well is highly sampled (A) or lightly (B). Note that matrix sampling is not possible with absorbance spectroscopy readings.
    Default Value: Automatic
    Default Calculation: When using the BMG plate readers, automatically set to Matrix if SamplingDimension is specified or Ring if SamplingDistance is specified. Otherwise set to Center.
    Pattern: (PlateReaderSamplingP | Automatic) | Null

Sample Prep Options

    Preparatory Incubation

    Incubate

    Indicates if the SamplesIn should be incubated at a fixed temperature prior to starting the experiment or any aliquoting. Sample Preparation occurs in the order of Incubation, Centrifugation, Filtration, and then Aliquoting (if specified).
    Default Value: Automatic
    Default Calculation: Resolves to True if any of the corresponding Incubation options are set. Otherwise, resolves to False.
    Pattern: BooleanP | Automatic
    Index Matches to: Sample

    IncubationTemperature

    Temperature at which the SamplesIn should be incubated for the duration of the IncubationTime prior to starting the experiment.
    Default Value: Automatic
    Pattern: ((Null | (Ambient | RangeP[$MinIncubationTemperature, $MaxIncubationTemperature])) | Automatic) | Null
    Index Matches to: Sample

    IncubationTime

    Duration for which SamplesIn should be incubated at the IncubationTemperature, prior to starting the experiment.
    Default Value: Automatic
    Pattern: ((Null | RangeP[1*Minute, $MaxExperimentTime]) | Automatic) | Null
    Index Matches to: Sample

    Mix

    Indicates if this sample should be mixed while incubated, prior to starting the experiment.
    Default Value: Automatic
    Default Calculation: Automatically resolves to True if any Mix related options are set. Otherwise, resolves to False.
    Pattern: ((Null | BooleanP) | Automatic) | Null
    Index Matches to: Sample

    MixType

    Indicates the style of motion used to mix the sample, prior to starting the experiment.
    Default Value: Automatic
    Default Calculation: Automatically resolves based on the container of the sample and the Mix option.
    Pattern: ((Null | MixTypeP) | Automatic) | Null
    Index Matches to: Sample

    MixUntilDissolved

    Indicates if the mix should be continued up to the MaxIncubationTime or MaxNumberOfMixes (chosen according to the mix Type), in an attempt dissolve any solute. Any mixing/incubation will occur prior to starting the experiment.
    Default Value: Automatic
    Default Calculation: Automatically resolves to True if MaxIncubationTime or MaxNumberOfMixes is set.
    Pattern: ((Null | BooleanP) | Automatic) | Null
    Index Matches to: Sample

    MaxIncubationTime

    Maximum duration of time for which the samples will be mixed while incubated in an attempt to dissolve any solute, if the MixUntilDissolved option is chosen. This occurs prior to starting the experiment.
    Default Value: Automatic
    Default Calculation: Automatically resolves based on MixType, MixUntilDissolved, and the container of the given sample.
    Pattern: ((Null | RangeP[1*Minute, $MaxExperimentTime]) | Automatic) | Null
    Index Matches to: Sample

    IncubationInstrument

    The instrument used to perform the Mix and/or Incubation, prior to starting the experiment.
    Default Value: Automatic
    Default Calculation: Automatically resolves based on the options Mix, Temperature, MixType and container of the sample.
    Pattern: ((Null | ObjectP[{Model[Instrument, Roller], Object[Instrument, Roller], Model[Instrument, OverheadStirrer], Object[Instrument, OverheadStirrer], Model[Instrument, Vortex], Object[Instrument, Vortex], Model[Instrument, Shaker], Object[Instrument, Shaker], Model[Instrument, BottleRoller], Object[Instrument, BottleRoller], Model[Instrument, Roller], Object[Instrument, Roller], Model[Instrument, Sonicator], Object[Instrument, Sonicator], Model[Instrument, HeatBlock], Object[Instrument, HeatBlock]}]) | Automatic) | Null
    Index Matches to: Sample

    AnnealingTime

    Minimum duration for which the SamplesIn should remain in the incubator allowing the system to settle to room temperature after the IncubationTime has passed but prior to starting the experiment.
    Default Value: Automatic
    Pattern: ((Null | RangeP[0*Minute, $MaxExperimentTime]) | Automatic) | Null
    Index Matches to: Sample

    IncubateAliquotContainer

    The desired type of container that should be used to prepare and house the incubation samples which should be used in lieu of the SamplesIn for the experiment.
    Default Value: Automatic
    Pattern: ((Null | (ObjectP[Model[Container]] | {GreaterEqualP[1, 1] | (Automatic | Null), (ObjectP[{Model[Container], Object[Container]}] | _String) | Automatic})) | Automatic) | Null
    Index Matches to: Sample

    IncubateAliquotDestinationWell

    The desired position in the corresponding IncubateAliquotContainer in which the aliquot samples will be placed.
    Default Value: Automatic
    Default Calculation: Automatically resolves to A1 in containers with only one position. For plates, fills wells in the order provided by the function AllWells.
    Pattern: ((Null | WellPositionP) | Automatic) | Null
    Index Matches to: Sample

    IncubateAliquot

    The amount of each sample that should be transferred from the SamplesIn into the IncubateAliquotContainer when performing an aliquot before incubation.
    Default Value: Automatic
    Default Calculation: Automatically set as the smaller between the current sample volume and the maximum volume of the destination container.
    Pattern: ((Null | (RangeP[1*Microliter, 20*Liter] | All)) | Automatic) | Null
    Index Matches to: Sample

    Preparatory Centrifugation

    Centrifuge

    Indicates if the SamplesIn should be centrifuged prior to starting the experiment or any aliquoting. Sample Preparation occurs in the order of Incubation, Centrifugation, Filtration, and then Aliquoting (if specified).
    Default Value: Automatic
    Default Calculation: Resolves to True if any of the corresponding Centrifuge options are set. Otherwise, resolves to False.
    Pattern: BooleanP | Automatic
    Index Matches to: Sample

    CentrifugeInstrument

    The centrifuge that will be used to spin the provided samples prior to starting the experiment.
    Default Value: Automatic
    Pattern: ((Null | ObjectP[{Model[Instrument, Centrifuge], Object[Instrument, Centrifuge]}]) | Automatic) | Null
    Index Matches to: Sample

    CentrifugeIntensity

    The rotational speed or the force that will be applied to the samples by centrifugation prior to starting the experiment.
    Default Value: Automatic
    Pattern: ((Null | (GreaterP[0*RPM] | GreaterP[0*GravitationalAcceleration])) | Automatic) | Null
    Index Matches to: Sample

    CentrifugeTime

    The amount of time for which the SamplesIn should be centrifuged prior to starting the experiment.
    Default Value: Automatic
    Pattern: ((Null | GreaterP[0*Minute]) | Automatic) | Null
    Index Matches to: Sample

    CentrifugeTemperature

    The temperature at which the centrifuge chamber should be held while the samples are being centrifuged prior to starting the experiment.
    Default Value: Automatic
    Pattern: ((Null | (Ambient | RangeP[-10*Celsius, 40*Celsius])) | Automatic) | Null
    Index Matches to: Sample

    CentrifugeAliquotContainer

    The desired type of container that should be used to prepare and house the centrifuge samples which should be used in lieu of the SamplesIn for the experiment.
    Default Value: Automatic
    Pattern: ((Null | (ObjectP[Model[Container]] | {GreaterEqualP[1, 1] | (Automatic | Null), (ObjectP[{Model[Container], Object[Container]}] | _String) | Automatic})) | Automatic) | Null
    Index Matches to: Sample

    CentrifugeAliquotDestinationWell

    The desired position in the corresponding AliquotContainer in which the aliquot samples will be placed.
    Default Value: Automatic
    Default Calculation: Automatically resolves to A1 in containers with only one position. For plates, fills wells in the order provided by the function AllWells.
    Pattern: ((Null | WellPositionP) | Automatic) | Null
    Index Matches to: Sample

    CentrifugeAliquot

    The amount of each sample that should be transferred from the SamplesIn into the CentrifugeAliquotContainer when performing an aliquot before centrifugation.
    Default Value: Automatic
    Default Calculation: Automatically set as the smaller between the current sample volume and the maximum volume of the destination container.
    Pattern: ((Null | (RangeP[1*Microliter, 20*Liter] | All)) | Automatic) | Null
    Index Matches to: Sample

    Preparatory Filtering

    Filtration

    Indicates if the SamplesIn should be filter prior to starting the experiment or any aliquoting. Sample Preparation occurs in the order of Incubation, Centrifugation, Filtration, and then Aliquoting (if specified).
    Default Value: Automatic
    Default Calculation: Resolves to True if any of the corresponding Filter options are set. Otherwise, resolves to False.
    Pattern: BooleanP | Automatic
    Index Matches to: Sample

    FiltrationType

    The type of filtration method that should be used to perform the filtration.
    Default Value: Automatic
    Default Calculation: Will automatically resolve to a filtration type appropriate for the volume of sample being filtered.
    Pattern: ((Null | FiltrationTypeP) | Automatic) | Null
    Index Matches to: Sample

    FilterInstrument

    The instrument that should be used to perform the filtration.
    Default Value: Automatic
    Default Calculation: Will automatically resolved to an instrument appropriate for the filtration type.
    Pattern: ((Null | ObjectP[{Model[Instrument, FilterBlock], Object[Instrument, FilterBlock], Model[Instrument, PeristalticPump], Object[Instrument, PeristalticPump], Model[Instrument, VacuumPump], Object[Instrument, VacuumPump], Model[Instrument, Centrifuge], Object[Instrument, Centrifuge], Model[Instrument, SyringePump], Object[Instrument, SyringePump]}]) | Automatic) | Null
    Index Matches to: Sample

    Filter

    The filter that should be used to remove impurities from the SamplesIn prior to starting the experiment.
    Default Value: Automatic
    Default Calculation: Will automatically resolve to a filter appropriate for the filtration type and instrument.
    Pattern: ((Null | ObjectP[{Model[Container, Plate, Filter], Model[Container, Vessel, Filter], Model[Item, Filter]}]) | Automatic) | Null
    Index Matches to: Sample

    FilterMaterial

    The membrane material of the filter that should be used to remove impurities from the SamplesIn prior to starting the experiment.
    Default Value: Automatic
    Default Calculation: Resolves to an appropriate filter material for the given sample is Filtration is set to True.
    Pattern: ((Null | FilterMembraneMaterialP) | Automatic) | Null
    Index Matches to: Sample

    PrefilterMaterial

    The material from which the prefilter filtration membrane should be made of to remove impurities from the SamplesIn prior to starting the experiment.
    Default Value: Automatic
    Default Calculation: By default, no prefiltration is performed on samples, even when Filter->True.
    Pattern: ((Null | FilterMembraneMaterialP) | Automatic) | Null
    Index Matches to: Sample

    FilterPoreSize

    The pore size of the filter that should be used when removing impurities from the SamplesIn prior to starting the experiment.
    Default Value: Automatic
    Default Calculation: Resolves to an appropriate filter pore size for the given sample is Filtration is set to True.
    Pattern: ((Null | FilterSizeP) | Automatic) | Null
    Index Matches to: Sample

    PrefilterPoreSize

    The pore size of the filter; all particles larger than this should be removed during the filtration.
    Default Value: Automatic
    Default Calculation: By default, no prefiltration is performed on samples, even when Filter->True.
    Pattern: ((Null | FilterSizeP) | Automatic) | Null
    Index Matches to: Sample

    FilterSyringe

    The syringe used to force that sample through a filter.
    Default Value: Automatic
    Default Calculation: Resolves to an syringe appropriate to the volume of sample being filtered, if Filtration is set to True.
    Pattern: ((Null | (ObjectP[{Model[Container, Syringe], Object[Container, Syringe]}] | _String)) | Automatic) | Null
    Index Matches to: Sample

    FilterHousing

    The filter housing that should be used to hold the filter membrane when filtration is performed using a standalone filter membrane.
    Default Value: Automatic
    Default Calculation: Resolve to an housing capable of holding the size of the membrane being used, if filter with Membrane FilterType is being used and Filtration is set to True.
    Pattern: ((Null | ObjectP[{Model[Instrument, FilterHousing], Object[Instrument, FilterHousing]}]) | Automatic) | Null
    Index Matches to: Sample

    FilterIntensity

    The rotational speed or force at which the samples will be centrifuged during filtration.
    Default Value: Automatic
    Default Calculation: Will automatically resolve to 2000 GravitationalAcceleration if FiltrationType is Centrifuge and Filtration is True.
    Pattern: ((Null | (GreaterP[0*RPM] | GreaterP[0*GravitationalAcceleration])) | Automatic) | Null
    Index Matches to: Sample

    FilterTime

    The amount of time for which the samples will be centrifuged during filtration.
    Default Value: Automatic
    Default Calculation: Will automatically resolve to 5 Minute if FiltrationType is Centrifuge and Filtration is True.
    Pattern: ((Null | GreaterP[0*Minute]) | Automatic) | Null
    Index Matches to: Sample

    FilterTemperature

    The temperature at which the centrifuge chamber will be held while the samples are being centrifuged during filtration.
    Default Value: Automatic
    Default Calculation: Will automatically resolve to 22 Celsius if FiltrationType is Centrifuge and Filtration is True.
    Pattern: ((Null | (Alternatives[GreaterEqualP[4*Celsius]])) | Automatic) | Null
    Index Matches to: Sample

    FilterContainerOut

    The desired container filtered samples should be produced in or transferred into by the end of filtration, with indices indicating grouping of samples in the same plates, if desired.
    Default Value: Automatic
    Default Calculation: Automatically set as the PreferredContainer for the Volume of the sample. For plates, attempts to fill all wells of a single plate with the same model before using another one.
    Pattern: ((Null | ((ObjectP[{Model[Container], Object[Container]}] | _String) | {GreaterEqualP[1, 1] | Automatic, (ObjectP[{Model[Container], Object[Container]}] | _String) | Automatic})) | Automatic) | Null
    Index Matches to: Sample

    FilterAliquotDestinationWell

    The desired position in the corresponding AliquotContainer in which the aliquot samples will be placed.
    Default Value: Automatic
    Default Calculation: Automatically resolves to A1 in containers with only one position. For plates, fills wells in the order provided by the function AllWells.
    Pattern: ((Null | WellPositionP) | Automatic) | Null
    Index Matches to: Sample

    FilterAliquotContainer

    The desired type of container that should be used to prepare and house the filter samples which should be used in lieu of the SamplesIn for the experiment.
    Default Value: Automatic
    Pattern: ((Null | (ObjectP[Model[Container]] | {GreaterEqualP[1, 1] | (Automatic | Null), (ObjectP[{Model[Container], Object[Container]}] | _String) | Automatic})) | Automatic) | Null
    Index Matches to: Sample

    FilterAliquot

    The amount of each sample that should be transferred from the SamplesIn into the FilterAliquotContainer when performing an aliquot before filtration.
    Default Value: Automatic
    Default Calculation: Automatically set as the smaller between the current sample volume and the maximum volume of the destination container.
    Pattern: ((Null | (RangeP[1*Microliter, 20*Liter] | All)) | Automatic) | Null
    Index Matches to: Sample

    FilterSterile

    Indicates if the filtration of the samples should be done in a sterile environment.
    Default Value: Automatic
    Default Calculation: Resolve to False if Filtration is indicated. If sterile filtration is desired, this option must manually be set to True.
    Pattern: ((Null | BooleanP) | Automatic) | Null
    Index Matches to: Sample

    Aliquoting

    Aliquot

    Indicates if aliquots should be taken from the SamplesIn and transferred into new AliquotSamples used in lieu of the SamplesIn for the experiment. Note that if NumberOfReplicates is specified this indicates that the input samples will also be aliquoted that number of times. Note that Aliquoting (if specified) occurs after any Sample Preparation (if specified).
    Default Value: Automatic
    Pattern: BooleanP | Automatic
    Index Matches to: Sample

    AliquotSampleLabel

    The label of the samples, after they are aliquotted.
    Default Value: Automatic
    Pattern: ((Null | _String) | Automatic) | Null
    Index Matches to: Sample

    AliquotAmount

    The amount of a sample that should be transferred from the input samples into aliquots.
    Default Value: Automatic
    Default Calculation: Automatically set as the smaller between the current sample volume and the maximum volume of the destination container if a liquid, or the current Mass or Count if a solid or counted item, respectively.
    Pattern: ((Null | (RangeP[1*Microliter, 20*Liter] | RangeP[1*Milligram, 20*Kilogram] | GreaterP[0*Unit, 1*Unit] | GreaterP[0., 1.] | All)) | Automatic) | Null
    Index Matches to: Sample

    TargetConcentration

    The desired final concentration of analyte in the AliquotSamples after dilution of aliquots of SamplesIn with the ConcentratedBuffer and BufferDiluent which should be used in lieu of the SamplesIn for the experiment.
    Default Value: Automatic
    Default Calculation: Automatically calculated based on aliquot and buffer volumes.
    Pattern: ((Null | (GreaterP[0*Molar] | GreaterP[(0*Gram)/Liter])) | Automatic) | Null
    Index Matches to: Sample

    TargetConcentrationAnalyte

    The substance whose final concentration is attained with the TargetConcentration option.
    Default Value: Automatic
    Default Calculation: Automatically set to the first value in the Analytes field of the input sample, or, if not populated, to the first analyte in the Composition field of the input sample, or if none exist, the first identity model of any kind in the Composition field.
    Pattern: ((Null | ObjectP[IdentityModelTypes]) | Automatic) | Null
    Index Matches to: Sample

    AssayVolume

    The desired total volume of the aliquoted sample plus dilution buffer.
    Default Value: Automatic
    Default Calculation: Automatically determined based on Volume and TargetConcentration option values.
    Pattern: ((Null | RangeP[1*Microliter, 20*Liter]) | Automatic) | Null
    Index Matches to: Sample

    ConcentratedBuffer

    The concentrated buffer which should be diluted by the BufferDilutionFactor in the final solution (i.e., the combination of the sample, ConcentratedBuffer, and BufferDiluent). The ConcentratedBuffer and BufferDiluent will be combined and then mixed with the sample, where the combined volume of these buffers is the difference between the AliquotAmount and the total AssayVolume.
    Default Value: Automatic
    Pattern: ((Null | (ObjectP[{Model[Sample], Object[Sample]}] | _String)) | Automatic) | Null
    Index Matches to: Sample

    BufferDilutionFactor

    The dilution factor by which the concentrated buffer should be diluted in the final solution (i.e., the combination of the sample, ConcentratedBuffer, and BufferDiluent). The ConcentratedBuffer and BufferDiluent will be combined and then mixed with the sample, where the combined volume of these buffers is the difference between the AliquotAmount and the total AssayVolume.
    Default Value: Automatic
    Default Calculation: If ConcentratedBuffer is specified, automatically set to the ConcentrationFactor of that sample; otherwise, set to Null.
    Pattern: ((Null | GreaterEqualP[1]) | Automatic) | Null
    Index Matches to: Sample

    BufferDiluent

    The buffer used to dilute the aliquot sample such that ConcentratedBuffer is diluted by BufferDilutionFactor in the final solution. The ConcentratedBuffer and BufferDiluent will be combined and then mixed with the sample, where the combined volume of these buffers is the difference between the AliquotAmount and the total AssayVolume.
    Default Value: Automatic
    Default Calculation: Automatically resolves to Model[Sample, "Milli-Q water"] if ConcentratedBuffer is specified; otherwise, resolves to Null.
    Pattern: ((Null | (ObjectP[{Model[Sample], Object[Sample]}] | _String)) | Automatic) | Null
    Index Matches to: Sample

    AssayBuffer

    The buffer that should be added to any aliquots requiring dilution, where the volume of this buffer added is the difference between the AliquotAmount and the total AssayVolume.
    Default Value: Automatic
    Default Calculation: Automatically resolves to Model[Sample, "Milli-Q water"] if ConcentratedBuffer is not specified; otherwise, resolves to Null.
    Pattern: ((Null | (ObjectP[{Model[Sample], Object[Sample]}] | _String)) | Automatic) | Null
    Index Matches to: Sample

    AliquotSampleStorageCondition

    The non-default conditions under which any aliquot samples generated by this experiment should be stored after the protocol is completed.
    Default Value: Automatic
    Pattern: ((Null | (SampleStorageTypeP | Disposal)) | Automatic) | Null
    Index Matches to: Sample

    DestinationWell

    The desired position in the corresponding AliquotContainer in which the aliquot samples will be placed.
    Default Value: Automatic
    Default Calculation: Automatically resolves to A1 in containers with only one position. For plates, fills wells in the order provided by the function AllWells.
    Pattern: ((WellPositionP | {((Automatic | Null) | WellPositionP)..}) | Automatic) | Null

    AliquotContainer

    The desired type of container that should be used to prepare and house the aliquot samples, with indices indicating grouping of samples in the same plates, if desired. This option will resolve to be the length of the SamplesIn * NumberOfReplicates.
    Default Value: Automatic
    Default Calculation: Automatically set as the PreferredContainer for the AssayVolume of the sample. For plates, attempts to fill all wells of a single plate with the same model before aliquoting into the next.
    Pattern: (((ObjectP[{Model[Container], Object[Container]}] | _String) | (Automatic | Null) | {GreaterEqualP[1, 1] | (Automatic | Null), (ObjectP[{Model[Container], Object[Container]}] | _String) | (Automatic | Null)} | {((ObjectP[{Model[Container], Object[Container]}] | _String) | (Automatic | Null))..} | {({GreaterEqualP[1, 1] | (Automatic | Null), (ObjectP[{Model[Container], Object[Container]}] | _String) | (Automatic | Null)} | (Automatic | Null))..}) | Automatic) | Null

    AliquotPreparation

    Indicates the desired scale at which liquid handling used to generate aliquots will occur.
    Default Value: Automatic
    Default Calculation: Automatic resolution will occur based on manipulation volumes and container types.
    Pattern: (PreparationMethodP | Automatic) | Null

    ConsolidateAliquots

    Indicates if identical aliquots should be prepared in the same container/position.
    Default Value: Automatic
    Pattern: (BooleanP | Automatic) | Null

    Sample Preparation

    PreparatoryPrimitives

    Specifies a sequence of transferring, aliquoting, consolidating, or mixing of new or existing samples before the main experiment. These prepared samples can be used in the main experiment by referencing their defined name. For more information, please reference the documentation for ExperimentSampleManipulation.
    Default Value: Null
    Pattern: {SampleManipulationP..} | Null

Protocol Options

    Post Experiment

    MeasureWeight

    Indicates if any solid samples that are modified in the course of the experiment should have their weights measured and updated after running the experiment.
    Default Value: Automatic
    Pattern: (BooleanP | Automatic) | Null

    MeasureVolume

    Indicates if any liquid samples that are modified in the course of the experiment should have their volumes measured and updated after running the experiment.
    Default Value: Automatic
    Pattern: (BooleanP | Automatic) | Null

    ImageSample

    Indicates if any samples that are modified in the course of the experiment should be freshly imaged after running the experiment.
    Default Value: Automatic
    Pattern: (BooleanP | Automatic) | Null

Example Calls

    Quantification

    If quantifying, it is recommended to use the fixed path length Lunatic plate reader. The specified wavelength will be the one on which the extinction cofficient will be obtained and absorbance will be calculated:
    To indicate which component in a mixture will be quantified, specify the QuantificationAnalyte option. If not specified, AbsorbanceSpectroscopy will call the Experiment`Private`selectAnalyteFromSample on the input samples to guess what component to quantify:
    Set the sample to set as the blank to subtract when quantifying. If not specified, will be set to water:

    Injections

    To specify injections, use the InjectionSample and InjectionVolume options if using the PHERAstar, CLARIOstar, or Omega. The sample and volume options are index matched to the input samples allowing you to control the wells which receive injections and the volumes of those injections. In the example below, 50 Microliter of myInjectionSample1 is injected into each well, and then myInjectionSample2 is injected at different volumes into the first two wells but not the third:

    Plate Reader Mixing

    The assay plate can be mixed during readings by specifying any of the PlateReaderMix options if using the PHERAstar, CLARIOstar, or Omega:

Preferred Input Containers

    The Lunatic plate reader can load its microfluidic chips with most Hamiltion robot-compatible containers, most notably except 50 mL tubes.
    The CLARIOstar, PHERAstar, and Omega plate readers can read standard SBS shallow well plates.
    The CLARIOstar, PHERAstar, and Omega plate readers can inject samples from samples in 2mL, 15mL and 50 mL tubes while recording kinetic signal.

Data Processing

    Calculate the concentration of the input samples given the data produced in the experiment:

Warnings and Errors

    Messages

Possible Issues

    Multiple components

    If a mixture exists with overlapping extinction coefficients, the calculated concentration may be off because the full absorbance will be attributed to a single component rather than the multiple components of the sample.

    Readings outside of linear range

    If the output data is outside of the recommended linear range of the instrument, AnalyzeAbsorbanceQuantification will throw a warning because quantifications may be less reliable.

    Incompatible solvents

    If the sample is contained in a volatile solvent (say methanol or acetone), the 2.1 μL of solvent will evaporate before any data can be collected. For example, when plotting the following data Object[Data, AbsorbanceSpectroscopy, "id:zGj91a7n4JNn"], an error will be thrown since there is no valid data collected.

    Lunatic NumberOfReplicates

    If the Lunatic is chosen as the instrument, consider using a NumberOfReplicates->3 or more, since the microfluidic chips can develop bubbles during loading which can prevent data from being collected. If QuantifyConcentration->True the NumberOfReplicates will automatically resolve to 3.