Ley Lab Quick Viewer for Qiime 2 artifacts.
Project description
=======================
Qiime 2 `Ley Lab`_ Quick Viewer
=======================
.. _Ley Lab: http://leylab.tuebingen.mpg.de/
.. image:: https://img.shields.io/pypi/v/qiime_2_ll_quick_viewer.svg
:target: https://pypi.python.org/pypi/qiime_2_ll_quick_viewer
.. image:: https://img.shields.io/travis/leylabmpi/qiime_2_ll_quick_viewer.svg
:target: https://travis-ci.org/leylabmpi/qiime_2_ll_quick_viewer
.. image:: https://pyup.io/repos/github/leylabmpi/qiime_2_ll_quick_viewer/shield.svg
:target: https://pyup.io/repos/github/leylabmpi/qiime_2_ll_quick_viewer/
:alt: Updates
This tool launches a simple web server to quickly visualize the contents locate into the ``data`` folder from
a `Qiime 2`_ visualization artifact, i.e. files produced by **Qiime 2** with extension ``*.qzv``.
.. _Qiime 2: https://qiime2.org/
* Free software: MIT license
Installation
------------
You can install this tool on a Python 3.6 environment using this command:
``pip install qiime_2_ll_quick_viewer``
Usage
-----
Given a **Qiime 2** visualization artifact e.g. ``demux.qzv`` you can run this command on your server:
``$ qiime_2_ll_quick_viewer --filename /full_path_to/demux.qzv``
By default, **qiime_2_ll_quick_viewer** will launch a web server on the port **8089** but you can change it for the one you want with the option ``--port XXXX``.
Then, you can for example open a SSH tunnel to the remote port opened on your server by **qiime_2_ll_quick_viewer** with this command:
``$ ssh -L 8089:localhost:8089 user@your_server``
Finally, open a browser and go to this address: `http://localhost:8089`_.
.. _http://localhost:8089: http://localhost:8089
Command options:
-f, --filename TEXT Full path to a Qiime2 visualization file (*.qzv).
[required]
-p, --port INTEGER Port to launch the web server. [required]
-h, --help Show the help info and exit.
Credits
---------
This package was created with Cookiecutter_ and the `audreyr/cookiecutter-pypackage`_ project template.
.. _Cookiecutter: https://github.com/audreyr/cookiecutter
.. _`audreyr/cookiecutter-pypackage`: https://github.com/audreyr/cookiecutter-pypackage
=======
History
=======
0.2.5 (2017-11-29)
------------------
* Generated a base version for a Conda package.
0.2.4 (2017-11-29)
------------------
* Documentation has been updated to be markdown friendly.
0.2.3 (2017-11-28)
------------------
* Repository migrated to Ley Lab's Github account.
0.2.2 (2017-11-27)
------------------
* Documentation updated.
0.2.1 (2017-11-27)
------------------
* Documentation updated.
0.2.0 (2017-11-27)
------------------
* First functional version of the package.
0.1.0 (2017-11-27)
------------------
* First release on PyPI.
Qiime 2 `Ley Lab`_ Quick Viewer
=======================
.. _Ley Lab: http://leylab.tuebingen.mpg.de/
.. image:: https://img.shields.io/pypi/v/qiime_2_ll_quick_viewer.svg
:target: https://pypi.python.org/pypi/qiime_2_ll_quick_viewer
.. image:: https://img.shields.io/travis/leylabmpi/qiime_2_ll_quick_viewer.svg
:target: https://travis-ci.org/leylabmpi/qiime_2_ll_quick_viewer
.. image:: https://pyup.io/repos/github/leylabmpi/qiime_2_ll_quick_viewer/shield.svg
:target: https://pyup.io/repos/github/leylabmpi/qiime_2_ll_quick_viewer/
:alt: Updates
This tool launches a simple web server to quickly visualize the contents locate into the ``data`` folder from
a `Qiime 2`_ visualization artifact, i.e. files produced by **Qiime 2** with extension ``*.qzv``.
.. _Qiime 2: https://qiime2.org/
* Free software: MIT license
Installation
------------
You can install this tool on a Python 3.6 environment using this command:
``pip install qiime_2_ll_quick_viewer``
Usage
-----
Given a **Qiime 2** visualization artifact e.g. ``demux.qzv`` you can run this command on your server:
``$ qiime_2_ll_quick_viewer --filename /full_path_to/demux.qzv``
By default, **qiime_2_ll_quick_viewer** will launch a web server on the port **8089** but you can change it for the one you want with the option ``--port XXXX``.
Then, you can for example open a SSH tunnel to the remote port opened on your server by **qiime_2_ll_quick_viewer** with this command:
``$ ssh -L 8089:localhost:8089 user@your_server``
Finally, open a browser and go to this address: `http://localhost:8089`_.
.. _http://localhost:8089: http://localhost:8089
Command options:
-f, --filename TEXT Full path to a Qiime2 visualization file (*.qzv).
[required]
-p, --port INTEGER Port to launch the web server. [required]
-h, --help Show the help info and exit.
Credits
---------
This package was created with Cookiecutter_ and the `audreyr/cookiecutter-pypackage`_ project template.
.. _Cookiecutter: https://github.com/audreyr/cookiecutter
.. _`audreyr/cookiecutter-pypackage`: https://github.com/audreyr/cookiecutter-pypackage
=======
History
=======
0.2.5 (2017-11-29)
------------------
* Generated a base version for a Conda package.
0.2.4 (2017-11-29)
------------------
* Documentation has been updated to be markdown friendly.
0.2.3 (2017-11-28)
------------------
* Repository migrated to Ley Lab's Github account.
0.2.2 (2017-11-27)
------------------
* Documentation updated.
0.2.1 (2017-11-27)
------------------
* Documentation updated.
0.2.0 (2017-11-27)
------------------
* First functional version of the package.
0.1.0 (2017-11-27)
------------------
* First release on PyPI.
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Close
Hashes for qiime_2_ll_quick_viewer-0.2.5.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 54e80021f0d884638ef251e03141c0fe4d837d42bfbc2788c197e94affeee7ba |
|
MD5 | d6f0cd9b95237fde16cf01d3889a9d9d |
|
BLAKE2b-256 | 40281266cfa18efecac0d09b2659b412d90f4cdbe728a747987e387e2b364e7b |
Close
Hashes for qiime_2_ll_quick_viewer-0.2.5-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 52fb1b5cae2b8ec0b0f99eae2c35e3dbdd8564fb386e98bfdab2a1e3ca7ead1b |
|
MD5 | 0249d811b0d524a2863b6b47361e7fd9 |
|
BLAKE2b-256 | 78e247de78f9e85b6ad23f133f220223a274dfd9118cafc741f57a7b59f92796 |