# Equalizer v1.1

## Overview

The Equalizer Workflow AmpliSeq for Illumina Immune Response Panel is part of the AmpliSeq for Illumina Immune Response Panel protocols that include the following functionality:

* Preconfigured AmpliSeq for Illumina Immune Response Panel protocol that supports the preparation of up to 96 uniquely indexed libraries of total RNA using the AmpliSeq for Illumina workflow.
* Automated calculation of sample and buffer volumes.
* Automated calculation or display of reagents at every step in the protocol.
* Automatic step transition when required.
* Automatic placement of samples when necessary.
* Automated assignment of QC Pass/Fail, based on user-selected threshold values.
* There is no extraction protocol in this workflow because the samples are already extracted.

## Protocol 1: Equalizer Workflow (AmpliSeq for Illumina Immune Response Panel v1.1)

Protocol Type = Library Prep

**Next Steps Configuration**

<figure><img src="https://2084401275-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfjuebS41N49G1Eh55hP7%2Fuploads%2Fgit-blob-281d34592cfe15f9504f7dd1a2cdaa4ab9890a2e%2Fampliseq-response-equ-next-step-config.png?alt=media" alt=""><figcaption></figcaption></figure>

### Step 1: Clean Up Library (AmpliSeq for Illumina Immune Response Panel v1.1)

* Master Step Name = Clean Up Library (AmpliSeq for Illumina v1.1)
* Step Type = No Outputs
* Reagent Kits
  * Agencourt AMPure XP Beads
    * Supplier = Thermo
    * Catalog Number = NC9959336; NC9933872

#### Automations

<figure><img src="https://2084401275-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfjuebS41N49G1Eh55hP7%2Fuploads%2Fgit-blob-26c7331686540ba00506e60b89ebd80ed9b34b08%2Fampliseq-response-equ-step1-automation.png?alt=media" alt=""><figcaption></figcaption></figure>

<details>

<summary>Set Next Step - Advance</summary>

* Trigger Location = Record Details
* Trigger Style = Automatic upon exit

{% code overflow="wrap" %}

```markup
bash -l -c "/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 {compoundOutputFileLuid0}"
```

{% endcode %}

</details>

#### Queue/Ice Bucket

* Defaults
  * Sample Grouping = Group by Containers
  * Well Sort Order = Row
* Sample Table (Column Headers)

  | **Category**   | **Field Name**      | **Field Type** | **Options** | **Additional Options and Dropdown Items** |
  | -------------- | ------------------- | -------------- | ----------- | ----------------------------------------- |
  | Container      | Container Name      | Built-in       |             |                                           |
  | Container      | LIMS ID (Container) | Built-in       |             |                                           |
  | Container      | Well                | Built-in       |             |                                           |
  | Derived Sample | Sample Name         | Built-in       |             |                                           |
  | Derived Sample | Waiting             | Built-in       |             |                                           |
  | Project        | Project Name        | Built-in       |             |                                           |

#### Record Details

* Step Data (Master Step Fields)

  | **Field Name**     | **Field Type** | **Options** | **Additional Options and Dropdown Items** |
  | ------------------ | -------------- | ----------- | ----------------------------------------- |
  | 70% EtOH Prep Date | Date           |             |                                           |
* Step File Placeholders
  * Log - Automatically attached
* Sample Table
  * Sample Display Default = Expand
  * Well Sort Order = Row
  * Table Columns - Global Fields

    | **Category**   | **Field Name**      | **Field Type** | **Options** | **Additional Options and Dropdown Items** |
    | -------------- | ------------------- | -------------- | ----------- | ----------------------------------------- |
    | Container      | Container Name      | Built-in       |             |                                           |
    | Container      | LIMS ID (Container) | Built-in       |             |                                           |
    | Container      | Well                | Built-in       |             |                                           |
    | Derived Sample | Sample Name         | Built-in       |             |                                           |
    | Project        | Project Name        | Built-in       |             |                                           |

### Step 2: Amplify Library (AmpliSeq for Illumina Immune Response Panel v1.1)

* Master Step Name = Amplify Library (AmpliSeq for Illumina v1.1)
* Step Type = No Outputs

#### Automations

<figure><img src="https://2084401275-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfjuebS41N49G1Eh55hP7%2Fuploads%2Fgit-blob-127d523cf30554d300ba33b35204131ee0db497a%2Fampliseq-response-equ-step2-automation.png?alt=media" alt=""><figcaption></figcaption></figure>

<details>

<summary>Count Samples and Calculate Master Mix</summary>

* Trigger Location = Record Details
* Trigger Style = Automatic upon entry

{% code overflow="wrap" %}

```markup
bash -l -c "/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 'step.::Total Samples:: = step.::Total Samples:: + 1' \
      -log {compoundOutputFileLuid0} && /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 'step.::1X Lib AMP Mix (uL):: = step.::Total Samples:: * 1.1 * 45 ; \
step.::10X Library Amp Primers (uL):: = step.::Total Samples:: * 1.1 * 5' \
      -log {compoundOutputFileLuid0}"
```

{% endcode %}

</details>

<details>

<summary>Set Next Step - Advance</summary>

* Trigger Location = Record Details
* Trigger Style = Automatic upon exit

{% code overflow="wrap" %}

```markup
bash -l -c "/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 {compoundOutputFileLuid0}"
```

{% endcode %}

</details>

<details>

<summary>Calculate Total Samples and Calculate Master Mix</summary>

* Trigger Location = Not Used

{% code overflow="wrap" %}

```markup
bash -l -c "/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 'step.::Total Samples:: = step.::Total Samples:: + 1' \ -log {compoundOutputFileLuid0} && /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 'step.::1X Lib Amp Mix:: = step.::Total Samples:: * 1.1 * 45 ; \ step.::10X Library Amp Primers:: = step.::Total Samples:: * 1.1 * 5' \ -log {compoundOutputFileLuid0}"
```

{% endcode %}

</details>

#### Queue/Ice Bucket

* Defaults
  * Sample Grouping = Group by Containers
  * Well Sort Order = Row
* Sample Table (Column Headers)

  | **Category**   | **Field Name**      | **Field Type** | **Options** | **Additional Options and Dropdown Items** |
  | -------------- | ------------------- | -------------- | ----------- | ----------------------------------------- |
  | Container      | Container Name      | Built-in       |             |                                           |
  | Container      | LIMS ID (Container) | Built-in       |             |                                           |
  | Container      | Well                | Built-in       |             |                                           |
  | Derived Sample | Sample Name         | Built-in       |             |                                           |
  | Derived Sample | Waiting             | Built-in       |             |                                           |
  | Project        | Project Name        | Built-in       |             |                                           |

#### Record Details

**Group of Defaults**

<details>

<summary>AmpliSeq for CHS V2</summary>

* Thermal Cycler Program = AMP

</details>

<details>

<summary>Equalizer Workflow</summary>

* Thermal Cycler Program = EQUAL

</details>

<details>

<summary>Standard Workflow</summary>

* Thermal Cycler Program = AMP\_7

</details>

* Step Data
  * Group of Defaults = Equalizer Workflow
  * Master Step Fields

    | **Field Name**               | **Field Type** | **Options**    | **Additional Options and Dropdown Items**                        |
    | ---------------------------- | -------------- | -------------- | ---------------------------------------------------------------- |
    | 1X Lib AMP Mix (uL)          | Numeric        |                | Decimal Places Displayed = 2                                     |
    | 10X Library Amp Primers (uL) | Numeric        |                | Decimal Places Displayed = 2                                     |
    | Thermal Cycler Program       | Text Dropdown  | Custom Entries | <p>Presets</p><ul><li>AMP\_7</li><li>EQUAL</li><li>AMP</li></ul> |
    | Total Samples                | Numeric        |                | Default = 0                                                      |
* Step File Placeholders
  * Log - Automatically attached
* Sample Table
  * Sample Display Default = Expand
  * Well Sort Order = Row
  * Table Columns - Global Fields

    | **Category**   | **Field Name**      | **Field Type** | **Options** | **Additional Options and Dropdown Items** |
    | -------------- | ------------------- | -------------- | ----------- | ----------------------------------------- |
    | Container      | Container Name      | Built-in       |             |                                           |
    | Container      | LIMS ID (Container) | Built-in       |             |                                           |
    | Container      | Well                | Built-in       |             |                                           |
    | Derived Sample | Sample Name         | Built-in       |             |                                           |
    | Project        | Project Name        | Built-in       |             |                                           |

### Step 3: Perform Capture and Clean Up (AmpliSeq for Illumina Immune Response Panel v1.1)

* Master Step Name = Perform Capture and Clean Up (AmpliSeq for Illumina v1.1)
* Step Type = Standard
* Derived Sample Generation = Fixed, 1
* Naming Convention = {InputItemName}
* Reagent Kits
  * AmpliSeq Library Equalizer for Illumina
    * Supplier = Illumina
    * Website = [www.illumina.com](https://www.illumina.com)

#### Automations

<figure><img src="https://2084401275-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfjuebS41N49G1Eh55hP7%2Fuploads%2Fgit-blob-2d4fe0da1b0ab0b694b5ccf65ec81e48f4e21432%2Fampliseq-response-equ-step3-automation.png?alt=media" alt=""><figcaption></figcaption></figure>

<details>

<summary>Set Next Step - Advance</summary>

* Trigger Location = Record Details
* Trigger Style = Automatic upon exit

{% code overflow="wrap" %}

```markup
bash -l -c "/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 {compoundOutputFileLuid0}"
```

{% endcode %}

</details>

#### Queue/Ice Bucket

* Defaults
  * Sample Grouping = Group by Containers
  * Well Sort Order = Row
* Sample Table (Column Headers)

  | **Category**   | **Field Name**      | **Field Type** | **Options** | **Additional Options and Dropdown Items** |
  | -------------- | ------------------- | -------------- | ----------- | ----------------------------------------- |
  | Container      | Container Name      | Built-in       |             |                                           |
  | Container      | LIMS ID (Container) | Built-in       |             |                                           |
  | Container      | Well                | Built-in       |             |                                           |
  | Derived Sample | Sample Name         | Built-in       |             |                                           |
  | Derived Sample | Waiting             | Built-in       |             |                                           |
  | Project        | Project Name        | Built-in       |             |                                           |

#### Record Details

* Step File Placeholders
  * Log - Automatically attached
* Sample Table
  * Sample Display Default = Expand
  * Well Sort Order = Row
  * Table Columns - Global Fields

    | **Category**   | **Field Name**      | **Field Type** | **Options** | **Additional Options and Dropdown Items** |
    | -------------- | ------------------- | -------------- | ----------- | ----------------------------------------- |
    | Container      | Container Name      | Built-in       |             |                                           |
    | Container      | LIMS ID (Container) | Built-in       |             |                                           |
    | Container      | Well                | Built-in       |             |                                           |
    | Derived Sample | Sample Name         | Built-in       |             |                                           |
    | Project        | Project Name        | Built-in       |             |                                           |

### Step 4: Elute Library (AmpliSeq for Illumina Immune Response Panel v1.1)

* Master Step Name = Elute Library (AmpliSeq for Illumina v1.1)
* Step Type = Standard
* Derived Sample Generation = Fixed, 1
* Naming Convention = {InputItemName}

#### Automations

<figure><img src="https://2084401275-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfjuebS41N49G1Eh55hP7%2Fuploads%2Fgit-blob-f3b630f9f03506f0257dc60ae36e33afbc185f82%2Fampliseq-response-equ-step4-automation.png?alt=media" alt=""><figcaption></figcaption></figure>

<details>

<summary>Set Next Step - Advance</summary>

* Trigger Location = Record Details
* Trigger Style = Automatic upon exit

{% code overflow="wrap" %}

```markup
bash -l -c "/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 {compoundOutputFileLuid0}"
```

{% endcode %}

</details>

#### Queue/Ice Bucket

* Defaults
  * Sample Grouping = Group by Containers
  * Well Sort Order = Row
* Sample Table (Column Headers)

  | **Category**   | **Field Name**      | **Field Type** | **Options** | **Additional Options and Dropdown Items** |
  | -------------- | ------------------- | -------------- | ----------- | ----------------------------------------- |
  | Container      | Container Name      | Built-in       |             |                                           |
  | Container      | LIMS ID (Container) | Built-in       |             |                                           |
  | Container      | Well                | Built-in       |             |                                           |
  | Derived Sample | Sample Name         | Built-in       |             |                                           |
  | Derived Sample | Waiting             | Built-in       |             |                                           |
  | Project        | Project Name        | Built-in       |             |                                           |

#### Placement = Enabled

* Defaults
  * Sample Grouping = Group by Containers
  * Well Sort Order = Row
  * Placement Pattern = Column
* Destination Containers
  * 96 well plate

#### Record Details

* Step Data (Master Step Fields)

  | **Field Name**         | **Field Type** | **Options** | **Additional Options and Dropdown Items** |
  | ---------------------- | -------------- | ----------- | ----------------------------------------- |
  | Thermal Cycler Program | Text           |             | Default = ELUTE                           |
* Step File Placeholders
  * Log - Automatically attached
* Sample Table
  * Sample Display Default = Expand
  * Well Sort Order = Row
  * Table Columns - Global Fields

    | **Category**   | **Field Name**      | **Field Type** | **Options** | **Additional Options and Dropdown Items** |
    | -------------- | ------------------- | -------------- | ----------- | ----------------------------------------- |
    | Container      | Container Name      | Built-in       |             |                                           |
    | Container      | LIMS ID (Container) | Built-in       |             |                                           |
    | Container      | Well                | Built-in       |             |                                           |
    | Derived Sample | Sample Name         | Built-in       |             |                                           |
    | Project        | Project Name        | Built-in       |             |                                           |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.connected.illumina.com/clarity-lims/library-prep/ampliseq/immune-response-panel/ampliseq-response-equ-v1.1.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.