Sample grouping


In this section, you provide one or more sample metadata attributes and associated values based on which samples are grouped.
Initially, the selected samples will be listed with no attributes (figure 36). From here, you can add attributes from a sample metadata file or you can add them manually.

Image samplegroupingclean
Figure 36: The Sample grouping section with no attributes specified.

Add attributes from sample metadata file

  1. Click the Add sample metadata file button.
  2. Select the relevant metadata file in .csv, .txt, or .xlsx format from your file system.

    The file must be comma or semi-colon separated, and the first column must have the header Sample or Run and contain the sample names. The header of the remaining columns specifies attributes. To be available for selection in the Experimental design section, attributes must have values defined for all samples.
    When using Excel with files containing special characters, choose the UTF-8 option when saving the file to .csv format.
    Click on the Download example of csv file link to see an example of a correctly formatted file.

    If the names of the selected samples match the sample name in the metadata file, you should now see the attributes and sample-specific values listed in the Sample grouping section (figure 37).

  3. If needed, you can click on Clear to remove all attributes and values to start over.

Image samplegroupingfromcsv
Figure 37: The Sample grouping section enriched with metadata attributes added from a csv file.

Add attributes manually

  1. Click on Manually add attributes to open the dialog Add sample metadata attribute manually (figure 38).
  2. Specify the name of the attribute, e.g. "Diet".
  3. Enter the attribute values, separated by commas, e.g. "Low calorie intake, High fat, Low fat, High protein".
  4. Under Add attribute options to samples, for each sample select the appropriate attribute value from the drop-down list.
  5. Click on Add to samples.
  6. Repeat the above steps to add additional attributes.
    Attributes and values will be listed in the Sample grouping section (figure 39).

    Image samplegroupingmanually1
    Figure 38: When adding metadata manually, you must specify the name and values for each attribute and then select the relevant value for each sample.

    Image samplegroupingmanually2
    Figure 39: The Sample grouping section enriched with manually added metadata attributes.

  7. If desired, you can click on Clear to remove all attributes and values to start over.