# MicroView
<!-- badges: start -->
[![license](https://img.shields.io/badge/license-BSD%203--Clause-green)](https://github.com/dalmolingroup/microview/blob/master/LICENSE)
[![pytest status](https://github.com/dalmolingroup/microview/workflows/test-and-lint/badge.svg)](https://github.com/dalmolingroup/microview/actions)
[![Documentation Status](https://readthedocs.org/projects/microview-bio/badge/?version=latest)](https://microview-bio.readthedocs.io/en/latest/?badge=latest)
<!-- badges: end -->
MicroView, a reporting tool for taxonomic classification
MicroView agreggates results from taxonomic classification tools,
such as Kaiju and Kraken, building an interactive HTML report with
insightful visualizations.
Checkout the [full documentation](https://microview-bio.readthedocs.io/en/latest/?badge=latest).
## Quickstart
Install the package:
```sh
pip install microview
```
Go to your directory containing Kaiju/Kraken-style results and run:
```sh
microview -t .
```
Alternatively, if you have a CSV table defining result paths and contrasts, like this:
```
sample,group
result_1.tsv,group_one
result_2.tsv,group_two
...etc...
```
You can run MicroView like this:
```sh
microview -df contrast_table.csv -o report_with_table.html
```
Then, an HTML file named `microview_report.html` -
or the name you defined with the `-o` param -
should be available in your working directory,
try opening it with your browser!
Raw data
{
"_id": null,
"home_page": "https://github.com/jvfe/microview",
"name": "MicroView",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "metagenomics workflow visualization report",
"author": "Jo\u00e3o Vitor F. Cavalcante",
"author_email": "jvfe@ufrn.edu.br",
"download_url": "https://files.pythonhosted.org/packages/99/82/12c3e238040fd4f1dcff49fa7d83105a22e089fdfbf38c908512dfb89671/MicroView-0.10.1.tar.gz",
"platform": null,
"description": "# MicroView\n\n<!-- badges: start -->\n\n[![license](https://img.shields.io/badge/license-BSD%203--Clause-green)](https://github.com/dalmolingroup/microview/blob/master/LICENSE)\n[![pytest status](https://github.com/dalmolingroup/microview/workflows/test-and-lint/badge.svg)](https://github.com/dalmolingroup/microview/actions)\n[![Documentation Status](https://readthedocs.org/projects/microview-bio/badge/?version=latest)](https://microview-bio.readthedocs.io/en/latest/?badge=latest)\n\n<!-- badges: end -->\n\nMicroView, a reporting tool for taxonomic classification\n\nMicroView agreggates results from taxonomic classification tools,\nsuch as Kaiju and Kraken, building an interactive HTML report with\ninsightful visualizations.\n\nCheckout the [full documentation](https://microview-bio.readthedocs.io/en/latest/?badge=latest).\n\n## Quickstart\n\nInstall the package:\n\n```sh\npip install microview\n```\n\nGo to your directory containing Kaiju/Kraken-style results and run:\n\n```sh\nmicroview -t .\n```\n\nAlternatively, if you have a CSV table defining result paths and contrasts, like this:\n\n```\nsample,group\nresult_1.tsv,group_one\nresult_2.tsv,group_two\n...etc...\n```\n\nYou can run MicroView like this:\n\n```sh\nmicroview -df contrast_table.csv -o report_with_table.html\n```\n\nThen, an HTML file named `microview_report.html` -\nor the name you defined with the `-o` param -\nshould be available in your working directory,\ntry opening it with your browser!\n",
"bugtrack_url": null,
"license": "BSD license",
"summary": "Generate reports from metagenomics data",
"version": "0.10.1",
"project_urls": {
"Bug Tracker": "https://github.com/jvfe/microview/issues",
"Documentation": "https://jvfe.github.io/microview/",
"Homepage": "https://github.com/jvfe/microview",
"Source Code": "https://github.com/jvfe/microview"
},
"split_keywords": [
"metagenomics",
"workflow",
"visualization",
"report"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "921d39ef8d811f51071f7e76e5dc740fb69b31e5c1c70f86a55a3a58330cd49d",
"md5": "c09ecdb938621ec4ddc2fe5472d08722",
"sha256": "b8721750b8abea23e643bb937a786d202653c5c1ba1fcc6ac49f6de6a2b09b9f"
},
"downloads": -1,
"filename": "MicroView-0.10.1-py2.py3-none-any.whl",
"has_sig": false,
"md5_digest": "c09ecdb938621ec4ddc2fe5472d08722",
"packagetype": "bdist_wheel",
"python_version": "py2.py3",
"requires_python": ">=3.8",
"size": 1151932,
"upload_time": "2024-04-08T17:02:37",
"upload_time_iso_8601": "2024-04-08T17:02:37.986106Z",
"url": "https://files.pythonhosted.org/packages/92/1d/39ef8d811f51071f7e76e5dc740fb69b31e5c1c70f86a55a3a58330cd49d/MicroView-0.10.1-py2.py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "998212c3e238040fd4f1dcff49fa7d83105a22e089fdfbf38c908512dfb89671",
"md5": "727622a108de6bdb5ac814eb3748630f",
"sha256": "c031b0c9405a2eae175d98835f4bd4ada63e0d23128b278ab146b0d3a844036a"
},
"downloads": -1,
"filename": "MicroView-0.10.1.tar.gz",
"has_sig": false,
"md5_digest": "727622a108de6bdb5ac814eb3748630f",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 1145598,
"upload_time": "2024-04-08T17:02:41",
"upload_time_iso_8601": "2024-04-08T17:02:41.823152Z",
"url": "https://files.pythonhosted.org/packages/99/82/12c3e238040fd4f1dcff49fa7d83105a22e089fdfbf38c908512dfb89671/MicroView-0.10.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-04-08 17:02:41",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "jvfe",
"github_project": "microview",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "microview"
}