Configuration
Last updated
Last updated
BSSH subscription (personal/professional/enterprise) is required for NextSeq 1000/2000 Integration v2.4.0
The Illumina NextSeq 1000/2000 Integration Package v2.4.0 supports the integration of Clarity LIMS to Illumina NextSeq 1000/2000 sequencing systems.
For instructions on user interaction for each step, validating and troubleshooting the NextSeq 1000/2000 Integration, refer to NextSeq 1000/2000 Integration v2.4.0 User Interaction, Validation and Troubleshooting.
The configuration provided in this integration has been established to support NextSeq 1000/2000 lab processes. Any configuration changes to protocols or workflows — including renaming protocols, steps, and fields (global or master step) — could break the process.
The Illumina NextSeq 1000/2000 Integration Package v2.4.0 is compatible with Illumina cloud hosted deployments only.
It is assumed that samples entering the NextSeq 1000/2000 Sequencing v2.3 workflow have gone through library preparation and quantification processes. Before they are assigned to the workflow, samples have completed the following actions:
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 some value. The Calculate Volumes automation in the Library Pooling and Dilution step requires a value in the Molarity (nM) global field.
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 NextSeq 1000/2000 Integration Package v2.4.0 includes the following workflows:
[Optional] Library Prep Validation v2.3.1 (recommended for validation purposes).
NextSeq 1000/2000 Sequencing v2.3
Samples are routed to this protocol after they have gone through Library Prep Validation v2.3.1 (or any other library prep workflow). Samples are pooled, diluted to final loading concentration, and added to a reagent cartridge in preparation for the sequencing run.
The workflow configuration includes a global field named Illumina Universal Sample Identifier. This text field is reserved for Clarity LIMS Product Analytics support. The field is optional and not required for this integration.
The Library Prep Validation v2.3.1 workflow allows for validation of the system after installation is complete. For details, refer to NextSeq 1000/2000 Integration v2.4.0 User Interaction, Validation and Troubleshooting.
In this step, the addition of RSB dilutes pooled samples. Manually create a working pool based on the final loading concentration required.
¹ These automations are required for Clarity LIMS Product Analytics support only.
The following fields are defined on the Library Pooling and Dilution (NextSeq 1000/2000 Sequencing v2.3) step.
Library Pooling and Dilution (NextSeq 1000/2000 Sequencing v2.3) Master Step Field Configuration
The following table lists the global fields that are configured to display on the Library Pooling and Dilution (NextSeq 1000/2000 Sequencing v2.3) step.
Library Pooling and Dilution (NextSeq 1000/2000 Sequencing v2.3) Global Field Configuration
In this step, scan the reagent cartridge barcode into Clarity LIMS, then manually place the working pool into the reagent cartridge for the NextSeq 1000/2000 run. This step validates the run setup and analysis information and generates the sample sheet file and/or creates a planned run on Illumina Connected Analytics, depending on the Run Mode selected.
¹ These automations are required for Clarity LIMS Product Analytics support only.
² These automations are required for the NextSeq 1000/2000 Sequencing v2.3 workflows and contain additional logic needed for Clarity LIMS Product Analytics support. If you would like to remove Clarity LIMS Product Analytics support, contact Illumina Support.
There are 24 fields defined on the Load to Reagent Cartridge (NextSeq 1000/2000 Sequencing v2.3) step. These fields are required for sample sheet generation and planned run creation on Illumina Connected Analytics (ICA).
Load to Reagent Cartridge (NextSeq 1000/2000 Sequencing v2.3) Master Step Fields Configuration
This step is fully automated.
The integration starts and completes the step automatically. Data from the run is parsed back to Clarity LIMS. No user interaction is required. In this step, the pooled samples in the reagent cartridge are sequenced on the NextSeq 1000/2000 instrument.
¹ These automations are required for Clarity LIMS Product Analytics support only.
There following fields are defined on the AUTOMATED - Sequencing Run (NextSeq 1000/2000 Sequencing v2.3) step. These fields are used to display the run status and sequencing run and analysis configuration parsed from the RunParameters.xml file of the sequencing run.
Run Parameters and Corresponding Clarity LIMS Step Fields The following table shows how some of the step fields map to the fields on the RunParameters.xml file, and whether the field is visible on the Record Details screen.
Additional Master Step Fields and Values The following table shows how the other step fields derive their values, and whether the step field is visible on the Record Details screen.
¹ For information on how the integration works, refer to Run Status, Primary Metrics, and Analysis Results Parsing and Recording in How the NextSeq 1000/2000 Integration Works.
The following global 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 this step, the pool of samples is automatically advanced to (and queued for) the Demultiplexing (NextSeq 1000/2000 Sequencing v2.3) step.
This step is a semi-automated step.
The DRAGEN version must be earlier than v3.9.3.
The samples in the run must not repeat.
The run must be for the single lane flow cell (P1 or P2).
The integration starts the step automatically and demultiplexing data from the GenerateFASTQ secondary analysis is parsed back to Clarity LIMS. The lab scientist reviews the demultiplexing result parsed into Clarity LIMS, assigns QC flags, and completes the step.
The following table lists the 12 master step fields that are configured on the Demultiplexing (NextSeq 1000/2000 Sequencing v2.3) master step.
Master Step Field Configuration for Demultiplexing (NextSeq 1000/2000 Sequencing v2.3) Step
The following table lists the global fields that are configured on the Demultiplexing (NextSeq 1000/2000 Sequencing v2.3) step. These fields are used to display the demultiplexing result metrics for individual library in the sample pool.
Global Field Configuration for Demultiplexing (NextSeq 1000/2000 Sequencing v2.3) Step
On the Load To Reagent Cartridge (NextSeq 1000/2000 Sequencing v2.3) step, when the Validate Run Setup and Create Planned Run automation is triggered, the run and analysis parameters entered in the Run Details screen are sent to Illumina Connected Analytics (ICA). ICA validates the run and analysis configuration, and sends an error message to Clarity LIMS if the validation fails. If the validation passes, ICA generates the sample sheet (and sends back to Clarity LIMS) and/or creates a planned run depending on the Run Mode selected. NextSeq 1000/2000 Integration supports local, hybrid and cloud run mode.
Refer to Start A Sequencing Run On Instrument With Different Run Modes for details on how to start a run using different run mode.
After the sequencing run is started on the instrument, NextSeq 1000/2000 Control Software (NCS) notifies BaseSpace Sequence Hub (BSSH) that the sequencing run has started.
BSSH then does the following actions:
Local run mode: Creates a run on the BSSH database with the run configuration information received from NCS.
Hybrid/Cloud run mode: Creates a run on the BSSH database by copying the run configuration information from the planned run created in ICA, using a special Cloud Run ID received from NCS.
After the run is created on BSSH, a run update event message that carries the RunStarted equivalent message is created on BSSH and sent to the integration service which processes the message.
Based on the reagent cartridge barcode information in the event message (refer to the following example), the integration looks in the queue of AUTOMATED - Sequencing Run (NextSeq 1000/2000 Sequencing v2.3) step for a container with the same reagent cartridge barcode. When identified, the step is started automatically and the Run Status field on Record Details screen is updated to RunStarted. The integration then updates all the other step fields (eg, Current Read, Output Folder) by parsing the details from the RunParameters.xml uploaded to BSSH by NCS.
The NextSeq 1000/2000 Control Software (NCS) continues to notify BaseSpace Sequence Hub (BSSH) of any run status change throughout the course of the sequencing run. The run update event delivery process continues as described in the previous section.
The following table lists the run status details and how the integration service handles each status.
Refer to the NextSeq 1000/2000 Product Documentation for the following information:
Configuring a run with the Proactive, Run Monitory and Storage option. Local runs are done in Local mode, and cloud or hybrid runs are done in Cloud or Hybrid mode.
Starting a local, cloud, or hybrid run.
This section describes the various components that are installed by default as part of this integration.
Information on installed workflows, protocols, steps, and automation points is provided in the Workflows, Protocols, and Steps section of NextSeq 1000/2000 Integration v2.4.0 User Interaction, Validation and Troubleshooting.
Reagent Categories/Label Groups
TruSeq HT adapters v2 (D7-D5)
Reagent Kits
Resuspension Buffer (RSB)
NextSeq 1000/2000 reagent cartridge
Container Types
Tube
96-well plate
NextSeq 1000/2000 reagent cartridge
Control Types
PhiX v3
This integration supports the NextSeq 1000/2000 reagent cartridge with barcode provided in the format [A-Za-z]{2}[0-9]{7}-[A-Za-z0-9]{4} (eg, EC1234567-EC03).
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.
Clarity LIMS requires unique library names when samples are re-queued to the workflow in the NextSeq 1000/2000 integration. Assign unique names to libraries after going through library preparation.
The following steps are used to configure the library preparation workflow correctly before routing the samples for re-queuing:
From Configuration, select the Lab Work tab.
Search for the library preparation workflow used for the re-queued samples.
In the Master Step of the library preparation workflow, modify the naming convention under Step Type to generate unique library names (E.g., appending LIMS ID to the default naming convention, like OutputItemLIMSID).
Select Save.
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:
Which samples, and how many, can enter each step together.
Which samples, and how many, can be pooled together.
The NextSeq 1000/2000 reagent cartridge barcode must be unique. There should not be multiple NextSeq 1000/2000 reagent cartridge containers in the system with the same name.
Reagent labels (indexes) must be unique.
One library pool can only contain one library or control with no label (index).
Do not manually start or complete the AUTOMATED - Sequencing Run (NextSeq 1000/2000 Sequencing v2.3) step. This step is a fully automated step, and the integration service does not update samples correctly if they have been manually started.
Do not manually start the Demultiplexing (NextSeq 1000/2000 Sequencing v2.3) step. This step is semi-automated, and the integration service does not update the demultiplexing result correctly if they have been manually started.
For the automated run to start successfully, select Validate Run Setup and Create Planned Run in the Load to Reagent Cartridge step.
The NextSeq 1000/2000 Reagent Cartridge barcode should not be modified after it has been successfully validated. Modifying the barcode would result in Clarity failing to update subsequent steps and sample details properly.
Do not add samples to the Ice Bucket or start or complete the step. The integration does this action automatically.
Do not add samples to the Ice Bucket or start or complete the step. The integration does this action automatically.
Create one pool per step. The Calculate Volumes automation supports one pool only.
The NextSeq 1000/2000 reagent cartridges support different read cycle numbers. Make sure that the read cycle values configured for the planned run are within the maximum allowable reads for the cartridge type.
Do not modify or disable the Retrieve Analysis Workflow Versions automation script. Modifying or disabling the script breaks the integration.
Do not add samples to the Ice Bucket or start or complete the step. The integration does this action automatically.
Do not add samples to the Ice Bucket or start or complete the step. The integration does this action automatically.
For the demultiplexing information in the Sample Details table to display correctly, the following conditions must be met:
The NextSeq 1000/2000 Reagent Cartridge barcode should not be modified after a successful validation. Modifications can cause issues when Clarity LIMS tries to update the status and sample details of subsequent steps.
Field Name
Field Type
Field Constraints/Options
Preset Values/Additional Options and Drop-down Items
Final Loading Concentration (pM)
Numeric Dropdown
Required Field
Custom Entries
Decimal places displayed = 0 Presets
225
400
RSB Volume (µl)
Numeric
Read Only
Decimal places displayed = 2
Field Name
Field Type
Field Constraints/Options
Preset Values/Additional Options and Drop-down Items
Run Name
Text
Required Field
Instrument Type
Text Dropdown
Required Field
Presets
NextSeq1000
NextSeq2000
Run Mode
Text Dropdown
Required Field
Presets
Local
Hybrid
Cloud
Paired End
Text Dropdown
Required Field
Presets
True
False
Read 1 Cycles
Numeric Dropdown
Required Field
Custom Entries
Presets
301
151
101
51
Read 2 Cycles
Numeric Dropdown
Required Field
Custom Entries
Presets
301
151
101
51
Index Reads
Text Dropdown
Required Field
Presets
No Index
Single Index
Dual Index
Index Read 1
Numeric Dropdown
Required Field
Custom Entries
Presets
0
6
8
Index Read 2
Numeric Dropdown
Required Field
Custom Entries
Presets
0
6
8
Analysis Workflow
Text
Required Field
Read Only
Default
GenerateFASTQ
Adapter Sequence Read 1
Text
Adapter Sequence Read 2
Text
Barcode Mismatches Index 1
Numeric Dropdown
Presets
0
1
2
Barcode Mismatches Index 2
Numeric Dropdown
Presets
0
1
2
Override Cycles
Text
Cloud Run ID (Used in creating planned run in ICA)
Text
Read Only
Hidden
Use Custom Index Read 1 Primer (Custom primer option is currently not supported)
Toggle Switch
Default
None Set
Hidden
Use Custom Index Read 2 Primer (Custom primer option is currently not supported)
Toggle Switch
Default
None Set
Hidden
Use Custom Read 1 Primer (Custom primer option is currently not supported)
Toggle Switch
Default
None Set
Hidden
Use Custom Read 2 Primer (Custom primer option is currently not supported)
Toggle Switch
Default
None Set
Hidden
Instructions
Multiline Text
Read Only
Default
If GenerateFASTQ analysis is required, please select the DRAGEN version in Cloud Analysis Workflow Versions (for Cloud run mode) or Local Analysis Workflow Versions (for Local/Hybrid run mode) custom fields above.
Local Analysis Workflow Versions
Text Dropdown
Default
None
Cloud Analysis Workflow Versions
Text Dropdown
Default
None
FASTQ Compression Format
Text Dropdown
Required Field
Presets
gzip
DRAGEN
None
Default
gzip
Master Step Field
RunParameters.xml Field
On Record Details Screen
Current Cycle
Calculated based on CompletedCycles Field
Visible
Current Read
Calculated based on CompletedCycles field against PlannedCycles
Visible
Flow Cell ID
FlowCellSerialNumber
Visible
Flow Cell Lot Number
FlowCellLotNumber
Visible
Instrument Control Software Version
ApplicationVersion
Visible
Instrument ID
InstrumentSerialNumber
Visible
Output Folder
OutputFolder
Visible
Reagent Cartridge ID
CartridgeSerialNumber
Visible
Reagent Cartridge Lot Number
CartridgeLotNumber
Visible
RTA Version
RtaVersion
Visible
Run Name
ExperimentName
Visible
Secondary Analysis Workflow
SecondaryAnalysisWorkflow
Visible
Flow Cell Mode
FlowCellMode
Hidden
Instrument Run ID
Derived from OutputFolder
Hidden
Run End Time
RunEndTime
Hidden
Run Start Time
RunStartTime
Hidden
Secondary Analysis Mode
SecondaryAnalysisMode
Hidden
Secondary Analysis Platform Version
SecondaryAnalysisPlatformVersion
Hidden
SkipObdd
SkipObdd
Hidden
Master Step Field
RunParameters.xml Field
On Record Details Screen
Instrument Platform
NextSeq 1000/2000 Constant value
Visible
Instrument Type
One of the following options:
NextSeq1000
NextSeq2000
Determined from Instrument Type step field from previous Load to Reagent Cartridge step.
Visible
Run Status
One of the following options:
RunStarted
RunCompletedSuccessfully
RunAbortedByUser
RunErroredOut
Set by the integration service¹
Visible
Sequencing Log
Filled in by the integration service¹ as the sequencing run proceeds
Visible
BaseSpace Run ID
Received as part of the event payload¹
Hidden
Field Name
Field Type
Field Constraints/Options
Preset Values/Additional Options and Drop-down Items
Criteria 1 - Source Data Field
Text Dropdown
Custom Entries
Presets
# Reads
# Perfect Index Reads
# One Mismatch Index Reads
# of >= Q30 Bases (PF)
Criteria 2 - Source Data Field
Text Dropdown
Custom Entries
Presets
# Reads
# Perfect Index Reads
# One Mismatch Index Reads
# of >= Q30 Bases (PF)
Criteria 1 - Operator
Text Dropdown
Custom Entries
Presets
>=
<=
=
!=
Criteria 2 - Operator
Text Dropdown
Custom Entries
Presets
>=
<=
=
!=
Criteria 1 - Threshold Value
Numeric
Valid integer value
Criteria 2 - Threshold Value
Numeric
Valid integer value
Log
Multiline Text
Read Only
Analysis Completed Time
Text
Read Only
Hidden
Analysis Started Time
Text
Read Only
Hidden
Analysis Status
Text
Read Only
Hidden
BSSH Analysis ID
Text
Read Only
Hidden
Reagent Cartridge ID (Used for parsing demultiplexing results)
Text
Read Only
Hidden
Field Name
Field Type
Field Constraints/Options
# of >= Q30 Bases (PF)
Numeric
Read Only
# One Mismatch Index Reads
Numeric
Read Only
# Perfect Index Reads
Numeric
Read Only
# Reads
Numeric
Read Only
Mean Quality Score (PF)
Numeric
Read Only
Run Status
Shown in Step
Details
RunStarted
AUTOMATED - Sequencing Run (NextSeq 1000/2000 Sequencing v2.3)
Run Status field is updated to RunStarted.
All other step fields (except Run End Time) are updated based on RunParameters.xml detail obtained from BSSH, the SQS event message, and the step field value from the Load to Reagent Cartridge (NextSeq 1000/2000 v2.3) step.
Reagent cartridge lot information received from BSSH is compared against the details of the pre-accessioned reagent cartridge on Clarity LIMS.
If the expiration date is different, it is updated to the date received from BSSH.
If reagent cartridge is not found, it is created and set to Active.
If reagent cartridge is not in Active status, it is set to Active.
Multiline Sequencing Log field is updated.
RunCompletedSuccessfully
AUTOMATED - Sequencing Run (NextSeq 1000/2000 Sequencing v2.3)
Run Status field is updated to RunCompletedSuccessfully
Current Read and Current Cycle fields are updated to the final cycle number and read number based on RunParameters.xml detail obtained from BSSH.
Run End Time field is updated based on RunParameters.xml detail obtained from BSSH.
Sequencing run result (primary metrics) is downloaded from BSSH and the fields in Sample Details table (e.g., % Error Rate R1, % Phasing, etc.) are updated with the values.
Multiline Sequencing Log field is updated.
The integration automatically completes the step and routes the samples in the reagent cartridge container to the next step (e.g., Demultiplexing (NextSeq 1000/2000 Sequencing v2.3)) step.
RunErroredOut
AUTOMATED - Sequencing Run (NextSeq 1000/2000 Sequencing v2.3)
Run Status field is updated to RunErroredOut.
Current Read and Current Cycle fields are updated to the final cycle number and read number that the run stopped based on RunParameters.xml detail obtained from BSSH.
Run End Time field is updated based on RunParameters.xml detail obtained from BSSH.
Sequencing run result (primary metrics) is downloaded from BSSH and the fields in Sample Details table (e.g., % Error Rate R1, % Phasing, etc.) are updated with the values.
Multiline Sequencing Log field is updated.
The integration does not automatically complete the step. Complete the step manually.
RunAbortedByUser
AUTOMATED - Sequencing Run (NextSeq 1000/2000 Sequencing v2.3)
Run Status field is updated to RunAbortedByUser.
Current Read and Current Cycle fields are updated to the final cycle number and read number that was aborted based on RunParameters.xml details obtained from BSSH.
Run End Time field is updated based on RunParameters.xml detail obtained from BSSH.
Sequencing run result (primary metrics) is downloaded from BSSH and the fields in Sample Details table (e.g., % Error Rate R1, % Phasing, etc.) are updated with the values.
Multiline Sequencing Log field is updated.
The integration does not automatically complete the step. Complete the step manually.
AnalysisStarted
Demultiplexing (NextSeq 1000/2000 Sequencing v2.3)
The integration starts the step automatically for the reagent cartridge container
Multiline Sequencing Log field is updated.
AnalysisCompleted
Demultiplexing (NextSeq 1000/2000 Sequencing v2.3)
The integration downloads the Demultiplex_stats.csv file, which contains the demultiplexing result from BSSH.
The file is parsed and details are recorded in the Sample Details table for each library in the library pool.
Hidden master step fields are updated with information from BSSH. In particular, Analysis Status is updated to Complete.
Multiline Sequencing Log field is updated.
The integration does not automatically complete the step. Assign the QC flag to the individual library and manually complete the step.
AnalysisFailed
Demultiplexing (NextSeq 1000/2000 Sequencing v2.3)
Hidden step fields are updated with information from BSSH. In particular, Analysis Status is updated to either TimedOut or Aborted.
Multiline Sequencing Log field is updated.
The integration does not automatically complete the step. Assign the QC flag to the individual library and manually complete the step.
Field Name
Field Type
Field Constraints/Options
Preset Values/Additional Options and Drop-down Items
Final Loading Concentration (pM)
Numeric Dropdown
Required Field
Custom Entries
Presets
650
750
1000
2000
Final Loading Volume (ul)
Numeric
Required Field
Default
24
Library Pool Volume (ul)
Numeric
Read Only
Hidden
RSB Volume for Pool (ul)
Numeric
Read Only
Hidden
This field is used by the Calculate Volumes automation. Removing, renaming, or modifying the field will break the automation.
This field is used by the Calculate Volumes automation. Removing, renaming, or modifying the field will break the automation.