From 9134bc1ec2b659f2b47b0824730679f5b2cda79c Mon Sep 17 00:00:00 2001 From: Tom Kerkhove Date: Thu, 30 Apr 2020 10:17:55 +0200 Subject: [PATCH] Improve documentation (#103) --- .../making-telemetry-more-powerful.md | 60 +++++ .../writing-different-telemetry-types.md | 230 ++++-------------- docs/index.md | 1 + docs/media/multi-dimensional-metrics.png | Bin 0 -> 59191 bytes docs/media/single-dimensional-metric.png | Bin 0 -> 20867 bytes 5 files changed, 115 insertions(+), 176 deletions(-) create mode 100644 docs/features/making-telemetry-more-powerful.md create mode 100644 docs/media/multi-dimensional-metrics.png create mode 100644 docs/media/single-dimensional-metric.png diff --git a/docs/features/making-telemetry-more-powerful.md b/docs/features/making-telemetry-more-powerful.md new file mode 100644 index 00000000..0a1d9acb --- /dev/null +++ b/docs/features/making-telemetry-more-powerful.md @@ -0,0 +1,60 @@ +--- +title: "Making telemetry more powerful" +layout: default +--- + +# Making telemetry more powerful + +## Providing contextual information + +In order to make telemetry more powerful we **highly recommend providing contextual information around what the situation is of your application**. That's why every telemetry type that you can write, allows you to provide context in the form of a dictionary. + +```csharp +// Provide context around event +var telemetryContext = new Dictionary +{ + {"Customer", "Arcus"}, + {"OrderId", "ABC"}, +}; + +logger.LogEvent("Order Created", telemetryContext); +// Output: "Events Order Created (Context: [Customer, Arcus], [OrderId, ABC])" +``` + +By doing so, you'll be able to interact more efficient with your logs by filtering, searching, ... on it. + +We support this for all [telemetry types that you can write](/features/writing-different-telemetry-types). + +### Seeing the power in action + +Let's use an example - When measuring a metric you get an understanding of the count, in our case the number of orders received: + +```csharp +logger.LogMetric("Orders Received", 133); +// Log output: "Metric Orders Received: 133 (Context: )" +``` + +If we output this to Azure Application Insights as a metric similar to our example: +![Single-dimension Metric](./../media/single-dimensional-metric.png) + +However, you can very easily provide additional context, allowing you to get an understanding of the number of orders received and annotate it with the vendor information. + +```csharp +var telemetryContext = new Dictionary +{ + { "Customer", "Contoso"}, +}; + +logger.LogMetric("Orders Received", 133, telemetryContext); +// Log output: "Metric Orders Received: 133 (Context: [Customer, Contoso])" +``` + +The outputted telemetry will contain that information and depending on the sink that you are using it's even going to be more powerful. + +For example, when using Azure Application Insights your metric will evolve from a single-dimensional metric to multi-dimensional metrics allowing you to get the total number of orders, get the number of orders per vendor or filter the metric to one specific vendor. + +Here we are using our multi-dimensional metric and splitting it per customer to get more detailed insights: + +![Multi-dimension Metric](./../media/single-dimensional-metric.png) + +[← back](/) diff --git a/docs/features/writing-different-telemetry-types.md b/docs/features/writing-different-telemetry-types.md index 3aec773b..c431b596 100644 --- a/docs/features/writing-different-telemetry-types.md +++ b/docs/features/writing-different-telemetry-types.md @@ -16,6 +16,10 @@ We provide the capability to track the following telemetry types on top of ILogg For most optimal output, we recommend using our [Azure Application Insights sink](/features/sinks/azure-application-insights). +**We highly encourage to provide contextual information to all your telemetry** to make it more powerful and support this for all telemetry types. + +> :bulb: For sake of simplicity we have not included how to track contextual information, for more information see [our documentation](/features/making-telemetry-more-powerful). + ## Installation This feature requires to install our NuGet package @@ -36,6 +40,8 @@ We provide support for the following dependencies: - [HTTP](#measuring-http-dependencies) - [SQL](#measuring-sql-dependencies) +Since measuring dependencies can add some noise in your code, we've introduced `DependencyMeasurement` to make it simpler. ([docs](#making-it-easier-to-measure-dependencies)) + ### Measuring Azure Service Bus dependencies We allow you to measure Azure Service Bus dependencies for both queues & topics. @@ -43,35 +49,14 @@ We allow you to measure Azure Service Bus dependencies for both queues & topics. Here is how you can report an Azure Service Bus Queue dependency: ```csharp -var telemetryContext = new Dictionary -{ - { "Namespace", "azure.servicebus.namespace" } -}; - var durationMeasurement = new Stopwatch(); // Start measuring durationMeasurement.Start(); var startTime = DateTimeOffset.UtcNow; -_logger.LogServiceBusQueueDependency(queueName: "ordersqueue", isSuccessful: true, startTime, durationMeasurement.Elapsed, telemetryContext); -// Output: "Dependency Azure Service Bus Queue named ordersqueue in 00:00:00.2521801 at 03/23/2020 09:56:31 +00:00 (Successful: True - Context: [Namespace, azure.servicebus.namespace])" -``` - -Or alternatively one can use our `DependencyMeasurement` model to manage the timing for you: - -```csharp -var telemetryContext = new Dictionary -{ - { "Namespace", "azure.servicebus.namespace" } -}; - -// Start measuring -using (var measurement = DependencyMeasurement.Start()) -{ - _logger.LogServiceBusQueueDependency(queueName: "ordersqueue", isSuccessful: true, measurement, telemetryContext); - // Output: "Dependency Azure Service Bus Queue named ordersqueue in 00:00:00.2521801 at 03/23/2020 09:56:31 +00:00 (Successful: True - Context: [Namespace, azure.servicebus.namespace])" -} +_logger.LogServiceBusQueueDependency(queueName: "ordersqueue", isSuccessful: true, startTime, durationMeasurement.Elapsed); +// Output: "Dependency Azure Service Bus Queue named ordersqueue in 00:00:00.2521801 at 03/23/2020 09:56:31 +00:00 (Successful: True - Context: )" ``` Note that we have an `LogServiceBusTopicDependency` to log dependency logs for an Azure Service Bus Topic and an `LogServiceBusDependency` to log Azure Service Bus logs where the entity type is not known. @@ -83,37 +68,14 @@ We allow you to measure Azure Table Storage dependencies. Here is how you can report a dependency call: ```csharp -var telemetryContext = new Dictionary -{ - { "Tenant", "Contoso" }, - { "Order", "ABC" } -}; - var durationMeasurement = new Stopwatch(); // Start measuring durationMeasurement.Start(); var startTime = DateTimeOffset.UtcNow; -_logger.LogTableStorageDependency(accountName: "orderAccount", tableName: "orders", isSuccessful: true, startTime, durationMeasurement.Elapsed, telemetryContext); -// Output: "Dependency Azure Table Storage orders named orderAccount in 00:00:00.2521801 at 03/23/2020 09:56:31 +00:00 (Successful: True - Context: [Tenant, Contoso], [Order, ABC])" -``` - -Or alternatively one can use our `DependencyMeasurement` model to manage the timing for you: - -```csharp -var telemetryContext = new Dictionary -{ - { "Tenant", "Contoso" }, - { "Order", "ABC" } -}; - -// Start measuring -using (var measurement = DependencyMeasurement.Start()) -{ - _logger.LogTableStorageDependency(accountName: "orderAccount", tableName: "orders", isSuccessful: true, measurement, telemetryContext); - // Output: "Dependency Azure Table Storage orders named orderAccount in 00:00:00.2521801 at 03/23/2020 09:56:31 +00:00 (Successful: True - Context: [Tenant, Contoso], [Order, ABC])" -} +_logger.LogTableStorageDependency(accountName: "orderAccount", tableName: "orders", isSuccessful: true, startTime, durationMeasurement.Elapsed); +// Output: "Dependency Azure Table Storage orders named orderAccount in 00:00:00.2521801 at 03/23/2020 09:56:31 +00:00 (Successful: True - Context: )" ``` ### Measuring HTTP dependencies @@ -121,11 +83,6 @@ using (var measurement = DependencyMeasurement.Start()) Here is how you can report a HTTP dependency: ```csharp -var telemetryContext = new Dictionary -{ - { "Tenant", "Contoso"}, -}; - var durationMeasurement = new Stopwatch(); // Create request @@ -140,34 +97,8 @@ var startTime = DateTimeOffset.UtcNow; // Send request to dependant service var response = await httpClient.SendAsync(request); -_logger.LogHttpDependency(request, response.StatusCode, startTime, durationMeasurement.Elapsed, telemetryContext); -// Output: "HTTP Dependency requestbin.net for POST /r/ujxglouj completed with 200 in 00:00:00.2521801 at 03/23/2020 09:56:31 +00:00 (Successful: True - Context: [Tenant, Contoso])" -``` - - -Or alternatively one can use our `DependencyMeasurement` model to manage the timing for you: - -```csharp -var telemetryContext = new Dictionary -{ - { "Tenant", "Contoso"}, -}; - -// Create request -var request = new HttpRequestMessage(HttpMethod.Post, "http://requestbin.net/r/ujxglouj") -{ - Content = new StringContent("{\"message\":\"Hello World!\"") -}; - -// Start measuring -using (var measurement = DependencyMeasurement.Start()) -{ - // Send request to dependant service - var response = await httpClient.SendAsync(request); - - _logger.LogHttpDependency(request, response.StatusCode, measurement, telemetryContext); - // Output: "HTTP Dependency requestbin.net for POST /r/ujxglouj completed with 200 in 00:00:00.2521801 at 03/23/2020 09:56:31 +00:00 (Successful: True - Context: [Tenant, Contoso])" -} +_logger.LogHttpDependency(request, response.StatusCode, startTime, durationMeasurement.Elapsed); +// Output: "HTTP Dependency requestbin.net for POST /r/ujxglouj completed with 200 in 00:00:00.2521801 at 03/23/2020 09:56:31 +00:00 (Successful: True - Context: )" ``` ### Measuring SQL dependencies @@ -175,12 +106,6 @@ using (var measurement = DependencyMeasurement.Start()) Here is how you can report a SQL dependency: ```csharp -var telemetryContext = new Dictionary -{ - { "Catalog", "Products"}, - { "Tenant", "Contoso"}, -}; - var durationMeasurement = new Stopwatch(); // Start measuring @@ -190,47 +115,25 @@ durationMeasurement.Start(); // Interact with database var products = await _repository.GetProducts(); -_logger.LogSqlDependency("sample-server", "sample-database", "my-table", "get-products", isSuccessful: true, startTime: startTime, duration: durationMeasurement.Elapsed, context: telemetryContext); -// Output: "SQL Dependency sample-server for sample-database/my-table for operation get-products in 00:00:01.2396312 at 03/23/2020 09:32:02 +00:00 (Successful: True - Context: [Catalog, Products], [Tenant, Contoso])" +_logger.LogSqlDependency("sample-server", "sample-database", "my-table", "get-products", isSuccessful: true, startTime: startTime, duration: durationMeasurement.Elapsed); +// Output: "SQL Dependency sample-server for sample-database/my-table for operation get-products in 00:00:01.2396312 at 03/23/2020 09:32:02 +00:00 (Successful: True - Context: )" ``` -Or alternatively, one can use our `DependencyMeasurement` model to manage the timing for you: - -```csharp -var telemetryContext = new Dictionary -{ - { "Catalog", "Products"}, - { "Tenant", "Contoso"}, -}; -// Start measuring -using (var measurement = DependencyMeasurement.Start("get-products")) -{ - // Interact with database - var products = await _repository.GetProducts(); - - _logger.LogSqlDependency("sample-server", "sample-database", "my-table", "get-products", isSuccessful: true, measurement: measurement, context: telemetryContext); - // Output: "SQL Dependency sample-server for sample-database/my-table for operation get-products in 00:00:01.2396312 at 03/23/2020 09:32:02 +00:00 (Successful: True - Context: [Catalog, Products], [Tenant, Contoso])" -} -``` Or alternatively, when one already got the SQL connection string, you can use the overload that takes this directly: ```csharp string connectionString = "Server=sample-server;Database=sample-database;User=admin;Password=123"; -var telemetryContext = new Dictionary -{ - { "Catalog", "Products"}, - { "Tenant", "Contoso"}, -}; +var durationMeasurement = new Stopwatch(); // Start measuring -using (var measurement = DependencyMeasurement.Start("get-products")) -{ - // Interact with database - var products = await _repository.GetProducts(); - - _logger.LogSqlDependency(connectionString, "my-table", "get-products", isSuccessful: true, measurement: measurement, context: telemetryContext); - // Output: "SQL Dependency sample-server for sample-database/my-table for operation get-products in 00:00:01.2396312 at 03/23/2020 09:32:02 +00:00 (Successful: True - Context: [Catalog, Products], [Tenant, Contoso])" -} +var startTime = DateTimeOffset.UtcNow; +durationMeasurement.Start(); + +// Interact with database +var products = await _repository.GetProducts(); + +_logger.LogSqlDependency(connectionString, "my-table", "get-products", isSuccessful: true, measurement: measurement); +// Output: "SQL Dependency sample-server for sample-database/my-table for operation get-products in 00:00:01.2396312 at 03/23/2020 09:32:02 +00:00 (Successful: True - Context: )" ``` ### Measuring custom dependencies @@ -238,11 +141,7 @@ using (var measurement = DependencyMeasurement.Start("get-products")) Here is how you can areport a custom depenency: ```csharp -var telemetryContext = new Dictionary -{ - { "Subject", "Your order is being processed!" }, - { "OrderId", "ABC" } -}; +var durationMeasurement = new Stopwatch(); // Start measuring var startTime = DateTimeOffset.UtcNow; @@ -251,27 +150,41 @@ durationMeasurement.Start(); string dependencyName = "SendGrid"; object dependencyData = "http://my.sendgrid.uri/" -_logger.LogDependency("SendGrid", dependencyData, isSuccessful: true, startTime: startTime, duration: durationMeasurement.Elapsed, context: telemetryContext); -// Output: "Dependency SendGrid http://my.sendgrid.uri/ in 00:00:01.2396312 at 03/23/2020 09:32:02 +00:00 (Successful: True - Context: [Subject, Your order is being processed!], [OrderId, ABC])" +_logger.LogDependency("SendGrid", dependencyData, isSuccessful: true, startTime: startTime, duration: durationMeasurement.Elapsed); +// Output: "Dependency SendGrid http://my.sendgrid.uri/ in 00:00:01.2396312 at 03/23/2020 09:32:02 +00:00 (Successful: True - Context: )" ``` -Or alternatively, one can use our `DependencyMeasurement` model to manage the timing for you: +### Making it easier to measure dependencies + +Measuring dependencies means you need to keep track of how long the action took and when it started. + +Here's a small example: ```csharp -var telemetryContext = new Dictionary -{ - { "Subject", "Your order is being processed!" }, - { "OrderId", "ABC" } -}; +var durationMeasurement = new Stopwatch(); +var startTime = DateTimeOffset.UtcNow; +durationMeasurement.Start(); + +// Do action + +/// Track dependency +string dependencyName = "SendGrid"; +object dependencyData = "http://my.sendgrid.uri/" +_logger.LogDependency("SendGrid", dependencyData, isSuccessful: true, startTime: startTime, duration: durationMeasurement.Elapsed, context: telemetryContext); +``` +However, by using `DependencyMeasurement.Start()` we take care of the measuring aspect: + +```csharp // Start measuring using (var measurement = DependencyMeasurement.Start()) { + // Do Action + + // Track dependency string dependencyName = "SendGrid"; object dependencyData = "http://my.sendgrid.uri/" - - _logger.LogDependency("SendGrid", dependencyData, isSuccessful: true, measurement: measurement, context: telemetryContext); - // Output: "Dependency SendGrid http://my.sendgrid.uri/ in 00:00:01.2396312 at 03/23/2020 09:32:02 +00:00 (Successful: True - Context: [Subject, Your order is being processed!], [OrderId, ABC])" + _logger.LogDependency("SendGrid", dependencyData, isSuccessful: true, startTime: measurement, context: telemetryContext); } ``` @@ -286,20 +199,6 @@ logger.LogEvent("Order Created"); // Output: "Events Order Created (Context: )" ``` -Contextual information is essential, that's why we provide an overload to give more information about the event: - -```csharp -// Provide context around event -var telemetryContext = new Dictionary -{ - {"Customer", "Arcus"}, - {"OrderId", "ABC"}, -}; - -logger.LogEvent("Order Created", telemetryContext); -// Output: "Events Order Created (Context: [Customer, Arcus], [OrderId, ABC])" -``` - ### Security Events Some events are considered "security events" when they relate to possible malicious activity, authentication, input validation... @@ -307,14 +206,8 @@ Some events are considered "security events" when they relate to possible malici Here is how an invalid `Order` can be reported: ```csharp -// Provide context around security event -var telemetryContext = new Dictionary -{ - {"OrderId", "OrderId was not in correct format"} -}; - -loger.LogSecurityEvent("Invalid Order", telemetryContext); -// Output: "Events Invalid Order (Context: [EventType, Security], [OrderId, OrderId was not in correct format])" +loger.LogSecurityEvent("Invalid Order"); +// Output: "Events Invalid Order (Context: )" ``` ## Metrics @@ -324,19 +217,10 @@ Metrics allow you to report custom metrics which allow you to give insights on a Here is how you can report an `Invoice Received` metric: ```csharp -// Provide context around metric -var telemetryContext = new Dictionary -{ - { "InvoiceId", "ABC"}, - { "Vendor", "Contoso"}, -}; - logger.LogMetric("Invoice Received", 133.37, telemetryContext); -// Output: "Metric Invoice Received: 133.37 (Context: [InvoiceId, ABC], [Vendor, Contoso])" +// Output: "Metric Invoice Received: 133.37 (Context: )" ``` -By using contextual information, you can create powerful metrics. When writing to Application Insights, for example, which will report the `Invoice Received` metric as [multi-dimensional metrics](https://docs.microsoft.com/en-us/azure/azure-monitor/platform/data-platform-metrics#multi-dimensional-metrics) which allow you to filter the metric based on its context. - ## Requests Requests allow you to keep track of the HTTP requests that are performed against your API and what the response was that was sent out. @@ -351,19 +235,13 @@ if (httpContext.Request?.Headers?.ContainsKey("X-Tenant") == true) tenantName = httpContext.Request.Headers["X-Tenant"]; } -// Provide context around request -var telemetryContext = new Dictionary -{ - { "Tenant", tenantName}, -}; - var stopWatch = Stopwatch.StartNew(); // Perform action that creates a response, in this case call next middleware in the chain. await _next(httpContext); -logger.LogRequest(httpContext.Request, httpContext.Response, stopWatch.Elapsed, telemetryContext); -// Output: "HTTP Request GET http://localhost:5000//weatherforecast completed with 200 in 00:00:00.0191554 at 03/23/2020 10:12:55 +00:00 - (Context: [Tenant, Contoso])" +logger.LogRequest(httpContext.Request, httpContext.Response, stopWatch.Elapsed); +// Output: "HTTP Request GET http://localhost:5000//weatherforecast completed with 200 in 00:00:00.0191554 at 03/23/2020 10:12:55 +00:00 - (Context: )" ``` [← back](/) diff --git a/docs/index.md b/docs/index.md index e624c62f..2b59be28 100644 --- a/docs/index.md +++ b/docs/index.md @@ -20,6 +20,7 @@ For more granular packages we recommend reading the documentation. # Features +- [Making telemetry more powerful](/features/making-telemetry-more-powerful) by making it simple to provide contextual information - [Writing different telemetry types](/features/writing-different-telemetry-types) - Go beyond logs with our `ILogger` extensions for Dependencies, Events, Requests & Metrics. - [Correlation](/features/correlation) - A common set of correlation levels. - Telemetry diff --git a/docs/media/multi-dimensional-metrics.png b/docs/media/multi-dimensional-metrics.png new file mode 100644 index 0000000000000000000000000000000000000000..4ddb49f570383b3037989a2dab741e8dabb5d7b8 GIT binary patch literal 59191 zcmb5Ubx<5#*Ds2@I|TRO?!n#N2?PjE1_>E_a19Q@-9vDKySux)yX(y1dEWPa_f(xz zx9a{e)ziCc_wL@k_WH@%;p(b#=qMy8P*70l3i8sLP*5;_P*BjHkYL_h@NlIi-w)8P znsSm*72~8w?43%g^)<3Uppz~$`wP+o6x{izhl~f04elkho+?T# zBsduVKWrJZ9sm9l*TrV+{7)OSy59nkTF~=qrOAf-yp(zsI~0t+_&Mb|?q+y<$c6XG z2M|~f^ss1@tfj!R{Ivo5yCP9l$wP0_HK^)CN|&myW*r9GJHkp2t$HzkM*0c_1+a9g@eBwg6FoS_9h9dK4< z+BJjf{UOD_DK&09jRUPdDTjN9ian2Yq zcQXvCKCcNcL1)cc-oVK-334DmAEUrJ% zJzgbvNQsC(cAfP5PPUh34`N zl0;zLDRzEYiZ^Hmcqrhe#HkVXLQsfcO;*Ci2Iv7zGq#=?5a>wyoaDsP!|ySEVv}CK zKrXYlBe;Ha3W^B%Yr+U^k)>ylW@n&0t!Ysyv*mcbJhy?X{K(EuGbc-uM92a3Jw6)8 zef@_%I`MEr-dAi*s^ggoq2iQSgPEOPFr!;e8URS@7q*6@RBQ>pJ)v)2X5_3pX8)U%x5r1IR)7+MHLFcQ?f`j#E#dC(n*w&ezw+dfde4AS|B+eh;S}-;Dg<6UKJkMY_&kpDlnf0M=iFb-bv^c10NG6S zgOC$zH6=zMAjk*2$ME=^u|Y1%a0RSiu0AgUhAmFkT6;g7m2X|eOMXz8WapEiSY~Mw zh%I3jce#B{ZGrL^r;HU2N`LVq#*1=-r-sfROCHw2k(iyo3CtFm;uj?jD@e1uYP?9@ z02hIrc<`db>8|5z3_ntrE;pr8p!Z$DQOoMH7_ub&yul>X z&8$<3Pp((Bn6n|P_u#nj*ML{)3@oK!+BiEL>sn%Hibew3kbXJDXZYt=$w>WQap|^` zRR+pDBnK#1(Ag7vH6dOh0eCtd6NJ*y`!i(Z!IFwv0#JZKW{-^`!C;#=BkadQ5XX3k01`7s5yiJQ!K z&Ik8DJJ{t19h12k(N|99O9j@(qWPpiG zm1`umm_w*`Tzewa*pAJ!SX2VMMh(kyvM9_WFjARod}6}UfTgzllV$vjC~X~UF9(~? z756R{s76IA?SIo$q}5DFg`9FcTia~Sm=d*&M^IyK)nrcU9Z8Pt?kqBnC6yK|E!A}P zub!iQUM^6UJ%vJwY9fc}Qp)V9^Tbo8Ra&&;d&NjS8y`_kN9qiLx?fEl?IO6ZBbe;7 zqZT_p0)?#U+4+D(k;8>0j=kAfv8~EvUX#R?i>)*Q(??cAfB#H2GNc)4=9?ilDdqzU zR$}$$#6&(P7213|64&kzK+9##`@_l?2yEZzMMEnCx2KYHpQvbkK4MJzIz`yuq z0Q)~p;?N=Q2@A;*UH%TbC(G;~a1+_LNR@{^Fe%4+s1E z71v3Ul(BQU8w&U&O{bPV)?a98wkwx3g;jcbne{ls{ZuqrqzAz-QiCK}qsFg~0wm$w z0)5xgHns6RR<-xZNIwWGuEIZ)(}`g3t2g;Ibe-J>q~-Y2-`(Fg8&}L;MR6!oV`qCP z%vi!GecMi7jeugX#yNmi>mBlV7(>q)EnBFXcfQsJx|}XF4djc0@LDOi zp-r(eFn3aj$Vk#JA4Q_E2VnRQ=oF@{Y6UY@o!SJVVL#owi{K?Kr~6amF!GJaOwszc zwSaoY{5m2m+_yt8&B7lw`BC5JW@K-!Y;hE7#uxL+(&%)RgPcJVA1B6hKqM}8!Bt8) zl%cBW;rL!PK`6z_#f1webwEBGOl7UG`W2#9#yz-4?oUkLHJFA53a47J|p zICOq&`U#qV_JBK_v0!8miH_mTQc0}+)-61grPK;Say>Sy^#?k{Z5vd zueRKa`nYLzl7s8$ewn`eW;GpeNZ5Ucc#3xahkI8{g8t%}((#}O9IU9*+@_429Aa#E zsx*|!3@$G2rl4D^w&n^pJQWQIYSRfcH9;NvvXosCjhkPhcb?D*QOw=q~~S3;_l1#%#ajCmlRpzDv?3#1nNn=^L|QGUD}ZUpCevb!ZQc z&$#->;3{&cne={cLCE_e62`@=>qPQ%=NeUwjH0~!BVArsdp$E*{*^KrsH&lTgnpRQ zCClfiJRqK{y7OTg)6}NfeMwtK2JRDQ2EBzwVxF|*))+Zy@<@_AEsQ^ueC5OetRDKd zZ)|+4eu%RWX|A|>g=YL_JW@c)Zd{hCA)4wW*%kmXLz&8?NI?w5UXaUu5ObaB4i$loJX(Er3Q z1t+N0C5Uyi8i;?Xk&%?Y7qGBdo_p^~yWw=SYAdDsZIsX)RZuH4icro17rS}&cSI<4 zr(tk_XhvRThUd}*A0zx?;t0bpCL)|q&ZUKv{OKdqXSjSBkw}7xJzJEEB0}WXK{#B< zjj_81(0_E91(@+z}-Jq_8iNs*H+ zj}5d}k1n}MLk13{VaEwUx0+K~Br!8|Sm95uaP{XLYeEuPhy6f8q+Xc&Ip>55TIj^$e529aQr#rbvB-=5f}y(>H+oUr8y&^o}gK+Pw$Ucw672+pc!3SyvP# z{?PxT{QM%#gDnW27SsuejzDkI5-Xki_!Viwwt+!DWFq%WOBFjn8s_s)b9j;QerATetM{?jw8zQ!fsy)K+^{HAcyu)$1&oe`1cZX!c!nf zy6$9;Qg?1TR_luh2rwooc5QWbLSgOL8szo&zZw1wvUHW|WT(6okdZTHi%`b$ZqlUA z$RL8H${C@s*!B(R&TKEiq+8UNWZ4rqgLX3CTz@gIQw|tq>Vzs!tfk4G*r|bB@GO62 z@P7u+`Sup(nC06MkLrZuG`L5S-| z7E%m%AC2xE3}<~#v|^Fm5=FL_qY4Si*xQ@cy4d~S+8NqQ5*fWr@55Yhn`{Gzb+AeH56Oxm4%S1%5ejPM7@ zLBcrQ`jU{zL%jZdquaFEi4F?2M8Tyfu^N-zNKT8-$NA~flmndxp*}SCADPG>wsv;j zz=Km|xb5rnr_)>_9Mj8$s^2rnckD>i_;nV32_j6?16wNV?j1YIYK}%fidc$G@3W3+ zWPUP?narmO(F6H*F0JEPala*CFX$J42G}(@wJuDQc1)KSWWd%p`qbtBu@ati*{t+K zIvb3m;pOE8wA~S?M`a2FKVzx@3fkJp65)~*@A^Lgw6(QKKY8NOjyDSPqh7LrFujE? zmBhaXcI9kbOpJ`AU+p7dO>;>L;C=UarKH7=2r?#!;)bbK=6YjAGo{sK+{0;?r^Vi~ zAq@($L#D>M>{391qo%Ycia@2MURTadM<-8)A3ih*e(h-b5Es4(xvMG=Vm=apGp_$Q zIyblUqZQ0#+RJ}l%VBha~G~T6Df%)pK5=3z4JMoUWI*c z?wOe`L7@NK_b5S^2#MmCNe;lu75{`u>+*`z5m#v8FRrUnEW^ywR_`Nofz!x1W$K8U zCzoJlrnr=bixT9P9=%GQAPE6n3;aaFlR1}g#-;{-@p4_z^Gvqy^$>$vrqJCUJBS!A znfs^~XCT%31MV0N9MUQM8+Up7&@W3f04Y^(0l}dgJ%<0QsF6o!0R~1lT(O>XRI!NZD4+C#`jykuv|1cF;E8x;Xc9UbIN_6xgN5wG&+k~qJMsjlI#Nf{ z1m`Sd@azyNNd%Xy+MB1CKgGD)4n8Herj3Z;u1N_;4eSco9&SCBAHj#f-7z* zU@0O|>%SWz)9Ma`d)Xu)>*~RiJ{BHiK}ywa?NlM&sqVlQ3e$~;DhH2~O1o6eL7^u* zR4GR2am2oxdR%ZnKrInJmQ3~PU;Pmp_W?dHBpSq=8s zQLKu=Fk#0!{oi>uKDObO=d3`9U>G2N3GJl;3M#6WQ`6&xPr^kb3Gnne zVZ+7bz+m&ksm7UGr=qI|QN`+PPC&4R=3V^v(n_60Fiy0LWSWH7j>&JYxJJ3^d-gh4 zgZ_%-m;FuGCc4Xr<(DSV)fsW`RaXN9^vH2USN9%Y<^5@#p~$_p`zvlwduH;*Sy!RR z^VujNhYRGM0WY(qLZGZASCLGYl7UYXrmSgHL-YC-u$i4*j1u&Nyq?0c~eDj^Q;y}#m&Y^KNay70z?yjj0!Iz1WBH~DS@ zE@Z9JPN1(!7^1^xNlJkZaC;+K!SKkdj9VHA}_Yq394K zKumX^7%vh{9cMYUMX+-H6B3oFadMrMOErs^W8xiQr{KnuhGJ8DnkcK>8F6-yWfTo+ z94X!%TAmJ}4|3~bAwW}33VD}fGkoG3O&W3%Y(MoNcxm`PVl4Cxo!$e60h{6|o6e;r z?%o7Oe!XP&121960*$VzAuG&lUFcXb$^peu1!&3=%jh)(2O?;MNi_TO`eWXZFZxO@ zew`FtO0Jpj5*Vk^Bk0m_PRxmVK@B0Jdvv5Oy^+{!+)AzCNpha}9k0>^1sW{ZezThm z1%LR>4p)=rhw|V*U>M1Q#DA6j|H%0N5#>mR-lvk#}9~dSM%%Hs+u^^VoI7Z zx^nH2h##>S*>z>l_ZEif#g})W#H!L~p-}%AGZ2_pqF4xn;$xD991%`$lVoY}CjsG= ziFDx2SIj*#H5FM8{@(|orRx+oq-S8T<`agSx@cV^DYHMu1E%F7Fu}Xf zFf*S#XRuNZP1*3!&{)XUWr+}uPhVpsMyk2xB_r%Wo@1>n&Mr|ikR$Sb%32)%`;KL* zn*4qUu>M11W0}aOc~mZW+|{MV8gc9w?Rb&-rEeuf5gAVKR-ZR;cm(dFLPhH?&gFzo z`75}{K&M6^UXi5L9CzLB3MI_>xwDR!^H4Iva&%eX#9Ez6N;@PKYzzs>}9E}vK^({G?p3*Y1HawaBy%G(N9-~I&Sx~p#z@+ zXV161!Nk?NM{UBi+^x5@x8JsRUth<=v;46y{Zl)-cea3RCT%~CdKVj+WodEWaD6Vm z3s|jZ!ZyFHDm`2*y#Y5~1Z91zl2$(PhIhQ|MZz>kdztmG)uL)w@gH2-Lk{&_asTILwhW3Go>k&nSKK74r9dLf~{sM z$KCG<;|hE8BTJ496vQ+1DH? zQ4gRH^DWwYoVpHt_>m<#&q0Dk=N&bs*E(KWdobSrl&0K9y?^0;H|ET|g0EvpH&qQJ z5#r`jUQi`zNv@_-S!P#eypGr|->O!@8i$?^~(t zQN2q8%iDtuu%P+aeuVp$S&Ev4)@Rd;;C=AbmRTqFX2Bo&y}Oe3+S;3|0g8qthaW9% z4Gj(T^}oc>u`I%+ySJSD)Un|>Ygu=M$qs|Tj|26J@FMpY+eLlm4T!sbcVZl`P`T?u{9`~SP z@a{SKrr1!(i?m(cen+sKk6mQ?x_<~ESaHq!YP++Fy^PYL$Ur1c{`GmG;~M~g$mwHm zU)E*zzRb8YyF|0qa#LKnRsS*Q{xE)o#y|+PbF%{|<%XTOY}Wfy6VXOIP&R$tPNhGb z8ox2v3zk~LcnMAjP}hqgpSC~G#!Be;fvEjj(Lw@w4uAT) z*pnvs?WOYJTgUCRl9rYh#oM9W&eh}Oq`HAYs%kOpkvLF>8asIeo?SjZW9f)ns;_dK zAnPo;V~ybDA@pxM;~P8si>Nm17RuKz)@pAY8o3sknPvd4JnNP~QVg;WXJK--T5Da@ z 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�=^vR`$Yb1xM-$Orjb-e6! z{85Ju_FBEWd1rr|6My(B|75~DI}N1HvtrKs+9dr>?kkK&w2hAiH0>A&o+sx%REhth!654BHvyr;V5ETD}h zJ@fV~K#R+M1QY*rR5FT}P&L9?g17An-^4hFzcYZG zE*4vcqYb(PUJdC0am&2Iu|L6o_~U^|dH&>bFxVTG(__>eBE?*l-T=3&drilXZ&p;v zbu#^Es7huu<$-dbw|@77lD{HG*^b6F=*GzJQ)K!K=Kh3k0vGWGnKVc%3{S#x2pv^N zme;*Rg~W*)19BOhkp{E$yP*&IWYx90*2ezm0K5}vyJ0hEfAe~)1~IBgvc@ye>l!zA z{%1aj1AvC%HMD4-;S_n&~Cg%?0lR;HGbJOGuSk@JDQnZXvbM%V`%jfk~dC2 zj1jh@ujW{T&pze^6bduX7p&k*`*tc6f9%fya1s`^q9E<^Aw25CsX|?FZ{7|BXqdf@ zJ?*a^2XvRyQOcWGRT7gARFc~xT&3Gv4#(Pa?WZh!;a?>|y=*#A6-00xx`2j2!=jBc z$uO9Q#|k4+m)meinpu8x%W5)nJjHgJ?__;leQ3{E->c5^AFPC27rVnuR2a4u;)_cF zgr}|tf$i#E7xf-IM7^ZgAb~?PcZM~o1%zc)Q`F{HN$Ha6!=D~SyN5(rk*zBpu;281 zanEfJ{}%wMKvusr=VyHQ>ksE|E?SOs1*ZJ}`LTZ~+FmMIz(S8+4F8=`a__Ec(GAz) ziYHo+U;YBgmGKtg4UBdSgBvXr3H?rg*{+H;tfk;I{8K)SMZ0RH0s>hVB<+8)!2_86 z$=-3`7K31{_Wo@pb>+q!)6BTM)F&4}*cTeS(*Nd9Uk(zfxE^(d?Fcf?I>p%BQx(m0JEGigXK0x@}&s_V$_y273 zhqm9CrN9pjdqb|#sgCn)y_Y(}-Y`Xya;;LKQ-~E3p;*Kh@aAa)qzDp3#$%l$rd;zU z|M_#-yoeEPpp3Pi zY*882S>-t!ak?!8a+{Hy;Djb3{)pe=i%;H;gPNCu0rB~}u|Na;- zL7634a;)@t)HXr)42ThCIIK^x8eD}d`RqU%?$c(83Mg4(IZhl~g?50&Lq6B&V+_gXPW4gtx zN)JN$O`S4ve_iP3s z@5PtT0c&F^$P_Cj>$bu9W}pBsh~#AaOI<*pk}Gac_khlpnIR@$&e)hRr6vLeB9NOFCC>E{8LPggB zwP69y0|Wv|1Mx^a;Pe4^KjaCjjGF9<97#I1rd?&A0525af6ZKO>Z+4Z)30V;OsA#( zo$D=z;R*OlTb?aJ(Qik?k*$TB3No)cJce^!_sV2Rv0umFam+Dbn;M#wqFzJRaX&wxuWw;qkU+7)A?C;|VPF_Id?mLUvVN z^?}-fD}6usE>Aobo247Uz8zuB4AX9E)H&f&|ay<+(=$ z3`$WmpIOf!GNf=@Nx|0QtM4>__rw2m_L-AGcW}CGAPGf~XP-Gyket7?pypzVVFpCp zN{eCs=pVeh)vO=O(R&CYm9%1z3{xLRz17(VYKr@cOat)*RA2}MveG~SUU4ST_=|id z^X}Rjv;M{fo=j4)dRy_S1iB&OEjF7il8DOoR2FY9J@xdl|Nhi>PCfljA{qy8P4rIm zHTEog-{KfW`_xkP0@g$W*_Bt4eTu??K&Fyb0FeI;k!W9O#+Je?36HzIJny(t5FyFb z+YrbN(CeeJ`Z3}{Ff@V2iFI;9kR`$W&Ue0(dbw1_I!7Y@aOwbZ1E6LMCK9iyMU{K2 zvlKF*VW~H!0S6|Tqz%K2-iUI8bUK1d5FkQbre3B|G`xEL!pr9+3dyl2j!2Xer9qYY z(5+~Tp^>WWO!a~`U66|ey=+=&^BM($g?xUo0Q1#>qE`wHduxhC(_`YqJRT_*4-eW3 z`22O=Ll0SHA|!PLjk-xv&*iSw_`uaN5-wC8{zIDJ{f zBu@r=ODWi~vr_T?^XIbJ7PY+Dd*NDyb!A4a#zAHycv)QE)0L2O=5M$yGwI{{|bH;xTipF)e79im%4e41Y|%0oPCjinyrNvRX+Tsma$%7cqSqWRXTLX$VKMLveZf z+UngH_D2b)_O5FEY%8J&xLjP0^bSsz@&vFUdQAY5LotkpAdUxuN3_UQglmW-)I6Yf zt9?7XIPpgYx9qDb(QCkOgA-7TgeI$@1>yEhxbirlh^*`aY&64k#L(Au;_|)KMS2bI zrq(j>>j;l)l1Xwh^vZmT$D}&VCfhv$JQ7z6_{l6=nOp<+C^<)SWxjl)uv!94vxKHh zRw58^hIBbO?5NEdz;#;9ME58Z;Om45@+gIcw-(eDScMA@`5jbgi$SsMONmlA|!bXiw~A&Y~5S}oW=RYZYCxMK7FBCC&{-s^zv4k z?7`yUU`z-^nwwmdKlRZ?GNZLraz-T$?#^T!8;-~ONwR}OM^H@1U)7tku2_x$FJ>VQ zin!F!pvWl7lyj~PIuyi249VZVspQfNr#H$%94k$LAYNl|^<9;~Q(ja-2lt@O;gQvM z9TFldRE^gIV^Q>2v0-0r$r7$Hxi(hM$d1Z0AMx@?Y44~pfabnmP za*Ws&j$kQH7YGG%?(F`;jLOo}SxtZk&4g$wNKHT3tdM{k6!LL|FOo|Tr9>0d z?D|{~lPzPwT7qHT<}%#vg{1~fDrsJZ0^wkN*TWP?xX~=jOvT<1Ck-tA6iN1S+2bm) zz^E`TEJ!aT)tQ+kRU>d2oVW@GbG{hK!lyVF*iiw;G4%ok@24KN=IlDhqvKs z$}-Vf^*cXxSL)yAaU`JJgnq5^Usd&ky&mB*+ zoox9W#+EOpS9PNhB*)o;OfEz(dqIB`zN`Kn(4otAB>_eO-}J!h7OSIjOlMky>Yu^$Tsf({CpAcJR3{gS!+SB z1R(paMWPq1s=94uN|A6mg${gGyUiu7@48n!dwbW0rad0-+g`XS$DBG|5-3TXXz2Ki zJ)D6odXokaJROaM1KW$X6<8N#9U=sA?qbIyu9#7D>%~LX3J`_36Icg^4M_!5mM$y9 zpq7iT^o{T7ch;^y*8zl#6Y)edfw{AE=3H}@PNfhDZXR1S7oeti(D>!6{dJ?>%`$0v zZ9Vw%j%e&`rfSF567?dBS)8QWC#K?820p^#8y2&f=8g2B=yACqZ(B*eR<&|61}>AJ zY48Bq4t@oAJxlkC-vxM7Q&F_7eW+yEb(d6{Ue{sWvYaMpI1Oo8Bs-;0v?*V|duy3e zxZIT@z@Mum;-&l+iKtssF|l|!djCry=nK~MZxEAglgHfAzK+IIUF{Xx&VN= zX+UG6n{w)kvKMaXXAp9^Lam~C*jCEotgE#Sz(t`XIYkhyBypS}uI6Y(n+vLH3Q95z zdYJ@db%st=ABiY@5p8mkTk5aY5TLsr9GoqFoX7MRnsV#Ps|&L-R5I}m9lZ+yd{n~c zTg=*vY>IFN4eYet7vRUVqv(07YHwY|2PUU21aKM_m7JZaJ>l^Q!f`E^yC?-kDXKn> zHd-}XcU4#wE4xz*_-b%&0uBe%Bk)6M`6ci*a-kqAL*K8JwmIB#j8t%zKJ06wuwLc? z19Jf4>6s3EjHcr>9VE%IM4~H(+Au6e(IA~>G2oeEz=y%drscw_a`Z;^nP5mCh^g0ZYyrss1VwkpVs8@hwmiMEwxF;guh^_piG+*N zrw;(GE=#ZKl?%JZo%!rEEM=1{C(-DoeEpuSr3+jr=4Qb4C`Cd`mZ1&d4UA7^vAGMJ z+Th0Vmq-k+E8bC_E8ob2{(z!q$fdGu!&we(n{Z|E__vcOyP4G*1w9AP{r+fM&uE0j zL^KFaSvbiC<(YNra-rBqO0{F~x}4 zY%zx;W^=%^h?AT`4qT_1=QTHZHxnhPcZhg=Yf){EIqk)(!{HX3?YLi@=C-x90+g`h z!C?5FO*Lj+D(U^$r=lDV+hkbiNRt4DUp#*KPZKQF0^(`#>)j}NGE=o{TbXhh@pp_Q zPc(IXY%-XSEM+U`D~c3aRW?v!vW;qP@QDBSGA<7ES0; zl01(mCbcqAwm#RQ*NKruHC-%(&MB|2x$pi2ZC*wn5C{yKqS5w3W8J3WwD{8`&GdWx zQ&$Ie2NNX-GEZFwKi!FFq>`Ap#$fkxw@p79+%v_dLfTSv-< zCXUK@<{hO48r903i66sS&RqKf%1Ac;K!!;iKT&MlU0E<|Zc!BT%H!QUJ7GGc+p#NS zfyNU!aA%skJ~ZaHisl<8W5e)Ql!7h0tMm)oD)E-I*<6yd9rwxPt5605IMEx64a!6b ztxRrIt4tb;RJ`PYEkpj$P<{Jnan3@T4bp-$fxRwdS?bD)7dGQ-nRpXeOY1=OuzROO zvM3D({_d#+>Zr)tT9T7S^}P;8)4g`Lr*-I_D4GBMW!J{yiMK^;{pP|li+)`VFGw%I zp7;BL6Yayb_TUz&ZPLIAR_b#7t_TKqp2_N|`cKe~Clc zU4AXi5+?`lr9QlBB>S-v@wb(N(z~j2Rq_=*0TGXvkRl@klldEeDa86jT(_w}Ifn%L z1BvmA-VfDgUT$@nN)%%8g5-e>P)J(m9gXG1iB}MI?cQp=ByEkxYKgcxjw;+?{ffyL zuvSADc8nn!)JV8Cub?`=G(Xd#Q>jJ5#SS045fvgL^@=Ma_97N%rTgTPF*k-EM%X!f zs|()0fYiz%=J6~h?KM8jIqAt<@NPxG#Xp6`-CGLkin4_(vko07p9Y0gmZ>`(jpDwr z5tLXC8>n(i96fH7)$FOt*R9}a=k)-vU`ZQp)n7$;gHt{YK_}ZXZR| zbl%=7%N%PMEe&pRl$`R4!(D{0$SAoeNghj}9fhX+9i`=k)*O{WI=w66@-G2=gBB6R z)Y9Hzd;YWrq~1t3Kz&Eh`0FZB`JT$;E}W_4)c}ZYrdBzwM0zG&Rw}vjV(N`KKq=}i zJdW2D*XCGOG%N#|AmQ_~GW3HoQJce!L=$Ie!c~(~S5u@$mNj>A0|DwwmPSEkXzOD! z)D<-GK_OhhJYO~L2mzh}SR#!Wu~?1Qr2H@6XS zzpH$Ep;i9wVhCvje4AD(9+e8+6Rw<=*6RjFSy&;*ul}M zY=JQCKhz$JB?p}EC^h<#rs5|X#81<|<8IjmNJ>W8E=yIDy$P9Q+B;g#<}q6phg|5NWYW zT3Az%`rbvdP6uHv5Ri%Oc2}rnaBrM05Q)-t7eS7IEbbuiRuy8b$}2N!R=Uq@9tfH_ z)z){g-&MLsvtO2jpCF#siTCfRp36h(>-NPjg=%tAgLFV)yxQ;fW^)hTpFOkU>@5Lh z;P~b4kByY~4Q(shoR_hp2F{LK?w1i7&a2MF>ojY)Tx zSDSQqtO~9NfPh_{bSAD2?!y=(kIzj`oJqD}OutCajRD3SM7KCa$7njtVuB3qVKE*q zJAw!pIl^dU8o5*_mnadTh|5jREJ*rD$*J~0St*7FrF!}WgOMbP6LFl3C!Y!Mnn@6B zj9}wLtwH;LpS)-0=N8Mx7GMB4`yht5^pC6BM-Pc4s%5W)4$4GZEOuUntkB9E%O_F4=4~&3aQn(R=l|zMWjTN%P)pD}tooXqnjj+3f5b zMJnl5*dwu_x0^mM5cAmVbFtXimi+AnnJcYipx||R{Mhkp9~VoPHo*~mLyV$Mp|P>D z%pE1!DnyhPi?cxDBz3lZU{{ZQlT^BVTSqd?#W>nsnz5@qZ#l~#rybyGG!EM|EkpMU zk(n;x2t_^1V3~Vs@--{i(g0Z?pceS!iKby&*cTSWF+M>FP+Snl1sH*_*>WyV#^cI) zTp5oieu_TiPlI10cu|&c~5J5Q-RZIA4xltuE$|Vw! zP{`*Acw8QPS<7^RGoPMM%gUCDzg&==N?jxyUVvu+KF*LgVDB2Mv;}HG4lijmBZ#HC zVrZ*UBq+)($}*~!J#92yfIHOT_K|1W9~Ou=&}4RSQ=TN^RUfX?&at3wD1yEA^X^Yp zWQmdYITll1v_9l}@X_KAq|XJYau)_C3LE=DPW4n;cU2Xv&LXtncQ5vg)V5F5h{dU- z1q1%J7mZ&~3bmDar54?qG_izn;_~I5{kCAyyi>VuNt~ijVyL$&XG?L`I$ZuYxy*&l z6}~d?VUi6Zo7WIdR$XbnW|hWfLly|QP03JoI$FgUnxJTcph$wGaDv21@B%#3BnjSN zrk}wBclxb0RsGJURLU0 zk=!N%JVT5iuZ}rbZNmpCPKIz1tK1PZGl60C9EzyOuFAEjmba(EN&s$Beb?~T&WTE7 z(YAiA7>S{878~x}R5I6%=;-v=Uw7TNJu`LuE;P+tXm^s;$i9Qt1&)Z0k>u<3tqLi! ze^be7Mqoh-au)79sWtb#S$5DHUWm|bZ@b}iRu=x_$rHdUO^`JRRjlV$< z{}vjfc9zuU%)ZX(dI044a3D0$*v(LM^gyauv0{hajjF^U2Y zoTPwLD+O9B6!2zRu$SMkvoN3lzX#1Q_GqlPdo-(mYOh2hUBHNCI~qU7qGCnn{DMr2 zZ2gXmNH#>DzWQj4R&RvmazLp%9!KdzH3e#AD(U@DH1pPr16ygCSwG8aUl>lk-a4`8 zO9dv=Le~Owpb0sjm##&*7tT;1Y(IVNa~$D9Tx?K2d!w;)YQ$7iP_(9F3$8PT#@p)K zKM}%B)1ByxB1Td#(+OmIX=R3C^~cdH3Q!>3@dU7T#xyO-0)fo1906YY`k!8ad}hj| z`?i*O4_5twPxr=AGP%(IEF>#r0)HotzHF8&@85FQrs7PwbUpV8fw(+-N9j>AK`z^8 zS_KH2u_;8Ea#`y5CSoWNcO*2**{z{az}=anJAZTx!>Cl!tuTv4tFOL*e3hJEmD`?3 z-14pjaN;NyKUHMhbfC7vyf)3wH)9eb3d)<8UwN?ON^q9|k52S7-vqdV-Wd7^A%ovlez3MgyUz9%&X7q;_HTNfM<*ycm2@k7IQ}w+%s5a}VbrYq zssn+nQ*KWI1^}C&K}7e|6mbr1ep<$BLD3oGf>Kl~miPmovfov9&w<+F={4eK{$%|F zyo8D(>v6fjhkwweSS&yi2zn6)cTrFbbA=|&ImUV1n&G}cwpu!m?dEdX_wBISF8Kn1 z_3m(h$h&r1$w>h#LC=z(L4rIQkDV;gZ#}fN!lawWDOoGPO~_Wsb-T)6#p5yR)=dr* z3G7(`%X*+DU!z?Ao+|{hZrP9vaV#8Q9Sjo0lx1v}30fzebR2(+MTWK(Y^p8J)hJhI z&SiQ*cs!m)-aBk7<|bDtOr^dbAg;{Ju2Vo|r}t(?X*xntUV1@n17Tn?Luv#w71@=G)e9F4VB z$OQtsh#MWA$`Zaef)6+%Ly5$T2wSnMd`p3Koy?A%6>!cP3F20YhsLG~ICCzN1&Y=% z8h=g3+j5{bQ!Y)VLLhfAN&&xmj*%|6LIj8~`49;O zAQX#Yc<<%jeeP%}f}}B&X+hE9oyD87OsV6W7#2)WA}7 z$K$6BvQ68|U}q`>G6Nh1y->iVZfNPfP5{GCox7&-gmIA|E)im4flz|T#UcfGMudov zFW_+n9By*5IVTx90&xWwKC8qgC(^VJ)D3#JAV^w<(tu2UhQ+PrxTR83#TX4 zgJgOBf_AA3MzG_P&Ii6yB3al*No$BJ7VkUR@)?Rdfng`ayxh9dJgsVDHM9Wt?!v%W zN$c27(ffQd;ODhOqm6m`owdcvbu&dC0$FpQ0N;tY5*V2xo1@0 zF@B#|vi#}lJ`8`}B0Er5IoI-&1PE%M?!QN`lZX~1sGx*i>2nA2xd#vBtk|CJ>49dL z%VUn<lWTg1!xI(O>WX~XMq7>z0$EYu zG^9HbgGgvbL~5Zx%u8;qnMz#}Vjgc#MSf^!$!laHc+-gSMFGUJArjH$n&;UbBOJ!q zK~l6}I}R?cI$s;Q5*`~1rIOYwAY`n~GMn$N-Lt7kzcJMpAmVZNRuwcA8am=};GSbN zeHx7oZpztQSpd}+0!brKfFVhMgm29@OZHVi%V%867*ZFfsX@IwU#CtT&&Kd@NSE9a zei8B{;B$5t8ZIB3#PJmwww*@!9CoEzxlEU6%|W=_x~jsH7Da0y^j0)tug%+2mbV_( zMTbCcCl({X3}qXi7#NwD93SZ)wfnsea%Cp5K-L5vn_a9^74ENjLBbhcz_Jpv;-M&2 zo@t&DB|aM@;heNR(dWodut6!xC1L zHg!B3!7xTTalK~ITPp&=-d3U;KkN2*&{Ps+g;5CvAKG5AE6W0$vs4lU0!bf>i-3Et zUBUz^A%_OBFBS{Y0u_(Xy?AP}uh&PAFdDuc0ESkJh<5HMKUZkDl$diN&sm8Q+kn_eDTyV1hPC9v=9fC+-D*Q4^gNUQj7HZC;H1cTVgqob3j-0VsGa=+V{B}b4o=!ymv7LAi9-X5Je?&|LF zXmeyT>6%T71Ex3>!Y*C3lO)ZVnPLc8I~06=rBXH{k+Z^?yZdHA(~zRk=sX{L>8;`Z zp}>R-?FmL@m6F=62B~Dd&(~aAChbv?kgL-!x*2wrAsMFM>5DY>-cPbMx7vb%TusFXS)1LotdH?+m*S{AsRQ1=oVOok3CJYKz<77A=;Ea|}`t ziBGy>*8<^!{kqap&1z0a1LbzY7QT9Hs*r;enq;0}yulf)deBsmuUZrFn{vkLUmDLB zh}k^0pCF?wlCR+@EFx=`99R`0aG#+juOe9z70T>)oL!13Jl2LQ1Hqd0<%t1lA$V6$#oc)p2BTi!OkXE`&HMZFBYdL zV2WWxv_dRuEoczZJaZ|Mt>cUM$@`ZM0q#u+FaVSZshFRulW{#{W0NC7lM0P!{ss5% z5J-w{X?9MY_8crQsg)w7OsJ%Jr<*3V*;1KQuv+zZiO7Tky+wN-j|;sK9hY}={EAWZ zQ8rmrQ-JX1oPdPJ$>!H4_7)kJZwR;?wplH1YIkLqtCla8KzFBHv97D`hNBbiW`Adk zdvrJyisB@T;qy8CIX5PNq?u3{yV~SzJz}e1OSTv3Sn zk6>*xE@)L<04UN*3Fqy$Se`)uG&mhi(1-g5N0Lp@9{^2|?Ze(dCb8{7Yhm8nbe60W z2$DW`ZUVg=IaFy82~#y0WW3E4Ju~IG|BFTIzdsldCCH|p5o`PSA(`w0W9^1x=<8+X z4^nf*XL__$5zajROYIIwx!;f8(_A=5$tS_ zQ&1({f45a6O6L+?pu#pb*zNVcy9-SkrD&e=mB7f8Z4P9!Z2vu3E7#JC;nb<4W5Pjf zSE*67c#jiAT|g&*K@LPPn>Xr+CL#h_ktNP9QRZYRG^!0?eAXcZK@X1w+Z&uU3gxrk zK9EXX0HElOdWhFrqJOqev4R3TgU27gFz6DON;mB>>E3NNxuZy6)TJ|%*tO`v8uQJ5 z^n^2d*6Tg+$-E592H4zkrQIB==d^bwBWXWt%E+3B5S#PG|mjiHE z;t5hJT~%`yiQy++8__vgJIV}v-YgdmvVY1KJ7sep{A|9-INt{K>ja8n`dmI&eaFXG ze62tL&KISqXC$1ugIk1iFI5Q2z{`(!-)k_a=4d@z8o-EL2>BoSQprLZqCuDyjo?Fr zfwoIdMSxYCt2KgHi_g7f-~#RuFjxtkoC=`5V*$U2R^&>`t91sW1gPT@n({!U0}%;H zF<63($H`zI;jl#h{gUvJh*mUdkrGaVlE)R436L+0vgJ;eif&lf-X;!rswuFTgg{CpM&F#Qg9?4-?k@UsOO7FjA4 zG8>?5peQ*$9&Wwl;5x|7*&2&RA`&F6M|P(C(NC48KDPis$scwT$2wwvx<|em0z5+~ zf?Xc=M)d4$cW0VSl2seF005TPZjW58pNdSzv$krs>@cp*_(@+Ne)hG|d`wiCtDeWo zgBt+Ctn)7KU7yO$vd$Mot`k7WI~oWLHFSR{O5}({eQ3O)DsyLP?mR-|_M&Hg-T(0| z+36j(3~I%NE+=QJbmvaXJUN_5kdwB^V7o6ef@TUt1xC4ADO#F21N9|_lAcg}+!ymu zI7h?RWlODja-B{rPELZK{X2nyPGA)9|APKRz?TSm%Pg626u&g+Vih8F`!f_va`J#D)OgVzx)$1%qt`9IRhFXY_7VROA3ON*^h}Tg zhI!l;ZhC!ui&T+ok*|=!1iv!rj5PTDdp?y1%yKFfasxO)Ii0cIHg9k+s%QAcCWTgs z@NWns7c0O6PP}O_@v$vZsfe?B0t^5KWzrozH|WYapx?aJlw7qV_0CEGelZ%w>(5LE zuZ8y&8Pp1-bU<;xs&Q>m@@;H6y@k!VI&*TADbQPVG zrQ?dl8=JZhPKCPJjN!p;+4A{3=rd<0WS!WS5`F48eE?N^sb&1oUlti}8W9b`RuJ;` z_WJrSdz3-;=6tO|4MNEDw19wm18iSse=T;JsOw@HYbAjf2L5QL6&n_G{cMx2kZYhd|$D} zq!p)9R|X&eK!eXXJa>Ptz+#4N(J3g3iN}etvGBDE4xxkETA($l#X`X>D@`p*fC-9u z@?7Y1yW|pKQo>hNfM zjI}uf>_XA*16GA>MJ7s(PlnGwH@s7?&C6J5L<{bN-5ssBd+I)wlfB4J&9x#(5Urgf zZWR4!UDZ5`^pSuWNnMJuOF;NF44<_#x&819ImF^U2|CKvL-L&D>Vxjc!GClT|-B3>HLfgtEm z6c5MnFhv9sgfEVf2wQ9t=`y7`*>a5v0siH>5@V1{p)gi|VuBe<)ELzndP&+(4_Gss zJJx9TTKDL-ZZj?9`@x^Iwz&sRIX7!nxn}t?PYHPZ!?tj9AaL+=`8Run3j~<{t5=<4 zr``MWjaubutTr>#2nXWe-Ji&TZPCDS9~}>MU-6KW39D3WRfu(JWS*wG#YVt4vIYVS z06*#Wq8CTp@@n~(U1o(`m|hh|<3vxFufN`v&l6YWsc#-hK~hZnfVYo`Ro!haC|0Mj z9WPk}hlAJNoY-U1n{S*EnZyi18=pV z-WItMzPsGK5<|M?0u-T1N2K24-SRYUkIvX_0u&)osS`Nm@yAb1xbFLM zk$J7hxDE^ln%|zxqJ%X$8riDM=Avk(d(__+4R8NgRza?6)^cE*ik^RUw1AD&}H(EY6SM;>awg2-4nda4tgGrKZ z>-HLTh{d#Ky>Gz~)_BqGZwnQxcY+MreaL zto53!|LD|*D>D_+C64t4X9bi)FA$!&Fex=7D%Ijju{j6h$c$YB>Ccc4tPBBE8dO z7Y?}lJ-xoGFODC~FqG%0R&B@_hs`#q#Rjgh@q#_hXS90pjiaLpg6{70TzPGLr%GL# zqfYziV(@ihgl9rTmoC^T3CFmwF{goG;^b>1dN+GdxiP&C!NQSC1zNV?!ezTUODbQP z?ztOD#v5Mr?3<&JhTwR2U}!8v^H>s@;Km_ND+*8z$5gbXe(Ksgwu~V6V1*^Q#*1ii z<3yASVRgAKb+Aa*Qh;XwCAGjL=Xl9;=WUdjt<@piMK(`?O78O~P97PxpY_&hH8r_f z*@9b>K*i9ikvx@j?3({_k6URH%Ve{!zcW7+MK@n^OdfZCs5(=!>><`t2|q)EoIN|C z%$6t=X>OliWkM0W`= zcyGByuNJRdc>#7jM=ia4aVjFDO(yC5Eqp$I{MhqDl`Khho@SLhO+En7T{Vk;^5VEI zSGJ-WOi@f~|g%9b`PcVi1M02DZlLX@MB3|#hfj|QY#(e&z!3(5=d)6Mmc?&FS9mUw50 zK_L|^q4)xSGs_@V6THip?Cw}XrAHPr0slH^oH%!40&k7pQ)K~Bbt-jvfbTJgMCa-! z#U_zj{oW$98;;@OAkh^o$yLvO1vI6bxVE!W#g!|BF@LXLKuZ_8sw(7`fMTOlBEboC zC>XWoEn;Hp@&Uok#ANu=OQUz^n$+`l#I7j7?Z`IDNGE>b>J*|8L?Zafmxiq&?sOaP zinj^~_}px@q@&U0XOSk$oXb^$j5_t~&=!fZ$f{gh^_>BjUmZtq@v=jeC0QX24u!Ex zXKk)}-+?@1hCbkT)IXrB1vUbk4VC-@L@tj41)L)nsC)=Vy z9GvEwNsu&#QNTj2oVwFA({f>IlS(;P`!gGh?<6}dWqH601D^>E47x!O%w2=tuiF(+ zY)l&QNV|U$Ph@2)R?WV<+_7`d4B+HnKRBhrOy!DB zLA()Q6LJl*;cLELZ^)Xh_&_@lhyr_i{g+=EyC=&8BCvJhXM?klO9g5+|J1p0byl(w zF7-w_plD`fBy{4rq1+fBgiOH7rQVnZ6jz~uXVuG!)H05TY&tdBJsuEA_~Pj$XqJ;d zKr-S9a(F0k?3JPDmGDlZrYchfq<8r>;x-Xr0LXp01gN0QKM-kbnc}PXYPINQ;Q=m8 zTf3*}jd7KW*`1}g8l~wPR0*mj5ORx9)Z60enG9-8VsPW0=-b1ruCvpk_Pvyy~ERT#@^B3H0R6HyLQiwB*(suDw|R{$S$d3qy5kO{RWb%qs;Z z1XQJ5owV4fSnO(-%ZJP5SoPBI7}_%C%gB{q?+6F#+uYMqB z9vcgte07BGLigtyb4~K)uc31@5`;fJIEy-adIFsu!7=NYh~!cmFASD3;;K9icd0#> zw*;JwMJ7Ifev+r-YqZD`3LgMOq6v)hd*dCgo`zGC11DW-KdV}$)G+*ZTOhYswL*=P zQ;uk)D^h5hV=@NAsO%kEO5{9b#=YuCWUlCLt8*Zq>u`-bh2zQ;_r=I zx@7l66H?&A2)PSs!vH@T4&!aD?hCJsN+!uY*@hyE0_1jj+ktL30S173Gp&Mh!hxSX zKS9Yj27|=ujvaq(IMNc{rd3zvYY@?VgPfNM5Dbk{l&g}t`ofLvPNhYxkiD<`Ih@hc z&kgU8sS2&i6>P(u1`+ZyW#TJMQ!EW%zsR}8z{?&Q3tp_ZwY)VM>4_Sm+;W+0OP(&v zC<8gHlnTcBgAobKyfQ1`v|Vum*EoywK`UXG+c;8<&g_ z`zy_h8g8=6fcppJO3M>~Vv`&Yx>OAYR_Nj-Ti09mU0O|P)}qG)f^sAja5MDMe3g{# zAzLp_bqsj9GM*+mNo3A47K-4fPK|fGZ8L^>+bo*oyqJ}l9I+e$UdwsF3nUoAF7!Du zGmml+)fz=%_Nwk|2y$oK9=`1G8@H*dw;JTrGCVXCy!6WGev3ZSxOy#Yfe?1A*Iw~Z zW@*`c<0Qce(-a*H;Z8?%Y9!(tiy|n?Dn^QORI|?O4@dCVdnWJsa*@%P=9OS^oO*#z zS9(2@^}P@W$Pb^3C6lv7OSkVNMZ3JHc6xqiDrt2|U}V==pa+ZAK9I?xnX9i%++S>2 zomJv)B!&{ldmRN2n#)TyH@kA+R{De3;9y|5)ywjdnIa_DDAUMAAk*fr=i^h6E3C*z z9w|!i?8DKC@Z~3mKVFwJyDg?E(_sB0`!ziI`&a8^7<*gaE3xu~COta`Lv92Vl8zz& zpagsH(}lvccHe*~=j@pY>T2{rwRt7RL)F)? z-JEvTsQ@!1!S_#P#fB@SfyS8Gm9>?{-q_XB?TcR=aAFK|Z<$%Oq=l}QPbh+)=y&8F zGFDZm+-EdSI9;e~Jn9^YkRDvm;umHp^y)=Srv|3;)HR!Iw`%)NbGlq|P^=p2ZPG5R zs&I}4u;S6Z{xjS5mEAn%84rcutalCP>|?##G!023z;ZSAxDv&JJqNSWxHo7^^VHNC z@BK9yi=D?0*(gkTV&@&6ouAIlTtFNg3S-UncC;&YpxCsc%bz88)*A7T;3y^G@WOPN zQdXF~QiED%W&H^-f%Ah-tEas#hpjKn;fe(Pm-~;9Rg`YS$21@o2N||j>(tB;OAseI z9hrCQHCm*%!|NIdDI%QGELEmXD&%v3`CEe1hhfwkos+vB%}ZBjFikUWKHYy%lN@cB zN_syc&)BDQBgT^4)bWkbw4El;zntkf6JJR5CfqUKB z<{mye^eXouAxIi0C?TJ_ z`U}o1M}X6Pt^_We8Y-GN`*CT{LkF$qnlheL!shV{Dl#iVt*m$~^|1{LC`@asz5t1c ze|MSLe%w8D*q-m@eZ0W>(9Y~)t5SmSmONEXDCBOnXwJVi2HeS1((;HzaN1AIxt=Y< zC<0?DgDQ3S0XQ5(Np60q8x*Hh3M8$7adCX>urjp)I3?$|Jy>Bbv?^ti^h{{8 z8l-wJyZ+1s2xwAC%b<6_uVL}$nw`bOA|*nZYxvDr+QMykoAX2Cn@2G8_(L7(-1x7h~_Bg-u?wom;^DN=vMPkIUHR@ zNfAB>gW#0|+@btzWjR-J>dg^?q*JL2ARZ@99v;~yRb{XIX2W9F@b)6aP+hu{>ZAki zR4QbxG3mtnvkd2+9(w1AzA8#`pvt@w>k{7HEUuw|&Ed+VGND9*2nAY`RY1panql(= z3-?Kt8Kynr39i?cI)z@4lv(8ju=qhqPYr6ph=3}Dm&5wa?GjwQa+2b-eurmlRn zR=`!Kx*;Ot_7?_~K65E-h=!~atY*n49?VW1+ytm2CX*?3a1&{m2aI2-r`?X!!NLfR zPQ1`34Oy#!jHi+y>j_XO+K0W~OwPXhvKG6p!q8~2@5RXvZOWY8I>*8X0;e_~sA6#z z)>_5T6D{2@N6Sg$2ALB~kqkj3n}s&orivi0eY@LM_F+p&sdg@PBMAE3sc}|kd|!oW z6{dU$T%!+3dvj`wudm?)^0vRR`v_+XrLoMUKp<<&dYT8kFcg{QyQL$rA$r{c>~Cq7 zI@%WL>kll-Lj&Pa+f`SNTsl{5ghX8V*@}g#FM!Q47iSm72SH?=N?AXEt0iz&0_8^i zqJTqg@7DF7%j-M3&3-Je?}(x2qzk7kw(zXyM^Q|3gM)03t&aM#&}eC>&01o;aRog#pI=auTNQ3);c4Cg1_D`q)+Pc5 zP|@hAi?(+2K8BzEMd2Z7!5>V#J>FR*qNo>t((%bM>s+g@=S*DqSe=q5 zTg;N~3_X0c|8T5=)@P(r)(D2CKn%zxFm5a$iu$BfM9)L@B0??`$Q6iKDiVo>e3392 z`%)B15JZ9?FanEXu^5iVuvnb(6M_IK3eqA%D8&&uiO5-?{PXz9{h-!IYmnU?JL~e? z`)Hw7^S+x7oQ=zur<`ZK_mo@2tFYh(!)PY1eySuc%K|t3{mvZ2ghnS`>=p!aw=Tky zgUkv|!)C~3vc^kME=_;|p}~>o2Ib+bO|S&4Tly!0{Zj1yhw~R0@k~uc+n*i3w`vZh zB#E8Q<2(14uou}pO9y#h%B-wQ^)Uz8twmL#;CEP z=oWHyGYm6vwfp5*C8=LwgG=B{(8~&VWOyKpA2x|FsZt_SN)V|?jPUs)KASIC)Uf|s zLs6h2097V%62mDRBNHf|h@wOSXMo(&(`pLpD0r|L@C@o}^1meS{tIAO^m~WX|1d0! zpf0k@aBJCg;vxXSZcCqMTuFZ9Glhcb>EL7I;j_OR_(+9Sy}Vu77Yc#r44!;wuTh}U zq*88zj7HC#A8WN7UE}?EC6phal+}pXk0)8)OSwN70B-WR+lSw?uFs~CcRO6ivo}?#8dsB)Q=m=3#Pq~ zIYGzAUTR~za(A+LaD@CEP!u~60Iw6)m^k= zDYf#Bh9bFPuQoDXn=jt-^{=E77s+B)!kPohG0w!6xST9UDAdz|zOe|QG;Ul=cYDL< zb3`P&anM~{shNM#X|F#%eA2lkUpMQ=IPvICPQRffZ)rE0D-ei7Q@v3cBVOosq>F%I z1g??&td4Daid0q;2)sBFS(+o=Rfo;vX*CjW|Bz2+UBZxTqe|S_>>fp9?Wd>iGH5M& z>FVSK6OREmsBCi{IR8}A9Ps6GUEDDkEwvDd}p zabuFHejl2l~xc2Dl=TnI9V;@t|@O9F8+D3=<72y+cKT_JdmY z)*7QWKZ`GwaHKMB#u6ta9S8E6lIm=Q#c{?( zwjXW)`hI|a;~LKyJAWV5^yy8UZ3il4xj7uc^u&jBu=Wvf65yw+6>`_WFsY?QE4;G` zWT_}+f{+ch5eaMdEGqzykAy^1q*XV2KZ4NSzc+_Objuy+!4>c|p|P%rf{`q>Df>Dk zAs@T;pw404RKgbA&SL<%LSZI9JTmA;RhGrs<<*3ydfGO)GI_0;;zyRTEggoM#u`3W z7&8`S-~Q@51Ba7UlDP%F#zL3ZShYfsgvH)cRBBrC?cgbtbp-;MZAGjHClbgSIrq_G z%v_$&7K#v~@!)pD7H>T_j<_6qDM#jFlKMBQYEA&BdgX9jj@Cc_DYz z*gJ-iOPpwMwe#~vXqp#vSw`v~M9+S1D|hqWa&2w~S0YW9e={rVsXdC#mgg7jl-N0I zUbKEm*EU#OLR2DkurHv4}KT51K-3 zy$6VEckRg*X|*3HFrW}_-(9d5YvFnAsic*JjfM;D7a!V!C^9W8TXea+g6iBVe={4z zqbmx-@SP)jskW`V3-~IP*kssppz`yU@w~A!9NJRZj&7M;6n z&n{PqgggwVJI_tk7}dPlHZEi$!CmY=Q(E)^bm|Km-imvf&B@Mm{<;=uRli%PnsNrXIigfX-ID zr6}1BIU8)D$ZU{E#@Z(0Vp^hDxk3fBu+(wko-HcGyu#``4M!lfsJOoVA-`{q@c%E>~*M=IgmCN0-wb!^O&#UHhG(IU#Sx_@xh-eN|g>5k2s+mQrSx zGYD(l2{0&LLY0bRA08#utlMZrG=s+YK6{3*r!?NTL*d;d_vg~~40Oy88Ph~2%I1MzqUXZ@89-y(J~7KTFQnD zMu6Sh)*taltVD+LRaZ%Bf z6 z;J};`R9RueWU`ZH3-CM#?m+gPqbW8PV-hhsp71B2a2oO@(Ks)m#0pZZq(yQD6)`Bm zq9Pu}vZLX_Ym)kb#s*Du>-P`ZZZJnf8Eq#sxAsg^j2NcYzV-SmO2I>w+fz8$Q1Fdi zf!>NM&RI!EBfh5K-piI2<9d+Di&uSf@SMN3>qS>ds$|wQ*F_k*esJ?Oms>GuA>DB{ znb@+W=ZNJ>XdJVWcpi)T=7#oNy2vax7{-`CJW2K(Y}-WECrvell`Bv|SsXjC>=G-c zo{oNh?yw@`x=Al$+ytmgQ)Mp=g?U*bjWI-s6^9h1wAKPm zU;L(cg4)>QiqQ03^;YGXB4iz=!{ZQ*G>3NLd?CS*cJREQ>OC4Ie z%!aEbJaza&fv3pUohROrtl-AAPD5efd7|&w=gPhMhWuB@8XcZbI~=bZW!)9a^KC&D zxw=-t?Trh|abnnaqJ*UEAfC zK!sYWfu?kWhpw~6j185eH!b8~*`&|k(&F9ERi=w;C*C5BMEo}2k)<}MxVjY0R{IK2 z@FpU_Q_%#?4i9R}?-7GxsZs_Fb`2nAh?q8k$&V3#H|EngnwyfxuQZ01%r%zPl`4$- zQ3A1^8Q|I?D2!nUL0}RIp^#?-3KnU##Rj9zWG&a%*p#!&@H(;w8R|+!6AUiqU~DSK z4vZioP$bF4z2v+a{TbVzrGfqxrIe%)-Fs&Mh9y$MKi~=}t!K_#p2q`@OOyMTuBgKD zw5Jy~pfsxW@?d9QFdKq@dK#jUc<3_rSmmPn0!Q`+z%Ya- zvzFDN(!4vrz|*QVX)UoHyEjA1^b@Udg4#*IemQwy!SWhRK0WFS02gIa!nvgyCf*%O zWz0hdZmb~<^;KDWI2I5DSU*dtrjqOn^*a){n#Vt0Ng^-cOj6-!SWp^bEvF z^>lQKbDYI_aMi*hTs}FmtFpuNWL#IvAZmigFx-r%G9|q`Z*E{p8!NLdRpSFe6h*p{ zQ?rQjIpqbP+B-u9nB$?|2>a(j$(H}ZaPT>oo0W_+)V3b#^@z;b;YwPuYt`Bd|~#M5&n+A?cd{W!dtivk#yXw-6FZ!f9j3b?q%Sm1fg-TNu6OJ7ws zc|{b#af=!X^w_gQc}JLx?#} z=I&Y}>a1T{k4R?3NcHTvwuHUg$1{pk=VFZ!I2o&U>{>fln$6+y-EkPkBoafZp$hhr z{XG$u$QIgj8Wx^IVnM6>z^8Pcxl1Y}2K~f)d{1X43NXn+o9x`5A~tz-y{$;*;N@PY zcfOWGM_o|%bYvc$v)X`|xKo16)lOf8M? zpS`4d{J!ScKx7In9qe$BjOr}IsW=Yv_Fs|NzwFZTf{ihTVVO=-0sFnZj+iRXq2??r zA3A=6W}tFGU3MX(nE|L(s0SKwDG(%ZWOdL&OS3F>rz%#mg&WKwvqz8;p5$& zFQTnimE?T~=wM*OE`N9V6G*tbpO{@t=g}WC&AXB6KDVs@CS)mNI4V6q$B=`W(r@1l|W*lA01& zKDC{oJl9~~a?R>ebn@*884ka`J7O(!cyQJ1rp0<2s({1X%U+i za~UZP$;Gf-1S`e7OoR{;5h@nLVhJjiAR=P8@nKkd$IK^>{csBbm!9p5&27$PIF6;L z^pL%^FVR68Lh1@iq5se)o@5fyHL0ERR!q+L=Tl(Wf&I;|@Rx8(y?W^A4Hmy?cHK#H zy#z*u=lc$|uglD)^rg8ylL;DhUC-{TxpelJ2Ei5rIvjd;U!bkzvaGlC5$R;H>&Vr% zgs#43GMXi`@O)y(@$Lz#*Sr*xoJ)flT03~?Mq8|C;t|0n4a)6$ZGXaExq3_kvUnZ| zc@{_aU3ys!HaR`nJi`Rqd$#pKgGKY%kwy-lLlP0Qr+Ia8+%&5?JNt3+ZQWD}FweOL z`Xe+GKVByADTG0c}-MUX*Pg zD|lsvp&NVOzGh7&ES;P&uBXHE;bX@Tsa#cEIb$7&nGET6y?QX?s8~6PoxwaWbF|)G z>M_<;PI3L1XXx%-$2Q`Z(rS|^U|*a*wrGhB*PLAu3rfcC|6q>?XfUrhQ>ZL5ZL#ma zeipB)uufu~xIpkU-MjC^dUif-wB>f44#$Z-J*%MBIhWK;(Ks@ejrR|B^#p6GwQ`$n zitFD~HV+tF7ZULMqVWVmhzTkXhcxA7X4)~hu_N~9NV%q_wnQgEMt!toQetmJtV?(+ zl%pSb8sO-UUV{3L4;Tiw5L8HYrKY-4aV6rD4xVsv8eUr9L9j?Xe2LVdFQ3@Fg}i`a zi9s*cYiG0rF@wQmG9Bsf@WZS^m)liv;^9@~!OD5(2<|u;zzC|;$RizHsc>wqyl?i> znyCzJfk~w{0|s?9yD%d!`s85Jbh6sM{pzM{SLJz8aRdfLWl*xc9S+=d<_HZOCv~)4 zt>|l5Tr+i}xDiC8QJZZBkxoDLeNU4<2rHFJ$V4EuMNZ@R+@mTXA`!30%w6c(4W;LFU&(=ib7E^9p;Cz73 zqz~=v-l18^$R@!x(Nu|Z-*^@$gJ#QUO_mp1BpWLku^* zw{aT4>yb*&I)!IU0!&e#SbhBzo;nnD#hAPXRs|9?+IH|qwJDWYXf2#(fZ1)|-?53G zOBLA)qrp61H@Nls%gi%m7Nfw}p@N||_eJ|{!{f;d3gWfjDm_uLuzouIyb)VBWvw!& zlS&-g)3Z%>39B|hiRc{njw@GKadqLM98VcMAL$)LANOxc~g+3i{&K7radFaUfl{6+u@N~nGWXFNd zE$ND+1=z=lJ~@0ma&>xV(~5Hs(-4?(aGdi**X!QWR7pc2RUwmVa%{fpGApXM*aL#H z@z|mL{rf0e9Y3^ku~Aa!$vIO7&oDg)+BRlpQKpJ)QK2cL~nXqVi-Cf1@E0&j@zv>Hs zF|2Aq%}TBri3MOXRouJd#;UZrq3U8&-w9HHNLVL4nNTWks|_?*CYNq;uygTm6q|#Cqp+ykJL4dtgk6BJ&-KF*}?zCQ{<1P=V*B>pZ*~jMKx+s zpsPP9FBxY_bL zm{5s0W7c9CgHo!J6H-aG{X>X_GMS`k{-~FpQ-mpq>2^B7(|d8(uFhit25>yo-0Av; zxcyR7wxTRB{S1fDTYo6!urA}J`SjZ{bXE6zH?OrKdB)%92{R-EHRv&+0E`dt4Es{t z>vn7#UR_&hmWe(#%DsWK&3^bhwPe0)kukC8``hiuORmVRg96-KhQg?{h>A-RK4r>h zm60|bsw&nKS}lx^gnFGUfR#wmoP65FW@eCK_$RxN4RCEO<-D~hzECIR%ycqkfjG|0 z`1*i90@z%+Lb_>yS}KVuPcj?=(*_I^N@b;niM6){B$jimfpId?(3O&IZRJ^($3F`U z$N!~Q_EK0smx$!MXtV$Th|^&Y^U#nfZf&e8)s8HG@)2qY-j+K z?)0V*5kAyq^cTLs=5;$RyA$i6&5-1GQyd2>K1sEX05Kg8#+!tP=rbKzx z(*-647{=u?n~KeJwfS-Vso{Ih2+u2BZOa>Ecs`+Df$O%<#lC~pmR4E!3}xns6Usc} zgkR(Y)7-xX@t2sYvf4_cN_4sj20N4r$u>JRj|gk>8tn+mfI?YHJ8L-S@(O6-Y;9S+ zRb5srRV#3bINQiPRdYRK6#pl?=7gp`=?~0Nb9s#^yTAao)enZae=>D76(&#@0hY5! zEv3~(?**jY-jp7r)FKEKWO!;h?*$kj7o#p%nQ(hRC08gvGXfaK6bh?>fV-O=j0%#- z&v9dDsv&W_W_Ere_LmP|`@1>o?#H3WC+X4RKzb|;j0$Wy0= zFHQ*twbjFZ=+R{Ltojlly}7**BqI=mUKx-Z-*AbY-e{$amEad?7EKEi5#Y&fI2t>k zw3HPo-a@LkI@k&KN(&SWT%);UdBtkx23)YuPPo z0;{O|>wr9-@9fo!k7$N_t_S{ov_@LrWHrdn=@gojc-&OEaVXnfogbjqHLW$`-YENO zy2MnZ1lPErLi;*YyVuQJgeC%9aaWM}v#+?O<`e2W0=WN03SvQHX;0~*pE$~%?Lh() zc8Ub1fSDq|08lrdQ)_uHS>{Lx_ICz>C{zoUlwZjn5xKh|{;an~9vLdK=<+hw{uKLC z)MzUDIP!3rPUM7MiHp0s`#%_TSqAGip2TOP>lPX+f-avEfbx!9RkR3xj|aqSiN1h z_ z)Gl^(o>7B&nzE$rQcWH!%rG4P<`9mTmdj3RI|cGxWt6w+8($p2&eI2SQb|zU3%&5~ z!j)+K+{O}lUcI5<;cBQUdCXUopw63&-Ra@`)m3`=$IU8o09GNs zx3sB5CmH+I5-6-!NidyZeMH+n6xE`%hRAAj?&}!<5L;i8`$s?i3e-?pUw)j?bPa`S zWweaQrx|T(0clRtoGZy62%;|z5zoa-4$EpQs!JD@j$xSUnV4|`46qFhk>J^xLtkZv44tk~! zW36>6=@}wc0!cQiC3~V0Ma*BN5@v^ITVmhn;~$Tgt842^bh3$Pr&L1h3KBNPUm~B; z`O5Opa|5DGd876u_xB^z63mNh0#5H-Eq7thy&+ltnJ%bVH@nI_9&1RTh(#++sZAUG zvJO|gQcNn&Fj9UR02RvPe&*q!qDX0DZK(!S4fRT~Tcm%#FSS6Lnt@XxXpZ+JxOeT` zvrfgUq|K?RKrOc7VtuJrY>?w~i^myQbjArV02C03LcV!`Tp)?7Cw3=DhWDrW<01G} z2ljlx@Ita=zYlW7XpZ9un8y)FaIo?stHDKD8{>4?gDF`NG&10sWoqKB)eYvchhk{< zu`e*SRi&D<83S-%)GFCKZp=aj%H$WejU5eOrv_r&BmMF{%EpH3V!3#tb4#bcP8pt|`=$vHZ-(hT3< z*82l}f4%NvY_$Nz_}xMFxs{S#s%02R zT33j9WJtqT)SI=kGhSDMWZS!3ccC5E+K_39y8;qPvCvSQ-R|PI(?&{dEHx@65)r7! zoH02z4ROzck4KW`#mp68kPGeh(B<*wyDP^u^&T9bqPe~Z*PIZwkjem|f>m0TO0GZ4 z91WI(d`TuAP4KaZj*ishvAOb0wHlQY@C-Nh;D)grPqPq#O94zq*+iO2mS##8L&;@ z^AuOhK>mPaa6CU0=l0{IzC{U=7)SSso#E;)OVSQ&o)ZuzL{KN zB)8FtZsKg(vJ#_WwB{F3^B%DK7bH4AZzWYzxK>`0;!XtlBMC_ttBOgqs77m4ia`G4 zzCH^VrT_zgMjr2Qep}YQ^enb|M2ZqL)EDLV2hoF+Hmx>lb*dtzh`^9B7OQN1hv5PV zDin+{p}=B1utZJOs9}`|!jTyyHU@=J+)G(mI1m6>b+cT1WT6&WvbZsd=uHiU^ zfafWXd-I_XLZ{bUHwPv}x&5OO$z+`y{p>l4QJtHU2_)!5XWLJ0{$lxLJ&K?p#YldW z19~}bMllqoDJ??kP+E`DI+RioyqbX31f&$faty+d+-pRnN9M_n;z?v5Fh2X9eepaf zZw$DhT(+ANd`Qz!jOG*6hwm&BVu>(|^}@qc_MerwN|j^15mQ4~ zkp4xWvUXPG7~Q^biVe26J!tbzUh$Y>Kso6Nv%hc_m(8jh`(u(Xpa68cpjf^o$Uo;%c{Mh3 zkxC=QaCEFa8yBnq17c~`(c1n?tNU~_;fXURLj3-;$_c9(g&I?;jY>icG&A>o-hhmt zS>6|?)3F$mh-k>@Tv24cimKECHJ|JPa0bAg34zOxG2JP=Eh7&iGK!Eg5(O_+sHHfl z7xxbZ>tfwsvL>f7gmNYj$hbY~##y6D&`GQtgw{zH)Rd_5%1~#7#CneZq%x|L7T!nz zMLg`GpAQu!i^|JPDgwL^B9O!ZZ!D6vigaTrvV!F>T$BJk&+Hl3omB+W-zG{Rz077Md@j73QpXAq1@OATmmCo%N1FmpJ(Rb{7 zRf(zemL?B(lKb_5PE^xqkWc!e+6jvD1mb+iSI>CY=n@V3tnTE#D-a~huOEaq(q(#E znIWIyRloqcBAHBo_t*69xkZz>QcG8edC8;bk(L!%ige&H&g~v67qS2Yh9Z=t`{>W> z6Ch_&H1AJw?Q!ftl<0(X8I8HhC{s(a3yv1>?tmNtxk55rZ-7h&gO-$gfjrfuV#=f( zc)}-7jDh?Es~sXCM+WUpVnBCYureq$sMK-11Q=VUODDzZ0!w>qULT%byDqg@H^Wrt`FR$fzS2HwUf zKb?I}hMyJS&1V12y0Cnl#X4E*Zz^lh^lkKHyC-eAn>@tHa7^T>~S{@W1aA`zjV%)MFYF3j~{_ z*bK#j&oVJ?)Jnu60>d#-`NAeTy)#>T9rP!}gKgg`i&khRzhxj#K;7kc?S!{-u}L*f z^Ev|fouj>hJLu!LR*Yu^I4J9p4EI7GvJd^9HbS$%n!4rDG!#)-$)>c*)sl^3s zjsRKY38(1Z_8;29rHb*ikb@i78DySvDEx+Mt3@LRmbVb8yC?)$U@UlIRHU!(^GfHX zrkS;L`5_PU+hjvion_(=B(R2UozDA2ovVxU6O1&?@9{yeNAzTIWqHxLR}i{*0H*eE ztK-M2jzy;FDKy?B`{O>Nsd3im6Mx4-Fv%p_PyD1jSdc-{AZL0a+&Z7URa|B&Dbk-b zLI*ffL%|g1cQ1s!muWNAYIxjnF@dz~a2eKIue$^xRHxcnNIs|NFMSA8&n1BFPR_-iu*si zwy3&FN)+Ik1hrPBTK<{?FQ>dEiZRt;LCx15=l;?o*(_}=ttvCA3Ngau0sL#c zVNh&(-6L&rrPO>zEr!9f_tBMR7wHPHzZ%eo${MRmv<08JJ_0x!&~=GU`>IPUiTNs& z=N|O}DmNjLf3X*OJYE5n*I6w(IVcu+-k{N$NF=QB2yo}IHmSJ;OFCU4s>q;g^^t-A z&m3?RHfUs>kaquIqFR(z&wwuB9Ukb2ytc$J)=1Ik1YDz5Bj4tRtD#WQxh5t>GTbYJ z==1SX-d0y-RuUI?kMG$KVMr8{1st9x4OhTs!?AEYz`aOSmY3=ZRV$K^RyvfSct>F#jIJUr3b3N*Zd)v@#&QXZabBS27W1(aX~+(}9e7iyIC`Qd*1|d&uSf z2=lPhR90UN1U|QGMgnpYWUSes49SgqlFIEaC>~Gh2u@BQu?+W8Km2dHs;IWwT#)h8 zqe7sFQLosORN0;3diiKWGLsbdmYsh*U~w7isw<4DY?o8v(>BEd3@J4#hbN4Yfi$8k zHtX920iI!iLZ(rOBT~a#1DuAAmdLYSWA3{tCzR&?IHWaJ+Qu>UXcWM&p$g^JflQ+) zp%I_?>M{&}&;3XhV^g)Q zNLGj@uCV}eRj-z|L54&2*eq#Aaa!keistwGpg-9)$25)Ql@^1lkiF5TFvYQ;`JmgG z;0e8gNT*4;&hYw)n9v72GXWLA-hR*JROcO5_M8FLCIgO#K-Ktt^`aWHd@_o^FGevv ztv|5^ie#rg`GZmBpAK24qN1e4pgLF3X@L=vB4-0&j=8T^gqE3L<(Zzo zILZC4M;5U)6>G=2nBBBPvAj1%NeNUdn})vYY+FT?jP~?=UGH3A{J3Gc#m7AF&BnAU zF4ik0lim+E>4UJ`Za2%G)yI9ai|&sI9`Fo>gP`63UEy#4yumjG5#3I~lj46Bs5VuV zP14f|%B~~E>4#dsS>n@u=m$qhen)_KkFjEw5+Ec~e97lK&KPHP9{Z2da6u+pkB&Xc z{VGylR%Mx_ZUIpL8|d?VN8VODs(A$7(uoNCPTV-4sVditL|9?Ml7PaQW}v|kr42im zqOK*Xv_+15bfqbV|A#|))G)tt@`IdT*d%DkW%qv$Yg?jYJSph?koL?PD2<4ec=PlkUvIxx_bZHQE(%YqP^JXXKEU84kE>C;I(gfKIHj16iz@jd|*sHSrf`E(d3^7mJWo~_yt)%e7a{!=xW*9CQ%eWlA zxtW1mEo6-jR7c?#dieL{bL(w7p@ukdKn}O}`HKDBc4={0xkaZGjic{>+z8W<1kOz~ z!}fO#-AeRbQ^HS8?BC81`!iqV?Ahg$J=qqR(N;%vzWS_6U zRW_Q;q?S{LgZ{Tu8n0fUkxj+u5@6lBJqbC18Z{GHk3%4bJ5KW*&A+OPo-A4g#FJou z)Nd}E(=d*xllcNHT)R6l&wKDI)tm%}vkgLN?)3q92U1>EVNuGabg30^_9V$fQ*@C^ zJfmjn3yhnI2(ZvbcM$>VhP9>YVCBLG2aSil96RB<*VzESd)Ui#h)Yz`DH_`eOj(^- zUXoooS1@V?z^uR%ri!;5S-C1WB*Xt>P$IEaPJ#LYfNNW8k{wddd1DCmr?{8;pr6=F zn=MNl8q2kcDQ&9+fU_yYScz65sILG(5a5do@cdhKVr_lH|3<4{>xa|yq-b!Q91nSvLQqXE8CSy`r=y48MA1gixH(5on2q{mZa%7ozkvg;VtZbKg^hHI;qeRdmbag;L7UKM?A*EE;3WN zG7?O&Pk8iZi($$J1CD^B@T_WcWmA2nNg+tDzzjhU;ENPsUh8eTP{o1={gsb(Vf|5# zEl_J?jO5lu^(Doc+_u1Zi&ly%>Sq0Krs+HF+Q0YW#{zsL!%d`^&>a7o1IKLD(=sz# zf@fD{&TR+?%m9QzSQk4q%LihafZcfsKXgkeW0G}!XH-*7)UF^()gVnkdY9e=qzFnc zQl$6Z1R*p-3!x~zcSNdmq=`rkEz-=32#Aybp?4CH5+EeG_5I3^2Z2M$M}QoUImxJC6mWgv0WTQ zGfzOt{-Ioz+S@js{=JFc#^iE>_4bd4v{BWE6rUY?pZi6;v!$bEq>R2rNq0AM6TF)3 z>#*Z?{A91B5zv`0g+lKyornQ$lR>a&MieG`~fC zmgMZ|A5#6W740X;l3YWBpAQZ$%d9hd?*G7F=K*743qW4iyLJEF7fxUlCt0&f6p?Fm zMdx$-=z#O3%42&cjf%OaW=~&EUN_0RnjA)-xY|C9A}0P!HuU%AkOXEZxDQM7AEI7?j`7JL0bc%{c|%l3}T#erYO+pv!6 z{P{L|jk2g?E`IfZD7m3wu5e+S@wnW_G)8y9L`6#i+4rI-A3Tq|!oziE+Tx*FHR*cBs_v$`zlM#owZvP3Rh#epry`l(Nl|julZtS zaa4V@hoT|y&thLdD`cTkey2P?%Pl5aaFGE(BV}IuJ^G4b<5rL~RaBDc_eC9C`S7df z;5#Jxn!$o3!z9hs%#Y2i9eMV)aq?1_Jk~GkM5#`#k}N-f=<1}pahPe4bU(!^ zaiYFe?R6gBpxKS}O}+4k@4T2hBqSuFS|mgajQnI&1*U4#!d}zfh2ovYDk>@*_BYS- zsTqkW*S&74kqk#U$p5QPLQ+L^Gf)5jQq(aekdFxz98H_z{P<=FH-j*ej38q3P}$v7GevAAc^yf46-IAiJcm?P0&5ilrN9v>bW~xq>GMHVS&@{CCF9YP;r8;x#wZYd~ z#Q*S+Q|8|Bd(^nr`XhqNOIni z`;5UsX~i>cy~9P4HxKUM__TQN`LwilrhlhmyNDr~iY-HrZskt*`rhYv%Y2I5$LOz$-Na?kH=W~(jV$M&GxSAFtzL!fg~wf zGtb`y`^LRW^j$b5Dr?=@SX*=?zEt4{E2N&*iu=Q?(Md`0OO=T#TTK)HD=6kZLmuLL z$FJ|QY>bj%hi%fDa*v5`fM}-Q-i9Fdrzp)%C>jb#Y}9_7J#(C{tp+++6v@*@B75HF z?FULap-Hh?OwbV6+c&N$#Cd#)BF>!nJ5{@T$IPkl8vd?&foWo|67jUnmjF8d0{f3k9FW8YoP zti#MJ%4|v$^f}n6>5?vN^G$4RP5;a)ad69l(o}t(l+wKxFLe2?uEZgRsEVNx}b<@TCV9pzzb6D@;liA%TJA&uRK+o*<-F>?yH_l9Q z5I^U%L-B3`Tp3zq83H?gyOH#8lCE&3wm}=qhQok3|2VP@%48iLrwp}&oqe$e!7K-k zLh|=^&gi`yFS<@=lD{Mx5()X#@CtCz?aelsYkLgLo7E@2=hA6l(0or$z8*7SNR_Hm2DB;5Y;_S-KYq=`mTD{yy-R<$EBWCEJs9JI zdvW9mR3igY6D6mhu8hurptQU>Il0N9HvS@OXW7FiE{gtlOm>PTAsWv;kRw^TM*dzHukpkSJ6S~ED zHOL`M^bb*=Z{W>EJbBqH8us@X$-@>Bzl;8H_<`@7{dn={@~nNSZ*o;<0ryhI{>I?1H<7&D(;xZ&8N%&5+YAmX98xR*yT#_F#n82U z<(;{%kT_`dJpGU1ncE~RtfG)?-B8fs{*H1)1&r1Pvn5{*pI+!e(2k`K6mPAoa;JWq zouMZiiBm2nPxb2nyMx9;;$2&tR^yN}OKS&&`3E1HOYTND#; z(gww!6@_wETE;ua*?|wo8_W7f^;HB97N&DX<~)HBA66M-Z+J(q@%GsjfG^)> z8TiD!fx;Ke<#A;)7xE(7ghZ;ht>jXNd^zkQ2DEUStB5#8Ez={vY^F;0Y_;KVtTNzh zT(@VK0mQgLv{u5IRWp;u)pNbl9y?g%q-bsA5Q@lzgv3{C&6`7#CoI2WE0KzjTb4%r zsUx%^F&S4BIove63c>N~aQJqON0ZMVr-t!&&%p8dx<39+FTEbtA(#AXPz&g#fZEl~ zpu#TeR7>4J&F*VBgE{M5C!jE_unv8Dd@U5KaQjt2_+^T{efL*K9#Vbxbu6wOvMZ9n zxP~aZ=)2lQk@~82lPXq zO@V}5PMskhUikLlp{+jbbIwm^#OK^hL+R)txsf*|-~|bf9QgTX+e%$3{5H}$;-sOT z^lk6yf5W%8)~>WZ%hEd;@Eq?y+UONmr|zifxJ&-6buW={y$6*nPnR+zT+JZ+PA+1n zLib?^g4$6pDSJrkA|J&8!pkOTT@ri&buKHT#v+xkB2KpQ-nLT zRsIGLj-DP2^u4huCwV<#_q_IA-pJo}d}cvRGthbo=l!gwBAuFD{2IRVE6NgXmgx6; zu7l*+(VxT_Az5fE6Tdh}06g?%7`3Hu#SO;`?+-bol#SN(a+Jp zPtD9J@C(qAVq5!#%~TFDt|!^{keSL|k9Z~BdqjB;!Mnr5hYEm0lv|UP({0i91%hor(PQz5uJxi|zjC7@|<{93UjC6*E&{C)}a&iG#au`##oQmDPu`7PN z{tKT!jTC#4#pHiBlP618xSp`_RFIFI$oYifPa}H8%rvplw!5ckL@Cf|VsKOF_Ly2g zUePZGu}Pus!5jIIhxbB>>&mC_sk!HR&4?F6ZKzZ{L{bvZD7*8ULfWj67NS3VFM zA0d>T>@E@?~gf0_6)h zDg@ayUZujsyw8w+C;m@=3{QR3;iS>tm~=?rv}AnfOr2I{7#n*U$||WyIG_W_WyO~} zS@JM)0HurFHvEsa>-2sXIaV^a#k-G6r=-&fWyVwU-Qy+!NYqO6n(mpr63)F=f-PMR@$*jl6UT}B=oAx#wM62{?f7mD`P9i3>8HlmJI;)$_*18<(Vgd z^EVl?a>z6yLCLCP7CP20JRA$#l>P7M+@{Dxqc}|{KFSrR@CbC0X}bi+)W*ZV;|6Lh z%1UXpGhW@3jQ-I~ru%08Ya?o^{#55NOq?-U$n-+c`QxE z3sL>yX_|r;Tn~*~fYBS|>1bg+2Qtbs@xmxz?eluk1CrlaN)DA~d;TF32_)P3-Z=6o z$8;=p`RqQYe2xpX3{zP!9q)IY2kfMn$QXKmZOP*PO8*3tR8?s${vXDUz9hzv)u{_s zcxePuoVjR-=d&IpNB{%IH4Xz)vo+Gkl{7ng!E-#Y_-<4V+ z|AfmRxmo?QeXE3OVB)Qt+Z*JPMg2p6AIv|ylX}NaE>YjR82^~~BO;7Xa<{_5e~Yrh zlli&CX>zS1?XibNokubIHMfY#db9+1W4(koM!A6!P+*f54kzmS9 zeu)jkTEwD2!8kj29+-wIXUWL=NoVL%nJS{)h=o1*ySV7)F_C$)73K;{l^3-*Zorzl zFMijV8;UEon41_J{k3Aq^{ex&=8?NaOElS~vE=(;It2VZ?lkI<8csuLUaFz{+ZVmp zc0zWr6BHaRnmLjgQ4QO~1cN2aPo^I&{H7VE)&6B7pW%?sy4?0t2rhC+U!qJVSr zUZCKmcWPU0m`i8vYM~WY#V=m=?9o-X$zyfj3E0q}mfO!tWAujZLQ|i|6@Gf!G|PUU z6v_tTqX%_?3)>I*q=a+ySGia=rZkVM)ttuog=Cx68s!*LpxfuQn=hb0ch{=l)TGb16$97S7>6wSB^Ajn5w{pD=p@j?`!=k zz8twZa_x*K0D+tcQ|UT<(#k&ssmIl#Hevfk@bV4)g-UZRoD z{!U=tgkBiBm+C!4_O&q8*UAd1ceWNM7?3qH+hVpfL=;Yc57c1i6g0Aq$7#zd>bFO8 zX__mhdVm8nCC@@dPhfHI_V=d_kw+yV%PW0W#5IJ?*O2H}O4 zmy3U;w0{*Gg5(=E?5>_359~clGe@SZ4KLs8!{L&wg#tHVX}DGxy?U@B!-4MA$22?+ zv%kEYv07P#?`U5FtQ)npSV-=5De+T^eO$hVoaqDapt_Vm3tjW0Vf@S~{O{b#%AljeQt2g8p3Ux)qG` zK1rylUNEE4eMQFkh4CJ|5$fftsy(;uY14J}qcY{|p#Q|nS{!f4@kVF&~^X*d&l|)Z!_>rI=p&vPf(~{SHvo*MQ(6P z<3`!f<3pUt6Ut`+SdrFxk!4O~&g^HX)2?^I@KtBwAA#Rih07*09=cMC3r}Q!7TU5^ zR_Nw6?oh-wTKtYrUSPwL6aAr%!yFpC(1IP@*;LO|5pWb~`eK<#7hhgxm6`qMKPOi? z+Pru*)1UxU&k1TzvIxOs4TgybeGp6%Zj%MS<}DK`G4`pcsjUd!sCwjE*IENCaGN~% zAadBNyZt12Sp!E-6f5Q1H|s49-xJiylum4M@k}ss`z(|6VodU2AFSm3G zH&YED1H!H`4?+(`+GiQyDQEB|d+2`_-XaoSI#i+hrh!WfULra+W(z>~9OoN_gX$MYg66j~NKFpKWBjH)tj z#-D(eOY^v&Q2w!l%)jue&2Xq}W6-dH9-Y_E3f}l4Z9N}+0hUc4jb(}?EdKrP6za?1 zelQqn1+{$q@MOi;^6m>m#@M(g#9ML<*KmIp5*TB&3XE%5l4|6HEIRTelJLxX_}zf} z5q;ts%gEF2)caG+99o~OE{w5}OSeaOx~$SOS6hFHCj$6y+uZ-}m_=IBk4eK2h*}l1 z`0%re1U~G&{d`S>=3WfTibXC=Jll0XmGzP5$zaG?<@`xek#Q9#tB;SbcMbQK)so;? zM+sn}ce@aP&MUY|Tuy|Pb6%I!GDj))r~ab4xME?{{K2E2bU<+}(uo+70L51H_-va{ zqo>>~MI^*y{}Po!+xg5PIozwncl-+l)%%cC_%P{+VR0Pi5do;vub)msGJbv@-5Nas zGcE|BQ|~WuzQBo$Hz$Po;$at`KwAjyPZ!Qsr8 zo6Q7;ONDOe%IE1)9nLpF$X5;7#Fxb1XkbzACn6Z#f<0&re;;)5Fg9<&wisSW0O{`c z5>w_IQ<89<@NB zBr(ff5;7hai@X8Q3Lp|X;&&u=ku(hVeO7%{Opz>-uVAefX+MgeJ2JQjAtqKsW>dL4$UI&tJSa)72$4H1-)skOecTHZ?ATkNpIONqn22hnfjztpXMMB-!SVgm^>x*|q821%rqbM?pvYG!DEv(=%D?YYBvi=|qP zDiLSLAhYf*!sD9- zk*L=YwW0Ws;(~V9rh_+D&%H0G8#hUJ)JEKUFu>N7CTj75gD)$2czT5xT6~buGe8Dh z>2C{DL}@94E~#>e3b`YTICwKkk=p>bqMpI$RcntES9gDpCPc4#d^?PC9xU6@+;;So zWQOx`u$+b{E}!y$GNn&6;d<`J-I{Xg!gFdQaVvrRBBuWl`@9Z+Ia@pbspEyXU{Nxd zWkK(T0AGpb^(9ITCdH$-kvP0BUSsNX0A$}msJF*$$@aE3!STOK2pDVR#g%Od6q_P4 zqWp)p82r~9c{QQj#6G|75rH1Iem3m}xbORt&Yo~w0^SxvLU!iW`LhWO(-^gC?Kr?f9eAi)@=)9bgAdzWj~O?_BO3~n1ka2K$mUR@1K zJG@4jKRYSZT&`ACYF`Y*Jw!n<*gmj4^Eu%-Px(5n34HdmyKi|99=YDL6xVynZr_RS z4fE{@J!H3wAY3%w!$5Z77$kP6T833j?}nFq_Qe%vj_TSUr;RE26J%~1aJypz`3&Eb z-bcu=k02!3Us>{4bFM<6B7N7(<`GATJa7zu#5EKhv561sJ%%A;rQT}~lCc!ccjD(K zmcx-{hB5~NMO3(h{SxfCz5kHI%F*zXcJR}WqmAfsH<~ouu`Kd>YZl$JU%X^H&=^zL zdpV?lKSD{5T>YcS^NIg5tVE@nC6J-~?>ZG16EHh)B)$ZBeK^@?V`c0=#A+XLRYJi3 zYzSCh>Jr(WI<_H1&Elbs=HefNd`909j@=0bfgPIC{%dlf28=_;L&@}>^$5Qts{dIFrIrT4XLR2G(K6ZM=?qqRt zsW9~`>$&EaAr9J;>s64!l2^Z)f1FndE78^iBq8{!xg= zD$B%*pqVz1jRYW;W5Qu10TpF`y;9hYJnkG9DgHr2J4{3*XJL$pr%KDa_f!FLF~VBX zhmj(gTkFKwh1)#E{9sm>>7knl*m#G4Y}<#-nw|*tld`S(*~9btf@j+y#{y%`tOx=W zPZH>9IzQ@oE7r058#M5yn+ShnDVU_3#`UQ(>Usea!OmsLP$R1#ajbe|jV4_62-03? zWtuD?!U)^S*nVz;+k?f@S!Qh;cN(j( z$p{wA;?iXKe#|`uMn|E|3uid`oF{`z-)y_1It~F42sC{8tORE7$!q5br(crOhuR_#yTHJ>pXWW{Z1?2AW|2P6FH$`wi_pN}J z9(Bdw%QJMtB<`>?g%dPufIsQ$sG0~r`w9P2Rh)=hjbhK0{=*y2hE#!jOS5~o)iwi&Z^CPq+d4qCbbllGo{>XR97I;(!Q)Sw9) z^Y&f)Vcpl_i!LT$Cm-UEkL;(wfgmnaSxX^)BX$sTR1r*V~IjmFF z{D2Hc0Y+w_P5^%EbMNaWcExb?L`3&sZsAka%5pIX@B%flBs$<=sJlwU62~Pl%*S>; z<%_}G2Y&@llN6j3#2K*6V}988oebzUsTsQm2()zO*@NISLd%!4%2!LP1MBQP?XKp? z$m+;1ntb7X*So62mq{^Y?;y=@P6GPE!f`}W#bhKe!tS#$S*~cg7J;yDWL3f4%gdoF z74-&+$1r>J(`e zBr064z`{d-@#P4N$cm?uE0qwj(gY%0tRlpGo#y@{ogf53+Qpdt&oi#*Q--K3YMblc z7Vn@AyiIc(1g7Fu@#m_V))eWimU9E5VZ!QHwrm!H>dGH&vdPb$oqg}4HPPQ38~~0j z>dx8)F)@SQJA0;<6$fwBQY%|6ru95;-t_WmNO$R3b&+RFZc%Sv3Viu%U9VD7H0>lN zuLQX)lTAYpd40Ih<&@z3%kRs%0@i?KFR1j+j|cyvAO#xBQF8rkGW2gNhP;|=-ekDr z&v%e9b(RF&ru9N$VYgM9w?%v7k}AVG9_MomSqvB{S5MMub6Wgz@d&f{h0$C1bu!=% z`ueYV5}k*Jk(F@y=gn^!=X)(c9gh3Wamih{o{(dfAsCV{-^Ci&)Vb}|Zu8A!^#!mz zBz>ZLWviRM*O|YZ%c%L%oPf<^kUjZS5;5D4gC2B z)j!=?m49y#Tb`{#jSf)Q8152mBS0cflK}VMLe9OAA8n)AmfFHFKO1~|k2N@I13_#q zGE$oKEUjKfsRIxk%wPO_|lfDu9@(*ahY_LNZtrr@XjpSTPb+H z0b>u@Ha~pfaY?lWZv6n~sVxw)I%Tfn-2}!$@&FJY2kkB;8x|5gk`rw%p<|Ygo|=aZ~SN zor%lIJ69&Q7yZ7GlXi)Wx3$c-^;W-C#0qXgVnt?{|(yEVnO*{Z<6z z3J1MkEB~Z0WK&_*h)@)hKX2>oigOXXynd1d^!t|du!1Bz<-ys81>eIY7slAK=Mtlh z%W0(?o-2H=?$`Grl>Rh7a#`gHIjKuTM7SZ`|IR5m`uPz3Z-ky&KrW;M{BN1O!TT4~ k4*xe|`2Ut3lSbo}9gn3@*Z=?k literal 0 HcmV?d00001 diff --git a/docs/media/single-dimensional-metric.png b/docs/media/single-dimensional-metric.png new file mode 100644 index 0000000000000000000000000000000000000000..f2bfa54b05c7fac2971f5b9c09972a7e9ec44492 GIT binary patch literal 20867 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�v<))^2H_xQ6%&z* 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 Isffh<2Tubxr2qf` literal 0 HcmV?d00001