From 330497e09c16613e3238faedb43c93fe34022ae3 Mon Sep 17 00:00:00 2001 From: Jasmine Elaine Mckinnon <58950226+jas-mckin@users.noreply.github.com> Date: Wed, 3 Jul 2024 15:31:31 +0100 Subject: [PATCH 1/4] Add cohort-subs-guide.rst add cohort-subs-guide.rst updates to pathogen-subs-guide.rst -updates new link to pathogen portal -improves wording and fixes typos --- faq/cohort-subs-guide.rst | 149 ++++++++++++++++++++++++++++++++++++ faq/pathogen-subs-guide.rst | 48 ++++++------ 2 files changed, 172 insertions(+), 25 deletions(-) create mode 100644 faq/cohort-subs-guide.rst diff --git a/faq/cohort-subs-guide.rst b/faq/cohort-subs-guide.rst new file mode 100644 index 00000000..5fd76582 --- /dev/null +++ b/faq/cohort-subs-guide.rst @@ -0,0 +1,149 @@ +Submit Multi-Omic Cohort Datasets +================================= + +This guide includes information about how to submit a multi-omic dataset to be displayed as an entry in the `Pathogens +Portal Cohort browser `_. +If you have a multi-omic dataset you wish to archive, but it is not linked to Pathogens, similar principles will apply, +but the dataset will not be displayed in the Pathogens Portal. + +Introduction +```````````` +Infectious disease plays out as an intricate set of molecular interactions between the systems of both pathogen and infected host. +In cases of vector-borne disease, such as malaria, or diseases with intermediate hosts, such as tapeworm, interactions with further +species are involved. Studying these interconnected biologies, such as to understand infection mechanisms and patient response, +develop clinical and public health interventions and predict outcomes of the circulation of new pathogen variants, requires the use +of combined data sets which span the two or more organisms involved in the infection. + +Regardless of which technical platform is used for their generation, biological data can be organised around the concept of sample. +A biological sample, such as a blood sample from a patient, can be represented as a digital record with an identifier. When the +sample is subjected to different assays, such as genomic sequencing or serology analysis, each of the resultant data sets can +reference the identifier of the sample from which they were derived. In many workflows, samples are divided, such as when a +wastewater sample is size-filtered to yield a bacterial subsample and a viral subsample. Records for each of these new samples +can be created and given their own identifiers, and reference can be made back to the sample from which they were derived by using +its top-level sample identifier. + +For example, in this diagram example, the top-level sample (#1) is linked to various child samples which hold information +for data in multiple databases: + +.. image:: images/linked_samples.png + :width: 600 + :alt: diagram showing BioSample relationships and data types + :align: center + +Steps +````` +The steps detailed here provide an overview of how to create a multi-omic dataset record. +Before starting a submission, we strongly advise you to contact us at cohort-dataflow@ebi.ac.uk if you are planning to submit a +linked cohort dataset, including some details about your study, and we can give guidance on your sample structure, and how +to complete the data submissions. The Samples structure will be be created in the `BioSamples Archive `_ +, which is a resource at the EBI (European Bioinformatics Institute). + +1. Create the top-level Sample +'''''''''''''''''''''''''''''' + +The first step is to create top-level Samples. These Samples will represent each case or patient in the study. +This is represented by Sample #1 in the diagram. If this is a human sample, this can contain minimal, non-identifying metadata about +the patient (e.g. gender, organism, disease). See an example `here `_. + +Top-level Sample records can be created in BioSamples using the `BioSamples uploader tool `_. + +.. note :: + The ENA and the `EGA (European Genome Phenome Archive) `_ are the only archives which integrate + BioSample records into their :doc:`database structure `. For data deposited at other + archives, additional BioSample records may need to be created (in BioSamples) to represent those data. + +2. Submit Pathogen Sequence data to the ENA +''''''''''''''''''''''''''''''''''''''''''' + +The next step is to submit your pathogen nucleotide records (raw reads or assembly data) to the ENA. +The :doc:`Pathogen Submissions Guide ` provides a quick introduction to the ENA and tips for +Pathogen data submissions. + + +2. Create the child Samples in additional database resources +'''''''''''''''''''''''''''''''''''''''''''''''''''''''''''' + +The next step is to create your datasets in the correct database for the data type. The `EBI submissions wizard +`_ can help direct you to a resource to deposit your data. +We can reccommend the following database resources for common data types: + +- For sensitive human nucleotide records and human clinical epidemiological data which requires controlled access, please + contact the `EGA (European Genome Phenome Archive) `_ to start a submission. +- For expression data, or uncategorsied datasets, please use `ArrayExpress/BioStudies `_ + +After the datasets have been submitted in the appropriate databases, the required child Samples for linking can be created. +The child samples will represent their relationship to the top-level Sample. Different samples can be used for different +data types **and** for different time points. Please contact us if you have any doubts about setting up your sample structure. + + +3. Link together the samples using BioSamples +'''''''''''''''''''''''''''''''''''''''''''''' + +Link your samples created from other EBI resources to the top-level sample using the ‘derived from’ curation +on biosamples: https://www.ebi.ac.uk/biosamples/docs/references/api/submit#_submit_curation_object + +Link your samples created from other EBI resources to the top-level sample using the ‘derived from’ curation on +BioSamples. The derived from relationship is used as follows, where the Source is the child Sample, and the Target is +the top-level Sample: + +**Source sample** - *derived from* - **Target sample** + +**Child sample accession** - *derived from* - **Parent sample accession** + +For example, in the first linked dataset, the `EMC study `_, +the BioSamples relationship is as follows: + +**[T/B-Cell/Antibody profile/ENA viral sample accession]** - *derived from* - **[Top level patient sample accession]** + +A JSON file curation object (see example below) containing the relationship attribute with the source and target sample +can be created and submitted via curl to the `BioSamples API `_) + +JSON curation: + +.. code-block:: JSON + + { + "curation" : { + "relationshipsPre" : [ ], + "relationshipsPost" : [ { + "source" : "SAMFAKE123456", + "type" : "DERIVED_FROM", + "target" : "SAMFAKE7654321" + } ], + "hash" : "09a5a9cddbea9f5bb6302b86b922c408abc92b8b10c78f0662ac7e41fd44e91f" + }, + "domain" : null, + "webinSubmissionAccountId" : "WEBIN-12345", + "created" : "2023-07-17T12:19:33.056356Z", + "hash" : "d1f611ec2c8caf3d9f58fa40227ea60ebb5fc00eda06338fb81db7d987a6fa63" + } + +.. + +There is also a `python script`_ +which can be used to create the sample relationships. Please contact ena-path-collabs@ebi.ac.uk for technical support +with any questions related to sample linking using BioSamples. + +4. Submit the cohort metadata +''''''''''''''''''''''''''''' + +While the BioSamples database is key to capturing the linking of data types on participant level, the +`Cohort Browser `_ presents a range of study-level information about each cohort. +This metadata is an integral part of the Pathogens Portal, enhancing the findability of a cohort dataset, and this serves +as the primary entry point into the dataset. The included data types in the dataset will be represented by the +'Type of data' column within the cohort browser. + +For your cohort to display within a cohort browser, please contact us to check which metadata will be needed for your dataset. +As a guide, the following information will be needed to describe the cohort: + +- Cohort acronym/link to webpage +- Cohort title +- Cohort/study description +- Institution +- Number of participants +- Territory/country +- Enrollment period + +Please find the form `here `_ +for a more complete version of the suggested metadata. Please get in touch with us using cohort-dataflow@ebi.ac.uk if you +would like to add your cohort metadata to the Pathogens Portal Cohort Browser. \ No newline at end of file diff --git a/faq/pathogen-subs-guide.rst b/faq/pathogen-subs-guide.rst index 31418d08..f16b9411 100644 --- a/faq/pathogen-subs-guide.rst +++ b/faq/pathogen-subs-guide.rst @@ -2,8 +2,9 @@ General Pathogens Submissions Guide ================================== .. image:: images/pathogens_logo_1.png - :width: 400 - :align: center + :width: 400 + :alt: Pathogens Portal logo + :align: center @@ -15,19 +16,22 @@ Introduction ~~~~~~~~~~~~ -This guide provides general information and help for submitting pathogen sequence data to the `European Nucleotide Archive (ENA) `_ -. All public `INSDC `_ pathogen data will be made available to browse using the `Pathogens Portal `_. +This guide provides general information and help for submitting pathogen sequence data to the +`European Nucleotide Archive (ENA) `_. The ENA is a partner of the `INSDC +`_ (International Nucleotide Sequence Database Collaboration), and provides an entry point for +INSDC data. All public pathogen data is made available by the ENA to explore and browse via +the `Pathogens Portal `_. -Please see below for a specific guide for submitting pathogen related data. The guide frequently refers to the -`ENA Training Modules `_, -our general ENA submissions guide. If you have any queries or require assistance with your submission please contact -us at ena-path-collabs@ebi.ac.uk. +This is a walk-through guide for submitting pathogen-related raw read files and assembled 'clone or isolate' genomes. +The guide frequently refers to our `ENA Data Submission `_ pages. +If your pathgoen dataset is not raw reads or a genome, or you have any other queries about archiving your data at the +ENA, you can also contact us at ena-path-collabs@ebi.ac.uk. .. tip:: - **Looking for something else?** + **Are you submitting SARS-CoV-2 or Monkeypox virus data?** - For pathogen-specific submissions guidance, please refer to these guides: + We have tailored support for SARS-CoV-2 and Monkeypox virus data submissions here: - `ENA SARS-CoV-2 submissions guide `_ - `Monkeypox virus ENA submissions Guidance `_ @@ -53,15 +57,6 @@ Before submitting data to ENA, it is important to familiarise yourself with the and what parts of your research project can be represented by which metadata objects. This will determine what you need to submit. -.. raw:: html - - - - - - - - ENA Submission routes ````````````````````` ENA allows submissions via three routes, each of which is appropriate for a @@ -173,7 +168,7 @@ in the checklists. If you specify the strain with both, this will make your stra The `ENA taxonomy API `_ interface may also be used. -Sample host +Sample Host ''''''''''' Every pathogen checklist includes host attribute fields which can be used to describe the host. Here is provided some guidance on filling the host fields. @@ -235,8 +230,9 @@ Prepare files Assembly file ''''''''''''' -The accepted format for unannotated genome assembly is **fasta** OR for annotated genome assembly, the accepted format is **embl flat file** -Please refer to the `Accepted genome assembly data formats guide `_ +The accepted format for unannotated genome assembly is **fasta**. For annotated genome assemblies, the accepted format +is **embl flat file**. Please refer to `Accepted Genome Assembly Data Formats +`_ for information about preparing these files. @@ -244,8 +240,8 @@ Manifest file ''''''''''''' The manifest file is a tab-separated .txt file for Webin-CLI assembly submission. It specifies metadata about the -assembly, including the study and sample it is linked to. -Please refer to the `assembly manifest file guide `_ +assembly, including the Study and Sample it is linked to. +Please refer to the `Clone or isolate genome manifest file guide `_ for permitted values. For example, the following manifest file represents a genome assembly consisting of contigs provided in one fasta file: @@ -270,7 +266,9 @@ For example, the following manifest file represents a genome assembly consisting Chromosome list file '''''''''''''''''''' -The **chromosome list file** must be provided when the submission contains assembled chromosomes. This is a tab separated file up to four columns. Each row describes each replicon unit within the assembly. Please refer to the `chromosome list file guide `_ +The **chromosome list file** must be provided when the submission contains assembled chromosomes. This is a tab +separated file up to four columns. Each row describes each replicon unit within the assembly. Please refer to +`Accepted Genome Assembly Data Formats `_ for permitted values. .. tabs:: From 9a9280867e8a517b52ae46c7336aab2a036c1143 Mon Sep 17 00:00:00 2001 From: Jasmine Elaine Mckinnon <58950226+jas-mckin@users.noreply.github.com> Date: Wed, 3 Jul 2024 15:35:10 +0100 Subject: [PATCH 2/4] Update clearinghouse_for_ENA_users.md fixes link to bash script example --- submit/annotation/clearinghouse_for_ENA_users.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/submit/annotation/clearinghouse_for_ENA_users.md b/submit/annotation/clearinghouse_for_ENA_users.md index 21996cd1..21a206cf 100644 --- a/submit/annotation/clearinghouse_for_ENA_users.md +++ b/submit/annotation/clearinghouse_for_ENA_users.md @@ -127,5 +127,5 @@ It is important to differentiate between the curations submitted via the ELIXIR ## Appendix: -### 1. [A template bash script for submission](clearinghouse_submission_template.sh) +### 1. {doc}`A template bash script for submission ` From 0666492b9c60bd73048bb7dca12e8341aefb3070 Mon Sep 17 00:00:00 2001 From: Jasmine Elaine Mckinnon <58950226+jas-mckin@users.noreply.github.com> Date: Wed, 4 Sep 2024 16:01:44 +0100 Subject: [PATCH 3/4] update cohort subs guide - add sample structure image - updates to doc structure --- faq/cohort-subs-guide.rst | 46 ++++++++++++++++++---------------- faq/images/linked_samples.png | Bin 0 -> 28234 bytes 2 files changed, 24 insertions(+), 22 deletions(-) create mode 100644 faq/images/linked_samples.png diff --git a/faq/cohort-subs-guide.rst b/faq/cohort-subs-guide.rst index 5fd76582..e430884b 100644 --- a/faq/cohort-subs-guide.rst +++ b/faq/cohort-subs-guide.rst @@ -1,5 +1,5 @@ -Submit Multi-Omic Cohort Datasets -================================= +How to Submit Multi-Omic Cohort Datasets +======================================== This guide includes information about how to submit a multi-omic dataset to be displayed as an entry in the `Pathogens Portal Cohort browser `_. @@ -32,18 +32,17 @@ for data in multiple databases: Steps ````` -The steps detailed here provide an overview of how to create a multi-omic dataset record. -Before starting a submission, we strongly advise you to contact us at cohort-dataflow@ebi.ac.uk if you are planning to submit a -linked cohort dataset, including some details about your study, and we can give guidance on your sample structure, and how -to complete the data submissions. The Samples structure will be be created in the `BioSamples Archive `_ -, which is a resource at the EBI (European Bioinformatics Institute). +The steps below provide an overview of creating a multi-omic dataset. Before starting a submission, we strongly advise +you to contact us at cohort-dataflow@ebi.ac.uk if you are planning to submit a linked cohort dataset, including some +details about your study, and we can give guidance on your sample structure, and how to complete the data submissions. -1. Create the top-level Sample -'''''''''''''''''''''''''''''' +1. Create the top-level BioSample +''''''''''''''''''''''''''''''''' -The first step is to create top-level Samples. These Samples will represent each case or patient in the study. -This is represented by Sample #1 in the diagram. If this is a human sample, this can contain minimal, non-identifying metadata about -the patient (e.g. gender, organism, disease). See an example `here `_. +The first step is to create top-level Samples using the `BioSamples Archive `_. +These Samples will represent each case or patient in the study. This is represented by Sample #1 in the diagram. +If this is a human sample, this can contain minimal, non-identifying metadata about the patient (e.g. gender, +organism, disease). See an example `here `_. Top-level Sample records can be created in BioSamples using the `BioSamples uploader tool `_. @@ -55,12 +54,13 @@ Top-level Sample records can be created in BioSamples using the `BioSamples uplo 2. Submit Pathogen Sequence data to the ENA ''''''''''''''''''''''''''''''''''''''''''' -The next step is to submit your pathogen nucleotide records (raw reads or assembly data) to the ENA. +The next step is to submit your nucleotide records (raw reads or assembly data) to the ENA. The :doc:`Pathogen Submissions Guide ` provides a quick introduction to the ENA and tips for Pathogen data submissions. +Otherwise, please refer to the :doc:`ENA General Submissions Guide <../submit/general-guide>`. -2. Create the child Samples in additional database resources +3. Submit other data types to appropriate database resources '''''''''''''''''''''''''''''''''''''''''''''''''''''''''''' The next step is to create your datasets in the correct database for the data type. The `EBI submissions wizard @@ -71,16 +71,19 @@ We can reccommend the following database resources for common data types: contact the `EGA (European Genome Phenome Archive) `_ to start a submission. - For expression data, or uncategorsied datasets, please use `ArrayExpress/BioStudies `_ +4. Create the child BioSamples for linking +'''''''''''''''''''''''''''''''''''''''''' + After the datasets have been submitted in the appropriate databases, the required child Samples for linking can be created. The child samples will represent their relationship to the top-level Sample. Different samples can be used for different data types **and** for different time points. Please contact us if you have any doubts about setting up your sample structure. -3. Link together the samples using BioSamples +5. Link together the samples using BioSamples '''''''''''''''''''''''''''''''''''''''''''''' -Link your samples created from other EBI resources to the top-level sample using the ‘derived from’ curation -on biosamples: https://www.ebi.ac.uk/biosamples/docs/references/api/submit#_submit_curation_object +Link your samples created from other EBI resources to the top-level sample using a +`BioSamples ‘derived from’ curation `_. Link your samples created from other EBI resources to the top-level sample using the ‘derived from’ curation on BioSamples. The derived from relationship is used as follows, where the Source is the child Sample, and the Target is @@ -90,7 +93,7 @@ the top-level Sample: **Child sample accession** - *derived from* - **Parent sample accession** -For example, in the first linked dataset, the `EMC study `_, +For example, in the first linked dataset, the `Erasmus Medical Cemter (EMC) study `_, the BioSamples relationship is as follows: **[T/B-Cell/Antibody profile/ENA viral sample accession]** - *derived from* - **[Top level patient sample accession]** @@ -120,11 +123,10 @@ JSON curation: .. -There is also a `python script`_ -which can be used to create the sample relationships. Please contact ena-path-collabs@ebi.ac.uk for technical support -with any questions related to sample linking using BioSamples. +Please contact ena-path-collabs@ebi.ac.uk for technical support with any questions related to sample +linking using BioSamples. -4. Submit the cohort metadata +6. Submit the cohort metadata ''''''''''''''''''''''''''''' While the BioSamples database is key to capturing the linking of data types on participant level, the diff --git a/faq/images/linked_samples.png b/faq/images/linked_samples.png new file mode 100644 index 0000000000000000000000000000000000000000..0fe9125dc65a23d5965850d8ed8f767ff7ad369f GIT binary patch literal 28234 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 Ix(?z04|iu Date: Thu, 26 Sep 2024 13:48:27 +0100 Subject: [PATCH 4/4] Update cohort-subs-guide.rst fix Biosamples curation link --- faq/cohort-subs-guide.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/faq/cohort-subs-guide.rst b/faq/cohort-subs-guide.rst index e430884b..a7b6ef50 100644 --- a/faq/cohort-subs-guide.rst +++ b/faq/cohort-subs-guide.rst @@ -83,7 +83,7 @@ data types **and** for different time points. Please contact us if you have any '''''''''''''''''''''''''''''''''''''''''''''' Link your samples created from other EBI resources to the top-level sample using a -`BioSamples ‘derived from’ curation `_. +`BioSamples derived from curation `_. Link your samples created from other EBI resources to the top-level sample using the ‘derived from’ curation on BioSamples. The derived from relationship is used as follows, where the Source is the child Sample, and the Target is @@ -148,4 +148,4 @@ As a guide, the following information will be needed to describe the cohort: Please find the form `here `_ for a more complete version of the suggested metadata. Please get in touch with us using cohort-dataflow@ebi.ac.uk if you -would like to add your cohort metadata to the Pathogens Portal Cohort Browser. \ No newline at end of file +would like to add your cohort metadata to the Pathogens Portal Cohort Browser.