-
Notifications
You must be signed in to change notification settings - Fork 14
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
[README] Edit README to include pipeline instructions; version v0.8.12
- Loading branch information
1 parent
04531ca
commit 84f89f7
Showing
2 changed files
with
8 additions
and
28 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
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 | ||
|
||
_ _____ _____ ____ ____ _____ ______ | ||
/ \ |_ _| |_ _| |_ || _||_ _|.' ___ | | ||
|
@@ -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 | ||
|
@@ -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 | ||
|
@@ -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 | ||
|
||
|
@@ -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. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters