# Samples

The page lists all the sample created in the study with meta data information.

<figure><img src="/files/jXutWTOFXavGdKeMcYib" alt=""><figcaption></figcaption></figure>

Top left is a search bar, type in Sample ID to search. It is doing partial matching, it is case insensitive.

Filter (<img src="/files/uiFXWLhyuBrNBni69g7Z" alt="" data-size="line">): click on filter icon, meta data field list is displayed on the right side. The search bar on the top is to search for the field name. Click on > to expand a field, search bar in each field. is to search for subgroup name. Check the box in front of each subgroup name to select. Deselected groups will be filtered out on the table

<div align="left"><figure><img src="/files/F37fIWjVuZGzMZcCf9tA" alt="" width="288"><figcaption></figcaption></figure></div>

Columns (<img src="/files/s70MGVfuCbOVzDemtoP2" alt="" data-size="original">): allows you to customize which columns you want to view in the table, click on the columns icon, meta data field list is displayed on the right.

<div align="left"><figure><img src="/files/xPU9WvmMu8V3cfHZXboE" alt="" width="280"><figcaption></figcaption></figure></div>

Check the box in front the field name to display the field in the table. Unchecked filed names are hidden from the table.

On the table, check the box in front of the sample ID to select samples, at least one sample is selected, the **Create sample group** button (<img src="/files/IeCFZm9VxdHGhRSRk7OO" alt="" data-size="line"> )will be enabled (upper-right of the table), click on this button, the created sample group will be displayed in Sample Groups page.

Selected sample meta data can be downloaded by clicking <img src="/files/gu6ao34hK4OuMp8lGiHO" alt="" data-size="line">; select samples will be removed from the study when click <img src="/files/g89D2kauIK0D6VAuL20c" alt="" data-size="line">. A warning message will be displayed:

<div align="left"><figure><img src="/files/AAXoqmSODzDIMa7kX04K" alt="" width="563"><figcaption></figcaption></figure></div>

Number of the samples displayed in the table, total number and number of selected samples are displayed at the low-right corner of the table.

<div align="left"><figure><img src="/files/oCJWeEjdJg7MnKbaJc8x" alt="" width="563"><figcaption></figcaption></figure></div>

Click the refresh icon <img src="/files/bQhthCGB6NtR1Yp6yjth" alt="" data-size="line"> to refresh the sample view after adding more data or to clear your filters and reset to the default view. You can also drag and drop columns to reorder columns.

### Sample Naming

#### Proteomic Data

Sample IDs for proteomic data will be extracted from the sample names provided in the ADAT files. Each file can contain multiple samples. For example, the Sample ID in the ADAT file (left image) corresponds to the sample name in a row of the Connected Multiomics table (right image). A new sample will be created in Connected Multiomics for each Sample ID listed in the ADAT file.

<figure><img src="/files/eiELgK4nRpukEU3u2Rx3" alt=""><figcaption></figcaption></figure>

#### Single Cell RNA Data

Sample IDs for scRNA data are obtained by removing the file extension from the file name. As a result, scRNA samples will be paired with their corresponding files based on the sample name. For example, the name of the scRNA files (left image) matches the sample name in a row of the ICM table (right image). Refer to [Supported Data Types](/icm/reference/supported-data-types.md) for information on the required files that make up a single scRNA sample.

<figure><img src="/files/W7QUffvHKW5yfNSZAe4x" alt=""><figcaption></figcaption></figure>

#### Spatial Data

Sample IDs for spatial data are derived by removing the file extension from the file name. Thus, spatial samples are linked to their corresponding files through the sample name. For instance, the name of the spatial data files (left image) corresponds to the sample name in a row of the Connected Multiomics table (right image). Refer to [Supported Data Types](/icm/reference/supported-data-types.md) for details on the required files that make up a single spatial sample.

<figure><img src="/files/vJJhodk0HsmYiMEpNCen" alt=""><figcaption></figcaption></figure>

### Sample Statuses

The following table describes the different sample statuses.

{% hint style="warning" %}
Note that protein samples only display the "Ready" status.
{% endhint %}

| Status    | Description                                                                                                          |
| --------- | -------------------------------------------------------------------------------------------------------------------- |
| Ingested  | The sample has been ingested to the Study but may not have been uploaded to Analysis yet.                            |
| Uploading | The sample is in the process of uploading to Analysis. Samples cannot be used for analyses while they are uploading. |
| Ready     | The sample is ready to be used in analysis.                                                                          |
| Failed    | The sample ingestion failed.                                                                                         |


---

# 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/icm/studies/view-studies/view-studies.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.
