Metadata-Version: 2.1
Name: tmtk
Version: 0.4.4
Summary: A toolkit for ETL curation for the tranSMART data warehouse.
Home-page: https://www.github.com/thehyve/tmtk/
Author: Jochem Bijlard
Author-email: j.bijlard@gmail.com
License: UNKNOWN
Download-URL: https://github.com/thehyve/tmtk/tarball/0.4.4/
Keywords: transmart,etl,arborist,concept tree
Platform: UNKNOWN
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Requires-Dist: pandas (>=0.19.2)
Requires-Dist: ipython (>=5.3.0)
Requires-Dist: jupyter (>=1.0.0)
Requires-Dist: jupyter-client (>=5.0.0)
Requires-Dist: jupyter-core (>=4.3.0)
Requires-Dist: jupyter-console (>=5.1.0)
Requires-Dist: notebook (>=4.4.1)
Requires-Dist: requests (>=2.13.0)
Requires-Dist: tqdm (>=4.11.0)
Requires-Dist: xlrd (>=1.0.0)
Requires-Dist: click (>=6.0)
Requires-Dist: arrow (>=0.10.0)

====
tmtk
====

Master:

.. image:: https://travis-ci.org/thehyve/tmtk.svg?branch=master
    :target: https://travis-ci.org/thehyve/tmtk

.. image:: https://codecov.io/gh/thehyve/tmtk/branch/master/graph/badge.svg
    :target: https://codecov.io/gh/thehyve/tmtk

.. image:: https://readthedocs.org/projects/tmtk/badge/?version=latest
    :target: http://tmtk.readthedocs.io/en/latest/?badge=latest
    :alt: Documentation Status

Develop:

.. image:: https://travis-ci.org/thehyve/tmtk.svg?branch=develop
    :target: https://travis-ci.org/thehyve/tmtk

.. image:: https://codecov.io/gh/thehyve/tmtk/branch/develop/graph/badge.svg
    :target: https://codecov.io/gh/thehyve/tmtk


Anaconda Cloud latest package:

.. image:: https://anaconda.org/conda-forge/tmtk/badges/version.svg
    :target: https://anaconda.org/conda-forge/tmtk


A toolkit for ETL curation for the tranSMART data warehouse. The
TranSMART curation toolkit (``tmtk``) can be used to edit and validate
studies prior to loading them with `transmart-batch`_.

For general documentation visit `readthedocs`_.

Installation
------------

Installing via Anaconda Cloud or Pypi package managers
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Anaconda:

.. code:: sh

    $   conda install -c conda-forge tmtk

Pypi:

.. code:: sh

    $   pip3 install tmtk

Installing manually
^^^^^^^^^^^^^^^^^^^

Initialize a virtualenv
~~~~~~~~~~~~~~~~~~~~~~~

.. code:: bash

    $ pip install virtualenv
    $ virtualenv -p /path/to/python3.x/installation env
    $ source env/bin/activate


For mac users it will most likely be

.. code:: bash

    $ pip install virtualenv
    $ virtualenv -p python3 env
    $ source env/bin/activate

or do this using `virtualenvwrapper`_.


Installation from source
~~~~~~~~~~~~~~~~~~~~~~

To install *tmtk* and all dependencies into your Python environment,
and enable the Arborist Jupyter notebook extension, run:

.. code:: sh

    $   pip3 install -r requirements.txt
    $   python3 setup.py install

or if you want to run the tool from code in development mode:

.. code:: sh

    $   pip3 install -r requirements.txt
    $   python3 setup.py develop
    $   jupyter-nbextension install --py tmtk.arborist
    $   jupyter-serverextension enable tmtk.arborist


Requirements
^^^^^^^^^^^^

These dependencies will have be installed:
 - pandas>=0.19.2
 - ipython>=5.3.0
 - jupyter>=1.0.0
 - jupyter-client>=5.0.0
 - jupyter-core>=4.3.0
 - jupyter-console>=5.1.0
 - notebook>=4.2.0
 - requests>=2.13.0
 - tqdm>=4.11.0

Optional dependencies:
 - mygene>=3.0.0

Licence
-------

LGPL-3.0

.. _transmart-batch: https://github.com/thehyve/transmart-batch/
.. _virtualenvwrapper: https://virtualenvwrapper.readthedocs.io
.. _readthedocs: https://tmtk.readthedocs.io/en/latest/
.. _examples: examples


