- Specimen functionality is a legacy feature available with Premium Editions of LabKey Server. For new installations, we recommend using Sample Manager
instead. Learn more
or contact LabKey
Specimen Quality Control provides row-level flagging of data for quality control during specimen import. Conflicting information during import of specimen data will automatically trigger a flag, the conflicting column will be left blank, and the row will have color highlighting on specimen grids for all users.
In addition to this automated flagging, administrators can enable Manual QC flagging/unflagging
and let other users with appropriate permissions manually set or unset QC flags. Once a vial's QC state has been set manually, it will no longer be updated automatically during the import process.
Guidelines for Flagging
Conflicting information on specimen data will trigger a flag, the conflicting column will be left blank, and the row will have color highlighting. Example flag situations:
- An imported specimen's globalUniqueID is associated with more than one primary type, as could occur if a clinic and repository entered different information pre- and post-shipment.
- A single sample is simultaneously at multiple locations, which can occur in normal operations when an information feed from a single location is delayed, but in other cases may indicate an erroneous or reused globalUniqueID on a vial or other aliquot.
- Conflicting Draw Timestamps are detected. See below for more about this case.
Primary specimens that meet user-specified protocol-specific criteria can also be flagged. Examples of QC problems that could be detected with this method include:
- A saliva specimen present in a protocol that only collects blood (indicating a possibly incorrect protocol or primary type).
- Primary specimen aliquoted into an unexpectedly large number of vials, based on protocol expectations for specimen volume (indicating a possibly incorrect participantID, visit, or type for the specimen).
Note that the tools refer to "vial" for a specimen aliquot, but in the case of tissue blocks or other divisions, the specimen sample may not actually be a vial.
Enable Manual QC Flagging
An administrator can enable or disable manual QC flagging; when enabled, specimen coordinators are also authorized to set manual QC flags.
- Click the Manage tab.
- Under Specimen Repository Settings, click Manage Display and Behavior.
- Set the Manual QC flagging/unflagging dropdown to Enabled.
- Click Save.
Work With Specimen QC Flags
Enable Specimen QC
To enable Specimen QC, go to a specimen grid and click Enable Comments/QC
The button you clicked will become a dropdown menu titled Comments And QC
. To disable, select Exit Comments and QC mode
from this menu.
Change Quality Control Flags
Review Flagged Vials
To filter to the set of rows with QC flags, scroll to find the Quality Control Flag
column and filter on true
. You can also save a custom grid
with this filter if you want to make it easy to quickly retrieve flagged vials.
Flagging Draw Timestamp Discrepancies
The Draw Timestamp for a specimen vial is expected to remain constant over time. However, as specimens are moved among labs sometimes the time portion is lost. Also, occasionally time corrections are made to the repository but it is difficult to change all events associated with a specimen. Whenever the Draw Timestamp differs among events the specimen is flagged with a QC flag and the Draw Timestamp is not shown.
To provide more information about possible discrepancies, upon import to the SpecimenEvent table, the DrawTimestamp field value is used to generate new DrawDate and DrawTime fields in the Vial and Specimen tables (the SpecimenEvent table retains the existing DrawTimestamp field only). QC Flagging will apply individually to the DrawDate and DrawTime fields on the Vial table, allowing the administrator to still import the row but be able to determine whether the discrepancy is significant.
For more information about quality control settings for study datasets, see Dataset QC States - Admin Guide