# Lists

A list of features can be used to filter data or perform some analysis e.g. pathway enrichment analysis, or perform visualization like heatmap etc.

* Click on gear <img src="https://580316046-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWMxqQAMFOJtu98OBk9KN%2Fuploads%2Fgit-blob-ebe54f487e3af45f4a141bd4d5da0736e5f4d479%2Fimage%20(305).png?alt=media" alt="" data-size="line"> button on Analysis page the top right corner
* Choose **Settings** in the menu
* Select **Lists** from the left panel of the *Components* section.

To create new list, select the **+ New list** button on the top of the page and give the list a name. Choose between the three list options:

* **Local file**: text file (.txt) on the local computer
* **Text**: manually specify a list of names
* **Hosted lists**: lists hosted by Illumina

When manually specifying a local file or text, only the user who added the list can view and use the lists.

The list name needs to be unique for each user. A description is optional. The list of features can be specified from a .txt file on your local computer by selecting the **Local file** option. The .txt file should contain only one feature per row.

<div align="left"><figure><img src="https://580316046-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWMxqQAMFOJtu98OBk9KN%2Fuploads%2Fgit-blob-fe62b0b8ebaf1a0e39ce75bf550b59caab972d06%2Fimage%20(309).png?alt=media" alt=""><figcaption></figcaption></figure></div>

To manually enter a list of genes, select the **Text** option. Content can be typed into the text field or pasted from the clipboard as one feature per row.

<div align="left"><figure><img src="https://580316046-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWMxqQAMFOJtu98OBk9KN%2Fuploads%2Fgit-blob-bceeebb05c671baf0a5d81acf2299fd854c0a83c%2Fimage%20(308).png?alt=media" alt=""><figcaption></figcaption></figure></div>

Select **Add list** to add the list. The new list will be added to the list table.

When the *Hosted lists* option is chosen, lists can be downloaded by clicking the check box for each list on the left to select lists and click **Add list.**

<figure><img src="https://580316046-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWMxqQAMFOJtu98OBk9KN%2Fuploads%2Fgit-blob-f74b0592db9462f1df8a27b78a3fa05f9053a3d8%2Fimage%20(310).png?alt=media" alt=""><figcaption></figcaption></figure>

View and sort the name of the list, number of features, owner, and creation date by clicking the column title of the list table. Click on the 3 dots under Actions column to download or edit the list:

<div align="left"><figure><img src="https://580316046-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWMxqQAMFOJtu98OBk9KN%2Fuploads%2Fgit-blob-564a15482b953897aed9ec1b6e5a40fad56c185f%2Fimage%20(311).png?alt=media" alt=""><figcaption></figcaption></figure></div>

## Use a Feature list to Select & Filter populations

Feature lists can be used to Select & Filter.

* In the Data Viewer, select the **Style** configuration option
* Choose **Feature list** from *Color by* drop-down list

<figure><img src="https://580316046-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWMxqQAMFOJtu98OBk9KN%2Fuploads%2Fgit-blob-fcfac4c53abab36bbf28d678ebef64340efb0670%2Fimage%20(312).png?alt=media" alt=""><figcaption></figcaption></figure>

* Select the **List** of interest using the drop-down
* Choose a **Metric** for the feature list

<figure><img src="https://580316046-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWMxqQAMFOJtu98OBk9KN%2Fuploads%2Fgit-blob-1ea83ba5cab38951e7eb7baa73642a9ae20047d4%2Fimage%20(313).png?alt=media" alt=""><figcaption></figcaption></figure>

* Click **Select & Filter** under *Tools* on left
* Use the *Add criteria* drop-down to choose **Gene score**

<figure><img src="https://580316046-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWMxqQAMFOJtu98OBk9KN%2Fuploads%2Fgit-blob-5d4912d9ab7d6d0896a0b52d9945048bd17df4c8%2Fimage%20(314).png?alt=media" alt=""><figcaption></figcaption></figure>

* Use the slider or text fields to select a population

<figure><img src="https://580316046-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWMxqQAMFOJtu98OBk9KN%2Fuploads%2Fgit-blob-baac1561417ee910b9489d84532d6c694ba650e3%2Fimage%20(315).png?alt=media" alt=""><figcaption></figcaption></figure>

* Use Filter at the top right to **include** (<img src="https://580316046-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWMxqQAMFOJtu98OBk9KN%2Fuploads%2Fgit-blob-2673e624ab6c12aa08dfe9076565345997b314f8%2Fimage%20(316).png?alt=media" alt="" data-size="line">) or **exclude** (<img src="https://580316046-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWMxqQAMFOJtu98OBk9KN%2Fuploads%2Fgit-blob-3b1cfe2355e3626df184d3415d00ff2c015b76a2%2Fimage%20(317).png?alt=media" alt="" data-size="line">) this population
* **Apply observation filter** can then be used to filter this population to a specific node in the analysis pipeline

<figure><img src="https://580316046-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWMxqQAMFOJtu98OBk9KN%2Fuploads%2Fgit-blob-b5ceeaf89a8c663d9d09791dec10cea445d3f249%2Fimage%20(318).png?alt=media" alt=""><figcaption></figcaption></figure>

To remove this filter, click **Clear filters**.

##
