Sample Metadata
Sample Metadata
Sample metadata allows you to add important additional information to your study that can be used to create sample groups or make comparisons as part of your study design. Sample metadata can be uploaded from local storage or added to an ICA project.
Metadata mapping
Metadata columns are populated based on the information in your metadata TSV file. Metadata files are required per study. Upon importing a metadata file, the samples will automatically be updated to reflect the metadata attributes. The sample names in the metadata file must match those in the data files. For example, in the figure below, you can see that the Sample ID in the ADAT file matches the SampleID in the metadata file. As a result, the attribute columns in the metadata file will correspond with the metadata columns available for selection in the Samples table.
The column order does not matter but you must have a column headed with "SampleID" (no space) and the column values need to match the Sample ID in the software.

You can add multiple metadata files. In this case, any samples that do not overlap with existing ones will be added as new entries in the Samples table.
Metadata cannot be overwritten. If an erroneous metadata file is added, a new study and analysis should be created.
Download Sample Metadata file to modify for use
Download a formatted Metadata file example for your study to add more information. Make sure to correct the SampleID column header to match the exact name of the samples.
Navigate to Sample groups > Info > Download Metadata. Click the Sample groups tab, under Action click the Info button, then use the Download Metadata button to download an example metadata file to your machine which can then be modified for use.
Make sure to save your modified file as a .tsv or .csv extension to re-upload into Connect Multiomics.

Upload sample metadata file to Connected Multiomics
Upload the sample metadata file to Connected Multiomics to update the sample records of the study.
Within a study, click + Add Data > Upload metadata
Upload data from your local or server based drives. Click Browse to select the files or drag and drop the files to the purple box.
This will not add the metadata file to the ICA project as a stored file. The metadata uploaded a Connected Multiomics study will be used only in this study. It will need to be added again to other studies later if you want to use it again for other samples. To add metadata to the ICA project you will need to do this within the ICA interface.

Using a sample metadata file contained in the Illumina Connected Analytics project
To add data, click the button in the top right. You can select data from an ICA project and choose your data type and format. TSV metadata files can always be selected. For example, if you choose Bulk > Proteomics as the data type, you will only see ADAT files and TSV files as options for upload.
Last updated
Was this helpful?