1 of 7

Work with Multiplexing

When working with multiplexing, you can do the following:

Find the Index Sequence for a Reagent Label
Demultiplexing
Pool Samples with Reagent Labels

Find the Index Sequence for a Reagent Label

A common requirement in applications involving indexed sequencing is to determine the sequence corresponding to a reagent label. This example shows how to configure index reagent types, which you can then use to find the sequence for a reagent label. Before you follow the example, make sure that you have a compatible version of API (v2 r14 to v2 r24).

Code Example

Reagents and reagent labels are independent concepts in the API. However, the recommended practice is to name reagent labels after reagent types. This allows you to use the label name to look up the sequence information on the reagent type resource. This practice is consistent with the Operations Interface process wizards. When a reagent is applied to a sample in the user interface, a reagent label with the same name of the reagent type is added to the analyte resource.

The following actions are also recommended:

Configure an index reagent type with the correct sequence for each type of index or tag you plan to use.
Use the names of the index reagent types as reagent labels.

Following these practices allows you to find the sequence for a reagent label by looking up the sequence in the corresponding reagent type.

Step 1. Configure Index Reagent Types

For each index or tag you plan to use in indexed sequencing, configure a corresponding index reagent type as follows.

As administrator, click Configuration > Consumables > Labels.
Add a new label group.
Then, to add labels to the group:

Step 2. Retrieve the sequence for a reagent label using the REST API

After you have configured reagent types for each indexing sequence you intend to use, and have used those reagent type names as reagent label names, you can easily retrieve the corresponding sequence using the REST API.

The following code snippet shows how to retrieve the index sequences (when available):

For an artifact labeled with Index 1, this would produce the following information:

Attachments

RetrievingReagentLabelIndex.groovy:

Demultiplexing

Demultiplexing is the last step in an indexed sequencing workflow. While the specifics depend on the sequencing instrument and analysis software used, taking pooled samples through sequencing and analysis produces result files/metrics per lane/identifier tag.

These results will likely be in the form of multiple files that you can import back into Clarity LIMS. To do this, you need to set up a configured process that generates process outputs that apply to inputs per reagent label, usually in the form of ResultFile artifacts.

Prerequisites

Before you follow the example, make sure you have the following items:

Configured reagent types named Index 1 through Index 6 in Clarity LIMS.
Reagents of type Index 1 through Index 6 in Clarity LIMS.
A compatible version of API (v2 r14 to v2 r24).

Code Example

Create a Demultiplexing Process in the Clarity LIMS Operations Interface

Configure a process that generates ResultFile with process outputs that apply to inputs per reagent label. It is recommended to name your outputs in a way that clearly identifies the samples to which they correspond (eg, Results for {SubmittedSampleName}-{AppliedReagentLabels}).

Demultiplexing in the User Interface

Running the demultiplexing process on a labeled pooled input produces a process run in the Operations Interface, similar to the one illustrated below.

Note the following:

There were three reagent labels in the input analyte (sample) artifact. As a result, three outputs were generated (the process was configured to produce one output result file per label per input).
The names of the outputs of the demultiplexing process expose the original sample name and label.
The Operations Interface shows details of the genealogy from the downstream result file all the way back to the original sample.

While reagent labels are not explicitly exposed in the Clarity LIMS client user interface, genealogy views in the Operations Interface are aware of reagent labels and will show the true sample inheritance. As noted above, you can use the {AppliedReagentLabels} output naming variable to show the reagent labels applied to each artifact in the user interface.

Demultiplexing in the API with a Process POST

Executing a demultiplexing process by issuing a process POST via the REST API is similar to the typical process execution found in .

The key difference is that when executing a demultiplexing process through the REST API, outputs per reagent label are automatically generated from the inputs provided. You do not need to explicitly specify them.

For example, when running the demultiplexing process configured against a single (pooled) sample, you could post a process execution representation like this:

The input-output-map only refers to inputs, not outputs, because the demultiplexing process is configured to exclusively produce outputs per reagent label.

If your process produces other outputs, such as shared or per-input outputs, you must explicitly specify input-output-maps for them.

Verify with the REST API

Irrespective of whether you use the user interface or the REST API to run the demultiplexing process, the REST API representation for the process looks something like this:

For each input with reagent labels, one output was created per reagent label.

In the example, the process ran on one pooled input, and produced three outputs (the pooled input included three reagent labels). The following example shows one of the demultiplexed result file outputs:

The output contains only one reagent label, and relates only to the sample that was tagged with the same reagent label. Compare this to the case of a pooled artifact, which has several labels and relates to several samples. This level of traceability (from a demultiplexed output back to its specific original sample) is only possible because the artifacts were labeled before they were pooled.

The artifact name generated by the demultiplexing process output name pattern is ("Results for SAM-3 - Index 3"). You can use the {SubmittedSampleName} naming variable to show true ancestors, and the {AppliedReagentLabels} to show any reagent labels applied to an output.

Pool Samples with Reagent Labels

Before pooling samples in a multiplexed workflow, apply reagent labels using one of the methods described in . After the analyte (derived sample) artifacts are labeled, they can be pooled together without loss of traceability.

Pooling samples is accomplished either by running a pooling step in the user interface, or by using the process resource in the REST API.

For an overview of how REST resources are structured, and to learn how the process resource is used to track workflow in Clarity LIMS, see and .

Prerequisites

Apply Reagent Labels with REST

Reagent labels are artifact resource elements and can be applied using a PUT. To apply a reagent label to an artifact using REST, the following steps are required:

GET the artifact representation.
Insert a reagent-label element with the intended label name.
PUT the modified artifact representation back.

You can apply the reagent label to the original analyte (sample) artifact or to a downstream sample or result file.

Prerequisites

Before you follow the example, make sure that you have the following items:

Reagent types that are configured in Clarity LIMS and are named index 1 through index 6.
Reagents of type index 1 through index 6 that have been added to Clarity LIMS.
A compatible version of API (v2 r14 to v2 r24).

Code Example

In this example, you can adjust the following code:

By inserting the reagent-label element, you end up with the following code.

Although it is not mandatory, it is recommended that you name reagent labels after reagent types using the Index special type. This allows you to relate the reagent label back to its sequence.

Apply Reagent Labels When Samples are Imported

When importing sample data into Clarity LIMS using a spreadsheet, you can specify the reagent labels to be applied during the import process. To do this, you must include the reagent label names in the spreadsheet, in a column named Sample/Reagent Label.

Prerequisites

Before you follow the example, make sure that you have the following items:

Reagent types that are configured in Clarity LIMS and are named index 1 through index 6.
Reagents of type index 1 through index 6 that have been added to Clarity LIMS.
A compatible version of API (v2 r14 to v2 r24).

Code Example

The following example spreadsheet would import six samples into the system. These samples are Sample-1 through Sample-6 with reagent labels Index 1 through Index 6:

Although not mandatory, it is recommended that you name reagent labels after reagent types using the Index special type. This allows you to relate the reagent label back to its sequence.

Verify with the REST API

If you examine the REST API representation of the samples imported, you are able to verify the following:

The sample representation shows no indication that reagent labels were applied.
The sample artifact (the analyte artifact linked from the sample representation) will indicate the label applied via the <reagent-label> element.

The following example shows how an imported sample artifact (Sample-1), with reagent label name applied (Index 1), appears when verified via the REST API:

Apply Reagent Labels by Adding Reagents to Samples

If your samples are already in Clarity LIMS, you can assign reagent labels by running the Add Multiple Reagents process/protocol step from the Clarity LIMS user interface. Adding a reagent implicitly assigns a reagent label to every sample artifact. The reagent label applied is derived from the reagent type used.

Prerequisites

Before you follow the example, make sure that you have the following items:

Demultiplexing

Prerequisites

Before you follow the example, make sure you have the following items:

Configured reagent types named Index 1 through Index 6 in Clarity LIMS.
Reagents of type Index 1 through Index 6 in Clarity LIMS.
A compatible version of API (v2 r14 to v2 r24).

Code Example

Create a Demultiplexing Process in the Clarity LIMS Operations Interface

Demultiplexing in the User Interface

Running the demultiplexing process on a labeled pooled input produces a process run in the Operations Interface, similar to the one illustrated below.

Note the following:

There were three reagent labels in the input analyte (sample) artifact. As a result, three outputs were generated (the process was configured to produce one output result file per label per input).
The names of the outputs of the demultiplexing process expose the original sample name and label.
The Operations Interface shows details of the genealogy from the downstream result file all the way back to the original sample.

Demultiplexing in the API with a Process POST

Executing a demultiplexing process by issuing a process POST via the REST API is similar to the typical process execution found in .

For example, when running the demultiplexing process configured against a single (pooled) sample, you could post a process execution representation like this:

The input-output-map only refers to inputs, not outputs, because the demultiplexing process is configured to exclusively produce outputs per reagent label.

If your process produces other outputs, such as shared or per-input outputs, you must explicitly specify input-output-maps for them.

Verify with the REST API

Irrespective of whether you use the user interface or the REST API to run the demultiplexing process, the REST API representation for the process looks something like this:

For each input with reagent labels, one output was created per reagent label.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <prc:process xmlns:udf="http://genologics.com/ri/userdefined" xmlns:file="http://genologics.com/ri/file" xmlns:prc="http://genologics.com/ri/process" uri="http://yourIPaddress/api/v2/processes/DMX-RCX-110816-24-95" limsid="DMX-RCX-110816-24-95"> <type uri="http://yourIPaddress/api/v2/processtypes/38">Demultiplex</type> <date-run>2011-08-12</date-run> <technician uri="http://yourIPaddress/api/v2/researchers/4"> <first-name>RC</first-name> <last-name>RC</last-name> </technician> <input-output-map> <input post-process-uri="http://yourIPaddress/api/v2/artifacts/2-424?state=335" uri="http://yourIPaddress/api/v2/artifacts/2-424?state=324" limsid="2-424"> <parent-process uri="http://yourIPaddress/api/v2/processes/PSA-RCX-110812-122-221" limsid="PSA-RCX-110812-122-221" /> </input> <output uri="http://yourIPaddress/api/v2/artifacts/92-163?state=339" output-generation-type="PerReagentLabel" output-type="ResultFile" limsid="92-163" /> </input-output-map> <input-output-map> <input post-process-uri="http://yourIPaddress/api/v2/artifacts/2-424?state=335" uri="http://yourIPaddress/api/v2/artifacts/2-424?state=324" limsid="2-424"> <parent-process uri="http://yourIPaddress/api/v2/processes/PSA-RCX-110812-122-221" limsid="PSA-RCX-110812-122-221" /> </input> <output uri="http://yourIPaddress/api/v2/artifacts/92-164?state=336" output-generation-type="PerReagentLabel" output-type="ResultFile" limsid="92-164" /> </input-output-map> <input-output-map> <input post-process-uri="http://yourIPaddress/api/v2/artifacts/2-424?state=335" uri="http://yourIPaddres/api/v2/artifacts/2-424?state=324" limsid="2-424"> <parent-process uri="http://yourIPaddress/api/v2/processes/PSA-RCX-110812-122-221" limsid="PSA-RCX-110812-122-221" /> </input> <output uri="http://yourIPaddress/api/v2/artifacts/92-162?state=338" output-generation-type="PerReagentLabel" output-type="ResultFile" limsid="92-162" /> </input-output-map> </prc:process>

Work with Multiplexing

Find the Index Sequence for a Reagent Label

hashtagCode Example

hashtagStep 1. Configure Index Reagent Types

hashtagStep 2. Retrieve the sequence for a reagent label using the REST API

hashtagAttachments

Demultiplexing

hashtagPrerequisites

hashtagCode Example

hashtagCreate a Demultiplexing Process in the Clarity LIMS Operations Interface

hashtagDemultiplexing in the User Interface

hashtagDemultiplexing in the API with a Process POST

hashtagVerify with the REST API

Pool Samples with Reagent Labels

hashtagPrerequisites

Apply Reagent Labels with REST

hashtagPrerequisites

hashtagCode Example

Apply Reagent Labels When Samples are Imported

hashtagPrerequisites

hashtagCode Example

hashtagVerify with the REST API

Apply Reagent Labels by Adding Reagents to Samples

hashtagPrerequisites

Work with Multiplexing

Find the Index Sequence for a Reagent Label

hashtagCode Example

hashtagStep 1. Configure Index Reagent Types

hashtagStep 2. Retrieve the sequence for a reagent label using the REST API

hashtagAttachments

Apply Reagent Labels by Adding Reagents to Samples

hashtagPrerequisites

hashtagCode Example

hashtagRun the Add Multiple Reagents process

hashtagVerify with the REST API

Apply Reagent Labels with REST

hashtagPrerequisites

hashtagCode Example

Demultiplexing

hashtagPrerequisites

hashtagCode Example

hashtagCreate a Demultiplexing Process in the Clarity LIMS Operations Interface

hashtagDemultiplexing in the User Interface

hashtagDemultiplexing in the API with a Process POST

hashtagVerify with the REST API

Apply Reagent Labels When Samples are Imported

hashtagPrerequisites

hashtagCode Example

hashtagVerify with the REST API

Pool Samples with Reagent Labels

hashtagPrerequisites

hashtagCode Example

hashtagPooling in the User Interface

hashtagPooling in the API with a Process POST

hashtagVerify with the REST API

hashtagAttachments

Code Example

Step 1. Configure Index Reagent Types

Step 2. Retrieve the sequence for a reagent label using the REST API

Attachments

Prerequisites

Code Example

Create a Demultiplexing Process in the Clarity LIMS Operations Interface

Demultiplexing in the User Interface

Demultiplexing in the API with a Process POST

Verify with the REST API

Prerequisites

Prerequisites

Code Example

Prerequisites

Code Example

Verify with the REST API

Prerequisites

Code Example

Step 1. Configure Index Reagent Types

Step 2. Retrieve the sequence for a reagent label using the REST API

Attachments

Prerequisites

Code Example

Run the Add Multiple Reagents process

Verify with the REST API

Prerequisites

Code Example

Prerequisites

Code Example

Create a Demultiplexing Process in the Clarity LIMS Operations Interface

Demultiplexing in the User Interface

Demultiplexing in the API with a Process POST

Verify with the REST API

Prerequisites

Code Example

Verify with the REST API

Prerequisites

Code Example

Pooling in the User Interface

Pooling in the API with a Process POST

Verify with the REST API

Attachments