Location element

This Location element appears in the Device XML block, in the LocationVector XML block, and in the StorageLocation XML block. See “Device XML block” , “LocationVector XML block” , “StorageLocation XML block” , and “StorageLocation XML block” .

Depending on the XML block that contains it, the Location element provides certain information about a location.

Device XML block: Each Location element contains the name of a location on the device where labware can be placed.

LocationVector XML block: The Location element contains information about the external location.

StorageLocation XML block: The Location element contains information about the location on the storage device.

Group attribute

The Group attribute is a bitmask that defines a location grouping for this device.

Grouping creates mutually exclusive locations on a device, that is, only one labware can be at a location in the group at a time. To enable this behavior, the Group attribute must be set to a value other than 0.

To determine which value to use, do a bitwise inclusive OR operation on all the groups to which the location should belong. For example, if a location belongs to group 1 and group 2, the value to use is 3.

Possible values:

0 = Not exclusive

1 = group 1

2 = group 2

4 = group 3

8 = group 4

16 = group 5

32 = group 6

64 = group 7

128 = group 8

256 = group 9

512 = group 10

MAXDWORD = Exclusivity all

Required: No

Default value: 0

MaxStackHeight attribute

The MaxStackHeight attribute is the maximum height to which a stack of labware is allowed to grow on a device. To determine the number of labware in a stack, divide the stack height by the thickness of the labware.

This attribute is used by stacker devices that return Location elements to define the stack locations.

The MaxStackHeight attribute is only checked when the value of the Type attribute is 2.

Required: No

Default value: 460.0

Name attribute

The Name attribute contains the name of the location on the device where labware can be placed.

Required: Yes

Offset attribute

The Offset attribute is the pick/place height offset, or the delid/relid approach height.

Required: No

Default value: 0.0

Type attribute

The Type attribute is a bitmask that represents the type of access for the location.

To determine the value to use, do a bitwise inclusive OR operation on all the access types for the location.

Possible values:

0 = No labware are allowed at this location.

1 = Labware are allowed to be moved to this location.

2 = Labware are allowed to be stacked at this location.
Adds the Stack Height property to the Location Properties area for a device. This value is used for stack locations only.

4 = Labware are allowed to be moved into and out of the system at this location.

8 = Labware are allowed to be incubated at this location.

16 = Labware are allowed to be delidded/relidded at this location.

32 = Labware are allowed to be moved into the system at this location.

64 = Labware are allowed to be moved out of the system at this location.

128 = A robot is allowed to move a labware into a waste bin at this location.

256 = Labware are allowed to be mounted at this location.

512 = Static labware are allowed to be assigned to this location.

1024 = Only the Centrifuge Loader robot is allowed to access the buckets of the Centrifuge Loader at this location, so private bucket locations are hidden in the device manager.

MAXDWORD = All labware are allowed at this location.

Required: No

Default value: 1