Configuration
Last updated
Last updated
The Illumina NovaSeq X Series Integration Package v1.2.0 supports the integration of Clarity LIMS to Illumina NovaSeq X series instruments.
For instructions on validating and troubleshooting the Illumina NovaSeq X Series Integration, refer to NovaSeq X Series Integration v1.2.0 User Interaction, Validation and Troubleshooting.
The configuration provided in this integration has been established to support NovaSeq X Series lab processes. Any configuration changes to protocols or workflows (including renaming protocols, steps, and fields) could break the process.
The NovaSeq X Series Integration v1.2.0 requires a valid BaseSpace Sequence Hub account with an Enterprise or Professional subscription.
The NovaSeq X Series Sequencing v1.1 workflow uses analysis configuration templates (ACTs) to configure secondary analysis for planned runs. Required ACTs must be created using BaseSpace Sequence Hub. The ACT names must be unique. The index adapter kit (the label group in Clarity LIMS) selected in the ACT is created in Clarity LIMS. The same label group must be used in the library preparation step. For more information, refer to NovaSeq X Series Integration v1.2.0 User Interaction, Validation and Troubleshooting.
Make sure that ACT names created in BaseSpace Sequence Hub do not have leading or trailing spaces. Otherwise, Clarity LIMS can have issues with recognizing the ACT names.
Samples must go through the library preparation and quantification process before they enter the NovaSeq X Series Sequencing v1.1 workflow. It is assumed that the following steps have completed before samples are assigned to the workflow:
Samples have been accessioned into Clarity LIMS.
Samples have been run through QC and library prep.
Samples have the Molarity (nM) global field set to a value.
This value is required for the Calculate Volumes automation in the Make Bulk Pool step.
Sample and library names must use only alphanumeric, dash, or underscore characters.
For more information on sample accessioning, refer to Sample Accessioning and Upload and Modify Samples in the Getting Started section of the Clarity LIMS (Clarity & LabLink Reference Guide) documentation.
You can assign samples to workflows automatically, using a routing script, or manually—from the Projects & Samples dashboard. Refer to Assign and Process Samples in the Clarity LIMS (Clarity & LabLink Reference Guide) documentation.
The NovaSeq X Series Integration Package v1.2 includes the following workflows:
NovaSeq X Series Sequencing v1.1
Library Prep Validation v2.3.2 (optional, but recommended for validation purposes)
The following describes the protocols and steps included in these workflows.
The Library Prep Validation v2.3.2 workflow allows for validation of the system after installation is complete. This workflow can be replaced by other custom library preparation workflows. For details, refer to NovaSeq X Series Integration v1.2.0 User Interaction, Validation and Troubleshooting.
Configure a custom library preparation workflow as follows.
Select Configuration, then select Lab Work.
Add a Routing Script automation to the last Master Step of the library preparation workflow.
Select Configuration, then select Automation.
Create a new Routing Script automation and update it as follows.
For Channel Name, enter limsserver.
For Command Line, enter the following script:
For Automation Use, select the custom library preparation workflow.
The Assign Analysis Configuration Template (NovaSeq X Series Sequencing v1.1) step uses ACTs to configure secondary analysis for samples. Each ACT contains details related to the secondary analysis (e.g., index adapter kit to use, reference genome setting, and so on). You can select an ACT from a list and assign samples to it. A planned run can have multiple ACTs and this step must be repeated for each ACT that is required for the run. For more information on creating ACTs and assigning samples to them, refer to NovaSeq X Series Integration v1.2.0 User Interaction, Validation and Troubleshooting.
¹ These automations are required for the NovaSeq X Series Sequencing v1.1 workflows and contain additional logic needed for CLPA support. If you would like to remove support for CLPA, contact Illumina Support.
² These automations are required for CLPA support only.
All remaining automations are required for the NovaSeq X Series Sequencing v1.1 workflows.
The following table lists the configuration details for fields that are defined on the Assign Analysis Configuration Template (NovaSeq X Series Sequencing v1.1) step.
Assign Analysis Configuration Template (NovaSeq X Series Sequencing v1.1) Master Step Field Configuration
The following table lists the global custom fields that are configured to display on the Assign Analysis Configuration Template (NovaSeq X Series Sequencing v1.1) step.
Global Field Configuration (Derived Sample)
Samples are pooled in the Make Bulk Pool (NovaSeq X Series Sequencing v1.1) step. You can manually create working pools based on the final loading concentration required.
¹These automations are required for CLPA support only.
All remaining automations are required for the NovaSeq X Series Sequencing v1.1 workflows.
The following table lists configuration details for the fields that are defined on the Make Bulk Pool (NovaSeq X Series Sequencing v1.1) step.
Make Bulk Pool (NovaSeq X Series Sequencing v1.1) Master Step Field Configuration
The following table lists the global custom fields that are configured to display on the Make Bulk Pool (NovaSeq X Series Sequencing v1.1) step.
Global Custom Fields Configuration (Derived Sample)
The Dilute and Denature (NovaSeq X Series Sequencing v1.1) step allows you to dilute pooled samples with the addition of RSB.
¹ These automations are required for the NovaSeq X Series Sequencing v1.1 workflows and contain additional logic needed for CLPA support. If you would like to remove support for CLPA, contact Illumina Support.
² These automations are required for CLPA support only.
All remaining automations are required for the NovaSeq X Series Sequencing v1.1 workflows.
The following table lists the global custom fields that are configured to display on the Dilute and Denature (NovaSeq X Series Sequencing v1.1) step.
Global Field Configuration (Derived Sample)
The Load to Library Tube Strip (NovaSeq X Series Sequencing v1.1) step allows you to scan the library tube strip barcode into Clarity LIMS. Then, you can place the working pools into the library tube strip used in the NovaSeq X Series run. This step also does the following actions:
Validates the run setup and analysis information.
Generates the sample sheet file.
Creates a planned run on Illumina Connected Analytics (ICA), depending on the selected run mode.
¹ These automations are required for the NovaSeq X Series Sequencing v1.0 workflows and contain additional logic needed for CLPA support. If you would like to remove support for CLPA, contact Illumina Support.
² These automations are required for CLPA support only.
All remaining automations are required for the NovaSeq X Series Sequencing v1.0 workflows.
The following table shows the master step fields that are configured on the Load to Library Tube Strip (NovaSeq X Series Sequencing v1.1) step. These fields are required for sample sheet generation and planned run creation in ICA.
Load to Library Tube Strip (NovaSeq X Series Sequencing v1.1) Master Step Field Configuration
The AUTOMATED - Sequencing Run (NovaSeq X Series Sequencing v1.1) step is fully automated. The integration starts the step, adds samples to the Ice Bucket, and completes the step. Data from the run is parsed back to Clarity LIMS. In this step, pooled samples in the library tube strip are sequenced on the NovaSeq X Series instrument.
¹ These automations are required for CLPA support only.
The following tables show the master step fields that are configured on the AUTOMATED - Sequencing Run (NovaSeq X Series Sequencing v1.1) step.
Clarity LIMS Master Step Field Information
Other Clarity LIMS Master Step Fields
The following global custom fields are used to capture the run metrics in Clarity LIMS:
% Bases >=Q30 R1
% Bases >=Q30 R2
% Error Rate R1
% Error Rate R2
Yield (Gb) R1
Yield (Gb) R2
Reads PF R1
Reads PF R2
%PF R1
%PF R2
% Aligned R1
% Aligned R2
% Phasing R1
% Phasing R2
% Prephasing R1
% Prephasing R2
Intensity Cycle 1 R1
Intensity Cycle 1 R2
Cluster Density R1
Cluster Density R2
At the end of the step, the pools of samples are automatically removed from the step. The step completes automatically when Run Status is RunCompletedSuccessfully.
The AUTOMATED - Analysis Run (NovaSeq X Series Sequencing v1.1) step is fully automated. The integration starts and completes the step automatically. Data from the analysis is parsed back to Clarity LIMS. In this step, the secondary analysis configured using the Analysis Configuration Template (ACT) is performed in Illumina Connected Analytics (ICA). There are no automations associated with this step.
The following tables show the master step fields that are configured on the AUTOMATED - Analysis Run (NovaSeq X Series Sequencing v1.1) step.
AUTOMATED - Analysis Run (NovaSeq X Series Sequencing v1.1) Master Step Field Information
The following information summarizes how the NovaSeq X Series integration works.
After the Validate Run Setup and Create Planned Run automation is triggered on the Load to Library Tube Strip (NovaSeq X Series Sequencing v1.1) step, the run parameters entered in the Run Details screen are sent to Illumina Connected Analytics (ICA). The analysis configuration parameters from the selected ACTs are also sent to ICA. ICA validates the run and analysis configuration. If the validation fails, ICA sends an error message to Clarity LIMS. If the validation passes, ICA generates the sample sheet and sends it back to Clarity LIMS. ICA also creates the planned run based on the selected run mode (e.g., Local or Cloud).
For the Local run mode, the sample sheet is generated and stored in Clarity LIMS. This sample sheet contains the run and analysis configuration information required to start the run on the NovaSeq X Series instrument.
For the Cloud run mode, the planned run is created in ICA. The planned run contains the run and analysis configuration information required to start the run on the instrument. The sample sheet is generated and stored in Clarity LIMS for reference purposes.
When the sequencing run starts on the instrument, the NovaSeq X Series Control Software notifies BaseSpace Sequence Hub. BaseSpace Sequence Hub monitors the run and notifies Clarity LIMS via the integration service. The events are processed and the integration service retrieves the run information from BaseSpace Sequence Hub. This information is used to populate the custom fields in the AUTOMATED - Sequencing Run (NovaSeq X Series Sequencing v1.1) step.
Other run events follow the same information flow. When sequencing is complete, the control software uploads the sequencing run data (primary metrics) and associated files to ICA. Then, Clarity LIMS retrieves the primary metrics and uses them to populate the fields in the Sample Details table (e.g., % Error Rate R1). The custom fields (e.g., Run Status, Current Read, and so on) on the AUTOMATED - Sequencing Run (NovaSeq X Series Sequencing v1.1) step are updated using the run related information. If the sequencing run is successfully completed, the step automatically completes.
The integration tracks the analysis events and results in the AUTOMATED - Analysis Run (NovaSeq X Series Sequencing v1.1) step. You must log in to BaseSpace Sequence Hub to retrieve the cloud analysis results. For local analysis, the secondary analysis results are in the external storage configured in Illumina Run Manager. The external storage information is found in the External Storage for Analysis Results configuration settings in Illumina Run Manager.
The following sections outline the steps to start a Clarity LIMS cloud or local run on the NovaSeq X Series instrument.
The library preparation workflow of the samples must be configured to ensure unique derived sample names before routing the samples through the library preparation workflow.
The following sections describe the components (files, properties, reagent categories / label groups, reagent kits, and containers) that are installed by default as part of this integration.
Reagent Kits
Buffer Cartridge
Lyophilization Cartridge
NaOH
Reagent Cartridge
Resuspension Buffer (RSB)
TT2
Container Types
Library 2-Tube Strip
Library 8-Tube Strip
Tube
This integration supports the library 8-tube strip with the barcode in the LC[0-9]{7}-L[A-Z]1 format. The integration also supports the library 2-tube strip with the barcode in the LC[0-9]{7}-L[A-Z]2 format.
Control Types
PhiX v3
The workflow configuration contains several validation checks. To make sure that the calculations work properly, it is important that you do not disable any of this validation logic. The validation checks determine the following information:
Which samples, and how many, can enter each step together.
Which samples, and how many, can be pooled together.
All submitted samples must have an associated secondary analysis that is configured using the analysis configuration template (ACT). The ACT must be configured on BaseSpace Sequence Hub before starting the Assign Analysis Configuration Template step. The ACT names must be unique.
The library tube strip barcode must be unique. There must not be multiple library tube strip containers with the same name in the system.
Reagent labels, or indexes, must be unique.
One library pool can only contain one library or control with no label/index.
The AUTOMATED - Sequencing Run (NovaSeq X Series Sequencing v1.1) and AUTOMATED - Analysis Run (NovaSeq X Series Sequencing v1.1) steps must not be manually started or completed. These steps are fully automated and the sequencing service does not update samples correctly if they have been manually started.
For the automated run to start successfully, you must select Validate Run Setup and Create Planned Run in the Load to Library Tube step.
The label group (index adapter kit) used for library preparation must be the same as the index adapter kit specified in the ACT that is being used. For more information, refer to NovaSeq X Series Integration v1.2.0 User Interaction, Validation and Troubleshooting.
Do not add samples to the Ice Bucket or start or complete the step. The integration does this automatically.
Do not add samples to the Ice Bucket or start or complete the step. The integration does this automatically.
This script is required for the NovaSeq X Series Sequencing v1.1 workflow to function properly.
The BP Aliquot Volume value is rounded up to the nearest µl. The value in the calculation file, however, is reflected with up to two decimal places.
This script is required for the NovaSeq X Series Sequencing v1.1 workflow to function properly.
Do not add samples to the Ice Bucket or start and complete the AUTOMATED - Sequencing Run (NovaSeq X Series Sequencing v1.1) step. The integration does this automatically.
Do not add samples to the Ice Bucket or start and complete the AUTOMATED - Sequencing Run (NovaSeq X Series Sequencing v1.1) step. The integration does this automatically.
Do not modify the names of the master step fields. Modifications cause the integration to break.
If a planned run with the same sample name and project name (case-insensitive) has been created previously in ICA, the sample sheet generated from the Validate Run Setup and Create Planned Run automation can reflect the original case of the previous sample name. This can cause validation errors for analysis configurations with sample-level settings. To resolve this issue, change the sample name or the project name on Clarity LIMS and run the automation again.
Field Name
Field Type
Options
Analysis Configuration Template
Text Dropdown
Required Field
Application
Text
Read Only
Application Version
Text
Read Only
Index Adapter Kit
Text
Read Only
Library Prep Kit
Text
Read Only
Reference Genome
Text
Read Only
Secondary Analysis Mode
Text
Read Only
Field Name
Field Type
Options
Additional Options and Dropdown Items
Molarity (nM)
Numeric
Decimal places displayed = 2
ACT Name
Text
Read Only
Field Name
Field Type
Options
Additional Options and Dropdown Items
Final Loading Concentration (pM)
Numeric Dropdown
Required Field
Custom Entries
Dropdown Items
90
140
150
160
180
Range from 0
Decimal places displayed: 0
Flowcell Type
Text
Required Field
Dropdown Items
1.5B
10B
25B
Minimum Per Sample Volume (ul)
Numeric
Required Field
Decimal places displayed: 2
Default: 2
Number of Lanes to Sequence
Numeric
Required Field
Range: 1–10
Decimal places displayed: 0
Field Name
Field Type
Options
Additional Options and Dropdown Items
Final Loading Concentration (pM)
Numeric Dropdown
Required Field
Custom Entries
Decimal places displayed: 0
Dropdown Items
225
400
RSB Volume (ul)
Numeric
Read Only
Decimal places displayed: 2
NovaSeq X Flowcell Type
Text Dropdown
Required Field
Read Only
Dropdown Items
1.5B
10B
25B
Field Name
Field Type
Options
Additional Options and Dropdown Items
BP Aliquot Volume (ul)
Numeric
Read Only
Decimal places displayed = 0
NaOH Volume (ul)
Numeric
Read Only
Decimal places displayed = 2
RSB Volume (ul)
Numeric
Read Only
Decimal places displayed = 2
TT2 Volume (ul)
Numeric
Read Only
Decimal places displayed = 2
Field Name
Source File
Corresponding Field in Source File
Additional Information
Current Cycle
RunCompletionStatus.xml
CompletedReads
Visible on Record Details screen.
Calculated based on the CompletedReads field.
Current Read
RunCompletionStatus.xml
RunParameters.xml
CompletedReads
PlannedReads
Visible on Record Details screen.
Calculated based on the CompletedReads field in RunCompletionStatus.xml and PlannedReads field in RunParameters.xml.
Flow Cell Expiration Date
RunParameters.xml
ExpirationDate
Visible on Record Details screen.
Corresponds to the value in the ExpirationDate field under the ConsumableInfo field for FlowCell Type.
Flow Cell ID
RunParameters.xml
SerialNumber
Visible on Record Details screen.
Corresponds to the value in the SerialNumber field under the ConsumableInfo field for FlowCell Type.
Flow Cell Lot Number
RunParameters.xml
LotNumber
Visible on Record Details screen.
Corresponds to the value in the LotNumber field under the ConsumableInfo field for FlowCell Type.
Flow Cell Part Number
RunParameters.xml
PartNumber
Visible on Record Details screen.
Corresponds to the value of the PartNumber field under the ConsumableInfo field for FlowCell Type.
Flow Cell Side
RunParameters.xml
Side
Visible on Record Details screen.
Flow Cell Type
RunParameters.xml
FlowCellType
Visible on Record Details screen.
Instrument Control Software Version
RunParameters.xml
SystemSuiteVersion
Visible on Record Details screen.
Instrument ID
RunParameters.xml
InstrumentSerialNumber
Visible on Record Details screen.
Instrument Type
RunParameters.xml
InstrumentType
Visible on Record Details screen.
Output Folder
RunParameters.xml
OutputFolder
Visible on Record Details screen.
Library Tube Strip Barcode
RunParameters.xml
SerialNumber
Visible on Record Details screen.
Corresponds to the value of the SerialNumber field under the ConsumableInfo field for SampleTube Type.
Library Tube Lot Number
RunParameters.xml
LotNumber
Hidden
Corresponds to the value of the LotNumber field under the ConsumableInfo field for SampleTube Type.
Run End Time
RunCompletionStatus.xml
RunEndTime
Hidden
Run Name
RunParameters.xml
ExperimentName
Visible on Record Details screen.
RTA Version
Not used
Not used
Hidden
Field Name
Description
Additional Information
Run Status
Presets
RunStarted
RunCompletedSuccessfully
RunAbortedByUser
RunErroredOut
Set by the integration service.
Visible on Record Details screen.
Sequencing Log
Set by the integration service during the sequencing run.
Visible on Record Details screen.
BaseSpace Run ID
Received from the message sent to the integration service.
Hidden
ICA Project ID
Received from the message sent to the integration service.
Hidden
Instrument Run ID
Received from the message sent to the integration service.
Hidden
Run Start Time
Received from the message sent to the integration service.
Hidden
Field Name
Description
Additional Information
Analysis Status
Presets
Started
Completed
Failed
NeedsAttention
Stopped
TimedOut
CompletedWithErrors
Set by the integration service.
Visible on Record Details screen.
Analysis Result Location
Received from the message sent to the integration service.
Visible on Record Details screen.
Library Tube Strip Barcode
Identified by the integration service using information from RunParameters.xml.
Hidden
Field Name
Field Type
Options
Additional Options and Dropdown Items
Cloud Run ID
Text
Read Only
Hidden
Index 1 Cycles
Numeric Dropdown
Required Field
Custom Entries
Range = 0–20
Presets
0
6
8
Index 2 Cycles
Numeric Dropdown
Required Field
Custom Entries
Range = 0–20
Presets
0
6
8
Read 1 Cycles
Numeric Dropdown
Required Field
Custom Entries
Range = 1–251
Presets
51
101
151
Read 2 Cycles
Numeric Dropdown
Required Field
Custom Entries
Range = 0–251
Presets
51
101
151
Run Mode
Text Dropdown
Required Field
Presets
Local
Cloud
Run Name
Text
Required Field
Used for creating a planned run in ICA.