From 9955bfafc29012518f338dde1927b21c47399f53 Mon Sep 17 00:00:00 2001 From: "ester.zhou" Date: Fri, 7 Jul 2023 17:15:28 +0800 Subject: [PATCH] Update docs (18685) Signed-off-by: ester.zhou --- .../reference/apis/js-apis-font.md | 5 +- .../reference/apis/js-apis-matrix4.md | 154 ++++++++++-------- .../reference/apis/js-apis-plugincomponent.md | 3 +- .../reference/apis/js-apis-router.md | 2 +- .../reference/apis/js-apis-uitest.md | 19 ++- .../device-test/figures/smartperf_frame.png | Bin 0 -> 49717 bytes en/device-dev/device-test/smartperf-host.md | 83 ++++++++++ 7 files changed, 189 insertions(+), 77 deletions(-) create mode 100644 en/device-dev/device-test/figures/smartperf_frame.png create mode 100644 en/device-dev/device-test/smartperf-host.md diff --git a/en/application-dev/reference/apis/js-apis-font.md b/en/application-dev/reference/apis/js-apis-font.md index 0b7d7fb3ab..ce578a35c1 100644 --- a/en/application-dev/reference/apis/js-apis-font.md +++ b/en/application-dev/reference/apis/js-apis-font.md @@ -5,6 +5,7 @@ The **font** module provides APIs for registering custom fonts. > **NOTE** > > The initial APIs of this module are supported since API version 9. Newly added APIs will be marked with a superscript to indicate their earliest API version. +> ## Modules to Import @@ -28,12 +29,14 @@ Registers a custom font with the font manager. ## FontOptions +**System capability**: SystemCapability.ArkUI.ArkUI.Full + | Name | Type | Mandatory | Description | | ---------- | ------ | ---- | ------------ | | familyName | string | Yes | Name of the custom font to register. | | familySrc | string | Yes | Path of the custom font to register.| -## Example +**Example** ```ts // xxx.ets diff --git a/en/application-dev/reference/apis/js-apis-matrix4.md b/en/application-dev/reference/apis/js-apis-matrix4.md index b707f54df1..e2de4ddced 100644 --- a/en/application-dev/reference/apis/js-apis-matrix4.md +++ b/en/application-dev/reference/apis/js-apis-matrix4.md @@ -16,7 +16,7 @@ import matrix4 from '@ohos.matrix4' ## matrix4.init -init(array: Array<number>): Matrix4Transit +init(options: [number,number,number,number,number,number,number,number,number,number,number,number,number,number,number,number]): Matrix4Transit Matrix constructor, which is used to create a 4 x 4 matrix by using the input parameter. Column-major order is used. @@ -25,17 +25,17 @@ Matrix constructor, which is used to create a 4 x 4 matrix by using the input pa **Parameters** -| Name| Type | Mandatory| Description | -| ------ | ------------------- | ---- | ------------------------------------------------------------ | -| array | Array<number> | Yes | A number array whose length is 16 (4 x 4). For details, see **array** parameters.
Default value:
[1, 0, 0, 0,
0, 1, 0, 0,
0, 0, 1, 0,
0, 0, 0, 1] | +| Name| Type | Mandatory| Description | +| ------ | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | +| option | [number,number,number,number,number,number,number,number,number,number,number,number,number,number,number,number] | Yes | A number array whose length is 16 (4 x 4). For details, see **Description of a 4 x 4 matrix**.
Default value:
[1, 0, 0, 0,
0, 1, 0, 0,
0, 0, 1, 0,
0, 0, 0, 1] | **Return value** -| Type | Description | -| -------------- | ---------------------------- | -| Matrix4Transit | 4 x 4 matrix object created based on the input parameter.| +| Type | Description | +| --------------------------------- | ---------------------------- | +| [Matrix4Transit](#matrix4transit) | 4 x 4 matrix object created based on the input parameter.| -**array** parameters +**Description of a 4 x 4 matrix** | Name | Type | Mandatory | Description | | ---- | ------ | ---- | -------------------- | @@ -91,9 +91,9 @@ Constructs an identity matrix. **Return value** -| Type | Description | -| -------------- | -------------- | -| Matrix4Transit | Identity matrix object.| +| Type | Description | +| --------------------------------- | -------------- | +| [Matrix4Transit](#matrix4transit) | Identity matrix object.| **Example** @@ -136,9 +136,9 @@ Copies this matrix object. **Return value** -| Type | Description | -| -------------- | -------------------- | -| Matrix4Transit | Copy object of the current matrix.| +| Type | Description | +| --------------------------------- | -------------------- | +| [Matrix4Transit](#matrix4transit) | Copy object of the current matrix.| **Example** @@ -171,12 +171,12 @@ struct Test { ![en-us_image_0000001219744181](figures/en-us_image_0000001219744181.png) -## Matrix4 +## Matrix4Transit ### combine -combine(matrix: Matrix4): Matrix4Transit +combine(options: Matrix4Transit): Matrix4Transit Combines the effects of two matrices to generate a new matrix object. @@ -185,15 +185,15 @@ Combines the effects of two matrices to generate a new matrix object. **Parameters** -| Name| Type | Mandatory| Description | -| ------ | ------- | ---- | ------------------ | -| matrix | Matrix4 | Yes | Matrix object to be combined.| +| Name| Type | Mandatory| Description | +| ------ | --------------------------------- | ---- | ------------------ | +| option | [Matrix4Transit](#matrix4transit) | Yes | Matrix object to be combined.| **Return value** -| Type | Description | -| -------------- | ------------------ | -| Matrix4Transit | Object after matrix combination.| +| Type | Description | +| --------------------------------- | ------------------ | +| [Matrix4Transit](#matrix4transit) | Object after matrix combination.| **Example** @@ -238,9 +238,9 @@ Inverts this matrix object. **Return value** -| Type | Description | -| -------------- | ---------------------- | -| Matrix4Transit | Inverse matrix object of the current matrix.| +| Type | Description | +| --------------------------------- | ---------------------- | +| [Matrix4Transit](#matrix4transit) | Inverse matrix object of the current matrix.| **Example** @@ -273,7 +273,7 @@ struct Tests { ### translate -translate({x?: number, y?: number, z?: number}): Matrix4Transit +translate(options: TranslateOption): Matrix4Transit Translates this matrix object along the x, y, and z axes. @@ -281,17 +281,15 @@ Translates this matrix object along the x, y, and z axes. **Parameters** -| Name| Type | Mandatory| Description | -| ------ | ------ | ---- | ----------------------------------------------------------- | -| x | number | No | Translation distance along the x-axis, in px.
Default value: **0**
Value range: (-∞, +∞)| -| y | number | No | Translation distance along the y-axis, in px.
Default value: **0**
Value range: (-∞, +∞)| -| z | number | No | Translation distance along the z-axis, in px.
Default value: **0**
Value range: (-∞, +∞)| +| Name| Type | Mandatory| Description | +| ------ | ----------------------------------- | ---- | -------------- | +| option | [TranslateOption](#translateoption) | Yes | Translation configuration.| **Return value** -| Type | Description | -| -------------- | ---------------------------- | -| Matrix4Transit | Matrix object after the translation effect is added.| +| Type | Description | +| --------------------------------- | ---------------------------- | +| [Matrix4Transit](#matrix4transit) | Matrix object after the translation.| **Example** @@ -319,7 +317,7 @@ struct Test { ### scale -scale({x?: number, y?: number, z?: number, centerX?: number, centerY?: number}): Matrix4Transit +scale(options: ScaleOption): Matrix4Transit Scales this matrix object along the x, y, and z axes. @@ -328,19 +326,16 @@ Scales this matrix object along the x, y, and z axes. **Parameters** -| Name | Type | Mandatory| Description | -| ------- | ------ | ---- | ------------------------------------------------------------ | -| x | number | No | Scaling multiple along the x-axis. If the value is greater than 1, the image is scaled up along the x-axis. If the value is less than 1, the image is scaled down along the x-axis.
Default value: **1**
Value range: [0, +∞)
**NOTE**
A value less than 0 evaluates to the default value.| -| y | number | No | Scaling multiple along the y-axis. If the value is greater than 1, the image is scaled up along the y-axis. If the value is less than 1, the image is scaled down along the y-axis.
Default value: **1**
Value range: [0, +∞)
**NOTE**
A value less than 0 evaluates to the default value.| -| z | number | No | Scaling multiple along the z-axis. If the value is greater than 1, the image is scaled up along the z-axis. If the value is less than 1, the image is scaled down along the z-axis.
Default value: **1**
Value range: [0, +∞)
**NOTE**
A value less than 0 evaluates to the default value.| -| centerX | number | No | X coordinate of the center point.
Default value: **0**
Value range: (-∞, +∞) | -| centerY | number | No | Y coordinate of the center point.
Default value: **0**
Value range: (-∞, +∞) | +| Name| Type | Mandatory| Description | +| ------ | --------------------------- | ---- | -------------- | +| option | [ScaleOption](#scaleoption) | Yes | Scaling configuration.| + **Return value** -| Type | Description | -| -------------- | ---------------------------- | -| Matrix4Transit | Matrix object after the scaling effect is added.| +| Type | Description | +| --------------------------------- | ---------------------------- | +| [Matrix4Transit](#matrix4transit) | Matrix object after the scaling.| **Example** @@ -367,7 +362,7 @@ struct Test { ### rotate -rotate({x?: number, y?: number, z?: number, angle?: number, centerX?: Length, centerY?: Length}): Matrix4Transit +rotate(options: RotateOption): Matrix4Transit Rotates this matrix object along the x, y, and z axes. @@ -376,20 +371,16 @@ Rotates this matrix object along the x, y, and z axes. **Parameters** -| Name | Type | Mandatory| Description | -| ------- | ------ | ---- | ------------------------------------------------------- | -| x | number | No | X coordinate of the rotation axis vector.
Default value: **1**
Value range: (-∞, +∞)| -| y | number | No | Y coordinate of the rotation axis vector.
Default value: **1**
Value range: (-∞, +∞)| -| z | number | No | Z coordinate of the rotation axis vector.
Default value: **1**
Value range: (-∞, +∞)| -| angle | number | No | Rotation angle.
Default value: **0** | -| centerX | number | No | X coordinate of the center point.
Default value: **0** | -| centerY | number | No | Y coordinate of the center point.
Default value: **0** | +| Name| Type | Mandatory| Description | +| ------ | ----------------------------- | ---- | -------------- | +| option | [RotateOption](#rotateoption) | Yes | Rotation configuration.| + **Return value** -| Type | Description | -| -------------- | ---------------------------- | -| Matrix4Transit | Matrix object after the rotation effect is added.| +| Type | Description | +| --------------------------------- | ---------------------------- | +| [Matrix4Transit](#matrix4transit) | Matrix object after the rotation.| **Example** @@ -417,7 +408,7 @@ struct Test { ### transformPoint -transformPoint(point: Point): Point +transformPoint(options: [number, number]): [number, number] Applies the current transformation effect to a coordinate point. @@ -426,15 +417,15 @@ Applies the current transformation effect to a coordinate point. **Parameters** -| Name| Type | Mandatory| Description | -| ------ | ----- | ---- | ------------------ | -| point | Point | Yes | Point to be transformed.| +| Name| Type | Mandatory| Description | +| ------ | ---------------- | ---- | ------------------ | +| option | [number, number] | Yes | Point to be transformed.| **Return value** -| Type | Description | -| ----- | ---------------- | -| Point | Point object after matrix transformation| +| Type | Description | +| ---------------- | --------------------------- | +| [number, number] | Point object after matrix transformation| **Example** @@ -472,3 +463,38 @@ struct Test { ``` ![en-us_image_0000001219864133](figures/en-us_image_0000001219864133.PNG) + +## TranslateOption + +**System capability**: SystemCapability.ArkUI.ArkUI.Full + +| Name| Type | Mandatory| Description | +| ---- | ------ | ---- | ----------------------------------------------------------- | +| x | number | No | Translation distance along the x-axis, in px.
Default value: **0**
Value range: (-∞, +∞)| +| y | number | No | Translation distance along the y-axis, in px.
Default value: **0**
Value range: (-∞, +∞)| +| z | number | No | Translation distance along the z-axis, in px.
Default value: **0**
Value range: (-∞, +∞)| + +## ScaleOption + +**System capability**: SystemCapability.ArkUI.ArkUI.Full + +| Name | Type | Mandatory| Description | +| ------- | ------ | ---- | ------------------------------------------------------------ | +| x | number | No | Scaling multiple along the x-axis. If the value is greater than 1, the image is scaled up along the x-axis. If the value is less than 1, the image is scaled down along the x-axis.
Default value: **1**
Value range: [0, +∞)
**NOTE**
A value less than 0 evaluates to the default value.| +| y | number | No | Scaling multiple along the y-axis. If the value is greater than 1, the image is scaled up along the y-axis. If the value is less than 1, the image is scaled down along the y-axis.
Default value: **1**
Value range: [0, +∞)
**NOTE**
A value less than 0 evaluates to the default value.| +| z | number | No | Scaling multiple along the z-axis. If the value is greater than 1, the image is scaled up along the z-axis. If the value is less than 1, the image is scaled down along the z-axis.
Default value: **1**
Value range: [0, +∞)
**NOTE**
A value less than 0 evaluates to the default value.| +| centerX | number | No | X coordinate of the center point.
Default value: **0**
Value range: (-∞, +∞) | +| centerY | number | No | Y coordinate of the center point.
Default value: **0**
Value range: (-∞, +∞) | + +## RotateOption + +**System capability**: SystemCapability.ArkUI.ArkUI.Full + +| Name | Type | Mandatory| Description | +| ------- | ------ | ---- | ------------------------------------------------------- | +| x | number | No | X coordinate of the rotation axis vector.
Default value: **1**
Value range: (-∞, +∞)| +| y | number | No | Y coordinate of the rotation axis vector.
Default value: **1**
Value range: (-∞, +∞)| +| z | number | No | Z coordinate of the rotation axis vector.
Default value: **1**
Value range: (-∞, +∞)| +| angle | number | No | Rotation angle.
Default value: **0** | +| centerX | number | No | X coordinate of the center point.
Default value: **0** | +| centerY | number | No | Y coordinate of the center point.
Default value: **0** | diff --git a/en/application-dev/reference/apis/js-apis-plugincomponent.md b/en/application-dev/reference/apis/js-apis-plugincomponent.md index 0ae1baf6ee..8e809509f0 100644 --- a/en/application-dev/reference/apis/js-apis-plugincomponent.md +++ b/en/application-dev/reference/apis/js-apis-plugincomponent.md @@ -262,7 +262,7 @@ pluginComponentManager.push( name: "ets/pages/plugin2.js", data: { "js": "ets/pages/plugin.js", - "key_1": 1111, , + "key_1": 1111, }, extraData: { "extra_str": "this is push event" @@ -376,7 +376,6 @@ Listens for events of the request type and returns the requested data, or listen | eventType | string | Yes | Type of the event to listen for. The options are as follows:
**"push"**: The component provider pushes data to the component consumer.
**"request"**: The component consumer proactively requests data from the component provider.| | callback | [OnPushEventCallback](#onpusheventcallback) \| [OnRequestEventCallback](#onrequesteventcallback) | Yes | Callback used to return the result. The type is [OnPushEventCallback](#onpusheventcallback) for the push event and [OnRequestEventCallback](#onrequesteventcallback) for the request event.| - **Example** ```js diff --git a/en/application-dev/reference/apis/js-apis-router.md b/en/application-dev/reference/apis/js-apis-router.md index bb43dd6ce3..ccdbaf8baa 100644 --- a/en/application-dev/reference/apis/js-apis-router.md +++ b/en/application-dev/reference/apis/js-apis-router.md @@ -671,7 +671,7 @@ struct Second { Text(this.text) .fontSize(30) .onClick(() => { - this.secondData = (this.data.['array'][1]).toString() + this.secondData = (this.data['array'][1]).toString() }) .margin({ top: 20 }) Text(`This is the data passed from the first page: ${this.secondData}`) diff --git a/en/application-dev/reference/apis/js-apis-uitest.md b/en/application-dev/reference/apis/js-apis-uitest.md index 3b0ee56a7b..13bb7707f4 100644 --- a/en/application-dev/reference/apis/js-apis-uitest.md +++ b/en/application-dev/reference/apis/js-apis-uitest.md @@ -8,9 +8,9 @@ This module provides the following functions: - [Component9+](#component9): represents a component on the UI and provides APIs for obtaining component attributes, clicking a component, scrolling to search for a component, and text injection. - [Driver9+](#driver9): works as the entry class and provides APIs for features such as component matching/search, key injection, coordinate clicking/sliding, and screenshot. - [UiWindow9+](#uiwindow9): works as the entry class and provides APIs for obtaining window attributes, dragging windows, and adjusting window sizes. -- [By(deprecated)](#bydeprecated): provides UI component feature description APIs for component filtering and matching. This API is deprecated since API version 9. You are advised to use [On9+](#on9) instead. -- [UiComponent(deprecated)](#uicomponentdeprecated): represents a component on the UI and provides APIs for obtaining component attributes, clicking a component, scrolling to search for a component, and text injection. This API is deprecated since API version 9. You are advised to use [Component9+](#component9) instead. -- [UiDriver(deprecated)](#uidriverdeprecated): works as the entry class and provides APIs for features such as component matching/search, key injection, coordinate clicking/sliding, and screenshot. This API is deprecated since API version 9. You are advised to use [Driver9+](#driver9) instead. +- [By(deprecated)](#bydeprecated): provides UI component feature description APIs for component filtering and matching. This class is deprecated since API version 9. You are advised to use [On9+](#on9) instead. +- [UiComponent(deprecated)](#uicomponentdeprecated): represents a component on the UI and provides APIs for obtaining component attributes, clicking a component, scrolling to search for a component, and text injection. This class is deprecated since API version 9. You are advised to use [Component9+](#component9) instead. +- [UiDriver(deprecated)](#uidriverdeprecated): works as the entry class and provides APIs for features such as component matching/search, key injection, coordinate clicking/sliding, and screenshot. This class is deprecated since API version 9. You are advised to use [Driver9+](#driver9) instead. >**NOTE** > @@ -1119,7 +1119,7 @@ For details about the error codes, see [UiTest Error Codes](../errorcodes/errorc ```js async function demo() { let driver = Driver.create(); - let button = await driver.findComponent(ON.type('Scroll')); + let scrollBar = await driver.findComponent(ON.type('Scroll')); let button = await scrollBar.scrollSearch(ON.text('next page')); } ``` @@ -2659,6 +2659,7 @@ async function demo() { ## By(deprecated) The UiTest framework provides a wide range of UI component feature description APIs in the **By** class to filter and match components. + The API capabilities provided by the **By** class exhibit the following features: - Allow one or more attributes as the match conditions. For example, you can specify both the **text** and **id** attributes to find the target component. @@ -2667,7 +2668,7 @@ The API capabilities provided by the **By** class exhibit the following features All APIs provided in the **By** class are synchronous. You are advised to use the static constructor **BY** to create a **By** object in chain mode. -This API is deprecated since API version 9. You are advised to use [On9+](#on9) instead. +This class is deprecated since API version 9. You are advised to use [On9+](#on9) instead. ```js BY.text('123').type('button'); @@ -2909,7 +2910,7 @@ selected(b?: boolean): By Specifies the selected status of the target component. -This API is deprecated since API version 9. You are advised to use [selected9+](#selected9). +This API is deprecated since API version 9. You are advised to use [selected9+](#selected9) instead. **System capability**: SystemCapability.Test.UiTest @@ -2937,7 +2938,7 @@ isBefore(by: By): By Specifies that the target component is located before the given attribute component. -This API is deprecated since API version 9. You are advised to use [isBefore9+](#isbefore9). +This API is deprecated since API version 9. You are advised to use [isBefore9+](#isbefore9) instead. **System capability**: SystemCapability.Test.UiTest @@ -2992,7 +2993,7 @@ let by = BY.isAfter(BY.text('123')); // Use the static constructor BY to create In **UiTest**, the **UiComponent** class represents a component on the UI and provides APIs for obtaining component attributes, clicking a component, scrolling to search for a component, and text injection. All APIs provided in this class use a promise to return the result and must be invoked using **await**. -This API is deprecated since API version 9. You are advised to use [Component9+](#component9) instead. +This class is deprecated since API version 9. You are advised to use [Component9+](#component9) instead. ### click(deprecated) @@ -3373,7 +3374,7 @@ async function demo() { The **UiDriver** class is the main entry to the UiTest framework. It provides APIs for features such as component matching/search, key injection, coordinate clicking/sliding, and screenshot. All APIs provided by this class, except for **UiDriver.create()**, use a promise to return the result and must be invoked using **await**. -This API is deprecated since API version 9. You are advised to use [Driver9+](#driver9) instead. +This class is deprecated since API version 9. You are advised to use [Driver9+](#driver9) instead. ### create(deprecated) diff --git a/en/device-dev/device-test/figures/smartperf_frame.png b/en/device-dev/device-test/figures/smartperf_frame.png new file mode 100644 index 0000000000000000000000000000000000000000..4cd602ed03837c570efee4dc3887272414b391e5 GIT binary patch literal 49717 zcmb4r1ymhPw0t9z=cXxMpcc%INdGGx*Yu>CG z*18nkeY>lwOU^la??b4Pf)p|WJ^~mR7_yACgbElK1P}1BgM$Ii1b_(cfCAi6MM?~; zbd>M_IDj%0l@|pAtB6K?HiQO_;q9cg9Kpa)y52wFeYOSPz`!~NWh6vZUG}W`TOHd`F!PC=(W&I{}IhVS?!iL5=kAYMbQD)5|Od|{{Sl@`o zgknu6mBOH)j*F8k|Hfte_Vo8a+roq9Z1~h_>}o~v)cKs4xz$l6XHIcRyXGzox~f!0PMRN8}<60<~`M?C|RR z^AL<^1Z;X~ZS7wISHtY1Nn7{WJbM`)rMj*gfpMv+M^;ooMQ}2NlT%YW-fvHto)U!lzea1n5eJ#|8FS`5g!{%R-{qp zJR6q^jfm4SknN8oiie7?22rVi-sq3HPdl zwbo0yhFw9EHI^DRUOi#h4mUFzMLU&Xzafkm66!-Z(Nx(@M^%S-?v@)IP1f6eEd-VC zZ}Vwn}oZ{x$TEFQN_ z8oo_O3{FsOb!M9(6Qgnc-u0BC#w!uOv+9Ng8gW!dt&UBD(AbWt>idYwEB+M8UY}F)TwYf<=eldlSO_{rf-s}@uA4FPDc;7>QJ35Bk@zxs z>-CG_N3?d(BmP{Oep#mvML+`6^E@>fJPf`Hk}|la)#LR+&LD+E6ig)RAYCyZEDE7r z?dR-7)2-gfQJh#Z@u2=Mih_TVCPcbWXVJ3mo*s|Nc8aS;RU)}|>&?nZMy+k8+B>0+ zFz_9bGQsa2fY)J;C*WF+!M)Px^kpuL`usJ5UZwmVh=e8 zPuO~?)~WV!zRp&E&-Rv{wd_6M?WcBt{x@^Prb&*kT@@;~MSV(#0c ztua(a+gXryf9(h1AbURDo+QqIiFH6lG6t17pRJbM_PL)d)~Ib2?hWogFc=(8|1DJh zl!FWl4!(S4L5hU-@wUVBLqPBr7^vbD2hUv^xld%?2bRQB>1DH78?Bw>$(#(z-Vj0* z<}HyyWAOfBOKk@lt+nk6268Xpo+TZJo7(&JDszUplwfc6BGk(;RJ-bX{athDRY4rRoQ11gnnbI1hzP&&ZEk3rwHbMdtykp9T5> z8!+O`u&Bh0gr6po5V*abZkeia1NqmWyA<8mEX!KdU&IUy;?6q*5oh?^bsm==g$xAQ z8lFy@W^5UE7er!2Jd+i|nUN(ZN-^6Pq3ljY{bBy@yuIGFIdnjOC@_H|hLhLqHn<4w z;lvQzgoH*RgAb{-5c$>~=1Yd*6NIaHECC568H_@dAPLvSA;NuZgU?~M&KRgzV=SEatscy1P zd!0-;ve17jg2GqSgfk#wp*euTfR8;t^M2ET#}_Pv5@&D^p~nC{Ur3q$rM=o6aZJiR zUo>>{llG4RPagBX>Xc98QQjR+*_xYF{Uy@8&gY902j*z$Q_EGNQ>UP1bFTU!0L3o) z$#$i2MvFWkffI`-fD*0T(`>?iFWrT{!XF05(GIK|9)H`cK%*?LaWNoU*r#5Su>Hb%2v|+;wd0z}vHGehvV9UqB=rO)$XmgV zna>}nD>s84-|==9#NEXJ#8u%OCf0gt0hw>w0(K+2H=DZkAAB6QpuNzL(4_6^+dk-f zvXbpqAdv{^eibf7or`{IZ~3U-s{56sn{;*~xV}r5u=q%7mh6X}fDcJphN~PL9l?Dv z4;egCF&HjJ=&Z#Ss-_%E^xkpRSk!0T`Z9QRWR7RE@e1VMG@A2|GAvgWcM=eDsNoT9 z4I0vr;osA~7+3ujM7 zE-ABygX2s6GlVIL7#uGOF#U1~W61wvPf`i4M9Ug;euASzv4jx=EQu=$uw?#U$|#jL zRq@YZ(ti+ch2L+WM0R^f+U_~8QG>r>qHiuW8td@Hd!4nlXvykNfd@?0rsTQMXsV7{ zd@GY;LhM`9bT4%qAR} z2`uo+-W`d5FDWhDZw~*Yu!b3h^ zgJCWL%#Kk0^1*7rBC3~Y?^s=208c7<;K>6_qUQTmI&6!%Ql_OkTbEhSWw*Wb!zGvh zy2iPDWy$g_F(pN-8(mDAG3&h#M4C40#hPU4d`=FvKoy?Zk$-@8H5bn)rxDIaAB$#Re1`++7FviIMW(iK)|COs#0Yo)8y z?ki4nGV1C{Rh(R^(()^Ko^wXwF8a4*2mK!;r3B!WD zxs+gNoE85^#I*Wivpy62EjEj=Zj)a`KaY(hCG~uz6@XNg0v=BXPsnrTz+n*Hyb#>YwWsWIrEH;)jdH`kUc&c9 z=Wc2nSYq@aGoS6sJS*Ab{aD4uwM50)eh>Y17(GZ-)g9GMCwp6QNB}Nep2#hf9LQYe zJ9AP_m68|bh7T{OU&VBELR0um;7r5K$ zlfL7&AA8ZDY+YJ*KwS_-pJXEj&(ikrFKm-j`J1#7NKGec~u|agX`LO8NDl^N8)q{K07v5%GN=Tu4}jq%&t|M%%n%AwMg?6KU^g1 z3LZ(N2$%c*u+UVapHEy3=@B0CSR+be{={K_OP<|7Qn#H(m-=Vyfphz8MG>%e@#@di zZ`wb}Qa`=u(Nj3cXjZ4xN-i!$US3;zLF_^Ce>C+>Ba3c*DjNJ*Q?!Up3m^WGy>^Ih zhQ5C}6;o<`UXAOYwNUq8Yk?JT05hARyn5u{^H-4A%=S9WlPd^+g?m~R2R@>ls%pxtv3+BIL$`+v+b8zQA0@EPICvu z%!~VOoj>el$^vfW^qI-euX(k=23b^Yq}$?NGn~fzg~?ws90&UpbzRtWl(5FC(sYa% zkJBQdO8vFnYsGoV8bqK6C(w<4OBTB^s+hZ-^}OPFHS&2pISc8LA@xA&$?vcLc6w}D1gwh4tiHH99wF-;@UR5G&LD<;%`>DacY zy;zLTXHCF&%X6<#o;6=ZRqcLlbUMnz-&&|L<=64dy8&Ka|NcZyI+GBo-#Miou=V8v zuS_xsX`KC&t~hQdi8$Ln>yeYo7@na02`qc7x#XmvHP8LnFHYH$93~5VLVe<3FEmBF z$5*tUryk<+B&~ltzP;QP>9Y$hLk;GH zrr1d_ z&4^_vt?$&j;wrZ?ERfeYHiIiK0gRi)*BpXDWCE^!zyY6$@h#n+U?=8xE`AUE^gs_L z*sJRu{)lsA$v=!E5L)F^xh4zM7))gRq2ap>7fA%Ik5LgZo;~hPnSe(yvgyM;ZSrBv z&{vua;mq*-Qt%fD{ZtQnc|3d_N9!6a5T$4^=zzEhp(ISYx!}3=g(Z%WWo}U=TB#PK)@SvWi?m&b;cR_mVnDD`E%1H?pXjO zJ{AvpmWQ*QnVr&w;PZJ`R9T&5~Lv-rilBQ(b|2y-*Pul z7N;ojXsaK6_X&0`;kwz2!|H{XX*Sgn<+k}bw$YgF%nC+$1w;6~7?Xv(8pHUzt58sp z8(=QJjebetb1DoQyM)_>yh9M(uML12%IOy$N#)jP3!w;rWZAv};=&@6XYw`jQ}6(a zN%%gAcvDVk4LFtDcp+x8+;2+j5@5rF$vzPo3z&)m+3qa`l=0B2%k`#me4nUJzE9=J zA8Le)@Mv0F%ohKxh2$XJIPZWZ!BV)Lz22V?M{iGW@|t!a zhbSW3oc=*w4prX~pkY?m-L4XpLK=5Q# z!4Q4D#mn+a7s*RM`~xylnl6R+(i~MOHopUd31XyD@DPa=oQ!hHU7!IL&cTUE(Vqap9O4M2D(`;s>&5fp5&ee_p zKJ$AC9cT z7ora)k)L|#_vB=YhU)A7i=i|%p~2y&p3oPkE^tSlS-^Jd)to{rEo|w%_`1R2;o(W{ zc4R4!+vCHdrSEedJ@BLb!sY593^d59@E!MjzUZ4-CNA?cjO!!zC}t_kCYy^lc>y1S z*z8^=K`w$1%4Hc&+)paA^G$AF{^*Fyt4ds=Uh?bkm^9;uE;tz@x z?tmvEx+~+tN{RA4Y{#qRNiehM8mzRl^57U6_>pBC+Ks7Q&=>3*=1KjDdJ6Uc_Mn;V z5ozE3fIo2dA$H?%1{u<%_J2A!Nn2S1&@9#}VUYhu(VTRaw8t`!GzZC4bOdpa`}}5| zed-$Asb#b%qTC$I{F5!u59Cj1h?X!+$wc1``QK`yN7NwiI ze}f>d`!x;YXM$~X@3VS`HVrrkn~`6fquR$Egw)*>La97vL_jhg6U9ih{fquH*k@ ztCgO)V6nnxo8K5Uxmz_R3WY*@*Q;{vF`cMw?RcaDWlu{zspaHwL0D7c z#kk2fSjFgQwuGM8NHo{poZD=6dmui&W?$>^hU_Q-wyk#dWKhLza`e}%&jWu+)KuNQ zvosi5U&xUi>s=jzf#uF%qJ`F$tq$Y;8md%Dd>_cVWZq$Vkg>d2*JEkr?Jj=CXz;F; zXwb*NtvdICTW?30rmX$(rE5(qXYIA8GQ6&k`GWs7UB4sT;ol9(LQYSz22 zKwASQW7buVE!ACvwLeF0pJRyr3KI`k9Y($N{(4=@WMU9rDiaFn1>eWs$MGKb+kzGB zBhwzIU@*tsA-euYD;`Br^Ok)@ej#=fp zdMs=9(DvY>zObZVr-)ab!*0Bed!vcr9~-4dPT0;gP}7Zg2)g|2?p9nf7lXXe>Htfr zb_U*63A5MJRB>L-93|SgZwPpL=x?VkiEcn>wFy72)I|>dVdRUB9_)pGeju7~rq^xC zFSDY(p!E++O3Kua%~Wys1}K<}h~-d5ryuaGUJhZdyyW%+!l!Jjdbs_cJK+GioiBSCUxm!4d#Jh{8(TJ)WN^wmzH~Hfvu%eI#${mOt6SHb5M3?-8y0%c-NBhYWjQ6qD4V|5MBbmlnvH6l=SCup> z))ZZjZF^4I$3%>~R2mXV^q}wP<|(;a_|lARTXq}0TO7df(wJJuatzp5i)r%IYCc8c z2Qud)CFmPoh`mnL(;yhn4|obfTrzI*C7sbTpi&05cX&`;6MRA?7ATPfhiaP#RH=zMC+H&*`v0QM7)o@rW~-W=m1vk|C-` zLUUUUiJ$Z&j;!qy#HwGU%SX{;GX1ek;WoQ{Tyd`Ru4ck}Vg!O+V{28YReyTGKtY!z>`_WuV zr5a$C^)iBafj=C7K{NY+Eoh2VMG9)k&_~w~;pV0-I-fFFu&QT8@*~5P`yN;$g4$;m zvxaW!UfFc(5?o{-oViarYUiD&(+2XYfPcoV^}qR~Q^!%S(T%t%g-S$*#J#&r+>Jh( zy#?=vxkTC>i=x@f<lz-YqO&~Bgp+D$m%~l+P`oO;5iEkJYtYU*<=GZ8m zmqH}NZd^AZu(-)7lCq2Lz_BwDc1{iP#Xs@8xNQQiyYdB?-5aXFxlf}o5^uK8?+Tw3 zd`0B_J0k<{W#LWvwk3$R5Dg!m3s`*n<|XjVZlA778;tCExrWGwoV6smuLf5 zX!{7Kn23i&3DltU@rrgz!?MIO2?}$lC=fd(A${UNJk5u{s!E0(&9G|Wy)Z4+rkP&q z*8b+`$O!b5K3k&#S8_Y+By!NkdQkMz!*Npc_nd2p;KPnIe2sSqunZ7E>ci1^zbE?y zExypFp8Q$xno^>`sQ)LTrw%gtVP2e5;I8*clJtOW@4N9K-B!FO za_-WSC!ua5w-T&NfkC5GwM%KI#gmFphQdy%!4L#NZ=>pPT48cU1c^&6vSZAJVWxDA zm`ZL4uqTI}jd6jF+(M^!1e9zn`4q$xT|MEsEJ>C)lR%WjFDt}CXduK3cCP$o_(Ld^ zb!XqUE>U!{ChSyOuh*$Wup8SeOIw^o0D1Wj=|-7eUw6Il&}B3ODfG6*SePy_S&ghIAj8@I=ClwOgi0c`e1S~DA-CUSxcM6e(e+O- zA;NXqg&4!jDk2BzeZMh>@tA8JB0e!d5QvGZ*4cdRn|u17&1x18+i`Cvjt+D_n3ODS zI^`P}9CWDd4MO-!SII=7!8bNf7yVKZwLD(fNI2vqfIK-R(Kt3wZ8}>_>u5{A^Z_l~ z&yS85Cs8;EtNMUXuetKV2kEUXbGyqh@{eBR5A1&so(crUhp~0`^p?RO%@twy?qp1K z`5a7mTW?3rR{-5%Y^cfR5N?UfU0U(&C_9ZSX)_rr1Y>T@d$0Eqc1dPg>xhI^<$)?zR{-Qu&lg720N8@)zpF(2q1n>(y-$cCnYDo8MzsbY!@ zqKplld7%*8WU|4)+Z~wneMpSCME>8PWGS)Hj=u%F>i|NAx-+O%GxaCy-jpYVYTlqfP6H1gx``f$g?VLqd|!)M8hD;dm9*zTQ+v$*?7F)R&Q_A#}OQ56O>+7iP z<#S<+gH8G%eXESC)g!M?sRbxbV5yHA7S{gZdJrk)dX(8&S3QnH6^fFw-*N3Vj^aa_ zmYQB8mHqDeJ1i;A<~*S2ERL-By-_Dzt zoAj=C<(f?}?$1~-I(wTHdbY|Ty14W`tLp6b3-KL<*3YpLQc39@KL*t+w`9DtK{#5=#`ElyF{u==Xwwv=)O#Io=D;Xd9&wbpu{sEUw6~It>;+W&gXl7ZZ zZo<4{@c_l(nDD1Pdza?_3O4^2@b)iInwH(y-*oCC3pXP*Kj)vHt5OEU&o6>JI=4Ih zRAXmx7KxL&M%oDadGBfkSKNXKeU!aH|DSV79spRZwLt7SL9z<=v^3%AW-%jrb4e0L z@ZOfE?OmP87gV*KOKLSLerB!`Z!vg6pD||D&wJAV9YjW%(qAQsqFXG@^DhuxMdkkQ zKU@$ck%>WvOofRWm1)X*uVj1^_Z(TtD}oAC=%qj3qQP>{T^05BIVIK)6ul{7z@_CWEfed;Sx~>2-B=@xH zVg|hZ&YqXUr@jYyv2^ZvPC&^)(mIeF!`AK@fJ^>uIGJ_O4{|639$z1sk;(vwR4Z*( z_zqT@>M9GWt(Vl{5j8b~knqSA1#c1-QIT(lQ`l$NqI&EwG^@>Gr~iJDLT1{))igXu z^k%f|F!CcSKq2D8(zbuRJz)@Zzm7RwX=3o^crM^xZs+6lyg&E3s{o?0m^pCKD*LTZ zHOK~do-a3Z4zpUO*u5mBh<%pj!kuh&BkBAarERb7R5n19$2rC417&v*p0SW+9PX)& z#iUtCby+BL3Fe(o7U?d^Js%vX!p;$^vqT|Fe*&mcQB+{LC?u*fo717{OaTQF$Nsq# z1hjxGsD*-t{hOe=Y@`!Uz z<9_Za8)!OfEdr78j0)cA)*u-|9zko?+hspWp27BY9c|5{4miPnNO?sqcCNyPFq3#Eu%j|GjQs}capTx%HV^f^4GL%p#lH5ny}j5{nO!gA-XD<_#-Sa&V2TZr z0Bbfuyn5%`YO~wmFLt|ik(yH98F9soljVjge7_DB`FDv46$~mSnA~WfnXf-d2F@jo z?&IBA8Hn``=806`*{B{a-h&L}Q|pXGz$JIG1#%dWFF1Nv9$fah*=52hjxo{0$F2&K zGQV1M|ga5q&1Q8UD40=X3Z%H}XvB`utoAb39_%u(JPs$Z5=0hB`jw#)s;u9pCwoGQBK zB?U*v|4x|#H2Qz)-2V6D!HMwK;~}}f-()N4TTL*eR3s4CPRx2KWjq?taz!QikqaM_ zWC%s^=Xb`$@P6crHm1YS+$YIAmtUT6h`fC36)vBfD&!raEG^*RIV`SMGGA99!0Wjhz~c!$t52N{1hM?d8GHYgp& z**)gom!rU~K{`^_a|l0IbhnPYZS*b?9)qMqK)}gctUBq?qpu(fE#Y*Fu z5+t&$D)4ptx})`)#g}BVUF=077L%KiKRSP|cIj}*)1DX^i^nj=`FDS*sbp(|Y_4Bb zWH;IvW z-xcCSC8tIDDADh{hd4KfK)*S6(bd^o#dOG{$GxgAX~&VcM#Ml zb5y(elYY~sxrqjc@^|-55>*)9wuQvH^frP;hNZmo|2@+$n&1k!OVo@=|OUW z(W@EWy|S9Exy*K6@!VHIXMFjJIaFQ{<#*Cd@5PRvcT4k;MLO#S_s?5jPPo36OUL5@ z{qcEx4YwihYpsGFHfU_W7!HZtv3oblx~4vQhf%M31BJYw!4$w&lDi3XJBZr zSAV5aY023VH5z=(bJo>>XS5Tlg&x()vF09FP%s+py(M?U>ws2h;g`T)vW5>u)&GIb zYtiS;i_LTUkM={X`P~o#*7<)CQ2cktJMaABKmy&Dw3^?|kB3ErB*#m2ih8aa&^5!d_fC%5dfXnzD(8ISwUm6{(Jo;b)Qe+a ziCsmQJiv3)`Ag6N@!Pq-wvg+2mV2hgQmu7(_Zz@qngHsk(O(5D_?#BGlYgs4U(bIA zlXk9i^jlsGi`Tm(fG0qw)iuxZ2P6Y1k0{mK>(d#(W$O*K{I7toxG!qCe*&Kt`yvVQ z>B+C$myrqSZ{HcOmgLJtxsBwTua`*u_E+yj6_%w#fG z=AC?_vI8WNr}vL$03*5xi^2@&@%pf5ay(xVWqaWJoC{q5FM&(w6H|XuyYvk(kQRc( zq^Qh#&6)mH& zhji-?4c5kols4wIR#09e*-n&aPS;++Q-)VsYt#;i)0`Z}1n=%!zGLQ20Rg{1m-bAN zhD#DgG@v3w(BlDE_~%u^R)7JfvKn?!(mP6zgD`{#I!KBz6rWfj5MS+Rr<84>)X~Tu zr9R?Iufn*6dky6j-BY~%qSgq9iHFy>9|QwcwEg1inAPEVT+x@t)bkf0VyaY~Cu4s6d4nv`WKPQ@0f3JbWpH8#-bQ!mlIXcP=|1Uf$MHf{BBv=ZN7z8m z_hLuT_+P%nkhYei;tPBCk*3?Nncc6GQeLw?Yge0*eaTmF61&=QQawLes?#_MG0y60 ze%MV#+#;Og0}L)6i-AwEZi7nT%ep@*eOs&7Qz3%)`Fh78A28GNYhfXFOaPJ7=r2XM zBOb9=k&ILx``=rsuKTVK^?FRtF=gkLN#H(DVh;em1oJ?6P!#>O+(6WD{$6t4mzMcP z!7WQb3vY-W0Bj6wX0Y+;*|C1COttO*4i7US)Wie4X#8^WKqm-#lGE0w(=SWqsPxXs zZU7`+lElfwOdn5^;VMStKd7Uz-9i5#LTcsWUwDR!f;};wEw1LTrv77pTvRQrQQ0p< z)bNupXNU7LJ3xPf{o@}@(B?>m5TkCE08ngUU(TE|tH5PHg@wL>_R@G3*}F?zHheb! zp$|gSCPq(MCzoM%;@+tLuUe71g*QiOi~9}ztSi75HUhFM$sl~cojM6HK`F2y$*~MU zwMLQR?9HAU3*XRQyZ#t53*K>7#19`;ACT{YpM&(f8FrsZU&z9$&HA{uWeI}?P$v8a z3Hr$7?ppxb*g~Jhs2i?^2m;Xr&`Yi=FQM%b)Efx&LniX{i3>ANi3OBs3^5+Pp#I@;Z1HNus1BmJ+T zq`GOa=3&)-B(oDr6f0!y<;aPclbu*fz9NwB`!R3K_)S+j&EqYCQ`s1|eSrK`4LYJh zv>>+zti#KgKLAc-@dnU~F~RbE2Qa?R$-gn?Mj2_!=ij+wi+2Hm5$ zGg`!aqLywm^I>5lfO9#+6_4zf>cCHy_zlQB=)K8X>`=9pAT%)z)g)G+gQNU;mwg3F zhXO|5z}n`8ad-Z#hSKbNl9BxW2ne}LyxA=pzmBobzJ-1uEILM}ki1Sa9C_D}e&mJoQy^MPMN zU53g;6ANy)`$CTX@>WX8@fAMEjZb6hxY8ldnu6X$Oyro9(kWC5{e9W%L@`qBgZcw$ z6Zc89Iu*qPL4>peVeca>8Z(;Q=~j%lF+3l-Gzru6v#*DE3MWDGq!_A3@@P8h%8z5s zYlh2ukZzNLI1=RHWdKTm7D+LJLa zA;!X>rk>0qFHd9sZvuWK_G~dJm`}Ef8lxR7hpzA)~S=-j^JgXQw?zuOa8 zzdPWlI>*l`#r(tSyYE>U*l)gBykq4rIDc)nDmo zWo9qK=Hwd$Ih3QB=%?S+aKx)Kw&T%?hhFC%lM-}bjK|` zN!qG$PiBjVKLQyBMJC=jklS9mAA<1q#xnJ3fj3|&!c1_dLVSN%RF?K(gxFITAr^Ft;UgN~0oG{KgP`XXRg~ zA&?IOngc%*B-T-nv)UE-kWsR95QEy~Y&Gf7GR!4?g&B21j0s_b8)!DT;BZSN+&Aih z`N*py`A%`xivH-t56^~h(eh26*bDH7wjYS25|y+d_a&qGsu!bgFN~H4HmfKHHS2_p zFX7^a1;5j<8p^pJ^DAA$V0Py984~$xD(ULK#v9)kGQOmASP5KQHOqmM!SGrxW&j2m zf7|K;y?~rkvr$kTwG7e1C&j`01G4iRtwGnzQjtKN!AB zsI&X#z-!nN_VlT{Q7B)Cb@2^C9~Fs^VqH4c_CXBf7PUKCYspa8Bo~?+Yy?rX@Vi zl821Yy`{NKO_k2GVVJ`tOB?!m-%iSlT~2sbSr?+NJT>sQwPzLIuK#pwjN79lZ*<$6 zE9K3_UZt9}nD$-V!iMLIf}%`b9vhjFQHmWN6cd@*{JtZ5$Kw zQ!8d5VSgPqG?EbM6E?KmpLswf*7^U{_fLIbTb`_aq3^3Ozv$ zCM7~6m6uTslcW$oO@F2gTNe&*+u)g+EJ_Xn@_|l3KG0nu9OsM@70R{Kd5B@jd(5%0TLu`$8!seH#6c89( zRQ2Rk@^u!P%q}g`n)%V!pv7a(TRjMtay_$S|@X z_&m6|zhc;p9Z~*)1fHqt%7!8XgyNx0?wx`{%zk8yNTLr_*D?3+N_{{-jjOppYxPe` z$~$uT?{MV*?Klbx@yv&-T_d{b#{v1=SC{l}CMLW(#uA?!bH9No61l3;%pa?z)3eDR zqzK2*a?@!m_q1YdPch7|vZWJ0k*jBH$ry=!hK@ZZB0u5}dj?fXw>%wR^B%h{=BATg z4#|@1zewiJsKjDwFPg_}xyB{O7~SzY+=UifQca$V#=@Xt%ll6kl0U6tJv5g|4+WCX z@P}Z1nzBdvXQssB^rwtXNv1-=K0F4Uk~_GWjqU#b4ncubk53EdIXZ%TZ3C zmK>b|W8Zu5rxWX}w4KZ$8Rh~ul0HZ}%rGCeIEC^xOPPsH!VIiPhz|OggVv}g0_{Ij zInwNWZhUakCVg?zDuZ#-*nrP_2?d-xrwwfv4QxFVCU43t@9H2VR6o7wC~YRQI$S1m zxU7+6a19xPJPSQ`mH0z7MH*#b(_!u}q0rJ`2A!!bvpxPM0m3!S_htG4v<7@;GjuPE zBh9E!SRxOmb4nrl?A7Y+Hze9lGZY4lGrsCWi*!!@v1E4*j8no_p;m%@j%GRkdX)pD zSZelTp6JWJChvHO_S%U6HE8oMJ);_!w3TStO+PcaH{1o*41E54BvasbT@m2aSZjX4 zsD#P-9$g{xW0zS3Do!#cZ;S?v!2X*p4o@=2VS>{b6M=S1n7sCUTZD0R{PE7iFN z0Fijqm`2vFP@3|G@)B74ru;Mn=2jRY;R|t^yURQgcoP%Z#YT83xzx$MZC!~j0^!r} zJApyA>IczhI8&&`_O83W>qKPkueGkVpn`{<+`SqTc9{)>^j0C_gt{vtbB&az>f!ZgPz)=j_)SgE%+mXVP$#B=N)8BACMy~=tzTmrDA)afp`cpAkd0DsD2u>srM1z;l= zKvM52=1I0%9xViO5%t4=2KFFlN~~-P*JY6svcF7wz5a@@);P7zGrT!08_Nncp-o=+ z*+MwiU#Fa$=m#oq((qtc6sy z*p7Cc_8yZ)K^641$vH8Y1XSPOOqhJh+_+DEuvAxuKZ*||uU6hq7ilOyOe zQ~9-qnePzUI|c?MRI3l+bD(jrc~-G;zvEMCEbpN=sL^Pl+|WOQL|E@+&(=x^Pec&| zdBq=9s9;uEi{iwx!0_GoZz|cCC)i?;iR#54^-m{4_2&azf4^(I+y&oBX-W7%bwegN@I{CpN3?^SL4jN z^~j)uod*m}z$@P-=|6YmzaL-5Zew8e3DQHDV4S>_D}f%Jgb#VG4X4Q3j|5DGZZ zGWX_OF|$}A;dSb~U|g4#;l29wht*a?A8H(|>%ZrB|J?G$QYHs+@pBQ(O|FVfMy{&dPh;U$ zI+thj#MfT3$d#aG-sV9=$~2 z=|QdKoWct=A~1Qsk_MrYlop4`|Kgxy8}_a5b!K8y5_(TFPeNZK;I?7pN(-Dc+<2!bhua@ zKC0b$Q;e;-MSHH@3c2k@p=?G3#litD4+Omm2g2gFXas`x-w^S9?(x|y492Rr$#6~1 zC)zVrlF>lM_G#(YrnH)^ti1pj=)Po|$=q$w0PZ9tX2%5N4eTc7uA5791A)XQ2@|>D z*A6?F?pz#3+{VBeq)nJeI!16X`*3SqzaAy*pm?yPicEf{A1Qt!o#Sww!O)_Jvr2vF zZ&{GrFkR)OsttCC(hg};qo=Je)^TQyq~SdNWmyb7%mXy zX0r?YTLWd%kWUe~*|ok(eSr{j5e_(~uX^A&Nm18vd3DxLk2wE`AdFLja_F!W3W` zXwRX1U#5~x!oqtMQN*Nny!Me}35FC@BILGSTzZ}`z_uPk0f%Vw${Mzn+aCX*FQU2|^ zN03fQr9ny>1nCe&KvE>7Te>@j20>C#V)kS?ll* z3m9gedFFY(ao^YVxk%7uEhnKQXxO1eV)zx2gJ~#o;!OqY~W;?!T#afm6MMXSZA zyNx8CLWI>Qo3cZNq4x|s!2xvSH*AGyFO~2RkZWw2xFH!x~dq?aOE*=o<6h!qxY7?fINzboz#3 z>|Xe?t{nA|$cnus{rQWIjr8$nTSwp6ODn$ql9edgtqIaM4K+J*HddwHHEYrZb1)qX zWf9%8=%b_&QCR6Fk2Qab{P96P(MzUF3+l(yUYs&|8xm8&_I&@fz=PSjx5s{R5`*!bs&1iS&HX4|Pnzq6t zyw_1CMbCvTa=Nf(O6e6A^lgs4A}^Zv&c3drsKU~#4i_ao^}W(Bei=l3akduH8r~m$ z|B)=lRYJkSXN%X-&?1}+SKOa~;jwFg0LkZ|OCcLH*%#E-oQpZ3#c^u~opxa;ls>TXwTCF(!eCjEIAM-9dCLcsGR5pc@)7?W^Mj zMrkLxlV_(gy(1MPNi;og_Pw`0ltWQXV(v0tF6D{68uPiNN*ivtS?ma|MZ(O6C@n~#sJt`{5?7NX8N=aGgJZ{jMq zTy__K8+oKg$K2BIKE!F(4m`$wAgtxzqjb9Y7`#dVzwmZRTTZXLbw+~sZkhQ=M!Vgs z2l1%F-16C4f))c)+k)9Gl%+|y9p zfw4jPOCvF|Sfw4*2mXnO(&KO0L&gSM!vX3trt zw}+g6JXj#{nBi?2CN0D!0Le9A>Oq<11f*I2)n#hlvR+ zJ@G4VZyURgyCUfB$jJxkTirClOq?@)YD0Ws^7g?l22~<*<2llTfd%IZ6Bc!p^2;^0 zF8*agIrqB9QT|lz6Y3Z+BZ`H!Qm+yJnm~gYf2Vd_oSwv=%lylDkx5SiK8%a^e7WK~ z*3ZYy2I(`~HdB;nssr%vTJ+?x@$!nV2%N)X~tpKZ^r72(2AY zKK*DKnexJH4!w%vVFQj1%lNC?FFo|!zns^!oe@r>ZpH5gy&sPK+ple)0CXAbaBCOIEk--^XpMNmW-n5j! zcdzeS8gfUbd`!?$2+pqhP?c~KBI;cdGDI5WLY+!tcaMFK8b|G-<&VeS&f{hLXh6?48nZja~Uul32AXB3rX@ z$qQ}ix7zTO+m~yQi6CGP=8VbEbD-9sIOTnTLoUHH~|KBRPQd|Bf+>*@qL847t&J{337R`rT0^4hWja(vYIWQj^ivX`xza4Ou zsl%6dg0RyFp9fdLRKAah*NF}Nf$+ZQu8iUyZe}$^p2rE$MXg!W;YUrpV2*CNJBOYCkU2_@9$lnA>PcQGGjCj55t8sCBx;bz}!<{pitXaAy&+qWD? z>>%Qt_HfM}s|I<#WQ5>A5T@(Zxd}7VI-YZAylY#xh{-h8YH2=_3q&ePL!w2R3EAfv zJ4IYQ9+tD84RP+M0YHZ$7hT&6t}p`D4NVFT_;h({(w(me=_E>YnKuxby;7d>Kh*5u zI*CqoG1s0BIrllW>4qH9G<-U^$Q!8{8y=4Jx0<}pd6^M_bRu~#sgrsg>^^a7b%a|b z23y4oX@*!!ds4GI2(P313bF%{;wS5=N8 zuV+{4ZM>wOld9IT!?gcSsP9LBelcUIwUJA+%eU$kJ&~I^@BOoLh~3@Y%F3F|elmqQ zfFO1BLw9ZV0|*K=Nw9nte|NFhPsfh@$Q~lq;uD5t%pdOyKq_*Lo?5N{u~FH-lKnv+ zeOWzx2=lu<-Rnf)MwB@X3Lt?;cV_s;_E&kd$&2^J*JT7FYwpk`^rNZ-A!N~~;)(j(z#%3=z$ zXX>p#LA==ye~=YpL`CQsSwiQh1+8y$)$KzH@;`ZNku@&eWe|diXoKrQQETRwLqwEE zXRnOD$1^&RDl^fV*@9wWrQV9L8y)h=LA&+PfUuVMNr^9~+d{mfL*RPAfuJeCI@G zSx-uBA=ou3Py*^^<&k~P#U5}I{Bso~qmkd99CS<<=1XfGlB!mcx*ixV@i{fIv51#k zj&<%APtS;0+yzu0{we=m)70(Rp{UnTr41>VnXSL~V0(p8JoWsKk*@ot&$O$MTychD z!qm4B)qTdEpD|P`Re~@07f3HfP4M_Fo4Bst6rKOM4Mj#j+ZrVM@s0!fxq7)7x$Ee< z_{)fuN#uK2b>)N2_my^*X1apEk-VVhR%ggV#pg#pJv*l76QR+XKi=zG_yk#g*k_qW zw)J;%{>)o5164l`O}ssFno-&Bclu)>Qsy0fhLYJbI$-HA_qnTdML~dsUsm81^7*rE zKLbaW?NtNv#fK}9af4qN`YXIEo8flHzoOBMG?5LVNK{WduZs;{hr)e`q&OX@n4w_v zH`wyKL3Q4m96n(nxJvD^(u;EHKV1gGmv4I2ksfFavAO$~@(spg1TUq~~=ao04Dq;~t2fb`n@prb2(+3GAe8utL}I zJO;fLkk7J8Ll2(HxNr5>mm25ek>520FMQ<(!Lz@WUTXp2(WO{HkwO-@{3I-JvE?ejnml4mrEz$38!<6aG>b}^kcm6T za)TxD$kBAFGP-|4Xe8kg*!C`ara8H{kPi*VXdK_>=)UHN$K+^KzQ5?4Q4zQ_pQGBE zA?e2i-Qx>7V?tHP@i`}18R#_@_4mBesL28!cdGU}1@ z`@-BWUy28j{rzyaT^I$wFUF#LP`ztn7medN*(rVbTl{5V%ydSOAQ+7NL0R9 zH6oKP2;NjIWB#p@u%}eN2^bjDo#QHjam&vKBE5ur$%T4984i~C7DUtvG=Tl8EI zm3Ls5r4Z~|@UI`hHAK$*=8`mDZbnEy!7X!-ZvXx#=#W>GR=-5GSa5EET`!rQO@Fo9 z8W&B^JMo})KNTJ3z6c(ioPTtF}3)2^XY6;lNUy0PAX+SoDAqYWILne_lD)4yu1S!1=!FtN@!K`B-sNU_cv_rZ%h-+y>VkTN#^)Wu746@m3p*+UvdgmvW| zEk9bV= z)(GU7V*HxUcnpG`c+q7+e}_rw^>Xb*#SE4&m@S9NPsQw(SzQ!u=yOFdk0U7hIJ(*JXtj`etSTF>dBV);J*J!kz0<^byEig8Bl!Gr7m zJ3by2ZKBJPmhBk_cD*HCYdOQ%0)gL2BNK@U7n;bw;?NGq!^qtPT~ z5r_~d%cXD$?r&_yz6PI3;$lxDsUpmmg4I($u827g+6UoFHy>qLuq+7B4V^)EIX;n= z%)hHfr*uHwf3WP9dxrpn+cQXIf{;-`tAWs7NM@QxT(qYwI7%AJ&=72xt=jO%O7+Ev z7*C`rrzKqg1@GOd#qTMAy@a;4e{}SRMU}lx41iC2dZz6`=zAJHG|Nwe4TZ5`G!m<* zp@!c9C8fYS%1}i2#YOo^pnH!!W&11P4iy29vrWH+OAqm^eHmfPzLcTpzRd_h+58BO zL>v-bnm@&!MT5TXWj6p)<6Jf1wa2laH%y--yRla-Guj+GO1>ok{C0#l8b)|2{HMGQOn>A7cdq+qfvuZIN(M04oL0$!BjY1|1=2q1L zlgv`1yuym(yN}$vKN2czfQ-*)u4}xYBiPaO&w|O&@|$tDaqGHo>*wQ@#^!ak@1*N? z(&Yty+G6Xw>vg9@ybD{(^7M>zkZq+CmoLN&5{MmFpl%U2L=n>XzR&b1kF&3qE~x(6 z;NE{6;dX#ZGa>F3ujY;>FS|NiFsI;m?yb;fno=~K>)BfOXAEszWMz3S)YER*%vo_bs=G;5 ziF5F?bOguhkKsbg2|2R5t$JcYf)gw(0H$+Gu9aBNFP(hNJunT|DNl%GZ>G zV#=fj5b_;{QP-G33q01$K$(pv4+R-!>%h{61f4h(FgwUBV4?LZBd!b+5o(kX5EUaCN+uc}!!rk_z&Lw#{? zs_-Le+8f!=Z>}7YKNQOrDa&g4+9z{-3hxS4R4J0VB)z(vGo0cdyW$X*4p;rID$D$Y zI4yn><4S;8fS5e3G)_?8va8ThB7tDD^Rp!rrt46ut0towfzJoad2|(ug+r$_&9_P! zS1-EO;U2M5VWE`-?Gk8?yk;T;gc3$#-W%?Y{yD2YlM!-L|0;F?lVx* zB5$Y;S0E}yJO9UY%ADp&Nv1MRPk&BUP?a4lGm$T~hegzfd)`oD!5Dtvp}x7$@M^dw z`iH7Ur{KK;4nC5~_$x=>N6>D?q!lIN0=LX`(QXaP2}L~U7JY2#J?&X&&#OY7iV5nG zQ@ZlDBd1L&Lg;+dMhI>=kNfuzq`B%ubJyQ`cYLH$B5S_u)Kz$%YyiyfJKWE;&-4+^e?GOBf%&%zbVRp8=ZN{g9CVXxw3JAb$bPag z!AyI8hnCh<(+X`T=9dq=QK@W_DFQx)+eiF=geLB*g)~3?x$%eT4iTT&ydWguN3Lnr zGR}WllKuib*q?_#JDbhE`D-h>tn5P^+Gjg_vBgw}Tbs$$YG$q6>UGUBUGEM}bIfzN zEkk6sUwnJn_>#0WK)E2wt`1KK`wVB+qHHROl1_0JD*7W;CSm0^Q6Yv>`qc4dP4Q`0 zls?+;Li2?ITg-?&;}$d>=X2+v4` zYXK~A)XjPXhY9d)4Zk-i(|`Rsq!Q4$Kf;Y5ued;=U*PUyA`dK^ z#(@zHj>BZtENeZzeDKlm6eiPQn3 z$yANlALxi>9l&{5QmmT+0Q1?XB)F(XMKMnp6|Cc~L=%Rbk- zy#BK*n`_Fio(fY(!SSPsG+AX>MUNgPWsn4Avsy#;3i5NomV_J5=@X*~dKduct6%-T zKL*WuIIzm{j5FvV1Fkf!iaZ2EMfzBPTm*RZjHB zwB~TXpQlRBYixRNnE!?b;ES@oud=V{#KC%NIQvG(+skad^CO&#dJ_u#lXT{{HHVh` z{UXOGlO?(fTKI6SfG}tYb#>ykjy`%gT0Nt;Z~aW*_wEnSZ+_-)Du`78K3Y!Tev@?^ zwscQ~dsN}5z6`wpKmQK78-s*huwkCZ{TzLIMB0ccjjL@qj9sIY!YwtF;2>s*9D%!i zmCQaWOo5iWHIP(fdVs`&zg!;3_|u-el_N8kHYf;=Sbn82Pr+>x=9z@OtcZnbH8i0l zrh79?7Dm#DgsQ}CXp2L+(4A`#M%IYhvm#`3)OfCVIr(|_Bu*S6PEEraeHqA930IzM%jt@*u5N)D~S(;h_ zv$^y0KleVkr{hm|oD*+Tb(yq01fuNv;B!&x=THrqe{iFt0RS0`7^J}Oq;sK@+!aAm zbp5NfFmSCf&Onsg7XO3LKUaf_(Mk6PK=KuO2z#Sb(a=4DkAs~LHJuDh0e}a%66xN< zy@-~IZ>-bl3lf-RK$SFCWy@K%=$Bn)g%hxH!7s~?NQs*yn=)p;-%Pg5<@92upMZb7 z|F^mR|Mfk-FQ0T+S5WSLYL~fgw>a@i-M7#mzB*xe78jfT%$(I*z56HAk`ixxbE^Ot zMpr!EzMm0P82;`Vx2f&ThzuXsq*Sbv-YHYdx!NV5@95Dz{o-=+t+gN~j#-Rcgvm#p z4IlHkFRK+gy3E$U9ri!BUcY?X_m&o4 z@h>1CC_Y{pG4vbZ-vKykoa*Zv+1NK0yI@$$lhk|J>{#ySksOcAHPmsXpNBEnk?Z`? zloAD<_f>)=AJ!8AEpE5lB+HbTaq1a%<)n;x@%gEervmh>I=w$p4}@VHLb#H@@Ki{t zarM0|ed@AYmy$Qv0_*0u%@;_(b4`j<9(nga8DHD@HT;kt41YJuJHU5D9~!nqWLPBeF} zX(ID^bU(73eq6zhE`u8^+olgWYKh-k%u{?=OHl4xO`Yofz{|cN`%`PxE|i)*IVll z$;!!gVNM@z5#*}8No`7F0RP+nZ1>7BJU9PFh}|~|j}N%H-?Hlfy;9fDU4|zzPU%Xk zdOnwGbAb7}q3xK+uFISWxv#4vCbLg(YyU(y@_9TEF`s-4)c)E7g5DtRBP4Wyx>Z&p z05ZpF{R`YWp+(>U#;z@RdtQQ(81B0UbMr=VR|t>`KHI^a?DL1o%t`ofJb;6v;f$ic zO8^Dn*fHJgjqQIq>kXPCd-RoM&GGSIqVN6jb9t}0D+&y?B>OV93pEOqJ{NDzBjI39 z%GD4u+n7(Eu*@T4D$D_g05~|=EP!0@(S&Gm8J7BubN1Nk;%tcVT`*ZO9-fNIXbvckHM0V-+SW_& zE2*4NwKYCq=Qm1}-aLmVaR4MI4FF=t!p)m%>z%hc_HD=&F8k`{LmK+D9II+Dd(GGP zevbnZP!g?%fcGyCoM+1?9^1ek1-|WUf3Z_^-?9~SDj7{D#D0v`CYF=?s-meC5R)nMRkcL>3J47){=Be zf+fY&UH#poXiu%5VzYL@B?_E|?nJ)apiyodK*W^Zrd-|vByE<9uD~l8yx)8C-kLh+ zDY?mO!XPT&o0lmvcm5JN&jnh2(a0i$a5S#*C5R9u-oP_avO~}S#w@oPH_$u8JG8>z z)H+Zfc~M!St<}!^(+Y52ZVjps@nM)&&54lnFXb&%c?fxgewgSxG@K{guhNm$7?BA1 zxfnG45t))t0wud&qfGAu7ZVF1*F?UO27~r<@+C=h)Z}*#VCXgdv7k`(m<7L(e0xQ2K65Eoi9)0x@lRReOZqd&G_4dN7;q8%WXM zu+eQ~x6hsfu z^6~KSabq$K$N2=Df5m{p?#N!_n>b7~ESuO-j|WDG#Ml!LCbb^3w~tN&`Y}CVm#8i* ziOV0%R}W|jDSkf*^gkDc_b^j8aGm8j8VIgbwm1U#jP|u_@k^2*+;7OqhQDAW%rJx2Gm7uV z?yId23V@{H{p;D|mOst!aY7AxzHWT7n%sKOQVWT^nsJ)87w(U4ZZQc$WbA&(q8y7r z6wPJ!oLp1y4F=|eXDp-C-T;4F=xq?-1!q^2^APaZf8Sig4XrcX<|IBvc^p1t@kx+? zg2TB=evH#@S=e-_L&&j=>P!LHjw$rtN~-)qOFdU!6u-Fub{Lt*c=Ob%H)CHjYuY*A zfsN4}PC7E}Y`JG4;AEx2KHIE zVK~;7;l;RrU9mAT(o$d3LB_&1NX9r8@#jSqF}$&g!5tet1aa%>_x0y`T} zKd=8jBX0iJjw9)5S?CRMZ%J!#PJ|Urs5wq(x#P-ZjC_ts{>SiX!ftoLT=T%=$ik(w{Xyxp6+#)5&$uD5CVLfr=f=vR zLHXM#;geX;KH`pYh)(S~ecw-vgOKdjW*3QdR8q8o`!Al$d5$|&^If?Pvu2oSSI029 zvjf-wcmixvv`s^_v^52eFj>m`)7h664c<}dp=|WF$)U2sFYg0JZ*J?-O-(9smI?V0 z+P8lm$P+WESY|o!7f8?xWJ^d@>!_R^(w=Kyacvu_SW>U3SDv4IZj zu8gmw0Q?P~HA;Yj(i{`Ms*_ni1(R?8+17w5m{LJH7$E^a$o9&I2WXLkp%@DF_Ths+ z5I?%AiU(doI9P7d&Hy1z=KBue=xK1)1p1doVPEe^c-7~lTrdVv{HVuftaKV%&oc&l z3=E7kdiZ7`rjwDk`X+we=wFv-ZsULIFyUJEzPE>b<{#ltKzAyz75@%6SZ{p7!#{ue z%jf#_OSaokL<-q|0%(jamg=iFx3>kg;eV3A552f>26j@V%`bM%=t`@}9KW4B9>HIa z?je9>#5Vmp{^yGC1#~G!EiJ8K^?w~rw&Pa+8Sp&!dL1`00?tBOb;A&>CtsT<5ZwT0cL2U*0uKALE)soyulO`j{gDIffpjj)hHApHM4T9*4BKLs+n~)v&vumlsqW(4lfF&!=#LM*RT>i22ecO z>dL6DdK^HWn4`D%PRR3)#{H6p@Q-{q`}_WXK!O}Ol|+~Zh+CoSO zakxeSh^!iG>>L!@`T=SyK@H{h2%u81ZBhom@RizYT7u=<88{<_rksHAparl}7}62n z;gKzSBofB|6osC(fZn?d7|z1cs0qR{mz%r>z=xcF)dHgCHiw0dRllOFE~4$jD`TMP zsk1$t&Qc0!TaO~}JBfz{e12cF??XY6P9+M-rFQ*&o*O%H-_T&$-fKctVKY8@WCOp!|>=V9t+F&8< zAi>lR0@WskX|Vzg{{S1n01)hL^)Y5TU!9bLJQx?zpoqH_P`9e4*h%9yeN*lPx;z?C z0*OXUaHYs%6hB9pCP90EC1t^9*#2wGV$1f)e-Z6r^Y+VgrRpK`A z_fP1u-ZUJm1ywgpiV$aNlVQ`M@m7W3vX@7%FBv6pKm=S> z8LAsKUjt3JR-J%oG=7{t;?6B78f}ehowWxqnHp>mJMwVMoDvC?x1$f^)8w)W#JQ>7 z0Sps+>7SFx#fmdFtr?rFs$vJr8^nAGsXF63Zmp_YA?Q`=AM=R3-XAr^1ZdB^oPF@H zAOC>&E6iJnF7$u;DQ_^?H1udhpJ-{41c$_>M@@N+$KGHhgMN=p5f;--+d4r`mMbycF-u z!D?s|Amy_y-gBJfw6*IgM+Px{uA)I~Z_r3y>3L~c2bf7Pb(5Ue zk&cN0ffyF>i6|8}>|34Fj-XY!;c%M3p63#ngruR5B#fkm`^&z-<7(hD6hj6sDUS?L zW-(Yz7dv>PKl5U;?-u~zr+6?UYiUV*T?2dkGcfY;TZtO%MdYakr)^ z)^oH!mpzN#Gs4TR&vvSS87KsYqHtRg*=VKNr@sYkN5{c@)gF#J{pH^=G4fUOaYzt; za<>j_K0>mywij&Q4MZf8(a3gMx#*Fbl!DOD`AYgI%$OhqIxJnJr_8+zOsMu|qBEwC zKd`V(yVP-o8dr&t_m_*}n38XyE-Xs6Xi7Kv|CYo}SaTP7wZ)(;^61y1f2+$EQ~f}z z(H%dk#32{A+HX{$-@qsxh5A_3yS9)Mai}Ndg-z=3B{13v1EE-9z{@UpF9V)o$zwSw z1FW4apjo7LdpKJzDR9xRybDiWu@n;TDg*Tqi`la5_aT=bU^l1C)}vr|e7PSDia7de z4Bwu2pv=Conr0dbV`9F8J*8}Ta5qSVfSttrNs*&(;H5)R}&;iDhBIVYs zW^wSokp>VF4T829G)2~q!P~xEuXn($HBVEDD1mnnZUd-7hU`U~qH162W^t9GuEDK` zd+zHmPY4tG0LG zc7~V&tWOQ}ee@=1gwJ8%5>uVY9W&g!#n_52TNU%X_%KkCHT42tpl84&>T>>Se6+*3ekV}9taHIcl(4J{W@{(FAxlY9s&aS$~5u6bvcW{~hm zetXI~z!HY+b=B{=tgg#_)Tcb6HQ$Np=j|awE~R*I#7na%PEpzTDYF4^%!ovJD#sCb zt{7y&rWhG^2W!2ETgGUwW_bw5vtp2Z(_0#lz{Q^?48jc6dvbL-6M>YZ>zV@SoE2dW zyWhT$>u1)Hiqrusr+~J%@vY#X@;#|$Fs1K}p-X9yI}w&r!&s09UqhhG|olGMta#X0FfjIrQ z&|DtQo_4|p5ULBWj1=n7KG@!cFQq<`V_p9W$0s@f9siThQ<2VixSX4(1_Af3%d!fHQtg6D=kKd4>iy5VEDCI1xi%k zJztGDynK=g(uh0>g;k8ylzvr|qQ58*c>LSbxycVCjXaR)7XwvWq|cDCvM+;~V)|eu zDQrsFydKUHKOv3=>LE&sqEM49#E%c;7XxEPMV=uG-+6c-0`?{xLcK8^&@A(hQj3cD*OJc*~k;@z#-#GQN!MD=e8 zA{?+nVwF*|7v*Gp+8hzd9Nd33=FvqiHK?_$-NScPc6 z5^rPOtrxV}%{kN3AYIwfAUFk}(MXBMDUxOSJy-`^S=+?Y&9kP>YN{|+BX;|DLukRgR3G=Iq^^*XVB8k$pA7cmr7&0Ml>0Lgb`}LI*(Fz zOq@Tz8${4A9&+*qqdAeb96TsTzl~})*@0&j{i(=sggj|lzC()l8M8xmDB)UAJLfpAt`NthwV0pqIU{Gm-=NSvk z=j#T@0*V8yMnNmOW%zN?@t+p53`NIuBYAhDY{|Dw#>BIsv)ISfogNYpB(t9S(A))o zn5c?cepbwI;{u7J3OeI+XrUq4nd(W|>EdW_bJa;=kKw-pi@>*bSltfrIk9rI{f%je z6){E=N7U5Xml;B=gU}NL!LCvd^5OiAM=Sbm6?L|HnJ6;|Vh4df3K!+~>#F*pR~{hV<<7PkBfaFxwzeV2a%pB|Xqv46(y6mxvORA?vKZHTCH2G4maz z)=xIYg}x3fTg@NvQ}n8oPxe5%rRCW7j=Ebdof$eutkgm6-?%?}!r38p@0N6H-&(!L zU6|xR8MNEXmvu~rGjK2d7%$nr7L`I2O`RbyFOW>r;Y3C1ddFDiiD6x9ger31oU4r&GW`ifh`;KH_HtKfb`jgAeQ*s|Y(Ab~(8r=bGDJ30K zr&%NDVofF2Qy(C(cB+|h7gnTB^y$+Gr!`WSwA7jGj_I9gYF~RSn2YADbk5zQ#H*Q| z*Ngi%!5!RDQ}?#^dgnT`R1S!t_Dk0vzNL6j$sqAJMcJ1XqbH1jG;glEyDj6JU9V~V zuqZm4r5>X%QB?c{i_u;Sr`&y|AA2x5xyF}Y?VzT!3*I3l#`2YwoEHyU&4ye|d63@H zP+SW74tWQctw!6g#*jFRPI^e~cxtV2HTw_RE| z>-z17c2tN?Kb#3Mb|E*U_{G!OWFT}jMd79yN_E9G@nH2{9-eERWd3)~)ACgi&PI+R z(~U(kdErFG`t;nQjH6~(p1gmBRcD)<+cj&@QV+M)!Bd|++J)f80s>h}MMm{Cqe0rf z+$*b^AOe9BcqLcTkLziXG-s|c23>-JjTNfCBh`vkW_@wkI~KH0iy}xvN=QU6dDMdh zx!a^=Cy?Qa2(xA-2BeC z>#``T;*CZ=xkfEnp|I;2phH$H7AJ2wPZbjT0Nc{qWYJ}?|D=ba$u}|66m_0zO0?fg zMS5NDq35RAc9zm2Y?6SOym+2z)@vARb3o>_v1(H=?A*>#W5apO}8 zL1+8v@Cq;!w(tAzj<1l1ir-*fgKiIp(Qp@u&r(qRawHjFVc%RW!{MS*wiI{UBLZ55 z69H6_v-KLHqXle*no~mlfJ9|EctMYVu0LSclrSkAdQ6-EzXz z{GnU4tJf;>k9+DCPZ2UpG)kF&S* z=bAMv5yRmp&nN~3hxC0%Zw4wK&$r)`xI%Qccd z0$o#)6>g}qDR-K){l-0p&@&-0$j)NuG()$^%oRG-Eei3nxx3|xh&l8QZpeEU^>bRj zVoN}8kx~}!EPSvj(K|!u?M2|&_h4EbSa3u?jm}9M|AgTnSr)AyQyXuJ;;nSJ*H@nJ zZ*xL^cZn>5GG5nka6j(M8vCzr?vkeawwkyUf}5;R7}xRtxBG$B)2t`Ow@NMW-z=@$6icG(l-;!+;r^`Hc5p+1-^GSn zBEie~)uKz1m_G@-AP(2FIbHU48r76f3>2fp@fSHAbT8RnO(jJ0CFhm{ajDnI4yW@frONCsm*Bm_C$^61+5Ydr4t-qI15L1xnNAr%Y?F9sX z{86?C&lLV4jae*FD=PAqc*j*KHR9o7AP(kCIJ)PIj#K3O(5($1<>zQbCG-|)Q_>GD z!8#E#?#8OdI-vy3=1=XlotNN}QDj3pv{U>gIV&g})(7JFr<%lqraZ^BDio zHaqBUi-1+6S`#z%`+%)VP_yd?tEmWR=)1lo9vj2E_RY6W5KS5fU*FG+_ta63X10Ue z)2Vo5lr|mGshm9|QbhogRO%{{WNotAA5HCO!@mU6xw#vPB;t&Kc@cn&Ia#qRrkV1I zhhi1?5m|vtWM?RtAK}qq%#Q^pK-E&_lE=^!%f$Cp$3m_w!DSFSsgbwoBwc)q*r?Fa zOsW1_{w2+u3%Pn=f9C)oj|}bziI|iQfe)h>4)(uAdC=Sdk*AQFMh7heu0QI;#>SxY ze9p=8R40wBHk7*^8TpAm?Q6|i^~KLMkF&0Wy{512f!vMwO6S7GfDCrxSP93NKpz0d zPAFdHiF7>{rSR;j$PsS&14u2roo@fw3P`=)eEJ~9vkWIl_}+`Z-!H>soTb_k_vX;5 z$mMLtLmBV7%ax;hIA9KkgtQ2Xtz~cylHkxQXsZswo1cP;dvSA%o~RaBC!B6k#T zn3IzV3tA#oz}B3*%J_NrS79j$I@A7@>R>@pRqxi7qk~`{>@9RqOVH_&?S9bejhRfS zu#Xz=@SW0%>5}|MJq}MAk##al+CDa~JTcq_jhtir*NfK+2h+xJZynD|P*5?8!jmdY57DnlWnj+;`~z)myC!*VA@!=VMVh~0 z{(KloQfmyI`wv;P!EUf#SDoeNMWP>bLC=5(-Eai;@W46&4_&i?W9i9n{{}|R9Z+vY7icIz( z<@@7nnCFFPbW+4YouyUq-n8xHU@c}0P15e z>qh!Vl6LqY3~+C|JMgoTnfm#sHE*Kma;+p6ILKzVL+cad=Asv|5lnkfHru;X$c^ zfqhafW)z<-R(>R?l19VZKDpHS)JmSy7OWa+zKJF~J+C+E;#=D`zO7L7$0QDz4agEP z7hYC8PI?M&M(z5!-v1oT;V#&s=dPDx?CZZ=HD3QM1z}4XPTb*Wlt6i5Nh5vk_;IdXBC5==qGTIQT!8yC2IAh4m5hYeE0E$-+p+5c5yJrsT1Mw?+F&UF{|>=kFIh zrG|eZ>2J#?XE5Zund`6Y?Nt-UutFVW`X7arAgt!2tl2%6`A0eo&#*#SZtS;zTT7jo z|0ufuCln%nGGLnZ7pfJ3gqD8P-k(Fz~gdCBM(%*_I#h^el-VmFlM$#(Ko#3mfyY8 zKdkD(x$@?0g7ZJ^H~>q^$#4!-CP58%3q`g5FU)Mc14xKyB}1?tHHsLHX1#o4P^?wi zeafZ_aMJXEU=S4k=5_6yoq1*A@0}jeqx7g6P-_V|6GTF;W`1haWM2p4=IBoZW{t-Mg zn)Tqp5xjKR^a-OH9&Nn>MhJ~as8t)hH;@7tU=_*+Xedpxs?A_}iUpTTfejG4#DgLL z(Tj)1Jy8kZ3Vq7kvqXw=# z0}Zp{t83IwCAbTgm+BXG$7ZzQ^B{k{8c{~^oQG=xd|vH_S`p-(Bq0o9O} z-WHk${RAaVqWs#QK5W352h+#AzrD zdi$MRR1l-w58DLnzrOD(2U0(Fa>Q_+MPj!1y&$Y7feNU$FrCa}aC)yvDfoUbQ$b)3 z)sQmoEO@n z#uJb&<6VK;7kBHpaXb|s0=NDY^q{-zxXz(z+XJCw%14CsT#pyc2|$a7-;X&VvO?gn zg(n93+GPc%L0iW<+b-*xonq}%)L73I%37X?wfg8?iypZ=_dc&LQ!2ZVhShC6yb&56 z1Q(x3_WD@kvi*8jy56>6`}lR3&5^gCck%I0sQ`U)2KH#l6aM$&i2zCbaIh}{ zVlebcq*u{%52wkO7EsHkli>oR;Bz`25Pzh6ZcB@t$Z)Z4DBveKGF5Vd`9tK$$!@Xs z?Pa3^JYmtiPwYOVY_wzg*IJPXpenx49>tuQdB}nhLd0Vm5kn^b?KSL6hY|Rb>i=o& zE5oXa)^+Lb?(POb7Tp~Z3JatgQKY*&lx_h*KtiNMS~?^|8YHAUq&v=7?!E81XFq4( zU)Nvin$KD@#vJ1t-&<*Hgn>`oI~a&@8Z^6!BZQpZ&LZTar`=bbZ(V7#ynFmgr|r6R z*(|t<(&p;|ZSab=r(=Q@0LnMSE#UuIVyR=5bVA;-tfcjOGW}eyz z+NKjV(QUrdVH}7{z_`yT4UOF&ymO5`f&~u1LT{Oi`gMaK9@zngzHnS(h$?ND1t9Wq zuDHq34mXDW=qLpY$ik&)#jJOmv%ClJa<| zVl%kjU7zjD0=C2|Aw~DqKRm#en)r>@TmOJWR1seyRxR-tL%vwTCY|tCaGmr1pYb@e z%#LE+dZ{wNfG(@z!$SUmUJrvVmGLe3Rk_oTHE_#!+Bx>{)M^D>$W41$*gvQH0d709!(6hA-BD?n|FUxYBsRw>aM~(~ z?t!3mDQ6JHE=MSni?|f-@UOO@VZN2G%H^QIfa(MKLEAyo?gX9;o!jao-}9HYvAAdr zAg82+k8X?4KtJ@NGOt<$5JXa?x~0MVPrZ0JlAP=;-WhCdb$Pf9Mp zOhRrJ$0F@-UQpR2Wm5ZmZ&&1IdL%V{#2l@jT3a@(W0B_@Q(`q*qGTBTp`N^?kA^)l zg81ORfme_Y7W0gaL4j{<6uR)pXPE4sL!~R^(A*xqe)(-mQg2}1YFFcd)9NT~^_%ph zZkZ}eHH!LRG><l5keyvv*-n72ME@Fd7*R5 zb^_i&iW;9Fa=LnhVzNpK9}T(+4xlK2QuF^21GOdr+2qM#e%NtKop&R#`L%f^{#U`p zufxPBraKJ1eDmhDcGI5@usImF0eWDA`uy4w=bAMVB1kJJHPMa;*y{#|ekR+tJv{xk z^*T%+SrhsB(#vY(;i5m^7?96R5Ks$89AT!}OvHRn-AQ3ULg$zic)LpbaM>qy&-~NWzN@eM zzm;aND^&Hz(Nv95E)pCD_&reDMYkXfdJL;#DVM19+Ltmk<8Jg<^|Y0`xBewg9Z6o* zja};QzHsUCo@C+_ethCguqOdwuW>hxGZJ;J7c4W@e(^qmr7jOvP)8~C*Hd1fi3wN_ zS$|!th=t{TzAUFiXLYKxUQ^xN^cc{co=l`P)JuQa7Z1Cf-w1^Mj|5JN&L(~c>?CEm z*s@k)W|NDpS4)93r)TaWX}ewo;IMApnIEltQfa)@xm^DLQ&IQ7Jv2yvMv6%4vE{p; zAX!k(!_XSAP-wHQ)M1a9Kn_g7I(z`=gu$pVE!{8Km3~rFzx)+SN0nH*MjMu5CR!?#79<~UGbY-DNS zoGIe^u>}YMYe0=mE)~%7CAB*iCdvcz{~BPW=pB@Q8BPN5w<;)3awL*sVbxYNYwi|c zeW`+dLK2^#!<0Hqkv0!-aF}=iCTA0AWnL{z)^tfzw%2O*cm;ejxmc%71HXMq6PKQs zfxZV2_b`d9vOUOqBOp1w1SyRh z7QBCo)1F69YH`!|qafp`Kqc=^b%ko-N8n(DL~ctoOgT+5AA!hh7_SO!C!XoiUS0si z?4a!-VEqEf77e(k0iQm6veDIclFR~veB(G%B~#IQ{o*Sx#APjt%cwys*Y8+mT?*tO zex;s1eYjtINCvjkrpBo4B7k>v>zpa(Sq@m)+_gj|`~1dLvhUA#G= zZ(H#Ldz^Sf+>|un_Yd}8Vaq@?swd$osBEV^npc1i2g|M`KquP?GTQ zj|d?U3)jpvFR~4H=-d(nNKFehc@i32p1UqIstZ8qspxywI+Nz#DCf851t$z z6{P;W>*!kYE||VBJ-eaX8Ba7y?F+raj1MhVHQlQO78r3$ob(oKxF3oG&KC2$Co)EZj^v%Q~&^|pMJy7ejp^y;Khf2!LNG}0rTEvcm9+WUz3coLj zU1y!!zLD*Gt0>FOp9xv2};I1Y9X zBmRtxwDJ`|?SMuD%}_TB?sQ6;LqkUh@wyX2NY+A4P9B~OV|^I z?;_gz)oJe#fzHK9c0Pi0BZri)9Yu_%U5$jzd4Pyb_L~5Q6em&AIjjMk5J_eD#hz+Fw#ILamFBq>H^8#bGE%KIWyB>C_I*2vKuQ`JancKbjxd$EhII| zPnhX}{0E1fwA}}O7oj_3PGPo70qPiwNP(yR<{Oysa=5GEUHzQ=dB2?|)f~4serC-F z0ZNZjm^(}vBl}yIKuOoL!aSoj46=Z>xUNP>;=nec)HD#O2?tte<{T4YS1E-@Hq754 z8YY`pm9W8bu*#o~CijK~>?&Q;RuET6uaHh$VD3pPRI<5v1mr}JLZcw`f|4zMsvs0N zoG!_XPlW8?nS+GZtz!L=hFz81X%pYi*KdjOkRj;-F({iZKikleH|))35R&tp#Vg3C z<9s8bT~3q{yQj%Ym)K`a#2a%Qo@51PJGz+E=aNdDJ}MvzY7 zMTG)ME=MGKWiUmhS)R5+C6yjkSg5y{T~#&r)Cn~m#-Su_%P-Os0kh1g-q|BS$^8`F z+@NRlD7R(wB5qmyZVi7p*fbk)69cINT`u_g9^a!%rJq8*_i^PaSVOe73HFTgqc*M) z;q#H;KXi=}hTR2=hkG>u71ZQ?M&6rzenRzQ1@T>nF3IW)D=M@#QZ&gNQzsLn0+GI0 zJOUc_+bjsX1H)Yw#HW61RJJ4~1sXw&1r-~iCS z>hwO;SgAHeFpdt5FC}y}vBHa48WKXhxd7TYBfk8V*yeIUX2+f_$8RNRH`03y-TDXv zG_o6(r@PUk;RNNYUqCI$_4r1VQ=iVm89C%dK(buvTI>#_X58h~%2&{qW;=;dW_U-w znKfX_K{vj397i^a91RIy`z`-Qr2ngjz#~AyGVj<4zcS6Z2)j7nx_E>yOF#-5Zb?{z zV+R*KUhpjwPoz?bIr%P-<+RDhy2dTM)C8tPSR)d;BVGSijRd3+RKPa?Wb%lA7u+)K zQDv(V@5QP)>nV3zZAKGm{F+IyQCm3`v<;V64+vIvZ2dxD3AOpa+NYTuGNX>khBByr znujB2OoGcXYo9d06ELwhv#o=tNU59V>O`Qk^t9^H0^-A!iU;-gR7mY;F3S)5rH?a5 zzAwIFl*zm$wv*O>1yW}oE`(LSJR!n`U$-6!GC98?w6-fYOd?=`vV zQLVhF=f-%bzsp$It$vD(ua>|=u5_|)DRztK5%I%(R(@^j4}@jzd|g>w^hA00i6?dP zYp6}9$M?3I_>KO)xwwJ*q1(=387`U3tNkc{oaP~_nxBcQo1$AWVr$F17gp?%kT*hT zCpV^F){}GkGFb2-DVhEr0Vc1~Gvy4foK@aIlM+a%GF+Q~&al`{m9x3NF57&`ynHy& zizqOE&>sjXub%jnNTZ9Xnd+9Lj(UL(`#U#hZ4jSE30l9tUaGY?qXKIhR%#H((lFVZuor6icT zNcYo(JcX0Kym;p3r_6SJ?+{7#og<+~Zurd=AMu#=cZcTnX44w0vns`5Jp!EFy|~%b zhfD2^yV78ziINxJYlG1~AV)GGgJm#@)Woa9fD`9-S$QSsGy@PeP5WvYx}~@{t#QHZ z`V1CDQNQ5vZn3i!L?xW5`t8XPBm?@#0DztTfEp2j|HTB`6;KFH9D~N_vxNwJ0v#W) z6bP6vwFj$?WGp?Gy14);3d$cw0DBv@19kzh9%%nJmpf4hgyB8RyNzp~qhB`d|)3}oPxxt5adTRuhu#T|U5DZxI#MjTTZl`g90*a3m ztX&D{q>Wk`et=3U0HVrap^twP30lByBdvJ%jrl3dKl`8kfa;ivjLu@Y-)7l|QY(O@Lf5{|`^4s1BcNLb zy2s(cOct)g6S^fYMTN)E`slHj>Kqpg8(zjR$__A=IKUD?FY}+Lz^^$Qqkx#jXKXG! zAP53hXd0qG15QVka)eBcpMJ5?_==TS3)q-KzesQf4c8iWzk)_<*?vC)7$byqL@))f z4?Wui9`=@XhV=J5grLKYd(aI_f#I>7l`SiK^a6h)7jeE7fTFL}=^IdAmdV1yawB$q zpvarD(0K9VsAJT_Hc*gZMjFGIxg4}VV7<`(Od?cJe1Yc z0(H@I&?*M%l!?j;x+Sx(qY|VeE#9uS>=0VN!{972i?ISFTv(>b7nZRmcL&>kC6G~` zA|3Kf=DAN&brKpXv`<}&T?&YT2dqGp$X9hlLJ1Dzz_cpxN^m&jWNzG_bH*RyAFUzE zJt^@tvsY|Y%t5_Pg^!|=K*gWCIomBplIoTawFJw0WzAZiWM_aO8$7hq-8)m#zlp>1 z@5!c!1&7ijp03Z1D|d;>-zFp=8{EY_QP~Z-gV1%o(cqGXlO+9)lYBv#AB? z7Bf3bum@G3V%bx`i1>I)h)uzrCwQ>TZ$!vJ@>HNopuQM?e8nlpnXqBRn zv+f3Q8woQ`?8m~C1aHW7e>N$K+g(@$rX0TGgL20a8t3o4*0Hy*1qxWn3oNasobLyM z#9H|#a0Z9Kdr(>~G+P#0gS;y+BB!}U*EIO17ra7*>xxTxN@zlF=n*P~KpKnA}*YtjDi7$jQmWSI6K|{RN3x z%lR`{KTx6xQjxiIiYJ=og@iPcUZI&M9JX6l3%!_dnv(w=aP!J`yMb7}m~-Iq0Dk~X zcwCs@_gHZ6@=Ubk{g6Hr-TN+qh$bvOIKiju>)MtnoD!L7L`v!K3yq5Ry-tl+3CKGN zSfgF}xf6QSLp}Vv3|K#;&Sxyct&!IIK2fhIvkN1jZaAWmu<5c{K;9f7emNcw(5i*) zA4pSW*qnF`OPC4SM#v09@Pdo5aQ>K;>hm7gKQFjIQp2Y}3k!`v{FW!ZqFTVo0L7cv z!yw3j#mvVTNc~zyNfXPdV14gbL*XHR%g~y*=q}oU%k+G{K(i|wThJ#8*SONW^YKoI zd?l_~PJ0V30ht6nbki033HXwN?BO6}auN;fa#1@}4F@oGPo73%o6~W*-R@4U&ke~m z;z5+fPh0sj2ar-}Faq-iaNiR2a;RBwgo}{&t&);!T?pO<=YI6&;j(;(vfIEyjpI}L zF_3NuLxXn}5{CFmPvxMpR)+ai){}*;7^Bc!Ob#`{G{EwI*0*!oTSG!89c%j5m)Zh_ zB>$)6jrv_yz`;pY-qHG+1?>R@SsC%AundLy3LlHo2gVR{g_BQw2W~=<)Y^(}qRSa} z5ln+(8J@w%`y}X5(_r;ktQ4ZiI719$-ieg{=IwchROL9u3S=;JTu@54%Y44B4uKuf zLQV>^Ta+@nZ%D@#22zbO1WuSkdXf6_Zt1bY!d=3vWU73)$=OH| zP`i}d7scP2wIjv#s<3(pnkBJERGGQ-h$B30xyIKQ&VY+mvJryzK88#DNb5Zrzv~WY zmLpPRUK6;QymC~4ZEYGJI)J)}eIlyt>$x1C=5!od5v0v8$AtQ+MA=NX=sDj*Qp(&h z&OoEoAZa^aZh+{>+X`B~Y-Ief=+cc(#Og!WDwb2`c)}2pC+l=vSg8wMt8c^IwfTme zs@_cVv|j_Fx#}cZ7sC_3?lMO?vc$SXlj3;|0UTs5?%Cx;u@>B-Lg{&Fk%Gi7OaJTs zEM-30Kn2KU_?33(;fS0-PMa!v#h&_#(eTW`-g~!!w7tgl4SLRT=`z z*s0lLX0$daW@gL<2K#TOn>}9(;Y1(3ASz25YxVcF?JrIWuHy*DqzUX%BVaSzHIAdoQOlrVad{bl z9<9!4ak^leY|G9Ui9_v@b}RMq4XcJAANS6Y&b|{aQ|s0h&3!wb3YU5xlZzQQnr%g- zen&EYFjo&5k4r2W;YAf8-+MdE2oYhFKlU|LNQ9!%SSOtUT-V>pE3+lONX}*3$<>`HbdOmKg&bunk zHt2NV>XYfh=tQT*_Z|fZb9wd5f3swKJT3x{rGyuND@qvW_Mf_>&`(1F0MJfSi|9jw;X6JYcT(Z6->) zI%|rMW_di#1Zjz!nYm(4un(p)McHsy^HUbh?2eIRl_CH&7yQd+>LE=E&+YLa%ZJ_m^yxFe$(P!%pfe3fXtgqht1xeLj zO@Av#KZ95>6mXipI#A4(KUtu^lOPF0EN=5HltFyeWcC4hF&3!*U*olxP$i*@3vJvh z#$CO7=d|2?{r&I)O>)XTC)g#!8Y=nnhk`%yx zHmoQt7kREd#F(|Xxj)MF2{MWkmNe1-BySj--2s0om^ z=Ljbi)fdR{E^wK`yd=tAGKLfGS}KX}au$AVyC&*tsmkuaHQ!bweNDz19IcQO@$BotXtmTuz#kU-~EXk&PiZ`RLk8nU5zWt}# z?vkN82|ig^+Rt*uFK>XbQ>o1rF-_2QMVxgiU9zb<78y@~%p_z|5qI0NBn*j_#69aC z=RJ)_r{snlCzCjvlPdXBioGHl)a2iMZL$}5M|XUIAKm?oaNd^I1vP4%U;A=3)st8B z1QVfJ;HQyvGp^i#;Ar^wvmG<{uj&^*o>Pl^IpNcX`QZer$AtyfJSktyOGXNn)9h?tLKlXtnPHrV($ooriKI#L5SP zkWh~7Fy5J6s*yq`Al11{oXnrcwLJLBV{1YM!i0Sz$3^J+fN(lD542&!H;f=H&B*b- z$u)??!mLw-1k_&d<7j>>kR!k}ux+sWsGMn@<)9X0KRnsRypi!39XF6=KdC+Xj43n9 zI_G1gr?!Vygjqh$^aoYH!kJXfL={x8KQcf%JrUMkUe0Cf@UkQ!i(yW{rRd~M&hZTG z?sx3ZWrNj5edBZz8ikuDb45PuPstbepY{)Pit>hB7Q6VwfSy8?_>FT!i>DG}sXn9e zF(%bdGA(9ftE2SD^|(kcDU4 z*L!-U`Vz*yMgcKa)k9%S65I-{cS6r29u}Vn?Djq?-2KI>s`qBRsLa^L6t$R z2a;|UuMIYSk4f{qcq(Ky`+v}@d9DJUQg%;|GIj%zYWoZh{fhEdu0!BJLF|jqpsXCM zJ4ymsuzi{QXK#Qt4ZC()Mpl-JLGIhlbgxdEO%u1YUqCfnYG+#;gelOtN)0$+hPlgH zLC+U8K06E$PG|Edt5~>T9@YT=a~PhRvG0s@({Gb9apqpxb*GhYCEp*g$cyPbS-`gA+d* z2kjlya8jK^uWInk7j*_kVcKsxw#>bG{Ndqm<#7y)sl;Bb1lM^aZ=ux>{i{WnQq*qV z76NPA{eSUafPGKF5E70gysXmSKb!vgBq{y%B|KTxx-1uEjQ&U5W!Vt_91p~&ggztd0$b??1Qxrph=LpywJTQmV^;q6kr@9nsm`UpUfb0H$9T>(& z=V%gm=WfvI*O(2%Nr9gS`+L|RvYKyjCK3iG15i`tq%WY`0fY3I=Va#$>Z`Dc)c zIRNyo)U=D$PI$_PeY{)1v4~=$X+7=vga=g{P&uv_^WX7vMOZ!(5TF7cv+Mwq2xH>M zV?{*4(&8P&U~>GZnZtoAahl+hsRyV?6S2}~Yl}Hzo*Zqj=IYo3Tj+?&q1Cd0SH=Ol zaILey%bsy=1AXhVGoAowwCD~V1|Id0rhcaYIPxs;lx6Z zMEsEGR$$GQ4jMfs063=m3+r*hOeM~b_b)&zi#<@6X#u2)3iw?fcCNMq@OgrF$^pp6 zy^Jmn7BCfXJ_DyxC_uB7lWLq-6=B^d0#Q7Yf4Fq`0b9Rvs!EoB3~weD&1(d1~1P(Qf1$OQhb96s}q;bBAU(KKkMnH6go*XZ(}BYeBa*k{>5Y& zdu-x#i4pyr0Rt0=FDC9^;H+uNUlSr@1@BGG+}%GS!9R%vXEXyW_a}JTa+u(4V5&Ok zmYauzy0)-6f;RXY|HpSLmr3`J&{hBA1tv|AA3HJqQ57d11{C>k@8^q+~ZniM% ztY7qSN;OL+RQkkF-TXcey<}deZ5EMf(i1l*To2rL*Y~!`@=egP*9=}o#9qkVRA_CK zEA&uW^vTPmWoMnqlmKZbt+3-KKp)oL*iRz!I>s%|IhWD8kN1J#$|XnmZ z#!7#*0!S!h6~ zmy1qa*x}}krb&l+?a}n2u1bWeA; zl)%%ZBOCrv#;_e1CpAIy513eq_0*NW0PmpEeTuN){lmV15+djF=A4F9=ZUaYbum?bzNcWci-2lJFR5`ZFDKJwpHH+wg|cvFzf3%7_-nL83d0T0>1=o zFRZjg94F`^AnAjQ4`GMnwf>z3u*R5tPNz&r3m!8n@@=(#wPR~Q`^*JLnG5fa@}t`w z!5+~x_<(B1kEGdcmI-wm{4kCAAcSPQY+Qd6xt#G0EX~b&FJ3(KkTCcC=H=Mki0I&e zn4$Q>NxZ?-j%eE1ucBf2=+I`Yrg4Shf?>+TE{`C=P7r9;XHI@kkz!0;@tbrz+B%2T ziRzqPf8FS0UwZKRbyiOA&ET`FcX{>`_E=RFEp59=OMEyQi-}L-{}EI zfYLp{4^=DH%qaw&t)#?6?HOOC*VqFsAf+8X9>_Fpb4#hF%xR`2M5sJ>Ki3Zc7pn@Lb2f*gjd0 zw@j>1UW646d{xxDvrNX{eB8f20MrKJMr=E8J(9z7I1QM%9y2%zifr$}Ein$fJF5Xs zLF=fPxaHC?A=r(jX^L+cCMNtbNWO#YA*vzx92K7Ok3-0me*%U)`ydTfxo{nv_7r8% zEj~A}Zb|`^BoPP61XdLMiuR) zWt0BCNA^M1i|PZ1ae^WX9;Ho}GcABqWR`ESHR5R`*1)>?;ws1UcOtL{D_PgV zqLnnlHUK@Q!kI%dc3;DKN3dK=|B`2ntd$KF24G~Lk`;*aE9*F6)shoRVd9tZ0o$Q( zsuNi}M!`f_QIuG=nNB#GfUeSwcRDrN+&ito?@_t=YaTE)23$g8aIq|^=PC4T80P-{Jp^Nb1HdJOi9NlbL0iUszKHZ;{+W+~(j9V?`uj zTVM+$f&5&r2n=)*^3S#Aj*9Ey=vHJON07vNv3)|n&)e-KZ1Xe8s^Vf1Z<#ATwZbd- z+sC_rVN6dItY{tq-WWOXYBG!@#wA2Q8(};~$d*b_sx<{9#3F$0?MiFalei+B%N%(&Cu)pxcj>?*>?`ZK}C3yk^H^G)0HA#|tm@vlqr% zZgL(Ph6zHW8c!XDh}Wc9SZ)m4?-h}ZcNAO-7UH#~4|GMTv$6`GRgxFFH-F_YkN5A{ z6uh(9_;G>wIwNx-hxul&<>Z~Gr>$SNjh|mjfYwUz#3H7%q~Wgl^zOm#QTq-mPjh2I z_wdV!Hl>#S&DA+0mjDZk53Mf)0$L@B_%PY*G`Vyi+}X}`QvBYs%csue}8qu zi`-XOI z$Cl?EM-kZ!Q`afcNXDiSuz>?!VF(G1K(InEgwgpH?sL9v0pgAftt(H*Vr@4^@t;57FfILz>fHNPCGd zQN406jhOy?{$2qSFU&^jq6IlS(hxaYX71OWRlUMsLZHb7V%?WdwKKmKvg#z4aNjK> zhB?ik811Fvv=RL1!*j~o3orRy&3I4wmK1q;2Ab{@ue`4Gs`uk+3kU(Ll*lnLEBD=9_-Z_x%%yTxxRAx? z?Y|BKvqmYwH`+Ge?o@j|^Iyr4M$}wrx^rbOc13}M3$7_yCSB$(G_G53>o;q6_Nym{ z3%cuBRrKt9JGfOuahq}{Nby#&VD$XSu1Ui-k{tX07%TtVS=0X=S}#RL7q_-bA|fM& z1Oz^uxj!t3g0WUd6sw@| literal 0 HcmV?d00001 diff --git a/en/device-dev/device-test/smartperf-host.md b/en/device-dev/device-test/smartperf-host.md new file mode 100644 index 0000000000..ec92a1ba4c --- /dev/null +++ b/en/device-dev/device-test/smartperf-host.md @@ -0,0 +1,83 @@ +# Smartperf-Host +## Overview +Smartperf-Host is an intuitive performance and power optimization tool that offers in-depth data mining and fine-grained data visualization. In this tool, you can gain visibility into a multitude of metrics in terms of CPU scheduling, frequency, process and thread time slices, heap memory, frame rate, and more, in swimlanes. Better yet, you can analyze the collected data intuitively on the GUI. +## Architecture +![System Architecture](figures/smartperf_frame.png) + +Smartperf-Host consists of the device end and PC end, which exchange data with each other based on gRPC – a high-performance remote procedure call (RPC) framework. + +The device end consists of modules such as Native Hook (application-embedded component), hiprofiler_command (command-line tool), hiprofilerd (performance profiler service), a set of performance profiler plug-ins, and some system tools and kernels. The device end provides the plug-in extension capability by exposing plug-in interfaces for external systems. By drawing on this capability, you can integrate custom plug-ins into the framework. For details about the preset plug-ins, see [Performance Profiler Component](https://gitee.com/openharmony/developtools_profiler). + +The PC end is accessible from the Smartperf-Host website. It consists of modules such as Trace Streamer, SQLite, HDC device management, data import, UI drawing, and data analysis. +## Project Directory +``` +/smartperf_host +├── host # Smartperf-Host related code +│ ├── doc # Smartperf-Host documentation +│ ├── ide # Smartperf-Host IDE module +│ │ └── src # Profiler module +│ │ │ ├── base-ui # Basic components +│ │ │ └── Trace # Service logic +│ ├── trace_streamer # Trace Streamer module +│ │ ├── base # Basic functionality +│ │ ├── cfg # Configuration +│ │ ├── filter # Filter +│ │ ├── include # Header files +│ │ ├── multi_platform # Platform adaptation +│ │ ├── parser # Parsing service logic +│ │ │ ├── bytrace_parser # byTrace service logic +│ │ │ └── htrace_parser # hTrace service logic +│ │ ├── table # Table structure +│ │ ├── trace_data # Trace structure +│ │ ├── trace_streamer # Trace Streamer structure +│ │ │ └── kits # JS APIs and native APIs +``` +## Function Description +- Loading Trace Files on Web Pages + + Load local trace files (such as htrace and ftrace) and display the data in swimlanes. For details, see [Loading Trace Files on Web Pages](https://gitee.com/openharmony-sig/developtools_smartperf_host/blob/master/ide/src/doc/md/quickstart_systemtrace.md). +- Capturing Traces Online + + Use Smartperf_Host to capture traces online, with the content, duration, and save path all customizable. For details, see [Capturing Traces on Web Pages](https://gitee.com/openharmony-sig/developtools_smartperf_host/blob/master/ide/src/doc/md/quickstart_web_record.md). +- Capturing Traces on a Device + + Capture traces on the target device, with the content, duration, and save path all customizable. For details, see [Capturing Traces from a Device](https://gitee.com/openharmony-sig/developtools_smartperf_host/blob/master/ide/src/doc/md/quickstart_device_record.md). +- Using Ability Monitor + + With Ability Monitor in Smartperf_Host, you can learn the CPU, memory, disk I/O, and network usage of your application. For details, see [Ability Monitor Usage](https://gitee.com/openharmony-sig/developtools_smartperf_host/blob/master/ide/src/doc/md/quickstart_ability_monitor.md). +- Using Native Memory + + With Native Memory in Smartperf_Host, you can track the allocation and release of your application's native memory (specific to C and C++). For details, see [Native Memory Usage](https://gitee.com/openharmony-sig/developtools_smartperf_host/blob/master/ide/src/doc/md/quickstart_native_memory.md). +- Using Hiperf + + With Hiperf in Smartperf_Host, you can view the CPU usage of your application and the call stack. For details, see [Hiperf Usage](https://gitee.com/openharmony-sig/developtools_smartperf_host/blob/master/ide/src/doc/md/quickstart_hiperf.md). +- Using HiSystemEvent + + With HiSystemEvent in Smartperf_Host, you can inspect the power consumption of each category (CPU, network, and location, and more) of your application, resource application and usage records (WorkScheduler, Runninglock, Alarm, and Location Request), power consumption exceptions, and system states associated with the power consumption (battery level and screen status). For details, see [HiSystemEvent Usage](https://gitee.com/openharmony-sig/developtools_smartperf_host/blob/master/ide/src/doc/md/quickstart_hisystemevent.md). +- Collecting FileSystem Records + + In Smartperf_Host, you can find out the system invoking information and read/write invoking times of all file systems. For details, see [Usage of FileSystem Recording](https://gitee.com/openharmony-sig/developtools_smartperf_host/blob/master/ide/src/doc/md/quickstart_filesystem.md). +- Collecting Page Fault Records + + In Smartperf_Host, you can collect page fault records, covering various aspects such as start time, duration, triggering process, triggering thread, event type, memory address, and memory size of page memory events. For details, see [Usage of Page Fault Recording](https://gitee.com/openharmony-sig/developtools_smartperf_host/blob/master/ide/src/doc/md/quickstart_page_fault.md). +- Collecting BIO Records + + In Smartperf_Host, you can collect I/O operation records, which provide the following information: start time, total latency, process, average latency of every 4 KB data, thread, operation (write data, page swap-in, and metadata), access traffic, path, block number, priority, and backtrace call stack. For details, see [Usage of BIO Latency Recording](https://gitee.com/openharmony-sig/developtools_smartperf_host/blob/master/ide/src/doc/md/quickstart_bio.md). +- Collecting Smaps Records + + In Smartperf_Host, you can collect the smaps data (type, Pss, Rss, Vss, and more) on a process-by-process basis. The data source is **/proc/$pid/smaps**. For details, see [Smaps Usage](https://gitee.com/openharmony-sig/developtools_smartperf_host/blob/master/ide/src/doc/md/quickstart_smaps.md). +- Using SQL Analysis and Metrics + + You can use Query (SQL) and Metrics features to quickly locate the trace data. For details, see [SQL Analysis and Metrics Usage](https://gitee.com/openharmony-sig/developtools_smartperf_host/blob/master/ide/src/doc/md/quickstart_sql_metrics.md). +## Compilation Guidance +Project compilation includes Trace Streamer compilation and Smartperf-Host compilation and deployment. +### Prerequisites +- C++ version: 11 or later +- Node.js version: 16.15.1 or later +- npm version: 8.13.2 or later +- TypeScript version: 4.2.3 or later +- Go version: 1.13.8 or later +### Compiling Trace Streamer +To set up the Smartperf_Host website, you need to compile the WASM version of Trace Streamer for the web page to parse the original trace data. For details about the compilation process, see [Compiling Trace Streamer](https://gitee.com/openharmony-sig/developtools_smartperf_host/blob/master/trace_streamer/doc/compile_trace_streamer.md). +### Compiling and Deploying Smartperf-Host +For details about the compilation and deployment process, see [SmartPerf Compilation and Deployment Guide](https://gitee.com/openharmony-sig/developtools_smartperf_host/blob/master/ide/README_zh.md)). After successful deployment, you can start to use Smartperf_Host by visiting **https://[*IP address of the device where SmartPerf is deployed*]:9000/application/**. -- GitLab