Storage Map
Display map of a storage


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

Before start

Here are required settings at Labii to enable Storage Map to work:
  • Tables:
    • storage - the storage table
    • samples, reagents, etc. - other tables that are using storage
  • Columns
    • storage/parent - the parent storage of the current storage
    • storage/columns - number of columns in the storage
    • storage/rows - number of rows in the storage
    • storage/storage_coordinates - the position of the current storage in the parent storage
    • samples, reagent, etc/storage - a ForeignKey to point to the storage table
    • samples, reagent, etc/storage_coordinates - the position of the item in the location Note: Add metadata for the storage_coordinates column: COLUMN_IDENTIFY=storage_map-storage_coordinates
Create a table with the type Storage 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 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 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 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 a number, and Column as a letter) and 96-well plate layout (Row as a letter, Column as number) have the opposite means of B3. Please make sure to use the correct layout. Default to "Letter as column".


There are a few columns that 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 layouts below to meet your requirement.
  • Letter as a column: C2 as row 2 column 3
  • Letter as a 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 storages, samples, reagents, etc.) inside each cell. Each item is clickable, and more details can be revealed on the new tab.

Add to the storage

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


The map can be downloaded by clicking the Download button.