Introduction

Introduction

The Tapestri Pipeline uses Bluebee’s High Performance Genomics Platform and allows customers to process single-cell DNA sequencing data generated on the Tapestri Platform. This document describes how to set up an account and get started using the platform.

Back To Top

Tapestri Pipeline: From Fastq to variant calls

Tapestri Pipeline: From Fastq to variant calls

This pipeline processes single-cell DNA-seq data generated with the Mission Bio Tapestri™ Genomics Platform.

Back To Top

Key Features Of Tapestri Pipeline

Key Features Of Tapestri Pipeline

  • Streamlined data analysis from FASTQ files to annotated VCF files.
  • Automatically annotate VCF files with variant ID numbers for common and pathogenic variants.
  • Create multiple data output files that seamlessly plug into Tapestri Insights or may be analyzed with 3rd party software packages.

Back To Top

Main Input/Output Files

Input Files:

    • FASTQ files in compressed format (fastq.gz) generated from Illumina MiSeq, Hiseq 2500, Hiseq 4000, or NovaSeq 6000 runs.
    • Custom Panel file in compressed format that provides a user-defined set of targeted positions (e.g., AML panel).

Back To Top

Primary output files:

  • LOOM file – used in Tapestri Insights
  • VCF in compressed format (vcf.gz) – used with 3rd party software platforms
  • Report file in PDF format – summarizes sequencing metrics and outputs total cell number

Back To Top

Overview Of The Workflow

Creating Your Account

Creating Your Account

Mission Bio will create a new account on Bluebee free of charge. Once the account has been created you will receive an email to set up your account.

If you have not received a Confirmation email, please contact Mission Bio Support – support@missionbio.com

Complete the following steps to create an account:

  1. Verify your email address by clicking the ‘VERIFY’ button in the email from Bluebee (noreply@bluebee.com)

 

  2. Set a password to activate your account.
  Once the account has been verified you will receive a confirmation email that your account has been activated.

Back To Top

Data

Folder/File Format Requirements

The Tapestri Pipeline requires the following data folder/input nomenclature:

    • The input directories cannot contain any spaces.
    • The user specified run prefix cannot contain ‘_R1’
    • The input file names (in the directories) must also not contain spaces, and they must be in the following format:
    • < prefix > _R1_ < suffix >.< extensions > for the forward FASTQ
    • < prefix > _R2_ < suffix >.< extensions > for the reverse FASTQ

NOTE
The underscores around R1 and R2 are mandatory.

  • < prefix > and < suffix > can be anything, but they must match between the two files that compose a pair:

e.g., a correct pair is: aaa_R1_001.fastq.gz, aaa_R2_001.fastq.gz

e.g., a wrong pair is: aaa_R1_001.fastq.gz, aaa_R2_002.fastq.gz

  • < extensions > are usually “.fastq.gz”

Back To Top

Data Transfers

As long as the connector is running and connected, data transfers will continue. You don’t need to stay logged in to the platform for this.

Back To Top

Storage

Statuses

There is a limit to the availability of the uploaded data, pipeline input data and pipeline output data. You can check the status of your files on the Data page within the project. The next statuses can be displayed:

Available: This file can be used for pipeline runs and can be downloaded.
Deleted: This file is deleted and cannot be used anymore. Deleted data isn’t shown in the list by default. You can display these files in the list by ticking the box ‘Show deleted data’ on top.
Archived: This file has been archived and needs to be restored before it can be used for runs or downloading. You can do this with the button on top.
Partial: This file is not completed yet. A part of it still needs to be uploaded.
Corrupted: The file cannot be used. It was declared corrupt after being inconsistent or the upload has been aborted by the user. The file cannot be used. Try to upload this file again with another name, e.g. add a letter to the file name.
Inconsistent: An issue occurred during the upload. The file cannot be used. Try to upload this file again with another name, e.g. add a letter to the file name.

Terms

The storage terms are agreed upon in a contract. If no contract is present or you don’t have access to the contract, you can contact support to ask the storage terms that are defined in your case. There are 3 types of storage terms:

Hot storage: Contains data that is available.
Cold storage: Contains data that is archived.
Grace period strategy: What happens with the uploaded data after the Grace period has past and when it hasn’t been used in a pipeline run. This can be a deletion, archiving to cold storage or keeping the file on hot storage. Archiving and keeping can be charged. The grace period and its strategy can be checked in the storage bundle on the Activation Codes page.

Back To Top

Support

First Time Using Your Account

Log In To Your Account

 

  1. Go to https://tapestri.bluebee.com/missionbio-tapestri/ and log in to your account.
Once logged in you will be directed to the ABOUT page that summarizes the key steps when working with the platform (Getting Started Guide):

  • Invite new users to your account
  • Set up connector
  • Create samples
  • Start pipeline

Back To Top

Invite New Users To Your Account

 

    1. Go to http://tapestriportal.com and sign up for a new account.
    2. After verifying your email address, contact Mission Bio Support at support@missionbio.com to request access to the Tapestri Pipeline. Please provide (1) the email address you used when you signed up and (2) the primary Tapestri Pipeline account holder’s name.
    3. Mission Bio will grant access to the Tapestri Pipeline within 24 hours.

Back To Top

Set Up Connector

Set Up Connector

The Bluebee Connector is a small piece of software that allows you to upload data secured to and download data secured from the platform.

  1. Go to SETTINGS in the top menu and click on SETTINGS in the left navigation bar.

 

The top section shows a summary of the personal settings. Optionally one may change the page that is shown after logging in to the account via the Initial view after login dropdown menu (default = About help view).
  2. Click on NEW to create a new Connector.
  3. Fill out the fields and click SAVE on the top of the page.
The UPLOAD FOLDER FOR PANEL ZIP FILES and DOWNLOAD FOLDER are optional fields.

Back To Top

Install Connector


1. After clicking SAVE the Bluebee Service Connector will be downloaded and the Initialisation Key will be displayed. Copy the key.
  2. Once downloaded, start the installation, enter the Initialisation Key when prompted, and follow the instructions to complete the installation.

Back To Top

Start the Connector

On the SETTINGS page the connector is now listed and connected.

Back To Top

Windows

The installer registers the Bluebee Service Connector as a Windows service and starts the service immediately. Wait ~ 1 minute and then refresh the screen on the SETTINGS page with the REFRESH button on the top right corner.
You can only install one connector at a time on Windows. If you need to install a new connector, first uninstall the old one and delete all associated files (log files?). A connector can be upgraded with the UPDATE TO LATEST VERSION button on the SETTINGS page.

Back To Top

Mac OS X

The installer registers the Bluebee Service Connector in your login items so that it automatically starts when you log in. To start it, you can either double-click it in your Launchpad, double-click on the Bluebee Service Connector icon in the directory or log out and log back in. Wait ~ 1 minute and then refresh the screen on the SETTINGS page with the REFRESH button on the top right corner.

Back To Top

Linux

Java needs to be installed (at least Java 8). The connector will use the default Java version on the operating system. During the installation process the connector puts a management script in the /etc/init.d. You can start it by executing ‘service bluebeeserviceconnector start’. If no script was generated, start the script from the bsc folder ./bluebeeserviceconnector start.

Back To Top

Create Samples

Create Samples

Before processing sequencing data, individual FASTQ.GZ files that belong to one biological sample need to be linked to samples.

1. Go to FILES in the top menu.
2. Select all FASTQ.GZ files that belong to one biological sample.
3. Click CREATE SAMPLE to associate all selected files to one sample.
4. Define a sample name. The prefix of the FASTQ.GZ files will be used automatically to name the sample. This label will be prefixed to each output file.
5. Select a Panel (e.g., AML).
6. Determine number of sequencing runs.

Use TWO RUNS only for the following two situations (file names across both ‘runs’ need to be identical):

  • You sequenced the identical library twice (technical replicate) and wish to increase overall coverage.
  • You sequenced the library across two lanes and received eight instead of four FASTQ.GZ files per sample. Run 1 accepts FASTQ.GZ files from lane 1. Run 2 accepts FASTQ.GZ files from lane 2.
7. Optionally provide a description.
8. Assign FASTQ.GZ files to the FORWARD and REVERSE sections. Matching read pairs need to be aligned in the same row. In most cases FASTQ.GZ files are automatically assigned in the correct format.
9. Click LINK AS SAMPLE in the top right corner.

Back To Top

Start Pipeline

Start Pipeline

1. Go to SAMPLES in the top menu.

2. Select the sample you want to analyze and click ANALYZE to start the pipeline.

Once the analysis is started the run status will show IN PROGRESS. Once the analysis is successfully completed the run status will show SUCCEEDED and you will be notified via email.

Back To Top

Review And Download Data

Review And Download Data

1. Go to SAMPLES in the top menu and highlight the sample you want to review data for.

2. The ANALYSIS DETAILS page includes a list of key performance metrics on the left side and generated data that can be downloaded on the right side.

Small-size files may be viewed and/or downloaded directly inside the web browser. Large-size files, such as loom files can be downloaded via the connector by clicking the download icon on the far right.

cells.vcf.gz Compressed annotated VCF file. Conforms to standard GATK format.
cells.loom Customized annotated VCF file in LOOM file format. To be used with Tapestri Insights.
cells.R Customized annotated VCF file in R file format.
flt3.itd.report.txt For each cell a report detailing the FLT3-ITD variants found by a customized algorithm.
report.pdf A report file summarizing key performance metrics (i.e., number of cells). Summary data also provided on a per-tube basis (i.e., eight tubes)
allele.drop.out.report.txt A report file that summarizes allele dropout metrics using allele dropout (ADO) amplicon information.
barcode.cell.distribution.tsv A spreadsheet file reporting the number of forward reads assigned to each amplicon for each cell found.
tapestri_log.txt A detailed report on the individual steps performed by the Tapestri Pipeline.
cells.bam Individual BAM files with reads of all cells found per tube.
mapped.bam Individual BAM files with all reads mapped to the genome per tube [only reads with valid barcodes are reported].

Back To Top