============ Installation ============ Installation and use requires Python 2.7. If setuptools_ and pip_ are installed, BIOA (along with VirA) can be installed simply by: :command:`sudo pip bioa` Otherwise BIOA (and VirA) may be downloaded from bitbucket_. Once downloaded and unpacked enter the new bioa directory and install by issuing the command: :command:`sudo python setup.py install` Either mechanism for installation checks if the required Python packages are installed: Cython_, Numpy_/Scipy_, NetworkX_, BioPython_, and PySam_ The installer will download and fetch any required packages [#f1]_. If fetching a missing packages fails, manual installation via the above links should correct it. Note: Due to Cython and PySam only being able to run in linux environments, VirA and some BIOA functionality are limited to linux. This may change in a future version if possible. Once installation is complete, VirA may be launched simply by: :command:`vira read_file reference_file primer_file` VirA requires InDelFixer_ to align reads and kGEM_ to correct sequencing errors. Place the jar files for both applications in the directory you wish to run VirA in. If these tools are already installed on your system export the JAR paths to the following environment variables: INDELFIXER_PATH and KGEM_PATH. For example, if both JAR files are located in `/home/jdoe/myjars/` then issue the following commands: :command:`export INDELFIXER_PATH=/home/jdoe/myjars/` and :command:`export KGEM_PATH=/home/jdoe/myjars/` Alternatively you could place these commands in your .bashrc file. Finally VirA uses SamTools_ for pre-processing of the sam/bam alignment files. Using BIOA as a package in your own Python-based projects is as simple as adding: :samp:`import bioa` .. rubric:: Installation Footnote .. [#f1] The only exception is the CPLEX_ library. That is needed only for multi-commodity flow (parameter k > 0) and several algorithms. As CPLEX is proprietary software, the downloader cannot install it on required machines. .. toctree:: :maxdepth: 2 .. _setuptools: http://pypi.python.org/pypi/setuptools .. _pip: http://pypi.python.org/pypi/pip .. _bitbucket: https://bitbucket.org/nmancuso/bioa/downloads .. _Cython: http://cython.org/ .. _Numpy: http://www.numpy.org/ .. _Scipy: http://www.scipy.org/ .. _NetworkX: http://networkx.github.com/ .. _BioPython: http://biopython.org .. _PySam: http://code.google.com/p/pysam/ .. _CPLEX: http://www.cplex.com .. _InDelFixer: http://www.bsse.ethz.ch/cbg/software/InDelFixer .. _kGem: http://alan.cs.gsu.edu/KGEM.jar .. _SamTools: http://samtools.sourceforge.net/