Git Product home page Git Product logo

galaksio's Introduction

An easy to use GUI for running Galaxy workflows.

Galaksio is a web application that simplifies the usage of the Galaxy bioinformatics platform (https://usegalaxy.eu/). Galaksio provides a simple but complete UI for using Galaxy for biologists that require bioinformatics workflows to complete their research. Using the application, users can run any workflow implemented in the associated Galaxy instance in just few clicks. Besides, the rich user interface allows customizing the execution, uploading the necessary files, downloading the results, and executing several workflows simultaneously in the background.

Quick start

First install all dependencies. For example, the instructions for an Ubuntu 16.04 server would be:

apt-get update
apt-get install -y python-pip unzip wget
pip install requests bioblend flask fpdf

Download and extract the latest version of Galaksio from the GitHub repository.

wget https://github.com/sgbc/galaksio/archive/master.zip
unzip galaksio-latest.zip

Launch the Flask server. Your new Galaksio instance will be listening to port 8081.

galaksio-latest/server/run.sh --start

By default Galaksio is configured to work with the official Galaxy instance.This and other options can be customized through the web application. The first time that you access to your Galaksio instance you will need to configure some of the main settings.

Documentation

Documentation for the project, including installation instructions, can be found at the ReadTheDocs platform: http://galaksio.readthedocs.io/en/latest/.

Docker for Galaksio

The Galaksio Docker Image is an easy distributable full-fledged Galaksio installation. The docker image for Galaksio can be found in the docker hub. However, you can download the Dockerfile and other files from the Github repository

About

Galaksio has been developed by the SLU Global Bioinformatics Centre at the Sveriges lantbruksuniversitet (Swedish University of Agricultural Sciences). This project is part of the B3Africa Project http://www.b3africa.org/, which has received funding under grant agreement nr 654404 from the European Union’s Horizon 2020 research and innovation programme. Galaksio application is distributed under GNU General Public License, Version 3..

galaksio's People

Contributors

fikipollo avatar hexylena avatar nsoranzo avatar oskarslu avatar tklingstrom avatar yvanlebras avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

galaksio's Issues

Input parameters in checkbox listed are a bit awkward

When selecting between modes (for example Choose computation mode in BamSummary) Galaksio displays a list of check boxes and then the fields dependent on your choice in the check boxes. In Galaxy you instead have a drop down menu of modes which puts the dependent fields in a more clear context (in Galaksio it looks like they are choices for the last option in the checkbox list).

Can't select old history at the bottom of the second step of workflow invocation

Dear @fikipollo

Testing more deeply Galaksio, I just find that, if I have quite a lot of histories, I can't select bottom / old history on the second workflow invocation step "history selection". When I try to go down on the page, I can't (it seems this is stopping at the bottom of the content history so datasets at the right of the page). This appears in Firefox as Chrome...

Handling workflow failure better

When the workflow fails. Underneath the ”Ooops! Something went wrong during the execution of the workflow” there is a lets take a look to the results” that sends you back to the home page. Some kind of reporting/debugging and the option to retry/save input parameters would be good.

A good way to test this is to trigger workflow failure is to alter the "Effective genome size" in Galaksio with the provided workflows. It is a conditional parameter and kills the workflow..

History available at: https://usegalaxy.org/u/tomkl/h/chip-seq-megakaryocytes
Workflow: https://usegalaxy.org/u/tomkl/w/galaksiocase
Subworkflow (import it and it should be activated by the above workflow): https://usegalaxy.org/u/tomkl/w/subworkflowgalaksiocase

Cannot find previous workflows

As soon as you close the Galaksio window the workflows becomes forgotten and impossible to retrieve (Workflow invocations menu remains empty).

Making it easier to find empty fields

The red square around empty fields is only visible if the tool is opened. Instead of blanking out the next step button I think it would be appropriate to provide a field listing the steps and specific fields that needs to be filled in before progressing.

Unable to load workflow invocations

There is a recurring error saying that workflow invocations does. This is not only show on the home page view but it pops up when setting up a workflow as well.

unabletoloadinvocation

Display label of first step for input data

When selecting input data it would be good if the label of the first step is displayed. Because right now we have two identically named ”Input dataset collection” in the Galaksio workflow and it is not possible to differentiate them while they in Galaxy they are named 1: Control Fastq List and 2: Treatment Fastq List.

History available at: https://usegalaxy.org/u/tomkl/h/chip-seq-megakaryocytes
Workflow: https://usegalaxy.org/u/tomkl/w/galaksiocase
Subworkflow (import it and it should be activated by the above workflow): https://usegalaxy.org/u/tomkl/w/subworkflowgalaksiocase

Forced to enter a value in field despite not being needed

If I open the a step with the value ”Region of the genome to limit the operation to” then I am forced to fill it in (despite not being a requirement in Galaxy). I can however run the workflow as long as I do not open any step with such an option.

Data to test.
History available at: https://usegalaxy.org/u/tomkl/h/chip-seq-megakaryocytes
Workflow: https://usegalaxy.org/u/tomkl/w/galaksiocase
Subworkflow (import it and it should be activated by the above workflow): https://usegalaxy.org/u/tomkl/w/subworkflowgalaksiocase

cookie issue on firefox

During test on localhost, I have a cookie issue on firefox
after login, the user name appeared (login ok)
on the right but but view did not changed (sign in page)
I needed to clear localhost cookies to be able to see other pages

Create New account

When I tried to create a new account, a message "Your account has been created" is shown but I did not receive any email and cannot log in with that account. Login works if you create an account directly in Galaxy but not in Galaksio local server [Create an Account button].

Select boxes which are selectable parameters cause workflows to crash

Galaksio treats conditional parameters like if they are editable when they in reality are not (see:
galaxyproject/galaxy#4520 and https://docs.galaxyproject.org/en/master/dev/schema.html#tool-inputs-conditional) If edited in Galaksio and sent to a workflow they will cause a crash. So we need to change how Galaksio treat those fields.

Background posted in link 1
We have a workflow using the MACS2 callpeak tool at Usegalaxy.org. When running the workflow it is impossible to edit the "Effective genome size" unless the workflow is set to "user defined". If it for example is set to M. musculus, then it is impossible to change for this specific tool.

When retrieving the same workflow by API there is no indication that this field is hardcoded in the workflow and if it is altered then the entire workflow crashes before running on the usegalaxy.org server.

Workflow:
https://usegalaxy.org/u/tomkl/w/subworkflowgalaksiocase
Subworkflow that is required to run it:
https://usegalaxy.org/u/tomkl/w/subworkflowgalaksiocase

History with test data:
https://usegalaxy.org/u/tomkl/h/chip-seq-megakaryocytes

To agressive warning on input data

At ”Input data” you immediately get the message ” Some of the required fields are not valid or are empty. Please check the form and try again!”

Create an "import history" feature in Galaksio

Users can publish histories on Galaxy just like Workflows. Being able to import histories from the Histories view would be a great way to leverage the capacity of public Galaxy servers.

A partially successful workflow is listed as "failure" in Galaksio

Running the Mouse ChIP-seq workflow one of the tools fail due to issues with the tool. This cause Galaksio to identify the Workflow as failed and when clicking "Lets look at the results" I am sent to the Home page on Galaksio rather than the results.

This mean that the results become inaccessible.

Default parameters cannot be used for certain required fields

Treatment of tools is inconsistent between the GUI layer and the command line.

Certain tool wrappers define a default parameter which on the command line is sent as "no value" (ie no flag at all) still requires a choice to be made on the GUI level. This is problematic when managing tools through the API. Currently Galaksio checks if a required field is empty when importing the workflow JSON from Galaxy and then interprets the required field as optional (in the Galaksio GUI this mean that the default "no value" is pre-selected but any value is accepted).

This does however not work if a Galaxy workflow has been made with a non-default value in a tool which got a required field and where the default value is sent as "no value". Because in such cases the default value is still interpreted as not filling in a required field.

Improved user design when Galaxy server is down

Galaksio is dependent on the user being able to log into an external Galaxy server and does not store any user data locally. Administrator access is based on a list of e-mail addresses and if a user is able to log in to the Galaxy server using an e-mail address on the Galaxy server, then the user is granted access to the administration menu. If the initial set up is botched this mean that it is necessary to delete the Galaksio instance and create a new one, likewise a user is completely blocked from Galaksio when a Galaxy server breaks down or changes IP.

"Error while creating form" when changing modesWhen selecting between modes

When changing modes (for example Choose computation mode in BamSummary) that cause dependent fields to change. Then Galaksio throws a pop up with message ”Error while creating the form: Unknown value for data type ”null””. I do however not see any issues after receiving the error and can proceed with my workflow.

Collections are not accepted as input in a workflow

After importing a history using Galaxy I was unable to use the collections in it as input parameters in my workflow. The collections showed up correctly in the history view but when selecting input they were unavailable in the dropdown menu. They were available when selecting "browse collections" but "use selected" did not allow me to select them as input datasets. After cancelling the workflow and trying again they were available in the dropdown menus.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.