Location Map

Display map of a location


When a location is created to manage the samples, it is critical to know what is stored at each location. The Location Map at Labii ELN & LIMS provides such functions. The widget shall only used in the Location table.

Before start

Here are required settings at Labii to enable Location Map to work:

  • Tables:

    • location - the location table

    • samples, reagents, etc. - other tables that are using location

  • Columns

    • location/parent - the parent location of the current location

    • location/columns - number of columns in the location

    • location/rows - number of rows in the location

    • location/position - the position of the current location in parent location

    • samples, reagent, etc/location - a ForeignKey to point to location table

    • samples, reagent, etc/position - the position of the item in the location

Create a table with type Location can create all required tables/columns automatically.


Labii accepts the position in the following format:

  • RxCx, wheres, R as Row, and C as Column. For example R2C3, means the row 2 and column 3. It supports all layout methods, see below.

  • Xx, wheres, X as Row, and x as Column. For example B3, means the row 2 and column 3. Use "Letter as row" to display the layout correctly. This mostly used for place layout.

  • Xx, wheres, X as Column, and x as Row. For example B3, means the row 3 and column 2. Use "Letter as column" or "Letter as row and column" to display the layout correctly.

The excel layout (Row as number, and Column as letter) and 96-well plate layout (Row as letter, Column as number) have the opposite means of B3. Please make sure to use correct layout. Default to "Letter as column".


There are a few columns need to be provided before the widget can work properly.

  • rows

  • columns

  • layout

Click the edit icon to select the correct columns for the rows and columns.


The widget will convert any position data into the layout. Choose one of the layout below to meet your requirement.

  • Letter as column: C2 as row 2 column 3

  • Letter as row: C2 as row 3 column 2. For plate.

  • Letter as both row and column: R3C2 as row 3 column 2

View what's inside

Once set up, the widget will show all items (other locations, samples, reagents, etc.) inside each cell. Each of item is clickable, and more details can be revealed on the new tab.

Add to the location

Click "+" inside a cell to add a location/sample/reagent/etc to the location, the window will return back once added.


The map can be downloaded via clicking the Download button.