From b9bcc3c9d2dc9dc83d9c0d4542d30fd1100f456d Mon Sep 17 00:00:00 2001
From: tiagosalvado10 <9038083+tiagosalvado10@users.noreply.github.com>
Date: Tue, 6 Feb 2024 16:26:25 +0000
Subject: [PATCH] [MNT-23960] Added new options (pdfFont, pdfFontSize) to
textToPdf transformer (#885)
* [MNT-23960] Added options (pdfFont, pdfFontSize) and NotoSans fonts to textToPdf transformer
* [MNT-23960] Added 'MISC_PDFBOX_DEFAULT_FONT' and 'transform.core.misc.pdfbox.defaultFont' configuration to core-aio and misc T-Engines
* [MNT-23960] Added NotoSans fonts to core-aio and misc T-Engine images
* [MNT-23960] Improved logging: added messages, using placeholders
* [MNT-23960] Added DEFAULT_FONT constant (NotoSans-Regular)
* [MNT-23960] Splitted getFont(PDDocument, String) code into 3 methods. Added Javadoc.
* [MNT-23960] Return TransformCheckResult on transformTextAndCheck methods. Added assertion to testUTF8WithBOM test.
---
docs/external-engine-configuration.md | 4 +-
engines/aio/Dockerfile | 1 +
.../main/resources/application-default.yaml | 3 +
.../alfresco/transform/aio/AIOTikaTest.java | 4 +-
engines/misc/Dockerfile | 1 +
engines/misc/LICENSES.md | 1 +
.../TextToPdfContentTransformer.java | 296 ++++++++++++++++--
.../main/resources/application-default.yaml | 5 +
.../fonts/NotoSans/NotoSans-Bold.ttf | Bin 0 -> 582604 bytes
.../fonts/NotoSans/NotoSans-BoldItalic.ttf | Bin 0 -> 596992 bytes
.../fonts/NotoSans/NotoSans-Italic.ttf | Bin 0 -> 597000 bytes
.../fonts/NotoSans/NotoSans-Regular.ttf | Bin 0 -> 582748 bytes
.../main/resources/licenses/3rd-party/OFL.txt | 93 ++++++
.../main/resources/misc_engine_config.json | 4 +-
.../TextToPdfContentTransformerTest.java | 193 ++++++++++--
.../transform/common/RequestParamMap.java | 2 +
16 files changed, 555 insertions(+), 52 deletions(-)
create mode 100644 engines/misc/src/main/resources/fonts/NotoSans/NotoSans-Bold.ttf
create mode 100644 engines/misc/src/main/resources/fonts/NotoSans/NotoSans-BoldItalic.ttf
create mode 100644 engines/misc/src/main/resources/fonts/NotoSans/NotoSans-Italic.ttf
create mode 100644 engines/misc/src/main/resources/fonts/NotoSans/NotoSans-Regular.ttf
create mode 100644 engines/misc/src/main/resources/licenses/3rd-party/OFL.txt
diff --git a/docs/external-engine-configuration.md b/docs/external-engine-configuration.md
index 33cde1e1..606c787f 100644
--- a/docs/external-engine-configuration.md
+++ b/docs/external-engine-configuration.md
@@ -39,6 +39,7 @@ The following externalized T-engines properties are available:
| ACTIVEMQ_PASSWORD | ActiveMQ Password. | admin |
| FILE_STORE_URL | T-Engine Port. | http://localhost:8099/alfresco/api/-default-/private/sfs/versions/1/file |
| TRANSFORM_ENGINE_REQUEST_QUEUE | T-Engine queue used for async requests. | org.alfresco.transform.engine.misc.acs |
+| MISC_PDFBOX_DEFAULT_FONT | Default font used by PdfBox | NotoSans-Regular |
## Libreoffice
| Property | Description | Default value |
@@ -96,4 +97,5 @@ The following externalized T-engines properties are available:
| IMAGEMAGICK_DYN | Path to Imagemagick DYLD. | /usr/lib64/ImageMagick-7.0.10/lib |
| IMAGEMAGICK_EXE | Path to Imagemagick EXE. | /usr/bin/convert |
| IMAGEMAGICK_CODERS | Path to Imagemagick custom coders. | |
-| IMAGEMAGICK_CONFIG | Path to Imagemagick custom config. | |
\ No newline at end of file
+| IMAGEMAGICK_CONFIG | Path to Imagemagick custom config. | |
+| MISC_PDFBOX_DEFAULT_FONT | Default font used by PdfBox | NotoSans-Regular |
\ No newline at end of file
diff --git a/engines/aio/Dockerfile b/engines/aio/Dockerfile
index df305972..47fef57c 100644
--- a/engines/aio/Dockerfile
+++ b/engines/aio/Dockerfile
@@ -76,6 +76,7 @@ ADD target/generated-resources/licenses /licenses
ADD target/generated-resources/licenses.xml /licenses/
ADD target/generated-sources/license/THIRD-PARTY.txt /licenses/
COPY target/classes/licenses/3rd-party/ /
+COPY target/classes/fonts/NotoSans /usr/local/share/fonts/NotoSans
RUN groupadd -g ${GROUPID} ${GROUPNAME} && \
useradd -u ${USERID} -G ${GROUPNAME} ${AIOUSERNAME} && \
diff --git a/engines/aio/src/main/resources/application-default.yaml b/engines/aio/src/main/resources/application-default.yaml
index 51e31f8d..e6b06b77 100644
--- a/engines/aio/src/main/resources/application-default.yaml
+++ b/engines/aio/src/main/resources/application-default.yaml
@@ -24,3 +24,6 @@ transform:
exifTool:
windowsOS: 'exiftool -args -G1 -sep "|||" #{"$"}{INPUT}'
unixOS: 'env FOO=#{"$"}{OUTPUT} exiftool -args -G1 -sep "|||" #{"$"}{INPUT}'
+ misc:
+ pdfBox:
+ defaultFont: ${MISC_PDFBOX_DEFAULT_FONT:NotoSans-Regular}
\ No newline at end of file
diff --git a/engines/aio/src/test/java/org/alfresco/transform/aio/AIOTikaTest.java b/engines/aio/src/test/java/org/alfresco/transform/aio/AIOTikaTest.java
index a1007538..40b3068e 100644
--- a/engines/aio/src/test/java/org/alfresco/transform/aio/AIOTikaTest.java
+++ b/engines/aio/src/test/java/org/alfresco/transform/aio/AIOTikaTest.java
@@ -71,7 +71,9 @@ public class AIOTikaTest extends TikaTest
"startPage",
"targetEncoding",
"thumbnail",
- "width"
+ "width",
+ "pdfFont",
+ "pdfFontSize"
),
getOptionNames(controller.transformConfig(0).getBody().getTransformOptions()));
}
diff --git a/engines/misc/Dockerfile b/engines/misc/Dockerfile
index 863835b0..9085bc94 100644
--- a/engines/misc/Dockerfile
+++ b/engines/misc/Dockerfile
@@ -19,6 +19,7 @@ ADD target/generated-resources/licenses /licenses
ADD target/generated-resources/licenses.xml /licenses/
ADD target/generated-sources/license/THIRD-PARTY.txt /licenses/
COPY target/classes/licenses/3rd-party/ /
+COPY target/classes/fonts/NotoSans /usr/local/share/fonts/NotoSans
RUN groupadd -g ${GROUPID} ${GROUPNAME} && \
useradd -u ${USERID} -G ${GROUPNAME} ${MISCUSERNAME} && \
diff --git a/engines/misc/LICENSES.md b/engines/misc/LICENSES.md
index 3fe03d83..8c7aeeaf 100644
--- a/engines/misc/LICENSES.md
+++ b/engines/misc/LICENSES.md
@@ -7,3 +7,4 @@
* commons-compress, PDFBox and poi-ooxml are from Apache. See the license at http://www.apache.org/licenses/LICENSE-2.0 or the
[Apache 2.0.txt](src/main/resources/licenses/3rd-party/Apache%202.0.txt)
file placed in the root directory of the docker image.
+* NotoSans https://openfontlicense.org/open-font-license-official-text/
\ No newline at end of file
diff --git a/engines/misc/src/main/java/org/alfresco/transform/misc/transformers/TextToPdfContentTransformer.java b/engines/misc/src/main/java/org/alfresco/transform/misc/transformers/TextToPdfContentTransformer.java
index 77ad0321..c8643d0d 100644
--- a/engines/misc/src/main/java/org/alfresco/transform/misc/transformers/TextToPdfContentTransformer.java
+++ b/engines/misc/src/main/java/org/alfresco/transform/misc/transformers/TextToPdfContentTransformer.java
@@ -26,16 +26,10 @@
*/
package org.alfresco.transform.misc.transformers;
-import org.alfresco.transform.base.TransformManager;
-import org.alfresco.transform.base.util.CustomTransformerFileAdaptor;
-import org.apache.pdfbox.pdmodel.PDDocument;
-import org.apache.pdfbox.pdmodel.PDPage;
-import org.apache.pdfbox.pdmodel.PDPageContentStream;
-import org.apache.pdfbox.pdmodel.font.PDType1Font;
-import org.apache.pdfbox.tools.TextToPDF;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
-import org.springframework.stereotype.Component;
+import static org.alfresco.transform.common.RequestParamMap.PAGE_LIMIT;
+import static org.alfresco.transform.common.RequestParamMap.PDF_FONT;
+import static org.alfresco.transform.common.RequestParamMap.PDF_FONT_SIZE;
+import static org.alfresco.transform.common.RequestParamMap.SOURCE_ENCODING;
import java.io.BufferedOutputStream;
import java.io.BufferedReader;
@@ -48,12 +42,31 @@ import java.io.InputStreamReader;
import java.io.OutputStream;
import java.io.PushbackInputStream;
import java.io.Reader;
+import java.net.URI;
import java.nio.charset.Charset;
import java.util.HashMap;
+import java.util.List;
import java.util.Map;
-import static org.alfresco.transform.common.RequestParamMap.PAGE_LIMIT;
-import static org.alfresco.transform.common.RequestParamMap.SOURCE_ENCODING;
+import org.alfresco.transform.base.TransformManager;
+import org.alfresco.transform.base.util.CustomTransformerFileAdaptor;
+import org.apache.fontbox.ttf.TrueTypeFont;
+import org.apache.fontbox.util.autodetect.FontFileFinder;
+import org.apache.pdfbox.pdmodel.PDDocument;
+import org.apache.pdfbox.pdmodel.PDPage;
+import org.apache.pdfbox.pdmodel.PDPageContentStream;
+import org.apache.pdfbox.pdmodel.font.FontMappers;
+import org.apache.pdfbox.pdmodel.font.FontMapping;
+import org.apache.pdfbox.pdmodel.font.PDFont;
+import org.apache.pdfbox.pdmodel.font.PDType0Font;
+import org.apache.pdfbox.pdmodel.font.PDType1Font;
+import org.apache.pdfbox.tools.TextToPDF;
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
+import org.springframework.beans.factory.annotation.Value;
+import org.springframework.stereotype.Component;
+
+import jakarta.annotation.PostConstruct;
/**
*
@@ -77,20 +90,30 @@ public class TextToPdfContentTransformer implements CustomTransformerFileAdaptor
private static final byte EF = (byte) 0xEF;
private static final byte BB = (byte) 0xBB;
private static final byte BF = (byte) 0xBF;
-
+ private static final String DEFAULT_FONT = "NotoSans-Regular";
+ private static final int DEFAULT_FONT_SIZE = 10;
private final PagedTextToPDF transformer;
+ @Value("${transform.core.misc.pdfBox.defaultFont:NotoSans-Regular}")
+ private String pdfBoxDefaultFont;
+
public TextToPdfContentTransformer()
{
transformer = new PagedTextToPDF();
}
+ @PostConstruct
+ public void init()
+ {
+ transformer.setDefaultFont(pdfBoxDefaultFont);
+ }
+
public void setStandardFont(String fontName)
{
try
{
- transformer.setFont(PagedTextToPDF.getStandardFont(fontName));
+ transformer.setFont(fontName);
}
catch (Throwable e)
{
@@ -112,6 +135,11 @@ public class TextToPdfContentTransformer implements CustomTransformerFileAdaptor
}
}
+ public String getUsedFont()
+ {
+ return transformer.getFontName();
+ }
+
@Override
public String getTransformerName()
{
@@ -130,6 +158,25 @@ public class TextToPdfContentTransformer implements CustomTransformerFileAdaptor
{
pageLimit = parseInt(stringPageLimit, PAGE_LIMIT);
}
+ String pdfFont = transformOptions.get(PDF_FONT);
+ if (pdfFont == null || pdfFont.isBlank())
+ {
+ pdfFont = pdfBoxDefaultFont;
+ }
+ String pdfFontSize = transformOptions.get(PDF_FONT_SIZE);
+ Integer fontSize = null;
+ if (pdfFontSize != null && !pdfFontSize.isBlank())
+ {
+ try
+ {
+ fontSize = parseInt(pdfFontSize, PDF_FONT_SIZE);
+ }
+ catch (Exception e)
+ {
+ fontSize = DEFAULT_FONT_SIZE;
+ logger.error("Error parsing font size {}, going to set it as {}", pdfFontSize, fontSize, e);
+ }
+ }
PDDocument pdf = null;
try (InputStream is = new FileInputStream(sourceFile);
@@ -138,7 +185,7 @@ public class TextToPdfContentTransformer implements CustomTransformerFileAdaptor
{
//TransformationOptionLimits limits = getLimits(reader, writer, options);
//TransformationOptionPair pageLimits = limits.getPagesPair();
- pdf = transformer.createPDFFromText(ir, pageLimit);
+ pdf = transformer.createPDFFromText(ir, pageLimit, pdfFont, fontSize);
pdf.save(os);
}
finally
@@ -231,22 +278,34 @@ public class TextToPdfContentTransformer implements CustomTransformerFileAdaptor
}
//duplicating until here
+ private String fontName = null;
+ private String defaultFont = null;
+
// The following code is based on the code in TextToPDF with the addition of
// checks for page limits.
// The calling code must close the PDDocument once finished with it.
- public PDDocument createPDFFromText(Reader text, int pageLimit)
+ public PDDocument createPDFFromText(Reader text, int pageLimit, String pdfFontName, Integer pdfFontSize)
throws IOException
{
PDDocument doc = null;
int pageCount = 0;
try
{
+ doc = new PDDocument();
+
+ final PDFont font = getFont(doc, pdfFontName);
+ final int fontSize = pdfFontSize != null ? pdfFontSize : getFontSize();
+
+ fontName = font.getName();
+
+ logger.debug("Going to use font {} with size {}", fontName, fontSize);
+
final int margin = 40;
- float height = getFont().getFontDescriptor().getFontBoundingBox().getHeight() / 1000;
+ float height = font.getFontDescriptor().getFontBoundingBox().getHeight() / 1000;
//calculate font height and increase by 5 percent.
- height = height * getFontSize() * 1.05f;
- doc = new PDDocument();
+ height = height * fontSize * 1.05f;
+
BufferedReader data = (text instanceof BufferedReader) ? (BufferedReader) text : new BufferedReader(text);
String nextLine;
PDPage page = new PDPage();
@@ -280,8 +339,8 @@ public class TextToPdfContentTransformer implements CustomTransformerFileAdaptor
{
String lineWithNextWord = nextLineToDraw.toString() + lineWords[lineIndex];
lengthIfUsingNextWord =
- (getFont().getStringWidth(
- lineWithNextWord) / 1000) * getFontSize();
+ (font.getStringWidth(
+ lineWithNextWord) / 1000) * fontSize;
}
}
while (lineIndex < lineWords.length &&
@@ -304,7 +363,7 @@ public class TextToPdfContentTransformer implements CustomTransformerFileAdaptor
contentStream.close();
}
contentStream = new PDPageContentStream(doc, page);
- contentStream.setFont(getFont(), getFontSize());
+ contentStream.setFont(font, fontSize);
contentStream.beginText();
y = page.getMediaBox().getHeight() - margin + height;
contentStream.moveTextPositionByAmount(margin, y);
@@ -344,6 +403,199 @@ public class TextToPdfContentTransformer implements CustomTransformerFileAdaptor
}
return doc;
}
+
+ public void setFont(String aFontName)
+ {
+ PDType1Font font = PagedTextToPDF.getStandardFont(aFontName);
+
+ if (font != null)
+ {
+ super.setFont(font);
+ this.fontName = aFontName;
+ }
+ }
+
+ /**
+ * Gets the font that will be used in document transformation using the following approaches:
+ *
+ * - Standard font map
+ *
- Font Mappers
+ *
- File system fonts
+ *
- Transformer default font
+ *
- PdfBox default font
+ *
+ *
+ * @param doc
+ * the document that will be transformed
+ * @param fontName
+ * the font name that will be used in transformation
+ *
+ * @return the font that was found
+ */
+ private PDFont getFont(PDDocument doc, String fontName)
+ {
+ if (fontName == null)
+ {
+ fontName = fontName != null ? fontName : getDefaultFont();
+ }
+
+ // First, it tries to get the font from PdfBox STANDARD_14 map
+ PDFont font = getFromStandardFonts(fontName);
+
+ // If not found, tries to get the font from FontMappers
+ if (font == null)
+ {
+ font = getFromFontMapper(fontName, doc);
+
+ // If still not found, tries to get the font from file system
+ if (font == null)
+ {
+ font = getFromFileSystem(fontName);
+
+ // If font is still null:
+ // - it will recursively get the transformer default font
+ // - Otherwise, it will use the PdfBox default font (Helvetica)
+ if (font == null)
+ {
+ if (defaultFont != null && !fontName.equals(defaultFont))
+ {
+ font = getFont(doc, defaultFont);
+ }
+ else
+ {
+ font = getFont();
+ }
+ }
+ }
+
+ }
+
+ return font;
+ }
+
+ /**
+ * Gets the font from PdfBox standard fonts map
+ *
+ * @param fontName
+ * the font name to obtain
+ *
+ * @return the font object that has been found, otherwise null
+ */
+ private PDFont getFromStandardFonts(String fontName)
+ {
+ return PagedTextToPDF.getStandardFont(fontName);
+ }
+
+ /**
+ * Gets the font from {@link FontMappers} instance
+ *
+ * @param fontName
+ * the font name to obtain
+ * @param doc
+ * the PDF document
+ *
+ * @return the font object that has been found, otherwise null
+ */
+ private PDFont getFromFontMapper(String fontName, PDDocument doc)
+ {
+ PDFont font = null;
+ FontMapping mapping = FontMappers.instance().getTrueTypeFont(fontName, null);
+
+ if (mapping != null && mapping.getFont() != null && !mapping.isFallback())
+ {
+ try
+ {
+ font = PDType0Font.load(doc, mapping.getFont().getOriginalData());
+ }
+ catch (Exception e)
+ {
+ logger.error("Error loading font mapping {}", fontName, e);
+ }
+ }
+
+ return font;
+ }
+
+ /**
+ * Gets the font from existing file system fonts
+ *
+ * @param fontName
+ * the font name to obtain
+ * @return the font object that has been found, otherwise null
+ */
+ private PDFont getFromFileSystem(String fontName)
+ {
+ PDFont font = null;
+ String nameWithExtension = fontName + ".ttf";
+
+ FontFileFinder fontFileFinder = new FontFileFinder();
+ List uris = fontFileFinder.find();
+
+ for (URI uri : uris)
+ {
+ if (uri.getPath().contains(nameWithExtension))
+ {
+ InputStream fontIS = null;
+ try
+ {
+ fontIS = new FileInputStream(new File(uri));
+ if (null != fontIS)
+ {
+ PDDocument documentMock = new PDDocument();
+ font = PDType0Font.load(documentMock, fontIS);
+ break;
+ }
+ }
+ catch (IOException ioe)
+ {
+ logger.error("Error loading font {} from filesystem", fontName, ioe);
+ }
+ finally
+ {
+ if (fontIS != null)
+ {
+ try
+ {
+ fontIS.close();
+ }
+ catch (Exception e)
+ {
+ logger.error("Error closing font inputstream", e);
+ }
+ }
+ }
+ }
+ }
+
+ return font;
+ }
+
+ public String getFontName()
+ {
+ return this.fontName;
+ }
+
+ public String getDefaultFont()
+ {
+ if (defaultFont == null || defaultFont.isBlank())
+ {
+ return TextToPdfContentTransformer.DEFAULT_FONT;
+ }
+
+ return defaultFont;
+ }
+
+ public void setDefaultFont(String name)
+ {
+ if (name == null || name.isBlank())
+ {
+ defaultFont = TextToPdfContentTransformer.DEFAULT_FONT;
+ }
+ else
+ {
+ this.defaultFont = name;
+ }
+ }
}
private int parseInt(String s, String paramName)
diff --git a/engines/misc/src/main/resources/application-default.yaml b/engines/misc/src/main/resources/application-default.yaml
index 62e91ec6..54cc2404 100644
--- a/engines/misc/src/main/resources/application-default.yaml
+++ b/engines/misc/src/main/resources/application-default.yaml
@@ -1,2 +1,7 @@
queue:
engineRequestQueue: ${TRANSFORM_ENGINE_REQUEST_QUEUE:org.alfresco.transform.engine.misc.acs}
+transform:
+ core:
+ misc:
+ pdfBox:
+ defaultFont: ${MISC_PDFBOX_DEFAULT_FONT:NotoSans-Regular}
\ No newline at end of file
diff --git a/engines/misc/src/main/resources/fonts/NotoSans/NotoSans-Bold.ttf b/engines/misc/src/main/resources/fonts/NotoSans/NotoSans-Bold.ttf
new file mode 100644
index 0000000000000000000000000000000000000000..d84248ed106af3688ac9eae31578e0493c73b069
GIT binary patch
literal 582604
zcmd?ScbpW(8oyiJJ=Z-Tis;;W;UX`Jg%H=1bRG*%`
zde<3M98=2sMJYGcXXua-rw;${SY=Mzpo~_x_8Bp%$MRcu?pEsE2bC&)ddP^TEza+A
zdcIP|K2n)HVr2J`6MyJ_J=>eu9ye{ll*R9!HsS)MDmPH7?R&GP9Jg4m#_=ksJ8S;(
znbQV-SzlS3x~ZH2XU(25WqNVbyWi&cWRAC)&5qdmY9(xUV!Ph#1xuIhdw5E*QvJzo
z-+#_uG;K<1?qy#nb-`O~f3{%Cvc;7r7+Z;7oA}9vQx?qF{b=1+l`=;vZ9o5B{LS!w$E8de9Ekx`;7Fu9g%a{R7N_j0#sFQXXL5s>U`zOR)v2N
ziG|rp%HLJWuUaMbgQYHLtqRbO#&0cCy@)M^ooo(bOW6shk^Nk}oqmHV|nHC{4
zw5*gMECt(@)$}kdKQWVf<6p#_ODG4soMnz-dw^DBqH1CEWv`!OMsgyi8Tm+=>24~S
zaFuE(_10&|kUnaQQt7lVcVxP8HtBAbM9n(pb4XIsRYk_*##ZYFH0W?V|gkEq&_Co|z3RWou^CTtVlkO@1gXJlX|?5akQI+?Ji8d$$&!cjHZ
zx;zv1RTt}+OgN@GS;68iQkm3(bWGQJJr#h&n{8zDb$Eg(Cb4V){rZ$V?LsV~UsqG~>
z@68b@y_9wl*IlYkBxSKdk~1ZS_KZWdpQKK-KP=&>*jnO_zy<@+A>>8kR!mvyNn2UU
z*@R<9qf5fP$<>ppIXM)P6>|3b>t=H^MV&zYq)bz=$o%lyC$cU1kUEg-c2~o~@KS7&
z{6Dmic$(N%TlGY&aw7R#5L!!WV0l>16y=h3Bz9klU8a+hMF+3=`*UY;WD&J1c|LUB
zEVh<%{z8sPy*5=n*(0?!i+$QBr*gHV8pKf@OJ6(5)egm!nwUZP7liih7uKMhFSge0
zZ#L&2&z1j}PQ@!q4d`_K7_T3xPa$98mC_daq0>k)>ywA-NOB{+f#gumSrWD<@h@p%
zhwPBVX9m*B4yBRx>k^gi6At&47Q}9bx3sKq-RxP(gJ&Iz)sZU>;lDnr>uIx^oRN*{89dBf2=>w
zAMYRIPx2@GQ~YWEbbqEl%b)Gf@#p&U{RRF)f04h~KQ?{?dCE77%p$Hl-(0}`cSnT#
zr`^bIq$2iM`xuoIof%!Oyy!L2Z7M%{Q}kw4H@YKwhboTV8@*RGjNTu;Up0z87=1`J
zjy@87l)OG3eNr`zJ{^5lwTS*B`jToBeI@!&)iL@;^j+08`bqRt)hqf%^k>y4`fK!8
zH8y&{ucgNM_532W!msZ)S10?e{8s7=znwo=t*1oCs?G83@mtkn@g4CU>M3#@k8X-y
zsZ{jy=w9+y<}<3p61J)?)=)LDhp%e+xqhyyja`mZ`F?e-QRpA#_f$oGU%#)a?+@??
zss^M!K{dik$EtRuThA;u84pKKik_m3=&8|5N&Twm7F9c18of~^qqjtFrSx}3?@>k3
z`=WoN^bbTIpxh5fA68AGk3}D&^iM^fQmN?6(U-Bo>(SR$v*>%#k5%*NXVK48Tgtst
zwTpg5zB@#JiT;8mev9r`y~Eu14RhZw%>95c_XEj&RW&Hg{cu0uud9ysi~V9X!EfQW
zP!q%QObW|0B`nX>usqYl@+|SM^siFu;%DeZ?{&g@FAD3uL0In%!+LKN)_aq%-cw<{HxKK*by)8m
z!g}u#)_c#e-g}4jJ|?X9v0=S04{Q9Su*OfO471gR`026g=CI!HqTcUR_eoxZ#zA9B
z(j;K~9+U)(@q@NOTYlRI9r*1P^y0T)(4XI_!BpZ*52o`wKbX(&l3)q@PYq5bye3$~
z@A<*`?71Mgfbd1Z#e^>pt|WYQa5cZz2iw?F8r)0xk>GJ<=6;>~jWTk7%>7jvd6B$o
z{Ep9?qs+X8c}w|Sk++K9y?H;9Q&Zih>Z#6Hyr-JLuk;m$I+_0rb(-45@8y)pQ1=`C
z=mSO>qxc57Dw_L}&0jlU8O$SL4YR_0I^~AL0*DM%dyle~G`G@X7ua
z{E8=A{xv@J;osnszP~-j>@c<`K1Uhx&G9Y#-aubw;V<-F@!R8fvFFkFWBfiBe}UhZ
z1IFfo9WVKiJwBg|FfZ2BFwN|hpU=<NoeE+;-0d%2(R
z`&I5&{7UP!a(CzAIk|gt$$!|AEn0GAW#v_&JzIIb^Js~Aqx10pux(p;bMxjAmKJX1
z9iMk1VQJ@9-e-AV5dJQ255Lmpt-J$y2MCwvVTZ~_Ws_gKGIpq3rSg&dHmTf<-{zH@
zGc%NbtUO4l5%>BqTu)|<;kFgd8S62N?N{=0;
zqRln-muL%^!tuSR9Ggb;A*hTuRskabV>N7K|1gwwrjYLFg}|zW#W{wge+{Dr*}oNT
zW&dLIHrT=bqtM&oJ@&6e-`CizD;Xca_w2tB-L0W-Q^pVQEBhZne}gpiAT6?MR%8E@
zXmzN;{=R5Us71IgS{vFBhwGVbHTG9%I~dFUpV4s|n>8YHye2|g<}olqDf=^YB5?hP
zr2Sxqj_5=16#JK3j;#U^F5M6>6Yh+Ah)d%W4dN$evda+K|3hfP}*}n}Pqlsbz
zOKd-t{r92MH2x@by2i)$)(nk51)Ztk-mfev1Nf3p*`7m~I-y7U0Wyl5g>rO_3y%?&JU_09{S$oxUSz+-
zeM#fCMqh?kxGp|#y$ZyQH9=p8Hwb@&;*Ub?OBA0JVp5-PYhs_G?`UET(04U4+J&?$
zA=VJZmxb8pD84Mj8lm{J5c>j^@IkqH{JFFFw>v7fw0Cc|m8)qdz2I0GMRhpvb7*^kdi+m37`K4pqrpj6Hg
z>|csjfg1EV)6trc&+*&Q0;tb^d^m?X5FE;vgWUyJ_F-$mq0BkhS8(Mx^({EqAg4s*
zO5BvjDMzuj;Bt%EO>SKzd$|Cg8fBtqF=y2VCNe
zL`hs=gu=v8!`MW5zJ}3_@~9Jm@saYV7a{10QZGW#7Y#H4_2uPi7_TWWPZKOeD{F!i
zQEV&(i&5+>1eDo35~>oWeRs7fm4L?y3n!qhc=zjz+s{7`-Y_YzM&=
zsMrM<3oB3j0~jMKua|~Vx$?w6`mnzr+E>FoQF*cr!6LLj3?RG=9jFP!PJ=Ye_>?zT
z6I_Uje?ZU@9jXbALx*XYIVw+V0nA2~Hv;he;39OChB>M7q-?+(Q+ZNm2rfs*Xo8bb
z@hu1@pyM=wTxYx{*oq#b3B*nk4}w!rsY?hbn>R@lT!T*51gp_08s;U+o2p?(qP%Gu
zW-7{)ZTu*ZdYh?X_MklRMPQDiyxAINA36YM2ixZ=NO)8;c(Ra~I_;&@h`(
z-a-v?DdkDs0J9?HNxOxhK6qAk!AA5%O>h}1
zbq~zLl($?HT!*gE1X715X#(*DsT&BSu2yP-OHr{q1mermt{`ZoRPKIF9J|%r0S`0&
zc@upE9_1c!CHj;mz8!rAUSy1Mvr@IGr`ohRAKT_DDB`|wH%gny#~!i!QOYmG9zq*x
zVx*nlNE73F`Hf)$=e~Z`
z<+z*!an8x7-i0`Rluy0qlNY(a7
zzJ@-diE>W<-!)O}mH(_JD(O9^@g-k!4Twq_a&3sdioT$Uipu%GiloYy>j5ijD*t5-
z>vk$%^2B+5Jyh}mzSvUEp+0@ubN*WzUu^ZZhP6bM|Bl8NdrKXFKNNir-X|=!`T#y8
zJPiFv(SM)j&aK`=;?3;`?-DrzFTk={C$6Avo<&IUj8DSCG~??UhPU
zu7pEd=#IL8|N7g}TsV^b3*#}SseOM!kZMjK1erzK7#d@8yO$Zza?6gwtPB76l(eI!;A7CWqlGYAhu
z*8_3=`_K(=Df{J`n_x5hUqiP*Df@3nZ-CnfTj&m8Uu+u)}n7{Vr$ShH8HXMTktk%(vA}Ez`KM$Mc>!NPeeb^#7{y$)Wlbz9|3V=
zSEHW+X~Z_7w0R+R6}nRs+lqb(Uy;7pjdqpzhA{0fLAw?F@6m5Haq*?^G;ztZ9D_K1
zlMvs9*lp-uP3%@w(t_9yRIUNBThO01G3q$+3;fEpGbrxD#laoe|0NS`on#rmfTf)_#fc+Ml(AWl=ggWf!8p*mE
z8Am4TX=L1=EYf)0&|-}lN9${3ev)he4apC7OE!Y0^h;zS*-T@S?__h0cMaMCT5??}
zM=Oo(qOCPDCQ7!^$T%t4RwLt~WIK(E{gUmW1L=qjI%;Gtk?f=~tDv1VGEYi&(byi^
zRU>2Qq?8R@>Lb}*mn8ks93hikmc(GeP%!z4#)Wd4^N
zrI9&j@@S3BZIYukGTuy%(a4-LIaVX{)#Nyh%s-OjH8M|49-|>im7JiFc}{Yo#*U(s
zG~Q}-vc@|boucv9pi?#8>F6|#w+@}I@z$a4B#pNPJz3*jg|38CxUS@7m4>HJDk60}=yr`Iesr@&)`OF`z}>`8qW5S#$>Y6nA9<5}{Y_(wt?t*@V%G;W
z-UaA`@DTB(Ob^2&gfB!N)$n9VC3kChdZr2$7{no8g{HUE^V=Lh7uLdT^eNjml+^(pc
z5AINudKEnCsxYD9385;a{sfQuDa5#fN1YVb(U@{xT@B9?Rbf4iOP^6#r17Yu!eR~2
zQB@&rM&K!>Dr}%}yP^1jz|%-oD0K<$C{)S@Zhy3i#ytux(YT$^l*W|&Hr2Q@(Pq$`
zbB{(_Xxx5iON~1QZKZK%p{+IErDz+CcNyAN<6Vum(|A{)?KM18RfQciJZn{j9W~w#
zRPqPzG_qqzgV}ZgL8&BF?Ewm3#zgeD8qbH6)F!
z@uduntofx(jjUa!ERC%3r6L+x>rCZnWL+?2Yh>Lq`?f
zl%usq)>%_hwzi~Mj*2Zn)?!obHL`Y_${_1@sg4?1&r8WQx)Psup6aHN^}JMfjjW}n
zq?{n@bg83Y2;u(dP#BJ%UyY7{3CttzR%#pR2+kWQ=?E@GrW
zg^~}!%|Ux>oVQW>EWx!={6lcwLCK%sV&`q-NpRjp2WVUu9jI~MLkDSG4;`#=-bX2u
z;6_o(B{(0T!!)jsQdYtF5T(3=8$(BGoR82^8n+U9w8r@u9j$R`Pus?5oKH~dTW|w(
zoW}VS9j|e7QG8KwK0~pw;O3zdHO}YgB#m1covd-bK&NQjBhaZDXD2#McOXF5WXKS3V(K#BIcDrq^#`y-thXl7eI$z`LLKkS<8t6ieOWWAC
z2$tYWozdeovTnX@DXe6__|YjES$o}ZW29D4iSK`+oaKcN?D+`8yR8s}&9VvSo5y+q^uf?ld|i_lFP=U4PHja!Ufu5o@t
zuh6*l(JSF9>aH1jHEhQI1NdG^0rejph*ICBu(3%gc@k{wT}nO#
z8=I7JZNbL&rCd+2u}NtIjZHn2Hq_YIq_mO7J_Bv6v9U>M6OB#%l$L00Y*LCp2{v_A
zihqTWD9JH^-#&=4k{=l)({u&!UDwX;Mhm4j=eS?ipl@8K4E;?9a<6osi
zG>(T3)!6u2=`f8GMTcu_{H}C_#_`dS8XF%h9i?$%=+PP*e=HrXaVnu>G&Vk3I#%Pv
z(Qz6ZpDi7)aRT%hjg23dPS7~H=tPaZ1)ZdE^3cf|`xg=w@4sgvm%dn-Ca
z;~as`)Y#XevouZ>bhgI64xOWMjzs5b?Ca5a8mB5cUt@1W7igSn=t7NMiZ0SP)zQTo
zSJFQgmQi;#(B&HY26TnSDMU}w*f*jlYn(dhN;rkOz6o8Waq6P0HTKQusT!vqdYZ<*
z1zn?YiqN$h`&M+F#wkWm*VwnAXK0-I=z2JZ>xwU&tFd>W=V_b<==mDwMRbG4z8&4D
zaT=o1Ho(3EmG%HmBUIV|{_cwH#lOK7-w~e%S8OkS46gXmWg1uNLHre5@hS09aHUSf
zFToZ65?=&Y>PP$!T=6yWIdG+}#LvLK6TL>`G)A{-?7L9$8*rMSQkP)gjf#JOQ-X?5
zfPD`tegIAil{yCdUR3H8oTjMMC28CDp^_Fj%}_ZX>?cq;2b|`p#CwE3e+l|1JjS?A
z^l^Ba{o+T@z;lG9952Hw#F68#Y2r_!ufyBye+u0L`v`MR>5uRe=SrD=);KSrzi3?9
z|EtDbjQ*x^TA=$OO+LBi4XD8TmFh;yFUT|6?UZf%IBb3_N}UPOX(;uyeG>bz-S){a
zopf5FGc>UW(U~xdysbiK1AgISUoNZmN3hlLXpYAI2DLTz_ezx$NAPQ-NvKPFe5|}4
z6p@F&qs5vi_A9Rs)Tf`1lJ|1z${&PMCc$jWccKTNjBq<;IICeDHsrlshj)XW9fW!N
z)!|)h=YGOv%J`7SZy#3T*)(sVei#o?@y#f2<9*|MW4H0Ekv6NDwahkVTXU>A!F<4c(0s~#)_l|a
zz}#c*HPcqiDzb{L?p7~rv^B<>YMp4Uvd*&3v97TmvmUozv_7`>MtCPHQYkVdGBk2b
zWK!g`$QhCIBO7y$$jQ&CpVQP^mAk*@!!;kR`BcppYp>5Q%5RiEA%AZEBl%zC|5{)a
zbS~&xu&Q8P!4(CY3w|g_C!9o(I5Lr+sGn$>Xq)Jo=#?0h7@ZiK7@wGsn3R~6Sd>_q
zI3sa>;?l(CL}}u-#9fIe6E7uROT3%-KCv%Rp7fJdlLg7?$vMemldF`}I(eq6fG+9-WPW4C)Nexd;*mm5umD@I#RxK?oU0k}X^v2S=
zO7AUwr1a_1=Sp8GeXaEE(%(wcH>7V&Z6CLN*7kY(Bl{T?l-Dh9TAogq@inyktE7@@
z3$|`yOf{w(tFiTk#uj6%ahq{Fw*CNH|6u&arv%l_+St0CInJDjtsgR+`H@vGo(yOV(~{U&O%Hacn&-G9fZKvL>=VvLSLo
zPL-U3oCY3mE!5mm^AT+QOzqYAyl;@-IDcaPy!=P=cjoUeFbldAbSqe0aC*U&1zQUC
zBzV@E$W2sFBohr1%@XYr-4cBhLl4?|a$z3
zZQZsl-F8YToFTJVs?$Y~8A1!^R^kr=Qdg-3h{h_U!Z6CjV_I}zVwoaDU
z!`26|wUPcY{b~B~oO{!c8Q;Py>D!E#)iuV8>LTO$9MAZN>Tf)k?rYFX8IMNpFdji4
zOs_H?Ksy5ZX%yS9AWk8r&-*iwJGtyjONL+x5||
zj^F0(qF0lDyXe{VzfZWAe7sAkuL@=RORoR<+Ake`kAn_eNM^lxW{(@4|22P@Popb}l*`ha@_Rh>bGk=)5n?0}3X)$@|gzidB?&{P3RjTc_
z=gEFM-XowB`A`2D-E_=~YV^$P>;L;yjFHC4755k`u;-PB_82!+2w%ssyZBoEcmK>g
z=rgHF^F?x6{m>z+CfoFb|L&hvwPFmbp4CL&WC;7V)8&0$YZH)*NQ+1}e(6#99Rmwt
zH5-|KIjwlE86HJn<$lmc4#*P-8L>L^fiv_!XUV}3<>knE;qN(muhG}&XVf+7**haO
z?9c4ajsC`f$f?FaV~{b}7-9@Hh8e@XN20T%bNJdzzVtelFTQ3)XGV5J7e?ns=ktx=
zF?<&|o9_VSJHg3(9XOY-0{JG8?|Rz1E!__B`SAsAE4O2OcI>0r$FWc1^J2wr>)2PZ
zuVYPOC9zcOo7k?{m$CY>Ph$;YpT!!+K94nueGzLM+Zk&b`yswC)-1Ls);!iCwl}sf
z)-u*A*4pf4_BHkyKk_Zn411s1}6rKgQk3Qb4)NK7|M4w?f712Y%nfZ
z5S$a78*~eL1apHkgR_E8!BN4iU|z6-Z){ozZGsuWmSAPDDwxQZI+KH|g42Wb!CJoK
zSrVMUcR9_2;$U=ebZ}*G1z+Ht%6C6}PsSHQi-Kjr@}L=C)?660436U~oF?+!P0)dF
za4ru{4kiS{f~`UK;1s?Kx+Yj1OyR4asX^zU3t!U4J=#$Z>%r0hEdzbyKeX{+D
zQEsHIzE(f0zcs)bXbrMg*k9YHIPL6JPWxEDSpV4M*p%4Z*u2=OvD0Gb$2P>Sh+P@m
z9=ka;n=l&P|r~YU06XPevSH-T5ZH{e;T@%|FyC8N|Y^(p1|Fgf(
z|IzdKX3VVQ_4I0b-ORXG$vf3M%{Fbzj@UW2Z98V*U1R2&dA92<@aB7q+~3T~<`G_z
zS;fn>J?|*@fVv%U6SefKB#XRn6W&@J=2dY5~xyvm;Ewe}Wz
zG0*k7d%nk;vUb#4?Vatd@lN;Fd29J-HD*_`<95I&Q+dt{W_`1PUD<4CHnNZKuJyKf
zS9#OD8D>>)tGC&^(i`WEw`2`Jpy3^emZZEfs+uN+|-RTZ8
z^XJIhp;j6v-y$8(#?;&@XcbA#)E^)g>XSk!>{_at3Co}2JbdPpN
zyZziT?kw+8?=tUd?+Wh@zW&?cPIITaBiugT^?VUn%C~_xxWnCv?j(1zJH@-#+vMGC
zH?d2+2i!gGUU#3JvYWcQ+;83Q-0$7p?hj@mfB&SeSfm?GLd}wNLXJdyTxRUQ_P~uZdUJtK(T-HLsah&pXmfc{yIb7xjw0
zz%#svH^wvVzFwYJ+nedN^Qw3yUK_8iSKVvwP4p&t$9NOGsopeivNy%+!MBYqJ;!U{
z-sH9L#(JH+LNDocam(Gb*V*gf&GqJZy}aIDAFr=B&+F$ccHVF;=S?@_yyfONZ@aeh
zj_Ww@x~}t{>pAbcQRf5KcRqAu&PQ$~=VLeSeBuVqr*5wEnVaW)?pAibaF1|yx>cMn
z-6Nf^+^WvkZZ+o{x4N^-t>LEp&VCoatKZEV?X7Z~I^ViAo$uUQ&i8I@XSbX0{NNTi
zd)$Px*G)S6+(PF^w~q6ZTi5y7t>^sW7CFDV#m;YTeYct0T)q^x*VudPwf0_noxRUK
z-Tu)&!~V%$Z~ttcY5!vXYX4@RW$(Aowh!3n*k$&)cDa3?owm<+l)b?*?2V3TU*K5w
zg-*o2$jPxUc5M3+$FVPUTziw_*_Sy{`*O#(uW(}al};u5DkpAV?F9B_C)eKMP{cX-m?)C0s
zr$uy{yUi_iZ*XsPS~{(q)=nFzZR|mRmA~5l#{NF~_vo|HXZR|+z)$!|ztFGa*YyYa
zgUvB&qTHp8NQMH{-grxOH&0hp86`Eg)~ST~ooZl2Rd-_qI)WE73)#mpBVQ$q9=x!b
z&pB5qhkf;+BNS)ILz_cgsFl%V7@u?5Zk&ZL?=0(7)gm1IY*FLPm8ygJ8QKhr;Gb-l
zsd2_Sl{5yV?=d&AueBOy-3BF4o8wC}dJ)I!^FZ<_RmI$=Mwv3|Vb*G10gK@%Roxh%
zdXr}xtwA2D8CRssjk&6Ud5mggE?0w1Q4
z-s*+)ckC}Q*76NK=UZJ=RckH`QcbXZt{Tf^{+br7oz4ickliiT%;1;D^xu*?N$=
zsEGKPY)f5Kgu0-<21}iU<(BJ9`75fFU9SIEDn2T{LHW%yQL&Na^{;hocwGEh&igCH
z*UgRTXYhGNo=sz2`d7;N61L7q_o5d1c320^saM*C`7%t!KWQHvdo*k#_^J4+v=y;e
zMtl8kdv3Vj;GBI@hg@&)ACv*f!F^Jf*fXrtiuwZe{wign{Ye|hXy1%Bk~V43E;3s5
zhi%$x*k%q_@fWGL|4^l^hwV-LOX@b;=4p3f+pnOsr@>|pFGgnSUHn~qE?c&29*tk<
z`-CgtWz|6KL3=?}_?-3_L5pcuRcWV56_qw;<*KOlKJ9)v`W&1FJ2>F4rb
zGjYUU=$E9AlWT|dDSh14@s9t$yL}lS!MD
za&N>pexd(8gSH~=V`bO|q;DH+vVv$%QFY}wWhjw2Y?p-b#Amv2yfhQ9633+teS@FR
zRbA;P&bV{msVop71&nUyidcEMFOUZAre*!GG$iM)bYoptAUD
zB&u>E^(lLlICm3gopQ}`RO;nS^a|iyz7`H`Wqr=^Vc5GG`yf2$Bk~}&GQm;p%-`65
zq8e+i=Xzo%(zH%zzu3v;*h{K+q=_0Akv#2DRhSveb;p?-NcUItM$Q>Y-7e-{GFA;W
z-c>^>PmbA7HL<3mKKHw=>=S0gQm)?%-2e;dbIw9ff=cwuzmo3`+~XRtzYBkbZzKCx
z^7rWeriNPg6UGOuqtPLdtBR}<=w!~}TIRXjGd>FUHTO@%8Tn;7kSG5!yfvAsGi-ObppTAH1d-2WR`CzF>>Drwas4Odl(L{twehhz9D
zKGninrfNYxG!@mW2I-r*U)j(wyq}$P18-p0*w8uY6>CcW2+s**-)zGKJ_SCKQH+3Y(jxev`I+u`#dpOSD
zbu!;!do|nNvVA(Xu7|%YQqf3rwik1J8QYCjV9i&f@QVRfrr$JKwK69_Msw<`4v`I9
zzo*Uz>oOgzhar32>)9WpElp9h*fMIg>>Z0f)~drbPN5CXRA$&8NSkiT{r?-bKfvbW
z)Zhp!{?@Hri?$N_>pu2hMm*_z=An0U&*SgSnC}zkUgGv+|4z!%1O18fXK)?TwLJ1b
z9`RXyKa}=V%(bPDk$xhpI|;AGC%4j`sxc<0r&^nD;5Tof8$#9hm%E6^I;53R>F=aX
zhwbVYu6-`o>`fbglX!A3yoBv>=$GUP+9je@O=v$R_I{FY9lgha86l}|Qfbx`BSHMPmbtZX|ws)~Aj(FGxKaU(iI`@%Yl6tt5
zbAF;8KA;}f)2}pE#a0XQ@lVn`%pSkrPJjLT?LQg!{LAx+|JUQ2%=jn0(;SlC{a5j%
z&gjG1XSDBM*;(&T@BYi<*|z&{^zgAmwypm=&GwUjP#NoG$0_`sAy#K?>QKglgQ>4k
z<_hk!E4lAx+l!2kCmyP2+Me7KJBI!!byu4HJ{$|mT;*MS`a(4d+tf1Uo+NXP{@e>@
zsYt}9FDXfX$Ngil*d#KKe&QPP@*Qc*wdofavozv9QB3}-8(Y)Agk!3?DknR(vMQ7A
zJ~f0qD$+z+EzB>U^+l$79RiXtUYzJ>v{(8ueFB|9E`pQ`KdDSmF9%d&-vOuQcnQ#+~#5
zCiV0L{`MGk0%2NNKWt53A$}|42(H6pSIhW{erpSU!2MOmo7py-okuX1(sPxI7`r~r
zap~)&k2?k*mpROG`W*2+llyydxSgFlH^z2hza(XodvGRx3HPk_VH%Q-o|A?1X!->C
zt3HE`@%$a(I|*N${)v5q87s(Kdq4)_ra$4l!RB3RjEqaI+0ca-j~R=S$0I8+nDAiZ
zJT(B0G+U@)+>hqh5}u&Njj0
z_{Ynnu??zo-HGVN^e#chRf2jt{f1GWaDC?C!kPF_6Xh6782HHejr)eEdJFDT1%lC8
zxsYq*GnUf$Xhhw`*p0OhAq>kLC$nwTqmKslJjcL@lTMZx;o9tzYd%e0j$&@Q412WY
z8e6gXUm^3T??J|vSEIs!3|yDKMbD?0SCPN=^fL`AV#YZxF!$npgA+oV%f0iNOkEAf
zeh0W;UX1S@&kNf5swqA)l<`v?<26+Jv*xOgQILMsY)gB6jqzPwHJ*F%(fEIN#;A3<
zzgG^&I~&vy%xN2&eehSA&j^*dw>MI8fw5N7JXsAlkE7jnWXMXaaI
zfZUJ{%vFnxJ(Ob;$8LdTsuFo^&{f%^*hJGmVIBq>F
zeM0()(9hST-?iRIe`sC>?4w_N!Z6w6aY(D$yrXcz3(
zBD+7cM)isw)1`mTj$QtsdM&Dt*_t(1*0S_kRC-@VpUTeB4(ea6NoDu{#TY$%uRJ(6
zTAHz=zBgyrr}}5^)fpwkiGxP
z_)hLehpXH_S$jTs-&)Fekae!ilo(0x0$F=+AY-}kUZM9jVgES?*+#y;qMwlUWm!W$
zbnI-xSbsi1J!nFU;7Ba8B3g2b!&N|xQtj)r)4RdkUdz7`BbJ{~6{Qqsn8`bGghSNUf
zxd-z-+J6K3&j!X9+%tr@>UxlS*e}SvEnhWbtw_el9pyOps1wQmew1FC{K=S4d>8*<
zvmiqwv=RAmE#CgKrV(cXd03v_Z=K0GvL?nFQ)E2H8B0V?<@g00r!ASUqEfzhC|4)u
z-Zr+pOA~3!dJ9;`5TCU%b3b#FJ4kO=IDd>%{_L}o>c(j@cI9~u?Hl{bGmrXaN5=nW
zsp^r(x#s0Cm%Pc`nr+e0{+qb($=F-;A82dtf3-Qz8b(eL*ICN`@56Pffc+h;2iZ3j
z-+P988a^+69@ZCsm)3lk^AoHooyi*6+2MFfnRU1~&kOIr?Mb_iRfjmT?|AxJ$?Gt-
zSEkDt(_7@h!nPK5FV9Xa>qO>7>q)PiYc5a!M7>wx9^aIBO2Wo*j7jfE{~~>Bgmo9`
zgTlHI8_{1%Uncd$_+*^L+*_1!@fYxFhRe}%O&D(^;U9=6>+r`KR2{);hYEH2{_>pVf&FaApNYs49CmO
z8UNgk4PK%SJ|kZ;$7PMyx+1+_?lD%tz65RiZ1PIa5cV~!b91b+Ie>f~AS`Wv4srVt
zm$k^qjpS`QK6)nFL=D5gt8q_EQI_zT8DjvRZE#%1>p;G0%J`r8nS^CbV39|QGFpr!
zel~sx>v^#FnKfP=Eo(v644AAE)~?LlWDM7Cmrj#zN^BE8+mU-5a}LI?y)}%rYNsE8
zFWByaK5X75$I@T3U5q}%SScaUu_uTmBqrSN|dScC&CCU5hc8oYR6dH9bY~*Wy2e_53c3cPk%`
zd9pg{KZaFQ#^?6o&}IzkC;W1}qB4%JS`o&1O^xGtzLR3?Qv^%#ar##2D|@rZU$Z_X-dVK&6#F{Rf3cP<>&IdE1?9_g4(p%rAkRhS)AvZf
z3DTd2&p;TXM9Niz$W+zZ+DW@CqFjxbPg#HFu}K%-K!5JV5-)
z+(&g^Rvz|85|;GrLiaGFN(lxWA%2HzD1U$RbtGdYk7Slli|7)TI44ge{zpQXlfXd@yr}
z!C{{x=bxE=KZkw?ABmf%q0(1KUp$uf++A(ry;xUsbjex
zEaO>)?2D=?=J{wP(t3{Y3G{*QFurL(Sl067UP#-s+NBRf){s^$@?C_T9FF};zwW4h
z)RBizdB$kg97d-X(U<0sc5})veNzeLs&0HlzIvv&Gan7#J>W0IHqE??P|Urrm^R!2
zpU;8=B2=iB}iD$9Dg!hNj;X2BFs>Z?j5;o>N;wA$244>KJYb7B(2eg2>
z*8t|7BMn)5VC|jf56WcCnzig|JS(YYOvAtQx{XD;vMw{2zeHTc97m;e3dBCvE7^+*9V7vUVWz&5h^}nRqGkUW@QEjPtsyf2ubbPc`QL
z(w%oux>Nq{tj%?&{M}V9w1mb`2jo}*V~nPZ!y;x!`t88FlKGd8iQ|+qOTf9s8Hy^6PksxE@
z|L@{`PrY15yS@m0jkdCq=VedQhn>v!dEDFOnZfC_FRsa7e$Bx@Tf=DDL2szR__Yf2
z%&M$GRADSpg)v7b*hpJ0V(qvWWov2d3&ZC}DzjFxpZ;x*hH+2<&(LHH8tyY>O-A1P
zX|1Nqdpl4)Omm+)ku*AHI4w-CzS<`53lY9v(&Jj&BrS`-^3F9Z(n^Hs?c*7=rW1Wk
zi|~5q^PH2kGsl;4T==tV+(G_lg!$!JCT&aJqdE9)kvWjL{uew`mwe~bW+TkE35V}7
zbqM!`?ZF%$#YRjQ=a$8xx?va
z>vB)}POXq_wTC&(9(=hU&yo949~s4N4M6Ps8vOHMydJEPh>gLot{U(KO#`C~KD>tO
zZBs3I7L=k7ZOL=l&PE+$ELm-GI}<;-K=BHV?zq=Ox+
z&_<@I52)8Me~vorUl{K`d~Yt-<$WgWQsxrxl8)SOn((|Tm+^Qf`o2zTGWVF~#Hma9
z<$jtp$hW9uqx$DtbdP*Y%k9kduk8)U-8?5|8%koclUh_b&bD(BYCsBG8Iq%U#h
z8ge{)jl=Wthct;R>B{x9d6E2tdC6R_;<`Pu_ThSXJ`%){{EF7j
zXre;82h-$O9rjD!Bp=y)hRS})LpCo5&tbo$*%d0Pgb&Y$oYUuUIKL(P4yKn4v%ePM
zKfwNqaV2lzHv3BmH#&^QZ2vwVGXMWq{MDNGzu!LyUtPj;?*#Y2B1&~Hh7qWwL%z$UEH}eHK+1egW?S}2eA&+%8)3dUChIRD
zJRvU^vfF19hw`R*b0kcUbIT}i`5LzOqxWMAIhKT0Y)?Ql@yj`$riUt%Izr1=pi(|r
z_aR>S(}Z(Du0c=B=ToXYiZZ)SAI*6u1EXuPW4Y`Toq?VMn?dSAco3xCh#&6151k5P
z$BW@Yka$v$Vp9SCDgPRnm6YGaw&eQ)kaQn|lb|N-WU4smxL*6dMIS#rXM2w3{d{`t#Aiq>qGK;18Y<*8ILzIr|}-aaK`pu@vN{R
z>u?^=4UbW6B3R3Mi+ic8r!sfso?Ts@Kg#_yyT*iu&uHa&Ww@>+?@Y;aJ=SDUp7Dk6
z+P=*80LD}$%yZ)0(@S`dpv1U8{fNxl%uCWQ%R5rsW99jZelD1q<4Bt1Rs6Ciylf%Cq|@G2_Q19^Y*E_j%Cy6()tdwLP!HsD=OOU{*dJY^m7-^68Z6lER}wRnaW
z(h(H~z(9_j3#_3r&a@z(b-bvxo$K&yKI9w}tPeomCv6SW*vD8b(i29peF^ZMY50tO
zF?D_h+Z#D{dWI#aK%B@Ljy(yK!{lAOe;1eMb1HHk=WSBa9P%1MeshE~;Vh1w$9eyE?mXgXj>|J0;#jh_oqgX1l{F3445Q3jwa?%;=C>Kj&~oSsjUhAV{$Hvg@7VqeD9_*w
zJy0RLJ*Yxh_8q>RjrUjQ4GQ0<*hrh&n0_+DC#dieybRy#IN|m?Z0~~!@B+LPuH(pB
z%wHkz0}JwQ@qbPFx9mCia@+qE#v44_r#-ViQ-gP&j%IGq8sF&s@9LcLf0aROvd_3Q
z{Q$fRFJ<&^=%?@ke9L@H*18Va;WWbk3VC)V-xr9AeI;BEU#?G|`b&B%?-A=~-0v~R
z;@uYON7fQAVtz07CT{p_K;8}I`LHGLovc`1oz2A7hx_RNUH>e^SB0(_{xAAx
z`Yr4s{FLES^fPQ_X?xMHjZg0;97T_XkKxm>UH>Z|{eR`3ypxsnfGM-l})}r~|$naP%
z_&uH3?#w%938M@ZBwTS@-m9ws&zsj*6u29hdx!G}nd2rj<=fHKAalF(
zOun_@c}#oWk!#Nw@~3d^JFA)RSHt%?MoZQ&~4$jlEaEPpoa;jgBIp
zJdbCtS8Pn@eFd8}z|Fi5_AqO!V2)tDbun|K8<>Ax&a;U7;Zyh2Ma>S3Z}hg!`Td!1$-W-Y9$!%*)K91#(360ef>B()U&>(Bhi1?a+QMp$
z`3YL2F@FrNnR8H2Ck@GucPAz@2`NNq^~-+ddC(-%dY=7FjJ|3r{@TjwbntjN$7Ee6pXY7-ODBwk8W`FPyNQiR
zv$ZI3zL8&vn>pueiO*Wi&migKXv$`@4drz-Wz>Agb0}*!xQ_7V|Gc2R*
z7oVhDQYNXVY`e+&X;^f+s#D^;Khw_VGcjlaoeM3LZ`b)OVlvUd0!E)mJ
z;sc?NiGS?^+D|qQlE;d5Vb!3Y{X20s!cEwSy8!bW{&o`EQn!@bz$@sh756)3a4q9;
zo`+unYY7WuIL_*vA?2*f{!0myPvdH~lUzHh3HwKRk9Pyd_QGzCSGaE2E+ri)qg+?g
zsF0Vx%m>%6cx}1npI$3Y|BHRXzw7k~*VqD5=H*b~I=pwKct2g4=K*zYoC4W0Uqm=t
z-s?Etl=ALipXBvw-lyuFDXZ9`9q*t^I^BUZ!*W%)X1I^^LfdhEXr~_dQiiZC&>nJV
zfuRpjk6DczLl|F=Jf}7EQQ7_*+t@Bb8;a12pf71y?^8Sz*GL}U1w+LmXYkCEb}8YopFEa0Yq=J6B}AS8$`B%H&g8r{
zAZ_w(l(xe-LrLEextuhP#Qtpao{BObXMZ7JCyTPvPthlqzZ$j;o8yxYQL%kWn7)#d
zryCLfS-3|uyq^}6elcr3#k_+Us@$V~4{@hdXSSBQVI4UZ-XAl5#W-L7j)T;30_Y{nbN=+)b(u7?W0%9mE#bX;EO9E1S7xwH
zf0ey=TU;f)mmfYJnZWyVQI7pcTp2%|!9BYbd98TQlKaegK>z)_`xW;pc|Rn3pE7&1
zeF@tY?oD#P3EP19-!G8$S*}Oh`MJEb{4)NM<@05al|3(e_}Abt#6su5E>f3V;Q!`F
zaDW`sXYr%(}shQE8u
zT`L$0Pw@Y1tpV4=(@N#BKd&eJgTEt8u_`wPELnL4Y=XbR2Y|JXz!pbbt5g*tR-tFB
z!X50$Zh#%C76Lt2)mxORMw-o>RQ0{
z>mCm`0C}iKxZXDYKRMX5s5=m^h%}2{Q>qv{7f*!ul&Vj<4Vu6$@Dxy|4e*qPm7oYZ
z!y32(?gVVu@Ke~YRHGvRTQ(vejm875rO|Wn3H+v1V{F*C5%ho)lxh+{edr3K0sA&N
z177F)*b3OT1*3@;UjX)NSp~35OZ=wgF|ZVMtBVHoi^Vq)iww6
zp*0Lr{OJ{_2`zwg+EFjSaXU@!=*?lNd
zls;P29|D2?RJ0}FpQ4m6ifxLufr0QdVAEpQx7ZaxzT#0LC6KSgw@?kpTY|hLrT}?M
zVE+<-z$=lG24n&JRxy@{~ymIiWm60&!Oczm=g6mDvoZ;GRfX9Z~`IE!zR^ij*58Ql9PdLtzH2gQIW@
zK8RE(4TE4hTo9=k2dcsZAZ{uZfm(pxe3F!>jA>^z`Xhk4jXm=P5
z3t>B)0raoZMI_7%ssJ)pjfTe};l*JQ+yM4h>jzIos$-|>mw`T6qc9+MgfG;EWg;~*
z!xE8N-Y^x`0AoR|Yw%j6whu5C)Se8hMCzmk+Np!?b?HBK@pWCw*Ha-JTEhTX4%2BGL{UwnN@_-C(0g`?ydJ=81Ihfd;^_4o^io
z;;)X#*73GTCx4*+PCenRNK_Euy-qycO=(kU`3fyj^O|D!LE_ebnBntDe!gj?IiLO
zu`@28$av%(Pam8x5nhW-q|J$QM1D>vGMU(zjIE{+6H}T1dQ8Q>Q`f<5mVYIIp>SVh
zdI`V}Gx$5>j>t^nVrD~_4)}OhHfRIbW7b8H*_544EX?i&*ltcbz+Q7(i_FUl`}y*y
zx6KI>RpITzX%}zFG~TLexXk-8q04lq=hXaOR7Kv
z=mtNEEJd%S*kUQRUX}xT!(NuLVY}tjyPVIdJtfR(FR{fW1~P17djfMR+Q*CIO@e
z`p+8Tc1?5W1LJ`9*6f74BEKevZ=e)l=U?B6tflU?+eFrBPyzB1*ys>8
zIz;=2Rbby?WIVi5^u$D12efyxG)#gOfSxC>0&Sd{EOHv1
zPb1G6?0uH@&-nw#&ZFA}&opQf(>>|2d41khQ3p&COz;74V!V$R1_u|v{
zF5MHktV1fu55a)ES4IH(UqSCHC*Y3ARdl(47MDCmDeyb`V^X>G29dEDaJN><3n#dhwx-%9Ii`-2J
zEy3C*p6`v~Hv}Be4!#5GzMlz@_d#YjDDsfc4~e};*#S8oEfaa18X5rgJfWQ@0|4Eg
z7JveynRnf1(Yf&84U_Bgz+oHtb
zvNw(&k~|1VR|JgnlpyR=_^E3NJbAnhrH@Tv?z%vljw{n{LZ>!@Vg8KdKu_t@LL$>
zSXcze=FAJHMe(UAN@9K=Ch=ZTd^5lVQIf=ge1M!u(?B1f&ScqPF}x7PFD}ro-zHI#
z#{=3SgsGCMC%h3Q^>?DA@d4yX%kR*nT_TEqVc>UZ(xFc}WKQn|
zl+A!{88X2LQ8H40#@(W1N(Mu?x#$Ox&>p6Xl0}E+FjJHO@&@zDd
z4Sp6SAF^`|sN~zn!<4KL4zollfISLe(*k=$DM-BqX|EtQFH{7!i4sWpK>T00I3Ryv
z+AoqBO2au(zAXj#t0?jny)R0!9ikLRmlD{w#6eL?b`hl%_AQkg(6toDOXIiFw8u4$
zQf44r5~XZLXam$)E9T`E(iGPbR}9?k=P
z3Q7goH>f6b1L7fQ3J`Nahv091Oog}!Mz&yV6Fe61Yw%jY_QBUh389^k6p$Yx0Qp0R
zk&v74T$Io_kQA_UXluZ}RcNcqV^P9F0QtkPSyke@>W{ErlyK}Fj$Gm74_^nbM5$IE
zXt#PwpnMJDt_He9;M)k=jNn+rJ5g#@gr8syJQJnXw}5|YldpDHQR*O19c);KIIo)y
zuwC8fqSPZM>h%L`SHC4Jhu=ksB-SF4BXS(<1p0M@f>0gsU4t8H
z(HT)1`@zqmG;spQo5qJzqBO&n&6bJMoc+zaz)MkD&~{7w)DoMt94$&K?AnTUTOAdp
zbylF>*4VxcK5Iivwpj`2*S0CppW6`|?N*D@zBV9t2kPp;b_ZnaaFGXNZAIx60M|r`
z>Mly>DsWbmE|iVV36$+hU0vUZ(yg8FA|Yghd7|{F3`60#C_QVzT2XrChZCao?f`d1
z`3`yd;Nw26MCpso`t}f|pFjL4N`HLNf3GM5XlK9=a6y!TeR!~$1F+v<>KKv?wu>?}
z9I)T8e6U=U;h6v#nA0oY_ZQ`d^sqye5rHrmj)^j|2_XN-7ov>9x1;L8Pon&2KqbJ}
zKQ0nwG;)kyCCV6VIA#d!5@jqpj-4gSPvwBW;}St5I3mh;w#O4|<0&&9n@-3A6XB^S
z6B_`>CZgZO1+Wdy!UItz(e9*NPyxs{iF}jDH;H_c$oF#@_*<084oD3>MVUfdQ;54M
zuSA(jTujC1Q%eCpoQf@{((csduotcXzMn>!X_=rH)PQz?O{Pr&{4s4m`~lQCojRw}
zFK75db|?$jX+{^oJ~QURW;g}tH6lYBGDHz9La1j24H=-;|
z35B655LXNP!_RXj4fpKF6F}b2O41mc%JghhX^raQA`OzvLpl_`#3G|PZ
z9f9~-iM?0SS5^{BD{sPkQC1}d`oXHQP!GDqViw!vU3E*8)e6w=>JEV2S1$#|l+_-YmEa^_#)c1m%>!Z33FZL(VlDPtJ42Lp_+TCSt;4448^B0-Aj*d7qHOerUqsoI
z3y9CnZQ&A&m*~4&+K951dbiTXwq|fqlS9ei%)1P+J
z&Tk2U_V*Isd$Gyh(ZK$F$hdE}DEs-le-UgHc?T&N=${)EQ%F(p&E!2S?up0h`5275yFUPRsv8J#LP5?3=M~CBu0KJam
z)8j`)IZ+CTi4(h6@ErknL^;(ME{Jj(Tb;(2XA%K%cLrU~Qts>{QO=ct=c1g)=NHiX
zLN7qJ3+F`n9ozr@9sCYYM7hZEiy4427n{H+K+a3p^U^+1E+fO`b)sC!3AAywJ{%C`
zkNCj$AH?P#=zOg_oCW;&=Wuu@%5`MDPTm_ep#vcAO#wdN><>#txs@6U0Cv4KOO)G5
zU@9*+3!;ZfF2K!Ja9o&zL`Q*GrelXK{ESs!tD56KfC%TSfIP2^&RCQVODk1x3&h
zXg`@h{3@znWuX1!X<;HP7d1snXbj{_nIDG3Ls3)x1UE%ZT?{6OnkFM~JWW~X1Up1c
zi@a&?i|Ri_)O7J-03c)fctD%!(IY*_GjxSfFdvXL1N$?uKcfz*fO<0q19D{S32Weh
zsF}Qhb~6-gd7IY8rgPedJ
z16o2K7zflBupN*s0NJu4Thr{!G*y0e~%X?1l?~PjX_{oE-ss=e!N?
zMa|_4*`OpuKzrbLZraaH`?*74zo>akr~~^%&Fh3LPz=y5?|C4mxCT@6rG|VE1X}?6
z<|luC^5-uBHDNp~24W!pS@>Jj0>okgVyQqL;26*0)B@C7(17n@Hf)4ra8uMm_^426
zs0GMe2s;*<4A`L1@9;>}KNK>g%N=5N;ZJwqLwNM)#hOvM&4uuS9KxEgG@i
zI0v)??lIQo5$pT0-VA1FHlJx7ceb>ufdzES1i
zf~Y_KAnNE4QO6{N9iomU4#wiopQ;1LetItIIO-Z-6r$mos1wLP0r@997Ih->Pf7*@
zV63P=XNP^FPA&oXbMie=r<4X{pF&+z(Pt`lo4QTZY3MtxJFtH`Hl2>Yreo_F_+@5F
z=mXep7B-z#1xCU&zz?&q$*jXbyv_O>-ibOp5u}D3Fc8*@IwuJr>zwPN&ZR%iy(sED
z+MUO-`N%bY9-I?(L0(uZ>Ozh!Yz=Qj{Ut4&5p_{Zpq)hzL|x4B#q_tu_zf1q-H;8i*@ofp3+xwlV|~CL
z8^-`;Hlh0#;&Dp|G=uMe`nGUv%b%idjRQI1fvDS(Kn=k5+tF=%Lm(EmZ-d_feRiaP
z<#2+9px9>T4pDcdf?@Dl)ZJ}hAfW4S#Q|IVMqKYfr#;nx<9j&1=ZL6#zXj~N7g_i2
z5_R7XqVBIH>Ve!)7v{iWQ4hw4F0ew>Lu?;P2h?+jV~0~iFf3(pSaM+h5&VDTJlutM
zq8>%&qr}Wn`qt4X_#S4%6H$+qf@r{g$I#{2ari^j;|fsU@jOrou-);IKs(1@iFzUz
zuRoKl^Az>&
z7E$kQ1@`})8A5))<`yb8+WOzuNKFSDT&7g=o0Q~XtHy}n|5#z7e|EfJq0_^pQHeM%&qR;>a1NMG>
zNz^w9fwte&f&MTT4goB?07xNEi-F;0(MKjc+K__!bI{6`h(o
z3--c&(X=EG45MK-tbu!?>A9f=@C}1JU()ouqB$}`J@^R@iWY~Tb&vBcM8QJX1Gh!v
z8Il$^8ht~}nh^@T(P`|5-{EgS
z2Qw|?fii%P%zdIctHEW_e00blTH;fp`Ql&S%z*8E(bX4!Btf?%b6_=4U(&8H8IA!u
zCZ+yl1~dWoC)*5visq*RHs#ru=7%1B4@FB(oFu2MUZ#wLej$`Sw0Q)k0
z1Jsq_yl5HGG2>sNWoistMaxW`nQ1diakwg4Ky&C0=*{(_mNhvP18kr5N71rTXSTVb
zeG?Cm`I}}yd}sHA(l8Ky18kO~Ds+N7qUEdrEnouBZqB!&<;nyRuvxU+@d2H3W5Ya!
z;E-r}(*W}3B`?=)T0Ugrdd&s)%RdOHFF&@)Pr3YWL@SU4hQI^S3Mvo`#74nYK%PPc
zfjSG(W})Yz1(pNq;8~l-`be#?1CjylutriVTnR?PNzsZBi$&0>2xCAI;_O>uuPCw>
zWxE(YD%Kjdi&h-Di#GydsW`fqXbMx|ifAQ~yCiW~lD0|_bEU{vY7bl!tu%fr-3*YW
z4DFY}{$+{ta>!5)*~^!NC8AXz?kX$;%2lid3xT>THGo;b_*ChsXqEACWqcKcuY#~c
z&=@!)T5xrk0k=d8Ne5xj750i2njX-vN<~--FGLF)C|cFTa9K3g_G#6M0=BD;Eo#Jt
zi*OI#iWY&5xL(sDHUT=;#GW-%Lqix0f50ozYB^z@Xth;n4%n?WHmHMcT+3;7)`(UY
z`_v7A7C`*g<#@eRz;=Cstbh#lqXF3?OTbyt8qih)WNv`&4GREq(-8kPd?H#S;;d0x
zAa5h&Y}6NKz&5x7=-W6EWCG&8aSiAU*sk#gK>jAw(IgMlhW_v~tc2t6NVKL-$OHJT
zX(Q+XV_+p5hex6{b3z`d3ax;8no&=)4RBtx<_cs5jyI=#^I5PT{(x7awMY(yp*Hk@
zpJ4+WhrdK?N%@w^fi_xJf>tmbeu4c!JuP2}*2)Q4p%S!$;XqrhsH+uqwfal6*3{LS
zx>^^8+Ry`jh7E8Y9*Nc_KBR+E&lzD~R)^QfR60K7Pm@itC
zFEoH|z<3sg@1vFj{_kvpKLi4OqH{y&4x?cO9D|3Vbul3~gh5N_2a{k090B@5bOHzf
z`cX7_qWb{jOf>yBdMBKNhoW`$hMW)z?O`0yf4g24ty>)6Shoo10wZ8HYzO*cH~L%m
z6o4$0d@7M1LWyLn|&6-RyYNBMC+@99~6X8U_9wN
z1n_s?J#bUBesLf(6bJ0tuRRQb`LG9Wiq=0453Drl8-H5kTEj{uXU2zMa|{2Eb$>2BvO@GjJ2I
z|Fk%O52j%&o*Qe^#=|^7w`sq@X}AH;M4Rq_B#;RTKsl%Z$TNK~OoLzHFx&vfiy7pf
zkpsv(1KDRp19@kRhj~E$8Nb14xB<^Zo9TcgkO>MvIj8~6AQ}e4c$f!U;54A`EC-~9
z0uTb^pYb`r=01)v<%fMyU4gJC>ScJ^;@320~bJJIGO
z0@|9B1ByWi)Q5KP9gKu&uoSkyVYmc;!#mODCW6$E1ByWiG=U!QBg}y1unmp^aWnS;
z;OBV;q=j5i0_Y#}IsoJUycw_#j>0V<|9s+bK6&R?fCkVFeuM?E4bH*?(H6vov``4D
zKnvJa^*g)8tvw1oy_ff7&?I>1nv0qfu>+=36H{gMoFK?P_4-QY)90Nda+V3$P>
zz$T0GK_%dPw+MSI8Uw$;4xq0rdL-In1F+p<=C6x6_bna{O*H>Tv;^-Ho-}FBHHSNkO4{owqE@m(AMhJa1hXI^()cVI3Wv^gC;sRXfH60+^uOZM3dcn`I67~b~b01P$OPgzHb8RD_uC?S@OP;lR;R<{ZZCzR@
z0S#amf1}8+@%K2yO
z1ktupA8WU@ZR>#;+uj(uz#!n<5#8{0H~JRnZQ`1?oCf4~D=j
z(GKJD!!t!YQd6{}PGBEvIkaQM&GD?TTeK6jeS$bUaaOdGm0<^9yOYGsDUP4U_ow-L
zhW5{3&$IhQJ2yzQ^Z54sQqe9D`xo|z_IpLRFWSXlM7!h-$aR_icp3dKUlHv}d!UW0
zO<^3+KmMTXAH?Ui(r{d~Kau~>%c5QH0JlWD5e>xXO=P}FOx{v}c)B%QwA;)dZey3f
z_KJ3=AuJK?ZhXiM;jZYK1}R~c==!&CNOVU!m;`@|
z9w(pZanr(nxF&kM_^?v+_@U5T^aOF?EIbfBVMf>_x|ac2pesPc>8Y)P-OP?1qP;r}-Xc!$vp(cSKLCitZl*{E~-1?WRiz)RPWd
zq^kzoMNf~O>HENI(KGl!HqkTIh4Z3kqTS5N0sCe_p8y9O6+LSuK<;coK)G+4z!lN6
zHvn|YfnGU~I|p{m(H4dPGUvelIa2}h!!=Z1=ajS5s3y`6!&bzdF;U7dVQd;zHY3EyP_bqZ3ohN#+4x$(L1==WqUc9TSmr4w+L@(_Rfv_FU
ziOzebdfC3BmkWTBPz#8Ga>PLSL_q9RAciU+W5u1KS4sxC09#aU1|LKZLbf3O1|v`K
z9M~m#2yKP*2jV3(D;yBLN)6G&(!fc$D|%H8(5Y%Zs0N*ZI;v7fcy`gNdBavXBYO1}
za13sXUPAyo)j*FLVbBu#!6aA@=is5}5hmmY@7Iie57w_(LF&k7xXP
zP3o#S30A;9xC$>tuVq32l!RK)5r)A`SP#eGw&=Cvfj1MQ;#S^oH1?;ZN{J^hVU(h?s7SEgBz&8=^NU4*NxKO505jirx&{G$VeS
zQCIU)@JjR+PGDb49q>&nY}<RVu66!Leb
z{Vw#WE{{Zyre8#F7QHL6-Yo?XJKau+-n}CrPY=rWzy>{u)t>HI$ZCc6tMSzzeFE|zJt??J|quZ
z5q;=<(TDvg`fzmrzO(2*5QihSh&~d(jCv~i=+vT*DJuF{;(Hu&jo&2tgvFvyJT3Yp
zwts#t`ebZB4`!r-(&wTtL;vMIqOaidij|_T93lEDVr+G&=xY?we=Q>VTH(Kl3q7NT$LFZw2Q-;6J|lo5R^I3y(rTo=PqW@73@cSRc&9zmc
z|4B?;r@rgh>Uw)X-|N$1EgXUSqTit28)={*(C!WL-5}o$^4%cc4f5R}-%aw}B;QT)
z-6Y>l^4%ogP4e9&-%aw}yb13`zm*iocPj$A!UR|gXW+T$x06Cah=47k|CJj00QR_3
z8s><8H-YH)$n$qv(eLLF{Q>@eSXT5$A!QCS{@!8hcgNu`(fKY%
z{e5kqtq=Snkjxi{@{2gs9^%jp=m39+Ll1=+;$Y6>h(n&Z%f%7zS8>GOD2@avpgH_5
zj)Wn=KCguE4Fo|O_yHEfLHHBih$B&A_y)>AUFZztOEd>I!AZC)4(3D-??`bN$YVSa
zhdCIg0qr|YI3Nz6mEuSo3{9aooDzrcP;n$_0kp;1P)E{T;$TkXNHzqn1HZ!O=L^}P
zEYyQ8FaqYnW}qIwd*Vp0!((xzxGj#9XT_1~H*ut<%{0i7miqiVi6b4q`jtLN92p9U
zBV#7GDUM7F#gVzSII`q~JK_kKFOIC_%ZAOeofF456UC7|LL51g!3J^UM24In#F2~k
zbC-h4;>goo9C?v5?`m=6s|MJBHHnV=O946ZUxH`iD8MiC7NFe%#h?bXgTa7|1+Z0t
z!*B!MiKAc=$N}Y`K19PvaTJOVOT-blKpchfLy@K8_!fT_tuBsY>BLbyBNPQb7jFxL
zU@EMEQ-G~XcmerJkgo*#l;{oPfO<>phKul293{zDl6)n}SF$>^1?np~71qEZxGs*;
zabXKwf@k6=%P$<3#r9?Q1F>07f#i?}DnTP4e#?ykV!7N7I1i7+Q6Bxur-Q;!697k@QO;+6^v1AZK?iGYfJfmTASbhs5|LUMl=BTGcJ;!`56$RxtP7BinqoAf`D_ValDytc&uQEi{=
z9{<1BU0Eh-NU3mti3}|l=KpVWH{881bu4N5b=m*0_kFH=@>sR~&wUv`g#?vF)@tEg
zEB-S-rTxdX{}ZpL_>XGK{8@~CuDSnLYx`GGs#BXKV}^fI>(?UxYa?S|qegAJs4p8e
z?%G+s*{Ds+_UhHfZM!vBFOYUt_cY1dxrw^HNu$oq)QwG=wCkuYv(w3TI>JtSH)-9Z
zi`unm`ws2Yj?JSQHBpRo>g_b31+5KDtd8fIGP85L
zCLNW@ojd2wr;H}euM8nAsPrZ+q(pU&ZroXE+c~;pXI}cX>TlS!QI}|?R?lWp9r!MH
z>zwrssj7@oezHHg`h9YHI~nIOh4Ygrn!UxDPEqYGZuBUMy~Q_6Sf^EzEOzQ=ryOTb
zHao3Js!F(2vpy*!?Ue74V4K&)$>oX;e|y_CPNcB6xiP^}A5xVxvHdB5omREecy=0}
z)H=>BHFAg9X+k@tx3MRQoqE}+(@uHui2dp9G^>>=Bkb){c3O*6lT?zLGq#m4rIjib
zNm+-<5$oJ;r2?MMarwk*#8^jNIrNx)R!sp`O`QA5s|-*EDMOT@$}nZP^1Z^NW7;Th
zACDl7s{|?0N>`+a~a(UYQkM%Rlj9-S>ZRkU}sba~w6dY9&1N_I)n`Dy1Pofmc<
z5H+gf?2g?#Ms|$TZd|*5?FzQt*S2HZh_*%BW^0?Y&BHcl+DvMGr1|9L{hEX|Nz+8H
z6IrKtoiw%I*S=hPYwhW^`_zuCUA%UhTJLLJuC=w+^jdvtMb;`_D^1P!H80oPT622M
zJ~bn27O$Bm;(f&Bh^-ORBl<){Mih@oQ{#P&%Qd#vm|mk#jmR3sYow|EzWU|rTdPm6
z-luwG_2SjjRC{0Ta<#41rdR7zEwWniYH7mXhu;oA5xy#XYe#ALRl}?1t?Co@IP65&s<5$PQDNa>dBc3FJg#!0%Bm`3t3*`^uadWlPw3;&6QQd@
z$A(6QhKJ@2^$B?#aw23^$k>pmknoVaAwI#6gHHsn3LYCA6&xO%H#k+$+n|dO
zcR}mFuj_w-m+t?O1q$Zbm}gL)uFfcDQ)h&;qO*uIdvrGMNbdme6bYXvyq2(hg0}H<
z#~ICS1+na)|x*|CmH<;c&@NzRGR$<8TG-shxF
zSD67E`N=ufImS88Io>(JZeNo~Dao|~?}9RJDbm!=Ey`%N4I{{?YxFXD8^0O*jVs1|
z-P8w&73&t(uw(-PxWhOEW)5lC^W;REgW6bg9
z1arDM$DC`Yd6vnxN=Ykwn#5TF9o#o2~*ptCh;f28n5+j!1U`*?_bJlHyp{$BJV-eRB}>-n*pCogXy
zv5$8(s4JRupu{Dja&o3k?`n@|Ag-L9?R-&ozD`y?XGhZhPTpoPnmT#kz-Ww5vLmOz
zq_E^bW2;;r(y7kxNT)b^lTLQ>&W178*^_jjZJ!8x%OznAwx>F)lk$dyEi;~FPvuy9
zs@Z$O?LCI{k*?C7-ViAfc)PNcrAGvEFTj?BD6?c}X_w&r4rFLfI@#HbbgZ)}=|Cs%
zaG*zH(x%Qvq>YJO&6rO)p04tDs*}}W{GH)!qPi`M8X|
zvyDe)S|5IF*2mSyRlM)xKF+rapnHE}%#uT8jEsFmv3r2E-v`^dB(h4xVKnOF9=Q{{
zHSnWPDZ)1mV70NvWJVclPb`nZitC`kPtYBbO$<
zrL=vfvgL2~lG0`E8eC&RUBnqoU6TIZtXH-uUVGGu(u_xY0H}giT!MuQ<|ypK^ikHvS&84*uJnV
zYx(0-Z+QC{_Bq%-J2xvUbtEtk5k@(=NdQifCq*X+TyN9CUOK&$^_
z(XsexvccO*#uUr8#&r8Erb>Jx+^~B2-@L)1TIWz=Y>v5*bdmktY)i}~Y#%X?kRCVr
zwhPXse^{-k?on0ZeBiqvsBx#naqm-=&B{#9r^}d)2%c$UK^`=hA%2NLj1hk0ndlpR6k(SDx7Q
zl(OoKWhKQGd$xV7$jxA6H?m7S&RLDIW>cdnX@ABVmt}R^vbtSHx68z#SMTH;bl5nI
zO^zCT7l$=tA!Wuw`k1E-it);Lg(WR(tJa)_bLAv!R%A{wr;<)LSutdLLAAZ0nwA$-
z<}rM$hPlP$dppd7Cf`6}`$e_=qM9d7zPrObW73xGBbB+%TTz_voqVqja~@*F$JfW#
zwz_WQH}WG#38MsQC~q?%}efC*B|a#muj^h6F2!8)jSbn#kF|*9BYV*uW9I>vet$)^4tLtA1BIBYQlFiKKrpjo>g(I?+Xq?WNIe_^}B(s?!BA*90$o<`X7D8=~E;K{Es
zjqg!WjG4x4(z(W5(s>3xVRrr-+xv~z#Ge=EG=&k4IkTC=%th?xF^iBEHR*3=S(Edw
z8DuhRGDA&9AG5m2yuoa3GTSmcnaq>S?k2Mtv#&XTbdbqR*Bojx2R4VB%(l%R%pXWy
zqt$qNj$-#5#qK$ZIn$iUo;l_+(p7e!S!?oLKjsFz&m6Y<$!WWvoHMVn|4;Kewf)7J
zKr!!_cO=gL9c^?~q@J0&d+K_rE2es%
zs%NU)DKDhlm~ueM$P~L%^huE|g?IAT$yX)Mp4`vxrQdbGV}6_c7W$3w>+V-E*`j2P
zlLaPyob*7_oJp=G*_~uXlF`0*e5d;M_HF4KoOoH{dWp09-1ph&6X?9}JmMU|b#J88
z%RFFCHj5j(jfKWIqq6rN??v7dydx6rOSB}>q(sfV4tXu{n&dSo;q8PQ6GkO0n_y9b
z?-O)Q5Eg$`{0Z^H;^&MvDqj0|+2W~jo5rmeH-Fruan(3CE9Yo@AqV6`4WtVDnLZZ;g(~2U==;`71wRsl>0+eYm(`;)z!4579xV3LMN_-Q|k0r6f
zh+yl|unXsl*mXImN>Qz$`+;mkFK(suSjHt|F_SAZJAW
z_l1VLTe-;W`HJxuGfe9q(Q{_Mw8-^_(_M=X_gFl&SoZTH7OePf;f{!Z7!Q#L_yHX2
z-h;;ys#(!&;%Xyu8COJ}HY`a~BWI{lh55bJQghmJ$!yu>AeMh{Y+W_XsCiMUF1U0bEMXM5H>
zZ;`nhe_2Rn}#n=FA`L7VGVnI$qn|$K3s<
z-ilb`f#oaB2shJv`ft6lw9wXF!qY+@@%3Bb-sfteoY~ObLSxP+9$#9qR0a=}h_QYc
zF;$J3RdcR5J=Pz_HQ_GX`iGcVe`^0f@xWcXZ@7H$%y@3RWd8Kg6aF!tm}B{ZYu1xo
zwVvVH@okJ>3{P*WyIcCjNN4F9kLYmqCaXWrWL{?5sqR#%6_d}3$fWi?GuIgW4|`l)
zYVf`s%St-)ySip~A5R;BN~)MPEK8OBB3512vihILTEpydV9KtTEKGlIu(r{-2FZb#jYu(#Emuq?#qo-Y!4X@s)cqGI*lN
z>d&6u{Qs+k_(teY&uwvu5-XZMu@Y;Y1Co?<>*wx4wTp^xlJ>E5*3DdIxY?H3uN{B2
zQz>~r(Yus8HcHv!vPWxIR9G=#MZ~TzV&bZC&G7UfD<(egJ*n)wMAmhyHIn_S{*%zY
z`{h0#)f&M4|JYHHka4vc5o(>&tn-8Ytiux_wW>?&nA}!`_}S+H%SQiEU#jKBonTL^
z)`;W4($?(DH8a(@W@=#e^~vnAUd_vLE+)4XHKk+qEbF}XaTN0OtS|eOb&k8t8Q_0s
zLF>HmiT!GpmZAyIxjpY5#cOh>JF)92b(BMl=O#u^o@aldA3W>yjC@AH}d5$Nv|TYtWr
z)NJh1y~cat*S=%v{_Vf;Z%fYaUwSsSS6#g#_8H}W=o98;`>Ybs@lV_G^&GFnlss{JXo&IiZ+~Y$H&J5f!|LA?yjONPT9vfIr@u~I&|Bdz^
z&lMic?{d%E8Vx?x`(K<%KhfH7$xyv_tg9+Z=j31LY{l9~z5nI>wt8L(V6<>)>ejwG
zGYHc&S9Q%VqKFS$`|7H~*y+x1#eJSw+LxhcTeFLnM7iti_`ACY-~B{i*WKn++-3ea
z_HF+-cW`U$y5pRXJI!{>)rQ5ITUt7&|6)dI&1ibZMBK-@vNe}B(|>{`&g?C>}&MTY)eGOy5kWxnLEIq7A@<>!#}S3
z9VfYl^V|^%Gz+_|9oAaOACun|Pl4`;YGzyeh&!HM*-w64Hs=l~5p~)8%Nkdm?_ANu
zU2r>|!u;e~OpTV+tt*MoujQ&?f!OookG*e}eMRxlt|wx9;^T-A>uTc5D~T#Sd4lG#
zkL3~7x@vMsUL{fj5`G-LZEdPl7T<)uKZ(|yW>vF|kM$Ij{#Yg3XX9E*V%6%A-(x+?
zcIWNh_==}yhW)%Om39BvZ9U6!))TUX9@~Xpl>0H#S+=X-w%w=m=DPNkm}d@T&EPz9
zNo(x-*Vh-H#_@lBH5OWsC%Lh0sN3`BX&yUY?}=b{-w#d|YmW1I-~V)W>xo{^82E9v;~9Pb>lyqf
zGoM7P0C3OPg8F=RcfiX%`>}e^SLU}tp%M_cxI1RuaU4`ceB*lVt5`O*p6?8GSurS$
zG}WwiM6vGv1SQ~!?;!U+_t~}bbDqOJckgr0oho0GfH)^UZL9JT+G3YopX*Fnf+tJ8
zcuHjVo65_S1X_0Yara#ze(mYwEYtEp>^o_(J>Z#R$G)=oKbvP(_Wf-B;P;hz=0BKa
zRyrgBj?JH1rP6xwb=-+%71a#mNt$huN>i1&pTuz*;yBV?Yd44|f7Y11n-S%_{q)z0
z=cKG#NNc9ERxL0pFEkgM8(B|BTr)1aW4cmBB`l^+%c99*&X4Z7)<2nxR8o}$F|}Cd
zo!HlXAMbGf-=7y_&ro9D^Ni^g6#w{xnt+hX%8Q=f#
zEP&rH^VK~)h~Ls+u2;mYV|MjP=kiyDd&-2EdaZFMEpxq({@Tr&mOqS}wzuxEt|g`0
zTUl67tJfI_VM!ZwpXrjKB+K4;aQD4LM)FZ|F@&rLe9uv8P6&N$LdX%
z*F4v3pI)o~KkZB9_rF%evL?qfnz4R>C(WD8-^@Kc6Fq32GtZkB-1)4vJFa||wd0vv&28pR
zbC@IKeuk7xo&YxvYj=${H>ocd6+yr7TU-5lgk~zTcWSIvXpJ?h#AAL{os7)%@kN
zNYdP~Wcnm_$CFadTBByI6c)u=iJ97tChKbCm9wzs0_K`^vRj%$1u`)_RWXlIuIRV&6^qIHG)go^8z&Kc8cNddEKYQxkulD||A)
z{$gIOlx1avTbABzCH)6ig`YmFRmxnAsexZoVnxQs`-E0(v64UvD!1(w0oErgLalc?
zJgu@mm3=$~VSi)(YepuY-1b@n#i(hoQL*dLvPlNbUrWj}^=s-mb(uO>?WuND%d16I
zALX`kSy`hjQu^`kM_Z+|5~z5ylJ4;Vjf%BZ
zEM|-E-FEL|6^na|RU+=K!ZBNcFA%RC&d%v?=j7YF$(hE^ncB{2jlz#VFJr#9%9!u0GUi*WjQPeYW3tA>
zEqT5#%Dl46ytK=(B7`!}?J|4=xVubV&zAYb-ioactLD%rrB&LQ!Yb`#4GH@A#guvU
zMHyBZQHJ$Ql(ELDJG@e4N%!lCfu=GpSuViCx;4J%yc#W6C`AY&r9|
zw=x(3MmFOcBd3we$Zg~`@)>1~az;g?l2O^HVMG}1jSfafqmvP3L>pa=Zbo;bhw;Yv
zVCtsBjBCa-L8kSx4>9#4X3I-2KVTFO-4x
zX&|5S@F|a-x4)g&I>PsHSx4>9*n;CKIqlH{nYf1oiedRMvtg}t`tlfK5yx0}{*_}^
zq`s%_uN|{iuvh>3G1H2~cmJZ!jvUMM^&K$)V^Lo%*NJ0UjjtXvt^W7UDEHNJ)|&;HzJAQ4m!jX-WvNKH
z@?Sq@(yuA^_4dlz<-UH5ctr;*4!?{SYovYq_4W+L2g-d_PWqNr?(6MYqeE7Xx$eVY
zCGEO)RV&Z=kJSw7MfHHXo>gT7IQIpsMbrRRmTgy-DN}hHvb)k;@#87gF;*%N|p)+%UAKkHmgd(-(4DBiW~R
ztNO*B@GthTmi4nz)v;%0_X=>!{;u|0eI~POO^U}u*4mLT%ed}ceDqHnyADs8)?c(-
z61!@#EYswRQZ>I?s`)3Sntf5K))#wff3c^|zw}{8yY|>V>=3iZV?)>V
zkY!JoP22HTH>{P%n!VcCwLX}$r+q$9nXLyH0i@X&1(R`Z%qdAYKjz{teQwSPPR^5g
zxjHUul;zn@MWZ55QEM1AxY}uNv}fgVN24RF=sOvmxXO+;qG_p{(T$dR7(FHfrGPaLh&&(F%B?ivNf}$%NBFS
zE{g;;XxTbTN7K^3I6vDZtutFi@zyr8LeF}WGfHczm6vSlZFMVi`aa&2P-?tc}RS`qBbsAS-B!v%<2hS%Fod
zuKqxKS}jST1#6{QQ
zVnur*?v6I(US2q}@bZjJMLxcD#%f8`EMYE2l9{aR)k-E(Al<2{cInfM9Oys(I4Hjd2^z@e}c8&98WsJ97nm4#uSt9y5-(V
z%v*NmSUcw!(q`sp(kfODFqd00Q`
zX$$ibX*2U8=`K5sWaN(Z2A+8vI~Fv5=lJ(r=c`69^E~Ng^A`JynCIB;$!w@N&oguL
zew6zv#XQT=pIL*hvIg)p=}7YwdnU3rT{TXcC;mV7-aF1}YU>+M@5xCHy-M$8Dpkrb
zh2A>~GQa>s8_Ep5BPa-nh%?dz?3E4zB1L)^6p<>ZfS@SYKm_@H_dc1-$@Sd(+~0HW
zKkw&#=X_@EwX%||l%1WORRQN>9p1TtWBQzUmE#=puH{Mam)oBL4zN!E_CkCPNBsVA
zzQ=&!en78-C`J1ys5$U^=K`ng!+?#$XZ-ddESX>*1iWOUZ{m0l03UDf2P9e?!QKZf
zkz#v+4M1#!FZK`bgZ%a$aL(GF0M4;@1J1H{k#+5zfamS2*l%rn2k=Bhu8`x{4v1W0
zUeEXl^c?DgA8&61KHJ_3i0A{z-vX?=+e1DiI6V2u)`YhSSl*d#1a-pR09fB%4;Z={
z>wty!wARDmCmeXiM&t`q)O-G-yeF`p_Y5Y(qTCc-r2XOLeH|XxH>js~*mKEd;?Dle
z?8no-0J_0Cc=8LJ11=ad`)c~T9;fewMrpa({j7Vv4Uhp&q&WP6Mwp>5x#Eg4G)
zO-2*alJSJJWJDn?8B<70MitVMafP&GWPvPqY#~@^bP>tA_+N>uOYF2HzL$7d63r@}
zp4@TS%qD#FH~3C@^EsmDV9lxEgfu`T#!z%)kY^yO$QxxTpN#H8kj&djls5~_Rs_EN
zd@di+E|K{2bNM#%=H(t;-u~@*xqQUTgyPbO-0zqX@{jUm`INj@-YmZ@FOlcUljY%Z
zAGwp9BG-|t$i-z#W~85`Z>2A!gVHwXed!g%M@*M8rT$VksfF~oR6{By1tmfJUHncw
zCmt1dh-<}H#YN&QaV(-Io)p`Njl~$ToLEp)g!{q|!X@ET;S)quyeYga%n>FcvZ6O)
zE0Tm-LM5RnA}s#mZ}VUCpY!|qE&RLuGQ97m;*Hmj@4`3Z>+#j_KC^=4-dx1TU^Be&ycgRzrrR%HK0bVWLVYefi
z&X87{c-$c}3A)UX2lEuFMI<(`In)A3qAXvhk(`IACHFYhcbeo?$8Q8~!r%4>_@e&=Uxho=SK)5p9`u~K(WQ~2HA_RYN3@_-{&mb|&<+NvJ`}wO
z{StAO=zPhfPk9t#qQa=kK8lXC-kME(yaXTB*he+=QT2UPJs(B%y?Mt%^vih^(Mjh~
z#LAFI5#2!^Mf3`J6wwXjQK%RmM%D09x{uO)l>>LNqpc=Rmcs9*;&+dQ?^4niYIhc^_5IN0s$a?V}p_s8T-a
zF&|aZN0snV#eGyUA4N1~dB;NMF5cM|@$m}#s6sx9zP-Ke3ix>WeN;XlMcyoV(j6aV
z`>24AA{w&1?Tm1Wx$C2T^-;h3sOvuJ2Oo9GM_u$$Kl-R!KI$hQ^_`Ep!VlEa=ec_`{`>1n1>Yk6f?W2D2QD6F~Gd}7!
zAN7@wI_smZ`Y7bi_2vjk5
zTz=qABz_RKs?h$Cfgr;6Bof-?Ka9wSuEyp68Ho>XB9|Yy9g#oFOS&
zl*GdR1w#}A)@Dno`L#WMVnlu|k3T0OKi=cdj>wPm
z_=6(yV?F-Ri2N9j-yc>Hz|`PDss+lc&X9{E)S(<}PL&K!rQU@tXswGvDib{s~mv|ew
zhdxL4p)KOO;xci*I8_`e_7l5^&BS_QHL)ZN&z$h9a83A9I4o=zRtqbIg~HRqXq4mX
zA+$o4q9~z^kYAAad;CrQ0)L#}#jodI=d<}|`SJV^z8BvPcHKC>0$-TdxCh*i+-2?*
zx0l<@y$xIPTy8S_PWo`2;CEREcHZKg1-0eR?6=TSRUle)hJlYQ>AUp<$T9~1SoBW#
zJfl(!H0vETMtOmXCVVNA2}d
zZ}_O!ebj3{>Qx`L%15pAQ7e2D`3}o_rkDGuWj<=Dk6PlR7W=4|eN?uOBAVGed6Rt9
zcpo*d%uW*aFIowoO
z*@s|u&<$Q-N$^dL;woT<5QI0_U+_}B$zEo^V2{ExYzzEVUuT!VLu?j1ksZknWP7ol
zkQcErTZ^s6mSGFi=#Bf#ZRQ&Crk+AR^c~Db_>Zk*vYENam`d*sJQ=tEy}x*O=VBFd
zvB0Wa%qCjt(0b(PLm1;>`8+J>VMLD_TCaeImGUs61rKpcdl=_oM8{9Ln8V~^0xfo_zxm==o4;>ZJdxS8e4GnE;
z=VF*y<#Hc+*k8FAW=gqR7`a%0e8-3OB6^tQVHky6ZsA-kFxkTraxr8P&s{IzVU~vx
zy?;ms(cp(LJr{%LW$rRL7YjVd#i*w>-6HVNT~-&K<(1%J9rCsed47<}4#bBi5&oYk
z@Vz7%i#ougzcYG!59$X(yg*U|eQD;Ufta%nrQVris5i)@z|_F>Fn;K9jQFq7uL*|fgf&^LK_GpD&}jHJ$cpSeuR>#{tq=##
znBs6c6)>a!0iNQY^9T9u{94TEU*_k+J0=tUpig2}p9F8sYJ4g9Ybu!6-{!uBhs;rK
z7q=15?=o%yd}PMr>FtfVeKW*VMRDc0!kob|?62Hd#8+KlKV|pg$$g()$u2_mor&yl
zwjbM#ZH1>c4wVavvo<2G?jd{FW!MW30^1HRH2OA$wStTu^gTo({ye-u7>)=#Z#kmA
zJ=_k%kr&2Wj@<7aZieAT7>+zC-a4pT;^Ar-j(9Y0xg3Tg6Q{Ra48w&moDaj{m+h@j
zGWzA7FQQs=aS|ix;eUnU55w>WVfdeUIQ+W2ZSf_Ohu;mu?}XvMh2hk{Fm(L`H^P>~
zk2Cjp0-uH9XT$I>!|?CJ@S9;c^2K`lxf+K55{7>phW{9be-(yb3d2u@;TOYj_@H{S
z5TEMd7sBx0!|<=e@bAL#>tXn{F#M-5{BRh4C=5RthJPA{-wVTUh2giu@S|b)kudz%
zF#LQN{zVx6a~OU)3`aDtcO6cI;m5=9D`EI$7w6ys@Be0h9Gu4ZW*6x%RnzJlUpjvkVZ$obo37RiE>
zyNnzW=X7*Bhb@5=rvvJgkbQ+RapWF7kx%mM6Ar0o;EmAmNfqITOZ;n#!dDjaDw=zn
z&X}D)u)h#?&%^F|*zYbT=GDguJC-=yi>bZ8YE
z&Q1w@1RvLwz&7}W--HDC>B2u8zQVL6p2E3TmE;8{_l?Ch%G>)?rUBQF>xFq^2Y6_v
zaE&o{jN@u>mEfsaoGZxLoW=>5L*9d?=?C^2=8@;v&)MVbLCht$vzytqi2Qw>eT99Q
zUC7SGoN_8^zh$z+Ft6;xK8YxVc9>fxu?-Ow9E15~1-2Ahl+BMhrowWlaf19d$l#X%
z%~dEPeS12m>5bVF4}VW+XOUwBReg~eY%=s$@bg3*$i=`##DshY?-C7KrXSHm;k$_(
zVno+up@*YlC3<)zraaXqRYJCvhfHPkS%#?sosz>;L*;`4Bv*dmKIStV>Msy@i^3l$
z{GP&_6yBil8iij|c!k2t6kek6JcZ{dJWJu16rQ2*6on@#JWkILlj=8@B)S1DO^cm6AGW8Z~%o*QP`Hk2^2O4%zG-y$V1{(ANNN=1UBO?EDLM`
zTpHL2xFoOvaA9CQ;EcdJz-fWCfc*k%07GL2nO%mD1FHi>yFp@F$v1N@Cy2iDPT;-3
z`^ZQCR^VN5B98$a@<4Ff|a({w4CoA7%HmyVz}rY+ud3jok6e*lc_=%|Qjk
z$%yqE$qvE{tQY2B9WV<^!91)E8-;#N@gjdIHYhoM(4gY%@Q-HW1vhELob`-Xy5Y{Rzd7MI6
zMu5j-Z2EzC^Mm@H#3Eqi3c<#}Z{Q8akui+Ixq#Qn(E*bE{Ya1LDuv%tc#Xio4hlb}
zkQ^gN&w>k`13gL(<206g@0}=A+4SF?ZOnQasr3r7zAnVq?yRs{SE$MPPwrf((g~`Z
zgjF`-@kSgHAn^@&3TcbykhXaGXp1KgEoYym@DzoIDcnxs1_H4cvJX6Cw8e8oTRdTu
z`xJ#uC~QpOJPPMhSf9dyfZmgUG1qXubj~{Gob%2F=c4nC^R;uux$J!9T*_Mu-~EPj
z)H#NF4kw&Xos-TP=L_ew^SSexL$sl}Pt|6uwaeM|#o6lYbapr&JKLR)9HObt-Pa(j^|tel^RDxr^S<+ev%y*KtaH{n
zYaF7x%v}p_LR89fe^@Re;;=6AFWe+?@!owciO7`Uh=K2i+AjYX?Z%-8H9`#!hSul6
zH>>j&xk?W93HSzuuT%IMg~=2qQJ6>}z1mI!#pyM78UfEeMi#MkM0*xGViu8JL|>Lm
zMIlFF9#w`R`lMW5ejINeCE;C-H#KUG*gEgo90{Q+vYpwyXJeS4Dx}w+FWCS}efx?4T0C#)x}o~XY0
zl-1ixMITZ15A~f4qo2~xF{;5C8WS|DnDI<8v$@%csc6nIUt(g-Q|3jck$J~_z_het
ztOiWiyt}}5Vcs^knID