# RNA Library Prep v1.1

## Overview

The RNA Library Prep AmpliSeq for Illumina Comprehensive Panel v3 is part of the AmpliSeq for Illumina Comprehensive Panel protocols that include the following functionality:

* Preconfigured AmpliSeq for Illumina Comprehensive 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.

## Protocol 1: RNA Library Prep (AmpliSeq for Illumina Comprehensive Panel v3 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-e07b6af6e168ff031d09ddfe352e1d06720ef356%2Fampliseq-cp-v3-rna-next-step-config.png?alt=media" alt=""><figcaption></figcaption></figure>

### Step 1: Dilute RNA (AmpliSeq for Illumina Comprehensive Panel v3 v1.1)

* Master Step Name = Dilute RNA (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-1315ef106ac7a490c6df5a73cb61a4d4d1c893d5%2Fampliseq-cp-v3-rna-step1-automation.png?alt=media" alt=""><figcaption></figcaption></figure>

<details>

<summary>Copy Concentration and Set Sample Volume</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 'output.::Concentration:: = input.::Concentration:: ; output.::Conc. Units:: = input.::Conc. Units:: ; output.::Sample Volume (uL):: = 5' \
-log {compoundOutputFileLuid0}"
```

{% endcode %}

</details>

<details>

<summary>Calculate Input Amount - RNA</summary>

* Trigger Location = Record Details
* Trigger Style = Manual button

{% 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 true \
        -h false \
        -exp 'output.::Total Volume (uL):: = (output.::Concentration::/step.::Desired Concentration (ng/uL)::) * output.::Sample Volume (uL):: ; \
output.::Nuclease-free water (uL):: = output.::Total Volume (uL):: - output.::Sample Volume (uL):: ; \
output.::Input Amount (ng):: = step.::Desired Concentration (ng/uL):: * output.::Total Volume (uL):: ' \
        -log {compoundOutputFileLuid0}"
```

{% endcode %}

</details>

<details>

<summary>Copy Desired Concentration</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 'output.::Desired Concentration (ng/uL):: = step.::Desired Concentration (ng/uL)::' \
-log {compoundOutputFileLuid0}"
```

{% endcode %}

</details>

<details>

<summary>Set Next Step - Advance</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 '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**                                                 |
  | ----------------------------- | -------------- | ----------- | ----------------------------------------------------------------------------------------- |
  | Desired Concentration (ng/uL) | Numeric        |             | Range = 0 To 1000                                                                         |
  | Directions                    | Multiline Text | Read Only   | Default = If enough RNA is available, dilute to intermediate concentration \~20-50 ng/uL. |
* 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** |
    | -------------- | ------------------------ | -------------- | -------------- | ----------------------------------------- |
    | Derived Sample | Concentration            | Numeric        | Required Field | Decimal Places Displayed = 2              |
    | Derived Sample | Conc. Units              | Text           | Required Field |                                           |
    | Derived Sample | Input Amount (ng)        | Numeric        |                | Decimal Places Displayed = 0              |
    | Derived Sample | Nuclease-free water (uL) | Numeric        |                | Decimal Places Displayed = 2              |
    | Derived Sample | Sample Name              | Built-in       |                |                                           |
    | Derived Sample | Sample Volume (uL)       | Numeric        |                | Decimal Places Displayed = 2              |
    | Derived Sample | Total Volume (uL)        | Numeric        |                | Decimal Places Displayed = 2              |

### Step 2: Qubit (AmpliSeq for Illumina Comprehensive Panel v3 v1.1)

* Master Step Name = Qubit (AmpliSeq for Illumina v1.1)
* Step Type = Standard QC
* Measurement 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-e31b4caabf152440259053a055493829409a6eda%2Fampliseq-cp-v3-rna-step2-automation.png?alt=media" alt=""><figcaption></figcaption></figure>

<details>

<summary>Assign QC flags (Qubit QC)</summary>

* Trigger Location = Record Details
* Trigger Style = Manual button

{% 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 {processURI:v2} -u {username} -p {password} script:assignQC -log {compoundOutputFileLuid1} -qcResult {compoundOutputFileLuid2}"
```

{% endcode %}

</details>

<details>

<summary>Set Next Step and Copy Concentration</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:: ; input.::Concentration:: = output.::Concentration:: ; input.::Conc. Units:: = output.::Conc. Units::' -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** |
  | ------------------------------ | -------------- | ----------- | ----------------------------------------- |
  | Criteria 1 - Operator          | Text           |             | Default = >=                              |
  | Criteria 1 - Source Data Field | Text           |             | Default = Concentration                   |
  | Criteria 1 - Threshold Value   | Numeric        |             |                                           |
  | Criteria 2 - Operator          | Text           |             | Default = <=                              |
  | Criteria 2 - Source Data Field | Text           |             | Default = Concentration                   |
  | Criteria 2 - Threshold Value   | Numeric        |             |                                           |
* Step File Placeholders
  * Log - Automatically attached
  * QC Log File - Automatically attached
  * QC Result File - Automatically attached
  * Upload File - Manually uploaded
* Sample Table
  * Enable QC Flags = Yes
  * Sample Display Default = Expand
  * Well Sort Order = Row
  * File Column Options
    * File Column Display = Hide
    * File Attachment Method = Auto
  * Table Columns - Global Fields

    | **Category**   | **Field Name** | **Field Type** | **Options**    | **Additional Options and Dropdown Items** |
    | -------------- | -------------- | -------------- | -------------- | ----------------------------------------- |
    | Derived Sample | Concentration  | Numeric        | Required Field | Decimal Places Displayed = 2              |
    | Derived Sample | Conc. Units    | Text           | Required Field |                                           |
    | Derived Sample | Sample Name    | Built-in       |                |                                           |
    | Measurement    | Concentration  | Numeric        |                | Decimal Places Displayed = 2              |
    | Measurement    | Conc. Units    | Text           |                |                                           |

### Step 3: Dilute RNA (AmpliSeq for Illumina Comprehensive Panel v3 v1.1)

* Master Step Name = Dilute RNA (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-bc8286b734deda8ccc3c2aa0cbd75b24b02394e9%2Fampliseq-cp-v3-rna-step3-automation.png?alt=media" alt=""><figcaption></figcaption></figure>

<details>

<summary>Copy Concentration and Set Sample Volume</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 'output.::Concentration:: = input.::Concentration:: ; output.::Conc. Units:: = input.::Conc. Units:: ; output.::Sample Volume (uL):: = 5' \
-log {compoundOutputFileLuid0}"
```

{% endcode %}

</details>

<details>

<summary>Calculate Input Amount - RNA</summary>

* Trigger Location = Record Details
* Trigger Style = Manual button

{% 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 true \
        -h false \
        -exp 'output.::Total Volume (uL):: = (output.::Concentration::/step.::Desired Concentration (ng/uL)::) * output.::Sample Volume (uL):: ; \
output.::Nuclease-free water (uL):: = output.::Total Volume (uL):: - output.::Sample Volume (uL):: ; \
output.::Input Amount (ng):: = step.::Desired Concentration (ng/uL):: * output.::Total Volume (uL):: ' \
        -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>Copy Desired Concentration</summary>

* Trigger Location = Step
* 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 'output.::Desired Concentration (ng/uL):: = step.::Desired Concentration (ng/uL)::' \
-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**                                                 |
  | ----------------------------- | -------------- | ----------- | ----------------------------------------------------------------------------------------- |
  | Desired Concentration (ng/uL) | Numeric        |             | Range = 0 To 1000                                                                         |
  | Directions                    | Multiline Text | Read Only   | Default = If enough RNA is available, dilute to intermediate concentration \~20-50 ng/uL. |
* 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** |
    | -------------- | ------------------------ | -------------- | -------------- | ----------------------------------------- |
    | Derived Sample | Concentration            | Numeric        | Required Field | Decimal Places Displayed = 2              |
    | Derived Sample | Conc. Units              | Text           | Required Field |                                           |
    | Derived Sample | Input Amount (ng)        | Numeric        |                | Decimal Places Displayed = 0              |
    | Derived Sample | Nuclease-free water (uL) | Numeric        |                | Decimal Places Displayed = 2              |
    | Derived Sample | Sample Name              | Built-in       |                |                                           |
    | Derived Sample | Sample Volume (uL)       | Numeric        |                | Decimal Places Displayed = 2              |
    | Derived Sample | Total Volume (uL)        | Numeric        |                | Decimal Places Displayed = 2              |

### Step 4: Reverse Transcribe (AmpliSeq for Illumina Comprehensive Panel v3 v1.1)

* Master Step Name = Reverse Transcribe RNA (AmpliSeq for Illumina v1.1)
* Step Type = Standard
* Derived Sample Generation = Fixed, 1
* Naming Convention = {InputItemName}
* Reagent Kits
  * AmpliSeq cDNA Synthesis for Illumina
    * Supplier = Illumina
    * Catalog Number = 20022654
    * Website = [www.illumina.com](https://www.illumina.com)

#### Automations

<figure><img src="https://github.com/illumina-swi/clarity-int-docs/blob/main/docs/int/resource/images/ipp/ampliseq/ampliseq-cp-v3-rna-step4-automation.pngg" alt=""><figcaption></figcaption></figure>

<details>

<summary>Copy Concentration, Total Volume and Input Amount</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 'output.::Concentration:: = input.::Concentration:: ; \
output.::Conc. Units:: = input.::Conc. Units:: ; \
output.::Total Volume (uL):: = input.::Total Volume (uL):: ; \
output.::Input Amount (ng):: = input.::Input Amount (ng):: ; \
step.::Desired Concentration (ng/uL):: = input.::Desired Concentration (ng/uL)::' \
-log {compoundOutputFileLuid0}"
```

{% endcode %}

</details>

<details>

<summary>Calculate Input Amount</summary>

* Trigger Location = Record Details
* Trigger Style = Manual button

{% 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 true \
-h false \
-exp 'step.::Prep Input Volume (uL):: = step.::Prep Input Amount (ng):: / step.::Desired Concentration (ng/uL):: ; \
if (step.::Prep Input Volume (uL):: < 7) {step.::Nuclease-free water (uL):: = (7 - step.::Prep Input Volume (uL)::) * step.::Total Samples::*1.1} else {step.::Nuclease-free water (uL):: = 0} ; \
step.::5X AmpliSeq cDNA Reaction Mix (uL):: = step.::Total Samples:: * 1.1 * 2 ; \
step.::10X AmpliSeq RT Enzyme Mix (uL):: = step.::Total Samples:: * 1.1 * 1' \
-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 Input Amount - Focus Panel</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 true \
-h false \
-exp 'step.::Prep Input Volume (uL):: = step.::Prep Input Amount (ng):: / step.::Desired Concentration (ng/uL):: ; \
if (step.::Prep Input Volume (uL):: < 7) {step.::Nuclease-free water (uL):: = (7 - step.::Prep Input Volume (uL)::) * step.::Total Samples::*1.1} else {step.::Nuclease-free water (uL):: = 0} ; \
step.::5X AmpliSeq cDNA Reaction Mix (uL):: = step.::Total Samples:: * 1.1 * 2; \
step.::10X AmpliSeq RT Enzyme Mix (uL):: = step.::Total Samples:: * 1.1 * 1' \
-log {compoundOutputFileLuid0}"
```

{% endcode %}

</details>

<details>

<summary>Calculate Input Amount - Immune Repertoire Panel</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 true \
-h false \
-exp 'step.::Prep Input Volume (uL):: = step.::Prep Input Amount (ng):: / step.::Desired Concentration (ng/uL):: ; \
if (step.::Prep Input Volume (uL):: < 3.5) {step.::Nuclease-free water (uL):: = (3.5 - step.::Prep Input Volume (uL)::) * step.::Total Samples::*1.1} else {step.::Nuclease-free water (uL):: = 0} ; \
step.::5X AmpliSeq cDNA Reaction Mix (uL):: = step.::Total Samples:: * 1.1 * 1 ; \
step.::10X AmpliSeq RT Enzyme Mix (uL):: = step.::Total Samples:: * 1.1 * 0.5' \
-log {compoundOutputFileLuid0}"
```

{% endcode %}

</details>

<details>

<summary>Calculate Input Amount - Immune Response Panel</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 true \
-h false \
-exp 'step.::Prep Input Volume (uL):: = step.::Prep Input Amount (ng):: / step.::Desired Concentration (ng/uL):: ; \
if (step.::Prep Input Volume (uL):: < 7.0) {step.::Nuclease-free water (uL):: = (7.0 - (step.::Prep Input Volume (uL):: + output.::AmpliSeq ERCC RNA Spike-in Volume (uL)::)) * step.::Total Samples::*1.1} else {step.::Nuclease-free water (uL):: = 0} ; \
step.::5X AmpliSeq cDNA Reaction Mix (uL):: = step.::Total Samples:: * 1.1 * 1 ; \
step.::10X AmpliSeq RT Enzyme Mix (uL):: = step.::Total Samples:: * 1.1 * 0.5 ; \
step.::AmpliSeq ERCC RNA Spike-in Mix (uL):: = step.::Total Samples:: * output.::AmpliSeq ERCC RNA Spike-in Volume (uL):: *1.1' \
-log {compoundOutputFileLuid0}"
```

{% endcode %}

</details>

<details>

<summary>Calculate Input Amount - Myeloid Panel</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 true \
-h false \
-exp 'step.::Prep Input Volume (uL):: = step.::Prep Input Amount (ng):: / step.::Desired Concentration (ng/uL):: ; \
if (step.::Prep Input Volume (uL):: < 3.5) {step.::Nuclease-free water (uL):: = (3.5 - step.::Prep Input Volume (uL)::) * step.::Total Samples::*1.1} else {step.::Nuclease-free water (uL):: = 0} ; \
step.::5X AmpliSeq cDNA Reaction Mix (uL):: = step.::Total Samples:: * 1.1 * 1 ; \
step.::10X AmpliSeq RT Enzyme Mix (uL):: = step.::Total Samples:: * 1.1 * 0.5' \
-log {compoundOutputFileLuid0}"
```

{% endcode %}

</details>

<details>

<summary>Calculate Input Amount - TCRbeta-SR</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 true \
-h false \
-exp 'step.::Prep Input Volume (uL):: = step.::Prep Input Amount (ng):: / step.::Desired Concentration (ng/uL):: ; \
if (step.::Prep Input Volume (uL):: < 7) {step.::Nuclease-free water (uL):: = (7 - step.::Prep Input Volume (uL)::) * step.::Total Samples::*1.1} else {step.::Nuclease-free water (uL):: = 0} ; \
step.::5X AmpliSeq cDNA Reaction Mix (uL):: = step.::Total Samples:: * 1.1 * 2 ; \
step.::10X AmpliSeq RT Enzyme Mix (uL):: = step.::Total Samples:: * 1.1 * 1' \
-log {compoundOutputFileLuid0}"
```

{% endcode %}

</details>

<details>

<summary>Calculate Input Amount - Transcriptome Human Genome Expression Panel</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 true \
-h false \
-exp 'step.::Prep Input Volume (uL):: = step.::Prep Input Amount (ng):: / step.::Desired Concentration (ng/uL):: ; \
if (step.::Prep Input Volume (uL):: < 3.5) {step.::Nuclease-free water (uL):: = (3.5 - (step.::Prep Input Volume (uL):: + output.::AmpliSeq ERCC RNA Spike-in Volume (uL)::)) * step.::Total Samples::*1.1} else {step.::Nuclease-free water (uL):: = 0} ; \
step.::5X AmpliSeq cDNA Reaction Mix (uL):: = step.::Total Samples:: * 1.1 * 1 ; \
step.::10X AmpliSeq RT Enzyme Mix (uL):: = step.::Total Samples:: * 1.1 * 0.5 ; \
step.::AmpliSeq ERCC RNA Spike-in Mix (uL):: = step.::Total Samples:: * output.::AmpliSeq ERCC RNA Spike-in Volume (uL):: *1.1' \
-log {compoundOutputFileLuid0}"
```

{% endcode %}

</details>

<details>

<summary>Calculate Input Amount- Custom RNA Panel</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 true \
-h false \
-exp 'step.::Prep Input Volume (uL):: = step.::Prep Input Amount (ng):: / step.::Desired Concentration (ng/uL):: ; \
if (step.::Prep Input Volume (uL):: < 7) {step.::Nuclease-free water (uL):: = (7 - step.::Prep Input Volume (uL)::) * step.::Total Samples::*1.1} else {step.::Nuclease-free water (uL):: = 0} ; \
step.::5X AmpliSeq cDNA Reaction Mix (uL):: = step.::Total Samples:: * 1.1 * 2; \
step.::10X AmpliSeq RT Enzyme Mix (uL):: = step.::Total Samples:: * 1.1 * 1' \
-log {compoundOutputFileLuid0}"
```

{% endcode %}

</details>

<details>

<summary>Copy Concentration, Total Volume and Input Amount - Myeloid</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 'output.::Concentration:: = input.::Desired Concentration (ng/uL):: ; \
output.::Conc. Units:: = input.::Conc. Units:: ; \
output.::Total Volume (uL):: = input.::Total Volume (uL):: ; \
output.::Input Amount (ng):: = input.::Input Amount (ng):: ; \
step.::Desired Concentration (ng/uL):: = input.::Desired Concentration (ng/uL)::' \
-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**                                                                                   |
  | ---------------------------------- | -------------- | ----------- | --------------------------------------------------------------------------------------------------------------------------- |
  | 5X AmpliSeq cDNA Reaction Mix (uL) | Numeric        |             | <ul><li>Decimal Places Displayed = 1</li></ul>                                                                              |
  | 10X AmpliSeq RT Enzyme Mix (uL)    | Numeric        |             | <ul><li>Decimal Places Displayed = 1</li></ul>                                                                              |
  | Desired Concentration (ng/uL)      | Numeric        | Read Only   |                                                                                                                             |
  | Nuclease-free water (uL)           | Numeric        |             | <ul><li>Decimal Places Displayed = 1</li></ul>                                                                              |
  | Prep Input Amount (ng)             | Numeric        |             | <ul><li>Default = 2</li><li>Range = 2 To 1000</li></ul>                                                                     |
  | Prep Input Volume (uL)             | Numeric        |             | <ul><li>Decimal Places Displayed = 2</li></ul>                                                                              |
  | Recommended Prep Input (ng)        | Multiline Text | Read Only   | <ul><li>Default = Each reaction requires 1-100 ng of DNase-treated total RNA. The recommended input is 10 ng RNA.</li></ul> |
  | Thermal Cycler Program             | Text           | Read Only   | <ul><li>Default = RT</li></ul>                                                                                              |
  | Total Samples                      | Numeric        |             | <ul><li>Default = 0</li><li>Decimal Places Displayed = 0</li></ul>                                                          |
* 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** |
    | -------------- | ----------------- | -------------- | -------------- | ----------------------------------------- |
    | Derived Sample | Concentration     | Numeric        | Required Field | Decimal Places Displayed = 2              |
    | Derived Sample | Conc. Units       | Text           | Required Field |                                           |
    | Derived Sample | Input Amount (ng) | Numeric        |                | Decimal Places Displayed = 0              |
    | Derived Sample | Sample Name       | Built-in       |                |                                           |
    | Derived Sample | Total Volume (uL) | Numeric        |                | Decimal Places Displayed = 2              |

### Step 5: Amplify cDNA Targets (AmpliSeq for Illumina Comprehensive Panel v3 v1.1)

* Master Step Name = Amplify cDNA Targets (AmpliSeq for Illumina v1.1)
* Step Type = Standard
* Derived Sample Generation = Fixed, 2
* Naming Convention = {InputItemName}\_{OutputItemSubsetNumber}
* Reagent Kits
  * AmpliSeq Comprehensive Panel v3 for Illumina
    * Supplier = Illumina
    * Catalog Number = 20019109
  * AmpliSeq Library PLUS for Illumina
    * Supplier = Illumina
    * Catalog Number = 24 - 20019101; 96 - 200191102; 384 - 200191103
    * 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-f2e61eae2a15cc3703f7569a0d2009dd10953964%2Fampliseq-cp-v3-rna-step5-automation.png?alt=media" alt=""><figcaption></figcaption></figure>

<details>

<summary>Set Sample Type 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 'output.::Sample Type:: = ::cDNA:: ; \
step.::5X AmpliSeq HiFi Mix (uL):: = 4.5 * step.::Total Samples:: * 1.1 ; \
step.::Nuclease-free water (uL):: = 3.5 * step.::Total Samples:: * 1.1' \
-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>Routing Samples</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 -u {username} -p {password} -i {stepURI:v2} -l {compoundOutputFileLuid0} script:changeWorkflow \
\
--FIELD_NAME 'Sample Type' \
--FIELD_VALUE 'cDNA' \
--WORKFLOW 'DNA Library Prep AmpliSeq for Illumina Childhood Cancer Panel v1.1' \
--STEP 'Transfer RNA and DNA Amplicons (AmpliSeq for Illumina Childhood Cancer Panel v1.1)' \
--INPUTS_OR_OUTPUTS 'OUTPUTS' "
```

{% endcode %}

> ℹ The workflow version and step version for the routing script may vary depending on the version of the IPP.

</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**                                                                                                                                                       |
  | ------------------------------------- | -------------- | ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  | 5X AmpliSeq HiFi Mix (uL)             | Numeric        |             | Decimal Places Displayed = 2                                                                                                                                                                    |
  | Instructions - Comprehensive Panel v3 | Multiline Text |             | <p>Default =<br>Add 2 µl 5X AmpliSeq Comprehensive RNA Panel v3 Pool 1 (red cap) to the first well.<br>Add 2 µl 5X AmpliSeq Comprehensive RNA Panel v3 Pool 2 (red cap) to the second well.</p> |
  | Nuclease-free water (uL)              | Numeric        |             | Decimal Places Displayed = 2                                                                                                                                                                    |
  | Thermal Cycler Program                | Text           |             | Default = AMP\_RNA                                                                                                                                                                              |
* 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 6: Partially Digested Amplicons (AmpliSeq for Illumina Comprehensive Panel v3 v1.1)

* Master Step Name = Partially Digested Amplicons with Pooling (AmpliSeq for Illumina v1.1)
* Step Type = Pooling
* Aliquot Generation = Fixed, 1
* Naming Convention = {PoolName}
* Reagent Kits
  * AmpliSeq Library PLUS for Illumina
    * Supplier = Illumina
    * Catalog Number = 24 - 20019101; 96 - 200191102; 384 - 200191103
    * 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-26c89e61d75b6c1026aa0852fb87f470a1199072%2Fampliseq-cp-v3-rna-step6-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>

<details>

<summary>Route AmpliSeq RNA Samples for Plate Transfer - Comp. Panel</summary>

* Trigger Location = Step
* 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 -u {username} -p {password} -i {stepURI:v2} -l {compoundOutputFileLuid0} script:changeWorkflow \
\
--FIELD_NAME 'Queue for Plate Transfer' \
--FIELD_VALUE 'Transfer Amplicons' \
--WORKFLOW 'DNA Library Prep AmpliSeq for Illumina Comprehensive Panel v3 v1.1' \
--STEP 'Transfer RNA and DNA Amplicons (AmpliSeq for Illumina Comprehensive Panel v3 v1.1)' \
--INPUTS_OR_OUTPUTS 'OUTPUTS' "
```

{% endcode %}

> ℹ The workflow version and step version for the routing script may vary depending on the version of the IPP.

</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       |             |                                           |

#### Pooling

* Label Uniqueness = Off
* Defaults
  * Sample Grouping = Group by Containers
  * Well Sort Order = Row

#### Placement

* Defaults
  * 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 = FUPA                            |
* 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 | Queue for Plate Transfer | Text           |             | Default = Transfer Amplicons              |
    | 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/comprehensive-panel-v3/ampliseq-cp-v3-rna-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.