# NanoPlot
Plotting tool for long read sequencing data and alignments.
[](https://twitter.com/wouter_decoster)
[](https://anaconda.org/bioconda/nanoplot)
[](https://travis-ci.org/wdecoster/NanoPlot)
### NanoPlot is also available as a [web service](http://nanoplot.bioinf.be).
The example plot above shows a bivariate plot comparing log transformed read length with average basecall Phred quality score. More examples can be found in the [gallery on my blog 'Gigabase Or Gigabyte'.](https://gigabaseorgigabyte.wordpress.com/2017/06/01/example-gallery-of-nanoplot/)
In addition to various plots also a NanoStats file is created summarizing key features of the dataset.
This script performs data extraction from Oxford Nanopore sequencing data in the following formats:
- fastq files
(can be bgzip, bzip2 or gzip compressed)
- fastq files generated by albacore, guppy or MinKNOW containing additional information
(can be bgzip, bzip2 or gzip compressed)
- sorted bam files
- sequencing_summary.txt output table generated by albacore, guppy or MinKnow basecalling
(can be gzip, bz2, zip and xz compressed)
- fasta files
(can be bgzip, bzip2 or gzip compressed)
Multiple files of the same type can be offered simultaneously
### INSTALLATION
`pip install NanoPlot`
Upgrade to a newer version using:
`pip install NanoPlot --upgrade`
or
[](https://anaconda.org/bioconda/nanoplot)
`conda install -c bioconda nanoplot`
The script is written for python3.
### OUTPUT
NanoPlot creates:
- a statistical summary
- a number of plots
- a html summary file
### USAGE
```
usage: NanoPlot [-h] [-v] [-t THREADS] [--verbose] [--store] [--raw] [--huge] [-o OUTDIR] [--no_static] [-p PREFIX] [--tsv_stats] [--info_in_report] [--maxlength N]
[--minlength N] [--drop_outliers] [--downsample N] [--loglength] [--percentqual] [--alength] [--minqual N] [--runtime_until N] [--readtype {1D,2D,1D2}]
[--barcoded] [--no_supplementary] [-c COLOR] [-cm COLORMAP] [-f [{png,jpg,jpeg,webp,svg,pdf,eps,json} ...]] [--plots [{kde,hex,dot} ...]]
[--legacy [{kde,dot,hex} ...]] [--listcolors] [--listcolormaps] [--no-N50] [--N50] [--title TITLE] [--font_scale FONT_SCALE] [--dpi DPI] [--hide_stats]
(--fastq file [file ...] | --fasta file [file ...] | --fastq_rich file [file ...] | --fastq_minimal file [file ...] | --summary file [file ...] | --bam file [file ...] | --ubam file [file ...] | --cram file [file ...] | --pickle pickle | --feather file [file ...])
CREATES VARIOUS PLOTS FOR LONG READ SEQUENCING DATA.
General options:
-h, --help show the help and exit
-v, --version Print version and exit.
-t, --threads THREADS
Set the allowed number of threads to be used by the script
--verbose Write log messages also to terminal.
--store Store the extracted data in a pickle file for future plotting.
--raw Store the extracted data in tab separated file.
--huge Input data is one very large file.
-o, --outdir OUTDIR Specify directory in which output has to be created.
--no_static Do not make static (png) plots.
-p, --prefix PREFIX Specify an optional prefix to be used for the output files.
--tsv_stats Output the stats file as a properly formatted TSV.
--info_in_report Add NanoPlot run info in the report.
Options for filtering or transforming input prior to plotting:
--maxlength N Hide reads longer than length specified.
--minlength N Hide reads shorter than length specified.
--drop_outliers Drop outlier reads with extreme long length.
--downsample N Reduce dataset to N reads by random sampling.
--loglength Additionally show logarithmic scaling of lengths in plots.
--percentqual Use qualities as theoretical percent identities.
--alength Use aligned read lengths rather than sequenced length (bam mode)
--minqual N Drop reads with an average quality lower than specified.
--runtime_until N Only take the N first hours of a run
--readtype {1D,2D,1D2}
Which read type to extract information about from summary. Options are 1D, 2D,
1D2
--barcoded Use if you want to split the summary file by barcode
--no_supplementary Use if you want to remove supplementary alignments
Options for customizing the plots created:
-c, --color COLOR Specify a valid matplotlib color for the plots
-cm, --colormap COLORMAP
Specify a valid matplotlib colormap for the heatmap
-f, --format [{png,jpg,jpeg,webp,svg,pdf,eps,json} ...]
Specify the output format of the plots, which are in addition to the html files
--plots [{kde,hex,dot} ...]
Specify which bivariate plots have to be made.
--legacy [{kde,dot,hex} ...]
Specify which bivariate plots have to be made (legacy mode).
--listcolors List the colors which are available for plotting and exit.
--listcolormaps List the colors which are available for plotting and exit.
--no-N50 Hide the N50 mark in the read length histogram
--N50 Show the N50 mark in the read length histogram
--title TITLE Add a title to all plots, requires quoting if using spaces
--font_scale FONT_SCALE
Scale the font of the plots by a factor
--dpi DPI Set the dpi for saving images
--hide_stats Not adding Pearson R stats in some bivariate plots
Input data sources, one of these is required.:
--fastq file [file ...]
Data is in one or more default fastq file(s).
--fasta file [file ...]
Data is in one or more fasta file(s).
--fastq_rich file [file ...]
Data is in one or more fastq file(s) generated by albacore, MinKNOW or guppy
with additional information concerning channel and time.
--fastq_minimal file [file ...]
Data is in one or more fastq file(s) generated by albacore, MinKNOW or guppy
with additional information concerning channel and time. Is extracted swiftly
without elaborate checks.
--summary file [file ...]
Data is in one or more summary file(s) generated by albacore or guppy.
--bam file [file ...]
Data is in one or more sorted bam file(s).
--ubam file [file ...]
Data is in one or more unmapped bam file(s).
--cram file [file ...]
Data is in one or more sorted cram file(s).
--pickle pickle Data is a pickle file stored earlier.
--feather file [file ...]
Data is in one or more feather file(s).
EXAMPLES:
NanoPlot --summary sequencing_summary.txt --loglength -o summary-plots-log-transformed
NanoPlot -t 2 --fastq reads1.fastq.gz reads2.fastq.gz --maxlength 40000 --plots hex dot
NanoPlot --color yellow --bam alignment1.bam alignment2.bam alignment3.bam --downsample 10000
```
### NOTES
- `--downsample` won't save you tons of time, as down sampling is only done after collecting all data and probably would only make a difference for a huge amount of data. If you want to save time you could down sample your data upfront. Note also that extracting information from a summary file is faster than other formats, and that you can extract from multiple files simultaneously (which will happen in parallel then). Some plot types (especially kde) are slower than others and you can take a look at the input for `--plots` to speed things up (default is to make both kde and dot plot). If you are only interested in say the read length histogram it is possible to write a script to just get you that and avoid wasting time on the rest. Let me know if you need any help here.
- `--plots` uses the plotly package to plot kde and dot plots. Hex option will be ignored.
- `--legacy` plotting of a hex plot currently is only possible using this option,which uses the seaborn and matplotlib package, since there is no support for it in plotly (yet). Plots like kde and dot are also possible with this option.
### EXAMPLE USAGE
```bash
NanoPlot --summary sequencing_summary.txt --loglength -o summary-plots-log-transformed
NanoPlot -t 2 --fastq reads1.fastq.gz reads2.fastq.gz --maxlength 40000 --plots dot --legacy hex
NanoPlot -t 12 --color yellow --bam alignment1.bam alignment2.bam alignment3.bam --downsample 10000 -o bamplots_downsampled
```
<!-- This script now also provides read length vs mean quality plots in the '[pauvre](https://github.com/conchoecia/pauvre)'-style from [@conchoecia](https://github.com/conchoecia). -->
## ACKNOWLEDGMENTS/CONTRIBUTORS
- [Ilias Bukraa](https://github.com/iliasbukraa) for tremendous improvements and maintenance of the code
- Andreas Sjödin for building and maintaining conda recipes
- Darrin Schultz [@conchoecia](https://github.com/conchoecia) for Pauvre code
- [@alexomics](https://github.com/alexomics) for fixing the indentation of the printed stats
- Botond Sipos [@bsipos](https://github.com/bsipos) for speeding up the calculation of average quality scores
## CONTRIBUTING
I welcome all suggestions, bug reports, feature requests and contributions. Please leave an [issue](https://github.com/wdecoster/NanoPlot/issues) or open a pull request. I will usually respond within a day, or rarely within a few days.
## PLOTS GENERATED
Plot|Fastq|Fastq_rich|Fastq_minimal|Bam|Summary|Options|Style
----|----|----|----|----|----|----|----
Histogram of read length|x|x|x|x|x|N50|
Histogram of (log transformed) read length|x|x|x|x|x|N50|
Bivariate plot of length against base call quality|x|x||x|x|log transformation|dot, hex, kde
Heatmap of reads per channel||x|||x||
Cumulative yield plot||x|x||x||
Violin plot of read length over time||x|x||x||
Violin plot of base call quality over time||x|||x||
Bivariate plot of aligned read length against sequenced read length||||x|||dot, hex, kde
Bivariate plot of percent reference identity against read length||||x||log transformation|dot, hex, kde
Bivariate plot of percent reference identity against base call quality||||x|||dot, hex, kde
Bivariate plot of mapping quality against read length||||x||log transformation|dot, hex, kde
Bivariate plot of mapping quality against basecall quality||||x|||dot, hex, kde
## COMPANION SCRIPTS
- [NanoComp](https://github.com/wdecoster/nanocomp): comparing multiple runs
- [NanoStat](https://github.com/wdecoster/nanostat): statistic summary report of reads or alignments
- [NanoFilt](https://github.com/wdecoster/nanofilt): filtering and trimming of reads
- [NanoLyse](https://github.com/wdecoster/nanolyse): removing contaminant reads (e.g. lambda control DNA) from fastq
## CITATION
If you use this tool, please consider citing our [publication](https://academic.oup.com/bioinformatics/article/39/5/btad311/7160911).
Copyright: 2016-2020 Wouter De Coster <decosterwouter@gmail.com>
Raw data
{
"_id": null,
"home_page": "https://github.com/wdecoster/NanoPlot",
"name": "NanoPlot",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3",
"maintainer_email": "",
"keywords": "nanopore sequencing plotting quality control",
"author": "Wouter De Coster",
"author_email": "decosterwouter@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/86/7a/ea5d9c5339570f71a46b378d30fa8544eb13b61b8433e9e052aabfab96f4/NanoPlot-1.42.0.tar.gz",
"platform": null,
"description": "# NanoPlot\nPlotting tool for long read sequencing data and alignments. \n\n[](https://twitter.com/wouter_decoster)\n[](https://anaconda.org/bioconda/nanoplot)\n[](https://travis-ci.org/wdecoster/NanoPlot)\n\n### NanoPlot is also available as a [web service](http://nanoplot.bioinf.be).\n\n\n\nThe example plot above shows a bivariate plot comparing log transformed read length with average basecall Phred quality score. More examples can be found in the [gallery on my blog 'Gigabase Or Gigabyte'.](https://gigabaseorgigabyte.wordpress.com/2017/06/01/example-gallery-of-nanoplot/)\n\nIn addition to various plots also a NanoStats file is created summarizing key features of the dataset.\n\nThis script performs data extraction from Oxford Nanopore sequencing data in the following formats: \n- fastq files \n(can be bgzip, bzip2 or gzip compressed) \n- fastq files generated by albacore, guppy or MinKNOW containing additional information \n(can be bgzip, bzip2 or gzip compressed) \n- sorted bam files \n- sequencing_summary.txt output table generated by albacore, guppy or MinKnow basecalling\n(can be gzip, bz2, zip and xz compressed)\n- fasta files\n(can be bgzip, bzip2 or gzip compressed) \nMultiple files of the same type can be offered simultaneously\n\n### INSTALLATION\n\n`pip install NanoPlot` \n\nUpgrade to a newer version using: \n`pip install NanoPlot --upgrade`\n\nor\n\n[](https://anaconda.org/bioconda/nanoplot) \n`conda install -c bioconda nanoplot`\n\nThe script is written for python3.\n\n### OUTPUT\nNanoPlot creates:\n- a statistical summary\n- a number of plots\n- a html summary file\n\n\n\n### USAGE\n```\nusage: NanoPlot [-h] [-v] [-t THREADS] [--verbose] [--store] [--raw] [--huge] [-o OUTDIR] [--no_static] [-p PREFIX] [--tsv_stats] [--info_in_report] [--maxlength N]\n [--minlength N] [--drop_outliers] [--downsample N] [--loglength] [--percentqual] [--alength] [--minqual N] [--runtime_until N] [--readtype {1D,2D,1D2}]\n [--barcoded] [--no_supplementary] [-c COLOR] [-cm COLORMAP] [-f [{png,jpg,jpeg,webp,svg,pdf,eps,json} ...]] [--plots [{kde,hex,dot} ...]]\n [--legacy [{kde,dot,hex} ...]] [--listcolors] [--listcolormaps] [--no-N50] [--N50] [--title TITLE] [--font_scale FONT_SCALE] [--dpi DPI] [--hide_stats]\n (--fastq file [file ...] | --fasta file [file ...] | --fastq_rich file [file ...] | --fastq_minimal file [file ...] | --summary file [file ...] | --bam file [file ...] | --ubam file [file ...] | --cram file [file ...] | --pickle pickle | --feather file [file ...])\n\nCREATES VARIOUS PLOTS FOR LONG READ SEQUENCING DATA.\n\nGeneral options:\n -h, --help show the help and exit\n -v, --version Print version and exit.\n -t, --threads THREADS\n Set the allowed number of threads to be used by the script\n --verbose Write log messages also to terminal.\n --store Store the extracted data in a pickle file for future plotting.\n --raw Store the extracted data in tab separated file.\n --huge Input data is one very large file.\n -o, --outdir OUTDIR Specify directory in which output has to be created.\n --no_static Do not make static (png) plots.\n -p, --prefix PREFIX Specify an optional prefix to be used for the output files.\n --tsv_stats Output the stats file as a properly formatted TSV.\n --info_in_report Add NanoPlot run info in the report.\n\nOptions for filtering or transforming input prior to plotting:\n --maxlength N Hide reads longer than length specified.\n --minlength N Hide reads shorter than length specified.\n --drop_outliers Drop outlier reads with extreme long length.\n --downsample N Reduce dataset to N reads by random sampling.\n --loglength Additionally show logarithmic scaling of lengths in plots.\n --percentqual Use qualities as theoretical percent identities.\n --alength Use aligned read lengths rather than sequenced length (bam mode)\n --minqual N Drop reads with an average quality lower than specified.\n --runtime_until N Only take the N first hours of a run\n --readtype {1D,2D,1D2}\n Which read type to extract information about from summary. Options are 1D, 2D,\n 1D2\n --barcoded Use if you want to split the summary file by barcode\n --no_supplementary Use if you want to remove supplementary alignments\n\nOptions for customizing the plots created:\n -c, --color COLOR Specify a valid matplotlib color for the plots\n -cm, --colormap COLORMAP\n Specify a valid matplotlib colormap for the heatmap\n -f, --format [{png,jpg,jpeg,webp,svg,pdf,eps,json} ...]\n Specify the output format of the plots, which are in addition to the html files\n --plots [{kde,hex,dot} ...]\n Specify which bivariate plots have to be made.\n --legacy [{kde,dot,hex} ...]\n Specify which bivariate plots have to be made (legacy mode).\n --listcolors List the colors which are available for plotting and exit.\n --listcolormaps List the colors which are available for plotting and exit.\n --no-N50 Hide the N50 mark in the read length histogram\n --N50 Show the N50 mark in the read length histogram\n --title TITLE Add a title to all plots, requires quoting if using spaces\n --font_scale FONT_SCALE\n Scale the font of the plots by a factor\n --dpi DPI Set the dpi for saving images\n --hide_stats Not adding Pearson R stats in some bivariate plots\n\nInput data sources, one of these is required.:\n --fastq file [file ...]\n Data is in one or more default fastq file(s).\n --fasta file [file ...]\n Data is in one or more fasta file(s).\n --fastq_rich file [file ...]\n Data is in one or more fastq file(s) generated by albacore, MinKNOW or guppy\n with additional information concerning channel and time.\n --fastq_minimal file [file ...]\n Data is in one or more fastq file(s) generated by albacore, MinKNOW or guppy\n with additional information concerning channel and time. Is extracted swiftly\n without elaborate checks.\n --summary file [file ...]\n Data is in one or more summary file(s) generated by albacore or guppy.\n --bam file [file ...]\n Data is in one or more sorted bam file(s).\n --ubam file [file ...]\n Data is in one or more unmapped bam file(s).\n --cram file [file ...]\n Data is in one or more sorted cram file(s).\n --pickle pickle Data is a pickle file stored earlier.\n --feather file [file ...]\n Data is in one or more feather file(s).\n\nEXAMPLES:\n NanoPlot --summary sequencing_summary.txt --loglength -o summary-plots-log-transformed\n NanoPlot -t 2 --fastq reads1.fastq.gz reads2.fastq.gz --maxlength 40000 --plots hex dot\n NanoPlot --color yellow --bam alignment1.bam alignment2.bam alignment3.bam --downsample 10000\n```\n\n### NOTES\n - `--downsample` won't save you tons of time, as down sampling is only done after collecting all data and probably would only make a difference for a huge amount of data. If you want to save time you could down sample your data upfront. Note also that extracting information from a summary file is faster than other formats, and that you can extract from multiple files simultaneously (which will happen in parallel then). Some plot types (especially kde) are slower than others and you can take a look at the input for `--plots` to speed things up (default is to make both kde and dot plot). If you are only interested in say the read length histogram it is possible to write a script to just get you that and avoid wasting time on the rest. Let me know if you need any help here.\n - `--plots` uses the plotly package to plot kde and dot plots. Hex option will be ignored.\n - `--legacy` plotting of a hex plot currently is only possible using this option,which uses the seaborn and matplotlib package, since there is no support for it in plotly (yet). Plots like kde and dot are also possible with this option.\n\n### EXAMPLE USAGE\n```bash\nNanoPlot --summary sequencing_summary.txt --loglength -o summary-plots-log-transformed \nNanoPlot -t 2 --fastq reads1.fastq.gz reads2.fastq.gz --maxlength 40000 --plots dot --legacy hex\nNanoPlot -t 12 --color yellow --bam alignment1.bam alignment2.bam alignment3.bam --downsample 10000 -o bamplots_downsampled\n```\n<!-- This script now also provides read length vs mean quality plots in the '[pauvre](https://github.com/conchoecia/pauvre)'-style from [@conchoecia](https://github.com/conchoecia). -->\n\n\n## ACKNOWLEDGMENTS/CONTRIBUTORS\n- [Ilias Bukraa](https://github.com/iliasbukraa) for tremendous improvements and maintenance of the code\n- Andreas Sj\u00f6din for building and maintaining conda recipes\n- Darrin Schultz [@conchoecia](https://github.com/conchoecia) for Pauvre code\n- [@alexomics](https://github.com/alexomics) for fixing the indentation of the printed stats\n- Botond Sipos [@bsipos](https://github.com/bsipos) for speeding up the calculation of average quality scores\n\n\n## CONTRIBUTING\nI welcome all suggestions, bug reports, feature requests and contributions. Please leave an [issue](https://github.com/wdecoster/NanoPlot/issues) or open a pull request. I will usually respond within a day, or rarely within a few days.\n\n## PLOTS GENERATED\nPlot|Fastq|Fastq_rich|Fastq_minimal|Bam|Summary|Options|Style\n----|----|----|----|----|----|----|----\nHistogram of read length|x|x|x|x|x|N50|\nHistogram of (log transformed) read length|x|x|x|x|x|N50|\nBivariate plot of length against base call quality|x|x||x|x|log transformation|dot, hex, kde\nHeatmap of reads per channel||x|||x||\nCumulative yield plot||x|x||x||\nViolin plot of read length over time||x|x||x||\nViolin plot of base call quality over time||x|||x||\nBivariate plot of aligned read length against sequenced read length||||x|||dot, hex, kde\nBivariate plot of percent reference identity against read length||||x||log transformation|dot, hex, kde\nBivariate plot of percent reference identity against base call quality||||x|||dot, hex, kde\nBivariate plot of mapping quality against read length||||x||log transformation|dot, hex, kde\nBivariate plot of mapping quality against basecall quality||||x|||dot, hex, kde\n\n\n## COMPANION SCRIPTS\n- [NanoComp](https://github.com/wdecoster/nanocomp): comparing multiple runs \n- [NanoStat](https://github.com/wdecoster/nanostat): statistic summary report of reads or alignments \n- [NanoFilt](https://github.com/wdecoster/nanofilt): filtering and trimming of reads \n- [NanoLyse](https://github.com/wdecoster/nanolyse): removing contaminant reads (e.g. lambda control DNA) from fastq\n\n\n## CITATION\nIf you use this tool, please consider citing our [publication](https://academic.oup.com/bioinformatics/article/39/5/btad311/7160911).\n\n\nCopyright: 2016-2020 Wouter De Coster <decosterwouter@gmail.com>\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Plotting suite for Oxford Nanopore sequencing data and alignments",
"version": "1.42.0",
"project_urls": {
"Homepage": "https://github.com/wdecoster/NanoPlot"
},
"split_keywords": [
"nanopore",
"sequencing",
"plotting",
"quality",
"control"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "867aea5d9c5339570f71a46b378d30fa8544eb13b61b8433e9e052aabfab96f4",
"md5": "4a5a3b96a7389c8e2a74f56bb3514bc8",
"sha256": "0f8fd2cffd33a346b3306716058c6cb4091c931e8ab502f10b17a28749e8b6d9"
},
"downloads": -1,
"filename": "NanoPlot-1.42.0.tar.gz",
"has_sig": false,
"md5_digest": "4a5a3b96a7389c8e2a74f56bb3514bc8",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3",
"size": 31712,
"upload_time": "2023-10-29T09:41:45",
"upload_time_iso_8601": "2023-10-29T09:41:45.012890Z",
"url": "https://files.pythonhosted.org/packages/86/7a/ea5d9c5339570f71a46b378d30fa8544eb13b61b8433e9e052aabfab96f4/NanoPlot-1.42.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-10-29 09:41:45",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "wdecoster",
"github_project": "NanoPlot",
"travis_ci": true,
"coveralls": false,
"github_actions": true,
"lcname": "nanoplot"
}
JSON
