Skip to end of metadata
Go to start of metadata

Login Screen

The following is a screenshot of the TIGER-LC Application Login interface (the interface that is displayed when the application is first launched):

Subject Creation

Once successfully logged in, click "Subject" from the list of menu items at the head of the interface. The following is displayed:

As part of the User Creation, a Patient ID is generated, following a strict set of guidelines.

Each Patient ID is 10 alpha numeric characters in length.

  • Characters 1 through 2 - these characters represent the patient's status. Selecting the proper status from the available drop down list automatically appends the appropriate characters to the ID
  • Characters 3 through 4 - The next two characters represent source. These are free text CHARACTERS only. Numbers are not permitted and exactly 2 characters (no less, no more) are required
  • Characters 5 through 6 - The next two characters represent year. These are free text NUMBERS only. Characters are not permitted and exactly 2 numbers (no less, no more) are required.
  • Characters 7 through 10 - the last four characters represent a 4-digit identification number for the patient. These are free text NUMBERS only. Characters are not permitted and exactly 4 (no less, no more) are required.

See illustration below:

Assigning an Active Subject

When entering data in any of the interfaces in this application, the Subject (patient registered on the Study) MUST be known. Therefore, a common theme for "assigning" an active subject has been incorporated at the head of each interface.

When the user first logs in (even if a new patient has just been created), he/she must assign an active subject. See the following illustration:

Click the "assign" text and the following dialog is displayed:

Here, a list of patient ID's (created at the Subject Creation page) is displayed for the User to choose from.

Once chosen, any data that may have already been entered for that patient (specific to the current UI) is extracted from the data store and presented.

Now that a subject has been chosen, this subject will remain the "active" subject as the user navigates from one interface to another. The user may "change" the active subject at anytime.

NOTE: A subject MUST be chosen before entering data. Not doing so will cause all data entered in the UI to be lost.

Record Epidemiology Interface

The Record Epidemiology interface is intended to serve as a data entry point for all data collected on the associated epidemiology paper forms as well as additional information captured on the paper-based coversheet. The interface form itself is divided into several sections:

  • TREATMENT - basic treatment information entered from the paper-based coversheet
  • GENERAL - general patient information (height, weight, ethnic background, etc)
  • EDUCATION AND OCCUPATION - history and level of education, place(s) of occupation
  • HOMETOWN AND ENVIRONMENT - hometown information, eating lifestyle, tobacco habits
  • HEALTH - history of illness, pregnancies
  • FAMILY HISTORY - family history of cancer(s)
  • CONCLUDING STATEMENT - patient interview-specific information

Epidemiology - Treatment Section

Epidemiology - General Section

Epidemiology - Education and Occupation Section

Epidemiology - Hometown and Environment Section

Epidemiology - Health Section

Epidemiology - Family History Section

Epidemiology - Concluding Statement Section

Lab Results Interface

Storage Management

The intent of the storage management portion of this application is to provide users with nearly the same level of flexibility for creating containers, storing containers and storing biomaterials as in the Labmatrix interface itself. All containers created via the interface are represented graphically by 2-d squares, each square representing a series of rows and columns for that particular storage container.


Consider a typical Freezer which has (4) shelves. This container will be represented as a 2-d square with 1 column and 4 rows (see below):

Consider a vial storage box to be stored in one of the Liquid Nitrogen tanks. Each box consists of 10 columns and 10 rows:

storage status and color codes

Each cell (a single square within any of the 2-d storage container images) can (under most circumstances) be one of three colors: gray, red or green

Color Code


A gray cell represents a vacant cell. This means nothing (no child containers, no biomaterials) has been stored in this particular cell

A green cell represents an available cell. This means that, somewhere down the line, there exists some open space to store at least one biomaterial or one new child storage container.

A red cell represents a completely occupied (full) cell. This means that either (1) a biomaterial occupies this cell or (2) a completely full child container occupies this space.

the interface

Before any containers can be created or any biomaterials can be stored, the user must first choose a top-level container to work with. In the case of the TIGER-LC storage facility, the top level containers consist of Liquid Nitrogen Tanks and Freezers:

Choosing a top level container (in this example, a TIGERLC Freezer) and clicking "get location info" results in the following:

Note the table of information to the right of the container image:

  • Container Name: The name of the displayed container
  • Container ID: The ID of the displayed container (auto assigned by Labmatrix)
  • Biomaterial Barcode: Barcode of the selected biomaterial (discussed in more detail later)
  • Biomaterial ID: ID of the selected Biomaterial (auto assigned by Labmatrix) - (discussed in more detail later)
  • Specimen Barcode: the entry field for scanning the barcode of a Biomaterial to be stored in a container
  • "delete this container" deletes the current container
  • "remove specimen" removes the selected Biomaterial from the current storage location
creating a new storage location

In this example, the chosen Freezer is completely empty. All cells (shelves in this case) are vacant. Suppose the user wants to add a new tower to the third shelf of this freezer. Based on the specific storage requirements, this chosen shelf could be set to support either (5) towers of one type or (10) towers of another. Click on the third cell of the freezer image, and the following dialog pops up:

Clicking "Cancel" brings the user back to the same interface. Clicking "OK" proceeds with child container creation. However, a new dialog box pops up allowing the user to choose from a list of possible freezer shelf layouts. In this case, two options exist. The first is a shelf of (10) spaces allowing for (10) 4-slot towers to be stored on this shelf. The other format is a shelf of (5) spaces allowing for (5) 3 (or 2) slot towers.

Simply click on the row of the desired shelf configuration...

click Continue...

Note the new container is a "shelf" container. Until now, the actual shelf configuration (which is variable until it's actually chosen) becomes the next-level-down storage container in the 3rd position of its parent freezer container.

Now create a tower.

  1. Click on the first column (row1 1, column 1) of the image
  2. Click OK at the container creation dialog box
  3. The following dialog appears

When adding a new tower container to a 5-tower capacity shelf, the user has two available options: a (2) slot tower or a (3) slot tower. Choose a (3) slot tower and click "Continue"

Create a new container in slot 1 (there is only one possible configuration option for containers stored in all freezer towers)...

Lastly, create the final container (a 9x9 box) in row 1, column 1 of this (4) slot storage container...

storing a biomaterial

Storing a barcoded biomaterial is a simple matter of (1) scanning the barcode into the "SPECIMEN BARCODE" entry field to the right of the container image and clicking on the desired VACANT container cell.

Scan the barcode...

Click the desired cell in the current storage container (in this case, the 9x9 box created in the above example)...

(info) Hovering the mouse over any cell will reveal a pop up 'tip strip" that will reveal the barcode of any stored Biomaterial, the ID of any child container or simply "VACANT" for gray colored cells.

remove a biomaterial from storage

To remove a biomaterial from any storage location, simply click on the specific container cell where the biomaterial is stored...

Next, click "remove specimen". The cell will return to its VACANT state.

(warning) Note this does NOT delete the Biomaterial from the database. It simply disassociates it from this storage location.

Last updated by Lemieux, Christopher (NIH/NCI) [C] on Mar 17, 2011