Skip to main content

Using Custom Liquid Policies on your Hamilton Microlab Star®

The following document goes over which liquid policy consequences are applicable to use when executing on a Hamilton Star® system.

Updated over 8 months ago

For a general overview of using liquid policies with Synthace, click here.

For information on how to use a custom liquid policy spreadsheet, click here.

For information on how to add a liquid handling policy to an element, click here.

Aspirate Reference

Specifies where in the container aspiration will occur. Appropriate input values are well_bottom, well_top, or liquid_level. For aspiration LLD to work, liquid_level must be specified as Aspirate Reference. When specifying liquid_level, Synthace can override this decision if the liquid height is not much more than 1-2 mm, Synthace will automatically default to using well_bottom instead.

Aspirate Offset

Specifies vertical (Z) position for aspirating. Can include both positive and negative values, upwards is always positive. Input must include unit of measurement (um, mm, m). Example inputs: -0.5 mm or 1.5 mm. If you plan on using LLF, it is recommended that this value should be set to -4 mm such that the tip goes into the liquid from the liquid level. The offset cannot be larger than 10 mm.

Aspirate LLD

Turns on liquid level detection during aspiration. Appropriate inputs are on, off, or auto. If Synthace determines that liquid volume is too low from the input container, LLD will automatically be overridden and Synthace will instead aspirate from the bottom of the well (see Aspirate Zone for details). When specifying auto, Synthace will defer to the value that is set in the Aspirate Reference.

Aspirate LLF

Turns on liquid level following during aspiration. Appropriate inputs are on, off, or auto. For Aspirate LLF to function properly, set a negative Aspirate Offset.

Dispense Reference

Specifies where in the container dispense pipetting will occur. Appropriate input values are well_bottom, well_top, or liquid_level. For dispense LLD to work, liquid_level must be specified as Dispense Reference. Note for dispense LLD to work during the execution, there must be enough liquid in the container prior to dispensing.

Dispense Offset

Specifies vertical (Z) position for dispensing. Can include both positive and negative values, upwards is always positive. Input must include unit of measurement (um, mm, m). Example inputs: -0.5 mm or 1.5 mm etc. If you plan on using LLF, it is recommended that this value should be set to -4 mm such that the tip goes into the liquid from the liquid level. The offset cannot be larger than 10 mm.

Dispense LLD

Turns on liquid level detection during aspiration. Appropriate inputs are on, off, or auto. Ensure that liquid is present in the well before dispensing otherwise Synthace will error.

Dispense LLF

Turns on liquid level following during dispensing. Appropriate inputs are on, off, or auto. For Dispense LLF to function properly, set a negative Dispense Offset.

Pre-Mix Num Cycles

Specifies number of mixing cycles prior to aspiration. Appropriate inputs are positive integer values (0, 1, 5 etc.). Setting 0 as cycle number to disables mixing.

Pre-Mix Reference

Specifies where in the container mixing before aspiration will occur. Appropriate input values are well_bottom, well_top, or liquid_level.

Pre-Mix Offset

Specifies vertical (Z) position for aspirating. Can include both positive and negative values, upwards is always positive. Input must include unit of measurement (um, mm, m). Example inputs: -0.5 mm or 1.5 mm.

Pre-Mix Proxy

Proxy liquid to set when mixing before aspirating. Choose one of the following that best represents the fluid mechanical properties you are working with, either Serum, Aqueous, Ethanol, DMSO. Proxy liquid is used for liquid class matching, so the liquid class has to be present within the Liquid CO-RE editor in order for Synthace to select it.

Proxy

Proxy liquid to use for the transfer. Choose one of the following that best represents the fluid mechanical properties you are working with, either Serum, Aqueous, Ethanol, DMSO. Proxy liquid is used for liquid class matching, so the liquid class has to be present within the Liquid CO-RE editor in order for Synthace to select it.

Tip Reuse Limit

Number of times that tips will be re-used before being discarded. Clean tips will always be used when changing liquid type or if tips are contaminated by liquid handling actions. Appropriate inputs are positive integer values (0, 1, 5 etc.). Setting 0 as Tip Reuse Limit means new tips will always be used.

Allowed Tip Types

The allowed tip types for the transfer. No entries mean all tip types are allowed. The proper input format is “Hx” followed by the tip size, followed by “F” if they are filtered. Examples include “Hx1000, Hx1000F, Hx300, Hx300F, Hx50, Hx50F”.

Multi Dispense Limit

Number of multi-dispenses that may be made. Appropriate inputs are positive integer values (0, 1, 5 etc.). Setting 0 as Multi Dispense Limit means unlimited multi dispenses. Multi dispenses are not counted as tip reuse. All transfers must have the same liquid type, and tip contaminating behaviours like post-mixing must be disabled.

Liquid Class Override

Use exactly this specific liquid class. Most policy parameters are ignored when calling device specific liquid class. The liquid class must exist in the HAMILTON CO-RE Liquid Editor and the name must match exactly.

Pre-Mix Volume

Volume to use when mixing before aspirating. Input values are volume amounts, units pl, nl, ul, ml, or l are appropriate.Example inputs include (30 ul, 2 ml etc.) Volume conditions can be a function of transfer properties, e.g. Max(0.75 * SourceInitialVolume, 50 ul) is equal to three quarters of the initial volume in the source or 50ul, whichever is larger. Supported operations are multiplication (<float> * <volume>), Max(...) and Min(...). Transfer property names are case insensitive and spaces are ignored.

Post-Mix Volume

Volume to use when mixing after dispensing. Input values are volume amounts, units pl, nl, ul, ml, or l are appropriate.Example inputs include (30 ul, 2 ml etc.) Volume conditions can be a function of transfer properties, e.g. Max(0.75 * SourceInitialVolume, 50 ul) is equal to three quarters of the initial volume in the source or 50ul, whichever is larger. Supported operations are multiplication (<float> * <volume>), Max(...) and Min(...). Transfer property names are case insensitive and spaces are ignored.

Header Volume

Extra volume to aspirate from the source and discard with the tip after transferring, thus increasing the accuracy of the final dispense. If Tip reuse is enabled, it may be dispensed back to the source and re-aspirated. Appropriate inputs are volume amounts such as 30 ul, 2 ml etc. When multi dispensing, it is recommended to use a header volume.

Prewet Volume:

Extra volume to aspirate from source and immediately dispense, can increase accuracy of the first dispense. Appropriate inputs are volume amounts such as 30 ul, 2 ml etc. When multi dispensing, it is recommended to use a prewet volume.

Default Settings

These are the settings Synthace will use if no values are set in your custom liquid policy file.

Did this answer your question?