Galaxy History Evaluator or ghevaluator is a command-line Python tool to compare Galaxy histories to a template workflow and generate a JSON and HTML report files.
Galaxy is an open, web-based platform for data-intensive computational research.
When running their data analysis, Galaxy users create histories storing their data, but also the steps of the data analysis, i.e. the tools used, their versions and parameters.
Galaxy is also used for training where participants follow step-by-step tutorials, stored in Galaxy histories. At the end, participants might want to know if they followed correctly the tutorial and instructors might need to evaluate histories to give feedback and deliver certificates. Evaluating histories manually can be painful and error prone.
Galaxy History Evaluator aims to solve this by providing a command-line tool to compare a Galaxy history to a templare workflow and generate a report in JSON and HTML with difference between the provided history and the expected workflow.
Galaxy History Evaluator can be used via command-line
$ ghevaluator --help
usage: ghevaluator [-h] -u HISTORY_URL -w WORKFLOW_URL -a APIKEY [-o OUTPUT]
Compare a Galaxy history to a template workflow and generate the JSON and HTML report files
options:
-h, --help show this help message and exit
-u HISTORY_URL, --history_url HISTORY_URL
URL to Galaxy history
-w WORKFLOW_URL, --workflow_url WORKFLOW_URL
URL to template workflow
-a APIKEY, --apikey APIKEY
Galaxy API key
-o OUTPUT, --output OUTPUT
Path to output directoryGalaxy History Evaluator can be installed with pip:
$ pip install ghevaluator- Export the Galaxy API key as environment variable
$ export GALAXY_API_KEY=<REPLACE_WITH_GALAXY_API_KEY>- Run the unit tests
$ make testDocumentation could be found at https://streetscience.community/ghevaluator/
To update it:
-
Make the changes in
src/docs -
Generate the doc with
$ make html