Installation

To install htsint there are two steps.

1. install the python package
2. setup the database

htsint is tested with current versions of Ubuntu and OSX although it should run under any operating system as it is simply a Python package with an attached PostgreSQL database. Because Debian based distros are common in the bioinformatics world, some installation details are Debian specific.

To ensure that you can run BLAST locally install the Suite of BLAST+ tools. For example,

~$ sudo apt-get install ncbi-blast+

As of the current release the following Python packages are used by htsint.

• NumPy
• SciPy
• matplotlib
• NetworkX
• Biopython
• Psycopg2
• SQLAlchemy

Install hstint

htsint is at its core a Python package so it may be installed (or upgraded) like most other packages in the Python package index.

~$ pip install htsint

~$ pip install htsint --upgrade

Note

htsint can also be installed from source.

Setting up your database

Follow the database setup instructions. Ensure that you edit the taxa field of the config file to fit your needs.

Installing from source

Installation from source requires that the prerequsites are present before proceeding.

First install the prerequsite Python packages. For example,

~$ sudo apt-get install python-numpy python-matplotlib python-networkx python-biopython
~$ sudo apt-get install python-scipy python-psycopg2 python-sqlalchemy

Then install the database (see previous section for details on setup).

Install htsint

~$ cd /htsint
~$ sudo python setup.py install

Unittests

First you will need to download the data and populate the database. Instructions for this are on the database page. Once everything is setup you can run the unittests to ensure everything is working properly.

~$ cd /htsint
~$ python runTests.py

Links

• How to run BLAST on a local computer
• Pip documentation