Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Start with adding a general ENA data submission toolbox landingpage #111

Merged
merged 12 commits into from
Mar 14, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
20 changes: 11 additions & 9 deletions _data/sidebars/main.yml
Original file line number Diff line number Diff line change
Expand Up @@ -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
1 change: 1 addition & 0 deletions _sass/_bootstrap_variables.scss
Original file line number Diff line number Diff line change
Expand Up @@ -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;

337 changes: 337 additions & 0 deletions images/datahub-to-ena.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
352 changes: 352 additions & 0 deletions images/ena-submission-toolbox.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
130 changes: 130 additions & 0 deletions pages/ena-submission.md
Original file line number Diff line number Diff line change
@@ -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="<b>Figure 1.</b> 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))

[<i class="fa-brands fa-github me-2"></i>Documentation + source](https://github.com/usegalaxy-eu/ena-upload-cli){: class="btn btn-light border rounded-pill"}
[<i class="fa-solid fa-download me-2"></i>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/)

[<i class="fa-solid fa-play me-2"></i>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"}
[<i class="fa-brands fa-github me-2"></i>Source](https://github.com/galaxyproject/tools-iuc/tree/master/tools/ena_upload){: class="btn btn-light border rounded-pill"}
[<i class="fa-solid fa-graduation-cap me-2"></i>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"}
[<i class="fa-solid fa-download me-2"></i>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/)

[<i class="fa-solid fa-play me-2"></i>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"}
[<i class="fa-brands fa-github me-2"></i>Source](https://github.com/usegalaxy-be/galaxytools/tree/main/consensus_sequence_ena_galaxy){: class="btn btn-light border rounded-pill"}
[<i class="fa-solid fa-graduation-cap me-2"></i>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"}
[<i class="fa-solid fa-download me-2"></i>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

[<i class="fa-brands fa-github me-2"></i>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

[<i class="fa-brands fa-github me-2"></i>Documentation + source](https://github.com/ELIXIR-Belgium/ena-upload-container){: class="btn btn-light border rounded-pill"}
[<i class="fa-solid fa-download me-2"></i>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="<b>Figure 2.</b> 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." %}

[<i class="fa-solid fa-play me-2"></i>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)

3 changes: 1 addition & 2 deletions pages/covid-19/faq.md → pages/faq.md
Original file line number Diff line number Diff line change
@@ -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?
Expand Down
Loading