LogoLogo
Illumina KnowledgeIllumina SupportSign In
Clarity LIMS Software
  • Home
Clarity LIMS Software
  • Announcements
  • Clarity LIMS
    • Clarity & LabLink
  • API and Database
    • API Portal
      • REST
        • REST General Concepts
        • REST Web Services
        • HTTP Response Codes and Errors
        • XML UTF-8 Character Encoding
        • Requesting API Version Information
        • Viewing Paginated List Resources
        • Filtering List Resources
        • Working with User-Defined Fields (UDF) and Types (UDT)
        • Traversing a Genealogy
        • Working with Batch Resources
      • Getting Started with API
        • Understanding API Terminology (LIMS v5 and later)
        • API-Based URIs (LIMS v4 and later)
        • Development Prerequisites
        • Structure of REST Resources
        • The Life Cycle of a Sample: Stages Versus Steps
        • Integrating Scripts
      • Automation
        • Automation Triggers and Command Line Calls
        • Automation Execution Environment
        • Supported Command Line Interpreters
        • Automation Channels
        • Error Handling
        • Automation Tokens
          • Derived Sample Automation Tokens
          • Step Automation Tokens
          • Project Automation Tokens
        • Automation Testing
        • Troubleshooting Automation
      • Tips and Tricks
        • Accessing Step UDFs from a different Step
        • Obfuscating Sensitive Data in Scripts
        • Integrating Clarity LIMS with Upstream Sample Accessioning Systems
        • Creating Samples and Projects via the API
        • Displaying Files From an Earlier Step
        • Transitioning Output Artifacts into the Next Step
        • Determining the Workflow(s) to Which a Sample is Assigned
        • Standardizing Sample Naming via the API
        • Copying UDF Values from Source to Destination
        • Updating Preset Value of a Step UDF through API
        • Automating BCL Conversion
        • Finding QC Flags in Aggregate QC (Library Validation) via REST API
        • Setting the Value of a QC Flag on an Artifact
        • Creating Notifications When Files are Added via LabLink
        • Remote HTTP Filestore Setup
      • Cookbook
        • Get Started with the Cookbook
          • Tips and Troubleshooting
          • Obtain and Use the REST API Utility Classes
        • Work with EPP/Automation and Files
          • Automation Trigger Configuration
          • Process Execution with EPP/Automation Support
        • Work with Submitted Samples
          • Adding Samples to the System
          • Renaming Samples
          • Assigning Samples to Workflows
          • Updating Sample Information
          • Show the Relationship Between Samples and Analyte Artifacts (Derived Samples)
        • Work with Containers
          • Add an Empty Container to the System
          • Find the Contents of a Well Location in a Container
          • Filter Containers by Name
        • Work with Derived Sample Automations
          • Remove Samples from Workflows
          • Requeue Samples
          • Rearray Samples
        • Work with Process/Step Outputs
          • Update UDF/Custom Field Values for a Derived Sample Output
          • Rename Derived Samples Using the API
          • Find the Container Location of a Derived Sample
          • Traverse a Pooled and Demultiplexed Sample History/Genealogy
          • View the Inputs and Outputs of a Process/Step
        • Work with Projects and Accounts
          • Remove Information from a Project
          • Add a New Project to the System with UDF/Custom Field Value
          • Get a Project Name
          • Find an Account Registered in the System
          • Update Contact (User and Client) Information
        • Work with Multiplexing
          • Find the Index Sequence for a Reagent Label
          • Demultiplexing
          • Pool Samples with Reagent Labels
          • Apply Reagent Labels with REST
          • Apply Reagent Labels When Samples are Imported
          • Apply Reagent Labels by Adding Reagents to Samples
        • Working with User Defined Fields/Custom Fields
          • About UDFs/Custom Fields and UDTs
          • Performing Post-Step Calculations with Custom Fields/UDFs
        • Work with Processes/Steps
          • Filter Processes by Date and Type
          • Find Terminal Processes/Steps
          • Run a Process/Step
          • Update UDF/Custom Field Information for a Process/Step
          • Work with the Steps Pooling Endpoint
        • Work with Batch Resources
          • Introduction to Batch Resources
          • Update UDF/Custom Field Information with Batch Operations
          • Retrieve Multiple Entities with a Single API Interaction
          • Select the Optimal Batch Size
        • Work with Files
          • Attach a File with REST and Python
          • Attach Files Located Outside the Default File Storage Repository
          • Attach a File to a File Placeholder with REST
        • Work with Controls
          • Automated Removal of Controls from a Workflow
      • Application Examples
        • Python API Library (glsapiutil.py) Location
        • Scripts That Help Automate Steps
          • Route Artifacts Based Off a Template File
          • Invoking bcl2fastq from BCL Conversion and Demultiplexing Step
          • Email Notifications
          • Finishing the Current Step and Starting the Next
          • Adding Downstream Samples to Additional Workflows
          • Advancing/Completing a Protocol Step via the API
          • Setting a Default Next Action
          • Automatic Placement of Samples Based on Input Plate Map (Multiple Plates)
          • Automatic Placement of Samples Based on Input Plate Map
          • Publishing Files to LabLink
          • Automatic Pooling Based on a Sample UDF/Custom Field
          • Completing a Step Programmatically
          • Automatic Sample Placement into Existing Containers
          • Routing Output Artifacts to Specific Workflows/Stages
          • Creating Multiple Containers / Types for Placement
          • Starting a Protocol Step via the API
          • Setting Quality Control Flags
          • Applying Indexing Patterns to Containers Automatically
          • Assignment of Sample Next Steps Based On a UDF
          • Parsing Metadata into UDFs (BCL Conversion and Demultiplexing)
        • Scripts That Validate Step Contents
          • Validating Process/Step Level UDFs
          • Checking That Containers Are Named Appropriately
          • Checking for Index Clashes Based on Index Sequence
          • Validating Illumina TruSeq Index Adapter Combinations
        • Scripts Triggered Outside of Workflows/Steps
          • Repurposing a Process to Upload Indexes
          • Adding Users in Bulk
          • Moving Reagent Kits & Lots to New Clarity LIMS Server
          • Programatically Importing the Sample Submission Excel File
          • Generating an MS Excel Sample Submission Spreadsheet
          • Assigning Samples to New Workflows
        • Miscellaneous Scripts
          • Illumina LIMS Integration
          • Generating a Hierarchical Sample History
          • Protocol-based Permissions
          • Self-Incremental Counters
          • Generic CSV Parser Template (Python)
          • Renaming Samples to Add an Internal ID
          • Creating Custom Sample Sheets
          • Copying Output UDFs to Submitted Samples
          • Parsing Sequencing Meta-Data into Clarity LIMS
          • Submit to a Compute Cluster via PBS
          • Downloading a File and PDF Image Extraction
        • Resources and References
          • Understanding LIMS ID Prefixes
          • Container States
          • Useful Tools
          • Unsupported Artifact Types
          • Unsupported Process Types
          • Suggested Reading
          • API Training Videos
  • Illumina Preset Protocols
    • IPP v2.10
      • Release Notes
      • Installation and User Configuration
      • Manual Upgrade
    • IPP v2.9
      • Release Notes
      • Installation and User Configuration
    • IPP v2.8
      • Release Notes
      • Installation and User Configuration
      • Manual Upgrade
    • IPP v2.7
      • Release Notes
      • Installation and User Configuration
    • IPP v2.6
      • Release Notes
      • Installation and User Configuration
      • Manual Upgrade
  • Sample Prep
    • QC and Sample Prep
      • DNA Initial QC 5.1.2
      • RNA Initial QC 5.1.2
      • Library Validation QC 5.1.2
  • Library Prep
    • AmpliSeq for Illumina
      • BRCA Panel
        • Library Preparation v1.1
        • Equalizer v1.1
        • Standard v1.1
      • Cancer HotSpot Panel v2
        • Library Preparation v1.1
        • Equalizer v1.1
        • Standard v1.1
      • Childhood Cancer Panel
        • DNA Library Prep v1.1
        • RNA Library Prep v1.1
        • Equalizer v1.1
        • Standard v1.1
      • Comprehensive Cancer Panel
        • Library Preparation v1.1
        • Equalizer v1.1
        • Standard v1.1
      • Comprehensive Panel v3
        • DNA Library Prep v1.1
        • RNA Library Prep v1.1
        • Equalizer v1.1
        • Standard v1.1
      • Custom DNA Panel
        • Library Preparation v1.1
        • Equalizer v1.1
        • Standard v1.1
      • Focus Panel
        • DNA Library Prep v1.1
        • RNA Library Prep v1.1
        • Equalizer v1.1
        • Standard v1.1
      • Immune Repertoire Panel
        • RNA Library Prep v1.1
        • Equalizer v1.1
        • Standard v1.1
      • Immune Response Panel
        • RNA Library Prep v1.1
        • Equalizer v1.1
        • Standard v1.1
      • Myeloid Panel
        • DNA Library Prep v1.1
        • RNA Library Prep v1.1
        • Equalizer v1.1
        • Standard v1.1
      • TCR beta-SR Panel
        • DNA Library Prep v1.1
        • RNA Library Prep v1.1
      • Transcriptome Human Gene Expression Panel
        • RNA Library Prep v1.1
        • Equalizer v1.1
        • Standard v1.1
    • Library Prep Validation
    • Nextera
      • Nextera Mate Pair v1.0
      • Nextera Rapid Capture Custom Enrichment v2.0
      • Nextera XT v2.0
    • Targeted Enrichment
      • Illumina DNA Prep with Enrichment (S) Tagmentation v1.2
      • Illumina RNA Prep with Enrichment (L) Tagmentation v1.1
    • TruSeq
      • TruSeq ChIP-Seq v1.0
      • TruSeq Custom Amplicon v1.0
      • TruSeq DNA Exome v2.0
      • TruSeq DNA PCR-Free v2.0
      • TruSeq Methyl Capture EPIC v2.0
      • TruSeq Nano DNA v1.0
      • TruSeq RNA Access v2.0
      • TruSeq RNA Exome v1.0
      • TruSeq Small RNA v1.0
      • TruSeq Stranded mRNA v2.0
    • TruSight
      • TruSight Oncology 500 ctDNA v1.1
      • TruSight Oncology 500 HT v1.1
      • TruSight Oncology 500 v1.1
      • TruSight Tumor 170 v2.0
    • Other DNA Protocols
      • Illumina DNA PCR-Free Library Prep Manual v1.1
      • Illumina DNA Prep (M) Tagmentation v1.0
    • Other RNA Protocols
      • Illumina Stranded mRNA Prep Ligation 1.1
      • Illumina Stranded Total RNA Prep Ligation with Ribo-Zero Plus v1.1
  • iLASS & Infinium Arrays
    • iLASS
      • iLASS Infinium Genotyping v1.1
        • iLASS Infinium Batch DNA v1.1
        • iLASS Infinium Genotyping Assay v1.1
        • iLASS Infinium Genotyping with PGx Assay v1.1
      • iLASS Infinium Genotyping v1.0
        • iLASS Infinium Genotyping Assay v1.0
        • iLASS Infinium Genotyping with PGx Assay v1.0
    • Infinium Arrays
      • Infinium HD Methylation Assay Manual v1.2
      • Infinium HTS Assay Manual v1.2
      • Infinium LCG Assay Manual v1.2
      • Infinium XT Assay Manual v1.2
      • GenomeStudio v1.0
  • Applications
    • IGA
      • IGA v2.1
        • IGA Library Prep Automated v2.1
        • IGA NovaSeq Sequencing v2.1
    • Viral Pathogen Protocols
      • CDC COVID-19 RT-PCR
        • Sort Specimens to Extraction v1.1
        • Qiagen QIAamp DSP Viral RNA Mini Kit v1.1
        • Qiagen EZ1 Advanced XL v1.1
        • Roche MagNA Pure LC v1.1
        • Roche MagNA Pure Compact v1.1
        • Roche MagNA Pure 96 v1.1
        • bioMerieux NucliSENS easyMAG Instrument v1.1
        • bioMerieux EMAG Instrument v1.1
        • Real-Time RT-PCR Prep v1.1
      • Illumina COVIDSeq v1.6
      • Respiratory Virus Panel v1.0
  • Instruments & Integrations
    • Compatibility
    • Integration Properties
      • Integration Properties Details
    • Clarity LIMS Product Analytics
      • Supported Workflows
      • Workflow Customization
      • Clarity LIMS Product Analytics v1.4.0
        • Configuration
      • Clarity LIMS Product Analytics v1.3.1
        • Configuration
      • Clarity LIMS Product Analytics v1.3.0
        • Configuration
      • Clarity LIMS Product Analytics v1.2.0
        • Configuration
    • Illumina Run Manager
      • Illumina Run Manager v1.0.0
        • Installation and User Interaction
    • iScan
      • iScan System
      • iScan v1.2.0
        • Release Notes
        • BeadChip Accessioning, Imaging, and Analysis
      • iScan v1.1.0
        • Release Notes
        • BeadChip Accessioning, Imaging, and Analysis
      • iScan System v1.0
    • iSeq 100 Run Setup v1.0
    • MiniSeq v1.0
    • MiSeq
      • MiSeq v8.3.0
        • Release Notes
        • Installation
        • Configuration
        • User Interaction, Validation and Troubleshooting
      • MiSeq v8.2.0
        • Release Notes
        • Installation
        • Configuration
        • User Interaction, Validation and Troubleshooting
        • Manual Upgrade
    • MiSeq i100 (On-Prem)
      • MiSeq i100 On-Prem v1.0.0
        • Release Notes
        • Installation
        • Configuration
        • User Interaction, Validation and Troubleshooting
    • MiSeq i100 (Hosted)
      • MiSeq i100 v1.0.0
        • Release Notes
        • Configuration
        • User Interaction, Validation and Troubleshooting
    • MiSeqDx
      • MiSeqDx Sample Sheet Generation (v1.11.0 and later)
      • MiSeqDx v1.11.0
        • Release Notes
        • Installation
        • Configuration
        • User Interaction, Validation and Troubleshooting
      • MiSeqDx v1.10.0
        • Release Notes
        • Installation
        • Configuration
        • User Interaction, Validation and Troubleshooting
        • Sample Sheet Generation
        • Manual Upgrade
    • Next Generation Sequencing Package
      • Release Notes
        • NGS Extensions v5.25.0
        • NGS Extensions v5.24.0
        • NGS Extensions v5.23.0
      • Accession Kit Lots
      • Auto-Placement of Reagent Indexes
      • Compute Replicate Average
      • Copy UDFs
      • Initialize Artifact UDFs
      • Label Non-Labeled Outputs
      • Linear Regression Calculation
      • Normalization Buffer Volumes
      • Process Summary Report
      • Routing Script
      • Set UDF
      • Validate Complete Plate
      • Validate Sample Count
      • Validate Unique Indexes
    • NextSeq 500/550
      • NextSeq 500/550 v2.5.0
        • Release Notes
        • Installation
        • Configuration
        • User Interaction, Validation and Troubleshooting
        • Manual Upgrade
      • NextSeq 500/550 v2.4.0
        • Release Notes
        • Installation
        • Configuration
        • User Interaction, Validation and Troubleshooting
      • NextSeq 500/550 v2.3.0
        • Release Notes
        • Installation
        • Configuration
        • User Interaction, Validation and Troubleshooting
    • NextSeq 1000/2000 (Hosted)
      • NextSeq 1000/2000 v2.5.1
        • Release Notes
      • NextSeq 1000/2000 v2.5.0
        • Release Notes
        • Configuration
        • User Interaction, Validation and Troubleshooting
        • Manual Upgrade
      • NextSeq 1000/2000 v2.4.0
        • Release Notes
        • Configuration
        • User Interaction, Validation and Troubleshooting
    • NextSeq 1000/2000 (On-Prem)
      • NextSeq 1000/2000 On-Prem v1.0.0
        • Release Notes
        • Installation
        • Configuration
        • User Interaction, Validation and Troubleshooting
    • NovaSeq 6000 (API-based)
      • NovaSeq 6000 API-based v3.7.0
        • Release Notes
        • Installation
        • Configuration
        • User Interaction, Validation and Troubleshooting
      • NovaSeq 6000 API-based v3.6.0
        • Release Notes
        • Installation
        • Configuration
        • User Interaction, Validation and Troubleshooting
        • Manual Upgrade
    • NovaSeq 6000 (File-based)
      • NovaSeq 6000 File-based v2.6.0
        • Release Notes
        • Installation
        • Configuration
        • User Interaction, Validation and Troubleshooting
      • NovaSeq 6000 File-based v2.5.0
        • Release Notes
        • Installation
        • Configuration
        • User Interaction, Validation and Troubleshooting
    • NovaSeq 6000Dx (API-based)
      • NovaSeq 6000Dx API-based v1.3.0
        • Release Notes
        • Installation
        • Configuration
        • User Interaction, Validation and Troubleshooting
      • NovaSeq 6000Dx API-based v1.2.0
        • Release Notes
        • Installation
        • Configuration
        • User Interaction, Validation and Troubleshooting
    • NovaSeq X Series (Hosted)
      • NovaSeq X Series v1.3.0
        • Release Notes
        • Configuration
        • Manual Upgrade
      • NovaSeq X Series v1.2.1
        • Release Notes
      • NovaSeq X Series v1.2.0
        • Release Notes
        • Configuration
        • User Interaction, Validation and Troubleshooting
        • Manual Upgrade
      • NovaSeq X Series v1.1.0
        • Release Notes
        • Configuration
        • User Interaction, Validation and Troubleshooting
    • NovaSeq X Series (On-Prem)
      • NovaSeq X Series On-Prem v1.0.0
        • Release Notes
        • Installation
        • Configuration
        • User Interaction, Validation and Troubleshooting
    • References
      • Configure Multiple Identical netPathPrefixSearch Values
      • Configure Support for Samples Having Duplicate Names with Different Indexes
      • Illumina Instrument Sample Sheets
      • Terminology
  • Integration Toolkits
    • Lab Instrument Toolkit
      • Template File Generator
        • Creating Template Files
        • Template File Contents
        • Template File Generator Troubleshooting
      • Add Blank Lines
      • Convert CSV to Excel
      • Parse CSV
      • Name Matching XML Parser
      • Sample Placement Helper
    • Lab Logic Toolkit
      • Working with Lab Logic Toolkit
        • Data Collection Entities
        • Failing a Script
        • Mapping Field Types
        • Non-UDF/Custom Field Properties
        • Setting QC Flags
        • Setting Next Actions
        • Specifying Custom Fields
        • Working with Submitted Samples
        • Working with Containers
      • Lab Logic Toolkit Script Examples
        • Comparing Stop/Start Dates and Times with LLTK
      • Lab Logic Toolkit FAQ
  • Known Issues
    • Integration
      • Sample Sheet Generation Issue and CLPA Issues When Samples Have Been Assigned QC Flag Prior to Entering Steps
  • Security Bulletin
    • Investigation of OpenSSH vulnerability with Clarity LIMS
  • Resources
    • Third Party Software Information
  • Others
    • Revision History
Powered by GitBook
On this page
  • Prerequisites and Assumptions
  • Analysis Configuration Template
  • Samples
  • Workflows, Protocols, and Steps
  • Library Prep Validation v2.3.5 Workflow
  • MiSeq i100 Series Sequencing v1.0 Workflow
  • Validation Workflow
  • Step 1: Assign Analysis Configuration Template (MiSeq i100 Series Sequencing v1.0)
  • Master Step Fields
  • Global Fields
  • Step 2: Make Bulk Pool (MiSeq i100 Series Sequencing v1.0)
  • Master Step Fields
  • Global Fields
  • Step 3: Load to Dry Cartridge (MiSeq i100 Series Sequencing v1.0)
  • Master Step Fields
  • Step 4: AUTOMATED - Sequencing Run (MiSeq i100 Series Sequencing v1.0)
  • Master Step Fields
  • Global Fields
  • Step 6: AUTOMATED - Analysis Run (MiSeq i100 Series Sequencing v1.0)
  • Master Step Fields
  • How the Integration Works
  • Start a Sequencing Run on MiSeq i100 Series Instrument
  • Enabling Planned Run Generation for Samples Having Duplicate Name with Different Indexes
  • Components Installed
  • Rules and Constraints

Was this helpful?

Export as PDF
  1. Instruments & Integrations
  2. MiSeq i100 (Hosted)
  3. MiSeq i100 v1.0.0

Configuration

PreviousRelease NotesNextUser Interaction, Validation and Troubleshooting

Last updated 4 months ago

Was this helpful?

This integration supports the integration of Clarity LIMS to Illumina MiSeq i100 series instruments.

The configuration provided in this integration has been established to support MiSeq i100 Series lab processes. Any configuration changes to protocols or workflows (including renaming protocols, steps, and fields) could break the integration.

Prerequisites and Assumptions

The MiSeq i100 Series Integration v1.0.0 requires a valid BaseSpace Sequence Hub account with an Enterprise or Professional subscription.

Analysis Configuration Template

The MiSeq i100 Series Sequencing v1.0 workflow uses analysis configuration templates (ACTs), created on BaseSpace Sequence Hub, to configure secondary analysis for planned runs.

The index adapter kit configured in the ACT must be created as label group in Clarity LIMS and used in the library preparation step for indexing the samples.

For more information, refer to .

ACT names created in BaseSpace Sequence Hub must not have leading or trailing spaces.

Samples

Samples must go through the library preparation and quantification process before they enter the MiSeq i100 Series Sequencing v1.0 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.

Workflows, Protocols, and Steps

The MiSeq i100 Series Integration Package v1.0.0 includes the following workflows:

  • MiSeq i100 Series Sequencing v1.0

  • Library Prep Validation v2.3.5 (optional, but recommended for validation purposes)

The following describes the protocols and steps included in these workflows.

Library Prep Validation v2.3.5 Workflow

Protocol 1: Library Prep Validation v2.3.5

Purpose:

  • Included for validation purposes only, this protocol models the library prep steps required to advance samples to the MiSeq i100 Series Sequencing v1.0 workflow.

  • The protocol contains a single step - Library Prep Validation v2.3.5. After this step, a routing script sends the samples to the first step of the MiSeq i100 Series Sequencing v1.0 workflow (Assign Analysis Configuration Template (MiSeq i100 Series Sequencing v1.0)).

Steps:

  1. Library Prep Validation v2.3.5

MiSeq i100 Series Sequencing v1.0 Workflow

Protocol 1: MiSeq i100 Series Sequencing v1.0

Purpose:

  • This protocol models the lab processes of run setup for starting a MiSeq i100 Series sequencing and secondary analysis run.

Steps:

  1. Assign Analysis Configuration Template (MiSeq i100 Series Sequencing v1.0)

    • The secondary analysis of samples is configured using the ACT.

    • The labels applied to the samples are validated against the selected ACT.

  2. Make Bulk Pool (MiSeq i100 Series Sequencing v1.0)

    • The Calculate Volume script assists with pooling samples and adding resuspension buffers and reagents.

    • The Validate Analysis Configurations automation validates the ACT of pooled samples to make sure that the secondary analysis configurations remain valid after pooling.

  3. Load To Dry Cartridge (MiSeq i100 Series Sequencing v1.0)

    • The library pool from step 2 is ready to be loaded to the MiSeq i100 Series dry cartridge.

    • Validates run and analysis configuration.

    • Generates the sample sheet and creates the planned run, depending on the run mode.

  4. AUTOMATED - Sequencing Run (MiSeq i100 Series Sequencing v1.0)

    • The step is fully automated and starts and completes automatically after the sequencing run is started and completed in BaseSpace Sequence Hub.

    • The sequencing run metadata (e.g., run configuration, primary run metrics, etc.) are recorded automatically.

  5. AUTOMATED - Analysis Run (MiSeq i100 Series Sequencing v1.0)

    • The step is fully automated and starts and completes automatically after the analysis run is started and completed in ICA.

    • The analysis run metadata (e.g., status and demultiplexing stats file) are recorded automatically.

Validation Workflow

The Library Prep Validation v2.3.5 workflow allows for validation of the system after installation is complete. This workflow can be replaced by other custom library preparation workflows.

Configure a custom library preparation workflow as follows.

  1. Select Configuration, then select Lab Work.

  2. Add a Routing Script automation to the last Master Step of the library preparation workflow.

  3. Select Configuration, then select Automation.

  4. Create a new Routing Script automation and update it as follows.

    1. For Channel Name, enter limsserver.

    2. For Command Line, enter the following script:

      bash -l -c "/opt/gls/clarity/bin/java -jar /opt/gls/clarity/extensions/ngs-common/v5/EPP/ngs-extensions.jar -u {username} -p {password} -i {stepURI:v2} -l {compoundOutputFileLuid0} script:changeWorkflow \
      \
      --FIELD_NAME 'Sequencing Instrument' \
      --FIELD_VALUE 'MiSeq i100 Series' \
      --WORKFLOW 'MiSeq i100 Series Sequencing v1.0' \
      --STEP 'Assign Analysis Configuration Template (MiSeq i100 Series Sequencing v1.0)' \
      --INPUTS_OR_OUTPUTS 'OUTPUTS'"
    3. For Automation Use, select the custom library preparation workflow.

Step 1: Assign Analysis Configuration Template (MiSeq i100 Series Sequencing v1.0)

This 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.

Validate Sample Names and Retrieve Analysis Configuration Template List and Register Step Started Automation¹

Automatically triggered on entry to the step, this automation completes the following actions:

  • Checks that submitted sample names contain only alphanumeric, dash, and underscore characters.

    /opt/gls/clarity/bin/java -jar /opt/gls/clarity/extensions/ngs-common/v5/EPP/ngs-extensions.jar -i {stepURI:v2} -u {username} -p {password} script:evaluateDynamicExpression -exp 'submittedSamples.each { sample -> if ( !sample.name.matches( ::[A-Za-z0-9_-]+:: ) ) { fail ( ::Submitted sample :: + sample.name + :: should only have alphanumeric, dash, and underscore characters. Please rename and try again.:: ) } }' -log {compoundOutputFileLuid1}
  • Retrieves the list of ACTs that were created in BaseSpace Sequence Hub.

    /opt/gls/clarity/bin/java -jar /opt/gls/clarity/extensions/SIS/SISServices/extensions/automation/miseqi100series-automation.jar script:retrieve_act_list -i {stepURI:v2} -u {username} -p {password} -l {compoundOutputFileLuid1}
  • Registers the start time of the step by publishing messages to CLPA through the ICA.

    /opt/gls/clarity/bin/java -jar /opt/gls/clarity/extensions/unified-product-analytics/automation/unified-product-analytics-automation.jar script:executeUPAAutomationScript -i {stepURI:v2} -u {username} -p {password} -s 'com/illumina/upa/scripts/common/step_started.groovy'
Retrieve ACT Information Automation

Triggered when you select Retrieve ACT Information on the Record Details screen, this automation completes the following actions:

  • Retrieves the details of the selected ACT and populates the step custom fields (e.g., Analysis Version, Library Prep Kit, and so on).

  • Saves the details into a file that is available to download. This file is stored in the Analysis Configuration Metadata file placeholder.

    /opt/gls/clarity/bin/java -jar /opt/gls/clarity/extensions/SIS/SISServices/extensions/automation/miseqi100series-automation.jar script:retrieve_act_info -i {stepURI:v2} -u {username} -p {password} -l {compoundOutputFileLuid1} -a '{udf:Analysis Configuration Template}'
Validate Reagent Labels and Apply Selected ACT to Samples and Set Next Step Automation

Automatically triggered on exit of the Record Details screen, this automation completes the following actions:

  • Checks that the molarity of all samples is specified.

    /opt/gls/clarity/bin/java -jar /opt/gls/clarity/extensions/ngs-common/v5/EPP/ngs-extensions.jar -i {stepURI:v2} -u {username} -p {password} script:evaluateDynamicExpression -t false -h false -exp 'if (!input.hasValue(::Molarity (nM)::)) { fail(::The Molarity cannot be empty.::) ; } else if (input.::Molarity (nM):: <= 0) { fail(::The Molarity cannot be negative or zero.::) ; }' -log {compoundOutputFileLuid1}
  • Checks that all samples are indexed and for invalid indexes. The indexes applied are the same as the selected ACT.

  • Assigns the selected ACT to all samples in the step.

    /opt/gls/clarity/bin/java -jar /opt/gls/clarity/extensions/SIS/SISServices/extensions/automation/miseqi100series-automation.jar -i {stepURI:v2} -u {username} -p {password} -l {compoundOutputFileLuid1} -a '{udf:Analysis Configuration Template}' script:validate_indexes  script:assign_act'
  • Sets the next step for samples to ADVANCE, which advances them to the next step in the protocol (Make Bulk Pool (MiSeq i100 Series Sequencing v1.0)).

    /opt/gls/clarity/bin/java -jar /opt/gls/clarity/extensions/ngs-common/v5/EPP/ngs-extensions.jar -i {stepURI:v2} -u {username} -p {password} script:evaluateDynamicExpression -t false -h false -exp 'nextStep = ::ADVANCE::' -log {compoundOutputFileLuid1}
Register Step Completed Automation²

Automatically triggered on exit of the step, this automation registers completion time of the step by publishing messages to CLPA through ICA.

/opt/gls/clarity/bin/java -jar /opt/gls/clarity/extensions/unified-product-analytics/automation/unified-product-analytics-automation.jar script:executeUPAAutomationScript -i {stepURI:v2} -u {username} -p {password} -s 'com/illumina/upa/scripts/common/step_completed.groovy'

¹ These automations are required for the MiSeq i100 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.

Master Step Fields

The following table lists the configuration details for fields that are defined on the Assign Analysis Configuration Template (MiSeq i100 Series Sequencing v1.0) step.

Field Name

Field Type

Options

Analysis Configuration Template

Text Dropdown

  • Required Field

  • Custom Entries¹

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

¹ The ACT entered must correspond to a valid ACT in BaseSpace Sequence Hub.

Global Fields

The following table lists the global custom fields that are configured to display on the Assign Analysis Configuration Template (MiSeq i100 Series Sequencing v1.0) step.

Global Field Configuration (Derived Sample)

Field Name

Field Type

Options

Additional Options and Dropdown Items

Molarity (nM)

Numeric

Decimal places displayed = 2

ACT Name

Text

Read Only

Step 2: Make Bulk Pool (MiSeq i100 Series Sequencing v1.0)

Samples are pooled in the Make Bulk Pool (MiSeq i100 Series Sequencing v1.0) step. You can manually create working pools based on the final loading concentration required.

Register Step Started Automation¹

Automatically triggered on entry to the step, this automation registers the start time of the step. This automation completes this action by publishing messages to CLPA through ICA.

/opt/gls/clarity/bin/java -jar /opt/gls/clarity/extensions/unified-product-analytics/automation/unified-product-analytics-automation.jar script:executeUPAAutomationScript -i {stepURI:v2} -u {username} -p {password} -l {compoundOutputFileLuid1} -s 'com/illumina/upa/scripts/common/step_started.groovy'
Validate Analysis Configurations Automation

Automatically triggered on exit of the Pooling screen, this automation performs analysis configuration validity and checks each pool for the following characteristics:

  • Pooled samples are within the maximum configuration limit.

  • Pooled samples have the same type of analysis (e.g., Cloud or Local).

  • Pooled samples assigned with the same secondary analysis application must have the same analysis version (e.g. v3.8.4) and settings (e.g. Map/Align Output Format = CRAM).

/opt/gls/clarity/bin/java -jar /opt/gls/clarity/extensions/SIS/SISServices/extensions/automation/miseqi100series-automation.jar -i {stepURI:v2} -u {username} -p {password} -l {compoundOutputFileLuid1} -m PerPool script:validate_analysis_config  script:validate_physical_logical_configurations
Calculate Volumes Automation

Automatically triggered when you select Calculate Volumes on the Record Details screen, this automation completes the following actions:

  • Proceeds if the sample has molarity values.

    if (!input.hasValue(::Molarity (nM)::)) { return; };
  • Computes the number of samples in pool.

  • Uses the Final Loading Concentration (pM) and Final Loading Volume (ul) to calculate the required volumes for the 4 nM intermediate library pools.

  • Copies the Final Loading Concentration (pM) and Flowcell Type from the step inputs to the step outputs.

    script:evaluateDynamicExpression \
    -exp 'if (!input.hasValue(::Molarity (nM)::)) { return; }; if (output.hasValue(::Number of Samples in Pool::)) { output.::Number of Samples in Pool:: = output.::Number of Samples in Pool:: + 1; } else { output.::Number of Samples in Pool:: = 1; };' -t true \
    script:evaluateDynamicExpression \
    -exp 'output.::Required Bulk Pool Volume (ul):: = (step.::Final Loading Concentration (pM):: / 1000) * step.::Final Loading Volume (ul):: / 4 ;
    output.::MiSeq i100 Series Flowcell Type:: = step.::Flowcell Type::
  • Calculates the per sample volume required for each library to make a 4 nM intermediate library pool

  • Copies the Bulk Pool Volume (ul) from the step input to the step output.

  • Sets the total sample volume to zero.

    script:evaluateDynamicExpression \
    -exp 'input.::Per Sample Volume (ul):: = 4 * step.::Bulk Pool Volume (ul):: / input.::Molarity (nM):: / output.::Number of Samples in Pool::; output.::Bulk Pool Volume (ul):: = step.::Bulk Pool Volume (ul)::; output.::Total Sample Volume (ul):: = 0;' -t true \
  • Computes the PhiX (100 pM) Spike-In required based on the the percentage specified. The PhiX Volume is saved to the file in the Calculation File placeholder in the Files section.

    script:evaluateDynamicExpression \
    -exp 'if (step.hasValue(::% PhiX (100 pM) Spike-In::) && step.::% PhiX (100 pM) Spike-In:: > 0) { output.::PhiX Concentration (pM):: = 100; output.::PhiX Volume (ul):: = 4 * output.::Required Bulk Pool Volume (ul):: * (step.::% PhiX (100 pM) Spike-In:: / 100) / (output.::PhiX Concentration (pM):: / 1000); } else { output.::PhiX Volume (ul):: = ::::; output.::PhiX Concentration (pM):: = ::::; }' -t true \
  • Calculates the adjusted per sample volume for the pools.

    script:calculate_multipool_adjusted_per_sample_volume -t
  • Uses the Total Sample Volume (ul), Bulk Pool Volume (ul) and Required Bulk Pool Volume (ul) to calculate the RSB volume (ul) required to top up the pools that are needed to create the intermediate library pools. Computes the KLD volume required. The RSB and KLD volumes are saved to the file in the Calculation File placeholder in the Files section.

    script:evaluateDynamicExpression \
    -exp 'if (output.hasValue(::Total Sample Volume (ul)::)) { output.::Total Sample Volume (ul):: = output.::Total Sample Volume (ul):: + input.::Adjusted Per Sample Volume (ul)::; } else { output.::Total Sample Volume (ul):: = input.::Adjusted Per Sample Volume (ul)::; }' -t true \
    script:evaluateDynamicExpression \
    -exp 'if (output.::Total Sample Volume (ul):: > output.::Bulk Pool Volume (ul)::) { output.::RSB Volume for Intermediate Pool (ul):: = 0 } else { output.::RSB Volume for Intermediate Pool (ul):: = output.::Bulk Pool Volume (ul):: - output.::Total Sample Volume (ul):: }' -t true \
    script:evaluateDynamicExpression \
    -exp 'if (output.::Bulk Pool Volume (ul):: < output.::Required Bulk Pool Volume (ul)::) { output.::RSB Volume (ul):: = output.::Required Bulk Pool Volume (ul):: - output.::Bulk Pool Volume (ul)::; } else { output.::RSB Volume (ul):: = 0.1 * step.::Final Loading Volume (ul):: - output.::Required Bulk Pool Volume (ul)::; } ; output.::KLD Volume (ul):: = 0.9 * step.::Final Loading Volume (ul)::; output.::Final Loading Concentration (pM):: = step.::Final Loading Concentration (pM)::;' -t true \
  • Uses the MiSeqi100Series_Bulk_Pool1.csv, MiSeqi100Series_Bulk_Pool2 and MiSeqi100Series_Bulk_Pool3.csv template files to generate a single CSV file. This file contains information about the pools and the samples that they contain. The generated file is stored in the Calculation File placeholder in the Files section.

    /opt/gls/clarity/bin/java -jar /opt/gls/clarity/extensions/ngs-common/v5/EPP/DriverFileGenerator.jar -i {stepURI:v2} -u {username} -p {password} -l {compoundOutputFileLuid1} script:driver_file_generator \
    -t /opt/gls/clarity/extensions/conf/driverfiletemplates/MiSeqi100Series_Bulk_Pool1.csv -o 1.csv \
    script:driver_file_generator \
    -t /opt/gls/clarity/extensions/conf/driverfiletemplates/MiSeqi100Series_Bulk_Pool2.csv -o 2.csv \
    script:driver_file_generator \
    -t /opt/gls/clarity/extensions/conf/driverfiletemplates/MiSeqi100Series_Bulk_Pool3.csv -o 3.csv \
    && cat 1.csv 2.csv 3.csv > {compoundOutputFileLuid0}.csv \
  • Resets the Number of Samples in Pool before exiting the step.

    script:evaluateDynamicExpression \
    -exp 'output.::Number of Samples in Pool:: = ::::;' -t true \
Set Next Step Automation

Automatically triggered on exit of the Record Details screen, this automation completes the following actions:

  • Proceeds only if the sample has a molarity value.

  • Copies the Run Mode from input to output.

  • Sets the next step for samples to ADVANCE, which advances them to the Load to Dry Cartridge (MiSeq i100 Series Sequencing v1.0) step.

/opt/gls/clarity/bin/java -jar /opt/gls/clarity/extensions/ngs-common/v5/EPP/ngs-extensions.jar -i {stepURI:v2} -u {username} -p {password} -log {compoundOutputFileLuid1} \
script:evaluateDynamicExpression -exp 'if (!input.hasValue(::Molarity (nM)::)){ return; }; output.::Run Mode:: = input.::Run Mode::; nextStep = ::ADVANCE::;'"
Register Pools and Register Step Completed Automation¹

Automatically triggered on exit of the step, this automation completes the following actions:

  • Registers the pool and library information used by the Clarity LIMS workflow. Samples in the pool are assumed to have gone through library preparation.

  • Registers the completion time of the step.

/opt/gls/clarity/bin/java -jar /opt/gls/clarity/extensions/unified-product-analytics/automation/unified-product-analytics-automation.jar script:executeUPAAutomationScript -i {stepURI:v2} -u {username} -p {password} -s 'com/illumina/upa/scripts/common/pooling.groovy' && /opt/gls/clarity/bin/java -jar /opt/gls/clarity/extensions/unified-product-analytics/automation/unified-product-analytics-automation.jar script:executeUPAAutomationScript -i {stepURI:v2} -u {username} -p {password} -s 'com/illumina/upa/scripts/common/step_completed.groovy'

This automation completes this action by publishing messages to CLPA through ICA.

¹These automations are required for CLPA support only.

All remaining automations are required for the MiSeq i100 Series Sequencing v1.0 workflows.

Master Step Fields

The following table lists configuration details for the fields that are defined on the Make Bulk Pool (MiSeq i100 Series Sequencing v1.0) step.

Make Bulk Pool (MiSeq i100 Series Sequencing v1.0) Master Step Field Configuration

Field Name

Field Type

Options

Additional Options and Dropdown Items

% PhiX (100pM) Spike-In

Numeric

  • Range from 0 to 100

  • Decimal places displayed: 0

Bulk Pool Volume (ul)

Numeric

  • Required Field

  • Decimal places displayed: 1

Final Loading Concentration (pM)

Numeric Dropdown

  • Required Field

  • Custom Entries

  • Dropdown Items

    • 60

    • 70

    • 80

    • 90

    • 100

    • 110

    • 120

    • 130

    • 140

    • 150

    • 160

    • 170

    • 180

Final Loading Volume (ul)

Numeric

  • Required Field

  • Default = 250

  • Decimal places displayed: 2

Flowcell Type

Text Dropdown

  • Required Field

  • Dropdown Items

    • 5M

    • 25M

Minimum Per Sample Volume (ul)

Numeric

  • Required Field

  • Decimal places displayed: 2

  • Default: 2

Global Fields

The following table lists the global custom fields that are configured to display on the Make Bulk Pool (MiSeq i100 Series Sequencing v1.0) step.

Global Custom Fields Configuration (Derived Sample)

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

KLD Volume (ul)

Numeric

  • Read Only

  • Decimal places displayed: 1

MiSeq i100 Series Flowcell Type

Text Dropdown

  • Required Field

  • Read Only

  • Dropdown Items

    • 5M

    • 25M

RSB Volume for Intermediate Pool (ul)

Numeric

  • Read Only

  • Decimal places displayed: 1

RSB Volume (ul)

Numeric

  • Read Only

  • Decimal places displayed: 2

Step 3: Load to Dry Cartridge (MiSeq i100 Series Sequencing v1.0)

The Load to Dry Cartridge (MiSeq i100 Series Sequencing v1.0) step requires you to enter or scan in the dry cartridge barcode into Clarity LIMS. Then, you can place the working pool into the dry cartridge used in the MiSeq i100 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.

Validate Single Pool and Register Step Started Automation¹

Automatically triggered on entry to the step, this automation completes the following actions:

  • Checks that the input is a single pool.

    /opt/gls/clarity/bin/java -jar /opt/gls/clarity/extensions/ngs-common/v5/EPP/ngs-extensions.jar -i {stepURI:v2} -u {username} -p {password} script:validateSampleCount -min 1 -max 1
  • Registers the start time of the step by publishing messages to CLPA through ICA.

    /opt/gls/clarity/bin/java -jar /opt/gls/clarity/extensions/unified-product-analytics/automation/unified-product-analytics-automation.jar script:executeUPAAutomationScript -i {stepURI:v2} -u {username} -p {password} -s 'com/illumina/upa/scripts/common/step_started.groovy'
Validate Dry Cartridge Barcode Automation

Automatically triggered on the Placement screen, this automation validates the dry cartridge barcode to make sure that it conforms to the barcode mask SC[0-9]{7}-SC3.

/opt/gls/clarity/bin/java -jar /opt/gls/clarity/extensions/ngs-common/v5/EPP/ngs-extensions.jar -i {stepURI:v2} -u {username} -p {password} script:validate_output_containers -l {compoundOutputFileLuid1} -r 'MiSeq i100 Series Dry Cartridge:SC[0-9]{7}-SC3' -min 1 -max 1
Validate Run Setup and Create Planned Run Automation

Automatically triggered when you select Validate Run Setup and Create Planned Run on the Record Details screen, this automation completes the following actions:

  • Validates the parameters entered on the Record Details screen. These parameters are used to set up the run, generate the sample sheet file, and create the planned run in ICA, depending on the run mode.

    • Run Name can only contain alphanumeric, dash, underscore, or period characters. Do not use spaces.

      if (!step.::Run Name::.matches(::[a-zA-Z0-9-_]+[a-zA-Z0-9-_. ]*::)) { fail(::Run Name contains prohibited characters. Please check to make sure Run Name only contains alphanumeric characters, spaces, dashes and underscores. Run Name must start with alphanumeric, a dash or an underscore::);}
    • Run Name cannot exceed 255 characters.

      if (step.::Run Name::.length() > 255) { fail(::Run Name shall not exceed 255 characters.::); };
  • Checks the Index 1 Cycles and Index 2 Cycles field values. If Index 2 Cycles is greater than 0, the Index 1 Cycles value must be greater than 0 or an error can occur.

    if (step.::Index 2 Cycles:: > 0 && step.::Index 1 Cycles:: == 0) { fail(::Index 1 Cycles cannot be zero if Index 2 Cycles is non-zero::); };
  • Generates the sample sheet and creates the planned run in ICA. The sample sheet is attached to the step.

    /opt/gls/clarity/bin/java -jar /opt/gls/clarity/extensions/SIS/SISServices/extensions/automation/miseqi100series-automation.jar  script:generate_sample_sheet -i {stepURI:v2} -u {username} -p {password} -c {compoundOutputFileLuid0} -l {compoundOutputFileLuid1} --verifyIndexLength

There is a backend validation of the sample sheet content in ICA. This validation makes sure that the sample sheet is valid to set up a Cloud or Hybrid mode run and that it is ready for use with DRAGEN applications.

Set Next Step Automation

Automatically triggered on exit of the Record Details screen, this automation completes the following actions:

  • Copies the Run Mode from input to output.

  • Sets the next step for samples to ADVANCE, advancing them to the AUTOMATED - Sequencing Run (MiSeq i100 Series Sequencing v1.0) step.

output.::Run Mode:: = input.::Run Mode::; nextStep = ::ADVANCE::
Register Step Completed Automation²

Automatically triggered on exit of the step, this automation registers the completion time of the step by publishing messages to CLPA through ICA.

/opt/gls/clarity/bin/java -jar /opt/gls/clarity/extensions/unified-product-analytics/automation/unified-product-analytics-automation.jar script:executeUPAAutomationScript -i {stepURI:v2} -u {username} -p {password} -s 'com/illumina/upa/scripts/common/step_completed.groovy'

¹ These automations are required for the MiSeq i100 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 MiSeq i100 Series Sequencing v1.0 workflows.

Master Step Fields

The following table shows the master step fields that are configured on the Load to Dry Cartridge (MiSeq i100 Series Sequencing v1.0) step. These fields are required for sample sheet generation and planned run creation in ICA.

Load to Dry Cartridge (MiSeq i100 Series Sequencing v1.0) Master Step Field Configuration

Field Name

Field Type

Options

Additional Options and Dropdown Items

Planned Run ID

Text

  • Read Only

  • Hidden

ℹ Used for storing the planned run ID.

Index 1 Cycles

Numeric Dropdown

  • Required Field

  • Custom Entries

  • Range = 0–18

  • Presets

    • 0

    • 6

    • 8

Index 2 Cycles

Numeric Dropdown

  • Required Field

  • Custom Entries

  • Range = 0–18

  • Presets

    • 0

    • 6

    • 8

Read 1 Cycles

Numeric Dropdown

  • Required Field

  • Custom Entries

  • Range = 1–301

  • Presets

    • 101

    • 151

    • 301

Read 2 Cycles

Numeric Dropdown

  • Required Field

  • Custom Entries

  • Range = 0–301

  • Presets

    • 101

    • 151

    • 301

Run Mode

Text Dropdown

  • Required Field

  • Presets

    • Cloud

    • Hybrid

Run Name

Text

  • Required Field

Step 4: AUTOMATED - Sequencing Run (MiSeq i100 Series Sequencing v1.0)

The AUTOMATED - Sequencing Run (MiSeq i100 Series Sequencing v1.0) 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 dry cartridge are sequenced on the MiSeq i100 Series instrument.

Do not add samples to the Ice Bucket or start and complete the AUTOMATED - Sequencing Run (MiSeq i100 Series Sequencing v1.0) step. The integration does this automatically.

Register Step Started and Register MiSeq i100 Series Run and Register MiSeq i100 Series Run Association and Register MiSeq i100 Series RunStarted Automation¹

Automatically triggered at the beginning of the step, this automation completes the following actions:

  • Registers the start time of the step.

  • Registers the MiSeq i100 Series sequencing run configuration.

  • Registers the association of the sequencing run with the samples by linking the Instrument Run ID with the sample ID.

  • Registers the time that the sequencing run started.

This automation completes these actions by publishing messages to CLPA through ICA.

/opt/gls/clarity/bin/java -jar /opt/gls/clarity/extensions/unified-product-analytics/automation/unified-product-analytics-automation.jar script:executeUPAAutomationScript -i {stepURI:v2} -u {username} -p {password} -s 'com/illumina/upa/scripts/common/step_started.groovy' && /opt/gls/clarity/bin/java -jar /opt/gls/clarity/extensions/unified-product-analytics/automation/unified-product-analytics-automation.jar script:executeUPAAutomationScript -i {stepURI:v2} -u {username} -p {password} -s 'com/illumina/upa/scripts/miseqi100series/register_miseqi100series_run.groovy' && /opt/gls/clarity/bin/java -jar /opt/gls/clarity/extensions/unified-product-analytics/automation/unified-product-analytics-automation.jar script:executeUPAAutomationScript -i {stepURI:v2} -u {username} -p {password} -s 'com/illumina/upa/scripts/miseqi100series/miseqi100series_associate_seqrun.groovy' && /opt/gls/clarity/bin/java -jar /opt/gls/clarity/extensions/unified-product-analytics/automation/unified-product-analytics-automation.jar script:executeUPAAutomationScript -i {stepURI:v2} -u {username} -p {password} -s 'com/illumina/upa/scripts/miseqi100series/miseqi100series_seqrun_started.groovy'
Register MiSeq i100 Series RunCompleted and Register Step Completed Automation¹

Automatically triggered on exit of the step, this automation completes the following actions:

  • Registers the sequencing run completion time, run status, and run metrics. This script requires the Planned Run ID custom field from the Load to Dry Cartridge (MiSeq i100 Series Sequencing v1.0) step.

  • Registers the completion time of the step.

This automation completes these actions by publishing messages to CLPA through ICA.

/opt/gls/clarity/bin/java -jar /opt/gls/clarity/extensions/unified-product-analytics/automation/unified-product-analytics-automation.jar script:executeUPAAutomationScript -i {stepURI:v2} -u {username} -p {password} -s 'com/illumina/upa/scripts/miseqi100series/miseqi100series_seqrun_completed.groovy' && /opt/gls/clarity/bin/java -jar /opt/gls/clarity/extensions/unified-product-analytics/automation/unified-product-analytics-automation.jar script:executeUPAAutomationScript -i {stepURI:v2} -u {username} -p {password} -s 'com/illumina/upa/scripts/common/step_completed.groovy'

¹ These automations are required for CLPA support only.

Master Step Fields

The following tables show the master step fields that are configured on the AUTOMATED - Sequencing Run (MiSeq i100 Series Sequencing v1.0) step. These fields are updated by the integration service.

Field Name

Description

Current Cycle

Completed cycles of current run.

Current Read

Completed reads of current run.

Flow Cell ID

ID of the flow cell.

Flow Cell Type

Type of flow cell.

Instrument Control Software Version

Control software version installed on the instrument.

Instrument Type

Instrument type.

Output Folder

Output folder containing the run data.

Run End Time

Run completion time.

Run Name

Name of the current run.

Dry Cartridge Barcode Serial Number

Serial number of the dry cartridge.

Dry Cartridge Expiration Date

Expiration date of the dry cartridge.

Wet Cartridge Expiration Date

Expiration date of the wet cartridge.

Wet Cartridge Serial Number

Serial number of the wet cartridge.

Run Status

Status of the run.

Sequencing Log

Log of the sequencing run.

BaseSpace Run ID

ID of the run in BaseSpace Sequence Hub.

ICA Project ID

ID of the project in Illumina Connected Analytics.

Instrument Run ID

ID of the run on the instrument.

Cloud Run ID

ID of the run in Illumina Connected Analytics.

Run Start Time

Run start time.

Global 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

  • % PF

  • % Aligned R1

  • % Aligned R2

  • % Occupied

  • % Phasing R1

  • % Phasing R2

  • % Prephasing R1

  • % Prephasing R2

  • Intensity Cycle 1 R1

  • Intensity Cycle 1 R2

At the end of the step, the pools of samples automatically advances to the next step when the sequencing run is successfully completed.

Step 6: AUTOMATED - Analysis Run (MiSeq i100 Series Sequencing v1.0)

The AUTOMATED - Analysis Run (MiSeq i100 Series Sequencing v1.0) step is fully automated. The integration starts and completes the step automatically. In this step, the secondary analysis configured using the Analysis Configuration Template (ACT) is performed in Illumina Connected Analytics (ICA). The local analysis status and results are uploaded to BaseSpace Sequence Hub which in turns passes back the data to Clarity LIMS.

There are no automations associated with this step.

Do not add samples to the Ice Bucket or start and complete the AUTOMATED - Sequencing Run (MiSeq i100 Series Sequencing v1.0) step. The integration does this automatically.

Master Step Fields

The following tables show the master step fields that are configured on the AUTOMATED - Analysis Run (MiSeq i100 Series Sequencing v1.0) step.

Do not modify the names of the master step fields. Modifications cause the integration to break.

AUTOMATED - Analysis Run (MiSeq i100 Series Sequencing v1.0) Master Step Field Information

Field Name

Description

Analysis Status

Status of the analysis run.

Analysis Result Location

BaseSpace Sequence Hub link to analysis run data.

App Session ID

BaseSpace Sequence Hub session ID for the analysis run.

How the Integration Works

The following information summarizes how the MiSeq i100 Series integration works.

  • After the Validate Run Setup and Create Planned Run automation is triggered on the Load to Dry Cartridge (MiSeq i100 Series Sequencing v1.0) step, validation of the run and analysis configuration occurs. When the validation fails, Clarity LIMS displays an error message. Otherwise, a cloud-planned run is created and available on BaseSpace Sequence Hub. The v2 sample sheet is also generated.

    • 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.

    • In Cloud run mode, analysis is performed in Illumina Connected Analytics (ICA). In Hybrid run mode, analysis is performed on-premise.

  • When the integration is configured with BaseSpace Sequence Hub storage and monitoring, the integration tracks the sequencing and analysis events. You can view the analysis result files in BaseSpace Sequence Hub.

If a planned run with the same sample name and project name (case-insensitive) has been created previously, 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.

Start a Sequencing Run on MiSeq i100 Series Instrument

The following sections outline the steps to start a Clarity LIMS cloud or hybrid run on the MiSeq i100 Series instrument.

Run Mode Configuration
  1. In the MiSeq i100 Series Control Software, log in to the instrument using an account that has permissions for configuring settings.

  2. On the menu, select Settings, then select Cloud settings.

  3. In Run Settings, select the Cloud run storage checkbox.

  4. For Hosting location, select the applicable location from the drop-down options.

  5. [Optional] For Private domain name, enter the domain name according to the workgroup that was configured with the MiSeq i100 Series integration package.

  6. Select Save.

Start a Planned Run (Cloud Run or Hybrid Run Modes)

Enabling Planned Run Generation for Samples Having Duplicate Name with Different Indexes

Components Installed

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

  • MiSeq i100 Series Dry Cartridge

  • MiSeq i100 Series Library Denature (KLD)

  • MiSeq i100 Series Wet Cartridge

  • Resuspension Buffer (RSB)

Container Types

  • MiSeq i100 Series Dry Cartridge

  • Tube

Rules and Constraints

  • 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. Refer to the individual validation checks for details.

  • 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 dry cartridge barcode must be unique. There must not be multiple dry cartridges with the same name in the system.

  • Reagent labels, or indexes, must be unique.

  • Only one library pool can be added to be Load to Dry Cartridge step.

  • The AUTOMATED - Sequencing Run (MiSeq i100 Series Sequencing v1.0) and AUTOMATED - Analysis Run (MiSeq i100 Series Sequencing v1.0) 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 Dry Cartridge step. The Load to Dry Cartridge step must be completed and libraries must be queued to the AUTOMATED - Sequencing Run step.

For more information on sample accessioning, refer to Sample Accessioning and Upload and Modify Samples in the Getting Started section of the .

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 .

âš  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 .

Refer to information on .

The library preparation workflow of the samples must be before routing the samples through the library preparation workflow.

MiSeq i100 Series Integration v1.0.0 User Interaction, Validation and Troubleshooting
Clarity LIMS (Clarity & LabLink Reference Guide) documentation
Clarity LIMS (Clarity & LabLink Reference Guide) documentation
MiSeq i100 Series Integration v1.0.0 User Interaction, Validation and Troubleshooting
starting a planned run in the Illumina support site.
configured to ensure unique derived sample names