NGS Order Entry

Overview

This document provides the information necessary to access PCPGM’s GIGPAD to submit and track information for Next Generation Sequencing (NGS) experiments.

1. A PI and/or Researcher first need to have an account in GIGPAD.
2. Upon account verification, a study should be created in order to request services and submit samples. Studies can be used for different purposes:
   • Grouping of samples for processing or analysis associated with a general IRB number with a unifying theme.
   • Single PI with several investigators associated with the work. Studies allow setting up the PI/investigator(s) relationships and facilitate managing the data captured under the study. If new investigators join later on they can be added to the study and access the data gathered easily.
   • Grouping of control vs. case samples. Investigators can create studies to help them group and organize their samples and data
     In the case of NGS studies most likely will be used for a and b.
3. Once a study is created a batch is required to submit samples and services associated with these samples
4. Once a batch is submitted and the lab receives the samples the experiment starts. Experiments can last days and the researcher can track some of the progress through their batch information in GIGPAD
5. Once an experiment is completed and data and results are associated the researcher/PI can download information from the batch through GIGPAD

The following sections describe in detail all the steps required to successfully submit NGS experiments and review/download the results generated.

GIGPAD Account Creation

In order to create an Account in GIGPAD go to https://portal.hpcgg.org and click on “click here to request a login”.

There are two types of external accounts in GIGPAD:

• Principal Investigator
• Researcher

Depending on your role select one or the other

Principal Investigator Information

Enter all the required information denoted by an *. If you need one or more physical invoices for billing purposes fill out the physical invoice information.

Once completed click on submit access request.

The request will be reviewed at the PCPGM. Once the request is approved you will receive an email with a temporary password that you will use along with the requested username to login into GIGPAD.

NOTE for Partners Researchers: Your username and password will be the same as your Partners username and password.

Researcher Information

Enter the information about yourself and your Principal Investigator’s. You can add as many investigators as you need to. You can also add physical invoice information for billing purposes.

Once done click on submit access request.

Your request will be reviewed at the PCPGM. Once your request is approved you will receive an email with a temporary password that you will use along with your requested username to login into GIGPAD.

NOTE for Partners Researchers: Your username and password will be the same as your Partners username and password.

New Study Registration

• Click on the 'Studies' tab

• Click on the 'New Study' tab

The facility could be a list if you are registered with multiple facilities. Choose DNA Sequencing. The principal investigator should default to you (if logged in as a PI) or to your PI (if you are a researcher)
Note for Researchers: If you have relationships with more than one PI choose from the list.

• Click on Next Step(Study Definition)

• Enter the study information

1. Enter the name that you would like to give your study
2. Enter a description of your study
3. Select your study coordinator from the drop down box(this could be yourself or a researcher in your study)
4. Select researchers from the right box and click 'add' to associate those researchers to your study. Select names in the left box and click ‘remove’ to disassociate researchers
5. Select 'yes' if your study requires IRB approval. Select 'no' if your study does not require IRB approval. If yes, fill in the following three fields. If no, then the following three fields remain grayed out and are not required.
   • Note: if your study requires IRB approval it will need to be reviewed and approved by a Director at the PCPGM before you can submit samples.
6. Once you have finished filling out all the required information click 'Next Step'

• If you intend to submit Sequencing batches for the ABI 3730, select the tests you may require for these batches. You need to select at least 1 service even if you are not going to use the ABI3730. This selection will not affect your NGS orders.

• If you need to track any specific annotations for samples in your study enter these in the following screen(optional)

1. This drop down is used for adding annotations to a study. For an explanation of how to add annotations see Appendix 1.1
2. Select a default value for an annotation
3. Click 'remove' to delete any annotation from your default annotations list.
4. Once you are satisfied with your setup click 'Next Step' to proceed.

Note: Click 'Save and Finish later' to save your study setup and continue later at any step

• Enter Billing Information for your Study

Billing for a study can be allocated across one or more funding sources. Billing for batches submitted under this study will default to the study’s setup. Funding Sources can be:
- PeopleSoft Numbers, if you have a Partners funded Grant
- Invoice and PO# if you belong to an external institution or for-profit organization The total allocation for funding sources should be 100.

1. There will be an Invoice to line for every Physical Invoice label provided when the account was created.
2. Funding type for Invoices should be AMC if your study is funded by an Academic Medical Center or For Profit if your funds are Industry based or For Profit.
3. People Sort Funding Sources can be selected(our of or entered)

• Enter or Select PeopleSoft Number

1. Select an existing PeopleSoft Number or enter a new one by clicking Add Number
2. A popup will appear, enter the number and click ok
3. Enter the allocation for the funding sources and click Next Step (Review and Create Study)

• Enter Allocations

Once you have entered in all the funding source numbers you wish to use for your study click ‘Next Step’ (Review and Create Study)

Review your Study setup. If everything is in order click ‘Create Study’

Click on the Studies tab, your new study should be listed in the list of studies. From this page you can access all the batches submitted under a particular study, view and edit study details such as researches associated and funding sources.

When your study has been created, you can order NGS services for your samples by submitting a batch.

Batch Creation

• Click on Batches - New Batch
• You must either select a Study by either
  • Selecting New Order under the Actions tab or
  • Entering a Study Code in the text box and clicking New Order button

Click on the New Order link on the study for which you’ll submit a batch

• Select Platform

Batch Details

1. Primary Contact: Defaults from study and can be changed for the batch
2. Batch Name: Optional name to identify your batch
3. Sample Type: Select RNA, Genomic DNA, shRNA Genomic, PCR Treatment, Library, or Other
   • Note: Do not override Sample Type after Sample Submission File Import.
4. If other is selected enter the type in this field
5. Number of Samples: Will be pre populated once the sample input file is uploaded
   • Note: Do not override Number of Samples after Sample Submission File Import.
6. Download Template: (see Sample Submission Form section)

Sample Submission Form

This section describes the functionality for completing the Sample Submission Sheet for Next Generation Sequencing orders. The following topics will be covered

1. Sample Submission Sheet access
2. Need Library Construction Only – Form
3. Need Library Construction and Sequence Detection - Form
4. Need Sequence Detection Only - Form
5. Error Messaging
6. Saving your form

Access Sample Submission Form

You will access the Sample Submission Form from the Download Template link in Step 1

• Clicking on “Download Template” link will present you with the following pop up.

• Click save and select location on your desktop to place the .xls file.
  • Please note that MS Excel 2003 must be installed on your system
• If you are using a newer version of MS Excel, please save the Sample Submission File in the .xls format.

Mac and Linus Users

Please contact Alison Brown for assistance in completing and submitting the Sample Submission Forms.

Contact Information Name: Alison Brown Phone: (617) 768-8470 E-mail: ABROWN13@PARTNERS.ORG

Sample Submission Form - Research Home Page

• Open up MS Excel workbook that was saved
• At Security warning choose "Enable Macros" button
  • Note: This warning may not appear depending on the computer's secruity settings.

Sample Submission Form - Home Page

Need Library Construction Only

To access Need Library Construction Only form – click on the following button on the Sample Submission Form Home Page

Need Library Construction Only Form

• Select Type of Sample, Type of Library, and Barcode/Index or No Barcode/Index values using the radio buttons. You may select only one value for each category
• Enter values in Sample Details table.
  • Important: When entering sample name in the “Labeled As” column only use the following characters:
    • a. alphanumeric characters b. Period ( . ) c. Dash ( - ) d. Underscore ( _ )
• Click button to add another line in the Sample Details section.
• Validation Button - when finished entering values click on the Validate button
• Requested Fragment Size field: single or multiple values are accepted.

Example: Single = 400 Multiple Values = 200,300,400
Note: Requested Fragment Size is the size that the DNA is to be sheared at; also know as the “insert size”. If the whole genome sequencing is to be done then the insert size should be 400 bp and if the whole exome sequencing is being carried out then 200 bp should be chosen.

• See Error Messaging in section 4.2.6

Need Library Construction and Sequence Detection

To access Need Library Construction and Sequence Detection form – click on the following button on the Sample Submission Form Home Page

Need Library Construction and Sequence Detection Form

• Select Type of Sample, Type of Library, and Barcode/Index or No Barcode/Index values using the radio buttons. You may select only one value for each category
• Enter values in Sample Details table.

Important: When entering sample name in the "Labeled As" column only use the following characters: numbers, letters, dash, underscore, parentheses, period and space.

• Add Another Sample button allows you to add anotehr line in the Sample Details section.
• Continue Button - when finished entering values click on the Continue button.
• See Error Messaging in section 4.2.6
• Note: This form and functionality is the same as the Library Construction Only form with the exception of the "Continue" Button, which leads to the Sequence Detection form.

Values carried over to Sequence Detection Form

The following values that are entered onto the Library Construction Form will be carried over to the Sequence Detection Form and do not need to be reentered.

1. Type of Library
2. Type of Library [seen as Read Type in Sequence Detection form]
3. Barcode, Index, or No Barcode/Index
4. Sample Details
   • “Labeled As” value
   • Requested Fragmentation Size [becomes Size(bp) in Sequence Detection Form]

Need Sequence Detection Only

To access Need Sequence Detection Only form – click on the following button on the Sample Submission Form Home Page

Need Sequence Detection Only

General Use

• Select a single value using the radio buttons for the following categories
  • Type of Library
  • Read Type
  • Cycles Required
  • Type of Instrument
  • Indexed, Barcoded, or No Indxing or Barcode Needed
• Complete values in Sample Details sections

Important: When entering sample name in the “Labeled As” column only use the following characters: numbers, letters, dash, underscore, parentheses, period and space.

• Select "Validate" Button when complete

Other Functions and Feature Exposure

• Size and Position values are only available when you select “Sequence Detection Only” from Sample Form Home page and selects Barcoded or Indexed.

• Additional Bias entries for 5’ Bias Sequence and 5’ Bias Notes/3’ Bias Sequence and 3’ Bias Notes becomes available by clicking the check box next to “Additional Bias”.

Note: You must fill in at least one of the four available text boxes.

• When Barcoded is chosen: Pooled is available in Sample Details.

• When Indexed is chosen: Pooled and Indexing Primer are available in the Sample Details

a. Indexed is chosen: De-Multiplexing option is automatically checked and the user must complete the values for the a.) Pooled Library Label b.) Individual Library Name c.) Barcode/Index Sequence.

• When Single Read in Read Type is selected, then 150 cycles is no longer an option.

• When Paired End Read is selected in Read Type, then 18 cycles is no longer an option.

• Type of Library “Other” – You may enter free form text

• Pooled column in Sample Details table includes drop down with Yes and No values only. You must select one of these values.

• When Pooled column selection is ”No” then Barcode/Index Sequence (Required if Pooled = “No”) column appears and Indexing Primer column appears in the Sample Details table.

a. Additionally, Text box appears above Sample Details table with instructions “Please provide details on how you would like to Pool the Libraries:”

• When you select Indexed or Barcoded and at least one Pooled value is “Yes” then the De-Multiplexing option appears below the Sample Details table.

• When you select De-Multiplexing, the following table appears below the Sample Details table.

Error Messaging - Sample Submission Form

Error messaging for the Library Construction Only form and Sequencing Detection Only form appear in line and in red on the form itself.

An initial Microsoft pop up appears like below

You must clear pop up by Clicking “OK” button and then view fields which are in error.

List of Error Messages

Please see full list in Section 6.3 of the Appendix.

Library Construction Only - Error Messaging

Example Screen Shot

Sequence Detection Only - Error Messaging

Example Screen Shot

Validation and Saving Sample Submission File

Once the form is validated and there are no errors, you will receive this message:

VERY IMPORTANT

you must then save the file to your local machine using File > Save or Save As function in MS Excel.

Order DNA Services - Steps 1-6

• Upload: Once the sample submission form is created upload it by clicking this link.

Browse for the sample submission form on your computer and click on upload files

Click on Upload Files

Service Selection

Services Selected Sample Submission Form

• The following values will be pre-populated in Step 2 from the values on the Sample Submission Form
  • Library Construction
  • NGS Sequencing
  • Platform
  • Read Type
  • Number of Cycles
• Exceptions: When Type of Instrument on Sequence Detection Form is “Either”, Platform Option under Available Services is available for your selection. DO NOT select a platform here.

Available Services

You may select the following in Step 2 – Select Services

1. Check the box next to Analysis
2. -Select- box appears

You MUST then select either Base Calling or Base Calling + Alignment

Screen Shot

Base Calling: If you select Base Calling then customer will receive the fastq formatted sequence files. These files are split according to the read number.

Base Calling + Alignment: If you select Base Calling + Alignment, then the customer will receive the fastq formatted sequence files and the Illumina specific export files that has the alignment. These files are split according to the read number.

After making selection click on Next Step.

File Upload During Sample Submission

You Select Base Calling

If you select Base Calling then the following screen appears after clicking Next Step from the Step 2 of Select Services

You can upload QC and image files at this step.

You Select Base Calling and Alignment

If you select Base Calling + Alignment, then the following screen appears after clicking Next Step from Step 2 of Select Services.

A. You can upload custom reference genome file.

• Name the reference using the free form text box
• Upload the reference file using the Additional Files function

B. You can select reference sequence from pre-defined list Options Include:

1. Human hg18 or hg19
2. Mouse mm9

Billing Information

Leave the billing information as defaulted from the study or update as needed. Click on Next Step

Order Review and Confirmation

Review your order. At this point you can Save and Finish later or submit your order. Note: See Appendix 6.2 Retrieving Partially Completed Orders

1. From the order confirmation screen you can get a confirmation PDF file that can be printed for your records. This file can be sent along with your samples.
2. The batch number is the information required to refer to this order in GIGPAD. All results, statuses, etc. will be accessed in GIGPAD by referring to the batch number.

I placed my batch, now what? Reviewing Batch Status and Retrieving Results

After a batch has been placed you can review its status and retrieve results when the batch is completed.

Login to GIGPAD, the screen presented by default is the batch browsing screen.

• The status filter is defaulted to Pending. Only batches that are not yet completed should be listed.
• he study filter is defaulted to All. Narrow your search by selecting a particular study.

Details of a particular batch can be accessed directly by entering the batch number next to View Batch Details and clicking ok.

• The batch number link leads to the batch details page. From this page you can view the samples submitted in the batch, access data files, view or add notes, and print confirmation.
• The status indicates where in the lab process the samples in your batch are.
• The View Data Files link should be used to access data such as results uploaded for the batch.

Accessing Batch Results

Most likely results for a batch will be available to download from GIGPAD when a batch has been completed by the lab. i. Select Completed on the Status filter and click go ii. All completed batches will be displayed iii. Click on the batch number link or on the View Data Files link of the batch you want to review.

Note: Alternatively you can search by entering the batch number if you know it.

From the Batch Details page click on the Data Files link on the top left corner. (Clicking on the Data Files link from the batch browsing screen leads to this screen).

Downloading Data Files

There are 4 ways to download files from GIGPAD

1. Click on the Download link next to the file (recommended only for small files downloaded independently)
2. Zip and Download action- recommended for small files downloaded as a group
3. Download files through the Applet Downloader Tool- Recommended for any file type of any size
4. Downloader Tool (command line) – recommended for large files

For NGS data files use methods 3 or 4. Method 4 is explained on this guide.

Downloader Tool(command line)

• Click on Downloader Tool(command line)

• Click Save
• Select a location to save the FileDownloader.zip
• Open the FiledDownloader.zip file

• Ensure Use Folder Names and All Files/Folders in archive are selected and click Extract
• Open the directory in which the files where extracted. There should be a FileDownloader-ReadMe.txt for more reference
• In a text editor such as WordPad open datafiledownloader-example.properties

i. Enter your GIGPAD username and password. Do not leave any spaces ie. Username=jjp123 ii. Enter the batch number for which you want to download files iii. Enter the location on your computer where you want the files downloaded to be saved iv. If you would like to download all the files available for a batch do not provide a filter. Otherwise, follow the examples to filter by any of these options. Example:

     File-filter=size=>10 Mb

v. Save as datafiledownloader.properties in the same directory as the example file.

• Open a command prompt by going to start > run. Enter cmd on the Open: textbox.
• Type CD to the location in which the file downloader was extracted.
• Type FiledownloaderCMDLine.bat
• Files should start to download in the directory provided on the properties file.

NOTE: The filedownloader.zip only needs to be downloaded once. After the initial download you just need to modify the .properties file and enter a new batch number and new filters to download data from other batches.

Appendix

Adding Annotations

• Select an annotation from this drop down or select other then Click ‘Add’.
• If you select ‘other’ then a pop-up will appear. Enter the name you wish to give the annotation.
• Click ‘OK’ when you are satisfied with your annotation name.

Retrieving Partially Completed Batches(Save and Finish Later)

To retrieve partially completed batches:

• login to GIGPAD
• Click on Batches – New Batch
• Click on the Continue link on the saved batch

Sample Submission Form - Error Messages List