ArtRand / signalAlign

HMM-HDP models for MinION signal alignments
MIT License
45 stars 12 forks source link

SignalAlign

MinION signal-level alignment and methylation detection using hidden Markov Models with hierarchical Dirichlet process kmer learning.

Introduction

Nanopore sequencing is based on the principal of isolating a nanopore in a membrane separating buffered salt solutions, then applying a voltage across the membrane and monitoring the ionic current through the nanopore. The Oxford Nanopore Technologies (ONT) MinION sequences DNA by recording the ionic current as DNA strands are enzymatically guided through the nanopore. SignalAlign will align the ionic current from the MinION to a reference sequence using a trainable hidden Markov model (HMM). The emissions model for the HMM can either be the table of parametric normal distributions provided by ONT or a hierarchical Dirichlet process (HDP) mixture of normal distributions. The HDP models enable mapping of methylated bases to your reference sequence. Instructions for usage including building/training HDP models can be found in the manual.

Requirements

Installation:

  1. Recursively clone this repo git clone --recursive https://github.com/ArtRand/signalAlign.git
  2. cd into the directory and run make
  3. Test the installation by running make test
  4. All of the programs can be found in the /bin/ directory

Using Docker

These steps were tested in both a Linux and OS X Sierra environment using Docker: https://docs.docker.com/installation/

To download signalAlign Docker container:

docker pull mitenjain/signalalign

To run signalAlign from the container:

docker run mitenjain/signalalign runSignalAlign

Code in this repo is based on cPecan (https://github.com/benedictpaten/cPecan)