The Seven Bridges Knowledge Center

The Seven Bridges Platform is a simple solution for doing bioinformatics at industrial scale. But sometimes, everyone needs a little help.

Get Started

Format of a manifest file

Two different manifest file formats are used on the Seven Bridges Platform. Which manifest file you should use depends on the functionality that you're using the manifest for.

  • Seven Bridges Uploader or Command Line Uploader - use this format of manifest file in order to apply metadata when uploading files to the Platform.
  • Modifying metadata via the visual interface - use this format of manifest file in order to modify the metadata for files that are already on the Platform in one of your projects.

Seven Bridges Uploader or Command Line Uploader

When uploading files to the Platform using the Seven Bridges Uploader or Command Line Uploader, a manifest file can be used to define metadata values for those files.

The supported file format for this manifest file is CSV, i.e. comma separated values. A CSV file contains a number of rows with columns which are separated with a comma.
The following rules apply:

  • The lines are separated with a line break, while the columns are separated using a comma.
  • The first row has to contain column names which are treated as metadata fields (e.g. “sample”, “library”).
  • The first column has to contain the names of the files which will be uploaded. In case the files are not in the same directory as the manifest file, you should also include a path to the files (e.g. ../filename.fastq).
  • All subsequent columns should contain metadata fields which will be assigned to the specified files.
  • Keys and values are case sensitive unless explicitly treated differently by a tool or a part of the Platform.
  • Maximum number of key-value pairs per file is 1000, including null-value keys.
  • Keys and values are UTF-8 encoded strings.
  • Maximum length of a key is 100 bytes (UTF-8 encoding).
  • Maximum length of a value is 300 bytes (UTF-8 encoding).
  • Quotation marks are allowed.

The following example shows the content of the manifest for three files with three metadata fields.

File name
sample
library
paired_end

file1.fastq

sample1

examplelibrary1

1

file2.fastq

sample1

examplelibrary1

2

file3.fastq

sample2

examplelibrary2

1

Below is the same example in a comma separated format.

File name,sample,library,paired_end
file1.fastq,sample1,examplelibrary1,1
file2.fastq,sample1,examplelibrary1,2
file3.fastq,sample2,examplelibrary2,1

Modifying metadata via the visual interface

This manifest file is used In case you are modifying metadata for all of your project files via the visual interface. The metadata are stored in a manifest file which you can download, change values for the metadata fields and then upload it back to the Platform, thus applying changes to metadata in all of your project files.

The supported file format for this manifest file is CSV. A CSV file contains a number of rows with columns which are separated with a comma.

The following rules apply:

  • The columns are separated using a comma while the lines are separated with a line break.
  • The first row has to contain column names. The required columns are:
    • id - specifies the file ID.
    • name - specifies the file name.
    • project - specifies the project name.
    • <metadata field name> - at least one metadata field name should be specified.

Columns which are specified after id, name and project will be treated as metadata fields.

The following example shows a manifest file which contains the required columns and one metadata field (paired_end).

id
name
project
paired_end

581b298d20946e087b2ce503

file1.fastq

rfranklin/my-project

1

581b298d20946e087b2ce51f

file2.fastq

rfranklin/my-project

2

581b298d20946e087b2ce50b

file3.fastq

rfranklin/my-project

1

Below is the same example in a comma separated format.

id,name,project,paired_end
581b298d20946e087b2ce503,file1.fastq,rfranklin/my-project,1
581b298d20946e087b2ce51f,file2.fastq,rfranklin/my-project,2
581b298d20946e087b2ce50b,file3.fastq,rfranklin/my-project,1