Skip to content

Commit

Permalink
[README] Edit README to include pipeline instructions; version v0.8.12
Browse files Browse the repository at this point in the history
  • Loading branch information
tanghaibao committed Dec 6, 2018
1 parent 04531ca commit 84f89f7
Show file tree
Hide file tree
Showing 2 changed files with 8 additions and 28 deletions.
34 changes: 7 additions & 27 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# ALLHIC: Genome scaffolding based on HiC data
# ALLHIC: Genome scaffolding based on Hi-C data

_ _____ _____ ____ ____ _____ ______
/ \ |_ _| |_ _| |_ || _||_ _|.' ___ |
Expand All @@ -9,15 +9,17 @@

[![Travis-CI](https://travis-ci.org/tanghaibao/allhic.svg?branch=master)](https://travis-ci.org/tanghaibao/allhic)

**This software is currently under active development. DO NOT USE.**

| | |
| --- | --- |
| Authors | Haibao Tang ([tanghaibao](http://github.com/tanghaibao)) |
| | Xingtan Zhang ([tangerzhang](https://github.com/tangerzhang)) |
| Email | <[email protected]> |
| License | [BSD](http://creativecommons.org/licenses/BSD/) |

## Introduction

This program can be used to scaffold genomic contigs based on Hi-C data, which is particularly effectively for auto-polyploid genomes. **We currently recommend using this program in a scripted pipeline, as detailed [here](https://github.com/tangerzhang/ALLHiC/wiki).**

## Installation

The easiest way to install allhic is to download the latest binary from
Expand Down Expand Up @@ -54,7 +56,6 @@ allhic prune tests/Allele.ctg.table tests/test.pairs.txt
Please see help string of `allhic prune` on the formatting of
`Allele.ctg.table`.


### <kbd>Partition</kbd>

Given a target `k`, number of partitions, the goal of the partitioning
Expand Down Expand Up @@ -113,28 +114,7 @@ allhic plot tests/test.bam tests/test.counts_GATC.2g1.tour

## <kbd>Pipeline</kbd>

Following the 4 steps of `prune`, `extract`, `partition`, `optimize`, as described above.
In summary, we have:

```console
allhic extract tests/test.bam tests/seq.fasta.gz
allhic partition tests/test.counts_GATC.txt tests/test.pairs.txt 2
allhic optimize tests/test.counts_GATC.2g1.txt tests/test.clm
allhic optimize tests/test.counts_GATC.2g2.txt tests/test.clm
allhic build tests/test.counts_GATC.2g?.txt tests/seq.fasta.gz tests/asm-2g.chr.fasta
```

Or, in a single step:

```console
allhic pipeline tests/test.bam tests/seq.fasta.gz 2
```

In summary, the pipeline requires a BAM file and the contigs FASTA file.
The user then needs to specify the Restriction Enzyme used, the number
`k` groups to partition into. Output include reconstructed chromosome
AGP file (containing how the contigs are linked together) and chromosomal
FASTA file.
Please see detailed steps in a scripted pipeline [here](https://github.com/tangerzhang/ALLHiC/wiki).

## WIP features

Expand All @@ -153,4 +133,4 @@ FASTA file.

## Reference

TBD
Zhang, X. Ming, R. Tang H. ALLHiC: phasing and scaffolding polyploid genomes based on Hi-C data. Submitted.
2 changes: 1 addition & 1 deletion base.go
Original file line number Diff line number Diff line change
Expand Up @@ -25,7 +25,7 @@ import (

const (
// Version is the current version of ALLHIC
Version = "0.8.11"
Version = "0.8.12"
// LB is lower bound for GoldenArray
LB = 18
// UB is upper bound for GoldenArray
Expand Down

0 comments on commit 84f89f7

Please sign in to comment.