Skip to content

Latest commit

 

History

History
114 lines (67 loc) · 5.7 KB

README.md

File metadata and controls

114 lines (67 loc) · 5.7 KB

DNAnalyzer: an online game for DNA data analysis

Involve and empower citizens to contribute to science

Welcome!

Welcome! 🎉 Willkommen! 🎈 Grüezi! 🎊 Bienvenue! 🎈🎈🎈

Thank you for visiting the DNAnalyzer project repository.

This document (the README file) is a hub to give you some information about the project. Jump straight to one of the sections below, or just scroll down to find out more.

What are we doing?

The problem

Especially in the last years public media is using words like sequencing, DNA, RNA, mutations, and variants, without easy to understand scientific explanations. Theses key words do not necessarily help informing the audience and sometimes leads to even more confusion. As scientists it is our duty to not only report but also explain our work in an easy to understand way. Technologies like DNA sequencing are getting cheaper and therefore more accessible for various applications, e.g. in personalized medicine. This produces more data. Platforms like Galaxy (Afgan et al., Nucl Acids Res , 2018) and the Galaxy training material (Batut et al., Cell syst, 2018) help scientists analyzing their own (complex) data in a user friendly way. However, for each analysis there are several ways to perform it. Experience and knowledge helps to achieve good results, but sometimes one has to test several combinations of different algorithms and parameter settings. This can be exhausting and time consuming.

The solution

We are implementing an encouraging and easy-to-understand online game on DNA data analysis, the DNAnalyzer.

We have some interesting story, to make the game more exciting. You can see them here

The game, implemented in Galaxy, will consist of several levels:

  1. Learning: about biological background (DNA and sequencing) and how to use the platform.
  2. Hands on: perform the first guided data analysis.
  3. Expert: change and improve their pipeline for data analysis.

Gamer will in the first two levels collect points by answering questions or finding treasures by following hints. In the third level gamer and reseachter will interactively evaluate dataanalysis of otheres and thereby give and get points. We believe that the integration of society into the scientific both will profit. Citizens will get excited for science and they can help to analyze and improve scientific data.

Who are we?

We are the Street Science Community, a group of researchers and teachers in Freiburg trying to bring DNA, sequencing, metagenomics and in general the scientific process closer to citizens. Therefore, we already developed the BeerDEcoded project: a series of hands-on workshops for pupils and citizens with the general aim of scientific outreach. During these workshops, we guide participants through the scientific project of the extraction and identification of different yeasts contained in a beer sample. The citizens are performing the whole process from opening the beer bottle to the last klick while performing the data analysis. We generated protocols that lead the citizens through the extraction of yeast DNA, the identification via sequencing, and the analyzation of the sequenced DNA via an easy and straightforward user interface. Our aim is to make science tangible and accessible for everyone.

What do we need?

You! In whatever way you can help.

We are searching for motivated students in computer science, who will be given a hiwi contract. We also want to work closely with the Galaxy community, to get implementation ideas and tips. We would like to get hints and inspiration from teachers and storytellers to improve the appeal of our game for users. And of course any direct feedback of a non-researcher's opinion of the usability and gaming factor.

Get involved

If you think you can help in any of the areas listed above (and we bet you can) or in any of the many areas that we haven't yet thought of (and here we're sure you can) then please check out our contributors' guidelines and our roadmap.

Please note that it's very important to us that we maintain a positive and supportive environment for everyone who wants to participate. When you join us we ask that you follow our code of conduct in all interactions both on and offline.

Contact us

If you want to report a problem or suggest an enhancement we'd love for you to open an issue at this github repository because then we can get right on it.

Thank you

Thank you very much for visiting our project repository. We hope you feel inspired and welcomed to test or even contribute to our online microbiome data analysis.

How can I generate the website locally?

The Project relies on Flask and Postgres. The detailed installation instructions are available here

Generate videos

Requirements

Ubuntu

$ sudo apt-get install sox
$ sudo apt-get install libsox-fmt-mp3

Steps

In different terminals:

  1. Launch MozillaTTS for speech

    $ docker run -it -p 5002:5002 synesthesiam/mozillatts
    
  2. Launch scripts

    $ conda activate dnanalyzer
    $ ./bin/ari-make.sh <path to slide>
    

You need to modify <path to slide>, e.g ./bin/ari-make.sh game/level1/intro/slides.md

Update quiz questions

If changes are made to the quiz questions in yaml files under the folder game

The following script needs to be run before starting the app to update the database

$ python init_yaml_to_db.py