Skip to content

Commit b05b114

Browse files
committed
update
1 parent a49eac0 commit b05b114

File tree

1 file changed

+5
-5
lines changed

1 file changed

+5
-5
lines changed

README.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,25 +1,25 @@
11
# MAGmax
22
MAGmax is a dereplication tool designed to maximize the recovery of Metagenome-Assembled Genomes (MAGs) through bin Merging and reAssembly. It performs dereplication in three stages: (i) grouping bins based on average sequence identity, (ii) merging bins within each group, and (iii) reassembling the merged bins.
33

4-
## INPUTS
4+
## Inputs
55
MAGmax requires three input directories,
66
1. `binsdir`, directory containing bin files in FASTA format that need to be dereplicated. (e.g., output files from any metagenome binning tool)
77

88
2. `readdir`, directory containing read files in FASTQ format for each sample.
99

1010
3. `mapid_dir`, directory containing mapping files for each sample. Each file is a text file listing read IDs and the corresponding contig IDs they mapped to. These files are used to retrieve reads that map to each merged bin from the FASTQ files in `readdir` and to generate new bin-specific FASTQ files for reassembly.
1111

12-
## OUTPUT
12+
## Output
1313
An output directory named `mags_<x>comp_<y>purity` will be created, where `x` and `y` correspond to the user-specified completeness and purity thresholds used to select final bins. By default, MAGmax uses a percentage of 50 for completeness and 95 for purity.
1414
The output directory contains dereplicated bins, and a text file listing the completeness and contamination scores for each bin as calculated by CheckM2.
1515

16-
### Example command line call
16+
## Example command line call
1717

1818
magmax -b <binsdir> -r <readdir> -m <mapid_dir> -f fasta -t 24
1919
magmax -b <binsdir> -r <readdir> -m <mapid_dir> -f fasta -t 24 -q quality_report.tsv // if CheckM2 result is already available
2020
magmax -b <binsdir> -r <readdir> -m <mapid_dir> -f fasta -t 24 --split // if input bins are not already split by sample id
2121

22-
## Install
22+
## Installation
2323
### Prerequisites
2424

2525
- **Rust**: Follow the instructions [here](https://www.rust-lang.org/tools/install) to install Rust.
@@ -87,7 +87,7 @@ Option 2: Build from source
8787
-V, --version
8888
Print version
8989

90-
### Test run using toy data
90+
## Test run using toy data
9191
This example test run demonstrates dereplication of bins using the provided toy dataset. In the `test/bins` directory, example bins generated with MetaBAT2 are given. In the `test/reads` directory, paired-end read files for two samples are given and in the `test/mapids` directory, mapid files mapping reads to contigs for each sample are given. Precomputed CheckM2 quality scores for the input bins are given in the `test/quality_report.tsv`. Run the following command to execute the test:
9292

9393
magmax -b test/bins -r test/reads -m test/mapids -t 24 -q test/quality_report.tsv

0 commit comments

Comments
 (0)