May 17, 2024
NCBI submission protocol (BioSample/SRA)
- Ruth Timme1,
- Emma Griffiths2,
- Bryan Wee3
- 1US Food and Drug Administration;
- 2Simon Fraser University;
- 3The University of Edinburgh
- PHA4GETech. support email: [email protected]
Protocol Citation: Ruth Timme, Emma Griffiths, Bryan Wee 2024. NCBI submission protocol (BioSample/SRA). protocols.io https://dx.doi.org/10.17504/protocols.io.rm7vzjyj5lx1/v1
Manuscript citation:
Griffiths, E.; Mendes, C.I.; Maguire, F.; Guthrie, J.; Chindelevitch, L.; Karsch-Mizrachi, I.; Waheed, Z.; Cameron, R.; Holt, K.; Katz, L.; Petit III, R.; MacCannell, D.; Dave, M.; Oluniyi, P.; Nasar, M.I.; Raphenya, A.; Hsiao, W.; Timme, R. PHA4GE Quality Control Contextual Data Tags: Standardized Annotations for Sharing Public Health Sequence Datasets with Known Quality Issues to Facilitate Testing and Training. Preprints 2023, 2023030037. https://doi.org/10.20944/preprints202303.0037.v1
License: This is an open access protocol distributed under the terms of the Creative Commons Attribution License, which permits unrestricted use, distribution, and reproduction in any medium, provided the original author and source are credited
Protocol status: Working
We use this protocol and it's working
Created: May 05, 2024
Last Modified: May 17, 2024
Protocol Integer ID: 99250
Keywords: NCBI submission, WGS, pathogen surveillance, GenomeTrakr, new ncbi submission environment, ncbi submission environment, step instructions for data submission, general submission to sra, data submission, first data submission, contextual data for pathogen, submission protocol, ncbi, raw sequence data, submission tool, based submission tool, guidance for new submitter, cdc, describing general submission, pathogen, based submission, anticipated first submission, pathogen dom, detailed instruction, large volume submission, biosample, sra, laboratory group, new submitter, essential step, place before data, standard data structure
Disclaimer
Please note that this protocol is public domain, which supersedes the CC-BY license default used by protocols.io.
Abstract
PURPOSE: This document provides detailed instructions on how to submit raw sequence data and associated contextual data for pathogens to NCBI while adhering to the INSDC standard data structure, "Pathogen DOM,". The protocol includes essential steps to create a new NCBI submission environment for your laboratory group, which is crucial to have in place before data are submitted. After these initial setups, the the remaining protocol focuses on step-by-step instructions for data submission.
GUIDANCE FOR NEW SUBMITTERS: Before initiating your first data submission, there is significant preparatory work required. We advise designating a team member to spend several days setting up the necessary systems well before your anticipated first submission.
ADVICE FOR FREQUENT/LARGE VOLUME SUBMISSIONS: Start by following Step 1 to establish your NCBI submission environment. For ongoing or large-scale submissions, email [email protected] to arrange an account for API-based submissions.
CDC maintains the following API-based submission tool: TOASTADAS
Version history:
Troubleshooting
Before start
This protocol has three sections:
- Section 1: Setting up NCBI accounts (for new users)
- Section 2: Data submission to BioSample for sample metadata and to SRA for raw reads and associated sequence metadata.
- Section 3: Detailed steps for creating a BioProject (usually done once during the account set-up)
Establish submission environment at NCBI
Set up a new NCBI submission environment for your laboratory:
1.1: Create an NCBI user account
1.2: Set up an NCBI submission user group for your lab
1.4: Bookmark the link to your submission portal
1.5. Identify or establish new BioProjects (detailed in Step 3)
Ready for data submission:
After these steps are complete you can proceed with data submission in Step 2.
Create an NCBI user account at NCBI: https://www.ncbi.nlm.nih.gov/account. This will be your own individual user account at NCBI.
The signup link is at the bottom of the page.
Choose a signup option that works for your institution.
Establish an NCBI submission user group for your laboratory.
We recommend using this user group for all NCBI submissions related to your labs's pathogen genome surveillance submissions.
This approach will link data submitted by your lab to the user group and not to individuals doing the submissions, allowing anyone in the current submission group to perform updates or retractions and answer inquiries from the NCBI staff, even if there's been a complete turnover of staff since the original data were submitted.
User groups also ensure consistent data ownership across BioProjects, BioSamples, and sequence data. If your laboratory has non-overlapping research groups submitting and managing data at NCBI, multiple user groups can be established, if needed, to manage these efforts separately.
Your laboratory might already have a submission group established! Sign into your personal NCBI account, then check the "Group" tab in the Submission Portal (Submission Portal | NCBI | NLM | NIH). Ask your colleagues to do the same to ensure your laboratory does not already have one in place.
View of the "Groups" tab, when selected from the NCBI Submission Portal
Click on this link to verify your membership in NCBI user groups: https://submit.ncbi.nlm.nih.gov/groups/
Creating a new submission group:
1. On your NCBI profile page (https://submit.ncbi.nlm.nih.gov/accounts/profile/), scroll to the bottom of the page and click on the "Create group for shared submissions" button.
Note
The "Create group for shared submissions" button will not exist, if the user has not filled in all of the required profile information, marked with an asterisk ('*') on the profile page.
2. On the resulting page, fill in the required information to create, at minimum, a short name, full name, and contact information for this submission group.
3. To invite members, use either the "Invite members" button at the top of the next, "Members" tab or from the "Invites" tab itself to navigate to the invite tab and add the invitees' emails to the text box. Click the "Invite Members" button when finished.
Managing your NCBI submission user group.
After a user group has been established it can be edited for membership and permissions by clicking in the “group” tab of the submission portal (https://submit.ncbi.nlm.nih.gov/groups/), then on the Group Id hyperlink, e.g "fda_ny" in the above example.
Users with admin privileges can update contact information in the "Profile" tab and membership in the "Members" tab. New members can be invited by clicking on the "Invite members" link.
This user list should be kept current as members/staff enter and leave the laboratory.
Permissions levels:
- READ: primarily for collaborators who would like to view the submissions, but not edit them.
- MODIFY, SUBMIT, DELETE: Permissions to submit, modify, or retract data (members usually have all or none of these permissions)
- ADMIN: Can invite or remove members of the submission group. Ensure that at least one (or more) members of your group have ADMIN privileges.
The "Submissions" tab will show a breakdown of how many submissions have been made by this group:
Bookmark “My submissions” at NCBI: https://submit.ncbi.nlm.nih.gov/subs/. This is the page where you view and track current and past submissions.
Identify or establish new BioProjects (Umbrella and/or Data BioProjects)
Umbrella BioProjects. If you are already part of a surveillance network, (e.g. SPHERES, COG-UK, CanCOGeN, etc) you should use one of their established umbrella BioProjects. For reference, here are some of the umbrella projects established for SARS-CoV-2 surveillance:
SPHERES (US): PRJNA615625
CanCOGeN (Canada), PRJNA623807
If you need to establish a new umbrella BioProject, follow instructions in Step 3 with modifications for creating a new Umbrella BioProject .
Data BioProjects. Does your laboratory have an established data BioProject for this effort? If not, please follow the instructions in Step 3 for creating a new one.
Download and populate metadata templates for BioSample and SRA
Custom templates created and maintained by PHA4GE can be found here:
- SARS-CoV-2 submission templates: https://github.com/pha4ge/SARS-CoV-2-Contextual-Data-Specification
- QC tags for SRA submission: PHA4GE-modified SRA Submission Form
Generic templates at NCBI: https://submit.ncbi.nlm.nih.gov/templates/
Data submission (BioSample and SRA)
Data submission (Sample metadata, SRA metadata, and raw sequence data), compliant with the Pathogen DOM data structure for sequencing either single isolate pathogens or population-level, environmental pathogens.
Note
Arrange your submissions according to their corresponding BioProjects, ensuring that each submission workflow is dedicated to a single BioProject. In cases where your data encompass multiple BioProjects, initiate a distinct submission for each BioProject separately.
Navigate to the My Submissions page in the NCBI Submission Portal: https://submit.ncbi.nlm.nih.gov/subs/
Click "Sequence Read Archive" to start a submission.
Click the “New submission” button.
SUBMITTER tab:
Populate with submitter info. The “submitter” is the name of the person AND user group, who is physically doing the submissions, not a supervisor or PI.
Select the appropriate submission group name (see Step 1.2 for creating a new submission group), and describe the submitting organization or laboratory name. This will be auto-populated from the contact info you included in your NCBI user account. Click "Continue" to proceed.
GENERAL INFO tab:
1. BioProject: Did you already have a data BioProject for this effort? If not please follow instructions in Step 3 for creating a new data or umbrella BioProject. Return back to this sub-step with the data BioProject accession in hand.
Click "Yes" and paste in your data BioProject accession, e.g. PRJNA614995. Note: Be sure not to use an umbrella BioProject. Select the appropriate BioProject under the umbrella. Otherwise, you will receive an error and not be able to proceed.
2. BioSample: Click "NO" here. You will be registering BioSamples within this current submission.
3. Release date: Choose "Release immediately following processing".
4. Click Continue.
Example of filled in "General Info" tab. Please use the BioProject accession necessary for your organism and project.
BIOSAMPLE TYPE tab:
Choose the metadata package type you pre-populated from .
BIOSAMPLE ATTRIBUTES tab:
Choose "Upload a file using Excel or text format (tab-delimited) that includes the attributes for each of your BioSamples".
Then click "Choose File" and browse to your populated metadata template.
Antibiogram data: please provide if you have it!
Click "Continue".
NCBI will do a validation check on your metadata. Resolve any red "errors" reported back by editing the spreadsheet and replacing the uploaded file. Review any yellow "Warnings" and proceed if everything looks ok.
Note
If you are using the One Health Enteric Package BioSample metadata template downloaded from the CFSAN Biostatistics GitHub and receiving an error like the one below, an the empty, original version of the template may have been uploaded. Try again with your completed template.
Note
You may see the warning pictured below. You do not need to do anything in response to this warning. It exists merely to tell you that the "sub species" and "serovar" fields have been created in addition to the "Organism name" field. The metadata will be preserved in the Organism name as well as used to populate the new serovar and sub species attributes.
Click "Continue".
SRA METADATA tab:
Choose: "Upload a file using Excel or text format (tab-delimited)".
Upload your pre-populated SRA metadata template from .
Click "Continue".
NCBI will do a validation check on your sequence metadata. Resolve any red "errors" reported back by editing the spreadsheet and replacing the uploaded file. Review any yellow "Warnings" and proceed if everything looks ok.
Click "Continue".
Files tab:
Each laboratory will establish its own path for transferring files. Select the radio button corresponding to the means you will use.
In general, selecting the web browser option should work for uploading ~48 sequences at a time. For a more stable internet connection, your laboratory can use FTP or Aspera. Directions for doing so pop up after clicking the FTP radio button. Firewalls may prevent use of Aspera or AWS routes of submission.
Note
It is generally not recommended to check the "Autofinish submission" box as this would not allow you to make corrections, if needed.
REVIEW & SUBMIT tab:
Check over your entire submission, then click "Submit."
If corrections are needed, you can go back and select individual tabs to edit your submission.
Note
If you are having trouble finalizing your submission, contact the relevant NCBI database for assistance, and include your submission ID in the email subject (SUB#######):
BioSample (for source metadata issues): [email protected]
SRA (for raw sequence or sequence metadata issues): [email protected]
BioSample accessions:
BioSample accessions will be automatically created upon submission and will be available on the “my submissions” page of the Submission portal by clicking on “## objects” within the submission record. You can also download by clicking the “Download attributes file with BioSample accessions”. Accessions will start with SAMNxxxxxxxx. You will also receive an email within 12 hours, but typically much faster, containing these same accessions.
SRA Accessions:
SRA run accessions will be available on the “My Submissions” page of the Submission portal by clicking on “## objects” within the submission record. You can also download by clicking the “Download metadata file with SRA accession”. Accessions will start with SRRxxxxxxx.” You will also receive an email with these same accessions within 24 hours, but typically much faster, containing these same accessions.
Important data stewardship and curation notes:
- Develop an internal method for storing and tracking your BioSample and SRR accessions! They are required for making future updates to your records.
- For updates, corrections, or retractions to your BioSample and SRA records, follow the guidance provided in by each database at NCBI. Some edits can be made within the submission portal and others need to be done via email.
Protocol
CREATED BY
Ruth Timme
Safety information
Caution: It is possible for a single BioSample to have more than one SRR ID. Two scenarios include:
- Two runs were submitted for the same isolate/BioSample, which is not generally recommended for surveillance. Follow Step 3 in the NCBI curation protocol to retract one of them).
- if the initial submission was retracted and a new run was submitted. It's important to keep track of both IDs, even if one was retracted.
BioProject Creation
Create a new BioProject
BioProjects are an organizing tool at NCBI that pulls together different kinds of data submitted across multiple NCBI databases. Each BioProject has a unique URL, providing a home page with a title, description, links to lab websites, publications, and funding resources associated with a particular project, along with links to the deposited data. A basic data BioProject holds actual sequence data, assemblies, and their associated metadata. An umbrella BioProject is a way to group two or more data BioProjects together, which is useful for coordinating disease surveillance and for looking across the grouped BioProjects in a single view.
This portion of the protocol describes the steps for creating a new data BioProject linked to an existing umbrella BioProject (usually established by a coordinating group, e.g. GenomeTrakr, NARMS, Vet-LIRN).
*If you need to create a new Umbrella BioProject, modifications are summarized in Step 3.12.
Navigate to the “My Submissions” page, https://submit.ncbi.nlm.nih.gov/subs/, and click “BioProject” in the “Start a new submission” box.
Click the “New submission” box:
Submitter tab:
Populate with submitter info. An NCBI "submitter” is the name of the person or submission group who is managing the submissions, not a supervisor or PI.
Select the appropriate submission group name (see Step 1.2 for creating a new submission group), and describe the submitting organization or laboratory name. This will be auto-populated from the contact info you included in your NCBI user account.
Project type tab:
Project data type: Genome sequencing and assembly.
Sample scope:
For a Data BioProject: Select multi-species. This will allow you to submit multiple different species to the BioProject.
Target tab:
For a Data BioProject: Populate ONLY the Organism name here:
For targeted-pathogen BioProjects:
Organism name = Include a Genus name, e.g., Salmonella sp.
For non-targeted pathogens
Organism name = "bacteria"
Create a description of the scope of the project (e.g. "enteric bacteria").
General info tab:
Click “Release immediately following processing”.
Include a brief title describing the effort.
- Data BioProject Title: e.g., “GenomeTrakr Project: NY State Dept. of Health, Wadsworth Center”.
Public Description: e.g., “Whole-genome sequencing of pure-cultured microbial pathogens as part of XXXX surveillance effort.”
Relevance: environmental.
Is your project part of a larger initiative that is already registered at NCBI?
- Data BioProjects. Click “Yes” and include a brief description and umbrella BioProject accession number (see Step 1.5). This will properly link your data project to the umbrella.
Note
Note: We advise against linking data BioProjects to multiple umbrella BioProjects.
BioSample tab:
Leave blank!! You will create biosamples separately.
Publications tab:
If relevant, include publications from your laboratory.
Review and Submit tab:
Check if everything looks correct and edit if necessary, then click “submit.”
Example for a new non-targeted BioProject
The BioProject accession will be available within a few minutes on the “My Submissions” page of the Submission portal in the format “PRJNAxxxxxx.” You will also receive an email containing the new accession.
If you are part of a coordinated surveillance effort please alert the coordinating body that a new BioProject was created under an existing umbrella.
Creating a new Umbrella BioProject:
Proceed as outlined in the above steps with the following modifications:
PROJECT TYPE tab:
For an Umbrella BioProject: Select multi-species. This will allow you to link multiple data BioProjects representing different species under a single umbrella.
---------------
TARGET tab:
For an Umbrella BioProject: Leave the Organism name field blank. Include a list or description of species you intend to include in this effort. E.g. “bacterial foodborne pathogens”, or “SARS-Cov-2”
--------------
GENERAL INFO tab:
Umbrella BioProject Title: e.g. "Microbial pathogen surveillance at NY State Dept. of Health, Wadsworth Center."
Is your project part of a larger initiative that is already registered at NCBI?
- For an Umbrella BioProject: click “NO”
--------------
Example email:
Note
“Dear BioProject and PD help teams,
Please convert the PRJNA##### to an Umbrella BioProject. Our laboratory will be submitting data under the XXX effort (SARS-CoV-2, GenomeTrakr, Vet-LIRN, NARMS, HAI, or more general pathogen surveillance).
I’d be happy to provide any additional details you might need.
Thank you, ”
After the conversion is complete you can use the new Umbrella accession to properly link any new data BioProjects being created.
Important data stewardship and curation notes:
- Develop an internal method for storing and tracking your BioProject accessions! They are required for every BioSample and sequence data submission to ensure proper linkage.
- Bookmark URLs for each of your data BioProjects to monitor the public-facing view of your submissions.
- For updates to your BioProjects: most edits can be made within the submission portal under the Manage Data tab. For others, contact mailto:[email protected].