Skip to content
Snippets Groups Projects
Commit bc3bf8c7 authored by mdriller's avatar mdriller
Browse files

Update README.md

parent 21921efd
No related branches found
No related tags found
No related merge requests found
...@@ -6,7 +6,7 @@ ...@@ -6,7 +6,7 @@
### Dependencies/Prerequisites: ### Dependencies/Prerequisites:
1. Python3 → version >3.6 necessary 1. Python3 → version >3.6 necessary
2. Python library networkx → can be installed using pip (pip install networkx) 2. Python library networkx → can be installed using pip (pip install networkx)
3- minimap2 → provided within the REAPRLong git repository (needed at this path) 3. minimap2 → provided within the REAPRLong git repository (needed at this path)
### Setup: ### Setup:
...@@ -19,12 +19,15 @@ make ...@@ -19,12 +19,15 @@ make
### Usage: ### Usage:
If python3 is in path the script can be called like: "./main.py" otherwise just "python main.py" The main script is made executable and can be executed if python3 exists at: "#!/usr/bin/env python3".
The help function can be accessed via: ./main.py -h|--help Otherwise the script can be run using python directly: "python main.py ..."
To run the script needs a genome assembly in fasta format and long reads (e.g. PacBio or ONT) in fastq or fasta format. The help function can be accessed via: ./main.py -h|--help and provides a general overview of how to use and which parameters can be set when using the tool.
>usage: main.py [-h] -ge GENOME -fq FASTQ -out OUTDIR [-m MODE] [-t THREADS] REAPRLong needs a genome assembly in fasta format, long reads (e.g. PacBio or ONT) in fastq or fasta format and a path, where output files will be generated, as mandatory input to run. Additional parameters can be set but the default values are tested and generally provide the best results.
[-mo MINOVERLAP] [-mi MINIDENT] [-it ITERATIONS] [-s SIZE] REAPRLong can be used as follows:
[-fa] \textbf{usage:} main.py [-h] -ge GENOME -fq FASTQ -out OUTDIR [-m MODE] [-t THREADS]
[-ml MINLINKS] [-mo MINOVERLAP] [-mi MINIDENT] [-it ITERATIONS]
[-s SIZE] [-fa]
>>optional arguments: >>optional arguments:
-h, --help show this help message and exit -h, --help show this help message and exit
...@@ -59,16 +62,16 @@ To run the script needs a genome assembly in fasta format and long reads (e.g. P ...@@ -59,16 +62,16 @@ To run the script needs a genome assembly in fasta format and long reads (e.g. P
REAPRLong generates multiple output files in the specified output directory. REAPRLong generates multiple output files in the specified output directory.
scaffolds.fasta - the generated scaffolds in fasta format 1. scaffolds.fasta - the generated scaffolds in fasta format
scaffolds.stats - statistics generated for scaffolds.fasta (total basepairs in the assembly, number of scaffolds, longest scaffold, average length and N10/20/30/40/ 50/60/70/80/90/100 values) 2. scaffolds.stats - statistics generated for scaffolds.fasta (total basepairs in the assembly, number of scaffolds, longest scaffold, average length and N10/20/30/40/ 50/60/70/80/90/100 values)
scaffolds.gff - gff3 file describing the regions of each new scaffold. Regions can either come from previous contigs or from reads if a gap was filled. 3. scaffolds.gff - gff3 file describing the regions of each new scaffold. Regions can either come from previous contigs or from reads if a gap was filled.
duplicates.fasta - fasta file containing contigs that were fully part of another contig and thus removed from the assembly. 4. duplicates.fasta - fasta file containing contigs that were fully part of another contig and thus removed from the assembly.
adjusted\_contigs\_it\*.fa - fasta file containing adjusted contigs, if the QC identified misassemblies and broke the previous input. The \* is an integer value indicating the iteration of QC, starting with 0. 5. adjusted\_contigs\_it\*.fa - fasta file containing adjusted contigs, if the QC identified misassemblies and broke the previous input. The \* is an integer value indicating the iteration of QC, starting with 0.
coverage\_map\_it\*.gff - a "coverage" map for the input assembly of each iteration. Regions are summarised giving a start and end position and the support given for the region. The support describes the amount of reads mapping continuously in the region substracted by the amount of reads mapping dis-continuously. Negative numbers indicate misassemblies. 6. coverage\_map\_it\*.gff - a "coverage" map for the input assembly of each iteration. Regions are summarised giving a start and end position and the support given for the region. The support describes the amount of reads mapping continuously in the region substracted by the amount of reads mapping dis-continuously. Negative numbers indicate misassemblies.
deletions\_it\*.txt - identified deletions (within the genome compared to the reads). The \* is an integer value indicating the iteration of QC, starting with 0 which represents the original assembly. Every subsequent number relates to the adjusted\_contigs\_it\*.fa of the previous iteration. 7. deletions\_it\*.txt - identified deletions (within the genome compared to the reads). The \* is an integer value indicating the iteration of QC, starting with 0 which represents the original assembly. Every subsequent number relates to the adjusted\_contigs\_it\*.fa of the previous iteration.
insertions\_it\*.txt - identified insertions (within the genome compared to the reads). The \* is an integer value indicating the iteration of QC, starting with 0 which represents the original assembly. Every subsequent number relates to the adjusted\_contigs\_it\*.fa of the previous iteration. 8. insertions\_it\*.txt - identified insertions (within the genome compared to the reads). The \* is an integer value indicating the iteration of QC, starting with 0 which represents the original assembly. Every subsequent number relates to the adjusted\_contigs\_it\*.fa of the previous iteration.
inversions\_it\*.txt - identified inversions (within the genome compared to the reads). The \* is an integer value indicating the iteration of QC, starting with 0 which represents the original assembly. Every subsequent number relates to the adjusted\_contigs\_it\*.fa of the previous iteration. 9. inversions\_it\*.txt - identified inversions (within the genome compared to the reads). The \* is an integer value indicating the iteration of QC, starting with 0 which represents the original assembly. Every subsequent number relates to the adjusted\_contigs\_it\*.fa of the previous iteration.
misjoins\_it\*.txt - identified misjoins (within the genome compared to the reads). The \* is an integer value indicating the iteration of QC, starting with 0 which represents the original assembly. Every subsequent number relates to the adjusted\_contigs\_it\*.fa of the previous iteration. 10. misjoins\_it\*.txt - identified misjoins (within the genome compared to the reads). The \* is an integer value indicating the iteration of QC, starting with 0 which represents the original assembly. Every subsequent number relates to the adjusted\_contigs\_it\*.fa of the previous iteration.
### Workflow ### Workflow
<p align="center"> <p align="center">
<img src="figures/workflow_noOptional.pdf"> <img src="figures/workflow_noOptional.pdf">
......
0% Loading or .
You are about to add 0 people to the discussion. Proceed with caution.
Please register or to comment