# Label Non-Labeled Outputs

**Available from:** Clarity LIMS v2.0.5

A user may need to add reagent labels to sample outputs that do not have reagent labels assigned to them.

## Script Overview

The *labelNonLabeledOutputs* script provides the ability to add reagent labels to sample outputs for which there is no pre-existing reagent label.

The script checks each process output for existing reagent labels; if an output does not have at least one pre-existing reagent label then the label supplied as a script parameter is applied.

* For each output that does not already have a reagent label applied to it (e.g. control samples), the script will apply a reagent label named with the supplied string.
* In the Preconfigured Package for Illumina NGS, all sequencing libraries go through a demultiplex process to both convert data to FASTQ and demultiplex reads if necessary. Note that presently, inputs that do not have a reagent label do not create an output in a demultiplex process even though we need BCL convertor to convert their reads to FASTQ.

## Script Parameters

| **Parameter** | **Description**                                                    |
| ------------- | ------------------------------------------------------------------ |
| -u {username} | (Required) LIMS login username                                     |
| -p {password} | (Required) LIMS login password                                     |
| -i {URI}      | (Required) LIMS process URI (must have at least one sample output) |
| -l {name}     | (Required) Reagent label to be applied                             |

## Command Line Example

<details>

<summary>Example</summary>

{% code overflow="wrap" %}

```markup
java -jar ngs-extensions.jar script:labelNonLabeledOutputs -u admin -p pass -i http://localhost:8080/api/v1/processes/RCX-RCX-110315-24-3 -l "GENERIC_INDEX"
```

{% endcode %}

</details>

You may also find the following script useful: [Initialize Artifact UDFs](/instruments-and-integrations/ngs/ngs-initialize-artifact-udfs.md)


---

# 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.claritylims.illumina.com/instruments-and-integrations/ngs/ngs-label-non-labeled-outputs.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.