From 14c792a8a92582751e88e5ac68339bf509c7cad9 Mon Sep 17 00:00:00 2001 From: Sigve Nakken Date: Wed, 30 Jun 2021 13:23:24 +0200 Subject: [PATCH] 0.9.2 release --- .appveyor.yml | 43 - README.md | 307 +++-- docs/CHANGELOG.md | 64 + docs/CHANGELOG.rst | 151 ++- docs/_build/doctrees/CHANGELOG.doctree | Bin 172686 -> 203191 bytes docs/_build/doctrees/about.doctree | Bin 18754 -> 18740 bytes .../doctrees/annotation_resources.doctree | Bin 47181 -> 47133 bytes docs/_build/doctrees/environment.pickle | Bin 54296 -> 56465 bytes docs/_build/doctrees/getting_started.doctree | Bin 59361 -> 74124 bytes docs/_build/doctrees/input.doctree | Bin 20984 -> 14952 bytes docs/_build/doctrees/output.doctree | Bin 189186 -> 188179 bytes docs/_build/html/.buildinfo | 2 +- docs/_build/html/CHANGELOG.html | 274 ++-- docs/_build/html/_sources/CHANGELOG.rst.txt | 151 ++- docs/_build/html/_sources/about.rst.txt | 10 +- .../_sources/annotation_resources.rst.txt | 31 +- .../html/_sources/getting_started.rst.txt | 298 +++-- docs/_build/html/_sources/input.rst.txt | 94 +- docs/_build/html/_sources/output.rst.txt | 383 +++--- docs/_build/html/_static/pygments.css | 10 +- docs/_build/html/about.html | 16 +- docs/_build/html/annotation_resources.html | 37 +- docs/_build/html/genindex.html | 6 +- docs/_build/html/getting_started.html | 307 +++-- docs/_build/html/index.html | 9 +- docs/_build/html/input.html | 99 +- docs/_build/html/objects.inv | Bin 567 -> 579 bytes docs/_build/html/output.html | 195 ++- docs/_build/html/search.html | 6 +- docs/_build/html/searchindex.js | 2 +- docs/_build/html/tier_systems.html | 6 +- docs/about.md | 10 +- docs/about.rst | 10 +- docs/annotation_resources.md | 24 +- docs/annotation_resources.rst | 31 +- docs/conf.py | 6 +- docs/getting_started.md | 242 ++-- docs/getting_started.rst | 298 +++-- docs/input.md | 82 +- docs/input.rst | 94 +- docs/output.md | 197 ++- docs/output.rst | 383 +++--- docs/pcgr_docs.tar.gz | Bin 0 -> 16255688 bytes install_no_docker/README.md | 4 +- install_no_docker/conda_pkg/pcgr/build.sh | 2 +- install_no_docker/conda_pkg/pcgr/meta.yaml | 138 +- .../conda_pkg/pcgr_dockerized/meta.yaml | 2 - pcgr.py | 1126 ++++++++++------- src/.Rhistory | 0 src/Dockerfile | 81 +- src/NearestExonJB.pm | 143 +++ src/R/assertable_0.2.7.tar.gz | Bin 38258 -> 0 bytes src/R/assertable_0.2.8.tar.gz | Bin 0 -> 38314 bytes src/R/pcgrr/.Rprofile | 1 - src/R/pcgrr/DESCRIPTION | 32 +- src/R/pcgrr/NAMESPACE | 8 +- src/R/pcgrr/R/biomarkers.R | 25 +- src/R/pcgrr/R/clinicaltrials.R | 82 +- src/R/pcgrr/R/cna.R | 22 +- src/R/pcgrr/R/cpsr.R | 781 ++++++++---- src/R/pcgrr/R/germline.R | 3 +- src/R/pcgrr/R/kataegis.R | 15 +- src/R/pcgrr/R/main.R | 1002 +++++++++------ src/R/pcgrr/R/msi.R | 21 +- src/R/pcgrr/R/mutational_burden.R | 29 +- src/R/pcgrr/R/mutational_signatures.R | 478 ++++--- src/R/pcgrr/R/report.R | 212 +++- src/R/pcgrr/R/utils.R | 413 ++++-- src/R/pcgrr/R/value_boxes.R | 76 +- .../data-raw/effect_prediction_algorithms.tsv | 2 + src/R/pcgrr/data/cancer_phenotypes_regex.rda | Bin 594 -> 594 bytes src/R/pcgrr/data/color_palette.rda | Bin 647 -> 647 bytes src/R/pcgrr/data/cpsr_acmg.rda | Bin 2250 -> 2246 bytes src/R/pcgrr/data/effect_prediction_algos.rda | Bin 953 -> 1005 bytes src/R/pcgrr/data/heterozygous_states.rda | Bin 915 -> 901 bytes src/R/pcgrr/data/homozygous_states.rda | Bin 155 -> 156 bytes src/R/pcgrr/data/variant_db_url.rda | Bin 528 -> 527 bytes src/R/pcgrr/inst/templates/cpsr.css | 27 +- .../cpsr_rmarkdown/cpsr_biomarkers.Rmd | 2 +- .../cpsr_rmarkdown/cpsr_documentation.Rmd | 2 +- .../templates/cpsr_rmarkdown/cpsr_gwas.Rmd | 13 +- .../cpsr_secondary_findings.Rmd | 8 +- .../cpsr_rmarkdown/cpsr_settings.Rmd | 12 +- .../templates/cpsr_rmarkdown/cpsr_summary.Rmd | 11 + .../templates/cpsr_rmarkdown/cpsr_tiers.Rmd | 174 ++- .../cpsr_rmarkdown/cpsr_virtual_panel.Rmd | 1 + .../inst/templates/cpsr_rmarkdown_report.Rmd | 21 +- .../cpsr_rmarkdown_report_working.Rmd | 94 ++ .../pcgr_flexdb/flexdb_clinicaltrials.Rmd | 3 +- .../templates/pcgr_flexdb/flexdb_cpsr.Rmd | 391 ++++++ .../pcgr_flexdb/flexdb_documentation.Rmd | 29 +- .../pcgr_flexdb/flexdb_mutsignatures.Rmd | 6 +- .../templates/pcgr_flexdb/flexdb_scna.Rmd | 7 +- .../pcgr_flexdb/flexdb_scna_oncogene.Rmd | 19 +- .../pcgr_flexdb/flexdb_scna_other.Rmd | 4 +- .../pcgr_flexdb/flexdb_scna_tier1.Rmd | 4 +- .../pcgr_flexdb/flexdb_scna_tier2.Rmd | 22 +- .../pcgr_flexdb/flexdb_scna_tsgene.Rmd | 19 +- .../pcgr_flexdb/flexdb_snv_biomarker.Rmd | 4 +- .../pcgr_flexdb/flexdb_snv_noncoding.Rmd | 47 +- .../pcgr_flexdb/flexdb_snv_overview.Rmd | 35 +- .../pcgr_flexdb/flexdb_snv_tier1.Rmd | 4 +- .../pcgr_flexdb/flexdb_snv_tier2.Rmd | 4 +- .../pcgr_flexdb/flexdb_snv_tier3.Rmd | 62 +- .../pcgr_flexdb/flexdb_snv_tier4.Rmd | 46 +- .../inst/templates/pcgr_flexdb/flexdb_tmb.Rmd | 19 +- .../inst/templates/pcgr_flexdb_report.Rmd | 8 + .../templates/pcgr_flexdb_tumor_control.css | 109 ++ .../pcgr_rmarkdown/clinicaltrials.Rmd | 1 + .../templates/pcgr_rmarkdown/cna_segments.Rmd | 4 - .../pcgr_rmarkdown/cpsr_main_findings.Rmd | 285 +++++ .../pcgr_rmarkdown/documentation.Rmd | 30 +- .../pcgr_rmarkdown/global_table_browse.Rmd | 10 +- .../pcgr_rmarkdown/mutational_signature.Rmd | 30 - .../mutational_signature_mp.Rmd | 18 +- .../pcgr_rmarkdown/report_query_settings.Rmd | 5 +- .../templates/pcgr_rmarkdown/value_boxes.Rmd | 53 +- .../pcgr_rmarkdown/value_boxes_old.Rmd | 7 + .../pcgr_rmarkdown/value_boxes_tumor_only.Rmd | 52 + .../inst/templates/pcgr_rmarkdown_report.Rmd | 25 +- .../pcgr_rmarkdown_tumor_control.css | 140 ++ .../templates/pcgr_rmarkdown_tumor_only.css | 28 + src/R/pcgrr/man/generate_pcgr_report.Rd | 20 +- src/R/pcgrr/man/init_report.Rd | 4 +- .../signature_contributions_single_sample.Rd | 47 - src/R/pcgrr/man/write_report_output.Rd | 11 +- src/R/pcgrr/renv.lock | 793 ++++++------ src/R/pcgrr/rlogging.log | 524 -------- src/R/pcgrr/tests/test.Rmd | 35 +- src/R/pcgrr/tests/test.css | 80 +- src/R/pcgrr/tests/test.html | 378 +----- src/R/pcgrr_0.9.1.tar.gz | Bin 421305 -> 0 bytes src/R/pcgrr_0.9.2.tar.gz | Bin 0 -> 420869 bytes src/cpsr.R | 141 ++- src/loftee.tgz | Bin 1609730 -> 0 bytes src/pcgr.R | 339 +++-- src/pcgr.tgz | Bin 26896 -> 26605 bytes src/pcgr/cpsr_validate_input.py | 241 ++-- src/pcgr/lib/annoutils.py | 324 ++--- src/pcgr/pcgr.code-workspace | 7 + src/pcgr/pcgr_summarise.py | 98 +- src/pcgr/pcgr_validate_input.py | 239 +++- src/pcgr/pcgr_vcfanno.py | 98 +- src/pcgr/vcf2tsv.py | 2 +- 144 files changed, 8168 insertions(+), 5684 deletions(-) delete mode 100644 .appveyor.yml create mode 100644 docs/pcgr_docs.tar.gz delete mode 100644 src/.Rhistory create mode 100644 src/NearestExonJB.pm delete mode 100644 src/R/assertable_0.2.7.tar.gz create mode 100644 src/R/assertable_0.2.8.tar.gz delete mode 100644 src/R/pcgrr/.Rprofile create mode 100644 src/R/pcgrr/inst/templates/cpsr_rmarkdown_report_working.Rmd create mode 100755 src/R/pcgrr/inst/templates/pcgr_flexdb/flexdb_cpsr.Rmd create mode 100644 src/R/pcgrr/inst/templates/pcgr_rmarkdown/cpsr_main_findings.Rmd delete mode 100644 src/R/pcgrr/inst/templates/pcgr_rmarkdown/mutational_signature.Rmd create mode 100644 src/R/pcgrr/inst/templates/pcgr_rmarkdown/value_boxes_old.Rmd create mode 100644 src/R/pcgrr/inst/templates/pcgr_rmarkdown/value_boxes_tumor_only.Rmd create mode 100644 src/R/pcgrr/inst/templates/pcgr_rmarkdown_tumor_control.css create mode 100644 src/R/pcgrr/inst/templates/pcgr_rmarkdown_tumor_only.css delete mode 100644 src/R/pcgrr/man/signature_contributions_single_sample.Rd delete mode 100644 src/R/pcgrr/rlogging.log delete mode 100644 src/R/pcgrr_0.9.1.tar.gz create mode 100644 src/R/pcgrr_0.9.2.tar.gz delete mode 100755 src/loftee.tgz create mode 100644 src/pcgr/pcgr.code-workspace diff --git a/.appveyor.yml b/.appveyor.yml deleted file mode 100644 index 76438821..00000000 --- a/.appveyor.yml +++ /dev/null @@ -1,43 +0,0 @@ -image: ubuntu - -services: - - docker - -install: - # Pulling the image - - sudo service docker start - - docker pull sigven/pcgr:dev - # Installing wrapper script dependencies - - wget -nv https://repo.continuum.io/miniconda/Miniconda3-latest-Linux-x86_64.sh -O miniconda.sh - - bash miniconda.sh -b -p $HOME/miniconda - - export PATH=$HOME/miniconda/bin:$PATH - - conda install -y -c conda-forge -c pcgr toml gdown - # Downloading datab bundle - commenting out because getting "not enough disk space" - # - gdown https://drive.google.com/uc?id=1OL5C994HDaeadASz7KzMhPoXfdSiyhNy -O - | tar xzf - # grch37 - -test_script: - - python pcgr.py --version - # Full test - commenting out because getting "not enough disk space" at gdown step - # - python pcgr.py --input_vcf examples/tumor_sample.COAD.vcf.gz --input_cna examples/tumor_sample.COAD.cna.tsv . ./examples grch37 examples/pcgr_conf.COAD.toml tumor_sample.COAD - -build: off - -# TODO: build and push docker from here - see https://stefanscherer.github.io/setup-windows-docker-ci-appveyor/ -#environment: -# DOCKER_USER: -# secure: xxxxxxx -# DOCKER_PASS: -# secure: yyyyyyy -# -#install: -# - docker version -# -#build_script: -# - docker build -t me/myfavoriteapp . -# -#test_script: -# - docker run me/myfavoriteapp -# -#deploy_script: -# - docker login -u="$env:DOCKER_USER" -p="$env:DOCKER_PASS" -# - docker push me/myfavoriteapp diff --git a/README.md b/README.md index 445b02f9..5ff12ac0 100755 --- a/README.md +++ b/README.md @@ -6,14 +6,14 @@ - [News](#news) - [Example reports](#example-reports) - [PCGR Documentation](#documentation) -- [Annotation resources](#annotation-resources-included-in-pcgr---091) +- [Annotation resources](#annotation-resources-included-in-pcgr---092) - [Getting started](#getting-started) - [FAQ](#faq) - [Contact](#contact) ### Overview -The Personal Cancer Genome Reporter (PCGR) is a stand-alone software package for functional annotation and translation of individual cancer genomes for precision cancer medicine. Currently, it interprets both somatic SNVs/InDels and copy number aberrations. The software extends basic gene and variant annotations from the [Ensembl’s Variant Effect Predictor (VEP)](http://www.ensembl.org/info/docs/tools/vep/index.html) with oncology-relevant, up-to-date annotations retrieved flexibly through [vcfanno](https://github.com/brentp/vcfanno), and produces interactive HTML reports intended for clinical interpretation. __NOTE__: If you also want to interrogate the clinical impact of germline variants in the same individual, try the accompanying tool [Cancer Predisposition Sequencing Reporter (CPSR)](https://github.com/sigven/cpsr). +The Personal Cancer Genome Reporter (PCGR) is a stand-alone software package for functional annotation and translation of individual cancer genomes for precision cancer medicine. Currently, it interprets both somatic SNVs/InDels and copy number aberrations. The software extends basic gene and variant annotations from the [Ensembl’s Variant Effect Predictor (VEP)](http://www.ensembl.org/info/docs/tools/vep/index.html) with oncology-relevant, up-to-date annotations retrieved flexibly through [vcfanno](https://github.com/brentp/vcfanno), and produces interactive HTML reports intended for clinical interpretation. __NOTE__: If you want to generate a personal report with respect to cancer predisposition for germline variants, try the accompanying tool [Cancer Predisposition Sequencing Reporter (CPSR)](https://github.com/sigven/cpsr). A few screenshots of the dashboard-type HTML output (new in 0.9.0) is shown below. @@ -21,45 +21,20 @@ A few screenshots of the dashboard-type HTML output (new in 0.9.0) is shown belo ![PCGR overview](pcgr_dashboard_views.png) ### News +* _June 30th 2021_: **0.9.2 release** + * Data bundle updates (CIViC, ClinVar, CancerMine, UniProt KB, PFAM) + * Software upgrades: VEP (104), R v4.1/BioConductor 3.13 + * **NEW**: TOML configuration removed - all options to PCGR are now command-line based + * **NEW**: Feed PCGR with a [CPSR report](https://github.com/sigven/cpsr) to view key germline findings in the tumor report + * [CHANGELOG](http://pcgr.readthedocs.io/en/latest/CHANGELOG.html) + * Planned for next release: Support for analysis of RNA fusions * _November 30th 2020_: **0.9.1 release** * Data bundle updates (CIViC, ClinVar, CancerMine, UniProt KB) * [CHANGELOG](http://pcgr.readthedocs.io/en/latest/CHANGELOG.html) -* _Sep 24th 2020_: **0.9.0rc release** - * Major data bundle updates (CIViC, ClinVar, CancerMine, UniProt KB, Open Targets Platform, Pfam, DisGeNET, GENCODE) - * VEP v101 - * _New_: report type output - [flexdashboard](https://rmarkdown.rstudio.com/flexdashboard/) HTML - * _New_: detection of kataegis events - * _New_: improved distinction between exact and regional biomarkers in tables - * _New_: addition of other drug targets in copy number view - * _New_: Inclusion of annotated molecularly targeted clinical trials (beta) - * _Changed_: estimation of mutational signatures - using [MutationalPatterns](https://github.com/UMCUGenetics/MutationalPatterns) with the [n = 67 reference collection (COSMIC v3)](https://cancer.sanger.ac.uk/cosmic/signatures) - * _Changed_: a number of options in the configuration file is now arguments for the main Python script - * __NOTE__: Non-Dockerized version (Conda-based) is in the making - * see [CHANGELOG](http://pcgr.readthedocs.io/en/latest/CHANGELOG.html) -* _Nov 18th 2019_: **0.8.4 release** - * Data bundle updates (CIViC, ClinVar, CancerMine, UniProt) - * Software updates: VEP 98.3 -* _Oct 14th 2019_: **0.8.3 release** - * Software updates (VEP 98.2) - * Data bundle updates (CIViC, ClinVar, CancerMine) - * Bug fixing, see [CHANGELOG](http://pcgr.readthedocs.io/en/latest/CHANGELOG.html#oct-14th-2019) -* _Sep 29th 2019_: **0.8.2 release** - * Software updates (VEP 97.3, vcfanno 0.3.2) - * Data bundle updates (CIViC, CancerMine, Open Targets Platform, UniProt KB, GENCODE, ClinVar) - * [CHANGELOG](http://pcgr.readthedocs.io/en/latest/CHANGELOG.html#sep-29th-2019) - * Accompanying release of the [Cancer Predisposition Sequencing Reporter](https://github.com/sigven/cpsr) - ### Example reports -[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.4050895.svg)](https://doi.org/10.5281/zenodo.4050895) - - +[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.5045309.svg)](https://doi.org/10.5281/zenodo.5045309) ### PCGR documentation @@ -70,32 +45,29 @@ A few screenshots of the dashboard-type HTML output (new in 0.9.0) is shown belo Sigve Nakken, Ghislain Fournous, Daniel Vodák, Lars Birger Aaasheim, Ola Myklebost, and Eivind Hovig. __Personal Cancer Genome Reporter: variant interpretation report for precision oncology__ (2017). _Bioinformatics_. 34(10):1778–1780. doi:[10.1093/bioinformatics/btx817](https://doi.org/10.1093/bioinformatics/btx817) -### Annotation resources included in PCGR - 0.9.1 +### Annotation resources included in PCGR - 0.9.2 -* [VEP](http://www.ensembl.org/info/docs/tools/vep/index.html) - Variant Effect Predictor v101 (GENCODE v35/v19 as the gene reference dataset) -* [CIViC](http://civic.genome.wustl.edu) - Clinical interpretations of variants in cancer (November 18th 2020) -* [ClinVar](http://www.ncbi.nlm.nih.gov/clinvar/) - Database of variants with clinical significance (November 2020) +* [VEP](http://www.ensembl.org/info/docs/tools/vep/index.html) - Variant Effect Predictor v104 (GENCODE v38/v19 as the gene reference dataset) +* [CIViC](http://civic.genome.wustl.edu) - Clinical interpretations of variants in cancer (June 15th 2021) +* [ClinVar](http://www.ncbi.nlm.nih.gov/clinvar/) - Database of variants with clinical significance (June 2021) * [DoCM](http://docm.genome.wustl.edu) - Database of curated mutations (v3.2, Apr 2016) * [CGI](http://www.cancergenomeinterpreter.org/biomarkers) - Cancer Biomarkers database (Jan 17th 2018) * [Cancer Hotspots](http://cancerhotspots.org) - Resource for statistically significant mutations in cancer (v2 - 2017) -* [dBNSFP](https://sites.google.com/site/jpopgen/dbNSFP) - Database of non-synonymous functional predictions (v4.1, June 2020) -* [TCGA](https://portal.gdc.cancer.gov/) - somatic mutations discovered across 33 tumor type cohorts (The Cancer Genome Atlas (TCGA), release 25, July 2020) +* [dBNSFP](https://sites.google.com/site/jpopgen/dbNSFP) - Database of non-synonymous functional predictions (v4.2, March 2021) +* [TCGA](https://portal.gdc.cancer.gov/) - somatic mutations discovered across 33 tumor type cohorts (The Cancer Genome Atlas (TCGA), release 29, March 2021) * [CHASMplus](https://karchinlab.github.io/CHASMplus/) - predicted driver mutations across 33 tumor type cohorts in TCGA -* [UniProt/SwissProt KnowledgeBase](http://www.uniprot.org) - Resource on protein sequence and functional information (2020_05, October 2020) -* [Pfam](http://pfam.xfam.org) - Database of protein families and domains (v33, May 2020) -* [Open Targets Platform](https://targetvalidation.org) - Target-disease and target-drug associations (2020_09, September 2020) -* [ChEMBL](https://www.ebi.ac.uk/chembl/) - Manually curated database of bioactive molecules (v27, May 2020) -* [CancerMine](https://zenodo.org/record/4270451#.X7t43qpKiHE) - Literature-mined database of tumor suppressor genes/proto-oncogenes (v30, November 2020) +* [UniProt/SwissProt KnowledgeBase](http://www.uniprot.org) - Resource on protein sequence and functional information (2021_03, June 2021) +* [Pfam](http://pfam.xfam.org) - Database of protein families and domains (v34, March 2021) +* [Open Targets Platform](https://targetvalidation.org) - Target-disease and target-drug associations (2021_04, April 2021) +* [ChEMBL](https://www.ebi.ac.uk/chembl/) - Manually curated database of bioactive molecules (v28, February 2021) +* [CancerMine](https://zenodo.org/record/4270451#.X7t43qpKiHE) - Literature-mined database of tumor suppressor genes/proto-oncogenes (v36, June 2021) ### Getting started #### STEP 0: Python -An installation of Python (version _3.6_) is required to run PCGR. Check that Python is installed by typing `python --version` in your terminal window. In addition, a [Python library](https://github.com/uiri/toml) for parsing configuration files encoded with [TOML](https://github.com/toml-lang/toml) is needed. To install, simply run the following command: - - pip install toml - +An installation of Python (version _3.6_) is required to run PCGR. Check that Python is installed by typing `python --version` in your terminal window. **IMPORTANT NOTE**: STEP 1 & 2 below outline installation guidelines for running PCGR with Docker. If you want to install and run PCGR without the use of Docker (i.e. through Conda), follow [these instructions](https://github.com/sigven/pcgr/blob/master/install_no_docker/README.md) @@ -115,32 +87,34 @@ An installation of Python (version _3.6_) is required to run PCGR. Check that Py #### STEP 2: Download PCGR and data bundle +##### Latest release + +a. Download and unpack the [latest software release (0.9.2)](https://github.com/sigven/pcgr/releases/tag/v0.9.2) + +b. Download and unpack the assembly-specific data bundle in the PCGR directory + * [grch37 data bundle - 20210627](http://insilico.hpc.uio.no/pcgr/pcgr.databundle.grch37.20210627.tgz) (approx 20Gb) + * [grch38 data bundle - 20210627](http://insilico.hpc.uio.no/pcgr/pcgr.databundle.grch38.20210627.tgz) (approx 21Gb) + * *Unpacking*: `gzip -dc pcgr.databundle.grch37.YYYYMMDD.tgz | tar xvf -` + + A _data/_ folder within the _pcgr-X.X_ software folder should now have been produced + +c. Pull the [PCGR Docker image (0.9.2)](https://hub.docker.com/r/sigven/pcgr/) from DockerHub (approx 5.0Gb): + * `docker pull sigven/pcgr:0.9.2` (PCGR annotation engine) + + ##### Development version a. Clone the PCGR GitHub repository (includes run script and default configuration file): `git clone https://github.com/sigven/pcgr.git` b. Download and unpack the latest data bundles in the PCGR directory - * [grch37 data bundle - 20201123](http://insilico.hpc.uio.no/pcgr/pcgr.databundle.grch37.20201123.tgz) (approx 17Gb) - * [grch38 data bundle - 20201123](http://insilico.hpc.uio.no/pcgr/pcgr.databundle.grch38.20201123.tgz) (approx 18Gb) - * If our local server cannot be reached or is non-responding, try [grch37 - Google Drive](https://drive.google.com/file/d/1Fp4pYp4rU8Q0IFsKIRPV5pbhpT17rs0l/view?usp=sharing) / [grch38 - Google Drive](https://drive.google.com/file/d/1iLe_ux4Y7sbkdBDTZKnOlsMmouMtDNrw/view?usp=sharing) + * [grch37 data bundle - 20210627](http://insilico.hpc.uio.no/pcgr/pcgr.databundle.grch37.20210627.tgz) (approx 20Gb) + * [grch38 data bundle - 20210627](http://insilico.hpc.uio.no/pcgr/pcgr.databundle.grch38.20210627.tgz) (approx 21Gb) + * If our local server cannot be reached or is non-responding, try [grch37 - Google Drive](https://drive.google.com/file/d/13CFmG3Nd0P73OXbF__P9w6iJ-tcAATzB/view?usp=sharing) / [grch38 - Google Drive](https://drive.google.com/file/d/1cYgnL3jPe_r7Fp625zPgMmKols99twu1/view?usp=sharing) * *Unpacking*: `gzip -dc pcgr.databundle.grch37.YYYYMMDD.tgz | tar xvf -` -c. Pull the [PCGR Docker image (*dev*)](https://hub.docker.com/r/sigven/pcgr/) from DockerHub (approx 5.1Gb): +c. Pull the [PCGR Docker image (*dev*)](https://hub.docker.com/r/sigven/pcgr/) from DockerHub (approx 5.0Gb): * `docker pull sigven/pcgr:dev` (PCGR annotation engine) -##### Latest release - -a. Download and unpack the [latest software release (0.9.1)](https://github.com/sigven/pcgr/releases/tag/v0.9.1) - -b. Download and unpack the assembly-specific data bundle in the PCGR directory - * [grch37 data bundle - 20201123](http://insilico.hpc.uio.no/pcgr/pcgr.databundle.grch37.20201123.tgz) (approx 17Gb) - * [grch38 data bundle - 20201123](http://insilico.hpc.uio.no/pcgr/pcgr.databundle.grch38.20201123.tgz) (approx 18Gb) - * *Unpacking*: `gzip -dc pcgr.databundle.grch37.YYYYMMDD.tgz | tar xvf -` - - A _data/_ folder within the _pcgr-X.X_ software folder should now have been produced - -c. Pull the [PCGR Docker image (0.9.1)](https://hub.docker.com/r/sigven/pcgr/) from DockerHub (approx 5.1Gb): - * `docker pull sigven/pcgr:0.9.1` (PCGR annotation engine) #### STEP 3: Input preprocessing @@ -151,7 +125,7 @@ The PCGR workflow accepts two types of input files: * A copy number segment file - __optional__ * We __strongly__ recommend that the input VCF is compressed and indexed using [bgzip](http://www.htslib.org/doc/tabix.html) and [tabix](http://www.htslib.org/doc/tabix.html) -* If the input VCF contains multi-allelic sites, these will be subject to [decomposition](http://genome.sph.umich.edu/wiki/Vt#Decompose) +* If the input VCF contains multi-allelic sites, these will be subject to [decomposition](http://genome.sph.umich.edu/wiki/Vt#Decompose). Optimally, try to decompose multi-allelic variants in the input VCF prior to analysis. * Variants used for reporting should be designated as 'PASS' in the VCF FILTER column The tab-separated values file with copy number aberrations __MUST__ contain the following four columns: @@ -170,17 +144,12 @@ Here, _Chromosome_, _Start_, and _End_ denote the chromosomal segment, and __Seg #### STEP 4: Configure your PCGR workflow -The PCGR software bundle comes with a default configuration file in the *conf/* folder, to be used as a starting point for runnning the PCGR workflow. The configuration file, formatted using [TOML](https://github.com/toml-lang/toml), enables the user to configure a number of options related to the following: +The PCGR software comes with a range of options to configure the report and analysis, depending on the type of sequencing assay (__tumor-control__ vs. __tumor_only__), types of data available (SNVs/InDels, copy number aberration) etc. -* __IMPORTANT__: Designation of VCF INFO tags that denote variant depth/allelic fraction +* __IMPORTANT__: Proper designation of VCF INFO tags that denote variant depth/allelic fraction is critical to make the report as comprehensive as possible (options `--tumor_dp_tag`, `tumor_af_tag`,`--control_dp_tag`,`--control_af_tag`, and `--call_conf_tag`) * If this is not available/properly set, the report contents will be less informative __AND__ it will not be possible to preset thresholds for variant depth/allelic fraction -* Tumor-only analysis options - * tick on/off various filtering schemes for exclusion of germline variants (for input VCFs coming from tumor-only sequencing assays) -* VEP/_vcfanno_ options - -See here for more details about the exact [usage of the configuration options](http://pcgr.readthedocs.io/en/latest/input.html#pcgr-configuration-file). -To make the report as complete as possible, take a note of the following arguments which can be used in the report generation: +Furthermore, to make the report as complete as possible, take a note of the following arguments which can be used in the report generation: * Tumor purity estimate (`--tumor_ploidy`, for display only) * Tumor ploidy estimate (`--tumor_purity`, for display only) @@ -192,24 +161,127 @@ To make the report as complete as possible, take a note of the following argumen A tumor sample report is generated by calling the Python script __pcgr.py__, which takes the following arguments and options: - usage: pcgr.py -h [options] --input_vcf INPUT_VCF --pcgr_dir PCGR_DIR --output_dir OUTPUT_DIR --genome_assembly GENOME_ASSEMBLY --conf CONFIG_FILE --sample_id SAMPLE_ID + usage: + pcgr.py -h [options] + --input_vcf + --pcgr_dir + --output_dir + --genome_assembly + --sample_id + Personal Cancer Genome Reporter (PCGR) workflow for clinical interpretation of somatic nucleotide variants and copy number aberration segments Required arguments: --input_vcf INPUT_VCF VCF input file with somatic variants in tumor sample, SNVs/InDels - --pcgr_dir PCGR_DIR PCGR base directory with accompanying data directory, e.g. ~/pcgr-0.9.0 + --pcgr_dir PCGR_DIR PCGR base directory with accompanying data directory, e.g. ~/pcgr-0.9.2 --output_dir OUTPUT_DIR Output directory --genome_assembly {grch37,grch38} Human genome assembly build: grch37 or grch38 - --conf CONFIGURATION_FILE - PCGR configuration file in TOML format --sample_id SAMPLE_ID Tumor sample/cancer genome identifier - prefix for output files - Optional arguments: + vcfanno options: + --vcfanno_n_proc VCFANNO_N_PROC + Number of vcfanno processes (option '-p' in vcfanno), default: 4 + + VEP options: + --vep_n_forks VEP_N_FORKS + Number of forks (option '--fork' in VEP), default: 4 + --vep_buffer_size VEP_BUFFER_SIZE + Variant buffer size (variants read into memory simultaneously, option '--buffer_size' in VEP) + - set lower to reduce memory usage, default: 100 + --vep_pick_order VEP_PICK_ORDER + Comma-separated string of ordered transcript/variant properties for selection of primary variant consequence + ( option '--pick_order' in VEP), default: canonical,appris,biotype,ccds,rank,tsl,length,mane + --vep_no_intergenic Skip intergenic variants during processing (option '--no_intergenic' in VEP), default: False + --vep_regulatory Add VEP regulatory annotations (option '--regulatory' )or non-coding interpretation, default: False + + Tumor mutational burden (TMB) and MSI options: + --target_size_mb TARGET_SIZE_MB + For mutational burden analysis - approximate protein-coding target size in Mb of sequencing assay (default: 34 (WES/WGS)) + --estimate_tmb Estimate tumor mutational burden from the total number of somatic mutations and target region size, default: False + --estimate_msi_status + Predict microsatellite instability status from patterns of somatic mutations/indels, default: False + --tmb_algorithm {all_coding,nonsyn} + Method for calculation of TMB, all coding variants (Chalmers et al., Genome Medicine, 2017), or non-synonymous variants only, default: all_coding + + Mutatonal signature options: + --estimate_signatures + Estimate relative contributions of reference mutational signatures in query sample and detect potential kataegis events, default: False + --min_mutations_signatures MIN_MUTATIONS_SIGNATURES + Minimum number of SNVs required for reconstruction of mutational signatures (SBS) by MutationalPatterns (default: 200, minimum n = 100) + --all_reference_signatures + Use all reference mutational signatures (SBS, n = 67) in signature reconstruction rather than only those already attributed to the tumor type (default: False) + --include_artefact_signatures + Include sequencing artefacts in the collection of reference signatures (default: False + + Tumor-only options: + --tumor_only Input VCF comes from tumor-only sequencing, calls will be filtered for variants of germline origin, (default: False) + --cell_line Input VCF comes from tumor cell line sequencing (requires --tumor_only), calls will be filtered for variants of germline origin, (default: False) + --pon_vcf PON_VCF VCF file with germline calls from Panel of Normals (PON) - i.e. blacklisted variants, (default: None) + --maf_onekg_eur MAF_ONEKG_EUR + Exclude variants in tumor (SNVs/InDels, tumor-only mode) with MAF above the given percent threshold (1000 Genomes Project - European pop, default: 0.002) + --maf_onekg_amr MAF_ONEKG_AMR + Exclude variants in tumor (SNVs/InDels, tumor-only mode) with MAF above the given percent threshold (1000 Genomes Project - Ad Mixed American pop, default: 0.002) + --maf_onekg_afr MAF_ONEKG_AFR + Exclude variants in tumor (SNVs/InDels, tumor-only mode) with MAF above the given percent threshold (1000 Genomes Project - African pop, default: 0.002) + --maf_onekg_eas MAF_ONEKG_EAS + Exclude variants in tumor (SNVs/InDels, tumor-only mode) with MAF above the given percent threshold (1000 Genomes Project - East Asian pop, default: 0.002) + --maf_onekg_sas MAF_ONEKG_SAS + Exclude variants in tumor (SNVs/InDels, tumor-only mode) with MAF above the given percent threshold (1000 Genomes Project - South Asian pop, default: 0.002) + --maf_onekg_global MAF_ONEKG_GLOBAL + Exclude variants in tumor (SNVs/InDels, tumor-only mode) with MAF above the given percent threshold (1000 Genomes Project - global pop, default: 0.002) + --maf_gnomad_nfe MAF_GNOMAD_NFE + Exclude variants in tumor (SNVs/InDels, tumor-only mode) with MAF above the given percent threshold, (gnomAD - European (non-Finnish), default: 0.002) + --maf_gnomad_asj MAF_GNOMAD_ASJ + Exclude variants in tumor (SNVs/InDels, tumor-only mode) with MAF above the given percent threshold, (gnomAD - Ashkenazi Jewish, default: 0.002) + --maf_gnomad_fin MAF_GNOMAD_FIN + Exclude variants in tumor (SNVs/InDels, tumor-only mode) with MAF above the given percent threshold, (gnomAD - European (Finnish), default: 0.002) + --maf_gnomad_oth MAF_GNOMAD_OTH + Exclude variants in tumor (SNVs/InDels, tumor-only mode) with MAF above the given percent threshold, (gnomAD - Other, default: 0.002) + --maf_gnomad_amr MAF_GNOMAD_AMR + Exclude variants in tumor (SNVs/InDels, tumor-only mode) with MAF above the given percent threshold, (gnomAD - Latino/Admixed American, default: 0.002) + --maf_gnomad_afr MAF_GNOMAD_AFR + Exclude variants in tumor (SNVs/InDels, tumor-only mode) with MAF above the given percent threshold, (gnomAD - African/African-American, default: 0.002) + --maf_gnomad_eas MAF_GNOMAD_EAS + Exclude variants in tumor (SNVs/InDels, tumor-only mode) with MAF above the given percent threshold, (gnomAD - East Asian, default: 0.002) + --maf_gnomad_sas MAF_GNOMAD_SAS + Exclude variants in tumor (SNVs/InDels, tumor-only mode) with MAF above the given percent threshold, (gnomAD - South Asian, default: 0.002) + --maf_gnomad_global MAF_GNOMAD_GLOBAL + Exclude variants in tumor (SNVs/InDels, tumor-only mode) with MAF above the given percent threshold, (gnomAD - global population, default: 0.002) + --exclude_pon Exclude variants occurring in PoN (Panel of Normals, if provided as VCF (--pon_vcf), default: False) + --exclude_likely_hom_germline + Exclude likely homozygous germline variants (100 pct allelic fraction for alternate allele in tumor, very unlikely somatic event, default: False) + --exclude_likely_het_germline + Exclude likely heterozygous germline variants (40-60 pct allelic fraction, AND presence in dbSNP + gnomAD, AND not existing as somatic event in COSMIC/TCGA, default: False) + --exclude_dbsnp_nonsomatic + Exclude variants found in dbSNP (only those that are NOT found in ClinVar(somatic origin)/DoCM/TCGA/COSMIC, defult: False) + --exclude_nonexonic Exclude non-exonic variants, defult: False) + + Allelic support options: + --tumor_dp_tag TUMOR_DP_TAG + Specify VCF INFO tag for sequencing depth (tumor, must be Type=Integer, default: _NA_ + --tumor_af_tag TUMOR_AF_TAG + Specify VCF INFO tag for variant allelic fraction (tumor, must be Type=Float, default: _NA_ + --control_dp_tag CONTROL_DP_TAG + Specify VCF INFO tag for sequencing depth (control, must be Type=Integer, default: _NA_ + --control_af_tag CONTROL_AF_TAG + Specify VCF INFO tag for variant allelic fraction (control, must be Type=Float, default: _NA_ + --call_conf_tag CALL_CONF_TAG + Specify VCF INFO tag for somatic variant call confidence (must be categorical, e.g. Type=String, default: _NA_ + --tumor_dp_min TUMOR_DP_MIN + If VCF INFO tag for sequencing depth (tumor) is specified and found, set minimum required depth for inclusion in report (default: 0) + --tumor_af_min TUMOR_AF_MIN + If VCF INFO tag for variant allelic fraction (tumor) is specified and found, set minimum required AF for inclusion in report (default: 0) + --control_dp_min CONTROL_DP_MIN + If VCF INFO tag for sequencing depth (control) is specified and found, set minimum required depth for inclusion in report (default: 0) + --control_af_max CONTROL_AF_MAX + If VCF INFO tag for variant allelic fraction (control) is specified and found, set maximum tolerated AF for inclusion in report (default: 1) + + Other options: --input_cna INPUT_CNA Somatic copy number alteration segments (tab-separated values) --logr_gain LOGR_GAIN @@ -218,7 +290,6 @@ A tumor sample report is generated by calling the Python script __pcgr.py__, whi Log ratio-threshold for regions containing homozygous deletions (default: -0.8) --cna_overlap_pct CNA_OVERLAP_PCT Mean percent overlap between copy number segment and gene transcripts for reporting of gains/losses in tumor suppressor genes/oncogenes, (default: 50) - --pon_vcf PON_VCF VCF file with germline calls from Panel of Normals (PON) - i.e. blacklisted variants, (default: None) --tumor_site TSITE Optional integer code to specify primary tumor type/site of query sample, choose any of the following identifiers: 1 = Adrenal Gland @@ -256,52 +327,41 @@ A tumor sample report is generated by calling the Python script __pcgr.py__, whi Estimated tumor purity (between 0 and 1, (default: None) --tumor_ploidy TUMOR_PLOIDY Estimated tumor ploidy (default: None) - --tumor_dp_min TUMOR_DP_MIN - If VCF INFO tag for sequencing depth (tumor) is provided and found, set minimum required depth for inclusion in report (default: 0) - --tumor_af_min TUMOR_AF_MIN - If VCF INFO tag for variant allelic fraction (tumor) is provided and found, set minimum required AF for inclusion in report (default: 0) - --control_dp_min CONTROL_DP_MIN - If VCF INFO tag for sequencing depth (control) is provided and found, set minimum required depth for inclusion in report (default: 0) - --control_af_max CONTROL_AF_MAX - If VCF INFO tag for variant allelic fraction (control) is provided and found, set maximum tolerated AF for inclusion in report (default: 1) - --target_size_mb TARGET_SIZE_MB - For mutational burden analysis - approximate protein-coding target size of sequencing assay (default: 34 Mb (WES/WGS)) - --tumor_only Input VCF comes from tumor-only sequencing, calls will be filtered for variants of germline origin (set configurations for filtering in .toml file), (default: False) - --cell_line Input VCF comes from tumor cell line sequencing (requires --tumor_only), calls will be filtered for variants of germline origin (set configurations for filtering in .toml file), (default: False) + --cpsr_report CPSR_REPORT + CPSR report file (Gzipped JSON - file ending with 'cpsr..json.gz' - germline report of patient's blood/control sample + --vcf2maf Generate a MAF file for input VCF using https://github.com/mskcc/vcf2maf (default: False) + --show_noncoding List non-coding (i.e. non protein-altering) variants in report, default: False --assay {WES,WGS,TARGETED} Type of DNA sequencing assay performed for input data (VCF) default: WES --include_trials (Beta) Include relevant ongoing or future clinical trials, focusing on studies with molecularly targeted interventions - --estimate_tmb Estimate tumor mutational burden from the total number of somatic mutations and target region size, default: False - --estimate_msi_status - Predict microsatellite instability status from patterns of somatic mutations/indels, default: False - --estimate_signatures - Estimate relative contributions of reference mutational signatures in query sample and detect potential kataegis events), default: False - --tmb_algorithm {all_coding,nonsyn} - Method for calculation of TMB, all coding variants (Chalmers et al., Genome Medicine, 2017), or non-synonymous variants only, default: all_coding - --min_mutations_signatures MIN_MUTATIONS_SIGNATURES - Minimum number of SNVs required for reconstruction of mutational signatures (SBS) by MutationalPatterns (default: 200, minimum n = 100) - --all_reference_signatures - Use all reference mutational signatures (SBS, n = 67) in signature reconstruction rather than only those already attributed to the tumor type (default: False) - --force_overwrite By default, the script will fail with an error if any output file already exists. You can force the overwrite of existing result files by using this flag + --preserved_info_tags PRESERVED_INFO_TAGS + Comma-separated string of VCF INFO tags from query VCF that should be kept in PCGR output TSV file + --report_theme {default,cerulean,journal,flatly,readable,spacelab,united,cosmo,lumen,paper,sandstone,simplex,yeti} + Visual report theme (rmarkdown) + --report_nonfloating_toc + Do not float the table of contents (TOC) in output report (rmarkdown), default: False + --force_overwrite By default, the script will fail with an error if any output file already exists. You can force the overwrite of existing result files by using this flag, default: False --version show program's version number and exit --basic Run functional variant annotation on VCF through VEP/vcfanno, omit other analyses (i.e. Tier assignment/MSI/TMB/Signatures etc. and report generation (STEP 4), default: False - --no_vcf_validate Skip validation of input VCF with Ensembl's vcf-validator - --docker-uid DOCKER_USER_ID + --no_vcf_validate Skip validation of input VCF with Ensembl's vcf-validator, default: False + --docker_uid DOCKER_USER_ID Docker user ID. default is the host system user ID. If you are experiencing permission errors, try setting this up to root (`--docker-uid root`) - --no-docker Run the PCGR workflow in a non-Docker mode (see install_no_docker/ folder for instructions) + --no_docker Run the PCGR workflow in a non-Docker mode (see install_no_docker/ folder for instructions) --debug Print full Docker commands to log, default: False The _examples_ folder contain input VCF files from two tumor samples sequenced within TCGA (**GRCh37** only). It also contains a PCGR configuration file customized for these VCFs. A report for a colorectal tumor case can be generated by running the following command in your terminal window: - python ~/pcgr-0.9.1/pcgr.py - --pcgr_dir ~/pcgr-0.9.1 - --output_dir ~/pcgr-0.9.1 + python ~/pcgr-0.9.2/pcgr.py + --pcgr_dir ~/pcgr-0.9.2 + --output_dir ~/pcgr-0.9.2 --sample_id tumor_sample.COAD + --tumor_dp_tag TDP + --tumor_af_tag TVAF + --call_conf_tag TAL --genome_assembly grch37 - --conf ~/pcgr-0.9.1/examples/example_COAD.toml - --input_vcf ~/pcgr-0.9.1/examples/tumor_sample.COAD.vcf.gz + --input_vcf ~/pcgr-0.9.2/examples/tumor_sample.COAD.vcf.gz --tumor_site 9 - --input_cna ~/pcgr-0.9.1/examples/tumor_sample.COAD.cna.tsv + --input_cna ~/pcgr-0.9.2/examples/tumor_sample.COAD.cna.tsv --tumor_purity 0.9 --tumor_ploidy 2.0 --include_trials @@ -313,14 +373,15 @@ The _examples_ folder contain input VCF files from two tumor samples sequenced w This command will run the Docker-based PCGR workflow and produce the following output files in the _examples_ folder: - 1. __tumor_sample.COAD.pcgr_acmg.grch37.html__ - An interactive HTML report for clinical interpretation (rmarkdown-based) - 2. __tumor_sample.COAD.pcgr_acmg.grch37.flexdb.html__ - An interactive HTML report for clinical interpretation (flexdashboard-based) - 3. __tumor_sample.COAD.pcgr_acmg.grch37.pass.vcf.gz__ - Bgzipped VCF file with rich set of annotations for precision oncology - 4. __tumor_sample.COAD.pcgr_acmg.grch37.pass.tsv.gz__ - Compressed vcf2tsv-converted file with rich set of annotations for precision oncology - 5. __tumor_sample.COAD.pcgr_acmg.grch37.snvs_indels.tiers.tsv__ - Tab-separated values file with variants organized according to tiers of functional relevance - 6. __tumor_sample.COAD.pcgr_acmg.grch37.mutational_signatures.tsv__ - Tab-separated values file with information on contribution of mutational signatures - 7. __tumor_sample.COAD.pcgr_acmg.grch37.json.gz__ - Compressed JSON dump of HTML report content - 8. __tumor_sample.COAD.pcgr_acmg.grch37.cna_segments.tsv.gz__ - Compressed tab-separated values file with annotations of gene transcripts that overlap with somatic copy number aberrations +1. __tumor_sample.COAD.pcgr_acmg.grch37.html__ - An interactive HTML report for clinical interpretation (rmarkdown) +2. __tumor_sample.COAD.pcgr_acmg.grch37.flexdb.html__ - An interactive HTML report for clinical interpretation (flexdashboard) +3. __tumor_sample.COAD.pcgr_acmg.grch37.vcf.gz (.tbi)__ - Bgzipped VCF file with rich set of annotations for precision oncology +4. __tumor_sample.COAD.pcgr_acmg.grch37.pass.vcf.gz (.tbi)__ - Bgzipped VCF file with rich set of annotations for precision oncology (PASS variants only) +5. __tumor_sample.COAD.pcgr_acmg.grch37.pass.tsv.gz__ - Compressed vcf2tsv-converted file with rich set of annotations for precision oncology +6. __tumor_sample.COAD.pcgr_acmg.grch37.snvs_indels.tiers.tsv__ - Tab-separated values file with variants organized according to tiers of functional relevance +7. __tumor_sample.COAD.pcgr_acmg.grch37.mutational_signatures.tsv__ - Tab-separated values file with information on contribution of mutational signatures +8. __tumor_sample.COAD.pcgr_acmg.grch37.json.gz__ - Compressed JSON dump of HTML report content +9. __tumor_sample.COAD.pcgr_acmg.grch37.cna_segments.tsv.gz__ - Compressed tab-separated values file with annotations of gene transcripts that overlap with somatic copy number aberrations ## FAQ diff --git a/docs/CHANGELOG.md b/docs/CHANGELOG.md index 3f5f71b4..bbdd5e29 100644 --- a/docs/CHANGELOG.md +++ b/docs/CHANGELOG.md @@ -1,6 +1,70 @@ ## CHANGELOG +#### 0.9.2 - June 30th 2021 + +* Data updates: ClinVar, GWAS catalog, CIViC, CancerMine, dbNSFP, KEGG, ChEMBL, Disease Ontology/EFO, Open Targets Platform, UniProt KB, GENCODE +* Software upgrades: R v4.1, Bioconductor v3.13, VEP (104) ++ + +##### Changed +* TOML-based configuration for PCGR is abandoned, all options to PCGR are now configured through command-line parameters + * __NOTE__: We recommend to turn on `--show_noncoding` and `--vcf2maf` (prevously turned on by default in TOML). For tumor-only runs, we recommend to include `--exclude_dbsnp_nonsomatic` and `exclude_nonexonic` + +##### Added +* Command-line options + * Previously set in TOML file) + * Allelic support + * `--tumor_dp_tag` + * `--tumor_af_tag` + * `--control_dp_tag` + * `--control_af_tag` + * `--call_conf_tag` + * Tumor-only options + * `--maf_onekg_eur` + * `--maf_onekg_amr` + * `--maf_onekg_afr` + * `--maf_onekg_eas` + * `--maf_onekg_sas` + * `--maf_onekg_global` + * `--maf_gnomad_nfe` + * `--maf_gnomad_asj` + * `--maf_gnomad_fin` + * `--maf_gnomad_oth` + * `--maf_gnomad_amr` + * `--maf_gnomad_afr` + * `--maf_gnomad_eas` + * `--maf_gnomad_sas` + * `--maf_gnomad_global` + * `--exclude_pon` + * `--exclude_likely_het_germline` + * `--exclude_likely_hom_germline` + * `--exclude_dbsnp_nonsomatic` + * `--exclude_nonexonic` + * `--report_theme` + * `--preserved_info_tags` (previously `custom_tags (TOML)`) + * `--show_noncoding` (previously `list_noncoding (TOML)`) + * `--vcfanno_n_proc` (previously `n_vcfanno_proc (TOML)`) + * `--vep_n_forks` (previously `n_vep_forks (TOML)`) + * `--vep_pick_order` + * `--vep_no_intergenic` (previously `vep_skip_intergenic (TOML)`) + * `--vcf2maf` + * New options + * `--report_nonfloating_toc` (**NEW**) - add the TOC at the top of the HTML report, not floating at the left of the document + * `--cpsr_report` (**NEW**) - add a dedicated section in PCGR with main germline findings from CPSR analysis - (use the gzipped JSON output from CPSR as input) + * `--vep_regulatory` (**NEW**) - append regulatory annotations to variants (TF binding sites etc.) + * `--include_artefact_signatures` (**NEW**) - include sequencing artefacts in the reference collection of mutational signatures (COSMIC v3.2) + + +##### Fixed + * Bug in writing (large) report contents to JSON (issue [#118](https://github.com/sigven/pcgr/issues/118)) + * Bug (typo) in merge of clinical evidence items from different sources (CIVIC + CGI) (issue [#126](https://github.com/sigven/pcgr/issues/126)) + * Bug in value box for number of (high-confident) kataegis events - rmarkdown (issue [#122](https://github.com/sigven/pcgr/issues/122)) + * Bug in value box for tumor purity/ploidy -rmarkdown (issue [#129](https://github.com/sigven/pcgr/issues/129)) + +##### Removed + * Command-line options + * `--conf` - TOML-based configuration file + #### 0.9.1 - November 30th 2020 * Data updates: ClinVar, GWAS catalog, CIViC, CancerMine, dbNSFP, KEGG, ChEMBL/DGIdb, Disease Ontology, Experimental Factor Ontology diff --git a/docs/CHANGELOG.rst b/docs/CHANGELOG.rst index eec2299e..42fb4a37 100644 --- a/docs/CHANGELOG.rst +++ b/docs/CHANGELOG.rst @@ -1,12 +1,115 @@ CHANGELOG --------- +0.9.2 - June 30th 2021 +^^^^^^^^^^^^^^^^^^^^^^ + +- Data updates: ClinVar, GWAS catalog, CIViC, CancerMine, dbNSFP, KEGG, + ChEMBL, Disease Ontology/EFO, Open Targets Platform, UniProt KB, + GENCODE +- Software upgrades: R v4.1, Bioconductor v3.13, VEP (104) ++ + +Changed +''''''' + +- TOML-based configuration for PCGR is abandoned, all options to PCGR + are now configured through command-line parameters + + - **NOTE**: We recommend to turn on ``--show_noncoding`` and + ``--vcf2maf`` (prevously turned on by default in TOML). For + tumor-only runs, we recommend to include + ``--exclude_dbsnp_nonsomatic`` and ``exclude_nonexonic`` + +Added +''''' + +- Command-line options + + - Previously set in TOML file) + + - Allelic support + + - ``--tumor_dp_tag`` + - ``--tumor_af_tag`` + - ``--control_dp_tag`` + - ``--control_af_tag`` + - ``--call_conf_tag`` + + - Tumor-only options + + - ``--maf_onekg_eur`` + - ``--maf_onekg_amr`` + - ``--maf_onekg_afr`` + - ``--maf_onekg_eas`` + - ``--maf_onekg_sas`` + - ``--maf_onekg_global`` + - ``--maf_gnomad_nfe`` + - ``--maf_gnomad_asj`` + - ``--maf_gnomad_fin`` + - ``--maf_gnomad_oth`` + - ``--maf_gnomad_amr`` + - ``--maf_gnomad_afr`` + - ``--maf_gnomad_eas`` + - ``--maf_gnomad_sas`` + - ``--maf_gnomad_global`` + - ``--exclude_pon`` + - ``--exclude_likely_het_germline`` + - ``--exclude_likely_hom_germline`` + - ``--exclude_dbsnp_nonsomatic`` + - ``--exclude_nonexonic`` + + - ``--report_theme`` + - ``--preserved_info_tags`` (previously ``custom_tags (TOML)``) + - ``--show_noncoding`` (previously ``list_noncoding (TOML)``) + - ``--vcfanno_n_proc`` (previously ``n_vcfanno_proc (TOML)``) + - ``--vep_n_forks`` (previously ``n_vep_forks (TOML)``) + - ``--vep_pick_order`` + - ``--vep_no_intergenic`` (previously + ``vep_skip_intergenic (TOML)``) + - ``--vcf2maf`` + + - New options + + - ``--report_nonfloating_toc`` (**NEW**) - add the TOC at the top + of the HTML report, not floating at the left of the document + - ``--cpsr_report`` (**NEW**) - add a dedicated section in PCGR + with main germline findings from CPSR analysis - (use the + gzipped JSON output from CPSR as input) + - ``--vep_regulatory`` (**NEW**) - append regulatory annotations + to variants (TF binding sites etc.) + - ``--include_artefact_signatures`` (**NEW**) - include + sequencing artefacts in the reference collection of mutational + signatures (COSMIC v3.2) + +Fixed +''''' + +- Bug in writing (large) report contents to JSON (issue + `#118 `__) +- Bug (typo) in merge of clinical evidence items from different sources + (CIVIC + CGI) (issue + `#126 `__) +- Bug in value box for number of (high-confident) kataegis events - + rmarkdown (issue + `#122 `__) +- Bug in value box for tumor purity/ploidy -rmarkdown (issue + `#129 `__) + +Removed +''''''' + +- Command-line options + + - ``--conf`` - TOML-based configuration file + 0.9.1 - November 30th 2020 ^^^^^^^^^^^^^^^^^^^^^^^^^^ - Data updates: ClinVar, GWAS catalog, CIViC, CancerMine, dbNSFP, KEGG, ChEMBL/DGIdb, Disease Ontology, Experimental Factor Ontology +.. _added-1: + Added ''''' @@ -18,6 +121,8 @@ Added - Improved Conda recipe (i.e. ``meta.yaml``) with version pinning of all package dependencies +.. _changed-1: + Changed ''''''' @@ -40,6 +145,8 @@ Changed UniProt KB, dbNSFP, Pfam, KEGG, Open Targets Platform - Software updates: VEP 101 +.. _fixed-1: + Fixed ''''' @@ -48,7 +155,7 @@ Fixed - Missing protein domain annotations for grch38, issue `#116 `__ -.. _changed-1: +.. _changed-2: Changed ''''''' @@ -90,7 +197,7 @@ Changed - Metadata - sample and sequencing assay - Report configuration -.. _added-1: +.. _added-2: Added ''''' @@ -134,7 +241,7 @@ Added - Data updates: ClinVar, GWAS catalog, GENCODE, CIViC, CancerMine - Software updates: VEP 98.2, vcf2tsv -.. _fixed-1: +.. _fixed-2: Fixed ''''' @@ -142,7 +249,7 @@ Fixed - More improved mapping between Ensembl transcripts and UniProt accessions (using also RefSeq accessions where available) -.. _added-2: +.. _added-3: Added ''''' @@ -150,7 +257,7 @@ Added - Possibility to filter evidence items by RATING in interactive data tables -.. _changed-2: +.. _changed-3: Changed ''''''' @@ -170,7 +277,7 @@ Changed LOFTEE (VEP plugin) `1.0.3 `__ -.. _fixed-2: +.. _fixed-3: Fixed ''''' @@ -187,7 +294,7 @@ Fixed - Bug in UpSetPlot for cases where filtering produce less than two intersecting sets -.. _added-3: +.. _added-4: Added ''''' @@ -205,7 +312,7 @@ Added 0.8.1 - May 22nd 2019 ^^^^^^^^^^^^^^^^^^^^^ -.. _added-4: +.. _added-5: Added ''''' @@ -215,7 +322,7 @@ Added 0.8.0 - May 20th 2019 ^^^^^^^^^^^^^^^^^^^^^ -.. _fixed-3: +.. _fixed-4: Fixed ''''' @@ -223,7 +330,7 @@ Fixed - Bug in value box for Tier 2 variants (new line carriage) `Issue #73 `__ -.. _added-5: +.. _added-6: Added ''''' @@ -346,7 +453,7 @@ Added - Rating of the ClinVar variant (0-4 stars) with respect to level of review -.. _changed-3: +.. _changed-4: Changed ''''''' @@ -358,6 +465,8 @@ Changed - Moved option for vcf_validation from configuration file to run script (``--no_vcf_validate``) +.. _removed-1: + Removed ''''''' @@ -366,7 +475,7 @@ Removed 0.7.0 - Nov 27th 2018 ^^^^^^^^^^^^^^^^^^^^^ -.. _fixed-4: +.. _fixed-5: Fixed ''''' @@ -400,7 +509,7 @@ Fixed - Removed ‘COSM’ prefix in COSMIC mutation links - Bug in retrieval of splice site predictions from dbscSNV -.. _added-6: +.. _added-7: Added ''''' @@ -439,7 +548,7 @@ Added - Upgraded VEP to v94 -.. _changed-4: +.. _changed-5: Changed ''''''' @@ -456,7 +565,7 @@ Changed 0.6.2.1 - May 14th 2018 ^^^^^^^^^^^^^^^^^^^^^^^ -.. _fixed-5: +.. _fixed-6: Fixed ''''' @@ -466,7 +575,7 @@ Fixed 0.6.2 - May 9th 2018 ^^^^^^^^^^^^^^^^^^^^ -.. _fixed-6: +.. _fixed-7: Fixed ''''' @@ -485,7 +594,7 @@ Fixed - Bug in copy number annotation (missing protein-coding transcripts) - Updated MSI prediction (variable importance, performance measures) -.. _added-7: +.. _added-8: Added ''''' @@ -499,7 +608,7 @@ Added 0.6.1 - May 2nd 2018 ^^^^^^^^^^^^^^^^^^^^ -.. _fixed-7: +.. _fixed-8: Fixed ''''' @@ -517,7 +626,7 @@ Fixed 0.6.0 - April 25th 2018 ^^^^^^^^^^^^^^^^^^^^^^^ -.. _added-8: +.. _added-9: Added ''''' @@ -642,7 +751,7 @@ Added - *MEAN_TRANSCRIPT_CNA_OVERLAP* - Mean overlap (%) betweeen gene transcripts and aberration segment -.. _removed-1: +.. _removed-2: Removed ''''''' @@ -678,7 +787,7 @@ Removed https://github.com/mskcc/vcf2maf will be incorporated in the next release -.. _changed-5: +.. _changed-6: Changed ''''''' diff --git a/docs/_build/doctrees/CHANGELOG.doctree b/docs/_build/doctrees/CHANGELOG.doctree index 1f8dcb799d09f9cd2d5995f92c00245e33bded45..389187e9e82e4955bd9d0e5151abacb0ebe53424 100644 GIT binary patch literal 203191 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%0D5)Uf-+|$Sgl9V$ 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

3t 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 delta 200 zcmdloiSf`RMwSMaspcD5VnrDZCmV&y8qVXIY$x`S(QvbYI3FWW&|YE= zn6v;2b4`|$d;;d_P3D&6oNOg^4agIeo(Co&Dn3cS0`ovB?g3e^WI?j8WQ`{CNeWCp zE%zME1MA=XO8z}Bqse3eJw=(K)a2B>5`}`&q@2v;#FEVXJgX@g?6Ffa#CpIA*dPiv J8|bk}0|0sJK1Kil diff --git a/docs/_build/doctrees/annotation_resources.doctree b/docs/_build/doctrees/annotation_resources.doctree index 0cdedd0fe85ef5bec3c2a6597bf01895bbfe29f6..f2f6d3994b7e0cfa07eb3413b9a167dc038e0c75 100644 GIT binary patch delta 2078 zcmah}TTEP46z!fn_W}cy_dw+_BVb_=hI#QA7^P*vfoXY+5-8y{V4$}^DPRX%8`5dh zHd(zNd#$zi zI{WN`W-DitHfVtmdu;sNfoG)|s#g8(KR;7#dN z;t`WYyQ@pA)12^(da^}+yg-sggOB+*C`J&JLa~>=A3J+9Bf{5esc9`zBkbnj1THGf z*sL(C4Y}%?&fzyjwLxdlYZM+aq|GB%Z&Yxv6C(qN_>p1-Y~BPf1jIF-)1Gy63=Wi$ zhzOn!GilbU;H~IxdOUZ`Q~GtqT0*@@a<3V%vm%H57F)@I8|xD__`A~fqFJj8uo~=i zjTt3j;&etlIuhrg37tu{6bb6@m=Tmg1Zru*XX%fmPvs!uo;Aq;9P>A)aT;)d0zc_<7>EwIWLs?j#(^}nlz^b-jer75@NH5yXwEBX>z6-;l z?QtRhLz&K4f^uBUH2VB*X#I;bJRvYQyNi7?b{APM9pT_CPG`F^igVSkb$1QBI){%c zww{?YUS716heY!=v|^iPPpTC1cfuG!VxoQd5r7`+J!!HrC+hQ6*qGOnuJ6zpa}|E= zluYj?HA+GyUD{-TI*ielrAQ!uH;f?FVxCS9M(ohppaYNVRk*CnPd7=%Gw4rhU#CV% zsMxQcgEDM0QQGrPrJ5QorXUf zzl0KR|KMG0FUX2FnGFR+#pVocb8SQMo`RZpnu{Fx#8jJBn5+KxhW@uU!e5Ke3QD%F zQdxK`Ype1emzX2g(qkOrwr!*DoN~MgYm4kV{ImMEgrRYPC{we3Sm?6P*N=Hi3dWg# zmD7thq0Iaw+`I5SLfKe9x&!Z)gpt$|H~1JcrMG+whea=x(KJ_C8ZvKr$bl6nclCe; z|JpS}`|0iMo!!TwicO}&iIdg@JXo$()pQZ%^F=;|6YkZSwuVbDlEctgWMCoVU3 zK?CF1nq1I>Up0M0AGZ3NN%;Q073jsXp;U6I`KgTWr{{0R7^juoYdr}tKx*5U01lBz z=P$qyQt&Ya%Sm2WD=!SuZKA+NaG^B?@9&=#Mrg?93tbmWq2F7A{3)traD*-sNlxD@ zJRD<%-GfVTl9Ua-Cl^jp)ek-uH&P0x7~V8;7tT{-S)}ysgJCd6=G@CXTp@#J9sz%i zDrWKiL(T==KZm7TxC*IC?QhxI!c95IPy@xN4B&PZvvIjHTT#X9ZRVv+ z9%f0kCzKa%PL%+}F+iA-i7u?_=4;Ds3{{budpiKY( delta 2133 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 literal 54296 zcmd6QdypK*c^`g4IRlz{l1Am=scrAgtam_R8uGOf!!KJ_-sOt5(mOf|DtW2*~)jZRv86X0~ z*Bq}B7LCRAT2uE->i?d0%xhNN0!9`6z%)qePB#}09GRgTC=Kqh8qDL(xNgn7;zgdr)+3$Yj)PU7Wl*EMzv~`JuwA;_^eYg9HVl= zDtiGYe?IWnPC2d@%((tgO?N%R(Lixfz^YdabnkCE4IAA9{~hPRwnkmA7LM!nvf&g? z8udoaD4aK%4F~-Kf3VzWE;!bliPqcp@7;H#xPR~dz3(hsAXXP<^vjoxI(VYDFgY|| z-(KDi1`we!_TH(7ruJcM$EX^*YXoM|-(XxTS6dZ>W{trFJ0|@;77`47(QMU9?o_3O z|EEq|&@Oll#|R96w7D=xa_VZXw@?MA`j}H-nc$D>>7G@NXxWcuQ~*M5qi|T2x)e;ByZp7(I`GHor+{89Y6|F>Q?>P~(1=7Pk+x4)K96vgi}i(EV<|MAy(jf%by_^Sd@;SY*? zZMFu1=B8Wt*B=G~dezWiK!hgu^F36Gdv52+XrY1&sxi~Ie!yuoyz5gR2@7nIUNo#L0yHbc2_<*9K}(YgAg8DB&Je-03-14J>VV^@e9? zjxh@(043I3m=+^gl!LlvB>U$pn1r=1YY>#CN#TB+8q%Ite1God2Ni_G=!MO zQ`>3Y!EnYxYo(Q7Z^@K$`N(C%Xlhq=rw*Eh!}}ZERu_hVDZ(EHGc$zG1};l@jO(aD#d;V9VHdQP14(A=2kMsBw91zkf<@72 zRNiaWT%AnUCGOkD>KL+UlhjUVB>vMXMiY+Z)NKN!Ib)t>*kjOKQ$vFi%(-5zhP^k6 za^ni<6zX@V9$^otK{)*(uj*YY&B)wT}nHXwonQXQCDe+>u>M+QUc z1xAbEjR^Y}o9;V8_r>0eomb?$m`|ch=!Q-{Iv~TIwNy?P$R83d*yo$yG`~q@<8hgm z5PDH3+gl!#*u0?Z*Uo z1TuBcnzhI+_qXbo>y4`+Kpx*Mi@?SFQ|>h&dbO-dfD*wEM!ig7QLsB%G>2A3SR}D? zjL6GyQ^um%AeEBtM^u9#a8eXF;<$DbSWz4A=bVxBc!mTOn73MtSk?!~haRuGy>F3zfx<85OF#9iay=w+VC1_3kS zn~8>kt6YN!4>qRMLPQePY!rR2Iu?0DGTCsNLx_s3A46lk$^)8P&27SzncK}BY}3Yt zzZL?R6gIYZTqlIhKM;z0k7%tRVyup+gvXG95wP(z@1~(~n9RYKwDf}lQP|)H42D2` zy(pR0=P4YPh33=dDW3gl^9=uU*gV4RIktwnJ9-$pam5w}jX+jwH7f|w;4nonAco;+ z$A$cs;CRXFiel~r-wAF|fGdNzuzHh#$v%KMZhu$3jWtlc`%6# zfl(z?peS`-bp>WAIWB2o*jI9f5lRA;6%0-w6o>s1*+_z}h8|K@FrP^w$W(^}=D9Um zUb6*<9Ysy+MARg)XTgV~N5Fyr1Ysn3mIV9QBa*`lS3aw!3bL~#o>*wc!Atu@xH4hD z1#BLciKW5BIAnoK!dpn9Q&d@DD+9D*p72!3|B%xU>3oOa6otehBBmZ#MTLtK^CHiP zM-?s^VHz#ioY1ujum?4=94M4hg8;)bZ5TDN&h+1FdS25#Iz3&k)NOaFTy3-}2y7f< z3iO-S(U2CI?zHSRy?^S+)RAeisPv|6_Yv?1VZg%|jUO!@J9D9U=FDmB$%|)BHyr#Y zDJmii8nKgLqaiBNa*}&q{k}=)#QSy!22U^QT(MlNWfz1GU;V!KQlm>@qX-aV6IzO~ zIRopzYaYdXBnrXHe!nad9(qGqPw~B2YQ1b6!Epl{=QTcdS4yW9ZD@y5J zZjY*B>)`1QN-6SSudyv`Qzf$llT>#>OIqRXc;cDUrwcR3&OBat_v2@dJ$3rgV<%3W zfBeFQ_XN@4TjJiFTEJ>vuLb_*)5m5`K6C6Ox}HA$Xw{l(ICF_^>*e~hK1cq^A7~PX zK^Tr2$GEm*Md=q{q{I@wELQLc*|30j9rd#}-~8uLa~lM7T@ zY;i2UnHzK(ZGn%3nQ-%~>+nP*A)C0HsG^7+figk|sxseYzFRce%1sj9B8*)`^{~WD zL|67JBzXzIosL`7N&0Y|%oK?VnPUJK%MdN{SF%0K48pha<&L$&DA^ybpztzWLhOi( z9pefX+@59{I;=_rabvOtVioweQ@4q+5;dMxLvjHzerLtihJ(xJfx^P;8PSXr|w8j@)uG{tbCIUA>J7~D>`y3sN%Cy^uoEN%Wk7*%gCi`BV?HMppT zLzE4q8QoTHHaXBquhj*D8%2Yz_-v-Co)~SQT6ojeoK|f#E@NS^2>(o~99IaAQ4%?< z+u>r?O%3^&y6z!`g$!T$GK{ushBMj%xq+C8>|d*1k@=Lszws*4AB?&QXS6B0g;xBgjR~z2W?OEs>rC`(ygHFt*9Ail`h4ww#KjoMG&=e=r%Upa-HdtRi8GkmS~3$`Se6hS9UXza--i$c8w}VIiZ@F}<$hDNd(wYS?xRFIPT_Wz zIcOqv><_@rbI$fvgv^7-pG5fg`02AJktBQK*pG+}87z;)uh^K`tk;pt6(KGx2d@d? zGuC^^`DpF}c5-UCU8k4GXZs>-rc?vAH?Ub#L2857Tfu9XYqa%(OnkVNHN{>K%ZK39 zYJa<&PgH1PBMhl$j|j7^v(l2g9H)EIt}ex{SHbA!p;HgG{LRw561l)~&I$yJ{&-tCRv*aHE+PZo zpyV*cQvLu4LJ1wZ0U-_KU*WH5-wCNZ&}z}&g2kAASu@b3s==F6W*ffuWq*AW$!}UM z3ft)y!X@0*t5>IZHnaekhQdvwr8^y9XA3=|Og@Rs7^fVNc8xZKhzb;IyRA}t>5!>ovqA*phy(qtLi0ftB#PnF zu&5`~Q^7npCDXj&9t?Iy#omv(#$Rfu!XF8fq~Hy*X6Cp2^#Y_8rkh*-0D=(OO=C95 zoy?QRe*dkv_7%SUjQ!N=RjY9K-G_erqu;!4KONnD?7Ii;v(eqhcfDz!iSGWX_Urb! z=$;irGUPOUxXPY z5l+xVoBON_tnm~e7!7|1fl;dcQeK^SEm$PO%l z!w#{@AN%A&?33H@xG6<9l!ug%y3my&?h_F02k_I?ryWEETp>T!*Ne!~ zh1nS>5cz8nk@RCJCK8yJg2|b1`ST)z3WcAdf4Z-xs0J|@872BRTr$!B?dvQm zNx0(|@!;8d8F+=+;Yr)T#O*n{Sai8eml|Cfbh$zo7Z(G8n0`&}e6L27p^GPJ5a97c zRe130IBlTOlG9&1S8bFKmG_xe1py}h8_XSP6^5klvXSE87?^O(!Pp!#!&3clD|eW+)+ZNiSi43C4jZ z^l5=t6cc6$eY%?zS~MXN776_}lVTsm2t3xOl*eM0+J_<#pA;Z^8jneP*-3aiKL}AQ z%-~TMdSI$>V6SHu=*iV~&wHbWJpZpL&p#ur{Y?{fiCvMf6VKHKl6W!w|DE#qDf)jo zFa7gM@VaBLTa|W7%Q7bFUnoy1D^dF<5G7#j6dk{#JYwmGapAYukAc@*-L5H#6j|?kP&k@> z54Fd8H)_aw`8&#_&MG2_$eOT&hXHny)p2C~Tgv07q~#lVL1gAr?x0`?G3o#qb++s^ zXa%&71A3hm^%*v+m3FM0iw<6)zgG=949zMmTw*-i{Qyj2m-O7dHA`a+g z9mkaiO;K_zFNj#)*9#EKz5-g(Aw8swdR8$G9n$`^i8-u1Xo}un)W&6K~t3c zg}fkQ8UJ}^#&WMOm-H&XtBiVfl8Z!U@j%+E{I>F-DUyFPFNjW(=det%abp$A0V2j? zMUC4&7`HR}LSg^@dIg&YouRWZZs|5`+*bFkRERe^QPUTSgi{aW_V;<28*kbCP=M%Z z+-`mNHnC#l48ymBX+AYw&hcD{WTZEvV(yi3L(Jm;H zC#wmTipG0$-7*O0l!s2q#~A^lr=s=V8_k=*Su#iMDNiaZJ;NxXi%YwrJZOrN^}HZr zO}os@xaCpA&nTmwo#Y%v97-Fvk0=kCBKbeb3u47do@s6RWo7iUl09CVc9Hd8RUS4) z_+QBjV&w^c9xsc{cW#39hox+?zoU$PR>BWV(93ExzNA^4?)_usK~rS^!@M9m$)3X# z$IhHxMh*}$7AqJvADJRYjopF5{v(_cc(8qA08w+dHY^z%`d2P$#?v-M!il2h2h;K~ zqC9j;K86H{x05s9r#z|bn#PIdE@AVO@}Mb7K9CngEaQ{Rj9c!^pHW6VJIUFZA5IJJ zdF4SQ0z^;Gvi$iNerl<0 zXGg9anVjEHo>NwGhO5LbOO~%I51Jz6n|VRRV*b^cD^l@ZL?4|nU9g1IvtwU zy$Q?350r_MRW3$E+EZ@nbkVZEQ64!Z9N!ZldTQDKhh)r799NlqpxWr4O^t$DMG%I7ep-IFXaUhYZD3d6wbZnT=39lmI)guw~Zas$;PkGoB;V1Hf=#=;z?jiOtY{7DXh_T=}E(eGh3x0Dr2Z$JpPl%W9 zRNj@A93d=lmJb~z)zgqKd)$;db;tgX(OchjWx?n!(ln!`-uk|*JXT7M&AcFD-Whp8 zNZyHKhHl-9`(2JKvi~4r-^Z0F)17@ZsioNWQRT5x?0a2+=qdTjAHp1X&eXkvdydqs!ta3I0HN@Dw|KFE5A{XUE8M=0X8SvlmFiIuxvj zpgIdUH5qEtRW1HDFA?MCTz`-k#ESD_+X+7Tk&X|o6g;DB*69mZ3+*PaXDjB-y(`9> z?Gy53N`YT7fnQ2p?p8)3r7m~n1+n66>ZfCy=#v%gtH7|7+3=(?`dO_NPTr8?r^x=e z@}McQKb99nC)smE@bMymBas{+Vk}M6DaQT8Vr@BiR zO?0W?@+XwXN(t5n1c+N0T;BVb?po!-yzW?f-77$8T>5GTzLr>skN0fX;cQ)4!9S%; zl8of{cTK>+TIHg|yqLhen7}-x{hw6ED8-~t=fA znA>iA&=ucE=1=v~_g#(IS)=UHe>mzI$BKtC*%9|D^y4}3pej}}s|fC&z#-OxsKvxw zijCPK&xQWuxr9>MC1(C=UJ}Q#+E?;|SV4K@!<=_MEA7gx_!dvSyilMcw<$F0VCxNA zG9&+w@-(wD@{WnnibQx8V?0wP3QF9IA?_)L?odW4#n7#JL994KC-5x}&#>w^ zL|%NlVLJS#GPpTwh%W+l=whZG%*;oXr=3+N@14NcLdU5xNfvGQSMgi@?L znis^1vvT?rzHEyxOUzMDNPYyRfUlz?Sw`Vng}#w4SRH<}uT4vpdoznG%H+t(;=L2} zrCu=~rP%%cydYMb-5by0gD?1AMK7P(rJh;# zvhtL&vTS^UzQP2YZsZ?7q&$3zDL<7LL}sSsKHcNq8OWqdYA1t+#6n4M3g0y8FsRwO zFz-IEJoBu)+l6CwfjKEy81BRiCBaXDc}mCLP{t_5&d&%Cw{TfIdQyDtvrxkq!LXKS z4_7)Xnee}*Jk6|xADfW786h?)5`RN^>=cQ=o)<){F>f-LmTytYi-7ef5b_tU;IpZz zz_GoG`S4xkiDc!&$OOfO#SoJe7v54HImLy)%nPEE3o7eXiA9_kWOd5{BF2If6gfb| zSa2>Y2Z$JpYk8MRGCe6i4|D6%lc|r%B;zmp`%zNz@cQLh0@3uAN=hD39xEl(dj*JF zX}vF8eEeKt@6p1!1<%AsLX%|lM>{InYCNMn&F)qsMN%I}W_dU>Yj2T1OqbsEJg+=- zio$2}f{0b+G&52AE?hfnmTJtbT2P*BR#x4`tlC#Z zUM@nGQUJUqmuB6(GAb$7xp_fkW?k+`b(i4X{-fa4)jGb!SP@&-VxdTmu)yEfZD(P| zKFrBaD$hMDCwDO?_k(kcy4dL!YeM0}CF+tJ@e>H2P{t_5(2ofax6s;cIzeA`Z#41w zY_AZ0?6}S3b#1{c_=@s`v$A0G1U|nR;#CasN>TjRl@Ul${7ZR3#47a5%(UgUexs*# zte8AxTdD?f*6pg&S;-9fbLGioWyshBtS_)Zu7t5k@#0UF$4>F$+j&8B@*+pv7l)3l zgE>INSgepg+$n780rH3VP!{cBAxBllcWqOv%p103Ss5Q$p*Yar$@cRAJR#7e?WqKs zDY+R_#v>&+>+^zGagN<9ICk(TeMfB8nrk^mVFBOuVqb`_s$ZV1Hm_--35y#wbXk4HRZ8VLiAw);uc1@Yo0y+M7x%X5+>d+DNiUP z@%*(D^X1v}qVJ2!1EwhW`Me-v1$cv*u-p;r=Hrd#LV-VmS#XUxT2yrGMs#n&%=kU! ziDhNR7CeyITqrVT_|lccEM+ABlQIS=?)*+(5G&4|ZQ{Gxp+Dzb3VkxQT{(KTVjlfK zd3srSw0(k}Cy(L{fnQPJmtxc3C?k<#)A#a%=wwq4M-=-qHikJs#8|wNcOuf4i4S$( zI$suk-#eLNus24|?7-;qEJ|orOF6T>%44OZs3<_(LT7gWQ}hjLJlSr|8-*t?o;fYw z&nZmKR*h>F-8D-M-Kp$u*Xhi?SjW#R6Q;Y4r)KPy?p|&)cdm4zCs&=C?p&rcWCuqx^|h=%H=GvB)?UyDr=Zm61rXpih9v!Gav-=r{53%I+6}>%kUNY%}bl^Z|W44!DZDwyla7{DH2pjysgzm z?e-`mlH&ROc|pY1^IidBIS)1I6prydcw*5gSantat5NTehz*_fUB%#1-nn)cgXfjO zWfg;s^h~4yYa7isZE~Me9zDhTi+MrZO5RWJ3C*;82QKj_zkGr027*yk>fBXoUdc

+RrY*GO}0C8&;xZ)g#yN}iJTA5(LX$y}^;?Z!*HT2B?WN6PUF_nptl_mE~$Uw-b6sy3Q zo)D+p!wvI4hB7)S-jwo!h*e2r_V(KT$dRQGOuXkz3oOK<6Yqq()?8h@6;7!N&#_8) zZ62q>wApDtO9y77uRQ6jY@C>=MOYUjtSPmSz*;gPPQfoKO@Qd>T6+5TyhiEHeN%<39)5|o%$@(KOoOc4+1b;{cRPgq zzbWI9;>BO&1re*=ck+UWm7gVI8I(TnT>o)jR|X_&*fbf(^i_s~;s znqIEWb*xYaql&iZC){&6mv`FTSE*-|!DZx_Kg7@V(G1gzj;ED}O)>9eUJ$Vcp2!O# zwgW6eH)RKQ-3%73Qp+Fn8f6X7xN3Op)a*z- zt5d@^y>@(R(545#Pp!4-sjXAv!m6BF-SS5XsB4t@*;#_gMR+MBQM3WAJjXCJt6r|Q zDq?J#hQ5RiNQ3Oc99=BBT&7EnE)BX|p^J-);rbiIPQKKmP?`YKcj)sr!TK>pfwNU~VVoGlCYT$3=xf+$W(jh(_it??5 zsDE2o{0uvdhNrm;wNj%R*cXAd-*5b`2I1x`gj%h z>#PcRiGPMGM!8C<1_X<^?Z-RCb-hMi#w_=|k*rtA$i_%`2M*3s zNy}eTZZ<`SpM`+i&tW+G=kQ-UDeTXnXvY35UHw5Z?X%9=CMG!Q;aEv}`S2X(Uvp8i zJ}f!r%;DaCLv;NY;`%vU7wymEdMU8KAbv34bwsST*{-8UEv_Z!(ch^x06}*ot_%y19@T!2Xs%CaPWI zxPsRb$++D0gyQ+bcyDj6(c~2hFqf0*t0LORV=5%_1K3GrQrdq7=w`_uahs-9zcy8E z;F$^os-sGg-d(Ak_vpdM)3!+isoIYoC#dj?_hxoQ3*@?2hiO-)Xv>}OENVRgt8w@iJ(Lng^dyg z?HDoqu$dg4VDX3P;^7Xo4|gCroJ8SZdy|80O?aRPN_d+d=ukV9LrEynG(tFuf^PGQ zFyi3|qt1C9ZXfP&*Wp4q(Qts&##n|Qp&s5QhvTwnxbQaFgvH}XJ4Q#67)b_2O&AI_ zdBVD8RDzga54J;jFbQSQF=}vc34x6Z{QmP?NwA{%hBHePv=QL;URiC@3GvkVjav9i ztk++H&l)118Jjs_+oXYeF|hwHS)L!_VwP}6_COj1+zrv)urLw08>Kt)BK8>mL&11d zu!#${Mg`lr;P$9sCl}lm6}*EB?uiN}xZu91;C?RH6BRtb1yfPMG#BiT3J!3=;i%vU z7aWZW-o*v)i3%R!g2$qQ<6Q7WRB)0Do{kDmaluSfaFz?sM+FzS;Mu6)IWBlUDtIp! zygw??xS&J@#CE$Z3L^j4^82hBEU_E-!_q6!F|2{V;R!r3N-@DRb?eFroCD1#R!`a= z0u%}a$<@Cm?!dDb+Y0IK#h^v4sI{nl4Ix#fDuUO*{veR>N5W%IXe4JJ6hC(I(e+q>6Xww0Fb=nL3ihX07yb47BB!(l%?}xc6YE3 z?(VF1cJa9LDY9LPEoRR;nyJ>6e_{e545{k{6*2S5AzBac2p|M@4qMyXui zPT7S*-7Pp?$3I$d^X-~bZ*@M?Ir}}GH#%{DtZ8p~Zo8RxI{qVQkuR02g{D*QyxQ?k zQ1e!~>ZRoOM?5FrD!cXI^U|Tx;nI;;JMq$(f2dV%RUPA%fAWgcYL)9n%WK)qmQ(0Z zQ?xv|=4=xP;Rc`RFjVOFlz+Hk1CCaw^knJL(gFXlgfinFtd{FeC)3W^e#~yQn&n)( zh1t<;4wMTXL4G7(wLK3H@%y2=T@$|@Ewmf@kDQ&q-E=mnP1`@xvWxVpQ#x5XQ+k|6 zEWOizfBJ^!G`+M}E^a#Ybkp%1yO}SgftTA(Gu_A+oAkSvE{cg}P12~5O&X_+2yxPU4-6)xB^@W+bRjvd6YSpGCw%iQ~mKEOw z4(QSNxzzLHXRWelHJy*P%T1?XwOp&&u3O8qS5{KiY{|*rjs9~c0h<$%W2lib-NndD%T6{R*KOQFP-+Ei2!0JKvuNoKT4TS|b?a%E63ia@N)L$P=9I2ME z7i=>jGcELi$cDdltW6#=f zn=vp-ov5Ff#o8*jO4c09k(9NtL8NbO+4UB2lw=vpt``FC;twzi*vqlnoETq^I@ zl#FAUmaDqCbj|j#`e_MFw(e%7*jt&OnOmGs)e5hyXS0$!#~`0uO}Ab&Y2~Rf(iEkf z=*DIboqTK*oqRXeX`7kp=iemDpl9g6X+S0<_Xx)^?3fO=WvB~Eg(w~Jv-g9@AUU53 z)3Slres3{_&kQ3b{~+)BvS;Qz#U&m8Feck>mOK9Cz2O($lz&u^ZZvsx42`8c(jWN8 z!I+KYL{doGj;;27{{+1tg(7%kXah0yB^8@M8yKRTyh}*8X=|ZJD-cpgG4iNpfv_(9 z1C0OoOmZ5ny!?`(ygbRu%SopW1-5BJo6J_r(6TfYYE5*E-ej?N)r{A-UV7}2N7m(J zERv#PA~C04B*`7fL`XR=B}5$yM)6+BL6+=kl6)34B2rjl4dw~bh8obFAn9wdSkh8b zob??s6uyXAmUX>cZ*T8zJZvKEZ60-C&(@-yr{0%Vch_~z&IcXS#x`wz(6LJPreoFJ zmbK%wteoT2Ejw3rXm4sbO`4(Q)OoXk;>{X9Z~>Ik_#b4g%?ogm;B9P6_StmuPI(ik z+Hjl#Y2f$_>LOIqRyp6U+D+<0>V%%&R3+2r;Zr3em+paYLW6lA_ zsh9Pd+pY`XHmri(vbk%w3i|241Bx|Iw_LZHbGOrF&ucqg`uT|$XtmGAzr8d0tQaI9s@0Z0<>s)y}GXD-yTf$w12XvKLe7`tJ0au0qE~hNK=0+WHb@v z)NTk;i0ObVfrV(4^j4tko5LWa)BJCs(H{V>nwnOO#n33`jo?mqfnH*|S3^XnrOLCs zdImXN+0(h6_MZr-Nutgmr|>(_Qz{}ob$^VVnFwlPHv~nSvmz&nh-eh`c7XY9Bf#uS zRJWeQS9h%ksO?%QM7vc2_CNy&Z~vQjx%V3ufhYEn6jG3+nsVCz%AW`FF=W7>kNH3# zEVDo`B{Ll!orH<^OPAoN$sYeHpnDGfQg#1p=84mVu!tU&(2CIQ^TX<8k=z76ev zFams}HA@~Ks~3D`1{3`5Org?dHgGK1z#DLO!aff-A3H=ntKbyMd9pQ;^if{H$2_bd3v;d6()QPo+Q;28YF#iYp{VwtY#9UBuRCA#x88yu+_4q zK5W2v`L3p~Na!wm2}q;zTUbu4>TgC^RYe8Qp#86N`_k_#zEgHUeNLLc%S93^)GNyN zve(o89`&ZN`JV(fzp)E!J_~IAPK5U0smi|-Sl38C*+acO=&Jk?!9)Ik9N&AJYN)x@ znaZC;fI`v0bAaZX5!&~KdLhJMcg0=$h~Qt{tDXfS18Yj<6ztd%kx%wYhg({L`+Z&l zQ*Xi7!z>L-yXyVgx;6ChI!N#Ys@0Pt#wC44t!Nx@9*@voujt@Cqw>8Vjmq~CeP9Ho zJ`tr0xiR?5z8civ=7<}BYXSid2&6fT2#Z`fk6*|)P~Ps84#Pj%-k@LoM^lWHuVP~| z{TruDZO(t1T|ARXY2jh7L(<(y3OpMwpLem#XL1_*Nq6u@&~k_ihAN+>jgyoNMelGTJ!o%BIGlbHTs9+Z6e0BRK6qlf*o0j z;j=h#9XmKS`KD8)Em(ou`&h$O6mU7gC{f|c1z#{+X~6ZhUhHat`OyHYgwS@qA-o}u zwGJ;50qnUOtu4erDad2-iPVd!sk3_fHx4&4M2X$^a;9DyK~3pR{)k){LIE&DRO5a_ zz_=&1{B46qHssgfHXxeUfNG#Okc$4TdxbScFW)+1RSd{SHpK+Kk0&tL1*+umpuQ|g z3|%(r==2cCWr4`SV$GDx2tTWAj(}TA&5GB>3*Bn>^+BsoF?+RKbtmaHoP2qsoHyl+ zI$My(FIGVGS-u6$J4Dpi_ONrc_Iui=7BoLkI671L>k&|@w#M^l|I-oL)7BVTg2Ag? znM0p`4Dmt~?}hNUPUSKIceru||5UEhh}b@{XH|NH+$6Ygi0a*5FCt*_+zVX`nT$p}02$)`*5!^{*2J3<)5_T3 zo`wc0mjB}3^1{U-yf6t~U@OJ=4OTB;-58(d*ogJwYvqQOEaa^L4E7=Xx41YrM+|0t zw}k+1YkPCUO0KWRVl&n_ab$X&VhjsTlOr*t{coK5OWsP|8rS-ZY~_{QcC~=`jjb5R zmvCGOn6}V{g(7U7kW71@(Z#&ehiUIQ7~M=eXt)s54r~az{pJX|?Pl7Zp7wxgyGb)( z+TZWPv_z@K+zfW+H<*n0DjL&Hqy2vqqx9@ehVkzMT}-ilHyqKs-z@A|*OD9;)G@+8 zW^}DcW-Q=tjY2lyzU#nnsZD|lap{$Ja65?6$EHn#GX16BYIE{ScY`bi^u;@sKs|Gu zj4($sn~OO{qn}sM{&a+XNy|DlqFsLj1dSjmRI4d#_d>8r3c}jXSQ>Tw7hw1fvGSU} zj!4n2mgx{ndi^2O)pw4Vv!W~6`)U7FpPfSY+5dGv=wf<%Q2-uQ8;1|!zc9q--(E({8#_hTIRd@X?&t3g8>7LRGRali=~ zXHe`qLRUo!hKMZe6TDfwuiytvI2H_R(2wyD*#ClHNp0Gg-xCBYetG-A)iNL&(g+ZK zaRh5Ay&~L;X|;G(1wsv_jX-OVXgTeFt2LZdjA@K)8lZbHo0x}zIkf+*Sf0Up#ryA; zOpSx<^qu!5Nlx$D-!`%@MIuiNPPO{8nZ_^6+20sJ41_=0f4?U1cG`dYKrYoi4{H?k z6>ZH(zxi?m7)g5m%7}LTMJA0PsA4!oG{UDbLNsGHn`A1#0xdRVit!I|o@wXW0YYvc zqs&~FFX4o+TqczP+{hP^HckDe+gZ?SX(x;J5P!j`IcL+Ux(&)ORzduVrux1MPU)4g zgKP>rLjUZ_7jQ86f^F{C!h2TS*tC9Nw(26+gIxJ62CtM`*lb{6Z@6BW%!x>*tLLk2 zWJ`1AotJNx8!gUYC^#E-yV{E7-TFqk*hUHprNokJ`0O+iT48#%^4z%+YyFL}DLlp* zTA)R%e&7F)04AlzY5#-w2q1&U@7WOGvv-0lKnhy=P3(4w6yYXzv$A@2EE}I?Cb(ae1d(e}X zE%SthGnLs0NK;5&M*DA%(7rE{2e0E0nXV*xk33rh5%;JXraXIqhHXPjd4N##vDDpj zUxOmjzP9ebwV_3UKcXRMtu%txlt$gRr#-OLz0hSu4s`AUgSA`py7+1^7Z9l{Mq9z; z*GEjA+7qL_igp9c>;3~Y7Ka(3$C4V5#2tFOy3MHF-Y#JsZQM>bYX=X}|4>YVUFkC6GnsKD zs|FUaerB$MvuVUT4Yd?Su_6kIrH@^=@8jS+HU&Q!=Dt8lH6H?Ve+NhE#-zzbMa1llJu?x?6;2S zNzvz-LFPw5u4$AH*cV37A}t_^$w_Vp-rED?qv$Id(PS}pG6IYwa>vmwD$(=}YNo*y zk#rdVPXTetE~g5v86m{x>%eShn-vdY=(#887KS#B0{=Z6t~`bCWDzKwWTzbBT9af( zNXkHAZFqc^qm~g_tUll{6k%sGB8z*0=&D~cBJB4J2QQza`ZY+ju@H!jP?Nmlc?g0D zC~a7qKsHxgTA4GITChM-1A;5T7i^r&fo1jHb8bypA*q_l2G#1a^LeMy@~qYt(v1*F z&J|ENQAlJ7O)J3f=vzIZH^hWq55S8uA$4Rc02OLtVHspvCq9gVeeJsR#yN!qTz2(h z)k%7yQp?TR%RDVB{>sbN=6Q;2=Bj9U)F4FKl;_r9W6j4l?PeK;(L5`@nz`wv7wU6P z)eD9A-TSdl`}cGVy*i&3tMeoHXIRLcxjAiMP5cP$NzQySSal-GZlmCt8RWq=khj*Z z&$1$wM}A)pLHa0z$>i&xrXFyIM8BMi8h@zMNA3nS+@1R!H__(P2SKS#OhbIMjl%N@8Oj2DZnz@)YF*}kX zDa#Tw_c$%GfU1NAXB)q_NitaLIgSb9N?eE#-P+npm0Di4oJ+aQA{AOiLPM^+jfb@= zYx~$>V(a`YFs+RINYJKU#5d~{=p=Cf=+_#N_!DdQZ)5LD6O5x`aQ= z-K`2>{^baiQ+ty3zfCA-i5K48K8ZT3-4Y4T+?I{p1FHttZaGPc2eJ^Lryv08WZSw0VvKzWRmv_ zCP_+B5RFsFRt2!)2?Bv7akTeXbk2U{RiqKwk% zR3yRntZ#h$$ChVSSHJP`FDRceHvZV#C z#n@1mj;eVn`Z-9`)MK-fv=w3HNJ*k`a7aGwzb6uw0*Z>*zRyeslZLsawz>&oh>9PZ zMP2cli_^GFoeosz%4Z3QqNIb_Dwu?5fXX%zkfqpS3xItlLVIG1AEEIF?DdCM>CTCs zeYWzqG{mxj2A1EQsr*8O!4YiR#(Bed^3i@|)+ zUt|&?_7j=6ehQgIZZQtC7)xBlL@NO9Gf_svM#~syhW4HEK*@4GQmLG2(Ba{dzG=>92P63rMIu1V0phuBxr5|It}J=b8QtV z_Z4!y9sF4Ysw9^*jmX=c1JF?X#YPw`EgZC4MqC<1zoZ zyqYMBt7`JMjcXqKhTfDdi??Ky%)@SMncHk^(mFRadGXxTi`Kad7bY&ec+r|jO-xLk zrxzD4Or5_lX`R3D;<@K1&*R19i!WZl3x4qYIqUiJ=gv*y%j9HgV(Nt#6ye?ffrG_o z`ra5p-~QNktvcnPw>wok zcF(Y57hYFk_3v%gonF%A&L!vQkld2@u&eg`G+l4R`4^73EsR|-%7LnuB3k1BeUETi~+{{C7P)Nt# ziN(jqTWyr5Ows|p=~kh+ZF;EdDj#RvI{9pHRaD?>=AeIj(=J!(zK@vcaZPk7YuXNQ z)^b{T;l`r#{r5cZNo%qHFaQH0`Qd;_gqz*4H9Q$wAw|N+yH-xmiCO)}(BmlAFo{eW znbpn1V&Qc+zIrkoz7yS~qJWDra7;hCONQ)k?iRB7y&=DVm;F8Jun%6eFzodkn_Jai z#+OPg0QWtX6&<2=>$h=^G%iS^3+0xZF7DR>hYOP``4(_YBG>6c=JFEkbVWKy;gBWH zh$=LKL_({SR^E$^rp@=fvA?y6BNxtiBwK3sZE+SAVg*71HYsw)mK;=H!i7Ju-@>Qi zmFcRVxDrb1>&c{8?m{CA2-epVsQ#>;*&FiNN00-TRDvcOH0^#Iv}Vs1e*mDfB=kf# zqFRmcJizrrS2*ENixPM^Qd)srN+Xg7c*0T8b6V`Ck&=?cXNwMiRO3eZZBSj85}3qE zlBPL6K9iY)EJVg0x1qjq#0{nnRPpY})p>ENo`Vx?wZM1y!8ppnC<8DqOxtn22k>nQ z`-|MO$Sg+Uh8Tn-Jb8rn~UzFa5SJJW9ZX;1Mr$XAIB(+$}r@ z5|5Z>n*)iDu-ztvAzYFgmW2wYCwgD?Ky~!!=*_(gOWjaaj^O)#XzBv07f}XKeNpv} z-2x>{OXl*aC;ebM)n_kI_&N!EnF6E-UCG@-X5Q^kaj^*p07cv2KaKXkCM3(i&E5Z{ zJ=nwcU<12@-Aiv?{@;BQPJ*e14k919m%wWpyvO5!)~+*w8@uHZslX@(IRJG=1H_W; zMg*py1A^@Pw7(od8`>2yX@KrQ-vQ*&IQGZT{%Qn_kl$#2M7#dZA{s%+gy9g;2w#Eh zh-PKzKNiU!R3Q=Tq{tGs#`AX;7rBdy+YZ;jcGeD>{NGpBit)r zAYeJu_q6}k0UaA$H?Rqy{|P2?qdJD6(kY0PbO}^C@j{Qlg63zqr{RV&QdZ=Ms07z< zroqDWe;s^3oVnEc{57=yd<3|N89Rj30U-ox^>~T;uO2UKq}BTh4b-!Gy&Y@Z1`8Z& z0+_$Xa~rUF5~A?x@e4fyuiih8fF)WzIpQ6!p7=i6>irbP`*H-hMy=j^*N{Nd&nzm~ zk1eF@>me@t@5Va4V{jK5k^Zn&n9J|=uGTT)emT5arX%u+?v~f*k0aoL)<=%feQ%l4 zZNZ$IQm*5%hW3+&iW8E=}i0`AV(ibtew?=?#)GEC) z>#`pKky1t6^X-*i8^SQ6QI;BIYdLU^Fm@Tog_rNDJ6;P?+~ZNZ(JQr!Z-BbXy=1{B z>#`_ZLJ^? zOI`-A*0ArpK4L301S9(=*>zn`NF0ciKiQg-W0lMp~2E=Zh?(L_@S zc1o744@=YftFff;re-(u8`et;ndKX6Ss43Y!EhT1et-xnRAtIsb$S*jEXo`)1?zd{)X_a@Bcvfio@a8_^UtB%_$ z7aV0ZhbbR^cr)fpyAf3|n-`0%z>kURJrGZ>P9D=;mjhcnRMbJ6s^{<>pSFhW#?(oKwP3}eT=WM zNOFPN?iJJv7@EhDh~5kO!iT*J{JOZ?A;JG#d?VDw)piYeiQ+4A2lKruxUs2RElgYT zUI?tC_#FLf;s|IX)TcOfh?Z#_1BqDV2w3HM3pcjlNs_!Lxao>dG%^m6Z_tayK`lldo$glUd4Uvdb$=vmppFA}G7|#pMBj)VIUZ0hu8=HXW^}UWTPN|J@|Ntn zu(PC`x$7(m8-FlYc;l^ zOngNsTV9yGmR(wzn_meHFpFSRJE>C(ka5Uy3meFe#phu07J?u|kO5GSs)g3#_r7uV7CxA zFe65e3C6Frg^Q;Ph@zPlq>WixjCR=rDOxD`W%9Z&wCi(2*rO--U1~lQ$ zRm2Mfin!ZH7*Bx1mQxNu7b6Ky0n;z$`XBiM5peFj760J;YWjm$R?p(n)ub}YWLveI z;`n)Gs1f@_7&I<8XfYiKl7SYtLHhZxZ zO#JUMSf-qB;j-C$)Ae9Vs!|vnC=Ts&xIYO-Ch?^xk=>xk=_Ue;`ay;(mkKDP&<7G= zB5PNRE{s;Cn)SNyy%3!wKr-G=J-pd0I<1l`QpDh@$rFLf*aZ*>B8qVql#~{5M0~bn zS8LEb5I%$ksf1EH7HNt&A|_DHZSn;OR7t8B*sbs2a&b>_KjsBHnK1zkX)Lx##L8NY zh^1&Fh``u(f@KfhhOr%x0m>s|LWmro@PcMJhiif)cJapA z%-X_IW)=K(B{Q>jV`Vi<=dh)ZNx-N3%jIB;jJD3l|c{da>A(@jr8H2hR zZVu1V;$wmJV$zVIveMp)tS+Gli_bM=i1Y*ADNGUAM_>$;H;55ng@`0zV31G|z6Q4O zKvWdV^+YdtgrvZ(q9KtLdHR83QFCcG(wK@%GW9GKUcd(OJ%zL3*7+E=yp*9c7(+|{ z>VrfuTY(+M-!gQ8DhYxN<*5K?aeRLkI~H9KZsn@D(z9B|Ntv=LMHL$pNg0Hy6OL+d zx#QQ{#jJyr$;Fw=*`>_sR&nkvMV(5q>gKS+YQDd6ed*H7_0Wd+AeTnMIE3+wsC{7Bm;92`u)T^ojhWRCJc#8mr!nJ| zZaa1RwX*dAXA3hJB!J}vHs~;fokXs~<%P_Ho<-F!$}yBXg>4lE>ITB^w4%cg%Sdy`49-s^pYK11goPML@;jiWB8)KrzK~nZEL-oh zgc=~;Q=*5njq?~8V4**D&4oUiU0PjSm`$(EUYQv-wL;FT!)*X#2~-{`Q5w*Q{3S#x zsD%U1R{&Prus(1;52d(dmez2>mhEP7uD)qE;|fG^!akdxb7vPBzO;aq!GsTB+6pZI z;B&Ugt_`3RK%@c5hx$MYn}XRxY(`Z`-}T!L$IIlDG~tkBNqc@^0pYYIE6$z5RwPSJP|(fG3verfhK*IoW@fTDD+>rjjJkvXTF$N@ zkTVZ6f`X(Ql*?7uMwU@vd69syEzqsXR40&5W^HBZ`W~P|b{rKU3J!@91;^eYr9V7_ zumb54eNVnA*!E#_Sl6fkEA)i~zM%760uIYjM5q--LQD|ciXtH>qC&21ks{H~ zipxHC3G=Ryt-uB&)$Hv6Y(n_Vtwtx3`&AT5grXsL4JR1?Q7Un&g9tDX2O9 zKAW%GpkWFVna#|Erm!k@FL0JF!edkhlJ$6C)9hCtj_iG?PSng6sq)+PB?PHlnd!qx z*WIEhUzF7LMWQ3&45Na;Tsw|-WD^eR)k{<8Ac6|O=In4WxFdBj003GK99aT{t4oV> z^I^-$E`Ts}DD>*|4vat!9vPU;!i?Ii+VF=%sRDkpOE>3NuFt?BKD!peHPy=sEUofG z*w$NH4lJPE>RV3}gqK|c8fq_b;aAPCu6=w8VmR`T z;67*c0EkR?S0aRle92{xOC2%pq86*pGteO<-gM~0Nw{}r3UIXnsw-6>C)8q!TGZ&u zTATX52?lD08l6LPII%o9s24by~?bnFEz2Ip|>y6TNn3>rdME#Z`VQ%CMVEh-g6rzyV&;9t1U2h zz7%doh@9UE13gLjyGj8jM0pt}e>?mwVeeYGPEf9NP-BzC1fq`poUn#mxQh*2;7}C6kpsqOGe{0+({AchERutS)NuT^mdBSh5)#7 z1C|}oRtAeh=cm;jcx}R1o+9*7bGVkBKC3WASX{2cjbn$0BJ{zTLLT}sm{Wv6#E*oR zev0t7>Ta~GwX)~6`+Q1hTqBQmpZO6I*GfCkn8E-N4)Lzp55cH!^RjgVJk;mIbA+^; z?dqnTzG=hp7oMw@G7}WO0e07-f&@4Jm6drh;vBJjV`X9OLm?oQ6COTUGnXc=Wak9a zD~itPAv0JTV-S%-AqTm>v@jQ85b;g8%Y4IY!h6lfqS@uumF&v=^3qCJ+|xUy)3FCJ ze&w}tqk%2`1FK6JpoAaFGA>*W<~iy*^%A5syt6?Z=PRiSLNimv*Pg>S`cN++fS5yw zM;Xq$=R7zYUAK^yiiV6g0HzTIHwFKqJeZ1qu82G>O8Fv(Aj2YbJE|E-im#~0-{&Ud zns+;&PpeKff`Zd0Rr{l(v5fcN0k7l8ZH60h`9OL=wh<2IVYLH$+F5O{2$W(&kLOV^ zDbAj-UPl~H0&zSE5nePu7YKW_-r#^d^SC2}1H@KNFW5$*OFrL5xe?MfI4o91c&@G9WI_UPf;zLXmDe2Wb*XP8 z5G>lRLJLY%5GRgpJh6eG8iemq>;)AYN^oT=)E!E+Q6>_%#pGSD<|a@v+NmcRHWn-4 zVQcb8@+J`Yh&0CS#10g+@T%V|du_;a$t41gIQ;X?+jQL!i3SNGND%k#fQ9PCY|9PX zapqjgiL|&4d(5E;Bd!<(MSMoVItYPVn&qeyi3d5TFTwRj*g!!h8E}l)_GXh#k0_r>T9k+sW)`-qB94VkT&U>zA-9c4jyh2{4$b87 zC&g2Yh$#e?FsO>K|M2QTjKJ2%mvOX8IM-s0ihbZmH+*mvTp)fD;}bs@n|2N2NHviG zN2F9>z!q?iIBK>@nIBWk{zkjbfk#-m;2?!yVG(l(mSVw#LxkHdmMG+rq!5KVB0{W& zQZDcoK~oh$gWx40W7a4j8PWm~Q8v*;F4RQ|k?=VTE<2J2@xs)OzvP#gBBf<%pJ*>^>HZX4>TZ0Sh zINRVXY$04W48PW(V-WC6Wr#&Bm12&CunywXJQ}g!Kk2Lem>j=(1b@1l|qjxspA_7b+t7TM3**w5P7&)OhOkaiX1<48GcnwR9G z{j3d^IX7idu>Gu!{j3eO|4N4(_9jZ1(YY65liJVP&>6?j0rs;tINxJGYhyoaL&yjD zb8$aw1Fq5itPMIq?q_ZEu{Q2!ZD_CRe%1yG_>(a}r_81tPSN-MAe4SWUh?MOGUhKm5D;O2PA77Sw0*wFH7rgp@y(=&x99~Mnk0YQ8Ey|qdG%Y ze0==M%53S}3%HS*%i5-_1uD|yxtwH13I52Dp|ly?)-CQ@5hs1l`9cyQGQCkzTqH3f z!v+P75iW-GuNjp9M+q}FI;-Mdz&z@ei`&~_pF>m14?~Gxne>ESkpIgyA#rz0-1tZL_Z%c-=}U6t-@xvV2e+kUN>68i;{|n5 ziXYR+Rd===Rp{1T@dE$Mhy|v**ssdbFve*=v$xBo!P)bk`{C#f14jX&C>$LYl%qjn z4E=Hh4AJGEv>uG1fAr=iyg&f>Z}N%sS$}=wQt92Vc1rKT|Hc(b^2Wo(jYsjRx{Rpz z5~6<%`PJA#sq=c*Wi)&*4Q?dDxh}YDXmHw7&l`PPj5rgDzf-eIGjqW?QB?_>TMizn zvRyZ4F5?-Mb<(w>)(|@tzUD^URD&0ypbhelx+kH8L^=dV3T=@%AB@cfN?r_lqS83# zq|!rrLfcf!+YGvrbqjE(kA5U7227>sl9cXLaXb+D>LQQ4-^~O4Z+|eJ;z|Z|)01?n z@)h?Nn6_C|-$x$qpRWZDBpb{1-x?v;2dOrT^=|Q?bsN9EMp@o!Yv){Z?Ebv-i=0`? z)`nKlowZBJ+^_-gZ9z~HVp>Ts($Rx!4fNJ7H)5?SjPJ`&E!3U4jM@r91O~eL0|Fp!T+aT! zU7$dzanD6WnkHqI2eB9}{P3$uNzXgX?Vt(I?+wm1b?s4y0gTZI@)Jamk42a~-GKRL z0WZ=ik4_z$Twjm0RvRcZQpgRW+89x-dD0q4wcL;Gm2$4#EcD(x>_2c=Od_7zJz^9s zry|g@fzck4o{X@nMAAt`(hDJyzT*YaWW9%-2CzmW?e8bjJ{tiEqe%O^BdwrNk*#>D zl`EfRk$kBr>r}yp5Mv7i7cN1G)e@Bfp_(S<^>QSpQHv;F=9(c?^$B$~b~>N^Kh`7s zA8inZy76G461$Z?P@lgO94R`Vh(PCE=7w;II ziZ3oi;EV8b^f1R?j6fO09Iq?pc-3Hzd$5|CWA5=l!JMM8(Wi)wwjv;F6dV0u^mT_J z1ZEZ9EM{@{G1ZxM3RELz3UBB-a8&-H+Qqx%r&zFg^z0cA8)zoGMAMU)+!fjspG47< zj1PMlx!AO_j+kHPu=sOf_X(_ ztsf=U`f3D(jbg268j-$$*0@|XDtl3BR8;+>nyD18!;#|h@?M-{V!CgAW31Q9RSz?m zCPV#&NDQT?973mJs+S@#)xd6g80!xs&q9vvxvq<9b%*Z z8Ua0{*ytmX)?F5n?orxAE$TwM)}TGcv||ygpj>J%Gu->ZOp;FRZfc5vqgbFNK6=RY z%&})?}G_&#ge!!DO1&=*PfR}{N^4AT8Ul7wcz2MtMpm1ykz1!Cvv2?f^K!h?w6I%Gydc130-#I$@oWQL2R$% zKZ%gfcB_n&AMS&vO|#JP58vd2Ugt9%=@>nk@yBF@o!i9sV^lI6kk=ac-ans0UdlOpUOt9v=by>$Gid*1YPQTcH& zm48C?YkYlU?Q-%W#_xX7^RfQ~&A|hrNx}8cBAk;jQZ8g+NZTlHcS?u-6L!1hX7wZgu`-D2IO%EFWw{bNEz}8q z!2WYYVbYV6{DiknT7Lbg;W_Pso87JvNj-sz@3?~r1`BxJ<(Et)`Brulew-GQ=*euM z?9pWh9H528$oNMTLzLduLIF=qQPZvHyp51p6B~GJ)v-t zEYY@asoO=iwzd$4M)7GWw^>XVoXs>^dg+e;7W#sEq%X3#j|W(80jo#xJo)Uzd7$M) zb0d%Hy5=zSL=W>$HB8HO!KG!VwZX$s5CVo6gJJ>}D6~qQYe)U3K~S}9z*|ATS-zX1 z^GW|SLxYf9*f?>l1jP}K3LxZTO?xZ&6O8wSw}ar|?QE%BELHJ8$n+qtZvs_6?%^hi zR`#Q9u&;+NPx0U4&urC2RGh%z)A^E3p%G3~uoYH}VYu;`*0L%%sX9^aytU zB#6XCi3VH<67c_1BoVxJuDjh6xP<_Bhj^_Wj8$@+7J7S29yej!&N?;RHIc>rS8UiN z_zpPr%?=#r{!t+bz)psFW|S`I8t3RMCP!1a5Hghu3+7HVN}--L7GJ zc#PgQf3JBm9_wm0rbgxdpX%zLw_Dm* z-qPEbeDjDOgXGHN8e7n9$3F&#Fs`%VYim0Gky-itGeG<&Ix8e4>?Q;PNWz2Aqygil zF>G3VUxj+CH_}5Q6#&i12rgMYUR6I*qUlrlatfdyYuh1;_`3n zob=J1_FvgW7vK2!Pv*bz@xRj5O`ukCP|p7*5*rbe^D-2xKOWJ}KO}e9NBx6Ds}LV_ ztq<*bN?n0KA${c9W6)bF{|o)0TOv6_^O-|1@E_rgiqLxa@%OgJqv7u@Bie=VS9uCw ojKChTse!!@Lml;>3N}yv)I+P(`$7(MTf21ZFcVz>#Sbypr^L1tl#Ff4s{!QTmxl8Hn*+J z>l$z@?&|C`^ts&PpxN!QIs3&Pm$T2-KjbzOoY-e`SUjS|+2iW9^orXNz|hsv+OjGP zbgha?fTa$zvtNN0Z648Su^_Wi>~M)Tr^jn{I7$p2+rXe>r|2GXie9Tl>~lFBuI-Ze zfdR9#w>J2iaFMY>I3JysG1kE0{lj~QZyheMYW$pF`d0|7>DDE%S~uHTam~&cw#IB8 zwx;-}M0zny=GZqV%nOO-dA_kP{93oAZ^&&M_Ge5Mg5e=+k=0Eq4|Stp@#*Yrl^;w6l`~5lN_#!fK z#yF(r8z)hiCIqtZo2B9~xe0QvRKQ|QJp6|vqju_`ZBWi-k#v`n=BqE1RJCdm=3#V0 zCS*9%4Auv&8P;NJX7f~7s+rE>V4Y?Z+O=NxPp~>e)I5*G&j#Pu_Oi5RCy3A**shz0 zEP3#TuA03@83@(-Y0>E7TG+fK3-;=BG?Z4)!s(0xmISZr&uT7V`ywoJl}@pKEa7q` zQtx}i5XC(3X8egLdoqIyrYtDe>)_rg8Eij{Oqr`gAbSE;ozJE;N8uBcw-o7SVrMLM zZcWJ5*bVe_C7~NGC466RufY~&6!@opSGZnX0L=PB1qSSn8BK9??&nFkO60> z9v6`V^p)GhCmnuS%g9dab0x+cnNeGUjG5F@LpM{x;rXytEEE<9aJQJJUm&s8D6B?goj);ae$ErI zN!@D_)gbpH?aPs@MUHy9G<1&!EaO0%Mg7PM^_>=Q=kZC+fSo~_7}*L z)}ruGku5r+$x&Fe46?5jz^>e~>Go*k!0{74aAv|!ay={+%JOd2AC>F_0Z!MIPd!X6 z9%DYj=0a!Pjrs>9lKVMH@ySS%D)hZ(0^bKy7JbBoX9O@T`L^%^Sv7}RI0&`XsPvQE z&SE+8PecIAk(Xn-;Z76+dzLQK7!0MN2zM5x#EPO=SzcLQQBgS;ww5i(UtpA*MsNQv zzDPil0`uUY+qFZiSkTyA$a#JBV|nYcILf$e)yM|P#?@M0FAKoE^j`ftl1tu}FP47lvLG zm*mBAop8ReUnX<1;O&MfaG)ev7wX3vRZ^F)_(!QMpK^0)(P0Qv+|igC%RNnipGv`A zgpU_^u$4mjq2wz*+Rm>~{Zf~z2;%WmkgL%prHVCmxf79vc>=zu4+9SIS{h{2-!2O? zJufO`dQQ063t(xZW*pPSC_YU@m|hLsbjlVoU5w&+z7!ub2wN>Q;ig||d|zm#*R!-Y zAZ2qDOlisx@Lx&O-9k6Lm_scZG0X9NBS%t(`G;Rq8OZN%^2(qTadnVMizlf@KD2U> zRlv;V-S``5F4y@b`#kVU^RRG~gi6)xd#h&R3^N-pESRm%Fn)NWIu{wgtS*YJKOPiR-7;1?pjH4+8SwH9SfR7Q#8qyR$OhOt$!3hrRpFl~0Z?hEt_ zl3jt53k#tuA-X03Tc1&ZWG`_Q?aHMHIIdy zm9vzYSBG*`JLLKsyt^Qg>FVfRy1f<|a&h8?$5uqMD&kghQ5Ow~2aDP$uJ-5ABa_8* zjK^BXjb~{3{(o9D4WZ(gZtp~wmtIZ1+$hB{qG&9jqG3?#f5uxcAH#Bg# zbdFjPCoY@`#@AJ{KTqLQ%|D3dFTI+Yd0-s#dCfFb$Tjl-nqQW+j}wlwpp!;8mQ3~p z<)MZu=A#hbl*t~2;--7pOT2e8@1+#qgijBXAC=nk_o!_4#49Oc*cT0t&fO=x7Y&v3 z=CKb6l9y)eI6QAL^}jl=7J62RH2&o`^X7ZmdpvfX1c6WL!06xuWAQ{~hk`AShjA;1 zWVN}f7zcV=bAy4GSZNLPYE2e)4w};8`5GY}jW*ANS=Fid zw6HoaR4%Gu)RfKlOoysdLnVV(_gJM`lxpD3YT}P5@7RlT(yVS&zL1NVFkHK83XoaS zv7A4ZKzeO9sZpDsSfOrqX{%|!85PPGZqmTrwJYf#3eogo|2phf!?=djo;ZxeP)NM$ zf_RPwm$wB=?Gu+LzXlI^+}`2lsIZAg4oqlM)D1CpH;kPfTEO16m(9gFA`1+woAp0N zf1m>Qk;L+;C#a=P4mLQx`gUDVB6%F9uA85~1&L*<$qM0U`xZFg{;#^9OUy5$52zGt z29W;+a*tBTM3toToe5Usk zNV@$XanOcWy8~MXIKL7wt#;CYk%1?I8C`KK>3+qq(81XV)S8XLDUMEuH}?DCPP19K zUyHlPxdqL)5NjxxCd_o$NjlY_+__gpwF2>%W1`CoDc+V8_Y+4C){0U(9X@@6Wg9N%U#ZXU$<7 z!{0q_?M^Boy?AOW5u9yX%$%H#0$36gJY-wJ#v}Z9do|k|PFTNX6W0!7o!EREDXhfW z`cUw)LtyMKq|csiecJjAo%YIye}1Bc2B(+Vc-8y0bF=ce~kb5xa++y$%Z=kO$BG%^rl{MV*f52VFL&7wOz|eD8Ep7oFjg z5{B(A_m)1~i{NQLc763Op@jGb%w8{|4$*zXSFRHx&zXIZ*9j$f6=CkCD+!W_y17wL zgDl2^S~`aYy0O>QC%Ojd2E!w|Eela3JsPUla=)QQsO5j3*!J+uR^9(+Kn@3%QW5K1 zeKVz{T%9JF)0ARGN1H`OO)YJ$?H$WZ9Ysa8;tI&wp05|TncX(C(`$g$+fx$wdc3I* z$0}YO+C0#;yF3=Fn8ShP$bhGn$9C6&X()+kVb4%vl7HRTgX%&T)zK&sr&M@t+bp75G5lkg=1jtbR_00m8i6-%ErE}A*?y5ZQD$PAeFQWU^4M--oCfR@x!xu5M0rAPFUYC^_G3?w; z@$ds3Ljx{%smqDC%Vww9vD1TT6q*WnYI$uvTSS+$%+=S&6VEl|p<8aR#Z42Lr^jlc zX_IC*%Z?rg&QW*^j`zeN#useh7`) za3{o#^@1Rxb;?iY5s6)^0kz%(s z6g$m*7`uUpv0*+H)ovtEfR7ieN^K<&RWT7<1sgPc) zc2Ij6cAzpxrSj0E3`V^oO!j?DNV>|;7cIxh3FWkC31Ou8b+UdcX;>epr0T1A03Yup zw<+7W%Q3W#^G&qxrgE*$TVW}AM~e$r&%G9}+2+6nZ?_9aHLVyeJIp;^(P{P$;cF}f z)Ym1iIr(QY26?T?KefRxZ3cV#eQu-MV(vxaURRIDXmgcWoMp5U^?1v8#V}gE1CCsz zbeBeemC`pibYo*wTwZ()n#u0+;ny+O#D{Kqky0{zQ>3n%dcNM`NP~Ufz+yQ|rbjqL z_O5Ih8a4p|n()s&2hG+j*tu^8oyYkiX_c(Pm0BZxi6TWSQuk|AT{+<+|M3+!Gb+l) zYWN)t_bwd8JH=9~xG|K1o5j*no?e|e(!?fH+uDv!oSH;fdT1IPKQv<%zVEj< zaSPIk6O?738|O)}vEJ0$Qs233&6@g_>sQ@~BoqK~d8?_Rsj;)6X;nRTdCd69mZj6y zE3R4A(zdF;vuQ=}56{^dohMZ}kXWJcRi{$ZK4 zOo8`Dtck6B2WNJOW_SP4fW_$zKJz=H0OxqFJy4@Ee@Lm-OKO zEEejHeh0sUs~E0_;+G+K@Mrj$%BDY_3Z}i^&Tv6fiq&O{#a#-o{N!m?3X4B{5*9rd zQ}wqb`CF1qk|Zw*OixF_DPs?$9>XFustYbXj|W-_dOU7RgAGK>i)r{ zy_f-2pB;k_K8>02f2+d-!U`UX8DnD6k}f$dm~qL*gmyI;8`WU6!zY&uSv&c-vNY1i z6Mjl0PbB`{zy*QLhS{GlNt7mDbqT1xQn$`KKKBYfE}C!qZov%Tb6pL%zNm>)<~xm_ zcko@`EqYv{73x~bNww|7n^Pcft8pj2SZfjoh&7w!$IS4rv}=jthE>*K5U zlu^s7SV;C}EsGDFjA0GJIW9&^V$SFTi8}Uk;Yx1r%7OFo?6{C_pn=Q-IKvPM;JUz_ z@oaq{C4pIl83rk0wS=Ec#OiI%1Zw|2f&C_SLxJu8X^UlP#z6K| zRu;G?ku4GyhomhcX|-1+Eg_lxED)c}&Z0%XPG(008<)X-Z!tV|bQ+t+1WO2a3E`SK zuChDu>S=c{pI={on?A9a02vl<$XVoBbI6 zSVyfN*bfotLHfA|ZvpIg(a$IJ8OH_sIZDkV^m7W&G3*c1&j+~Nv;PbI{_UPu=Y#!(<&bad;DlHgQ;!-A9-vj%VUnCXQnovWmpX6^pZeU@hTVSwEIk zqVE$WmFSxwNhP|Zl~ke&3`r&0Dsh!?ULd{V`&=%s)8(~v;>Yczn?G`G{{eDQm{v$O2XDgkBf z!Go{|VMmYl;9npC!Gn7DB#3{5`X6}o%_MCjlBg(N9?P5ezW2TNzJ1?bm|sNZ;mp(e z#>>p55}L2pcD7M~eHI8wvUN$0#pAx@eyI`N%A1C<2C)8wr9@i+KWjf+N;J zHqtn@XS;n)d9Fx=@cBli(xrlg&2o$NDx7xjVz1Kjd9a4=fgjbXSGNHwU}2YN$VQ`7 zQtx+$gc^+;^97BVS4KAo<&fpNK$eHDK-7b(ZQQ0UTL7aj4tg#HjvTiHWu9WCSgIPi zAzT?*OknWZ0x=aySm?G9!2t#|KNLCvsQOTX1Lo$=mW4Vraz{zf7z>38Z1#1-Wj(SY z%&h!peN+B=);n{6Q**b#)V8p@|c#k@FeIkMn-61@*u56ipD+6g?g6BK`+dn}4tUDOB}b z6T5KUtR^3>EuWoNe{N}XN^EilZppd2jJ11oVUo9nmBE$Gddj>o*t@=$j*g@a!&y)! zffM6AQRWrw%o!+?RSz>@!g$WJdsy^+%#|=4m1pT3OUGL})(QzyuL_VXXf*P82=z=M UD=6o+(sR7nVN7^~H?@oAcdxO$6#xJL literal 20984 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 WC-Y_|290hOQFTeZHPX8Xxc)DDx9Ic$ diff --git a/docs/_build/doctrees/output.doctree b/docs/_build/doctrees/output.doctree index b942917a7e16923c7ddda14bf7311c6044a701ff..cc3883336b1c41c3e575e3277720b7919808962e 100644 GIT binary patch delta 32371 zcmeHwcX(7q_rEhFo4XrA5_(8THVLFxQs{vI0YXS23B806Hf0G(NTEs-1%*f(U@TNo z0qI6uQ92f|P%MCo0%Ac$ith^+RDS2oY{{lv^!t9_KYq{i^?6+Gy>mY2bLPyMdgo3a zdE1#Ca(0;Ku$t_3__c|ldykNiirmR%#fF@si6J2g5oLJ=Lk=vRyaJ^Le-)H3x!dj-nEYHl0b(h z7HUA}Bs8a^ojJ9$X3LLD0=w@}Qd8nMj5sa>%ZKwTCunC{_!KH|L!f|O(5o=CuziXL76x;5-=`e{>L59t@LMZs3{CN3w0RU+%wn1^akhq^v5=i? z9z%^nod(JB3A>UW;^hOE6Qn`)>}AC*wrdwk^^Xd1meIn2&XY>errCr=PYZCd80Cw~ zSd_niYfQ{RWUZP74*0rdB&}uCOU%1X0Nr6TYO6HLAJES?VpPp5Z5C1O32D{aLSEky z z?Oe$%R^!16!u^swY62Y$M>lhlLPb3prnZ766=Nsb~33?`=o`y4D=G&bO_jM(+Sb=YvGE3%d zHpquMMgek0eG9z&#wu&1+$xk~m-P;0Im$T-e?e6EuwVV6l(Dkpj$xQ+FzK*;3}IP5 zkBNFrtRF*`0va)@=Cpr2ZKl(U|0+r+=T;WwvB=n{HkL=8z zgFAQ_gXwHuoYt`$+(k-dQkwZj1vIl%XVi6-vS@!lQJ*hME3H+ex|B7G_GDY57B#yL zNtS{!j$}QfW5{Sw>+gVBWf?L4thdrMpeN|dk_OdlYb@yM!EAk}6xOBF0cD!Bw#sU4 zFThX1JB`R&30(THBRPuIU=+w|(zwCb*wL6gXDs(x;nGsvHxMgLAc1X&?eAfiyJyiV zY|dL(cVrtoc676i2C%O-uETsQ<|2ODV!Kx#NLt-U-q{OriHfe4N$$Fe2J9g^HYPsp z?+NNVC;bgU4_#G-p*+}@1LJ<_bCcO_7gB>)(%*aF(%#?wM5fT+qRp}d2;0?VjHs9P zRm)X4+FGyl?8j~qY*E)x`{?ZbUiX9t%FOKHtlX3C`pxVvtz!xpdB^6mpX<2{1$+L#>ANF%~xJVs8v$HLnlqNR*?}0f!OeI1(^#z?F2=YZASf^&jjx|$j23_wXkGWl}PRy=|CI3eZ$O??a-HQdW@PTWgTn8l&NR+t3!;Y7z`nc_ZB7 zXtYqCPRBdl@;}&jvNS8p~~sYcU};F2(soIU{7Cmdu)5!`74rvY{n@nrZN` zI*jEOhqYW)RTyG4=Ud7awq{pKJlTbkKpWVpbQw%nEZ%bd74Sy0lG~Ln*r`b#ts7EQ z-Jabj_GZClVf2i}iF3j5_c1fVi6>9TKsssGOStc?2m9V&$b^2rP+c?ME(#KHOZs0azs>B9B;)ZC&H>oa|RdFf<*-;AtGeYv5mw7gPhUZF~` zs%q7cs$L;-(a7el6<89oNp!DAZ5!GNUox97mkD3at%mF@X~dUSOML#0>4i4Sz18I{ z%U&QBrREZw@y6YlNl)WW8E#AAa+|HJUbHJKOk5($s*xs&t(*2^tzpPVj7<+>Npm`g zWs$Qo#Fm4S4;pdH=Fl0m)lHFT%!fK*byFuce?})(KC37BmF<}osCh`is>i;V<*%4) z?M8xSI!F*(RK}UU|ri;$;uuHY|Qxfv+p*w6@Hk)eC7nu2u0LAtRo=` z*2wm2;4%RC>(>#SlfF8qHPH@&WRMyt0Gg-ZvY${RDtn^D!ZOmlATo}Pnb$!(PRfs$ z^3Q<$mIgrN}G8>%!l2+>djg&NK~Ga>>F9mf@rsOcq0~}#Io6jnvDwv z5$zr+vP%(bW_~G~zzB2>>d+0#N3iwFcWb!>u9m>P09>I8 ztU0`*GtusrsGSm31E_7PC|1Za$Z@ux4b~o)(6=OXA3%?)L#M48Mm}SwR%L2GlhBI- z%EmwCKraYrhX=%Db+63CY_@5o7kguM6uHf=uO6zsEp`1%nqdMnZmOG6vnH7;I`-F^ zep*E*f=Z{upkm{naiAKVS}3wtcmnm&v48WfS|5q^6^p-QP;NNnL)5p`@=K+wG*Ww z`4V~npc4et_dx~Gle_ID-t66HBVh^m_h+-Tv!tfkQqw`uG(+8p!)w!FUgf$jMY~c$ zS4rq0fG$^uzQ1k^*~Ws`k8s!qP&ViJK%Ba24g+$FKt8Z->%Ae21#WO9M_A_#y|hQ9 z0mq~PM?lRXbpx(#=u6JCu#LU6=Oy%02|WtXPgJ2bUu;}Ov_DJKEr~h?sOzdIHfHm5 zHhS|-2c0wI*L$nTuj8A5b6{kfe`75tJMera^>$`%FQh8ofCPCx$cH+<4Od>O$kQ(j zrg6@!{fh&XIEm~G@{uG)6?N{#5IWeI(JdX7!4j1w_)Y-dAXVhkTS9bs2$2E4X-f-s zd5caFk35YA=DQ;jhS_R)9kVrq%w#*a4pwGL>W2mOyFfi%6*y^IHd(=rY|BtqNFWoy z_W-y|73jSE@fzKBSEB5YxR(U(eZak_hO1e!Lr0W1CFYpGoC3@tH4Jmwm7=?V5a}P+ zU9oKWE}bGCc^W?xTF!u$bE;aJ?oNg7eAMn_<));+Er4eM_>(HI)t)e_Y0CQU2~;#q zMIb5c_Q6oc4*}@_SB;0@#Xa$~eN)zQZ?w{0B4Hc_$d3T&sfsl1&8D$Unaj)RN~}c2 z3*^Uu?4*i3_3|j1(v*eN3{_GjGF2cy0c5f&@^;M_GJ&PNGD4XkffEJr9013w0^9CO z(ak`JEFb;8*ygs;n@I39&Jw!LgRW_+y4t@w23~BMv!(4zwSIY1ApLbtwdV5P5W*`C*rD4$E{rvmx~ zKtEB14m=>C83&Fi|B}$#0(uFcKOyvit@zP{-u#CQ+N_Du$%XAd7^QV`5wWRt5&gN_ z5eMq%qS~L2KD1oxCqa4v(tHK%UIHX$3kMW_WgCgMu2198dmUSRI9c06!n(PL5&qni zuQA0u5{DtUZLaG0aKH5AhsBiCem2(xp39l4w%W01a&CcP6PUv-nJ@}gDMo&S~z_Nvf=Rn@w@Tv(x) zm|JP6fDJL#q}M9rIM7>xQ>+YhpxkSKJ=0*gt(uTq=*S@U@d&(0%R0zLUlbAp^fRVwHyNO zX?#q^<_}=*d|N=zF=tXbQO^6m{2+=v!(2~=X`hjKT`QqK0`w^X6+^oQpw_JRW@)F} zxO9z*h>D1fjfslr6y1qUIqk{roN{Nco@!e!#Y-_~uvde?0PQ|$NsX+PN8Wd!yKNP0 zj*F;Z)|Wh($8`$#eF=604LUQNY+%owd6>A1xp&XA?X_P?WtUyp_ytjJU)Z@I-*|GU#Yc-+hx4l`z=vFnaZ33&(z?i;C>LU&dJ<1{Irk z)cuofZtk`PKCwFasIV&1&MGA#!kkTOwX3#0L;G3A#W;M&_cvpEX9Z}Ef*u$Pq<rHC)Zb+ntHhOM-d|kQaiws)82&>kLtbOVCgNMUf$D@+|VM0gThJE_V+rr4lw- zaQPxvks7wf_{$8UERvwd1jrvj^Ho8^etVcG8zcy}bASswBIs!~5IcHr7CUn9j$)Fy zeF7JVxV@^l9e*z12lVj5ci*4)l+zOYfdB_1_#}eGP^*D*vvdlp!$>(>cYogM0P=|P zoz(G-&=HC{uBaJc@+72!DEB4mPk{L$DPL{sU0BR1l2{f>jmpnNFk(!+|ewBA+M&qyb41AA|TrRlMmv zg(MRtN8-jxTpZ#?s^a(}9T}^uK$sXW@MSvEpX#Qj_1Mk4N(I&N$jxj~d>%|!q<<$HTUt2PF43SKwfsvU|T zoG1Yj*FoZP5T{qg@#1K*nMK^ynW~~mccLUn1wEvKTvX6SRe{Mr25aariOZI_iHOTk z$2E^5gNafiam5mskGMj0+}U^nn^6}^+@lf)Lt{_lJXIY3vx~WgX}Xecl=Tw7R^p9_ ze@Yc^8rKawsaGZL6^ScG+#XdNf2#+X$KUKh?klGx_I-&hLF@^EeNgAhqk552-n%Dp zkApY#~ zABv_Dv2NmCtSvXtB$^KOB_2eHkk~LQmhVXhkR^~Y{%oWzc?VP_(CgesPQGmw<=X9p1-zcCQ{_o-4zrA^7hsH99?$=X50fJ#m( zOC`SAhM$A@$5rvB^C{#mRbG_X=WW<|h~21;?VV0WKwm4d2dvmN>EQR*)S=Eph!MJ5 z3H{g#)htBXGwRrDnWRk<<%Yyww_?2?N9;9t+~72UXAC3J^nMGzU>FHg?n^Y`z9XRB zt48FXLX+4L@Viv9n70{DI*``9$8e%oTDKIz*;YcHL`X}#mOF;5kT-{uFcQvh4<|uN zxP(MX$WnxaHUODFf`pKMe8&h9p!AcF{t~hbA$=NvbQ=lX>1bXwl7uLuC1k9GEJw)5 z1|auFl4w%S!$*;DrCdTP1%xjf4h2>wAYviTrXmG?vDgB(_)4(<>PviOqAmhi7@yZ)gcE6Neg|hpEtk^#C zJNF$+th<#`Maf;mXFg0%9fbL|Hp09Xu-LS0EYUPkE=kQ_NX=_d^QS_ySYUN@73)8) z=1&4r#a!~oW@6cd56UG&-7QNQa+wR}qqsW4PvsI1`)REMzmp3ks^Lc`5!+@>insn^ zVtXGAv97YDu5EZ?%b%J+E-Cs}7|_OiJ~xl#kYH3IHwS8>A;mb2H=PJEV4i>LdBQ}} zmFW5MNf6fSF^67)Ry3X-0I<=D=`f#WAS+E(2I4}LbPLnse6pX6urfJuV*%+%rt#$k zB*wy&E-5x5MT($^!Z)=IP*|gALuz7LQchOV;H19U`fzOb#^q8Q}G87x~ zD)pu1;#QYYTveg(3!BS|@^XvymF2l56?x@FWtIATkN^;mjwWr{nY%3=a^RCfHszLw z+kc6mBN7<&rDc_{+-hD|ZC(9eB9pn<^hZnOVJt1!bRnE8I>YDC*;CcaGro`vBg^@d zg(O~CX(`ZMMlymtV=Yic^Bkl==nN@>cFi0*EBTBf5=mCda(w}*ma0>=G?J0z5HB&3 zF3J%*suQ)S&eW$m!pBS^G31D(dJ(B$rUsRxu_!g&n?$N$mL*B9^XZdGPx1>wY}M-q zzcQJ$Qf9+0HPCkhbw`mORMql}C1i@}vl7yYC?2gvHM`DRmXYq%uXXKZSdZ4Y@wTPb ztQ&4&<86r3HZ;5yNQV2RJSg@@C#7X2rS=(|laZO8os^uGliUxgKvIeLfLEVaT3&9b zC@U3vD7pI!w1p#vxsDH+Ogy^RS;?>d4|K&yU9JBU9W8B3na2L$HE=?|)?)s;9UanJ zIHa+XGIZMweu->2+@D0igdEM zpG}sV{+dmEi1wZY|0cov5qw7#Y+62-mp5S)fb2J|T|oK~rAHgt@0qSW3Zo7J%U)JGpM@k5 zx})5MB;HbfJ=YmEUN64xZM(W5^>wrakEyCaH^b? zxOXJ(eZ(DC$9b+I9jJ0e;x0+tX~cc5isREbc~g359w)Pj@|)BE%{BV?L)7puRSjFp zo+ec5-c}TiYg^H@e1b6Nw$`Pw2F4k@dab2sR^7Fn;bO5^p~+ewTmy5*a|>2d%c3oF@c_7#F_< zrq~9ksoym`E;hZmojgaBZ!I~>*a91Wdby3=QhzM-Oub9lM5kDc;UEDW{UAKqC5hYS$!)@4Ghz(Z9 zCcR9?6D0|-BK~&Pz+y@oLd1yQ$+cQHw4^AbytGoE(r1-<{AOtZlRRWI`!D24ROR94 zUm*vTa%p0j&BVJ1Emnn^oL(icA!4z_K5oPQir7chv7WDy1gdN_XU~-TIyUUv5F_)) zYc=c+I4tEyPLN2=Jyg9`s21CD8z?c$9Am_8MEP!`t@zEiNH+iN0Eum?pEw~ctAB=W zYHUO&e)diBL`axETi;WkU0Q4?hYcYU!}Muzn`WqjSw?Y~z8~E5%Y|Jq@Iebdco2pq zZl_2h-+zcSbBKx1>v_f*62t#G1aqcX-t;i(>=1`fhkQhOQC&QL{4nVQnD-8oB!@1T zaN|7bJ6zWlF30!lgO=p9h;&QbAGqxq4eB!G|mj5xQLXfTxNiw(KuC17{3 z4nSbjWs=U{I!eYgiI#UQdGb}#4Id5UuO9>dcjE6IgLQ!z{^v26vc~eD<6wOppL86e zIG%4hPGV_vXMX-T$#lRk5&l4kw>LqH${&@f>rClJ0#xSJT;Og!oGn=c)Kcm0tO@BlhxYyK30Nvq^}x0_=CHhB>mdl#fk}U?d#8ynF*;3KembuHc7KO%WB^%izNCw2Gun1ovF=DhS{(v@tfI_Cx4wU@6PqAKFjIh&G4JdhHAM5TE`DOx%wP4(E3T2bM-S*MCC7U2I#@;1!g# zdim|9nx>eG1C8XO@*El6_DX|nSK9IK&Oz_^t<2I-GE0f)Nq0+@uG&akkmOP$BwwE= zW7{}*HWaT8e8dG3Otk#ycd~0xG;SaW)pGX*(#t{w>ucZ1j+ys52P>Gczy|l?ybMdc zTKa|RC;tmg@0_c|Pc*%A?VH}Z^Y#A%cf$Cb99@uk`5=;4UnMOYwFGKU?Y4E;|Gp>C z8kuQ+^)u4433O`w_s>Xs1upPQW!UmyDaSE!q8u?kyZ;B>UhSX`294OnRCngRKO@2I z>J-Lf))UZVddoWLU|+DOXp#8t^AJTHMHJcBz5$oX9-efWyaG+%@0ZC>fFUO^%Gr zA>Y`lKo)oYiX5g{Qm@7xt3i5wy{6EsWE26N3%`aPCi83Qe8Q&F(h1GBWHTMJ>CHD@ zg}(czZ^$@0+f36EX=c=?;XA%11KPX*`1(D=3taadtnI#3i+iu+9{ZiGmD(bdik_hj zl5B2(3~%&55JwB&Pc}Xez9)YmDQ%j0HRQ8q z{N@j^38Dp`at*q_b|51^I``wZek85@9C@tPOZ?^U%3Z z;>e_|eo2FK68rT_?9b=_i+J!;H;Fr6dXqG7r7qO&0qM8pp(Ud(j+oC! ztoe+zw-+}kin*iJ;4Wrc1}A4_=VWz~mipW#Zv3-fiMwm(Mv^_6HI$HZn|LZ4rAg~8 zCNECr7RX5q{D7yroJK(4@(xy{3n>wIP?^g8VLt;(y$+1zP>|==O5cTy;{TD!Myd0|WW)+ayplsR3x*S61V? zJjl2~bu=etWhG^0r3>?Xc{7ME9`rMDZ=3uex#s-TFR;w2jHT92a^?Eph|*w^htgJ>)0&^X2P=x9Xi9Uu z_K$v$>nxQrad3M7?2OE$elprpf0wqnyIZPdeSy|0X|BzzqYPsd7{^QRn9DXCjSCUR zJ+LB#TYNNBnzr#Cbn_|qNOMb*0MRCFh6JD1<}eGZ4+?e|h&EigYqlX0ZRjIxh!P34>5cvN2g2k~@i;Q9VPNb`oC|MCZE=`bEm$obW5LNuB%>hG0N4>MIp zW^!s`c2Z)pETg~vB+W(B>E69j0Z+F^lUmej+o#L;nTqy=YGTl~^1oL^miXzHls+IS z&D^LDzF)Vks+-)-MXvkUJ+HnGP1SN~%2K31@qTEbHQ}R%s(e+J3WXt!K_ZkMowzVV2qCh_XZz_ zaW4vs_zkDI*6Kixpgq0+G~3e^?Rj0;BlZ*6Mg;YH*r8_SsY%(1xR55}4NWi` zoRu*+xi4&;NX|~m$rOX0mVCV8eS>fSn6U8*ae>_`>M(5DeqeU)3%${W(k1hn!8 zVP)qB#l^S=_!IjjVsQvFefb}Y5+ggjt0Sd z&igHBsAZKu+1u`w6WoedP6II0Nx~HIVxo_oDRQSzVl%peXZTZR)1YS5ktoycDCajy zIo+NTZUyBaq^wk>H0j;xNuq4ABihp_(H46mxD`aHNVHj%h-b8-t7P6rwxZ2oW1$`8 zrA8^w*;B$TQu51g)RBIuPWeGw$|U8vw$zy@jy|O%w3THqiKCCq zWEN%;CW)5QXBsNNeqMCBWK4y&l_;@xj6EA=jJ0EoH8T!F#wb-rlir7(B}!f`o|fFj zmu{oQjgsZrk>#1mMj}~`I@vKl3I{2!tV`CEyZO^@yjN4|%75!X_54}~8cUyT)PR+C z2CS3@@XOv%qDxf`;I9W*{ChkA{d=^QDF^AhjWQm!V?1ik@;J=$K~+Z6nqZnjlv@^_ zP0_TP{w8_Wh0=CV_uV6D2g}EGQV!PAqrzwp9vDUk(pzS-TqL`$PWE{i%^`|jZw^x= zgYATy!eE34XAL^>TV1H9nb8ufdfqdVZlLfE3#)}D4_UkrB6n~!6r`U;ffFx8(W6R+ z9n(m4rVPHe6J0?w%uEJkg5iY?KS7eyXc)z7Os zLwi}#nI2R2*m3M{n8VUS@6q$FUFk{+{|cuSVODmiQ=RQbpW>&x(bLN1T2%i0WOrIb zzHgY%vMwkQu>1+{e09`wO$c@1CwtHedf9BiBsAcnx&d2z())^=uQ@b!C(tp}!xvwu zJNv>zxxA(4?s>$EUrwM7b_-5!d{Qqun!5SQmaGKnn)<4?WVd_MgWN3vx}x8E!yf@q zdRdtL`_S`rAb_Fw^Xp54Asz?!rF|^%*o&{}OS5P%GgTQIoKcEhGQjSQP^Wzc+nBZEGx_ya(Ul~xR)1{&rkHh#pyLwG;5zKn)jqQ#$&%%lT| zKOd4pL!IVf27Lsr7$SMu(aIrG(=2*V$+S~HTB^^huRfEX&!*udQ>uRi)u*YeC&TD6 z)BT}1K$&kxvRIO=tWPqZe=(eb|6M@~>CEccpLcO5ZHOto*FbbZR`bvx4dTc&aB#M^I{wBoe_% zf$R(wO?-X2jyz=yO{E?EWxKu<`Fs%~JHrOz$uuvIE+R^{g~ioC^T^m*EC$K4(Ez7f znqOpR^W8->$%47g|0tr7qyjOvtKt zHqaXXk=w;L9DtZ{cI0Fg*jgcUHwX^}1jCin;CDZ9X)8gqc zuu!H-C6zWMn^8%bRf#yErGdbL)vvpxHFJZpShQJC<-)yHm$&I`D(DsW;hY=8AT({27Y97B;6q<1RGFHX+~M zNYB!LF1=;yH*UaeCh!ucW}OK8h*M1zdfJ!v&r{-gpMIM zQ9e-f3n+oWdgl=uXc@Xoy)bn5SwKB_>jktU1r=g^xD$Q!p2cceSx(p)F8ih~kJ4ql zcR93@iI39GL}}I0Z0fwnXeIUTD8@`)3#mJp8nKWDT7s-qM>#Iri#+ZiWL(6CLc!R^)A02lHCX5*l2$ zY`60#me8?obxxi6OMF+=s+uNi9|2o{V_rvb$j)rMvlZxTa>(&^H65;HQgDS7Txu`) zhAIC^=&H4wq|kMHCimtcN94C;h|oY4{(@Xxk9nssxQk?LWIF4yV~^ zwZ?KdjXb4gpYWVGng&J0CWbnHW$iKR?u9xDV0nGD)_VD$98GgVSmlaG(^#!)lfVxw zqrMdWg`BpdJ3GS3La~}7!ht+~{2 z_-ilFK@PCLQqK~1w%{Hw(!TJ{d+due6E+X*d67zH;@^LTG)=fIY-R;+4gWk%QXc=Ut$#%$LSDvz+4x_PAeDiiFsn}@#`F0vi zV>@xp4jKwxIlGn)Y!VC5P5o&Ce`5zt1nqzBpmT)wjJdE0m+hqa;G^Gn!e3JB!e{LQ zZ+7LU;2# z%T6AQr9MFX^~3OKSmb4f@;of`VuQW{zM?X~F=$Z}%Jkr*3bQ}(`@)jalJLAzJfL2m z1b;ITeE(x9+7$f$>oE*~v+nx_BsgyvXU7 zB%=}DC!2S$j`+XO{=d-v|1PwhYlSxdbuSESTkypFFmvkqGWB$K4}d;e9Hy9hQa0j- zm+3j!G1sGpMvy?1lz%Y9-^6NYE7IH_0isivy`%9ufBh9`3A&-EpPS{+2%(thJjU*W z&LevtG)eve*b6ziHWA&p9A$jAkLJ4787I6U#|g$)=}7H(Wb-tR3lIZ}(N=D8!dOdF zQxhEyhlNO?Vt#WajT_V&^;;zEh6&04beOPwKlKd7iFt$Lgqc=r?8XV?5#cm3PC$`= zI!>ss_J1@^sQcI7Rtu}dIKgU_X99;TcBJxOPe*XvOi@UhcEX7~;&nP-*(2S%OSsqF z%ig`l=B7Vir<)we0o3oKH~NCK(GT+tUtZOUF1^IbV!wTu=G86smVDw7np0KQ18@Xx+YJHT-J$lJ7sW%hsw z5&Apdp-=PY-=Qzi=7AXcb336u79P9M?E4QxGa|1fH>bi-Fd2HsiipaJsj9~QoMYV$eGZ8BFJ(OamkZc|Y;p`x;=vI+;VITH==SAmM~ zvi51hvmzq&;v8cAKRQ;p{+YhEQ-z29?PG<-xXW%oyfhuZm>B{mvRb0em<=~P_ZamK zt$PNsI5yaNYOtp$-J z@M_)Yhd=l6y}}=J@pn5ed2Gd>a>SM5&w14KG5(CepP~438h_r$pLfx;ckoBVnTW50 zc>6m1R8?y+896M0Az_NNKk(~NV`@HAm`nlLy`7@H;xO%q0@3H#E7 zZE3=;G+|SkuqRE}k|ykU+=w=$RTb*deZq513y&6t3AYu#BYlSFG)tf1p}%vb({Kqx zIt|~8NT=cXrP675;EQw`e&TBU1AT_uMWoO04T$s^u2@N*;Sfgp3>PS*&u|PPeTH?} zD11hA7N;2r-*uVZAsYVt75X}z8w5v>cX04DJ`BMJA24tEiiS9aH^Hc!$uGdo{{s$c BpDX|X delta 32790 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

uK$ZwrFM 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 JoqmHq{ud*qPR#%S diff --git a/docs/_build/html/.buildinfo b/docs/_build/html/.buildinfo index a2363450..9b1d949c 100644 --- a/docs/_build/html/.buildinfo +++ b/docs/_build/html/.buildinfo @@ -1,4 +1,4 @@ # Sphinx build info version 1 # This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done. -config: 5beb36e19b46cb37857c83ef6e4c61da +config: f3187be31b558b8b8d001dc017be83ab tags: 645f666f9bcd5a90fca523b33c5a78b7 diff --git a/docs/_build/html/CHANGELOG.html b/docs/_build/html/CHANGELOG.html index 2969d550..2eb44aee 100644 --- a/docs/_build/html/CHANGELOG.html +++ b/docs/_build/html/CHANGELOG.html @@ -8,7 +8,7 @@ - CHANGELOG — Personal Cancer Genome Reporter 0.9.1 documentation + CHANGELOG — Personal Cancer Genome Reporter 0.9.2 documentation @@ -60,7 +60,7 @@

- 0.9.1 + 0.9.2
@@ -94,63 +94,70 @@
  • Output
  • Tier models
  • CHANGELOG