Sample Metadata

While in the annotating status, metadata can be applied to the samples based on the metadata structure defined at the organization level. Learn more about creating metadata fields here.

Metadata can be applied to samples using the built-in grid editing system, or by uploading a metadata file (csv format). Adding metadata does not require a Standard Compute runtime, but merging it onto the samples when transitioning them to the ready status does.

Editing the metadata from the UI

Double click on a cell to fill in the corresponding information. Depending on the metadata field type, the input field differs:

• string - free text

• numeric - required numeric input

• list - select one of the available options

• ontology - autocomplete - type and select

Once all metadata was applied, click the Commit button in the grid toolbar to submit the data to the server. While editing, all data is stored in the browser. Rows with unsaved information are colored in orange. To revert changes to an unsaved sample, select the row and click the Revert button in the grid toolbar.

Edit sample metadata

Uploading metadata using a CSV file

For large studies, manually inputting the metadata may not be feasible. Simply upload a metadata file by clicking the Upload Metadata button in the grid toolbar.

The metadata file's header must match the metadata field names defined at the organization level and must include the field marked as "sample identifier" in the metadata fields management area.

Example metadata file:

Metadata file screenshot

2KB

GSE136961_metadata_showcase.csv

In this example, the column sample.id refers to the sample names. Data matching is performed based on this information.

Upload a sample metadata file

Once the metadata is successfully added, the samples can be marked as ready. This action requires a Standard Compute runtime.