Package: puzzle
# Puzzle [![Build Status][travis-image]][travis-url] [![Test Coverage][coveralls-img]][coveralls-url]Documentation at www.robinandeer.com/puzzle/Variant Caller GUI and genetic disease analysis tool.`bash $ git clonehttps://github.com/robinandeer/puzzle.git$ cd puzzle $ pip install--editable. $ puzzle view tests/fixtures/ # open webbrowser on port 5000 $ openhttp://localhost:5000`## Using Puzzle
Puzzle will look for variant calling resources such as VCF files and [GEMINI][gemini] databases and visualize their content. It lets you inspect, annotate, and analyze variant calls.Puzzle is not primarily meant to be run as a persistant server but think of it more as an webinterface to quickly spin to visualize your variant calls.We set out to makePuzzleboth very simple to install as well as intuitive to use. You can be up and running in minutes with minimal prerequisites.## Developing Puzzle
Puzzle is a Python Flask app with a command line interface. It can work with multiple backends using plugins; raw VCFs, GEMINI, MongoDB.Anyone can help make this project better - read [CONTRIBUTING](CONTRIBUTING.md) to get started!### Install for development
I decided to try out [Otto][otto] for this project so make sure you have it installed :smile:`bash $ git clonehttps://github.com/robinandeer/puzzle.git$ cd puzzle $ otto dev $ otto dev ssh > npm install > sudoapt-getinstall vimpython-pipgit > pip install--user--editable. > puzzle /vagrant/tests/ # open webbrowser on port 5000 `## Testing Puzzle
To run the tests, you need [pytest](pytest) installed in your system. You can installpytesttogether
with the other development libraries by runningpip install -r requirements-dev.txt.You will also need to download the database used for testing, which you can do by executing this command:` wgethttps://s3-us-west-2.amazonaws.com/robinandeer/HapMapFew.db-Otests/fixtures/HapMapFew.db `To test a gemini database with structural variants do:` wgethttps://s3-us-west-2.amazonaws.com/robinandeer/HapMapSv.db-Otests/fixtures/HapMapSv.db `Then, just runpy.test tests/## Use a gemini databaseMake sure you have gemini installed in your local environment` puzzle view path/to/gemini_database.db `## Use ped info ##Puzzle uses the ped file to show more information in family view and in variant calls:` puzzle view tests/fixtures/hapmap.vcf--family_file/-ftests/fixtures/hapmap.ped `## Establish a persistent local databasePuzzle can establish a persistent local database, so you can keep work between sessions.
This enables other key features, such as gene lists for filtering and variant triage.
First, you need to initialize a local database. Then one or more cases can be loaded and
are then ready for viewing as soon as the web server is started.` puzzle init--roottests/fixtures puzzle load--roottests/fixtures tests/fixtures/hapmap.vcf puzzle view--roottests/fixtures `## Structural variant visualisationPuzzle enables visualisation also of structural variants with the use of ‘–variant-type sv’ with ‘–load’ or ‘–view’.
Enjoy a list view of SVs as stored in gemini or vcf format. Key fields such as chromosomal band and size are enabled by default.If gemini database with sv:s is downloaded, as described above, do:` puzzle view tests/fixtures/HapMapSv.db `To view a example file with sv:s:` puzzle view tests/fixtures/hapmap.sv.vep.vcf.gz `## Build documentation
Documentation is generated using [Gitbook][gitbook]. Building the docs locally requires the GitBook CLI.`bash $ cd puzzle/ $ npm install-ggitbook-cli$ gitbook serve ./docs `The documentation can now be viewed onhttp://localhost:4000/.## Credits
Puzzle Piece by Creative Stall from the Noun Project## License
MIT. See the [LICENSE](LICENSE) file for more details.[travis-url]:https://travis-ci.org/robinandeer/puzzle?branch=master[travis-image]:https://img.shields.io/travis/robinandeer/puzzle/master.svg?style=flat-square[coveralls-url]:https://coveralls.io/github/robinandeer/puzzle[coveralls-img]:https://img.shields.io/coveralls/robinandeer/puzzle.svg?style=flat-square[otto]:https://ottoproject.io/[gemini]:https://github.com/arq5x/gemini[pytest]:http://pytest.org/latest/[gitbook]:https://www.gitbook.com/