# Chanjo Report
Automatically generate basic coverage reports from Chanjo SQL databases. This plugin installs as a subcommand ("report") to the Chanjo command line interface.
## Usage
Chanjo Report supports a number of output formats: tabular, PDF, and HTML. To print a PDF coverage report for a group of samples "WGS-prep" do:
```bash
$ chanjo report --render pdf --group "WGS-prep" > ./coverage-report.pdf
```
## Features
### Supported output formats
Chanjo Reports multiple output formats:
- tabular: easily parsable and pipeable
- PDF: easily distributable (for humans)
- HTML: easily deliverable on the web
### Supported languages (translations)
The coverage report (HTML/PDF) can be render is the following languages:
- English
- Swedish
## Motivation
We are using the output from Chanjo at Clincal Genomics to report success of sequencing across the exome based on coverage. Our customers, clinicians mostly, are specifically interested in knowing to what degree their genes of interest are covered by sequencing along with some intuitive overall coverage metrics. They want the output in PDF format to file it in their system.
As a side effect of finding it easiest to convert HTML to PDF, Chanjo Report has a built in Flask server that can be used to render reports dynamically and even be plugged into other Flask servers as a Blueprint.
### Installation
The latest version of Chanjo-report can be installed by cloning and installing the repository from Clinical Genomics github:
```bash
$ git clone https://github.com/Clinical-Genomics/chanjo-report.git
$ cd chanjo-report
$ pip install --editable .
```
### Demo instance with Docker
To run a local demo with Docker, ensure you have a Docker engine running.
If you do not have Docker set up, we can recommend Docker Desktop (https://www.docker.com/products/docker-desktop/).
Then use `make` with the repository `Makefile` to build and run:
```bash
make build
make setup
make report
```
Point your browser to `http://127.0.0.1:5000` and find the demo samples.
#### Comprehensive instructions
We provide a Dockerfile to run the server in a container. To run a demo instance of the server with a pre-populated database consisting of a case with 3 samples, clone the repository using the following commands:
```bash
$ git clone https://github.com/Clinical-Genomics/chanjo-report.git
$ cd chanjo-report
```
Then you could make use of the services present in the Docker-compose file following these 3 steps:
1. Build the images
```bash
make build
```
2. Launch chanjo to create a populate the database with demo data
```bash
make setup
```
3. Launch the chanjo-report server
```bash
make report
```
A running instance of the server should now be available at the following url: http://localhost:5000/.
In order to generate a report containing all 3 demo samples, use the respective request args: http://localhost:5000/report?sample_id=sample1&sample_id=sample2&sample_id=sample3
Please be aware that if you are building and running the Dockerized version of chanjo-report, there might be **issues on `macOS` if your processor is Apple silicon** (or another `ARM64` based architecture).
In order to build the `chanjo-report` image in the `ARM64` architecture, you can set the environment variable `DOCKER_DEFAULT_PLATFORM`:
```bash
export DOCKER_DEFAULT_PLATFORM=linux/amd64
make build
make setup
make report
```
## License
MIT. See the [LICENSE](LICENSE) file for more details.
## Contributing
Anyone can help make this project better - read [CONTRIBUTING](CONTRIBUTING.md) to get started!
Raw data
{
"_id": null,
"home_page": "https://github.com/robinandeer/chanjo-report",
"name": "chanjo-report",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "chanjo-report development",
"author": "Robin Andeer",
"author_email": "robin.andeer@scilifelab.se",
"download_url": "https://files.pythonhosted.org/packages/ee/89/fc20713fffd1fdfc563027346e1e69a127ef3fdcb7dbf35ba9763732b351/chanjo-report-4.10.2.tar.gz",
"platform": null,
"description": "\n\n# Chanjo Report\nAutomatically generate basic coverage reports from Chanjo SQL databases. This plugin installs as a subcommand (\"report\") to the Chanjo command line interface.\n\n## Usage\nChanjo Report supports a number of output formats: tabular, PDF, and HTML. To print a PDF coverage report for a group of samples \"WGS-prep\" do:\n\n```bash\n$ chanjo report --render pdf --group \"WGS-prep\" > ./coverage-report.pdf\n```\n\n## Features\n\n### Supported output formats\nChanjo Reports multiple output formats:\n\n - tabular: easily parsable and pipeable\n - PDF: easily distributable (for humans)\n - HTML: easily deliverable on the web\n\n### Supported languages (translations)\nThe coverage report (HTML/PDF) can be render is the following languages:\n\n - English\n - Swedish\n\n\n## Motivation\nWe are using the output from Chanjo at Clincal Genomics to report success of sequencing across the exome based on coverage. Our customers, clinicians mostly, are specifically interested in knowing to what degree their genes of interest are covered by sequencing along with some intuitive overall coverage metrics. They want the output in PDF format to file it in their system.\n\nAs a side effect of finding it easiest to convert HTML to PDF, Chanjo Report has a built in Flask server that can be used to render reports dynamically and even be plugged into other Flask servers as a Blueprint.\n\n\n### Installation\n\nThe latest version of Chanjo-report can be installed by cloning and installing the repository from Clinical Genomics github:\n\n```bash\n$ git clone https://github.com/Clinical-Genomics/chanjo-report.git\n$ cd chanjo-report\n$ pip install --editable .\n```\n\n### Demo instance with Docker\n\nTo run a local demo with Docker, ensure you have a Docker engine running.\nIf you do not have Docker set up, we can recommend Docker Desktop (https://www.docker.com/products/docker-desktop/).\n\nThen use `make` with the repository `Makefile` to build and run:\n\n```bash\nmake build\nmake setup\nmake report\n```\n\nPoint your browser to `http://127.0.0.1:5000` and find the demo samples.\n\n#### Comprehensive instructions\n\nWe provide a Dockerfile to run the server in a container. To run a demo instance of the server with a pre-populated database consisting of a case with 3 samples, clone the repository using the following commands:\n\n ```bash\n $ git clone https://github.com/Clinical-Genomics/chanjo-report.git\n $ cd chanjo-report\n ```\n\nThen you could make use of the services present in the Docker-compose file following these 3 steps:\n\n1. Build the images\n\n ```bash\n make build\n ```\n\n2. Launch chanjo to create a populate the database with demo data\n\n ```bash\n make setup\n ```\n\n3. Launch the chanjo-report server\n\n ```bash\n make report\n ```\n\nA running instance of the server should now be available at the following url: http://localhost:5000/.\n\nIn order to generate a report containing all 3 demo samples, use the respective request args: http://localhost:5000/report?sample_id=sample1&sample_id=sample2&sample_id=sample3\n\nPlease be aware that if you are building and running the Dockerized version of chanjo-report, there might be **issues on `macOS` if your processor is Apple silicon** (or another `ARM64` based architecture).\nIn order to build the `chanjo-report` image in the `ARM64` architecture, you can set the environment variable `DOCKER_DEFAULT_PLATFORM`:\n\n ```bash\n export DOCKER_DEFAULT_PLATFORM=linux/amd64\nmake build\nmake setup\nmake report\n```\n\n## License\nMIT. See the [LICENSE](LICENSE) file for more details.\n\n\n## Contributing\nAnyone can help make this project better - read [CONTRIBUTING](CONTRIBUTING.md) to get started!\n\n\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Automatically render coverage reports from Chanjo ouput",
"version": "4.10.2",
"project_urls": {
"Homepage": "https://github.com/robinandeer/chanjo-report"
},
"split_keywords": [
"chanjo-report",
"development"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "aa3c09858750f97177d74fa8e9d3eb1d310928764941935ab81db9631d795ef6",
"md5": "d1a517c918a8ff3c6acdf175f4e035d4",
"sha256": "bfa58160326c86e43210a3e56f48aa8c1c7760ae286d3900b141e85846de8d97"
},
"downloads": -1,
"filename": "chanjo_report-4.10.2-py2.py3-none-any.whl",
"has_sig": false,
"md5_digest": "d1a517c918a8ff3c6acdf175f4e035d4",
"packagetype": "bdist_wheel",
"python_version": "py2.py3",
"requires_python": null,
"size": 26451,
"upload_time": "2023-08-21T06:24:50",
"upload_time_iso_8601": "2023-08-21T06:24:50.618397Z",
"url": "https://files.pythonhosted.org/packages/aa/3c/09858750f97177d74fa8e9d3eb1d310928764941935ab81db9631d795ef6/chanjo_report-4.10.2-py2.py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "ee89fc20713fffd1fdfc563027346e1e69a127ef3fdcb7dbf35ba9763732b351",
"md5": "6b4513daf6bff7b347640d676b35f5b9",
"sha256": "7c446aa046173b3ff19d1f93702d0b600bd154de3509dd74d70e12b71f4ac544"
},
"downloads": -1,
"filename": "chanjo-report-4.10.2.tar.gz",
"has_sig": false,
"md5_digest": "6b4513daf6bff7b347640d676b35f5b9",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 27074,
"upload_time": "2023-08-21T06:24:52",
"upload_time_iso_8601": "2023-08-21T06:24:52.230735Z",
"url": "https://files.pythonhosted.org/packages/ee/89/fc20713fffd1fdfc563027346e1e69a127ef3fdcb7dbf35ba9763732b351/chanjo-report-4.10.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-08-21 06:24:52",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "robinandeer",
"github_project": "chanjo-report",
"travis_ci": true,
"coveralls": false,
"github_actions": false,
"requirements": [],
"lcname": "chanjo-report"
}
JSON
