From 981144e42d29f0156dd0ed584d7936c71550762c Mon Sep 17 00:00:00 2001 From: krahets Date: Sun, 20 Aug 2023 23:28:30 +0800 Subject: [PATCH] =?UTF-8?q?1.=20lower-case=20nouns=202.=20fix=202=20figure?= =?UTF-8?q?s=203.=20Replace=20some=20=E3=80=8C=E3=80=8D=20by=20=E2=80=9C?= =?UTF-8?q?=E2=80=9D?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/chapter_appendix/contribution.md | 4 +- docs/chapter_array_and_linkedlist/array.md | 4 +- .../linked_list.md | 8 ++-- docs/chapter_array_and_linkedlist/list.md | 2 +- .../backtracking_algorithm.md | 4 +- .../space_complexity.md | 4 +- .../time_complexity.md | 16 ++++---- .../basic_data_types.md | 3 +- .../classification_of_data_structure.md | 4 +- .../chapter_data_structure/number_encoding.md | 13 +++--- .../build_binary_tree_problem.md | 1 + .../divide_and_conquer.md | 10 ++--- .../dp_problem_features.md | 10 ++--- .../dp_solution_pipeline.md | 2 +- .../intro_to_dynamic_programming.md | 4 +- .../unbounded_knapsack_example.png | Bin 70520 -> 70479 bytes docs/chapter_graph/graph.md | 27 +++++++------ docs/chapter_graph/graph_operations.md | 3 +- docs/chapter_graph/graph_traversal.md | 6 +-- docs/chapter_hashing/hash_collision.md | 6 +-- docs/chapter_hashing/hash_map.md | 11 +++--- docs/chapter_heap/build_heap.md | 2 +- docs/chapter_heap/heap.md | 15 +++---- docs/chapter_heap/top_k.md | 2 +- .../binary_search_dictionary_step_1.png | Bin 50511 -> 49543 bytes .../algorithms_are_everywhere.md | 6 +-- docs/chapter_introduction/what_is_dsa.md | 2 +- docs/chapter_preface/suggestions.md | 6 +-- docs/chapter_searching/binary_search.md | 2 +- .../searching_algorithm_revisited.md | 13 +++--- docs/chapter_sorting/bubble_sort.md | 2 +- docs/chapter_sorting/bucket_sort.md | 2 +- docs/chapter_sorting/counting_sort.md | 4 +- docs/chapter_sorting/heap_sort.md | 4 +- docs/chapter_sorting/insertion_sort.md | 2 +- docs/chapter_sorting/merge_sort.md | 2 +- docs/chapter_sorting/quick_sort.md | 16 ++++---- docs/chapter_sorting/radix_sort.md | 4 +- docs/chapter_sorting/selection_sort.md | 2 +- docs/chapter_sorting/sorting_algorithm.md | 6 +-- docs/chapter_stack_and_queue/deque.md | 5 ++- docs/chapter_stack_and_queue/queue.md | 9 +++-- docs/chapter_stack_and_queue/stack.md | 11 +++--- .../array_representation_of_tree.md | 2 +- docs/chapter_tree/avl_tree.md | 27 +++++++------ docs/chapter_tree/binary_search_tree.md | 3 +- docs/chapter_tree/binary_tree.md | 37 +++++++++--------- docs/chapter_tree/binary_tree_traversal.md | 8 ++-- 48 files changed, 174 insertions(+), 162 deletions(-) diff --git a/docs/chapter_appendix/contribution.md b/docs/chapter_appendix/contribution.md index cd82541b0..7248443d3 100644 --- a/docs/chapter_appendix/contribution.md +++ b/docs/chapter_appendix/contribution.md @@ -12,9 +12,9 @@ ## 内容微调 -在每个页面的右上角有一个「编辑」图标，您可以按照以下步骤修改文本或代码： +您可以按照以下步骤修改文本或代码： -1. 点击编辑按钮，如果遇到“需要 Fork 此仓库”的提示，请同意该操作。 +1. 点击页面的右上角的“编辑图标”，如果遇到“需要 Fork 此仓库”的提示，请同意该操作。 2. 修改 Markdown 源文件内容，检查内容的正确性，并尽量保持排版格式的统一。 3. 在页面底部填写修改说明，然后点击“Propose file change”按钮。页面跳转后，点击“Create pull request”按钮即可发起拉取请求。 diff --git a/docs/chapter_array_and_linkedlist/array.md b/docs/chapter_array_and_linkedlist/array.md index bc54714e4..15edd34c2 100755 --- a/docs/chapter_array_and_linkedlist/array.md +++ b/docs/chapter_array_and_linkedlist/array.md @@ -1,6 +1,6 @@ # 数组 -「数组 Array」是一种线性数据结构，其将相同类型元素存储在连续的内存空间中。我们将某个元素在数组中的位置称为该元素的「索引 Index」。 +「数组 array」是一种线性数据结构，其将相同类型元素存储在连续的内存空间中。我们将某个元素在数组中的位置称为该元素的「索引 index」。 ![数组定义与存储方式](array.assets/array_definition.png) @@ -445,7 +445,7 @@ elementAddr = firtstElementAddr + elementLength * elementIndex 在数组中查找指定元素需要遍历数组，每轮判断元素值是否匹配，若匹配则输出对应索引。 -因为数组是线性数据结构，所以上述查找操作被称为「线性查找」。 +因为数组是线性数据结构，所以上述查找操作被称为“线性查找”。 === "Java" diff --git a/docs/chapter_array_and_linkedlist/linked_list.md b/docs/chapter_array_and_linkedlist/linked_list.md index 997036ab0..f4296f24c 100755 --- a/docs/chapter_array_and_linkedlist/linked_list.md +++ b/docs/chapter_array_and_linkedlist/linked_list.md @@ -2,17 +2,17 @@ 内存空间是所有程序的公共资源，在一个复杂的系统运行环境下，空闲的内存空间可能散落在内存各处。我们知道，存储数组的内存空间必须是连续的，而当数组非常大时，内存可能无法提供如此大的连续空间。此时链表的灵活性优势就体现出来了。 -「链表 Linked List」是一种线性数据结构，其中的每个元素都是一个节点对象，各个节点通过“引用”相连接。引用记录了下一个节点的内存地址，我们可以通过它从当前节点访问到下一个节点。这意味着链表的各个节点可以被分散存储在内存各处，它们的内存地址是无须连续的。 +「链表 linked list」是一种线性数据结构，其中的每个元素都是一个节点对象，各个节点通过“引用”相连接。引用记录了下一个节点的内存地址，我们可以通过它从当前节点访问到下一个节点。这意味着链表的各个节点可以被分散存储在内存各处，它们的内存地址是无须连续的。 ![链表定义与存储方式](linked_list.assets/linkedlist_definition.png) -观察上图，链表中的每个「节点 Node」对象都包含两项数据：节点的“值”、指向下一节点的“引用”。 +观察上图，链表的组成单位是「节点 node」对象。每个节点都包含两项数据：节点的“值”和指向下一节点的“引用”。 - 链表的首个节点被称为“头节点”，最后一个节点被称为“尾节点”。 - 尾节点指向的是“空”，它在 Java, C++, Python 中分别被记为 $\text{null}$ , $\text{nullptr}$ , $\text{None}$ 。 - 在 C, C++, Go, Rust 等支持指针的语言中，上述的“引用”应被替换为“指针”。 -如以下代码所示，链表以节点对象 `ListNode` 为单位，每个节点除了包含值，还需额外保存下一节点的引用（指针）。因此在相同数据量下，**链表通常比数组占用更多的内存空间**。 +链表节点 `ListNode` 如以下代码所示。每个节点除了包含值，还需额外保存一个引用（指针）。因此在相同数据量下，**链表比数组占用更多的内存空间**。 === "Java" @@ -633,7 +633,7 @@ ### 查找节点 -遍历链表，查找链表内值为 `target` 的节点，输出节点在链表中的索引。此过程也属于「线性查找」。 +遍历链表，查找链表内值为 `target` 的节点，输出节点在链表中的索引。此过程也属于线性查找。 === "Java" diff --git a/docs/chapter_array_and_linkedlist/list.md b/docs/chapter_array_and_linkedlist/list.md index 25a10bc16..0e4c59973 100755 --- a/docs/chapter_array_and_linkedlist/list.md +++ b/docs/chapter_array_and_linkedlist/list.md @@ -2,7 +2,7 @@ **数组长度不可变导致实用性降低**。在实际中，我们可能事先无法确定需要存储多少数据，这使数组长度的选择变得困难。若长度过小，需要在持续添加数据时频繁扩容数组；若长度过大，则会造成内存空间的浪费。 -为解决此问题，出现了一种被称为「动态数组 Dynamic Array」的数据结构，即长度可变的数组，也常被称为「列表 List」。列表基于数组实现，继承了数组的优点，并且可以在程序运行过程中动态扩容。我们可以在列表中自由地添加元素，而无须担心超过容量限制。 +为解决此问题，出现了一种被称为「动态数组 dynamic array」的数据结构，即长度可变的数组，也常被称为「列表 list」。列表基于数组实现，继承了数组的优点，并且可以在程序运行过程中动态扩容。我们可以在列表中自由地添加元素，而无须担心超过容量限制。 ## 列表常用操作 diff --git a/docs/chapter_backtracking/backtracking_algorithm.md b/docs/chapter_backtracking/backtracking_algorithm.md index 389bd561d..a8c7980e6 100644 --- a/docs/chapter_backtracking/backtracking_algorithm.md +++ b/docs/chapter_backtracking/backtracking_algorithm.md @@ -1,8 +1,8 @@ # 回溯算法 -「回溯算法 Backtracking Algorithm」是一种通过穷举来解决问题的方法，它的核心思想是从一个初始状态出发，暴力搜索所有可能的解决方案，当遇到正确的解则将其记录，直到找到解或者尝试了所有可能的选择都无法找到解为止。 +「回溯算法 backtracking algorithm」是一种通过穷举来解决问题的方法，它的核心思想是从一个初始状态出发，暴力搜索所有可能的解决方案，当遇到正确的解则将其记录，直到找到解或者尝试了所有可能的选择都无法找到解为止。 -回溯算法通常采用「深度优先搜索」来遍历解空间。在二叉树章节中，我们提到前序、中序和后序遍历都属于深度优先搜索。接下来，我们利用前序遍历构造一个回溯问题，逐步了解回溯算法的工作原理。 +回溯算法通常采用“深度优先搜索”来遍历解空间。在二叉树章节中，我们提到前序、中序和后序遍历都属于深度优先搜索。接下来，我们利用前序遍历构造一个回溯问题，逐步了解回溯算法的工作原理。 !!! question "例题一" diff --git a/docs/chapter_computational_complexity/space_complexity.md b/docs/chapter_computational_complexity/space_complexity.md index 95cef5f84..5ee66c2c3 100755 --- a/docs/chapter_computational_complexity/space_complexity.md +++ b/docs/chapter_computational_complexity/space_complexity.md @@ -290,7 +290,7 @@ 空间复杂度的推算方法与时间复杂度大致相同，只需将统计对象从“操作数量”转为“使用空间大小”。 -而与时间复杂度不同的是，**我们通常只关注「最差空间复杂度」**。这是因为内存空间是一项硬性要求，我们必须确保在所有输入数据下都有足够的内存空间预留。 +而与时间复杂度不同的是，**我们通常只关注最差空间复杂度**。这是因为内存空间是一项硬性要求，我们必须确保在所有输入数据下都有足够的内存空间预留。 观察以下代码，最差空间复杂度中的“最差”有两层含义。 @@ -1077,7 +1077,7 @@ $$ ### 指数阶 $O(2^n)$ -指数阶常见于二叉树。高度为 $n$ 的「满二叉树」的节点数量为 $2^n - 1$ ，占用 $O(2^n)$ 空间： +指数阶常见于二叉树。高度为 $n$ 的“满二叉树”的节点数量为 $2^n - 1$ ，占用 $O(2^n)$ 空间： === "Java" diff --git a/docs/chapter_computational_complexity/time_complexity.md b/docs/chapter_computational_complexity/time_complexity.md index 8f3840707..14acb162e 100755 --- a/docs/chapter_computational_complexity/time_complexity.md +++ b/docs/chapter_computational_complexity/time_complexity.md @@ -187,7 +187,7 @@ $$ ## 统计时间增长趋势 -「时间复杂度分析」采取了一种不同的方法，其统计的不是算法运行时间，**而是算法运行时间随着数据量变大时的增长趋势**。 +时间复杂度分析统计的不是算法运行时间，**而是算法运行时间随着数据量变大时的增长趋势**。 “时间增长趋势”这个概念比较抽象，我们通过一个例子来加以理解。假设输入数据大小为 $n$ ，给定三个算法函数 `A` 、 `B` 和 `C` ： @@ -426,11 +426,11 @@ $$ } ``` -算法 `A` 只有 $1$ 个打印操作，算法运行时间不随着 $n$ 增大而增长。我们称此算法的时间复杂度为「常数阶」。 +算法 `A` 只有 $1$ 个打印操作，算法运行时间不随着 $n$ 增大而增长。我们称此算法的时间复杂度为“常数阶”。 -算法 `B` 中的打印操作需要循环 $n$ 次，算法运行时间随着 $n$ 增大呈线性增长。此算法的时间复杂度被称为「线性阶」。 +算法 `B` 中的打印操作需要循环 $n$ 次，算法运行时间随着 $n$ 增大呈线性增长。此算法的时间复杂度被称为“线性阶”。 -算法 `C` 中的打印操作需要循环 $1000000$ 次，虽然运行时间很长，但它与输入数据大小 $n$ 无关。因此 `C` 的时间复杂度和 `A` 相同，仍为「常数阶」。 +算法 `C` 中的打印操作需要循环 $1000000$ 次，虽然运行时间很长，但它与输入数据大小 $n$ 无关。因此 `C` 的时间复杂度和 `A` 相同，仍为“常数阶”。 ![算法 A 、B 和 C 的时间增长趋势](time_complexity.assets/time_complexity_simple_example.png) @@ -1442,7 +1442,7 @@ $$ [class]{}-[func]{exp_recur} ``` -指数阶增长非常迅速，在穷举法（暴力搜索、回溯等）中比较常见。对于数据规模较大的问题，指数阶是不可接受的，通常需要使用「动态规划」或「贪心」等算法来解决。 +指数阶增长非常迅速，在穷举法（暴力搜索、回溯等）中比较常见。对于数据规模较大的问题，指数阶是不可接受的，通常需要使用动态规划或贪心等算法来解决。 ### 对数阶 $O(\log n)$ @@ -1771,7 +1771,7 @@ $$ - 当 `nums = [?, ?, ..., 1]` ，即当末尾元素是 $1$ 时，需要完整遍历数组，**达到最差时间复杂度 $O(n)$** 。 - 当 `nums = [1, ?, ?, ...]` ，即当首个元素为 $1$ 时，无论数组多长都不需要继续遍历，**达到最佳时间复杂度 $\Omega(1)$** 。 -「最差时间复杂度」对应函数渐近上界，使用大 $O$ 记号表示。相应地，「最佳时间复杂度」对应函数渐近下界，用 $\Omega$ 记号表示： +“最差时间复杂度”对应函数渐近上界，使用大 $O$ 记号表示。相应地，“最佳时间复杂度”对应函数渐近下界，用 $\Omega$ 记号表示： === "Java" @@ -1888,9 +1888,9 @@ $$ [class]{}-[func]{find_one} ``` -值得说明的是，我们在实际中很少使用「最佳时间复杂度」，因为通常只有在很小概率下才能达到，可能会带来一定的误导性。**而「最差时间复杂度」更为实用，因为它给出了一个效率安全值**，让我们可以放心地使用算法。 +值得说明的是，我们在实际中很少使用最佳时间复杂度，因为通常只有在很小概率下才能达到，可能会带来一定的误导性。**而最差时间复杂度更为实用，因为它给出了一个效率安全值**，让我们可以放心地使用算法。 -从上述示例可以看出，最差或最佳时间复杂度只出现于“特殊的数据分布”，这些情况的出现概率可能很小，并不能真实地反映算法运行效率。相比之下，**「平均时间复杂度」可以体现算法在随机输入数据下的运行效率**，用 $\Theta$ 记号来表示。 +从上述示例可以看出，最差或最佳时间复杂度只出现于“特殊的数据分布”，这些情况的出现概率可能很小，并不能真实地反映算法运行效率。相比之下，**平均时间复杂度可以体现算法在随机输入数据下的运行效率**，用 $\Theta$ 记号来表示。 对于部分算法，我们可以简单地推算出随机数据分布下的平均情况。比如上述示例，由于输入数组是被打乱的，因此元素 $1$ 出现在任意索引的概率都是相等的，那么算法的平均循环次数就是数组长度的一半 $\frac{n}{2}$ ，平均时间复杂度为 $\Theta(\frac{n}{2}) = \Theta(n)$ 。 diff --git a/docs/chapter_data_structure/basic_data_types.md b/docs/chapter_data_structure/basic_data_types.md index 01de6fa15..acbbd1573 100644 --- a/docs/chapter_data_structure/basic_data_types.md +++ b/docs/chapter_data_structure/basic_data_types.md @@ -17,6 +17,7 @@ - 整数类型 `int` 占用 $4$ bytes = $32$ bits ，可以表示 $2^{32}$ 个数字。 下表列举了各种基本数据类型的占用空间、取值范围和默认值。此表格无须硬背，大致理解即可，需要时可以通过查表来回忆。 +

表：基本数据类型的占用空间和取值范围

| 类型 | 符号 | 占用空间 | 最小值 | 最大值 | 默认值 | @@ -78,7 +79,7 @@ === "Go" ```go title="" - // 使用多种「基本数据类型」来初始化「数组」 + // 使用多种基本数据类型来初始化数组 var numbers = [5]int{} var decimals = [5]float64{} var characters = [5]byte{} diff --git a/docs/chapter_data_structure/classification_of_data_structure.md b/docs/chapter_data_structure/classification_of_data_structure.md index 40bdef27f..f21ce6763 100644 --- a/docs/chapter_data_structure/classification_of_data_structure.md +++ b/docs/chapter_data_structure/classification_of_data_structure.md @@ -4,7 +4,7 @@ ## 逻辑结构：线性与非线性 -**「逻辑结构」揭示了数据元素之间的逻辑关系**。在数组和链表中，数据按照顺序依次排列，体现了数据之间的线性关系；而在树中，数据从顶部向下按层次排列，表现出祖先与后代之间的派生关系；图则由节点和边构成，反映了复杂的网络关系。 +**逻辑结构揭示了数据元素之间的逻辑关系**。在数组和链表中，数据按照顺序依次排列，体现了数据之间的线性关系；而在树中，数据从顶部向下按层次排列，表现出祖先与后代之间的派生关系；图则由节点和边构成，反映了复杂的网络关系。 逻辑结构可被分为“线性”和“非线性”两大类。线性结构比较直观，指数据在逻辑关系上呈线性排列；非线性结构则相反，呈非线性排列。 @@ -31,7 +31,7 @@ 内存是所有程序的共享资源，当某块内存被某个程序占用时，则无法被其他程序同时使用了。**因此在数据结构与算法的设计中，内存资源是一个重要的考虑因素**。比如，算法所占用的内存峰值不应超过系统剩余空闲内存；如果缺少连续大块的内存空间，那么所选用的数据结构必须能够存储在离散的内存空间内。 -**「物理结构」反映了数据在计算机内存中的存储方式**，可分为连续空间存储（数组）和离散空间存储（链表）。物理结构从底层决定了数据的访问、更新、增删等操作方法，同时在时间效率和空间效率方面呈现出互补的特点。 +**物理结构反映了数据在计算机内存中的存储方式**，可分为连续空间存储（数组）和离散空间存储（链表）。物理结构从底层决定了数据的访问、更新、增删等操作方法，同时在时间效率和空间效率方面呈现出互补的特点。 ![连续空间存储与离散空间存储](classification_of_data_structure.assets/classification_phisical_structure.png) diff --git a/docs/chapter_data_structure/number_encoding.md b/docs/chapter_data_structure/number_encoding.md index 9cb3e9b7e..c2be5286f 100644 --- a/docs/chapter_data_structure/number_encoding.md +++ b/docs/chapter_data_structure/number_encoding.md @@ -6,9 +6,9 @@ ## 原码、反码和补码 -从上一节的表格中我们发现，所有整数类型能够表示的负数都比正数多一个。例如，`byte` 的取值范围是 $[-128, 127]$ 。这个现象比较反直觉，它的内在原因涉及到原码、反码、补码的相关知识。 +在上一节的表格中我们发现，所有整数类型能够表示的负数都比正数多一个，例如 `byte` 的取值范围是 $[-128, 127]$ 。这个现象比较反直觉，它的内在原因涉及到原码、反码、补码的相关知识。 -在展开分析之前，我们首先给出三者的定义： +实际上，**数字是以“补码”的形式存储在计算机中的**。在分析这样做的原因之前，我们首先给出三者的定义： - **原码**：我们将数字的二进制表示的最高位视为符号位，其中 $0$ 表示正数，$1$ 表示负数，其余位表示数字的值。 - **反码**：正数的反码与其原码相同，负数的反码是对其原码除符号位外的所有位取反。 @@ -16,9 +16,7 @@ ![原码、反码与补码之间的相互转换](number_encoding.assets/1s_2s_complement.png) -显然「原码」最为直观。但实际上，**数字是以「补码」的形式存储在计算机中的**。这是因为原码存在一些局限性。 - -一方面，**负数的原码不能直接用于运算**。例如，我们在原码下计算 $1 + (-2)$ ，得到的结果是 $-3$ ，这显然是不对的。 +「原码 true form」虽然最直观，但存在一些局限性。一方面，**负数的原码不能直接用于运算**。例如在原码下计算 $1 + (-2)$ ，得到的结果是 $-3$ ，这显然是不对的。 $$ \begin{aligned} @@ -29,7 +27,7 @@ $$ \end{aligned} $$ -为了解决此问题，计算机引入了「反码」。如果我们先将原码转换为反码，并在反码下计算 $1 + (-2)$ ，最后将结果从反码转化回原码，则可得到正确结果 $-1$ 。 +为了解决此问题，计算机引入了「反码 1's complement code」。如果我们先将原码转换为反码，并在反码下计算 $1 + (-2)$ ，最后将结果从反码转化回原码，则可得到正确结果 $-1$ 。 $$ \begin{aligned} @@ -51,7 +49,7 @@ $$ \end{aligned} $$ -与原码一样，反码也存在正负零歧义问题，因此计算机进一步引入了「补码」。我们先来观察一下负零的原码、反码、补码的转换过程： +与原码一样，反码也存在正负零歧义问题，因此计算机进一步引入了「补码 2's complement code」。我们先来观察一下负零的原码、反码、补码的转换过程： $$ \begin{aligned} @@ -136,6 +134,7 @@ $$ **尽管浮点数 `float` 扩展了取值范围，但其副作用是牺牲了精度**。整数类型 `int` 将全部 32 位用于表示数字，数字是均匀分布的；而由于指数位的存在，浮点数 `float` 的数值越大，相邻两个数字之间的差值就会趋向越大。 进一步地，指数位 $E = 0$ 和 $E = 255$ 具有特殊含义，**用于表示零、无穷大、$\mathrm{NaN}$ 等**。 +

表：指数位含义

| 指数位 E | 分数位 $\mathrm{N} = 0$ | 分数位 $\mathrm{N} \ne 0$ | 计算公式 | diff --git a/docs/chapter_divide_and_conquer/build_binary_tree_problem.md b/docs/chapter_divide_and_conquer/build_binary_tree_problem.md index b4782e36b..fec525702 100644 --- a/docs/chapter_divide_and_conquer/build_binary_tree_problem.md +++ b/docs/chapter_divide_and_conquer/build_binary_tree_problem.md @@ -40,6 +40,7 @@ - 将当前树在 `inorder` 中的索引区间记为 $[l, r]$ 。 如下表所示，通过以上变量即可表示根节点在 `preorder` 中的索引，以及子树在 `inorder` 中的索引区间。 +

表：根节点和子树在前序和中序遍历中的索引

| | 根节点在 `preorder` 中的索引 | 子树在 `inorder` 中的索引区间 | diff --git a/docs/chapter_divide_and_conquer/divide_and_conquer.md b/docs/chapter_divide_and_conquer/divide_and_conquer.md index f2a194250..8010becef 100644 --- a/docs/chapter_divide_and_conquer/divide_and_conquer.md +++ b/docs/chapter_divide_and_conquer/divide_and_conquer.md @@ -1,11 +1,11 @@ # 分治算法 -「分治 Divide and Conquer」，全称分而治之，是一种非常重要且常见的算法策略。分治通常基于递归实现，包括“分”和“治”两步： +「分治 divide and conquer」，全称分而治之，是一种非常重要且常见的算法策略。分治通常基于递归实现，包括“分”和“治”两步： 1. **分（划分阶段）**：递归地将原问题分解为两个或多个子问题，直至到达最小子问题时终止。 2. **治（合并阶段）**：从已知解的最小子问题开始，从底至顶地将子问题的解进行合并，从而构建出原问题的解。 -已介绍过的「归并排序」是分治策略的典型应用之一，它的分治策略为： +我们已学过的“归并排序”是分治策略的典型应用之一，其算法原理为： 1. **分**：递归地将原数组（原问题）划分为两个子数组（子问题），直到子数组只剩一个元素（最小子问题）。 2. **治**：从底至顶地将有序的子数组（子问题的解）进行合并，从而得到有序的原数组（原问题的解）。 @@ -34,7 +34,7 @@ ### 操作数量优化 -以「冒泡排序」为例，其处理一个长度为 $n$ 的数组需要 $O(n^2)$ 时间。假设我们把数组从中点分为两个子数组，则划分需要 $O(n)$ 时间，排序每个子数组需要 $O((\frac{n}{2})^2)$ 时间，合并两个子数组需要 $O(n)$ 时间，总体时间复杂度为： +以“冒泡排序”为例，其处理一个长度为 $n$ 的数组需要 $O(n^2)$ 时间。假设我们把数组从中点分为两个子数组，则划分需要 $O(n)$ 时间，排序每个子数组需要 $O((\frac{n}{2})^2)$ 时间，合并两个子数组需要 $O(n)$ 时间，总体时间复杂度为： $$ O(n + (\frac{n}{2})^2 \times 2 + n) = O(\frac{n^2}{2} + 2n) @@ -54,9 +54,9 @@ $$ **这意味着当 $n > 4$ 时，划分后的操作数量更少，排序效率应该更高**。请注意，划分后的时间复杂度仍然是平方阶 $O(n^2)$ ，只是复杂度中的常数项变小了。 -进一步想，**如果我们把子数组不断地再从中点划分为两个子数组**，直至子数组只剩一个元素时停止划分呢？这种思路实际上就是「归并排序」，时间复杂度为 $O(n \log n)$ 。 +进一步想，**如果我们把子数组不断地再从中点划分为两个子数组**，直至子数组只剩一个元素时停止划分呢？这种思路实际上就是“归并排序”，时间复杂度为 $O(n \log n)$ 。 -再思考，**如果我们多设置几个划分点**，将原数组平均划分为 $k$ 个子数组呢？这种情况与「桶排序」非常类似，它非常适合排序海量数据，理论上时间复杂度可以达到 $O(n + k)$ 。 +再思考，**如果我们多设置几个划分点**，将原数组平均划分为 $k$ 个子数组呢？这种情况与“桶排序”非常类似，它非常适合排序海量数据，理论上时间复杂度可以达到 $O(n + k)$ 。 ### 并行计算优化 diff --git a/docs/chapter_dynamic_programming/dp_problem_features.md b/docs/chapter_dynamic_programming/dp_problem_features.md index 60088293d..5c0c59a8a 100644 --- a/docs/chapter_dynamic_programming/dp_problem_features.md +++ b/docs/chapter_dynamic_programming/dp_problem_features.md @@ -2,9 +2,9 @@ 在上节中，我们学习了动态规划是如何通过子问题分解来求解问题的。实际上，子问题分解是一种通用的算法思路，在分治、动态规划、回溯中的侧重点不同： -- 「分治算法」递归地将原问题划分为多个相互独立的子问题，直至最小子问题，并在回溯中合并子问题的解，最终得到原问题的解。 -- 「动态规划」也对问题进行递归分解，但与分治算法的主要区别是，动态规划中的子问题是相互依赖的，在分解过程中会出现许多重叠子问题。 -- 「回溯算法」在尝试和回退中穷举所有可能的解，并通过剪枝避免不必要的搜索分支。原问题的解由一系列决策步骤构成，我们可以将每个决策步骤之前的子序列看作为一个子问题。 +- 分治算法递归地将原问题划分为多个相互独立的子问题，直至最小子问题，并在回溯中合并子问题的解，最终得到原问题的解。 +- 动态规划也对问题进行递归分解，但与分治算法的主要区别是，动态规划中的子问题是相互依赖的，在分解过程中会出现许多重叠子问题。 +- 回溯算法在尝试和回退中穷举所有可能的解，并通过剪枝避免不必要的搜索分支。原问题的解由一系列决策步骤构成，我们可以将每个决策步骤之前的子序列看作为一个子问题。 实际上，动态规划常用来求解最优化问题，它们不仅包含重叠子问题，还具有另外两大特性：最优子结构、无后效性。 @@ -26,7 +26,7 @@ $$ dp[i] = \min(dp[i-1], dp[i-2]) + cost[i] $$ -这便可以引出「最优子结构」的含义：**原问题的最优解是从子问题的最优解构建得来的**。 +这便可以引出最优子结构的含义：**原问题的最优解是从子问题的最优解构建得来的**。 本题显然具有最优子结构：我们从两个子问题最优解 $dp[i-1]$ , $dp[i-2]$ 中挑选出较优的那一个，并用它构建出原问题 $dp[i]$ 的最优解。 @@ -184,7 +184,7 @@ $$ ## 无后效性 -「无后效性」是动态规划能够有效解决问题的重要特性之一，定义为：**给定一个确定的状态，它的未来发展只与当前状态有关，而与当前状态过去所经历过的所有状态无关**。 +无后效性是动态规划能够有效解决问题的重要特性之一，定义为：**给定一个确定的状态，它的未来发展只与当前状态有关，而与当前状态过去所经历过的所有状态无关**。 以爬楼梯问题为例，给定状态 $i$ ，它会发展出状态 $i+1$ 和状态 $i+2$ ，分别对应跳 $1$ 步和跳 $2$ 步。在做出这两种选择时，我们无须考虑状态 $i$ 之前的状态，它们对状态 $i$ 的未来没有影响。 diff --git a/docs/chapter_dynamic_programming/dp_solution_pipeline.md b/docs/chapter_dynamic_programming/dp_solution_pipeline.md index a9614e4ed..89b39dc05 100644 --- a/docs/chapter_dynamic_programming/dp_solution_pipeline.md +++ b/docs/chapter_dynamic_programming/dp_solution_pipeline.md @@ -29,7 +29,7 @@ 动态规划的解题流程会因问题的性质和难度而有所不同，但通常遵循以下步骤：描述决策，定义状态，建立 $dp$ 表，推导状态转移方程，确定边界条件等。 -为了更形象地展示解题步骤，我们使用一个经典问题「最小路径和」来举例。 +为了更形象地展示解题步骤，我们使用一个经典问题“最小路径和”来举例。 !!! question diff --git a/docs/chapter_dynamic_programming/intro_to_dynamic_programming.md b/docs/chapter_dynamic_programming/intro_to_dynamic_programming.md index 5a3f646b5..910b80b90 100644 --- a/docs/chapter_dynamic_programming/intro_to_dynamic_programming.md +++ b/docs/chapter_dynamic_programming/intro_to_dynamic_programming.md @@ -1,6 +1,6 @@ # 初探动态规划 -「动态规划 Dynamic Programming」是一个重要的算法范式，它将一个问题分解为一系列更小的子问题，并通过存储子问题的解来避免重复计算，从而大幅提升时间效率。 +「动态规划 dynamic programming」是一个重要的算法范式，它将一个问题分解为一系列更小的子问题，并通过存储子问题的解来避免重复计算，从而大幅提升时间效率。 在本节中，我们从一个经典例题入手，先给出它的暴力回溯解法，观察其中包含的重叠子问题，再逐步导出更高效的动态规划解法。 @@ -239,7 +239,7 @@ $$ ![爬楼梯对应递归树](intro_to_dynamic_programming.assets/climbing_stairs_dfs_tree.png) -观察上图发现，**指数阶的时间复杂度是由于「重叠子问题」导致的**。例如：$dp[9]$ 被分解为 $dp[8]$ 和 $dp[7]$ ，$dp[8]$ 被分解为 $dp[7]$ 和 $dp[6]$ ，两者都包含子问题 $dp[7]$ 。 +观察上图发现，**指数阶的时间复杂度是由于“重叠子问题”导致的**。例如：$dp[9]$ 被分解为 $dp[8]$ 和 $dp[7]$ ，$dp[8]$ 被分解为 $dp[7]$ 和 $dp[6]$ ，两者都包含子问题 $dp[7]$ 。 以此类推，子问题中包含更小的重叠子问题，子子孙孙无穷尽也。绝大部分计算资源都浪费在这些重叠的问题上。 diff --git a/docs/chapter_dynamic_programming/unbounded_knapsack_problem.assets/unbounded_knapsack_example.png b/docs/chapter_dynamic_programming/unbounded_knapsack_problem.assets/unbounded_knapsack_example.png index 016228998a857bfef8e15d3a111c1b2471bc4ba9..17d95b8435318f3b10329f94b1fb61ef294226de 100644 GIT binary patch delta 42300 zcmc$`byQW~w>L~mNhl)HC;|ckBHaiA(%mH>9fwA8gQAEMD$?EE-57w<-6h?9=y(?# zzQ5nS&v?iCj{DqaJole7^lNrMU;NM z87@p3?s`M%viX>va(}e1CnsqMmhUMjDOj(kj537!uw!$(s1$Y+<_1IA?U4GRw!)HT;Ctat!?hDN}5gV)x z0M~i|dbH>jbdI>}!`v6EX`CRfT`|d7I?&j^C zyW)od#n#5NIqxgRUko4l7@P!@9y&^e|HX$PWI9g@Fh2`W3}I#4`RRPEA#LDa%QkI+si`fT2ikjILrio|3FZu@x0gH0yW^ z)4+#vdTX5ry6szcXZS*}(ZlUK`3AkBx;mFt=Xn3OZyOWUPi33&%@S-MG4c+eU+`Y+gwp2~Bu*m7%0U`e&TloQA>rA)(edqP;8N;DOqtX`1?BXp zF2Bhw5hP@^SZWdcLPG5?eAGT7UUxr)ga{`?4ac7E?A4eS*R$O)IL5kXpD7}X|M@0G8Lz8AL$f3d3af{JX>@; zjDviQYFzye=@|6n>)57{m~PvIg)+DV2?di!)dy)f30J1<@_uOK42oJ`V$@<)L*M0a zuxYO9aq@YE*y=~!Dd50fB$=EMOqo)LBxFC*e9ydd`Aj4f7i5%|H8(7-hJ&_JCZZ~< zJ4IITX>#A!5bg1%wf<|T;xFS(FILS`;oL@F^IBgs)m5d%2&@`dhWCDdv1~Mda@$@m z$j`-NuFw|@2TVf@9n*(mv{04lHd=D;)1YJu2?x1qhX+YQx-=-5Ys9`#Wx6D(+>Lu_ ztAWM1@6BqIv~2J7)N68c^?iWZ{^BmnPfjkLNq1%0eJw~&;UOJW;bb>5ZiL{8C?lLLQo)eGM@=#g;pHmv_K zjc1{!o#FH%s2<7`kpA?_Vt%nTGjmuo&nIoSzo{+9!!4`4g<+tHmlp$Jm=jSSq}K+S z4)SQ04+#cpQ(Vt_m&zxsRHH?~Bt@9f_g=3+1}7%W_{lto3*_&9aB-N=BtwDgh|t_% z8n8(gz8szJZ=y$|N>$E!PM_XBsJNla3td^s0}az>qHnOjR0#Vy)p%Epvz}M&(|j!8 z7nxBa;)6dPB~L|bDP8%=v=0se64e&nG>R_sv?UHHA>0Rt4q5Rr#CODz$}2GtNv z6>gOan0ligu)~HW%u)v*y&uc^+ud8JLqF61eg(c->a&TVVR5Sm2AR|DKe%+AekNp; zY4-tg-9Q<1Pc}PU(WaR{?HDf0+&-2x1okN6{Iyy*UOffgp4(TxFGB5rrisqyF#3_n zxzwjxaqrdbDb?!cJhdKkLGs8&RQ~FwEOL}v426z8Le8g_$inaH1x~mhkbU_i0X%b@ zSp;cqV?Sdb4oNj~2PztFH4{}of^DQr!}GT;@4pi2L$WPVwnCl<$9aAKa(vVTzF;=D zhRt=0Q_v&j7MB*%91u=_>9`omKD><>$_ZVUcSm@^h zFMkjHS12Kx~|RVX3oYI}<0L11qrTe+a^ZaY0(z-&xC#lHlg%+E4F%OojtJJTfgf9}ZouD}y3-Z-Wd`WRq zAEr_bE$4oe?poZ{FW67~D%v#&7a!xg6LD8VRVNZLUQ8Z+>cMT!ROk)j2|TjXk#9R= z%WQj#nH}j0&b>uWLf;J9_O1LtZ-8}-s2Z)?jM5!__6;H{lPz|5aTV>Tr@4^beI^EH z`iU=}O+AA?V>HvX>FDL8+Fp4C%m1TwTQlJ(wEXmVna^V{=jn*mC+}lwtE08?#+|wA zJ3zO=E%bW3RSA73P|(rQ9bM}g85!LVHoS%n{b}jxHz(HzRc*8cD7)51N;2eP!asku z+v|~Z-54Lqb4Xgz)6(MgI(E{ca9>K2l6uBR8Nq5$Z_*Z?m|;FrY*OR0j^cVB7G2u0 zPgG{x_4LPz@Xf2Lla|oEqR(h4TZ<$u zMT)w%jSh(FBkMBj1jAw?J-=mG>p0x^mQGJStt4e-+x1*0;EkyGn!L6$e&3VHFzMr* zdKWrkm~+n0PN0JcR}vBub-aLgIK=uM>tzk+$2pILj+as#y9Bwr=l=RbRNlKC+^D-@ z?3VqR^zpBMz=(HTKBw@-7CVc5{|aMjf$D!g*=srY_>nEzIh(FBPVjz>+sU`3rANC2 zlUGM8fn5j^a-qj)bo7Ilx}Mujn++HB)WO3?qxD`VmG-j^j*e8GTi?s9hJq>h2je8l zOrp49lhfbdR@jUUrbgu|>y4KdYlLN%58ct57M=U5%8ay8ZzuNaL--Bsu-zavo zc(47D6}6h_H#qIlj6z3k2Io7iOa)6*hs{A`F`QNl*1m~lIm~Tae}4*}?e(>{xBm&H zznmc7VuXRW+n|;i!*;)l!i4*3-ZSAQ!Kf9ihK=e~^*rq~MtpLft%@mc710CCPX5hW z5kIENC#kwzl$^=uF~$^n=U41=Ma>7ol2M;iNV$VDC&{WrO8T_uJj(ZQ`XJJUv!sSO2iK<(sis(f6B|S&MH6QDBsU}cHj31uc2HmWAO&QFk277{b6HBdP%bRaC`P(VeX5Eb)F`Nq1wbk_L|_q zxUocoG<1HnXbRUG`(z6{>k>MV?J2NLuZ0iltlX~H9F5`F@pkWP7`b=vEL&Ff_r);L zac4}q)1Ps*68gOJ*)bwv&%&*N6T0A|Hdm%ajD&#ogCy&#vxb^r8Rh;(Lf~GjJ#>ai zt%!;owDSbR9ZfGK^9H@0>6dIxq4PsyN6mtf`JC1Q-Kw4Sim5>n^EBeenu$``op-YA z^EmP}cH4LiM1l#E%l{-g8M)kMlZ>r7P|rj>Bf zTG!BiVq9k+6mz|+6u_=>gKVUO2r}b*-fvoZen1H`4(3gFk>sm(QhSW;sdCyi;eEK4;5N+$n}~6)z!VNo)Z7inX%tpbX%c z^ZCV#?C$j`TpV>l>K1Z0Z6|Bp;QqXI&&wW1GccnvLnhMZxdk_lS0;VKc?Nesf2*?S zqsyQf@H$JEk7I1yUms(#9z?Mr)z{ZvnUV>potRLmZ~39IuZQhJbj-Nap{Jo-TBjRx zobvoxd4~Pl1#M{Nr~Ys}3u|8F*7gGryldzeORspQ{iQR9ofDj!g3)Rr>ueNv%Fj-w zF6!5c+g@g2eIl9C4&i@V18vqF=r5 z)d+o66a>}kmfT%bhw}B{9FR~)uJ?8mv4YUiD~g;9$B{0dT0OC4Z!w)=$96N}VaIG~ z`cLIE zWzbVpOvI30MlO#o%r4YIYHDg)C{;^W-aH%ndpH|1B(*o50@cu_1&;Vs zpKzf;Z%1jn-)}ZXNxr3-b;T=pBke$Es|IJsa56rp%m5=i>Y=_=Jl;71SGM)HqtQ44 z7U++eZV&oXZ_=Ml_Ngo?OgfJ>jizA^OZ&gjgqnn1;9!^Cw(+ov6C-tm0Y zyN(eeK9mSUC#Iu}jEscRE9^7n`PR&~glH@%?w9&?t8If>VYregKD@$UvU%(}N zx+PYZ!&;|TdbjDwaxD)j0)U$osuw|O{2)z&KQIs5DyrcbN-K9VD8ZEfxCmYgsj zs!6X~CZeFQsm~deUe%jDj+GXvBd`nbiGSd@UN%&J08M&i7o7WA*;#mco_-`^Ds>M% z_Z0?{;GS>_m3g!_aPuu7aq`68-vnoKFcMLNMeRnl^Qx0PdNZuytlWBi(bdo$1W9eO z_T0+zPiz|PgRYO+*p#A^%H1NMvpC7Mw43y}UTaRQa(MT;UELd)Ka8KoKrfRjj zOHM+m-LsHn!iiKG_o4aX-nSdLeWY6Ez5xyjZo1ZCOnPOT1Ji+IeCU+oc!))S>o)4% z`dND`*AIx5Ny?0?~twGu$cXja-8hENJ-TSBZ;LG3Z@Dg&Mk!&G<>Qv68%wgsD>Gh6{uN*-qiMDu;9R_Z3UOPIT;RB-r#)NRmmPU z;Z1NkGZ*^Zi-aVCB=!86>N5%t?ouu(1mGpOb(ux=$m%{s!H^IUON0h+GM-V@xxUBB9Nx7DSCuepWRPpDk1;6_Ft7WwFhx~r`O2d8c2c^Q_5A0qM4 z!#v$Bry62`+OWLRdv|WjVabml{hs>Tn_T;&_SfOB^NAbpg`_<~dyOQ6m-TGeuo1&o zEI_lohqS4Wl%lUENQ{WhNGNJpH+iaz%aHA!DS1DW^49^~fbe#sx*IH)Sw^@RiDYbdCoD7 zt23niE=PKga=bKK?>gWEywr{yymxo*_zH6CG7=CHdi8h9AFJppsz(}xf4!UVjg<8h z-TK$fhI2s$x6fI%WEFW<(Ibxqc~cmR>oYiDy8!ybZJ*xV#V>X zO7U!xv({wCF7=cIK5kAyw(c~gzS3O@XV_HEvuT$3N5_H=nr(?SzY())BtcQqX69pJ zk_kZ_C=r2Emh6Ikp4R}+myX^PnCT^1mt($4#C0Die%3hc!05}6(=E4{*k4-8R9`2< zy*ECe`q%3=6zW;`i)qo?fX8ArUG1Iru2zn|#bkkmP~XAo*UcLPmk$Fx*3TB|TL2}& z0ZKwd=IiwBfiLNe#+$w_J+5!E5sPz`=3dU}E(n&6t17ODH1(PjXcPzT&thqv{qf2T zkx(GS?JBhZ80^SXm_Vd7SKI;kAjTpv+MV*JlfH3i2ncZHC%*2n+1jh zFS^cy<&}T3{rv)wwevF`A>1qQ3V0f2YTo+tekRF+)RR_g)2v*n~%K<~~B zx|LaJtM$cr#er?Rmg5Eb#e?H{t2YQJMk|73t@IhOMASQI+OJB3K7M4`{l=op-B)|O zT_W_G^^Z^5 zb_ZoAijChUk8lO?Q;d3xNowBkB99M@& zt>->{i104E46vsBV{zJ7DD8Qwh`q&MR-F3i%B7gonRQcij%98(7KXy7UVM1t;SEQB zSYczIp_1ca$_)G!E{?*Ryw|HL2g209S&cX7UvDdeM;&LdUf2!)r7=o2Rwa}>?qF)g z%2k%q>PbmBQ|l>kiR(G&ZAAHp)({0AO3cNlc10$Au=f3RIQJJ-V$x%h30H+wO)WHm zIIyjAEU_*K>WjA8-z*N=ZHV69*p#Usvi_Tmcb^Keye&A-)zsBZO-ulCY-(;^5j0(7 z;^WhXR`uZAQ(9uZ+Xm>2A1)UK5QHOct5l~;)ro?Q>UwyVgJ+2g6AcNwMN#ZChhy?f zyzQehh=d2(4D(T;ns}{#!I8d_QW8`;31?(wJ$NnP4jU_HcJzts8Sh5{AbZK|yH!D* z3qbH@uU_>Zzg(oG4!56e#-$YC5fl`3Vul+#9qr72y35>~_fx;leR`RV7!C{NyvD&i9d4V^hezF!zh#s^z3k|SF0QlF5!FqO_l7u(=L_z? z)-Yk!DsoHGnx1(E-9N@PY+||EG%YyYsB4FG>2EO6hz~(p=8sPmA0A!~#_{djx9NA| z5huG{!c$%c6H-!A2Hr<$lQ}4gOCD{^6>|#<+UV6T>&M_C4KgmBd5YL>Zt3?j;g5@k ziew^KKs_vL#rBiYD1jyy#pZ5?*Z)Id;#>%WR z&L{6OYe&L4PX;*2k54um8USDO*bih`O?3vI+wUBlT9TfjOw)Xvf_Rk0&xG@f852>bPBC9M1z1(Ij{iPV%%DIWJ>uS#Dh=`1HDH}^m zC(OIfrj|*MiO4w2KfA3R!&e(lHu#xS3j%U;)bo^u?K0%!a{H>E7)}ru4%NBsF6=IJ z=#-cS3939RPKT7atp?Y&e&SawV#v|J%(SZ93{9m&ZS(MB5;$!nw>PSm_Mdt$fAiyL zAm_T~`;w3Z8(FNKve#UYna=^E78@Pyel#CZGx0+m0$-@Br~6h$4_dYDE7%TCdlY7? zbJ>m*r&Vp{RZJ?s@C4f>D#jG~;-_vyURV+Iir^lZ)eUF4WCMy%wP!M^^SPZQTZ^mm z^{(ynRHZh$DP%01fuZXOqNE6)S_DTje}P=qEtDj*JJ}Y4Y0|px%V`T=n}F|rc7HtO zx!a-W&+C<-DRi>NKA@ap*P-^EBUq#B!|_54>@+)H68=cC%^>RNV{3B=)l?1Sx(RBt z`dwnm>690av|?Sn`!S?6pxsGeY>Rv^DU$;2*L0GF#t z8$mH%A!+V+42&8gA#2f4i@$cGe>;7nfd~$s1@nV>?KT68{`|W`6U8Q*Le_th`rGhk`NJ?mkKIP8AOToU-9UwyW)dZAE(fe8KVF za$k|LWSWg5?l2km-yCPqrDV~AksLyA6Q36 zM+=mKdJv5_QqE2NTO)^< zf@mT|Zi+JRSXDlTNKM(?x@{NNTV8>){RI!_$P0OnR)HF>U2IR}!s>U%bR=Xa_n76g z_fPL2@KYm%jPm%+ypKdGHfF!-bVh==vJ(2kkF<9-qY6maO&{$73U6p(K*K<<&yhDX z_Q*~f?uSpox0iZR7yei)nGtaM>Lek;=ap)D6GDpGAwoN==Vf$CG3dEF`EpCajTElq zNo55by1G5E+2){wuP8^+DEXeWjDuEl#H9Ll#79uICp>%Wcrqm==+|ol(Hagu?Sj%f z1{HRLIPZsM$L9WJV?YPGm-W6>)p^gFl@{Oc9QEakVe?OKkBP#p;m4oF zt+W_aKIt)dvk$%FVrZB8Q5~=~A7S9K+&ll9CWK=*LpI8Yb^1mHfwSr!zx$r~1f+9o z`jU~O$Cr>0LOZ0aaqxb6XDoZOLOCUl&~w|yB(3QF7&jpgjm^*pbMYS?WF#i@HR%|{ zME974x%l)dTik}PEg1kZ3wdj`6+aOo6hitNTI}jpJRJ$b264{OIa*EjcwJlxIP)4( zf^^cW#;a%GFfHHYTZn{=@8HL<`*k!Wbkq^j$tsGrnRCJ>$Mq-QS+F0+aoI$ht_uM+ z#AA1friOCIC5W-l#7)AfD9P3!Z$DQU+Y8RfxD7|r_(n1r7qfCcFvZp*aoU-dq$XmV z8c}OmN@4jcL&MF~;;bC-WW9=mNe2+G2s%EY=Had9=oY5U^$5J#|-qv4Gil(7u?d>xM|Q`lhVlj zTZ?tqpyItCw=DbZ8BdBI?(2^@25t5QZ~wU&5|*<3z2j>T`oZD;4x$R%*aOZq{%SW+ zAm)S!G8ubwz9-4E+$O+WpPf(64yMdH zqSGEks|Y&G{cbE?fo%@tM1);((DKn7f5tg5k_!M7+?xJw+8O6MX+bYO>5%hOsrLJ$ z$6O9B_o|L0a_DL#c&w@mP+p$($UG}Z$5@3Xbnj^Ml44R2ui}IWG6lT}ldx=IROrM* zgvke&GL_#jF-wq9o@j{Bc))q)kx_3vmy~4Huhr}+Fs;U;5;~3d*a%=FzB}45M5vW8 zm@Y?lg07*iz7nOp&=wtV)^KxbYX8UYG0ry`#xp@*QsgP{{%U>-%mf|{lG)6`*ujX?s4x4l~p77KVZQy+^ zKv`$ya91pG)t=130@Q69(4G1UB||9TC!}$1&c8KA@`Et$S=~9_h+WMQbzj-+bT07J zt9M`i-heJ%UvB`%k6~rLn>SF{uGHQ7XKaOxqN5rGsV3AWlmu!anWU?UKW0Km~QUcPw`8>ITF=n-m$LdnAKo~-`I>De>FEpg5Fd!^hQ1XhG@jX24lMcVyZk! zKG6N{tG#;}(WkY2@4gLujQcwONxAJop8Wu|^U$H0FGt5-kPDY2j}=d8y#K2^q(sa0 zPZwmwQbJt>$J@%hRmm^$N#n?+Yu9*XQCyx}J|}3}L0ir!t8OpSOll&0xDsxXQ!VPO zNwYRJN1x?rSbp8C%lt+BB%(>`Ue9*Doc{HA{*#JFm#O>sF-`WD&F>A^_I)nF(4b22 zpe^CXPv&ttki0IDkQ zfS2;O2Q|&}zNSUEMAdz_@!uE^#S0^WQYyYU_$diENBD%htAER3s9)I8h;j6cS$QBo z!h5du#V+(_%Jz4OxAGfADGOHv+#pEA7^Ya4Wxm3L<8rB-1OLbD6e6(m^*MGvskc?-V%ypAlF`>< zWqyyp-bc7lE9$Y!cRvDf3klp9m+I#5xear3Zkio-3pI$^^EAiW+u{G2`kMh$;Dq zBmym1sCtA69Rj9a`og7P1IZ!UWq)r9*?iaQdIts7vigk0WEQ3v^a zGdJ(vJOZ8bJV9w-rZo5qf9U2o)-rFax0gVxFj?ZYUX1F<;CW4CePIy6w|fPZlWAO) z+oqrT%8d<~F4`!jVU(`tANX02%}hqc?oRgGoQ*wC@V2f=B9?6VRT=2Ff*{!xt$=F6 zO0F3h;jn9v@4Hpg6|vCS+x)M}Rg;$v=IgC8whgYr?{TceRP7J44-Fzb|~<>|JCGlT4o*ePO`eJD?-!pmc;>>Vk$?Rc%*t_X5S z3r)NDr@MfPfP-S6%~-jw$#^V)r6A#-$<578my6j48V#vXx+G2@;Q&=Q?$=w>dwYA` zw0cYpwqw$NoPJwVQV^*DS*d_)97Ssl#4Efntl}sXS)XUHn%Ng@0UgsiVUBsdKvdaY z0zcc8yHrtu9DOSWR!>se3DBK8P#(P5aPVAcxH#JcH3%+qPS)zBWHQ^z@308bDIMD? zT5j&4*3HqfRlxD<*=(7Hx!M^4^aJ#t2VZGDoWubdF=>xvBY{Xr)YMLg3?MaMV*S^D zLCz>EEuEbm88gqlU>cBS;%;2$QM}9asqO8fEV0+p;cWA9xr@TAWaD{%-bK7}+6szT zK)@p;lyoHICsSx>=%RlRp|O=&=u!C1DW}5uZPIgSEh;;CnltH=&7T2^K`p~3Mc!DXE2CpBMx69PcE|xozDx5 zE+35CPsk;%e@r%Bwv7&1I(6UoxbyO=UVwxgfmMhZ-bNY=HbLVgmih2*s#K^`@GTmN z$ew~;LV9_Qu4DL+!REv=&H2)7Fu(kPy1w_33DdD!*taZ;M(Ot0Wu0b*EfbfER`$Y% z3C2Lk(>kyKXJ{6FENgUdxarY9ieA)A$;J%1m24OP!61=_e$h_o z5R<_7_X;PSZ8(S^C<}sc^KuidKPqcJ+9?Q7$P#)yGulhV3%?VkZ?v!P1_pXqr8y#-_RZ>#&MQ0pqys=@Tvbgo?eS2AB@lkoWCgL@20y z28eXrJXwlcB8i=7T-IBHAJmx0ta_|>Q(<-RaM2k+e{_v=;Pj6y@2BA>CDkzg8TMt_LwclIV9K~X zIdpb*^wsgLFt@ri{i!Xqy06K`?;(@5=(jctXl@7Ur0hfDXH$~Eq78fB$0}Ijh*EEA zAuP%x<0D=eI}qQ0!#5i1@%YixHpY8{GF|aU01kIxrkXC=z04ZmH!y9wb8|Iqxjwqn z(ja0u5SDkp-t=ITNJBR%Lr9S2o+NKB*G2_GE1*(ogWcriRCj>vA0d1As%4(lYjOnEgRM$AcTSyPX;F z?$SMR$z@?okcPhNgfm#0Dn}}hwW8{yKum!)pbTTJ+v_C*EZT(Y)PQc^B|$n|XqfFE zU$YBzQ^QQEnwps%bFZeXW#3u4yBCJL_U`nkMAAyG2Le%c*Au-=W-WL_z$Tg)+O;YNt?Sp`&mTb#t`&Q+Xc_>cG}V z%W?*7dX2RK2PqyTG_YMzyCW^vHB;%}9=pjoq?|#2XH0 za6FtlzIQEjn|mA-v}T5?Y~qq~6h^qZ@$vI}^k*uOF6MskiqLb3N@xZ(Sd;{BRW+nQ zPa|FB&3)8YhpUWJGim{PIuD)3j6d&^;Kodpm>s|*WXJi(2BX$=T4ksv3;QS0M&{GH zVEPtaN_>nA`ODox6Hj{~D1N&))Zo-+e?|BdyD;DipolyN@?uG+UHk3J6pR(B&w+j{FbNAAL{-Nm%7vJ@LUcPu zB>f!~^20yY2CN*sW}DergrzqJWvt9Ieyy>UEC+B2vcSfhAAg=@xUf8-%PG8lQDL}z zH{{~+!Hq@oyK!F?7Z@%!i$E4@gjg%KE67D9I-e?4v3e$;i@t)$V zDoR2a=_bS3YE0~TBN_}g?64rULy^zu+Bb2MxYOjY4>Ca@C z*)%^FH~G~Z6B9?MLTNeBF`5Sb;*=Y6mKujQaqWWW@JiRouU9xfQcF>toQTNFXwz}s z|C$A+?nPg^uK#ADBJbYf)JAUm=(jqZ`US#v*2})FJ=*F%^M$J;D|v5?7a}D^+QZ@tn(EaiGM~9AkKlx-K zDr4vJ zi(YLU%J9-#VNg(Lt=w8#J$Ur<#$|ekgz|;8@MI7+H}sAa2rxNO44|{Jcujuu?nGJ{ zm!PQr(t%5i=sp}0EHE3$p3OU%R0BWF0DwUkI)h`sg*q55SF()Q^8)iad{Hq*SK~f^ ze)8%!0lTD%PKV$7)y^n($z^~cC-jHkS#$&s9vgo2<}7gq&=G7ZH34hLt!}dW@k-`R zZ6vo)aUmLodvOF2rFE&(N5Vq8s;a*#{#f%aoJKZ#+%%nBVX(SQCj6M@a6R(7jJJVG zwMUf$1V84g+b#W;!Uqrw`-%Tij0OYS%wa`!nk71AcBMC<1L=WSq};~gk3na6_Fd^4bnVfcGVp=+$uBgL zH`H}q@4CZRh$3P0szgXRNIU7up90G@@F?NEuJ|mi`nxl8T?N7pnw}@kdGQx2`^Hn> z+V!o%EpA6_dDbw-DagZi^z`=!LBtV{Mx4`SoHM~E4ry4O30X)0knNsEQhd0eo{ zo9mi19^r>7AXtRAC3w>hZbAz+w~x<$dTQ8oOo@x0O3XaDmHpP|Eqec1j#<&lNI4+y zC##)vD3wwuUj~h;Eu8?NGH>NfQcgNsHGQnzo58YPBMs~^CrJ^(##VvN+TA<$=#)8H z-`#Bs@0FQGJ}lELqRWM{FLaqGPjHj*1O~TxN$YYk82mFA%7*mGD#=UhP63q7r(2q8 zXrL^#?$RK2!%3B!eQT6#bT>by%CKcHjF$}0YJm4XCxi2ggJC+0G#M_n@NYV_Z|QEN zajt}pi%>M+vMx>S<@e1*b9N`1!_U0y?Y_1itiNs_pr2^EIC%ywBeWcuizv};DNOw} zXKBdh3o>WqN~1|ikiETq^jx~@*?xKi(aqJDY4A?S4_=#AC4gp0n+P4cqvgzS3of^4 zPgSa$*}XC>%GIk;H?&*qj4N}oFLUl+NA1W`=gDYc*cB_*&gXmVQyXx!O;zB$@z7 zUM^ogBF(V6!=`QgrN51QR-&@w_84&9bg_bR+?aRg1n}eYQipv7h{<&R?qbd>WzW{M zmPvukv8<#JBUVIYfvW?()Fc-!@q5IvtcU%Yv9%%UXtI)I^V_#|?XfC1OVbe3^)a(@ z^Dp69LVx{+4}pO3nbvmrk6O;En7d{LTJa^{PsQ)Iejpu&f7=bIrlTpd*V89lL}Xwu zFR&p3q)h|ZwU)ydl~GYM`eJsx%UgeIAe@5C(&2u<_8&HP+wOthYa}&9(S6)TN(L!dURA<(v(xD1e!L%++#o_H+3e+`lP*jVJXg zqCC(}e2@I33pscRQeT)s1eq=3rT!U$Gd4$=)=!_LcVq-<*?QRiU|D1ZET5;1TvtNn zK+0%qX|r-A-2s%vugZsK_F8FKEQnF5VIRhC|C1RZR^@W#TL7NnuMfzgM*IqasR152?Z_-j1td@88It_EZzWt#({ASm}Q_3A=;fYp@VTp`AjV5>(h_|Ok~5{ z%u*`^{SdvHk{d4qVaUseLeq}`pDD>n9~Pj9{9aMQ{HOiMKVt^x4Q=BC%`XG`y3GH1 zHX@PWmWDs<@BJ@dzXHWlNp%nVvVY&=>R*O{+VIC}G5lY?{z5APA(3mXHx2w}EfuC8 z1E8$v$o&zND>(QN7d{UMUjM3$SmTP;``6dh1b~jPi?k#E_q4A5MxX^o`TsL|=-+qo z5&5qV|Gz!@%YMB7#_<2!qlf+{jSohDt%n0}=6}HW!1mDpr1636q5m<@N4UtNAk&IyyNa3KD3l=?pri7#VNGMS z0144+6q)BQ5O&-F`4x z_ifG&9AJrbC=2*HtCF@LI};TZmBUNDJb!@#8q;T0&C!kx{F}zNw^y0{I8Vs}`zkc| zm-%>Ou8QB&9mjCDBjCW=sMXU=XMLG|m; z)d6nFlz30m{|QrNx$QSeB;PYu5&W%l?nOdC0uG|A=ujW$m62jxCQK(vB5Z{lsv9l% zb1C3-_O%0(`KdH}4|M7#pagnOCP1T}mwg`u$+K1Mz!oBfkK5 zFc|oMypN<$lGEQz`%9DBC88fLdnM}lbV(vXzKlT5k&|i&8o$ZykgIRuy(YA~EOUt5 zLpfev-+ujr=d;-5$h|-db8W#pUSX8W(-A}T`nc;yMGoI6zzAxj1(y&2jVbk`SNFj? z2M8XqvKHV+eCNEX#QWWE?Am(L&4UKk=q*?yZ;=HW(A`3g><;1oxH5-GqBrIid#!gV zss=z9=iuNxe_)NMO8_%suGJy+`5a7sW(QA+0|;k`mw_G_ijUwWiX8>D1NOi0kFOw@ z4(O4;W{fZ0iUsW+x*qYzSiowpXadj@{EQb=EBgbGax(g{AR78-m!?fb68?ivEkp(C zLuvp-XwZs*CKU1)$j7*N*WJVY@4!!1MZY+LAy8Znf$dSoRSgz_axSZ}nF(Or@DjaB z#($0Hin#XW1A?A>V?}xYe|9=TpP(p=4gu#jtFco9F2IH&E-nrTi_4yfdm6bZ<*+Hr z*VCXuG*^!ky88{An3xzN-fS>etGaxAe7sTbIw1h&VY&0c*)T5aDGFw#;`HUKH;PSU zaGByk>+XD*#$e$VH&BT+lfj%;`j@FL4kdB%**?wB&rdiH>1ji>Y8aGG-OmP#*v&dU zcmB|qflj>hzIYhXmW=gq;oto+SjeYO9;>~3nt9%mM#c_*!<5N2X$P!WDG7LY zK^r-_TOy6G&)`Eq_<9>fH02#@)!f%c6m0to(D2ph=@DG*NW?qln7jA+zF4R5g{PGY zmUxDN7d-4XsE`B;UaUd|4f>$9C~9}uI7IN`bQiq4Wgo@c!kOj*%&&EAqUOLPLeF$+ z74F{A0ZLs>@dbOh+~an?Zb=@RY@DS_yj`8)q|~WE{rdGQp3vcRC%?f;9G*bc4-X>! z!k6EB(`1MmbM$W9yqEYyXo&)Qzyy@+K7lsQBBOVmgMhk?hXg&chXl7u|Gk*^L5L8W zE(8u7OSc8osp+Yyewks_uikD<0C}2=i%Yj&D+g-ro4A5RlhPJe=!YLx^jXZ8FZOFi zE!s8e1^Q=z(YM^~m0^wJbIzXm$!6Rvu+@nA%vf|c69{>iqlpL@kp>COS5>7WOWr^O z%XyXk@dc$Vv)gSWCvqJ+-V0G?Yi8#_MdUPUJ5gXmWUFh7JKe zv(-?(nykl4Rz|cx(^HL*%wut#3R|0C&Cd4r+QoQ}JA914)QI!n7{cd|y#_sim?t73 zVG0y{X+i{g`9hMd*z=HoN|#!X^iK9<;}1lgb*9L@8(C1ad>5^Z{g~i^=E<@bIj;_0)-m&bcF6aDdNd=Q z>Rygp$qMN}jh3>b`M`EAQ4$fMB>@~LV=bMNvwapupzJBNfXiCz8V7zAD0H61`|p9R z8&lKn8uu4ed@2?rEtr1yTc94i@9g0%ds+5Af@x_0ey}-ZFi*5(`JtH8Ru})(Q`DDU zpUcQyK~LQ$*7{-4P#-pAqN7xLT$hKWIh&lP5aGk?tTp>{peWZ{OHMv(7)dnXG7HPIqKm_0C(sjVd=hMt%7M!6$Hjmo&YZeJGO_x?i~(SlZ7?0(9f zyOznhf)W(M-n9#7mTUGgTs9l^C$?~;v9?P|G~aWtnPQkM#8*(#$r{KGKE?nCxI>yelySO-$oJ#Gj?5`L(*Awf^wO_;{&BXjJ#1 z8G8~?N7lrEnyc5zei@4blU|g`uN@!)kFfxb@iVs6Hk{-v`Ute=6CxK%edh=J?DEJ| z1x+Wq%(u|NIr|3v&etdz5p=yV-ses2JaT&9NJYs@BPIT7pF#P)=y$5nO&KNo)Hyo_ zM$@DkfZ(!sA@SMU{F)6u@%|N#@|FSZIjvPuhH};6+z-cp{i)QSo{4oP1d+cIX;ga-@(Nk zk`XI&zR`4H>J5Re;EsT9(tYbNRnfD>eYxuz1~_Cf0h%D-0R?p555$$AzMNa%@`SMu zyk!B12flBLG}U3#UF!4?=QV1yG&Rlli&uIi7nV%mHQD|uUF3t7&7?PT&8YRfkLLF= z=ot3&svOcJY^@3?1Nt)*s08~pz8{rZ^g(;}(F8eSr$QPi?AAl-5xy*sjiT(j!U55U9ag zr@EeCju)gZTo`5{9|UpLKm&H967|+2PaO+B9ytr?NPhVjqFDp+&IK1N$utMDprVGF zGHd>zvT~_~`~$VlhI2S8dgI4dj#wV^SD9ZbzeW_X`M`zG3y2^h z0VavEPQ}orAx3Lj+seN;-t|S}TFq->;remUci_;OyJ!s zlz#fFLj~Ndvb69+BmNINoc$v=eLDWGn*Q3DN-{sPUbaZuqVoHl$BY~zG*%hoaB=YB;%Gps~*HEsGPxe z)H7#VO!BAf4fS?(bnGB+Skj1!#?QS!BAq!k#wXq6q&*-S>I=%~HU+_Tk!ta1*Siv- zhB6lg-L*U_B80Zkz=8Ro-0lnTmWq^82^!GJP$QkmJ^WF1z#}WFVuhtV*+6D)(qnTS zyp5%dgzx|1?JdKq>iYFjKtw=AIs`@O4(Uee5Co(fq#Hz#nji>BN_R_lcSuTimvndc z8B3r2?)|>|oDb(*|Lc5PFy~rx%u&C(?|Y;e-5FzAt-l)6DkU6tLJE!0p7ug|E&zlr z%K35%x_|@I4{ES}_7y;7BxiVfiWSRAavxZh)YreC#ugY9VE51_j}}?XYBN1l31+J} zYl60Pn^(8B?eB7;6CWDjj@=;VF7y!nqjUl+UJjVUxuGzER6K?CNMDpHZGM(HQWKuG zOK}Yeo8XkoK*6agM)o%>N*ZRD^ZguTx2qiv`fiO;trM-BEfv0cMI7WyUrpwxL#A@ACZm2>IJH6p zpog@XJIN0Mh(mc#sP~jodUA2EnwJD$j0g1Ov3z`nrbmlYE_Xysp>LnddA@7N@_^6# za^+x4?&a@72xnubp$Prx++zJpuAtJMFFRN>Mk*Hc$kq3h<`Sn?si#De=5lAIy0jYb z8WNh6@^Yn1uapDHnM(sQRMa~{|FxRlfT+ReR2O8tImMCzjtKa_EYOzzV~??nH+kI* zwbC|)?Yj)x4H~jELz}&^Kh!LG?cdOgt|)H8!}^Y6_2w##4P(W@N; zt27aHIApHHlMN+urmJI)VP&#@(X2n;OuYj@?YuDK@bU^_Wr49Chcp}o5;)Z5j@i>?Ir;`cJI*6iV?>Xc)4^ho0dj^g^$PF@hrWm$1 zd&PFJqy)J*OG(6<<*$%xJIQHr|B z6u9Z^%4_lJ$v^0K>I#_v_B!{-Y><(8b69A`@*SnMscDX$PJXn3W@w-FT7rW&XV+iP z>d&OPWgxa4d*ccY+;J)1W5gd&?g(S z8{fy~HxWtacfB;m&yRe{zY?yHcPsJr!=|}Lm34|z%TSdD?WM(F>er0K*!m1^rNU$* zr3{($j)%1Ghq1n4+tU^u(`FwuL25x#DH+^Mu()+&ICCE0_&m}e`*0GA`#Xw!gcALY zqo0p4P?3RCx^+gK!f}t7GcWhCtN62BK0uRb;f&i=SjTDiAo|M{22(v6L9S-LkOBGT zd4{$t0MAb!4>208)}m79J5Z<|1il7YA!=nSheLhrA|Rdb_&!rUW-&4vnOf%`2FKA!?l;sU4GIt{t1TeQ3)P9!yQ~0!~O#C zk#z*11LwxZb^Uuvc^3zS5LVL)cK_V=cROrS1l?I+Y6;Q&do86(8N~JV7P5aq$p5vs z!z;sx={eQebpK^WVIJ;_-&&w{bXLK~_8-J_z?k07Sj?kNwYa-G!-(nArz3xW z>wg0}ctill{{PbK|6{F&{`HE88viev4O%Ujmuo8ZSM3vEuVWA*B5da9y)hJ@54XnP z{80My?)EPM?pc${_8)c!0%C>L-1)D8*Taq1WI9g>>>0m9>#7kN4ZPJZs&z&}vq=do ze+G|J1dIYTy#(K%)@_Elk8indjcrLje8_XkSI4gz#ZpL~Q^MPz7p7W?*zc59G8A+2 z&m)}y1$MojVj1yo=OZHb5ZsN{d_7`#cJ#(Dmp#`Ok715m-)zCV#4mKYstm$4d4^`f zo@`_5@9y~vS>eT4E#D^OBTBe381Z#3Yvj&gAC`^%+e`#hMhv|Y{IdWNIttTi1No08*+~#W zTwff~($F9{>_GkTi;IhZB)YRD8-KWQ)yrdV!kj$bXvBATTW4fw6<=l9ak$-VpIgaz zslUTfDAVZB*RFkb_*7C#3V;mH4$17@&KKMK&+f(<+iUe5L?k&n-sA4g<=M~xG+TQB z!E665^?WGq^XJd6&vu8U*$x2S=k|Q*$(90zY~uA26f6)K90Hg6nkrJf`<{*Of*Jw|VbUh^n1rjclrP~L1 z=NZ~TcnlhjAk8t_u(ru&2Y0oG8RUbM-fw~Vb(1APEyyAj! zx@c1IS&awQ2h+|5#iDTV@)KFo`oFf!$DfE-SB~r{$S)D1nL3CTuHL&jG^?t1yKw?o z>MV8uPXxTBSrDW!L(I%RP;V;r&*^!I_rMFfIsz3JuetxRb3ep}WcLnJs#>VTCDG>qUKHag-@ca>qoQ<@?Pd{-+iC5n`f!KZ;ahb z3qIw^|A2i%Q~EZJ-L1BH`Z!NT;qoMS#SZUtX{E`giFCK2jSq2bT+HH$qgn^YW<|m0 z)5w)+eN?H?G+yfB4I6?7#H?A6b8whms@dgTVT0PGD0NW}5HhOeK0rl9&666ncxEq? zk(n7cFGxEt$!a=6#m}!5x9J7}IC0+f6vc?3-wMbIzah$cZqio&^l{3bmga%?Ij5O& zStV1=A>=^7``LSMzG{3*y~XQxbj$f1CIV#C22zWb0+RFccE1GApxxP>i<0KKEN$cXMRNJmVcURi8u2{E#>jsmSGK-2B$olRu z_gO5?^T88}%W@TQfO9arZ+b~wWag0tglRb?euI_pWP7?;`CZ5kd6b4;|AEw&vhK+y zmBMTs0Q`(;K`h&>_Wmx5o9pf%82XWsp?1Trw2+K)V(qi#|_7YRU%k`HBIFq$Ud^`bJ6OyFy3-#aW|Ob=}?0b_P;B zRaNS(H+?IJjb-E7MzGi%b~Wm!9b!yQR@p3PCc3OZ!fc+?=;T?ponqrE(hl;FM-3S* zdU;>z8OjYqfhE<+!R6!T5sd+mTDbyp1fzlXM9iKNTb>+mMtZ~w$;H$_v!}AhwIKNs zs5wsgX?sGBgTgEC^>#4tp*VncwO~tgXzbzjB|{GHr9XDD zrC64$WR68%$)vwRx@od_wncoY6YQtPW9ED>+W*{7`k+|p10BEj~s##^2j=bZ1g@t4Q7)s6-#o0USVbC*!;kq z1^)MsW0*)Bp7_;$(9Df5Pm6M12z#dIw}8Aj$6LX2c25dcb9o!J0nN?zQipf6ex(kO zPL8Qx<>b0!D_3Cqqpo=qTJG~qH%w@h8HaF>vD(Qm6uiOE47j9ZBU9f4G$t4g z!t^QyXNx1E4v+VeO%{ju@@BpRTAyeg_Gv9My=@G52W?#$?x11BAkVu&%OFS|SvTGi z>?F1yksHg1iGF3^hgm}k@UoeywjUYWyAF8BtQEA~W>@6wXvgXS9P|W7UN-v;zkNC` zF76!2gS_5bMNFg=moYHN*ZjDcJAC==B2e3sDt+Kr7&JwRL-7) z2|(*Lmhi$pW%>;1ZEnmpMgLZZ_yC-Wwx+99{+?&U^kwDV_~%^d8zBX@lP3bLHxG{_ zS;v~TWeX&dpC3buov`?mrPG6aZM`<}p98@5%Xr>SZ zXJ0A%>zFv60yfx>Uq7ZkkDp@EXmT$&w5V@=%czxIJlTBI8I@SdL-|UfCi};_GJN8# z=DHb_eCsm06s;d5x1NqM2%!B6h*>XZ#*`~p%L5KpDI*GfvyUHBaA?O)5gLSdINvqa zv%r`BpxHayaaGdM(NTHe1wV<0;!lT?iXey4>W<1lm#Xugy*NkmDqP^ex9 z-03WmqWGa>p??>{m~{B=8Uv5yJz0Bock03d8JXs6&NWnCeLCCOt$d!y190m3b2XLO z^A`{mn?D(-8>t^;X?CW>J ziH^jde+Z(c?^;>wVWb^L$Sl{Kj1l7mnTQxpq1HnO{oR@BHe5fh0^(6>m@?By*NnOEJSLp=ii*>Kap)p^+U6o=Y#H!yV6 zGNmjb97Qp2Y{HgU-Cme~ci?=>yAx0B-L=&>GGXRL_Jf?qqPD)s2~P>WA)Xq2m;h*E zsinL)5g(Qj0MAC*R_SMo_OTDL(L3hZDH}%Lu}4cgOYvwcXyMv4*S)>IfS5%vUE7|@ zJXd&?`^sK^jR{#ZF;Y-0!k8dxeE*Of>scFR>vt_VZ&_>%j6VNd73LQ#jh+X@AmK%7Q7`;xe`+!vr^mM)?~71tG7^b87FcnzPgG$D^!_iSe~n> zI1Sq1k=ed$x^yP;p)RnT?%;O61M zoPzaym9_89J=FcSAiV&B^MhInr^)2aC^c!seXjK#;VU;uK?F?vMhFqRY3Xc|%N9jE z86JW2bNeOV9Jbl}rTfn$B4<7-NNCX>kOc_7`jCofYbgKb@d9wxp15X>G{=`onlh0O z^`$%Rpg7DSuXN@0n54 zOe&)IeShWBVO$%WXWb$6D3N(^-ZUOxTg=>jy6cb|axi+}vG9TmAWk_Y+NGBbu0e(|GuP(|v!`n0JQuQq8De$4Ju>d$rqhplv(m zJ;6cJ_ZdVoSu^)R8P##^5xRm~Wepn<;RzCCto8*{f1Q|(rrN}$Ckl@~w&pzuejatc zt+ujQ#B+t)UNUzpIb9M&A8BtXXQD1uTj-3|{%#qvnf7liFn4rJ*B`ajZnk8EJ|$=G zPKvMS#hok{vBEj*zQ=TC+;3Typ|Im%-tw9x(hcww;=>|Oe)v*ynYS+cHGKb2q2BRT zfkXXPxPr_ALAvhm#K-L)TquYOZ5z^iUVD8A3`J~RRR5WyFLR;PG5?@hmBr#`E0*`- zOc`DyBzCJ}K#ACbkOwET{8n5L0V~2C!7-Izbx#T`&liF!8OU3&Sc&SEQvCeL@S)+6re|}_YGwM^(tI<7o%{u>ZD9qJH?2LqRF+UaonSE@M22*JQKa&Lt2GMXkN*B`2>*)D%oP2 zmG{QW^_Wv-_Tl2Ah?Ri?r+Bi9^+Z8Mzuk^*lfVbeHir6Rd43eqo@J2{R53W?AFn2V zK||s27!1Q?=NZi2@lp_L=*@EOFYJ3*sC3uu7WiwXZWNp=hTY3Un)OGW8@V4FXX+KS zuhgjV+cN0RG5kFqpkZ6h55dC+IPYVAI@`$l*rzgB{#n~u0`VkE?h32L1hFJY@7ilg z-Rt(l+)Imo!Y>tl^FUUo49V`3IE5ik1GII`bRi{gK}K!(yh5)6D_F0miaDx7yVSHC z`8rW^#ND@T9tMKyn7b`ax(QJ0=`DW4sh%(}Q0pqtV((C~gT@~sruOO0)SLBxdw z(PY8E;lgXN9x%5H`dK_6R1RgO6K&gJiBp(*t0Jdz(A{2FSFI;Qjnh;YClB!j=&1Tj zn#5K2lu^rNTba_t+v~{0kWCbLd!BUSt9^D@OOIg{qiG2Q9Lu(Kf}js9(#m429)Mur392TIxIMSC+7NWdWlZNIj= zxOVKucEuF)rFX7H)tj(m8Xz(kLW~x~D81FxPmJY-i(OJ4+m;d`SZY~i47r~V2HU*4 z`%|7{8M8K91)6*XMXG?p^%pjcS69ZOFyQLz{<>U%SA1E!DG8^fBIrZURDfbQ8wlCREgr z6)>k2VQ#nsoVS+89vAmlRnfTDUy#}CY^qG@iVzr%nTCJ(@{KEPQAx{%dGnCHpY@rk z0FO^ZwXr+`=J%%7mrTFr=fByd&3yw72{p=Z*|3pQ#}73$c(444%x1B__Ld=E(t_ zzLF0;e`TM;GYN7GQ(X_DP8e0EpwWq86oLD0&BbLe-JV@bbGBWg5^OIRD{J%?mxJWmEOwTWXCAVfHbSu#kcXFkP4piTeuEP4PoU9Cq9#7 zX(}PQ(Q_)?+}2B>ZS%UXMumFGEz!7K0a&@%XfgQosz19KguOIGUv@aNIQa12^;)@k zma+#w@Q;>b#Id$6i4gPYLnN8U#L21kY&9 z%JEyMU(6h5GHx4N6-sM*CVb9qb9jG=`{bJA&aX?eu= z`cBN;lY0^oNu^ASelbz@jWK~9YxvV7Q8-s7{b6hAJr;U+;Hy;wzpZ!0#0>Mh;1*`n zVa&B!2s%aI^f_?_oLUXI$JG>Mn1yuNh4}~VCx%sm zq%;`l)>NwPIDGw@T%(HHQpcRa1r?AcTSd9qlZG2Qw;PO*lycD)k{Renv_nP*zYA|2 z_Wr=7`AQ#taBOIlPg#>2|!KYaj-P;cp4)-yh0;dXUdom5Qxx*u2fuaYSLZo zjf)~VlQ)D=_jzenbGopkOs`zpi+~5E80vg{f8WNS=OrdUY@s|A=C^yC{nffcxN@98 zf=bamTlmaOtNz&Mo~<#m*jY+$qu_ZpiNu=}@+dqaBOllnxjCXLdKQcG!fgeS}43uq);b$ISi<8L@~(9ly7uNkW;98p9OM)WwsG6yC&aroJoXdF- zH)$JOvD#4BiJ1GfyAEl`KWa5YRl4E0_85NuhVGNNCAJ)W=hEv@Muj(YLcaKFzs6_! zAG7d7rq(=0PyLxTMDBvNsV;WLwTj&H`PCcLV%13zl@Dm7$e0d&9&jqF3jJJdZ_`@^ zU5FVi4t5Ew4HG9uuuae-c!j;BPzV=i7>L)a6H!Zco~-r#4b`Z;M~6F)8Z$NPWmBp@ z+zc2Dc8CK~Lc_uH~q z_ANLu>1~c`6!U$0cp*aTq&Po4p*n2K4U7+Qa7UiRJmAPgoN|(Ljfv9*YapTIbF@dEA+M; z5!-e#xI(qM&o+F&lw#*14*Ie(fJZ`*xph`2Ml62|I-IB zgBSw`jcMkoBa1w$t2;atbp}B8qs>lr{=Mw8IcLVie*B+~clwQQu{UX|vCZhV(?^1*;t-i3~ z(zK@(ruOpl0dYJoiJ=&#Nh?%WGW-jDk#ZbDzgN~zqp8AWEL(a<8rb&Y z0=Adn!nGA+@)sWM$or<<)4Jvmo7bh@badXgN0ml%dl*fvBxpXmYGQ@*4;x#j%$%6J zQdWuvh7e>%OjH(jqcu=lyyDbboq_sq$E6@Emsn1m6w@KT;-D`!xy^UcveGs=b4{#v zt)4*}94pa)f*Cdg^cG>MX3fan$P!e_lW3wG(rei+E6Fb}i%)1H8H61ng{S5TqBW;8 zUq|b@3#%J$U&hGi_j30Z(|_oM+PO; z(2nehUlhK{r`NJhxVNbmo1Y>oMzxnD?|{U^8f|w{_Hlju&NIGB^D((@cHWGku?FtO z#=?A8i;>*9Q_tOgiN5} zk?+xQ$4j12jaX_H+lf()lQ`0)Y~YydB2&3j_M{z)g8T(0g1|ZS^NF6-lL8Dm0%C!> zkk6I+n&hH7%^Jl8Ppph0m*m|=8hy1!7^S{&`69Rif?MxBREtoxohF(Mof6$C;nsY~j~MP%F$uSpJl(yQ4rxAmS-Ru#kUQ!w$71s` zVr9EySb0Oe!Za$4ye&iJxYn`n$|$&7td!Mn^lHTC^Cxln_A)Sv9=5;mbqvc4ZxD0g>8jF!$rW!4X2ZXV} z+07cr!UrkF&_i7q@#_{Nhaz~It;AX8F;7kCY7UNmCVkaobCWE_luWCD6y&8MDNm`EW zTsIGq-awzmIj7iTMI^e$saVRSvQ&Ra?M@!J8m@kQYfNYn*4Bbgrb_pn=I|Lq%~eM3 zTZuf!-36XT=a#X;9P|3|W>npzT%sEbzHW9-y~#XM+8u%?YYpUljGEKKGUvG`X>%og z`RHF2r&QtspCDri^>7>r8K%OIKf>khFesxEhLoPUM(w6&NA zkfc0>Bt{qm_oEQgTpx?X)?{jr&A;MkB__bd7%6nas5j3S)+W+jF2txIXoN$O&EqFo zv-vS+Mm90z;ziMH`f-yS1vmg{q98$NnzbViG7|R?vL=VLK94Wgqle)!mQx|Jk`;!^ zVM5j7j|eMHMLwirmTuxLp~OCh3(wsOm!|6Ann^oa9E#F6y{&e`^aMxF>Vw2%(f^oETUgH zl}0pD#gM}9 zjEye0ZQX_SD6>FrC2m(pYqogBus)ct`Z|guukLO^5`xZtUdh}wIZqjln=R&!vCVv! z<`VeyD75Xc=XUv3wL?x6f2_F#YLUlMh=w=^LOuzcvf1Dw%R!uW1 z6XU%2z@MI5`NgfM!7Qsh{PwkqaSQ^q1kWt)M5d=&qbB`gQ1#Yb!^rgB9mZ`1cDFEE zcj5-K@q1eR23WTDKqfh`(KGLn?o_lun#-Y9^G|h67hC5A8ilpHi*_Eg4o2WyAbTLc z87A?x!3Pct?f3j>tn&Y6v0^7*dHpX ztuO<9*p%zLpCf*4`7B{5FuYInHN)M zD{vS?;_n@>)WSbEdy9ZcPUoT&348dz{tN4{H{gO+V)znlullzuy1)^5@-Qg^_+!w2 z{mh>`bn4K7ix5S*!U=QL{&~RPD=NU1ZfQ0$__zOp#^5u;Dkv)wTr&Ub3NHNp{i1!< z|LT~3{b2h;aKZ7je2@YHCiK1O{KY;H>*E8UuPP#jY-!45>FGQ-M>-jc9MH{ z)p(~~@{D}5Mpo=WjztXVKvS?Cf}grBID z+#+!Qp|W(tydd z8|=ERA7@_D*?8UE_~B?v0(RmYIL#so6bP(j6S&J04a@|s&H?^|5>vL!TT+?_xkC)5ISKyW47nc&Oog(LYMV7UdhL8-GOJjDpY8s4kh<23_C}C)#@p`u+->B&R|r z*at)o=LQEu>OTVFtgde&hn1GBtSq}glwptb&v(-B@qZi~&^S<)*&hEpO(|Y@Xy09q zbLw+^)Tb&~K-THWe~8CGw_}qQ$liRcS$EtFJ!Ay0`3z7WA0bTu0Gv(qsm0XAwvmAP zc6u~WR=n;9k$_cIT4j0pPQ|pPNYqKzN&TKH<0{7Ovg|G5lT$r~>UjE!36hn%;~^=} z!|U4|QpHY+qO*d^Ij6~Z@x~Q;tI3bUZ~ZT*ALzoeWh@D?f0ijc$_ErG_fm*e8kW5N z-sDBH@A1S%2hfW*A}wn+D9jTlkmgS-D$}Jg#l^03OSy!^@AiEJT4UAJ4)U#Bw*X2l zzTS)P8o-P?YB>!S^W?SUR48dV*lOtw#JPq2I)eBZQnj9ZVv;{PJMKY?S6r* z3D!URizsL}A-Un_KQmax2X6BK<_@T0=%8q8JaVTFL)6N4(KBgfk2?gQuI{{Erj;m) zK5$N;DZ6}6rcsjXr(#@$V4NaqVt-nMXz2M9&fo6g5~<%X64AqeOrb@E%@8;^Seaps zaQ+-gF8S9C$X!rFutRUahr9hJcY=N2*_gVWg1I-d%*CMd7GlZ!OlbXp`Kc|RlZWaC z;8b=`zVv{3(@|&Xwt5SC_`Jpxy4|$~2IaiDTc9(!P{`{~0*6khPz;=w_@7 zcQa8vV25THf`fNCGCndNtS~}c93vV84bIx<&3LvkiLiPt7`ZR*2oqLc{%mNE{F|)Y zj^a`~Ov=TT#RnQM;uUZr6uYQT~hsu~yz8m3^OXymvj~~*H6P$hQB(}cuuF=YA zI8H|3<|9%--?e`ubnXvOh{S8lLTFq+ZmZt4#Th(iSHP6!NOs$+UQ5)2xBUb}5c3cX zc%h3Z=wcN>1a9^qP_;We!fQMiS!JuKt(7nbn)&HFKct;_H-3as1qj)9^^osN-;QMR zw;{|5+zboc{C*&SuPoQ+C90oQ__^0?-F3Amrdq8{VHx`PX}=9&bf(&$yf@^J`H&C? z+cpYuO(h-JFq2~tE2d0o<4qL&!F;BD9q|dkTERgLKcq3~$lHE>6P*IIZTVYTtpmUC z=d3mWn5d+FEm4|2ngmLhd2e4Gv$O~m8FcI4^&|#;yo42ZHD8?Ws{}PLC8a)*NPAKY zeJ2L&cOm?i#@nq%Eg(~uHzJ~Fm}``f3jeh&;zdvGcFDuOPHZ72z2aCeJ4sdZUzqTC_=>qu=TCu(z-U!?s3BYvm zz&Vov0+(q5skoSU-F5+#uCKJ45FttK`~)h^kD9f9e^QU)Ij2Yk)pF-bXmJ{NExxSclLBiPo7 z(P`dz46M%6EB1Pw$D*fq7fE*)7-B>}ZH=9Db)XYv=&S2F;2C#MIrj7H@oKdC-@|A1 z5gZPOM@~Rfn?Qj6?(Pz>-M!QElpVIaON%0?1eD67e*2~MdVB_%OMH3an;kyshMzwWLDyVkxcR0mtq9-HrC6 zB~<}k1U+VTkBtbKpE%ZYM~P=lv+n1u@8XXj>2~jc5CVfZBm&&u@o=j&G9zW~7g4Ov z7{ffSav}D0h`kh8kOxpA2nhP#FmrVuPs5!n76n_0I#WijdvY*CW=nc`d%=FJB>K;q zlztCV$KNhL)HD9sp0ZqSkCOV4ev)jy>W*NxPqZIXRprK)VHPp8^Nw%-B#8)7C>@bZ zBOiS2*qffeJ>8C-E8|iqF}#~@ydjL;2Y8YvwOikBiWTb2-jh2cx6u!<^|hx*?o&10 zicaVZ-;n4D+#UpD`4GsSsAOGtK-V47y9)4_UfvYG%IrP_h%){!y8w=8FB!xPReXR< zw-Elb_3bQpQsoDd3b~~ZklS$@ahuB9ZQ2Yt{qQWDi#;v+N z(Y~|q^Cr+L`PCe6v-fPzu_Hw6c?==EOm*}FyO?SP^GuAlG*QG*X0a)Dn$4^FPzZ1d zj=s?|SMpevbVaf&8d20lk>VI$FsBB+#*`r-h(}~X_mAYK?#1!jsH4U=zqLdMf|I6$u3{*1WZFAkB=vbJ>F`(NKW%rN3`Qe2S z8gP;$vOf4^3tf+@7WbUNZzP(%Oek5y^$#01Au|?;BG9hTV3z&I3kN&m72Dt7A_c4I z7|)MmTzD{$3sq;XCxVf_)0@L{_q(vlhA9I6PKTO;ld!`IQad#vT3ez}wbWZ1kG}G6 z30UwwtD@p1Oq&!DzB6r>-zr%`8BOn_hC_Eu7K4LN&(0m7Gl%MfM+?{;+xxu*avY9^ zQR-s4bY;AxdKxSk=v;JMx3f8<(@zuoRlHIB+eB4cliO(tDKH|q)dN^PvSHppI7&T0 zOHb#K%RE}bJbI-g+a~=_2!RQ5zHfBj{4wB9DVn_bbnDHlR%21yenApu1&?mD7ikn? zs1$_p`zj8b?mbENpLmH&5ZNmh)-hK%*^}`jj6yhU4Uwt)qw06NUyY_vvKWVKXs87 zBLU`Erwpa&I+S#p7CzA0PZWpPX+6b6j%rM%$6Z4&>UYNZnV~aX1~X--1mY^d8#6oO zD1Sg?a;vCziQFJ@kJEGL1!v9c@q1EH>o&hyI`c1QiG=bghRM~?x~UXHovjP9MP)Iv zoOi2@0@bRp#;al(m=kAs-)Ow~v{*)DIlYW-X$o|qCCbHry9Zv1^uv7H*XAs=uT$~c z>2j=309A2AN!`L8XvZwsz}&8)=bX823+Ku^ z8+ayxKqDx*!~9N)*tirHPSL%ms0a9Y1LrpOTj2Z=hcSvyO&k~l^kmhQJd)4>(Dsg` z=Urw!?Z=l0#C80@R?wdQ!GJz;x!929Wq)G3&F{V5k4=Pg``+drm&0u#`enf?!)>C- zU)p4(pf(rV30Y1vQ3iT_7^n?ce;QyxB~Gg9RbdvCRK(r59fl>9V*X|uFhYNMKq7{6 z>d({woaKgtKr8g`F)upL%OlZzpE)7TKA@`e_a9Yt@H-cFU656;<9@?s%(9&{gWYXu z(_nz=e!sq$DdK)vHCtH~Jj?xk5Dr0DV%h;^@p>#`D5R{KGl!q@%IlX zpG5GlH=U!s^Clnjk7O3Pp6Q%mB$tSSo`SjuzK5J zv6BMKs}T)`;~{)$Y-5`t^>L39IB2OC45FojqJ*v+Qrg^riKS}oJPIi)>ppIuWUH1i z5_16uX?~F1l3n5^)Qyz+!-(;flGf!76RMKutc1V^E1Id=zljUh@9PXsQ+ly+)GM2Pj6v$RcA18v@bfrq`JLp4Jfa~=9+tc z?4r&rYK?MKhDMLc#>{s~-stXtO3ElwPY?3$K)SM-xyDDJ9fkQema;7**B_4Jfv(2R zWbqSRzURP)sP_9CjWqorPlih@3!Wp40jz-KVlJcqOtPJ;uGWj!%fIPT zZV2tA8)Tj926|0shoNxF$U3;SV`$B-k~)A{fd&7oJESNU*UDpe0;ESjcuDp- z<*ap;qMpHGWOWJVj-Mg5YEE4>X1FVnS|ltM-tY4TO>RNcG~;un7}I;KU|9+31Su+a zJ3-zE@Dfa&Fz4n1uW1_gN=$%ns`e?53v~GY>sb(LY?^NYpR7X`Kh4G_>A5i8^L!Ny zJLd0x^a}14fwpZjJUgtcTE&xDK~&_)%rCP!4Kyt$Xg1K&{m_UGzl?5AFvYz3F_Tqt z-`3m*~)fwfYApG@(EHhqtKvPL+?+pc-uY zJ|#ylEh`q`O`;3?CX30LxA3BU4Vas0LW}XkKTbPXtN+T7c^tr^w&zK)`u{5p=M4+j zMGf!&_sxI5haU_}oIwZKT!tvpE(mQmG8DIb&OWf8roe^23zf}V+n5#C`2q`vzCYNo z03R`4P|PFNl3Iy@);4`0{jGi2dD>d9jS}z>Y#BBO(L_HGDW1XaAcgIQIJf+(jXKMq z1!9TCeE;3rPO;?7OryiuG6x7mnPuF-Jm(6$?4b1MlyFbzq+AOGXK?-TH~uu0R1CbE zt+@qA2% zrOq8NXNusS9OF9hh%yBDUgZ3JY$8wC?_8psJJh-dXcEAi9>+|lfdvc)--FyB z#n!~E!9@-Shsi1-{Q7-&>fcv|gNoVif;O;<>_F4d!4JQN`wZ(4JA^tZ0(7&Uq%Zei zJ;p=@Kf0IfO9y)`F7Uq50tgSl=SMO+fD1e2@u1@a3Tz_ii@C>0S~TkWK=X;98ta7e zaZG){_V1Gf>y+t%(1Em=?%JP0c=twd+6o1`6f``NEct#FIkCTIs5@d8awzN+{lb-BoAOz$`Cxh|D;te z*xuREEY`a(L^6na&+ZYdnH2aQ*nW+6;L32#N2F73u*8Uup$1}l2QXO;3~zWfFZ3=8-T^68H;7i|G5N>6%ioR-%75pf&kd~-=7~VDF{FFKAs(* z6#lhr{(Q`bUC5DbxA|YsR{%>O&TqK=-L;C?4FB;{n8q~l(0ywKo2kFC z^Z$5I84YYn@)LBB|L61H0+VA&BSRSWpZ%f)yD&<*RQ11}pA9yew{0f+|M7}s138G; zP*eWp2coEd?_+?>fOY@>AL9c3KMloDKD%@0Qou-7X0HZ~;e%`_wpVk7W-8)Dg3nXSYg{?~&3A7d5p*kc7$E`aRCN>@bS zr}?q5ijNyZ7e{NuZwf2}rK&?)1fKOacneG^8NYsLP0M?~2Dt53dw?E*L4AT$Tuwsuhfd6=fKw z{TlD<>jT_+;Ou{TU#RJy+s}7415kO*`EntiL^;HczddHU(Y-Nd4?ZS3ZBhr!SvQ#w zDV24m4j^i*!7*V1|4ThX@UafCTB!@{RG)Cl1e$k>> z)V4}2B4cWtEjbliLK2cz^HnJoo*+*L^?NeRy7S2>JtL5U42pB!1lg zY!j5vWx;V^Yqs!%(4hX2E zx`H4nFg~J6_pKB^9K*sUp7;&S9DOKe4%DPolO<}~-60040xe$Az#cI(5KuIAJmvxf z_abzUR30)X^?3nA&U__eExUJv>0iUK3Uf$7ihyM$!#I4_*+PON_}U;~5L?{0Tk}GV zN7>~M_UuNnM`xL6uJzr$B{?5Nhj}hMEgZFu&z`b>(aB0bqb9(f=rS0!^9Y0^a!Si- z?yIj9|6t%|XZN$S}p(`-%QKfR76VPq%t>96ei@Owy&ZpI>Y#EN&t`Xu&8GaLyT>}jQJ7jta9`D&l3#@vlNfgM60)jZRCSpChW4}2Q4smO-=h`P?%Q~4qv zlapUAllk|CNtWcF=Y1UGiwQ?1nM!wN?j0iX%=a(;8o5;~)+AXNa_i%GfC)UH4!LVc6lD$vI6|ejEl*BkD#03+Fb^P`U z+r6AVT59|fV{7UOE#+Z*o-gH*6Ii%0a7Ezpr+ndC=gd$4Tndq!;3K`?rZtnRCX&+a z3L>-2uq>&I5vnL3b2qqJO&Zmr&X_~?4jmWksR#I2Es9j8=vS2lYA)-a?xmP|2=1x=XRfRbD9ln!dZ^FVt z2DAPv&oPMo5z*Q5pI}V=3cY&Ku&zi(R(yGldD{FX>_{+c(=cJ%vVwCKZPf^=1u3Ma zD^q{L00$SpRvD4ht3vyIg}0{^SRe8%_<2@SW4COt}8^*BsnuhIF3BdYp9A z>yRYCgngf2F&X6kJfgk6Hp#j|(d(v%fb6vZGCS;*f>;Y+sI~hfaHs8R+l=U(m!a-V zRhx<#=j#@iJe}{N{d%b0dMG_q=d!VY?<0T5=eXZ*@&vbeSiVs?Aar*VaW-sRAv|%l zv)5{^@?@50SAe2h+0*v)Hk%PBROT30X>rnYBKK>6@SFRS1%W3LY5{K}qAmF5q~mfnre7cqbXzJKp8E?P&6UYV7r{HNib1TE@q)xd0yD%Zf(U< ziJiUBFQRkmdkFk$7Dm^ImHXdrHNzW5y~r+K#VtLSkR-|RgUU1<6AZ4+al9{j_uuXs zs8~c((=zLi1-($od)$6JmN@0!;Frq+Ni17*y>?6Cff*WWmNC*>_2pxUF1BRd+uqNe zyW+PY!`k5a;RvM}H#L8BXf0$~=?PJB1UKnwOjuR^CXr2<7UA;iTnN-beWYWQ34|#y zB^g#n5yM}wdVT8^NS4}saQ!w7otAk690;Q!-pI^Rx#tG4no+T81XlQ(s3mb{l7Gs2 zLG<=%7um>@eVxkNoumyFd`}->+;)LPMnvGm^BO|RVL*Pe2UQKJ+3&qi{(CTantZH0 zVH}IJDZG-1&1TwdK`5eCT_HcPXaD`yk7DLX5hU3xg3uT(e()*)@RAghGe8 zT<*w7t|l38m910Wknv<1L~Z4^toQ5qG;a|V?)8CA>$g%?H8aYLlrhU?o$IvlCK*6@ zL_NPC!SO;Ky}CMyEF3Mz;$Pss1OhOrgvM%M+@8F z?UgvH=M8u3o6!K%&lvOAh_rCnz`u29qBEdGC zh#>FtNp#32C}vn#kB;xRjRM@XkT#y0$%SP-10AbCPsTf^T9VW1%PmlWlU4?dClN9& z$+b@5UsE2o=$V#)h@Z6^)SV4M88XInZAQr-_dR$pJ4*giGUo=RM~slu33Aj=X9c|Y zG6sdw!B_6v{BUu&zY=TLT$E8ufT!1x-gZZ59SJmPnA+)LtuoJ#!cugkvJXfb0*4ZHzdNBAt11#fLLP(W9QnPt zs9<+f$C!-Ex9HJ7%E(WGUs<}O-_vNryZ@auEK3w-ITQp+x0~FX{XTW-cB`MfFT>PE zLRFv&OgAJHMfJUWgeUmU3g{5I?yL6PF@(yf8I*+^mh^G1cYgorJv*GQf-w(DSi01` zyNS^~eSaXUyCs#k?EC7b6u%EbPB%_|Me7nKzn(C?W>`&U&7; z6ON&}jDl1L`53;;k~qOJtVJE-#J#8ma3U83l!Z?2eRRYbq@Bbj79IT{J2dl6Y+!G>5EP-4VV4-Ru-_?g?W`Pfgr+BNhV4Bv6bMW@p(+gwOdF{4O(GNIO==xt~Z^kU9u zkch;*o?3&;0sh=3vXt;J!%;~yrDCM_NrQH#z>S%YFFafE2 zPc%L$%@mqTYQ=OPQi4~kw~w7g7kH8q;}Q<;r_FtkF~%oe-_ttA%G4_%*~eH=^P;sF z8}BJsI%6LXp`q{n!2Qy>|MZQ6pRCn-zztSW?P3pe>rdYn`jRESRAP@QYJ}>yMoJ$p zeYGOg+Nzb|YmeqpV=_ulpO10to4&*MdWR0{AszvA=dc@4k&fb2cDlnFi=9KWL zd*I~#Bt7etJ>NvXJ0<;@dhlCEnEoEy1EZvKr*;gL$HTtiJc387US$tQvo*Nc74oZ= z(!wnl28z65hMZ5QG$J0L3LnN=r=t8Wv%-tR8%=Q2DIa^<`QmnRW)AraUP8}E%#IuC zHr)O~kTxIcQq?U-KF09cQxtJ=@wt|$xai=Xa%Gv%e-9=}I;3XyH!}JihN(qdU8t<% zI;%gMd(y4-S{jbu__mURmRMIR(jBy?zk1O1MQXG>!uHGEh+Kz!uJq4+H`HTHQlG)l zC_FrHQ5KNx1?c2%q2L%c!t(O+ys*f6zU6eJ_d}m6CjYXs@fqM*u-z+LbBhcdQd`yz zS$i&Cj1tjG9Aa8f_51Z6@s7!Q$X7PXJ*=ddqZ>k%IQ&S+DC*B@a106Ac@;&$4>)L| zp5L=X>Tgut=g3R7u+C9(+#@&+&6Sf@^?yG>VJE&~R#0UdNBuDUTkK7eQA3N#@B#|? zFZZoe*SGrDzxdNGFeQyN#wj~xQ3d%D7!XT|9Na3_ zJFIUzC-NrUkA0Z3JI3-9{0R_(gq9y^rQ>rl9PAkh=8s3i*xW`Vnb!1MG4g)qZgymB zg$#R+B!)8aA?9t1$*N8ZVk(ICZ=kjU#>G34kjs&fb2UD&T!@1N!-7*#(&|r)GX#um z#=b>)wr;BF_%0!Epw^J3(U4`}i+BO;H2uClp~a@DYmuHDHC4J-$hyRzg6C6QD?zn4 zuNJ|^r$Dkdtd+~M#Q9S!eNN03`g^F$Ti`iQZVO6KWUJK2MO=o}ZrH}V4Hots7q@Rvd>9lYvWv49jUSIsh zWyz<7TJBoi;rI}UjYiQifr{oq?22pUdASd?19Tyw`zuk6L^m`>L!U)eS$6SBHGiRfoIi!)8K>?lM<9wN6x5yL{z zrF4^YZ*mc?$DbROG=3M~ROf_27v|}Lg61*W-Pcp_5JSkGcxJTf$3x8r{U5<*6r|#x z=~|(5TJ&bpT-wQ-bs)*^7>c?F0@by-UPu`CM){GKM-vrJ8|-K|c_D0V+|pbyn-m>lD@bcZlJTcjeV-i+doIykfmYI4y^) zb(;iNxyY7i+f(BRm%s2X8n@?rjWOT4ss-ihs%s_V@WL`-q`YQzAzW~N4H{=AZwp$D z{GtrQBr@!lZBNqCDFtlLT)crw!#FPYLXS8Bt=LoIP`^fDDxk160$>#m$MVOYA3+nu zB5BVZw`nzk*4kMOjyE!~#32d_^2!hA2kvwOmiq;AmTigWejKfmR7!@xo6PvwpCLxTRxZ{8RH z?b?a7-nz1+f0jY(Nku~bf4Ba>TOPWU^?!5yW4a0Yecq#5yY)7A9Z2TS=GBHul&wSsqk%_GAcd3s5wCfA0_zO`eDJdcB)#pD)XwIE_ z346J|{l3-^1u{(A{r0uusXeKy+vxwncxcH7xxT|LKw1kU7U2bwzUYMY7# zuYDvq%a)DwW@BXtD-;%Afhe#_jA?I5`;6fkqTo5|)smJK`~}k{uTg=#(1oFf*K9DP zwheAH`U)vS|YGyX?wWRY~P_3NwConS+D_89G( z>LI-FT@)**Ite=MWR}A3gn9@uwKT#CpXKsmLW6tT4a6&*IZf}f84o5aeM4;WZ!`ye zxYUP-1c(Zdy_lf96v`gP%-Zr!!7w8g zw3j|Av$j3oPFQu)v~#O%-3j5K);;AaBOoprW&Rh6>YrhZ2*iJ#8ogz$+ZNpNCpf$> zCg=kJ1@4tkHo(L|;x2bfCxsoO(GWT94H{UKEvAf&sGEo?DD-3%k2&v;I;e4)OZ0dM zv*Y-4ua$t8!<9bVx^p%cWg#aopG9)-DuT zVVayT8p$7Vh<5aYWCCnO*k1Gy(I zwe&N3de&{buwR-rjH5+nYIb*z^~hXS^4vKak3CJ*W6Kv$88(GAUEE#eX3z8I*J($K ze#Gk?KRWhIx)$*R|HrD}ckkZ)`SV9eRCHOx?Ul2zh)Co*QKcm$qS(yf z#pa{7ZS8#LCk5To@>9S-O4rJk-@E&`F!kcPAI^s5sOF0(l5yECljBk?WV@7RV$w#NSapP(YrEfPfJ3y!}E6~%Kpou zNRTHjnqjaPX9v{+k+33%C-YZ@KUC978RSHZwk;=8g^1j$=Rj6 z4lzkKs*E(KvR&-5ny&AiT6j3KO8;h!Uh7PBqb|DnCB8pf`%q}U>Df}kZ=K`x;IX0? z`=#9O@Qq`UYFD;vn}`KwyFC<41U-DigN!xadw_#VTkCZvXDra4LF4Y%-x|H;8s+ve zTy{*zcVFh=I~w+lxNvb;bTgi_;gszm#V ze-;*r{e!yW<^A+sO7S1F~=P2@Jb8wx)E>HN|IE*J8We2&#Ur%OPcUD8I7U`<(DT zCV8lb{P7kOPb*QXiT53sw~$L&L5XRTm&6L^Ki4Ief7V2pE2pgo4H;#}P>H9g!S>C- z-jGR-hUG8RT!l|{z7|;xq!FXl4kK1xJKw*5$194kA`0)l*Ks3ghv|;&^UN^k3Fvs0 zJrF+sYAoRmWvP{KXqH@Y7EiZ0-A-ZGo{+1$fHQoVo}10N8T!!BPK3&{x8=Df`1&F@ zK%+)U%bLCPg?YMdU}P%z2bD*=>{sD-=f*##1F1ye&-IZ_f`kk`^V@lkL)FYXmj)$5pLNa{``Pqiba4sEr?<`yX4VE4 z(*%F<@iy&;y7vWDM#IPszV$h_AAG9O-L~<;+}?j#N^8l;c@^b2_(6C@_Ir(wlU7t? z)j(Qo)cu6#uTnGN@~_uRYTZZ*Je4U!)Yg5-if@hjG9zd;6lRv+mY<&;8cfDg7Q)lu zy7z%6HNiF^7LNpfiBk-p^fm8QjK#(Qxf4H?94d-2O}x1zz23>MTjUFz{1`Ku&Wp)J zv5l%;pY&fCh|kZ?E_%v2dt^Pyq%|erfBW_ar&&mP&++-RWy_0(g-6b7veMH2b`aYP zJqB}UnaS2f5F8(G)nd;{Ng+P5Ar7p;%L732&d`}3nQI{2*9_=m*A_c=&i`x|V>1n)4ff?p~+$~j|) zQDG7<8U>CVzXZ8SHRofFcdr~)Z#Q)nTWCEsL^|AV=i@W%i0@1kjiQ-DvgVOmivNIZ zP1uc`mR0&KT&dWs5D}PBGxUR=;T-1!0iq4?@77@W|HpEihMO4D=wDnFe*77&Hd%5~gRr=5uy7ep| zWCiExpBrzV?vMAEA9ZotE==4jhNsVM%{I3ZW9{WfgbRMY-I=LPNAC1h!27V;9L?7~ zL<{4k9I9u2L>ND_H%tL{2iZ`V- zKlPe-7O3b|Gjp@z<7-~>cR$-jdbHX#m!296KU5`APAGeZj*bo;b;n75W;5IKC9FJN zD{n=fA=I!9oc@Td{ppERWKT78{h^lNGnO9%*>AW|nHCN4Mb zrOg^kf+hlZ_6B;DwN~$8xUibk00d`GHc_NCie1LTXPiaTq4qNtS1N3peaum?Xm7jx zd8PI*SQeJPlKOdFIGz5o!82Z7&4{C4^2jzhWR!Mw_{!l30}!CgjJi|4x3snOjhSSZ zitq*LzgQ-93K9r7hbk9a0-7p+iE^htVm0qdOaDX=PO}?aFQi=3rP$!^CsX>QB9k8O;gQHv@>-*SyHxJ63Nfve477LKWL>E+?A}-tNhHj+;}wZbu3| zXGE0Q^VDiCc90T2aY6>Y zjj=^4LpyBNwF_T^Yu{qRRL&R)i62Q!=#_$w+4rk(L-7pMnY9TKC9hGIMEM2ddofdA zLFA`LyZJKtnQ;iC=W%e2P~guwZRQ?PQ}3^hM!jV^?)E(*H>vZ%hi|LO%zQUUPPHy| zjc9P`9taSidx~Tp9c@fLqb>)pFkfE6rsr;`|MQ8rNWQwBx*MHj=*x9&DFbTD$wGAH zi;5N$9%g7StxorsmEV2hm4~d10#i^L*4<|;WUXFFyGy&8o=j*83X&&RqWdK<#tu|> z>EK<7AO8wn;RVuIIg-eSGG~UHR~`a|_TGJK*Lm?96BX}ADiTJbPh$GSR!Dy<>1!vH zc-ZB_6dPY%#9GTQNC+1U3UUQz^L_m3_hiIg$+~M- zX-Sup{UYqxqN{&$<*p}b_>oBbv+7wdV_S&^#nZ=YKac&nPP>rlhf`GuAn}01N6 zGzitK!hBq!3dPwHwN!1_hv!m6+a#sE@7Nj*C3LFdIyD9J1Hhy6vjlzD=IbD)>V+z-`68eLfUsXS8-lI3!DxAw#s_d%J@^ejD?|;lktZMHL5V^U&)V2Rnax@Q(o&g~B#rywx7{~H|TkQXv z)DtY86$u*BhU-F>SF!rMBJ0T$_xX=8U}jx0(YgT0)H8Iw}!b)JBOI>%%bWHw zk6%E&3%qJ`A#R-9X5k>Mk)~HD$lV6xCk&yWAh%INt^D+;H(UOuKjt%j>?=taE+l!I zD6e-Z$p*of04WmgnJMlz=WH>#ZXe^V=>$e58#W`0e33;c^0ZuM`!}OOC{1{ zjbPA#@2!0wJ05l-kK~*VD0P1~{-RIw+TJ(>`8~5}r*@rN_kaFmO5V+el#Pti8>Ty5 zj`vn0Zmjsu0mq@B#$S!8>AG15a(Hf5*21A%-1|s*;AcWA5#QHhV(1zYr$id1*0bLq zOV}>wYE`=*xe=9B4Dadd>CtPHDX^=k6&QAc+IOxsN|`nnL}ySaz2;?kvh}@(Qe~St zWxZwmE+KACDtRj$I<-L?V~uE5GSe_6;IJ4N_jVUl$-7KHfdY1rxU0O=DPX@)dCv}} zK_F){?lIh+YZVg{`-NG`xZgkyRjd{b-@A8@_x!}BQW+(_V;>Yst!-^Z7&|M2+nu81 zSuCbSP23zm;%FW)s1>znHjwc+gLYV6LOH#U(KrO1pN46&<_76H&ituA`eU|oXbDp8Umft|<2Q9=+H*)=%K6rXXg!fNxH2z)*rX$Z z7W&PPCcUcOCfvA%ef#cdHoR~t1CcGaGn^zA1fJOpmX{9v;mjQp5f)~^7lqkvGY_>@ z9!!13KdrB;BL&b!wz9J;S_?XeE9&FDE7(l?z0lHEk z^FnOnUUrM(dcqXD;;Aph+=hl6@81N9?ey)FL4!E6{x(9-+oW7ODN*KKlUe{kDV>ic zo>FO82bhw9m6eqjHfhiJaE2mXewBW8*=IpeX%^2%+xUO_78jROvJY%V-hYh)fV(EDzt^~Cy4>P zM z?3K_pcVB*=Aymy(WCs^Le(+B%EPa7;4zBeK^}@LASKj14gxQ_{tSR43{1z0HcqV3M zY;220V5e{V;~73Nn`yYyO1&R(_2C>beNv8hrb%C>ET3h6wnkQW+4Hxfgt`4ZJUni{ z-lHz}W#t>tzV1_4f^-VA7V1=uhEWh6OL-uGsfWc zH!^x%B2A#}MZ)TFGjTs0w8!ypr1BXQbw*08=DyeMkGbSH zKhtvC?S13L=@zHLdpLvJE0<{5s`!h=U%CCu(Gnu(BqLjNmqxT%E8@_n>4{A2NHw^B zy8fIZ?SgVCWarZkXi-ZV$_*tXWp=~dPK9O98gKcW=5B1G=fp+jjT)$RB1|&(6Ij~6 z-XPW(whnwTji+1xpnj#_NZ_7 ziNEz>ig}LVr}=?_fo^H;ta`l0;YIP6b?uT>E`3WpLG7#MnYO71U#yJuMk&R8gC9|i zIXKi0bq^LqpN+vr6;`}$Tzqg)=Y^EJ*VRD>$~gdB=#T8={RbSTvOAio;8_DpHz>5$^LLaT-$d^G|F&GUxr-#o>p{?dLG zxuS`UX*7vx17D!AQ>gM@DQXp8tGr(l3RPK8qvJqhr1?&?HXpOmRhW;a2Pw+RUa~#f z3e|If#MY#e8$BL#!zi`T1%-*H3||Hf65B04lcL<{6#%%fkn1804od=Ze-jz#>r00} ze?`^8dT{t2lOZiv9p9e9LR8$OM*!NJVObqXg+}A2eVHp~#~u^UNot(vou!a7ECrI> zeK1LfLtdO3p4#%|%k$tcob~3vbkD_kL;5vvsQ)O<$^REl!U3AeCG40p#Pd3}taki@)l z_{`wP*Af!)0*Eh*-i475N6H;6Y_O<#PL!tO3Y(v46WAY?FPN81-pt|}t8m%|<)aFw z@9G`2t&k;Q5urUJ_FS1LnD0qTv)r5ZyVoAu8vRlWDbsv1 zP0P3ShObhCqO&{3brS{TUj)CbuThST+B-=X1V)&N$a;K>KXm#Hs<9rXru|o9G zyCsKnQH6UUpTE)_ne}B3y30{$Dc1D13k$jUjkwk#_F-C3SdONi=D5qdq`TzH5{6+S zqRYKBfBWg9Hwz|r57?Zp($@)F;09yHe)rr#j^YQHJInpv&`Am7bZR?|l$4an&D?QK zc2in5%y*q|rKTPoWuNgDyB|^*Hs5p2DP6&3<8j{MIN7LeJz4Bd9mXvAMK45(e>!H{ zEmZ~;Q`U%*IVCBP`TDw|ZMfO%oodq*DUMr|if}g^P7Q;mjC_j46HDVn9;yU<^i+0M zaq)f0I}DA?N|2!~k3-yc?)8O`Ck9H2G}cf3%sxwaiRBNjWftZ9_tPY? zX1s(=Ip3WngZmo#j-BRX48~bq4R7Z(@zwiqO%I@enw zm|0Es^BTy8<3z~^cfS>zD1c%s?iY+~R*Xb7AQ--|vm!^&UtxjVlieIhqrfmwzxWc$96?NW%%Nzb)+?E=yo>y12jcwr zTuVeEWu&|t$OUhODnc&R?x&e2pyxFWlBgH#t)2@e{n?~1bUsGdG}9Lkhy@mp&`RQ& zGi_n|Won4nXLqI?#@=mQ!Y%44gM_oSHHER%lQ;a?$qD4EYg|7E&Mea;bc(bHRk@I(lt9 z3P}n=tGguLZlsu1@o|aY_@P`~QvB$e)e%jD^MjEb22x-P}96%H{g9!|ab$ zoQ^NaDov~j1mlS9Fd9$F|3GJ z$<8xVNwUU`R|ZNQoO219jEB2kTj+YYV|0lNy; zZawfD@Y9yQ*Qa8b^*uSvKBDs1s_6Py5O&A|sIWTFHe8lNH^3v*St%Itv}$fkSuNi+ zYKc;Mi04c-&~jTLQI$Q>N_pQ$*5)!GJD_#kSn;<{3B6RGIqrfTVsiA-Ai=D@&`a?E;7gqbOu5z;paasyP?I@ z6h+KgTJ<<5GmPMu+@s7No%;JZeN9b1EM+{}j|%gBzFh$&HR%8XkTz3Yy2R-xoIM-w z>vl+p?5p{jkqItqM=<)mmlk7!vyU^AaQ!HLv1LY87_giNu+R(h_=IHRq0!l*aPRW4 zDq&^;60C4?vrO0e#)!9g>r71&eg}rN#Ck%h#98euaMESX2gaAE&;&0qv;9I&R*}nf zqCCppmusySiOXwUOr2L zX}+n22dS0h|3miyP9_{p$m_42b;OlvmS{|rACkNAZtqf+2axn04`65A@%u8vP&5oZ zO1s1Z`Rz~-s`JZqg0HIfcy| z;M871!+waX-9*%c#w;`2u%&ki4(<23jI>C-u#j$cHmLXiwMr?&n^C*4O_`XWE+Sxe z1%;&*A@S7oKAA?k+WV5G_U7loqmDn}2hv7aAv6bO$?HT-6?eP)LdN%;>%9%=&-=5u znL`hmuJ5b|KPtE;kTQ}W8w?v?1yu4yX2b85vh9}pNV#m$%9=MLKru5=%6u>+&>G1q zAtQ4KZ^QBBZ}p$=#3Uspfzux`V|IuX2lGw;+QjW@fH@ zWvsgYLPrP?3Kza-hm7ay7QW+3P8Jmr3Jwb+Y#Z11+A@b){oGwd`dpxu`#o$^Nt2{9 zXM9{AS9!1dpwGcE9g6YSXutr$VjPiEMO4s+`$W=l;fL4zHEY*7lbp)E-F~fGS#xn` zJE<4tvPGD{IQW!}n|ruveK3C>RD*D%4gC-YOC5k26pz{u|I|CS72aFu)Sdd{oerg^ z<13!b$3aS-7iBl-W68XJot73JHOp>b@Fm$!oVn74$)*`o;sZ^(priBW7pJYhsl4L1c?QKgzqI6mvd9_)1_5~Ie8hLkm%?YaXW9DjBte7Hm?SRAK_-QfbZWM> z<*U1c{@yY44oksnBNsdML`%U|^2^rB6$S|CjVLt`gOOo|cMUHL6xq(RA?MzPsQ18 zzR0+@DRVJ^?<|e?Etc2W-mpbG=X`X{(pTxg{H=D5Y2TVkCI9AGObHC3yX2$@hiYhT zT=kH=&KAlKbhxK+Ck7hmGAZl z3FjFu_LZM#UO5Xf(1ywtq5FpmG+Kn&4a>U`LhIY(`yY3|CiuBoE4*`m)t2y^hqP{X zcuQyOm}Rr#rYYF zSU=Wiy54Wxb=waFd>e3wmRd%tWzdcj@f$K+MskSe1ay|6zO3!${*-zNgn^1T$YMl< zgir{c+kBJxB84aX)+lf+k*IF?2bp>Qd{2*Cs4?AEsGk>t45Ch(K&1x$8ANS<)q0RR9{C}o*u3g@>5U1X9N-k|L#ZPWeijY%9d zAB=1CBsW86H)0r(To)%HF3z&M{|8s5VE#Bc&?0g~?n#7G)ohdQ&`N&vKuyvUclFuN zR-(&fg2b%5&Ft*W#q**N2lxESva*)rWX7FXM!KiiaNp~`P4oq>UBQ+tf~LUmT({nr zx&39nZi7F(elfQeyZm%-m=&_f->Qw)6liDZBGKLzB!f;iq0?n8uofz+zI(`6m0P*> zjQ$)QZPZIA>+`eI0M5DlJa@z*oKFJAADU(a^sn5%qpmBtk9`3(-2MCV>EGgtAdxq5 zz+eFk5fVqdmDS}c^K|&zw2QCmI~`NWau&XXdpX4e%fzwq$^!48p70(Xo7~oDiuEyT z-M!CWAop)pCxgxFrEib7IA1k=yKY41qo|-XtFDTf;iN^@OpP+;XTE=1xw8^6?ta|r z%b#J7eJd1Reypb?`72iwq_&Hhdv@Nf2Yp0SCidr=j+39bXnA?73JQ9ByGhdW$rZbT zihX>1baZtg8SYh<>h6U_QMF=o#gxL6kRu;EwTBydEsYLR>r`pGoDrpUsD4xTaBtev zXjHe4hVJLHWivjlD7ACon-OPk&c{gLi_Bl1<}AlHpXS-zkk&mT!7pydSr%{Szlg6O zQvMe90L><&r`fokLwDbd578HoY&B8^(3Hs+6hXkRfE%Qq8p{Wr0S=uCcii321`l57 z{3)@TKHDpj4j#MRq%E9L8L?rCdI3ZEqJwgfB$-rN5Dqxzo2L4d)%A zm47p#mJt^AIM?-X3pfFlDEN7)p2RqX=5e$7nQ@H=atyZv+qTqOmj^CYQM2X6YlIN~ zV!0WQ#Wrmvb-==6YVbY$Ao;mG1I+^cw!JReJ8K=ei=4z%>*tokn0KD39%=Tq-9AqL z$INd7GdC!pD&&vPfJN#%jl1n@IE>l>23b#;l(XbAu(rg`RIW3CT_To1OI|u)yK<*X zVi$#qr&{z`cGgRkfY$^{K$&a!VmkT? zzS!ti$VzS3Arp{>^aeVA11_X^; z!S1CtUlmonA#-?D>oi|;<>mt~p(k}Aj^fp7n++#+-GrG@=6oNosqB*sx$Wn{lbR1M zdY;BlI+7&_xA{>aJ6mn|XS1P#7u}I=kvk*rSo}jM{wbSD-?KNhuFp2IHOfT-$X1K@XGa;aR62gXn`4-nwR}DQc2R1`Y_Rk! zNLW6Hb1UJ$L6meFY&QW82KqK_1@4F}BJ~NJCtGC_ymbfQN5D-(9l2 zr-zR;WoI9uKOcezd@tqDY0RSMim8hleD8{d9T!s8DcrBA~4x@uO0gbSX zkD*0BV;z&EY%((JjRtc;i@|WEK(%wRd*3!#)kd|JJbsS#&5ldA6#GRwh4{n+x)~Z! zxjmLMgK%9W{>nb^2y$;p(_D`;OdG#GW}>ui`7s?5UTAe#(ON|<&0g)SVC%dgyPrHe z<~kg#y?ZCXctqVxC5IRNY3E&+>YGA;MA)k*g(@xD+Yb#VWoX$d`WJSdm}PA}y2^bm zJwU>UZ77uC!Ox0PKpB{z&Rm}hVRuK$h~Ig@B-E{yC8_)v@J4#Zmm8S$n(!X(EOs}v zF}WUC3hT|iR0QY3t9(b6GGOtZ zXT`cX2Pw_7jWU1xHI)3ZxZ))fkY1+Nult)RiE;IPY!Edhs z6@U&5xGb}uEDK=a@W(0BiZi~vWMHHgq$Bk|9H?pYv7+`R(& z#>>_oKZPr*`p__L6;^!+RW2Wls01P1HV&O@NbsAek&8;?HF&Al)U3Ii{ z%IS1KhDffaq@p6EhbJ+JMi>$lJlTnqc(Ir+>wKuVngg98Fih+b1pa-{gl2jqt_S{o zwYK4^mE$v)&ECus;O&wj_^GWSmF4^i_4aoHQbmq3J@MvY8UN)q z%n)k&7&fQF+mA)|NFnBux}d*Ocprsu&R?q?!2n=h;{LWW3R*Pp~!Jz0aq%k zaJ1f6HNRj>XTA9}>!>xWzvzDx zokiI#6e>(5oMh7#nGAJQ5>sy6BSuUY|Kq0XT3yrQs06rKmKdKr5eXXE$+oa?R{fQWtpr~`5gn*e zi)0%}q_g zedU@*bMb3f7dRENrJ%V`Hr8b(;`s(9PvClVBoh$k#8ZZ9W7_{p7dj#tq%m)=jQXkZ zNf?toRR5im{mkLf$Hc^h$VY#QEQp{t#CCX5)V<0dER*;83O%RCpN6+=`t&SRBTLQo`krim75I4f zMZr9}0lAftv334X#gn$Hq!M76I1o~Q7JJ<1D{4n2#th*+Ae#k|6S|d}^`~U0zjig9 znj8(_v8v&OE0xjCKE0Zn;1>kLJLZj9wS`yEyk$I!lDTFHh3;IJpAEZy*59X%KOsqV zTi4|Re~s>Ak{N0nXDB1$AFc%Qt2)Rl}fzFx`y307rrvUPQr zFA$pRl5G>znf?|!v|lct`q!5UTnePQXY>E@;N^EU_~7YmLw(vymg~Q8914D0j51zzQ({79A#5#tR za-ra)z0n4#DgK)7t?Lz7o?ndA^iin$AEV%%o}I2k4qBDzFJRI*Z+4*LnIIXiA5X4E z1d)&(F5aFPldgAzU;@+jhB*ntm9bw)StEO~b7N^*+!WaDAGfcoJRAMdA3@UaRjP{eb6@I4XvquZaK3Zo)|eNS-CuB*&GR{!2R)6&FOq z|Hte9yXF7ImHKa5{~u-i&z6V&jeh=}{QqwKf44mJe^&h{(6w3o&-C-}pf z&;M@qBcT7I){lY%T{*S?Q|c#z{+Hh2zg_*p&_Dj@$`1ekbw1$oUcLXnU;PQS%hshA zu9-p|EM#Q^n{YNif7W3HpMcTUImUO({noCouIlRQF>YMspxcG@&)6>r?vwOy z)YVNzswXwDvdMriw=D2*mt7XVzp@~bVvVLi1NN`}5bL5n=$V0ubEGut^Bu^-FNi~N z+Z-*chLz&YJ^)A+_vc(GVQ3su9t-_O^x|$H6tTiEKJ0Rju=XY=piyXd+-SLj3fbD=x>|qlDj7=k||A_52Lr(UFazk8}b^o;RP>piJBx;ZP?6(q5)L zZ@fWVf6Tvf*&e#|I+jsLiBSB-ylp=Zkblj{#2Ao*3n^-vXbL?VpI*H9CS#4o@y&4| zbqW|OV4!9{B=G|O%7Ytq0oU@177Ny>Ui}}JxPIfsYfIpuVb#X*K@x{Tj^M!!M*DXvi-suYZG_2wEp+Q0U@BZG)>0kEB2aN-Ol9~aoiu)nH z+1fy!?r52vrwgEl0#LDfnF{6*c$L+Hx0Af_T)5$EFMZkW!x7+rINPrUktTSIXa5lN z+FR~#XM~s+Ql`eBlWB5PR8&7=c3v>%@gX#wW;<~-=b_-|5x@f2V*-yl6h?U;4!^KtkT|B$zt^>frwb18th4 zt!73lN=k6gX`dCic)^CYwxBJgEV$weq&{@~blS6%b?96z3rXcg{)3=^`!9aGi{
    1l?yt4*akAcRL*r6z?UGVrAC|YS#LAT8P(DaJM4|IMDsQiE*)5iVc z#@zD+qc$2gt*k#Vd3Jl`J>BXsm@GiECm@9f)TU!MeGrk#g z1F<<9XIke+VLYiyT^RlBrUSW-`*hsg;Zr?=PP(Wg{XlA1_t_g-k@HFKgR$5G$ta#X!hVS-o&5{-cMRf#kTMly0+FPVF_AN zr)HfAbpXUY25pH72n<11I#g%E+`UguT$$DR0CNm%{Z?K39?a)?VY(xeVO8bKS*neV z&3frP8ESQ3dQV7Jfpa716b=EJVSN)jE=Gu*%&Yvc)x(Px0p(%&dKEX9bKE(LgoFgS z(@bC-bT&w9n!;FhFx4%?H`?^*id+O7wWxL+blyzdrf2o|!dbYW;MtpxRdCw6o$3hZ zTf*T(fK^IzRAamfkYz1=dTMHFaxf&_=ZWEs|A%%@{#{yCcV=cLJ7@`2jpq21a>MIZ z(1oi%efqRyLRxaHH?F9lkTf<8D24#aXlINqAk6QgQ_AeXdjA2ND-Ak7Q_{zWaLc&k zjauNhpXFAxP)kRreI?;>E+|x%|7iiBdVsIPIh6!PE0*Z{3ykSR(LeR&8?+bAhcALb z@Vum?nP{6f^bz4}jyhUT4sbE2N85`RyZP~}o|PD8R_rn#yJZ)aFSzl9$ zA=O)mI02YSeM18jg^G6yh}PTUT2^)VKJFoJsB>X;fP*GXEt_iC9?R4Ey|0{dW`7*g zids5jWwz7bMUOH6f#(rz(Gt_J-w2w-tuH9Y=hW;}L zx|;f3b(s$o{CTs>kaKTZ7n=@lZ8nfAPdE>o71!0(Exx?y6N*?xk^fjTk0>ze7K!rF z2mi-Fe-7~hUf2N}8dBg#d}?ZOg|Om^804lCS|uyB09NKjY9D^jSbTd^+9$gD{LBTB ztN8tT7UDmjF7VTzRN!o4C=cg0Bl&?7QleyKWi9B>eOp@}K&~bGpw1M-75mY=KScVswOpi|6pI4>Yf*|$p{B>uCO@lGK4~& zHz~m}@)Nyp2FFNCJ_Q{BT{)T!d;|f>XX{f06s?QH>;> zsB&^xVd*)#MwZ>ZQIC!+6q|f7pP^L6N&x5F(^iR!EX!QZW5hM{zpp%>TUu3McTc#d zE3HXDtMB2Xf9lT(en7b;H+=3O&y!Ypd=hcH083>DH`>dC0A)$f0gr0 z^vps{UhO<=WP2aP{#6O~H!C? zAX_g{;Qye%+x5N{!=o2H{dvpBHx)@pDuJmfqeFtvxPxxeBEI%Izs?Z>@sGGqGk(b^ zt3pr2?MMhqL&?zKW)0VeKFRDOr_ArpwBP&uGYk{9&QHhB6Ww0LBZ5tTP+X zQ0Ylnp3Yz^1ut5o3Xiy8^%E2pH5~|7(}MqtP?MnaTT=>O-XTv3p(K>$g|F7Ebd1l; z_uc_m@_4J z=}@{6q+7Zhr8}g%yPNxN&-s4e`Mx{u{pXH*#yDqi*4}%qcdhlt^UPW`Y_}D(%7*`F04}$JEZ;9ZCzkZP-MjvYs7I?nKp%L4F9)ticsnI%9Cd$Gp zEvKla=OriMWJub^aQO|QkH%oK98M(Fu$@6eOGmG2w_!3rh$!t#hkMu@x8upEs;2&I zgS&_3CU3<{1{>=EBKsHF=8nt{1j5)jcYeq3STd*6&=3zasSOrgdKSE{#vaSf8rQh~ z?MWqNL6;8`L8F}D=Y6kP+^HWkM=P!Spj{ZpZbGlf0G!eI)reQeF4a!iR^{vdBxWEc ztp`I68h6LCfd>W+=J4%#8pbceQ(cc%)5XKaN?lax zCa3AZv&N{x5x*RaUz0{r`35Z>c3(gEF4L3XtL49+s(3)`Ag6bm_`)86-GYHeP*7JS zsbF1Ipi-l;hJIB3IL|1L%33?Xkw*9hsuko&&oHJO`um3O!==O4fdmK?OGBytCqfbh zlbSaNVhlLIgfp=8UY2J8vGfpCu9rm5UeVqs>uo{>aBg7C&36nKjd1OIv9>PxI!bEe zo2ciKJK%nZBMn7?Mm25EZUZlY`NGZBy8RZkqPjz=d3kTe_d7-$(59w*hIs+p53<55B$k7qDxl>O=&S38EW!zM?f zh`?p68*eJ&(nm{=mFO84-$QDVySi#Cl7GX*LiaELxc=->vk?f2-XM((U&STT zFy75t6jgJct-TWgjCq|u&2?REz zj{J63B>&Y>02~1K7aZW_Rf||=IRq?{^u^RQkS>9YU=Vo?WG9NRUX1_^1CQOZ#G_1Q z+N}eZ9uMLZFj<))J#Sp-^>zZ`uYsPiqrHQGv0nj#b-^#?nbv#V4A4mau3`B0QC#_~ z$^~+aFkR(Y*;q3m;MXqe;@<0pr+q;#$XnCR^?SgRgl$A?=&Q=xcR_pFwGYsD@QTQ z{P+hnrmv8H1FJj`wE}E7*1MmLq4o#5^j3|>7v*{CAvFQpB@jAi)cA7_ zDlyPlP!~sQ5ejD!(mzFqC)qQ%4&$-oKqZc)I zMteq^*o;HT--qyyAzgzy#azm+Zox~Vm*f&z+Lc$zgEWORH$y)D+ei-L^I)y5Y&nS+ z@RMXc0#d|nntYA|J~WLcC}dAic5B$cG$V{6*&_3~>t8kDo3o3UBj*ELmi`z%-^q ze#%clRVnyyi9JX?y^%wFhwIpSX@f#T$7-!ywlbLYS8EGp&Fa}>a%K|((f%X_sTsM1 zEk+~Foa@j7&!cf~c2Y2TJyH>JzV~#y+*Tjpc(kcSOkE?(Y)9G_IS_4ub3KQHOi=E+ zwtb{WGvnVhz-vT*&l{nMzY6vM3;}ovUn)k<-==K;0$6~<5Moo*Q~7@dfqyNSLQU}C z@E>Xh46FKg(Mzrx_>Oap7z8?kF6ICnGe|6S>UFHAUcIf}5@vsK{KeiqE*VFkwHeQr36RPGQ=}os~ z4NsP7M%24(oT^V9aYsesP<3#ak7f_QV)Wy9W2u~UBwsO!FgTlpamNSI4$+1@?>`fx zykquh`~%XV=L2HTgRz)W*!1s6EvKYZX3!pJr)m9l2w-FYUAVG;1cs0-CoB%VHoqoyFHMOvxM^n~~y|Jtm>yp42E<7p<$3a!wmiWo2M}&AJtwuE)LNZ_3BysfW z5_fgp5wJfP%Raoh#H%?|`uq*bvS01_4QQPL!_r%G^T3X+1^|RVe*9>vf50n#4rnbm z(Twhw_3Z5I<<;*xznXv8O?w@rgmfd5HztoQ2Jv*@Ae;ua^x_=W4;+@|4@^8h~XC;-qIl5v~nlP|58sv2@?hQm4Jz7LUjpa+bV*TPb>oQU z_8DDg$=lD4JQ=!|a*fxymQrf)*Vh+E;I_|z!Oq=L%H1|lcqyajC$RPNAN2q^8ekGT z0n*rLFU{xkNPK9oPr$uCL##8@|4<`HV$N-=;PK1zc>s-FPtDz~I>TSC!Oq2?c!zlW zxY^qJbpi|w1!isycXvzx(L!r41d!?nH@BLXZ|>G%)KtSTfeO_koiXt()N<~ZFK4?- zXdHZG8-E}3?Nlv=)`B%?r}huyaugG+0T3>pFX(ju=2rurV1OY`fPsO5gM)KfhblVi zJ)EnY7l@#Ta}J8+4wxU>D`kwFPDI7`E|iO`6T#97L;`X)L)r2ad20Tjn51qZ2|i=u;I#6Evn$!2>?ccb#-+xGO!hYH}m< z=Z)dWUN$(~Vp^}F_p*hU&#>NRts{}0n#io@`fg&SSuEv9%zd81H&f%rKv17c zaw7x0?m!Fz;PQf&4S>&r6_&;g(jZ>zSQ^?}~GL z7QC5Zzo|P66YdKp!YWU4+TOXhf~qq|3a}cIP--BI-d_XgVZwMSKh4$~7Ga3=96F9s zj(Zz#RL2edd!(kyX}fOVWSOf!w7IFID`#n$ugoU8cswk72mT#J$$w&Sygo=K1)0Zm z;BQF@N2-@z;goq@el!<=Q;{IR!b;bC=$%5F2x!0OVCb;4ay|0Cg-P(4GoS1NKSue` zwBZ|~Iswn?^C$4dR`0Vv;IPN0WLPnkD`lLCZpUoKjG>?p$;``P!3j{VP;ro9 z*Y(ljIHYnQI3@S;vH5IF!zCm~az%p2Pz_ucB; z)D!hf-j`-Wlrx-Fhg}T4(jOwmLhj{x#mVWGK%cM7^K(YO-2e=hc5}dG5Q9SO90z@H zD#!W=fH{r5x03C5n>LEYH$Z)HyF_{?XA(2#np>s5f35j?&y%Fg#!YFlU9vu2?EX_D z4V_&+dV02vp*u9UeBI1N25k=jTVw!-ils;;aQOjBk^WJ5k+)SJQ>JWJ>@ZB2|mi7D$CB8b_)7_A# zPfdB$_;{$1?#BLzPsNbw*nFx2+5w_`biQqto1yIWhA^?B*zPCSC08rX$xXe$vUCk7 z+>v`|U_LV8O`bP>ub;pMpxzzQv9IzRf=CLDs6*~OoIW%BTsH@h8Yx}5UL)x3NJ&Z# zB8&8LmbY+~)=`U@rxx8zG?f`xviG1*8=)_&H2ikW)@z;Z%uMfr;56rweVn>Kt=lQV zr9Va749H#Nw!SK-+a7Fs;~QxlX|dY{%nqF|!R?wUB3~XB6rBLi46ZYJOS%1=GK3eS zEj=R(;zYKe;wolwFlh_e#+X7LsD#!O=Mw?fD-_Of-ndbdLN(QNII&Qo-&wMx?N13M z3%8UcHn;=J(~h8tqi!xMIyV}ZV+&j~lAGH-Y+kP0WqJAc9$1_rjo4$MPr3V^8#?Je zU@VgQZDMI&oF_K_fKh!bu4d5wC$aPTTxg5-%%yx*SD%{R8q6(fN~o(h=0)+#nqgi*j@KMaZtP&y4)@N zCEn~cdXyioaNt!_!Bo4=Mx4>${Ccl)&a<}RN8Z*6s5Oim$Xx1pg1ry!3z#q(O94zqO(vmZ2~WSNr>6Al`ytCZ>XbUU_22{3;qEu@fI zK~sd^3iMeztAN$#cWQOeNZmkoA9 zv~1Nt0X#2OmfBX=wVl#C4vihHB}eXS<;bpsb*H-f@2b}p>$`*HZ4lNALQC(b zvMqGM?%BP?Bd_-syjZ?`2`*wH3?o1!K^%?i)^oat@>7>!sd*Dktzqb4auH%ET#wHa zJaZ4?42>BPhSi7DW8Up&IX-(kzijS)HRbj>RysO3IQ0tX?fw$V87Z&sv4K$Frw93_ z>x)NNWpvNhL-Y)ZzN3))!ihnT@q(xFi>bnKkV0QxnrdyO<9gUQO#nnsEm-?(svVCl znOZnry>wE(OFb10YUo*M*xl%Vf$(JCy`4kL&i+{-e5F?guW!y8o|oV2aUPXrPefZZ z9Kj3BuXB1{K7ov}bnqzB?g*&!W_SMeuTUgXKcJ)r8Jt+Q>F2V_dE7x&@jbCQl%L1^ zA7Q=NR%+w3s_A+oxcc_mFR%SARm)p?EeX+U9o${qLyN>i@}OSE#ouxd<*~g(!&BG8 z>&TfJ9zM18=R~1dcE~AKiRScf!xA%E@ax2t%bAG9%>F57Bsv`sc%1N1)SC*Zw}M5EOo4+`#cXMz)+l-Ook!>H za@;U(+4z-r9*gHj3Xng_Gf&JBIv|j`0(HHcN5Fl}d3C(qq`}qQUdv|A2KeAw+)LC~ zzCV!ILWpeJFecpP8>Kn)uBaa9!Zl=kmp6^|SI6wRw82H+5B~ZPdTPH%A!2`jSE9?Q zYGh`vUIZFjgKYtRV zkKt~YHMp*4N$8-&fHv{gFvPll%$g@*zIx`Qng(aPcmD3-C~5*TJc@)6{I;_Y0%o{S z9*Q1a2yJG5rlC(Ft0QSqK^?|nLtmGE4@I?0M|4y|DLDr^J>JeIL3U=}YRtTuJsw1s zN7Qp~tXLK`1|6T5zt&Ok8dtBd2qaEWdljf@7^1I-PNjrX*#jjUSDm2jP4i&35-FN* zqOE*RUGZNxh}5UF_E>sqJF*-?^hir?TmB2JLFXM7f!Dx?9ShxrmJbW_k8CzGIh*Pl z)@mD5AOHRsWh%rf?$t|BPt3=d;hllFYL%vt?m1}Y(Dp;Q=LElStEefzGDBrE%{;9H z*Jei6+3&@d7YHoSk45hI*G_gyJ839*EV)Y+O5|kxFH&Zl5vZe&J_(KF<#O05`{tgdAg)T!KV6Gh%W_z?6kzdYs^R-c zxqK`}P%X5?^r}86yent_J7pCywzYYnWJ#HDERWMQ`g5%+C_HZ=Vmejzb-v4*_n}3r zC}tKCh5cqI;?9!2H+k<2Ehu-a4p$Px2h))x^{|B;qjj_z%s#-|H4XXA-S(o?lgCuA z%6M7Y4`bw%z4SmFv7UU#6rHA*(P{Va;`I(h1K2u}cQ%2kh|J-)W zm)9;|h-mF~J{qp6%?8^Fz$91QTex;EWUI9ALQk*{5{qnJf~;UTQ1t%&Xl&$o<;d74 z3+nQ4isvu-U1g3*_~5?nD0WU{1+MGnNdI6L$3cL^m)PFM^DUlkO_m+-z0Ug9<ixeA^+V`-2=|5w~EEgQSkd_@`QoN!+ zLOAdJan7E62%Kfy0f%8EX{&iB(eGr18H!tLsU&6%-eF}FD3~$yEH^QIk=2?p%UOT* z*trktW&V;}zBu$&Ocr}@|56^lC;rrNdvREKGnsp!bjfBdQ8)@EIgS1Z_Z&kH0cod; z^x0EFR`FJ8)FZj?bSnO%iK;!rWL^OZedNBR*Ygi1CN92?+a#ig;b_c%Yb$zU*5S1$ zGHXdj?A@h64QV~Uzk0@agYcyGWjRrMtSAEyq#-_k@4KD(&rh(ogaD6Z1Mi=O8SaG` zFXQFRQ_;VmjH%rfq=EUcuB|jmCRy=4Ee3wTlb6Vk6ZsEl3)R?A<^#W2)2jqX&xW;r z6+;`8Xm3#yWmrwOw)GSnEw+hqr}SsI*EB}Bs*;-;J{U*)Zo0JORr!RL&tkhv=1}#AF)BnKZu}PpxzsX`xKE^vX$MrJC6PEMrS;Qpq@GokbT=6SBV^;2ErE z90-4P$1}ogUXjk>kK_E|jERD{-j~EZ89KL}%Vpp)`f=Z7MmuAuFk|=qo1@drMG3Qa zUh4x9&if{B3|$7rA39AxP!l6bzT57vYenaq|LPU_8jhXOHv^mEJ%t64nu&K(VsuIG zVf{)!!RuaT+4gn>-&+05fR@(Pn)`=#~uqi-;LBfiwZK-nJ)g#z%FE88`*_nALs8<%|?=Pa<>% zRK3~HgDFbO?cC%*j=f1O*O+Y^_^nDoD83H2qdvi^CTIV&hyGQt84r~mXx`{PM`(=Q zrd?Lm+aL3|6fDduYH2*beulPPLA)B+L8c$>W<8!f%KEbSTrFe~zYN7ow27r7z?oHi zR=TZ-oc*0h;Mb%WvJio2qYO$G$!|$4Tx>}gn(*IvStwP4G24!X~;hzWKzZPn*C^Q7we((K>(Q_?d_=J|b|!uNrG2913Xj4=S_n+qbI(YvF+8yR5t>vZ6{l})>rAX!hWtp}OqKF) z2#htSxrIX))k4z|NuHcjb3p4WeGd4IE~9P>&W4z+wtjGh=XuKS;a1-WA+U#dA-H4; z*zTz!V45-`#EKu5=dkkRGXUvuAzN$LQ918F95%6u_Bya$0 z$HqE?rEPps&*pAy5hexxb|Enm!~iIbLH zR@R8#owY7PIpxg6omeIq48kRUhY^aBt^OTj3Vq>fa-PNJ$f|fbS|Q)iW@Xxsd2@67 zd9UZDy56p~yP}!P&N>8jH)?9QXqlZ-4^D9(&)bMw3o`i8c(i?2wyS&m(@sT5G}!r; zKQ4a31YYp^{Hi^p+A75|4>#gf=WMqdyk}}L3OicIL-`q8+9qAykSJ`7irg=^VmH0NG9`*dq-3E$E{0kdkv=RKF^zp8$2*W| ztLU&Gx{ZTJhd=*DxcMFriAYZi|Xj=6kQ9{$a?0F-n13#&uLpWA{&0U zZ0?Sc>sYt3qR%ZZ4AWeiKf!|!mXfvAI^v>&maMSiCirp~31tXODt`35RJ<@%a)Yg~|HKXxF``3k}gm&Edi* z`}D-qJTd+5hgiI<%KKtI)n#^Ov1v={m&n^a59KK$R0buKQhw2(Q2lctGw)Gh zkl|xWb55v%gbkxPiu<7`U94hFBqo^`8q>h9-{0t3Y z-i2i}(y80|B60o>+EvYCiKir2btf?+Ur7K=x8Ag(#3A%l zJTZLOegzdm=HN23EzZ14tf5SwJ*Tg7Hye#IKV&mLw&nIXmQR{Ce=t3rV_Klh zF12>h)h}E5yp1NMh}U*78^?8+%d$BOuO4c=z?-BB=cGDL)dU32W zBV|zQrh{;P*0nhbS6gn$5}~jFS5B^qz{=9|QczTJAVg`fd!DJ69os;0&AIg))rddJ z3z0G$YvS5IdM!R0{Qb;(?1^6Ovsvoyt3`pwe3VSk1g3hbf2+QleD2P=rYZc%n@Cli zM|q4#tty3Yn$`RbUG z=oYbtVsNC^@$G$Mi}N~WO&^#q>uu5I8}O`V#d$f^SewVcig%*gZ+p9b=kTz)7=qZ| z4(nmB2ZmVN#%Wtv$CWPTB?$z*(UuL{xoe5IeJHGvr+}^rHy7@fh zbHU;|p?bo@wlC~sve9FTzAN{o+eBw<9``kVy2cR|h4Uaaf8G_cSry(EZ%#dJb=J!kRrq0osqpCA$!G35vc=l5hDV6z&&kBT<8YYg z{^C^&EYTT(NZd4Wi>(@>w36&!(*_chH!f$#Jh%{H*jbVcl&< z36~7xCYJ)5;)`gHGTf&WYnTks=Bf;;3+wWmfs$zMq1$LB<0@$E(E8M>syyBKD(jK^ zyQ+~py_^&}GAD#thleM-WyU|*#gP$vS&P#~N_!Pmxnf-DO)T#|qq!BbU$mzNyi24B zNewY+c5^(fHIApwSrImoeqVgWr0bH|2?FA(F1jhSQvO&UM(E;;q`NK@6GQ2@0>`-; zdnmVwlQ-Tgif^A#=F`Z%l~}@+J{$Ml{q`tDSIu9(k`7G*%rf3!mZ9c1+LH&fj4nbQ zU$VzxXE3t^La4`cWut_*JuNQcrKQ~jCW+0)b=X2WKi12>@aap^e|?w}mzdXWabVYT zWgyxssag^Pt5qdpLe=!0hYp-ni^PQe3xv$&*kT?(q{3ZZ)QK5JeB;{<)fB>l$+vj~ z4krVD6`2kNH0)b0pTu*JWBI(F39%nWrtsD?mbW5fPZCb%cAq_DRa&eh@?708Z%6zA z&;4dMKBI4=J)UUWY`uw}68|vSKoV2cvLGkUe)h74rh~}~${C%{E=EneV7(b#>9|G` z_vy8=ZLb-dd3iP1@91c)2gdC!HB9-hMcneQ@LDs)Y^ z?#q%YITE(Npw037_~a&E%8!EV2cK4=ea}Rnn~Y~4-pV!da1A5Oy~o54>F(Z7TFXMQ zhN8Lj_SdfNpt?1IqB^zZd2BgDU2;#-T%>wt4mCy%9;h2Bj~UCgCy8}R;ov@6uNyr) zN)HFXG2%|!>UB{h^fpn7e*yQH2`(<3!GXZeD?E5mQuYZX;T{**F$i2sR|$M8)v#2Y`G(Cym3X+X{&qf7o^iDebf z$z?GlarA>jGaoJPpc+Y!#FOjn%pj&3|5^%jjusN)_F2Z2g7#+=g5;NxF>w;;ftSGk zXGx|+f_n(v4q?L`*hCgnNz;cB5K!qN<3}&s(vK~Q_Lri+Z+L>>rlXe5lW|bToU`5JURt zmg|B|56if~`gJ9SC%k!CEB>aHPn+d4=jKz(knPc)$J*2RLEhad@h>pL;Xp{^`H1ov zKnLUDaFr~X2N|prEuVZux>wTmhD0;>M=17N-!UU2I%_+8{RuC`Fr!)1fT`oCA`hf$ z$lu=jbr9-kNyh+n(5~GQ4dXCzLvLNNL7b?Dq1NlZ9UzogHdOt__xTggLO~2$KBcrA z3z}i|3J!t3G!C{qkEX#rX(RIHRmlnW!TK^0bc%P06E59;Qty}}*D_*s0_kEkm%QM* zqijj~ZqmYd7Ln@+4ir|MI?Qhwg9|3d)pVp&N>q_cT1taHDfMq_ehx@Sx;1T57rz$)gRoOq}s!ezbQjWZ-7Qs zosTUi2TigK$K-z29R@yHEtdP(D2Lj(@z&aaFzEGz>zvOeF*a6+{UQS$yqXTi+q``= zSmyj_2Bn6ms}KBcI%8v><*JK%Wg#VN%t#ntGZyc#&yHM6r6yjixUTWd{hlwrs0|Y2 z=pa%yzn&p8IxyE~MbgJO_w5nU#H)dpWYp0^B;y2IkNwnXmjG75(uzXsWpa+!G!^58 znCS(F@i|~Wc=6Fpf&twTx&OzN8T2eI={8!1{3>LL?TBpk=>XRls%twn_g~DUZgoBe z2}TrS)1SKC>Em&C0(ak*7f*azdEoON(P`0<;6#&UX9ykMcoB(rw0%se;VBlB98o8$ zc;DhNh4@O^tYVb#M`Kqs8c)m$gLmvfiLORJGb7RT9Qf{~Tj=~m8>QKbbhbj^!MUci zzqc35+u|l$wZXrR_lB0iEj%>m_W{oCwE3+H>0MLqnTP4ScEfVbb+sz5uaQOCmiemc z0J zD-nF1@v~*+4@sXIC(9lUecnxqbI2JIyRoEhr*)XN{mClXMmZubcsZ!_VCGjFuC9c1 za}`6DAXCHXIh%+5QuA2~&J42Ns@FODccxMqj}WxSOy%kl`%^7#L`jPT&ComX1@jO^ zbJo3%<0r#n*sWzj?+R3sllpCC^dDzUq}6GZMD{b^kKPfhFqKl4hAlyUUNFHn5v9f2m($HamU>)bCyGEZ~5HB=HGyM}bIe#KMa*HAZCyR8VU zkIAdzRxNwq8Ef2dl&mJRLjN=HJoI6m(L*5KRoZU(Cqk{q8?(FNR|u zx0&~TfNNP7xzOOHh410oh%Iza?_)aubd^zEy2V8KA+Fr#U={%=@_MLhSi5$+tkTi9^zu5n(*J-iX;ydo?N~2=}+5ral_sI@spMBxt0f1{#B&@4QTRU;|ZEr z4VNrK{?xwEUb-%%!2&ggHuNt106-$kfb#TYmPRSgk-AL($B!)ahuG&9E%u)TWp6Rn zC7aIzGZ3%cup6#j?DbeX#JU_b5xqt3l~N`nO|_wWskJxI8y`lzw&9^JMix@0ZDPis zV37G#^891@%|oBOYf3gFmF$F+!%<#fS7#HwpchYG|5N7MgX$X*i^sq3sx!RBlWR{mFQ)2$ zjMPf*qDMiOT*upNuTJ<5YKwgd5f6VkaR$0df}VwifUGIjQm5&$s3#mR8yefT79n}f z+OuEY8S>&GK&AmI4WfUR6~xcRd#zBppY731BN5St;N|=hZvT{X@0ec!!z1U1C8y=3 zS=Rjug|5Q)?RWU$*}W5N9uy+8l| z_k~~|2_Zzh1(m4ZqVHw@y82%SVGWu5>V;6nNE+nx6?W1;-~H3RXWpIEAdI$5tDyPE z!9Rb#mlT4Zj)ub8UrGMQHNfM2hb0Fm%OyV*@!uz_paf0t{<)a?AJ+h<)B6D?O`3%4 zo&P?UkS3-aT;+o=lGp_VIPG=YEc2uTPa0Aj&GsHZ}oWCbt|?7|&V^MLDi2exN*-UTv3n8#_P?I-PdJlH`!1ynp&L~nUpgniUjMmQF=Z7JQ~CYRo0Db&c;ND38RwrqW~zwL+S-aE{u!yt zz%znP@Mc4nqO4=&9B}Ah)xoeFDNURPK>U!;y$FYG;Cjs=YdBaBm_gx@($Yi@1FuLg z2mI*G=ie~bM*6WuHyr8?R>0X;dw~Tipif9H)Jpx_}*dK;n`rchDU269|?c18cvY z@A!tbH8rS4i`dl2?n8|eE=tcMOoTaAvlh@m*bIT$xr&8Zg|D}CK3ipVyz%x#_jW~B zrPjRRPy5OqgVtX0qluIM8MG0SaMgC86KCP7b4pzTsg)<#R7H^*1^51uq|I~7QaVzC z3b3C=#_(hSV070%qfm71$udcDRN;M#A{~QV>=4+F11}v0-1*;iQ8x2VTtg1zX2ndF&+PsOt zmO6C11~mYjL@9R4Pf}J^wu|gl)pL*Ul6v?>nc<4A4fkA#RiAfgOsm#!D$9SBFy^Nl z^UeyS^dIqs_qe^j_;OJW6@AzNdmXsxJd;hIh@<{x-!%-~ok3xMgWCW?YcK%~NP(nB zWvGJrueV1GpYM}$(PM&oqa5Vmi%12hKp#AK$b7rVJY=?m7+CWxSJ72eLrV7j$0<7G zy2FEKJR&#L;<^u8{1u3t8~1&gi9q!RiBV%#ID{xME)KGo*OS}_L^%x|Oc*NwRd1ty ztFZRv?Lk;pC-TDrM3SYUJuoS$CaTkNTy@HN0s>XhbK1MQhuptnmfh#BNQ@-Ds|Uc; zVK;3wFH3s4rs}q|_k^ccmFY7Nrj1FyFJ?r(P#Hf{8iZ9?KrNaajBm=8GP=KR2ckeg zq~Zk%g&{B4W)#8RZ3M=zO}i*xNzex;*4Nkfd#ti6zI?;0SYx#awlxeg?O35QtKg3y zLf~03?i}cUSTz4mlR{0Y-Iyl!0<>YS%&Yf^c+W+gqh02;gxnC=pa>E75V$7076+5$riM0c$w*YZ4=$_WD6@E4~_`dzMc7lZ9!^~yZ~Kya5%dgE_~VJre?2dtd?lK8m8 z6p5FnjbgNA_z&7TO7P+HY*nIR3*Nv(@HUO*%HRIE{a7~$q3y}4#F9|!vyR!*ib|ZZ z^t9U9tJyPyEsA*?dj3qrK-RF55s8_z`n?Y;?VdFUwEeQeCD%jCtEp$E;p#q=eT^5r z);|nzKS=1&7lw+!VYLM2JlM`V$KR_yXeuRiUW8T5iHV6>Z-Jp)0;25Nc4>cT;<03G zq25(1=`Hj`){>IJ$@2NAZ~IUVe*hYD9ZRoxTSdPwi-wDj{Qz+qo}h_UG~|iWIxa+aV6{ZXVG4RA@kFvgt72W9Y_)*J`Rfgy>c2p^AZ+O&P0Vi5$jZ15i{7K>BmhJKcKL|49xLh$DGhmEzo$~ zZ8qkWs`N_+_ugL3R^g|D7DE0|&uR+(xav9nX%0gCR(HEjF}TtkX5P4~x3$W)<5O0( zjAP^Lkp!p@t3}bTeu=*nuA=kz&eNL=IaoVF(uZe4)@$Q`^}X>R#QKRO+7Vj;)J|{I zwhu&xqRt$l9mY!d-f>J96F*;mW{iJ5fU8s(6+WYrw_*Ug|KB;4)s zg?6cY`8z_;BSO4gAiX7H2KBmmdv zHHfg%Nh-M+{>-;altPil!O^~5B?OPh2A{}ZC`$+7v{F-)&_*YS9BJSTS4)-}c#E+a zeqg4mMpL4F%8bLsEp^E?Hf^xieu8&JLw^7k1!A0%BDV8o;u(o7Up8d3k9ztQjA~YB z?H}zgAnh>26U*m?#yeKCNRv@iZTaRM881H3PGP4PmaLNi{swfS3cdbbW({3Und((s zuaKp+mSD2$H;-at^K$yf@bKYh4U1ul?#Cl{h}9Ga|CwZzC{p1H#X3Cx46^VhV}uwT zH@ZAA?i7=pyYsNSUwvFuC|X+baDK*6Ax2D9T~2@+8tdAhH~1cNVgqc%-L^+~MPu+d zohrF=A~B*qhPHRmapDbg_3~GiyUc@BiGwRf|4xVUgEm;|_wnFGQ4quVmd;rXzX|!q zlP0=g74uDBW)J=EwtlNJh7g5ms^^#5=XgIY;yqM|VM2HOg~57jx8Vdx;p7mJ%KpPG zD3o9P=w@=?(wvKDe)@UMLgy&{ux9m7pe@7zqDxK5sfIs;C-pUAu}#Nrc}}C+v&%~8 zsuF2Q)1?#B9$$A(DYotD+__jqV6VMI<8cPF5vw^_sZHPxN17zg;SvXKr~yYGUS`K> zv6{GgLj1Ut%5R9@UfL{@E40})N(4CZ-XlG4f`OMIx{jmD+b-Cu2TY-e6dpi$5D*e9 zoxu{fuJdvsT9`w;^WejeD2%ea(f1zuJAf&uQ~Z-W`N+8X6}p|;i^R1o4tw}*ccRnx z9xd=u4Nt9IyESdF*XaExWYMIc{RdDuHJSn%9sH0I6w~wUv+X%-=2nceOK_@rC;TUt z(hvjDIopU6<)3a?K;gB)jBWj`+m3sc){BQOvPcb+Ov%}gvPDW2s|i^{I`kNy`e)0; zgbnQ}5&g1kjSYDjTT3jQ{A2!op-qMy(YB`@vUN#u2>yBA2rGgZnhu-DTc%R7lm`$9 zZnKU5=hh&d{cL@Ky8$;86h~TVR96h_XuF*9uf^r6JkA?1M7#}Iq-?$ zeBq0NHb!O`+y3fV(J%7Znk|<&=BB*34`0;;rLptsc+FNJv_pc3*i}7T>i)#zfZ!JV zKLws=-eSnKUQfThBlt6dCR&hFA)domrJFcerb?_GHSaLnCIg5TF}q*Vv^R3^mGFnG zQbtI$!vKU3xMb{Fi&^3g|LDXZk+BAY);8+kix`B?>!6vhLO++6 zEwmuCf{+btdy5^;rbiV{+a*6&#m1F_=0~e(T${s)_jctP^Uqg8Y3sU~YU`G%m?cNi zP_UVYaS?+$65?CC=sK8ycKEqcQ=v--N<0x>96ch zQ3y_R8U)#|PT>uHuK})jA|k{>7Rs`v-_QyN^B^cWu~2;AXYza}9WG(=%`6XVWi+#H zvUPQva-DrEo1|KP9gBP|kewLV6%V96Uc#(h`fTqq`IWnfEtEr3h^!({`QemVd0xme zMR3XNFnUR*?dht{ll|vC9W{MK4=`eF%~oHPws9*lxMQz<%SF}Ja))-x{ng@IhzXN= zv?Lpl6RpwjF9_qv{B{T&Fa@EZ1==B>lmde;i#|aOfdYQ=hB_=XU+*WuS)#sts{}w_eR%40I90Pa|78Xxm;N3d_18 zWO(VA%|LM$#I*ky+z=Quib7td9ik*H^8tDE!j;oucrV;Q8cGqYP8`Ta`HX#PR*7BS zbJsp4k8F1FGQh%?N6-@X9*)ogpiUuSal99+^*jx+?xP88jdhW;sUHSfd7RbGX&2+H)k{kez9o5+RPsXHhg0PxJEe+v3gGYe(CPi`5UifW z-*;*NI)m7+^O?CwuSIgmuky;nA9VF~L&Xhe08b##S{z1sY-06oQTaRHgUKonUh2IT zKvw`$7>5tYaS4>(EB<+PnXz!j{lJMHYt5vid5qI?OQYBcx8tWWuKl6_@HzPKC`BLl zVT$vtt1nw(vRxM)63xURo7!8HeC1z1ad3~A4S9HO zVhl!LJWASouJr0FSw9d*6xUc) zV(V$93zrC9L##j0QQp5X4zPZmPFs=_9*Hkg-Q~6vQ@?G*>9#vH|a546Kwo z+I>Nkmlx3E2Ue;FlBC}+@)rU)=$48xV6z4QDv|waUq2ju1(*^5;1WeH_SYjHEnt9$ zP|9M35XIkRMtNSeWzfE)AiD3VCLR0ZWG1`n1eSin7O}rDB-o$-WD@`TDC`UPRH<;M z?*I91aGd=kK&!?0jja_BFk_!1w28;&XIhH?=}ME)UX7>FUtAb!Ky~GR<)s2j4#v3N zgqo#2&!5Z|zyeaUw@tcNW;ZVN)dVo`FP*fJ8@$QjC@(JW63o)N|7oBpDM+kNU2#K2 z|D61z&itMSN4 zq9?rRm<-^JFZ+l1Kx&{NBGfJPkFy}m=a5@BVw%DOOatxNlrO+fp#tRMhc09J>cgAS zb$_k4E`eT+`?6p5by1{c!98tUXw@@-E94+@pmX39g}@NKSYd?Q7FjZn+Grs(?~0CV zI58UM@8vAjIB+{y%(2;O+orE$@{}+M4$hsWB+|dju_DOsy*Io|GRtt zH2^0+fe+r2d}{s2rT_fty$Tj8?wF#2zcJwdX@yV%=;@W6J~sIO`}MWJQ(HYOcl_s| zhYfFVGpO@iu20ZK{`>mzKpirz)ldP%A+Rt0yA|(+!3WfjTlD|)Fz9*qAVN;)9v=g* z7W$7LrM?9{cxw3-&%Y}Sf6pkU02a2fznHA~@8?p60zOFKNA@H8@9X!18Oe%CR}}W0n0)9|1}A$#VFUM% zR|rPb$dmQGJzb!U27^Mac5i)M4GdmD#y9&WSJ{yv+!>Hk@uMgptb$l$0AU(kwwd)m z-!@Ruf}%rA$t-kt1JqmY`U9LyI8rj#Wd{vnVq)Q2kcfx~aAizzY1DK;L!D>5Jb2;q z&n_X&@Mo(uu$7Ms@O%VoBg4!DD1AU+!L}?PRRQo`n;P>DAe{%{GD^KwmL9l;?GIzz z8xKsMv;lDj7|Qt@sD1uY1%$jjpT{na*7iW&R9$J`o@s7Us96bx-UnjwnbA?4N2jN! zV}&1!PTp6}e9q%KEU&F~2isZ$0V&O>#rWc8R}{lu{h5wcNFdR&+)Z}+|7z>X2&u%w%6CV^4NtjY5MN%VZk4BFk7}A|fJ9&5SL>knNi6`#K8Ul=Yetg%ncVT&0Li zU1Hj9y6Qdn^uD~^-`~GKo^zh(obx^3@AEt-eafp(k1>~C^M3fi4&sNTEx75XawqM> zAsM(v(BUuUxcVY^&Xen3*8y0m)zb43pSSy?XrUIT&aNq6>*2cUe~q1%&Sg(cG90^~ z#|ZD(VYj_r2kzIN@SHV4$UO^S((vF^Zz{eZdh%R!I~P>Ne*)$23mlHsI}7k6nDB)w z4<9wF&aJ9K)=WiTd^gaF?ygD;?IL}iVZQ-FHmuuX`5#a>?4umjVXHeCGo3a!3c%nh zM$Ms2l4^?5&AFH$Mwrw!YVTL@mUgAtP9dtbr@=0(^DX>shQ*R`XWm}E(f5tP4LlSN z9mYLdGH#?wyqIln3E1c=j86#f?ENAKz7Ozm4)BOlTFSHnEfl>s?c*Vo+gZ^dhY9+~ zF*zwyJwC#=9vufVEMu!2?4{rU{V486?;8fkcgaKj4y zj(9;{Lc}+G1@O;ts)20r4on_sBxy-m0CmxN?#opY5+Ops{!6Fm5=n6upb#>zQXpJ5 zgk_k#P}NZs{aiZRP`Boi{&R?kyU1pL$(H`35aV>A z-hf!}QVTOc0IEdceiec;?!VU1-=|_ybn5`rJaKV;{rdA`H;R#gCTMGjwb(8IsSW0d z(YZDWnpS0aO}B~-d?KAgosN54rI6ksS7$rEqCSHvexa>iD6wLzIHnoh4)_6U0-lNh z(qHVG2qnuGC?^rIf!8%|gP?3WDcIPS;`e5XC5ITxsncV0CR)p|OicBxoLf=9^KVPL z_Ls{Ba^=T*A5)`}U`~mnJ>Teh5+H}ze?-&pPITRQ=CAe%9H|>b|G;)HJhYnCvXi*C zH$|4NJ8G*FN$ZH{ebef7AfAoq%`8_WRt1&$_M7iyMNp)2d(sL&;cwwf`*gVyLL8~U z-j(vcCq88>xkVaOkEHSRAM>z&S}pTBxBWHbV5+>!_oBKzxv&1ol4pu`GjZw|<4ex3 zwf({#eyIKxsjVED-do=7zO-9aqN5E-B7Qo8$HVQ!-&WsiYJ?j}7tt-`#K_gG-4y&> zs?T79Hor`BV{LNi!Q936o>~Eopr#2XKcObG_D`R(f5wV6s5QCWU7HWcgGy9YVF#u1 zRCJ8|1!uX*sv!9#iSwNa*N^+lB68)F<^_b(bWn)ipa|uF1ZoPuU)r9`W;f|nN1H2Z znMao3?UE(_)>ulJ&j<_XVef+WOBn5+|5kE74k=mZNQ^Y0HAo4+C56KdUY|=jhfj(> zNtn<-zDvY$Zq}{ZBU(z_iU_Ud8z#n8^C5(mYM*8a4U(Vnmz+O9AXh_*r?&ch{^78- zoz@bkz({+QA@I?`>>gvfLoDq#q!y3(5e!A~T{{)ZG?m3|4bM zYg=+s!k)1zr+?C5w3#8-4s@`XEk!)PK70TTvGt2B6XpyDpZQ|#T^rDjNs&)oI!IY2 zg!H0waV^Iw!WI1LACzVnQa*cB+#Dmlhrg6YTzNs}j!k9r-fmUe{>guwx2rVFG;MiE zwnS@l2*86>XnLgkDBT=D;1h7gQijT|nO7faC#Da{))k~%B$T@qtT{{svAyOx6N-5A}=S+8&(gsgei@?G*+=|xlHAl0)e68-d z)OWWRHd?lB_z9U&8Eiw8%`4#5RSPeMbBq+b$4LXmKY>1YkTh-F-H`Mr1%rNxhaSbN z-zj}xj@J|qed_r%bJHZQnp$e9z^rYH97;`GP*D>KgR}8w1DOZ}0#L0%1IWx9L7R8% z)tw6Hu}Ft(d#Bv-yMkERX?o!hPisfV-m8CW<~WFBoRM!9vHh;k3n=IQKNW<^8wZI) z(H~-z>Gq1FWYs}!lD|%roff+dg3$Upc2gy5#H#WksqCUl-?~(~5lNL|d9AaP6sl51 z8|xY?-IVr!pU|X!U0&vHGaMbUT6XNJ{;Ai+*V&zop42_Uo3-dTg>uK$oKY0I(DY0>^1_A8 zE*EKWwuOa7S63Iu+RJP-2Rl?1S)8qpjoD}|2%A-4qnc`IGoKe|oBzNh%gLC2lvn2} zbBS?f%j_l4m=~l&6l-U*uijH*VutMl1Jz3UUz_SbBR#W|oH(`OaZG)%UjB%X)O2f#n6ZbCy);Ni1!=Nhopir@arQ1_ zfpF$uq7sYDaJVm8hAKd-(=&dbDN%n3u%pp!&BI25K6;1VzkcA|75kCRw!}=hD2f$guDDL~2L zRI^yAMRBk$xymof2J$XQwMI-nYj@3X2v|?pO_R0i(^{v}>+R^dLl$FUhcYo=*F|ILS|)Lr$H7+Wq0>3rT`qO4h?7O!NK(PB3ME%f|mM0<4_l1H;SLt|2fKsO=uA`=~#oxFme(koow`Z$ZsDr+QqwZba>}M^PAhTZt){* zhJrlG&P>LM&fRzKhvNIcosm&sIp$X#_5DPFHWH-w fQ^;7#!vFrh3~RRGm@@Z4z=yTr$DyxS`^5bRZuupj diff --git a/docs/chapter_graph/graph.md b/docs/chapter_graph/graph.md index 3e8a70f06..16aada6b7 100644 --- a/docs/chapter_graph/graph.md +++ b/docs/chapter_graph/graph.md @@ -1,6 +1,6 @@ # 图 -「图 Graph」是一种非线性数据结构，由「顶点 Vertex」和「边 Edge」组成。我们可以将图 $G$ 抽象地表示为一组顶点 $V$ 和一组边 $E$ 的集合。以下示例展示了一个包含 5 个顶点和 7 条边的图。 +「图 graph」是一种非线性数据结构，由「顶点 vertex」和「边 edge」组成。我们可以将图 $G$ 抽象地表示为一组顶点 $V$ 和一组边 $E$ 的集合。以下示例展示了一个包含 5 个顶点和 7 条边的图。 $$ \begin{aligned} @@ -12,43 +12,43 @@ $$ ![链表、树、图之间的关系](graph.assets/linkedlist_tree_graph.png) -那么，图与其他数据结构的关系是什么？如果我们把「顶点」看作节点，把「边」看作连接各个节点的指针，则可将「图」看作是一种从「链表」拓展而来的数据结构。**相较于线性关系（链表）和分治关系（树），网络关系（图）的自由度更高，从而更为复杂**。 +那么，图与其他数据结构的关系是什么？如果我们把顶点看作节点，把边看作连接各个节点的指针，则可将图看作是一种从链表拓展而来的数据结构。**相较于线性关系（链表）和分治关系（树），网络关系（图）的自由度更高，从而更为复杂**。 ## 图常见类型 -根据边是否具有方向，可分为「无向图 Undirected Graph」和「有向图 Directed Graph」。 +根据边是否具有方向，可分为「无向图 undirected graph」和「有向图 directed graph」。 - 在无向图中，边表示两顶点之间的“双向”连接关系，例如微信或 QQ 中的“好友关系”。 - 在有向图中，边具有方向性，即 $A \rightarrow B$ 和 $A \leftarrow B$ 两个方向的边是相互独立的，例如微博或抖音上的“关注”与“被关注”关系。 ![有向图与无向图](graph.assets/directed_graph.png) -根据所有顶点是否连通，可分为「连通图 Connected Graph」和「非连通图 Disconnected Graph」。 +根据所有顶点是否连通，可分为「连通图 connected graph」和「非连通图 disconnected graph」。 - 对于连通图，从某个顶点出发，可以到达其余任意顶点。 - 对于非连通图，从某个顶点出发，至少有一个顶点无法到达。 ![连通图与非连通图](graph.assets/connected_graph.png) -我们还可以为边添加“权重”变量，从而得到「有权图 Weighted Graph」。例如，在王者荣耀等手游中，系统会根据共同游戏时间来计算玩家之间的“亲密度”，这种亲密度网络就可以用有权图来表示。 +我们还可以为边添加“权重”变量，从而得到「有权图 weighted graph」。例如，在王者荣耀等手游中，系统会根据共同游戏时间来计算玩家之间的“亲密度”，这种亲密度网络就可以用有权图来表示。 ![有权图与无权图](graph.assets/weighted_graph.png) ## 图常用术语 -- 「邻接 Adjacency」：当两顶点之间存在边相连时，称这两顶点“邻接”。在上图中，顶点 1 的邻接顶点为顶点 2、3、5。 -- 「路径 Path」：从顶点 A 到顶点 B 经过的边构成的序列被称为从 A 到 B 的“路径”。在上图中，边序列 1-5-2-4 是顶点 1 到顶点 4 的一条路径。 -- 「度 Degree」表示一个顶点拥有的边数。对于有向图，「入度 In-Degree」表示有多少条边指向该顶点，「出度 Out-Degree」表示有多少条边从该顶点指出。 +- 「邻接 adjacency」：当两顶点之间存在边相连时，称这两顶点“邻接”。在上图中，顶点 1 的邻接顶点为顶点 2、3、5。 +- 「路径 path」：从顶点 A 到顶点 B 经过的边构成的序列被称为从 A 到 B 的“路径”。在上图中，边序列 1-5-2-4 是顶点 1 到顶点 4 的一条路径。 +- 「度 degree」：一个顶点拥有的边数。对于有向图，「入度 In-Degree」表示有多少条边指向该顶点，「出度 Out-Degree」表示有多少条边从该顶点指出。 ## 图的表示 -图的常用表示方法包括「邻接矩阵」和「邻接表」。以下使用无向图进行举例。 +图的常用表示方法包括“邻接矩阵”和“邻接表”。以下使用无向图进行举例。 ### 邻接矩阵 -设图的顶点数量为 $n$ ，「邻接矩阵 Adjacency Matrix」使用一个 $n \times n$ 大小的矩阵来表示图，每一行（列）代表一个顶点，矩阵元素代表边，用 $1$ 或 $0$ 表示两个顶点之间是否存在边。 +设图的顶点数量为 $n$ ，「邻接矩阵 adjacency matrix」使用一个 $n \times n$ 大小的矩阵来表示图，每一行（列）代表一个顶点，矩阵元素代表边，用 $1$ 或 $0$ 表示两个顶点之间是否存在边。 -如下图所示，设邻接矩阵为 $M$ 、顶点列表为 $V$ ，那么矩阵元素 $M[i][j] = 1$ 表示顶点 $V[i]$ 到顶点 $V[j]$ 之间存在边，反之 $M[i][j] = 0$ 表示两顶点之间无边。 +如下图所示，设邻接矩阵为 $M$ 、顶点列表为 $V$ ，那么矩阵元素 $M[i, j] = 1$ 表示顶点 $V[i]$ 到顶点 $V[j]$ 之间存在边，反之 $M[i, j] = 0$ 表示两顶点之间无边。 ![图的邻接矩阵表示](graph.assets/adjacency_matrix.png) @@ -62,17 +62,18 @@ $$ ### 邻接表 -「邻接表 Adjacency List」使用 $n$ 个链表来表示图，链表节点表示顶点。第 $i$ 条链表对应顶点 $i$ ，其中存储了该顶点的所有邻接顶点（即与该顶点相连的顶点）。 +「邻接表 adjacency list」使用 $n$ 个链表来表示图，链表节点表示顶点。第 $i$ 条链表对应顶点 $i$ ，其中存储了该顶点的所有邻接顶点（即与该顶点相连的顶点）。 ![图的邻接表表示](graph.assets/adjacency_list.png) 邻接表仅存储实际存在的边，而边的总数通常远小于 $n^2$ ，因此它更加节省空间。然而，在邻接表中需要通过遍历链表来查找边，因此其时间效率不如邻接矩阵。 -观察上图可发现，**邻接表结构与哈希表中的「链地址法」非常相似，因此我们也可以采用类似方法来优化效率**。例如，当链表较长时，可以将链表转化为 AVL 树或红黑树，从而将时间效率从 $O(n)$ 优化至 $O(\log n)$ ，还可以通过中序遍历获取有序序列；此外，还可以将链表转换为哈希表，将时间复杂度降低至 $O(1)$ 。 +观察上图，**邻接表结构与哈希表中的“链式地址”非常相似，因此我们也可以采用类似方法来优化效率**。比如当链表较长时，可以将链表转化为 AVL 树或红黑树，从而将时间效率从 $O(n)$ 优化至 $O(\log n)$ ；还可以把链表转换为哈希表，从而将时间复杂度降低至 $O(1)$ 。 ## 图常见应用 实际应用中，许多系统都可以用图来建模，相应的待求解问题也可以约化为图计算问题。 +

    表：现实生活中常见的图

    | | 顶点 | 边 | 图计算问题 | diff --git a/docs/chapter_graph/graph_operations.md b/docs/chapter_graph/graph_operations.md index f0de07c8a..866e6202f 100644 --- a/docs/chapter_graph/graph_operations.md +++ b/docs/chapter_graph/graph_operations.md @@ -1,6 +1,6 @@ # 图基础操作 -图的基础操作可分为对「边」的操作和对「顶点」的操作。在「邻接矩阵」和「邻接表」两种表示方法下，实现方式有所不同。 +图的基础操作可分为对“边”的操作和对“顶点”的操作。在“邻接矩阵”和“邻接表”两种表示方法下，实现方式有所不同。 ## 基于邻接矩阵的实现 @@ -206,6 +206,7 @@ ## 效率对比 设图中共有 $n$ 个顶点和 $m$ 条边，下表为邻接矩阵和邻接表的时间和空间效率对比。 +

    表：邻接矩阵与邻接表对比

    | | 邻接矩阵 | 邻接表（链表） | 邻接表（哈希表） | diff --git a/docs/chapter_graph/graph_traversal.md b/docs/chapter_graph/graph_traversal.md index a0abd3202..724bc40dc 100644 --- a/docs/chapter_graph/graph_traversal.md +++ b/docs/chapter_graph/graph_traversal.md @@ -4,9 +4,9 @@ 树代表的是“一对多”的关系，而图则具有更高的自由度，可以表示任意的“多对多”关系。因此，我们可以把树看作是图的一种特例。显然，**树的遍历操作也是图的遍历操作的一种特例**，建议你在学习本章节时融会贯通两者的概念与实现方法。 -「图」和「树」都是非线性数据结构，都需要使用「搜索算法」来实现遍历操作。 +图和树都是非线性数据结构，都需要使用搜索算法来实现遍历操作。 -与树类似，图的遍历方式也可分为两种，即「广度优先遍历 Breadth-First Traversal」和「深度优先遍历 Depth-First Traversal」，也称为「广度优先搜索 Breadth-First Search」和「深度优先搜索 Depth-First Search」，简称 BFS 和 DFS。 +与树类似，图的遍历方式也可分为两种，即「广度优先遍历 breadth-first traversal」和「深度优先遍历 depth-first traversal」。它们也被称为「广度优先搜索 breadth-first search」和「深度优先搜索 depth-first search」，简称 BFS 和 DFS 。 ## 广度优先遍历 @@ -16,7 +16,7 @@ ### 算法实现 -BFS 通常借助「队列」来实现。队列具有“先入先出”的性质，这与 BFS 的“由近及远”的思想异曲同工。 +BFS 通常借助队列来实现。队列具有“先入先出”的性质，这与 BFS 的“由近及远”的思想异曲同工。 1. 将遍历起始顶点 `startVet` 加入队列，并开启循环。 2. 在循环的每轮迭代中，弹出队首顶点并记录访问，然后将该顶点的所有邻接顶点加入到队列尾部。 diff --git a/docs/chapter_hashing/hash_collision.md b/docs/chapter_hashing/hash_collision.md index 92df0bd0e..facc8f21c 100644 --- a/docs/chapter_hashing/hash_collision.md +++ b/docs/chapter_hashing/hash_collision.md @@ -11,7 +11,7 @@ ## 链式地址 -在原始哈希表中，每个桶仅能存储一个键值对。「链式地址 Separate Chaining」将单个元素转换为链表，将键值对作为链表节点，将所有发生冲突的键值对都存储在同一链表中。 +在原始哈希表中，每个桶仅能存储一个键值对。「链式地址 separate chaining」将单个元素转换为链表，将键值对作为链表节点，将所有发生冲突的键值对都存储在同一链表中。 ![链式地址哈希表](hash_collision.assets/hash_table_chaining.png) @@ -105,11 +105,11 @@ !!! tip - 当链表很长时，查询效率 $O(n)$ 很差，**此时可以将链表转换为「AVL 树」或「红黑树」**，从而将查询操作的时间复杂度优化至 $O(\log n)$ 。 + 当链表很长时，查询效率 $O(n)$ 很差，**此时可以将链表转换为“AVL 树”或“红黑树”**，从而将查询操作的时间复杂度优化至 $O(\log n)$ 。 ## 开放寻址 -「开放寻址 Open Addressing」不引入额外的数据结构，而是通过“多次探测”来处理哈希冲突，探测方式主要包括线性探测、平方探测、多次哈希等。 +「开放寻址 open addressing」不引入额外的数据结构，而是通过“多次探测”来处理哈希冲突，探测方式主要包括线性探测、平方探测、多次哈希等。 ### 线性探测 diff --git a/docs/chapter_hashing/hash_map.md b/docs/chapter_hashing/hash_map.md index 945b09303..803e4d972 100755 --- a/docs/chapter_hashing/hash_map.md +++ b/docs/chapter_hashing/hash_map.md @@ -1,6 +1,6 @@ # 哈希表 -散列表，又称「哈希表 Hash Table」，其通过建立键 `key` 与值 `value` 之间的映射，实现高效的元素查询。具体而言，我们向哈希表输入一个键 `key` ，则可以在 $O(1)$ 时间内获取对应的值 `value` 。 +「哈希表 hash table」，又称「散列表」，其通过建立键 `key` 与值 `value` 之间的映射，实现高效的元素查询。具体而言，我们向哈希表输入一个键 `key` ，则可以在 $O(1)$ 时间内获取对应的值 `value` 。 以一个包含 $n$ 个学生的数据库为例，每个学生都有“姓名”和“学号”两项数据。假如我们希望实现“输入一个学号，返回对应的姓名”的查询功能，则可以采用哈希表来实现。 @@ -11,6 +11,7 @@ - **添加元素**：仅需将元素添加至数组（链表）的尾部即可，使用 $O(1)$ 时间。 - **查询元素**：由于数组（链表）是乱序的，因此需要遍历其中的所有元素，使用 $O(n)$ 时间。 - **删除元素**：需要先查询到元素，再从数组中删除，使用 $O(n)$ 时间。 +

    表：元素查询效率对比

    | | 数组 | 链表 | 哈希表 | @@ -436,9 +437,9 @@ ## 哈希表简单实现 -我们先考虑最简单的情况，**仅用一个数组来实现哈希表**。在哈希表中，我们将数组中的每个空位称为「桶 Bucket」，每个桶可存储一个键值对。因此，查询操作就是找到 `key` 对应的桶，并在桶中获取 `value` 。 +我们先考虑最简单的情况，**仅用一个数组来实现哈希表**。在哈希表中，我们将数组中的每个空位称为「桶 bucket」，每个桶可存储一个键值对。因此，查询操作就是找到 `key` 对应的桶，并在桶中获取 `value` 。 -那么，如何基于 `key` 来定位对应的桶呢？这是通过「哈希函数 Hash Function」实现的。哈希函数的作用是将一个较大的输入空间映射到一个较小的输出空间。在哈希表中，输入空间是所有 `key` ，输出空间是所有桶（数组索引）。换句话说，输入一个 `key` ，**我们可以通过哈希函数得到该 `key` 对应的键值对在数组中的存储位置**。 +那么，如何基于 `key` 来定位对应的桶呢？这是通过「哈希函数 hash function」实现的。哈希函数的作用是将一个较大的输入空间映射到一个较小的输出空间。在哈希表中，输入空间是所有 `key` ，输出空间是所有桶（数组索引）。换句话说，输入一个 `key` ，**我们可以通过哈希函数得到该 `key` 对应的键值对在数组中的存储位置**。 输入一个 `key` ，哈希函数的计算过程分为两步： @@ -573,7 +574,7 @@ index = hash(key) % capacity 20336 % 100 = 36 ``` -如下图所示，两个学号指向了同一个姓名，这显然是不对的。我们将这种多个输入对应同一输出的情况称为「哈希冲突 Hash Collision」。 +如下图所示，两个学号指向了同一个姓名，这显然是不对的。我们将这种多个输入对应同一输出的情况称为「哈希冲突 hash collision」。 ![哈希冲突示例](hash_map.assets/hash_collision.png) @@ -583,4 +584,4 @@ index = hash(key) % capacity 类似于数组扩容，哈希表扩容需将所有键值对从原哈希表迁移至新哈希表，非常耗时。并且由于哈希表容量 `capacity` 改变，我们需要通过哈希函数来重新计算所有键值对的存储位置，这进一步提高了扩容过程的计算开销。为此，编程语言通常会预留足够大的哈希表容量，防止频繁扩容。 -「负载因子 Load Factor」是哈希表的一个重要概念，其定义为哈希表的元素数量除以桶数量，用于衡量哈希冲突的严重程度，**也常被作为哈希表扩容的触发条件**。例如在 Java 中，当负载因子超过 $0.75$ 时，系统会将哈希表容量扩展为原先的 $2$ 倍。 +「负载因子 load factor」是哈希表的一个重要概念，其定义为哈希表的元素数量除以桶数量，用于衡量哈希冲突的严重程度，**也常被作为哈希表扩容的触发条件**。例如在 Java 中，当负载因子超过 $0.75$ 时，系统会将哈希表容量扩展为原先的 $2$ 倍。 diff --git a/docs/chapter_heap/build_heap.md b/docs/chapter_heap/build_heap.md index 64f4db6db..d63541a54 100644 --- a/docs/chapter_heap/build_heap.md +++ b/docs/chapter_heap/build_heap.md @@ -1,6 +1,6 @@ # 建堆操作 -在某些情况下，我们希望使用一个列表的所有元素来构建一个堆，这个过程被称为「建堆」。 +在某些情况下，我们希望使用一个列表的所有元素来构建一个堆，这个过程被称为“建堆操作”。 ## 借助入堆方法实现 diff --git a/docs/chapter_heap/heap.md b/docs/chapter_heap/heap.md index 609239223..f8af02bb8 100644 --- a/docs/chapter_heap/heap.md +++ b/docs/chapter_heap/heap.md @@ -1,25 +1,26 @@ # 堆 -「堆 Heap」是一种满足特定条件的完全二叉树，可分为两种类型： +「堆 heap」是一种满足特定条件的完全二叉树，可分为两种类型： -- 「大顶堆 Max Heap」，任意节点的值 $\geq$ 其子节点的值。 -- 「小顶堆 Min Heap」，任意节点的值 $\leq$ 其子节点的值。 +- 「大顶堆 max heap」：任意节点的值 $\geq$ 其子节点的值。 +- 「小顶堆 min heap」：任意节点的值 $\leq$ 其子节点的值。 ![小顶堆与大顶堆](heap.assets/min_heap_and_max_heap.png) 堆作为完全二叉树的一个特例，具有以下特性： - 最底层节点靠左填充，其他层的节点都被填满。 -- 我们将二叉树的根节点称为「堆顶」，将底层最靠右的节点称为「堆底」。 +- 我们将二叉树的根节点称为“堆顶”，将底层最靠右的节点称为“堆底”。 - 对于大顶堆（小顶堆），堆顶元素（即根节点）的值分别是最大（最小）的。 ## 堆常用操作 -需要指出的是，许多编程语言提供的是「优先队列 Priority Queue」，这是一种抽象数据结构，定义为具有优先级排序的队列。 +需要指出的是，许多编程语言提供的是「优先队列 priority queue」，这是一种抽象数据结构，定义为具有优先级排序的队列。 -实际上，**堆通常用作实现优先队列，大顶堆相当于元素按从大到小顺序出队的优先队列**。从使用角度来看，我们可以将「优先队列」和「堆」看作等价的数据结构。因此，本书对两者不做特别区分，统一使用「堆」来命名。 +实际上，**堆通常用作实现优先队列，大顶堆相当于元素按从大到小顺序出队的优先队列**。从使用角度来看，我们可以将“优先队列”和“堆”看作等价的数据结构。因此，本书对两者不做特别区分，统一使用“堆“来命名。 堆的常用操作见下表，方法名需要根据编程语言来确定。 +

    表：堆的操作效率

    | 方法名 | 描述 | 时间复杂度 | @@ -524,7 +525,7 @@ ### 元素入堆 -给定元素 `val` ，我们首先将其添加到堆底。添加之后，由于 val 可能大于堆中其他元素，堆的成立条件可能已被破坏。因此，**需要修复从插入节点到根节点的路径上的各个节点**，这个操作被称为「堆化 Heapify」。 +给定元素 `val` ，我们首先将其添加到堆底。添加之后，由于 val 可能大于堆中其他元素，堆的成立条件可能已被破坏。因此，**需要修复从插入节点到根节点的路径上的各个节点**，这个操作被称为「堆化 heapify」。 考虑从入堆节点开始，**从底至顶执行堆化**。具体来说，我们比较插入节点与其父节点的值，如果插入节点更大，则将它们交换。然后继续执行此操作，从底至顶修复堆中的各个节点，直至越过根节点或遇到无须交换的节点时结束。 diff --git a/docs/chapter_heap/top_k.md b/docs/chapter_heap/top_k.md index 01a98f716..9ea00b3e6 100644 --- a/docs/chapter_heap/top_k.md +++ b/docs/chapter_heap/top_k.md @@ -16,7 +16,7 @@ !!! tip - 当 $k = n$ 时，我们可以得到从大到小的序列，等价于「选择排序」算法。 + 当 $k = n$ 时，我们可以得到从大到小的序列，等价于“选择排序”算法。 ## 方法二：排序 diff --git a/docs/chapter_introduction/algorithms_are_everywhere.assets/binary_search_dictionary_step_1.png b/docs/chapter_introduction/algorithms_are_everywhere.assets/binary_search_dictionary_step_1.png index a283003faf94ed3d722c97607db3a8957dcd2008..e1a2e19c7cf56514cf579ba43b98de940c508d65 100644 GIT binary patch literal 49543 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 JOOAWq_&>QcHS7QY literal 50511 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­Q2eXHeOo8v)SvJgj2)o$T4=aYCNf=E`mDWCI!7}rYW z?`5SsP;f z3wSO?xw3s@-ilUmq*qp->XAoq%tu0B+0o4B6yCGKcLPth&HvtfaBlBEskRlf;_Y}KWabUSz z%YZTf5)G)dr4XRQyt$EFycERve&k7QX*eU~ZJuhm?mjo1ozm)8OB3&ssh zMmNuxiYXNA)$k8*j-lyGn3NxoL%F(J$yenTdJ-d=E^K^Fx^VOG0Qk0vmClA*q`4)0 z@I!d*qx^n{CW>zyJRb2*ol%_3(#0V45FONAI#pEDH5d_Xqqs^iExdgk`m0B-9pTL` z?5JC*)LTL&mPAE+?V{yg4B!_1od~-5cHoReFyn&5+o7{XAjIw<{tzO-7_#tw|GtM+ z`kXML;WVSf5}P@lr*bA_Ze7`&PG_*6VM>0-SBQIr)<|VUt8SvBz1$cyb=H(;JN{Or zRh(RsFukZ^8QRYNDQ6fgM&%}PT@fXiZ8acznhK8PT6oL3XT8?z<0Z27@)z zcv9-N9plRVmpuKg?4T_}53W+t2PpyC7xJGpVzfwI8D=E~TQwo;6XhVm4cm(D=Ijy6 zWtnuZx^MA<;TKmDx=9g!4X*4K_RK1sj16gXm(W<*$%FS@UvAP`bIXx0SQBUr8zpl| zEn-ovx7I*40Rd~W)KF&XT67czZo19G+vBmwMr4rqaWFBv>G8@U^~hzso8{`SJiYG0 zL|;%#J?>OLv|4cCSUg~{p0!B)-fh9O5$BPb!{Ru?-V-?73qI+;$r?~*nrabOD>N#g zZ`-yx5~};`@+!f$o4smjyQLCgo4}Kdb<7?cv6C#TR)v4D4WD8=Qizyo>nopP$@^Xl z|DgZO$DreT!jhb-OUuDX&QMhUGw+LQC_(cym1_%|YTd?iGFnYS0o7anb%Z&0DIb55 zLKOL7t-1Em29_3^OpFQ0^%vwGZe@}S!P|B*Vq2kK|f>`F6Rd91;1R3(Zv&Vso81Heft=dt^#90PB8o&xaGS(of z;!1M26ff!6WVrRnH>MXCtX3{M5#>_H(#(YX`FQ0vN1^UZCF7JcZXTJGE1cf~2f5$R zkuykR66a0CM~|Ddk`R5|ZRFwGSDlQelPL!~9T@W=)0T9S+|IJ&PcMfV0309@a4pKQ zqwes?d1pG7_H?#Sr>yX*9a(^bdLiTJYb^LBWk3aNd_S~KBI$1r2 zoV#4@_Q+Bp!*Wu+JV@%^VOZ;!P;HY1p%?$Kr0n$J3P1elucfZTcZJ3@F2pz+sO~?X zJMEkVPReLeJ@bD(_WOCGxI^bRcuXhxKR*Zl(93vB!@g{9_sV-A{M^J_7H1#T3zrVoR2g-e)a%wqE*fkmZ z9mTaXYJy90C^dx?@X~NU(^5Wsj8J_iciuR`-I4p)BrnkRcsezBasbr#t={TQnv$kl zhc6cBV>lhiIoBlaT|8tS}=W_PX-Sod+ zk$>({|9B?;am@Vbg8IiV^^aTbAFt$}E8_pldsHCFn7DdKaIGQlPEI;7C-`Hky|S7r z(szm$*?M_+XubVyEnJ*{VZR|OFGpGkkDOgzhA#l&- zO)nJbg2=8rUb9Wwg~E-A3cYjQ9V|H2ozVU#w;rhzBebIAh zP2`X7ZGnhMa=6Q%{djgP_AO0)eoMaC-yQEauh5iq+ydec|D6tjPk=B?id^dL`+t0R zg!ccXLOD)09kS&Wck(rhb)L!o@fJWsYtV7(PiF!C8+nk)e(Bs*N z_Y5F-Ds6^p3SjUn02Nq)AWt~}$oS4tK1ir90*dsSi$JhZ08(BxoziYu6hI9o8}|at z2DCRYaKctK*K#KJmG**^yby+{a^&RgYc#@lA2a_qn04o+%JipGO^#kI9F%tI9ydsG z9K63M4d3U)d9^bE>~<6oAi@_XKc>!WQeHP605elMx8!4JZvX`^=?%xam((>LDphJO*;0E8WOr33KNhx!8W{S-L( z!iY8z2Pg}qK%%x?n!WF$!Aoi1<`Io+2(FE{^a5zkK~F&DU=p=k4Uur@K9s^p0GRV= zx4|b-zVkdOCOybH$==8>z|w_GPsMdS9AR1OoDY$ozY0ZpV}MnLUbwa-F_lhTbfhe@ zHf{vF8gzF3@xEuTh|odmX^e(aeb5i`w=j)ZjAh4BU>e}|B5}8TN3O_=+eGh`P*zJ8 zz>pDco{OFGeHSr^O2pLaN{F(0J0BjaK8)^GMB-B`98Nnis|2{=h_J) zF!b)k%CJ$LEt`9;HK7n-QsO+}u83Vyf2G&HDG+_0(uAM%pXcGuSMabp0pTMZb`NL; z3hi7k@g6Q*l($L*3{Sdf+cq(|WIy>3P1PXZq9*WH`1CJx5Ll=?jeIt{(DdAMHf`#b zlT_`nITt=L`CT1JtN0s8Jay3`q82gE06iq&E68a?ZOKWEewUB&2;7DGW1y5)_#SJV zFsry&d*hK$@0(y83oL3<}q%&e7neHG}$eU zmhVK2RUPjIADW>aYv#XAUMD_a_6qgg&lQEF12&E_7(mplquDz|sVtr78iX7pp{b+* z>I}fr)OR6R&EsHkGa z`fEmtqR`z!>53hwXjp_cqS(ZxdbT-qUvW&0x@GViuO3f~`ng7k#nvov>4++vV<__d z+|~94@Jteub)RpkKJCWgu8IE!15@&mQ0ByJ3{L)~=wdLBJF2vt149Ubsa&qO<($*P za90A!q6^j816)cQ(;4zDOzYjH-X4^44}vF^0^_(|m=;~nXT8-cz^m}f#aD_UX!b<- zgQ*EfqUPG%4SnB_P^PdG-6$HfUC%%bh zxbrMopmqOj1E6=12;fk@<5FLIZ$1M+F5~{6Mo-iH`pk~$+aeLwlQQ0(K^9Xd6fQN) zJb!m5UG0M~MRWD?lKBdOCnO-;`*uKvGH*^&T_ucRO)`ir*)qN3k0&*gcVtF`di_{P z5edm5G|`khr$0v!z~j3aQJO5bq2>jDJKBPi16j@J05%VOe@zn*YcK|1L`J@zmw*=` zJk?)oqhI!Gg{E#{aYG{7G|+FFoGReNYTETtp^MVFn0BYyP_*0mUc|d7|5rT=Fm6mn z48U#%SE&lC)Liag?~fYhrv^uHa~h#&aeRNNXTR(c#)o`8_NuYWr*Poh>aI;Lyq^fY zwCwfKhxjdOGG(@@)_gpjmj+YDs_S`qP*KIY0|b2xjq z@oKny1vGWhkGzg2|A0_p&TBBA)u-|b;0~3yhx=o8f%AZX;~5Hs4UN1PurJ0ec?g{c z)&{9J1Nt0O64{rrm8z8eK{ue z@rDKe9w69Mp&J-HBbJ1fa%lz@=V35PynQKAt;7|$frzvw^E?P9`Zrn_7PGck=;efR zl|yHS>GIBhkPGKAHH9}d-4HFGo2|YeUxBBDHWbBL58oJDG>M0^3nH!cZV7Vt*=o0! z8$p5D0~Rcm4c^K;|1B8cJX!4=src#4keeINBz+WU=OKfTmR`ym$Yr(477KvXPyk;+ z@C(cTJSIj&H1)*<$``oHXx_oUzWzI z;wjtXBY&P`*9ywpLQL*SIGTujzFGmrLpZ3bFg2{a~&{8WFo)^ak#4;E_dnU4eZG{t%SqGsNt_us% zRyl}GsB&cFc+UjIfo+CUBCZ1i7+tl=cI4Qai5wUhfD|k`SXJ-6By3L?CoE;fjE;lJ zGqd&XO$UmP13b0rC0D;U-nmWoTzy(#Jdp`d&VJ{*<&iOGwE(hO6=^vQCZS!cS?Kzr zlB&ztN#wj_sK0+=N8RD0gWWN}zFdpYKSb{7Dv1;fyig`}A72|k4z?vqGwi*g&mnYB zQ?YvHa!tOGgg3DHZ^O+g(hFPwVI)YN@N&jqC5ZuK*Fgl3smu9f*3X0An}EteCY4 ze%vC0AY<&((I@vl?ule;{ptntcIHGY=ho?m%y#WtcL=K7Ok_8U8>0=bZfb}o4QzO& zPp#P=VeKt<3)k*|X2b;aKCA}Y-%_JFuvZ2yzMIGIhYjGXLk5a$I`3SAm0V})%|k2` z#Dj_P>5ZR=NXUY+mo4E~!^;%jF85%Oc;tzAq;)jtdU#~NX;^A1qZmjjd{e8c8403U zzlEq}mbU*piO(*uiDZVEfHX_G02%5CC5=5cC3nC4?J1LQ&+I$%mm&h_!jz>^;M|+o zxGVMp-lRUI!sTWe?ytfwaXnv2YVM&i*?NQJ{vele*7-f25+{dDWq1zAjvN8DA7};{ z%qLIL+ie>;cMS8(6|30YvBS+n&wPY=n?scY&8rNSj%mwMl}RrbK1x`WqeWri>IWUH zU6fruUheVxhi_vE36lned5dNC8Qv6|^$(MQzcdXv8DVEyM@D`{{=4f5YWZRSNA>4% zB4LSRBsDjs1Is8>vL%IYXY5SU-}K!63#0(R`fKtv#DU7nfl;8JO)TeO4O|%^Z#?=t z->eCyHB1Pidzm@8k*}F?1-ZO8b($U7z2`2Z`x8{eS!p-@OQ)N_f~R=rOx2P1g{!X% zD?^mG-@`5TQ9D;@xT>5+jt8$K7@gS)fq6}Ir_{z|&9sKgLwl?Kay{bk<4k=dNts*r zA)E43lD=w{yy6$a@N?*MOZ#-cl5Ee}LZjAQNp@)-hV<+J4CjMA_>Qlk#vr_U$dq|J z7sRe>)3Kok603cE412POm1(uQn(p=GgMo&j7gA1FU2giV>Us)FPcGOQEKe&^i{a>R z$EyDSCVY=8Fo3p4-BGvoeV79vuOmTf8)z=;O7eNc(j>g$7ccK8j<;gLt`x#7@!9K< zLmYqi#X#5lo&G~w7=t>^!4oU5LW&ysFI1x#drs7rdfWOUl_1WUKj=Z_Y(+s$+Bkz? z1?+vckXtY`?2-aOM}}R^jPJiTAsF77@E)Q5$DTbNT)HgVrmZ6QwL(ST>PnmAf*uL6;;PX%2=$ZOncE#l@}sColn zfsH03GS;>>)G{tdaC_Q zU&Bkk*U@fQ<9hxf^x^*wy2h0uLFx!RvfoFuE{*F z!)@KurvxOjg8B-O-?E_MAF1)64^_%p_YC zskWs?@1$N_);4lQ2&b$uY;R~{RWP!OU_TX%)xfzg+>EtzTY=MLfygOaeYUIOifOmm zpi7-#;MFtQ?E({X?p{NGm_yeVG|9Or%)Y9ncF#i^JJJKu*?NbtXdHIMcp#|nJP~C- z{z?`{r%3mv4vYVQl0+?_WAC|J6ezUX{w=ji%J^tWzWVH-aeRzy!~;pks(x3I?~||G zLS1oxTqLJRGBZ)I*k@IzNMzGW1AKHoGRAsfIt!h@@OR74n=kDz6TI>}#*>~hz)&WQ zo=i(|YYFKu0*=-{mW#qi0eLgWb1+PzEEw%b_M7+`_qMtJC)o^S?Bha7ltX`FT69nc zRRYiHbp+YI#e3WhSZBvtU_IYDMtHK)A=FtXxtRx};_OA{r{Vj{a*cCx?8c+P)hwxa z?Mv*>b&fQ-h6LRW^cMID`|kEHU&LLu!qK&Db`mhouRL;At>osWjDUNN*Jf+n*hLfh zgy6&9rW4Y7Tay*TFa)gWwgK}ZuQ9RVrKCm^270lIN&BD&3dl9J0^-W!%zz4Avkz!-R8L+6qJvfi3)+1`xQq& zlXKi{YDW3il-d2OJ|J#Ow7HJIJs^HTb3=TaSZ#AZl05Df=}$j=*uMb^(%jMRTa2s7 z8lHTED|0z|>We9Teu$FJQH)gez*S_9!d~YJ(>F!GF`o>s&DVz5wU$*pNSoMWzX1g# zXRgE|Qy>_$+}sfm)10@yK1I}SlWFD0)l_7fVz+<$x1l$sZL~F# zEA2Dp%*aMcoc&%F>sFu!ZY?JVsh$T`%k4syqA>qAV)BI}MiB(?1Fpts)y)y0)| zk)&)vAZg1pr%qfLqQ60tK}?`JXC#lcMHwDut3k(T_%va7K&K-&@5>UOAKdpRs~!t5 z(Fi8!hcx3Yk`vp`ZRn^dFKv_&kw>F=2KdwnqEWy=4okur>O zGkJsoV}~C>tq{rNA^O^AyhbQi4Ou_0r73(BSC@7v2g4<5U!noElR`p3A=}Z!i&2rK zzx{Plv%weY`}v_dNlGhEFlvSYD``=(P6PkCTz$EE->qE4Chj~?Kz+(KWwLoO88!Lp z$V_&fYvYtQJ8;C*Y$YMq8))`NN8Z2rX{X~v|`M=lgzqY(Qx#bWiH zf^qi|b8Oq_^ra--=?MqnMUPb9MO4DKbr4I|wQUEr*xT+AqprWzw&9N@>TQ=Oxq`h( z)(yLp@>c+j(*;S*QKF7$+l)uO8Pk~XHSmqCd3Tt;b{-Y>{c;7;HXjRyQ3vTX$0ORY zgl;rRe6+i$G%;WiNn5i5>D2)|Pa%G(jyZOgrg4X(kx4aJ=`5q4TFk)tEz zsS4FOh2A6E_L{qzXhP1v4uA0ogU*>Li^|FW&OO_uryrsH_lmDvZQ3+OhE_S z2JnZYA2Ah^^1T~p(FY?=_B^7VZ9*^Ky-D`jKf zS(`};^(@XHBrEMaA~-nqnE%SGAG|R$wm-7bqYD$7Ub-o|Y#vaQ9m1m-!x4E=Iw0(= zx_=@u!!8PlGkd=^ToVd4fvO&ZI>nqnCN;O8H`zctT)1Q$5$*}M2CDUmgBsaE@_L)e zTNk@O-T~|4l|=O4zlP?|kkxtc&;mRin?_(4f!s@ZnZ}HZeDlLO1ob4gUQ{|uBIGN1 z+wf6i%r^uXa=9kYbZiI8?R)bwl-g=Fu`Snp34t{;U8)A4L?YKKac9F)I03bdTI^ml k{59lBfSu~Me{Ox#_}zI!eH)b" ![binary_search_dictionary_step_5](algorithms_are_everywhere.assets/binary_search_dictionary_step_5.png) -查阅字典这个小学生必备技能，实际上就是著名的二分查找算法。从数据结构的角度，我们可以把字典视为一个已排序的「数组」；从算法的角度，我们可以将上述查字典的一系列操作看作是「二分查找」。 +查阅字典这个小学生必备技能，实际上就是著名的二分查找算法。从数据结构的角度，我们可以把字典视为一个已排序的“数组”；从算法的角度，我们可以将上述查字典的一系列操作看作是“二分查找”。 **例二：整理扑克**。我们在打牌时，每局都需要整理扑克牌，使其从小到大排列，实现流程如下图所示。 @@ -35,7 +35,7 @@ ![扑克排序步骤](algorithms_are_everywhere.assets/playing_cards_sorting.png) -上述整理扑克牌的方法本质上是「插入排序」算法，它在处理小型数据集时非常高效。许多编程语言的排序库函数中都存在插入排序的身影。 +上述整理扑克牌的方法本质上是“插入排序”算法，它在处理小型数据集时非常高效。许多编程语言的排序库函数中都存在插入排序的身影。 **例三：货币找零**。假设我们在超市购买了 $69$ 元的商品，给收银员付了 $100$ 元，则收银员需要找我们 $31$ 元。他会很自然地完成如下图所示的思考。 @@ -47,7 +47,7 @@ ![货币找零过程](algorithms_are_everywhere.assets/greedy_change.png) -在以上步骤中，我们每一步都采取当前看来最好的选择（尽可能用大面额的货币），最终得到了可行的找零方案。从数据结构与算法的角度看，这种方法本质上是「贪心算法」。 +在以上步骤中，我们每一步都采取当前看来最好的选择（尽可能用大面额的货币），最终得到了可行的找零方案。从数据结构与算法的角度看，这种方法本质上是“贪心”算法。 小到烹饪一道菜，大到星际航行，几乎所有问题的解决都离不开算法。计算机的出现使我们能够通过编程将数据结构存储在内存中，同时编写代码调用 CPU 和 GPU 执行算法。这样一来，我们就能把生活中的问题转移到计算机上，以更高效的方式解决各种复杂问题。 diff --git a/docs/chapter_introduction/what_is_dsa.md b/docs/chapter_introduction/what_is_dsa.md index 4b7e3ec19..06b6d20a6 100644 --- a/docs/chapter_introduction/what_is_dsa.md +++ b/docs/chapter_introduction/what_is_dsa.md @@ -50,4 +50,4 @@ !!! tip "约定俗成的简称" - 在实际讨论时，我们通常会将「数据结构与算法」简称为「算法」。比如众所周知的 LeetCode 算法题目，实际上同时考察了数据结构和算法两方面的知识。 + 在实际讨论时，我们通常会将“数据结构与算法”简称为“算法”。比如众所周知的 LeetCode 算法题目，实际上同时考察了数据结构和算法两方面的知识。 diff --git a/docs/chapter_preface/suggestions.md b/docs/chapter_preface/suggestions.md index 4741ccd5b..e0fe3a8ac 100644 --- a/docs/chapter_preface/suggestions.md +++ b/docs/chapter_preface/suggestions.md @@ -7,10 +7,10 @@ ## 行文风格约定 - 标题后标注 `*` 的是选读章节，内容相对困难。如果你的时间有限，建议可以先跳过。 -- 文章中的重要名词会用 `「 」` 括号标注，例如 `「数组 Array」` 。请务必记住这些名词，包括英文翻译，以便后续阅读文献时使用。 -- **加粗的文字** 表示重点内容或总结性语句，这类文字值得特别关注。 - 专有名词和有特指含义的词句会使用 `“双引号”` 标注，以避免歧义。 -- 涉及到编程语言之间不一致的名词，本书均以 Python 为准，例如使用 $\text{None}$ 来表示“空”。 +- 重要专有名词及其英文翻译会用 `「 」` 括号标注，例如 `「数组 array」` 。建议记住它们，以便阅读文献。 +- **加粗的文字** 表示重点内容或总结性语句，这类文字值得特别关注。 +- 当涉及到编程语言之间不一致的名词时，本书均以 Python 为准，例如使用 $\text{None}$ 来表示“空”。 - 本书部分放弃了编程语言的注释规范，以换取更加紧凑的内容排版。注释主要分为三种类型：标题注释、内容注释、多行注释。 === "Java" diff --git a/docs/chapter_searching/binary_search.md b/docs/chapter_searching/binary_search.md index 3487acd8e..e11a28616 100755 --- a/docs/chapter_searching/binary_search.md +++ b/docs/chapter_searching/binary_search.md @@ -1,6 +1,6 @@ # 二分查找 -「二分查找 Binary Search」是一种基于分治思想的高效搜索算法。它利用数据的有序性，每轮减少一半搜索范围，直至找到目标元素或搜索区间为空为止。 +「二分查找 binary search」是一种基于分治思想的高效搜索算法。它利用数据的有序性，每轮减少一半搜索范围，直至找到目标元素或搜索区间为空为止。 !!! question diff --git a/docs/chapter_searching/searching_algorithm_revisited.md b/docs/chapter_searching/searching_algorithm_revisited.md index 8f6cdc6f6..0a687b7cc 100644 --- a/docs/chapter_searching/searching_algorithm_revisited.md +++ b/docs/chapter_searching/searching_algorithm_revisited.md @@ -1,6 +1,6 @@ # 重识搜索算法 -「搜索算法 Searching Algorithm」用于在数据结构（例如数组、链表、树或图）中搜索一个或一组满足特定条件的元素。 +「搜索算法 searching algorithm」用于在数据结构（例如数组、链表、树或图）中搜索一个或一组满足特定条件的元素。 根据实现思路，搜索算法总体可分为两种： @@ -13,8 +13,8 @@ 暴力搜索通过遍历数据结构的每个元素来定位目标元素。 -- 「线性搜索」适用于数组和链表等线性数据结构。它从数据结构的一端开始，逐个访问元素，直到找到目标元素或到达另一端仍没有找到目标元素为止。 -- 「广度优先搜索」和「深度优先搜索」是图和树的两种遍历策略。广度优先搜索从初始节点开始逐层搜索，由近及远地访问各个节点。深度优先搜索是从初始节点开始，沿着一条路径走到头为止，再回溯并尝试其他路径，直到遍历完整个数据结构。 +- “线性搜索”适用于数组和链表等线性数据结构。它从数据结构的一端开始，逐个访问元素，直到找到目标元素或到达另一端仍没有找到目标元素为止。 +- “广度优先搜索”和“深度优先搜索”是图和树的两种遍历策略。广度优先搜索从初始节点开始逐层搜索，由近及远地访问各个节点。深度优先搜索是从初始节点开始，沿着一条路径走到头为止，再回溯并尝试其他路径，直到遍历完整个数据结构。 暴力搜索的优点是简单且通用性好，**无须对数据做预处理和借助额外的数据结构**。 @@ -24,9 +24,9 @@ 自适应搜索利用数据的特有属性（例如有序性）来优化搜索过程，从而更高效地定位目标元素。 -- 「二分查找」利用数据的有序性实现高效查找，仅适用于数组。 -- 「哈希查找」利用哈希表将搜索数据和目标数据建立为键值对映射，从而实现查询操作。 -- 「树查找」在特定的树结构（例如二叉搜索树）中，基于比较节点值来快速排除节点，从而定位目标元素。 +- “二分查找”利用数据的有序性实现高效查找，仅适用于数组。 +- “哈希查找”利用哈希表将搜索数据和目标数据建立为键值对映射，从而实现查询操作。 +- “树查找”在特定的树结构（例如二叉搜索树）中，基于比较节点值来快速排除节点，从而定位目标元素。 此类算法的优点是效率高，**时间复杂度可达到 $O(\log n)$ 甚至 $O(1)$** 。 @@ -43,6 +43,7 @@ ![多种搜索策略](searching_algorithm_revisited.assets/searching_algorithms.png) 上述几种方法的操作效率与特性如下表所示。 +

    表：查找算法效率对比

    | | 线性搜索 | 二分查找 | 树查找 | 哈希查找 | diff --git a/docs/chapter_sorting/bubble_sort.md b/docs/chapter_sorting/bubble_sort.md index b987155b7..65d568e00 100755 --- a/docs/chapter_sorting/bubble_sort.md +++ b/docs/chapter_sorting/bubble_sort.md @@ -1,6 +1,6 @@ # 冒泡排序 -「冒泡排序 Bubble Sort」通过连续地比较与交换相邻元素实现排序。这个过程就像气泡从底部升到顶部一样，因此得名冒泡排序。 +「冒泡排序 bubble sort」通过连续地比较与交换相邻元素实现排序。这个过程就像气泡从底部升到顶部一样，因此得名冒泡排序。 我们可以利用元素交换操作模拟上述过程：从数组最左端开始向右遍历，依次比较相邻元素大小，如果“左元素 > 右元素”就交换它俩。遍历完成后，最大的元素会被移动到数组的最右端。 diff --git a/docs/chapter_sorting/bucket_sort.md b/docs/chapter_sorting/bucket_sort.md index 203f1c2f2..d03dab937 100644 --- a/docs/chapter_sorting/bucket_sort.md +++ b/docs/chapter_sorting/bucket_sort.md @@ -2,7 +2,7 @@ 前述的几种排序算法都属于“基于比较的排序算法”，它们通过比较元素间的大小来实现排序。此类排序算法的时间复杂度无法超越 $O(n \log n)$ 。接下来，我们将探讨几种“非比较排序算法”，它们的时间复杂度可以达到线性阶。 -「桶排序 Bucket Sort」是分治思想的一个典型应用。它通过设置一些具有大小顺序的桶，每个桶对应一个数据范围，将数据平均分配到各个桶中；然后，在每个桶内部分别执行排序；最终按照桶的顺序将所有数据合并。 +「桶排序 bucket sort」是分治思想的一个典型应用。它通过设置一些具有大小顺序的桶，每个桶对应一个数据范围，将数据平均分配到各个桶中；然后，在每个桶内部分别执行排序；最终按照桶的顺序将所有数据合并。 ## 算法流程 diff --git a/docs/chapter_sorting/counting_sort.md b/docs/chapter_sorting/counting_sort.md index 671137de9..a1a29adbc 100644 --- a/docs/chapter_sorting/counting_sort.md +++ b/docs/chapter_sorting/counting_sort.md @@ -1,6 +1,6 @@ # 计数排序 -「计数排序 Counting Sort」通过统计元素数量来实现排序，通常应用于整数数组。 +「计数排序 counting sort」通过统计元素数量来实现排序，通常应用于整数数组。 ## 简单实现 @@ -92,7 +92,7 @@ 细心的同学可能发现，**如果输入数据是对象，上述步骤 `3.` 就失效了**。例如，输入数据是商品对象，我们想要按照商品价格（类的成员变量）对商品进行排序，而上述算法只能给出价格的排序结果。 -那么如何才能得到原数据的排序结果呢？我们首先计算 `counter` 的「前缀和」。顾名思义，索引 `i` 处的前缀和 `prefix[i]` 等于数组前 `i` 个元素之和，即 +那么如何才能得到原数据的排序结果呢？我们首先计算 `counter` 的“前缀和”。顾名思义，索引 `i` 处的前缀和 `prefix[i]` 等于数组前 `i` 个元素之和，即： $$ \text{prefix}[i] = \sum_{j=0}^i \text{counter[j]} diff --git a/docs/chapter_sorting/heap_sort.md b/docs/chapter_sorting/heap_sort.md index 9aabe6c11..3007792bc 100644 --- a/docs/chapter_sorting/heap_sort.md +++ b/docs/chapter_sorting/heap_sort.md @@ -2,9 +2,9 @@ !!! tip - 阅读本节前，请确保已学完「堆」章节。 + 阅读本节前，请确保已学完“堆“章节。 -「堆排序 Heap Sort」是一种基于堆数据结构实现的高效排序算法。我们可以利用已经学过的“建堆操作”和“元素出堆操作”实现堆排序： +「堆排序 heap sort」是一种基于堆数据结构实现的高效排序算法。我们可以利用已经学过的“建堆操作”和“元素出堆操作”实现堆排序： 1. 输入数组并建立小顶堆，此时最小元素位于堆顶。 2. 不断执行出堆操作，依次记录出堆元素，即可得到从小到大排序的序列。 diff --git a/docs/chapter_sorting/insertion_sort.md b/docs/chapter_sorting/insertion_sort.md index 68f7d8435..6fbcd9c26 100755 --- a/docs/chapter_sorting/insertion_sort.md +++ b/docs/chapter_sorting/insertion_sort.md @@ -1,6 +1,6 @@ # 插入排序 -「插入排序 Insertion Sort」是一种简单的排序算法，它的工作原理与手动整理一副牌的过程非常相似。 +「插入排序 insertion sort」是一种简单的排序算法，它的工作原理与手动整理一副牌的过程非常相似。 具体来说，我们在未排序区间选择一个基准元素，将该元素与其左侧已排序区间的元素逐一比较大小，并将该元素插入到正确的位置。 diff --git a/docs/chapter_sorting/merge_sort.md b/docs/chapter_sorting/merge_sort.md index 11859ded7..4ae5e5ee2 100755 --- a/docs/chapter_sorting/merge_sort.md +++ b/docs/chapter_sorting/merge_sort.md @@ -1,6 +1,6 @@ # 归并排序 -「归并排序 Merge Sort」基于分治思想实现排序，包含“划分”和“合并”两个阶段： +「归并排序 merge sort」基于分治思想实现排序，包含“划分”和“合并”两个阶段： 1. **划分阶段**：通过递归不断地将数组从中点处分开，将长数组的排序问题转换为短数组的排序问题。 2. **合并阶段**：当子数组长度为 1 时终止划分，开始合并，持续地将左右两个较短的有序数组合并为一个较长的有序数组，直至结束。 diff --git a/docs/chapter_sorting/quick_sort.md b/docs/chapter_sorting/quick_sort.md index a8a11e0c0..7d70f08db 100755 --- a/docs/chapter_sorting/quick_sort.md +++ b/docs/chapter_sorting/quick_sort.md @@ -1,8 +1,8 @@ # 快速排序 -「快速排序 Quick Sort」是一种基于分治思想的排序算法，运行高效，应用广泛。 +「快速排序 quick sort」是一种基于分治思想的排序算法，运行高效，应用广泛。 -快速排序的核心操作是「哨兵划分」，其目标是：选择数组中的某个元素作为“基准数”，将所有小于基准数的元素移到其左侧，而大于基准数的元素移到其右侧。具体来说，哨兵划分的流程为： +快速排序的核心操作是“哨兵划分”，其目标是：选择数组中的某个元素作为“基准数”，将所有小于基准数的元素移到其左侧，而大于基准数的元素移到其右侧。具体来说，哨兵划分的流程为： 1. 选取数组最左端元素作为基准数，初始化两个指针 `i` 和 `j` 分别指向数组的两端。 2. 设置一个循环，在每轮中使用 `i`（`j`）分别寻找第一个比基准数大（小）的元素，然后交换这两个元素。 @@ -133,8 +133,8 @@ ## 算法流程 -1. 首先，对原数组执行一次「哨兵划分」，得到未排序的左子数组和右子数组。 -2. 然后，对左子数组和右子数组分别递归执行「哨兵划分」。 +1. 首先，对原数组执行一次“哨兵划分”，得到未排序的左子数组和右子数组。 +2. 然后，对左子数组和右子数组分别递归执行“哨兵划分”。 3. 持续递归，直至子数组长度为 1 时终止，从而完成整个数组的排序。 ![快速排序流程](quick_sort.assets/quick_sort_overview.png) @@ -219,15 +219,15 @@ ## 快排为什么快？ -从名称上就能看出，快速排序在效率方面应该具有一定的优势。尽管快速排序的平均时间复杂度与「归并排序」和「堆排序」相同，但通常快速排序的效率更高，原因如下： +从名称上就能看出，快速排序在效率方面应该具有一定的优势。尽管快速排序的平均时间复杂度与“归并排序”和“堆排序”相同，但通常快速排序的效率更高，原因如下： - **出现最差情况的概率很低**：虽然快速排序的最差时间复杂度为 $O(n^2)$ ，没有归并排序稳定，但在绝大多数情况下，快速排序能在 $O(n \log n)$ 的时间复杂度下运行。 -- **缓存使用效率高**：在执行哨兵划分操作时，系统可将整个子数组加载到缓存，因此访问元素的效率较高。而像「堆排序」这类算法需要跳跃式访问元素，从而缺乏这一特性。 -- **复杂度的常数系数低**：在上述三种算法中，快速排序的比较、赋值、交换等操作的总数量最少。这与「插入排序」比「冒泡排序」更快的原因类似。 +- **缓存使用效率高**：在执行哨兵划分操作时，系统可将整个子数组加载到缓存，因此访问元素的效率较高。而像“堆排序”这类算法需要跳跃式访问元素，从而缺乏这一特性。 +- **复杂度的常数系数低**：在上述三种算法中，快速排序的比较、赋值、交换等操作的总数量最少。这与“插入排序”比“冒泡排序”更快的原因类似。 ## 基准数优化 -**快速排序在某些输入下的时间效率可能降低**。举一个极端例子，假设输入数组是完全倒序的，由于我们选择最左端元素作为基准数，那么在哨兵划分完成后，基准数被交换至数组最右端，导致左子数组长度为 $n - 1$ 、右子数组长度为 $0$ 。如此递归下去，每轮哨兵划分后的右子数组长度都为 $0$ ，分治策略失效，快速排序退化为「冒泡排序」。 +**快速排序在某些输入下的时间效率可能降低**。举一个极端例子，假设输入数组是完全倒序的，由于我们选择最左端元素作为基准数，那么在哨兵划分完成后，基准数被交换至数组最右端，导致左子数组长度为 $n - 1$ 、右子数组长度为 $0$ 。如此递归下去，每轮哨兵划分后的右子数组长度都为 $0$ ，分治策略失效，快速排序退化为“冒泡排序”。 为了尽量避免这种情况发生，**我们可以优化哨兵划分中的基准数的选取策略**。例如，我们可以随机选取一个元素作为基准数。然而，如果运气不佳，每次都选到不理想的基准数，效率仍然不尽如人意。 diff --git a/docs/chapter_sorting/radix_sort.md b/docs/chapter_sorting/radix_sort.md index a00f87783..f5f51b06b 100644 --- a/docs/chapter_sorting/radix_sort.md +++ b/docs/chapter_sorting/radix_sort.md @@ -2,14 +2,14 @@ 上一节我们介绍了计数排序，它适用于数据量 $n$ 较大但数据范围 $m$ 较小的情况。假设我们需要对 $n = 10^6$ 个学号进行排序，而学号是一个 $8$ 位数字，这意味着数据范围 $m = 10^8$ 非常大，使用计数排序需要分配大量内存空间，而基数排序可以避免这种情况。 -「基数排序 Radix Sort」的核心思想与计数排序一致，也通过统计个数来实现排序。在此基础上，基数排序利用数字各位之间的递进关系，依次对每一位进行排序，从而得到最终的排序结果。 +「基数排序 radix sort」的核心思想与计数排序一致，也通过统计个数来实现排序。在此基础上，基数排序利用数字各位之间的递进关系，依次对每一位进行排序，从而得到最终的排序结果。 ## 算法流程 以学号数据为例，假设数字的最低位是第 $1$ 位，最高位是第 $8$ 位，基数排序的步骤如下： 1. 初始化位数 $k = 1$ 。 -2. 对学号的第 $k$ 位执行「计数排序」。完成后，数据会根据第 $k$ 位从小到大排序。 +2. 对学号的第 $k$ 位执行“计数排序”。完成后，数据会根据第 $k$ 位从小到大排序。 3. 将 $k$ 增加 $1$ ，然后返回步骤 `2.` 继续迭代，直到所有位都排序完成后结束。 ![基数排序算法流程](radix_sort.assets/radix_sort_overview.png) diff --git a/docs/chapter_sorting/selection_sort.md b/docs/chapter_sorting/selection_sort.md index 1207c3b4a..549c32726 100644 --- a/docs/chapter_sorting/selection_sort.md +++ b/docs/chapter_sorting/selection_sort.md @@ -1,6 +1,6 @@ # 选择排序 -「选择排序 Selection Sort」的工作原理非常直接：开启一个循环，每轮从未排序区间选择最小的元素，将其放到已排序区间的末尾。 +「选择排序 selection sort」的工作原理非常直接：开启一个循环，每轮从未排序区间选择最小的元素，将其放到已排序区间的末尾。 设数组的长度为 $n$ ，选择排序的算法流程如下： diff --git a/docs/chapter_sorting/sorting_algorithm.md b/docs/chapter_sorting/sorting_algorithm.md index f8c201a43..e1e739496 100644 --- a/docs/chapter_sorting/sorting_algorithm.md +++ b/docs/chapter_sorting/sorting_algorithm.md @@ -1,6 +1,6 @@ # 排序算法 -「排序算法 Sorting Algorithm」用于对一组数据按照特定顺序进行排列。排序算法有着广泛的应用，因为有序数据通常能够被更有效地查找、分析和处理。 +「排序算法 sorting algorithm」用于对一组数据按照特定顺序进行排列。排序算法有着广泛的应用，因为有序数据通常能够被更有效地查找、分析和处理。 在排序算法中，数据类型可以是整数、浮点数、字符或字符串等；顺序的判断规则可根据需求设定，如数字大小、字符 ASCII 码顺序或自定义规则。 @@ -12,9 +12,9 @@ **就地性**：顾名思义，「原地排序」通过在原数组上直接操作实现排序，无须借助额外的辅助数组，从而节省内存。通常情况下，原地排序的数据搬运操作较少，运行速度也更快。 -**稳定性**：「稳定排序」在完成排序后，相等元素在数组中的相对顺序不发生改变。稳定排序是优良特性，也是多级排序场景的必要条件。 +**稳定性**：「稳定排序」在完成排序后，相等元素在数组中的相对顺序不发生改变。 -假设我们有一个存储学生信息的表格，第 1, 2 列分别是姓名和年龄。在这种情况下，「非稳定排序」可能导致输入数据的有序性丧失。 +稳定排序是多级排序场景的必要条件。假设我们有一个存储学生信息的表格，第 1 列和第 2 列分别是姓名和年龄。在这种情况下，「非稳定排序」可能导致输入数据的有序性丧失。 ```shell # 输入数据是按照姓名排序好的 diff --git a/docs/chapter_stack_and_queue/deque.md b/docs/chapter_stack_and_queue/deque.md index 13dc1fec7..c155ef85c 100644 --- a/docs/chapter_stack_and_queue/deque.md +++ b/docs/chapter_stack_and_queue/deque.md @@ -1,12 +1,13 @@ # 双向队列 -对于队列，我们仅能在头部删除或在尾部添加元素。然而，「双向队列 Deque」提供了更高的灵活性，允许在头部和尾部执行元素的添加或删除操作。 +对于队列，我们仅能在头部删除或在尾部添加元素。然而，「双向队列 deque」提供了更高的灵活性，允许在头部和尾部执行元素的添加或删除操作。 ![双向队列的操作](deque.assets/deque_operations.png) ## 双向队列常用操作 双向队列的常用操作如下表所示，具体的方法名称需要根据所使用的编程语言来确定。 +

    表：双向队列操作效率

    | 方法名 | 描述 | 时间复杂度 | @@ -323,7 +324,7 @@ 回顾上一节内容，我们使用普通单向链表来实现队列，因为它可以方便地删除头节点（对应出队操作）和在尾节点后添加新节点（对应入队操作）。 -对于双向队列而言，头部和尾部都可以执行入队和出队操作。换句话说，双向队列需要实现另一个对称方向的操作。为此，我们采用「双向链表」作为双向队列的底层数据结构。 +对于双向队列而言，头部和尾部都可以执行入队和出队操作。换句话说，双向队列需要实现另一个对称方向的操作。为此，我们采用“双向链表”作为双向队列的底层数据结构。 我们将双向链表的头节点和尾节点视为双向队列的队首和队尾，同时实现在两端添加和删除节点的功能。 diff --git a/docs/chapter_stack_and_queue/queue.md b/docs/chapter_stack_and_queue/queue.md index ffb6eedf0..5bba5771d 100755 --- a/docs/chapter_stack_and_queue/queue.md +++ b/docs/chapter_stack_and_queue/queue.md @@ -1,14 +1,15 @@ # 队列 -「队列 Queue」是一种遵循先入先出（First In, First Out）规则的线性数据结构。顾名思义，队列模拟了排队现象，即新来的人不断加入队列的尾部，而位于队列头部的人逐个离开。 +「队列 queue」是一种遵循先入先出规则的线性数据结构。顾名思义，队列模拟了排队现象，即新来的人不断加入队列的尾部，而位于队列头部的人逐个离开。 -我们把队列的头部称为「队首」，尾部称为「队尾」，把将元素加入队尾的操作称为「入队」，删除队首元素的操作称为「出队」。 +我们把队列的头部称为“队首”，尾部称为“队尾”，把将元素加入队尾的操作称为“入队”，删除队首元素的操作称为“出队”。 ![队列的先入先出规则](queue.assets/queue_operations.png) ## 队列常用操作 队列的常见操作如下表所示。需要注意的是，不同编程语言的方法名称可能会有所不同。我们在此采用与栈相同的方法命名。 +

    表：队列操作效率

    | 方法名 | 描述 | 时间复杂度 | @@ -288,7 +289,7 @@ ### 基于链表的实现 -对于链表实现，我们可以将链表的「头节点」和「尾节点」分别视为队首和队尾，规定队尾仅可添加节点，而队首仅可删除节点。 +对于链表实现，我们可以将链表的“头节点”和“尾节点”分别视为“队首”和“队尾”，规定队尾仅可添加节点，队首仅可删除节点。 === "LinkedListQueue" ![基于链表实现队列的入队出队操作](queue.assets/linkedlist_queue.png) @@ -395,7 +396,7 @@ === "pop()" ![array_queue_pop](queue.assets/array_queue_pop.png) -你可能会发现一个问题：在不断进行入队和出队的过程中，`front` 和 `rear` 都在向右移动，**当它们到达数组尾部时就无法继续移动了**。为解决此问题，我们可以将数组视为首尾相接的「环形数组」。 +你可能会发现一个问题：在不断进行入队和出队的过程中，`front` 和 `rear` 都在向右移动，**当它们到达数组尾部时就无法继续移动了**。为解决此问题，我们可以将数组视为首尾相接的“环形数组”。 对于环形数组，我们需要让 `front` 或 `rear` 在越过数组尾部时，直接回到数组头部继续遍历。这种周期性规律可以通过“取余操作”来实现，代码如下所示。 diff --git a/docs/chapter_stack_and_queue/stack.md b/docs/chapter_stack_and_queue/stack.md index 1e95e14c1..53843cf34 100755 --- a/docs/chapter_stack_and_queue/stack.md +++ b/docs/chapter_stack_and_queue/stack.md @@ -1,16 +1,17 @@ # 栈 -「栈 Stack」是一种遵循先入后出（First In, Last Out）原则的线性数据结构。 +「栈 stack」是一种遵循先入后出的逻辑的线性数据结构。 我们可以将栈类比为桌面上的一摞盘子，如果需要拿出底部的盘子，则需要先将上面的盘子依次取出。我们将盘子替换为各种类型的元素（如整数、字符、对象等），就得到了栈数据结构。 -在栈中，我们把堆叠元素的顶部称为「栈顶」，底部称为「栈底」。将把元素添加到栈顶的操作叫做「入栈」，而删除栈顶元素的操作叫做「出栈」。 +在栈中，我们把堆叠元素的顶部称为“栈顶”，底部称为“栈底”。将把元素添加到栈顶的操作叫做“入栈”，而删除栈顶元素的操作叫做“出栈”。 ![栈的先入后出规则](stack.assets/stack_operations.png) ## 栈常用操作 栈的常用操作如下表所示，具体的方法名需要根据所使用的编程语言来确定。在此，我们以常见的 `push()` , `pop()` , `peek()` 命名为例。 +

    表：栈的操作效率

    | 方法 | 描述 | 时间复杂度 | @@ -19,7 +20,7 @@ | pop() | 栈顶元素出栈 | $O(1)$ | | peek() | 访问栈顶元素 | $O(1)$ | -通常情况下，我们可以直接使用编程语言内置的栈类。然而，某些语言可能没有专门提供栈类，这时我们可以将该语言的「数组」或「链表」视作栈来使用，并通过“脑补”来忽略与栈无关的操作。 +通常情况下，我们可以直接使用编程语言内置的栈类。然而，某些语言可能没有专门提供栈类，这时我们可以将该语言的“数组”或“链表”视作栈来使用，并在程序逻辑上忽略与栈无关的操作。 === "Java" @@ -377,7 +378,7 @@ ### 基于数组的实现 -在基于「数组」实现栈时，我们可以将数组的尾部作为栈顶。在这样的设计下，入栈与出栈操作就分别对应在数组尾部添加元素与删除元素，时间复杂度都为 $O(1)$ 。 +使用数组实现栈时，我们可以将数组的尾部作为栈顶。在这样的设计下，入栈与出栈操作就分别对应在数组尾部添加元素与删除元素，时间复杂度都为 $O(1)$ 。 === "ArrayStack" ![基于数组实现栈的入栈出栈操作](stack.assets/array_stack.png) @@ -489,5 +490,5 @@ ## 栈典型应用 -- **浏览器中的后退与前进、软件中的撤销与反撤销**。每当我们打开新的网页，浏览器就会将上一个网页执行入栈，这样我们就可以通过「后退」操作回到上一页面。后退操作实际上是在执行出栈。如果要同时支持后退和前进，那么需要两个栈来配合实现。 +- **浏览器中的后退与前进、软件中的撤销与反撤销**。每当我们打开新的网页，浏览器就会将上一个网页执行入栈，这样我们就可以通过后退操作回到上一页面。后退操作实际上是在执行出栈。如果要同时支持后退和前进，那么需要两个栈来配合实现。 - **程序内存管理**。每次调用函数时，系统都会在栈顶添加一个栈帧，用于记录函数的上下文信息。在递归函数中，向下递推阶段会不断执行入栈操作，而向上回溯阶段则会执行出栈操作。 diff --git a/docs/chapter_tree/array_representation_of_tree.md b/docs/chapter_tree/array_representation_of_tree.md index 752392bd8..2f3cefb2b 100644 --- a/docs/chapter_tree/array_representation_of_tree.md +++ b/docs/chapter_tree/array_representation_of_tree.md @@ -2,7 +2,7 @@ 在链表表示下，二叉树的存储单元为节点 `TreeNode` ，节点之间通过指针相连接。在上节中，我们学习了在链表表示下的二叉树的各项基本操作。 -那么，能否用「数组」来表示二叉树呢？答案是肯定的。 +那么，我们能否用数组来表示二叉树呢？答案是肯定的。 ## 表示完美二叉树 diff --git a/docs/chapter_tree/avl_tree.md b/docs/chapter_tree/avl_tree.md index c522487ca..ae411a71a 100644 --- a/docs/chapter_tree/avl_tree.md +++ b/docs/chapter_tree/avl_tree.md @@ -14,7 +14,7 @@ G. M. Adelson-Velsky 和 E. M. Landis 在其 1962 年发表的论文 "An algorit ## AVL 树常见术语 -「AVL 树」既是二叉搜索树也是平衡二叉树，同时满足这两类二叉树的所有性质，因此也被称为「平衡二叉搜索树」。 +AVL 树既是二叉搜索树也是平衡二叉树，同时满足这两类二叉树的所有性质，因此也被称为「平衡二叉搜索树 balanced binary search tree」。 ### 节点高度 @@ -188,7 +188,7 @@ G. M. Adelson-Velsky 和 E. M. Landis 在其 1962 年发表的论文 "An algorit ``` -「节点高度」是指从该节点到最远叶节点的距离，即所经过的“边”的数量。需要特别注意的是，叶节点的高度为 0 ，而空节点的高度为 -1 。我们将创建两个工具函数，分别用于获取和更新节点的高度。 +“节点高度”是指从该节点到最远叶节点的距离，即所经过的“边”的数量。需要特别注意的是，叶节点的高度为 0 ，而空节点的高度为 -1 。我们将创建两个工具函数，分别用于获取和更新节点的高度。 === "Java" @@ -288,7 +288,7 @@ G. M. Adelson-Velsky 和 E. M. Landis 在其 1962 年发表的论文 "An algorit ### 节点平衡因子 -节点的「平衡因子 Balance Factor」定义为节点左子树的高度减去右子树的高度，同时规定空节点的平衡因子为 0 。我们同样将获取节点平衡因子的功能封装成函数，方便后续使用。 +节点的「平衡因子 balance factor」定义为节点左子树的高度减去右子树的高度，同时规定空节点的平衡因子为 0 。我们同样将获取节点平衡因子的功能封装成函数，方便后续使用。 === "Java" @@ -368,13 +368,13 @@ G. M. Adelson-Velsky 和 E. M. Landis 在其 1962 年发表的论文 "An algorit ## AVL 树旋转 -AVL 树的特点在于「旋转 Rotation」操作，它能够在不影响二叉树的中序遍历序列的前提下，使失衡节点重新恢复平衡。换句话说，**旋转操作既能保持树的「二叉搜索树」属性，也能使树重新变为「平衡二叉树」**。 +AVL 树的特点在于“旋转”操作，它能够在不影响二叉树的中序遍历序列的前提下，使失衡节点重新恢复平衡。换句话说，**旋转操作既能保持“二叉搜索树”的性质，也能使树重新变为“平衡二叉树”**。 -我们将平衡因子绝对值 $> 1$ 的节点称为「失衡节点」。根据节点失衡情况的不同，旋转操作分为四种：右旋、左旋、先右旋后左旋、先左旋后右旋。下面我们将详细介绍这些旋转操作。 +我们将平衡因子绝对值 $> 1$ 的节点称为“失衡节点”。根据节点失衡情况的不同，旋转操作分为四种：右旋、左旋、先右旋后左旋、先左旋后右旋。下面我们将详细介绍这些旋转操作。 ### 右旋 -如下图所示，节点下方为平衡因子。从底至顶看，二叉树中首个失衡节点是“节点 3”。我们关注以该失衡节点为根节点的子树，将该节点记为 `node` ，其左子节点记为 `child` ，执行「右旋」操作。完成右旋后，子树已经恢复平衡，并且仍然保持二叉搜索树的特性。 +如下图所示，节点下方为平衡因子。从底至顶看，二叉树中首个失衡节点是“节点 3”。我们关注以该失衡节点为根节点的子树，将该节点记为 `node` ，其左子节点记为 `child` ，执行“右旋”操作。完成右旋后，子树已经恢复平衡，并且仍然保持二叉搜索树的特性。 === "<1>" ![右旋操作步骤](avl_tree.assets/avltree_right_rotate_step1.png) @@ -388,7 +388,7 @@ AVL 树的特点在于「旋转 Rotation」操作，它能够在不影响二叉 === "<4>" ![avltree_right_rotate_step4](avl_tree.assets/avltree_right_rotate_step4.png) -此外，如果节点 `child` 本身有右子节点（记为 `grandChild` ），则需要在「右旋」中添加一步：将 `grandChild` 作为 `node` 的左子节点。 +此外，如果节点 `child` 本身有右子节点（记为 `grandChild` ），则需要在右旋中添加一步：将 `grandChild` 作为 `node` 的左子节点。 ![有 grandChild 的右旋操作](avl_tree.assets/avltree_right_rotate_with_grandchild.png) @@ -468,15 +468,15 @@ AVL 树的特点在于「旋转 Rotation」操作，它能够在不影响二叉 ### 左旋 -相应的，如果考虑上述失衡二叉树的“镜像”，则需要执行「左旋」操作。 +相应的，如果考虑上述失衡二叉树的“镜像”，则需要执行“左旋”操作。 ![左旋操作](avl_tree.assets/avltree_left_rotate.png) -同理，若节点 `child` 本身有左子节点（记为 `grandChild` ），则需要在「左旋」中添加一步：将 `grandChild` 作为 `node` 的右子节点。 +同理，若节点 `child` 本身有左子节点（记为 `grandChild` ），则需要在左旋中添加一步：将 `grandChild` 作为 `node` 的右子节点。 ![有 grandChild 的左旋操作](avl_tree.assets/avltree_left_rotate_with_grandchild.png) -可以观察到，**右旋和左旋操作在逻辑上是镜像对称的，它们分别解决的两种失衡情况也是对称的**。基于对称性，我们可以轻松地从右旋的代码推导出左旋的代码。具体地，只需将「右旋」代码中的把所有的 `left` 替换为 `right` ，将所有的 `right` 替换为 `left` ，即可得到「左旋」代码。 +可以观察到，**右旋和左旋操作在逻辑上是镜像对称的，它们分别解决的两种失衡情况也是对称的**。基于对称性，我们只需将右旋的实现代码中的所有的 `left` 替换为 `right` ，将所有的 `right` 替换为 `left` ，即可得到左旋的实现代码。 === "Java" @@ -552,13 +552,13 @@ AVL 树的特点在于「旋转 Rotation」操作，它能够在不影响二叉 ### 先左旋后右旋 -对于下图中的失衡节点 3，仅使用左旋或右旋都无法使子树恢复平衡。此时需要先左旋后右旋，即先对 `child` 执行「左旋」，再对 `node` 执行「右旋」。 +对于下图中的失衡节点 3，仅使用左旋或右旋都无法使子树恢复平衡。此时需要先左旋后右旋，即先对 `child` 执行“左旋”，再对 `node` 执行“右旋”。 ![先左旋后右旋](avl_tree.assets/avltree_left_right_rotate.png) ### 先右旋后左旋 -同理，对于上述失衡二叉树的镜像情况，需要先右旋后左旋，即先对 `child` 执行「右旋」，然后对 `node` 执行「左旋」。 +同理，对于上述失衡二叉树的镜像情况，需要先右旋后左旋，即先对 `child` 执行“右旋”，然后对 `node` 执行“左旋”。 ![先右旋后左旋](avl_tree.assets/avltree_right_left_rotate.png) @@ -569,6 +569,7 @@ AVL 树的特点在于「旋转 Rotation」操作，它能够在不影响二叉 ![AVL 树的四种旋转情况](avl_tree.assets/avltree_rotation_cases.png) 在代码中，我们通过判断失衡节点的平衡因子以及较高一侧子节点的平衡因子的正负号，来确定失衡节点属于上图中的哪种情况。 +

    表：四种旋转情况的选择条件

    | 失衡节点的平衡因子 | 子节点的平衡因子 | 应采用的旋转方法 | @@ -656,7 +657,7 @@ AVL 树的特点在于「旋转 Rotation」操作，它能够在不影响二叉 ### 插入节点 -「AVL 树」的节点插入操作与「二叉搜索树」在主体上类似。唯一的区别在于，在 AVL 树中插入节点后，从该节点到根节点的路径上可能会出现一系列失衡节点。因此，**我们需要从这个节点开始，自底向上执行旋转操作，使所有失衡节点恢复平衡**。 +AVL 树的节点插入操作与二叉搜索树在主体上类似。唯一的区别在于，在 AVL 树中插入节点后，从该节点到根节点的路径上可能会出现一系列失衡节点。因此，**我们需要从这个节点开始，自底向上执行旋转操作，使所有失衡节点恢复平衡**。 === "Java" diff --git a/docs/chapter_tree/binary_search_tree.md b/docs/chapter_tree/binary_search_tree.md index 38e814fef..6e82fb72b 100755 --- a/docs/chapter_tree/binary_search_tree.md +++ b/docs/chapter_tree/binary_search_tree.md @@ -1,6 +1,6 @@ # 二叉搜索树 -「二叉搜索树 Binary Search Tree」满足以下条件： +「二叉搜索树 binary search tree」满足以下条件： 1. 对于根节点，左子树中所有节点的值 $<$ 根节点的值 $<$ 右子树中所有节点的值。 2. 任意节点的左、右子树也是二叉搜索树，即同样满足条件 `1.` 。 @@ -310,6 +310,7 @@ 给定一组数据，我们考虑使用数组或二叉搜索树存储。 观察可知，二叉搜索树的各项操作的时间复杂度都是对数阶，具有稳定且高效的性能表现。只有在高频添加、低频查找删除的数据适用场景下，数组比二叉搜索树的效率更高。 +

    表：数组与搜索树的效率对比

    | | 无序数组 | 二叉搜索树 | diff --git a/docs/chapter_tree/binary_tree.md b/docs/chapter_tree/binary_tree.md index 2e3307cd8..7b6082e55 100644 --- a/docs/chapter_tree/binary_tree.md +++ b/docs/chapter_tree/binary_tree.md @@ -1,6 +1,6 @@ # 二叉树 -「二叉树 Binary Tree」是一种非线性数据结构，代表着祖先与后代之间的派生关系，体现着“一分为二”的分治逻辑。与链表类似，二叉树的基本单元是节点，每个节点包含：值、左子节点引用、右子节点引用。 +「二叉树 binary tree」是一种非线性数据结构，代表着祖先与后代之间的派生关系，体现着“一分为二”的分治逻辑。与链表类似，二叉树的基本单元是节点，每个节点包含：值、左子节点引用、右子节点引用。 === "Java" @@ -161,9 +161,9 @@ ``` -节点的两个指针分别指向「左子节点」和「右子节点」，同时该节点被称为这两个子节点的「父节点」。当给定一个二叉树的节点时，我们将该节点的左子节点及其以下节点形成的树称为该节点的「左子树」，同理可得「右子树」。 +每个节点都有两个引用（指针），分别指向「左子节点 left-child node」和「右子节点 right-child node」，该节点被称为这两个子节点的「父节点 parent node」。当给定一个二叉树的节点时，我们将该节点的左子节点及其以下节点形成的树称为该节点的「左子树 left subtree」，同理可得「右子树 right subtree」。 -**在二叉树中，除叶节点外，其他所有节点都包含子节点和非空子树**。例如，在以下示例中，若将“节点 2”视为父节点，则其左子节点和右子节点分别是“节点 4”和“节点 5”，左子树是“节点 4 及其以下节点形成的树”，右子树是“节点 5 及其以下节点形成的树”。 +**在二叉树中，除叶节点外，其他所有节点都包含子节点和非空子树**。在以下示例中，若将“节点 2”视为父节点，则其左子节点和右子节点分别是“节点 4”和“节点 5”，左子树是“节点 4 及其以下节点形成的树”，右子树是“节点 5 及其以下节点形成的树”。 ![父节点、子节点、子树](binary_tree.assets/binary_tree_definition.png) @@ -171,20 +171,20 @@ 二叉树涉及的术语较多，建议尽量理解并记住。 -- 「根节点 Root Node」：位于二叉树顶层的节点，没有父节点。 -- 「叶节点 Leaf Node」：没有子节点的节点，其两个指针均指向 $\text{None}$ 。 -- 节点的「层 Level」：从顶至底递增，根节点所在层为 1 。 -- 节点的「度 Degree」：节点的子节点的数量。在二叉树中，度的范围是 0, 1, 2 。 -- 「边 Edge」：连接两个节点的线段，即节点指针。 -- 二叉树的「高度」：从根节点到最远叶节点所经过的边的数量。 -- 节点的「深度 Depth」 ：从根节点到该节点所经过的边的数量。 -- 节点的「高度 Height」：从最远叶节点到该节点所经过的边的数量。 +- 「根节点 root node」：位于二叉树顶层的节点，没有父节点。 +- 「叶节点 leaf node」：没有子节点的节点，其两个指针均指向 $\text{None}$ 。 +- 「边 edge」：连接两个节点的线段，即节点引用（指针）。 +- 节点所在的「层 level」：从顶至底递增，根节点所在层为 1 。 +- 节点的「度 degree」：节点的子节点的数量。在二叉树中，度的取值范围是 0, 1, 2 。 +- 二叉树的「高度 height」：从根节点到最远叶节点所经过的边的数量。 +- 节点的「深度 depth」 ：从根节点到该节点所经过的边的数量。 +- 节点的「高度 height」：从最远叶节点到该节点所经过的边的数量。 ![二叉树的常用术语](binary_tree.assets/binary_tree_terminology.png) !!! tip "高度与深度的定义" - 请注意，我们通常将「高度」和「深度」定义为“走过边的数量”，但有些题目或教材可能会将其定义为“走过节点的数量”。在这种情况下，高度和深度都需要加 1 。 + 请注意，我们通常将“高度”和“深度”定义为“走过边的数量”，但有些题目或教材可能会将其定义为“走过节点的数量”。在这种情况下，高度和深度都需要加 1 。 ## 二叉树基本操作 @@ -512,35 +512,35 @@ ### 完美二叉树 -「完美二叉树 Perfect Binary Tree」除了最底层外，其余所有层的节点都被完全填满。在完美二叉树中，叶节点的度为 $0$ ，其余所有节点的度都为 $2$ ；若树高度为 $h$ ，则节点总数为 $2^{h+1} - 1$ ，呈现标准的指数级关系，反映了自然界中常见的细胞分裂现象。 +「完美二叉树 perfect binary tree」除了最底层外，其余所有层的节点都被完全填满。在完美二叉树中，叶节点的度为 $0$ ，其余所有节点的度都为 $2$ ；若树高度为 $h$ ，则节点总数为 $2^{h+1} - 1$ ，呈现标准的指数级关系，反映了自然界中常见的细胞分裂现象。 !!! tip - 在中文社区中，完美二叉树常被称为「满二叉树」，请注意区分。 + 请注意，在中文社区中，完美二叉树常被称为「满二叉树」。 ![完美二叉树](binary_tree.assets/perfect_binary_tree.png) ### 完全二叉树 -「完全二叉树 Complete Binary Tree」只有最底层的节点未被填满，且最底层节点尽量靠左填充。 +「完全二叉树 complete binary tree」只有最底层的节点未被填满，且最底层节点尽量靠左填充。 ![完全二叉树](binary_tree.assets/complete_binary_tree.png) ### 完满二叉树 -「完满二叉树 Full Binary Tree」除了叶节点之外，其余所有节点都有两个子节点。 +「完满二叉树 full binary tree」除了叶节点之外，其余所有节点都有两个子节点。 ![完满二叉树](binary_tree.assets/full_binary_tree.png) ### 平衡二叉树 -「平衡二叉树 Balanced Binary Tree」中任意节点的左子树和右子树的高度之差的绝对值不超过 1 。 +「平衡二叉树 balanced binary tree」中任意节点的左子树和右子树的高度之差的绝对值不超过 1 。 ![平衡二叉树](binary_tree.assets/balanced_binary_tree.png) ## 二叉树的退化 -当二叉树的每层节点都被填满时，达到「完美二叉树」；而当所有节点都偏向一侧时，二叉树退化为「链表」。 +当二叉树的每层节点都被填满时，达到“完美二叉树”；而当所有节点都偏向一侧时，二叉树退化为“链表”。 - 完美二叉树是理想情况，可以充分发挥二叉树“分治”的优势。 - 链表则是另一个极端，各项操作都变为线性操作，时间复杂度退化至 $O(n)$ 。 @@ -548,6 +548,7 @@ ![二叉树的最佳与最差结构](binary_tree.assets/binary_tree_best_worst_cases.png) 如下表所示，在最佳和最差结构下，二叉树的叶节点数量、节点总数、高度等达到极大或极小值。 +

    表：二叉树的最佳与最差情况

    | | 完美二叉树 | 链表 | diff --git a/docs/chapter_tree/binary_tree_traversal.md b/docs/chapter_tree/binary_tree_traversal.md index dea1a09b3..e10cdd7cf 100755 --- a/docs/chapter_tree/binary_tree_traversal.md +++ b/docs/chapter_tree/binary_tree_traversal.md @@ -6,13 +6,13 @@ ## 层序遍历 -「层序遍历 Level-Order Traversal」从顶部到底部逐层遍历二叉树，并在每一层按照从左到右的顺序访问节点。 +「层序遍历 level-order traversal」从顶部到底部逐层遍历二叉树，并在每一层按照从左到右的顺序访问节点。 -层序遍历本质上属于「广度优先搜索 Breadth-First Traversal」，它体现了一种“一圈一圈向外扩展”的逐层搜索方式。 +层序遍历本质上属于「广度优先遍历 breadth-first traversal」，它体现了一种“一圈一圈向外扩展”的逐层遍历方式。 ![二叉树的层序遍历](binary_tree_traversal.assets/binary_tree_bfs.png) -广度优先遍历通常借助「队列」来实现。队列遵循“先进先出”的规则，而广度优先遍历则遵循“逐层推进”的规则，两者背后的思想是一致的。 +广度优先遍历通常借助“队列”来实现。队列遵循“先进先出”的规则，而广度优先遍历则遵循“逐层推进”的规则，两者背后的思想是一致的。 === "Java" @@ -92,7 +92,7 @@ ## 前序、中序、后序遍历 -相应地，前序、中序和后序遍历都属于「深度优先遍历 Depth-First Traversal」，它体现了一种“先走到尽头，再回溯继续”的遍历方式。 +相应地，前序、中序和后序遍历都属于「深度优先遍历 depth-first traversal」，它体现了一种“先走到尽头，再回溯继续”的遍历方式。 如下图所示，左侧是深度优先遍历的示意图，右上方是对应的递归代码。深度优先遍历就像是绕着整个二叉树的外围“走”一圈，在这个过程中，在每个节点都会遇到三个位置，分别对应前序遍历、中序遍历和后序遍历。