#+TITLE: About/FAQ #+AUTHOR: Pjotr Prins * Table of Contents :TOC:noexport: - [[#what-is-the-public-sequence-resource-about][What is the 'public sequence resource' about?]] - [[#presentations][Presentations]] - [[#who-created-the-public-sequence-resource][Who created the public sequence resource?]] - [[#how-does-the-public-sequence-resource-compare-to-other-data-resources][How does the public sequence resource compare to other data resources?]] - [[#why-should-i-upload-my-data-here][Why should I upload my data here?]] - [[#why-should-i-not-upload-by-data-here][Why should I not upload by data here?]] - [[#how-does-the-public-sequence-resource-work][How does the public sequence resource work?]] - [[#who-uses-the-public-sequence-resource][Who uses the public sequence resource?]] - [[#how-can-i-contribute][How can I contribute?]] - [[#is-this-about-open-data][Is this about open data?]] - [[#is-this-about-free-software][Is this about free software?]] - [[#how-do-i-upload-raw-data][How do I upload raw data?]] - [[#how-do-i-change-metadata][How do I change metadata?]] - [[#how-do-i-change-the-work-flows][How do I change the work flows?]] - [[#how-do-i-change-the-source-code][How do I change the source code?]] - [[#should-i-choose-cc-by-or-cc0][Should I choose CC-BY or CC0?]] - [[#are-there-also-variant-in-the-rdf-databases][Are there also variant in the RDF databases?]] - [[#how-do-i-deal-with-private-data-and-privacy][How do I deal with private data and privacy?]] - [[#do-you-have-any-checks-or-concerns-if-human-sequence-accidentally-submitted-to-your-service-as-part-of-a-fastq-][Do you have any checks or concerns if human sequence accidentally submitted to your service as part of a fastq? *]] - [[#does-pubseq-support-only-sars-cov-2-data][Does PubSeq support only SARS-CoV-2 data?]] - [[#how-do-i-communicate-with-you][How do I communicate with you?]] - [[#citing-pubseq][Citing PubSeq]] - [[#who-are-the-sponsors][Who are the sponsors?]] * What is the 'public sequence resource' about? PubSeq, the *public sequence resource*, aims to provide a generic and useful resource for COVID-19 research. The focus is on providing the best possible sequence data with associated metadata that can be used for sequence comparison and protein prediction. Just to avoid the notion that PubSeq is a biorepository: it is far more than that. We are not competing with the likes of GenBank, EBI/ENA and GISAID - in fact, PubSeq sources much of the data from those and they get ours. There is no conflict of posting data to multiple repositories. It is better to view PubSeq as an *open precision medicine initiative* that allows for early detection of new variants and strains; very valuable for both testing and treatment. We have live analysis work flows that run on uploading a new sequence. Contributing sequences helps the overall detection. At this moment the output is limited. We will soon add interactive discovery tools. Uploading data from a sequencer will give researchers all information they want in 5 hours *without any bioinformatics knowledge*. We may even provide workflows that take data straight from the sequencer. In fact, you get very little out of existing biorepositories, in our opinion, unless you have solid bioinformatics support. And even then there is the question about comparing data that was created using different technologies and workflows. How do you deal with that? With PubSeq we are in a position to reanalyse that data from raw material when new insights arise. It is likely that COVID19 will be around for another year at least. After that we should prepare for the next pandemic. PubSeq is meant for that. We take the long view and it will only get more powerful. Who knows: maybe the live analysis part of PubSeq will be an approach that other biorepositories will follow. * Presentations We presented at the BOSC 2020 Have a look at the [[https://bcc2020.sched.com/event/coLw][video]] ([[https://drive.google.com/file/d/1skXHwVKM_gl73-_4giYIOQ1IlC5X5uBo/view?usp=sharing][alternative link]]) and the [[https://drive.google.com/file/d/1vyEgfvSqhM9yIwWZ6Iys-QxhxtVxPSdp/view?usp=sharing][poster]]. * Who created the public sequence resource? The *public sequence resource* is an initiative by [[https://github.com/arvados/bh20-seq-resource/graphs/contributors][bioinformatics]] and ontology experts who want to create something agile and useful for the wider research community. The initiative started at the COVID-19 biohackathon in April 2020 and is ongoing. The main project drivers are Pjotr Prins (UTHSC), Peter Amstutz (Curii), Andrea Guarracino (University of Rome Tor Vergata), Michael Crusoe (Common Workflow Language), Thomas Liener (consultant, formerly EBI), Erik Garrison (UCSC) and Jerven Bolleman (Swiss Institute of Bioinformatics). Notably, as this is a free software initiative, the project represents major work by hundreds of software developers and ontology and data wrangling experts. Thank you everyone! * How does the public sequence resource compare to other data resources? The short version is that we use state-of-the-art practices in bioinformatics using agile methods. Unlike the resources from large institutes we can improve things on a dime and anyone can contribute to building out this resource! Sequences from GenBank, EBI/ENA and others are regularly added to PubSeq. We encourage people to everyone to submit on PubSeq because of its superior live tooling and metadata support (see the next question). Importantly: all data is published under either the [[https://creativecommons.org/licenses/by/4.0/][Creative Commons 4.0 attribution license]] or the [[https://creativecommons.org/share-your-work/public-domain/cc0/][CC0 “No Rights Reserved” license]] which means it data can be published and workflows can run in public environments allowing for improved access for research and reproducible results. This contrasts with some other public resources, such as GISAID. * Why should I upload my data here? 1. We champion truly shareable data without licensing restrictions - with proper attribution 2. We provide full metadata support using state-of-the-art ontology's 2. We provide a web-based sequence uploader and a command-line version for bulk uploads 3. We provide a live SPARQL end-point for all metadata 2. We provide free data analysis and sequence comparison triggered on data upload 3. We do real work for you, with this [[https://workbench.lugli.arvadosapi.com/container_requests/lugli-xvhdp-bhhk4nxx1lch5od][link]] you can see the last run took 5.5 hours! 4. We provide free downloads of all computed output 3. There is no need to set up pipelines and/or compute clusters 4. All workflows get triggered on uploading a new sequence 4. When someone (you?) improves the software/workflows and everyone benefits 4. Your data gets automatically integrated with the Swiss Institure of Bioinformatics COVID-19 knowledge base https://covid-19-sparql.expasy.org/ (Elixir Switzerland) 4. Your data will be used to develop drug targets Finally, if you upload your data here we have workflows that output formatted data suitable for [[http://covid19.genenetwork.org/blog?id=using-covid-19-pubseq-part6][uploading to EBI resources]] (and soon others). Uploading your data here get your data ready for upload to multiple resources. * Why should I not upload by data here? Funny question. There are only good reasons to upload your data here and make it available to the widest audience possible. In fact, you can upload your data here as well as to other resources. It is your data after all. No one can prevent you from uploading your data to multiple resources. We recommend uploading to EBI and NCBI resources using our data conversion tools. It means you only enter data once and make the process smooth. You can also use our command line data uploader for bulk uploads! * How does the public sequence resource work? On uploading a sequence with metadata it will automatically be processed and incorporated into the public pangenome with metadata using workflows from the High Performance Open Biology Lab defined [[https://github.com/hpobio-lab/viral-analysis/tree/master/cwl/pangenome-generate][here]]. * Who uses the public sequence resource? The Swiss Institute of Bioinformatics has included this data in https://covid-19-sparql.expasy.org/ and made it part of [[https://www.uniprot.org/][Uniprot]]. The Pantograph [[https://graph-genome.github.io/][viewer]] uses PubSeq data for their visualisations. [[https://uthsc.edu][UTHSC]] (USA), [[https://www.esr.cri.nz/][ESR]] (New Zealand) and [[https://www.ornl.gov/news/ornl-fight-against-covid-19][ORNL]] (USA) use COVID-19 PubSeq data for monitoring, protein prediction and drug development. * How can I contribute? You can contribute by submitting sequences, updating metadata, submit issues on our issue tracker, and more importantly add functionality. See 'How do I change the source code' below. Read through our online documentation at http://covid19.genenetwork.org/blog as a starting point. * Is this about open data? All data is published under a [[https://creativecommons.org/licenses/by/4.0/][Creative Commons 4.0 attribution license]] (CC-BY-4.0). You can download the raw and published (GFA/RDF/FASTA) data and store it for further processing. * Is this about free software? Absolutely. Free software allows for fully reproducible pipelines. You can take our workflows and data and run it elsewhere! * How do I upload raw data? We are preparing raw sequence data pipelines (fastq and BAM). The reason is that we want the best data possible for downstream analysis (including protein prediction and test development). The current approach where people publish final sequences of SARS-CoV-2 is lacking because it hides how this sequence was created. For reasons of reproducible and improved results we want/need to work with the raw sequence reads (both short reads and long reads) and take alternative assembly variations into consideration. This is all work in progress. * How do I change metadata? See the [[http://covid19.genenetwork.org/blog]]! * How do I change the work flows? Workflows are on [[https://github.com/arvados/bh20-seq-resource/tree/master/workflows][github]] and can be modified. See also the BLOG [[http://covid19.genenetwork.org/blog]] on workflows. * How do I change the source code? Go to our [[https://github.com/arvados/bh20-seq-resource][source code repositories]], fork/clone the repository, change something and submit a [[https://github.com/arvados/bh20-seq-resource/pulls][pull request]] (PR). That easy! Check out how many PRs we already merged. * Should I choose CC-BY or CC0? Restrictive data licenses are hampering data sharing and reproducible research. CC0 is the preferred license because it gives researchers the most freedom. Since we provide metadata there is no reason for others not to honour your work. We also provide CC-BY as an option because we know people like the attribution clause. In all honesty: we prefer both data and software to be free. * Are there also variant in the RDF databases? We do output a RDF file with the pangenome built in, and you can parse it because it has variants implicitly. We are also writing tools to generate VCF files directly from the pangenome. * How do I deal with private data and privacy? A public sequence resource is about public data. Metadata can refer to private data. You can use your own (anonymous) identifiers. We also plan to combine identifiers with clinical data stored securely at [[https://redcap-covid19.elixir-luxembourg.org/redcap/][REDCap]]. See the relevant [[https://github.com/arvados/bh20-seq-resource/issues/21][tracker]] for more information and contributing. * Do you have any checks or concerns if human sequence accidentally submitted to your service as part of a fastq? * We are planning to remove reads that match the human reference. * Does PubSeq support only SARS-CoV-2 data? To date, PubSeq is a resource specific to SARS-CoV-2, but we are designing it to be able to support other species in the future. * How do I communicate with you? We use a [[https://gitter.im/arvados/pubseq?utm_source=share-link&utm_medium=link&utm_campaign=share-link][gitter channel]] you can join. See also [[./contact][contact]]. * Citing PubSeq We have two publications in the works. Until we have a DOI please cite PubSeq in the following way: We made use of the COVID-19 public sequence (PubSeq) resources hosted at http://covid19.genenetwork.org/. * Who are the sponsors? The main sponsors are listed in the footer. In addition to the time generously donated by many contributors we also acknowledge Amazon AWS for donating COVID-19 related compute time.