Default Luminex® assay designs include properties specific to the technology, and beyond the default properties included in General
assay designs. The general process for designing an assay is described in Design a New Assay
. A design based on the built-in defaults for Luminex is defined in the Luminex assay tutorials (Step 1: Create a New Luminex Assay Design
). This page offers additional details on the default properties defined for this type of assay.
For optional, additional properties that are used by the Luminex QC transform script, see below
, or review Review Fields for Script
If you want the assay to auto-copy results to a target study, specify that here. For more information about copying assay data to studies, see Copy Assay Data into a Study
Add any transform script here. For more information, see Transformation Scripts
Import in Background
Using this option is particularly helpful when you have large runs that are slow to upload. If this setting is enabled, assay uploads are processed as jobs in the data pipeline.
You will see the Upload Jobs
page while these runs are being processed. Your current jobs are marked "Running." When the jobs have completed, you will see "Completed" instead of "Running" for the job status for each. If you see "Error" instead of completed, you can see the log files reporting the problem by clicking on "Error." Luminex assay properties (batch, run, well role/titration settings, and analyte properties) are also written to the log file to assist in diagnosing upload problems.
When the Status
of all of your jobs is "Completed", click the Description
link for one of the runs to see all of the data for this run.
The user is prompted for batch properties once for each set of runs during import. The batch is a convenience to let users set properties once and import many runs using the same suite of properties.
Included by default:
- Participant Visit Resolver: Required. This field records the method used to associate the assay with participant/visit pairs. The user chooses a method of association during the assay import process.
- TargetStudy: Including this field simplifies copying assay data to a study, but it is not required. Alternatively, you can create a property with the same name and type at the run level so that you can then copy each run to a different study.
- Network: Enter the network.
- Species: Enter the species under study.
- LabID: The lab where this experiment was performed.
- Analysis Software: The software tool used to analyze results. For LabKey's Luminex tool, this is typically "Bioplex."
The user is prompted to enter run level properties for each imported file. These properties are used for all data records imported as part of a Run.
Included by default:
- Assay Id: If not provided, the file name is used.
- Test Date
- Replaces Previous File: Boolean
- Date file was modified
- Specimen Type
- Run Data (Required): Data files must be in the multi-sheet BioPlex Excel file format.
Well Roles and Analyte Properties
The user is prompted to select well rolls and enter properties for each of the analytes in the imported file. These properties can be helpful for tracking bead lots, analyte batches, etc.
for quality control.
Included by default:
- Well Roles for Standard, QC Control, and Other Control
- Single Point Controls
For each analyte the user enters (a checkbox allows entering the same value for all analytes for any property):
- Standard Name
- Analyte Type
- Weighting Method
- Bead Manufacturer
- Bead Dist
- Bead Catalog Number
- Use Standard: Elect whether to use the standard specified under well roles as the standard for a given analyte.
Additional analyte properties present in the data:
- PositivityThreshold: The positivity threshold.
- AnalyteWithBead: The name of the analyte including the bead number.
- BeadNumber: The bead number.
Excel File Run Properties
When the user imports a Luminex data file, the server will try to find these properties in the header and footer of the spreadsheet, and does not prompt the user to enter them.
Included by default:
- File Name
- Acquisition Date (DateTime)
- Reader Serial Number
- Plate ID
- RP1 PMT (Volts)
- RP1 Target
The user is prompted to enter data values for each row of data associated with a run.
Not included by default in the design, but should be considered:
- SpecimenID: For Luminex files, data sources are uniquely identified using SpecimenIDs, which in turn point to ParticipantID/VisitID pairs. For Luminex Assays, we automatically extract ParticipantID/VisitID pairs from the SpecimenID. If you exclude the SpecimenID field, you will have to enter SpecimenIDs manually when you copy the data to a study.
Additional Properties for the Transform Script
The LabKey Luminex transform script calculates additional values (e.g., curve fits and negative bead subtraction) that are used by the LabKey Luminex tool. Custom batch, run, analyte, and data properties used by this script are covered in these pages: Customize Luminex Assay for Script
and Review Fields for Script
. Some useful assay properties are listed here:Assay Properties
|Transform Script||--||Path to the LabKey Luminex transform script. The path provided must be specific to your server. The default path provided in a XAR will be usable only on the server where the XAR was created.|
|Import in Background||Unchecked||When selected, runs are imported in the background, allowing you to continue work on the server during import. This can be helpful for importing large amounts of data. This tutorial leaves this value unchecked merely for simplicity of workflow. For further information on what happens when you check this property, see Luminex Properties.|
|Editable Runs||Unchecked||When selected, allows run data to be edited after import by default. If you allow editing of run data, you may wish to uncheck Display > Shown In Display Modes > Update in the domain editor for each field used or calculated by the script. The script runs only on data import, so preventing later editing of such fields is necessary for calculated data to continue matching the values displayed for the fields in the assay.|