diff --git a/CHANGELOG.md b/CHANGELOG.md index cf03aaf9..11c6e7fa 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -8,6 +8,7 @@ - Save ensembl_transcript_id and exon rank info on exons database records - Display MANE badges on gene overview report - `Create PDF` button on MANE overview and gene overview pages +- Documentation on how to create MANE overview reports ### Changed - Do not use stored cases/samples any more and run stats exclusively on d4 files paths provided by the user in real time - How parameters are passed to starlette.templating since it was raising a deprecation warning. diff --git a/README.md b/README.md index ed193159..45089550 100644 --- a/README.md +++ b/README.md @@ -9,7 +9,30 @@ Chanjo2 is coverage analysis tool for human clinical sequencing data using the [d4 (Dense Depth Data Dump) format][d4-article]. It's implemented in Python [FastAPI][fastapi] and provides API endpoints to communicate with a d4tools software in order to -return coverage and coverage completeness over genomic intervals (genes, transcripts, exons as well as custom intervals) over d4 files. +return reports containing coverage and coverage completeness over genomic intervals (genes, transcripts, exons as well as custom intervals) over d4 files. + +## Coverage and coverage overview reports + +Chanjo2 can be directly used to create the same types of report produced by [chanjo-report][chanjo-report] in conjunction with chanjo[chanjo]. +Follow the instructions present in the [documentation pages][github-docs] to learn how to use the report and the overview endpoints to create customised gene coverage report using this software. + +Examples of reports available with chanjo2: + +### Coverage report + +image + +### Genes coverage overview + +image + +### Mane coverage overview + +image + +### Gene overview + +image ## Run a software demo containing test data @@ -52,21 +75,6 @@ The response will return the number of genes inserted in the database: To find more information on how to set up a REST server running chanjo2 please visit the software's [documentation pages][github-docs]. Here you'll find also instructions on how to populate the database with custom cases and different genomic intervals. -## Coverage report and genes coverage overview - -Chanjo2 can be directly used to create the same types of report produced by [chanjo-report][chanjo-report] in conjunction with chanjo[chanjo]. - -Given a running demo instance of chanjo2, with gene genes and transcripts from genome build GRCh37 loaded in the database, an example of the coverage report based on PanelAPP gene panel described is provided by this demo report endpoint: http://0.0.0.0:8000/report/demo: - -image - -Similarly, an example report containing an overview of the genes with partial coverage at the given coverage thresholds is provided by the demo overview endpoint: - -image - -Follow the instructions present in the [documentation pages][github-docs] to learn how to use the report and the overview endpoints to create customised gene coverage report using this software. - - [actions-build-status]: https://github.com/Clinical-Genomics/chanjo2/actions/workflows/build_and_push_docker_stage.yml/badge.svg [black-image]: https://img.shields.io/badge/code%20style-black-000000.svg diff --git a/docs/usage/coverage-reports.md b/docs/usage/coverage-reports.md index 8fa72673..7c6c9bf5 100644 --- a/docs/usage/coverage-reports.md +++ b/docs/usage/coverage-reports.md @@ -67,6 +67,15 @@ A demo genes overview report based on genes transcripts from the demo PanelApp g To create a custom genes coverage overview report, send a **POST request to the `/overview` endpoint** containing the same request data described above for the `/report` endpoint. +# Creating coverage overview over MANE transcripts for a list of genes + +image + +This report contains statistics over all MANE Select and Mane Plus Clinical transcripts for a list of genes provided by the user. + +The **`/mane_overview` endpoint** accepts POST request with the same data described for the 2 reports above. + +Note that MANE overview reports are available only for analyses run with genome build GRCh38.