From 855c10a724b480b8f75462b90a1a7eb5a0be73c6 Mon Sep 17 00:00:00 2001 From: Yatharth Date: Fri, 24 May 2024 22:37:19 +0530 Subject: [PATCH 01/44] time space complexity --- contrib/ds-algorithms/index.md | 1 + .../ds-algorithms/time-space-complexity.md | 227 ++++++++++++++++++ 2 files changed, 228 insertions(+) create mode 100644 contrib/ds-algorithms/time-space-complexity.md diff --git a/contrib/ds-algorithms/index.md b/contrib/ds-algorithms/index.md index 5b52155..9a0d556 100644 --- a/contrib/ds-algorithms/index.md +++ b/contrib/ds-algorithms/index.md @@ -1,4 +1,5 @@ # List of sections - [Section title](filename.md) +- [Time and Space Complexity](time-space-complexity.md) - [Sorting Algorithms](sorting-algorithms.md) diff --git a/contrib/ds-algorithms/time-space-complexity.md b/contrib/ds-algorithms/time-space-complexity.md new file mode 100644 index 0000000..79a072f --- /dev/null +++ b/contrib/ds-algorithms/time-space-complexity.md @@ -0,0 +1,227 @@ +# Time and Space Complexity + +We can solve a problem using one or more algorithms. It's essential to learn how to compare the performance of different algorithms and select the best one for a specific task. +Therefore, it is highly required to use a method to compare the solutions in order to judge which one is more optimal.
The method must be: + +- Regardless of the system or its settings on which the algorithm is executing. +- Demonstrate a direct relationship with the quantity of inputs. +- Able to discriminate between two methods with clarity and precision. + +Two such methods use to analyze algorithms are `time complexity` and `space complexity`. + +## What is Time Complexity? + +The _number of operations an algorithm performs in proportion to the quantity of the input_ is measured by time complexity. It facilitates our investigation of how the performance of the algorithm scales with increasing input size. But in real life, **_time complexity does not refer to the time taken by the machine to execute a particular code_**. + +## Order of Growth and Asymptotic Notations + +The Order of Growth explains how an algorithm's space or running time expands as the amount of the input does. This increase is described via asymptotic language, such Big O notation, which concentrates on the dominating term as the input size approaches infinity and is independent of lower-order terms and machine-specific constants. + +### Common Asymptotic Notation + +1. `Big Oh (O)`: Provides the worst-case scenario for describing the upper bound of an algorithm's execution time. +2. `Big Omega (Ω)`: Provides the best-case scenario and describes the lower bound. +3. `Big Theta (Θ)`: Gives a tight constraint on the running time by describing both the upper and lower bounds. + +### 1. Big Oh (O) Notation + +Big O notation describes how an algorithm behaves as the input size gets closer to infinity and provides an upper bound on the time or space complexity of the method. It helps developers and computer scientists to evaluate the effectiveness of various algorithms without regard to the software or hardware environment. + +To denote asymptotic upper bound, we use O-notation. For a given function `g(n)`, we denote by `O(g(n))` (pronounced "big-oh of g of n") the set of functions: + +$$ +O(g(n)) = \{ f(n) : \exists \text{ positive constants } c \text{ and } n_0 \text{ such that } 0 \leq f(n) \leq c \cdot g(n) \text{ for all } n \geq n_0 \} +$$ + +Graphical representation of Big Oh: + +![BigOh Notation Graph](./images/Time-And-Space-Complexity-BigOh.png) + +Image Credit: www.programiz.com + +### 2. Big Omega (Ω) Notation + +Big Omega (Ω) notation is used to describe the lower bound of an algorithm's running time. It provides a way to express the minimum time complexity that an algorithm will take to complete. In other words, Big Omega gives us a guarantee that the algorithm will take at least a certain amount of time to run, regardless of other factors. + +To denote asymptotic lower bound, we use Omega-notation. For a given function `g(n)`, we denote by `Ω(g(n))` (pronounced "big-omega of g of n") the set of functions: + +$$ +\Omega(g(n)) = \{ f(n) : \exists \text{ positive constants } c \text{ and } n_0 \text{ such that } 0 \leq c \cdot g(n) \leq f(n) \text{ for all } n \geq n_0 \} +$$ + +Graphical representation of Big Omega: + +![BigOmega Notation Graph](./images/Time-And-Space-Complexity-BigOmega.png) + +Image Credit: www.programiz.com + +### 3. Big Theta (Θ) Notation + +Big Theta (Θ) notation provides a way to describe the asymptotic tight bound of an algorithm's running time. It offers a precise measure of the time complexity by establishing both an upper and lower bound, indicating that the running time of an algorithm grows at the same rate as a given function, up to constant factors. + +To denote asymptotic tight bound, we use Theta-notation. For a given function `g(n)`, we denote by `Θ(g(n))` (pronounced "big-theta of g of n") the set of functions: + +$$ +\Theta(g(n)) = \{ f(n) : \exists \text{ positive constants } c_1, c_2, \text{ and } n_0 \text{ such that } 0 \leq c_1 \cdot g(n) \leq f(n) \leq c_2 \cdot g(n) \text{ for all } n \geq n_0 \} +$$ + +Graphical representation of Big Theta: + +![Big Theta Notation Graph](./images/Time-And-Space-Complexity-BigTheta.png) + + +Image Credit: www.programiz.com + + +## Best Case, Worst Case and Average Case +### 1. Best-Case Scenario: +The best-case scenario refers to the situation where an algorithm performs optimally, achieving the lowest possible time or space complexity. It represents the most favorable conditions under which an algorithm operates. + +#### Characteristics: +- Represents the minimum time or space required by an algorithm to solve a problem. +- Occurs when the input data is structured in such a way that the algorithm can exploit its strengths fully. +- Often used to analyze the lower bound of an algorithm's performance. + +#### Example: +Consider the `linear search algorithm` where we're searching for a `target element` in an array. The best-case scenario occurs when the target element is found `at the very beginning of the array`. In this case, the algorithm would only need to make one comparison, resulting in a time complexity of O(1). + + +### 2. Worst-Case Scenario: +The worst-case scenario refers to the situation where an algorithm performs at its poorest, achieving the highest possible time or space complexity. It represents the most unfavorable conditions under which an algorithm operates. + +#### Characteristics: +- Represents the maximum time or space required by an algorithm to solve a problem. +- Occurs when the input data is structured in such a way that the algorithm encounters the most challenging conditions. +- Often used to analyze the upper bound of an algorithm's performance. + +#### Example: +Continuing with the `linear search algorithm`, the worst-case scenario occurs when the `target element` is either not present in the array or located `at the very end`. In this case, the algorithm would need to iterate through the entire array, resulting in a time complexity of O(n), where n is the size of the array. + + +### 3. Average-Case Scenario: +The average-case scenario refers to the expected performance of an algorithm over all possible inputs, typically calculated as the arithmetic mean of the time or space complexity. + +#### Characteristics: +- Represents the typical performance of an algorithm across a range of input data. +- Takes into account the distribution of inputs and their likelihood of occurrence. +- Provides a more realistic measure of an algorithm's performance compared to the best-case or worst-case scenarios. + +#### Example: +- For the `linear search algorithm`, the average-case scenario considers the probability distribution of the target element's position within the array. If the `target element is equally likely to be found at any position in the array`, the average-case time complexity would be O(n/2), as the algorithm would, on average, need to search halfway through the array. + + +## Space Complexity +The memory space that a code utilizes as it is being run is often referred to as space complexity. Additionally, space complexity depends on the machine, therefore rather than using the typical memory units like MB, GB, etc., we will express space complexity using the Big O notation. + +#### Examples of Space Complexity +1. `Constant Space Complexity (O(1))`: Algorithms that operate on a fixed-size array or use a constant number of variables have O(1) space complexity. + +2. `Linear Space Complexity (O(n))`: Algorithms that store each element of the input array in a separate variable or data structure have O(n) space complexity. + +3. `Quadratic Space Complexity (O(n^2))`: Algorithms that create a two-dimensional array or matrix with dimensions based on the input size have O(n^2) space complexity. + + +#### Analyzing Space Complexity +To analyze space complexity: + +- Identify the variables, data structures, and recursive calls used by the algorithm. +- Determine how the space requirements scale with the input size. +- Express the space complexity using Big O notation, considering the dominant terms that contribute most to the overall space usage. + +## Examples to calculate time and space complexity + +#### 1. Print all elements of given array : +Consider each line takes one unit of time to run. So, to simply iterate over an array to print all elements it will take `O(n)` time, where n is the size of array. +Code: +```python +arr = [1,2,3,4] #1 +for x in arr: #2 + print(x) #3 +``` +Here, the 1st statement executes only once. So, it takes one unit of time to run. The for loop consisting of 2nd and 3rd statements executes 4 times. +Also, as the code dosen't take any additional space except the input arr its Space Complexity is O(1) constant. + +#### 2. Linear Search +Linear search is a simple algorithm for finding an element in an array by sequentially checking each element until a match is found or the end of the array is reached. Here's an example of calculating the time and space complexity of linear search: + +```python +def linear_search(arr, target): + for x in arr: # n iterations in worst case + if x == target: # 1 + return True # 1 + return False # If element not found + +# Example usage +arr = [1, 3, 5, 7, 9] +target = 5 +print(linear_search(arr, target)) +``` +`Time Complexity Analysis:` +The for loop iterates through the entire array, which takes O(n) time in the worst case, where n is the size of the array. +Inside the loop, each operation takes constant time (O(1)). +Therefore, the time complexity of linear search is `O(n)`. + + +`Space Complexity Analysis:` +The space complexity of linear search is `O(1)` since it only uses a constant amount of additional space for variables regardless of the input size. + + +#### 3. Binary Search +Binary search is an efficient algorithm for finding an element in a sorted array by repeatedly dividing the search interval in half. Here's an example of calculating the time and space complexity of binary search: + +```python +def binary_search(arr, target): + left = 0 # 1 + right = len(arr) - 1 # 1 + + while left <= right: # log(n) iterations in worst case + mid = (left + right) // 2 # log(n) + + if arr[mid] == target: # 1 + return mid # 1 + elif arr[mid] < target: # 1 + left = mid + 1 # 1 + else: + right = mid - 1 # 1 + + return -1 # If element not found + +# Example usage +arr = [1, 3, 5, 7, 9] +target = 5 +print(binary_search(arr, target)) + +``` +`Time Complexity Analysis:` +The initialization of left and right takes constant time (O(1)). +The while loop runs for log(n) iterations in the worst case, where n is the size of the array. +Inside the loop, each operation takes constant time (O(1)). +Therefore, the time complexity of binary search is `O(log n)`. + +`Space Complexity Analysis:` +The space complexity of binary search is `O(1)` since it only uses a constant amount of additional space for variables regardless of the input size. + +#### 4. Fibbonaci Sequence +Let's consider an example of a function that generates Fibonacci numbers up to a given index and stores them in a list. In this case, the space complexity will not be constant because the size of the list grows with the Fibonacci sequence. + +```python +def fibonacci_sequence(n): + fib_list = [0, 1] # Initial Fibonacci sequence with first two numbers + + while len(fib_list) < n: # O(n) iterations in worst case + next_fib = fib_list[-1] + fib_list[-2] # Calculating next Fibonacci number + fib_list.append(next_fib) # Appending next Fibonacci number to list + + return fib_list + +# Example usage +n = 10 +fib_sequence = fibonacci_sequence(n) +print(fib_sequence) +``` +`Time Complexity Analysis:` +The while loop iterates until the length of the Fibonacci sequence list reaches n, so it takes `O(n)` iterations in the `worst case`.Inside the loop, each operation takes constant time (O(1)). + +`Space Complexity Analysis:` +The space complexity of this function is not constant because it creates and stores a list of Fibonacci numbers. +As n grows, the size of the list also grows, so the space complexity is O(n), where n is the index of the last Fibonacci number generated. \ No newline at end of file From 34e349e9f30329c5f0dea478ca41ede8f2bcbc9a Mon Sep 17 00:00:00 2001 From: Yatharth Date: Fri, 24 May 2024 22:40:06 +0530 Subject: [PATCH 02/44] graph images added --- .../images/Time-And-Space-Complexity-BigOh.png | Bin 0 -> 17286 bytes .../Time-And-Space-Complexity-BigOmega.png | Bin 0 -> 15822 bytes .../Time-And-Space-Complexity-BigTheta.png | Bin 0 -> 21022 bytes 3 files changed, 0 insertions(+), 0 deletions(-) create mode 100644 contrib/ds-algorithms/images/Time-And-Space-Complexity-BigOh.png create mode 100644 contrib/ds-algorithms/images/Time-And-Space-Complexity-BigOmega.png create mode 100644 contrib/ds-algorithms/images/Time-And-Space-Complexity-BigTheta.png diff --git a/contrib/ds-algorithms/images/Time-And-Space-Complexity-BigOh.png b/contrib/ds-algorithms/images/Time-And-Space-Complexity-BigOh.png new file mode 100644 index 0000000000000000000000000000000000000000..510b4d8117ba9b945e8a18038861fc6256dda749 GIT binary patch literal 17286 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 Z&ui$-5@*Z6^P;ZvjG$c@YnQk`q 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/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 IYPlr-ALFsiXaE2J literal 0 HcmV?d00001 From 6db3d06e0f50d1c7bf28b43d6149c39ddff818d3 Mon Sep 17 00:00:00 2001 From: Yatharth Date: Fri, 24 May 2024 22:46:22 +0530 Subject: [PATCH 03/44] graph queues in index --- contrib/ds-algorithms/index.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/contrib/ds-algorithms/index.md b/contrib/ds-algorithms/index.md index 6569868..4f458f7 100644 --- a/contrib/ds-algorithms/index.md +++ b/contrib/ds-algorithms/index.md @@ -2,6 +2,8 @@ - [Section title](filename.md) - [Time Space Complexity](time-space-complexity.md) +- [Queues in Python](Queues.md) +- [Graphs](graph.md) - [Sorting Algorithms](sorting-algorithms.md) - [Recursion and Backtracking](recursion.md) - [Divide and Conquer Algorithm](divide-and-conquer-algorithm.md) From 485c508e4dbe68bde1a3842ca6f030f0e2c072f1 Mon Sep 17 00:00:00 2001 From: unknown Date: Sat, 25 May 2024 12:03:10 +0530 Subject: [PATCH 04/44] Created datetime_with_pandas --- contrib/pandas/datetime_with_pandas.md | 117 +++++++++++++++++++++++++ 1 file changed, 117 insertions(+) create mode 100644 contrib/pandas/datetime_with_pandas.md diff --git a/contrib/pandas/datetime_with_pandas.md b/contrib/pandas/datetime_with_pandas.md new file mode 100644 index 0000000..7b8c720 --- /dev/null +++ b/contrib/pandas/datetime_with_pandas.md @@ -0,0 +1,117 @@ +# Pandas DateTime + +Pandas is a robust Python library that is available as free source. The Pandas library is used to manipulate and analyse data. Pandas are made up of data structures and functions that allow for efficient data processing. + +While working with data, it is common to come across time series data. Pandas is a very handy tool for dealing with time series data. Pandas is a strong Python data analysis toolkit that provides a wide range of date and time data processing options. Many data science jobs require working with time series data, time zones, and date arithmetic, and pandas simplifies these processes. + +Features of Pandas `Data_Time`: + +- **Parsing dates and times**: Pandas provides a number of functions for parsing dates and times from strings, including `to_datetime()` and `parse_dates()`. These functions can handle a variety of date and time formats, Unix timestamps, and human-readable formats. + +- **Manipulating dates and times**: Pandas provides a number of functions for manipulating dates and times, including `shift()`, `resample()`, and `to_timedelta()`. These functions can be used to add or subtract time periods, change the frequency of a time series, and calculate the difference between two dates or times. + +- **Visualizing dates and times**: Pandas provides a number of functions for visualizing dates and times, including `plot()`, `hist()`, and `bar()`. These functions can be used to create line charts, histograms, and bar charts of date and time data. + + + +### Installation of libraries + +`pip install pandas` + +- **Note**: There is no need to install a seperate library for date_time operations, pandas module itself has built-in functions. + +Example for retrieving day, month and year from given date: + +```python +import pandas as pd + +ts = pd.Timestamp('2024-05-05') +y = ts.year +print('Year is: ', y) +m = ts.month +print('Month is: ', m) +d = ts.day +print('Day is: ', d) +``` + +Output: +```python +Year is: 2024 +Month is: 5 +Day is: 5 +``` + +- **Note**: The timestamp function in Pandas is used to convert a datetime object to a Unix timestamp. A Unix timestamp is a numerical representation of datetime. + + +Example for extracting time related data from given date: + +```python +import pandas as pd + +ts = pd.Timestamp('2024-10-24 12:00:00') +print('Hour is: ', ts.hour) +print('Minute is: ', ts.minute) +print('Weekday is: ', ts.weekday()) +print('Quarter is: ', ts.quarter) +``` + +Output: +```python +Hour is: 12 +Minute is: 0 +Weekday is: 1 +Quarter is: 4 +``` + +Example for getting current date and time: + +```python +import pandas as pd + +ts = pd.Timestamp.now() +print('Current date and time is: ', ts) +``` + +Output: +```python +Current date and time is: 2024-05-25 11:48:25.593213 +``` + +Example for generating dates' for next five days: + +```python +import pandas as pd + +ts = pd.date_range(start = pd.Timestamp.now(), periods = 5) +for i in ts: + print(i.date()) +``` + +Output: +```python +2024-05-25 +2024-05-26 +2024-05-27 +2024-05-28 +2024-05-29 +``` + +Example for generating dates' for previous five days: + +```python +import pandas as pd + +ts = pd.date_range(end = pd.Timestamp.now(), periods = 5) +for i in ts: + print(i.date()) +``` + +Output: +```python +2024-05-21 +2024-05-22 +2024-05-23 +2024-05-24 +2024-05-25 +``` \ No newline at end of file From e140e97690b7c06e9e3e31401c72a25b85995865 Mon Sep 17 00:00:00 2001 From: HimakarC <116370824+HimakarC@users.noreply.github.com> Date: Sat, 25 May 2024 12:06:37 +0530 Subject: [PATCH 05/44] Update index.md --- contrib/pandas/index.md | 1 + 1 file changed, 1 insertion(+) diff --git a/contrib/pandas/index.md b/contrib/pandas/index.md index 834d1f4..9a7a103 100644 --- a/contrib/pandas/index.md +++ b/contrib/pandas/index.md @@ -2,3 +2,4 @@ - [Pandas Series Vs NumPy ndarray](pandas_series_vs_numpy_ndarray.md) - [Excel using Pandas DataFrame](excel_with_pandas.md) +- [Working with datetime using Pandas](datetime_with_pandas.md) From 1744d12d8e160aa480399af7f354b077bb8797ae Mon Sep 17 00:00:00 2001 From: HimakarC <116370824+HimakarC@users.noreply.github.com> Date: Sat, 25 May 2024 12:15:49 +0530 Subject: [PATCH 06/44] Update datetime_with_pandas.md --- contrib/pandas/datetime_with_pandas.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/contrib/pandas/datetime_with_pandas.md b/contrib/pandas/datetime_with_pandas.md index 7b8c720..796df4a 100644 --- a/contrib/pandas/datetime_with_pandas.md +++ b/contrib/pandas/datetime_with_pandas.md @@ -4,7 +4,7 @@ Pandas is a robust Python library that is available as free source. The Pandas l While working with data, it is common to come across time series data. Pandas is a very handy tool for dealing with time series data. Pandas is a strong Python data analysis toolkit that provides a wide range of date and time data processing options. Many data science jobs require working with time series data, time zones, and date arithmetic, and pandas simplifies these processes. -Features of Pandas `Data_Time`: +Features of Pandas `Date_Time`: - **Parsing dates and times**: Pandas provides a number of functions for parsing dates and times from strings, including `to_datetime()` and `parse_dates()`. These functions can handle a variety of date and time formats, Unix timestamps, and human-readable formats. @@ -114,4 +114,4 @@ Output: 2024-05-23 2024-05-24 2024-05-25 -``` \ No newline at end of file +``` From d0e9b353f7aaaeecf87096aae77c6a560755ddd0 Mon Sep 17 00:00:00 2001 From: srilekha279 <158455553+srilekha279@users.noreply.github.com> Date: Sat, 25 May 2024 21:17:23 +0530 Subject: [PATCH 07/44] Updated recursion.md with example to explain the working of recursion with simple python program This commit updates the recursion explanation in the recursion.md file to be more beginner-friendly and comprehensive. The factorial example has been revised with n = 4 and stack variables have been included for each recursive call to demonstrate how functions are called and how values are returned. These changes aim to provide a clearer understanding of recursion, especially for beginners, by illustrating the step-by-step process of function calls and return values. --- contrib/ds-algorithms/recursion.md | 43 ++++++++++++++++++++++++++++++ 1 file changed, 43 insertions(+) diff --git a/contrib/ds-algorithms/recursion.md b/contrib/ds-algorithms/recursion.md index 7ab3136..67c630b 100644 --- a/contrib/ds-algorithms/recursion.md +++ b/contrib/ds-algorithms/recursion.md @@ -17,6 +17,49 @@ When a recursive function is called, the following sequence of events occurs: - Stack Management: Each recursive call is placed on the call stack. The stack keeps track of each function call, its argument, and the point to return to once the call completes. - Unwinding the Stack: When the base case is eventually met, the function returns a value, and the stack starts unwinding, returning values to previous function calls until the initial call is resolved. +# Python Code: Factorial using Recursion + +```python +def fact(n): + if n == 0 or n == 1: + return 1 + return n * fact(n - 1) + +if __name__ == "__main__": + n = int(input("Enter a positive number: ")) + print("Factorial of", n, "is", fact(n)) +``` + +## Explanation + +This Python script calculates the factorial of a given number using recursion. + +- **Function `fact(n)`:** + - The function takes an integer `n` as input and calculates its factorial. + - It checks if `n` is 0 or 1. If so, it returns 1 (since the factorial of 0 and 1 is 1). + - Otherwise, it returns `n * fact(n - 1)`, which means it recursively calls itself with `n - 1` until it reaches either 0 or 1. + +- **Main Section:** + - The main section prompts the user to enter a positive number. + - It then calls the `fact` function with the input number and prints the result. + +### Example : Let n = 4 + + +The recursion unfolds as follows: +1. When `fact(4)` is called, it computes `4 * fact(3)`. +2. Inside `fact(3)`, it computes `3 * fact(2)`. +3. Inside `fact(2)`, it computes `2 * fact(1)`. +4. `fact(1)` returns 1 (`if` statement executes), which is received by `fact(2)`, resulting in `2 * 1` i.e. `2`. +5. Back to `fact(3)`, it receives the value from `fact(2)`, giving `3 * 2` i.e. `6`. +6. `fact(4)` receives the value from `fact(3)`, resulting in `4 * 6` i.e. `24`. +7. Finally, `fact(4)` returns 24 to the main function. + + +#### So, the result is 24. + + + # What is Stack Overflow in Recursion Stack overflow is an error that occurs when the call stack memory limit is exceeded. During execution of recursion calls they are simultaneously stored in a recursion stack waiting for the recursive function to be completed. Without a base case, the function would call itself indefinitely, leading to a stack overflow. From 5dbf1f07cae3eb5c0694f1a9019a23693f423414 Mon Sep 17 00:00:00 2001 From: HimakarC <116370824+HimakarC@users.noreply.github.com> Date: Mon, 27 May 2024 10:49:15 +0530 Subject: [PATCH 08/44] Update datetime_with_pandas.md --- contrib/pandas/datetime_with_pandas.md | 49 ++++++++++++++++++++++++++ 1 file changed, 49 insertions(+) diff --git a/contrib/pandas/datetime_with_pandas.md b/contrib/pandas/datetime_with_pandas.md index 796df4a..d87d9ec 100644 --- a/contrib/pandas/datetime_with_pandas.md +++ b/contrib/pandas/datetime_with_pandas.md @@ -115,3 +115,52 @@ Output: 2024-05-24 2024-05-25 ``` + +### Pandas `DateTime` is Efficient than Built-in `DateTime` library in various aspects like: + +- **In pandas, you may add a time delta to a full column of dates in a single action, but Python's datetime requires a loop.** + +Example using Pandas DateTime: + +```python +import pandas as pd + +dates = pd.DataFrame(pd.date_range('2023-01-01', periods=100000, freq='T')) +dates += pd.Timedelta(days=1) +print(dates) +``` + +Output: +```python + 0 +0 2023-01-02 00:00:00 +1 2023-01-02 00:01:00 +2 2023-01-02 00:02:00 +3 2023-01-02 00:03:00 +4 2023-01-02 00:04:00 +... ... +99995 2023-03-12 10:35:00 +99996 2023-03-12 10:36:00 +99997 2023-03-12 10:37:00 +99998 2023-03-12 10:38:00 +99999 2023-03-12 10:39:00 +``` + +Example using Built-In datetime library: + +```python +from datetime import datetime, timedelta + +dates = [datetime(2023, 1, 1) + timedelta(minutes=i) for i in range(100000)] +dates = [date + timedelta(days=1) for date in dates] +``` + +Output: +```The output is very large to display and taking more time to display``` + + +- **Pandas employs NumPy's datetime64 dtype, which takes up a set amount of bytes (usually 8 bytes per date), to store datetime data more compactly and efficiently.** +- **Each datetime object in Python takes up extra memory since it contains not only the date and time but also the additional metadata and overhead associated with Python objects.** + +- **Pandas Offers a wide range of convenient functions and methods for date manipulation, extraction, and conversion, such as `pd.to_datetime()`, `date_range()`, `timedelta_range()`, and more.** +- **datetime library requires manual implementation for many of these operations, leading to longer and less efficient code.** From b819dfeaf7af4ca999fce1fa74da124b98bbad08 Mon Sep 17 00:00:00 2001 From: Yatharth Date: Mon, 27 May 2024 13:23:28 +0530 Subject: [PATCH 09/44] figma drawn images --- .../Time-And-Space-Complexity-BigOh.png | Bin 17286 -> 12856 bytes .../Time-And-Space-Complexity-BigOmega.png | Bin 15822 -> 9438 bytes .../Time-And-Space-Complexity-BigTheta.png | Bin 21022 -> 13438 bytes 3 files changed, 0 insertions(+), 0 deletions(-) diff --git a/contrib/ds-algorithms/images/Time-And-Space-Complexity-BigOh.png b/contrib/ds-algorithms/images/Time-And-Space-Complexity-BigOh.png index 510b4d8117ba9b945e8a18038861fc6256dda749..f7480941bc597a9bc6f8f2d4efdd0d8075ffd429 100644 GIT binary patch literal 12856 zcmb`uX*?9(7dV`heT(c{ie%riWeZ6tO2)o~?Ayp5M#KoAFi6%=jAg82U$SPGvJNq_ zg&|FrX)OOc-{14nPg8~3D$3TlyK?C=ExvbK^(=zL zRbPA%qhz6;3HFqdl%C)iqj}RA91ux&UMGl*Bl795O@~(!PAp`B2lTc&&9wKIgXre} zsb_x@iAQcCD{p-oRUSLMhG-`G2kmozN1cuhoxKY}38f0^#bo7mqzUR>l!XfEiAF|> z=^0bgS?i_fKUvaGF*#3emQuvb(U>BL=iu&6Sdbs1c`=gCubr{fMdKoCiBwniH zShmIY=iT7hUrV1~&cf-r|1|Jz?C)JEY6)j(4(E%6?Qc%Tiq3gY$2$O3(&*;PKE2;5 zVTIl^fqsU-)@X>s&dW}zEFiGx<%F!joq1)Jq-Z{Sj&%>}{)45W zIYB|{p;t{)fzdbTw7IO%p6{CMM9pk{7{9TKnW{23T5s{dB%}UYZI6DoItcVfHN){b z=N37~1rJm*zbPknE|D~CU4Adr4Rz~XD6U-VD_@#PF^7Vx&qDM5J*Zy=-G6e3n>g?_ zEL7UGIIlrVoiQ&{dmpzhw0ETInBn+YVpC%24We58II=u)SOYErgETG(+@86lmB`vt z&gHCmS?slAF=w|Vg>+vhbzw=K!#pEQE%`QyL4y|l<%Gl zefst?LhQ5Nl1@d zv^7Z!IkfyUEu7?{Ax^$-ksv6-8_kChw|ddZBr7n(m%fd1(uB13G5NJlDc_%`pOioJ z`@8Y=c<{ty-l*X=zoMA6-bBx(57D;sUE058vs-xyieUANbQX&V*q4ko7-1vlgah0Vs;Cp9zd8Fr(&GiZs9lKNw$ zY!frpS3^GU!dzz1GJsvj-m9e-QLQP*S4$0nJZ_$@m@m+pgd#pCuvLA_qo4AA_+XB9 zS_rK5asd1qZ9>rx7)Hl9oFv2B`IZ1N@s#Jwj1khFM3VH^?1_vCMQq0h4FuKzM}T7O zwT>}9T{7V9_j4rT+4Jqt&pO81Bv@_7x8DzU+t}Ik9%0=BNyKmDdZ{RqzC4lf%nQbk z6pf*CXh~8qq0gXiRK-%*+yA-4ATLSokvxuapyg_aHwkNb*FoN=Tv<OC z>}z{CfpsJXnEz&6Ra^LJnEBiCuOyx;z4LCda#@Kh`*yXV9Z3uLJ~RC})J+QhH^#vU z0AiyH570i0hzffZbrLUdo1%D*^3a zCJG=(yRqikVc9k}h!!M)m4rv8*;_FHDVVh%C!nS)N7(ppt(-4qCV{@euuBf#tPehp zVgFMm`Vw#(m#_He(5Hj9YbqSQ3N$W4mi^DsXJr70T#8-36sjTPDLmMTD57v|KNwBq zo=we=3hnt34Um1mT>!a8FOmCP)auVEkpOv+0?^U39L|iMO`>XahzF}?@@{}5`FnI$ z3<6aJI`u#u-A?y%*q~CX0IQ?TG6Lk+Bf$8`BUjh2 zNKZG{y&1o;RkPw9z-JaYx23B&n4}+ovt^ME1pN1c%5F5Ajj!U9J>d1`i(uEVz+GEc zSNj=v65vQw6@6@`vdOaAemmGKoQ*3E45{_(Ji1vY?I|w`@HJ<; zx%zIrp_jNxa%uro^b%;FvGi=Ew`!+dv;>ITO)y$da%?+_b*?cL3xzjH&SKTob+3CM zH89y&0B|{w5Zfo`W1vmjZK?z06~Y1E0r%2KZaaR)aTi?>L%MnO+3@v??R$68D^d}A zJXWkg?P=N2C&$eJv&nhkYz$YRzG;I%-}*G#U$#;7+FuUtn8uNCFBS2_-&k<0GSv(^ zFX_9t&M>}9g{gL%rUInyb>I|53#`PTI`|C#`BGW@Hz;^8B^!Nz`Ud;lJ`Kd{NA6b^ z*mvMyiuB`n3rpPD+X)|qk4t0#Da2=*6_jn*9<0B_6teZhQXXuh+wyX|rRB|M&5XQ- zUNkPh>-x?B9E6Jf&9K)A;U zfcqo^Dt>GCVM0Tdb{)B1^Nlh@ z5K?8?{o4JRtTB49v+%w{-U2ZHwsAyP=ZblgO>3}>%JaXjFnL-mal$~#X-pM=A6DEk z@?Oz}6rL?+iIba6WcQF`XV+?v#swM(uAWqLO0S3CNJHHHe=mLZ?1s}5tSpX{)K4dh z4GL0lJX+VYzry%QcEqL6qkig)oAdlEhME!5ckG{+5TLRBqp-X`S!Nd7pt;{1ur>8g zG;l0eZ8l5ZqigFD*@7~oDmCCQ@&vkRlKH7EBkxhm(xe&w@ZQf__erE@e-bZtf1xF4 z%%pC*(uUTrAqU?;CzYojek)8|d)%Z}(R=>OV(8h4Or0=Esb!5L>jwj=-uSOQOj!$T z2EF!>(F(ddXjAoigbhEgDnAb{Nspn>dHU~VWvp-GtRG3#g7$V$J zgN>emqZjV!rmuZh_l{SGTo_(vAg?g6H;j!jL|x~^b&ryyjq^Y`@1jK`mHbFDUbXs{;?WLoA*c#1r`j$A zm*`H;iTmo{!x8n6eWXpncd84x{IaAnX0$Z4m?F-v_DoHlb!>3|acl9nD%}TI+s(%~=^IJo;4u#LAOY0>qy&v;|ow&vA3a$?er4(^{lZ z6v9iTB@j3G@#Dv?Nc{FYFHtiQ19|AW#_2WU-Z5c2HdR==O7du7m(F~Wfov#FW4lnu zyvdiD>48YFMa)5hjx4k|{zFz<_@+sTE5WCEY4=o;Cw3iLy&3%yOKqx^E^+H-{*nv~ zyo?Z*n${G6I}Wzn3*M00dDnY;!D6lz&Jgy$%Ga&k?rV-SBTZ0ZW|j9(s~0*EqE{uO z95#Zn8mEPmzlyEAZsA7RbeU54Bgl-Q;wZ5Nfg^RdKQw=aDR?8j~8jOLk4q zgrddC-gkZY^hmi#{6Xh}RQs29;-?6jgo16aa-?s;W8k7n@8IxtMy*6|^UFdHvS@P# zv2SWjm<_kw@;=FX%8SskeES-A)n&HE3HwDwbQT=+XnTh>`;dhyUMVr_(kH+{5l2;K z9SL89@p-UY5y>V=N{rlQ%-0mMm-eQbrk`;%8fyZpE@G+@3GzpRi;GKc&8<6fmlSMU zY7W6HOI;=XNxRE+E$V=HO;-!`Q+VE>?0nOBDF`*(=rTV!?aR=9U~3~*;_J9tW}sb3 zhWjAUy+(zv+ihimzs>nHsRV#S05HScy4$bN;osFa<40o*hr9onZ)kl2@ky}&=~#29 z+x{LD8~x@kSRJ*x1}5a7#bmu9mZwAF>R~e>mh>YrhHhZYLfXh+{0HF}Uv*^=jK;r6 zWc9S(xV-+vW+RP{+-&nR7#xZ*-0Zg zGNq4Z#m6>OBJ_AQqgIC$h(PomhI(d>@@}und`XYvQe=N1Vlg}oYYX&3|K6Xb$3)jj z`8&L2QAEx*j>mD+=1|#moBn(nQzjULQ`b#;YA~APXK!-;7W=JUtUaJ{AJAZ4_u$mG zeYPBpucy~BT2`Vo=SeB*5L7BEf67!tdgY8*wW|{K%4+02-@lA81h)aB(Oiav zRXT3INvk}H8Q7rgNTU%&sYeLPM-{YgMU>gKSr zwY+gQYQ%C(I0schDLV6#k`bQU^Z4=O*<7_yt<^y`-ZjT$J~gg2dwQ!$1ZyQ%Z2SQR zhXKHiGqN(H-NtQwNrvhaB_JG;kH^&1)St5h#o$98vI!n9O%^Pib5894_)En z!A=NH#%^e~-nV^f^iitL_|8I$;)U&M$NsMDtzX|hxs1XWYMc_t%772wj3?CJ02{FW=8Im|_TsCSu$<@pr6=Q;RH%AyE!{D!%7M2{R) z4iEe_p+S3ttIjxr!h6~LyB6!vxLpH5UepGDf!dDGr1UxUh933$^cvA4uQhCzFh`AD zq}LoOp$d;DG&qjypKvx(UsIws=aZ(KjqiOa$|^OvBM8rYhbn&8>&U~l8-}~nBkXEY za~!&~n1rvLcrqXRUK+M|TuI1bd}$gQCaL|(2_oNMlrz}w5`n{ZGYA-+(=_-JC2Vub zkASRNpFmMJQ5{40}QvMiKEr=Ne6E~o6M zsr-o~O)O&%!SZlAJ%R9VrYh=%6T@OY;;!S;_4vu+y6@ZZwi5Z=I+G;OvUcpeomI*~et=Yk z2_3njCY`XHup-0F92fNr#L&-90@&q)J$BnKDC9jJ!OlP_t?7IOcrsph<>?;4WsccY zJM`X5lvxhLi0Ie(%P-@=!M5?KV1{9-Y6s zt25J_VJey%`JMxws^~fMrbAxcejE(CEV4$x<*m@QKgqKM;KEFTM@Sr z&dXTJQH+f%YLbJpXq{t|iNM4uYaXlzj;_PIDgO}W{^xMMDt(Prw!+Bjr#dZNj~0z> zYLS)B8{!dQ{3||D@a|%4uZo?OB>F@;Y`au_VuiCY?#ka1g&_{(q>_)NC8z6)XW<7Y zp}R58Y(OXdUK+;W%^LUQG?2MFZuex{1*>@$an`NDffn+`B%3^-@V+{j)#24&{d^dc zdvX{tb_()Q+W02XyVh~rXnqi{&)<3IlrA4JgyvuKP&Q4re`MbvqKDeTn4jMe{d@l0X#z=wBng^1Q-rGIAp1154W8rK?v*ZQJ<^7k9oOWX=A9xaLB^h@UA^TU4o_RX94 z*1f0GO9_ejfF?ir{h3mZUgAIJxmlRm?PRV(At_b*g^Kndq1nb2iVO8D^`^HfRi~SW zUxOwnB_$W`!<0f~t)A^zFT&Y^c7Kd`FEq1y=PxHx*{t!=FMRIt(%7j+Yz}mKRehLK zW=3nk{^)Has9GJ~IG_IH3Y!0r%z~_LHOOM2jBI=!5%NVMb})$IbOKpB0xSGzlkNGP*q5 z*rt_n#eOR#QHHNC^?Fx2oK02ct%)6l_sc|&Q?!|O!fX$ew{D14yEv@8Ae0~Tk;;NC z0}(QqTI2v!$I32{*sM_tz%*sb@4sq4T23G!PR;3hnA|rLWmNl3-TBBH3QD|nE8@W$ zcjV&(8*WRwc*x-J5JT-^I%0@U^P7%{PPBwZ2faj*vka6wJ{(mzy!eCg_gmF%_dRTP z^36I9HX>AmxLsRWmex{m^}0VJkJ1}!MbX^Ms*Wi*n=u}+(Mx`4z3!uZSfcnNv%a9$ zlgivX;$%94m+g+sCl%KXH5bBj+X^b4`y$@7MD+r#N752dN*W$F&c-%uh-^Tx2ryz zxjT$yPN(yA9H&uq;L93!O7>3G&LFtM)Zbg)8v)v8qV_>&ZE3WSvR^wud)?}gFuLM>##jLq3!)m>46n0BL!M$B&N=i#hJ#lmO z*!?EB6!8(Kw^MMFTkuuQpNz37#m;h2Zs$zwN@IWEDGG-8@3y;T>q|vQn40DaRBB@B zt}xlLYVaOGedouc%df8wL>H0Pz_BZuX!71F8xVK-xdS3fu|w@k_NF3-S{u(a9=N{# zycl2b)adl>#FHh3;VU>EM{U|>UA1a2D_Ff!dHUKt<=0$|SBj|0ZpBI(X}Q`DuwBt} zlZJ9fQ~I*8?!TukD$v>B3po0n-J(k`3iqJ1{=pYO2D$U_Qfq+MYt5NwS}Az6@h!S} zil#uEkSOw z@YB;(MtrnO$iH7Edp>Ei%DaHO;av5Ip0Ops_)9**>JBi)OEni9J#k9j0W>yn;_Uez zm=)01UtlMne^|jqn(B!=IYC<5wD7n6v*QjAWu8+1@HK0EWTT~s_Rcn7m)6^NSyH&; zQkyV7?(pq8v((MH%sVrEFWSD+guz=9N}z?vSZ`~Kkwak-;3>7o%QEe)n9v0Uy|rU( zQ{xUy7sLyO49-`75oL$a+pKy0LJS{X7qJ15Jv13`HoFR2n_%q(`*QQ@tHToP7TCKG zTAQx)5Gyvly*53NV#A!P^IQ3>8kj6vR?vH8<7Tg@Q!dk$;_=m8t(j+;r&ks_1m)iY zsB%MFqGCiUxVyYaSs;wo@i?qzRHYkWtOsonkr= zfIsu{>?GP|V=5cdYqj^{Q8?+EqA#5lO=m$X_cDc#S7T_4cdL0XkQpqgFZ}z#VJPW% zugPY%z+mVue2m^oFNbcPtFWN=jPNZ_Yu~)L>SE*&OBAEVv2=%VyR4R?Lj5^EbPlmV zXrQw~gv;{3)TV9(u>s*-#3W{U-Yq4b&W24_4OBJkh0wYnuJ@r!XnUioXUl068^{&3(I=rX&yV8@5z%YoXq0E>wj2h5uz&J089yXf z>@}<8!pDaPJl>xU#uq>uVR#qHVX`Iu`l_d!Le~i-Bu&#;9;~{=ZK--L_FH8>Vjm# z$K`q&wf@wi34n-&UALOKX|Z6BF0#_PNj9QvE*%Yn2m9v>g1EZk4d#3 zs=bMQ=gWIm`!IfP#t#F0shSXXNO^R|?=0`IE6v#`F7k9W6uhD+4I&8*dGZk=P==V@ z{UU0ebs3s?Zq2m#I!$3C{?{jasu1iJ%H_W@&uEfbA;f!qCQ0DwLHX1w5mEHvySEk7 zByVi!W86f^i)7R_!+%ZTf1aXO=9>x(|6$kH^eBzAkVz4i^R8i^^_`+JBs8u4Jl+(2 z|Gx7mxxfTzn{>Ny;#%0|&F{lZe-uG1a%f4`lb&avJPA?}mbe2E7W8ZVhd5@mWOhp0 zhq-jlGSdng?NO7)I;ElxFP>+W?&st{{M!91#-uGYC4K@0y!Z5Nv+RE(^SOaSS#Sh@Q{)^~cDWNiwSf?ps5(Up(7 zOCGD}*2Q{+#&~S#>pvezCc*Z+p71sxJfk z=+FN^*;Rse=q4dwX-nYB!A~TQPPfp!H{xmM1Vx+@8Lg%3T0!V@T(QT!wiMZf{27@4 zsJ#`43I{2rtjrs~gOro@2M8 z)7)E`EOXof@JLKEgD?yF_=m%nzHY-3IaKv2yiZB1Svj9U8R5Nvri#J4+l5LHLFzP)(#vF>hTWu&4r^p&v~DIS@?hYi z9M++5E~wg6S$5?*_d4_K&@*m$-zK+9v8o`w`8S2TTn zb~s+}F5l*8?Y;f`u_$IVfiB+begJ>GkiSLoaf03P)sCxrZu*i?3##6)A*kc^2YtQ}k9eM_h zU^b09wD#o*J?7JZsdgCi26(N{(3T;1jnmU=`Yw1Ar})^k9(`q~Sr^IADFc88=tKbG`eYOJmJpUXy3b6`gnG_Lcc29V@z5siCSJO2qc#Yh=H=u+JwOB z58=&4FZl#Zk?x$0aN|?>kn5{>{4Nt@@~yJQorXs;9C( z7=ay*s>JYJ?}V8dGQ0Z_l&H7cimyJ^G-LUFcoj-$3SIylBSm=|eFZMZQV-j;xBl+F zkU8X}GAbCG&Iy!tEJ0;?4pn8{p%A`sOn`ex4|Tr(3j67P-GUX&`0N)sKI7AIA$8mp+SBIcr+K z4$C~(e<)LK9f;{~=I@_=kX@U2jY2XrB@JmQo+ZkyJ@m;akAYr>V_Cu=bxs-mJ}YZb z!RH50m*NjW5qS!4#`4SU!FvuImd-I=oLRs{P>4Y!x(D|H^z`3GVkir^*&oR?SQZ7J zg^hf~x;Qqf%7UZwr8DQEAJUWEvex-QL4iR4rmjNHcTqz7Zzb60TjW9KZuVU92h5t! z1PU06TXw+0Pfcs9Bwh)#m;%#sUSfC!8@k|dDVB$6`2mLE@}-&v?}aQ^xl4M;^W;HP zp$FU4WU@PI&E_#`tZ?0}W)f16}#`MzZV;sK485nN7Zh>wy`YJ;#4F z&hQ$s(;%KIm4&XqvNsmBF_lcNv3aH66xThFV_I%5!-8fIF#xJiiJIYXOjB!quq8Q3 z-|^`n@2lv4NH0}4XLd8J)#xhnDU4N=QcZ)mv-;oY9-9AVW%6Yx5^|{)?4={#cR^)| zP$|3i><*_GF%YuuWLD{B^cr>F?0a&G{?$EzUms&k7zXvQUefjsbn+IS5D#MuzG)t8 z{PCsJR1ArE#&hdBlv80H7o1x3oukpQ@2co6-I2gxwS?j<_3Yts8O2=lup?|Nqs{;3 zr(nV19jBj7KJ&bKbN+nBdrdJBCkk&e4)tOg3VhQ-^CRE(owbqo+-vq)_Qt1L}OXrvQTKs5_`PR_EF``$Fr+vTFfdI;?K@#+RO*~yfLV2vAKl>7YH;aK= z7A&$~R<}OiusEQXk_I}tVm^Fuig}jGIG0hR$1VT|sqq8Af z6t*+p^uOJJ6fE;dD(dOKi!AHvQET+IdT4z|=sz|y4VOB#1Fp9Quu2)@H#6n_x%G(*{X0Sf@7BpQ}(1nc15x#wlpBnyNnoj;tb z_aIoMq=A;0n8I)04W!yG+ctC|fKJU~u0El*Ui1AdU0VSB7-{iKgqNnvSS~%PJLa+R zT&8opZs5lrAf`hVbE~4y4?2{A{@DK3bobBBy`TNHHZ6fpU_;|xK^R8xIPATMFliH!20N`()Cy{2@5ncJP17fI zIs-QYD@wtd>kI;Teo#MzU;|y7cT(;6b@XYHFqTjy4=rAcTUcq9 zf$o->EFmo%mii(baP}aE0v%1eehg+Y@dDiBQ|mz~#!fM1TD=jrt)3|N3aC(VAB|bD zw5L$m0g~7Yy;)3<3d3Z(4EmI=}oqD znF&qC)H#29qvlwnIM6%g!aA_vq~*D`&>$t+jP-z4L%&pzqhI3}&;wk6sYQ1U-st#@ z!Kta76k}km(hHVtGDSSG8Q|ujsJtGJbz-PcBGrv`QnCg*CwrkDb|i%n2$WKs8?rla*B^hf}tUs+g%Wm=lrPhcsa^P^l zBO=6yRPIJJ{XDf|T*j)GZ2*^s4eA;j96JWZ^O#)%=zApS4ksnA2PyC5`C1=_g0c)$ zgH%aJslHw$i?{|0)O#rdot*w!sM}30#aP)Aw9CNQX;x`Hut>a3=fqc{t78teTZjsu zI3f^iexC%iT87+>Y0!K8;jMT!%1BcYb*{x#J=# zsAVy@0&`N6nK+gZVF2639rB`r+|`<>4*Q8M;SZqgGL}YPx(xKfS3ZlW37Vo8yelY| zjth5wav|&#O>|rHkX4v@mkvVTQByaA*ke}4XWW+;RTlg6CmqX2TTVRp4(B`~A!0Ml zr@58_{OYmOEele#jlp&e#8sEo@YlvY@pUJCW0M|KVQ7(<#>RLe;(K0XStS)G-~FHD z%8ae83(C9qZvPGKOe`1}3g(|z)UJ~;e;#Ak!SpM3jB`bygd;!f?B#}Hs{!;+yLb0Q znC)@S@A{+6qn73N<@G??dDtO0c}6m}Z}A1Hcjzdj?G)yFqivd{P-%O9i#nr-lFoXc zRjkI=ud#abDo;yXBnC(Jo-*u5|4W!+EyS!1+VOIpg0&+VhM&oCfCesGHf+6`6sE1Y zRUhlyu;|o5OpF{_{NPvjqT%Ps!E@$L;`5V4rnA1BYy2sEYdn>AyN<6|GJe52Nr4>m z7rW4WR%xtLYqDVl<)7a*(>#t+^Sf6XGy_I07(cK&V1*L3J_Kv*h2w(x@kPhO6)%QS z>Ye+h<7+-@;-|3X-7S~!;GFUk3C-RNHqb~{KQ&NN00P=8DAiG zKcDI0LR5XmuV24@*VrA=`$eQ6`#UG^#nVLsM;?=LqE*5TccyHj7d6dsp_u>R4;r6; z*VJ0_t^`5qMP*^YK}7!33lI2*b2=;CedrQ?rotN+@JubOT0a|zD* z$b0heB1>b~*oA;kN40fQAJ2F6b8NODeX`vDPHe$+S$9#3i&su_=GM!E{>KKn@7qa8 z1B0oPBSKz7%)Sxy)mCcwY=5|D$`wRg+W5QFsszLyDy=K(%T+fyrdBOGuxqeGmH4AO z$mytxqwu8Wd;^jvc>55s_r!qXb?u5lzQFX0yE%J)bUN z#fE$WW4y2qoECm8%)I=0%Sq)?n0iKD&Z5ZSz%*7!vl;XtA7A5#e7~nn_uCfi!}L}* zD*f*baT|U#W{NzKMi_sDV+=sP))MUek6Z3@xLn0c&>n>?9=3zX@*z!U_ z^YCxqy*LWHWFk&cmx~-W9%J)z$z|DPg}4Fv+=rUpqJ|eK92Q;b_13ANTs;=g`chuVNHe}39RYNS+&G;1Vv5V?4 znq%Fcnt0O18q@a<`d_9ieWqa&2;nf?iLo~k)$l%MpkQtB4&c7DVOG$G#n{@3jgmEt zoh3!3MjxFVayh+<*lNtbKOz2S32|3;R5XJoDIyC}>8(3SQ~I0ee#Y6RO3gk z*c^}Xg0Zr~q*Mf9$n!^Q2sQxbvnK?RLR_0%)#VSrZ2OE&$|`C(N*t!xcD$z8L47#1 z8}DZTSWYh1tTcGHdw&4_027vbK&qmhrwYG z`C~JcvcfaQ(&V>)9lW%M@p8vDcc~6$qCqY4S{}PDR0ju9p%$dM!)qo?784){RQ3Cx z4L_!9YjIdBPp?nk9YklIvE^~#tr}dzyHTmlGrT} zR3+IE^1q>iA=)30ynxrI6~SR-pT~6}Fb#q#=>{Vh36(fw|5pSGl;|u(=cDXBn^bSi zL1T#no{T7jed2~^(&T}!zyo6$b@sf4-)FMWjj-Kl+*>&*f&0gBx{d;dJU@gro*ntC z6L@}OMlU&zHH6C2XI6)Wn!gE=`$;=hMMeit1eUocTb}}{W&+j53l|qmgWh}uE@?j` zyV@ZzDTg6V%2Liw3&11D3;ktPh919JNl(XvKp?qck6rOV7mo|VSYQc>iNojLzucTP z4V?B+nhYSIlI&u4BYbW_vqg);t2f@=%@uXT^Sj!b*3E;%w?JsY$6td<4Jk1i|@QvkabfCk|lJTuC|5Jv&4c z`)l7~6sm_m@s$hkjO!0Rm-TkFUPhA$7|ssytc8iKPfUviX^~2ol0>(clVN0?I_18DKxg?d<)fKjr*#}$1)YPf#9qtt>Ih^Tv zR*(or!!KPlOcuhR%4|2~58Q4WLQl`nRxeLC2N7@3(TA35bUgP)&>%)e$_OT{79XX6 zvNXN4&dR~Z_O@kvND97s^)DIWyvCqHGa@NBlA`tG+zvEBla4GcoT`)MZ zU}Q6pbm1^rtbr~!x*~UWEY{Z6N}X35p)D;4XjpOzd3kx)x3>{RMU!&+Wyhuo|;I^MaRyL5%_p1x7qC*9mw)-Xr;lJ@q``>Nw@eZ zt(p*~ouz=mOh8109>MqF-a$2=??elYuS^|5UV6FP*Lf=MElNN@z|&qL7kBWp5A8zv zN$K966>T}$Tf3yRu4twou~?J|Tmvt7K=s3~fB!@m2IO#>E(~>7Q(MB)LHl1Yc*;XK z=ovYUN)1Ma79~aNq8iW+G15V%baIvx22Z(B;5DZ!#t2zIzd`pQuD!X5g0sPBPy9yBQJbs9!rU#NO*6jG;RM$7D(o zqUn5o{Fqd26TlH^{^ZRKgU6@&_ycN**l5Z<66W6j8(FPDAS)`(0k(I~oBkAz zVTq7H=W%zamP9FnT*7IHOl?j*N2iGgR`!v!dYD(BhJF8TNb;QJuLY9dlQT!1o}OlO zr2c8_V|bL0lCJag1ybPL?KUz>Vxfc(@~~Drtub1Ee(vnlNKD60Bzbxr>e| zENMe}skIUPEfO?M5h_&OgAg>%l#2>)`f4$1TZ8ldN!0A@4BOb*k(V>mS0~z)_0MSN zt03SqeZ1V5@aHlmeXIl?OcRFU+|+h;hou)sZM#a4REX+LSn#=B5O&Aq*8BwsnjRct zg!wB|>szaaBdR#wg`}X7u!a|)y;~#lp}fL!!j3(iaQe9zQ3Zp`OQ}7Iu9)y*F&+km z-J0)Bm|bBse-|S4LUF%$L+){!upY#R8g6fVV!hJDSPjT2-E+pw>m1>!g zQ-2A;5R@o_0(kWarcyQ}EYn08-5@-(vvqWRWEy=iWa3iCg%Uq4T2hJC<3*p1&gycv zO`Jnh?Nm&V7pqxlD7{L>qfAvY52Oo+g*-~f!+}xJEhwi~^HurK?u*6vo7_Y}R|H;U zaNGjGHD)(XOA6jJ9_N+2hN;?UJJZQ;~zA}<* zj4#rBoftWSLU=O&d}y}S#-nNe;loRIsHeEW?H+5sAT!K8Wq%Xe=d?AJNxBXsPsc8A-P02@jDu^_j#O zbVFjTG4jINLAQy@&1cdC_4W1h18r~L*yQO|P4f@ZT2{I4k*j`$!#1D}5bIEk?lZu* zh^Kq=;2)WXE31!9J{n=mz$G})B)_Nlae9mc89`$s%vFv2joYdwZorzHz)AC{A+)k` z+?EGk3~!7L;Z=wTo_baI_{6$t*xJ%()qx1S*?gFv8|DJy#RyNXrrSB%jZnYTmnSy7 zNz-g^ymN<%sxHFYG$N29RY5}8&^g3T%PJJqDw67L2*Dv*zd5WBx@ptWtA{>W!yNV( zNiM`(l8x%)KF7!mjaJ3sKb?Hi@#0Y3F$CegMQ=V?!t`-G4A;kWChdbb(n36=bKuUI*o3Kj177L{W9kgiDdGcCNA$l_{m=mA5QO?>XRsXYV zz7ga52qYC+%JgXqgjqUC35g>*ZI9n8l)ZR!WDoktg;UB1#FLzmmq4!YoKDmXMh^it zLW7D+Ya0VnMDTcZGPItZlsOUe@EjJ_AE*&0FG#?Uml<7E$?*y##`RCO1LYa6STQ5C zoU~|7_fAO8i$->Oto%gv%D6X}s*-}BV`yAo&J`U!J4!|IUBL5{Bt3zH+Blm!bd5Q` zdv4@XZ~-gb9Kl6|9D^N$5V_quw#qT|%}?60_`a156GS>m=5?2Mlo;gBDsLQ2w|6w! zKjQc8(Sd8ooGT?pw0C#C2&8FxP}e-}k;#^8!l@celiB`tQ^Y0fLw|?XkGG~fOymYLc+RnbsP)}|f zXgs2dQ79w{%|SZMF3jz#?cPwb$nnZIj7zL#{(!=(zp?*;b0j93x9~rlybtY!rRlGB zqpA8m>SMO1z&Ob`iH!XjbB&m%B zy|F-j2{xI7trrtVDa#hqgX1N=cvN?20msd_7IZ8skK7ue5&VkBVmoUAOHXIYv0VT; zc>R@@6_^1j>@UM}>^N922-!G_Vq}9MU79-dlH|GmMg55z=WmkUIK-S5`eTZ`?X#IP+xdL(S-A1&r zR)8a_wglz-+6&n25z0|D+4j9Vv^`iw5$FTk!gZ2s%O@5uEf4w}t-#txhK3*&k*5~| zeC{_0hQF)U0$v1ajq}PvnFS%nw zR02Dy->ib_ej7WrMld4NOH6`_88kIP6zB=VeIo>KuC^(BojrA{Qq6`Us<2N@s$n># zBs2oz*b3@j2WLkyfkk)&kNe@C3L~3p*L!(_Db4f^g)nhyeWB>R+fn%QgDBim$0!7P ze*xcU?g?TUmR58TSC8F@9`Hwe5^N56PLlj;=xTxNC?3qnr-=z;8?f1Waj__hnr=vg zb8U!M9~-@y^xtuCPj%xsgKg!PvBrmyMdwwOUi99O zw&>9|sL{7JJ2W8~En;?TOw!DZs<5z769S3jFmB(e$}x-R`u!yXcR`F@zkaY%DZ|2! zX;U*FNhO>Mr=XG?p;APtYp^CwmO(5|Mk5rP&#!%7ms?}!-+rpZHSihU9>DB>+6!Il z@#k7;G)?tAdzH;%n|(FPFDXfFH0`khu$RMpd9)3dEiC;FBQXOC{JRKJwzrJcprfHn zdNy%#Q)7O4Zv&Or=f^iFL<9sDPuII70xm*ZA%8eBv$L(Ha+}}Zd?n@ydYVHw6%ToN zFE!Wy`s_U3jf|0P!_q}lgPQApUZ&elB%hNtK zr0)a&^ZiL|I3mi>_42`iO~jI!KmwjTWt zb{C2VcW;zcd*m&AF6BW zPl$>FN&QTr5=$^@b5dG(3xP7g#-dr0;T%0v&^t+rW1KrKhuiZ>KeXP2)mifwS1b$~ z<{6S617PrzT2XwNOf0R?6Wb?^l5nv=zu}=F3JfCfP>l{V68sk^R1ydkb`B3?0JKWW z$cO|F4=?1g19!SyS1r|WusspMh$hb|%L;N>%gHp2`?8CMnyf5|(e%yX%8=Z*LF?5( zqKc$RQbZA29NN#tq>&$iOE15-P^FS9!cYi-I;O>x?g#{Hb6<$B;0!|uT{jalC3>lbQBGE1oq91UE z&Mm1Dfz{$~{(fMV9PZC;)h_HMiX6#Aakx55(N8`t)93Fiu=7ElYXNFpsjwbRxqf)S z&F1fY_yK8kUd5sgx-O&9_w@86;djcM^Lzf_;OH0+i$vLPTQ!rJ%;w;&egjy)Y zq+_HPNSb-F4q54VF!3Q1={cA7xg+xVH^9!Se+D{~3>+g9HnB+m~kSy@@p z@QBDX+}xTiX#TaaNGhWH1+bch%<6k`zuB7J4K8tzI41Tbg8>t6`$5r_Ullt z8cHU&bokL~*k!BDKtx8Ca5!C{qR)kqUCGkL&5A~ll}X3MgK|`%{W0I*&2~(R!)?Q*qZ>? zw1IoC4j|Uf0;8}+%jV9K?AXKNMu+t=Dy-%A7n$E?J{~Jnea2B#nU>Sl1xGX?TQ7Zv z_xQ{)?c|%hu6qca-tgSFe$X$cs?yt>2#8~`Aw;m`8Sf+uLD8F@p6jY27Akr!QJuX`)k`8@JxNqq=i3=N72sFv+howOBZ+q?9Zsz}epQ z7NjS#ckFpcFk*@)o6NOni7mDB9N{~(($#LtAR$#Ls!m8LDpE*G?|X6y;A1`b&bI{M z^SK_P5*rNuKxSbMO!CW8z9zs}k-&L(`LR?mO9#|Ypgf7vC@UrjdH?3z$*{s&$G`L4 z%8n}9t!1dLmm{kt1eJj?bI<8o%tVMdJhK%nwDLu2Qor%~rVhn`SOj9os!>`zLaz*^ zqo?Bzm>{q;?DsSSTmN{@8av2=!^QUUys@LuZfTiY>7g|etc^6%gUx5QTPz2q9G0f1 z-{O+t#qLb<#B~)#Jq3R(TJrlwqukg_Y0d3eIpxJA zeOxHWmcPg;m>cjx>pop`1;_l|uVjO7X$d1Q%R?2$jmgcGUHhRYGr7V!B+-cJsPufkKcnM2#vJfdgoL;c;ihgC^1;FTwijHvxS z*!Jpj`%=;Zy}g^)CfE{uH|;p(pGP^Z9ej}7!yRDx!oFN@|XY6=TQws zFv8bQ!7h;0cBhu?p*$!@58{q-4TY>FewTP%>z`5d$=yc}(d zDlfoMPDI@0u3Zzhlu1`8MwpDR;66B1&t&vlP(H`)(!&WZ*PBinh6GgDC4!doPY@oj zW(t9ZR~&!UZA(sFUHpYiWO%j$i^7$IT`^`&zRY6gx{-pxmALN5T&RT;B&XbRu5(N+-T3|-N`r~?zNL&5n9 z*`vm~>e^R(!qzCymO(p@R8r9c0qa~Oab$$S=juE1X7``6@I=ByU0b-x7t>Y?VC%wM zZ+BfRRd#hdD2o+Xnh@8~1j%kpk96&m zd0(MvKO_iU*zZjyBuPy(bT9>1@zVy}o zKkJ4U?9`Sh+u0jLzUy-7Rmxsa9vQ{uhq(lhD4@TS3C->?e{vv2AN{6dMnQ5LFQM zNmsPP{zV*-+e)FiGVni6Y`!|74PR2-Bp`i&z0GmWI8Lpx6v^j(!l^jY>~zIf~f3RzV}b2LfH%$^D2v zRnmji)W1UPy1pE69{&=w^T;pN87P9SWB(|nCbG#{uR4yR4jQHBe5EROUIg`HQri6f zQGKwZhuMwZFPAHX(uh=T{qK@}Y-}td6h+YI@&~HhCI7Dn#3~D`mV$2)dT3V4lszu< zO84YDi4R58#C5T$3&dsCDELtORXNpyMHJsNNB{C_rt&mB%?R&~Jx_Wjd{ZL! zpKJfUX>aj|bg|>~U)mzBHZkptm2oqS*jDH{YxtaO$&Q6->WQpQxVDdH&PM3P*9pE7 zMQ`*X^u89GR~79I<)J|StUH4LeCSN0P)n)%oXP9YwD090l>ec7czcp`B}?s-b9s~( zNy9a7G~rQA=Bz0EXi5~#ZV2y>_D5ie7CS6O(X%pkX=GZ+$;(GDZFabPFRv6(vQzol zKoRusLJRyFl=cJR{;pPYZM89(SbjNY3X3gn;mx-C%xJN7&hEKGYzXCxrVf)<=8{J= zk$m7|%NO0w_pbsoMe#$CQ9iAX`^j!%`9sUo2t-+bQCV6|zqt`%=)a@lWJNxl6^`R^ zZ;j1KZTRswEG8{OVk6$s`+2ynjIU3er-PtpW<%0bizmj{F`=7(I)E~(n~D|RR9kIo+t zz(<An%Q4y`3Q_kwzu@>f)`c)y8!8@_k@I5R;N+P zx$hnsm%JBDJRQ`3PF5Yw^;Tg#V>y&IXT%%1AVWotyP?8;3K#}UwKF{*myuZ+`ViHr z62HaoTYffNL1E!aR;sko^|oU#V>YHNyWzP!M+bB+LY@5c9Pi%w2+bd5lQUzk8;1TK+DXz$`T!@= zUL<3ekM6qur%Zv1Ysv2?7!}mq zO%XdsEYq^gzLzJT5b`wHyRy0*v6Alwto)K=-oyTBn}we-T@W=&gq^^L zd{ek#WRRo>BCQBQLPDhcVct)uXJ$$0b^7ODng5Yj!Zwz_{6Q(g6toSZu?v2oJJq|M z=Vl)u`NJhoFV;bVDDt~BL`{68tVJ*-itR=U_u-;9`Z&(#{hwv2lGm-z#!U%7X;~+Y zY`5k%w+*4i7Jr93R(DPgqKbphl=q?&j}|9ZlJg_xXv~d!w$PMET*;3PHWN zFLIpv#nf%>ugSScFa|tj(ELJ`F!j0_+QmpW z_&6h1=ig#m6Oe#wrrT+#*V=wv>DVA+IYx%P{(9$|_~Sn5PTmn|GHg5Lk7w1>{oTdW z>Etdqmpx%b?jeVvH~A|4!u6H|m(N3;7EFn+`^3TO2VF<>ebqydCRT{CH^pWkKWq-y zEFE+HpuK1^CnpRzvuJ8)$?kW(bImn)JDNt@IOOD8!d#Bp#9rS2uL)Sq*ORLpJYRLFzG~8(Ty}W1yW`gZb{^iqCvgRiU#o?Gj&Zs z^?$O6&do-9s6}J-U)yB4*yoAKl;ji^hVJELyFV-w*V`{Sf+GmMnNcL_#UnJbv9iIP z3FF|Qc6`g@rB<{bfon7(Jp}85#nQ^kR7|R8^hGF`?UkY1BL#vB(C4$a*Y4{ST*-cN zzU+~%1mv7=;m1LfX`!egM&4A#mnp|vlQMj6WC+D6(}Oj2WhBeX)RzyTM`7dRdbE3X zbSokL1Q-MFk@Od4&Jx>=sgZsj!G|_>C6HTo@VEuJ^WE%?=}?DoR|+%YgJqn242>Oy zo-RWL_wO`fVOvrg9bUqfKC{a`acXL#YnRhnUsTn7jTB^kUCr$3jFzSpAAAarPt@AY;aA{sHVad-!z{f}CV%Zs*xA8(d8~j9vAzu= zWrlCQI{fk($VWTm`;>^0lMA?TL-q;;Mk_w(S&V7gH>^w6tq4*jM=2l%g7}(DcLn92 zZ6vG@IfMB61x*SMit9gCOgbc^-S{U$UlJp)Z@gjb)<)MRSr06Pe=0Y`)H5ySEC0A4 z5`oD+^$FPFi~o74LKkEW*We;2_eJ~1H(OF7_za@@)+KFl?iX_N5D`e-uA#OYZit8n zTJXA{LL&01yZF=;8*H?M0>*szJScxjqcZ!qnVb5_^1$=wfdQ=NN+Q;1kN4rYi{GTL zA1$}lqDYuDb&TATY^4~PG(xFe0)wpy0NMx%GdM9^4YL$g$EVihq&*LhGU3#w8 z*82XmvC?!lOF*WAd_gCS@eaGfyMu}3w!A=J0-a26Opsg*9tk6Rqr%eSJF^0}kAun+ zUtPn;ibd~4=*gg=&#%X5bD3W;;orZ1ADf<(G9CROZQ9H;c$#%|Jzh;|VHd^Br=UQv z^T%D?YAr71_{jt_ASUeAA2<0KX&Wp7e*roxNwFI9hWJ?BDO|nAxc5`nJ>Z)COxcjO z7~QSAcKI3CzICdxboA4PUQhx%C9{cGvIZT(dn9B=wux07@{Q282vb>p=UL_bQ6$y% z?LmgZL1^+X!$`MK{#N|@&?go(D4&$S7#}wIYVpXB#`5gCnI;10)t8cr(|4}x_x8v1 zZUaAcqTAa$YBVA-|G!qk50_ZqmIA~Wj4hiQ#k@8YsCn95v4+3vbnsYTN(y}@4w|q; z&vC2-$)f4|__RWE=5TWOg9g|LrVF}C@4Qc^5s2%;HmffyVv>;%eh4}BiV3qbWBk@Y z)mOrWdOY*=3O1vhE*3lca;aq+Zt?;_)R9o*^8?GmqBpniGmTjbO**s0s|x}XE2MSr zrO&^8=gX|Z;8xjfqtvsPpOEvM?c)vs_x-9q!6g#8NTr%_aNB&Y z7R@+|L5{x2N)A&(UwQUjwRE`x=Vx1FAy8|)3m4ovL-wD&wV(Zx z7*>)JWv%#!$-%~aCZ2#-hzHDoG4SF;qVg)J>NyJ0GRoCspOMnDN_k{%mD4lBW|P6* zp<}1F(2mH;su~*AdD!{ljy&8_cv82gO>;ejxYWU~;O~B-FHS^E9Qj&f*7uSZNahy& z=PMGQ(*_)3EW3TZ9LiKk`_DHf6 zrDXs;hNbQ3zP#QUf`3~{c6}`6?B3m6!vp`eA^w&Wj8!C3*F2<8EbmFlq$ZhZ!RpFo zDOU_;E3fDkusX@1*ZOj}c&F{du-X($$6aYE)4BXHBtjk^R_^z5qa&1%7{0poYe7ZV z`@~8(zN$qGt_WUS3gsQCXO1)WTn&I1r&DIAqL|uoTnf^(&UIbu?h(wVb%&&}hqrB&yG6 z401Il$oOe7VdJPPjTbkXSqL&Exl>Gf5)?tiqyb+^R_0}dq|GR+RtY4~h!}6`bQJ!^ zzbs{HgY!F3GCn=T))lp28*&X}MLuN|$I*Cypl%1GmZ6%?jZvip7ClAD9qBbxM+qLY&_ zCa5=1`ppB-Q+zqDA3Cun#Qany``PXSN4}oLg#nqychA;t>a3sCzDIE748+yiX20D~ znH*igU*-N}F0y8@>SgdHKV`uOtInmlI`VS&kw5n4AfY*3K`bC(u+fwjRhTGozM`kh zlzCW;&P>hV+7(%Kkb$n=*#O_;*h7d(?Zf5AI^J8oHLsuO#dnYL86R#_gO!z)OSNk( z9BVc~591Z%Ykm88hv4Jbd_0N+g;<%wccih?>#1eNk3=NGmG9UfbasQLg=&IK2nmTm z*0aa*!d9qf8Rl*Jj|!WpHmvOrS4FhH%#)ygsJar?Iv?xZeLNq?O*jlK1Er!Y_PP2# zv!MbCCloA77W-f>C1xMk%iE4}Ds<|`KfrWx5STZZ0b;#o{BR=;Bn6d`SA(v>>ti%-u#oIQKV=8d1QE4a&Gl`SQ z$2@o!%-$5095;*O>j#I$cKCCbX=>v}DMLN)78P7icFH65Z8=?81fxHKvIF5}pN(gy zSiHsx9_pO)8w5YVy1lw^Mm0uvhabhDXVQ4eiC#RPGswZ1dJPlziA(BRu@Tr{jr{7c_b(m3M^B60&%N@JBN8wiN zge@2u+~wY4y33J}`SSUpA?c-BMmNjTFa71{^SVT7d1wU0HJWX;c^*S8ZTv~MQ! zpP>+2FVl~pZd)w&fP6VDIQcwW)<|Xdy@V#cpn(0HQCHA7(kd*!h4!B;d_EFl{-*21 z`!>g({|;PT@!H+jtJF5rB{B+)Bh*ISOKmGYUHjBWq*hZ8b+88xm+vk1GIZ=4B02T^ zHe~+h$*4Lg`G3QBIv^QxHJz-eZFzQ6N3!r0v;P+*4jBT)CUrD+wZKY`s}0<=<$Mcr zU|^u!+ORw~ybJ@4Hk6LX_7;4;)}`d`S`GKI)YgNVJUxmbCaU#VvdPrb&IDlS(pj3} z@9dui<4kz)xp5Hakl4xIe&QU;z8E;J>O%TDXnu56S_(yt?0#SVED?{x@^5)bX`Lrz zh^DjK@c64hVPA=YEzwG%RNyTC=!|&pcJ{p1 zKlp-Rv8NEaH`$~xJfU1|=V=RYQO6V|D=ju*J?`Mau-8aSd-up@_s7WSDfndc!KyLc zLX5uTaMJ?VJ}HX)MqfeX^7iFudKLZqjHaZb*hD*oZYCNdD3b;xhGX4ezq;gsp79;! zRlgvGFGZDvZ_J<#QKr@8$4O{&%eO(!erN!gcx#{}1Di5VR^5*$Cgu8LeDz^TBWnQl zUu)Wq^2sGD&TKT6@c-DcadAVj)T+a;h{lq4^0BFMma7lkZ^+h2Hv^YKz?99o-_k`* zG*|}bcUXLGf%8%S9(3$?f1g8{uV2FSuW#@><{?Sb8sh9saxIyD9)_xeX=rf-^@?DV zR#50m{~>NMp+06ewzpC?|{dhye{W;BG`39Ug7M zH6xj)_;u#YM8g^|_)z-3^WFEocM{}n>TOCIh~mY4_~yZHL5Cl-=BMwqT4el zTQhb})x7zw+!$B5Y&+N90nV&$6?=N`{_UV|6&{r?~Moh|iu~NS(fs_=jrbeDasfVwR74Tu6X29y9%T;*&jMY9C^q z$~WP=k?{W(^71%*w0mAYo^iW98Nn!F-3WUEW-VBm>x%=->gDyw-6^A7>1H;ELP}E7 zx%KS!v0s=B!7O1)-r=X|{pAk4LF}nhj={sXUQt3j)vbuxezJI{+xq&s3C<634|qVL ze-H+fI^%tk3dYC5CqG{I+y87{X(4CzeEx2&+c8p}Pdg**9rYE=U=k%F`}5U1%E2J~pp`aaxPwJ;p@@{*~g#gep z)bY2N8G`?;ch@W?^6A9TjUS&|8lfDN*pJ7VKR`0jpy$5uSISRZfT}+tC4^&ldyVX9 z#)by`6M5@HQ-woo&G=w-qMzk=gUD$7;@<#oeDLYNDXs`E?7p1sk zMfUG3OrC%YG)I!jMD}e@5m!NlSGrSu3;G!ZQCmwQQnBg_a_GC1U2R% zsF58S!9F4Cd8`0PZi%wR3`(nI5xg5_QU^w3o?_+v-D0!j{))ZT6bF3BmNy3HFADC? zK6-F*GtRwRA^M~N)zE@maGSV@W);Grszg}4&NHmJm{&|0LxHtgq-pqhRpRBZbY8ID zxPCl-{TS+0o&+NKzo2K6p|Q*$mv^4{o5sJ(BNf`b9uXGG=h5DFSl^-q?;e(Kl2vV( z5PnM8PCBTQhe?;+T@YA)w7B6hR}P_E6R5(+;eg!ba1Q<`c@0`p&u=ayU60PCC;k|o5%%qn%!3kRrAS8m+!jY$8{VYNARv%o&%vUQNwUP zw>8-V@@sIK6YfEyFky7klxXj5&|6)Dw|y%5+2~)YUBCV7r;4sMs`psyJrSljucIy1 z!2kN3*m20R!avKG6k9iOpYuP5Ix>ZXf%9}kJ;tt0dp+nVBpF zb#kU+J1qO!xh&5rt2Qj}?Ss`z6x@>k%K7(+^Yq&*K88xJ=#&(^hV-ljq4CMRRa37@ zBVq@WexSEk!9uv<1p+%$S!WJEcag7Rel5+I>aC!_h;KcgZ3tdPYHH*g$0tCCQyY<7 z+1QzX;oc;_3EZJ=o7#d3@6%6lTdIn#*5nVZF)UjJMYaj=*=YrUoz`XpfBJv5~$_SNq#JQEzCZV0#? zUF*{M+ZRR1GeDXhQ&iAoc{;ketc;yeY!p?Mm}0rRAWkM{d+z@~$w}#Y^CtjV@H^uQ zxWDS9uhc1rk>Wq>N5;=qSXN9VZZsbt-`*zN+#VlhZBO|F+7pZG|J*SHlSXk$kw}S| zP%TH^UA33zwIr$?$FZhmrraMKiDEwzZz7b^?1uI>y@x`d0V=*&xqrE08+jb2^I7~6 z|7Ji*F=2|Z1VHJb11LTG#=|r-`9oK5dxd^rbL2~iG!aglH~ry9MndX(zi(67hX5eY9C_P9J( z13&*nT3aJY>0lY6gYET2#q7Ur*9`y>utPG#cmHG^r4^SC?d)DyB72|z@T7t&jzo<| z68N*J+cqBD^Jd{{?`&fRzf?+ATB&K*TWAd{wsID#4Ug0NTe|6EZU*+0>KT(qPO(g! z*pB$=4F?qas*9V)6W6l>ikH|AC^ZwSZw_)^t`6<t}iGiDLvbqzTzy!>`*>6XL!-?ywfpDX}s zOgB`oSU8h1cYM)~Q_mh`b7s~;SpSyKNN*&ficlaV4gg@mINXjf-g#=);QP0Yi;`$8 z7nD4}jXCiVySMNejDrzX^s9?eB9xU*wzgFjWL;!m@imQ}%HLby1u^nHDfv^ri+{vB zMddTFUIKV93m*dmxXMx_z4_(U00OAOr5`KWXLfMsrt-Xxv(D>~$AhkIe z>jM^L!@ELk6@|ervI>U(Ue$4HCQTWB=#-QXNRm=E3IJTpaP94(`49CiW!|@CZg@k~ zv1X@8fP!Y=c!HFr%t#?^={9r3?3A#vbG6zsOA^#$>i`sequHg1NHa)BSCV0418mwQ z>zy{hv>(BFA9LMo5f48x%T^MWH1IIt-g{#>7EvWrvOuAq#a2jV7(3R*Mo<4=TVfZ; zz`}~lEBfu$wZ2PujWKA)sbPDdNeKOWv)HNu^%;J0Z1}He**B%Zy^OsJn-H2@-Dh@%V@)WZ zM=f$kEvE7UFC)h}sTzwMYi*d|&F2f#{&`tc;QM<8UG0F6t=xZkcJuSXXz{qwVA>JZ z$2fY*dj@SzdW^Zl0xWrO|5&omD2eJ@9Bj^6dOdW<(P8cJv}t*H@k>j(ot>RDe0;i3 zS`WW|Wih^u2i$T}(#X@zezW~770-p<;TOC_gYOw7fX?RMOA>H2so)^1;8;tfy4ta3;&a3IrStpil#u5W~w$yLs4Bey9oi+5c1yw zS?8fBG@+m;D2}UAa6Df9@v%ei%kAXxM%S0Lvv_H#{JOHlLuW7tM^(Fl;ej5!vL1n1 zW~kWDwA@@4Zl}4@@WHsX%*@O&JOOqLJYyXm_-7&$PwE9`snfb-GX5ceQfFyr_n@ky z_&J-yIOgx4$KkClv!`t!wFPK_h$n*O*9GG7z(#$PL_|!zaYRH!L-E{8gRz(uIm=6L zUD8=_3u1|FDH%COj&}#ze5oWxK|WH06BFnF)swx0jm(n6q!ULWl`0xgV~PL%i4Q2G z&}C$5wnMcdsxTlXDELnWa2lDcZOmyF9H!j_C|KvfIlP$ozZY-I_wNDu)-64lW7DxS zqRKWh>(r+`5sic`ytI_&<#qJxY5VA(OoLGy)bGM*F4VZqiBJI&bE?~30Ica75CM^; z=NiLSl?ehqw;2LDK6oE#n!_3p(}@D}^XAPY2d$u>!IPJ=3Q2lKMzk&UJz-UE;=T%L z5loI833!Bb^XV(G`OaLKOzG?pD=RC&Ll}JA4o$_P6n@cRSIJ~~Nzxz?mkG*6Qju@s zFltp?LxMW5asm=J6o67nM6??WNXB?qCgdiS!uYk-yR&kpBlO%42JOfiRTZOqn^F|zKgKHq!7}?sb8)$pr@gML&2gL zM7bJBJz&=_^>Y=s(33aF)M?%A{oHL|F-2wwwYkTTg8)p_P(B6f4={y6v+ZntrndD-1&zDpiEY z!N zS#O+rkuVx59Uuv0azQy=Z8Goj4FU9U4jY|3W*<%%wfsK5pK}DFha~MY&AfY!?`J!( zNFmQX5KD!e95F|2m6zR2q2Z;g?#jtxHIMt2C;qlzJZi{#+ds0BP0Y_UE`z$V=yny)qLc z<8G1vmXxY$Qd)f)C<>1h5Q`GFcBH41XfMe=B$K|C$H}?n#Owb^uVA&&=?RDuHM$+0Symgzu#LNV4dFyeZ4DDxcH=av`gx3t5Nr9s-`vX&#oNq55NgW z3r~t`gqH9*rsH&da)W{Iih4}2)Kx70PdkbZ1x8Hr|RrUTaGyW zJMiz1#QoK_`C4ee-)CQ+vlUE$E{!u$IxIph`aX=1U4Lh*FHoATL@e;ZgXm4NO{U}x9H7p|o-z@l-o|L2_NLxoInz#?}c|*a#ksUD|Hy)C*r_3-5 znRIrMF@m1tl}GhP>PJ2)$j0wAh6FdzBCKkC&V545&f5v1flD zw}}s%9a7?BtQo+3O+FVt_-VaI017bD$1;{ArmhoPu0XAO8Dh+4s*v3;ZEe9WV{-F2 zm@=&Ib~B`3*4>tM&cD!RPcYuP~$rYJpm(y#*C!{Qh4ya+A_uY0=(HdBIQa?D4aLqYx(t@ zL5#Z9_ZC~}Oc@z&JTTee{7?SB1?9vE;)=S8P`8cF@Er3H!`y8;SUGCqVV}e2U)OY6 zq`Wq9G`v3Z|EkMqCY%8`P{VxFGf)5@@;5e45=-kx0XwN{O}0J;I`pNa|<84&R#=x0~H)WiM# zifeBXopFFLSV{p+J%DXVou@zPhBXFPE{FdlxsfB7!C92eh4fmmQW4TJ%mudqBv z_&*d8@B`Wh2ZzY=-|qq#DLgLTqCB^()fsTnF0clEJQfWQ>k>$~3^;4(@HkmuEaSwJ zC%gTa_TT<#4n9ew#@s%phl_ucbu+=!VmCbm2ymm0Ie2-s6=M{K6%*)Ke|Y)$EJfFKVNv38d%zZO84>GZVxsO_ z7FOQ@R=%8n!TKvmraX_66cfe3!T@1l@Zm;oFs9R@DVy`VjE#ye=Oas5snt`7`*wSG z2iOwxNU`*oolY)@&s|=H+JO}*n5S}JzL10?l18g1^q=@v;FVYzC12A@i>->(hT@yI zZ{J2Yr4WqIZxF{5qj60y&l|`ktWnA5A|HwibRYnmh5VYBLuY1A4s)d`6K-j|ADQ?( z_dFn+jgw^AE9cj0B?vF)OmK2w9f?B2kFtfo7vv$vq&~r52!?rkdIr>s;_*NKQ1ESY z+cYBKO#i%4ND{nTaU6Fz=a61hE}1_}_s8)y`MmtkF(O=+MudVZBdlC8>4&No1*SVI z-u`6ge?NVYBQfcUIsL2EecOygJIjB*5VvSg27~LMU$K-0ubeBE&r#jmlELi%tR#Vb z?aoDF}0>m)Yywzwh`O zo_up}+0)2{@BZ0oMtv;s>rrwLl9W;lQt>$C8qX8c-f*gI8h0HV(5!c2J`PMwUVT5O zap*@p7jEAU_?|opBDwOHG%4UJ2n5+B}*}A$eBs6NCveC*v?%w1WMWh zCEwosI9XKSfkprBb{U|pPZpd?1)Wg94U~%9AQiY!Ml18V&$DH++r8!`9TaMwYQ0pV z>W_}_g&Dx={@95hjKDt17gu1%DgKFQ{Q7@~-2Yx(Q?Y!;p2q+DT8yy_7p1KWfCp5;(S6%Ux2GEwOu`%j>8-A+kMiHN8??&cZd2GAyRRX6b+0((GIlni_=f6ZEy7)-o6+@%cCoW1p^S({n_mZu@gE?Nw3QW+Z1pCH~gt-T*U zht=k}0v{WX7ur#sULk)!QrAqzsoJB(DC3>c7>Ul`fM2hxFQLG~#I7AhSa-)h7`hNW zke#!`pdVIF^iPS+$4RB4B_-GUDN5$gCQJi9ia6FoQCQX*rgao}pkF*5JZ6hgM>$AB z!H{YeJ{0yl1w91jgp2?e)$}6VkM~x$1~cS3??F%s@CQ&sBO^+B$cV1D2ju@c7{+%OzVh`Igt+XN_z2-*<4+f;01> zWY@n}J5B*ZDgq9-ZMx$)sB7IaUd#CZeNm?{SfpQ2G4V9Gxh`J_FjNNJ<7)<7hrj2k z(MCo_mDfn9Li-kE6_*tZ#NUg#wkL+3PLs#O%sl)qZ z+?G_l_f~pnSkn)-XHSi@C&%C!2<{^NWHh=mDJkjY`d~&*W26TS!*q?)O*GHd<^B}O zspCKEcpF^OyY3{s>N4Om{?-$v7M*!&$;ru)nsLekhIc1hUNs^lZs1j5F5;YuF~(yr zB!Fiz8j5ceg_5z#ULPC)cACY1y_Q8(1QRZnQu*#e!Cr%z4+F;I#3HC}%QDz{s!}we z8_SO#@OR)s-5B8381)VIx7qTP%-63K7-#JKamRFIg)D1hWJ@+KiMjn8$w;wS0GNqd+H%iiCfz<&~VdcTb|!r5)fP zT|3SUp^hv2$Krt8+9k@&265Lm47jv^XK(`s!%!vFyC(PwT&$}9m(iNee>!SuLG{TDyiK-Tfps6v;4=2EBkA}u6JtKtD2L^-maSS28`gudSD8$;%55k z+QzTv7Jn(rD_C>A87v+1=gnD-2${!p2*eMB7?GD<;Tv|Om%%cfJ_mHEv-DHXx(mB^-J z9}o0fFTHN~&*L@Xe^jD?SSa#@aj8q+;Zhn?q)7n)CMo zG#QZ*RYc{&eO?u#aAbs(8epIMneL{a8hXX!>4bGQZv%^M2;o&ULWM$Y!eu(`o2d$m z#Q>&}fFq25vX<|#Z{A?TtE9eR(}A$D@QpD16XxIJb$}R-S~?R20u;^@ZF;#Nw!8j8 zvVk%qopdJmqcdqSxU~)U>XNLg|3B;T-RW9>yw!_Z!;94s4_%d5Vd zOyV8LLVOr+^jMGGd=5$L7uRzH22&LR7P9wX;d4j=oUThBR>{og5Qf-%{vccQUO3`I z7b`rhZZ~mM9vQ*fEu`WA?1z{~uZ_dhf7xJOeCu#7@iixvyJZTrpJQGulE(Xb%EHx- z>u8E;iZUqZMHtiyJzTlq?`Dl*fQOor;%FNxWlS?l@5J4VZ|D^NIz!8OolJON0%XO@ z?G=akP~YJ9$JTf|RK(TD&@j@B*DD6-vwEMwX<}(9>Ks3+ii}uWYY)4LKr%J5YHR=p zmk0hXm_1OS=#+wf;0B!R+O{DtOp%!{H7e?snCyb+{yW5nl|l^}fv-4~4Qjj!#0^RY zCv$Xy{A)}#^X?}gK46U%GT-<>&aE&4EC=A-1(l*K3VL4pf@_)^fV@3rROmEQ$oX@O zKt!EqBsNF_ns~jkZt{l)Op%2T7h|nCdDa`kkar;gHJBbNHmaoO*JhXi@5duPe4m`i zSk(vbqY)oWm&$p)-5}?-m_nxU1@|F32r|O<30zs#3eMdl{CY&sFXDPOhP|L&2Zg_E5&nkA{T0@_!3+0$520W(j)cC+xM zekrGeBrx-_MkT%Zr~%fp!o0ZCPzMBm1K|B41$~SPynSway4FR^IsRXJ<#QtzM?p`i z3SUZYLg6H!Qi*;2nyE;{hwhTnQY7yhKm~4t`El27D6?89UWyT~!dB)T|gsAl3uJ_C1ExRbqf!)zRLu`D!$cU>{u$c;*C^)2h*jMpv zH?C6WVzX5_S6kfGFa4t*{=DqPQ6J?=Vc#mUg`JdbTat!h1B6#;YYQQ%{IfnJ7ggMO z|GHYxMW4?c8RZdu>uKZE_liv*!3w6Ld zV~-oWHVr3RQVIMe`M1AL{t4R}$@{9 zV9sC8w`}1*1wS?g?}|8(YMOKgN_P zUr$n%lF7()cq{f|wB+*0TSxI__fs z=>%x5_34a$S{Q*tDruF#zeMK|d z2<2zYLP?0B@+pc0P_E}t>psIoB3)bCByrpBqERbr11{)-KbY=q$nu@cH{{9}8un1)McNR&V8gE` z_<^N@e%um)61Yk2mn#+Ih*7`ypdjrIcNL<}R|}=5e~MeGXYq_9#kto>h3SU`LKS7r{If zq`AHsCgxSeyT?ZllsY4Z1r?dj=6TCfnFNp!>Q1`Z-sic9HYK0Yge*c+TTVIVd%%z3 zoM8nz2C2X1Bu@OjBp^CcxMBK2xx5a0$2vizwKx!}sn5*!a78IHi|RcZ4dS{(N^NWS z@HkA2nH?9s5lT-e_>ue}N_bAYjDnaX=QV^t;#cZ^qumSit>cO>9(%1f#>%f}TS@2q zD~HYe@o&OlY3u1W(gk9n`mD^~iJ5a~9_=dhHYA&Lad*apONN~Wy>S<68cB?rdd%_a zurcRu^yb}|ll!+@A_zO-Q-tH`)`5#-pCJC}{Z27tx0{NWStp~bwQk2|fA-Qo9ZeHQ zdi&~7(D=gpwGMH6E}?j8%K#Ar)}f{o2e-}ViC^ygcD4Mtm*+1h>u+>a?d~-{@D7YEsNk+*WUom#l6=%qUa0pqis_j z+v}6Z9wBw`?DeDwr}%G3^K%dOH~g_rJeTs z_&&t1lWy2uoP5H69r?C&&ZnZCE<>xJR>m?e9=KU>W!+~_OOZWez+m!5&?X_2e5G-o z5>Cp9Avu8z+&>h5;InOxiDX?@McZ-F2%SY=d(#_}et&8Dc%IC=PE;(YL{&;Htr?Y~btrCVr|jrnElUNxhb97_@HfsRz4 z5!!$2ie3gf#;PTn=E=uKhKd&0cd7OI2B+YTayiZg%;UIVywG0K>S12P(3_HZq)7}( zeQJKZf4{Q1l=xV)aKjq=MW8>vTb22whB&4+{Oq&M*8>>wd85yDN!&AS2S9CF?UVE3@IuE1@Gg{ld}t+2JILl z?T2@0Rj!k_jogZkD;p)z#1xRyDQE16kw_G0vT~zfX_^>Utd}4D%w)K;^O5`;TOCTmOPrt7sRt)8GIxc@P5>S)rJm-LO7<;f;^po z!>qAR6*U53<#Ve%_2VgvnX*zpkNV~vRhw2!n+(fYC)!3YYx+QWFWuZ z-+?mSO>ktl_5Er*PR8JUk!CnU89!yJLl}E1Qesy8a&qG{o<^X=tLthAKFE)GJ(a>lEAhCY0hL-+aZ*FqC}0y|3G>WA;KO*q0E5$v^Gz z7_!k>x$+2YaLlQUqa^tv?CO-B*ZC`&zfnIa0{(X9;%B*&LQaNPHK{#y<$1Rf8M7_E=PGJqc%Dc3i#=>b6 zC>jWOV8V_b;ctQB0Dwi&wkIcm^8oEkf|5<(MZ+;FVV~{kwjW#Tpcxo%h(&Z=unoy4 z%r^UoH6FPT3}-3>NOy(cWWG<2qJP9nLBV;6U}zzc@f_A6_x`(uqoZH7k8d%gsnAk+ zK7?n`s=B&DNi2*)EDSyU%DF~MPQOaCSo2b}82LE`_NQA(qk&vL4~$R_>2jm$FT}ki zf4dvyYRMYxyLY_4E|FJL{6-nx?ue7!eG_*w>jQ*o?7s=QWy`kiVYuah`96iS?-T8J z1Z@@1mtv$}OjQ)LoUMxAj9h(kdF`vePDV-}o5)Yo$PMC@9iWgUUZ@Z5{7sEAF!|LR zDk^B}-n>&kWb^cFU_MYv_k1p3)B09UBksprE1Ez_lF~+l94ITE6)B$M7~Oq0t*=)F zCX|F<>BzdUKN$I@W7n7!C~=(>(YDJNiYJ^85&ADy#RwA9meEEu?CCDHuF=Zb!y*&d z6uWO9gmR)BQ^}|U`$Ne-W$>($(G`$rYS`d~^6byGh_7}(%(i-?CN{kWG&ShiykBS!&j&S5QP=orh;fzjn{KQl-t{MC z5Mmf-b0lYaap(7t#7AaOKe41bIM1+A;-@L*HTi3vl?Rz2Zjl3Br}DpK%|ongD&jJ@ zJcuK)i4NhAG&^AP;s_0VndwrOum3>NLZcQP!nlk0hk4z z@>c|^ndNDL>{APGryzX9-`d2T(@hDfvd~ z<&k|Lp@yYCfHo*3IMT76u}M3R0z{NTDYh#6$*$b{Jgd3d|4|{rkcTuvAfdXo|U(th4eMEhv3SIW9I$UBezHj%ex- zE%mm(dZPsJ0x3AA?z443r$%U=!Lv*A0+V*>?A)u_rbRSi4*EuX-X7I#ee(d!q2UC~ zWkO5Ve~+R;kqPY-_GOnVN2Y3PTM z1tb?YGfN^IY60kUG@qQlnq&H)ods|h38+6ek|c=?{ZSj7_Z;(=;^sqEFbXCK^?ysW z*zr;nqA?);leQZI9*9DW@EGv1UlIGa4s9{YXU>m5UCxwC87`` zlHpXhg+w7RStKM*H%8ufhcn#_*nB;gT!D-}SyHaY{&$mw%Crh_msG?EeK}nOu(H5^ z7*aF;q4)36s!U?4VJyxPCR-!$kXAV1vIgNH{pH^>^aebaDlLb_V;O)fE?Xjk{~xyz z#u2{Po3MW3fDDnLkLm%Szzx`s)|kI4B~ViO#s+YnE#@yN*B)?NlQ|LBj0MP{j6}P`EeHd^6U}A!|@mRG&C;(jl z0rFDPq#iSuW;g&ZT~c}1SM+kaW`Jjbm)8zhSbihp;X?h(?0;IIy}AO_U^d~A;5;kL z-+rJL6RC;1k3T;>#8*5?_ldYvhuP+juepmey(*^ZKtbl=bhV?A_x4P^YYPw%Uv|gd zUOXthly7H2#byZ;QRQpEeM{8*OR0H1YPQaeN6u@*!29Iy&%qKjuzLUg<^(03Jv|K{ zTGXN!sJ`GMIHy`(1u%DST?Hf{jlX5-+a@Y%Pd{AUSro1NvsWe`Frr!QNxY_pi{^z> zH7u*U+`790P(H)N=>1*m{NQA3t!HKGKg$egle)wysw6Gl0dHGMR-*#RGvkr~0O?k3 zmC>qrJpc;H*ipMx-{Pp9HHY~JLfH1hrp5INcJvejkHkX(K(9*X6)C-0B8W?62{N)I z?&#>cb9<(1sNr)j*6yeds0S9Ar2LIm;3OZ-GfPFiSgJIa_cQyQ^i z;Uk~5*d?`?uuPD;iC5XQ=8w%$PfbF6DD%8;VNqOMJeBh}9Kd>uWaA`%%1{}0EGXQJ zj_EM5*p)rpt)quj0u>8L_0$0G|G$cv@%ihiC``}^gvYjBf(F|7ve@y$EV$m`u2wtU zNjNo!_KCl5smX*;+TXcxKj)$%iUeXSGKK?(xW0_CxKqvpFGbgdM{Z93XH=Pug7a(k z<|Z7`6PAlnuQT?qz=hG}udpqjkF<)Qz%QcvhNRy9lx364%Q*)6@qBEng?X_pTZFJZy zu>5fGaJ+53YyRHR)FN<_I|4u}^8J48F>l-1*}ZW@v0%dtE=Y zvoJDWmua;#0OIK~1`@(9?<+3nzM@_SZIzvPkYv&5Es`#|VE%+4cNnuw5zR9!*6QL4?2#a=vjpK#*N32}EU^I^m?TW-hU-IiNTiVHOe zYgV+_Q>x&;1rPW6qp7l|3PYV9U5A0p3OpCvM=43Wa=wJ)SFl^me3Xx`Nouo;+dVFp zU=<1KiXe_fCKE?ZTZi9T$y-6%2=WwAd#8pA)9jTsn(=Djs z!UJDX<%q+G>At$bfVNj8yOP?W8kSlmBveCq52~ACKwt^~bGcsa&QV*dlEcRj%6gBX z8*3jnpHFr(adbzNBPANj>s}e7HQ1$l*fy4ucaI*<_{k^*mz!? z9mfX;oK1brRg;!Swko=O3BTBur)mF%pDQ?OS?8))JpPdxRZAT?`!2TuY>hUxv|y|S zN-H)a5}upU#g<2g8R2Sfzv7p>SA!Qs_So(W@IbAnzMm` zhLaVhiUJ{l+f7&9`t<3i!Rd(|%rWp1)ojF0BVh?XK z6g;H9D3QN`IRsND?PTuyFFS$)6_*U=?C1G2gD2-{3RtPr8YnJWO|`o|6SRbU-yJKHv)gI=bDBj?TzZjx4n(ZXvGLhgSjUDtcxL{%jC6`* zDa5*kw!Lw1-6ElM^h@z3ZmAcGal)-m7u?cyT0vOh2bQhS zbk=fBts!xX&DoAI(|x}cYw4edEZ^spa-MD2pPcWiaP6;;a8;Isr2w!j~0rgL?j(l^#J^L*%wI*chT*8739TKirmiiaF!+_8GF zQMq_HGEl=}5jE1p%(rnzIb=AxZ!bhQhc=5B437EtQI3a08Mx?w__54An<)Yb_7m)p VCGRUz;F}~Oh^n?qsq(Y8{{vz#Cgk3J;_lc~U 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 literal 21022 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/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 IYPlr-ALFsiXaE2J From b5f682559bd50495ab44dd46d75eea7693882c27 Mon Sep 17 00:00:00 2001 From: piyush-poddar Date: Tue, 28 May 2024 02:45:47 +0530 Subject: [PATCH 10/44] Added Content: Bar Plots in Matplotlib --- contrib/plotting-visualization/bar-plots.md | 216 ++++++++++++++++++ .../images/bar_colors_and_legends.png | Bin 0 -> 22079 bytes .../images/bar_labels.png | Bin 0 -> 24793 bytes .../images/basic_bar_plot.png | Bin 0 -> 11890 bytes .../images/horizontal_bar_plot_1.png | Bin 0 -> 25704 bytes .../images/horizontal_bar_plot_2.png | Bin 0 -> 25689 bytes .../images/title_and_axis_labels.png | Bin 0 -> 18124 bytes contrib/plotting-visualization/index.md | 1 + 8 files changed, 217 insertions(+) create mode 100644 contrib/plotting-visualization/bar-plots.md create mode 100644 contrib/plotting-visualization/images/bar_colors_and_legends.png create mode 100644 contrib/plotting-visualization/images/bar_labels.png create mode 100644 contrib/plotting-visualization/images/basic_bar_plot.png create mode 100644 contrib/plotting-visualization/images/horizontal_bar_plot_1.png create mode 100644 contrib/plotting-visualization/images/horizontal_bar_plot_2.png create mode 100644 contrib/plotting-visualization/images/title_and_axis_labels.png diff --git a/contrib/plotting-visualization/bar-plots.md b/contrib/plotting-visualization/bar-plots.md new file mode 100644 index 0000000..104001d --- /dev/null +++ b/contrib/plotting-visualization/bar-plots.md @@ -0,0 +1,216 @@ +# Bar Plots in Matplotlib +A bar plot or a bar chart is a type of data visualisation that represents data in the form of rectangular bars, with lengths or heights proportional to the values and data which they represent. The bar plots can be plotted both vertically and horizontally. + +It is one of the most widely used type of data visualisation as it is easy to interpret and is pleasing to the eyes. + +Matplotlib provides a very easy and intuitive method to create highly customized bar plots. + +## Prerequisites + +Before creating bar plots in matplotlib you must ensure that you have Python as well as Matplotlib installed on your system. + +## Creating a simple Bar Plot with `bar()` method + +A very basic Bar Plot can be created with `bar()` method in `matplotlib.pyplot` + +```Python +import matplotlib.pyplot as plt + +# Creating dataset +x = ["A", "B", "C", "D"] +y = [2, 7, 9, 11] + +# Creating bar plot +plt.bar(x,y) +plt.show() # Shows the plot +``` +When executed, this would show the following bar plot: + +![Basic Bar Plot](images/basic_bar_plot.png) + +The `bar()` function takes arguments that describes the layout of the bars. + +Here, `plt.bar(x,y)` is used to specify that the bar chart is to be plotted by taking the `x` array as X-axis and `y` array as Y-axis. You can customize the graph further like adding labels to the axes, color of the bars, etc. These will be explored in the upcoming sections. + +Additionally, you can also use `numpy` arrays for faster generation when handling large datasets. + +```Python +import matplotlib.pyplot as plt +import numpy as np + +# Using numpy array +x = np.array(["A", "B", "C", "D"]) +y = np.array([2, 7, 9, 11]) + +plt.bar(x,y) +plt.show() +``` +Its output would be the same as above. + +## Customizing Bar Plots + +For creating customized bar plots, it is **highly recommended** to create the plots using `matplotlib.pyplot.subplots()`, otherwise it is difficult to apply the customizations in the newer versions of Matplotlib. + +### Adding title to the graph and labeling the axes + +Let us create an imaginary graph of number of cars sold in a various years. + +```Python +import matplotlib.pyplot as plt + +fig, ax = plt.subplots() + +years = ['1999', '2000', '2001', '2002'] +num_of_cars_sold = [300, 500, 700, 1000] + +# Creating bar plot +ax.bar(years, num_of_cars_sold) + +# Adding axis labels +ax.set_xlabel("Years") +ax.set_ylabel("Number of cars sold") + +# Adding plot title +ax.set_title("Number of cars sold in various years") + +plt.show() +``` + +![Title and axis labels](images/title_and_axis_labels.png) + +Here, we have created a `matplotlib.pyplot.subplots()` object which returns a `Figure` object `fig` as well as an `Axes` object `ax` both of which are used for customizing the bar plot. `ax.set_xlabel`, `ax.set_ylabel` and `ax.set_title` are respectively used for adding labels of X, Y axis and adding title to the graph. + +### Adding bar colors and legends + +Let us consider our previous example of number of cars sold in various years and suppose that we want to add different colors to the bars from different centuries and respective legends for better interpretation. + +This can be achieved by creating two separate arrays `bar_colors` for bar colors and `bar_labels` for legend labels and passing them as arguments to parameters color and label respectively in `ax.bar` method. + +```Python +import matplotlib.pyplot as plt + +fig, ax = plt.subplots() + +years = ['1998', '1999', '2000', '2001', '2002'] +num_of_cars_sold = [200, 300, 500, 700, 1000] +bar_colors = ['tab:green', 'tab:green', 'tab:blue', 'tab:blue', 'tab:blue'] +bar_labels = ['1900s', '_1900s', '2000s', '_2000s', '_2000s'] + +# Creating the customized bar plot +ax.bar(years, num_of_cars_sold, color=bar_colors, label=bar_labels) + +# Adding axis labels +ax.set_xlabel("Years") +ax.set_ylabel("Number of cars sold") + +# Adding plot title +ax.set_title("Number of cars sold in various years") + +# Adding legend title +ax.legend(title='Centuries') + +plt.show() +``` + +![Bar colors and Legends](images/bar_colors_and_legends.png) + +Note that the labels with a preceding underscore won't show up in the legend. Legend titles can be added by simply passing `title` argument in `ax.legend()`, as shown. Also, you can have a different color for all the bars by passing the `HEX` value of that color in the `color` parameter. + +### Adding labels to bars + +We may want to add labels to bars representing their absolute (or truncated) values for instant and accurate reading. This can be achieved by passing the `BarContainer` object (returned by `ax.bar()` method) which is basically a aontainer with all the bars and optionally errorbars to `ax.bar_label` method. + +```Python +import matplotlib.pyplot as plt + +fig, ax = plt.subplots() + +years = ['1998', '1999', '2000', '2001', '2002'] +num_of_cars_sold = [200, 300, 500, 700, 1000] +bar_colors = ['tab:green', 'tab:green', 'tab:blue', 'tab:blue', 'tab:blue'] +bar_labels = ['1900s', '_1900s', '2000s', '_2000s', '_2000s'] + +# BarContainer object +bar_container = ax.bar(years, num_of_cars_sold, color=bar_colors, label=bar_labels) + +ax.set_xlabel("Years") +ax.set_ylabel("Number of cars sold") +ax.set_title("Number of cars sold in various years") +ax.legend(title='Centuries') + +# Adding bar labels +ax.bar_label(bar_container) + +plt.show() +``` + +![Bar Labels](images/bar_labels.png) + +**Note:** There are various other methods of adding bar labels in matplotlib. + +## Horizontal Bar Plot + +We can create horizontal bar plots by using the `barh()` method in `matplotlib.pyplot`. All the relevant customizations are applicable here also. + +```Python +import matplotlib.pyplot as plt + +fig, ax = plt.subplots(figsize=(10,5)) # figsize is used to alter the size of figure + +years = ['1998', '1999', '2000', '2001', '2002'] +num_of_cars_sold = [200, 300, 500, 700, 1000] +bar_colors = ['tab:green', 'tab:green', 'tab:blue', 'tab:blue', 'tab:blue'] +bar_labels = ['1900s', '_1900s', '2000s', '_2000s', '_2000s'] + +# Creating horizontal bar plot +bar_container = ax.barh(years, num_of_cars_sold, color=bar_colors, label=bar_labels) + +# Adding axis labels +ax.set_xlabel("Years") +ax.set_ylabel("Number of cars sold") + +# Adding Title +ax.set_title("Number of cars sold in various years") +ax.legend(title='Centuries') + +# Adding bar labels +ax.bar_label(bar_container) + +plt.show() +``` + +![Horizontal Bar Plot-1](images/horizontal_bar_plot_1.png) + +We can also invert the Y-axis labels here to show the top values first. + +```Python +import matplotlib.pyplot as plt + +fig, ax = plt.subplots(figsize=(10,5)) # figsize is used to alter the size of figure + +years = ['1998', '1999', '2000', '2001', '2002'] +num_of_cars_sold = [200, 300, 500, 700, 1000] +bar_colors = ['tab:green', 'tab:green', 'tab:blue', 'tab:blue', 'tab:blue'] +bar_labels = ['1900s', '_1900s', '2000s', '_2000s', '_2000s'] + +# Creating horizontal bar plot +bar_container = ax.barh(years, num_of_cars_sold, color=bar_colors, label=bar_labels) + +# Adding axis labels +ax.set_xlabel("Years") +ax.set_ylabel("Number of cars sold") + +# Adding Title +ax.set_title("Number of cars sold in various years") +ax.legend(title='Centuries') + +# Adding bar labels +ax.bar_label(bar_container) + +# Inverting Y-axis +ax.invert_yaxis() + +plt.show() +``` + +![Horizontal Bar Plot-2](images/horizontal_bar_plot_2.png) \ No newline at end of file diff --git a/contrib/plotting-visualization/images/bar_colors_and_legends.png b/contrib/plotting-visualization/images/bar_colors_and_legends.png new file mode 100644 index 0000000000000000000000000000000000000000..e3af5965a214411a75e0607fb97f2c13f45c100a GIT binary patch literal 22079 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 literal 0 HcmV?d00001 diff --git a/contrib/plotting-visualization/images/bar_labels.png b/contrib/plotting-visualization/images/bar_labels.png new file mode 100644 index 0000000000000000000000000000000000000000..9fdc1a6ae657c03c914c6f6e04b88b01d7f838c4 GIT binary patch literal 24793 zcmdVDc|4cv+BSY85;BA|m^D$EQc0!|LS<}_NKz=7hs=slBuO+8QHCN!Awz_s5|K#8 zM9Ea9jKAZuhQ0Um+t2ep@B6%e{C?}xT6-;NBJ4APn#$u)wOcX^e z-leIgPf@gL6h%|X$bg@iZqUfY|7>&KdBEAg?zpp?xuYeu+uYgyl%4Y_>!X6MmX1!= zcBeOq%ZhK>AZX?6Z0{r|Az}OX3&ialPe@dLJz#(jS!Azy(21hh%*o$0$x8RFDe8#& zF0~zo?zj3spE+=~VNP+#Q`wc5{aA!y$!hNM)f;Y`7%W({o347}&Yc@~?sn*o?5yk5 zALzKU{DAdTNx*Hw`*b zJztyD*95Q&3JVKMA5ota_X`dV)@)mbe+Iv7mtyDO;D~r`L4GTIu2NYIe=&snlV7s% z)8Tg<%jFr!@1)&X$nTB~;f*rw<88h{I%~>4JUlddSS#?DrDgoyIK@X#o{%42S*<;C zSU*WH@|EPt4-a}S-Q0X~=`rahr^?04r5Bt&eR{4?QX%-lg|m2RcXjmWVWx;ZlI(g> zdSe2Q^YXUM&WyJ?&fMPark;KL&4}*7hE3+B3tm)I2yfWHqBK23m+v;1K6oWKcqH{k z5woEF{vA7LzP`B`giq=#xGHwCt;oB#A&qCv?i-1N`ldFxfF0J>DMi)pLgyG3s}%dp z965gc-k^T4^I6Z}n#Px|S=rgY7L)F|kyWwyvHFS8sDV4zz6Z8hXC)QD&z9xpQ>KU&qi0Etvh?BQWy4 zf!Q&S_wC!a2cFt@aGGV~L*}O1=GuS!U|GL@{j*uM`BsH(_ZV4+1z=sda^(SI z;{=2Idt{w^FIUB6-FSOz+c_FKhCAwEE3DdzW;XSBeXCpjY`oR;QFivZq@>l&xwaQS z7r1H9SO)P0vg7Ic>8$Y_SZQi)EqYD-Fw@?>dt+|iEPMW(1}~}%;ar<26%i59TbIPl z%g1Ma{5S&}8`}euysVbomX?-xcQx4XL=s&3K0JE#sN{P?8V%*(;DGN{IAv>VZfhHc ztLX5>9c((8*820j1g3wzp*+Xr-_J2yv;bs8GS;%E_&u z?7OSDL-`d}gss?oHZYL>M}PlttLI?Uc7fy{J?3+>Gs_e_WN;ID1+KPHMU`>cN6VRH zY@4}`A3tvI;IKnelhM)9(XiraUY_~O%R=4Xf3)Onl5-n)P?ziV+mXER+O=!RdUqL& zpPUX`ymE`Y3*SI%Av2ze*Yt2@_hhLGrlzKQ<=5)2i8Oy5BXywIr|>bWl#~?Z7q)V1 zX>~PoL)!iz6Y-$?_t)adOxEY=c9*IiH|%~|P+&3C{`^4p@x}Lc-(=w7;R&-Xuxl%_ zs!Lo%b^sn+S9Xo!x!bq-_GOrci672CGCTbnAFqJT5YTAm%g49f)$q(L0*Upy&iNFB z`@-9|uhhP_!T-sVtydx=&CShe+B-VLl$4a*&zv#;`ue)0wDc9)asl6I|E;a=s+Kng z3&;6aY&jJyQ8YoT5`6zdY*bVr9uw#Iz~{234qZp=?7|Te9k<jE|l(DI2Oi4+> zD;D0^YIkXy)7KJ&43D_UI-Vs0`y+Zj7yAkzn^Xic^GF_ly^O44^|g)5q>qv39y?KC zyk_-kdPPM=dwctm2M4otO-w?sZ#q%>>eaWrzOfA}x11`$yN7TOh&S`+XXzOk8B3D1 zqmLXt`twE4#7Xz8tN$PZOjm`X-p48 zKCr;8^&-BoS?RR3wWE5%5x1~Ga>Z-!^4YZL2M#Ot=F$#7vtgF za5$f9@Yyd`ygInFROM95Qx5Xb6Yk#a7#z&dFDvq%dUWR3@zCX)7;r5CH*c=&?CgA3 z?Ca~?-^~51r)D8_OTlw#5G$X@*P3NU!e^5&1c!!lQ7?wOD$C0+^6bp9X?TH1Nu1qt zTP_4qtQG$L{d;stUSHpoRJrNITf76&kd)imd6aBhp~zP+o}KxXIQHp@ z9W(yIQm@Kcy=oOB)fu(ll;g~qGx}3_0`yd-^EZ8=0Cq%3f_d5b(#FR9SFc^u>Kgc5 zu(sv%=bcD9RSosUzH>|uYp|;H6p1@cTepE0j)8%J(l>8*U%h%Y`L)ujRbTQxwLGzl zqwZwAwdBv3bHMXVFfH^DvrSJ=r}YaC3DL7Qd*+@=38tGB&$isC_ijbeTR;tWg)3>< z1_lPI#OpGiJb5x|u(3;tr_ghJ>DRAcJFBAB>wiLQ1!QJsCcpHJ+p%LuX+wjNhsoF` zYdbrM)1UKK=gdw2s-gA!m~*mm(-WShOV{Y==orQx($y72Vl97UUY3}<)>~-_Cnv5Q zbyC~bve=;i(-WTZ@^Z1R>dCtI?*rLYj-5EcY+zu}(baYLXZFZwqZu>RSuj`>*=%z7 zu#t~amGk%dUF2_%mbCp6QEg2ZE`)_~Q!kKZQ|nrvopFll_nrK9zqG1K>(+L+J(ewx zt>2SNe);m{bvMGFZtLk5Wgj2KeAoU9bPHLp zeu|o_)etaB9#ilfYY*Gns=MvManzs)5sl8D-PN*AUv?b&0$3CL0=_*qI>}sCu-- zt1hJ6J8SB@YSxR1m5%j)O3Fn@2(Mkc(0ghus+oVrhl`uL0|9LH?hXx}v%}9XuN*(| zNgWNSioLe>cmI<%-2(@Lv4zTB_Rh7+sfRA3$umiJw8~8&FGl+5;TQM1g(PlbV)Dpm z#v`SFYf*=u-tc`rvs8VpR) z82&i%;M8sYxPp`vQ9zt=6(uv^t-zd|&8_ZTi}980LPA0{3OY=by1M!@S$jd(ftC=@ z@c|m@Lxvd}FbzRpbx)BMMb@mj*D`nmPslH*=UPt@-*dLBx>L9St>3ndgl9XK_-wcF^25*EISv=NmIGQmvZ@vS(OS3?NG(Rv zoR+%Eym{}9a3CfGf?u1@)M5bSQZwI~KqUEuLr+fEO#2k}{u=2op4J)d|HQLs(IRAS z1|}w^p=ya@K}kvWhSZrh(Rft&azKhp=m-REZndjuE%fBz;aTYEIkon@&hEKTqY<}^ zU6E@vwYAF-d$mR0o~J(LE=JPw?c{$|xtL#mncHA%`Pxz&7Tay0pH!4_P1)#sZJd}bz}B6gj88*v2;2wvd( z)Rr|u($YV#*LdE-7VsGR5fZE5neg~A*IkY93hW3eiwYJQt9Qx|Z6gL8*f@-=NBbHp z7Yca!0l=!J7^aTA>UOMuaL}Mz9=Ou7tobLFu?r8nt_#mqc+)0M06>b8kdOfQ7a$NB z!1~a@@5T%>-;PF~ss1MpKR!yWTC+yW_V@4Kq>QwG{km`9R?r1T7M1{ZS}d1%53R8gp0PzIkKR_vQ;0th?Db_tc{HjxgD|>R+usQ?~1(w4%y%ki8BRd2M^}@L?^m z@7mL!K7L$=y8bcGX)P8ZaSWd)yk*N+o>Sd50OpeS?>UhrN&!-I)Al`d+`oOr%9YWd zvNOGY|D1c=`1;eQmG|!5JCJ+odQ~o-`$bYa)@PCs5z)AG=g}iwn~Rq&iMughz@A8z z-?DjgU{KJ)0QPlaVjib=lbwcrl6maa60`)`#V0IVedoM!tBS)@QIV17fO{ymM(s6` zDGzGU*k(HQyzTig^f+(X^5wgH85R0Y#E7vC2qlOOM($O7&Zac&_xQ04S{1`2yNRKW zn5}mF=h*}IjQukRh#=vE5Kl;$EXbp_=8=$cG){Q z5#qt2_npv&gIQ|bt0pSn#44;r3)TBBo=!cSejlP}K=4A9p$nQbm763V_ zz3n_ldi{ZZX|`0bc!nJ#_%oCjO^28-tu#Z8|Dqe0SZRyD4utXzl=-l{R3@7Aqb_G3Q|dd-YB z4vmldejQJG4frByS;h6^V5 z9W7y|jsgYL9gc=M9$Rynx)_utjpqr~%sBW19*dO&~&c$vCd5HOCI6PA@dfczSa{d*B9+YDe)X*6r9QlgEO ziD}8cefzpi2Zyz%tHlfEzTJ;gJ8&Sz-q{&>WNB$zn_2gje(C#rZZDysp($-`HAR!V z2zhOIc53h<9&OKukqtZ&rd-~WBOJN8xuw_=&xR{j3d_mmx5yd}WqAtmxB9f>mbp-k zmSXpmK7YPr;`i^6#KcwBuO*77g^_~A0V)D--n@yky!#`QIh3ZP-^PayF`Jp0 z4P%L-3wUP_78`_{xte`N5G*AZzh=!Ebcnk`S8Ud5De^98`9=Co(=*-Npi0&tZrAR) zC95}(HHA!g@e<#5t>T5qjXaTS_b$!L%i}g)C=}q1{67tM?viiwG7FJn`xciT0xq@5o;V5De{SgLR9#hCM5jgaN>6+6uokEG`avW_kGma$XAGiS<7=; zC@wBuQ@Cv-ogTeOf$L(I@Ab8A%klORTEdFeryriWZm}#_?9Pv+KhYSmeR0f-O(WNR z;bnET>TNj}u@OB<7By~N*BBk~=uL#lG?L=p_Bn8^5$As-H4OtvfC` z?1wz^y*}j}J@Zm4PaBVNr(l_6&~-a^?wl0wN;-b@C@tt9@8}(BiCa;&tbjU!YR>!l z`8m!oFWpd*Wm)~`^k+FjLsWz=9~vDkM@NXt%t{dmDZObEz*A5{f-uR$s3b4&W=dXu zc@vULYisL)92;&tMafeiB|kPdAN}$&Lhg1(`q16&VuBJ9Y)EJ?-@Nhe+|{7Mh?@81 z%a`6FS-N8S*tZ!&|TQ`@N*f}}RJ!$ha>%{8ZwV_v~T4a^*^*6l%08DB0%6)*@ls?A!gS zVke$Hl|_r(n{#SaoLVXyqk7u^ABFoCv<7 zxUS9`r8z<&U9xv`<3T4DU4c@0__0;33hy>YH39|_kUJ7cC+&OsbUL2I67=v~_xHvv zRhk)z1fR^Fwm&1?{x%XNtsla9W24*LthdA0*UO`B)JI*vE{bg<0yZZQq#pomE{MON z3G~RO?l;5x>Qf>oCc45m=N1BXT>y#>v)#*gGI<;<`8?`Wi9Vpfi+^Z^@ z$wiwsZ6c^W;@Y))Sz+XD=m(iW-Uvlkmt$$lLH`+6O#kkQOF$P|`uerbv!7M#kAf)4 zzmZTO-#0Vm;IUXO+(Vu{>e@9XY_wslx0da;ZQICer$^rJRbdnY;U_``gAmlV@R=Fi zPYA8zx!Lsr>_^Kla3_E*Pq=eOdBrA|?}oKt{+Jr?y-~gz8!L|e84wf{^buJe{Szly zBxW9Q!?cQ?T0=n(XTH%uBGibf+*UTUt`YKRE##u)$4!|mEn=M|0)Yupn+|DYpUFpO z2`QrEW2Ob5^9!)+7l4n1Wn{QCF7eV($P-6UhtQ|{nTTtEiWx#br}ZfYvJHTA2!Tpa zZ6I3gfP7-#^Olb)xh$mm$al_%(1p_1S@4J86+=TV5E4e;oAR9QSM92{{4|TEzhhuP z{B!rnum{U09yoX~9)0)(8iJ(R_50KBoT!N<9Q%U@4+sYR(Uh%GmbMFZ z;HX%?cksv=iNLdGX}P$#G{b-W{5jioD)tBPA6U5Ogv(yPKFx8)(!9HHy!9M*J6T@< zoFm{xdYg0Bqu*GFjZKw+WdM%eqo$$J1q#L;J)M+YtGpKq4GC|&Ea>=~8|HXW6t!?+ z5L4qBR7%pRf^+o!?(K`HI|pX+2+A*HgXbiP7J9lRCMMoNpU${w(GGKSAvDqygn?Vz zoESjF+N3W-5pp$bR!-at0AG%~%9)h|Q1D}?1%~kX9)p&y6VK%3+qdVhUtdnO6WIe7 zLh$9cO_peYIk>q40o3RyAcKI333qa}L_9(}wqfH&vtGwnAmhAnD|;8~EnmJIT&tS8 z`gv!S*2GQMxZ9#4RZO7?BtLGmcF$H4G0r1$-?Rk;! zJO*B;;OgWQS;{^%WU-Oo>?Tk5_wSRh6|_V}Mc0XnKF58f)|rCDY*0AeA`8&O1UwrE zI)s*vt`>x2SiJ_GwV6?~@9jlqX^9(R10e!7lPuJBmBhztNc~KFsjsbaif9+eje0dbJ<=*_M zUy-am3Z{2KK_b~!@#(MMzF`Yc^u*-kQQXeQ0yl}TZ*O0OQg9SFy{2Ugo}YN{Xrhg3 zar9ZpDqh~+$m9O#lpJTUzuo(D8t)j2={+>wOxob?Gz1X0&qg3PLL)!kCM(;Hrzw_k zc&t!Y13jd!zW&)CKYloFR?O!~2LV3OdpG=%_mr#7Em;oelzLM+*vyZ2Wcc^K2;sD9 zNaZ%pv7x6J7cbt4H?#Bevr;kAmP{3w_%0G^6J$aqBp(h=PLadk7EpbS85)R9lF6RU zjC~?nT+#2ZD^uDkDj2ZZJ5guRVUTK%jH2Ds+IvV%ZGo1S)= zzE9nUg}0pg=$D+lE~jVcds@cP_7eYP^6rwkc5RnNMx1%KyRwkYFz}fzJT6>7i66wW z=H9)PuOin*T)ymw#yfe&7znWWPNV8^WL}@IXJn9GoW8z}NDuW`f}MQotF`D3)`72QMUHmH^KIdF zuaUN{TeX0m{&`s$9cq;Z776m^5Lo=9;9!Z;MmT23GKIPaLPJAeoQU&2k8kK~^PSsC z=)+vwLnFPlbQF2A(56fZJ-8v`5(Txh{9=O-AMmj4<&X=vnohQ(-XF2BIES9-Ww&Eg z5u{H+1%<=i{0fPOO`L>N#oVI~mRom;WuGYYRZ6dGjfp@kXzu@?i1Y+~e;dtyZR#4^ zC+{-pA-Y4I~SWfdK&v4jeipvThwC9xN1|>0uG! zgerf}V3q^mkc}T(ks9Ubt-?4m@OdSwODPaSD45je4Gr9Yv@dIFqAPaCNYW6U@7l&g zq^^)=06nI@FKFuNnHfFM-;k*+KIgl@H=yF~{&de*O*J(`4i+_r*EKb4ao%IgTfN6W zJ9-nL0Gs2HW4G3`*~vbu`eY6QRj0-WyY9#N&=SJ`D0<}skF7ZJoxjn7dqTqOL{Bg4 z_=S-=f~A05z~VDKtnv6%(-QDg6R6*0&m+%LCE(FQp0s-WCD2Ak^I$i`7X-pPL7WqN z4Rv)XN-S=T-LYc}fGW^VvQw9@UJU@8M{}WVLFi|Yhr&`)9Mt8Q7)FThQL0wpph!Do zVP9qgF|mQgRn!EDPZ)|1; zd;>R939=cYvp=M1t23_H_;W%2!LijyTG+xQCt-#Cp}f(!FN=W|#x5Wr5w=@fTNSa# z#Y9gj$Lk70zHMr1s*3?m#@2#(p=pc8S!|6?j31F%z<GY?b};>jS2C@2`B?e~5z*y`owMai>hp$9}74nzs~;@+$E-XBQx zgd0n&jE|3}{O;TlMEgbdCI0heRh7y^;~Yu%p(6yTTCTjvBSG3A)J&t(uMbp!y{xUR zUAEbV3kw0@#LmSP0P$OMW~*K6i}vT|A|TF#>m~OOHtWN4CbY*2t2k8{y?OMSy1Tod zV~v5aFIRVqd9(4$E0f&!`LmI@-rD|-8=QJZ9b0Ul6lo_*i`V>WoY)dKIy)m9t4dn? z|D`*KB%c4$R-{y|bJ5wm+SSF*Q_*d}}kwM_1| z1UkL<_G}R}7oifL;pOJ0M+b~_ON0`%Gv#21GR?~voWIr4Q|!x^hoI!mTOU5?Rbqk1t2BoH>uaB8Rm$3eL zO>7u`SyETG1hGRhE%6V17H5KuYt?{|@UGLR#i;*81Hduj3n*oDuNC0};gCn-Q8+0I{WcI0*oxFp^rmO^Q?6FX zuQ*>dSv?uMc@2Oisk``GxIoBfflj3S?%%&((Srm(BGaO(M){$#-cs~lv2yF_`rjv? zSk=-(&0vESM3j$_{5|8R$Q{a1Nw=ZfaT%J^tmZS9;6i zqN3l1ra^}ru6`cr+sP0C?=?6RrsdEVAUMYY8d>R^{XfMacrhiKTcc#EW7eT|R zLUtj*`a(1h3*Fq@qI^(1K#mE5lC*)BG7W|*pn_{wTDY&jwiIC|zcIuX#3lqo_ zd}dHZj}Gp3m3+`kKa|rWW#<=9px@Lh^liG1^GoIa?S3MY)P!B{jy+|k3dm0 z6tLJn>+sOftEX=O;~j+(AtWiO+g%ZA85$PG!N(T{28IB~swyUEzA>9lT#~6kq!My5 zU=imd7&AcUt%T6<(D_xNiFhRlwnvaZz910+2Owqx;^N|5dEia#or_##`f1t(whq#B zB4WY&X|Dx_CA|=Q$B+R{h@nQjGKiI0Eu>YuR)rb63{iG(YZw=~IlHRiAJgTYl{o{DJ zFONwp>>qVpqS6jDOxm@F4>#hrM-L-B3Rf))mbvp|Qvv_X1XCS9RBP)u_!Jp`e@!~@ zjD%do$|Bo*108h(rFNVJZAFC?yY*$nUE2e^HdQdzaQFXaW=*U2C$!_HK6NWd%?FMCNLoS?`X|Wc`kiRi3=#tgcTPF4;Jyo~G?f1kj7WfKx0C z6@#SV1CNf-T$3;p4?9TyW#ggq$Uhw*Tp%%?&B&18mv!fo-~9LcJ#bZ zBT0gRI#UAMLv6mxNlIBqhlOZ)1Y;A{_@T((glC|Mc;nk+A;G;#UH?+E8qUn6*LwyN z<+(UnGl)GwtZ-IP(vhY|^1Y0LHRBV(#0e!&pmzp_hpt9khqNRWgI)3~J1qG3! zgms5x1&b3!fxQHIBq%DnYelwQn<8GCfHjeep~n&#xkh=g>D9z43?r4@1*c9tedu}v zp=X(Yd}K~hFd^dU63?P4G9HMcOUpMMFDWml2W(@QFK?ui3g!@b1jz;)h`1%e44Va} zlPgV#HcMhvL$a=f8%@$<#0p9l_)U7^YeO1Ok}|lbvjYu?`X%0wTeo;0+qLmSA%uM( zy5fOZF+ZsjDEa2cjs=vIC~r8Ft0Q25+fUF+)^7_+&T99@3is|DQdHxvoFc*k$G7GG znH&0FG7L#S|6LpPfBi-o7}6F?Uw_cDAE1Q-qFV@>$-l5r0SY$9vSq<&*`jQZ9XnP6 zAOg$|neGK7MLiRf2jSl?`E}!a3Mv!A1Ka&&7QaFA~+$?yQ1oTqv5J=TgO3>;A11)zVvFwE5(Z0WVGk8}T3UL_- zCB75HGkTYX9%s|wPme!OipN(ym9H`D`efKMbJG)#L9+`8j9BZAB5c6+XliMx=;?6~ z%|Hr7nmRT}1iC3oQ%5HN(BV&E02@6rlG~US&c>er8_j4DQZuIClitP5iz_FW& zNXG!MhiyRptAhh1X5z6WmX?;!o0<-;aDsy&$~Nk7;Jz*AH4lk#1!Dsw{hYvaS|={9 z4wOMr;LOjV5P+PKF%!bJ5kCnqP;mk10u6tRQ?0sko)ln}z> z$B$F8a&oj30E}RCbw@`>{8Y&09VxnkTAG@dXA9x^G0ZR}I-M%~(G&%&Q~^@E7M`?z zLolpHD!^;PA|f!E1P~a#5th;aBb;$BLo~uaSy#}bzBG_I({0dHl!ZnaUpdrtB97o} z&b52$t^ConyG(->1|wMlH)GZ4M$>1@V4ngltp+1M2)0bvvs2psljf$^k?Gi-dR8?& z+o#Bsd1GL`h@)hM=mk{KH39+x^8I73@LD2jFv;-3Aa3yc_X`mHtkUEY?(0v9WfK8O zHHftwAc%Biq?&;IQnj~#RK=%(QXHJhlrzo_?97C~Erk-IYiKxPFVc`IBrCfN=Axtu z=2gN8bC=w7(q(O1q^^r8<yzA_ggDRdc&UL6~U=zndpT9^K2V;kl${_ZxIB|>F3DX?Mx?l6L6m*@F7s| zlJ!Ke#jGBzBYEbq{*9JP7G8fwTnW=GN z<^UMp0g}gO_V)>B<8cC?$hR6@X%2dgU3wngoCGid`ky}86)%P?`fP4?>Oh`j(waU} z9_r+%t_%=t z^-P)Ex2ZT#S1m!%^>i`=EH*!w10nnvcc5lCSU{@bXHIlG4#QTdIT~nTphQo z3dv&r5g`W;9qK~8rU=DA%yJY3&lH&z$!?f07Jkj1!6@M8!JOO$Xo3lcm!KC)88iN8*9owaWau4 zDB;5focDUeK4 zQWib{i@YD03XGgo?=4u1qAIqlU%CFy4m!+Ma1tROc3IMKPy|W?ytyMUfbzZPD#*mf zRtfC_Mz8Z*Y@5OEQ0`BkBx3*z*y4(Hz0bigg-U;qeqYat;s*afC}OICqT24GBun}zRpJPBpYG$ z2$KaR+_vFvXSA8m4paa#7W2HemV+<@V1^QB!N&uq5^B;G>aErLdy4^mX($Nn*ga9D z>=b@g_VOho;9kQkd4ztlBiSEo-dpb!r2lgdMsn z2yC5i{^!N^GqJ$J_4f_MI(mDP>&&2-d~9mkWx>B+SJw}yAxZ-A>~SW=F$n4-JUz6h$uDOmckc&{OzrjFu7PHGFRxb2G-lLy#o(MTQXDQ9iq4Pt8pBWuSKOLGdetfY}Z-zFPYl zA*AbKL=ElzeA}0zvsMO@l>-0D zvT}<~7d>(ZhxN_owMI2Jx9**EgT=N3-~ze?kx6=+vhV*{=>q4x1QL+S6X1)yk^EP6 zI<^H&rx#{(x|@rq2DZPBQ!*3TNz(VXE6x5^pv=)lI^>NZB#t(u8qEWmV9jXL-mEDN zCC!}BbLY-Ek1of{^^6i+1yc>~vmzxMrq2M&O`nn^k#nV9F~tJ~ahZ~jJhII@SlcOO zFE9CfI@ixav$FZKbQ)}D-yJKzoRGw523^Hs2q_|AHv;i7{y zkDh=Y(!t9DL)fbHqDD){g|c#UD~KcVl`&b|5taVPR8k2{xBO#Bv^Qzf$qySqokV45 z*sYraEC>h)C~0lwhc-^|9{hS$#D3g9ILHQ$1t^w?ZotJKMh$~CH2{`PJ^MGe6nU?t zB;gNjDRA4Hh83IHj}~+1@#FVKT!z|rq}Y`PEW)@9PwuIvv%oi9pjT0TE>CJ}Y2kyz z5#B_(B={Hh1oVZYQryCI{!H`<#O{lrrU(^Bio+kDjkPC+wh<$E@a7o_a26Md15-O% z9EzgKv16++#uAFHKv93uwHP8&!$?_2Pfrk`Yw?ik`qhJbyY=JKUK0*CUNwkVN7z+} zz<)L;XOy$@r^GtpR2KA1Y}mKhNviR>M+RE*k`Fx*hcXS!xd4^S`V<6Ry(gy+gOwn` z^hbZQmJkY3fKi0{2k}yiOz5o>68tz>#UJisCJ@MK=*N&Hh!X+>bh9ba*F%92M$)lx zL_Z_sCe#}2&%1!avfh(2a6#$p-c5#HfAXTj6Y_#hDSNn9((r@X2MsleIII`)x;d_g zqC`YQ(2tbW*6O7Nf(cm%L-4mY5Q-YGOSfZ3;9oK1s1hEBCq;zog25|xqF@6WEJf#pVZ5{R+ypQ(d=R?pxF`w|4TKz!0@@b;=#73&hGG?3=@OjIXo;gHM&9)#2yoUnXP4K0EzuFI@CTCr7@aaqsBavZOGves)7P@ya1+ zVbeCv8$UJ`~7g8e0U_*If+ZFyA$ z6V@U{y*ehX14)>3jSiW!Qp~^EC2dY^k;0zF3ii7 z*%i+)faHf+DP=^$__3x%Io`za?QFAuF9xiL`-767R&Lb5#lA6wnNclK6=e@GVO#%4 zA1C3}G=peoU%B!kkT@L`z`kNV8dc@o${5xaY)QDsc*o6txhjp!w%vAx;cUoX$;z}=|3HkZ! zm(dtY6d`}X@yY0u^b{cu3?t{<>j#3y)MG>BD_zXi!q3|N@JVak-ybcMjUSQ9F6+>_ z01S*2?CZd|ouG!u(D@ddRao*mG4z8N1!Vz^K?V$JF;e)Yr$+>;BaGrI7&6JxgL=&o zu@7AgBZX)if_Km=e<^uhh3@gn&QoKySpTIcGxQWt+7WCfjI6)^r^^7LS^_EzDYgvg z+yQSOC>%yj;B3Etx(rAscd$NaR#$_LrJ+`@UcC&n-;iTre@qw_o^Mrl^(&~sgH-}l zk|eo+!Uh7yBRNUNn0J0@lKJNA&bO9$joX-IB~rPj-u!AC#;YF3xNY>vAnXT;^kOcOY#f20KVR3m?_;pACE*%EJDO4y*d zl0LtBwMZ*Tf5k7WWnz62eV$kTr2SVU$6_f`&+;&lQbcSjl=7O$UEbldhd7D#o%j!e zFJ3$cfnNQ|%!dEaiO6}97N>4w4qYwM>F{T_Hga@<@j4A7ef=dM_lKKLX6&*>_>)GI z^i$-phCj_1o+0Ra$hi^}^nnT#K*QWauH42=F_oAAe-6iLSvGOlS84S-1tVd+LoaMw zufGSGDgqv2_>8}$Va6X`^*bYWe=w8UHM{;7@@MZceiB%DNCCZM+h8g;^Hh_xZT;N@ z^to0a9$eSD85PBilN*x8(5jt5yYg zk|)ks!n}YGU*^E%D2M8(F~H_kYanO7X@XzzE!OG_#xktStBy znwd0{L&nA{h%ki~*&O?u2*Q8$M?7*tD9tCANgZ7P#R`H&D8h=kD==JtBb`WFntiC? zi2WFhc&w1I^22BgASdB2NwDO87fG!nwl1`=s^Zb)PrNQ+YoaCvrDrCyl*APbgIFn$9-+oq8B9%@@{xIDV&_sLU-OvW#C<@W`xX)Fwt8*Jl7 z*N9U^Y6^eE2FIpDQ6}T!kj-E!`ln7r=g)*G%Dx(tPw(FwFsV|+2?)_&2(wmTl|j2xPP!_+S7l1&A)=}|EWjyzqE?| zw=`F2cEbIEj<|%(gT|Bt@Iu|#_(m1+t_q_5kByBHQV8@Eil1S{zZFfZQ-H&)dFdkj z5o$^RjrLz&a$v+fJ~^2Y$HUCqRR8_H|IclziubVKiBb(ChpBJsIy#|MUC>lPbO?)z zE`sAx4J;Mm7eM3PL4Bb7;MXUvE=*7%r7nJ9x+pYp6o4}wMZ9LXW@2lI!Nfh0-oYF!pui$v=W-Go-7-``IB&3Zje;7` z$XPFi#YqfPdO&%E{gwfsryz>{wN*3!*s66g8fCf%Vc;YsrCjwm!#b=jhEgh^P2(6Z z{4}XVL5%@)q!cN`Dk`+-N;c-eVfmL8v@3fad~66iGo6~9RcUE~&`T9&5T?WMe~gsH zBa2GbAD^DE0oRJn!1)ii{|+y&XZ4V`|4H{$Mmr0XlO%hsBnR*+G2)y8^m>Vxk28FEX4> zoW4+{h=~w~JV8$ou9XdJIP=r`kNH6ZNS^+LM^qij+A%+*wXC zF_~(}w9tS9)&d=oelgTt9H3)<>J$soA)Dd^1uIhp9_)zJYE<8_2(;-%7n75r@sZd? zrx-nOy9@n42@9O6M)?)b&92;iLuSX(qr&7EF9<>0aMYBbKS*3pW*+`h(Yf>8_WVmr z->~hRP%NDssEg-dE&~W)(nSxA@eVzn{19u#!yPfMxw3UK#%TX`VgE zi-H0%r=aNNo=Qo!6|#AKB^kJ4&Fi&CqLS{Eqq|L$8_s95X}Znt-l6tTO2=Lk#-MX z#G;whs`|pS2b(ZL-0-`C8rB_hKOIpizqM{FDf9da)hD@Sd*$EI(EEF#(;sN?)gSM> zfTsgou!!ny$;;OA1Xp*SWjSqoN1+qU`|PkxV2X&$dSK?N?qil`4{?&>;X|rrWMb+p zbi!q5>Zj1@?K~ZE?BC?eSIC#ay{q+8{+M*FqyPU}9wcDy|BmxA({*#tu$~ z5C`xB5N(UV0CI33Y-y4)%9u1=gGS>hjyaP(^K%u^qmdNRYxfn%5KO%3+#)qNJxXCe zlEk42gqZ+0{OIxH7qAfAA0(lmS;HdC&W$5Bkj;^8^`WN_QwqE&$(2>)d!&=^4bnPy zU~gaw${z}tRsmda5VZ##yO^1nbTJX7fMYA@Ddb}7q@pWRtBsomsx>3q=+ZsQtsOsW zGY?pwIwY|@y}-x*^Qh{|!A#3fTq^Qz4|XgNc6kGr7dUM3MpL+*6%19wvzA-l9bCe) z1UvfFwcY~SvKKCmY_{oBAkdCj{Q5ChiK}gRaF7#}2SLTwHS@%)Q{M1j-DUK(YlPhS z;}pmD9)cKFHQ4M%Rlvz~0TZ{GcA!zAhf}{mQ%MCY zFQ8z4$9_~HiX|CNf+C9ITM4CO^zaIjQm#K=kbtoP;u``-5u~3&*mul984Rew*eNV6 z&%hZ>5xeeQc{TNJw6)|cyKYv#D`WO=<}ZEzJC$zh7=AG(&pIJGW=G5Xz)kPL{{+m8 zT#-X7jU!MNfgFUS0U_HUNooChW?0PqF%OMtyjtjP^V;)kP%-m#F%DA%as`?z`$_rP$P^%6QEvT{l=_w419sGR2x;0)|F6| zWFi5k20<|~txxaM9y{j@U}4Ca5~kjxMsV|*PfrZz$CxH1rMaMs-VX1=ni;c1-E|-@ z(;~NhM@iGh$$$c&!^jb#d5S^{JjMsYfLc1>LaG3b4eFl>Og+dy?V9o7VSh}T<00AO zkPe{b1kih!#f!>qfau4?!()N(AT9^&Fmm7z1c%#ia-?g^^UW~%gS|u!Cn59RXpPAX zGT4p$TQ*5q7!87kMC|e)M^w>1WBwx1h2HP~j(>kT$tTi%>EVZ-a3X>0mV{_Y=9cd} zJqX2eEo9|YhO2-KlL29MfGSmixzXW!z3AjWAd6<}} zhGsh$^eCfHKrjwjLnA7@b?g2WNChItq_5*9FpuFdGwFh}CuHrFS42ifucb6CSgz-O z@J1J13XKJ$gqjwJ00|mp5?$5VsVjheaMT^vLg+==W*I3d4zz3$6}J>T_fhO<$T4mV zbT5LE7eLJRkmmI<7X$7?5aY&h#w0+15X&IPlVNNitzXn=QM2*52If0=5!R{swkG%8 zi!Ksf9UVfLCU}^1y_aX4efb@fP6|gKt=g-GNp!_%#nIK2S8f^{goi8zTU z01?j*R}z#wa!L>se@3wAd~cI&-qq*hD3TK733c_k@xGHVY*2N}RHOf!(AA)OVD#@{ zslSI3&d0z1kpDjWo6TnsD_TafzZ zNNwam0x;yne>}g?L^Xq}~FA2S6kiPH-YDn z0(B8Vkc`|6>a#GRmLT-WA((JhWa8vUG%q%zIV0tF6stpL!!ZGehCbrv&5KwG!Ye^x zgbOQ2hMa{1E8Gj%Gj)mCqq(^hl<@pu7{T}O$UOC)+Ja#!>IlFX_CXmEPGaHG5nq|i z0ZQ^n3B|HZlENf1ahfBOfMzwUSe5{*fgp~2C0h|wd`YgD=0I}6NqQRH8DHUt1?1MY z_^aJ_-i*!{Es@C%N6qZVOdg^pCo1SjotKoo3X{rCWo5srEk*Dk0H~}JH+d@P zGtsdSJmOk(MM<;hLYU#O!Yqy;9_>za(HPplf<}zv)vH%>x9u$BFS_ukkm=BiXrFLs z!Wu#_140Plu-eq@GyArHx>*7mq!aU4Jg6~sjR?O)DFN@12*}&%@V>->*$e>1f4G?(DkShJ3aaGMX?okzpq?(@u`(?6bKLRTuez*AIjFS1ZVV$2rBuB$ePq6mpiy zez;LmPxXKgFU6)te-jK})&;mVE+ixfM@eDIEdle`^C$bH?cdwInI%lTab{OW*Z1$K z=ML^u#C?K4R`@lS9UTU4@$r*6B5@`E?AnGB{l`h&|Fy;Z-@$xC%SA%%{r!v0%-S5i zaqyKNXmA{IoElUWoSX_*d4d?uCBwOJOQ4vSBflq&!A7QYU78+N{QbYV?03V2P}e&K zuh__1r4L_W19wY05Hj2z{KQy1I%}6*5I7&9cY?iMIcc~ z)E1mvu$KX6dom$BCq9$ z9qjc|#5)EQShsH7N=%aAJI|svkONeZ_{dMtLz2m1WHii9C-)c$Ch(L4C`kmupH04# z_z}V0+XEMnv2}ofs0t$YqwMYgQw|W;;P{E0uSi682rVFZcKKTY`jX>Jk{pP=0_+v> zokiwxM2rnzUd~a-1w=TEgNYN!c`g`MC58i1A8`8Pqzz_LD9xa9V#|kN>MllTkp*#b z8XX1pEBRCbL>#g3N}OX#d}K(b)XVnso;NlsnOWyZz1;}IuiX7HPj{gHq zAC&>qqIOU&`A_&3%mHU*F+v8c#zd{#u)(k?9frNCF7W7GbxGR927%*>-eG_TN0XT> z+_XyAHU&KqxSEcfM$i{}ijd>LVVi4*P)43I za@_jI{a}m<5Nh()4jzv8y)n-F@y2-fzBk|xd++SM)?9PV`OUJvduNUHwsMMa zGBGi2J*}^Oj)@5dXJTSbW`}_%8hPO#!9Ql-b9yJ4a$CemOiYqYr?pR92w-Jm6&g_Ko?WH-{~)vd(6XTfd|b{XzPJmhi3_>%wS`!|92q56kY3c&M-7 zTJpjEjP2r6->ptZ^W1cjG_y9D13YLJiq5;yseog)gAm;%TkdQ^+5_ z`Ysf7T8%GFDC5tl=LjOod9;|AS$Oni&%UH-9p?s@T1;p;!kxYAkL4?or@b2Y?FwUp zu`3{ctp7X*GmM){58ef1mkeVf+>!X(SHF-BDJc<1$i4gaWh|bA=9-pKIC7+mgmiRt zY#e!n#2}9*-;`&}Ys&ird6cadnUItu6Ol$B1xS2tyANiTR8U^Q-f3uPxOEw0Xk@fq zM^RbX%zSGnFEsN-c5S>bDK$zb>)NF=4b2MM+8`f4zCH9`9b7M3XdQ_^LY-D1ovVq7dO=CQxtE1ZPE>P8!piZDK)uluYp zr-KH+-V5(!W*+o)zz8#Q=rJ+Z!_Wm!_xySv^&l*4rt}aZD(tpYSlAVGWmn^)U+$T8 z^|dM&Fa9NBzq>=jFZWDRyCv;|a}9;0BnQ|f`zO9juG47xOhV6~OwFr`nPI zm1wV!aT`5&$lUC3lZocqTs<6BR$SO0>8#A9dyN+uqVry8!H1V2VYe9FBW3RgP_&nA-A>7Zoc#^~)N^X|9n>bWD%YS1C9?O-cej2}N7N6&J|w-Mcqp$<8p2c^CLX%K!%1 zR_kg`s@!UC?IJs{KXe^rf3ND^6rjN{5vW5Q6=-MWHC2iT(2W8oWXrn5A2)heN977M z+v&a3a#fq}ZEXUY?W)IRfs07yXhHU;pX`X4=)wBq$L(}XgXt@MeFaWxj82+`n3L-BZY}3KU(nV(HVB7!ALr*T+9#T-kJWFL6Mq)iwN7$<4~woD8ecST~VYO7~$z zkyqbw6_tgrS7NSXdsfI5sP;Ezs(rx}ty%(saNgH0**HTwA~Q1+9TX6$6~1nqYdnyx zm-ayUSHbo14xLCrS*!f3t!X;yeiOoS{+BPO#nWq%JIueI`OjbE`;NA}ck7($E~Qkl z!B@NRp+!E!jn6zWF3&HAk`FOe+psvYGMp!IH)QTUSb_tHU7fZ;9(f;=sDX);*J< zupMx?U4i4Li9Y>aAQ-Qn*tOd27AyzuoAdwfz=7uFXSir!2g4s_X&Ud%BEr}fk;H9xSkJvZ{L+jJBfLrx@|TkQIXUMh82tZ%(Gk%Ws%?VSn-uAl z;M^DwocPrfqQVf;R|eOxewsY2^Cra`6JpdQ$(0lhp}2kdz|9fA#9d}4YCYxY?hja7 z7~w;q&-;Y0y3xZo`;t8E&Z~TcIWa;*yjRKd(&Tjgc7EgHy#1nA(FKf{)U0~(bGPyN zmt!0m#Lg#M^DDa;@n%F+&e=0#|GD|wgh{u?->mxG8L@=2Rp@XrK_D}*nzW$oa7)Hp zg%QM-!nqQOE)f?r29PU>`6mR`L^s9$Kc{Vuol zg3*@kCWeLrl!|z{E!u3OHVnTRyK&@CcN+4`Xd?D56vYG&N#XdQ%szCn20n#L4yhs| ze$y%|+s^QYl;<1bdirCsZHlM97|2gP4d}VvnPZE?Q2iEl3KIu-a?8wqYLNfhh984a zJLemR4_zo&(`@g{cQBxPIfNU;m@A1@KP^6^#qiC*T^lY7DuHL|O*m>V_G-f;kOyea zeBjrlFX8)U?)!HKQ$C?1UbM4Zw&LSjR|5B6e#!`GBtL9%j~_8JBL(B$mH*iIs7qCa z(x0W!a?W<1_4PzZ8-BN{B}R z690hjT90eu8*wc=UM`3_r2&eI&=q1|=*)M<9;-aY_hX2c`TzP|$5afIJg_l>d4jPm8NEC+(a&w5Jn_ywc& zd}Elrk%1ADIpZRJVLfMTzv8nIf+mgQKub$V=Uu>5mUIME zve}je&}nO29pX8TRnl_hdwzzk!CwP^_nd#7ZRpbQ-Q{v)^~u6WIn0kg?n)duc+}d+ zO0skQ=O+dK^vPkwZxJ@rCUwi?d*%d`QeL0+`Vz-VH!@gIskI;#Ib+<{*E9cdBh=(0 zG1_j?=KO0co)3P;_?XHK)#%|VPb&QHb%^BbUFPVP5o5C)tK&$ zPoXxcnz7~dRj{D;35T%XH3ZbxliE2s)MZy;rj=?b4hIdD~<={8d)Ksi5umEB9F(j_Or`2~2wI zd?Qr86O>n>Q$FB4&FGm5sNI%l>fzj-idd1H^v1hLY|lc8UjO5RBD!9p%n`9gJkTHp z!_js1=FlJ_BC?aaeh!k}6j!l2T(eDmf*ZA1!{uv7Un8Tou}h%=zSAJMO-d z)^j<>t~GQXd3*;G(>6(n3m_o#^bfN#2~dz%_-9&blZ%{{aq2bl&XHkS@wv;ck~$*> z?OSX79b1HZL!k$11|wPRJA}%VpmQfr_`7X3Z@EP-iYdn4Cc1=`+Ur+8(j~tT6mavt zHg}b8>NVO4#ZGW&3)d?wUWQi;Uq5VGq-uF#5%OIeN< z`Orv?FKbNAd>n%C3KlsB4TaJTa>8#=M%*ig(?n5(j|&G9rAI~G3%zuqfmWUwM%yYP z;^m@6?$S@(&Uuwg;6X~uEPqO+Y&~VYRelJX>=dC?A>DwqgZGtxU`_XnV%ivT(`d=5cotI=q6yqsZN zsqO2fEP|Kti7w@x23|r>##D7Otv|6=z-~6WS#RrYL0-cAV?n!?${1yr{hSJvCW^Ob z1>8!v&agTl65CS;UU@RFJA`43!dueV1c~uFTe!3}FYNj3?+Etze$M_;z+ayo=yk+lrBqhg+4$k;!2Cboys0%-a?X4?tDKB5`D0!}BdW3ufkLJ8?c z1y)Xuj^=r`A;V8Cwh6QbiRPsHJ1yQJIA!ivH?#;bJD*c81BH8rAPR_iGe{6Kr;F1q z;0!fUE)Tcx?R#ycKe@N3DP*QrC^cxR6j$8i>Cb3ij3+py?1xx%%?RhkacuD_H+?_9 zv-42_^M$30@HE!|=7un>Q-nX>0wzLu;TQr??{rKJjg1%Ji)(pCgyGWBl!Fo9bFoun zA>W7N?8-yemV1fxAVoz*)9E{a^CGDb0RxF3y^@UTSw@oRxF!R6+}zM(6Tmy_5Pirt z(^Eho(y;Gt1w?vulA$A%>G3 z_h-qk6dNjfs3f3b6z5rt1=BXkVci$1nwy)mtqS%|pI<9VO{GzkCWIe=&PEi{hxl;^ zr%gr^v@xKO4o;~_(78mlP`UTwz+E~emF~WBMEqE4>ZST0GbaS&Z*{BqgjaWvz`lcY z5T0vO>`D6aYP>VAVr2?T4Ap0AA2k7ghK8$sDEI}lXiG&&E(vKMyOVU1J*IH&!eTH) zR%G^v84CHwMBRi)h-~1Rjr$%Sbp3bF2~ybcTjQDRtWRZ?GtMXATG3LS)}?j?l0~Q90v@Dh3Oh@JHR)C&haTGyYo$+ch=yK zuS|qcdx}F=7Ch2GU$zsv9n z!{M6bGD=`1IOu^#rUd{q4YCNhB&4=7QP7!fMFAbZIaC`ExQ!m$8O{1zURahGq+PhQGiI)n2C{s4>q6)H`{E?cM3Z2|^NPDcyWxwKY%O3Vy+qTHDlqU>&E?h@ zT0fiS4?iqekNWrDr2yCN{z$6M5JP8?Lh_-b5W`H&w^@cz=eeOalv(F+P79U(;9bOHN8hCT+P zlu`oL#z6-YH}uHBJjZ&TT0zGR`N?$(mH-<}kbB=g#v-GJXwjsvo;N=7s-?c9EROVL z`W*uF_;gHVQdW)*Jvh}%TPS9ud3_T}Z%}vdSN8>7LWp`%>_LnzKGWDk*>`2Xve0ri zS|SBE96}E23*Ra#hzWU_tB6QE)&e$B{CbpDc_>IMRbI96?1IJ2Q2r8E#Vs1$E19&ds@-QNw}|!CB3)*u{m8vI0Ey_n%!`1Q zQJ^{GHGA)a%czC9(^2B#~YC#^B>r+4RZIG;8o z+of&SxdwWjp+8Q+G4mZZ22;a6zUa|Z6ojszP=!1P&_)21HL-i;9?{J2tTBj{IWqfE z3a>U81u%T);|l6WWI`WT*(nAMdMDsJ|MAg@!31s=vd1)2`^6b_VNO67=F~a91>zCg zmopI@%Gt;a?(jLli#{hkyMsYIrm)7#Q8WVXLh$(DWEknu$%lA|qs$Wzh|~$>Ds>1s z&;o#NED#a=8#HibFmrlSFn8}xh^+jQ#~$F?QWXv4CO{L6NE;q9_;(=mM4An@CYQB1O812BU%~RYV2pMS7KP z2qGY&z@j56qS6&9($AR7Bs=^6_kZty&b{Z{n`irw$SU9We(yWym}87N_hrT7hnFtm zT*P27mNJhVQf4sb>M$5{8Wwzmzxm0>pC3PV+skO$tJs*@I~m%UFpe48+gjS#TbiBx z&e6o~teK6qnD8!PF~RRn+uPfol@t-N`s)S4Hg=~(%HL|L;6oPL9??3>U@SMJKXc;t z#hNh~Ml9x`{i^3~_qRLia+u7{ejJsQ~(MW5$-x$L*8nfK-6E{B$Scg}H_+UWb~ z+_|@TPoKQwlzmzKMAt}kN$Edu9gOg!yPNXqUl_S7R%Fx9l5ZB^o*9f2b1w?f&(t}; zt)`z%48z6r)AD@kJo>rw$EL67C)anDbMWK*(tl(#UP|g@nED*u?EkhV%w|wojz>&P zW%<6TR5y2b6VZ_27p{ZN`B8QcjYYdz8V1v?9w|i=2}d{Ab&U45=A@W6CQsKa&bW}9 zyDQ}A<_)`SOI}1XetdAC=_}iV{1aU@ES8$*%=oFaQP;sjjp|T|oP#DDHK~TB0oSjG zZ#R1MzDlH6HTL+OKD}=l42}c5u4@>KZ2Orh=VP~bDQ$H7@Kd3De5!hqcJ%y>Zi*rW zAAT;Be{j!zsA3DhpkSucy2dD{!51!lY2|NTzdkvr%m~+g^>30SnyrY-W1UGci2;$CX=-7nm2%oxkj{vFKJ|;bhI$=&`q} z+An0Bs^OOU`1{JCp&`GpurPh+E{=6x_c}ah^_EM24u4{r@zvb9;?6^Fs;o2cDYG+U z#T;wb@-1J!T}=Smgv{KnyFOZ+#cDK zhv%8}^v)iE@4w%lq>~dA8X77+^Vx{0eDY)jzIuy|jg7O5OM+6Q?8I2{tUIekZsNiH z`+_5b9R_pe%&~KDP^$_O5dDKtZ2rN&!oE3g<+tA&i-xS)xKV^DdG13vR%5rg zdHoSb>mItg#oJG1Y$ zq=OtcH#euK@sYIbeKVgAUb}Yf);7bRO|%>xv%QvWNZ=GVe_U23Gt%4GsAE&8*5}>1 zXRsg=e^iQ!itNswRXK9xvB}`W9U(_KcbvXnG&5mQ<)K;R_JGIi>FwQ%7A{oksth#Q z8OpJK{rz~ASp74C4F1i+o4&R^n5YtaZDP1Pl6G(8VPADcMa7V${KLN7=Cx6mHy^(p z7cC#$<0J9ny05PuK zd*P~JXlN+MWZu9-jVcy?b=BKj^~jN5ANg=?nLmHNyyp0;OB?Mc`*U=XKHWIXt#sj= zrNd#fQ-{3_b<;+lJUQC#{O*qA*|*-`Eaw(9FfgdTy<27Z-Vf&yG*T{cyBu-qaL*~4 z8j>FwXxG`W$5Ay*+I_|`Y#1Bk%$YM+yuIts&zWog>bH5*A4-?E~PwG743h(oUm&TJ&gJa%{rBS;`rO^K|+}fis?aN_s|y z$fUgM4ZK)j?_OOG4-c0SmWBha$cIbfI5w|men+xt!+kAD=b@;(&TrQtoE^KhgV~CmBzJZ7KXR=1=YUf_1^ z+pd3H$f(AAw*Em7qg zJ*U#cJ`NApA6zaKMOUH{bM!`JWMs6}XkWAFl7l#1emr+}pOqbJJL@|$^+`eM(-W}- zt&EtRmQC#7`{7lo`pVLycO=#5N#ck`7ZmKR4iP)-yLaf<*PWdl92_QUr3q?@JDdh| zmvZhnqL!$xh7%Wf^Jd&#Dc6L9mzKHoCgt!j^PL785Uf&MyywK7U&6?pQ}*Z)r=K_C zJ=f&epaj2Kg7FgWy-l?qHBw`1t8a;C6e!5ci}9>WOG_(j;H_9IVST%6I`>TH66T{i zg?(09j(9AQxE`+xV^M7S(^?*{e_vQyU0wa_wQJdeI)yG--&cHYES@oW^Y*QFP|ck^ zjn|EF8?0?hO8Eo@ci_yOICSXHT7>Z+k5f-?Z$}I?vhQn3(>x~SIx6^lW}T#c96kXX zUa;!;-MwZAi{){8`Pm2q1BGKRa7%ckfhJn|`gd1wa+;rWanW`!6qXXsbL=U279#gp{<2fB37Dq&b1hwo~ zBR=cI9@*O2rBC#Ye|onR@wXFOB2zHGt#Q-Vtrgde-9DDB2{MtHjYW7qrJHN}Fu_wv zM_c=r;aaa7fq^Ew_Uz$$_3D*+dF`c*9;c6pO3zN6t)jconx5seqsKv;qig!Ya_Q3} zp4m~~e)}yR0uJ-3tOA*B2gLP9I8*t`f^+Cl9c4^?(PmU2_DG6eu;Gc z^j3Cqv_C0GUUdEX_1@T`+Cm#ejej-V8G5ze5ZBc$iza zZf(hTO5ygLI)g}a6v2`8Jo2!^#ITve`)B)m8m+Soo<}NBOTS}#W8UJ`$m3>hxo65+go~z9-`~H()Ai=f`}fZy^WNQcrHk0Q zWlMR_S%;qbwA(*zRkojP!n4sySja0k^uVMlXzR9Zir7(^f@kgQYF|FQfY)tJ(#s!B z4-??yQ#^3sXFT@=1UT&=3A5TL&FN@X~#wB6#l8Q=e+e8Yb&i6twPqpLct(cvj!p*_jhN zdHwpCK@FeSyDoC38O=R*EI*)}1_XzXIl+qh07^&q@83T$(VHSv<=EGB&%k3`Mq%&A zizdwl&Y$cX^_=460{MexEwGGgnwmEkEn1Xm-7YELadoWu^2#j%{{E5q19`palY~f= z>SB&v_30Y!u9G`@RFI{~P~8i>De+6Nfrr)_VcpNIt~qj@uMHA-E2^sGlarGZu+h@G zwj96BH#&}ZtXU`#ax}r9xTvcrxX^V>&MzV|vg_TuQzH|@bqWqMQ{z=${(ifV?vY+q zEuH;09~114&hnh~m^W`;MS1zVgz1J9gOt?NZO-S;J#KB)K@bm`jFA()%Pr*+XVsd` zx$VUHufFvEf8UP{#ll{FU4>Cv1L*7p%dAEoz&+7u~azp;wkU8~Xo?#vN9f+hnJ)RXuTy-iM? zS~KZ#gm=%QE2DMMMox~7>PQnQ-JfyY0ehvS9FRp5@ts#LUmkCjKg?V4@Zo+0G^MjfHM9h`p?sV_XmN@+!;A z592nGC}l5?H6nY&dM)MR7Zp`zC2BPKD@dC?2wq&`^GoWymobVt)_R0NHTLE^L|@*B z2brAvv})R6R?hRIM6%s%ec-BJ&eQh2eED*)J7Ao)``g#Wxxt4KqBVe&?T6nh9Saea z0g_Y$+{5>5W|nbX(mK_O^&2O4yH0K?SM}wV z%5)hq-yr3p`mQFd5$AlL!{7_OK>q0tq1Kvxvjs2QJ{^;qcprIdk5jVxea(Bn|9)tE zVnTmsNzll4_1aliWLqV3^MtogLLzZM%^v>Sy=;tL22_M?a6vVr{hOctm5z4iX$+Q?>?8fA{^ML>4 zTCdUm*4WiT+DH5VH@7fFL#u;|lY;}X&$o(;XEhBOcuuow^|eQOSSmRF*Ea6+D9g~1 z4-!n9s`dQ1E)-8K*j#7XvSmHb?p=_ye;>Y8CFcFU*>PWemu}u9{lbZa$(})J4P=Dr zp(+t7awPLdoF>a^Y7_u{%Zg(Bg!98vg0bIEPksKVoqFOY?Dv4s(8O|X*Cz=zQ{$gF zHf*pGw|M*D?7J(|27Epd(*d_`CFD8uY6rdR>e?zKRNZ5t8Z8%CW!;N-r5+Z@gV;Xu z{`o;EmtjR@Exa;DqQgza=#lr0#Kc~XUb7bk4{&$UDaA9|xOxp27nihCgZMWElx-8O zvlfe23({&MaomsT@%8a3?0F~L)z^1lST8RQTM742PumucKr^La=nA5lL4v~^zT#aO z*t1G0`ckxKCr~N`-ne1NGTj-fmSwJ%I4K%c9Fv?KC{pzKz!rtOnFV3{Jd2iXl)nG? z@e!snU@MkC*6D@wVO$0O==i3?*K|K+BPMzv#4E_j$)yYKai7SXne3QNz-B5N*uM4h zKzn}Gwk3dDMVdO#4W_O>t<`n=<~!gz)#5nreI5l(={nXAWNHnTr_F2$%b%T@qziKB zZvSQRn&F4@H$JYbQ$en*F=_07|32>5Ul$1J7idx*>;n2xKXBl;j%yX_w|1CCynK1W z{ZqBX#M@9C)geBRzR^_wL>5VxzRA zToTr*cnBt1Zf_^~-2xn5HJkB+ zuk=KmpP!%bTI~1u`g&E=K~EB_kdklhIur5DlC|LtNjesYYAqS3e5=hre*CDE@7Q0TVzAG| z)U*dsM`e0qWCY2GInlc&Rbk(>>Wv#W%p2~900zc-PWKv2e5%=(g?JEBZ7QUd{^nLT zHrVOvyHYxM9p~P2skp-(XWt%;j*h02UN)e`e|d5sUjb=>Rwe~M6I5c4)9wKm5l+8C zL85%_TyB@hM9tn$-pB7qMpKc51I>H4;7wMeejWDiDh`flI*S4V@^!Ha8aRe26P9Uy zZUf!1VGRJx_lw*o`FHQu%Ccx|z+uVqn0CRvxT>$brE5+H3MCqnov;)hbkKDa17dUx zqgz8vDByAKalEgqr^hPxoIPpKiYmDmkuV@QI2ey7Au5W;eRg^b)oI~dtBLV(vnMyV zb7EH^Zbeaf6CWRcOWHlpI=_Es;^nQhz`%2;_Kv#@KR--4&K>1QkXXLVZ>6Q+2I8`< zTKT{G?ngq_06%f~C(%Ri%3ja_Erut9V`t|H!i;(C(IjV-UaXd^q z33ZMIGAh9xWUYj_I6jK)cO)HZJAL;hqh>!Ay7L(7SCNm6&UosQ0G_CtsEDS(F!A!j za{DTw9L<5{U)x?tt>O8VaYAQ}!n8*`aO*+kG_$Ch+q;cW-F18z8WQE#NVeRI$S$j{ z-oO#-QEb2HBVJZoS{m6jDtyPZ=ycCmbH*ty#FXt*)6+{OBqTQR^H-X;eE2~p$66eZ z&Ghrc1gEgDuq@7t_u-B1^_matx;h%{#i@GW_V{dA+S=M`>);@6T|Di$Nm{x{b6=os zk5lPqi$zn&XsxH)a?@V*^;v!%A76+4B@4V9T|C$_SPCBSODl&zraI>C>mO;0&H4`=__auT6{J-zN5oqvj1DFNx9L1cEEU^bx1x& zX``TyG#~YLcbidVQjBsvZEJJNsAo@Ye8*Kclp?a7k9?MH*|KHRci)w)MKO5h_3xKY zhK22QPXCzVIbCIY=FIk%Y%2>(;FPBNLBPATGgRl#Y^+bzs9C$)F6xHAze>dPiM3v5 zun)QXyq9wA)XkoLQ{n&U=5`}*oJ%gcJ)jyN@Dz3D-raHX27H$kK({cRS*+?&~y0+}fjFXO=oy&1EoD zw=I_%zMgH80fs-L=s@?fE%{@^frgzPby7(zaAiUcL^O zG=g(kSy92H6J03(6@L8$yk)K-K(snSfI12p)2FxNOG~$f^eubRVQ6_7zqU!Fgf}m_954z!3jv>gTH~vgO{>Ym_3rKm zlY;VsYNN0I{PWMC{W8yeJelYSr03YDiIaB>&}Y%&#dR+VU6Ur( z@AJ?lVx!qIC?_XpVr(!4F;r`0yers%ikS)!&L9e(MKS%8ADHHQB`sXJ`F(b)wF-`T z7f8Zny?lOgaaKYN0Me?JD>os75}^qUUisunW{>~fyU7TZAYiLHIt(bZBAW{KqdZeB zzqSFj%9f1g`_G;!^78QL25+Z5`1u`0+aMtw^Oj7rV5_hlW_~X`XWiWq)$tepd-v{L zwPMA+v+tg2O$_(2l@&x1-XhbS!?d~hmWTN388j9~1VXc+aSSCDRB6b3I$nfkf`JFFuY_mV}>S`fnP;_EP4^UI6%gjM5y1c)4sXkU=V;4v$ zy@*_Z9b#k4eK%@=%jB6h*!j4k;zqM&(aH9%p1Vo6Z?9+ifwkq?3jBf69y>Z?7~De| zP*Xh615;U9+3)8I7lii9`~C344+QE#rRY2EAu$4+q{*J(vk*q;%L?f(0`{$2x6aQv zaN(5~YqCs?jURV(bR-liN6QU;{Fv5r_JM zo3&oNc%kkt(ry;r{{3LVr)z|!kavf#j2ykWZ9i338a|xj$quLKo2(CXZMH1?{rA&2 z0=L9YT|1T|h7yc;OKfYQAWM;*rcc)5scGsL&(7o@>!o91YX!xFH@@kROGrpaP&NX% ziHV6;mO-xVek@SVU)Q(B(BfJ6{wuz|jaYu@0S;9|cx@L-l|6e}6K13LBt`8p24_yC zJy=%@2ea2*xw*NIEqChtu?pZ^lun!oS5MY8(}G@+h%K^p#|~A$Rh*m&NY1=lw&+aU z*Upl|GUjz&+au@>U>iF% z+!Y=aUB^IK$tfrVgN{e`8F|EI^WJlIGK})2wEF}fAKzoq%d((5NS=`bs-8ev%mg+i z&ed0H^d`b04-*wsE-(n-r)PiL1CmAXtPB*; z8Au~N3Uq%#K|wvxbOA9&|Z z5|!}?50Hhj+}`%46gPzLzfgbg;QZaYcEus$x&WsL^<%SXgZP3@v+CP#Bfz>6*P>qY znty5j@o8((5aIm2(5e6{0*4z9`W*INdkd@=z}e5m>C!`d7Id%KaSQL8xFd*S^QeRiL|mu&ZacPS-kiI#2bz z!kJxJ_9da)Mt=WKffVofpU%|(C(`CW)!lHv!o_i?9ld?8H(O>qu^~z2?x+7p?%+pg zwu;YpYz+Qx{u(FOU@ULn8-!QaU`F`QFA2>3_eALbpRMtE3q@?2kfSjtQ*Pc|%dGvk zXhHk1i%VWaM8unc0bx&1PoMR>l|h20mfJF#&g+#nTwJ))zSSxx-ma^1XlzUac_#4I zEpt|^V3E=WX*W$e&YU|f`JlZm-5@#avSc}f(N?n4=EZ$LW*vQybbe8Xxt$OB?XYax zh7$S^F*{zPu6gsE~W*Yc3Y*PXL-&;=6=&vI~-pz6M_340?0kH{WRMqvB7{ zNVyAbm76GW(CKx^+Vvnrf4O*(4=0ko6WSp!lgJ3bs$sYTx{*7TjE$r8J*OS0z61bq z_0NFBcX>#vFc?2ZF%&h6!l z@V>xA*K9jGJ02#&o}Y1}4N;RCcmWGg=cOH(k^4vybXk4@H*S1?>eMM`S67{p#S0cF zA__*=loc1R%36~(C+>6Qu_odo5WQL1RyyJ~FLeFfi61|A9pKT|E7NQs5de1yU)ID%3sB-ML7mq-N<70) z2f!txteLt;%7l0OSogB3hT*U0YO1kOUwJ9?jdCGR@nhw zk^GNMODQ}M4+#Y`Wnin8%o{ueY|ZLosQd$?5p(h4*M(Cnp^x*@gFn!nltlr&UGjOKjHD{GX0+bT%>0i3-T9Lnkmf=Gqw9lSBJ9~@I=)Lal+}vQd>)0D!b|+5O zcR0ZrBT)GbNI#9j_P9fa7N0-7;(hS}hfA(4=LdG$xtuyL{EcDaq2LwP?Rl)8X|U(_ zQG!6pm-UN+-t_qSbEWUU|9&>yn8IuBnE*aZaK|k}gJ6^65N>YmJ{yyu8vg@R^33at zM94wGsoJSVxa`MyDm~2$z^L9wVWjzU5Dy-rj7`BuugwZ~bz{mXJN_u6){`0tB!%*4 zm5v7~CLke>UZJ<2zmi;U*n961w{o$^bf)dA1JfVNH%@?2$~^J#E7}HBe#rRXl?=sK z0Ta7*fGKb2pL;cr{413;HM17Hf&B5FvokJ`NU92cq!-5hDz_oKt-W2`eZszQdbG8r z*t3`?Ucb-ukFS1D& z96fm?fI}M7`*7lefycPrhn2{0BiIY>1fLjRe<~XwH}d@X^CzpOr>7ryvwdDO#mbkG za8Ajg@b2lI48c9FqxT>AZcKUh?3t+0GWrhw1Z4x+T@F2}GKUVuK`}Q6J;Y-MtWRDX z9Q}|rUoJ%{zEm9vB+F?~-yMoB)l|GpY$eqc{X&T7>Tl<Xargx?kz z2@!&DOERxt=E<@}4t-5Ze&i>@K@75Tpbu5tA2{(u9i@r*i4sPZIZMuUwC_1WfC#hY z!P!`HUNnrbxAiZoJz_c#FjY>Uj=Q#gcLb@wjg5%>2w8A51Udi2{x(=^c`} z{-t(A_Oq=a9Ampuz-%WUE{I-M(y{5kfLGDWbWYXWWrc{H5*%F4y*G}GH%O6ub-&U3 z!haBOXma`RaQ;Zy8iON#kb50aIG-MRQ$c?T_lLKr2>aRdN8s6`Zq{;YcL?S&1C@&e z_w3;X_8Z^R{eAk1ZY%r;91Yr?AYlcWgrvczZU(3zQy4v;>IJMow?qho1=`sgx_~%x-QL$}FWah@o$B&<( z_F$!($nV}Y71-!8(Y*yvPTaaJ_sLbkN2NrHzHacxdukLUr^U#$CDDmaGO3G?Z%trtWW zo$4j!qIh=NX2U*@w$&r__a#g3sRpl*BcDSYs)en5d`GYw{4QO(q&A5Fs%!es;Ks_b z(BKN7)niBmVVTc#K5C9&AE(@V0TV<}(gVicO9I3yg!Vv^Wo=zuU~up$*3;kF_}X^q zscbrm6mp>rfW&+bI}IyIM*`K&dtjlg{g>%;6h8(?TC$Ja8-Ilz2oA6d(ZQ?7u1^41 zGY9RP9k+sB%6}Wz;_ba;9^6=dkdXuZ{Wmdt+8$&C3F~QRv)G$>9%3_<$%G*NaCoJX zG}8|FWjcQ{eUO_Q@Yjiuw3Hftc2N6)T{KVk_`9%1fs}#>2=H+bQVC7{GxADtz54y~ zN}<_-=aHB2kfT8w$Ds@cCnO)Tn!Vl}YVoBF(crQoQ7i_?{26;kOfIh6eDvA7Fi(9; ze1m6l&I^~szb6SK1$ErpRUsRwLefwNM7NSfm%*QBaciOwHFjChU~`vavPQ`nAITs1jfe3<~a=}!z`ER5EUCM016J) zLV*9q$2T^?YW7R7)GB0PpkZ;t-@a~lY_%e?8j=WYNMJMVk*$dv-7FgJKZjJo4`&-I z#enQ{+1%WW@b#pwfqA!dCSPSxwqdE4S%n|(EeV^u4as_mpm^e;rUZ@tmsNogALG2; z(_}*nNEZNL&jH@a$VHI)(xqNh(m~QDA1{c2tx!@@qRKwN&oAQM!As_lhvbeN$xQ|* zZ!&;(yb6HSSuIIh&5zt6q+r5$ri6#Wfdam%NzA$vTKv7rsb`b7jotP;f7L;N*d}i@D+`ISese+i* zBL?mgA@n*As5{N+g01Ev=5rY@Px9XK`9MV!;8lIH-X4%rBy!)qdpEe>HK{R)481r6 z=B?RDc<{nZlhF%8qG~mS91=M}FYoL0%@Hy$huHKp5f1 zcf;2A2W!`2wH^dke0|1>)vH$rX+8Tl#m@BWjczi+V;5|&tt%@l(}y1n&o=;YU`bw? zSd}!FVSD!6t6$czN%vj0KT<6Wx}4|m;lm?+%_^X@dOC`Wy_RoGhN>?Bz883hUH zw@_K-K;5zsnk;o4hiOk`{y^!HE8d2+X-6W8(W8;w{N1n}HzBimsKW;XVC&{2# zALz6WPG4-AazC3kk1`I}{%^S=f(h~VQw5e(MYAk6@Y z23iZLGE}t*ZIp7!Bs&tY)_4oQ@H;e8D5gg>BhlUS6wI)iP@OfpT2GC*An;8-pm46We!XlSLb^`k&tk)7o zzr5w{vr}R2rdPG;WiP#ydg41obaTTANC7<-5~=X&l_5*oq%uHM;Ll3rQWAjr`vx7G zK%V~QjPitPW6{84YV-+;53yEMqpoIS_L8Mtw_-gy;L?U|$R44K>1VjsM12*#RMj2` z8W~&#ms+1{c(C1bb{dA!R30kBIJciX^d}BQNz;H%5+XOiBtf#%2^xcusVZ1Ru1c8!6X zp|g!>h^nS$9MgYuchTg4z&}6UuCIz$C^3TcToN$q24l}*JHO2qy9|9 zSHpaN=bzPV@QQEd&ldn=BWC*KI{f22@#s;3HTX99#Ni`pjZ$>&6g@yIrd*M+A8Urc zRM;fzo%*#9)6U+$9>5pMSCK^`o9?yVh6hM!uuDJbDjgoMi-P_U^!D%wf#+YZBLjO^ z2kC&5v}_q*p6G40wN62&D|b+O(dAe?=5@5K)2Ty=)Hw zE@qv=^xdE!b<ki@M?aQB_wDg5Z|aLI-Oz`}IG{ zsQ0824SDLWvn-qu1mG%+(=+j9UwWtBb8?&OM#?Ugn(WJ z{(}0Xs*@wL=oV@qHiyB~xL+&jOGwES zU99uzT}`mBufkt{h5g@@peB&G5F8z`v{cH2(+)N}Lm#84gh1oa-@@uCyl~+H5*W2# zB%r|i`}d|NsQO2K)pN! zZb8xCf|r?2DG_`@S#!>tKDkL084_KU$BnWPr}}eM_3^;5gWp>S;OqUPR?X5fk>R>2L)Wt4^HG5Uil#EHEfGBZerqnv0Z%w-1bvK;BIJ51I{z@j%@T@Ga$X1Ar?wGoZb?pAjt3)mXT zya!@w9SNq8{t=0_$!J0nNf;0f>9qjOq{Je&$AkY03R$sygJcve==6v}cUslLxt)cU zB*2#()vT{lePMfjk0`5wvV^i%;rQFoA++dFvGu=PEaA(Wo$ZO=RDa#Pp!4jgw>$#X~qiOypNcQv)T;YOoz z6Nmy;a9;t9`d=tDXda@{3Z4jx$+*AbC*|`>cEUQf!{)_aq)BbSX*g8Waj<{;?KeSp zvdhEO!4JL@t-osA!S!my79Iw6QEn1~0}9b%7({{g z#Lc6dL11W3ph>0@VoriD{ARqTnIvBGXieyvO`^C_7h#O1L4b#0rxMCE3eWr4>rs&5 z`8RDkNFjW5G`nZxKmHMpI*Um zFTW^o8zdc*j|9w}J$gx~n-1GLb=a(!W_MP44qc=}DI2(hv zu-tc=5lppBbX3%7tS7Z|K_UT-ChQuFlu)`Olqh6XRZ3r9r-?Tc!&;3rU6$@#&darM|OmEoc|NRQ`* z0$NjfnUEF8w}97?*&4CCw<*ntTHc}+;Ju}?1lCdV_@j*^ntI9-rAf%7^#KV4XOR)R ztq!6=qI59PDM!WihQCsjUIlX=G<#eXY>NJ5)-a>yzP}Y}Ek*A6>FMc$?%%FliPlIs z66$*O_uwcy2b}wPi7WrDE?YDow4|F{g}OL$(jAADpGj5?ylJ>(?($W=D)wQIa1p}j ztUw|2+)HgP-(nD|BuJ9S#(#?ferRc<*%_!45g~eJdXm%^7-nG8X@FrF#JVDZky-=K z>t-#P@zk&c(6<%aOQd)z9VPMofidt^d=`#Nb>KX&Md%Y8tgEdBRr15ejT?!n#8dP~ z3ov~nVuHov>)-dZWF^95AryAm$43o#5kWB)h964LrCv)_u;&EbrKdg|qz+5O3Nm>i z7{>#ztCbBH6X(HB^xwA5%dp9!lXxcgv33nh=Re#V2wT1VIUVYzrZI?m zG4z$Ft#05XMh{}g6IKF9PDI`10+mx71qrZ{JbJVyPQ&3z1PMh1Vvk|n6jn>Zk)`YP zUw7=y`?u%%FMOkTvNbZN6$KgN{K+fn`;Q-gs%9gRZqbx*WPwh}$YE+t?^0rxsz12< z1@7?k|M$DtkwO2zGHIx$JI&#!epD_|X}PmCe+eb?uJxzbFzNr)B`H?Cn5VkK$~5an zWN2hz)sORXq+Id~<#8qFeb^HM&M%5W!bG(?D%|Py_RSlf!{weHKcjC5FHvQ98S-I^ zLvS7y?uvN{bq5|Sm>(?k=d-Obaf~ZJ2LU2Lq?=V*P!fpD3GBiLlf54S7z_P1?3eMq zL#`0qUxhx#7hP>1+S=N9nACGWHdg#reo=@I6~}z(jgdIPE-F8`4odlzZs=>^*L4n+hXkAf^z2Pnkw@+^Fz#IkaBD zVAa*xX*8%jv*L??Mj{tZz~k@=?wcO=Cw3QTgNR8^@L@Zx+xVE&a)I9FKadXEgDk*r z1UVE;^d#nW1?ddKm`W`uI0>~zzEUxWLUMi+qy33U4b+=28gdl>Bbz>G&Nu!2R%$h9 z6HD40&Zj*_5&@3YV|ZGXKZ==9Th(Hbf^cfDfHwM!^ck2SG+T%zp>`WI@{y7a3s@#> z;-W7?dCS>q)yr=jQI8546zQV7Ee4jWAT6y=2@k-4H0~bsl-I+gmW6Q#Pq>)h|NM-QE%vxGhq&fk(T4u*Zvyi~9U65FEtlO0vm4evy zcgfNx+q{eWGpt&7f`FDotG{{`ShGa1Lpm>Tx2@l1^28%0fiUFvm$YCdIIzSF>7MuR z{|SuM>8vTFz@R*+a`y=xm0jTg+Ef`EXlKD^AsRoZjcFXTSv9dnut6tFE_?)hj3XwV zI2m?D*R2>3(qApK!dThR@ReH5;LDeaf*;`FS<~zEKz_YQ5{z$3V5rM5$|O(K7PLKC z3icjlIZu{D>!Ov$_$r3PHe@YG$EU$eNni=(iHmi=~ErBNK*D4KR@N3GpHuzpw7`ft9OqvIxqA!p3A(i-eIq7^^@C@{~=W9@p3-$aU`NG^o))DZJtScM>_Ag83keDD+ zIP8bX5X!InLBHt`>c;X>yCPZs!M0z|&(Eg`9TuoM07!#ylH{bk=%8w(==apc`mV;c zWM=N5-Y^>D06mSLNu9I60RcflF(k7lYNV(mH_H_!rDJ#rmd4r^E-MyUFR1wlY=06NFJ&v{V zFWwx<tB`Dxf{UlB=s`Z1e)sT65 z;OJ-sX2xBes(FP)ZyWC8%tmi3+ieWT4u3;7h+ld;Ht#d5oc0*xO|wVd>m*?+0pl*j z)GqcYgm)<%y#kP+Df}VJ*P~N_2qR`K$PKcO_;5>UgAGwcjM{PL^&y%svB$BG)WKv7 z$$+kdnKaD*qD=GyOCE*($iz!aWe*+VlaSB=%TaKR$mo~KU88rCK=#P{vF82`!GQ+D zpv&obZMm^%1#0`+a->0OVU$MPC04BH^XtV_mBMrR40W6!ESRt+>Ns$&Ph=>U)XpU(HWUwtKb%0x_5^a|*Z_fn^u=iOC}8Q8(-h zmtG-qIDO%t5xOYt;)vR#i<`chCK3_maR(hzG&|!;TZ2vubsrxMi9k+CL{8Rdn?WUp z9Bbl?3b8ZKn@b`VsDmnYOv*`f+KNrbw<)ksuOx8SmkN>8BdQQ#QbU!Fr(3yg36lm3 zy{!(7MeOT=|05XXv&(2-Jh8~jmU(s^Dcwd5Em#E_u>vx=j^G1!;%US!6iY28Ir~uk z!UNtmBrPEkTrw~8->7bisEmPVvL*8a!R!DA%7=w{OjMY=%dGr;6;V(U*)KyLHafTh z$pv=*x%}6tG{a0L42iDK}sJslsdQ!l-O*g#B;+K@J1tX?y!HtKug(Y(bA=A$csGF zBjq&yDFI`#NM%5N8-}zauzB;N9(`GCGuQE0|JQ-6CDo+Cq4ush8qoL5>?|P@FYp-qyP>dL?99_x>_*bKQUpS!*zh zAkf4N7ur}>=KtD#>SH-Y6V&h);#>8#s-N8k>_iU}k=1_24hlDukThwSk;e2dXE6c@ zP17IL8n+|lVm8{x1b1jSNf$3(v`8TD(0Qu>W95Q$Q4CgDx^~--M9zSs8-BdW7sRTI zNuH0q+OJ=T`?i}i*2)D}Pn|AmiWb|kruwnl8CRuHoyXlMY z)Hfi9we4C`O@cqARr2EXHXOqMpPd_29=Jax)#3b=LDU8`d#TI)dDJ;ru4&j1LKaOt zB5DMurV*0Q{mo_h=e$gTJRx*R%}#yNxP8yLHi`+%nR@HqI67%K(ay?^wqN*;4`YtW zB|<~M8Ljqx?D2NtUkUUd^h(J|zqx7$82D72zT3!IdC`y?1*4iYq&?F z^_@&JrUo1)M?&w*FJ`g-nQ?nqsQ;1`pk@mE9!+>G?!w_b>%o%WSbpgSCE!~sEe)rNuO%C&3MlAs!2J1YZZ z*>D=n7uz9OA9s&>0N|OME;lMt|AGuphygLFAqt_!jYFdpstkfTu?k_?!|Ncvlkt^Q zE}#&MvAB*XY-%QgnK!Dc0jP8{0aVB_O8ycw%||Psj~6?OP9D^98HjQ$l+0kUZ1u`r zx1$fxt36x)C-_jw%W%we#}^i3|36s_j>qW0AgKPO9A+gX6@)eC)lr`-jUOOD|3B}-^_1sttO6Q@i~`L}I* zR=Y(^EJM>(sg*Txv)UAAtO5lpdJWhuoai`nhvk)!9L`szOWbN*Sxq^vjUDG$p)ctW zOl>UPHVmcHf?D!G+JY?kt0j+WFf2_l&wuD>Ah`u7zz^jL4-I}X&CmjB%No|owhUqA zq02z1_c{-RWGJNx$Vs$0DKw+2)eOgB=ej-YD)oHz@91^}S4Nc-kWS5w4S<2AOhk^)%oO{(G_Ik zhDu&hzWk%bfpyU5D&})hngoxc*T;SnYI#!Q=q%9r=xTD0~(gu5VXbUUHB2yT^yRiwkIi?|KAq>N#EYwX>|+c5t>p()670nDlVh>uBe%j39l?!;V>em&008)zrmghL4K z;L;60zmsk7D#;>T`_N2+iM=q6Agzdd1Hp3wUT;SdGHQd!6Eq4uyB0;M1VEZMh!IZQ zs~FClIRNn^?t=$*f5aHXbx3PFwKGo}E?Fn~d;0Cpg}ijzkvN&M9YyXwh!^XKlDGja zsIN7rruGyDhIk=9rD1x45%B#Z81GI1kd^O3fgerdn!JI2IpNIR;qm#^{78s|vS2Sk zdNe%;U1~-%SYRoTMXufs!MC)ouI{F!LqhcO@|DTP&FLnOi?0 zQsWzhZii8W;BJmx8*y2{&_e4WQmqrYy3y;aX4km3Fqa+mPP`-C=GpL>}n` ziQ4GI;9EnJ8+V|jJaY8t4(d~sZ^B7oV!qWEKpa%^n^HbXekFVLXK`m@UBFbsQMxBf_(`5Jm}xK2OvTDc!c~uA*JA zS5ms9BPndEnBdp*t_?(hH=b|vxkDO{OfG8N0PzF+0`(^bp$7niD38J~;&^{ammYu# z5A0co*}Wz(TqhdE1LYGs?$Z1N3a}B|-}?T`dzAE%g)qjUvM2Wjeg7OwvhfvqpAc^yLW>QO_dBPC@f^*rSf5*4{$A{NH^MSOU)-EA{pmF^7AmM z1_bLLM?1VhbOYt95ett-OPYv- z`DR6!r5bhqJOk04+FNLFbD{}hT(GZEvwK!2kDe9Ar-E5f?>&6BgtglVLT)yPVOqW8$QKd+>U8==E*-K*!nOfIK~o>WP8}_0g0pXN zR5Jm=nvD1mG$O%}GW~$?B5`07jkbar1f7vC83Z_qmQu^^3>2k*u>HBqB7bx~0|svQ zF3s7V_u$CzxcALcDtzv~%IvI6Ea0{m_oqK>NQ8W^W7>hEjSX@W;egTr$ZmSVxur5Ln*jJ1KA z+d3*LYAyVx5~wx8UAHY3ywQ0O=#(K_AS|Yq525k|0(`J`7qK zCo!-~)Zs&ma~pUyHjv24k#_>9fz1BAUzZR{8yHXVD|ZODW>+#~D>PH?3@ zuf5c{P{VHM4bup5>Jg?|U>GgBNZI)W64Q<)k(Sr)Ag;0lH2QDZ0UF@TD?fjaN^!6g zSp#XLQz>-cT*xs#C{SARc>=`zgeTEJoHe`~dE+A{-mOE+(spRSKA7|Tco(d=EEmwk zCom_56XhuTdZ1ja1>9_(=Gi2*P)yd)cP?A7V8J%} z4a{6?!L6ygHJ)9|Hy_8`=lg?RYf-iCz!CL9waH1E z5Nk&(j=CSp4}(#sXc{@Tt#Y8L8N}Cf^iGt5G-j{cQSc=$OFyP#TGex-VsM!7cK`gP zlKL+z@&Cr$e0&W1?dL;(He5?W9tL}*Wy3p${tg{tEjIAaWwgZsuHqHY>>%g`PgRv|((X!Ogd`flX+=NM|Y32=^j(P*T4o_#k) zWF(O52_cLo>-KGTW0W|UQtz`9NF`kbXe??-U0CiIOf1!-*+tNncbq6;khPAw9El6Z zKpY}7{ip>Ph7gRVJ3!VLU?K*c#okcLp$_J%pZZ{%fJOp=|P`6r8Gn_2u=@cXSN|f_oUc$|o+a z24+ey`x<7Zla-42S>zWX!(J3hb>N%?r-7vI0a#dI+Ha$YC7}C-Dp&&~Hh?gf!dz^c zuTG>ULXsI!BYZfS1%T9o%pm!BAR-fK-Zf|=lt~GgRlu`VN~+zw9nmb?WgiUXg&!Yr zQBw{!dMwDdveCI;GXfT~pCnpp(N%fyQY0HRxc}4Rag1 zOnU>Ej_HST;(kLf-1Q?KkZ>n}Uh1h;1ikwBx(56oA=qw^UBF1qksB4p7Ie)A7eq=b zi}dFbVGJ7Bj(FSy^5D6iQ#&t{@|=9Z3|8qqMia287li(g7wGrM!Um=za~YLe$m?M3 z0y8?TGN}pxr?i34_oawdB-AM3v{%qBOUIa~5PIYw6hxlqA-pG`uOGX#8}6$H(DyX0 ziOY8ZLy?Me6&2>`T2b;60Em`Kg}UwTt!!;<6G5S~N5zqp7VMH!S=-Z}Gp= uJ*_)e%wbf{HQn?z9b&HkP4h)Q%rcBML-tq}8}QNBFlCM(N~rq>?0w(Q^Ld~9ec$uB&)Iib)>{An|M$DD?{xk4S(UvzXHMgp z#$YgJGI#AzV=yM_GZ+)9f0>NGId<`yApWt*SzgCk-QL34&BW21vB$*O!Pef{)@uK6 zuI7$TR`zz{q8mlUg?~HX?CjtqwPwx1KVKkf?`XN^$vYi&yvbCDUAj&T#%vS%?}TW% zC@TiTw1~N5tH$A*-LKqrxZB3ZKh;dA`*ifT^KbKodMudrcYc|xcgHVqxqRjPLId&C z$C0v;y1H7{Uh(DgCEV1NcvXev)#o}*4^R=D)W~ql7#e+f`SZXZ(--dC5^}jqs-`V) zL{_}lbK$WC;!c-~*Us3EZ^1Y^*Ic`P68(SopZ{@}^Z!V0sr`xmV)1Xb6Y!6tGk?vX zKi;4G3+@Div2Wr@5&Gxd2@mJfKWiB#)9IhKNAc?$YI9t=%)|oI99}=H5RKebQBl$V zbmirz4GsFMt}&M%`MA|8Kx5VQ-K#Dxmm9k=T6B5&nrp?*&%H;72h^Y6kQnzeiQHEm zuPYX~Tk7z~eO3WKG0dl#OuxS;rX@hm($aEt^h@)p`rh1LSqZC(2rfY(pVPCKC%%7w z;Nl{21!J!PKPk5!gL=LR3>8rg{_dX`_x(i;vO<~HR&|75mKE$)D@mxW)sg8h-|q4H z)B?p^-=O+uf#QB4A;$IQ1_82O!|y*mSsrlhn)>$-w#;BOR_Uc32n!Uq?ELt;Fw(GO zrrWz`fpc}0Jv?$Y%g8918IGSeSx6sh6<{JhYu2nb(Ri*Urh|inj;^kv6>Y4{lyBdT z+>-OjPb+0OOq@e+XyiR)-qzNJ@6XikcKg_}HE{PTTzZ^JL*$otT#YAE-Fl5i+vUcu zo;h>o$dM!c^)^X(SffMjAs+9;&X`FCwe|KUeQEOSO=);mT3T7Ura;)o$0s{GyW_!> zSrc4d5?5&vs{8VHGJh#W7s!1=#P7* zmucr!=ec&zs%w*HFN?R&A1X>&u9cw2$Gow@J{UhtIL9qiVk;Sk2Xg~Af&0l%p-0|` zZDVXm*GspKv2V`5vB~LyE;l*V#dL11d!!0Lfb1hjC|LD< zN<+6-k*Stt)=#gjz*Sa%s7oEdds@GKc*^7J>oYE8GGE@uCFQGy$a+=9sIMOAZuoLz z#O(gj2{$Bc{2xAixZa^#|d+r??8aj93LYkhjni|Vvpfl1k*j+(cX26$c{ee)!T-O+-08#7e_&_6{QI}1d zHd&32jh_1HedM{mY^U}Y^lU4~Mn@!2i`cQ6O4H{HtKh-=UcGv#&bWU1huY-rD^{%N z`}FDM*H5i}K|yhcT8oOy%6e~%bX%iNgsVsG?Fh6CzFKTn@wWIHJI~W?6a~i7!6EB| zB`pzlqM`oh_A>1qJ5Fjg;LgV>`UwiGU$4PRGcTQgurW&&dowFmD%D&cT1(Hue!F*s)Dz)@7ii* z9#K(I1>AGMdDP$Pp>G}Nw@Z6_kC&h!N)F<@#w!H!TrSv zUGf;-bGR!>q% z`|lTcB&>Cs7A(2e)YMdTcHU~?(f|>Ci(O*a3Eu1hbjTtH2Zy`EA5KkQFax!>wRm+% zns9Do%}QC>rYmMgP=o!=Cyhs;G~2&@_fBtM%>kvodnIQSuC1u7oVj!7&Xv5pk2-aR zzqVe+JzHRW#6(vsTw!M1`0`1#Dq8VC((n18Ma7Sm&DV5xPQx|4KC?XDe}hf+GwV_N zd!J6fe)rDe!>iny*k+|Qd1kc@4U4f({mlba$Lj$MFm@MR3 zyYHxZc2rapZE?A=ui@qGBZJ*>D3f|ka(z!%#;Qf0%O4-}WUB4oe|xaIA!>E-;cZVY zFRw{9ed7F~cHON_P6|t?g8o7zn`Bk!onucI@CHX-SEhe$pc+!X34W>RrHR%d0#rQk5w!z?y%cw{cM`3 z9@;XNY+mZmZL{s{?IS%Sy#)aU1qG;1=DP1%T0&QBKm8tUJbw zqJmjCwPAXjwjnpXZh+O`0-A=(pdtP;)S^dvQy8puxVNLvDQNvU%O{Nz-S@V5TS$_2QZU=| zT5$v}N3X}TF4I1QSK#;Gx5>)NY9*D)j_h6l%xAk%;2a=H3`*fC{|(kvPb-WJrp#KR zvSrKBd-v`o*4r1Jo;hvSEdQXOAY5ZxYpZFteJp=#M_p? z-lFMSwp7Y_*FYybb=of#>0e4;hVOLgY0Tbctj-L0RrdH$$04m>?}@tYHjH=w{LZ@e zZdm^4pnhqJeZi=fpOCf|*0pdcZdw#pgkFz&tU-1PupJtS>ie!0+}#U>YLx>ny?Xgl zHQlBrKe5%O|NToxH@BLlZjE7h>H=b7eK!IwDYDR8QHm2Hl>$1^Gg%Qp0}2329{n$O zij2}yMycZ-E||Y$iEu}V=g_oxR9*l&ztq%JT=v`6)^I{*?mmQpVvP&((MvVbtu!taPuU;j{I(;&3EWJH(%B*P9CzqsLKU_xxxs3~_`d)Zuc0k0oV;zpIhYlTj ziCs0&dRZ=3IYf52JF~ee)lwONt|QhsscY20YGlI`jj~{wbk}Y@Y(aXIwQr-g-u6|3dsjBiP~i+x#`*dAio17L(YKqj{D_K8O`@ibj!xJ}7sJbnQHi0UZzEA zU0=-rOAQs3kB^UAZwy62zy5q2n##FLm#R_D6A!!E4E4478xOCMHBEKxuHS#K^u>$4 zxJ??^aT4YwTzLc4`W|h5+G+ShS0aEO-DKa85PKKbF1?Y*PoC^V^E;J)hb5XD zV(%L)<7xfy;)CYFT%Nq_j1vol8Yt$qf zveRv}+uGZ^fOsl_`C@B~JomVCRf|;TFnkSf*8SvA8m%662`hH|eWkLTrnPmfW>B52 zR$GZ*LQmqt^99&O1RM_eck|>=o^1v>GLwd5w!5P{XMz8op{QpWPPylx|#+j z&fXkq>^&s^>C-2FbITVuUyhG`k;BtUEtgp(kF7s@(dn?M^Hy>9D(%Cq(cVKJ7+Lj~7 zPn>9b|2}%Q+_!S;SKxiwV&dWn79ZkpE5MW@&{9iNxP`R1JZ3!n)cPc$Nm@!O764Uj z#&!VRn)n#(K)pPVblI;h6Wu*M^~XZE4}VC0!nJ(4PhFC>g2HLg7QWHc0w5>$*rvlD zL-9R5p7SKGpD!&fUAkO1(RIc|exHr0lUn@yN`#U)fE^ecm@J`w@~kD%Xy;bw%sHcj z4e96u-RS!k>4)9jW4uNNJDUp%NE!fRjYenl=!}Wt9sNAL)-uHF4yeSW$&+J!#>aBH zGaC8Q?)5U_G>*XIAayd8>8DLZaRLVVn{v9;Rr{FGN5?YRqDf312G~NeC-p(2y z8(~K&FZTlc0GJ6Oo(dK|N|XdYA~1jI z=FJ8Y)>SH?`FE5<5@R*vj0WoV%MUeTc_k>zjcSlyv2ELNFozhxDQk2SB1Q45)@N4% zgr`}v1z&l6dF9cQ-7dUB1iY{S-Qbg}#netT7yx!5?4g+p*M^qYWPpDRqf)$m{W=Wb zRY+FWh#KGpKF?ATY+Q)kW?4|J)uKmjN}za~GLPs#s4 zdFa+tcY>EoSo?zQNV{}Y$kWAjRVTQ-d$y<>6leMZ(W(b0rf6n6n&bCvN_+)68?#e` z55Jij85LzypJoN_YIn8Z1wOqBb*d_C`xMOtJx#Q{3XtmvJQkgv**`m69Vj(T@+y`h%{1?h)%8%jMt z@}R00oJ;~d$n@**FbBjRKAgo)dp#-RV1tEoZ_}%fgM*ScZ{8#zyzsKj;PqsS=QnJs zoh8uu*DiB^JEyR+veLoTRkA0mb(ZPlbKIwfWByPtSX?Bh-cs=Sg|q@5BLUsQCr_UI zGJU%E+_`gwz38Td>!wC%hftn)jrG9VqHBP!rl)2D`` zY8R~zIkJDK-k{X)j<-+yEw^)N-9iL#Ruo?``}XZ~*{OQv;LTQxl5%r%=kV}Ye?ylz zb;qoremq7g%6rX6kjup&PwST~Su#UTPRYs${L|oLFYlUcUnwZqnPS{7G}^42YoTSL4C198#)*wDVNOorVGGzI!` zR@TOWj>?_5=o>Pg8Q(@nm2!Fi@yif6Tb}(V1#_y{Ieq|vGqaa#VR@K~1uEt)A#F4A z(b^g46N(ciOgOb{zR$XcT631l9?^j&Ak-~JFYuk?Gd2_js_yaF6+hIB*HNvIldiIr z3~-d7pDQY9Y5Aj!SQP)Fy{%U8_Hm^t&n?6`!s&ep`!)NI&!AWRyQJz#((6&jhihkm z$U>q^N>j>?scUG6+jeT&`0!O_juacZBtow0(Nu}@#V{FGC( zm80gCWT6D|tzKQ))MSLKKx6$@V`=E%e%gdzT3UbS?sS3XL7z6e=8m= z#L*;>mSQ$LJ*_mm1A5QX2M@MlZ>yon-@J7z$wmff2Vc^6UXADJNsqPXj@(H4Pj{6g zD~IkT^#Y35-3rmx94MiABgeHn76O}Zt)!yV5)q?&Iv|b; zXA^oAOeMGBcUo4FWJ+Z%I5^k?Tcj$@O1fM1E(qF?hpb+#wGd&1ZZ0Y z^d&i1kV2hROt2Ty@^D*#aTS_4JIUDi*s)_g>-L{SJ>_MVJbhYz|JX#Zft9Is@w1jn z9RP3ice$`!&Ill~9NZ)ll0`{j;dUYhKxTZ*&YGlO2_ z=%=O(YJ0lJUY!Ryaw8wau~4gmi*0)hqlFOB~$eP2xaDMWkNx{!@E{H*%TK6{PSp%w(9>!!{zN~z;tFgeR07X3F@%aU%O=Eop_Oq95*2#72tp>p6`t{dP zG?8c&X40q?xz~IBOlXixc?=dK>xcSdwL2eCXOyHegy?S z$z9K|0|Jb_-5($IXR&TaNApKUMDT;IvicuRUvmKW9y(HmzI|RKkk-Kam)rLQN&4|( z+2z){`0{d$42OB*Gg@zWW!N_-Rz@k8LQk+Bf(Yo`a(_bU2tHNsxIeFEjG8zCdDIf1v!g1fx8?2M-=}z6?Ku-_`nkz;O1DPeE4* z-o2_)bM=FbUc+g4*85$?)sLO;&4ey^*IGPqH<)KZ=V14T57Q>)qnm9T6?Hq?8YxlV z&>*y8MOeA{=}7_8poOV~g@uuVOJpByw-Y74@^hJ-58I_-+B`F?cgBWw(DYB8K5dO2 zE#>rXci13AfplxOVoXd7Nu*TF2S7y~uVxaEymxPNoH-x|L}Xuf#=Lp+&dXeaeu%20 zjB7q+eeY|^W0Zo9I?E6?WCjV8@8>r+rPekG3UJC$%c>1<3t(+@T$1i7zb$`0&AwT- zyDoL-a__HU$B!Q;X%bo%I?o>5gK9vE^h2!*c>s^~IW9I=Gu6>uNsXK`dl?BQAT3EC znd*?#$scgRbAY726N^D`a3S_xQd6F19OP}idxw)**RBn~2s!ZP(OJ4ByjHb$O+cFn z6?%^jXeSuvYLRX-n4t(aiBk%w;y?(A>nRxbzPMzQ+MXNhRipOaO0#&*^Zfd{?J%pF zea7>E-AB5hDk<^EPY{oVqHU-|g8} zU0vP2j~`XS7hSwQymXvLy4; zA&sLR{HCp~4QWIdwKKKTY3!T3yn;dr{6ENMv>Skh;)f%!IRUZpXki+$qgBIwgMw_j zUK?_Ap3YG$D<_5LK^tn)tSYCagKL2!bfD&zr3nU=#G==DQcSggAm;dx%e>fcl+iECiJ7^xL;@r{UdU zIx$&k9s}0U1NDu4M$^eO1dqx4RJ8bp4aOJAZu4v~88w*O@x^y=9_GcLB^+ z;|oWw+<9piOHExJb$}n*a9r8&(2#(H1iPaBO{iwMQTeJ-CuMEaCmu=LXb4gr=rEd} z-#tGlCCjO5N7Y_Kw?u=mLHod>X2r$DRVNz8;U3i0`PphLLW?C%*wV5O8;uD(&i``2 zc$Ud@em)RpjUdT`8p)tnaNa;ApbVsRsvB80VGZ)fRww8Sty`zMXwf2K?J&L~;dI0S zE3E47peN8fu=ixzaheujNg%muOU_NyQd>lM*J|>ZVnAmhvu&PKbM8T<~{Rz^?WUbnBBLdfF zgU|M_Jh#QF^w~3CUMQK&oWW<(kVNy|Jd-{#c_!_dDpZxl(!Vem4u#!+)T-9=8L)Br zF5{zL^qVd(T(^zIHD^v37+}ZKt1AgBqJn8eDsq#Sn3OkogDutMGwubz83PoZyu3WEc%3k^-)DzOu)@vpj=)#mI@6J|g zP;I8Zwo`)DZ`dKx;N4Hn#K2vOE1p0Yb9HqchWg13ZP(u3UgALc7ARDa@OXjhS9^iT zp_FQZOD5%v9_Qf|5E3e#9RBmzRdi7pfH7Dx1nVMLLGDu+jL`MqZC+wCTF-TFKRx3m zFiT?2ENBvFT-_MuSwqG_Fp)dZz`CG7Qw1ic z7)@Vy7^#j?m_zj$2ZIE);`!$KkO<@c8C1#BRqyV)Q_5tPB&s?;@ZV&CKY^Nx! zT5WJWe5;ebb$2y=t$y=5awKivgP%l<^9|57r~^Wd!j+nLm@Yj1`^uGVU0rc7teJ!y z;R4*jL)81JuI&OsAZUgDH9(c_+lwyhm(i-*|9Bepe`t>B!fRqUOJ7B*#I}}|C^Ivn zzwEgK`2rAnE-jV5laxQK=rcZ=8L4b*8&A&;Vm{~Av19$vnMD^YSb$D4a<0ME(UCk7 zj|qIpX3PX0R`M5C#qW^6!!}}x_u_I|iiA?X*cv_qQe_EOZplY8I5n(+$6X=!T2MyD zaJKB%P~HyG@ipFu9l+z&5}*Im20b&g2ok1Y55??%e9qr9o-B|zZ}v-kz7!A;@XR6= zglS0V#XWKNKC{R>cl4g$n}{k@p&o0}1ud%{V7<)?+sMes2)299d|{p6mM>pUZA04i zLpikCggeK4BLI-0Z|y?)J9qhV4gOZ*$X5qiQx$SPLrLHtzyJRGde;v+;Clz~Z4~$J z)jE9m>&)fiD*Lc4S!3B&{rgo_Rf+yY_{e>pMfF5E=5zw<`eZR!&twVXaccn45x%3^ z7MbVRR)S~fXXM_-?ee~SD?~_SD`@jofk-SCS7{MTloV1v<|F<6?JgJdm)IXs0dK|) zs5+pqvM#qaz;zRUd&%(UwG76VI!9m&tbHsnJ*~?M$GZ&wgS&*Wp8NJpH;1{`o^f-3M@+TP5XoTQ*|V64JCuDYdMp+z ze)y)Gj}ewBMKPecc=W#y!T!Bdv*Z29CSn6NPg@Iy#d`!yIVi@BRfG~8+apS z;A7(VFL2)iG?B0#wwM5n1iJdEQ(q!kBYv%_uOVh_W2UM{Jr(FQ=uK`6pEFi-%Cg5dP!&3%9Hc0gp+4p+Dc?KcVa zwG*9DB|y~B`Rhj$INwZ`?9khJl>I<~^9v6TSGc?^0RoUU)z*VDV_#c|I78gvWs+1# z`lrvhH)V;ih9UU}g3C^07u%ks2U6nq?AdN63oDsdV8sf~BA7KRqaT1hELJ-y5vYc# zcI3!CpeF07dMqv;p4j+!VKkglAQ2a?egT~)z|mE4+H1(OB3ToqIto2=K}TIw&H1Su zF{bfXd~3QdWaXg|{0C%{55%OnXHR;6_QnI;X$#T}6O^&U$eIHN;@_}A8^u@~WPz87 zCnfS}ozVqxPVCL@4-nh##%y)Kp4`_BcE~2d=Zc1u*9kDhhLh<6Oci8z?K`x5M`0bP z@6;?~_0nU_v*GZPo^ti730qD?WY5^xn7?emi@iD@$Mn3gs}V;cLIG4T`mt~}0T$We z_bX{jq5<&9XiVn-Ek@9~8QYNtsb=vhQR~BU(@oDr@&?&6y;O^f=DHAw)zs9uxVU(k z)225@WMm|kg|dUL`56QWV%@~YwmKV2^@8e zu}>UJ|Ax3FvA{cIpZ6pa)`7Bs9l3trea1y}N7NZYP-8>we+34Rw$Osc^Dkh4MTUAO z$W%26(9k>8fX{9qA*Yr2%`&41sNV)!D)z?Jq@*NC`=)p--B>t!l8dFkt5Q$Kx-~vz zNSYSSU{*k5w@lwGD5wYmevLN|9SgTu{qiyy=hqJ>5%Wb-z&{^xJW@M==Oci^V8f7I zoK!HD6RDh_m!9U>rZ{uCtO2l&CV=w*=q)FM1C&9&h1bUiQvj~juq66nTnh*bKeI4x z-=r`9$SFgGb@&CeF8)h#GM}erJaFQ$uh0v>|5v%m(3|`0au-MO4odtG*`QnUGLbD2 zX;ZXYI%y?j6IS4 zuBSQPZ*Deb2_KuD(bmynRo7l~p0gNzCxWGE#%jQA?iddl=Joo`1=A)^Tkk(nB9)|!TWjGy5OPnl#OnKpKIboD`FbkQ%TGLbB@Y`#Q;j*rF_wXPVPNLf05ZQxW zuP5+N048EbFt7Q7I)J&vg49yPG|i?)lv(lDw0h{s-!&zDz3tE=GyedBg<-0SDhYa; zw(a0)lW1_dVQly`+d45I?>%I!fl9u(xyf|s$gW*~z+eP_NjE8+3^o@B{SyLM059q5 z;P{k_q$+@~Y6T}4fTQ{162YTgRj`C*KHi^*rV&hH5P8kOip0=hgAM>FbBwC;uoD!K z1l*yd8h9p)my|hDFG;L{tjRAdyqmH~DCBn#J5pN)PL~y^$^ZP~nNz2*+drfnBw~Rd zr#ZFng)^x*-0n!$+Vfk|+GKelIO7aSny$=nBOz zdO~c65V}G>%z|JVK!&I3Q)v;1q;lvPAw;h`n7DN+L0 z`qpN5wKaMDEMDDVgBQSMZSV%&@%*0;o|x>QJCkR<3UXVtCWu&}lH*~DcBf$PCdNKH zEiz@w6mktbzx4P4WEdD4QkLY@sZ+Wy)P}x(JphaaA2}PL6})ZOcRjSEVl^yUl+YQ4a^CkYEt9ckx2wT6@sGJP z-H1_g8V-+Pmcv$TWq(LMh|!x`DJd$dp}s(U7I zck%7~d67JB$%>8;rg(uCcf20 zHGro;>ILO}_%V8d5{cnW?(It>BO_yw>Y&dw^6Zu%o;{r3U!g=8fA7tWVfbe!Deb7k z@F9i0NG<^ArkD!F%ZPPDZHdxJw=g#^2F1K+v7VK8eso|q&z7s-Wen^HF10H&Q4W(l za#gQBto~!p%5(Q#L%!t7ws+rF`;*;f!j$~y&+%lOb6)fs$UnYm9I?}q=g-p(Vl!bE zk<*CPI)0nuCuF&E3D}Y(*4IlKDA*~vsxTUPnNse35yM}4laTOhkkmvYU~Ji>{=qYY zJZCDnP@%L+-Fg~hu3Y&Ql|5_6bYY>a3%_Q4!vDZKl$X!DaJROsj#NxY3)4m9Jo=+y zuxU23Nr=Y$N3BU0!lYWzoYD_}+D}1xe9?lm122E41qRHXDSr{KWT^CTjcn2nInsBQ z?vTuXPF8@s3)= zU2bk}^MCx&@zodGr7|8GOeT{R0T}x9$&;u@=jbjS?MuXElZ+C4q>oAV5(Vzbc0gL6 zzA=TaMXZUq9(9bWHL-d0#~k8_eQl*+5>&rX{C9)a@oaL8_~+{a=7=KoMr@1_vhLvh ziL;+Rek@O!2*l)7Sp#%ew`6O45Z6aBrU96+Hqc%J1*l*Q#<+2EA)ywKg(zg~^!<@9 z**kC5ZWa9J?0m>a3`Uz~@|u-55%)$L(nNw#!oJCXmF6|#in<^qC6)7NI_E3*Mc10d zAqYe5~SMb%_PoB zbl3P$`pfvY&&tHgSp=bE5Cf(RFI*t$I7|Ci@scvhh~Q;oN{8OHh z0D<|~Fvc)+QrVCk1@(%`bhOX|X zbCCYOTRg}1pGlyJ1;|PMUnqKmY8}ds(+)UbLf=9q7&nRrpN9KN*YGi+rsp8=G5|u; z0lm5c%GsaaO5P2o)kg5gx+;1FpibN%SwWA^5wSYj7mJ+$AS}sGe`MH+KAxqI=9elDxJfld zU{Ho5GaR)M!g7HXOJtU4G042{ty>4#FCK9inZr`c49bI10mjy)kU7eF74#xN536rq zKS}b>p?53^!GfTyC5?SRxYi8YHVN0GL`fM)NO2H1>TWC0EBW2<#DOi?2vRUvSoLTa zd`uV%FRA(ex!9Lx&>#xOC&K(gIF^-#!l_sol62j3RO~TsHa)#et zQ&x-slfqT@Cfamp|K(FcNJCkHH0x0i?eYAby%i^Iek@pjm(Z#yOd-Me52j zkRR ztrnwo(_q!4>GSzviBV4KOV2BjZWt@jL$zUEA}$tPmuiV6po=|iYc*pM$|+1YG%a-~ z+Z0TN#6^J}Q~`9~4Q8h8swGxq2~4FP&5*by!b?=fTkg`1s_fPMyk9?3vOGo$5BUwhn|W)FG6v zM~0NsLtqjqnJvNgHf_%Ln)b^tDk%Q!TsM29Pj<18A0(>~_LNdH7FaAEHPrS1UZk*T zT94>O|J0c?HK9L3hI28U@)Lvq^Es{zD7~he8rGXU{P~uwSN*ETh!!idkl*L^Yn+`A zg*5KF5ZYz{u#bd*)*8l^Ay*0!;ii+qPLps5#!&^QEC=@XpSJE-j;*W7^1X4xdf@XN z4tG0xp4&?DA*gUPGPl;v`FRMZ1IG!uxqT@e%xmhZ{`~o~1SS3n)><`Y z9U@5%)SsjgJm0V3tFCqA6l!6Oxb`$!xr94fQS?>e!a@`G5aiNftoZGhXB=g{>*$EV z41o=hAnMSyACl_8&U}a>;B87Qr2HrgqLUE5uj0;eS%6@EwOShZgwM2^iPu*GTEFe; z(%&yX1ICSzR(v_$k3dYRqmR${+@S~Uy}iZ(R1icF>|U=uHOdX(Nf#I)q5nEpw%)D}-+gxU%Y+Ma|y z%{M;{_n8bTv*Njri;7TP^|ZPdjJF6mWG_DguZBFS$g)VeujqyG)vD!D`<5axS2%sm zz0jR>%0Uvy}; z`0?Y%ol`>oWOhSBV=Y0O-BYmOrjNFG4%S%`AnSU(z_{v~vTO`Sub+p=86(DdFZlID zv0(IodCxlH}ZxJq4W0 zWWm+dd2@>1W{bP4VOgEvmZuyJQz|t0T`oRqv+_S_w&%Dr&{7cR+KCaIGOYn>X!rMo z>6p;oK`1^b!TLLhQUIU$R^~Gnjy}^kKmGgb!fVwF+A-$~r=T1c6is{X`Sa(oUdW*H zX>pRdzS`*E6d8bE!^?!~lTHyjK6P$-2VW=r5Q1X*KTuY7PfYWd-sU8XgcGM>nJrW} z%guonZHCE()mVsZd{xSY&ffg-C}{yq&X)R5%^qIqri~l<(I1dt@^1r(!Q5w@V%kRf zQ2wNIUS-uZmxQrB{I#A4O{^hJsFGOf)Zb9jvZ@=g@jT7UW9(G1+=dC^dSq;CI1LE#-Yn&AX)>%gSM)sf&XM1m?4L~N?${fshax0q!`p{q}J?K$a4I z^e-%3>>)H&L6l0&DPKWUf>!`RL&8tg$)SGLMwC|+nV+OD6mi?~#Qu;v5>0`-tY8e1 zRYp-1bb%Ue4l`;r!@fZGGtbuU+K&Q81VQN^*zer>twk8cvl!yUGo9b7KvOb?2Ia>~ z(Jd66O32{0>U{KJzT)yZmNZ!f)1;=;S}c%K#QPun@ilTxnJt2^W15l9Qi_KO4Rpp0 zO$0rzu-b+Gcz;h@&NAyGFiuBtqZE~uwGq?NY(T(5F@p1Y{xW<`Bvd$a=m@Zqvs`SJ zl7{H;cZ2V})G}*>1U(57U#SCr_;60f=}7kD?>mflv24{>ur7~ppPtyqgmRYdV@*7q zDahskl~LX+MPA0-=-Q!|DNc?eluq9wu<3h6QrXKTZM)~@MpXj$SeX=^#yZwXR}K`5 z{0C3z%z3DV_zrZf-=ZOG;{?+p6r_w=Zm}*!(p{2Kyg>FD9BF?!vH& zfsNa6`yZHB+E!j(zV0@MS!BgKs&+Idw`)VGOE}%1I7z}{NmhPOCfjwfQo`K9JOgnw$^?V z8;prTZ2ae6;T~fM-AZCBXgZ12kg1UJ>7Og|o%_V$^FecU^D+_MLmCVdWwHQGcmMVC z0eUi`ztca#%~cEOd)tOSwafr(P8?oq%0#_|^fp=}|NX9Lzr9O-tWXB6W&O@_ z{is$~3#&11qH%!yUOL=?vNBL0s)2fqZvVKgE{2euV587+2QbuQ8ygMyR;{8S0U4^y zn(s=ETJl3JbSX0Rq1vKf8j_JrtrFIGZ7cv3YFfa#B^j%fgX7_-lj?ax+AWc`Dan2Q z>G-<7x|G>3HWTbeZSm#3^_Q^;mw$_WUbmf*b(U+BZ61VAI*Mp!!?S+qvwv>3!bfXur5U&`atqMv_@VgCgq}et-gMIO`<=tFdXP4 zd!)A0EfO3X<4i(G(-Drso+8q7ajA5MM$yF3x7_Z>FW`I>Bd5+UZ+>tW%7o$;68)#> z239LlAFDb->@@&ss$k&I3>Q+(^zG|GB_qa16zHrLgg1ynkuD%JY-OcsSbVbkSd z^vi=dgfj?UOEm^`O$WSjGDj?C_-LpeB2XtxhZ^Kzt1wo@R0Gk$a8m?`4oT=FO}X|q zC7`^kVsTi%ynU+aaO+I+SP+s72oE>4nlXLLR56mGUFS@KV?Y)oP+JEMI#I<#2aZ^8 z`C5Jm@9YqLPmxP?S_HeogDybGU5kjR*y6!O>7Lz$$p>>2>wY=Nht9@&+t$X%(b6#F zj)_PSFN&z5`_d#`g7&~HNGCPElT0GL$Ib?p{TUF`pEL+rn%+FX)w-HnYj z3I)eW;J4pG)08Htoc0a83s)lshyzJX_ejHYyo9B9huB|B>A5DiMGq3_diHU4dpLl+@+(;#st zYJ@`!d=La`1vh^i?`fl~GS(iY+e=d-B6w*y0-cwIm`DU#Ex(M+tBTb~CBeYNYRx}1 z5!sJOo{YaBC`ZCkPtA4F)sTIrVB|FJF?*KfKaHMplnBbAV%|*%AHiv|7`KeZFcL(ZH%t=*jTPB3Jg+!<06;7GrI@@ZR zZ+L94@jX@2X!77>Z-ST-2>;l(i0(XK%_J%WH|BszsfY^r5j?QaqEtr>Tqm8Wj#F$v@$|3a2R-fS3t<{()$UK(dq>O zG3~Z~<}@ks8#G+s%61M^zW@CA|6g(oROtWq%r9=m+@pOK?I%^R{V;)qmu^|~dX)sNYQ1gV{#LKvoW5@61=JX&+>>1o|KI&8{|6_c;amPUDVdUc2y;;G z0s7GuoFamHgn(>eIc60!kuxTZ8X)caIK`VsQ|WLW>{CR4h?-EAgWZm^gDR2e6@lvy zc)thxBfsZ{k^~3r0pY5mWm9IBJW>IH;@GmkR1Z6mRKNZ4qXT>x$_hf}QbV*n((BWk z$E38NS3qZ{kQYS_#W>pWcoTel#5bMLkh)X4@wwFyfTOYPb_8v(r_(jy54m9PD1~5J z2bXAw<33&@6G10~$Y3Jde-QCLDi0Wefgw^(5dg5TE}!v{W*4?WtclQHB=3L42`xnx zmjBk(b;t%xYj10#)IVrZeb%9HGLT4c!dXrJvcyd=|%SlFs7E%Kuu-?4Hw=1^JY~krcuU3khP^J>OETlu7L4J@k zP)8`2LU%N<%&fpT5uM^7fNqAb$%X+FDr%VX9^U}+;Wb{bzT(xSGgE8dx${Y>oe+`? z;G=2N%(bum2W^5+d><~5QRD2Omc=lp>6qhCN5V zEk}R^bijtX+kf`rMH&?$DOM>2g+^%g>L;9D4~6S)W0K~QzwYxtLL}_HKN2MDy$uLj zXewSjd-f_aZ6N<5rI?C}Lz}nhY0REBJ2U?QF`+GWuIR_08G;zvVfo&?NvFgCZeWsu zhVnRji$ER;oRG}9fBkh|;Er(65zd(c9-RWCFenKAw@)Bk%lrt6vnzCBY_u*ksSa$ zS{N%||29!VcG${rr4G^MQ{o4+!{@LyFO3I-A1Z74U|_5lGn* zK%*nk=y)KR^Kly$T{_)xFlJrbpCS8Y)|+YI5}`93ilYKFi+Kb)m$NNl+s|<3P4zSP z{+KXGIq~lqSie37i)&BqVE1fb~$cl)M zk5@}1fnkf4;M1QcEqbl^i@v<`x37noYBYeGJr_S>m_I;j47BMG=ga^aPNL{`V$Sws zHpNIBBP%YF6ME4j=}i1NOH zYs5-6q}Dx4J~_AW(@EAN{P$twW4C`B`b=aXGcyypJT|rm!cn>da8y(=!HEbTVHcDL%(s70m^I0~94j1ISUNqk zRP54fE;g8J!uYp#xgRHHlGcIxrT5n$O797(a1}f{WMmPFwWg2_gq(}ZrYY(o+)80A z5-V{`60vaN(}tUCc%IBlH2aGrE=$Ul4pAhl4e<~yJTj^y`m?(`XBeH>%%57-Omzzx{tuV^kjvMjYs)&{Efa~-HL zIIcr09R0rtlD@eWI*9~ag#ABHnX(uLxi}qW7mn$gB4jTWO?UCH^d4$k5Dt-10f6NK z3WT1&)8;UKq{>VXc`JO6p`B#+&lccFV{2iRT!c-eKfL?K`r?ltKd!|oKi0O*`L7Nm z_kIz2>LSF8Q~Nt`;>%0mJX2_;MaU4FRVC=xyoY6PHDhYzd(^k}II-p;*wjK;xkb=I zW*}o{3fSl`yF@vQ1r*bC7$;L*z=-H#)&)Qho%Dc5$=3n{t>8#5f^a2CuHUm;(lri; z4z0s6v6YJ@o^AU@zsBLoQn!UDkp5q=Kj>7Ib%)+OQj4EvZU}p9Me!f!&x_-PLY$>K z1Hn&Iq&xj(fy>tME<#rJw8^*6dvG+yi(NGD5s0x~93^-Wsi?-<38A|;!WvaYIAP_g zRYh4iB3H!ZeCt$s2`C)l7zEa~EyMYb@DeW~j`Ac$7(=EGj*enzc{U4An|x@>Yq(-& zTbJ^%4?DB4>XVj^&UJi%K>_x{o7Pr3ycGwJysTJ_gG{l7fgIn?js^#y zMFgN+Mp3G1CfuEM>(-$Jh;}=wT%xne5c8$;RkEbbU0ML5qW(qL&x5cpRY z*uhKadUVRikIVz0&JyMO+zyLgYton?hCfbOe8r5wHH3%-G*6}20z;5%PLtJSEcuW8 zQzaT*BkPaVy2dk}JMDG#RR}Q15L2t+7SvDyGUi&aAPVF`1%JE}60-csymJvqpVF8S zJB9cK#FC2frPH-XHo^T)!tcfnLhFQ~blkLKzBtk?B+-)VKrta2^TnxtbdE9Kq0O&{ z{i>4H=lcxK$w+*Nr-ss74U1j46i+oBiWBm_eptpf|3OWfFLeqz6C1K0mMVSs&XboY z{fH>DH?TO<(eJhu2)}+;P3|Gip(0(d1_SGfppyDy&p(~KjgyQF!=9+%NKtJBaIWxD z-3El#dZLC%1rp-6F2d$!X8bEwJg8U=^8v0qwIloc{3=>EWjwWz=PQt+V>KY^%|(GX zW-gV+H_$8a&Vwf>Od;tiNIYuUCspRE7Z{gPJx46w6mYKy>hDDyMOXi^zd!B9>*)&- z1Ew>q;`K9M;9R3W+FS-d=qiQaJhSR(OkvJhyx7L}RSx@?Y171D=L>gFQg=CX^5jCQ z`goEvAO+v)gt2g%ZF}M?Q8?mWPVSE))S_e~dmt%75w_?$8j<^jRCMvIh49!KH-uklQOzTu_ zN3bhX^pGNuzZuLTUjg+CXful-Zi&qZH@kET0n{Z3T}HkE=~w)mdkRl z{;R5pd>3M~XW^*l3(x@ksLS&j4pR8F!>OlnQ!9?_6G!UGEGs96hth+G-aefZH?U;$ z;c_}*3+VI$Qf7;x=C8*sxBGZNWj+ce(1%88z?u!z1{ z*X`|=^b?4e>p6p(OXR#8(T@UN_w?9Ze{KoQ{*Dy8WK;H4}sW zT6+RPTh6w8x1;`VNM9}f`xc&ta?Q=dqZfS;(GrTeA~~oz&2Iw3P78wJeUS%dVgi_Q z1HY@rqO;benvG|uO3#3TBexr#6&DMw5~KADAo!N8-r8FV-zihET>5=0~tkdcXY+g>!8!7ok8 zb%)YVIKM=^Y%|0%o*1YplrlkiMs~`rG!CtWWtOes0G2&Tqaxw__-Zel zTdtqC9LHJHDeM>kamA#~O~R86vwvl%tRj^$GXhlrXP-`EMc`B-QVB6SlIB5a3dd|? z)IS$Ug6QMwv^J1%;$uSi(&}oX7pO<`Wc_SYpBQ&^4BME?+>v5bAB|Q1GCMX60cCsYbZWM%WJ( z1QX_zg^49QgQh)~&0&NJ)4zbi&K+%$1OZq8Tyy8%hD=2HPHYmyVsC*?uZJvyV=d^s zNpg`eTXF061ZiXmh*nocU!~(8DKLh${{3C|aSjs00O9}8fZ_P;pu2wj3HcwFQLSLg M@7p2l25;^#7_+Oop^))9JZI&wb!sQv3ERw)tKqjdHX9?HuhHL z7q(wBzG`P~bNPVKA)y2Nwwu}8U$K)A7PkK93xsU0nhJmF(bd33e!X(?j2#mb>v{6; zl31A-b0#K*!xXt=noiG$Tb=d&yB8LJOodzBxV~M9;*6i|=d>J0Tz0peiRH$TjtP=l5EAbFR=k5SYx@&iU&ZX4G-SVB%HpVQwv(a_Lv zMncrg7?;ku^6j` zdG+cietv#jE`2*V4`1a`DOj^jJl0{ber#$=CuqNMZQ_{&Nk#>25h|BY9dR7doEmA> zO4dItX5BOqf3dB=vw+KeLT$y$mGR0!`*Q}9b0;PnjG6;`xvq(RG@G61#}qWoc?CXs z^2)Kz`NZU4Lm>XSar0(fj)SFjQ(AGG=}1eq%U7>eZ0pzWR8di>i_aKvvdE`vzM#pX2xmR)|A-=#;5~hIJ300RH-grE43knJ1|t%pAqCXn3Op& zk~lj1f%bv|i~7X9 zHa0dZR;=i+I>B9TC#^ctdw#eno&4_j@#C5i$5(h82PPl5`0=;8q_aAqp`pyItUAid zzUmqpoU@v7>hdbmGnYaoMsr7{TOHfoS*$f;PHVO1IA}#HZwV04IgMMW-xKC`^~2P+ zvY-QFKYmo%RY(PzHqr_f;?<)R&4<3cp=Z?AYOdKTdXim0+dn2ICSHe@{G;cy)lqKMmAxN{j&EqtXmhcC)DY z>>s2R)LYW>qTjtcS{^EOmR0im^^bnsv=ys2_TAoOSV@M`bu_Qx{CtCvrvVme;hi-a zii$qFRYDVEWBIIGbF^@G)CEcXy698e#4Ku0;%2BJAt6$#Zn*oL&WA@hGG_W-`Nb@De<^!;9pFP{`JF+0Pi zJ^88NS$^zM+S@Uol#~=vi(0q`M%1P2or}9|0WU0x_eZL7Pif3l$@B8}4&EUg! z(OBow!!6kw#wGr?x&@w#3(PDm^+k_&(Ii&SlnBtwCi<#;e0-`8R7k#xjN~bQepqAM z!OOL?lY=x}MgZ2~iDj!;Y6%SYhPs~KB&1)NVcnc|zHp_(Xxn_s;PmY5z&CI1`j_(e zMa`>u0AVHhL%96_5d|riiAOvyjyRq!4;HJjDVUFr3G>jy3#wUV=EA>x(dCqKsr`20 z1_20GsfkA}6MYe7Wy*s3S*m{0v$5KVx)Jy!iQ3mLlNRKGm#zFwb!MzvD@u`_mxm`7 z(_+!~HXCbCn9`JP8CXv<@~o@a?6Yo}|5_{)F>2Yz2iwZ?-5JXL)luc|yp|1@hKO03 z4AduCdU||)w`5mw*^46wD>8V3)LtnxhWTw3D>=D;es(f7)7aQJ2;;Xoq}&9TFtw3! z81Vl=r;B66Q!e{XY3$fk&j(nUC*|PSv=ED(hGY2 zoWr#M_Ys6OP=mpd6a%&j8jV(jAG_(xGmcf#*nB!n+Ir{Coyr&!Wxh2;)mh(B(=2r%~b_VzY!Oo=KqHE&8YSD?;( zy~#Rcjb(am+M^2~8f1=t=bcfQIPz0x*txlFc!E3^8SN~?0JbY%77}Rr7H)2CWh1S* zoU?1VrCa>5s5qqEzO-HIcYPWZWIj-rV9Mq6b&2;i%E$8Za=>C?#C&#d=m8H859hWM z{u~6zG_g-6hZ;3T^BKtxxuo>YH4oRs_|3ORDF&!x8yWkm+1sb(Np0VLloXSNdB%9+ z;-4E-Vyzle=)HcDV|Op-^zU{bFF#0)Ogfus0azJm%gbGu?qq#&$oBZ2)6XkWm+Ia+ z+u^rD6`Bh&i!&8&bqnPO+xs3K8M$&Ov1f2F0qEL~ZP=7;XS&dKt3Wr$J`VH+$QEGQ zXvCV{{n>+}uBR7#`uU*KypTc8m*#~W86m^Bu`&zOvRHpQM~`0j zSeWURY#wgTq!lWccDtdDmXwtN_HK6d&^=`&X6eHMGBPsWvY5iPYr~B^=O=@`R|~VV zvqydZenn9C^}9BDsc?Z=bB47G*5C@-QLK&!ydt$l|)Jg03@f#W!kNr3XDl|D(Dl8x%Fc{ps{%|Kv zW}2tCz1;}3iQg#SEtC$p>^@U~5oW2d77syryez|d5tB!a1nJv*=+KvMKiXVJ_wL%& znX+W33=5}3WU!cJk2%dCH^V(Ul|I}YgS!W>F-&g<1mbCUxw*N)I{5Hb4=xptk2O(B zo5akkrg^g7EOF$cW&Vt^ED**9ZI~JF9Us!51iFX4ul? zN;&Dza_9$D*TSTwTQ`f7B`m0ymNl@D(>CeT)IOt3eqvdlSaom1 z9{9Z4@?4#A@T;vEvy230xDjVtz~Ms3Yy# zaFe2=p+5`t>h?3uQr4ZcF+37IWRV?s%y`WKk%fihW+5v71 zkL^HuOG`^F015<1|H*kETd-i-f|FlnURO!l< z*KhOk{#vlBl>&tfL|rD#$N)t|L@27L=rkl7aL(>KlOjjhN7mLc454%W>d!^)VN@!W zAg-&ciAgjI$DyyU{eUixjSY}Yj|y|BU7ek;fHSeUCQw8(=Jbn+*+CjnUf8)hi80um zIg|Bg)6e~}R4Z2Xm^Ul;XFHn|?2&#zT*F*4xd*%ws=zVp)cclfJ6cX#l%%9&ZN9r} zx=p(wvk!`x=aq7wqAYPZ_7@9GYnu&r=LtR;9B7D;l}epVPRn zh>ZG$3orAAhZ<8|z*@mc0wjASyH50eeqroe)mQaud|&B&`C-S5PFevaCMxRiWMNlV z@e}8!t>RXE{T1767hX(qxqUyzyJyc44wI6SlIq$xjcybSQ~`r)&7?-5@TXZd?&l7-Uhu_MqV&$q$F)mF$QyB2E zqo>DYQNGV2>^vJc(ZH_#QGpYXN_+S2rC?V(=+?)ma6{yrCfJD@oPN1gVz@1@**JYU zgrs>*^gwHFCMZjE@sm9Xn8E?no=BO+CvM>OwU`v5s`6Z?>SY#wu+Gz)ZS+!29?Z?n zrMb-DEX2En}?!E;%Q3yiu{Qyu<;KmyM~1$B*%(l9lAA|h(-9*iVR zM>0d~=FOYz+qNZOsU~1pUHT%t{r&wTw;V9(!=N}G3d&XqlZJz3jiOW@)K_9O9 z#O-Mnwxhf*#aQX~?b~rcU*XHp|MXj4efwS~@2Coi8zLM0uSR`R=Kle5ZCt2-vug}XeW-R!6e0n;>-#L5c4K1hxRrXWI^xwOVv>e{R$!R?| zKYyw*#kl;UpOgu%ne5a!9~EdbHBeVNJw4s!oTnuGqXO^4tc$&Q^JX^>&!0}Nt|3G< z=%>7}1c*n24(tZMb#ieD#xG6v%8S&oZ(rCN!jl za}V}ZG_$^)=?RGjng3W=Sh#%EDlDv~XXPOWn;CACbvn_?>jdLm?W2Ox^+fsVfT>E6uk_?p6$JEx_%}xC{#b$ow8(;t3ipSd^|9 z!xJ`s8XO$7gqLBwFjcVFoz1ae(H^HHoLd36MpPp~Td;FvY&Si>F^m1engF zb_RRSb#i~Ksi}c(`_rl^ZEuC~RH|u(_*9!KZQfNC*f);J4^B%xOp7Fx0TZ4 z&FzsjG*%O%5&{LMk>}#j`R&_zz^TnhKI8Iu{aKqJ0xt#FPwlm_YK3IrabrQCB8Jyw zjQVp^FBPw^!6MwSe*FdDw=$rv4D)9ViXJ@rCfuyiH~ZlM*(FSTE4e(T&s(?W8=w*j z4ydcXw`Ez!6fP&>G7+1+!%jt`q(;fVz#CFg<<#_+D~E+oIlTG{BZg^B5_1jpg4a_sz?Sr*(&)ug-H zjxS&*kByHDbXYJk9rcKeiAlKd!DnVxcnsBL%u@P5Wb5Ipkwm^YySfU1=mG0&`|QTLD1;b7BQgK- ziz>v==jVqzD@}nwIS>b3Kps4i#rs>oCUb3NV&XgIBf9p5l&d!3s?jQ89*x}_b}Lu< z@6`~stlww-<@GUXX=&8w03rRXbE7q{POuJtc_aJlufGyPS)X(^2GXZ75Dry>ap}`| zNKJx@kT4p=^=NaSG6?izWn%JQ8~yCjrTpoR)r@fvtPLACnzXr%pK?8GVG;jhVnQ^` zV>V9Y<1^4Z2vbxHy7VHJ_=9qj0|oQ+5c~$9_v~tSNszDaZ?0ir#6g73=Vqj(iS8eWReY?s^DAEb^so+; z;eO6)zu}Igt3j1ib}(sHQU&>Y}rfk z@%7cjAY)dnMpNOiba!?2eLgapHgyJ74oc8$^vR<~;TTOr`jsFa+;T}pMa4Jll*{_^ zTkm4&ydtU?6%@8LA*o&;J}wRuXy4>ye(RD z(jgraFte1w23o`QCCh5lEp@Pdm8dz6qe85#tnw#LSi8qX@H-J8JDmzu7c7h>1V5ph=@QtJqCW!9`8CK(UR~B6O(R8`R0p0Id?mR zq@)ZM78an$JHKyXYI%1kE~hW6Bhtdu!(&r3fgL91)n4QcT>ta+|F;n^e8VC~`W_+| zZow++f<7dopiajqK;&cFr_HZ0Z3EFEm#LYVnb^5$rWIV?!*H|IiTMbkkK#^x186O< z(XRjsM6?o@RZais6a%G)96JSCQ%$}-|9<(Y7ZP=Crog}8{l-4v;ZcBqqEDYrz+0`p zy?WD-J25CZk6a@%Pe41dk{~b5sNm)1_1J26ta@lQf*+J|J+`e|<4O5ztB30Y1RjL= zcq*cRP2d7YW%B)M;geL@9OPwKm2q%thOo2V!-9f>k+l(gD^2Mg`2StZh5)M$W5)#o0SMrUJ6K4Lxili=(Qo;$$>hh z^XJb~BLSxUSPv;QM}Vc6)fZJN+s2L2{{C#dJG?NbJYOA*E^|KDJ9-z_!56Owf+))F;}hD{C>KqQuk z1z2dXs5v#%WneD_t)&_mXcJAAG~yEhn=9|G+r`Gkl?;4Wq>>g3N@s#idp>~oDe>b7 zc439gk&t(%9v$i{ zJ7Ow!1Rt_}`SBsACANSjdYpOmCQJP2g4af@ebvp+S>*cr`z1W)oI>fHpZo@46|7Ka z1D2e>DzR2-?t39ot;A5BhoeEZY`T5FI%-$~n0az6n&R)G#vE9xjL-#95`O#r2C7^# zboN5_bup;uXjY3e5c*dSzan}DA`&q@cK6Y8n0M%SA#_^-XWw2POJ)* zSQ0bS(`-(*c+T5@^dI#v1w_F&=PS~~PkiL^mp(qwyV4y<(_nxlb5yNJXFFQDjt-po zwft@)FEcb=larTWLlx;y9hQShsiUq=<%t90p)n-%`Xye+{G?`T2a$PX)waT8$N{e= z9X5VRN&Tv-DhbDt=K>aF`1Zyut9rCUHtpK59^5DWxVSjQQ>W?zjXdJgEgJ@~s~zPZ z;DSQk6FX9)lmacFiF2U0hpbtpr^DejO@6uPN1AXe&TwPNl^zC!LHnT{)??24>#yG) zfnW1I#tb}u{1}}Te?m5Gj(9G-C1Sd$sA#Dm&?Nl#L+(XGFC5#{uw98)*?P59kQzyt zBHTH3v=Y2FVWWSwIKAp6Tm^F&i+Zomc@eEdp<;_hb4j@rH8)3Jb_G z=~jt3egC>t7-Z~S-E-+n*Sd<r06`P%SeCqrDEjx{jjOKrQ z;-*Go!N$WNrt+YH16w%%TmmMIZ~19Jj9JxjSSVFVnQief90&hc#f@D6`mF_6?wiGU z>woUw^0L1sMqvMbbz(zwrp^kkIUt8e2^P233#G$N*mUw3 z-g~y*!C)@k729&>Va~gx`3-f^54lC+0zg_`3cMyFy}mC6Ug($i9~A{K z=6!#^8Vz(GQu5>#6clIeGWwuY1-~!#WDFmaLQe+`Wx^mZ9W+c{W8k)n z_2zM2n0NqM;bSo1EY`=qs#euN6z~m!-_gR}fE#wB? z2+P29BNTw0-PmS)YN`QyGY_Qv$IlhkuD7 zDb-|K8F|der<#KuW7Ncz2X}_Ic`Q|FtdXlC%*ybcloL$(R zd-8y1#LDKSAhUtSLp8~G0CM?u?mUh#k*bqZmiun9Q2rKhXHrf2!Qcp~Ko6{h-2|7f zc3A#$XviuL=B(aZr#CFz(ur_`yt`L8r%aMyh;aV&aTs-5519CZ%oFs0BT?993LGWX z1`W3uJO^AWO*14RzGH_qQ!v0BvhGl$gT z+&I5MP8z8RD0nJp#MQze@AKJ8z@!Al7OM<5sYFGCJ>con-Tf6o&k5K28=6GDK3bGh+X*em%3OrSry42w@_%~{zg9OIG2_z zTe_zs`dlai^&~EVnTT~~&{ybjV3^NOH&5*#p)30a14ni_L9B53_x-Xa#7J1h?e-{U z{wAw*B|ux=uJ#KTBVfbB`8gaZ@oji zH_3P*<=}d(9(78U=ecwoEUB*wvfJ_PUyL-6cGSMvIoX}Awgsm&cHFgEz>59B%rV$DO4i$NR|fg5vc6I8<=l`ZjlQ1Lc(DJ z)@2;V*rGDri)?VLMf5NKU>C!aXZfRGL;W;8jm;K9eGNoT9D0LWugIkw^DZiHd$JdypRp_ac zaK&(A>L;y9ynsz2X6fVH++3LZJ@G%O?yVZ{GLm@AgBz3_`xjAbbVtNXdiv`!cjOg_ zwFCCY@l+*PH13@b;V8eMOcQL+Y`qr3V~&0YOR1Ik**`SNX1EKUNgAi}KdEw0j&N=} za$KanidYwgDiZz92a~`@Dm{rwpcBx5u5TiCoGM5`01r6-Ah1aIU)%%v((K&aLFDN8 zHKKj<^3eVCxqttklis_Qcu+_h#;Zo$kaY!i+Y?490Nx({`VgovedvsLP=x*-l~82; zO#j-lxJx2mNC{`yAtVOh^whK8kHK>A{9Ca|UlNC*LHfSvS*V+sMBicIjE8m62l-1{ zQh#%I)4Pb$#DGF3kmg%u#Lds4QVD1fn1f1@*7Cnz_cLT6oHwCF8 zK6pNA0xu1W@t;T1&BCa1@k|Ku(#?zTKv0yWKrk4Vr=QTEQyAFWRN z$LhD=o->@$Jk-lFPx@N+rGlAkC;!^@-ep)fCW})rfG1n*D$GaQ@(6zNP%x3N;BF^_ z#bie-;&V2Y=xnz@b{AHruLwN@B)6x(A;O*TJxOXRo`uA20XS9nh4W(*6ZZwy1NanK zVodK6YXFuBKkSpsmrwV`4QAMODv-`3$yS+hV>6QO2}vbF75;Qz<23dl=xbOVcJP5! zb4Jqp_wOgb;7Jv8>A1J23rQpJgjbaVg!u&4-0K0(f-_o1+=+mz7K@c1e8BV}nro&u zDoRQvF{C$LU^1mJ9d_-Voe(N|OAB5;LxQ##Zi;}sU#0Hnoy`^d-$ z#w@`71)`sb8t6i2QzMItPLjqOq!e8m9UUTfu-Tc7!9BvA?BJFmYgdEKOssU!^l(Jx zAjLvuLy#vYfq`LI1mtO#E?d@(=(%Z_yEd*%myv8n(34evdstWiRf37(XOa(=s`GMy4UmQ>yZ4@%q=>B{O3brOECbZd@0h&A$wv&PjvNJnq6dV`{KZh870QVZ~ zNL^KO27)bkFlT7tDnS=$%K70NxE}LauNSf;%78peTDUmzm&};=trbL~#>>lVMfzb} z^>`<$GH6NNw@8bNzK~H4bJMoo+jatX{n=1^U=>P8I-;3@v<}Jkf<`2S50J_vir=Dj zoc#~pQTSjBcw2Y3>z$(V^5OV{m;8B9EfNzG3k-g`S0#?yXVKtI&f14?0n9*v)#<-V z%oyiglG}+9L~w)f4aC#x(BT7xjy`(-XBlmPqeYsaggt;Lk^~D@D)HH%X|uxz@uDk- zW0tBRd4i5pG|J4+mJXKMQ(>cIxG>rA(io4x(y1M(ME}lB|3F)|2EiJaMp-lbhF2|r z83~}10|4aR=-a{=UNB}5Yiot}Pa0h0xSc>$vU8&pnK=K^qof|cc9 z-^s;)^Z#$%+MlgU*7!G9Jyr>mxa{BC!~bX!|KI;rpx(<2V3z|OrUlk^`_?U@SCM(U z+GqFe{R-4uKAaLjE^nYEJN0L4u@^&a0rZCt@d`RRZ@S|?=9IrIf~@^S-BmAP=kcQ) zk$Q=v81_Fp>PHZ14u_#2;6HV_55v@i+AHtu9Xk=uZ zG)W6sg)}na)Or8zf}nrs4o9Jhkp}w(mT%LWi=T{*_Uzgvi*Hzf*H=3EMZEa->^T8_ ztPWV!M81Whe)Vb!f(&eH*M6-$C@QLnP6%DvbB%0vsa>GKXLLQ#xUuonOw@hz4_JP( ze#6}h7cNYYZ0xu9w}m{D5TuBTifZJ>X&u`c%cV@$Uuq;)>?jdC_m1gr(+4@Dp<$ps z$=!r!eJ}nDgLw;=|I3eA&N`D;_z8!80PhX3>uFzNK+$HAW@Szh#WXJ4Ti;9K9&9WB8!Y%shWyWO|G$iY(hA~0 zCxFqDj4ZJLNtz>832XDib>pQ~f`olmE5gTEQqpM0$2QO0^C@ntJOC9cL(oa{hdt-C|p}>?N zBfanYi#*%x3++9ZYc|`J=Rf^L?(^1vaKINac?kB%tFF;6_Pna5!=!V*z3tf-+Cd?m zk!CEt()RYnc=vtl?vi)`&TsVt3|PofCJkL(-Oz=9QbLG?)1i`a|2X9s*l?--P{a!?(p$nF!@Q@>}tLqZ6QQ*=!pH2g7ufG^{l!t;7 zI$1+I_Um)wgE6iA72o9j-G-XCZNex1=`qi++AY)Y68o;@-9Fok3fTJzJN_+u^>aYy7> z8e_2$I18^w*k5F$>GGZTkHGgNOCM}hs$%~|Uvh$Do-s8DkgY`+RTIXqyu5rry1Mj9 z7$|!|;qaN3IH*Kw0Sq}LSa(rok@6)cF9=hDCq#HC$~w^$8+%j*P2q+?M^%yVFFFa3 zP-=o_Gtx$nP>4D6pOx;&yb9>q+6?Qntq{6RISvUV@gwa%`<*-SK3lyZabfou>bZwoW;bnh=Z4> z0*OdO2k|A*J5)o`4ek=6H3Pp}E^ojTS79Z+M0#hV!(P6lLk-(>&JQ<}Lzb^j_|?P3 zCLxvT2L6$0^IHkTEzG#w8jlVHP9~BL#4M6KKMys8VVzo_4q-u&Qzs#Kn? zgiy^OzNz8%oQu#gbe2cI)v<3`!)7!_$Qed*@Zq@UDG!j044&y(&b6>KowopB8z!!HbMu_E9q&cMH!ni&+o%ILbhY(>Irx&X7$ z`H^N7nR!hT$cJo;hbfigbct7PU0Cgdo!7AZQjJSDl7DvAz@#%`C=Ky z9dm102JKjekgYP>B&Tp7gd^hz>iRSE2~*Le8^;(2p;L1J6v0~>t4|Ehh&Zs?1ZN6A zHa9oFMR)7A_-O$WRQE-m381`i5h-E|&*wnzw%)MCxtKV3L}zerzcJ1H$vt0RQQ|^$ zpE+|T8plnd(K$9jLv^>1&}S0v1`Br$1M-Go?LEUdRS}p_4wG&rrw{-9@PU26De2{F zdVap0#ioAz8B%LbJ z_54U;@euJLy4Hc`buTz+|sgFh2zx!Fkzh zb&FF;B__Ti$)UH2#qjx%H(cBQEb(~s9u8YVa1oAT+K9ta&`RXIVEQlo%T%k^-evOF zMb8muW$R!Sh`Q3PTp1`aqBw{^B6;6vw>RB_zp}B9&cw!w?hCITx>J+L7W_PKj#pm# zd6ZKx!zzw6pz+rQ9@A(vA_{TT17|hg=U>*>e~yqt{PpWhDDZJ;!Zd+4xX=7?bCq#w zV;as-W0NWanMo{!90`O^mY|<~6&+$V0L&y@ezp(am$0o}c)I2Kw&P%MM4v+9k{n_k z=3f(kIbyQE<^<{FVKT_kyuC;#CFsze@{p5Dcs$szl|ctgNvweU^#+_?4nQ?y;gXDn z8LWlB4X|O)=~@`V{BWiwhnsa^_K{c;&^gVn_cT&}{b+Rxb~rA1H@S1|lB^y0OA@hY z<&lFGINtKJUyZ+P@d8zH*xh4(Qb#LMmoS?goEaFm>I4BM?H@cBIg{bKogD2U4y9`W zR#Ys89{okl2;Vi=2W^Xfd$(o>504!7b{Yw!;qeAYkgz`S%r2lW;}yJD>Lr|pY4@d zjPqO=5A#8R#P27DQY$v<&NDG@Iv~e%`6PTvGQOl83}2WO0MevG?;rrDR-q{O!bBm* zi|He+351jtJ=!tTL`P+0Fh8@L1+T1 literal 0 HcmV?d00001 diff --git a/contrib/plotting-visualization/index.md b/contrib/plotting-visualization/index.md index 67bee6d..896e10a 100644 --- a/contrib/plotting-visualization/index.md +++ b/contrib/plotting-visualization/index.md @@ -1,3 +1,4 @@ # List of sections - [Installing Matplotlib](matplotlib_installation.md) +- [Bar Plots in Matplotlib](bar-plots.md) From 6f9708595d58bbf6945dd9f66355f47b5b56d94e Mon Sep 17 00:00:00 2001 From: piyush-poddar Date: Tue, 28 May 2024 03:19:55 +0530 Subject: [PATCH 11/44] Renamed bar-plots.md file to matplotlib_bar_plots.md --- contrib/plotting-visualization/index.md | 2 +- .../{bar-plots.md => matplotlib_bar_plots.md} | 0 2 files changed, 1 insertion(+), 1 deletion(-) rename contrib/plotting-visualization/{bar-plots.md => matplotlib_bar_plots.md} (100%) diff --git a/contrib/plotting-visualization/index.md b/contrib/plotting-visualization/index.md index 896e10a..e7c5745 100644 --- a/contrib/plotting-visualization/index.md +++ b/contrib/plotting-visualization/index.md @@ -1,4 +1,4 @@ # List of sections - [Installing Matplotlib](matplotlib_installation.md) -- [Bar Plots in Matplotlib](bar-plots.md) +- [Bar Plots in Matplotlib](matplotlib_bar_plots.md) diff --git a/contrib/plotting-visualization/bar-plots.md b/contrib/plotting-visualization/matplotlib_bar_plots.md similarity index 100% rename from contrib/plotting-visualization/bar-plots.md rename to contrib/plotting-visualization/matplotlib_bar_plots.md From d7608ec46647f127219a9ece2aab5a22704e360e Mon Sep 17 00:00:00 2001 From: Manmita Das <34617961+manmita@users.noreply.github.com> Date: Tue, 28 May 2024 16:15:12 +0530 Subject: [PATCH 12/44] Create concatenation-of-arrays.md --- contrib/numpy/concatenation-of-arrays.md | 195 +++++++++++++++++++++++ 1 file changed, 195 insertions(+) create mode 100644 contrib/numpy/concatenation-of-arrays.md diff --git a/contrib/numpy/concatenation-of-arrays.md b/contrib/numpy/concatenation-of-arrays.md new file mode 100644 index 0000000..a0c5051 --- /dev/null +++ b/contrib/numpy/concatenation-of-arrays.md @@ -0,0 +1,195 @@ +# Concatenation of Arrays + +Concatenation of arrays in NumPy refers to combining multiple arrays into a single array, either along existing axes or by adding new axes. NumPy provides several functions for this purpose. + +# Functions of Concatenation + +## np.concatenate + +Joins two or more arrays along an existing axis. + +### Syntax + +```python +numpy.concatenate((arr1, arr2, ...), axis) +``` + +Args: +- arr1, arr2, ...: Sequence of arrays to concatenate. +- axis: Axis along which the arrays will be joined. Default is 0. + +### Example + +```python +import numpy as np +#creating 2 arrays +arr1 = np.array([1 2 3],[7 8 9]) +arr2 = np.array([4 5 6],[10 11 12]) + +#concatenate along axis 0 +result_1 = np.concatenate((arr1, arr2), axis=0) +print("Concatenation along axis 0:") +print(result_1) +""" Output- Concatenation along axis 0: +[[ 1 2 3] + [ 7 8 9] + [ 4 5 6] + [10 11 12]] """ + +#concatenate along axis 1 +result_2 = np.concatenate((arr1, arr2), axis=1) +print("Concatenation along axis 1:") +print(result_2) +""" Output- Concatenation along axis 1: +[[ 1 2 3 4 5 6 ] + [ 7 8 9 10 11 12]] """ + +``` +## np.vstack + +Vertical stacking of arrays (row-wise). + +### Syntax + +```python +numpy.vstack(arrays) +``` + +Args: +- arrays: Sequence of arrays to stack. + +### Example +```python +import numpy as np +#create arrays +arr1= np.array([1 2 3], [7 8 9]) +arr2 = np.array([4 5 6],[10 11 12]) + +result = np.vstack((arr1, arr2)) +print(result) +"""output- +[[ 1 2 3] + [ 7 8 9] + [ 4 5 6] + [10 11 12]] """ +``` +## 3. np.hstack + +Stacks arrays horizontally (column-wise). + +### Syntax + +```python +numpy.hstack(arrays) +``` + +Args: +- arrays: Sequence of arrays to stack. + +### Example + +```python +import numpy as np +#create arrays +arr1= np.array([1 2 3], [7 8 9]) +arr2 = np.array([4 5 6],[10 11 12]) + +result = np.hstack((arr1, arr2)) +print(result) +"""output- +[[ 1 2 3] [ 4 5 6] + [ 7 8 9] [10 11 12]] """ +``` + +## np.dstack + +Stacks arrays along the third axis (depth-wise). + +### Syntax + +```python +numpy.dstack(arrays) +``` + +- arrays: Sequence of arrays to stack. + +### Example + +```python +import numpy as np +#create arrays +arr1= np.array([1 2 3], [7 8 9]) +arr2 = np.array([4 5 6],[10 11 12]) + +result = np.dstack((arr1, arr2)) +print(result) +""" output- +[[[ 1 4] + [ 2 5] + [ 3 6]] + + [[ 7 10] + [ 8 11] + [ 9 12]]] """ +``` + +## np.stack + +Joins a sequence of arrays along a new axis. + +```python +numpy.stack(arrays, axis) +``` + +Args: +- arrays: Sequence of arrays to stack. + +### Example + +```python +import numpy as np +#create arrays +arr1= np.array([1 2 3], [7 8 9]) +arr2 = np.array([4 5 6],[10 11 12]) + +result = np.stack((arr1, arr2), axis=0) +print(result) +""" output- +[[[ 1 2 3] + [ 7 8 9]] + + [[ 4 5 6] + [10 11 12]]] """ +``` + +# Concatenation with Mixed Dimensions + +When concatenating arrays with different shapes, it's often necessary to reshape them to have compatible dimensions. + +## Example + +```python +arr1 = np.array([[1, 2, 3], [4, 5, 6]]) +arr2 = np.array([7, 8, 9]) + +# Concatenate along axis 0 +result_0= np.concatenate((arr1, arr2[np.newaxis, :]), axis=0) +print("Concatenation along axis 0:") +print(result_0) +""" output- +Concatenation along axis 0: +[[1 2 3] + [4 5 6] + [7 8 9]] """ + +# Concatenate along axis 1 +result_1 = np.concatenate((arr1, arr2[:, np.newaxis]), axis=1) +print("\nConcatenation along axis 1:") +print(result_1) +""" output- +Concatenation along axis 1: +[[1 2 3 7] + [4 5 6 8]] """ +``` + + From 81992560369b3c2e8a6e940ab14c35797623abcb Mon Sep 17 00:00:00 2001 From: Manmita Das <34617961+manmita@users.noreply.github.com> Date: Tue, 28 May 2024 16:16:08 +0530 Subject: [PATCH 13/44] Update index.md --- contrib/numpy/index.md | 1 + 1 file changed, 1 insertion(+) diff --git a/contrib/numpy/index.md b/contrib/numpy/index.md index b2d459a..fb07865 100644 --- a/contrib/numpy/index.md +++ b/contrib/numpy/index.md @@ -8,3 +8,4 @@ - [Loading Arrays from Files](loading_arrays_from_files.md) - [Saving Numpy Arrays into FIles](saving_numpy_arrays_to_files.md) - [Sorting NumPy Arrays](sorting-array.md) +- [Concatenation of Arrays](concatenation-of-arrays.md) From 13829732888a012ee5b198564e211ddd6375f34d Mon Sep 17 00:00:00 2001 From: Lingamuneni Santhosh Siddhardha <103999924+Santhosh-Siddhardha@users.noreply.github.com> Date: Tue, 28 May 2024 21:01:23 +0530 Subject: [PATCH 14/44] Create numpy_array_iteration.md Added Introduction Added Basic Iteration Added nditer Added ndenumerate Added flat Added Conclusion --- contrib/pandas/numpy_array_iteration.md | 109 ++++++++++++++++++++++++ 1 file changed, 109 insertions(+) create mode 100644 contrib/pandas/numpy_array_iteration.md diff --git a/contrib/pandas/numpy_array_iteration.md b/contrib/pandas/numpy_array_iteration.md new file mode 100644 index 0000000..ac35d95 --- /dev/null +++ b/contrib/pandas/numpy_array_iteration.md @@ -0,0 +1,109 @@ +# NumPy Array Iteration + +Iterating over arrays in NumPy is a common task when processing data. NumPy provides several ways to iterate over elements of an array efficiently. +Understanding these methods is crucial for performing operations on array elements effectively. + +## 1. Basic Iteration + +- Iterating using basic `for` loop. + +**Single-dimensional array iteration**: + +Iterating over a single-dimensional array is straightforward using a basic `for` loop + +```python +import numpy as np + +arr = np.array([1, 2, 3, 4, 5]) +for i in arr: + print(i) +``` +**Output** : +```python +[ 1 2 3 4 5 ] +``` +**Multi-dimensional array**: + +Iterating over multi-dimensional arrays, each iteration returns a sub-array along the first axis. + +```python +marr = np.array([[1, 2, 3], [4, 5, 6], [7, 8, 9]]) + +for arr in marr: + print(arr) +``` +**Output** : +```python +[1 2 3] +[4 5 6] +[7 8 9] +``` + +## 2. Iterating with nditer + +- `nditer` is a powerful iterator provided by NumPy for iterating over multi-dimensional arrays. +- In each interation it gives each element. + +```python +import numpy as np + +arr = np.array([[1, 2, 3], [4, 5, 6]]) +for i in np.nditer(arr): + print(i) +``` +**Output** : +```python +1 +2 +3 +4 +5 +6 +``` + +## 3. Iterating with ndenumerate + +- `ndenumerate` allows you to iterate with both the index and the value of each element. +- It gives index and value as output in each iteration + +```python +import numpy as np + +arr = np.array([[1, 2], [3, 4]]) +for index,value in np.ndenumerate(arr): + print(index,value) +``` + +**Output** : + +```python +(0, 0) 1 +(0, 1) 2 +(1, 0) 3 +(1, 1) 4 +``` + +## 4. Iterating with flat + +- The `flat` attribute returns a 1-D iterator over the array. +- + +```python +import numpy as np + +arr = np.array([[1, 2], [3, 4]]) +for element in arr.flat: + print(element) +``` + +**Output** : + +```python +1 +2 +3 +4 +``` + +Understanding the various ways to iterate over NumPy arrays can significantly enhance your data processing efficiency. +Whether you are working with single-dimensional or multi-dimensional arrays, NumPy provides versatile tools to iterate and manipulate array elements effectively. From 6c5f9d9fd7acc118339a00b7c33045028f2e895b Mon Sep 17 00:00:00 2001 From: Lingamuneni Santhosh Siddhardha <103999924+Santhosh-Siddhardha@users.noreply.github.com> Date: Tue, 28 May 2024 21:03:35 +0530 Subject: [PATCH 15/44] Update index.md Added Numpy Array Iteration --- contrib/pandas/index.md | 1 + 1 file changed, 1 insertion(+) diff --git a/contrib/pandas/index.md b/contrib/pandas/index.md index c71c324..0af05c7 100644 --- a/contrib/pandas/index.md +++ b/contrib/pandas/index.md @@ -7,3 +7,4 @@ - [Excel using Pandas DataFrame](excel_with_pandas.md) - [Importing and Exporting Data in Pandas](import-export.md) - [Handling Missing Values in Pandas](handling-missing-values.md) +- [NumPy Array Iteration](numpy-array-iteration.md) From b31bfc61498761a219a3be2896633e3d6624ad67 Mon Sep 17 00:00:00 2001 From: Lingamuneni Santhosh Siddhardha <103999924+Santhosh-Siddhardha@users.noreply.github.com> Date: Tue, 28 May 2024 21:04:45 +0530 Subject: [PATCH 16/44] Update index.md --- contrib/pandas/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/contrib/pandas/index.md b/contrib/pandas/index.md index 0af05c7..9bf59a3 100644 --- a/contrib/pandas/index.md +++ b/contrib/pandas/index.md @@ -7,4 +7,4 @@ - [Excel using Pandas DataFrame](excel_with_pandas.md) - [Importing and Exporting Data in Pandas](import-export.md) - [Handling Missing Values in Pandas](handling-missing-values.md) -- [NumPy Array Iteration](numpy-array-iteration.md) +- [NumPy Array Iteration](numpy_array_iteration.md) From 5280fb09a8b8cb7118b1cddee2f045eeea9cc4ee Mon Sep 17 00:00:00 2001 From: Lingamuneni Santhosh Siddhardha <103999924+Santhosh-Siddhardha@users.noreply.github.com> Date: Tue, 28 May 2024 21:28:52 +0530 Subject: [PATCH 17/44] Create numpy_array_iteration.md Added Introduction Added Methods Added examples Added Conclusion --- contrib/numpy/numpy_array_iteration.md | 109 +++++++++++++++++++++++++ 1 file changed, 109 insertions(+) create mode 100644 contrib/numpy/numpy_array_iteration.md diff --git a/contrib/numpy/numpy_array_iteration.md b/contrib/numpy/numpy_array_iteration.md new file mode 100644 index 0000000..ac35d95 --- /dev/null +++ b/contrib/numpy/numpy_array_iteration.md @@ -0,0 +1,109 @@ +# NumPy Array Iteration + +Iterating over arrays in NumPy is a common task when processing data. NumPy provides several ways to iterate over elements of an array efficiently. +Understanding these methods is crucial for performing operations on array elements effectively. + +## 1. Basic Iteration + +- Iterating using basic `for` loop. + +**Single-dimensional array iteration**: + +Iterating over a single-dimensional array is straightforward using a basic `for` loop + +```python +import numpy as np + +arr = np.array([1, 2, 3, 4, 5]) +for i in arr: + print(i) +``` +**Output** : +```python +[ 1 2 3 4 5 ] +``` +**Multi-dimensional array**: + +Iterating over multi-dimensional arrays, each iteration returns a sub-array along the first axis. + +```python +marr = np.array([[1, 2, 3], [4, 5, 6], [7, 8, 9]]) + +for arr in marr: + print(arr) +``` +**Output** : +```python +[1 2 3] +[4 5 6] +[7 8 9] +``` + +## 2. Iterating with nditer + +- `nditer` is a powerful iterator provided by NumPy for iterating over multi-dimensional arrays. +- In each interation it gives each element. + +```python +import numpy as np + +arr = np.array([[1, 2, 3], [4, 5, 6]]) +for i in np.nditer(arr): + print(i) +``` +**Output** : +```python +1 +2 +3 +4 +5 +6 +``` + +## 3. Iterating with ndenumerate + +- `ndenumerate` allows you to iterate with both the index and the value of each element. +- It gives index and value as output in each iteration + +```python +import numpy as np + +arr = np.array([[1, 2], [3, 4]]) +for index,value in np.ndenumerate(arr): + print(index,value) +``` + +**Output** : + +```python +(0, 0) 1 +(0, 1) 2 +(1, 0) 3 +(1, 1) 4 +``` + +## 4. Iterating with flat + +- The `flat` attribute returns a 1-D iterator over the array. +- + +```python +import numpy as np + +arr = np.array([[1, 2], [3, 4]]) +for element in arr.flat: + print(element) +``` + +**Output** : + +```python +1 +2 +3 +4 +``` + +Understanding the various ways to iterate over NumPy arrays can significantly enhance your data processing efficiency. +Whether you are working with single-dimensional or multi-dimensional arrays, NumPy provides versatile tools to iterate and manipulate array elements effectively. From 7ef8cb226d414c75cb62167aa20d7fa4b78eb051 Mon Sep 17 00:00:00 2001 From: Lingamuneni Santhosh Siddhardha <103999924+Santhosh-Siddhardha@users.noreply.github.com> Date: Tue, 28 May 2024 21:29:29 +0530 Subject: [PATCH 18/44] Delete contrib/pandas/numpy_array_iteration.md Wrong folder --- contrib/pandas/numpy_array_iteration.md | 109 ------------------------ 1 file changed, 109 deletions(-) delete mode 100644 contrib/pandas/numpy_array_iteration.md diff --git a/contrib/pandas/numpy_array_iteration.md b/contrib/pandas/numpy_array_iteration.md deleted file mode 100644 index ac35d95..0000000 --- a/contrib/pandas/numpy_array_iteration.md +++ /dev/null @@ -1,109 +0,0 @@ -# NumPy Array Iteration - -Iterating over arrays in NumPy is a common task when processing data. NumPy provides several ways to iterate over elements of an array efficiently. -Understanding these methods is crucial for performing operations on array elements effectively. - -## 1. Basic Iteration - -- Iterating using basic `for` loop. - -**Single-dimensional array iteration**: - -Iterating over a single-dimensional array is straightforward using a basic `for` loop - -```python -import numpy as np - -arr = np.array([1, 2, 3, 4, 5]) -for i in arr: - print(i) -``` -**Output** : -```python -[ 1 2 3 4 5 ] -``` -**Multi-dimensional array**: - -Iterating over multi-dimensional arrays, each iteration returns a sub-array along the first axis. - -```python -marr = np.array([[1, 2, 3], [4, 5, 6], [7, 8, 9]]) - -for arr in marr: - print(arr) -``` -**Output** : -```python -[1 2 3] -[4 5 6] -[7 8 9] -``` - -## 2. Iterating with nditer - -- `nditer` is a powerful iterator provided by NumPy for iterating over multi-dimensional arrays. -- In each interation it gives each element. - -```python -import numpy as np - -arr = np.array([[1, 2, 3], [4, 5, 6]]) -for i in np.nditer(arr): - print(i) -``` -**Output** : -```python -1 -2 -3 -4 -5 -6 -``` - -## 3. Iterating with ndenumerate - -- `ndenumerate` allows you to iterate with both the index and the value of each element. -- It gives index and value as output in each iteration - -```python -import numpy as np - -arr = np.array([[1, 2], [3, 4]]) -for index,value in np.ndenumerate(arr): - print(index,value) -``` - -**Output** : - -```python -(0, 0) 1 -(0, 1) 2 -(1, 0) 3 -(1, 1) 4 -``` - -## 4. Iterating with flat - -- The `flat` attribute returns a 1-D iterator over the array. -- - -```python -import numpy as np - -arr = np.array([[1, 2], [3, 4]]) -for element in arr.flat: - print(element) -``` - -**Output** : - -```python -1 -2 -3 -4 -``` - -Understanding the various ways to iterate over NumPy arrays can significantly enhance your data processing efficiency. -Whether you are working with single-dimensional or multi-dimensional arrays, NumPy provides versatile tools to iterate and manipulate array elements effectively. From 866d28dfdd63539e570e5eead81afc2f1c7e9b06 Mon Sep 17 00:00:00 2001 From: Lingamuneni Santhosh Siddhardha <103999924+Santhosh-Siddhardha@users.noreply.github.com> Date: Tue, 28 May 2024 21:30:02 +0530 Subject: [PATCH 19/44] Update index.md Removed unwanted section --- contrib/pandas/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/contrib/pandas/index.md b/contrib/pandas/index.md index 9bf59a3..2b3149a 100644 --- a/contrib/pandas/index.md +++ b/contrib/pandas/index.md @@ -7,4 +7,4 @@ - [Excel using Pandas DataFrame](excel_with_pandas.md) - [Importing and Exporting Data in Pandas](import-export.md) - [Handling Missing Values in Pandas](handling-missing-values.md) -- [NumPy Array Iteration](numpy_array_iteration.md) + From 8a2b838e7bd47122c18cb4877399ebc98e559482 Mon Sep 17 00:00:00 2001 From: Lingamuneni Santhosh Siddhardha <103999924+Santhosh-Siddhardha@users.noreply.github.com> Date: Tue, 28 May 2024 21:30:37 +0530 Subject: [PATCH 20/44] Update index.md Added numpy array iteration section --- contrib/numpy/index.md | 1 + 1 file changed, 1 insertion(+) diff --git a/contrib/numpy/index.md b/contrib/numpy/index.md index b2d459a..5e88e1d 100644 --- a/contrib/numpy/index.md +++ b/contrib/numpy/index.md @@ -8,3 +8,4 @@ - [Loading Arrays from Files](loading_arrays_from_files.md) - [Saving Numpy Arrays into FIles](saving_numpy_arrays_to_files.md) - [Sorting NumPy Arrays](sorting-array.md) +- [NumPy Array Iteration](numpy_array_iteration.md) From 1f4f3abd20eac2ad0c04e8372c2254a12b2e55d6 Mon Sep 17 00:00:00 2001 From: Lingamuneni Santhosh Siddhardha <103999924+Santhosh-Siddhardha@users.noreply.github.com> Date: Tue, 28 May 2024 21:34:59 +0530 Subject: [PATCH 21/44] Update index.md --- contrib/pandas/index.md | 1 - 1 file changed, 1 deletion(-) diff --git a/contrib/pandas/index.md b/contrib/pandas/index.md index 2b3149a..c71c324 100644 --- a/contrib/pandas/index.md +++ b/contrib/pandas/index.md @@ -7,4 +7,3 @@ - [Excel using Pandas DataFrame](excel_with_pandas.md) - [Importing and Exporting Data in Pandas](import-export.md) - [Handling Missing Values in Pandas](handling-missing-values.md) - From 58cfc5b9021b44c461e14ab309e29e4a28a6be8d Mon Sep 17 00:00:00 2001 From: Ritesh Date: Wed, 29 May 2024 10:34:20 +0530 Subject: [PATCH 22/44] Create Logistic_Regression.md --- .../machine-learning/Logistic_Regression.md | 121 ++++++++++++++++++ 1 file changed, 121 insertions(+) create mode 100644 contrib/machine-learning/Logistic_Regression.md diff --git a/contrib/machine-learning/Logistic_Regression.md b/contrib/machine-learning/Logistic_Regression.md new file mode 100644 index 0000000..3111550 --- /dev/null +++ b/contrib/machine-learning/Logistic_Regression.md @@ -0,0 +1,121 @@ +# Logistic Regression + +Logistic Regression is a statistical method used for binary classification problems. It is a type of regression analysis where the dependent variable is categorical. This README provides an overview of logistic regression, including its fundamental concepts, assumptions, and how to implement it using Python. + +## Table of Contents + +1. [Introduction](#introduction) +2. [Concepts](#concepts) +3. [Assumptions](#assumptions) +4. [Implementation](#implementation) + - [Using Scikit-learn](#using-scikit-learn) + - [Code Example](#code-example) +5. [Evaluation Metrics](#evaluation-metrics) +6. [Conclusion](#conclusion) +7. [References](#references) + +## Introduction + +Logistic Regression is used to model the probability of a binary outcome based on one or more predictor variables (features). It is widely used in various fields such as medical research, social sciences, and machine learning for tasks such as spam detection, fraud detection, and predicting user behavior. + +## Concepts + +### Sigmoid Function + +The logistic regression model uses the sigmoid function to map predicted values to probabilities. The sigmoid function is defined as: + +$$ +\sigma(z) = \frac{1}{1 + e^{-z}} +$$ + +Where \( z \) is a linear combination of the input features. + +### Odds and Log-Odds + +- **Odds**: The odds represent the ratio of the probability of an event occurring to the probability of it not occurring. + +$$\text{Odds} = \frac{P(Y=1)}{P(Y=0)}$$ + +- **Log-Odds**: The log-odds is the natural logarithm of the odds. + + $$\text{Log-Odds} = \log \left( \frac{P(Y=1)}{P(Y=0)} \right)$$ + +Logistic regression models the log-odds as a linear combination of the input features. + +### Model Equation + +The logistic regression model equation is: + +$$ +\log \left( \frac{P(Y=1)}{P(Y=0)} \right) = \beta_0 + \beta_1 X_1 + \beta_2 X_2 + \cdots + \beta_n X_n +$$ + +Where: +- β₀ is the intercept. +- βi are the coefficients for the predictor variables Xi. + + +## Assumptions + +1. **Linearity**: The log-odds of the response variable are a linear combination of the predictor variables. +2. **Independence**: Observations should be independent of each other. +3. **No Multicollinearity**: Predictor variables should not be highly correlated with each other. +4. **Large Sample Size**: Logistic regression requires a large sample size to provide reliable results. + +## Implementation + +### Using Scikit-learn + +Scikit-learn is a popular machine learning library in Python that provides tools for logistic regression. + +### Code Example + +```python +import numpy as np +import pandas as pd +from sklearn.model_selection import train_test_split +from sklearn.linear_model import LogisticRegression +from sklearn.metrics import accuracy_score, confusion_matrix, classification_report + +# Load dataset +data = pd.read_csv('path/to/your/dataset.csv') + +# Define features and target variable +X = data[['feature1', 'feature2', 'feature3']] +y = data['target'] + +# Split data into training and testing sets +X_train, X_test, y_train, y_test = train_test_split(X, y, test_size=0.3, random_state=42) + +# Initialize and train logistic regression model +model = LogisticRegression() +model.fit(X_train, y_train) + +# Make predictions +y_pred = model.predict(X_test) + +# Evaluate the model +accuracy = accuracy_score(y_test, y_pred) +conf_matrix = confusion_matrix(y_test, y_pred) +class_report = classification_report(y_test, y_pred) + +print("Accuracy:", accuracy) +print("Confusion Matrix:\n", conf_matrix) +print("Classification Report:\n", class_report) +``` + +## Evaluation Metrics + +- **Accuracy**: The proportion of correctly classified instances among all instances. +- **Confusion Matrix**: A table showing the number of true positives, true negatives, false positives, and false negatives. +- **Precision, Recall, and F1-Score**: Metrics to evaluate the performance of the classification model. + +## Conclusion + +Logistic regression is a fundamental classification technique that is easy to implement and interpret. It is a powerful tool for binary classification problems and provides a probabilistic framework for predicting binary outcomes. + +## References + +- [Scikit-learn Documentation](https://scikit-learn.org/stable/modules/linear_model.html#logistic-regression) +- [Wikipedia: Logistic Regression](https://en.wikipedia.org/wiki/Logistic_regression) +- [Towards Data Science: Understanding Logistic Regression](https://towardsdatascience.com/understanding-logistic-regression-9b02c2aec102) From a8c83302b7c7d063d98951799595c7c7b78050f5 Mon Sep 17 00:00:00 2001 From: Ritesh Date: Wed, 29 May 2024 10:35:42 +0530 Subject: [PATCH 23/44] Update index.md --- contrib/machine-learning/index.md | 1 + 1 file changed, 1 insertion(+) diff --git a/contrib/machine-learning/index.md b/contrib/machine-learning/index.md index 94ca1e2..0b9c2b0 100644 --- a/contrib/machine-learning/index.md +++ b/contrib/machine-learning/index.md @@ -9,3 +9,4 @@ - [TensorFlow.md](tensorFlow.md) - [PyTorch.md](pytorch.md) - [Types of optimizers](Types_of_optimizers.md) +- [Logistic Regression](Logistic_Regression.md) From 9f0f50fe4803009d1d4968a0e2f4722b061751a2 Mon Sep 17 00:00:00 2001 From: Rupa-Rd Date: Thu, 30 May 2024 19:27:15 +0530 Subject: [PATCH 24/44] Added index --- contrib/numpy/index.md | 1 + 1 file changed, 1 insertion(+) diff --git a/contrib/numpy/index.md b/contrib/numpy/index.md index b2d459a..df759d9 100644 --- a/contrib/numpy/index.md +++ b/contrib/numpy/index.md @@ -3,6 +3,7 @@ - [Installing NumPy](installing-numpy.md) - [Introduction](introduction.md) - [NumPy Data Types](datatypes.md) +- [Numpy Array Shape and Reshape](array_reshape.md) - [Basic Mathematics](basic_math.md) - [Operations on Arrays in NumPy](operations-on-arrays.md) - [Loading Arrays from Files](loading_arrays_from_files.md) From ed9e0652008dc706d96fbbc0833d7458bcc2e386 Mon Sep 17 00:00:00 2001 From: Rupa-Rd Date: Thu, 30 May 2024 19:55:02 +0530 Subject: [PATCH 25/44] Numpy array reshape() is added --- contrib/numpy/array_reshape.md | 54 ++++++++++++++++++++++++++++++++++ 1 file changed, 54 insertions(+) create mode 100644 contrib/numpy/array_reshape.md diff --git a/contrib/numpy/array_reshape.md b/contrib/numpy/array_reshape.md new file mode 100644 index 0000000..d3d7f59 --- /dev/null +++ b/contrib/numpy/array_reshape.md @@ -0,0 +1,54 @@ +# Numpy Array Shape and Reshape +In NumPy, the primary data structure is the ndarray (N-dimensional array). An array can have one or more dimensions, and it organizes your data efficiently. + +Code to create a 2D array +``` python +import numpy as np + +numbers = np.array([[1, 2, 3, 4], [5, 6, 7, 8]]) +print(numbers) + +# Output: +# array([[1, 2, 3, 4],[5, 6, 7, 8]]) +``` + +## Changing Array Shape using Reshape() +The `reshape()` function allows you to rearrange the data within a NumPy array. +It take 2 arguements, row and columns. The `reshape()` can add or remove the dimensions. For instance, array can convert a 1D array into a 2D array or vice versa. + +``` python +arr_1d = np.array([1, 2, 3, 4, 5, 6]) # 1D array +arr_2d = arr_1d.reshape(2, 3) # Reshaping with 2rows and 3cols + +print(arr_2d) + +# Output: +# array([[1, 2, 3],[4, 5, 6]]) + +``` + +## Changing Array Shape using Resize() +The `resize()` function allows you to modify the shape of a NumPy array directly. +It take 2 arguements, row and columns. + +``` python +import numpy as np +arr_1d = np.array([1, 2, 3, 4, 5, 6]) + +arr_1d.resize((2, 3)) # 2rows and 3cols +print(arr_1d) + +# Output: +# array([[1, 2, 3],[4, 5, 6]]) + +``` + +## Reshape() VS Resize() + +| Reshape | Resize | +| ----------- | ----------- | +| Does not modify the original array | Modifies the original array in-place | +| Creates a new array | Changes the shape of the array | +| Returns a reshaped array | Doesn't return anything | +| Compatibility between dimensions | Does not compatibility between dimensions | +| Syntax: reshape(row,col) | Syntax: resize((row,col)) | From d02ee273f12f74b392c0748117f51265d63adae6 Mon Sep 17 00:00:00 2001 From: Ankit Mahato Date: Fri, 31 May 2024 04:50:16 +0530 Subject: [PATCH 26/44] Update index.md --- contrib/pandas/index.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/contrib/pandas/index.md b/contrib/pandas/index.md index 58b21a5..051f3b0 100644 --- a/contrib/pandas/index.md +++ b/contrib/pandas/index.md @@ -5,6 +5,7 @@ - [Pandas Descriptive Statistics](Descriptive_Statistics.md) - [Group By Functions with Pandas](GroupBy_Functions_Pandas.md) - [Excel using Pandas DataFrame](excel_with_pandas.md) -- [Working with datetime using Pandas](datetime_with_pandas.md) +- [Working with datetime in Pandas](datetime.md) - [Importing and Exporting Data in Pandas](import-export.md) -- [Handling Missing Values in Pandas](handling-missing-values.md) \ No newline at end of file +- [Handling Missing Values in Pandas](handling-missing-values.md) + From eba755cb6370a9642efdc6298d8a3d46eb3564a6 Mon Sep 17 00:00:00 2001 From: Ankit Mahato Date: Fri, 31 May 2024 05:06:11 +0530 Subject: [PATCH 27/44] Update and rename datetime_with_pandas.md to datetime.md --- .../{datetime_with_pandas.md => datetime.md} | 46 ++++++++----------- 1 file changed, 19 insertions(+), 27 deletions(-) rename contrib/pandas/{datetime_with_pandas.md => datetime.md} (58%) diff --git a/contrib/pandas/datetime_with_pandas.md b/contrib/pandas/datetime.md similarity index 58% rename from contrib/pandas/datetime_with_pandas.md rename to contrib/pandas/datetime.md index d87d9ec..008d6fc 100644 --- a/contrib/pandas/datetime_with_pandas.md +++ b/contrib/pandas/datetime.md @@ -1,10 +1,6 @@ -# Pandas DateTime +# Working with Date & Time in Pandas -Pandas is a robust Python library that is available as free source. The Pandas library is used to manipulate and analyse data. Pandas are made up of data structures and functions that allow for efficient data processing. - -While working with data, it is common to come across time series data. Pandas is a very handy tool for dealing with time series data. Pandas is a strong Python data analysis toolkit that provides a wide range of date and time data processing options. Many data science jobs require working with time series data, time zones, and date arithmetic, and pandas simplifies these processes. - -Features of Pandas `Date_Time`: +While working with data, it is common to come across data containing date and time. Pandas is a very handy tool for dealing with such data and provides a wide range of date and time data processing options. - **Parsing dates and times**: Pandas provides a number of functions for parsing dates and times from strings, including `to_datetime()` and `parse_dates()`. These functions can handle a variety of date and time formats, Unix timestamps, and human-readable formats. @@ -12,13 +8,9 @@ Features of Pandas `Date_Time`: - **Visualizing dates and times**: Pandas provides a number of functions for visualizing dates and times, including `plot()`, `hist()`, and `bar()`. These functions can be used to create line charts, histograms, and bar charts of date and time data. +### `Timestamp` function - -### Installation of libraries - -`pip install pandas` - -- **Note**: There is no need to install a seperate library for date_time operations, pandas module itself has built-in functions. +The timestamp function in Pandas is used to convert a datetime object to a Unix timestamp. A Unix timestamp is a numerical representation of datetime. Example for retrieving day, month and year from given date: @@ -35,15 +27,13 @@ print('Day is: ', d) ``` Output: + ```python Year is: 2024 Month is: 5 Day is: 5 ``` -- **Note**: The timestamp function in Pandas is used to convert a datetime object to a Unix timestamp. A Unix timestamp is a numerical representation of datetime. - - Example for extracting time related data from given date: ```python @@ -57,6 +47,7 @@ print('Quarter is: ', ts.quarter) ``` Output: + ```python Hour is: 12 Minute is: 0 @@ -64,6 +55,8 @@ Weekday is: 1 Quarter is: 4 ``` +### `Timestamp.now()` + Example for getting current date and time: ```python @@ -78,6 +71,8 @@ Output: Current date and time is: 2024-05-25 11:48:25.593213 ``` +### `date_range` function + Example for generating dates' for next five days: ```python @@ -89,6 +84,7 @@ for i in ts: ``` Output: + ```python 2024-05-25 2024-05-26 @@ -116,11 +112,11 @@ Output: 2024-05-25 ``` -### Pandas `DateTime` is Efficient than Built-in `DateTime` library in various aspects like: +### Built-in vs pandas date & time operations -- **In pandas, you may add a time delta to a full column of dates in a single action, but Python's datetime requires a loop.** +In `pandas`, you may add a time delta to a full column of dates in a single action, but Python's datetime requires a loop. -Example using Pandas DateTime: +Example in Pandas: ```python import pandas as pd @@ -146,7 +142,7 @@ Output: 99999 2023-03-12 10:39:00 ``` -Example using Built-In datetime library: +Example using Built-in datetime library: ```python from datetime import datetime, timedelta @@ -155,12 +151,8 @@ dates = [datetime(2023, 1, 1) + timedelta(minutes=i) for i in range(100000)] dates = [date + timedelta(days=1) for date in dates] ``` -Output: -```The output is very large to display and taking more time to display``` +Why use pandas functions? - -- **Pandas employs NumPy's datetime64 dtype, which takes up a set amount of bytes (usually 8 bytes per date), to store datetime data more compactly and efficiently.** -- **Each datetime object in Python takes up extra memory since it contains not only the date and time but also the additional metadata and overhead associated with Python objects.** - -- **Pandas Offers a wide range of convenient functions and methods for date manipulation, extraction, and conversion, such as `pd.to_datetime()`, `date_range()`, `timedelta_range()`, and more.** -- **datetime library requires manual implementation for many of these operations, leading to longer and less efficient code.** +- Pandas employs NumPy's datetime64 dtype, which takes up a set amount of bytes (usually 8 bytes per date), to store datetime data more compactly and efficiently. +- Each datetime object in Python takes up extra memory since it contains not only the date and time but also the additional metadata and overhead associated with Python objects. +- Pandas Offers a wide range of convenient functions and methods for date manipulation, extraction, and conversion, such as `pd.to_datetime()`, `date_range()`, `timedelta_range()`, and more. datetime library requires manual implementation for many of these operations, leading to longer and less efficient code. From 90aa15145b2289d9c203bbddf79de917cd7daa8d Mon Sep 17 00:00:00 2001 From: Ankit Mahato Date: Fri, 31 May 2024 05:07:26 +0530 Subject: [PATCH 28/44] Update index.md --- contrib/pandas/index.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/contrib/pandas/index.md b/contrib/pandas/index.md index 051f3b0..c17d839 100644 --- a/contrib/pandas/index.md +++ b/contrib/pandas/index.md @@ -5,7 +5,6 @@ - [Pandas Descriptive Statistics](Descriptive_Statistics.md) - [Group By Functions with Pandas](GroupBy_Functions_Pandas.md) - [Excel using Pandas DataFrame](excel_with_pandas.md) -- [Working with datetime in Pandas](datetime.md) +- [Working with Date & Time in Pandas](datetime.md) - [Importing and Exporting Data in Pandas](import-export.md) - [Handling Missing Values in Pandas](handling-missing-values.md) - From 976eb8cffd558f544efd27d2be4e30303a236191 Mon Sep 17 00:00:00 2001 From: Ankit Mahato Date: Fri, 31 May 2024 05:10:48 +0530 Subject: [PATCH 29/44] Update index.md --- contrib/ds-algorithms/index.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/contrib/ds-algorithms/index.md b/contrib/ds-algorithms/index.md index 3645f82..31cff39 100644 --- a/contrib/ds-algorithms/index.md +++ b/contrib/ds-algorithms/index.md @@ -1,7 +1,6 @@ # List of sections -- [Section title](filename.md) -- [Time Space Complexity](time-space-complexity.md) +- [Time & Space Complexity](time-space-complexity.md) - [Queues in Python](Queues.md) - [Graphs](graph.md) - [Sorting Algorithms](sorting-algorithms.md) From db796bfc2b1a30f5167e5f5b4e4cbe73db7ed0ca Mon Sep 17 00:00:00 2001 From: Ankit Mahato Date: Fri, 31 May 2024 05:19:31 +0530 Subject: [PATCH 30/44] Update time-space-complexity.md --- .../ds-algorithms/time-space-complexity.md | 86 +++++++++++-------- 1 file changed, 51 insertions(+), 35 deletions(-) diff --git a/contrib/ds-algorithms/time-space-complexity.md b/contrib/ds-algorithms/time-space-complexity.md index 79a072f..eeadd64 100644 --- a/contrib/ds-algorithms/time-space-complexity.md +++ b/contrib/ds-algorithms/time-space-complexity.md @@ -1,7 +1,10 @@ # Time and Space Complexity We can solve a problem using one or more algorithms. It's essential to learn how to compare the performance of different algorithms and select the best one for a specific task. -Therefore, it is highly required to use a method to compare the solutions in order to judge which one is more optimal.
The method must be: + +Therefore, it is highly required to use a method to compare the solutions in order to judge which one is more optimal. + +The method must be: - Regardless of the system or its settings on which the algorithm is executing. - Demonstrate a direct relationship with the quantity of inputs. @@ -35,9 +38,7 @@ $$ Graphical representation of Big Oh: -![BigOh Notation Graph](./images/Time-And-Space-Complexity-BigOh.png) - -Image Credit: www.programiz.com +![BigOh Notation Graph](images/Time-And-Space-Complexity-BigOh.png) ### 2. Big Omega (Ω) Notation @@ -51,9 +52,7 @@ $$ Graphical representation of Big Omega: -![BigOmega Notation Graph](./images/Time-And-Space-Complexity-BigOmega.png) - -Image Credit: www.programiz.com +![BigOmega Notation Graph](images/Time-And-Space-Complexity-BigOmega.png) ### 3. Big Theta (Θ) Notation @@ -67,61 +66,64 @@ $$ Graphical representation of Big Theta: -![Big Theta Notation Graph](./images/Time-And-Space-Complexity-BigTheta.png) - - -Image Credit: www.programiz.com - +![Big Theta Notation Graph](images/Time-And-Space-Complexity-BigTheta.png) ## Best Case, Worst Case and Average Case + ### 1. Best-Case Scenario: + The best-case scenario refers to the situation where an algorithm performs optimally, achieving the lowest possible time or space complexity. It represents the most favorable conditions under which an algorithm operates. #### Characteristics: -- Represents the minimum time or space required by an algorithm to solve a problem. + +- Represents the minimum time or space required by an algorithm to solve a problem. - Occurs when the input data is structured in such a way that the algorithm can exploit its strengths fully. - Often used to analyze the lower bound of an algorithm's performance. #### Example: -Consider the `linear search algorithm` where we're searching for a `target element` in an array. The best-case scenario occurs when the target element is found `at the very beginning of the array`. In this case, the algorithm would only need to make one comparison, resulting in a time complexity of O(1). +Consider the `linear search algorithm` where we're searching for a `target element` in an array. The best-case scenario occurs when the target element is found `at the very beginning of the array`. In this case, the algorithm would only need to make one comparison, resulting in a time complexity of `O(1)`. ### 2. Worst-Case Scenario: + The worst-case scenario refers to the situation where an algorithm performs at its poorest, achieving the highest possible time or space complexity. It represents the most unfavorable conditions under which an algorithm operates. #### Characteristics: + - Represents the maximum time or space required by an algorithm to solve a problem. - Occurs when the input data is structured in such a way that the algorithm encounters the most challenging conditions. - Often used to analyze the upper bound of an algorithm's performance. #### Example: -Continuing with the `linear search algorithm`, the worst-case scenario occurs when the `target element` is either not present in the array or located `at the very end`. In this case, the algorithm would need to iterate through the entire array, resulting in a time complexity of O(n), where n is the size of the array. +Continuing with the `linear search algorithm`, the worst-case scenario occurs when the `target element` is either not present in the array or located `at the very end`. In this case, the algorithm would need to iterate through the entire array, resulting in a time complexity of `O(n)`, where `n` is the size of the array. ### 3. Average-Case Scenario: + The average-case scenario refers to the expected performance of an algorithm over all possible inputs, typically calculated as the arithmetic mean of the time or space complexity. #### Characteristics: + - Represents the typical performance of an algorithm across a range of input data. - Takes into account the distribution of inputs and their likelihood of occurrence. - Provides a more realistic measure of an algorithm's performance compared to the best-case or worst-case scenarios. #### Example: -- For the `linear search algorithm`, the average-case scenario considers the probability distribution of the target element's position within the array. If the `target element is equally likely to be found at any position in the array`, the average-case time complexity would be O(n/2), as the algorithm would, on average, need to search halfway through the array. +For the `linear search algorithm`, the average-case scenario considers the probability distribution of the target element's position within the array. If the `target element is equally likely to be found at any position in the array`, the average-case time complexity would be `O(n/2)`, as the algorithm would, on average, need to search halfway through the array. ## Space Complexity + The memory space that a code utilizes as it is being run is often referred to as space complexity. Additionally, space complexity depends on the machine, therefore rather than using the typical memory units like MB, GB, etc., we will express space complexity using the Big O notation. #### Examples of Space Complexity + 1. `Constant Space Complexity (O(1))`: Algorithms that operate on a fixed-size array or use a constant number of variables have O(1) space complexity. - 2. `Linear Space Complexity (O(n))`: Algorithms that store each element of the input array in a separate variable or data structure have O(n) space complexity. - 3. `Quadratic Space Complexity (O(n^2))`: Algorithms that create a two-dimensional array or matrix with dimensions based on the input size have O(n^2) space complexity. - #### Analyzing Space Complexity + To analyze space complexity: - Identify the variables, data structures, and recursive calls used by the algorithm. @@ -130,18 +132,23 @@ To analyze space complexity: ## Examples to calculate time and space complexity -#### 1. Print all elements of given array : +#### 1. Print all elements of given array + Consider each line takes one unit of time to run. So, to simply iterate over an array to print all elements it will take `O(n)` time, where n is the size of array. + Code: + ```python arr = [1,2,3,4] #1 for x in arr: #2 print(x) #3 ``` -Here, the 1st statement executes only once. So, it takes one unit of time to run. The for loop consisting of 2nd and 3rd statements executes 4 times. + +Here, the 1st statement executes only once. So, it takes one unit of time to run. The for loop consisting of 2nd and 3rd statements executes 4 times. Also, as the code dosen't take any additional space except the input arr its Space Complexity is O(1) constant. #### 2. Linear Search + Linear search is a simple algorithm for finding an element in an array by sequentially checking each element until a match is found or the end of the array is reached. Here's an example of calculating the time and space complexity of linear search: ```python @@ -156,17 +163,20 @@ arr = [1, 3, 5, 7, 9] target = 5 print(linear_search(arr, target)) ``` -`Time Complexity Analysis:` -The for loop iterates through the entire array, which takes O(n) time in the worst case, where n is the size of the array. -Inside the loop, each operation takes constant time (O(1)). + +**Time Complexity Analysis** + +The for loop iterates through the entire array, which takes O(n) time in the worst case, where n is the size of the array. +Inside the loop, each operation takes constant time (O(1)). Therefore, the time complexity of linear search is `O(n)`. +**Space Complexity Analysis** -`Space Complexity Analysis:` The space complexity of linear search is `O(1)` since it only uses a constant amount of additional space for variables regardless of the input size. #### 3. Binary Search + Binary search is an efficient algorithm for finding an element in a sorted array by repeatedly dividing the search interval in half. Here's an example of calculating the time and space complexity of binary search: ```python @@ -190,18 +200,21 @@ def binary_search(arr, target): arr = [1, 3, 5, 7, 9] target = 5 print(binary_search(arr, target)) - ``` -`Time Complexity Analysis:` -The initialization of left and right takes constant time (O(1)). -The while loop runs for log(n) iterations in the worst case, where n is the size of the array. -Inside the loop, each operation takes constant time (O(1)). + +**Time Complexity Analysis** + +The initialization of left and right takes constant time (O(1)). +The while loop runs for log(n) iterations in the worst case, where n is the size of the array. +Inside the loop, each operation takes constant time (O(1)). Therefore, the time complexity of binary search is `O(log n)`. -`Space Complexity Analysis:` +**Space Complexity Analysis** + The space complexity of binary search is `O(1)` since it only uses a constant amount of additional space for variables regardless of the input size. #### 4. Fibbonaci Sequence + Let's consider an example of a function that generates Fibonacci numbers up to a given index and stores them in a list. In this case, the space complexity will not be constant because the size of the list grows with the Fibonacci sequence. ```python @@ -219,9 +232,12 @@ n = 10 fib_sequence = fibonacci_sequence(n) print(fib_sequence) ``` -`Time Complexity Analysis:` + +**Time Complexity Analysis** + The while loop iterates until the length of the Fibonacci sequence list reaches n, so it takes `O(n)` iterations in the `worst case`.Inside the loop, each operation takes constant time (O(1)). -`Space Complexity Analysis:` -The space complexity of this function is not constant because it creates and stores a list of Fibonacci numbers. -As n grows, the size of the list also grows, so the space complexity is O(n), where n is the index of the last Fibonacci number generated. \ No newline at end of file +**Space Complexity Analysis** + +The space complexity of this function is not constant because it creates and stores a list of Fibonacci numbers. +As n grows, the size of the list also grows, so the space complexity is O(n), where n is the index of the last Fibonacci number generated. From dc015fb32fdb5c8d13beb1f6db76cc669f7d4f5e Mon Sep 17 00:00:00 2001 From: Ankit Mahato Date: Fri, 31 May 2024 05:36:53 +0530 Subject: [PATCH 31/44] Update index.md --- contrib/plotting-visualization/index.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/contrib/plotting-visualization/index.md b/contrib/plotting-visualization/index.md index e7c5745..cabea95 100644 --- a/contrib/plotting-visualization/index.md +++ b/contrib/plotting-visualization/index.md @@ -1,4 +1,4 @@ # List of sections -- [Installing Matplotlib](matplotlib_installation.md) -- [Bar Plots in Matplotlib](matplotlib_bar_plots.md) +- [Installing Matplotlib](installation.md) +- [Bar Plots in Matplotlib](bar-plots.md) From 5f8a9d01ea69a7eb70ccfdc2c1f4690486f6cf77 Mon Sep 17 00:00:00 2001 From: Ankit Mahato Date: Fri, 31 May 2024 05:37:07 +0530 Subject: [PATCH 32/44] Rename matplotlib_bar_plots.md to bar-plots.md --- .../{matplotlib_bar_plots.md => bar-plots.md} | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) rename contrib/plotting-visualization/{matplotlib_bar_plots.md => bar-plots.md} (99%) diff --git a/contrib/plotting-visualization/matplotlib_bar_plots.md b/contrib/plotting-visualization/bar-plots.md similarity index 99% rename from contrib/plotting-visualization/matplotlib_bar_plots.md rename to contrib/plotting-visualization/bar-plots.md index 104001d..97d45ce 100644 --- a/contrib/plotting-visualization/matplotlib_bar_plots.md +++ b/contrib/plotting-visualization/bar-plots.md @@ -213,4 +213,4 @@ ax.invert_yaxis() plt.show() ``` -![Horizontal Bar Plot-2](images/horizontal_bar_plot_2.png) \ No newline at end of file +![Horizontal Bar Plot-2](images/horizontal_bar_plot_2.png) From 077e569deafbb0b0beb244e2c9ddb45df3549723 Mon Sep 17 00:00:00 2001 From: Ankit Mahato Date: Fri, 31 May 2024 05:37:52 +0530 Subject: [PATCH 33/44] Rename matplotlib_installation.md to matplotlib-installation.md --- .../{matplotlib_installation.md => matplotlib-installation.md} | 0 1 file changed, 0 insertions(+), 0 deletions(-) rename contrib/plotting-visualization/{matplotlib_installation.md => matplotlib-installation.md} (100%) diff --git a/contrib/plotting-visualization/matplotlib_installation.md b/contrib/plotting-visualization/matplotlib-installation.md similarity index 100% rename from contrib/plotting-visualization/matplotlib_installation.md rename to contrib/plotting-visualization/matplotlib-installation.md From 7bb7b05ea1de0d1a6d15d985df652579d20a5724 Mon Sep 17 00:00:00 2001 From: Ankit Mahato Date: Fri, 31 May 2024 05:38:17 +0530 Subject: [PATCH 34/44] Update index.md --- contrib/plotting-visualization/index.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/contrib/plotting-visualization/index.md b/contrib/plotting-visualization/index.md index cabea95..4d7fda8 100644 --- a/contrib/plotting-visualization/index.md +++ b/contrib/plotting-visualization/index.md @@ -1,4 +1,4 @@ # List of sections -- [Installing Matplotlib](installation.md) -- [Bar Plots in Matplotlib](bar-plots.md) +- [Installing Matplotlib](matplotlib-installation.md) +- [Bar Plots in Matplotlib](matplotlib-bar-plots.md) From a904e73c65f8bd1941794fe9a87295b4c0493f5e Mon Sep 17 00:00:00 2001 From: Ankit Mahato Date: Fri, 31 May 2024 06:07:45 +0530 Subject: [PATCH 35/44] Update concatenation-of-arrays.md --- contrib/numpy/concatenation-of-arrays.md | 90 ++++++++++++++++-------- 1 file changed, 59 insertions(+), 31 deletions(-) diff --git a/contrib/numpy/concatenation-of-arrays.md b/contrib/numpy/concatenation-of-arrays.md index a0c5051..bf27512 100644 --- a/contrib/numpy/concatenation-of-arrays.md +++ b/contrib/numpy/concatenation-of-arrays.md @@ -20,31 +20,39 @@ Args: ### Example +#### Concatenate along axis 0 + ```python import numpy as np #creating 2 arrays arr1 = np.array([1 2 3],[7 8 9]) arr2 = np.array([4 5 6],[10 11 12]) -#concatenate along axis 0 result_1 = np.concatenate((arr1, arr2), axis=0) -print("Concatenation along axis 0:") print(result_1) -""" Output- Concatenation along axis 0: +``` + +#### Output +``` [[ 1 2 3] [ 7 8 9] [ 4 5 6] - [10 11 12]] """ - -#concatenate along axis 1 -result_2 = np.concatenate((arr1, arr2), axis=1) -print("Concatenation along axis 1:") -print(result_2) -""" Output- Concatenation along axis 1: -[[ 1 2 3 4 5 6 ] - [ 7 8 9 10 11 12]] """ - + [10 11 12]] ``` + +#### Concatenate along axis 1 + +```python +result_2 = np.concatenate((arr1, arr2), axis=1) +print(result_2) +``` + +#### Output +``` +[[ 1 2 3 4 5 6 ] + [ 7 8 9 10 11 12]] +``` + ## np.vstack Vertical stacking of arrays (row-wise). @@ -59,6 +67,7 @@ Args: - arrays: Sequence of arrays to stack. ### Example + ```python import numpy as np #create arrays @@ -67,12 +76,16 @@ arr2 = np.array([4 5 6],[10 11 12]) result = np.vstack((arr1, arr2)) print(result) -"""output- +``` + +#### Output +``` [[ 1 2 3] [ 7 8 9] [ 4 5 6] - [10 11 12]] """ + [10 11 12]] ``` + ## 3. np.hstack Stacks arrays horizontally (column-wise). @@ -96,9 +109,12 @@ arr2 = np.array([4 5 6],[10 11 12]) result = np.hstack((arr1, arr2)) print(result) -"""output- +``` + +#### Output +``` [[ 1 2 3] [ 4 5 6] - [ 7 8 9] [10 11 12]] """ + [ 7 8 9] [10 11 12]] ``` ## np.dstack @@ -123,14 +139,17 @@ arr2 = np.array([4 5 6],[10 11 12]) result = np.dstack((arr1, arr2)) print(result) -""" output- +``` + +#### Output +``` [[[ 1 4] [ 2 5] [ 3 6]] [[ 7 10] [ 8 11] - [ 9 12]]] """ + [ 9 12]]] ``` ## np.stack @@ -154,12 +173,15 @@ arr2 = np.array([4 5 6],[10 11 12]) result = np.stack((arr1, arr2), axis=0) print(result) -""" output- +``` + +#### Output +``` [[[ 1 2 3] [ 7 8 9]] [[ 4 5 6] - [10 11 12]]] """ + [10 11 12]]] ``` # Concatenation with Mixed Dimensions @@ -168,28 +190,34 @@ When concatenating arrays with different shapes, it's often necessary to reshape ## Example +#### Concatenate along axis 0 + ```python arr1 = np.array([[1, 2, 3], [4, 5, 6]]) arr2 = np.array([7, 8, 9]) -# Concatenate along axis 0 result_0= np.concatenate((arr1, arr2[np.newaxis, :]), axis=0) -print("Concatenation along axis 0:") print(result_0) -""" output- -Concatenation along axis 0: +``` + +#### Output +``` [[1 2 3] [4 5 6] - [7 8 9]] """ + [7 8 9]] +``` -# Concatenate along axis 1 +#### Concatenate along axis 1 + +```python result_1 = np.concatenate((arr1, arr2[:, np.newaxis]), axis=1) -print("\nConcatenation along axis 1:") print(result_1) -""" output- -Concatenation along axis 1: +``` + +#### Output +``` [[1 2 3 7] - [4 5 6 8]] """ + [4 5 6 8]] ``` From 75423bc5ba6e4a698ebc53df6f13af52f4cfc21f Mon Sep 17 00:00:00 2001 From: Ankit Mahato Date: Fri, 31 May 2024 06:14:48 +0530 Subject: [PATCH 36/44] Rename numpy_array_iteration.md to array-iteration.md --- contrib/numpy/{numpy_array_iteration.md => array-iteration.md} | 0 1 file changed, 0 insertions(+), 0 deletions(-) rename contrib/numpy/{numpy_array_iteration.md => array-iteration.md} (100%) diff --git a/contrib/numpy/numpy_array_iteration.md b/contrib/numpy/array-iteration.md similarity index 100% rename from contrib/numpy/numpy_array_iteration.md rename to contrib/numpy/array-iteration.md From 3bebec30e0529dac743073495a12ad85cd1e3904 Mon Sep 17 00:00:00 2001 From: Ankit Mahato Date: Fri, 31 May 2024 06:18:47 +0530 Subject: [PATCH 37/44] Update array-iteration.md --- contrib/numpy/array-iteration.md | 35 +++++++++++++++++++++----------- 1 file changed, 23 insertions(+), 12 deletions(-) diff --git a/contrib/numpy/array-iteration.md b/contrib/numpy/array-iteration.md index ac35d95..b0a499f 100644 --- a/contrib/numpy/array-iteration.md +++ b/contrib/numpy/array-iteration.md @@ -7,7 +7,7 @@ Understanding these methods is crucial for performing operations on array elemen - Iterating using basic `for` loop. -**Single-dimensional array iteration**: +### Single-dimensional array Iterating over a single-dimensional array is straightforward using a basic `for` loop @@ -18,11 +18,18 @@ arr = np.array([1, 2, 3, 4, 5]) for i in arr: print(i) ``` -**Output** : + +#### Output + ```python -[ 1 2 3 4 5 ] +1 +2 +3 +4 +5 ``` -**Multi-dimensional array**: + +### Multi-dimensional array Iterating over multi-dimensional arrays, each iteration returns a sub-array along the first axis. @@ -32,14 +39,16 @@ marr = np.array([[1, 2, 3], [4, 5, 6], [7, 8, 9]]) for arr in marr: print(arr) ``` -**Output** : + +#### Output + ```python [1 2 3] [4 5 6] [7 8 9] ``` -## 2. Iterating with nditer +## 2. Iterating with `nditer` - `nditer` is a powerful iterator provided by NumPy for iterating over multi-dimensional arrays. - In each interation it gives each element. @@ -51,7 +60,9 @@ arr = np.array([[1, 2, 3], [4, 5, 6]]) for i in np.nditer(arr): print(i) ``` -**Output** : + +#### Output + ```python 1 2 @@ -61,7 +72,7 @@ for i in np.nditer(arr): 6 ``` -## 3. Iterating with ndenumerate +## 3. Iterating with `ndenumerate` - `ndenumerate` allows you to iterate with both the index and the value of each element. - It gives index and value as output in each iteration @@ -74,7 +85,7 @@ for index,value in np.ndenumerate(arr): print(index,value) ``` -**Output** : +#### Output ```python (0, 0) 1 @@ -86,7 +97,6 @@ for index,value in np.ndenumerate(arr): ## 4. Iterating with flat - The `flat` attribute returns a 1-D iterator over the array. -- ```python import numpy as np @@ -96,7 +106,7 @@ for element in arr.flat: print(element) ``` -**Output** : +#### Output ```python 1 @@ -105,5 +115,6 @@ for element in arr.flat: 4 ``` -Understanding the various ways to iterate over NumPy arrays can significantly enhance your data processing efficiency. +Understanding the various ways to iterate over NumPy arrays can significantly enhance your data processing efficiency. + Whether you are working with single-dimensional or multi-dimensional arrays, NumPy provides versatile tools to iterate and manipulate array elements effectively. From d1bc3127082c3a27b7f2eb27a52fbb4b1013cc36 Mon Sep 17 00:00:00 2001 From: Ankit Mahato Date: Fri, 31 May 2024 06:21:12 +0530 Subject: [PATCH 38/44] Rename Logistic_Regression.md to logistic-regression.md --- .../{Logistic_Regression.md => logistic-regression.md} | 0 1 file changed, 0 insertions(+), 0 deletions(-) rename contrib/machine-learning/{Logistic_Regression.md => logistic-regression.md} (100%) diff --git a/contrib/machine-learning/Logistic_Regression.md b/contrib/machine-learning/logistic-regression.md similarity index 100% rename from contrib/machine-learning/Logistic_Regression.md rename to contrib/machine-learning/logistic-regression.md From ad01516cf8f834d7c4afbf907cd72320bc432f1e Mon Sep 17 00:00:00 2001 From: Ankit Mahato Date: Fri, 31 May 2024 06:21:28 +0530 Subject: [PATCH 39/44] Update index.md --- contrib/machine-learning/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/contrib/machine-learning/index.md b/contrib/machine-learning/index.md index 0b9c2b0..46100df 100644 --- a/contrib/machine-learning/index.md +++ b/contrib/machine-learning/index.md @@ -9,4 +9,4 @@ - [TensorFlow.md](tensorFlow.md) - [PyTorch.md](pytorch.md) - [Types of optimizers](Types_of_optimizers.md) -- [Logistic Regression](Logistic_Regression.md) +- [Logistic Regression](logistic-regression.md) From 70547423e3af49f0c65c7b444f8d2987239e87a5 Mon Sep 17 00:00:00 2001 From: Ankit Mahato Date: Fri, 31 May 2024 06:23:46 +0530 Subject: [PATCH 40/44] Update logistic-regression.md --- contrib/machine-learning/logistic-regression.md | 6 ------ 1 file changed, 6 deletions(-) diff --git a/contrib/machine-learning/logistic-regression.md b/contrib/machine-learning/logistic-regression.md index 3111550..2e45e98 100644 --- a/contrib/machine-learning/logistic-regression.md +++ b/contrib/machine-learning/logistic-regression.md @@ -113,9 +113,3 @@ print("Classification Report:\n", class_report) ## Conclusion Logistic regression is a fundamental classification technique that is easy to implement and interpret. It is a powerful tool for binary classification problems and provides a probabilistic framework for predicting binary outcomes. - -## References - -- [Scikit-learn Documentation](https://scikit-learn.org/stable/modules/linear_model.html#logistic-regression) -- [Wikipedia: Logistic Regression](https://en.wikipedia.org/wiki/Logistic_regression) -- [Towards Data Science: Understanding Logistic Regression](https://towardsdatascience.com/understanding-logistic-regression-9b02c2aec102) From 1646a8c0330695ef4750a2ca533062a7c1c61599 Mon Sep 17 00:00:00 2001 From: Ankit Mahato Date: Fri, 31 May 2024 06:32:34 +0530 Subject: [PATCH 41/44] Update recursion.md --- contrib/ds-algorithms/recursion.md | 41 +++++++----------------------- 1 file changed, 9 insertions(+), 32 deletions(-) diff --git a/contrib/ds-algorithms/recursion.md b/contrib/ds-algorithms/recursion.md index 67c630b..4233242 100644 --- a/contrib/ds-algorithms/recursion.md +++ b/contrib/ds-algorithms/recursion.md @@ -2,7 +2,7 @@ When a function calls itself to solve smaller instances of the same problem until a specified condition is fulfilled is called recursion. It is used for tasks that can be divided into smaller sub-tasks. -# How Recursion Works +## How Recursion Works To solve a problem using recursion we must define: - Base condition :- The condition under which recursion ends. @@ -17,7 +17,7 @@ When a recursive function is called, the following sequence of events occurs: - Stack Management: Each recursive call is placed on the call stack. The stack keeps track of each function call, its argument, and the point to return to once the call completes. - Unwinding the Stack: When the base case is eventually met, the function returns a value, and the stack starts unwinding, returning values to previous function calls until the initial call is resolved. -# Python Code: Factorial using Recursion +## Python Code: Factorial using Recursion ```python def fact(n): @@ -30,7 +30,7 @@ if __name__ == "__main__": print("Factorial of", n, "is", fact(n)) ``` -## Explanation +### Explanation This Python script calculates the factorial of a given number using recursion. @@ -43,8 +43,7 @@ This Python script calculates the factorial of a given number using recursion. - The main section prompts the user to enter a positive number. - It then calls the `fact` function with the input number and prints the result. -### Example : Let n = 4 - +#### Example : Let n = 4 The recursion unfolds as follows: 1. When `fact(4)` is called, it computes `4 * fact(3)`. @@ -55,48 +54,26 @@ The recursion unfolds as follows: 6. `fact(4)` receives the value from `fact(3)`, resulting in `4 * 6` i.e. `24`. 7. Finally, `fact(4)` returns 24 to the main function. - #### So, the result is 24. - - -# What is Stack Overflow in Recursion +#### What is Stack Overflow in Recursion? Stack overflow is an error that occurs when the call stack memory limit is exceeded. During execution of recursion calls they are simultaneously stored in a recursion stack waiting for the recursive function to be completed. Without a base case, the function would call itself indefinitely, leading to a stack overflow. -# Example - -- Factorial of a Number - - The factorial of i natural numbers is nth integer multiplied by factorial of (i-1) numbers. The base case is if i=0 we return 1 as factorial of 0 is 1. - -```python -def factorial(i): - #base case - if i==0 : - return 1 - #recursive case - else : - return i * factorial(i-1) -i = 6 -print("Factorial of i is :", factorial(i)) # Output- Factorial of i is :720 -``` -# What is Backtracking +## What is Backtracking Backtracking is a recursive algorithmic technique used to solve problems by exploring all possible solutions and discarding those that do not meet the problem's constraints. It is particularly useful for problems involving combinations, permutations, and finding paths in a grid. -# How Backtracking Works +## How Backtracking Works - Incremental Solution Building: Solutions are built one step at a time. - Feasibility Check: At each step, a check is made to see if the current partial solution is valid. - Backtracking: If a partial solution is found to be invalid, the algorithm backtracks by removing the last added part of the solution and trying the next possibility. - Exploration of All Possibilities: The process continues recursively, exploring all possible paths, until a solution is found or all possibilities are exhausted. -# Example +## Example: Word Search -- Word Search - - Given a 2D grid of characters and a word, determine if the word exists in the grid. The word can be constructed from letters of sequentially adjacent cells, where "adjacent" cells are horizontally or vertically neighboring. The same letter cell may not be used more than once. +Given a 2D grid of characters and a word, determine if the word exists in the grid. The word can be constructed from letters of sequentially adjacent cells, where "adjacent" cells are horizontally or vertically neighboring. The same letter cell may not be used more than once. Algorithm for Solving the Word Search Problem with Backtracking: - Start at each cell: Attempt to find the word starting from each cell. From 73955bd969f1f799832976af4177d24c3f09b9ff Mon Sep 17 00:00:00 2001 From: Ankit Mahato Date: Fri, 31 May 2024 07:10:57 +0530 Subject: [PATCH 42/44] Update index.md --- contrib/numpy/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/contrib/numpy/index.md b/contrib/numpy/index.md index df759d9..2e418ab 100644 --- a/contrib/numpy/index.md +++ b/contrib/numpy/index.md @@ -3,7 +3,7 @@ - [Installing NumPy](installing-numpy.md) - [Introduction](introduction.md) - [NumPy Data Types](datatypes.md) -- [Numpy Array Shape and Reshape](array_reshape.md) +- [Numpy Array Shape and Reshape](reshape-array.md) - [Basic Mathematics](basic_math.md) - [Operations on Arrays in NumPy](operations-on-arrays.md) - [Loading Arrays from Files](loading_arrays_from_files.md) From bf4fa5a067c550d3a76403789e33839827c96021 Mon Sep 17 00:00:00 2001 From: Ankit Mahato Date: Fri, 31 May 2024 07:11:13 +0530 Subject: [PATCH 43/44] Rename array_reshape.md to reshape-array.md --- contrib/numpy/{array_reshape.md => reshape-array.md} | 0 1 file changed, 0 insertions(+), 0 deletions(-) rename contrib/numpy/{array_reshape.md => reshape-array.md} (100%) diff --git a/contrib/numpy/array_reshape.md b/contrib/numpy/reshape-array.md similarity index 100% rename from contrib/numpy/array_reshape.md rename to contrib/numpy/reshape-array.md From 02c7f2c3a202fc7234c5000dd010b1f3df6b9910 Mon Sep 17 00:00:00 2001 From: Ankit Mahato Date: Fri, 31 May 2024 07:19:32 +0530 Subject: [PATCH 44/44] Update reshape-array.md --- contrib/numpy/reshape-array.md | 53 ++++++++++++++++++---------------- 1 file changed, 28 insertions(+), 25 deletions(-) diff --git a/contrib/numpy/reshape-array.md b/contrib/numpy/reshape-array.md index d3d7f59..91da366 100644 --- a/contrib/numpy/reshape-array.md +++ b/contrib/numpy/reshape-array.md @@ -1,54 +1,57 @@ # Numpy Array Shape and Reshape + In NumPy, the primary data structure is the ndarray (N-dimensional array). An array can have one or more dimensions, and it organizes your data efficiently. -Code to create a 2D array +Let us create a 2D array + ``` python import numpy as np numbers = np.array([[1, 2, 3, 4], [5, 6, 7, 8]]) print(numbers) - -# Output: -# array([[1, 2, 3, 4],[5, 6, 7, 8]]) ``` -## Changing Array Shape using Reshape() +#### Output: + +``` python +array([[1, 2, 3, 4],[5, 6, 7, 8]]) +``` + +## Changing Array Shape using `reshape()` + The `reshape()` function allows you to rearrange the data within a NumPy array. -It take 2 arguements, row and columns. The `reshape()` can add or remove the dimensions. For instance, array can convert a 1D array into a 2D array or vice versa. + +It take 2 arguments, row and columns. The `reshape()` can add or remove the dimensions. For instance, array can convert a 1D array into a 2D array or vice versa. ``` python arr_1d = np.array([1, 2, 3, 4, 5, 6]) # 1D array -arr_2d = arr_1d.reshape(2, 3) # Reshaping with 2rows and 3cols +arr_2d = arr_1d.reshape(2, 3) # Reshaping with 2 rows and 3 cols print(arr_2d) - -# Output: -# array([[1, 2, 3],[4, 5, 6]]) - ``` -## Changing Array Shape using Resize() +#### Output: + +``` python +array([[1, 2, 3],[4, 5, 6]]) +``` + +## Changing Array Shape using `resize()` + The `resize()` function allows you to modify the shape of a NumPy array directly. + It take 2 arguements, row and columns. ``` python import numpy as np arr_1d = np.array([1, 2, 3, 4, 5, 6]) -arr_1d.resize((2, 3)) # 2rows and 3cols +arr_1d.resize((2, 3)) # 2 rows and 3 cols print(arr_1d) - -# Output: -# array([[1, 2, 3],[4, 5, 6]]) - ``` -## Reshape() VS Resize() +#### Output: -| Reshape | Resize | -| ----------- | ----------- | -| Does not modify the original array | Modifies the original array in-place | -| Creates a new array | Changes the shape of the array | -| Returns a reshaped array | Doesn't return anything | -| Compatibility between dimensions | Does not compatibility between dimensions | -| Syntax: reshape(row,col) | Syntax: resize((row,col)) | +``` python +array([[1, 2, 3],[4, 5, 6]]) +```