Author: | Pierre-Yves Chibon <[email protected]>, <[email protected]> |
---|
A web application for MQ2 to quickly visualize output from MapQTL analysis
Assuming one QTL per linkage group and using the LOD threshold set by the user. This application extracts all the QTLs detected by MapQTL, using the JoinMap map file, it finds the closest marker and finally put the number of QTLs found for each marker on the map.
This approach quickly allows you to find and visualize potential QTL hotspot in your dataset. This is particularly usefull for large QTL analysis on a large number of traits.
Source: https://github.com/PBR/MQ2_Web
Run it at: http://www.plantbreeding.wur.nl/mq2
This project is a Flask application, as such it depends on:
- python (2.5 minimum)
- python-flask
- python-flask-wtf
- python-wtforms
Since this project is a web-interface to MQ2, it requires MQ2 installed.
Instruction to deploy this application is available on the Flask deployment documentation page.
My approach.
Below is the approach I took to deploy the instance on a local machine.
Retrieve the sources:
cd /srv/ git clone <repo> cd MQ2_Web
Copy the configuration file:
cp mq2.cfg.sample mq2.cfg
Adjust the configuration file (upload folder, secret key...)
Don't forget to create the folder and set its right it you use a specific one,
for example if you use /var/www/uploads
as upload folder:
sudo mkdir /var/www/uploads sudo chown apache:apache /var/www/uploads
Then configure apache:
sudo vim /etc/httd/conf.d/wsgi.conf
and put in this file:
WSGIScriptAlias /mq2 /var/www/wsgi/mq2.wsgi <Directory /var/www/wsgi/> Order deny,allow Allow from all </Directory>
Then create the file /var/www/wsgi/mq2.wsgi with:
import sys sys.path.insert(0, '/srv/MQ2_Web') import mq2_web application = mq2_web.APP
Then restart apache and you should be able to access the website on http://localhost/mq2
The configuration file contains the name of a sample_session
which is
presented in the index page of the project to show what MQ² can do.
Create your own sample session by creating a folder in the static
folder of MQ²_Web. Place on this folder the dataset you want to have in
your sample session (name it input.zip
) and set in the configuration
file the name of the directory you created.
This project contains unit-tests allowing you to check if your server has all the dependencies correctly set.
To run them:
python tests.py
Note that the unit-tests will fail if the upload_folder
defined in
mq2.cfg
is not writable for the user running the tests.
Within the sources of the project is a script called clean_uploads.py
which can be called from within a cron job to clean the upload directory
and remove the session older than X days.
This X
is set at the top of the script and can be adjusted as desired.
python clean_uploads.py --help
provides more information about the options available for this script.
Beware that this script requires the mq2.cfg
file to be in the same
directory as it is.
This project is licensed GPLv3+.