diff --git a/_data/sidebars/main.yml b/_data/sidebars/main.yml index 0f30fbb..9928ef5 100644 --- a/_data/sidebars/main.yml +++ b/_data/sidebars/main.yml @@ -76,13 +76,15 @@ subitems: url: /uniprot - title: ArrayExpress url: /arrayexpress - - title: Covid-19 data submission - url: /covid-19/ + - title: ENA data submission toolbox + url: /ena-submission subitems: - - title: SARS-CoV-2 raw reads submission in Galaxy - url: /covid-19/sarscov2_submission - - title: SARS-CoV-2 assembly submission in Galaxy - url: /covid-19/sarscov2_assembly_submission - - title: Frequently asked questions - url: /covid-19/faq - + - title: SARS-CoV-2 usecase + url: /covid-19/ + subitems: + - title: SARS-CoV-2 raw reads submission in Galaxy + url: /covid-19/sarscov2_submission + - title: SARS-CoV-2 assembly submission in Galaxy + url: /covid-19/sarscov2_assembly_submission + - title: FAQ for Docker deployment + url: /faq diff --git a/_sass/_bootstrap_variables.scss b/_sass/_bootstrap_variables.scss index 087bdf5..ca64c8d 100644 --- a/_sass/_bootstrap_variables.scss +++ b/_sass/_bootstrap_variables.scss @@ -30,4 +30,5 @@ $h3-font-size: 1rem * 1.5 !default; $h4-font-size: 1rem * 1.1 !default; $h5-font-size: 1rem !default; $h6-font-size: 1rem !default; +$table-bg: $white; diff --git a/images/datahub-to-ena.svg b/images/datahub-to-ena.svg new file mode 100644 index 0000000..7fb01ef --- /dev/null +++ b/images/datahub-to-ena.svg @@ -0,0 +1,337 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/images/ena-submission-toolbox.svg b/images/ena-submission-toolbox.svg new file mode 100644 index 0000000..c1e1610 --- /dev/null +++ b/images/ena-submission-toolbox.svg @@ -0,0 +1,352 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/pages/ena-submission.md b/pages/ena-submission.md new file mode 100644 index 0000000..cd9c988 --- /dev/null +++ b/pages/ena-submission.md @@ -0,0 +1,130 @@ +--- +title: ENA data submission toolbox +contributors: [Bert Droesbeke, Flora D'Anna] +description: High scale publishing of data to ENA using easy to use metadata templates. +training: + - name: Submission of SARS-CoV-2 sequence data to ENA using Galaxy + registry: YouTube + url: https://www.youtube.com/watch?v=POiQG-7O7rw + - name: "Galaxy Training network: Submitting sequence data to ENA" + registry: + url: https://training.galaxyproject.org/training-material/topics/galaxy-interface/tutorials/upload-data-to-ena/tutorial.html +--- + + +## Introduction + +The [European Nucleotide Archive (ENA)](https://www.ebi.ac.uk/ena/browser/) is a fully open repository dedicated to storing raw sequencing data, assemblies, and annotation data. The ENA data submission toolbox simplifies the submission of sequence data, including raw reads and assembled sequences by offering a single-step submission process, a graphical user interface, tabular-formatted metadata and client-side validation, for every sample checklist supported at ENA. + + +## Its components + +{% include image.html file="ena-submission-toolbox.svg" caption="Figure 1. Overview of the ENA submission toolbox components." %} + + +### ENA upload CLI + +Command line tool allowing submission of raw reads data and respective metadata to ENA using tabular files or an excel sheet. Programmatically submit study, sample, run and experiment objects without the need of logging in to the [ENA Webin interface](https://www.ebi.ac.uk/ena/submit/webin/login). + +Key features: +- Submit raw sequencing data and metadata +- High volume submissions +- Support for all sample types +- Use tabular files or an excel sheet to easily capture the metadata +- Add, modify, cancel and release ENA objects (study, experiment, run and sample) taking away the need login into ENA Webin. +- Safe credential management using a credentials file +- Client side validation using ENA checklists (samples) and official ENA XSD files (run, experiment and study) +- Compatible with the provided tsv/xlsx templates to fill in the metadata ([see below](#metadata-templates)) + +[Documentation + source](https://github.com/usegalaxy-eu/ena-upload-cli){: class="btn btn-light border rounded-pill"} +[Install using pip](https://pypi.org/project/ena-upload-cli/){: class="btn btn-light border rounded-pill"} + +### Galaxy + +[Galaxy](https://galaxyproject.org/eu/) is an open-source platform for FAIR data analysis that enables users to use tools from various domains through its graphical web interface. The 2 tool wrappers listed below make Galaxy your one stop shop for data preprocessing, analysing and submitting. Both tools can be installed through the Galaxy toolshed. + +#### Galaxy ENA upload tool + +This is the Galaxy tool wrapper of the ENA-upload-cli mentioned above. The integration with Galaxy gives the command line tool a graphic user interface and adds support for interactive submissions. + +Key features: +- Graphical user interface making it easy to use +- Raw read submissions +- ENA-upload-cli at its core +- Add and modify ENA objects +- User based credential management +- Possibility to set a system-wide brokering account +- Easy data upload/management +- Available at [useGalaxy Europe](https://usegalaxy.eu/), [useGalaxy Belgium](https://usegalaxy.be/) and [useGalaxy Australia](https://usegalaxy.org.au/) + +[Use at useGalaxy.be](https://usegalaxy.be/?tool_id=toolshed.g2.bx.psu.edu%2Frepos%2Fiuc%2Fena_upload%2Fena_upload){: class="btn btn-light border rounded-pill"} +[Source](https://github.com/galaxyproject/tools-iuc/tree/master/tools/ena_upload){: class="btn btn-light border rounded-pill"} +[Tutorial on GTN](https://training.galaxyproject.org/training-material/topics/galaxy-interface/tutorials/upload-data-to-ena/tutorial.html#submitting-raw-sequence-data-reads-to-the-ena){: class="btn btn-light border rounded-pill"} +[Galaxy toolshed](https://toolshed.g2.bx.psu.edu/repository?repository_id=0db04aa13ef9d2f8){: class="btn btn-light border rounded-pill"} + + +#### Galaxy assembly submission tool + +Galaxy wrapper to submit consensus sequences to ENA in an interactive way. The tool has the [Webin-CLI](https://github.com/enasequence/webin-cli) script of ENA at its core and supports all sample checklists. + +Key features: +- Interactive submission of the metadata +- Possibility to set a brokering account +- Easy data upload/management +- Available at [useGalaxy Belgium](https://usegalaxy.be/) + +[Use at useGalaxy.be](https://usegalaxy.be/?tool_id=toolshed.g2.bx.psu.edu%2Frepos%2Fieguinoa%2Fena_webin_cli%2Fena_consensus_submit){: class="btn btn-light border rounded-pill"} +[Source](https://github.com/usegalaxy-be/galaxytools/tree/main/consensus_sequence_ena_galaxy){: class="btn btn-light border rounded-pill"} +[Tutorial on GTN](https://training.galaxyproject.org/training-material/topics/galaxy-interface/tutorials/upload-data-to-ena/tutorial.html#submitting-consensus-sequences-to-ena){: class="btn btn-light border rounded-pill"} +[Galaxy toolshed](https://toolshed.g2.bx.psu.edu/repository?repository_id=dfa4f0fc31027b52){: class="btn btn-light border rounded-pill"} + + +### Metadata templates + +Tabular-format and xlsx spreadsheet metadata templates required to submit data to ENA using the ENA-upload-cli or GALAXY ENA upload tool. A GitHub Action is put in place to automatically keep these templates up to date with the ENA sample checklists. + +Key features: +- GitHub repo hosting tsv and xlsx templates for every checklist +- GitHub Actions to keep up to date with ENA XSD/checklist files to guarantee compatibility +- Versions in sync with the ones from ENA-upload-CLI + +[Documentation + source](https://github.com/ELIXIR-Belgium/ENA-metadata-templates){: class="btn btn-light border rounded-pill"} + +### Docker deployment + +When you can not use the Galaxy instances at useGalaxy.eu, .be and .au, possibly due to GDPR reasons, we also offer a ready to use Docker container. The Docker container is shipped with the previously mentioned Galaxy tools and deploys locally a fully usable Galaxy instance. + +Key features: +- Easy deployment of a local Galaxy instance +- Data stays on-premise until submission +- Contains: + - ENA-upload tool + - ENA Assembly submission tool + - Tool to easily clean raw reads from human reads + +[Documentation + source](https://github.com/ELIXIR-Belgium/ena-upload-container){: class="btn btn-light border rounded-pill"} +[Download image from Quay.io](https://quay.io/repository/galaxy/ena-upload){: class="btn btn-light border rounded-pill"} + + +## Using DataHub to manage your metadata + +{% include image.html file="datahub-to-ena.svg" caption="Figure 2. Submission flow of metadata from DataHub to ENA" %} + +[DataHub](https://datahub-test.elixir-belgium.org/) is a free and open platform for easier Research metaData Management in Life Sciences. Based on [FAIRDOM-SEEK](https://seek4science.org/), DataHub offers users the ability to effortlessly create sample metadata templates derived from ENA-specific templates for seamless compatibility with the ENA repository. + +Key features: +- Powered by FAIRDOM-SEEK open-source software, DataHub facilitates effective research metadata management +- Easily craft metadata templates tailored to various repositories +- Promoting and supporting ENA standards and checklists ensures data consistency and compliance +- Streamline data exchange with structured metadata export adhering to the ISA-JSON standard +- Promote ISA-JSON as a machine-actionable metadata carrier, enhancing interoperability + +{% include callout.html type="note" content="Please note that specific documentation on creating ISA-JSON for ENA in DataHub is a work in progress and will be available soon." %} + +[Try out on DataHub](https://datahub-test.elixir-belgium.org/){: class="btn btn-light border rounded-pill"} + + +## Publication + +Roncoroni, M., Droesbeke, B., Eguinoa, I., De Ruyck, K., D’Anna, F., Yusuf, D., Grüning, B., Backofen, R., & Coppens, F. (2021). A SARS-CoV-2 sequence submission tool for the European Nucleotide Archive. Bioinformatics, 37(21), 3983–3985. [https://doi.org/10.1093/bioinformatics/btab421](https://doi.org/10.1093/bioinformatics/btab421) + diff --git a/pages/covid-19/faq.md b/pages/faq.md similarity index 97% rename from pages/covid-19/faq.md rename to pages/faq.md index a6bf04a..6d1174d 100644 --- a/pages/covid-19/faq.md +++ b/pages/faq.md @@ -1,6 +1,5 @@ --- -permalink: covid-19/faq -title: Frequently asked questions +title: FAQ for Docker deployment --- ### Why is the reads cleaning tool not showing files for input?