ecl-logo Documentation
ECL`

FillToVolume

FillToVolume[Options]⟹UnitOperation

transfers an amount of sample from the given sources up to the specified volume of the given destinations.

    
Filling a container featuring some sample to a specific volume allows for the creation of solutions with known concentrations and final volumes. Solvent is added to a container containing the relevant solute up until the combined volume reaches the specified level, either in a volumetric flask or a container whose volume can be measured ultrasonically.
    

Experimental Principles

    Figure 1.1: Step 1: Solvent is added to input sample. Step 2: Input container is mixed (optional). Step 3: Solvent is added until the meniscus reaches the marked line on the volumetric flask.
    Figure 1.2: Step 1: Solvent is added to input sample. Step 2: An ultrasonic sensor determines the distance to the surface of the liquid sample by measuring the time elapsed between sending and receiving ultrasonic pulses. Step 3:A calibration that stores an empty container distance and a function relating liquid level to volume is used to calculate the sample's volume. Step 4: If calculated volume is within the specified Tolerance of the TotalVolume, experiment is complete. If not, steps 1-3 are repeated until the volume reaches the desired level.

Instrumentation

    Eppendorf Research Plus P200

    Figure 2.1: The diagram above lists the available pipette sizes and corresponding tip types that are available in the ECL.

    pipetus

    Figure 2.2: The above diagram lists the compatible serological tip sizes that are available at the ECL.

    Eppendorf Research Plus, 8-channel 1200uL

    Figure 2.3: 1 to 8 samples can be transferred at the same time using the 8 channel pipette.

    Mettler Toledo XP6

    Figure 2.4: Items are transferred through an ionizer, which floods the local environment with positive and negative ions. This removes any static electricity that has built up on items and provides a more stable and accurate mass reading.The user must explicitly specify the Micro-Balance using the option Instrument -> Model[Instrument,Balance,"id:54n6evKx08XN"] if so desired.

    Ohaus Pioneer PA124

    Figure 2.5: Items are transferred through an ionizer, which floods the local environment with positive and negative ions. This removes any static electricity that has built up on items and provides a more stable and accurate mass reading.

    Ohaus EX6202

    Figure 2.6: Items are transferred to the balance to obtain a mass reading.

Experiment Options

    General

    Sample

    Input samples for this analytical or preparative experiment which will be filled to a specified volume.
    Default Value: Null
    Pattern Description: Container with Well Position or Model Sample or Sample or Container or Null.
    Programmatic Pattern: (ObjectP[{Object[Sample], Object[Container]}] | _String) | {Alternatives @@ Flatten[AllWells[NumberOfWells -> 384]] | LocationPositionP, ObjectP[{Object[Container]}] | _String} | ObjectP[Model[Sample]]
    Index Matches to: Sample

    TotalVolume

    The volume to which to fill the destination sample with the source solvent.
    Default Value: Null
    Pattern Description: Greater than or equal to 1 microliter and less than or equal to 20 liters or Null.
    Programmatic Pattern: RangeP[1*Microliter, 20*Liter]
    Index Matches to: Sample

    Solvent

    Source solvent to be transferred into the destination for this experiment.
    Default Value: Automatic
    Pattern Description: Sample or Container.
    Programmatic Pattern: (Alternatives[ObjectP[{Object[Sample], Object[Container, Vessel], Model[Sample]}] | _String]) | Automatic
    Index Matches to: Sample

    SampleLabel

    A user defined word or phrase used to identify the samples that are used for the fill to volume, for use in downstream unit operations.
    Default Value: Automatic
    Pattern Description: A string.
    Programmatic Pattern: _String | Automatic
    Index Matches to: Sample

    SampleContainerLabel

    A user defined word or phrase used to identify the containers of the samples that are used for the fill to volume, for use in downstream unit operations.
    Default Value: Automatic
    Pattern Description: A string.
    Programmatic Pattern: _String | Automatic
    Index Matches to: Sample

    Method

    The method by which to add the Solvent to the bring the input sample up to the TotalVolume.
    Default Value: Automatic
    Default Calculation: Automatically set to Volumetric if in a volumetric flask, or Null and throws an error if in an UltrasonicIncompatible container or using an UltrasonicIncompatible solvent, or Ultrasonic otherwise.
    Pattern Description: Ultrasonic or Volumetric.
    Programmatic Pattern: FillToVolumeMethodP | Automatic
    Index Matches to: Sample

    SolventLabel

    A user defined word or phrase used to identify the solvent that is used for the fill to volume, for use in downstream unit operations.
    Default Value: Automatic
    Pattern Description: A string.
    Programmatic Pattern: _String | Automatic
    Index Matches to: Sample

    SolventContainer

    The container that the source sample will be located in during the transfer.
    Default Value: Automatic
    Default Calculation: Automatically set to the Object[Container, Vessel] if an Object[Sample] is specified in the Solvent option. Otherwise, automatically set to a Model[Container, Vessel] on any existing samples that can be used to fulfill the Model[Sample] request or based on the container that the default product for the Model[Sample] comes in.
    Pattern Description: Existing Container or New Container or Null.
    Programmatic Pattern: ((Null | ((ObjectP[Object[Container, Vessel]] | _String) | ObjectP[Model[Container, Vessel]])) | Automatic) | Null
    Index Matches to: Sample

    SolventContainerLabel

    A user defined word or phrase used to identify the solvent's container that is used for the fill to volume, for use in downstream unit operations.
    Default Value: Automatic
    Pattern Description: A string.
    Programmatic Pattern: _String | Automatic
    Index Matches to: Sample

    DestinationWell

    The position in the destination container in which the source sample will be placed.
    Default Value: Automatic
    Default Calculation: Automatically set to the position of the given Object[Sample]. Otherwise, is set to the first empty well of the container. Otherwise, is set to "A1".
    Pattern Description: Any valid container position or any well from A1 to H12.
    Programmatic Pattern: (WellPositionP | LocationPositionP) | Automatic
    Index Matches to: Sample

    MaxNumberOfOverfillingRepreparations

    The maximum number of times the FillToVolume protocol can be repeated in the event of target volume overfilling. When a repreparation is triggered, the same inputs and options are used, and the value of MaxNumberOfOverfillingRepreparations is decreased by 1. If this value is set to Null, the protocol will complete normally, even if the final sample volume exceeds the target.
    Default Value: Automatic
    Default Calculation: For a new FillToVolume protocol, automatically set to 3 if all experiment inputs are of type Model[Sample]. When a repeat protocol is enqueued, the value is decremented by 1 from the current MaxNumberOfOverfillingRepreparations. For all other cases, set to Null.
    Pattern Description: Greater than or equal to 1 and less than or equal to 3 or Null.
    Programmatic Pattern: (RangeP[1, 3] | Automatic) | Null

    Instrument Specifications

    Tolerance

    The allowed tolerance of the final volume. If the sample's volume reaches the specified volume +/- this value then no more Solvent will be added. If the sample's volume is below the specified volume +/- this value then more Solvent will be added. If the sample's volume is above the specified volume +/-, no further Solvent will be added and TargetVolumeToleranceAchieved in the protocol object will be set to False.
    Default Value: Automatic
    Default Calculation: Automatically set to the Precision field of the sample's container if Method -> Volumetric, or calculated from the VolumeCalibrations field of the sample's container model at the specified volume.
    Pattern Description: Percent Tolerance or Volume Tolerance or Null.
    Programmatic Pattern: ((Null | (GreaterP[0*Milliliter] | RangeP[0*Percent, 100*Percent])) | Automatic) | Null
    Index Matches to: Sample

    Instrument

    The standalone instrument used to transfer the sample from the source container (or from the intermediate container if IntermediateDecant->True) to the destination container. If this option is set to Null, it indicates that pouring will be done to perform the transfer when Preparation->Manual.
    Default Value: Automatic
    Default Calculation: Automatically set to an instrument that can move the amount being transferred and the source and destination containers of the transfer. For more information, please refer to the function TransferDevices[].
    Pattern Description: An object of type or subtype Model[Container, Syringe], Model[Container, GraduatedCylinder], Model[Instrument, Pipette], Model[Instrument, Aspirator], Model[Item, Spatula], Model[Item, Tweezer], Model[Item, TransferTube], Model[Item, ChippingHammer], Model[Item, Scissors], Object[Container, Syringe], Object[Container, GraduatedCylinder], Object[Instrument, Pipette], Object[Instrument, Aspirator], Object[Item, Spatula], Object[Item, Tweezer], Object[Item, TransferTube], Object[Item, ChippingHammer], or Object[Item, Scissors] or a prepared sample or Null.
    Programmatic Pattern: ((Null | (ObjectP[{Model[Container, Syringe], Model[Container, GraduatedCylinder], Model[Instrument, Pipette], Model[Instrument, Aspirator], Model[Item, Spatula], Model[Item, Tweezer], Model[Item, TransferTube], Model[Item, ChippingHammer], Model[Item, Scissors], Object[Container, Syringe], Object[Container, GraduatedCylinder], Object[Instrument, Pipette], Object[Instrument, Aspirator], Object[Item, Spatula], Object[Item, Tweezer], Object[Item, TransferTube], Object[Item, ChippingHammer], Object[Item, Scissors]}] | _String)) | Automatic) | Null
    Index Matches to: Sample

    TransferEnvironment

    The environment in which the transfer will be performed (Biosafety Cabinet, Fume Hood, Glove Box, or Benchtop Handling Station). Containers involved in the transfer will first be moved into the TransferEnvironment (with covers on), uncovered inside of the TransferEnvironment, then covered after the Transfer has finished -- before they're moved back onto the operator cart. Consult the SterileTechnique/RNaseFreeTechnique option when using a BSC. This option cannot be set when Preparation->Robotic.
    Default Value: Automatic
    Default Calculation: Automatically set to an instrument that can handle the any safety requirements of the samples being transferred.
    Pattern Description: An object of type or subtype Model[Instrument, BiosafetyCabinet], Model[Instrument, FumeHood], Model[Instrument, GloveBox], Model[Container, Bench], Model[Container, Enclosure], Model[Instrument, HandlingStation], Object[Instrument, BiosafetyCabinet], Object[Instrument, FumeHood], Object[Instrument, GloveBox], Object[Container, Bench], Object[Container, Enclosure], or Object[Instrument, HandlingStation] or Null.
    Programmatic Pattern: ((Null | ObjectP[{Model[Instrument, BiosafetyCabinet], Model[Instrument, FumeHood], Model[Instrument, GloveBox], Model[Container, Bench], Model[Container, Enclosure], Model[Instrument, HandlingStation], Object[Instrument, BiosafetyCabinet], Object[Instrument, FumeHood], Object[Instrument, GloveBox], Object[Container, Bench], Object[Container, Enclosure], Object[Instrument, HandlingStation]}]) | Automatic) | Null
    Index Matches to: Sample

    Tips

    The pipette tips used to aspirate and dispense the requested volume.
    Default Value: Automatic
    Default Calculation: Automatically set to a tip that does not conflict with the incompatible materials of the sample(s) that the tip will come in contact with, the amount being transferred, and the source and destination containers of the transfer (accessibility). For more information, please refer to the function TransferDevices[].
    Pattern Description: An object of type or subtype Model[Item, Tips], Object[Item, Tips], Model[Item, Consumable], or Object[Item, Consumable] or Null.
    Programmatic Pattern: ((Null | ObjectP[{Model[Item, Tips], Object[Item, Tips], Model[Item, Consumable], Object[Item, Consumable]}]) | Automatic) | Null
    Index Matches to: Sample

    TipType

    The type of pipette tips used to aspirate and dispense the requested volume during the transfer.
    Default Value: Automatic
    Default Calculation: Automatically set to the TipType field of the calculated Tips that will be used to perform the transfer.
    Pattern Description: Normal, Barrier, WideBore, GelLoading, or Aspirator or Null.
    Programmatic Pattern: ((Null | TipTypeP) | Automatic) | Null
    Index Matches to: Sample

    TipMaterial

    The material of the pipette tips used to aspirate and dispense the requested volume during the transfer.
    Default Value: Automatic
    Default Calculation: Automatically set to the chemistry of the calculated Tips that will be used to perform the transfer.
    Pattern Description: {ABS, PLA, Acrylic, AmorphousFluoropolymer, CPVC, CTFE, Cycloolefine, COC, Delrin, ECTFE, EPDM, ETFE, EVA, FEP, FFKM, HDPE, Hypalon, LDPE, NaturalRubber, NBR, Neoprene, Nitrile, Noryl, Nylon, PEEK, PEI, Perlast, PharmaPure, Polycarbonate, Polyester, Polyethylene, Polyisoprene, Polyolefin, Polyoxymethylene, Polypropylene, Polysulfone, Polystyrene, Polyurethane, PVC, PCTFE, PETG, PF, PFA, PPS, PTFE, PVDF, SEBS, Silicone, Styrofoam, SyntheticRubber, TFM, TPE, Tygon, UVPlastic, UVXPO, Viton}, {Aluminum, Alloy, AnodisedAluminum, Brass, Bronze, CarbonSteel, CastIron, Chrome, Copper, Elgiloy, Gold, Hastelloy, Lead, Magnesium, Molybdenum, MP35N, MP35NHPS, Nickel, Niobium, Platinum, Silver, Steel, StainlessSteel, Titanium, Tungsten, Zinc}, {Cellulose, Cotton, Polyethylene, Polypropylene, PTFE, Nylon, PES, PLUS, PVDF, GlassFiber, GHP, UHMWPE, EPDM, DuraporePVDF, GxF, ZebaDesaltingResin, NickelResin, AgaroseResin, CobaltResin, Silica, HLB, AnoporeAlumina}, {Silica, Alumina, ResinParticlesWithLatexMicroBeads, CrossLinkedDextranBeads, CrossLinkedPolystyrene, AerisCoreShell, KinetexCoreShell, CrossLinkedAgarose, Vydac218MS, JordiGel, Styrene, SilicaCompositeTWIN, BEH, CSH, HSS, CarboPacPA1, CarboPacPA10, BEH}, AluminiumOxide, ZirconiumOxide, Ceramic, Epoxy, EpoxyResin, GlassyCarbon, {BorosilicateGlass, Glass, OpticalGlass}, Graphite, Porcelain, Oxidizer, {Cardboard, Wood}, {Agate, Quartz, UVQuartz, ESQuartz, FusedQuartz, IRQuartz}, Ruby, Sapphire, Silicon, Viton, or {VacuumMeltedStainlessSteel} or Null.
    Programmatic Pattern: ((Null | MaterialP) | Automatic) | Null
    Index Matches to: Sample

    Needle

    The needle used to aspirate and dispense the requested volume.
    Default Value: Automatic
    Default Calculation: Automatically set to a needle that does not conflict with the incompatible materials of the sample(s) that the tip will come in contact with, the amount being transferred, and the source and destination containers of the transfer (accessibility). For more information, please refer to the function TransferDevices[].
    Pattern Description: An object of type or subtype Model[Item, Needle] or Object[Item, Needle] or Null.
    Programmatic Pattern: ((Null | ObjectP[{Model[Item, Needle], Object[Item, Needle]}]) | Automatic) | Null
    Index Matches to: Sample

    Funnel

    The funnel that is used to guide the source sample into the destination container when pouring or using a graduated cylinder.
    Default Value: Automatic
    Default Calculation: Automatically set to a funnel that can fit into the aperture of the destination container if 1) the transfer Instrument is set to Null (pouring)/GraduatedCylinder or 2) liquid is being transferred from a weighing container to the destination (pouring).
    Pattern Description: An object of type or subtype Model[Part, Funnel] or Object[Part, Funnel] or Null.
    Programmatic Pattern: ((Null | ObjectP[{Model[Part, Funnel], Object[Part, Funnel]}]) | Automatic) | Null
    Index Matches to: Sample

    HandPump

    The hand pump used to get liquid out of the source container.
    Default Value: Automatic
    Default Calculation: Automatically set to Model[Part, HandPump, "id:L8kPEjNLDld6"] if the source is in a container with a MaxVolume over 5 Liters and either (1) the transfer instrument used is a graduated cylinder or (2) an intermediate decant is specified.
    Pattern Description: An object of type or subtype Model[Part, HandPump] or Object[Part, HandPump] or Null.
    Programmatic Pattern: ((Null | ObjectP[{Model[Part, HandPump], Object[Part, HandPump]}]) | Automatic) | Null
    Index Matches to: Sample

    IntermediateFunnel

    The funnel that is used to guide the source sample into the intermediate container when pouring.
    Default Value: Automatic
    Default Calculation: Automatically set to a funnel that can fit inside the IntermediateContainer, if an IntermediateDecant is required.
    Pattern Description: An object of type or subtype Model[Part, Funnel] or Object[Part, Funnel] or Null.
    Programmatic Pattern: ((Null | ObjectP[{Model[Part, Funnel], Object[Part, Funnel]}]) | Automatic) | Null
    Index Matches to: Sample

    Post Experiment

    SolventStorageCondition

    The non-default conditions under which the specified Solvent used by this experiment should be stored after the protocol is completed. If left unset, the solvents will be stored according to their Models' DefaultStorageCondition.
    Default Value: Null
    Pattern Description: {AmbientStorage, EnclosedAmbientStorage, Refrigerator, Freezer, DeepFreezer, CryogenicStorage, YeastIncubation, YeastShakingIncubation, BacterialIncubation, BacterialShakingIncubation, MammalianIncubation, ViralIncubation, CrystalIncubation, AcceleratedTesting, IntermediateTesting, LongTermTesting, UVVisLightTesting} or Disposal or Null.
    Programmatic Pattern: (Null | (Alternatives[SampleStorageTypeP | Disposal])) | Null
    Index Matches to: Sample

    SamplesOutStorageCondition

    The non-default conditions under which any new samples generated by this experiment should be stored after the protocol is completed. If left unset, the new samples will be stored according to their Models' DefaultStorageCondition.
    Default Value: Null
    Pattern Description: {AmbientStorage, EnclosedAmbientStorage, Refrigerator, Freezer, DeepFreezer, CryogenicStorage, YeastIncubation, YeastShakingIncubation, BacterialIncubation, BacterialShakingIncubation, MammalianIncubation, ViralIncubation, CrystalIncubation, AcceleratedTesting, IntermediateTesting, LongTermTesting, UVVisLightTesting} or Disposal or Null.
    Programmatic Pattern: (Null | (Alternatives[SampleStorageTypeP | Disposal])) | Null
    Index Matches to: Sample

    Transfer Technique

    ReversePipetting

    Indicates if additional source sample will be aspirated (past the first stop of the pipette) to reduce the chance of bubble formation when dispensing into the destination position. This option can only be set if Preparation->Manual.
    Default Value: Automatic
    Default Calculation: Automatically set to True if the source or destination sample has the ReversePipetting field set and the transfer is occurring via pipette.
    Pattern Description: True or False or Null.
    Programmatic Pattern: ((Null | BooleanP) | Automatic) | Null
    Index Matches to: Sample

    SlurryTransfer

    Indicates if the source sample should be mixed via pipette until it becomes homogeneous, up to MaxNumberOfAspirationMixes times.
    Default Value: Automatic
    Default Calculation: Automatically set to True if the SampleHandling of the source sample is set to Slurry.
    Pattern Description: True or False or Null.
    Programmatic Pattern: ((Null | BooleanP) | Automatic) | Null
    Index Matches to: Sample

    AspirationMix

    Indicates if the source sample will be mixed immediately before it is transferred into the destination sample.
    Default Value: Automatic
    Default Calculation: Automatically set to True if any of the other AspirationMix options are set. Otherwise, set to Null.
    Pattern Description: True or False.
    Programmatic Pattern: BooleanP | Automatic
    Index Matches to: Sample

    DispenseMix

    Indicates if the destination sample will be mixed immediately after the source sample is transferred into the destination sample.
    Default Value: Automatic
    Default Calculation: Automatically set to True if any of the other DispenseMix options are set. Otherwise, set to Null.
    Pattern Description: True or False.
    Programmatic Pattern: BooleanP | Automatic
    Index Matches to: Sample

    AspirationMixVolume

    The volume that will be repeatedly aspirated and dispensed via pipette from the source sample in order to mix the source sample immediately before the transfer occurs. The same pipette and tips used in the transfer will be used to mix the source sample.
    Default Value: Automatic
    Default Calculation: Automatically set to 1/2 the volume of the source sample or the maximum volume of the pipette being used, depending on which value is smaller.
    Pattern Description: Greater than or equal to 0 microliters and less than or equal to 50 milliliters or Null.
    Programmatic Pattern: ((Null | RangeP[0*Microliter, 50*Milliliter]) | Automatic) | Null
    Index Matches to: Sample

    NumberOfAspirationMixes

    The number of times the source is quickly aspirated and dispensed to mix the source sample immediately before it is transferred into the destination.
    Default Value: Automatic
    Default Calculation: Automatically set to 5 if any of the other AspirationMix options are set. Otherwise, set to Null.
    Pattern Description: Greater than or equal to 0 and less than or equal to 50 in increments of 1 or Null.
    Programmatic Pattern: ((Null | RangeP[0, 50, 1]) | Automatic) | Null
    Index Matches to: Sample

    MaxNumberOfAspirationMixes

    The number of times the source is quickly aspirated and dispensed to mix the source sample immediately before it is transferred into the destination.
    Default Value: Automatic
    Default Calculation: Automatically set to 5 if any of the other AspirationMix options are set. Otherwise, set to Null.
    Pattern Description: Greater than or equal to 0 and less than or equal to 100 in increments of 1 or Null.
    Programmatic Pattern: ((Null | RangeP[0, 100, 1]) | Automatic) | Null
    Index Matches to: Sample

    DispenseMixVolume

    The volume that will be repeatedly aspirated and dispensed via pipette from the destination sample in order to mix the destination sample immediately after the transfer occurs. The same pipette and tips used in the transfer will be used to mix the destination sample.
    Default Value: Automatic
    Default Calculation: Automatically set to 1/2 the volume of the destination sample or the maximum volume of the pipette being used, depending on which value is smaller.
    Pattern Description: Greater than or equal to 0 microliters and less than or equal to 50 milliliters or Null.
    Programmatic Pattern: ((Null | RangeP[0*Microliter, 50*Milliliter]) | Automatic) | Null
    Index Matches to: Sample

    NumberOfDispenseMixes

    The number of times the destination is quickly aspirated and dispensed to mix the destination sample immediately after the source is dispensed.
    Default Value: Automatic
    Default Calculation: Automatically set to 5 if any of the other DispenseMix options are set. Otherwise, set to Null.
    Pattern Description: Greater than or equal to 0 and less than or equal to 50 in increments of 1 or Null.
    Programmatic Pattern: ((Null | RangeP[0, 50, 1]) | Automatic) | Null
    Index Matches to: Sample

    SterileTechnique

    Indicates if sterilized instruments and aseptic transfer environments must be used for the transfer. Aseptic transfer environments include biosafety cabinets as TransferEnvironment, or bioSTAR and microbioSTAR Hamilton enclosures as WorkCell. Please consult the ExperimentTransfer documentation for a full diagram of SterileTechnique that is employed by operators.
    Default Value: Automatic
    Default Calculation: Automatically set to True if the samples being transferred contain tissue culture or microbial components, or require aseptic techniques.
    Pattern Description: True or False.
    Programmatic Pattern: BooleanP | Automatic
    Index Matches to: Sample

    RNaseFreeTechnique

    Indicates that RNase free technique will be followed when performing the transfer (spraying RNase away on surfaces, using RNaseFree tips, etc.).
    Default Value: Automatic
    Default Calculation: Automatically set to True if the samples being transferred are RNaseFree->True.
    Pattern Description: True or False.
    Programmatic Pattern: BooleanP | Automatic
    Index Matches to: Sample

    Hermetic Transfers

    BackfillGas

    The inert gas that is used equalize the pressure in the source's hermetic container while the transfer out of the source's container occurs.
    Default Value: Automatic
    Default Calculation: Automatically set to Nitrogen if the source's container is hermetic and UnsealHermeticSource->False.
    Pattern Description: Nitrogen or Argon or Null.
    Programmatic Pattern: ((Null | (Nitrogen | Argon)) | Automatic) | Null
    Index Matches to: Sample

    BackfillNeedle

    The needle used to backfill the source's hermetic container with BackfillGas.
    Default Value: Automatic
    Default Calculation: Automatically set to the same model of Needle that will be used to perform the transfer, if the source's container is hermetic and UnsealHermeticSource->False.
    Pattern Description: An object of type or subtype Model[Item, Needle] or Object[Item, Needle] or Null.
    Programmatic Pattern: ((Null | ObjectP[{Model[Item, Needle], Object[Item, Needle]}]) | Automatic) | Null
    Index Matches to: Sample

    UnsealHermeticSource

    Indicates if the source's hermetic container will be unsealed before sample is transferred out of it.
    Default Value: Automatic
    Default Calculation: Automatically set to True if it is indicated that a syringe/needle will not be used to perform the transfer and the source is in a hermetic container. Otherwise, is set to False.
    Pattern Description: True or False or Null.
    Programmatic Pattern: ((Null | BooleanP) | Automatic) | Null
    Index Matches to: Sample

    Tip Rinsing

    TipRinse

    Indicates if the Tips will first be rinsed with a TipRinseSolution before they are used to aspirate from the source sample.
    Default Value: Automatic
    Default Calculation: Automatically set to True if any of the other TipRinse options are set. Otherwise, is set to False.
    Pattern Description: True or False or Null.
    Programmatic Pattern: ((Null | BooleanP) | Automatic) | Null
    Index Matches to: Sample

    TipRinseSolution

    The solution that the Tips will be rinsed before they are used to aspirate from the source sample.
    Default Value: Automatic
    Default Calculation: Automatically set to Model[Sample, "Milli-Q water"] if any of the other TipRinse options are set. Otherwise, is set to Null.
    Pattern Description: An object of type or subtype Model[Sample] or Object[Sample] or a prepared sample or Null.
    Programmatic Pattern: ((Null | (ObjectP[{Model[Sample], Object[Sample]}] | _String)) | Automatic) | Null
    Index Matches to: Sample

    TipRinseVolume

    The volume of the solution that the Tips will be rinsed before they are used to aspirate from the source sample.
    Default Value: Automatic
    Default Calculation: Automatically set to 125% of the volume to be transferred, or the MaxVolume of the Tips (which ever is smaller) if any of the other TipRinse options are set. Otherwise, is set to Null.
    Pattern Description: Greater than 0 liters or Null.
    Programmatic Pattern: ((Null | GreaterP[0*Liter]) | Automatic) | Null
    Index Matches to: Sample

    NumberOfTipRinses

    The number of times that the Tips will be rinsed before they are used to aspirate from the source sample.
    Default Value: Automatic
    Default Calculation: Automatically set to 1 if any of the other TipRinse options are set. Otherwise, is set to Null.
    Pattern Description: Greater than 0 in increments of 1 or Null.
    Programmatic Pattern: ((Null | GreaterP[0, 1]) | Automatic) | Null
    Index Matches to: Sample

    Mixing

    AspirationMixType

    The type of mixing that will occur immediately before aspiration from the source container. Swirl has the operator place the container on the surface of the TransferEnvironment and perform NumberOfAspirationMixes clockwise rotations of the container. Pipette performs NumberOfAspirationMixes aspiration/dispense cycle(s) of AspirationMixVolume using a pipette. Tilt changes the angle of the container to (1) 0 AngularDegrees, (2) 10 AngularDegrees, (3) 0 AngularDegrees, a total of NumberOfAspirationMixes times on a Hamilton integrated tilt plate position. Swirl is only available when Preparation->Manual and Tilt is only available when Preparation->Robotic.
    Default Value: Automatic
    Default Calculation: Automatically set to Pipette if any of the other AspirationMix options are set and we're using a pipette to do the transfer. Otherwise, set to Null.
    Pattern Description: Swirl, Pipette, or Tilt or Null.
    Programmatic Pattern: ((Null | (Swirl | Pipette | Tilt)) | Automatic) | Null
    Index Matches to: Sample

    DispenseMixType

    The type of mixing that will occur immediately after the sample is dispensed into the destination container. Swirl has the operator place the container on the surface of the TransferEnvironment and perform NumberOfDispenseMixes clockwise rotations of the container. Pipette performs NumberOfDispenseMixes aspiration/dispense cycle(s) of DispenseMixVolume using a pipette. Tilt changes the angle of the container to (1) 0 AngularDegrees, (2) 10 AngularDegrees, (3) 0 AngularDegrees, a total of NumberOfDispenseMixes times on a Hamilton integrated tilt plate position. Swirl is only available when Preparation->Manual and Tilt is only available when Preparation->Robotic.
    Default Value: Automatic
    Default Calculation: Automatically set to Pipette if any of the other DispenseMix options are set and we're using a pipette to do the transfer. Otherwise, set to Null.
    Pattern Description: Swirl, Pipette, or Tilt or Null.
    Programmatic Pattern: ((Null | (Swirl | Pipette | Tilt)) | Automatic) | Null
    Index Matches to: Sample

    Intermediate Decanting

    IntermediateDecant

    Indicates if the source will need to be decanted into an intermediate container in order for the precise amount requested to be transferred via pipette. Intermediate decants are necessary if the container geometry prevents the Instrument from reaching the liquid level of the sample in the container (plus the delta of volume that is to be transferred). The container geometry is automatically calculated from the inverse of the volume calibration function when the container is parameterized upon receiving. This option will be set to Null if Preparation->Robotic.
    Default Value: Automatic
    Default Calculation: Automatically set to True if the source is in a container that in a container that is pipette-inaccessible and the Instrument set to perform the transfer is a pipette.
    Pattern Description: True or False or Null.
    Programmatic Pattern: ((Null | BooleanP) | Automatic) | Null
    Index Matches to: Sample

    IntermediateContainer

    The container that the source will be decanted into in order to make the final transfer via pipette into the final destination.
    Default Value: Automatic
    Default Calculation: Automatically set to the PreferredContainer[...] of the volume that is being transferred if IntermediateDecant->True.
    Pattern Description: An object of type or subtype Model[Container] or Object[Container] or a prepared sample or Null.
    Programmatic Pattern: ((Null | (ObjectP[{Model[Container], Object[Container]}] | _String)) | Automatic) | Null
    Index Matches to: Sample

    Temperature Conditions

    SourceTemperature

    Indicates the temperature at which the source sample will be at during the transfer. When samples are transferred off of the operator cart and into the TransferEnvironment, they are placed in a portable heater/cooler to get the sample to temperature right before the transfer occurs. Note that this is different than the TransportCondition of the sample.
    Default Value: Automatic
    Default Calculation: Automatically set to the TransferTemperature or TransportTemperature (whichever is first filled out) of the source sample. Otherwise, is transferred at Ambient temperature.
    Pattern Description: Ambient or greater than or equal to -20 degrees Celsius and less than or equal to 90 degrees Celsius or Null.
    Programmatic Pattern: ((Null | (RangeP[$MinIncubationTemperature, 90*Celsius] | Ambient)) | Automatic) | Null
    Index Matches to: Sample

    SourceEquilibrationTime

    The duration of time for which the samples will be heated/cooled to the target SourceTemperature.
    Default Value: Automatic
    Default Calculation: Automatically set to 5 Minute if SourceTemperature is not set to Ambient.
    Pattern Description: Greater than or equal to 0 minutes and less than or equal to 72 hours or Null.
    Programmatic Pattern: ((Null | RangeP[0*Minute, $MaxExperimentTime]) | Automatic) | Null
    Index Matches to: Sample

    MaxSourceEquilibrationTime

    The maximum duration of time for which the samples will be heated/cooled to the target SourceTemperature, if they do not reach the SourceTemperature after SourceEquilibrationTime. MaxSourceEquilibrationTime will only be used if SourceEquilibrationCheck is set, in order to extend the equilibration time past the initial SourceEquilibrationTime if SourceTemperature has not been reached. Performing an equilibration check will require stopping the experiment and verifying the temperature before moving on; this may add experiment time and may result in loss of sample through evaporation, and is only recommended for use in cases where temperature precision or temperature data is required.
    Default Value: Automatic
    Default Calculation: Automatically set to 30 Minute if SourceEquilibrationCheck is set.
    Pattern Description: Greater than or equal to 0 minutes and less than or equal to 72 hours or Null.
    Programmatic Pattern: ((Null | RangeP[0*Minute, $MaxExperimentTime]) | Automatic) | Null
    Index Matches to: Sample

    SourceEquilibrationCheck

    The method by which to verify the temperature of the source before the transfer is performed. Performing an equilibration check will require stopping the experiment and verifying the temperature before moving on; this may add experiment time and may result in loss of sample through evaporation, and is only recommended for use in cases where temperature precision or temperature data is required.
    Default Value: Automatic
    Default Calculation: Automatically set to Null.
    Pattern Description: ImmersionThermometer or IRThermometer or Null.
    Programmatic Pattern: ((Null | EquilibrationCheckP) | Automatic) | Null
    Index Matches to: Sample

    DestinationTemperature

    Indicates the temperature at which the destination will be at during the transfer. When samples are transferred off of the operator cart and into the TransferEnvironment, they are placed in a portable heater/cooler to get the sample to temperature right before the transfer occurs. Note that this is different than the TransportCondition of the sample.
    Default Value: Automatic
    Default Calculation: Automatically set to the TransferTemperature or TransportTemperature (whichever is first filled out) of the destination sample. Otherwise, is transferred at Ambient temperature.
    Pattern Description: Ambient or greater than or equal to -20 degrees Celsius and less than or equal to 90 degrees Celsius or Null.
    Programmatic Pattern: ((Null | (RangeP[$MinIncubationTemperature, 90*Celsius] | Ambient)) | Automatic) | Null
    Index Matches to: Sample

    DestinationEquilibrationTime

    The duration of time for which the samples will be heated/cooled to the target DestinationTemperature.
    Default Value: Automatic
    Default Calculation: Automatically set to 5 Minute if DestinationTemperature is not set to Ambient.
    Pattern Description: Greater than or equal to 0 minutes and less than or equal to 72 hours or Null.
    Programmatic Pattern: ((Null | RangeP[0*Minute, $MaxExperimentTime]) | Automatic) | Null
    Index Matches to: Sample

    MaxDestinationEquilibrationTime

    The maximum duration of time for which the samples will be heated/cooled to the target DestinationTemperature, if they do not reach the DestinationTemperature after DestinationEquilibrationTime. MaxDestinationEquilibrationTime will only be used if DestinationEquilibrationCheck is set, in order to extend the equilibration time past the initial DestinationEquilibrationTime if DestinationTemperature has not been reached. Performing an equilibration check will require stopping the experiment and verifying the temperature before moving on; this may add experiment time and may result in loss of sample through evaporation, and is only recommended for use in cases where temperature precision or temperature data is required.
    Default Value: Automatic
    Default Calculation: Automatically set to 30 Minute if DestinationEquilibrationCheck is set.
    Pattern Description: Greater than or equal to 0 minutes and less than or equal to 72 hours or Null.
    Programmatic Pattern: ((Null | RangeP[0*Minute, $MaxExperimentTime]) | Automatic) | Null
    Index Matches to: Sample

    DestinationEquilibrationCheck

    The method by which to verify the temperature of the destination before the transfer is performed. Performing an equilibration check will require stopping the experiment and verifying the temperature before moving on; this may add experiment time and may result in loss of sample through evaporation, and is only recommended for use in cases where temperature precision or temperature data is required.
    Default Value: Automatic
    Default Calculation: Automatically set to Null.
    Pattern Description: ImmersionThermometer or IRThermometer or Null.
    Programmatic Pattern: ((Null | EquilibrationCheckP) | Automatic) | Null
    Index Matches to: Sample

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. Please note that public samples are weighed regardless of the value of this option.
    Default Value: Automatic
    Pattern Description: True or False or Null.
    Programmatic 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. Please note that public samples are volume measured regardless of the value of this option.
    Default Value: Automatic
    Pattern Description: True or False or Null.
    Programmatic 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. Please note that public samples are imaged regardless of the value of this option.
    Default Value: Automatic
    Pattern Description: True or False or Null.
    Programmatic Pattern: (BooleanP | Automatic) | Null

Example Calls

    Fill to volume parameters

    To specify the volume to which the sample should be filled and the solvent with which to do it, set the TotalVolume and Solvent options:
    Indicate allowed tolerance of the final volume with the Tolerance option. If using a volumetric flask, automatically set to the precision of the flask itself:

    Sample handling

    Specify how the destination container should be mixed after solvent addition:
    Specify the location where the fill to volume will occur with the TransferEnvironment option:
    If transferring from a hermetically sealed container, specify a variety of options such as whether to uncap the source container or what the backfill gas is:

Preferred Input Containers

    Volumetric Flasks
    Ultrasonic Compatible Containers

Warnings and Errors

    Messages
Last modified on Wed 8 Oct 2025 12:56:54

EMERALD CLOUD LAB
15500 Wells Port Drive
Austin, TX 78728
© 2025 Emerald Cloud Lab, Inc.