From 077fbdff28e5b4f7aaad22750a07048af60bb235 Mon Sep 17 00:00:00 2001
From: cimendes <iines.mendes@gmail.com>
Date: Fri, 6 Dec 2024 10:29:39 +0000
Subject: [PATCH 1/6] update freyja docker to version 1.5.2; expose pathogen
 flag; rename freyja_usher_barcodes to freyja_barcodes; update docs

---
 .../genomic_characterization/freyja.md         | 14 +++++++-------
 tasks/taxon_id/freyja/task_freyja.wdl          | 18 ++++++++++--------
 .../taxon_id/freyja/task_freyja_dashboard.wdl  |  2 +-
 tasks/taxon_id/freyja/task_freyja_plot.wdl     |  2 +-
 tasks/taxon_id/freyja/task_freyja_update.wdl   |  2 +-
 workflows/freyja/wf_freyja_fastq.wdl           |  2 +-
 6 files changed, 21 insertions(+), 19 deletions(-)

diff --git a/docs/workflows/genomic_characterization/freyja.md b/docs/workflows/genomic_characterization/freyja.md
index c5b15c54d..7442c6ac5 100644
--- a/docs/workflows/genomic_characterization/freyja.md
+++ b/docs/workflows/genomic_characterization/freyja.md
@@ -63,7 +63,7 @@ We recommend running this workflow with **"Run inputs defined by file paths"** s
 | freyja_update | **gcp_uri** | String | The path where you want the Freyja reference files to be stored. Include gs:// at the beginning of the string. Full example with a Terra workspace bucket: "gs://fc-87ddd67a-c674-45a8-9651-f91e3d2f6bb7" | | Required |
 | freyja_update_refs | **cpu** | Int | Number of CPUs to allocate to the task | 4 | Optional |
 | freyja_update_refs | **disk_size** | Int | Amount of storage (in GB) to allocate to the task | 100 | Optional |
-| freyja_update_refs | **docker** | String | The Docker container to use for the task | "us-docker.pkg.dev/general-theiagen/staphb/freyja:1.5.1-07_02_2024-01-27-2024-07-22" | Optional |
+| freyja_update_refs | **docker** | String | The Docker container to use for the task | "us-docker.pkg.dev/general-theiagen/staphb/freyja:1.5.2-11_30_2024-02-00-2024-12-02" | Optional |
 | freyja_update_refs | **memory** | Int | Amount of memory/RAM (in GB) to allocate to the task | 16 | Optional |
 | transfer_files | **cpu** | Int | Number of CPUs to allocate to the task | 2 | Optional |
 | transfer_files | **disk_size** | Int | Amount of storage (in GB) to allocate to the task | 100 | Optional |
@@ -110,12 +110,12 @@ This workflow runs on the sample level.
 | freyja | **confirmed_only** | Boolean | Include only confirmed SARS-CoV-2 lineages | FALSE | Optional |
 | freyja | **cpu** | Int | Number of CPUs to allocate to the task | 2 | Optional |
 | freyja | **disk_size** | Int | Amount of storage (in GB) to allocate to the task | 100 | Optional |
-| freyja | **docker** | String | The Docker container to use for the task | "us-docker.pkg.dev/general-theiagen/staphb/freyja:1.5.1-07_02_2024-01-27-2024-07-22" | Optional |
+| freyja | **docker** | String | The Docker container to use for the task | "us-docker.pkg.dev/general-theiagen/staphb/freyja:1.5.2-11_30_2024-02-00-2024-12-02" | Optional |
 | freyja | **eps** | Float | The minimum lineage abundance cut-off value | 0.001 | Optional |
 | freyja | **freyja_lineage_metadata** | File | (found in the optional section, but is required) File containing the lineage metadata; the "curated_lineages.json" file found <https://github.com/andersen-lab/Freyja/tree/main/freyja/data> can be used for this variable. Does not need to be provided if update_db is true. | None | Optional, Required |
 | freyja | **memory** | Int | Amount of memory/RAM (in GB) to allocate to the task | 4 | Optional |
 | freyja | **number_bootstraps** | Int | The number of bootstraps to perform (only used if bootstrap = true) | 100 | Optional |
-| freyja | **update_db** | Boolean | Updates the Freyja reference files (the usher barcodes and lineage metadata files) but will not save them as output (use Freyja_Update for that purpose). If set to true, the `freyja_lineage_metadata` and `freyja_usher_barcodes` files are not required. | FALSE | Optional |
+| freyja | **update_db** | Boolean | Updates the Freyja reference files (the usher barcodes and lineage metadata files) but will not save them as output (use Freyja_Update for that purpose). If set to true, the `freyja_lineage_metadata` and `freyja_barcodes` files are not required. | FALSE | Optional |
 | freyja_fastq | **depth_cutoff** | Int | The minimum coverage depth with which to exclude sites below this value and group identical barcodes | 10 | Optional |
 | freyja_fastq | **kraken2_target_organism** | String | The organism whose abundance the user wants to check in their reads. This should be a proper taxonomic name recognized by the Kraken database. | "Severe acute respiratory syndrome coronavirus 2" | Optional |
 | freyja_fastq | **ont** | Boolean | Indicates if the input data is derived from an ONT instrument.  | FALSE | Optional |
@@ -364,7 +364,7 @@ The main output file used in subsequent Freyja workflows is found under the `fre
 | freyja_fastq_wf_version | String | The version of the Public Health Bioinformatics (PHB) repository used | ONT, PE, SE |
 | freyja_lineage_metadata_file | File | Lineage metadata JSON file used. Can be the one provided as input or downloaded by Freyja if update_db is true | ONT, PE, SE |
 | freyja_metadata_version | String | Name of lineage metadata file used, or the date if update_db is true | ONT, PE, SE |
-| freyja_usher_barcode_file | File | USHER barcode feather file used. Can be the one provided as input or downloaded by Freyja if update_db is true | ONT, PE, SE |
+| freyja_barcode_file | File | Barcode feather file used. Can be the one provided as input or downloaded by Freyja if update_db is true | ONT, PE, SE |
 | freyja_variants | File | The TSV file containing the variants identified by Freyja | ONT, PE, SE |
 | freyja_version | String | version of Freyja used | ONT, PE, SE |
 | ivar_version_primtrim | String | Version of iVar for running the iVar trim command | ONT, PE, SE |
@@ -431,7 +431,7 @@ This workflow runs on the set level.
 | freyja_plot | **collection_date** | Array[String] | An array containing the collection dates for the sample (YYYY-MM-DD format) |  | Optional |
 | freyja_plot_task | **cpu** | Int | Number of CPUs to allocate to the task | 2 | Optional |
 | freyja_plot_task | **disk_size** | Int | Amount of storage (in GB) to allocate to the task | 100 | Optional |
-| freyja_plot_task | **docker** | String | The Docker container to use for the task | us-docker.pkg.dev/general-theiagen/staphb/freyja:1.5.1-07_02_2024-01-27-2024-07-22 | Optional |
+| freyja_plot_task | **docker** | String | The Docker container to use for the task | us-docker.pkg.dev/general-theiagen/staphb/freyja:1.5.2-11_30_2024-02-00-2024-12-02 | Optional |
 | freyja_plot_task | **memory** | Int | Amount of memory/RAM (in GB) to allocate to the task | 4 | Optional |
 | freyja_plot_task | **mincov** | Int | The minimum genome coverage used as a cut-off of data to include in the plot | 60 | Optional |
 | freyja_plot_task | **plot_day_window** | Int | The width of the rolling average window; only used if plot_time_interval is "D" | 14 | Optional |
@@ -492,7 +492,7 @@ This workflow runs on the set level.
 | freyja_dashboard | **dashboard_intro_text** | File | A file containing the text to be contained at the top of the dashboard. | SARS-CoV-2 lineage de-convolution performed by the Freyja workflow (<https://github.com/andersen-lab/Freyja>). | Optional |
 | freyja_dashboard_task | **config** | File | (found in the optional section, but is required) A yaml file that applies various configurations to the dashboard, such as grouping lineages together, applying colorings, etc. See also <https://github.com/andersen-lab/Freyja/blob/main/freyja/data/plot_config.yml>. | None | Optional, Required |
 | freyja_dashboard_task | **cpu** | Int | Number of CPUs to allocate to the task | 2 | Optional |
-| freyja_dashboard_task | **docker** | String | The Docker container to use for the task | us-docker.pkg.dev/general-theiagen/staphb/freyja:1.5.1-07_02_2024-01-27-2024-07-22 | Optional |
+| freyja_dashboard_task | **docker** | String | The Docker container to use for the task | us-docker.pkg.dev/general-theiagen/staphb/freyja:1.5.2-11_30_2024-02-00-2024-12-02 | Optional |
 | freyja_dashboard_task | **headerColor** | String | A hex color code to change the color of the header |  | Optional |
 | freyja_dashboard_task | **memory** | Int | Amount of memory/RAM (in GB) to allocate to the task | 4 | Optional |
 | freyja_dashboard_task | **mincov** | Float | The minimum genome coverage used as a cut-off of data to include in the dashboard. Default is set to 60 by the freyja command-line tool (not a WDL task default, per se) | None | Optional |
@@ -551,7 +551,7 @@ When running **Freyja_FASTQ_PHB**, the appropriate reference and barcodes file n
     ##### Figure 2 { #figure2 }
     ![**Figure 2:  Required input for Freyja_FASTQ_PHB to provide the reference genome to be used by Freyja.**](../../assets/figures/Freyja_figure2.png)
 
-The barcodes file can be passed directly to Freyja by the `freyja_usher_barcodes` optional input ([Figure 3](freyja.md/#figure3)).
+The barcodes file can be passed directly to Freyja by the `freyja_barcodes` optional input ([Figure 3](freyja.md/#figure3)).
 
 !!! caption "Figure 3: Optional input for Freyja_FASTQ_PHB to provide the barcodes file to be used by Freyja"
     ##### Figure 3 {#figure3}
diff --git a/tasks/taxon_id/freyja/task_freyja.wdl b/tasks/taxon_id/freyja/task_freyja.wdl
index a0894e55e..b3a7ed2c2 100644
--- a/tasks/taxon_id/freyja/task_freyja.wdl
+++ b/tasks/taxon_id/freyja/task_freyja.wdl
@@ -5,7 +5,8 @@ task freyja_one_sample {
     File primer_trimmed_bam
     String samplename
     File reference_genome
-    File? freyja_usher_barcodes
+    String? freyja_pathogen
+    File? freyja_barcodes
     File? freyja_lineage_metadata
     Float? eps
     Float? adapt
@@ -16,7 +17,7 @@ task freyja_one_sample {
     Int? depth_cutoff
     Int memory = 8
     Int cpu = 2
-    String docker = "us-docker.pkg.dev/general-theiagen/staphb/freyja:1.5.1-07_02_2024-01-27-2024-07-22"
+    String docker = "us-docker.pkg.dev/general-theiagen/staphb/freyja:1.5.2-11_30_2024-02-00-2024-12-02"
     Int disk_size = 100
   }
   command <<<
@@ -44,9 +45,9 @@ task freyja_one_sample {
       freyja_metadata_version="freyja update: $(date +"%Y-%m-%d")"
   else
     # configure barcode    
-    if [[ ! -z "~{freyja_usher_barcodes}" ]]; then
-      echo "User freyja usher barcodes identified; ~{freyja_usher_barcodes} will be utilized for freyja demixing"
-      freyja_usher_barcode_version=$(basename -- "~{freyja_usher_barcodes}")
+    if [[ ! -z "~{freyja_barcodes}" ]]; then
+      echo "User freyja usher barcodes identified; ~{freyja_barcodes} will be utilized for freyja demixing"
+      freyja_usher_barcode_version=$(basename -- "~{freyja_barcodes}")
     else
       freyja_usher_barcode_version="unmodified from freyja container: ~{docker}"  
     fi
@@ -74,9 +75,10 @@ task freyja_one_sample {
   # Calculate Boostraps, if specified
   if ~{bootstrap}; then
     freyja boot \
+    ~{"--pathogen" + freyja_pathogen} \
     ~{"--eps " + eps} \
     ~{"--meta " + freyja_lineage_metadata} \
-    ~{"--barcodes " + freyja_usher_barcodes} \
+    ~{"--barcodes " + freyja_barcodes} \
     ~{"--depthcutoff " + depth_cutoff} \
     ~{"--nb " + number_bootstraps } \
     ~{true='--confirmedonly' false='' confirmed_only} \
@@ -91,7 +93,7 @@ task freyja_one_sample {
   freyja demix \
     ~{'--eps ' + eps} \
     ~{'--meta ' + freyja_lineage_metadata} \
-    ~{'--barcodes ' + freyja_usher_barcodes} \
+    ~{'--barcodes ' + freyja_barcodes} \
     ~{'--depthcutoff ' + depth_cutoff} \
     ~{true='--confirmedonly' false='' confirmed_only} \
     ~{'--adapt ' + adapt} \
@@ -144,7 +146,7 @@ task freyja_one_sample {
     File? freyja_bootstrap_summary = "~{samplename}_summarized.csv"
     File? freyja_bootstrap_summary_pdf = "~{samplename}_summarized.pdf"
     # capture barcode file - first is user supplied, second appears if the user did not supply a barcode file
-    File freyja_usher_barcode_file = select_first([freyja_usher_barcodes, "usher_barcodes.feather"])
+    File freyja_barcode_file = select_first([freyja_barcodes, "usher_barcodes.feather"])
     File freyja_lineage_metadata_file = select_first([freyja_lineage_metadata, "curated_lineages.json"])
     String freyja_barcode_version = read_string("FREYJA_BARCODES")
     String freyja_metadata_version = read_string("FREYJA_METADATA")
diff --git a/tasks/taxon_id/freyja/task_freyja_dashboard.wdl b/tasks/taxon_id/freyja/task_freyja_dashboard.wdl
index a463a4cf6..24be429a9 100644
--- a/tasks/taxon_id/freyja/task_freyja_dashboard.wdl
+++ b/tasks/taxon_id/freyja/task_freyja_dashboard.wdl
@@ -13,7 +13,7 @@ task freyja_dashboard_task {
     Boolean scale_by_viral_load = false
     String freyja_dashboard_title
     File? dashboard_intro_text
-    String docker = "us-docker.pkg.dev/general-theiagen/staphb/freyja:1.5.1-07_02_2024-01-27-2024-07-22"
+    String docker = "us-docker.pkg.dev/general-theiagen/staphb/freyja:1.5.2-11_30_2024-02-00-2024-12-02"
     Int disk_size = 100
     Int memory = 4
     Int cpu = 2
diff --git a/tasks/taxon_id/freyja/task_freyja_plot.wdl b/tasks/taxon_id/freyja/task_freyja_plot.wdl
index 82735e1a4..7c02572cb 100644
--- a/tasks/taxon_id/freyja/task_freyja_plot.wdl
+++ b/tasks/taxon_id/freyja/task_freyja_plot.wdl
@@ -10,7 +10,7 @@ task freyja_plot_task {
     String plot_time_interval="MS"
     Int plot_day_window=14
     String freyja_plot_name
-    String docker = "us-docker.pkg.dev/general-theiagen/staphb/freyja:1.5.1-07_02_2024-01-27-2024-07-22"
+    String docker = "us-docker.pkg.dev/general-theiagen/staphb/freyja:1.5.2-11_30_2024-02-00-2024-12-02"
     Int disk_size = 100
     Int mincov = 60
     Int memory = 4
diff --git a/tasks/taxon_id/freyja/task_freyja_update.wdl b/tasks/taxon_id/freyja/task_freyja_update.wdl
index d877ba282..14bf716b2 100644
--- a/tasks/taxon_id/freyja/task_freyja_update.wdl
+++ b/tasks/taxon_id/freyja/task_freyja_update.wdl
@@ -2,7 +2,7 @@ version 1.0
 
 task freyja_update_refs {
   input {
-    String docker = "us-docker.pkg.dev/general-theiagen/staphb/freyja:1.5.1-07_02_2024-01-27-2024-07-22"
+    String docker = "us-docker.pkg.dev/general-theiagen/staphb/freyja:1.5.2-11_30_2024-02-00-2024-12-02"
     Int disk_size = 100
     Int memory = 16
     Int cpu = 4
diff --git a/workflows/freyja/wf_freyja_fastq.wdl b/workflows/freyja/wf_freyja_fastq.wdl
index 2e0fe755e..b758d3ca4 100644
--- a/workflows/freyja/wf_freyja_fastq.wdl
+++ b/workflows/freyja/wf_freyja_fastq.wdl
@@ -208,7 +208,7 @@ workflow freyja_fastq {
     File freyja_depths = freyja.freyja_depths
     File freyja_demixed = freyja.freyja_demixed
     Float freyja_coverage = freyja.freyja_coverage
-    File freyja_usher_barcode_file = freyja.freyja_usher_barcode_file
+    File freyja_barcode_file = freyja.freyja_barcode_file
     File freyja_lineage_metadata_file = freyja.freyja_lineage_metadata_file
     String freyja_barcode_version = freyja.freyja_barcode_version
     String freyja_metadata_version = freyja.freyja_metadata_version

From d0e6ad007de2666867733c60a6662a93d5ea5431 Mon Sep 17 00:00:00 2001
From: cimendes <iines.mendes@gmail.com>
Date: Fri, 6 Dec 2024 10:43:14 +0000
Subject: [PATCH 2/6] minimally update docs

---
 docs/workflows/genomic_characterization/freyja.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/docs/workflows/genomic_characterization/freyja.md b/docs/workflows/genomic_characterization/freyja.md
index 7442c6ac5..8510ddbf8 100644
--- a/docs/workflows/genomic_characterization/freyja.md
+++ b/docs/workflows/genomic_characterization/freyja.md
@@ -112,7 +112,9 @@ This workflow runs on the sample level.
 | freyja | **disk_size** | Int | Amount of storage (in GB) to allocate to the task | 100 | Optional |
 | freyja | **docker** | String | The Docker container to use for the task | "us-docker.pkg.dev/general-theiagen/staphb/freyja:1.5.2-11_30_2024-02-00-2024-12-02" | Optional |
 | freyja | **eps** | Float | The minimum lineage abundance cut-off value | 0.001 | Optional |
+| freyja | **freyja_barcodes** | String |  | None | Optional |
 | freyja | **freyja_lineage_metadata** | File | (found in the optional section, but is required) File containing the lineage metadata; the "curated_lineages.json" file found <https://github.com/andersen-lab/Freyja/tree/main/freyja/data> can be used for this variable. Does not need to be provided if update_db is true. | None | Optional, Required |
+| freyja | **freyja_pathogen** | String | Pathogen of interest, used if not providing the barcodes and lineage metadata files. Options: SARS-CoV-2, MPXV, H5NX, H1N1pdm, FLU-B-VIC, MEASLESN450, MEASLES, RSVa, RSVb | None | Optional |
 | freyja | **memory** | Int | Amount of memory/RAM (in GB) to allocate to the task | 4 | Optional |
 | freyja | **number_bootstraps** | Int | The number of bootstraps to perform (only used if bootstrap = true) | 100 | Optional |
 | freyja | **update_db** | Boolean | Updates the Freyja reference files (the usher barcodes and lineage metadata files) but will not save them as output (use Freyja_Update for that purpose). If set to true, the `freyja_lineage_metadata` and `freyja_barcodes` files are not required. | FALSE | Optional |

From c00cbdc3ae19b0f9600a57c22573ac8064ad03d7 Mon Sep 17 00:00:00 2001
From: cimendes <iines.mendes@gmail.com>
Date: Fri, 6 Dec 2024 10:48:24 +0000
Subject: [PATCH 3/6] more docs

---
 docs/workflows/genomic_characterization/freyja.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/workflows/genomic_characterization/freyja.md b/docs/workflows/genomic_characterization/freyja.md
index 8510ddbf8..64f57931b 100644
--- a/docs/workflows/genomic_characterization/freyja.md
+++ b/docs/workflows/genomic_characterization/freyja.md
@@ -112,8 +112,8 @@ This workflow runs on the sample level.
 | freyja | **disk_size** | Int | Amount of storage (in GB) to allocate to the task | 100 | Optional |
 | freyja | **docker** | String | The Docker container to use for the task | "us-docker.pkg.dev/general-theiagen/staphb/freyja:1.5.2-11_30_2024-02-00-2024-12-02" | Optional |
 | freyja | **eps** | Float | The minimum lineage abundance cut-off value | 0.001 | Optional |
-| freyja | **freyja_barcodes** | String |  | None | Optional |
-| freyja | **freyja_lineage_metadata** | File | (found in the optional section, but is required) File containing the lineage metadata; the "curated_lineages.json" file found <https://github.com/andersen-lab/Freyja/tree/main/freyja/data> can be used for this variable. Does not need to be provided if update_db is true. | None | Optional, Required |
+| freyja | **freyja_barcodes** | String | Custom barcode file. Does not need to be provided if update_db is true if the freyja_pathogen is provided. | None | Optional |
+| freyja | **freyja_lineage_metadata** | File | File containing the lineage metadata; the "curated_lineages.json" file found <https://github.com/andersen-lab/Freyja/tree/main/freyja/data> can be used for this variable. Does not need to be provided if update_db is true or if the freyja_pathogen is provided. | None | Optional, Required |
 | freyja | **freyja_pathogen** | String | Pathogen of interest, used if not providing the barcodes and lineage metadata files. Options: SARS-CoV-2, MPXV, H5NX, H1N1pdm, FLU-B-VIC, MEASLESN450, MEASLES, RSVa, RSVb | None | Optional |
 | freyja | **memory** | Int | Amount of memory/RAM (in GB) to allocate to the task | 4 | Optional |
 | freyja | **number_bootstraps** | Int | The number of bootstraps to perform (only used if bootstrap = true) | 100 | Optional |

From 1420db3385ab0fa970a8eca0a2513b767c4d7f6d Mon Sep 17 00:00:00 2001
From: cimendes <iines.mendes@gmail.com>
Date: Fri, 6 Dec 2024 10:52:15 +0000
Subject: [PATCH 4/6] bump version

---
 docs/workflows/genomic_characterization/freyja.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/workflows/genomic_characterization/freyja.md b/docs/workflows/genomic_characterization/freyja.md
index 64f57931b..cbc5478bb 100644
--- a/docs/workflows/genomic_characterization/freyja.md
+++ b/docs/workflows/genomic_characterization/freyja.md
@@ -10,7 +10,7 @@
 
 | **Workflow Type** | **Applicable Kingdom** | **Last Known Changes** | **Command-line Compatibility** | **Workflow Level** |
 |---|---|---|---|---|
-| [Genomic Characterization](../../workflows_overview/workflows_type.md/#genomic-characterization) | [Viral](../../workflows_overview/workflows_kingdom.md/#viral) | PHB v2.2.0 | Yes | Sample-level, Set-level |
+| [Genomic Characterization](../../workflows_overview/workflows_type.md/#genomic-characterization) | [Viral](../../workflows_overview/workflows_kingdom.md/#viral) | PHB v2.3.0 | Yes | Sample-level, Set-level |
 
 ## Freyja Overview
 

From 092a12443fcb0fe5aac52d14bd8e1d68bfe8a4c2 Mon Sep 17 00:00:00 2001
From: cimendes <iines.mendes@gmail.com>
Date: Tue, 10 Dec 2024 09:20:32 +0000
Subject: [PATCH 5/6] oh my god I forgot to commit!

---
 docs/assets/figures/Freyja_FASTQ.png          | Bin 21812 -> 24270 bytes
 .../genomic_characterization/freyja.md        |  28 +++++++++++-------
 2 files changed, 18 insertions(+), 10 deletions(-)

diff --git a/docs/assets/figures/Freyja_FASTQ.png b/docs/assets/figures/Freyja_FASTQ.png
index 1789c8c53535bf45dc4315af02fee059656379b9..75eb466c21c300256d2940f628f67202d8b9086a 100644
GIT binary patch
literal 24270
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

literal 21812
zcmdqIbyOVRx8O?>NP+|n9SBa407b9>fndSit#Rqb6WlGh2B)#$?ohY~mqvq2aDuyA
zGJJnCcdc3X&b>49-uvsV)xEm*k*-sx>eSit*&&MZ5-%`bW1yg*ypWO<RYpO144|Mq
z$$0+cp@gC2*WkksrLm;4914mX9SX`<e-xCPhoY}rC@7AsC@4DyC@8#%C@8ONzBelI
zp`bjvQj}E{`}_Cr)z#I`&d%N4-RS6OaB#4mo?cH+&++l`?CflIcDAptZ+Cb1>gwvo
z#>UdpQdU;h=g*(Nefx$$AS^5_CMG6^hK7oZi-UrK+}+(98ym~Z%blE@YHDhVii#p4
zB3fEn5)%`LhlhXt`ZYB*)zs9KmzT%E!C`A_Yh+}kqN0+NlvG(+>Fw<;A|etV9&Tr6
zr=z25YH4k0<K*QRBCD*;`$>A?*HTzy+}QZ!?cH5acr?GLoQtPlckjT(#U<Rr_M@;&
zLsMI0Q`6V*SZgQOgyPz^m9zHs%jU(SoR)#K>h_4-%EpC*@}b3=$=@&=XH6s1jHdq9
zmD7ZZR=043tg?E3*MyLWn152Xjdzf#g;n|BLjBB6_4t~LPhfCD#=+r{hAynQ3{=xL
zE-a}?NzajxQ&0My+1}BmtE=ngYgg8n)UjI7yH(OKm6cf+W#eSky;0P<kZWoI_l<Ck
z%?_v@`yNx^V`8T(Br4z;VbeI9RnmvZX^r|`6|7~fBBvtRwNVtD;$r7x`eQk-dL%6@
z$-AH}KDjjXvpKvmFJuRqKHHj5p6ciBU>WRfcQu*&cfRm$HXjk<k{#>SQx-8&{mt#O
z&PI1~UAp(dQ2NDqc4tvwL9Fw9OI&i$m)n_q4JFAiceuE)fVsZ%@o3g+S4w{STFJx1
z@yJL<LKGz!jZE@EK(~>E+M}QlrTp`KB<1KA_fYuEK}t^S+17I`T-vwa&`7mWP?S-m
zL_evz%<Z>?c)yWyN`%tyn1Oj=lfO2~4zv`iB4DZRE_GTQ7IKl|AgZM;MVH|<k$DcW
z%*QyB95$3iR4LaU#Ajw^mPbc)pAOr$T@J-y;;WRtG(QGKTMsXbsiT}tJc60l>YctB
z5(WN0|GeuuCkY>E*sgigHKbklCj79$bF*wZ@41F%e1^@4rN#ls)V>nf3og8xJ{s#<
zf6_DUVY+IJr-)PT&V&?M!6?Q@rSoU5<8$07tM_%+6MWheTqwC7oewUAhzcCvP_dc_
zO{~@cDtdybJ>d#aNY6`e<jL$BLyzDc0TnVE`(UZ5<MB^oP}XDBvF5RH$EHGa!basZ
zjt|=gW;y(mMytnN+%cz$8IrK&*%nh+y}yFMDX&Z~)^CnJW}Tsr+g_m1@U2RD`V-?0
zQw>PXS?orkq+hcaMmRBr81*H8yjV^Eh5J1&5l5Qdq~%u*nCs5Dh{51d6L2X2_vrkK
zA96Q7te*I$u&C)PuylPOp{D_`KDoZ@Ump#V+)UUY*VudNKi^rqu>c;)d|hVU`#$Ij
zPx22-Ouib<wTBPBO}g7VPN2>Ryqnr;20iHBtyE4&`m!0|+aVSQP7;}ReLMK6kU9CF
zM?ap70j{BAuL{(^^v;cq(t~qv8s$|~z!J+-|IFz<5Lm-Rb`W)ftUVP#I2(XzjP;+1
zeP?H9RRYCnm->?wmE))6o6oO~%&Foxx{(Pi8@=XNX3#05K+5phzp7<7*=-}Xi`&Kx
z@ztTCeR89{8i?~bCTO0i2^P*4rZ6Ki=XnG7)ppX=*+mI#OBifsi-iw>Wq%e~<R#&*
zN7$<b%cajd)6xp~B=n(l>6bHFN3!d(dQN?hi@QVgK4?=Ol0nl1j|2_l;lik7fsv8{
zi~LdjQAex$NaCyeHqXmNx4#Eys73EEKd|zjYPqoT&_13^ZWoaa^(>jTehYO!o&)t-
zZ2H+5u<5wsrG9nA&8+^KH+6x9Ws&gxn(%)%vZCX!2Dwra8RgGjYGOvd3|vG-%a%-U
zgtzbYRb5uMyH{+aF1)5L;66K!e}`n!IZGZsmi=-kAG=YibI}p@%obaiDeU>A1`aEs
zn_ywT?_*gE!o{}4thgc(2&Vl<qhGfn<^w(QexwBDtOTg;TGo0-CD~5CgJ-v|%;NZZ
zwP%)R{Wd8>-YTqZ(=CpnT_=qWoP5uEj3;W-ATQL4x5MYn@dO=<7B3ZSb`!rg4t~ly
zs4qLzoPr8pj3pYcUPPdQ60vbSZs<}|gP4wrqq0`4pVNmoi4#T#9*1;lW2yBqegON9
z+~@`*$|r>r0L9?so~yMD<TQx#$HVQlG5P`uq<IRKse^am_bmBkkkcy7ro)t2sIG>z
z3)~fR<y;sNY6UF_J`*;Pa_fK0)ly+43Og3}Obc8`AIEP=6O$71PH#hySc1)y@|&g|
zOqimKu_|C=_r>G3Pr$L8$!|{u=rT(myGZkoyZz!M4HHmk=aL*}zwabQz89Ril7~Ep
zz1=jT4f}}i8r1z=s<<2&cSB1F@NM2o!RjB08*I*57-rIi9B<rn0Cbgr|6iD^PdAj&
zr@kd)>0Z<uN>`}Kf9>RUlQd{4I~%Y(jCFuz;t7B1{8UCiR-Ro{tkM}qf)u_|Ks-BC
zQ<IKN>`qSZFggoM12bM*)9D$<p#-^x<sKw$8noZmSvQ3aa}cP+(LaLg8IIlD%M8#f
zC<tR*;7_+*IJf8|!rPBBlb!1TP#(Lpxeh2&#>Nm)QGF34e^wNi;!zF>dD73@z#Z4!
z&N&{Z>lN8x5lJ3EY>3$4>HaGu5qkRcXFhsdULAl#X=&Bs{fw>MzTn#Xl5{njxTwQ(
zzwDs*@o4d8`H>LIGIL$uR_ilp-jXpHW!eEx4=*`C21f^ggz`}=EN?fYcBeYD$Q>O2
zxk*~w+lEFK)fv1GGlCKsYeIU65CLp~aKmuJ|0s66L!O0~9C;rZ{T}jrW^MA6J2@?h
zr|EnR)6ck`m8X#9c>@qzURsBfW_;A<U&q7ov=sH}xo~P`9)e|YNOP*#`Al7#=zaEu
zuU;?*@A%OH?{j}01UCrnKjVS9UY`tRq;}Q$jOZ8EBFYtG5+*E2zMdnnb;VGg*8yiK
z0{Os`#II{YRsIRojc#SUe60@2Tt2|~4<;&np=0fT8kMu5e1yBoAAX}ZoCr5vZR>x<
zLYZ)K$IL0$5zQfrE9mm)=a=HMyM1lKU(G&W)3XjtD}M8fldxp+V={yDRD&~k(n9!I
zib!_Dx&p_3>g)t_O-h8(2*^E?w$JHEk`(wiLoD?CwK1wiDoaX33q+pJxz4AZbWCPL
z90y9?j3GLKZvkCYoX@X<yRw9T4Yck^o}N(=9XJ_C_Vp6MVI4|xqtXy?dHUiDy(%W(
zGC!$&-^m_7@t6#PyY=wfbAK(w^hDE@74!)6oGzv7E+}q;lZF)3&E0cHh0eYj?L5xi
z^Y$MU`Wurl15&sRT*SfWHb1WiD<Y{e+n>N5F_={Nv<B1Y&430t*%~v~=a0nSa9mxJ
zS+VE7vR)js)$5o#BtJuJ_#8HsJqD0JV9y2Ga!@g+C82a?j{+~xkPKTNo~AGP>6C#-
z;mpYD1vUMZ)|cJ{CeSqG_wKJ)?>xMu!W^J^=Itb<^6;k-*E>F?L~L(P0UV*M=~zI9
z5}p+I3-7k?q(c%St6Neib>%mYj5r;su4-0%mgqnD4v8-ceM%#8=+=KytBo+7*f;)}
z^+f1|21DRNBtvIJrb*(bJp%q6mXw7xaH|K(IwRTTlE%@a;L6EI%8rg6tjFYQuU%1a
za}t1&8!W3$7GdVFR32O8Nr&70st>7fw-7|B%<FVH>8)Vc$%#MKUnwH)gYHw)QA<K3
zQW{~ZRVN~cK<AHL(-vk%Y8PSb#=&D6V_O5ztY5%f-*5%uWp;W0EiP(ERedr9J*2C7
zvX%PU5t^quEvZjn0Zmg`SCD&IeF4O>=(Tup+>=6<y`4znxhqz}@6+eJR>>l)c#cox
zx(eSVx$vCcoQJ!4uD`c)HN}a$3ygTte0jg@CsY8(bJg^|%h2U){X@F|24|H}JZ*3x
z4+a%y;6CBGIE^_Yn%3{UqnIey!C-&0os(w`G}im#4g&Ohpsc)mItpLg4}bAATqkIv
z{f~$JI9wRP(&k=%D+<UQ5eERi3avXY1L5cbZ(?$_i4e3`Sh@&H?gPHi53>CCaiIbK
zv}y%@b$Fb)tbPQLM69o&iiz5n6uccCCvBC0kEsKQ;%x1C-0%hqiEks$glXe>(*GF&
z2Z&mLzHcA(LBMA-6xQIhkB7u}DN{!DB~XMJDLn&ZZ0ePv)cpR2P~Xn@e!JaT72rm>
zcpm=W#r-+CCQW}r7Vt{~935NZEhhRnv<?ZP1~DPfY}>F5ppX4t{d3-5f4{@giS+s(
z>!f>}1jEsB^#*(^fcADAkgwJG`j&{G^>jNwou5!Pb!aWW&omvQ)&9CFdG#5zLP<9<
zJE31e(DUZ3xG<9XmH6|s_zH=7j)C2?AfQMobvn~&GT3bW7*4uvI;?@aizV24p@V2D
z<5E_M6vPzYY?iS*tjecQ@cj9)#9GkpY^y(&!&Q{X>{L^eqnduF;h!nHKJFqiH4;d5
z;XQ}5h#V|6aJa7Zpph?rBjG+k_c;)Bb7)F`Pm%dPq18#hk2+xN^`xf}_Zc~bP^>~D
ztt&NY15b6Y3&Bvs(tL_So`BcQEUi~?YcyKD*CFOTUE7_DEZB1C)<suG@vFgc?dEOz
zZ{5tHSiLC^p7XP&S2qkd(vXa`eWmqmA$sYh>$C0NRN@&4{e=eGOGb+AZzL@_*RY*q
zSMRXaSTtMiGYD}FN)KDQJl}z=Be^HrYTvqS*;2h@K9U#@nMg1DCl2lF+uxa9`V^jo
zQ6AyJ@~t-oDzP8QEml`=9&U3z1@Kb%n^*Xs_<)1GMFQtXN}_250ueBQ`!A*rC)e2@
zV>Obu5^Ya=O6kc4Jl?b3Tr>cEzuZ$VX{i<380;UWQr{6~M8V(S=#zD%_PBEJv%Rq|
zCFZXL$#?<hXMw@+G`)@DXaONQrvXoR`cfOmcC2de*D{K=iM5clNKRIelE~G`WLMBP
zCWD?fk31Qbl6QOPJOWsy*LQ65L`MK8t(0L?h2fIP0ub|YLaEb2Ne5oe2G1q#q!~=X
zS!`ngx4R_rZd4_Rt1&LpV{s!~@_Sxd#Bj30NBy0<!?=)^%}&`pG`vD(iOB*tM0>oL
zow2eg2mkl>`lqkGJh;N?C}x5UEQ)qtrvIh*yQfE~lIjzA9<jTRdHxH%8Hj08TyvPR
z)HLHjeG%A-`66&|m8|kt*LZ$pzFR9fBm~>y#M{ktGkdL(DHJa$F|t<_g4Tjde0Q=)
ztMtm0lWp6jkfR4g;r`fY6dn(7O<OP2Kbc#IzzUg<Y{j*e(!h2agnz2GP3lpBOb;#M
z@{p)*Dy8qq>35Mki^~2K)W?4cMVb9=b_d@U@A}vUJIphyA1;WO(u6(oXT5A`4HP1v
zgC@#!{2!?6|CKU-r?01vLO?3u;`vC{#sEt6r1g)%Y0dO>#}%0bq`ch!n7=Jo=bHIn
zM@uT8$H*>|p~uK&Jg{_mBTe-8bbfun+TD{(7UgP@dwGESI|iHIwLrdbI9uD3vb%_B
zjdoODieQJW6bctlLRrcyh!MiNr4@sY=<cX9h{DbDg{;t3`{AE=4?T#N>=?U<PCFk;
z(PRy-#v+?reSg^BPo+j3xwmbe6Y3DgcBW9PZyt<3Wi+|#%I;rjvO8SaC=WZPy$swR
zpdr7wOgdgo7by@Ry%6PLW%)sIXBbD!@u!<2<ZBDRj>eZzkw4MX+&$sGg1DbPE)>pD
z65hPhTY_+4{82>RFU=gVqsPDA)LSCtc<m*K@5*ik^;+6ZF%s{jz;eeRM!-F;+x{^g
z|8vFZzgDaMM=jj~sEHu7X9=N?A)9w#{_ywHWOP?DYMH`!Pya-CZnM|>79tiXAjTWZ
zxuAzLEt~8#T!_}s2P6%pkd^j+Qn?@uS$0O^A6io(?FcnrqgCybL1X0m@)$@7#OQNI
z9PwJ<QhCaSIm|MRe?M^)s`gizx;!<eN0vN~RvlyYP-z5kE2=g$T_ILJXvD{viJ|df
zo&*T5SD8p<Sv=a$Em5=w<1=eOk30k;Kj!LX5KfY25ozqPCtoZ}F)A&wOgzRrsL(g|
zk|D%4tJKHP{xAit<Y?U6pVOKEWCU_@?e8@Ttpg(PZD(`_@CoRXzQJwG1=Ko_zUO12
z@^@kFukQrYWHz>9sv10aUiE%%Hj;&hjOUlgKBZJ-?L%|D`koot2v9q-%cO(2*`pV*
zPh6>?-IGpIyn|LT!wEk;hOKHZKk0&7u8@z8Op3}05y<n^^uem&zvE~+#GRI36}m}F
zE<@SkbA^&1&ksG41VmV0j=x;%V*46~NHYo^Va!G82607l+`m6j&&zSJk<{+hd$!Mn
znG+`#{k~nks**YlV`_vKq}j`Um96YJ@YVgorB@kYWdcdJi4j)1dyQ0jertrE=8EoJ
zt^V#ci{(o4gmg9A`PyOh&|n6=(XJ7KeWKFJw|d8R^bc6TX|(IWm7E#?M-NXlLYG50
zP?LyESG~M7;9H+vBl`%o>I*T7iy_n@(+E?3X--pZBWDKEuzK8>SgtwbVZjTsbEHQ6
zc8C{b6`-M%M87MIURH@_E6E{bRsTGmNO*~42T0XS2-tCHse_c>DzWu<+)44gb|lo{
zg-g}57rma<WQ<3c4*|L2AzsfW!-gx<K!>SL1D)S}_>lwD+Mj+`8Ux6RC^1u+rzsFs
z^!T>!pwf=2t>LPIfqJY!*&@>wE~taBetaH&nO_>ciImfTZ;eO<a6-hUjX%7M{eoDY
z_IiTt@DnUn9{a~1sOd-cdPYGRTTiU221y3^^olToCSmX*N~{Nf?((@p`f^7J=~DYj
zg8&QN5I8Y}(N8<4!%BX#R&?85*)=L_Fr3L9uXB*mBa09Cvs3x~oB7v)U5HYMFb-5X
zZcXyL3?hqH;=NlSKzkPxW|syJF0hHo#N7C)%%xo$x&aVJW!}kPRfTD`SqCu@nGl}#
zqu#lUu}RkdOcJHi@1n-^31BSIVQ}vIxtnnhXHaovjGSds>XR}Z4u}3IG6K?8vrb1V
zIvK=9$b6eLyMzXf0s_?hL&LGuLJT+qV}pif8t{sP4WFWE)%+-nWm4LI)@tB@%)+*y
zlL<UwxRCGY;ed~^@22rDvc=QN=Z==BTZU1H<$Rr2gj@EXe|eiMiyVE6Y`nLUV$tsZ
z7V01*i=zYf`SpZb*km6=F)mTJ)nvs-5MomUwrOy)E+aPL5;Qj)0=b@n>&LWI$M{^F
zZ`bi{J-)r+8k(6Wuq_xG*MCCGVdU)*U>rNNjLdT>F*q#On{l9cPcZI;I1F5mhj*Kx
z^XUQcG8VfV+Elj%J1)nvbP<OreD2L_w8)Kqs9s<XF^yd%Y0LUq+4*DSDxLP(2mMhT
z4_dXvnx|Y<BvgRRvpD)={q-2thW)#ZNJk}2g#2m)yK3D{Bq`VS$vZv6|DmJ)Pd+1i
zNAN>xQH)|hvLx1CeY~8G?UbOG)1gT7K_+YSo1_I1(h&ro^~k`NGFil4NxYxi-rEV5
z?&TN#LIn7~9gW$V&OM**P8&-O*ACtD6O4~W+Bs>Y#X%1<UEZk^9f`2={S@1>#W6oF
zSSzGDQ)y&}N`uZK6FLakz}3a~?A(P?!mwPI>fNR(-{FllR#?B{2DHrHl`l_>E;m|r
zeSJA2sqEp7*GrgTjQ!>RG`MG1CXGPl!sAH?HZ!yld|j_|p|hxS_hiP1IL?p0iL}_d
zx%TFza(<qBO8JGe0vh@m2=3g|!`Xhde)ce&8w|LTb^3PfAKkoP{DVZkfGe+PqviNX
zA6)9J;f7DtzVM)aICGf=%I-uFRPYYd>19GCcvT+d%k_Cob58mbftGAwOrbKDpk=>!
zML^8e*ubY3>%)@zP|=DF-6hjWWc(j6PI;r`!)Ne&M8mKo2tyK$ZDtVC>iN_Umduzz
znvxJIpjfCj0#;;}+pQaF`7Wd>hFb@hn~&*BJ#5K_0sB%b7&1V;*xBTt()*1vAcPj#
zo%O+7e2<<&lKdUci6r%uzn&#Kv9J8qMt$=d>}g}+kI?WBb5<ceSYO%Rbd{~Pnkm>S
zq1O-oQ5q%eSFXMNP!EeX)XcjmVX)#*A2wdAO&naND{**zd;N*1H*B>Qra_{yFrklN
zugyBR^FjcwW+60Qc{5vYi&LXvQpN-_eNTcnMswtK=ybu03$`WNumCW4-Y?uF^vj2D
zP5mUp?a`s;RzEa;(6h-nhnL=lCI*LXq9E<hGOC}&RKhde`wTGKsV{ONy-FZWMwO3;
zZEBF1*j|s2dnmm|*Sjds&ke7kpgcv89@qt2+qBc+N*VqQS7E!e<{}vCsR(c+hJ=m0
zlrx9+w1Qn~63m<KD^^guqDd__I_XPSD;o*ZuH9kddRj$2rLM&I6cZ|s)wz2oI$lPe
z>XU%_nC^kK7hx?`TdWI~kLE{nE4+>H73imWLTwrowd8NNacDj-MKwP&b0_b#|6N@`
zm_6%4obdAaSyX;&T;W^J4<iQ17B6^1akLnr@3TH(98R&1u+LDtmwl^a8#Y4z^~G!{
zSQsr&B6w}6@lv`?#x9(%t{bwV-$B`78p5?`eTGamC00=s*=D^F=^!|5o>tcWP6gIT
zg8vp8s&tO3e8nTLB>HL5@+nTl+$UWT^`0!AS!%uzD!pnJhCm#e5T^IgftQu>R5eT=
z+YrEgE5?yctV5X<^}$|9(1^w5iZPV+=q-JT@F&9T?-_k`_#t|2^YYL=>kzZZLr*wE
z-zg0#)poc`09&ZjvZ<6tY~DM5w0V?m>B`;SLKuTN*oPf{(i^3C`Px2Qxh~Xue*?bx
z$s9*C7OswYm_-=5qhv`Pt>me+Zb1I9l}O)itd)yHlG?~9Wx~nDg!#2;!%i!zXlJ8J
zooN(qV}b3L7wpW1=O;}nbXyEzeJ^u#+~!T=lCZ8R$*zrFV(x(JlYL4pFex*zt6FCI
zKur%C>Q?#_9tAM$^Ic`AhB?#$w)>B08JK8;=$JmH7<1pfzsb6gmH743{Y@A~B68sI
zY@;S%OdW<5H(SywkQ->QO&_M4o+oda&X%`x5)<L!RIYkYWvU`ipDlxoQHl@rgfUp)
zbVbt^=8m)7v@AnLF>rTMw&G@Gi)1(i``9Uor7vS>7nx-`$n$?FLX<S$Ztt#@kq7g`
z7))RT%nB(P2XH9{88)c8E9It7<Ac6tepj&4m!;e(Y7ND>c{1j!gLKMy`z_8@cTk2$
zu-57mHi@V^WaF^29DKP)xfe$}$1D>r%xD6H4OBaNMqaSIP_lvrk*Ih7-eVes!25li
zBAf?em@f*K8xsML_1UYaeJYu7qhZbb2cIM>A{2fe+#ri*nZ*09u&mLReuUaS=ziz0
zOdL_)93c;_xS`c%kEiu(@be|b6!EtHRk!thD%NVViGaqo6g47D)Fxqn+^C%@Ib%>k
zTK!Mg5wS6IGAD`i!_=TtkSpxQt9Drmlmk%;(niGmg!@#O8#x<KGSl(D&>&vD9WP-t
z&6TIbJZlC-WzHz=D&FRaCo#Y?NwE#%x6d25LK!zq`lsZf8BS8`l;eS5Fnt;%V8x-I
z(W#kriwQH}^RzR)<k|ag5W?mBT>0X3wp=|ZjTtI0Q7<@wR~2VoFUuKRNRSzp(Iwqr
z|DdceGVohw3Ko=jxgOENF|Bh?3_PX82`-)|<w6V4WP8C?Q<cz-O3haZ?xDi2Qd1YX
zZemdyG%_Kf?x~;w^vMZ&Ah=x6QwZ>3j=x^Or{haq8i_&UR?25yCSG$9zs2ZgAquL_
zdDYMe*ybn3ZN2qh9r?Qe_LVVI^_#Ikx5%8K0=T5|{#*k;4MuDWcBjb|v37is(0XZ}
zJ!>|WPPB{g_`Oy-y#eaovDKN3uE{I(xgCRD(pk#4Qb@zjl6(D$MS<-cemC}Y4|$_C
zip{1O!Nq%ii#mM#0EJuDqLrwbE_0Xo32d?iiKql34T)+EQv$9J>k_6r)=L5Qogon<
zwJdMU^$Tu8f8j9BMtiDUQvNNPSH$^I<4T?X>iC%6(pm#>r^DnlJ*KUyN)QyMke=#$
z-SzEj;veM#1J?x8%s@LY8lH|_#+!2EHRAfvpldyr;IfijovbE)+%+bnCvW~1TUIb*
z-0KNq{|4Bfm?kWjQT_*mGc$@dlY6>_mH2~XvvFUC65gc^c2TSUCq&|ykkzp!&*$6|
zwtRNRB&Js?xxOb>h~$~@vdzM<Gs4tOzK2#>@jDb%G;oEViLcok-tIP3S*YsFl2M``
z9%qsmdmje!yf6Wq)EYPag%ImW$I=mA?W19NQQ>qP7OO-n(rmH8beY~lF<gV`lZnI%
z?*}jSY5#un{qP5*v8VnLW$k3|gz7hL^TT}+j92LT^mf+uO-j}!zWMiB)==x33QxUR
z#;#1xaF5O1<_bBwt;sLKsO5ZbOZM3Gg6Co)cAKBG^zlf574GcD>C@KeV^_$Sm{OTl
zbBkeY<T{Y}zV2}s1fG8?PTDe-+(3f_2`#zu=B`zYArmrOm<;`pzYIK#?rgK1dcg}Z
ztIQvS@gl>F=R?hyLtEl)8O>i~3mAVp@Vx3K@`kcg2l)KNg>l<e&6uz<J?2CZ_;#&P
z$NNxCoUhX=c;4{h`}k`{1sC#Qh0$*9Vl||^C*{(ANlZeTK$SgLOV|YSVO}xHXwQz~
zOz(AaqJAv3AuYypJ7}c@B&b++dnQ;CdqZKjRldn0!{%>OSc)zz$`0~)UXSEtD;V~h
zrxEABGr2;j2bw+Y&~S_oRIeJvobW`M#pZcd8aklP7@?%7%qh$=fNq4GE%=4UuwSQ6
zmKja^x;LGnR&KbyQMya#9tW=J2q*ffwR=~xLratp0>O)A=2eTB^+fSRX6@a)2zdXx
zm5Fv-U{9G5(*TYWw0$V$0t=xt%!^|8@(E#u=lxVf0FFgU_mTLl>`}=--_o8ANkg!<
zbu`#fwUvKQrv9KYu*$3^MW>W8?f=kwikBJPo%Zp0>*$~`{P~qYzhc81;(>yQ{t8|B
z$$lEu$kFQ5cZI%gmtS3m5jTzXud9H`u@9;6<Hs1j_=EXL74F{j#&#!Haf4x7#0%9s
z(jo?b#7PM9P|%V@)d>?<c`7K^U`96Pc`^`Fq(4^?8dh_(q_U+OqTBxM^Pj492)mA`
z9d${F^B9kbDTU3W@S69<Zo9OjA44Vgwj^Jgo20^?I|JwB76iPPTX;})`L;f`Fu@E;
z8#>)U^Wo8OA~|v#B-JGYQ%?>z!%nfET0_-rPPo~+0b!zO?urb1-VJrJUPe`swn7jv
zjDXH=$_K|rkEvuO0B=Z9&W-%VAtn6%KU|D$CCz>WL5uWN$dEq+>ibah;e(W`sYddB
ziXCqm=&M*kiri6#M`{ejTW^!Y=NvgQpy+NsbdC8FLrO!eCV_Szn5@vT{KNWs3}nmS
zK|Q9asNaJxZLDgkRkIPxWQM$A_8W8?M}iH*uR<=Y6crm8kaZywkv}_TH8?)#XOik*
zCv=j(#~}SOYD)&6iD8$vdGwwEsHeq}?_9Pae%PLo*1sZzDZ@zJ8=~q=WTf!k<VcTw
zkd02xbD%<GC3I6?qVxOj7p`Q_>JW=NGmZU_0yE^+R1l%8gT`F65#IxTt)oN*yo@Mk
zfaKWy%FVRGs>^|XHFQDZw@MD=WNg~LPmqRByd85ukZN4sCRy3KOd4zw$+RAJUjc+h
zP@Q!H-=h`Mou6Rby*k7Q%B%RqRF^!8cFI&3z3Tpc+AkJvi^mdj*Q2<2?hD)yC2xkC
zddzZvhZEzCuJUHuFaEmU#6Wf={=3NeS|xzqWG<w`#6q)2ENV#9Qlghfr1i^BDHob$
zeAGTHW8;0OaW(dgV^8HRd+7r4MM>%Ls;fnObG+Cjo#HfBv8M8y{ayQU+OxUP%$Djy
zDj8?Vtv7kfBn;OeTlrJ0$+pX4^-6{K%Eo-eHs2UA?Bpl{<a6n?j~ajGO733=juIhe
zLg-R`o$IPBI$l91zl}qdiMs480y2lR9yExo`K~X}BWjaL2mOOXmsHjoO~#F6ZuQin
zHYRcKhx_TtUd63e{_rvHpb8Wg?=%=={{|Ln@fz(Mf5;r*T0sBc-XFseEr#u?oi{z2
zx|Gc?L4wHV?Ig@@O6fKj!n)=Zx+BGzQh}OGHp?<v$o*tdzjK4><&83g3FLXuK_WK?
zTwTlibp*sbr87_76KB_=*@P=Is$~)98wFU=r8Clg#~th$C}giy3l1?jAgyRk2P_)P
zhY!a%V3oT4UHGe7E4(XOXOAkX-ls{3>##buDLfSVB4@0Ghg{V5Lh)?hOx9Ar`=T+F
zC^aG>f12>pxu_>tGEVtgmMb=EDzk@~syU8UO0YMP>rg|F%O^ZfDnm3MaMR2IEGpm2
zjQmXN!I~S<vM@L<`5svq9!r_SU=ORSP<XljRN>-)4(!|R;%!T(3L8(+61@}Sx#CTm
z7f^z1?x?<!Jw=T>@(r7dY?DC{y*N;4F<b**Xf%(UCdtjEkDE_sO`O3K6Tm*($9tQk
zYGf{5+12xTX$)bUDKb43y^!}}A-&zE$ynpkwD=QZ&rLIBbJm-Qk7xts*73n7N^DQv
zeaaY4VFgSkAvmGX7_pBpq@mrjc35*qh}c=3F#+6$$FGuPzOtd+kwIOFX4|FOFfM2!
zBLIk%s6Bqd3cp#PGVnnOD^1}kiwzgS$l9GKYqk}Z!1#+4XOA;wL|mgLbJRL2x&gl2
zt-W}fSZzqp#dv@!4~Zl1MZdfN+7%T-a*$eJDjWkE7w|jBC;!#%o3P}HLCz<#@5iD|
z@s`3a#Li=A3*|)Ovc8ywsD`pzSr}nh5SPsH#hd*kT2Qs-&^W-*a@8QN_jkeA{Mt2Q
zL;d;>70Yd1pPrmu+Kg{pcQb)c0+^$wPnrO*#RNRI`3h_dr+n)dKjDFAa=n57O!F#~
zWXgJvSB|lg2G(QlE0YJG+K-Vh-3};MpGg)Kln(a!bAPf&nfDCEuuH?aU7h^hLbr<)
z|J6B4184DnS;|t>FuHv`pd-zt2+n+)(FI>hLR_@^KY?c4Dc=my)d%o3b|<SMEyoj#
z?)<=lmlYEli0>uFGEF;B)i%6acd6a?Q!)@HM2zuco`6ZKh_XbOloXXe9|Kfl*+1L!
z^qTyXrIC9eZoH@}=ib94b-RCgz32sbH$su_MFhaWEGA#X7v{0o0}9C#TJlvNaNnEc
z#7WeW3RaVgwv@5%3|D=SbNtwL8BgnTKU%#wsq}sK<2Q~D#$9O#hPiMtGO$l)h!}*a
z>|~%{o+>%VbX@Oj`{c(1c`vFwC}pIWUUaLPzYQh6{ay*c-KI9=p{hWvLoYx(o|tR;
zlsg~c>=l`&<N%pPR14%<huEp_M40ZE1aVOWtvy;0wW~E1`}R&IkoN<`tuLkujbZ*H
zswASCpQ#LkHaVTuVx&M5NF1Q%i0YPy#@H$PJ$591z+mDUPXVd>4TZL!QOS?%Pj8{%
z58Cw_B%)GOdIP#FAtKfwjDyoxn-=fZ2(YiI?8MMcrkYAUWgN-!8gR|^<deHB>Y)5Q
zl#GnYJbLRStM%6Vo9j+^xOS#cz0xQ7iojPwBOJM#b+`Tab=9*m*-r2*IvI6u7RK_R
z-!_gghOuZ$I@{1;Mmc1T9T~V@(_V1a*#wswvwtv`Or~pTCRAH0h5EBhxH~7B;(P=&
zRkaNhBx@|dv~ys12!j}dIJ!tkKO$mVv2+$I{8Li&Ie@nHgs5g0TH-;iaIPMeNHYXe
zN?koabh=QJYnh?Nyklg)fQOyf<VAr$sVn8?>>W0b6|0hHCfl~a;0~FP8*~S(xlH6^
zw00Qzjoxp9vd!3lvAwQs8|_3)Qd5nIlJh1&DxPoNI6vonz<Q!z6_V`Cj<$klKQcfz
z&Lpa$I-R5%nIcXbw;Av!=)n;BJkH;W6NPs3lYT#G!+iM@(IjiGG<)q&_NHQFOeIHa
z;U7@6u;bP5Cp9`F5|e8A%OS6h?9--9{gnKe#<9=xaG4U=clzhE^G%H}=3h4q-hYv7
z6>1j?U~eY&y=JchV<U9Z2RCGRlF+5$1eJUjZ(`R{O}j&k(Re~&0Ky+#ujbluza6oy
zIebauwRd-*W5AdDZQ9uRb;oUgfnfr{HIc5ZGTGap&o?W+<~r7{mP#LlIu3l|Y$+CJ
zpWC<7dT^jJTP%#wr!d4%Cav)hNkqf?i4(rJ#OG$j`;|S;o@gk5v$A}0t0s##4Pwm#
zlUEn7yjnhwDAxwg$C;wgfv`buGt+3&{TW7)q^GLGT3^Uf$?M`sevZuG5<rK?iMFs-
zL!x_<M0oi69!Sq$Yh3jjDY(~P7MQK^!0(6C1Esgb{~Pk<|0sa-pHMRoA){-f8SqY~
z+&YvP-J2*x^x%aWqG>hQd++=+TlR9K*r*;w5im_2TCkz->Zw0?bUpo-9sk;+zD%cy
z{x0k;Meu6Pdnla1`^=h3=MW2uu+$e#WP{hwYS+TQH*k7rl<79{Tz5YNsE9ap$ORfX
z*9SjeT^+UWG8y<j`OiST|6qvyS5)7>8vls&M)mmm*K6;*hE-s59*1km&67EN>6&0;
zAl=22HvI5<+`2E``p?9_;((EAgB?(a38f&FhS%!3BkQB(5lMvL>CFSbd}J&iKxFLI
zQHX0iknRU~ADpYP`Yc;UZCI9<`=UP;ygypW*VBJOfa`U!(mB%H`jn2+W9XsrpaKt}
zk?b{bzHq|t-`}E+4*#T1YuJb_ki|3Bk-PHaZpI(K@?QBT9GLEHYmI80ve>+T?#Y(D
za+=cVw87iNUb{eE%gjo2tN%w(Fx|K(wC!eBKlrOBI}A#Wq2aZCUdq<Fnc&S}Mf_#r
zajeSyx9Q97aNl%^K>pa-Qpxp)=p>WL`@4+_deTOMkh_6@MF86(MGvZga6E5*-$FMi
zf-T^GO-}vS&rb)fjF@443miIG_M|UT4Oz7E7cuSZ2=|wP$gs6lnANw)AZTZtLj)ql
z5#2lBG)|!)RlHb*QSC!H+KjD_Kr9e%QDb34X$)D;@S=49Cq%c@HM)a1{q`-tKzCj;
zO&(+Rvs?X!LfQ;^Uox!{(1@PL&&|zsu)iy2DJ?H6MXsBh8@H;LI`@HA&|(sVSV}B_
ztkL>bt4}arK4D?B;Z|B(&4AtfSe<#wg2Wz)S#v(1<LPSr?IN`pm?(LjW{HQb2-Tne
zI#Egoq?KQ*CqxY>=PQI+#?crKC})opAGxLqlr_Tfv`d~Favg;+jer@}IH9Ghj}1l8
zl=(uVxb|EM8SUlmJjGHq^P=<w^Su035pWDCypmHjT;n82>ATSrx#!@E_foNFh%de-
zDMxY%Xm#a<`zr-gbIn(vJp15CX96eYUtk=3abzx6R;MmiS~TPMxjrew5T6$c$vA5g
zh<sG@yv+hw3)Zi>`c*zfB@N98&JsQjgV-@yd>ka%1xr+@3N4V-Tt4ru(qNjp{wz~F
zzkk0b_wrjUSDQhfDp&i>cv>)J#xC4R?EuaMY{IdUT{DMcAg3B^{+2II!oEPK6l38@
z%G=<?+qUNIF2G)OxGV$9fw6F@d4KQml~VL(L1AYlAkc0Le-abpxY_i)&thnpy=1^D
zTn3_Onl$12-8=|Lj84)3tp*ESij8{p)O9}}e6J1MO*s3f<0nY!COpb&3oMySCzH|v
z%`8GtvsEB*mP5nK11(aB2A=b0+)I0Lx$M2*6%O&08kAnb9J@03Q;_&fzv3@iWHLdI
zrM)g_Hjfk2y+Mgw)lhvKVw1j<GY653pj3<IWGQAmYR?KKFN%sP5&5P!IXpB6S}9Uj
zt;fJC%K^(c`Oj0EZhc0|&@H@`I5cD#HQm=UGg~~1jvd_58o3e{sJQ*qu8d_Pfa&x>
zIYK-EE%cWqau*?k2u(A!?SIUsRU;3luLGD6_Xqt!{wffFgk?6~m`LYTl_PLt@unGI
z=K&`QtuRXrCX<VmBiQ*)Eg#m!UX&Oax&FHb*sQ9?nv5_bChDt++%iQ73<?w(b<eKS
zVSvHy4JB%qEX4yKFvj3@fTPE}>NY{upkp6<ofKNRR*MQ`K&%Sz%1|!sL(zXpL4{N-
zSJhb0YS`GJF2%#-N+^;^IpF{cYkb=~gVDm~R(Y+Yj^h`KBk~KzpPodvT(8<W77CbJ
zbJF7keI%(#JMw*?f*B#jBsH|5`8#_0$mfR8z(*#W5DP>(W@|zaoEQVij?_B+jL(jx
ziC9rApR$-qgn$2EL6yu%X|>5^k<Mv3KWsgu+IXW&Co_{;EVk?)$_cPU)6x-R0;3r$
zBvLJ$1jc_)1Zq!hdfp{B_^~2E9-Q($R>f~{D0i6*+oXlmxz?$mAtE>MGxjh&(lz1>
z(X&aI1kGOpBPc5#dsKkM5jXcoh$ZGuiyghoLieA^zZdc;K2pKL0P^*@$bM8V<F`yS
zh|?7`U0biFL`&?mZWZGsXC=yIIg8L6xjj#dLm;y0-N)pyq#f{lqUb8`@O_=Ur_7y#
z3mh6ZggzVv9|zS-)y!UST2B@n$HwK-3A?2=`j>=7VxBs%)&Zkt1Suk=#`E4g$fv_r
zp)bty<?f|D9(orJES(aAgNCM`%p!E>{d;VXwZN1c8KlHmQllc5H0~>t)(S~ukkv5r
zR0(G$di5fqx>E6hT7{yOrp9cttK~K6s{^u?c(@2xA-^_c);`DgBk&Id8RKYUP(@9U
zF|2;gx$|4oCzTBYPvFyUnC^GyDzM}brbm8>I2y<j-m-%JhzUjXNJ1;_KpOX!ckk4S
zYsxBdEF3a;NsXU?4C<fp?sRhLYAePA7tB9#qFwR;GWyV+pG1{9PG6j0N@UVqf0>F3
zy{3;}t@{*ZEz_R#tse5_2;nj@H#rqO&GFGqghQjfZ~K&OVeMiqa33!!rkVbh-K*Ub
zAtq|$D#onHP)&9HKuxKG>R}L798qP2pjCldFpAi#v(sRVoOAB!)>fk=&A!-?{!Jr-
zsVDg2O$QTF+#0I>_Ox+12JP<|LhJ%aKBNkpbH&516XqY7ntto5J?*@TRkoyL>m3B7
zn4zyT48q#k@pFU~m$y|M0)s7HT;h3C{;fhWAIl;&!B|Z-Xm-Ue2jUmw?M4Y49f#&v
z<Kan-&F?TVi^$^bid7lv_$1bt6wz1@8fl!1+U1uwe_xmV`ez{DJ!r=nkiT!5IolMu
z<KbV>zH26H7nM%&!k~EO!_8J~Dk{Ah^`Zx=KB>#J@zWz6;kZcU{afkZ-&4IIw;EH{
zQ_l`naikevnn3UHC3hb&d<fElM28RFQkE}A7PC?hf>&$Y`>|I;{)$NDa&`W{N-Q_d
z;p^{&nKA7J{@v!<K_BMI&GyD3)sJ6y^@@qpyDkwk6)1YL%r1-bUSGRzvqFVd6O)9&
z{JUp!nUCbi(xQR6;gD7UvB3ReJg3zI?XD?GW`O!RQ97`v8KL%WGcLEdsHb_i8Rk<4
zdl9s8?x-<U(GU83F5P8)c|j)|_Q6_VIm^O+zhE`=^+(~lC|=ng5}xMw3nuSiATVqH
zQu@tK@l|Y@7Kz2^oji1BE^g&~V0D2`j4W&t9*%0$XFQWb{R-#^?hi96)I<^ZsW@0K
z{vr-*embFu$;Dvy&Msh1V(`|<WxrvxpZX&vbQq`Jx2j*Y)IyE!Q7Wif?O$LtX;c6A
z1*w;(7kv23%(tQQ&HacAPO}$iFVYx4EHmV&rc7jb`wf5ce7wxaWsZAD%bQZ3vKA-{
z2^C;;8?RPNPN~q+SD{X&MK;$oVyTd7k&NEE4kO@;T3@68q+*w`E)6Eva0#}70+G)a
zaoyiBkD_I~T@E|NR=Ob5axxJ*p;(C#dwK_^S?XqR-K*_<ba7%=&Fsq%|4f@pPlMSd
zeTsV}jgVXLsClOiWiGlV<+2&65!-9E;BLbwww5j3`IGva$_fNjo``GctK2;Xe^`4T
z>|vFiNjc$b1*GNxi7o~QP{-8ts$RL#wLCa6+2>K>JwnW)A4A|(K+(=4m?Izp?J94=
z80$;|%`7dF0px{UOMF@CPJ2T4j&Nyh(RpU=eE7&D_nv*}O}(qkTlkpw&V(&7+{Yq9
zj>x0CrZVE!FDt)`k{xp;1t{Z=!+ZT^&hqn2b*b@%)uPzab9;&`#R0HjggJ=J?SXFQ
z4~K1sLZ1$R!q*9e3`lk|Y>v5jS2<inH%q~hzP%j+`97Zm4Np_GNs;}%BI1Q5xm^W`
zG6Z^7x%C&m`O;FL>=-8jV7!NdOj=##uLY!_2BLYBV|}2>rDpd*u?q_6GW^RT=kili
zn|t41mkKXGYZS+0$R>s!`o{rB<QXD}?&P&W+K1(pyW!@TrpF>ArVF=!a@vsPuTDi-
z)wH#_7_t)6Z7yv+($uJwU(TMdSUFr4*Hi(#FW<SNmjBK`&6T`cQ>LJ;aLy_~9?lAT
z05b%+#6CGWinLJa)skeE%)d}Y6gq~GSM`n9y{Oe`AKDP8Crua-XRiK!F{cClr8(<Q
zj)tTh``MvY8Y)se_oKF0V0bA|4w7C?w4K6s>`W36)xR3sK62Z?N|11i#|6C`Gs;N^
zNdAx~@jHN5S>2Kp&^x^Sb9x6*ag8Q2(+Ff?*#|o4G3^ci-ID&l61@mR7AR_gwxgT8
z#4+3u(Jv3ymXvK*+sRE?qSBEwwOKii8p0CiO?2BmN%>(Iv4Hn!U3A}Orz6_WOv!b@
zyPNXF%GJX^EjF|#-BIv{3o(CUm4hYHT44H%yQjjS8IfD_<AoN-rQKVjz@bfrgNTlJ
z*5ehwX^kJK&;DN`fd9^dT;9du(s%#I$g+hUKQNU`r`iMYODF$2;-^JkHn-yUTzcsD
zpLqTQVG6d%mEF}&Pq(9fJ@kB1=FwS*%aM3!{|`C&ae3hIzf+bzl0mK4KL3I*t*K0|
zr*?}CeA{sZJ+3mRr+=XOQ`{XKKCqUF$ISnLnu2$k|6Eld#eLr{({sLQ>tE>TZI|wP
z`t53LJa>;`eVX_zPBc%<?5@fd+_%nk+1{)!R_G>mb^Zw@X7PHId1Eu<XC;XL?0$%)
zCGF6km`m_)&GVW0PREVB59{SEt!ySQ@95a~`U@X;%ZBN?2V+ZLJdl5%Y$W<a>mB32
zKued4Nwy7cJ~b9&jFH{J|DzPN|9i{!-?G{K^$<fAH9OtWh~i0j`Qd%DzXaku*+2w!
zE6>ul8!R~`w`j<#^s0O_2^9Z6f5XGF5-sK*0W(z6_P~P{A;kBMB#fZGRAKN*7UzOR
zFkCP*2A-*02>855T4c^AyP^HH;$<5#5{nG@&GoByoS)c%<`$Xtk+_SK@YXn&eN$hU
z7IQ;TgDozAov>1pj{L~mvlION>NlkOrUpJ!(Hf!j%tYGYzKAKQ5{_5QbxUqe7(ru{
z^_tuX{>60&<YK%yP?LPwoqX-6YS!)>iS+tbCj1u3`?ToFy3-Dgt?*GMI`vSdS}n7M
z{q(UF)Z*aH=jAUl4mo0~MucsHEGt>pJaP~%W9B|4zeyl$dgkFZOyZ}BDkFz!R4ndO
zQ~AjkFm|f}e7~rCX;rtU7(t+EI8vBDicpPr{q8vMUQI(vOdC=ObtFfd^JgkjpYlk-
z!-xl>OxqKU1AK|t@w7aI4C}rYwlf}}*bY4Y<1@tlF><pHoZXc)s(Znw950Vv3q0f^
zuf3LlRGOiqX=Sq517VwHxtWu^fqkz5CtsH&>R1dks;3sETBTE}5Yw7nms)^KLTl%P
zay*6sW?aNrL<Hc-+Y`Dl)0?})Isj7oJ+m*9$JKxxs50BfM=*TZ`jEyf(;E%hmrkIi
z#e}I8RrfY(LmX^g#1t1*e|d=SCBGJXsRreWSMnO6tcACeRY3HAyMBzwk5ILxFfUt+
ztnNDRMdZ@qsH@4_4zBV$Jx$ocUX_->Emy+pZfV$cxragb5Mp6aw|*ljDC=oe59l(~
z0M8uUUXZS7bdiTL{sMm_d;$TUTvkN4_AoQ%U0W?Ey*;Vc_ZVtn`FYX^%D1@y8f<rG
z88p9!A_`AT{T>E&ie!Iw82$Sd;(SQAm!uZ3m%+5G*`YJFc{1>O1IM;({8M4;l$z`%
zIuI6#+nrG(=7MR?toO&@%~$v_-qmA#yM|LeeJN{Ah~Oh@W~y7e{vK$yFZ`JBJibi4
zL%{cc<+KPdoZ$M6NW~8JoGqF3&`xV01;QB4IjycWQ&OfE*-AgT&&yAF-dJq@tN`*d
z9;d{2H=tSEJy(U<f8;Kh{LldsDOYM=TJr{)E!NkiQXu_<;cT!M1nC&zu}UgK%)6(!
z0TWD<0kkC<OC@E4Y6vFEF-<yAAdEO{0{-L#7!?oETU>r-QR)BUPHa!5JCGqP;lTY+
zMiasT%Oiy2K^NdU&y~W1b-5Vh(PVS{fz#8P(AsX7b}&&Xn_5xr;;wyIAZ3*9i@8^8
z*^~wl9|YY}lg8kCIDutcAuW`v(D7&EloXzETIjE?QeH$71ksH(J6v0I<NpZ)|MoMP
zkm#$G+yJ%ACjb+fMWg9kYqcsEjl#SdOk4}torYREMA-Vk**cjq^Q18~eHSa%DG~r=
z3zNZPY^0HR5TIt6EpI-|2iN)i3$$T>&}(&asRmb-4IAYr8&t84pqh}cKS?EgU&vq^
z*Bh38dG}7!68HQASfVBJI%HO(0x$uTF0r%`w3GVAQrI}CWaOWrT=#RQn|2RX6Aa_Z
zmA#7P>KpT2L-BJr%AQ{;wMwmuj%Ru~ypdp{@;)iu9@frji`F|-3Pg9DJxqkF2L#jM
zY^Gx$D1>Vqjh`cp!p((MDMmDg?E$1KE2&1?!S3-T%m0V&!hd_I{!jGhzYBx@o7nbX
z6{~pRh42v<0d>^TeJuYt+Fsu2pzg0L!W-U2T#=MphY_Q-K|Z<L7l1lV%-Gkv>F%D!
zgB91geU(@|NW1;HUqP!G(fW74%ahnvx!Zgd$?O<u>R%c5#0LG70Z?NZ`;as6@TUu{
zA3Zcsx#`pSFrHC7WHz8_bj4~<OJqqW{{Pxv8qTnEn>MY1>p<7$vUQ$Vs?n`~7x3Ua
zRa@|~Ge#|1xa)XOX2d)9sT58rbsF~1`Ps6KW={EZ{9HB!|Kzus_JsYt)Bj@$o3U5X
zZMtx!Il=jR2;p$L<2FQgt~A<dTwPx3Exme3mk?mz<AE8>eJno=C4NC|(ZHb!JrJe-
zyLB%2;D&9JpuT*_lL-E6jjD1E0>%%K@&E0Hj+L-4p1pF;8IFa3qsSpMd0b8rGlRP_
z<ir3HWtai87cfl7rJ6myG2#n^6AO*Ums!<mH8l<G>mJ*hTDLh;3hdQtF;_nq*yHN<
zuHP75T)BvzekBOgL_Dg8n`=%jvgJrf&?mCi1kkPCQkBftl^DmH&YG|7^tfzyfLIwa
z2;;%#_d;k_^_X7OhN)Mz<uISg3a61>Bn9Kc2pVCP5jffs6%HiX3HPPC$JaulbOWT7
z*J)^#LtLVqYp6(e6n;M$@HyL$5EU&3YC_eg%9$!^4vXeoV*T5FB`AcX4<p$UGmS%w
z{T|qQgkl_}5^Sl;?oeIFvTg)@NVr7@CSkMP3j^4qZzP-s?K~oil9qow42)^yXN<Q(
z3Mw(!CI`<#*bU5CeyIWgq`GP8pLgqS`-9<{KG*Zihyb`x+q@<qfKN;y8!rl}lcS}G
zLyO57&;Hd@AD;?EJUT<55hRb-0wkXxuVh3SO?WabAbkzt<0;e+GwunS<;lg`6JXBY
zX<(*Ba+Q7L<0UV59(}lUr%5C^tZ7oYA*!Xb2fdZ%@oUvXBU2M6?QbFl1@`--E}96#
zQPpic)uC@HI;(;3hWAaSoyO36y9s4$!d`sD#!rJ9-P^uD_3pDzZXgfhSE_uu^J9na
z><nZTfQSJ%joj9M)cX@{kamw9&Hq~`*BR6V*0on!kgl*1fheE?Y7m4FN&v-BM3xYW
zEFl(3B1r)0pp+NsAP}U5BApdN2|@^o7+C4Ws30{V1Qi7-0V`!i;LCnLzM1cRXaBr2
zcjn$d&zw7R&&)aJIrlt(!36YSNTXza>cfPF5C^h}j+|h4R+wxDBRFRf^^X>VnG~W4
zEa->u<MM>lo+PWpaj4kRkh@kGi^>b5nxS@-f9V0U4nm>lFP}O0+g8gK^QE7NhMGhR
z7`Clc8zgbvEPPX$3)mSgy8E%&v-DU`N;2Q!3D0Qua6^ABuQPXZ`A-tY-;iu38JYm(
z2CNzMMb0#EaOEnOQGMB5c8O>0YdYc`(uQKavz=J{dd=PSBH<n!Y$y4!V#s=1+xMCD
z@@wb@Ea`ilHrKN3{!fWT6p;vH9;IX8Mr`NQpj2j=1iHc&t9-=I(V6TWJ$?DQs5_cT
zU7i@uHnC6@ZvodTtk_F^CQX{(2C1a^Wr(lx<d>#`F0U2o3SC0EPqnx)9*61kAM_I-
z-G_tRJZ)FWoUQ@w`NAEy#TgQMp6~_hu<}Gx8Sz({97|oFF8C|OGW+Z)S!_$k=$#5a
zs!4@R#190FDsf+hhYrQx&4NF$wZ1UOP9rBR7u_E!F8qAij<_r#G<M@m2UTUbF&@;~
zRRAyI%%&vOvU`BuBDG5$Tv~}sH5@o;Ct?b(M5suIZ+_8l!g<9)GH4&lJ@Qg|&Zhq`
zJB!j~mzE_<5BaLVFVh)$;HcoR3n=6R;h@=?@o4nVXHmh8k&qlP7ZE!EYKxNdK$&2S
zNu_VMurVBSYaK1g3`WoxLHfZXTk6ope1P+ZP~{zpybZ~9(8CFw{$}|^`rOFJQ4@u_
z(RJW36`rXX!NhX1sTZ37RnprXa6q$GD>KQyol$}rx|+qJZkG{FCB>px`O^xvqX+U`
zE|Sb5&o-~+EGX{rZBZD*R_KQm8JwY{o>`%+N!T!zQkty)WUsawGEt%9hA=iU>+dpe
zBX^}!RXofUo)7G-$mJQBndDPddgVfDM?3ZvZN#|)(GusnMr@FGg=;|0(ySX%H_Ikg
zeLSsGvBoVJB%bQ=CkBndIJ87lDaC8vWsm#~=njo^E#*&jW2~0RxeGL0o-sKY=I7{h
z=g>3_U5nHK0PvqafzT;l{_^vsQ_y3KHtn4;=htV&6WxHQBa5U3Tsgt>w1XP;$%Ldh
zwtI&6zO<U2J9uwVT0N{sR2}8ZdVcc-In`gb*=arTNBg?xp;g8G3tigWJVg-T(N1(K
zmh(vW0^t$@!>F4Z;UA;Pxb&%YRP<BJ7CdC1twTy9vq6f}3O4xeoUG1IujuSea+>Sf
z`a37n@!Rqvp%b&*TpvHNng+*IY<5_^PY}6&lPh*%FMZLJnDCXLH9?h%Oo(WH9H|@d
z@aMLU7Rv)011DoS#;rm3^nnh&xWfGOVXAzgn1ouv0{`a5p66=U9tP<f-qL8}F{A01
zbRD>O?cWj&fwI8jjS%FCHvill<W?M-dxXvUn208kx)s?+Rx{WV&sp8y<Ory6?bYvr
z$OZARqb54_HjV+|=R$uQIoJlae@t*-2)oGF9tuZI44!!L)aX-Llz$A#&8Dd%i@tzp
z9dzBfLeh6wg7tvYc}H6&2`r!;r0eO*u$s_@%OZ-7?}5Q^SXl_}>q#dCMe*N>&ZonZ
zYB+g5aqIQ2J908pG$q}{DD=sw`kV8PlFCE;@|~Ve0n<sVI34E8z?OQLA6cZpOuL)B
zYN;>fA@!E1aBfdhGF0_zT(mq*+RUmiR#W$yUdI(GxMVE@W88+=lEv5b)r8H`E4(*`
zr<&MwwdZarmrAD&%C;Yp(mHzBs!D!EL;Q@&#gnb}*IzZKX+IBE7oJ^~)<8cgNi8Lk
zJ+;G-2}a((lag_e%xb#dA2Cl`Pbq(On#PY|U`DOCsbEz}`?FyglGxAiAknAs$S&wZ
z#VlOueBC=Roet|s4yN{_6HMW#a4nm$d%fhEw|DgJQ-lnIVXP{!ah^N}bV=749OoF{
z=+oW)w$0jqqWR{g>)ebn&Y~*$AxlQhZ6tVN*0&Auu9aYV_X=;)9j)*PBvSqUOgHsA
zzy1Chm5PH3lH@i-_7PYb(l;-Gt{-y?zH#R^oAONiG;3;##A6(Sn)JjOB7}0Wo~Z9-
z4cf!N%)y}4gDHGbFVKCrTFNjLfV!G-F3|e(t&qodB>Cd-Z?r7%D0*)qIKt?g0XRJe
z`zHVOEYRvbeJ<qcB2op_S5R$st;69RZzboEeJ61y2FvL=6i;Lb39+g$oZKRb;<f`<
zj0h4wOYQgjE6lC~TfBA@wDIiaLNrNZp(NtRNjMWQ@%W^cnIPP1YwFAl9R5xO%O7_S
zk6i#t?<DIx;Jrof52bj?yjWO2<`iEw2xdq5?I`#ZMPN82`0?B0bJ|3dP@El*pBWul
z|GX7OlCm_I5z7GGQQc$bKd~Xrx{@c7i=eWU_sMoZ@*<2rquvnmbZzKT{<%!}i!qh5
z;IdPSPXyOK|5iyGRcMyK`{wj8I{-bnV}nkSwjojA`S(;(Jp%Y?>du0Krq61vx0KRp
zEjWI^!A-$eRzegW{Mmq3D|n<_+u1{0;Z*8X`#`ZqCQ5g@=0r|01w;BV%_$prfM$`R
z0oYEbIAt){bU&fDB17hmXfwDIS66v}p%fPtr+>+fbOW*mwFSfxN+DkV8Qv91R&lwG
zpf)Apo!E`#3u3v>MJ-&M2&S)F#tqni+Ws^~n!i6;>$75<Y%cSniy_Dq4lA8+^fwUO
z%=<Kc{>5*=667~6-4kz~dZNUQW!|2ekt`g(Bu_Zzwx%j5E+sACxOA7L=E+%q|KkQ*
zs>ld;&7CN@MhdWBgGrfcQnB~m^4JeVrzZuj6i%fn(E@A3aI)w-G{zfTH+{5Isz40C
z5&$5Ha`I#T)qEg!oWS?qaw=AB?OY3WOtcQtHgG6owq5vbBQ8DAj?=U+=a-YY?-0Q!
zHZ-jhy5q1G<oywu?;^hIP>T2JwulDyp2jYl<_eALyCxtjxb)44;vZ-6a+SRJFT1kM
zle{lbDZYc5ESCb}_eWZ4vL$f60^`}&d-==vRM(NMrnu`0=Y^`u>IMg!*C&SSdTv0<
zr4VWf%wv~UxiQ6mIKLFLupLkPwPf!z6f9X)+`AlNQ>U^DwYL!~lH&iUJW}dVGV&_1
zcu;jR?%EX1CvgyAbA@z~DAi9@4VF1G{eeu-fS1H)xTCzLWhFjVPgT14v|}tRHfi`z
zf$lda^`)7nt>EqgtE9>tQFBI#u~Wq9?#d#!^Cb_BXjk5|Po<Ywj}#&0)8`3valR!5
zp-`CiEX)mPDV;N>mQEMV$gt3Fq2pfpWaucJLyabw`Pbhdq6QpEuS_MQ!?TP4-&{cN
zg~UIe;P76o<og&enA$C2IQi8re#gDK(p?gBWW;^&y>vA2XSBp^m4+D-bny-rkK@*<
zn@f3(-yn%PKHdyP>85aJd8DiAFhYlLhJxjfR<6RP5h%a1Y~c>`ZsTHNfXA<y^*(WP
zl)(G)tBN<ZMZd1evEundGX@1<h<pvN<L0KH21+LIW!iJ5-|JC?QM!ivC{yf6_1VU8
z$rl}|CSXam>MURefWdXj-v&?y(u%jn5XM@}7UncNV4ki=i0hOoIYfF$v4(eQ&ivZX
zk1_82WYN$DBDb$Y+<@~Jt(A8<VFR$v(78|ssL&G{>INLH*y@7Sp3zh6@vF;Jb=_<Q
zLv4Ka*za~#t<1QC1tYilj(=$dHiPf$!;v4H5#bZHEMR1o5ClP$B=y%AH(M+`c<^lq
zAp7r(bbsLidD}Gzpn&`sENiCZ2E;Ie-j$_F<fa)W=$i*SxB)+mdWi2Hpz>S6YT5ly
zqj#gu7Up8g1b%n4M|T=*XM~C4=s75JVVS!;S8rMOb;CwzG}|QGUdAI&N{R3uxAXbQ
z+6qJBQ#w&L;tz0CCVi4USQ9iqvbX%jGo;}z+r0mM*Y>RDowt-*zYOv`P;?jAp6fWF
z{GxfpR-ya3QWZ{aqY2M-OS?gP%J-$?+et6w@JGPeiP3|#YJ|6ZXMg^|dr`=b)_%iL
zN?miW1b*#4gxcXUA8>#D(shiM;*>yzpB*BV%r~a#RF-;uZwZUOH$ZDPe#CCO3-+<{
z3-H!&A76Y8h4%NBI&?jp>e|#dPsCaX+A6-kOSc8xK2p4X0Davlwi39QsEmm6<*X%W
zG?~<7=!HAyf|QkMf7-unTUY`!<G@E+z^OT+#WG}#C)))YV?01Qzv^3dNmwqDmk#c%
z1^mnh4*!*?^oo!@TPjA~kY~j&Nw;l%FH4=+{GhmZ0#%$zFFuirl(E2!hlY!yi1=MK
zO8B+-yQ%R7f&@Q@Se7b1EMqV}*X>d8EwY#YnPRPj3anx}x35Amf%wkfo~WQU8!ytQ
zZ=uAmlZ1a~4ui7gc?ILT&Wx*<>#tGYHoh_PuUSb;WmAWaD)^(qE50lAT{%h;U0$Ns
zGa^mtmbNK+$E6MSSF%Y`Yp-w6E<Zj<&#gqDER*|r22ibLaB4#c=ln!-YKfJyzH*c+
zI$gaPDV!U{m~3KdiGzEJ7PGn=gooq|@ej|T0t3r;Rq32tD7gZ#I*1@hM@_sNae{ZG
zg!>+^`O>y|bwc&|z@TnY6(5fS-99d8OvmI@)||Njcx>87RXvBo#EyIa^>hh2pbjCa
zxICwOLhr(+gAzArDJT17uFk}ZcVdl$>%D}2AMc^6vd`H1hP|2P()HWxZ3?9}cxE$%
z!C}$&Q}zB6uju^Gk(QDlg8h_FAwvF8x>y7ueHHKps{9Td65x3J7?{Q3(}<IeZ{t)>
zd6S#LK4UbOT@*{=gVs@a64p4kG?(P}lp4d9xK%!`_75@|`&bd`&xC2i{*2^(rL<WA
zb+sj+u42FaZ<FbQ<>;JZJ=n1S&_46;zJ^e?gjMp2fQHKIBJG!-C<uBV`?Fe{y#psL
zEcS|jmfau9kl#NfwDFE7&~8{e$LYxcmCN#e^<?F8|CXVMKK8GmknN^lra$pK2kxVL
zwE^d)dUgNnr8XZc6c&(YUAC(8w`Sz2P%F1kjAtm;#5))(*nZK|)q`m38fl-`b2$$+
z(Kj^FH$JPYYoe<wf&$R~AHY8VgTHn6p8;Va&%^})t^czSiucEcgnIf1{xe4XP}#Hq
P^NXz&!m{a-NBsW)Z&DkH

diff --git a/docs/workflows/genomic_characterization/freyja.md b/docs/workflows/genomic_characterization/freyja.md
index cbc5478bb..7be6fbe1f 100644
--- a/docs/workflows/genomic_characterization/freyja.md
+++ b/docs/workflows/genomic_characterization/freyja.md
@@ -1,11 +1,5 @@
 # Freyja Workflow Series
 
-!!! dna inline end "Wastewater and more"
-    The typical use case of Freyja is to **analyze mixed SARS-CoV-2 samples** from a sequencing dataset, most often **wastewater**.
-
-    !!! warning "Default Values"
-        The defaults included in the Freyja workflows reflect this use case but **can be adjusted for other pathogens**. See the [**Running Freyja on other pathogens**](freyja.md#running-freyja-on-other-pathogens) section for more information.
-
 ## Quick Facts
 
 | **Workflow Type** | **Applicable Kingdom** | **Last Known Changes** | **Command-line Compatibility** | **Workflow Level** |
@@ -21,9 +15,15 @@
 
 Additional post-processing steps can produce visualizations of aggregated samples.
 
+!!! dna "Wastewater and more"
+    The typical use case of Freyja is to **analyze mixed SARS-CoV-2 samples** from a sequencing dataset, most often **wastewater**.
+
+    !!! warning "Default Values"
+        The defaults included in the Freyja workflows reflect this use case but **can be adjusted for other pathogens**. See the [**Running Freyja on other pathogens**](freyja.md#running-freyja-on-other-pathogens) section for more information.
+
 !!! caption "Figure 1: Workflow Diagram for Freyja_FASTQ_PHB workflow"
     ##### Figure 1 { #figure1 }
-    ![**Figure 1: Workflow diagram for Freyja_FASTQ_PHB workflow.**](../../assets/figures/Freyja_FASTQ.png){width=25%}
+    ![**Figure 1: Workflow diagram for Freyja_FASTQ_PHB workflow.**](../../assets/figures/Freyja_FASTQ.png){width=100%}
 
     Depending on the type of data (Illumina or Oxford Nanopore), the Read QC and Filtering steps, as well as the Read Alignment steps use different software. The user can specify if the barcodes and lineages file should be updated with `freyja update` before running Freyja or if bootstrapping is to be performed with `freyja boot`.
 
@@ -534,19 +534,27 @@ This workflow runs on the set level.
 
 The main requirement to run Freyja on other pathogens is **the existence of a barcode file for your pathogen of interest**. Currently, barcodes exist for the following organisms
 
-- MEASLES
+- SARS-CoV-2 (default)
 - MPXV
+- H5NX
+- H1N1pdm
+- FLU-B-VIC
+- MEASLESN450
+- MEASLES
 - RSVa
 - RSVb
 
-The appropriate barcode file and reference sequence need to be downloaded and uploaded to your [Terra.bio](http://Terra.bio) workspace.
-
 !!! warning "Freyja barcodes for other pathogens"
 
     Data for various pathogens can be found in the following repository: [Freyja Barcodes](https://github.com/gp201/Freyja-barcodes)
 
     Folders are organized by pathogen, with each subfolder named after the date the barcode was generated, using the format YYYY-MM-DD. Barcode files are named `barcode.csv`, and reference genome files are named `reference.fasta`.
 
+There's two ways of 
+The appropriate barcode file and reference sequence need to be downloaded and uploaded to your [Terra.bio](http://Terra.bio) workspace.
+
+
+
 When running **Freyja_FASTQ_PHB**, the appropriate reference and barcodes file need to be passed as inputs. The first is a required input and will show up at the top of the workflows inputs page on [Terra.bio](http://Terra.bio) ([Figure 2](freyja.md/#figure2)).
 
 !!! caption "Figure 2:  Required input for Freyja_FASTQ_PHB to provide the reference genome to be used by Freyja"

From 3125c0bf42cf08913e67202e40c6a54497d875b8 Mon Sep 17 00:00:00 2001
From: Michal-Babins <michal.babinski@theiagen.com>
Date: Wed, 11 Dec 2024 18:01:42 +0000
Subject: [PATCH 6/6] remove redundant text in Freyja documentation

---
 docs/workflows/genomic_characterization/freyja.md | 1 -
 1 file changed, 1 deletion(-)

diff --git a/docs/workflows/genomic_characterization/freyja.md b/docs/workflows/genomic_characterization/freyja.md
index 7be6fbe1f..fc1094204 100644
--- a/docs/workflows/genomic_characterization/freyja.md
+++ b/docs/workflows/genomic_characterization/freyja.md
@@ -550,7 +550,6 @@ The main requirement to run Freyja on other pathogens is **the existence of a ba
 
     Folders are organized by pathogen, with each subfolder named after the date the barcode was generated, using the format YYYY-MM-DD. Barcode files are named `barcode.csv`, and reference genome files are named `reference.fasta`.
 
-There's two ways of 
 The appropriate barcode file and reference sequence need to be downloaded and uploaded to your [Terra.bio](http://Terra.bio) workspace.