# Equalizer v1.1

## Overview

The Equalizer Workflow AmpliSeq for Illumina Myeloid Panel is part of the AmpliSeq for Illumina Myeloid Panel protocols which include the following functionality:

* Preconfigured AmpliSeq for Illumina Myeloid Panel protocol that supports the preparation of up to 96 uniquely indexed libraries of genomic DNA or 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 Myeloid 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-d6b6659fe29440ecec05472e6fb4e4ab2cdf0c86%2Fampliseq-mye-equ-next-step-config.png?alt=media" alt=""><figcaption></figcaption></figure>

### Step 1: Clean Up Library (AmpliSeq for Illumina Myeloid 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-672b5f22b17365a481d787cb6efaff7d2caac304%2Fampliseq-mye-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 Myeloid 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-6a78dd7cb808802a4f475f0fd36bbd95f99271de%2Fampliseq-mye-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 Myeloid 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-f7805cf300f7f6acac6d4ab6355e7134f2b166b1%2Fampliseq-mye-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 Myeloid 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-43b5c5cbd573c13e9e2a0c89d56f4231c6d2b734%2Fampliseq-mye-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       |             |                                           |