How to edit a sample sheet and requeue an analysis in BaseSpace Sequence Hub

Sample sheets can be edited to requeue analysis generating FASTQ files for all Illumina sequencing runs uploaded to BaseSpace Sequence Hub. The sample sheet is a comma-separated values (*.csv) file that stores information required to set up, perform, and generate demultiplexed FASTQs from a sequencing run. Illumina recommends using BaseSpace Run Planning to create Planned runs. A SampleSheet can be exported from the Planned Run if that is desirable.

There are various reasons to recreate FASTQ files. For example, if indexes were entered incorrectly into the sample sheet (eg, reverse complemented), the indexes must be corrected and the data demultiplexed again. Techniques for troubleshooting demultiplexing issues can help users diagnose demultiplexing issues. Requeuing can also be used to turn adapter trimming on or off, or to reformat the sample sheet to remove any illegal characters. Examples of illegal characters are spaces or any characters other than alphanumerics, dashes, or underscores in the Sample ID field of the sample sheet.

Important Notes:

• Only the owner of the run can requeue an analysis. It is possible to transfer ownership of a run, if necessary. A shared run does not provide the necessary permissions needed to requeue analysis.

• There is a limit of five requeue attempts for users of BaseSpace Sequence Hub. If assistance with additional requeues is needed, email Illumina Technical Support, share the run ID and updated sample sheet. To find the run ID, open the run in BaseSpace, and look in the web browser address bar for the numerical value after: https://basespace.illumina/com/run/

• After a sample sheet is edited, only the originally uploaded file shows up in the Sample Sheet tab for the run, but any changes made to the samplesheet are used for analysis.

To edit a sample sheet and requeue:

1. After logging in to the BaseSpace account, select the RUNS tab at the top of the page.

2. Select the blue hyperlink of the run you wish to requeue.

3. Select the hourglass icon below the run name, then REQUEUE > SAMPLE SHEET.

4. Copy and paste the corrected sample sheet into the text window (to copy the appropriate format, open the sample sheet in a text editor, not a spreadsheet program.) Alternatively, select Load Original to load the original sample sheet for editing. Any errors detected in the sample sheet will be displayed above the editing window. Edits can be directly entered or copy/pasted from a plain text editor, such as Notepad, to maintain comma-separated values. Edits cannot be copied from a spreadsheet program, like Excel. When edits are complete, select the blue Queue Analysis button. If the Queue Analysis button is not active, check for and resolve any validation errors.

5. The status on the run summary page will display “Analyzing” when the analysis is ongoing and will change to “Complete” when the requeued analysis is complete.

Note: It is possible to requeue a run from a Planned Run. This provides a user interface to update run or sample information. This option is only available if the run was initial set up using BaseSpace Run Planning

For any feedback or questions regarding this article (Illumina Knowledge Article #1321), contact Illumina Technical Support [e-mail].