Package: pomoxis
Pomoxis - bioinformatics tools for nanopore researchPomoxis comprises a set of basic bioinformatic tools tailored to nanopore
sequencing. Notably tools are included for generating and analysing draft
assemblies. Many of these tools are used by the research data analysis
group at Oxford Nanopore Technologies.Documentation can be found athttps://nanoporetech.github.io/pomoxis/.© 2018 Oxford Nanopore Technologies Ltd.FeaturesWraps third party tools with known good default parameters
and methods of use.Creates an isolated environment with all third-party tools.Can be installed with conda.Streamlines common short analysis chains.Integrates intokatualifor performing more complex analysis pipelines.Open source (Mozilla Public License 2.0).CompatibilityPomoxis is developed on Ubuntu 16.04, other recent linuxes should be
equally compatible (see build notes below). Pomoxis is known to work on
at least some MacOS High Sierra configurations, though some components,
notably scrappy, are known to not work on some MacOS configurations
(combinations of OS and xcode versions).InstallationMuch of pomoxis's functionality is dependent on thirty party tools. These
can be provided by the user, or can be installed with the help of the
providedMakefileInstallation with condaPomoxis is available onbiocondaand so can be most easily installed with:conda install pomoxisInstallation with pipFor those who prefer python's native package manager, pomoxis is also available
on pypi and can be installed using pip:pip install git+https://github.com/rrwick/Porechop
pip install pomoxisWe recommend using pomoxis within a virtual environment, viz.:virtualenv pomoxis --python=python3 --prompt "(pomoxis) "
. pomoxis/bin/activate
pip install git+https://github.com/rrwick/Porechop
pip install pomoxisUsing this method requires the user to provide several binaries:minimap2,miniasm,racon,samtools,bcftools, andseqkit,and place these within thePATH.Installation from sourceWith this method pomoxis will install itself into a an isolated virtual
environment. The installation will fetch, compile, and install all direct
dependencies into the environment. Use this method if you do not wish to
use conda, but will not be providing the third-party binaries.Before installing pomoxis is may be required to install some prerequisite
packages, best installed by a package manager. On Ubuntu these are:gcc-4.9g++-4.9zlib1g-devlibncurses5-devpython3-all-devlibhdf5-devlibatlas-base-devlibopenblas-baselibopenblas-devlibbz2-devliblzma-devlibffi-devmakepython-virtualenvcmake (for racon)wget (for fetching modules from github)bzip2 (for extracting those modules)To setup the environment run:git clone --recursive https://github.com/nanoporetech/pomoxis
cd pomoxis
make install
. ./venv/bin/activateThe installation of porechop (https://github.com/rrwick/Porechop)
requires a newer compiler than is a available on some systems. It may therefore
be necessary to install a newer compiler and set environment variables before
themake installstep:# For porechop to be compiled on older systems set these, e.g.:
export CXX="g++-4.9" CC="gcc-4.9"Note also that racon requires at leastgcc>=4.8.5tocompile smoothly.Installation without compiling third-party binariesRunning the above within a pre-exisiting (virtual) environnment may well fail;
advanced may wish to simply runpython setup.py installin the standard manner after compiling the third party programs listed below
and ensuring they are present on thePATH. Thesetup.pyscript can copy
the binaries into the python interpreter path if they are placed within a
directory namedbincachealongsidesetup.py. To make use of this facility
run:pip install -r requirements.txt
POMO_BINARIES=1 python setup.py installThird party binariesThe distribution bundles some common bioinformatics tools:miniasmminimap2raconsamtoolsbcftoolsseqkitporechopHelpLicence and Copyright© 2018 Oxford Nanopore Technologies Ltd.pomoxisis distributed under the terms of the Mozilla Public License 2.0.Research ReleaseResearch releases are provided as technology demonstrators to provide early
access to features or stimulate Community development of tools. Support for
this software will be minimal and is only provided directly by the developers.
Feature requests, improvements, and discussions are welcome and can be
implemented by forking and pull requests. However much as we would
like to rectify every issue and piece of feedback users may have, the
developers may have limited resource for support of this software. Research
releases may be unstable and subject to rapid iteration by Oxford Nanopore
Technologies.