From 00e097f4d6ab34f295bcff2d59681638b1debf8f Mon Sep 17 00:00:00 2001 From: "Documenter.jl" Date: Mon, 25 Nov 2024 21:28:30 +0000 Subject: [PATCH] build based on 347821a --- previews/PR237/404.html | 22 + previews/PR237/api.html | 405 +++++++++++++ previews/PR237/assets/aecehxl.0OJvb21A.png | Bin 0 -> 18310 bytes previews/PR237/assets/ajtctyp.DuBHk1fh.png | Bin 0 -> 62883 bytes previews/PR237/assets/api.md.CJkYwQvX.js | 381 +++++++++++++ previews/PR237/assets/api.md.CJkYwQvX.lean.js | 381 +++++++++++++ previews/PR237/assets/app.BluvM3bW.js | 1 + previews/PR237/assets/arirdaj.DC3TvBOO.png | Bin 0 -> 31376 bytes previews/PR237/assets/bcsrpqr.Cb0_DiYE.png | Bin 0 -> 14120 bytes previews/PR237/assets/brxrvlc.Dab1-ETk.png | Bin 0 -> 76849 bytes .../PR237/assets/call_notes.md.BcP_ugKX.js | 1 + .../assets/call_notes.md.BcP_ugKX.lean.js | 1 + .../chunks/@localSearchIndexroot.DYRrAYA4.js | 1 + .../chunks/VPLocalSearchBox.dF_ipd1x.js | 8 + .../PR237/assets/chunks/framework.Cq8AuEls.js | 18 + .../PR237/assets/chunks/theme.BVJ9-_aP.js | 2 + previews/PR237/assets/cmuiohu.B94PsR1K.png | Bin 0 -> 34578 bytes previews/PR237/assets/dxmotlj.DaovVbE6.png | Bin 0 -> 18370 bytes previews/PR237/assets/ebapxoz.bkAEKDbV.png | Bin 0 -> 207669 bytes previews/PR237/assets/ehnzxhs.mCtKcWOr.png | Bin 0 -> 83901 bytes ...ments_accurate_accumulators.md.BXYktaVF.js | 6 + ..._accurate_accumulators.md.BXYktaVF.lean.js | 6 + .../experiments_predicates.md.B9dtjjXk.js | 98 ++++ ...experiments_predicates.md.B9dtjjXk.lean.js | 98 ++++ .../assets/explanations_crs.md.DiYuqaex.js | 1 + .../explanations_crs.md.DiYuqaex.lean.js | 1 + .../explanations_paradigms.md.DW4pGVk2.js | 1 + ...explanations_paradigms.md.DW4pGVk2.lean.js | 1 + .../explanations_peculiarities.md.DpkElEdT.js | 1 + ...anations_peculiarities.md.DpkElEdT.lean.js | 1 + .../explanations_winding_order.md.DlVqRHt9.js | 1 + ...anations_winding_order.md.DlVqRHt9.lean.js | 1 + previews/PR237/assets/fhlxvsp.BC9L2R1H.png | Bin 0 -> 65244 bytes previews/PR237/assets/fhnaafw.Dz86q2IX.png | Bin 0 -> 14890 bytes previews/PR237/assets/grtdpgq.UKfqMM__.png | Bin 0 -> 60281 bytes previews/PR237/assets/gwxtpci.3UVIT8DR.png | Bin 0 -> 14090 bytes previews/PR237/assets/hjnwfgx.B8m6QFVZ.png | Bin 0 -> 229647 bytes previews/PR237/assets/hkffoiq.DHcwB147.png | Bin 0 -> 11197 bytes previews/PR237/assets/hmidtfb.-VpeHhXX.png | Bin 0 -> 12067 bytes previews/PR237/assets/hmxjqbb.DeeQUply.png | Bin 0 -> 41343 bytes previews/PR237/assets/hrgkwjx.eNayRHGS.png | Bin 0 -> 80428 bytes previews/PR237/assets/icuhega.BD0hVfse.png | Bin 0 -> 10899 bytes previews/PR237/assets/ijvdjav.C3SxJ3x-.png | Bin 0 -> 23728 bytes previews/PR237/assets/index.md.DjUkOUxW.js | 1 + .../PR237/assets/index.md.DjUkOUxW.lean.js | 1 + .../inter-italic-cyrillic-ext.r48I6akx.woff2 | Bin 0 -> 43112 bytes .../inter-italic-cyrillic.By2_1cv3.woff2 | Bin 0 -> 31300 bytes .../inter-italic-greek-ext.1u6EdAuj.woff2 | Bin 0 -> 17404 bytes .../assets/inter-italic-greek.DJ8dCoTZ.woff2 | Bin 0 -> 32564 bytes .../inter-italic-latin-ext.CN1xVJS-.woff2 | Bin 0 -> 120840 bytes .../assets/inter-italic-latin.C2AdPX0b.woff2 | Bin 0 -> 74784 bytes .../inter-italic-vietnamese.BSbpV94h.woff2 | Bin 0 -> 14884 bytes .../inter-roman-cyrillic-ext.BBPuwvHQ.woff2 | Bin 0 -> 40488 bytes .../inter-roman-cyrillic.C5lxZ8CY.woff2 | Bin 0 -> 29164 bytes .../inter-roman-greek-ext.CqjqNYQ-.woff2 | Bin 0 -> 16272 bytes .../assets/inter-roman-greek.BBVDIX6e.woff2 | Bin 0 -> 29920 bytes .../inter-roman-latin-ext.4ZJIpNVo.woff2 | Bin 0 -> 110160 bytes .../assets/inter-roman-latin.Di8DUHzh.woff2 | Bin 0 -> 67792 bytes .../inter-roman-vietnamese.BjW4sHH5.woff2 | Bin 0 -> 14072 bytes .../PR237/assets/introduction.md.CGS9TUwC.js | 1 + .../assets/introduction.md.CGS9TUwC.lean.js | 1 + previews/PR237/assets/jdkujxv.CULn5saZ.png | Bin 0 -> 14528 bytes previews/PR237/assets/kpqpxvx.Cx40vhB3.png | Bin 0 -> 15689 bytes previews/PR237/assets/lodwufu.DiwGEg2f.png | Bin 0 -> 13659 bytes previews/PR237/assets/msahijx.Dig-DWOQ.png | Bin 0 -> 11901 bytes previews/PR237/assets/mysefnd.BX1TCrz5.png | Bin 0 -> 60301 bytes previews/PR237/assets/nicwgxr.DmInwsY_.png | Bin 0 -> 65768 bytes previews/PR237/assets/ownkpce.DTKLkKh_.png | Bin 0 -> 200857 bytes previews/PR237/assets/qhlrwrc.CgiryX2p.png | Bin 0 -> 13822 bytes previews/PR237/assets/qvfopfk.BEFUMtlf.png | Bin 0 -> 12299 bytes previews/PR237/assets/rukbfux.3sfpQl2i.png | Bin 0 -> 65364 bytes .../assets/source_GeometryOps.md.DWxcJS4q.js | 85 +++ .../source_GeometryOps.md.DWxcJS4q.lean.js | 85 +++ ...xt_GeometryOpsFlexiJoinsExt.md.Cb0F4T1E.js | 16 + ...ometryOpsFlexiJoinsExt.md.Cb0F4T1E.lean.js | 16 + ...OSExt_GeometryOpsLibGEOSExt.md.SUH-wZv2.js | 31 + ..._GeometryOpsLibGEOSExt.md.SUH-wZv2.lean.js | 31 + ...eometryOpsLibGEOSExt_buffer.md.BBYR_g1c.js | 31 + ...ryOpsLibGEOSExt_buffer.md.BBYR_g1c.lean.js | 31 + ...tryOpsLibGEOSExt_segmentize.md.BqXn7mYP.js | 21 + ...sLibGEOSExt_segmentize.md.BqXn7mYP.lean.js | 21 + ...LibGEOSExt_simple_overrides.md.B0O49YKH.js | 46 ++ ...OSExt_simple_overrides.md.B0O49YKH.lean.js | 46 ++ ...metryOpsLibGEOSExt_simplify.md.0759lT_4.js | 29 + ...OpsLibGEOSExt_simplify.md.0759lT_4.lean.js | 29 + ...sProjExt_GeometryOpsProjExt.md.T9WAXhCV.js | 8 + ...Ext_GeometryOpsProjExt.md.T9WAXhCV.lean.js | 8 + ...eometryOpsProjExt_reproject.md.CtArVbVw.js | 44 ++ ...ryOpsProjExt_reproject.md.CtArVbVw.lean.js | 44 ++ ...ometryOpsProjExt_segmentize.md.5tB78318.js | 31 + ...yOpsProjExt_segmentize.md.5tB78318.lean.js | 31 + .../source_methods_angles.md.C2l1TSM1.js | 124 ++++ .../source_methods_angles.md.C2l1TSM1.lean.js | 124 ++++ .../assets/source_methods_area.md.Lwj3szS1.js | 87 +++ .../source_methods_area.md.Lwj3szS1.lean.js | 87 +++ .../source_methods_barycentric.md.BBVjpi4w.js | 415 ++++++++++++++ ...ce_methods_barycentric.md.BBVjpi4w.lean.js | 415 ++++++++++++++ .../source_methods_buffer.md.BAri0anf.js | 11 + .../source_methods_buffer.md.BAri0anf.lean.js | 11 + .../source_methods_centroid.md.BZPe_QHV.js | 93 +++ ...ource_methods_centroid.md.BZPe_QHV.lean.js | 93 +++ ...clipping_clipping_processor.md.Cn8s_AHy.js | 508 +++++++++++++++++ ...ing_clipping_processor.md.Cn8s_AHy.lean.js | 508 +++++++++++++++++ ...e_methods_clipping_coverage.md.DV_tWTFE.js | 223 ++++++++ ...hods_clipping_coverage.md.DV_tWTFE.lean.js | 223 ++++++++ ...source_methods_clipping_cut.md.C35jjvPO.js | 87 +++ ...e_methods_clipping_cut.md.C35jjvPO.lean.js | 87 +++ ...methods_clipping_difference.md.DWZJEyKa.js | 166 ++++++ ...ds_clipping_difference.md.DWZJEyKa.lean.js | 166 ++++++ ...thods_clipping_intersection.md.CyyVQZLK.js | 383 +++++++++++++ ..._clipping_intersection.md.CyyVQZLK.lean.js | 383 +++++++++++++ ...methods_clipping_predicates.md.Dyq9YrPd.js | 44 ++ ...ds_clipping_predicates.md.Dyq9YrPd.lean.js | 44 ++ ...urce_methods_clipping_union.md.DfnvhyrM.js | 251 +++++++++ ...methods_clipping_union.md.DfnvhyrM.lean.js | 251 +++++++++ .../source_methods_convex_hull.md.CW7Bt5Ex.js | 57 ++ ...ce_methods_convex_hull.md.CW7Bt5Ex.lean.js | 57 ++ .../source_methods_distance.md.CFtY9lnQ.js | 181 ++++++ ...ource_methods_distance.md.CFtY9lnQ.lean.js | 181 ++++++ .../source_methods_equals.md.VAVTT70r.js | 265 +++++++++ .../source_methods_equals.md.VAVTT70r.lean.js | 265 +++++++++ ...ods_geom_relations_contains.md.BFVDAiB9.js | 33 ++ ...eom_relations_contains.md.BFVDAiB9.lean.js | 33 ++ ...ds_geom_relations_coveredby.md.CqbNTbTy.js | 183 ++++++ ...om_relations_coveredby.md.CqbNTbTy.lean.js | 183 ++++++ ...thods_geom_relations_covers.md.lXjO6TJl.js | 33 ++ ..._geom_relations_covers.md.lXjO6TJl.lean.js | 33 ++ ...hods_geom_relations_crosses.md.D0wTvJKv.js | 120 ++++ ...geom_relations_crosses.md.D0wTvJKv.lean.js | 120 ++++ ...ods_geom_relations_disjoint.md.D-2b0dzW.js | 178 ++++++ ...eom_relations_disjoint.md.D-2b0dzW.lean.js | 178 ++++++ ...ations_geom_geom_processors.md.B0gKT2XJ.js | 437 ++++++++++++++ ...s_geom_geom_processors.md.B0gKT2XJ.lean.js | 437 ++++++++++++++ ...s_geom_relations_intersects.md.ClSocZGa.js | 27 + ...m_relations_intersects.md.ClSocZGa.lean.js | 27 + ...ods_geom_relations_overlaps.md.Cw9LQh0J.js | 212 +++++++ ...eom_relations_overlaps.md.Cw9LQh0J.lean.js | 212 +++++++ ...hods_geom_relations_touches.md.B6goQM2o.js | 174 ++++++ ...geom_relations_touches.md.B6goQM2o.lean.js | 174 ++++++ ...thods_geom_relations_within.md.BPrebRYc.js | 193 +++++++ ..._geom_relations_within.md.BPrebRYc.lean.js | 193 +++++++ .../source_methods_orientation.md.D1GOBoW6.js | 100 ++++ ...ce_methods_orientation.md.D1GOBoW6.lean.js | 100 ++++ .../source_methods_polygonize.md.U6uoZhWE.js | 289 ++++++++++ ...rce_methods_polygonize.md.U6uoZhWE.lean.js | 289 ++++++++++ .../source_not_implemented_yet.md.DVmFgcZJ.js | 1 + ...ce_not_implemented_yet.md.DVmFgcZJ.lean.js | 1 + .../assets/source_primitives.md.D4c57Awv.js | 1 + .../source_primitives.md.D4c57Awv.lean.js | 1 + .../source_src_GeometryOpsCore.md.D72HXpHZ.js | 25 + ...ce_src_GeometryOpsCore.md.D72HXpHZ.lean.js | 25 + .../assets/source_src_apply.md.B_9nF_39.js | 144 +++++ .../source_src_apply.md.B_9nF_39.lean.js | 144 +++++ .../source_src_applyreduce.md.DZQXF3zb.js | 72 +++ ...source_src_applyreduce.md.DZQXF3zb.lean.js | 72 +++ .../source_src_geometry_utils.md.DStHZN_K.js | 2 + ...rce_src_geometry_utils.md.DStHZN_K.lean.js | 2 + .../source_src_keyword_docs.md.Cu2o_Mxm.js | 1 + ...ource_src_keyword_docs.md.Cu2o_Mxm.lean.js | 1 + ...source_src_other_primitives.md.x4-eP4Xq.js | 118 ++++ ...e_src_other_primitives.md.x4-eP4Xq.lean.js | 118 ++++ .../assets/source_src_types.md.DBsi_VC7.js | 111 ++++ .../source_src_types.md.DBsi_VC7.lean.js | 111 ++++ ...ions_correction_closed_ring.md.uikVr-1e.js | 30 + ...correction_closed_ring.md.uikVr-1e.lean.js | 30 + ...rection_geometry_correction.md.C2ysKw1R.js | 31 + ...on_geometry_correction.md.C2ysKw1R.lean.js | 31 + ...ction_intersecting_polygons.md.Cfjz8cbj.js | 97 ++++ ..._intersecting_polygons.md.Cfjz8cbj.lean.js | 97 ++++ ...urce_transformations_extent.md.D6fK7i3a.js | 13 + ...transformations_extent.md.D6fK7i3a.lean.js | 13 + ...source_transformations_flip.md.Drqj7zVo.js | 22 + ...e_transformations_flip.md.Drqj7zVo.lean.js | 22 + ...e_transformations_reproject.md.CmgYJAT2.js | 1 + ...nsformations_reproject.md.CmgYJAT2.lean.js | 1 + ..._transformations_segmentize.md.A3Zwf5SL.js | 161 ++++++ ...sformations_segmentize.md.A3Zwf5SL.lean.js | 161 ++++++ ...ce_transformations_simplify.md.Bjsi40yW.js | 490 ++++++++++++++++ ...ansformations_simplify.md.Bjsi40yW.lean.js | 490 ++++++++++++++++ ...e_transformations_transform.md.fQuX-Pz6.js | 55 ++ ...nsformations_transform.md.fQuX-Pz6.lean.js | 55 ++ ...urce_transformations_tuples.md.k24FH2eZ.js | 19 + ...transformations_tuples.md.k24FH2eZ.lean.js | 19 + .../PR237/assets/source_types.md.CL-ODfd9.js | 38 ++ .../assets/source_types.md.CL-ODfd9.lean.js | 38 ++ .../PR237/assets/source_utils.md.DLZcNIzl.js | 120 ++++ .../assets/source_utils.md.DLZcNIzl.lean.js | 120 ++++ previews/PR237/assets/style.BK3-A7nA.css | 1 + previews/PR237/assets/ttyjkgn.Bglvb-jp.png | Bin 0 -> 44112 bytes ...tutorials_creating_geometry.md.kdUBQRWQ.js | 89 +++ ...ials_creating_geometry.md.kdUBQRWQ.lean.js | 89 +++ .../tutorials_geodesic_paths.md.0IfaH3DB.js | 11 + ...torials_geodesic_paths.md.0IfaH3DB.lean.js | 11 + .../tutorials_spatial_joins.md.Bs6yD1m0.js | 52 ++ ...utorials_spatial_joins.md.Bs6yD1m0.lean.js | 52 ++ previews/PR237/assets/tztfann.pAYw0Yqf.png | Bin 0 -> 162783 bytes previews/PR237/assets/ujdqybe.0f3Lq4Lw.png | Bin 0 -> 201557 bytes previews/PR237/assets/uyetcvi.CPClNl7F.png | Bin 0 -> 191569 bytes previews/PR237/assets/vfshmbk.4wfjCtJV.png | Bin 0 -> 66660 bytes previews/PR237/assets/vhavubn.rOsRk89v.png | Bin 0 -> 63969 bytes previews/PR237/assets/xeijnvc._0R9BbFk.png | Bin 0 -> 30821 bytes previews/PR237/assets/xoyljyv.BxObbkJu.png | Bin 0 -> 76708 bytes previews/PR237/assets/xvmpyqb.D5-bot8v.png | Bin 0 -> 41516 bytes previews/PR237/assets/yinaqkl.D9AE7i2o.png | Bin 0 -> 198219 bytes previews/PR237/call_notes.html | 25 + .../experiments/accurate_accumulators.html | 30 + previews/PR237/experiments/predicates.html | 122 ++++ previews/PR237/explanations/crs.html | 25 + previews/PR237/explanations/paradigms.html | 25 + .../PR237/explanations/peculiarities.html | 25 + .../PR237/explanations/winding_order.html | 25 + previews/PR237/favicon.ico | Bin 0 -> 23866 bytes previews/PR237/hashmap.json | 1 + previews/PR237/index.html | 25 + previews/PR237/introduction.html | 25 + previews/PR237/logo.png | Bin 0 -> 87252 bytes previews/PR237/siteinfo.js | 1 + previews/PR237/source/GeometryOps.html | 109 ++++ .../GeometryOpsFlexiJoinsExt.html | 40 ++ .../GeometryOpsLibGEOSExt.html | 55 ++ .../source/GeometryOpsLibGEOSExt/buffer.html | 55 ++ .../GeometryOpsLibGEOSExt/segmentize.html | 45 ++ .../simple_overrides.html | 70 +++ .../GeometryOpsLibGEOSExt/simplify.html | 53 ++ .../GeometryOpsProjExt.html | 32 ++ .../source/GeometryOpsProjExt/reproject.html | 68 +++ .../source/GeometryOpsProjExt/segmentize.html | 55 ++ previews/PR237/source/methods/angles.html | 148 +++++ previews/PR237/source/methods/area.html | 111 ++++ .../PR237/source/methods/barycentric.html | 439 +++++++++++++++ previews/PR237/source/methods/buffer.html | 35 ++ previews/PR237/source/methods/centroid.html | 117 ++++ .../methods/clipping/clipping_processor.html | 532 ++++++++++++++++++ .../source/methods/clipping/coverage.html | 247 ++++++++ .../PR237/source/methods/clipping/cut.html | 111 ++++ .../source/methods/clipping/difference.html | 190 +++++++ .../source/methods/clipping/intersection.html | 407 ++++++++++++++ .../source/methods/clipping/predicates.html | 68 +++ .../PR237/source/methods/clipping/union.html | 275 +++++++++ .../PR237/source/methods/convex_hull.html | 81 +++ previews/PR237/source/methods/distance.html | 205 +++++++ previews/PR237/source/methods/equals.html | 289 ++++++++++ .../methods/geom_relations/contains.html | 57 ++ .../methods/geom_relations/coveredby.html | 207 +++++++ .../source/methods/geom_relations/covers.html | 57 ++ .../methods/geom_relations/crosses.html | 144 +++++ .../methods/geom_relations/disjoint.html | 202 +++++++ .../geom_relations/geom_geom_processors.html | 461 +++++++++++++++ .../methods/geom_relations/intersects.html | 51 ++ .../methods/geom_relations/overlaps.html | 236 ++++++++ .../methods/geom_relations/touches.html | 198 +++++++ .../source/methods/geom_relations/within.html | 217 +++++++ .../PR237/source/methods/orientation.html | 124 ++++ previews/PR237/source/methods/polygonize.html | 313 +++++++++++ .../PR237/source/not_implemented_yet.html | 25 + previews/PR237/source/primitives.html | 25 + .../PR237/source/src/GeometryOpsCore.html | 49 ++ previews/PR237/source/src/apply.html | 170 ++++++ previews/PR237/source/src/applyreduce.html | 96 ++++ previews/PR237/source/src/geometry_utils.html | 26 + previews/PR237/source/src/keyword_docs.html | 33 ++ .../PR237/source/src/other_primitives.html | 142 +++++ previews/PR237/source/src/types.html | 135 +++++ .../correction/closed_ring.html | 54 ++ .../correction/geometry_correction.html | 55 ++ .../correction/intersecting_polygons.html | 121 ++++ .../PR237/source/transformations/extent.html | 37 ++ .../PR237/source/transformations/flip.html | 46 ++ .../source/transformations/reproject.html | 65 +++ .../source/transformations/segmentize.html | 185 ++++++ .../source/transformations/simplify.html | 514 +++++++++++++++++ .../source/transformations/transform.html | 79 +++ .../PR237/source/transformations/tuples.html | 43 ++ previews/PR237/source/types.html | 62 ++ previews/PR237/source/utils.html | 144 +++++ .../PR237/tutorials/creating_geometry.html | 113 ++++ previews/PR237/tutorials/geodesic_paths.html | 35 ++ previews/PR237/tutorials/spatial_joins.html | 76 +++ previews/PR237/vp-icons.css | 1 + 279 files changed, 24046 insertions(+) create mode 100644 previews/PR237/404.html create mode 100644 previews/PR237/api.html create mode 100644 previews/PR237/assets/aecehxl.0OJvb21A.png create mode 100644 previews/PR237/assets/ajtctyp.DuBHk1fh.png create mode 100644 previews/PR237/assets/api.md.CJkYwQvX.js create mode 100644 previews/PR237/assets/api.md.CJkYwQvX.lean.js create mode 100644 previews/PR237/assets/app.BluvM3bW.js create mode 100644 previews/PR237/assets/arirdaj.DC3TvBOO.png create mode 100644 previews/PR237/assets/bcsrpqr.Cb0_DiYE.png create mode 100644 previews/PR237/assets/brxrvlc.Dab1-ETk.png create mode 100644 previews/PR237/assets/call_notes.md.BcP_ugKX.js create mode 100644 previews/PR237/assets/call_notes.md.BcP_ugKX.lean.js create mode 100644 previews/PR237/assets/chunks/@localSearchIndexroot.DYRrAYA4.js create mode 100644 previews/PR237/assets/chunks/VPLocalSearchBox.dF_ipd1x.js create mode 100644 previews/PR237/assets/chunks/framework.Cq8AuEls.js create mode 100644 previews/PR237/assets/chunks/theme.BVJ9-_aP.js create mode 100644 previews/PR237/assets/cmuiohu.B94PsR1K.png create mode 100644 previews/PR237/assets/dxmotlj.DaovVbE6.png create mode 100644 previews/PR237/assets/ebapxoz.bkAEKDbV.png create mode 100644 previews/PR237/assets/ehnzxhs.mCtKcWOr.png create mode 100644 previews/PR237/assets/experiments_accurate_accumulators.md.BXYktaVF.js create mode 100644 previews/PR237/assets/experiments_accurate_accumulators.md.BXYktaVF.lean.js create mode 100644 previews/PR237/assets/experiments_predicates.md.B9dtjjXk.js create mode 100644 previews/PR237/assets/experiments_predicates.md.B9dtjjXk.lean.js create mode 100644 previews/PR237/assets/explanations_crs.md.DiYuqaex.js create mode 100644 previews/PR237/assets/explanations_crs.md.DiYuqaex.lean.js create mode 100644 previews/PR237/assets/explanations_paradigms.md.DW4pGVk2.js create mode 100644 previews/PR237/assets/explanations_paradigms.md.DW4pGVk2.lean.js create mode 100644 previews/PR237/assets/explanations_peculiarities.md.DpkElEdT.js create mode 100644 previews/PR237/assets/explanations_peculiarities.md.DpkElEdT.lean.js create mode 100644 previews/PR237/assets/explanations_winding_order.md.DlVqRHt9.js create mode 100644 previews/PR237/assets/explanations_winding_order.md.DlVqRHt9.lean.js create mode 100644 previews/PR237/assets/fhlxvsp.BC9L2R1H.png create mode 100644 previews/PR237/assets/fhnaafw.Dz86q2IX.png create mode 100644 previews/PR237/assets/grtdpgq.UKfqMM__.png create mode 100644 previews/PR237/assets/gwxtpci.3UVIT8DR.png create mode 100644 previews/PR237/assets/hjnwfgx.B8m6QFVZ.png create mode 100644 previews/PR237/assets/hkffoiq.DHcwB147.png create mode 100644 previews/PR237/assets/hmidtfb.-VpeHhXX.png create mode 100644 previews/PR237/assets/hmxjqbb.DeeQUply.png create mode 100644 previews/PR237/assets/hrgkwjx.eNayRHGS.png create mode 100644 previews/PR237/assets/icuhega.BD0hVfse.png create mode 100644 previews/PR237/assets/ijvdjav.C3SxJ3x-.png create mode 100644 previews/PR237/assets/index.md.DjUkOUxW.js create mode 100644 previews/PR237/assets/index.md.DjUkOUxW.lean.js create mode 100644 previews/PR237/assets/inter-italic-cyrillic-ext.r48I6akx.woff2 create mode 100644 previews/PR237/assets/inter-italic-cyrillic.By2_1cv3.woff2 create mode 100644 previews/PR237/assets/inter-italic-greek-ext.1u6EdAuj.woff2 create mode 100644 previews/PR237/assets/inter-italic-greek.DJ8dCoTZ.woff2 create mode 100644 previews/PR237/assets/inter-italic-latin-ext.CN1xVJS-.woff2 create mode 100644 previews/PR237/assets/inter-italic-latin.C2AdPX0b.woff2 create mode 100644 previews/PR237/assets/inter-italic-vietnamese.BSbpV94h.woff2 create mode 100644 previews/PR237/assets/inter-roman-cyrillic-ext.BBPuwvHQ.woff2 create mode 100644 previews/PR237/assets/inter-roman-cyrillic.C5lxZ8CY.woff2 create mode 100644 previews/PR237/assets/inter-roman-greek-ext.CqjqNYQ-.woff2 create mode 100644 previews/PR237/assets/inter-roman-greek.BBVDIX6e.woff2 create mode 100644 previews/PR237/assets/inter-roman-latin-ext.4ZJIpNVo.woff2 create mode 100644 previews/PR237/assets/inter-roman-latin.Di8DUHzh.woff2 create mode 100644 previews/PR237/assets/inter-roman-vietnamese.BjW4sHH5.woff2 create mode 100644 previews/PR237/assets/introduction.md.CGS9TUwC.js create mode 100644 previews/PR237/assets/introduction.md.CGS9TUwC.lean.js create mode 100644 previews/PR237/assets/jdkujxv.CULn5saZ.png create mode 100644 previews/PR237/assets/kpqpxvx.Cx40vhB3.png create mode 100644 previews/PR237/assets/lodwufu.DiwGEg2f.png create mode 100644 previews/PR237/assets/msahijx.Dig-DWOQ.png create mode 100644 previews/PR237/assets/mysefnd.BX1TCrz5.png create mode 100644 previews/PR237/assets/nicwgxr.DmInwsY_.png create mode 100644 previews/PR237/assets/ownkpce.DTKLkKh_.png create mode 100644 previews/PR237/assets/qhlrwrc.CgiryX2p.png create mode 100644 previews/PR237/assets/qvfopfk.BEFUMtlf.png create mode 100644 previews/PR237/assets/rukbfux.3sfpQl2i.png create mode 100644 previews/PR237/assets/source_GeometryOps.md.DWxcJS4q.js create mode 100644 previews/PR237/assets/source_GeometryOps.md.DWxcJS4q.lean.js create mode 100644 previews/PR237/assets/source_GeometryOpsFlexiJoinsExt_GeometryOpsFlexiJoinsExt.md.Cb0F4T1E.js create mode 100644 previews/PR237/assets/source_GeometryOpsFlexiJoinsExt_GeometryOpsFlexiJoinsExt.md.Cb0F4T1E.lean.js create mode 100644 previews/PR237/assets/source_GeometryOpsLibGEOSExt_GeometryOpsLibGEOSExt.md.SUH-wZv2.js create mode 100644 previews/PR237/assets/source_GeometryOpsLibGEOSExt_GeometryOpsLibGEOSExt.md.SUH-wZv2.lean.js create mode 100644 previews/PR237/assets/source_GeometryOpsLibGEOSExt_buffer.md.BBYR_g1c.js create mode 100644 previews/PR237/assets/source_GeometryOpsLibGEOSExt_buffer.md.BBYR_g1c.lean.js create mode 100644 previews/PR237/assets/source_GeometryOpsLibGEOSExt_segmentize.md.BqXn7mYP.js create mode 100644 previews/PR237/assets/source_GeometryOpsLibGEOSExt_segmentize.md.BqXn7mYP.lean.js create mode 100644 previews/PR237/assets/source_GeometryOpsLibGEOSExt_simple_overrides.md.B0O49YKH.js create mode 100644 previews/PR237/assets/source_GeometryOpsLibGEOSExt_simple_overrides.md.B0O49YKH.lean.js create mode 100644 previews/PR237/assets/source_GeometryOpsLibGEOSExt_simplify.md.0759lT_4.js create mode 100644 previews/PR237/assets/source_GeometryOpsLibGEOSExt_simplify.md.0759lT_4.lean.js create mode 100644 previews/PR237/assets/source_GeometryOpsProjExt_GeometryOpsProjExt.md.T9WAXhCV.js create mode 100644 previews/PR237/assets/source_GeometryOpsProjExt_GeometryOpsProjExt.md.T9WAXhCV.lean.js create mode 100644 previews/PR237/assets/source_GeometryOpsProjExt_reproject.md.CtArVbVw.js create mode 100644 previews/PR237/assets/source_GeometryOpsProjExt_reproject.md.CtArVbVw.lean.js create mode 100644 previews/PR237/assets/source_GeometryOpsProjExt_segmentize.md.5tB78318.js create mode 100644 previews/PR237/assets/source_GeometryOpsProjExt_segmentize.md.5tB78318.lean.js create mode 100644 previews/PR237/assets/source_methods_angles.md.C2l1TSM1.js create mode 100644 previews/PR237/assets/source_methods_angles.md.C2l1TSM1.lean.js create mode 100644 previews/PR237/assets/source_methods_area.md.Lwj3szS1.js create mode 100644 previews/PR237/assets/source_methods_area.md.Lwj3szS1.lean.js create mode 100644 previews/PR237/assets/source_methods_barycentric.md.BBVjpi4w.js create mode 100644 previews/PR237/assets/source_methods_barycentric.md.BBVjpi4w.lean.js create mode 100644 previews/PR237/assets/source_methods_buffer.md.BAri0anf.js create mode 100644 previews/PR237/assets/source_methods_buffer.md.BAri0anf.lean.js create mode 100644 previews/PR237/assets/source_methods_centroid.md.BZPe_QHV.js create mode 100644 previews/PR237/assets/source_methods_centroid.md.BZPe_QHV.lean.js create mode 100644 previews/PR237/assets/source_methods_clipping_clipping_processor.md.Cn8s_AHy.js create mode 100644 previews/PR237/assets/source_methods_clipping_clipping_processor.md.Cn8s_AHy.lean.js create mode 100644 previews/PR237/assets/source_methods_clipping_coverage.md.DV_tWTFE.js create mode 100644 previews/PR237/assets/source_methods_clipping_coverage.md.DV_tWTFE.lean.js create mode 100644 previews/PR237/assets/source_methods_clipping_cut.md.C35jjvPO.js create mode 100644 previews/PR237/assets/source_methods_clipping_cut.md.C35jjvPO.lean.js create mode 100644 previews/PR237/assets/source_methods_clipping_difference.md.DWZJEyKa.js create mode 100644 previews/PR237/assets/source_methods_clipping_difference.md.DWZJEyKa.lean.js create mode 100644 previews/PR237/assets/source_methods_clipping_intersection.md.CyyVQZLK.js create mode 100644 previews/PR237/assets/source_methods_clipping_intersection.md.CyyVQZLK.lean.js create mode 100644 previews/PR237/assets/source_methods_clipping_predicates.md.Dyq9YrPd.js create mode 100644 previews/PR237/assets/source_methods_clipping_predicates.md.Dyq9YrPd.lean.js create mode 100644 previews/PR237/assets/source_methods_clipping_union.md.DfnvhyrM.js create mode 100644 previews/PR237/assets/source_methods_clipping_union.md.DfnvhyrM.lean.js create mode 100644 previews/PR237/assets/source_methods_convex_hull.md.CW7Bt5Ex.js create mode 100644 previews/PR237/assets/source_methods_convex_hull.md.CW7Bt5Ex.lean.js create mode 100644 previews/PR237/assets/source_methods_distance.md.CFtY9lnQ.js create mode 100644 previews/PR237/assets/source_methods_distance.md.CFtY9lnQ.lean.js create mode 100644 previews/PR237/assets/source_methods_equals.md.VAVTT70r.js create mode 100644 previews/PR237/assets/source_methods_equals.md.VAVTT70r.lean.js create mode 100644 previews/PR237/assets/source_methods_geom_relations_contains.md.BFVDAiB9.js create mode 100644 previews/PR237/assets/source_methods_geom_relations_contains.md.BFVDAiB9.lean.js create mode 100644 previews/PR237/assets/source_methods_geom_relations_coveredby.md.CqbNTbTy.js create mode 100644 previews/PR237/assets/source_methods_geom_relations_coveredby.md.CqbNTbTy.lean.js create mode 100644 previews/PR237/assets/source_methods_geom_relations_covers.md.lXjO6TJl.js create mode 100644 previews/PR237/assets/source_methods_geom_relations_covers.md.lXjO6TJl.lean.js create mode 100644 previews/PR237/assets/source_methods_geom_relations_crosses.md.D0wTvJKv.js create mode 100644 previews/PR237/assets/source_methods_geom_relations_crosses.md.D0wTvJKv.lean.js create mode 100644 previews/PR237/assets/source_methods_geom_relations_disjoint.md.D-2b0dzW.js create mode 100644 previews/PR237/assets/source_methods_geom_relations_disjoint.md.D-2b0dzW.lean.js create mode 100644 previews/PR237/assets/source_methods_geom_relations_geom_geom_processors.md.B0gKT2XJ.js create mode 100644 previews/PR237/assets/source_methods_geom_relations_geom_geom_processors.md.B0gKT2XJ.lean.js create mode 100644 previews/PR237/assets/source_methods_geom_relations_intersects.md.ClSocZGa.js create mode 100644 previews/PR237/assets/source_methods_geom_relations_intersects.md.ClSocZGa.lean.js create mode 100644 previews/PR237/assets/source_methods_geom_relations_overlaps.md.Cw9LQh0J.js create mode 100644 previews/PR237/assets/source_methods_geom_relations_overlaps.md.Cw9LQh0J.lean.js create mode 100644 previews/PR237/assets/source_methods_geom_relations_touches.md.B6goQM2o.js create mode 100644 previews/PR237/assets/source_methods_geom_relations_touches.md.B6goQM2o.lean.js create mode 100644 previews/PR237/assets/source_methods_geom_relations_within.md.BPrebRYc.js create mode 100644 previews/PR237/assets/source_methods_geom_relations_within.md.BPrebRYc.lean.js create mode 100644 previews/PR237/assets/source_methods_orientation.md.D1GOBoW6.js create mode 100644 previews/PR237/assets/source_methods_orientation.md.D1GOBoW6.lean.js create mode 100644 previews/PR237/assets/source_methods_polygonize.md.U6uoZhWE.js create mode 100644 previews/PR237/assets/source_methods_polygonize.md.U6uoZhWE.lean.js create mode 100644 previews/PR237/assets/source_not_implemented_yet.md.DVmFgcZJ.js create mode 100644 previews/PR237/assets/source_not_implemented_yet.md.DVmFgcZJ.lean.js create mode 100644 previews/PR237/assets/source_primitives.md.D4c57Awv.js create mode 100644 previews/PR237/assets/source_primitives.md.D4c57Awv.lean.js create mode 100644 previews/PR237/assets/source_src_GeometryOpsCore.md.D72HXpHZ.js create mode 100644 previews/PR237/assets/source_src_GeometryOpsCore.md.D72HXpHZ.lean.js create mode 100644 previews/PR237/assets/source_src_apply.md.B_9nF_39.js create mode 100644 previews/PR237/assets/source_src_apply.md.B_9nF_39.lean.js create mode 100644 previews/PR237/assets/source_src_applyreduce.md.DZQXF3zb.js create mode 100644 previews/PR237/assets/source_src_applyreduce.md.DZQXF3zb.lean.js create mode 100644 previews/PR237/assets/source_src_geometry_utils.md.DStHZN_K.js create mode 100644 previews/PR237/assets/source_src_geometry_utils.md.DStHZN_K.lean.js create mode 100644 previews/PR237/assets/source_src_keyword_docs.md.Cu2o_Mxm.js create mode 100644 previews/PR237/assets/source_src_keyword_docs.md.Cu2o_Mxm.lean.js create mode 100644 previews/PR237/assets/source_src_other_primitives.md.x4-eP4Xq.js create mode 100644 previews/PR237/assets/source_src_other_primitives.md.x4-eP4Xq.lean.js create mode 100644 previews/PR237/assets/source_src_types.md.DBsi_VC7.js create mode 100644 previews/PR237/assets/source_src_types.md.DBsi_VC7.lean.js create mode 100644 previews/PR237/assets/source_transformations_correction_closed_ring.md.uikVr-1e.js create mode 100644 previews/PR237/assets/source_transformations_correction_closed_ring.md.uikVr-1e.lean.js create mode 100644 previews/PR237/assets/source_transformations_correction_geometry_correction.md.C2ysKw1R.js create mode 100644 previews/PR237/assets/source_transformations_correction_geometry_correction.md.C2ysKw1R.lean.js create mode 100644 previews/PR237/assets/source_transformations_correction_intersecting_polygons.md.Cfjz8cbj.js create mode 100644 previews/PR237/assets/source_transformations_correction_intersecting_polygons.md.Cfjz8cbj.lean.js create mode 100644 previews/PR237/assets/source_transformations_extent.md.D6fK7i3a.js create mode 100644 previews/PR237/assets/source_transformations_extent.md.D6fK7i3a.lean.js create mode 100644 previews/PR237/assets/source_transformations_flip.md.Drqj7zVo.js create mode 100644 previews/PR237/assets/source_transformations_flip.md.Drqj7zVo.lean.js create mode 100644 previews/PR237/assets/source_transformations_reproject.md.CmgYJAT2.js create mode 100644 previews/PR237/assets/source_transformations_reproject.md.CmgYJAT2.lean.js create mode 100644 previews/PR237/assets/source_transformations_segmentize.md.A3Zwf5SL.js create mode 100644 previews/PR237/assets/source_transformations_segmentize.md.A3Zwf5SL.lean.js create mode 100644 previews/PR237/assets/source_transformations_simplify.md.Bjsi40yW.js create mode 100644 previews/PR237/assets/source_transformations_simplify.md.Bjsi40yW.lean.js create mode 100644 previews/PR237/assets/source_transformations_transform.md.fQuX-Pz6.js create mode 100644 previews/PR237/assets/source_transformations_transform.md.fQuX-Pz6.lean.js create mode 100644 previews/PR237/assets/source_transformations_tuples.md.k24FH2eZ.js create mode 100644 previews/PR237/assets/source_transformations_tuples.md.k24FH2eZ.lean.js create mode 100644 previews/PR237/assets/source_types.md.CL-ODfd9.js create mode 100644 previews/PR237/assets/source_types.md.CL-ODfd9.lean.js create mode 100644 previews/PR237/assets/source_utils.md.DLZcNIzl.js create mode 100644 previews/PR237/assets/source_utils.md.DLZcNIzl.lean.js create mode 100644 previews/PR237/assets/style.BK3-A7nA.css create mode 100644 previews/PR237/assets/ttyjkgn.Bglvb-jp.png create mode 100644 previews/PR237/assets/tutorials_creating_geometry.md.kdUBQRWQ.js create mode 100644 previews/PR237/assets/tutorials_creating_geometry.md.kdUBQRWQ.lean.js create mode 100644 previews/PR237/assets/tutorials_geodesic_paths.md.0IfaH3DB.js create mode 100644 previews/PR237/assets/tutorials_geodesic_paths.md.0IfaH3DB.lean.js create mode 100644 previews/PR237/assets/tutorials_spatial_joins.md.Bs6yD1m0.js create mode 100644 previews/PR237/assets/tutorials_spatial_joins.md.Bs6yD1m0.lean.js create mode 100644 previews/PR237/assets/tztfann.pAYw0Yqf.png create mode 100644 previews/PR237/assets/ujdqybe.0f3Lq4Lw.png create mode 100644 previews/PR237/assets/uyetcvi.CPClNl7F.png create mode 100644 previews/PR237/assets/vfshmbk.4wfjCtJV.png create mode 100644 previews/PR237/assets/vhavubn.rOsRk89v.png create mode 100644 previews/PR237/assets/xeijnvc._0R9BbFk.png create mode 100644 previews/PR237/assets/xoyljyv.BxObbkJu.png create mode 100644 previews/PR237/assets/xvmpyqb.D5-bot8v.png create mode 100644 previews/PR237/assets/yinaqkl.D9AE7i2o.png create mode 100644 previews/PR237/call_notes.html create mode 100644 previews/PR237/experiments/accurate_accumulators.html create mode 100644 previews/PR237/experiments/predicates.html create mode 100644 previews/PR237/explanations/crs.html create mode 100644 previews/PR237/explanations/paradigms.html create mode 100644 previews/PR237/explanations/peculiarities.html create mode 100644 previews/PR237/explanations/winding_order.html create mode 100644 previews/PR237/favicon.ico create mode 100644 previews/PR237/hashmap.json create mode 100644 previews/PR237/index.html create mode 100644 previews/PR237/introduction.html create mode 100644 previews/PR237/logo.png create mode 100644 previews/PR237/siteinfo.js create mode 100644 previews/PR237/source/GeometryOps.html create mode 100644 previews/PR237/source/GeometryOpsFlexiJoinsExt/GeometryOpsFlexiJoinsExt.html create mode 100644 previews/PR237/source/GeometryOpsLibGEOSExt/GeometryOpsLibGEOSExt.html create mode 100644 previews/PR237/source/GeometryOpsLibGEOSExt/buffer.html create mode 100644 previews/PR237/source/GeometryOpsLibGEOSExt/segmentize.html create mode 100644 previews/PR237/source/GeometryOpsLibGEOSExt/simple_overrides.html create mode 100644 previews/PR237/source/GeometryOpsLibGEOSExt/simplify.html create mode 100644 previews/PR237/source/GeometryOpsProjExt/GeometryOpsProjExt.html create mode 100644 previews/PR237/source/GeometryOpsProjExt/reproject.html create mode 100644 previews/PR237/source/GeometryOpsProjExt/segmentize.html create mode 100644 previews/PR237/source/methods/angles.html create mode 100644 previews/PR237/source/methods/area.html create mode 100644 previews/PR237/source/methods/barycentric.html create mode 100644 previews/PR237/source/methods/buffer.html create mode 100644 previews/PR237/source/methods/centroid.html create mode 100644 previews/PR237/source/methods/clipping/clipping_processor.html create mode 100644 previews/PR237/source/methods/clipping/coverage.html create mode 100644 previews/PR237/source/methods/clipping/cut.html create mode 100644 previews/PR237/source/methods/clipping/difference.html create mode 100644 previews/PR237/source/methods/clipping/intersection.html create mode 100644 previews/PR237/source/methods/clipping/predicates.html create mode 100644 previews/PR237/source/methods/clipping/union.html create mode 100644 previews/PR237/source/methods/convex_hull.html create mode 100644 previews/PR237/source/methods/distance.html create mode 100644 previews/PR237/source/methods/equals.html create mode 100644 previews/PR237/source/methods/geom_relations/contains.html create mode 100644 previews/PR237/source/methods/geom_relations/coveredby.html create mode 100644 previews/PR237/source/methods/geom_relations/covers.html create mode 100644 previews/PR237/source/methods/geom_relations/crosses.html create mode 100644 previews/PR237/source/methods/geom_relations/disjoint.html create mode 100644 previews/PR237/source/methods/geom_relations/geom_geom_processors.html create mode 100644 previews/PR237/source/methods/geom_relations/intersects.html create mode 100644 previews/PR237/source/methods/geom_relations/overlaps.html create mode 100644 previews/PR237/source/methods/geom_relations/touches.html create mode 100644 previews/PR237/source/methods/geom_relations/within.html create mode 100644 previews/PR237/source/methods/orientation.html create mode 100644 previews/PR237/source/methods/polygonize.html create mode 100644 previews/PR237/source/not_implemented_yet.html create mode 100644 previews/PR237/source/primitives.html create mode 100644 previews/PR237/source/src/GeometryOpsCore.html create mode 100644 previews/PR237/source/src/apply.html create mode 100644 previews/PR237/source/src/applyreduce.html create mode 100644 previews/PR237/source/src/geometry_utils.html create mode 100644 previews/PR237/source/src/keyword_docs.html create mode 100644 previews/PR237/source/src/other_primitives.html create mode 100644 previews/PR237/source/src/types.html create mode 100644 previews/PR237/source/transformations/correction/closed_ring.html create mode 100644 previews/PR237/source/transformations/correction/geometry_correction.html create mode 100644 previews/PR237/source/transformations/correction/intersecting_polygons.html create mode 100644 previews/PR237/source/transformations/extent.html create mode 100644 previews/PR237/source/transformations/flip.html create mode 100644 previews/PR237/source/transformations/reproject.html create mode 100644 previews/PR237/source/transformations/segmentize.html create mode 100644 previews/PR237/source/transformations/simplify.html create mode 100644 previews/PR237/source/transformations/transform.html create mode 100644 previews/PR237/source/transformations/tuples.html create mode 100644 previews/PR237/source/types.html create mode 100644 previews/PR237/source/utils.html create mode 100644 previews/PR237/tutorials/creating_geometry.html create mode 100644 previews/PR237/tutorials/geodesic_paths.html create mode 100644 previews/PR237/tutorials/spatial_joins.html create mode 100644 previews/PR237/vp-icons.css diff --git a/previews/PR237/404.html b/previews/PR237/404.html new file mode 100644 index 000000000..ff57a510f --- /dev/null +++ b/previews/PR237/404.html @@ -0,0 +1,22 @@ + + + + + + 404 | GeometryOps.jl + + + + + + + + + + + +
+ + + + \ No newline at end of file diff --git a/previews/PR237/api.html b/previews/PR237/api.html new file mode 100644 index 000000000..4d9fd1075 --- /dev/null +++ b/previews/PR237/api.html @@ -0,0 +1,405 @@ + + + + + + Full GeometryOps API documentation | GeometryOps.jl + + + + + + + + + + + + + + +
Skip to content

Full GeometryOps API documentation

Warning

This page is still very much WIP!

Documentation for GeometryOps's full API (only for reference!).

apply and associated functions

GeometryOpsCore.apply Function
julia
apply(f, target::Union{TraitTarget, GI.AbstractTrait}, obj; kw...)

Reconstruct a geometry, feature, feature collection, or nested vectors of either using the function f on the target trait.

f(target_geom) => x where x also has the target trait, or a trait that can be substituted. For example, swapping PolgonTrait to MultiPointTrait will fail if the outer object has MultiPolygonTrait, but should work if it has FeatureTrait.

Objects "shallower" than the target trait are always completely rebuilt, like a Vector of FeatureCollectionTrait of FeatureTrait when the target has PolygonTrait and is held in the features. These will always be GeoInterface geometries/feature/feature collections. But "deeper" objects may remain unchanged or be whatever GeoInterface compatible objects f returns.

The result is a functionally similar geometry with values depending on f.

  • threaded: true or false. Whether to use multithreading. Defaults to false.

  • crs: The CRS to attach to geometries. Defaults to nothing.

  • calc_extent: true or false. Whether to calculate the extent. Defaults to false.

Example

Flipped point the order in any feature or geometry, or iterables of either:

julia
import GeoInterface as GI
+import GeometryOps as GO
+geom = GI.Polygon([GI.LinearRing([(1, 2), (3, 4), (5, 6), (1, 2)]),
+                   GI.LinearRing([(3, 4), (5, 6), (6, 7), (3, 4)])])
+
+flipped_geom = GO.apply(GI.PointTrait, geom) do p
+    (GI.y(p), GI.x(p))
+end

source

GeometryOpsCore.applyreduce Function
julia
applyreduce(f, op, target::Union{TraitTarget, GI.AbstractTrait}, obj; threaded)

Apply function f to all objects with the target trait, and reduce the result with an op like +.

The order and grouping of application of op is not guaranteed.

If threaded==true threads will be used over arrays and iterables, feature collections and nested geometries.

source

GeometryOps.reproject Function
julia
reproject(geometry; source_crs, target_crs, transform, always_xy, time)
+reproject(geometry, source_crs, target_crs; always_xy, time)
+reproject(geometry, transform; always_xy, time)

Reproject any GeoInterface.jl compatible geometry from source_crs to target_crs.

The returned object will be constructed from GeoInterface.WrapperGeometry geometries, wrapping views of a Vector{Proj.Point{D}}, where D is the dimension.

Tip

The Proj.jl package must be loaded for this method to work, since it is implemented in a package extension.

Arguments

  • geometry: Any GeoInterface.jl compatible geometries.

  • source_crs: the source coordinate reference system, as a GeoFormatTypes.jl object or a string.

  • target_crs: the target coordinate reference system, as a GeoFormatTypes.jl object or a string.

If these a passed as keywords, transform will take priority. Without it target_crs is always needed, and source_crs is needed if it is not retrievable from the geometry with GeoInterface.crs(geometry).

Keywords

  • always_xy: force x, y coordinate order, true by default. false will expect and return points in the crs coordinate order.

  • time: the time for the coordinates. Inf by default.

  • threaded: true or false. Whether to use multithreading. Defaults to false.

  • crs: The CRS to attach to geometries. Defaults to nothing.

  • calc_extent: true or false. Whether to calculate the extent. Defaults to false.

source

GeometryOps.transform Function
julia
transform(f, obj)

Apply a function f to all the points in obj.

Points will be passed to f as an SVector to allow using CoordinateTransformations.jl and Rotations.jl without hassle.

SVector is also a valid GeoInterface.jl point, so will work in all GeoInterface.jl methods.

Example

julia
julia> import GeoInterface as GI
+
+julia> import GeometryOps as GO
+
+julia> geom = GI.Polygon([GI.LinearRing([(1, 2), (3, 4), (5, 6), (1, 2)]), GI.LinearRing([(3, 4), (5, 6), (6, 7), (3, 4)])]);
+
+julia> f = CoordinateTransformations.Translation(3.5, 1.5)
+Translation(3.5, 1.5)
+
+julia> GO.transform(f, geom)
+GeoInterface.Wrappers.Polygon{false, false, Vector{GeoInterface.Wrappers.LinearRing{false, false, Vector{StaticArraysCore.SVector{2, Float64}}, Nothing, Nothing}}, Nothing, Nothing}(GeoInterface.Wrappers.Linea
+rRing{false, false, Vector{StaticArraysCore.SVector{2, Float64}}, Nothing, Nothing}[GeoInterface.Wrappers.LinearRing{false, false, Vector{StaticArraysCore.SVector{2, Float64}}, Nothing, Nothing}(StaticArraysCo
+re.SVector{2, Float64}[[4.5, 3.5], [6.5, 5.5], [8.5, 7.5], [4.5, 3.5]], nothing, nothing), GeoInterface.Wrappers.LinearRing{false, false, Vector{StaticArraysCore.SVector{2, Float64}}, Nothing, Nothing}(StaticA
+rraysCore.SVector{2, Float64}[[6.5, 5.5], [8.5, 7.5], [9.5, 8.5], [6.5, 5.5]], nothing, nothing)], nothing, nothing)

With Rotations.jl you need to actually multiply the Rotation by the SVector point, which is easy using an anonymous function.

julia
julia> using Rotations
+
+julia> GO.transform(p -> one(RotMatrix{2}) * p, geom)
+GeoInterface.Wrappers.Polygon{false, false, Vector{GeoInterface.Wrappers.LinearRing{false, false, Vector{StaticArraysCore.SVector{2, Int64}}, Nothing, Nothing}}, Nothing, Nothing}(GeoInterface.Wrappers.LinearR
+ing{false, false, Vector{StaticArraysCore.SVector{2, Int64}}, Nothing, Nothing}[GeoInterface.Wrappers.LinearRing{false, false, Vector{StaticArraysCore.SVector{2, Int64}}, Nothing, Nothing}(StaticArraysCore.SVe
+ctor{2, Int64}[[2, 1], [4, 3], [6, 5], [2, 1]], nothing, nothing), GeoInterface.Wrappers.LinearRing{false, false, Vector{StaticArraysCore.SVector{2, Int64}}, Nothing, Nothing}(StaticArraysCore.SVector{2, Int64
+}[[4, 3], [6, 5], [7, 6], [4, 3]], nothing, nothing)], nothing, nothing)

source

General geometry methods

OGC methods

GeometryOps.contains Function
julia
contains(g1::AbstractGeometry, g2::AbstractGeometry)::Bool

Return true if the second geometry is completely contained by the first geometry. The interiors of both geometries must intersect and the interior and boundary of the secondary (g2) must not intersect the exterior of the first (g1).

contains returns the exact opposite result of within.

Examples

julia
import GeometryOps as GO, GeoInterface as GI
+line = GI.LineString([(1, 1), (1, 2), (1, 3), (1, 4)])
+point = GI.Point((1, 2))
+
+GO.contains(line, point)
+# output
+true

source

GeometryOps.coveredby Function
julia
coveredby(g1, g2)::Bool

Return true if the first geometry is completely covered by the second geometry. The interior and boundary of the primary geometry (g1) must not intersect the exterior of the secondary geometry (g2).

Furthermore, coveredby returns the exact opposite result of covers. They are equivalent with the order of the arguments swapped.

Examples

julia
import GeometryOps as GO, GeoInterface as GI
+p1 = GI.Point(0.0, 0.0)
+p2 = GI.Point(1.0, 1.0)
+l1 = GI.Line([p1, p2])
+
+GO.coveredby(p1, l1)
+# output
+true

source

GeometryOps.covers Function
julia
covers(g1::AbstractGeometry, g2::AbstractGeometry)::Bool

Return true if the first geometry is completely covers the second geometry, The exterior and boundary of the second geometry must not be outside of the interior and boundary of the first geometry. However, the interiors need not intersect.

covers returns the exact opposite result of coveredby.

Examples

julia
import GeometryOps as GO, GeoInterface as GI
+l1 = GI.LineString([(1.0, 1.0), (1.0, 2.0), (1.0, 3.0), (1.0, 4.0)])
+l2 = GI.LineString([(1.0, 1.0), (1.0, 2.0)])
+
+GO.covers(l1, l2)
+# output
+true

source

GeometryOps.crosses Function
julia
 crosses(geom1, geom2)::Bool

Return true if the intersection results in a geometry whose dimension is one less than the maximum dimension of the two source geometries and the intersection set is interior to both source geometries.

TODO: broken

Examples

julia
import GeoInterface as GI, GeometryOps as GO
+# TODO: Add working example

source

GeometryOps.disjoint Function
julia
disjoint(geom1, geom2)::Bool

Return true if the first geometry is disjoint from the second geometry.

Return true if the first geometry is disjoint from the second geometry. The interiors and boundaries of both geometries must not intersect.

Examples

julia
import GeometryOps as GO, GeoInterface as GI
+
+line = GI.LineString([(1, 1), (1, 2), (1, 3), (1, 4)])
+point = (2, 2)
+GO.disjoint(point, line)
+
+# output
+true

source

GeometryOps.intersects Function
julia
intersects(geom1, geom2)::Bool

Return true if the interiors or boundaries of the two geometries interact.

intersects returns the exact opposite result of disjoint.

Example

julia
import GeoInterface as GI, GeometryOps as GO
+
+line1 = GI.Line([(124.584961,-12.768946), (126.738281,-17.224758)])
+line2 = GI.Line([(123.354492,-15.961329), (127.22168,-14.008696)])
+GO.intersects(line1, line2)
+
+# output
+true

source

GeometryOps.overlaps Function
julia
overlaps(geom1, geom2)::Bool

Compare two Geometries of the same dimension and return true if their intersection set results in a geometry different from both but of the same dimension. This means one geometry cannot be within or contain the other and they cannot be equal

Examples

julia
import GeometryOps as GO, GeoInterface as GI
+poly1 = GI.Polygon([[(0,0), (0,5), (5,5), (5,0), (0,0)]])
+poly2 = GI.Polygon([[(1,1), (1,6), (6,6), (6,1), (1,1)]])
+
+GO.overlaps(poly1, poly2)
+# output
+true

source

julia
overlaps(::GI.AbstractTrait, geom1, ::GI.AbstractTrait, geom2)::Bool

For any non-specified pair, all have non-matching dimensions, return false.

source

julia
overlaps(
+    ::GI.MultiPointTrait, points1,
+    ::GI.MultiPointTrait, points2,
+)::Bool

If the multipoints overlap, meaning some, but not all, of the points within the multipoints are shared, return true.

source

julia
overlaps(::GI.LineTrait, line1, ::GI.LineTrait, line)::Bool

If the lines overlap, meaning that they are collinear but each have one endpoint outside of the other line, return true. Else false.

source

julia
overlaps(
+    ::Union{GI.LineStringTrait, GI.LinearRing}, line1,
+    ::Union{GI.LineStringTrait, GI.LinearRing}, line2,
+)::Bool

If the curves overlap, meaning that at least one edge of each curve overlaps, return true. Else false.

source

julia
overlaps(
+    trait_a::GI.PolygonTrait, poly_a,
+    trait_b::GI.PolygonTrait, poly_b,
+)::Bool

If the two polygons intersect with one another, but are not equal, return true. Else false.

source

julia
overlaps(
+    ::GI.PolygonTrait, poly1,
+    ::GI.MultiPolygonTrait, polys2,
+)::Bool

Return true if polygon overlaps with at least one of the polygons within the multipolygon. Else false.

source

julia
overlaps(
+    ::GI.MultiPolygonTrait, polys1,
+    ::GI.PolygonTrait, poly2,
+)::Bool

Return true if polygon overlaps with at least one of the polygons within the multipolygon. Else false.

source

julia
overlaps(
+    ::GI.MultiPolygonTrait, polys1,
+    ::GI.MultiPolygonTrait, polys2,
+)::Bool

Return true if at least one pair of polygons from multipolygons overlap. Else false.

source

GeometryOps.touches Function
julia
touches(geom1, geom2)::Bool

Return true if the first geometry touches the second geometry. In other words, the two interiors cannot interact, but one of the geometries must have a boundary point that interacts with either the other geometry's interior or boundary.

Examples

julia
import GeometryOps as GO, GeoInterface as GI
+
+l1 = GI.Line([(0.0, 0.0), (1.0, 0.0)])
+l2 = GI.Line([(1.0, 1.0), (1.0, -1.0)])
+
+GO.touches(l1, l2)
+# output
+true

source

GeometryOps.within Function
julia
within(geom1, geom2)::Bool

Return true if the first geometry is completely within the second geometry. The interiors of both geometries must intersect and the interior and boundary of the primary geometry (geom1) must not intersect the exterior of the secondary geometry (geom2).

Furthermore, within returns the exact opposite result of contains.

Examples

julia
import GeometryOps as GO, GeoInterface as GI
+
+line = GI.LineString([(1, 1), (1, 2), (1, 3), (1, 4)])
+point = (1, 2)
+GO.within(point, line)
+
+# output
+true

source

Other general methods

GeometryOps.equals Function
julia
equals(geom1, geom2)::Bool

Compare two Geometries return true if they are the same geometry.

Examples

julia
import GeometryOps as GO, GeoInterface as GI
+poly1 = GI.Polygon([[(0,0), (0,5), (5,5), (5,0), (0,0)]])
+poly2 = GI.Polygon([[(0,0), (0,5), (5,5), (5,0), (0,0)]])
+
+GO.equals(poly1, poly2)
+# output
+true

source

julia
equals(::T, geom_a, ::T, geom_b)::Bool

Two geometries of the same type, which don't have a equals function to dispatch off of should throw an error.

source

julia
equals(trait_a, geom_a, trait_b, geom_b)

Two geometries which are not of the same type cannot be equal so they always return false.

source

julia
equals(::GI.PointTrait, p1, ::GI.PointTrait, p2)::Bool

Two points are the same if they have the same x and y (and z if 3D) coordinates.

source

julia
equals(::GI.PointTrait, p1, ::GI.MultiPointTrait, mp2)::Bool

A point and a multipoint are equal if the multipoint is composed of a single point that is equivalent to the given point.

source

julia
equals(::GI.MultiPointTrait, mp1, ::GI.PointTrait, p2)::Bool

A point and a multipoint are equal if the multipoint is composed of a single point that is equivalent to the given point.

source

julia
equals(::GI.MultiPointTrait, mp1, ::GI.MultiPointTrait, mp2)::Bool

Two multipoints are equal if they share the same set of points.

source

julia
equals(
+    ::Union{GI.LineTrait, GI.LineStringTrait}, l1,
+    ::Union{GI.LineTrait, GI.LineStringTrait}, l2,
+)::Bool

Two lines/linestrings are equal if they share the same set of points going along the curve. Note that lines/linestrings aren't closed by definition.

source

julia
equals(
+    ::Union{GI.LineTrait, GI.LineStringTrait}, l1,
+    ::GI.LinearRingTrait, l2,
+)::Bool

A line/linestring and a linear ring are equal if they share the same set of points going along the curve. Note that lines aren't closed by definition, but rings are, so the line must have a repeated last point to be equal

source

julia
equals(
+    ::GI.LinearRingTrait, l1,
+    ::Union{GI.LineTrait, GI.LineStringTrait}, l2,
+)::Bool

A linear ring and a line/linestring are equal if they share the same set of points going along the curve. Note that lines aren't closed by definition, but rings are, so the line must have a repeated last point to be equal

source

julia
equals(
+    ::GI.LinearRingTrait, l1,
+    ::GI.LinearRingTrait, l2,
+)::Bool

Two linear rings are equal if they share the same set of points going along the curve. Note that rings are closed by definition, so they can have, but don't need, a repeated last point to be equal.

source

julia
equals(::GI.PolygonTrait, geom_a, ::GI.PolygonTrait, geom_b)::Bool

Two polygons are equal if they share the same exterior edge and holes.

source

julia
equals(::GI.PolygonTrait, geom_a, ::GI.MultiPolygonTrait, geom_b)::Bool

A polygon and a multipolygon are equal if the multipolygon is composed of a single polygon that is equivalent to the given polygon.

source

julia
equals(::GI.MultiPolygonTrait, geom_a, ::GI.PolygonTrait, geom_b)::Bool

A polygon and a multipolygon are equal if the multipolygon is composed of a single polygon that is equivalent to the given polygon.

source

julia
equals(::GI.PolygonTrait, geom_a, ::GI.PolygonTrait, geom_b)::Bool

Two multipolygons are equal if they share the same set of polygons.

source

GeometryOps.centroid Function
julia
centroid(geom, [T=Float64])::Tuple{T, T}

Returns the centroid of a given line segment, linear ring, polygon, or mutlipolygon.

source

GeometryOps.distance Function
julia
distance(point, geom, ::Type{T} = Float64)::T

Calculates the ditance from the geometry g1 to the point. The distance will always be positive or zero.

The method will differ based on the type of the geometry provided: - The distance from a point to a point is just the Euclidean distance between the points. - The distance from a point to a line is the minimum distance from the point to the closest point on the given line. - The distance from a point to a linestring is the minimum distance from the point to the closest segment of the linestring. - The distance from a point to a linear ring is the minimum distance from the point to the closest segment of the linear ring. - The distance from a point to a polygon is zero if the point is within the polygon and otherwise is the minimum distance from the point to an edge of the polygon. This includes edges created by holes. - The distance from a point to a multigeometry or a geometry collection is the minimum distance between the point and any of the sub-geometries.

Result will be of type T, where T is an optional argument with a default value of Float64.

source

GeometryOps.signed_distance Function
julia
signed_distance(point, geom, ::Type{T} = Float64)::T

Calculates the signed distance from the geometry geom to the given point. Points within geom have a negative signed distance, and points outside of geom have a positive signed distance. - The signed distance from a point to a point, line, linestring, or linear ring is equal to the distance between the two. - The signed distance from a point to a polygon is negative if the point is within the polygon and is positive otherwise. The value of the distance is the minimum distance from the point to an edge of the polygon. This includes edges created by holes. - The signed distance from a point to a multigeometry or a geometry collection is the minimum signed distance between the point and any of the sub-geometries.

Result will be of type T, where T is an optional argument with a default value of Float64.

source

GeometryOps.area Function
julia
area(geom, [T = Float64])::T

Returns the area of a geometry or collection of geometries. This is computed slightly differently for different geometries:

- The area of a point/multipoint is always zero.
+- The area of a curve/multicurve is always zero.
+- The area of a polygon is the absolute value of the signed area.
+- The area multi-polygon is the sum of the areas of all of the sub-polygons.
+- The area of a geometry collection, feature collection of array/iterable 
+    is the sum of the areas of all of the sub-geometries.

Result will be of type T, where T is an optional argument with a default value of Float64.

source

GeometryOps.signed_area Function
julia
signed_area(geom, [T = Float64])::T

Returns the signed area of a single geometry, based on winding order. This is computed slightly differently for different geometries:

- The signed area of a point is always zero.
+- The signed area of a curve is always zero.
+- The signed area of a polygon is computed with the shoelace formula and is
+positive if the polygon coordinates wind clockwise and negative if
+counterclockwise.
+- You cannot compute the signed area of a multipolygon as it doesn't have a
+meaning as each sub-polygon could have a different winding order.

Result will be of type T, where T is an optional argument with a default value of Float64.

source

GeometryOps.angles Function
julia
angles(geom, ::Type{T} = Float64)

Returns the angles of a geometry or collection of geometries. This is computed differently for different geometries:

- The angles of a point is an empty vector.
+- The angles of a single line segment is an empty vector.
+- The angles of a linestring or linearring is a vector of angles formed by the curve.
+- The angles of a polygon is a vector of vectors of angles formed by each ring.
+- The angles of a multi-geometry collection is a vector of the angles of each of the
+    sub-geometries as defined above.

Result will be a Vector, or nested set of vectors, of type T where an optional argument with a default value of Float64.

source

GeometryOps.embed_extent Function
julia
embed_extent(obj)

Recursively wrap the object with a GeoInterface.jl geometry, calculating and adding an Extents.Extent to all objects.

This can improve performance when extents need to be checked multiple times, such when needing to check if many points are in geometries, and using their extents as a quick filter for obviously exterior points.

Keywords

  • threaded: true or false. Whether to use multithreading. Defaults to false.

  • crs: The CRS to attach to geometries. Defaults to nothing.

source

Barycentric coordinates

GeometryOps.barycentric_coordinates Function
julia
barycentric_coordinates(method = MeanValue(), polygon, point)

Returns the barycentric coordinates of point in polygon using the barycentric coordinate method method.

source

GeometryOps.barycentric_coordinates! Function
julia
barycentric_coordinates!(λs::Vector{<: Real}, method::AbstractBarycentricCoordinateMethod, polygon, point)

Loads the barycentric coordinates of point in polygon into λs using the barycentric coordinate method method.

λs must be of the length of the polygon plus its holes.

Tip

Use this method to avoid excess allocations when you need to calculate barycentric coordinates for many points.

source

GeometryOps.barycentric_interpolate Function
julia
barycentric_interpolate(method = MeanValue(), polygon, values::AbstractVector{V}, point)

Returns the interpolated value at point within polygon using the barycentric coordinate method method. values are the per-point values for the polygon which are to be interpolated.

Returns an object of type V.

Warning

Barycentric interpolation is currently defined only for 2-dimensional polygons. If you pass a 3-D polygon in, the Z coordinate will be used as per-vertex value to be interpolated (the M coordinate in GIS parlance).

source

Other methods

GeometryOps.AbstractBarycentricCoordinateMethod Type
julia
abstract type AbstractBarycentricCoordinateMethod

Abstract supertype for barycentric coordinate methods. The subtypes may serve as dispatch types, or may cache some information about the target polygon.

API

The following methods must be implemented for all subtypes:

  • barycentric_coordinates!(λs::Vector{<: Real}, method::AbstractBarycentricCoordinateMethod, exterior::Vector{<: Point{2, T1}}, point::Point{2, T2})

  • barycentric_interpolate(method::AbstractBarycentricCoordinateMethod, exterior::Vector{<: Point{2, T1}}, values::Vector{V}, point::Point{2, T2})::V

  • barycentric_interpolate(method::AbstractBarycentricCoordinateMethod, exterior::Vector{<: Point{2, T1}}, interiors::Vector{<: Vector{<: Point{2, T1}}} values::Vector{V}, point::Point{2, T2})::V

The rest of the methods will be implemented in terms of these, and have efficient dispatches for broadcasting.

source

GeometryOps.ClosedRing Type
julia
ClosedRing() <: GeometryCorrection

This correction ensures that a polygon's exterior and interior rings are closed.

It can be called on any geometry correction as usual.

See also GeometryCorrection.

source

GeometryOps.DiffIntersectingPolygons Type
julia
DiffIntersectingPolygons() <: GeometryCorrection

This correction ensures that the polygons included in a multipolygon aren't intersecting. If any polygon's are intersecting, they will be made nonintersecting through the difference operation to create a unique set of disjoint (other than potentially connections by a single point) polygons covering the same area. See also GeometryCorrection, UnionIntersectingPolygons.

source

GeometryOps.DouglasPeucker Type
julia
DouglasPeucker <: SimplifyAlg
+
+DouglasPeucker(; number, ratio, tol)

Simplifies geometries by removing points below tol distance from the line between its neighboring points.

Keywords

  • ratio: the fraction of points that should remain after simplify. Useful as it will generalise for large collections of objects.

  • number: the number of points that should remain after simplify. Less useful for large collections of mixed size objects.

  • tol: the minimum distance a point will be from the line joining its neighboring points.

Note: user input tol is squared to avoid unnecessary computation in algorithm.

source

GeometryOps.GEOS Type
julia
GEOS(; params...)

A struct which instructs the method it's passed to as an algorithm to use the appropriate GEOS function via LibGEOS.jl for the operation.

Dispatch is generally carried out using the names of the keyword arguments. For example, segmentize will only accept a GEOS struct with only a max_distance keyword, and no other.

It's generally a lot slower than the native Julia implementations, since it must convert to the LibGEOS implementation and back - so be warned!

source

GeometryOps.GeodesicSegments Type
julia
GeodesicSegments(; max_distance::Real, equatorial_radius::Real=6378137, flattening::Real=1/298.257223563)

A method for segmentizing geometries by adding extra vertices to the geometry so that no segment is longer than a given distance. This method calculates the distance between points on the geodesic, and assumes input in lat/long coordinates.

Warning

Any input geometries must be in lon/lat coordinates! If not, the method may fail or error.

Arguments

  • max_distance::Real: The maximum distance, in meters, between vertices in the geometry.

  • equatorial_radius::Real=6378137: The equatorial radius of the Earth, in meters. Passed to Proj.geod_geodesic.

  • flattening::Real=1/298.257223563: The flattening of the Earth, which is the ratio of the difference between the equatorial and polar radii to the equatorial radius. Passed to Proj.geod_geodesic.

One can also omit the equatorial_radius and flattening keyword arguments, and pass a geodesic object directly to the eponymous keyword.

This method uses the Proj/GeographicLib API for geodesic calculations.

source

GeometryOps.GeometryCorrection Type
julia
abstract type GeometryCorrection

This abstract type represents a geometry correction.

Interface

Any GeometryCorrection must implement two functions: * application_level(::GeometryCorrection)::AbstractGeometryTrait: This function should return the GeoInterface trait that the correction is intended to be applied to, like PointTrait or LineStringTrait or PolygonTrait. * (::GeometryCorrection)(::AbstractGeometryTrait, geometry)::(some_geometry): This function should apply the correction to the given geometry, and return a new geometry.

source

GeometryOps.LineOrientation Type
julia
Enum LineOrientation

Enum for the orientation of a line with respect to a curve. A line can be line_cross (crossing over the curve), line_hinge (crossing the endpoint of the curve), line_over (collinear with the curve), or line_out (not interacting with the curve).

source

GeometryOps.LinearSegments Type
julia
LinearSegments(; max_distance::Real)

A method for segmentizing geometries by adding extra vertices to the geometry so that no segment is longer than a given distance.

Here, max_distance is a purely nondimensional quantity and will apply in the input space. This is to say, that if the polygon is provided in lat/lon coordinates then the max_distance will be in degrees of arc. If the polygon is provided in meters, then the max_distance will be in meters.

source

GeometryOps.MeanValue Type
julia
MeanValue() <: AbstractBarycentricCoordinateMethod

This method calculates barycentric coordinates using the mean value method.

References

source

GeometryOps.MonotoneChainMethod Type
julia
MonotoneChainMethod()

This is an algorithm for the convex_hull function.

Uses DelaunayTriangulation.jl to compute the convex hull. This is a pure Julia algorithm which provides an optimal Delaunay triangulation.

See also convex_hull

source

GeometryOps.PointOrientation Type
julia
Enum PointOrientation

Enum for the orientation of a point with respect to a curve. A point can be point_in the curve, point_on the curve, or point_out of the curve.

source

GeometryOps.RadialDistance Type
julia
RadialDistance <: SimplifyAlg

Simplifies geometries by removing points less than tol distance from the line between its neighboring points.

Keywords

  • ratio: the fraction of points that should remain after simplify. Useful as it will generalise for large collections of objects.

  • number: the number of points that should remain after simplify. Less useful for large collections of mixed size objects.

  • tol: the minimum distance between points.

Note: user input tol is squared to avoid unnecessary computation in algorithm.

source

GeometryOps.SimplifyAlg Type
julia
abstract type SimplifyAlg

Abstract type for simplification algorithms.

API

For now, the algorithm must hold the number, ratio and tol properties.

Simplification algorithm types can hook into the interface by implementing the _simplify(trait, alg, geom) methods for whichever traits are necessary.

source

GeometryOps.UnionIntersectingPolygons Type
julia
UnionIntersectingPolygons() <: GeometryCorrection

This correction ensures that the polygon's included in a multipolygon aren't intersecting. If any polygon's are intersecting, they will be combined through the union operation to create a unique set of disjoint (other than potentially connections by a single point) polygons covering the same area.

See also GeometryCorrection.

source

GeometryOps.VisvalingamWhyatt Type
julia
VisvalingamWhyatt <: SimplifyAlg
+
+VisvalingamWhyatt(; kw...)

Simplifies geometries by removing points below tol distance from the line between its neighboring points.

Keywords

  • ratio: the fraction of points that should remain after simplify. Useful as it will generalise for large collections of objects.

  • number: the number of points that should remain after simplify. Less useful for large collections of mixed size objects.

  • tol: the minimum area of a triangle made with a point and its neighboring points.

Note: user input tol is doubled to avoid unnecessary computation in algorithm.

source

GeometryOps._det Method
julia
_det(s1::Point2{T1}, s2::Point2{T2}) where {T1 <: Real, T2 <: Real}

Returns the determinant of the matrix formed by hcat'ing two points s1 and s2.

Specifically, this is:

julia
s1[1] * s2[2] - s1[2] * s2[1]

source

GeometryOps._equals_curves Method
julia
_equals_curves(c1, c2, closed_type1, closed_type2)::Bool

Two curves are equal if they share the same set of point, representing the same geometry. Both curves must must be composed of the same set of points, however, they do not have to wind in the same direction, or start on the same point to be equivalent. Inputs: c1 first geometry c2 second geometry closed_type1::Bool true if c1 is closed by definition (polygon, linear ring) closed_type2::Bool true if c2 is closed by definition (polygon, linear ring)

source

GeometryOps.angles Method
julia
angles(geom, ::Type{T} = Float64)

Returns the angles of a geometry or collection of geometries. This is computed differently for different geometries:

- The angles of a point is an empty vector.
+- The angles of a single line segment is an empty vector.
+- The angles of a linestring or linearring is a vector of angles formed by the curve.
+- The angles of a polygon is a vector of vectors of angles formed by each ring.
+- The angles of a multi-geometry collection is a vector of the angles of each of the
+    sub-geometries as defined above.

Result will be a Vector, or nested set of vectors, of type T where an optional argument with a default value of Float64.

source

GeometryOps.area Method
julia
area(geom, [T = Float64])::T

Returns the area of a geometry or collection of geometries. This is computed slightly differently for different geometries:

- The area of a point/multipoint is always zero.
+- The area of a curve/multicurve is always zero.
+- The area of a polygon is the absolute value of the signed area.
+- The area multi-polygon is the sum of the areas of all of the sub-polygons.
+- The area of a geometry collection, feature collection of array/iterable 
+    is the sum of the areas of all of the sub-geometries.

Result will be of type T, where T is an optional argument with a default value of Float64.

source

GeometryOps.barycentric_coordinates! Method
julia
barycentric_coordinates!(λs::Vector{<: Real}, method::AbstractBarycentricCoordinateMethod, polygon, point)

Loads the barycentric coordinates of point in polygon into λs using the barycentric coordinate method method.

λs must be of the length of the polygon plus its holes.

Tip

Use this method to avoid excess allocations when you need to calculate barycentric coordinates for many points.

source

GeometryOps.barycentric_coordinates Method
julia
barycentric_coordinates(method = MeanValue(), polygon, point)

Returns the barycentric coordinates of point in polygon using the barycentric coordinate method method.

source

GeometryOps.barycentric_interpolate Method
julia
barycentric_interpolate(method = MeanValue(), polygon, values::AbstractVector{V}, point)

Returns the interpolated value at point within polygon using the barycentric coordinate method method. values are the per-point values for the polygon which are to be interpolated.

Returns an object of type V.

Warning

Barycentric interpolation is currently defined only for 2-dimensional polygons. If you pass a 3-D polygon in, the Z coordinate will be used as per-vertex value to be interpolated (the M coordinate in GIS parlance).

source

GeometryOps.centroid Method
julia
centroid(geom, [T=Float64])::Tuple{T, T}

Returns the centroid of a given line segment, linear ring, polygon, or mutlipolygon.

source

GeometryOps.centroid_and_area Method
julia
centroid_and_area(geom, [T=Float64])::(::Tuple{T, T}, ::Real)

Returns the centroid and area of a given geometry.

source

GeometryOps.centroid_and_length Method
julia
centroid_and_length(geom, [T=Float64])::(::Tuple{T, T}, ::Real)

Returns the centroid and length of a given line/ring. Note this is only valid for line strings and linear rings.

source

GeometryOps.contains Method
julia
contains(g1::AbstractGeometry, g2::AbstractGeometry)::Bool

Return true if the second geometry is completely contained by the first geometry. The interiors of both geometries must intersect and the interior and boundary of the secondary (g2) must not intersect the exterior of the first (g1).

contains returns the exact opposite result of within.

Examples

julia
import GeometryOps as GO, GeoInterface as GI
+line = GI.LineString([(1, 1), (1, 2), (1, 3), (1, 4)])
+point = GI.Point((1, 2))
+
+GO.contains(line, point)
+# output
+true

source

GeometryOps.convex_hull Function
julia
convex_hull([method], geometries)

Compute the convex hull of the points in geometries. Returns a GI.Polygon representing the convex hull.

Note that the polygon returned is wound counterclockwise as in the Simple Features standard by default. If you choose GEOS, the winding order will be inverted.

Warning

This interface only computes the 2-dimensional convex hull!

For higher dimensional hulls, use the relevant package (Qhull.jl, Quickhull.jl, or similar).

source

GeometryOps.coverage Method
julia
coverage(geom, xmin, xmax, ymin, ymax, [T = Float64])::T

Returns the area of intersection between given geometry and grid cell defined by its minimum and maximum x and y-values. This is computed differently for different geometries:

  • The signed area of a point is always zero.

  • The signed area of a curve is always zero.

  • The signed area of a polygon is calculated by tracing along its edges and switching to the cell edges if needed.

  • The coverage of a geometry collection, multi-geometry, feature collection of array/iterable is the sum of the coverages of all of the sub-geometries.

Result will be of type T, where T is an optional argument with a default value of Float64.

source

GeometryOps.coveredby Method
julia
coveredby(g1, g2)::Bool

Return true if the first geometry is completely covered by the second geometry. The interior and boundary of the primary geometry (g1) must not intersect the exterior of the secondary geometry (g2).

Furthermore, coveredby returns the exact opposite result of covers. They are equivalent with the order of the arguments swapped.

Examples

julia
import GeometryOps as GO, GeoInterface as GI
+p1 = GI.Point(0.0, 0.0)
+p2 = GI.Point(1.0, 1.0)
+l1 = GI.Line([p1, p2])
+
+GO.coveredby(p1, l1)
+# output
+true

source

GeometryOps.covers Method
julia
covers(g1::AbstractGeometry, g2::AbstractGeometry)::Bool

Return true if the first geometry is completely covers the second geometry, The exterior and boundary of the second geometry must not be outside of the interior and boundary of the first geometry. However, the interiors need not intersect.

covers returns the exact opposite result of coveredby.

Examples

julia
import GeometryOps as GO, GeoInterface as GI
+l1 = GI.LineString([(1.0, 1.0), (1.0, 2.0), (1.0, 3.0), (1.0, 4.0)])
+l2 = GI.LineString([(1.0, 1.0), (1.0, 2.0)])
+
+GO.covers(l1, l2)
+# output
+true

source

GeometryOps.crosses Method
julia
 crosses(geom1, geom2)::Bool

Return true if the intersection results in a geometry whose dimension is one less than the maximum dimension of the two source geometries and the intersection set is interior to both source geometries.

TODO: broken

Examples

julia
import GeoInterface as GI, GeometryOps as GO
+# TODO: Add working example

source

GeometryOps.cut Method
julia
cut(geom, line, [T::Type])

Return given geom cut by given line as a list of geometries of the same type as the input geom. Return the original geometry as only list element if none are found. Line must cut fully through given geometry or the original geometry will be returned.

Note: This currently doesn't work for degenerate cases there line crosses through vertices.

Example

julia
import GeoInterface as GI, GeometryOps as GO
+
+poly = GI.Polygon([[(0.0, 0.0), (10.0, 0.0), (10.0, 10.0), (0.0, 10.0), (0.0, 0.0)]])
+line = GI.Line([(5.0, -5.0), (5.0, 15.0)])
+cut_polys = GO.cut(poly, line)
+GI.coordinates.(cut_polys)
+
+# output
+2-element Vector{Vector{Vector{Vector{Float64}}}}:
+ [[[0.0, 0.0], [5.0, 0.0], [5.0, 10.0], [0.0, 10.0], [0.0, 0.0]]]
+ [[[5.0, 0.0], [10.0, 0.0], [10.0, 10.0], [5.0, 10.0], [5.0, 0.0]]]

source

GeometryOps.difference Method
julia
difference(geom_a, geom_b, [T::Type]; target::Type, fix_multipoly = UnionIntersectingPolygons())

Return the difference between two geometries as a list of geometries. Return an empty list if none are found. The type of the list will be constrained as much as possible given the input geometries. Furthermore, the user can provide a taget type as a keyword argument and a list of target geometries found in the difference will be returned. The user can also provide a float type that they would like the points of returned geometries to be. If the user is taking a intersection involving one or more multipolygons, and the multipolygon might be comprised of polygons that intersect, if fix_multipoly is set to an IntersectingPolygons correction (the default is UnionIntersectingPolygons()), then the needed multipolygons will be fixed to be valid before performing the intersection to ensure a correct answer. Only set fix_multipoly to false if you know that the multipolygons are valid, as it will avoid unneeded computation.

Example

julia
import GeoInterface as GI, GeometryOps as GO
+
+poly1 = GI.Polygon([[[0.0, 0.0], [5.0, 5.0], [10.0, 0.0], [5.0, -5.0], [0.0, 0.0]]])
+poly2 = GI.Polygon([[[3.0, 0.0], [8.0, 5.0], [13.0, 0.0], [8.0, -5.0], [3.0, 0.0]]])
+diff_poly = GO.difference(poly1, poly2; target = GI.PolygonTrait())
+GI.coordinates.(diff_poly)
+
+# output
+1-element Vector{Vector{Vector{Vector{Float64}}}}:
+ [[[6.5, 3.5], [5.0, 5.0], [0.0, 0.0], [5.0, -5.0], [6.5, -3.5], [3.0, 0.0], [6.5, 3.5]]]

source

GeometryOps.disjoint Method
julia
disjoint(geom1, geom2)::Bool

Return true if the first geometry is disjoint from the second geometry.

Return true if the first geometry is disjoint from the second geometry. The interiors and boundaries of both geometries must not intersect.

Examples

julia
import GeometryOps as GO, GeoInterface as GI
+
+line = GI.LineString([(1, 1), (1, 2), (1, 3), (1, 4)])
+point = (2, 2)
+GO.disjoint(point, line)
+
+# output
+true

source

GeometryOps.distance Method
julia
distance(point, geom, ::Type{T} = Float64)::T

Calculates the ditance from the geometry g1 to the point. The distance will always be positive or zero.

The method will differ based on the type of the geometry provided: - The distance from a point to a point is just the Euclidean distance between the points. - The distance from a point to a line is the minimum distance from the point to the closest point on the given line. - The distance from a point to a linestring is the minimum distance from the point to the closest segment of the linestring. - The distance from a point to a linear ring is the minimum distance from the point to the closest segment of the linear ring. - The distance from a point to a polygon is zero if the point is within the polygon and otherwise is the minimum distance from the point to an edge of the polygon. This includes edges created by holes. - The distance from a point to a multigeometry or a geometry collection is the minimum distance between the point and any of the sub-geometries.

Result will be of type T, where T is an optional argument with a default value of Float64.

source

GeometryOps.embed_extent Method
julia
embed_extent(obj)

Recursively wrap the object with a GeoInterface.jl geometry, calculating and adding an Extents.Extent to all objects.

This can improve performance when extents need to be checked multiple times, such when needing to check if many points are in geometries, and using their extents as a quick filter for obviously exterior points.

Keywords

  • threaded: true or false. Whether to use multithreading. Defaults to false.

  • crs: The CRS to attach to geometries. Defaults to nothing.

source

GeometryOps.enforce Method
julia
enforce(alg::GO.GEOS, kw::Symbol, f)

Enforce the presence of a keyword argument in a GEOS algorithm, and return alg.params[kw].

Throws an error if the key is not present, and mentions f in the error message (since there isn't a good way to get the name of the function that called this method).

source

GeometryOps.equals Method
julia
equals(trait_a, geom_a, trait_b, geom_b)

Two geometries which are not of the same type cannot be equal so they always return false.

source

GeometryOps.equals Method
julia
equals(geom1, geom2)::Bool

Compare two Geometries return true if they are the same geometry.

Examples

julia
import GeometryOps as GO, GeoInterface as GI
+poly1 = GI.Polygon([[(0,0), (0,5), (5,5), (5,0), (0,0)]])
+poly2 = GI.Polygon([[(0,0), (0,5), (5,5), (5,0), (0,0)]])
+
+GO.equals(poly1, poly2)
+# output
+true

source

GeometryOps.equals Method
julia
equals(
+    ::GI.LinearRingTrait, l1,
+    ::GI.LinearRingTrait, l2,
+)::Bool

Two linear rings are equal if they share the same set of points going along the curve. Note that rings are closed by definition, so they can have, but don't need, a repeated last point to be equal.

source

GeometryOps.equals Method
julia
equals(
+    ::GI.LinearRingTrait, l1,
+    ::Union{GI.LineTrait, GI.LineStringTrait}, l2,
+)::Bool

A linear ring and a line/linestring are equal if they share the same set of points going along the curve. Note that lines aren't closed by definition, but rings are, so the line must have a repeated last point to be equal

source

GeometryOps.equals Method
julia
equals(::GI.MultiPointTrait, mp1, ::GI.MultiPointTrait, mp2)::Bool

Two multipoints are equal if they share the same set of points.

source

GeometryOps.equals Method
julia
equals(::GI.MultiPointTrait, mp1, ::GI.PointTrait, p2)::Bool

A point and a multipoint are equal if the multipoint is composed of a single point that is equivalent to the given point.

source

GeometryOps.equals Method
julia
equals(::GI.PolygonTrait, geom_a, ::GI.PolygonTrait, geom_b)::Bool

Two multipolygons are equal if they share the same set of polygons.

source

GeometryOps.equals Method
julia
equals(::GI.MultiPolygonTrait, geom_a, ::GI.PolygonTrait, geom_b)::Bool

A polygon and a multipolygon are equal if the multipolygon is composed of a single polygon that is equivalent to the given polygon.

source

GeometryOps.equals Method
julia
equals(::GI.PointTrait, p1, ::GI.MultiPointTrait, mp2)::Bool

A point and a multipoint are equal if the multipoint is composed of a single point that is equivalent to the given point.

source

GeometryOps.equals Method
julia
equals(::GI.PointTrait, p1, ::GI.PointTrait, p2)::Bool

Two points are the same if they have the same x and y (and z if 3D) coordinates.

source

GeometryOps.equals Method
julia
equals(::GI.PolygonTrait, geom_a, ::GI.MultiPolygonTrait, geom_b)::Bool

A polygon and a multipolygon are equal if the multipolygon is composed of a single polygon that is equivalent to the given polygon.

source

GeometryOps.equals Method
julia
equals(::GI.PolygonTrait, geom_a, ::GI.PolygonTrait, geom_b)::Bool

Two polygons are equal if they share the same exterior edge and holes.

source

GeometryOps.equals Method
julia
equals(
+    ::Union{GI.LineTrait, GI.LineStringTrait}, l1,
+    ::GI.LinearRingTrait, l2,
+)::Bool

A line/linestring and a linear ring are equal if they share the same set of points going along the curve. Note that lines aren't closed by definition, but rings are, so the line must have a repeated last point to be equal

source

GeometryOps.equals Method
julia
equals(
+    ::Union{GI.LineTrait, GI.LineStringTrait}, l1,
+    ::Union{GI.LineTrait, GI.LineStringTrait}, l2,
+)::Bool

Two lines/linestrings are equal if they share the same set of points going along the curve. Note that lines/linestrings aren't closed by definition.

source

GeometryOps.equals Method
julia
equals(::T, geom_a, ::T, geom_b)::Bool

Two geometries of the same type, which don't have a equals function to dispatch off of should throw an error.

source

GeometryOps.flip Method
julia
flip(obj)

Swap all of the x and y coordinates in obj, otherwise keeping the original structure (but not necessarily the original type).

Keywords

  • threaded: true or false. Whether to use multithreading. Defaults to false.

  • crs: The CRS to attach to geometries. Defaults to nothing.

  • calc_extent: true or false. Whether to calculate the extent. Defaults to false.

source

GeometryOps.intersection Method
julia
intersection(geom_a, geom_b, [T::Type]; target::Type, fix_multipoly = UnionIntersectingPolygons())

Return the intersection between two geometries as a list of geometries. Return an empty list if none are found. The type of the list will be constrained as much as possible given the input geometries. Furthermore, the user can provide a target type as a keyword argument and a list of target geometries found in the intersection will be returned. The user can also provide a float type that they would like the points of returned geometries to be. If the user is taking a intersection involving one or more multipolygons, and the multipolygon might be comprised of polygons that intersect, if fix_multipoly is set to an IntersectingPolygons correction (the default is UnionIntersectingPolygons()), then the needed multipolygons will be fixed to be valid before performing the intersection to ensure a correct answer. Only set fix_multipoly to nothing if you know that the multipolygons are valid, as it will avoid unneeded computation.

Example

julia
import GeoInterface as GI, GeometryOps as GO
+
+line1 = GI.Line([(124.584961,-12.768946), (126.738281,-17.224758)])
+line2 = GI.Line([(123.354492,-15.961329), (127.22168,-14.008696)])
+inter_points = GO.intersection(line1, line2; target = GI.PointTrait())
+GI.coordinates.(inter_points)
+
+# output
+1-element Vector{Vector{Float64}}:
+ [125.58375366067548, -14.83572303404496]

source

GeometryOps.intersection_points Method
julia
intersection_points(geom_a, geom_b, [T::Type])

Return a list of intersection tuple points between two geometries. If no intersection points exist, returns an empty list.

Example

jldoctest

+line1 = GI.Line([(124.584961,-12.768946), (126.738281,-17.224758)]) line2 = GI.Line([(123.354492,-15.961329), (127.22168,-14.008696)]) inter_points = GO.intersection_points(line1, line2)
+
+**output**
+
+1-element Vector{Tuple{Float64, Float64}}:  (125.58375366067548, -14.83572303404496)
+
+
+[source](https://github.com/JuliaGeo/GeometryOps.jl/blob/347821afdac1a9ec607aa2939464014c8ef54b3d/src/methods/clipping/intersection.jl#L177-L195)
+
+</details>
+
+<details class='jldocstring custom-block' open>
+<summary><a id='GeometryOps.intersects-Tuple{Any, Any}' href='#GeometryOps.intersects-Tuple{Any, Any}'><span class="jlbinding">GeometryOps.intersects</span></a> <Badge type="info" class="jlObjectType jlMethod" text="Method" /></summary>
+
+
+
+```julia
+intersects(geom1, geom2)::Bool

Return true if the interiors or boundaries of the two geometries interact.

intersects returns the exact opposite result of disjoint.

Example

julia
import GeoInterface as GI, GeometryOps as GO
+
+line1 = GI.Line([(124.584961,-12.768946), (126.738281,-17.224758)])
+line2 = GI.Line([(123.354492,-15.961329), (127.22168,-14.008696)])
+GO.intersects(line1, line2)
+
+# output
+true

source

GeometryOps.isclockwise Method
julia
isclockwise(line::Union{LineString, Vector{Position}})::Bool

Take a ring and return true if the line goes clockwise, or false if the line goes counter-clockwise. "Going clockwise" means, mathematically,

(i=2n(xixi1)(yi+yi1))>0

Example

julia
julia> import GeoInterface as GI, GeometryOps as GO
+julia> ring = GI.LinearRing([(0, 0), (1, 1), (1, 0), (0, 0)]);
+julia> GO.isclockwise(ring)
+# output
+true

source

GeometryOps.isconcave Method
julia
isconcave(poly::Polygon)::Bool

Take a polygon and return true or false as to whether it is concave or not.

Examples

julia
import GeoInterface as GI, GeometryOps as GO
+
+poly = GI.Polygon([[(0, 0), (0, 1), (1, 1), (1, 0), (0, 0)]])
+GO.isconcave(poly)
+
+# output
+false

source

GeometryOps.overlaps Method
julia
overlaps(geom1, geom2)::Bool

Compare two Geometries of the same dimension and return true if their intersection set results in a geometry different from both but of the same dimension. This means one geometry cannot be within or contain the other and they cannot be equal

Examples

julia
import GeometryOps as GO, GeoInterface as GI
+poly1 = GI.Polygon([[(0,0), (0,5), (5,5), (5,0), (0,0)]])
+poly2 = GI.Polygon([[(1,1), (1,6), (6,6), (6,1), (1,1)]])
+
+GO.overlaps(poly1, poly2)
+# output
+true

source

GeometryOps.overlaps Method
julia
overlaps(::GI.AbstractTrait, geom1, ::GI.AbstractTrait, geom2)::Bool

For any non-specified pair, all have non-matching dimensions, return false.

source

GeometryOps.overlaps Method
julia
overlaps(::GI.LineTrait, line1, ::GI.LineTrait, line)::Bool

If the lines overlap, meaning that they are collinear but each have one endpoint outside of the other line, return true. Else false.

source

GeometryOps.overlaps Method
julia
overlaps(
+    ::GI.MultiPointTrait, points1,
+    ::GI.MultiPointTrait, points2,
+)::Bool

If the multipoints overlap, meaning some, but not all, of the points within the multipoints are shared, return true.

source

GeometryOps.overlaps Method
julia
overlaps(
+    ::GI.MultiPolygonTrait, polys1,
+    ::GI.MultiPolygonTrait, polys2,
+)::Bool

Return true if at least one pair of polygons from multipolygons overlap. Else false.

source

GeometryOps.overlaps Method
julia
overlaps(
+    ::GI.MultiPolygonTrait, polys1,
+    ::GI.PolygonTrait, poly2,
+)::Bool

Return true if polygon overlaps with at least one of the polygons within the multipolygon. Else false.

source

GeometryOps.overlaps Method
julia
overlaps(
+    ::GI.PolygonTrait, poly1,
+    ::GI.MultiPolygonTrait, polys2,
+)::Bool

Return true if polygon overlaps with at least one of the polygons within the multipolygon. Else false.

source

GeometryOps.overlaps Method
julia
overlaps(
+    trait_a::GI.PolygonTrait, poly_a,
+    trait_b::GI.PolygonTrait, poly_b,
+)::Bool

If the two polygons intersect with one another, but are not equal, return true. Else false.

source

GeometryOps.overlaps Method
julia
overlaps(
+    ::Union{GI.LineStringTrait, GI.LinearRing}, line1,
+    ::Union{GI.LineStringTrait, GI.LinearRing}, line2,
+)::Bool

If the curves overlap, meaning that at least one edge of each curve overlaps, return true. Else false.

source

GeometryOps.polygon_to_line Method
julia
polygon_to_line(poly::Polygon)

Converts a Polygon to LineString or MultiLineString

Examples

julia
import GeometryOps as GO, GeoInterface as GI
+
+poly = GI.Polygon([[(-2.275543, 53.464547), (-2.275543, 53.489271), (-2.215118, 53.489271), (-2.215118, 53.464547), (-2.275543, 53.464547)]])
+GO.polygon_to_line(poly)
+# output
+GeoInterface.Wrappers.LineString{false, false, Vector{Tuple{Float64, Float64}}, Nothing, Nothing}([(-2.275543, 53.464547), (-2.275543, 53.489271), (-2.215118, 53.489271), (-2.215118, 53.464547), (-2.275543, 53.464547)], nothing, nothing)

source

GeometryOps.polygonize Method
julia
polygonize(A::AbstractMatrix{Bool}; kw...)
+polygonize(f, A::AbstractMatrix; kw...)
+polygonize(xs, ys, A::AbstractMatrix{Bool}; kw...)
+polygonize(f, xs, ys, A::AbstractMatrix; kw...)

Polygonize an AbstractMatrix of values, currently to a single class of polygons.

Returns a MultiPolygon for Bool values and f return values, and a FeatureCollection of Features holding MultiPolygon for all other values.

Function f should return either true or false or a transformation of values into simpler groups, especially useful for floating point arrays.

If xs and ys are ranges, they are used as the pixel/cell center points. If they are Vector of Tuple they are used as the lower and upper bounds of each pixel/cell.

Keywords

  • minpoints: ignore polygons with less than minpoints points.

  • values: the values to turn into polygons. By default these are union(A), If function f is passed these refer to the return values of f, by default union(map(f, A). If values Bool, false is ignored and a single MultiPolygon is returned rather than a FeatureCollection.

Example

julia
using GeometryOps
+A = rand(100, 100)
+multipolygon = polygonize(>(0.5), A);

source

GeometryOps.segmentize Method
julia
segmentize([method = Planar()], geom; max_distance::Real, threaded)

Segmentize a geometry by adding extra vertices to the geometry so that no segment is longer than a given distance. This is useful for plotting geometries with a limited number of vertices, or for ensuring that a geometry is not too "coarse" for a given application.

Arguments

  • method::Manifold = Planar(): The method to use for segmentizing the geometry. At the moment, only Planar (assumes a flat plane) and Geodesic (assumes geometry on the ellipsoidal Earth and uses Vincenty's formulae) are available.

  • geom: The geometry to segmentize. Must be a LineString, LinearRing, Polygon, MultiPolygon, or GeometryCollection, or some vector or table of those.

  • max_distance::Real: The maximum distance between vertices in the geometry. Beware: for Planar, this is in the units of the geometry, but for Geodesic and Spherical it's in units of the radius of the sphere.

Returns a geometry of similar type to the input geometry, but resampled.

source

GeometryOps.signed_area Method
julia
signed_area(geom, [T = Float64])::T

Returns the signed area of a single geometry, based on winding order. This is computed slightly differently for different geometries:

- The signed area of a point is always zero.
+- The signed area of a curve is always zero.
+- The signed area of a polygon is computed with the shoelace formula and is
+positive if the polygon coordinates wind clockwise and negative if
+counterclockwise.
+- You cannot compute the signed area of a multipolygon as it doesn't have a
+meaning as each sub-polygon could have a different winding order.

Result will be of type T, where T is an optional argument with a default value of Float64.

source

GeometryOps.signed_distance Method
julia
signed_distance(point, geom, ::Type{T} = Float64)::T

Calculates the signed distance from the geometry geom to the given point. Points within geom have a negative signed distance, and points outside of geom have a positive signed distance. - The signed distance from a point to a point, line, linestring, or linear ring is equal to the distance between the two. - The signed distance from a point to a polygon is negative if the point is within the polygon and is positive otherwise. The value of the distance is the minimum distance from the point to an edge of the polygon. This includes edges created by holes. - The signed distance from a point to a multigeometry or a geometry collection is the minimum signed distance between the point and any of the sub-geometries.

Result will be of type T, where T is an optional argument with a default value of Float64.

source

GeometryOps.simplify Method
julia
simplify(obj; kw...)
+simplify(::SimplifyAlg, obj; kw...)

Simplify a geometry, feature, feature collection, or nested vectors or a table of these.

RadialDistance, DouglasPeucker, or VisvalingamWhyatt algorithms are available, listed in order of increasing quality but decreasing performance.

PoinTrait and MultiPointTrait are returned unchanged.

The default behaviour is simplify(DouglasPeucker(; kw...), obj). Pass in other SimplifyAlg to use other algorithms.

Keywords

  • prefilter_alg: SimplifyAlg algorithm used to pre-filter object before using primary filtering algorithm.

  • threaded: true or false. Whether to use multithreading. Defaults to false.

  • crs: The CRS to attach to geometries. Defaults to nothing.

  • calc_extent: true or false. Whether to calculate the extent. Defaults to false.

Keywords for DouglasPeucker are allowed when no algorithm is specified:

Keywords

  • ratio: the fraction of points that should remain after simplify. Useful as it will generalise for large collections of objects.

  • number: the number of points that should remain after simplify. Less useful for large collections of mixed size objects.

  • tol: the minimum distance a point will be from the line joining its neighboring points.

Example

Simplify a polygon to have six points:

julia
import GeoInterface as GI
+import GeometryOps as GO
+
+poly = GI.Polygon([[
+    [-70.603637, -33.399918],
+    [-70.614624, -33.395332],
+    [-70.639343, -33.392466],
+    [-70.659942, -33.394759],
+    [-70.683975, -33.404504],
+    [-70.697021, -33.419406],
+    [-70.701141, -33.434306],
+    [-70.700454, -33.446339],
+    [-70.694274, -33.458369],
+    [-70.682601, -33.465816],
+    [-70.668869, -33.472117],
+    [-70.646209, -33.473835],
+    [-70.624923, -33.472117],
+    [-70.609817, -33.468107],
+    [-70.595397, -33.458369],
+    [-70.587158, -33.442901],
+    [-70.587158, -33.426283],
+    [-70.590591, -33.414248],
+    [-70.594711, -33.406224],
+    [-70.603637, -33.399918]]])
+
+simple = GO.simplify(poly; number=6)
+GI.npoint(simple)
+
+# output
+6

source

GeometryOps.t_value Method
julia
t_value(sᵢ, sᵢ₊₁, rᵢ, rᵢ₊₁)

Returns the "T-value" as described in Hormann's presentation [1] on how to calculate the mean-value coordinate.

Here, sᵢ is the vector from vertex vᵢ to the point, and rᵢ is the norm (length) of sᵢ. s must be Point and r must be real numbers.

t=det(s,s)rr+ss

+
+[source](https://github.com/JuliaGeo/GeometryOps.jl/blob/347821afdac1a9ec607aa2939464014c8ef54b3d/src/methods/barycentric.jl#L289-L305)
+
+</details>
+
+<details class='jldocstring custom-block' open>
+<summary><a id='GeometryOps.to_edges-Union{Tuple{Any}, Tuple{T}, Tuple{Any, Type{T}}} where T' href='#GeometryOps.to_edges-Union{Tuple{Any}, Tuple{T}, Tuple{Any, Type{T}}} where T'><span class="jlbinding">GeometryOps.to_edges</span></a> <Badge type="info" class="jlObjectType jlMethod" text="Method" /></summary>
+
+
+
+```julia
+to_edges()

Convert any geometry or collection of geometries into a flat vector of Tuple{Tuple{Float64,Float64},Tuple{Float64,Float64}} edges.

source

GeometryOps.touches Method
julia
touches(geom1, geom2)::Bool

Return true if the first geometry touches the second geometry. In other words, the two interiors cannot interact, but one of the geometries must have a boundary point that interacts with either the other geometry's interior or boundary.

Examples

julia
import GeometryOps as GO, GeoInterface as GI
+
+l1 = GI.Line([(0.0, 0.0), (1.0, 0.0)])
+l2 = GI.Line([(1.0, 1.0), (1.0, -1.0)])
+
+GO.touches(l1, l2)
+# output
+true

source

GeometryOps.transform Method
julia
transform(f, obj)

Apply a function f to all the points in obj.

Points will be passed to f as an SVector to allow using CoordinateTransformations.jl and Rotations.jl without hassle.

SVector is also a valid GeoInterface.jl point, so will work in all GeoInterface.jl methods.

Example

julia
julia> import GeoInterface as GI
+
+julia> import GeometryOps as GO
+
+julia> geom = GI.Polygon([GI.LinearRing([(1, 2), (3, 4), (5, 6), (1, 2)]), GI.LinearRing([(3, 4), (5, 6), (6, 7), (3, 4)])]);
+
+julia> f = CoordinateTransformations.Translation(3.5, 1.5)
+Translation(3.5, 1.5)
+
+julia> GO.transform(f, geom)
+GeoInterface.Wrappers.Polygon{false, false, Vector{GeoInterface.Wrappers.LinearRing{false, false, Vector{StaticArraysCore.SVector{2, Float64}}, Nothing, Nothing}}, Nothing, Nothing}(GeoInterface.Wrappers.Linea
+rRing{false, false, Vector{StaticArraysCore.SVector{2, Float64}}, Nothing, Nothing}[GeoInterface.Wrappers.LinearRing{false, false, Vector{StaticArraysCore.SVector{2, Float64}}, Nothing, Nothing}(StaticArraysCo
+re.SVector{2, Float64}[[4.5, 3.5], [6.5, 5.5], [8.5, 7.5], [4.5, 3.5]], nothing, nothing), GeoInterface.Wrappers.LinearRing{false, false, Vector{StaticArraysCore.SVector{2, Float64}}, Nothing, Nothing}(StaticA
+rraysCore.SVector{2, Float64}[[6.5, 5.5], [8.5, 7.5], [9.5, 8.5], [6.5, 5.5]], nothing, nothing)], nothing, nothing)

With Rotations.jl you need to actually multiply the Rotation by the SVector point, which is easy using an anonymous function.

julia
julia> using Rotations
+
+julia> GO.transform(p -> one(RotMatrix{2}) * p, geom)
+GeoInterface.Wrappers.Polygon{false, false, Vector{GeoInterface.Wrappers.LinearRing{false, false, Vector{StaticArraysCore.SVector{2, Int64}}, Nothing, Nothing}}, Nothing, Nothing}(GeoInterface.Wrappers.LinearR
+ing{false, false, Vector{StaticArraysCore.SVector{2, Int64}}, Nothing, Nothing}[GeoInterface.Wrappers.LinearRing{false, false, Vector{StaticArraysCore.SVector{2, Int64}}, Nothing, Nothing}(StaticArraysCore.SVe
+ctor{2, Int64}[[2, 1], [4, 3], [6, 5], [2, 1]], nothing, nothing), GeoInterface.Wrappers.LinearRing{false, false, Vector{StaticArraysCore.SVector{2, Int64}}, Nothing, Nothing}(StaticArraysCore.SVector{2, Int64
+}[[4, 3], [6, 5], [7, 6], [4, 3]], nothing, nothing)], nothing, nothing)

source

GeometryOps.tuples Method
julia
tuples(obj)

Convert all points in obj to Tuples, wherever the are nested.

Returns a similar object or collection of objects using GeoInterface.jl geometries wrapping Tuple points.

Keywords

  • threaded: true or false. Whether to use multithreading. Defaults to false.

  • crs: The CRS to attach to geometries. Defaults to nothing.

  • calc_extent: true or false. Whether to calculate the extent. Defaults to false.

source

GeometryOps.union Method
julia
union(geom_a, geom_b, [::Type{T}]; target::Type, fix_multipoly = UnionIntersectingPolygons())

Return the union between two geometries as a list of geometries. Return an empty list if none are found. The type of the list will be constrained as much as possible given the input geometries. Furthermore, the user can provide a taget type as a keyword argument and a list of target geometries found in the difference will be returned. The user can also provide a float type 'T' that they would like the points of returned geometries to be. If the user is taking a intersection involving one or more multipolygons, and the multipolygon might be comprised of polygons that intersect, if fix_multipoly is set to an IntersectingPolygons correction (the default is UnionIntersectingPolygons()), then the needed multipolygons will be fixed to be valid before performing the intersection to ensure a correct answer. Only set fix_multipoly to false if you know that the multipolygons are valid, as it will avoid unneeded computation.

Calculates the union between two polygons.

Example

julia
import GeoInterface as GI, GeometryOps as GO
+
+p1 = GI.Polygon([[(0.0, 0.0), (5.0, 5.0), (10.0, 0.0), (5.0, -5.0), (0.0, 0.0)]])
+p2 = GI.Polygon([[(3.0, 0.0), (8.0, 5.0), (13.0, 0.0), (8.0, -5.0), (3.0, 0.0)]])
+union_poly = GO.union(p1, p2; target = GI.PolygonTrait())
+GI.coordinates.(union_poly)
+
+# output
+1-element Vector{Vector{Vector{Vector{Float64}}}}:
+ [[[6.5, 3.5], [5.0, 5.0], [0.0, 0.0], [5.0, -5.0], [6.5, -3.5], [8.0, -5.0], [13.0, 0.0], [8.0, 5.0], [6.5, 3.5]]]

source

GeometryOps.weighted_mean Method
julia
weighted_mean(weight::Real, x1, x2)

Returns the weighted mean of x1 and x2, where weight is the weight of x1.

Specifically, calculates x1 * weight + x2 * (1 - weight).

Note

The idea for this method is that you can override this for custom types, like Color types, in extension modules.

source

GeometryOps.within Method
julia
within(geom1, geom2)::Bool

Return true if the first geometry is completely within the second geometry. The interiors of both geometries must intersect and the interior and boundary of the primary geometry (geom1) must not intersect the exterior of the secondary geometry (geom2).

Furthermore, within returns the exact opposite result of contains.

Examples

julia
import GeometryOps as GO, GeoInterface as GI
+
+line = GI.LineString([(1, 1), (1, 2), (1, 3), (1, 4)])
+point = (1, 2)
+GO.within(point, line)
+
+# output
+true

source


  1. K. Hormann and N. Sukumar. Generalized Barycentric Coordinates in Computer Graphics and Computational Mechanics. Taylor & Fancis, CRC Press, 2017. ↩︎

+ + + + \ No newline at end of file diff --git a/previews/PR237/assets/aecehxl.0OJvb21A.png b/previews/PR237/assets/aecehxl.0OJvb21A.png new file mode 100644 index 0000000000000000000000000000000000000000..38ed060781aec6333b0f4888c59a37f930117065 GIT binary patch literal 18310 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 literal 0 HcmV?d00001 diff --git a/previews/PR237/assets/api.md.CJkYwQvX.js b/previews/PR237/assets/api.md.CJkYwQvX.js new file mode 100644 index 000000000..ed1ff9772 --- /dev/null +++ b/previews/PR237/assets/api.md.CJkYwQvX.js @@ -0,0 +1,381 @@ +import{_ as h,c as l,a5 as a,j as i,a as e,G as n,B as k,o as p}from"./chunks/framework.Cq8AuEls.js";const mi=JSON.parse('{"title":"Full GeometryOps API documentation","description":"","frontmatter":{},"headers":[],"relativePath":"api.md","filePath":"api.md","lastUpdated":null}'),r={name:"api.md"},o={class:"jldocstring custom-block",open:""},d={class:"jldocstring custom-block",open:""},g={class:"jldocstring custom-block",open:""},y={class:"jldocstring custom-block",open:""},E={class:"jldocstring custom-block",open:""},c={class:"jldocstring custom-block",open:""},u={class:"jldocstring custom-block",open:""},m={class:"jldocstring custom-block",open:""},F={class:"jldocstring custom-block",open:""},C={class:"jldocstring custom-block",open:""},b={class:"jldocstring custom-block",open:""},f={class:"jldocstring custom-block",open:""},T={class:"jldocstring custom-block",open:""},G={class:"jldocstring custom-block",open:""},v={class:"jldocstring custom-block",open:""},A={class:"jldocstring custom-block",open:""},j={class:"jldocstring custom-block",open:""},B={class:"jldocstring custom-block",open:""},O={class:"jldocstring custom-block",open:""},D={class:"jldocstring custom-block",open:""},Q={class:"jldocstring custom-block",open:""},x={class:"jldocstring custom-block",open:""},w={class:"jldocstring custom-block",open:""},L={class:"jldocstring custom-block",open:""},I={class:"jldocstring custom-block",open:""},M={class:"jldocstring custom-block",open:""},P={class:"jldocstring custom-block",open:""},q={class:"jldocstring custom-block",open:""},R={class:"jldocstring custom-block",open:""},S={class:"jldocstring custom-block",open:""},V={class:"jldocstring custom-block",open:""},J={class:"jldocstring custom-block",open:""},U={class:"jldocstring custom-block",open:""},H={class:"jldocstring custom-block",open:""},N={class:"jldocstring custom-block",open:""},W={class:"jldocstring custom-block",open:""},z={class:"jldocstring custom-block",open:""},Z={class:"jldocstring custom-block",open:""},_={class:"jldocstring custom-block",open:""},K={class:"jldocstring custom-block",open:""},X={class:"jldocstring custom-block",open:""},$={class:"jldocstring custom-block",open:""},Y={class:"jldocstring custom-block",open:""},ss={class:"jldocstring custom-block",open:""},is={class:"jldocstring custom-block",open:""},as={class:"jldocstring custom-block",open:""},es={class:"jldocstring custom-block",open:""},ts={class:"jldocstring custom-block",open:""},ns={class:"jldocstring custom-block",open:""},ls={class:"jldocstring custom-block",open:""},ps={class:"jldocstring custom-block",open:""},hs={class:"jldocstring custom-block",open:""},ks={class:"jldocstring custom-block",open:""},rs={class:"jldocstring custom-block",open:""},os={class:"jldocstring custom-block",open:""},ds={class:"jldocstring custom-block",open:""},gs={class:"jldocstring custom-block",open:""},ys={class:"jldocstring custom-block",open:""},Es={class:"jldocstring custom-block",open:""},cs={class:"jldocstring custom-block",open:""},us={class:"jldocstring custom-block",open:""},ms={class:"jldocstring custom-block",open:""},Fs={class:"jldocstring custom-block",open:""},Cs={class:"jldocstring custom-block",open:""},bs={class:"jldocstring custom-block",open:""},fs={class:"jldocstring custom-block",open:""},Ts={class:"jldocstring custom-block",open:""},Gs={class:"jldocstring custom-block",open:""},vs={class:"jldocstring custom-block",open:""},As={class:"jldocstring custom-block",open:""},js={class:"jldocstring custom-block",open:""},Bs={class:"jldocstring custom-block",open:""},Os={class:"jldocstring custom-block",open:""},Ds={class:"jldocstring custom-block",open:""},Qs={class:"jldocstring custom-block",open:""},xs={class:"jldocstring custom-block",open:""},ws={class:"jldocstring custom-block",open:""},Ls={class:"jldocstring custom-block",open:""},Is={class:"jldocstring custom-block",open:""},Ms={class:"jldocstring custom-block",open:""},Ps={class:"jldocstring custom-block",open:""},qs={class:"MathJax",jax:"SVG",display:"true",style:{direction:"ltr",display:"block","text-align":"center",margin:"1em 0",position:"relative"}},Rs={style:{overflow:"visible","min-height":"1px","min-width":"1px","vertical-align":"-2.827ex"},xmlns:"http://www.w3.org/2000/svg",width:"33.539ex",height:"6.785ex",role:"img",focusable:"false",viewBox:"0 -1749.5 14824.1 2999","aria-hidden":"true"},Ss={class:"jldocstring custom-block",open:""},Vs={class:"jldocstring custom-block",open:""},Js={class:"jldocstring custom-block",open:""},Us={class:"jldocstring custom-block",open:""},Hs={class:"jldocstring custom-block",open:""},Ns={class:"jldocstring custom-block",open:""},Ws={class:"jldocstring custom-block",open:""},zs={class:"jldocstring custom-block",open:""},Zs={class:"jldocstring custom-block",open:""},_s={class:"jldocstring custom-block",open:""},Ks={class:"jldocstring custom-block",open:""},Xs={class:"jldocstring custom-block",open:""},$s={class:"jldocstring custom-block",open:""},Ys={class:"jldocstring custom-block",open:""},si={class:"jldocstring custom-block",open:""},ii={class:"jldocstring custom-block",open:""},ai={class:"jldocstring custom-block",open:""},ei={class:"MathJax",jax:"SVG",display:"true",style:{direction:"ltr",display:"block","text-align":"center",margin:"1em 0",position:"relative"}},ti={style:{overflow:"visible","min-height":"1px","min-width":"1px","vertical-align":"-2.059ex"},xmlns:"http://www.w3.org/2000/svg",width:"27.746ex",height:"5.362ex",role:"img",focusable:"false",viewBox:"0 -1460 12263.9 2370","aria-hidden":"true"},ni={class:"jldocstring custom-block",open:""},li={class:"jldocstring custom-block",open:""},pi={class:"jldocstring custom-block",open:""},hi={class:"jldocstring custom-block",open:""},ki={class:"jldocstring custom-block",open:""},ri={class:"jldocstring custom-block",open:""};function oi(di,s,gi,yi,Ei,ci){const t=k("Badge");return p(),l("div",null,[s[318]||(s[318]=a('

Full GeometryOps API documentation

Warning

This page is still very much WIP!

Documentation for GeometryOps's full API (only for reference!).

apply and associated functions

',5)),i("details",o,[i("summary",null,[s[0]||(s[0]=i("a",{id:"GeometryOpsCore.apply",href:"#GeometryOpsCore.apply"},[i("span",{class:"jlbinding"},"GeometryOpsCore.apply")],-1)),s[1]||(s[1]=e()),n(t,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[2]||(s[2]=a(`
julia
apply(f, target::Union{TraitTarget, GI.AbstractTrait}, obj; kw...)

Reconstruct a geometry, feature, feature collection, or nested vectors of either using the function f on the target trait.

f(target_geom) => x where x also has the target trait, or a trait that can be substituted. For example, swapping PolgonTrait to MultiPointTrait will fail if the outer object has MultiPolygonTrait, but should work if it has FeatureTrait.

Objects "shallower" than the target trait are always completely rebuilt, like a Vector of FeatureCollectionTrait of FeatureTrait when the target has PolygonTrait and is held in the features. These will always be GeoInterface geometries/feature/feature collections. But "deeper" objects may remain unchanged or be whatever GeoInterface compatible objects f returns.

The result is a functionally similar geometry with values depending on f.

  • threaded: true or false. Whether to use multithreading. Defaults to false.

  • crs: The CRS to attach to geometries. Defaults to nothing.

  • calc_extent: true or false. Whether to calculate the extent. Defaults to false.

Example

Flipped point the order in any feature or geometry, or iterables of either:

julia
import GeoInterface as GI
+import GeometryOps as GO
+geom = GI.Polygon([GI.LinearRing([(1, 2), (3, 4), (5, 6), (1, 2)]),
+                   GI.LinearRing([(3, 4), (5, 6), (6, 7), (3, 4)])])
+
+flipped_geom = GO.apply(GI.PointTrait, geom) do p
+    (GI.y(p), GI.x(p))
+end

source

`,10))]),i("details",d,[i("summary",null,[s[3]||(s[3]=i("a",{id:"GeometryOpsCore.applyreduce",href:"#GeometryOpsCore.applyreduce"},[i("span",{class:"jlbinding"},"GeometryOpsCore.applyreduce")],-1)),s[4]||(s[4]=e()),n(t,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[5]||(s[5]=a('
julia
applyreduce(f, op, target::Union{TraitTarget, GI.AbstractTrait}, obj; threaded)

Apply function f to all objects with the target trait, and reduce the result with an op like +.

The order and grouping of application of op is not guaranteed.

If threaded==true threads will be used over arrays and iterables, feature collections and nested geometries.

source

',5))]),i("details",g,[i("summary",null,[s[6]||(s[6]=i("a",{id:"GeometryOps.reproject",href:"#GeometryOps.reproject"},[i("span",{class:"jlbinding"},"GeometryOps.reproject")],-1)),s[7]||(s[7]=e()),n(t,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[8]||(s[8]=a(`
julia
reproject(geometry; source_crs, target_crs, transform, always_xy, time)
+reproject(geometry, source_crs, target_crs; always_xy, time)
+reproject(geometry, transform; always_xy, time)

Reproject any GeoInterface.jl compatible geometry from source_crs to target_crs.

The returned object will be constructed from GeoInterface.WrapperGeometry geometries, wrapping views of a Vector{Proj.Point{D}}, where D is the dimension.

Tip

The Proj.jl package must be loaded for this method to work, since it is implemented in a package extension.

Arguments

  • geometry: Any GeoInterface.jl compatible geometries.

  • source_crs: the source coordinate reference system, as a GeoFormatTypes.jl object or a string.

  • target_crs: the target coordinate reference system, as a GeoFormatTypes.jl object or a string.

If these a passed as keywords, transform will take priority. Without it target_crs is always needed, and source_crs is needed if it is not retrievable from the geometry with GeoInterface.crs(geometry).

Keywords

  • always_xy: force x, y coordinate order, true by default. false will expect and return points in the crs coordinate order.

  • time: the time for the coordinates. Inf by default.

  • threaded: true or false. Whether to use multithreading. Defaults to false.

  • crs: The CRS to attach to geometries. Defaults to nothing.

  • calc_extent: true or false. Whether to calculate the extent. Defaults to false.

source

`,10))]),i("details",y,[i("summary",null,[s[9]||(s[9]=i("a",{id:"GeometryOps.transform",href:"#GeometryOps.transform"},[i("span",{class:"jlbinding"},"GeometryOps.transform")],-1)),s[10]||(s[10]=e()),n(t,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[11]||(s[11]=a(`
julia
transform(f, obj)

Apply a function f to all the points in obj.

Points will be passed to f as an SVector to allow using CoordinateTransformations.jl and Rotations.jl without hassle.

SVector is also a valid GeoInterface.jl point, so will work in all GeoInterface.jl methods.

Example

julia
julia> import GeoInterface as GI
+
+julia> import GeometryOps as GO
+
+julia> geom = GI.Polygon([GI.LinearRing([(1, 2), (3, 4), (5, 6), (1, 2)]), GI.LinearRing([(3, 4), (5, 6), (6, 7), (3, 4)])]);
+
+julia> f = CoordinateTransformations.Translation(3.5, 1.5)
+Translation(3.5, 1.5)
+
+julia> GO.transform(f, geom)
+GeoInterface.Wrappers.Polygon{false, false, Vector{GeoInterface.Wrappers.LinearRing{false, false, Vector{StaticArraysCore.SVector{2, Float64}}, Nothing, Nothing}}, Nothing, Nothing}(GeoInterface.Wrappers.Linea
+rRing{false, false, Vector{StaticArraysCore.SVector{2, Float64}}, Nothing, Nothing}[GeoInterface.Wrappers.LinearRing{false, false, Vector{StaticArraysCore.SVector{2, Float64}}, Nothing, Nothing}(StaticArraysCo
+re.SVector{2, Float64}[[4.5, 3.5], [6.5, 5.5], [8.5, 7.5], [4.5, 3.5]], nothing, nothing), GeoInterface.Wrappers.LinearRing{false, false, Vector{StaticArraysCore.SVector{2, Float64}}, Nothing, Nothing}(StaticA
+rraysCore.SVector{2, Float64}[[6.5, 5.5], [8.5, 7.5], [9.5, 8.5], [6.5, 5.5]], nothing, nothing)], nothing, nothing)

With Rotations.jl you need to actually multiply the Rotation by the SVector point, which is easy using an anonymous function.

julia
julia> using Rotations
+
+julia> GO.transform(p -> one(RotMatrix{2}) * p, geom)
+GeoInterface.Wrappers.Polygon{false, false, Vector{GeoInterface.Wrappers.LinearRing{false, false, Vector{StaticArraysCore.SVector{2, Int64}}, Nothing, Nothing}}, Nothing, Nothing}(GeoInterface.Wrappers.LinearR
+ing{false, false, Vector{StaticArraysCore.SVector{2, Int64}}, Nothing, Nothing}[GeoInterface.Wrappers.LinearRing{false, false, Vector{StaticArraysCore.SVector{2, Int64}}, Nothing, Nothing}(StaticArraysCore.SVe
+ctor{2, Int64}[[2, 1], [4, 3], [6, 5], [2, 1]], nothing, nothing), GeoInterface.Wrappers.LinearRing{false, false, Vector{StaticArraysCore.SVector{2, Int64}}, Nothing, Nothing}(StaticArraysCore.SVector{2, Int64
+}[[4, 3], [6, 5], [7, 6], [4, 3]], nothing, nothing)], nothing, nothing)

source

`,9))]),s[319]||(s[319]=i("h2",{id:"General-geometry-methods",tabindex:"-1"},[e("General geometry methods "),i("a",{class:"header-anchor",href:"#General-geometry-methods","aria-label":'Permalink to "General geometry methods {#General-geometry-methods}"'},"​")],-1)),s[320]||(s[320]=i("h3",{id:"OGC-methods",tabindex:"-1"},[e("OGC methods "),i("a",{class:"header-anchor",href:"#OGC-methods","aria-label":'Permalink to "OGC methods {#OGC-methods}"'},"​")],-1)),i("details",E,[i("summary",null,[s[12]||(s[12]=i("a",{id:"GeometryOps.contains",href:"#GeometryOps.contains"},[i("span",{class:"jlbinding"},"GeometryOps.contains")],-1)),s[13]||(s[13]=e()),n(t,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[14]||(s[14]=a(`
julia
contains(g1::AbstractGeometry, g2::AbstractGeometry)::Bool

Return true if the second geometry is completely contained by the first geometry. The interiors of both geometries must intersect and the interior and boundary of the secondary (g2) must not intersect the exterior of the first (g1).

contains returns the exact opposite result of within.

Examples

julia
import GeometryOps as GO, GeoInterface as GI
+line = GI.LineString([(1, 1), (1, 2), (1, 3), (1, 4)])
+point = GI.Point((1, 2))
+
+GO.contains(line, point)
+# output
+true

source

`,6))]),i("details",c,[i("summary",null,[s[15]||(s[15]=i("a",{id:"GeometryOps.coveredby",href:"#GeometryOps.coveredby"},[i("span",{class:"jlbinding"},"GeometryOps.coveredby")],-1)),s[16]||(s[16]=e()),n(t,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[17]||(s[17]=a(`
julia
coveredby(g1, g2)::Bool

Return true if the first geometry is completely covered by the second geometry. The interior and boundary of the primary geometry (g1) must not intersect the exterior of the secondary geometry (g2).

Furthermore, coveredby returns the exact opposite result of covers. They are equivalent with the order of the arguments swapped.

Examples

julia
import GeometryOps as GO, GeoInterface as GI
+p1 = GI.Point(0.0, 0.0)
+p2 = GI.Point(1.0, 1.0)
+l1 = GI.Line([p1, p2])
+
+GO.coveredby(p1, l1)
+# output
+true

source

`,6))]),i("details",u,[i("summary",null,[s[18]||(s[18]=i("a",{id:"GeometryOps.covers",href:"#GeometryOps.covers"},[i("span",{class:"jlbinding"},"GeometryOps.covers")],-1)),s[19]||(s[19]=e()),n(t,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[20]||(s[20]=a(`
julia
covers(g1::AbstractGeometry, g2::AbstractGeometry)::Bool

Return true if the first geometry is completely covers the second geometry, The exterior and boundary of the second geometry must not be outside of the interior and boundary of the first geometry. However, the interiors need not intersect.

covers returns the exact opposite result of coveredby.

Examples

julia
import GeometryOps as GO, GeoInterface as GI
+l1 = GI.LineString([(1.0, 1.0), (1.0, 2.0), (1.0, 3.0), (1.0, 4.0)])
+l2 = GI.LineString([(1.0, 1.0), (1.0, 2.0)])
+
+GO.covers(l1, l2)
+# output
+true

source

`,6))]),i("details",m,[i("summary",null,[s[21]||(s[21]=i("a",{id:"GeometryOps.crosses",href:"#GeometryOps.crosses"},[i("span",{class:"jlbinding"},"GeometryOps.crosses")],-1)),s[22]||(s[22]=e()),n(t,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[23]||(s[23]=a(`
julia
 crosses(geom1, geom2)::Bool

Return true if the intersection results in a geometry whose dimension is one less than the maximum dimension of the two source geometries and the intersection set is interior to both source geometries.

TODO: broken

Examples

julia
import GeoInterface as GI, GeometryOps as GO
+# TODO: Add working example

source

`,6))]),i("details",F,[i("summary",null,[s[24]||(s[24]=i("a",{id:"GeometryOps.disjoint",href:"#GeometryOps.disjoint"},[i("span",{class:"jlbinding"},"GeometryOps.disjoint")],-1)),s[25]||(s[25]=e()),n(t,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[26]||(s[26]=a(`
julia
disjoint(geom1, geom2)::Bool

Return true if the first geometry is disjoint from the second geometry.

Return true if the first geometry is disjoint from the second geometry. The interiors and boundaries of both geometries must not intersect.

Examples

julia
import GeometryOps as GO, GeoInterface as GI
+
+line = GI.LineString([(1, 1), (1, 2), (1, 3), (1, 4)])
+point = (2, 2)
+GO.disjoint(point, line)
+
+# output
+true

source

`,6))]),i("details",C,[i("summary",null,[s[27]||(s[27]=i("a",{id:"GeometryOps.intersects",href:"#GeometryOps.intersects"},[i("span",{class:"jlbinding"},"GeometryOps.intersects")],-1)),s[28]||(s[28]=e()),n(t,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[29]||(s[29]=a(`
julia
intersects(geom1, geom2)::Bool

Return true if the interiors or boundaries of the two geometries interact.

intersects returns the exact opposite result of disjoint.

Example

julia
import GeoInterface as GI, GeometryOps as GO
+
+line1 = GI.Line([(124.584961,-12.768946), (126.738281,-17.224758)])
+line2 = GI.Line([(123.354492,-15.961329), (127.22168,-14.008696)])
+GO.intersects(line1, line2)
+
+# output
+true

source

`,6))]),i("details",b,[i("summary",null,[s[30]||(s[30]=i("a",{id:"GeometryOps.overlaps",href:"#GeometryOps.overlaps"},[i("span",{class:"jlbinding"},"GeometryOps.overlaps")],-1)),s[31]||(s[31]=e()),n(t,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[32]||(s[32]=a(`
julia
overlaps(geom1, geom2)::Bool

Compare two Geometries of the same dimension and return true if their intersection set results in a geometry different from both but of the same dimension. This means one geometry cannot be within or contain the other and they cannot be equal

Examples

julia
import GeometryOps as GO, GeoInterface as GI
+poly1 = GI.Polygon([[(0,0), (0,5), (5,5), (5,0), (0,0)]])
+poly2 = GI.Polygon([[(1,1), (1,6), (6,6), (6,1), (1,1)]])
+
+GO.overlaps(poly1, poly2)
+# output
+true

source

julia
overlaps(::GI.AbstractTrait, geom1, ::GI.AbstractTrait, geom2)::Bool

For any non-specified pair, all have non-matching dimensions, return false.

source

julia
overlaps(
+    ::GI.MultiPointTrait, points1,
+    ::GI.MultiPointTrait, points2,
+)::Bool

If the multipoints overlap, meaning some, but not all, of the points within the multipoints are shared, return true.

source

julia
overlaps(::GI.LineTrait, line1, ::GI.LineTrait, line)::Bool

If the lines overlap, meaning that they are collinear but each have one endpoint outside of the other line, return true. Else false.

source

julia
overlaps(
+    ::Union{GI.LineStringTrait, GI.LinearRing}, line1,
+    ::Union{GI.LineStringTrait, GI.LinearRing}, line2,
+)::Bool

If the curves overlap, meaning that at least one edge of each curve overlaps, return true. Else false.

source

julia
overlaps(
+    trait_a::GI.PolygonTrait, poly_a,
+    trait_b::GI.PolygonTrait, poly_b,
+)::Bool

If the two polygons intersect with one another, but are not equal, return true. Else false.

source

julia
overlaps(
+    ::GI.PolygonTrait, poly1,
+    ::GI.MultiPolygonTrait, polys2,
+)::Bool

Return true if polygon overlaps with at least one of the polygons within the multipolygon. Else false.

source

julia
overlaps(
+    ::GI.MultiPolygonTrait, polys1,
+    ::GI.PolygonTrait, poly2,
+)::Bool

Return true if polygon overlaps with at least one of the polygons within the multipolygon. Else false.

source

julia
overlaps(
+    ::GI.MultiPolygonTrait, polys1,
+    ::GI.MultiPolygonTrait, polys2,
+)::Bool

Return true if at least one pair of polygons from multipolygons overlap. Else false.

source

`,29))]),i("details",f,[i("summary",null,[s[33]||(s[33]=i("a",{id:"GeometryOps.touches",href:"#GeometryOps.touches"},[i("span",{class:"jlbinding"},"GeometryOps.touches")],-1)),s[34]||(s[34]=e()),n(t,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[35]||(s[35]=a(`
julia
touches(geom1, geom2)::Bool

Return true if the first geometry touches the second geometry. In other words, the two interiors cannot interact, but one of the geometries must have a boundary point that interacts with either the other geometry's interior or boundary.

Examples

julia
import GeometryOps as GO, GeoInterface as GI
+
+l1 = GI.Line([(0.0, 0.0), (1.0, 0.0)])
+l2 = GI.Line([(1.0, 1.0), (1.0, -1.0)])
+
+GO.touches(l1, l2)
+# output
+true

source

`,5))]),i("details",T,[i("summary",null,[s[36]||(s[36]=i("a",{id:"GeometryOps.within",href:"#GeometryOps.within"},[i("span",{class:"jlbinding"},"GeometryOps.within")],-1)),s[37]||(s[37]=e()),n(t,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[38]||(s[38]=a(`
julia
within(geom1, geom2)::Bool

Return true if the first geometry is completely within the second geometry. The interiors of both geometries must intersect and the interior and boundary of the primary geometry (geom1) must not intersect the exterior of the secondary geometry (geom2).

Furthermore, within returns the exact opposite result of contains.

Examples

julia
import GeometryOps as GO, GeoInterface as GI
+
+line = GI.LineString([(1, 1), (1, 2), (1, 3), (1, 4)])
+point = (1, 2)
+GO.within(point, line)
+
+# output
+true

source

`,6))]),s[321]||(s[321]=i("h3",{id:"Other-general-methods",tabindex:"-1"},[e("Other general methods "),i("a",{class:"header-anchor",href:"#Other-general-methods","aria-label":'Permalink to "Other general methods {#Other-general-methods}"'},"​")],-1)),i("details",G,[i("summary",null,[s[39]||(s[39]=i("a",{id:"GeometryOps.equals",href:"#GeometryOps.equals"},[i("span",{class:"jlbinding"},"GeometryOps.equals")],-1)),s[40]||(s[40]=e()),n(t,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[41]||(s[41]=a(`
julia
equals(geom1, geom2)::Bool

Compare two Geometries return true if they are the same geometry.

Examples

julia
import GeometryOps as GO, GeoInterface as GI
+poly1 = GI.Polygon([[(0,0), (0,5), (5,5), (5,0), (0,0)]])
+poly2 = GI.Polygon([[(0,0), (0,5), (5,5), (5,0), (0,0)]])
+
+GO.equals(poly1, poly2)
+# output
+true

source

julia
equals(::T, geom_a, ::T, geom_b)::Bool

Two geometries of the same type, which don't have a equals function to dispatch off of should throw an error.

source

julia
equals(trait_a, geom_a, trait_b, geom_b)

Two geometries which are not of the same type cannot be equal so they always return false.

source

julia
equals(::GI.PointTrait, p1, ::GI.PointTrait, p2)::Bool

Two points are the same if they have the same x and y (and z if 3D) coordinates.

source

julia
equals(::GI.PointTrait, p1, ::GI.MultiPointTrait, mp2)::Bool

A point and a multipoint are equal if the multipoint is composed of a single point that is equivalent to the given point.

source

julia
equals(::GI.MultiPointTrait, mp1, ::GI.PointTrait, p2)::Bool

A point and a multipoint are equal if the multipoint is composed of a single point that is equivalent to the given point.

source

julia
equals(::GI.MultiPointTrait, mp1, ::GI.MultiPointTrait, mp2)::Bool

Two multipoints are equal if they share the same set of points.

source

julia
equals(
+    ::Union{GI.LineTrait, GI.LineStringTrait}, l1,
+    ::Union{GI.LineTrait, GI.LineStringTrait}, l2,
+)::Bool

Two lines/linestrings are equal if they share the same set of points going along the curve. Note that lines/linestrings aren't closed by definition.

source

julia
equals(
+    ::Union{GI.LineTrait, GI.LineStringTrait}, l1,
+    ::GI.LinearRingTrait, l2,
+)::Bool

A line/linestring and a linear ring are equal if they share the same set of points going along the curve. Note that lines aren't closed by definition, but rings are, so the line must have a repeated last point to be equal

source

julia
equals(
+    ::GI.LinearRingTrait, l1,
+    ::Union{GI.LineTrait, GI.LineStringTrait}, l2,
+)::Bool

A linear ring and a line/linestring are equal if they share the same set of points going along the curve. Note that lines aren't closed by definition, but rings are, so the line must have a repeated last point to be equal

source

julia
equals(
+    ::GI.LinearRingTrait, l1,
+    ::GI.LinearRingTrait, l2,
+)::Bool

Two linear rings are equal if they share the same set of points going along the curve. Note that rings are closed by definition, so they can have, but don't need, a repeated last point to be equal.

source

julia
equals(::GI.PolygonTrait, geom_a, ::GI.PolygonTrait, geom_b)::Bool

Two polygons are equal if they share the same exterior edge and holes.

source

julia
equals(::GI.PolygonTrait, geom_a, ::GI.MultiPolygonTrait, geom_b)::Bool

A polygon and a multipolygon are equal if the multipolygon is composed of a single polygon that is equivalent to the given polygon.

source

julia
equals(::GI.MultiPolygonTrait, geom_a, ::GI.PolygonTrait, geom_b)::Bool

A polygon and a multipolygon are equal if the multipolygon is composed of a single polygon that is equivalent to the given polygon.

source

julia
equals(::GI.PolygonTrait, geom_a, ::GI.PolygonTrait, geom_b)::Bool

Two multipolygons are equal if they share the same set of polygons.

source

`,47))]),i("details",v,[i("summary",null,[s[42]||(s[42]=i("a",{id:"GeometryOps.centroid",href:"#GeometryOps.centroid"},[i("span",{class:"jlbinding"},"GeometryOps.centroid")],-1)),s[43]||(s[43]=e()),n(t,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[44]||(s[44]=a('
julia
centroid(geom, [T=Float64])::Tuple{T, T}

Returns the centroid of a given line segment, linear ring, polygon, or mutlipolygon.

source

',3))]),i("details",A,[i("summary",null,[s[45]||(s[45]=i("a",{id:"GeometryOps.distance",href:"#GeometryOps.distance"},[i("span",{class:"jlbinding"},"GeometryOps.distance")],-1)),s[46]||(s[46]=e()),n(t,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[47]||(s[47]=a('
julia
distance(point, geom, ::Type{T} = Float64)::T

Calculates the ditance from the geometry g1 to the point. The distance will always be positive or zero.

The method will differ based on the type of the geometry provided: - The distance from a point to a point is just the Euclidean distance between the points. - The distance from a point to a line is the minimum distance from the point to the closest point on the given line. - The distance from a point to a linestring is the minimum distance from the point to the closest segment of the linestring. - The distance from a point to a linear ring is the minimum distance from the point to the closest segment of the linear ring. - The distance from a point to a polygon is zero if the point is within the polygon and otherwise is the minimum distance from the point to an edge of the polygon. This includes edges created by holes. - The distance from a point to a multigeometry or a geometry collection is the minimum distance between the point and any of the sub-geometries.

Result will be of type T, where T is an optional argument with a default value of Float64.

source

',5))]),i("details",j,[i("summary",null,[s[48]||(s[48]=i("a",{id:"GeometryOps.signed_distance",href:"#GeometryOps.signed_distance"},[i("span",{class:"jlbinding"},"GeometryOps.signed_distance")],-1)),s[49]||(s[49]=e()),n(t,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[50]||(s[50]=a('
julia
signed_distance(point, geom, ::Type{T} = Float64)::T

Calculates the signed distance from the geometry geom to the given point. Points within geom have a negative signed distance, and points outside of geom have a positive signed distance. - The signed distance from a point to a point, line, linestring, or linear ring is equal to the distance between the two. - The signed distance from a point to a polygon is negative if the point is within the polygon and is positive otherwise. The value of the distance is the minimum distance from the point to an edge of the polygon. This includes edges created by holes. - The signed distance from a point to a multigeometry or a geometry collection is the minimum signed distance between the point and any of the sub-geometries.

Result will be of type T, where T is an optional argument with a default value of Float64.

source

',4))]),i("details",B,[i("summary",null,[s[51]||(s[51]=i("a",{id:"GeometryOps.area",href:"#GeometryOps.area"},[i("span",{class:"jlbinding"},"GeometryOps.area")],-1)),s[52]||(s[52]=e()),n(t,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[53]||(s[53]=a(`
julia
area(geom, [T = Float64])::T

Returns the area of a geometry or collection of geometries. This is computed slightly differently for different geometries:

- The area of a point/multipoint is always zero.
+- The area of a curve/multicurve is always zero.
+- The area of a polygon is the absolute value of the signed area.
+- The area multi-polygon is the sum of the areas of all of the sub-polygons.
+- The area of a geometry collection, feature collection of array/iterable 
+    is the sum of the areas of all of the sub-geometries.

Result will be of type T, where T is an optional argument with a default value of Float64.

source

`,5))]),i("details",O,[i("summary",null,[s[54]||(s[54]=i("a",{id:"GeometryOps.signed_area",href:"#GeometryOps.signed_area"},[i("span",{class:"jlbinding"},"GeometryOps.signed_area")],-1)),s[55]||(s[55]=e()),n(t,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[56]||(s[56]=a(`
julia
signed_area(geom, [T = Float64])::T

Returns the signed area of a single geometry, based on winding order. This is computed slightly differently for different geometries:

- The signed area of a point is always zero.
+- The signed area of a curve is always zero.
+- The signed area of a polygon is computed with the shoelace formula and is
+positive if the polygon coordinates wind clockwise and negative if
+counterclockwise.
+- You cannot compute the signed area of a multipolygon as it doesn't have a
+meaning as each sub-polygon could have a different winding order.

Result will be of type T, where T is an optional argument with a default value of Float64.

source

`,5))]),i("details",D,[i("summary",null,[s[57]||(s[57]=i("a",{id:"GeometryOps.angles",href:"#GeometryOps.angles"},[i("span",{class:"jlbinding"},"GeometryOps.angles")],-1)),s[58]||(s[58]=e()),n(t,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[59]||(s[59]=a(`
julia
angles(geom, ::Type{T} = Float64)

Returns the angles of a geometry or collection of geometries. This is computed differently for different geometries:

- The angles of a point is an empty vector.
+- The angles of a single line segment is an empty vector.
+- The angles of a linestring or linearring is a vector of angles formed by the curve.
+- The angles of a polygon is a vector of vectors of angles formed by each ring.
+- The angles of a multi-geometry collection is a vector of the angles of each of the
+    sub-geometries as defined above.

Result will be a Vector, or nested set of vectors, of type T where an optional argument with a default value of Float64.

source

`,5))]),i("details",Q,[i("summary",null,[s[60]||(s[60]=i("a",{id:"GeometryOps.embed_extent",href:"#GeometryOps.embed_extent"},[i("span",{class:"jlbinding"},"GeometryOps.embed_extent")],-1)),s[61]||(s[61]=e()),n(t,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[62]||(s[62]=a('
julia
embed_extent(obj)

Recursively wrap the object with a GeoInterface.jl geometry, calculating and adding an Extents.Extent to all objects.

This can improve performance when extents need to be checked multiple times, such when needing to check if many points are in geometries, and using their extents as a quick filter for obviously exterior points.

Keywords

  • threaded: true or false. Whether to use multithreading. Defaults to false.

  • crs: The CRS to attach to geometries. Defaults to nothing.

source

',6))]),s[322]||(s[322]=i("h2",{id:"Barycentric-coordinates",tabindex:"-1"},[e("Barycentric coordinates "),i("a",{class:"header-anchor",href:"#Barycentric-coordinates","aria-label":'Permalink to "Barycentric coordinates {#Barycentric-coordinates}"'},"​")],-1)),i("details",x,[i("summary",null,[s[63]||(s[63]=i("a",{id:"GeometryOps.barycentric_coordinates",href:"#GeometryOps.barycentric_coordinates"},[i("span",{class:"jlbinding"},"GeometryOps.barycentric_coordinates")],-1)),s[64]||(s[64]=e()),n(t,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[65]||(s[65]=a('
julia
barycentric_coordinates(method = MeanValue(), polygon, point)

Returns the barycentric coordinates of point in polygon using the barycentric coordinate method method.

source

',3))]),i("details",w,[i("summary",null,[s[66]||(s[66]=i("a",{id:"GeometryOps.barycentric_coordinates!",href:"#GeometryOps.barycentric_coordinates!"},[i("span",{class:"jlbinding"},"GeometryOps.barycentric_coordinates!")],-1)),s[67]||(s[67]=e()),n(t,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[68]||(s[68]=a('
julia
barycentric_coordinates!(λs::Vector{<: Real}, method::AbstractBarycentricCoordinateMethod, polygon, point)

Loads the barycentric coordinates of point in polygon into λs using the barycentric coordinate method method.

λs must be of the length of the polygon plus its holes.

Tip

Use this method to avoid excess allocations when you need to calculate barycentric coordinates for many points.

source

',5))]),i("details",L,[i("summary",null,[s[69]||(s[69]=i("a",{id:"GeometryOps.barycentric_interpolate",href:"#GeometryOps.barycentric_interpolate"},[i("span",{class:"jlbinding"},"GeometryOps.barycentric_interpolate")],-1)),s[70]||(s[70]=e()),n(t,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[71]||(s[71]=a('
julia
barycentric_interpolate(method = MeanValue(), polygon, values::AbstractVector{V}, point)

Returns the interpolated value at point within polygon using the barycentric coordinate method method. values are the per-point values for the polygon which are to be interpolated.

Returns an object of type V.

Warning

Barycentric interpolation is currently defined only for 2-dimensional polygons. If you pass a 3-D polygon in, the Z coordinate will be used as per-vertex value to be interpolated (the M coordinate in GIS parlance).

source

',5))]),s[323]||(s[323]=i("h2",{id:"Other-methods",tabindex:"-1"},[e("Other methods "),i("a",{class:"header-anchor",href:"#Other-methods","aria-label":'Permalink to "Other methods {#Other-methods}"'},"​")],-1)),i("details",I,[i("summary",null,[s[72]||(s[72]=i("a",{id:"GeometryOps.AbstractBarycentricCoordinateMethod",href:"#GeometryOps.AbstractBarycentricCoordinateMethod"},[i("span",{class:"jlbinding"},"GeometryOps.AbstractBarycentricCoordinateMethod")],-1)),s[73]||(s[73]=e()),n(t,{type:"info",class:"jlObjectType jlType",text:"Type"})]),s[74]||(s[74]=a('
julia
abstract type AbstractBarycentricCoordinateMethod

Abstract supertype for barycentric coordinate methods. The subtypes may serve as dispatch types, or may cache some information about the target polygon.

API

The following methods must be implemented for all subtypes:

  • barycentric_coordinates!(λs::Vector{<: Real}, method::AbstractBarycentricCoordinateMethod, exterior::Vector{<: Point{2, T1}}, point::Point{2, T2})

  • barycentric_interpolate(method::AbstractBarycentricCoordinateMethod, exterior::Vector{<: Point{2, T1}}, values::Vector{V}, point::Point{2, T2})::V

  • barycentric_interpolate(method::AbstractBarycentricCoordinateMethod, exterior::Vector{<: Point{2, T1}}, interiors::Vector{<: Vector{<: Point{2, T1}}} values::Vector{V}, point::Point{2, T2})::V

The rest of the methods will be implemented in terms of these, and have efficient dispatches for broadcasting.

source

',7))]),i("details",M,[i("summary",null,[s[75]||(s[75]=i("a",{id:"GeometryOps.ClosedRing",href:"#GeometryOps.ClosedRing"},[i("span",{class:"jlbinding"},"GeometryOps.ClosedRing")],-1)),s[76]||(s[76]=e()),n(t,{type:"info",class:"jlObjectType jlType",text:"Type"})]),s[77]||(s[77]=a('
julia
ClosedRing() <: GeometryCorrection

This correction ensures that a polygon's exterior and interior rings are closed.

It can be called on any geometry correction as usual.

See also GeometryCorrection.

source

',5))]),i("details",P,[i("summary",null,[s[78]||(s[78]=i("a",{id:"GeometryOps.DiffIntersectingPolygons",href:"#GeometryOps.DiffIntersectingPolygons"},[i("span",{class:"jlbinding"},"GeometryOps.DiffIntersectingPolygons")],-1)),s[79]||(s[79]=e()),n(t,{type:"info",class:"jlObjectType jlType",text:"Type"})]),s[80]||(s[80]=a('
julia
DiffIntersectingPolygons() <: GeometryCorrection

This correction ensures that the polygons included in a multipolygon aren't intersecting. If any polygon's are intersecting, they will be made nonintersecting through the difference operation to create a unique set of disjoint (other than potentially connections by a single point) polygons covering the same area. See also GeometryCorrection, UnionIntersectingPolygons.

source

',3))]),i("details",q,[i("summary",null,[s[81]||(s[81]=i("a",{id:"GeometryOps.DouglasPeucker",href:"#GeometryOps.DouglasPeucker"},[i("span",{class:"jlbinding"},"GeometryOps.DouglasPeucker")],-1)),s[82]||(s[82]=e()),n(t,{type:"info",class:"jlObjectType jlType",text:"Type"})]),s[83]||(s[83]=a(`
julia
DouglasPeucker <: SimplifyAlg
+
+DouglasPeucker(; number, ratio, tol)

Simplifies geometries by removing points below tol distance from the line between its neighboring points.

Keywords

  • ratio: the fraction of points that should remain after simplify. Useful as it will generalise for large collections of objects.

  • number: the number of points that should remain after simplify. Less useful for large collections of mixed size objects.

  • tol: the minimum distance a point will be from the line joining its neighboring points.

Note: user input tol is squared to avoid unnecessary computation in algorithm.

source

`,6))]),i("details",R,[i("summary",null,[s[84]||(s[84]=i("a",{id:"GeometryOps.GEOS",href:"#GeometryOps.GEOS"},[i("span",{class:"jlbinding"},"GeometryOps.GEOS")],-1)),s[85]||(s[85]=e()),n(t,{type:"info",class:"jlObjectType jlType",text:"Type"})]),s[86]||(s[86]=a('
julia
GEOS(; params...)

A struct which instructs the method it's passed to as an algorithm to use the appropriate GEOS function via LibGEOS.jl for the operation.

Dispatch is generally carried out using the names of the keyword arguments. For example, segmentize will only accept a GEOS struct with only a max_distance keyword, and no other.

It's generally a lot slower than the native Julia implementations, since it must convert to the LibGEOS implementation and back - so be warned!

source

',5))]),i("details",S,[i("summary",null,[s[87]||(s[87]=i("a",{id:"GeometryOps.GeodesicSegments",href:"#GeometryOps.GeodesicSegments"},[i("span",{class:"jlbinding"},"GeometryOps.GeodesicSegments")],-1)),s[88]||(s[88]=e()),n(t,{type:"info",class:"jlObjectType jlType",text:"Type"})]),s[89]||(s[89]=a('
julia
GeodesicSegments(; max_distance::Real, equatorial_radius::Real=6378137, flattening::Real=1/298.257223563)

A method for segmentizing geometries by adding extra vertices to the geometry so that no segment is longer than a given distance. This method calculates the distance between points on the geodesic, and assumes input in lat/long coordinates.

Warning

Any input geometries must be in lon/lat coordinates! If not, the method may fail or error.

Arguments

  • max_distance::Real: The maximum distance, in meters, between vertices in the geometry.

  • equatorial_radius::Real=6378137: The equatorial radius of the Earth, in meters. Passed to Proj.geod_geodesic.

  • flattening::Real=1/298.257223563: The flattening of the Earth, which is the ratio of the difference between the equatorial and polar radii to the equatorial radius. Passed to Proj.geod_geodesic.

One can also omit the equatorial_radius and flattening keyword arguments, and pass a geodesic object directly to the eponymous keyword.

This method uses the Proj/GeographicLib API for geodesic calculations.

source

',8))]),i("details",V,[i("summary",null,[s[90]||(s[90]=i("a",{id:"GeometryOps.GeometryCorrection",href:"#GeometryOps.GeometryCorrection"},[i("span",{class:"jlbinding"},"GeometryOps.GeometryCorrection")],-1)),s[91]||(s[91]=e()),n(t,{type:"info",class:"jlObjectType jlType",text:"Type"})]),s[92]||(s[92]=a('
julia
abstract type GeometryCorrection

This abstract type represents a geometry correction.

Interface

Any GeometryCorrection must implement two functions: * application_level(::GeometryCorrection)::AbstractGeometryTrait: This function should return the GeoInterface trait that the correction is intended to be applied to, like PointTrait or LineStringTrait or PolygonTrait. * (::GeometryCorrection)(::AbstractGeometryTrait, geometry)::(some_geometry): This function should apply the correction to the given geometry, and return a new geometry.

source

',5))]),i("details",J,[i("summary",null,[s[93]||(s[93]=i("a",{id:"GeometryOps.LineOrientation",href:"#GeometryOps.LineOrientation"},[i("span",{class:"jlbinding"},"GeometryOps.LineOrientation")],-1)),s[94]||(s[94]=e()),n(t,{type:"info",class:"jlObjectType jlType",text:"Type"})]),s[95]||(s[95]=a('
julia
Enum LineOrientation

Enum for the orientation of a line with respect to a curve. A line can be line_cross (crossing over the curve), line_hinge (crossing the endpoint of the curve), line_over (collinear with the curve), or line_out (not interacting with the curve).

source

',3))]),i("details",U,[i("summary",null,[s[96]||(s[96]=i("a",{id:"GeometryOps.LinearSegments",href:"#GeometryOps.LinearSegments"},[i("span",{class:"jlbinding"},"GeometryOps.LinearSegments")],-1)),s[97]||(s[97]=e()),n(t,{type:"info",class:"jlObjectType jlType",text:"Type"})]),s[98]||(s[98]=a('
julia
LinearSegments(; max_distance::Real)

A method for segmentizing geometries by adding extra vertices to the geometry so that no segment is longer than a given distance.

Here, max_distance is a purely nondimensional quantity and will apply in the input space. This is to say, that if the polygon is provided in lat/lon coordinates then the max_distance will be in degrees of arc. If the polygon is provided in meters, then the max_distance will be in meters.

source

',4))]),i("details",H,[i("summary",null,[s[99]||(s[99]=i("a",{id:"GeometryOps.MeanValue",href:"#GeometryOps.MeanValue"},[i("span",{class:"jlbinding"},"GeometryOps.MeanValue")],-1)),s[100]||(s[100]=e()),n(t,{type:"info",class:"jlObjectType jlType",text:"Type"})]),s[101]||(s[101]=a('
julia
MeanValue() <: AbstractBarycentricCoordinateMethod

This method calculates barycentric coordinates using the mean value method.

References

source

',4))]),i("details",N,[i("summary",null,[s[102]||(s[102]=i("a",{id:"GeometryOps.MonotoneChainMethod",href:"#GeometryOps.MonotoneChainMethod"},[i("span",{class:"jlbinding"},"GeometryOps.MonotoneChainMethod")],-1)),s[103]||(s[103]=e()),n(t,{type:"info",class:"jlObjectType jlType",text:"Type"})]),s[104]||(s[104]=a('
julia
MonotoneChainMethod()

This is an algorithm for the convex_hull function.

Uses DelaunayTriangulation.jl to compute the convex hull. This is a pure Julia algorithm which provides an optimal Delaunay triangulation.

See also convex_hull

source

',5))]),i("details",W,[i("summary",null,[s[105]||(s[105]=i("a",{id:"GeometryOps.PointOrientation",href:"#GeometryOps.PointOrientation"},[i("span",{class:"jlbinding"},"GeometryOps.PointOrientation")],-1)),s[106]||(s[106]=e()),n(t,{type:"info",class:"jlObjectType jlType",text:"Type"})]),s[107]||(s[107]=a('
julia
Enum PointOrientation

Enum for the orientation of a point with respect to a curve. A point can be point_in the curve, point_on the curve, or point_out of the curve.

source

',3))]),i("details",z,[i("summary",null,[s[108]||(s[108]=i("a",{id:"GeometryOps.RadialDistance",href:"#GeometryOps.RadialDistance"},[i("span",{class:"jlbinding"},"GeometryOps.RadialDistance")],-1)),s[109]||(s[109]=e()),n(t,{type:"info",class:"jlObjectType jlType",text:"Type"})]),s[110]||(s[110]=a('
julia
RadialDistance <: SimplifyAlg

Simplifies geometries by removing points less than tol distance from the line between its neighboring points.

Keywords

  • ratio: the fraction of points that should remain after simplify. Useful as it will generalise for large collections of objects.

  • number: the number of points that should remain after simplify. Less useful for large collections of mixed size objects.

  • tol: the minimum distance between points.

Note: user input tol is squared to avoid unnecessary computation in algorithm.

source

',6))]),i("details",Z,[i("summary",null,[s[111]||(s[111]=i("a",{id:"GeometryOps.SimplifyAlg",href:"#GeometryOps.SimplifyAlg"},[i("span",{class:"jlbinding"},"GeometryOps.SimplifyAlg")],-1)),s[112]||(s[112]=e()),n(t,{type:"info",class:"jlObjectType jlType",text:"Type"})]),s[113]||(s[113]=a('
julia
abstract type SimplifyAlg

Abstract type for simplification algorithms.

API

For now, the algorithm must hold the number, ratio and tol properties.

Simplification algorithm types can hook into the interface by implementing the _simplify(trait, alg, geom) methods for whichever traits are necessary.

source

',6))]),i("details",_,[i("summary",null,[s[114]||(s[114]=i("a",{id:"GeometryOps.UnionIntersectingPolygons",href:"#GeometryOps.UnionIntersectingPolygons"},[i("span",{class:"jlbinding"},"GeometryOps.UnionIntersectingPolygons")],-1)),s[115]||(s[115]=e()),n(t,{type:"info",class:"jlObjectType jlType",text:"Type"})]),s[116]||(s[116]=a('
julia
UnionIntersectingPolygons() <: GeometryCorrection

This correction ensures that the polygon's included in a multipolygon aren't intersecting. If any polygon's are intersecting, they will be combined through the union operation to create a unique set of disjoint (other than potentially connections by a single point) polygons covering the same area.

See also GeometryCorrection.

source

',4))]),i("details",K,[i("summary",null,[s[117]||(s[117]=i("a",{id:"GeometryOps.VisvalingamWhyatt",href:"#GeometryOps.VisvalingamWhyatt"},[i("span",{class:"jlbinding"},"GeometryOps.VisvalingamWhyatt")],-1)),s[118]||(s[118]=e()),n(t,{type:"info",class:"jlObjectType jlType",text:"Type"})]),s[119]||(s[119]=a(`
julia
VisvalingamWhyatt <: SimplifyAlg
+
+VisvalingamWhyatt(; kw...)

Simplifies geometries by removing points below tol distance from the line between its neighboring points.

Keywords

  • ratio: the fraction of points that should remain after simplify. Useful as it will generalise for large collections of objects.

  • number: the number of points that should remain after simplify. Less useful for large collections of mixed size objects.

  • tol: the minimum area of a triangle made with a point and its neighboring points.

Note: user input tol is doubled to avoid unnecessary computation in algorithm.

source

`,6))]),i("details",X,[i("summary",null,[s[120]||(s[120]=i("a",{id:"GeometryOps._det-Union{Tuple{T2}, Tuple{T1}, Tuple{Union{Tuple{T1, T1}, StaticArraysCore.StaticArray{Tuple{2}, T1, 1}}, Union{Tuple{T2, T2}, StaticArraysCore.StaticArray{Tuple{2}, T2, 1}}}} where {T1<:Real, T2<:Real}",href:"#GeometryOps._det-Union{Tuple{T2}, Tuple{T1}, Tuple{Union{Tuple{T1, T1}, StaticArraysCore.StaticArray{Tuple{2}, T1, 1}}, Union{Tuple{T2, T2}, StaticArraysCore.StaticArray{Tuple{2}, T2, 1}}}} where {T1<:Real, T2<:Real}"},[i("span",{class:"jlbinding"},"GeometryOps._det")],-1)),s[121]||(s[121]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[122]||(s[122]=a('
julia
_det(s1::Point2{T1}, s2::Point2{T2}) where {T1 <: Real, T2 <: Real}

Returns the determinant of the matrix formed by hcat'ing two points s1 and s2.

Specifically, this is:

julia
s1[1] * s2[2] - s1[2] * s2[1]

source

',5))]),i("details",$,[i("summary",null,[s[123]||(s[123]=i("a",{id:"GeometryOps._equals_curves-NTuple{4, Any}",href:"#GeometryOps._equals_curves-NTuple{4, Any}"},[i("span",{class:"jlbinding"},"GeometryOps._equals_curves")],-1)),s[124]||(s[124]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[125]||(s[125]=a('
julia
_equals_curves(c1, c2, closed_type1, closed_type2)::Bool

Two curves are equal if they share the same set of point, representing the same geometry. Both curves must must be composed of the same set of points, however, they do not have to wind in the same direction, or start on the same point to be equivalent. Inputs: c1 first geometry c2 second geometry closed_type1::Bool true if c1 is closed by definition (polygon, linear ring) closed_type2::Bool true if c2 is closed by definition (polygon, linear ring)

source

',3))]),i("details",Y,[i("summary",null,[s[126]||(s[126]=i("a",{id:"GeometryOps.angles-Union{Tuple{Any}, Tuple{T}, Tuple{Any, Type{T}}} where T<:AbstractFloat",href:"#GeometryOps.angles-Union{Tuple{Any}, Tuple{T}, Tuple{Any, Type{T}}} where T<:AbstractFloat"},[i("span",{class:"jlbinding"},"GeometryOps.angles")],-1)),s[127]||(s[127]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[128]||(s[128]=a(`
julia
angles(geom, ::Type{T} = Float64)

Returns the angles of a geometry or collection of geometries. This is computed differently for different geometries:

- The angles of a point is an empty vector.
+- The angles of a single line segment is an empty vector.
+- The angles of a linestring or linearring is a vector of angles formed by the curve.
+- The angles of a polygon is a vector of vectors of angles formed by each ring.
+- The angles of a multi-geometry collection is a vector of the angles of each of the
+    sub-geometries as defined above.

Result will be a Vector, or nested set of vectors, of type T where an optional argument with a default value of Float64.

source

`,5))]),i("details",ss,[i("summary",null,[s[129]||(s[129]=i("a",{id:"GeometryOps.area-Union{Tuple{Any}, Tuple{T}, Tuple{Any, Type{T}}} where T<:AbstractFloat",href:"#GeometryOps.area-Union{Tuple{Any}, Tuple{T}, Tuple{Any, Type{T}}} where T<:AbstractFloat"},[i("span",{class:"jlbinding"},"GeometryOps.area")],-1)),s[130]||(s[130]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[131]||(s[131]=a(`
julia
area(geom, [T = Float64])::T

Returns the area of a geometry or collection of geometries. This is computed slightly differently for different geometries:

- The area of a point/multipoint is always zero.
+- The area of a curve/multicurve is always zero.
+- The area of a polygon is the absolute value of the signed area.
+- The area multi-polygon is the sum of the areas of all of the sub-polygons.
+- The area of a geometry collection, feature collection of array/iterable 
+    is the sum of the areas of all of the sub-geometries.

Result will be of type T, where T is an optional argument with a default value of Float64.

source

`,5))]),i("details",is,[i("summary",null,[s[132]||(s[132]=i("a",{id:"GeometryOps.barycentric_coordinates!-Tuple{Vector{<:Real}, GeometryOps.AbstractBarycentricCoordinateMethod, Any, Any}",href:"#GeometryOps.barycentric_coordinates!-Tuple{Vector{<:Real}, GeometryOps.AbstractBarycentricCoordinateMethod, Any, Any}"},[i("span",{class:"jlbinding"},"GeometryOps.barycentric_coordinates!")],-1)),s[133]||(s[133]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[134]||(s[134]=a('
julia
barycentric_coordinates!(λs::Vector{<: Real}, method::AbstractBarycentricCoordinateMethod, polygon, point)

Loads the barycentric coordinates of point in polygon into λs using the barycentric coordinate method method.

λs must be of the length of the polygon plus its holes.

Tip

Use this method to avoid excess allocations when you need to calculate barycentric coordinates for many points.

source

',5))]),i("details",as,[i("summary",null,[s[135]||(s[135]=i("a",{id:"GeometryOps.barycentric_coordinates-Tuple{GeometryOps.AbstractBarycentricCoordinateMethod, Any, Any}",href:"#GeometryOps.barycentric_coordinates-Tuple{GeometryOps.AbstractBarycentricCoordinateMethod, Any, Any}"},[i("span",{class:"jlbinding"},"GeometryOps.barycentric_coordinates")],-1)),s[136]||(s[136]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[137]||(s[137]=a('
julia
barycentric_coordinates(method = MeanValue(), polygon, point)

Returns the barycentric coordinates of point in polygon using the barycentric coordinate method method.

source

',3))]),i("details",es,[i("summary",null,[s[138]||(s[138]=i("a",{id:"GeometryOps.barycentric_interpolate-Union{Tuple{V}, Tuple{GeometryOps.AbstractBarycentricCoordinateMethod, Any, AbstractVector{V}, Any}} where V",href:"#GeometryOps.barycentric_interpolate-Union{Tuple{V}, Tuple{GeometryOps.AbstractBarycentricCoordinateMethod, Any, AbstractVector{V}, Any}} where V"},[i("span",{class:"jlbinding"},"GeometryOps.barycentric_interpolate")],-1)),s[139]||(s[139]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[140]||(s[140]=a('
julia
barycentric_interpolate(method = MeanValue(), polygon, values::AbstractVector{V}, point)

Returns the interpolated value at point within polygon using the barycentric coordinate method method. values are the per-point values for the polygon which are to be interpolated.

Returns an object of type V.

Warning

Barycentric interpolation is currently defined only for 2-dimensional polygons. If you pass a 3-D polygon in, the Z coordinate will be used as per-vertex value to be interpolated (the M coordinate in GIS parlance).

source

',5))]),i("details",ts,[i("summary",null,[s[141]||(s[141]=i("a",{id:"GeometryOps.centroid-Union{Tuple{Any}, Tuple{T}, Tuple{Any, Type{T}}} where T",href:"#GeometryOps.centroid-Union{Tuple{Any}, Tuple{T}, Tuple{Any, Type{T}}} where T"},[i("span",{class:"jlbinding"},"GeometryOps.centroid")],-1)),s[142]||(s[142]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[143]||(s[143]=a('
julia
centroid(geom, [T=Float64])::Tuple{T, T}

Returns the centroid of a given line segment, linear ring, polygon, or mutlipolygon.

source

',3))]),i("details",ns,[i("summary",null,[s[144]||(s[144]=i("a",{id:"GeometryOps.centroid_and_area-Union{Tuple{Any}, Tuple{T}, Tuple{Any, Type{T}}} where T",href:"#GeometryOps.centroid_and_area-Union{Tuple{Any}, Tuple{T}, Tuple{Any, Type{T}}} where T"},[i("span",{class:"jlbinding"},"GeometryOps.centroid_and_area")],-1)),s[145]||(s[145]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[146]||(s[146]=a('
julia
centroid_and_area(geom, [T=Float64])::(::Tuple{T, T}, ::Real)

Returns the centroid and area of a given geometry.

source

',3))]),i("details",ls,[i("summary",null,[s[147]||(s[147]=i("a",{id:"GeometryOps.centroid_and_length-Union{Tuple{Any}, Tuple{T}, Tuple{Any, Type{T}}} where T",href:"#GeometryOps.centroid_and_length-Union{Tuple{Any}, Tuple{T}, Tuple{Any, Type{T}}} where T"},[i("span",{class:"jlbinding"},"GeometryOps.centroid_and_length")],-1)),s[148]||(s[148]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[149]||(s[149]=a('
julia
centroid_and_length(geom, [T=Float64])::(::Tuple{T, T}, ::Real)

Returns the centroid and length of a given line/ring. Note this is only valid for line strings and linear rings.

source

',3))]),i("details",ps,[i("summary",null,[s[150]||(s[150]=i("a",{id:"GeometryOps.contains-Tuple{Any, Any}",href:"#GeometryOps.contains-Tuple{Any, Any}"},[i("span",{class:"jlbinding"},"GeometryOps.contains")],-1)),s[151]||(s[151]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[152]||(s[152]=a(`
julia
contains(g1::AbstractGeometry, g2::AbstractGeometry)::Bool

Return true if the second geometry is completely contained by the first geometry. The interiors of both geometries must intersect and the interior and boundary of the secondary (g2) must not intersect the exterior of the first (g1).

contains returns the exact opposite result of within.

Examples

julia
import GeometryOps as GO, GeoInterface as GI
+line = GI.LineString([(1, 1), (1, 2), (1, 3), (1, 4)])
+point = GI.Point((1, 2))
+
+GO.contains(line, point)
+# output
+true

source

`,6))]),i("details",hs,[i("summary",null,[s[153]||(s[153]=i("a",{id:"GeometryOps.convex_hull",href:"#GeometryOps.convex_hull"},[i("span",{class:"jlbinding"},"GeometryOps.convex_hull")],-1)),s[154]||(s[154]=e()),n(t,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[155]||(s[155]=a('
julia
convex_hull([method], geometries)

Compute the convex hull of the points in geometries. Returns a GI.Polygon representing the convex hull.

Note that the polygon returned is wound counterclockwise as in the Simple Features standard by default. If you choose GEOS, the winding order will be inverted.

Warning

This interface only computes the 2-dimensional convex hull!

For higher dimensional hulls, use the relevant package (Qhull.jl, Quickhull.jl, or similar).

source

',5))]),i("details",ks,[i("summary",null,[s[156]||(s[156]=i("a",{id:"GeometryOps.coverage-Union{Tuple{T}, NTuple{5, Any}, Tuple{Any, Any, Any, Any, Any, Type{T}}} where T<:AbstractFloat",href:"#GeometryOps.coverage-Union{Tuple{T}, NTuple{5, Any}, Tuple{Any, Any, Any, Any, Any, Type{T}}} where T<:AbstractFloat"},[i("span",{class:"jlbinding"},"GeometryOps.coverage")],-1)),s[157]||(s[157]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[158]||(s[158]=a('
julia
coverage(geom, xmin, xmax, ymin, ymax, [T = Float64])::T

Returns the area of intersection between given geometry and grid cell defined by its minimum and maximum x and y-values. This is computed differently for different geometries:

  • The signed area of a point is always zero.

  • The signed area of a curve is always zero.

  • The signed area of a polygon is calculated by tracing along its edges and switching to the cell edges if needed.

  • The coverage of a geometry collection, multi-geometry, feature collection of array/iterable is the sum of the coverages of all of the sub-geometries.

Result will be of type T, where T is an optional argument with a default value of Float64.

source

',5))]),i("details",rs,[i("summary",null,[s[159]||(s[159]=i("a",{id:"GeometryOps.coveredby-Tuple{Any, Any}",href:"#GeometryOps.coveredby-Tuple{Any, Any}"},[i("span",{class:"jlbinding"},"GeometryOps.coveredby")],-1)),s[160]||(s[160]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[161]||(s[161]=a(`
julia
coveredby(g1, g2)::Bool

Return true if the first geometry is completely covered by the second geometry. The interior and boundary of the primary geometry (g1) must not intersect the exterior of the secondary geometry (g2).

Furthermore, coveredby returns the exact opposite result of covers. They are equivalent with the order of the arguments swapped.

Examples

julia
import GeometryOps as GO, GeoInterface as GI
+p1 = GI.Point(0.0, 0.0)
+p2 = GI.Point(1.0, 1.0)
+l1 = GI.Line([p1, p2])
+
+GO.coveredby(p1, l1)
+# output
+true

source

`,6))]),i("details",os,[i("summary",null,[s[162]||(s[162]=i("a",{id:"GeometryOps.covers-Tuple{Any, Any}",href:"#GeometryOps.covers-Tuple{Any, Any}"},[i("span",{class:"jlbinding"},"GeometryOps.covers")],-1)),s[163]||(s[163]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[164]||(s[164]=a(`
julia
covers(g1::AbstractGeometry, g2::AbstractGeometry)::Bool

Return true if the first geometry is completely covers the second geometry, The exterior and boundary of the second geometry must not be outside of the interior and boundary of the first geometry. However, the interiors need not intersect.

covers returns the exact opposite result of coveredby.

Examples

julia
import GeometryOps as GO, GeoInterface as GI
+l1 = GI.LineString([(1.0, 1.0), (1.0, 2.0), (1.0, 3.0), (1.0, 4.0)])
+l2 = GI.LineString([(1.0, 1.0), (1.0, 2.0)])
+
+GO.covers(l1, l2)
+# output
+true

source

`,6))]),i("details",ds,[i("summary",null,[s[165]||(s[165]=i("a",{id:"GeometryOps.crosses-Tuple{Any, Any}",href:"#GeometryOps.crosses-Tuple{Any, Any}"},[i("span",{class:"jlbinding"},"GeometryOps.crosses")],-1)),s[166]||(s[166]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[167]||(s[167]=a(`
julia
 crosses(geom1, geom2)::Bool

Return true if the intersection results in a geometry whose dimension is one less than the maximum dimension of the two source geometries and the intersection set is interior to both source geometries.

TODO: broken

Examples

julia
import GeoInterface as GI, GeometryOps as GO
+# TODO: Add working example

source

`,6))]),i("details",gs,[i("summary",null,[s[168]||(s[168]=i("a",{id:"GeometryOps.cut-Union{Tuple{T}, Tuple{Any, Any}, Tuple{Any, Any, Type{T}}} where T<:AbstractFloat",href:"#GeometryOps.cut-Union{Tuple{T}, Tuple{Any, Any}, Tuple{Any, Any, Type{T}}} where T<:AbstractFloat"},[i("span",{class:"jlbinding"},"GeometryOps.cut")],-1)),s[169]||(s[169]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[170]||(s[170]=a(`
julia
cut(geom, line, [T::Type])

Return given geom cut by given line as a list of geometries of the same type as the input geom. Return the original geometry as only list element if none are found. Line must cut fully through given geometry or the original geometry will be returned.

Note: This currently doesn't work for degenerate cases there line crosses through vertices.

Example

julia
import GeoInterface as GI, GeometryOps as GO
+
+poly = GI.Polygon([[(0.0, 0.0), (10.0, 0.0), (10.0, 10.0), (0.0, 10.0), (0.0, 0.0)]])
+line = GI.Line([(5.0, -5.0), (5.0, 15.0)])
+cut_polys = GO.cut(poly, line)
+GI.coordinates.(cut_polys)
+
+# output
+2-element Vector{Vector{Vector{Vector{Float64}}}}:
+ [[[0.0, 0.0], [5.0, 0.0], [5.0, 10.0], [0.0, 10.0], [0.0, 0.0]]]
+ [[[5.0, 0.0], [10.0, 0.0], [10.0, 10.0], [5.0, 10.0], [5.0, 0.0]]]

source

`,6))]),i("details",ys,[i("summary",null,[s[171]||(s[171]=i("a",{id:"GeometryOps.difference-Union{Tuple{T}, Tuple{Any, Any}, Tuple{Any, Any, Type{T}}} where T<:AbstractFloat",href:"#GeometryOps.difference-Union{Tuple{T}, Tuple{Any, Any}, Tuple{Any, Any, Type{T}}} where T<:AbstractFloat"},[i("span",{class:"jlbinding"},"GeometryOps.difference")],-1)),s[172]||(s[172]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[173]||(s[173]=a(`
julia
difference(geom_a, geom_b, [T::Type]; target::Type, fix_multipoly = UnionIntersectingPolygons())

Return the difference between two geometries as a list of geometries. Return an empty list if none are found. The type of the list will be constrained as much as possible given the input geometries. Furthermore, the user can provide a taget type as a keyword argument and a list of target geometries found in the difference will be returned. The user can also provide a float type that they would like the points of returned geometries to be. If the user is taking a intersection involving one or more multipolygons, and the multipolygon might be comprised of polygons that intersect, if fix_multipoly is set to an IntersectingPolygons correction (the default is UnionIntersectingPolygons()), then the needed multipolygons will be fixed to be valid before performing the intersection to ensure a correct answer. Only set fix_multipoly to false if you know that the multipolygons are valid, as it will avoid unneeded computation.

Example

julia
import GeoInterface as GI, GeometryOps as GO
+
+poly1 = GI.Polygon([[[0.0, 0.0], [5.0, 5.0], [10.0, 0.0], [5.0, -5.0], [0.0, 0.0]]])
+poly2 = GI.Polygon([[[3.0, 0.0], [8.0, 5.0], [13.0, 0.0], [8.0, -5.0], [3.0, 0.0]]])
+diff_poly = GO.difference(poly1, poly2; target = GI.PolygonTrait())
+GI.coordinates.(diff_poly)
+
+# output
+1-element Vector{Vector{Vector{Vector{Float64}}}}:
+ [[[6.5, 3.5], [5.0, 5.0], [0.0, 0.0], [5.0, -5.0], [6.5, -3.5], [3.0, 0.0], [6.5, 3.5]]]

source

`,5))]),i("details",Es,[i("summary",null,[s[174]||(s[174]=i("a",{id:"GeometryOps.disjoint-Tuple{Any, Any}",href:"#GeometryOps.disjoint-Tuple{Any, Any}"},[i("span",{class:"jlbinding"},"GeometryOps.disjoint")],-1)),s[175]||(s[175]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[176]||(s[176]=a(`
julia
disjoint(geom1, geom2)::Bool

Return true if the first geometry is disjoint from the second geometry.

Return true if the first geometry is disjoint from the second geometry. The interiors and boundaries of both geometries must not intersect.

Examples

julia
import GeometryOps as GO, GeoInterface as GI
+
+line = GI.LineString([(1, 1), (1, 2), (1, 3), (1, 4)])
+point = (2, 2)
+GO.disjoint(point, line)
+
+# output
+true

source

`,6))]),i("details",cs,[i("summary",null,[s[177]||(s[177]=i("a",{id:"GeometryOps.distance-Union{Tuple{T}, Tuple{Any, Any}, Tuple{Any, Any, Type{T}}} where T<:AbstractFloat",href:"#GeometryOps.distance-Union{Tuple{T}, Tuple{Any, Any}, Tuple{Any, Any, Type{T}}} where T<:AbstractFloat"},[i("span",{class:"jlbinding"},"GeometryOps.distance")],-1)),s[178]||(s[178]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[179]||(s[179]=a('
julia
distance(point, geom, ::Type{T} = Float64)::T

Calculates the ditance from the geometry g1 to the point. The distance will always be positive or zero.

The method will differ based on the type of the geometry provided: - The distance from a point to a point is just the Euclidean distance between the points. - The distance from a point to a line is the minimum distance from the point to the closest point on the given line. - The distance from a point to a linestring is the minimum distance from the point to the closest segment of the linestring. - The distance from a point to a linear ring is the minimum distance from the point to the closest segment of the linear ring. - The distance from a point to a polygon is zero if the point is within the polygon and otherwise is the minimum distance from the point to an edge of the polygon. This includes edges created by holes. - The distance from a point to a multigeometry or a geometry collection is the minimum distance between the point and any of the sub-geometries.

Result will be of type T, where T is an optional argument with a default value of Float64.

source

',5))]),i("details",us,[i("summary",null,[s[180]||(s[180]=i("a",{id:"GeometryOps.embed_extent-Tuple{Any}",href:"#GeometryOps.embed_extent-Tuple{Any}"},[i("span",{class:"jlbinding"},"GeometryOps.embed_extent")],-1)),s[181]||(s[181]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[182]||(s[182]=a('
julia
embed_extent(obj)

Recursively wrap the object with a GeoInterface.jl geometry, calculating and adding an Extents.Extent to all objects.

This can improve performance when extents need to be checked multiple times, such when needing to check if many points are in geometries, and using their extents as a quick filter for obviously exterior points.

Keywords

  • threaded: true or false. Whether to use multithreading. Defaults to false.

  • crs: The CRS to attach to geometries. Defaults to nothing.

source

',6))]),i("details",ms,[i("summary",null,[s[183]||(s[183]=i("a",{id:"GeometryOps.enforce-Tuple{GEOS, Symbol, Any}",href:"#GeometryOps.enforce-Tuple{GEOS, Symbol, Any}"},[i("span",{class:"jlbinding"},"GeometryOps.enforce")],-1)),s[184]||(s[184]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[185]||(s[185]=a('
julia
enforce(alg::GO.GEOS, kw::Symbol, f)

Enforce the presence of a keyword argument in a GEOS algorithm, and return alg.params[kw].

Throws an error if the key is not present, and mentions f in the error message (since there isn't a good way to get the name of the function that called this method).

source

',4))]),i("details",Fs,[i("summary",null,[s[186]||(s[186]=i("a",{id:"GeometryOps.equals-NTuple{4, Any}",href:"#GeometryOps.equals-NTuple{4, Any}"},[i("span",{class:"jlbinding"},"GeometryOps.equals")],-1)),s[187]||(s[187]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[188]||(s[188]=a('
julia
equals(trait_a, geom_a, trait_b, geom_b)

Two geometries which are not of the same type cannot be equal so they always return false.

source

',3))]),i("details",Cs,[i("summary",null,[s[189]||(s[189]=i("a",{id:"GeometryOps.equals-Tuple{Any, Any}",href:"#GeometryOps.equals-Tuple{Any, Any}"},[i("span",{class:"jlbinding"},"GeometryOps.equals")],-1)),s[190]||(s[190]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[191]||(s[191]=a(`
julia
equals(geom1, geom2)::Bool

Compare two Geometries return true if they are the same geometry.

Examples

julia
import GeometryOps as GO, GeoInterface as GI
+poly1 = GI.Polygon([[(0,0), (0,5), (5,5), (5,0), (0,0)]])
+poly2 = GI.Polygon([[(0,0), (0,5), (5,5), (5,0), (0,0)]])
+
+GO.equals(poly1, poly2)
+# output
+true

source

`,5))]),i("details",bs,[i("summary",null,[s[192]||(s[192]=i("a",{id:"GeometryOps.equals-Tuple{GeoInterface.LinearRingTrait, Any, GeoInterface.LinearRingTrait, Any}",href:"#GeometryOps.equals-Tuple{GeoInterface.LinearRingTrait, Any, GeoInterface.LinearRingTrait, Any}"},[i("span",{class:"jlbinding"},"GeometryOps.equals")],-1)),s[193]||(s[193]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[194]||(s[194]=a(`
julia
equals(
+    ::GI.LinearRingTrait, l1,
+    ::GI.LinearRingTrait, l2,
+)::Bool

Two linear rings are equal if they share the same set of points going along the curve. Note that rings are closed by definition, so they can have, but don't need, a repeated last point to be equal.

source

`,3))]),i("details",fs,[i("summary",null,[s[195]||(s[195]=i("a",{id:"GeometryOps.equals-Tuple{GeoInterface.LinearRingTrait, Any, Union{GeoInterface.LineStringTrait, GeoInterface.LineTrait}, Any}",href:"#GeometryOps.equals-Tuple{GeoInterface.LinearRingTrait, Any, Union{GeoInterface.LineStringTrait, GeoInterface.LineTrait}, Any}"},[i("span",{class:"jlbinding"},"GeometryOps.equals")],-1)),s[196]||(s[196]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[197]||(s[197]=a(`
julia
equals(
+    ::GI.LinearRingTrait, l1,
+    ::Union{GI.LineTrait, GI.LineStringTrait}, l2,
+)::Bool

A linear ring and a line/linestring are equal if they share the same set of points going along the curve. Note that lines aren't closed by definition, but rings are, so the line must have a repeated last point to be equal

source

`,3))]),i("details",Ts,[i("summary",null,[s[198]||(s[198]=i("a",{id:"GeometryOps.equals-Tuple{GeoInterface.MultiPointTrait, Any, GeoInterface.MultiPointTrait, Any}",href:"#GeometryOps.equals-Tuple{GeoInterface.MultiPointTrait, Any, GeoInterface.MultiPointTrait, Any}"},[i("span",{class:"jlbinding"},"GeometryOps.equals")],-1)),s[199]||(s[199]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[200]||(s[200]=a('
julia
equals(::GI.MultiPointTrait, mp1, ::GI.MultiPointTrait, mp2)::Bool

Two multipoints are equal if they share the same set of points.

source

',3))]),i("details",Gs,[i("summary",null,[s[201]||(s[201]=i("a",{id:"GeometryOps.equals-Tuple{GeoInterface.MultiPointTrait, Any, GeoInterface.PointTrait, Any}",href:"#GeometryOps.equals-Tuple{GeoInterface.MultiPointTrait, Any, GeoInterface.PointTrait, Any}"},[i("span",{class:"jlbinding"},"GeometryOps.equals")],-1)),s[202]||(s[202]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[203]||(s[203]=a('
julia
equals(::GI.MultiPointTrait, mp1, ::GI.PointTrait, p2)::Bool

A point and a multipoint are equal if the multipoint is composed of a single point that is equivalent to the given point.

source

',3))]),i("details",vs,[i("summary",null,[s[204]||(s[204]=i("a",{id:"GeometryOps.equals-Tuple{GeoInterface.MultiPolygonTrait, Any, GeoInterface.MultiPolygonTrait, Any}",href:"#GeometryOps.equals-Tuple{GeoInterface.MultiPolygonTrait, Any, GeoInterface.MultiPolygonTrait, Any}"},[i("span",{class:"jlbinding"},"GeometryOps.equals")],-1)),s[205]||(s[205]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[206]||(s[206]=a('
julia
equals(::GI.PolygonTrait, geom_a, ::GI.PolygonTrait, geom_b)::Bool

Two multipolygons are equal if they share the same set of polygons.

source

',3))]),i("details",As,[i("summary",null,[s[207]||(s[207]=i("a",{id:"GeometryOps.equals-Tuple{GeoInterface.MultiPolygonTrait, Any, GeoInterface.PolygonTrait, Any}",href:"#GeometryOps.equals-Tuple{GeoInterface.MultiPolygonTrait, Any, GeoInterface.PolygonTrait, Any}"},[i("span",{class:"jlbinding"},"GeometryOps.equals")],-1)),s[208]||(s[208]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[209]||(s[209]=a('
julia
equals(::GI.MultiPolygonTrait, geom_a, ::GI.PolygonTrait, geom_b)::Bool

A polygon and a multipolygon are equal if the multipolygon is composed of a single polygon that is equivalent to the given polygon.

source

',3))]),i("details",js,[i("summary",null,[s[210]||(s[210]=i("a",{id:"GeometryOps.equals-Tuple{GeoInterface.PointTrait, Any, GeoInterface.MultiPointTrait, Any}",href:"#GeometryOps.equals-Tuple{GeoInterface.PointTrait, Any, GeoInterface.MultiPointTrait, Any}"},[i("span",{class:"jlbinding"},"GeometryOps.equals")],-1)),s[211]||(s[211]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[212]||(s[212]=a('
julia
equals(::GI.PointTrait, p1, ::GI.MultiPointTrait, mp2)::Bool

A point and a multipoint are equal if the multipoint is composed of a single point that is equivalent to the given point.

source

',3))]),i("details",Bs,[i("summary",null,[s[213]||(s[213]=i("a",{id:"GeometryOps.equals-Tuple{GeoInterface.PointTrait, Any, GeoInterface.PointTrait, Any}",href:"#GeometryOps.equals-Tuple{GeoInterface.PointTrait, Any, GeoInterface.PointTrait, Any}"},[i("span",{class:"jlbinding"},"GeometryOps.equals")],-1)),s[214]||(s[214]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[215]||(s[215]=a('
julia
equals(::GI.PointTrait, p1, ::GI.PointTrait, p2)::Bool

Two points are the same if they have the same x and y (and z if 3D) coordinates.

source

',3))]),i("details",Os,[i("summary",null,[s[216]||(s[216]=i("a",{id:"GeometryOps.equals-Tuple{GeoInterface.PolygonTrait, Any, GeoInterface.MultiPolygonTrait, Any}",href:"#GeometryOps.equals-Tuple{GeoInterface.PolygonTrait, Any, GeoInterface.MultiPolygonTrait, Any}"},[i("span",{class:"jlbinding"},"GeometryOps.equals")],-1)),s[217]||(s[217]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[218]||(s[218]=a('
julia
equals(::GI.PolygonTrait, geom_a, ::GI.MultiPolygonTrait, geom_b)::Bool

A polygon and a multipolygon are equal if the multipolygon is composed of a single polygon that is equivalent to the given polygon.

source

',3))]),i("details",Ds,[i("summary",null,[s[219]||(s[219]=i("a",{id:"GeometryOps.equals-Tuple{GeoInterface.PolygonTrait, Any, GeoInterface.PolygonTrait, Any}",href:"#GeometryOps.equals-Tuple{GeoInterface.PolygonTrait, Any, GeoInterface.PolygonTrait, Any}"},[i("span",{class:"jlbinding"},"GeometryOps.equals")],-1)),s[220]||(s[220]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[221]||(s[221]=a('
julia
equals(::GI.PolygonTrait, geom_a, ::GI.PolygonTrait, geom_b)::Bool

Two polygons are equal if they share the same exterior edge and holes.

source

',3))]),i("details",Qs,[i("summary",null,[s[222]||(s[222]=i("a",{id:"GeometryOps.equals-Tuple{Union{GeoInterface.LineStringTrait, GeoInterface.LineTrait}, Any, GeoInterface.LinearRingTrait, Any}",href:"#GeometryOps.equals-Tuple{Union{GeoInterface.LineStringTrait, GeoInterface.LineTrait}, Any, GeoInterface.LinearRingTrait, Any}"},[i("span",{class:"jlbinding"},"GeometryOps.equals")],-1)),s[223]||(s[223]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[224]||(s[224]=a(`
julia
equals(
+    ::Union{GI.LineTrait, GI.LineStringTrait}, l1,
+    ::GI.LinearRingTrait, l2,
+)::Bool

A line/linestring and a linear ring are equal if they share the same set of points going along the curve. Note that lines aren't closed by definition, but rings are, so the line must have a repeated last point to be equal

source

`,3))]),i("details",xs,[i("summary",null,[s[225]||(s[225]=i("a",{id:"GeometryOps.equals-Tuple{Union{GeoInterface.LineStringTrait, GeoInterface.LineTrait}, Any, Union{GeoInterface.LineStringTrait, GeoInterface.LineTrait}, Any}",href:"#GeometryOps.equals-Tuple{Union{GeoInterface.LineStringTrait, GeoInterface.LineTrait}, Any, Union{GeoInterface.LineStringTrait, GeoInterface.LineTrait}, Any}"},[i("span",{class:"jlbinding"},"GeometryOps.equals")],-1)),s[226]||(s[226]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[227]||(s[227]=a(`
julia
equals(
+    ::Union{GI.LineTrait, GI.LineStringTrait}, l1,
+    ::Union{GI.LineTrait, GI.LineStringTrait}, l2,
+)::Bool

Two lines/linestrings are equal if they share the same set of points going along the curve. Note that lines/linestrings aren't closed by definition.

source

`,3))]),i("details",ws,[i("summary",null,[s[228]||(s[228]=i("a",{id:"GeometryOps.equals-Union{Tuple{T}, Tuple{T, Any, T, Any}} where T",href:"#GeometryOps.equals-Union{Tuple{T}, Tuple{T, Any, T, Any}} where T"},[i("span",{class:"jlbinding"},"GeometryOps.equals")],-1)),s[229]||(s[229]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[230]||(s[230]=a('
julia
equals(::T, geom_a, ::T, geom_b)::Bool

Two geometries of the same type, which don't have a equals function to dispatch off of should throw an error.

source

',3))]),i("details",Ls,[i("summary",null,[s[231]||(s[231]=i("a",{id:"GeometryOps.flip-Tuple{Any}",href:"#GeometryOps.flip-Tuple{Any}"},[i("span",{class:"jlbinding"},"GeometryOps.flip")],-1)),s[232]||(s[232]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[233]||(s[233]=a('
julia
flip(obj)

Swap all of the x and y coordinates in obj, otherwise keeping the original structure (but not necessarily the original type).

Keywords

  • threaded: true or false. Whether to use multithreading. Defaults to false.

  • crs: The CRS to attach to geometries. Defaults to nothing.

  • calc_extent: true or false. Whether to calculate the extent. Defaults to false.

source

',5))]),i("details",Is,[i("summary",null,[s[234]||(s[234]=i("a",{id:"GeometryOps.intersection-Union{Tuple{T}, Tuple{Any, Any}, Tuple{Any, Any, Type{T}}} where T<:AbstractFloat",href:"#GeometryOps.intersection-Union{Tuple{T}, Tuple{Any, Any}, Tuple{Any, Any, Type{T}}} where T<:AbstractFloat"},[i("span",{class:"jlbinding"},"GeometryOps.intersection")],-1)),s[235]||(s[235]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[236]||(s[236]=a(`
julia
intersection(geom_a, geom_b, [T::Type]; target::Type, fix_multipoly = UnionIntersectingPolygons())

Return the intersection between two geometries as a list of geometries. Return an empty list if none are found. The type of the list will be constrained as much as possible given the input geometries. Furthermore, the user can provide a target type as a keyword argument and a list of target geometries found in the intersection will be returned. The user can also provide a float type that they would like the points of returned geometries to be. If the user is taking a intersection involving one or more multipolygons, and the multipolygon might be comprised of polygons that intersect, if fix_multipoly is set to an IntersectingPolygons correction (the default is UnionIntersectingPolygons()), then the needed multipolygons will be fixed to be valid before performing the intersection to ensure a correct answer. Only set fix_multipoly to nothing if you know that the multipolygons are valid, as it will avoid unneeded computation.

Example

julia
import GeoInterface as GI, GeometryOps as GO
+
+line1 = GI.Line([(124.584961,-12.768946), (126.738281,-17.224758)])
+line2 = GI.Line([(123.354492,-15.961329), (127.22168,-14.008696)])
+inter_points = GO.intersection(line1, line2; target = GI.PointTrait())
+GI.coordinates.(inter_points)
+
+# output
+1-element Vector{Vector{Float64}}:
+ [125.58375366067548, -14.83572303404496]

source

`,5))]),i("details",Ms,[i("summary",null,[s[237]||(s[237]=i("a",{id:"GeometryOps.intersection_points-Union{Tuple{T}, Tuple{Any, Any}, Tuple{Any, Any, Type{T}}} where T<:AbstractFloat",href:"#GeometryOps.intersection_points-Union{Tuple{T}, Tuple{Any, Any}, Tuple{Any, Any, Type{T}}} where T<:AbstractFloat"},[i("span",{class:"jlbinding"},"GeometryOps.intersection_points")],-1)),s[238]||(s[238]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[239]||(s[239]=a(`
julia
intersection_points(geom_a, geom_b, [T::Type])

Return a list of intersection tuple points between two geometries. If no intersection points exist, returns an empty list.

Example

jldoctest

+line1 = GI.Line([(124.584961,-12.768946), (126.738281,-17.224758)]) line2 = GI.Line([(123.354492,-15.961329), (127.22168,-14.008696)]) inter_points = GO.intersection_points(line1, line2)
+
+**output**
+
+1-element Vector{Tuple{Float64, Float64}}:  (125.58375366067548, -14.83572303404496)
+
+
+[source](https://github.com/JuliaGeo/GeometryOps.jl/blob/347821afdac1a9ec607aa2939464014c8ef54b3d/src/methods/clipping/intersection.jl#L177-L195)
+
+</details>
+
+<details class='jldocstring custom-block' open>
+<summary><a id='GeometryOps.intersects-Tuple{Any, Any}' href='#GeometryOps.intersects-Tuple{Any, Any}'><span class="jlbinding">GeometryOps.intersects</span></a> <Badge type="info" class="jlObjectType jlMethod" text="Method" /></summary>
+
+
+
+\`\`\`julia
+intersects(geom1, geom2)::Bool

Return true if the interiors or boundaries of the two geometries interact.

intersects returns the exact opposite result of disjoint.

Example

julia
import GeoInterface as GI, GeometryOps as GO
+
+line1 = GI.Line([(124.584961,-12.768946), (126.738281,-17.224758)])
+line2 = GI.Line([(123.354492,-15.961329), (127.22168,-14.008696)])
+GO.intersects(line1, line2)
+
+# output
+true

source

`,9))]),i("details",Ps,[i("summary",null,[s[240]||(s[240]=i("a",{id:"GeometryOps.isclockwise-Tuple{Any}",href:"#GeometryOps.isclockwise-Tuple{Any}"},[i("span",{class:"jlbinding"},"GeometryOps.isclockwise")],-1)),s[241]||(s[241]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[244]||(s[244]=a('
julia
isclockwise(line::Union{LineString, Vector{Position}})::Bool

Take a ring and return true if the line goes clockwise, or false if the line goes counter-clockwise. "Going clockwise" means, mathematically,

',2)),i("mjx-container",qs,[(p(),l("svg",Rs,s[242]||(s[242]=[a('',1)]))),s[243]||(s[243]=i("mjx-assistive-mml",{unselectable:"on",display:"block",style:{top:"0px",left:"0px",clip:"rect(1px, 1px, 1px, 1px)","-webkit-touch-callout":"none","-webkit-user-select":"none","-khtml-user-select":"none","-moz-user-select":"none","-ms-user-select":"none","user-select":"none",position:"absolute",padding:"1px 0px 0px 0px",border:"0px",display:"block",overflow:"hidden",width:"100%"}},[i("math",{xmlns:"http://www.w3.org/1998/Math/MathML",display:"block"},[i("mrow",{"data-mjx-texclass":"INNER"},[i("mo",{"data-mjx-texclass":"OPEN"},"("),i("munderover",null,[i("mo",{"data-mjx-texclass":"OP"},"∑"),i("mrow",{"data-mjx-texclass":"ORD"},[i("mi",null,"i"),i("mo",null,"="),i("mn",null,"2")]),i("mi",null,"n")]),i("mo",{stretchy:"false"},"("),i("msub",null,[i("mi",null,"x"),i("mi",null,"i")]),i("mo",null,"−"),i("msub",null,[i("mi",null,"x"),i("mrow",{"data-mjx-texclass":"ORD"},[i("mi",null,"i"),i("mo",null,"−"),i("mn",null,"1")])]),i("mo",{stretchy:"false"},")"),i("mo",null,"⋅"),i("mo",{stretchy:"false"},"("),i("msub",null,[i("mi",null,"y"),i("mi",null,"i")]),i("mo",null,"+"),i("msub",null,[i("mi",null,"y"),i("mrow",{"data-mjx-texclass":"ORD"},[i("mi",null,"i"),i("mo",null,"−"),i("mn",null,"1")])]),i("mo",{stretchy:"false"},")"),i("mo",{"data-mjx-texclass":"CLOSE"},")")]),i("mo",null,">"),i("mn",null,"0")])],-1))]),s[245]||(s[245]=a(`

Example

julia
julia> import GeoInterface as GI, GeometryOps as GO
+julia> ring = GI.LinearRing([(0, 0), (1, 1), (1, 0), (0, 0)]);
+julia> GO.isclockwise(ring)
+# output
+true

source

`,3))]),i("details",Ss,[i("summary",null,[s[246]||(s[246]=i("a",{id:"GeometryOps.isconcave-Tuple{Any}",href:"#GeometryOps.isconcave-Tuple{Any}"},[i("span",{class:"jlbinding"},"GeometryOps.isconcave")],-1)),s[247]||(s[247]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[248]||(s[248]=a(`
julia
isconcave(poly::Polygon)::Bool

Take a polygon and return true or false as to whether it is concave or not.

Examples

julia
import GeoInterface as GI, GeometryOps as GO
+
+poly = GI.Polygon([[(0, 0), (0, 1), (1, 1), (1, 0), (0, 0)]])
+GO.isconcave(poly)
+
+# output
+false

source

`,5))]),i("details",Vs,[i("summary",null,[s[249]||(s[249]=i("a",{id:"GeometryOps.overlaps-Tuple{Any, Any}",href:"#GeometryOps.overlaps-Tuple{Any, Any}"},[i("span",{class:"jlbinding"},"GeometryOps.overlaps")],-1)),s[250]||(s[250]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[251]||(s[251]=a(`
julia
overlaps(geom1, geom2)::Bool

Compare two Geometries of the same dimension and return true if their intersection set results in a geometry different from both but of the same dimension. This means one geometry cannot be within or contain the other and they cannot be equal

Examples

julia
import GeometryOps as GO, GeoInterface as GI
+poly1 = GI.Polygon([[(0,0), (0,5), (5,5), (5,0), (0,0)]])
+poly2 = GI.Polygon([[(1,1), (1,6), (6,6), (6,1), (1,1)]])
+
+GO.overlaps(poly1, poly2)
+# output
+true

source

`,5))]),i("details",Js,[i("summary",null,[s[252]||(s[252]=i("a",{id:"GeometryOps.overlaps-Tuple{GeoInterface.AbstractTrait, Any, GeoInterface.AbstractTrait, Any}",href:"#GeometryOps.overlaps-Tuple{GeoInterface.AbstractTrait, Any, GeoInterface.AbstractTrait, Any}"},[i("span",{class:"jlbinding"},"GeometryOps.overlaps")],-1)),s[253]||(s[253]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[254]||(s[254]=a('
julia
overlaps(::GI.AbstractTrait, geom1, ::GI.AbstractTrait, geom2)::Bool

For any non-specified pair, all have non-matching dimensions, return false.

source

',3))]),i("details",Us,[i("summary",null,[s[255]||(s[255]=i("a",{id:"GeometryOps.overlaps-Tuple{GeoInterface.LineTrait, Any, GeoInterface.LineTrait, Any}",href:"#GeometryOps.overlaps-Tuple{GeoInterface.LineTrait, Any, GeoInterface.LineTrait, Any}"},[i("span",{class:"jlbinding"},"GeometryOps.overlaps")],-1)),s[256]||(s[256]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[257]||(s[257]=a('
julia
overlaps(::GI.LineTrait, line1, ::GI.LineTrait, line)::Bool

If the lines overlap, meaning that they are collinear but each have one endpoint outside of the other line, return true. Else false.

source

',3))]),i("details",Hs,[i("summary",null,[s[258]||(s[258]=i("a",{id:"GeometryOps.overlaps-Tuple{GeoInterface.MultiPointTrait, Any, GeoInterface.MultiPointTrait, Any}",href:"#GeometryOps.overlaps-Tuple{GeoInterface.MultiPointTrait, Any, GeoInterface.MultiPointTrait, Any}"},[i("span",{class:"jlbinding"},"GeometryOps.overlaps")],-1)),s[259]||(s[259]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[260]||(s[260]=a(`
julia
overlaps(
+    ::GI.MultiPointTrait, points1,
+    ::GI.MultiPointTrait, points2,
+)::Bool

If the multipoints overlap, meaning some, but not all, of the points within the multipoints are shared, return true.

source

`,3))]),i("details",Ns,[i("summary",null,[s[261]||(s[261]=i("a",{id:"GeometryOps.overlaps-Tuple{GeoInterface.MultiPolygonTrait, Any, GeoInterface.MultiPolygonTrait, Any}",href:"#GeometryOps.overlaps-Tuple{GeoInterface.MultiPolygonTrait, Any, GeoInterface.MultiPolygonTrait, Any}"},[i("span",{class:"jlbinding"},"GeometryOps.overlaps")],-1)),s[262]||(s[262]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[263]||(s[263]=a(`
julia
overlaps(
+    ::GI.MultiPolygonTrait, polys1,
+    ::GI.MultiPolygonTrait, polys2,
+)::Bool

Return true if at least one pair of polygons from multipolygons overlap. Else false.

source

`,3))]),i("details",Ws,[i("summary",null,[s[264]||(s[264]=i("a",{id:"GeometryOps.overlaps-Tuple{GeoInterface.MultiPolygonTrait, Any, GeoInterface.PolygonTrait, Any}",href:"#GeometryOps.overlaps-Tuple{GeoInterface.MultiPolygonTrait, Any, GeoInterface.PolygonTrait, Any}"},[i("span",{class:"jlbinding"},"GeometryOps.overlaps")],-1)),s[265]||(s[265]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[266]||(s[266]=a(`
julia
overlaps(
+    ::GI.MultiPolygonTrait, polys1,
+    ::GI.PolygonTrait, poly2,
+)::Bool

Return true if polygon overlaps with at least one of the polygons within the multipolygon. Else false.

source

`,3))]),i("details",zs,[i("summary",null,[s[267]||(s[267]=i("a",{id:"GeometryOps.overlaps-Tuple{GeoInterface.PolygonTrait, Any, GeoInterface.MultiPolygonTrait, Any}",href:"#GeometryOps.overlaps-Tuple{GeoInterface.PolygonTrait, Any, GeoInterface.MultiPolygonTrait, Any}"},[i("span",{class:"jlbinding"},"GeometryOps.overlaps")],-1)),s[268]||(s[268]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[269]||(s[269]=a(`
julia
overlaps(
+    ::GI.PolygonTrait, poly1,
+    ::GI.MultiPolygonTrait, polys2,
+)::Bool

Return true if polygon overlaps with at least one of the polygons within the multipolygon. Else false.

source

`,3))]),i("details",Zs,[i("summary",null,[s[270]||(s[270]=i("a",{id:"GeometryOps.overlaps-Tuple{GeoInterface.PolygonTrait, Any, GeoInterface.PolygonTrait, Any}",href:"#GeometryOps.overlaps-Tuple{GeoInterface.PolygonTrait, Any, GeoInterface.PolygonTrait, Any}"},[i("span",{class:"jlbinding"},"GeometryOps.overlaps")],-1)),s[271]||(s[271]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[272]||(s[272]=a(`
julia
overlaps(
+    trait_a::GI.PolygonTrait, poly_a,
+    trait_b::GI.PolygonTrait, poly_b,
+)::Bool

If the two polygons intersect with one another, but are not equal, return true. Else false.

source

`,3))]),i("details",_s,[i("summary",null,[s[273]||(s[273]=i("a",{id:"GeometryOps.overlaps-Tuple{Union{GeoInterface.LineStringTrait, GeoInterface.Wrappers.LinearRing}, Any, Union{GeoInterface.LineStringTrait, GeoInterface.Wrappers.LinearRing}, Any}",href:"#GeometryOps.overlaps-Tuple{Union{GeoInterface.LineStringTrait, GeoInterface.Wrappers.LinearRing}, Any, Union{GeoInterface.LineStringTrait, GeoInterface.Wrappers.LinearRing}, Any}"},[i("span",{class:"jlbinding"},"GeometryOps.overlaps")],-1)),s[274]||(s[274]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[275]||(s[275]=a(`
julia
overlaps(
+    ::Union{GI.LineStringTrait, GI.LinearRing}, line1,
+    ::Union{GI.LineStringTrait, GI.LinearRing}, line2,
+)::Bool

If the curves overlap, meaning that at least one edge of each curve overlaps, return true. Else false.

source

`,3))]),i("details",Ks,[i("summary",null,[s[276]||(s[276]=i("a",{id:"GeometryOps.polygon_to_line-Tuple{Any}",href:"#GeometryOps.polygon_to_line-Tuple{Any}"},[i("span",{class:"jlbinding"},"GeometryOps.polygon_to_line")],-1)),s[277]||(s[277]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[278]||(s[278]=a(`
julia
polygon_to_line(poly::Polygon)

Converts a Polygon to LineString or MultiLineString

Examples

julia
import GeometryOps as GO, GeoInterface as GI
+
+poly = GI.Polygon([[(-2.275543, 53.464547), (-2.275543, 53.489271), (-2.215118, 53.489271), (-2.215118, 53.464547), (-2.275543, 53.464547)]])
+GO.polygon_to_line(poly)
+# output
+GeoInterface.Wrappers.LineString{false, false, Vector{Tuple{Float64, Float64}}, Nothing, Nothing}([(-2.275543, 53.464547), (-2.275543, 53.489271), (-2.215118, 53.489271), (-2.215118, 53.464547), (-2.275543, 53.464547)], nothing, nothing)

source

`,5))]),i("details",Xs,[i("summary",null,[s[279]||(s[279]=i("a",{id:"GeometryOps.polygonize-Tuple{AbstractMatrix{Bool}}",href:"#GeometryOps.polygonize-Tuple{AbstractMatrix{Bool}}"},[i("span",{class:"jlbinding"},"GeometryOps.polygonize")],-1)),s[280]||(s[280]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[281]||(s[281]=a(`
julia
polygonize(A::AbstractMatrix{Bool}; kw...)
+polygonize(f, A::AbstractMatrix; kw...)
+polygonize(xs, ys, A::AbstractMatrix{Bool}; kw...)
+polygonize(f, xs, ys, A::AbstractMatrix; kw...)

Polygonize an AbstractMatrix of values, currently to a single class of polygons.

Returns a MultiPolygon for Bool values and f return values, and a FeatureCollection of Features holding MultiPolygon for all other values.

Function f should return either true or false or a transformation of values into simpler groups, especially useful for floating point arrays.

If xs and ys are ranges, they are used as the pixel/cell center points. If they are Vector of Tuple they are used as the lower and upper bounds of each pixel/cell.

Keywords

  • minpoints: ignore polygons with less than minpoints points.

  • values: the values to turn into polygons. By default these are union(A), If function f is passed these refer to the return values of f, by default union(map(f, A). If values Bool, false is ignored and a single MultiPolygon is returned rather than a FeatureCollection.

Example

julia
using GeometryOps
+A = rand(100, 100)
+multipolygon = polygonize(>(0.5), A);

source

`,10))]),i("details",$s,[i("summary",null,[s[282]||(s[282]=i("a",{id:"GeometryOps.segmentize-Tuple{Any}",href:"#GeometryOps.segmentize-Tuple{Any}"},[i("span",{class:"jlbinding"},"GeometryOps.segmentize")],-1)),s[283]||(s[283]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[284]||(s[284]=a('
julia
segmentize([method = Planar()], geom; max_distance::Real, threaded)

Segmentize a geometry by adding extra vertices to the geometry so that no segment is longer than a given distance. This is useful for plotting geometries with a limited number of vertices, or for ensuring that a geometry is not too "coarse" for a given application.

Arguments

  • method::Manifold = Planar(): The method to use for segmentizing the geometry. At the moment, only Planar (assumes a flat plane) and Geodesic (assumes geometry on the ellipsoidal Earth and uses Vincenty's formulae) are available.

  • geom: The geometry to segmentize. Must be a LineString, LinearRing, Polygon, MultiPolygon, or GeometryCollection, or some vector or table of those.

  • max_distance::Real: The maximum distance between vertices in the geometry. Beware: for Planar, this is in the units of the geometry, but for Geodesic and Spherical it's in units of the radius of the sphere.

Returns a geometry of similar type to the input geometry, but resampled.

source

',6))]),i("details",Ys,[i("summary",null,[s[285]||(s[285]=i("a",{id:"GeometryOps.signed_area-Union{Tuple{Any}, Tuple{T}, Tuple{Any, Type{T}}} where T<:AbstractFloat",href:"#GeometryOps.signed_area-Union{Tuple{Any}, Tuple{T}, Tuple{Any, Type{T}}} where T<:AbstractFloat"},[i("span",{class:"jlbinding"},"GeometryOps.signed_area")],-1)),s[286]||(s[286]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[287]||(s[287]=a(`
julia
signed_area(geom, [T = Float64])::T

Returns the signed area of a single geometry, based on winding order. This is computed slightly differently for different geometries:

- The signed area of a point is always zero.
+- The signed area of a curve is always zero.
+- The signed area of a polygon is computed with the shoelace formula and is
+positive if the polygon coordinates wind clockwise and negative if
+counterclockwise.
+- You cannot compute the signed area of a multipolygon as it doesn't have a
+meaning as each sub-polygon could have a different winding order.

Result will be of type T, where T is an optional argument with a default value of Float64.

source

`,5))]),i("details",si,[i("summary",null,[s[288]||(s[288]=i("a",{id:"GeometryOps.signed_distance-Union{Tuple{T}, Tuple{Any, Any}, Tuple{Any, Any, Type{T}}} where T<:AbstractFloat",href:"#GeometryOps.signed_distance-Union{Tuple{T}, Tuple{Any, Any}, Tuple{Any, Any, Type{T}}} where T<:AbstractFloat"},[i("span",{class:"jlbinding"},"GeometryOps.signed_distance")],-1)),s[289]||(s[289]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[290]||(s[290]=a('
julia
signed_distance(point, geom, ::Type{T} = Float64)::T

Calculates the signed distance from the geometry geom to the given point. Points within geom have a negative signed distance, and points outside of geom have a positive signed distance. - The signed distance from a point to a point, line, linestring, or linear ring is equal to the distance between the two. - The signed distance from a point to a polygon is negative if the point is within the polygon and is positive otherwise. The value of the distance is the minimum distance from the point to an edge of the polygon. This includes edges created by holes. - The signed distance from a point to a multigeometry or a geometry collection is the minimum signed distance between the point and any of the sub-geometries.

Result will be of type T, where T is an optional argument with a default value of Float64.

source

',4))]),i("details",ii,[i("summary",null,[s[291]||(s[291]=i("a",{id:"GeometryOps.simplify-Tuple{GeometryOps.SimplifyAlg, Any}",href:"#GeometryOps.simplify-Tuple{GeometryOps.SimplifyAlg, Any}"},[i("span",{class:"jlbinding"},"GeometryOps.simplify")],-1)),s[292]||(s[292]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[293]||(s[293]=a(`
julia
simplify(obj; kw...)
+simplify(::SimplifyAlg, obj; kw...)

Simplify a geometry, feature, feature collection, or nested vectors or a table of these.

RadialDistance, DouglasPeucker, or VisvalingamWhyatt algorithms are available, listed in order of increasing quality but decreasing performance.

PoinTrait and MultiPointTrait are returned unchanged.

The default behaviour is simplify(DouglasPeucker(; kw...), obj). Pass in other SimplifyAlg to use other algorithms.

Keywords

  • prefilter_alg: SimplifyAlg algorithm used to pre-filter object before using primary filtering algorithm.

  • threaded: true or false. Whether to use multithreading. Defaults to false.

  • crs: The CRS to attach to geometries. Defaults to nothing.

  • calc_extent: true or false. Whether to calculate the extent. Defaults to false.

Keywords for DouglasPeucker are allowed when no algorithm is specified:

Keywords

  • ratio: the fraction of points that should remain after simplify. Useful as it will generalise for large collections of objects.

  • number: the number of points that should remain after simplify. Less useful for large collections of mixed size objects.

  • tol: the minimum distance a point will be from the line joining its neighboring points.

Example

Simplify a polygon to have six points:

julia
import GeoInterface as GI
+import GeometryOps as GO
+
+poly = GI.Polygon([[
+    [-70.603637, -33.399918],
+    [-70.614624, -33.395332],
+    [-70.639343, -33.392466],
+    [-70.659942, -33.394759],
+    [-70.683975, -33.404504],
+    [-70.697021, -33.419406],
+    [-70.701141, -33.434306],
+    [-70.700454, -33.446339],
+    [-70.694274, -33.458369],
+    [-70.682601, -33.465816],
+    [-70.668869, -33.472117],
+    [-70.646209, -33.473835],
+    [-70.624923, -33.472117],
+    [-70.609817, -33.468107],
+    [-70.595397, -33.458369],
+    [-70.587158, -33.442901],
+    [-70.587158, -33.426283],
+    [-70.590591, -33.414248],
+    [-70.594711, -33.406224],
+    [-70.603637, -33.399918]]])
+
+simple = GO.simplify(poly; number=6)
+GI.npoint(simple)
+
+# output
+6

source

`,14))]),i("details",ai,[i("summary",null,[s[294]||(s[294]=i("a",{id:"GeometryOps.t_value-Union{Tuple{T2}, Tuple{T1}, Tuple{N}, Tuple{Union{NTuple{N, T1}, StaticArraysCore.StaticArray{Tuple{N}, T1, 1}}, Union{NTuple{N, T1}, StaticArraysCore.StaticArray{Tuple{N}, T1, 1}}, T2, T2}} where {N, T1<:Real, T2<:Real}",href:"#GeometryOps.t_value-Union{Tuple{T2}, Tuple{T1}, Tuple{N}, Tuple{Union{NTuple{N, T1}, StaticArraysCore.StaticArray{Tuple{N}, T1, 1}}, Union{NTuple{N, T1}, StaticArraysCore.StaticArray{Tuple{N}, T1, 1}}, T2, T2}} where {N, T1<:Real, T2<:Real}"},[i("span",{class:"jlbinding"},"GeometryOps.t_value")],-1)),s[295]||(s[295]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[298]||(s[298]=a('
julia
t_value(sᵢ, sᵢ₊₁, rᵢ, rᵢ₊₁)

Returns the "T-value" as described in Hormann's presentation [1] on how to calculate the mean-value coordinate.

Here, sᵢ is the vector from vertex vᵢ to the point, and rᵢ is the norm (length) of sᵢ. s must be Point and r must be real numbers.

',3)),i("mjx-container",ei,[(p(),l("svg",ti,s[296]||(s[296]=[a('',1)]))),s[297]||(s[297]=i("mjx-assistive-mml",{unselectable:"on",display:"block",style:{top:"0px",left:"0px",clip:"rect(1px, 1px, 1px, 1px)","-webkit-touch-callout":"none","-webkit-user-select":"none","-khtml-user-select":"none","-moz-user-select":"none","-ms-user-select":"none","user-select":"none",position:"absolute",padding:"1px 0px 0px 0px",border:"0px",display:"block",overflow:"hidden",width:"100%"}},[i("math",{xmlns:"http://www.w3.org/1998/Math/MathML",display:"block"},[i("mi",null,"t"),i("mi",null,"ᵢ"),i("mo",null,"="),i("mfrac",null,[i("mrow",null,[i("mrow",{"data-mjx-texclass":"ORD"},[i("mi",{"data-mjx-auto-op":"false"},"det")]),i("mrow",{"data-mjx-texclass":"INNER"},[i("mo",{"data-mjx-texclass":"OPEN"},"("),i("mi",null,"s"),i("mi",null,"ᵢ"),i("mo",null,","),i("mi",null,"s"),i("mi",null,"ᵢ"),i("mrow",{"data-mjx-texclass":"ORD"},[i("mo",{"data-mjx-pseudoscript":"true"},"₊")]),i("mrow",{"data-mjx-texclass":"ORD"},[i("mo",{"data-mjx-pseudoscript":"true"},"₁")]),i("mo",{"data-mjx-texclass":"CLOSE"},")")])]),i("mrow",null,[i("mi",null,"r"),i("mi",null,"ᵢ"),i("mo",null,"∗"),i("mi",null,"r"),i("mi",null,"ᵢ"),i("mrow",{"data-mjx-texclass":"ORD"},[i("mo",{"data-mjx-pseudoscript":"true"},"₊")]),i("mrow",{"data-mjx-texclass":"ORD"},[i("mo",{"data-mjx-pseudoscript":"true"},"₁")]),i("mo",null,"+"),i("mi",null,"s"),i("mi",null,"ᵢ"),i("mo",null,"⋅"),i("mi",null,"s"),i("mi",null,"ᵢ"),i("mrow",{"data-mjx-texclass":"ORD"},[i("mo",{"data-mjx-pseudoscript":"true"},"₊")]),i("mrow",{"data-mjx-texclass":"ORD"},[i("mo",{"data-mjx-pseudoscript":"true"},"₁")])])])])],-1))]),s[299]||(s[299]=a(`

+
+[source](https://github.com/JuliaGeo/GeometryOps.jl/blob/347821afdac1a9ec607aa2939464014c8ef54b3d/src/methods/barycentric.jl#L289-L305)
+
+</details>
+
+<details class='jldocstring custom-block' open>
+<summary><a id='GeometryOps.to_edges-Union{Tuple{Any}, Tuple{T}, Tuple{Any, Type{T}}} where T' href='#GeometryOps.to_edges-Union{Tuple{Any}, Tuple{T}, Tuple{Any, Type{T}}} where T'><span class="jlbinding">GeometryOps.to_edges</span></a> <Badge type="info" class="jlObjectType jlMethod" text="Method" /></summary>
+
+
+
+\`\`\`julia
+to_edges()

Convert any geometry or collection of geometries into a flat vector of Tuple{Tuple{Float64,Float64},Tuple{Float64,Float64}} edges.

source

`,3))]),i("details",ni,[i("summary",null,[s[300]||(s[300]=i("a",{id:"GeometryOps.touches-Tuple{Any, Any}",href:"#GeometryOps.touches-Tuple{Any, Any}"},[i("span",{class:"jlbinding"},"GeometryOps.touches")],-1)),s[301]||(s[301]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[302]||(s[302]=a(`
julia
touches(geom1, geom2)::Bool

Return true if the first geometry touches the second geometry. In other words, the two interiors cannot interact, but one of the geometries must have a boundary point that interacts with either the other geometry's interior or boundary.

Examples

julia
import GeometryOps as GO, GeoInterface as GI
+
+l1 = GI.Line([(0.0, 0.0), (1.0, 0.0)])
+l2 = GI.Line([(1.0, 1.0), (1.0, -1.0)])
+
+GO.touches(l1, l2)
+# output
+true

source

`,5))]),i("details",li,[i("summary",null,[s[303]||(s[303]=i("a",{id:"GeometryOps.transform-Tuple{Any, Any}",href:"#GeometryOps.transform-Tuple{Any, Any}"},[i("span",{class:"jlbinding"},"GeometryOps.transform")],-1)),s[304]||(s[304]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[305]||(s[305]=a(`
julia
transform(f, obj)

Apply a function f to all the points in obj.

Points will be passed to f as an SVector to allow using CoordinateTransformations.jl and Rotations.jl without hassle.

SVector is also a valid GeoInterface.jl point, so will work in all GeoInterface.jl methods.

Example

julia
julia> import GeoInterface as GI
+
+julia> import GeometryOps as GO
+
+julia> geom = GI.Polygon([GI.LinearRing([(1, 2), (3, 4), (5, 6), (1, 2)]), GI.LinearRing([(3, 4), (5, 6), (6, 7), (3, 4)])]);
+
+julia> f = CoordinateTransformations.Translation(3.5, 1.5)
+Translation(3.5, 1.5)
+
+julia> GO.transform(f, geom)
+GeoInterface.Wrappers.Polygon{false, false, Vector{GeoInterface.Wrappers.LinearRing{false, false, Vector{StaticArraysCore.SVector{2, Float64}}, Nothing, Nothing}}, Nothing, Nothing}(GeoInterface.Wrappers.Linea
+rRing{false, false, Vector{StaticArraysCore.SVector{2, Float64}}, Nothing, Nothing}[GeoInterface.Wrappers.LinearRing{false, false, Vector{StaticArraysCore.SVector{2, Float64}}, Nothing, Nothing}(StaticArraysCo
+re.SVector{2, Float64}[[4.5, 3.5], [6.5, 5.5], [8.5, 7.5], [4.5, 3.5]], nothing, nothing), GeoInterface.Wrappers.LinearRing{false, false, Vector{StaticArraysCore.SVector{2, Float64}}, Nothing, Nothing}(StaticA
+rraysCore.SVector{2, Float64}[[6.5, 5.5], [8.5, 7.5], [9.5, 8.5], [6.5, 5.5]], nothing, nothing)], nothing, nothing)

With Rotations.jl you need to actually multiply the Rotation by the SVector point, which is easy using an anonymous function.

julia
julia> using Rotations
+
+julia> GO.transform(p -> one(RotMatrix{2}) * p, geom)
+GeoInterface.Wrappers.Polygon{false, false, Vector{GeoInterface.Wrappers.LinearRing{false, false, Vector{StaticArraysCore.SVector{2, Int64}}, Nothing, Nothing}}, Nothing, Nothing}(GeoInterface.Wrappers.LinearR
+ing{false, false, Vector{StaticArraysCore.SVector{2, Int64}}, Nothing, Nothing}[GeoInterface.Wrappers.LinearRing{false, false, Vector{StaticArraysCore.SVector{2, Int64}}, Nothing, Nothing}(StaticArraysCore.SVe
+ctor{2, Int64}[[2, 1], [4, 3], [6, 5], [2, 1]], nothing, nothing), GeoInterface.Wrappers.LinearRing{false, false, Vector{StaticArraysCore.SVector{2, Int64}}, Nothing, Nothing}(StaticArraysCore.SVector{2, Int64
+}[[4, 3], [6, 5], [7, 6], [4, 3]], nothing, nothing)], nothing, nothing)

source

`,9))]),i("details",pi,[i("summary",null,[s[306]||(s[306]=i("a",{id:"GeometryOps.tuples-Union{Tuple{Any}, Tuple{T}, Tuple{Any, Type{T}}} where T",href:"#GeometryOps.tuples-Union{Tuple{Any}, Tuple{T}, Tuple{Any, Type{T}}} where T"},[i("span",{class:"jlbinding"},"GeometryOps.tuples")],-1)),s[307]||(s[307]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[308]||(s[308]=a('
julia
tuples(obj)

Convert all points in obj to Tuples, wherever the are nested.

Returns a similar object or collection of objects using GeoInterface.jl geometries wrapping Tuple points.

Keywords

  • threaded: true or false. Whether to use multithreading. Defaults to false.

  • crs: The CRS to attach to geometries. Defaults to nothing.

  • calc_extent: true or false. Whether to calculate the extent. Defaults to false.

source

',6))]),i("details",hi,[i("summary",null,[s[309]||(s[309]=i("a",{id:"GeometryOps.union-Union{Tuple{T}, Tuple{Any, Any}, Tuple{Any, Any, Type{T}}} where T<:AbstractFloat",href:"#GeometryOps.union-Union{Tuple{T}, Tuple{Any, Any}, Tuple{Any, Any, Type{T}}} where T<:AbstractFloat"},[i("span",{class:"jlbinding"},"GeometryOps.union")],-1)),s[310]||(s[310]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[311]||(s[311]=a(`
julia
union(geom_a, geom_b, [::Type{T}]; target::Type, fix_multipoly = UnionIntersectingPolygons())

Return the union between two geometries as a list of geometries. Return an empty list if none are found. The type of the list will be constrained as much as possible given the input geometries. Furthermore, the user can provide a taget type as a keyword argument and a list of target geometries found in the difference will be returned. The user can also provide a float type 'T' that they would like the points of returned geometries to be. If the user is taking a intersection involving one or more multipolygons, and the multipolygon might be comprised of polygons that intersect, if fix_multipoly is set to an IntersectingPolygons correction (the default is UnionIntersectingPolygons()), then the needed multipolygons will be fixed to be valid before performing the intersection to ensure a correct answer. Only set fix_multipoly to false if you know that the multipolygons are valid, as it will avoid unneeded computation.

Calculates the union between two polygons.

Example

julia
import GeoInterface as GI, GeometryOps as GO
+
+p1 = GI.Polygon([[(0.0, 0.0), (5.0, 5.0), (10.0, 0.0), (5.0, -5.0), (0.0, 0.0)]])
+p2 = GI.Polygon([[(3.0, 0.0), (8.0, 5.0), (13.0, 0.0), (8.0, -5.0), (3.0, 0.0)]])
+union_poly = GO.union(p1, p2; target = GI.PolygonTrait())
+GI.coordinates.(union_poly)
+
+# output
+1-element Vector{Vector{Vector{Vector{Float64}}}}:
+ [[[6.5, 3.5], [5.0, 5.0], [0.0, 0.0], [5.0, -5.0], [6.5, -3.5], [8.0, -5.0], [13.0, 0.0], [8.0, 5.0], [6.5, 3.5]]]

source

`,6))]),i("details",ki,[i("summary",null,[s[312]||(s[312]=i("a",{id:"GeometryOps.weighted_mean-Union{Tuple{WT}, Tuple{WT, Any, Any}} where WT<:Real",href:"#GeometryOps.weighted_mean-Union{Tuple{WT}, Tuple{WT, Any, Any}} where WT<:Real"},[i("span",{class:"jlbinding"},"GeometryOps.weighted_mean")],-1)),s[313]||(s[313]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[314]||(s[314]=a('
julia
weighted_mean(weight::Real, x1, x2)

Returns the weighted mean of x1 and x2, where weight is the weight of x1.

Specifically, calculates x1 * weight + x2 * (1 - weight).

Note

The idea for this method is that you can override this for custom types, like Color types, in extension modules.

source

',5))]),i("details",ri,[i("summary",null,[s[315]||(s[315]=i("a",{id:"GeometryOps.within-Tuple{Any, Any}",href:"#GeometryOps.within-Tuple{Any, Any}"},[i("span",{class:"jlbinding"},"GeometryOps.within")],-1)),s[316]||(s[316]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[317]||(s[317]=a(`
julia
within(geom1, geom2)::Bool

Return true if the first geometry is completely within the second geometry. The interiors of both geometries must intersect and the interior and boundary of the primary geometry (geom1) must not intersect the exterior of the secondary geometry (geom2).

Furthermore, within returns the exact opposite result of contains.

Examples

julia
import GeometryOps as GO, GeoInterface as GI
+
+line = GI.LineString([(1, 1), (1, 2), (1, 3), (1, 4)])
+point = (1, 2)
+GO.within(point, line)
+
+# output
+true

source

`,6))]),s[324]||(s[324]=a('
  1. K. Hormann and N. Sukumar. Generalized Barycentric Coordinates in Computer Graphics and Computational Mechanics. Taylor & Fancis, CRC Press, 2017. ↩︎

',2))])}const Fi=h(r,[["render",oi]]);export{mi as __pageData,Fi as default}; diff --git a/previews/PR237/assets/api.md.CJkYwQvX.lean.js b/previews/PR237/assets/api.md.CJkYwQvX.lean.js new file mode 100644 index 000000000..ed1ff9772 --- /dev/null +++ b/previews/PR237/assets/api.md.CJkYwQvX.lean.js @@ -0,0 +1,381 @@ +import{_ as h,c as l,a5 as a,j as i,a as e,G as n,B as k,o as p}from"./chunks/framework.Cq8AuEls.js";const mi=JSON.parse('{"title":"Full GeometryOps API documentation","description":"","frontmatter":{},"headers":[],"relativePath":"api.md","filePath":"api.md","lastUpdated":null}'),r={name:"api.md"},o={class:"jldocstring custom-block",open:""},d={class:"jldocstring custom-block",open:""},g={class:"jldocstring custom-block",open:""},y={class:"jldocstring custom-block",open:""},E={class:"jldocstring custom-block",open:""},c={class:"jldocstring custom-block",open:""},u={class:"jldocstring custom-block",open:""},m={class:"jldocstring custom-block",open:""},F={class:"jldocstring custom-block",open:""},C={class:"jldocstring custom-block",open:""},b={class:"jldocstring custom-block",open:""},f={class:"jldocstring custom-block",open:""},T={class:"jldocstring custom-block",open:""},G={class:"jldocstring custom-block",open:""},v={class:"jldocstring custom-block",open:""},A={class:"jldocstring custom-block",open:""},j={class:"jldocstring custom-block",open:""},B={class:"jldocstring custom-block",open:""},O={class:"jldocstring custom-block",open:""},D={class:"jldocstring custom-block",open:""},Q={class:"jldocstring custom-block",open:""},x={class:"jldocstring custom-block",open:""},w={class:"jldocstring custom-block",open:""},L={class:"jldocstring custom-block",open:""},I={class:"jldocstring custom-block",open:""},M={class:"jldocstring custom-block",open:""},P={class:"jldocstring custom-block",open:""},q={class:"jldocstring custom-block",open:""},R={class:"jldocstring custom-block",open:""},S={class:"jldocstring custom-block",open:""},V={class:"jldocstring custom-block",open:""},J={class:"jldocstring custom-block",open:""},U={class:"jldocstring custom-block",open:""},H={class:"jldocstring custom-block",open:""},N={class:"jldocstring custom-block",open:""},W={class:"jldocstring custom-block",open:""},z={class:"jldocstring custom-block",open:""},Z={class:"jldocstring custom-block",open:""},_={class:"jldocstring custom-block",open:""},K={class:"jldocstring custom-block",open:""},X={class:"jldocstring custom-block",open:""},$={class:"jldocstring custom-block",open:""},Y={class:"jldocstring custom-block",open:""},ss={class:"jldocstring custom-block",open:""},is={class:"jldocstring custom-block",open:""},as={class:"jldocstring custom-block",open:""},es={class:"jldocstring custom-block",open:""},ts={class:"jldocstring custom-block",open:""},ns={class:"jldocstring custom-block",open:""},ls={class:"jldocstring custom-block",open:""},ps={class:"jldocstring custom-block",open:""},hs={class:"jldocstring custom-block",open:""},ks={class:"jldocstring custom-block",open:""},rs={class:"jldocstring custom-block",open:""},os={class:"jldocstring custom-block",open:""},ds={class:"jldocstring custom-block",open:""},gs={class:"jldocstring custom-block",open:""},ys={class:"jldocstring custom-block",open:""},Es={class:"jldocstring custom-block",open:""},cs={class:"jldocstring custom-block",open:""},us={class:"jldocstring custom-block",open:""},ms={class:"jldocstring custom-block",open:""},Fs={class:"jldocstring custom-block",open:""},Cs={class:"jldocstring custom-block",open:""},bs={class:"jldocstring custom-block",open:""},fs={class:"jldocstring custom-block",open:""},Ts={class:"jldocstring custom-block",open:""},Gs={class:"jldocstring custom-block",open:""},vs={class:"jldocstring custom-block",open:""},As={class:"jldocstring custom-block",open:""},js={class:"jldocstring custom-block",open:""},Bs={class:"jldocstring custom-block",open:""},Os={class:"jldocstring custom-block",open:""},Ds={class:"jldocstring custom-block",open:""},Qs={class:"jldocstring custom-block",open:""},xs={class:"jldocstring custom-block",open:""},ws={class:"jldocstring custom-block",open:""},Ls={class:"jldocstring custom-block",open:""},Is={class:"jldocstring custom-block",open:""},Ms={class:"jldocstring custom-block",open:""},Ps={class:"jldocstring custom-block",open:""},qs={class:"MathJax",jax:"SVG",display:"true",style:{direction:"ltr",display:"block","text-align":"center",margin:"1em 0",position:"relative"}},Rs={style:{overflow:"visible","min-height":"1px","min-width":"1px","vertical-align":"-2.827ex"},xmlns:"http://www.w3.org/2000/svg",width:"33.539ex",height:"6.785ex",role:"img",focusable:"false",viewBox:"0 -1749.5 14824.1 2999","aria-hidden":"true"},Ss={class:"jldocstring custom-block",open:""},Vs={class:"jldocstring custom-block",open:""},Js={class:"jldocstring custom-block",open:""},Us={class:"jldocstring custom-block",open:""},Hs={class:"jldocstring custom-block",open:""},Ns={class:"jldocstring custom-block",open:""},Ws={class:"jldocstring custom-block",open:""},zs={class:"jldocstring custom-block",open:""},Zs={class:"jldocstring custom-block",open:""},_s={class:"jldocstring custom-block",open:""},Ks={class:"jldocstring custom-block",open:""},Xs={class:"jldocstring custom-block",open:""},$s={class:"jldocstring custom-block",open:""},Ys={class:"jldocstring custom-block",open:""},si={class:"jldocstring custom-block",open:""},ii={class:"jldocstring custom-block",open:""},ai={class:"jldocstring custom-block",open:""},ei={class:"MathJax",jax:"SVG",display:"true",style:{direction:"ltr",display:"block","text-align":"center",margin:"1em 0",position:"relative"}},ti={style:{overflow:"visible","min-height":"1px","min-width":"1px","vertical-align":"-2.059ex"},xmlns:"http://www.w3.org/2000/svg",width:"27.746ex",height:"5.362ex",role:"img",focusable:"false",viewBox:"0 -1460 12263.9 2370","aria-hidden":"true"},ni={class:"jldocstring custom-block",open:""},li={class:"jldocstring custom-block",open:""},pi={class:"jldocstring custom-block",open:""},hi={class:"jldocstring custom-block",open:""},ki={class:"jldocstring custom-block",open:""},ri={class:"jldocstring custom-block",open:""};function oi(di,s,gi,yi,Ei,ci){const t=k("Badge");return p(),l("div",null,[s[318]||(s[318]=a('

Full GeometryOps API documentation

Warning

This page is still very much WIP!

Documentation for GeometryOps's full API (only for reference!).

apply and associated functions

',5)),i("details",o,[i("summary",null,[s[0]||(s[0]=i("a",{id:"GeometryOpsCore.apply",href:"#GeometryOpsCore.apply"},[i("span",{class:"jlbinding"},"GeometryOpsCore.apply")],-1)),s[1]||(s[1]=e()),n(t,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[2]||(s[2]=a(`
julia
apply(f, target::Union{TraitTarget, GI.AbstractTrait}, obj; kw...)

Reconstruct a geometry, feature, feature collection, or nested vectors of either using the function f on the target trait.

f(target_geom) => x where x also has the target trait, or a trait that can be substituted. For example, swapping PolgonTrait to MultiPointTrait will fail if the outer object has MultiPolygonTrait, but should work if it has FeatureTrait.

Objects "shallower" than the target trait are always completely rebuilt, like a Vector of FeatureCollectionTrait of FeatureTrait when the target has PolygonTrait and is held in the features. These will always be GeoInterface geometries/feature/feature collections. But "deeper" objects may remain unchanged or be whatever GeoInterface compatible objects f returns.

The result is a functionally similar geometry with values depending on f.

  • threaded: true or false. Whether to use multithreading. Defaults to false.

  • crs: The CRS to attach to geometries. Defaults to nothing.

  • calc_extent: true or false. Whether to calculate the extent. Defaults to false.

Example

Flipped point the order in any feature or geometry, or iterables of either:

julia
import GeoInterface as GI
+import GeometryOps as GO
+geom = GI.Polygon([GI.LinearRing([(1, 2), (3, 4), (5, 6), (1, 2)]),
+                   GI.LinearRing([(3, 4), (5, 6), (6, 7), (3, 4)])])
+
+flipped_geom = GO.apply(GI.PointTrait, geom) do p
+    (GI.y(p), GI.x(p))
+end

source

`,10))]),i("details",d,[i("summary",null,[s[3]||(s[3]=i("a",{id:"GeometryOpsCore.applyreduce",href:"#GeometryOpsCore.applyreduce"},[i("span",{class:"jlbinding"},"GeometryOpsCore.applyreduce")],-1)),s[4]||(s[4]=e()),n(t,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[5]||(s[5]=a('
julia
applyreduce(f, op, target::Union{TraitTarget, GI.AbstractTrait}, obj; threaded)

Apply function f to all objects with the target trait, and reduce the result with an op like +.

The order and grouping of application of op is not guaranteed.

If threaded==true threads will be used over arrays and iterables, feature collections and nested geometries.

source

',5))]),i("details",g,[i("summary",null,[s[6]||(s[6]=i("a",{id:"GeometryOps.reproject",href:"#GeometryOps.reproject"},[i("span",{class:"jlbinding"},"GeometryOps.reproject")],-1)),s[7]||(s[7]=e()),n(t,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[8]||(s[8]=a(`
julia
reproject(geometry; source_crs, target_crs, transform, always_xy, time)
+reproject(geometry, source_crs, target_crs; always_xy, time)
+reproject(geometry, transform; always_xy, time)

Reproject any GeoInterface.jl compatible geometry from source_crs to target_crs.

The returned object will be constructed from GeoInterface.WrapperGeometry geometries, wrapping views of a Vector{Proj.Point{D}}, where D is the dimension.

Tip

The Proj.jl package must be loaded for this method to work, since it is implemented in a package extension.

Arguments

  • geometry: Any GeoInterface.jl compatible geometries.

  • source_crs: the source coordinate reference system, as a GeoFormatTypes.jl object or a string.

  • target_crs: the target coordinate reference system, as a GeoFormatTypes.jl object or a string.

If these a passed as keywords, transform will take priority. Without it target_crs is always needed, and source_crs is needed if it is not retrievable from the geometry with GeoInterface.crs(geometry).

Keywords

  • always_xy: force x, y coordinate order, true by default. false will expect and return points in the crs coordinate order.

  • time: the time for the coordinates. Inf by default.

  • threaded: true or false. Whether to use multithreading. Defaults to false.

  • crs: The CRS to attach to geometries. Defaults to nothing.

  • calc_extent: true or false. Whether to calculate the extent. Defaults to false.

source

`,10))]),i("details",y,[i("summary",null,[s[9]||(s[9]=i("a",{id:"GeometryOps.transform",href:"#GeometryOps.transform"},[i("span",{class:"jlbinding"},"GeometryOps.transform")],-1)),s[10]||(s[10]=e()),n(t,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[11]||(s[11]=a(`
julia
transform(f, obj)

Apply a function f to all the points in obj.

Points will be passed to f as an SVector to allow using CoordinateTransformations.jl and Rotations.jl without hassle.

SVector is also a valid GeoInterface.jl point, so will work in all GeoInterface.jl methods.

Example

julia
julia> import GeoInterface as GI
+
+julia> import GeometryOps as GO
+
+julia> geom = GI.Polygon([GI.LinearRing([(1, 2), (3, 4), (5, 6), (1, 2)]), GI.LinearRing([(3, 4), (5, 6), (6, 7), (3, 4)])]);
+
+julia> f = CoordinateTransformations.Translation(3.5, 1.5)
+Translation(3.5, 1.5)
+
+julia> GO.transform(f, geom)
+GeoInterface.Wrappers.Polygon{false, false, Vector{GeoInterface.Wrappers.LinearRing{false, false, Vector{StaticArraysCore.SVector{2, Float64}}, Nothing, Nothing}}, Nothing, Nothing}(GeoInterface.Wrappers.Linea
+rRing{false, false, Vector{StaticArraysCore.SVector{2, Float64}}, Nothing, Nothing}[GeoInterface.Wrappers.LinearRing{false, false, Vector{StaticArraysCore.SVector{2, Float64}}, Nothing, Nothing}(StaticArraysCo
+re.SVector{2, Float64}[[4.5, 3.5], [6.5, 5.5], [8.5, 7.5], [4.5, 3.5]], nothing, nothing), GeoInterface.Wrappers.LinearRing{false, false, Vector{StaticArraysCore.SVector{2, Float64}}, Nothing, Nothing}(StaticA
+rraysCore.SVector{2, Float64}[[6.5, 5.5], [8.5, 7.5], [9.5, 8.5], [6.5, 5.5]], nothing, nothing)], nothing, nothing)

With Rotations.jl you need to actually multiply the Rotation by the SVector point, which is easy using an anonymous function.

julia
julia> using Rotations
+
+julia> GO.transform(p -> one(RotMatrix{2}) * p, geom)
+GeoInterface.Wrappers.Polygon{false, false, Vector{GeoInterface.Wrappers.LinearRing{false, false, Vector{StaticArraysCore.SVector{2, Int64}}, Nothing, Nothing}}, Nothing, Nothing}(GeoInterface.Wrappers.LinearR
+ing{false, false, Vector{StaticArraysCore.SVector{2, Int64}}, Nothing, Nothing}[GeoInterface.Wrappers.LinearRing{false, false, Vector{StaticArraysCore.SVector{2, Int64}}, Nothing, Nothing}(StaticArraysCore.SVe
+ctor{2, Int64}[[2, 1], [4, 3], [6, 5], [2, 1]], nothing, nothing), GeoInterface.Wrappers.LinearRing{false, false, Vector{StaticArraysCore.SVector{2, Int64}}, Nothing, Nothing}(StaticArraysCore.SVector{2, Int64
+}[[4, 3], [6, 5], [7, 6], [4, 3]], nothing, nothing)], nothing, nothing)

source

`,9))]),s[319]||(s[319]=i("h2",{id:"General-geometry-methods",tabindex:"-1"},[e("General geometry methods "),i("a",{class:"header-anchor",href:"#General-geometry-methods","aria-label":'Permalink to "General geometry methods {#General-geometry-methods}"'},"​")],-1)),s[320]||(s[320]=i("h3",{id:"OGC-methods",tabindex:"-1"},[e("OGC methods "),i("a",{class:"header-anchor",href:"#OGC-methods","aria-label":'Permalink to "OGC methods {#OGC-methods}"'},"​")],-1)),i("details",E,[i("summary",null,[s[12]||(s[12]=i("a",{id:"GeometryOps.contains",href:"#GeometryOps.contains"},[i("span",{class:"jlbinding"},"GeometryOps.contains")],-1)),s[13]||(s[13]=e()),n(t,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[14]||(s[14]=a(`
julia
contains(g1::AbstractGeometry, g2::AbstractGeometry)::Bool

Return true if the second geometry is completely contained by the first geometry. The interiors of both geometries must intersect and the interior and boundary of the secondary (g2) must not intersect the exterior of the first (g1).

contains returns the exact opposite result of within.

Examples

julia
import GeometryOps as GO, GeoInterface as GI
+line = GI.LineString([(1, 1), (1, 2), (1, 3), (1, 4)])
+point = GI.Point((1, 2))
+
+GO.contains(line, point)
+# output
+true

source

`,6))]),i("details",c,[i("summary",null,[s[15]||(s[15]=i("a",{id:"GeometryOps.coveredby",href:"#GeometryOps.coveredby"},[i("span",{class:"jlbinding"},"GeometryOps.coveredby")],-1)),s[16]||(s[16]=e()),n(t,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[17]||(s[17]=a(`
julia
coveredby(g1, g2)::Bool

Return true if the first geometry is completely covered by the second geometry. The interior and boundary of the primary geometry (g1) must not intersect the exterior of the secondary geometry (g2).

Furthermore, coveredby returns the exact opposite result of covers. They are equivalent with the order of the arguments swapped.

Examples

julia
import GeometryOps as GO, GeoInterface as GI
+p1 = GI.Point(0.0, 0.0)
+p2 = GI.Point(1.0, 1.0)
+l1 = GI.Line([p1, p2])
+
+GO.coveredby(p1, l1)
+# output
+true

source

`,6))]),i("details",u,[i("summary",null,[s[18]||(s[18]=i("a",{id:"GeometryOps.covers",href:"#GeometryOps.covers"},[i("span",{class:"jlbinding"},"GeometryOps.covers")],-1)),s[19]||(s[19]=e()),n(t,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[20]||(s[20]=a(`
julia
covers(g1::AbstractGeometry, g2::AbstractGeometry)::Bool

Return true if the first geometry is completely covers the second geometry, The exterior and boundary of the second geometry must not be outside of the interior and boundary of the first geometry. However, the interiors need not intersect.

covers returns the exact opposite result of coveredby.

Examples

julia
import GeometryOps as GO, GeoInterface as GI
+l1 = GI.LineString([(1.0, 1.0), (1.0, 2.0), (1.0, 3.0), (1.0, 4.0)])
+l2 = GI.LineString([(1.0, 1.0), (1.0, 2.0)])
+
+GO.covers(l1, l2)
+# output
+true

source

`,6))]),i("details",m,[i("summary",null,[s[21]||(s[21]=i("a",{id:"GeometryOps.crosses",href:"#GeometryOps.crosses"},[i("span",{class:"jlbinding"},"GeometryOps.crosses")],-1)),s[22]||(s[22]=e()),n(t,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[23]||(s[23]=a(`
julia
 crosses(geom1, geom2)::Bool

Return true if the intersection results in a geometry whose dimension is one less than the maximum dimension of the two source geometries and the intersection set is interior to both source geometries.

TODO: broken

Examples

julia
import GeoInterface as GI, GeometryOps as GO
+# TODO: Add working example

source

`,6))]),i("details",F,[i("summary",null,[s[24]||(s[24]=i("a",{id:"GeometryOps.disjoint",href:"#GeometryOps.disjoint"},[i("span",{class:"jlbinding"},"GeometryOps.disjoint")],-1)),s[25]||(s[25]=e()),n(t,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[26]||(s[26]=a(`
julia
disjoint(geom1, geom2)::Bool

Return true if the first geometry is disjoint from the second geometry.

Return true if the first geometry is disjoint from the second geometry. The interiors and boundaries of both geometries must not intersect.

Examples

julia
import GeometryOps as GO, GeoInterface as GI
+
+line = GI.LineString([(1, 1), (1, 2), (1, 3), (1, 4)])
+point = (2, 2)
+GO.disjoint(point, line)
+
+# output
+true

source

`,6))]),i("details",C,[i("summary",null,[s[27]||(s[27]=i("a",{id:"GeometryOps.intersects",href:"#GeometryOps.intersects"},[i("span",{class:"jlbinding"},"GeometryOps.intersects")],-1)),s[28]||(s[28]=e()),n(t,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[29]||(s[29]=a(`
julia
intersects(geom1, geom2)::Bool

Return true if the interiors or boundaries of the two geometries interact.

intersects returns the exact opposite result of disjoint.

Example

julia
import GeoInterface as GI, GeometryOps as GO
+
+line1 = GI.Line([(124.584961,-12.768946), (126.738281,-17.224758)])
+line2 = GI.Line([(123.354492,-15.961329), (127.22168,-14.008696)])
+GO.intersects(line1, line2)
+
+# output
+true

source

`,6))]),i("details",b,[i("summary",null,[s[30]||(s[30]=i("a",{id:"GeometryOps.overlaps",href:"#GeometryOps.overlaps"},[i("span",{class:"jlbinding"},"GeometryOps.overlaps")],-1)),s[31]||(s[31]=e()),n(t,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[32]||(s[32]=a(`
julia
overlaps(geom1, geom2)::Bool

Compare two Geometries of the same dimension and return true if their intersection set results in a geometry different from both but of the same dimension. This means one geometry cannot be within or contain the other and they cannot be equal

Examples

julia
import GeometryOps as GO, GeoInterface as GI
+poly1 = GI.Polygon([[(0,0), (0,5), (5,5), (5,0), (0,0)]])
+poly2 = GI.Polygon([[(1,1), (1,6), (6,6), (6,1), (1,1)]])
+
+GO.overlaps(poly1, poly2)
+# output
+true

source

julia
overlaps(::GI.AbstractTrait, geom1, ::GI.AbstractTrait, geom2)::Bool

For any non-specified pair, all have non-matching dimensions, return false.

source

julia
overlaps(
+    ::GI.MultiPointTrait, points1,
+    ::GI.MultiPointTrait, points2,
+)::Bool

If the multipoints overlap, meaning some, but not all, of the points within the multipoints are shared, return true.

source

julia
overlaps(::GI.LineTrait, line1, ::GI.LineTrait, line)::Bool

If the lines overlap, meaning that they are collinear but each have one endpoint outside of the other line, return true. Else false.

source

julia
overlaps(
+    ::Union{GI.LineStringTrait, GI.LinearRing}, line1,
+    ::Union{GI.LineStringTrait, GI.LinearRing}, line2,
+)::Bool

If the curves overlap, meaning that at least one edge of each curve overlaps, return true. Else false.

source

julia
overlaps(
+    trait_a::GI.PolygonTrait, poly_a,
+    trait_b::GI.PolygonTrait, poly_b,
+)::Bool

If the two polygons intersect with one another, but are not equal, return true. Else false.

source

julia
overlaps(
+    ::GI.PolygonTrait, poly1,
+    ::GI.MultiPolygonTrait, polys2,
+)::Bool

Return true if polygon overlaps with at least one of the polygons within the multipolygon. Else false.

source

julia
overlaps(
+    ::GI.MultiPolygonTrait, polys1,
+    ::GI.PolygonTrait, poly2,
+)::Bool

Return true if polygon overlaps with at least one of the polygons within the multipolygon. Else false.

source

julia
overlaps(
+    ::GI.MultiPolygonTrait, polys1,
+    ::GI.MultiPolygonTrait, polys2,
+)::Bool

Return true if at least one pair of polygons from multipolygons overlap. Else false.

source

`,29))]),i("details",f,[i("summary",null,[s[33]||(s[33]=i("a",{id:"GeometryOps.touches",href:"#GeometryOps.touches"},[i("span",{class:"jlbinding"},"GeometryOps.touches")],-1)),s[34]||(s[34]=e()),n(t,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[35]||(s[35]=a(`
julia
touches(geom1, geom2)::Bool

Return true if the first geometry touches the second geometry. In other words, the two interiors cannot interact, but one of the geometries must have a boundary point that interacts with either the other geometry's interior or boundary.

Examples

julia
import GeometryOps as GO, GeoInterface as GI
+
+l1 = GI.Line([(0.0, 0.0), (1.0, 0.0)])
+l2 = GI.Line([(1.0, 1.0), (1.0, -1.0)])
+
+GO.touches(l1, l2)
+# output
+true

source

`,5))]),i("details",T,[i("summary",null,[s[36]||(s[36]=i("a",{id:"GeometryOps.within",href:"#GeometryOps.within"},[i("span",{class:"jlbinding"},"GeometryOps.within")],-1)),s[37]||(s[37]=e()),n(t,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[38]||(s[38]=a(`
julia
within(geom1, geom2)::Bool

Return true if the first geometry is completely within the second geometry. The interiors of both geometries must intersect and the interior and boundary of the primary geometry (geom1) must not intersect the exterior of the secondary geometry (geom2).

Furthermore, within returns the exact opposite result of contains.

Examples

julia
import GeometryOps as GO, GeoInterface as GI
+
+line = GI.LineString([(1, 1), (1, 2), (1, 3), (1, 4)])
+point = (1, 2)
+GO.within(point, line)
+
+# output
+true

source

`,6))]),s[321]||(s[321]=i("h3",{id:"Other-general-methods",tabindex:"-1"},[e("Other general methods "),i("a",{class:"header-anchor",href:"#Other-general-methods","aria-label":'Permalink to "Other general methods {#Other-general-methods}"'},"​")],-1)),i("details",G,[i("summary",null,[s[39]||(s[39]=i("a",{id:"GeometryOps.equals",href:"#GeometryOps.equals"},[i("span",{class:"jlbinding"},"GeometryOps.equals")],-1)),s[40]||(s[40]=e()),n(t,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[41]||(s[41]=a(`
julia
equals(geom1, geom2)::Bool

Compare two Geometries return true if they are the same geometry.

Examples

julia
import GeometryOps as GO, GeoInterface as GI
+poly1 = GI.Polygon([[(0,0), (0,5), (5,5), (5,0), (0,0)]])
+poly2 = GI.Polygon([[(0,0), (0,5), (5,5), (5,0), (0,0)]])
+
+GO.equals(poly1, poly2)
+# output
+true

source

julia
equals(::T, geom_a, ::T, geom_b)::Bool

Two geometries of the same type, which don't have a equals function to dispatch off of should throw an error.

source

julia
equals(trait_a, geom_a, trait_b, geom_b)

Two geometries which are not of the same type cannot be equal so they always return false.

source

julia
equals(::GI.PointTrait, p1, ::GI.PointTrait, p2)::Bool

Two points are the same if they have the same x and y (and z if 3D) coordinates.

source

julia
equals(::GI.PointTrait, p1, ::GI.MultiPointTrait, mp2)::Bool

A point and a multipoint are equal if the multipoint is composed of a single point that is equivalent to the given point.

source

julia
equals(::GI.MultiPointTrait, mp1, ::GI.PointTrait, p2)::Bool

A point and a multipoint are equal if the multipoint is composed of a single point that is equivalent to the given point.

source

julia
equals(::GI.MultiPointTrait, mp1, ::GI.MultiPointTrait, mp2)::Bool

Two multipoints are equal if they share the same set of points.

source

julia
equals(
+    ::Union{GI.LineTrait, GI.LineStringTrait}, l1,
+    ::Union{GI.LineTrait, GI.LineStringTrait}, l2,
+)::Bool

Two lines/linestrings are equal if they share the same set of points going along the curve. Note that lines/linestrings aren't closed by definition.

source

julia
equals(
+    ::Union{GI.LineTrait, GI.LineStringTrait}, l1,
+    ::GI.LinearRingTrait, l2,
+)::Bool

A line/linestring and a linear ring are equal if they share the same set of points going along the curve. Note that lines aren't closed by definition, but rings are, so the line must have a repeated last point to be equal

source

julia
equals(
+    ::GI.LinearRingTrait, l1,
+    ::Union{GI.LineTrait, GI.LineStringTrait}, l2,
+)::Bool

A linear ring and a line/linestring are equal if they share the same set of points going along the curve. Note that lines aren't closed by definition, but rings are, so the line must have a repeated last point to be equal

source

julia
equals(
+    ::GI.LinearRingTrait, l1,
+    ::GI.LinearRingTrait, l2,
+)::Bool

Two linear rings are equal if they share the same set of points going along the curve. Note that rings are closed by definition, so they can have, but don't need, a repeated last point to be equal.

source

julia
equals(::GI.PolygonTrait, geom_a, ::GI.PolygonTrait, geom_b)::Bool

Two polygons are equal if they share the same exterior edge and holes.

source

julia
equals(::GI.PolygonTrait, geom_a, ::GI.MultiPolygonTrait, geom_b)::Bool

A polygon and a multipolygon are equal if the multipolygon is composed of a single polygon that is equivalent to the given polygon.

source

julia
equals(::GI.MultiPolygonTrait, geom_a, ::GI.PolygonTrait, geom_b)::Bool

A polygon and a multipolygon are equal if the multipolygon is composed of a single polygon that is equivalent to the given polygon.

source

julia
equals(::GI.PolygonTrait, geom_a, ::GI.PolygonTrait, geom_b)::Bool

Two multipolygons are equal if they share the same set of polygons.

source

`,47))]),i("details",v,[i("summary",null,[s[42]||(s[42]=i("a",{id:"GeometryOps.centroid",href:"#GeometryOps.centroid"},[i("span",{class:"jlbinding"},"GeometryOps.centroid")],-1)),s[43]||(s[43]=e()),n(t,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[44]||(s[44]=a('
julia
centroid(geom, [T=Float64])::Tuple{T, T}

Returns the centroid of a given line segment, linear ring, polygon, or mutlipolygon.

source

',3))]),i("details",A,[i("summary",null,[s[45]||(s[45]=i("a",{id:"GeometryOps.distance",href:"#GeometryOps.distance"},[i("span",{class:"jlbinding"},"GeometryOps.distance")],-1)),s[46]||(s[46]=e()),n(t,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[47]||(s[47]=a('
julia
distance(point, geom, ::Type{T} = Float64)::T

Calculates the ditance from the geometry g1 to the point. The distance will always be positive or zero.

The method will differ based on the type of the geometry provided: - The distance from a point to a point is just the Euclidean distance between the points. - The distance from a point to a line is the minimum distance from the point to the closest point on the given line. - The distance from a point to a linestring is the minimum distance from the point to the closest segment of the linestring. - The distance from a point to a linear ring is the minimum distance from the point to the closest segment of the linear ring. - The distance from a point to a polygon is zero if the point is within the polygon and otherwise is the minimum distance from the point to an edge of the polygon. This includes edges created by holes. - The distance from a point to a multigeometry or a geometry collection is the minimum distance between the point and any of the sub-geometries.

Result will be of type T, where T is an optional argument with a default value of Float64.

source

',5))]),i("details",j,[i("summary",null,[s[48]||(s[48]=i("a",{id:"GeometryOps.signed_distance",href:"#GeometryOps.signed_distance"},[i("span",{class:"jlbinding"},"GeometryOps.signed_distance")],-1)),s[49]||(s[49]=e()),n(t,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[50]||(s[50]=a('
julia
signed_distance(point, geom, ::Type{T} = Float64)::T

Calculates the signed distance from the geometry geom to the given point. Points within geom have a negative signed distance, and points outside of geom have a positive signed distance. - The signed distance from a point to a point, line, linestring, or linear ring is equal to the distance between the two. - The signed distance from a point to a polygon is negative if the point is within the polygon and is positive otherwise. The value of the distance is the minimum distance from the point to an edge of the polygon. This includes edges created by holes. - The signed distance from a point to a multigeometry or a geometry collection is the minimum signed distance between the point and any of the sub-geometries.

Result will be of type T, where T is an optional argument with a default value of Float64.

source

',4))]),i("details",B,[i("summary",null,[s[51]||(s[51]=i("a",{id:"GeometryOps.area",href:"#GeometryOps.area"},[i("span",{class:"jlbinding"},"GeometryOps.area")],-1)),s[52]||(s[52]=e()),n(t,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[53]||(s[53]=a(`
julia
area(geom, [T = Float64])::T

Returns the area of a geometry or collection of geometries. This is computed slightly differently for different geometries:

- The area of a point/multipoint is always zero.
+- The area of a curve/multicurve is always zero.
+- The area of a polygon is the absolute value of the signed area.
+- The area multi-polygon is the sum of the areas of all of the sub-polygons.
+- The area of a geometry collection, feature collection of array/iterable 
+    is the sum of the areas of all of the sub-geometries.

Result will be of type T, where T is an optional argument with a default value of Float64.

source

`,5))]),i("details",O,[i("summary",null,[s[54]||(s[54]=i("a",{id:"GeometryOps.signed_area",href:"#GeometryOps.signed_area"},[i("span",{class:"jlbinding"},"GeometryOps.signed_area")],-1)),s[55]||(s[55]=e()),n(t,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[56]||(s[56]=a(`
julia
signed_area(geom, [T = Float64])::T

Returns the signed area of a single geometry, based on winding order. This is computed slightly differently for different geometries:

- The signed area of a point is always zero.
+- The signed area of a curve is always zero.
+- The signed area of a polygon is computed with the shoelace formula and is
+positive if the polygon coordinates wind clockwise and negative if
+counterclockwise.
+- You cannot compute the signed area of a multipolygon as it doesn't have a
+meaning as each sub-polygon could have a different winding order.

Result will be of type T, where T is an optional argument with a default value of Float64.

source

`,5))]),i("details",D,[i("summary",null,[s[57]||(s[57]=i("a",{id:"GeometryOps.angles",href:"#GeometryOps.angles"},[i("span",{class:"jlbinding"},"GeometryOps.angles")],-1)),s[58]||(s[58]=e()),n(t,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[59]||(s[59]=a(`
julia
angles(geom, ::Type{T} = Float64)

Returns the angles of a geometry or collection of geometries. This is computed differently for different geometries:

- The angles of a point is an empty vector.
+- The angles of a single line segment is an empty vector.
+- The angles of a linestring or linearring is a vector of angles formed by the curve.
+- The angles of a polygon is a vector of vectors of angles formed by each ring.
+- The angles of a multi-geometry collection is a vector of the angles of each of the
+    sub-geometries as defined above.

Result will be a Vector, or nested set of vectors, of type T where an optional argument with a default value of Float64.

source

`,5))]),i("details",Q,[i("summary",null,[s[60]||(s[60]=i("a",{id:"GeometryOps.embed_extent",href:"#GeometryOps.embed_extent"},[i("span",{class:"jlbinding"},"GeometryOps.embed_extent")],-1)),s[61]||(s[61]=e()),n(t,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[62]||(s[62]=a('
julia
embed_extent(obj)

Recursively wrap the object with a GeoInterface.jl geometry, calculating and adding an Extents.Extent to all objects.

This can improve performance when extents need to be checked multiple times, such when needing to check if many points are in geometries, and using their extents as a quick filter for obviously exterior points.

Keywords

  • threaded: true or false. Whether to use multithreading. Defaults to false.

  • crs: The CRS to attach to geometries. Defaults to nothing.

source

',6))]),s[322]||(s[322]=i("h2",{id:"Barycentric-coordinates",tabindex:"-1"},[e("Barycentric coordinates "),i("a",{class:"header-anchor",href:"#Barycentric-coordinates","aria-label":'Permalink to "Barycentric coordinates {#Barycentric-coordinates}"'},"​")],-1)),i("details",x,[i("summary",null,[s[63]||(s[63]=i("a",{id:"GeometryOps.barycentric_coordinates",href:"#GeometryOps.barycentric_coordinates"},[i("span",{class:"jlbinding"},"GeometryOps.barycentric_coordinates")],-1)),s[64]||(s[64]=e()),n(t,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[65]||(s[65]=a('
julia
barycentric_coordinates(method = MeanValue(), polygon, point)

Returns the barycentric coordinates of point in polygon using the barycentric coordinate method method.

source

',3))]),i("details",w,[i("summary",null,[s[66]||(s[66]=i("a",{id:"GeometryOps.barycentric_coordinates!",href:"#GeometryOps.barycentric_coordinates!"},[i("span",{class:"jlbinding"},"GeometryOps.barycentric_coordinates!")],-1)),s[67]||(s[67]=e()),n(t,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[68]||(s[68]=a('
julia
barycentric_coordinates!(λs::Vector{<: Real}, method::AbstractBarycentricCoordinateMethod, polygon, point)

Loads the barycentric coordinates of point in polygon into λs using the barycentric coordinate method method.

λs must be of the length of the polygon plus its holes.

Tip

Use this method to avoid excess allocations when you need to calculate barycentric coordinates for many points.

source

',5))]),i("details",L,[i("summary",null,[s[69]||(s[69]=i("a",{id:"GeometryOps.barycentric_interpolate",href:"#GeometryOps.barycentric_interpolate"},[i("span",{class:"jlbinding"},"GeometryOps.barycentric_interpolate")],-1)),s[70]||(s[70]=e()),n(t,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[71]||(s[71]=a('
julia
barycentric_interpolate(method = MeanValue(), polygon, values::AbstractVector{V}, point)

Returns the interpolated value at point within polygon using the barycentric coordinate method method. values are the per-point values for the polygon which are to be interpolated.

Returns an object of type V.

Warning

Barycentric interpolation is currently defined only for 2-dimensional polygons. If you pass a 3-D polygon in, the Z coordinate will be used as per-vertex value to be interpolated (the M coordinate in GIS parlance).

source

',5))]),s[323]||(s[323]=i("h2",{id:"Other-methods",tabindex:"-1"},[e("Other methods "),i("a",{class:"header-anchor",href:"#Other-methods","aria-label":'Permalink to "Other methods {#Other-methods}"'},"​")],-1)),i("details",I,[i("summary",null,[s[72]||(s[72]=i("a",{id:"GeometryOps.AbstractBarycentricCoordinateMethod",href:"#GeometryOps.AbstractBarycentricCoordinateMethod"},[i("span",{class:"jlbinding"},"GeometryOps.AbstractBarycentricCoordinateMethod")],-1)),s[73]||(s[73]=e()),n(t,{type:"info",class:"jlObjectType jlType",text:"Type"})]),s[74]||(s[74]=a('
julia
abstract type AbstractBarycentricCoordinateMethod

Abstract supertype for barycentric coordinate methods. The subtypes may serve as dispatch types, or may cache some information about the target polygon.

API

The following methods must be implemented for all subtypes:

  • barycentric_coordinates!(λs::Vector{<: Real}, method::AbstractBarycentricCoordinateMethod, exterior::Vector{<: Point{2, T1}}, point::Point{2, T2})

  • barycentric_interpolate(method::AbstractBarycentricCoordinateMethod, exterior::Vector{<: Point{2, T1}}, values::Vector{V}, point::Point{2, T2})::V

  • barycentric_interpolate(method::AbstractBarycentricCoordinateMethod, exterior::Vector{<: Point{2, T1}}, interiors::Vector{<: Vector{<: Point{2, T1}}} values::Vector{V}, point::Point{2, T2})::V

The rest of the methods will be implemented in terms of these, and have efficient dispatches for broadcasting.

source

',7))]),i("details",M,[i("summary",null,[s[75]||(s[75]=i("a",{id:"GeometryOps.ClosedRing",href:"#GeometryOps.ClosedRing"},[i("span",{class:"jlbinding"},"GeometryOps.ClosedRing")],-1)),s[76]||(s[76]=e()),n(t,{type:"info",class:"jlObjectType jlType",text:"Type"})]),s[77]||(s[77]=a('
julia
ClosedRing() <: GeometryCorrection

This correction ensures that a polygon's exterior and interior rings are closed.

It can be called on any geometry correction as usual.

See also GeometryCorrection.

source

',5))]),i("details",P,[i("summary",null,[s[78]||(s[78]=i("a",{id:"GeometryOps.DiffIntersectingPolygons",href:"#GeometryOps.DiffIntersectingPolygons"},[i("span",{class:"jlbinding"},"GeometryOps.DiffIntersectingPolygons")],-1)),s[79]||(s[79]=e()),n(t,{type:"info",class:"jlObjectType jlType",text:"Type"})]),s[80]||(s[80]=a('
julia
DiffIntersectingPolygons() <: GeometryCorrection

This correction ensures that the polygons included in a multipolygon aren't intersecting. If any polygon's are intersecting, they will be made nonintersecting through the difference operation to create a unique set of disjoint (other than potentially connections by a single point) polygons covering the same area. See also GeometryCorrection, UnionIntersectingPolygons.

source

',3))]),i("details",q,[i("summary",null,[s[81]||(s[81]=i("a",{id:"GeometryOps.DouglasPeucker",href:"#GeometryOps.DouglasPeucker"},[i("span",{class:"jlbinding"},"GeometryOps.DouglasPeucker")],-1)),s[82]||(s[82]=e()),n(t,{type:"info",class:"jlObjectType jlType",text:"Type"})]),s[83]||(s[83]=a(`
julia
DouglasPeucker <: SimplifyAlg
+
+DouglasPeucker(; number, ratio, tol)

Simplifies geometries by removing points below tol distance from the line between its neighboring points.

Keywords

  • ratio: the fraction of points that should remain after simplify. Useful as it will generalise for large collections of objects.

  • number: the number of points that should remain after simplify. Less useful for large collections of mixed size objects.

  • tol: the minimum distance a point will be from the line joining its neighboring points.

Note: user input tol is squared to avoid unnecessary computation in algorithm.

source

`,6))]),i("details",R,[i("summary",null,[s[84]||(s[84]=i("a",{id:"GeometryOps.GEOS",href:"#GeometryOps.GEOS"},[i("span",{class:"jlbinding"},"GeometryOps.GEOS")],-1)),s[85]||(s[85]=e()),n(t,{type:"info",class:"jlObjectType jlType",text:"Type"})]),s[86]||(s[86]=a('
julia
GEOS(; params...)

A struct which instructs the method it's passed to as an algorithm to use the appropriate GEOS function via LibGEOS.jl for the operation.

Dispatch is generally carried out using the names of the keyword arguments. For example, segmentize will only accept a GEOS struct with only a max_distance keyword, and no other.

It's generally a lot slower than the native Julia implementations, since it must convert to the LibGEOS implementation and back - so be warned!

source

',5))]),i("details",S,[i("summary",null,[s[87]||(s[87]=i("a",{id:"GeometryOps.GeodesicSegments",href:"#GeometryOps.GeodesicSegments"},[i("span",{class:"jlbinding"},"GeometryOps.GeodesicSegments")],-1)),s[88]||(s[88]=e()),n(t,{type:"info",class:"jlObjectType jlType",text:"Type"})]),s[89]||(s[89]=a('
julia
GeodesicSegments(; max_distance::Real, equatorial_radius::Real=6378137, flattening::Real=1/298.257223563)

A method for segmentizing geometries by adding extra vertices to the geometry so that no segment is longer than a given distance. This method calculates the distance between points on the geodesic, and assumes input in lat/long coordinates.

Warning

Any input geometries must be in lon/lat coordinates! If not, the method may fail or error.

Arguments

  • max_distance::Real: The maximum distance, in meters, between vertices in the geometry.

  • equatorial_radius::Real=6378137: The equatorial radius of the Earth, in meters. Passed to Proj.geod_geodesic.

  • flattening::Real=1/298.257223563: The flattening of the Earth, which is the ratio of the difference between the equatorial and polar radii to the equatorial radius. Passed to Proj.geod_geodesic.

One can also omit the equatorial_radius and flattening keyword arguments, and pass a geodesic object directly to the eponymous keyword.

This method uses the Proj/GeographicLib API for geodesic calculations.

source

',8))]),i("details",V,[i("summary",null,[s[90]||(s[90]=i("a",{id:"GeometryOps.GeometryCorrection",href:"#GeometryOps.GeometryCorrection"},[i("span",{class:"jlbinding"},"GeometryOps.GeometryCorrection")],-1)),s[91]||(s[91]=e()),n(t,{type:"info",class:"jlObjectType jlType",text:"Type"})]),s[92]||(s[92]=a('
julia
abstract type GeometryCorrection

This abstract type represents a geometry correction.

Interface

Any GeometryCorrection must implement two functions: * application_level(::GeometryCorrection)::AbstractGeometryTrait: This function should return the GeoInterface trait that the correction is intended to be applied to, like PointTrait or LineStringTrait or PolygonTrait. * (::GeometryCorrection)(::AbstractGeometryTrait, geometry)::(some_geometry): This function should apply the correction to the given geometry, and return a new geometry.

source

',5))]),i("details",J,[i("summary",null,[s[93]||(s[93]=i("a",{id:"GeometryOps.LineOrientation",href:"#GeometryOps.LineOrientation"},[i("span",{class:"jlbinding"},"GeometryOps.LineOrientation")],-1)),s[94]||(s[94]=e()),n(t,{type:"info",class:"jlObjectType jlType",text:"Type"})]),s[95]||(s[95]=a('
julia
Enum LineOrientation

Enum for the orientation of a line with respect to a curve. A line can be line_cross (crossing over the curve), line_hinge (crossing the endpoint of the curve), line_over (collinear with the curve), or line_out (not interacting with the curve).

source

',3))]),i("details",U,[i("summary",null,[s[96]||(s[96]=i("a",{id:"GeometryOps.LinearSegments",href:"#GeometryOps.LinearSegments"},[i("span",{class:"jlbinding"},"GeometryOps.LinearSegments")],-1)),s[97]||(s[97]=e()),n(t,{type:"info",class:"jlObjectType jlType",text:"Type"})]),s[98]||(s[98]=a('
julia
LinearSegments(; max_distance::Real)

A method for segmentizing geometries by adding extra vertices to the geometry so that no segment is longer than a given distance.

Here, max_distance is a purely nondimensional quantity and will apply in the input space. This is to say, that if the polygon is provided in lat/lon coordinates then the max_distance will be in degrees of arc. If the polygon is provided in meters, then the max_distance will be in meters.

source

',4))]),i("details",H,[i("summary",null,[s[99]||(s[99]=i("a",{id:"GeometryOps.MeanValue",href:"#GeometryOps.MeanValue"},[i("span",{class:"jlbinding"},"GeometryOps.MeanValue")],-1)),s[100]||(s[100]=e()),n(t,{type:"info",class:"jlObjectType jlType",text:"Type"})]),s[101]||(s[101]=a('
julia
MeanValue() <: AbstractBarycentricCoordinateMethod

This method calculates barycentric coordinates using the mean value method.

References

source

',4))]),i("details",N,[i("summary",null,[s[102]||(s[102]=i("a",{id:"GeometryOps.MonotoneChainMethod",href:"#GeometryOps.MonotoneChainMethod"},[i("span",{class:"jlbinding"},"GeometryOps.MonotoneChainMethod")],-1)),s[103]||(s[103]=e()),n(t,{type:"info",class:"jlObjectType jlType",text:"Type"})]),s[104]||(s[104]=a('
julia
MonotoneChainMethod()

This is an algorithm for the convex_hull function.

Uses DelaunayTriangulation.jl to compute the convex hull. This is a pure Julia algorithm which provides an optimal Delaunay triangulation.

See also convex_hull

source

',5))]),i("details",W,[i("summary",null,[s[105]||(s[105]=i("a",{id:"GeometryOps.PointOrientation",href:"#GeometryOps.PointOrientation"},[i("span",{class:"jlbinding"},"GeometryOps.PointOrientation")],-1)),s[106]||(s[106]=e()),n(t,{type:"info",class:"jlObjectType jlType",text:"Type"})]),s[107]||(s[107]=a('
julia
Enum PointOrientation

Enum for the orientation of a point with respect to a curve. A point can be point_in the curve, point_on the curve, or point_out of the curve.

source

',3))]),i("details",z,[i("summary",null,[s[108]||(s[108]=i("a",{id:"GeometryOps.RadialDistance",href:"#GeometryOps.RadialDistance"},[i("span",{class:"jlbinding"},"GeometryOps.RadialDistance")],-1)),s[109]||(s[109]=e()),n(t,{type:"info",class:"jlObjectType jlType",text:"Type"})]),s[110]||(s[110]=a('
julia
RadialDistance <: SimplifyAlg

Simplifies geometries by removing points less than tol distance from the line between its neighboring points.

Keywords

  • ratio: the fraction of points that should remain after simplify. Useful as it will generalise for large collections of objects.

  • number: the number of points that should remain after simplify. Less useful for large collections of mixed size objects.

  • tol: the minimum distance between points.

Note: user input tol is squared to avoid unnecessary computation in algorithm.

source

',6))]),i("details",Z,[i("summary",null,[s[111]||(s[111]=i("a",{id:"GeometryOps.SimplifyAlg",href:"#GeometryOps.SimplifyAlg"},[i("span",{class:"jlbinding"},"GeometryOps.SimplifyAlg")],-1)),s[112]||(s[112]=e()),n(t,{type:"info",class:"jlObjectType jlType",text:"Type"})]),s[113]||(s[113]=a('
julia
abstract type SimplifyAlg

Abstract type for simplification algorithms.

API

For now, the algorithm must hold the number, ratio and tol properties.

Simplification algorithm types can hook into the interface by implementing the _simplify(trait, alg, geom) methods for whichever traits are necessary.

source

',6))]),i("details",_,[i("summary",null,[s[114]||(s[114]=i("a",{id:"GeometryOps.UnionIntersectingPolygons",href:"#GeometryOps.UnionIntersectingPolygons"},[i("span",{class:"jlbinding"},"GeometryOps.UnionIntersectingPolygons")],-1)),s[115]||(s[115]=e()),n(t,{type:"info",class:"jlObjectType jlType",text:"Type"})]),s[116]||(s[116]=a('
julia
UnionIntersectingPolygons() <: GeometryCorrection

This correction ensures that the polygon's included in a multipolygon aren't intersecting. If any polygon's are intersecting, they will be combined through the union operation to create a unique set of disjoint (other than potentially connections by a single point) polygons covering the same area.

See also GeometryCorrection.

source

',4))]),i("details",K,[i("summary",null,[s[117]||(s[117]=i("a",{id:"GeometryOps.VisvalingamWhyatt",href:"#GeometryOps.VisvalingamWhyatt"},[i("span",{class:"jlbinding"},"GeometryOps.VisvalingamWhyatt")],-1)),s[118]||(s[118]=e()),n(t,{type:"info",class:"jlObjectType jlType",text:"Type"})]),s[119]||(s[119]=a(`
julia
VisvalingamWhyatt <: SimplifyAlg
+
+VisvalingamWhyatt(; kw...)

Simplifies geometries by removing points below tol distance from the line between its neighboring points.

Keywords

  • ratio: the fraction of points that should remain after simplify. Useful as it will generalise for large collections of objects.

  • number: the number of points that should remain after simplify. Less useful for large collections of mixed size objects.

  • tol: the minimum area of a triangle made with a point and its neighboring points.

Note: user input tol is doubled to avoid unnecessary computation in algorithm.

source

`,6))]),i("details",X,[i("summary",null,[s[120]||(s[120]=i("a",{id:"GeometryOps._det-Union{Tuple{T2}, Tuple{T1}, Tuple{Union{Tuple{T1, T1}, StaticArraysCore.StaticArray{Tuple{2}, T1, 1}}, Union{Tuple{T2, T2}, StaticArraysCore.StaticArray{Tuple{2}, T2, 1}}}} where {T1<:Real, T2<:Real}",href:"#GeometryOps._det-Union{Tuple{T2}, Tuple{T1}, Tuple{Union{Tuple{T1, T1}, StaticArraysCore.StaticArray{Tuple{2}, T1, 1}}, Union{Tuple{T2, T2}, StaticArraysCore.StaticArray{Tuple{2}, T2, 1}}}} where {T1<:Real, T2<:Real}"},[i("span",{class:"jlbinding"},"GeometryOps._det")],-1)),s[121]||(s[121]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[122]||(s[122]=a('
julia
_det(s1::Point2{T1}, s2::Point2{T2}) where {T1 <: Real, T2 <: Real}

Returns the determinant of the matrix formed by hcat'ing two points s1 and s2.

Specifically, this is:

julia
s1[1] * s2[2] - s1[2] * s2[1]

source

',5))]),i("details",$,[i("summary",null,[s[123]||(s[123]=i("a",{id:"GeometryOps._equals_curves-NTuple{4, Any}",href:"#GeometryOps._equals_curves-NTuple{4, Any}"},[i("span",{class:"jlbinding"},"GeometryOps._equals_curves")],-1)),s[124]||(s[124]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[125]||(s[125]=a('
julia
_equals_curves(c1, c2, closed_type1, closed_type2)::Bool

Two curves are equal if they share the same set of point, representing the same geometry. Both curves must must be composed of the same set of points, however, they do not have to wind in the same direction, or start on the same point to be equivalent. Inputs: c1 first geometry c2 second geometry closed_type1::Bool true if c1 is closed by definition (polygon, linear ring) closed_type2::Bool true if c2 is closed by definition (polygon, linear ring)

source

',3))]),i("details",Y,[i("summary",null,[s[126]||(s[126]=i("a",{id:"GeometryOps.angles-Union{Tuple{Any}, Tuple{T}, Tuple{Any, Type{T}}} where T<:AbstractFloat",href:"#GeometryOps.angles-Union{Tuple{Any}, Tuple{T}, Tuple{Any, Type{T}}} where T<:AbstractFloat"},[i("span",{class:"jlbinding"},"GeometryOps.angles")],-1)),s[127]||(s[127]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[128]||(s[128]=a(`
julia
angles(geom, ::Type{T} = Float64)

Returns the angles of a geometry or collection of geometries. This is computed differently for different geometries:

- The angles of a point is an empty vector.
+- The angles of a single line segment is an empty vector.
+- The angles of a linestring or linearring is a vector of angles formed by the curve.
+- The angles of a polygon is a vector of vectors of angles formed by each ring.
+- The angles of a multi-geometry collection is a vector of the angles of each of the
+    sub-geometries as defined above.

Result will be a Vector, or nested set of vectors, of type T where an optional argument with a default value of Float64.

source

`,5))]),i("details",ss,[i("summary",null,[s[129]||(s[129]=i("a",{id:"GeometryOps.area-Union{Tuple{Any}, Tuple{T}, Tuple{Any, Type{T}}} where T<:AbstractFloat",href:"#GeometryOps.area-Union{Tuple{Any}, Tuple{T}, Tuple{Any, Type{T}}} where T<:AbstractFloat"},[i("span",{class:"jlbinding"},"GeometryOps.area")],-1)),s[130]||(s[130]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[131]||(s[131]=a(`
julia
area(geom, [T = Float64])::T

Returns the area of a geometry or collection of geometries. This is computed slightly differently for different geometries:

- The area of a point/multipoint is always zero.
+- The area of a curve/multicurve is always zero.
+- The area of a polygon is the absolute value of the signed area.
+- The area multi-polygon is the sum of the areas of all of the sub-polygons.
+- The area of a geometry collection, feature collection of array/iterable 
+    is the sum of the areas of all of the sub-geometries.

Result will be of type T, where T is an optional argument with a default value of Float64.

source

`,5))]),i("details",is,[i("summary",null,[s[132]||(s[132]=i("a",{id:"GeometryOps.barycentric_coordinates!-Tuple{Vector{<:Real}, GeometryOps.AbstractBarycentricCoordinateMethod, Any, Any}",href:"#GeometryOps.barycentric_coordinates!-Tuple{Vector{<:Real}, GeometryOps.AbstractBarycentricCoordinateMethod, Any, Any}"},[i("span",{class:"jlbinding"},"GeometryOps.barycentric_coordinates!")],-1)),s[133]||(s[133]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[134]||(s[134]=a('
julia
barycentric_coordinates!(λs::Vector{<: Real}, method::AbstractBarycentricCoordinateMethod, polygon, point)

Loads the barycentric coordinates of point in polygon into λs using the barycentric coordinate method method.

λs must be of the length of the polygon plus its holes.

Tip

Use this method to avoid excess allocations when you need to calculate barycentric coordinates for many points.

source

',5))]),i("details",as,[i("summary",null,[s[135]||(s[135]=i("a",{id:"GeometryOps.barycentric_coordinates-Tuple{GeometryOps.AbstractBarycentricCoordinateMethod, Any, Any}",href:"#GeometryOps.barycentric_coordinates-Tuple{GeometryOps.AbstractBarycentricCoordinateMethod, Any, Any}"},[i("span",{class:"jlbinding"},"GeometryOps.barycentric_coordinates")],-1)),s[136]||(s[136]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[137]||(s[137]=a('
julia
barycentric_coordinates(method = MeanValue(), polygon, point)

Returns the barycentric coordinates of point in polygon using the barycentric coordinate method method.

source

',3))]),i("details",es,[i("summary",null,[s[138]||(s[138]=i("a",{id:"GeometryOps.barycentric_interpolate-Union{Tuple{V}, Tuple{GeometryOps.AbstractBarycentricCoordinateMethod, Any, AbstractVector{V}, Any}} where V",href:"#GeometryOps.barycentric_interpolate-Union{Tuple{V}, Tuple{GeometryOps.AbstractBarycentricCoordinateMethod, Any, AbstractVector{V}, Any}} where V"},[i("span",{class:"jlbinding"},"GeometryOps.barycentric_interpolate")],-1)),s[139]||(s[139]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[140]||(s[140]=a('
julia
barycentric_interpolate(method = MeanValue(), polygon, values::AbstractVector{V}, point)

Returns the interpolated value at point within polygon using the barycentric coordinate method method. values are the per-point values for the polygon which are to be interpolated.

Returns an object of type V.

Warning

Barycentric interpolation is currently defined only for 2-dimensional polygons. If you pass a 3-D polygon in, the Z coordinate will be used as per-vertex value to be interpolated (the M coordinate in GIS parlance).

source

',5))]),i("details",ts,[i("summary",null,[s[141]||(s[141]=i("a",{id:"GeometryOps.centroid-Union{Tuple{Any}, Tuple{T}, Tuple{Any, Type{T}}} where T",href:"#GeometryOps.centroid-Union{Tuple{Any}, Tuple{T}, Tuple{Any, Type{T}}} where T"},[i("span",{class:"jlbinding"},"GeometryOps.centroid")],-1)),s[142]||(s[142]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[143]||(s[143]=a('
julia
centroid(geom, [T=Float64])::Tuple{T, T}

Returns the centroid of a given line segment, linear ring, polygon, or mutlipolygon.

source

',3))]),i("details",ns,[i("summary",null,[s[144]||(s[144]=i("a",{id:"GeometryOps.centroid_and_area-Union{Tuple{Any}, Tuple{T}, Tuple{Any, Type{T}}} where T",href:"#GeometryOps.centroid_and_area-Union{Tuple{Any}, Tuple{T}, Tuple{Any, Type{T}}} where T"},[i("span",{class:"jlbinding"},"GeometryOps.centroid_and_area")],-1)),s[145]||(s[145]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[146]||(s[146]=a('
julia
centroid_and_area(geom, [T=Float64])::(::Tuple{T, T}, ::Real)

Returns the centroid and area of a given geometry.

source

',3))]),i("details",ls,[i("summary",null,[s[147]||(s[147]=i("a",{id:"GeometryOps.centroid_and_length-Union{Tuple{Any}, Tuple{T}, Tuple{Any, Type{T}}} where T",href:"#GeometryOps.centroid_and_length-Union{Tuple{Any}, Tuple{T}, Tuple{Any, Type{T}}} where T"},[i("span",{class:"jlbinding"},"GeometryOps.centroid_and_length")],-1)),s[148]||(s[148]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[149]||(s[149]=a('
julia
centroid_and_length(geom, [T=Float64])::(::Tuple{T, T}, ::Real)

Returns the centroid and length of a given line/ring. Note this is only valid for line strings and linear rings.

source

',3))]),i("details",ps,[i("summary",null,[s[150]||(s[150]=i("a",{id:"GeometryOps.contains-Tuple{Any, Any}",href:"#GeometryOps.contains-Tuple{Any, Any}"},[i("span",{class:"jlbinding"},"GeometryOps.contains")],-1)),s[151]||(s[151]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[152]||(s[152]=a(`
julia
contains(g1::AbstractGeometry, g2::AbstractGeometry)::Bool

Return true if the second geometry is completely contained by the first geometry. The interiors of both geometries must intersect and the interior and boundary of the secondary (g2) must not intersect the exterior of the first (g1).

contains returns the exact opposite result of within.

Examples

julia
import GeometryOps as GO, GeoInterface as GI
+line = GI.LineString([(1, 1), (1, 2), (1, 3), (1, 4)])
+point = GI.Point((1, 2))
+
+GO.contains(line, point)
+# output
+true

source

`,6))]),i("details",hs,[i("summary",null,[s[153]||(s[153]=i("a",{id:"GeometryOps.convex_hull",href:"#GeometryOps.convex_hull"},[i("span",{class:"jlbinding"},"GeometryOps.convex_hull")],-1)),s[154]||(s[154]=e()),n(t,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[155]||(s[155]=a('
julia
convex_hull([method], geometries)

Compute the convex hull of the points in geometries. Returns a GI.Polygon representing the convex hull.

Note that the polygon returned is wound counterclockwise as in the Simple Features standard by default. If you choose GEOS, the winding order will be inverted.

Warning

This interface only computes the 2-dimensional convex hull!

For higher dimensional hulls, use the relevant package (Qhull.jl, Quickhull.jl, or similar).

source

',5))]),i("details",ks,[i("summary",null,[s[156]||(s[156]=i("a",{id:"GeometryOps.coverage-Union{Tuple{T}, NTuple{5, Any}, Tuple{Any, Any, Any, Any, Any, Type{T}}} where T<:AbstractFloat",href:"#GeometryOps.coverage-Union{Tuple{T}, NTuple{5, Any}, Tuple{Any, Any, Any, Any, Any, Type{T}}} where T<:AbstractFloat"},[i("span",{class:"jlbinding"},"GeometryOps.coverage")],-1)),s[157]||(s[157]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[158]||(s[158]=a('
julia
coverage(geom, xmin, xmax, ymin, ymax, [T = Float64])::T

Returns the area of intersection between given geometry and grid cell defined by its minimum and maximum x and y-values. This is computed differently for different geometries:

  • The signed area of a point is always zero.

  • The signed area of a curve is always zero.

  • The signed area of a polygon is calculated by tracing along its edges and switching to the cell edges if needed.

  • The coverage of a geometry collection, multi-geometry, feature collection of array/iterable is the sum of the coverages of all of the sub-geometries.

Result will be of type T, where T is an optional argument with a default value of Float64.

source

',5))]),i("details",rs,[i("summary",null,[s[159]||(s[159]=i("a",{id:"GeometryOps.coveredby-Tuple{Any, Any}",href:"#GeometryOps.coveredby-Tuple{Any, Any}"},[i("span",{class:"jlbinding"},"GeometryOps.coveredby")],-1)),s[160]||(s[160]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[161]||(s[161]=a(`
julia
coveredby(g1, g2)::Bool

Return true if the first geometry is completely covered by the second geometry. The interior and boundary of the primary geometry (g1) must not intersect the exterior of the secondary geometry (g2).

Furthermore, coveredby returns the exact opposite result of covers. They are equivalent with the order of the arguments swapped.

Examples

julia
import GeometryOps as GO, GeoInterface as GI
+p1 = GI.Point(0.0, 0.0)
+p2 = GI.Point(1.0, 1.0)
+l1 = GI.Line([p1, p2])
+
+GO.coveredby(p1, l1)
+# output
+true

source

`,6))]),i("details",os,[i("summary",null,[s[162]||(s[162]=i("a",{id:"GeometryOps.covers-Tuple{Any, Any}",href:"#GeometryOps.covers-Tuple{Any, Any}"},[i("span",{class:"jlbinding"},"GeometryOps.covers")],-1)),s[163]||(s[163]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[164]||(s[164]=a(`
julia
covers(g1::AbstractGeometry, g2::AbstractGeometry)::Bool

Return true if the first geometry is completely covers the second geometry, The exterior and boundary of the second geometry must not be outside of the interior and boundary of the first geometry. However, the interiors need not intersect.

covers returns the exact opposite result of coveredby.

Examples

julia
import GeometryOps as GO, GeoInterface as GI
+l1 = GI.LineString([(1.0, 1.0), (1.0, 2.0), (1.0, 3.0), (1.0, 4.0)])
+l2 = GI.LineString([(1.0, 1.0), (1.0, 2.0)])
+
+GO.covers(l1, l2)
+# output
+true

source

`,6))]),i("details",ds,[i("summary",null,[s[165]||(s[165]=i("a",{id:"GeometryOps.crosses-Tuple{Any, Any}",href:"#GeometryOps.crosses-Tuple{Any, Any}"},[i("span",{class:"jlbinding"},"GeometryOps.crosses")],-1)),s[166]||(s[166]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[167]||(s[167]=a(`
julia
 crosses(geom1, geom2)::Bool

Return true if the intersection results in a geometry whose dimension is one less than the maximum dimension of the two source geometries and the intersection set is interior to both source geometries.

TODO: broken

Examples

julia
import GeoInterface as GI, GeometryOps as GO
+# TODO: Add working example

source

`,6))]),i("details",gs,[i("summary",null,[s[168]||(s[168]=i("a",{id:"GeometryOps.cut-Union{Tuple{T}, Tuple{Any, Any}, Tuple{Any, Any, Type{T}}} where T<:AbstractFloat",href:"#GeometryOps.cut-Union{Tuple{T}, Tuple{Any, Any}, Tuple{Any, Any, Type{T}}} where T<:AbstractFloat"},[i("span",{class:"jlbinding"},"GeometryOps.cut")],-1)),s[169]||(s[169]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[170]||(s[170]=a(`
julia
cut(geom, line, [T::Type])

Return given geom cut by given line as a list of geometries of the same type as the input geom. Return the original geometry as only list element if none are found. Line must cut fully through given geometry or the original geometry will be returned.

Note: This currently doesn't work for degenerate cases there line crosses through vertices.

Example

julia
import GeoInterface as GI, GeometryOps as GO
+
+poly = GI.Polygon([[(0.0, 0.0), (10.0, 0.0), (10.0, 10.0), (0.0, 10.0), (0.0, 0.0)]])
+line = GI.Line([(5.0, -5.0), (5.0, 15.0)])
+cut_polys = GO.cut(poly, line)
+GI.coordinates.(cut_polys)
+
+# output
+2-element Vector{Vector{Vector{Vector{Float64}}}}:
+ [[[0.0, 0.0], [5.0, 0.0], [5.0, 10.0], [0.0, 10.0], [0.0, 0.0]]]
+ [[[5.0, 0.0], [10.0, 0.0], [10.0, 10.0], [5.0, 10.0], [5.0, 0.0]]]

source

`,6))]),i("details",ys,[i("summary",null,[s[171]||(s[171]=i("a",{id:"GeometryOps.difference-Union{Tuple{T}, Tuple{Any, Any}, Tuple{Any, Any, Type{T}}} where T<:AbstractFloat",href:"#GeometryOps.difference-Union{Tuple{T}, Tuple{Any, Any}, Tuple{Any, Any, Type{T}}} where T<:AbstractFloat"},[i("span",{class:"jlbinding"},"GeometryOps.difference")],-1)),s[172]||(s[172]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[173]||(s[173]=a(`
julia
difference(geom_a, geom_b, [T::Type]; target::Type, fix_multipoly = UnionIntersectingPolygons())

Return the difference between two geometries as a list of geometries. Return an empty list if none are found. The type of the list will be constrained as much as possible given the input geometries. Furthermore, the user can provide a taget type as a keyword argument and a list of target geometries found in the difference will be returned. The user can also provide a float type that they would like the points of returned geometries to be. If the user is taking a intersection involving one or more multipolygons, and the multipolygon might be comprised of polygons that intersect, if fix_multipoly is set to an IntersectingPolygons correction (the default is UnionIntersectingPolygons()), then the needed multipolygons will be fixed to be valid before performing the intersection to ensure a correct answer. Only set fix_multipoly to false if you know that the multipolygons are valid, as it will avoid unneeded computation.

Example

julia
import GeoInterface as GI, GeometryOps as GO
+
+poly1 = GI.Polygon([[[0.0, 0.0], [5.0, 5.0], [10.0, 0.0], [5.0, -5.0], [0.0, 0.0]]])
+poly2 = GI.Polygon([[[3.0, 0.0], [8.0, 5.0], [13.0, 0.0], [8.0, -5.0], [3.0, 0.0]]])
+diff_poly = GO.difference(poly1, poly2; target = GI.PolygonTrait())
+GI.coordinates.(diff_poly)
+
+# output
+1-element Vector{Vector{Vector{Vector{Float64}}}}:
+ [[[6.5, 3.5], [5.0, 5.0], [0.0, 0.0], [5.0, -5.0], [6.5, -3.5], [3.0, 0.0], [6.5, 3.5]]]

source

`,5))]),i("details",Es,[i("summary",null,[s[174]||(s[174]=i("a",{id:"GeometryOps.disjoint-Tuple{Any, Any}",href:"#GeometryOps.disjoint-Tuple{Any, Any}"},[i("span",{class:"jlbinding"},"GeometryOps.disjoint")],-1)),s[175]||(s[175]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[176]||(s[176]=a(`
julia
disjoint(geom1, geom2)::Bool

Return true if the first geometry is disjoint from the second geometry.

Return true if the first geometry is disjoint from the second geometry. The interiors and boundaries of both geometries must not intersect.

Examples

julia
import GeometryOps as GO, GeoInterface as GI
+
+line = GI.LineString([(1, 1), (1, 2), (1, 3), (1, 4)])
+point = (2, 2)
+GO.disjoint(point, line)
+
+# output
+true

source

`,6))]),i("details",cs,[i("summary",null,[s[177]||(s[177]=i("a",{id:"GeometryOps.distance-Union{Tuple{T}, Tuple{Any, Any}, Tuple{Any, Any, Type{T}}} where T<:AbstractFloat",href:"#GeometryOps.distance-Union{Tuple{T}, Tuple{Any, Any}, Tuple{Any, Any, Type{T}}} where T<:AbstractFloat"},[i("span",{class:"jlbinding"},"GeometryOps.distance")],-1)),s[178]||(s[178]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[179]||(s[179]=a('
julia
distance(point, geom, ::Type{T} = Float64)::T

Calculates the ditance from the geometry g1 to the point. The distance will always be positive or zero.

The method will differ based on the type of the geometry provided: - The distance from a point to a point is just the Euclidean distance between the points. - The distance from a point to a line is the minimum distance from the point to the closest point on the given line. - The distance from a point to a linestring is the minimum distance from the point to the closest segment of the linestring. - The distance from a point to a linear ring is the minimum distance from the point to the closest segment of the linear ring. - The distance from a point to a polygon is zero if the point is within the polygon and otherwise is the minimum distance from the point to an edge of the polygon. This includes edges created by holes. - The distance from a point to a multigeometry or a geometry collection is the minimum distance between the point and any of the sub-geometries.

Result will be of type T, where T is an optional argument with a default value of Float64.

source

',5))]),i("details",us,[i("summary",null,[s[180]||(s[180]=i("a",{id:"GeometryOps.embed_extent-Tuple{Any}",href:"#GeometryOps.embed_extent-Tuple{Any}"},[i("span",{class:"jlbinding"},"GeometryOps.embed_extent")],-1)),s[181]||(s[181]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[182]||(s[182]=a('
julia
embed_extent(obj)

Recursively wrap the object with a GeoInterface.jl geometry, calculating and adding an Extents.Extent to all objects.

This can improve performance when extents need to be checked multiple times, such when needing to check if many points are in geometries, and using their extents as a quick filter for obviously exterior points.

Keywords

  • threaded: true or false. Whether to use multithreading. Defaults to false.

  • crs: The CRS to attach to geometries. Defaults to nothing.

source

',6))]),i("details",ms,[i("summary",null,[s[183]||(s[183]=i("a",{id:"GeometryOps.enforce-Tuple{GEOS, Symbol, Any}",href:"#GeometryOps.enforce-Tuple{GEOS, Symbol, Any}"},[i("span",{class:"jlbinding"},"GeometryOps.enforce")],-1)),s[184]||(s[184]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[185]||(s[185]=a('
julia
enforce(alg::GO.GEOS, kw::Symbol, f)

Enforce the presence of a keyword argument in a GEOS algorithm, and return alg.params[kw].

Throws an error if the key is not present, and mentions f in the error message (since there isn't a good way to get the name of the function that called this method).

source

',4))]),i("details",Fs,[i("summary",null,[s[186]||(s[186]=i("a",{id:"GeometryOps.equals-NTuple{4, Any}",href:"#GeometryOps.equals-NTuple{4, Any}"},[i("span",{class:"jlbinding"},"GeometryOps.equals")],-1)),s[187]||(s[187]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[188]||(s[188]=a('
julia
equals(trait_a, geom_a, trait_b, geom_b)

Two geometries which are not of the same type cannot be equal so they always return false.

source

',3))]),i("details",Cs,[i("summary",null,[s[189]||(s[189]=i("a",{id:"GeometryOps.equals-Tuple{Any, Any}",href:"#GeometryOps.equals-Tuple{Any, Any}"},[i("span",{class:"jlbinding"},"GeometryOps.equals")],-1)),s[190]||(s[190]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[191]||(s[191]=a(`
julia
equals(geom1, geom2)::Bool

Compare two Geometries return true if they are the same geometry.

Examples

julia
import GeometryOps as GO, GeoInterface as GI
+poly1 = GI.Polygon([[(0,0), (0,5), (5,5), (5,0), (0,0)]])
+poly2 = GI.Polygon([[(0,0), (0,5), (5,5), (5,0), (0,0)]])
+
+GO.equals(poly1, poly2)
+# output
+true

source

`,5))]),i("details",bs,[i("summary",null,[s[192]||(s[192]=i("a",{id:"GeometryOps.equals-Tuple{GeoInterface.LinearRingTrait, Any, GeoInterface.LinearRingTrait, Any}",href:"#GeometryOps.equals-Tuple{GeoInterface.LinearRingTrait, Any, GeoInterface.LinearRingTrait, Any}"},[i("span",{class:"jlbinding"},"GeometryOps.equals")],-1)),s[193]||(s[193]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[194]||(s[194]=a(`
julia
equals(
+    ::GI.LinearRingTrait, l1,
+    ::GI.LinearRingTrait, l2,
+)::Bool

Two linear rings are equal if they share the same set of points going along the curve. Note that rings are closed by definition, so they can have, but don't need, a repeated last point to be equal.

source

`,3))]),i("details",fs,[i("summary",null,[s[195]||(s[195]=i("a",{id:"GeometryOps.equals-Tuple{GeoInterface.LinearRingTrait, Any, Union{GeoInterface.LineStringTrait, GeoInterface.LineTrait}, Any}",href:"#GeometryOps.equals-Tuple{GeoInterface.LinearRingTrait, Any, Union{GeoInterface.LineStringTrait, GeoInterface.LineTrait}, Any}"},[i("span",{class:"jlbinding"},"GeometryOps.equals")],-1)),s[196]||(s[196]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[197]||(s[197]=a(`
julia
equals(
+    ::GI.LinearRingTrait, l1,
+    ::Union{GI.LineTrait, GI.LineStringTrait}, l2,
+)::Bool

A linear ring and a line/linestring are equal if they share the same set of points going along the curve. Note that lines aren't closed by definition, but rings are, so the line must have a repeated last point to be equal

source

`,3))]),i("details",Ts,[i("summary",null,[s[198]||(s[198]=i("a",{id:"GeometryOps.equals-Tuple{GeoInterface.MultiPointTrait, Any, GeoInterface.MultiPointTrait, Any}",href:"#GeometryOps.equals-Tuple{GeoInterface.MultiPointTrait, Any, GeoInterface.MultiPointTrait, Any}"},[i("span",{class:"jlbinding"},"GeometryOps.equals")],-1)),s[199]||(s[199]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[200]||(s[200]=a('
julia
equals(::GI.MultiPointTrait, mp1, ::GI.MultiPointTrait, mp2)::Bool

Two multipoints are equal if they share the same set of points.

source

',3))]),i("details",Gs,[i("summary",null,[s[201]||(s[201]=i("a",{id:"GeometryOps.equals-Tuple{GeoInterface.MultiPointTrait, Any, GeoInterface.PointTrait, Any}",href:"#GeometryOps.equals-Tuple{GeoInterface.MultiPointTrait, Any, GeoInterface.PointTrait, Any}"},[i("span",{class:"jlbinding"},"GeometryOps.equals")],-1)),s[202]||(s[202]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[203]||(s[203]=a('
julia
equals(::GI.MultiPointTrait, mp1, ::GI.PointTrait, p2)::Bool

A point and a multipoint are equal if the multipoint is composed of a single point that is equivalent to the given point.

source

',3))]),i("details",vs,[i("summary",null,[s[204]||(s[204]=i("a",{id:"GeometryOps.equals-Tuple{GeoInterface.MultiPolygonTrait, Any, GeoInterface.MultiPolygonTrait, Any}",href:"#GeometryOps.equals-Tuple{GeoInterface.MultiPolygonTrait, Any, GeoInterface.MultiPolygonTrait, Any}"},[i("span",{class:"jlbinding"},"GeometryOps.equals")],-1)),s[205]||(s[205]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[206]||(s[206]=a('
julia
equals(::GI.PolygonTrait, geom_a, ::GI.PolygonTrait, geom_b)::Bool

Two multipolygons are equal if they share the same set of polygons.

source

',3))]),i("details",As,[i("summary",null,[s[207]||(s[207]=i("a",{id:"GeometryOps.equals-Tuple{GeoInterface.MultiPolygonTrait, Any, GeoInterface.PolygonTrait, Any}",href:"#GeometryOps.equals-Tuple{GeoInterface.MultiPolygonTrait, Any, GeoInterface.PolygonTrait, Any}"},[i("span",{class:"jlbinding"},"GeometryOps.equals")],-1)),s[208]||(s[208]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[209]||(s[209]=a('
julia
equals(::GI.MultiPolygonTrait, geom_a, ::GI.PolygonTrait, geom_b)::Bool

A polygon and a multipolygon are equal if the multipolygon is composed of a single polygon that is equivalent to the given polygon.

source

',3))]),i("details",js,[i("summary",null,[s[210]||(s[210]=i("a",{id:"GeometryOps.equals-Tuple{GeoInterface.PointTrait, Any, GeoInterface.MultiPointTrait, Any}",href:"#GeometryOps.equals-Tuple{GeoInterface.PointTrait, Any, GeoInterface.MultiPointTrait, Any}"},[i("span",{class:"jlbinding"},"GeometryOps.equals")],-1)),s[211]||(s[211]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[212]||(s[212]=a('
julia
equals(::GI.PointTrait, p1, ::GI.MultiPointTrait, mp2)::Bool

A point and a multipoint are equal if the multipoint is composed of a single point that is equivalent to the given point.

source

',3))]),i("details",Bs,[i("summary",null,[s[213]||(s[213]=i("a",{id:"GeometryOps.equals-Tuple{GeoInterface.PointTrait, Any, GeoInterface.PointTrait, Any}",href:"#GeometryOps.equals-Tuple{GeoInterface.PointTrait, Any, GeoInterface.PointTrait, Any}"},[i("span",{class:"jlbinding"},"GeometryOps.equals")],-1)),s[214]||(s[214]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[215]||(s[215]=a('
julia
equals(::GI.PointTrait, p1, ::GI.PointTrait, p2)::Bool

Two points are the same if they have the same x and y (and z if 3D) coordinates.

source

',3))]),i("details",Os,[i("summary",null,[s[216]||(s[216]=i("a",{id:"GeometryOps.equals-Tuple{GeoInterface.PolygonTrait, Any, GeoInterface.MultiPolygonTrait, Any}",href:"#GeometryOps.equals-Tuple{GeoInterface.PolygonTrait, Any, GeoInterface.MultiPolygonTrait, Any}"},[i("span",{class:"jlbinding"},"GeometryOps.equals")],-1)),s[217]||(s[217]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[218]||(s[218]=a('
julia
equals(::GI.PolygonTrait, geom_a, ::GI.MultiPolygonTrait, geom_b)::Bool

A polygon and a multipolygon are equal if the multipolygon is composed of a single polygon that is equivalent to the given polygon.

source

',3))]),i("details",Ds,[i("summary",null,[s[219]||(s[219]=i("a",{id:"GeometryOps.equals-Tuple{GeoInterface.PolygonTrait, Any, GeoInterface.PolygonTrait, Any}",href:"#GeometryOps.equals-Tuple{GeoInterface.PolygonTrait, Any, GeoInterface.PolygonTrait, Any}"},[i("span",{class:"jlbinding"},"GeometryOps.equals")],-1)),s[220]||(s[220]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[221]||(s[221]=a('
julia
equals(::GI.PolygonTrait, geom_a, ::GI.PolygonTrait, geom_b)::Bool

Two polygons are equal if they share the same exterior edge and holes.

source

',3))]),i("details",Qs,[i("summary",null,[s[222]||(s[222]=i("a",{id:"GeometryOps.equals-Tuple{Union{GeoInterface.LineStringTrait, GeoInterface.LineTrait}, Any, GeoInterface.LinearRingTrait, Any}",href:"#GeometryOps.equals-Tuple{Union{GeoInterface.LineStringTrait, GeoInterface.LineTrait}, Any, GeoInterface.LinearRingTrait, Any}"},[i("span",{class:"jlbinding"},"GeometryOps.equals")],-1)),s[223]||(s[223]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[224]||(s[224]=a(`
julia
equals(
+    ::Union{GI.LineTrait, GI.LineStringTrait}, l1,
+    ::GI.LinearRingTrait, l2,
+)::Bool

A line/linestring and a linear ring are equal if they share the same set of points going along the curve. Note that lines aren't closed by definition, but rings are, so the line must have a repeated last point to be equal

source

`,3))]),i("details",xs,[i("summary",null,[s[225]||(s[225]=i("a",{id:"GeometryOps.equals-Tuple{Union{GeoInterface.LineStringTrait, GeoInterface.LineTrait}, Any, Union{GeoInterface.LineStringTrait, GeoInterface.LineTrait}, Any}",href:"#GeometryOps.equals-Tuple{Union{GeoInterface.LineStringTrait, GeoInterface.LineTrait}, Any, Union{GeoInterface.LineStringTrait, GeoInterface.LineTrait}, Any}"},[i("span",{class:"jlbinding"},"GeometryOps.equals")],-1)),s[226]||(s[226]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[227]||(s[227]=a(`
julia
equals(
+    ::Union{GI.LineTrait, GI.LineStringTrait}, l1,
+    ::Union{GI.LineTrait, GI.LineStringTrait}, l2,
+)::Bool

Two lines/linestrings are equal if they share the same set of points going along the curve. Note that lines/linestrings aren't closed by definition.

source

`,3))]),i("details",ws,[i("summary",null,[s[228]||(s[228]=i("a",{id:"GeometryOps.equals-Union{Tuple{T}, Tuple{T, Any, T, Any}} where T",href:"#GeometryOps.equals-Union{Tuple{T}, Tuple{T, Any, T, Any}} where T"},[i("span",{class:"jlbinding"},"GeometryOps.equals")],-1)),s[229]||(s[229]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[230]||(s[230]=a('
julia
equals(::T, geom_a, ::T, geom_b)::Bool

Two geometries of the same type, which don't have a equals function to dispatch off of should throw an error.

source

',3))]),i("details",Ls,[i("summary",null,[s[231]||(s[231]=i("a",{id:"GeometryOps.flip-Tuple{Any}",href:"#GeometryOps.flip-Tuple{Any}"},[i("span",{class:"jlbinding"},"GeometryOps.flip")],-1)),s[232]||(s[232]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[233]||(s[233]=a('
julia
flip(obj)

Swap all of the x and y coordinates in obj, otherwise keeping the original structure (but not necessarily the original type).

Keywords

  • threaded: true or false. Whether to use multithreading. Defaults to false.

  • crs: The CRS to attach to geometries. Defaults to nothing.

  • calc_extent: true or false. Whether to calculate the extent. Defaults to false.

source

',5))]),i("details",Is,[i("summary",null,[s[234]||(s[234]=i("a",{id:"GeometryOps.intersection-Union{Tuple{T}, Tuple{Any, Any}, Tuple{Any, Any, Type{T}}} where T<:AbstractFloat",href:"#GeometryOps.intersection-Union{Tuple{T}, Tuple{Any, Any}, Tuple{Any, Any, Type{T}}} where T<:AbstractFloat"},[i("span",{class:"jlbinding"},"GeometryOps.intersection")],-1)),s[235]||(s[235]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[236]||(s[236]=a(`
julia
intersection(geom_a, geom_b, [T::Type]; target::Type, fix_multipoly = UnionIntersectingPolygons())

Return the intersection between two geometries as a list of geometries. Return an empty list if none are found. The type of the list will be constrained as much as possible given the input geometries. Furthermore, the user can provide a target type as a keyword argument and a list of target geometries found in the intersection will be returned. The user can also provide a float type that they would like the points of returned geometries to be. If the user is taking a intersection involving one or more multipolygons, and the multipolygon might be comprised of polygons that intersect, if fix_multipoly is set to an IntersectingPolygons correction (the default is UnionIntersectingPolygons()), then the needed multipolygons will be fixed to be valid before performing the intersection to ensure a correct answer. Only set fix_multipoly to nothing if you know that the multipolygons are valid, as it will avoid unneeded computation.

Example

julia
import GeoInterface as GI, GeometryOps as GO
+
+line1 = GI.Line([(124.584961,-12.768946), (126.738281,-17.224758)])
+line2 = GI.Line([(123.354492,-15.961329), (127.22168,-14.008696)])
+inter_points = GO.intersection(line1, line2; target = GI.PointTrait())
+GI.coordinates.(inter_points)
+
+# output
+1-element Vector{Vector{Float64}}:
+ [125.58375366067548, -14.83572303404496]

source

`,5))]),i("details",Ms,[i("summary",null,[s[237]||(s[237]=i("a",{id:"GeometryOps.intersection_points-Union{Tuple{T}, Tuple{Any, Any}, Tuple{Any, Any, Type{T}}} where T<:AbstractFloat",href:"#GeometryOps.intersection_points-Union{Tuple{T}, Tuple{Any, Any}, Tuple{Any, Any, Type{T}}} where T<:AbstractFloat"},[i("span",{class:"jlbinding"},"GeometryOps.intersection_points")],-1)),s[238]||(s[238]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[239]||(s[239]=a(`
julia
intersection_points(geom_a, geom_b, [T::Type])

Return a list of intersection tuple points between two geometries. If no intersection points exist, returns an empty list.

Example

jldoctest

+line1 = GI.Line([(124.584961,-12.768946), (126.738281,-17.224758)]) line2 = GI.Line([(123.354492,-15.961329), (127.22168,-14.008696)]) inter_points = GO.intersection_points(line1, line2)
+
+**output**
+
+1-element Vector{Tuple{Float64, Float64}}:  (125.58375366067548, -14.83572303404496)
+
+
+[source](https://github.com/JuliaGeo/GeometryOps.jl/blob/347821afdac1a9ec607aa2939464014c8ef54b3d/src/methods/clipping/intersection.jl#L177-L195)
+
+</details>
+
+<details class='jldocstring custom-block' open>
+<summary><a id='GeometryOps.intersects-Tuple{Any, Any}' href='#GeometryOps.intersects-Tuple{Any, Any}'><span class="jlbinding">GeometryOps.intersects</span></a> <Badge type="info" class="jlObjectType jlMethod" text="Method" /></summary>
+
+
+
+\`\`\`julia
+intersects(geom1, geom2)::Bool

Return true if the interiors or boundaries of the two geometries interact.

intersects returns the exact opposite result of disjoint.

Example

julia
import GeoInterface as GI, GeometryOps as GO
+
+line1 = GI.Line([(124.584961,-12.768946), (126.738281,-17.224758)])
+line2 = GI.Line([(123.354492,-15.961329), (127.22168,-14.008696)])
+GO.intersects(line1, line2)
+
+# output
+true

source

`,9))]),i("details",Ps,[i("summary",null,[s[240]||(s[240]=i("a",{id:"GeometryOps.isclockwise-Tuple{Any}",href:"#GeometryOps.isclockwise-Tuple{Any}"},[i("span",{class:"jlbinding"},"GeometryOps.isclockwise")],-1)),s[241]||(s[241]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[244]||(s[244]=a('
julia
isclockwise(line::Union{LineString, Vector{Position}})::Bool

Take a ring and return true if the line goes clockwise, or false if the line goes counter-clockwise. "Going clockwise" means, mathematically,

',2)),i("mjx-container",qs,[(p(),l("svg",Rs,s[242]||(s[242]=[a('',1)]))),s[243]||(s[243]=i("mjx-assistive-mml",{unselectable:"on",display:"block",style:{top:"0px",left:"0px",clip:"rect(1px, 1px, 1px, 1px)","-webkit-touch-callout":"none","-webkit-user-select":"none","-khtml-user-select":"none","-moz-user-select":"none","-ms-user-select":"none","user-select":"none",position:"absolute",padding:"1px 0px 0px 0px",border:"0px",display:"block",overflow:"hidden",width:"100%"}},[i("math",{xmlns:"http://www.w3.org/1998/Math/MathML",display:"block"},[i("mrow",{"data-mjx-texclass":"INNER"},[i("mo",{"data-mjx-texclass":"OPEN"},"("),i("munderover",null,[i("mo",{"data-mjx-texclass":"OP"},"∑"),i("mrow",{"data-mjx-texclass":"ORD"},[i("mi",null,"i"),i("mo",null,"="),i("mn",null,"2")]),i("mi",null,"n")]),i("mo",{stretchy:"false"},"("),i("msub",null,[i("mi",null,"x"),i("mi",null,"i")]),i("mo",null,"−"),i("msub",null,[i("mi",null,"x"),i("mrow",{"data-mjx-texclass":"ORD"},[i("mi",null,"i"),i("mo",null,"−"),i("mn",null,"1")])]),i("mo",{stretchy:"false"},")"),i("mo",null,"⋅"),i("mo",{stretchy:"false"},"("),i("msub",null,[i("mi",null,"y"),i("mi",null,"i")]),i("mo",null,"+"),i("msub",null,[i("mi",null,"y"),i("mrow",{"data-mjx-texclass":"ORD"},[i("mi",null,"i"),i("mo",null,"−"),i("mn",null,"1")])]),i("mo",{stretchy:"false"},")"),i("mo",{"data-mjx-texclass":"CLOSE"},")")]),i("mo",null,">"),i("mn",null,"0")])],-1))]),s[245]||(s[245]=a(`

Example

julia
julia> import GeoInterface as GI, GeometryOps as GO
+julia> ring = GI.LinearRing([(0, 0), (1, 1), (1, 0), (0, 0)]);
+julia> GO.isclockwise(ring)
+# output
+true

source

`,3))]),i("details",Ss,[i("summary",null,[s[246]||(s[246]=i("a",{id:"GeometryOps.isconcave-Tuple{Any}",href:"#GeometryOps.isconcave-Tuple{Any}"},[i("span",{class:"jlbinding"},"GeometryOps.isconcave")],-1)),s[247]||(s[247]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[248]||(s[248]=a(`
julia
isconcave(poly::Polygon)::Bool

Take a polygon and return true or false as to whether it is concave or not.

Examples

julia
import GeoInterface as GI, GeometryOps as GO
+
+poly = GI.Polygon([[(0, 0), (0, 1), (1, 1), (1, 0), (0, 0)]])
+GO.isconcave(poly)
+
+# output
+false

source

`,5))]),i("details",Vs,[i("summary",null,[s[249]||(s[249]=i("a",{id:"GeometryOps.overlaps-Tuple{Any, Any}",href:"#GeometryOps.overlaps-Tuple{Any, Any}"},[i("span",{class:"jlbinding"},"GeometryOps.overlaps")],-1)),s[250]||(s[250]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[251]||(s[251]=a(`
julia
overlaps(geom1, geom2)::Bool

Compare two Geometries of the same dimension and return true if their intersection set results in a geometry different from both but of the same dimension. This means one geometry cannot be within or contain the other and they cannot be equal

Examples

julia
import GeometryOps as GO, GeoInterface as GI
+poly1 = GI.Polygon([[(0,0), (0,5), (5,5), (5,0), (0,0)]])
+poly2 = GI.Polygon([[(1,1), (1,6), (6,6), (6,1), (1,1)]])
+
+GO.overlaps(poly1, poly2)
+# output
+true

source

`,5))]),i("details",Js,[i("summary",null,[s[252]||(s[252]=i("a",{id:"GeometryOps.overlaps-Tuple{GeoInterface.AbstractTrait, Any, GeoInterface.AbstractTrait, Any}",href:"#GeometryOps.overlaps-Tuple{GeoInterface.AbstractTrait, Any, GeoInterface.AbstractTrait, Any}"},[i("span",{class:"jlbinding"},"GeometryOps.overlaps")],-1)),s[253]||(s[253]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[254]||(s[254]=a('
julia
overlaps(::GI.AbstractTrait, geom1, ::GI.AbstractTrait, geom2)::Bool

For any non-specified pair, all have non-matching dimensions, return false.

source

',3))]),i("details",Us,[i("summary",null,[s[255]||(s[255]=i("a",{id:"GeometryOps.overlaps-Tuple{GeoInterface.LineTrait, Any, GeoInterface.LineTrait, Any}",href:"#GeometryOps.overlaps-Tuple{GeoInterface.LineTrait, Any, GeoInterface.LineTrait, Any}"},[i("span",{class:"jlbinding"},"GeometryOps.overlaps")],-1)),s[256]||(s[256]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[257]||(s[257]=a('
julia
overlaps(::GI.LineTrait, line1, ::GI.LineTrait, line)::Bool

If the lines overlap, meaning that they are collinear but each have one endpoint outside of the other line, return true. Else false.

source

',3))]),i("details",Hs,[i("summary",null,[s[258]||(s[258]=i("a",{id:"GeometryOps.overlaps-Tuple{GeoInterface.MultiPointTrait, Any, GeoInterface.MultiPointTrait, Any}",href:"#GeometryOps.overlaps-Tuple{GeoInterface.MultiPointTrait, Any, GeoInterface.MultiPointTrait, Any}"},[i("span",{class:"jlbinding"},"GeometryOps.overlaps")],-1)),s[259]||(s[259]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[260]||(s[260]=a(`
julia
overlaps(
+    ::GI.MultiPointTrait, points1,
+    ::GI.MultiPointTrait, points2,
+)::Bool

If the multipoints overlap, meaning some, but not all, of the points within the multipoints are shared, return true.

source

`,3))]),i("details",Ns,[i("summary",null,[s[261]||(s[261]=i("a",{id:"GeometryOps.overlaps-Tuple{GeoInterface.MultiPolygonTrait, Any, GeoInterface.MultiPolygonTrait, Any}",href:"#GeometryOps.overlaps-Tuple{GeoInterface.MultiPolygonTrait, Any, GeoInterface.MultiPolygonTrait, Any}"},[i("span",{class:"jlbinding"},"GeometryOps.overlaps")],-1)),s[262]||(s[262]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[263]||(s[263]=a(`
julia
overlaps(
+    ::GI.MultiPolygonTrait, polys1,
+    ::GI.MultiPolygonTrait, polys2,
+)::Bool

Return true if at least one pair of polygons from multipolygons overlap. Else false.

source

`,3))]),i("details",Ws,[i("summary",null,[s[264]||(s[264]=i("a",{id:"GeometryOps.overlaps-Tuple{GeoInterface.MultiPolygonTrait, Any, GeoInterface.PolygonTrait, Any}",href:"#GeometryOps.overlaps-Tuple{GeoInterface.MultiPolygonTrait, Any, GeoInterface.PolygonTrait, Any}"},[i("span",{class:"jlbinding"},"GeometryOps.overlaps")],-1)),s[265]||(s[265]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[266]||(s[266]=a(`
julia
overlaps(
+    ::GI.MultiPolygonTrait, polys1,
+    ::GI.PolygonTrait, poly2,
+)::Bool

Return true if polygon overlaps with at least one of the polygons within the multipolygon. Else false.

source

`,3))]),i("details",zs,[i("summary",null,[s[267]||(s[267]=i("a",{id:"GeometryOps.overlaps-Tuple{GeoInterface.PolygonTrait, Any, GeoInterface.MultiPolygonTrait, Any}",href:"#GeometryOps.overlaps-Tuple{GeoInterface.PolygonTrait, Any, GeoInterface.MultiPolygonTrait, Any}"},[i("span",{class:"jlbinding"},"GeometryOps.overlaps")],-1)),s[268]||(s[268]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[269]||(s[269]=a(`
julia
overlaps(
+    ::GI.PolygonTrait, poly1,
+    ::GI.MultiPolygonTrait, polys2,
+)::Bool

Return true if polygon overlaps with at least one of the polygons within the multipolygon. Else false.

source

`,3))]),i("details",Zs,[i("summary",null,[s[270]||(s[270]=i("a",{id:"GeometryOps.overlaps-Tuple{GeoInterface.PolygonTrait, Any, GeoInterface.PolygonTrait, Any}",href:"#GeometryOps.overlaps-Tuple{GeoInterface.PolygonTrait, Any, GeoInterface.PolygonTrait, Any}"},[i("span",{class:"jlbinding"},"GeometryOps.overlaps")],-1)),s[271]||(s[271]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[272]||(s[272]=a(`
julia
overlaps(
+    trait_a::GI.PolygonTrait, poly_a,
+    trait_b::GI.PolygonTrait, poly_b,
+)::Bool

If the two polygons intersect with one another, but are not equal, return true. Else false.

source

`,3))]),i("details",_s,[i("summary",null,[s[273]||(s[273]=i("a",{id:"GeometryOps.overlaps-Tuple{Union{GeoInterface.LineStringTrait, GeoInterface.Wrappers.LinearRing}, Any, Union{GeoInterface.LineStringTrait, GeoInterface.Wrappers.LinearRing}, Any}",href:"#GeometryOps.overlaps-Tuple{Union{GeoInterface.LineStringTrait, GeoInterface.Wrappers.LinearRing}, Any, Union{GeoInterface.LineStringTrait, GeoInterface.Wrappers.LinearRing}, Any}"},[i("span",{class:"jlbinding"},"GeometryOps.overlaps")],-1)),s[274]||(s[274]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[275]||(s[275]=a(`
julia
overlaps(
+    ::Union{GI.LineStringTrait, GI.LinearRing}, line1,
+    ::Union{GI.LineStringTrait, GI.LinearRing}, line2,
+)::Bool

If the curves overlap, meaning that at least one edge of each curve overlaps, return true. Else false.

source

`,3))]),i("details",Ks,[i("summary",null,[s[276]||(s[276]=i("a",{id:"GeometryOps.polygon_to_line-Tuple{Any}",href:"#GeometryOps.polygon_to_line-Tuple{Any}"},[i("span",{class:"jlbinding"},"GeometryOps.polygon_to_line")],-1)),s[277]||(s[277]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[278]||(s[278]=a(`
julia
polygon_to_line(poly::Polygon)

Converts a Polygon to LineString or MultiLineString

Examples

julia
import GeometryOps as GO, GeoInterface as GI
+
+poly = GI.Polygon([[(-2.275543, 53.464547), (-2.275543, 53.489271), (-2.215118, 53.489271), (-2.215118, 53.464547), (-2.275543, 53.464547)]])
+GO.polygon_to_line(poly)
+# output
+GeoInterface.Wrappers.LineString{false, false, Vector{Tuple{Float64, Float64}}, Nothing, Nothing}([(-2.275543, 53.464547), (-2.275543, 53.489271), (-2.215118, 53.489271), (-2.215118, 53.464547), (-2.275543, 53.464547)], nothing, nothing)

source

`,5))]),i("details",Xs,[i("summary",null,[s[279]||(s[279]=i("a",{id:"GeometryOps.polygonize-Tuple{AbstractMatrix{Bool}}",href:"#GeometryOps.polygonize-Tuple{AbstractMatrix{Bool}}"},[i("span",{class:"jlbinding"},"GeometryOps.polygonize")],-1)),s[280]||(s[280]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[281]||(s[281]=a(`
julia
polygonize(A::AbstractMatrix{Bool}; kw...)
+polygonize(f, A::AbstractMatrix; kw...)
+polygonize(xs, ys, A::AbstractMatrix{Bool}; kw...)
+polygonize(f, xs, ys, A::AbstractMatrix; kw...)

Polygonize an AbstractMatrix of values, currently to a single class of polygons.

Returns a MultiPolygon for Bool values and f return values, and a FeatureCollection of Features holding MultiPolygon for all other values.

Function f should return either true or false or a transformation of values into simpler groups, especially useful for floating point arrays.

If xs and ys are ranges, they are used as the pixel/cell center points. If they are Vector of Tuple they are used as the lower and upper bounds of each pixel/cell.

Keywords

  • minpoints: ignore polygons with less than minpoints points.

  • values: the values to turn into polygons. By default these are union(A), If function f is passed these refer to the return values of f, by default union(map(f, A). If values Bool, false is ignored and a single MultiPolygon is returned rather than a FeatureCollection.

Example

julia
using GeometryOps
+A = rand(100, 100)
+multipolygon = polygonize(>(0.5), A);

source

`,10))]),i("details",$s,[i("summary",null,[s[282]||(s[282]=i("a",{id:"GeometryOps.segmentize-Tuple{Any}",href:"#GeometryOps.segmentize-Tuple{Any}"},[i("span",{class:"jlbinding"},"GeometryOps.segmentize")],-1)),s[283]||(s[283]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[284]||(s[284]=a('
julia
segmentize([method = Planar()], geom; max_distance::Real, threaded)

Segmentize a geometry by adding extra vertices to the geometry so that no segment is longer than a given distance. This is useful for plotting geometries with a limited number of vertices, or for ensuring that a geometry is not too "coarse" for a given application.

Arguments

  • method::Manifold = Planar(): The method to use for segmentizing the geometry. At the moment, only Planar (assumes a flat plane) and Geodesic (assumes geometry on the ellipsoidal Earth and uses Vincenty's formulae) are available.

  • geom: The geometry to segmentize. Must be a LineString, LinearRing, Polygon, MultiPolygon, or GeometryCollection, or some vector or table of those.

  • max_distance::Real: The maximum distance between vertices in the geometry. Beware: for Planar, this is in the units of the geometry, but for Geodesic and Spherical it's in units of the radius of the sphere.

Returns a geometry of similar type to the input geometry, but resampled.

source

',6))]),i("details",Ys,[i("summary",null,[s[285]||(s[285]=i("a",{id:"GeometryOps.signed_area-Union{Tuple{Any}, Tuple{T}, Tuple{Any, Type{T}}} where T<:AbstractFloat",href:"#GeometryOps.signed_area-Union{Tuple{Any}, Tuple{T}, Tuple{Any, Type{T}}} where T<:AbstractFloat"},[i("span",{class:"jlbinding"},"GeometryOps.signed_area")],-1)),s[286]||(s[286]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[287]||(s[287]=a(`
julia
signed_area(geom, [T = Float64])::T

Returns the signed area of a single geometry, based on winding order. This is computed slightly differently for different geometries:

- The signed area of a point is always zero.
+- The signed area of a curve is always zero.
+- The signed area of a polygon is computed with the shoelace formula and is
+positive if the polygon coordinates wind clockwise and negative if
+counterclockwise.
+- You cannot compute the signed area of a multipolygon as it doesn't have a
+meaning as each sub-polygon could have a different winding order.

Result will be of type T, where T is an optional argument with a default value of Float64.

source

`,5))]),i("details",si,[i("summary",null,[s[288]||(s[288]=i("a",{id:"GeometryOps.signed_distance-Union{Tuple{T}, Tuple{Any, Any}, Tuple{Any, Any, Type{T}}} where T<:AbstractFloat",href:"#GeometryOps.signed_distance-Union{Tuple{T}, Tuple{Any, Any}, Tuple{Any, Any, Type{T}}} where T<:AbstractFloat"},[i("span",{class:"jlbinding"},"GeometryOps.signed_distance")],-1)),s[289]||(s[289]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[290]||(s[290]=a('
julia
signed_distance(point, geom, ::Type{T} = Float64)::T

Calculates the signed distance from the geometry geom to the given point. Points within geom have a negative signed distance, and points outside of geom have a positive signed distance. - The signed distance from a point to a point, line, linestring, or linear ring is equal to the distance between the two. - The signed distance from a point to a polygon is negative if the point is within the polygon and is positive otherwise. The value of the distance is the minimum distance from the point to an edge of the polygon. This includes edges created by holes. - The signed distance from a point to a multigeometry or a geometry collection is the minimum signed distance between the point and any of the sub-geometries.

Result will be of type T, where T is an optional argument with a default value of Float64.

source

',4))]),i("details",ii,[i("summary",null,[s[291]||(s[291]=i("a",{id:"GeometryOps.simplify-Tuple{GeometryOps.SimplifyAlg, Any}",href:"#GeometryOps.simplify-Tuple{GeometryOps.SimplifyAlg, Any}"},[i("span",{class:"jlbinding"},"GeometryOps.simplify")],-1)),s[292]||(s[292]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[293]||(s[293]=a(`
julia
simplify(obj; kw...)
+simplify(::SimplifyAlg, obj; kw...)

Simplify a geometry, feature, feature collection, or nested vectors or a table of these.

RadialDistance, DouglasPeucker, or VisvalingamWhyatt algorithms are available, listed in order of increasing quality but decreasing performance.

PoinTrait and MultiPointTrait are returned unchanged.

The default behaviour is simplify(DouglasPeucker(; kw...), obj). Pass in other SimplifyAlg to use other algorithms.

Keywords

  • prefilter_alg: SimplifyAlg algorithm used to pre-filter object before using primary filtering algorithm.

  • threaded: true or false. Whether to use multithreading. Defaults to false.

  • crs: The CRS to attach to geometries. Defaults to nothing.

  • calc_extent: true or false. Whether to calculate the extent. Defaults to false.

Keywords for DouglasPeucker are allowed when no algorithm is specified:

Keywords

  • ratio: the fraction of points that should remain after simplify. Useful as it will generalise for large collections of objects.

  • number: the number of points that should remain after simplify. Less useful for large collections of mixed size objects.

  • tol: the minimum distance a point will be from the line joining its neighboring points.

Example

Simplify a polygon to have six points:

julia
import GeoInterface as GI
+import GeometryOps as GO
+
+poly = GI.Polygon([[
+    [-70.603637, -33.399918],
+    [-70.614624, -33.395332],
+    [-70.639343, -33.392466],
+    [-70.659942, -33.394759],
+    [-70.683975, -33.404504],
+    [-70.697021, -33.419406],
+    [-70.701141, -33.434306],
+    [-70.700454, -33.446339],
+    [-70.694274, -33.458369],
+    [-70.682601, -33.465816],
+    [-70.668869, -33.472117],
+    [-70.646209, -33.473835],
+    [-70.624923, -33.472117],
+    [-70.609817, -33.468107],
+    [-70.595397, -33.458369],
+    [-70.587158, -33.442901],
+    [-70.587158, -33.426283],
+    [-70.590591, -33.414248],
+    [-70.594711, -33.406224],
+    [-70.603637, -33.399918]]])
+
+simple = GO.simplify(poly; number=6)
+GI.npoint(simple)
+
+# output
+6

source

`,14))]),i("details",ai,[i("summary",null,[s[294]||(s[294]=i("a",{id:"GeometryOps.t_value-Union{Tuple{T2}, Tuple{T1}, Tuple{N}, Tuple{Union{NTuple{N, T1}, StaticArraysCore.StaticArray{Tuple{N}, T1, 1}}, Union{NTuple{N, T1}, StaticArraysCore.StaticArray{Tuple{N}, T1, 1}}, T2, T2}} where {N, T1<:Real, T2<:Real}",href:"#GeometryOps.t_value-Union{Tuple{T2}, Tuple{T1}, Tuple{N}, Tuple{Union{NTuple{N, T1}, StaticArraysCore.StaticArray{Tuple{N}, T1, 1}}, Union{NTuple{N, T1}, StaticArraysCore.StaticArray{Tuple{N}, T1, 1}}, T2, T2}} where {N, T1<:Real, T2<:Real}"},[i("span",{class:"jlbinding"},"GeometryOps.t_value")],-1)),s[295]||(s[295]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[298]||(s[298]=a('
julia
t_value(sᵢ, sᵢ₊₁, rᵢ, rᵢ₊₁)

Returns the "T-value" as described in Hormann's presentation [1] on how to calculate the mean-value coordinate.

Here, sᵢ is the vector from vertex vᵢ to the point, and rᵢ is the norm (length) of sᵢ. s must be Point and r must be real numbers.

',3)),i("mjx-container",ei,[(p(),l("svg",ti,s[296]||(s[296]=[a('',1)]))),s[297]||(s[297]=i("mjx-assistive-mml",{unselectable:"on",display:"block",style:{top:"0px",left:"0px",clip:"rect(1px, 1px, 1px, 1px)","-webkit-touch-callout":"none","-webkit-user-select":"none","-khtml-user-select":"none","-moz-user-select":"none","-ms-user-select":"none","user-select":"none",position:"absolute",padding:"1px 0px 0px 0px",border:"0px",display:"block",overflow:"hidden",width:"100%"}},[i("math",{xmlns:"http://www.w3.org/1998/Math/MathML",display:"block"},[i("mi",null,"t"),i("mi",null,"ᵢ"),i("mo",null,"="),i("mfrac",null,[i("mrow",null,[i("mrow",{"data-mjx-texclass":"ORD"},[i("mi",{"data-mjx-auto-op":"false"},"det")]),i("mrow",{"data-mjx-texclass":"INNER"},[i("mo",{"data-mjx-texclass":"OPEN"},"("),i("mi",null,"s"),i("mi",null,"ᵢ"),i("mo",null,","),i("mi",null,"s"),i("mi",null,"ᵢ"),i("mrow",{"data-mjx-texclass":"ORD"},[i("mo",{"data-mjx-pseudoscript":"true"},"₊")]),i("mrow",{"data-mjx-texclass":"ORD"},[i("mo",{"data-mjx-pseudoscript":"true"},"₁")]),i("mo",{"data-mjx-texclass":"CLOSE"},")")])]),i("mrow",null,[i("mi",null,"r"),i("mi",null,"ᵢ"),i("mo",null,"∗"),i("mi",null,"r"),i("mi",null,"ᵢ"),i("mrow",{"data-mjx-texclass":"ORD"},[i("mo",{"data-mjx-pseudoscript":"true"},"₊")]),i("mrow",{"data-mjx-texclass":"ORD"},[i("mo",{"data-mjx-pseudoscript":"true"},"₁")]),i("mo",null,"+"),i("mi",null,"s"),i("mi",null,"ᵢ"),i("mo",null,"⋅"),i("mi",null,"s"),i("mi",null,"ᵢ"),i("mrow",{"data-mjx-texclass":"ORD"},[i("mo",{"data-mjx-pseudoscript":"true"},"₊")]),i("mrow",{"data-mjx-texclass":"ORD"},[i("mo",{"data-mjx-pseudoscript":"true"},"₁")])])])])],-1))]),s[299]||(s[299]=a(`

+
+[source](https://github.com/JuliaGeo/GeometryOps.jl/blob/347821afdac1a9ec607aa2939464014c8ef54b3d/src/methods/barycentric.jl#L289-L305)
+
+</details>
+
+<details class='jldocstring custom-block' open>
+<summary><a id='GeometryOps.to_edges-Union{Tuple{Any}, Tuple{T}, Tuple{Any, Type{T}}} where T' href='#GeometryOps.to_edges-Union{Tuple{Any}, Tuple{T}, Tuple{Any, Type{T}}} where T'><span class="jlbinding">GeometryOps.to_edges</span></a> <Badge type="info" class="jlObjectType jlMethod" text="Method" /></summary>
+
+
+
+\`\`\`julia
+to_edges()

Convert any geometry or collection of geometries into a flat vector of Tuple{Tuple{Float64,Float64},Tuple{Float64,Float64}} edges.

source

`,3))]),i("details",ni,[i("summary",null,[s[300]||(s[300]=i("a",{id:"GeometryOps.touches-Tuple{Any, Any}",href:"#GeometryOps.touches-Tuple{Any, Any}"},[i("span",{class:"jlbinding"},"GeometryOps.touches")],-1)),s[301]||(s[301]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[302]||(s[302]=a(`
julia
touches(geom1, geom2)::Bool

Return true if the first geometry touches the second geometry. In other words, the two interiors cannot interact, but one of the geometries must have a boundary point that interacts with either the other geometry's interior or boundary.

Examples

julia
import GeometryOps as GO, GeoInterface as GI
+
+l1 = GI.Line([(0.0, 0.0), (1.0, 0.0)])
+l2 = GI.Line([(1.0, 1.0), (1.0, -1.0)])
+
+GO.touches(l1, l2)
+# output
+true

source

`,5))]),i("details",li,[i("summary",null,[s[303]||(s[303]=i("a",{id:"GeometryOps.transform-Tuple{Any, Any}",href:"#GeometryOps.transform-Tuple{Any, Any}"},[i("span",{class:"jlbinding"},"GeometryOps.transform")],-1)),s[304]||(s[304]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[305]||(s[305]=a(`
julia
transform(f, obj)

Apply a function f to all the points in obj.

Points will be passed to f as an SVector to allow using CoordinateTransformations.jl and Rotations.jl without hassle.

SVector is also a valid GeoInterface.jl point, so will work in all GeoInterface.jl methods.

Example

julia
julia> import GeoInterface as GI
+
+julia> import GeometryOps as GO
+
+julia> geom = GI.Polygon([GI.LinearRing([(1, 2), (3, 4), (5, 6), (1, 2)]), GI.LinearRing([(3, 4), (5, 6), (6, 7), (3, 4)])]);
+
+julia> f = CoordinateTransformations.Translation(3.5, 1.5)
+Translation(3.5, 1.5)
+
+julia> GO.transform(f, geom)
+GeoInterface.Wrappers.Polygon{false, false, Vector{GeoInterface.Wrappers.LinearRing{false, false, Vector{StaticArraysCore.SVector{2, Float64}}, Nothing, Nothing}}, Nothing, Nothing}(GeoInterface.Wrappers.Linea
+rRing{false, false, Vector{StaticArraysCore.SVector{2, Float64}}, Nothing, Nothing}[GeoInterface.Wrappers.LinearRing{false, false, Vector{StaticArraysCore.SVector{2, Float64}}, Nothing, Nothing}(StaticArraysCo
+re.SVector{2, Float64}[[4.5, 3.5], [6.5, 5.5], [8.5, 7.5], [4.5, 3.5]], nothing, nothing), GeoInterface.Wrappers.LinearRing{false, false, Vector{StaticArraysCore.SVector{2, Float64}}, Nothing, Nothing}(StaticA
+rraysCore.SVector{2, Float64}[[6.5, 5.5], [8.5, 7.5], [9.5, 8.5], [6.5, 5.5]], nothing, nothing)], nothing, nothing)

With Rotations.jl you need to actually multiply the Rotation by the SVector point, which is easy using an anonymous function.

julia
julia> using Rotations
+
+julia> GO.transform(p -> one(RotMatrix{2}) * p, geom)
+GeoInterface.Wrappers.Polygon{false, false, Vector{GeoInterface.Wrappers.LinearRing{false, false, Vector{StaticArraysCore.SVector{2, Int64}}, Nothing, Nothing}}, Nothing, Nothing}(GeoInterface.Wrappers.LinearR
+ing{false, false, Vector{StaticArraysCore.SVector{2, Int64}}, Nothing, Nothing}[GeoInterface.Wrappers.LinearRing{false, false, Vector{StaticArraysCore.SVector{2, Int64}}, Nothing, Nothing}(StaticArraysCore.SVe
+ctor{2, Int64}[[2, 1], [4, 3], [6, 5], [2, 1]], nothing, nothing), GeoInterface.Wrappers.LinearRing{false, false, Vector{StaticArraysCore.SVector{2, Int64}}, Nothing, Nothing}(StaticArraysCore.SVector{2, Int64
+}[[4, 3], [6, 5], [7, 6], [4, 3]], nothing, nothing)], nothing, nothing)

source

`,9))]),i("details",pi,[i("summary",null,[s[306]||(s[306]=i("a",{id:"GeometryOps.tuples-Union{Tuple{Any}, Tuple{T}, Tuple{Any, Type{T}}} where T",href:"#GeometryOps.tuples-Union{Tuple{Any}, Tuple{T}, Tuple{Any, Type{T}}} where T"},[i("span",{class:"jlbinding"},"GeometryOps.tuples")],-1)),s[307]||(s[307]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[308]||(s[308]=a('
julia
tuples(obj)

Convert all points in obj to Tuples, wherever the are nested.

Returns a similar object or collection of objects using GeoInterface.jl geometries wrapping Tuple points.

Keywords

  • threaded: true or false. Whether to use multithreading. Defaults to false.

  • crs: The CRS to attach to geometries. Defaults to nothing.

  • calc_extent: true or false. Whether to calculate the extent. Defaults to false.

source

',6))]),i("details",hi,[i("summary",null,[s[309]||(s[309]=i("a",{id:"GeometryOps.union-Union{Tuple{T}, Tuple{Any, Any}, Tuple{Any, Any, Type{T}}} where T<:AbstractFloat",href:"#GeometryOps.union-Union{Tuple{T}, Tuple{Any, Any}, Tuple{Any, Any, Type{T}}} where T<:AbstractFloat"},[i("span",{class:"jlbinding"},"GeometryOps.union")],-1)),s[310]||(s[310]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[311]||(s[311]=a(`
julia
union(geom_a, geom_b, [::Type{T}]; target::Type, fix_multipoly = UnionIntersectingPolygons())

Return the union between two geometries as a list of geometries. Return an empty list if none are found. The type of the list will be constrained as much as possible given the input geometries. Furthermore, the user can provide a taget type as a keyword argument and a list of target geometries found in the difference will be returned. The user can also provide a float type 'T' that they would like the points of returned geometries to be. If the user is taking a intersection involving one or more multipolygons, and the multipolygon might be comprised of polygons that intersect, if fix_multipoly is set to an IntersectingPolygons correction (the default is UnionIntersectingPolygons()), then the needed multipolygons will be fixed to be valid before performing the intersection to ensure a correct answer. Only set fix_multipoly to false if you know that the multipolygons are valid, as it will avoid unneeded computation.

Calculates the union between two polygons.

Example

julia
import GeoInterface as GI, GeometryOps as GO
+
+p1 = GI.Polygon([[(0.0, 0.0), (5.0, 5.0), (10.0, 0.0), (5.0, -5.0), (0.0, 0.0)]])
+p2 = GI.Polygon([[(3.0, 0.0), (8.0, 5.0), (13.0, 0.0), (8.0, -5.0), (3.0, 0.0)]])
+union_poly = GO.union(p1, p2; target = GI.PolygonTrait())
+GI.coordinates.(union_poly)
+
+# output
+1-element Vector{Vector{Vector{Vector{Float64}}}}:
+ [[[6.5, 3.5], [5.0, 5.0], [0.0, 0.0], [5.0, -5.0], [6.5, -3.5], [8.0, -5.0], [13.0, 0.0], [8.0, 5.0], [6.5, 3.5]]]

source

`,6))]),i("details",ki,[i("summary",null,[s[312]||(s[312]=i("a",{id:"GeometryOps.weighted_mean-Union{Tuple{WT}, Tuple{WT, Any, Any}} where WT<:Real",href:"#GeometryOps.weighted_mean-Union{Tuple{WT}, Tuple{WT, Any, Any}} where WT<:Real"},[i("span",{class:"jlbinding"},"GeometryOps.weighted_mean")],-1)),s[313]||(s[313]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[314]||(s[314]=a('
julia
weighted_mean(weight::Real, x1, x2)

Returns the weighted mean of x1 and x2, where weight is the weight of x1.

Specifically, calculates x1 * weight + x2 * (1 - weight).

Note

The idea for this method is that you can override this for custom types, like Color types, in extension modules.

source

',5))]),i("details",ri,[i("summary",null,[s[315]||(s[315]=i("a",{id:"GeometryOps.within-Tuple{Any, Any}",href:"#GeometryOps.within-Tuple{Any, Any}"},[i("span",{class:"jlbinding"},"GeometryOps.within")],-1)),s[316]||(s[316]=e()),n(t,{type:"info",class:"jlObjectType jlMethod",text:"Method"})]),s[317]||(s[317]=a(`
julia
within(geom1, geom2)::Bool

Return true if the first geometry is completely within the second geometry. The interiors of both geometries must intersect and the interior and boundary of the primary geometry (geom1) must not intersect the exterior of the secondary geometry (geom2).

Furthermore, within returns the exact opposite result of contains.

Examples

julia
import GeometryOps as GO, GeoInterface as GI
+
+line = GI.LineString([(1, 1), (1, 2), (1, 3), (1, 4)])
+point = (1, 2)
+GO.within(point, line)
+
+# output
+true

source

`,6))]),s[324]||(s[324]=a('
  1. K. Hormann and N. Sukumar. Generalized Barycentric Coordinates in Computer Graphics and Computational Mechanics. Taylor & Fancis, CRC Press, 2017. ↩︎

',2))])}const Fi=h(r,[["render",oi]]);export{mi as __pageData,Fi as default}; diff --git a/previews/PR237/assets/app.BluvM3bW.js b/previews/PR237/assets/app.BluvM3bW.js new file mode 100644 index 000000000..8ec908583 --- /dev/null +++ b/previews/PR237/assets/app.BluvM3bW.js @@ -0,0 +1 @@ +import{R as p}from"./chunks/theme.BVJ9-_aP.js";import{R as o,a6 as u,a7 as c,a8 as l,a9 as f,aa as d,ab as m,ac as h,ad as g,ae as A,af as v,d as P,u as R,v as w,s as y,ag as C,ah as b,ai as E,a4 as S}from"./chunks/framework.Cq8AuEls.js";function i(e){if(e.extends){const a=i(e.extends);return{...a,...e,async enhanceApp(t){a.enhanceApp&&await a.enhanceApp(t),e.enhanceApp&&await e.enhanceApp(t)}}}return e}const s=i(p),T=P({name:"VitePressApp",setup(){const{site:e,lang:a,dir:t}=R();return w(()=>{y(()=>{document.documentElement.lang=a.value,document.documentElement.dir=t.value})}),e.value.router.prefetchLinks&&C(),b(),E(),s.setup&&s.setup(),()=>S(s.Layout)}});async function D(){globalThis.__VITEPRESS__=!0;const e=j(),a=_();a.provide(c,e);const t=l(e.route);return a.provide(f,t),a.component("Content",d),a.component("ClientOnly",m),Object.defineProperties(a.config.globalProperties,{$frontmatter:{get(){return t.frontmatter.value}},$params:{get(){return t.page.value.params}}}),s.enhanceApp&&await s.enhanceApp({app:a,router:e,siteData:h}),{app:a,router:e,data:t}}function _(){return g(T)}function j(){let e=o,a;return A(t=>{let n=v(t),r=null;return n&&(e&&(a=n),(e||a===n)&&(n=n.replace(/\.js$/,".lean.js")),r=import(n)),o&&(e=!1),r},s.NotFound)}o&&D().then(({app:e,router:a,data:t})=>{a.go().then(()=>{u(a.route,t.site),e.mount("#app")})});export{D as createApp}; diff --git a/previews/PR237/assets/arirdaj.DC3TvBOO.png b/previews/PR237/assets/arirdaj.DC3TvBOO.png new file mode 100644 index 0000000000000000000000000000000000000000..924b99908e5a85c7b17da33f9cc1caf8ab1a67b0 GIT binary patch literal 31376 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 literal 0 HcmV?d00001 diff --git a/previews/PR237/assets/brxrvlc.Dab1-ETk.png b/previews/PR237/assets/brxrvlc.Dab1-ETk.png new file mode 100644 index 0000000000000000000000000000000000000000..7c32623e0e0fff839fabf61e59a4a1ccaecb2950 GIT binary patch literal 76849 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 literal 0 HcmV?d00001 diff --git a/previews/PR237/assets/call_notes.md.BcP_ugKX.js b/previews/PR237/assets/call_notes.md.BcP_ugKX.js new file mode 100644 index 000000000..97d91bed8 --- /dev/null +++ b/previews/PR237/assets/call_notes.md.BcP_ugKX.js @@ -0,0 +1 @@ +import{_ as i,c as l,a5 as t,o}from"./chunks/framework.Cq8AuEls.js";const u=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"call_notes.md","filePath":"call_notes.md","lastUpdated":null}'),a={name:"call_notes.md"};function r(n,e,s,p,c,d){return o(),l("div",null,e[0]||(e[0]=[t('

20th April, 2024

See GeometryOps#114.

  • [ ] Exact predicates can be defined for lower-level, more atomic predicates within GeometryOps.

  • [ ] Add Shewchuck's adaptive math as a stage for exact predicates.

  • [x] @skygering to write docstrings for the predicates

29th Feb, 2024

To do

  • [ ] Finish clipping degeneracies

  • [ ] Fix cross & overlap functions

  • [x] Benchmarks to show why things you couldn't concieve of in R are doable in Julia

  • [x] profile functions for exponential improvements

  • [ ] A list of projects people can work on...the beauty here is that each function is kind of self-contained so it's an undergrad level project

  • [ ] Doc improvements

    • more

    • benchmarks page

  • Methods to validate and fix geometry

    • [ ] Polygons and LinearRings:

      • [ ] self-intersection

      • [ ] holes are actually within the polygon

      • [ ] Polygon exteriors must be counterclockwise, holes clockwise.

      • [ ] length of all rings > 4

      • [ ] repeated last point

    • [ ] LineStrings: NaN/Inf points

    • [x] Fix linear rings at some point to make sure the ring is closed, i.e., points[end] == points[begin]

  • Tests

    • [x] Simplify functions

    • [x] Polygonize

    • Barycentric tests for n_vertices > 4

Done

  • Rename bools.jl to something more relevant to the actual code -> orientation.jl

  • Doc improvements:

    • organise sections
',8)]))}const f=i(a,[["render",r]]);export{u as __pageData,f as default}; diff --git a/previews/PR237/assets/call_notes.md.BcP_ugKX.lean.js b/previews/PR237/assets/call_notes.md.BcP_ugKX.lean.js new file mode 100644 index 000000000..97d91bed8 --- /dev/null +++ b/previews/PR237/assets/call_notes.md.BcP_ugKX.lean.js @@ -0,0 +1 @@ +import{_ as i,c as l,a5 as t,o}from"./chunks/framework.Cq8AuEls.js";const u=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"call_notes.md","filePath":"call_notes.md","lastUpdated":null}'),a={name:"call_notes.md"};function r(n,e,s,p,c,d){return o(),l("div",null,e[0]||(e[0]=[t('

20th April, 2024

See GeometryOps#114.

  • [ ] Exact predicates can be defined for lower-level, more atomic predicates within GeometryOps.

  • [ ] Add Shewchuck's adaptive math as a stage for exact predicates.

  • [x] @skygering to write docstrings for the predicates

29th Feb, 2024

To do

  • [ ] Finish clipping degeneracies

  • [ ] Fix cross & overlap functions

  • [x] Benchmarks to show why things you couldn't concieve of in R are doable in Julia

  • [x] profile functions for exponential improvements

  • [ ] A list of projects people can work on...the beauty here is that each function is kind of self-contained so it's an undergrad level project

  • [ ] Doc improvements

    • more

    • benchmarks page

  • Methods to validate and fix geometry

    • [ ] Polygons and LinearRings:

      • [ ] self-intersection

      • [ ] holes are actually within the polygon

      • [ ] Polygon exteriors must be counterclockwise, holes clockwise.

      • [ ] length of all rings > 4

      • [ ] repeated last point

    • [ ] LineStrings: NaN/Inf points

    • [x] Fix linear rings at some point to make sure the ring is closed, i.e., points[end] == points[begin]

  • Tests

    • [x] Simplify functions

    • [x] Polygonize

    • Barycentric tests for n_vertices > 4

Done

  • Rename bools.jl to something more relevant to the actual code -> orientation.jl

  • Doc improvements:

    • organise sections
',8)]))}const f=i(a,[["render",r]]);export{u as __pageData,f as default}; diff --git a/previews/PR237/assets/chunks/@localSearchIndexroot.DYRrAYA4.js b/previews/PR237/assets/chunks/@localSearchIndexroot.DYRrAYA4.js new file mode 100644 index 000000000..a096759ef --- /dev/null +++ b/previews/PR237/assets/chunks/@localSearchIndexroot.DYRrAYA4.js @@ -0,0 +1 @@ +const e='{"documentCount":201,"nextId":201,"documentIds":{"0":"/GeometryOps.jl/previews/PR237/api#Full-GeometryOps-API-documentation","1":"/GeometryOps.jl/previews/PR237/api#apply-and-associated-functions","2":"/GeometryOps.jl/previews/PR237/api#General-geometry-methods","3":"/GeometryOps.jl/previews/PR237/api#OGC-methods","4":"/GeometryOps.jl/previews/PR237/api#Other-general-methods","5":"/GeometryOps.jl/previews/PR237/api#Barycentric-coordinates","6":"/GeometryOps.jl/previews/PR237/api#Other-methods","7":"/GeometryOps.jl/previews/PR237/call_notes#20th-April,-2024","8":"/GeometryOps.jl/previews/PR237/call_notes#29th-Feb,-2024","9":"/GeometryOps.jl/previews/PR237/call_notes#To-do","10":"/GeometryOps.jl/previews/PR237/call_notes#done","11":"/GeometryOps.jl/previews/PR237/experiments/accurate_accumulators#Accurate-accumulation","12":"/GeometryOps.jl/previews/PR237/experiments/predicates#predicates","13":"/GeometryOps.jl/previews/PR237/experiments/predicates#orient","14":"/GeometryOps.jl/previews/PR237/experiments/predicates#dashboard","15":"/GeometryOps.jl/previews/PR237/experiments/predicates#Testing-robust-vs-regular-predicates","16":"/GeometryOps.jl/previews/PR237/experiments/predicates#incircle","17":"/GeometryOps.jl/previews/PR237/explanations/paradigms#paradigms","18":"/GeometryOps.jl/previews/PR237/explanations/paradigms#apply","19":"/GeometryOps.jl/previews/PR237/explanations/paradigms#applyreduce","20":"/GeometryOps.jl/previews/PR237/explanations/paradigms#fix-and-prepare","21":"/GeometryOps.jl/previews/PR237/explanations/peculiarities#peculiarities","22":"/GeometryOps.jl/previews/PR237/explanations/peculiarities#What-does-apply-return-and-why?","23":"/GeometryOps.jl/previews/PR237/explanations/peculiarities#Why-do-you-want-me-to-provide-a-target-in-set-operations?","24":"/GeometryOps.jl/previews/PR237/explanations/peculiarities#_True-and-_False-(or-BoolsAsTypes)","25":"/GeometryOps.jl/previews/PR237/#what-is-geometryops-jl","26":"/GeometryOps.jl/previews/PR237/#how-to-navigate-the-docs","27":"/GeometryOps.jl/previews/PR237/introduction#introduction","28":"/GeometryOps.jl/previews/PR237/introduction#Main-concepts","29":"/GeometryOps.jl/previews/PR237/introduction#The-apply-paradigm","30":"/GeometryOps.jl/previews/PR237/introduction#What\'s-this-GeoInterface.Wrapper-thing?","31":"/GeometryOps.jl/previews/PR237/source/GeometryOps#geometryops-jl","32":"/GeometryOps.jl/previews/PR237/source/GeometryOpsLibGEOSExt/segmentize#segmentize","33":"/GeometryOps.jl/previews/PR237/source/GeometryOpsLibGEOSExt/simple_overrides#Simple-overrides","34":"/GeometryOps.jl/previews/PR237/source/GeometryOpsLibGEOSExt/simple_overrides#Polygon-set-operations","35":"/GeometryOps.jl/previews/PR237/source/GeometryOpsLibGEOSExt/simple_overrides#difference","36":"/GeometryOps.jl/previews/PR237/source/GeometryOpsLibGEOSExt/simple_overrides#union","37":"/GeometryOps.jl/previews/PR237/source/GeometryOpsLibGEOSExt/simple_overrides#intersection","38":"/GeometryOps.jl/previews/PR237/source/GeometryOpsLibGEOSExt/simple_overrides#Symmetric-difference","39":"/GeometryOps.jl/previews/PR237/source/GeometryOpsLibGEOSExt/simple_overrides#DE-9IM-boolean-methods","40":"/GeometryOps.jl/previews/PR237/source/GeometryOpsLibGEOSExt/simple_overrides#equals","41":"/GeometryOps.jl/previews/PR237/source/GeometryOpsLibGEOSExt/simple_overrides#disjoint","42":"/GeometryOps.jl/previews/PR237/source/GeometryOpsLibGEOSExt/simple_overrides#touches","43":"/GeometryOps.jl/previews/PR237/source/GeometryOpsLibGEOSExt/simple_overrides#crosses","44":"/GeometryOps.jl/previews/PR237/source/GeometryOpsLibGEOSExt/simple_overrides#within","45":"/GeometryOps.jl/previews/PR237/source/GeometryOpsLibGEOSExt/simple_overrides#contains","46":"/GeometryOps.jl/previews/PR237/source/GeometryOpsLibGEOSExt/simple_overrides#overlaps","47":"/GeometryOps.jl/previews/PR237/source/GeometryOpsLibGEOSExt/simple_overrides#covers","48":"/GeometryOps.jl/previews/PR237/source/GeometryOpsLibGEOSExt/simple_overrides#coveredby","49":"/GeometryOps.jl/previews/PR237/source/GeometryOpsLibGEOSExt/simple_overrides#intersects","50":"/GeometryOps.jl/previews/PR237/source/GeometryOpsLibGEOSExt/simple_overrides#Convex-hull","51":"/GeometryOps.jl/previews/PR237/source/methods/angles#angles","52":"/GeometryOps.jl/previews/PR237/source/methods/angles#What-is-angles?","53":"/GeometryOps.jl/previews/PR237/source/methods/angles#implementation","54":"/GeometryOps.jl/previews/PR237/source/methods/area#Area-and-signed-area","55":"/GeometryOps.jl/previews/PR237/source/methods/area#What-is-area?-What-is-signed-area?","56":"/GeometryOps.jl/previews/PR237/source/methods/area#implementation","57":"/GeometryOps.jl/previews/PR237/source/methods/buffer#buffer","58":"/GeometryOps.jl/previews/PR237/source/methods/barycentric#Barycentric-coordinates","59":"/GeometryOps.jl/previews/PR237/source/methods/barycentric#example","60":"/GeometryOps.jl/previews/PR237/source/methods/barycentric#Barycentric-coordinate-API","61":"/GeometryOps.jl/previews/PR237/source/methods/centroid#centroid","62":"/GeometryOps.jl/previews/PR237/source/methods/centroid#What-is-the-centroid?","63":"/GeometryOps.jl/previews/PR237/source/methods/centroid#implementation","64":"/GeometryOps.jl/previews/PR237/source/methods/clipping/clipping_processor#Polygon-clipping-helpers","65":"/GeometryOps.jl/previews/PR237/source/methods/clipping/cut#Polygon-cutting","66":"/GeometryOps.jl/previews/PR237/source/methods/clipping/cut#What-is-cut?","67":"/GeometryOps.jl/previews/PR237/source/methods/clipping/cut#implementation","68":"/GeometryOps.jl/previews/PR237/source/methods/clipping/coverage#What-is-coverage?","69":"/GeometryOps.jl/previews/PR237/source/methods/clipping/coverage#implementation","70":"/GeometryOps.jl/previews/PR237/source/methods/clipping/difference#Difference-Polygon-Clipping","71":"/GeometryOps.jl/previews/PR237/source/methods/clipping/difference#Helper-functions-for-Differences-with-Greiner-and-Hormann-Polygon-Clipping","72":"/GeometryOps.jl/previews/PR237/source/methods/clipping/intersection#Geometry-Intersection","73":"/GeometryOps.jl/previews/PR237/source/methods/clipping/intersection#Helper-functions-for-Intersections-with-Greiner-and-Hormann-Polygon-Clipping","74":"/GeometryOps.jl/previews/PR237/source/methods/clipping/predicates#If-we-want-to-inject-adaptivity,-we-would-do-something-like:","75":"/GeometryOps.jl/previews/PR237/source/methods/clipping/union#Union-Polygon-Clipping","76":"/GeometryOps.jl/previews/PR237/source/methods/clipping/union#Helper-functions-for-Unions-with-Greiner-and-Hormann-Polygon-Clipping","77":"/GeometryOps.jl/previews/PR237/source/methods/convex_hull#Convex-hull","78":"/GeometryOps.jl/previews/PR237/source/methods/convex_hull#example","79":"/GeometryOps.jl/previews/PR237/source/methods/convex_hull#Simple-hull","80":"/GeometryOps.jl/previews/PR237/source/methods/convex_hull#Convex-hull-of-the-USA","81":"/GeometryOps.jl/previews/PR237/source/methods/convex_hull#Investigating-the-winding-order","82":"/GeometryOps.jl/previews/PR237/source/methods/convex_hull#implementation","83":"/GeometryOps.jl/previews/PR237/source/methods/distance#Distance-and-signed-distance","84":"/GeometryOps.jl/previews/PR237/source/methods/distance#What-is-distance?-What-is-signed-distance?","85":"/GeometryOps.jl/previews/PR237/source/methods/distance#implementation","86":"/GeometryOps.jl/previews/PR237/source/methods/equals#equals","87":"/GeometryOps.jl/previews/PR237/source/methods/equals#What-is-equals?","88":"/GeometryOps.jl/previews/PR237/source/methods/equals#implementation","89":"/GeometryOps.jl/previews/PR237/source/methods/geom_relations/coveredby#coveredby","90":"/GeometryOps.jl/previews/PR237/source/methods/geom_relations/coveredby#What-is-coveredby?","91":"/GeometryOps.jl/previews/PR237/source/methods/geom_relations/coveredby#implementation","92":"/GeometryOps.jl/previews/PR237/source/methods/geom_relations/coveredby#Convert-features-to-geometries","93":"/GeometryOps.jl/previews/PR237/source/methods/geom_relations/coveredby#Points-coveredby-geometries","94":"/GeometryOps.jl/previews/PR237/source/methods/geom_relations/coveredby#Lines-coveredby-geometries","95":"/GeometryOps.jl/previews/PR237/source/methods/geom_relations/coveredby#Rings-covered-by-geometries","96":"/GeometryOps.jl/previews/PR237/source/methods/geom_relations/coveredby#Polygons-covered-by-geometries","97":"/GeometryOps.jl/previews/PR237/source/methods/geom_relations/coveredby#Geometries-coveredby-multi-geometry/geometry-collections","98":"/GeometryOps.jl/previews/PR237/source/methods/geom_relations/coveredby#Multi-geometry/geometry-collections-coveredby-geometries","99":"/GeometryOps.jl/previews/PR237/source/methods/geom_relations/contains#contains","100":"/GeometryOps.jl/previews/PR237/source/methods/geom_relations/contains#What-is-contains?","101":"/GeometryOps.jl/previews/PR237/source/methods/geom_relations/contains#implementation","102":"/GeometryOps.jl/previews/PR237/source/methods/geom_relations/covers#covers","103":"/GeometryOps.jl/previews/PR237/source/methods/geom_relations/covers#What-is-covers?","104":"/GeometryOps.jl/previews/PR237/source/methods/geom_relations/covers#implementation","105":"/GeometryOps.jl/previews/PR237/source/methods/geom_relations/crosses#Crossing-checks","106":"/GeometryOps.jl/previews/PR237/source/methods/geom_relations/disjoint#disjoint","107":"/GeometryOps.jl/previews/PR237/source/methods/geom_relations/disjoint#What-is-disjoint?","108":"/GeometryOps.jl/previews/PR237/source/methods/geom_relations/disjoint#implementation","109":"/GeometryOps.jl/previews/PR237/source/methods/geom_relations/disjoint#Convert-features-to-geometries","110":"/GeometryOps.jl/previews/PR237/source/methods/geom_relations/disjoint#Point-disjoint-geometries","111":"/GeometryOps.jl/previews/PR237/source/methods/geom_relations/disjoint#Lines-disjoint-geometries","112":"/GeometryOps.jl/previews/PR237/source/methods/geom_relations/disjoint#Rings-disjoint-geometries","113":"/GeometryOps.jl/previews/PR237/source/methods/geom_relations/disjoint#Polygon-disjoint-geometries","114":"/GeometryOps.jl/previews/PR237/source/methods/geom_relations/disjoint#Geometries-disjoint-multi-geometry/geometry-collections","115":"/GeometryOps.jl/previews/PR237/source/methods/geom_relations/disjoint#Multi-geometry/geometry-collections-coveredby-geometries","116":"/GeometryOps.jl/previews/PR237/source/methods/geom_relations/geom_geom_processors#Line-curve-interaction","117":"/GeometryOps.jl/previews/PR237/source/methods/geom_relations/intersects#Intersection-checks","118":"/GeometryOps.jl/previews/PR237/source/methods/geom_relations/intersects#What-is-intersects?","119":"/GeometryOps.jl/previews/PR237/source/methods/geom_relations/intersects#implementation","120":"/GeometryOps.jl/previews/PR237/source/methods/geom_relations/overlaps#overlaps","121":"/GeometryOps.jl/previews/PR237/source/methods/geom_relations/overlaps#What-is-overlaps?","122":"/GeometryOps.jl/previews/PR237/source/methods/geom_relations/overlaps#implementation","123":"/GeometryOps.jl/previews/PR237/source/methods/geom_relations/touches#touches","124":"/GeometryOps.jl/previews/PR237/source/methods/geom_relations/touches#What-is-touches?","125":"/GeometryOps.jl/previews/PR237/source/methods/geom_relations/touches#implementation","126":"/GeometryOps.jl/previews/PR237/source/methods/geom_relations/touches#Convert-features-to-geometries","127":"/GeometryOps.jl/previews/PR237/source/methods/geom_relations/touches#Point-touches-geometries","128":"/GeometryOps.jl/previews/PR237/source/methods/geom_relations/touches#Lines-touching-geometries","129":"/GeometryOps.jl/previews/PR237/source/methods/geom_relations/touches#Rings-touch-geometries","130":"/GeometryOps.jl/previews/PR237/source/methods/geom_relations/touches#Polygons-touch-geometries","131":"/GeometryOps.jl/previews/PR237/source/methods/geom_relations/touches#Geometries-touch-multi-geometry/geometry-collections","132":"/GeometryOps.jl/previews/PR237/source/methods/geom_relations/touches#Multi-geometry/geometry-collections-cross-geometries","133":"/GeometryOps.jl/previews/PR237/source/methods/geom_relations/within#within","134":"/GeometryOps.jl/previews/PR237/source/methods/geom_relations/within#What-is-within?","135":"/GeometryOps.jl/previews/PR237/source/methods/geom_relations/within#implementation","136":"/GeometryOps.jl/previews/PR237/source/methods/geom_relations/within#Convert-features-to-geometries","137":"/GeometryOps.jl/previews/PR237/source/methods/geom_relations/within#Points-within-geometries","138":"/GeometryOps.jl/previews/PR237/source/methods/geom_relations/within#Lines-within-geometries","139":"/GeometryOps.jl/previews/PR237/source/methods/geom_relations/within#Rings-covered-by-geometries","140":"/GeometryOps.jl/previews/PR237/source/methods/geom_relations/within#Polygons-within-geometries","141":"/GeometryOps.jl/previews/PR237/source/methods/geom_relations/within#Geometries-within-multi-geometry/geometry-collections","142":"/GeometryOps.jl/previews/PR237/source/methods/geom_relations/within#Multi-geometry/geometry-collections-within-geometries","143":"/GeometryOps.jl/previews/PR237/source/methods/orientation#orientation","144":"/GeometryOps.jl/previews/PR237/source/methods/orientation#isclockwise","145":"/GeometryOps.jl/previews/PR237/source/methods/orientation#isconcave","146":"/GeometryOps.jl/previews/PR237/source/methods/polygonize#Polygonizing-raster-data","147":"/GeometryOps.jl/previews/PR237/source/not_implemented_yet#Not-implemented-yet","148":"/GeometryOps.jl/previews/PR237/source/src/apply#apply","149":"/GeometryOps.jl/previews/PR237/source/src/apply#docstrings","150":"/GeometryOps.jl/previews/PR237/source/src/apply#functions","151":"/GeometryOps.jl/previews/PR237/source/src/apply#What-is-apply?","152":"/GeometryOps.jl/previews/PR237/source/src/apply#embedding","153":"/GeometryOps.jl/previews/PR237/source/src/apply#threading","154":"/GeometryOps.jl/previews/PR237/source/src/applyreduce#applyreduce","155":"/GeometryOps.jl/previews/PR237/source/src/keyword_docs#Keyword-docs","156":"/GeometryOps.jl/previews/PR237/source/src/other_primitives#Other-primitives-(unwrap,-flatten,-etc)","157":"/GeometryOps.jl/previews/PR237/source/src/types#types","158":"/GeometryOps.jl/previews/PR237/source/src/types#Manifold","159":"/GeometryOps.jl/previews/PR237/source/src/types#TraitTarget","160":"/GeometryOps.jl/previews/PR237/source/src/types#BoolsAsTypes","161":"/GeometryOps.jl/previews/PR237/source/transformations/correction/closed_ring#Closed-Rings","162":"/GeometryOps.jl/previews/PR237/source/transformations/correction/closed_ring#example","163":"/GeometryOps.jl/previews/PR237/source/transformations/correction/closed_ring#implementation","164":"/GeometryOps.jl/previews/PR237/source/transformations/correction/geometry_correction#Geometry-Corrections","165":"/GeometryOps.jl/previews/PR237/source/transformations/correction/geometry_correction#interface","166":"/GeometryOps.jl/previews/PR237/source/transformations/correction/geometry_correction#Available-corrections","167":"/GeometryOps.jl/previews/PR237/source/transformations/correction/intersecting_polygons#Intersecting-Polygons","168":"/GeometryOps.jl/previews/PR237/source/transformations/correction/intersecting_polygons#example","169":"/GeometryOps.jl/previews/PR237/source/transformations/correction/intersecting_polygons#implementation","170":"/GeometryOps.jl/previews/PR237/source/transformations/extent#Extent-embedding","171":"/GeometryOps.jl/previews/PR237/source/transformations/flip#Coordinate-flipping","172":"/GeometryOps.jl/previews/PR237/source/transformations/reproject#Geometry-reprojection","173":"/GeometryOps.jl/previews/PR237/source/transformations/reproject#Method-error-handling","174":"/GeometryOps.jl/previews/PR237/source/transformations/segmentize#segmentize","175":"/GeometryOps.jl/previews/PR237/source/transformations/segmentize#examples","176":"/GeometryOps.jl/previews/PR237/source/transformations/segmentize#benchmark","177":"/GeometryOps.jl/previews/PR237/source/transformations/segmentize#implementation","178":"/GeometryOps.jl/previews/PR237/source/transformations/simplify#Geometry-simplification","179":"/GeometryOps.jl/previews/PR237/source/transformations/simplify#examples","180":"/GeometryOps.jl/previews/PR237/source/transformations/simplify#benchmark","181":"/GeometryOps.jl/previews/PR237/source/transformations/simplify#Simplify-with-RadialDistance-Algorithm","182":"/GeometryOps.jl/previews/PR237/source/transformations/simplify#Simplify-with-DouglasPeucker-Algorithm","183":"/GeometryOps.jl/previews/PR237/source/transformations/simplify#Simplify-with-VisvalingamWhyatt-Algorithm","184":"/GeometryOps.jl/previews/PR237/source/transformations/simplify#Shared-utils","185":"/GeometryOps.jl/previews/PR237/source/transformations/transform#Pointwise-transformation","186":"/GeometryOps.jl/previews/PR237/source/types#types","187":"/GeometryOps.jl/previews/PR237/source/types#GEOS","188":"/GeometryOps.jl/previews/PR237/source/transformations/tuples#Tuple-conversion","189":"/GeometryOps.jl/previews/PR237/source/utils#Utility-functions","190":"/GeometryOps.jl/previews/PR237/tutorials/creating_geometry#Creating-Geometry","191":"/GeometryOps.jl/previews/PR237/tutorials/creating_geometry#creating-geometry","192":"/GeometryOps.jl/previews/PR237/tutorials/creating_geometry#plot-geometry","193":"/GeometryOps.jl/previews/PR237/tutorials/creating_geometry#geom-crs","194":"/GeometryOps.jl/previews/PR237/tutorials/creating_geometry#attributes","195":"/GeometryOps.jl/previews/PR237/tutorials/creating_geometry#save-geometry","196":"/GeometryOps.jl/previews/PR237/tutorials/geodesic_paths#Geodesic-paths","197":"/GeometryOps.jl/previews/PR237/tutorials/spatial_joins#Spatial-joins","198":"/GeometryOps.jl/previews/PR237/tutorials/spatial_joins#Simple-example","199":"/GeometryOps.jl/previews/PR237/tutorials/spatial_joins#Real-world-example","200":"/GeometryOps.jl/previews/PR237/tutorials/spatial_joins#Enabling-custom-predicates"},"fieldIds":{"title":0,"titles":1,"text":2},"fieldLength":{"0":[4,1,87],"1":[4,4,246],"2":[3,4,1],"3":[2,7,205],"4":[3,7,255],"5":[2,4,81],"6":[2,4,1016],"7":[3,1,55],"8":[3,1,1],"9":[2,3,107],"10":[1,3,17],"11":[2,1,74],"12":[1,1,5],"13":[1,1,128],"14":[1,2,116],"15":[5,2,72],"16":[1,1,1],"17":[1,1,53],"18":[1,1,109],"19":[1,2,35],"20":[3,1,79],"21":[1,1,1],"22":[7,1,71],"23":[13,1,101],"24":[6,1,66],"25":[5,1,72],"26":[5,1,61],"27":[1,1,72],"28":[2,1,1],"29":[3,3,50],"30":[8,3,18],"31":[2,1,146],"32":[1,1,106],"33":[2,1,23],"34":[3,2,1],"35":[1,5,20],"36":[1,5,20],"37":[1,5,20],"38":[2,5,22],"39":[4,2,1],"40":[1,6,13],"41":[1,6,13],"42":[1,6,13],"43":[1,6,13],"44":[1,6,13],"45":[1,6,13],"46":[1,6,13],"47":[1,6,13],"48":[1,6,13],"49":[1,6,13],"50":[2,2,34],"51":[1,1,3],"52":[4,1,57],"53":[1,1,268],"54":[4,1,4],"55":[5,4,100],"56":[1,4,246],"57":[1,1,110],"58":[2,1,65],"59":[1,2,211],"60":[3,2,414],"61":[1,1,6],"62":[5,1,91],"63":[1,1,199],"64":[3,1,610],"65":[2,1,3],"66":[4,2,57],"67":[1,2,200],"68":[4,1,70],"69":[1,1,327],"70":[3,1,214],"71":[10,1,190],"72":[2,1,250],"73":[10,1,480],"74":[11,1,25],"75":[3,1,236],"76":[10,1,284],"77":[2,1,56],"78":[1,2,1],"79":[2,3,32],"80":[5,2,40],"81":[4,2,100],"82":[1,2,166],"83":[4,1,4],"84":[5,4,128],"85":[1,4,260],"86":[1,1,3],"87":[4,1,68],"88":[1,1,265],"89":[1,1,3],"90":[4,1,81],"91":[1,1,128],"92":[4,1,11],"93":[3,1,56],"94":[3,1,46],"95":[4,1,48],"96":[4,1,40],"97":[5,1,40],"98":[5,1,44],"99":[1,1,3],"100":[4,1,79],"101":[1,1,79],"102":[1,1,3],"103":[4,1,67],"104":[1,1,78],"105":[2,1,149],"106":[1,1,3],"107":[4,1,68],"108":[1,1,110],"109":[4,1,10],"110":[3,1,57],"111":[3,1,58],"112":[3,1,47],"113":[3,1,33],"114":[5,1,39],"115":[5,1,44],"116":[3,1,432],"117":[2,1,3],"118":[4,2,80],"119":[1,2,76],"120":[1,1,3],"121":[4,1,82],"122":[1,1,244],"123":[1,1,3],"124":[4,1,70],"125":[1,1,125],"126":[4,1,11],"127":[3,1,69],"128":[3,1,52],"129":[3,1,61],"130":[3,1,40],"131":[5,1,39],"132":[5,1,42],"133":[1,1,3],"134":[4,1,72],"135":[1,1,129],"136":[4,1,11],"137":[3,1,63],"138":[3,1,53],"139":[4,1,53],"140":[3,1,38],"141":[5,1,39],"142":[5,1,42],"143":[1,1,4],"144":[1,1,21],"145":[1,1,206],"146":[3,1,511],"147":[3,1,43],"148":[1,1,114],"149":[1,1,1],"150":[1,2,152],"151":[4,1,114],"152":[2,1,36],"153":[1,1,490],"154":[1,1,291],"155":[2,1,51],"156":[6,1,217],"157":[1,1,17],"158":[1,1,221],"159":[1,1,74],"160":[1,1,98],"161":[2,1,54],"162":[1,2,87],"163":[1,2,83],"164":[2,1,41],"165":[1,2,109],"166":[2,2,106],"167":[2,1,77],"168":[1,2,70],"169":[1,2,135],"170":[2,1,71],"171":[2,1,56],"172":[2,1,132],"173":[3,2,77],"174":[1,1,76],"175":[1,1,147],"176":[1,1,268],"177":[1,1,221],"178":[2,1,44],"179":[1,2,67],"180":[1,2,391],"181":[4,1,75],"182":[4,1,186],"183":[4,1,85],"184":[2,1,149],"185":[2,1,111],"186":[1,1,37],"187":[1,1,147],"188":[2,1,58],"189":[2,1,136],"190":[2,1,60],"191":[4,2,287],"192":[13,2,280],"193":[9,2,199],"194":[7,2,63],"195":[4,2,140],"196":[2,1,52],"197":[2,1,141],"198":[2,2,137],"199":[3,2,117],"200":[3,2,68]},"averageFieldLength":[2.72139303482587,1.7263681592039801,101.9004975124378],"storedFields":{"0":{"title":"Full GeometryOps API documentation","titles":[]},"1":{"title":"apply and associated functions","titles":["Full GeometryOps API documentation"]},"2":{"title":"General geometry methods","titles":["Full GeometryOps API documentation"]},"3":{"title":"OGC methods","titles":["Full GeometryOps API documentation","General geometry methods"]},"4":{"title":"Other general methods","titles":["Full GeometryOps API documentation","General geometry methods"]},"5":{"title":"Barycentric coordinates","titles":["Full GeometryOps API documentation"]},"6":{"title":"Other methods","titles":["Full GeometryOps API documentation"]},"7":{"title":"20th April, 2024","titles":[]},"8":{"title":"29th Feb, 2024","titles":[]},"9":{"title":"To do","titles":["29th Feb, 2024"]},"10":{"title":"Done","titles":["29th Feb, 2024"]},"11":{"title":"Accurate accumulation","titles":[]},"12":{"title":"Predicates","titles":[]},"13":{"title":"Orient","titles":["Predicates"]},"14":{"title":"Dashboard","titles":["Predicates","Orient"]},"15":{"title":"Testing robust vs regular predicates","titles":["Predicates","Orient"]},"16":{"title":"Incircle","titles":["Predicates"]},"17":{"title":"Paradigms","titles":[]},"18":{"title":"apply","titles":["Paradigms"]},"19":{"title":"applyreduce","titles":["Paradigms","apply"]},"20":{"title":"fix and prepare","titles":["Paradigms"]},"21":{"title":"Peculiarities","titles":[]},"22":{"title":"What does apply return and why?","titles":["Peculiarities"]},"23":{"title":"Why do you want me to provide a target in set operations?","titles":["Peculiarities"]},"24":{"title":"_True and _False (or BoolsAsTypes)","titles":["Peculiarities"]},"25":{"title":"What is GeometryOps.jl?","titles":[]},"26":{"title":"How to navigate the docs","titles":[]},"27":{"title":"Introduction","titles":[]},"28":{"title":"Main concepts","titles":["Introduction"]},"29":{"title":"The apply paradigm","titles":["Introduction","Main concepts"]},"30":{"title":"What's this GeoInterface.Wrapper thing?","titles":["Introduction","Main concepts"]},"31":{"title":"GeometryOps.jl","titles":[]},"32":{"title":"Segmentize","titles":[]},"33":{"title":"Simple overrides","titles":[]},"34":{"title":"Polygon set operations","titles":["Simple overrides"]},"35":{"title":"Difference","titles":["Simple overrides","Polygon set operations"]},"36":{"title":"Union","titles":["Simple overrides","Polygon set operations"]},"37":{"title":"Intersection","titles":["Simple overrides","Polygon set operations"]},"38":{"title":"Symmetric difference","titles":["Simple overrides","Polygon set operations"]},"39":{"title":"DE-9IM boolean methods","titles":["Simple overrides"]},"40":{"title":"Equals","titles":["Simple overrides","DE-9IM boolean methods"]},"41":{"title":"Disjoint","titles":["Simple overrides","DE-9IM boolean methods"]},"42":{"title":"Touches","titles":["Simple overrides","DE-9IM boolean methods"]},"43":{"title":"Crosses","titles":["Simple overrides","DE-9IM boolean methods"]},"44":{"title":"Within","titles":["Simple overrides","DE-9IM boolean methods"]},"45":{"title":"Contains","titles":["Simple overrides","DE-9IM boolean methods"]},"46":{"title":"Overlaps","titles":["Simple overrides","DE-9IM boolean methods"]},"47":{"title":"Covers","titles":["Simple overrides","DE-9IM boolean methods"]},"48":{"title":"CoveredBy","titles":["Simple overrides","DE-9IM boolean methods"]},"49":{"title":"Intersects","titles":["Simple overrides","DE-9IM boolean methods"]},"50":{"title":"Convex hull","titles":["Simple overrides"]},"51":{"title":"Angles","titles":[]},"52":{"title":"What is angles?","titles":["Angles"]},"53":{"title":"Implementation","titles":["Angles"]},"54":{"title":"Area and signed area","titles":[]},"55":{"title":"What is area? What is signed area?","titles":["Area and signed area"]},"56":{"title":"Implementation","titles":["Area and signed area"]},"57":{"title":"Buffer","titles":[]},"58":{"title":"Barycentric coordinates","titles":[]},"59":{"title":"Example","titles":["Barycentric coordinates"]},"60":{"title":"Barycentric-coordinate API","titles":["Barycentric coordinates"]},"61":{"title":"Centroid","titles":[]},"62":{"title":"What is the centroid?","titles":["Centroid"]},"63":{"title":"Implementation","titles":["Centroid"]},"64":{"title":"Polygon clipping helpers","titles":[]},"65":{"title":"Polygon cutting","titles":[]},"66":{"title":"What is cut?","titles":["Polygon cutting"]},"67":{"title":"Implementation","titles":["Polygon cutting"]},"68":{"title":"What is coverage?","titles":[]},"69":{"title":"Implementation","titles":[]},"70":{"title":"Difference Polygon Clipping","titles":[]},"71":{"title":"Helper functions for Differences with Greiner and Hormann Polygon Clipping","titles":[]},"72":{"title":"Geometry Intersection","titles":[]},"73":{"title":"Helper functions for Intersections with Greiner and Hormann Polygon Clipping","titles":[]},"74":{"title":"If we want to inject adaptivity, we would do something like:","titles":[]},"75":{"title":"Union Polygon Clipping","titles":[]},"76":{"title":"Helper functions for Unions with Greiner and Hormann Polygon Clipping","titles":[]},"77":{"title":"Convex hull","titles":[]},"78":{"title":"Example","titles":["Convex hull"]},"79":{"title":"Simple hull","titles":["Convex hull","Example"]},"80":{"title":"Convex hull of the USA","titles":["Convex hull"]},"81":{"title":"Investigating the winding order","titles":["Convex hull"]},"82":{"title":"Implementation","titles":["Convex hull"]},"83":{"title":"Distance and signed distance","titles":[]},"84":{"title":"What is distance? What is signed distance?","titles":["Distance and signed distance"]},"85":{"title":"Implementation","titles":["Distance and signed distance"]},"86":{"title":"Equals","titles":[]},"87":{"title":"What is equals?","titles":["Equals"]},"88":{"title":"Implementation","titles":["Equals"]},"89":{"title":"CoveredBy","titles":[]},"90":{"title":"What is coveredby?","titles":["CoveredBy"]},"91":{"title":"Implementation","titles":["CoveredBy"]},"92":{"title":"Convert features to geometries","titles":[]},"93":{"title":"Points coveredby geometries","titles":[]},"94":{"title":"Lines coveredby geometries","titles":[]},"95":{"title":"Rings covered by geometries","titles":[]},"96":{"title":"Polygons covered by geometries","titles":[]},"97":{"title":"Geometries coveredby multi-geometry/geometry collections","titles":[]},"98":{"title":"Multi-geometry/geometry collections coveredby geometries","titles":[]},"99":{"title":"Contains","titles":[]},"100":{"title":"What is contains?","titles":["Contains"]},"101":{"title":"Implementation","titles":["Contains"]},"102":{"title":"Covers","titles":[]},"103":{"title":"What is covers?","titles":["Covers"]},"104":{"title":"Implementation","titles":["Covers"]},"105":{"title":"Crossing checks","titles":[]},"106":{"title":"Disjoint","titles":[]},"107":{"title":"What is disjoint?","titles":["Disjoint"]},"108":{"title":"Implementation","titles":["Disjoint"]},"109":{"title":"Convert features to geometries","titles":[]},"110":{"title":"Point disjoint geometries","titles":[]},"111":{"title":"Lines disjoint geometries","titles":[]},"112":{"title":"Rings disjoint geometries","titles":[]},"113":{"title":"Polygon disjoint geometries","titles":[]},"114":{"title":"Geometries disjoint multi-geometry/geometry collections","titles":[]},"115":{"title":"Multi-geometry/geometry collections coveredby geometries","titles":[]},"116":{"title":"Line-curve interaction","titles":[]},"117":{"title":"Intersection checks","titles":[]},"118":{"title":"What is intersects?","titles":["Intersection checks"]},"119":{"title":"Implementation","titles":["Intersection checks"]},"120":{"title":"Overlaps","titles":[]},"121":{"title":"What is overlaps?","titles":["Overlaps"]},"122":{"title":"Implementation","titles":["Overlaps"]},"123":{"title":"Touches","titles":[]},"124":{"title":"What is touches?","titles":["Touches"]},"125":{"title":"Implementation","titles":["Touches"]},"126":{"title":"Convert features to geometries","titles":[]},"127":{"title":"Point touches geometries","titles":[]},"128":{"title":"Lines touching geometries","titles":[]},"129":{"title":"Rings touch geometries","titles":[]},"130":{"title":"Polygons touch geometries","titles":[]},"131":{"title":"Geometries touch multi-geometry/geometry collections","titles":[]},"132":{"title":"Multi-geometry/geometry collections cross geometries","titles":[]},"133":{"title":"Within","titles":[]},"134":{"title":"What is within?","titles":["Within"]},"135":{"title":"Implementation","titles":["Within"]},"136":{"title":"Convert features to geometries","titles":[]},"137":{"title":"Points within geometries","titles":[]},"138":{"title":"Lines within geometries","titles":[]},"139":{"title":"Rings covered by geometries","titles":[]},"140":{"title":"Polygons within geometries","titles":[]},"141":{"title":"Geometries within multi-geometry/geometry collections","titles":[]},"142":{"title":"Multi-geometry/geometry collections within geometries","titles":[]},"143":{"title":"Orientation","titles":[]},"144":{"title":"isclockwise","titles":["Orientation"]},"145":{"title":"isconcave","titles":["Orientation"]},"146":{"title":"Polygonizing raster data","titles":[]},"147":{"title":"Not implemented yet","titles":[]},"148":{"title":"apply","titles":[]},"149":{"title":"Docstrings","titles":["apply"]},"150":{"title":"Functions","titles":["apply","Docstrings"]},"151":{"title":"What is apply?","titles":["apply"]},"152":{"title":"Embedding:","titles":["apply"]},"153":{"title":"Threading","titles":["apply"]},"154":{"title":"applyreduce","titles":[]},"155":{"title":"Keyword docs","titles":[]},"156":{"title":"Other primitives (unwrap, flatten, etc)","titles":[]},"157":{"title":"Types","titles":[]},"158":{"title":"Manifold","titles":["Types"]},"159":{"title":"TraitTarget","titles":["Types"]},"160":{"title":"BoolsAsTypes","titles":["Types"]},"161":{"title":"Closed Rings","titles":[]},"162":{"title":"Example","titles":["Closed Rings"]},"163":{"title":"Implementation","titles":["Closed Rings"]},"164":{"title":"Geometry Corrections","titles":[]},"165":{"title":"Interface","titles":["Geometry Corrections"]},"166":{"title":"Available corrections","titles":["Geometry Corrections"]},"167":{"title":"Intersecting Polygons","titles":[]},"168":{"title":"Example","titles":["Intersecting Polygons"]},"169":{"title":"Implementation","titles":["Intersecting Polygons"]},"170":{"title":"Extent embedding","titles":[]},"171":{"title":"Coordinate flipping","titles":[]},"172":{"title":"Geometry reprojection","titles":[]},"173":{"title":"Method error handling","titles":["Geometry reprojection"]},"174":{"title":"Segmentize","titles":[]},"175":{"title":"Examples","titles":["Segmentize"]},"176":{"title":"Benchmark","titles":["Segmentize"]},"177":{"title":"Implementation","titles":["Segmentize"]},"178":{"title":"Geometry simplification","titles":[]},"179":{"title":"Examples","titles":["Geometry simplification"]},"180":{"title":"Benchmark","titles":["Geometry simplification"]},"181":{"title":"Simplify with RadialDistance Algorithm","titles":[]},"182":{"title":"Simplify with DouglasPeucker Algorithm","titles":[]},"183":{"title":"Simplify with VisvalingamWhyatt Algorithm","titles":[]},"184":{"title":"Shared utils","titles":[]},"185":{"title":"Pointwise transformation","titles":[]},"186":{"title":"Types","titles":[]},"187":{"title":"GEOS","titles":["Types"]},"188":{"title":"Tuple conversion","titles":[]},"189":{"title":"Utility functions","titles":[]},"190":{"title":"Creating Geometry","titles":[]},"191":{"title":"Creating and plotting geometries","titles":["Creating Geometry"]},"192":{"title":"Plot geometries on a map using GeoMakie and coordinate reference system (CRS)","titles":["Creating Geometry"]},"193":{"title":"Create geospatial geometries with embedded coordinate reference system information","titles":["Creating Geometry"]},"194":{"title":"Creating a table with attributes and geometry","titles":["Creating Geometry"]},"195":{"title":"Saving your geospatial data","titles":["Creating Geometry"]},"196":{"title":"Geodesic paths","titles":[]},"197":{"title":"Spatial joins","titles":[]},"198":{"title":"Simple example","titles":["Spatial joins"]},"199":{"title":"Real-world example","titles":["Spatial joins"]},"200":{"title":"Enabling custom predicates","titles":["Spatial joins"]}},"dirtCount":0,"index":[["⋮",{"2":{"192":1}}],["θ",{"2":{"191":7,"192":3,"193":5}}],["☁",{"2":{"191":1}}],["✈",{"2":{"191":1}}],["÷",{"2":{"153":1,"154":1}}],["ϵ",{"2":{"73":5}}],["∘",{"2":{"73":1,"122":2,"146":2,"165":1,"180":2,"200":2}}],["⊻",{"2":{"64":1,"71":2}}],["≥",{"2":{"64":1,"116":2,"169":1,"182":1}}],["α≈1",{"2":{"73":1}}],["α≈0",{"2":{"73":1}}],["α2",{"2":{"64":4,"73":2}}],["α",{"2":{"64":3,"73":28,"116":7}}],["α1",{"2":{"64":4,"73":2}}],["β2",{"2":{"64":4,"73":2}}],["β",{"2":{"64":4,"73":28,"116":7}}],["β1",{"2":{"64":4,"73":2}}],["≤",{"2":{"64":5,"69":14,"116":6,"182":1,"184":1,"189":4}}],["^",{"2":{"192":1}}],["^3",{"2":{"192":1}}],["^n",{"2":{"145":1}}],["^2",{"2":{"63":2,"85":2}}],["^hormannpresentation",{"2":{"60":2}}],["∑λ",{"2":{"60":2}}],["∑i=2n",{"2":{"6":1}}],["λ₁",{"2":{"60":2}}],["λn",{"2":{"58":1}}],["λ3",{"2":{"58":1}}],["λ2",{"2":{"58":2}}],["λ1",{"2":{"58":2}}],["λs",{"2":{"5":3,"6":4,"60":27}}],["`$",{"2":{"187":1}}],["`equatorial",{"2":{"176":2}}],["`extents",{"2":{"170":1}}],["`inf`",{"2":{"172":1}}],["`inv",{"2":{"158":1}}],["`intersects`",{"2":{"119":1}}],["`intersectingpolygons`",{"2":{"70":1,"72":1,"75":1}}],["`90`",{"2":{"158":1}}],["`libgeos",{"2":{"187":1}}],["`linearring`",{"2":{"177":1}}],["`linestring`",{"2":{"177":1}}],["`linestringtrait`",{"2":{"165":1}}],["`line2`",{"2":{"145":1}}],["`line1`",{"2":{"145":1}}],["`line",{"2":{"72":4}}],["`lat`",{"2":{"158":1}}],["`lon`",{"2":{"158":1}}],["`z`",{"2":{"158":1}}],["``1",{"2":{"158":1}}],["``a``",{"2":{"158":1}}],["``r",{"2":{"158":1}}],["```jldoctest",{"2":{"67":1,"70":1,"72":1,"73":1,"75":1,"88":1,"91":1,"101":1,"104":1,"108":1,"119":1,"122":1,"125":1,"135":1,"145":1,"180":1}}],["```julia",{"2":{"6":2,"60":1,"105":1,"145":1,"153":1,"159":1,"185":2}}],["```math",{"2":{"60":1,"145":1}}],["```",{"2":{"11":1,"60":3,"67":1,"70":1,"72":1,"75":1,"88":1,"91":1,"101":1,"104":1,"108":1,"119":1,"122":1,"125":1,"135":1,"145":3,"146":11,"153":1,"180":1,"185":2,"189":1}}],["`6371008",{"2":{"158":1}}],["`prefilter",{"2":{"180":1}}],["`proj",{"2":{"172":1,"176":2}}],["`planar`",{"2":{"158":1,"177":2}}],["`polgontrait`",{"2":{"153":1}}],["`polygontrait`",{"2":{"153":1,"165":1}}],["`polygonize`",{"2":{"146":2}}],["`polygon`",{"2":{"60":3,"177":1}}],["`polys`",{"2":{"71":1}}],["`poly",{"2":{"71":3,"73":1,"76":1}}],["`pointrait`",{"2":{"180":1}}],["`pointtrait`",{"2":{"156":3,"165":1}}],["`point",{"2":{"116":3}}],["`point`",{"2":{"60":4,"85":1}}],["`point2f`",{"2":{"59":1}}],["`obj`",{"2":{"156":1,"185":1,"188":1}}],["`op`",{"2":{"154":2}}],["`calc",{"2":{"155":1}}],["`crs`",{"2":{"155":1}}],["`components`",{"2":{"156":1}}],["`collect`",{"2":{"154":1}}],["`contains`",{"2":{"101":1,"135":1}}],["`convex",{"2":{"82":2}}],["`covers`",{"2":{"91":1,"104":1}}],["`coveredby`",{"2":{"91":1,"104":1}}],["`+`",{"2":{"154":1}}],["`alg",{"2":{"187":1}}],["`alg`",{"2":{"184":1}}],["`always",{"2":{"172":1}}],["`application",{"2":{"165":1}}],["`apply`",{"2":{"153":1,"159":1}}],["`abstractgeometrytrait`",{"2":{"156":1}}],["`abstractarray`",{"2":{"156":1}}],["`abstractmatrix`",{"2":{"146":1}}],["`union",{"2":{"146":2}}],["`unionintersectingpolygons`",{"2":{"169":1}}],["`unionintersectingpolygons",{"2":{"70":1,"71":2,"72":1,"73":2,"75":1,"76":2}}],["`ys`",{"2":{"146":1}}],["`flattening`",{"2":{"176":1}}],["`flattening",{"2":{"176":1}}],["`flatten`",{"2":{"156":1}}],["`f",{"2":{"153":1}}],["`featurecollectiontrait`",{"2":{"153":1,"156":1}}],["`featurecollection`",{"2":{"146":2}}],["`featuretrait`",{"2":{"153":2,"156":1}}],["`feature`s",{"2":{"146":1}}],["`f`",{"2":{"146":5,"153":3,"154":1,"156":2,"185":2,"187":1}}],["`false`",{"2":{"145":1,"146":1,"155":4,"160":1,"172":1}}],["`fix",{"2":{"70":2,"71":2,"72":2,"73":2,"75":2,"76":2}}],["`douglaspeucker`",{"2":{"180":1}}],["`d`",{"2":{"172":1}}],["`difference`",{"2":{"169":1}}],["`disjoint`",{"2":{"119":1}}],["`delaunaytriangulation",{"2":{"82":1}}],["`within`",{"2":{"101":1,"135":1}}],["`weight`",{"2":{"60":1}}],["`geos`",{"2":{"187":3}}],["`geodesicsegments`",{"2":{"175":1}}],["`geodesic`",{"2":{"158":1,"176":2,"177":2}}],["`geointerface`",{"2":{"165":1}}],["`geointerface",{"2":{"153":1,"156":2,"172":2}}],["`geom`",{"2":{"85":3,"156":1,"177":1}}],["`geometrycollection`",{"2":{"177":1}}],["`geometrycorrection`",{"2":{"163":1,"165":1,"169":2}}],["`geometry`",{"2":{"153":1,"172":2}}],["`geometrybasics",{"2":{"60":3}}],["`geometries`",{"2":{"82":1}}],["`g1`",{"2":{"85":1}}],["`gi",{"2":{"82":1,"146":1}}],["`tuple",{"2":{"189":1}}],["`tuple`s",{"2":{"188":1}}],["`tuple`",{"2":{"146":1,"188":1}}],["`time`",{"2":{"172":1}}],["`transform`",{"2":{"172":1}}],["`true`",{"2":{"91":1,"105":1,"108":2,"125":1,"135":1,"145":2,"146":1,"155":2,"160":1,"172":1}}],["`threaded`",{"2":{"155":1}}],["`threaded==true`",{"2":{"154":1}}],["`tol`",{"2":{"180":2,"181":3,"182":2,"183":3,"184":4}}],["`to",{"2":{"73":1}}],["`target",{"2":{"172":3}}],["`target`",{"2":{"72":1,"153":2,"154":1,"156":1,"159":1}}],["`tables",{"2":{"153":1}}],["`taget`",{"2":{"70":1,"75":1}}],["`method",{"2":{"177":1}}],["`method`",{"2":{"60":3}}],["`max",{"2":{"176":4,"177":3,"187":1}}],["`map`",{"2":{"153":1}}],["`makie",{"2":{"146":1}}],["`multipointtrait`",{"2":{"153":1,"180":1}}],["`multipolygontrait`",{"2":{"153":1}}],["`multipolygon`",{"2":{"146":3,"177":1}}],["`multipolygon",{"2":{"71":3,"73":3,"76":2}}],["`multipoly",{"2":{"71":7,"73":3,"76":3}}],["`minpoints`",{"2":{"146":2}}],["`number`",{"2":{"180":2,"184":3}}],["`namedtuple`",{"2":{"153":1}}],["`nothing`",{"2":{"64":1,"155":1}}],["`next",{"2":{"64":1}}],["`radialdistance`",{"2":{"180":1}}],["`ratio`",{"2":{"180":2,"184":3}}],["`reproject`",{"2":{"173":1}}],["`rebuild`",{"2":{"156":1}}],["`r`",{"2":{"60":1}}],["`rᵢ`",{"2":{"60":1}}],["`svector`",{"2":{"185":3}}],["`simplifyalg`",{"2":{"180":2}}],["`simplify",{"2":{"180":1}}],["`simplify`",{"2":{"180":2}}],["`segmentize`",{"2":{"187":1}}],["`segmentize",{"2":{"177":2}}],["`semimajor",{"2":{"158":1}}],["`source",{"2":{"172":3}}],["`spherical`",{"2":{"158":1,"177":1}}],["`s`",{"2":{"60":1}}],["`sᵢ`",{"2":{"60":2}}],["`s2`",{"2":{"60":1}}],["`s1`",{"2":{"60":1}}],["`hcat`",{"2":{"60":1}}],["`x`",{"2":{"153":1,"160":1}}],["`xs`",{"2":{"146":1}}],["`x1",{"2":{"60":1}}],["`x1`",{"2":{"60":2}}],["`x2`",{"2":{"60":1}}],["`visvalingamwhyatt`",{"2":{"180":1}}],["`vector",{"2":{"172":1}}],["`vector`",{"2":{"146":1,"153":1}}],["`vᵢ`",{"2":{"60":1}}],["`v`",{"2":{"60":1}}],["`values`",{"2":{"60":1,"146":1}}],["`λs`",{"2":{"60":2}}],["`",{"2":{"60":2,"70":1,"71":2,"72":1,"73":3,"75":1,"76":2,"146":3,"153":2,"154":1,"158":1,"165":2,"172":2,"177":1,"180":3,"187":2,"189":1}}],["`boolsastypes`",{"2":{"160":1}}],["`bool`",{"2":{"146":2}}],["`barycentric",{"2":{"60":3}}],["`buffer`",{"2":{"57":1}}],["π",{"2":{"53":1,"180":1}}],["δbay",{"2":{"73":3}}],["δbax",{"2":{"73":3}}],["δby",{"2":{"73":5}}],["δbx",{"2":{"73":5}}],["δb",{"2":{"73":2}}],["δay",{"2":{"73":5}}],["δax",{"2":{"73":5}}],["δa",{"2":{"73":2}}],["δintrs",{"2":{"64":2}}],["δy2",{"2":{"145":2}}],["δy1",{"2":{"145":2}}],["δyl",{"2":{"122":4}}],["δy",{"2":{"53":8,"69":3,"116":7}}],["δys",{"2":{"53":1}}],["δx2",{"2":{"145":2}}],["δx1",{"2":{"145":2}}],["δxl",{"2":{"122":4}}],["δx",{"2":{"53":9,"69":3,"116":7}}],["∈",{"2":{"14":1}}],["~",{"2":{"14":3}}],["$ratio",{"2":{"184":1}}],["$rectangle",{"2":{"176":2}}],["$number",{"2":{"184":1}}],["$name",{"2":{"31":2}}],["$min",{"2":{"184":1}}],["$douglas",{"2":{"180":1,"182":1}}],["$simplify",{"2":{"180":1,"181":1,"183":1}}],["$lg",{"2":{"176":1}}],["$lin",{"2":{"176":2}}],["$geom",{"2":{"180":8}}],["$geo",{"2":{"176":1}}],["$calc",{"2":{"155":1}}],["$crs",{"2":{"155":1,"170":1}}],["$apply",{"2":{"153":1,"171":1,"172":1,"180":1}}],["$tol",{"2":{"184":1}}],["$threaded",{"2":{"155":1}}],["$t",{"2":{"88":1,"153":2,"154":2}}],["$target",{"2":{"71":1,"73":1,"76":1,"156":3}}],["$trait",{"2":{"67":1,"71":2,"73":2,"76":2}}],["$",{"2":{"13":4,"14":1,"60":4,"64":2,"146":3,"165":4,"177":4,"180":12,"187":1}}],["|=",{"2":{"116":4,"122":1}}],["||",{"2":{"53":2,"64":13,"67":1,"69":8,"72":1,"73":5,"75":1,"88":18,"105":2,"116":8,"122":1,"127":1,"146":7,"182":1,"184":3}}],["|",{"2":{"11":4,"116":1}}],["|>",{"2":{"11":8,"13":2,"156":3,"175":1,"176":1,"180":3,"199":2}}],["↩︎",{"2":{"6":1}}],["ᵢᵢᵢ₊₁ᵢᵢ₊₁ᵢᵢ₊₁tᵢ=det",{"2":{"6":1}}],["⋅",{"2":{"6":1,"60":1}}],["qy",{"2":{"13":2,"14":2}}],["qx",{"2":{"13":2,"14":2}}],["q",{"2":{"13":13,"14":12,"64":4}}],["qhull",{"2":{"6":1,"82":1}}],["queue",{"2":{"182":41}}],["questions",{"2":{"73":1}}],["quite",{"2":{"162":1,"199":1}}],["quickhull",{"2":{"6":1,"77":1,"82":2}}],["quick",{"2":{"4":1,"6":1,"60":1,"170":1,"179":1}}],["quality",{"2":{"6":1,"180":1}}],["quantity",{"2":{"6":1,"176":1}}],["quot",{"2":{"1":4,"6":6,"20":2,"64":8,"84":2,"85":2,"88":2,"103":4,"116":10,"150":4,"151":2,"153":2,"154":2,"156":4,"174":6,"191":2,"198":2}}],["zone",{"2":{"192":1}}],["zoom",{"2":{"14":1}}],["zs",{"2":{"146":5}}],["zip",{"2":{"13":1,"14":1,"191":4,"192":1,"193":1}}],["zeros",{"2":{"60":1,"69":1}}],["zero",{"2":{"4":6,"6":8,"56":11,"63":3,"64":4,"69":11,"73":22,"84":1,"85":3,"145":1,"153":1,"182":4}}],["z",{"2":{"4":1,"5":1,"6":2,"60":3,"88":3,"146":3,"158":1,"171":1,"185":1,"188":1}}],["0e6",{"2":{"192":6}}],["0example",{"2":{"6":1}}],["097075198097933",{"2":{"193":1}}],["09707519809793252",{"2":{"193":2}}],["091887951911644",{"2":{"193":3}}],["0999933334666654",{"2":{"191":1}}],["09801605542096",{"2":{"191":1}}],["098016055420953",{"2":{"191":3}}],["09297443860091348",{"2":{"191":4}}],["09",{"2":{"59":1}}],["08506974233813636",{"2":{"193":2}}],["08",{"2":{"59":1}}],["062749678615475",{"2":{"193":1}}],["06274967861547665",{"2":{"193":2}}],["06592462566760626",{"2":{"191":1}}],["0650624499034016",{"2":{"191":4}}],["06",{"2":{"59":1}}],["02017324484778",{"2":{"193":1}}],["020173244847778715",{"2":{"193":2}}],["027886421973952302",{"2":{"191":4}}],["02",{"2":{"59":3}}],["04500741774392",{"2":{"193":1}}],["045007417743918",{"2":{"193":2}}],["049999166670833324",{"2":{"191":1}}],["0438052480035",{"2":{"191":1}}],["043805248003498",{"2":{"191":3}}],["04",{"2":{"59":6}}],["07518688541961",{"2":{"193":1}}],["075186885419612",{"2":{"193":2}}],["071",{"2":{"175":2,"176":2}}],["07",{"2":{"59":6,"175":6,"176":6}}],["009176636029576",{"2":{"193":1}}],["0091766360295773",{"2":{"193":2}}],["003135308800957",{"2":{"193":1}}],["0031353088009582475",{"2":{"193":2}}],["0035114210915891397",{"2":{"191":4}}],["006784125578492062",{"2":{"193":2}}],["0020133807972559925",{"2":{"193":2}}],["00839489109211",{"2":{"193":3}}],["008696",{"2":{"3":1,"6":3,"72":1,"73":1,"118":1,"119":1}}],["005465967083412071",{"2":{"191":4}}],["00111595449914",{"2":{"191":1}}],["001115954499138",{"2":{"191":3}}],["0010075412835199304",{"2":{"191":4}}],["001",{"2":{"180":1}}],["00085222666982",{"2":{"193":3}}],["000577332369005",{"2":{"193":1}}],["0005773323690041465",{"2":{"193":2}}],["000510363870095e6",{"2":{"192":2}}],["00025191811248184703",{"2":{"193":2}}],["000215611503127e6",{"2":{"192":2}}],["0007260527263e6",{"2":{"192":2}}],["000342160541625e6",{"2":{"192":2}}],["000124843834609e6",{"2":{"192":2}}],["000063948817746e6",{"2":{"192":2}}],["000026987852369e6",{"2":{"192":2}}],["000008144045314",{"2":{"193":1}}],["000007998400139e6",{"2":{"192":2}}],["000000999950001e6",{"2":{"192":2}}],["00001e6",{"2":{"192":1}}],["0004397316773170068",{"2":{"191":4}}],["000",{"2":{"180":1,"196":1}}],["00",{"2":{"59":2}}],["053798628882221644",{"2":{"193":2}}],["05877989361332",{"2":{"191":1}}],["058779893613323",{"2":{"191":3}}],["05416726609360478",{"2":{"191":4}}],["05",{"2":{"59":1}}],["052704767595",{"2":{"15":1}}],["037564867762832",{"2":{"193":1}}],["03756486776283019",{"2":{"193":2}}],["031245035570328428",{"2":{"193":2}}],["033518309870985",{"2":{"193":3}}],["03503632062070827",{"2":{"191":4}}],["03",{"2":{"59":4}}],["01458815628695",{"2":{"193":3}}],["016044338630866517",{"2":{"193":2}}],["01592650896568995",{"2":{"191":1}}],["01597247419241532",{"2":{"191":4}}],["01908693278165",{"2":{"191":1}}],["019086932781654",{"2":{"191":3}}],["01098781325325",{"2":{"191":1}}],["010987813253244",{"2":{"191":3}}],["011814947665167774",{"2":{"191":4}}],["01362848005",{"2":{"15":1}}],["01",{"2":{"14":1,"59":1,"175":1,"176":1,"191":1,"192":1,"193":1}}],["0^",{"2":{"13":2,"14":2}}],["0+2",{"2":{"13":2,"14":2}}],["0",{"2":{"3":35,"4":12,"6":190,"11":1,"13":5,"14":8,"15":32,"52":20,"53":3,"55":9,"56":4,"59":155,"60":2,"62":6,"63":6,"64":49,"66":22,"67":49,"68":13,"69":5,"70":42,"72":2,"73":21,"75":46,"76":2,"80":1,"84":20,"85":2,"87":13,"88":18,"90":6,"91":6,"100":16,"103":6,"104":12,"105":9,"107":15,"116":37,"121":13,"122":9,"124":12,"125":11,"134":16,"145":21,"146":7,"158":1,"162":24,"168":64,"169":4,"175":16,"176":13,"177":2,"180":11,"182":7,"184":4,"189":2,"191":129,"192":2,"193":46,"198":13}}],[">=",{"2":{"60":6,"105":4,"122":1,"184":1}}],[">geometryops",{"2":{"6":2}}],[">",{"2":{"1":1,"6":6,"11":2,"13":1,"15":2,"50":1,"53":1,"60":1,"64":17,"67":5,"69":3,"70":1,"71":1,"73":2,"75":1,"76":3,"84":1,"88":1,"105":8,"116":10,"122":2,"145":4,"146":12,"156":6,"165":1,"169":3,"177":3,"180":1,"182":12,"184":3,"185":1,"189":1,"199":1}}],["914930257661865",{"2":{"193":1}}],["96875496442967",{"2":{"193":1}}],["961329",{"2":{"3":1,"6":3,"72":1,"73":1,"118":1,"119":1}}],["983955661369134",{"2":{"193":1}}],["9833",{"2":{"15":1}}],["9877550012664",{"2":{"191":1}}],["9840085315131",{"2":{"191":1}}],["98271048511609",{"2":{"191":1}}],["98661575256801",{"2":{"191":1}}],["99321587442151",{"2":{"193":1}}],["99375130197483",{"2":{"191":1}}],["997986619202745",{"2":{"193":1}}],["997750168744936",{"2":{"191":1}}],["997247091122496",{"2":{"191":1}}],["99600053330489",{"2":{"191":1}}],["991002699676024",{"2":{"191":1}}],["990022362600165",{"2":{"191":1}}],["99292997455441",{"2":{"191":1}}],["99533829767195",{"2":{"191":1}}],["99865616402829",{"2":{"191":1}}],["999999967681458e6",{"2":{"192":2}}],["999997707902938e6",{"2":{"192":2}}],["999987539891298e6",{"2":{"192":2}}],["999963474314044e6",{"2":{"192":2}}],["999919535736425e6",{"2":{"192":2}}],["999974634566875",{"2":{"191":1}}],["999849768598615e6",{"2":{"192":2}}],["999748081887518",{"2":{"193":1}}],["999748243174828e6",{"2":{"192":2}}],["999750002083324",{"2":{"191":1}}],["999609061508909e6",{"2":{"192":2}}],["999426363321033e6",{"2":{"192":2}}],["999194331880103e6",{"2":{"192":2}}],["99900003333289",{"2":{"191":1}}],["999565375483215",{"2":{"191":1}}],["97976366505997",{"2":{"191":1}}],["9783069507679",{"2":{"191":1}}],["97",{"2":{"59":1}}],["946201371117777",{"2":{"193":1}}],["94",{"2":{"59":1}}],["92",{"2":{"59":1}}],["9im",{"0":{"39":1},"1":{"40":1,"41":1,"42":1,"43":1,"44":1,"45":1,"46":1,"47":1,"48":1,"49":1},"2":{"116":2,"197":1}}],["95770326033",{"2":{"15":1}}],["95",{"2":{"13":1,"14":1,"196":1}}],["900",{"2":{"176":1}}],["90063612163",{"2":{"11":2}}],["90`",{"2":{"158":1}}],["90",{"2":{"52":9,"59":1}}],["909318372607",{"2":{"11":3}}],["9",{"2":{"1":1,"6":1,"116":2,"145":12,"175":1,"185":1}}],["897070",{"2":{"196":1}}],["873633668827033",{"2":{"193":1}}],["8135804051007",{"2":{"191":1}}],["813580405100698",{"2":{"191":3}}],["88",{"2":{"59":1}}],["86641841658641",{"2":{"191":1}}],["866418416586406",{"2":{"191":3}}],["86",{"2":{"59":1}}],["868447876892",{"2":{"15":2}}],["84",{"2":{"59":1}}],["821068835162155",{"2":{"193":1}}],["82",{"2":{"59":1}}],["800",{"2":{"59":1}}],["80000",{"2":{"15":5}}],["80",{"2":{"59":1}}],["80869813739",{"2":{"15":2}}],["856614689791036e",{"2":{"15":2}}],["83572303404496",{"2":{"6":2,"72":1,"73":1}}],["8",{"2":{"1":3,"6":9,"13":1,"14":1,"70":2,"75":4,"116":1,"146":3,"158":2,"175":1,"185":3,"193":2}}],["karnataka",{"2":{"199":1}}],["kbn",{"2":{"11":2}}],["kinds",{"2":{"23":1}}],["kind",{"2":{"9":1,"146":1,"197":1}}],["k",{"2":{"6":1,"14":6,"60":1,"64":5,"116":5,"191":5,"193":5}}],["kernel",{"2":{"177":4}}],["keepat",{"2":{"75":1,"169":2}}],["keep",{"2":{"64":3,"146":1,"169":14,"175":1,"198":1}}],["keeping",{"2":{"6":1,"153":1,"171":1}}],["keys",{"2":{"146":4,"153":1}}],["key",{"2":{"6":1,"146":4,"153":2,"187":5}}],["keyword",{"0":{"155":1},"2":{"6":8,"23":1,"31":3,"70":1,"72":1,"75":1,"153":1,"155":7,"170":2,"176":2,"187":4,"192":1,"193":1}}],["keywords",{"2":{"1":2,"4":1,"6":10,"31":1,"116":2,"146":1,"153":1,"155":1,"170":1,"171":2,"172":3,"180":8,"181":1,"182":1,"183":1,"184":1,"188":2}}],["known",{"2":{"69":2}}],["know",{"2":{"6":3,"53":2,"64":1,"69":1,"70":1,"72":1,"73":2,"75":1,"76":1,"153":1,"198":1}}],["kwargs",{"2":{"32":2,"57":3,"67":1,"69":1,"70":3,"71":3,"72":4,"73":5,"75":3,"76":5,"165":2,"173":1,"176":1}}],["kwdef",{"2":{"31":1,"64":1,"158":2,"176":1,"181":1,"182":1,"183":1}}],["kw",{"2":{"1":1,"6":10,"116":10,"146":20,"150":1,"153":18,"154":3,"156":2,"171":3,"180":15,"183":1,"185":3,"187":6,"188":3}}],["json",{"2":{"195":3}}],["jstep",{"2":{"88":3}}],["jstart",{"2":{"88":7}}],["joined",{"2":{"198":4}}],["joins",{"0":{"197":1},"1":{"198":1,"199":1,"200":1},"2":{"197":3}}],["joinpath",{"2":{"180":2}}],["join",{"2":{"153":1,"154":1,"197":4,"198":5,"200":1}}],["joining",{"2":{"6":2,"180":1,"197":1}}],["jpn",{"2":{"199":2}}],["jp",{"2":{"88":2}}],["jhole",{"2":{"88":2}}],["jh",{"2":{"76":5}}],["j+1",{"2":{"64":1,"146":1,"184":1}}],["j",{"2":{"64":24,"88":8,"105":9,"116":12,"145":2,"146":8,"184":2}}],["jet",{"2":{"59":1}}],["just",{"2":{"4":1,"6":1,"32":1,"63":1,"64":2,"73":4,"76":1,"81":1,"85":2,"146":1,"151":1,"153":2,"154":1,"157":1,"176":1,"177":1,"197":1}}],["julialand",{"2":{"192":2}}],["julialines",{"2":{"55":1}}],["julialinearsegments",{"2":{"6":1}}],["juliahole",{"2":{"191":1}}],["juliaplot",{"2":{"192":2}}],["juliap1",{"2":{"191":1}}],["juliapoly",{"2":{"192":1}}],["juliapolygon3",{"2":{"192":1}}],["juliapolygon1",{"2":{"191":1}}],["juliapolygonize",{"2":{"6":1}}],["juliapolygon",{"2":{"6":1}}],["juliapoints",{"2":{"198":1}}],["juliapoint",{"2":{"191":1}}],["juliaxoffset",{"2":{"191":3,"193":1}}],["juliax",{"2":{"191":2}}],["juliaxrange",{"2":{"84":1}}],["julia$apply",{"2":{"188":1}}],["julia$threaded",{"2":{"170":1}}],["julia6",{"2":{"180":1}}],["julia```jldoctest",{"2":{"189":1}}],["julia```julia",{"2":{"146":1}}],["julia```",{"2":{"105":1,"159":1}}],["julia1",{"2":{"70":1,"72":1,"73":1,"75":1}}],["julia2",{"2":{"67":1}}],["juliabase",{"2":{"60":1,"85":4,"153":1,"187":1}}],["juliabarycentric",{"2":{"5":3,"6":3}}],["juliafig",{"2":{"191":1,"192":1}}],["juliaflexijoins",{"2":{"200":1}}],["juliaflatten",{"2":{"156":1}}],["juliaflipped",{"2":{"148":1}}],["juliaflip",{"2":{"6":1}}],["juliafalse",{"2":{"145":1}}],["juliafunction",{"2":{"32":1,"35":1,"36":1,"37":1,"38":1,"40":1,"41":1,"42":1,"43":1,"44":1,"45":1,"46":1,"47":1,"48":1,"49":1,"50":1,"53":2,"57":2,"60":3,"63":1,"64":11,"67":1,"69":2,"71":1,"73":2,"76":1,"82":1,"85":8,"116":6,"122":2,"127":1,"147":1,"154":2,"156":4,"173":1,"176":1,"177":1,"184":2}}],["juliafor",{"2":{"31":1,"153":1,"154":1}}],["juliagi",{"2":{"11":2}}],["juliago",{"2":{"11":1,"52":1,"55":1,"68":1,"87":1,"90":1,"100":1,"103":1,"107":1,"118":1,"121":1,"124":1,"134":1,"197":1}}],["juliageopoly1",{"2":{"193":1}}],["juliageointerface",{"2":{"189":1}}],["juliageometry",{"2":{"82":1}}],["juliageo",{"2":{"6":2,"158":1}}],["juliageodesicsegments",{"2":{"6":1}}],["juliageos",{"2":{"6":1}}],["juliaweighted",{"2":{"6":1}}],["juliawithin",{"2":{"3":1,"6":1}}],["juliaunwrap",{"2":{"156":7}}],["juliaunion",{"2":{"6":1}}],["juliaunionintersectingpolygons",{"2":{"6":1,"166":1}}],["juliausing",{"2":{"6":1,"13":1,"14":1,"59":1,"175":2,"176":1,"179":1,"180":1,"194":1,"197":1}}],["juliascatter",{"2":{"198":1}}],["juliasource",{"2":{"192":2}}],["juliasimplify",{"2":{"6":1,"180":3}}],["juliasigned",{"2":{"4":2,"6":2}}],["juliasegmentize",{"2":{"6":1,"177":1}}],["julias1",{"2":{"6":1}}],["juliavisvalingamwhyatt",{"2":{"6":1}}],["juliaring3",{"2":{"192":1}}],["juliaring1",{"2":{"191":1}}],["juliar",{"2":{"191":2,"192":1,"193":1}}],["juliarebuild",{"2":{"156":1}}],["juliareconstruct",{"2":{"156":1}}],["juliareproject",{"2":{"1":1}}],["juliaradialdistance",{"2":{"6":1}}],["juliamy",{"2":{"200":1}}],["juliamultipoly",{"2":{"180":1}}],["juliamodule",{"2":{"31":1}}],["juliamonotonechainmethod",{"2":{"6":1}}],["juliameanvalue",{"2":{"6":1}}],["juliadf",{"2":{"194":1}}],["juliadestination",{"2":{"192":1}}],["juliadouglaspeucker",{"2":{"6":1}}],["juliadifference",{"2":{"6":1}}],["juliadiffintersectingpolygons",{"2":{"6":1,"166":1}}],["juliadistance",{"2":{"4":1,"6":1}}],["juliadisjoint",{"2":{"3":1,"6":1}}],["juliaexport",{"2":{"51":1,"54":1,"58":1,"61":1,"65":1,"70":1,"72":1,"75":1,"83":1,"86":1,"89":1,"99":1,"102":1,"106":1,"117":1,"120":1,"123":1,"133":1,"143":1,"146":1,"148":1,"154":1,"158":1,"161":1,"164":1,"167":1,"172":1,"174":1,"180":1,"186":1}}],["juliaend",{"2":{"85":1}}],["juliaenforce",{"2":{"6":1}}],["juliaenum",{"2":{"6":2}}],["juliaembed",{"2":{"4":1,"6":1}}],["juliaequals",{"2":{"4":15,"6":15,"64":1}}],["juliaaccuratearithmetic",{"2":{"11":2}}],["juliaabstract",{"2":{"6":3,"165":1,"166":1,"176":1}}],["juliaangles",{"2":{"4":1,"6":1}}],["juliaarea",{"2":{"4":1,"6":1}}],["juliaapplyreduce",{"2":{"1":1,"150":1}}],["juliaapply",{"2":{"1":1,"18":1,"150":1}}],["juliacent",{"2":{"62":1}}],["juliacentroid",{"2":{"4":1,"6":3}}],["juliacut",{"2":{"6":1}}],["juliaclosedring",{"2":{"6":1,"166":1}}],["juliaconst",{"2":{"53":1,"56":1,"60":1,"64":1,"69":2,"85":1,"91":1,"108":1,"125":1,"135":1,"155":1}}],["juliaconvex",{"2":{"6":1,"82":1}}],["juliacontains",{"2":{"3":1,"6":1}}],["juliacoverage",{"2":{"6":1}}],["juliacovers",{"2":{"3":1,"6":1}}],["juliacoveredby",{"2":{"3":1,"6":1}}],["juliatraittarget",{"2":{"159":1}}],["juliatransform",{"2":{"1":1,"6":1}}],["juliatrue",{"2":{"88":1,"91":1,"101":1,"104":1,"108":1,"119":1,"122":1,"125":1,"135":1,"145":1}}],["juliatuples",{"2":{"6":1}}],["juliat",{"2":{"6":1}}],["juliatouches",{"2":{"3":1,"6":1}}],["juliaoverlaps",{"2":{"3":9,"6":9}}],["juliainnerjoin",{"2":{"199":1}}],["juliaintersection",{"2":{"6":2}}],["juliaintersects",{"2":{"3":1}}],["juliaisconcave",{"2":{"6":1}}],["juliaisclockwise",{"2":{"6":1}}],["juliaimport",{"2":{"1":1,"3":9,"4":1,"6":17,"11":1,"32":1,"52":1,"55":1,"62":1,"66":1,"68":1,"79":1,"80":1,"81":1,"84":1,"87":1,"90":1,"100":1,"103":1,"107":1,"118":1,"121":1,"124":1,"134":1,"150":1,"162":2,"168":2,"175":1,"195":4,"196":1,"198":1,"199":1}}],["julia",{"2":{"3":1,"6":5,"9":1,"15":1,"25":1,"27":1,"31":1,"32":2,"53":4,"56":10,"60":8,"63":19,"64":60,"67":10,"69":18,"70":6,"71":1,"72":5,"73":29,"75":6,"76":4,"77":1,"82":5,"84":1,"85":4,"88":15,"92":1,"93":5,"94":1,"95":1,"96":2,"97":1,"98":1,"101":1,"104":1,"105":3,"109":1,"110":3,"111":1,"112":1,"113":1,"114":1,"115":1,"116":50,"119":1,"122":7,"126":1,"127":3,"128":1,"129":1,"130":1,"131":1,"132":1,"136":1,"137":3,"138":1,"139":1,"140":2,"141":1,"142":1,"145":9,"146":40,"147":2,"153":44,"154":18,"156":11,"159":1,"160":1,"163":5,"165":1,"169":3,"170":1,"171":1,"172":1,"176":1,"177":2,"180":1,"181":2,"182":15,"183":3,"185":1,"186":1,"187":4,"188":1,"189":1,"190":2,"192":2,"195":2,"198":1}}],["julia>",{"2":{"1":5,"6":7,"145":3,"185":7}}],["juliajulia>",{"2":{"1":2,"6":3}}],["jl`",{"2":{"82":1,"172":1,"187":1}}],["jlmethod",{"2":{"6":2}}],["jlobjecttype",{"2":{"6":2}}],["jlbinding",{"2":{"6":2}}],["jldocstring",{"2":{"6":2}}],["jldoctest",{"2":{"6":1}}],["jl",{"0":{"25":1,"31":1},"2":{"1":10,"4":1,"6":15,"10":2,"11":1,"22":2,"25":2,"27":2,"31":42,"32":1,"50":1,"53":1,"56":1,"57":3,"60":1,"63":1,"64":1,"67":1,"69":1,"71":1,"73":1,"74":1,"76":1,"77":3,"82":6,"85":1,"88":1,"98":1,"101":1,"104":1,"105":1,"115":1,"116":1,"119":1,"122":1,"132":1,"142":1,"145":2,"146":1,"147":1,"153":2,"154":1,"155":1,"156":3,"158":1,"160":2,"163":1,"166":1,"169":1,"170":2,"171":1,"172":4,"173":3,"174":1,"176":3,"177":2,"180":2,"184":1,"185":6,"187":2,"188":2,"189":1,"192":1,"197":1}}],["+5000000",{"2":{"192":1}}],["+proj=natearth2",{"2":{"192":2}}],["+=",{"2":{"56":2,"60":11,"63":6,"64":17,"67":1,"69":10,"88":1,"105":1,"116":5,"145":1,"169":2,"182":4,"189":3}}],["+",{"2":{"1":1,"6":1,"13":1,"14":1,"53":4,"56":1,"60":20,"63":10,"64":15,"67":1,"69":7,"73":10,"85":3,"88":2,"105":2,"116":6,"145":6,"146":2,"150":1,"169":3,"177":2,"182":3,"183":2,"184":2,"191":6,"192":1,"193":4}}],["yticklabelsvisible",{"2":{"192":1}}],["york",{"2":{"199":1}}],["yoffset",{"2":{"191":7,"193":2}}],["your",{"0":{"195":1},"2":{"18":1,"57":1,"146":1,"148":1,"173":1,"176":1,"194":1,"195":1,"200":2}}],["you",{"0":{"23":1},"2":{"1":1,"4":1,"5":2,"6":9,"9":1,"11":1,"17":1,"18":5,"23":1,"29":2,"53":1,"56":1,"57":1,"60":8,"63":1,"70":1,"72":1,"75":1,"81":1,"82":1,"148":1,"153":1,"154":1,"159":1,"162":1,"168":1,"173":1,"175":1,"176":1,"185":1,"192":1,"194":2,"195":3,"198":2,"199":3,"200":4}}],["y=y",{"2":{"189":1}}],["yvec",{"2":{"146":4}}],["ybounds",{"2":{"146":4}}],["yhalf",{"2":{"146":2}}],["ylast",{"2":{"85":3}}],["yfirst",{"2":{"85":5}}],["y0",{"2":{"85":5}}],["yw",{"2":{"69":4}}],["ye",{"2":{"69":4}}],["yet",{"0":{"147":1},"2":{"31":1,"60":1,"67":1,"71":1,"73":1,"76":1,"88":1,"146":1,"147":1,"165":2,"199":1}}],["y2",{"2":{"63":2,"69":18,"85":7,"105":10,"116":5,"122":4,"146":5,"177":6,"189":2}}],["y1",{"2":{"63":2,"69":22,"85":7,"105":11,"116":6,"122":5,"146":5,"177":7,"189":2}}],["yind+1",{"2":{"146":1}}],["yind",{"2":{"146":2}}],["yinterior",{"2":{"63":2}}],["yield",{"2":{"73":1,"176":1}}],["yi+yi−1",{"2":{"6":1}}],["ycentroid",{"2":{"63":13}}],["yrange",{"2":{"59":3,"84":3}}],["yautolimits",{"2":{"59":2}}],["yp2",{"2":{"53":4}}],["ys",{"2":{"6":3,"146":30}}],["ymax",{"2":{"6":1,"68":2,"69":48}}],["ymin",{"2":{"6":1,"68":2,"69":49}}],["y",{"2":{"1":2,"4":1,"6":3,"13":9,"14":10,"53":8,"56":2,"59":8,"62":1,"63":10,"64":6,"68":1,"69":8,"71":6,"73":8,"84":2,"85":7,"88":3,"105":21,"116":16,"122":7,"145":10,"148":2,"150":1,"153":1,"171":4,"172":1,"177":2,"184":1,"185":2,"188":2,"189":7,"191":8,"192":2,"193":2,"197":1}}],["75",{"2":{"84":2,"100":1,"107":1,"134":1}}],["78",{"2":{"59":1}}],["749907",{"2":{"196":1}}],["74",{"2":{"59":1}}],["72",{"2":{"59":1}}],["726711609794",{"2":{"15":1}}],["76",{"2":{"59":1}}],["76085",{"2":{"15":1}}],["768946",{"2":{"3":1,"6":3,"72":1,"73":1,"118":1,"119":1}}],["70440582002419",{"2":{"191":1}}],["704405820024185",{"2":{"191":3}}],["704377648755",{"2":{"15":2}}],["700",{"2":{"14":1}}],["700454",{"2":{"6":1,"179":1,"180":1}}],["701141",{"2":{"6":1,"179":1,"180":1}}],["70",{"2":{"6":20,"59":1,"179":20,"180":20,"191":20}}],["738281",{"2":{"3":1,"6":3,"72":1,"73":1,"118":1,"119":1}}],["7",{"2":{"1":5,"6":4,"116":1,"150":1,"153":1,"175":4,"176":4,"185":4,"193":1}}],["65533525026046",{"2":{"191":1}}],["655335250260467",{"2":{"191":3}}],["659942",{"2":{"6":1,"179":1,"180":1}}],["6378137",{"2":{"158":1}}],["6371008",{"2":{"158":1}}],["639343",{"2":{"6":1,"179":1,"180":1}}],["6area",{"2":{"63":2}}],["66",{"2":{"59":1}}],["668869",{"2":{"6":1,"179":1,"180":1}}],["64744840486518",{"2":{"193":3}}],["64",{"2":{"59":1,"175":2,"176":2}}],["646209",{"2":{"6":1,"179":1,"180":1}}],["629",{"2":{"192":1}}],["62",{"2":{"59":1}}],["624923",{"2":{"6":1,"179":1,"180":1}}],["61366192682",{"2":{"15":1}}],["614624",{"2":{"6":1,"179":1,"180":1}}],["605000000000004",{"2":{"175":2}}],["60",{"2":{"59":1,"175":2}}],["60000",{"2":{"15":3}}],["609817",{"2":{"6":1,"179":1,"180":1}}],["603637",{"2":{"6":2,"179":2,"180":2}}],["68",{"2":{"59":1}}],["682601",{"2":{"6":1,"179":1,"180":1}}],["683975",{"2":{"6":1,"179":1,"180":1}}],["69159119078359",{"2":{"193":3}}],["694274",{"2":{"6":1,"179":1,"180":1}}],["697021",{"2":{"6":1,"179":1,"180":1}}],["6",{"2":{"1":12,"3":4,"6":20,"70":3,"75":3,"116":1,"122":4,"150":3,"153":3,"180":1,"185":9,"193":2}}],["51695367760999",{"2":{"193":1}}],["516953677609987",{"2":{"193":2}}],["51030066635026",{"2":{"191":4}}],["5e6",{"2":{"192":2}}],["55715336218991",{"2":{"193":1}}],["557153362189904",{"2":{"193":2}}],["55",{"2":{"191":3}}],["55494217175954",{"2":{"191":4}}],["57",{"2":{"175":4,"176":4}}],["57725",{"2":{"15":2}}],["5x",{"2":{"153":1}}],["563198",{"2":{"73":1}}],["56",{"2":{"59":1}}],["54",{"2":{"59":1,"191":19}}],["50",{"2":{"59":1,"175":4,"176":4,"191":3}}],["500000",{"2":{"192":1}}],["50000",{"2":{"15":1}}],["500",{"2":{"14":1,"192":1}}],["5d",{"2":{"25":1,"27":1,"158":1}}],["52",{"2":{"59":1,"196":1}}],["52521",{"2":{"15":1}}],["52709",{"2":{"15":2}}],["594711",{"2":{"6":1,"179":1,"180":1}}],["590591",{"2":{"6":1,"179":1,"180":1}}],["595397",{"2":{"6":1,"179":1,"180":1}}],["535",{"2":{"175":4}}],["5355",{"2":{"175":2}}],["53333",{"2":{"15":4}}],["53",{"2":{"6":10,"175":2,"189":10}}],["58",{"2":{"59":1}}],["58059",{"2":{"15":2}}],["587158",{"2":{"6":2,"179":2,"180":2}}],["58375366067548",{"2":{"6":2,"72":1,"73":1}}],["584961",{"2":{"3":1,"6":3,"72":1,"73":1,"118":1,"119":1}}],["5",{"2":{"1":29,"3":4,"4":8,"6":82,"13":1,"59":1,"66":5,"67":8,"70":16,"75":18,"84":8,"88":8,"116":1,"122":4,"146":1,"150":2,"153":2,"175":1,"176":1,"185":27,"191":32,"192":25,"200":1}}],["4983491639274692e6",{"2":{"192":2}}],["4986507085647392e6",{"2":{"192":2}}],["497205585568957e6",{"2":{"192":2}}],["4976022389592e6",{"2":{"192":2}}],["4957639801366436e6",{"2":{"192":2}}],["4940253560034204e6",{"2":{"192":2}}],["4946113281484335e6",{"2":{"192":2}}],["491990928929295e6",{"2":{"192":2}}],["4904357734399722e6",{"2":{"192":2}}],["4926709788709967e6",{"2":{"192":2}}],["4962554647802354e6",{"2":{"192":2}}],["499984780817334e6",{"2":{"192":2}}],["4997392479570867e6",{"2":{"192":2}}],["4991939151049731e6",{"2":{"192":2}}],["4994001399837343e6",{"2":{"192":2}}],["4998500087497458e6",{"2":{"192":2}}],["49",{"2":{"146":1}}],["43541888381864",{"2":{"193":3}}],["4326",{"2":{"192":2,"193":3}}],["43787",{"2":{"15":1}}],["439295815226",{"2":{"15":1}}],["434306",{"2":{"6":1,"179":1,"180":1}}],["4896621210021754e6",{"2":{"192":2}}],["489271",{"2":{"6":4,"189":4}}],["4870405593989636e6",{"2":{"192":2}}],["4879072738504685e6",{"2":{"192":2}}],["484003",{"2":{"145":4}}],["482551",{"2":{"145":4}}],["48268",{"2":{"15":1}}],["48",{"2":{"59":1}}],["48001",{"2":{"15":1}}],["45",{"2":{"59":2,"145":12,"191":2}}],["450",{"2":{"13":1}}],["458369",{"2":{"6":2,"179":2,"180":2}}],["42004014766201",{"2":{"191":1}}],["420040147662014",{"2":{"191":3}}],["4219350464667047e",{"2":{"191":4}}],["42",{"2":{"13":1,"14":1,"59":3}}],["426283",{"2":{"6":1,"179":1,"180":1}}],["400",{"2":{"59":3}}],["40000",{"2":{"15":1}}],["40",{"2":{"14":1,"59":3}}],["406224",{"2":{"6":1,"179":1,"180":1}}],["404504",{"2":{"6":1,"179":1,"180":1}}],["41544701408748197",{"2":{"191":1}}],["41",{"2":{"59":1,"193":20}}],["41878",{"2":{"15":1}}],["414248",{"2":{"6":1,"179":1,"180":1}}],["419406",{"2":{"6":1,"179":1,"180":1}}],["4493927459900552",{"2":{"191":1}}],["44121252392",{"2":{"15":1}}],["44",{"2":{"14":1,"59":2}}],["442901",{"2":{"6":1,"179":1,"180":1}}],["446339",{"2":{"6":1,"179":1,"180":1}}],["477985",{"2":{"145":4}}],["47",{"2":{"59":3}}],["473835",{"2":{"6":1,"179":1,"180":1}}],["472117",{"2":{"6":2,"179":2,"180":2}}],["46525251631344455",{"2":{"191":1}}],["465816",{"2":{"6":1,"179":1,"180":1}}],["46",{"2":{"59":3}}],["468107",{"2":{"6":1,"179":1,"180":1}}],["464547",{"2":{"6":6,"189":6}}],["4",{"2":{"1":11,"3":4,"6":12,"9":2,"13":2,"14":1,"52":1,"69":1,"101":1,"104":1,"108":1,"116":2,"135":1,"145":1,"150":3,"153":3,"175":1,"182":1,"185":8,"192":20,"195":2,"196":1}}],["358421",{"2":{"196":1}}],["3585",{"2":{"175":1}}],["35",{"2":{"59":3}}],["354492",{"2":{"3":1,"6":3,"72":1,"73":1,"118":1,"119":1}}],["38042741557976",{"2":{"191":1}}],["380427415579764",{"2":{"191":3}}],["38",{"2":{"59":3}}],["3655999675063154",{"2":{"191":1}}],["36",{"2":{"59":2}}],["360",{"2":{"53":1}}],["36022",{"2":{"15":1}}],["327284472232776",{"2":{"193":3}}],["32610",{"2":{"192":3}}],["32",{"2":{"59":3}}],["377956",{"2":{"196":1}}],["37",{"2":{"59":5}}],["3497142366876638",{"2":{"191":1}}],["34",{"2":{"59":3}}],["347821afdac1a9ec607aa2939464014c8ef54b3d",{"2":{"6":2}}],["31571636123306385",{"2":{"191":1}}],["31",{"2":{"59":2}}],["30151010318639",{"2":{"191":4}}],["30527612515520186",{"2":{"191":4}}],["300",{"2":{"84":1}}],["30",{"2":{"14":2,"59":3,"191":2}}],["3376428491230612",{"2":{"191":4}}],["3390",{"2":{"116":1}}],["33333333333",{"2":{"15":1}}],["333333333336",{"2":{"15":3}}],["33",{"2":{"6":20,"179":20,"180":20}}],["3d",{"2":{"4":1,"6":1,"60":2,"88":1,"156":1,"174":1}}],["3",{"2":{"1":13,"3":4,"5":1,"6":26,"14":2,"60":13,"62":6,"64":1,"70":6,"75":5,"87":1,"101":1,"104":1,"108":1,"116":2,"121":1,"135":1,"146":7,"150":3,"153":3,"158":2,"168":16,"175":4,"180":3,"182":2,"184":1,"185":11,"192":1,"193":1,"198":1}}],["39945867303846",{"2":{"193":3}}],["3995734698458635",{"2":{"191":1}}],["399918",{"2":{"6":2,"179":2,"180":2}}],["394759",{"2":{"6":1,"179":1,"180":1}}],["392466",{"2":{"6":1,"179":1,"180":1}}],["395332",{"2":{"6":1,"179":1,"180":1}}],["39",{"0":{"30":1},"2":{"0":1,"3":1,"4":5,"6":22,"7":1,"9":2,"17":2,"18":1,"19":1,"23":1,"29":1,"32":1,"53":1,"55":1,"56":1,"58":1,"59":3,"60":2,"62":6,"63":3,"64":28,"66":1,"67":1,"69":1,"71":1,"72":4,"73":1,"76":2,"81":2,"85":4,"88":7,"90":1,"103":2,"110":2,"116":19,"122":1,"124":2,"127":2,"146":3,"148":2,"153":5,"154":4,"159":2,"160":3,"166":6,"167":1,"175":6,"176":1,"178":1,"180":2,"187":6,"190":1,"191":6,"192":6,"193":4,"194":4,"195":5,"197":1,"199":1,"200":2}}],["2pi",{"2":{"191":1,"192":1,"193":1}}],["2nd",{"2":{"73":6}}],["2335447787454",{"2":{"193":1}}],["233544778745394",{"2":{"193":2}}],["23",{"2":{"59":3,"116":1}}],["23699059147",{"2":{"15":1}}],["28",{"2":{"59":2}}],["28083",{"2":{"15":2}}],["2658011835867806",{"2":{"191":1}}],["26745668457025",{"2":{"191":1}}],["267456684570245",{"2":{"191":3}}],["26",{"2":{"59":5,"116":2}}],["24989584635339165",{"2":{"191":1}}],["24279488312757858",{"2":{"191":4}}],["24",{"2":{"59":7,"116":1,"193":9}}],["274364",{"2":{"70":1,"72":1,"75":1}}],["274363",{"2":{"70":1,"72":1,"75":1}}],["27",{"2":{"59":2}}],["275543",{"2":{"6":6,"189":6}}],["2d",{"2":{"25":1,"27":1,"158":4,"174":1}}],["2^",{"2":{"14":1}}],["2158594260436434",{"2":{"191":1}}],["215118",{"2":{"6":4,"189":4}}],["21664550952386064",{"2":{"191":4}}],["21",{"2":{"59":4,"116":2,"193":40}}],["21427",{"2":{"11":5}}],["25",{"2":{"59":3,"100":1,"116":1,"134":1,"193":12}}],["258",{"2":{"11":1}}],["257223563`",{"2":{"176":1}}],["257223563",{"2":{"6":2,"158":1,"176":1}}],["295828190107045",{"2":{"193":1}}],["29582819010705",{"2":{"193":2}}],["299820032397223",{"2":{"191":1}}],["29",{"2":{"59":3,"196":1}}],["29th",{"0":{"8":1},"1":{"9":1,"10":1}}],["298",{"2":{"6":2,"158":1,"176":2}}],["20340",{"2":{"195":1}}],["20682326747054",{"2":{"193":1}}],["206823267470536",{"2":{"193":2}}],["20093817218219",{"2":{"191":1}}],["200938172182195",{"2":{"191":3}}],["2018",{"2":{"116":1}}],["2017",{"2":{"6":1,"60":1}}],["20",{"2":{"59":3,"116":2,"191":60,"193":1}}],["2024",{"0":{"7":1,"8":1},"1":{"9":1,"10":1}}],["20th",{"0":{"7":1}}],["22",{"2":{"59":3,"116":1}}],["22168",{"2":{"3":1,"6":3,"72":1,"73":1,"118":1,"119":1}}],["224758",{"2":{"3":1,"6":3,"72":1,"73":1,"118":1,"119":1}}],["2",{"2":{"1":19,"3":9,"5":1,"6":48,"13":1,"14":1,"15":3,"25":2,"27":2,"32":1,"53":3,"56":1,"59":6,"60":32,"62":2,"63":4,"64":10,"66":1,"67":2,"68":6,"69":7,"73":2,"75":1,"79":1,"80":1,"81":3,"82":1,"84":1,"85":3,"88":4,"101":2,"104":2,"105":2,"107":2,"108":3,"116":11,"135":2,"145":2,"146":23,"150":2,"153":4,"154":1,"158":2,"169":1,"177":1,"180":5,"182":7,"183":7,"184":5,"185":18,"189":11,"191":7,"192":6,"193":10,"194":1,"196":1}}],["1st",{"2":{"73":6}}],["198232937815632",{"2":{"193":1}}],["19823293781563178",{"2":{"193":2}}],["1999466709331708",{"2":{"191":1}}],["1998",{"2":{"70":1,"72":1,"75":1}}],["19",{"2":{"59":2,"116":2}}],["11591614996189725",{"2":{"191":1}}],["11966707868197",{"2":{"191":1}}],["119667078681967",{"2":{"191":3}}],["110m",{"2":{"192":2}}],["110",{"2":{"80":1,"192":1}}],["11",{"2":{"15":2,"59":2,"116":1}}],["1145",{"2":{"70":1,"72":1,"75":1}}],["114",{"2":{"7":1}}],["16589608273778408",{"2":{"191":1}}],["165644",{"2":{"145":2}}],["16692537029320365",{"2":{"191":4}}],["166644",{"2":{"145":2}}],["163434",{"2":{"145":2}}],["169356",{"2":{"145":2}}],["164434",{"2":{"145":2}}],["16111",{"2":{"15":1}}],["16",{"2":{"13":1,"14":1,"59":2,"116":2}}],["180",{"2":{"53":1,"145":1,"158":2}}],["18593721105",{"2":{"15":1}}],["18",{"2":{"13":1,"14":1,"59":3,"116":2}}],["13309630561615",{"2":{"193":3}}],["13401805979",{"2":{"15":2}}],["13",{"2":{"6":3,"59":1,"70":1,"75":2,"116":1}}],["10n",{"2":{"192":1}}],["10832215707812454",{"2":{"191":4}}],["10^9",{"2":{"13":1}}],["1000000",{"2":{"192":1}}],["1000",{"2":{"13":2,"175":2,"192":1,"198":2}}],["100",{"2":{"6":2,"14":3,"79":1,"81":1,"146":2,"196":1}}],["10",{"2":{"6":12,"11":1,"55":1,"59":5,"66":4,"67":10,"70":2,"72":1,"75":2,"87":2,"116":3,"121":2,"176":1,"180":4,"191":1}}],["14182952335953",{"2":{"193":1}}],["14182952335952814",{"2":{"193":2}}],["14404531208901e",{"2":{"193":2}}],["1499775010124783",{"2":{"191":1}}],["1464721641710074",{"2":{"191":4}}],["14",{"2":{"3":1,"6":5,"59":2,"72":2,"73":2,"116":1,"118":1,"119":1,"175":2,"176":2}}],["15488729606723",{"2":{"193":3}}],["15",{"2":{"3":1,"6":4,"59":1,"66":1,"67":1,"72":1,"73":1,"116":1,"118":1,"119":1}}],["17893116483784577",{"2":{"193":2}}],["17289902010158",{"2":{"191":1}}],["172899020101585",{"2":{"191":3}}],["170356",{"2":{"145":2}}],["17",{"2":{"3":1,"6":3,"59":3,"72":1,"73":1,"116":2,"118":1,"119":1}}],["125",{"2":{"6":2,"72":1,"73":1}}],["127",{"2":{"3":1,"6":3,"72":1,"73":1,"118":1,"119":1,"192":1}}],["123",{"2":{"3":1,"6":3,"72":1,"73":1,"118":1,"119":1}}],["12636633117296836",{"2":{"193":2}}],["126",{"2":{"3":1,"6":3,"72":1,"73":1,"118":1,"119":1}}],["12",{"2":{"3":1,"6":3,"59":2,"72":1,"73":1,"116":1,"118":1,"119":1,"199":1}}],["124",{"2":{"3":1,"6":3,"72":1,"73":1,"118":1,"119":1}}],["1",{"2":{"1":8,"3":38,"6":59,"13":1,"14":4,"15":1,"52":4,"53":15,"55":7,"58":2,"59":11,"60":16,"62":4,"63":7,"64":72,"66":1,"67":10,"68":9,"69":15,"71":3,"73":9,"75":4,"76":11,"81":6,"84":7,"85":6,"88":16,"90":2,"91":2,"100":2,"101":6,"103":2,"104":8,"105":12,"107":2,"108":5,"116":38,"122":6,"124":4,"125":5,"127":1,"134":2,"135":6,"145":16,"146":27,"150":2,"153":6,"154":3,"156":1,"162":12,"163":2,"169":9,"176":1,"177":4,"180":8,"182":15,"183":3,"184":15,"185":6,"189":9,"191":8,"192":44,"193":12,"194":1,"198":8,"199":3}}],["nselected",{"2":{"184":3}}],["nmax",{"2":{"184":2}}],["nice",{"2":{"182":1}}],["n+1",{"2":{"162":1}}],["nfeature",{"2":{"153":1,"154":1}}],["nkeys",{"2":{"146":8}}],["nc",{"2":{"116":13}}],["ncoord",{"2":{"88":2}}],["nl",{"2":{"116":11}}],["nhole",{"2":{"64":2,"70":2,"72":2,"75":2,"76":1,"88":2}}],["nbpts",{"2":{"64":2}}],["ngeom",{"2":{"63":1,"153":2,"154":1,"189":1}}],["nt",{"2":{"187":2}}],["ntasks",{"2":{"153":3,"154":3}}],["nthreads",{"2":{"153":2,"154":2}}],["nthe",{"2":{"57":1,"173":1,"176":1}}],["ntuple",{"2":{"60":3,"177":1}}],["n2",{"2":{"60":8,"88":10}}],["n1",{"2":{"60":8,"88":9}}],["np2",{"2":{"105":4}}],["npolygon",{"2":{"71":1,"88":3,"169":2}}],["npoints",{"2":{"53":6,"64":5,"116":3,"176":6,"182":7}}],["npoint",{"2":{"6":1,"53":2,"55":1,"56":1,"69":2,"81":2,"85":1,"88":6,"105":6,"116":6,"127":1,"145":2,"163":1,"176":3,"177":1,"180":14,"184":1,"189":13}}],["npts",{"2":{"64":6,"182":3}}],["np",{"2":{"56":2,"85":5}}],["null",{"2":{"32":1,"176":1}}],["numeric",{"2":{"11":1}}],["numbers",{"2":{"6":1,"7":1,"58":2,"60":1,"176":1}}],["number=6",{"2":{"6":1,"179":1,"180":1}}],["number",{"2":{"6":11,"60":1,"64":2,"67":1,"77":1,"81":1,"84":1,"88":2,"116":2,"174":1,"175":1,"177":1,"180":2,"181":4,"182":7,"183":4,"184":12}}],["n",{"2":{"6":1,"9":1,"57":2,"58":2,"60":36,"64":51,"67":10,"75":4,"76":4,"116":11,"127":2,"145":6,"146":5,"162":1,"169":25,"173":2,"176":2,"177":3,"180":2,"184":7,"189":32}}],["naive",{"2":{"74":1}}],["napts",{"2":{"64":3}}],["navigate",{"0":{"26":1}}],["natearth2",{"2":{"192":1}}],["natural",{"2":{"180":1,"192":2,"197":1}}],["naturalearth",{"2":{"11":2,"80":2,"180":3,"192":1}}],["nature",{"2":{"146":1}}],["native",{"2":{"6":1,"147":1,"187":4,"195":1}}],["nan",{"2":{"9":1}}],["named",{"2":{"153":1}}],["namedtuple",{"2":{"22":2,"153":2,"187":2}}],["name",{"2":{"6":1,"31":2,"180":1,"187":1,"194":1,"195":2,"199":1}}],["namespaced",{"2":{"153":1}}],["names",{"2":{"6":1,"31":3,"153":3,"154":3,"187":1}}],["nodestatus",{"2":{"146":6}}],["nodes",{"2":{"64":1,"146":4}}],["node",{"2":{"64":26,"146":17}}],["north",{"2":{"69":12,"158":1}}],["nor",{"2":{"57":1,"173":1,"176":1}}],["normalized",{"2":{"60":1}}],["normalize",{"2":{"60":1}}],["norm",{"2":{"6":1,"60":22}}],["now",{"2":{"6":1,"13":1,"25":1,"27":1,"55":1,"57":1,"59":2,"60":4,"64":1,"67":1,"76":1,"77":1,"85":1,"145":1,"146":2,"168":1,"174":1,"175":3,"176":1,"180":1,"191":5,"192":6,"193":2,"194":1,"195":3,"198":2}}],["no",{"2":{"6":6,"53":1,"60":2,"64":4,"70":1,"71":1,"72":1,"73":14,"75":1,"88":2,"91":3,"108":3,"116":2,"125":2,"127":1,"129":1,"130":2,"135":2,"137":1,"138":3,"139":3,"140":1,"146":2,"147":1,"148":1,"153":3,"174":1,"176":2,"177":1,"180":1,"187":1,"195":1}}],["nonzero",{"2":{"177":2}}],["none",{"2":{"6":4,"64":1,"67":1,"70":1,"72":1,"75":1,"76":1,"105":4,"107":1}}],["nondimensional",{"2":{"6":1,"176":1}}],["nonintersecting",{"2":{"6":1,"23":1,"166":1,"169":1}}],["non",{"2":{"3":2,"6":2,"22":1,"58":2,"64":15,"70":2,"71":1,"72":1,"73":4,"75":1,"76":2,"84":1,"122":2,"129":1,"151":1,"160":1}}],["note",{"2":{"4":4,"6":11,"19":1,"29":1,"53":1,"56":2,"60":1,"62":2,"63":2,"64":3,"67":2,"69":1,"71":3,"73":5,"76":3,"82":1,"85":1,"88":5,"116":1,"121":1,"122":1,"158":1,"160":1,"172":1,"177":1,"181":1,"182":2,"183":1,"192":2,"193":1}}],["not",{"0":{"147":1},"2":{"1":2,"3":8,"4":1,"6":16,"18":1,"19":1,"22":1,"24":1,"31":1,"53":4,"56":1,"57":1,"60":4,"62":1,"64":18,"67":1,"72":1,"73":7,"76":3,"81":1,"87":2,"88":4,"90":2,"91":2,"100":2,"101":1,"103":1,"104":2,"108":3,"110":5,"111":3,"112":2,"113":2,"116":5,"121":1,"122":2,"125":1,"134":2,"135":2,"137":1,"145":4,"146":2,"147":1,"150":1,"151":1,"152":1,"153":7,"154":4,"156":3,"158":2,"159":1,"160":1,"162":2,"165":2,"168":3,"171":1,"172":1,"173":1,"174":1,"176":2,"177":1,"186":1,"187":2,"192":1,"193":1,"197":1}}],["nothing`",{"2":{"71":2,"73":2,"76":2}}],["nothing",{"2":{"1":34,"4":1,"6":41,"15":3,"64":4,"67":1,"71":2,"72":1,"73":2,"76":2,"88":1,"116":1,"145":9,"146":3,"150":1,"153":3,"154":2,"156":3,"162":24,"165":1,"168":60,"173":1,"177":1,"180":2,"181":6,"182":6,"183":6,"184":1,"185":32,"189":7,"191":252,"192":16,"193":20}}],["ne",{"2":{"192":2}}],["net",{"2":{"165":2}}],["ness",{"2":{"156":1}}],["nesting",{"2":{"151":2}}],["nestedloopfast",{"2":{"200":1}}],["nested",{"2":{"1":2,"4":1,"6":3,"18":1,"53":1,"150":2,"151":2,"153":2,"154":2,"180":1,"188":1}}],["never",{"2":{"151":1,"181":1}}],["neumann",{"2":{"146":1}}],["neither",{"2":{"76":1}}],["neighborhood",{"2":{"146":2}}],["neighbor",{"2":{"64":27}}],["neighboring",{"2":{"6":6,"64":1,"180":1,"181":1,"182":1,"183":2}}],["nearly",{"2":{"195":1}}],["nearest",{"2":{"64":1,"73":2}}],["neatly",{"2":{"17":1}}],["nedge",{"2":{"64":2,"189":13}}],["nextnode",{"2":{"146":27}}],["nextnodes",{"2":{"146":6}}],["next",{"2":{"63":1,"64":81,"67":4,"69":3,"116":14,"146":3,"169":13,"182":5}}],["necessarily",{"2":{"6":1,"145":1,"171":1}}],["necessary",{"2":{"6":1,"151":1,"180":1}}],["newfeature",{"2":{"156":2}}],["newnodes",{"2":{"146":2}}],["new",{"2":{"6":1,"57":1,"64":58,"69":9,"70":3,"71":1,"76":16,"116":2,"146":4,"152":1,"153":21,"154":1,"165":2,"166":1,"167":1,"169":19,"177":10,"181":1,"182":2,"183":1,"193":1,"194":1,"199":1}}],["negative",{"2":{"4":3,"6":3,"55":2,"56":1,"58":2,"84":2,"85":3}}],["needs",{"2":{"63":1}}],["needing",{"2":{"4":1,"6":1,"17":1,"170":1}}],["need",{"2":{"1":1,"3":1,"4":2,"5":1,"6":5,"32":1,"60":2,"62":1,"64":2,"71":1,"81":1,"88":4,"103":1,"104":1,"116":1,"146":2,"148":1,"153":3,"154":1,"170":1,"184":1,"185":1,"192":1,"193":2,"200":2}}],["needed",{"2":{"1":2,"6":4,"53":1,"60":1,"64":4,"69":1,"70":1,"72":1,"75":1,"85":2,"116":5,"146":1,"153":1,"154":1,"165":1,"172":3,"193":1}}],["bx",{"2":{"145":2}}],["b2y",{"2":{"73":4}}],["b2x",{"2":{"73":4}}],["b2",{"2":{"73":47,"85":3,"122":6}}],["b``",{"2":{"71":1}}],["b`",{"2":{"71":3,"73":4,"76":4}}],["bigger",{"2":{"64":1}}],["bit",{"2":{"25":1,"27":1,"184":8,"191":2}}],["b1y",{"2":{"73":7}}],["b1x",{"2":{"73":7}}],["b1",{"2":{"64":8,"73":63,"122":6}}],["breaks",{"2":{"169":1}}],["break",{"2":{"64":3,"69":1,"71":2,"88":4,"116":11,"122":1,"146":6,"169":2}}],["brevity",{"2":{"60":1}}],["broadcasting",{"2":{"6":1,"60":1}}],["broken",{"2":{"3":1,"6":1,"105":1}}],["building",{"2":{"191":1}}],["build",{"2":{"64":13,"67":1,"70":1,"72":1,"75":1,"175":2,"183":1,"184":1}}],["built",{"2":{"17":1,"20":1}}],["buffers",{"2":{"146":1}}],["buffered",{"2":{"57":2}}],["buffering",{"2":{"57":1,"60":1}}],["buffer",{"0":{"57":1},"2":{"31":2,"57":5,"63":2,"64":1}}],["but",{"2":{"1":2,"3":5,"4":3,"6":12,"18":1,"22":1,"25":1,"27":1,"32":1,"53":1,"55":1,"56":1,"69":1,"73":2,"76":2,"81":2,"82":2,"88":4,"90":2,"116":1,"121":1,"122":5,"124":1,"125":1,"128":2,"129":1,"134":1,"145":1,"146":1,"147":1,"150":2,"151":1,"153":10,"154":3,"156":5,"158":5,"159":1,"171":1,"172":1,"177":2,"180":1,"187":2,"192":2,"193":2,"195":1,"197":1,"198":1,"199":2}}],["black",{"2":{"66":1,"192":1}}],["blue",{"2":{"14":1,"66":1,"87":2,"100":2,"107":2,"121":2,"134":2,"198":2}}],["bloat",{"2":{"193":1}}],["block",{"2":{"6":2,"191":1}}],["blob",{"2":{"6":2,"180":1}}],["balancing",{"2":{"153":1,"154":1}}],["barrier",{"2":{"153":1}}],["barycentric",{"0":{"5":1,"58":1,"60":1},"1":{"59":1,"60":1},"2":{"0":6,"5":10,"6":17,"9":1,"31":1,"58":9,"59":4,"60":52}}],["basic",{"2":{"146":1}}],["base",{"2":{"31":4,"32":1,"57":1,"60":15,"64":2,"146":6,"153":3,"154":3,"158":2,"159":1,"173":1,"176":2,"187":3}}],["based",{"2":{"4":2,"6":2,"19":1,"53":2,"56":2,"59":2,"63":1,"69":1,"85":2,"88":1,"91":1,"108":1,"116":2,"122":1,"125":1,"135":1,"159":1,"195":1,"197":1,"198":1}}],["badge",{"2":{"6":2}}],["backs",{"2":{"67":4}}],["backwards",{"2":{"64":1,"71":1,"73":1,"76":1}}],["backing",{"2":{"64":1}}],["backend",{"2":{"57":2,"187":1}}],["back",{"2":{"6":1,"18":1,"22":1,"23":1,"67":4,"187":1}}],["b",{"2":{"3":2,"4":7,"6":13,"35":2,"36":2,"37":2,"38":2,"40":2,"41":2,"42":2,"43":2,"44":2,"45":2,"46":2,"47":2,"48":2,"49":2,"64":206,"69":9,"70":26,"71":18,"72":26,"73":77,"74":3,"75":27,"76":39,"88":29,"116":2,"122":22,"194":1}}],["box",{"2":{"68":2,"69":3,"198":1}}],["bounce",{"2":{"64":8,"70":1,"71":1,"72":1,"73":1,"75":1,"76":1}}],["bouncings",{"2":{"64":1}}],["bouncing",{"2":{"64":13,"71":3,"73":4,"76":4}}],["bound",{"2":{"74":1}}],["bounding",{"2":{"64":1,"68":2,"69":3}}],["boundscheck",{"2":{"60":14}}],["bounds",{"2":{"6":1,"146":4}}],["boundaries",{"2":{"3":2,"6":2,"103":2,"107":1,"108":1,"116":2,"118":1,"119":1,"146":1}}],["boundary",{"2":{"3":7,"6":7,"84":1,"90":1,"91":3,"94":4,"100":1,"101":1,"104":2,"105":9,"108":2,"110":1,"111":6,"112":3,"116":18,"124":2,"125":4,"127":3,"128":5,"129":3,"130":3,"134":1,"135":3}}],["bold",{"2":{"57":1,"173":1,"176":1}}],["both",{"2":{"3":5,"6":6,"64":2,"73":4,"75":1,"76":1,"81":2,"84":1,"88":3,"101":1,"105":4,"108":1,"116":2,"122":1,"129":1,"135":1,"175":1,"177":1}}],["booltype",{"2":{"31":1,"153":2,"154":1,"158":1,"160":5,"177":1}}],["booleans",{"2":{"64":1,"116":2}}],["boolean",{"0":{"39":1},"1":{"40":1,"41":1,"42":1,"43":1,"44":1,"45":1,"46":1,"47":1,"48":1,"49":1},"2":{"24":2,"64":1,"71":1,"73":1,"76":1,"156":1,"160":2,"197":1}}],["boolsastypes",{"0":{"24":1,"160":1},"2":{"31":1,"32":1,"158":1,"160":10,"177":3}}],["bools",{"2":{"10":1}}],["bool",{"2":{"3":17,"4":14,"6":40,"32":1,"64":3,"88":17,"91":1,"101":1,"104":2,"105":13,"108":1,"116":2,"119":1,"122":10,"125":2,"135":1,"145":7,"146":6,"160":2,"177":3,"189":5}}],["bypred",{"2":{"200":1}}],["by",{"0":{"95":1,"96":1,"139":1},"2":{"1":3,"3":2,"4":8,"6":29,"7":1,"17":1,"18":2,"19":1,"22":1,"24":1,"25":1,"26":1,"27":1,"52":1,"53":6,"55":1,"56":1,"57":1,"60":4,"62":5,"63":4,"64":14,"66":1,"67":6,"68":1,"69":6,"70":1,"72":1,"73":5,"75":4,"76":3,"82":2,"85":5,"88":8,"90":1,"91":1,"95":2,"96":2,"97":1,"98":2,"101":1,"103":1,"115":2,"116":10,"145":2,"146":4,"153":2,"156":7,"158":7,"166":2,"167":1,"169":3,"171":1,"172":2,"173":1,"174":1,"176":3,"177":1,"178":1,"180":1,"181":1,"182":3,"183":1,"185":1,"191":1,"192":1,"193":1,"195":1,"197":5,"198":1,"199":2,"200":1}}],["berlin",{"2":{"199":1}}],["bearing",{"2":{"145":4}}],["beauty",{"2":{"9":1}}],["better",{"2":{"105":1,"153":1,"154":1,"180":1}}],["between",{"2":{"4":4,"6":18,"23":1,"53":2,"60":13,"64":1,"69":18,"70":1,"71":4,"72":1,"73":11,"75":2,"76":4,"85":8,"88":1,"116":4,"122":4,"146":1,"158":2,"176":3,"177":1,"181":2,"182":2,"183":1,"192":1,"197":2,"198":1}}],["been",{"2":{"71":1,"146":1,"148":2,"154":1,"160":1}}],["because",{"2":{"64":1,"82":1,"148":1,"154":1,"186":1}}],["becomes",{"2":{"158":1}}],["become",{"2":{"22":1}}],["being",{"2":{"53":1,"73":1,"116":1,"122":1,"167":1}}],["behind",{"2":{"25":1,"26":1,"27":1,"59":1,"148":1,"154":1}}],["behaviours",{"2":{"32":1}}],["behaviour",{"2":{"6":1,"18":1,"23":1,"180":1}}],["best",{"2":{"19":1,"153":2,"180":1}}],["benchmarking",{"2":{"176":1,"180":1}}],["benchmarkgroup",{"2":{"176":2,"180":3}}],["benchmark",{"0":{"176":1,"180":1},"2":{"176":1,"180":1}}],["benchmarktools",{"2":{"13":1,"176":1,"180":1}}],["benchmarks",{"2":{"9":2}}],["beginning",{"2":{"69":1,"191":1}}],["begin+1",{"2":{"60":5}}],["begin",{"2":{"9":1,"60":7,"153":1,"154":1,"181":1,"195":1}}],["beware",{"2":{"6":1,"18":1,"177":1}}],["before",{"2":{"6":4,"33":1,"60":1,"70":1,"72":1,"73":1,"75":1,"180":1,"192":1}}],["below",{"2":{"6":2,"17":1,"57":1,"165":1,"182":1,"183":1,"184":1,"195":1}}],["be",{"2":{"1":7,"3":3,"4":11,"5":4,"6":59,"7":1,"9":1,"13":2,"20":3,"23":2,"24":1,"25":3,"26":1,"27":3,"32":1,"53":8,"56":7,"57":2,"58":2,"59":1,"60":10,"62":1,"63":3,"64":14,"67":1,"68":1,"69":2,"70":7,"71":4,"72":7,"73":12,"75":6,"76":5,"82":6,"84":2,"85":4,"88":15,"91":6,"103":2,"104":1,"108":6,"116":21,"122":2,"125":6,"135":6,"137":1,"138":1,"139":1,"140":1,"145":2,"146":1,"150":4,"151":2,"152":2,"153":9,"154":1,"155":1,"156":6,"158":4,"160":1,"162":1,"163":1,"164":1,"165":3,"166":4,"167":2,"169":2,"170":1,"172":3,"173":1,"174":1,"176":8,"177":3,"180":10,"182":1,"184":3,"185":1,"187":2,"191":2,"193":1,"197":4}}],["human",{"2":{"195":1}}],["hull`",{"2":{"82":2}}],["hulls",{"2":{"6":1,"77":1,"82":1}}],["hull",{"0":{"50":1,"77":1,"79":1,"80":1},"1":{"78":1,"79":1,"80":1,"81":1,"82":1},"2":{"0":1,"6":8,"31":2,"50":1,"77":2,"79":4,"80":1,"81":10,"82":15}}],["hypot",{"2":{"177":1}}],["h2",{"2":{"116":6}}],["h1",{"2":{"116":11}}],["hm",{"2":{"59":2}}],["h",{"2":{"53":2,"64":2,"76":8}}],["href=",{"2":{"6":2}}],["https",{"2":{"6":2,"70":1,"72":1,"73":1,"75":1,"82":1,"116":2,"158":1,"182":1}}],["high",{"2":{"195":1}}],["highest",{"2":{"193":1}}],["higher",{"2":{"6":1,"82":1}}],["hit",{"2":{"64":1,"153":1,"154":1,"156":3}}],["hits",{"2":{"18":1}}],["hidedecorations",{"2":{"59":2}}],["hinter",{"2":{"31":3,"57":1,"173":1,"176":1}}],["hint",{"2":{"31":3,"57":1,"176":1}}],["hinge=2",{"2":{"72":1}}],["hinge`",{"2":{"72":1}}],["hinge",{"2":{"6":1,"64":1,"73":13,"116":15}}],["hist",{"2":{"13":1}}],["histogram",{"2":{"13":1}}],["hcat",{"2":{"6":1}}],["heavily",{"2":{"153":1}}],["heatmap",{"2":{"13":5,"14":6,"59":2,"84":2,"146":1}}],["help",{"2":{"158":1,"160":1}}],["helpers",{"0":{"64":1},"2":{"105":1,"122":1}}],["helper",{"0":{"71":1,"73":1,"76":1},"2":{"63":1,"64":1,"67":1}}],["helps",{"2":{"30":1}}],["held",{"2":{"1":1,"150":1,"153":1}}],["here",{"2":{"6":2,"9":1,"13":1,"14":1,"20":1,"60":1,"73":1,"82":2,"105":1,"146":2,"153":2,"156":4,"158":1,"162":1,"176":1,"192":2,"197":5,"198":3}}],["hours",{"2":{"199":1}}],["hood",{"2":{"195":1}}],["hook",{"2":{"6":1,"180":1}}],["home",{"2":{"192":1}}],["horizontal",{"2":{"69":1,"73":1,"146":1,"180":1}}],["hormann",{"0":{"71":1,"73":1,"76":1},"2":{"6":2,"60":2,"64":3,"67":2,"70":1,"72":1,"75":1}}],["how",{"0":{"26":1},"2":{"6":1,"26":2,"55":1,"60":1,"64":1,"73":1,"88":1,"146":2,"156":2,"171":1,"180":1,"192":1,"195":1,"197":2,"198":2,"199":1,"200":1}}],["however",{"2":{"3":1,"6":2,"53":1,"60":1,"63":1,"64":1,"73":1,"81":1,"84":1,"88":1,"100":1,"104":1,"167":1}}],["hole",{"2":{"53":1,"56":3,"59":2,"60":9,"63":4,"64":60,"69":3,"70":6,"72":2,"76":15,"85":3,"94":1,"95":1,"96":1,"116":33,"146":5,"163":2,"191":1}}],["holes=",{"2":{"64":1}}],["holes",{"2":{"4":3,"5":1,"6":4,"9":2,"53":2,"55":1,"60":2,"63":1,"64":19,"67":4,"70":2,"72":2,"75":6,"76":29,"85":3,"88":3,"113":1,"116":11,"137":1,"146":17,"163":2,"191":4}}],["holds",{"2":{"64":1,"159":2,"178":1}}],["holding",{"2":{"6":1,"146":1,"153":2}}],["hold",{"2":{"6":1,"146":1,"160":1,"180":1,"195":1}}],["halign",{"2":{"180":1}}],["half",{"2":{"68":2}}],["hail",{"2":{"163":1}}],["handling",{"0":{"173":1},"2":{"148":1}}],["handler",{"2":{"57":1,"173":1}}],["handle",{"2":{"31":1,"145":1,"151":2,"153":1,"192":1}}],["handled",{"2":{"18":1}}],["hao",{"2":{"116":1}}],["had",{"2":{"70":1,"72":1,"88":1,"160":1,"175":1}}],["happens",{"2":{"64":1}}],["happen",{"2":{"24":1,"153":1}}],["have",{"2":{"3":3,"4":9,"6":15,"19":1,"23":1,"33":1,"53":2,"56":3,"57":1,"60":6,"64":4,"73":1,"82":2,"84":1,"85":2,"88":10,"116":5,"121":1,"122":3,"124":1,"125":1,"146":1,"147":1,"148":2,"152":1,"153":1,"154":2,"156":4,"158":2,"160":1,"180":1,"182":1,"187":1,"191":1,"192":1,"197":1,"198":1,"199":3}}],["haskey",{"2":{"153":1,"187":1}}],["hash",{"2":{"146":1}}],["hasn",{"2":{"146":1}}],["hassle",{"2":{"1":1,"6":1,"185":1}}],["has",{"2":{"1":4,"52":1,"55":2,"60":2,"64":2,"71":2,"73":1,"76":1,"84":1,"85":1,"88":11,"127":1,"145":1,"150":4,"153":6,"161":1,"175":2,"184":1,"192":1}}],["xticklabelsvisible",{"2":{"192":1}}],["xticklabelrotation",{"2":{"13":2}}],["xoffset",{"2":{"191":4,"193":1}}],["x=x",{"2":{"189":1}}],["x`",{"2":{"153":1}}],["xvec",{"2":{"146":4}}],["xbounds",{"2":{"146":4}}],["xhalf",{"2":{"146":2}}],["xlast",{"2":{"85":3}}],["xfirst",{"2":{"85":5}}],["x0",{"2":{"85":5}}],["xn",{"2":{"69":4}}],["xind+1",{"2":{"146":1}}],["xind",{"2":{"146":2}}],["xinterior",{"2":{"63":2}}],["xi−xi−1",{"2":{"6":1}}],["xcentroid",{"2":{"63":13}}],["xrange",{"2":{"59":3,"84":2}}],["xautolimits",{"2":{"59":2}}],["xp2",{"2":{"53":5}}],["x26",{"2":{"53":2,"56":6,"57":4,"60":1,"64":58,"69":36,"70":4,"71":4,"73":24,"76":2,"85":3,"88":14,"97":2,"98":2,"105":48,"114":2,"115":2,"116":170,"122":22,"127":2,"131":2,"132":2,"141":2,"142":2,"145":4,"146":12,"153":2,"165":2,"169":6,"173":2,"176":2,"182":10,"183":2,"189":4,"197":4}}],["x2",{"2":{"6":3,"60":4,"63":2,"69":18,"85":8,"105":10,"116":5,"122":4,"146":5,"177":6,"189":2}}],["x1",{"2":{"6":4,"60":3,"63":2,"69":22,"85":8,"105":11,"116":6,"122":5,"146":5,"177":7,"189":2}}],["xs",{"2":{"6":3,"69":4,"146":30,"189":4}}],["xmax",{"2":{"6":1,"68":2,"69":48}}],["xmin",{"2":{"6":1,"68":2,"69":49}}],["x3c",{"2":{"5":1,"6":28,"31":1,"53":4,"56":2,"60":66,"64":17,"67":3,"69":11,"70":1,"72":1,"73":6,"75":1,"84":1,"85":13,"88":2,"105":33,"116":13,"122":10,"145":1,"146":4,"153":3,"154":2,"156":19,"158":3,"159":4,"160":4,"163":2,"166":3,"169":5,"176":2,"181":2,"182":6,"183":3,"184":9,"200":1}}],["xy`",{"2":{"172":1}}],["xy",{"2":{"1":4,"60":1,"172":3}}],["x",{"2":{"1":4,"4":1,"6":3,"7":1,"9":5,"11":6,"13":11,"14":10,"15":4,"50":2,"53":9,"56":2,"59":8,"62":1,"63":10,"64":21,"67":6,"68":1,"69":8,"71":9,"73":18,"76":9,"84":2,"85":7,"88":3,"105":21,"116":16,"122":7,"145":11,"146":2,"148":2,"150":3,"153":5,"154":4,"156":10,"160":5,"165":2,"170":2,"171":4,"172":1,"177":2,"180":2,"182":2,"184":1,"185":2,"188":2,"189":33,"191":6,"192":2,"193":2,"197":1,"199":2}}],["=>",{"2":{"153":2}}],["=float64",{"2":{"63":3,"72":1,"75":1}}],["=false",{"2":{"53":1}}],["===",{"2":{"105":8,"145":4}}],["==",{"2":{"9":1,"19":1,"32":1,"53":4,"56":2,"57":2,"60":9,"63":1,"64":34,"69":30,"71":1,"73":20,"75":2,"76":1,"80":1,"84":1,"88":16,"116":44,"122":2,"145":3,"146":18,"153":2,"163":1,"165":1,"169":1,"173":1,"176":2,"180":1,"184":3}}],["=",{"2":{"1":5,"3":17,"4":7,"5":2,"6":59,"11":1,"13":19,"14":33,"15":18,"31":4,"32":7,"35":2,"36":2,"37":2,"38":2,"50":3,"52":4,"53":56,"55":6,"56":25,"57":3,"59":35,"60":110,"62":6,"63":36,"64":324,"66":7,"67":29,"68":6,"69":96,"70":21,"71":30,"72":18,"73":143,"75":21,"76":78,"79":6,"80":4,"81":14,"82":4,"84":15,"85":52,"87":7,"88":40,"90":4,"91":23,"92":3,"93":7,"94":14,"95":14,"96":4,"97":2,"98":2,"100":7,"101":3,"103":5,"104":3,"105":57,"107":7,"108":18,"109":3,"110":11,"111":17,"112":9,"113":3,"114":2,"115":2,"116":189,"118":3,"119":3,"121":7,"122":40,"124":3,"125":22,"126":3,"127":9,"128":14,"129":10,"130":6,"131":2,"132":2,"134":7,"135":22,"136":3,"137":11,"138":14,"139":14,"140":4,"141":2,"142":2,"145":32,"146":110,"148":1,"150":3,"153":40,"154":20,"155":4,"156":39,"158":3,"159":6,"160":2,"162":2,"163":4,"165":9,"168":3,"169":30,"170":1,"173":2,"175":16,"176":21,"177":25,"178":2,"179":5,"180":60,"181":11,"182":49,"183":7,"184":43,"185":2,"187":3,"188":1,"189":42,"191":45,"192":19,"193":13,"194":3,"195":4,"196":7,"198":12,"199":6,"200":2}}],["utm",{"2":{"192":1}}],["utility",{"0":{"189":1},"2":{"60":1,"153":1,"154":1}}],["utils",{"0":{"184":1},"2":{"31":1}}],["u2",{"2":{"116":4}}],["u1",{"2":{"116":4}}],["update",{"2":{"64":6,"146":10}}],["updated",{"2":{"64":6,"156":3}}],["updates",{"2":{"60":1}}],["up",{"2":{"64":2,"73":1,"116":1,"129":1,"151":1,"168":1,"182":2,"191":2}}],["upper",{"2":{"6":1,"146":1,"198":1}}],["uv",{"2":{"60":1}}],["usage",{"2":{"199":1}}],["usable",{"2":{"157":1}}],["usa",{"0":{"80":1},"2":{"80":4,"180":15,"199":3}}],["us",{"2":{"56":1,"82":1,"192":1,"199":1}}],["usually",{"2":{"26":2,"77":1,"153":1,"156":2,"158":1,"195":1}}],["usual",{"2":{"6":1,"163":1,"166":1}}],["usecases",{"2":{"25":1,"27":1}}],["uses",{"2":{"6":3,"77":1,"82":1,"116":1,"157":1,"158":1,"172":1,"176":1,"177":1,"180":1,"195":1}}],["users",{"2":{"31":1,"148":1,"167":1}}],["user",{"2":{"6":12,"23":1,"63":1,"70":3,"72":3,"75":3,"153":1,"181":1,"182":1,"183":1,"197":1}}],["useful",{"2":{"6":10,"60":1,"146":1,"174":1,"177":1,"180":2,"187":1}}],["used",{"2":{"1":1,"5":1,"6":4,"53":1,"56":1,"58":1,"60":1,"63":2,"64":7,"67":1,"69":1,"73":1,"84":1,"85":1,"88":1,"122":1,"146":2,"150":1,"153":1,"154":1,"156":2,"158":1,"159":1,"161":1,"180":1,"182":2,"186":2,"192":1,"195":1,"197":2,"198":1}}],["use",{"2":{"1":2,"4":1,"5":1,"6":9,"11":1,"20":1,"23":1,"26":1,"60":1,"64":1,"76":1,"82":2,"105":2,"122":1,"146":1,"147":1,"150":1,"153":4,"154":3,"155":1,"158":2,"163":1,"171":1,"175":1,"177":2,"180":1,"182":2,"187":3,"191":1,"195":1,"197":2,"200":2}}],["using",{"0":{"192":1},"2":{"1":4,"4":1,"5":3,"6":11,"11":4,"13":4,"14":1,"15":1,"31":6,"32":1,"50":1,"52":1,"53":1,"55":2,"56":2,"57":3,"59":4,"60":7,"62":2,"63":1,"64":5,"66":2,"67":1,"68":2,"69":1,"71":3,"73":4,"74":1,"76":3,"79":1,"80":2,"81":1,"82":2,"84":2,"85":2,"87":2,"88":1,"90":2,"91":1,"98":1,"100":2,"101":1,"103":2,"104":1,"105":1,"107":2,"108":1,"115":1,"116":1,"118":2,"119":1,"121":2,"122":1,"124":2,"125":1,"132":1,"134":2,"135":1,"142":1,"145":1,"146":5,"147":1,"148":2,"150":1,"151":1,"153":4,"154":2,"155":1,"156":1,"160":1,"163":1,"166":1,"169":1,"170":2,"171":1,"172":1,"173":3,"175":1,"176":5,"177":1,"180":3,"182":1,"184":1,"185":4,"187":2,"188":2,"189":1,"190":4,"191":1,"193":1,"194":2,"196":1,"197":1,"198":4,"199":2}}],["until",{"2":{"146":3,"151":1,"182":1,"187":1}}],["unprocessed",{"2":{"64":1}}],["unknown",{"2":{"64":4,"69":15}}],["unknown=3",{"2":{"64":1}}],["unmatched",{"2":{"64":9,"69":26}}],["understand",{"2":{"186":1}}],["under",{"2":{"56":2,"195":1}}],["undergrad",{"2":{"9":1}}],["undef",{"2":{"53":2,"64":1,"181":1,"182":1,"184":2,"189":2}}],["unwrap",{"0":{"156":1},"2":{"31":2,"156":19}}],["unless",{"2":{"22":1,"64":1,"71":2,"73":2,"76":2,"153":1}}],["unlike",{"2":{"18":1,"186":1}}],["unstable",{"2":{"13":1,"153":1,"160":1}}],["unneeded",{"2":{"6":3,"64":1,"70":2,"72":2,"75":2}}],["unnecessary",{"2":{"6":3,"146":1,"181":1,"182":1,"183":1}}],["universal",{"2":{"192":1}}],["united",{"2":{"180":1}}],["unit",{"2":{"158":1}}],["units",{"2":{"6":2,"177":2}}],["unify",{"2":{"25":1,"27":1}}],["unique",{"2":{"6":2,"73":3,"166":2,"169":2}}],["unioning",{"2":{"76":1}}],["unionintersectingpolygons",{"2":{"0":1,"6":8,"70":1,"71":2,"72":1,"73":2,"75":1,"76":2,"166":2,"167":2,"168":1,"169":4}}],["unions",{"0":{"76":1},"2":{"18":1,"159":1}}],["union",{"0":{"36":1,"75":1},"2":{"0":1,"1":2,"3":2,"4":4,"6":18,"11":3,"23":2,"31":1,"32":1,"36":2,"53":2,"56":1,"60":1,"63":4,"64":7,"69":1,"72":2,"75":18,"76":30,"85":1,"88":8,"93":2,"94":4,"95":1,"97":2,"98":1,"110":2,"111":6,"114":2,"115":1,"122":4,"127":2,"128":4,"129":1,"131":2,"132":1,"137":2,"138":4,"139":1,"141":2,"142":1,"145":1,"146":5,"148":1,"150":2,"151":3,"153":3,"154":3,"159":4,"166":1,"167":1,"169":9,"177":5,"180":2,"181":3,"182":3,"183":3,"189":1}}],["unchanged",{"2":{"1":1,"6":1,"150":1,"153":1,"180":1}}],["gdal",{"2":{"195":1}}],["gml",{"2":{"195":1}}],["gpkg",{"2":{"195":3}}],["gadm",{"2":{"199":4}}],["ga",{"2":{"192":3,"196":2}}],["gaps",{"2":{"146":1}}],["global",{"2":{"192":1}}],["globally",{"2":{"154":1,"158":1}}],["gft",{"2":{"190":1,"192":2}}],["gc",{"2":{"165":6}}],["g",{"2":{"53":3,"56":3,"57":1,"63":3,"69":3,"85":6,"151":1,"153":2,"156":4,"158":1,"180":2,"189":2,"195":1}}],["gb",{"2":{"31":1}}],["guarantee",{"2":{"19":1,"30":1}}],["guaranteed",{"2":{"1":1,"53":1,"150":1,"154":1}}],["grows",{"2":{"158":1}}],["grouped",{"2":{"191":1}}],["groups",{"2":{"6":1,"146":1}}],["grouping",{"2":{"1":1,"150":1,"154":3}}],["grand",{"2":{"199":1}}],["grained",{"2":{"175":1}}],["grahamscanmethod",{"2":{"82":1}}],["graphics",{"2":{"6":1,"60":1}}],["great",{"2":{"191":1,"193":1,"195":1}}],["greater",{"2":{"145":1}}],["greiner",{"0":{"71":1,"73":1,"76":1},"2":{"64":3,"67":2,"70":1,"72":1,"75":1}}],["green",{"2":{"14":1,"192":1}}],["grid",{"2":{"6":1,"59":1,"69":4}}],["g2",{"2":{"3":5,"6":5,"91":12,"92":6,"93":9,"94":6,"95":6,"96":3,"97":4,"98":2,"101":4,"104":3,"105":21,"108":10,"109":6,"110":10,"111":8,"112":4,"113":2,"114":4,"115":2,"125":10,"126":6,"127":10,"128":6,"129":5,"130":4,"131":4,"132":2,"135":10,"136":6,"137":9,"138":6,"139":6,"140":3,"141":4,"142":2}}],["g1",{"2":{"3":5,"4":1,"6":6,"91":12,"92":6,"93":9,"94":6,"95":6,"96":3,"97":2,"98":4,"101":4,"104":3,"105":21,"108":9,"109":6,"110":10,"111":8,"112":4,"113":2,"114":2,"115":4,"125":10,"126":6,"127":9,"128":6,"129":5,"130":4,"131":2,"132":4,"135":10,"136":6,"137":9,"138":6,"139":6,"140":3,"141":2,"142":4}}],["generic",{"2":{"22":1,"177":1}}],["generation",{"2":{"180":2}}],["generated",{"2":{"31":1,"32":1,"50":1,"53":1,"56":1,"57":1,"60":1,"63":1,"64":1,"67":1,"69":1,"71":1,"73":1,"74":1,"76":1,"82":1,"85":1,"88":1,"98":1,"101":1,"104":1,"105":1,"115":1,"116":1,"119":1,"122":1,"132":1,"142":1,"145":1,"146":1,"147":1,"153":1,"154":1,"155":1,"156":1,"160":1,"163":1,"166":1,"169":1,"170":1,"171":1,"173":1,"177":1,"180":1,"184":1,"185":1,"187":1,"188":1,"189":1,"198":1}}],["generate",{"2":{"7":1,"13":2,"180":1,"198":2}}],["generalization",{"2":{"58":1}}],["generalized",{"2":{"6":1,"58":3,"60":1}}],["generalise",{"2":{"6":4,"180":1}}],["generally",{"2":{"6":2,"158":2,"187":3}}],["general",{"0":{"2":1,"4":1},"1":{"3":1,"4":1},"2":{"18":1,"20":1,"25":1,"27":1,"148":1,"154":1,"173":1}}],["getfeature",{"2":{"153":1,"154":1,"156":3,"189":5}}],["getcolumn",{"2":{"153":2,"154":2,"156":1}}],["getgeom",{"2":{"97":1,"98":1,"114":1,"115":1,"122":2,"131":1,"132":1,"141":1,"142":1,"153":3,"154":2,"156":3,"180":3,"189":6}}],["getring",{"2":{"64":1}}],["getindex",{"2":{"60":2}}],["gethole",{"2":{"53":1,"56":1,"63":1,"64":4,"67":1,"69":1,"70":2,"72":2,"76":6,"85":1,"88":2,"116":5,"163":1,"191":1}}],["getexterior",{"2":{"53":1,"56":1,"60":1,"63":1,"64":3,"67":1,"69":1,"70":2,"72":2,"75":3,"76":6,"85":1,"88":2,"116":5,"145":1,"146":1,"163":1,"191":1}}],["getpolygon",{"2":{"71":3,"73":2,"76":2,"88":3}}],["getpoint",{"2":{"52":1,"53":5,"55":2,"56":1,"60":1,"62":1,"63":6,"64":3,"66":3,"68":2,"69":3,"84":1,"85":6,"87":4,"88":13,"90":1,"100":4,"103":1,"105":7,"107":4,"116":28,"118":2,"121":4,"122":2,"124":2,"127":2,"134":4,"145":5,"163":3,"175":4,"177":2,"184":1,"189":3,"191":2}}],["getproperty",{"2":{"13":2,"14":1}}],["get",{"2":{"6":1,"13":1,"32":1,"55":1,"57":1,"64":9,"70":1,"71":1,"72":1,"73":2,"75":2,"82":2,"146":4,"153":3,"154":1,"173":1,"176":3,"180":1,"181":1,"183":1,"184":2,"187":5,"189":1,"191":2,"199":2}}],["geoparquet",{"2":{"195":4}}],["geopoly1",{"2":{"193":1,"194":1}}],["geopoly2",{"2":{"193":1,"194":1}}],["geoaxis",{"2":{"192":4,"196":1}}],["geographic",{"2":{"158":1,"192":1,"195":1}}],["geographiclib",{"2":{"6":1,"176":1}}],["geointeface",{"2":{"151":1}}],["geointerace",{"2":{"22":1}}],["geointerfacemakie",{"2":{"179":1,"198":1,"199":1}}],["geointerface",{"0":{"30":1},"2":{"1":20,"3":9,"4":2,"6":35,"11":1,"13":1,"14":1,"15":1,"22":3,"25":1,"27":1,"30":1,"31":7,"52":1,"53":1,"55":1,"56":1,"60":23,"62":1,"63":1,"64":1,"66":1,"67":1,"68":1,"69":1,"70":1,"72":1,"73":1,"75":1,"79":1,"80":1,"81":1,"84":1,"85":11,"87":1,"88":2,"90":1,"91":2,"100":1,"101":2,"103":1,"104":2,"105":1,"107":1,"108":3,"118":1,"119":2,"121":1,"122":2,"124":1,"125":2,"134":1,"135":2,"145":5,"146":1,"150":3,"151":3,"153":11,"156":5,"162":9,"165":1,"166":1,"168":23,"170":1,"172":2,"175":1,"176":1,"179":1,"180":2,"185":13,"188":1,"189":1,"190":1,"191":122,"192":5,"193":9,"196":1,"198":1,"199":1}}],["geo",{"2":{"146":1,"176":4,"192":2}}],["geotable",{"2":{"29":1}}],["geojson",{"2":{"11":1,"180":2,"190":1,"192":4,"195":3}}],["geodataframes",{"2":{"195":3}}],["geodesy",{"2":{"158":1}}],["geodesic`",{"2":{"176":2}}],["geodesic",{"0":{"196":1},"2":{"6":7,"31":3,"158":6,"175":6,"176":8,"177":3,"196":1}}],["geodesicsegments",{"2":{"0":1,"6":1,"174":1,"175":3,"176":6,"177":1,"196":1}}],["geod",{"2":{"6":2,"176":3}}],["geoformattypes",{"2":{"1":2,"172":2,"190":1,"192":2,"193":8}}],["geomakie",{"0":{"192":1},"2":{"190":2,"192":5,"196":2}}],["geomtype",{"2":{"153":2,"156":1}}],["geoms",{"2":{"50":3,"82":1,"116":1,"153":12,"156":9}}],["geomfromgeos",{"2":{"32":1,"176":1}}],["geom2",{"2":{"3":8,"4":1,"6":9,"85":6,"88":1,"105":6,"108":1,"119":3,"122":6,"125":1,"135":2}}],["geom1",{"2":{"3":8,"4":1,"6":9,"85":6,"88":1,"105":4,"108":1,"119":3,"122":6,"125":1,"135":2}}],["geometrical",{"2":{"197":1}}],["geometric",{"2":{"25":2,"27":2,"62":1,"158":1}}],["geometries",{"0":{"92":1,"93":1,"94":1,"95":1,"96":1,"97":1,"98":1,"109":1,"110":1,"111":1,"112":1,"113":1,"114":1,"115":1,"126":1,"127":1,"128":1,"129":1,"130":1,"131":1,"132":1,"136":1,"137":1,"138":1,"139":1,"140":1,"141":1,"142":1,"191":1,"192":1,"193":1},"2":{"1":6,"3":8,"4":14,"6":55,"18":3,"20":1,"22":3,"25":2,"27":2,"29":4,"52":1,"53":3,"56":4,"63":1,"67":1,"69":2,"70":5,"72":5,"73":4,"75":5,"82":6,"84":1,"85":4,"87":1,"88":7,"90":1,"91":1,"101":1,"105":2,"108":2,"116":1,"118":1,"119":1,"121":2,"122":3,"124":2,"125":2,"135":2,"137":1,"148":1,"150":3,"152":2,"153":6,"154":3,"155":1,"156":10,"170":1,"172":2,"174":3,"175":1,"176":4,"177":1,"178":1,"181":1,"182":1,"183":1,"188":1,"189":1,"190":5,"192":1,"193":2,"194":2,"195":1,"197":5,"198":1,"200":1}}],["geometry=",{"2":{"194":1}}],["geometrybasics",{"2":{"31":3,"59":2,"60":10,"82":1,"84":1,"91":1,"125":1,"135":1}}],["geometrycolumns",{"2":{"153":5,"154":2,"156":1}}],["geometrycollections",{"2":{"197":1}}],["geometrycollectiontrait",{"2":{"23":1,"32":1,"97":1,"98":1,"114":1,"115":1,"131":1,"132":1,"141":1,"142":1}}],["geometrycollection",{"2":{"6":1,"23":1,"199":1}}],["geometrycorrections",{"2":{"165":1}}],["geometrycorrection",{"2":{"0":1,"6":11,"163":2,"164":2,"165":13,"166":11,"169":4}}],["geometry",{"0":{"2":1,"72":1,"97":2,"98":2,"114":2,"115":2,"131":2,"132":2,"141":2,"142":2,"164":1,"172":1,"178":1,"190":1,"194":1},"1":{"3":1,"4":1,"165":1,"166":1,"173":1,"179":1,"180":1,"191":1,"192":1,"193":1,"194":1,"195":1},"2":{"1":10,"3":24,"4":12,"6":67,"9":1,"11":2,"18":4,"20":1,"23":3,"29":1,"31":1,"53":7,"56":4,"57":4,"63":3,"67":4,"68":1,"69":4,"80":1,"84":4,"85":6,"88":8,"90":4,"91":5,"92":4,"93":1,"97":3,"98":4,"100":5,"101":2,"103":4,"104":4,"105":3,"107":2,"108":5,"109":4,"110":2,"111":2,"114":3,"115":4,"116":2,"118":2,"122":3,"124":3,"125":4,"126":4,"127":2,"131":3,"132":4,"134":4,"135":5,"136":4,"141":3,"142":4,"144":1,"148":4,"150":3,"151":2,"153":28,"154":12,"156":10,"158":5,"162":1,"163":1,"164":2,"165":23,"166":6,"170":1,"171":1,"172":6,"174":3,"175":1,"176":5,"177":10,"180":6,"189":6,"191":1,"192":1,"193":4,"194":2,"195":2,"197":1,"198":7,"199":4,"200":2}}],["geometryopsprojext",{"2":{"172":1,"173":1,"176":1,"177":1}}],["geometryopslibgeosext",{"2":{"57":1}}],["geometryopscore",{"2":{"0":2,"1":2,"31":2,"150":2,"156":4}}],["geometryops",{"0":{"0":1,"25":1,"31":1},"1":{"1":1,"2":1,"3":1,"4":1,"5":1,"6":1},"2":{"0":105,"1":4,"3":18,"4":9,"5":3,"6":106,"7":2,"11":1,"13":1,"14":1,"15":1,"17":2,"25":1,"26":4,"27":1,"31":1,"32":2,"52":1,"55":1,"57":1,"59":5,"62":1,"66":1,"67":1,"68":1,"70":1,"72":1,"73":1,"75":1,"77":1,"79":1,"80":1,"81":3,"84":1,"87":1,"88":1,"90":1,"91":2,"100":1,"101":2,"103":1,"104":2,"105":2,"107":1,"108":2,"118":1,"119":1,"121":1,"122":1,"124":1,"125":2,"134":1,"135":2,"145":3,"146":2,"150":1,"153":1,"157":2,"158":1,"162":1,"165":1,"166":4,"168":1,"173":1,"175":1,"176":2,"179":1,"180":2,"185":1,"186":1,"187":2,"189":1,"190":1,"191":3,"196":1,"197":1,"198":2,"199":2}}],["geom",{"2":{"1":7,"4":21,"6":41,"18":3,"31":12,"32":10,"35":5,"36":5,"37":5,"38":5,"40":4,"41":4,"42":4,"43":4,"44":4,"45":4,"46":4,"47":4,"48":4,"49":4,"53":25,"56":17,"63":28,"64":16,"67":15,"69":6,"70":8,"71":2,"72":12,"73":10,"75":9,"76":9,"85":28,"88":45,"91":4,"105":1,"108":4,"116":3,"122":1,"125":4,"135":4,"145":3,"146":1,"148":2,"150":4,"153":34,"154":13,"156":52,"169":11,"171":4,"177":24,"180":36,"184":3,"185":7,"188":4,"189":13,"199":6}}],["geospatial",{"0":{"193":1,"195":1},"2":{"190":5,"192":1,"193":3,"195":5}}],["geoscontext",{"2":{"176":1}}],["geosdensify",{"2":{"32":2,"176":3}}],["geos",{"0":{"187":1},"2":{"0":1,"6":6,"32":8,"33":1,"35":1,"36":1,"37":1,"38":1,"40":1,"41":1,"42":1,"43":1,"44":1,"45":1,"46":1,"47":1,"48":1,"49":1,"50":1,"57":4,"77":1,"81":4,"82":1,"158":1,"178":5,"180":2,"186":1,"187":12}}],["got",{"2":{"184":3}}],["goes",{"2":{"6":2,"145":2}}],["good",{"2":{"6":1,"60":1,"187":2,"193":1}}],["going",{"2":{"4":4,"6":5,"69":2,"81":1,"88":5,"145":1,"146":1,"190":1}}],["go",{"2":{"1":5,"3":17,"4":2,"6":40,"11":9,"13":1,"14":1,"15":6,"18":1,"31":2,"32":5,"35":1,"36":1,"37":1,"38":1,"40":1,"41":1,"42":1,"43":1,"44":1,"45":1,"46":1,"47":1,"48":1,"49":1,"50":2,"52":1,"55":1,"60":1,"62":2,"66":2,"67":2,"68":1,"70":2,"72":2,"73":2,"75":2,"79":3,"80":2,"81":8,"82":2,"84":6,"87":1,"88":2,"90":1,"91":2,"100":2,"101":2,"103":2,"104":2,"105":1,"107":1,"108":2,"118":1,"119":2,"121":1,"122":2,"124":1,"125":2,"134":2,"135":2,"145":6,"146":2,"148":1,"150":2,"153":2,"156":2,"162":3,"168":3,"175":7,"176":8,"179":2,"180":49,"185":3,"187":1,"189":2,"190":1,"191":3,"193":1,"195":1,"196":3,"197":9,"198":2,"199":5,"200":1}}],["gtrait",{"2":{"85":2}}],["gt",{"2":{"1":1,"6":1,"9":2,"10":1,"11":5,"64":3,"145":3,"150":1}}],["gif",{"2":{"182":1}}],["gives",{"2":{"199":1}}],["give",{"2":{"116":1,"195":1}}],["given",{"2":{"4":7,"6":21,"18":2,"29":1,"52":1,"53":1,"56":2,"63":3,"64":8,"67":5,"69":3,"70":1,"71":2,"72":1,"73":2,"75":1,"76":2,"85":8,"88":4,"91":1,"100":1,"101":1,"103":1,"104":1,"108":1,"116":7,"118":1,"119":1,"125":1,"127":1,"135":1,"148":1,"154":1,"165":4,"166":1,"168":1,"174":2,"176":2,"177":2,"183":1}}],["github",{"2":{"6":2,"82":1,"158":1}}],["gis",{"2":{"5":1,"6":1,"25":1,"27":1,"60":1}}],["gi",{"2":{"1":13,"3":42,"4":31,"6":108,"11":8,"13":15,"14":15,"15":8,"18":2,"31":1,"32":12,"35":3,"36":3,"37":3,"38":3,"40":2,"41":2,"42":2,"43":2,"44":2,"45":2,"46":2,"47":2,"48":2,"49":2,"50":3,"52":3,"53":30,"55":5,"56":21,"59":1,"62":5,"63":38,"64":34,"66":6,"67":13,"68":5,"69":17,"70":19,"71":16,"72":25,"73":24,"75":17,"76":36,"79":1,"80":1,"81":3,"82":4,"84":8,"85":42,"87":7,"88":99,"90":3,"91":4,"92":6,"93":12,"94":10,"95":7,"96":4,"97":8,"98":6,"100":7,"101":3,"103":3,"104":3,"105":21,"107":7,"108":2,"109":3,"110":12,"111":14,"112":4,"113":2,"114":8,"115":6,"116":59,"118":5,"119":3,"121":7,"122":51,"124":5,"125":3,"126":6,"127":15,"128":10,"129":7,"130":4,"131":8,"132":6,"134":7,"135":2,"136":6,"137":12,"138":10,"139":7,"140":4,"141":8,"142":6,"145":32,"146":15,"148":4,"150":9,"153":42,"154":25,"156":54,"159":9,"162":2,"163":10,"165":9,"168":3,"169":8,"170":1,"171":5,"175":6,"176":6,"177":13,"179":2,"180":34,"184":4,"185":9,"188":5,"189":55,"190":1,"191":21,"192":2,"193":2,"196":2,"198":5,"199":2}}],["t8vkb",{"2":{"192":1}}],["ty",{"2":{"146":3}}],["typically",{"2":{"58":1,"194":1}}],["typing",{"2":{"57":1,"173":1,"176":1}}],["typemax",{"2":{"85":1,"146":9}}],["typeof",{"2":{"19":1,"60":3,"153":2,"156":1,"159":1,"177":1,"200":1}}],["type=",{"2":{"6":2}}],["type2",{"2":{"6":2,"88":4}}],["type1",{"2":{"6":2,"88":5}}],["types",{"0":{"157":1,"186":1},"1":{"158":1,"159":1,"160":1,"187":1},"2":{"6":4,"23":1,"24":1,"31":1,"60":3,"67":1,"69":1,"116":3,"157":1,"160":1,"180":1,"186":3,"197":1}}],["type",{"2":{"4":11,"5":1,"6":40,"11":1,"22":2,"23":1,"24":2,"30":2,"53":9,"56":11,"59":1,"60":8,"63":8,"64":21,"67":6,"69":8,"70":7,"71":6,"72":8,"73":19,"75":7,"76":5,"85":28,"88":2,"153":5,"156":42,"158":2,"159":3,"160":6,"164":1,"165":5,"166":2,"171":1,"176":1,"177":1,"180":3,"187":1,"188":1,"189":3,"196":1}}],["tx",{"2":{"146":3}}],["tᵢ",{"2":{"60":1}}],["tutorial",{"2":{"190":1,"197":1}}],["tutorials",{"2":{"26":2}}],["tups",{"2":{"163":4}}],["tuplepoint",{"2":{"31":3,"189":1}}],["tuple",{"0":{"188":1},"2":{"4":1,"6":19,"31":2,"60":2,"63":3,"64":5,"67":1,"69":3,"73":31,"116":17,"145":2,"146":5,"153":2,"162":6,"168":13,"175":1,"180":2,"182":1,"184":2,"189":6,"191":99,"198":2}}],["tuples",{"2":{"0":1,"6":2,"31":1,"57":1,"63":1,"64":1,"67":1,"70":3,"71":1,"72":2,"73":1,"75":4,"76":5,"82":2,"163":2,"169":2,"180":2,"188":2,"199":2}}],["turf",{"2":{"145":1}}],["turned",{"2":{"146":1,"153":1}}],["turning",{"2":{"146":8}}],["turn",{"2":{"6":1,"146":1}}],["temporary",{"2":{"64":1}}],["term",{"2":{"56":1}}],["terms",{"2":{"6":1,"60":1}}],["teach",{"2":{"26":1}}],["technically",{"2":{"23":1,"161":1}}],["technique",{"2":{"11":1}}],["tell",{"2":{"18":1,"116":1,"160":1,"200":1}}],["test",{"2":{"64":1,"180":2,"187":1}}],["testing",{"0":{"15":1}}],["tests",{"2":{"9":2}}],["text=",{"2":{"6":2}}],["t2",{"2":{"6":5,"60":47,"92":1,"105":2,"126":1,"136":1}}],["t1",{"2":{"6":6,"60":51,"105":2}}],["t=float64",{"2":{"4":1,"6":3,"63":3}}],["two",{"2":{"3":5,"4":10,"6":23,"23":2,"53":2,"55":1,"60":1,"63":1,"64":6,"69":3,"70":2,"72":1,"73":14,"75":4,"76":3,"85":5,"87":3,"88":12,"90":1,"100":2,"101":1,"103":1,"104":1,"105":1,"107":1,"116":2,"118":2,"119":2,"121":4,"122":5,"124":3,"125":1,"134":2,"146":3,"165":2,"166":1,"168":2,"169":2,"175":1,"187":1,"191":1,"197":3,"198":3}}],["task",{"2":{"153":3,"154":3}}],["tasks",{"2":{"153":5,"154":5}}],["taskrange",{"2":{"153":5,"154":5}}],["tags",{"2":{"64":4}}],["taget",{"2":{"6":2}}],["taylor",{"2":{"6":1,"60":1}}],["table2",{"2":{"197":4}}],["table1",{"2":{"197":12}}],["tables",{"2":{"22":4,"31":1,"153":6,"154":5,"156":2}}],["table",{"0":{"194":1},"2":{"6":2,"18":1,"29":2,"153":13,"154":4,"177":1,"180":1,"194":1,"195":1,"197":2}}],["taking",{"2":{"6":3,"63":1,"70":1,"71":1,"72":1,"73":1,"75":1,"76":1,"167":1}}],["takes",{"2":{"64":3,"197":1}}],["taken",{"2":{"20":1,"59":1}}],["take",{"2":{"1":1,"6":2,"29":1,"64":3,"70":1,"71":1,"72":1,"73":1,"76":1,"145":2,"146":2,"148":1,"154":1,"172":1}}],["target=gi",{"2":{"64":1}}],["target=nothing",{"2":{"35":1,"36":1,"37":1,"38":1,"70":1,"72":1,"75":1}}],["targets",{"2":{"23":1,"53":2,"56":3,"69":3,"85":3}}],["target",{"0":{"23":1},"2":{"1":14,"6":11,"15":3,"22":2,"23":2,"32":1,"60":1,"63":2,"64":1,"70":5,"71":11,"72":6,"73":10,"75":4,"76":13,"146":1,"148":1,"150":8,"151":5,"152":1,"153":34,"154":33,"156":87,"159":3,"169":2,"172":3,"180":2}}],["tilted",{"2":{"69":1}}],["tie",{"2":{"53":1}}],["timings",{"2":{"13":5}}],["timing",{"2":{"13":2}}],["times",{"2":{"4":1,"6":1,"170":1}}],["time",{"2":{"1":5,"13":3,"24":1,"59":1,"146":1,"158":1,"172":4,"187":1,"191":1,"192":1,"193":2,"198":1,"199":1}}],["title",{"2":{"13":2,"59":2,"81":2,"146":1,"176":1,"180":2}}],["tip",{"2":{"1":1,"5":1,"6":1,"60":1,"172":1,"197":1}}],["tree",{"2":{"197":1}}],["treating",{"2":{"180":1}}],["treated",{"2":{"116":5,"191":1}}],["treats",{"2":{"56":1,"85":1}}],["trials",{"2":{"176":2,"180":2}}],["triangles",{"2":{"58":1}}],["triangle",{"2":{"6":1,"58":4,"183":4,"198":1}}],["triangulation",{"2":{"6":1,"31":1,"82":1}}],["trivially",{"2":{"148":1}}],["try",{"2":{"74":3,"146":1,"151":1,"153":3,"154":3,"156":3,"199":1}}],["tr",{"2":{"56":3}}],["trues",{"2":{"169":3}}],["true",{"0":{"24":1},"2":{"1":5,"3":25,"4":3,"6":40,"31":1,"53":7,"56":1,"57":1,"59":2,"64":30,"67":1,"69":6,"70":1,"71":2,"72":1,"73":1,"75":2,"76":3,"85":4,"88":21,"90":2,"91":6,"93":1,"94":1,"95":4,"97":1,"98":1,"100":1,"101":1,"103":2,"104":1,"105":9,"107":2,"108":2,"110":1,"111":1,"112":3,"114":1,"115":1,"116":78,"118":3,"119":1,"121":2,"122":18,"124":2,"125":6,"128":1,"129":1,"131":1,"132":1,"134":2,"135":7,"137":1,"138":1,"139":4,"141":1,"142":1,"145":4,"146":5,"150":2,"153":6,"154":2,"156":1,"158":1,"160":3,"169":1,"173":1,"176":1,"180":1,"197":1,"200":1}}],["traditional",{"2":{"146":1,"158":1}}],["traverse",{"2":{"64":1}}],["traced",{"2":{"64":1}}],["traces",{"2":{"64":1}}],["trace",{"2":{"64":2,"70":1,"72":1,"75":1}}],["track",{"2":{"64":3,"169":2}}],["tracing",{"2":{"6":1,"64":4,"69":1,"71":5,"73":2,"76":2}}],["transverse",{"2":{"192":1}}],["translate",{"2":{"59":2}}],["translation",{"2":{"1":2,"6":2,"180":2,"185":2,"191":3,"193":1}}],["transformations",{"2":{"31":10}}],["transformation",{"0":{"185":1},"2":{"6":1,"146":1,"153":1,"164":1,"172":1,"190":1}}],["transform",{"2":{"0":2,"1":6,"6":3,"15":2,"31":1,"148":1,"172":2,"180":1,"185":4,"191":4,"193":1}}],["trait`",{"2":{"156":1}}],["trait2",{"2":{"85":10,"88":2,"110":2,"111":2,"122":2,"127":2,"129":2,"130":2}}],["trait1",{"2":{"85":12,"88":2,"110":2,"111":2,"122":2,"127":2,"129":2,"130":2}}],["traits",{"2":{"6":1,"18":1,"122":1,"151":2,"159":3,"165":2,"180":2}}],["trait",{"2":{"1":5,"3":2,"4":2,"6":6,"18":7,"20":1,"22":1,"31":1,"32":1,"53":2,"56":5,"60":6,"63":7,"67":3,"69":2,"70":2,"71":2,"72":6,"73":4,"75":2,"76":2,"85":7,"88":11,"91":3,"105":2,"108":3,"116":4,"122":10,"125":3,"135":3,"145":1,"148":1,"150":5,"151":3,"153":19,"154":9,"156":27,"159":8,"165":9,"166":1,"177":2,"180":2,"189":7,"191":1}}],["traittarget",{"0":{"159":1},"2":{"1":2,"31":2,"32":1,"53":1,"56":1,"63":1,"69":1,"70":2,"71":4,"72":3,"73":4,"75":2,"76":4,"85":1,"148":1,"150":2,"153":6,"154":6,"158":1,"159":20,"177":1,"180":1}}],["thus",{"2":{"53":1,"56":1,"64":3,"71":1,"73":1,"76":1}}],["though",{"2":{"20":1,"162":1}}],["those",{"2":{"6":1,"33":1,"53":1,"64":1,"73":1,"93":1,"137":1,"158":1,"177":1}}],["thing",{"0":{"30":1}}],["things",{"2":{"9":1}}],["this",{"0":{"30":1},"2":{"0":1,"1":1,"3":1,"4":6,"5":1,"6":30,"7":1,"18":1,"23":3,"24":2,"25":2,"27":2,"29":1,"31":1,"32":3,"33":1,"50":1,"52":2,"53":6,"55":2,"56":9,"57":2,"59":3,"60":11,"62":1,"63":4,"64":26,"66":1,"67":5,"68":1,"69":4,"71":1,"73":5,"74":1,"75":1,"76":2,"82":5,"84":4,"85":6,"88":4,"90":3,"91":3,"98":1,"100":1,"101":2,"103":1,"104":2,"105":1,"108":3,"115":1,"116":3,"119":2,"121":1,"122":4,"125":3,"132":1,"134":1,"135":3,"142":1,"144":1,"145":3,"146":8,"147":2,"148":2,"151":2,"153":15,"154":7,"155":2,"156":2,"157":1,"158":4,"159":2,"160":4,"161":3,"163":3,"164":1,"165":6,"166":7,"167":4,"169":3,"170":2,"171":2,"172":4,"173":3,"174":3,"175":5,"176":5,"177":5,"178":2,"180":3,"184":9,"185":1,"186":3,"187":2,"188":1,"189":1,"190":1,"191":2,"192":4,"193":3,"194":3,"195":1,"197":3,"198":3,"199":3,"200":1}}],["three",{"2":{"26":1,"58":1,"73":1,"158":1,"177":1}}],["thread",{"2":{"153":3,"154":3}}],["threading",{"0":{"153":1},"2":{"153":5,"154":2,"160":1}}],["threads",{"2":{"1":1,"150":1,"153":5,"154":7}}],["threaded=",{"2":{"153":4,"154":5}}],["threaded=true",{"2":{"153":1}}],["threaded=false",{"2":{"56":1,"63":4,"69":2,"85":8,"153":1,"154":1,"170":1,"180":1}}],["threaded==true",{"2":{"1":1,"150":1,"153":1}}],["threaded",{"2":{"1":3,"4":1,"6":5,"24":1,"31":1,"32":2,"53":2,"56":1,"63":3,"69":3,"85":5,"150":2,"153":25,"154":27,"155":1,"160":2,"170":1,"177":13,"180":1}}],["through",{"2":{"6":4,"53":1,"60":1,"64":3,"66":1,"67":2,"69":1,"82":1,"91":1,"116":5,"135":1,"146":1,"151":1,"153":1,"166":2,"169":2,"182":1,"187":1,"191":1}}],["thrown",{"2":{"151":1}}],["throws",{"2":{"6":1,"187":1}}],["throw",{"2":{"4":1,"6":1,"76":1,"88":1,"146":1,"153":1,"154":1,"156":3}}],["than",{"2":{"1":1,"3":1,"6":10,"11":1,"64":2,"93":1,"105":1,"122":1,"137":1,"145":1,"146":2,"150":1,"152":1,"153":1,"157":1,"166":2,"167":1,"168":1,"169":2,"174":1,"176":2,"177":1,"181":1,"187":2}}],["that",{"2":{"1":1,"3":3,"4":8,"6":40,"9":1,"17":1,"18":4,"19":3,"20":1,"22":3,"25":1,"26":1,"27":1,"53":4,"55":2,"56":4,"57":2,"60":4,"62":2,"63":3,"64":17,"68":3,"69":5,"70":4,"71":5,"72":4,"73":14,"75":3,"76":5,"77":1,"81":3,"82":4,"85":2,"87":1,"88":11,"90":2,"91":1,"100":4,"101":1,"104":1,"107":1,"108":1,"116":3,"118":1,"119":1,"121":2,"122":10,"124":2,"125":2,"127":2,"134":3,"135":1,"137":3,"145":1,"146":4,"148":1,"150":1,"153":5,"154":1,"155":1,"156":4,"157":2,"158":6,"159":1,"160":3,"161":3,"162":2,"163":1,"164":3,"165":2,"166":4,"167":2,"168":3,"169":4,"172":1,"174":2,"175":2,"176":3,"177":2,"180":2,"182":1,"184":1,"187":1,"192":4,"193":1,"194":2,"195":3,"197":1,"198":2}}],["theta",{"2":{"158":1}}],["theorem",{"2":{"85":1}}],["themselves",{"2":{"60":1}}],["them",{"2":{"25":1,"27":1,"64":1,"146":2,"147":2,"153":3,"156":2,"162":2,"167":1,"168":1,"180":1,"191":1,"193":1,"195":3}}],["thereof",{"2":{"148":1,"154":1}}],["therefore",{"2":{"84":1,"161":1}}],["there",{"2":{"6":2,"22":1,"53":1,"57":1,"60":2,"64":3,"67":2,"69":1,"71":1,"73":6,"74":1,"76":1,"116":1,"122":2,"146":3,"147":1,"148":1,"153":4,"158":1,"159":1,"162":1,"175":1,"184":1,"187":1,"192":2,"195":3}}],["then",{"2":{"6":5,"18":1,"22":1,"29":1,"53":3,"60":2,"64":6,"69":1,"70":1,"72":2,"73":6,"74":2,"75":2,"76":2,"82":1,"116":1,"146":2,"148":1,"151":1,"153":2,"154":3,"167":1,"176":2,"180":1,"192":1,"197":1,"198":1}}],["their",{"2":{"3":1,"4":1,"6":2,"60":1,"62":2,"76":1,"85":2,"113":1,"122":1,"124":1,"128":1,"129":1,"138":3,"139":3,"148":1,"154":1,"162":1,"168":1,"170":1}}],["they",{"2":{"3":3,"4":11,"6":24,"20":2,"22":1,"23":1,"24":1,"58":1,"63":2,"64":8,"69":2,"70":2,"72":1,"73":6,"75":2,"76":3,"81":1,"87":3,"88":16,"91":1,"107":1,"111":2,"112":1,"113":1,"116":2,"118":1,"121":2,"122":4,"127":1,"129":1,"130":1,"138":1,"139":1,"146":6,"153":2,"156":2,"161":1,"166":2,"169":2,"175":1,"184":1,"186":1,"198":1}}],["these",{"2":{"1":2,"6":4,"24":1,"53":1,"60":5,"64":3,"76":1,"87":1,"88":1,"91":1,"100":1,"103":1,"105":2,"107":1,"108":1,"118":1,"121":1,"122":1,"124":2,"125":1,"134":1,"135":1,"145":1,"146":3,"150":1,"151":1,"153":2,"172":1,"176":1,"180":2,"187":1,"195":1,"197":1}}],["the",{"0":{"26":1,"29":1,"62":1,"80":1,"81":1},"2":{"1":28,"3":64,"4":112,"5":12,"6":386,"7":5,"9":3,"10":1,"11":3,"17":5,"18":10,"19":2,"20":4,"22":4,"23":5,"24":3,"25":3,"26":4,"27":3,"29":3,"32":3,"52":1,"53":63,"55":12,"56":43,"57":6,"58":15,"59":12,"60":71,"62":6,"63":25,"64":116,"66":2,"67":7,"68":7,"69":47,"70":27,"71":23,"72":27,"73":82,"74":1,"75":29,"76":70,"77":6,"81":11,"82":16,"84":11,"85":81,"87":5,"88":47,"90":8,"91":25,"94":8,"95":9,"96":3,"97":3,"98":2,"100":9,"101":11,"103":4,"104":11,"105":5,"107":2,"108":21,"110":8,"111":6,"112":4,"114":3,"115":2,"116":123,"118":5,"119":6,"121":5,"122":26,"124":5,"125":21,"127":6,"128":10,"129":7,"130":3,"131":3,"132":2,"134":7,"135":24,"137":2,"138":9,"139":9,"140":6,"141":2,"142":2,"144":1,"145":8,"146":47,"147":1,"148":9,"150":14,"151":11,"153":69,"154":23,"155":2,"156":19,"157":1,"158":24,"160":5,"161":5,"162":5,"163":4,"164":2,"165":13,"166":10,"167":4,"168":8,"169":6,"170":1,"171":5,"172":14,"173":2,"174":3,"175":5,"176":26,"177":21,"178":3,"180":18,"181":3,"182":6,"183":3,"184":2,"185":3,"186":2,"187":21,"188":1,"191":10,"192":11,"193":10,"194":2,"195":4,"197":10,"198":17,"199":3}}],["t",{"2":{"0":1,"4":28,"6":54,"9":1,"23":1,"31":8,"32":1,"53":32,"56":41,"60":26,"63":38,"64":74,"67":18,"69":44,"70":12,"71":12,"72":12,"73":156,"75":10,"76":20,"85":87,"88":17,"90":1,"111":1,"116":24,"122":1,"124":1,"128":2,"129":1,"146":14,"153":5,"154":4,"156":3,"158":5,"159":14,"160":2,"166":2,"169":2,"176":3,"177":4,"180":1,"187":3,"188":7,"189":10,"191":4,"199":1}}],["tokyo",{"2":{"199":1}}],["toy",{"2":{"197":1}}],["together",{"2":{"73":1,"76":1,"191":1,"198":1}}],["touching",{"0":{"128":1},"2":{"73":1,"76":1}}],["touch",{"0":{"129":1,"130":1,"131":1},"2":{"64":1,"124":1,"127":2,"129":1,"131":1}}],["touches",{"0":{"42":1,"123":1,"124":1,"127":1},"1":{"124":1,"125":1},"2":{"0":2,"3":3,"6":3,"31":1,"42":2,"123":1,"124":3,"125":11,"126":6,"127":11,"128":15,"129":9,"130":8,"131":3,"132":4,"197":1}}],["totally",{"2":{"75":1}}],["total",{"2":{"56":1,"60":2,"64":2,"69":1}}],["towards",{"2":{"25":1,"27":1}}],["topright",{"2":{"180":1}}],["topologypreserve",{"2":{"178":1}}],["topology",{"2":{"178":1}}],["topological",{"2":{"158":2}}],["top",{"2":{"20":1,"26":1,"64":1,"146":1}}],["took",{"2":{"199":1}}],["tools",{"2":{"17":1}}],["too",{"2":{"6":1,"73":1,"174":1,"177":1}}],["tol^2",{"2":{"181":1,"182":1}}],["tolerances",{"2":{"183":1,"184":29}}],["tolerance",{"2":{"181":1,"182":1,"183":1,"184":17}}],["tol",{"2":{"6":12,"176":2,"180":18,"181":7,"182":15,"183":8,"184":18}}],["todo",{"2":{"3":2,"6":2,"32":1,"64":1,"73":1,"82":2,"105":4,"122":1,"146":1,"153":1,"160":1,"163":1,"180":1}}],["to",{"0":{"9":1,"23":1,"26":1,"74":1,"92":1,"109":1,"126":1,"136":1},"2":{"0":2,"1":22,"3":1,"4":33,"5":4,"6":125,"7":2,"9":3,"10":2,"11":2,"13":1,"17":2,"18":9,"19":1,"20":2,"22":3,"23":4,"24":2,"25":3,"26":2,"27":3,"29":4,"30":1,"52":1,"53":8,"55":1,"56":4,"57":2,"58":4,"59":1,"60":26,"62":2,"63":5,"64":32,"66":1,"67":3,"68":1,"69":12,"70":8,"71":4,"72":8,"73":27,"75":7,"76":11,"77":1,"79":1,"80":1,"81":4,"82":6,"84":6,"85":32,"87":2,"88":17,"90":2,"91":7,"100":1,"101":1,"103":3,"104":1,"105":2,"107":1,"108":7,"116":21,"118":2,"119":1,"121":3,"122":7,"124":1,"125":7,"127":1,"134":1,"135":7,"145":4,"146":16,"148":4,"150":9,"151":6,"152":1,"153":33,"154":11,"155":7,"156":23,"158":7,"159":2,"160":6,"161":2,"162":3,"164":4,"165":8,"166":5,"167":3,"168":1,"169":4,"170":3,"171":1,"172":4,"173":1,"174":3,"175":3,"176":9,"177":7,"178":1,"180":4,"181":1,"182":15,"183":1,"184":2,"185":4,"186":2,"187":9,"188":1,"189":28,"190":4,"191":6,"192":10,"193":6,"194":7,"195":5,"196":1,"197":7,"198":5,"199":2,"200":8}}],["o",{"2":{"154":24}}],["odd",{"2":{"116":1}}],["own",{"2":{"76":1,"148":2}}],["occur",{"2":{"73":1}}],["occurs",{"2":{"73":1}}],["occupied",{"2":{"55":1}}],["old",{"2":{"64":8,"153":3}}],["ourselves",{"2":{"176":1}}],["our",{"2":{"24":1,"176":1,"191":4,"192":3,"198":1}}],["out=3",{"2":{"116":1}}],["out=4",{"2":{"72":1}}],["out`",{"2":{"72":1,"116":1}}],["out",{"2":{"6":3,"64":12,"69":23,"73":6,"76":4,"82":1,"84":5,"91":4,"105":1,"108":3,"116":102,"122":2,"125":4,"135":4,"145":1,"153":1,"177":1,"187":2}}],["outside",{"2":{"3":2,"4":1,"6":3,"64":3,"69":1,"71":2,"73":4,"76":3,"84":2,"85":1,"90":1,"104":1,"107":1,"116":12,"122":3,"140":1}}],["outputs",{"2":{"64":1}}],["output",{"2":{"3":8,"4":1,"6":18,"18":1,"23":1,"67":2,"70":1,"72":1,"73":1,"75":1,"76":2,"88":1,"91":1,"101":1,"104":1,"108":1,"119":1,"122":1,"125":1,"135":1,"145":2,"180":1,"184":1,"189":1}}],["outerjoin",{"2":{"197":1}}],["outermost",{"2":{"153":1}}],["outer",{"2":{"1":1,"150":1,"151":1,"153":2,"198":1}}],["omit",{"2":{"6":1,"176":1}}],["obtain",{"2":{"153":1}}],["obtained",{"2":{"23":1}}],["observable",{"2":{"14":2}}],["obs",{"2":{"14":10}}],["obviously",{"2":{"4":1,"6":1,"170":1}}],["objects",{"2":{"1":4,"4":1,"6":10,"150":4,"151":5,"153":4,"154":1,"156":6,"170":1,"174":1,"180":2,"188":1}}],["object",{"2":{"1":4,"4":1,"5":1,"6":5,"20":1,"60":1,"84":1,"116":4,"150":1,"151":5,"153":1,"156":4,"170":1,"172":3,"176":1,"180":1,"188":1}}],["obj",{"2":{"1":4,"4":1,"6":10,"150":2,"153":1,"154":1,"156":13,"170":1,"171":2,"176":3,"180":3,"185":1,"188":1}}],["others",{"2":{"57":1,"169":1}}],["otherwise",{"2":{"4":2,"6":3,"57":1,"64":1,"71":1,"73":1,"85":2,"146":1,"171":1,"173":1,"176":1,"189":1}}],["other",{"0":{"4":1,"6":1,"156":1},"2":{"3":4,"6":10,"53":1,"64":5,"70":1,"72":1,"73":1,"75":2,"76":3,"77":2,"85":2,"88":2,"93":1,"100":1,"116":8,"118":1,"121":1,"122":4,"124":2,"125":2,"128":1,"137":1,"146":1,"151":1,"153":1,"156":2,"159":1,"166":2,"167":1,"169":2,"180":2,"182":2,"186":1,"187":1,"192":1,"197":4,"200":1}}],["ogc",{"0":{"3":1}}],["over=3",{"2":{"72":1}}],["over`",{"2":{"72":1}}],["overflow",{"2":{"67":1}}],["overhead",{"2":{"22":1,"153":1,"154":1}}],["overrides",{"0":{"33":1},"1":{"34":1,"35":1,"36":1,"37":1,"38":1,"39":1,"40":1,"41":1,"42":1,"43":1,"44":1,"45":1,"46":1,"47":1,"48":1,"49":1,"50":1},"2":{"33":1}}],["override",{"2":{"6":1,"60":1}}],["overlapping",{"2":{"64":11,"73":4,"76":6}}],["overlap",{"2":{"3":4,"6":4,"9":1,"64":2,"73":8,"76":2,"91":1,"103":1,"116":2,"121":5,"122":6,"135":1,"167":1}}],["overlaps",{"0":{"46":1,"120":1,"121":1},"1":{"121":1,"122":1},"2":{"0":10,"3":5,"6":13,"31":1,"46":2,"73":1,"120":1,"121":3,"122":30,"146":1,"197":1}}],["over",{"2":{"1":1,"6":2,"55":2,"56":1,"63":3,"64":5,"69":1,"72":1,"73":11,"76":1,"81":1,"91":1,"105":1,"108":1,"116":15,"122":2,"125":1,"135":1,"150":1,"153":9,"154":11,"156":3,"191":3}}],["opposed",{"2":{"196":1}}],["opposite",{"2":{"3":5,"6":5,"64":2,"71":1,"73":2,"76":1,"91":1,"101":2,"104":2,"119":2,"135":1}}],["ops",{"2":{"154":1}}],["operable",{"2":{"158":1}}],["operates",{"2":{"153":1,"154":1,"161":1,"167":1}}],["operate",{"2":{"18":1,"29":1,"154":1}}],["operations",{"0":{"23":1,"34":1},"1":{"35":1,"36":1,"37":1,"38":1},"2":{"23":1,"26":1,"73":1,"76":1,"148":1}}],["operation",{"2":{"6":3,"64":1,"148":1,"154":1,"158":1,"166":2,"169":2,"187":2,"197":1}}],["open",{"2":{"64":1,"162":1,"192":1}}],["open>",{"2":{"6":2}}],["optimisation",{"2":{"116":1}}],["optimise",{"2":{"105":1}}],["optimal",{"2":{"6":1,"82":1}}],["options",{"2":{"14":1,"64":1}}],["optional",{"2":{"4":5,"6":6,"53":1,"56":2,"69":1,"85":2}}],["op",{"2":{"1":3,"19":2,"63":1,"150":3,"154":35}}],["on=2",{"2":{"116":1}}],["on`",{"2":{"116":1}}],["once",{"2":{"105":1,"122":1,"146":1}}],["onto",{"2":{"85":1}}],["ones",{"2":{"168":1}}],["oneunit",{"2":{"60":1}}],["one",{"2":{"1":1,"3":9,"6":14,"23":1,"53":4,"56":2,"59":1,"60":1,"63":1,"64":5,"69":3,"70":1,"71":1,"72":1,"73":32,"75":2,"76":2,"77":1,"84":2,"90":1,"97":1,"105":1,"107":1,"116":18,"121":1,"122":18,"124":2,"125":2,"128":3,"129":2,"130":2,"131":1,"132":1,"134":1,"135":1,"141":1,"145":1,"146":5,"153":1,"158":2,"168":1,"172":1,"176":1,"184":1,"185":1,"192":1,"197":1}}],["on",{"0":{"192":1},"2":{"1":2,"4":3,"6":9,"9":1,"18":1,"20":1,"23":2,"25":3,"27":3,"29":2,"32":1,"53":5,"56":3,"59":1,"60":2,"63":3,"64":28,"67":1,"69":8,"70":1,"71":5,"72":1,"73":4,"75":1,"76":2,"82":1,"84":1,"85":3,"88":2,"90":1,"91":7,"93":2,"94":3,"95":3,"96":1,"105":4,"108":6,"110":4,"111":1,"112":1,"116":125,"122":9,"125":7,"127":2,"135":7,"137":2,"138":1,"139":1,"146":3,"148":1,"150":2,"153":12,"154":4,"156":2,"158":4,"160":2,"161":1,"163":1,"166":1,"167":1,"174":1,"176":1,"177":1,"182":1,"190":1,"192":3,"193":1,"195":1,"196":1,"197":4,"198":1,"199":2,"200":2}}],["only",{"2":{"0":1,"5":1,"6":10,"23":1,"33":2,"56":2,"57":1,"59":2,"60":1,"63":2,"64":4,"67":1,"69":3,"70":1,"72":1,"73":1,"75":1,"82":3,"85":2,"88":3,"121":3,"122":1,"124":1,"146":2,"153":1,"154":2,"158":2,"168":1,"174":1,"175":1,"177":1,"186":1,"187":2,"193":1,"199":1,"200":1}}],["often",{"2":{"192":1}}],["offers",{"2":{"191":1}}],["offer",{"2":{"176":1}}],["offset",{"2":{"53":8,"88":1}}],["off",{"2":{"4":1,"6":1,"64":4,"88":1,"116":6,"154":1}}],["of",{"0":{"80":1},"2":{"1":7,"3":29,"4":66,"5":5,"6":190,"7":2,"9":4,"17":3,"18":5,"19":1,"20":2,"22":1,"23":2,"24":2,"25":1,"26":1,"27":1,"29":3,"32":2,"52":1,"53":38,"55":5,"56":28,"57":1,"58":9,"59":1,"60":13,"62":3,"63":12,"64":84,"67":5,"68":5,"69":31,"70":12,"71":13,"72":10,"73":48,"75":9,"76":20,"77":5,"81":3,"82":3,"84":6,"85":18,"87":2,"88":19,"90":6,"91":18,"93":1,"94":5,"95":5,"96":1,"97":2,"98":1,"100":4,"101":5,"104":5,"105":1,"107":3,"108":14,"110":1,"111":1,"112":1,"114":2,"115":1,"116":85,"118":1,"119":3,"121":1,"122":13,"124":2,"125":15,"127":3,"128":7,"129":5,"130":1,"131":2,"132":1,"134":4,"135":18,"137":3,"138":6,"139":6,"140":4,"141":1,"142":1,"144":2,"145":3,"146":19,"147":2,"148":3,"150":6,"151":5,"152":2,"153":21,"154":7,"156":2,"158":5,"159":2,"161":1,"162":1,"166":2,"167":4,"169":4,"171":3,"172":1,"174":2,"175":2,"176":5,"177":6,"180":8,"182":4,"183":2,"184":1,"187":4,"188":1,"189":2,"191":6,"192":4,"193":2,"194":1,"195":4,"197":4,"198":4,"199":2}}],["org",{"2":{"70":1,"72":1,"75":1,"116":2,"182":1}}],["organise",{"2":{"10":1}}],["orange",{"2":{"66":1,"84":1,"87":2,"100":2,"107":2,"121":2,"134":2}}],["oro",{"2":{"11":2}}],["originate",{"2":{"76":1}}],["originals",{"2":{"22":1}}],["original",{"2":{"6":4,"18":1,"22":1,"64":10,"67":5,"70":1,"72":1,"76":4,"151":1,"153":7,"165":1,"171":2,"177":1,"179":4,"180":1}}],["orient",{"0":{"13":1},"1":{"14":1,"15":1},"2":{"13":7,"14":12,"64":15,"73":53}}],["orientation",{"0":{"143":1},"1":{"144":1,"145":1},"2":{"6":2,"10":1,"31":1,"56":1,"64":10,"69":2,"70":1,"72":2,"73":2,"75":1,"116":16,"144":1,"180":1}}],["ordered",{"2":{"55":1}}],["order",{"0":{"81":1},"2":{"1":4,"3":1,"4":2,"6":5,"53":1,"55":1,"56":2,"60":1,"64":4,"73":1,"76":1,"81":4,"82":1,"85":2,"88":3,"91":1,"101":1,"104":1,"119":1,"150":2,"153":1,"154":1,"172":2,"180":1,"197":1}}],["or",{"0":{"24":1},"2":{"1":11,"3":3,"4":10,"6":46,"18":1,"20":1,"22":1,"23":1,"25":1,"27":1,"29":2,"31":1,"32":1,"53":4,"56":1,"57":1,"60":1,"62":2,"63":4,"64":24,"67":1,"68":1,"70":1,"71":3,"72":2,"73":9,"75":1,"76":2,"77":1,"82":1,"84":2,"85":4,"88":3,"91":1,"93":2,"94":1,"95":1,"96":1,"97":1,"98":1,"100":1,"107":2,"110":2,"111":3,"112":2,"113":1,"114":1,"115":1,"116":26,"118":2,"119":1,"121":1,"122":2,"124":1,"125":1,"131":1,"132":1,"135":1,"137":2,"141":1,"142":1,"144":2,"145":3,"146":7,"148":4,"150":7,"152":1,"153":8,"154":3,"155":2,"156":2,"158":2,"159":3,"160":1,"161":1,"163":1,"165":5,"166":2,"172":2,"173":1,"174":2,"176":2,"177":4,"178":1,"180":3,"182":2,"184":2,"188":1,"189":2,"197":1,"199":2}}],["ecosystem",{"2":{"157":1}}],["effects",{"2":{"153":2,"154":1}}],["efficiently",{"2":{"20":1}}],["efficient",{"2":{"6":1,"60":1,"70":2,"72":2,"75":2,"82":1,"163":1}}],["e2",{"2":{"116":4}}],["e1",{"2":{"116":8}}],["euclid",{"2":{"69":2,"85":11,"116":1,"181":1}}],["euclidean",{"2":{"4":1,"6":1,"60":13,"85":6,"158":6,"177":1}}],["everything",{"2":{"180":1}}],["everywhere",{"2":{"158":1}}],["every",{"2":{"64":1,"88":2,"151":1,"187":1}}],["evenly",{"2":{"198":1}}],["eventually",{"2":{"64":1}}],["even",{"2":{"56":2,"69":1,"73":1,"85":1,"88":1,"148":1,"162":1,"167":1}}],["evaluated",{"2":{"197":1}}],["eval",{"2":{"31":2,"153":1,"154":1}}],["epsg",{"2":{"192":5,"193":8}}],["eps",{"2":{"53":2,"73":14}}],["eponymous",{"2":{"6":1,"176":1}}],["est",{"2":{"199":1}}],["essentially",{"2":{"33":1,"159":1}}],["especially",{"2":{"6":1,"18":1,"23":1,"146":1}}],["eg",{"2":{"32":1}}],["etc",{"0":{"156":1},"2":{"20":2,"55":1,"82":1,"159":1,"195":1}}],["e",{"2":{"9":1,"22":1,"57":1,"146":1,"151":1,"153":2,"158":1,"191":2,"192":1,"195":1}}],["ellipsoid",{"2":{"158":2,"196":1}}],["ellipsoidal",{"2":{"6":1,"177":1}}],["eltype",{"2":{"146":4}}],["elements",{"2":{"97":1,"98":1,"114":1,"115":1,"122":1,"131":1,"132":1,"141":1,"142":1}}],["element",{"2":{"6":6,"52":1,"64":4,"67":2,"70":1,"72":1,"73":1,"75":3,"175":1,"192":1}}],["elsewhere",{"2":{"67":1}}],["elseif",{"2":{"64":5,"69":7,"70":1,"72":1,"73":14,"75":2,"76":1,"105":3,"116":10,"145":1,"146":2,"169":1,"182":2,"184":2}}],["else",{"2":{"3":6,"6":6,"53":1,"60":2,"64":19,"67":1,"69":9,"71":2,"73":9,"75":1,"76":9,"105":2,"116":17,"122":8,"146":20,"153":6,"154":2,"156":2,"163":1,"171":1,"173":1,"180":2,"182":4,"184":2,"185":1,"187":1,"188":1}}],["empty",{"2":{"4":2,"6":6,"53":2,"64":2,"70":1,"72":1,"73":2,"75":1,"146":2}}],["embedding",{"0":{"152":1,"170":1}}],["embedded",{"0":{"193":1},"2":{"146":1,"152":3,"190":1,"193":1}}],["embed",{"2":{"0":2,"4":1,"6":1,"152":1,"170":2}}],["errors",{"2":{"31":1,"73":1,"177":1}}],["error",{"0":{"173":1},"2":{"4":1,"6":4,"7":1,"18":1,"31":6,"32":2,"57":4,"60":1,"64":2,"73":2,"74":1,"88":2,"146":1,"151":1,"165":2,"173":3,"176":5,"184":4,"187":3,"189":1}}],["edgekeys",{"2":{"146":3}}],["edge",{"2":{"3":1,"4":3,"6":4,"20":1,"31":1,"56":1,"62":1,"64":25,"69":13,"70":1,"72":1,"73":6,"75":1,"85":4,"88":1,"93":2,"111":2,"112":1,"116":7,"122":21,"137":2,"138":1,"139":1,"146":7,"189":2}}],["edges`",{"2":{"73":1}}],["edges",{"2":{"0":1,"4":2,"6":9,"64":12,"69":8,"71":3,"73":10,"76":3,"85":3,"87":2,"88":1,"93":1,"94":3,"95":7,"96":3,"100":1,"107":1,"110":3,"113":1,"116":3,"122":20,"134":1,"137":1,"146":22,"189":29}}],["earlier",{"2":{"191":3}}],["earth",{"2":{"6":3,"25":1,"27":1,"158":3,"176":2,"177":1,"180":1,"192":2,"197":1}}],["easiest",{"2":{"194":1}}],["easier",{"2":{"160":1,"186":1}}],["easily",{"2":{"148":1}}],["east",{"2":{"69":9}}],["easy",{"2":{"1":1,"6":1,"167":1,"185":1}}],["eachindex",{"2":{"53":1,"145":1,"146":3,"153":1,"154":1,"181":1,"184":1}}],["each",{"2":{"3":2,"4":3,"6":6,"9":1,"18":2,"20":1,"53":4,"56":2,"58":4,"60":1,"64":5,"69":1,"73":3,"85":1,"88":2,"91":1,"108":1,"116":6,"121":1,"122":3,"125":1,"135":1,"145":1,"146":1,"153":1,"167":2,"180":1,"194":1,"195":1,"198":2,"199":2,"200":1}}],["equator",{"2":{"158":1}}],["equatorial",{"2":{"6":6,"176":4}}],["equality",{"2":{"64":1,"73":1,"197":1}}],["equal",{"2":{"3":2,"4":16,"6":19,"53":6,"73":1,"84":1,"85":4,"87":3,"88":22,"93":1,"110":1,"116":15,"121":1,"122":2,"127":2,"137":1,"162":1}}],["equals",{"0":{"40":1,"86":1,"87":1},"1":{"87":1,"88":1},"2":{"0":17,"4":3,"6":19,"31":1,"40":2,"53":2,"64":4,"67":2,"73":8,"85":1,"86":1,"87":2,"88":50,"93":1,"110":1,"116":10,"122":2,"127":3,"137":1,"197":1}}],["equivalent",{"2":{"3":1,"4":4,"6":6,"56":1,"64":1,"73":1,"76":1,"88":5,"91":1,"116":1}}],["enable",{"2":{"200":1}}],["enabled",{"2":{"197":1}}],["enabling",{"0":{"200":1}}],["enclosed",{"2":{"116":1}}],["encode",{"2":{"24":1}}],["encompasses",{"2":{"18":1,"116":1}}],["encounters",{"2":{"18":1}}],["en",{"2":{"116":1,"182":1}}],["envelope",{"2":{"73":2}}],["envelopes",{"2":{"73":2}}],["enough",{"2":{"64":1}}],["entirely",{"2":{"116":1}}],["entire",{"2":{"69":1,"116":4}}],["entry",{"2":{"64":11,"71":3,"73":4,"76":3,"146":1}}],["ent",{"2":{"64":19,"67":2}}],["enter",{"2":{"64":4}}],["ensuring",{"2":{"6":1,"174":1,"177":1}}],["ensure",{"2":{"6":3,"60":1,"70":1,"72":1,"75":1,"153":2,"161":2,"164":1}}],["ensures",{"2":{"6":3,"163":1,"166":3,"169":2}}],["enumerate",{"2":{"13":2,"53":1,"64":10,"67":1,"69":1,"71":1,"76":2,"116":1,"146":2,"169":2,"184":1}}],["enum",{"2":{"6":2,"64":3,"72":3,"116":3}}],["endpt",{"2":{"182":3}}],["endpoints",{"2":{"64":3,"69":1,"71":1,"73":6,"76":1,"85":2,"116":11,"122":2,"124":1}}],["endpoint=3",{"2":{"64":1}}],["endpointtype",{"2":{"64":2}}],["endpoint",{"2":{"3":1,"6":2,"64":27,"72":1,"73":16,"85":2,"90":1,"116":3,"122":2,"180":4,"182":4,"191":1}}],["ending",{"2":{"64":1,"69":1}}],["end",{"2":{"1":1,"9":1,"13":4,"14":3,"31":4,"32":4,"35":1,"36":1,"37":1,"38":1,"40":1,"41":1,"42":1,"43":1,"44":1,"45":1,"46":1,"47":1,"48":1,"49":1,"50":1,"53":18,"56":8,"57":3,"60":35,"63":10,"64":130,"67":9,"69":43,"70":8,"71":12,"72":5,"73":31,"74":1,"75":6,"76":24,"82":3,"85":19,"88":20,"97":2,"98":2,"105":20,"114":2,"115":2,"116":104,"122":21,"127":1,"131":2,"132":2,"137":1,"141":2,"142":2,"145":9,"146":44,"147":1,"148":1,"150":1,"153":27,"154":17,"156":15,"158":4,"159":1,"160":4,"161":1,"163":5,"165":3,"169":18,"171":4,"172":1,"173":2,"176":8,"177":9,"180":7,"181":6,"182":30,"183":3,"184":27,"185":4,"187":4,"188":4,"189":19}}],["enforce",{"2":{"0":1,"6":2,"32":3,"187":3}}],["exits",{"2":{"64":1}}],["exit",{"2":{"64":32,"67":2,"71":3,"73":3,"76":2}}],["existingnodes",{"2":{"146":3}}],["existing",{"2":{"64":3,"75":1,"146":1,"192":2,"194":1}}],["exists",{"2":{"64":1,"69":1,"73":1}}],["exist",{"2":{"6":1,"64":1,"73":3,"187":1}}],["excluding",{"2":{"113":1,"116":1,"137":2}}],["exclude",{"2":{"105":9}}],["exclusively",{"2":{"129":1}}],["exclusive",{"2":{"69":1,"73":2}}],["exc",{"2":{"57":2,"173":2,"176":2}}],["excellent",{"2":{"23":1}}],["except",{"2":{"18":1,"19":1}}],["excess",{"2":{"5":1,"6":1,"60":1}}],["exp10",{"2":{"176":1,"180":2}}],["expressed",{"2":{"58":2}}],["express",{"2":{"58":1}}],["experimental",{"2":{"31":3}}],["expect",{"2":{"1":1,"118":1,"172":1}}],["explain",{"2":{"26":1}}],["explanations",{"2":{"26":3}}],["explicitly",{"2":{"18":1,"24":1,"53":2,"56":1,"57":1,"60":1,"85":2,"88":1,"173":1,"176":1}}],["expose",{"2":{"77":1}}],["exposes",{"2":{"17":1}}],["export",{"2":{"31":1,"58":1,"158":2,"174":1,"193":1,"195":1}}],["exponential",{"2":{"9":1}}],["ext2",{"2":{"116":3}}],["ext1",{"2":{"116":3}}],["ext",{"2":{"59":15,"64":10,"67":3,"69":2,"70":8,"72":8,"73":18,"75":8,"76":14,"105":7,"116":7}}],["extrema",{"2":{"146":1,"189":1}}],["extreem",{"2":{"53":10}}],["extracts",{"2":{"82":1}}],["extract",{"2":{"82":1,"146":1,"153":1,"154":2,"180":1}}],["extra",{"2":{"6":3,"64":1,"75":1,"174":1,"176":2,"177":1}}],["external",{"2":{"56":1,"116":2}}],["exteriors",{"2":{"9":1,"72":2,"75":2,"146":1}}],["exterior",{"2":{"3":4,"4":2,"6":10,"53":1,"55":1,"56":1,"59":1,"60":36,"63":2,"64":4,"70":2,"75":3,"76":14,"85":1,"88":2,"91":3,"100":1,"101":1,"104":1,"108":2,"116":9,"125":2,"134":1,"135":3,"138":3,"139":3,"145":6,"146":6,"163":3,"164":1,"166":1,"170":1,"191":2}}],["extending",{"2":{"122":1}}],["extended",{"2":{"85":1,"158":2}}],["extensions",{"2":{"77":1,"195":1}}],["extension",{"2":{"1":1,"6":1,"57":1,"60":1,"82":1,"90":1,"147":1,"172":3,"173":2,"176":1,"177":1,"178":1,"195":1}}],["extent`",{"2":{"155":1,"170":1}}],["extent=true",{"2":{"170":1}}],["extent=nothing",{"2":{"156":1}}],["extent=",{"2":{"153":4}}],["extent=false",{"2":{"153":1,"180":1}}],["extent=gi",{"2":{"146":3}}],["extents",{"2":{"4":3,"6":3,"31":5,"69":1,"73":3,"116":5,"122":1,"146":3,"153":2,"170":2,"189":2}}],["extent",{"0":{"170":1},"2":{"0":2,"1":4,"4":3,"6":9,"24":1,"31":3,"32":1,"35":2,"36":2,"37":2,"38":2,"50":1,"59":1,"68":1,"69":1,"73":10,"116":4,"122":2,"146":12,"150":2,"152":4,"153":29,"155":3,"156":2,"160":1,"170":2,"180":1,"189":7}}],["exactly",{"2":{"184":1}}],["exactpredicates",{"2":{"7":1,"13":2,"14":2,"31":1}}],["exact",{"2":{"3":5,"6":5,"7":2,"12":1,"13":1,"64":36,"67":7,"69":6,"70":5,"72":5,"73":7,"74":1,"75":5,"76":7,"91":3,"93":1,"94":3,"95":3,"96":1,"101":2,"104":2,"105":1,"108":2,"110":1,"111":3,"112":2,"113":1,"116":24,"119":2,"122":3,"125":2,"127":1,"128":3,"129":1,"130":1,"135":3,"137":1,"138":3,"139":3,"140":1,"146":1,"168":1}}],["examples",{"0":{"175":1,"179":1},"2":{"3":8,"4":1,"6":11,"26":2,"88":1,"91":1,"101":1,"104":1,"105":1,"108":1,"122":1,"125":1,"135":1,"145":2,"189":1}}],["example",{"0":{"59":1,"78":1,"162":1,"168":1,"198":1,"199":1},"1":{"79":1},"2":{"1":3,"3":2,"6":11,"11":1,"20":1,"23":2,"52":1,"55":1,"59":1,"62":1,"63":1,"66":1,"67":1,"68":1,"70":1,"72":1,"73":1,"75":1,"84":1,"87":1,"88":1,"90":1,"100":1,"103":1,"105":1,"107":1,"116":1,"118":1,"119":1,"121":1,"124":1,"134":1,"145":1,"146":8,"148":1,"150":2,"153":2,"162":1,"164":1,"167":1,"168":1,"171":1,"179":1,"180":2,"185":1,"187":1,"198":1,"200":1}}],["either",{"2":{"1":2,"3":1,"6":2,"22":1,"25":1,"27":1,"64":9,"70":1,"72":1,"73":2,"75":1,"76":1,"84":1,"91":1,"116":5,"118":1,"124":1,"125":1,"135":1,"146":1,"150":2,"153":3,"165":1,"197":1}}],["lj",{"2":{"146":2}}],["lrs",{"2":{"180":2}}],["lr",{"2":{"146":3,"153":3}}],["lp",{"2":{"116":2}}],["lstart",{"2":{"116":2}}],["ls",{"2":{"116":12}}],["ll",{"2":{"17":1,"59":1,"175":2,"180":1,"192":1,"194":1}}],["l",{"2":{"14":4,"60":6,"105":2,"116":32}}],["lgeos",{"2":{"180":1}}],["lg",{"2":{"13":1,"14":1,"15":2,"32":5,"33":1,"35":3,"36":3,"37":3,"38":3,"40":3,"41":3,"42":3,"43":3,"44":3,"45":3,"46":3,"47":3,"48":3,"49":3,"50":3,"81":4,"176":9,"180":17}}],["l305",{"2":{"6":1}}],["log10",{"2":{"176":2,"180":4}}],["log",{"2":{"175":2}}],["loudly",{"2":{"153":1}}],["location",{"2":{"64":1,"116":6}}],["locally",{"2":{"158":2}}],["local",{"2":{"53":3,"56":1,"64":4,"71":1,"76":1,"146":1}}],["loose",{"2":{"161":1}}],["lookup",{"2":{"146":1,"153":1}}],["looks",{"2":{"62":1}}],["look",{"2":{"55":2,"146":2,"162":1,"175":1}}],["looping",{"2":{"146":1}}],["loop",{"2":{"53":1,"60":2,"63":3,"64":8,"69":1,"73":1,"76":1,"116":5,"146":3,"182":1}}],["lower",{"2":{"6":1,"7":1,"146":1,"198":1}}],["lon",{"2":{"6":2,"175":1,"176":2}}],["longitude",{"2":{"158":3,"192":2}}],["long",{"2":{"6":1,"73":1,"176":1,"199":1}}],["longer",{"2":{"6":3,"174":1,"176":2,"177":1}}],["lots",{"2":{"192":1}}],["lot",{"2":{"6":1,"23":1,"53":1,"56":1,"63":1,"69":1,"85":1,"88":1,"122":1,"148":1,"175":1,"187":2}}],["load",{"2":{"153":1,"154":1,"180":1,"190":2}}],["loading",{"2":{"57":1,"173":1,"176":1}}],["loads",{"2":{"5":1,"6":1,"60":1}}],["loaded",{"2":{"1":1,"57":3,"172":1,"173":2,"176":2}}],["laptop",{"2":{"199":1}}],["land",{"2":{"192":8}}],["lazily",{"2":{"156":2}}],["layers",{"2":{"151":1}}],["label",{"2":{"14":4,"15":2,"79":2,"81":1,"84":1,"146":3,"175":2,"179":2,"180":2}}],["labels",{"2":{"13":2,"146":1}}],["latitude",{"2":{"158":3,"192":2}}],["later",{"2":{"56":1,"81":1,"146":1}}],["lat",{"2":{"6":3,"175":1,"176":3}}],["larger",{"2":{"64":1,"75":1,"184":1}}],["large",{"2":{"6":8,"60":1,"180":2,"195":1,"199":1}}],["lastindex",{"2":{"184":1}}],["last",{"2":{"4":3,"6":3,"9":1,"53":11,"56":2,"59":2,"64":9,"69":4,"85":7,"88":5,"116":20,"127":1,"146":6,"162":1,"169":2,"182":1}}],["lt",{"2":{"6":6,"73":4,"175":1}}],["len",{"2":{"182":7}}],["length",{"2":{"0":1,"5":1,"6":5,"9":1,"18":1,"60":32,"61":1,"62":1,"63":22,"64":11,"67":2,"69":1,"70":2,"72":1,"73":1,"75":1,"76":1,"116":1,"146":16,"153":2,"154":1,"169":2,"175":1,"181":1,"182":1,"183":1,"184":7}}],["legend",{"2":{"180":4}}],["le",{"2":{"116":10}}],["leaving",{"2":{"162":1}}],["leaf",{"2":{"153":1,"156":3}}],["leading",{"2":{"191":1}}],["lead",{"2":{"73":1,"162":1}}],["least",{"2":{"3":4,"6":4,"64":1,"73":1,"76":2,"116":14,"122":6,"125":1,"128":3,"129":2,"130":2,"131":1,"132":1,"135":1,"141":1,"145":1}}],["leftjoin",{"2":{"197":1}}],["leftover",{"2":{"64":1}}],["left=1",{"2":{"64":1}}],["left",{"2":{"60":1,"64":5,"145":1,"146":2,"182":17,"184":5}}],["lets",{"2":{"56":1}}],["let",{"2":{"55":1,"62":1,"116":1,"146":3,"175":1,"191":6,"192":4,"193":3,"194":2,"195":2,"200":1}}],["levels",{"2":{"146":1,"151":1,"159":1}}],["level",{"2":{"6":1,"7":1,"9":1,"18":2,"20":1,"29":1,"151":1,"153":2,"161":1,"163":1,"165":4,"166":1,"167":1,"169":2,"193":2}}],["less",{"2":{"3":1,"6":7,"53":1,"56":1,"60":1,"63":1,"69":1,"85":1,"88":1,"105":1,"122":1,"146":1,"180":1,"181":1}}],["l289",{"2":{"6":1}}],["l2",{"2":{"3":4,"4":4,"6":8,"87":4,"88":12,"100":8,"104":2,"107":5,"121":4,"124":3,"125":2,"134":8}}],["l195",{"2":{"6":1}}],["l177",{"2":{"6":1}}],["l1",{"2":{"3":6,"4":4,"6":10,"87":4,"88":12,"90":4,"91":2,"100":8,"103":4,"104":2,"107":5,"121":4,"124":3,"125":2,"134":8}}],["li",{"2":{"146":2}}],["lie",{"2":{"73":1}}],["lies",{"2":{"64":3,"158":1,"198":1}}],["limitations",{"2":{"73":1}}],["limits",{"2":{"59":1}}],["limited",{"2":{"6":1,"174":1,"177":1}}],["library",{"2":{"67":1,"195":1}}],["libraries",{"2":{"56":1,"167":1,"195":1}}],["libgeos",{"2":{"6":2,"13":1,"14":1,"15":1,"23":1,"32":2,"56":1,"57":5,"81":1,"147":1,"176":7,"180":4,"187":2}}],["little",{"2":{"26":1}}],["literate",{"2":{"26":1,"31":1,"32":1,"50":1,"53":1,"56":1,"57":1,"60":1,"63":1,"64":1,"67":1,"69":1,"71":1,"73":1,"74":1,"76":1,"82":1,"85":1,"88":1,"98":1,"101":1,"104":1,"105":1,"115":1,"116":1,"119":1,"122":1,"132":1,"142":1,"145":1,"146":1,"147":1,"153":1,"154":1,"155":1,"156":1,"160":1,"163":1,"166":1,"169":1,"170":1,"171":1,"173":1,"177":1,"184":1,"185":1,"187":1,"188":1,"189":1}}],["lift",{"2":{"14":2}}],["lin",{"2":{"176":5}}],["linked",{"2":{"77":1}}],["linrange",{"2":{"13":2,"14":5,"59":2,"84":1,"146":2,"176":1,"180":2}}],["linering",{"2":{"192":1}}],["linewidth",{"2":{"55":1,"191":1}}],["linesegment",{"2":{"145":2,"177":1}}],["lines",{"0":{"94":1,"111":1,"128":1,"138":1},"2":{"3":1,"4":4,"6":5,"64":3,"66":1,"73":9,"79":1,"80":2,"81":2,"84":1,"87":4,"88":4,"90":1,"91":1,"100":3,"103":2,"105":1,"107":3,"116":2,"118":3,"121":4,"122":2,"124":4,"134":3,"135":1,"146":3,"178":1,"191":4,"196":2}}],["linestrings",{"2":{"4":2,"6":2,"9":1,"88":2,"144":1,"161":1,"191":1}}],["linestringtrait",{"2":{"3":2,"4":4,"6":7,"11":3,"32":1,"53":1,"63":4,"72":2,"85":2,"88":8,"93":1,"94":4,"95":1,"105":6,"110":1,"111":5,"122":4,"127":1,"128":4,"129":1,"137":1,"138":4,"139":1,"151":1,"159":2,"165":2,"166":1,"177":2}}],["linestring",{"2":{"3":5,"4":6,"6":15,"18":1,"20":1,"53":2,"63":2,"85":4,"87":2,"88":2,"93":1,"94":3,"100":2,"101":1,"104":2,"107":2,"108":1,"110":1,"111":4,"116":2,"121":2,"127":1,"128":3,"129":1,"134":2,"135":1,"137":1,"138":4,"139":1,"145":7,"153":2,"154":2,"189":3,"191":5,"196":1}}],["linetrait",{"2":{"3":2,"4":4,"6":6,"53":1,"64":2,"67":2,"72":2,"85":2,"88":8,"93":1,"94":4,"95":1,"110":1,"111":5,"122":4,"127":1,"128":4,"129":1,"137":1,"138":4,"139":1}}],["line2",{"2":{"3":3,"6":7,"72":2,"73":2,"105":5,"118":3,"119":2,"122":3,"145":5}}],["line1",{"2":{"3":4,"6":8,"72":2,"73":2,"105":5,"118":3,"119":2,"122":5,"145":5}}],["linea",{"2":{"1":1,"6":1,"185":1}}],["linearmap",{"2":{"180":1}}],["linearalgebra",{"2":{"31":1}}],["linear",{"2":{"4":7,"6":10,"9":1,"56":2,"60":1,"62":1,"63":3,"69":1,"73":1,"85":5,"88":8,"95":1,"116":2,"128":1,"129":2,"138":1,"144":1,"153":1,"154":1,"158":1,"163":3,"175":5,"176":3,"177":4}}],["linearr",{"2":{"1":1,"6":1,"185":1}}],["linearrings",{"2":{"9":1,"112":1,"146":6,"161":1,"191":1}}],["linearringtrait",{"2":{"4":4,"6":4,"11":3,"32":1,"53":3,"56":2,"63":4,"64":4,"72":2,"85":2,"88":8,"93":1,"94":1,"95":4,"110":1,"111":2,"112":3,"127":1,"128":1,"129":4,"137":1,"138":1,"139":4,"159":2,"165":1,"177":2,"180":1}}],["linearring",{"2":{"1":10,"3":2,"4":1,"6":13,"31":1,"53":2,"63":2,"64":2,"75":2,"76":1,"82":1,"85":1,"93":1,"95":3,"110":1,"111":1,"112":2,"116":2,"122":4,"127":1,"128":1,"129":3,"137":1,"139":4,"145":1,"146":3,"150":2,"153":5,"154":2,"161":1,"162":6,"163":1,"168":13,"180":1,"185":8,"191":24,"192":6,"193":8,"198":2}}],["linearsegments",{"2":{"0":1,"6":1,"174":1,"175":1,"176":3,"177":2}}],["line",{"0":{"116":1},"2":{"0":1,"3":13,"4":9,"6":52,"23":1,"52":2,"53":7,"62":3,"63":10,"64":12,"66":6,"67":18,"69":8,"72":8,"73":67,"76":6,"85":11,"88":5,"90":2,"91":1,"93":2,"94":11,"95":8,"101":2,"103":1,"105":11,"108":2,"110":1,"111":9,"112":4,"116":141,"118":2,"119":2,"121":3,"122":12,"124":2,"125":2,"127":1,"128":10,"129":3,"135":2,"137":2,"138":10,"139":7,"145":6,"146":2,"177":1,"180":1,"181":1,"182":4,"183":1,"189":3,"191":3}}],["lineorientation",{"2":{"0":1,"6":2,"72":2}}],["lists",{"2":{"20":1,"64":3,"122":1}}],["listed",{"2":{"6":1,"53":1,"180":1}}],["list",{"2":{"6":16,"9":1,"53":20,"64":233,"67":20,"70":14,"71":8,"72":13,"73":5,"75":13,"76":1,"199":2}}],["likely",{"2":{"151":1}}],["like",{"0":{"74":1},"2":{"1":2,"6":5,"17":1,"18":2,"19":1,"20":1,"23":1,"24":1,"29":1,"56":1,"59":1,"60":1,"62":1,"69":1,"70":1,"72":1,"75":1,"82":1,"84":1,"85":1,"88":1,"148":2,"150":2,"153":1,"154":2,"159":2,"165":2,"166":1,"174":1,"175":1,"192":2}}],["iah",{"2":{"196":2}}],["image",{"2":{"146":1}}],["impossible",{"2":{"67":1,"121":1}}],["important",{"2":{"175":1}}],["import",{"2":{"1":3,"6":4,"13":2,"14":2,"15":1,"31":9,"52":1,"55":1,"57":1,"62":1,"67":1,"68":1,"70":1,"72":1,"73":1,"75":1,"84":1,"87":1,"88":1,"90":1,"91":1,"100":1,"101":1,"103":1,"104":1,"105":1,"107":1,"108":1,"118":1,"119":1,"121":1,"122":1,"124":1,"125":1,"134":1,"135":1,"145":3,"150":1,"153":2,"154":1,"173":1,"176":2,"179":2,"180":3,"185":2,"189":1,"190":5}}],["implements",{"2":{"32":1,"187":1}}],["implementing",{"2":{"6":1,"180":1}}],["implement",{"2":{"6":1,"17":1,"23":1,"53":1,"56":1,"60":1,"63":1,"69":1,"82":1,"85":1,"88":1,"91":1,"108":1,"122":1,"125":1,"135":1,"148":1,"164":1,"165":3,"166":1}}],["implementation",{"0":{"53":1,"56":1,"63":1,"67":1,"69":1,"82":1,"85":1,"88":1,"91":1,"101":1,"104":1,"108":1,"119":1,"122":1,"125":1,"135":1,"163":1,"169":1,"177":1},"2":{"6":1,"53":3,"56":3,"60":1,"63":3,"69":3,"75":1,"85":3,"88":3,"91":2,"101":1,"104":1,"108":2,"119":1,"122":3,"125":2,"135":2,"146":2,"147":1,"153":1,"154":1,"172":1,"177":1,"180":1,"187":1}}],["implementations",{"2":{"6":1,"91":1,"108":1,"125":1,"135":1,"147":1,"178":1,"187":3}}],["implemented",{"0":{"147":1},"2":{"1":1,"6":2,"31":1,"56":1,"60":3,"67":2,"71":2,"73":2,"76":2,"82":1,"85":2,"147":1,"148":2,"154":1,"165":2,"172":1,"178":1}}],["improvements",{"2":{"9":2,"10":1}}],["improve",{"2":{"4":1,"6":1,"170":1}}],["i=2",{"2":{"145":1}}],["ipoints",{"2":{"116":4}}],["ip",{"2":{"88":2}}],["ipt",{"2":{"64":8}}],["ihole",{"2":{"88":2}}],["ih",{"2":{"76":22}}],["i2",{"2":{"69":2}}],["i1",{"2":{"69":2}}],["ii",{"2":{"64":8}}],["i+1",{"2":{"60":8,"146":1,"182":2,"184":1}}],["io",{"2":{"57":5,"173":5,"176":5}}],["i",{"2":{"9":1,"13":4,"22":1,"53":14,"56":1,"60":16,"64":28,"69":4,"71":2,"75":2,"76":4,"85":2,"88":8,"105":7,"116":28,"145":14,"146":17,"153":8,"154":8,"177":2,"181":3,"182":12,"184":28,"189":2,"191":2,"192":1,"199":3}}],["id",{"2":{"194":1}}],["identical",{"2":{"153":1,"168":1}}],["identity",{"2":{"146":4,"156":2,"170":1}}],["ideal",{"2":{"146":1}}],["idea",{"2":{"6":1,"20":1,"25":1,"27":1,"60":1,"148":1,"154":1}}],["idx`",{"2":{"64":1}}],["idx",{"2":{"53":6,"64":167,"67":23,"69":9,"70":5,"72":5,"75":2,"169":34,"182":51}}],["id=",{"2":{"6":2}}],["ignored",{"2":{"6":1,"146":1}}],["ignore",{"2":{"6":1,"146":2}}],["innerjoin",{"2":{"197":1,"198":1,"199":1}}],["inner",{"2":{"116":6,"153":5}}],["in=1",{"2":{"116":1}}],["in`",{"2":{"116":1}}],["inject",{"0":{"74":1},"2":{"173":1}}],["inaccuracies",{"2":{"73":1}}],["ind",{"2":{"199":2}}],["individual",{"2":{"193":1}}],["indicate",{"2":{"156":1}}],["indicates",{"2":{"20":1}}],["indices",{"2":{"64":4,"153":2,"154":2,"184":16}}],["indeed",{"2":{"162":1}}],["index",{"2":{"60":8,"64":11,"116":1,"153":1,"182":1}}],["inds",{"2":{"146":3}}],["inplace",{"2":{"60":1}}],["inputs",{"2":{"6":1,"64":1,"88":1,"101":1,"104":1,"119":1,"184":1}}],["input",{"2":{"6":11,"53":1,"67":1,"70":1,"72":1,"73":1,"75":1,"146":1,"148":1,"154":1,"176":3,"177":1,"181":1,"182":1,"183":1,"192":1}}],["inbounds",{"2":{"60":16,"85":5,"116":1}}],["inspiration",{"2":{"67":1}}],["inspired",{"2":{"66":1,"67":2}}],["inside",{"2":{"53":3,"62":1,"64":3,"69":1,"70":1,"71":1,"72":1,"73":1,"75":1,"76":2,"84":3,"85":1,"93":1,"116":1,"134":1,"137":1,"146":2}}],["insertion",{"2":{"64":1}}],["insert",{"2":{"53":1,"182":1}}],["instability",{"2":{"24":2}}],["instantiating",{"2":{"20":1}}],["instead",{"2":{"18":1,"24":1,"154":1,"177":1}}],["instructs",{"2":{"6":1,"187":2}}],["inline",{"2":{"32":1,"116":4,"145":1,"153":12,"154":10,"160":2}}],["init=nothing",{"2":{"154":1}}],["init=typemax",{"2":{"85":2}}],["init=zero",{"2":{"56":1,"69":1}}],["initial",{"2":{"73":2,"176":1}}],["initially",{"2":{"64":1}}],["initialize",{"2":{"60":3,"63":2,"64":1,"73":1}}],["init",{"2":{"19":1,"31":1,"53":1,"63":2,"154":30,"176":4}}],["incorrect",{"2":{"161":1,"162":1}}],["increase",{"2":{"64":1,"116":1}}],["increasing",{"2":{"6":1,"180":1}}],["increment",{"2":{"60":5}}],["including",{"2":{"53":1,"64":2,"73":1,"85":1,"93":1,"94":1,"95":1,"96":1,"116":2}}],["include",{"2":{"31":41,"53":1,"64":1,"77":1,"85":2,"160":1,"180":2,"193":2,"194":1}}],["included",{"2":{"6":2,"76":2,"166":2,"169":2,"193":1}}],["includes",{"2":{"4":2,"6":2,"76":1,"85":2,"88":1,"116":1}}],["incircle",{"0":{"16":1}}],["inv",{"2":{"158":3}}],["investigate",{"2":{"146":1}}],["investigating",{"0":{"81":1}}],["inverted",{"2":{"6":1,"82":1}}],["invalid",{"2":{"20":1,"71":2,"162":1,"167":1,"168":1}}],["invoke",{"2":{"20":1}}],["involved",{"2":{"148":1}}],["involve",{"2":{"20":1}}],["involving",{"2":{"6":3,"70":1,"72":1,"75":1}}],["invocation",{"2":{"18":1}}],["ing",{"2":{"1":1,"6":2,"60":1,"185":1}}],["intr",{"2":{"64":28,"67":16,"69":9,"73":8}}],["intr2",{"2":{"64":2,"73":14}}],["intr1",{"2":{"64":3,"73":21,"116":2}}],["intrs",{"2":{"64":10,"73":5}}],["introduction",{"0":{"27":1},"1":{"28":1,"29":1,"30":1}}],["introducing",{"2":{"24":1}}],["introduces",{"2":{"24":1}}],["int",{"2":{"64":6,"76":7,"105":7,"177":1,"180":1,"182":5,"183":1,"184":1}}],["integrate",{"2":{"56":1}}],["integrating",{"2":{"56":1}}],["integrals",{"2":{"55":1}}],["integral",{"2":{"55":1}}],["intended",{"2":{"6":1,"165":2,"166":1}}],["intermediate",{"2":{"69":1}}],["inter2",{"2":{"69":15}}],["inter1",{"2":{"69":23}}],["interpreted",{"2":{"60":1}}],["interpolation",{"2":{"5":1,"6":1,"59":1,"60":2,"174":1}}],["interpolated",{"2":{"5":3,"6":3,"60":17,"174":1}}],["interpolate",{"2":{"0":2,"5":2,"6":4,"58":1,"59":2,"60":25}}],["interest",{"2":{"60":1,"85":1}}],["internal",{"2":{"59":1}}],["internals",{"2":{"24":1}}],["inter",{"2":{"6":3,"64":21,"67":1,"70":1,"72":5,"73":4}}],["interface",{"0":{"165":1},"2":{"6":3,"20":1,"77":1,"82":1,"153":1,"164":1,"165":4,"166":1,"180":1,"192":1}}],["interacted",{"2":{"116":1}}],["interaction",{"0":{"116":1},"2":{"116":2}}],["interactions",{"2":{"64":1,"76":3,"116":15}}],["interactive",{"2":{"13":1,"14":1}}],["interacting",{"2":{"6":1,"72":1,"116":2}}],["interacts",{"2":{"3":1,"6":1,"116":3,"124":1,"125":1,"128":3,"129":1,"130":1}}],["interact",{"2":{"3":2,"6":2,"75":1,"76":1,"107":1,"116":5,"119":1,"124":1,"125":1,"127":1,"128":2,"129":2,"130":1}}],["interior",{"2":{"3":6,"6":7,"53":9,"55":1,"60":7,"63":5,"64":1,"76":18,"90":1,"91":3,"94":5,"95":1,"96":2,"100":1,"101":1,"103":2,"104":1,"105":1,"108":2,"110":2,"111":6,"112":3,"116":15,"124":1,"125":3,"128":1,"129":2,"130":2,"134":1,"135":3,"140":2,"145":2,"163":1,"166":1}}],["interiors",{"2":{"3":6,"6":7,"60":20,"90":1,"100":1,"101":1,"103":1,"104":1,"107":1,"108":1,"113":1,"116":5,"118":1,"119":1,"124":1,"125":1,"127":1,"128":2,"129":1,"134":1,"135":1,"138":3,"139":3}}],["intersectingpolygons",{"2":{"6":3}}],["intersecting",{"0":{"167":1},"1":{"168":1,"169":1},"2":{"6":4,"31":1,"64":2,"76":2,"166":4,"167":1,"169":4}}],["intersections",{"0":{"73":1},"2":{"64":2,"69":2,"71":1,"72":2,"73":1,"76":1,"116":2}}],["intersection",{"0":{"37":1,"72":1,"117":1},"1":{"118":1,"119":1},"2":{"0":2,"3":3,"6":19,"9":1,"15":4,"23":1,"31":1,"37":2,"64":38,"67":3,"69":6,"70":4,"71":4,"72":15,"73":73,"75":2,"76":2,"105":2,"116":6,"118":1,"122":5}}],["intersect",{"2":{"3":8,"6":11,"64":4,"69":3,"70":2,"72":1,"73":1,"75":1,"76":5,"90":1,"91":1,"100":1,"101":2,"104":1,"108":1,"111":1,"113":1,"116":4,"118":2,"122":1,"134":1,"135":2,"138":3,"139":3,"168":1,"169":4}}],["intersects",{"0":{"49":1,"118":1},"2":{"0":2,"3":3,"6":6,"31":1,"49":2,"64":1,"73":2,"76":2,"105":2,"117":1,"118":4,"119":4,"122":5,"140":1,"169":2,"197":1}}],["into",{"2":{"5":1,"6":5,"17":1,"26":1,"53":1,"56":1,"60":1,"63":4,"64":2,"67":1,"70":1,"72":1,"116":1,"146":4,"153":3,"154":2,"155":1,"156":2,"159":1,"169":1,"180":1,"189":2,"191":2,"197":1}}],["int64",{"2":{"1":6,"6":6,"162":6,"181":1,"182":1,"184":1,"185":6,"191":14}}],["influence",{"2":{"158":1}}],["infinity",{"2":{"116":1,"122":1}}],["info",{"2":{"6":2,"174":1}}],["information",{"0":{"193":1},"2":{"6":1,"29":1,"60":1,"64":2,"68":1,"73":1,"82":1,"116":1,"190":1,"193":3,"195":2}}],["inf",{"2":{"1":1,"9":1,"67":2,"181":1,"184":3}}],["in",{"0":{"23":1},"2":{"1":6,"3":3,"4":1,"5":4,"6":45,"7":1,"9":2,"13":6,"14":2,"17":2,"18":4,"20":1,"23":3,"24":2,"25":1,"26":3,"27":1,"29":1,"30":1,"31":2,"32":1,"33":1,"53":7,"55":1,"56":3,"57":1,"58":2,"60":22,"62":2,"63":5,"64":72,"67":6,"69":31,"70":9,"71":3,"72":5,"73":29,"75":11,"76":28,"81":1,"82":3,"84":6,"85":6,"87":1,"88":17,"91":10,"94":1,"95":1,"96":1,"97":1,"98":1,"100":2,"101":1,"104":1,"105":7,"108":9,"110":1,"111":1,"112":1,"114":1,"115":1,"116":135,"118":2,"119":1,"121":1,"122":11,"124":1,"125":11,"129":1,"131":1,"132":1,"134":1,"135":10,"138":3,"139":3,"141":1,"142":1,"145":4,"146":10,"147":3,"148":1,"150":2,"151":2,"152":1,"153":8,"154":4,"156":8,"157":1,"158":5,"159":1,"160":1,"164":1,"165":1,"166":2,"167":1,"169":7,"170":1,"171":2,"172":3,"173":1,"174":2,"175":2,"176":14,"177":8,"178":1,"180":5,"181":2,"182":4,"183":1,"184":5,"185":2,"186":4,"187":4,"188":1,"189":8,"190":1,"191":2,"192":6,"195":2,"197":4,"198":3,"199":1,"200":1}}],["itererable",{"2":{"189":1}}],["iter",{"2":{"156":31}}],["iterator",{"2":{"64":4,"72":2,"156":4}}],["iterators",{"2":{"13":1,"60":1,"64":5,"69":3,"72":1,"76":2,"146":1,"153":2,"154":3,"156":8,"169":6,"177":1}}],["iterate",{"2":{"60":2,"151":1,"153":1,"156":4}}],["iteration",{"2":{"56":1}}],["iterabletype",{"2":{"153":5,"154":6}}],["iterable",{"2":{"4":1,"6":2,"18":1,"56":1,"69":1,"82":1,"153":17,"154":15,"156":11,"191":1}}],["iterables",{"2":{"1":2,"22":1,"150":2,"153":1,"154":2,"156":3}}],["ith",{"2":{"64":3,"76":7}}],["itself",{"2":{"69":1,"145":1,"151":1}}],["its",{"2":{"5":1,"6":9,"18":1,"55":1,"60":1,"64":2,"69":4,"76":1,"94":1,"156":2,"164":1,"180":1,"181":1,"182":1,"183":3,"197":1}}],["it",{"2":{"1":4,"4":1,"6":14,"9":1,"18":11,"19":2,"20":1,"22":1,"29":3,"30":1,"52":1,"53":1,"55":2,"56":3,"57":1,"59":1,"63":2,"64":2,"68":1,"69":2,"70":1,"71":1,"72":1,"73":4,"75":1,"76":3,"81":2,"82":2,"85":3,"88":1,"90":2,"93":3,"110":3,"116":14,"121":1,"122":1,"127":2,"137":3,"144":1,"145":2,"146":4,"148":3,"150":1,"151":3,"152":1,"153":8,"154":5,"156":8,"158":1,"159":2,"160":2,"162":1,"163":1,"164":1,"166":1,"167":1,"172":5,"175":2,"176":1,"177":1,"180":1,"182":1,"186":1,"187":7,"192":3,"193":3,"195":3,"199":2,"200":2}}],["iff",{"2":{"153":1}}],["if",{"0":{"74":1},"2":{"1":5,"3":17,"4":19,"5":1,"6":68,"18":1,"22":2,"32":1,"52":1,"53":15,"55":1,"56":6,"57":3,"60":5,"63":1,"64":95,"67":8,"69":36,"70":13,"71":12,"72":9,"73":44,"75":10,"76":22,"82":3,"84":2,"85":8,"87":2,"88":35,"90":1,"91":2,"93":4,"94":3,"95":3,"96":2,"97":1,"98":1,"100":1,"101":1,"103":1,"104":1,"105":9,"107":1,"108":3,"110":5,"111":4,"112":2,"113":2,"114":1,"115":1,"116":132,"118":1,"119":1,"121":4,"122":16,"124":1,"125":2,"127":4,"128":3,"129":2,"130":2,"131":1,"132":1,"134":1,"135":2,"137":5,"138":3,"139":3,"140":1,"141":1,"142":1,"145":5,"146":35,"150":3,"151":1,"153":19,"154":6,"156":9,"160":1,"163":1,"165":1,"166":2,"167":1,"169":12,"170":1,"171":1,"172":3,"173":2,"176":6,"177":1,"180":1,"182":12,"184":12,"185":1,"187":2,"188":1,"192":1,"195":1,"198":2,"199":1}}],["isolate",{"2":{"180":1}}],["isodd",{"2":{"67":1}}],["istable",{"2":{"153":1,"154":1,"156":1}}],["isequal",{"2":{"146":1}}],["iseven",{"2":{"116":1}}],["isempty",{"2":{"56":1,"60":4,"69":1,"70":1,"71":2,"72":1,"146":1,"165":1,"182":1}}],["isparallel",{"2":{"116":1,"145":8}}],["is3d",{"2":{"88":1,"156":1,"171":1,"185":1,"188":1,"189":10}}],["issue",{"2":{"64":1}}],["issues",{"2":{"25":1,"27":1}}],["isa",{"2":{"18":1,"60":9,"153":3,"154":1,"177":2,"189":1}}],["isnothing",{"2":{"57":1,"64":9,"67":1,"71":2,"73":2,"76":2,"88":1,"146":1,"173":1,"176":1,"180":1,"181":1,"182":5,"183":1,"184":6}}],["isn",{"2":{"6":1,"56":1,"64":4,"67":1,"69":1,"71":1,"73":3,"76":2,"85":3,"88":1,"90":1,"116":9,"122":1,"180":1,"187":1}}],["isconcave",{"0":{"145":1},"2":{"0":1,"6":2,"81":1,"143":1,"145":3}}],["isclockwise",{"0":{"144":1},"2":{"0":1,"6":2,"69":1,"143":1,"145":5,"146":2}}],["is",{"0":{"25":1,"52":1,"55":2,"62":1,"66":1,"68":1,"84":2,"87":1,"90":1,"100":1,"103":1,"107":1,"118":1,"121":1,"124":1,"134":1,"151":1},"2":{"0":1,"1":10,"3":8,"4":43,"5":1,"6":103,"9":3,"11":1,"13":1,"14":1,"18":3,"19":1,"20":1,"22":3,"23":2,"25":2,"27":2,"52":1,"53":19,"55":7,"56":19,"57":3,"58":2,"59":2,"60":15,"62":2,"63":5,"64":82,"66":1,"67":2,"68":3,"69":22,"70":4,"71":13,"72":4,"73":40,"75":7,"76":20,"77":1,"81":5,"82":4,"84":8,"85":23,"88":13,"90":4,"91":4,"93":7,"94":3,"95":3,"96":1,"97":1,"98":1,"100":2,"101":3,"104":3,"105":3,"107":1,"108":5,"110":9,"111":4,"112":2,"113":1,"114":1,"115":1,"116":91,"119":2,"121":3,"122":12,"125":4,"127":2,"134":4,"135":5,"137":8,"138":3,"139":3,"140":1,"141":2,"142":1,"144":2,"145":7,"146":11,"147":1,"148":3,"150":3,"151":3,"152":1,"153":18,"154":4,"156":7,"158":11,"159":1,"160":1,"161":7,"162":2,"163":1,"164":3,"165":2,"166":1,"167":4,"168":1,"169":2,"171":1,"172":7,"173":2,"174":3,"175":3,"176":9,"177":8,"179":1,"180":4,"181":1,"182":2,"183":1,"185":2,"186":1,"187":3,"191":4,"192":5,"193":3,"194":1,"195":3,"197":2,"198":5,"199":2}}],["cpu",{"2":{"199":1}}],["cp",{"2":{"196":1}}],["circumstances",{"2":{"158":2}}],["cy",{"2":{"145":2}}],["cyan",{"2":{"57":1,"173":1,"176":1}}],["cx",{"2":{"145":2}}],["cdot",{"2":{"145":1}}],["cs",{"2":{"116":9}}],["cshape",{"2":{"62":3}}],["cw",{"2":{"69":2}}],["cb",{"2":{"59":1,"81":1,"146":1}}],["cgrad",{"2":{"59":1}}],["cgal",{"2":{"59":1}}],["c",{"2":{"32":1,"56":1,"62":1,"67":5,"69":4,"74":3,"116":24,"176":1}}],["cleaner",{"2":{"82":1}}],["cleanest",{"2":{"82":1}}],["clear",{"2":{"68":1}}],["clearly",{"2":{"52":1,"55":1,"84":1}}],["clamped",{"2":{"73":18}}],["clamp",{"2":{"53":1,"73":1}}],["classified",{"2":{"64":1}}],["classify",{"2":{"64":4}}],["class",{"2":{"6":1,"146":1}}],["class=",{"2":{"6":6}}],["clipping",{"0":{"64":1,"70":1,"71":1,"73":1,"75":1,"76":1},"2":{"6":1,"9":1,"31":8,"64":9,"67":3,"70":1,"72":1,"75":1,"167":1}}],["closure",{"2":{"153":2}}],["closing",{"2":{"53":1}}],["closer",{"2":{"158":1}}],["close",{"2":{"53":5,"64":2,"67":1,"69":1,"73":1,"85":9,"146":1,"162":1,"163":4}}],["closest",{"2":{"4":3,"6":3,"73":2,"84":1,"85":6,"158":1}}],["closed2",{"2":{"88":2}}],["closed1",{"2":{"88":2}}],["closed",{"0":{"161":1},"1":{"162":1,"163":1},"2":{"4":4,"6":11,"9":1,"31":1,"53":6,"56":3,"63":3,"64":1,"69":1,"73":1,"76":3,"88":21,"93":2,"94":5,"95":5,"110":2,"111":5,"112":3,"116":52,"128":5,"129":1,"137":3,"138":5,"139":5,"145":1,"146":1,"161":1,"162":1,"163":2,"164":1,"166":1,"191":1}}],["closedring",{"2":{"0":1,"6":1,"161":1,"162":1,"163":4,"164":1,"165":1,"166":1}}],["clockwise",{"2":{"4":1,"6":4,"9":1,"55":1,"56":1,"69":7,"81":1,"144":2,"145":3,"146":1}}],["ceil",{"2":{"177":1}}],["ce",{"2":{"116":11}}],["certainly",{"2":{"73":1}}],["certain",{"2":{"17":1,"18":1,"26":1,"29":1}}],["central",{"2":{"64":1}}],["centroids",{"2":{"62":1,"63":1}}],["centroid",{"0":{"61":1,"62":1},"1":{"62":1,"63":1},"2":{"0":4,"4":2,"6":6,"31":1,"61":3,"62":4,"63":38,"148":1,"154":1,"180":4}}],["cent",{"2":{"62":2}}],["centered",{"2":{"64":1}}],["center",{"2":{"6":1,"62":1,"146":1}}],["cells",{"2":{"146":1}}],["cell",{"2":{"6":4,"68":3,"69":28,"146":2}}],["children",{"2":{"180":1}}],["child",{"2":{"156":9}}],["chunks",{"2":{"153":4,"154":5}}],["chunk",{"2":{"153":6,"154":7}}],["chull",{"2":{"50":2}}],["chose",{"2":{"24":1,"146":1}}],["choose",{"2":{"6":1,"82":1,"146":2}}],["changes",{"2":{"64":1}}],["changed",{"2":{"64":1}}],["change",{"2":{"24":1,"64":1,"81":1}}],["chain=2",{"2":{"64":1}}],["chain=1",{"2":{"64":1}}],["chain",{"2":{"64":66,"71":3,"73":4,"76":4,"81":2}}],["chains",{"2":{"20":1,"64":1}}],["chairmarks",{"2":{"13":1,"176":1,"180":1}}],["checkargs",{"2":{"181":1,"182":1,"183":1,"184":1}}],["checking",{"2":{"88":1,"182":1}}],["checks",{"0":{"105":1,"117":1},"1":{"118":1,"119":1},"2":{"57":1,"64":1,"73":1,"87":1,"90":1,"100":1,"103":1,"107":1,"116":5,"118":1,"121":1,"122":1,"124":1,"134":1,"198":1}}],["check",{"2":{"4":1,"6":1,"7":1,"63":1,"64":8,"67":1,"69":3,"70":1,"73":4,"74":1,"75":1,"88":8,"116":11,"146":5,"153":1,"168":1,"170":1,"175":2,"182":1,"184":1}}],["checked",{"2":{"4":1,"6":1,"64":1,"73":1,"81":1,"116":1,"170":1}}],["c2",{"2":{"6":3,"15":2,"85":3,"88":14,"146":21}}],["c1",{"2":{"6":3,"15":2,"85":4,"88":13,"146":26}}],["ctor",{"2":{"1":1,"6":1,"185":1}}],["categorize",{"2":{"67":1}}],["categorical",{"2":{"59":1}}],["came",{"2":{"67":1}}],["case",{"2":{"53":1,"58":2,"63":1,"64":1,"70":1,"73":2,"76":1,"116":16,"154":1,"177":1,"200":1}}],["cases",{"2":{"6":1,"60":1,"67":2,"116":3,"151":1,"153":1,"154":1,"156":3}}],["cause",{"2":{"18":1,"23":1,"182":1}}],["careful",{"2":{"60":1,"151":1}}],["care",{"2":{"17":1,"153":1,"158":1}}],["carried",{"2":{"6":1,"187":1}}],["cairomakie",{"2":{"13":1,"52":1,"55":1,"59":2,"62":1,"66":1,"68":1,"79":1,"80":1,"81":1,"84":1,"87":1,"90":1,"100":1,"103":1,"107":1,"118":1,"121":1,"124":1,"134":1,"175":1,"176":1,"180":1,"190":1,"196":1,"198":1,"199":1}}],["california",{"2":{"199":1}}],["callable",{"2":{"146":4,"165":1}}],["calls",{"2":{"64":1,"73":1,"76":1,"85":1,"91":1,"108":1,"125":1,"135":1,"151":1,"153":1,"177":1}}],["calling",{"2":{"33":1,"64":2,"153":1}}],["call",{"2":{"18":1,"24":1,"56":1,"63":1,"153":4,"178":1}}],["called",{"2":{"6":2,"63":3,"64":1,"153":1,"163":1,"165":1,"166":1,"187":1,"192":1}}],["calculation",{"2":{"73":1}}],["calculations",{"2":{"6":1,"25":2,"27":2,"73":1,"158":2,"176":1}}],["calculating",{"2":{"4":1,"6":1,"18":1,"64":1,"170":1}}],["calculated",{"2":{"6":1,"62":2,"69":1,"73":2,"85":1,"153":4}}],["calculates",{"2":{"4":2,"6":6,"56":1,"60":2,"69":1,"73":2,"75":1,"85":2,"176":1,"183":1}}],["calculate",{"2":{"1":2,"5":1,"6":5,"11":1,"53":3,"60":3,"63":1,"69":1,"73":1,"116":1,"146":1,"150":1,"153":3,"155":1}}],["calc",{"2":{"1":2,"6":3,"24":1,"31":1,"32":1,"35":2,"36":2,"37":2,"38":2,"50":1,"53":4,"150":1,"152":1,"153":19,"155":1,"160":1,"170":1,"180":2}}],["cache",{"2":{"6":1,"60":1}}],["cant",{"2":{"88":1,"146":1,"189":1}}],["cannot",{"2":{"3":3,"4":2,"6":5,"56":1,"88":1,"93":1,"96":1,"122":2,"125":1,"127":2,"129":1,"140":1}}],["can",{"2":{"1":1,"4":2,"6":14,"7":2,"9":1,"13":1,"14":1,"24":1,"26":1,"31":1,"53":1,"56":1,"57":1,"58":2,"59":1,"60":3,"63":1,"64":3,"69":1,"70":3,"72":3,"73":1,"75":3,"76":1,"81":1,"82":2,"87":1,"88":3,"90":1,"100":1,"105":1,"107":1,"116":23,"118":2,"121":2,"122":3,"124":1,"128":1,"129":1,"134":1,"137":1,"138":1,"139":1,"146":1,"147":1,"148":1,"150":1,"152":1,"153":8,"155":1,"156":2,"158":1,"162":2,"163":1,"166":1,"167":2,"168":1,"170":1,"173":1,"175":1,"176":2,"180":2,"187":1,"191":6,"192":1,"193":3,"195":3,"197":3,"198":3}}],["creation",{"2":{"191":1,"193":1}}],["creating",{"0":{"190":1,"191":1,"194":1},"1":{"191":1,"192":1,"193":1,"194":1,"195":1},"2":{"116":1}}],["creates",{"2":{"7":1,"64":3}}],["create",{"0":{"193":1},"2":{"6":2,"13":2,"14":1,"64":1,"67":1,"73":2,"82":1,"146":2,"153":1,"166":2,"167":3,"169":2,"190":2,"191":4,"192":5,"193":3,"194":1,"195":1,"198":1}}],["created",{"2":{"4":2,"6":2,"64":1,"85":3}}],["criteria",{"2":{"91":2,"108":2,"125":2,"135":2,"182":3}}],["cropping",{"2":{"59":2}}],["cross=1",{"2":{"72":1}}],["cross`",{"2":{"72":1}}],["crossings",{"2":{"64":3,"116":1}}],["crossing",{"0":{"105":1},"2":{"6":2,"64":81,"70":1,"71":7,"72":3,"73":7,"75":1,"76":6,"91":1,"105":1,"116":1,"135":1}}],["cross",{"0":{"132":1},"2":{"6":1,"9":1,"53":3,"64":13,"67":14,"70":2,"71":1,"72":2,"73":10,"74":4,"75":2,"76":1,"91":1,"105":2,"108":1,"116":17,"122":2,"125":1,"135":1,"145":3}}],["crosses",{"0":{"43":1},"2":{"0":2,"3":2,"6":3,"31":1,"43":2,"64":1,"67":1,"105":26,"116":2,"197":1}}],["crc",{"2":{"6":1,"60":1}}],["crs2",{"2":{"192":2}}],["crs1",{"2":{"192":2,"193":1}}],["crs=nothing",{"2":{"153":1,"170":1,"180":1}}],["crs=gi",{"2":{"153":5,"156":3}}],["crs`",{"2":{"153":1,"172":6}}],["crs",{"0":{"192":1},"2":{"1":16,"4":2,"6":8,"31":1,"32":2,"35":2,"36":2,"37":2,"38":2,"50":2,"82":1,"146":10,"150":2,"152":3,"153":36,"155":2,"156":5,"170":1,"172":7,"180":1,"190":1,"192":13,"193":7,"195":1}}],["customize",{"2":{"153":1,"154":1}}],["custom",{"0":{"200":1},"2":{"6":3,"60":1,"200":2}}],["curr^2",{"2":{"53":2}}],["curr",{"2":{"53":8,"64":116,"67":9,"76":3,"169":26}}],["currentnode",{"2":{"146":8}}],["current",{"2":{"53":1,"60":8,"64":3,"67":2,"71":1,"73":1,"76":6,"146":2,"169":3}}],["currently",{"2":{"5":1,"6":3,"23":1,"60":1,"64":1,"67":1,"71":2,"146":1,"153":1,"158":2}}],["curve",{"0":{"116":1},"2":{"3":1,"4":7,"6":18,"53":6,"56":7,"64":5,"69":3,"72":7,"84":1,"85":22,"88":6,"91":2,"93":4,"94":9,"95":9,"108":1,"110":4,"111":6,"112":3,"116":152,"122":1,"125":1,"128":6,"130":3,"135":1,"137":4,"138":6,"139":6}}],["curves",{"2":{"0":1,"3":1,"6":5,"56":3,"69":3,"73":1,"84":1,"85":1,"88":13,"96":1,"116":1,"122":1,"140":1,"180":2}}],["cutpolygon",{"2":{"66":1}}],["cuts",{"2":{"66":1}}],["cutting",{"0":{"65":1},"1":{"66":1,"67":1},"2":{"64":1,"67":2}}],["cut",{"0":{"66":1},"2":{"0":1,"6":6,"31":1,"60":1,"65":1,"66":5,"67":22,"116":1}}],["coastlines",{"2":{"196":1}}],["coarse",{"2":{"6":1,"174":1,"177":1}}],["cos",{"2":{"191":3,"192":1,"193":2}}],["copy",{"2":{"153":1,"165":1,"184":1}}],["coors1",{"2":{"145":2}}],["coors2",{"2":{"145":3}}],["coord",{"2":{"177":6}}],["coords",{"2":{"67":9,"177":8}}],["coordinatetransformations",{"2":{"1":2,"6":2,"180":1,"185":2,"190":1,"191":5,"193":2}}],["coordinate",{"0":{"60":1,"171":1,"192":1,"193":1},"2":{"1":4,"5":5,"6":7,"25":1,"27":1,"59":2,"60":10,"156":1,"172":4,"177":1,"190":3,"192":1}}],["coordinates",{"0":{"5":1,"58":1},"1":{"59":1,"60":1},"2":{"0":4,"1":1,"4":2,"5":7,"6":20,"56":2,"58":8,"60":25,"64":2,"67":2,"68":1,"70":1,"72":1,"75":1,"85":1,"88":2,"148":1,"158":2,"171":2,"172":1,"175":1,"176":3,"192":2}}],["co",{"2":{"116":2}}],["core",{"2":{"157":1}}],["corner",{"2":{"69":4,"146":1}}],["corners",{"2":{"69":1}}],["correspondent",{"2":{"145":1}}],["correspond",{"2":{"64":1}}],["corresponding",{"2":{"53":3,"71":2}}],["corrected",{"2":{"165":1}}],["correctness",{"2":{"161":1,"187":1}}],["correctly",{"2":{"153":1,"175":1}}],["correcting",{"2":{"20":1,"165":1}}],["corrections",{"0":{"164":1,"166":1},"1":{"165":1,"166":1},"2":{"162":1,"165":6,"168":1}}],["correction",{"2":{"6":10,"31":4,"70":1,"71":2,"72":1,"73":2,"75":1,"76":2,"161":1,"163":2,"164":2,"165":8,"166":7,"167":1,"169":2}}],["correct",{"2":{"6":3,"24":1,"53":1,"56":1,"63":1,"64":1,"69":1,"70":1,"72":1,"75":1,"85":1,"88":1,"91":1,"108":1,"122":1,"125":1,"135":1,"161":1,"162":2,"164":1}}],["cov",{"2":{"69":16}}],["cover",{"2":{"93":1,"97":1}}],["covering",{"2":{"6":2,"103":1,"166":2,"169":2}}],["covered",{"0":{"95":1,"96":1,"139":1},"2":{"3":1,"6":1,"71":1,"76":1,"90":1,"91":1,"95":2,"96":2,"97":1,"98":2,"103":1,"115":2,"116":3,"169":1}}],["coveredby",{"0":{"48":1,"89":1,"90":1,"93":1,"94":1,"97":1,"98":1,"115":1},"1":{"90":1,"91":1},"2":{"0":2,"3":4,"6":4,"31":1,"48":2,"64":1,"89":1,"90":3,"91":10,"92":6,"93":13,"94":15,"95":13,"96":5,"97":2,"98":2,"104":3,"197":1}}],["covers",{"0":{"47":1,"102":1,"103":1},"1":{"103":1,"104":1},"2":{"0":2,"3":5,"6":5,"31":1,"47":2,"102":1,"103":4,"104":5,"146":1,"197":1}}],["coverages",{"2":{"6":1,"69":1}}],["coverage",{"0":{"68":1},"2":{"0":1,"6":2,"31":1,"68":3,"69":16}}],["code",{"2":{"7":1,"10":1,"26":5,"60":1,"91":1,"108":1,"116":1,"125":1,"135":1,"145":1,"160":1,"186":1,"199":1}}],["colatitude",{"2":{"158":1}}],["colname",{"2":{"153":3}}],["col",{"2":{"153":2,"154":1}}],["columns",{"2":{"153":2}}],["column",{"2":{"22":1,"153":9,"154":8,"156":2,"194":2,"197":8}}],["colored",{"2":{"198":1}}],["color=",{"2":{"192":2}}],["colors",{"2":{"79":1,"80":1,"196":1,"198":2}}],["colorrange",{"2":{"59":2,"84":1}}],["colorbar",{"2":{"59":1,"81":1,"84":1,"146":1}}],["colormap",{"2":{"14":1,"59":3,"84":1}}],["color",{"2":{"6":1,"55":1,"57":1,"59":2,"60":1,"62":1,"66":3,"79":1,"80":1,"81":2,"84":2,"87":4,"90":1,"100":4,"103":1,"107":4,"121":4,"134":4,"173":1,"176":1,"191":1,"192":1,"196":1,"198":5}}],["collect",{"2":{"11":3,"13":1,"50":1,"52":1,"55":2,"60":1,"62":1,"66":2,"68":2,"82":2,"84":1,"146":3,"153":2,"154":1,"175":4,"189":2}}],["collections",{"0":{"97":1,"98":1,"114":1,"115":1,"131":1,"132":1,"141":1,"142":1},"2":{"1":2,"6":8,"22":1,"150":2,"152":1,"153":2,"154":2,"156":3,"180":2,"195":1}}],["collection",{"2":{"1":1,"4":7,"6":12,"18":2,"29":2,"53":2,"56":3,"69":2,"85":2,"97":2,"98":2,"114":2,"115":2,"131":2,"132":2,"141":2,"142":2,"148":1,"150":1,"153":3,"154":1,"180":1,"188":1,"189":1}}],["collinear",{"2":{"3":1,"6":2,"64":5,"70":2,"72":3,"73":12,"75":2,"121":1,"122":2}}],["come",{"2":{"158":1}}],["commonly",{"2":{"195":1}}],["common",{"2":{"87":1,"155":1,"177":1,"190":1,"192":1,"193":1}}],["commented",{"2":{"145":1}}],["comments",{"2":{"116":1}}],["comment",{"2":{"30":1}}],["combos",{"2":{"71":1,"73":1,"76":1}}],["combination",{"2":{"64":1,"156":2}}],["combines",{"2":{"63":1}}],["combine",{"2":{"63":2,"64":5,"169":1}}],["combined",{"2":{"6":1,"64":4,"76":1,"166":1,"169":2,"191":1}}],["coming",{"2":{"69":1}}],["com",{"2":{"6":2,"73":1,"82":1,"158":1}}],["compilation",{"2":{"160":1}}],["compiled",{"2":{"24":1}}],["compiler",{"2":{"24":1,"153":2,"160":2}}],["complex",{"2":{"148":1,"180":1,"197":1}}],["complexity",{"2":{"148":1}}],["complete",{"2":{"56":1}}],["completely",{"2":{"1":1,"3":4,"6":4,"64":2,"71":1,"76":1,"91":1,"100":2,"101":1,"103":1,"104":1,"116":1,"135":1,"150":1,"153":1,"158":1}}],["components",{"2":{"62":1,"63":2,"154":1,"156":25}}],["component",{"2":{"56":3,"63":11,"69":8,"73":1,"153":2,"156":2}}],["composed",{"2":{"4":4,"6":5,"88":5,"191":2}}],["comprised",{"2":{"6":3,"70":1,"72":1,"75":1}}],["computing",{"2":{"57":1,"77":1}}],["computational",{"2":{"6":1,"60":1}}],["computation",{"2":{"6":6,"60":1,"63":1,"70":1,"72":1,"75":1,"181":2,"182":2,"183":2}}],["computer",{"2":{"6":1,"60":1}}],["computes",{"2":{"6":1,"82":1}}],["compute",{"2":{"4":1,"6":3,"56":1,"60":1,"82":3,"177":1}}],["computed",{"2":{"4":4,"6":5,"53":1,"56":3,"60":3,"69":1,"196":1}}],["compact",{"2":{"199":3}}],["comparisons",{"2":{"197":1}}],["comparing",{"2":{"76":1,"88":1}}],["compares",{"2":{"146":1}}],["compared",{"2":{"88":1}}],["compare",{"2":{"3":1,"4":1,"6":2,"53":1,"76":1,"88":2,"122":1}}],["compatibility",{"2":{"56":1}}],["compatible",{"2":{"1":3,"22":1,"25":1,"27":1,"53":1,"56":1,"60":2,"63":1,"69":1,"85":1,"88":1,"91":1,"101":1,"104":1,"108":1,"119":1,"122":1,"125":1,"135":1,"150":1,"151":1,"153":1,"172":2}}],["couple",{"2":{"194":1}}],["course",{"2":{"152":1}}],["country",{"2":{"199":8}}],["countries",{"2":{"11":1,"80":1,"180":1}}],["counted",{"2":{"73":2}}],["counters",{"2":{"60":8}}],["counterparts",{"2":{"33":1}}],["counter",{"2":{"6":1,"64":7,"116":1,"144":1,"145":1}}],["counterclockwise",{"2":{"4":1,"6":2,"9":1,"55":2,"56":1,"81":1,"82":1}}],["count",{"2":{"64":16,"146":1,"184":1}}],["couldn",{"2":{"9":1,"160":1}}],["could",{"2":{"4":1,"6":1,"56":3,"73":4,"76":1,"77":1,"85":1,"116":2,"158":1,"172":1}}],["conditions",{"2":{"197":4}}],["connected",{"2":{"116":5}}],["connect",{"2":{"69":11}}],["connecting",{"2":{"53":1,"182":1,"191":2}}],["connections",{"2":{"6":2,"166":2,"169":2}}],["contents",{"2":{"153":1,"161":1}}],["context",{"2":{"32":4,"176":4,"192":2}}],["contours",{"2":{"146":1}}],["contour",{"2":{"146":4}}],["continue",{"2":{"56":1,"64":7,"69":1,"71":2,"73":1,"116":1,"153":1,"165":1,"169":3,"184":1,"199":1}}],["contributions",{"2":{"25":1,"27":1}}],["controlled",{"2":{"24":1}}],["control",{"2":{"23":1}}],["containing",{"2":{"68":1,"198":1}}],["contain",{"2":{"3":1,"6":1,"26":1,"76":1,"100":1,"122":1,"191":1}}],["contained",{"2":{"3":1,"6":1,"9":1,"76":4,"101":1,"103":1,"121":1,"122":1,"153":1,"198":1}}],["contains",{"0":{"45":1,"99":1,"100":1},"1":{"100":1,"101":1},"2":{"0":2,"3":4,"6":4,"26":1,"31":1,"33":1,"45":2,"64":1,"76":1,"77":1,"99":1,"100":5,"101":4,"151":1,"168":1,"197":1,"198":1}}],["consistent",{"2":{"64":1,"148":1}}],["consistency",{"2":{"22":1}}],["considered",{"2":{"53":1,"60":1}}],["consider",{"2":{"52":1,"55":1,"62":1,"66":1,"68":1,"69":3,"84":2,"87":1,"90":1,"100":1,"103":1,"107":1,"116":3,"118":1,"121":1,"124":1,"134":1}}],["constprop",{"2":{"105":1}}],["constants",{"2":{"64":1}}],["const",{"2":{"31":4,"64":1,"91":4,"108":3,"125":4,"135":4,"155":3,"180":4}}],["constructing",{"2":{"193":1}}],["constructors",{"2":{"159":2}}],["construct",{"2":{"159":1}}],["constructed",{"2":{"1":1,"20":1,"172":1}}],["constrained",{"2":{"6":3,"70":1,"72":1,"75":1}}],["concepts",{"0":{"28":1},"1":{"29":1,"30":1},"2":{"26":1}}],["concieve",{"2":{"9":1}}],["concave",{"2":{"6":1,"53":2,"62":2,"145":2}}],["convention",{"2":{"62":1}}],["convenience",{"2":{"60":1,"187":1}}],["conversely",{"2":{"64":1}}],["conversion",{"0":{"188":1},"2":{"22":1,"33":1}}],["converted",{"2":{"22":1,"60":3}}],["converts",{"2":{"6":1,"189":1}}],["convert",{"0":{"92":1,"109":1,"126":1,"136":1},"2":{"6":3,"32":1,"35":2,"36":2,"37":2,"38":2,"40":2,"41":2,"42":2,"43":2,"44":2,"45":2,"46":2,"47":2,"48":2,"49":2,"50":1,"60":6,"82":1,"84":1,"146":2,"176":1,"180":3,"187":1,"188":1,"189":1}}],["convexity",{"2":{"81":2}}],["convexhull",{"2":{"50":1}}],["convex",{"0":{"50":1,"77":1,"80":1},"1":{"78":1,"79":1,"80":1,"81":1,"82":1},"2":{"0":1,"6":7,"31":2,"50":1,"53":3,"77":4,"79":2,"80":1,"81":4,"82":11,"145":1}}],["vw",{"2":{"180":3}}],["von",{"2":{"146":1}}],["v2",{"2":{"116":9}}],["v1",{"2":{"116":9}}],["v`",{"2":{"60":2}}],["vcat",{"2":{"53":1,"60":1,"153":1}}],["vararg",{"2":{"60":1}}],["varying",{"2":{"158":1}}],["vary",{"2":{"53":1}}],["variables",{"2":{"24":1,"60":8,"101":1,"104":1,"119":1}}],["variable",{"2":{"24":1,"71":2}}],["vals",{"2":{"182":9}}],["valign",{"2":{"180":1}}],["validated",{"2":{"71":2,"73":2,"76":2}}],["validate",{"2":{"9":1}}],["valid",{"2":{"1":1,"6":8,"63":1,"70":2,"72":2,"73":3,"75":2,"146":1,"161":3,"162":1,"167":1,"168":1,"184":1,"185":1}}],["val",{"2":{"53":2,"64":2,"73":8,"116":30,"122":4}}],["values=",{"2":{"146":2}}],["values=sort",{"2":{"146":1}}],["values",{"2":{"1":1,"5":3,"6":15,"53":2,"59":3,"60":40,"63":2,"64":5,"69":5,"73":1,"85":2,"116":4,"146":19,"150":1,"153":2,"160":1,"182":2,"184":1}}],["value",{"2":{"0":1,"4":7,"5":2,"6":15,"14":1,"24":1,"32":2,"53":1,"55":2,"56":4,"60":45,"64":5,"69":2,"73":7,"84":1,"85":3,"146":6,"153":2,"182":11,"187":2,"197":1}}],["vs",{"0":{"15":1},"2":{"12":1,"73":2}}],["vᵢ",{"2":{"6":1}}],["v",{"2":{"5":2,"6":6,"14":4,"60":23,"85":8}}],["visvalingam",{"2":{"178":1}}],["visvalingamwhyatt",{"0":{"183":1},"2":{"0":1,"6":3,"180":4,"183":5}}],["visualized",{"2":{"162":1}}],["visualize",{"2":{"118":1,"192":1}}],["visa",{"2":{"64":1}}],["visited",{"2":{"64":4}}],["view",{"2":{"64":2,"82":1,"146":1,"169":1,"182":3,"199":1}}],["viewport",{"2":{"14":1}}],["views",{"2":{"1":1,"64":1,"75":1,"172":1}}],["vincenty",{"2":{"6":1,"177":1}}],["via",{"2":{"6":1,"57":1,"77":1,"147":1,"173":1,"176":1,"187":2}}],["vec",{"2":{"82":2}}],["vect",{"2":{"156":2}}],["vectypes",{"2":{"60":5}}],["vector",{"2":{"1":12,"4":6,"5":1,"6":46,"18":1,"23":1,"29":1,"52":1,"53":10,"60":14,"64":7,"67":6,"70":4,"71":1,"72":2,"73":3,"75":4,"116":1,"122":2,"145":3,"146":4,"148":1,"150":1,"153":4,"154":3,"162":8,"163":1,"168":22,"174":1,"175":1,"177":2,"181":1,"182":4,"183":1,"184":2,"185":10,"189":15,"191":18,"192":6,"193":9}}],["vectors",{"2":{"1":1,"4":2,"6":3,"22":1,"53":4,"60":3,"64":1,"82":1,"85":1,"144":1,"146":1,"150":1,"153":1,"156":2,"180":1}}],["ve",{"2":{"17":1,"177":1}}],["vein",{"2":{"7":1}}],["version",{"2":{"187":1}}],["versa",{"2":{"64":1}}],["vert",{"2":{"184":21}}],["verts",{"2":{"180":2}}],["vertical",{"2":{"59":1,"69":1,"73":1,"146":1}}],["vertices",{"2":{"6":7,"9":1,"58":4,"60":5,"64":1,"67":2,"82":1,"93":1,"95":5,"107":1,"110":3,"113":1,"116":1,"137":1,"162":1,"174":2,"175":1,"176":3,"177":3,"180":1,"183":1}}],["vertex",{"2":{"5":1,"6":2,"53":1,"58":2,"60":2,"64":19,"73":12,"81":1,"93":2,"111":2,"112":1,"116":1,"137":3}}],["very",{"2":{"0":1,"175":1,"199":2}}],["rd",{"2":{"180":3}}],["rdbu",{"2":{"84":1}}],["rhumb",{"2":{"145":2}}],["runner",{"2":{"192":1}}],["running",{"2":{"153":1,"156":2}}],["run",{"2":{"153":5,"154":3,"199":1}}],["runs",{"2":{"73":2,"144":1}}],["rule",{"2":{"64":1}}],["rules",{"2":{"64":1}}],["rightjoin",{"2":{"197":1}}],["right=2",{"2":{"64":1}}],["right",{"2":{"60":1,"64":4,"67":1,"85":1,"145":1,"182":19,"184":5,"191":1}}],["ring4",{"2":{"193":2}}],["ring3",{"2":{"192":1}}],["ring2",{"2":{"191":2}}],["ring1",{"2":{"191":2}}],["rings",{"0":{"95":1,"112":1,"129":1,"139":1,"161":1},"1":{"162":1,"163":1},"2":{"4":4,"6":6,"9":2,"56":1,"63":1,"64":3,"73":1,"88":7,"144":1,"146":5,"163":1,"166":1,"180":1}}],["ring",{"2":{"4":7,"6":13,"9":1,"31":1,"53":3,"56":2,"60":1,"62":1,"63":4,"64":12,"69":13,"76":3,"85":5,"88":4,"93":1,"94":2,"95":5,"110":1,"112":1,"116":2,"127":1,"128":1,"129":3,"137":1,"138":2,"139":4,"145":3,"146":11,"161":2,"162":1,"163":14,"164":1,"191":1}}],["rtrees",{"2":{"20":1}}],["r+y",{"2":{"13":2,"14":1}}],["r+x",{"2":{"13":2,"14":1}}],["ry",{"2":{"13":3,"14":3}}],["rx",{"2":{"13":3,"14":3}}],["round",{"2":{"180":1,"182":1,"184":1}}],["routines",{"2":{"11":1}}],["row",{"2":{"154":3}}],["rows",{"2":{"154":2}}],["robust",{"0":{"15":1},"2":{"81":1}}],["rotate",{"2":{"69":1}}],["rotation",{"2":{"1":1,"6":1,"185":1}}],["rotations",{"2":{"1":3,"6":3,"185":3}}],["rotmatrix2d",{"2":{"180":1}}],["rotmatrix",{"2":{"1":1,"6":1,"185":1}}],["r",{"2":{"6":1,"9":1,"13":11,"14":12,"32":1,"176":1,"184":2,"191":6,"192":2,"193":4}}],["rᵢ₋₁",{"2":{"60":20}}],["rᵢ∗rᵢ₊₁+sᵢ⋅sᵢ₊₁",{"2":{"6":1}}],["rᵢ₊₁",{"2":{"6":1,"60":29}}],["rᵢ",{"2":{"6":2,"60":49}}],["ramer",{"2":{"182":1}}],["raster",{"0":{"146":1},"2":{"146":4}}],["ray",{"2":{"116":4}}],["raw",{"2":{"18":1}}],["range",{"2":{"13":8,"14":4,"146":3,"153":2,"154":2}}],["ranges",{"2":{"6":1,"146":2}}],["randomly",{"2":{"198":2}}],["random",{"2":{"180":2}}],["randn",{"2":{"79":1}}],["rand",{"2":{"6":1,"81":1,"146":1,"198":2}}],["rather",{"2":{"6":1,"146":1,"168":1}}],["ratio",{"2":{"6":7,"73":1,"176":1,"180":1,"181":4,"182":6,"183":4,"184":11}}],["radii",{"2":{"6":1,"176":1}}],["radius`",{"2":{"176":1}}],["radius",{"2":{"6":6,"60":13,"158":5,"176":4,"177":1}}],["radialdistance",{"0":{"181":1},"2":{"0":1,"6":2,"178":1,"180":4,"181":4}}],["rrayscore",{"2":{"1":1,"6":1,"185":1}}],["rring",{"2":{"1":1,"6":1,"185":1}}],["rewrap",{"2":{"153":2,"156":1}}],["req",{"2":{"116":44}}],["requirement",{"2":{"161":1,"167":1}}],["requirements",{"2":{"116":5}}],["required",{"2":{"82":1,"91":3,"108":3,"125":3,"135":3,"175":1,"190":1}}],["requires",{"2":{"57":1,"88":1,"91":2,"94":3,"95":3,"96":1,"100":1,"108":1,"111":3,"112":2,"113":1,"125":1,"128":3,"129":1,"130":1,"134":1,"135":1,"138":3,"139":3,"140":1,"173":1,"176":1,"187":1}}],["require",{"2":{"33":1,"82":1,"90":2,"91":6,"108":3,"116":32,"125":3,"135":3}}],["requests",{"2":{"25":1,"27":1}}],["reflected",{"2":{"180":3}}],["ref",{"2":{"84":1}}],["refers",{"2":{"158":1}}],["referring",{"2":{"116":1}}],["refer",{"2":{"6":1,"146":1}}],["references",{"2":{"6":1,"60":1}}],["reference",{"0":{"192":1,"193":1},"2":{"0":1,"1":2,"172":2,"190":2,"192":1}}],["reveal",{"2":{"76":1}}],["reveals",{"2":{"76":1}}],["reverse",{"2":{"55":1,"59":1,"60":1,"64":2,"191":2}}],["rev",{"2":{"75":1}}],["render",{"2":{"59":1}}],["rendering",{"2":{"59":3,"60":1}}],["rename",{"2":{"10":1}}],["regardless",{"2":{"73":1,"116":1}}],["regions",{"2":{"71":3,"73":5,"75":1,"76":3,"116":2,"199":1}}],["region",{"2":{"57":2,"73":3,"76":2,"199":1}}],["register",{"2":{"31":3,"60":3}}],["regular",{"0":{"15":1}}],["rebuilding",{"2":{"153":1,"154":1}}],["rebuild",{"2":{"31":2,"151":1,"153":3,"156":11,"177":1,"180":2}}],["rebuilt",{"2":{"1":1,"148":1,"150":1,"153":1,"156":2}}],["readable",{"2":{"195":1}}],["readability",{"2":{"64":1}}],["read",{"2":{"153":1,"192":2}}],["reading",{"2":{"153":1}}],["reads",{"2":{"153":1}}],["reached",{"2":{"153":1,"156":3}}],["reaches",{"2":{"151":1}}],["reach",{"2":{"151":1}}],["reasons",{"2":{"187":1}}],["reason",{"2":{"24":1,"160":1,"161":1,"167":1}}],["real`",{"2":{"176":1,"177":1}}],["reality",{"2":{"81":1}}],["really",{"2":{"56":1,"116":1,"146":1,"160":1}}],["real=1",{"2":{"6":2,"176":2}}],["real=6378137`",{"2":{"176":1}}],["real=6378137",{"2":{"6":2,"176":1}}],["real",{"0":{"199":1},"2":{"5":1,"6":13,"53":1,"60":45,"63":2,"73":1,"176":3,"177":3,"184":5,"197":1}}],["relation",{"2":{"64":2}}],["relations",{"2":{"31":10,"105":1,"122":1}}],["relationship",{"2":{"23":1,"197":2}}],["relative",{"2":{"60":3}}],["relevant",{"2":{"6":1,"10":1,"82":1,"158":2}}],["reducing",{"2":{"154":2}}],["reduced",{"2":{"181":1,"182":1,"183":1}}],["reduces",{"2":{"19":1,"76":1,"154":1}}],["reduce",{"2":{"1":1,"146":1,"150":1,"154":2,"165":1}}],["redundant",{"2":{"64":1}}],["red",{"2":{"14":1,"62":2,"84":1,"90":1,"103":1,"118":1,"191":1,"192":1,"198":2}}],["removal",{"2":{"64":1}}],["removes",{"2":{"64":1,"148":1}}],["removed",{"2":{"64":3,"71":5,"146":1}}],["remove",{"2":{"56":1,"64":33,"67":2,"69":1,"70":5,"72":5,"75":2,"169":2,"181":1,"182":3,"184":4}}],["removing",{"2":{"6":3,"64":1,"71":1,"181":1,"182":1,"183":1}}],["remainingnode",{"2":{"146":3}}],["remaining",{"2":{"64":1,"88":1,"116":2,"182":1}}],["remain",{"2":{"1":1,"6":8,"150":1,"153":1,"180":2}}],["resolution",{"2":{"192":1}}],["resolved",{"2":{"146":1}}],["resembles",{"2":{"158":2}}],["reset",{"2":{"64":1,"153":1}}],["resize",{"2":{"13":1,"14":1,"64":2}}],["resampled",{"2":{"6":1,"177":1}}],["respectively",{"2":{"64":1,"122":1,"156":1,"191":1}}],["respect",{"2":{"6":2,"72":1,"73":1,"82":1,"116":6}}],["rest",{"2":{"6":1,"60":2,"75":1}}],["resulting",{"2":{"67":1,"76":1,"146":1,"198":1}}],["results",{"2":{"3":2,"6":2,"73":1,"105":1,"122":1,"153":1,"154":1,"162":1,"182":25,"191":3}}],["result",{"2":{"1":2,"3":5,"4":5,"6":11,"19":1,"32":3,"53":1,"56":2,"69":1,"73":15,"82":1,"85":2,"91":1,"101":1,"104":1,"119":1,"135":1,"150":2,"153":9,"154":2,"176":3,"184":6}}],["receives",{"2":{"153":1,"154":1}}],["recent",{"2":{"64":1,"71":1,"73":1,"76":1}}],["recalculate",{"2":{"152":1}}],["recursive",{"2":{"151":1}}],["recursively",{"2":{"4":1,"6":1,"151":1,"170":1}}],["rect",{"2":{"52":3,"55":5,"68":3,"84":7}}],["rectangle",{"2":{"52":2,"55":2,"59":2,"68":2,"69":1,"84":2,"175":5,"176":8,"198":2}}],["rectangletrait",{"2":{"32":1}}],["recommended",{"2":{"22":1}}],["reconstructing",{"2":{"180":1}}],["reconstructed",{"2":{"18":1}}],["reconstruct",{"2":{"1":1,"18":1,"31":2,"150":1,"153":2,"154":1,"156":28}}],["replace",{"2":{"64":1,"146":2,"182":1}}],["replaced",{"2":{"22":1}}],["repl",{"2":{"57":1,"173":1,"176":1}}],["repeat",{"2":{"63":1,"64":3,"88":6}}],["repeating",{"2":{"56":1,"76":1}}],["repeated",{"2":{"4":3,"6":3,"9":1,"53":2,"60":1,"64":2,"76":2,"85":2,"88":4,"116":1}}],["represented",{"2":{"158":1,"198":1}}],["represent",{"2":{"17":1,"60":1,"64":4,"88":1,"158":1}}],["representing",{"2":{"6":2,"71":1,"73":1,"76":1,"82":1,"84":1,"88":1,"158":1,"199":1}}],["represents",{"2":{"6":1,"165":2,"166":1}}],["reprojects",{"2":{"172":1}}],["reprojection",{"0":{"172":1},"1":{"173":1}}],["reproject",{"2":{"0":1,"1":4,"31":2,"148":1,"172":6,"173":2}}],["re",{"2":{"1":1,"6":1,"17":1,"82":1,"185":1,"190":1,"192":1}}],["retrievable",{"2":{"1":1,"172":1}}],["returnval",{"2":{"116":9}}],["returntype",{"2":{"19":1}}],["returning",{"2":{"18":1,"57":1,"71":2}}],["return",{"0":{"22":1},"2":{"1":1,"3":18,"4":2,"6":37,"13":3,"14":3,"23":2,"30":1,"32":3,"35":1,"36":1,"37":1,"38":1,"40":1,"41":1,"42":1,"43":1,"44":1,"45":1,"46":1,"47":1,"48":1,"49":1,"50":1,"53":5,"56":5,"57":1,"60":20,"63":4,"64":36,"67":12,"69":12,"70":5,"71":4,"72":4,"73":18,"75":6,"76":9,"82":2,"85":8,"88":30,"91":1,"97":2,"98":2,"101":1,"104":1,"105":18,"108":2,"114":2,"115":2,"116":71,"118":1,"119":1,"122":28,"125":1,"127":2,"131":2,"132":2,"135":1,"141":2,"142":2,"145":10,"146":12,"153":17,"154":3,"156":7,"161":1,"163":4,"165":6,"166":2,"169":2,"171":2,"172":1,"177":4,"180":3,"181":1,"182":5,"183":3,"184":7,"185":2,"187":3,"188":2,"189":8}}],["returned",{"2":{"1":1,"6":10,"22":2,"23":1,"64":3,"67":1,"70":2,"72":2,"73":2,"75":2,"81":1,"82":1,"146":1,"153":1,"156":2,"160":1,"172":1,"180":1}}],["returns",{"2":{"1":1,"3":5,"4":4,"5":3,"6":23,"18":1,"22":2,"53":1,"56":2,"60":6,"63":3,"64":4,"67":1,"69":6,"70":1,"73":1,"75":1,"82":1,"85":8,"87":1,"91":1,"100":2,"101":1,"103":2,"104":1,"107":1,"116":4,"119":1,"122":2,"135":1,"146":2,"150":1,"153":2,"160":1,"177":1,"188":1,"197":1}}],["phi``",{"2":{"158":1}}],["physics",{"2":{"158":1}}],["psa",{"2":{"153":1,"154":1}}],["pb",{"2":{"105":2}}],["p0",{"2":{"85":9}}],["p3",{"2":{"64":8,"183":4}}],["ptm",{"2":{"145":3}}],["ptj",{"2":{"145":5}}],["pti",{"2":{"145":3}}],["ptrait",{"2":{"85":2}}],["pts",{"2":{"64":22,"67":7}}],["pt",{"2":{"64":114,"67":2,"73":26,"116":8,"182":4}}],["pt2",{"2":{"64":14,"73":2}}],["pt1",{"2":{"64":18,"73":2}}],["pn",{"2":{"127":3}}],["pn2",{"2":{"64":4}}],["pn1",{"2":{"64":4}}],["pfirst",{"2":{"56":3}}],["pu",{"2":{"198":2}}],["purpose",{"2":{"153":1}}],["pure",{"2":{"6":1,"82":1,"146":1}}],["purely",{"2":{"6":1,"18":1,"158":1,"176":1}}],["push",{"2":{"64":15,"67":5,"70":2,"72":2,"73":2,"75":4,"76":5,"146":3,"163":1,"177":3,"182":3}}],["pulling",{"2":{"82":1}}],["pull",{"2":{"25":1,"27":1}}],["public",{"2":{"24":1}}],["pick",{"2":{"192":2}}],["piece",{"2":{"64":6,"169":6}}],["pieces",{"2":{"64":12,"67":1,"71":2,"75":4,"116":1,"169":9}}],["pi",{"2":{"13":2}}],["pixels",{"2":{"146":1}}],["pixel",{"2":{"6":2,"146":7}}],["pythagorean",{"2":{"85":1}}],["py",{"2":{"13":2,"14":2}}],["px",{"2":{"13":2,"14":2}}],["peucker",{"2":{"178":2,"180":3,"182":2}}],["peaks",{"2":{"146":2}}],["peculiarities",{"0":{"21":1},"1":{"22":1,"23":1,"24":1}}],["people",{"2":{"9":1}}],["persist",{"2":{"153":1}}],["performed",{"2":{"158":1,"198":1}}],["performs",{"2":{"60":1,"154":1,"177":1}}],["perform",{"2":{"26":1,"59":1,"60":2,"64":1,"148":1,"154":1,"197":3,"198":2,"200":1}}],["performing",{"2":{"6":3,"23":1,"60":1,"70":1,"72":1,"75":1,"198":1}}],["performance",{"2":{"4":1,"6":2,"22":1,"146":1,"167":1,"170":1,"180":1,"195":1}}],["per",{"2":{"5":2,"6":2,"59":1,"60":2,"64":5,"146":1,"153":2,"154":2,"177":1}}],["pl",{"2":{"198":2}}],["plt",{"2":{"191":1}}],["please",{"2":{"64":1}}],["place",{"2":{"73":1,"197":1}}],["placement",{"2":{"64":1}}],["plan",{"2":{"174":1}}],["plane",{"2":{"6":1,"60":1,"158":3,"177":1,"196":1}}],["planar",{"2":{"6":4,"31":2,"158":5,"177":9}}],["plottable",{"2":{"146":1}}],["plotted",{"2":{"62":1}}],["plotting",{"0":{"191":1},"2":{"6":1,"146":1,"174":1,"177":1,"190":1,"191":4,"192":1}}],["plots",{"2":{"59":2}}],["plot",{"0":{"192":1},"2":{"13":1,"59":3,"79":2,"80":1,"81":1,"87":1,"121":1,"146":1,"176":2,"180":4,"190":2,"191":9,"192":5,"193":1,"195":1,"198":1}}],["plus",{"2":{"5":1,"6":1,"60":1}}],["p2y",{"2":{"189":3}}],["p2x",{"2":{"189":3}}],["p2box",{"2":{"59":1}}],["p2",{"2":{"3":2,"4":2,"6":6,"15":12,"53":12,"56":9,"64":18,"69":19,"75":2,"81":1,"85":15,"88":11,"91":2,"103":2,"116":12,"122":2,"145":3,"175":1,"183":4,"189":3,"191":2}}],["p1y",{"2":{"189":3}}],["p1x",{"2":{"189":3}}],["p1",{"2":{"3":3,"4":2,"6":7,"15":12,"53":21,"56":8,"59":4,"64":9,"66":1,"69":25,"75":2,"81":2,"85":15,"88":14,"90":5,"91":3,"103":5,"116":4,"122":2,"127":3,"145":3,"183":4,"189":3,"191":1}}],["practice",{"2":{"193":1}}],["pred",{"2":{"197":5,"198":1,"199":2,"200":1}}],["predicate",{"2":{"7":1,"105":1,"197":6,"198":1,"200":5}}],["predicates",{"0":{"12":1,"15":1,"200":1},"1":{"13":1,"14":1,"15":1,"16":1},"2":{"7":4,"12":1,"31":1,"64":5,"73":4,"74":3,"116":1,"197":1,"199":1}}],["pretty",{"2":{"172":1}}],["prettytime",{"2":{"13":2}}],["prevent",{"2":{"71":2,"73":2,"76":2}}],["prev^2",{"2":{"53":2}}],["prev",{"2":{"53":14,"64":69,"145":4}}],["previously",{"2":{"175":1}}],["previous",{"2":{"19":1,"53":1,"153":1,"181":3}}],["preparations",{"2":{"20":1}}],["prepared",{"2":{"20":1,"146":2}}],["prepare",{"0":{"20":1},"2":{"17":1,"20":1}}],["precision",{"2":{"11":1}}],["preserve",{"2":{"180":4,"182":3}}],["preserved",{"2":{"153":2}}],["preserving",{"2":{"178":1}}],["presentation",{"2":{"6":1,"60":1}}],["present",{"2":{"6":1,"153":1,"187":1}}],["presence",{"2":{"6":1,"32":1,"187":1}}],["prescribes",{"2":{"20":1}}],["press",{"2":{"6":1,"60":1}}],["pre",{"2":{"6":1,"75":1,"180":1,"182":2}}],["prefilter",{"2":{"6":1,"180":7}}],["protters",{"2":{"153":1,"154":1}}],["progressively",{"2":{"151":1}}],["program",{"2":{"17":1}}],["programming",{"2":{"17":1,"26":1}}],["promote",{"2":{"60":5}}],["property",{"2":{"154":2}}],["properties=gi",{"2":{"156":1}}],["properties=namedtuple",{"2":{"154":1}}],["properties=",{"2":{"146":1}}],["properties",{"2":{"6":1,"153":8,"156":1,"180":1,"184":1}}],["propagated",{"2":{"153":1}}],["propagate",{"2":{"60":16,"85":4}}],["probably",{"2":{"56":1,"153":1}}],["prod",{"2":{"53":4}}],["product",{"2":{"53":1}}],["process",{"2":{"93":3,"94":3,"95":3,"96":1,"105":1,"110":3,"111":3,"112":2,"113":1,"116":11,"127":1,"128":3,"129":1,"130":1,"137":3,"138":3,"139":3,"140":1,"153":1,"154":1,"182":1}}],["processed",{"2":{"64":6}}],["processors",{"2":{"31":1,"91":2,"108":2,"125":2,"135":2}}],["processor",{"2":{"31":1}}],["processing",{"2":{"23":1}}],["profile",{"2":{"9":1}}],["providers",{"2":{"162":1,"168":1}}],["provide",{"0":{"23":1},"2":{"6":6,"52":1,"55":1,"58":1,"62":1,"66":1,"68":1,"70":2,"72":2,"75":2,"84":1,"87":1,"90":1,"100":1,"103":1,"107":1,"116":2,"118":1,"121":1,"124":1,"134":1,"146":1,"184":1}}],["provides",{"2":{"6":1,"77":1,"82":1,"192":1}}],["provided",{"2":{"4":1,"6":3,"11":1,"64":1,"85":1,"88":1,"168":1,"176":2,"187":1}}],["projecting",{"2":{"192":1}}],["projections",{"2":{"158":1}}],["projection",{"2":{"85":2,"190":1,"192":1}}],["project",{"2":{"9":1}}],["projects",{"2":{"9":1}}],["proj",{"2":{"1":2,"6":3,"172":2,"173":4,"175":1,"176":6,"190":1}}],["prints",{"2":{"173":1}}],["printstyled",{"2":{"57":1,"173":1,"176":1}}],["println",{"2":{"57":1,"173":1,"176":1,"180":2}}],["print",{"2":{"57":2,"173":2,"176":2}}],["primitives",{"0":{"156":1},"2":{"31":1,"156":1}}],["primitive",{"2":{"29":1}}],["primarily",{"2":{"25":2,"27":2,"159":1}}],["primary",{"2":{"3":2,"6":3,"91":1,"135":1,"180":1}}],["priority",{"2":{"1":1,"172":1}}],["pay",{"2":{"154":1}}],["paper",{"2":{"116":2}}],["pa",{"2":{"105":2}}],["pathof",{"2":{"180":2}}],["paths",{"0":{"196":1},"2":{"160":1,"196":2}}],["path",{"2":{"55":3,"192":2}}],["parquet",{"2":{"195":3}}],["parent",{"2":{"160":1}}],["parse",{"2":{"116":1,"122":1}}],["part",{"2":{"69":2,"76":2,"116":3,"152":1}}],["partition",{"2":{"153":2,"154":2}}],["partialsort",{"2":{"184":1}}],["partial",{"2":{"69":4}}],["partially",{"2":{"64":2,"76":2}}],["particularly",{"2":{"60":1}}],["particular",{"2":{"30":1,"53":1,"146":1,"192":2}}],["parameter",{"2":{"159":3}}],["parameterized",{"2":{"158":1}}],["parameters",{"2":{"156":1,"159":2}}],["parametrized",{"2":{"158":1}}],["params",{"2":{"6":2,"187":10}}],["parallel",{"2":{"116":1,"145":1}}],["paradigm",{"0":{"29":1}}],["paradigms",{"0":{"17":1},"1":{"18":1,"19":1,"20":1},"2":{"17":2,"20":1}}],["parlance",{"2":{"5":1,"6":1,"60":1,"158":1}}],["passes",{"2":{"69":2,"116":1}}],["passed",{"2":{"1":2,"6":5,"82":1,"146":1,"156":4,"172":1,"176":2,"185":1,"187":2,"200":1}}],["passable",{"2":{"60":18}}],["passing",{"2":{"18":1,"153":1,"178":1}}],["pass",{"2":{"5":1,"6":3,"18":1,"60":1,"101":1,"104":1,"116":2,"119":1,"153":1,"160":1,"176":1,"180":1}}],["pairs",{"2":{"73":1,"191":1}}],["pair",{"2":{"3":2,"6":2,"69":1,"122":2,"153":2,"154":1}}],["packages",{"2":{"25":1,"27":1,"77":1,"156":2,"161":1,"186":1,"190":3,"192":1,"195":1}}],["package",{"2":{"1":2,"6":1,"22":1,"25":2,"27":2,"57":1,"77":2,"82":1,"146":1,"172":3,"173":1,"176":1,"192":1,"195":2}}],["page",{"2":{"0":1,"9":1,"26":1,"29":1,"31":1,"32":1,"50":1,"53":1,"56":1,"57":1,"59":1,"60":1,"63":1,"64":1,"67":1,"69":1,"71":1,"73":1,"74":1,"76":1,"82":1,"85":1,"88":1,"98":1,"101":1,"104":1,"105":1,"115":1,"116":1,"119":1,"122":1,"132":1,"142":1,"145":1,"146":1,"147":1,"153":1,"154":1,"155":1,"156":1,"160":1,"163":1,"166":1,"169":1,"170":1,"171":1,"173":1,"177":1,"184":1,"185":1,"187":1,"188":1,"189":1}}],["p",{"2":{"1":5,"6":2,"13":13,"14":12,"15":2,"52":1,"55":1,"62":1,"64":5,"68":1,"69":5,"71":2,"75":2,"79":1,"80":1,"84":3,"87":1,"90":1,"100":1,"103":1,"105":4,"107":1,"116":20,"118":1,"121":1,"124":1,"134":1,"145":4,"146":3,"148":3,"150":3,"153":5,"171":7,"175":1,"179":1,"180":1,"184":3,"185":9,"188":7,"189":11,"197":1,"198":1}}],["poylgon",{"2":{"116":1}}],["potential",{"2":{"69":1}}],["potentially",{"2":{"6":2,"64":1,"166":2,"169":2}}],["post",{"2":{"182":2}}],["possibly",{"2":{"153":1}}],["possiblenodes",{"2":{"146":2}}],["possible",{"2":{"6":3,"70":1,"72":1,"75":1,"146":1,"153":1,"154":1}}],["possibility",{"2":{"151":1}}],["possibilities",{"2":{"73":1}}],["position=",{"2":{"180":1}}],["position",{"2":{"6":1,"145":1,"175":1}}],["positive",{"2":{"4":4,"6":4,"55":3,"56":1,"84":3,"85":3,"177":2,"184":1}}],["poles",{"2":{"158":1}}],["pole",{"2":{"158":2}}],["polgons",{"2":{"146":1}}],["polgontrait",{"2":{"1":1,"150":1}}],["polar",{"2":{"6":1,"176":1}}],["polynodes",{"2":{"64":7,"70":1,"72":1,"75":1}}],["polynode",{"2":{"64":36}}],["polypoints",{"2":{"60":46}}],["polys",{"2":{"6":2,"64":39,"66":3,"67":10,"70":14,"71":14,"72":9,"73":6,"75":14,"76":28,"169":26}}],["polys1",{"2":{"3":2,"6":2,"122":6}}],["polys2",{"2":{"3":2,"6":2,"122":6}}],["poly",{"2":{"3":2,"6":16,"15":2,"52":1,"55":1,"56":6,"59":2,"60":3,"62":1,"64":107,"66":4,"67":20,"68":2,"69":4,"70":22,"71":12,"72":15,"73":10,"75":19,"76":79,"79":2,"84":1,"85":3,"88":4,"105":10,"116":21,"122":8,"145":5,"146":5,"169":18,"175":2,"179":2,"180":8,"189":8,"191":2,"198":5}}],["poly2",{"2":{"3":3,"4":2,"6":7,"70":2,"88":2,"116":19,"122":7}}],["poly1",{"2":{"3":3,"4":2,"6":7,"70":2,"88":2,"116":14,"122":7}}],["polygon3",{"2":{"191":2,"192":1}}],["polygon2",{"2":{"191":6}}],["polygon1",{"2":{"191":4}}],["polygonization",{"2":{"146":1}}],["polygonizing",{"0":{"146":1}}],["polygonized",{"2":{"146":1}}],["polygonize",{"2":{"0":1,"6":6,"9":1,"31":1,"146":31}}],["polygon`",{"2":{"60":3,"82":1}}],["polygons",{"0":{"96":1,"130":1,"140":1,"167":1},"1":{"168":1,"169":1},"2":{"3":4,"4":3,"5":1,"6":18,"9":1,"23":5,"31":1,"56":5,"58":1,"60":2,"62":1,"63":1,"64":14,"67":2,"69":1,"70":9,"71":5,"72":3,"73":8,"75":6,"76":19,"84":1,"85":1,"88":5,"96":1,"122":5,"140":1,"145":1,"146":19,"151":1,"162":2,"166":3,"167":2,"168":2,"169":10,"178":1,"180":1,"191":3,"192":1,"198":5,"199":3}}],["polygontrait",{"2":{"1":1,"3":4,"4":6,"6":13,"15":3,"23":1,"32":1,"53":2,"56":3,"60":3,"63":2,"64":2,"67":1,"69":2,"70":5,"71":5,"72":3,"73":5,"75":4,"76":8,"85":2,"88":10,"93":2,"94":1,"95":1,"96":3,"97":1,"105":4,"110":2,"111":2,"112":1,"113":2,"114":1,"122":8,"127":2,"128":1,"129":1,"130":3,"131":1,"137":2,"138":1,"139":1,"140":3,"141":1,"148":1,"150":1,"151":2,"153":2,"154":1,"163":2,"165":2,"166":1,"169":2,"180":2,"189":1}}],["polygon",{"0":{"34":1,"64":1,"65":1,"70":1,"71":1,"73":1,"75":1,"76":1,"113":1},"1":{"35":1,"36":1,"37":1,"38":1,"66":1,"67":1},"2":{"0":1,"1":4,"3":4,"4":21,"5":9,"6":65,"9":2,"11":3,"15":4,"20":1,"23":1,"52":1,"53":5,"55":2,"56":5,"58":5,"59":16,"60":57,"62":2,"63":4,"64":39,"66":3,"67":10,"68":3,"69":4,"70":5,"71":7,"72":5,"73":6,"75":6,"76":34,"77":1,"81":1,"82":3,"84":3,"85":14,"88":12,"91":1,"93":3,"94":3,"95":4,"96":8,"105":1,"110":3,"111":4,"112":4,"113":4,"116":66,"122":4,"125":1,"127":3,"128":4,"129":5,"130":7,"135":1,"137":3,"138":4,"139":4,"140":8,"145":5,"146":4,"150":1,"153":1,"161":4,"162":8,"163":5,"164":1,"166":4,"167":3,"168":12,"169":7,"175":1,"176":4,"179":1,"180":9,"185":3,"189":6,"191":12,"192":5,"193":7,"194":2,"198":6}}],["pointwise",{"0":{"185":1},"2":{"172":1}}],["point1",{"2":{"85":4}}],["point`",{"2":{"73":1}}],["pointedgeside",{"2":{"64":1}}],["point₂",{"2":{"63":13}}],["point₁",{"2":{"63":13}}],["point3s",{"2":{"60":10}}],["point3f",{"2":{"59":1}}],["pointrait",{"2":{"6":1}}],["point2f",{"2":{"59":4,"60":2,"79":1,"84":1}}],["point2d",{"2":{"59":1}}],["point2",{"2":{"6":2,"60":5,"81":1,"85":4}}],["pointtrait",{"2":{"1":1,"4":4,"6":6,"18":1,"32":1,"50":1,"53":2,"56":1,"60":3,"69":1,"72":2,"82":1,"85":17,"88":8,"93":6,"97":1,"110":6,"114":1,"127":6,"131":1,"137":6,"141":1,"148":2,"150":1,"151":1,"153":7,"154":4,"156":12,"159":2,"165":2,"166":1,"170":1,"171":2,"180":2,"185":2,"188":2,"189":1}}],["point",{"0":{"110":1,"127":1},"2":{"1":4,"3":10,"4":37,"5":7,"6":82,"9":2,"20":1,"50":1,"53":12,"56":3,"58":3,"59":1,"60":126,"63":6,"64":97,"67":13,"69":50,"71":9,"72":1,"73":71,"76":9,"82":3,"84":17,"85":73,"88":27,"90":1,"91":2,"93":8,"101":3,"105":21,"108":2,"110":10,"116":138,"118":1,"121":2,"122":21,"124":1,"125":3,"127":10,"128":1,"130":1,"135":4,"137":11,"145":1,"146":3,"150":1,"153":1,"161":1,"162":2,"166":2,"167":1,"169":2,"172":1,"174":1,"180":2,"181":3,"182":9,"183":1,"185":2,"189":4,"191":111,"192":7,"193":8,"198":2}}],["points2",{"2":{"3":1,"6":1,"122":3}}],["points1",{"2":{"3":1,"6":1,"122":3}}],["points",{"0":{"93":1,"137":1},"2":{"0":1,"1":3,"3":1,"4":11,"5":1,"6":53,"9":3,"13":1,"53":2,"55":3,"56":3,"59":8,"60":32,"63":1,"64":55,"67":3,"69":5,"70":5,"71":1,"72":8,"73":28,"75":4,"76":1,"77":3,"79":4,"81":4,"82":6,"84":2,"85":8,"87":2,"88":13,"91":6,"93":3,"94":4,"100":1,"108":6,"110":1,"111":7,"112":3,"116":10,"122":5,"125":5,"127":1,"128":2,"129":4,"130":3,"134":1,"135":5,"137":3,"138":3,"139":3,"140":1,"144":1,"146":3,"153":2,"154":1,"170":2,"172":1,"175":2,"176":2,"180":11,"181":11,"182":26,"183":10,"184":33,"185":2,"188":2,"189":25,"191":8,"192":1,"197":1,"198":11}}],["pointorientation",{"2":{"0":1,"6":2,"116":2}}],["my",{"2":{"199":1,"200":2}}],["m`",{"2":{"158":1}}],["mdk",{"2":{"153":2}}],["moore",{"2":{"146":1}}],["moved",{"2":{"64":1,"172":1}}],["move",{"2":{"63":1,"116":1}}],["mode",{"2":{"200":3}}],["model",{"2":{"158":1,"197":1}}],["modify",{"2":{"191":1}}],["modified",{"2":{"153":1,"154":1}}],["module",{"2":{"172":1,"177":1}}],["modules",{"2":{"6":1,"60":1}}],["mod1",{"2":{"60":5}}],["mod",{"2":{"60":1,"64":1}}],["most",{"2":{"25":1,"27":1,"64":1,"71":1,"73":1,"76":1,"81":1,"116":1,"180":1,"195":2}}],["monotone",{"2":{"20":1,"81":2}}],["monotonechainmethod",{"2":{"0":1,"6":1,"77":1,"81":2,"82":4}}],["moment",{"2":{"6":1,"175":1,"177":1}}],["more",{"2":{"6":3,"7":1,"9":1,"10":1,"11":1,"23":1,"26":1,"29":1,"64":1,"70":1,"72":1,"75":1,"82":1,"116":1,"122":1,"153":2,"154":2,"157":1,"158":2,"163":1,"173":1,"175":1,"177":1,"191":2,"197":1}}],["missing",{"2":{"175":4}}],["missed",{"2":{"146":1}}],["mistakenly",{"2":{"167":1}}],["mid",{"2":{"69":2,"116":3}}],["midpoint",{"2":{"64":2}}],["middle",{"2":{"64":2}}],["mining",{"2":{"199":1}}],["minimal",{"2":{"199":1}}],["minimize",{"2":{"73":1}}],["minimum",{"2":{"4":7,"6":12,"68":1,"69":2,"85":12,"180":1,"181":1,"183":1}}],["mind",{"2":{"175":1,"198":1}}],["minmax",{"2":{"73":4}}],["min",{"2":{"69":1,"73":16,"85":15,"180":1,"182":3,"183":1,"184":28}}],["minus",{"2":{"55":1}}],["minpoints=0",{"2":{"146":1}}],["minpoints",{"2":{"6":2}}],["might",{"2":{"6":3,"25":1,"27":1,"56":1,"70":1,"72":1,"73":1,"75":1,"164":1,"182":1}}],["mixed",{"2":{"6":4,"180":1}}],["m",{"2":{"5":1,"6":1,"15":10,"60":2,"69":6,"145":2,"192":1}}],["mp",{"2":{"105":2}}],["mp1",{"2":{"4":2,"6":2,"88":7}}],["mp2",{"2":{"4":2,"6":2,"88":8}}],["mason",{"2":{"153":1,"154":1}}],["markersize",{"2":{"191":2}}],["marker",{"2":{"191":2}}],["marked",{"2":{"64":6,"71":1,"73":1,"76":1}}],["marking",{"2":{"71":2,"73":2,"76":2}}],["mark",{"2":{"64":2}}],["marks",{"2":{"64":1}}],["mag",{"2":{"53":4}}],["making",{"2":{"64":1,"146":1,"151":1,"168":1,"191":1,"193":2}}],["makie",{"2":{"13":1,"14":1,"52":1,"55":1,"59":3,"62":1,"66":4,"68":1,"79":1,"80":1,"84":1,"87":1,"90":1,"100":1,"103":1,"107":1,"118":1,"121":1,"124":1,"134":1,"146":3,"179":1,"180":1,"196":1}}],["makevalid",{"2":{"180":2}}],["makes",{"2":{"56":1,"64":1,"85":1,"153":1,"162":1,"167":1,"168":1}}],["make",{"2":{"9":1,"25":1,"27":1,"53":1,"64":3,"73":1,"85":1,"122":1,"146":2,"151":1,"163":1,"175":1,"184":1,"186":1,"191":2,"193":1}}],["mainly",{"2":{"60":1,"84":1,"148":1,"154":1}}],["maintain",{"2":{"56":1}}],["main",{"0":{"28":1},"1":{"29":1,"30":1},"2":{"7":1,"26":1,"64":1,"146":1,"153":1,"176":1}}],["manner",{"2":{"197":1}}],["manipulate",{"2":{"195":1}}],["manifolds",{"2":{"158":2}}],["manifold",{"0":{"158":1},"2":{"6":1,"31":2,"158":12,"177":3}}],["manually",{"2":{"161":1}}],["many",{"2":{"4":1,"5":1,"6":2,"23":1,"26":1,"60":1,"64":1,"67":1,"71":1,"73":2,"76":1,"88":1,"162":1,"170":1}}],["mapped",{"2":{"195":1}}],["maptasks`",{"2":{"153":1}}],["maptasks",{"2":{"153":7}}],["mapreducetasks`",{"2":{"154":1}}],["mapreducetasks",{"2":{"154":5}}],["mapreduce",{"2":{"71":1,"146":2,"153":3,"154":7}}],["map",{"0":{"192":1},"2":{"6":1,"13":1,"18":3,"19":1,"29":1,"60":1,"64":1,"73":1,"122":2,"146":17,"153":11,"154":5,"156":10,"158":1,"159":1,"163":1,"180":1,"190":1,"192":1,"193":1,"195":1}}],["matches",{"2":{"88":1,"146":1}}],["match",{"2":{"88":12,"122":3,"146":1,"153":1,"156":2}}],["matching",{"2":{"3":1,"6":1,"22":1,"88":3,"122":1,"151":2}}],["matlab",{"2":{"66":1}}],["materializer`",{"2":{"153":1}}],["materializer",{"2":{"22":1,"153":1}}],["mathematical",{"2":{"158":1}}],["mathematically",{"2":{"6":1,"145":1,"158":2}}],["mathematics",{"2":{"158":1}}],["mathrm",{"2":{"60":1}}],["math",{"2":{"7":1}}],["matrix",{"2":{"6":1,"14":2,"60":1}}],["maxlog=3",{"2":{"177":1}}],["maximal",{"2":{"73":1}}],["maximum",{"2":{"3":1,"6":4,"14":1,"68":1,"69":4,"105":1,"146":1,"176":1,"177":1,"182":4}}],["max",{"2":{"6":9,"32":9,"53":2,"69":1,"146":1,"153":1,"154":1,"175":5,"176":8,"177":21,"182":36,"184":1,"196":1}}],["made",{"2":{"6":2,"63":1,"64":1,"73":1,"129":1,"151":1,"166":1,"169":1,"183":1}}],["maybe",{"2":{"32":1,"116":4,"153":2,"154":3,"156":2}}],["may",{"2":{"1":1,"6":3,"23":2,"24":1,"60":2,"64":1,"73":1,"81":1,"145":1,"147":1,"150":1,"151":1,"153":4,"158":1,"159":1,"167":1,"168":1,"176":1}}],["mercator",{"2":{"192":1}}],["merge",{"2":{"153":1}}],["measures",{"2":{"158":1}}],["measure",{"2":{"156":1,"174":1}}],["meant",{"2":{"26":1}}],["meaning",{"2":{"3":3,"4":1,"6":4,"24":1,"56":1,"57":1,"122":4,"145":1,"158":1}}],["means",{"2":{"3":1,"6":2,"55":1,"56":1,"57":1,"90":1,"116":3,"121":1,"122":1,"145":1,"151":1,"158":2,"160":2}}],["mean",{"2":{"0":1,"6":5,"17":1,"59":2,"60":5,"154":1,"158":1}}],["meanvalue",{"2":{"0":1,"5":2,"6":3,"58":1,"59":2,"60":15}}],["meets",{"2":{"116":9,"122":1,"182":1}}],["meet",{"2":{"73":3,"90":1,"91":1,"108":1,"116":7,"125":1,"135":1}}],["memory",{"2":{"60":1,"193":1}}],["mesh",{"2":{"59":1}}],["message",{"2":{"6":1,"187":1}}],["me",{"0":{"23":1}}],["mentioned",{"2":{"19":1}}],["mentions",{"2":{"6":1,"187":1}}],["menu",{"2":{"14":3}}],["median",{"2":{"13":4,"154":1}}],["mechanics",{"2":{"6":1,"60":1}}],["metadatakeys",{"2":{"153":1}}],["metadatasupport",{"2":{"153":2}}],["metadata",{"2":{"153":11}}],["met",{"2":{"116":44}}],["meters",{"2":{"6":4,"175":1,"176":4,"192":1}}],["methoderror",{"2":{"31":3}}],["methods",{"0":{"2":1,"3":1,"4":1,"6":1,"39":1},"1":{"3":1,"4":1,"40":1,"41":1,"42":1,"43":1,"44":1,"45":1,"46":1,"47":1,"48":1,"49":1},"2":{"1":1,"6":7,"9":1,"25":1,"27":1,"31":27,"60":3,"77":1,"91":1,"108":1,"125":1,"135":1,"146":1,"151":1,"153":1,"156":2,"159":1,"175":1,"180":2,"185":1,"191":1}}],["method",{"0":{"173":1},"2":{"1":1,"4":1,"5":10,"6":30,"24":1,"32":1,"53":1,"56":1,"57":2,"60":37,"63":1,"69":1,"73":1,"76":1,"81":3,"82":2,"85":4,"88":1,"91":2,"108":2,"122":1,"125":2,"135":2,"146":1,"153":1,"154":1,"156":3,"160":1,"172":1,"173":2,"175":2,"176":9,"177":22,"178":2,"187":3,"197":1,"200":1}}],["mutation",{"2":{"194":1}}],["mutlipolygon",{"2":{"4":1,"6":1,"63":1}}],["muladd",{"2":{"60":2}}],["multifloats",{"2":{"13":1,"14":1,"15":1}}],["multifloat",{"2":{"7":1}}],["multilinestringtrait",{"2":{"32":1,"165":1}}],["multilinestring",{"2":{"6":1,"189":2}}],["multi",{"0":{"97":1,"98":1,"114":1,"115":1,"131":1,"132":1,"141":1,"142":1},"2":{"4":2,"6":3,"53":1,"56":1,"69":1,"88":2,"97":1,"98":1,"114":1,"115":1,"131":1,"132":1,"141":1,"142":1}}],["multicurves",{"2":{"56":1,"69":1}}],["multicurve",{"2":{"4":1,"6":1,"56":1}}],["multigeometry",{"2":{"4":2,"6":2,"85":2}}],["multiplication",{"2":{"177":1}}],["multiplied",{"2":{"60":3,"158":1}}],["multiple",{"2":{"4":1,"6":1,"60":1,"116":1,"170":1,"184":1,"191":1,"195":1}}],["multiply",{"2":{"1":1,"6":1,"185":1}}],["multipolys",{"2":{"76":3}}],["multipoly`",{"2":{"70":2,"72":2,"75":2}}],["multipoly",{"2":{"6":9,"15":3,"70":1,"71":27,"72":1,"73":26,"75":1,"76":24,"169":21,"180":9}}],["multipolygon`",{"2":{"146":1}}],["multipolygons",{"2":{"3":1,"4":1,"6":11,"63":1,"70":3,"72":3,"73":3,"75":3,"84":1,"88":1,"122":2,"168":1,"191":1,"192":1}}],["multipolygon",{"2":{"3":2,"4":5,"6":17,"56":2,"62":1,"70":1,"71":7,"72":1,"73":5,"75":1,"76":6,"88":4,"122":2,"146":7,"166":2,"167":7,"168":8,"169":2,"180":3,"191":8,"192":1}}],["multipolygontrait",{"2":{"1":1,"3":4,"4":2,"6":6,"23":1,"32":1,"71":4,"73":4,"76":4,"88":6,"97":1,"98":1,"114":1,"115":1,"122":8,"131":1,"132":1,"141":1,"142":1,"150":1,"153":1,"165":1,"169":4}}],["multipoint",{"2":{"4":5,"6":5,"50":1,"56":1,"88":5,"105":6,"153":1,"154":2,"180":1,"191":5}}],["multipoints",{"2":{"3":2,"4":1,"6":3,"56":1,"69":1,"88":2,"122":2,"180":1,"191":1}}],["multipointtrait",{"2":{"1":1,"3":2,"4":4,"6":7,"32":1,"53":2,"56":1,"69":1,"88":8,"97":1,"98":1,"105":4,"114":1,"115":1,"122":4,"131":1,"132":1,"141":1,"142":1,"150":1,"151":1,"165":1,"180":2,"189":1}}],["multithreading",{"2":{"1":2,"4":1,"6":4,"150":1,"155":1}}],["must",{"2":{"1":1,"3":8,"4":2,"5":1,"6":22,"9":1,"53":1,"57":1,"60":5,"64":2,"67":1,"69":3,"73":2,"88":5,"91":1,"101":2,"103":1,"104":1,"108":1,"116":13,"122":1,"124":1,"125":1,"135":2,"146":1,"153":1,"156":2,"164":1,"165":3,"166":1,"172":1,"176":1,"177":1,"180":1,"184":4,"187":1}}],["much",{"2":{"0":1,"6":3,"70":1,"72":1,"75":1}}],["df",{"2":{"194":3,"195":4,"198":10,"199":12}}],["dp",{"2":{"180":3}}],["dy",{"2":{"145":2,"177":3}}],["dy2",{"2":{"145":2}}],["dy1",{"2":{"105":10,"145":2}}],["dyc",{"2":{"105":2}}],["dx",{"2":{"145":2,"177":3}}],["dx2",{"2":{"145":2}}],["dx1",{"2":{"105":10,"145":2}}],["dxc",{"2":{"105":2}}],["drop",{"2":{"76":1,"169":1,"177":1}}],["driven",{"2":{"25":1,"27":1}}],["driving",{"2":{"25":1,"27":1}}],["duplicated",{"2":{"73":2}}],["during",{"2":{"64":1}}],["due",{"2":{"63":1,"64":1,"73":3}}],["date",{"2":{"81":1}}],["datas",{"2":{"200":1}}],["datasets",{"2":{"192":1,"197":1,"198":1}}],["dataset",{"2":{"192":1,"197":1}}],["datainterpolations",{"2":{"174":1}}],["dataapi",{"2":{"31":1,"153":7}}],["dataaspect",{"2":{"13":1,"14":1,"52":1,"55":1,"59":2,"62":1,"68":1,"84":2,"146":2,"175":1,"180":1}}],["dataframes",{"2":{"194":3,"198":2,"199":1}}],["dataframe",{"2":{"29":1,"194":1,"197":1,"198":5,"199":2}}],["data",{"0":{"146":1,"195":1},"2":{"23":1,"25":1,"27":1,"80":1,"146":2,"153":1,"180":10,"190":1,"192":2,"193":2,"194":2,"195":6,"198":1}}],["dashboard",{"0":{"14":1},"2":{"13":1,"14":1}}],["d",{"2":{"1":2,"5":1,"6":1,"60":1,"158":1,"172":1,"182":3}}],["deu",{"2":{"199":2}}],["demonstrates",{"2":{"198":1}}],["densify",{"2":{"176":3}}],["densifying",{"2":{"176":1}}],["densifies",{"2":{"174":1}}],["denoted",{"2":{"116":1}}],["denotes",{"2":{"64":1}}],["debug",{"2":{"165":1}}],["debugging",{"2":{"60":1,"64":1}}],["derivation",{"2":{"73":1}}],["dealing",{"2":{"69":1}}],["delete",{"2":{"105":1,"122":1,"146":1,"182":1}}],["deleteat",{"2":{"64":6,"182":1,"184":2}}],["deltri",{"2":{"82":1}}],["delayed",{"2":{"64":10,"71":2,"73":2,"76":2}}],["delay",{"2":{"64":14,"70":2,"71":2,"72":2,"73":2,"75":2,"76":2}}],["delaunay",{"2":{"6":1,"82":1}}],["delaunaytriangulation",{"2":{"6":1,"31":1,"77":1,"82":6}}],["deprecated",{"2":{"177":1}}],["depend",{"2":{"64":2}}],["depends",{"2":{"64":1,"67":1}}],["depending",{"2":{"1":1,"23":1,"73":1,"150":1,"153":1}}],["depth",{"2":{"60":2}}],["desktop",{"2":{"195":1}}],["dest",{"2":{"192":2}}],["destination",{"2":{"192":5}}],["desired",{"2":{"75":1,"195":1}}],["despite",{"2":{"53":1}}],["describe",{"2":{"17":1}}],["described",{"2":{"6":1,"60":1,"63":1,"64":1}}],["de",{"0":{"39":1},"1":{"40":1,"41":1,"42":1,"43":1,"44":1,"45":1,"46":1,"47":1,"48":1,"49":1},"2":{"116":2,"197":1}}],["deconstruct",{"2":{"148":1,"154":1}}],["decomposition",{"2":{"18":1,"148":1}}],["decomposing",{"2":{"18":1}}],["decompose",{"2":{"18":2,"29":1,"60":4,"154":1,"161":1}}],["decrementing",{"2":{"146":1}}],["decrease",{"2":{"63":1}}],["decreasing",{"2":{"6":1,"180":1}}],["decide",{"2":{"81":1,"146":1}}],["decision",{"2":{"24":1}}],["degeneracies",{"2":{"9":1}}],["degenerate",{"2":{"6":1,"60":1,"67":2}}],["degrees",{"2":{"6":1,"52":1,"145":1,"158":1,"176":1}}],["defines",{"2":{"64":1,"148":1,"154":1,"155":1,"156":1,"157":1,"164":1,"186":1}}],["define",{"2":{"59":1,"73":2,"87":1,"146":2,"148":1,"151":1,"153":1,"158":1,"186":1,"200":2}}],["defined",{"2":{"4":1,"5":1,"6":3,"7":1,"22":1,"53":2,"60":1,"68":1,"69":4,"73":4,"85":2,"144":1,"153":1,"158":3,"177":1,"186":1}}],["definitions",{"2":{"187":1}}],["definition",{"2":{"4":4,"6":6,"88":8,"90":1,"158":3,"177":1}}],["default",{"2":{"1":2,"4":5,"6":13,"32":1,"53":1,"56":2,"69":1,"70":1,"71":2,"72":1,"73":5,"75":1,"76":2,"82":1,"85":2,"146":5,"153":5,"156":2,"158":1,"172":2,"180":2}}],["defaults",{"2":{"1":6,"4":2,"6":11,"150":3,"153":1,"155":3}}],["deeper",{"2":{"1":1,"150":1,"152":1,"153":2}}],["detrimental",{"2":{"167":1}}],["detector",{"2":{"81":1}}],["detection",{"2":{"81":1,"146":1}}],["determined",{"2":{"64":1,"69":1}}],["determine",{"2":{"64":10,"69":3,"70":2,"72":2,"73":9,"75":2,"91":1,"108":1,"116":9,"122":1,"125":1,"135":1,"182":3,"197":1}}],["determines",{"2":{"56":1,"64":3,"73":1,"116":10}}],["determinant",{"2":{"6":1,"60":1}}],["detail",{"2":{"26":1}}],["details",{"2":{"6":2,"175":2}}],["details>",{"2":{"6":2}}],["det",{"2":{"0":1,"6":2,"60":4}}],["dirname",{"2":{"180":4}}],["dirty",{"2":{"179":1}}],["directive",{"2":{"153":1}}],["direction",{"2":{"6":1,"64":1,"88":5,"146":3}}],["direct",{"2":{"33":1}}],["directly",{"2":{"6":1,"82":3,"146":1,"176":1}}],["dig",{"2":{"153":1}}],["dict",{"2":{"146":5}}],["didn",{"2":{"76":1,"116":1,"160":1}}],["division",{"2":{"59":1}}],["divided",{"2":{"26":1}}],["ditance",{"2":{"4":1,"6":1,"85":1}}],["dimensional",{"2":{"5":1,"6":3,"55":1,"60":1,"82":2,"158":1}}],["dimensions",{"2":{"3":1,"6":1,"122":2}}],["dimension",{"2":{"1":1,"3":4,"6":4,"105":2,"121":1,"122":4,"172":1}}],["discouraged",{"2":{"193":1}}],["discussion",{"2":{"25":1,"27":1,"67":1}}],["distributed",{"2":{"198":2}}],["distinct",{"2":{"73":1,"146":1}}],["dist",{"2":{"73":40,"85":19,"116":2,"176":8,"182":40}}],["distance`",{"2":{"176":3,"177":2,"187":1}}],["distances",{"2":{"73":1,"84":1,"176":1,"181":5}}],["distance",{"0":{"83":2,"84":2},"1":{"84":2,"85":2},"2":{"0":4,"4":26,"6":47,"31":1,"32":9,"57":3,"60":13,"69":3,"73":32,"83":2,"84":17,"85":92,"116":1,"148":1,"154":1,"174":1,"175":5,"176":13,"177":28,"180":1,"181":3,"182":6,"183":1,"196":1,"200":2}}],["disagree",{"2":{"56":1}}],["displacement",{"2":{"158":1}}],["displaying",{"2":{"192":1}}],["display",{"2":{"13":1,"59":1,"192":1}}],["disparate",{"2":{"25":1,"27":1}}],["dispatches",{"2":{"6":1,"53":1,"56":1,"60":1,"63":1,"69":1,"85":1,"88":1,"91":1,"108":1,"122":1,"125":1,"135":1}}],["dispatch",{"2":{"4":1,"6":3,"24":1,"60":1,"88":1,"156":3,"159":1,"187":1}}],["disjoint",{"0":{"41":1,"106":1,"107":1,"110":1,"111":1,"112":1,"113":1,"114":1},"1":{"107":1,"108":1},"2":{"0":2,"3":5,"6":7,"23":1,"31":1,"41":2,"76":2,"106":1,"107":3,"108":11,"109":6,"110":15,"111":18,"112":10,"113":5,"114":4,"115":2,"116":16,"119":3,"166":2,"167":2,"169":7,"197":1}}],["diffs",{"2":{"53":4}}],["diff",{"2":{"6":2,"53":17,"70":5,"71":3,"122":3,"169":8}}],["differs",{"2":{"192":1}}],["differ",{"2":{"4":1,"6":1,"85":1}}],["differently",{"2":{"4":3,"6":4,"53":1,"56":2,"69":1}}],["different",{"2":{"3":1,"4":4,"6":6,"20":1,"23":1,"53":1,"56":4,"64":3,"69":1,"73":2,"81":1,"122":3,"146":1,"151":1,"153":1,"167":2,"192":2,"195":1}}],["differences",{"0":{"71":1},"2":{"73":1,"182":1}}],["difference",{"0":{"35":1,"38":1,"70":1},"2":{"0":1,"6":7,"11":1,"23":1,"31":1,"35":2,"38":1,"64":3,"70":12,"71":14,"73":1,"75":1,"76":3,"166":1,"169":1,"176":1}}],["diffintersectingpolygons",{"2":{"0":1,"6":1,"166":1,"169":4}}],["doi",{"2":{"70":2,"72":2,"75":2,"116":1}}],["doing",{"2":{"17":1,"22":1,"153":1,"193":1}}],["dot",{"2":{"53":2,"60":1}}],["download",{"2":{"192":1}}],["down",{"2":{"18":1,"29":1,"60":1,"156":2}}],["doable",{"2":{"9":1}}],["documenter",{"2":{"175":2}}],["documentation",{"0":{"0":1},"1":{"1":1,"2":1,"3":1,"4":1,"5":1,"6":1},"2":{"0":1,"26":1,"59":1,"155":1}}],["docstring",{"2":{"175":4}}],["docstrings",{"0":{"149":1},"1":{"150":1},"2":{"7":1,"155":1}}],["docs",{"0":{"26":1,"155":1},"2":{"26":1,"146":1}}],["doc",{"2":{"9":1,"10":1}}],["does",{"0":{"22":1},"2":{"7":1,"19":1,"62":1,"73":2,"90":3,"100":1,"116":1}}],["doesn",{"2":{"4":1,"6":2,"32":1,"56":1,"67":1,"88":1,"176":1,"187":1,"199":1}}],["doublets",{"2":{"199":2}}],["double",{"2":{"183":4}}],["doubled",{"2":{"6":1,"183":1}}],["douglas",{"2":{"178":2,"180":2,"182":1}}],["douglaspeucker",{"0":{"182":1},"2":{"0":1,"6":5,"178":1,"180":5,"182":6}}],["done",{"0":{"10":1},"2":{"13":1,"14":1,"116":2,"146":1,"148":1,"158":1,"167":1,"191":1,"197":1}}],["don",{"2":{"4":2,"6":2,"64":4,"70":1,"76":1,"88":6,"111":1,"116":1,"124":1,"128":1,"146":2,"153":3,"154":2,"187":1}}],["do",{"0":{"9":1,"23":1,"74":1},"2":{"1":1,"6":1,"14":1,"23":1,"31":1,"53":1,"56":2,"57":1,"60":2,"63":1,"67":1,"69":1,"76":3,"85":2,"87":1,"88":1,"103":1,"111":2,"112":1,"113":2,"116":1,"146":4,"148":1,"150":1,"153":5,"154":2,"156":4,"162":1,"163":1,"168":1,"171":2,"173":1,"176":1,"180":1,"185":2,"188":2,"192":2,"193":2,"194":3,"198":1,"199":1}}],["aim",{"2":{"158":1}}],["ay",{"2":{"145":2}}],["azimuth",{"2":{"145":2}}],["automatically",{"2":{"122":1,"153":1,"192":1}}],["a3",{"2":{"80":1}}],["against",{"2":{"88":1,"116":2,"176":1,"180":1}}],["again",{"2":{"73":1,"153":1}}],["a``",{"2":{"71":2}}],["a`",{"2":{"71":7,"73":3,"76":2}}],["a2y",{"2":{"73":4}}],["a2x",{"2":{"73":4}}],["a2",{"2":{"59":4,"73":54,"81":1,"122":6}}],["a1y",{"2":{"73":7}}],["a1x",{"2":{"73":7}}],["a1",{"2":{"59":2,"64":9,"73":66,"81":1,"122":6}}],["away",{"2":{"57":1,"105":1,"200":1}}],["ams",{"2":{"196":2}}],["america",{"2":{"180":1}}],["am",{"2":{"116":1}}],["ambiguity",{"2":{"85":2,"153":1,"154":1,"156":3}}],["amounts",{"2":{"195":1}}],["amount",{"2":{"55":1,"68":1}}],["amp",{"2":{"6":1,"9":1}}],["axes",{"2":{"146":6}}],["ax",{"2":{"13":3,"14":3,"145":2,"191":5}}],["axis`",{"2":{"158":1}}],["axislegend",{"2":{"79":1,"175":1,"179":1}}],["axis",{"2":{"13":2,"14":1,"52":1,"55":1,"59":4,"62":1,"68":1,"81":2,"84":1,"146":2,"158":4,"175":1,"180":1,"196":1}}],["axs",{"2":{"13":2}}],["advised",{"2":{"159":1}}],["advance",{"2":{"63":2}}],["adjust",{"2":{"73":1}}],["adjacent",{"2":{"64":1,"71":1,"73":1,"76":1}}],["adaptivity",{"0":{"74":1}}],["adaptive",{"2":{"7":1,"13":3,"14":2,"74":1}}],["adapted",{"2":{"70":1,"72":1,"75":1,"145":1}}],["administrative",{"2":{"199":1}}],["admin",{"2":{"11":1,"80":1,"180":2}}],["adm0",{"2":{"11":7,"80":4}}],["additional",{"2":{"195":1}}],["additionally",{"2":{"64":3,"88":1}}],["addition",{"2":{"59":1,"76":1}}],["adding",{"2":{"4":1,"6":4,"7":1,"76":2,"146":1,"170":1,"174":1,"176":2,"177":1}}],["added",{"2":{"53":1,"64":6,"69":1,"76":2,"156":2,"169":2,"182":1}}],["add",{"2":{"3":1,"6":1,"7":2,"57":1,"60":1,"64":16,"67":4,"69":1,"70":3,"72":1,"73":2,"75":2,"76":9,"82":1,"105":1,"146":4,"156":1,"160":1,"174":1,"176":1,"182":10,"192":1,"194":2,"197":4}}],["average",{"2":{"58":3,"63":4,"73":1}}],["available",{"0":{"166":1},"2":{"6":2,"31":1,"63":1,"159":1,"165":3,"174":1,"175":1,"177":1,"180":1,"184":1}}],["avoid",{"2":{"5":1,"6":7,"60":1,"70":1,"72":1,"73":1,"75":1,"76":1,"146":2,"153":1,"154":1,"156":3,"177":1,"181":1,"182":1,"183":1,"191":3}}],["a>",{"2":{"6":2}}],["achieve",{"2":{"167":1}}],["across",{"2":{"151":1}}],["acos",{"2":{"53":1}}],["activate",{"2":{"175":1}}],["action",{"2":{"20":2}}],["actions",{"2":{"20":2}}],["actual",{"2":{"10":1,"60":1,"145":1,"163":1,"172":1,"176":1}}],["actually",{"2":{"1":1,"6":1,"9":1,"60":4,"73":1,"76":3,"116":1,"146":1,"185":1,"195":1}}],["access",{"2":{"192":1}}],["accessed",{"2":{"187":1}}],["accepted",{"2":{"158":1}}],["acceptable",{"2":{"116":1}}],["accepts",{"2":{"82":1}}],["accept",{"2":{"6":1,"187":1}}],["according",{"2":{"162":1,"167":1,"168":1,"198":1}}],["accordingly",{"2":{"64":1}}],["account",{"2":{"70":1,"72":1}}],["accurary",{"2":{"73":1}}],["accuratearithmetic",{"2":{"11":2}}],["accurate",{"0":{"11":1},"2":{"11":3,"175":1}}],["accumulators",{"2":{"60":1}}],["accumulator",{"2":{"60":1}}],["accumulate",{"2":{"56":1,"63":3}}],["accumulation",{"0":{"11":1},"2":{"60":1}}],["after",{"2":{"6":8,"53":1,"64":3,"153":1,"154":1,"180":2}}],["ab",{"2":{"64":3,"70":1,"72":1,"73":5,"75":1}}],["able",{"2":{"20":1,"73":1}}],["ability",{"2":{"17":1}}],["about",{"2":{"6":1,"24":2,"30":1,"60":2,"116":1,"153":1,"158":1,"161":1}}],["above",{"2":{"4":1,"6":1,"53":1,"63":1,"64":1,"73":1,"76":1,"165":1}}],["abs",{"2":{"53":1,"56":4,"63":1,"69":2,"105":8,"122":2,"146":1,"183":1,"200":1}}],["absolutely",{"2":{"154":1}}],["absolute",{"2":{"4":1,"6":1,"55":1,"56":2}}],["abstractarray",{"2":{"153":4,"154":2,"156":1,"189":2}}],["abstractarrays",{"2":{"151":1}}],["abstractrange",{"2":{"146":6}}],["abstractmulticurvetrait",{"2":{"97":1,"98":1,"114":1,"115":1,"131":1,"132":1,"141":1,"142":1}}],["abstractmatrix",{"2":{"6":5,"146":13}}],["abstractpolygontrait",{"2":{"85":1}}],["abstractcurvetrait",{"2":{"53":1,"56":1,"69":1,"93":1,"96":1,"97":1,"105":1,"110":1,"114":1,"127":1,"130":1,"131":1,"137":1,"140":1,"141":1,"145":1,"180":2,"189":3}}],["abstractwkbgeomtrait",{"2":{"32":1}}],["abstractfloat",{"2":{"31":1,"53":1,"56":2,"64":1,"67":1,"69":2,"70":1,"72":1,"73":1,"75":1,"85":8}}],["abstract",{"2":{"6":3,"32":1,"60":3,"158":2,"160":3,"164":1,"165":4,"166":1,"180":3}}],["abstractvector",{"2":{"5":1,"6":1,"60":26,"146":8}}],["abstractgeometrytrait`",{"2":{"165":1}}],["abstractgeometrytrait",{"2":{"6":2,"32":1,"56":2,"69":1,"85":1,"98":1,"115":1,"132":1,"142":1,"151":1,"156":1,"165":4,"166":2,"189":5}}],["abstractgeometry",{"2":{"3":4,"6":4,"32":1,"101":2,"104":2}}],["abstracttrait",{"2":{"1":2,"3":2,"6":2,"67":1,"71":2,"73":4,"76":2,"122":4,"148":1,"150":2,"153":1,"154":2,"156":11,"159":3}}],["abstractbarycentriccoordinatemethod",{"2":{"0":1,"5":1,"6":7,"60":18}}],["attribute",{"2":{"195":1}}],["attributed",{"2":{"194":1}}],["attributes",{"0":{"194":1},"2":{"190":1,"194":3}}],["attempt",{"2":{"158":1}}],["attempts",{"2":{"116":1}}],["attach",{"2":{"1":2,"4":1,"6":4,"150":1,"155":1}}],["atomic",{"2":{"7":1}}],["at",{"2":{"3":4,"5":1,"6":6,"9":1,"18":1,"20":1,"24":1,"26":1,"53":2,"55":1,"56":1,"59":1,"60":2,"64":4,"69":2,"73":8,"76":2,"81":1,"116":17,"122":6,"124":1,"125":1,"128":3,"129":2,"130":2,"131":1,"132":1,"135":1,"141":1,"145":1,"151":1,"153":1,"175":1,"177":1,"182":1,"184":1,"192":1,"193":2}}],["arbitrarily",{"2":{"151":1}}],["arbitrary",{"2":{"58":1,"148":1,"154":1,"191":1}}],["around",{"2":{"59":1,"60":2,"67":1,"84":1,"88":1,"146":1,"180":1,"198":1}}],["argmin",{"2":{"184":1}}],["arg",{"2":{"177":1}}],["argtypes",{"2":{"57":2,"173":1,"176":1}}],["args",{"2":{"13":2}}],["argumenterror",{"2":{"76":1,"146":1,"153":1,"154":1,"156":3}}],["argument",{"2":{"4":5,"6":10,"53":1,"56":2,"63":1,"69":1,"70":1,"72":1,"75":1,"85":2,"153":1,"156":1,"187":2,"192":1,"193":1}}],["arguments",{"2":{"1":1,"3":1,"6":5,"64":1,"91":2,"108":1,"125":1,"135":1,"172":1,"176":2,"177":1,"187":1}}],["arithmetic",{"2":{"11":1}}],["archgdal",{"2":{"23":1}}],["arc",{"2":{"6":1,"176":1}}],["array",{"2":{"4":1,"6":2,"56":1,"69":1,"146":5,"153":5,"154":2,"181":1,"184":1}}],["arrays",{"2":{"1":1,"6":1,"22":1,"146":1,"150":1,"154":2}}],["aren",{"2":{"4":3,"6":5,"67":1,"71":1,"73":2,"76":4,"88":3,"166":2,"169":2}}],["are",{"2":{"1":1,"3":4,"4":18,"5":2,"6":46,"9":2,"20":2,"22":3,"24":1,"25":1,"26":2,"27":1,"52":1,"53":8,"55":1,"56":2,"58":6,"60":11,"62":1,"63":3,"64":31,"67":3,"69":6,"70":3,"71":15,"72":2,"73":16,"75":5,"76":9,"81":3,"84":1,"85":1,"87":3,"88":26,"91":7,"93":1,"94":3,"95":3,"96":1,"98":1,"100":1,"107":1,"108":5,"110":1,"111":1,"112":1,"114":1,"115":1,"116":12,"122":7,"125":5,"127":1,"129":2,"134":1,"135":5,"137":1,"138":3,"139":3,"140":1,"142":1,"145":1,"146":14,"147":1,"150":1,"151":1,"153":6,"156":4,"157":1,"158":4,"159":1,"161":1,"162":1,"163":1,"165":1,"166":3,"167":1,"168":1,"169":2,"170":1,"175":1,"176":1,"177":1,"180":4,"182":1,"184":2,"186":2,"187":1,"188":1,"191":1,"194":2,"195":2,"196":1,"197":3,"198":6,"199":1,"200":1}}],["area2",{"2":{"63":4}}],["area1",{"2":{"63":4}}],["areas",{"2":{"4":2,"6":2,"56":3,"158":1,"183":2}}],["area",{"0":{"54":2,"55":2},"1":{"55":2,"56":2},"2":{"0":5,"4":15,"6":25,"11":6,"31":1,"54":2,"55":9,"56":61,"61":1,"62":3,"63":49,"68":2,"69":44,"75":2,"76":1,"122":1,"148":1,"154":1,"158":2,"166":2,"169":2,"180":2,"183":4,"192":1}}],["asked",{"2":{"153":1}}],["ask",{"2":{"23":1}}],["aspect",{"2":{"13":1,"14":1,"52":1,"55":1,"59":2,"62":1,"68":1,"84":2,"146":2,"175":1,"180":1}}],["assign",{"2":{"190":1}}],["assigned",{"2":{"64":1,"146":7,"198":1}}],["assets",{"2":{"192":1}}],["assetpath",{"2":{"192":1}}],["assemble",{"2":{"163":1}}],["assert",{"2":{"60":23,"63":1,"64":1,"67":1,"71":1,"73":1,"177":2,"189":1}}],["assume",{"2":{"122":2,"153":3,"154":1,"162":1,"169":1}}],["assumed",{"2":{"56":1,"88":1,"116":1}}],["assumes",{"2":{"6":3,"64":1,"85":1,"176":1,"177":2,"184":1}}],["associativity",{"2":{"19":1}}],["associated",{"0":{"1":1},"2":{"58":2}}],["as",{"2":{"1":8,"3":18,"4":6,"5":1,"6":74,"7":1,"11":2,"13":3,"14":3,"15":3,"17":2,"18":2,"20":1,"22":1,"23":2,"24":1,"25":1,"27":1,"52":2,"53":4,"55":2,"56":3,"57":3,"58":4,"59":1,"60":4,"62":2,"63":1,"64":15,"66":3,"67":5,"68":2,"69":5,"70":8,"71":2,"72":7,"73":8,"75":7,"76":5,"77":1,"79":2,"80":2,"81":3,"82":3,"84":3,"85":1,"87":2,"88":2,"90":3,"91":3,"100":2,"101":2,"103":2,"104":2,"105":2,"107":2,"108":3,"116":7,"118":2,"119":2,"121":2,"122":2,"124":2,"125":3,"127":1,"134":2,"135":3,"145":8,"146":3,"148":3,"150":2,"151":2,"152":2,"153":10,"154":4,"156":4,"158":4,"159":2,"160":2,"162":2,"163":2,"165":1,"166":1,"168":2,"170":1,"172":3,"174":2,"175":2,"176":3,"177":1,"178":2,"179":2,"180":7,"182":2,"185":3,"187":2,"189":2,"190":3,"191":2,"192":1,"193":1,"195":3,"196":3,"197":2,"198":3,"199":2}}],["alone",{"2":{"153":1}}],["along",{"2":{"4":4,"6":5,"64":3,"69":2,"73":4,"88":4,"116":1}}],["although",{"2":{"138":1,"139":1}}],["alternate",{"2":{"64":1}}],["alternative",{"2":{"64":1}}],["already",{"2":{"88":1,"116":2,"153":1,"182":1}}],["almost",{"2":{"73":1}}],["alg=nothing",{"2":{"180":1}}],["alg`",{"2":{"180":1}}],["alg",{"2":{"6":4,"32":2,"180":21,"181":3,"182":8,"183":3,"184":7,"187":9}}],["algorithms",{"2":{"6":3,"77":1,"81":1,"162":1,"177":1,"178":1,"180":4,"182":1,"184":1}}],["algorithm",{"0":{"181":1,"182":1,"183":1},"2":{"6":12,"59":1,"64":2,"67":3,"69":1,"70":1,"72":1,"75":1,"77":1,"82":4,"116":1,"178":1,"180":8,"181":1,"182":3,"183":1,"187":4}}],["allocating",{"2":{"82":1}}],["allocations",{"2":{"5":1,"6":1,"60":1}}],["allocate",{"2":{"82":1}}],["allow=",{"2":{"116":1}}],["allows",{"2":{"11":1,"18":1,"23":1,"24":1,"29":1,"91":2,"93":3,"94":3,"95":3,"96":1,"108":2,"110":3,"111":3,"112":2,"113":1,"125":1,"128":1,"129":1,"130":1,"135":3,"137":3,"138":3,"139":3,"140":1,"148":1,"178":1,"192":1,"194":1,"197":1}}],["allowed",{"2":{"6":1,"91":3,"108":3,"116":6,"125":5,"127":1,"128":2,"135":3,"180":1}}],["allow",{"2":{"1":1,"6":1,"23":1,"73":1,"91":7,"105":3,"108":7,"116":73,"125":10,"135":10,"177":1,"185":1}}],["all",{"2":{"1":3,"3":2,"4":3,"6":12,"9":1,"11":7,"22":1,"25":1,"27":1,"31":2,"53":5,"56":3,"60":1,"64":13,"69":3,"70":1,"71":3,"73":3,"76":5,"77":1,"80":3,"82":1,"84":1,"88":2,"94":3,"95":3,"98":1,"100":1,"114":1,"115":1,"116":7,"122":4,"134":1,"142":1,"145":1,"146":3,"147":1,"150":1,"151":2,"152":1,"153":7,"154":1,"156":2,"158":1,"163":1,"165":1,"167":1,"170":1,"171":1,"180":1,"185":2,"186":1,"188":1,"191":1,"193":1,"195":1,"197":1}}],["always",{"2":{"1":7,"4":6,"6":8,"25":1,"27":1,"55":1,"56":4,"69":2,"81":1,"84":1,"85":1,"88":1,"150":2,"153":3,"154":1,"172":4,"197":1}}],["also",{"2":{"1":2,"6":9,"23":1,"53":1,"56":2,"63":2,"64":3,"69":1,"70":1,"72":1,"73":2,"75":1,"77":1,"81":1,"82":1,"84":1,"85":2,"88":3,"122":1,"146":1,"150":1,"151":1,"153":1,"159":1,"163":1,"166":3,"169":2,"173":1,"174":1,"175":1,"176":1,"178":1,"185":1,"191":2,"194":1}}],["a",{"0":{"23":1,"192":1,"194":1},"2":{"1":13,"3":5,"4":79,"5":1,"6":187,"7":3,"9":1,"11":1,"15":2,"17":1,"18":6,"20":3,"22":3,"23":4,"24":2,"25":2,"27":2,"29":2,"30":2,"32":4,"35":3,"36":3,"37":3,"38":3,"40":2,"41":2,"42":2,"43":2,"44":2,"45":2,"46":2,"47":2,"48":2,"49":2,"52":3,"53":22,"55":11,"56":20,"57":2,"58":13,"59":4,"60":11,"62":5,"63":8,"64":281,"66":3,"67":4,"68":2,"69":17,"70":39,"71":30,"72":38,"73":91,"74":3,"75":36,"76":45,"77":3,"79":3,"80":2,"81":1,"82":4,"84":15,"85":27,"87":2,"88":54,"90":1,"91":3,"93":5,"94":3,"95":2,"97":2,"98":2,"100":2,"103":2,"105":1,"107":1,"108":3,"110":4,"111":3,"112":1,"114":2,"115":2,"116":52,"118":2,"121":5,"122":27,"124":2,"125":4,"127":4,"128":2,"129":2,"130":1,"131":2,"132":2,"134":1,"135":3,"137":5,"138":2,"139":2,"141":2,"142":2,"144":1,"145":4,"146":79,"148":4,"150":4,"151":4,"153":27,"154":6,"156":7,"158":11,"159":6,"160":6,"161":6,"162":2,"163":2,"164":5,"165":5,"166":9,"167":8,"169":6,"170":2,"171":3,"172":8,"173":3,"174":5,"175":4,"176":8,"177":10,"179":3,"180":5,"183":3,"184":1,"185":2,"187":12,"188":1,"189":2,"190":1,"191":21,"192":12,"193":5,"194":5,"195":11,"196":1,"197":5,"198":8,"199":3,"200":3}}],["apart",{"2":{"169":1}}],["april",{"0":{"7":1}}],["appears",{"2":{"162":1}}],["append",{"2":{"53":1,"64":5,"70":1,"71":2,"73":2,"75":1,"76":5,"169":2}}],["approximately",{"2":{"64":1,"175":1}}],["approach",{"2":{"19":1}}],["appropriately",{"2":{"198":1}}],["appropriate",{"2":{"6":1,"187":2}}],["applies",{"2":{"151":2}}],["applied",{"2":{"6":1,"20":1,"156":4,"164":2,"165":2,"166":1}}],["application",{"2":{"1":1,"6":2,"150":1,"154":1,"163":1,"165":3,"166":1,"169":2,"174":1,"177":1}}],["apply`",{"2":{"153":1}}],["applys",{"2":{"56":1,"69":1}}],["applyreduce",{"0":{"19":1,"154":1},"2":{"0":1,"1":1,"17":1,"19":2,"29":1,"31":2,"53":1,"56":1,"63":2,"69":1,"85":2,"148":1,"150":1,"154":42,"160":1}}],["apply",{"0":{"1":1,"18":1,"22":1,"29":1,"148":1,"151":1},"1":{"19":1,"149":1,"150":1,"151":1,"152":1,"153":1},"2":{"0":1,"1":4,"6":3,"17":1,"18":5,"20":1,"22":1,"24":1,"29":3,"31":3,"32":2,"148":5,"150":3,"151":4,"152":1,"153":55,"154":5,"155":1,"156":3,"158":1,"160":1,"165":4,"166":1,"170":1,"171":3,"172":1,"176":1,"177":1,"180":2,"185":3,"188":2}}],["apis",{"2":{"17":1}}],["api",{"0":{"0":1,"60":1},"1":{"1":1,"2":1,"3":1,"4":1,"5":1,"6":1},"2":{"0":1,"6":3,"24":1,"60":1,"176":1,"180":1,"187":1}}],["annotation",{"2":{"160":1}}],["annotated",{"2":{"26":1}}],["angular",{"2":{"158":1}}],["angels",{"2":{"53":1}}],["angle",{"2":{"53":35,"145":1}}],["angles",{"0":{"51":1,"52":1},"1":{"52":1,"53":1},"2":{"0":2,"4":10,"6":10,"31":1,"51":1,"52":4,"53":42}}],["answers",{"2":{"167":1}}],["answer",{"2":{"6":3,"70":1,"72":1,"73":1,"75":1}}],["another",{"2":{"3":1,"6":1,"64":2,"73":1,"82":1,"84":1,"90":1,"93":1,"95":1,"96":1,"100":1,"103":1,"107":1,"110":1,"111":1,"112":1,"113":1,"116":1,"118":1,"121":1,"122":1,"124":1,"127":1,"128":1,"129":1,"130":1,"134":1,"137":1,"138":1,"139":1,"140":1,"146":1,"172":1}}],["anonymous",{"2":{"1":1,"6":1,"185":1}}],["an",{"2":{"1":3,"4":11,"5":1,"6":27,"9":1,"13":1,"14":1,"18":1,"20":1,"23":2,"32":1,"52":1,"53":4,"55":1,"56":2,"57":2,"59":1,"60":3,"62":1,"64":15,"66":1,"67":1,"68":2,"69":2,"70":2,"71":5,"72":2,"73":9,"75":2,"76":2,"82":3,"84":2,"85":5,"87":1,"88":1,"90":2,"93":2,"100":1,"103":1,"107":1,"116":13,"118":1,"121":1,"122":1,"124":1,"134":1,"137":2,"138":1,"139":1,"146":3,"147":1,"150":1,"151":1,"152":1,"153":5,"154":2,"156":2,"158":1,"163":1,"170":1,"172":1,"176":1,"185":2,"187":3,"189":1,"191":2,"192":2,"194":1,"196":1,"198":1}}],["anything",{"2":{"59":1,"116":1}}],["any",{"2":{"1":3,"3":1,"4":2,"6":17,"18":1,"24":1,"25":1,"27":1,"29":1,"58":2,"63":1,"64":7,"67":1,"69":1,"71":1,"73":4,"76":1,"85":2,"92":2,"93":1,"96":1,"107":1,"109":2,"110":1,"111":2,"112":1,"113":2,"116":8,"122":2,"126":2,"136":2,"140":1,"146":2,"148":2,"150":1,"153":2,"154":2,"156":2,"163":1,"164":1,"165":3,"166":4,"169":4,"172":2,"174":1,"176":1,"177":1,"182":1,"189":1,"197":3,"198":2}}],["and",{"0":{"1":1,"20":1,"22":1,"24":1,"54":1,"71":1,"73":1,"76":1,"83":1,"191":1,"192":1,"194":1},"1":{"55":1,"56":1,"84":1,"85":1},"2":{"0":2,"1":8,"3":11,"4":18,"6":79,"7":1,"9":2,"17":4,"18":4,"20":2,"22":1,"23":2,"24":3,"25":2,"26":5,"27":2,"29":2,"30":1,"31":2,"32":2,"33":1,"53":13,"55":1,"56":7,"57":1,"58":2,"59":2,"60":20,"61":2,"62":1,"63":29,"64":71,"66":1,"67":4,"68":2,"69":18,"70":4,"71":16,"72":4,"73":38,"75":6,"76":15,"81":1,"82":2,"84":2,"85":13,"87":2,"88":13,"90":2,"91":3,"94":3,"95":4,"96":1,"100":3,"101":2,"103":2,"104":2,"105":1,"108":3,"111":3,"112":1,"113":1,"116":36,"118":1,"121":2,"122":3,"125":2,"129":2,"130":2,"134":3,"135":4,"137":2,"138":3,"139":3,"140":1,"145":2,"146":16,"148":6,"150":5,"151":2,"152":3,"153":16,"154":10,"156":3,"157":1,"158":14,"159":1,"160":3,"161":1,"162":2,"163":1,"164":1,"165":4,"166":2,"167":1,"170":2,"171":2,"172":2,"175":1,"176":5,"177":7,"178":2,"179":1,"180":8,"182":8,"183":1,"184":1,"185":1,"187":4,"190":3,"191":9,"192":7,"193":2,"195":5,"197":2,"198":4,"199":2}}],["snapped",{"2":{"146":1}}],["s3",{"2":{"64":3}}],["scratch",{"2":{"195":1}}],["sciences",{"2":{"192":1}}],["scalefactor",{"2":{"176":3}}],["scattered",{"2":{"198":1}}],["scatter",{"2":{"62":1,"84":2,"87":2,"90":1,"100":2,"103":1,"107":2,"121":2,"134":2,"198":1}}],["schema",{"2":{"153":5,"154":1}}],["scheme",{"2":{"63":1}}],["scenario",{"2":{"116":2}}],["scene",{"2":{"14":1}}],["skipmissing",{"2":{"146":1}}],["skipped",{"2":{"146":1}}],["skip",{"2":{"56":1,"116":14,"146":1,"153":1,"184":4}}],["skygering",{"2":{"7":1}}],["square",{"2":{"85":1,"181":1,"182":1}}],["squared",{"2":{"6":2,"69":2,"85":12,"181":2,"182":7}}],["sqrt",{"2":{"53":2,"63":1,"85":3}}],["sgn",{"2":{"53":5}}],["smallest",{"2":{"53":2,"73":1,"77":1}}],["sᵢ₋₁",{"2":{"60":25}}],["sᵢ₊₁",{"2":{"6":2,"60":41}}],["sᵢ",{"2":{"6":4,"60":46}}],["src",{"2":{"6":2}}],["syntax",{"2":{"194":1}}],["sym10100477",{"2":{"116":1}}],["symdifference",{"2":{"38":1,"147":1}}],["symmetric",{"0":{"38":1},"2":{"38":1}}],["symbol=",{"2":{"105":1}}],["symbol",{"2":{"6":1,"187":2}}],["system",{"0":{"192":1,"193":1},"2":{"1":2,"172":2,"190":2,"192":1}}],["switches",{"2":{"73":1,"76":1}}],["switch",{"2":{"64":1,"76":1,"160":1}}],["switching",{"2":{"6":1,"69":1}}],["swap",{"2":{"6":1,"76":1,"85":2,"171":1}}],["swapped",{"2":{"3":1,"6":1,"91":1,"101":1,"104":1,"105":1,"119":1,"122":1}}],["swapping",{"2":{"1":1,"150":1,"153":1}}],["s2",{"2":{"6":4,"60":6,"64":3}}],["s1",{"2":{"6":3,"60":6,"64":3}}],["saving",{"0":{"195":1}}],["saved",{"2":{"88":1}}],["save",{"2":{"53":1,"190":1,"195":3}}],["samples",{"2":{"13":1}}],["sample",{"2":{"13":1}}],["same",{"2":{"3":2,"4":12,"6":22,"18":1,"53":3,"56":1,"64":15,"67":1,"69":1,"70":3,"72":1,"73":1,"75":1,"76":1,"81":1,"84":1,"87":2,"88":30,"116":2,"121":1,"122":8,"151":1,"153":5,"156":2,"161":1,"166":2,"168":1,"169":2,"175":1,"191":1,"192":1,"195":1}}],["says",{"2":{"81":1}}],["say",{"2":{"6":1,"60":1,"176":1}}],["spliced",{"2":{"155":1}}],["split",{"2":{"67":1}}],["sp",{"2":{"116":2}}],["specify",{"2":{"156":2,"192":1,"193":1,"197":1}}],["specification",{"2":{"162":1,"165":1,"167":1,"168":1}}],["specifically",{"2":{"6":2,"60":3,"178":1,"197":1}}],["specific",{"2":{"64":1,"91":1,"108":1,"125":1,"135":1,"153":1,"154":1,"156":3,"158":1}}],["specified",{"2":{"3":1,"6":2,"64":1,"71":2,"73":2,"76":2,"122":1,"151":1,"180":1}}],["specialized",{"2":{"25":1,"27":1,"82":1,"153":1}}],["sphere",{"2":{"6":1,"158":3,"177":1}}],["sphericalgeodesics",{"2":{"158":1}}],["spherical",{"2":{"6":1,"31":2,"158":7,"177":1}}],["spatial",{"0":{"197":1},"1":{"198":1,"199":1,"200":1},"2":{"197":6,"198":3,"200":1}}],["spawn",{"2":{"153":3,"154":3}}],["span>",{"2":{"6":2}}],["span",{"2":{"6":2,"198":1}}],["space",{"2":{"6":1,"25":1,"27":1,"53":1,"55":1,"116":1,"158":5,"176":1}}],["slow",{"2":{"199":1}}],["slower",{"2":{"6":1,"187":2}}],["slope2",{"2":{"145":2}}],["slope1",{"2":{"145":2}}],["slidergrid",{"2":{"14":1}}],["sliders",{"2":{"14":3}}],["slightly",{"2":{"4":2,"6":2,"56":2}}],["suite",{"2":{"176":5,"180":13}}],["suggestion",{"2":{"173":1}}],["success",{"2":{"158":1}}],["such",{"2":{"4":1,"6":1,"55":1,"66":1,"77":1,"151":1,"170":1}}],["sun",{"2":{"116":1}}],["surrounds",{"2":{"116":1}}],["sure",{"2":{"9":1,"53":1,"64":2,"85":1,"122":1,"184":1}}],["suppose",{"2":{"199":1,"200":1}}],["supports",{"2":{"59":1,"60":1,"77":1,"153":3,"195":1,"200":2}}],["support",{"2":{"32":1,"57":1,"174":1,"200":1}}],["supported",{"2":{"23":1,"195":1}}],["supertype",{"2":{"6":1,"60":1}}],["sukumar",{"2":{"6":1,"60":1}}],["sum=1",{"2":{"60":1}}],["summary>",{"2":{"6":4}}],["sum",{"2":{"4":2,"6":3,"11":6,"55":1,"56":2,"58":2,"60":8,"69":1,"85":2,"145":5,"184":1,"189":4}}],["sublevel",{"2":{"199":1}}],["subsequent",{"2":{"191":1}}],["substituted",{"2":{"1":1,"150":1,"153":1}}],["subgeom1",{"2":{"156":2}}],["subgeom",{"2":{"156":3}}],["subject",{"2":{"64":1}}],["subtype",{"2":{"153":1}}],["subtypes",{"2":{"6":2,"60":2}}],["subtracted",{"2":{"145":1}}],["subtitle",{"2":{"13":1,"59":2,"176":1,"180":2}}],["sub",{"2":{"4":6,"6":7,"53":1,"56":3,"69":1,"71":6,"73":3,"76":4,"85":2,"97":2,"98":2,"114":2,"115":2,"131":2,"132":2,"141":2,"142":2,"153":3,"167":4,"168":2,"169":4}}],["series",{"2":{"191":1}}],["serve",{"2":{"6":1,"60":1}}],["searchsortedfirst",{"2":{"182":1}}],["semimajor",{"2":{"158":3}}],["seg2",{"2":{"145":2}}],["seg1",{"2":{"145":3}}],["seg",{"2":{"116":23,"122":9}}],["segmentation",{"2":{"175":1}}],["segments",{"2":{"23":1,"31":1,"52":2,"53":1,"62":1,"63":2,"64":3,"69":1,"73":6,"116":18,"176":1,"177":3}}],["segmentization",{"2":{"32":1,"158":1,"174":1}}],["segmentizing",{"2":{"6":3,"175":1,"176":2,"177":1}}],["segmentizemethod",{"2":{"176":3,"177":1}}],["segmentized",{"2":{"175":1}}],["segmentizes",{"2":{"174":1}}],["segmentize",{"0":{"32":1,"174":1},"1":{"175":1,"176":1,"177":1},"2":{"0":1,"6":4,"31":1,"32":9,"57":1,"148":1,"158":1,"174":1,"175":5,"176":11,"177":18,"196":1}}],["segment",{"2":{"4":4,"6":7,"53":1,"63":5,"64":6,"66":1,"69":3,"73":17,"85":2,"105":3,"116":43,"122":3,"145":2,"174":1,"176":2,"177":1}}],["seperate",{"2":{"73":1}}],["separates",{"2":{"116":1}}],["separate",{"2":{"64":1,"146":1,"153":1,"160":1,"195":1,"198":1}}],["separately",{"2":{"60":1,"146":1}}],["sense",{"2":{"56":1,"85":1}}],["several",{"2":{"20":2,"56":1,"161":1,"169":1}}],["select",{"2":{"159":1}}],["selected",{"2":{"146":1}}],["selectednode",{"2":{"146":3}}],["selection",{"2":{"14":1}}],["self",{"2":{"9":2}}],["section",{"2":{"26":1,"116":3,"121":1}}],["sections",{"2":{"10":1,"26":1}}],["seconds=1",{"2":{"176":3,"180":8}}],["secondisleft",{"2":{"146":4}}],["secondisstraight",{"2":{"146":7}}],["secondary",{"2":{"3":3,"6":3,"91":1,"101":1,"135":1}}],["second",{"2":{"3":8,"6":9,"64":1,"73":4,"88":1,"90":1,"91":1,"94":1,"95":1,"96":1,"100":2,"101":1,"104":2,"108":2,"116":2,"125":1,"134":1,"135":1,"138":1,"139":1,"140":2,"182":1,"193":1,"197":1}}],["seem",{"2":{"25":1,"27":1}}],["see",{"2":{"6":4,"7":1,"29":1,"62":1,"82":1,"85":1,"87":1,"90":1,"100":1,"107":1,"116":5,"118":1,"121":1,"124":1,"134":1,"146":2,"162":1,"163":1,"165":1,"166":3,"168":1,"169":2,"175":2,"182":1,"198":2}}],["setup=",{"2":{"91":1,"108":1,"125":1,"135":1}}],["sets",{"2":{"64":1,"81":1}}],["setting",{"2":{"23":1}}],["set",{"0":{"23":1,"34":1},"1":{"35":1,"36":1,"37":1,"38":1},"2":{"3":2,"4":7,"6":19,"23":1,"53":1,"58":2,"60":8,"64":3,"70":2,"72":2,"73":7,"75":2,"77":2,"87":2,"88":10,"91":1,"105":1,"108":1,"116":2,"122":1,"125":1,"135":1,"145":1,"146":1,"153":5,"166":2,"169":2,"182":2,"191":1,"195":1,"198":3}}],["sve",{"2":{"1":1,"6":1,"185":1}}],["svector",{"2":{"1":14,"6":14,"64":5,"70":1,"73":2,"76":6,"116":1,"146":1,"185":13,"191":6,"193":4}}],["solution",{"2":{"116":1}}],["south",{"2":{"69":7,"158":1}}],["source",{"2":{"1":10,"3":19,"4":22,"5":3,"6":84,"26":4,"105":2,"150":2,"156":4,"165":1,"166":4,"172":3,"192":13,"193":1}}],["sort",{"2":{"64":4,"67":2,"73":2,"75":2,"116":1,"122":2,"146":1,"182":1}}],["sorted",{"2":{"20":1,"64":1,"182":7,"197":1}}],["someone",{"2":{"82":1,"187":1}}],["something",{"0":{"74":1},"2":{"10":1}}],["some",{"2":{"3":1,"6":4,"9":1,"17":1,"60":4,"88":1,"116":3,"122":1,"146":1,"147":1,"148":1,"151":2,"153":2,"154":1,"164":1,"165":2,"166":1,"177":1,"184":1,"186":2,"190":2,"197":1,"200":1}}],["so",{"2":{"1":1,"4":4,"6":9,"9":1,"17":1,"19":1,"25":1,"27":1,"31":1,"59":1,"60":1,"64":1,"68":1,"73":1,"75":2,"76":2,"84":1,"85":1,"87":1,"88":4,"100":1,"107":1,"116":2,"118":1,"134":1,"146":3,"153":8,"156":2,"174":1,"175":1,"176":3,"177":1,"184":1,"185":1,"187":2,"192":1,"193":1}}],["styles",{"2":{"153":1}}],["style",{"2":{"153":7}}],["step",{"2":{"64":7,"70":1,"71":3,"72":1,"73":3,"75":1,"76":3,"146":6,"189":1}}],["storing",{"2":{"195":1}}],["stored",{"2":{"64":2,"198":1}}],["stores",{"2":{"64":1}}],["store",{"2":{"60":1,"195":1}}],["stopping",{"2":{"182":2}}],["stops",{"2":{"151":1}}],["stop",{"2":{"18":2,"105":3,"116":4,"122":3}}],["stay",{"2":{"76":1}}],["stackoverflow",{"2":{"73":1}}],["stack",{"2":{"67":1}}],["states",{"2":{"180":1}}],["state",{"2":{"75":1,"199":9}}],["status",{"2":{"64":31,"71":4,"73":5,"76":4,"146":1}}],["static",{"2":{"160":1}}],["staticarray",{"2":{"60":1}}],["staticarrays",{"2":{"31":1,"64":5,"70":1,"73":2,"76":6,"116":1,"146":1,"185":2}}],["staticarraysco",{"2":{"1":1,"6":1,"185":1}}],["staticarrayscore",{"2":{"1":10,"6":10,"60":1,"185":10,"191":6,"193":4}}],["statica",{"2":{"1":1,"6":1,"185":1}}],["statistics",{"2":{"13":2,"31":1}}],["stability",{"2":{"23":1,"30":1}}],["stable",{"2":{"13":1,"24":1,"177":1}}],["stage",{"2":{"7":1}}],["standardized",{"2":{"116":1}}],["standards",{"2":{"116":1}}],["standard",{"2":{"6":1,"82":1,"158":1}}],["started",{"2":{"64":1}}],["starting",{"2":{"63":2,"64":1,"69":1,"73":1,"169":4}}],["startvalue",{"2":{"14":4}}],["start",{"2":{"6":1,"18":1,"53":7,"60":1,"64":76,"69":17,"71":4,"73":4,"76":5,"88":1,"105":4,"116":44,"122":3,"137":1,"146":2,"161":1,"182":16,"191":1}}],["straightline",{"2":{"146":3}}],["straight",{"2":{"146":6,"154":1}}],["strait",{"2":{"146":1}}],["structs",{"2":{"20":1,"165":1}}],["structures",{"2":{"148":1}}],["structure",{"2":{"6":1,"148":1,"156":2,"171":1}}],["struct",{"2":{"6":2,"60":2,"64":2,"82":1,"158":3,"159":3,"160":6,"163":1,"169":2,"176":2,"181":1,"182":1,"183":1,"187":4}}],["strings",{"2":{"6":1,"63":1,"73":1}}],["string",{"2":{"1":2,"14":1,"62":1,"63":1,"172":2}}],["still",{"2":{"0":1,"56":1,"63":1,"64":3,"90":1,"182":1}}],["shp",{"2":{"195":1}}],["ships",{"2":{"192":1}}],["shifting",{"2":{"193":1}}],["shift",{"2":{"191":3}}],["shewchuck",{"2":{"7":1}}],["short",{"2":{"153":1}}],["shorthand",{"2":{"82":1}}],["show",{"2":{"9":1,"11":1,"13":1,"14":1,"59":1,"192":1,"195":1,"197":2}}],["shoelace",{"2":{"4":1,"6":1,"56":2,"69":1}}],["shouldn",{"2":{"73":1}}],["should",{"2":{"1":1,"4":1,"6":12,"17":1,"18":1,"20":2,"25":1,"27":1,"32":1,"53":3,"56":1,"63":1,"64":3,"68":1,"88":1,"116":4,"146":2,"150":1,"153":2,"156":2,"158":1,"160":1,"162":1,"165":4,"166":2,"177":2,"180":2}}],["sharing",{"2":{"107":1}}],["shares",{"2":{"73":1}}],["share",{"2":{"4":7,"6":8,"87":2,"88":8,"111":2,"112":1,"113":1,"122":1,"130":1}}],["shared",{"0":{"184":1},"2":{"3":1,"6":1,"64":2,"73":2,"122":3}}],["shapes",{"2":{"85":1,"195":7}}],["shape",{"2":{"62":1,"71":1,"73":1,"87":1,"158":1,"168":1,"191":1}}],["shaped",{"2":{"59":1}}],["shapefiles",{"2":{"195":1}}],["shapefile",{"2":{"29":1,"195":4}}],["shallower",{"2":{"1":1,"150":1,"153":1}}],["sites",{"2":{"199":1}}],["sides",{"2":{"64":3,"162":1}}],["side",{"2":{"53":4,"64":26}}],["signals",{"2":{"152":1}}],["sign",{"2":{"13":2,"14":2,"53":7,"56":2,"145":3}}],["signed",{"0":{"54":1,"55":1,"83":1,"84":1},"1":{"55":1,"56":1,"84":1,"85":1},"2":{"0":4,"4":15,"6":18,"11":3,"54":1,"55":5,"56":23,"69":3,"83":1,"84":7,"85":19}}],["six",{"2":{"6":1,"180":1}}],["size=",{"2":{"192":1}}],["sizehint",{"2":{"64":2,"71":1,"177":1}}],["size",{"2":{"6":4,"13":2,"14":5,"59":1,"76":1,"146":2,"153":2,"154":2,"180":1}}],["sin",{"2":{"191":3,"192":1,"193":2}}],["singed",{"2":{"85":1}}],["singular",{"2":{"73":1}}],["singlepoly",{"2":{"180":6}}],["single",{"2":{"4":6,"6":10,"23":1,"53":2,"56":1,"69":1,"88":5,"121":2,"146":2,"154":1,"166":2,"167":1,"169":2,"191":3,"195":1}}],["since",{"2":{"1":1,"6":2,"26":1,"53":1,"56":1,"63":1,"69":2,"75":1,"85":1,"88":1,"116":1,"122":2,"129":1,"153":1,"160":1,"172":1,"187":2,"199":1}}],["simulation",{"2":{"23":1}}],["simultaneously",{"2":{"20":1}}],["simply",{"2":{"7":1,"55":1,"57":1,"64":1,"73":1,"76":1,"101":1,"104":1,"119":1,"146":1,"164":1,"172":1,"173":1,"176":1,"191":1,"194":1}}],["simpler",{"2":{"6":1,"146":1}}],["simple",{"0":{"33":1,"79":1,"198":1},"1":{"34":1,"35":1,"36":1,"37":1,"38":1,"39":1,"40":1,"41":1,"42":1,"43":1,"44":1,"45":1,"46":1,"47":1,"48":1,"49":1,"50":1},"2":{"6":3,"33":1,"60":1,"82":1,"148":3,"158":1,"160":1,"171":1,"172":1,"179":2,"180":2}}],["simplifier",{"2":{"180":4}}],["simplified",{"2":{"23":1,"179":1}}],["simplifies",{"2":{"6":3,"181":1,"182":1,"183":1}}],["simplification",{"0":{"178":1},"1":{"179":1,"180":1},"2":{"6":2,"178":2,"180":3}}],["simplifying",{"2":{"178":1}}],["simplify",{"0":{"181":1,"182":1,"183":1},"2":{"0":1,"6":15,"9":1,"31":1,"64":1,"148":1,"179":1,"180":41,"181":1,"182":2,"183":1}}],["simplifyalgs",{"2":{"184":1}}],["simplifyalg",{"2":{"0":1,"6":8,"180":5,"181":2,"182":2,"183":2}}],["similarly",{"2":{"148":1}}],["similar",{"2":{"1":1,"6":3,"18":1,"25":1,"27":1,"29":1,"57":1,"77":1,"82":1,"146":2,"150":1,"153":1,"176":2,"177":1,"188":1}}],["s",{"0":{"30":1},"2":{"0":1,"3":1,"6":11,"7":1,"9":1,"18":1,"19":1,"29":1,"53":1,"55":1,"56":4,"58":1,"59":2,"60":5,"62":3,"63":3,"64":3,"66":1,"69":1,"71":1,"73":2,"76":3,"81":1,"85":1,"88":1,"103":2,"110":3,"111":4,"112":2,"116":9,"122":1,"124":1,"125":1,"130":1,"146":5,"148":2,"153":2,"154":1,"159":2,"160":2,"163":1,"166":4,"167":1,"169":3,"175":4,"176":1,"177":2,"178":1,"180":2,"184":4,"187":6,"191":6,"192":4,"193":4,"194":2,"195":5,"200":2}}],["fn",{"2":{"195":8}}],["f``",{"2":{"158":1}}],["fc",{"2":{"153":4,"154":5,"156":13,"180":3,"189":14}}],["fj",{"2":{"146":2}}],["f2",{"2":{"64":2}}],["f1",{"2":{"64":2}}],["f64",{"2":{"13":2,"14":2}}],["few",{"2":{"162":1}}],["fetched",{"2":{"146":1}}],["fetch",{"2":{"32":2,"153":1,"154":1}}],["feb",{"0":{"8":1},"1":{"9":1,"10":1}}],["featurecollection",{"2":{"6":2,"11":1,"18":1,"146":4,"153":6,"156":1,"192":2}}],["featurecollectiontrait",{"2":{"1":1,"150":1,"151":1,"153":3,"154":2,"156":10,"189":5}}],["features",{"0":{"92":1,"109":1,"126":1,"136":1},"2":{"1":1,"6":2,"11":1,"22":1,"82":1,"146":3,"150":1,"152":1,"153":11,"154":6,"156":2,"192":1}}],["featuretrait",{"2":{"1":2,"92":4,"105":2,"109":4,"126":4,"136":4,"150":2,"151":3,"153":3,"154":3,"156":10,"189":5}}],["feature",{"2":{"1":6,"4":1,"6":4,"18":2,"22":1,"56":1,"69":1,"146":2,"148":1,"150":6,"152":1,"153":22,"154":6,"156":22,"180":2,"189":2,"195":1}}],["fra",{"2":{"199":2}}],["frame",{"2":{"194":1}}],["framework",{"2":{"148":4,"154":2}}],["fracs",{"2":{"64":20,"67":1}}],["frac",{"2":{"60":1,"64":2,"73":17,"180":2}}],["fractional",{"2":{"64":1,"73":3}}],["fractions",{"2":{"64":1,"73":4}}],["fraction",{"2":{"6":4,"73":2,"85":1,"180":1}}],["front",{"2":{"53":1}}],["from",{"2":{"1":3,"3":4,"4":16,"6":26,"7":1,"11":1,"20":1,"22":1,"26":1,"31":1,"56":2,"57":1,"59":1,"60":4,"63":1,"64":6,"67":1,"69":11,"70":1,"71":3,"72":1,"73":11,"75":1,"76":6,"82":1,"85":25,"108":2,"110":5,"111":4,"112":2,"113":1,"114":2,"116":6,"122":2,"145":2,"146":7,"153":1,"156":6,"158":1,"160":1,"169":1,"172":4,"174":1,"180":1,"181":1,"182":3,"183":1,"189":1,"190":1,"192":5,"195":1,"197":1,"198":1,"200":1}}],["footprint",{"2":{"193":1}}],["foldable",{"2":{"153":2,"154":1}}],["follows",{"2":{"64":2,"91":1,"108":1,"125":1,"135":1,"146":1}}],["followed",{"2":{"26":1}}],["following",{"2":{"6":1,"60":1,"66":1,"156":1,"162":1,"168":1,"180":1,"197":1}}],["focusing",{"2":{"25":1,"27":1}}],["foundational",{"2":{"17":1}}],["found",{"2":{"6":7,"26":1,"67":1,"69":1,"70":2,"72":2,"73":1,"75":2,"88":1,"146":5,"151":3,"153":2,"154":1,"156":5,"177":2}}],["forward",{"2":{"73":1}}],["forwards",{"2":{"64":1,"71":1,"76":1}}],["formats",{"2":{"190":1,"193":1,"195":3}}],["format",{"2":{"67":1,"195":3}}],["form",{"2":{"18":1,"64":3,"73":8,"76":3,"153":1}}],["formed",{"2":{"4":2,"6":3,"52":1,"53":4,"60":1,"64":8,"75":1,"76":1,"182":1}}],["formulae",{"2":{"6":1,"177":1}}],["formula",{"2":{"4":1,"6":1,"56":2,"69":1}}],["force",{"2":{"1":1,"153":3,"172":1,"180":1}}],["for",{"0":{"71":1,"73":1,"76":1},"2":{"0":2,"1":3,"3":1,"4":4,"5":3,"6":46,"7":4,"9":2,"13":5,"14":1,"18":1,"20":1,"22":1,"23":5,"25":3,"26":1,"27":3,"29":1,"31":2,"32":1,"33":1,"53":5,"56":8,"57":3,"58":1,"59":1,"60":19,"63":7,"64":35,"67":5,"69":11,"70":2,"71":3,"72":1,"73":7,"75":1,"76":9,"77":2,"80":1,"82":3,"84":2,"85":7,"88":13,"91":3,"97":1,"98":1,"103":1,"105":6,"108":2,"114":1,"115":1,"116":22,"121":1,"122":11,"125":2,"131":1,"132":1,"135":3,"141":1,"142":1,"144":1,"145":5,"146":13,"147":1,"148":3,"150":1,"153":7,"154":1,"156":1,"158":1,"159":1,"160":2,"161":3,"162":2,"164":1,"165":5,"167":3,"168":1,"169":5,"170":1,"172":3,"174":4,"175":7,"176":6,"177":10,"178":4,"180":12,"181":2,"182":2,"183":1,"184":6,"187":5,"189":7,"190":1,"192":4,"193":1,"195":3,"197":2,"199":2,"200":1}}],["fi",{"2":{"146":2}}],["fine",{"2":{"175":1}}],["final",{"2":{"76":1,"165":4,"176":1}}],["finally",{"2":{"59":2,"73":1,"146":1,"153":3,"154":1,"195":1}}],["findmin",{"2":{"184":1}}],["findmax",{"2":{"180":1,"182":1}}],["findall",{"2":{"165":1}}],["finding",{"2":{"73":1}}],["findfirst",{"2":{"64":6,"67":2,"80":1,"180":1}}],["findnext",{"2":{"64":3}}],["findlast",{"2":{"64":2}}],["findprev",{"2":{"64":2}}],["finds",{"2":{"64":1,"69":1}}],["find",{"2":{"53":6,"56":1,"64":12,"67":2,"69":3,"70":4,"72":2,"73":8,"75":1,"85":3,"88":1,"116":7,"146":2,"182":5,"199":1}}],["finish",{"2":{"9":1}}],["fill",{"2":{"64":1,"146":1,"177":3}}],["filled",{"2":{"64":5,"69":3,"84":1,"85":2,"116":16}}],["files",{"2":{"186":1,"195":2}}],["file",{"2":{"26":1,"32":1,"33":1,"64":1,"91":3,"108":3,"125":3,"135":3,"146":1,"147":1,"148":1,"154":1,"155":1,"156":1,"164":1,"172":1,"177":1,"178":1,"186":2,"190":1,"195":2}}],["filters",{"2":{"64":1}}],["filtering",{"2":{"6":1,"180":1}}],["filter",{"2":{"4":1,"6":2,"64":2,"153":2,"154":1,"169":2,"170":1,"180":1}}],["fit",{"2":{"17":1}}],["field",{"2":{"13":2,"64":2}}],["figure",{"2":{"13":1,"14":1,"55":1,"59":2,"81":1,"192":3}}],["fig",{"2":{"13":6,"14":6,"81":5,"191":7,"192":4,"196":2}}],["fix1",{"2":{"153":1,"154":1}}],["fixme",{"2":{"145":1}}],["fix2",{"2":{"32":1,"64":2}}],["fixed",{"2":{"6":3,"70":1,"72":1,"75":1}}],["fix",{"0":{"20":1},"2":{"6":9,"9":3,"15":3,"17":1,"20":1,"70":1,"71":11,"72":1,"73":11,"75":1,"76":10,"81":2,"162":1,"164":1,"165":1,"168":1}}],["firstisright",{"2":{"146":2}}],["firstisleft",{"2":{"146":4}}],["firstisstraight",{"2":{"146":4}}],["firstnode",{"2":{"146":9}}],["first",{"2":{"3":9,"6":10,"53":14,"56":7,"57":1,"59":1,"60":9,"63":1,"64":17,"67":1,"69":2,"70":2,"72":1,"73":5,"75":3,"85":8,"88":4,"90":1,"91":2,"94":1,"95":1,"96":1,"100":2,"101":2,"104":2,"108":3,"116":22,"122":1,"125":2,"127":1,"134":1,"135":2,"138":1,"139":1,"140":2,"145":1,"146":16,"153":3,"154":2,"156":2,"162":1,"177":3,"181":1,"182":2,"189":2,"190":1,"191":1,"192":1,"193":1,"197":1,"198":1}}],["flexijoins",{"2":{"197":2,"198":3,"199":1,"200":5}}],["flexible",{"2":{"153":1,"154":1}}],["flags",{"2":{"64":5}}],["flag",{"2":{"64":12,"67":1}}],["flattened",{"2":{"18":1}}],["flatten",{"0":{"156":1},"2":{"11":3,"13":1,"18":1,"31":2,"50":1,"60":1,"64":2,"69":3,"72":1,"76":1,"82":2,"105":1,"156":33,"169":1}}],["flattening`",{"2":{"158":1}}],["flattening",{"2":{"6":4,"154":1,"158":3,"176":2}}],["flat",{"2":{"6":2,"177":1,"184":2,"189":1}}],["floating",{"2":{"6":1,"64":1,"73":5,"146":2}}],["float",{"2":{"6":3,"70":1,"72":1,"75":1}}],["float64x2",{"2":{"13":6,"14":6,"15":2}}],["float64",{"2":{"1":6,"4":10,"6":30,"13":1,"52":1,"53":3,"56":6,"63":1,"67":2,"69":4,"70":2,"72":1,"73":3,"75":1,"81":1,"85":12,"116":4,"122":2,"145":4,"162":6,"168":26,"175":2,"176":2,"177":1,"181":4,"182":9,"183":2,"184":6,"185":6,"188":1,"189":8,"191":190,"192":7,"193":10}}],["flipping",{"0":{"171":1},"2":{"171":1}}],["flipped",{"2":{"1":2,"150":2,"153":2}}],["flipaxis",{"2":{"59":1}}],["flip",{"2":{"0":1,"6":1,"31":1,"148":2,"153":1,"171":2}}],["fancy",{"2":{"191":1}}],["fancis",{"2":{"6":1,"60":1}}],["fair",{"2":{"175":1}}],["fail",{"2":{"1":1,"6":1,"150":1,"153":2,"154":1,"156":3,"176":1}}],["fallback",{"2":{"153":1}}],["falses",{"2":{"64":2,"67":1,"70":1,"72":1}}],["false",{"0":{"24":1},"2":{"1":29,"3":7,"4":3,"6":51,"31":1,"32":2,"35":1,"36":1,"37":1,"38":1,"50":1,"53":2,"56":1,"59":5,"64":26,"67":1,"69":5,"70":1,"71":3,"73":1,"75":4,"85":2,"87":2,"88":27,"91":8,"93":2,"94":4,"95":1,"96":1,"97":1,"98":1,"100":2,"103":2,"105":11,"108":9,"110":1,"111":4,"114":1,"115":1,"116":39,"122":22,"125":8,"127":3,"128":4,"129":1,"131":1,"132":1,"134":1,"135":7,"137":2,"138":4,"139":1,"140":1,"141":1,"142":1,"145":10,"146":5,"150":4,"153":11,"154":7,"156":3,"158":1,"160":3,"162":16,"168":44,"169":4,"177":5,"180":1,"184":2,"185":20,"189":2,"191":242,"192":12,"193":18,"197":1}}],["fashion",{"2":{"55":1}}],["faster",{"2":{"60":1,"153":1}}],["fast",{"2":{"12":1}}],["f",{"2":{"1":12,"6":14,"15":1,"18":3,"19":1,"22":2,"52":1,"55":2,"57":1,"59":4,"62":2,"64":19,"66":2,"68":2,"70":2,"71":2,"72":2,"73":2,"75":2,"76":2,"79":2,"80":2,"84":5,"87":2,"90":2,"100":2,"103":2,"107":2,"116":7,"118":2,"121":2,"124":2,"134":2,"146":30,"150":7,"151":2,"153":61,"154":64,"156":52,"173":1,"175":2,"176":1,"179":2,"180":1,"184":6,"185":6,"187":5,"189":16,"191":6,"193":2,"198":3}}],["fulfilled",{"2":{"182":1}}],["fully",{"2":{"6":1,"64":4,"67":1,"122":4}}],["full",{"0":{"0":1},"1":{"1":1,"2":1,"3":1,"4":1,"5":1,"6":1},"2":{"0":1,"69":5,"165":1,"199":4}}],["furthest",{"2":{"146":1}}],["further",{"2":{"62":1,"153":1}}],["furthermore",{"2":{"3":2,"6":5,"64":1,"70":1,"72":1,"75":1,"91":1,"135":1}}],["fun",{"2":{"191":1}}],["fundamental",{"2":{"26":1,"186":1}}],["func",{"2":{"13":5}}],["funcs",{"2":{"13":2,"14":3}}],["functionality",{"2":{"73":1,"171":1,"172":1,"177":1,"187":1}}],["functionalities",{"2":{"64":1}}],["functionally",{"2":{"1":1,"18":1,"29":1,"150":1,"153":1}}],["function",{"2":{"1":4,"4":1,"6":10,"7":2,"9":1,"13":3,"14":2,"18":2,"29":1,"31":1,"32":2,"53":5,"56":3,"60":13,"63":6,"64":18,"66":2,"67":4,"69":7,"70":3,"71":3,"72":2,"73":7,"74":1,"75":2,"76":4,"82":2,"85":6,"87":1,"88":8,"90":1,"91":1,"97":1,"98":1,"100":1,"103":1,"105":5,"107":1,"108":1,"114":1,"115":1,"116":9,"118":1,"121":1,"122":7,"124":1,"125":1,"131":1,"132":1,"134":1,"135":1,"141":1,"142":1,"145":4,"146":16,"148":1,"150":2,"151":2,"153":15,"154":11,"156":5,"160":1,"163":2,"165":7,"166":2,"169":2,"171":2,"172":1,"174":2,"176":2,"177":7,"180":3,"181":2,"182":3,"183":2,"184":7,"185":3,"187":6,"188":1,"189":12,"191":1,"197":4,"200":4}}],["functions",{"0":{"1":1,"71":1,"73":1,"76":1,"150":1,"189":1},"2":{"6":1,"9":3,"17":1,"26":1,"29":1,"33":1,"56":1,"60":1,"63":1,"64":2,"66":1,"69":1,"116":1,"147":1,"148":1,"151":1,"165":2,"166":1}}],["future",{"2":{"23":1,"77":1,"85":1,"174":2}}],["wgs84",{"2":{"192":1}}],["wglmakie",{"2":{"14":1}}],["wₜₒₜ",{"2":{"60":8}}],["wᵢ",{"2":{"60":18}}],["wt",{"2":{"60":3}}],["w",{"2":{"13":13,"14":7,"85":4,"146":1}}],["wrong",{"2":{"167":1,"184":1}}],["writing",{"2":{"195":1}}],["written",{"2":{"88":1}}],["writes",{"2":{"153":1}}],["write",{"2":{"7":1,"30":1,"146":1,"153":1,"195":7}}],["wrap",{"2":{"4":1,"6":1,"32":3,"35":1,"36":1,"37":1,"38":1,"50":1,"170":1,"176":1}}],["wrapped",{"2":{"22":1,"146":2,"151":1,"153":1}}],["wrapper",{"0":{"30":1},"2":{"30":1,"53":1,"56":1,"63":1,"69":1,"85":1,"88":1,"91":1,"108":1,"122":1,"125":1,"135":1}}],["wrappers`",{"2":{"156":1}}],["wrappers",{"2":{"1":10,"6":11,"22":1,"145":2,"146":1,"156":1,"162":8,"163":1,"168":22,"175":1,"176":1,"180":1,"185":10,"189":1,"191":121,"192":5,"193":9}}],["wrappergeometry`",{"2":{"172":1}}],["wrappergeometry",{"2":{"1":1}}],["wrapping",{"2":{"1":1,"6":1,"88":1,"172":1,"188":1}}],["web",{"2":{"195":1}}],["west",{"2":{"69":8}}],["were",{"2":{"64":1,"146":1,"198":1}}],["welcome",{"2":{"25":1,"27":1}}],["well",{"2":{"17":1,"64":1,"69":1,"82":1,"160":1,"174":1,"177":1,"178":1}}],["we",{"0":{"74":2},"2":{"7":1,"11":1,"13":1,"17":3,"19":1,"23":3,"24":1,"25":2,"26":1,"27":2,"32":1,"53":1,"55":2,"56":2,"57":2,"59":4,"60":8,"63":1,"64":7,"69":4,"71":8,"72":2,"73":3,"76":1,"77":1,"81":3,"82":2,"85":1,"87":1,"88":5,"90":1,"91":1,"100":1,"101":1,"104":1,"107":1,"108":1,"116":2,"118":3,"119":1,"121":1,"122":2,"124":1,"125":1,"134":1,"135":1,"146":21,"147":1,"151":1,"153":19,"154":6,"156":3,"158":6,"160":4,"161":1,"173":1,"174":2,"175":2,"176":3,"177":1,"180":5,"184":2,"186":1,"187":1,"190":2,"191":4,"192":6,"193":4,"194":1,"195":3,"197":3,"198":7}}],["weighting",{"2":{"62":2,"63":1}}],["weights",{"2":{"58":4}}],["weight",{"2":{"6":5,"60":14,"63":1}}],["weighted",{"2":{"0":1,"6":2,"58":3,"60":4,"63":4}}],["wall2",{"2":{"69":7}}],["wall1",{"2":{"69":12}}],["walls",{"2":{"69":3}}],["wall",{"2":{"69":69}}],["walk",{"2":{"67":1}}],["wachspress",{"2":{"60":1}}],["wasincreasing",{"2":{"146":10}}],["wasn",{"2":{"64":1}}],["was",{"2":{"31":1,"32":1,"50":1,"53":1,"56":1,"57":1,"59":1,"60":4,"63":1,"64":1,"67":1,"69":1,"70":1,"71":3,"72":1,"73":2,"74":1,"75":1,"76":3,"82":1,"85":1,"88":1,"98":1,"101":1,"104":1,"105":1,"115":1,"116":1,"119":1,"122":1,"132":1,"142":1,"145":1,"146":1,"147":1,"151":1,"153":1,"154":1,"155":1,"156":1,"160":1,"163":1,"166":1,"169":1,"170":1,"171":1,"173":1,"175":1,"177":1,"184":1,"185":1,"187":2,"188":1,"189":1}}],["wanted",{"2":{"200":1}}],["wants",{"2":{"82":1,"154":1}}],["want",{"0":{"23":1,"74":1},"2":{"13":1,"18":1,"23":1,"60":1,"64":1,"145":1,"192":2,"194":1,"199":1,"200":1}}],["ways",{"2":{"167":1}}],["way",{"2":{"6":1,"17":1,"18":1,"24":1,"29":1,"58":1,"148":1,"159":1,"164":1,"177":1,"187":2,"194":1}}],["warn",{"2":{"146":2,"177":1}}],["warned",{"2":{"6":1,"187":1}}],["warning",{"2":{"0":1,"5":1,"6":3,"24":1,"60":1,"82":1,"154":1,"176":1,"186":1,"199":1}}],["wong",{"2":{"79":1,"80":1,"196":1}}],["won",{"2":{"23":1,"64":1,"154":1}}],["wouldn",{"2":{"73":1}}],["would",{"0":{"74":1},"2":{"6":3,"23":1,"70":1,"72":1,"73":1,"75":1,"82":4,"146":1,"153":1,"160":2,"192":1,"199":1,"200":1}}],["wound",{"2":{"6":1,"82":1}}],["world",{"0":{"199":1},"2":{"197":1}}],["worrying",{"2":{"24":1}}],["words",{"2":{"3":1,"6":1,"100":1,"118":1,"124":1,"125":1}}],["workflow",{"2":{"105":1,"122":1}}],["workflows",{"2":{"23":1,"25":1,"27":1}}],["works",{"2":{"26":1,"172":1,"174":1}}],["working",{"2":{"3":1,"6":1,"105":1,"192":1}}],["work",{"2":{"1":3,"6":2,"9":1,"53":1,"56":2,"63":1,"67":2,"69":2,"77":1,"85":1,"88":1,"116":1,"122":1,"145":1,"150":1,"153":1,"154":1,"172":1,"185":1,"199":1}}],["whole",{"2":{"116":1}}],["whose",{"2":{"3":1,"6":1,"105":1}}],["white",{"2":{"59":1}}],["while",{"2":{"53":1,"62":1,"63":1,"64":5,"73":2,"81":2,"84":1,"88":1,"105":1,"116":1,"146":3,"169":1,"182":1,"184":2,"198":1}}],["whichever",{"2":{"6":1,"180":1}}],["which",{"2":{"1":1,"4":2,"5":1,"6":7,"7":1,"11":1,"13":1,"14":1,"17":1,"18":4,"20":1,"23":2,"33":1,"55":1,"56":1,"57":1,"58":1,"59":2,"60":5,"64":11,"69":2,"73":2,"77":1,"82":1,"88":2,"116":3,"146":3,"147":1,"148":1,"153":1,"158":2,"159":1,"161":2,"162":1,"165":1,"167":1,"168":1,"173":1,"174":1,"175":1,"176":3,"177":2,"180":1,"182":2,"185":1,"187":4,"195":3,"197":3,"198":6,"200":1}}],["what",{"0":{"22":1,"25":1,"30":1,"52":1,"55":2,"62":1,"66":1,"68":1,"84":2,"87":1,"90":1,"100":1,"103":1,"107":1,"118":1,"121":1,"124":1,"134":1,"151":1},"2":{"13":1,"14":1,"24":1,"62":1,"145":1,"146":1,"160":1,"175":1,"192":1,"199":1}}],["whatever",{"2":{"1":1,"22":1,"150":1,"153":1}}],["whyatt",{"2":{"178":1}}],["why",{"0":{"22":1,"23":1},"2":{"9":1,"17":1,"30":1,"56":1}}],["wheel",{"2":{"17":1}}],["whether",{"2":{"1":4,"4":1,"6":8,"144":1,"145":1,"150":2,"155":2,"160":1,"161":1}}],["when",{"2":{"1":1,"4":2,"5":1,"6":4,"18":1,"20":1,"23":2,"24":1,"56":1,"60":3,"63":1,"64":2,"71":5,"73":6,"76":7,"116":1,"146":1,"150":1,"151":3,"153":1,"162":1,"165":1,"170":2,"180":1,"192":1,"193":2,"195":1,"200":1}}],["whereas",{"2":{"158":1}}],["wherever",{"2":{"6":1,"188":1}}],["where",{"2":{"1":2,"4":5,"6":10,"20":1,"31":2,"53":8,"56":12,"58":2,"60":24,"63":8,"64":14,"67":5,"69":8,"70":2,"71":5,"72":3,"73":18,"75":2,"76":9,"85":25,"88":1,"116":9,"146":3,"150":1,"153":18,"154":18,"156":17,"158":2,"159":5,"167":1,"172":1,"175":1,"186":1,"188":1,"189":3,"191":4}}],["widely",{"2":{"195":1}}],["widths",{"2":{"14":1}}],["wiki",{"2":{"116":1,"182":1}}],["wikipedia",{"2":{"116":1,"182":2}}],["wind",{"2":{"4":1,"6":2,"56":1,"88":1}}],["winding",{"0":{"81":1},"2":{"4":2,"6":3,"56":3,"64":7,"81":4,"82":1,"88":1,"146":1}}],["without",{"2":{"1":2,"6":1,"17":1,"24":1,"64":1,"107":1,"122":1,"153":1,"154":1,"156":2,"172":1,"185":1}}],["with",{"0":{"71":1,"73":1,"76":1,"181":1,"182":1,"183":1,"193":1,"194":1},"2":{"1":5,"3":5,"4":7,"6":22,"11":1,"20":1,"22":2,"23":1,"52":1,"53":2,"56":7,"58":4,"59":1,"60":2,"63":1,"64":14,"69":6,"71":8,"72":5,"73":15,"75":1,"76":12,"84":1,"85":2,"91":1,"107":1,"111":1,"116":28,"118":1,"121":2,"122":5,"124":1,"125":1,"128":3,"129":2,"130":2,"140":1,"146":7,"148":1,"150":3,"151":1,"153":12,"154":3,"156":4,"158":1,"160":1,"162":1,"167":1,"170":1,"172":1,"174":1,"177":2,"180":2,"182":2,"183":1,"185":1,"187":1,"190":1,"191":4,"192":6,"193":2,"194":2,"195":2,"197":1,"198":1,"199":1}}],["within",{"0":{"44":1,"133":1,"134":1,"137":1,"138":1,"140":1,"141":1,"142":1},"1":{"134":1,"135":1},"2":{"0":2,"3":9,"4":3,"5":1,"6":13,"7":1,"9":1,"31":1,"44":2,"53":2,"56":1,"58":3,"60":1,"63":1,"64":9,"68":2,"69":5,"71":1,"73":2,"75":1,"76":6,"84":1,"85":5,"90":2,"100":2,"101":3,"110":1,"116":9,"121":1,"122":9,"133":1,"134":6,"135":11,"136":6,"137":14,"138":15,"139":15,"140":7,"141":4,"142":4,"148":1,"197":1,"198":4,"199":2}}],["will",{"2":{"1":8,"4":7,"5":1,"6":38,"11":1,"18":3,"23":2,"24":1,"53":4,"56":3,"60":2,"63":1,"64":5,"67":1,"69":1,"70":4,"71":4,"72":4,"73":4,"75":4,"76":4,"82":1,"84":2,"85":4,"88":1,"105":1,"145":1,"146":2,"150":3,"151":1,"152":2,"153":4,"154":3,"156":6,"158":2,"162":1,"166":2,"167":1,"169":2,"172":3,"174":2,"176":3,"180":2,"182":1,"184":1,"185":2,"187":1,"192":1,"195":1,"197":2,"199":1,"200":1}}],["wip",{"2":{"0":1}}]],"serializationVersion":2}';export{e as default}; diff --git a/previews/PR237/assets/chunks/VPLocalSearchBox.dF_ipd1x.js b/previews/PR237/assets/chunks/VPLocalSearchBox.dF_ipd1x.js new file mode 100644 index 000000000..2102176ad --- /dev/null +++ b/previews/PR237/assets/chunks/VPLocalSearchBox.dF_ipd1x.js @@ -0,0 +1,8 @@ +var Ft=Object.defineProperty;var Ot=(a,e,t)=>e in a?Ft(a,e,{enumerable:!0,configurable:!0,writable:!0,value:t}):a[e]=t;var Ae=(a,e,t)=>Ot(a,typeof e!="symbol"?e+"":e,t);import{V as Ct,p as ie,h as me,aj as tt,ak as Rt,al as At,q as $e,am as Mt,d as Lt,D as xe,an as st,ao as Dt,ap as zt,s as Pt,aq as jt,v as Me,P as he,O as _e,ar as Vt,as as $t,W as Bt,R as Wt,$ as Kt,o as H,b as Jt,j as _,a0 as Ut,k as L,at as qt,au as Gt,av as Ht,c as Z,n as nt,e as Se,C as it,F as rt,a as fe,t as pe,aw as Qt,ax as at,ay as Yt,a9 as Zt,af as Xt,az as es,_ as ts}from"./framework.Cq8AuEls.js";import{u as ss,c as ns}from"./theme.BVJ9-_aP.js";const is={root:()=>Ct(()=>import("./@localSearchIndexroot.DYRrAYA4.js"),[])};/*! +* tabbable 6.2.0 +* @license MIT, https://github.com/focus-trap/tabbable/blob/master/LICENSE +*/var mt=["input:not([inert])","select:not([inert])","textarea:not([inert])","a[href]:not([inert])","button:not([inert])","[tabindex]:not(slot):not([inert])","audio[controls]:not([inert])","video[controls]:not([inert])",'[contenteditable]:not([contenteditable="false"]):not([inert])',"details>summary:first-of-type:not([inert])","details:not([inert])"],Ne=mt.join(","),gt=typeof Element>"u",ae=gt?function(){}:Element.prototype.matches||Element.prototype.msMatchesSelector||Element.prototype.webkitMatchesSelector,Fe=!gt&&Element.prototype.getRootNode?function(a){var e;return a==null||(e=a.getRootNode)===null||e===void 0?void 0:e.call(a)}:function(a){return a==null?void 0:a.ownerDocument},Oe=function a(e,t){var s;t===void 0&&(t=!0);var n=e==null||(s=e.getAttribute)===null||s===void 0?void 0:s.call(e,"inert"),r=n===""||n==="true",i=r||t&&e&&a(e.parentNode);return i},rs=function(e){var t,s=e==null||(t=e.getAttribute)===null||t===void 0?void 0:t.call(e,"contenteditable");return s===""||s==="true"},bt=function(e,t,s){if(Oe(e))return[];var n=Array.prototype.slice.apply(e.querySelectorAll(Ne));return t&&ae.call(e,Ne)&&n.unshift(e),n=n.filter(s),n},yt=function a(e,t,s){for(var n=[],r=Array.from(e);r.length;){var i=r.shift();if(!Oe(i,!1))if(i.tagName==="SLOT"){var o=i.assignedElements(),l=o.length?o:i.children,c=a(l,!0,s);s.flatten?n.push.apply(n,c):n.push({scopeParent:i,candidates:c})}else{var h=ae.call(i,Ne);h&&s.filter(i)&&(t||!e.includes(i))&&n.push(i);var m=i.shadowRoot||typeof s.getShadowRoot=="function"&&s.getShadowRoot(i),f=!Oe(m,!1)&&(!s.shadowRootFilter||s.shadowRootFilter(i));if(m&&f){var b=a(m===!0?i.children:m.children,!0,s);s.flatten?n.push.apply(n,b):n.push({scopeParent:i,candidates:b})}else r.unshift.apply(r,i.children)}}return n},wt=function(e){return!isNaN(parseInt(e.getAttribute("tabindex"),10))},re=function(e){if(!e)throw new Error("No node provided");return e.tabIndex<0&&(/^(AUDIO|VIDEO|DETAILS)$/.test(e.tagName)||rs(e))&&!wt(e)?0:e.tabIndex},as=function(e,t){var s=re(e);return s<0&&t&&!wt(e)?0:s},os=function(e,t){return e.tabIndex===t.tabIndex?e.documentOrder-t.documentOrder:e.tabIndex-t.tabIndex},xt=function(e){return e.tagName==="INPUT"},ls=function(e){return xt(e)&&e.type==="hidden"},cs=function(e){var t=e.tagName==="DETAILS"&&Array.prototype.slice.apply(e.children).some(function(s){return s.tagName==="SUMMARY"});return t},us=function(e,t){for(var s=0;ssummary:first-of-type"),i=r?e.parentElement:e;if(ae.call(i,"details:not([open]) *"))return!0;if(!s||s==="full"||s==="legacy-full"){if(typeof n=="function"){for(var o=e;e;){var l=e.parentElement,c=Fe(e);if(l&&!l.shadowRoot&&n(l)===!0)return ot(e);e.assignedSlot?e=e.assignedSlot:!l&&c!==e.ownerDocument?e=c.host:e=l}e=o}if(ps(e))return!e.getClientRects().length;if(s!=="legacy-full")return!0}else if(s==="non-zero-area")return ot(e);return!1},ms=function(e){if(/^(INPUT|BUTTON|SELECT|TEXTAREA)$/.test(e.tagName))for(var t=e.parentElement;t;){if(t.tagName==="FIELDSET"&&t.disabled){for(var s=0;s=0)},bs=function a(e){var t=[],s=[];return e.forEach(function(n,r){var i=!!n.scopeParent,o=i?n.scopeParent:n,l=as(o,i),c=i?a(n.candidates):o;l===0?i?t.push.apply(t,c):t.push(o):s.push({documentOrder:r,tabIndex:l,item:n,isScope:i,content:c})}),s.sort(os).reduce(function(n,r){return r.isScope?n.push.apply(n,r.content):n.push(r.content),n},[]).concat(t)},ys=function(e,t){t=t||{};var s;return t.getShadowRoot?s=yt([e],t.includeContainer,{filter:Be.bind(null,t),flatten:!1,getShadowRoot:t.getShadowRoot,shadowRootFilter:gs}):s=bt(e,t.includeContainer,Be.bind(null,t)),bs(s)},ws=function(e,t){t=t||{};var s;return t.getShadowRoot?s=yt([e],t.includeContainer,{filter:Ce.bind(null,t),flatten:!0,getShadowRoot:t.getShadowRoot}):s=bt(e,t.includeContainer,Ce.bind(null,t)),s},oe=function(e,t){if(t=t||{},!e)throw new Error("No node provided");return ae.call(e,Ne)===!1?!1:Be(t,e)},xs=mt.concat("iframe").join(","),Le=function(e,t){if(t=t||{},!e)throw new Error("No node provided");return ae.call(e,xs)===!1?!1:Ce(t,e)};/*! +* focus-trap 7.6.2 +* @license MIT, https://github.com/focus-trap/focus-trap/blob/master/LICENSE +*/function We(a,e){(e==null||e>a.length)&&(e=a.length);for(var t=0,s=Array(e);t0){var s=e[e.length-1];s!==t&&s.pause()}var n=e.indexOf(t);n===-1||e.splice(n,1),e.push(t)},deactivateTrap:function(e,t){var s=e.indexOf(t);s!==-1&&e.splice(s,1),e.length>0&&e[e.length-1].unpause()}},Os=function(e){return e.tagName&&e.tagName.toLowerCase()==="input"&&typeof e.select=="function"},Cs=function(e){return(e==null?void 0:e.key)==="Escape"||(e==null?void 0:e.key)==="Esc"||(e==null?void 0:e.keyCode)===27},ge=function(e){return(e==null?void 0:e.key)==="Tab"||(e==null?void 0:e.keyCode)===9},Rs=function(e){return ge(e)&&!e.shiftKey},As=function(e){return ge(e)&&e.shiftKey},dt=function(e){return setTimeout(e,0)},ve=function(e){for(var t=arguments.length,s=new Array(t>1?t-1:0),n=1;n1&&arguments[1]!==void 0?arguments[1]:{},g=d.hasFallback,T=g===void 0?!1:g,k=d.params,O=k===void 0?[]:k,S=r[u];if(typeof S=="function"&&(S=S.apply(void 0,Is(O))),S===!0&&(S=void 0),!S){if(S===void 0||S===!1)return S;throw new Error("`".concat(u,"` was specified but was not a node, or did not return a node"))}var C=S;if(typeof S=="string"){try{C=s.querySelector(S)}catch(v){throw new Error("`".concat(u,'` appears to be an invalid selector; error="').concat(v.message,'"'))}if(!C&&!T)throw new Error("`".concat(u,"` as selector refers to no known node"))}return C},m=function(){var u=h("initialFocus",{hasFallback:!0});if(u===!1)return!1;if(u===void 0||u&&!Le(u,r.tabbableOptions))if(c(s.activeElement)>=0)u=s.activeElement;else{var d=i.tabbableGroups[0],g=d&&d.firstTabbableNode;u=g||h("fallbackFocus")}else u===null&&(u=h("fallbackFocus"));if(!u)throw new Error("Your focus-trap needs to have at least one focusable element");return u},f=function(){if(i.containerGroups=i.containers.map(function(u){var d=ys(u,r.tabbableOptions),g=ws(u,r.tabbableOptions),T=d.length>0?d[0]:void 0,k=d.length>0?d[d.length-1]:void 0,O=g.find(function(v){return oe(v)}),S=g.slice().reverse().find(function(v){return oe(v)}),C=!!d.find(function(v){return re(v)>0});return{container:u,tabbableNodes:d,focusableNodes:g,posTabIndexesFound:C,firstTabbableNode:T,lastTabbableNode:k,firstDomTabbableNode:O,lastDomTabbableNode:S,nextTabbableNode:function(p){var E=arguments.length>1&&arguments[1]!==void 0?arguments[1]:!0,F=d.indexOf(p);return F<0?E?g.slice(g.indexOf(p)+1).find(function(z){return oe(z)}):g.slice(0,g.indexOf(p)).reverse().find(function(z){return oe(z)}):d[F+(E?1:-1)]}}}),i.tabbableGroups=i.containerGroups.filter(function(u){return u.tabbableNodes.length>0}),i.tabbableGroups.length<=0&&!h("fallbackFocus"))throw new Error("Your focus-trap must have at least one container with at least one tabbable node in it at all times");if(i.containerGroups.find(function(u){return u.posTabIndexesFound})&&i.containerGroups.length>1)throw new Error("At least one node with a positive tabindex was found in one of your focus-trap's multiple containers. Positive tabindexes are only supported in single-container focus-traps.")},b=function(u){var d=u.activeElement;if(d)return d.shadowRoot&&d.shadowRoot.activeElement!==null?b(d.shadowRoot):d},y=function(u){if(u!==!1&&u!==b(document)){if(!u||!u.focus){y(m());return}u.focus({preventScroll:!!r.preventScroll}),i.mostRecentlyFocusedNode=u,Os(u)&&u.select()}},x=function(u){var d=h("setReturnFocus",{params:[u]});return d||(d===!1?!1:u)},w=function(u){var d=u.target,g=u.event,T=u.isBackward,k=T===void 0?!1:T;d=d||Ee(g),f();var O=null;if(i.tabbableGroups.length>0){var S=c(d,g),C=S>=0?i.containerGroups[S]:void 0;if(S<0)k?O=i.tabbableGroups[i.tabbableGroups.length-1].lastTabbableNode:O=i.tabbableGroups[0].firstTabbableNode;else if(k){var v=i.tabbableGroups.findIndex(function(j){var I=j.firstTabbableNode;return d===I});if(v<0&&(C.container===d||Le(d,r.tabbableOptions)&&!oe(d,r.tabbableOptions)&&!C.nextTabbableNode(d,!1))&&(v=S),v>=0){var p=v===0?i.tabbableGroups.length-1:v-1,E=i.tabbableGroups[p];O=re(d)>=0?E.lastTabbableNode:E.lastDomTabbableNode}else ge(g)||(O=C.nextTabbableNode(d,!1))}else{var F=i.tabbableGroups.findIndex(function(j){var I=j.lastTabbableNode;return d===I});if(F<0&&(C.container===d||Le(d,r.tabbableOptions)&&!oe(d,r.tabbableOptions)&&!C.nextTabbableNode(d))&&(F=S),F>=0){var z=F===i.tabbableGroups.length-1?0:F+1,P=i.tabbableGroups[z];O=re(d)>=0?P.firstTabbableNode:P.firstDomTabbableNode}else ge(g)||(O=C.nextTabbableNode(d))}}else O=h("fallbackFocus");return O},R=function(u){var d=Ee(u);if(!(c(d,u)>=0)){if(ve(r.clickOutsideDeactivates,u)){o.deactivate({returnFocus:r.returnFocusOnDeactivate});return}ve(r.allowOutsideClick,u)||u.preventDefault()}},A=function(u){var d=Ee(u),g=c(d,u)>=0;if(g||d instanceof Document)g&&(i.mostRecentlyFocusedNode=d);else{u.stopImmediatePropagation();var T,k=!0;if(i.mostRecentlyFocusedNode)if(re(i.mostRecentlyFocusedNode)>0){var O=c(i.mostRecentlyFocusedNode),S=i.containerGroups[O].tabbableNodes;if(S.length>0){var C=S.findIndex(function(v){return v===i.mostRecentlyFocusedNode});C>=0&&(r.isKeyForward(i.recentNavEvent)?C+1=0&&(T=S[C-1],k=!1))}}else i.containerGroups.some(function(v){return v.tabbableNodes.some(function(p){return re(p)>0})})||(k=!1);else k=!1;k&&(T=w({target:i.mostRecentlyFocusedNode,isBackward:r.isKeyBackward(i.recentNavEvent)})),y(T||i.mostRecentlyFocusedNode||m())}i.recentNavEvent=void 0},J=function(u){var d=arguments.length>1&&arguments[1]!==void 0?arguments[1]:!1;i.recentNavEvent=u;var g=w({event:u,isBackward:d});g&&(ge(u)&&u.preventDefault(),y(g))},Q=function(u){(r.isKeyForward(u)||r.isKeyBackward(u))&&J(u,r.isKeyBackward(u))},W=function(u){Cs(u)&&ve(r.escapeDeactivates,u)!==!1&&(u.preventDefault(),o.deactivate())},V=function(u){var d=Ee(u);c(d,u)>=0||ve(r.clickOutsideDeactivates,u)||ve(r.allowOutsideClick,u)||(u.preventDefault(),u.stopImmediatePropagation())},$=function(){if(i.active)return ut.activateTrap(n,o),i.delayInitialFocusTimer=r.delayInitialFocus?dt(function(){y(m())}):y(m()),s.addEventListener("focusin",A,!0),s.addEventListener("mousedown",R,{capture:!0,passive:!1}),s.addEventListener("touchstart",R,{capture:!0,passive:!1}),s.addEventListener("click",V,{capture:!0,passive:!1}),s.addEventListener("keydown",Q,{capture:!0,passive:!1}),s.addEventListener("keydown",W),o},be=function(){if(i.active)return s.removeEventListener("focusin",A,!0),s.removeEventListener("mousedown",R,!0),s.removeEventListener("touchstart",R,!0),s.removeEventListener("click",V,!0),s.removeEventListener("keydown",Q,!0),s.removeEventListener("keydown",W),o},M=function(u){var d=u.some(function(g){var T=Array.from(g.removedNodes);return T.some(function(k){return k===i.mostRecentlyFocusedNode})});d&&y(m())},U=typeof window<"u"&&"MutationObserver"in window?new MutationObserver(M):void 0,q=function(){U&&(U.disconnect(),i.active&&!i.paused&&i.containers.map(function(u){U.observe(u,{subtree:!0,childList:!0})}))};return o={get active(){return i.active},get paused(){return i.paused},activate:function(u){if(i.active)return this;var d=l(u,"onActivate"),g=l(u,"onPostActivate"),T=l(u,"checkCanFocusTrap");T||f(),i.active=!0,i.paused=!1,i.nodeFocusedBeforeActivation=s.activeElement,d==null||d();var k=function(){T&&f(),$(),q(),g==null||g()};return T?(T(i.containers.concat()).then(k,k),this):(k(),this)},deactivate:function(u){if(!i.active)return this;var d=ct({onDeactivate:r.onDeactivate,onPostDeactivate:r.onPostDeactivate,checkCanReturnFocus:r.checkCanReturnFocus},u);clearTimeout(i.delayInitialFocusTimer),i.delayInitialFocusTimer=void 0,be(),i.active=!1,i.paused=!1,q(),ut.deactivateTrap(n,o);var g=l(d,"onDeactivate"),T=l(d,"onPostDeactivate"),k=l(d,"checkCanReturnFocus"),O=l(d,"returnFocus","returnFocusOnDeactivate");g==null||g();var S=function(){dt(function(){O&&y(x(i.nodeFocusedBeforeActivation)),T==null||T()})};return O&&k?(k(x(i.nodeFocusedBeforeActivation)).then(S,S),this):(S(),this)},pause:function(u){if(i.paused||!i.active)return this;var d=l(u,"onPause"),g=l(u,"onPostPause");return i.paused=!0,d==null||d(),be(),q(),g==null||g(),this},unpause:function(u){if(!i.paused||!i.active)return this;var d=l(u,"onUnpause"),g=l(u,"onPostUnpause");return i.paused=!1,d==null||d(),f(),$(),q(),g==null||g(),this},updateContainerElements:function(u){var d=[].concat(u).filter(Boolean);return i.containers=d.map(function(g){return typeof g=="string"?s.querySelector(g):g}),i.active&&f(),q(),this}},o.updateContainerElements(e),o};function Ds(a,e={}){let t;const{immediate:s,...n}=e,r=ie(!1),i=ie(!1),o=f=>t&&t.activate(f),l=f=>t&&t.deactivate(f),c=()=>{t&&(t.pause(),i.value=!0)},h=()=>{t&&(t.unpause(),i.value=!1)},m=me(()=>{const f=tt(a);return(Array.isArray(f)?f:[f]).map(b=>{const y=tt(b);return typeof y=="string"?y:Rt(y)}).filter(At)});return $e(m,f=>{f.length&&(t=Ls(f,{...n,onActivate(){r.value=!0,e.onActivate&&e.onActivate()},onDeactivate(){r.value=!1,e.onDeactivate&&e.onDeactivate()}}),s&&o())},{flush:"post"}),Mt(()=>l()),{hasFocus:r,isPaused:i,activate:o,deactivate:l,pause:c,unpause:h}}class ce{constructor(e,t=!0,s=[],n=5e3){this.ctx=e,this.iframes=t,this.exclude=s,this.iframesTimeout=n}static matches(e,t){const s=typeof t=="string"?[t]:t,n=e.matches||e.matchesSelector||e.msMatchesSelector||e.mozMatchesSelector||e.oMatchesSelector||e.webkitMatchesSelector;if(n){let r=!1;return s.every(i=>n.call(e,i)?(r=!0,!1):!0),r}else return!1}getContexts(){let e,t=[];return typeof this.ctx>"u"||!this.ctx?e=[]:NodeList.prototype.isPrototypeOf(this.ctx)?e=Array.prototype.slice.call(this.ctx):Array.isArray(this.ctx)?e=this.ctx:typeof this.ctx=="string"?e=Array.prototype.slice.call(document.querySelectorAll(this.ctx)):e=[this.ctx],e.forEach(s=>{const n=t.filter(r=>r.contains(s)).length>0;t.indexOf(s)===-1&&!n&&t.push(s)}),t}getIframeContents(e,t,s=()=>{}){let n;try{const r=e.contentWindow;if(n=r.document,!r||!n)throw new Error("iframe inaccessible")}catch{s()}n&&t(n)}isIframeBlank(e){const t="about:blank",s=e.getAttribute("src").trim();return e.contentWindow.location.href===t&&s!==t&&s}observeIframeLoad(e,t,s){let n=!1,r=null;const i=()=>{if(!n){n=!0,clearTimeout(r);try{this.isIframeBlank(e)||(e.removeEventListener("load",i),this.getIframeContents(e,t,s))}catch{s()}}};e.addEventListener("load",i),r=setTimeout(i,this.iframesTimeout)}onIframeReady(e,t,s){try{e.contentWindow.document.readyState==="complete"?this.isIframeBlank(e)?this.observeIframeLoad(e,t,s):this.getIframeContents(e,t,s):this.observeIframeLoad(e,t,s)}catch{s()}}waitForIframes(e,t){let s=0;this.forEachIframe(e,()=>!0,n=>{s++,this.waitForIframes(n.querySelector("html"),()=>{--s||t()})},n=>{n||t()})}forEachIframe(e,t,s,n=()=>{}){let r=e.querySelectorAll("iframe"),i=r.length,o=0;r=Array.prototype.slice.call(r);const l=()=>{--i<=0&&n(o)};i||l(),r.forEach(c=>{ce.matches(c,this.exclude)?l():this.onIframeReady(c,h=>{t(c)&&(o++,s(h)),l()},l)})}createIterator(e,t,s){return document.createNodeIterator(e,t,s,!1)}createInstanceOnIframe(e){return new ce(e.querySelector("html"),this.iframes)}compareNodeIframe(e,t,s){const n=e.compareDocumentPosition(s),r=Node.DOCUMENT_POSITION_PRECEDING;if(n&r)if(t!==null){const i=t.compareDocumentPosition(s),o=Node.DOCUMENT_POSITION_FOLLOWING;if(i&o)return!0}else return!0;return!1}getIteratorNode(e){const t=e.previousNode();let s;return t===null?s=e.nextNode():s=e.nextNode()&&e.nextNode(),{prevNode:t,node:s}}checkIframeFilter(e,t,s,n){let r=!1,i=!1;return n.forEach((o,l)=>{o.val===s&&(r=l,i=o.handled)}),this.compareNodeIframe(e,t,s)?(r===!1&&!i?n.push({val:s,handled:!0}):r!==!1&&!i&&(n[r].handled=!0),!0):(r===!1&&n.push({val:s,handled:!1}),!1)}handleOpenIframes(e,t,s,n){e.forEach(r=>{r.handled||this.getIframeContents(r.val,i=>{this.createInstanceOnIframe(i).forEachNode(t,s,n)})})}iterateThroughNodes(e,t,s,n,r){const i=this.createIterator(t,e,n);let o=[],l=[],c,h,m=()=>({prevNode:h,node:c}=this.getIteratorNode(i),c);for(;m();)this.iframes&&this.forEachIframe(t,f=>this.checkIframeFilter(c,h,f,o),f=>{this.createInstanceOnIframe(f).forEachNode(e,b=>l.push(b),n)}),l.push(c);l.forEach(f=>{s(f)}),this.iframes&&this.handleOpenIframes(o,e,s,n),r()}forEachNode(e,t,s,n=()=>{}){const r=this.getContexts();let i=r.length;i||n(),r.forEach(o=>{const l=()=>{this.iterateThroughNodes(e,o,t,s,()=>{--i<=0&&n()})};this.iframes?this.waitForIframes(o,l):l()})}}let zs=class{constructor(e){this.ctx=e,this.ie=!1;const t=window.navigator.userAgent;(t.indexOf("MSIE")>-1||t.indexOf("Trident")>-1)&&(this.ie=!0)}set opt(e){this._opt=Object.assign({},{element:"",className:"",exclude:[],iframes:!1,iframesTimeout:5e3,separateWordSearch:!0,diacritics:!0,synonyms:{},accuracy:"partially",acrossElements:!1,caseSensitive:!1,ignoreJoiners:!1,ignoreGroups:0,ignorePunctuation:[],wildcards:"disabled",each:()=>{},noMatch:()=>{},filter:()=>!0,done:()=>{},debug:!1,log:window.console},e)}get opt(){return this._opt}get iterator(){return new ce(this.ctx,this.opt.iframes,this.opt.exclude,this.opt.iframesTimeout)}log(e,t="debug"){const s=this.opt.log;this.opt.debug&&typeof s=="object"&&typeof s[t]=="function"&&s[t](`mark.js: ${e}`)}escapeStr(e){return e.replace(/[\-\[\]\/\{\}\(\)\*\+\?\.\\\^\$\|]/g,"\\$&")}createRegExp(e){return this.opt.wildcards!=="disabled"&&(e=this.setupWildcardsRegExp(e)),e=this.escapeStr(e),Object.keys(this.opt.synonyms).length&&(e=this.createSynonymsRegExp(e)),(this.opt.ignoreJoiners||this.opt.ignorePunctuation.length)&&(e=this.setupIgnoreJoinersRegExp(e)),this.opt.diacritics&&(e=this.createDiacriticsRegExp(e)),e=this.createMergedBlanksRegExp(e),(this.opt.ignoreJoiners||this.opt.ignorePunctuation.length)&&(e=this.createJoinersRegExp(e)),this.opt.wildcards!=="disabled"&&(e=this.createWildcardsRegExp(e)),e=this.createAccuracyRegExp(e),e}createSynonymsRegExp(e){const t=this.opt.synonyms,s=this.opt.caseSensitive?"":"i",n=this.opt.ignoreJoiners||this.opt.ignorePunctuation.length?"\0":"";for(let r in t)if(t.hasOwnProperty(r)){const i=t[r],o=this.opt.wildcards!=="disabled"?this.setupWildcardsRegExp(r):this.escapeStr(r),l=this.opt.wildcards!=="disabled"?this.setupWildcardsRegExp(i):this.escapeStr(i);o!==""&&l!==""&&(e=e.replace(new RegExp(`(${this.escapeStr(o)}|${this.escapeStr(l)})`,`gm${s}`),n+`(${this.processSynomyms(o)}|${this.processSynomyms(l)})`+n))}return e}processSynomyms(e){return(this.opt.ignoreJoiners||this.opt.ignorePunctuation.length)&&(e=this.setupIgnoreJoinersRegExp(e)),e}setupWildcardsRegExp(e){return e=e.replace(/(?:\\)*\?/g,t=>t.charAt(0)==="\\"?"?":""),e.replace(/(?:\\)*\*/g,t=>t.charAt(0)==="\\"?"*":"")}createWildcardsRegExp(e){let t=this.opt.wildcards==="withSpaces";return e.replace(/\u0001/g,t?"[\\S\\s]?":"\\S?").replace(/\u0002/g,t?"[\\S\\s]*?":"\\S*")}setupIgnoreJoinersRegExp(e){return e.replace(/[^(|)\\]/g,(t,s,n)=>{let r=n.charAt(s+1);return/[(|)\\]/.test(r)||r===""?t:t+"\0"})}createJoinersRegExp(e){let t=[];const s=this.opt.ignorePunctuation;return Array.isArray(s)&&s.length&&t.push(this.escapeStr(s.join(""))),this.opt.ignoreJoiners&&t.push("\\u00ad\\u200b\\u200c\\u200d"),t.length?e.split(/\u0000+/).join(`[${t.join("")}]*`):e}createDiacriticsRegExp(e){const t=this.opt.caseSensitive?"":"i",s=this.opt.caseSensitive?["aàáảãạăằắẳẵặâầấẩẫậäåāą","AÀÁẢÃẠĂẰẮẲẴẶÂẦẤẨẪẬÄÅĀĄ","cçćč","CÇĆČ","dđď","DĐĎ","eèéẻẽẹêềếểễệëěēę","EÈÉẺẼẸÊỀẾỂỄỆËĚĒĘ","iìíỉĩịîïī","IÌÍỈĨỊÎÏĪ","lł","LŁ","nñňń","NÑŇŃ","oòóỏõọôồốổỗộơởỡớờợöøō","OÒÓỎÕỌÔỒỐỔỖỘƠỞỠỚỜỢÖØŌ","rř","RŘ","sšśșş","SŠŚȘŞ","tťțţ","TŤȚŢ","uùúủũụưừứửữựûüůū","UÙÚỦŨỤƯỪỨỬỮỰÛÜŮŪ","yýỳỷỹỵÿ","YÝỲỶỸỴŸ","zžżź","ZŽŻŹ"]:["aàáảãạăằắẳẵặâầấẩẫậäåāąAÀÁẢÃẠĂẰẮẲẴẶÂẦẤẨẪẬÄÅĀĄ","cçćčCÇĆČ","dđďDĐĎ","eèéẻẽẹêềếểễệëěēęEÈÉẺẼẸÊỀẾỂỄỆËĚĒĘ","iìíỉĩịîïīIÌÍỈĨỊÎÏĪ","lłLŁ","nñňńNÑŇŃ","oòóỏõọôồốổỗộơởỡớờợöøōOÒÓỎÕỌÔỒỐỔỖỘƠỞỠỚỜỢÖØŌ","rřRŘ","sšśșşSŠŚȘŞ","tťțţTŤȚŢ","uùúủũụưừứửữựûüůūUÙÚỦŨỤƯỪỨỬỮỰÛÜŮŪ","yýỳỷỹỵÿYÝỲỶỸỴŸ","zžżźZŽŻŹ"];let n=[];return e.split("").forEach(r=>{s.every(i=>{if(i.indexOf(r)!==-1){if(n.indexOf(i)>-1)return!1;e=e.replace(new RegExp(`[${i}]`,`gm${t}`),`[${i}]`),n.push(i)}return!0})}),e}createMergedBlanksRegExp(e){return e.replace(/[\s]+/gmi,"[\\s]+")}createAccuracyRegExp(e){const t="!\"#$%&'()*+,-./:;<=>?@[\\]^_`{|}~¡¿";let s=this.opt.accuracy,n=typeof s=="string"?s:s.value,r=typeof s=="string"?[]:s.limiters,i="";switch(r.forEach(o=>{i+=`|${this.escapeStr(o)}`}),n){case"partially":default:return`()(${e})`;case"complementary":return i="\\s"+(i||this.escapeStr(t)),`()([^${i}]*${e}[^${i}]*)`;case"exactly":return`(^|\\s${i})(${e})(?=$|\\s${i})`}}getSeparatedKeywords(e){let t=[];return e.forEach(s=>{this.opt.separateWordSearch?s.split(" ").forEach(n=>{n.trim()&&t.indexOf(n)===-1&&t.push(n)}):s.trim()&&t.indexOf(s)===-1&&t.push(s)}),{keywords:t.sort((s,n)=>n.length-s.length),length:t.length}}isNumeric(e){return Number(parseFloat(e))==e}checkRanges(e){if(!Array.isArray(e)||Object.prototype.toString.call(e[0])!=="[object Object]")return this.log("markRanges() will only accept an array of objects"),this.opt.noMatch(e),[];const t=[];let s=0;return e.sort((n,r)=>n.start-r.start).forEach(n=>{let{start:r,end:i,valid:o}=this.callNoMatchOnInvalidRanges(n,s);o&&(n.start=r,n.length=i-r,t.push(n),s=i)}),t}callNoMatchOnInvalidRanges(e,t){let s,n,r=!1;return e&&typeof e.start<"u"?(s=parseInt(e.start,10),n=s+parseInt(e.length,10),this.isNumeric(e.start)&&this.isNumeric(e.length)&&n-t>0&&n-s>0?r=!0:(this.log(`Ignoring invalid or overlapping range: ${JSON.stringify(e)}`),this.opt.noMatch(e))):(this.log(`Ignoring invalid range: ${JSON.stringify(e)}`),this.opt.noMatch(e)),{start:s,end:n,valid:r}}checkWhitespaceRanges(e,t,s){let n,r=!0,i=s.length,o=t-i,l=parseInt(e.start,10)-o;return l=l>i?i:l,n=l+parseInt(e.length,10),n>i&&(n=i,this.log(`End range automatically set to the max value of ${i}`)),l<0||n-l<0||l>i||n>i?(r=!1,this.log(`Invalid range: ${JSON.stringify(e)}`),this.opt.noMatch(e)):s.substring(l,n).replace(/\s+/g,"")===""&&(r=!1,this.log("Skipping whitespace only range: "+JSON.stringify(e)),this.opt.noMatch(e)),{start:l,end:n,valid:r}}getTextNodes(e){let t="",s=[];this.iterator.forEachNode(NodeFilter.SHOW_TEXT,n=>{s.push({start:t.length,end:(t+=n.textContent).length,node:n})},n=>this.matchesExclude(n.parentNode)?NodeFilter.FILTER_REJECT:NodeFilter.FILTER_ACCEPT,()=>{e({value:t,nodes:s})})}matchesExclude(e){return ce.matches(e,this.opt.exclude.concat(["script","style","title","head","html"]))}wrapRangeInTextNode(e,t,s){const n=this.opt.element?this.opt.element:"mark",r=e.splitText(t),i=r.splitText(s-t);let o=document.createElement(n);return o.setAttribute("data-markjs","true"),this.opt.className&&o.setAttribute("class",this.opt.className),o.textContent=r.textContent,r.parentNode.replaceChild(o,r),i}wrapRangeInMappedTextNode(e,t,s,n,r){e.nodes.every((i,o)=>{const l=e.nodes[o+1];if(typeof l>"u"||l.start>t){if(!n(i.node))return!1;const c=t-i.start,h=(s>i.end?i.end:s)-i.start,m=e.value.substr(0,i.start),f=e.value.substr(h+i.start);if(i.node=this.wrapRangeInTextNode(i.node,c,h),e.value=m+f,e.nodes.forEach((b,y)=>{y>=o&&(e.nodes[y].start>0&&y!==o&&(e.nodes[y].start-=h),e.nodes[y].end-=h)}),s-=h,r(i.node.previousSibling,i.start),s>i.end)t=i.end;else return!1}return!0})}wrapMatches(e,t,s,n,r){const i=t===0?0:t+1;this.getTextNodes(o=>{o.nodes.forEach(l=>{l=l.node;let c;for(;(c=e.exec(l.textContent))!==null&&c[i]!=="";){if(!s(c[i],l))continue;let h=c.index;if(i!==0)for(let m=1;m{let l;for(;(l=e.exec(o.value))!==null&&l[i]!=="";){let c=l.index;if(i!==0)for(let m=1;ms(l[i],m),(m,f)=>{e.lastIndex=f,n(m)})}r()})}wrapRangeFromIndex(e,t,s,n){this.getTextNodes(r=>{const i=r.value.length;e.forEach((o,l)=>{let{start:c,end:h,valid:m}=this.checkWhitespaceRanges(o,i,r.value);m&&this.wrapRangeInMappedTextNode(r,c,h,f=>t(f,o,r.value.substring(c,h),l),f=>{s(f,o)})}),n()})}unwrapMatches(e){const t=e.parentNode;let s=document.createDocumentFragment();for(;e.firstChild;)s.appendChild(e.removeChild(e.firstChild));t.replaceChild(s,e),this.ie?this.normalizeTextNode(t):t.normalize()}normalizeTextNode(e){if(e){if(e.nodeType===3)for(;e.nextSibling&&e.nextSibling.nodeType===3;)e.nodeValue+=e.nextSibling.nodeValue,e.parentNode.removeChild(e.nextSibling);else this.normalizeTextNode(e.firstChild);this.normalizeTextNode(e.nextSibling)}}markRegExp(e,t){this.opt=t,this.log(`Searching with expression "${e}"`);let s=0,n="wrapMatches";const r=i=>{s++,this.opt.each(i)};this.opt.acrossElements&&(n="wrapMatchesAcrossElements"),this[n](e,this.opt.ignoreGroups,(i,o)=>this.opt.filter(o,i,s),r,()=>{s===0&&this.opt.noMatch(e),this.opt.done(s)})}mark(e,t){this.opt=t;let s=0,n="wrapMatches";const{keywords:r,length:i}=this.getSeparatedKeywords(typeof e=="string"?[e]:e),o=this.opt.caseSensitive?"":"i",l=c=>{let h=new RegExp(this.createRegExp(c),`gm${o}`),m=0;this.log(`Searching with expression "${h}"`),this[n](h,1,(f,b)=>this.opt.filter(b,c,s,m),f=>{m++,s++,this.opt.each(f)},()=>{m===0&&this.opt.noMatch(c),r[i-1]===c?this.opt.done(s):l(r[r.indexOf(c)+1])})};this.opt.acrossElements&&(n="wrapMatchesAcrossElements"),i===0?this.opt.done(s):l(r[0])}markRanges(e,t){this.opt=t;let s=0,n=this.checkRanges(e);n&&n.length?(this.log("Starting to mark with the following ranges: "+JSON.stringify(n)),this.wrapRangeFromIndex(n,(r,i,o,l)=>this.opt.filter(r,i,o,l),(r,i)=>{s++,this.opt.each(r,i)},()=>{this.opt.done(s)})):this.opt.done(s)}unmark(e){this.opt=e;let t=this.opt.element?this.opt.element:"*";t+="[data-markjs]",this.opt.className&&(t+=`.${this.opt.className}`),this.log(`Removal selector "${t}"`),this.iterator.forEachNode(NodeFilter.SHOW_ELEMENT,s=>{this.unwrapMatches(s)},s=>{const n=ce.matches(s,t),r=this.matchesExclude(s);return!n||r?NodeFilter.FILTER_REJECT:NodeFilter.FILTER_ACCEPT},this.opt.done)}};function Ps(a){const e=new zs(a);return this.mark=(t,s)=>(e.mark(t,s),this),this.markRegExp=(t,s)=>(e.markRegExp(t,s),this),this.markRanges=(t,s)=>(e.markRanges(t,s),this),this.unmark=t=>(e.unmark(t),this),this}function ke(a,e,t,s){function n(r){return r instanceof t?r:new t(function(i){i(r)})}return new(t||(t=Promise))(function(r,i){function o(h){try{c(s.next(h))}catch(m){i(m)}}function l(h){try{c(s.throw(h))}catch(m){i(m)}}function c(h){h.done?r(h.value):n(h.value).then(o,l)}c((s=s.apply(a,[])).next())})}const js="ENTRIES",_t="KEYS",St="VALUES",D="";class De{constructor(e,t){const s=e._tree,n=Array.from(s.keys());this.set=e,this._type=t,this._path=n.length>0?[{node:s,keys:n}]:[]}next(){const e=this.dive();return this.backtrack(),e}dive(){if(this._path.length===0)return{done:!0,value:void 0};const{node:e,keys:t}=le(this._path);if(le(t)===D)return{done:!1,value:this.result()};const s=e.get(le(t));return this._path.push({node:s,keys:Array.from(s.keys())}),this.dive()}backtrack(){if(this._path.length===0)return;const e=le(this._path).keys;e.pop(),!(e.length>0)&&(this._path.pop(),this.backtrack())}key(){return this.set._prefix+this._path.map(({keys:e})=>le(e)).filter(e=>e!==D).join("")}value(){return le(this._path).node.get(D)}result(){switch(this._type){case St:return this.value();case _t:return this.key();default:return[this.key(),this.value()]}}[Symbol.iterator](){return this}}const le=a=>a[a.length-1],Vs=(a,e,t)=>{const s=new Map;if(e===void 0)return s;const n=e.length+1,r=n+t,i=new Uint8Array(r*n).fill(t+1);for(let o=0;o{const l=r*i;e:for(const c of a.keys())if(c===D){const h=n[l-1];h<=t&&s.set(o,[a.get(c),h])}else{let h=r;for(let m=0;mt)continue e}Et(a.get(c),e,t,s,n,h,i,o+c)}};class X{constructor(e=new Map,t=""){this._size=void 0,this._tree=e,this._prefix=t}atPrefix(e){if(!e.startsWith(this._prefix))throw new Error("Mismatched prefix");const[t,s]=Re(this._tree,e.slice(this._prefix.length));if(t===void 0){const[n,r]=qe(s);for(const i of n.keys())if(i!==D&&i.startsWith(r)){const o=new Map;return o.set(i.slice(r.length),n.get(i)),new X(o,e)}}return new X(t,e)}clear(){this._size=void 0,this._tree.clear()}delete(e){return this._size=void 0,$s(this._tree,e)}entries(){return new De(this,js)}forEach(e){for(const[t,s]of this)e(t,s,this)}fuzzyGet(e,t){return Vs(this._tree,e,t)}get(e){const t=Ke(this._tree,e);return t!==void 0?t.get(D):void 0}has(e){const t=Ke(this._tree,e);return t!==void 0&&t.has(D)}keys(){return new De(this,_t)}set(e,t){if(typeof e!="string")throw new Error("key must be a string");return this._size=void 0,ze(this._tree,e).set(D,t),this}get size(){if(this._size)return this._size;this._size=0;const e=this.entries();for(;!e.next().done;)this._size+=1;return this._size}update(e,t){if(typeof e!="string")throw new Error("key must be a string");this._size=void 0;const s=ze(this._tree,e);return s.set(D,t(s.get(D))),this}fetch(e,t){if(typeof e!="string")throw new Error("key must be a string");this._size=void 0;const s=ze(this._tree,e);let n=s.get(D);return n===void 0&&s.set(D,n=t()),n}values(){return new De(this,St)}[Symbol.iterator](){return this.entries()}static from(e){const t=new X;for(const[s,n]of e)t.set(s,n);return t}static fromObject(e){return X.from(Object.entries(e))}}const Re=(a,e,t=[])=>{if(e.length===0||a==null)return[a,t];for(const s of a.keys())if(s!==D&&e.startsWith(s))return t.push([a,s]),Re(a.get(s),e.slice(s.length),t);return t.push([a,e]),Re(void 0,"",t)},Ke=(a,e)=>{if(e.length===0||a==null)return a;for(const t of a.keys())if(t!==D&&e.startsWith(t))return Ke(a.get(t),e.slice(t.length))},ze=(a,e)=>{const t=e.length;e:for(let s=0;a&&s{const[t,s]=Re(a,e);if(t!==void 0){if(t.delete(D),t.size===0)Tt(s);else if(t.size===1){const[n,r]=t.entries().next().value;It(s,n,r)}}},Tt=a=>{if(a.length===0)return;const[e,t]=qe(a);if(e.delete(t),e.size===0)Tt(a.slice(0,-1));else if(e.size===1){const[s,n]=e.entries().next().value;s!==D&&It(a.slice(0,-1),s,n)}},It=(a,e,t)=>{if(a.length===0)return;const[s,n]=qe(a);s.set(n+e,t),s.delete(n)},qe=a=>a[a.length-1],Ge="or",kt="and",Bs="and_not";class ue{constructor(e){if((e==null?void 0:e.fields)==null)throw new Error('MiniSearch: option "fields" must be provided');const t=e.autoVacuum==null||e.autoVacuum===!0?Ve:e.autoVacuum;this._options=Object.assign(Object.assign(Object.assign({},je),e),{autoVacuum:t,searchOptions:Object.assign(Object.assign({},ht),e.searchOptions||{}),autoSuggestOptions:Object.assign(Object.assign({},qs),e.autoSuggestOptions||{})}),this._index=new X,this._documentCount=0,this._documentIds=new Map,this._idToShortId=new Map,this._fieldIds={},this._fieldLength=new Map,this._avgFieldLength=[],this._nextId=0,this._storedFields=new Map,this._dirtCount=0,this._currentVacuum=null,this._enqueuedVacuum=null,this._enqueuedVacuumConditions=Ue,this.addFields(this._options.fields)}add(e){const{extractField:t,tokenize:s,processTerm:n,fields:r,idField:i}=this._options,o=t(e,i);if(o==null)throw new Error(`MiniSearch: document does not have ID field "${i}"`);if(this._idToShortId.has(o))throw new Error(`MiniSearch: duplicate ID ${o}`);const l=this.addDocumentId(o);this.saveStoredFields(l,e);for(const c of r){const h=t(e,c);if(h==null)continue;const m=s(h.toString(),c),f=this._fieldIds[c],b=new Set(m).size;this.addFieldLength(l,f,this._documentCount-1,b);for(const y of m){const x=n(y,c);if(Array.isArray(x))for(const w of x)this.addTerm(f,l,w);else x&&this.addTerm(f,l,x)}}}addAll(e){for(const t of e)this.add(t)}addAllAsync(e,t={}){const{chunkSize:s=10}=t,n={chunk:[],promise:Promise.resolve()},{chunk:r,promise:i}=e.reduce(({chunk:o,promise:l},c,h)=>(o.push(c),(h+1)%s===0?{chunk:[],promise:l.then(()=>new Promise(m=>setTimeout(m,0))).then(()=>this.addAll(o))}:{chunk:o,promise:l}),n);return i.then(()=>this.addAll(r))}remove(e){const{tokenize:t,processTerm:s,extractField:n,fields:r,idField:i}=this._options,o=n(e,i);if(o==null)throw new Error(`MiniSearch: document does not have ID field "${i}"`);const l=this._idToShortId.get(o);if(l==null)throw new Error(`MiniSearch: cannot remove document with ID ${o}: it is not in the index`);for(const c of r){const h=n(e,c);if(h==null)continue;const m=t(h.toString(),c),f=this._fieldIds[c],b=new Set(m).size;this.removeFieldLength(l,f,this._documentCount,b);for(const y of m){const x=s(y,c);if(Array.isArray(x))for(const w of x)this.removeTerm(f,l,w);else x&&this.removeTerm(f,l,x)}}this._storedFields.delete(l),this._documentIds.delete(l),this._idToShortId.delete(o),this._fieldLength.delete(l),this._documentCount-=1}removeAll(e){if(e)for(const t of e)this.remove(t);else{if(arguments.length>0)throw new Error("Expected documents to be present. Omit the argument to remove all documents.");this._index=new X,this._documentCount=0,this._documentIds=new Map,this._idToShortId=new Map,this._fieldLength=new Map,this._avgFieldLength=[],this._storedFields=new Map,this._nextId=0}}discard(e){const t=this._idToShortId.get(e);if(t==null)throw new Error(`MiniSearch: cannot discard document with ID ${e}: it is not in the index`);this._idToShortId.delete(e),this._documentIds.delete(t),this._storedFields.delete(t),(this._fieldLength.get(t)||[]).forEach((s,n)=>{this.removeFieldLength(t,n,this._documentCount,s)}),this._fieldLength.delete(t),this._documentCount-=1,this._dirtCount+=1,this.maybeAutoVacuum()}maybeAutoVacuum(){if(this._options.autoVacuum===!1)return;const{minDirtFactor:e,minDirtCount:t,batchSize:s,batchWait:n}=this._options.autoVacuum;this.conditionalVacuum({batchSize:s,batchWait:n},{minDirtCount:t,minDirtFactor:e})}discardAll(e){const t=this._options.autoVacuum;try{this._options.autoVacuum=!1;for(const s of e)this.discard(s)}finally{this._options.autoVacuum=t}this.maybeAutoVacuum()}replace(e){const{idField:t,extractField:s}=this._options,n=s(e,t);this.discard(n),this.add(e)}vacuum(e={}){return this.conditionalVacuum(e)}conditionalVacuum(e,t){return this._currentVacuum?(this._enqueuedVacuumConditions=this._enqueuedVacuumConditions&&t,this._enqueuedVacuum!=null?this._enqueuedVacuum:(this._enqueuedVacuum=this._currentVacuum.then(()=>{const s=this._enqueuedVacuumConditions;return this._enqueuedVacuumConditions=Ue,this.performVacuuming(e,s)}),this._enqueuedVacuum)):this.vacuumConditionsMet(t)===!1?Promise.resolve():(this._currentVacuum=this.performVacuuming(e),this._currentVacuum)}performVacuuming(e,t){return ke(this,void 0,void 0,function*(){const s=this._dirtCount;if(this.vacuumConditionsMet(t)){const n=e.batchSize||Je.batchSize,r=e.batchWait||Je.batchWait;let i=1;for(const[o,l]of this._index){for(const[c,h]of l)for(const[m]of h)this._documentIds.has(m)||(h.size<=1?l.delete(c):h.delete(m));this._index.get(o).size===0&&this._index.delete(o),i%n===0&&(yield new Promise(c=>setTimeout(c,r))),i+=1}this._dirtCount-=s}yield null,this._currentVacuum=this._enqueuedVacuum,this._enqueuedVacuum=null})}vacuumConditionsMet(e){if(e==null)return!0;let{minDirtCount:t,minDirtFactor:s}=e;return t=t||Ve.minDirtCount,s=s||Ve.minDirtFactor,this.dirtCount>=t&&this.dirtFactor>=s}get isVacuuming(){return this._currentVacuum!=null}get dirtCount(){return this._dirtCount}get dirtFactor(){return this._dirtCount/(1+this._documentCount+this._dirtCount)}has(e){return this._idToShortId.has(e)}getStoredFields(e){const t=this._idToShortId.get(e);if(t!=null)return this._storedFields.get(t)}search(e,t={}){const{searchOptions:s}=this._options,n=Object.assign(Object.assign({},s),t),r=this.executeQuery(e,t),i=[];for(const[o,{score:l,terms:c,match:h}]of r){const m=c.length||1,f={id:this._documentIds.get(o),score:l*m,terms:Object.keys(h),queryTerms:c,match:h};Object.assign(f,this._storedFields.get(o)),(n.filter==null||n.filter(f))&&i.push(f)}return e===ue.wildcard&&n.boostDocument==null||i.sort(pt),i}autoSuggest(e,t={}){t=Object.assign(Object.assign({},this._options.autoSuggestOptions),t);const s=new Map;for(const{score:r,terms:i}of this.search(e,t)){const o=i.join(" "),l=s.get(o);l!=null?(l.score+=r,l.count+=1):s.set(o,{score:r,terms:i,count:1})}const n=[];for(const[r,{score:i,terms:o,count:l}]of s)n.push({suggestion:r,terms:o,score:i/l});return n.sort(pt),n}get documentCount(){return this._documentCount}get termCount(){return this._index.size}static loadJSON(e,t){if(t==null)throw new Error("MiniSearch: loadJSON should be given the same options used when serializing the index");return this.loadJS(JSON.parse(e),t)}static loadJSONAsync(e,t){return ke(this,void 0,void 0,function*(){if(t==null)throw new Error("MiniSearch: loadJSON should be given the same options used when serializing the index");return this.loadJSAsync(JSON.parse(e),t)})}static getDefault(e){if(je.hasOwnProperty(e))return Pe(je,e);throw new Error(`MiniSearch: unknown option "${e}"`)}static loadJS(e,t){const{index:s,documentIds:n,fieldLength:r,storedFields:i,serializationVersion:o}=e,l=this.instantiateMiniSearch(e,t);l._documentIds=Te(n),l._fieldLength=Te(r),l._storedFields=Te(i);for(const[c,h]of l._documentIds)l._idToShortId.set(h,c);for(const[c,h]of s){const m=new Map;for(const f of Object.keys(h)){let b=h[f];o===1&&(b=b.ds),m.set(parseInt(f,10),Te(b))}l._index.set(c,m)}return l}static loadJSAsync(e,t){return ke(this,void 0,void 0,function*(){const{index:s,documentIds:n,fieldLength:r,storedFields:i,serializationVersion:o}=e,l=this.instantiateMiniSearch(e,t);l._documentIds=yield Ie(n),l._fieldLength=yield Ie(r),l._storedFields=yield Ie(i);for(const[h,m]of l._documentIds)l._idToShortId.set(m,h);let c=0;for(const[h,m]of s){const f=new Map;for(const b of Object.keys(m)){let y=m[b];o===1&&(y=y.ds),f.set(parseInt(b,10),yield Ie(y))}++c%1e3===0&&(yield Nt(0)),l._index.set(h,f)}return l})}static instantiateMiniSearch(e,t){const{documentCount:s,nextId:n,fieldIds:r,averageFieldLength:i,dirtCount:o,serializationVersion:l}=e;if(l!==1&&l!==2)throw new Error("MiniSearch: cannot deserialize an index created with an incompatible version");const c=new ue(t);return c._documentCount=s,c._nextId=n,c._idToShortId=new Map,c._fieldIds=r,c._avgFieldLength=i,c._dirtCount=o||0,c._index=new X,c}executeQuery(e,t={}){if(e===ue.wildcard)return this.executeWildcardQuery(t);if(typeof e!="string"){const f=Object.assign(Object.assign(Object.assign({},t),e),{queries:void 0}),b=e.queries.map(y=>this.executeQuery(y,f));return this.combineResults(b,f.combineWith)}const{tokenize:s,processTerm:n,searchOptions:r}=this._options,i=Object.assign(Object.assign({tokenize:s,processTerm:n},r),t),{tokenize:o,processTerm:l}=i,m=o(e).flatMap(f=>l(f)).filter(f=>!!f).map(Us(i)).map(f=>this.executeQuerySpec(f,i));return this.combineResults(m,i.combineWith)}executeQuerySpec(e,t){const s=Object.assign(Object.assign({},this._options.searchOptions),t),n=(s.fields||this._options.fields).reduce((x,w)=>Object.assign(Object.assign({},x),{[w]:Pe(s.boost,w)||1}),{}),{boostDocument:r,weights:i,maxFuzzy:o,bm25:l}=s,{fuzzy:c,prefix:h}=Object.assign(Object.assign({},ht.weights),i),m=this._index.get(e.term),f=this.termResults(e.term,e.term,1,e.termBoost,m,n,r,l);let b,y;if(e.prefix&&(b=this._index.atPrefix(e.term)),e.fuzzy){const x=e.fuzzy===!0?.2:e.fuzzy,w=x<1?Math.min(o,Math.round(e.term.length*x)):x;w&&(y=this._index.fuzzyGet(e.term,w))}if(b)for(const[x,w]of b){const R=x.length-e.term.length;if(!R)continue;y==null||y.delete(x);const A=h*x.length/(x.length+.3*R);this.termResults(e.term,x,A,e.termBoost,w,n,r,l,f)}if(y)for(const x of y.keys()){const[w,R]=y.get(x);if(!R)continue;const A=c*x.length/(x.length+R);this.termResults(e.term,x,A,e.termBoost,w,n,r,l,f)}return f}executeWildcardQuery(e){const t=new Map,s=Object.assign(Object.assign({},this._options.searchOptions),e);for(const[n,r]of this._documentIds){const i=s.boostDocument?s.boostDocument(r,"",this._storedFields.get(n)):1;t.set(n,{score:i,terms:[],match:{}})}return t}combineResults(e,t=Ge){if(e.length===0)return new Map;const s=t.toLowerCase(),n=Ws[s];if(!n)throw new Error(`Invalid combination operator: ${t}`);return e.reduce(n)||new Map}toJSON(){const e=[];for(const[t,s]of this._index){const n={};for(const[r,i]of s)n[r]=Object.fromEntries(i);e.push([t,n])}return{documentCount:this._documentCount,nextId:this._nextId,documentIds:Object.fromEntries(this._documentIds),fieldIds:this._fieldIds,fieldLength:Object.fromEntries(this._fieldLength),averageFieldLength:this._avgFieldLength,storedFields:Object.fromEntries(this._storedFields),dirtCount:this._dirtCount,index:e,serializationVersion:2}}termResults(e,t,s,n,r,i,o,l,c=new Map){if(r==null)return c;for(const h of Object.keys(i)){const m=i[h],f=this._fieldIds[h],b=r.get(f);if(b==null)continue;let y=b.size;const x=this._avgFieldLength[f];for(const w of b.keys()){if(!this._documentIds.has(w)){this.removeTerm(f,w,t),y-=1;continue}const R=o?o(this._documentIds.get(w),t,this._storedFields.get(w)):1;if(!R)continue;const A=b.get(w),J=this._fieldLength.get(w)[f],Q=Js(A,y,this._documentCount,J,x,l),W=s*n*m*R*Q,V=c.get(w);if(V){V.score+=W,Gs(V.terms,e);const $=Pe(V.match,t);$?$.push(h):V.match[t]=[h]}else c.set(w,{score:W,terms:[e],match:{[t]:[h]}})}}return c}addTerm(e,t,s){const n=this._index.fetch(s,vt);let r=n.get(e);if(r==null)r=new Map,r.set(t,1),n.set(e,r);else{const i=r.get(t);r.set(t,(i||0)+1)}}removeTerm(e,t,s){if(!this._index.has(s)){this.warnDocumentChanged(t,e,s);return}const n=this._index.fetch(s,vt),r=n.get(e);r==null||r.get(t)==null?this.warnDocumentChanged(t,e,s):r.get(t)<=1?r.size<=1?n.delete(e):r.delete(t):r.set(t,r.get(t)-1),this._index.get(s).size===0&&this._index.delete(s)}warnDocumentChanged(e,t,s){for(const n of Object.keys(this._fieldIds))if(this._fieldIds[n]===t){this._options.logger("warn",`MiniSearch: document with ID ${this._documentIds.get(e)} has changed before removal: term "${s}" was not present in field "${n}". Removing a document after it has changed can corrupt the index!`,"version_conflict");return}}addDocumentId(e){const t=this._nextId;return this._idToShortId.set(e,t),this._documentIds.set(t,e),this._documentCount+=1,this._nextId+=1,t}addFields(e){for(let t=0;tObject.prototype.hasOwnProperty.call(a,e)?a[e]:void 0,Ws={[Ge]:(a,e)=>{for(const t of e.keys()){const s=a.get(t);if(s==null)a.set(t,e.get(t));else{const{score:n,terms:r,match:i}=e.get(t);s.score=s.score+n,s.match=Object.assign(s.match,i),ft(s.terms,r)}}return a},[kt]:(a,e)=>{const t=new Map;for(const s of e.keys()){const n=a.get(s);if(n==null)continue;const{score:r,terms:i,match:o}=e.get(s);ft(n.terms,i),t.set(s,{score:n.score+r,terms:n.terms,match:Object.assign(n.match,o)})}return t},[Bs]:(a,e)=>{for(const t of e.keys())a.delete(t);return a}},Ks={k:1.2,b:.7,d:.5},Js=(a,e,t,s,n,r)=>{const{k:i,b:o,d:l}=r;return Math.log(1+(t-e+.5)/(e+.5))*(l+a*(i+1)/(a+i*(1-o+o*s/n)))},Us=a=>(e,t,s)=>{const n=typeof a.fuzzy=="function"?a.fuzzy(e,t,s):a.fuzzy||!1,r=typeof a.prefix=="function"?a.prefix(e,t,s):a.prefix===!0,i=typeof a.boostTerm=="function"?a.boostTerm(e,t,s):1;return{term:e,fuzzy:n,prefix:r,termBoost:i}},je={idField:"id",extractField:(a,e)=>a[e],tokenize:a=>a.split(Hs),processTerm:a=>a.toLowerCase(),fields:void 0,searchOptions:void 0,storeFields:[],logger:(a,e)=>{typeof(console==null?void 0:console[a])=="function"&&console[a](e)},autoVacuum:!0},ht={combineWith:Ge,prefix:!1,fuzzy:!1,maxFuzzy:6,boost:{},weights:{fuzzy:.45,prefix:.375},bm25:Ks},qs={combineWith:kt,prefix:(a,e,t)=>e===t.length-1},Je={batchSize:1e3,batchWait:10},Ue={minDirtFactor:.1,minDirtCount:20},Ve=Object.assign(Object.assign({},Je),Ue),Gs=(a,e)=>{a.includes(e)||a.push(e)},ft=(a,e)=>{for(const t of e)a.includes(t)||a.push(t)},pt=({score:a},{score:e})=>e-a,vt=()=>new Map,Te=a=>{const e=new Map;for(const t of Object.keys(a))e.set(parseInt(t,10),a[t]);return e},Ie=a=>ke(void 0,void 0,void 0,function*(){const e=new Map;let t=0;for(const s of Object.keys(a))e.set(parseInt(s,10),a[s]),++t%1e3===0&&(yield Nt(0));return e}),Nt=a=>new Promise(e=>setTimeout(e,a)),Hs=/[\n\r\p{Z}\p{P}]+/u;class Qs{constructor(e=10){Ae(this,"max");Ae(this,"cache");this.max=e,this.cache=new Map}get(e){let t=this.cache.get(e);return t!==void 0&&(this.cache.delete(e),this.cache.set(e,t)),t}set(e,t){this.cache.has(e)?this.cache.delete(e):this.cache.size===this.max&&this.cache.delete(this.first()),this.cache.set(e,t)}first(){return this.cache.keys().next().value}clear(){this.cache.clear()}}const Ys=["aria-owns"],Zs={class:"shell"},Xs=["title"],en={class:"search-actions before"},tn=["title"],sn=["aria-activedescendant","aria-controls","placeholder"],nn={class:"search-actions"},rn=["title"],an=["disabled","title"],on=["id","role","aria-labelledby"],ln=["id","aria-selected"],cn=["href","aria-label","onMouseenter","onFocusin","data-index"],un={class:"titles"},dn=["innerHTML"],hn={class:"title main"},fn=["innerHTML"],pn={key:0,class:"excerpt-wrapper"},vn={key:0,class:"excerpt",inert:""},mn=["innerHTML"],gn={key:0,class:"no-results"},bn={class:"search-keyboard-shortcuts"},yn=["aria-label"],wn=["aria-label"],xn=["aria-label"],_n=["aria-label"],Sn=Lt({__name:"VPLocalSearchBox",emits:["close"],setup(a,{emit:e}){var S,C;const t=e,s=xe(),n=xe(),r=xe(is),i=ss(),{activate:o}=Ds(s,{immediate:!0,allowOutsideClick:!0,clickOutsideDeactivates:!0,escapeDeactivates:!0}),{localeIndex:l,theme:c}=i,h=st(async()=>{var v,p,E,F,z,P,j,I,K;return at(ue.loadJSON((E=await((p=(v=r.value)[l.value])==null?void 0:p.call(v)))==null?void 0:E.default,{fields:["title","titles","text"],storeFields:["title","titles"],searchOptions:{fuzzy:.2,prefix:!0,boost:{title:4,text:2,titles:1},...((F=c.value.search)==null?void 0:F.provider)==="local"&&((P=(z=c.value.search.options)==null?void 0:z.miniSearch)==null?void 0:P.searchOptions)},...((j=c.value.search)==null?void 0:j.provider)==="local"&&((K=(I=c.value.search.options)==null?void 0:I.miniSearch)==null?void 0:K.options)}))}),f=me(()=>{var v,p;return((v=c.value.search)==null?void 0:v.provider)==="local"&&((p=c.value.search.options)==null?void 0:p.disableQueryPersistence)===!0}).value?ie(""):Dt("vitepress:local-search-filter",""),b=zt("vitepress:local-search-detailed-list",((S=c.value.search)==null?void 0:S.provider)==="local"&&((C=c.value.search.options)==null?void 0:C.detailedView)===!0),y=me(()=>{var v,p,E;return((v=c.value.search)==null?void 0:v.provider)==="local"&&(((p=c.value.search.options)==null?void 0:p.disableDetailedView)===!0||((E=c.value.search.options)==null?void 0:E.detailedView)===!1)}),x=me(()=>{var p,E,F,z,P,j,I;const v=((p=c.value.search)==null?void 0:p.options)??c.value.algolia;return((P=(z=(F=(E=v==null?void 0:v.locales)==null?void 0:E[l.value])==null?void 0:F.translations)==null?void 0:z.button)==null?void 0:P.buttonText)||((I=(j=v==null?void 0:v.translations)==null?void 0:j.button)==null?void 0:I.buttonText)||"Search"});Pt(()=>{y.value&&(b.value=!1)});const w=xe([]),R=ie(!1);$e(f,()=>{R.value=!1});const A=st(async()=>{if(n.value)return at(new Ps(n.value))},null),J=new Qs(16);jt(()=>[h.value,f.value,b.value],async([v,p,E],F,z)=>{var ee,ye,He,Qe;(F==null?void 0:F[0])!==v&&J.clear();let P=!1;if(z(()=>{P=!0}),!v)return;w.value=v.search(p).slice(0,16),R.value=!0;const j=E?await Promise.all(w.value.map(B=>Q(B.id))):[];if(P)return;for(const{id:B,mod:te}of j){const se=B.slice(0,B.indexOf("#"));let Y=J.get(se);if(Y)continue;Y=new Map,J.set(se,Y);const G=te.default??te;if(G!=null&&G.render||G!=null&&G.setup){const ne=Yt(G);ne.config.warnHandler=()=>{},ne.provide(Zt,i),Object.defineProperties(ne.config.globalProperties,{$frontmatter:{get(){return i.frontmatter.value}},$params:{get(){return i.page.value.params}}});const Ye=document.createElement("div");ne.mount(Ye),Ye.querySelectorAll("h1, h2, h3, h4, h5, h6").forEach(de=>{var et;const we=(et=de.querySelector("a"))==null?void 0:et.getAttribute("href"),Ze=(we==null?void 0:we.startsWith("#"))&&we.slice(1);if(!Ze)return;let Xe="";for(;(de=de.nextElementSibling)&&!/^h[1-6]$/i.test(de.tagName);)Xe+=de.outerHTML;Y.set(Ze,Xe)}),ne.unmount()}if(P)return}const I=new Set;if(w.value=w.value.map(B=>{const[te,se]=B.id.split("#"),Y=J.get(te),G=(Y==null?void 0:Y.get(se))??"";for(const ne in B.match)I.add(ne);return{...B,text:G}}),await he(),P)return;await new Promise(B=>{var te;(te=A.value)==null||te.unmark({done:()=>{var se;(se=A.value)==null||se.markRegExp(k(I),{done:B})}})});const K=((ee=s.value)==null?void 0:ee.querySelectorAll(".result .excerpt"))??[];for(const B of K)(ye=B.querySelector('mark[data-markjs="true"]'))==null||ye.scrollIntoView({block:"center"});(Qe=(He=n.value)==null?void 0:He.firstElementChild)==null||Qe.scrollIntoView({block:"start"})},{debounce:200,immediate:!0});async function Q(v){const p=Xt(v.slice(0,v.indexOf("#")));try{if(!p)throw new Error(`Cannot find file for id: ${v}`);return{id:v,mod:await import(p)}}catch(E){return console.error(E),{id:v,mod:{}}}}const W=ie(),V=me(()=>{var v;return((v=f.value)==null?void 0:v.length)<=0});function $(v=!0){var p,E;(p=W.value)==null||p.focus(),v&&((E=W.value)==null||E.select())}Me(()=>{$()});function be(v){v.pointerType==="mouse"&&$()}const M=ie(-1),U=ie(!0);$e(w,v=>{M.value=v.length?0:-1,q()});function q(){he(()=>{const v=document.querySelector(".result.selected");v==null||v.scrollIntoView({block:"nearest"})})}_e("ArrowUp",v=>{v.preventDefault(),M.value--,M.value<0&&(M.value=w.value.length-1),U.value=!0,q()}),_e("ArrowDown",v=>{v.preventDefault(),M.value++,M.value>=w.value.length&&(M.value=0),U.value=!0,q()});const N=Vt();_e("Enter",v=>{if(v.isComposing||v.target instanceof HTMLButtonElement&&v.target.type!=="submit")return;const p=w.value[M.value];if(v.target instanceof HTMLInputElement&&!p){v.preventDefault();return}p&&(N.go(p.id),t("close"))}),_e("Escape",()=>{t("close")});const d=ns({modal:{displayDetails:"Display detailed list",resetButtonTitle:"Reset search",backButtonTitle:"Close search",noResultsText:"No results for",footer:{selectText:"to select",selectKeyAriaLabel:"enter",navigateText:"to navigate",navigateUpKeyAriaLabel:"up arrow",navigateDownKeyAriaLabel:"down arrow",closeText:"to close",closeKeyAriaLabel:"escape"}}});Me(()=>{window.history.pushState(null,"",null)}),$t("popstate",v=>{v.preventDefault(),t("close")});const g=Bt(Wt?document.body:null);Me(()=>{he(()=>{g.value=!0,he().then(()=>o())})}),Kt(()=>{g.value=!1});function T(){f.value="",he().then(()=>$(!1))}function k(v){return new RegExp([...v].sort((p,E)=>E.length-p.length).map(p=>`(${es(p)})`).join("|"),"gi")}function O(v){var F;if(!U.value)return;const p=(F=v.target)==null?void 0:F.closest(".result"),E=Number.parseInt(p==null?void 0:p.dataset.index);E>=0&&E!==M.value&&(M.value=E),U.value=!1}return(v,p)=>{var E,F,z,P,j;return H(),Jt(Qt,{to:"body"},[_("div",{ref_key:"el",ref:s,role:"button","aria-owns":(E=w.value)!=null&&E.length?"localsearch-list":void 0,"aria-expanded":"true","aria-haspopup":"listbox","aria-labelledby":"localsearch-label",class:"VPLocalSearchBox"},[_("div",{class:"backdrop",onClick:p[0]||(p[0]=I=>v.$emit("close"))}),_("div",Zs,[_("form",{class:"search-bar",onPointerup:p[4]||(p[4]=I=>be(I)),onSubmit:p[5]||(p[5]=Ut(()=>{},["prevent"]))},[_("label",{title:x.value,id:"localsearch-label",for:"localsearch-input"},p[7]||(p[7]=[_("span",{"aria-hidden":"true",class:"vpi-search search-icon local-search-icon"},null,-1)]),8,Xs),_("div",en,[_("button",{class:"back-button",title:L(d)("modal.backButtonTitle"),onClick:p[1]||(p[1]=I=>v.$emit("close"))},p[8]||(p[8]=[_("span",{class:"vpi-arrow-left local-search-icon"},null,-1)]),8,tn)]),qt(_("input",{ref_key:"searchInput",ref:W,"onUpdate:modelValue":p[2]||(p[2]=I=>Ht(f)?f.value=I:null),"aria-activedescendant":M.value>-1?"localsearch-item-"+M.value:void 0,"aria-autocomplete":"both","aria-controls":(F=w.value)!=null&&F.length?"localsearch-list":void 0,"aria-labelledby":"localsearch-label",autocapitalize:"off",autocomplete:"off",autocorrect:"off",class:"search-input",id:"localsearch-input",enterkeyhint:"go",maxlength:"64",placeholder:x.value,spellcheck:"false",type:"search"},null,8,sn),[[Gt,L(f)]]),_("div",nn,[y.value?Se("",!0):(H(),Z("button",{key:0,class:nt(["toggle-layout-button",{"detailed-list":L(b)}]),type:"button",title:L(d)("modal.displayDetails"),onClick:p[3]||(p[3]=I=>M.value>-1&&(b.value=!L(b)))},p[9]||(p[9]=[_("span",{class:"vpi-layout-list local-search-icon"},null,-1)]),10,rn)),_("button",{class:"clear-button",type:"reset",disabled:V.value,title:L(d)("modal.resetButtonTitle"),onClick:T},p[10]||(p[10]=[_("span",{class:"vpi-delete local-search-icon"},null,-1)]),8,an)])],32),_("ul",{ref_key:"resultsEl",ref:n,id:(z=w.value)!=null&&z.length?"localsearch-list":void 0,role:(P=w.value)!=null&&P.length?"listbox":void 0,"aria-labelledby":(j=w.value)!=null&&j.length?"localsearch-label":void 0,class:"results",onMousemove:O},[(H(!0),Z(rt,null,it(w.value,(I,K)=>(H(),Z("li",{key:I.id,id:"localsearch-item-"+K,"aria-selected":M.value===K?"true":"false",role:"option"},[_("a",{href:I.id,class:nt(["result",{selected:M.value===K}]),"aria-label":[...I.titles,I.title].join(" > "),onMouseenter:ee=>!U.value&&(M.value=K),onFocusin:ee=>M.value=K,onClick:p[6]||(p[6]=ee=>v.$emit("close")),"data-index":K},[_("div",null,[_("div",un,[p[12]||(p[12]=_("span",{class:"title-icon"},"#",-1)),(H(!0),Z(rt,null,it(I.titles,(ee,ye)=>(H(),Z("span",{key:ye,class:"title"},[_("span",{class:"text",innerHTML:ee},null,8,dn),p[11]||(p[11]=_("span",{class:"vpi-chevron-right local-search-icon"},null,-1))]))),128)),_("span",hn,[_("span",{class:"text",innerHTML:I.title},null,8,fn)])]),L(b)?(H(),Z("div",pn,[I.text?(H(),Z("div",vn,[_("div",{class:"vp-doc",innerHTML:I.text},null,8,mn)])):Se("",!0),p[13]||(p[13]=_("div",{class:"excerpt-gradient-bottom"},null,-1)),p[14]||(p[14]=_("div",{class:"excerpt-gradient-top"},null,-1))])):Se("",!0)])],42,cn)],8,ln))),128)),L(f)&&!w.value.length&&R.value?(H(),Z("li",gn,[fe(pe(L(d)("modal.noResultsText"))+' "',1),_("strong",null,pe(L(f)),1),p[15]||(p[15]=fe('" '))])):Se("",!0)],40,on),_("div",bn,[_("span",null,[_("kbd",{"aria-label":L(d)("modal.footer.navigateUpKeyAriaLabel")},p[16]||(p[16]=[_("span",{class:"vpi-arrow-up navigate-icon"},null,-1)]),8,yn),_("kbd",{"aria-label":L(d)("modal.footer.navigateDownKeyAriaLabel")},p[17]||(p[17]=[_("span",{class:"vpi-arrow-down navigate-icon"},null,-1)]),8,wn),fe(" "+pe(L(d)("modal.footer.navigateText")),1)]),_("span",null,[_("kbd",{"aria-label":L(d)("modal.footer.selectKeyAriaLabel")},p[18]||(p[18]=[_("span",{class:"vpi-corner-down-left navigate-icon"},null,-1)]),8,xn),fe(" "+pe(L(d)("modal.footer.selectText")),1)]),_("span",null,[_("kbd",{"aria-label":L(d)("modal.footer.closeKeyAriaLabel")},"esc",8,_n),fe(" "+pe(L(d)("modal.footer.closeText")),1)])])])],8,Ys)])}}}),Fn=ts(Sn,[["__scopeId","data-v-42e65fb9"]]);export{Fn as default}; diff --git a/previews/PR237/assets/chunks/framework.Cq8AuEls.js b/previews/PR237/assets/chunks/framework.Cq8AuEls.js new file mode 100644 index 000000000..689f0a237 --- /dev/null +++ b/previews/PR237/assets/chunks/framework.Cq8AuEls.js @@ -0,0 +1,18 @@ +/** +* @vue/shared v3.5.13 +* (c) 2018-present Yuxi (Evan) You and Vue contributors +* @license MIT +**//*! #__NO_SIDE_EFFECTS__ */function Ns(e){const t=Object.create(null);for(const n of e.split(","))t[n]=1;return n=>n in t}const Z={},Et=[],ke=()=>{},Ko=()=>!1,en=e=>e.charCodeAt(0)===111&&e.charCodeAt(1)===110&&(e.charCodeAt(2)>122||e.charCodeAt(2)<97),Fs=e=>e.startsWith("onUpdate:"),ae=Object.assign,Hs=(e,t)=>{const n=e.indexOf(t);n>-1&&e.splice(n,1)},qo=Object.prototype.hasOwnProperty,z=(e,t)=>qo.call(e,t),W=Array.isArray,Tt=e=>In(e)==="[object Map]",ii=e=>In(e)==="[object Set]",q=e=>typeof e=="function",re=e=>typeof e=="string",Xe=e=>typeof e=="symbol",ne=e=>e!==null&&typeof e=="object",oi=e=>(ne(e)||q(e))&&q(e.then)&&q(e.catch),li=Object.prototype.toString,In=e=>li.call(e),Go=e=>In(e).slice(8,-1),ci=e=>In(e)==="[object Object]",$s=e=>re(e)&&e!=="NaN"&&e[0]!=="-"&&""+parseInt(e,10)===e,Ct=Ns(",key,ref,ref_for,ref_key,onVnodeBeforeMount,onVnodeMounted,onVnodeBeforeUpdate,onVnodeUpdated,onVnodeBeforeUnmount,onVnodeUnmounted"),Nn=e=>{const t=Object.create(null);return n=>t[n]||(t[n]=e(n))},Yo=/-(\w)/g,Le=Nn(e=>e.replace(Yo,(t,n)=>n?n.toUpperCase():"")),Xo=/\B([A-Z])/g,st=Nn(e=>e.replace(Xo,"-$1").toLowerCase()),Fn=Nn(e=>e.charAt(0).toUpperCase()+e.slice(1)),_n=Nn(e=>e?`on${Fn(e)}`:""),tt=(e,t)=>!Object.is(e,t),bn=(e,...t)=>{for(let n=0;n{Object.defineProperty(e,t,{configurable:!0,enumerable:!1,writable:s,value:n})},vs=e=>{const t=parseFloat(e);return isNaN(t)?e:t},Jo=e=>{const t=re(e)?Number(e):NaN;return isNaN(t)?e:t};let ar;const Hn=()=>ar||(ar=typeof globalThis<"u"?globalThis:typeof self<"u"?self:typeof window<"u"?window:typeof global<"u"?global:{});function Ds(e){if(W(e)){const t={};for(let n=0;n{if(n){const s=n.split(Qo);s.length>1&&(t[s[0].trim()]=s[1].trim())}}),t}function js(e){let t="";if(re(e))t=e;else if(W(e))for(let n=0;n!!(e&&e.__v_isRef===!0),sl=e=>re(e)?e:e==null?"":W(e)||ne(e)&&(e.toString===li||!q(e.toString))?ui(e)?sl(e.value):JSON.stringify(e,di,2):String(e),di=(e,t)=>ui(t)?di(e,t.value):Tt(t)?{[`Map(${t.size})`]:[...t.entries()].reduce((n,[s,r],i)=>(n[zn(s,i)+" =>"]=r,n),{})}:ii(t)?{[`Set(${t.size})`]:[...t.values()].map(n=>zn(n))}:Xe(t)?zn(t):ne(t)&&!W(t)&&!ci(t)?String(t):t,zn=(e,t="")=>{var n;return Xe(e)?`Symbol(${(n=e.description)!=null?n:t})`:e};/** +* @vue/reactivity v3.5.13 +* (c) 2018-present Yuxi (Evan) You and Vue contributors +* @license MIT +**/let we;class rl{constructor(t=!1){this.detached=t,this._active=!0,this.effects=[],this.cleanups=[],this._isPaused=!1,this.parent=we,!t&&we&&(this.index=(we.scopes||(we.scopes=[])).push(this)-1)}get active(){return this._active}pause(){if(this._active){this._isPaused=!0;let t,n;if(this.scopes)for(t=0,n=this.scopes.length;t0)return;if(jt){let t=jt;for(jt=void 0;t;){const n=t.next;t.next=void 0,t.flags&=-9,t=n}}let e;for(;Dt;){let t=Dt;for(Dt=void 0;t;){const n=t.next;if(t.next=void 0,t.flags&=-9,t.flags&1)try{t.trigger()}catch(s){e||(e=s)}t=n}}if(e)throw e}function yi(e){for(let t=e.deps;t;t=t.nextDep)t.version=-1,t.prevActiveLink=t.dep.activeLink,t.dep.activeLink=t}function vi(e){let t,n=e.depsTail,s=n;for(;s;){const r=s.prevDep;s.version===-1?(s===n&&(n=r),ks(s),ol(s)):t=s,s.dep.activeLink=s.prevActiveLink,s.prevActiveLink=void 0,s=r}e.deps=t,e.depsTail=n}function _s(e){for(let t=e.deps;t;t=t.nextDep)if(t.dep.version!==t.version||t.dep.computed&&(_i(t.dep.computed)||t.dep.version!==t.version))return!0;return!!e._dirty}function _i(e){if(e.flags&4&&!(e.flags&16)||(e.flags&=-17,e.globalVersion===Kt))return;e.globalVersion=Kt;const t=e.dep;if(e.flags|=2,t.version>0&&!e.isSSR&&e.deps&&!_s(e)){e.flags&=-3;return}const n=te,s=Ne;te=e,Ne=!0;try{yi(e);const r=e.fn(e._value);(t.version===0||tt(r,e._value))&&(e._value=r,t.version++)}catch(r){throw t.version++,r}finally{te=n,Ne=s,vi(e),e.flags&=-3}}function ks(e,t=!1){const{dep:n,prevSub:s,nextSub:r}=e;if(s&&(s.nextSub=r,e.prevSub=void 0),r&&(r.prevSub=s,e.nextSub=void 0),n.subs===e&&(n.subs=s,!s&&n.computed)){n.computed.flags&=-5;for(let i=n.computed.deps;i;i=i.nextDep)ks(i,!0)}!t&&!--n.sc&&n.map&&n.map.delete(n.key)}function ol(e){const{prevDep:t,nextDep:n}=e;t&&(t.nextDep=n,e.prevDep=void 0),n&&(n.prevDep=t,e.nextDep=void 0)}let Ne=!0;const bi=[];function rt(){bi.push(Ne),Ne=!1}function it(){const e=bi.pop();Ne=e===void 0?!0:e}function fr(e){const{cleanup:t}=e;if(e.cleanup=void 0,t){const n=te;te=void 0;try{t()}finally{te=n}}}let Kt=0;class ll{constructor(t,n){this.sub=t,this.dep=n,this.version=n.version,this.nextDep=this.prevDep=this.nextSub=this.prevSub=this.prevActiveLink=void 0}}class $n{constructor(t){this.computed=t,this.version=0,this.activeLink=void 0,this.subs=void 0,this.map=void 0,this.key=void 0,this.sc=0}track(t){if(!te||!Ne||te===this.computed)return;let n=this.activeLink;if(n===void 0||n.sub!==te)n=this.activeLink=new ll(te,this),te.deps?(n.prevDep=te.depsTail,te.depsTail.nextDep=n,te.depsTail=n):te.deps=te.depsTail=n,wi(n);else if(n.version===-1&&(n.version=this.version,n.nextDep)){const s=n.nextDep;s.prevDep=n.prevDep,n.prevDep&&(n.prevDep.nextDep=s),n.prevDep=te.depsTail,n.nextDep=void 0,te.depsTail.nextDep=n,te.depsTail=n,te.deps===n&&(te.deps=s)}return n}trigger(t){this.version++,Kt++,this.notify(t)}notify(t){Vs();try{for(let n=this.subs;n;n=n.prevSub)n.sub.notify()&&n.sub.dep.notify()}finally{Us()}}}function wi(e){if(e.dep.sc++,e.sub.flags&4){const t=e.dep.computed;if(t&&!e.dep.subs){t.flags|=20;for(let s=t.deps;s;s=s.nextDep)wi(s)}const n=e.dep.subs;n!==e&&(e.prevSub=n,n&&(n.nextSub=e)),e.dep.subs=e}}const Cn=new WeakMap,dt=Symbol(""),bs=Symbol(""),qt=Symbol("");function me(e,t,n){if(Ne&&te){let s=Cn.get(e);s||Cn.set(e,s=new Map);let r=s.get(n);r||(s.set(n,r=new $n),r.map=s,r.key=n),r.track()}}function Ge(e,t,n,s,r,i){const o=Cn.get(e);if(!o){Kt++;return}const l=c=>{c&&c.trigger()};if(Vs(),t==="clear")o.forEach(l);else{const c=W(e),f=c&&$s(n);if(c&&n==="length"){const a=Number(s);o.forEach((h,y)=>{(y==="length"||y===qt||!Xe(y)&&y>=a)&&l(h)})}else switch((n!==void 0||o.has(void 0))&&l(o.get(n)),f&&l(o.get(qt)),t){case"add":c?f&&l(o.get("length")):(l(o.get(dt)),Tt(e)&&l(o.get(bs)));break;case"delete":c||(l(o.get(dt)),Tt(e)&&l(o.get(bs)));break;case"set":Tt(e)&&l(o.get(dt));break}}Us()}function cl(e,t){const n=Cn.get(e);return n&&n.get(t)}function _t(e){const t=J(e);return t===e?t:(me(t,"iterate",qt),Pe(e)?t:t.map(ye))}function Dn(e){return me(e=J(e),"iterate",qt),e}const al={__proto__:null,[Symbol.iterator](){return Zn(this,Symbol.iterator,ye)},concat(...e){return _t(this).concat(...e.map(t=>W(t)?_t(t):t))},entries(){return Zn(this,"entries",e=>(e[1]=ye(e[1]),e))},every(e,t){return We(this,"every",e,t,void 0,arguments)},filter(e,t){return We(this,"filter",e,t,n=>n.map(ye),arguments)},find(e,t){return We(this,"find",e,t,ye,arguments)},findIndex(e,t){return We(this,"findIndex",e,t,void 0,arguments)},findLast(e,t){return We(this,"findLast",e,t,ye,arguments)},findLastIndex(e,t){return We(this,"findLastIndex",e,t,void 0,arguments)},forEach(e,t){return We(this,"forEach",e,t,void 0,arguments)},includes(...e){return es(this,"includes",e)},indexOf(...e){return es(this,"indexOf",e)},join(e){return _t(this).join(e)},lastIndexOf(...e){return es(this,"lastIndexOf",e)},map(e,t){return We(this,"map",e,t,void 0,arguments)},pop(){return Ft(this,"pop")},push(...e){return Ft(this,"push",e)},reduce(e,...t){return ur(this,"reduce",e,t)},reduceRight(e,...t){return ur(this,"reduceRight",e,t)},shift(){return Ft(this,"shift")},some(e,t){return We(this,"some",e,t,void 0,arguments)},splice(...e){return Ft(this,"splice",e)},toReversed(){return _t(this).toReversed()},toSorted(e){return _t(this).toSorted(e)},toSpliced(...e){return _t(this).toSpliced(...e)},unshift(...e){return Ft(this,"unshift",e)},values(){return Zn(this,"values",ye)}};function Zn(e,t,n){const s=Dn(e),r=s[t]();return s!==e&&!Pe(e)&&(r._next=r.next,r.next=()=>{const i=r._next();return i.value&&(i.value=n(i.value)),i}),r}const fl=Array.prototype;function We(e,t,n,s,r,i){const o=Dn(e),l=o!==e&&!Pe(e),c=o[t];if(c!==fl[t]){const h=c.apply(e,i);return l?ye(h):h}let f=n;o!==e&&(l?f=function(h,y){return n.call(this,ye(h),y,e)}:n.length>2&&(f=function(h,y){return n.call(this,h,y,e)}));const a=c.call(o,f,s);return l&&r?r(a):a}function ur(e,t,n,s){const r=Dn(e);let i=n;return r!==e&&(Pe(e)?n.length>3&&(i=function(o,l,c){return n.call(this,o,l,c,e)}):i=function(o,l,c){return n.call(this,o,ye(l),c,e)}),r[t](i,...s)}function es(e,t,n){const s=J(e);me(s,"iterate",qt);const r=s[t](...n);return(r===-1||r===!1)&&Ks(n[0])?(n[0]=J(n[0]),s[t](...n)):r}function Ft(e,t,n=[]){rt(),Vs();const s=J(e)[t].apply(e,n);return Us(),it(),s}const ul=Ns("__proto__,__v_isRef,__isVue"),Si=new Set(Object.getOwnPropertyNames(Symbol).filter(e=>e!=="arguments"&&e!=="caller").map(e=>Symbol[e]).filter(Xe));function dl(e){Xe(e)||(e=String(e));const t=J(this);return me(t,"has",e),t.hasOwnProperty(e)}class xi{constructor(t=!1,n=!1){this._isReadonly=t,this._isShallow=n}get(t,n,s){if(n==="__v_skip")return t.__v_skip;const r=this._isReadonly,i=this._isShallow;if(n==="__v_isReactive")return!r;if(n==="__v_isReadonly")return r;if(n==="__v_isShallow")return i;if(n==="__v_raw")return s===(r?i?Sl:Ai:i?Ci:Ti).get(t)||Object.getPrototypeOf(t)===Object.getPrototypeOf(s)?t:void 0;const o=W(t);if(!r){let c;if(o&&(c=al[n]))return c;if(n==="hasOwnProperty")return dl}const l=Reflect.get(t,n,fe(t)?t:s);return(Xe(n)?Si.has(n):ul(n))||(r||me(t,"get",n),i)?l:fe(l)?o&&$s(n)?l:l.value:ne(l)?r?Vn(l):jn(l):l}}class Ei extends xi{constructor(t=!1){super(!1,t)}set(t,n,s,r){let i=t[n];if(!this._isShallow){const c=yt(i);if(!Pe(s)&&!yt(s)&&(i=J(i),s=J(s)),!W(t)&&fe(i)&&!fe(s))return c?!1:(i.value=s,!0)}const o=W(t)&&$s(n)?Number(n)e,cn=e=>Reflect.getPrototypeOf(e);function yl(e,t,n){return function(...s){const r=this.__v_raw,i=J(r),o=Tt(i),l=e==="entries"||e===Symbol.iterator&&o,c=e==="keys"&&o,f=r[e](...s),a=n?ws:t?Ss:ye;return!t&&me(i,"iterate",c?bs:dt),{next(){const{value:h,done:y}=f.next();return y?{value:h,done:y}:{value:l?[a(h[0]),a(h[1])]:a(h),done:y}},[Symbol.iterator](){return this}}}}function an(e){return function(...t){return e==="delete"?!1:e==="clear"?void 0:this}}function vl(e,t){const n={get(r){const i=this.__v_raw,o=J(i),l=J(r);e||(tt(r,l)&&me(o,"get",r),me(o,"get",l));const{has:c}=cn(o),f=t?ws:e?Ss:ye;if(c.call(o,r))return f(i.get(r));if(c.call(o,l))return f(i.get(l));i!==o&&i.get(r)},get size(){const r=this.__v_raw;return!e&&me(J(r),"iterate",dt),Reflect.get(r,"size",r)},has(r){const i=this.__v_raw,o=J(i),l=J(r);return e||(tt(r,l)&&me(o,"has",r),me(o,"has",l)),r===l?i.has(r):i.has(r)||i.has(l)},forEach(r,i){const o=this,l=o.__v_raw,c=J(l),f=t?ws:e?Ss:ye;return!e&&me(c,"iterate",dt),l.forEach((a,h)=>r.call(i,f(a),f(h),o))}};return ae(n,e?{add:an("add"),set:an("set"),delete:an("delete"),clear:an("clear")}:{add(r){!t&&!Pe(r)&&!yt(r)&&(r=J(r));const i=J(this);return cn(i).has.call(i,r)||(i.add(r),Ge(i,"add",r,r)),this},set(r,i){!t&&!Pe(i)&&!yt(i)&&(i=J(i));const o=J(this),{has:l,get:c}=cn(o);let f=l.call(o,r);f||(r=J(r),f=l.call(o,r));const a=c.call(o,r);return o.set(r,i),f?tt(i,a)&&Ge(o,"set",r,i):Ge(o,"add",r,i),this},delete(r){const i=J(this),{has:o,get:l}=cn(i);let c=o.call(i,r);c||(r=J(r),c=o.call(i,r)),l&&l.call(i,r);const f=i.delete(r);return c&&Ge(i,"delete",r,void 0),f},clear(){const r=J(this),i=r.size!==0,o=r.clear();return i&&Ge(r,"clear",void 0,void 0),o}}),["keys","values","entries",Symbol.iterator].forEach(r=>{n[r]=yl(r,e,t)}),n}function Bs(e,t){const n=vl(e,t);return(s,r,i)=>r==="__v_isReactive"?!e:r==="__v_isReadonly"?e:r==="__v_raw"?s:Reflect.get(z(n,r)&&r in s?n:s,r,i)}const _l={get:Bs(!1,!1)},bl={get:Bs(!1,!0)},wl={get:Bs(!0,!1)};const Ti=new WeakMap,Ci=new WeakMap,Ai=new WeakMap,Sl=new WeakMap;function xl(e){switch(e){case"Object":case"Array":return 1;case"Map":case"Set":case"WeakMap":case"WeakSet":return 2;default:return 0}}function El(e){return e.__v_skip||!Object.isExtensible(e)?0:xl(Go(e))}function jn(e){return yt(e)?e:Ws(e,!1,pl,_l,Ti)}function Tl(e){return Ws(e,!1,ml,bl,Ci)}function Vn(e){return Ws(e,!0,gl,wl,Ai)}function Ws(e,t,n,s,r){if(!ne(e)||e.__v_raw&&!(t&&e.__v_isReactive))return e;const i=r.get(e);if(i)return i;const o=El(e);if(o===0)return e;const l=new Proxy(e,o===2?s:n);return r.set(e,l),l}function ht(e){return yt(e)?ht(e.__v_raw):!!(e&&e.__v_isReactive)}function yt(e){return!!(e&&e.__v_isReadonly)}function Pe(e){return!!(e&&e.__v_isShallow)}function Ks(e){return e?!!e.__v_raw:!1}function J(e){const t=e&&e.__v_raw;return t?J(t):e}function wn(e){return!z(e,"__v_skip")&&Object.isExtensible(e)&&ai(e,"__v_skip",!0),e}const ye=e=>ne(e)?jn(e):e,Ss=e=>ne(e)?Vn(e):e;function fe(e){return e?e.__v_isRef===!0:!1}function oe(e){return Ri(e,!1)}function qs(e){return Ri(e,!0)}function Ri(e,t){return fe(e)?e:new Cl(e,t)}class Cl{constructor(t,n){this.dep=new $n,this.__v_isRef=!0,this.__v_isShallow=!1,this._rawValue=n?t:J(t),this._value=n?t:ye(t),this.__v_isShallow=n}get value(){return this.dep.track(),this._value}set value(t){const n=this._rawValue,s=this.__v_isShallow||Pe(t)||yt(t);t=s?t:J(t),tt(t,n)&&(this._rawValue=t,this._value=s?t:ye(t),this.dep.trigger())}}function Oi(e){return fe(e)?e.value:e}const Al={get:(e,t,n)=>t==="__v_raw"?e:Oi(Reflect.get(e,t,n)),set:(e,t,n,s)=>{const r=e[t];return fe(r)&&!fe(n)?(r.value=n,!0):Reflect.set(e,t,n,s)}};function Mi(e){return ht(e)?e:new Proxy(e,Al)}class Rl{constructor(t){this.__v_isRef=!0,this._value=void 0;const n=this.dep=new $n,{get:s,set:r}=t(n.track.bind(n),n.trigger.bind(n));this._get=s,this._set=r}get value(){return this._value=this._get()}set value(t){this._set(t)}}function Ol(e){return new Rl(e)}class Ml{constructor(t,n,s){this._object=t,this._key=n,this._defaultValue=s,this.__v_isRef=!0,this._value=void 0}get value(){const t=this._object[this._key];return this._value=t===void 0?this._defaultValue:t}set value(t){this._object[this._key]=t}get dep(){return cl(J(this._object),this._key)}}class Pl{constructor(t){this._getter=t,this.__v_isRef=!0,this.__v_isReadonly=!0,this._value=void 0}get value(){return this._value=this._getter()}}function Ll(e,t,n){return fe(e)?e:q(e)?new Pl(e):ne(e)&&arguments.length>1?Il(e,t,n):oe(e)}function Il(e,t,n){const s=e[t];return fe(s)?s:new Ml(e,t,n)}class Nl{constructor(t,n,s){this.fn=t,this.setter=n,this._value=void 0,this.dep=new $n(this),this.__v_isRef=!0,this.deps=void 0,this.depsTail=void 0,this.flags=16,this.globalVersion=Kt-1,this.next=void 0,this.effect=this,this.__v_isReadonly=!n,this.isSSR=s}notify(){if(this.flags|=16,!(this.flags&8)&&te!==this)return mi(this,!0),!0}get value(){const t=this.dep.track();return _i(this),t&&(t.version=this.dep.version),this._value}set value(t){this.setter&&this.setter(t)}}function Fl(e,t,n=!1){let s,r;return q(e)?s=e:(s=e.get,r=e.set),new Nl(s,r,n)}const fn={},An=new WeakMap;let ft;function Hl(e,t=!1,n=ft){if(n){let s=An.get(n);s||An.set(n,s=[]),s.push(e)}}function $l(e,t,n=Z){const{immediate:s,deep:r,once:i,scheduler:o,augmentJob:l,call:c}=n,f=g=>r?g:Pe(g)||r===!1||r===0?Ye(g,1):Ye(g);let a,h,y,v,S=!1,_=!1;if(fe(e)?(h=()=>e.value,S=Pe(e)):ht(e)?(h=()=>f(e),S=!0):W(e)?(_=!0,S=e.some(g=>ht(g)||Pe(g)),h=()=>e.map(g=>{if(fe(g))return g.value;if(ht(g))return f(g);if(q(g))return c?c(g,2):g()})):q(e)?t?h=c?()=>c(e,2):e:h=()=>{if(y){rt();try{y()}finally{it()}}const g=ft;ft=a;try{return c?c(e,3,[v]):e(v)}finally{ft=g}}:h=ke,t&&r){const g=h,O=r===!0?1/0:r;h=()=>Ye(g(),O)}const K=hi(),N=()=>{a.stop(),K&&K.active&&Hs(K.effects,a)};if(i&&t){const g=t;t=(...O)=>{g(...O),N()}}let j=_?new Array(e.length).fill(fn):fn;const p=g=>{if(!(!(a.flags&1)||!a.dirty&&!g))if(t){const O=a.run();if(r||S||(_?O.some((F,$)=>tt(F,j[$])):tt(O,j))){y&&y();const F=ft;ft=a;try{const $=[O,j===fn?void 0:_&&j[0]===fn?[]:j,v];c?c(t,3,$):t(...$),j=O}finally{ft=F}}}else a.run()};return l&&l(p),a=new pi(h),a.scheduler=o?()=>o(p,!1):p,v=g=>Hl(g,!1,a),y=a.onStop=()=>{const g=An.get(a);if(g){if(c)c(g,4);else for(const O of g)O();An.delete(a)}},t?s?p(!0):j=a.run():o?o(p.bind(null,!0),!0):a.run(),N.pause=a.pause.bind(a),N.resume=a.resume.bind(a),N.stop=N,N}function Ye(e,t=1/0,n){if(t<=0||!ne(e)||e.__v_skip||(n=n||new Set,n.has(e)))return e;if(n.add(e),t--,fe(e))Ye(e.value,t,n);else if(W(e))for(let s=0;s{Ye(s,t,n)});else if(ci(e)){for(const s in e)Ye(e[s],t,n);for(const s of Object.getOwnPropertySymbols(e))Object.prototype.propertyIsEnumerable.call(e,s)&&Ye(e[s],t,n)}return e}/** +* @vue/runtime-core v3.5.13 +* (c) 2018-present Yuxi (Evan) You and Vue contributors +* @license MIT +**/function tn(e,t,n,s){try{return s?e(...s):e()}catch(r){nn(r,t,n)}}function He(e,t,n,s){if(q(e)){const r=tn(e,t,n,s);return r&&oi(r)&&r.catch(i=>{nn(i,t,n)}),r}if(W(e)){const r=[];for(let i=0;i>>1,r=Se[s],i=Gt(r);i=Gt(n)?Se.push(e):Se.splice(jl(t),0,e),e.flags|=1,Li()}}function Li(){Rn||(Rn=Pi.then(Ii))}function Vl(e){W(e)?At.push(...e):Qe&&e.id===-1?Qe.splice(wt+1,0,e):e.flags&1||(At.push(e),e.flags|=1),Li()}function dr(e,t,n=Ve+1){for(;nGt(n)-Gt(s));if(At.length=0,Qe){Qe.push(...t);return}for(Qe=t,wt=0;wte.id==null?e.flags&2?-1:1/0:e.id;function Ii(e){try{for(Ve=0;Ve{s._d&&Ar(-1);const i=Mn(t);let o;try{o=e(...r)}finally{Mn(i),s._d&&Ar(1)}return o};return s._n=!0,s._c=!0,s._d=!0,s}function _f(e,t){if(de===null)return e;const n=Gn(de),s=e.dirs||(e.dirs=[]);for(let r=0;re.__isTeleport,Vt=e=>e&&(e.disabled||e.disabled===""),hr=e=>e&&(e.defer||e.defer===""),pr=e=>typeof SVGElement<"u"&&e instanceof SVGElement,gr=e=>typeof MathMLElement=="function"&&e instanceof MathMLElement,xs=(e,t)=>{const n=e&&e.to;return re(n)?t?t(n):null:n},$i={name:"Teleport",__isTeleport:!0,process(e,t,n,s,r,i,o,l,c,f){const{mc:a,pc:h,pbc:y,o:{insert:v,querySelector:S,createText:_,createComment:K}}=f,N=Vt(t.props);let{shapeFlag:j,children:p,dynamicChildren:g}=t;if(e==null){const O=t.el=_(""),F=t.anchor=_("");v(O,n,s),v(F,n,s);const $=(R,b)=>{j&16&&(r&&r.isCE&&(r.ce._teleportTarget=R),a(p,R,b,r,i,o,l,c))},V=()=>{const R=t.target=xs(t.props,S),b=Di(R,t,_,v);R&&(o!=="svg"&&pr(R)?o="svg":o!=="mathml"&&gr(R)&&(o="mathml"),N||($(R,b),Sn(t,!1)))};N&&($(n,F),Sn(t,!0)),hr(t.props)?be(()=>{V(),t.el.__isMounted=!0},i):V()}else{if(hr(t.props)&&!e.el.__isMounted){be(()=>{$i.process(e,t,n,s,r,i,o,l,c,f),delete e.el.__isMounted},i);return}t.el=e.el,t.targetStart=e.targetStart;const O=t.anchor=e.anchor,F=t.target=e.target,$=t.targetAnchor=e.targetAnchor,V=Vt(e.props),R=V?n:F,b=V?O:$;if(o==="svg"||pr(F)?o="svg":(o==="mathml"||gr(F))&&(o="mathml"),g?(y(e.dynamicChildren,g,R,r,i,o,l),Qs(e,t,!0)):c||h(e,t,R,b,r,i,o,l,!1),N)V?t.props&&e.props&&t.props.to!==e.props.to&&(t.props.to=e.props.to):un(t,n,O,f,1);else if((t.props&&t.props.to)!==(e.props&&e.props.to)){const I=t.target=xs(t.props,S);I&&un(t,I,null,f,0)}else V&&un(t,F,$,f,1);Sn(t,N)}},remove(e,t,n,{um:s,o:{remove:r}},i){const{shapeFlag:o,children:l,anchor:c,targetStart:f,targetAnchor:a,target:h,props:y}=e;if(h&&(r(f),r(a)),i&&r(c),o&16){const v=i||!Vt(y);for(let S=0;S{e.isMounted=!0}),Ki(()=>{e.isUnmounting=!0}),e}const Re=[Function,Array],ji={mode:String,appear:Boolean,persisted:Boolean,onBeforeEnter:Re,onEnter:Re,onAfterEnter:Re,onEnterCancelled:Re,onBeforeLeave:Re,onLeave:Re,onAfterLeave:Re,onLeaveCancelled:Re,onBeforeAppear:Re,onAppear:Re,onAfterAppear:Re,onAppearCancelled:Re},Vi=e=>{const t=e.subTree;return t.component?Vi(t.component):t},Wl={name:"BaseTransition",props:ji,setup(e,{slots:t}){const n=qn(),s=Bl();return()=>{const r=t.default&&Bi(t.default(),!0);if(!r||!r.length)return;const i=Ui(r),o=J(e),{mode:l}=o;if(s.isLeaving)return ts(i);const c=mr(i);if(!c)return ts(i);let f=Es(c,o,s,n,h=>f=h);c.type!==ve&&Yt(c,f);let a=n.subTree&&mr(n.subTree);if(a&&a.type!==ve&&!ut(c,a)&&Vi(n).type!==ve){let h=Es(a,o,s,n);if(Yt(a,h),l==="out-in"&&c.type!==ve)return s.isLeaving=!0,h.afterLeave=()=>{s.isLeaving=!1,n.job.flags&8||n.update(),delete h.afterLeave,a=void 0},ts(i);l==="in-out"&&c.type!==ve?h.delayLeave=(y,v,S)=>{const _=ki(s,a);_[String(a.key)]=a,y[Ze]=()=>{v(),y[Ze]=void 0,delete f.delayedLeave,a=void 0},f.delayedLeave=()=>{S(),delete f.delayedLeave,a=void 0}}:a=void 0}else a&&(a=void 0);return i}}};function Ui(e){let t=e[0];if(e.length>1){for(const n of e)if(n.type!==ve){t=n;break}}return t}const Kl=Wl;function ki(e,t){const{leavingVNodes:n}=e;let s=n.get(t.type);return s||(s=Object.create(null),n.set(t.type,s)),s}function Es(e,t,n,s,r){const{appear:i,mode:o,persisted:l=!1,onBeforeEnter:c,onEnter:f,onAfterEnter:a,onEnterCancelled:h,onBeforeLeave:y,onLeave:v,onAfterLeave:S,onLeaveCancelled:_,onBeforeAppear:K,onAppear:N,onAfterAppear:j,onAppearCancelled:p}=t,g=String(e.key),O=ki(n,e),F=(R,b)=>{R&&He(R,s,9,b)},$=(R,b)=>{const I=b[1];F(R,b),W(R)?R.every(x=>x.length<=1)&&I():R.length<=1&&I()},V={mode:o,persisted:l,beforeEnter(R){let b=c;if(!n.isMounted)if(i)b=K||c;else return;R[Ze]&&R[Ze](!0);const I=O[g];I&&ut(e,I)&&I.el[Ze]&&I.el[Ze](),F(b,[R])},enter(R){let b=f,I=a,x=h;if(!n.isMounted)if(i)b=N||f,I=j||a,x=p||h;else return;let B=!1;const se=R[dn]=le=>{B||(B=!0,le?F(x,[R]):F(I,[R]),V.delayedLeave&&V.delayedLeave(),R[dn]=void 0)};b?$(b,[R,se]):se()},leave(R,b){const I=String(e.key);if(R[dn]&&R[dn](!0),n.isUnmounting)return b();F(y,[R]);let x=!1;const B=R[Ze]=se=>{x||(x=!0,b(),se?F(_,[R]):F(S,[R]),R[Ze]=void 0,O[I]===e&&delete O[I])};O[I]=e,v?$(v,[R,B]):B()},clone(R){const b=Es(R,t,n,s,r);return r&&r(b),b}};return V}function ts(e){if(sn(e))return e=nt(e),e.children=null,e}function mr(e){if(!sn(e))return Hi(e.type)&&e.children?Ui(e.children):e;const{shapeFlag:t,children:n}=e;if(n){if(t&16)return n[0];if(t&32&&q(n.default))return n.default()}}function Yt(e,t){e.shapeFlag&6&&e.component?(e.transition=t,Yt(e.component.subTree,t)):e.shapeFlag&128?(e.ssContent.transition=t.clone(e.ssContent),e.ssFallback.transition=t.clone(e.ssFallback)):e.transition=t}function Bi(e,t=!1,n){let s=[],r=0;for(let i=0;i1)for(let i=0;iXt(S,t&&(W(t)?t[_]:t),n,s,r));return}if(pt(s)&&!r){s.shapeFlag&512&&s.type.__asyncResolved&&s.component.subTree.component&&Xt(e,t,n,s.component.subTree);return}const i=s.shapeFlag&4?Gn(s.component):s.el,o=r?null:i,{i:l,r:c}=e,f=t&&t.r,a=l.refs===Z?l.refs={}:l.refs,h=l.setupState,y=J(h),v=h===Z?()=>!1:S=>z(y,S);if(f!=null&&f!==c&&(re(f)?(a[f]=null,v(f)&&(h[f]=null)):fe(f)&&(f.value=null)),q(c))tn(c,l,12,[o,a]);else{const S=re(c),_=fe(c);if(S||_){const K=()=>{if(e.f){const N=S?v(c)?h[c]:a[c]:c.value;r?W(N)&&Hs(N,i):W(N)?N.includes(i)||N.push(i):S?(a[c]=[i],v(c)&&(h[c]=a[c])):(c.value=[i],e.k&&(a[e.k]=c.value))}else S?(a[c]=o,v(c)&&(h[c]=o)):_&&(c.value=o,e.k&&(a[e.k]=o))};o?(K.id=-1,be(K,n)):K()}}}let yr=!1;const bt=()=>{yr||(console.error("Hydration completed but contains mismatches."),yr=!0)},ql=e=>e.namespaceURI.includes("svg")&&e.tagName!=="foreignObject",Gl=e=>e.namespaceURI.includes("MathML"),hn=e=>{if(e.nodeType===1){if(ql(e))return"svg";if(Gl(e))return"mathml"}},xt=e=>e.nodeType===8;function Yl(e){const{mt:t,p:n,o:{patchProp:s,createText:r,nextSibling:i,parentNode:o,remove:l,insert:c,createComment:f}}=e,a=(p,g)=>{if(!g.hasChildNodes()){n(null,p,g),On(),g._vnode=p;return}h(g.firstChild,p,null,null,null),On(),g._vnode=p},h=(p,g,O,F,$,V=!1)=>{V=V||!!g.dynamicChildren;const R=xt(p)&&p.data==="[",b=()=>_(p,g,O,F,$,R),{type:I,ref:x,shapeFlag:B,patchFlag:se}=g;let le=p.nodeType;g.el=p,se===-2&&(V=!1,g.dynamicChildren=null);let U=null;switch(I){case gt:le!==3?g.children===""?(c(g.el=r(""),o(p),p),U=p):U=b():(p.data!==g.children&&(bt(),p.data=g.children),U=i(p));break;case ve:j(p)?(U=i(p),N(g.el=p.content.firstChild,p,O)):le!==8||R?U=b():U=i(p);break;case kt:if(R&&(p=i(p),le=p.nodeType),le===1||le===3){U=p;const Y=!g.children.length;for(let D=0;D{V=V||!!g.dynamicChildren;const{type:R,props:b,patchFlag:I,shapeFlag:x,dirs:B,transition:se}=g,le=R==="input"||R==="option";if(le||I!==-1){B&&Ue(g,null,O,"created");let U=!1;if(j(p)){U=co(null,se)&&O&&O.vnode.props&&O.vnode.props.appear;const D=p.content.firstChild;U&&se.beforeEnter(D),N(D,p,O),g.el=p=D}if(x&16&&!(b&&(b.innerHTML||b.textContent))){let D=v(p.firstChild,g,p,O,F,$,V);for(;D;){pn(p,1)||bt();const he=D;D=D.nextSibling,l(he)}}else if(x&8){let D=g.children;D[0]===` +`&&(p.tagName==="PRE"||p.tagName==="TEXTAREA")&&(D=D.slice(1)),p.textContent!==D&&(pn(p,0)||bt(),p.textContent=g.children)}if(b){if(le||!V||I&48){const D=p.tagName.includes("-");for(const he in b)(le&&(he.endsWith("value")||he==="indeterminate")||en(he)&&!Ct(he)||he[0]==="."||D)&&s(p,he,null,b[he],void 0,O)}else if(b.onClick)s(p,"onClick",null,b.onClick,void 0,O);else if(I&4&&ht(b.style))for(const D in b.style)b.style[D]}let Y;(Y=b&&b.onVnodeBeforeMount)&&Oe(Y,O,g),B&&Ue(g,null,O,"beforeMount"),((Y=b&&b.onVnodeMounted)||B||U)&&go(()=>{Y&&Oe(Y,O,g),U&&se.enter(p),B&&Ue(g,null,O,"mounted")},F)}return p.nextSibling},v=(p,g,O,F,$,V,R)=>{R=R||!!g.dynamicChildren;const b=g.children,I=b.length;for(let x=0;x{const{slotScopeIds:R}=g;R&&($=$?$.concat(R):R);const b=o(p),I=v(i(p),g,b,O,F,$,V);return I&&xt(I)&&I.data==="]"?i(g.anchor=I):(bt(),c(g.anchor=f("]"),b,I),I)},_=(p,g,O,F,$,V)=>{if(pn(p.parentElement,1)||bt(),g.el=null,V){const I=K(p);for(;;){const x=i(p);if(x&&x!==I)l(x);else break}}const R=i(p),b=o(p);return l(p),n(null,g,b,R,O,F,hn(b),$),O&&(O.vnode.el=g.el,ho(O,g.el)),R},K=(p,g="[",O="]")=>{let F=0;for(;p;)if(p=i(p),p&&xt(p)&&(p.data===g&&F++,p.data===O)){if(F===0)return i(p);F--}return p},N=(p,g,O)=>{const F=g.parentNode;F&&F.replaceChild(p,g);let $=O;for(;$;)$.vnode.el===g&&($.vnode.el=$.subTree.el=p),$=$.parent},j=p=>p.nodeType===1&&p.tagName==="TEMPLATE";return[a,h]}const vr="data-allow-mismatch",Xl={0:"text",1:"children",2:"class",3:"style",4:"attribute"};function pn(e,t){if(t===0||t===1)for(;e&&!e.hasAttribute(vr);)e=e.parentElement;const n=e&&e.getAttribute(vr);if(n==null)return!1;if(n==="")return!0;{const s=n.split(",");return t===0&&s.includes("children")?!0:n.split(",").includes(Xl[t])}}Hn().requestIdleCallback;Hn().cancelIdleCallback;function Jl(e,t){if(xt(e)&&e.data==="["){let n=1,s=e.nextSibling;for(;s;){if(s.nodeType===1){if(t(s)===!1)break}else if(xt(s))if(s.data==="]"){if(--n===0)break}else s.data==="["&&n++;s=s.nextSibling}}else t(e)}const pt=e=>!!e.type.__asyncLoader;/*! #__NO_SIDE_EFFECTS__ */function wf(e){q(e)&&(e={loader:e});const{loader:t,loadingComponent:n,errorComponent:s,delay:r=200,hydrate:i,timeout:o,suspensible:l=!0,onError:c}=e;let f=null,a,h=0;const y=()=>(h++,f=null,v()),v=()=>{let S;return f||(S=f=t().catch(_=>{if(_=_ instanceof Error?_:new Error(String(_)),c)return new Promise((K,N)=>{c(_,()=>K(y()),()=>N(_),h+1)});throw _}).then(_=>S!==f&&f?f:(_&&(_.__esModule||_[Symbol.toStringTag]==="Module")&&(_=_.default),a=_,_)))};return Ys({name:"AsyncComponentWrapper",__asyncLoader:v,__asyncHydrate(S,_,K){const N=i?()=>{const j=i(K,p=>Jl(S,p));j&&(_.bum||(_.bum=[])).push(j)}:K;a?N():v().then(()=>!_.isUnmounted&&N())},get __asyncResolved(){return a},setup(){const S=ue;if(Xs(S),a)return()=>ns(a,S);const _=p=>{f=null,nn(p,S,13,!s)};if(l&&S.suspense||Mt)return v().then(p=>()=>ns(p,S)).catch(p=>(_(p),()=>s?ce(s,{error:p}):null));const K=oe(!1),N=oe(),j=oe(!!r);return r&&setTimeout(()=>{j.value=!1},r),o!=null&&setTimeout(()=>{if(!K.value&&!N.value){const p=new Error(`Async component timed out after ${o}ms.`);_(p),N.value=p}},o),v().then(()=>{K.value=!0,S.parent&&sn(S.parent.vnode)&&S.parent.update()}).catch(p=>{_(p),N.value=p}),()=>{if(K.value&&a)return ns(a,S);if(N.value&&s)return ce(s,{error:N.value});if(n&&!j.value)return ce(n)}}})}function ns(e,t){const{ref:n,props:s,children:r,ce:i}=t.vnode,o=ce(e,s,r);return o.ref=n,o.ce=i,delete t.vnode.ce,o}const sn=e=>e.type.__isKeepAlive;function zl(e,t){Wi(e,"a",t)}function Ql(e,t){Wi(e,"da",t)}function Wi(e,t,n=ue){const s=e.__wdc||(e.__wdc=()=>{let r=n;for(;r;){if(r.isDeactivated)return;r=r.parent}return e()});if(kn(t,s,n),n){let r=n.parent;for(;r&&r.parent;)sn(r.parent.vnode)&&Zl(s,t,n,r),r=r.parent}}function Zl(e,t,n,s){const r=kn(t,e,s,!0);Bn(()=>{Hs(s[t],r)},n)}function kn(e,t,n=ue,s=!1){if(n){const r=n[e]||(n[e]=[]),i=t.__weh||(t.__weh=(...o)=>{rt();const l=rn(n),c=He(t,n,e,o);return l(),it(),c});return s?r.unshift(i):r.push(i),i}}const Je=e=>(t,n=ue)=>{(!Mt||e==="sp")&&kn(e,(...s)=>t(...s),n)},ec=Je("bm"),Lt=Je("m"),tc=Je("bu"),nc=Je("u"),Ki=Je("bum"),Bn=Je("um"),sc=Je("sp"),rc=Je("rtg"),ic=Je("rtc");function oc(e,t=ue){kn("ec",e,t)}const qi="components";function Sf(e,t){return Yi(qi,e,!0,t)||e}const Gi=Symbol.for("v-ndc");function xf(e){return re(e)?Yi(qi,e,!1)||e:e||Gi}function Yi(e,t,n=!0,s=!1){const r=de||ue;if(r){const i=r.type;{const l=Wc(i,!1);if(l&&(l===t||l===Le(t)||l===Fn(Le(t))))return i}const o=_r(r[e]||i[e],t)||_r(r.appContext[e],t);return!o&&s?i:o}}function _r(e,t){return e&&(e[t]||e[Le(t)]||e[Fn(Le(t))])}function Ef(e,t,n,s){let r;const i=n,o=W(e);if(o||re(e)){const l=o&&ht(e);let c=!1;l&&(c=!Pe(e),e=Dn(e)),r=new Array(e.length);for(let f=0,a=e.length;ft(l,c,void 0,i));else{const l=Object.keys(e);r=new Array(l.length);for(let c=0,f=l.length;czt(t)?!(t.type===ve||t.type===xe&&!Xi(t.children)):!0)?e:null}function Cf(e,t){const n={};for(const s in e)n[/[A-Z]/.test(s)?`on:${s}`:_n(s)]=e[s];return n}const Ts=e=>e?bo(e)?Gn(e):Ts(e.parent):null,Ut=ae(Object.create(null),{$:e=>e,$el:e=>e.vnode.el,$data:e=>e.data,$props:e=>e.props,$attrs:e=>e.attrs,$slots:e=>e.slots,$refs:e=>e.refs,$parent:e=>Ts(e.parent),$root:e=>Ts(e.root),$host:e=>e.ce,$emit:e=>e.emit,$options:e=>Js(e),$forceUpdate:e=>e.f||(e.f=()=>{Gs(e.update)}),$nextTick:e=>e.n||(e.n=Un.bind(e.proxy)),$watch:e=>Rc.bind(e)}),ss=(e,t)=>e!==Z&&!e.__isScriptSetup&&z(e,t),lc={get({_:e},t){if(t==="__v_skip")return!0;const{ctx:n,setupState:s,data:r,props:i,accessCache:o,type:l,appContext:c}=e;let f;if(t[0]!=="$"){const v=o[t];if(v!==void 0)switch(v){case 1:return s[t];case 2:return r[t];case 4:return n[t];case 3:return i[t]}else{if(ss(s,t))return o[t]=1,s[t];if(r!==Z&&z(r,t))return o[t]=2,r[t];if((f=e.propsOptions[0])&&z(f,t))return o[t]=3,i[t];if(n!==Z&&z(n,t))return o[t]=4,n[t];Cs&&(o[t]=0)}}const a=Ut[t];let h,y;if(a)return t==="$attrs"&&me(e.attrs,"get",""),a(e);if((h=l.__cssModules)&&(h=h[t]))return h;if(n!==Z&&z(n,t))return o[t]=4,n[t];if(y=c.config.globalProperties,z(y,t))return y[t]},set({_:e},t,n){const{data:s,setupState:r,ctx:i}=e;return ss(r,t)?(r[t]=n,!0):s!==Z&&z(s,t)?(s[t]=n,!0):z(e.props,t)||t[0]==="$"&&t.slice(1)in e?!1:(i[t]=n,!0)},has({_:{data:e,setupState:t,accessCache:n,ctx:s,appContext:r,propsOptions:i}},o){let l;return!!n[o]||e!==Z&&z(e,o)||ss(t,o)||(l=i[0])&&z(l,o)||z(s,o)||z(Ut,o)||z(r.config.globalProperties,o)},defineProperty(e,t,n){return n.get!=null?e._.accessCache[t]=0:z(n,"value")&&this.set(e,t,n.value,null),Reflect.defineProperty(e,t,n)}};function Af(){return cc().slots}function cc(){const e=qn();return e.setupContext||(e.setupContext=So(e))}function br(e){return W(e)?e.reduce((t,n)=>(t[n]=null,t),{}):e}let Cs=!0;function ac(e){const t=Js(e),n=e.proxy,s=e.ctx;Cs=!1,t.beforeCreate&&wr(t.beforeCreate,e,"bc");const{data:r,computed:i,methods:o,watch:l,provide:c,inject:f,created:a,beforeMount:h,mounted:y,beforeUpdate:v,updated:S,activated:_,deactivated:K,beforeDestroy:N,beforeUnmount:j,destroyed:p,unmounted:g,render:O,renderTracked:F,renderTriggered:$,errorCaptured:V,serverPrefetch:R,expose:b,inheritAttrs:I,components:x,directives:B,filters:se}=t;if(f&&fc(f,s,null),o)for(const Y in o){const D=o[Y];q(D)&&(s[Y]=D.bind(n))}if(r){const Y=r.call(n,n);ne(Y)&&(e.data=jn(Y))}if(Cs=!0,i)for(const Y in i){const D=i[Y],he=q(D)?D.bind(n,n):q(D.get)?D.get.bind(n,n):ke,on=!q(D)&&q(D.set)?D.set.bind(n):ke,ot=ie({get:he,set:on});Object.defineProperty(s,Y,{enumerable:!0,configurable:!0,get:()=>ot.value,set:De=>ot.value=De})}if(l)for(const Y in l)Ji(l[Y],s,n,Y);if(c){const Y=q(c)?c.call(n):c;Reflect.ownKeys(Y).forEach(D=>{mc(D,Y[D])})}a&&wr(a,e,"c");function U(Y,D){W(D)?D.forEach(he=>Y(he.bind(n))):D&&Y(D.bind(n))}if(U(ec,h),U(Lt,y),U(tc,v),U(nc,S),U(zl,_),U(Ql,K),U(oc,V),U(ic,F),U(rc,$),U(Ki,j),U(Bn,g),U(sc,R),W(b))if(b.length){const Y=e.exposed||(e.exposed={});b.forEach(D=>{Object.defineProperty(Y,D,{get:()=>n[D],set:he=>n[D]=he})})}else e.exposed||(e.exposed={});O&&e.render===ke&&(e.render=O),I!=null&&(e.inheritAttrs=I),x&&(e.components=x),B&&(e.directives=B),R&&Xs(e)}function fc(e,t,n=ke){W(e)&&(e=As(e));for(const s in e){const r=e[s];let i;ne(r)?"default"in r?i=Ot(r.from||s,r.default,!0):i=Ot(r.from||s):i=Ot(r),fe(i)?Object.defineProperty(t,s,{enumerable:!0,configurable:!0,get:()=>i.value,set:o=>i.value=o}):t[s]=i}}function wr(e,t,n){He(W(e)?e.map(s=>s.bind(t.proxy)):e.bind(t.proxy),t,n)}function Ji(e,t,n,s){let r=s.includes(".")?fo(n,s):()=>n[s];if(re(e)){const i=t[e];q(i)&&Fe(r,i)}else if(q(e))Fe(r,e.bind(n));else if(ne(e))if(W(e))e.forEach(i=>Ji(i,t,n,s));else{const i=q(e.handler)?e.handler.bind(n):t[e.handler];q(i)&&Fe(r,i,e)}}function Js(e){const t=e.type,{mixins:n,extends:s}=t,{mixins:r,optionsCache:i,config:{optionMergeStrategies:o}}=e.appContext,l=i.get(t);let c;return l?c=l:!r.length&&!n&&!s?c=t:(c={},r.length&&r.forEach(f=>Pn(c,f,o,!0)),Pn(c,t,o)),ne(t)&&i.set(t,c),c}function Pn(e,t,n,s=!1){const{mixins:r,extends:i}=t;i&&Pn(e,i,n,!0),r&&r.forEach(o=>Pn(e,o,n,!0));for(const o in t)if(!(s&&o==="expose")){const l=uc[o]||n&&n[o];e[o]=l?l(e[o],t[o]):t[o]}return e}const uc={data:Sr,props:xr,emits:xr,methods:$t,computed:$t,beforeCreate:_e,created:_e,beforeMount:_e,mounted:_e,beforeUpdate:_e,updated:_e,beforeDestroy:_e,beforeUnmount:_e,destroyed:_e,unmounted:_e,activated:_e,deactivated:_e,errorCaptured:_e,serverPrefetch:_e,components:$t,directives:$t,watch:hc,provide:Sr,inject:dc};function Sr(e,t){return t?e?function(){return ae(q(e)?e.call(this,this):e,q(t)?t.call(this,this):t)}:t:e}function dc(e,t){return $t(As(e),As(t))}function As(e){if(W(e)){const t={};for(let n=0;n1)return n&&q(t)?t.call(s&&s.proxy):t}}const Qi={},Zi=()=>Object.create(Qi),eo=e=>Object.getPrototypeOf(e)===Qi;function yc(e,t,n,s=!1){const r={},i=Zi();e.propsDefaults=Object.create(null),to(e,t,r,i);for(const o in e.propsOptions[0])o in r||(r[o]=void 0);n?e.props=s?r:Tl(r):e.type.props?e.props=r:e.props=i,e.attrs=i}function vc(e,t,n,s){const{props:r,attrs:i,vnode:{patchFlag:o}}=e,l=J(r),[c]=e.propsOptions;let f=!1;if((s||o>0)&&!(o&16)){if(o&8){const a=e.vnode.dynamicProps;for(let h=0;h{c=!0;const[y,v]=no(h,t,!0);ae(o,y),v&&l.push(...v)};!n&&t.mixins.length&&t.mixins.forEach(a),e.extends&&a(e.extends),e.mixins&&e.mixins.forEach(a)}if(!i&&!c)return ne(e)&&s.set(e,Et),Et;if(W(i))for(let a=0;ae[0]==="_"||e==="$stable",zs=e=>W(e)?e.map(Me):[Me(e)],bc=(e,t,n)=>{if(t._n)return t;const s=Ul((...r)=>zs(t(...r)),n);return s._c=!1,s},ro=(e,t,n)=>{const s=e._ctx;for(const r in e){if(so(r))continue;const i=e[r];if(q(i))t[r]=bc(r,i,s);else if(i!=null){const o=zs(i);t[r]=()=>o}}},io=(e,t)=>{const n=zs(t);e.slots.default=()=>n},oo=(e,t,n)=>{for(const s in t)(n||s!=="_")&&(e[s]=t[s])},wc=(e,t,n)=>{const s=e.slots=Zi();if(e.vnode.shapeFlag&32){const r=t._;r?(oo(s,t,n),n&&ai(s,"_",r,!0)):ro(t,s)}else t&&io(e,t)},Sc=(e,t,n)=>{const{vnode:s,slots:r}=e;let i=!0,o=Z;if(s.shapeFlag&32){const l=t._;l?n&&l===1?i=!1:oo(r,t,n):(i=!t.$stable,ro(t,r)),o=t}else t&&(io(e,t),o={default:1});if(i)for(const l in r)!so(l)&&o[l]==null&&delete r[l]},be=go;function xc(e){return lo(e)}function Ec(e){return lo(e,Yl)}function lo(e,t){const n=Hn();n.__VUE__=!0;const{insert:s,remove:r,patchProp:i,createElement:o,createText:l,createComment:c,setText:f,setElementText:a,parentNode:h,nextSibling:y,setScopeId:v=ke,insertStaticContent:S}=e,_=(u,d,m,T=null,w=null,E=null,P=void 0,M=null,A=!!d.dynamicChildren)=>{if(u===d)return;u&&!ut(u,d)&&(T=ln(u),De(u,w,E,!0),u=null),d.patchFlag===-2&&(A=!1,d.dynamicChildren=null);const{type:C,ref:k,shapeFlag:L}=d;switch(C){case gt:K(u,d,m,T);break;case ve:N(u,d,m,T);break;case kt:u==null&&j(d,m,T,P);break;case xe:x(u,d,m,T,w,E,P,M,A);break;default:L&1?O(u,d,m,T,w,E,P,M,A):L&6?B(u,d,m,T,w,E,P,M,A):(L&64||L&128)&&C.process(u,d,m,T,w,E,P,M,A,vt)}k!=null&&w&&Xt(k,u&&u.ref,E,d||u,!d)},K=(u,d,m,T)=>{if(u==null)s(d.el=l(d.children),m,T);else{const w=d.el=u.el;d.children!==u.children&&f(w,d.children)}},N=(u,d,m,T)=>{u==null?s(d.el=c(d.children||""),m,T):d.el=u.el},j=(u,d,m,T)=>{[u.el,u.anchor]=S(u.children,d,m,T,u.el,u.anchor)},p=({el:u,anchor:d},m,T)=>{let w;for(;u&&u!==d;)w=y(u),s(u,m,T),u=w;s(d,m,T)},g=({el:u,anchor:d})=>{let m;for(;u&&u!==d;)m=y(u),r(u),u=m;r(d)},O=(u,d,m,T,w,E,P,M,A)=>{d.type==="svg"?P="svg":d.type==="math"&&(P="mathml"),u==null?F(d,m,T,w,E,P,M,A):R(u,d,w,E,P,M,A)},F=(u,d,m,T,w,E,P,M)=>{let A,C;const{props:k,shapeFlag:L,transition:H,dirs:G}=u;if(A=u.el=o(u.type,E,k&&k.is,k),L&8?a(A,u.children):L&16&&V(u.children,A,null,T,w,rs(u,E),P,M),G&&Ue(u,null,T,"created"),$(A,u,u.scopeId,P,T),k){for(const ee in k)ee!=="value"&&!Ct(ee)&&i(A,ee,null,k[ee],E,T);"value"in k&&i(A,"value",null,k.value,E),(C=k.onVnodeBeforeMount)&&Oe(C,T,u)}G&&Ue(u,null,T,"beforeMount");const X=co(w,H);X&&H.beforeEnter(A),s(A,d,m),((C=k&&k.onVnodeMounted)||X||G)&&be(()=>{C&&Oe(C,T,u),X&&H.enter(A),G&&Ue(u,null,T,"mounted")},w)},$=(u,d,m,T,w)=>{if(m&&v(u,m),T)for(let E=0;E{for(let C=A;C{const M=d.el=u.el;let{patchFlag:A,dynamicChildren:C,dirs:k}=d;A|=u.patchFlag&16;const L=u.props||Z,H=d.props||Z;let G;if(m&<(m,!1),(G=H.onVnodeBeforeUpdate)&&Oe(G,m,d,u),k&&Ue(d,u,m,"beforeUpdate"),m&<(m,!0),(L.innerHTML&&H.innerHTML==null||L.textContent&&H.textContent==null)&&a(M,""),C?b(u.dynamicChildren,C,M,m,T,rs(d,w),E):P||D(u,d,M,null,m,T,rs(d,w),E,!1),A>0){if(A&16)I(M,L,H,m,w);else if(A&2&&L.class!==H.class&&i(M,"class",null,H.class,w),A&4&&i(M,"style",L.style,H.style,w),A&8){const X=d.dynamicProps;for(let ee=0;ee{G&&Oe(G,m,d,u),k&&Ue(d,u,m,"updated")},T)},b=(u,d,m,T,w,E,P)=>{for(let M=0;M{if(d!==m){if(d!==Z)for(const E in d)!Ct(E)&&!(E in m)&&i(u,E,d[E],null,w,T);for(const E in m){if(Ct(E))continue;const P=m[E],M=d[E];P!==M&&E!=="value"&&i(u,E,M,P,w,T)}"value"in m&&i(u,"value",d.value,m.value,w)}},x=(u,d,m,T,w,E,P,M,A)=>{const C=d.el=u?u.el:l(""),k=d.anchor=u?u.anchor:l("");let{patchFlag:L,dynamicChildren:H,slotScopeIds:G}=d;G&&(M=M?M.concat(G):G),u==null?(s(C,m,T),s(k,m,T),V(d.children||[],m,k,w,E,P,M,A)):L>0&&L&64&&H&&u.dynamicChildren?(b(u.dynamicChildren,H,m,w,E,P,M),(d.key!=null||w&&d===w.subTree)&&Qs(u,d,!0)):D(u,d,m,k,w,E,P,M,A)},B=(u,d,m,T,w,E,P,M,A)=>{d.slotScopeIds=M,u==null?d.shapeFlag&512?w.ctx.activate(d,m,T,P,A):se(d,m,T,w,E,P,A):le(u,d,A)},se=(u,d,m,T,w,E,P)=>{const M=u.component=Vc(u,T,w);if(sn(u)&&(M.ctx.renderer=vt),Uc(M,!1,P),M.asyncDep){if(w&&w.registerDep(M,U,P),!u.el){const A=M.subTree=ce(ve);N(null,A,d,m)}}else U(M,u,d,m,w,E,P)},le=(u,d,m)=>{const T=d.component=u.component;if(Ic(u,d,m))if(T.asyncDep&&!T.asyncResolved){Y(T,d,m);return}else T.next=d,T.update();else d.el=u.el,T.vnode=d},U=(u,d,m,T,w,E,P)=>{const M=()=>{if(u.isMounted){let{next:L,bu:H,u:G,parent:X,vnode:ee}=u;{const Te=ao(u);if(Te){L&&(L.el=ee.el,Y(u,L,P)),Te.asyncDep.then(()=>{u.isUnmounted||M()});return}}let Q=L,Ee;lt(u,!1),L?(L.el=ee.el,Y(u,L,P)):L=ee,H&&bn(H),(Ee=L.props&&L.props.onVnodeBeforeUpdate)&&Oe(Ee,X,L,ee),lt(u,!0);const pe=is(u),Ie=u.subTree;u.subTree=pe,_(Ie,pe,h(Ie.el),ln(Ie),u,w,E),L.el=pe.el,Q===null&&ho(u,pe.el),G&&be(G,w),(Ee=L.props&&L.props.onVnodeUpdated)&&be(()=>Oe(Ee,X,L,ee),w)}else{let L;const{el:H,props:G}=d,{bm:X,m:ee,parent:Q,root:Ee,type:pe}=u,Ie=pt(d);if(lt(u,!1),X&&bn(X),!Ie&&(L=G&&G.onVnodeBeforeMount)&&Oe(L,Q,d),lt(u,!0),H&&Jn){const Te=()=>{u.subTree=is(u),Jn(H,u.subTree,u,w,null)};Ie&&pe.__asyncHydrate?pe.__asyncHydrate(H,u,Te):Te()}else{Ee.ce&&Ee.ce._injectChildStyle(pe);const Te=u.subTree=is(u);_(null,Te,m,T,u,w,E),d.el=Te.el}if(ee&&be(ee,w),!Ie&&(L=G&&G.onVnodeMounted)){const Te=d;be(()=>Oe(L,Q,Te),w)}(d.shapeFlag&256||Q&&pt(Q.vnode)&&Q.vnode.shapeFlag&256)&&u.a&&be(u.a,w),u.isMounted=!0,d=m=T=null}};u.scope.on();const A=u.effect=new pi(M);u.scope.off();const C=u.update=A.run.bind(A),k=u.job=A.runIfDirty.bind(A);k.i=u,k.id=u.uid,A.scheduler=()=>Gs(k),lt(u,!0),C()},Y=(u,d,m)=>{d.component=u;const T=u.vnode.props;u.vnode=d,u.next=null,vc(u,d.props,T,m),Sc(u,d.children,m),rt(),dr(u),it()},D=(u,d,m,T,w,E,P,M,A=!1)=>{const C=u&&u.children,k=u?u.shapeFlag:0,L=d.children,{patchFlag:H,shapeFlag:G}=d;if(H>0){if(H&128){on(C,L,m,T,w,E,P,M,A);return}else if(H&256){he(C,L,m,T,w,E,P,M,A);return}}G&8?(k&16&&It(C,w,E),L!==C&&a(m,L)):k&16?G&16?on(C,L,m,T,w,E,P,M,A):It(C,w,E,!0):(k&8&&a(m,""),G&16&&V(L,m,T,w,E,P,M,A))},he=(u,d,m,T,w,E,P,M,A)=>{u=u||Et,d=d||Et;const C=u.length,k=d.length,L=Math.min(C,k);let H;for(H=0;Hk?It(u,w,E,!0,!1,L):V(d,m,T,w,E,P,M,A,L)},on=(u,d,m,T,w,E,P,M,A)=>{let C=0;const k=d.length;let L=u.length-1,H=k-1;for(;C<=L&&C<=H;){const G=u[C],X=d[C]=A?et(d[C]):Me(d[C]);if(ut(G,X))_(G,X,m,null,w,E,P,M,A);else break;C++}for(;C<=L&&C<=H;){const G=u[L],X=d[H]=A?et(d[H]):Me(d[H]);if(ut(G,X))_(G,X,m,null,w,E,P,M,A);else break;L--,H--}if(C>L){if(C<=H){const G=H+1,X=GH)for(;C<=L;)De(u[C],w,E,!0),C++;else{const G=C,X=C,ee=new Map;for(C=X;C<=H;C++){const Ce=d[C]=A?et(d[C]):Me(d[C]);Ce.key!=null&&ee.set(Ce.key,C)}let Q,Ee=0;const pe=H-X+1;let Ie=!1,Te=0;const Nt=new Array(pe);for(C=0;C=pe){De(Ce,w,E,!0);continue}let je;if(Ce.key!=null)je=ee.get(Ce.key);else for(Q=X;Q<=H;Q++)if(Nt[Q-X]===0&&ut(Ce,d[Q])){je=Q;break}je===void 0?De(Ce,w,E,!0):(Nt[je-X]=C+1,je>=Te?Te=je:Ie=!0,_(Ce,d[je],m,null,w,E,P,M,A),Ee++)}const lr=Ie?Tc(Nt):Et;for(Q=lr.length-1,C=pe-1;C>=0;C--){const Ce=X+C,je=d[Ce],cr=Ce+1{const{el:E,type:P,transition:M,children:A,shapeFlag:C}=u;if(C&6){ot(u.component.subTree,d,m,T);return}if(C&128){u.suspense.move(d,m,T);return}if(C&64){P.move(u,d,m,vt);return}if(P===xe){s(E,d,m);for(let L=0;LM.enter(E),w);else{const{leave:L,delayLeave:H,afterLeave:G}=M,X=()=>s(E,d,m),ee=()=>{L(E,()=>{X(),G&&G()})};H?H(E,X,ee):ee()}else s(E,d,m)},De=(u,d,m,T=!1,w=!1)=>{const{type:E,props:P,ref:M,children:A,dynamicChildren:C,shapeFlag:k,patchFlag:L,dirs:H,cacheIndex:G}=u;if(L===-2&&(w=!1),M!=null&&Xt(M,null,m,u,!0),G!=null&&(d.renderCache[G]=void 0),k&256){d.ctx.deactivate(u);return}const X=k&1&&H,ee=!pt(u);let Q;if(ee&&(Q=P&&P.onVnodeBeforeUnmount)&&Oe(Q,d,u),k&6)Wo(u.component,m,T);else{if(k&128){u.suspense.unmount(m,T);return}X&&Ue(u,null,d,"beforeUnmount"),k&64?u.type.remove(u,d,m,vt,T):C&&!C.hasOnce&&(E!==xe||L>0&&L&64)?It(C,d,m,!1,!0):(E===xe&&L&384||!w&&k&16)&&It(A,d,m),T&&ir(u)}(ee&&(Q=P&&P.onVnodeUnmounted)||X)&&be(()=>{Q&&Oe(Q,d,u),X&&Ue(u,null,d,"unmounted")},m)},ir=u=>{const{type:d,el:m,anchor:T,transition:w}=u;if(d===xe){Bo(m,T);return}if(d===kt){g(u);return}const E=()=>{r(m),w&&!w.persisted&&w.afterLeave&&w.afterLeave()};if(u.shapeFlag&1&&w&&!w.persisted){const{leave:P,delayLeave:M}=w,A=()=>P(m,E);M?M(u.el,E,A):A()}else E()},Bo=(u,d)=>{let m;for(;u!==d;)m=y(u),r(u),u=m;r(d)},Wo=(u,d,m)=>{const{bum:T,scope:w,job:E,subTree:P,um:M,m:A,a:C}=u;Tr(A),Tr(C),T&&bn(T),w.stop(),E&&(E.flags|=8,De(P,u,d,m)),M&&be(M,d),be(()=>{u.isUnmounted=!0},d),d&&d.pendingBranch&&!d.isUnmounted&&u.asyncDep&&!u.asyncResolved&&u.suspenseId===d.pendingId&&(d.deps--,d.deps===0&&d.resolve())},It=(u,d,m,T=!1,w=!1,E=0)=>{for(let P=E;P{if(u.shapeFlag&6)return ln(u.component.subTree);if(u.shapeFlag&128)return u.suspense.next();const d=y(u.anchor||u.el),m=d&&d[Fi];return m?y(m):d};let Yn=!1;const or=(u,d,m)=>{u==null?d._vnode&&De(d._vnode,null,null,!0):_(d._vnode||null,u,d,null,null,null,m),d._vnode=u,Yn||(Yn=!0,dr(),On(),Yn=!1)},vt={p:_,um:De,m:ot,r:ir,mt:se,mc:V,pc:D,pbc:b,n:ln,o:e};let Xn,Jn;return t&&([Xn,Jn]=t(vt)),{render:or,hydrate:Xn,createApp:gc(or,Xn)}}function rs({type:e,props:t},n){return n==="svg"&&e==="foreignObject"||n==="mathml"&&e==="annotation-xml"&&t&&t.encoding&&t.encoding.includes("html")?void 0:n}function lt({effect:e,job:t},n){n?(e.flags|=32,t.flags|=4):(e.flags&=-33,t.flags&=-5)}function co(e,t){return(!e||e&&!e.pendingBranch)&&t&&!t.persisted}function Qs(e,t,n=!1){const s=e.children,r=t.children;if(W(s)&&W(r))for(let i=0;i>1,e[n[l]]0&&(t[s]=n[i-1]),n[i]=s)}}for(i=n.length,o=n[i-1];i-- >0;)n[i]=o,o=t[o];return n}function ao(e){const t=e.subTree.component;if(t)return t.asyncDep&&!t.asyncResolved?t:ao(t)}function Tr(e){if(e)for(let t=0;tOt(Cc);function Zs(e,t){return Wn(e,null,t)}function Rf(e,t){return Wn(e,null,{flush:"post"})}function Fe(e,t,n){return Wn(e,t,n)}function Wn(e,t,n=Z){const{immediate:s,deep:r,flush:i,once:o}=n,l=ae({},n),c=t&&s||!t&&i!=="post";let f;if(Mt){if(i==="sync"){const v=Ac();f=v.__watcherHandles||(v.__watcherHandles=[])}else if(!c){const v=()=>{};return v.stop=ke,v.resume=ke,v.pause=ke,v}}const a=ue;l.call=(v,S,_)=>He(v,a,S,_);let h=!1;i==="post"?l.scheduler=v=>{be(v,a&&a.suspense)}:i!=="sync"&&(h=!0,l.scheduler=(v,S)=>{S?v():Gs(v)}),l.augmentJob=v=>{t&&(v.flags|=4),h&&(v.flags|=2,a&&(v.id=a.uid,v.i=a))};const y=$l(e,t,l);return Mt&&(f?f.push(y):c&&y()),y}function Rc(e,t,n){const s=this.proxy,r=re(e)?e.includes(".")?fo(s,e):()=>s[e]:e.bind(s,s);let i;q(t)?i=t:(i=t.handler,n=t);const o=rn(this),l=Wn(r,i.bind(s),n);return o(),l}function fo(e,t){const n=t.split(".");return()=>{let s=e;for(let r=0;rt==="modelValue"||t==="model-value"?e.modelModifiers:e[`${t}Modifiers`]||e[`${Le(t)}Modifiers`]||e[`${st(t)}Modifiers`];function Mc(e,t,...n){if(e.isUnmounted)return;const s=e.vnode.props||Z;let r=n;const i=t.startsWith("update:"),o=i&&Oc(s,t.slice(7));o&&(o.trim&&(r=n.map(a=>re(a)?a.trim():a)),o.number&&(r=n.map(vs)));let l,c=s[l=_n(t)]||s[l=_n(Le(t))];!c&&i&&(c=s[l=_n(st(t))]),c&&He(c,e,6,r);const f=s[l+"Once"];if(f){if(!e.emitted)e.emitted={};else if(e.emitted[l])return;e.emitted[l]=!0,He(f,e,6,r)}}function uo(e,t,n=!1){const s=t.emitsCache,r=s.get(e);if(r!==void 0)return r;const i=e.emits;let o={},l=!1;if(!q(e)){const c=f=>{const a=uo(f,t,!0);a&&(l=!0,ae(o,a))};!n&&t.mixins.length&&t.mixins.forEach(c),e.extends&&c(e.extends),e.mixins&&e.mixins.forEach(c)}return!i&&!l?(ne(e)&&s.set(e,null),null):(W(i)?i.forEach(c=>o[c]=null):ae(o,i),ne(e)&&s.set(e,o),o)}function Kn(e,t){return!e||!en(t)?!1:(t=t.slice(2).replace(/Once$/,""),z(e,t[0].toLowerCase()+t.slice(1))||z(e,st(t))||z(e,t))}function is(e){const{type:t,vnode:n,proxy:s,withProxy:r,propsOptions:[i],slots:o,attrs:l,emit:c,render:f,renderCache:a,props:h,data:y,setupState:v,ctx:S,inheritAttrs:_}=e,K=Mn(e);let N,j;try{if(n.shapeFlag&4){const g=r||s,O=g;N=Me(f.call(O,g,a,h,v,y,S)),j=l}else{const g=t;N=Me(g.length>1?g(h,{attrs:l,slots:o,emit:c}):g(h,null)),j=t.props?l:Pc(l)}}catch(g){Bt.length=0,nn(g,e,1),N=ce(ve)}let p=N;if(j&&_!==!1){const g=Object.keys(j),{shapeFlag:O}=p;g.length&&O&7&&(i&&g.some(Fs)&&(j=Lc(j,i)),p=nt(p,j,!1,!0))}return n.dirs&&(p=nt(p,null,!1,!0),p.dirs=p.dirs?p.dirs.concat(n.dirs):n.dirs),n.transition&&Yt(p,n.transition),N=p,Mn(K),N}const Pc=e=>{let t;for(const n in e)(n==="class"||n==="style"||en(n))&&((t||(t={}))[n]=e[n]);return t},Lc=(e,t)=>{const n={};for(const s in e)(!Fs(s)||!(s.slice(9)in t))&&(n[s]=e[s]);return n};function Ic(e,t,n){const{props:s,children:r,component:i}=e,{props:o,children:l,patchFlag:c}=t,f=i.emitsOptions;if(t.dirs||t.transition)return!0;if(n&&c>=0){if(c&1024)return!0;if(c&16)return s?Cr(s,o,f):!!o;if(c&8){const a=t.dynamicProps;for(let h=0;he.__isSuspense;function go(e,t){t&&t.pendingBranch?W(e)?t.effects.push(...e):t.effects.push(e):Vl(e)}const xe=Symbol.for("v-fgt"),gt=Symbol.for("v-txt"),ve=Symbol.for("v-cmt"),kt=Symbol.for("v-stc"),Bt=[];let Ae=null;function Os(e=!1){Bt.push(Ae=e?null:[])}function Nc(){Bt.pop(),Ae=Bt[Bt.length-1]||null}let Jt=1;function Ar(e,t=!1){Jt+=e,e<0&&Ae&&t&&(Ae.hasOnce=!0)}function mo(e){return e.dynamicChildren=Jt>0?Ae||Et:null,Nc(),Jt>0&&Ae&&Ae.push(e),e}function Of(e,t,n,s,r,i){return mo(vo(e,t,n,s,r,i,!0))}function Ms(e,t,n,s,r){return mo(ce(e,t,n,s,r,!0))}function zt(e){return e?e.__v_isVNode===!0:!1}function ut(e,t){return e.type===t.type&&e.key===t.key}const yo=({key:e})=>e??null,xn=({ref:e,ref_key:t,ref_for:n})=>(typeof e=="number"&&(e=""+e),e!=null?re(e)||fe(e)||q(e)?{i:de,r:e,k:t,f:!!n}:e:null);function vo(e,t=null,n=null,s=0,r=null,i=e===xe?0:1,o=!1,l=!1){const c={__v_isVNode:!0,__v_skip:!0,type:e,props:t,key:t&&yo(t),ref:t&&xn(t),scopeId:Ni,slotScopeIds:null,children:n,component:null,suspense:null,ssContent:null,ssFallback:null,dirs:null,transition:null,el:null,anchor:null,target:null,targetStart:null,targetAnchor:null,staticCount:0,shapeFlag:i,patchFlag:s,dynamicProps:r,dynamicChildren:null,appContext:null,ctx:de};return l?(er(c,n),i&128&&e.normalize(c)):n&&(c.shapeFlag|=re(n)?8:16),Jt>0&&!o&&Ae&&(c.patchFlag>0||i&6)&&c.patchFlag!==32&&Ae.push(c),c}const ce=Fc;function Fc(e,t=null,n=null,s=0,r=null,i=!1){if((!e||e===Gi)&&(e=ve),zt(e)){const l=nt(e,t,!0);return n&&er(l,n),Jt>0&&!i&&Ae&&(l.shapeFlag&6?Ae[Ae.indexOf(e)]=l:Ae.push(l)),l.patchFlag=-2,l}if(Kc(e)&&(e=e.__vccOpts),t){t=Hc(t);let{class:l,style:c}=t;l&&!re(l)&&(t.class=js(l)),ne(c)&&(Ks(c)&&!W(c)&&(c=ae({},c)),t.style=Ds(c))}const o=re(e)?1:po(e)?128:Hi(e)?64:ne(e)?4:q(e)?2:0;return vo(e,t,n,s,r,o,i,!0)}function Hc(e){return e?Ks(e)||eo(e)?ae({},e):e:null}function nt(e,t,n=!1,s=!1){const{props:r,ref:i,patchFlag:o,children:l,transition:c}=e,f=t?$c(r||{},t):r,a={__v_isVNode:!0,__v_skip:!0,type:e.type,props:f,key:f&&yo(f),ref:t&&t.ref?n&&i?W(i)?i.concat(xn(t)):[i,xn(t)]:xn(t):i,scopeId:e.scopeId,slotScopeIds:e.slotScopeIds,children:l,target:e.target,targetStart:e.targetStart,targetAnchor:e.targetAnchor,staticCount:e.staticCount,shapeFlag:e.shapeFlag,patchFlag:t&&e.type!==xe?o===-1?16:o|16:o,dynamicProps:e.dynamicProps,dynamicChildren:e.dynamicChildren,appContext:e.appContext,dirs:e.dirs,transition:c,component:e.component,suspense:e.suspense,ssContent:e.ssContent&&nt(e.ssContent),ssFallback:e.ssFallback&&nt(e.ssFallback),el:e.el,anchor:e.anchor,ctx:e.ctx,ce:e.ce};return c&&s&&Yt(a,c.clone(a)),a}function _o(e=" ",t=0){return ce(gt,null,e,t)}function Mf(e,t){const n=ce(kt,null,e);return n.staticCount=t,n}function Pf(e="",t=!1){return t?(Os(),Ms(ve,null,e)):ce(ve,null,e)}function Me(e){return e==null||typeof e=="boolean"?ce(ve):W(e)?ce(xe,null,e.slice()):zt(e)?et(e):ce(gt,null,String(e))}function et(e){return e.el===null&&e.patchFlag!==-1||e.memo?e:nt(e)}function er(e,t){let n=0;const{shapeFlag:s}=e;if(t==null)t=null;else if(W(t))n=16;else if(typeof t=="object")if(s&65){const r=t.default;r&&(r._c&&(r._d=!1),er(e,r()),r._c&&(r._d=!0));return}else{n=32;const r=t._;!r&&!eo(t)?t._ctx=de:r===3&&de&&(de.slots._===1?t._=1:(t._=2,e.patchFlag|=1024))}else q(t)?(t={default:t,_ctx:de},n=32):(t=String(t),s&64?(n=16,t=[_o(t)]):n=8);e.children=t,e.shapeFlag|=n}function $c(...e){const t={};for(let n=0;nue||de;let Ln,Ps;{const e=Hn(),t=(n,s)=>{let r;return(r=e[n])||(r=e[n]=[]),r.push(s),i=>{r.length>1?r.forEach(o=>o(i)):r[0](i)}};Ln=t("__VUE_INSTANCE_SETTERS__",n=>ue=n),Ps=t("__VUE_SSR_SETTERS__",n=>Mt=n)}const rn=e=>{const t=ue;return Ln(e),e.scope.on(),()=>{e.scope.off(),Ln(t)}},Rr=()=>{ue&&ue.scope.off(),Ln(null)};function bo(e){return e.vnode.shapeFlag&4}let Mt=!1;function Uc(e,t=!1,n=!1){t&&Ps(t);const{props:s,children:r}=e.vnode,i=bo(e);yc(e,s,i,t),wc(e,r,n);const o=i?kc(e,t):void 0;return t&&Ps(!1),o}function kc(e,t){const n=e.type;e.accessCache=Object.create(null),e.proxy=new Proxy(e.ctx,lc);const{setup:s}=n;if(s){rt();const r=e.setupContext=s.length>1?So(e):null,i=rn(e),o=tn(s,e,0,[e.props,r]),l=oi(o);if(it(),i(),(l||e.sp)&&!pt(e)&&Xs(e),l){if(o.then(Rr,Rr),t)return o.then(c=>{Or(e,c,t)}).catch(c=>{nn(c,e,0)});e.asyncDep=o}else Or(e,o,t)}else wo(e,t)}function Or(e,t,n){q(t)?e.type.__ssrInlineRender?e.ssrRender=t:e.render=t:ne(t)&&(e.setupState=Mi(t)),wo(e,n)}let Mr;function wo(e,t,n){const s=e.type;if(!e.render){if(!t&&Mr&&!s.render){const r=s.template||Js(e).template;if(r){const{isCustomElement:i,compilerOptions:o}=e.appContext.config,{delimiters:l,compilerOptions:c}=s,f=ae(ae({isCustomElement:i,delimiters:l},o),c);s.render=Mr(r,f)}}e.render=s.render||ke}{const r=rn(e);rt();try{ac(e)}finally{it(),r()}}}const Bc={get(e,t){return me(e,"get",""),e[t]}};function So(e){const t=n=>{e.exposed=n||{}};return{attrs:new Proxy(e.attrs,Bc),slots:e.slots,emit:e.emit,expose:t}}function Gn(e){return e.exposed?e.exposeProxy||(e.exposeProxy=new Proxy(Mi(wn(e.exposed)),{get(t,n){if(n in t)return t[n];if(n in Ut)return Ut[n](e)},has(t,n){return n in t||n in Ut}})):e.proxy}function Wc(e,t=!0){return q(e)?e.displayName||e.name:e.name||t&&e.__name}function Kc(e){return q(e)&&"__vccOpts"in e}const ie=(e,t)=>Fl(e,t,Mt);function Ls(e,t,n){const s=arguments.length;return s===2?ne(t)&&!W(t)?zt(t)?ce(e,null,[t]):ce(e,t):ce(e,null,t):(s>3?n=Array.prototype.slice.call(arguments,2):s===3&&zt(n)&&(n=[n]),ce(e,t,n))}const qc="3.5.13";/** +* @vue/runtime-dom v3.5.13 +* (c) 2018-present Yuxi (Evan) You and Vue contributors +* @license MIT +**/let Is;const Pr=typeof window<"u"&&window.trustedTypes;if(Pr)try{Is=Pr.createPolicy("vue",{createHTML:e=>e})}catch{}const xo=Is?e=>Is.createHTML(e):e=>e,Gc="http://www.w3.org/2000/svg",Yc="http://www.w3.org/1998/Math/MathML",qe=typeof document<"u"?document:null,Lr=qe&&qe.createElement("template"),Xc={insert:(e,t,n)=>{t.insertBefore(e,n||null)},remove:e=>{const t=e.parentNode;t&&t.removeChild(e)},createElement:(e,t,n,s)=>{const r=t==="svg"?qe.createElementNS(Gc,e):t==="mathml"?qe.createElementNS(Yc,e):n?qe.createElement(e,{is:n}):qe.createElement(e);return e==="select"&&s&&s.multiple!=null&&r.setAttribute("multiple",s.multiple),r},createText:e=>qe.createTextNode(e),createComment:e=>qe.createComment(e),setText:(e,t)=>{e.nodeValue=t},setElementText:(e,t)=>{e.textContent=t},parentNode:e=>e.parentNode,nextSibling:e=>e.nextSibling,querySelector:e=>qe.querySelector(e),setScopeId(e,t){e.setAttribute(t,"")},insertStaticContent(e,t,n,s,r,i){const o=n?n.previousSibling:t.lastChild;if(r&&(r===i||r.nextSibling))for(;t.insertBefore(r.cloneNode(!0),n),!(r===i||!(r=r.nextSibling)););else{Lr.innerHTML=xo(s==="svg"?`${e}`:s==="mathml"?`${e}`:e);const l=Lr.content;if(s==="svg"||s==="mathml"){const c=l.firstChild;for(;c.firstChild;)l.appendChild(c.firstChild);l.removeChild(c)}t.insertBefore(l,n)}return[o?o.nextSibling:t.firstChild,n?n.previousSibling:t.lastChild]}},ze="transition",Ht="animation",Qt=Symbol("_vtc"),Eo={name:String,type:String,css:{type:Boolean,default:!0},duration:[String,Number,Object],enterFromClass:String,enterActiveClass:String,enterToClass:String,appearFromClass:String,appearActiveClass:String,appearToClass:String,leaveFromClass:String,leaveActiveClass:String,leaveToClass:String},Jc=ae({},ji,Eo),zc=e=>(e.displayName="Transition",e.props=Jc,e),Lf=zc((e,{slots:t})=>Ls(Kl,Qc(e),t)),ct=(e,t=[])=>{W(e)?e.forEach(n=>n(...t)):e&&e(...t)},Ir=e=>e?W(e)?e.some(t=>t.length>1):e.length>1:!1;function Qc(e){const t={};for(const x in e)x in Eo||(t[x]=e[x]);if(e.css===!1)return t;const{name:n="v",type:s,duration:r,enterFromClass:i=`${n}-enter-from`,enterActiveClass:o=`${n}-enter-active`,enterToClass:l=`${n}-enter-to`,appearFromClass:c=i,appearActiveClass:f=o,appearToClass:a=l,leaveFromClass:h=`${n}-leave-from`,leaveActiveClass:y=`${n}-leave-active`,leaveToClass:v=`${n}-leave-to`}=e,S=Zc(r),_=S&&S[0],K=S&&S[1],{onBeforeEnter:N,onEnter:j,onEnterCancelled:p,onLeave:g,onLeaveCancelled:O,onBeforeAppear:F=N,onAppear:$=j,onAppearCancelled:V=p}=t,R=(x,B,se,le)=>{x._enterCancelled=le,at(x,B?a:l),at(x,B?f:o),se&&se()},b=(x,B)=>{x._isLeaving=!1,at(x,h),at(x,v),at(x,y),B&&B()},I=x=>(B,se)=>{const le=x?$:j,U=()=>R(B,x,se);ct(le,[B,U]),Nr(()=>{at(B,x?c:i),Ke(B,x?a:l),Ir(le)||Fr(B,s,_,U)})};return ae(t,{onBeforeEnter(x){ct(N,[x]),Ke(x,i),Ke(x,o)},onBeforeAppear(x){ct(F,[x]),Ke(x,c),Ke(x,f)},onEnter:I(!1),onAppear:I(!0),onLeave(x,B){x._isLeaving=!0;const se=()=>b(x,B);Ke(x,h),x._enterCancelled?(Ke(x,y),Dr()):(Dr(),Ke(x,y)),Nr(()=>{x._isLeaving&&(at(x,h),Ke(x,v),Ir(g)||Fr(x,s,K,se))}),ct(g,[x,se])},onEnterCancelled(x){R(x,!1,void 0,!0),ct(p,[x])},onAppearCancelled(x){R(x,!0,void 0,!0),ct(V,[x])},onLeaveCancelled(x){b(x),ct(O,[x])}})}function Zc(e){if(e==null)return null;if(ne(e))return[os(e.enter),os(e.leave)];{const t=os(e);return[t,t]}}function os(e){return Jo(e)}function Ke(e,t){t.split(/\s+/).forEach(n=>n&&e.classList.add(n)),(e[Qt]||(e[Qt]=new Set)).add(t)}function at(e,t){t.split(/\s+/).forEach(s=>s&&e.classList.remove(s));const n=e[Qt];n&&(n.delete(t),n.size||(e[Qt]=void 0))}function Nr(e){requestAnimationFrame(()=>{requestAnimationFrame(e)})}let ea=0;function Fr(e,t,n,s){const r=e._endId=++ea,i=()=>{r===e._endId&&s()};if(n!=null)return setTimeout(i,n);const{type:o,timeout:l,propCount:c}=ta(e,t);if(!o)return s();const f=o+"end";let a=0;const h=()=>{e.removeEventListener(f,y),i()},y=v=>{v.target===e&&++a>=c&&h()};setTimeout(()=>{a(n[S]||"").split(", "),r=s(`${ze}Delay`),i=s(`${ze}Duration`),o=Hr(r,i),l=s(`${Ht}Delay`),c=s(`${Ht}Duration`),f=Hr(l,c);let a=null,h=0,y=0;t===ze?o>0&&(a=ze,h=o,y=i.length):t===Ht?f>0&&(a=Ht,h=f,y=c.length):(h=Math.max(o,f),a=h>0?o>f?ze:Ht:null,y=a?a===ze?i.length:c.length:0);const v=a===ze&&/\b(transform|all)(,|$)/.test(s(`${ze}Property`).toString());return{type:a,timeout:h,propCount:y,hasTransform:v}}function Hr(e,t){for(;e.length$r(n)+$r(e[s])))}function $r(e){return e==="auto"?0:Number(e.slice(0,-1).replace(",","."))*1e3}function Dr(){return document.body.offsetHeight}function na(e,t,n){const s=e[Qt];s&&(t=(t?[t,...s]:[...s]).join(" ")),t==null?e.removeAttribute("class"):n?e.setAttribute("class",t):e.className=t}const jr=Symbol("_vod"),sa=Symbol("_vsh"),ra=Symbol(""),ia=/(^|;)\s*display\s*:/;function oa(e,t,n){const s=e.style,r=re(n);let i=!1;if(n&&!r){if(t)if(re(t))for(const o of t.split(";")){const l=o.slice(0,o.indexOf(":")).trim();n[l]==null&&En(s,l,"")}else for(const o in t)n[o]==null&&En(s,o,"");for(const o in n)o==="display"&&(i=!0),En(s,o,n[o])}else if(r){if(t!==n){const o=s[ra];o&&(n+=";"+o),s.cssText=n,i=ia.test(n)}}else t&&e.removeAttribute("style");jr in e&&(e[jr]=i?s.display:"",e[sa]&&(s.display="none"))}const Vr=/\s*!important$/;function En(e,t,n){if(W(n))n.forEach(s=>En(e,t,s));else if(n==null&&(n=""),t.startsWith("--"))e.setProperty(t,n);else{const s=la(e,t);Vr.test(n)?e.setProperty(st(s),n.replace(Vr,""),"important"):e[s]=n}}const Ur=["Webkit","Moz","ms"],ls={};function la(e,t){const n=ls[t];if(n)return n;let s=Le(t);if(s!=="filter"&&s in e)return ls[t]=s;s=Fn(s);for(let r=0;rcs||(ua.then(()=>cs=0),cs=Date.now());function ha(e,t){const n=s=>{if(!s._vts)s._vts=Date.now();else if(s._vts<=n.attached)return;He(pa(s,n.value),t,5,[s])};return n.value=e,n.attached=da(),n}function pa(e,t){if(W(t)){const n=e.stopImmediatePropagation;return e.stopImmediatePropagation=()=>{n.call(e),e._stopped=!0},t.map(s=>r=>!r._stopped&&s&&s(r))}else return t}const Gr=e=>e.charCodeAt(0)===111&&e.charCodeAt(1)===110&&e.charCodeAt(2)>96&&e.charCodeAt(2)<123,ga=(e,t,n,s,r,i)=>{const o=r==="svg";t==="class"?na(e,s,o):t==="style"?oa(e,n,s):en(t)?Fs(t)||aa(e,t,n,s,i):(t[0]==="."?(t=t.slice(1),!0):t[0]==="^"?(t=t.slice(1),!1):ma(e,t,s,o))?(Wr(e,t,s),!e.tagName.includes("-")&&(t==="value"||t==="checked"||t==="selected")&&Br(e,t,s,o,i,t!=="value")):e._isVueCE&&(/[A-Z]/.test(t)||!re(s))?Wr(e,Le(t),s,i,t):(t==="true-value"?e._trueValue=s:t==="false-value"&&(e._falseValue=s),Br(e,t,s,o))};function ma(e,t,n,s){if(s)return!!(t==="innerHTML"||t==="textContent"||t in e&&Gr(t)&&q(n));if(t==="spellcheck"||t==="draggable"||t==="translate"||t==="form"||t==="list"&&e.tagName==="INPUT"||t==="type"&&e.tagName==="TEXTAREA")return!1;if(t==="width"||t==="height"){const r=e.tagName;if(r==="IMG"||r==="VIDEO"||r==="CANVAS"||r==="SOURCE")return!1}return Gr(t)&&re(n)?!1:t in e}const Yr=e=>{const t=e.props["onUpdate:modelValue"]||!1;return W(t)?n=>bn(t,n):t};function ya(e){e.target.composing=!0}function Xr(e){const t=e.target;t.composing&&(t.composing=!1,t.dispatchEvent(new Event("input")))}const as=Symbol("_assign"),If={created(e,{modifiers:{lazy:t,trim:n,number:s}},r){e[as]=Yr(r);const i=s||r.props&&r.props.type==="number";St(e,t?"change":"input",o=>{if(o.target.composing)return;let l=e.value;n&&(l=l.trim()),i&&(l=vs(l)),e[as](l)}),n&&St(e,"change",()=>{e.value=e.value.trim()}),t||(St(e,"compositionstart",ya),St(e,"compositionend",Xr),St(e,"change",Xr))},mounted(e,{value:t}){e.value=t??""},beforeUpdate(e,{value:t,oldValue:n,modifiers:{lazy:s,trim:r,number:i}},o){if(e[as]=Yr(o),e.composing)return;const l=(i||e.type==="number")&&!/^0\d/.test(e.value)?vs(e.value):e.value,c=t??"";l!==c&&(document.activeElement===e&&e.type!=="range"&&(s&&t===n||r&&e.value.trim()===c)||(e.value=c))}},va=["ctrl","shift","alt","meta"],_a={stop:e=>e.stopPropagation(),prevent:e=>e.preventDefault(),self:e=>e.target!==e.currentTarget,ctrl:e=>!e.ctrlKey,shift:e=>!e.shiftKey,alt:e=>!e.altKey,meta:e=>!e.metaKey,left:e=>"button"in e&&e.button!==0,middle:e=>"button"in e&&e.button!==1,right:e=>"button"in e&&e.button!==2,exact:(e,t)=>va.some(n=>e[`${n}Key`]&&!t.includes(n))},Nf=(e,t)=>{const n=e._withMods||(e._withMods={}),s=t.join(".");return n[s]||(n[s]=(r,...i)=>{for(let o=0;o{const n=e._withKeys||(e._withKeys={}),s=t.join(".");return n[s]||(n[s]=r=>{if(!("key"in r))return;const i=st(r.key);if(t.some(o=>o===i||ba[o]===i))return e(r)})},To=ae({patchProp:ga},Xc);let Wt,Jr=!1;function wa(){return Wt||(Wt=xc(To))}function Sa(){return Wt=Jr?Wt:Ec(To),Jr=!0,Wt}const Hf=(...e)=>{const t=wa().createApp(...e),{mount:n}=t;return t.mount=s=>{const r=Ao(s);if(!r)return;const i=t._component;!q(i)&&!i.render&&!i.template&&(i.template=r.innerHTML),r.nodeType===1&&(r.textContent="");const o=n(r,!1,Co(r));return r instanceof Element&&(r.removeAttribute("v-cloak"),r.setAttribute("data-v-app","")),o},t},$f=(...e)=>{const t=Sa().createApp(...e),{mount:n}=t;return t.mount=s=>{const r=Ao(s);if(r)return n(r,!0,Co(r))},t};function Co(e){if(e instanceof SVGElement)return"svg";if(typeof MathMLElement=="function"&&e instanceof MathMLElement)return"mathml"}function Ao(e){return re(e)?document.querySelector(e):e}const Df=(e,t)=>{const n=e.__vccOpts||e;for(const[s,r]of t)n[s]=r;return n},xa=window.__VP_SITE_DATA__;function tr(e){return hi()?(il(e),!0):!1}function Be(e){return typeof e=="function"?e():Oi(e)}const Ro=typeof window<"u"&&typeof document<"u";typeof WorkerGlobalScope<"u"&&globalThis instanceof WorkerGlobalScope;const jf=e=>e!=null,Ea=Object.prototype.toString,Ta=e=>Ea.call(e)==="[object Object]",Zt=()=>{},zr=Ca();function Ca(){var e,t;return Ro&&((e=window==null?void 0:window.navigator)==null?void 0:e.userAgent)&&(/iP(?:ad|hone|od)/.test(window.navigator.userAgent)||((t=window==null?void 0:window.navigator)==null?void 0:t.maxTouchPoints)>2&&/iPad|Macintosh/.test(window==null?void 0:window.navigator.userAgent))}function Aa(e,t){function n(...s){return new Promise((r,i)=>{Promise.resolve(e(()=>t.apply(this,s),{fn:t,thisArg:this,args:s})).then(r).catch(i)})}return n}const Oo=e=>e();function Ra(e,t={}){let n,s,r=Zt;const i=l=>{clearTimeout(l),r(),r=Zt};return l=>{const c=Be(e),f=Be(t.maxWait);return n&&i(n),c<=0||f!==void 0&&f<=0?(s&&(i(s),s=null),Promise.resolve(l())):new Promise((a,h)=>{r=t.rejectOnCancel?h:a,f&&!s&&(s=setTimeout(()=>{n&&i(n),s=null,a(l())},f)),n=setTimeout(()=>{s&&i(s),s=null,a(l())},c)})}}function Oa(e=Oo){const t=oe(!0);function n(){t.value=!1}function s(){t.value=!0}const r=(...i)=>{t.value&&e(...i)};return{isActive:Vn(t),pause:n,resume:s,eventFilter:r}}function Ma(e){return qn()}function Mo(...e){if(e.length!==1)return Ll(...e);const t=e[0];return typeof t=="function"?Vn(Ol(()=>({get:t,set:Zt}))):oe(t)}function Po(e,t,n={}){const{eventFilter:s=Oo,...r}=n;return Fe(e,Aa(s,t),r)}function Pa(e,t,n={}){const{eventFilter:s,...r}=n,{eventFilter:i,pause:o,resume:l,isActive:c}=Oa(s);return{stop:Po(e,t,{...r,eventFilter:i}),pause:o,resume:l,isActive:c}}function nr(e,t=!0,n){Ma()?Lt(e,n):t?e():Un(e)}function Vf(e,t,n={}){const{debounce:s=0,maxWait:r=void 0,...i}=n;return Po(e,t,{...i,eventFilter:Ra(s,{maxWait:r})})}function Uf(e,t,n){let s;fe(n)?s={evaluating:n}:s={};const{lazy:r=!1,evaluating:i=void 0,shallow:o=!0,onError:l=Zt}=s,c=oe(!r),f=o?qs(t):oe(t);let a=0;return Zs(async h=>{if(!c.value)return;a++;const y=a;let v=!1;i&&Promise.resolve().then(()=>{i.value=!0});try{const S=await e(_=>{h(()=>{i&&(i.value=!1),v||_()})});y===a&&(f.value=S)}catch(S){l(S)}finally{i&&y===a&&(i.value=!1),v=!0}}),r?ie(()=>(c.value=!0,f.value)):f}const $e=Ro?window:void 0;function Lo(e){var t;const n=Be(e);return(t=n==null?void 0:n.$el)!=null?t:n}function Pt(...e){let t,n,s,r;if(typeof e[0]=="string"||Array.isArray(e[0])?([n,s,r]=e,t=$e):[t,n,s,r]=e,!t)return Zt;Array.isArray(n)||(n=[n]),Array.isArray(s)||(s=[s]);const i=[],o=()=>{i.forEach(a=>a()),i.length=0},l=(a,h,y,v)=>(a.addEventListener(h,y,v),()=>a.removeEventListener(h,y,v)),c=Fe(()=>[Lo(t),Be(r)],([a,h])=>{if(o(),!a)return;const y=Ta(h)?{...h}:h;i.push(...n.flatMap(v=>s.map(S=>l(a,v,S,y))))},{immediate:!0,flush:"post"}),f=()=>{c(),o()};return tr(f),f}function La(e){return typeof e=="function"?e:typeof e=="string"?t=>t.key===e:Array.isArray(e)?t=>e.includes(t.key):()=>!0}function kf(...e){let t,n,s={};e.length===3?(t=e[0],n=e[1],s=e[2]):e.length===2?typeof e[1]=="object"?(t=!0,n=e[0],s=e[1]):(t=e[0],n=e[1]):(t=!0,n=e[0]);const{target:r=$e,eventName:i="keydown",passive:o=!1,dedupe:l=!1}=s,c=La(t);return Pt(r,i,a=>{a.repeat&&Be(l)||c(a)&&n(a)},o)}function Ia(){const e=oe(!1),t=qn();return t&&Lt(()=>{e.value=!0},t),e}function Na(e){const t=Ia();return ie(()=>(t.value,!!e()))}function Io(e,t={}){const{window:n=$e}=t,s=Na(()=>n&&"matchMedia"in n&&typeof n.matchMedia=="function");let r;const i=oe(!1),o=f=>{i.value=f.matches},l=()=>{r&&("removeEventListener"in r?r.removeEventListener("change",o):r.removeListener(o))},c=Zs(()=>{s.value&&(l(),r=n.matchMedia(Be(e)),"addEventListener"in r?r.addEventListener("change",o):r.addListener(o),i.value=r.matches)});return tr(()=>{c(),l(),r=void 0}),i}const gn=typeof globalThis<"u"?globalThis:typeof window<"u"?window:typeof global<"u"?global:typeof self<"u"?self:{},mn="__vueuse_ssr_handlers__",Fa=Ha();function Ha(){return mn in gn||(gn[mn]=gn[mn]||{}),gn[mn]}function No(e,t){return Fa[e]||t}function sr(e){return Io("(prefers-color-scheme: dark)",e)}function $a(e){return e==null?"any":e instanceof Set?"set":e instanceof Map?"map":e instanceof Date?"date":typeof e=="boolean"?"boolean":typeof e=="string"?"string":typeof e=="object"?"object":Number.isNaN(e)?"any":"number"}const Da={boolean:{read:e=>e==="true",write:e=>String(e)},object:{read:e=>JSON.parse(e),write:e=>JSON.stringify(e)},number:{read:e=>Number.parseFloat(e),write:e=>String(e)},any:{read:e=>e,write:e=>String(e)},string:{read:e=>e,write:e=>String(e)},map:{read:e=>new Map(JSON.parse(e)),write:e=>JSON.stringify(Array.from(e.entries()))},set:{read:e=>new Set(JSON.parse(e)),write:e=>JSON.stringify(Array.from(e))},date:{read:e=>new Date(e),write:e=>e.toISOString()}},Qr="vueuse-storage";function rr(e,t,n,s={}){var r;const{flush:i="pre",deep:o=!0,listenToStorageChanges:l=!0,writeDefaults:c=!0,mergeDefaults:f=!1,shallow:a,window:h=$e,eventFilter:y,onError:v=b=>{console.error(b)},initOnMounted:S}=s,_=(a?qs:oe)(typeof t=="function"?t():t);if(!n)try{n=No("getDefaultStorage",()=>{var b;return(b=$e)==null?void 0:b.localStorage})()}catch(b){v(b)}if(!n)return _;const K=Be(t),N=$a(K),j=(r=s.serializer)!=null?r:Da[N],{pause:p,resume:g}=Pa(_,()=>F(_.value),{flush:i,deep:o,eventFilter:y});h&&l&&nr(()=>{n instanceof Storage?Pt(h,"storage",V):Pt(h,Qr,R),S&&V()}),S||V();function O(b,I){if(h){const x={key:e,oldValue:b,newValue:I,storageArea:n};h.dispatchEvent(n instanceof Storage?new StorageEvent("storage",x):new CustomEvent(Qr,{detail:x}))}}function F(b){try{const I=n.getItem(e);if(b==null)O(I,null),n.removeItem(e);else{const x=j.write(b);I!==x&&(n.setItem(e,x),O(I,x))}}catch(I){v(I)}}function $(b){const I=b?b.newValue:n.getItem(e);if(I==null)return c&&K!=null&&n.setItem(e,j.write(K)),K;if(!b&&f){const x=j.read(I);return typeof f=="function"?f(x,K):N==="object"&&!Array.isArray(x)?{...K,...x}:x}else return typeof I!="string"?I:j.read(I)}function V(b){if(!(b&&b.storageArea!==n)){if(b&&b.key==null){_.value=K;return}if(!(b&&b.key!==e)){p();try{(b==null?void 0:b.newValue)!==j.write(_.value)&&(_.value=$(b))}catch(I){v(I)}finally{b?Un(g):g()}}}}function R(b){V(b.detail)}return _}const ja="*,*::before,*::after{-webkit-transition:none!important;-moz-transition:none!important;-o-transition:none!important;-ms-transition:none!important;transition:none!important}";function Va(e={}){const{selector:t="html",attribute:n="class",initialValue:s="auto",window:r=$e,storage:i,storageKey:o="vueuse-color-scheme",listenToStorageChanges:l=!0,storageRef:c,emitAuto:f,disableTransition:a=!0}=e,h={auto:"",light:"light",dark:"dark",...e.modes||{}},y=sr({window:r}),v=ie(()=>y.value?"dark":"light"),S=c||(o==null?Mo(s):rr(o,s,i,{window:r,listenToStorageChanges:l})),_=ie(()=>S.value==="auto"?v.value:S.value),K=No("updateHTMLAttrs",(g,O,F)=>{const $=typeof g=="string"?r==null?void 0:r.document.querySelector(g):Lo(g);if(!$)return;const V=new Set,R=new Set;let b=null;if(O==="class"){const x=F.split(/\s/g);Object.values(h).flatMap(B=>(B||"").split(/\s/g)).filter(Boolean).forEach(B=>{x.includes(B)?V.add(B):R.add(B)})}else b={key:O,value:F};if(V.size===0&&R.size===0&&b===null)return;let I;a&&(I=r.document.createElement("style"),I.appendChild(document.createTextNode(ja)),r.document.head.appendChild(I));for(const x of V)$.classList.add(x);for(const x of R)$.classList.remove(x);b&&$.setAttribute(b.key,b.value),a&&(r.getComputedStyle(I).opacity,document.head.removeChild(I))});function N(g){var O;K(t,n,(O=h[g])!=null?O:g)}function j(g){e.onChanged?e.onChanged(g,N):N(g)}Fe(_,j,{flush:"post",immediate:!0}),nr(()=>j(_.value));const p=ie({get(){return f?S.value:_.value},set(g){S.value=g}});try{return Object.assign(p,{store:S,system:v,state:_})}catch{return p}}function Ua(e={}){const{valueDark:t="dark",valueLight:n="",window:s=$e}=e,r=Va({...e,onChanged:(l,c)=>{var f;e.onChanged?(f=e.onChanged)==null||f.call(e,l==="dark",c,l):c(l)},modes:{dark:t,light:n}}),i=ie(()=>r.system?r.system.value:sr({window:s}).value?"dark":"light");return ie({get(){return r.value==="dark"},set(l){const c=l?"dark":"light";i.value===c?r.value="auto":r.value=c}})}function fs(e){return typeof Window<"u"&&e instanceof Window?e.document.documentElement:typeof Document<"u"&&e instanceof Document?e.documentElement:e}function Bf(e,t,n={}){const{window:s=$e}=n;return rr(e,t,s==null?void 0:s.localStorage,n)}function Fo(e){const t=window.getComputedStyle(e);if(t.overflowX==="scroll"||t.overflowY==="scroll"||t.overflowX==="auto"&&e.clientWidth1?!0:(t.preventDefault&&t.preventDefault(),!1)}const us=new WeakMap;function Wf(e,t=!1){const n=oe(t);let s=null,r="";Fe(Mo(e),l=>{const c=fs(Be(l));if(c){const f=c;if(us.get(f)||us.set(f,f.style.overflow),f.style.overflow!=="hidden"&&(r=f.style.overflow),f.style.overflow==="hidden")return n.value=!0;if(n.value)return f.style.overflow="hidden"}},{immediate:!0});const i=()=>{const l=fs(Be(e));!l||n.value||(zr&&(s=Pt(l,"touchmove",c=>{ka(c)},{passive:!1})),l.style.overflow="hidden",n.value=!0)},o=()=>{const l=fs(Be(e));!l||!n.value||(zr&&(s==null||s()),l.style.overflow=r,us.delete(l),n.value=!1)};return tr(o),ie({get(){return n.value},set(l){l?i():o()}})}function Kf(e,t,n={}){const{window:s=$e}=n;return rr(e,t,s==null?void 0:s.sessionStorage,n)}function qf(e={}){const{window:t=$e,behavior:n="auto"}=e;if(!t)return{x:oe(0),y:oe(0)};const s=oe(t.scrollX),r=oe(t.scrollY),i=ie({get(){return s.value},set(l){scrollTo({left:l,behavior:n})}}),o=ie({get(){return r.value},set(l){scrollTo({top:l,behavior:n})}});return Pt(t,"scroll",()=>{s.value=t.scrollX,r.value=t.scrollY},{capture:!1,passive:!0}),{x:i,y:o}}function Gf(e={}){const{window:t=$e,initialWidth:n=Number.POSITIVE_INFINITY,initialHeight:s=Number.POSITIVE_INFINITY,listenOrientation:r=!0,includeScrollbar:i=!0,type:o="inner"}=e,l=oe(n),c=oe(s),f=()=>{t&&(o==="outer"?(l.value=t.outerWidth,c.value=t.outerHeight):i?(l.value=t.innerWidth,c.value=t.innerHeight):(l.value=t.document.documentElement.clientWidth,c.value=t.document.documentElement.clientHeight))};if(f(),nr(f),Pt("resize",f,{passive:!0}),r){const a=Io("(orientation: portrait)");Fe(a,()=>f())}return{width:l,height:c}}const ds={BASE_URL:"/GeometryOps.jl/previews/PR237/",DEV:!1,MODE:"production",PROD:!0,SSR:!1};var hs={};const Ho=/^(?:[a-z]+:|\/\/)/i,Ba="vitepress-theme-appearance",Wa=/#.*$/,Ka=/[?#].*$/,qa=/(?:(^|\/)index)?\.(?:md|html)$/,ge=typeof document<"u",$o={relativePath:"404.md",filePath:"",title:"404",description:"Not Found",headers:[],frontmatter:{sidebar:!1,layout:"page"},lastUpdated:0,isNotFound:!0};function Ga(e,t,n=!1){if(t===void 0)return!1;if(e=Zr(`/${e}`),n)return new RegExp(t).test(e);if(Zr(t)!==e)return!1;const s=t.match(Wa);return s?(ge?location.hash:"")===s[0]:!0}function Zr(e){return decodeURI(e).replace(Ka,"").replace(qa,"$1")}function Ya(e){return Ho.test(e)}function Xa(e,t){return Object.keys((e==null?void 0:e.locales)||{}).find(n=>n!=="root"&&!Ya(n)&&Ga(t,`/${n}/`,!0))||"root"}function Ja(e,t){var s,r,i,o,l,c,f;const n=Xa(e,t);return Object.assign({},e,{localeIndex:n,lang:((s=e.locales[n])==null?void 0:s.lang)??e.lang,dir:((r=e.locales[n])==null?void 0:r.dir)??e.dir,title:((i=e.locales[n])==null?void 0:i.title)??e.title,titleTemplate:((o=e.locales[n])==null?void 0:o.titleTemplate)??e.titleTemplate,description:((l=e.locales[n])==null?void 0:l.description)??e.description,head:jo(e.head,((c=e.locales[n])==null?void 0:c.head)??[]),themeConfig:{...e.themeConfig,...(f=e.locales[n])==null?void 0:f.themeConfig}})}function Do(e,t){const n=t.title||e.title,s=t.titleTemplate??e.titleTemplate;if(typeof s=="string"&&s.includes(":title"))return s.replace(/:title/g,n);const r=za(e.title,s);return n===r.slice(3)?n:`${n}${r}`}function za(e,t){return t===!1?"":t===!0||t===void 0?` | ${e}`:e===t?"":` | ${t}`}function Qa(e,t){const[n,s]=t;if(n!=="meta")return!1;const r=Object.entries(s)[0];return r==null?!1:e.some(([i,o])=>i===n&&o[r[0]]===r[1])}function jo(e,t){return[...e.filter(n=>!Qa(t,n)),...t]}const Za=/[\u0000-\u001F"#$&*+,:;<=>?[\]^`{|}\u007F]/g,ef=/^[a-z]:/i;function ei(e){const t=ef.exec(e),n=t?t[0]:"";return n+e.slice(n.length).replace(Za,"_").replace(/(^|\/)_+(?=[^/]*$)/,"$1")}const ps=new Set;function tf(e){if(ps.size===0){const n=typeof process=="object"&&(hs==null?void 0:hs.VITE_EXTRA_EXTENSIONS)||(ds==null?void 0:ds.VITE_EXTRA_EXTENSIONS)||"";("3g2,3gp,aac,ai,apng,au,avif,bin,bmp,cer,class,conf,crl,css,csv,dll,doc,eps,epub,exe,gif,gz,ics,ief,jar,jpe,jpeg,jpg,js,json,jsonld,m4a,man,mid,midi,mjs,mov,mp2,mp3,mp4,mpe,mpeg,mpg,mpp,oga,ogg,ogv,ogx,opus,otf,p10,p7c,p7m,p7s,pdf,png,ps,qt,roff,rtf,rtx,ser,svg,t,tif,tiff,tr,ts,tsv,ttf,txt,vtt,wav,weba,webm,webp,woff,woff2,xhtml,xml,yaml,yml,zip"+(n&&typeof n=="string"?","+n:"")).split(",").forEach(s=>ps.add(s))}const t=e.split(".").pop();return t==null||!ps.has(t.toLowerCase())}function Yf(e){return e.replace(/[|\\{}()[\]^$+*?.]/g,"\\$&").replace(/-/g,"\\x2d")}const nf=Symbol(),mt=qs(xa);function Xf(e){const t=ie(()=>Ja(mt.value,e.data.relativePath)),n=t.value.appearance,s=n==="force-dark"?oe(!0):n==="force-auto"?sr():n?Ua({storageKey:Ba,initialValue:()=>n==="dark"?"dark":"auto",...typeof n=="object"?n:{}}):oe(!1),r=oe(ge?location.hash:"");return ge&&window.addEventListener("hashchange",()=>{r.value=location.hash}),Fe(()=>e.data,()=>{r.value=ge?location.hash:""}),{site:t,theme:ie(()=>t.value.themeConfig),page:ie(()=>e.data),frontmatter:ie(()=>e.data.frontmatter),params:ie(()=>e.data.params),lang:ie(()=>t.value.lang),dir:ie(()=>e.data.frontmatter.dir||t.value.dir),localeIndex:ie(()=>t.value.localeIndex||"root"),title:ie(()=>Do(t.value,e.data)),description:ie(()=>e.data.description||t.value.description),isDark:s,hash:ie(()=>r.value)}}function sf(){const e=Ot(nf);if(!e)throw new Error("vitepress data not properly injected in app");return e}function rf(e,t){return`${e}${t}`.replace(/\/+/g,"/")}function ti(e){return Ho.test(e)||!e.startsWith("/")?e:rf(mt.value.base,e)}function of(e){let t=e.replace(/\.html$/,"");if(t=decodeURIComponent(t),t=t.replace(/\/$/,"/index"),ge){const n="/GeometryOps.jl/previews/PR237/";t=ei(t.slice(n.length).replace(/\//g,"_")||"index")+".md";let s=__VP_HASH_MAP__[t.toLowerCase()];if(s||(t=t.endsWith("_index.md")?t.slice(0,-9)+".md":t.slice(0,-3)+"_index.md",s=__VP_HASH_MAP__[t.toLowerCase()]),!s)return null;t=`${n}assets/${t}.${s}.js`}else t=`./${ei(t.slice(1).replace(/\//g,"_"))}.md.js`;return t}let Tn=[];function Jf(e){Tn.push(e),Bn(()=>{Tn=Tn.filter(t=>t!==e)})}function lf(){let e=mt.value.scrollOffset,t=0,n=24;if(typeof e=="object"&&"padding"in e&&(n=e.padding,e=e.selector),typeof e=="number")t=e;else if(typeof e=="string")t=ni(e,n);else if(Array.isArray(e))for(const s of e){const r=ni(s,n);if(r){t=r;break}}return t}function ni(e,t){const n=document.querySelector(e);if(!n)return 0;const s=n.getBoundingClientRect().bottom;return s<0?0:s+t}const cf=Symbol(),Vo="http://a.com",af=()=>({path:"/",component:null,data:$o});function zf(e,t){const n=jn(af()),s={route:n,go:r};async function r(l=ge?location.href:"/"){var c,f;l=gs(l),await((c=s.onBeforeRouteChange)==null?void 0:c.call(s,l))!==!1&&(ge&&l!==gs(location.href)&&(history.replaceState({scrollPosition:window.scrollY},""),history.pushState({},"",l)),await o(l),await((f=s.onAfterRouteChanged)==null?void 0:f.call(s,l)))}let i=null;async function o(l,c=0,f=!1){var y,v;if(await((y=s.onBeforePageLoad)==null?void 0:y.call(s,l))===!1)return;const a=new URL(l,Vo),h=i=a.pathname;try{let S=await e(h);if(!S)throw new Error(`Page not found: ${h}`);if(i===h){i=null;const{default:_,__pageData:K}=S;if(!_)throw new Error(`Invalid route component: ${_}`);await((v=s.onAfterPageLoad)==null?void 0:v.call(s,l)),n.path=ge?h:ti(h),n.component=wn(_),n.data=wn(K),ge&&Un(()=>{let N=mt.value.base+K.relativePath.replace(/(?:(^|\/)index)?\.md$/,"$1");if(!mt.value.cleanUrls&&!N.endsWith("/")&&(N+=".html"),N!==a.pathname&&(a.pathname=N,l=N+a.search+a.hash,history.replaceState({},"",l)),a.hash&&!c){let j=null;try{j=document.getElementById(decodeURIComponent(a.hash).slice(1))}catch(p){console.warn(p)}if(j){si(j,a.hash);return}}window.scrollTo(0,c)})}}catch(S){if(!/fetch|Page not found/.test(S.message)&&!/^\/404(\.html|\/)?$/.test(l)&&console.error(S),!f)try{const _=await fetch(mt.value.base+"hashmap.json");window.__VP_HASH_MAP__=await _.json(),await o(l,c,!0);return}catch{}if(i===h){i=null,n.path=ge?h:ti(h),n.component=t?wn(t):null;const _=ge?h.replace(/(^|\/)$/,"$1index").replace(/(\.html)?$/,".md").replace(/^\//,""):"404.md";n.data={...$o,relativePath:_}}}}return ge&&(history.state===null&&history.replaceState({},""),window.addEventListener("click",l=>{if(l.defaultPrevented||!(l.target instanceof Element)||l.target.closest("button")||l.button!==0||l.ctrlKey||l.shiftKey||l.altKey||l.metaKey)return;const c=l.target.closest("a");if(!c||c.closest(".vp-raw")||c.hasAttribute("download")||c.hasAttribute("target"))return;const f=c.getAttribute("href")??(c instanceof SVGAElement?c.getAttribute("xlink:href"):null);if(f==null)return;const{href:a,origin:h,pathname:y,hash:v,search:S}=new URL(f,c.baseURI),_=new URL(location.href);h===_.origin&&tf(y)&&(l.preventDefault(),y===_.pathname&&S===_.search?(v!==_.hash&&(history.pushState({},"",a),window.dispatchEvent(new HashChangeEvent("hashchange",{oldURL:_.href,newURL:a}))),v?si(c,v,c.classList.contains("header-anchor")):window.scrollTo(0,0)):r(a))},{capture:!0}),window.addEventListener("popstate",async l=>{var c;l.state!==null&&(await o(gs(location.href),l.state&&l.state.scrollPosition||0),(c=s.onAfterRouteChanged)==null||c.call(s,location.href))}),window.addEventListener("hashchange",l=>{l.preventDefault()})),s}function ff(){const e=Ot(cf);if(!e)throw new Error("useRouter() is called without provider.");return e}function Uo(){return ff().route}function si(e,t,n=!1){let s=null;try{s=e.classList.contains("header-anchor")?e:document.getElementById(decodeURIComponent(t).slice(1))}catch(r){console.warn(r)}if(s){let r=function(){!n||Math.abs(o-window.scrollY)>window.innerHeight?window.scrollTo(0,o):window.scrollTo({left:0,top:o,behavior:"smooth"})};const i=parseInt(window.getComputedStyle(s).paddingTop,10),o=window.scrollY+s.getBoundingClientRect().top-lf()+i;requestAnimationFrame(r)}}function gs(e){const t=new URL(e,Vo);return t.pathname=t.pathname.replace(/(^|\/)index(\.html)?$/,"$1"),mt.value.cleanUrls?t.pathname=t.pathname.replace(/\.html$/,""):!t.pathname.endsWith("/")&&!t.pathname.endsWith(".html")&&(t.pathname+=".html"),t.pathname+t.search+t.hash}const yn=()=>Tn.forEach(e=>e()),Qf=Ys({name:"VitePressContent",props:{as:{type:[Object,String],default:"div"}},setup(e){const t=Uo(),{frontmatter:n,site:s}=sf();return Fe(n,yn,{deep:!0,flush:"post"}),()=>Ls(e.as,s.value.contentProps??{style:{position:"relative"}},[t.component?Ls(t.component,{onVnodeMounted:yn,onVnodeUpdated:yn,onVnodeUnmounted:yn}):"404 Page Not Found"])}}),uf="modulepreload",df=function(e){return"/GeometryOps.jl/previews/PR237/"+e},ri={},Zf=function(t,n,s){let r=Promise.resolve();if(n&&n.length>0){document.getElementsByTagName("link");const o=document.querySelector("meta[property=csp-nonce]"),l=(o==null?void 0:o.nonce)||(o==null?void 0:o.getAttribute("nonce"));r=Promise.allSettled(n.map(c=>{if(c=df(c),c in ri)return;ri[c]=!0;const f=c.endsWith(".css"),a=f?'[rel="stylesheet"]':"";if(document.querySelector(`link[href="${c}"]${a}`))return;const h=document.createElement("link");if(h.rel=f?"stylesheet":uf,f||(h.as="script"),h.crossOrigin="",h.href=c,l&&h.setAttribute("nonce",l),document.head.appendChild(h),f)return new Promise((y,v)=>{h.addEventListener("load",y),h.addEventListener("error",()=>v(new Error(`Unable to preload CSS for ${c}`)))})}))}function i(o){const l=new Event("vite:preloadError",{cancelable:!0});if(l.payload=o,window.dispatchEvent(l),!l.defaultPrevented)throw o}return r.then(o=>{for(const l of o||[])l.status==="rejected"&&i(l.reason);return t().catch(i)})},eu=Ys({setup(e,{slots:t}){const n=oe(!1);return Lt(()=>{n.value=!0}),()=>n.value&&t.default?t.default():null}});function tu(){ge&&window.addEventListener("click",e=>{var n;const t=e.target;if(t.matches(".vp-code-group input")){const s=(n=t.parentElement)==null?void 0:n.parentElement;if(!s)return;const r=Array.from(s.querySelectorAll("input")).indexOf(t);if(r<0)return;const i=s.querySelector(".blocks");if(!i)return;const o=Array.from(i.children).find(f=>f.classList.contains("active"));if(!o)return;const l=i.children[r];if(!l||o===l)return;o.classList.remove("active"),l.classList.add("active");const c=s==null?void 0:s.querySelector(`label[for="${t.id}"]`);c==null||c.scrollIntoView({block:"nearest"})}})}function nu(){if(ge){const e=new WeakMap;window.addEventListener("click",t=>{var s;const n=t.target;if(n.matches('div[class*="language-"] > button.copy')){const r=n.parentElement,i=(s=n.nextElementSibling)==null?void 0:s.nextElementSibling;if(!r||!i)return;const o=/language-(shellscript|shell|bash|sh|zsh)/.test(r.className),l=[".vp-copy-ignore",".diff.remove"],c=i.cloneNode(!0);c.querySelectorAll(l.join(",")).forEach(a=>a.remove());let f=c.textContent||"";o&&(f=f.replace(/^ *(\$|>) /gm,"").trim()),hf(f).then(()=>{n.classList.add("copied"),clearTimeout(e.get(n));const a=setTimeout(()=>{n.classList.remove("copied"),n.blur(),e.delete(n)},2e3);e.set(n,a)})}})}}async function hf(e){try{return navigator.clipboard.writeText(e)}catch{const t=document.createElement("textarea"),n=document.activeElement;t.value=e,t.setAttribute("readonly",""),t.style.contain="strict",t.style.position="absolute",t.style.left="-9999px",t.style.fontSize="12pt";const s=document.getSelection(),r=s?s.rangeCount>0&&s.getRangeAt(0):null;document.body.appendChild(t),t.select(),t.selectionStart=0,t.selectionEnd=e.length,document.execCommand("copy"),document.body.removeChild(t),r&&(s.removeAllRanges(),s.addRange(r)),n&&n.focus()}}function su(e,t){let n=!0,s=[];const r=i=>{if(n){n=!1,i.forEach(l=>{const c=ms(l);for(const f of document.head.children)if(f.isEqualNode(c)){s.push(f);return}});return}const o=i.map(ms);s.forEach((l,c)=>{const f=o.findIndex(a=>a==null?void 0:a.isEqualNode(l??null));f!==-1?delete o[f]:(l==null||l.remove(),delete s[c])}),o.forEach(l=>l&&document.head.appendChild(l)),s=[...s,...o].filter(Boolean)};Zs(()=>{const i=e.data,o=t.value,l=i&&i.description,c=i&&i.frontmatter.head||[],f=Do(o,i);f!==document.title&&(document.title=f);const a=l||o.description;let h=document.querySelector("meta[name=description]");h?h.getAttribute("content")!==a&&h.setAttribute("content",a):ms(["meta",{name:"description",content:a}]),r(jo(o.head,gf(c)))})}function ms([e,t,n]){const s=document.createElement(e);for(const r in t)s.setAttribute(r,t[r]);return n&&(s.innerHTML=n),e==="script"&&t.async==null&&(s.async=!1),s}function pf(e){return e[0]==="meta"&&e[1]&&e[1].name==="description"}function gf(e){return e.filter(t=>!pf(t))}const ys=new Set,ko=()=>document.createElement("link"),mf=e=>{const t=ko();t.rel="prefetch",t.href=e,document.head.appendChild(t)},yf=e=>{const t=new XMLHttpRequest;t.open("GET",e,t.withCredentials=!0),t.send()};let vn;const vf=ge&&(vn=ko())&&vn.relList&&vn.relList.supports&&vn.relList.supports("prefetch")?mf:yf;function ru(){if(!ge||!window.IntersectionObserver)return;let e;if((e=navigator.connection)&&(e.saveData||/2g/.test(e.effectiveType)))return;const t=window.requestIdleCallback||setTimeout;let n=null;const s=()=>{n&&n.disconnect(),n=new IntersectionObserver(i=>{i.forEach(o=>{if(o.isIntersecting){const l=o.target;n.unobserve(l);const{pathname:c}=l;if(!ys.has(c)){ys.add(c);const f=of(c);f&&vf(f)}}})}),t(()=>{document.querySelectorAll("#app a").forEach(i=>{const{hostname:o,pathname:l}=new URL(i.href instanceof SVGAnimatedString?i.href.animVal:i.href,i.baseURI),c=l.match(/\.\w+$/);c&&c[0]!==".html"||i.target!=="_blank"&&o===location.hostname&&(l!==location.pathname?n.observe(i):ys.add(l))})})};Lt(s);const r=Uo();Fe(()=>r.path,s),Bn(()=>{n&&n.disconnect()})}export{Ki as $,lf as A,Sf as B,Ef as C,qs as D,Jf as E,xe as F,ce as G,xf as H,Ho as I,Uo as J,$c as K,Ot as L,Gf as M,Ds as N,kf as O,Un as P,qf as Q,ge as R,Vn as S,Lf as T,wf as U,Zf as V,Wf as W,mc as X,Ff as Y,Cf as Z,Df as _,_o as a,Nf as a0,Af as a1,jn as a2,Ll as a3,Ls as a4,Mf as a5,su as a6,cf as a7,Xf as a8,nf as a9,Qf as aa,eu as ab,mt as ac,$f as ad,zf as ae,of as af,ru as ag,nu as ah,tu as ai,Be as aj,Lo as ak,jf as al,tr as am,Uf as an,Kf as ao,Bf as ap,Vf as aq,ff as ar,Pt as as,_f as at,If as au,fe as av,bf as aw,wn as ax,Hf as ay,Yf as az,Ms as b,Of as c,Ys as d,Pf as e,tf as f,ti as g,ie as h,Ya as i,vo as j,Oi as k,Ga as l,Io as m,js as n,Os as o,oe as p,Fe as q,Tf as r,Zs as s,sl as t,sf as u,Lt as v,Ul as w,Bn as x,Rf as y,nc as z}; diff --git a/previews/PR237/assets/chunks/theme.BVJ9-_aP.js b/previews/PR237/assets/chunks/theme.BVJ9-_aP.js new file mode 100644 index 000000000..8879d9c20 --- /dev/null +++ b/previews/PR237/assets/chunks/theme.BVJ9-_aP.js @@ -0,0 +1,2 @@ +const __vite__mapDeps=(i,m=__vite__mapDeps,d=(m.f||(m.f=["assets/chunks/VPLocalSearchBox.dF_ipd1x.js","assets/chunks/framework.Cq8AuEls.js"])))=>i.map(i=>d[i]); +import{d as m,o as a,c as u,r as c,n as I,a as z,t as w,b as g,w as f,e as h,T as de,_ as $,u as Ge,i as je,f as ze,g as pe,h as y,j as v,k as i,l as K,m as re,p as T,q as F,s as Z,v as O,x as ve,y as fe,z as Ke,A as Re,B as R,F as M,C as H,D as Ve,E as x,G as k,H as E,I as Te,J as ee,K as j,L as q,M as We,N as Ne,O as ie,P as he,Q as we,R as te,S as qe,U as Je,V as Ye,W as Ie,X as me,Y as Xe,Z as Qe,$ as Ze,a0 as xe,a1 as Me,a2 as et,a3 as tt,a4 as nt}from"./framework.Cq8AuEls.js";const st=m({__name:"VPBadge",props:{text:{},type:{default:"tip"}},setup(o){return(e,t)=>(a(),u("span",{class:I(["VPBadge",e.type])},[c(e.$slots,"default",{},()=>[z(w(e.text),1)])],2))}}),ot={key:0,class:"VPBackdrop"},at=m({__name:"VPBackdrop",props:{show:{type:Boolean}},setup(o){return(e,t)=>(a(),g(de,{name:"fade"},{default:f(()=>[e.show?(a(),u("div",ot)):h("",!0)]),_:1}))}}),rt=$(at,[["__scopeId","data-v-b06cdb19"]]),V=Ge;function it(o,e){let t,s=!1;return()=>{t&&clearTimeout(t),s?t=setTimeout(o,e):(o(),(s=!0)&&setTimeout(()=>s=!1,e))}}function le(o){return/^\//.test(o)?o:`/${o}`}function _e(o){const{pathname:e,search:t,hash:s,protocol:n}=new URL(o,"http://a.com");if(je(o)||o.startsWith("#")||!n.startsWith("http")||!ze(e))return o;const{site:r}=V(),l=e.endsWith("/")||e.endsWith(".html")?o:o.replace(/(?:(^\.+)\/)?.*$/,`$1${e.replace(/(\.md)?$/,r.value.cleanUrls?"":".html")}${t}${s}`);return pe(l)}function Y({correspondingLink:o=!1}={}){const{site:e,localeIndex:t,page:s,theme:n,hash:r}=V(),l=y(()=>{var p,b;return{label:(p=e.value.locales[t.value])==null?void 0:p.label,link:((b=e.value.locales[t.value])==null?void 0:b.link)||(t.value==="root"?"/":`/${t.value}/`)}});return{localeLinks:y(()=>Object.entries(e.value.locales).flatMap(([p,b])=>l.value.label===b.label?[]:{text:b.label,link:lt(b.link||(p==="root"?"/":`/${p}/`),n.value.i18nRouting!==!1&&o,s.value.relativePath.slice(l.value.link.length-1),!e.value.cleanUrls)+r.value})),currentLang:l}}function lt(o,e,t,s){return e?o.replace(/\/$/,"")+le(t.replace(/(^|\/)index\.md$/,"$1").replace(/\.md$/,s?".html":"")):o}const ct={class:"NotFound"},ut={class:"code"},dt={class:"title"},pt={class:"quote"},vt={class:"action"},ft=["href","aria-label"],ht=m({__name:"NotFound",setup(o){const{theme:e}=V(),{currentLang:t}=Y();return(s,n)=>{var r,l,d,p,b;return a(),u("div",ct,[v("p",ut,w(((r=i(e).notFound)==null?void 0:r.code)??"404"),1),v("h1",dt,w(((l=i(e).notFound)==null?void 0:l.title)??"PAGE NOT FOUND"),1),n[0]||(n[0]=v("div",{class:"divider"},null,-1)),v("blockquote",pt,w(((d=i(e).notFound)==null?void 0:d.quote)??"But if you don't change your direction, and if you keep looking, you may end up where you are heading."),1),v("div",vt,[v("a",{class:"link",href:i(pe)(i(t).link),"aria-label":((p=i(e).notFound)==null?void 0:p.linkLabel)??"go to home"},w(((b=i(e).notFound)==null?void 0:b.linkText)??"Take me home"),9,ft)])])}}}),mt=$(ht,[["__scopeId","data-v-951cab6c"]]);function Ae(o,e){if(Array.isArray(o))return X(o);if(o==null)return[];e=le(e);const t=Object.keys(o).sort((n,r)=>r.split("/").length-n.split("/").length).find(n=>e.startsWith(le(n))),s=t?o[t]:[];return Array.isArray(s)?X(s):X(s.items,s.base)}function _t(o){const e=[];let t=0;for(const s in o){const n=o[s];if(n.items){t=e.push(n);continue}e[t]||e.push({items:[]}),e[t].items.push(n)}return e}function bt(o){const e=[];function t(s){for(const n of s)n.text&&n.link&&e.push({text:n.text,link:n.link,docFooterText:n.docFooterText}),n.items&&t(n.items)}return t(o),e}function ce(o,e){return Array.isArray(e)?e.some(t=>ce(o,t)):K(o,e.link)?!0:e.items?ce(o,e.items):!1}function X(o,e){return[...o].map(t=>{const s={...t},n=s.base||e;return n&&s.link&&(s.link=n+s.link),s.items&&(s.items=X(s.items,n)),s})}function U(){const{frontmatter:o,page:e,theme:t}=V(),s=re("(min-width: 960px)"),n=T(!1),r=y(()=>{const C=t.value.sidebar,N=e.value.relativePath;return C?Ae(C,N):[]}),l=T(r.value);F(r,(C,N)=>{JSON.stringify(C)!==JSON.stringify(N)&&(l.value=r.value)});const d=y(()=>o.value.sidebar!==!1&&l.value.length>0&&o.value.layout!=="home"),p=y(()=>b?o.value.aside==null?t.value.aside==="left":o.value.aside==="left":!1),b=y(()=>o.value.layout==="home"?!1:o.value.aside!=null?!!o.value.aside:t.value.aside!==!1),L=y(()=>d.value&&s.value),_=y(()=>d.value?_t(l.value):[]);function P(){n.value=!0}function S(){n.value=!1}function A(){n.value?S():P()}return{isOpen:n,sidebar:l,sidebarGroups:_,hasSidebar:d,hasAside:b,leftAside:p,isSidebarEnabled:L,open:P,close:S,toggle:A}}function kt(o,e){let t;Z(()=>{t=o.value?document.activeElement:void 0}),O(()=>{window.addEventListener("keyup",s)}),ve(()=>{window.removeEventListener("keyup",s)});function s(n){n.key==="Escape"&&o.value&&(e(),t==null||t.focus())}}function gt(o){const{page:e,hash:t}=V(),s=T(!1),n=y(()=>o.value.collapsed!=null),r=y(()=>!!o.value.link),l=T(!1),d=()=>{l.value=K(e.value.relativePath,o.value.link)};F([e,o,t],d),O(d);const p=y(()=>l.value?!0:o.value.items?ce(e.value.relativePath,o.value.items):!1),b=y(()=>!!(o.value.items&&o.value.items.length));Z(()=>{s.value=!!(n.value&&o.value.collapsed)}),fe(()=>{(l.value||p.value)&&(s.value=!1)});function L(){n.value&&(s.value=!s.value)}return{collapsed:s,collapsible:n,isLink:r,isActiveLink:l,hasActiveLink:p,hasChildren:b,toggle:L}}function $t(){const{hasSidebar:o}=U(),e=re("(min-width: 960px)"),t=re("(min-width: 1280px)");return{isAsideEnabled:y(()=>!t.value&&!e.value?!1:o.value?t.value:e.value)}}const ue=[];function Ce(o){return typeof o.outline=="object"&&!Array.isArray(o.outline)&&o.outline.label||o.outlineTitle||"On this page"}function be(o){const e=[...document.querySelectorAll(".VPDoc :where(h1,h2,h3,h4,h5,h6)")].filter(t=>t.id&&t.hasChildNodes()).map(t=>{const s=Number(t.tagName[1]);return{element:t,title:yt(t),link:"#"+t.id,level:s}});return Pt(e,o)}function yt(o){let e="";for(const t of o.childNodes)if(t.nodeType===1){if(t.classList.contains("VPBadge")||t.classList.contains("header-anchor")||t.classList.contains("ignore-header"))continue;e+=t.textContent}else t.nodeType===3&&(e+=t.textContent);return e.trim()}function Pt(o,e){if(e===!1)return[];const t=(typeof e=="object"&&!Array.isArray(e)?e.level:e)||2,[s,n]=typeof t=="number"?[t,t]:t==="deep"?[2,6]:t;return Vt(o,s,n)}function St(o,e){const{isAsideEnabled:t}=$t(),s=it(r,100);let n=null;O(()=>{requestAnimationFrame(r),window.addEventListener("scroll",s)}),Ke(()=>{l(location.hash)}),ve(()=>{window.removeEventListener("scroll",s)});function r(){if(!t.value)return;const d=window.scrollY,p=window.innerHeight,b=document.body.offsetHeight,L=Math.abs(d+p-b)<1,_=ue.map(({element:S,link:A})=>({link:A,top:Lt(S)})).filter(({top:S})=>!Number.isNaN(S)).sort((S,A)=>S.top-A.top);if(!_.length){l(null);return}if(d<1){l(null);return}if(L){l(_[_.length-1].link);return}let P=null;for(const{link:S,top:A}of _){if(A>d+Re()+4)break;P=S}l(P)}function l(d){n&&n.classList.remove("active"),d==null?n=null:n=o.value.querySelector(`a[href="${decodeURIComponent(d)}"]`);const p=n;p?(p.classList.add("active"),e.value.style.top=p.offsetTop+39+"px",e.value.style.opacity="1"):(e.value.style.top="33px",e.value.style.opacity="0")}}function Lt(o){let e=0;for(;o!==document.body;){if(o===null)return NaN;e+=o.offsetTop,o=o.offsetParent}return e}function Vt(o,e,t){ue.length=0;const s=[],n=[];return o.forEach(r=>{const l={...r,children:[]};let d=n[n.length-1];for(;d&&d.level>=l.level;)n.pop(),d=n[n.length-1];if(l.element.classList.contains("ignore-header")||d&&"shouldIgnore"in d){n.push({level:l.level,shouldIgnore:!0});return}l.level>t||l.level{const n=R("VPDocOutlineItem",!0);return a(),u("ul",{class:I(["VPDocOutlineItem",t.root?"root":"nested"])},[(a(!0),u(M,null,H(t.headers,({children:r,link:l,title:d})=>(a(),u("li",null,[v("a",{class:"outline-link",href:l,onClick:e,title:d},w(d),9,Tt),r!=null&&r.length?(a(),g(n,{key:0,headers:r},null,8,["headers"])):h("",!0)]))),256))],2)}}}),He=$(Nt,[["__scopeId","data-v-3f927ebe"]]),wt={class:"content"},It={"aria-level":"2",class:"outline-title",id:"doc-outline-aria-label",role:"heading"},Mt=m({__name:"VPDocAsideOutline",setup(o){const{frontmatter:e,theme:t}=V(),s=Ve([]);x(()=>{s.value=be(e.value.outline??t.value.outline)});const n=T(),r=T();return St(n,r),(l,d)=>(a(),u("nav",{"aria-labelledby":"doc-outline-aria-label",class:I(["VPDocAsideOutline",{"has-outline":s.value.length>0}]),ref_key:"container",ref:n},[v("div",wt,[v("div",{class:"outline-marker",ref_key:"marker",ref:r},null,512),v("div",It,w(i(Ce)(i(t))),1),k(He,{headers:s.value,root:!0},null,8,["headers"])])],2))}}),At=$(Mt,[["__scopeId","data-v-b38bf2ff"]]),Ct={class:"VPDocAsideCarbonAds"},Ht=m({__name:"VPDocAsideCarbonAds",props:{carbonAds:{}},setup(o){const e=()=>null;return(t,s)=>(a(),u("div",Ct,[k(i(e),{"carbon-ads":t.carbonAds},null,8,["carbon-ads"])]))}}),Bt={class:"VPDocAside"},Et=m({__name:"VPDocAside",setup(o){const{theme:e}=V();return(t,s)=>(a(),u("div",Bt,[c(t.$slots,"aside-top",{},void 0,!0),c(t.$slots,"aside-outline-before",{},void 0,!0),k(At),c(t.$slots,"aside-outline-after",{},void 0,!0),s[0]||(s[0]=v("div",{class:"spacer"},null,-1)),c(t.$slots,"aside-ads-before",{},void 0,!0),i(e).carbonAds?(a(),g(Ht,{key:0,"carbon-ads":i(e).carbonAds},null,8,["carbon-ads"])):h("",!0),c(t.$slots,"aside-ads-after",{},void 0,!0),c(t.$slots,"aside-bottom",{},void 0,!0)]))}}),Dt=$(Et,[["__scopeId","data-v-6d7b3c46"]]);function Ft(){const{theme:o,page:e}=V();return y(()=>{const{text:t="Edit this page",pattern:s=""}=o.value.editLink||{};let n;return typeof s=="function"?n=s(e.value):n=s.replace(/:path/g,e.value.filePath),{url:n,text:t}})}function Ot(){const{page:o,theme:e,frontmatter:t}=V();return y(()=>{var b,L,_,P,S,A,C,N;const s=Ae(e.value.sidebar,o.value.relativePath),n=bt(s),r=Ut(n,B=>B.link.replace(/[?#].*$/,"")),l=r.findIndex(B=>K(o.value.relativePath,B.link)),d=((b=e.value.docFooter)==null?void 0:b.prev)===!1&&!t.value.prev||t.value.prev===!1,p=((L=e.value.docFooter)==null?void 0:L.next)===!1&&!t.value.next||t.value.next===!1;return{prev:d?void 0:{text:(typeof t.value.prev=="string"?t.value.prev:typeof t.value.prev=="object"?t.value.prev.text:void 0)??((_=r[l-1])==null?void 0:_.docFooterText)??((P=r[l-1])==null?void 0:P.text),link:(typeof t.value.prev=="object"?t.value.prev.link:void 0)??((S=r[l-1])==null?void 0:S.link)},next:p?void 0:{text:(typeof t.value.next=="string"?t.value.next:typeof t.value.next=="object"?t.value.next.text:void 0)??((A=r[l+1])==null?void 0:A.docFooterText)??((C=r[l+1])==null?void 0:C.text),link:(typeof t.value.next=="object"?t.value.next.link:void 0)??((N=r[l+1])==null?void 0:N.link)}}})}function Ut(o,e){const t=new Set;return o.filter(s=>{const n=e(s);return t.has(n)?!1:t.add(n)})}const D=m({__name:"VPLink",props:{tag:{},href:{},noIcon:{type:Boolean},target:{},rel:{}},setup(o){const e=o,t=y(()=>e.tag??(e.href?"a":"span")),s=y(()=>e.href&&Te.test(e.href)||e.target==="_blank");return(n,r)=>(a(),g(E(t.value),{class:I(["VPLink",{link:n.href,"vp-external-link-icon":s.value,"no-icon":n.noIcon}]),href:n.href?i(_e)(n.href):void 0,target:n.target??(s.value?"_blank":void 0),rel:n.rel??(s.value?"noreferrer":void 0)},{default:f(()=>[c(n.$slots,"default")]),_:3},8,["class","href","target","rel"]))}}),Gt={class:"VPLastUpdated"},jt=["datetime"],zt=m({__name:"VPDocFooterLastUpdated",setup(o){const{theme:e,page:t,lang:s}=V(),n=y(()=>new Date(t.value.lastUpdated)),r=y(()=>n.value.toISOString()),l=T("");return O(()=>{Z(()=>{var d,p,b;l.value=new Intl.DateTimeFormat((p=(d=e.value.lastUpdated)==null?void 0:d.formatOptions)!=null&&p.forceLocale?s.value:void 0,((b=e.value.lastUpdated)==null?void 0:b.formatOptions)??{dateStyle:"short",timeStyle:"short"}).format(n.value)})}),(d,p)=>{var b;return a(),u("p",Gt,[z(w(((b=i(e).lastUpdated)==null?void 0:b.text)||i(e).lastUpdatedText||"Last updated")+": ",1),v("time",{datetime:r.value},w(l.value),9,jt)])}}}),Kt=$(zt,[["__scopeId","data-v-475f71b8"]]),Rt={key:0,class:"VPDocFooter"},Wt={key:0,class:"edit-info"},qt={key:0,class:"edit-link"},Jt={key:1,class:"last-updated"},Yt={key:1,class:"prev-next","aria-labelledby":"doc-footer-aria-label"},Xt={class:"pager"},Qt=["innerHTML"],Zt=["innerHTML"],xt={class:"pager"},en=["innerHTML"],tn=["innerHTML"],nn=m({__name:"VPDocFooter",setup(o){const{theme:e,page:t,frontmatter:s}=V(),n=Ft(),r=Ot(),l=y(()=>e.value.editLink&&s.value.editLink!==!1),d=y(()=>t.value.lastUpdated),p=y(()=>l.value||d.value||r.value.prev||r.value.next);return(b,L)=>{var _,P,S,A;return p.value?(a(),u("footer",Rt,[c(b.$slots,"doc-footer-before",{},void 0,!0),l.value||d.value?(a(),u("div",Wt,[l.value?(a(),u("div",qt,[k(D,{class:"edit-link-button",href:i(n).url,"no-icon":!0},{default:f(()=>[L[0]||(L[0]=v("span",{class:"vpi-square-pen edit-link-icon"},null,-1)),z(" "+w(i(n).text),1)]),_:1},8,["href"])])):h("",!0),d.value?(a(),u("div",Jt,[k(Kt)])):h("",!0)])):h("",!0),(_=i(r).prev)!=null&&_.link||(P=i(r).next)!=null&&P.link?(a(),u("nav",Yt,[L[1]||(L[1]=v("span",{class:"visually-hidden",id:"doc-footer-aria-label"},"Pager",-1)),v("div",Xt,[(S=i(r).prev)!=null&&S.link?(a(),g(D,{key:0,class:"pager-link prev",href:i(r).prev.link},{default:f(()=>{var C;return[v("span",{class:"desc",innerHTML:((C=i(e).docFooter)==null?void 0:C.prev)||"Previous page"},null,8,Qt),v("span",{class:"title",innerHTML:i(r).prev.text},null,8,Zt)]}),_:1},8,["href"])):h("",!0)]),v("div",xt,[(A=i(r).next)!=null&&A.link?(a(),g(D,{key:0,class:"pager-link next",href:i(r).next.link},{default:f(()=>{var C;return[v("span",{class:"desc",innerHTML:((C=i(e).docFooter)==null?void 0:C.next)||"Next page"},null,8,en),v("span",{class:"title",innerHTML:i(r).next.text},null,8,tn)]}),_:1},8,["href"])):h("",!0)])])):h("",!0)])):h("",!0)}}}),sn=$(nn,[["__scopeId","data-v-4f9813fa"]]),on={class:"container"},an={class:"aside-container"},rn={class:"aside-content"},ln={class:"content"},cn={class:"content-container"},un={class:"main"},dn=m({__name:"VPDoc",setup(o){const{theme:e}=V(),t=ee(),{hasSidebar:s,hasAside:n,leftAside:r}=U(),l=y(()=>t.path.replace(/[./]+/g,"_").replace(/_html$/,""));return(d,p)=>{const b=R("Content");return a(),u("div",{class:I(["VPDoc",{"has-sidebar":i(s),"has-aside":i(n)}])},[c(d.$slots,"doc-top",{},void 0,!0),v("div",on,[i(n)?(a(),u("div",{key:0,class:I(["aside",{"left-aside":i(r)}])},[p[0]||(p[0]=v("div",{class:"aside-curtain"},null,-1)),v("div",an,[v("div",rn,[k(Dt,null,{"aside-top":f(()=>[c(d.$slots,"aside-top",{},void 0,!0)]),"aside-bottom":f(()=>[c(d.$slots,"aside-bottom",{},void 0,!0)]),"aside-outline-before":f(()=>[c(d.$slots,"aside-outline-before",{},void 0,!0)]),"aside-outline-after":f(()=>[c(d.$slots,"aside-outline-after",{},void 0,!0)]),"aside-ads-before":f(()=>[c(d.$slots,"aside-ads-before",{},void 0,!0)]),"aside-ads-after":f(()=>[c(d.$slots,"aside-ads-after",{},void 0,!0)]),_:3})])])],2)):h("",!0),v("div",ln,[v("div",cn,[c(d.$slots,"doc-before",{},void 0,!0),v("main",un,[k(b,{class:I(["vp-doc",[l.value,i(e).externalLinkIcon&&"external-link-icon-enabled"]])},null,8,["class"])]),k(sn,null,{"doc-footer-before":f(()=>[c(d.$slots,"doc-footer-before",{},void 0,!0)]),_:3}),c(d.$slots,"doc-after",{},void 0,!0)])])]),c(d.$slots,"doc-bottom",{},void 0,!0)],2)}}}),pn=$(dn,[["__scopeId","data-v-83890dd9"]]),vn=m({__name:"VPButton",props:{tag:{},size:{default:"medium"},theme:{default:"brand"},text:{},href:{},target:{},rel:{}},setup(o){const e=o,t=y(()=>e.href&&Te.test(e.href)),s=y(()=>e.tag||(e.href?"a":"button"));return(n,r)=>(a(),g(E(s.value),{class:I(["VPButton",[n.size,n.theme]]),href:n.href?i(_e)(n.href):void 0,target:e.target??(t.value?"_blank":void 0),rel:e.rel??(t.value?"noreferrer":void 0)},{default:f(()=>[z(w(n.text),1)]),_:1},8,["class","href","target","rel"]))}}),fn=$(vn,[["__scopeId","data-v-906d7fb4"]]),hn=["src","alt"],mn=m({inheritAttrs:!1,__name:"VPImage",props:{image:{},alt:{}},setup(o){return(e,t)=>{const s=R("VPImage",!0);return e.image?(a(),u(M,{key:0},[typeof e.image=="string"||"src"in e.image?(a(),u("img",j({key:0,class:"VPImage"},typeof e.image=="string"?e.$attrs:{...e.image,...e.$attrs},{src:i(pe)(typeof e.image=="string"?e.image:e.image.src),alt:e.alt??(typeof e.image=="string"?"":e.image.alt||"")}),null,16,hn)):(a(),u(M,{key:1},[k(s,j({class:"dark",image:e.image.dark,alt:e.image.alt},e.$attrs),null,16,["image","alt"]),k(s,j({class:"light",image:e.image.light,alt:e.image.alt},e.$attrs),null,16,["image","alt"])],64))],64)):h("",!0)}}}),Q=$(mn,[["__scopeId","data-v-35a7d0b8"]]),_n={class:"container"},bn={class:"main"},kn={key:0,class:"name"},gn=["innerHTML"],$n=["innerHTML"],yn=["innerHTML"],Pn={key:0,class:"actions"},Sn={key:0,class:"image"},Ln={class:"image-container"},Vn=m({__name:"VPHero",props:{name:{},text:{},tagline:{},image:{},actions:{}},setup(o){const e=q("hero-image-slot-exists");return(t,s)=>(a(),u("div",{class:I(["VPHero",{"has-image":t.image||i(e)}])},[v("div",_n,[v("div",bn,[c(t.$slots,"home-hero-info-before",{},void 0,!0),c(t.$slots,"home-hero-info",{},()=>[t.name?(a(),u("h1",kn,[v("span",{innerHTML:t.name,class:"clip"},null,8,gn)])):h("",!0),t.text?(a(),u("p",{key:1,innerHTML:t.text,class:"text"},null,8,$n)):h("",!0),t.tagline?(a(),u("p",{key:2,innerHTML:t.tagline,class:"tagline"},null,8,yn)):h("",!0)],!0),c(t.$slots,"home-hero-info-after",{},void 0,!0),t.actions?(a(),u("div",Pn,[(a(!0),u(M,null,H(t.actions,n=>(a(),u("div",{key:n.link,class:"action"},[k(fn,{tag:"a",size:"medium",theme:n.theme,text:n.text,href:n.link,target:n.target,rel:n.rel},null,8,["theme","text","href","target","rel"])]))),128))])):h("",!0),c(t.$slots,"home-hero-actions-after",{},void 0,!0)]),t.image||i(e)?(a(),u("div",Sn,[v("div",Ln,[s[0]||(s[0]=v("div",{class:"image-bg"},null,-1)),c(t.$slots,"home-hero-image",{},()=>[t.image?(a(),g(Q,{key:0,class:"image-src",image:t.image},null,8,["image"])):h("",!0)],!0)])])):h("",!0)])],2))}}),Tn=$(Vn,[["__scopeId","data-v-955009fc"]]),Nn=m({__name:"VPHomeHero",setup(o){const{frontmatter:e}=V();return(t,s)=>i(e).hero?(a(),g(Tn,{key:0,class:"VPHomeHero",name:i(e).hero.name,text:i(e).hero.text,tagline:i(e).hero.tagline,image:i(e).hero.image,actions:i(e).hero.actions},{"home-hero-info-before":f(()=>[c(t.$slots,"home-hero-info-before")]),"home-hero-info":f(()=>[c(t.$slots,"home-hero-info")]),"home-hero-info-after":f(()=>[c(t.$slots,"home-hero-info-after")]),"home-hero-actions-after":f(()=>[c(t.$slots,"home-hero-actions-after")]),"home-hero-image":f(()=>[c(t.$slots,"home-hero-image")]),_:3},8,["name","text","tagline","image","actions"])):h("",!0)}}),wn={class:"box"},In={key:0,class:"icon"},Mn=["innerHTML"],An=["innerHTML"],Cn=["innerHTML"],Hn={key:4,class:"link-text"},Bn={class:"link-text-value"},En=m({__name:"VPFeature",props:{icon:{},title:{},details:{},link:{},linkText:{},rel:{},target:{}},setup(o){return(e,t)=>(a(),g(D,{class:"VPFeature",href:e.link,rel:e.rel,target:e.target,"no-icon":!0,tag:e.link?"a":"div"},{default:f(()=>[v("article",wn,[typeof e.icon=="object"&&e.icon.wrap?(a(),u("div",In,[k(Q,{image:e.icon,alt:e.icon.alt,height:e.icon.height||48,width:e.icon.width||48},null,8,["image","alt","height","width"])])):typeof e.icon=="object"?(a(),g(Q,{key:1,image:e.icon,alt:e.icon.alt,height:e.icon.height||48,width:e.icon.width||48},null,8,["image","alt","height","width"])):e.icon?(a(),u("div",{key:2,class:"icon",innerHTML:e.icon},null,8,Mn)):h("",!0),v("h2",{class:"title",innerHTML:e.title},null,8,An),e.details?(a(),u("p",{key:3,class:"details",innerHTML:e.details},null,8,Cn)):h("",!0),e.linkText?(a(),u("div",Hn,[v("p",Bn,[z(w(e.linkText)+" ",1),t[0]||(t[0]=v("span",{class:"vpi-arrow-right link-text-icon"},null,-1))])])):h("",!0)])]),_:1},8,["href","rel","target","tag"]))}}),Dn=$(En,[["__scopeId","data-v-f5e9645b"]]),Fn={key:0,class:"VPFeatures"},On={class:"container"},Un={class:"items"},Gn=m({__name:"VPFeatures",props:{features:{}},setup(o){const e=o,t=y(()=>{const s=e.features.length;if(s){if(s===2)return"grid-2";if(s===3)return"grid-3";if(s%3===0)return"grid-6";if(s>3)return"grid-4"}else return});return(s,n)=>s.features?(a(),u("div",Fn,[v("div",On,[v("div",Un,[(a(!0),u(M,null,H(s.features,r=>(a(),u("div",{key:r.title,class:I(["item",[t.value]])},[k(Dn,{icon:r.icon,title:r.title,details:r.details,link:r.link,"link-text":r.linkText,rel:r.rel,target:r.target},null,8,["icon","title","details","link","link-text","rel","target"])],2))),128))])])])):h("",!0)}}),jn=$(Gn,[["__scopeId","data-v-d0a190d7"]]),zn=m({__name:"VPHomeFeatures",setup(o){const{frontmatter:e}=V();return(t,s)=>i(e).features?(a(),g(jn,{key:0,class:"VPHomeFeatures",features:i(e).features},null,8,["features"])):h("",!0)}}),Kn=m({__name:"VPHomeContent",setup(o){const{width:e}=We({initialWidth:0,includeScrollbar:!1});return(t,s)=>(a(),u("div",{class:"vp-doc container",style:Ne(i(e)?{"--vp-offset":`calc(50% - ${i(e)/2}px)`}:{})},[c(t.$slots,"default",{},void 0,!0)],4))}}),Rn=$(Kn,[["__scopeId","data-v-7a48a447"]]),Wn={class:"VPHome"},qn=m({__name:"VPHome",setup(o){const{frontmatter:e}=V();return(t,s)=>{const n=R("Content");return a(),u("div",Wn,[c(t.$slots,"home-hero-before",{},void 0,!0),k(Nn,null,{"home-hero-info-before":f(()=>[c(t.$slots,"home-hero-info-before",{},void 0,!0)]),"home-hero-info":f(()=>[c(t.$slots,"home-hero-info",{},void 0,!0)]),"home-hero-info-after":f(()=>[c(t.$slots,"home-hero-info-after",{},void 0,!0)]),"home-hero-actions-after":f(()=>[c(t.$slots,"home-hero-actions-after",{},void 0,!0)]),"home-hero-image":f(()=>[c(t.$slots,"home-hero-image",{},void 0,!0)]),_:3}),c(t.$slots,"home-hero-after",{},void 0,!0),c(t.$slots,"home-features-before",{},void 0,!0),k(zn),c(t.$slots,"home-features-after",{},void 0,!0),i(e).markdownStyles!==!1?(a(),g(Rn,{key:0},{default:f(()=>[k(n)]),_:1})):(a(),g(n,{key:1}))])}}}),Jn=$(qn,[["__scopeId","data-v-cbb6ec48"]]),Yn={},Xn={class:"VPPage"};function Qn(o,e){const t=R("Content");return a(),u("div",Xn,[c(o.$slots,"page-top"),k(t),c(o.$slots,"page-bottom")])}const Zn=$(Yn,[["render",Qn]]),xn=m({__name:"VPContent",setup(o){const{page:e,frontmatter:t}=V(),{hasSidebar:s}=U();return(n,r)=>(a(),u("div",{class:I(["VPContent",{"has-sidebar":i(s),"is-home":i(t).layout==="home"}]),id:"VPContent"},[i(e).isNotFound?c(n.$slots,"not-found",{key:0},()=>[k(mt)],!0):i(t).layout==="page"?(a(),g(Zn,{key:1},{"page-top":f(()=>[c(n.$slots,"page-top",{},void 0,!0)]),"page-bottom":f(()=>[c(n.$slots,"page-bottom",{},void 0,!0)]),_:3})):i(t).layout==="home"?(a(),g(Jn,{key:2},{"home-hero-before":f(()=>[c(n.$slots,"home-hero-before",{},void 0,!0)]),"home-hero-info-before":f(()=>[c(n.$slots,"home-hero-info-before",{},void 0,!0)]),"home-hero-info":f(()=>[c(n.$slots,"home-hero-info",{},void 0,!0)]),"home-hero-info-after":f(()=>[c(n.$slots,"home-hero-info-after",{},void 0,!0)]),"home-hero-actions-after":f(()=>[c(n.$slots,"home-hero-actions-after",{},void 0,!0)]),"home-hero-image":f(()=>[c(n.$slots,"home-hero-image",{},void 0,!0)]),"home-hero-after":f(()=>[c(n.$slots,"home-hero-after",{},void 0,!0)]),"home-features-before":f(()=>[c(n.$slots,"home-features-before",{},void 0,!0)]),"home-features-after":f(()=>[c(n.$slots,"home-features-after",{},void 0,!0)]),_:3})):i(t).layout&&i(t).layout!=="doc"?(a(),g(E(i(t).layout),{key:3})):(a(),g(pn,{key:4},{"doc-top":f(()=>[c(n.$slots,"doc-top",{},void 0,!0)]),"doc-bottom":f(()=>[c(n.$slots,"doc-bottom",{},void 0,!0)]),"doc-footer-before":f(()=>[c(n.$slots,"doc-footer-before",{},void 0,!0)]),"doc-before":f(()=>[c(n.$slots,"doc-before",{},void 0,!0)]),"doc-after":f(()=>[c(n.$slots,"doc-after",{},void 0,!0)]),"aside-top":f(()=>[c(n.$slots,"aside-top",{},void 0,!0)]),"aside-outline-before":f(()=>[c(n.$slots,"aside-outline-before",{},void 0,!0)]),"aside-outline-after":f(()=>[c(n.$slots,"aside-outline-after",{},void 0,!0)]),"aside-ads-before":f(()=>[c(n.$slots,"aside-ads-before",{},void 0,!0)]),"aside-ads-after":f(()=>[c(n.$slots,"aside-ads-after",{},void 0,!0)]),"aside-bottom":f(()=>[c(n.$slots,"aside-bottom",{},void 0,!0)]),_:3}))],2))}}),es=$(xn,[["__scopeId","data-v-91765379"]]),ts={class:"container"},ns=["innerHTML"],ss=["innerHTML"],os=m({__name:"VPFooter",setup(o){const{theme:e,frontmatter:t}=V(),{hasSidebar:s}=U();return(n,r)=>i(e).footer&&i(t).footer!==!1?(a(),u("footer",{key:0,class:I(["VPFooter",{"has-sidebar":i(s)}])},[v("div",ts,[i(e).footer.message?(a(),u("p",{key:0,class:"message",innerHTML:i(e).footer.message},null,8,ns)):h("",!0),i(e).footer.copyright?(a(),u("p",{key:1,class:"copyright",innerHTML:i(e).footer.copyright},null,8,ss)):h("",!0)])],2)):h("",!0)}}),as=$(os,[["__scopeId","data-v-c970a860"]]);function rs(){const{theme:o,frontmatter:e}=V(),t=Ve([]),s=y(()=>t.value.length>0);return x(()=>{t.value=be(e.value.outline??o.value.outline)}),{headers:t,hasLocalNav:s}}const is={class:"menu-text"},ls={class:"header"},cs={class:"outline"},us=m({__name:"VPLocalNavOutlineDropdown",props:{headers:{},navHeight:{}},setup(o){const e=o,{theme:t}=V(),s=T(!1),n=T(0),r=T(),l=T();function d(_){var P;(P=r.value)!=null&&P.contains(_.target)||(s.value=!1)}F(s,_=>{if(_){document.addEventListener("click",d);return}document.removeEventListener("click",d)}),ie("Escape",()=>{s.value=!1}),x(()=>{s.value=!1});function p(){s.value=!s.value,n.value=window.innerHeight+Math.min(window.scrollY-e.navHeight,0)}function b(_){_.target.classList.contains("outline-link")&&(l.value&&(l.value.style.transition="none"),he(()=>{s.value=!1}))}function L(){s.value=!1,window.scrollTo({top:0,left:0,behavior:"smooth"})}return(_,P)=>(a(),u("div",{class:"VPLocalNavOutlineDropdown",style:Ne({"--vp-vh":n.value+"px"}),ref_key:"main",ref:r},[_.headers.length>0?(a(),u("button",{key:0,onClick:p,class:I({open:s.value})},[v("span",is,w(i(Ce)(i(t))),1),P[0]||(P[0]=v("span",{class:"vpi-chevron-right icon"},null,-1))],2)):(a(),u("button",{key:1,onClick:L},w(i(t).returnToTopLabel||"Return to top"),1)),k(de,{name:"flyout"},{default:f(()=>[s.value?(a(),u("div",{key:0,ref_key:"items",ref:l,class:"items",onClick:b},[v("div",ls,[v("a",{class:"top-link",href:"#",onClick:L},w(i(t).returnToTopLabel||"Return to top"),1)]),v("div",cs,[k(He,{headers:_.headers},null,8,["headers"])])],512)):h("",!0)]),_:1})],4))}}),ds=$(us,[["__scopeId","data-v-bc9dc845"]]),ps={class:"container"},vs=["aria-expanded"],fs={class:"menu-text"},hs=m({__name:"VPLocalNav",props:{open:{type:Boolean}},emits:["open-menu"],setup(o){const{theme:e,frontmatter:t}=V(),{hasSidebar:s}=U(),{headers:n}=rs(),{y:r}=we(),l=T(0);O(()=>{l.value=parseInt(getComputedStyle(document.documentElement).getPropertyValue("--vp-nav-height"))}),x(()=>{n.value=be(t.value.outline??e.value.outline)});const d=y(()=>n.value.length===0),p=y(()=>d.value&&!s.value),b=y(()=>({VPLocalNav:!0,"has-sidebar":s.value,empty:d.value,fixed:p.value}));return(L,_)=>i(t).layout!=="home"&&(!p.value||i(r)>=l.value)?(a(),u("div",{key:0,class:I(b.value)},[v("div",ps,[i(s)?(a(),u("button",{key:0,class:"menu","aria-expanded":L.open,"aria-controls":"VPSidebarNav",onClick:_[0]||(_[0]=P=>L.$emit("open-menu"))},[_[1]||(_[1]=v("span",{class:"vpi-align-left menu-icon"},null,-1)),v("span",fs,w(i(e).sidebarMenuLabel||"Menu"),1)],8,vs)):h("",!0),k(ds,{headers:i(n),navHeight:l.value},null,8,["headers","navHeight"])])],2)):h("",!0)}}),ms=$(hs,[["__scopeId","data-v-070ab83d"]]);function _s(){const o=T(!1);function e(){o.value=!0,window.addEventListener("resize",n)}function t(){o.value=!1,window.removeEventListener("resize",n)}function s(){o.value?t():e()}function n(){window.outerWidth>=768&&t()}const r=ee();return F(()=>r.path,t),{isScreenOpen:o,openScreen:e,closeScreen:t,toggleScreen:s}}const bs={},ks={class:"VPSwitch",type:"button",role:"switch"},gs={class:"check"},$s={key:0,class:"icon"};function ys(o,e){return a(),u("button",ks,[v("span",gs,[o.$slots.default?(a(),u("span",$s,[c(o.$slots,"default",{},void 0,!0)])):h("",!0)])])}const Ps=$(bs,[["render",ys],["__scopeId","data-v-4a1c76db"]]),Ss=m({__name:"VPSwitchAppearance",setup(o){const{isDark:e,theme:t}=V(),s=q("toggle-appearance",()=>{e.value=!e.value}),n=T("");return fe(()=>{n.value=e.value?t.value.lightModeSwitchTitle||"Switch to light theme":t.value.darkModeSwitchTitle||"Switch to dark theme"}),(r,l)=>(a(),g(Ps,{title:n.value,class:"VPSwitchAppearance","aria-checked":i(e),onClick:i(s)},{default:f(()=>l[0]||(l[0]=[v("span",{class:"vpi-sun sun"},null,-1),v("span",{class:"vpi-moon moon"},null,-1)])),_:1},8,["title","aria-checked","onClick"]))}}),ke=$(Ss,[["__scopeId","data-v-e40a8bb6"]]),Ls={key:0,class:"VPNavBarAppearance"},Vs=m({__name:"VPNavBarAppearance",setup(o){const{site:e}=V();return(t,s)=>i(e).appearance&&i(e).appearance!=="force-dark"&&i(e).appearance!=="force-auto"?(a(),u("div",Ls,[k(ke)])):h("",!0)}}),Ts=$(Vs,[["__scopeId","data-v-af096f4a"]]),ge=T();let Be=!1,ae=0;function Ns(o){const e=T(!1);if(te){!Be&&ws(),ae++;const t=F(ge,s=>{var n,r,l;s===o.el.value||(n=o.el.value)!=null&&n.contains(s)?(e.value=!0,(r=o.onFocus)==null||r.call(o)):(e.value=!1,(l=o.onBlur)==null||l.call(o))});ve(()=>{t(),ae--,ae||Is()})}return qe(e)}function ws(){document.addEventListener("focusin",Ee),Be=!0,ge.value=document.activeElement}function Is(){document.removeEventListener("focusin",Ee)}function Ee(){ge.value=document.activeElement}const Ms={class:"VPMenuLink"},As=["innerHTML"],Cs=m({__name:"VPMenuLink",props:{item:{}},setup(o){const{page:e}=V();return(t,s)=>(a(),u("div",Ms,[k(D,{class:I({active:i(K)(i(e).relativePath,t.item.activeMatch||t.item.link,!!t.item.activeMatch)}),href:t.item.link,target:t.item.target,rel:t.item.rel,"no-icon":t.item.noIcon},{default:f(()=>[v("span",{innerHTML:t.item.text},null,8,As)]),_:1},8,["class","href","target","rel","no-icon"])]))}}),ne=$(Cs,[["__scopeId","data-v-acbfed09"]]),Hs={class:"VPMenuGroup"},Bs={key:0,class:"title"},Es=m({__name:"VPMenuGroup",props:{text:{},items:{}},setup(o){return(e,t)=>(a(),u("div",Hs,[e.text?(a(),u("p",Bs,w(e.text),1)):h("",!0),(a(!0),u(M,null,H(e.items,s=>(a(),u(M,null,["link"in s?(a(),g(ne,{key:0,item:s},null,8,["item"])):h("",!0)],64))),256))]))}}),Ds=$(Es,[["__scopeId","data-v-48c802d0"]]),Fs={class:"VPMenu"},Os={key:0,class:"items"},Us=m({__name:"VPMenu",props:{items:{}},setup(o){return(e,t)=>(a(),u("div",Fs,[e.items?(a(),u("div",Os,[(a(!0),u(M,null,H(e.items,s=>(a(),u(M,{key:JSON.stringify(s)},["link"in s?(a(),g(ne,{key:0,item:s},null,8,["item"])):"component"in s?(a(),g(E(s.component),j({key:1,ref_for:!0},s.props),null,16)):(a(),g(Ds,{key:2,text:s.text,items:s.items},null,8,["text","items"]))],64))),128))])):h("",!0),c(e.$slots,"default",{},void 0,!0)]))}}),Gs=$(Us,[["__scopeId","data-v-7dd3104a"]]),js=["aria-expanded","aria-label"],zs={key:0,class:"text"},Ks=["innerHTML"],Rs={key:1,class:"vpi-more-horizontal icon"},Ws={class:"menu"},qs=m({__name:"VPFlyout",props:{icon:{},button:{},label:{},items:{}},setup(o){const e=T(!1),t=T();Ns({el:t,onBlur:s});function s(){e.value=!1}return(n,r)=>(a(),u("div",{class:"VPFlyout",ref_key:"el",ref:t,onMouseenter:r[1]||(r[1]=l=>e.value=!0),onMouseleave:r[2]||(r[2]=l=>e.value=!1)},[v("button",{type:"button",class:"button","aria-haspopup":"true","aria-expanded":e.value,"aria-label":n.label,onClick:r[0]||(r[0]=l=>e.value=!e.value)},[n.button||n.icon?(a(),u("span",zs,[n.icon?(a(),u("span",{key:0,class:I([n.icon,"option-icon"])},null,2)):h("",!0),n.button?(a(),u("span",{key:1,innerHTML:n.button},null,8,Ks)):h("",!0),r[3]||(r[3]=v("span",{class:"vpi-chevron-down text-icon"},null,-1))])):(a(),u("span",Rs))],8,js),v("div",Ws,[k(Gs,{items:n.items},{default:f(()=>[c(n.$slots,"default",{},void 0,!0)]),_:3},8,["items"])])],544))}}),$e=$(qs,[["__scopeId","data-v-04f5c5e9"]]),Js=["href","aria-label","innerHTML"],Ys=m({__name:"VPSocialLink",props:{icon:{},link:{},ariaLabel:{}},setup(o){const e=o,t=T();O(async()=>{var r;await he();const n=(r=t.value)==null?void 0:r.children[0];n instanceof HTMLElement&&n.className.startsWith("vpi-social-")&&(getComputedStyle(n).maskImage||getComputedStyle(n).webkitMaskImage)==="none"&&n.style.setProperty("--icon",`url('https://api.iconify.design/simple-icons/${e.icon}.svg')`)});const s=y(()=>typeof e.icon=="object"?e.icon.svg:``);return(n,r)=>(a(),u("a",{ref_key:"el",ref:t,class:"VPSocialLink no-icon",href:n.link,"aria-label":n.ariaLabel??(typeof n.icon=="string"?n.icon:""),target:"_blank",rel:"noopener",innerHTML:s.value},null,8,Js))}}),Xs=$(Ys,[["__scopeId","data-v-d26d30cb"]]),Qs={class:"VPSocialLinks"},Zs=m({__name:"VPSocialLinks",props:{links:{}},setup(o){return(e,t)=>(a(),u("div",Qs,[(a(!0),u(M,null,H(e.links,({link:s,icon:n,ariaLabel:r})=>(a(),g(Xs,{key:s,icon:n,link:s,ariaLabel:r},null,8,["icon","link","ariaLabel"]))),128))]))}}),ye=$(Zs,[["__scopeId","data-v-ee7a9424"]]),xs={key:0,class:"group translations"},eo={class:"trans-title"},to={key:1,class:"group"},no={class:"item appearance"},so={class:"label"},oo={class:"appearance-action"},ao={key:2,class:"group"},ro={class:"item social-links"},io=m({__name:"VPNavBarExtra",setup(o){const{site:e,theme:t}=V(),{localeLinks:s,currentLang:n}=Y({correspondingLink:!0}),r=y(()=>s.value.length&&n.value.label||e.value.appearance||t.value.socialLinks);return(l,d)=>r.value?(a(),g($e,{key:0,class:"VPNavBarExtra",label:"extra navigation"},{default:f(()=>[i(s).length&&i(n).label?(a(),u("div",xs,[v("p",eo,w(i(n).label),1),(a(!0),u(M,null,H(i(s),p=>(a(),g(ne,{key:p.link,item:p},null,8,["item"]))),128))])):h("",!0),i(e).appearance&&i(e).appearance!=="force-dark"&&i(e).appearance!=="force-auto"?(a(),u("div",to,[v("div",no,[v("p",so,w(i(t).darkModeSwitchLabel||"Appearance"),1),v("div",oo,[k(ke)])])])):h("",!0),i(t).socialLinks?(a(),u("div",ao,[v("div",ro,[k(ye,{class:"social-links-list",links:i(t).socialLinks},null,8,["links"])])])):h("",!0)]),_:1})):h("",!0)}}),lo=$(io,[["__scopeId","data-v-925effce"]]),co=["aria-expanded"],uo=m({__name:"VPNavBarHamburger",props:{active:{type:Boolean}},emits:["click"],setup(o){return(e,t)=>(a(),u("button",{type:"button",class:I(["VPNavBarHamburger",{active:e.active}]),"aria-label":"mobile navigation","aria-expanded":e.active,"aria-controls":"VPNavScreen",onClick:t[0]||(t[0]=s=>e.$emit("click"))},t[1]||(t[1]=[v("span",{class:"container"},[v("span",{class:"top"}),v("span",{class:"middle"}),v("span",{class:"bottom"})],-1)]),10,co))}}),po=$(uo,[["__scopeId","data-v-5dea55bf"]]),vo=["innerHTML"],fo=m({__name:"VPNavBarMenuLink",props:{item:{}},setup(o){const{page:e}=V();return(t,s)=>(a(),g(D,{class:I({VPNavBarMenuLink:!0,active:i(K)(i(e).relativePath,t.item.activeMatch||t.item.link,!!t.item.activeMatch)}),href:t.item.link,target:t.item.target,rel:t.item.rel,"no-icon":t.item.noIcon,tabindex:"0"},{default:f(()=>[v("span",{innerHTML:t.item.text},null,8,vo)]),_:1},8,["class","href","target","rel","no-icon"]))}}),ho=$(fo,[["__scopeId","data-v-956ec74c"]]),mo=m({__name:"VPNavBarMenuGroup",props:{item:{}},setup(o){const e=o,{page:t}=V(),s=r=>"component"in r?!1:"link"in r?K(t.value.relativePath,r.link,!!e.item.activeMatch):r.items.some(s),n=y(()=>s(e.item));return(r,l)=>(a(),g($e,{class:I({VPNavBarMenuGroup:!0,active:i(K)(i(t).relativePath,r.item.activeMatch,!!r.item.activeMatch)||n.value}),button:r.item.text,items:r.item.items},null,8,["class","button","items"]))}}),_o={key:0,"aria-labelledby":"main-nav-aria-label",class:"VPNavBarMenu"},bo=m({__name:"VPNavBarMenu",setup(o){const{theme:e}=V();return(t,s)=>i(e).nav?(a(),u("nav",_o,[s[0]||(s[0]=v("span",{id:"main-nav-aria-label",class:"visually-hidden"}," Main Navigation ",-1)),(a(!0),u(M,null,H(i(e).nav,n=>(a(),u(M,{key:JSON.stringify(n)},["link"in n?(a(),g(ho,{key:0,item:n},null,8,["item"])):"component"in n?(a(),g(E(n.component),j({key:1,ref_for:!0},n.props),null,16)):(a(),g(mo,{key:2,item:n},null,8,["item"]))],64))),128))])):h("",!0)}}),ko=$(bo,[["__scopeId","data-v-e6d46098"]]);function go(o){const{localeIndex:e,theme:t}=V();function s(n){var A,C,N;const r=n.split("."),l=(A=t.value.search)==null?void 0:A.options,d=l&&typeof l=="object",p=d&&((N=(C=l.locales)==null?void 0:C[e.value])==null?void 0:N.translations)||null,b=d&&l.translations||null;let L=p,_=b,P=o;const S=r.pop();for(const B of r){let G=null;const W=P==null?void 0:P[B];W&&(G=P=W);const se=_==null?void 0:_[B];se&&(G=_=se);const oe=L==null?void 0:L[B];oe&&(G=L=oe),W||(P=G),se||(_=G),oe||(L=G)}return(L==null?void 0:L[S])??(_==null?void 0:_[S])??(P==null?void 0:P[S])??""}return s}const $o=["aria-label"],yo={class:"DocSearch-Button-Container"},Po={class:"DocSearch-Button-Placeholder"},Pe=m({__name:"VPNavBarSearchButton",setup(o){const t=go({button:{buttonText:"Search",buttonAriaLabel:"Search"}});return(s,n)=>(a(),u("button",{type:"button",class:"DocSearch DocSearch-Button","aria-label":i(t)("button.buttonAriaLabel")},[v("span",yo,[n[0]||(n[0]=v("span",{class:"vp-icon DocSearch-Search-Icon"},null,-1)),v("span",Po,w(i(t)("button.buttonText")),1)]),n[1]||(n[1]=v("span",{class:"DocSearch-Button-Keys"},[v("kbd",{class:"DocSearch-Button-Key"}),v("kbd",{class:"DocSearch-Button-Key"},"K")],-1))],8,$o))}}),So={class:"VPNavBarSearch"},Lo={id:"local-search"},Vo={key:1,id:"docsearch"},To=m({__name:"VPNavBarSearch",setup(o){const e=Je(()=>Ye(()=>import("./VPLocalSearchBox.dF_ipd1x.js"),__vite__mapDeps([0,1]))),t=()=>null,{theme:s}=V(),n=T(!1),r=T(!1);O(()=>{});function l(){n.value||(n.value=!0,setTimeout(d,16))}function d(){const _=new Event("keydown");_.key="k",_.metaKey=!0,window.dispatchEvent(_),setTimeout(()=>{document.querySelector(".DocSearch-Modal")||d()},16)}function p(_){const P=_.target,S=P.tagName;return P.isContentEditable||S==="INPUT"||S==="SELECT"||S==="TEXTAREA"}const b=T(!1);ie("k",_=>{(_.ctrlKey||_.metaKey)&&(_.preventDefault(),b.value=!0)}),ie("/",_=>{p(_)||(_.preventDefault(),b.value=!0)});const L="local";return(_,P)=>{var S;return a(),u("div",So,[i(L)==="local"?(a(),u(M,{key:0},[b.value?(a(),g(i(e),{key:0,onClose:P[0]||(P[0]=A=>b.value=!1)})):h("",!0),v("div",Lo,[k(Pe,{onClick:P[1]||(P[1]=A=>b.value=!0)})])],64)):i(L)==="algolia"?(a(),u(M,{key:1},[n.value?(a(),g(i(t),{key:0,algolia:((S=i(s).search)==null?void 0:S.options)??i(s).algolia,onVnodeBeforeMount:P[2]||(P[2]=A=>r.value=!0)},null,8,["algolia"])):h("",!0),r.value?h("",!0):(a(),u("div",Vo,[k(Pe,{onClick:l})]))],64)):h("",!0)])}}}),No=m({__name:"VPNavBarSocialLinks",setup(o){const{theme:e}=V();return(t,s)=>i(e).socialLinks?(a(),g(ye,{key:0,class:"VPNavBarSocialLinks",links:i(e).socialLinks},null,8,["links"])):h("",!0)}}),wo=$(No,[["__scopeId","data-v-164c457f"]]),Io=["href","rel","target"],Mo=["innerHTML"],Ao={key:2},Co=m({__name:"VPNavBarTitle",setup(o){const{site:e,theme:t}=V(),{hasSidebar:s}=U(),{currentLang:n}=Y(),r=y(()=>{var p;return typeof t.value.logoLink=="string"?t.value.logoLink:(p=t.value.logoLink)==null?void 0:p.link}),l=y(()=>{var p;return typeof t.value.logoLink=="string"||(p=t.value.logoLink)==null?void 0:p.rel}),d=y(()=>{var p;return typeof t.value.logoLink=="string"||(p=t.value.logoLink)==null?void 0:p.target});return(p,b)=>(a(),u("div",{class:I(["VPNavBarTitle",{"has-sidebar":i(s)}])},[v("a",{class:"title",href:r.value??i(_e)(i(n).link),rel:l.value,target:d.value},[c(p.$slots,"nav-bar-title-before",{},void 0,!0),i(t).logo?(a(),g(Q,{key:0,class:"logo",image:i(t).logo},null,8,["image"])):h("",!0),i(t).siteTitle?(a(),u("span",{key:1,innerHTML:i(t).siteTitle},null,8,Mo)):i(t).siteTitle===void 0?(a(),u("span",Ao,w(i(e).title),1)):h("",!0),c(p.$slots,"nav-bar-title-after",{},void 0,!0)],8,Io)],2))}}),Ho=$(Co,[["__scopeId","data-v-0f4f798b"]]),Bo={class:"items"},Eo={class:"title"},Do=m({__name:"VPNavBarTranslations",setup(o){const{theme:e}=V(),{localeLinks:t,currentLang:s}=Y({correspondingLink:!0});return(n,r)=>i(t).length&&i(s).label?(a(),g($e,{key:0,class:"VPNavBarTranslations",icon:"vpi-languages",label:i(e).langMenuLabel||"Change language"},{default:f(()=>[v("div",Bo,[v("p",Eo,w(i(s).label),1),(a(!0),u(M,null,H(i(t),l=>(a(),g(ne,{key:l.link,item:l},null,8,["item"]))),128))])]),_:1},8,["label"])):h("",!0)}}),Fo=$(Do,[["__scopeId","data-v-c80d9ad0"]]),Oo={class:"wrapper"},Uo={class:"container"},Go={class:"title"},jo={class:"content"},zo={class:"content-body"},Ko=m({__name:"VPNavBar",props:{isScreenOpen:{type:Boolean}},emits:["toggle-screen"],setup(o){const e=o,{y:t}=we(),{hasSidebar:s}=U(),{frontmatter:n}=V(),r=T({});return fe(()=>{r.value={"has-sidebar":s.value,home:n.value.layout==="home",top:t.value===0,"screen-open":e.isScreenOpen}}),(l,d)=>(a(),u("div",{class:I(["VPNavBar",r.value])},[v("div",Oo,[v("div",Uo,[v("div",Go,[k(Ho,null,{"nav-bar-title-before":f(()=>[c(l.$slots,"nav-bar-title-before",{},void 0,!0)]),"nav-bar-title-after":f(()=>[c(l.$slots,"nav-bar-title-after",{},void 0,!0)]),_:3})]),v("div",jo,[v("div",zo,[c(l.$slots,"nav-bar-content-before",{},void 0,!0),k(To,{class:"search"}),k(ko,{class:"menu"}),k(Fo,{class:"translations"}),k(Ts,{class:"appearance"}),k(wo,{class:"social-links"}),k(lo,{class:"extra"}),c(l.$slots,"nav-bar-content-after",{},void 0,!0),k(po,{class:"hamburger",active:l.isScreenOpen,onClick:d[0]||(d[0]=p=>l.$emit("toggle-screen"))},null,8,["active"])])])])]),d[1]||(d[1]=v("div",{class:"divider"},[v("div",{class:"divider-line"})],-1))],2))}}),Ro=$(Ko,[["__scopeId","data-v-822684d1"]]),Wo={key:0,class:"VPNavScreenAppearance"},qo={class:"text"},Jo=m({__name:"VPNavScreenAppearance",setup(o){const{site:e,theme:t}=V();return(s,n)=>i(e).appearance&&i(e).appearance!=="force-dark"&&i(e).appearance!=="force-auto"?(a(),u("div",Wo,[v("p",qo,w(i(t).darkModeSwitchLabel||"Appearance"),1),k(ke)])):h("",!0)}}),Yo=$(Jo,[["__scopeId","data-v-ffb44008"]]),Xo=["innerHTML"],Qo=m({__name:"VPNavScreenMenuLink",props:{item:{}},setup(o){const e=q("close-screen");return(t,s)=>(a(),g(D,{class:"VPNavScreenMenuLink",href:t.item.link,target:t.item.target,rel:t.item.rel,"no-icon":t.item.noIcon,onClick:i(e)},{default:f(()=>[v("span",{innerHTML:t.item.text},null,8,Xo)]),_:1},8,["href","target","rel","no-icon","onClick"]))}}),Zo=$(Qo,[["__scopeId","data-v-735512b8"]]),xo=["innerHTML"],ea=m({__name:"VPNavScreenMenuGroupLink",props:{item:{}},setup(o){const e=q("close-screen");return(t,s)=>(a(),g(D,{class:"VPNavScreenMenuGroupLink",href:t.item.link,target:t.item.target,rel:t.item.rel,"no-icon":t.item.noIcon,onClick:i(e)},{default:f(()=>[v("span",{innerHTML:t.item.text},null,8,xo)]),_:1},8,["href","target","rel","no-icon","onClick"]))}}),De=$(ea,[["__scopeId","data-v-372ae7c0"]]),ta={class:"VPNavScreenMenuGroupSection"},na={key:0,class:"title"},sa=m({__name:"VPNavScreenMenuGroupSection",props:{text:{},items:{}},setup(o){return(e,t)=>(a(),u("div",ta,[e.text?(a(),u("p",na,w(e.text),1)):h("",!0),(a(!0),u(M,null,H(e.items,s=>(a(),g(De,{key:s.text,item:s},null,8,["item"]))),128))]))}}),oa=$(sa,[["__scopeId","data-v-4b8941ac"]]),aa=["aria-controls","aria-expanded"],ra=["innerHTML"],ia=["id"],la={key:0,class:"item"},ca={key:1,class:"item"},ua={key:2,class:"group"},da=m({__name:"VPNavScreenMenuGroup",props:{text:{},items:{}},setup(o){const e=o,t=T(!1),s=y(()=>`NavScreenGroup-${e.text.replace(" ","-").toLowerCase()}`);function n(){t.value=!t.value}return(r,l)=>(a(),u("div",{class:I(["VPNavScreenMenuGroup",{open:t.value}])},[v("button",{class:"button","aria-controls":s.value,"aria-expanded":t.value,onClick:n},[v("span",{class:"button-text",innerHTML:r.text},null,8,ra),l[0]||(l[0]=v("span",{class:"vpi-plus button-icon"},null,-1))],8,aa),v("div",{id:s.value,class:"items"},[(a(!0),u(M,null,H(r.items,d=>(a(),u(M,{key:JSON.stringify(d)},["link"in d?(a(),u("div",la,[k(De,{item:d},null,8,["item"])])):"component"in d?(a(),u("div",ca,[(a(),g(E(d.component),j({ref_for:!0},d.props,{"screen-menu":""}),null,16))])):(a(),u("div",ua,[k(oa,{text:d.text,items:d.items},null,8,["text","items"])]))],64))),128))],8,ia)],2))}}),pa=$(da,[["__scopeId","data-v-875057a5"]]),va={key:0,class:"VPNavScreenMenu"},fa=m({__name:"VPNavScreenMenu",setup(o){const{theme:e}=V();return(t,s)=>i(e).nav?(a(),u("nav",va,[(a(!0),u(M,null,H(i(e).nav,n=>(a(),u(M,{key:JSON.stringify(n)},["link"in n?(a(),g(Zo,{key:0,item:n},null,8,["item"])):"component"in n?(a(),g(E(n.component),j({key:1,ref_for:!0},n.props,{"screen-menu":""}),null,16)):(a(),g(pa,{key:2,text:n.text||"",items:n.items},null,8,["text","items"]))],64))),128))])):h("",!0)}}),ha=m({__name:"VPNavScreenSocialLinks",setup(o){const{theme:e}=V();return(t,s)=>i(e).socialLinks?(a(),g(ye,{key:0,class:"VPNavScreenSocialLinks",links:i(e).socialLinks},null,8,["links"])):h("",!0)}}),ma={class:"list"},_a=m({__name:"VPNavScreenTranslations",setup(o){const{localeLinks:e,currentLang:t}=Y({correspondingLink:!0}),s=T(!1);function n(){s.value=!s.value}return(r,l)=>i(e).length&&i(t).label?(a(),u("div",{key:0,class:I(["VPNavScreenTranslations",{open:s.value}])},[v("button",{class:"title",onClick:n},[l[0]||(l[0]=v("span",{class:"vpi-languages icon lang"},null,-1)),z(" "+w(i(t).label)+" ",1),l[1]||(l[1]=v("span",{class:"vpi-chevron-down icon chevron"},null,-1))]),v("ul",ma,[(a(!0),u(M,null,H(i(e),d=>(a(),u("li",{key:d.link,class:"item"},[k(D,{class:"link",href:d.link},{default:f(()=>[z(w(d.text),1)]),_:2},1032,["href"])]))),128))])],2)):h("",!0)}}),ba=$(_a,[["__scopeId","data-v-362991c2"]]),ka={class:"container"},ga=m({__name:"VPNavScreen",props:{open:{type:Boolean}},setup(o){const e=T(null),t=Ie(te?document.body:null);return(s,n)=>(a(),g(de,{name:"fade",onEnter:n[0]||(n[0]=r=>t.value=!0),onAfterLeave:n[1]||(n[1]=r=>t.value=!1)},{default:f(()=>[s.open?(a(),u("div",{key:0,class:"VPNavScreen",ref_key:"screen",ref:e,id:"VPNavScreen"},[v("div",ka,[c(s.$slots,"nav-screen-content-before",{},void 0,!0),k(fa,{class:"menu"}),k(ba,{class:"translations"}),k(Yo,{class:"appearance"}),k(ha,{class:"social-links"}),c(s.$slots,"nav-screen-content-after",{},void 0,!0)])],512)):h("",!0)]),_:3}))}}),$a=$(ga,[["__scopeId","data-v-833aabba"]]),ya={key:0,class:"VPNav"},Pa=m({__name:"VPNav",setup(o){const{isScreenOpen:e,closeScreen:t,toggleScreen:s}=_s(),{frontmatter:n}=V(),r=y(()=>n.value.navbar!==!1);return me("close-screen",t),Z(()=>{te&&document.documentElement.classList.toggle("hide-nav",!r.value)}),(l,d)=>r.value?(a(),u("header",ya,[k(Ro,{"is-screen-open":i(e),onToggleScreen:i(s)},{"nav-bar-title-before":f(()=>[c(l.$slots,"nav-bar-title-before",{},void 0,!0)]),"nav-bar-title-after":f(()=>[c(l.$slots,"nav-bar-title-after",{},void 0,!0)]),"nav-bar-content-before":f(()=>[c(l.$slots,"nav-bar-content-before",{},void 0,!0)]),"nav-bar-content-after":f(()=>[c(l.$slots,"nav-bar-content-after",{},void 0,!0)]),_:3},8,["is-screen-open","onToggleScreen"]),k($a,{open:i(e)},{"nav-screen-content-before":f(()=>[c(l.$slots,"nav-screen-content-before",{},void 0,!0)]),"nav-screen-content-after":f(()=>[c(l.$slots,"nav-screen-content-after",{},void 0,!0)]),_:3},8,["open"])])):h("",!0)}}),Sa=$(Pa,[["__scopeId","data-v-f1e365da"]]),La=["role","tabindex"],Va={key:1,class:"items"},Ta=m({__name:"VPSidebarItem",props:{item:{},depth:{}},setup(o){const e=o,{collapsed:t,collapsible:s,isLink:n,isActiveLink:r,hasActiveLink:l,hasChildren:d,toggle:p}=gt(y(()=>e.item)),b=y(()=>d.value?"section":"div"),L=y(()=>n.value?"a":"div"),_=y(()=>d.value?e.depth+2===7?"p":`h${e.depth+2}`:"p"),P=y(()=>n.value?void 0:"button"),S=y(()=>[[`level-${e.depth}`],{collapsible:s.value},{collapsed:t.value},{"is-link":n.value},{"is-active":r.value},{"has-active":l.value}]);function A(N){"key"in N&&N.key!=="Enter"||!e.item.link&&p()}function C(){e.item.link&&p()}return(N,B)=>{const G=R("VPSidebarItem",!0);return a(),g(E(b.value),{class:I(["VPSidebarItem",S.value])},{default:f(()=>[N.item.text?(a(),u("div",j({key:0,class:"item",role:P.value},Qe(N.item.items?{click:A,keydown:A}:{},!0),{tabindex:N.item.items&&0}),[B[1]||(B[1]=v("div",{class:"indicator"},null,-1)),N.item.link?(a(),g(D,{key:0,tag:L.value,class:"link",href:N.item.link,rel:N.item.rel,target:N.item.target},{default:f(()=>[(a(),g(E(_.value),{class:"text",innerHTML:N.item.text},null,8,["innerHTML"]))]),_:1},8,["tag","href","rel","target"])):(a(),g(E(_.value),{key:1,class:"text",innerHTML:N.item.text},null,8,["innerHTML"])),N.item.collapsed!=null&&N.item.items&&N.item.items.length?(a(),u("div",{key:2,class:"caret",role:"button","aria-label":"toggle section",onClick:C,onKeydown:Xe(C,["enter"]),tabindex:"0"},B[0]||(B[0]=[v("span",{class:"vpi-chevron-right caret-icon"},null,-1)]),32)):h("",!0)],16,La)):h("",!0),N.item.items&&N.item.items.length?(a(),u("div",Va,[N.depth<5?(a(!0),u(M,{key:0},H(N.item.items,W=>(a(),g(G,{key:W.text,item:W,depth:N.depth+1},null,8,["item","depth"]))),128)):h("",!0)])):h("",!0)]),_:1},8,["class"])}}}),Na=$(Ta,[["__scopeId","data-v-196b2e5f"]]),wa=m({__name:"VPSidebarGroup",props:{items:{}},setup(o){const e=T(!0);let t=null;return O(()=>{t=setTimeout(()=>{t=null,e.value=!1},300)}),Ze(()=>{t!=null&&(clearTimeout(t),t=null)}),(s,n)=>(a(!0),u(M,null,H(s.items,r=>(a(),u("div",{key:r.text,class:I(["group",{"no-transition":e.value}])},[k(Na,{item:r,depth:0},null,8,["item"])],2))),128))}}),Ia=$(wa,[["__scopeId","data-v-9e426adc"]]),Ma={class:"nav",id:"VPSidebarNav","aria-labelledby":"sidebar-aria-label",tabindex:"-1"},Aa=m({__name:"VPSidebar",props:{open:{type:Boolean}},setup(o){const{sidebarGroups:e,hasSidebar:t}=U(),s=o,n=T(null),r=Ie(te?document.body:null);F([s,n],()=>{var d;s.open?(r.value=!0,(d=n.value)==null||d.focus()):r.value=!1},{immediate:!0,flush:"post"});const l=T(0);return F(e,()=>{l.value+=1},{deep:!0}),(d,p)=>i(t)?(a(),u("aside",{key:0,class:I(["VPSidebar",{open:d.open}]),ref_key:"navEl",ref:n,onClick:p[0]||(p[0]=xe(()=>{},["stop"]))},[p[2]||(p[2]=v("div",{class:"curtain"},null,-1)),v("nav",Ma,[p[1]||(p[1]=v("span",{class:"visually-hidden",id:"sidebar-aria-label"}," Sidebar Navigation ",-1)),c(d.$slots,"sidebar-nav-before",{},void 0,!0),(a(),g(Ia,{items:i(e),key:l.value},null,8,["items"])),c(d.$slots,"sidebar-nav-after",{},void 0,!0)])],2)):h("",!0)}}),Ca=$(Aa,[["__scopeId","data-v-18756405"]]),Ha=m({__name:"VPSkipLink",setup(o){const e=ee(),t=T();F(()=>e.path,()=>t.value.focus());function s({target:n}){const r=document.getElementById(decodeURIComponent(n.hash).slice(1));if(r){const l=()=>{r.removeAttribute("tabindex"),r.removeEventListener("blur",l)};r.setAttribute("tabindex","-1"),r.addEventListener("blur",l),r.focus(),window.scrollTo(0,0)}}return(n,r)=>(a(),u(M,null,[v("span",{ref_key:"backToTop",ref:t,tabindex:"-1"},null,512),v("a",{href:"#VPContent",class:"VPSkipLink visually-hidden",onClick:s}," Skip to content ")],64))}}),Ba=$(Ha,[["__scopeId","data-v-c3508ec8"]]),Ea=m({__name:"Layout",setup(o){const{isOpen:e,open:t,close:s}=U(),n=ee();F(()=>n.path,s),kt(e,s);const{frontmatter:r}=V(),l=Me(),d=y(()=>!!l["home-hero-image"]);return me("hero-image-slot-exists",d),(p,b)=>{const L=R("Content");return i(r).layout!==!1?(a(),u("div",{key:0,class:I(["Layout",i(r).pageClass])},[c(p.$slots,"layout-top",{},void 0,!0),k(Ba),k(rt,{class:"backdrop",show:i(e),onClick:i(s)},null,8,["show","onClick"]),k(Sa,null,{"nav-bar-title-before":f(()=>[c(p.$slots,"nav-bar-title-before",{},void 0,!0)]),"nav-bar-title-after":f(()=>[c(p.$slots,"nav-bar-title-after",{},void 0,!0)]),"nav-bar-content-before":f(()=>[c(p.$slots,"nav-bar-content-before",{},void 0,!0)]),"nav-bar-content-after":f(()=>[c(p.$slots,"nav-bar-content-after",{},void 0,!0)]),"nav-screen-content-before":f(()=>[c(p.$slots,"nav-screen-content-before",{},void 0,!0)]),"nav-screen-content-after":f(()=>[c(p.$slots,"nav-screen-content-after",{},void 0,!0)]),_:3}),k(ms,{open:i(e),onOpenMenu:i(t)},null,8,["open","onOpenMenu"]),k(Ca,{open:i(e)},{"sidebar-nav-before":f(()=>[c(p.$slots,"sidebar-nav-before",{},void 0,!0)]),"sidebar-nav-after":f(()=>[c(p.$slots,"sidebar-nav-after",{},void 0,!0)]),_:3},8,["open"]),k(es,null,{"page-top":f(()=>[c(p.$slots,"page-top",{},void 0,!0)]),"page-bottom":f(()=>[c(p.$slots,"page-bottom",{},void 0,!0)]),"not-found":f(()=>[c(p.$slots,"not-found",{},void 0,!0)]),"home-hero-before":f(()=>[c(p.$slots,"home-hero-before",{},void 0,!0)]),"home-hero-info-before":f(()=>[c(p.$slots,"home-hero-info-before",{},void 0,!0)]),"home-hero-info":f(()=>[c(p.$slots,"home-hero-info",{},void 0,!0)]),"home-hero-info-after":f(()=>[c(p.$slots,"home-hero-info-after",{},void 0,!0)]),"home-hero-actions-after":f(()=>[c(p.$slots,"home-hero-actions-after",{},void 0,!0)]),"home-hero-image":f(()=>[c(p.$slots,"home-hero-image",{},void 0,!0)]),"home-hero-after":f(()=>[c(p.$slots,"home-hero-after",{},void 0,!0)]),"home-features-before":f(()=>[c(p.$slots,"home-features-before",{},void 0,!0)]),"home-features-after":f(()=>[c(p.$slots,"home-features-after",{},void 0,!0)]),"doc-footer-before":f(()=>[c(p.$slots,"doc-footer-before",{},void 0,!0)]),"doc-before":f(()=>[c(p.$slots,"doc-before",{},void 0,!0)]),"doc-after":f(()=>[c(p.$slots,"doc-after",{},void 0,!0)]),"doc-top":f(()=>[c(p.$slots,"doc-top",{},void 0,!0)]),"doc-bottom":f(()=>[c(p.$slots,"doc-bottom",{},void 0,!0)]),"aside-top":f(()=>[c(p.$slots,"aside-top",{},void 0,!0)]),"aside-bottom":f(()=>[c(p.$slots,"aside-bottom",{},void 0,!0)]),"aside-outline-before":f(()=>[c(p.$slots,"aside-outline-before",{},void 0,!0)]),"aside-outline-after":f(()=>[c(p.$slots,"aside-outline-after",{},void 0,!0)]),"aside-ads-before":f(()=>[c(p.$slots,"aside-ads-before",{},void 0,!0)]),"aside-ads-after":f(()=>[c(p.$slots,"aside-ads-after",{},void 0,!0)]),_:3}),k(as),c(p.$slots,"layout-bottom",{},void 0,!0)],2)):(a(),g(L,{key:1}))}}}),Da=$(Ea,[["__scopeId","data-v-a9a9e638"]]),Se={Layout:Da,enhanceApp:({app:o})=>{o.component("Badge",st)}},Fa=o=>{if(typeof document>"u")return{stabilizeScrollPosition:n=>async(...r)=>n(...r)};const e=document.documentElement;return{stabilizeScrollPosition:s=>async(...n)=>{const r=s(...n),l=o.value;if(!l)return r;const d=l.offsetTop-e.scrollTop;return await he(),e.scrollTop=l.offsetTop-d,r}}},Fe="vitepress:tabSharedState",J=typeof localStorage<"u"?localStorage:null,Oe="vitepress:tabsSharedState",Oa=()=>{const o=J==null?void 0:J.getItem(Oe);if(o)try{return JSON.parse(o)}catch{}return{}},Ua=o=>{J&&J.setItem(Oe,JSON.stringify(o))},Ga=o=>{const e=et({});F(()=>e.content,(t,s)=>{t&&s&&Ua(t)},{deep:!0}),o.provide(Fe,e)},ja=(o,e)=>{const t=q(Fe);if(!t)throw new Error("[vitepress-plugin-tabs] TabsSharedState should be injected");O(()=>{t.content||(t.content=Oa())});const s=T(),n=y({get(){var p;const l=e.value,d=o.value;if(l){const b=(p=t.content)==null?void 0:p[l];if(b&&d.includes(b))return b}else{const b=s.value;if(b)return b}return d[0]},set(l){const d=e.value;d?t.content&&(t.content[d]=l):s.value=l}});return{selected:n,select:l=>{n.value=l}}};let Le=0;const za=()=>(Le++,""+Le);function Ka(){const o=Me();return y(()=>{var s;const t=(s=o.default)==null?void 0:s.call(o);return t?t.filter(n=>typeof n.type=="object"&&"__name"in n.type&&n.type.__name==="PluginTabsTab"&&n.props).map(n=>{var r;return(r=n.props)==null?void 0:r.label}):[]})}const Ue="vitepress:tabSingleState",Ra=o=>{me(Ue,o)},Wa=()=>{const o=q(Ue);if(!o)throw new Error("[vitepress-plugin-tabs] TabsSingleState should be injected");return o},qa={class:"plugin-tabs"},Ja=["id","aria-selected","aria-controls","tabindex","onClick"],Ya=m({__name:"PluginTabs",props:{sharedStateKey:{}},setup(o){const e=o,t=Ka(),{selected:s,select:n}=ja(t,tt(e,"sharedStateKey")),r=T(),{stabilizeScrollPosition:l}=Fa(r),d=l(n),p=T([]),b=_=>{var A;const P=t.value.indexOf(s.value);let S;_.key==="ArrowLeft"?S=P>=1?P-1:t.value.length-1:_.key==="ArrowRight"&&(S=P(a(),u("div",qa,[v("div",{ref_key:"tablist",ref:r,class:"plugin-tabs--tab-list",role:"tablist",onKeydown:b},[(a(!0),u(M,null,H(i(t),S=>(a(),u("button",{id:`tab-${S}-${i(L)}`,ref_for:!0,ref_key:"buttonRefs",ref:p,key:S,role:"tab",class:"plugin-tabs--tab","aria-selected":S===i(s),"aria-controls":`panel-${S}-${i(L)}`,tabindex:S===i(s)?0:-1,onClick:()=>i(d)(S)},w(S),9,Ja))),128))],544),c(_.$slots,"default")]))}}),Xa=["id","aria-labelledby"],Qa=m({__name:"PluginTabsTab",props:{label:{}},setup(o){const{uid:e,selected:t}=Wa();return(s,n)=>i(t)===s.label?(a(),u("div",{key:0,id:`panel-${s.label}-${i(e)}`,class:"plugin-tabs--content",role:"tabpanel",tabindex:"0","aria-labelledby":`tab-${s.label}-${i(e)}`},[c(s.$slots,"default",{},void 0,!0)],8,Xa)):h("",!0)}}),Za=$(Qa,[["__scopeId","data-v-9b0d03d2"]]),xa=o=>{Ga(o),o.component("PluginTabs",Ya),o.component("PluginTabsTab",Za)},tr={extends:Se,Layout(){return nt(Se.Layout,null,{})},enhanceApp({app:o,router:e,siteData:t}){xa(o)}};export{tr as R,go as c,V as u}; diff --git a/previews/PR237/assets/cmuiohu.B94PsR1K.png b/previews/PR237/assets/cmuiohu.B94PsR1K.png new file mode 100644 index 0000000000000000000000000000000000000000..65bec08ee041bea3fbc09c0e72a8aeb6f7387ae9 GIT binary patch literal 34578 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

YFW2AiB=HTn1h&?i|(pqpV5oy)_f{FIlqa6 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�u_du1`rFJ$ETbINKb&9zawWq5BKG} zEzXa&qPl0&U3Ae|AUV8g;*(#+YtF_XnG1-kXGK<7l9%qg!zKH z{%|fvUHXN|#{q;n6z8!C2Ex?A_qVycM;PP~&f!arbdR9LJ8@iIG%c7gIPlcZcCNc7S(gGI4IETTqkL ztrtB6h_Q(=tn+w^uP&_sx48R)*mZd+vG%f2JoDb{ZPfZ=(aFv7e)y~M2Z>3-vLOc` zdDuGanIXz9AJ4@pe&C(tA=!LzuC-BC`I5Y1)^Y-0b^CuwiLv4#ASqEH(5zdqoHIXg zL0QEXrEpcU%@_8mg6($b;8@i5M1d-IQjbc*FtO%9QM7Q}|K(WiO1B|K7Z0s&x?_JS zooyzAfYD9D>={rVn3Qxk4lXp-gjz*h;}S3Mn{bZ^#d^G85+G5 z1F?mZxdy76K*NH90CSKl6=~gib4q zMYe(AGXi4VS>B5;>POlqhoy&-Ef?>=7xtEhd&)meR*v!-B;_JuTz4XLh!(7 zH%uiL?1FZNH;u0*=p%&@NwP$e?dsBzrlMC4uHu|=QIn;_t&z#fkIxq|~bddQ7HlBjV{`okK&ZK7U3t4@BSeg>0 z<#brza-MZ7ll!@r;1^?n1fH)B^^#|$8Pp?&6Pm2Q3}EObV?cR$(iNOohTy57uk$vdb0kvfszWA z8cYO{vAzT@X4j?b*S7l$qcdUc9D(rlHA8k%U$MjkvwdgUT*q>$!YARkL4Id^=9j2t zI&u^)%BCymfkY>yI7tR8#&~h|csn;{e1sU=)JX+u<)1=1KMT)KRW*wk(s8M!Y9Vu< zA-g&IM^)(JM?RWQ$jUa^_p%;>`=kiEH0bhX>)kplpMK9T8APuKWPC-@QPq}pi-F8t zw#dC(eKK~SJNIKm4|U=w2jVx}=wn+qmitn1cz;v~!*x+4a@~mQU`0rPLl!goIYb0q z+q*-kVJx0=HZYjx02)M<=ZhI^Ibwk)_+b-o@ZRJ^a*gkNnk;$B(1PO>xIIGu$}l@! zb?0{d#pS0yIsuK~@|}t{=3}vIaSCMDT#g>|g$e>KrWgt{V}3BqplicI__R0)zYdO&dWD< zUOhgRa1s!AuGw<9hdE=PsR{9Co@mg{9@-P-6zm|pd(!=ylsqJoNTgx(G19cT0py*6 zL0X;l%V3}fMhGhC?yA7vPfj{|`O+)D?D--nGTct8q))8h)LD*(g*bUHd1G-}q*h;C zmnrkTuO2N#1VPsoMm#}VFic3O+tBO=GJ(nenItr#udSg_@zMpq9=oWW08_|~WcYgl zMIpwB!@*s~tLspZ1W9RAX#@N=*05QPkD{WFz4x&0?Oe(b_8^BA(f2ZyFQFz_)ucy5 zSowGtJJOcOydD~^RQ>yfhf&X&H90AYk-$ztgzjv2y)S%qN`{;F{IvgrDOq2YvZ3qt zRsWHe)XT9mgz1b$9+9J~-RItvwZp|9Ln@HYKOgz_4~_+4)xam>rQC_-+zHt25Ed-- z+NDtu=m~*k>KA#^s1m5WHO>eIg`P5sT2>I_oYB%j;Cx`2 ziwW(H`+;CJ&vXVuDa!0eP7TmRDizuV6II0%5BUf?R_~pB#M>`hg?j$3q`$Y@;L@)5 zKJ~W84Yg`XV0zLv`DQn>0nQse{LC__JdM{*@wRl=${5-Dy`|qHaSqM1g0%?~CQC{a zV*L)QW4XH|w^k7@i$>MK`gsWWPCdTK?wDK8)IVan5oPMA`rv{;2OuCE|H}W)oQ;|8 z)&eUOu{~Q-;}ea1&yCNr@Oc?*`k{R7)>)MLKmCM! z1Cv>o$;o?EA!m@caOE*j!7OTVY>TxM*PgW#^ln=0Gx8;Vs@k)T>-NA5X3Iu?xH{Ck zt`LL-Jkz-p(CtQKyhfIunarmokfQJ|G~eG({{jxpY3d10vBqt7A(jd z_ya?>QaK^x&yt$wZ}`x=vZOww+*QQ>G*=fQhFn-b8d7Dw89q^|lU2r2yU}6F%1`^t zo$Nk(Tz@H>j&9rL4O{pL^35cD;`(YAvhVcER9^z+zw!nh=hX15Vcz^u)a%6f+qF%I zBXqo{aCr}Yl5G%{PdoUvL&?6tPz1agb}Nr z0`aKE>&jyOqL;15tkpGR`ee~y9c1n$I)$S+t)b()Lf7_1qt`9&i3ZHu?`8|`j+;Dg z^tI(ipGNQ^20SifR{YvDw&Gfwa$U5#4oq+Y2d+qOA_Nm^isF>zHL z2?XlKo$%m=IN}zrlCu^#513%4+**4H(bd0ByM5(;-M-p{YU4}6N_|VE-L|WuRm;jW z2_gLDhRz-NZet0vZ@0baeALC}=?))btD)h4HIAu5(tVn57m8zSC5Fvh&VwcRr#prq zLHoTq_{_zQtsOF)^fa}Rmw##9qE5s$4T$PMw(it9!b{BLW*?bn=0WAj{9Jc!Jo75I z$CV@l;ll(-k<|vK(B@5!_H|s(Z6Q=eBV`oPqEgP&rqiPH*Sf3*$CK*G$s)8B`NxKY z4cY$r!=tV);+O_+)ZElj@-<3xl%Q_=Ix7j6Mt%G_7C2aMmi0c3hh|w44x)+!P^xOE zU7`+D&7K-?ec^{tt%jvN*o<3d&|F`{QBYxY)OCHdUh^@jlezIjR#7;1TspaCK00#Y z(vZcEf56o^5Y2*t)st2|(OCi!&}<1vWU4<7*|PGz$xk!0>5Q>zQfRXlB-Z z&w019C?B`6hj{hGY!e~j=A?ausQF&t&w%%0eS7iD#6O|G6}=u01?^s%v9crD14Wu> zR2Jv8B&Z@oBtvSw&%*sah9ocBTLrz9gZlK@nFbBK@5b-H`jI1;W6_{&yE<7dKzNmn zHArx3lQk=CdgqpXW@+1)YFnv`HoNAt#QQd!khNEBM6l>XAwIc)ng3|@1smaK6=&m7 zBx*aui5X!xM+W zA<$h_)p?@SE}NOdPki70vKqMC@{2xhYSE11n%d#X26G_&M+d@2&P(}*oiT`W`rz>x z<+T}?yYJ{_&uj)8E6I2NhkAE+H7X}*k?#QkXZFDNkkWw|OZQHkh}uP~p9aO02Th&K za!MPKUaa!Yzmjmh2t&LV3RiuhiZ`r}rzMbU z$aT~U#T<4MpNopx^HJq(E{5LF8)p#^M&bWg++c$py-dI}J8D>}R#)=sB3kG2hEw!XjErI*`P8gBKx4f&U2o=S$Z&V9dkpcQ_I( zdH40c3v=;Tw$Xq>mpq_TSl_4}lFt)o;^cs^52JWYPDJdYFMiE_y`c@GffG@3c>F{4 zE%{ToWIlE@$QNX--Ji9Mp7ZJq>c)WMW1n)?8nq$p2#Cf$`}A?^zy9I4bt~QZ^J9i# zv+KP(nF0Bcek}^r=Qm^1q@bIAac|52f6R=t4k?t5az(nPNBj=vmlt>o#W@X)jr1RpBDHJOaKQGZqffb5Zo7Ol6 zkCE?aB)gp5I2Aw=%MgjCheH{(KKsi~WO$dIO2y0)ey)Dq#u$$t_jAG{8jbt$D*Uf( zr%wBzqk7e%J}J$sGuP$wPd-8qiPBL6mmY4-kJ7s$cTKb?l9TfoSxJfPMXt2wU4Olc zb`jsYO~RMtr5(W~#tONETpJs&I<8|=QVCfyvf_&{D7Ss}_C@}$77NFLw zYc}z*$f^D1N<283NrRZMEs3>nah!3$nP zf{T5jP?=D8psl*7=Md+hoOMKe8@utBfIYOU51Of*hNDF;4s!5{#O@ZFI|W#rHQ!Da zTeb&JjJ34vtD(l&5@D8dsuVb4aN#sT7%B1_rO?;7S0#`g#2c_N2KNUL5G1~QyRX|J}ioIn2T&POl3U8^s1`t0}nrF(rA{vR1Y{ zPR5&+tI%HF|7|BJSzlgLo(n&04*}*A!oSr7RGY#s$Hoak--&sQH|yWDp+mJ#UKCyG z_~Hr$_?ZeyG_jAIyJ-fXZZ%msAwfE>*r&Cr@7zkf4zY7g&}QxcmgM{c3AoQ z&?|_!%^Aw*zzh!coNC!9SE(*6^&M-8_zNt z?V?a!{u%5&bZNH4^05gtKtYfBRxRge-x;0XJgU^r|6PDjC7R$?)U2IKO8(7PgZQ4$>K$X%%+kC9a4E1 zVF%Dhq6VZpR@MfkMJaT)k%)2V5R5@x4-M=ztWI|>1v1y?em7rsQ%?87$<&hC(X9=lgKhn}p zh^hYJVZ|{qF|UZg2X{yrKe;N|&@^Mr#O2>3DmP&)5lE9NGziSU^^RjL8m>u*1Z}-5 zdX9p|yt@J!Ux(lbSFijBuB3H(wJ5%r_6DXFk0N&H{&YuGeo0s$Fkfzj+D`U*5+x0Y z?yR(DLw>7)@vb&J@WhVtNkN2z3fldIBsgcLfPM`Vpk~s46l_eoqpn)^d@Wp4MO~&@ zUw-@SX^2Itr+@$V2tsS}>fEmuw@iIf5zI;?qh!3x=l-CegBuw6#UHhKEKYQHd-GBp zZ=EP3$eF4}6I=EBQ|~$j__H75pvU-7Ik5b$z{rV34D!!$)Vgbjtui!S6)u?(xJFV6 zlnHC|)v>01#xllux=8}feslU=v)3{{hv#2CY`C80z3{W_XX5}5^ncF?kOj^zUSpVG zN|Ym=8|-HgP(c%9(F`K)2`q3agZ9DUb8tuhe1GADXl;Y})SYhnG+txDD23IB2!6#k z;3B9^BWjlgXERx3)7h+z2+~LB9rS;CE?Krf0qM^~SDp1XAyK&DARw3rmjF}*9;Nno z1@|davKB-xQcC_T9;(DYgxYn_lj~o3XB(IGCimbg=_@qHLT))BNDR0riv1_dUrK%e z&C7TyC-55v$t)=2{mA%saPdMWC_mXQ0o4(b-_m+q?x?^f)$LdskzVaG%5 z-=vaEPz@XV(CT{Y3yt+xo6TPw7yE}JnOIJZWo=OXTmpCCgMpUz&FLgXCkw!uJ_ycw zdMy@_LKS=0)X;j=+1$1vNodrWcsN1(!q~1)S|``$l&wDB1`qL~ea&bM8X!PhNuRKXl7WKHybpR0r;ExLhiQa9MVRTFMlV|yUpkrqrgen5J$1T>y zJ^v7Ev>|4en~}qsr9m8U>`!!bD>6OJ{aCk7!*dyOeu4C@z_D)s;sUW7jram!%MLjY zD%5RMkw6vuLN*^|Q@Im=H$%2V0Aa)5&RnvzlXUxDo^wnYhi(U-!9ZNtton$rx6Z@e zL!*)I4dsm4Cr;BwRQ-P81lFvXZVCzXh|x#w&}@e8wcpKR!v5)#8SQqIkP0an=*R(l zKVL5#9;!njL1^*`&19?Zh%g9Cz2a8&s!0k01g`tarFuIe?EX5Ao=*)f+^P>j4BmI$ z2kAD@LUO$c)hcF6z5=^^=I9tsKg^I>A_PGaE39VJHM@-*T!3d2sjW#o8bVK>I3ite zL(Xx}A+dx95u!vRVgC2N3Z@ytvX0B_w%s>|vz~K|4A|#D`|}r#^h*WAa}O~Lb+B|C z7YF#bLQHnT;`_tY#ZS@(8iJ1-za?;wN`)%`L*hT=y&3G5H{-!RdX?{7!QM?N(67mXi}OpGJmN0X{1!rv#NPGA0{6+Hm(^6f@%A?==FtM| z>rQUr7L^Hdn44<6&*{okg)TlO8XVd=z;VBTgCfVXDG{MJ9_k>C1fb7^LM}_f7EDhH zVa;dst7xVlIjJz4*=a<3C`ZpyPn}R%8NOBc`f$YLxK+u$$aRX}=H9#1L^x6YrXmVq zEk%$SYgqid5$v?5ivcd5)jis=e;+}F1c-{sqw_nXx;nL7-# zn9GgMkQ<+l#E8l8U9x~@>ZMcUO)|shRN$N=htV7k5sfSQD;isog*zkT=9{&??Vvx1 zOu2AMC^vuRll>*f{j$xXJ|78PJW1wjKm+<-s5V|b_rDV=LYZ(B5XY(K3E+m*UlY&a ze>0=fkuF->3`qAoJ!Y1`-X8~pAGHc8crF+RwK1iK_bZf5Gt)Aqv9rCz|{^^Lz0z>iS^{n0PfPN8B_hra5;DvV^ns$ z7DrnyUwY9C*9K1d>E~@ENIjg3^R&iw-L{K?~1?? zZR$}6yMr!!kvO3GEi=1QPi5JrX^fC7lUR?eg~wh?J*XZSgtE5K&h4I#PM{)4mGUNZLmi&!*w4jefhLb<_|M zn1HbUTID(i`N`p;+q!VA5_-0j4*3xLMh2CaL7Ltn?0 zFG$pGuW%(K#Ay21z|fk~c!CSAIm2|?o5hlEUB$(e<_g9d9AL3m6OC_ zDD4G=WRDivcdfu~lgmxMlFN2!+wY7jRLC$OK)9M%iebTeQdI>8`#~Hfr8USuH24@} zW!~cccbO(S!d?LWeq!7k&dG(gGv57>0Y zzmQz7kz9Gs`C-Hh!+;L=F-zQfi~e$(e&PT8TlVCvOxltea|z6NP845=@g%C_ATgHj zhS1Z)>S)HV79#;6)&;@}Go5Hh2QGI^&5MZ}|0r+o`qE};X}|iS35&AB2I4nH7_dAA zaVFm=ymGIn^Rw1OUB-4-OwxEX^JL`!k0)+Vl~asDZeN*LyG~T4Y!mG*wiKDMfqaV9 z_%lsHs}=^h@X7!7)bDZA9BqJ+EYd;YTV9oOgMV6{ds2%`B4Y<)@Nc=f@18o-$%CQ9 zi%yKFYBvyw*roAv%Pa*0O?Un-N*;;8a8Q7rHG@y0lV#$}IFtk&>gc^fc%NQy$$>?eCt9)2VBB`0e)I%cE!6UdhVb=UR+<^`C&^Q@OG zON46Eq_v>5Y(y|bBmhZb-W8u~379^mFL&v+__xvG!LM}!bI;i2bt>Q~ilEG%8jxH# zw|GyGJMwsb4=q~EmXGaOHIpO1*-%}mm8U>9eaU}h!p4dV_{ShoLa-@yi1^3~A+!_@ zuYcruaxh6@lci9`c~VX+O)eHb{Zasdd_P?>VblMi&HAWd9E7G*#z#7JVkFY9ktPR* zC716{$+4ZdcykCIgfSgETSE9z+pe9vPzQS?H4?p;MKFpgM#hNU-h-aYR1HYr*SJK~E08_{P<4>#j~MUZn4B^l9e))|ByX^)i2BJwk$MdS;2mL6XT7_3Z6q7S~`cqmLU zGBxdbj7s8-E?+M_fd6sNtyY=wA&S|N#K2~s>l&098~<@Ur@<3V6|j{y zlV*}K1JqNm?dpU+ofgMGqtIOMx;0qaw{dp&?HY~6qy;5YTY3tB9RDjPAyW^qNQnPiB&(4zo2GbK6(Rw1LZSqRqd`#E(pf&g z<>%iB^piV}u?))B(JiA_fx^))?D1plos4sJas|{V1vryfVImjD9E|)dc4ND(MF1BB zX>$Fd|7L(gYQ6n$f?s9s`%u9=@9aaLPL)z>L|w08#hr~hzbda=)9@B@@Rv%z`~&z( z>N2C9eBW|CZr2oWNzC2cVnCYnsam-k-024(v|4g)1=3YEW)M|R-B;t&K=Id0= z-&d1nmck5(w@8=lP{h0(H$N7LUUQLOI-aIy669nipg3`r7`&Mo=^*~;=N!Zwyp$gu zp#~k?Hq*y4*4``dQmPK*LiKUTN=|Va1%F>4+H5 zyfFR)z*oIFg&b4mR(v~UMchLk0;nHdS{jPUIWL!FsU--YYFMYyoGP#FK9eNn zIw!-2Fl?L*#PN%rWp5Vv{=%^{v4R6%lTz1}3nWMYh6K_XH3-S_QE7Zt*Va5>zb9+iUE6fmNeHnGfv`R`7e z&;tki!g)_Jkjk4z9DD}<&{L>i8iS|t`GV_U5Fb;-F|Qm*A5A3i+pbniVEW8D9nOB* z%u466&NV8SS#d0FlUWfNjI+>iw6tZ`nPoUNEC$be6^;62OEzV6NlMRw{JcxUy3Mts zv-bowEhI@SyBIVS&?T2Gmi`2*%N|Q}_~YDMy>J=OVcI7x+_9)S$FNq{V)y6B`O9oc zS|L(0k=)3bT)qDbpw8rIyhQh8v9*!EWMGCAd^t?Cn$PFnieR%nhR!~@O!>G6m`inN zm-V`n{G9??40^2{lMWGBF_OPyL9>oCXWR`k-B=shSl-I~Sgfap#P#2EIsp~!>-{rW z&E4c_Bk$toeSta2O8q41RvS)p5sb-T7wVn+7QY(LnYcCth7gDHC$jKEyHqH|r>%z` zETa(~u&hdfLXb1<=ocjP2>l7zOQZoi?cRS@12h==a1K^2SBIn|`RYED&ovxpkPqXd zs4$nB&NKd*(7TWg6^f;{<=-=31SXbOz%ZgeoO}+gh7<$zJD5)ae)oA-5)21-qr^5W zUYs$0%8=#5!}BSqRMoZqEY&s`4cV3Ir;qq-1*_#^S#6xhT0yQ*lHlh}mAbnSOU)iQ6KN@oxE!LR-ojC=43 zfhf|u+V--ap3E7%#}Vqid2y=^H6|to#`jB8|R0M2d{Komb z#uef_GS7+CGe|T;a2RM1goggFY?t%&Vm->N-r1NjqAK17&N~E#lq%Yd9J-k_+cqt4 zAwYqArBNENOYvKGS_27rW<&d6BU*CvYJ^?m`d1Kbf z=5v2Ya`aGz!444bWYNCZWc~SD=)d3tHo}!=xl+mN9NjvX$-}N@xm7lFc$FG> z_(q^XI38aNsSkvhXE!lXvWJQc91Kq11t>SsNz+7M0`%WvGV*230Um8L7fRw}{Y-#! z%&jKLg8EU5b$MxZ6A-nL14!n8X7PLer@ihm&?4mE&Zo8DADGJO|liX_oiei#@gUf?0!x7cWC3vurnuxpT5-LCfw% zW7fiT7MGl7MM>wTK8q-pHdVS<-Gt;U^cb{YHQaj?tFrN4nBL_p4Z6?i!kiVQTlA#z zDpHJF05ILeCXCR%($4w4Y`kR63~&$Zs#OPdOCUykgns~sQ;reU&Aj+=@I+-+4`8A1 z&)u!p*bYw*h}M>(A33(N=c!7sD=(vSpz?qb3q_RI^PI3&7}qdV+@1z}FUlrDCvZ7w z;LO1K;1w}Ok{}?^h5{ln;jv8?i#ldVz~&6{hUd{~$^_mn!6Pp|v}sun6;>Z$w)x0$ zpy#BYh8x(N!HlCzq1G>aqEclhH@QxN2;YPU!6AOpFn{1Hl zP%zi|LMpCyri3S;JZ7x*rb_*R1xwafbjK-}`F;lT^0x?o!%kviKT&FLS~$`}JNmJH zg6Vkta|qB#=~PI#=68eH{i^&Ky(}=p3z#>kl1=G$u<`xBZhg!#F7R4A2Md8=wh1Kx zx@I!jfPL?&H|aYxH0YaVq{n#BeJLGRx@?xh4=yYT^5gml?$_{7aEPv(Fz+VxhNMqx zNCq^|%lko+{1XQSPAy3_)A)gQMm}rM%640gPR%d|2!u;piPUS`P__^b&quh}cB&6D zBETgX*V7Kd#!^E70sxeHSJ}hUmzar@@5M;KZSxhKx;skX_qq-7um-oT0rB1FNRTzo zdDl=d@T3ZLsz2l!CQ8qMBj{X{>n7#Xi*|}0&so;Hrv*=F_IN6LSsytJLAYoMY{8uj zcQUd3UE{dAzapRkYZr`Z=MkOqA{o6(Eapr`z4@Q6S9T%0_*hMCYBmwm2J&qr2C7kI zxhV9P{fNIgp7zL)e{?3O$IdGal}0HtIrOS3?%ldyTY0^IO$vam`a7|}`=PvHXVFL> zDy}U9ocQotDLw4t@Mj%>tMJ+{Eht6rU}3vk6EM?Hnx50G+Yao>0zM@`siWSC167xj zkQ~xi9?=M}Q0{%bQ>2O(6T)`oFtjDirIAkeulB)V8|fCXwX|gRtyO+-e^#YG@&XQh zMcQy6yCsq6I4r0Tq`mNqKXtx)`eKk!1E_FU+T<%KJJZ-$O1}R9EiJe$$J~C%su7DY z#I9+X+iJO(c-^M7CJD%w2{0I-2e6bY8CNP9g9%{mI)!#G6A5&cYU|Ld1O5(v5AZCd z#YBlci%$Lb#qfbzxze^*@(6tSK-enotQ^sVMRBMvq7-^pfHyD0(8HhP_Hf@hjYCZpejNAZm)VQa(qNF?UdyjaeKH44!R6OWu|9K& z6wP?-Q$H5K1xKbsK(~vO47tL8Gd&ZZ=e-0&l&{`hc=nJFE_C&SnoAlM`D9y~`#~H8 zs&zY3Vtu7Ru2tGFz7^eyQ1fJ505y}taIb793QeS`5CZCfl9iB9|^38@22kj#8l3+Ggg1Cb`jt zSa>1q;3k-NUUE9rP$SGBH$LNKfn^zf>n;FO`L#?lC*HvcL9Q2T72F$x;lXRi z=9bKaf0cf>AC?5B1$fZd+Y9&i2f4wS07?_n4-R{Shl?ka0&q&suPzqLT{6HdE?gB& z+@xUm)1i3x8^lh=K|*Y?D!R(FTW9P@sGC$)nk;<}my4lz`}K4bzwp~=wnD@1btJ8- z*$db}GAp@6ZAG#u;76+dAO))554SwE2y$_P^vHudF0tUCj65*G5%Q0w@uyD3de;{_ z;qnm3!;-6WNGe4^tWQVweJUt>bj9eOY!^a#StPIP{68&t`>U&G9JR18=KsQQo9*tl z+d=7#<<@$9;66?hn@Ek0v*QRP(QH?EqWWd`1o(JB`o#6Jd2a@i_apd1TGVGvG6Tx~ zAbsSQkEWvYgS3X*E>WVp)s?~EwzNZ6^&8Fd?1cFOa!z;2t*O(!y@}hEP$A0dSnuLp zdx1uQJBi&S;E8wV%yKwh1i)Wbp%{NkYSa(^o-R@l>_CxsoHGk7LSgM{phtO6CoiQDaz{8!sJ+f0;jBJ;_ej_4(nsS)ps+_9w4(P2y z*G$fH|D;Q}Ck0ABwVCe@1cW#uAP^k{a?x29l)67~UwLm(Z2>A3vNJ)xTL9xAVE9TaFQg4GTcBdzUrRW= z!`>0N_zMlvOQk6C%u1P+0swU5%Ai`?GfUqS5blQ$#?aRF5<39QowP61qd839fye!j zpEb8(IMHdS8|MFX!1Buaw}@==T>gR_B#;1+S)_EsT)3t?At;le#Vi9|0$&%U@zAR^ zw{i&GrgMGT3NyuCcWe6o)wr&TrqaFo_V?E<{@3w7y~Ef1a<;Vo+eGslz@z$1@vUR_ z0T=nAwai;sg?&QNpJh!aV8WV|7Ii}>Ah!)8xm55{oE>@V*(J|`tzF4q%Dg^N?71Jw z2dlRYFL+!U)>r5g&eb3vwmcU7X*cv@u2d;)JUL8J!`6Wjw-B$vPZ!h;rd{OI*f8DK zn00x}5&vJr=l}RzVsg)Ilwkd@YfsCRK@cQK^k1p=Cs|@Q3l}>1nbypUs)q3u}Xjmddqcwn)wyMi2qJ2@6j8pb3F{}9zICf8l-H&G>NgUcB z*1P>$-+u8c%KthDoMD22n$J+UVU*)q|FGxTYcWgV>ba*9r$uN0Z3+B+s5O08Gw!8t z`!9FeyX%_^UpR&`B3L&k&5|ZW6XF1YSu+!ILW7H~wFuRR9?L7nX>g^X4jwC9d}vfAVs#J`6cxc}w#bAHYw@TEr-gf5}gANDZi>1_z;s z7K|@6%N~d?^b>3YBOQQN>7Rdf5rGi-*+kFmcS4k7(@|{++ zN(CIm4Cy-wCb`pk{FP;mIVQqnwCn2_Yk)?xZ&&rTY#r6d zK_*EEH-{4a#c1^xC3{A#ke5^vWeM^qe%0AjB9_+%a8n-oNRJ(?eP6|zlrs%tm2%FK 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¥o%Ts$>;c?%YF$w=G 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⪚faX5TO%KDM0;@ek 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

YaVF$;v(*&0@fsNDtir!Eiw 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 z[m^{F?$N0<>;nCqi8>N=m^t@$7tD2V7#4^aH!K9>vwZo7O6)ZFc@J<7;?a{D?B z{q{Tj05!B1(zmzkzIRf!C z_Iw0#QEZDIo+ih&_^^I-d))@BRml-YYi~F`Jsem`Yl-rb9eGZb&wusiH^Kvo|9ur1 z3cfEe(1iApMSm?YPG!_=4(>M;OVKzvGRz}N7k9udrW&68evhW)AU;ThxOse< z3vb1*&;#>=)Ai!Uy_1f&@jbs;ZqGg?DvTBq)K?9WvoGFU$5Lh?-|{R4=rYjE zrG>|Ceu1K=9d-Bl?~N8K^IO^w-Cztof%A3p)My^L-3&ww;G95=g}6Lz>a}vV6VFoW zUBeQ&PGJRiF3Go;PS%g=C3g77!R#xyg~&pNXWEUwTvV=iAA6koafW5wI zLN%xqPAF~7A3=EI_VF_L!!WE29z(3T1O-KDb%TFoOw1pc6LcPf>YMn%ePnwXM$aeK zboW6x9&wKOTtHZW15_&#vTv!bQ_h3_krseTKMusv+A9&AkA(EdEWS~$8fYs+MLIc=j%7!?^+rgNNBe=y~U#oloipa))*O{h3m5@;z#05I1>(M+l)>!~fepaOjFZ!B4DzoZ78(%$(E zzMW$sCr`Z?YVK36V6ULyy#AR%6q6YUQ&q}hG)?&NG^FDIi(L~3o=0sKbQGOJmR;)) zj1FUQ+lTGUV!a%u+m6JeGsZ2N%*)w46)ibtwU^YcXG^jz@fz4O$La4~6}txsBf@l8 z>@lGcw0pX5e=9z^dZstG*flcir^yMsYEZ%VKlD8MQctIBSWLqY9IvD*Dl6P9UCIc=eo zuQd)5Nzx;}Xhoxbtc+KA&^%4^#Kl9J65?}{8aYwP*5qVVxE!&$HPrnsR~Hw7^yQyy zB;X!SK+DPwia!$EY@bZ%_k)Ti6(=Q77q*%AqjziBg`pp&C4aCuuXUdr*29}hmoc#Q zJ#9acr1<=rOLfe`O?Ri)5vjmGi4$Qp5K)9%;HtioK4(WK0C30dtJ+k0G%}9cO&QVK z&wzpp!h1agHA$;O!BNQfzbK>355cP#?8SXWDCxvP;1=zCp)}vL@`HUS zR78xA)y>Tnrg3(4aej}6{w-KTp@qS=ZZFi>JGkkOPn8oB6w0KODxz@|+rO zqDW?3v;OvMx@HMI`#&E;9-{M6=M|=<;C^bSlXb(w8<2`KCe#@#E8F1kmHS`lsr(|Z zb0h^G;9>cblJm_!ZD1wu6rtZ^y1JX!VsEC7zcbpFiAOC@QVEd&4}(D+5nwb+tt59GAAmb(-D)AI9as~Y4GnXO2W(%W#7K?7VzWN|| zE}J@HvtFK6O3WDu(;AZ4D&@aFUk!dB`(eQ~?KbrFmnp~~09rYXI&*0z*qrDR4vQ{3 z$)0s^p4ff?PWl#JN(d^;N68a>?*b~7`0=6y(~8YXyQ%0$+0J>2m0YTI4e#}3d!!LI zJWB)6wpIS1Z0ddUVU^CidJzD=?u=*dCt`_kG9=fP+CP!gkEy%#ZdXkyn_YwH=ahzQi`15xBG z;Mr9J;6a10@cI5`hLNt|tL!*hI|zj8x2r<`3l<{*s8V&J7B2FIN~Q3fXB$R9*b@)Z zD$V2DMx3~4E?(Z$7WWSM72)8SUg*-oOL@DarcU01MTcW8-NIg%`K}jkbO>U#kWld) zQcLssH{worx)K9|WvGuK6jZbFV-}_Sa9^B)lYLK(7lMXdX_ zB#CIK^zYRdtthC}Ome6;Wbos*QozxD{@LE+h}fQE0pDNDC0vJn{FFE>22gxMjBmJd z)d@7y$g+8bO3&uvHE8tX z;RoHqA(zj{akx-u-G+$lp)0&kgKX>O^AIV(J{1Bri0paYa}fUW@G>!% z!TROqgfphRkEWg47+(n)A_TK*pTpCzAOTLhsZqCUUG_2X4=yPF4mg@~?+1S)GnWj$ zzw?V}zdR%6jK0&bTHggtf$jf9l_jh0M(+Yoj4w{a5fYIPnkEX@2F?JT2N7LbcLsYC zfipQw{u~0C-xyCO(zVg=#?*a19B|LYEl*&eQdM^zBlK;dccE#8ei$3d@-wvA&Ok&1 zmJl+<7ltd|nV<1dx?fW@y{2R7yNxbE@OuGug4wg6uA-+9A6PTnuCOTVE(5Zx2H2Xb z(V@ExRIPfQkL*;Mq=nH?dCwpv)u2;d-~(bcre2E!fN`m0=b$K9(0IU8iNI`(Opj*q zmuwH{Fsz;TfI`0lfH0UX%B|3 zY_HsHbA!517!a}w1oMJ!QV&*=yd^KSeA#nntiM8nT*mzX2 z|C2l4|5MBUDQp--Bh-n^l7ZKMjoEPp;rh#CpP(6=O6BQx3d4kkT$fk zm=8HGeZSyPB?Yt(UiXJ#x!8*f`kbl_N%!&B|A{)R1;Z+ryWXP9c4Obg>j^+1i(snK-n}k2A}ERnR&@u(b*^c7;!MIQT^qL6sz=BdmS>i&;uxLUrqN`vU zXb{nwKIM~lS{fuO+A%~Kk#%c^VLY4LmJ)dd-d@(;+20V=0@VN-9Nc4k@90!6Lu=dH z;6f2p!HM~NjU;Df3$AS>rDT!>Pkk!-Zv`?0_D<%->SO5LO-4vEw< zAhxdr27`@eiEL!ld!Q>LuTU+6uHHk;g(d@@^@%T_s`vQ>{B*Z|6+8pqxORvoG_fBA z#fVYU@eauG_T~KagAhT5d;HZ|?l_1`N?gwBJClE)egSL~CPgTqlP~M6X4w1`{^|yl zrXV$AvqMEiEU`Bq%atpd$|sTmfyp@5Wl0QL(NTuS(^__SUsO2EkC+Ch z-+AQ$-g)sj*88AfT6=z8h%i@4NQBL>cRJp8^F13!t0(|W)ntURy0=5u0UEeTf!W^m ziAKRPu*sI(@jRwZVfQnn^@Ft9MhJ8zjlAeZ#=$W$ygby@_`pL}WJyOACRV?_{R>b( zeiOE(`IgQJUe>PtV8OS3MVrQcG39hd=-$g?x-xl7d%HVUjN>gVnced$E<Xas`)LAy%+fB}{R(=1sU6c4l@+9x^|MUX1f0BFWBJV?Y z?s0|{my(RbuFPEOi$_?2NVCLjbjqwj;KC&C~f0L0qP6K(3Q+So)qAnNits+4IXDUUz$Vl_Q8=mzN3-^Fa z0DT<}8~#p=%MgIqq)QvG;8BO3H`N;$8GEz$b*XUbK+(?S9UUJMqecLR5=SrSvrOWq z@(|NRKIcvDx5U;1ImyT;N0K7ThwNHD7Dk)Pz9Kv@5%XkmrsizFx9L8U6SuibEfFS# z#rq!Dd;Amrp5^Vn4I>&3Q%qnuULeR2;DwyXl;>4vEOrvt&G$NIK*Oanau)QNoEGWgs|#lF%Lx9?|9o)`zeX^yXklQHN_cSg4H_$B5*1J zizoWrfKhvsOBoYd5Tfvcg}76u2^Ta%a=~#-jPz(3|1>NMxs_YMn0_KAC+2uT84Uwn zFr)Rmpfl?tH<_fx4aleBy`VE%$Ikmw&V4JrAF%Ad4w5GC{sAOb2ox&5wtUHFeK1(C zvvsAGuy*Pl`M-kW=D{TjTsA;Q|0P$v!gZxsb%SA>z1xE3Q<#v}@2Z}%n_Yf4jOrXZ z_v>j5eE@}_=H63$DBC$2yoxOjXal_x`}NjlW;A$+Y_p!@{O&b)JOuf(a&uT5JhZi& zLH|eKB&kGcB0B%oF7XD=ijtr(FzvRN^Cx?`m~%p0J_F~&R3hWL5rpkTXI#m5u;8-0 z7}nz^%udO=*0f|07J`OTAZG1+MxSEy&^ePv#CcjNYQo#BPVhtVK!2^xSOmkkV=2Yv zNHyw@`d1D{jE;476A}qp<0V)=E$(8V@jK?E*#{yg1R=vS=w<)X8DC zBw5|=Xo9qQOrg6rgQ223Nmu3Mt%)_i6rhhqQ{2*!1Kj8eF~z(=ayXN8jvdj&paB(< z+y!$Sycs~V24or9-HAYcdva>*&3m+w%CYj%UM6cJbg&zsK%k%~JSz?J*IZiUUMWn2C8<=hCc_5ewF0wEKl zj6r?^G8W7f&30jLr9M#3!n9y29CIm2C&a>hns=67e&Cb%H!GmX?$Xzf4GsR2TK0;x zbi#_7O3!e+GH6~s|LbcC|9j8@0>SWQ$%H_(i)KvblyV-Jb2oP8ub&rW9t2^(d4l&f zSWS?J_O8%TrDGJ|-}m2IEL_18=;dh;Gfh|oy=!ilDg7$5Y$1o{ZU}Jo42D2_$l`13 z^0=D#K8=BOmYk@t?pwDvR-TfcL1(*k6?&ho$Vf>k;wlqBVIrB-MOGNiG7y@IQ)1}W zP}(u7Y?5~y0)r9AUT5y#>0gonq!M45cEV^n={aVEmbWTYNaJrz(G3798FeJ+8KZGA zHrxe> HL;dzn!7-7K+VM+y25085#kd<~ayR3A|BD7nG_HB&zZWjW-FF!06od(G?B!h2s+Vz921xx|BlE100NqnWzCilUrCS;Kxm<(tD zv`w4_b?{^7vfVDw4*z@p36(%_7fo4QhtlaaWZ5}O!w=A<9GQNgAORi_1Obbof&;HlirRPcH5Z`W+a+O57-k?mN2_PH!9W& z+vmSa2sD+T0f-E(np(@Z)Y}tW=4q`0O-mrRsYxIO%tFHGYq95{aBT zfX2MtM>S_$(%kNX7@X^mxTF#a;1LL96va^&AwHtg98!OboTVB{N6TVztLf5_Rbzb^fTVtnE0Vbg|?;ME|h*RRn7^Mn#(;D#i8X`t8+8@K3$6-TAul zBFFXs(1uJH{27)^nw_i!8bcw=k`_ZlNreCx-d-NsH3G%{K3;L`@P{v&@whA=@g(VW z(@E<$ZHo@A$_-&KSWMnHnbXDGm0ugG|3Tx)P#`+71OI~iL6dW_F+V?lenCO7$w2%| zV{fO8frR$&-@muYO0;+Bsn&7Pq`+V<4fmx#Cm=o|S3T%|7!&+q_v1}OWXot@=&bOj1#dU}_`Hl*OKmWR6%xmFl^3>F82;hakKe7Uh>Lfc zjFCG6L4w=1ILxZl@!7O3I1=_-9`0RFHqMR=+}$_9{prgT78;tYs;a85OiT!1n!BL2 zlB{f#PSj)kFN#k0qDDU!ErZ)dl!gtth`>8cyWZ#7nB#%t0pQOLVC;YUujuvV*JCxC99lb4e6 z4Py;Mp~T!Z6ND0%u8X*ct0iUY{c)RXYX$}eh1yN^2XwNuQSARPy0>U5WGg@;Moo5a z94AY3ychH9mrxO5@}W5QoWIrW4?j#qCA_Eo($!vGD3*>1CThmHnof??k*BcFCfA|o z#Cb8?oMioIbJeMs*>&KTr3JK4D@2VM5B%b!@lc=41wS)|X;K3w)yL8CnDFAB-Xt$Z z$r=-M^$WP%PXD2@dNALevu@F9a4J&ByWPtCI)r;7r!;;xl|Mdn^EA$>Aq6&cgPJug zd{g*!7-c7DWo5;)1zD3q*ukua^65b($3{pg#WU(DaL?*gF7IPGbHS)drTVSF<0UAW z+=pR1=7)V6Xp`6Xm7JHh`ud2gcqk1E`!>Ao9UTDMMf_>OgKCN?lH{7%IEEL#8BEWj zz{$0pyxFeV9(j@xQ-d8rqvvKb7Gvef*7AF?rF(mO+w0+G=|u2h>>XQnZf@FzD;Qgg z#*Fu_1OxemXwa2ElufmCx$yuO6VqnVc)1-R{>>PmCtxlKb^nmr)lHv?9`J@&s4_Fg zpgbJ;eRVaM{AvAR%bUT<$>ugi2gg9fAx~lZJS>wjrfvuiE zjfH>&wUS%CNXI>qBz$+OxI%kD$8~O^!JgWX8uLQw!i@hJv$2?{6 z_p9fuu${t$&weQiZC>on)#!F0Qq^y!x{EWS4+ZP4kA35!qWVpGO%hS?2-1QBXpJ(^ z&+%#bJhq0WrPT5&=T<|c_bR>gD0G;tz|vdSJc3=@RY~T84BeR>x9Q-&C8*;P@fFKg zRR6NFvaf>2$k3*%jih&RtP5b|@crG5O0g!N^S);8ctUcr$CBqouom^{W4J%nwAB&` z{|In7NUM*nAlq(hjX+(}l8DRq@~Rs}x$uV$V@V6Sa9GZZz(r2(wlK%TZyrH6i$BwXv61~ge@=DXAfzG^ayy+#GgNb0sCPugV|F=cy0EjiA2hND z`IRF`w=Nc((=HIjFj1A^I2LH;_0iNT=L4iL&le$826ze%VWTxnAe3Iwaps0va!r$6 z(H@k^UOCH!dp~^2X1_X3Uc*Uo_vU>?;w}Ggxw_vp({3G%hpbYlI(or*vN@b4;(h-; z`UxuqI_Y4kU1|m2>=!-_CMFE%-vr;5GXFE;6F{=4f6fG88f2)Xe4=sBK=I=@I~NyG zh4}i-T%#~vT;!)D!=QsNft?IoLf9Huu__u=ujpEI_y!{|^#PYnYntOkPHH**m$T&# znCw;8%pk37Dg19?pmPC&Z?w>s50oU~=6q3NXJ~%SQNpg49r@ck?FQkZ&D<>JlLLta zg~_IiM?~Sp+svOj_X;`Miw@R@L7%^&!HQPH+a!1ws<_Wv_`?d^(MyXv+`4n$N+7;P zVhH|eU@r%oFvH2M#uMhZzl>`KdJ38tJ?`BFtzefK5Wm%J0PvFB%2I3;pj-Q>y}%sEN47|=cje|eGU z;@pxV0xtT+!Bc-*kb$wD*5B~g?0?aB+;k@aA9?ePQduH>OiHq3QkrtqYKi@O4J#Ig zLX37sItefv$Aikw2j)HnnFV4h63eFmu?_x<*ltf=JVp?+AVOorslG zTJm>CXWjn+ZJmogChhOnoY;el9UP(JlmZhfw32@hrl^_LQR-VH%xo6Swq?bH-x?h@ z1Sx!~#V()XoE6_q8Q>-xz4Qawi>-FnAH~@d6)?XbN7Z+{*7rLM_X4*XHJ|;pO-ja@ zSz>Z)zK9ROjU4*<$-e$hfYI2J z2lr0$FKBu(_lOenvw3fO59*V7!AB4(x7D1`PuZdHEeE|!@Fqr|pu|Li*^`d{hpfL0 zt1{}g$KefvfTGeNxd{Q0mTuUjG}0v^(%p@8cc_#C(jn3dCqgr?|R=4 za`|Q7vDS<+$Cz{7c7+(PYcxC2n~NvHT>eXchJ5AT^W-H5YhOs}VJLT0!2$326~raU zylHfy^grw_qMN(S_)stn?wzfED7tvM zPjazhT^?sRoPk)oUYb7z*LTALw|NWby?E%t$db5c!VPU44dyiUbGp>!!dk=kk@?9n zd_v)2E>JS^i91k3m~|WI8pj>CAdovSaN@R_7*iZE&Tx02u)-$zKJBjl&`L1%qN8sp zl}+A5Z9v}vLs9en0vSz5Z85X*;I*6qGG<90Eg0iHug6RVvX!Majx$e-?W9%E}m36Y0SI)1*P%d?S?`*vw+g@-5lt9ya8IZ z(wIfym2;o-4Yhubl-t*6+SyZaYdo+?Eby}#`hUj#v0~`NdERMGXI^(2OZ+?=4dHL& zEGL7_DSNI_+T)vBzX{O$4QoBTDNI`do-PCft$^Dr&J;DTRh(8kQO{Kj>E;)V1%+V+ z+CCq|IGoUuEKnTWEoOd}_zD|^UFRe%+)NPk5U^XFgB@$igh{NhC@XrwsR6~~)6 zZ&}a;p6L3Z&lYDK@(pf1Mw45shF1CN9eR*xt+5HTT8E=~u14#7$?^!pc8~)^CzyvJ62SwmkOSC^rC;Rt4ssK~I3! zOjH9cy(WR+?fuTIle^aFB+9|M?yg~nTRWR>3ARyS6fzYC2f`D-dNnk+iUItoKR*kG zguVpugTW6ZL_c)altnI5!a27W7MpX|cQ%G?-zNSP6@9vINb}r?ev@)cATzLR*LUo$ zci3$;`X}HKgj_J*$K#V?U;FfW`?t4CY>u3X1X(Fj)&q}IVhl;u$qj83DeMkomxR(B zNb=(kKD;Kz#1c6Wr1FDcm;)nUkLk)j(etjpecE400P$9|G_`fMEHFCn-&=vxXNUnw!q*SuMxIb(BbR=-6vY92Z$dH$cjwPB zP0%uJy);y(kPqS=mA=cwY~W-=Pp@gg*mq5h+;ih1oRFEH6iSAVQWN$LM;vWh^Y0)z z6zSdoM^nX_6cZDzs3?V1;t^z^xOXSFC>1BdXAPY3q8Xo!TsPb6Rg&+rka)+;0;N%H zp7z~KwRM|?S9Ju(`_YzAuE$h<b4rVG@)Q!Z2z>W1PVox0&n0={+5keWT)29!Pd$uH@3UXb6Zmj1^O8w?NK2ag#)`QVetBF2ZPhB{tl3iY1EV1wmW zl;8mrNjdm$ssMM|w3(%0f-VX>F_bE;+yiJaXSH6`+0=69f(sjypXzW|*sLwT4oqR- zWXV`;xq!89e2NB@L`H)`kh1HzmeIZq!dBM&$2rHkNkHQGSEnN05iw}l=r%`$kH`2g zBHEgN&XCSSk@zJIpU^+d=LI6&L;WU!cMws90e4Ai~=L8oAO5(Dbykid~b^PWU>QWe8U}f>dMf`T|#F%J^^&xlI5D0Aeig)l`ndpY` zjqnWBhd5W!xk9Bk2m-*|u$07{x4Yl}C_;xIB_&15W20DE=Ej!!AVP#BJ0sZ$N1jmR zZC9|LbKeLwR$oZj{OGTV7?sxO#0fwIyB4Il6~9;w`>69R#WwH}#5yXr)Sz9AC@5!o z?aElfcV-d1yi5~oY)o^Tjg3LE7mZW7l_ST!2@z10I1p1Dk;$m70Cd+8BL8 zF*P?(s`4k#6$1GwV%{YRll7EEo#kIWtAUI0EO;~99pCgX!1k0yVIT@IhYsX2(#qg; zYzQJiFvzknQSRzRjpt6O(D*P-l=~DTy3UvXF}nkM*39daO08k#U-jvEB~1x_vE0vkWbF{|3KhR1l%1J2?W_Iqnfa2QMU& z=6davY1`af`GH5y;C=N4Kzf{B?QI&P@D7T78DQW6!4@qTblBtsGvf!z6*#MZs1X#|%i zI*J6shxgJ4@7B@2l*aMVKMzN4OhpF=29ZOgV8ZXunV;+)JbDyN4)qiI`y2}K3z=Ta z>X(Y7g0JHJp&b762*kg%Yzv(^`@DW<-}`6k-GYKtBsNN|4&*R?=;U zB*(0_AHxOuO1J;Vo7*pFxT4U(8e_mwfCxYV%Od?vgCx)DTn0dI6&fgB5f~c_rSbKgtDb2LbU5@{^jk{h;zLB*W|8roSjl*JT+2 z5;fA`*z?rvb=zU7QTU7D*B(h7+Ba2P1BTk^%vo39=2-BXtE^DT>wMc|g_~5A^?F^H zh6&KNS1$0!-gm(xpr7S^dh6m^u(6}-$}i;@kEGUFWy|90??6^GXsW*p1(C!L1JO^B z@CC@8uM^?&4Vi98TQ_>yfryLummo64usNhYa5Nw2ImZKZT;qYNW%B2I`v-iN&Z0;_IZtI z-?xwX5@L*yz-dui7ucgLr8jtFlIXw!`n>(D^XsC4nvK<>pjswOygUN@f;qhYOhQ$a zufnwW;$S~}Rh(#~LAH&Tr@$>S6rO-@u*s18B3FGO?hCo}l-3`02*pjJctNxFd?L2l z%-nz|4A)|9ax)qpqZd#bcg*xE8m@X~8Ri7?{e$&6dyndAbAFv5mze%|Z5#9I@Y6jE z4dDw|%s@rLc>T$}RMwIr^gb+jMhHHEGl7BgCKZ|K@9RXI*x zV&fDW{ExK6DMCdtK(jV^!m1p@4VJoIg@DvAy(u^sqt!3Bms?ubu z(XWI9po3DIbbVLea8;jvB@j4$4UX0TSimberJ{;lchihR5;k_E<}87NNhkAdYUKC^ zgAoY>*bS}9$ouKLb5yv)*sruYV>K5#%!cYtU!0b+wQsyX3P6G|I}an{(P zK@|KSfN|WDj3N231ktg<`cezCv%h?%yJ=5tC6FKo*QERmob5Rc$33$?LUIvIR_uwD zSeS#VhxfGYIenq*v)qCPHo|pbHi!`7rP@DZ9csJS9Y(7iv;2Z~o}c3c@iDkS5?LBh zw|^W!S zMK44Cz4OgVrggP1viD%$;u;e;9B_DxB0Uau)-6#^pYR_4{_Vc2Ch>+{B5U5Ft^|?> zJQ^#D$(E}$$isc=XIGA*oa}S?4-9)Y`oY1$(!Z22jGf-in-p6V?3bKR&1Tm(nA{eY zvSkdI;zCyJI})k2wrheV3qJ@pe9Y@7S&wWQ{H=7u)j@k2Q1{C-jSLaM2=F>JjYTrN zSRxPtG=hL9OS1Fx)-!cph5KbSnpecg^2KtIL)j8r!<46liUB8*w>STCB>A88LxjBR zwBFxuS+Or&RNEaHWx*s%LR`k-Wt9hiet7gpG*k$%B;&kJI^c|I=io$L1aC}A!MPJ) zm2!9I;`yYJ>@-3ruSc`{{?+cc+OP(oKr$qx?B-?DTwk+mvr=y+OqwVaESb*l znCr^IA=C1H9Jn$%PW%@kgZJWw>Uh!WYM&F~DC?s4&?K5nkA;0pa{Z6zROm-G2>H(| z(reCN43ULXZcWo#@~*3#`CuUX#(CHbA4j?@z52q&=0{J}dwrRBV_a0o4u%iS-ftf4e8P^LSmq&(*=R$My&4OuW^1l;em znBK0Xz=}((_~mB&FuJMKR4W+L+jY>x#>6yuQza2XP5$8koOXvWHT>vrCti_?tn?FJ zCy|?5n(&@rcC6^pE{mMa7+yvQfeDvx)lmycppoxu7M49sErA15+1f8RLAYC=cb|DOmBUj+hyX?!0!7`jR$_qEeT%xn-sJ|JZoKiGP?!IoYe9Gvar&qrE`-tQds@Kom+5CIBTrmFYmH zFS#wcZl7-2U9^ab-!0;(*bgx8AK40yc)mSYP|g|L42?Ou^H4*k9UY`K(KGJ zfKq^zE4$PTDSV;?V)79H50DI5usp}>EBjS$x^+^bFb0o^r}K2SHgz*L2w-gDPOX1# zVbi5#Uynnq=`k${&J3Q}B|V6qhr$%vfuv{vWAg!w{dXe{BkOh_S2_NTC~P~QXaBZF z2H*(t*0{>==T7QDv@-cODJ( z385mh>HFtK7E~1e0#b=CF64=ir2s&lMBfk(0I5U92H z1454Et~pbd^~X1eAV97^^yy49q7j{oIPuG){g3Jn3ki>d;n!FI_&n^hzUHctnjBjW zF6{lBX~S6~?`i}p#AjAnaKCmV1>jAL!Lk*WkN$aoe?NrZcmD~$9)HLDfyto$fkUhe zZO^*R)2C0{4rzFa=y?l{+Cin>)BBXu{m=0is~%@z^7I+?Wr;-jXP+RTLJWQ6u?H%| zCo4nb>|jZVR7TnhO+Gbc4C4Kp4K5PrThnx(beP9gi>J;i{0D*aV-y>oAFxd&#} zS_bs+S8rBVb|4)K|8KZNKiI;6fJ#m-FDJJmFA{Ye72yL;(l@N19|$AxLy}y3pI0i{ zjoiO=n$~95so0V;b4V<&8CIP&!6kE?)PAJr*c*nkneiCX<)Jv_zIi=e02Hpb(vFv6 zv5enha4wktwMB+L(rN$o#K3gn5hNFEGk0!!cJL#36|P7xlm8}&a~GVm;}GjpF$XiJG!&RGqta$W<44)&1jcX=~GN zi1HCxKyCIv-E($KOcua4Ad*3lARqw5W*3G1t*v>7)YnH_2FDWQz5p@v61fE%A0}zJ zJJ+gq1#G`(@OVz~WIV4<#S}u0V^e3neJ`zhS*Yp$71!e8?CP7w;A0IR7JR|~kYDid z`ll75Br1Yx3m`<5+j)qCp>;S0L_B+Wm_qNiaLq|COPOwn^3)`{W+ce>?xoex%)RX7 zaN`bTI%%z0Q$7(X7u|N*jCw${fIZ}(^16}X__MDa8^yiT=n1VapUwjJyOjDZN*nX9 z*2QmFgdl(>`}PxX58jnUVY-EqPlnqAO|V+Z4qsV(ta=5NN%}BE)DhUasFw!ZfWfiT8O1attLXqm2f5spFw&{MtEJ~f5MnZsg7Bcl@+<+n-my`7!6 zFT_;i->3Ir^4EiAuR?|JZTUmsy6-)b-3H5{Zel4dapdvquCJVWRDTu9G5H0uQvBV$Q1aqXI{>oa)z-yQ0D|+QoFU4 zt<0XM9Q0AgK3$SsiUpc%WlqDwx6$?bazh=J>^gAxFeZbR-fer9rp?XFV)_zwQW687A_G7WvYCUkv#J~$y3f6sZ}$1$o|Sp;)8>0e_I?kSTN|dL z>rY0M9T@{Jz4>_F^r5K5g)ZkCh1FYF*3=zhL|fcXCznSD;apMatgV8C69Zi72>gSP zvj_YvJz5@PNU2{-m^6xrJjTnPct7p1$SbBHe{<9Py&L3`F#-hf3<al2L;=Z;PA~ryhDvn;MY_yQ&%$DX`PAma7Kp<{D4k#s2<6yJSZ6gM z8))I~FP^;L8*?qm)K|$q?PGEh{A1hytW?P|DJhz`=$Sg7A;Ve#Y0~*m;llSXinga( zkz%F4%$tcC=kNSx)Y4;!NaLcEZ%^>mt=N)pdp!710o2bd3XubMy##yfPv^Tm&2%8= zN;nv}IRSfr_1+aJ!UIT`NsOS65NwUptfdsD{rf8?o6yp>)oqMPAYH6g{xD~ z)-4GvQ|WhPS~LxOc^?QIJ#dn5y#5WGyZz!znSp_GwcQ<6YnJ$z`=PKqc`bu}eU6Ns zPpWxwKsOof8h`OAY4UQU|C*KbdNbrj#lGd<@v<#YM4HkP-#r;`a1{Q@<>~fr77U5q z5WEnASl1n7?{~Kz%9bjXu2_mPvF^Le5O1(Dst_mxItCGq*AD|n{geO{M-Wuf!&kkO zp|*PhP`k^uDg5#GDh`^#or`Pp40&EwTDP0kHg;@$49^M~`xXVp(Bu`{jcZ56cRZO-E+w;Q1p z6z%HPk^csTK0u*?>^n7p-__mS{NA6`Y=Rmm6lXu?|8Ld`~9w@##Y$^A8_d& zT4P5R8lhg}AB~Nv*>wf1nrrg<^5o2lXFaC2ljf?OkNjh?Zi%qGVXvqDEiH`9Ob{3- zyuD)ke~TBe(g^-wrQf_Cyd6iKwgI`7Jcw3(&8N9Fys}@T(*Dc^8%y0J1p3@zjJfbA z-^_^0-weJCOrBQL@67TuQPKbIpOtB}3d@Bl&Pl?OfAy)JMssncG3M$@`7#$q^ z!e?usm3dzMy4j5ck`F!;>h%;qn!YN=4u+Kg_ZV<7H7 z)aV5oO|RmIJ3?NhU6&t~sJN{@Lt8N3s@+`*-d4|eC6XP(NzgQE#Gv;oA{?766FTPT z6O91K0ZhP$LKcXqd)_qW3}_jj{KQ>lD#(ok9z~gln)TFgEJV%42>(BPlpQGQRsd(_ z1ITJ{wmV@D^S&Yxb3mhuDI2r!W!*uj`OYwQK|lH^bM zAwyk8D`s*^`0D~8srjoo95Fx|hVpUsblD6_a zxPDRizpRp-3wD$do>3t!IJs(tb^4#h<5GhPtCaBDHZ#kO=fLFMyg}8;bo=1-fj75B;h<8l4 z;#tt&b+G}G#EBk+bpo``=i!^sDv(qlkjBnXwp4C`z5Ll;AEA3~wbLUP?3D=AfM2~k z1zTmRj_NO6cjz!{np+S4(boIirf{I)(WuRtGMa7DTd=5=eV6YKt#@r#KjcKV#q4Lp z9xTcdsQzgE)}6_7;3Lqx_84sa5rlzcg@msXr>-V$?S%WZ4x45Q0rJ&%s}_ngSo|1%|YJQ_VB2)2Hh=|9XSaH#pgZH2vms6u*<~sg`E^>c=!1 zLK1jGO2J{MY6IM?O|~8| z_~EkU=gCoYPB3O#ki!AIzI8p{e;-uNQw=mlQHGagg$+h?jbnNWUoTF+xtK&>>HBR` z2K@AK9&Z26Nb%Za@2R`U2E0PLiw6=0Vf#Gh!YCAV5fFPM@F)!Ns`k*W;c|A-!R>h3 z;mOijRNZg0Ow)#)rsLtvVLU|p6uSivzjdCK*FsTFM&zp_Gj<-1xn;rOO)%OE#(%C0 znKrKF*`sryFg;GaS_KZX*1|#hNNCQ?Z!IMfXq9V*52cd#2VW8qR31>3oo&f?*@YkQ zRJR~NyfGZR;#L5|WX8s8R%3ooZ*tetid0SMlQE?}>~Pe`>B{ytL7y=t#=iZc>O|5* zJWgQBdV?XxG1Sh;V85?@ZYgU{N46f&$lyHlaQ3zKmmMA7j+Vk)Y}yNqeWh(a+%G3^ zZ=QQ8UoDpf-aOsf^=yWJ`zc?v_a@G#hg9(Da#;z5=xS=Q9fC;K<4W zCu8zkI=UT#;z*7h{7+&`pxh>_art7nF@bCl(^9^#$78s;bHdy3W>R}v7B;=*MtW0p z^R2XDHpJKhlpnF>Ncf<#I)}Z~V*|>_s zbGo`OuTJ(c_CWD%Q`ditjthhk6}S+Be2!$UgK7)d?v3ByB@bb>f5DkXwQ#}bX8L&W|txo2>2<;)X7816cOYs4CeuN@z$Zm zn-$eXxBGo!fa%>U3+exQ^&%8+^!(rTxNDkM^2adKlGO0FE{i-8O~vHJ-*J2lcX>Lo zzlBKH=s#?WL;>*Kgqkf596hp+E(jk*Z_ko+?frAkc|$w)(*bo} zp;iP(j$oC!^e|=i%{<-YN5hxGKavC(&Z=MaHs8e-bxb6mFwG6>&t7MNMD0w@94aFD z7nr{|-2A`yOUj^@7RAG94^)fLr%PlS8p5#o`0^SqUG|_S6uR|}=LLyl;89bEt!!)q z-5tW@P6t<&@mIsjZv$1!wLzPZgyNtfRg znTiUj(jm#e!q`pcv{^S#I5_~A(HOb`^ff0*8qfpaSP@{hIwmbv?#*9q$SmUQn70m! zeWSx2ea<$8>bV;~adDa6oUOi^>zZT%DVRE4#ci5QBW}5Pe}mvnZ5sXz9)*&a+z=Hb z>faEI*HIWE%p&XHYgPvt&8@%7Bt0Cm%cs{g>l>F>cAzU(K+i5NTg~}JUTaarHaBtd zPh)vMIdL&kalXz$L|NjC9RFv)ECU+QuO zn*NkpU)sW~KHe{}tu(>xg+J$&n1emr`HZPCTx`@IbGB3CaC=$NnNX8V;Q|+PVOd%i zvKl}!K={TJpu#hQV89XM3P0;sE`3WLoIQky%r5yjABx`NQ}_DHqY}C9^cUw6UxaBk zy&QQG9y6McOM<5sIoo#FtfRL#H#%|+s=7z9Es{U`7w@dyT7YAl=kIebJq3mwn1r8y zG;%(%e_3-fsN!ZNAYfr5>@H=uKUS04Tdvb4ixMx%eP76+r^9O?xycDU2|*S$c%zH$ z$a8YMp|oUtYXvSfUjXS$Ww=AY$?*;dJ_3H)Jk*=F=~p1q5d%Hj#%3_ZF0gD@1~&Nk zbS3k5`V}cBQ^DN4r=#c1exngV0dDb8A0vfQz`C(=U%Wj7DmUTAbM3@{1y;TS3aP7X9Z zx!A}W+NJph)mRkKcurln%DY8!l+N}tdD`_jjrS&}5wc%66I=H8efoC<@#6B9kzqkQ$=%K`zb=>-xJ-9v&D{2oh6XsCd#7}&im21Gt z>n4B5{i-s(ns`>(JL%GYgO86t!$t3)D;{@IX$idiuheoLndZe5GIpr}dZ2tKa~!r= z9pJVE`}*X=2QYzXl5&~W`>~Ht^6ZX8gqo--GIx1d=Jej_Xd53-j*J)Z3?|g)sn$E@ zQ9(+S_K~NYMb7r4si2Hhz&{;}zf@eRVXe5evKtepP}+#K|CT6KgXc#9pj;-P@FCu0 zbQ){E@3Q^ORA8SRtNJw>#0s=+(Lwg?K19S!Ng&$Z_4GsykMXeU$^;^9@drYRyxl*& zfFl7#(+x=j)t!~$<@NOQI5|QxBUc+6;pG;Z#_CT)Hn|e@IN6GS#>o;j9q)tFbl5FE zOT%od&SuaKBhyl^m%}?8?rukpuI1hLhv)!Xf3dlyA+@MU!OA<6-PqvrZuUbG{lRU# z4A68GM(6jzkf~{#1Di6(Jj?m&@hgHC@9rXvHiqapdtdn545f}lj!X1fbn(y6cIvK>e8AL|^mHB>tWI8XjtS}D4+mgvxz-Sz2p6FZG8JW4*}qZhR7 zWhix;cWSn<8;*1~+_QeulFSL!U*5Iby4zprFaCa)jjZvs)ZlRgCtLTyuxx2-)^iZh z)4i`*y0dmwQ*I)h6;US57shi zM>*F_u7sjXzrrhJ`1s66_GmyYP-`NKz-u)nl&x<2J)EQ*M9^BG>{(|5p5pT_mx{)O z!s67s=IOl3t-8y^jopNI40`@_0?oTFt~!8tB^ zrDBS7045jni9i^g&u<)cFRRxVbJ-5qDgw~*o#30hK=nM0l(L)Zh+sH8qXCGa*M~ zCQJq2E|;dZ>fg+Y#En&1-HnRXQykn$;44%gRRV5!Z+W@HsKUtG?(D4%2m*q{7dc67 ziJ#H)dhx{vy=MUj0ZahG0NQWP;pFJ}GQ7Q0@?H-IfxzPbNdMr725523@Kxsvw>kQ} z_2-Pt$3xY~m3>lVTjoAO%BlAb5~56)vu+>PhK(Z5wSKfzoE+=iYwF3u&_w~fUtPMh zEB#VZUUUsaARP|1^Dp<+wY!XoNnQ&VRc**NEG(%{fuKHi9{O@mkj^e=cFu6bz=`_q zRHDSpu&bVCr6cL_WqXLK-P~{^Dk7cw=l(}D!N?9b>D$?MI}Uo7(E{6B2a`Rw>n$e#F~X zia6{q!*E9E)D~GgXJmd-GG*)!^=}0omWB^R52c1~^5HOj_HLcq9kPEg?4*^@MZiiv zC6-LkV~2p^4_9@z7g|V?A3gol-j!`7SHlnH!$oBuY9eB(I^H5Ob2EaW?DOe0SB~^~ zK&_iOT~ibMZ;^yQNlr`z0--6;%`29H6bq5G6cL%|P?MQ;zD_=VMRmak&My|FF$!K* z^UMcz%>^9~nTOh#>msjKTSREbFY!9Nu1~L!_E!BnCE)Gg{RcFD(a!+uz^?KZUM&j!=#>d3_}pzjc5#slZwPg; zWlbQm*t3JTCxvlx1YgVLV%9Jfr7|X%BQz@0PaM;@dPW`$p0zhMM(cOFX`O;S3Gm_o zo#SN_EgBD1j#<@klVqSECV9@!0a^&ek0JoNPhG#7WNN|4_!j{cvA&|@)qbvCtCj@} z$Kbt}$8H#xvVyiTaV}%(5;yzRJjt`b5n7%K`fTdZ6zo#_v53Wn!XN ze9XzYAL4-aEDU5?S>h^Qr=Z4dkVR0@06!fb%7LMn*n4^y0o}oWrl%3=0?3DX&?a2j zD+a7zO^!^_pNE%_&);r2t7^Sf;;Sl+5V@N zPcd^TXiTv1(T!dcP=g{u!JvHbNsBrK7FTU;wl=(?g**<`@0?EB8-2$9MPp=fjZ9aA zWs|J2D1Qqltt*71pvGhjkltcMBVU5`-@?DHmrk>7xkEBFI|zC+a6vc1yjt0wN$CZi z_rg|b0uy#edvjorwHA&iP<~Jyx!_;Hea3wG&*AdWG6z`w`4R_mQR;oL2cgC>fO zu0uG94ycaT4d;Hb?PBlh-#S}ZZD68&{59Fs6Eu_-MJNXI5vu*}eq&PdzOI?K7M$9Z znjyh@J*JZ;^D=<4__RtrR@}V=1<8>19 zJz{9zg!1;vKo}3A)z0q@W=B8Wjdty4WZYNQC;Vck{!S04Bf#f6s7cV30O#h1&~IJ^ zW1JKkfMiDij+7;?(;FFBKadZtZt*CqUmPSm50QdZsh02DpqV9->S0*L7;|%d?=7EQ z`rz74;J6WQ+D4fHdz~x!ajDHu^wsz-v!lvZ@4wawq=L-pOi_tV7R{swpx!7m*1NlBM@2*Mrz_EaN<81olw1Iv9Xn*s_FEKxrXR}I`^+C z-iCb!Hi7heO8w#bQFvBEH|xz(9|xo4Lz5D$ib(p*0f|wjl?;m`$hzG)%9X}r7hB~N zWRoVo`BU6dNf`EWHTgu60t@NtXSzkyJ}bW9tLG=*66w(C8W^5s5CV6625J!)K4*kD&1o@VM{LGDmFO=oASBpb4KWY z2s>(^^F(#27=Xi1gGW+5I|<~f)nE!$urdZxYh1kB7#}Eq$^sTI8=o8?bsrhS^cXaq!gQ=kjsXskyQ$zD>cg9@rQVO>kmnPJ$ zi>>Gp0Tn!8O%C0e`BDSE@QzXQipF2i-Zp{j&Y_Vhu~%SbkDJN$aD}STANlS#d5_(~ z@%52v338hP3pztLKXX@!p84D<&LJbk5Y-!nHsbXbTL>U4MUeADl{aDmfF9oNFKPgR z6v5HavyKboN%oQRiti+XyB0LyNZ|x>C^{?PwI^8~Q*8aIu5-CoNcleOWqR^;9M#1w z-(nxk8GSwQwlYJ2_ufJu0w$%XaGg|vfYP)fk-HPZV1r|55`K`el9IY@71M0LFb}#Y zCt2F7i2L$}sY)rl&mFYt0YN~Ha8gf}aQpV_MC?l`X7p>@Kd)@Q{P(gCG6bcsk6{*d zVCb?ed!wEF4#phoTk-OtM#V3B+Uy<$!iD7NfIc9~3#@x20|V^{VQ~QP95(0GOEiSi zR$UdW_OzCi90*gKkRZ&1U=Rg70c<|Y=PdCc-=C>3SCQmbrOHUrBW@ zfF;r(2z^gZiLP4tPYxd?ZO7bn)9!+~B^R)9Qv>yz zUSRm4tKw%5(8Q>#Wx=QAAmn}|i9F)O=DFLBFVbg|6Dv7Mdcbxlf$aeGXfXI{&Hd!g zJEQ1LgN{~$QP{}LI<4gv|4ROUqcuT{!?(m|yt)LtAf(bZ<${lN6A)rGmlhDpsndhk~TRR`sa0dnIJZkpq!%VGg*_+7i`Jjm!(i&mzezQ`q!$UF$_G>D=VFE``w<|_ZLES-jo?op~4TvN#7_U zJhlZDzi#A;PJ3Ffqy3*sbVW)b1f~-)q~T3w5b?0mob2%Gj1`c zLFW}J_d{T!YzMM-TNC)b&RoKA$EP9Zt3l9)tmKdE`NuvY`@VHrYs+<~2wFeBwlxoZ z?;=oC3(69$G5Ek_%LVTZ9(9;22%)WT`O6z~IoanT)0zPj5WS64{5eCEimvi1T@k*; z3BnjWAU^x~F;i^WRn1Ro3TB>9X$S6Md=DkVM!EXegByTz?~j&20v?P7fPBb@R)s(R z%5Q&3=*}|dC}#lGo@=9w0*a2nNwz!4)BgU7OdSIQQ;_OhTrh)$|^XBU@Xe3 z(#zLR5xz)YANh;(I>Cp+AbvI5k;ieQ8s*u$JF7{ct2^TM>Ji#c3u6fkVLZ@D|9m_z zD5q}pW;wND-lIOT-YZby&1(Zj&t#<3pfbAk*BxPr9Jxr2`I1`+S5b3mEFZR!ly-sT2~=C-LfhJdHP zqm@9XtRF`$oS;HSsQf3jz0WkHIch?(QVV7b%ccEY#+6$ET#Kzzz_m+$tKYog4~+K( zXtRakYz5GugD$zMfBE(^ao6$~!(74|OmO+Q|M%ER0kQN-Dh7 zRxC^=)Skz)Ud=lPRDOfqmeX^qOB2kC2xy3Y4^~JDmzJ52WaOUc+4bxc7k!H+&Badx zY~;7=qbqKv;`>iV8I@%Gm^$iTX`j!{DA9=iV77m^o*C>58jUrReR(#f=k&zRxXw`! zjVLKpPV8ly5lz7G3#c{xQXiq|uR9+4u!BR_I;~YbXZEh;oIfc>=dD$?bF2VJg8m&BuPkw6ou$Gr!&ZSB^4l1gH-m?-~A zEJL8tx{@ii?!KP}l-F4kmEJ*`y%B+Gs-VMd%;T2G7tGZXIe*9T8DnQ_2W&gV)Z~QQ zZ3pjcqCAN78St-4s7tb!8*a~=llr$Ur z09%ZCZTg+-U?jc?3d$6M&A2zEpKON!1!jwaD4;|)v5GG%9XtSEco>j@*JI8rZrzUy zTJ);_q@VsfINjV5e;@@5wh>9_!(LqwJcFXa(+-4u1@JdO?E$^vA%$CB`Fmy65d;29 z*GFT5;$Dmq&s-{5UYjHO`hm^K5z!$8zd#im?~~~YWyg$e>9s1@d}0SC{I=%x)g zR2>EF{P6GvA&>jlAB2SxNaI)g&Woq-cTy0SxCw!m#1Bf}K@?!#d5?Jgz)%Hv3~vk; z!Qog8%Yw}<-l}_;+1*Amo z5^;(@wU;GcS`NKlPB(SM9$pq*FM5o6$1JHRQooK6dL{765a13tB8q$k11}kOycD($ zICL#`@V+Pr~S?QDs<1(+r2l-HpR&rzlCZP z5T1h;6p;xqM8=E8$5Ms;6x=grQ75@Pm2KQM;bosToAt2#!j5QiD2T;R4DyGqKW8!mDt>5Tp0R>zgfMhAD%u?{3or>Nbtw2E0q+8)DtGbSlNLmhhzhPW}s4m~A z*F56i1%So|vOqk6g#);B%4Msf-K$6}8N*>JMZ z{RO^^2ER}aZi*m70zK>)Q(%}3bpA+0GcJFGHx7W2eu@LRIVGknm(;j^?Jf->ZoBY> z3Umh!Rg#~~hO{z-k2r6^ytyjBc*p_*B0OPmz{3~#x&am!k(I?!^6}36#_?ftwn)oX zY#fLnxJwOb0>b(-MscpeODIuboEO#N5mvLsgE=!Vx%9a_m$|%pUEOe7SL&9dT(X6# zn)YLWCS;xO#V7Cfx9;iQgJ8VKkHcU84ZNZSBYcSK3x&`28l>mOIyI6WCm$E!&5Zr* zTjO8n23tay(3aDjiAqXd223U@5Dxqy&=4ob!+I4NBkq3o)6ohN<9VZ^S6|46-p~DE zeAMsqT9)vM=#!F*)~D9*FUB8BAAw|=ezx8XS&a#kF4&pkcp(d`@><=) zM5R+9W9)h#1L98A4q96jJFasuLVkF;M2&gTPbA5{uoP1#l0eYkG;O)PF0 z_sZQ{@d>`n`tR?%!|VjVusU7sUOQ-CdMl?iIjlR`v=pw0-$zUH&Rgog4n%LQU!&8ym|S z+LU2oQF5n*zz-qNrvh^zHgDbKVMP)DF%w@Wh3ked>wF%@^Bs8_qDR7XWK-t|NMP`i z87n6}%N1Kh=L+k=B2alGOyJG z?*=v8c)S$4*U!&9vTVY5w1Jff;lUpOjO=9D5k-6F4FenfbJ)i?HwCtj>$oY&v!QH% z`1ci6+5RJf@`HWuFeI=Y`QeMZ7CxmNv$cAJ9CGl{S;);o=kE2@8CqZJPdSH9usMVu zcs!$@Fn|uplDn#`2MHOCl$m zYnz;o7-_JIT-YMo`t(r)A8xE9HJdbII}qk4@CR91@WX&710hXBqxHgYtjhg&262yp z=|AY*m?HWzV(^fAP}|b);!5`1ArEZA3(NUHyHp4{5xAM{16I6P+t|G}MXEH+DRr4X zCn?)B>i#rp0PGs_fh!85x$~i-wKhjIS}v4LwM)e++gIMe2L3JnGnUp9^nd{pgc1l< zz@Iy(8}@(5HvW%$kpSal2`5km+X6vELxYA9!~KvskGS4LkL0lE|Idve32Vf)d!E}Cfh*ZG>diaI~KYY(Cc#{{pFDc^;dVNMf4s-^*U<`N{5G~n=kO` zMtCj~2|Z6<_m0?&|NpA{>ZmBcwQax_1V*}L3E%aK~hS(WattVK`BuIX#{0x zq+x(T=?;mJ96E-Q9GD^A&F`FdedqiC{PRAG<-l@a_OtgL*M05%+}GxG!>a zfh2vgU=Iz{)XLNbd-_`Pf6TvW)M=l?*%@sW7mQur-D&A>dGv<8_E}PPl2_o)u(yl+ zT-l1-7eEvMYpD1L%;d{k9(xBty^2jAa^wjz;LJG~FT_?(zUIdHDtx;K401YHyUWgL zp-5wM`uZg3LE>Q&4iuoV9rRV!zz$i1p=S8oYMTMy6bUIfPlPeGCg`uX;5#i zfNTdtoi;|ZSPNv4G3ekOI<1S-9~y410HC$tf@z;%{AUe^st%9i)qpLTr^8fP=~Xm8=i4ILomZaUaL|t<`~G@b8tp z1&Y#l$RG<`k7?3-(EIdXeF11Q)~o7lZd@mNM)d!CPM(W#OLaYZJ?gjAqx=b$BR5;Y#NKATDNi5z#LO@3m2PW|pwJBtpXsvH zpq5VVsrqLg$Y{pno(nHA*HSAVtAmawU9jdPr^y6Hi!P)+lt3k`)x~iyw2=4F`vFiA zer^u8rVs5)7V(O7dTP}g{oq3)4$6>EoT&vK4YK;veR|GU00@bJsLU^*k>M58kd^f0EH|N z^IDI%4>_*3n7Kdj1!nn_gr&^@wbdB6b-fE$o3Q;Ykd0`DOa7K3jP^ydMR#HCs32RU z>Y`{Yy?Vp3m8;vNv(NMGBm$k6OfbAgF!>?4_9rRJff5?gZpaA2bSzd7G8P3Qk!g+sG`k)rRl>X;xsKQ_2G zMy!yv4RF>4Lfeor5~*E!bpq*{o$#6l^TWN0N8I;Xz2z*V3z0}SAk#VJNpQcy>u&-$sbBxw%;q z$tQ;xBJT`qr$>sV{i1)d+o<-jeH50e&s=E>1Y|VMy14B#{oxa(uVjN0zPhFalF`;F zD5g)P`Jr>oAF{WRuL-?eI<5)CP{i@op#=2u3Y<4Olld@ool;svFO?~;4(_i8HOq6j z@ty81_l=VvioU_o6|V0H`)#byok(`+95OPDUzw`nCNpH;#kIA1nfrlv`)w1{*&%98 z0y+QEo0Gg?=%bIvQ#!Tup%=5^e(83tPciv=t9vpM7=Cc00j=I8KSL$l%ER##L_bGf z$z9dp|3Y}HiLbC}SNvW)t`me5S{(h6M}SX1Pt#=0U`AYS(g^1bbjNkHcwxk7YMV%*_&t|P?_g8V5m}rH>H=L5u zN;1O~X_q5WKf@%FzXD*a$Rh=$$59Qwb9H$MsZ&HRV3k?0G1|G`pgT z2Oq}g;m*jCI1e3`TZ_wUq)6I?gA>y(`9{uUmPJ1EQoX{}in|!|q1UdyMOJ5L5Qxd< z!TXX=uiA>K;x1)ppJA%3p;`B{j(;2~2FDlWwu#KfpR@`epuXnFfG_qOlw}+E-U)ey zY-I@(N=E|M>`mN~y!}4g0HNEBJGsA;L|{;lyXP=pVNiH7= zPrnIKTQa%qSs{M_z!dZxpSiaiKX#WEBK{fXcYmvK%|Oam zp=VsYS>oH7oZW!Uk&Ma+C!(Rg65&`Cm{A+Mg6x<9E$Px2LMfA}_~&9ZyZzLb{2_Ty z&R$Os7X+-o(qgMISHv>+4SlaX6SoK!YQ&0K6Vw9)D?0`E$ab92tQS}w@nCS-9k8^G z9}D97o}c~IocfoNmsbr-8!})&iPE$_a7ch~8Vn_27gD9$+pQ#5OXu-HMCfjNef%{% zBw-!4{lML7F3ib3Nd?5Uq>Ne^RBD%dJ5NN%N8WGaNK+d3%Z}(7S9U1C!2ITuO)j z6PdrEBz)j#(%iav;iR56dUdy_;?d<31MRXXC0n6B;r=12MMALZ%b-d)QQl6Fhr||9Km5#5{?^5DpeSfhTo6UV`b|{% zt)?dLW7g%0c!?q`5@u^L`gY+$<(*x-MOz`~bH8@DhYHgAr1oVbu3 zaD{22Xm_Ay2^=Sgtk_JNHAnSVqDU7Bpuyr*FxS1@_U;`T8J~l_Bj!j&BlA# z9q7?T!tf(mtv%3Q*OX>lm~z~?N)MrFYiEaB8JtgcDt?&6tE0vxDvCSYo~Mnx3tEuN z$e6S6Um8!)!fpSe5>42sHKSHB({Vgn-j#R7*VKl_E!&ZGmXtN%T#6$e5O9Mj)^$e& z-@Gl_J|@UW@rg3sPWDbvf)rx0snst%Q3s{9m5tjP(LX}TNbtS414nn>j&o8jEidz# zA>s3F(VEMx!fSi}CvUD%oq}%fH&`SpJP4_&so%bx_q^^Awh)n!@E^%H@R|0rBf#mC z=g~M9(j$a8IjRkQWY)Km0$IAJx418sBt1m4p(^af*Xt1`j z0)1}5nGM|Ll%!Qlgy^&{*vLMu3?P8%GYdJ{zkByCbZ&7G^tsjs!UG5EV@JEo%ZrQB z_?7I90XzF>hk-17eot~XUqr-Wi<3F=$w~MFr!rfcOw7(3;@B;**>NhXy1Ke|5{yL-8_5V z?OK6C`g2N(lRy&c7p9{$cid64Y;ab$p_mJ1~WV)pmYC;DW|vCPaR&3YgM_r7B|6jE(I6x5aJ z&em+ef3KM<+ht8tlvIZSdc>j+I^t2D7V>trA-`u>l(TVtzb2q2-nIUjHKEk{lt0oAm5X*=ZA zM6PjhaXs%(Z*UmO;a6?8%T{atN}slBbOFI}2YR6RXjSAR~Ua*e=r| zV4u!K+2c=Yf~nT$Ey9*m|4*YdpG-R>SYP)fDb}l6sbcIc6>j*Nx* z`CYxeG;#MPIPToZW#Z6G1^QQ>WI4G5k2~*9v`cO*lB>BobnX3cuviItmEzQRu*Qt` z4y)u{wFt)$L~zmK&6kzGOnj}jmoHx=2z*B7kEW}ejVigl7oz7Q$NyvZa0XV2H#er4 z;E9QexIq=RcO5P7s79m_nrXVCR#sMw)f8l8WaQ+$e86ZfNVRa=*mr2KC2l6?h&k`u zViGr!Xe9i?`(`F==AT(N53Zl}@-l2Eo&^QB2}ic=S>_ISQiqQ?bUI}PTC6SmiSS|& z$}<0eoL8V(<4T!?v$>w7r6qW5z18X=JsG!Qp|(%{cTUASVl}IS^um;e`lePq;TZzK zMn*<|l27FW_7vb~RBm9ks$%K#7WW@%E!pGBd$7|8iaKAm8}In11a2KJ4j)T|msj;| zr^LnvCdHqj9ZtrpF}?YDd7ONF)y75p`$d7A#o3%*i&o;dt4K;|A{L{-cL{>;g)N*f z70Dz{!;bw|)E`oJb!z6<>k$Ro?p8i?4V3$R zDArg&SU53vG5+Jn7oDy~MWcpr#&K$i-T}8H8G;`~XGa8mq$rLTemG}l?z!!=YU8n? zQclp?a0*^1FK>Te2;DiI%~~NUX_bw%?>851cdQ(D7J2<^;Bm-NyhPgmt3TJ_2l9E+ z1qIUF2PA1l+IHf1V@6d3N^Z5%7tv?8a>#FQ@V42X|6tuxkYsD-?6vurvgS@o?~=P1 zkcSARtdYmgKR$H54F7Nt9JK*tNLGJ;&&$h$-n@Bpr;EF!Cq;CtvEgX86zeXQe7ucB zN*r14kI?3F4+*KT$VNr1P-6xM$CRXOAL>sCSkOU&`npfQo*d87*0RaMT+M26xkzbi zcVBh=*f00T*w6&g3}%8I{u1PAxopUea6{XH!vRf;x1O2V#^R!_NQ#2Iyu=Tt_t}Pd zy*~OG-lM7BhTvaw?LusOd6rPnyr_!Z-w}oY?1}$M)HyJ0s4bapESdhJu!T`sw%yS_ zBaUyL%`GX3jfeok1F+nxDnrB&Lv)+#6w(WBLB!+O*lzUrac6d{4E|uk4a7f0ilon` z#pzCBM~5m-ko1lg00PY%NI@hgQ3vM)!3s; zxb4XFMG5@mGDmmOKJ+)o@E*?Z_Q`R*Qj3<&Nqt;x{FQ?=E)T9Qy?`s)>w|?4-@otlVd=OTX2oc44=wL; zeS>@AGwIBSH>OqrP(uOn?NBia0twd}^Io6Z!XhQ-reKNNA}g45QK;((YhClvQQpUf zr>)m6AZNB*J}nZM6QoqUVstTBzjUmB`sXch%)nlB19CN%SzN#iJG`^A^Y`!HM00ftM3oB<;*kLe zr^d$Pn^SclQZzL+O;Q8_Z2{;_78VvZwynHPl3u}!dlU_RPMt9qzoXi8;?0nR^J?!o z`Rew@(RIk!3!z4jTT$LjcLE(@&pEEWaWO(^?M?e*T5Nou`U-Px9}YhJZJ9AxAGAn(A2wqU{>f51vxCpKx<={aidu5WA7El|%@ z=6ui;X!2Ec%~85`$&az;#B{CB_tKu=m-9Lk_#GISgGB5oQBhu=4(y_ElDgxyU-!JW zrcYJ|vx{Rv%s(HW(n4|FCVr$On1+=#{o}{7=e^0mj)30A-X8qZ>U-MHumVHvW9r1- zkK4+vr(xJC&dsx^Nm0?d7ARDbt$sEkbhh~UnMB|$nk^9KQUD4Z&FM7JxniA$@p{4c zLz@+}1#w$*Ptq&>G`qv_U7wzqd4USdc(nCdRQ(sC5f9mnm_mJGxV)dAAMiuzfCHO& zotf(+qocGmGz`(o=($%!rl894J$Sfe%+zL8TJye7bnqRUEa-!V>IDJDF!Y`}4!H z8Hfy-5&(j1beX8)R)767Ua(bqCATk6rv8cI0|vKK_BLGlM-#;bqetYX&x7`(BhK=9rd1s?oDsC^LlJ3G!!a2q|GxlJS&%&H4M;X7=t* z<3~-vM9pC5#^me;lF|crI@Ls+v|-vM=tjb3o##@|)5hSF!E6ni_;5kzmcLuXiyh7mKGN*Qjb@d{Bn!r11pyy`4N0rKRCI!do8Nm~8~aOke1^@1 zzu;`c`fserm#q63KoY*}ZpNw3?EDMfv7J1#sX+~VtL`f_*B!CW*F=!*@iEaD&Uzh~ zT6$|Z_2=Ot581a`>5r|+mgt2qVoxNLI>Bx?5&Z5&`I-0h>N>$xJ`0;^5ZjKC$QN3F z4kEAQn><+0#EE?IXXqI`iw=~1BbWAdY~S~MSFlRy*2Q9d(?&=uyF<8)W_{a->6s6G zl0U&9udW1m9lEfv`M0Ft=7ktv0bC#lK>V4KynllsZc<@gE zB$5y$VIL5wZwOrOF$u^i6cKtOo&m;IBf;-*!(Q#-w@2UyQ|YVc8=6F!IzY@3Tm$z> z*w0_>se#47&3hubE6@Htxc|~pERGDa0Cmvz7#7LE z!@r+7^?(l9_}_}!+S>M5wrZmXgM))0J4&P#-_Rn58w0T$>|k~~ASz5;4WB+uii`7@ zZ3-j4aJi+e&EKzb??X{ZiI$dDe|I-285y$#+}_vMH^rNw#&KbBkwqrZs02+x&!1`0 z7|bJDTv#XtU(p5%I-uB#fZUE!wkE)Du5?ionGJ$rDBj`WDeBB755FxSAW-Pn+1Ys` zcwujKNH0g-L+d3N)!Ff~taJ#c+!X>Sx0UWZd{`PLa)pAm{uIA9#a1FCBLjrwLO_E5 zv|-`D`aL4zD$JUXuSDE)iJF$yf9d+mzK&Hm>R{Yys?Nu!(PM6Y9=AR=WJ5?!PHv5) ztK;|yF3i~}&bzK5Er1;U5R|W^V72wb?^IV z1G1BM?Y+$ANuVajbEU~^ZFF^?&f*t;O795)CrVF-Z66pI*g_GC9}zHsYAKe?1qDEH z#>NnWB8igGveMWMb@Ut^O-V&%Es`?glBS71EQvNO7&&p{-MozzeBR?O#?119Mh^WG zFsd-mg?707|(7x+u=!K~XjNft^U`YHMPWRCke4Lz|yu6wk z8qv|wG;u(NEd;0rrPncMUKn$(TFwYLP4k&{_^R>f(XTSw?o>^?t?34zjd268#PRV! zyK8^av;XMmC_W*fFGCjNScx3x;NWOHoQs4CJn#9^98N(8R2QkKkGEq(sN(>06h=zt zkI#D9H=`AT9|FimX(99q>wR9{zRu3P++5Yik5`8fv03*41`!K5C=4I~xh|-%uz@0w z2Lm5qVPy0rDM{RE^Z{fHFf84Cjg#y!VmO2)O_jJJdSPMVu3ADAlW1R%p`GXLHzg>1 zegquA21KeK;a~$hmL9MvjyqvsV0iTC5mW$d3y9PZWe(lv<_^HGB9?nomSqacYavaT z<0VnY*TciZm&45iHiY*FQru9h<9RVJ6jfBfQkeoZ$A}d;^0rD$#Ssm0+7m;=1c~Uy z>3}U4_m#<7PptNAmQtjtWMpI{kg*{<~6ERe|IzKlT+?6EiI(Z)ofk1$Ql^2GMiAgfxz!@_357Du)2xnaR zytBItG_8(K30riuwB}{oz)8W0|8I{0i{t8kA1tYmkiO#Y-@k{YK_=Hx5l`ST8GS~R zggM#t0W5kKP-YyTgTCxri{wLTBTA)!I@b+yPy(z0{VLixP|yGu$d{~knRs4mq-X;O zzGBW%sFe_7;)AD9C;&Vb!AG_PIO~f4)i-i=lN-*jaeIpY1RDuH&54 z$+RsoZ+J_=#tQ{E0}H$)hwxq*V24~IC0zr4IiHQa?{8^2`;LlZSQ;BWROhn=fRwPk zR1hA%A8+Q$JX5CQO|k;Lr~ZZCvgx8%00tEla=M#gVqX|TNzN#gTUh7}0voUdsnEP1BWSmGoAZ4*BG?1_+oy;7P@NzvN&B#>QMw;ENip1{TVc zaa0_dxgokbZmIX!6uy4_3J{>0mez6`F)vdn|6hNp(A=- z90GyZr6=KK(o-hx6$d^z0SZ4kK6VzF0QCVvBL!@1oD;KC z_M2;Y$i}R!EHga0sW1u%uw5dhjZjrr?~%q$W^d}d!$ z_#J3N0Pb|*lNPu!MVrO0c&sLRQfL3yq>-6fT0{*RNhGAE^Eu>rp3TF<1H`lppu%_= zWSaoo=Ha0)?85$A$0OI9uJ_?UD)pQ>`1R|TNQw&(=_4j42H`O_DvDXe`46CnU27L< zE1$~Az5Gj0A{Fa%HB=LUMEZl@NOTslYY~n02?-O2cs#Fh#me=wuUn00!Ly?-@9^M> zGyJ(mKvNhfJm?^wIxC#V%4oO^g^WZL8onB%z_Ix2u#|3J=NrsofB%$PN7C|)m)S

6f(YRMb*ZxRMgb)uuymK z9~9DiA9|k)(vyK~aM;XtI#6!c-_|?Kl;2tRSP?`(B}K$gSXh|ZW4o8$-hQz~9UUE7 zGDl!471&DQCWDy!Gq8%EV%d*o+h!kLG!;3Y#xK1~Dr`Z+p34?h&QCQo zdcQsX1i1I9LwjZAx5%%W+`|9KPfUt|G&w~t{^DCZp42qX#I?3{|H(&=z>|G6z&nju z_d$s__QUeE)5({6dHZV{-U0spc;LxQ%m!}vH}9Ex8592GgAA;tMHd%$TSbIdveaW< z8Bz;4e*pZ3r2#uM4(9*Y>nlLy)%fl7_nI1`8y_ace%e~=Fvxj=(tEVntS<2A1-i*~ zv&wl4dd^4}cV>a6=Fl?W3?PADj+QJ{Vf(B05M@0uj5v};MuRmBx!G&XTJzJfPT*M^Q)5}IsjNw8&PxCsT)KFLbeMA z)$oV_v_$im01*27EH;!EEUtYY(0)|BBPmJnX(X7vRsiCN>3He=cO2>N8>T;=g-SRL zSMKF<2@CH72JdDZz;*%kLvjePWmD(1W(Yaja0^*8CM~_BoV|@AY*NLcEkdS(PE)e( zgY6KyIKWo{#ORw}C$~(=$SC2xZUkt^=h1|eP+MEu>M3vVKCspR!xo>+gPResiHMLo zJ)9Rw>8)(6uRk8M%bdA;X@rZ1zp<$o|{WC1$L3vV2yYKfUKW9 z=}H!M>gw(WaN_sSkl*4pvp;~Pmpwb)ZE0x%M1!!{9!M`>yP^nslbU*1{#HHMqr&*k z-|&*;<8wRwJFBFm1md1K67C=`-_-eu;~Xw9S3cIWQh*7o)-Oye2Y zD3S5s%N?|r0>Y$#3z5JYzbr^6$?P7h^C|Ivjrjgucr3H5>;?D`jZ@j#&AKgK9v+v0 z=~?$l;C<0dxGjwA?c2?}bQj^@u2J2KPz8+Hyg~?J0u$Vo?G4DpP1*esm_==lO&tJi zKq0#dElkYfwlQ9L16vjmQBtzCR?;|aLx7q4ec#qq2T`>Wvy?su%O~OhKMd53TUuMEz%O^#Ga% zphF61a04rH>6f`+M)AMJxzhQG`2VX__wV;!1>efK(_lgCP$ipBEJUi}Yg C<~w%) literal 0 HcmV?d00001 diff --git a/previews/PR237/assets/experiments_accurate_accumulators.md.BXYktaVF.js b/previews/PR237/assets/experiments_accurate_accumulators.md.BXYktaVF.js new file mode 100644 index 000000000..187d09c2e --- /dev/null +++ b/previews/PR237/assets/experiments_accurate_accumulators.md.BXYktaVF.js @@ -0,0 +1,6 @@ +import{_ as i,c as a,a5 as t,o as e}from"./chunks/framework.Cq8AuEls.js";const g=JSON.parse('{"title":"Accurate accumulation","description":"","frontmatter":{},"headers":[],"relativePath":"experiments/accurate_accumulators.md","filePath":"experiments/accurate_accumulators.md","lastUpdated":null}'),n={name:"experiments/accurate_accumulators.md"};function l(h,s,p,k,d,r){return e(),a("div",null,s[0]||(s[0]=[t(`

Accurate accumulation

Accurate arithmetic is a technique which allows you to calculate using more precision than the provided numeric type.

We will use the accurate sum routines from AccurateArithmetic.jl to show the difference!

julia
import GeometryOps as GO, GeoInterface as GI
+using GeoJSON
+using AccurateArithmetic
+using NaturalEarth
+
+all_adm0 = naturalearth("admin_0_countries", 10)
FeatureCollection with 258 Features
julia
GO.area(all_adm0)
21427.909318372607
julia
AccurateArithmetic.sum_oro(GO.area.(all_adm0.geometry))
21427.909318372607
julia
AccurateArithmetic.sum_kbn(GO.area.(all_adm0.geometry))
21427.909318372607
julia
GI.Polygon.(GO.flatten(Union{GI.LineStringTrait, GI.LinearRingTrait}, all_adm0) |> collect .|> x -> [x]) .|> GO.signed_area |> sum
-21427.90063612163
julia
GI.Polygon.(GO.flatten(Union{GI.LineStringTrait, GI.LinearRingTrait}, all_adm0) |> collect .|> x -> [x]) .|> GO.signed_area |> sum_oro
-21427.90063612163

@example accurate GI.Polygon.(GO.flatten(Union{GI.LineStringTrait, GI.LinearRingTrait}, all_adm0) |> collect .|> x -> [x]) .|> GO.signed_area |> sum_kbn \`\`\`

`,16)]))}const E=i(n,[["render",l]]);export{g as __pageData,E as default}; diff --git a/previews/PR237/assets/experiments_accurate_accumulators.md.BXYktaVF.lean.js b/previews/PR237/assets/experiments_accurate_accumulators.md.BXYktaVF.lean.js new file mode 100644 index 000000000..187d09c2e --- /dev/null +++ b/previews/PR237/assets/experiments_accurate_accumulators.md.BXYktaVF.lean.js @@ -0,0 +1,6 @@ +import{_ as i,c as a,a5 as t,o as e}from"./chunks/framework.Cq8AuEls.js";const g=JSON.parse('{"title":"Accurate accumulation","description":"","frontmatter":{},"headers":[],"relativePath":"experiments/accurate_accumulators.md","filePath":"experiments/accurate_accumulators.md","lastUpdated":null}'),n={name:"experiments/accurate_accumulators.md"};function l(h,s,p,k,d,r){return e(),a("div",null,s[0]||(s[0]=[t(`

Accurate accumulation

Accurate arithmetic is a technique which allows you to calculate using more precision than the provided numeric type.

We will use the accurate sum routines from AccurateArithmetic.jl to show the difference!

julia
import GeometryOps as GO, GeoInterface as GI
+using GeoJSON
+using AccurateArithmetic
+using NaturalEarth
+
+all_adm0 = naturalearth("admin_0_countries", 10)
FeatureCollection with 258 Features
julia
GO.area(all_adm0)
21427.909318372607
julia
AccurateArithmetic.sum_oro(GO.area.(all_adm0.geometry))
21427.909318372607
julia
AccurateArithmetic.sum_kbn(GO.area.(all_adm0.geometry))
21427.909318372607
julia
GI.Polygon.(GO.flatten(Union{GI.LineStringTrait, GI.LinearRingTrait}, all_adm0) |> collect .|> x -> [x]) .|> GO.signed_area |> sum
-21427.90063612163
julia
GI.Polygon.(GO.flatten(Union{GI.LineStringTrait, GI.LinearRingTrait}, all_adm0) |> collect .|> x -> [x]) .|> GO.signed_area |> sum_oro
-21427.90063612163

@example accurate GI.Polygon.(GO.flatten(Union{GI.LineStringTrait, GI.LinearRingTrait}, all_adm0) |> collect .|> x -> [x]) .|> GO.signed_area |> sum_kbn \`\`\`

`,16)]))}const E=i(n,[["render",l]]);export{g as __pageData,E as default}; diff --git a/previews/PR237/assets/experiments_predicates.md.B9dtjjXk.js b/previews/PR237/assets/experiments_predicates.md.B9dtjjXk.js new file mode 100644 index 000000000..7c93e23b4 --- /dev/null +++ b/previews/PR237/assets/experiments_predicates.md.B9dtjjXk.js @@ -0,0 +1,98 @@ +import{_ as i,c as a,a5 as h,o as k}from"./chunks/framework.Cq8AuEls.js";const n="/GeometryOps.jl/previews/PR237/assets/mysefnd.BX1TCrz5.png",y=JSON.parse('{"title":"Predicates","description":"","frontmatter":{},"headers":[],"relativePath":"experiments/predicates.md","filePath":"experiments/predicates.md","lastUpdated":null}'),p={name:"experiments/predicates.md"};function l(t,s,E,e,r,d){return k(),a("div",null,s[0]||(s[0]=[h(`

Predicates

Exact vs fast predicates

Orient

julia
using CairoMakie
+import GeometryOps as GO, GeoInterface as GI, LibGEOS as LG
+import ExactPredicates
+using MultiFloats
+using Chairmarks: @be
+using BenchmarkTools: prettytime
+using Statistics
+
+function orient_f64(p, q, r)
+    return sign((GI.x(p) - GI.x(r))*(GI.y(q) - GI.y(r)) - (GI.y(p) - GI.y(r))*(GI.x(q) - GI.x(r)))
+end
+
+function orient_adaptive(p, q, r)
+    px, py = Float64x2(GI.x(p)), Float64x2(GI.y(p))
+    qx, qy = Float64x2(GI.x(q)), Float64x2(GI.y(q))
+    rx, ry = Float64x2(GI.x(r)), Float64x2(GI.y(r))
+    return sign((px - rx)*(qy - ry) - (py - ry)*(qx - rx))
+end
+# Create an interactive Makie dashboard which can show what is done here
+labels = ["Float64", "Adaptive", "Exact"]
+funcs = [orient_f64, orient_adaptive, ExactPredicates.orient]
+fig = Figure()
+axs = [Axis(fig[1, i]; aspect = DataAspect(), xticklabelrotation = pi/4, title) for (i, title) in enumerate(labels)]
+w, r, q, p = 42.0, 0.95, 18.0, 16.8
+function generate_heatmap_args(func, w, r, q, p, heatmap_size = 1000)
+    w_range = LinRange(0, 0+2.0^(-w), heatmap_size)
+    orient_field = [func((p, p), (q, q), (r+x, r+y)) for x in w_range, y in w_range]
+    return (w_range, w_range, orient_field)
+end
+for (i, (ax, func)) in enumerate(zip(axs, funcs))
+    heatmap!(ax, generate_heatmap_args(func, w, r, q, p)...)
+    # now get timing
+    w_range = LinRange(0, 0+2.0^(-w), 5) # for timing - we want to sample stable + unstable points
+    @time timings = [@be $(func)($((p, p)), $((q, q)), $((r+x, r+y))) for x in w_range, y in w_range]
+    median_timings = map.(x -> getproperty(x, :time), getproperty.(timings, :samples)) |> Iterators.flatten |> collect
+    ax.subtitle = prettytime(Statistics.median(median_timings)*10^9)
+    # create time histogram plot
+    # hist(fig[2, i], median_timings; axis = (; xticklabelrotation = pi/4))
+    display(fig)
+end
+resize!(fig, 1000, 450)
+fig

Dashboard

julia
using WGLMakie
+import GeometryOps as GO, GeoInterface as GI, LibGEOS as LG
+import ExactPredicates
+using MultiFloats
+
+function orient_f64(p, q, r)
+    return sign((GI.x(p) - GI.x(r))*(GI.y(q) - GI.y(r)) - (GI.y(p) - GI.y(r))*(GI.x(q) - GI.x(r)))
+end
+
+function orient_adaptive(p, q, r)
+    px, py = Float64x2(GI.x(p)), Float64x2(GI.y(p))
+    qx, qy = Float64x2(GI.x(q)), Float64x2(GI.y(q))
+    rx, ry = Float64x2(GI.x(r)), Float64x2(GI.y(r))
+    return sign((px - rx)*(qy - ry) - (py - ry)*(qx - rx))
+end
+# Create an interactive Makie dashboard which can show what is done here
+fig = Figure()
+ax = Axis(fig[1, 1]; aspect = DataAspect())
+sliders = SliderGrid(fig[2, 1],
+        (label = L"w = 2^{-v} (zoom)", range = LinRange(40, 44, 100), startvalue = 42),
+        (label = L"r = (x, y),~ x, y ∈ v + [0..w)", range = 0:0.01:3, startvalue = 0.95),
+        (label = L"q = (k, k),~ k = v", range = LinRange(0, 30, 100), startvalue = 18),
+        (label = L"p = (k, k),~ k = v", range = LinRange(0, 30, 100), startvalue = 16.8),
+)
+orient_funcs = [orient_f64, orient_adaptive, ExactPredicates.orient]
+menu = Menu(fig[3, 1], options = zip(string.(orient_funcs), orient_funcs))
+w_obs, r_obs, q_obs, p_obs = getproperty.(sliders.sliders, :value)
+orient_obs = menu.selection
+
+heatmap_size = @lift maximum(widths($(ax.scene.viewport)))*4
+
+matrix_observable = lift(orient_obs, w_obs, r_obs, q_obs, p_obs, heatmap_size) do orient, w, r, q, p, heatmap_size
+    return [orient((p, p), (q, q), (r+x, r+y)) for x in LinRange(0, 0+2.0^(-w), heatmap_size), y in LinRange(0, 0+2.0^(-w), heatmap_size)]
+end
+heatmap!(ax, matrix_observable; colormap = [:red, :green, :blue])
+resize!(fig, 500, 700)
+fig

Testing robust vs regular predicates

julia

+import GeoInterface as GI, GeometryOps as GO, LibGEOS as LG
+using MultiFloats
+c1 = [[-28083.868447876892, -58059.13401805979], [-9833.052704767595, -48001.726711609794], [-16111.439295815226, -2.856614689791036e-11], [-76085.95770326033, -2.856614689791036e-11], [-28083.868447876892, -58059.13401805979]]
+c2 = [[-53333.333333333336, 0.0], [0.0, 0.0], [0.0, -80000.0], [-60000.0, -80000.0], [-53333.333333333336, 0.0]]
+
+p1 = GI.Polygon([c1])
+p2 = GI.Polygon([c2])
+GO.intersection(p1, p2; target = GI.PolygonTrait(), fix_multipoly = nothing)
+
+p1_m, p2_m = GO.transform(x -> (Float64x2.(x)), [p1, p2])
+GO.intersection(p1_m, p2_m; target = GI.PolygonTrait(), fix_multipoly = nothing)
+
+p1 = GI.Polygon([[[-57725.80869813739, -52709.704377648755], [-53333.333333333336, 0.0], [-41878.01362848005, 0.0], [-36022.23699059147, -43787.61366192682], [-48268.44121252392, -52521.18593721105], [-57725.80869813739, -52709.704377648755]]])
+p2 = GI.Polygon([[[-60000.0, 80000.0], [0.0, 80000.0], [0.0, 0.0], [-53333.33333333333, 0.0], [-50000.0, 40000.0], [-60000.0, 80000.0]]])
+p1_m, p2_m = GO.transform(x -> (Float64x2.(x)), [p1, p2])
+f, a, p__1 = poly(p1; label = "p1")
+p__2 = poly!(a, p2; label = "p2")
+
+GO.intersection(p1_m, p2_m; target = GI.PolygonTrait(), fix_multipoly = nothing)
+LG.intersection(p1_m, p2_m)

Incircle

`,10)]))}const F=i(p,[["render",l]]);export{y as __pageData,F as default}; diff --git a/previews/PR237/assets/experiments_predicates.md.B9dtjjXk.lean.js b/previews/PR237/assets/experiments_predicates.md.B9dtjjXk.lean.js new file mode 100644 index 000000000..7c93e23b4 --- /dev/null +++ b/previews/PR237/assets/experiments_predicates.md.B9dtjjXk.lean.js @@ -0,0 +1,98 @@ +import{_ as i,c as a,a5 as h,o as k}from"./chunks/framework.Cq8AuEls.js";const n="/GeometryOps.jl/previews/PR237/assets/mysefnd.BX1TCrz5.png",y=JSON.parse('{"title":"Predicates","description":"","frontmatter":{},"headers":[],"relativePath":"experiments/predicates.md","filePath":"experiments/predicates.md","lastUpdated":null}'),p={name:"experiments/predicates.md"};function l(t,s,E,e,r,d){return k(),a("div",null,s[0]||(s[0]=[h(`

Predicates

Exact vs fast predicates

Orient

julia
using CairoMakie
+import GeometryOps as GO, GeoInterface as GI, LibGEOS as LG
+import ExactPredicates
+using MultiFloats
+using Chairmarks: @be
+using BenchmarkTools: prettytime
+using Statistics
+
+function orient_f64(p, q, r)
+    return sign((GI.x(p) - GI.x(r))*(GI.y(q) - GI.y(r)) - (GI.y(p) - GI.y(r))*(GI.x(q) - GI.x(r)))
+end
+
+function orient_adaptive(p, q, r)
+    px, py = Float64x2(GI.x(p)), Float64x2(GI.y(p))
+    qx, qy = Float64x2(GI.x(q)), Float64x2(GI.y(q))
+    rx, ry = Float64x2(GI.x(r)), Float64x2(GI.y(r))
+    return sign((px - rx)*(qy - ry) - (py - ry)*(qx - rx))
+end
+# Create an interactive Makie dashboard which can show what is done here
+labels = ["Float64", "Adaptive", "Exact"]
+funcs = [orient_f64, orient_adaptive, ExactPredicates.orient]
+fig = Figure()
+axs = [Axis(fig[1, i]; aspect = DataAspect(), xticklabelrotation = pi/4, title) for (i, title) in enumerate(labels)]
+w, r, q, p = 42.0, 0.95, 18.0, 16.8
+function generate_heatmap_args(func, w, r, q, p, heatmap_size = 1000)
+    w_range = LinRange(0, 0+2.0^(-w), heatmap_size)
+    orient_field = [func((p, p), (q, q), (r+x, r+y)) for x in w_range, y in w_range]
+    return (w_range, w_range, orient_field)
+end
+for (i, (ax, func)) in enumerate(zip(axs, funcs))
+    heatmap!(ax, generate_heatmap_args(func, w, r, q, p)...)
+    # now get timing
+    w_range = LinRange(0, 0+2.0^(-w), 5) # for timing - we want to sample stable + unstable points
+    @time timings = [@be $(func)($((p, p)), $((q, q)), $((r+x, r+y))) for x in w_range, y in w_range]
+    median_timings = map.(x -> getproperty(x, :time), getproperty.(timings, :samples)) |> Iterators.flatten |> collect
+    ax.subtitle = prettytime(Statistics.median(median_timings)*10^9)
+    # create time histogram plot
+    # hist(fig[2, i], median_timings; axis = (; xticklabelrotation = pi/4))
+    display(fig)
+end
+resize!(fig, 1000, 450)
+fig

Dashboard

julia
using WGLMakie
+import GeometryOps as GO, GeoInterface as GI, LibGEOS as LG
+import ExactPredicates
+using MultiFloats
+
+function orient_f64(p, q, r)
+    return sign((GI.x(p) - GI.x(r))*(GI.y(q) - GI.y(r)) - (GI.y(p) - GI.y(r))*(GI.x(q) - GI.x(r)))
+end
+
+function orient_adaptive(p, q, r)
+    px, py = Float64x2(GI.x(p)), Float64x2(GI.y(p))
+    qx, qy = Float64x2(GI.x(q)), Float64x2(GI.y(q))
+    rx, ry = Float64x2(GI.x(r)), Float64x2(GI.y(r))
+    return sign((px - rx)*(qy - ry) - (py - ry)*(qx - rx))
+end
+# Create an interactive Makie dashboard which can show what is done here
+fig = Figure()
+ax = Axis(fig[1, 1]; aspect = DataAspect())
+sliders = SliderGrid(fig[2, 1],
+        (label = L"w = 2^{-v} (zoom)", range = LinRange(40, 44, 100), startvalue = 42),
+        (label = L"r = (x, y),~ x, y ∈ v + [0..w)", range = 0:0.01:3, startvalue = 0.95),
+        (label = L"q = (k, k),~ k = v", range = LinRange(0, 30, 100), startvalue = 18),
+        (label = L"p = (k, k),~ k = v", range = LinRange(0, 30, 100), startvalue = 16.8),
+)
+orient_funcs = [orient_f64, orient_adaptive, ExactPredicates.orient]
+menu = Menu(fig[3, 1], options = zip(string.(orient_funcs), orient_funcs))
+w_obs, r_obs, q_obs, p_obs = getproperty.(sliders.sliders, :value)
+orient_obs = menu.selection
+
+heatmap_size = @lift maximum(widths($(ax.scene.viewport)))*4
+
+matrix_observable = lift(orient_obs, w_obs, r_obs, q_obs, p_obs, heatmap_size) do orient, w, r, q, p, heatmap_size
+    return [orient((p, p), (q, q), (r+x, r+y)) for x in LinRange(0, 0+2.0^(-w), heatmap_size), y in LinRange(0, 0+2.0^(-w), heatmap_size)]
+end
+heatmap!(ax, matrix_observable; colormap = [:red, :green, :blue])
+resize!(fig, 500, 700)
+fig

Testing robust vs regular predicates

julia

+import GeoInterface as GI, GeometryOps as GO, LibGEOS as LG
+using MultiFloats
+c1 = [[-28083.868447876892, -58059.13401805979], [-9833.052704767595, -48001.726711609794], [-16111.439295815226, -2.856614689791036e-11], [-76085.95770326033, -2.856614689791036e-11], [-28083.868447876892, -58059.13401805979]]
+c2 = [[-53333.333333333336, 0.0], [0.0, 0.0], [0.0, -80000.0], [-60000.0, -80000.0], [-53333.333333333336, 0.0]]
+
+p1 = GI.Polygon([c1])
+p2 = GI.Polygon([c2])
+GO.intersection(p1, p2; target = GI.PolygonTrait(), fix_multipoly = nothing)
+
+p1_m, p2_m = GO.transform(x -> (Float64x2.(x)), [p1, p2])
+GO.intersection(p1_m, p2_m; target = GI.PolygonTrait(), fix_multipoly = nothing)
+
+p1 = GI.Polygon([[[-57725.80869813739, -52709.704377648755], [-53333.333333333336, 0.0], [-41878.01362848005, 0.0], [-36022.23699059147, -43787.61366192682], [-48268.44121252392, -52521.18593721105], [-57725.80869813739, -52709.704377648755]]])
+p2 = GI.Polygon([[[-60000.0, 80000.0], [0.0, 80000.0], [0.0, 0.0], [-53333.33333333333, 0.0], [-50000.0, 40000.0], [-60000.0, 80000.0]]])
+p1_m, p2_m = GO.transform(x -> (Float64x2.(x)), [p1, p2])
+f, a, p__1 = poly(p1; label = "p1")
+p__2 = poly!(a, p2; label = "p2")
+
+GO.intersection(p1_m, p2_m; target = GI.PolygonTrait(), fix_multipoly = nothing)
+LG.intersection(p1_m, p2_m)

Incircle

`,10)]))}const F=i(p,[["render",l]]);export{y as __pageData,F as default}; diff --git a/previews/PR237/assets/explanations_crs.md.DiYuqaex.js b/previews/PR237/assets/explanations_crs.md.DiYuqaex.js new file mode 100644 index 000000000..64abfb1bd --- /dev/null +++ b/previews/PR237/assets/explanations_crs.md.DiYuqaex.js @@ -0,0 +1 @@ +import{_ as e,c as t,o as a}from"./chunks/framework.Cq8AuEls.js";const _=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"explanations/crs.md","filePath":"explanations/crs.md","lastUpdated":null}'),s={name:"explanations/crs.md"};function n(r,o,c,p,i,l){return a(),t("div")}const m=e(s,[["render",n]]);export{_ as __pageData,m as default}; diff --git a/previews/PR237/assets/explanations_crs.md.DiYuqaex.lean.js b/previews/PR237/assets/explanations_crs.md.DiYuqaex.lean.js new file mode 100644 index 000000000..64abfb1bd --- /dev/null +++ b/previews/PR237/assets/explanations_crs.md.DiYuqaex.lean.js @@ -0,0 +1 @@ +import{_ as e,c as t,o as a}from"./chunks/framework.Cq8AuEls.js";const _=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"explanations/crs.md","filePath":"explanations/crs.md","lastUpdated":null}'),s={name:"explanations/crs.md"};function n(r,o,c,p,i,l){return a(),t("div")}const m=e(s,[["render",n]]);export{_ as __pageData,m as default}; diff --git a/previews/PR237/assets/explanations_paradigms.md.DW4pGVk2.js b/previews/PR237/assets/explanations_paradigms.md.DW4pGVk2.js new file mode 100644 index 000000000..eb1473005 --- /dev/null +++ b/previews/PR237/assets/explanations_paradigms.md.DW4pGVk2.js @@ -0,0 +1 @@ +import{_ as a,c as t,a5 as o,o as i}from"./chunks/framework.Cq8AuEls.js";const u=JSON.parse('{"title":"Paradigms","description":"","frontmatter":{},"headers":[],"relativePath":"explanations/paradigms.md","filePath":"explanations/paradigms.md","lastUpdated":null}'),r={name:"explanations/paradigms.md"};function s(n,e,d,p,c,l){return i(),t("div",null,e[0]||(e[0]=[o('

Paradigms

GeometryOps exposes functions like apply and applyreduce, as well as the fix and prepare APIs, that represent paradigms of programming, by which we mean the ability to program in a certain way, and in so doing, fit neatly into the tools we've built without needing to re-implement the wheel.

Below, we'll describe some of the foundational paradigms of GeometryOps, and why you should care!

apply

The apply function allows you to decompose a given collection of geometries down to a certain level, operate on it, and reconstruct it back to the same nested form as the original. In general, its invocation is:

julia
apply(f, trait::Trait, geom)

Functionally, it's similar to map in the way you apply it to geometries - except that you tell it at which level it should stop, by passing a trait to it.

apply will start by decomposing the geometry, feature, featurecollection, iterable, or table that you pass to it, and stop when it encounters a geometry for which GI.trait(geom) isa Trait. This encompasses unions of traits especially, but beware that any geometry which is not explicitly handled, and hits GI.PointTrait, will cause an error.

apply is unlike map in that it returns reconstructed geometries, instead of the raw output of the function. If you want a purely map-like behaviour, like calculating the length of each linestring in your feature collection, then call GO.flatten(f, trait, geom), which will decompose each geometry to the given trait and apply f to it, returning the decomposition as a flattened vector.

applyreduce

applyreduce is like the previous map-based approach that we mentioned, except that it reduces the result of f by op. Note that applyreduce does not guarantee associativity, so it's best to have typeof(init) == returntype(op).

fix and prepare

The fix and prepare paradigms are different from apply, though they are built on top of it. They involve the use of structs as "actions", where a constructed object indicates an action that should be taken. A trait like interface prescribes the level (polygon, linestring, point, etc) at which each action should be applied.

In general, the idea here is to be able to invoke several actions efficiently and simultaneously, for example when correcting invalid geometries, or instantiating a Prepared geometry with several preparations (sorted edge lists, rtrees, monotone chains, etc.)

',14)]))}const m=a(r,[["render",s]]);export{u as __pageData,m as default}; diff --git a/previews/PR237/assets/explanations_paradigms.md.DW4pGVk2.lean.js b/previews/PR237/assets/explanations_paradigms.md.DW4pGVk2.lean.js new file mode 100644 index 000000000..eb1473005 --- /dev/null +++ b/previews/PR237/assets/explanations_paradigms.md.DW4pGVk2.lean.js @@ -0,0 +1 @@ +import{_ as a,c as t,a5 as o,o as i}from"./chunks/framework.Cq8AuEls.js";const u=JSON.parse('{"title":"Paradigms","description":"","frontmatter":{},"headers":[],"relativePath":"explanations/paradigms.md","filePath":"explanations/paradigms.md","lastUpdated":null}'),r={name:"explanations/paradigms.md"};function s(n,e,d,p,c,l){return i(),t("div",null,e[0]||(e[0]=[o('

Paradigms

GeometryOps exposes functions like apply and applyreduce, as well as the fix and prepare APIs, that represent paradigms of programming, by which we mean the ability to program in a certain way, and in so doing, fit neatly into the tools we've built without needing to re-implement the wheel.

Below, we'll describe some of the foundational paradigms of GeometryOps, and why you should care!

apply

The apply function allows you to decompose a given collection of geometries down to a certain level, operate on it, and reconstruct it back to the same nested form as the original. In general, its invocation is:

julia
apply(f, trait::Trait, geom)

Functionally, it's similar to map in the way you apply it to geometries - except that you tell it at which level it should stop, by passing a trait to it.

apply will start by decomposing the geometry, feature, featurecollection, iterable, or table that you pass to it, and stop when it encounters a geometry for which GI.trait(geom) isa Trait. This encompasses unions of traits especially, but beware that any geometry which is not explicitly handled, and hits GI.PointTrait, will cause an error.

apply is unlike map in that it returns reconstructed geometries, instead of the raw output of the function. If you want a purely map-like behaviour, like calculating the length of each linestring in your feature collection, then call GO.flatten(f, trait, geom), which will decompose each geometry to the given trait and apply f to it, returning the decomposition as a flattened vector.

applyreduce

applyreduce is like the previous map-based approach that we mentioned, except that it reduces the result of f by op. Note that applyreduce does not guarantee associativity, so it's best to have typeof(init) == returntype(op).

fix and prepare

The fix and prepare paradigms are different from apply, though they are built on top of it. They involve the use of structs as "actions", where a constructed object indicates an action that should be taken. A trait like interface prescribes the level (polygon, linestring, point, etc) at which each action should be applied.

In general, the idea here is to be able to invoke several actions efficiently and simultaneously, for example when correcting invalid geometries, or instantiating a Prepared geometry with several preparations (sorted edge lists, rtrees, monotone chains, etc.)

',14)]))}const m=a(r,[["render",s]]);export{u as __pageData,m as default}; diff --git a/previews/PR237/assets/explanations_peculiarities.md.DpkElEdT.js b/previews/PR237/assets/explanations_peculiarities.md.DpkElEdT.js new file mode 100644 index 000000000..58717e863 --- /dev/null +++ b/previews/PR237/assets/explanations_peculiarities.md.DpkElEdT.js @@ -0,0 +1 @@ +import{_ as o,c as t,a5 as a,o as r}from"./chunks/framework.Cq8AuEls.js";const u=JSON.parse('{"title":"Peculiarities","description":"","frontmatter":{},"headers":[],"relativePath":"explanations/peculiarities.md","filePath":"explanations/peculiarities.md","lastUpdated":null}'),n={name:"explanations/peculiarities.md"};function i(s,e,l,d,c,p){return r(),t("div",null,e[0]||(e[0]=[a('

Peculiarities

What does apply return and why?

apply returns the target geometries returned by f, whatever type/package they are from, but geometries, features or feature collections that wrapped the target are replaced with GeoInterace.jl wrappers with matching GeoInterface.trait to the originals. All non-geointerface iterables become Arrays. Tables.jl compatible tables are converted either back to the original type if a Tables.materializer is defined, and if not then returned as generic NamedTuple column tables (i.e., a NamedTuple of vectors).

It is recommended for consistency that f returns GeoInterface geometries unless there is a performance/conversion overhead to doing that.

Why do you want me to provide a target in set operations?

In polygon set operations like intersection, difference, and union, many different geometry types may be obtained - depending on the relationship between the polygons. For example, when performing an union on two nonintersecting polygons, one would technically have two disjoint polygons as an output.

We use the target keyword to allow the user to control which kinds of geometry they want back. For example, setting target to PolygonTrait will cause a vector of polygons to be returned (this is the only currently supported behaviour). In future, we may implement MultiPolygonTrait or GeometryCollectionTrait targets which will return a single geometry, as LibGEOS and ArchGDAL do.

This also allows for a lot more type stability - when you ask for polygons, we won't return a geometrycollection with line segments. Especially in simulation workflows, this is excellent for simplified data processing.

_True and _False (or BoolsAsTypes)

Warning

These are internals and explicitly not public API, meaning they may change at any time!

When dispatch can be controlled by the value of a boolean variable, this introduces type instability. Instead of introducing type instability, we chose to encode our boolean decision variables, like threaded and calc_extent in apply, as types. This allows the compiler to reason about what will happen, and call the correct compiled method, in a stable way without worrying about

',11)]))}const y=o(n,[["render",i]]);export{u as __pageData,y as default}; diff --git a/previews/PR237/assets/explanations_peculiarities.md.DpkElEdT.lean.js b/previews/PR237/assets/explanations_peculiarities.md.DpkElEdT.lean.js new file mode 100644 index 000000000..58717e863 --- /dev/null +++ b/previews/PR237/assets/explanations_peculiarities.md.DpkElEdT.lean.js @@ -0,0 +1 @@ +import{_ as o,c as t,a5 as a,o as r}from"./chunks/framework.Cq8AuEls.js";const u=JSON.parse('{"title":"Peculiarities","description":"","frontmatter":{},"headers":[],"relativePath":"explanations/peculiarities.md","filePath":"explanations/peculiarities.md","lastUpdated":null}'),n={name:"explanations/peculiarities.md"};function i(s,e,l,d,c,p){return r(),t("div",null,e[0]||(e[0]=[a('

Peculiarities

What does apply return and why?

apply returns the target geometries returned by f, whatever type/package they are from, but geometries, features or feature collections that wrapped the target are replaced with GeoInterace.jl wrappers with matching GeoInterface.trait to the originals. All non-geointerface iterables become Arrays. Tables.jl compatible tables are converted either back to the original type if a Tables.materializer is defined, and if not then returned as generic NamedTuple column tables (i.e., a NamedTuple of vectors).

It is recommended for consistency that f returns GeoInterface geometries unless there is a performance/conversion overhead to doing that.

Why do you want me to provide a target in set operations?

In polygon set operations like intersection, difference, and union, many different geometry types may be obtained - depending on the relationship between the polygons. For example, when performing an union on two nonintersecting polygons, one would technically have two disjoint polygons as an output.

We use the target keyword to allow the user to control which kinds of geometry they want back. For example, setting target to PolygonTrait will cause a vector of polygons to be returned (this is the only currently supported behaviour). In future, we may implement MultiPolygonTrait or GeometryCollectionTrait targets which will return a single geometry, as LibGEOS and ArchGDAL do.

This also allows for a lot more type stability - when you ask for polygons, we won't return a geometrycollection with line segments. Especially in simulation workflows, this is excellent for simplified data processing.

_True and _False (or BoolsAsTypes)

Warning

These are internals and explicitly not public API, meaning they may change at any time!

When dispatch can be controlled by the value of a boolean variable, this introduces type instability. Instead of introducing type instability, we chose to encode our boolean decision variables, like threaded and calc_extent in apply, as types. This allows the compiler to reason about what will happen, and call the correct compiled method, in a stable way without worrying about

',11)]))}const y=o(n,[["render",i]]);export{u as __pageData,y as default}; diff --git a/previews/PR237/assets/explanations_winding_order.md.DlVqRHt9.js b/previews/PR237/assets/explanations_winding_order.md.DlVqRHt9.js new file mode 100644 index 000000000..c87f9300d --- /dev/null +++ b/previews/PR237/assets/explanations_winding_order.md.DlVqRHt9.js @@ -0,0 +1 @@ +import{_ as e,c as n,o as t}from"./chunks/framework.Cq8AuEls.js";const l=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"explanations/winding_order.md","filePath":"explanations/winding_order.md","lastUpdated":null}'),a={name:"explanations/winding_order.md"};function r(o,i,d,s,c,p){return t(),n("div")}const m=e(a,[["render",r]]);export{l as __pageData,m as default}; diff --git a/previews/PR237/assets/explanations_winding_order.md.DlVqRHt9.lean.js b/previews/PR237/assets/explanations_winding_order.md.DlVqRHt9.lean.js new file mode 100644 index 000000000..c87f9300d --- /dev/null +++ b/previews/PR237/assets/explanations_winding_order.md.DlVqRHt9.lean.js @@ -0,0 +1 @@ +import{_ as e,c as n,o as t}from"./chunks/framework.Cq8AuEls.js";const l=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"explanations/winding_order.md","filePath":"explanations/winding_order.md","lastUpdated":null}'),a={name:"explanations/winding_order.md"};function r(o,i,d,s,c,p){return t(),n("div")}const m=e(a,[["render",r]]);export{l as __pageData,m as default}; diff --git a/previews/PR237/assets/fhlxvsp.BC9L2R1H.png b/previews/PR237/assets/fhlxvsp.BC9L2R1H.png new file mode 100644 index 0000000000000000000000000000000000000000..c442743865867bf4cfb9a006d7ec45fcdc0506a2 GIT binary patch literal 65244 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%0DAr^u~%2m$L zG+ZsCx4XN$rzbKCneUB$Nu)kIAK$N^KR2UvN&me1f#Q zafcF07O9tS-XP6cTU)EDsa1Gw6o!SVySa(G)!;^l(|`YaHPKr684db*$*h+z?HnC> zczF+bA7o@q0O$^|YvcIuSD0yDE0B1b0nLFsc@|84_&QMMWJ`*_`G0HebO1HP+ee>o z6*U*D>#;DhJE3Xf%@L&Dkr5%UKg;;=t<8!5n$NF>pp%l$IXXHbGS8ejgFmtQiHV8N zo;|~%NBMKfvHVxti9Y0j@c8cTa*`-7*V`-SZ#Op}z2`wI8bA<%zi;oK(nn&WlK=AM3n2%Um!Ms`f4|zr zy4f@@?b$Qqn>W$0&&p;i{NCTS~xkO08_oVk#q@%Q%9!@OwIm%`_L&| z#6wl}&&o_jcJ{!)#k5Rx#N6Bw(b2-f!q#(zM49gh4nRPXeAw01g$$({Coqg^INMM2l?wqtMotdG0IRhlX@69GZRJ*S za&q-IN)i$s#2soK8bmwNfz3}LjDz-5U_CQmy;?AQ^wnILk}_<0*{OmNXiBqAg@KZi zvcdzkG_R;=vNZ6;iwTrd9bPS!CO#gXrQg3N7}w|-7!1o?BbrQ$eqY%f!17|rz_7Tr z#38|gtpr%|C|cM?x$>vNnpn>4LfRSLzPMw@4jZr6gP(8-3;r2z-_9pIj*5(&r>}6F zY*sh#og;Q9xp&-VpiG>TlbG#!cDBroYGMu!4gfyvJ{lJ=b7K<|U@4Y2*OzwfrLdlh zaX!LtR3U|0lAphfilcG}`v7>r?h68^H^-td$UR zfOuMd!?^hP0$WX=3XqXLK0dzTj~{nDI?U5kDqfkIpD*nBFqZe)$i&3=fu{AxazIiO z_)IYdCTaI&kP5d<1|_q^6(b{Avt}k~>GB=B_RROIJ2^Qa zbXHm|AACn_O9Kts510OiooQ0yaT^2dp$1pl-u zK(w4|c@H;Be>moQ59+J_E-cFo9Hs*4em33}pL_<$cC9Rc)SLdxoJ33P7 zk#2Cpc(GB5Lpn-TW1Ju;osnJxGNQG00)_901mPQwPQVuA0O;g?G-rw8j@W-zX?Ni} zKfe7oALXy9ujdvLI>5%s&p$X|vx8`pjF&=`t@4l6)wJhgO&1iZ%R8-$k+^4crDNuzI|&xSGZ|RSkI`$#9*o)ojI&nPjUufoQA@R3K?$h^Kx=JMn?Q5 zF7*C27D%jD2MMBrx%p7(c`vVWbjbqUyW>>3VjECj4{a5%tgIkSL^mASVPayUd#9hH z%SAYjHlYb=@Ah=l;d*b~4mFyfkHdD}^Jhu7Z`5>Ii$v9rNs2yvmYRA7NjWY|Q$>tP z4XYWJV)u0+SFEqRMQ9g$Uc-+kfz=i74SpBvk_q0PyaD1g*J$PGD^xy$4Rw|7ei3Y%@bN9z;-sppUNoL zW82An^`q6uoWIw_(P!HUS9p2&1Y4dDW)GwtI$H5}qsw`DWyL4#)aDYQX?oCP8XFrs zDyy5x!NoN(IjMd5@{Q})KWtblD%Ju(4VHU!_Vw|Chcz`7@%rN=Dk^GkFO$+15D)`yFpSjlh+>r(-ZLbG z1p=Lqe}XY5Nd;3l#2f8ev~%D-F7I--uCMjm>i|Y*+Q2n~SI4yikRr|3)YSC%8^jd{ zxUzvj2INC?S?n^$lF-y#SGQK-{7&aJBnZEU4?))ZDWw7VBa3^W8?F8D962U7IvQlm z5np+E`2z-e74S?_nDlVBWNd^p?y$gP`veH|t zL?hJn$MNxjvIA%;pNQHTsyvwbkdqzp(VjdwXzhv;cUVgngY!s7gY5kinoJ9)bJY)uC!wy(m=!_jdG zNyA6#2pK6U1Q~gfrX)#iJ3b>cZvCY$Vf3f=usMMMhb}SV(3cfRbwJ>qeQf|Wsv$`# zBvDrDw{;y{-+dpL|F0L|wi)N`v_tP^maIl%PSYxLOB$XLju^KFPXKaFf#g+YX0~3D zn%y|I(%0V~9pylUSHkLIc}2w*sEFa=VQ{RE9z8;tKV{lTC*^9V;!$cp`Uw|<<%w5) z0bV$qO<|%XMV9rU~?w`5V=%Z;QRo@c8R9>9WxEjW_c1D$JX{_1Mmy3amt z+Oz46^GHrkev+3L%A9V&4Qw;0k##PvBq%VrzY-z;8gZv75Ng!6``SU$AXp);KX}P> z@F3)rsj)Gqjo&tqD-;wIKs6g5guo8q0c?yXfZ7&ipm%bIc&`3RdhlSE?S3p1cl~R2 zcJ}!*P#Az=9%My?dHn1W)IY_^>FeT;RIATdl$}i>8yp1T!iqEDSKodpX`V zrWJ*Ax;{5MzXY(asMN$M- z7}3@+Fx0UgCi6MFWcWIiPVm|L_fIrRU==`%S@sx9j@+&CO11A!dYri91oY$(*LT54 zY{&tNp^M?Mv6B~b^)6kKbK)h$(#P7`a4RG^Mz;Lh{SpqtXtl1|W>cqyB zSH<^QkGdX|D9udwX}-a(meilgn+6tIn~RUMcw2H3z*Nd-OKMAkosl5?P0k~x%4*#4 z&fl{Q8iwtTKSmH%yS$A=sEiBkQGWw)o|&D^<-kP7EV1m-5_0?uB^wpJi_0p9a;Wg> z(-#xP?0I+n z=#!Y9`XeriMD|Bqg2ECO&KA`n;a&nOA z3JZUOm2L0p!f`{>+(!6EN5|u-deDhJe^+Q_5{rsf@9x+Y9UYCk2f0E;M+Z~J$lM%U zR&o~W=%q$SNBjHxX?b<78yjor=(w)U4}-U*rKKfEB~u=NftyP$vS^sG47dRq^RGwj z?H7=?pq73e95jlf=U}2RgJOdFa+2^GD09OeqcHx37a;fMXB;Kyn@<5u9L6uOsf(>0 zjs7me>J!iNbfQtUhil}23N{KMTHJGHnt6U6L|ot%UpR6)qX4pYjT!;yhhz)NE_ z`Y8n27CSE>C`f&EsfU5X-hXIc!Fi9d*PiB1KUNl214BbU`H-wDEiqq@jEe*3_yN5J z+E<{i-kzSA$B(69I06xeJ{?@2_sWmMxm(I;?4a6%>!X$@u)0Df0g;hys5bU{hp^zd z*uS4yeW)Z?=jT71l1KD?4q-Gy?n9@9nBTK^?~(z7J>t^!QCd<`5&+kW7pC&^)i@+{ zWDouQKVxUmHwRlG4p8<%|Ki3}lO*myUP0mqa+3D=ZGG)pH)TBwi6(UtpT_I+2D*poC8iErvc3&&6o(#q5KncK7)mhh6cE~C@7f@e%<(c zihzMlhpYW^j4BCB9Q1J?&Kd>9ueS6CEa)CEdk8(K`xSa{2pCp)(zA_CPnSSA*MFIn zH8V7H-PF_>rvy$KS=V_Y$_Wc|^A9y#Faw0LNIz1J0*@jgF226DhANvf#|DNJvZ5QB zF{UI2dV1JOx&{W4KN{!iyv99K(hCuHCQ96~bZ}TiL95%vKrO$Qg2~+4`ihoTh09zr z3IZSU9J8QtZL$3*U`?UzAPac>P;aIqaP5Y%XTsEnTe`SS-5)4|d4rT`t*1ikgG zFc#^r+k8C88}(+VIXHGvenpVv1O@Hq`}Xzg+rq-zmX`1BhJlQC+BP69K<;UQ>1Ws< zY&@WLQ)A=i{O~SA2I5lJ1!H@A!6Y?G3W~ylf{%Wv;*h$4K=!dzpMd-1IE#n#k8j+^ zjvdo~nUOJxb2vV}f&>q8Mm=80Z%y$YMOIv^)8?&Efzwg@=v76O?ULSpi);#Oo04yo z`+h0>kHx48P$4rj^ITtv0$EBgtW8;2R!An`<1?>jL2IU#U*ia&surF0`HJ(myQSUH z*;(uA)w3i3@P}w<*nR)}p5+;94t(Njw^zQdw$=otkRWK;i2<&nXVAfFJcJ%$-6gPh zufOwoa)a2il$y-HrlXo0g47M? zy3Qx3tx(6&!m-MFtMXnL2G27$M{vME9YZ|1f+i{6gghn2Kt@7xB*t!jaZ&f}^?TSq zH@9^p{lKjI*kC5|Q2J97(3iyY60ladIk>+9ef;Wy`|qVyp_KfB+hOg^^1=eWw7ZkL z`+KBxuqyU(tAL@g{6_4)J9q6eYkJ~mg&Nq|+G>wNWmMrA7!q<=K;RB2M4UbJV@O_L zI@u}4z@kGTznZ1hlq|iW{32~X2dC(|*V%glr&~P#e456Zg z+utXwE-2<~3J-zf{p&hJ?MG@^q}@H&7mrFwC6bUJdD+iZ2T*f>aZ}pzPB?9)1tlNU z6fWwlr$M5mOK6iRcuX!%&LMtQYl!*Cq6k93W*oI+MVyex@B=`BtlbdN;PB^J=mtlG z05M<-D~4MSxp1M=2~-`-Ksq{f^5=kAJ38(Fj7BFEU^j2(>cA*fX26P)r;XpRwETgp zVJGJbv;bySP*Bjw$Y`-oULvW&dA8^6+qW^M0(^Rf!JA$LI>^iGFZfRaMh@7M3(npU zEEGUrlj*3i3sTX?28-8vMWH0R0;f+GKr!OK_Kp)-Qd&AmsLuyB%xJ6CGY|H(PCFS_ zj8npKW>9Q*1D6UE0>~uKIll30k0x?=F#2y89fUO1R8P`K zMqzCuiGX}W<>2J>yiaXrpnL;9PUOymtgQUS_Z*}J2>NpW zGB~J#fi0W>MK6&AFC04G@T@EzYI0*xhIFF0`_KUGE+S|1Ev-P64>YHW3J>op_b7^r zLJ(`Zx{5W%&8;azw&>uT;$RGw%R>F2HFQa^54~7t zLqit%}Iq267NPzL9)Qu-)7PP zvTG#Y@enfjz`(%T9AFb1MOz9aNitqf$`si`l$KUjLPA5m0bTHX(5`A^XU|hk_-FLo zB#<2JL#QYns2~AhVV`M#xgPhAjMT8R6Ige=b^EsWSRM61Rf{Xb*wZr)2v*+Y>!#-B zu2_4#6q#+{{hj?jj0ar~aCiPin5LlR^RKy)t8+4`2o-uLcmxVK$FnoO;m@CsK@vr+ zG`eVc7ichW zz1j2?Mt=BrtFE+9QW+VN{U-pOKN7IXRQPby_#_ zx<8D%Nk5IWR77Kiz&lxm$=jt*P8CWeeq(Ck^Q1Hq0@p# z5X!6T#_yBFzE3&mB%OKJ{~VraP4fq6K$ZyLw_)$tH&}WHd>CSNq;wms;Nl+NvL&D6 z0gOJbi6<3v_ztn>kC=mTU&?8FCeUfCf||_?4pWHN@AWnO{pf+_;>J|`EsR8ZBtXo zsuBd{HUM@M2{p2CC6aR2h5K{EajK>U2F$l6eJR8?cI}k^$_1qj52W>vrg^fSYgE+K z_Q1fnevyQ7Sni;Ju(y3sI1No*@j3Ys6?JuG5?Jbo&hIW3a!b_{g3=JPvpVMC-2S{T zgIF_adEoo8%cCZ!>$qPreYW<_&h3fj%7l~@qbpYqC8^;<1a9>VyNDJawHA>Co;Y@F z66P)_Jc#5EsVZ6XYNHlcB?H-{JqNvDgVQ2^KITw@vjX)Pg&KbXDSK^id8s`1b7S2t znv<^1OE1Gnk~%*>-Twmol?&s4fC)pMr+asa>@}A>)zu?~Ue)nerf?7TO8TN~t zTzUCBaHpFy%{5eZf&i41)HLp3AZ)lF?H1F!uJ0$hrFZdYqsS zJjIJE92{A_Bsh{bD4l4%A-@A?C(HT_w6tJ|gbB?hXkI82xCWQlk7yx2ecIPWY51A) zGaE3?sGh&j&r4V4!?Y9>b_vSgWIV;V zxE>~6MlVnXYci_y8_QF3r?s+r&ig(+S-v3;=6ho@#fM-%Sbw3VscB_F{90fxZD`_E zR@P{0b@k63lxa4B=ibMj(QCgH-Xl`|vv-B+M3z-WtOloW5_WKDMqdcmA$N=7^o$JnMDbwrMSfNarW3Sidk$K4f836M${e z&bi@ib!LH&v_TEsD_gQvcQ*e77j{zpP^xL+Z2YJIajinoiQrK)YtFwC(lD;2t$k3s z1{D~9WQu_Cyf@E17eD+uBwO2u817nOpvK>@;DGXE7bM%QmPoL{f~CL&O>#0k;Au~v z!uC|G|LgU&JmL(d4_5mSM2|rhfBQE7MuC2k^#Bv7xukIp!+XhEQdbavliJv z`yk79E+N~g*wV0W_QFeokLJCLiEVk#|@=XHE}rhtIpFdc-)gT z6GNr08D_j~FUDk?QhVuXj7)y9Q2J4lRL}(bb#BK>J%5XhLb-%?Nlr@Ywmfwihvn?q zk2so;-;B-75Y%sCKD`~9_OnSkrQ}<7axbfj*X3@9XRWDExR?bP4jowd4*U4)^yoRd zR%uuCTp%4V{&d8b^XO3^2skNtPo4x{B7@nc0aD-SCP@mykP4C@L<>DIAfG=ge^8$T zLR^s2Ei(_x&vzp5Z9ze3>)`FLbUUDTLwlBcc7j zCXx8`%3KA5J`zyN;F-d6isZM=&Aaj~4kk1~0~NziRPH5Tk^*e^?rYxOGIMc)6#fr< zrgy6g_LMl9!IT59Nd$-Tap^3WzAS7u>dDB+0wxyr_*Q!g1=5FEY#uJ#~}2bu0( zRF&DZN8ZPl^PV^%fo2MJ_}$vgO-+EnLVm5C-h!Z`Y*IMZfdT+Z2L00| z2hAc$?%B)xL?r1+6V_#T+WQp@r<#>+fQCI3_F#T#DM8}S57EjtsD;YhFhQzaxBw=V zJ;vt{QH#;7yl!mo(F*T+*!jM0E0G?EG5~G~PV?IL#Xo+n95xXenS>zV*l0K}RO4Yz z9l+Gi&+b!YCYO;>Vq>*c>Z1SxaE9v=Ch}`EVq+@BO$vK`%w}|&%37XqzcO<8DOYq> zR|Prb+O-m>(oh$xRhKpZK0yuDn+U@<*-7$rKIN1tzYNwQc$RO+!BgE*)&oU zpc6_b7f|^Hb^k+=H-h5QC8}nrhg+iAqo69vc1;rOordj2#H{%xCGl|ra#{c=kQNRd z`j#1;FqrY5DIPJ4Q8!>T+i8lZa}0@)yFb@}$n_Itu%6a^dlkAgTnCPh-LDuOzE~386TY}5xuy`eCVPSz^#=foH0O^I6 zD?oB5pge#F1X={(C+=mK81??xRG(D6aA8F621qO9E?NQSTm!OJVeipG$!nQAdy=b|;_v_cYv2kcOj{bT-eAXJ^*>#Qei;=^%7;-n$A+RkA;~OZ> zeER10Ne^KAMTw^FKI4-J11B&7mHhblI6PQ~-%g^9>o0RV$o36mO)!G#L!%e5{C3>; zE7~yNh;MC$D4MQcxYD(0Jh5j*+e+ya|hq~_Q zmtK)wm!Knid6}01@l` zos$JLZx@LT*D{|zy}O!8aB{)#5*id_wMzf6tnu;tfjjZqLN*?2BrOTed4|E)bVa9jLV2rrY5|0n^Zz1gWrklOA}lySi`^7$E&dAMyRx(cv~ptfZ`5B+?$U{TKR_m^;HXwZqwjK;1 ztN=2xGr<0{XY9F!VFd*%;Nqy|x3;!0ytI}8IEIwzg9gs^WoBJY9ANK)Ybxd|SXo&| ze8i&a$@cB5&T6@sAaXHI{DkMQWCT|5e(6t4*r0_Br2>$Njfl8>P?p_V!0-wK8)TiM z4sBzY!h;Yvv=A>AF|=C#W6pdM`wx(vm6-{z@`XMQp!Xh_Y%9*IR_ys`_IR_GpPM^y zV*zf1v%hXMH#R29`pB?Me*gM)zJFI3QrJl@E-hVM36S{4$1oL*D8lH};fb0O_Z3Ub z>Ji4Mw>P7TcLcUjvXmNQ^v}ZLbm2hC|9Sz|y_$A0vl;|{*HgCe47;6n^8F9z2#cAT z-0q*BVhV(NA6Y}h9^05Aw6I?J$;mAC!=Z#Jx)NyOP}BTt2=EY#?q)mCU*d=4MrEk4{xGYfh|cs6E&|fsx~d=YbgE#$k-C zc>~YH9%AAnzNX+e8%_J(-3o%Bh|mY|CSGa*8R}Qnix2!`$c{L>M+Zm2=pchgBs8HJ zXN%+0jbZoT>4S zPnYW;xjV&A%Oe+Um&DEQZ*OeZb&zz!1%+Ax>N(?Lf>MR=^;{hS396<>5u(IF<5Rug zl!lg8)BO-MBK*R`ZN8J^rn~el#0Js6hBXBv%;zuWD=K;84ZV zLbT>GDsG>4!qgIEp|&;+{E6Rjnj1)}x(=BG({H4tfndd=q5{_b{K4=8mhKiXBF+OE zHVF8zkV1L1`u@5*-y-TR_t0QdN5=|I8HV)$n@fDQy}^_oK6D6tSMW_bxO6L2*hoo_ zogZ~50Y3;`Vjh#y*i_ro#(VCEg;5UnW|5@AezuvlG)fM>KS|(5HIf`ZwBmyY+mY+h zR0CPT42s!0oEfmse4?T*kj-!n)QN}G?rIglp6i1i68g{iix=-WJ7ZfeYic$$H-9Q( z0r^xfYF?0^51SMN6B85<1p-!RaKkhaddrJyYK28bb1*u>hXT(6^k={&Oy#I0NqjUB zQpV)ZtuN6y-UYu4;-K<+cYFP4bj1VdOD%iEu9@H8zg4|M`V z0$fLrhR_MhtElYH5c)ivjvfajx?b-IBHaUYbjPpX8iS>GL@h5SnBnvZUf#y$=4J#D z$RBtxL_`WpO0LPvvt!uj-5;R5zrWx~x>4IIC2*^NH{-(aoCSfpTBF80~p0uP6d2Sgt-Y&GfG<>h6}>6|;y z(Tezh$Zm#ufGP}_0CpH%o&dhZASQ{!$7?d$1L7n-NU1c=q@2-=J1NMY#s#ynip@_M{w12$BiNTx4cj^dPpj zww9JpP^S(atT7P+hwBMQ;-ErM7!f0I>cG6fj`c-UXlt*6ZbGc$iw!W#>p6EF`Zl^3 zjFeO*EdS_G(a>1LFCc`GiJ!GkgO53E*M`d;`uS5IIy=500=fU@O-%y>uhm}$Wo=3@ zF70Is>El~dqdAJWSjgu6%Zwt0{7;}3G3kt<+Z#0xG318ehVD!>c%iG(M>aQkn4tNz z-7zyG)F_lrz#^n2jK6C`1+K1UKYe-y)*`Y!HJzQS8R;yWYWhTqKaeC@SXdrzs;0>N z#m}Ba7{-XliAdi9;fm#G(JRT!w1jv+_5_ExrMa1ck`h)bf{*X=DK4%(+K^V$ewqMa z!UTge9laP3KvG7^a^svcTtw{cToJZQUAZ?=!#r2-+FrYiskj;(S%}<6BjH0D zI02_n!}xcY$^9cDB8q!}Le`S63VosWv$j(~aAC3u<^y@_+t$`)m>c`?!xAI!7&+62 z3+#NAWNI0e;Tuacef>Uk#dVLj*G9t-cp3vafCmT68tdx=k5iJ7J!c}|VAl?yJ~eu* z4+8__Fj{SAN5|0(wyMXt#M#+d?s0UU5FC!>I%3uUK0$QC+S=OiNI@Dra2lgO|Jm`? zx@&+}z!%k>6c!W&_2&iip~^8TqG8hZ6@Mx)(d^k_d2>D8-P9f*4ujSsl!ER|Y(K=N zlgtvpOmqEwzTstMoA7PJp#sDG4sdYtUn%)O~Z!UL{b8oQwdm&>V5s1_sb(c z5~NI0e*PSo$}fz=u>^5%;l*1VQnB?V1u^HJbmLlnadBPHJ?F*DVDfUfMd1%W=LZkk z7Nie|c<&}b)G;oWay*4-t=vsz=Q4uAQs;;3L{s|Q8e@1Y=&>FxZ6zE?^iK?rj;=a_kfU) z@hw~T{qpDP8s4S^emZ=am50a#R4o|Ide{N@`RBgBNr0~$UIJ0tdw2>t6C)3;fCymK z%82Y?iE(fcN@x-h6s#J2jziN0%?^P-s>iLro;%FKz&p1bd1_ z!y~aJ{QgJd;RP1x3S;}o_Fz`_C@f(YE_|u3zTY=_3GDyn%l9N#D>e!+90GiHn3fi3 zgD_i|!`6xrLp_I3vp?!gbi+7`CB~P9;#HCV;Kv(iOegYW#g`M%)2}yK;#90Xk-=;6 z_LncWf)kMS`0^w96C1KHU=`cDX{cTNT3c#C+XMyw4!+}u8&0!f4;zzag z>g(!`A3sh9ZfIdpKvYzFEngkd=;+35YhND|J`aflIs~Lryp%AK{$MYpCf&GgBSbxP z5zy!Wr=Lb!a0dghS4ee}U9uBPg!T-~k9nu8vNC;m;ZRl4?ZfTQX1W7k#lrB{Hinr# z=p!K24X}w=Y21BaU_Dx-^@n<0IA8FL5a@IhA(UJ67ZR}f#dtr)P2C_W-;=aR5H}5&*c(aQ8zAtZZ;|ncaBz7TzNuD2Udh-_GF8 zIV*y6B_>HyVN}C$L!UgbU59#yOCVIy%*^WUNNB5Wj#NWWuq0|KDp{{ze`{@}$2e(j zoFy($QPCH2C$a!s*|;(djRW#^RaL2Jw}=U2Zx;ZzK^ILqNhJGU%tijgDx=9@_dcH`CaveKnhVK~=W|)NxZIk5rZ(Qu@RlDf`6>@VAPJ5ApR4 zi>s@)o!|eB$<6QB!M3&nw;wK9#(nuE8o?%04Ew;WgNDx4%?)GgMJ_XP88lFyz%j$P zhk;@oPs~e#q{ZB_J$9SD@h~yrqK=%PqPlNHhi{+}pcCNV?<9vJj?<(3?(x6x@z^B( zKfh7z{4K&u@OT<^|L%ViendnP+$1FbF6{s9(?i?2E_3z{SMF?W%Vwypq`Pz7;EE+Z zPjb(f=*$tifT?%kyMs9c`VQ4Hu05X1B>u{p#rOKl{pww816tSY9-r;H#d^YB~7LZ~8u~G)paMkTuCS`B!{Br>aYnYGty|(Tq$h84mjwg9a<> ziF?i-A>97m|7-pp|77rQ<(Kzg-g?uQS-Q_wie_BoQIwNj==reiIG3)^iqpj^S%+`E z2`T;eHE{vgwmP=GJ*u_?A4&3jKgcoA>HcTedkcNus~rsY2zw`&#$){_Wj3rS^7z!^ zOOLOYIhx(njz0WWk|}{N-Xi?M&Ais^3^SM5J!d&RJ#KwAn*5gc>^&Qm)|YVy+lqBl zx`*ZB>$63JzsBRG>rC_3J+}-D35)vS9{26_LA%b(9K|qqrs=(r_|5IB%UwOBFz31M3463?d^yp zV!TVe7RWcGY{qu;^gRg8RFGb&Wv+Jdz2Uk(9$N&UY}XvbU$Iuw;>AaDAN|Mn+Gkm~ z?bg9Yp&#aErK+5OOfEVV%_Na z{Aa9}aDcwI~IdQD0Wa?9p}cR8pgc1F>AIgQn8TE*zcI#06eNFX>b_w9|r?d5j$ z*c`^27~U^H*Sw#vc&KVGYhTVBdqNW*d|Ma>!-%=toX22RbdQI5_q$t+qPMMWY%nh1 z04^n#U-T2c-NYVKM7lGW2xW4pV+*b6zln<`Qxn<8+1UMc@YJzSw{h8TZ@N+P)4R7N zzPMSbm9qFFQ1mZhw7B87*v#uZcd@11&n!Gmhsvj(1)ZR{i0}XSsz7--LYc+w`6Pc4 z5;{z)E^gFsR=UknPO^u=<0RuBE3@)V6W>eYI=C@Fd$#ptQJ)ZmIZbux6%N+*I_#h8 zScI|+ynpPAwFlKz@wIyJlT9W%Hgjhr3R!-8X_Zqh^61&(%%OdLKI^eQ^sv$m`?GFU zQF_l~RbYkN1e);qJ7ct}PuK;4Asx+teZ4kYCmAOO;u$jgQjcwCIV8OIxN1CBA78&w zJabBpnq>SDPj<0O*i3e5w*M*2y`5m6c5=t(b||adaKQ3O`;_2r9{>81?73KvCuaiy z=7FT<)+Ig~+Y_jZBHPM8Ke8$pLTot?1h%V5+Q2Nq{tlyxC}dl`m4AD$nI#p#{WTgY ziLdjr2vlSzxet1Pa4^R^*ZU@AT$)aIS`U~mtN6)wo+m7?0HKcHuXXw%P5}3<=0!vtuxbC{yuucv2)nlb^Nim zq6s!xcjiYL2DA=Ehz_`NfSOujXLnc|_IGiKSZsF(%lIBgXz3y2?JfZBltz7d9(7)4h701H>CnUkP zq6A+SreULPHGA1ae(u^9WX<;kG?go2u-j?~9a!<^seor+g& zp`HFE;Xw=P=zBusv*UkikIC4NhKR;&WfoM-7WR5?Ev2|PIbk~>0kSwY3Z^T3X7Tvh zp>6c{jjfkeN9NVb|WdBaX#ScVy11_Zv-UqV> zu?=766z|1pq+J(JKS19~Pg-zjk$wG(c7efEzCrP7#WlnKhq1SS%4++*h7Zz63(^e| zih$Berznl0AdS)>NJxXAbO|WZ9nuIQQi7rgBHd+x(nvSF>%hIgf4uKE#&?I~j-l{8 z=bU}^UVE)M=bD?HY2I@jWc>r{yI9Q!;6kLpo}%XF-nUid&sGp=saSTm*O#3V3FqS%C}7Pyl+=g7_QTG#>O_` zwT#-`^92&)`YPNhw?gh~W~bT<=-iir5>xrk8RI9_6CQ>8m8pC^<1QZVF%8eu^3uFF zhaJ3r(dGQeM0c}sx5rO^y_X(4&AW_kv{7s(~rTaukX&XvQ_{BvUE|)N3YmD)oraq zq;cgF9l-T(4|nIm79&+9CtM)v>S`-A{}_49=Iq9yTg(EkP0Li)zP@my>enmkf4Mm` zp5claCaDl=z6vYG(C~-15_x4wlnh*>W}Ke3o#v}!_Qa`PH(tiiS*xv6=81o$&wRm= z{!g5?+RkQmU_k>HdM`QDio>AkW1};qDJiTt8>dqB zY8`L-zWh7JA%AQ1$sqRkaD5A6@_GBS3p&nW;c~H}1K&vn(bAUt%q=7H<)1GtQiqd> z-@9>#WbyLr-Z(gJ|yH#|%+_WVW zyldjqyk>J=gtkIEGI#gn|4#wDsN#gIl%BrhK0r2TF~OKEpS`Xyre`8_?7D z$gKJ%!UJRMXFWiX+3cD$X&qpzkd^+cs$fdyXBXEaKfJ)bKcka}Z|2{XHtfzlp)$N3 z`VcszQ~>$68nz_JUP9pjGWpHaI;ckh`$TOc!If&73jG1#M-c*4cONvFMM<2+k^!AO z%vuY{H5#&)z-22?8R(=rSb#u~b#>u&r=iczG-weBAHUx^PzXEgy&9Y5wN&#*e(D3$ z;RA2jeQ?a(5;x zN^;i{tYH8fQ3+C$I#?gIuPqj#g0|7!4hNryzh7E_dh}3^X;%XpJ~A}$9!tx^y{vr? zAaSj}Zjx5J^E>HJM^ZJEZJux+sh&#(qPshQifX6r>YUuqgb5qneY=D+bS`>>+|$C` zDWL^LGQrYA*8qWnLQBCMI#tF~9=1^G(z{QgyTmV}!_^mBwDh3fh49|uyZ_nOd0g$t z^Bj3dPd~B5dRJ)J4d6!rbsaQt8+Y*C8-)b1M;CqB_BGSb$=DRvbNj&Gpr@r!~Rlv{9dx zE?rv+<%HLtUZ_c^s&HItvm?g|+7#-aCMKAP025gFeF(PD0l@HAA++TuokLwl731am zH(V+U^JFvr?#`D&!(?NU1Dbh?@()aLd>vj@l2eekn!f+BgNu={K${`4&AQs zR~3rqr93G*_Obk;m7gA&qgJ`n^hM<+B^8<)+>TmmnRk-qz2b#PPd>97dJ0B$#!XKr z(&=(rM;F&^b*y98lnv8W;jeny7mTzc&*yM)xzN6es>ch2FGH+5M))oM4XR`36taxH z{`o=CPE;LKdQV=a&jT> z&w6yzcI9%mf9%+k1K-l*NN5TYY_k3H!zM-Huh$Y@r_f<5`E%_n?nvK7puSjKW5nZl<%gKkn6%D`6 zGQN|QuBDRKVyC6X+R)bZ`D7GbUu$;b+!5GOD{RxWR~!q^)O^sza%|;I)TtLjpxMQu zsnJk`j?}b=AOZ2M<9ko{A8vgrM)&&_Ew=X0`xFt60~n4gI7@k9f|e=U=riTZMLapq zdNmzCqbX=l9lb=u&?i%PCF0p@!sI!MGSk8#PNuI;3osvFDx&G1moj8Eel1@Oaot8MI_MKp+wKA&%A&E-s^6YO-VDJ*ix@*pA``)F0m> z9{*>AsC7<$c4V3*-JDEx0MDBlH_u&tjeg=oR_EU+G*Ha&6>$&opU>^GidU5BBRn3` z;G`n!hU@PqCk7|M!d)Jb7Z$Ag(f#fu}xyZsw5ZwI@^6i4I?>CWiq# zC1LK=X2kL5=t*tt;;LJS%T4lJI5WsqRXhdau@`WU-+Eb^t@#IdCas2uz~GrUr=&Qw z7M-(YlPCA!Fw7OrZxO-wrbtsG&Pl>C36>4D=Ktj0;~d;dS8Y)-FZJa*p+EJO5_7Giev8SYU%X(Vk{c3k4y-pevp zLEn<)jpL^!bV7p%4}{*6@LI>A`0J+;8qRTeZ3u+FhH^XW-Hdd)euY3>pdWjk>f}S> za2I9wQ!^OH3j;H*%H$i)oq{n%)`GEfCUp4eR3}%l z{7-QG2^00TXvj7XCJyz`7mJO9s?_=xHBI>x=?@vS>BkkU-}6MAnCx?gHK zDs8Y-Pbd7ie3bo+S9m76&5oUZ`nfBG^PCP>7jk@``Al>RBdgyvV~*~-ak49=jEEl` zu2N33LlUqUlBr2LW9HQWkgVVCmy)-yg9N!)TRPUl^pD)OjGR?+o))0VwQ_(o@9~pq zNIlW@tzCXN@#sd4YUJSW?5Er*ujFn@f5@bvg8SMy<61QOM=a(jSB1D(P5^l;2b0}T zynG;7zFw?!vkD>oacrn&-5L62w5vKdy}mo9G3U=~m$mKPIBdTwXrho$X+!Yl?d3MR zNP;WH+`-DL-!E_Oyy|0lZEZx0kR88{T|y9q5h5=`IUfOS#FX4Y#%3TOH%o&Wo_AP)$5?{(O{dq1v!}O8m0x_VAj^ z+K-L=v&ix6Sbi=vFl9G$okE9EORvVNJJpGNy1gm#UhP>!?XmTbSFWoyU)et+m*?Gi zEvm@71#vwNS>L5^(_Pbv?&1@|b<+c(f=ga981}Ofz8T#AZrN zd$3MP8#5no=;=zeN-a|#Z!K~!zg6*U>j*Y=mEdPS4ys+0HnubRzrfH7z57&4b+Nja zSUAFmQa}^em#4eyA%t^F8h4Qy<+dQ}VWrxJ_zGOhONI zRr)ECKN;9IU47%B6aI@Q1r}gjBwXqwNg(tYpcQZz*qPH5P_c6C&Fl>i#h@ic2j7_V zH9GcgVmylRPUvNDjx!=^=b|c2nHvpZ@PUw69r$%-*5j)*eS|R@CoiI<%z`pKQBweE zJ01lbNxG3T!ApHQjHWt-eoH6+cEQHA8V~XnmYn#cvy0rEWJ>oC92|5yy+_RK*fnKj zCvQcCYDV^Occ=Cgh^k=npR8pZJR3WmvJ5^=8C$9>Q+g3LH5H01Q)K-tddKOFuQfGQ zcpp=;$+<;^uEfm?T%vf7ahwaS>!NSzmD1DDUp$N4A|F~ckY$|X&!m-qdfFh=Aa8=+ z%Y4XY+=p6G#M_UF177<*9p!SFv zjL7cs4fZKe==}=&G79e@vJg@{8cp%YHbn3uIwaCWcWgdRwM-Q%wQ%LMsD`Os=E0G^ zdmK%wjEiCEmNHUi#j%NVh>%tCJlfK z$2aA0=XjA--^?|!z?k%Sd=^Y1h`epQ zLYmv;RL&2cS>z6?R!4A1d@?Z*zo!;#HmjyyHlguBaaqoKch$wdi1J|iji7tD-_v_7 z6q)>-{cLgyA!@J%iZjR=AR2t=Sadxo;tpQ1OIWtnxuN3vM;e}+dLMo6bQ5`hp$4LZ z62%sFSbd8EFy3on=EP*=u9BkvcDy4SOPAkw3p4(2G15^72f-vk-vc2sph!;1 zzHZl_PyOFklOIMnI@-Ge|IgKQk{wI?LK5=7-V#!G{dnNg78ogG3mIv6A`2_?#t7Nu zFw#p&@g|D_rDTu&0!$BPgRF2;zg}MNLiB0G(s*E~tNPOmuA-~il}-{6#UD+cLcGIC zh9=^{hAWa*Xs$Qya2=!06{MoNhVIiqZ9t=dMCX@5^wLPU!sOf8 zH^Q4LVoI$Fey(o?$XWXt4e^Ys5T zR}?F_)x(VR;kw~%sY6E#fFg!oD=kv{KS&z)#+NhmUrp9i9Ue>`d4sH;b@dn1(IaRG z&uQsZmy(G60&PQoX7kbx7ae?2IA!x594hqjJVDV41Z4>R8F$sKq9Dp@__mF-X?~k& z0=vC)>Zy0jw||iM0;tZkbfBPib>$-x4Q{9DggGiQi zO@?hP^_<)@y!nQqx8hzqDAT~9PuzWV3gDBAM)u*ufLejlwsHV$J4L6W z<>-SZ+YmoD-v8H%K**Lzmr4VO#b+woFOKdFqAW}uNtpmy73a=~|z*y1}C#Pv9bt0C2Le2i(!2zN)^y-gzdNEpmIB&)2=@8mGj{ z$1_IT%~UFGYzpi#%6A`j2u<#Mb8Guxn4z)#Mcv0~zPS3iFB@EUN)<5ll@_Yy!D<{t zI;2YRhT)BgMAH_QoXWRW-B#1=W(7ouMx^vxU&Sa!@8$ZfrGxp&gYn5l2j;tPZ12pL zEPUZiyX%d%aiO53r{^B{K}L!G3}!6RzHk-={Nel!fNm#&J%Qsyt}Ise0-U!7fDb4H zJ>XM-Yp(&&&!Er^EZqyWJYYu2v6{fy2l|$D=X5Wigv%DNrn2&P2PI%!y(T9Ck^F~o z3B!9yij+we3AxklqJhOpK2JW+iWtk!=gH?&^NaDihTI1~{(c}Sl|-9oLjS*56fdCd z$YX$>GjMF7RHAqM2rn4AFy4Tn0L%}dS#HQLy_+wo=ko;?R>kV?tHP2I;9%g-gx6XJ zxR}LR*8-(9*37@01QracgHBR|NfTZ`BmU^95I9ELOD=1 z8`TXP#h}`{V{={gDNu27!Qo6&hnu4glb#*WiZkZis|wK~uNtNjK;xitTz(xco8e(8 ziWvWWty#WqX$jFeCwAZ(_vbT?>=gLt(-^RkbwvQRXE*QzH=Y9%B5yN(FD(6!`*hyM zrwOqf4j|Z|g98N062KO3<~BV8`1O|j>Q0?N?t1_Aa%~$11x0dUXLKHZyEse4t)VEa4 z<`os@&VYBp_y>=gUr|zq@?a_D36m41NQV-Wx3kswTAh~1LQcK*n4gm1xtCYIsd@0_|eCoK4`=WQrn8s3O|voz3-x>-zk zE`!xLN>u{`dj)zIfe2iL#U-(~@Y>Vep)9+0`~rdm_*KQoW8-_WvaycEy5&0|GsSUVY zr_f+9fZhM&d-&%?~+&4JC?D4ydzr%q4wJTVkq}1ffC%Ffbjs0_w@V=Lyv;s zudtf|UOqh!yRH5^=Yrt7uEY0SxH=t^K}&Z8Y(O3G!nVV|q*+aic_q5_{?Nq(^4niN zHQF>_@$QP=*wsd}6{48N7M#Tt@+_ygB+c0$k%PJ9a&aHlCXasoP)!&)&O0-7DII=SJdDH#p-`9tnV!PquI#|d|&|5j`*XEbphfIQ6 z44wp|q+mk<9ztzgRG#4=XJngy+01k0R8A1%owZkpv9v(U!FgjG_!fV-e0kH@ts2zVAc;^@hn{=47}8(Oce}dE zY%5AzsoYr;L#R}pfo*k*Rb?tz{?C|e?^ySrS zl+gY2Z0;BuA*2@OL2(l*x|{S`P)Ze7a=u#ao%p->;>z>MTaOmEG!J>n9DCS$e@XT@ zk5ye94?xO3zbYQia`4RjW4qqcNOKe$#b{I-Iv2FH7~eNOLBkG5-{G-(k+ zy>oLnImf@xS0DeD`fdF=k_Bt?d?$bg3?hRt5c;zB@;;}i=268TPW=XD0Z%L}Oqnrp%n{^Kz+liWA&&Zb81m5wFD zB&U@5Z&x!vVSnPAbR<|wUaJ&`ZEW&u(b{E*wGv z->?Hj>uzsaWI0TU3BZp;*yQ4Sv}h? ~IfpZBq6O{5B^^SO+wUOR_3ObJg)m%I)Z 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

^7LJ2T1W@cV7J=Md(;;`e$zim@T*12N`#IQ|nvz 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 literal 0 HcmV?d00001 diff --git a/previews/PR237/assets/fhnaafw.Dz86q2IX.png b/previews/PR237/assets/fhnaafw.Dz86q2IX.png new file mode 100644 index 0000000000000000000000000000000000000000..4009c1abb86e2c71c1ebcb2ca8dea2bea3795232 GIT binary patch literal 14890 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 F{{gAEmiPbw literal 0 HcmV?d00001 diff --git a/previews/PR237/assets/grtdpgq.UKfqMM__.png b/previews/PR237/assets/grtdpgq.UKfqMM__.png new file mode 100644 index 0000000000000000000000000000000000000000..00dd4642d15025889967f9a4d2ed72c92fea11b0 GIT binary patch literal 60281 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 literal 0 HcmV?d00001 diff --git a/previews/PR237/assets/hjnwfgx.B8m6QFVZ.png b/previews/PR237/assets/hjnwfgx.B8m6QFVZ.png new file mode 100644 index 0000000000000000000000000000000000000000..abc47b3747cf384131e5798795efb776e0666ccb GIT binary patch literal 229647 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%0Dyiku~q26bI#Lihd?}L!G}<3O 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 literal 0 HcmV?d00001 diff --git a/previews/PR237/assets/hkffoiq.DHcwB147.png b/previews/PR237/assets/hkffoiq.DHcwB147.png new file mode 100644 index 0000000000000000000000000000000000000000..9595a3cd4e3b4a4ea13d9563f5624714017a6fa0 GIT binary patch literal 11197 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 literal 0 HcmV?d00001 diff --git a/previews/PR237/assets/hmxjqbb.DeeQUply.png b/previews/PR237/assets/hmxjqbb.DeeQUply.png new file mode 100644 index 0000000000000000000000000000000000000000..8a60753d00536ba6552886d98e4eefef8238f743 GIT binary patch literal 41343 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 literal 0 HcmV?d00001 diff --git a/previews/PR237/assets/hrgkwjx.eNayRHGS.png b/previews/PR237/assets/hrgkwjx.eNayRHGS.png new file mode 100644 index 0000000000000000000000000000000000000000..85371f2c31b7df4d98474186587dd41fbfb34d88 GIT binary patch literal 80428 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%0A+?ZKu{Tc8CfQLj|$535G%E@;ivZo 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 ZExSr;UYOeGL?e?p^^?hunY!n1{SSygYoq`G literal 0 HcmV?d00001 diff --git a/previews/PR237/assets/ijvdjav.C3SxJ3x-.png b/previews/PR237/assets/ijvdjav.C3SxJ3x-.png new file mode 100644 index 0000000000000000000000000000000000000000..5261ec3dce1f5a67175259f7346801f4e899593d GIT binary patch literal 23728 zcmd3OcTiN>)-NhbJBlzmBO^!}TTn@oB?m{LMS_ANl5|Ltm7GCDnUMjsk(@=6k|att zBRPX)ksO=cG^yX(2j#+AFW$+J9=ODbfGH`~wXQ4Lw2m zx2rTXv^g|1d;D;_;fXARVJ7^s?{^iY-)N}lzl8GC5E>c|8p3Z1S}rluea@jwd8Hz2J)IbKE=UtUj9syL$jjpB^{Gmwlk-`(d@eN@m_$BFUuQ> zf`W0|)ttInk!n)#@kDuN`vr+=SLrRc0YX-Yb}@gs=Yq8z^G#jdJv21(o94VSK!%SH zEhqdf_OKuP#qkm&P}p`_0Y^ilk^2AhKTI09$)~n8HEFm3!5U2PO|Qt`^1TtMhgPHi+}Y{>Gd{e0;5+w@j$L};%L(V+dsUf*-4@y9D=9`v9@(T;EliCg4CXyXH^_{!(&7*BAD0>*B zbLxa@^F2L2{_$gKyq6mhh?rX)3O0-gkCLz-O$wG>d%(W&t%fJt1HOV7W8Wab9qVxQ zTIEEUh=>S2eNwLEA^EEjWq=yH&~2I5p_AIkE!%8g(0++ww?*~;*4d5+O>P|=6z$X# zw(ib<^ym@$)||iXLmlFeCoXynpI|50&3|GNsGI7&`+;6XpnOTJ$I5=Tc&xDf7M(|H zw=;FK%QV`m!nI;Pu;Toq43{Pa8Q5u^6#wTD6#-Bx$p@4B24kK3BaQu8oxa{l3hZA_ z7x0=7AjG*%rq2&m3CuZ`IFl+?x-GL84OtgeEqgPIOjBbQ#^fr89`NxMkAzv3JH~mH zH1X2VBrK-=&RCeA4?OoK7s3Uzzto6a-v%_UdBKTs_XpAxz}FUv`#s9@DU4a!D5|%g*@9Al27_j^6NnUkp5kT z6xHYfCh3j4v*kre9bg4wHGlT59S;zw`07-*>>tX)!lJG3*uMV=*JZ2Dco)lT+qKD8 z+5B_v1<%~~kpm2Q-wbiywLUPF@qlnbk*Kqp|F;h8iqJGNGCF_$0o9J? zaPN00WA&g06oH8o+sBr+%M%T<7xfeEe z0(X})9xJ>71ubN?-_$9cXiY7WdFVb>D@hWcaj9Yrr%lnV@^Uu# zM^bJrKf!Br%CM5GS-IApOTJOSZR6xpp?5@_}8b==eSw8W(@i1_Sq*f=@?v@e*LPs)E@ER^I94nX)>zU7>D_ z$+0jqKRU!JIo8R*ChbzteqGnPpxvf&bLG%_O00e`TbFUjXl7Adai0^P|M9DoZ(p9C z5&5w2f1$U(6#N$HmqEqEw!zAcAD^rfxV*7si&T@ zY+E+}`2`__csX9S{6mGgw$L4ota7nD(~+XedXiUo1C_~W7md%EmutFDZC-ymN*?g0 z0xj*`-D|0Gn-lPTaY80FKk#JS?J^0cXO}JG@oc@>ROwx@5LzQ+q1AjE9B94e9c$~E z2+~q8oYLzmwrE*TH|o}=+{)|V<>{`xMX%OE@f1>yx5EJu*M;G9&D5;?mP?*%OO!FW zyylCMGExLD>iTrf`H6e-S3uL|J}

7Znv%jXBrM(t18{%4c@`4af8)3kh7vagVzd zi?R4F$If0y?LljK9bd)>9tB*iBAtU$JGJH%tL@jE{7r_+_)T60IXyReaFDNPZ!_g@ zt#vsM)Oe0YUPuKw6ur#or264e@@qkYO{I)CMP))1K121epMGmf^ymRYWnxE1jN|ox zJ?+T3ZGK0Y$i8(pSoS8isXOiM@a6jq;0i)s6o?vqer5nBu#HXOYbZUtfvd91V!iA4 zKU*w8q?k|ON^>&{Ys}=L@%8m=hru(ExNxO!TGd`1A6Pf|94sKYmxd-y&^ISw{fpAV zpXzvmJsAJgC8Ppjxc6D4rBZ9vef1mbPI|h+yW#6mBp* zqJMR~Q!ixyk;iHvCl-%5G7iLV7(4X}5=8U2=jpZit=#)m?#48T@B;K*Q# zU)L+_6C;?`eR*>)8EL7gJY&bx#Pd8=MU}DP24^txcKPN6O;@-V_Dd2{)av&#Vc+|V z3pb^F{=Aw@ft{h7xq)l)IHFlZ;fCQ#zm%@kQ@m~2(*XW6<)9CzE-`k5KYDbKS*uv! z4M%qQbq91b&p0xq)@Q;4#V!#$4I7ig!w?sroxn}071`KUau2?_=ek(`9C6W(_O{I0 zLU`W0eFPy_yNb;jjJJyLbh3kQ58d@y`-bXgr!OG#AL8CiF1KfodXiL#)D3QJ{cA1< z;az?l8JaR~!_PF&kh{#x)|Rks57XY>l$_34BE{ncDk3biP9s{!@A~F=@fB#PNx!xW zW{r*%4#)zIO2%+xSQ=8@I&PdG7`SkX_i7+PXnIY1TYsvZXJGC62%C&#p6So}@CgpQ z3O7hWl4o9J5b=#N;Vibi*uL_j>U;ZDQja z9d-n)7Z`~Zp7y=>Lfx0f^YeegHvLIKndq??t>Z<(Q@p7HMg5p4HgVE&5^{U(Y~}FM zLkAi5@1jZI$0?psJI7he8-k~jy^A+jFlJ32@zct9^Lvm)ie3D@i#K(#uX?G@xKJ3P zc4?r3uuxPvl2v*s8@~1BWq2B@-OyQSP^|RV9Fm@ra|&OiVm$2J$ZAA6ssy=L6Vn4# z-zUyDtP75Nxs1qeE4g`6MIrMi>x#ba^3 z-rksE{)|%`wJBd-NEWy@D`>R6@I0fCI_R}-5x#gT3*0)k(EW&CUF$v;;{i_|a-`YO zSkOSN`y9qzkLXp5jEKEn?ps@Aj6+T*agp(=;`K}wPw<(U$7D({9n{~ic=XoS90{GWJpn+Az7OvUo)6u!J? z7R#{H^Y+|Y&L*k=gPk~WIyb0`a+KAokQeFI=M_O@f1u?I_?GGK_m2e#i{LQ+(PJT` z>$X2WQlb@GwFIk7w@pCgx!2=A(a_wg#wi}H&nh+Tu?{i*{MTPB+K9d!T3BfHSzFmvEWRRp;-4Rf`PY8xB({BIpaV0_SJ2%|IPV`eW33a~Hh zhh0f8LRyM!i5oMvpg!Irq(h6o)7GhOCnWkTym<;CNBe zp(|jxc6EeJI0Xszw^&-vYvNWnN*q;)rL#337%+Bjgmb)@6#L4tKCM~YD4mCCz#-o! zL3g{&&8;pIdu$u!wlKYY@*87|pje-X`%LIRrhwy5ju#&evV=W)gr^KLERH8(D&YI% z(BeA=)1p4&i{z6#3eJI>P(E={i|z2%H@clbAYpdDqGZE$-4Wq<0&&z7Gt|-w%Kpr< zWp*Cq(qnQJh?+Ea*lzi0uyMFPvKM19n3-)8S5Q`B*|q|4o`u*#TOhlzRqfx5z$pUb z)wfNFp+l3egl{V%{%cgxa_;q*)ZDfK!eeo|NW0s36qJuWpwkYj6=?kUCklw<%MbfK zdp(ua<^BJ!%5~ZmgHg6Kq zy75U`PSF?I*$02oC{_wyLC*4}3gcDXAX!Pw|I0>4+h8$JiHL%-^+YQ-cML2HteNh@ zJ}I0FmoD)?^j;qXbrkg8C^+*Uy&o^3Mi6>rykaO$owB{2YYX zH*U#NDR^`9Y8^97XJR8cUMwCHe7^8xj!y1Nh&mS0#)iSeF1IOKlt#k|DpU%`@!J6R`)z3HT?uHY&P0!k4a0zMaGt5dS)#N z{z~a1+*mXe8wiYC-x$lADI^FPUF3h0fQf(>Y}xd@Ne1|s&ZZ}v=g*KoF^#orqtMc);XGr@&(r13Vgu5IewPzW`rBu5*!M|R z!t41NLvcwPJ*cfA*E5c%<<$SUwQiOaNE}}7wC^&(7;gq<^w$!{+Vs@xvx|+5(Y8mC zw~oEf@nUMVMmu*q7vQff!?e{E_D#|)f)I5?mQ;2*8p|-+z`};xec^N+SSK2{ywGzs z859JAGX$@@^j|?hfhuE5`*Eim9eTn90}sJYeJm1cJFB3q-I_Pn!?3?ml4mEphxD;! zFRQEZbwe3KoVV;wD$sUDL7A!TmG-`a$gQWQr=u@Ry9Q)UL>RSX8xp10t!&C(W5g2R zX}WrR%w5G1HqkSAW>^>^3WsgN>TY#iPmmDjB`H3D<*$%bDu)+L=Spm?*2uUy+`NgR zCZFyTxQQAR;|s*&gXQAbH`B0v1z}&S;*o_wTdmnvbuzL={UGR{{;>t>-dKFqb{L2) zYPlq_HeTcT`Ixyi9}2K6z`;#PQHH_r;Jr63y;kxtQ8&dYmQ+9p@S~E}PVDY;^H*H@ zfz%jce|gAouy>sd8PmuD1;(pPU<(Y_Z;r4DJ|8{|3}E$r;wE_amfOl@A{~33t+y`9 z#@co(D3{-GpMi9K+ZKR=>mL)stMG;5E4LhHOS94EoKj`Hs`R%d2hNq1{L82ezLMyA^;Z@Sowm|y4yiYUJcwlBR^4cUNRH%m6p ze2hN$+*H}scOF}dkOUB48(|7|n3i+d^5Y*h=iigO<+d-K@f*O@qQwTv z*DB(R^wT?j-GM^^cT6(hPS5cg*X2`)Tar&W{J`k^?fzpik#_h=0Y^X{cy*;n_}=f> zTd&Y^;;YBx;;oBRiN}QPwu5_le?~tIL6^HDZ7>Hs8nSZH&nvepH zbocG9t~*J1*Ue=;Cmj@}YN+}$_9tQ~K%BQ%zXuk6r*Xm3mC$VC2lPbag<-vW7qF$G zurzZ=`N_RI%C8m3;a7Za_(?{d8u4<}vsYOd(_fxve6P1OKEHDQ{c9s(Pd6+AVfAGk zot^uTHyT9{y7zllX%?nUyA^Quoq1+zlIeEwj@M1=&mbLnDbM&`n$=P3Kb1dUTmiTE z-^zc-7PcMxNBK+A(YANA;c4oBEC0+T#`n7+a=(6q6DsCsih8dixyff&z#YihQGN@p z9pzs+fxG=~-@z|C;lGj`_F>(Ba`^4lwJG)(VhLSeYL&s$(j){h`sHZAN}*bOwNda$ zsvMTQc0b_odzcH#KbiJ#%8xyDtT{c=BTm>_>+JP(My$>GNXyBa0m?t|3SEmfeD%P>s;?qfZxJ-)Q!;k?cl?i3;D!~5lzetMo zm2y`Lcs=!J!@eDoNWV|7``x;{sefk*Id9-4DV*n9zDD4kd!Nc}V$6pWlJRIOSF|xQ z0o$hH?e9PO<*cenWrEMD zTw?4@f%c9e*wOAqE_f;`Vhoi7&*lp|nZPZ`EAuNoSE@&&xvN=hhrb74W)kwsrY&X` zd#D_^_rBRl1Ah?@ z^4Bih@O#JAK^^;geB?R7PD4ZFuIdPkijK?Eks)d?dyPIDcVwUpO+zqp_vJsHk*qG-7EAiV+)TJ7It_9K8_~0&KnV z?1Gs`P+TYqr$;9-`z9ktktn^aWmBAtOa`#(c9_0c6}urs#Ftc5kj>)2C7uAcJ`%1@ ztYU8r_Qrw*M|DQUDjg^R*k1+*{2mp3emLUSlvuHx$(whXD7|uH_DvGnaWb02?@+;x z30Rxh_WwR>aDGX#F29EvNdB7%XcJVxv0ArZTU^fm+XP@MeeUmREp;Yt%m-6O1kgDp z80=R(b*rG=Zagv6{o@~~Se0hx%UE-6xeX=u(sS}#WN&OCKP)twDX^b=_jh)Y23B!K zT=E@!7={ISd`##CD5Q2}4awUOnZjiyMnyq5!GCOlJY=I9Elr6N{W1jT)krUCAhB*c zrhq${S!A#>Pzg-EhC*ia)7$4Cy?}E6?3)wbYns@)BMP{O*13e0{!+W(W1484<3&bA z*AM>MkhTwVyAD4^u|OINd_WJx0NlajamvFLg-f`+aO^Aw;M)n+1&9<;2FXCLc<>GW6QrV{V{fcRPrPIVbWyEzN8D)7W z$83Av=Ts}!gRjmvm!NJSE{s2ir)lpV@Kl`)A07!u<|iQlxSzDr&7*4*iPuaWeI9_s zA0>$zNzBasUdk^2vH;_c;n!K7Wau6Kn*~Uy1+6Y+W&!sw!Y0n2U5Vx5`awYDO0s~- z2l@~w5!!910!;P7M-LM# z+^C{H-@Fy|Ijh**tpFUcxlSIiF6!$r^xnMS`7|sn%y4s3+k5o`JC}M~Sl^61&OjHmmcP`B2)*mcZx0v@zA(8CK4fx&9%>=8p7-W5Ku87<5~F&P zJU~rX_na&MoJnVAFuPoZK9y0U_0d5>FdJdvmEj1v5|uc88j?!Xab^uMu3vBai;9a2 zRBkLVNYB0Hinf9bAblbLXaMkqYb{^VahGrR-2u3<+i=Y9h+2e*`BfqdG=bmlVX#{N z2ACI7P$!R%ylZ{AtY;NISzCr5EcCNlnkK@0DqG zfeyMDU`aYUIzrTCDZrk%Ma}h@qJhk!{_av|5<)o4yfcb63D;k#7au4Ch{h^O0hOS zV2TXAC?k~0FY4ZFtw1Z_Vs`D>S2m^T&*pZA2oMG8LU^Ue)PoQ%Rky`@@er#wgO6tB z{e9GKZ7$~xc!j#RrD0}M`X!4W9I7Ev-Q)Wa(q> z^#ki&peKbhyT*Z?64Xv8D|3%7|0)B>7rR=%f#qMV<>bEt0^sxK&w@suf!(rFvu}nH z{n;dKdfzY^xZIwnN^A6pb>ZDf`e2hzLw@L^_WW_B)+l8x-c|}=9+_k>r}X5o$L%ghU%v=CO@9SQMsDVX#DHV6 z(sFB8Zr)rNVjp{|l>6x@k{OL2z?W#ITsD{L-nu^KzC6=IP7XJ)Sa+>-HMh2o6|?T% zFvM5G_AA;K!2~SF$+*v!llyyYO05B@L){`*4#2k~3`4ULdtYzwMxd>S(bf=C$}db2 zxvZn@+J>>Ro@-!I!VKIdT69mDN1808t1qvA5^yUjG#zg;XENM~ZwWX>`ov^tWo~Y6 zW3!@S;v-QXC$kQ8O!k+%19oMCPo8k?;CqBeVFiB1OfltqmSvJhO+Np1%(_y`Y|!w< z%>F@(SD8+YGGr^ksuRTfd+26Co&Zo*xsRSXA8c6$C`G_h)qS#IFXTNkp5N2362l9ksW zNm@H85^Y`B1vIWv8ojqbK{ooy72=?}6psN4)uOX-%pXi=d}F7>3t)gt&;D*`VmEs7 z%dP7~Mcel|zVaTEN~XJVv&g2eY=(BuKvh+>uhf}bctrkZ@ANv|dqR$rZN*;iHmLk} zqCsSU5dtj%9^>cP*S;vp3UyMQdH}uFdBZ3W9}Jkg_ZvSZ2usf7*W7DW-RV?V=>GiR zZoO!ymDJWI$-9!AXYFk-L(om+n{ymp`<1|TIU?t*z(N?nRL((x+<_iPlid})OB}n z_KDT`Aw!S(Pem16(7#t?fEb3j5}`64R#op4jS~+o3~ImJ8bvoW?6K9dzs- zcPqU%iN^sQ1c)`4DfC;{9;r`YsH^S0HW8HY?Jm0GP$glIUHzuZ-V63bj$GV$@|fW7 zAM@-t7*Xuz&82RwbL${~1+YD@&9y#v5@@Hp zt)=A@AcHWzQ;yDo_)mkRMhzn;1qW zSN3in3vV_1OKbZAa1mwTBHVlS_fJ735W#E8-9{!-^O`E%{^U1#@3+6-X}3%EHpbPh zXMfr~)+W|#9_;VMkP`w-rt8LhmE3Zh<`@vC%MP%o&FqS`NeRolvSMFvJwWckXU`!7 z1V#R?NOtQTgV!A3JR|e=g=D}&Ie>!&fogzs1OsTwyC><3SSeuJe%97|jWBcb><1+8 zH+pdOScm(w)%Q5+?3;fZq>67Q+fiAmRtP{9h+%Ncz zQIQE60gxz=A2NY;MvVXfF)5C(t@MdU+r}Y8kP1I)2l+%nQa)vARrmIO=(_KLh3y8P zhA_nL4+T6=v)Dx7v&)Do0$2{!4LKCQ!&I22dS>rfT=Z#8R0B^CgPeegj`f*irz!*s z_Md)6nUBUE*dYL-|1H9MzyvK#pcol@_%z#-?>{O4fKO9xh;Fwp1<3H)#{k~et-`!guXyha8~aLrIhXF zK9rjMN}Rs`iGTo<^#S`TRxC|?4LcNsUaxtobbY5^kWc~dcjk_LmK?4|tlT&$M|H(A zC8#Yg+q7Rp{lN9Vgb~^%!DzoC#~!*AXA*)v+L6k!9ifu^q+PoaRrUrypvqpt30Owh zM_+SQe68P9EI}d;zv3|7m?7 zUckH9F5cA?%Q$cfxH9YUCMdC&k{Y&K`|_dt6~9?eWyf!>08--O&qzp@;SuYjL#hbn zb5Ch&V+>2^Aqy(|02M$|`9IJ-c~Mx}_lO}|8V}`+#V;o?QG%+nOHsX8E$9!y@|B_Z z4>V2imRtOf7}U4>0C6tQQ85Kd%De676B$PA<5hNA`z5>zxVk>*D+ICF)~(K?OkD$t z%n_xi__wA7#Xqy@uNXN{WUg!dUPow(RmVIV8IFYd?cpPS zZ{J(|mkB@x=N#N2>9hZ70!{*57n(AAwhMcjDF_nxmiVLJ+vkwF?9>3W%5u?hg!#b7 zs$%Uu>9Lrd9zWELcLz*c8rDiq;j04#Mkik(WxaI|c=dF7{OL|*@AF@%u5d#S$UTm1 z0APInWdm|tfUt9J%Qb&;UkAXM&^E@0_b9L-B`F9}RSe@(I)GWM3*5N-pYoSlC>=$p z)nvL2@F4fAW@E1xaPu1s{(L3&RNh3HH6ZXPMCAJW5R7Dl+=XuitQN$3TBWf1&gT`?Yv#TomdDGI)Q<_QG&(2Y$uf zcgh2&ijY1YE~vK6dr$$FpQ`Wx0w#hTb(7LZLIQTHf|j!>uERjeaMJ=x8@WhkkNyU9 zS~VqLP@n$j0cr(0+)+gR^d<>|2kbz2MpfXM?SI+>1U*XF%&hcU=_~rX4hZGx`!9bH z;|&ZX*j2Go7UMCF+R$=p{0wQdfR`ZQrmlU54$^&8T}}(bzETX41Iu!9Nx9R-59JJGeg*9(VuDT9f|*L}*arBSY~nO#-&eLa<-) z{)qV@R6|1`B@KP{t-G?6Y6SZG`WkyT)DgA%CQ`M7NFLnOHEqN;s6g+&ReSKLx&5hBMBwd(4mFe#qFK|$Usp3`YgZ~kfYy*25FGtxDxl# zzdRnU2N>H_I4++OkoZH(p9D+;_=v_e&-6U*A(kz}ak0Kk|Q>;Zu~%WPDT*BF4G zH?Q;vL|cd9vn%7aBZ7pW{fY@mqGG1s-lE>%cEis{63%S*Kh~g@A9)W{Xio64=|d&H z+2Tkcgo^WVJBhn51hDjsQX3-R>j9sS5%h)G5?_5lV7O!o9XjBc7*C~Z zXCrvx-{AoEY#RCjJK;b-8C%H>E3GDy7c*_I%?dZxZI=Suz<54${uk`mgSw6pKo3tl zQ`LjyDv)lEjw0Qje8fR(@m`$j?e5H$)#;H|i@Y7INfFoUj-nJBMDJi$A;I^bpTqiZ!dTFASW67W>sfLxu@BId^ ze|ZNaQ%w~HQ<}H?1TgXh4jy~?Rd{(I>fS>H(uH0vbp>=*6d;36st7U&mJ|A*~8^t&6~3eHvbE04k5>2TJ*laA6B4;KP@@e-8jmg9)2V33_vbGQ7EaZg8UI zB*CUafbynT8J2u!H#$>zXAj%M&++S{nsez2%b)}0)0RGa!M;?PlrR-uPUMK$x z;t-1l?*2_74;Pa+3pJPH^hAE3k)P3oM_>@UT*vS_IUGh+n7|ByzLCI$K|Gi{zD8)OrPqzchIi#*yNbfAdMZ{5tO|8dyhL5gZb5WC2D%CXlMFaR z*Xgfy(b^)ggDUJ0MXt9s4N)ZyCx_cX#)5R?5HQBIuXJpEAiGX(gKD3U`Bj^ebhPgzC}V65;Hr&+((BCPB2TJ3M*Ow;fwKvnpSs0>1ZHGO(v{tWtJ3?al=DV zeXOXG53O7SE~d6;8$#|?BWb4FW6!Is=)i1u?nAhsge);b1XxdCYb$~2sGq3wA4pAeJ~T=w5j z4Gyx$p&sKz3hFT;&dGDqPJZ&))n!|WmUfwiqosRcgP@pu7fqhdtxYWshak>BgHv)e z{&#bLep&}%#iOaL+7|>wH(Il7QpK8w0-D|!DEK0}Pk}s2olv^|$TF)suQBX0Fc+y= zY^+lae<{BD`GsRrg-8zU;H_)`Upkic=2r;F(IEuEx+IyEFMwXE_T77Q|1O_3u*Z%T zUvp~a;;E5LhP=#sX%ZOW1)BeD2~GmHHc^T3E?|g9LXn-l1Y*5bFyKWQ<_`jq= zv#P)jeedYZYWYF{Zpa56w`H)tlln$O(ImVyb)zoo8d58|tGHcutAi5*awtH8qy_nd zD?cgvh=`2>*mx0!0%S_j%Y(q8!c@go5pJT(XU-L@n~~W zo-qM2Yvv*+?TsLC^C)pTqCN~m42WQMAkD6f?Yf?(9`7-w z8#;1SXOxEKxGK6A!1W_8zz-Z;665ZSIs$j{_GA&H^hg}6F9Cg#3?3ZRdG^0!gYGCr zT+R>N@i8cYTc523)FIlx=L+n9dngbUF~GiD=p6Zr@(9xWs|g6C5Lh1B5>lG zr3Ey_u0}RWzPbaxyb!%T?DmJ20!w1AtJ!QZ=CupK#%6@oi=%WTvQf4atrP=k$jBP} z&TAg#4AfgPfSqX90#TI)C6RMvC zP3rQM8G{iLpAS8Ru8PO3J*Mdm$drBSgCpw?6mCd6*l7?=2zh)F)hE&Gjs9g50Mv+x z(ne3sVPfg-a{Eqz(9a5c>aW$Ap-J1^J5P}eaDix&`dco%=gIm4<9J|V%IrZWaAy1kggekUh9uNi}w_|dy7~XAHUd$4E?uQ4IuCpl>H7e8OCTE z@`3f(dA3Pz(|0?*9BQyI|jZ0jW^NK2TU|5wVJ5WtS}q z^!>4Y;oS2hvpr63u5&|?v3Qt>Z3|Z9jxfL*DZ@3=PF4W^0b##&4L+@KX*t`hRW-!8 zJ0IYUgJ)@Ic)(!gCqoXShnFVzZbt}jF9H9or(v?^GYdDe4mCW8`!~ReCIn`_z6eM} zA?lpJPEG=%;b%~n?tbX!(~DmwG8udk?L-DDXE&IVo~h;&fIWy*3T}A+5LulJANXK? z7)eAhe;AoJlSA5h%N0m-YJQ~+83(wi*iQi{rn$ieuPXZCg|dh6`&l(B6t{TAHarHuw@B-FhFVR z`D!OVNIME2t8{KBK9G%&nnj+M<4^dxpzPfJgKT<{NmW+)Eq?zv(Clqv+zMaC2&{{F)1k?BRrv$j69?$ zAeoY1b8b&`iy}}F%tL~O(HKB)DWHr}7Q%TJyUdtC%iCmt>LhyhIOy&cFLzvyK+&v5 z6)X(usPsN039-R3O^6M!-|kkElhH51SFg@frVP;+x23T8)#g)xc!u-3)P1jNx=?qgS_yoR1S9y97)k)vCZ)-G zXk9F<`vIDTXljA?rZEI<;~H=%uBoxtkHLt+c3{wU1js0pA=g2V4FUrRQW?foIDD;# zP}2O69Bw+<2KLye1bYNv!MFDbLf&2ta+Qc+Ss=LmJ79l4Y>yWJ`%(6(!M8FX2mO_Q ztiU9QxdtCI^TGpmt)eC|jXVPS2mc>Fmc73Gj={DFbU-FbTf6c`kHybZQ}xfq)L0_6#^Xmk+{r^yvI zxCW^qcRY9m8F2vjgL`%`0G^1ht##&2q!5IxZvtHL?k{jj1sLF$SBh*TCSKHRd|)^2 zF9Y}NqXsT5?dk(MY#ajegpp8;+^0Zpa>tD!!=w9|_<0cle*poL%QLoS2rTuG$!@tF z#T~I=+%(GFmcH!gMt&THH`Wkvr&%bmhE{lDFeRwufvIrd2coXQ^fCYo!OigmFkz&k zrv)rRc+WLFRHTR3rjQ^?{s<@7y*wL>f_?}juo?iCh^Fm=ZiQn9fmlhE5%1GNEYN}T z68+{$a)+#{P8cKLJP<(79rL81;}XIvuFhkh`(C-+-C8BD9~TX+I(e zVz%7R%mkP-LRCk!Wh88AB-Vd!VD+NOimD=bSmDI}L7473QAdhW7N*VH^D zS0)5Na3uA7V0$fE(o<6`JMmCK?RB?B3$5WeEm}sS$C@BX-BEvDpyqn4n*|E_b#1B* zx2_@$egG$T6V3Sn_)gmNGTIXR@mGk?kM6GutTm(}VbZXKb5!6l`+!Yty^{oa&XfRrLSXV7Q%ga7oV zl6NdX*&aA`v%AOyluRuId!qmaWu^(jt8J-h%6Z$v-*N=$j{P_{7&`d!6*Rq&ix-8G z!Z_ZkPZUsy_<*A((AWSWzS&e@#4qeT+Y5KUpkBEBScA2NMYr>SXVKT+1DxG}#4s53 ztSp8WGoa!7i);q~Pqf?$6$f|2pAsIS*{lhnaKpI7^KeN-@}6BZ?U{*iB}#d=AOKq4 zJ)moh5FE;6LFfc_>S`4N{M3hBjyZ>}h}rBJ*jnibl$yzJ1@Oco^njg8#vh}5bS8W% zOWH-??g_Z>B%`R`t=w(-OzhrMR%5aDjWPtgjd^H|T!w;Taj`1^b1bZ^cvc$Jm?iUt^xVu-)KHL<<~E~? zW8%GW)@AM+;F}yfbjF}n><<0&&j1mF>w7%Oed5*h;=N~~S==tsIA6t1U8oh{rgSxW zi9v4}?k&0va5)%saRU6Ho5k>#r!)7OZ@#{J8=S?x_kN;q(T+-chR*I!FuQW>+*!hC zW23~_@KdD{xuquND9$-C`bDm6!KrsPd0SBz@-CU(KhsRqQ6FiSGZ{6^Grm1>mNnJW z_EZ z{>sqjkpM%F_0Q@azn=FuZAv(N-{(vVky_4mq_LjGJKO5ccoaRkrmC@SUG9p=FVFIf z6}W=xUjzt~;@K0N^o663M+L`5iXQN0tsJ#I#wu>3M+}C`k8Jr&3Fvwrz}MgrH1Ab* zMae=)FF=p@`1t7Q!EoJu-{Zu3@8gez(fVlTu~_HAnG3H5{Px4dte#_gwDsBQwseV^ z{Ec{Oh{^2py^~)81X2MO~81^aBPQ_+G zuyOObp3o_?!Mfhp_FIx0^C-7=P^t4*RRSh?9PwD2KC40&UQwulBoBr&hF8^FuvA1<`eKU7_If%Zk zx%)L^#l}KyX0SWBPwTKgsk`6acI<6JVl^@b`31MO15p&*5?rpcs;k~|ohj3f$shup zVb`vq&w#@Sy0k|tWbi|tadpk1UnGPAjyh^FC%Eyto$!`(HlgFyc~%)Xo^V#yKrrboDh)MpCJI)a9Na}!;P29lA764(LfDzLM$Ou5z3}Y90$#|6_0RSE8 z=htL57~Q-0*Oy&%`QASzMAb!xl#&cS3AUz;#JT5AWwAb`OZ!!zFY=SU_Px4i)bLdP z%jfCJQ<-aYU0L+p>N-*jy`TNwJ zNhD`3B%BOb2se`AIN0{&r0r$5*S*=BtO=|K2FqL*Z~BW~pZikVF=IcLHT~fwWpS)X zR?AFOy@iWObpen!nHxTMmFr&G*WE2__#I6Wgm2`hC4W;toA5{2$p954pYD9)dt+Pi zrcy`Wv&p#SA3DIqPnBUiaFkaW!dP->jInvPZhc68^@WhS2tlKh?z)`}+73*XbayN! zVUGCKxzQo^#zRsr5gcvd#rBJN@qCLu%_awbncD)sr|wyxX-`UYjg~H|Nh-}8LQ3McB+8+=Aq-?Hi0eyce&4p4Wt&MW3McLo%{mN0g%_5V=>SGJ_;+I|LLmt4uh zB7(s3ND^S&oU42pZ|&H8rfB{%+$Q0m|88v-;H^xRHySL{@4MZddv{F8_@TS=fQ(s8 z^L=xlm$`k^dbghJyQHd%#t-@=&(dq%f5hK45k67uTk!l*7NxB~Cr@}lAZo=+a1&k2 zw6UlN++<@kt2ZUyVGTt`_h0BJb#&mrQBuG3V}0Wfs}U^juM5UGC5a>oEzU2sgsX0uV7-;PIW1fGoYK zo|&HIY@217`QN}@bY+(p-fdOw?6odp^IQ)*M62chDFD#1V_WNnx@B)ndaOI4>%h-b z*?v6jM1U!u*93#@WzRB|PPQqlg^7&Pz8>$NA4!T(N6Or6kCsJcmFLcK=dCDRqPryd z!a3iTGe+2~0W8`I+~_t7HH;$g-YrT#h<};wvjFOoTmAMRoXxxansy%`-3UQ|rv;$4 zrb-bBz_kc%x4ts7J_Z1p5LGerzSX%83?u-nFOJqrO{OLBSFC<__H1@eeEGv|1S4() zWG7(Or$z!4-d0Az43oY6;zbtgwy)zwGT&7HXMiDUhzkMXrT2$%c_Lro*Y5`mSKk9s z-T(yb12iD`C4^&JogZT9U(hcCSRYJa@LyU$KyZkF^h-QjUJy`tQWq)QscT!l=g_%Z zZ+&(ltQbJ)gaApd3TSsg$w4gS+R5a}1jXFzr~Ka9o%Yi>BAMWvzwT~&2#|*8#xnQm z*XnYcOK_$|4(psi5oIJi+f;CBpppuhvnhl#6L@EeKTN#cd4$JPA0#vv1}AM;?GK!7ehqhP@1(w9++6@+XqXD8 zUsThs@+40~sa^2$b_mF!Qwc>rz~7|)1mjRXl91p-(*;_1FvPD0(JZ?9lam%EeKddI zL^nkIKl{l`%Ly9MjKsu52Y8#0bK~~wEbc%}H1Rr(QOxuTa1ax`@{Z8_ zp+{iJ?*RfUQ=QokM-v`Hh>J9-AKX5h_r`pSjt?>8|MZK}AHl#y%Q0ZVski@^AFtKf zvJ23bmm}d~J*p=-O8^}2*>~{Hoja#uacTUO)J+mZ`CG{Xp6L#Z2{(Cla)&`?++j$- zZE5^9z-m!6o_u82Cz1U8{AUesOP2t`?lmSg0NIsP*p`x&g@q){STIOU=j6WgnS6cg zoi9D$H0Qs6$}?-^hY;TOo$uZ;xHc1Zm4d7znPr_!^6qyXo2jI3?R~H-`IKM5BusR` zEHrD1dVJgq%g!vz%z_Tf?DCEh%jvJLx#L`ZZ+4I`fXc?J;B(*q0HpS5zqh@`_H>7i zpS$<{BOby)_$GwihG>7PA2JX$IdEam?!BvrZfC+RVjp1Ne(-nzo_7GqW^0Nn3fR}k zqObzDA!1U18l)|Nb!7?jfTTc5}2wJqIb%?Fb*m|#{`47OFA|4?_@@6QAkOd%K zAg|EjVnUJ*X9fYTe4^%o9&p38F!pK^BhQk1xK*P>ARI$s5u_m{Fx^nQm-bT0Fj0lg zYjqG|SmA2ZJAJ=DWORYcJ;h;;?co8YSukI~>?vJmfWf=NkPKXlXNGbTh-Shs;eNXP zFo#PYFu!O@V!fQ?Ny_X&ylhgSI|&X>7Xn~yuHzcrU!I;2D4ottwr1q0h7ah0ow<&Q zS$*wsTAuAIUAFOsp^(e5k_GbT5{|1M%Ot>biW#xdbJo7E#L>Mc3)nz<%##%%=e>oJ z1Q~K~-fxl#IS3@JB6pY>CR4z+)sF6ZsW9dL8}L4U^&@u}?AxJRbO`22i~%hzDRNBX znc@w1I1*793B%WJ-rs@*sL&DaeC7U0F-;vz)t44Zms$KZ02{)G_JM3}B2EKtUC)UG zDPO0g70ec}MjtqJnKMHM=2tFHei4_#^Rtvc6&x=jjId7HD0n090M2l2em4b-82?W=&o3puYrqtMF~M5iDtY=t<0_F=NAaf%*>MfM`$!Ost401 zUamfp!&2~5?QDb04;z%laCiBs6~OyD>v7Q}T;w$Dd@;8e;9An0;?Q3X*FC~3eo7s0L*5YkkufwUM|REr+iV8lxC*UDDQ{-575<9PnFmvIx>5j z63?s4EVqI9gdf`bQwnSWqX{sMb2;Md;MO|H(1`@RX_B;pY#NS?Ce6a|f9>C=>GHsw z1u8e6&CdUKCfzRBiZ4LaCS;jfE%5kG|4*~;|49R8#{Ao*hk4C`+oZFk3=$j~Qy3gV ztAK5$eBi0FD!`TYJIy$BmI_>3l3(|E_S*8^d1bdU^Y8ux#`m9B;rqQl-F;uTJ-~!v zfmCeKNmbx3%ULy<0u|cZd#)`3t_g1jmK=|OHI?4pFPCm^PM5EGu@F?#0jp_K;O-b; zYT*ZNXLD}j(VQ#DutEvAdOrbpe%kVNe>N6_&e{}<&bb)4u;G))p(s;eX#m`)0~~@~ zzZbZWd>wE#`O@3w!2K_v72UuTt22X_VTIY+^NXUlWL(^I-@I})u$fyPqO?E@ShlV5 zo~{RM82YpGN|gXxEVjTA7hp>y8(3;SXkhNMdZm%Cz%uO?u;DPdVuHezoj_+L_uFm* z_G_lPSLKRcnca5v=S5&W;PCwMLL>TBiS(&>p|<>&SCQjP=B{fF2YQgf)78&qol`;+ E03rEqoB#j- literal 0 HcmV?d00001 diff --git a/previews/PR237/assets/index.md.DjUkOUxW.js b/previews/PR237/assets/index.md.DjUkOUxW.js new file mode 100644 index 000000000..04b153294 --- /dev/null +++ b/previews/PR237/assets/index.md.DjUkOUxW.js @@ -0,0 +1 @@ +import{_ as t,c as a,a5 as o,o as i}from"./chunks/framework.Cq8AuEls.js";const m=JSON.parse('{"title":"What is GeometryOps.jl?","description":"","frontmatter":{"layout":"home","hero":{"name":"GeometryOps.jl","text":"","tagline":"Blazing fast geometry operations in pure Julia","image":{"src":"/logo.png","alt":"GeometryOps"},"actions":[{"theme":"brand","text":"Introduction","link":"/introduction"},{"theme":"alt","text":"View on Github","link":"https://github.com/JuliaGeo/GeometryOps.jl"},{"theme":"alt","text":"API Reference","link":"/api"}]},"features":[{"icon":"\\"Julia","title":"Pure Julia code","details":"Fast, understandable, extensible functions","link":"/introduction"},{"icon":"","title":"Literate programming","details":"Documented source code with examples!","link":"/source/methods/clipping/cut"},{"icon":"","title":"Full integration with GeoInterface","details":"Use any GeoInterface.jl-compatible geometry","link":"https://juliageo.org/GeoInterface.jl/stable"}]},"headers":[],"relativePath":"index.md","filePath":"index.md","lastUpdated":null}'),n={name:"index.md"};function s(r,e,l,c,d,h){return i(),a("div",null,e[0]||(e[0]=[o('

What is GeometryOps.jl?

GeometryOps.jl is a package for geometric calculations on (primarily 2D) geometries.

The driving idea behind this package is to unify all the disparate packages for geometric calculations in Julia, and make them GeoInterface.jl-compatible. We seem to be focusing primarily on 2/2.5D geometries for now.

Most of the usecases are driven by GIS and similar Earth data workflows, so this might be a bit specialized towards that, but methods should always be general to any coordinate space.

We welcome contributions, either as pull requests or discussion on issues!

How to navigate the docs

GeometryOps' docs are divided into three main sections: tutorials, explanations and source code.
Documentation and examples for many functions can be found in the source code section, since we use literate programming in GeometryOps.

  • Tutorials are meant to teach the fundamental concepts behind GeometryOps, and how to perform certain operations.
  • Explanations usually contain little code, and explain in more detail how GeometryOps works.
  • Source code usually contains explanations and examples at the top of the page, followed by annotated source code from that file.
',2)]))}const u=t(n,[["render",s]]);export{m as __pageData,u as default}; diff --git a/previews/PR237/assets/index.md.DjUkOUxW.lean.js b/previews/PR237/assets/index.md.DjUkOUxW.lean.js new file mode 100644 index 000000000..04b153294 --- /dev/null +++ b/previews/PR237/assets/index.md.DjUkOUxW.lean.js @@ -0,0 +1 @@ +import{_ as t,c as a,a5 as o,o as i}from"./chunks/framework.Cq8AuEls.js";const m=JSON.parse('{"title":"What is GeometryOps.jl?","description":"","frontmatter":{"layout":"home","hero":{"name":"GeometryOps.jl","text":"","tagline":"Blazing fast geometry operations in pure Julia","image":{"src":"/logo.png","alt":"GeometryOps"},"actions":[{"theme":"brand","text":"Introduction","link":"/introduction"},{"theme":"alt","text":"View on Github","link":"https://github.com/JuliaGeo/GeometryOps.jl"},{"theme":"alt","text":"API Reference","link":"/api"}]},"features":[{"icon":"\\"Julia","title":"Pure Julia code","details":"Fast, understandable, extensible functions","link":"/introduction"},{"icon":"","title":"Literate programming","details":"Documented source code with examples!","link":"/source/methods/clipping/cut"},{"icon":"","title":"Full integration with GeoInterface","details":"Use any GeoInterface.jl-compatible geometry","link":"https://juliageo.org/GeoInterface.jl/stable"}]},"headers":[],"relativePath":"index.md","filePath":"index.md","lastUpdated":null}'),n={name:"index.md"};function s(r,e,l,c,d,h){return i(),a("div",null,e[0]||(e[0]=[o('

What is GeometryOps.jl?

GeometryOps.jl is a package for geometric calculations on (primarily 2D) geometries.

The driving idea behind this package is to unify all the disparate packages for geometric calculations in Julia, and make them GeoInterface.jl-compatible. We seem to be focusing primarily on 2/2.5D geometries for now.

Most of the usecases are driven by GIS and similar Earth data workflows, so this might be a bit specialized towards that, but methods should always be general to any coordinate space.

We welcome contributions, either as pull requests or discussion on issues!

How to navigate the docs

GeometryOps' docs are divided into three main sections: tutorials, explanations and source code.
Documentation and examples for many functions can be found in the source code section, since we use literate programming in GeometryOps.

  • Tutorials are meant to teach the fundamental concepts behind GeometryOps, and how to perform certain operations.
  • Explanations usually contain little code, and explain in more detail how GeometryOps works.
  • Source code usually contains explanations and examples at the top of the page, followed by annotated source code from that file.
',2)]))}const u=t(n,[["render",s]]);export{m as __pageData,u as default}; diff --git a/previews/PR237/assets/inter-italic-cyrillic-ext.r48I6akx.woff2 b/previews/PR237/assets/inter-italic-cyrillic-ext.r48I6akx.woff2 new file mode 100644 index 0000000000000000000000000000000000000000..b6b603d596933f026dfecf98550bbe4d0876276b GIT binary patch literal 43112 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 literal 0 HcmV?d00001 diff --git a/previews/PR237/assets/inter-italic-cyrillic.By2_1cv3.woff2 b/previews/PR237/assets/inter-italic-cyrillic.By2_1cv3.woff2 new file mode 100644 index 0000000000000000000000000000000000000000..def40a4f658cf8a9f7029c98931f5c9ff5a00910 GIT binary patch literal 31300 zcmV(?K-a%_Pew8T0RR910D43K6951J0MIl50C~{>1ONa400000000000000000000 z0000QiY*(lQXGM7KS)+VQipCoO;$ltfhY!GKT}jeRDoP4GysAeFM&1+$3VOuFoE-2 z0X7081B6ryf-C?8AO(zc2Ot|B$ThMl7Its6bF^)RdoO{!7jRCz<#xbd(%Y+!Ln4c{r_hq9YZwW9|EY>ue)I=RfV)Y7czVA?iOgI5E>yc4!f(c@@!3(c5Y;vHqWGq zO4XG~LRu!wbC=WT$2-A*j*xr~OGAH&wLT_)U7KkNH^zblJw^`pUVwe%*n7Oops*pSz=~i zWlX%ffnZ}K2q>k5R7jKwMjZ1zSL`MPN34g5Q z37P-%bN%PJ$qfuF5Va17gsCvBNL6Jrzh$>_TcKME>=ya)Kn6mWkf2<+OYZXDP74Mq z5EfxnGGBy5IGg2p{_p?ybM5c#_oYzcH2YGR-!l@9I1cjwpFZBh|8ML6moYjO&Z$V9 z6R)Db+rb;zZ!#?e!ObpqR1*RMq72}v3!1df>}ir|`2)afM%AYJulu+b=y+gBfhD+qon@;z)E&?2 z7_{A9(Loi24!hJSjU-FsZ<%D)vO~LU?-AHu2Z8MXQ%yygm!c@rl_{Z&|KIYRzH_r@ zQ`-EYYPwQg;>2cme#oB7%cS&yu1YO?P~dVf3S$rkghOcCeR@;V_PRkjBzZW?3iQ6zLz4#+*Wg0Z70e z(eOBUvJL}*j1w6S{==r#e^rDDR(D~wM`kbv3|cnD!+HHSGCxnrr8H9(IYbs&1{sX_ z2k~0-m%cx?{sR3Gf%&*eIAru4V``jA?3l|p4kT0&DFFn+XI%tK6(fH_;n&b;2Dd0U z?S=snCM1|6kCjBMrg0qz(TEUj2+^T|T_WsL<_QpD3L)-9h`TlLUj6uxVVq{fMf|u$ z1h>oJK_xt)f~VE^BDFSi#ejkv9>#zVp%oWhy=4vpJOSXPz#HJ5@M-uu{9O8fOcs>R zunDe6uNY^1scW1o!kwEfViO*eyVU_784I9n+?jpl+y_Mt5X@^o^+dHNq${s$o7>J~ z^HtvdQCFH;J|a!E%V>}_Iz-0!Ljn~)+Hb7k^-E^rw$8K3*twy@j&MA z6kTa+C}$4o7k3-k6Q-Q>#mje!Oy!{`9|I5ofEI@P%{}_z9{|d|3fkEHV!Zb3vl_TK zd@HcbMPS_1AVwvm=F7%QnMaPibnn6x4f!pVe|C&9I!9NM$1;y5plH?z_;-5$KNgwa z6FfElqrz_R`{Cp17e4*rpnq0h=>J#i5baQ|H0lxc@#2%x)T)8rxBZ94ZtqC9=pO&_ z7Oxj_g^PaM&C#uo|Mb~~W_a9Ogil1y9N&J7k@Z0|F<%f4J-K}57ubVrC_U`8%|6TBM zSLfrs@l#Lyern;Zi>36@(+~cUdi(b;{3*Tj-2MOb@3{QfKcD^S;}`yY;|THw8UOn4 z_Wt)rzp7;4y8cOMm07+j$loTX^J{P1{QR$OIb^^59PiSd{_WJE_?6?g9ZH`#cJ$ED zkXbH#Yt*TE;piiaU;6psNBFm%KcMKl&-3kiuN^)7=-O-lxcyPm7XBdu4v* zA7*UxhX;6Z>WFgB*+WN+ z`;H$zVs{U5kM!ljo+I}h8Ir%i{{A16i$m2&T_7Ir^6MOS{kcsQxg-1+?2*?(`>9slU|{Aaz*`Am1Vw?03-cuaOH7pE@n zp6{bSqW@i)bo_67Uw+|*mBXuBLEPW{>5G3KPtgC!15g_^?}V!pzl(NXoOXVYe0X>F z*x^p+dd!1|Z5+&6F*-$Wy~X8Jd?D!w1Rw|=#xFmJ<5AzcJNJNxep+9jgQ>q0B9Hf0 z*tGM(g&*WlSl;t9g3V^dtwtz-m_AcB&0ApiV&Add4H^4z02)a;6&>AQlW`;qx8u}% z$vj->6}&}+bcG=uLkm?J8)B+J)A08sgG+%_7$SZJsZTBX^6!FWHsJ^eiAcy%L7qx7 zg-TliBV)W%~Hy$&Gq^ zy4(%N6xDyWGlLCd`(hJ-$+x!70~P?l!q7ng5K{DQ3IQ841R%g60PTSP!S-5wk=y)t zxBnA6xieirbpwkyoPq$Ra<_jK-9m893Djht+c!anH0qa!xp0D9&hmk4lMjI{(B-se zk)JW0ZlrR3+6S(49=|?*C3sg5_#~bs#wT#EqjnO57w{btlY-+Rc)N>rkPNCrUx~$E zoPH5|7+7%N061k4UCxMKIDZj+IRXmP_8nws<8lW_aa*C~zs)k=$xZ;EZN~$t} zTS^PqtZf6&)9XH|x&>=_)rMmW_jayRTaab)r1oUQ>D*_1@@v$Dk z-1w@s)Xb(R23EPb3}dAXahaW_|B?dU%cvD2E~yDdWTYV^f~VMz_!YeND1cDid`h~x zN@*AOP9MwnTMUP%5O3i@!C|GFoomqeZJ~?>8ok@%tMZ4Z>mM)&hudn>&Oxs9J!kygP=tF- z_%eI`*|TK&YX!nVmJf6FR{KK~w!!0SXocxCpmWJQE6llB6o(@9)HADyb!$~uvk70V zslxa%yk|KyVYF7K{!XLj(E`8WT(T@R%s+M1B`?^g-0yE&drr2~&;AKqmzF+lO;YDr9i#4^|umgbK0w$PamRyGu+#5RZ)kVuXAP9--gZO z=1VgsbC~UVvQU-V=|8;;UWTm<$t-nyg+YgD>0q)F_H<$1QI18Oiq&79pEuk+gxUAm z&)Td-Bk#bQ{v#33{Y;pbCI9d|SMuGf)XmtG!L5DszMHp6I%vept%J|sqxt2SKqL|b zt}YoGz-^by88r0hlOj!yJOzr7LWRmW6ZGico-|~eD`(NB=Ix%;YWtriSaH29gS-Z_ zo_oUGSA$A{;nBo_3XJ?~V%0YYN@Q=C2QU&O=^CW)wXLtk-99ukvB)R{|)B-cV- zuho#j^Ehh54ngTF7Y2x@O;@fXUoTJE;B-WMl-t@{2&iN=^N^5`LzHvOcd!{4;Xd=A zPGC!jad;qu0hTh!0YL;LrwEmv7JxgD_z2g7us^U$1%QxH)SyFbNdc(HIR-R_ESP|V z2*bJ9BpaePRT`3l2>J-kmjh0LDgvbDi%5&8mxulUmwgNs_!vJ}j1r(2KoEz7N+dbP zYHSwVaPnir*$=71;_9jp7PV7$$n3xu#&7u4w2Jg=f`_o@u`PH93_2u2rJMVsZzyD*mfAu*(XP?@cf0H|I z4Sq0LrTGI__f6aj-2F#_KQ!U>s-HEL43+t7J|4`?F>_0Zo#Qjgj4vqXDvEv#45AYpt;Ct8u#lVmL zzagcdtIN3)KjXJ^aO>D2in{$ZiTh&rp2vL&d-yzk<@C{(_N^fOM{6(j@U`JOSvaPj ztF8Pl@T0=YBN>C|Z?;rV`F9_&+2s#!qz|5b;Aap0@Zq(R`t0KqmyCArkCtia-v4Zp zstcTMJofIjGvlN0T02V~f9I>^Ki}pKt^EG{%`gCP5fHn0^?!JCzfy;DZ&%jS;6quN>GA_lPQy9h4C$x9p)17NDbV@7 zJ^eU%?P!Cc!uU{@_Il`qZBCqIeRV{KnnIlh0s zZOSqy0Cj->0C$UV-Y~Ph0W|k34|L7sx39{++Kp&EM)b+LPfVZL?b+pq;$!CdZgf!p z!u;^f(f@xaWqnv4Q3@bH8l`3OOQxv)@v9W^0sc$k$<~a!KHTA`7CzYBeGNY{TI^ zBvDCM*uzD%7e9xaDKW!*h|Pu`h$MS73_LMXMD~YxO#SCD9RO0G-f7OCNc(It(0u7o z?pO>&q{Df;Y^lGZLn;{jn4YNbwZH6s@_xR zZ*}o4-%!YdemU$t_!6GY-cX>>?v0 zX-=CDgxf~*D`t)r%IU|aXHHZNoU9dSF@e2L7kfp6l|CGJZ<&5EsjUC#aT@n}scE)8 z_KHe^0V|4mkwsL(_m&c3a8}$-*Wwo1HSK~g!9B&z`?qs2-jAPR7RP)>3fMMcgFc_r zop_@Q^4_fmj+*6V6AwbUg4oV9T0-l&uYXvKI&bcyQwOE+K3^8L%SYw#9Nav-F4!$3 zEb2;6KJviL7n^atIY~EAyU~)H6cm+6WaZwAsP}1xW*x+_@C^W>(wFJF;eJ(#Z|?nl z#$QL}vKP5L9y+opF12agcF+I?n2ssT>{!lw_(-vgLiyr$_fs^s2` zCknC^ori8lgn2`nP&rdGL)qFq#F+<(AxKZE9E2C)jU_&%WBSNEHl62HJ<4|7|DGEQJ`3c+j=I|Hnzkxy=BvOB!cLr#m9XAlaodeQ$0$B znfF?*dv8$MM5V}I=9InjI^lo)-h*B*tCf;9Um{@s_?(#2XjUeQUFjcfWo_i#!4k+w}!=GEBaAcXLS& zzv*cSP#@&c-?XuGk+Ne*DapBPQucy&hx}U8qg9k-l2aOk&j_Ar=FM}4s)czpuZMGy z5DCAI(Gd*0qnK;ah%-d_C>9^2VTbNQd?}{+Bc5Y)HU6hA3SA%#RW-^@h88KJ|IzMf ze&tB`Lp}%*Xrg7U<3-o&LnTjjWG&9rH-xrnYKf}U1leMnRSapD6nV#WUp5Ll{c3TpHm3hKA-8DThStva6(PCOjNWi+@}IXME-PEoG^DL~ zZqBP^nG9?mEwZd{o5CoD#_=pqSz5C%j>J1Ih|ApsDK1q}Qttzxo*BQbfH4%fk1OB( z-jq#Ev{GXx7Ut=UZ_=pAOlJBVk!np$sJc=PUA2m6aRmLC5*(yaY=B<))YqM%#2S+h zTG1!c&35UAWRKdE&y!Mubda^C42DEZiA+D2v7J$N9`(k}hXgp>|HHzSOw|wLLn-KV zztI0S$WbLZ>jW~hp-&pjc@LCn^R1V3FzORv1?)j|JZrC4%9o(0z0w;fP|@O2!8~mV z8uz*&dk%xNTIpP6PJSb8?oUw$R%eGk^dwfGK{S->sRKhBT$7fXy9j&R1LAV|Ft?^x zt>^q;HYE+YgLix0a^D)0``OqwJf%h}C_~XQrIrFRDlQK!)?1(Y*__mqahtl#V_`S8 zh#s+bHLbA8`u47307>En=%!WS58-XFzFw;F@ZhVX8=4pM5H%8Zo%?FGT9RkW6bpb8 zO>w!os3=uQ>{5U|q#i$S_@oqK>N(BJSQ`i8t#@%OtP{-7{jV$po5(2}QW^VCWekvc z+!LApb-M2|G7EZzQc&dYEhpn8R(QpIT#k#(E}i``Q6)Ewgvr8;b(@fE^JHuw_RF73llczv1;h z3z4aHCS01DS{cSGtni78*8RIXIgh0yTwZt^I%r(3Cxkj5Y+ z(g3zsV;dQdDv&Ejl_9V4>h2uyyHM&hl%`UH+fZa_QF%qv(FOMnTZ2EsxhLDw<*h8m za?NgqFpO1bN*kHIXm=>J4sjIL;Y{#(gx8fH8;uRk=R0U8dCFt}D0oNEge7=a<> z;WJwHhHT+&2~rTf(VCJx<<8831j+iiQ3@Q03R9Ltru-G9K2*`*)=#M|EzfCLi!kPz zc*gasRq;KS zk3#gy1OFt&D{C_jp1#-qvURIMHo=LR-0no+zW>VTXN;tH@LsWQtC1j%omX8L0pHct z(b?YCSKh+0ivrp9m^sX}d`UR9&f8*`)}N8Gg(^T7=&$C}Xc@yWZg*)qO!IDc)g#ZZhbtuHoxz-BX=WL?b+jB=!@huOOl zjK>@_{ZiPa!5xM`Q>?v{k@m2mEn4)`JFl~O^dWz8O>|6L#V*MO_ePhl{Dy9}a3Q(6 zr4z`^L3-k(sgM+EQ;|=kWsFk|gT_rSm&+bQ>FIfpCDv{B@;6#z)s5ZW_XHxKVkQu)0&zpD+3v#bWYFW(SKrQ_={IT8U#h!rSyjU+{jq8N zHXGD%n`&kdmDY!0qx+TOyeS~|Quyz{+Po;u47*Z?PcK-?h`(P~M)GuPif z_5k@)Qng`HcYNxwwJ^FQ_mk4(u9&0&%kB8eyg_hF@z3L~33<}wOAyH!tYj23C_aQ| z5fsAUxOxZ5EgH3G7Z0HF;8b42tw7H88)YiV2A(pbs=GU*QoXn)1R}G?4N4re%np4uFl;`?ivu;tt$JpRwTkxcX=TD{R=n4XNFaPh75UYAM zw^%DTYCS&W;BS!M?$akmr$R#g^#V<)aCFjUNhgXXx5vbK7{`Y1+5VE+xo?b0n2}km zD!X7~Pbk>beu6dZ5#Pu;R&*}HlTTt`0QTPu(a7>Kz}mwpqvUA&fQV+kTY*nL!4*j3AAEsq*ZcYdpIf9fSn{PtYsUYrIWug{ zQAo|_pB&%5aHJzIvqpea!??arjDydBP8;l(X!o0`{TIF|gsrbpPP~;-)P6Yyj5XXy z^-ebWOBav6^VU208=AQWd+`V&(Z(t%b}M7oGwI?fmPc{jQ&Sm*!ze&%NqD9qjg`gRjG||aF0I7>is6I?Lethu`_u8 zeu^~{>0Ktwp9s)6*mW3BKF0J1JQM~zK>p69y3RGe_$yK>UTrPK@rMo5M(I8&9_t;dT?EY_EbmTK?dcXyhNeC>)`wBJ_BriLAh)4v$!swgmM@K z7GYITwxRRT<}F#(~L_o669z%Ft1Z6W&a=nd9}$ zk1H^;<@Wnf%3xRI%ZfV>3NSZ1=60|89iYkiqU!d3<1YLU=bl)ve)8qhK`>jr4beu8 z?jMP`b9R`U?sY{(K43>h2@ah2K%Smo<#&}666)LP!cfVZRaO4=digx+tpiF75^E=LW9{{`FHF_#VHY|Jc%qyCE4bmMb=u z#=Nan5A&lvNy;tX%n$uu)rOt@^uOP0I(r^96O}Y}rN22Q*|othT@kGp&46kDMoAb< zpf96}{L%E3z7Ag@um?H)j&TwMrBM?`fN3`d(6dSjNy|uSCW^@ z;D>%rWx0@SIo2Z>CS7nWy|g;rI07p-GYfI&b0kAdj^hJ2o`{nIj=FuE&J%BWPvA?w z{K%UxpP~1~*}n)@cMxCmwZ6k|y$0QB){J*#i7a`Qa+P?+gKp{*!iI+CCNlldm3|5J z39^AQeiUkWSR)DQIfsZWsoL^S&*}`p*TKk$#OC}cgk(O7UW-hFN0&D}2mv<*Qi(XI zK{;-!IL(kE89)q13?@sJMBrKWo3nF;ZHaE@n1zoLPl0b!U*FPK&mqBT9&?TM)3XC| z0_n5W*3eqqM#k@bdHKLmt`svyzYgWSu5}q+hF}c%RL1;I9nHYaJe2Jfp;CecEN5PF z_d!#*7-kAPH!b$RtjkvRSFy^ln$(Dg8e@!;ER@SaX6kM6SW?5*n@hFsJ!mFLU}rFs zlcN7M6%R8<*|be$hFrFuu$arlp193GC;HZ%JD?Xf@2(om_Pu zvMgGkLHIi^G1&W&+PaD1B>+rMx>t@zc?=q2U>s$sR!B z>3fRJHP=^K?f;p#?t0^xb5bD@5&$D5h9j zuPhMO7S2*B!=lLo$*4kFLgGkD_9nV`2w}BWniTKPwF#k+1nTK6LkE=Hp53-kam>WY z>M`+u+rIl#`MQLgPRvYZ7x%_eciXFj{M$K(DAOhVOMJGaF%=dwe1@`PYy6cu$uHK| zl==|q`NKz))-C%xS02{=^$79Wf!($sF_m%5#0`mm+j?^6$uUD>83Jn?N}{!2{74dG z1zm*ZSqMv067eikGPzEmmfSeJN3GTN^GO@k@-!i15yst-@W#_hZNsAbT~jy^A~e{! zpwTNk4>Ot<(QrAM0U<*CO*84vA;d=8BpS?TMUgu&|5;*L?OIl-0GWm^{$wsk6B7;N zCYW@>si^$x!k;ri*iHEg2QLOA#M8pU-m|=}V6VKtn`1`?WIWL|)WcIK;P8KJ(tWr` z7wqOGpDe51xeF%C&t8RBp72%MY4B<9XkIsODs~hobwU;BP2r9`2pS>|k&@YSBRq}X zxMwLyX&Sv}JUq08l#~vSgvCM0ZmHqq{meJpIDGOo=#augr?a-ApKH@&_J4CnrzA%w_aEo>J;i z?(JLb9(cT^G7|Y&SpCguPD9_*(%8?G+J?!g_aa4oVnL<5(!Q4am29+Bgn=4Xhipi- zN|ugGQ`!^?;(RL6Ty(BHw*%cQqkB_8lNBY*XRyOZo{VikHcLe+)xy~b7Lwf?=L7Vm z&sG^KW34Jq&F-U;Uxe_TH=0)}3Gmh9pc$~`7m4}d;o?HX{b8U)`2NLN=LUx5lB z>H~^TZ9=6aHNi8zewPuR45#$ z65b};(kZeACg>xDo+fG)-1n-@;Rgez_j}Kaeepag1LS7Xz7*;?EjAaZ%zg6OJ#OTo z=x3>q6Ifh$NC{D`P<>#NJ?O=rP1cJ9m0msOyC>ftl3Cz|_myP>8%DYj+#DFXPA9)3 zCi3W=gWeV7+x`1;RjnKD5$zhdb)=5s?Y-QjR*!3z=G%)$JQ|4PKz?oUanWte)9=AS zn#APLZL&6uldBNFm4Nr+`ubSUz4^7_bl9#Eqbk> z#i}sb_Z_C$g-5}=xdedjM*wImd-E}g_UxD)lO`V;@tOqoJ`$MWPk>DX$id6r%fH31 zOA_M{o3W;S;kw1Q*}r!j2cOG7&ycIezr>a z$`jiRigcAc`Miu*i9<&JZz@X?_XfD{NyQE%5qzJo&EZF^x5dBSUc3I99|WdDZ|9Ie z?vUWZ(0^z+Klk9*l_gr=3WqTXOF|PCV))YkZUEj&w{}98XoqRU=wdpA9D|$=--iE> zy*Q50-OxLcv>h)@!2G$1=O; zFK=LEP;PLZ`=Md3;q5$RgfaFsPBbnx5jBZ6DKwQdT{Jx@Ju&MyFR-|3DQEeIwZ8RH zxBpJG7mt9lR|0)`q8i~z)F{-;7fu4=k$2d-z-SF%uOHeRX% zkHsA2IEGMo8wYUc5|5)Co2}bkK#2z48qzzH)p3iyIR&~c7D^5p06)?o3k|E}$o?NZ z@|(i1KOCa}Gb0>$YVwhH>jP^k;7BxI)4|(t>=uG*tpcB{VnK!v$MU>oRcCZ5!~c)3 zqlR(&j;;bj*o*i;iE0|_HE_FS0*6zIIfnDiB;wyU!Ou}w+!0tz|7Hv08XzXx5~}@q z2{7n*mglv}ce+wG*KlCKfCB^8H``481KsAb6bbMc2qz0ZkFD5-Td@_}BFR>6eZ4Cv zb(EMMP-v}!ohwDwIHis7Aj=>pO?}t2?EB!d6xT1rB2lPordd3$C@PZePEKRKgz;8S z#j1N{xAKyjk_wB#;3y8m*vb{JCrJ3}!FRK`4-bqir?hV<%6nNThC4~#53WgZF;}zD zO1fU#gc~hg$p@6QT?Zu_$e)w;4(_wvbvG_}YS|H4q2)qS2(hzP%Mz(n(ndIf=jQj< z&C!v*b~b(RbwL@Amb1@(-9sBH3RU@qR5BNAlj2BimXj$h6~U60geb6QZN6U(?SQ=G zTBqm>!dfEaa83zvy{vWU|p@CzJdqN7*6&SCQI~R)ciK(j7H~@1mmoqTdy_I2yWvaMfcl$a^fIpH!M2QM$y+nSPVC2> z*om#~%&{@_-OYNK2osuSUY5idiN>u-2t5IGE0xjtl$Hcen`Q@vtxPScw6HixsY;Z| zTb98!ZdFU4YpqD)-W`2Y4I(4cu`KZ#MgGNZ!E<9JDgUTZE7Cu0?H<^fNPIzVq5$e1 zK&U>cbxTAYqmLnUzx^~wTwa$ld+x7&?Qhor=hQ82x%R=FaWDsi7Kwe}-F9?)-zMHb zO$y{83*H}kyI8d0g8f##HsFf<+>K`Ok4_G%1p6gWKDCE*ri9wI@D)$@DXoieqGrWZ zT-iM|fg0?{S5HG-V6(;TR}Pl_r4$Vr9xWD@hKBqByVKo_gQ3y{gE&07JtJgae zPJkwtz|^OT3+1E*VOo}qCF3bqhKISWNb%>=BkIwbdZ@IQu7z=w>L!^Y^Q`PfU7{^q zbhK4fQ!@iyWx$%VsFfKm%);jS+Nx8MfulM)>|BC1IAimC*t=oFMjAHkHrQqF!Qd(N zPUji@X2sAA_ssaL3LY%K55nI&#VvlgydqbaJ z|3(9NvdT0Cr|ZB$=n_l-iL6|z|LLB`3Uw6!fNUUVmksChFYPUwkD|i#JQ_w|JTZvm z8QY$9qx89EDI5I*5inqK^Brx7=D;2e&?hv9j>k7K3P6DY1scL~;xDE-hSD^{aa|i|OtNeJY%>#7Y`8rRb<9yj znoXc6L6-}c>RQWB}vwF+0$JaV-DKA(#%SqysJkvfeB zHK{w>ocz=6RT!@zB(JDv!1r4jUU$iFz^*KRQez2T-L9cb`kE)IL3u$yZSt?Mc)HU_ zNPFL8V?;H&F7o-Df4m)!BX9KQVGqIf>!x&__@LPF*}GP59cfk= z=+x@68;?8sxM4#i-(2ff@}fZSggu~d_dVsM>_{ws;`C$18KuIQF*ka8S@LB3u} zm}n`g8BgcQjHby7k+P|~86b>hRhbdIfSIOc%A6vLq9}vJ&z>Pa=Ctb9XafR2ZYQiT zd0yruFcO8c76w#9AJN~_%kiD87hHoI(2L#&VD~vMiY!Gf&S0p@dY(*kyc+hZ21jcc z7%;(9S^|@&3@_OBsB9-#&u(_wg1o(Wq@R|sZq9-U9jb7=*j*FGYROdN<&>^jJ1d@k zeR8z3XUdHim!Al?b-XA>Ct|!gj8hEW8xbi*`IFJ>BBL6udx1t$0!g&U0~F_sj5oltMdwNa1g79$vougdtQx zI^+WDKR`O;BaBC;6>X<#X@i~< zgWbH4inq|o+a-y&tjk`_NTTlxf}Qe<)j(j24gwUIUpmtj&#_yrO`^%vitM-bwbZlo z;LTEp9`ohSUf5s3*VY8PbLAVj@W!EF3g-SD-|pzJg|=rAYul(Nn*zIV6Q;1i4F}S| z4?b)A!lhIb(tf>ZQiI37;GJ)_@ar(=UUpD8F+=eEM!mk-l*Tbei8PxrO{gVDKC45r zE(gWSR45MYss?6Fvo}6C#gjA3_PnaGfg%c4B~YM0?APK#md}e6j7YCL4*6Km$zCDZ z^7EImE&hjm&sF4%FB8rS?gnS+y*62X?b)!i5$siC)+wfeKlr zZL%c{3|hx;!3QR-m+Z`imoKioudPY#>GRpSx@&mEGv1#osG9S96|GhZE1C+$Q4~^` z=aXoa;5EljV}aUxVd@WDXyeqVOmmjv)HE$ya?LQLxH7RwJ(^L+MS^N{&5CPF6E!=0 z+-f3kCiQM2^(YNs0cp#?nY0T-mgP;3L72~5g7n$I<;@HrVL3vEUZtya6II8rqlOxW zQ9~^fv+_DiDOmsCMuR)Pg_-rl&;d=S6p)h2mt`0}Sc0TETU1Sv(3Cf;8w(3cbpY*H z_o=fF?a^GRZbHWWIuNe*D8_=^@D|87xnNh=$#&&8cuy@y!#W|a<2K_g9(wj1F4BsU zd|tRW#s0nwvVpx)Jo*wkQ>1mwYNTf?m&8I9aWwDEgaLAA_OzX)qC4&L6R4V{TeP{0 zKtd{?>4nU1AT_QNaKf}+y#!3SG^Gnr3gK2*& z2=I@q@llVP;m-WP@LKx1PGE6_QF`#34s>zRaaN{K2McpFX(v;r7ag@aQ*rhuDi zshE@$+SdnEwGZoLjLAjUB>w7uoql|4a%^??)z4+(-`^V_FUMa*(OMklEWea6cX18G zOT<;y-jxE$dq%)())p z1EZzP4Ah7ALMcW{8x?!?^(7&Mh%g$PMwF(@gIU5ry*^6Qbd*+7Z~XhvpuvR(t%iDs zNm502RSXBvUC2}4f_Th0_X`0_S7}%9JHc6@OO?|6~F z-dQ(xYO3tnaiA&VflCvb2t39i7Q0OPhLj$4m{cmLASkRTq$70`bh{!i!;<+{&)?lH zLfqA<$;CzC$~u2QzoM(k?V`g{+=qQ{PQIF7DzY3BObe)S6O+b=%QZ~w#?$QQU#e*V z&KmM#O)Dta!W>+#ksmJ^XqYeYnw#m-jv4`#iw(-ZA7heHG6(sL9w$1DZ+$`(8C4>f zZjxtc5U(BYYMttOb#!ADBr+ca&C(Sbsr;~iiig*(C&ti9>1U2Pj9_RAF2j<}GnA?WrFk%gvws;F z3b~;Df3Z-QEi|sb<%};ovN2VT)GB)QIo2I`nfC5=qn1u}d!><6V#N=3Yz%7$7mO9E zo44ZPC11JT*<9D{0ud8ziB3k5NCy6QyqzjsQkp{H9hcT?TZ7Y0t?S^$75PL1wd;L~ zp;%Ex&ULgKbPCnk%g^pHYFZShYX5&y+he_Pc#?$-A0ZOhVgm$XQlmGbVeJ5{RMlDz zk?E$KZif(BEHcL~9b%-okhg zrqjMjHTOx@bir1+FzpcJPysTpmclSssIU%Aqozs1R3)P#=sU!67_T%^=Q1LzhpX$= zh7q{Qq@NI?wdSLSDgCJ}UBR%GQDYKnat$QWXeAlVT9^A|=aBYsE*ljCa}r7WfVa_@ zAuA|UNh4H1x5kfQJ9gp@Y{w2a`&v*90%$S?lROLEj3nSHUa7KzjihN%vq5I$v8n$rKIDg99tDc&31KJ;Y7)>5~+liO6jZxgVI@N1G3Xp zX&Y+qxIPz*J$x(9WL9CXdWQ**ftR#H{X11qH$6c&$3Ge0iyN^Ad&dipMO*TAaTLX> zrXncsBn(C1WQ>tDU5=?hWVM3Q3Q(GW3`3P_VGEiDVJHma1i>y=d0#i)*raVAj35(7 zrVbu#7*R~|GHYe%)|D2yY#%;tyZgc|oa2gpa#1cBzO4IGm2aqGVA^uARB_vbcvQYP zXW?R`QhAueiR{QkQG7kGT)_UnQ)INo{hf2$ePgSvct-AI!d(L`zyCs2NkYCf-R~E+ zv8cs@C7YL~%rY;W{r%-2j!SF=xk>~Rv@x6$i$f_{ezxpEub=4_>Hw;qwZ`S`@jV0T zc;?nA4<2lhIaQp@l4=lXZGmDKPSQ+{A_!KsBC^BU7z^|$3dbZ+v4Lk9|M-q-jMK6{ zLcSgwT_^hDPb=y^(48u?_mnnq@L(vs+AZWKc})li_zR(yM?&&}n*{-i(VtJV({H zG!tIn6Dn>o9Q^Z0`3R0H|G>=*b8bV`<}qsSCl|4r7`VX)4K%O`4K$X=e5-h#!YoIE zfq=`OC?Fh$(*(t^z+f<$m^tLyDinMLp2ad~JS4~EHowr6;-Bpw8nlO_@m085`SnfF zJ7jh39C%t!zU=xY7=Y2l*X=!vC2edKGp@1upq@d=&@a)0977(KQZs$xH1uP}hONsj zFWo;O;5~f{;vb15vGKAkCT@V?eY{tH2U@;x;8)f}+v3bTL7Y zH=>PmdWz$he+m^U+2ENE>NJk zri%hFm?cpZR$Fv8kP8D+Q6Bl zah6eRnt{NA0t*V%iXa$Zf|tmvIHUpS-kHy8KuRf;49#G`(7+#+qNX9!{K8>^VStR8 z#pzAygWo^NmQ5}6FZBgmt~``gkg1~L3`{?Nz=1k2r5tz_ckovQfjj&3kIp4Q=>Zam zBaJxXA-GAR%9veq+1aX}YQSqmQ&?E;l+d;ab;{*(V!o_U_m9`{mhRr;gMUlVo=>F5 zk%J1{Yo);WX7mhVSYCA>TCiDB72y>RR-TQx}ibBX` zQM?v`{Pk0j?L$s=jeF&rV|}w~o1M(w%tArnbc}4^9l0@pN^7P}l`xw0wRVg@02wo= zGH(iB`k_#Q^cJOCooIC$&v>69vW)1in^7ywRW}w6+}ZvNusp2 z3CoiQbPQ8_kyhH>kcu0{(VdjbebX9LY+gR39W+DVq4(nNVJEiX4cLyY;%q5V0$~j= zynw7O;}&vPLX#VF%MM6i!}vB*;s|dS4hdMhgiJ8bvh8%WTj{U zDJkB{+HF^7@ywSyS`166Ok5w3pT!lc$k2%am*!es?@|^=_YU|aZS6RSNpjA$&r(?~ zPOPj*mI?*^16ed&>eK!7(5q=4nL+E%eujdQp${1_XAT>2k8WLAo0n|51vu^WA=hAM zwPS$Su#D5M|3G53$;r}94C+x~sh9_$B-~n?h?TgQMvbNnnhIatEP+wgaYt%%)`fG+ zxJ&AN-6yH(|U8INiX$J~8 z-B!8bw3|$Od@sh>Pde4cU?}l*iQM3hPJ*DxBYfZOQ*ORVV)M1#cD>!MvTLGO#{aVbXOa&==+AaI#J=7a*3&ffn_YvlC zs-8%AeuWgVlb(|9*USBBTjD7YbDgF+x*HTZXJ`@|JWMQk!1}nj%B0~XdLm?)bS-XO z$G{9uAghfoV)R^7vmBLWXeya*sG-a2iCj|ZW@J)MDX$dDjb_2jyLMCzZLgdkZ3l*% z&w;9S5B^k794t-b_+Th;X*L^ybN;%0$ex$x{xNM}sb~A&!+tVAaZHoVi`h8hYjKU( zZqReGyA=#F#(D-A`6=ALswP%xm|-;4<%BB3ik=yo2FDY+0_?_lB}SounBB;$3#3p8 z{8_sB3|d`<^mZ9xj@#WYsPOu>-ei3GqDQ^^MTe&U1i9WefBosGF|FbR8skvv3$yeq z!JDntdR{?5ogbN{uXA7I>|M4tH{e3%`oc7ZVQJFO-^}*a=HJ7PjwF_$@~$vb+UlmP z1p3B@G!9LCB|#rzI*s$;HMVu=)h}k~??O*0RsY8i#M`BOZS$}rszj=gqjRdP;JYad z%hLVJ!yqmW=p}k^Y~8Y=J>e{5(-n~x9&}yd1!Qi!cxyy-m<)ol^n3_=2bLPXT~GO> zHM;l|IPDDd?1wY-;P_-XY&sXtLgQXQ(7r@v0`2H@Su`ki=hWWTNV=o5=jt_f-OZ)#C z)DDBLVs1bFQ0X({C4!tparbL)Y*+i2*NKKFq@x$MitE+AZ)S-@y;G`+eZPjF<+;66 z$;!KjChf}Zqc^AV4{IgA-C%J#e*Qjj?s1n{WI1|y8BEY=khcY`)KG;qmeX4a0o^p@ zDuba)K}NS}z4Y+|0Q0sP4u}j9%^Po7^$wM1K@*vy!paC)7hLdMg34GfX6<`vmOyL& zyWmLFg-i2US^u@;d10??+DCcGxgPePwW9XsNUWb9vYA{3luK`&6xG;3|JhjrZM`JR z)pg<0xD)3%cs~Ie*xg>S)8{Zta@;0R`2@NP2k->{L>@BN-8fX_aPAlbDDdE+fCoQD z%$TYZRwI*f2o|;SebK=Gd6V}q;>LcCJtE^Z($lk^w)X4``0H27O*M(SacOU z_pD40Lt0(7hX@e{M2M5rj249DC;^j`%r8Tq-H{)4Qqpu%8>z*wOEV7BFv-*hnwl%) zl9LoF8^`=OU9#6syYVP7Y{NvxuyoV1OhdN(D2g3d1%7uJs7QhZlyDie8h}yT+vGvN zJ9=I5@;^W7H^trU^G{Az8vP!78(69?Z0df-cuda*E_qOmE90YmV+Tfd&n$_@6h-D?V-PP#&B!L1XIK68=q)F#64+%WPS-*p_< ziyd82WXlY}j3k57NDL>5ibPZlFV}i?a7@r--R7+URdK?|)kKWZ0ZjvW6`Ipsq`^|6 z#!eo47!Epg1dyRm#payAWdWFrPRcB8rr1kE-^p0vM{z;$SK-w-yX!%LIuz>NaJASe zU%rOhTX*YWk12MoYnm*g%qgCVK`P6#$uqUY$Z>QTPz`kqVF&7{Pg-v&f;@4cwNm-E zP^D5L=?YXXmq3$o#9GOR8lv=)ShYgH%cHs$JjnoCDN7IkNH;X~yBnU?&eu?{-1lmc zuIZ@DPjFuxJ0MktrU_^kdbh>&9Qy3#Po6dzC`MkkpVzF<*q8CMzz56*LVN&&9TTv? z%kQIMf*DqMe2{M*8Wy5v+m2jgJi0vVq}nICv=?#KyuZEqY68`GOKW}JJP94eszQ=I zzcckHPSXrbh$E=r6nhXV%5>@5Vqj8uTLLpnJta5+Li!F-Dm`7q)--?##^Chvq`&WJ zH1qdWfB#uyDCg4^AsTaAb}d)_$eZTpcDs|jp|0RnjSNI!v=}@U;(T@G5wWsBg<+}3 zGcx(=$~&iiURypIm8>7X>kskvK$9O$zWVFQb5_Wamu#fdmX8n){ZaaFI{k}Wqg_7W z`}#TZpOG(tPC0?w0xcaZJ%qlIZ2 zF4sUpT;l4+=jF?J;W zk2W&M6qUEsi7&}u7%yNI7$s;147k=X&nyEOYXlWN`)k^h^vgXvM*4T@f0xlb(E-1*4Ud&`fTz@giDNL3MH`#29c>JSxBuCu zB}t~MsJt3C8Y3Uqfha4QZUDD&)M|rPTif|vi}iXTDMSymK3*dT?A)9Xb?k{r?-sP^ zO{PWYYWFGa$Bvw@NH)s85m0R$-A9m4&%~@KlZK3b$FRxeA{~s@-o>3UOZytLKSFn^ z?@U@2;!7V03P-t379ZL=$EqG4|NDCaz!~18GuHIL=l%B1`cCg$2fauvpq8pS%U7>^ z;}l40O&fU)J9(?ICAjy3SOfj8z_Lwmy}BJatt8Z(K{XS35gOF_QyN2QwLV6J3HnY~ zmpVzNCI0R_Jz}GcCk`#dhlP<{Zy>1Cwjn`%EWG;7UY!AU;`)Pj?%#T&^*ldrw3rAf zLIj6|s8lK?aO8QT>zWY`FYOvIWeIR{D0Ddo7@=M_6A%?rKoQ2Vy7T$qHtrDJM%u9q zwsoSGPiwS#*Oa+1DelM>D*=ZaSJ&H`8#^rJ!5@%=uuGJ7mPgI5iKcCY*XKC<>~7wN zBie@g%9szs^}oF%x2=BTT#=$mqgYjFrN!a~kJDkk!|onH_Xu@3J_ts~Qa`xoW(Iv0 z5HsSg@5>EmE@8WQrj~GsY0F%LgjUXrUjjcZUz>apn*V>o?qL1p(eO$Fd|u|T;%mAQ zf{oXv!&Zx4l`d}kI%CC2W)#oyxHjsEB0DtuGChwC4)pbVGue&JI;E z&qTcOF9-YO&!s+`?;->jKV19PJvw9Ch32mJ|L|@Bj%~i*^c&A_TaLo6%)&|=cy}+q z9XS+Gg2F0!vRg{*e)k@~J6b)yZd>MliSjJ;xKa(K5&(S0usBp~pLAo;ul2uhY(FT) zilBrBD}rJ{?+Co$x^grWd5$$b--~@;opQM_h$;1=;B69Rgan_uksTQ==Q1Cbcgi$l z=1#qkgijp$rWITh={nG#VO*B1_vVTkSG~VoroA7vwrpvwGR}tAVFF(p<6d02Flf2_ zP5GZsVVg)ALb)B6_U=Rl8m(xn735`tRqMvXiHKRU-^w4F>3d^Fvkj?D|0%#a)G|D5|E- zM4HAjnhyL%I;PC!fQ0dwjuCWoHUo*=lR|DQ!Y*nI{U1*39h;_WFXd0UhUwGYWnHW8 zw~}DyT=H+JqO=`Lxo^k3v-ZaZqa*)9c9|1X4Hi|~kcdPdoC_LN=dPV6lXqS>9ErLS z5VZE+%tMR6dp`(7eBu__teEuwub2AunHJ&$srWky(0JnRi9#<}KHE*9lkxks5Ox&kP!=KXzmf$vwy6fH0*FF*}+)Trn|_85E6gEso-u2HLH z-M6$XbEaizs%luKqEMuuSZ)X`Rpf!+6rGmFI_Kk(X7rH+3lWvKJ;t$$KcVUKXY8(2 zT_4`~eDfP-pZ=kaCZqfv%nAM~WA%rnSsWGPL76_p^^M8#ZT%}U$NRYO7Ypv3yL~F3 zPSJaAoiYm`P^{R_FSW^PdsEgFs7&#VbNf7F(+k{Enk$Rw#$LP|uMby4d~@4dvQEd1 z17VzZK{$B;HM%54P;YAs??}-RoqCP9m`8^ZGway@Pck`{TG1V^4G}lQZ!u`C|bsJ6oKR8@{x4g1yQ&3?*`L7GAM*` zy0-a%5anzh_l;I@Rsyp07S009#v|JS?!g3hl(Z#445>~QU-jJk=l@4*x++VmE{av0 z)h*vf=a?%vMzE*Fnp#8;xm8p!*?YuHr5fKZtrihy(D<~s=!MBxc3hIa2R}a{G}_%p zirWfk7e|lVw^Mjsc?MlwJ7+MoMejU%Uai*Yy5gRbIwZu;aG~6tcH*((&VRM{9Vfc@ z^M#K|e{k`u3o?kYys+|uG^s#lJhA;Q9#gx5kRCt-?ttS%A6)%Y5 z*wOSP>2w>%vUQbsajgL_*+iFY&LJd1S@2z>(rlK3L@H5;^Fqpj_Kss(q2j9~f^L(g zZD5L{9`>DZ8DE)2NpFaUjB;!MOw8S`RUPuHM8ZtcI1GX~O?+QfY(K5*Drp190!gJS zd3y!w#y9mz_L{YIb>*AV+6G<9-Or6VKO;(yd2dWLEEV4RDKMMlBtviX0ScLaq5dwd zr%xsM8LFw@1fI_x9PDlB^Yb|V%~PMdQZ3Sgw1j48*xSrNTt?1RxG&ON=7r+O1LyYnFhMrJ`WQf;>cs~0Mu01?V5aFYeReRX7|ATVlgo5 zU0C{LOWR)8m83!X8(t9o{@eLS`oURe>8`oNiiY0$iO=(PrC1!M_gK1}e#%Y6*82<- z9A{E0WDJ_OL&x`^ey5-kZyY0ppRTgpsMdca)UKMsP(40ija4bg(XXeJF>}JpPDVq1 z_6|BWGAVISP%ME4Zj9M%aTX*>EVxN-Q+6MIRfoLD62~<*`aGU-ccVnf%$RVv0%&v@OmU<*H;FWj3n)tQ zmR5nXEK|U8bcM!UgTs`BbzZh>)@AjG<;FFtyHAqLG+H>7S2RK>E%`(W&Zsx`dJ`@> zyQP7*cVOC)6>(@E*{C8;8(nLqvI|P0aXBCSsods){kRKn#eVEA75}-e6Y_d#gbL+g zE?yLMz|dHl)?Mm+MbzMFQ6?_a-oC`kz-? zzu)H43?wrAwMRCnCc|~fs`HyI>cE>6dN=sf22|051+7%Atf_ksJ#m9Zx1QKoGQz@* zK)@J0PJ1Zgl^7oS{>bMa8DLa<=tzpJ8)2yH0hW639FE}7N?rqzEJ?yEH~9pDS2@)_ zoyq`}vI)Nkyl|ru%U%#fpW|2hTtDn62Lt}Xp6q>eHjwl%5Z{2d*I8lB*CN&A+p|aY z3%jCC5cY%B0p7L=ffvQ|P$i{OG$us_!bXNEYp48;fY#9n{h3xdUy*Cx?X4P>b$-Ve zTXy+(+-Q4((R0=&OU7sI3nel=I^#Pg`;3Y*{IcW3QWiZp@e*QSW$v~|W8?~ik!=hA zKcwqdxi`ZQ?goyDhZK1}tNaU{itqxfYDOt0nYK3j(8P-w+CQ zxVX@8aeNaKof71@KZN;kF%b6BX?W}QO^#*awQaArCWt@ZB?hOk`oBLYt5J`NW9=P@ zc&hFw`NEa0G2jf_A&7v*@i-I5kbU-TS7u#XrN5OO{nTgENu*q)cYb)8(bPu}z*)9)~y=BeD>SJCWwAv(*qP1PCgb;9Vsc3@I=i zJq85_5hAn^A^T&KKU*wA@O*vEAm_~~jzdwTHC03RHI(zt1S!&+GkMq;th_h$&8Q;9f(4`1UWGtk)~6S7=E zDrk%h=;j3m-pyJ~`mR|=dbIm13jvyfbqTa`O{?`in4AUc6;d*pGOUa>@3kPBfho}@ zh{6M|{)#M<&5PhB@Mg4s;AY&4x8r8qT&MosG%Q2X3_T99)PklP7u&H@F~~GkQ*3*_ zA9|Ll$&w^GuK=&N0+I+$a*Qcv1naa0DE5G}b9sPoT#PtmJ#m5wicDQEJ{4T-k1Rna zw0(M4e8J~-`(~mh%ZjWyz>-Z_kovpzbxbNwR2CIAwNm9Un6m=-RJhXXHuXpTe_)JP z__a|dK|sw{&Rd@?0YY=G%y_=NZC7L6nfG6}OW&7K@GNh1jiBLRtr(3*gWUYqOerr( z!b$>}XBbR;zYNLRW;wSUd;GIfyeqpqcQuPftau2cjrkA>o^MlsSY=+O&v}17ltj^r zVqK!uiLn?(=EcJ}tPpRauDwLgIx>Irq>da!14t!HxJR!cs2jh77rLGs)RN_Uq_wW- z<22Sdnc^+e(#0qY14|HeU2&2qtq*-Ib;PEFDYpuLYG@(QRkY<6IMD z%Sg2Y1~UF5#Sw+=q6meGGd}p3ro|ODVjXs1Bi4C>QijV=Bn8i4u=WU=mMN8IS)$7G zoJ5f%h0yB?ZLWqEEF);Tp7diMDv?$~kSn68B3p$jbNlejrBsp1qm9^nVWq@4U!NPD zusd$sKhU9J*W_igD*~=cu{^^xjr-gd47+)UQD?XEL*$UUzqYN_&Nw$2@(*@&oy#k4 zTp3Ho%*PkpF``9vr}V1Gtr==*llgzgw6CdJ+WG(DkQ7Vim%cC~DFRiA>rsP?><)53 zT`l|&=c#=}w3+y1tGkU}7*5E3eKo7sxahK4yxwBe5ZEcs?XDJ!&lfUD-&b%LfoDZr z37T_BQcdTpZU4DI5d1KcNe|bH%4(EeZOe)QtS4fOV_I4~5qARz&`UIv!B!^}SPJ5g zII9WHI)POpCK_oT2nqZ=)t2AL^z{x)%B~EqNz>S=rY91;IKHAO#r^e!8#@m|1E)tI z!;m|9aKfIS=;7a_xFbG(bJ8qf|WJy_7;LWe#Tn^aY~wC(SSX(*~t;uL#w;5%BW z_+PPYs7iiM^mNBpSCmeUp9gtZvlW=X$=yCfw54fsnc(Wbd@LjJa>|m2II|I z%kvz|FhWxH(bv={j7;4Pq5!0&3%SpPQrv|Rp2XA*OzvPO#^h;HkUy)ef@vzOE_}O+ zBqn1T7RV+;TK05QF@ZIxqS~(h*AmO5!edmajG$a*)4Zuh{;!*{wOds6{4{+QssBbC*5Dv1fL7~GOpRkaHC(u5yfR~zggd{Gs#W9M$WJ&5B@Hu#$CQkKSX;F zWH)QummpEB+w}TdWVnKY99Rk8#+w}BSER`lm)aLPm^rA@v^XfT%9>!L`7c3Of_S5p z8%3Ql3tG}K9K9=E)EFZv@edPd5F%itdCr6Gfl(laeL|&qYfx6CrN;GXigN`ov>GYzaDi5gw&>xv-RT5Eh&8BccB zH@N~=R-g4xAKC1WPEm6=J;xK`aJS(%S|bHPOUYu1Z@~K==C?D;G~fCXNz=47Q6rD3 zgW}*V+%!rtrt4nkEtf$w9tY(^jYgiAgKUNX-tC2Y=b6iP)8i+&VlVUfy!Y1r<_H>T z?^0lCv@ls?P){B8P+HewKvGQ&HM!P?AB(Z>iL0B<0gX27S>4P{(XT-ssCd5oeWBLC z`~5M$ei8y?Z&hDwox3+smt#~|AZd<+h-cNEU^u`TQ(FOuMm z0B3HjA+C`l||9k&ktJ~Ln1X#tmIHm;YnX$6y5a_ zBNEI2?O$-=&x>puEq1tO?6@*X!vq05s%lPWQB8s8bCVqX(a|xHSCrzPRq9Gv{uMB1 zx3JC+Y7*$J#Xgdct>*sN^3%^i?_*$*DcJC>X5Fx}3^gZ^?Je)+HX1Tx8b(y_9Ac0r zU!l$;(O1VjElU|L$|T*kK_14~ApmK`kwAbvT(}ExOESsuQnf0&5-0mXyO^e+X}Q9j zg=(C+fReJVvE-PN;ilT_^wV*$r=#pjK`B?lFdg4t^c}`|H!_ z!qE6AjxlwE+#Y;xb)V2Cp_w!)h8JaKUND#vi1DEnCK#?FI)Ni_g9fOIxfvb2bmfsl z2EE82Q=HimB&q+QsSrc_GzkQI^FkllZ;3h-$PI z5p&Kzn;Y{Q^w%feM+(_3?_{x-22)?BN}?#jN*r@hYAE5%A+)*AplkLF5u>&eV}#l^ zV_G{#SOsx(f}vUXj`~~0dz}lZxg$f>G;`2q#GxS$6*|GB zNK+8E2bnT8Re9V#u<6D>x?AN z{wM)AkK@q@Ux%3X({++>0I~!go@HoZas6Ja9B=9jP3k_zVx>Z{ zf?xHo3y5LMAn}KgvYTju(tH;8l`0 z5}ZU;Ypmu8EdQTfIdny>HY-jlJ`O4PHy-Rr zrutj`Dp2uca!(|C2I4b;xN||^ZqF_dpT`q4`Q&ts261cLzt+;LGnY^fnBa8#wq@2u zeB~#iPw3PgSCC$#ex~WR>xWhA_d2L$j@M|gjn=IxAUHJ2SmJb_CVk?o(KhQ{n2hpP zy4Eli5PeZ=3sztdvvOmi8kjt`VVO@k-dZ0c=BirQhF9WwK@^qAM>Q=;L@CqpBqko; zj3mrNVGspDHE-)mGV9nW69njy!dPb=a9-lFcj(8$$Bef#mcBe#2qKa=mEWP;(sE?* zirzYBUsiM=t$^@ZJf&BZ8u0QBmqRlAE2dS};fC@J{8%AD>KGM7D5HQT3MhPV?USPG zQk7+Sj+bOrQ3i%omn*1>u0p}mm4a&94;E-c&uyT__6;+iQOk{2amnpYQ|{}%-*tjz z;n)gYtFHF**S%>d`EsdPxgVMKuY4gKFM?hMmY3HwG_Bs2@B5xhKod<3d|NmZC#6|d z>E7+MWn|trhT$LEptp6yh@;RCe8<8z;^=zdVh-l5tD<>CT@v{a>h{D<5k;?V>mhRU5b`aTHY(M;lCCGG^zc0bFJv zDr&TuepFhr5>_v{JyW)QP%z9B^d+0cmYM{AmGzfN!tk>`IK2y^OpnZlUQA&F8tBO? z1&``oux>%zG~tImm*cIkgU=jqr11FpG=_fyI_Sd&bkHZ0xRdV$)+){ZU+g#AEbB&X z1t}|vZd@C)w(T4`)Cjzf9K?-|T~L|=c;1<;gS9ocGvh{laO{Zb#FJvVQoiO7EHM7n zp3zJDlBW391I~-*9CX!nV_%*8tdy0kkH8jyn|^?^Xl+(_n5c9Hp~3R4G&Csb%1LLu zvZv~(+$H9Is)65%cbdC0U8}wn%gT^>4eV=(OpAITCI1S;jkH-aTBJoIr`|2A2_zEVWy?93@xe>M^$m2 z7X^VrDlmd^qU1VYz{DQdFiqjZ(Z-ZnIzhpCRz@SFR5$Lz@;}GR71s@=lKjppXQp=l zq=i?@FJ~)XZ`tgrEc<*Zzan4qr>&I(uq?5M-Z18c&xmv19hxhfTg9dYA;uK7Plc2b z=($^bbq+~nXQXrn3(D2`#uNYec1N@I!ELRp`vm05?}fR^`gEn=>lQf*V(RjGC-|Z; zOviQ`Iv`scHvHJKGXE+x{oS=O$U3pueC;?BVk8Dy+0RvSdqn|b19y|y0vAFkL*PE! z*PAv~jwFhj6f=?vJU0+a!8m7aw-ifK<9i$RVGv4$*r5b@5>tw8&P8gqhvO6Rf_9fM zbyeU*-OChAC+QoaVw;4a>H!$(892a=>_F`lrD3UL8>rhyoB8l^EUuCzCIDT0?PK%^ z`>|*4Yb@8|LMh9xVH650WsEeQK#Mm$mVS-V7Dz1lJucp6ABvTswGkXh6u}(0#x8q- ziwk(>>z3)8p;!V*C4jwwyBgYA96E84;q+64;uAnjwCSO z+mmAGMv<#8WpL(KC!WwQOiJXZIFX1=qNFHEcp;iusLIN1xw0$%Sa8bFJBpg?>-QH6 z`4FG|7P-yyUXYaFt&mDx!d@q@-)WVkL6#v9dweAM`_$%HG}P#^tZZ4)Q64;pQ_%>r z9TI#hwWkR+@I?usR=e$ zSaD4`BrD#%uwY3@C{e=^Dm}sDIKJ#(ZeSbJN*R62AC%nLNyft(dH(TOMEhFi! z<~Rsk_=%vYa~BeeB0fU{E!xcXpquN<)FSwz7)%jhf|gL-NwK(=SoJy8>h^9o8qL#W zJyIm+bQ8}FdBqY_sEzlH*8}5X;FL<|H5rkYVjpBlv!P6kjKQ45UNmd^#YXV`BZMqM zm5Y=4bkbrYe;PCJMWC-R^|`dFtAeeFZYeZlI21{7s;()TVY@bm6R@OdO1+lOfP$DL zQ_qLmrnGpRy3mvCVTNO?bv3l1C}B4=u1~W*?#3N>7w*RGKCLdt&NenJic8wWuuuu( zg0nEsh+-@n&sd(*HPz12O)1n|juI7OG$Tw}$qsHGiAL42CSA%0L`cjbN~qL)@Ls9J zwdm?8g%m7Lp(p_qySioBz0c6-8x5AU2g_8UEo~ZJW0T-RJV}7f`WvG?&tF2cz&`^LqQka zxmHXMSai^bhF+vG7Qd4~TzaSYB8x`U*ehM1xTHS43^_KYefIOr0`IA841-=AZ`2nBP@W58(QJ)+)+SR_!vev0x%H=p&Vgq^r;fB;`w?~VL3~NNTIU=K%B9fJ&{}b|T2hy2;QzV9B49AiL zNilR4ul_i{glC`T@z4ii^Uqzbk zOCW^dd64737~~uJi6RX-ejF>vdZRFzj!h|cXO%`HQZ#$1{-JVNd=C9uKz?_UHX7qT z2-7T0qPSMC%7<5m$UrxX9tdak2PSYXDCX1lQe-&ZI?1`V9wW^r$p+?Vm`cbX>E5^Q za9T9u9TJg6_k9oF1p@{=7{vUMI7nS1MJ&tbaGK(O3W5MhL=T4;G=V1moM7@cF@R@|HvPQ%bAh)--3$R26AV@e1CVi9JtO=Z?TIUiQ|9mFe^CkNAht-p*n~ucw z1dO1?)pBvkW3>+YJWiK>?x|*D=rVQkr1EHHD_T6kiliVz1~n&;PaL2#d%OLgc^f9o zabN6FMhWWf@8&Qb{NT_N=-(g8%%t1=4ShOTZa6t@`ts4W%a^xhpvJ+JTAEEU&@C-<2U}7f?tWnpgKHbV^b`0>KPU$D zrbRS$c_T;RjaW5b=+PHv^fbIAj|)PRMpJRCKZ8n0futKdUx zh-lIkGth%j)N|W`nevE@4L@zluzO9+zt1N=b-zvXujw=CSIvXdoCxEcm(vcX;ph7k z0S1PrwvyH+%(&Kj3=R$n-op3)@Y7FUgYz=>n^qk@A%!|x>=L_MSO!Z54Bka zjT_><1;v;8W}?2KV%CIGC%*x)YVnDY5}^_@m8koi8=)tqMTo*;PGq$R>%E#0F}1+m zR=+`0IEIh4^Y#eWr|cxMk{BNR(~rm0C)0)K%h=Cm74#t48oq0~JS6Ev=kwS*Qf|BF zM4Z&?LpFcU*!YdzF}bx%Yg<+^3OpryWxS2z4-R}JVZ)J#O&YG_=#og1l$c|eh+Gi5 zK(WFs1U<7}5Sjm9lMA(?p&Rxwd!YF&IC`DXSB8m2V{C|$vNGc-1|(Wk$oXAje+gb0 z3=PUrU$*9vsn$eE(j7NV6E_EOet|~RfWdV zkrg7e$}l2^LWm9qDJ7IJIAfGhfYoD>P$(F3|8NxKezj|@=AS+in3B78dPO)w=W>}% z(Rv>7Gwk5`5>dL*uL0*Pi%ds-V{tf@k?S=Y!z9r0_mo?qMx%mYd)RTE8hAs^F)6OS zS_C$R$&lqZ2{(_~X3SWQL4jQTR5Fq+ zIBE`wsb0dFabvqXQMoPj zrsXuowT<9olnDsDvj&LE;&Z8qb28y7XuO08;mz_ItV`00=>aHnIRL>j&l`cD`xTRf zxB{=iL)e2|t6nT+Na7elvlUh0;5=6*WQwKm3dB%wxgr>v%EK#om1J020cPVoO<`fK z<)kZ>fT_Q{FcZ(RGIjR4QlW6fA);}zE3229hipx7Uc%=fJkyz^e*cF;2*vrH$rUdA z=Z%AvQ-eIa+>C0SQ0*PNKMzC2{27NYGK%~NWF$q|Al|Pb`l+&76(Vipoy`XID6g1d zpe$QRB&KN8F~J*0dBck|mXYTZ{dd#Qv&^f*P%`wM>;|8v18P{E@EZ-`YEPmkgUFJd zMNcbE3lU6aF?SkcVZML9(;=YhjzO(d*eI?sQ$Ugw$!8Q_QXuf248-}iG1SWr`ph!$ zSd?|cen{&#v#z&SBGmJlvfZmjd-rNsu;)d8b(9c@$20_ivuqRYu-M)uZnA)vaGq0u8faarmJ*!m`;n}veB?0{S98_ z5w)gOE@Cc)%Czog%QRW)4--QN&W|c6pRoxl`=uv zn?Dy>X%nq)$~QId`N8!@L>%jy?_8<=V(UkSyazmfx+RBds^B@Vwfwh?uJWY$XYgD~ zKsVh}W<9SN4#C6`8x>}`+qRZ1@IxRASpeX`K?DbGu~<)20&~JFreTd?;Pc;r+wg{Z z1yFN;0y5U&PiDr?bUHzPA%m2yYh=4sn-5TGgUToVZ{2vrugcC&Et2MN(C}p%~pfUI3 z1(rnTJ`=y(4V?V>t;DdGLyV0mHh~up^5yeGb9_QK+UH9S+`$W!=^#cd%>c8oWICWg zIs><@Llx(tgYKt*e%=u1tUBJ}XZ>mhDi-FT*0dDUe(usD#?Mp1-~Ypy=sxE{qx)9^ zB7lR(eC3y7_dEYD(-454?nzI~>VKMM{ITLAsW;HDnNFGoO#ZWM(bC6`EWU9Eu`e-D zTR*eA@rqul&)yYhyN>J`b?u06P3%9*1?M$_HC?U+Zxx-65Oz5v8`Qil*0JY&4I5C~ z*x}CA@AfP{-@cj~P}+!DTi=Wg+*SFB(fX0>to*3`$c?8bU;F$}DPJh7e8Qj-qd%R= z)8Dz*%aDvny~b$K(>bfJ+mB55xUEGO4Bn^fbV*)0hRE%=Y1+%tRB(7s@Z2sKwVY3c zITjS`zJ?L1cRk@pJGJtzacjOm<1b^AkB!GunvkGYg-1op(!_h{()x^1pg*m@kZPNF zG>W?Vbafa4n=Gi=c7upsNkF^r4{FyL938~Q5>lS3>)X>mQ_U3p{4{o29XgGj;#B=i ztAbF*>y8-d1Mm_+?%QoaDbpz1jVnEbtufVt$_&(la-W1SOxAAgeKDrDaTm0=x_}9 zFONGdw@*(jhZGs1C}HH38d?g~s-#t&WNxW9kaG=;qM=c(*gs8q{nDIL3#+7S)hHF( z#LKF7?ebIyt-^GwR2^Ns8m3!c<>+D5S-ooY-u7+fPyI+&Fo1J)HJBbllxAue?dI%A zZI&6uxGlyAjbhw7u6>}qDCk%U}E%4TNCAYy)Ortm-QE& zY`_jG#3E7zjKoBHFsICzC`WjZ_S2VKiKVKRm!cYxo-)&F->289FIWVnpeUqBiG$?$ zOP0*6m{~~~wt=?}6Wk6scGx-=in3K^_3b{0vELGdwI?F)!4#3Fkg15N?-7NM;4Q35LP2l&Ew ziCo}q$)b=YgDkNnSvnEhGRkq5|6SA8<`)3eWM7pS<(ey#h3!;rYv%|RN+3v+5&V3f z-=C{o&e=aUaUQm?SOPBAA)A>13Bzm2uKdzvF!j-QHCp` z_R6#=s#H}{)M?7p`TMC#^)-4@^s_up>9$!4P-)e%(7P+4y<+J-*Uw3$Y^7r^EUCl# z?M4nu2np<%Xag1kN)Xu)$xZv!b`T|&;9vEMkpz}NTS1g$ngt)V*V)bOzNAxJ2B%Vu zp&1W~KNm_@jE`eHjxUoKg#w=M_nOjszs}Wv?%KEUjMDmdkR|}B_@M+Y1G40@<-639 z(lvo=t-CfAz@T8m6xmCZzA@6KYSZd^%mQ#}fPy3g8W4j_IFKfid7$<~#W1&XaL^Bn zB1s9QQTR{u{q;ESv#Ll{+-PKt!rC*QRkN*4p zkZvFFxi->Sf!6v^?k|7{r1rVWxjoj8=a-taM6bekdhQPlkU4 zqQ_AJb)poCP#R@`k#@u2GL!@w#tw%dDt@|3me)Rm9rOo(@ov3*<@Fb@ z1;qZ}x0ZAOKs&$y!N33@5GcQ%-@3jD7Q72%zlO1!>UYjTofk1N^6ZZx``6w(3trzN zJP3jh@3rjjgV}$UuJcg&FUi){ECckLq$A@R`^!we?rYk;t*h5H1>#i(-d7!|wzl2Z zfZ-~c_y000-|_p~X|MBh`)8%{$S!YbeUl}ZEbElLTH7YS|NG}Y0)Cs^TRyu0vkou{ zZ!t|xsl$M0sb27^(SLyp7khT%X1*_D`uJ&Htnlr@PoTWS{teIab<2e-xP^1qeEEgb zLNDAELRiy^@oD*YU4OE#bM5n+oAHQzzfGS5A|Q@x9{=$iV|(n#{3Vs+zux%CjPoEn z6sI!5+k6vF=PXaN{c$GKoH#{}vpLD+5H}4z#k*u*n~F&5#JNmzauri~Io>9ca6TGt z!aOY4ar-#+3zINDe)` zQao(N9iPZ4)?o)ZVTWf*fW;`vQ+cjwP=YhQ9g2%=U|_U4O9d>)OHcY79q=9QaEu|$ z9!&TWBn&=`4222%3|Cey_eR!8`1NtEs6)PL>l=m5JvDZ(>foUC;2H+KPWNc36GnXgcwHXqC-`2OAET z3XH_y>pC3Q(_@$eu*>E@F!W2EH2e5?m)_0deZJq{?{4HRxD8Pc!yrwWfDDfRp_#yl z9_{)x>AH+%WF*H-y&~T^pUnB$@q6MKbov6wz)j?YbiaLCkDUW@OWwM%%K{{_E>@rb zRC}oywoUoGrlbl>(ss{M^;=w)PoF4GKf~@t@g`8sR$rg#0Q&W)2LgaHygmaqqX7a4 z(0~YFITXNd2zfWOulKls+b=J4dIXTalzz>62mpqXSCv3(x7&$&$DH$-=0hRGZ1FWAwOegCm@bs zv>TtDUomg)8WF`XTsF3RIo+~npdwLEP>=F{5`i?Z2h7jFdN?Xuz|aiG=or}^3`dn) zPmH!cN{pLmz>LETF(VAm5R+@qV#M#}np!+;HDOoN`sUAjzeQhw&$j>{uiU>W_w(jY z%TKcmKKid|@6uba6W@qv0=EN0M#LOat zHy^(I`0FD;qK6)-@YoYi{qLEPMj364H0d&A`cI8j)@-rvv<*Z3bjvT#)nWk~IJkKD zoC$0tBd4IGqNZ_`I}c`_EUau^cMEu#Slh7Tv|>{lfXk;Jo8J(@b6zf)M(sbVw9pL%dj#gwzT5 zsx0JUMO6_>(OOXj=A=PYb!f!piZ*mk#;W=-h|+@bJAr<>VIMM{)iqmLFcGv)msOMS zwN=7&j&twHN`LDG@@*N{cc`_@LRN){U-rta(7F*9xAKJLhNQLvvRXgj*Pz%#pPIJ9BS#X9pi#y`Kwscil&CRCTC5V)cR?Ue zOq+xjN@`+Kd2ytAhrP+$@9+Q6?Y+u6|MC;+a{exFGln{pzQ{V$J6EIZ62yZvMGB&P zCrWtCRJ4@IQ3w+i&@fLCTCsYEF?pLPhfkui?n17BgBt1gQX~m6nhcoB$Gi>%q9lwF zE?n`~mw~YotD;Yl3-IwyUIj7TVQ)m%vS?2L97l;cRz=EkM=**}HffEa=}*O%#rudy zWYM57MnA^+T)V%~(Rx6w^K`z!_-fn(H*O-rk;V8tdi4_Mk@YsojNT|JckFSeIq8`~0j* zE+mU0P*uF4s4m=8K%@%fjH9fc*5K>yZcO%xm>TG}4G)d_IoqXsdtzQlU3b#6 zC9-{w6TWS|PPZ+&?e!M>UQS-kDPdXY>XUi%_p$;hjRN9L<^^Xnvf!>FrAMjih{+p8Zb zihe05buL{|*~T?w%l3_!wk3JsQsw~WK-YzH5~q4I%iQ2^T3VvbfBfo`Hqo(4m>1ip zAbm}r*h!y$x{b+C8wKo`oE!OB6^rI3cWv=}n7CyA%{+M5?v$=={T~YF?a16RB72M1 zrJ)17<`*Ok&DhL~u+{7Gu$j{iLl1xHxwNQq;nE40&J>(tk8~-@4H%d@J0Phj@$#ab zDZC_Hyx?YKI$)CR*=S6jdj4+rTG3MRhWYqsCz8HuRdxE>3%qUj?0_m3PsUve=se%^?pq%2cd^5TO= z-LN?euSAEt%~)fOif0d>#m$_zvLbfo^v&VPMfCos&Gh)R)SUc{BNz$v@Z9*qdE9(R zyJq~>Gfr!UA9Z6%(zB))t?*7M*fBKnqG+kpnXEFWHG>6n(w0w5SQ(K~3Vor#eTIHw zjf`Jy%HEcjd5t%jH_>om>e!r&tr;2ToTob%xn7%|1H0Fqyst34Ms`@TaZ>YQ-SG$g z!q=WC{32Q|J2d1%!MOQHrQ2Ovj;FRrw}&6ipR)dvY`B2E!oe8XnViVw3qT-ltLR`cw9vi`<8J@~DCE?R2( z`4bu}>1utbcts~)PWX2w@88iA5{y;BT@vZH3;*#(W{ii`zohgX&Kjb;vP*d>i!Wny zm7I(=0k8z$nNEF~c796y2fLn|qo0x$gT|r>a}r+9lsSK&oSlH)>SIe{CZmykW_-#` z`zKBRGEndVD4 zhE}RY^tn+rB>GR%))t~+q?H<{%SqZU+Q2v~o2T}@9fqQGc{+;AM;~=>@T4|#DprirL;>muqi+KBp+KB8i^ z!SMJ@%uQ?+Ti9WT9d_7Z$JNoz&an#c!;#}~xOrqc>|_zft)+MeNO!t3L|j!EA}I_h z17JwWg(2l%7*a+b48dDde;kG|*%__5Rc6Ji#&D;+t-x?Mqi4&khRs-4SDCS{&`PWd zwU?36&4kOwfGc%v14yu;+hLOjFu(&t){9a3c&v%Az~T5hhfCC9I9!-Fy!?yHSRu&R zD3CY{Vn&xHfgunV!=d;p5a9DGO9Tt*zCwnfMx#2K!(uq?>WzX}P%jWg)XRmjqUwt{ zFFaUdc)ePT0L8*_`3wDp{z8ADS(q-vmiB>d?MtI1NO4BFA~^*V$^pf4U_pjOb9iXv zXK^O40dK&Q`4s*=Z%=lMCNF6$Tjs!%QEG%5?0<-rWM)@5%U%#!s)Y zNxP7Ct^qq41pgbNaxebzg=sPFSQm^J;$dZDoi%LTt+2@$4CsI%5B(8rX)SDP9gLOr z2F%Z)@b9^AphFwrzg6WPvXKW1td|1VC}+W@o`!)QhM`_5MhUh`7Pd>yi`Bs2Rn>_i zTtJ~5P%H-)WLPwZhem!B&w(3YvKuj}*{L%rC;4{ppX^*H7M_yvV#7GfTHSuz{L5r> zES87EvN#~d8rFW(BqaabEWv`|xG^I?1_Y(I%*wxV&G)WX@YjBv9eh4~?eT-D@Z@0u z8bH<6?!51v8mEPds(7$vMTrD$?y0(~Yw6<;Ze?lhi_E@B6Gpb4;q)#wyODrKjSwP) z2q6Lxg0N@0chqNog637bRYn5UD$u7TeT8Ms67#fu6Lp!1il{9@cDw8Wa+;D%%aS!i zE470^-e22PaPxkCY>H+_cC{8c(}fUnrVAlLh!8@~wh?`Nsng_2HJLMI&X?tIQpzps zWON=`oPvN+H-Ieei>M>izEK!0QSHjcWg}>xLu$Y3H#N?r7gce9Ww~iKJLr>bYeazE zc2dv9T2W=5Pv$Uk4N%3IQnbf*ebFF96UZLv^t^>QeEcZm8U``|+6@|^g_IfOZ$lA= z#6vABMoT8Fz0qF9iM9b8orz!+f*=TjAP8aZC5AAtmkTjw{HSpa%eT`9+fC@qbej#s zg<+7SKF1WwlFJ^mEwr6)9YG;bFtw1uLZPz+nQ-^0k|}5R!6P|f>4FfwcWJuoq)G;( z5Cmal$!#i5);1_Vn>sqv3?bY^gxDtB#6B?~{%FN_y$9O+;AD0ziyKY2Bx{H2^PvxF z9<4+FHS%(8O!M{Sw5oj!OwP3YF=hgP2#aa|{I^=Cg_vQ)gP3(&~ft;bIr=MOQW)GWQez=0=Z43X`+1=s8 zEB9B$^25%JJGUXCYt`oJpp2LE(DREUU6Gq>Vgw-<#$H$$Est)GUR?WTok-*mB~$s- zvY6(W(RF+4Lkgba#G!(rRk2o;;{U}B5{|?yNsx?_ER$ZAzL9pygffRLS(YzbCO65W zpMAb^waaD!t zH%7-&uyAZNHXGZ9UB^CP-5ou5yxQ@6Cr@M1#E<2UExOon(X(@P7d~CB4bl!DpM6Ps z$$fck4>?n-4`WBO#YxJfu04F z!?qzk$vy-S48Zk2EUU5TVs?K4L%jsTmc$YUNcJCvNc!7Y5p~D3U~Na_@=5SF4$4Xp z#F|1zsK1j1cs|vYAl9Vff-|#Z1(upcQSkr9_}la=FKjFUM=X?wbJ4G#2t%OAzLiL< zto)*3e|~&ZDEu+1zLy>lC4ehCGWrDLL~D}>a-#rP_$*)#rRlJ#%BLFsW;TY>*R0$Y z#n_DBZV|_BIxt*Gzo_qy!T0axQlM@@Q1hF~5x(O0F}w+mZNzbJo0M#rfX2M#;NZ_J z4^U?r!*TM&*aSguF~lzD_Tu} z;DHV8PpKFw{u>Kj)Prrr!RKKbaG$pw#? z1WQsN?m|V|RJVY#ifOJ4Uo@QA4Cu=A*c13(pP`)2Z1{t?J zx`~9B>C|93{i_C|KDO%_T*p06LgROhMQJ?B$RrPl7U6_ZMw$s64~;P@I3%bp-cccp z{hWGUU@sR?zX+qiMCEsYL24%PD6XY?aOo3lOo@Q&vfhV2 zrc!mGRf0!!GmzCnW!7u(WFyuI>{B-a~UiIMW%!VtQGA5qbUo0szJyE*1B?T zxHkEJVm3>}j7=(uzv0^|Xzm)BF(+Wcf)h-e{<=16fozf$63`f;V>bcWWcMBdvPnLV zfYhQ81knN4J$i>=F`>61NPylZq(!D?R5lPeaN&XjLAJyb*Fc0Fk46K{0DqsLCW07< zu;T_bkWFGLa$ZYGFb?-|{)|Vafe1U!to><;-q09G)#>8u)b^e0IWlZK-?i(>A&y^Yb}RZD$s60h6_ru_Dm^x>zmf^Qqw%b>GO#>8uWc8iv$@Ft_J(+6h>|VOW-SA8s6je!$xgue2WYUVZk=h_q zw2dSYiqQj5Id*GyfIYC&uQyo?d4$(9mAUcgY$xLi$3w*Wc7507_ti~_AH@yv@WedY z{zKVz4<80Q9OdjQQTvpsqHP@B9nYXCQ$Dn1WX#VIkVkai*guP)I8y^B6G+?02wX9b zon(?zv9a&%Y~K0x^S(;m~&ySfy2=#Fulouxp`S2ShxT2 z(PZ*U-f^LHq4X%IiRA8CC|P!g5O-r?_aq|fArx|7SrdpqAZ8tmA4;B?2W$FXIRhKJ z41eOz?JKDV;(g<&A+hkh?Ht=>>oe4Xb7K=+R-{&>)d$+oL|LBXRB4;AZe(Z2{?NDB*>)@QdymD@GREs;8mZyX2(is%yIQaIGi1Jup$QLmeUN@Fl zXvUz6e5c)S1Ve#*Us^2NftQv)KmIGV7nnYey@le@tW=L{n)88d+J|;`Hu|z$VD|3V z3O-diBq(AUB-O=G%8(?-k>!@GO5g(1Vm-OV$c)?EC*d6Pq3uh{Uuog+kd^l&0|H91 zN5|Okl#DhO{^-P)oZRNG@H&JnvG{oFglP_0o+rv%o$G;ng%OGMH_o6o4aSyajR@Gz zWDvtp&DX=1q77B}0COT$Q+Td$VBv~8QY|O|%!%AK^eBi(t}6UIESHKhad&5ki0Gs9U_X-h9HvT!Em*29UEa@d zVIl+>PJ((qIGki~Hk@YMyehaS)y^*`=lYBKK8}4L+p? zc#synzl24?jdE1eUILev>vs{fIZz|d92O36gMcPU6zC{B(0UyF0azGHHCqC zx=mWIiGq@Rdf)cUXaUBkYC7eg_$0a7t^X}6p1imdmW(J!!iTu)Q}LDTESC;ja@#L6 z-Zb#WbsZ*xmpp!);YY6dF0b|;iHf3ZpRgovcCc%Wx{S`MQo+?bCs{SoXw`$)`9Ts& zS(7PbX9&a^QSg;qnS|+63GryyP2gbCL^Ul-+dlkG)VPw)g{k#R^q>&rF`bj9_^M2j z!wWcy3>TmzOOkoy?_}>NUgl(@lgxnab%~@sZY+kRw_M|~ENM`!En7+?)E8>@{^2cuCuc&vGTH2DMHt%x-B6D@K%dZnTT@*uXSf8yMX6*cK;==6Vfv z0Bo`4mRu~CtUI$()ww2X@@0reK5Mn=sq9u&%1Ym4OP8CHEPL5Qok4PdB^NNkjYw`HA#HI zIj?_3o$#(;RDjyFq?^>HB`J2_-WCFUVf6aX7^!WzR++JC{#XJJ%nuJtp+>=6#h8$B z1rjc`U@Y#gqxK)E{6nY*UcYyLZ)K**Y?mPFWev2SdQ|Wvohc{@`I2xJ=!0|DCjT(> zi0)QeaMkh$_wTQV2O> z&fCCYnUg$SGzQS=QExh_X*@%w5;cV1sCE-8TM<9->^xW*Vsa-_;)tYlB8!+RA)2e| zb&f7mz0SN6?;Fb$WKnY+)iE4V62V#9X)z67Sy44Mn`xGpm$GsW$Cqux&v>|f-h0O^`Pi=BR@C+*^7NCl^Ybb8T~;{vtX$HT)< zuYS45ef(GaY+N02cpy~T#9U5ZsxtvQzA_xC)kSsuMmY*CVTMGV&)dX|v+Ed9z^Q0f z8sVr+CQTUHdD2!#>ddEOpKRS)d|a9@R!*^=Fbd(jv0d5kIzB$D#kTT0dPq5&yOWg5}Svd1pQmYj*SO zjK}lm;j7uh?>>QdZ<;F&mLtVpV zmgg=lgLQ?@pSGDJkp*=k1ugEun;F^Znk7?eE1JG*q?OBSsZ-RVQX!@FcH-Y;-;5S4 z_6Se%#Gd;9enqzv@Y3i!Nk;*5jq!k1S{8@fAC$cZ^W27Z)i!UY@w-L*sASsqc_n2J z@OF!jUMB3?va!ApadML;8m*b2xn@Zab0$;Zbx1djM5QN`@aaDFk7RLcxMCkD(Pj9f zbPHvhij!{AX;h+FqIw6TT827$L9eq*ZX1u`6(C>uX@0r@{|j0(Sore)%r=Omp_! zf{qMkEUrXOeI|yVl(izL8H9NL=SC|eMd#UljJ+JQ(+uQ3&ktug!7 zTT>$pu8%jyiY90_sY2NO>OjEl?rX(^b(0@;fOxz)O)8=EQP!34+}miGI5bUWrOx-L zLiueBY^;hi75-|HVq}e`V(gzR3Dp|%tG_z3{wXF*dS^-{X3vDG4!zL#!>HC2iU&&B z!GaNvujCa6@aaql!DPA^<59Q91W{(Y?7T?8lBO*XA*N+!gdjKBZna-g4j{%hg#6^D zOpsz@V|3?U^;EsVMOHm=yR#13_i=`V-^bp*t{PU(P_3DW4B(#*2XnlKzsW?!koSw% z8Kp9rlut?cYcik5UP`iAxxLYq@gV%vac;j>fd6s}tIBoW1@P5e`m$p0qT42DSmw}i zsz~P(Gcj&NAxC@mXGxQ41$qwG;vJnwYCr^wn2)K0W(@4@2SpV&)Z@p8ou@R?t z^Q%v#6p|k+l?%ri6%N=gG10w{!-x*k-I6Bw(LDE2(KYCUa;=h64W(zgZR^S)!WC>% zrs63VggJ2z(VG&@u444|QtvyAU^s`gj|5n;_nmp8A3;o0q-5wZP(vAI2(YZia&wc*`1esv5sPI!l=>8sm6D0Yr4h0s&yia)JCn_dh*lf+YT2Q&$@Q_Q z4OQN7Ubtk64o_k+HyKZgm-+IPV`5~6Xjc7*j~+a5GBxA-?2@B#V=LxyLl2Vo$~6~( zborA}jLH~nA~VLKza>cUOVW>j0qnBk&aE7y&T5PsRVW@Se#Fg~-+YIP;4!k~7= zXqN`rYxU8%`p<`S@LZ0Ig|--sw!(}CM~tL%G5F@O@;pbSb9o~emQeW7?3z@j>ZV@{ zP%b9fx1q6-pr$rYX1A50x;JZ_cidGno$e~0i;XNYS8~dcUQaro-P1*mIpbSqI87Qq zoH?~DM}t?d`!f}*8LxH;E%k9HAg&4|R~jnWaH88e0cl9?&2P-~D+xeVpBv-W6mKYl zXldGah?C^6iwZ4AL1}QmnmP;BvN1lb#XE?(L9|r9ZzDSxv5p^Hj)KJwt(J}PYl=6N zY+71F-%2)+QKhb9(6Wvdo>9g!UzDjEYTG8;h{5iR(OGsxI+xv> zH9PMGnaYC0jG6UqBn9TeSd{OA9`6L({B!X3RCsgYAHX$TFVO2XM=$yg7k^`D8k9MT zx?QOmT3|(#!bY%;`fuq-FSiF=K1@6gaVqz6&o$_<}!4XvFJ+}cfimXF8F%@--97n#reRkhvL{yqnv-Iaq#?eD`Tr+Cu5>YhgnO90%~o1wtpfja*K9L?GD2rd?SL#WV5 zp_hFjBixyO61gM!szABIFOuXI3GA2f>Hy{Wp0dvy{DnjO;2TMOs0#O(Ycg| zn4vTkDwGz9t*vA5!R-EqU^YB*!_FH}aKlFrsLO}^0LKM`i2Y$)yJe?gR9j;yc52!% zlC8CYwr-ZbbLH+*cuyd56#*d3j1KVwOMzV-Tp9&o!EP%O?o2t zk@9k}>tiZ%;?k-19JzoWCa#7yGji0&#{IQdr6q>*bP&u=KDHDR2xcw8q=vQB>i}I4 z@uDN>x1kX&!(J8r)x9t5O$1{)}ju5yb=wYSeBLLgVKl%)?zU?%2Qc2%nzo z>wOyT8aR$%ew+0gdl2a}UBGPonz{ezJ;aqqzd@3Gn~;LMyX~3D5Y;@AkXK!Kbn+IU z)<~wNl(Z7u_>_KFMBetqFPkBZN+uOWoo`P(=-eV{Y3Q8KdA04z)G|z~;Jkd%GW=MQ zgDK=pF?lHEe7x(uZOahoyRVhG?90K`7Ol+zjS03nz53 z1=+23S?@9nPBOX>Sda*~iFDm2M6TInac9xYi2#r5`J&wNLx^13ZjbUC`)SJs<58-A z3dO!1db|nZd@YbY0ZwYpo)dK9jxIz^E&lxBQHYW{{^1LiAxvs8@rT+FCACEGhN=() z?@8x0hFGWGx?B%ehc2J4;+vu=(#&AHtF_hQ=5%NoMNg^ta`0v z-4EEvY2)7D$5ay163LcBL_w>Wk#X|OGq@FTJC~rg!`}@L8qp+P+86PrX=X8YrRaWQ zG=2N%&v9EGgtj#`0K5nqhsasv_^xe(w}zLE-XtOglIUmDHr8A-1n0Vl7IQeRDl}{I z@d?p5DHCHfXo${&OmcX%_O-MqNtDc}xRoz^^!?j^fxVsuP45mna(g(K z;e?>{l1w+}L+IcPpoUu^owO55HrTA9NyROz-ru^ci%$H!N#wRA zA8ejyh|71|YCl`)EoYmIxyvpU=jf4XNlzNWoKSw|-g)Il`%8HuoWQ%$zzkQ4**0E##_3@_p7{+_1hRmR40Uu4Ow#Sn(_%#|jEfvvU zu2QO_)|;>eDd}jO4nACY?fN#K-|ZaI<8#tusKzsBdWOHhpAHqj52=m4-tstur`bbE zA6n&|p>;6M=mMR_B-UooB&=vZ%gVGsuca7;&L8@2!b&!5bR~(&NaarQEh4rIyUCl z{eW%J+g<`;z80ju6+Y6OJ@+6ZLl?sLzhR%}L$mjTN&X4E8TeO_^AG`jpoWm3k_w&U zAqX^v(8Q&XMsWH<=Sc_xmC^j>`) z%Ib~*3W44sbG0bJVj79&WE7+CW>Fy% z#pK`1?J*tmUH?@Et-}IUs$!KxyMVrEypTk0Rs1@~pR_#jbdi=(SLKb+}&U7*P zb+KXX6N-Z5sqqh?j1e}xFv(FctNoQdKtbxeGil6+FC7e@yyysTNa*i)N&-|>k>QoT z3)l5!V(gi%rL(=$q!s7q=9USorAkpnWt|S8qP5r6(xO-Eft9Wir63GTm(odTJ1&>Yb|o@QtJMklEEtX#8C_*!FLOn*TosL>HTs5M!%e;aN=aB?w?><)0=%Au?cKGjUN?~Y9cR_lTn`5u} z>`0L`=fQSlO!qBd_g1j5#HpOX=s3=?WZR!R8 zSXGI<(q~g}CHq?0C%FVIVt57i8$7LGxxW4`$pSpE0Z8)>el9vGYN1b_G3y zvYAOHpI{|@-0IAJ(iyfemEB(6e%+MSq(esfOR>cC=6AR`t!_(Jd-=s{ozbJFr&oKJ z)#HN;xW~sc#gorbTeM;m*M;BKkX2ZF?86z;=?PEjv(+szeburRm^z*-BIhGJk@}3D zKH0}bjntF(Llx88$KtV~hU(ou)orfMy-u{M5*-_GVF=%AKnP*`1J78>F)Z`UhYp2K zN`J-M-cI~4P1SCKjv0m^Oc24zFtV-vtn(AE$mWC@`o(MUf_UlY#b=|%x1!C2Sk{Z6 zYyMvSv^xG!eZ3n*mQ+s=uHh@dm&W@=RP%CYF?IJ*DLbVxhoW6E$8Nw{d7JkwooJ>; zLjX|Bq#o6hvTx}+E^3%)0d0yid~pr@eR?ro|Mynk5NmZ^cld90JKN4#zqB34cGF<( zuv`9g|0+uv%7(wis#a9>rO2&Dvx!fXIUIJiYnPJ6kqq(l)~%-@|I+hUects6ejpzd z7#NgSt5oW|(V){G{JrJ+Mm26lbt|fBWZJs**rPgxn?uAA-01u`$8&;E6~iF=Xe23i z*@Gc8m$PkSW8-7h3k(CIzvCX~op*oRNCFO{XMP<|bN?ionV2|<&Kgi}bI9eST{(r! z^@`H8ez62%N^Ps&9xaympUR6EnvYK=-ISB60?jYfl(T|0}7L9)aq>d*QBs1I6AO%Kb+8vNr;G;9?j=E%9uIA42qhLFofwx8Du_ z-$8R=VD|-ZE8Tsn%T~rjr$uL-wP;1ToB1gghJF+`x{l!8zZu#K0ey7aDXEeEmx(HX)D8on-`1mj6@i z|70tZ-~J25PmC}!E(dThPxZp=K_FwyWws*Htia2v&JabW0&Y5#$D?~coEg1QJqdA- zGp~e6FQ5*!i(&<%C}Nt#f$1jP-Mzx@(Zd71bi&)mF1q?l zPkW$m!Yzpi(vFi6I_Hj(p1B#9Fp&&HsF{bgntY;|FFU(Mam?EYD#461!!RWRu|CzH z4hS=klTP_C>8#4^kYUoxMY7zkH*LEXchT1Z&`k8sWq73!hCZW;fc^y>P_8P_-Z^Gw zCg|&)hzkV7kb<*F_ByT3pp&#YJG#;7lqZ^njJlp8R~Wn3)ZpswLqSE76w+aUPSRDv z?x54D8?s)2E%OfFR%r|d7Z0n|41q~9)Os2^TZjqx0(twf~*0^$NAq8u||*xDlL z646#Va`Zf}a~NSb3q=6WqHq;PUAdA$oQO8ceJMtx>Tm@c)?hhoSdt?@ws+#DsZ$N5 z6*azm!(X0EhB?OK*AQ&?^o`MXtk8}c?i<19<9HiAR?MEqrg1sj8TA2U`JzT)p9g}-Dh?@JWiMd337(r+q=$jEY#0vO2dI|30Ptn#dC zLCJe6{cm@j9jdtHe0XwbjACzQEBUwFCw%8XaD01kh&`=xF zIXN{B(mOHP4!${D{HefE52-z<(qGzzjgTjyKn+1sB<3LZg+fAsiQzjTkn%8{LMc(n z1N#gz;iiBR8PPbq6JC=YO94Z03NFMDoRVX{2}S3e-dZ3HwTZ^j4^KD7^CQsiG@nX| zL_%RLM2MOb?AV)T-kT@3V|TNKlKRLH{Z##mZ{>9px=>iC|!AgP0#ENHV+xw@|F?Ye21ajP0x zj%gSk#mlT0%6HmD+0kW6v5#T zKf;r#tySw!UgOFy?AHEKoK6%o$RU2l{K&cF@ETA$sCxsENGzGnrV_=BbBHg|!zBQ>6 zFL{N4@jq8oLj}jKPDri9@8%#R067Ec4|_Zi5pG7Ix_P4ePZlr^uDl^T-Ie&>$geEU zx3^7pp<=jzD#fjTQ}MzC+*J1rh#yY$9&b`7-W=XQ-~m4zUh6&I`^9i@AvR@gB3I|e zN8wAc#QJSmcIlAl5{#iEb2ol*OXwuawF=$+3^EKDAcM_YCM^MC#qyvF4hx=UWLw%H zfL&PGr4@mEZxbiVTi=x+ahGL9Vl{XI)3KFQE|1I9R^dLu*;ypuO&$H!0>M{r4i9y7 zb*HJU!JyZtL{n39defVXMgZ$?ODt}NHtto8L^%b@=^Y=+&XJpX%gT;bAJSBL)co!Z zc1hjRoV2KYO-kUpZ+^}+4Al?R^R0mLh^MLDzN`Ww(6Ni2rxqGk&cee&Xnls8MYSz`L`Xw`m;nZoY`Ww7X5c*u22&FJ|iR5xsKyO zD@Ap46Lme~mOlzTaIS7X)%=t@Iv?-#+SAm^aA&ccfkHlC`bh@oqmtFgz|lfjlkVOY2Dro zWGhr0u7kpCJsGiu`jGZX_x|8fj@ILZRz6m>P{w8hL<}+)Hgtr5eXiYrdiRJs`@EU2 zZ}VbEbt_!PR3QlU7|sA0Y(?hx=(6DLJs0NkgwGWaVm1~)NM?AD&t?)tH z{?d_=WVY6BiRh!8J^s?dmaE=O4o8MjqZH9j!k*;}y~|(-F~!omwkVa$Rf^UilQ^lv zW?{r5Rw0}0E5*k!?XGJ()Yck{-nIfAR$&u#Wa(Bs4iH4D@m0i}#{HAtuG^-M^|zOI zt@o3s)NYZ~LNJOTWK7c6?)-xRzym-0Z`qkX3>sTb`!o3A5i1EX_i@^&{a(X09X67O zK(oH;6}gWgAf!yBXHOino8w;rOX<4XZ%I3#W7maZ5kBtXkzdhXUP5leKqeb-o_K$| zZkKbizbj0*P9K=;*#$PMnF#44C0I>Ag)Z%Fv%mis+jWG+S^gby z7f$?C!0&5_Gyr^jcgoVd?Ylii&oz+`Xzvk#*u*j>0RFw1niaP$u=aN^OZ;JE!J;I$0x-Uj8ln)XXotLpK|wwsIa2?GA6?&&~zDz&-!*&M3+cr|@qk4dB`Pc5ab zzg5)cHP+);AIPSa(dhtKPqx+drr@``i`zHFrp|;4uZYV?2C2CimKU*dJ6hiLc!*~~ zJ*?<^Bt!mfQJ6ziG^NGea*lOBHcgC9iw)CBaR*y%&?${7s$6Q@X}*s4xF?&jr;$zd zy)L-6;4|Oug`m@+qEr}uY40U}Xc(+@s^~#}_9#_TiPitqdn_a?>UwqX?P_t`9glq? z?r&Wa#iadTVp#W#%Qz#8F87?5;3XAAz%4u=&yflndKdk-^ex{;e^0;U4}Z&+FZ8mr zIwm%QNDYtdwd`kAJK>nQ38>7M^dpUv7VoLkCUbJ%CFdZGOS)5zehdng4AVcQsUO(Gy_G%0byG#Oj+t(NOa zmRHo)l%y#~Q*oqH4WmrwH8tP#O4AT#mZoLNI!y=5{WU%RJW(?c=VO|YE#EO*W}Z&X z6^+EvOjsl_+&l)&opUj39vGxh!+gdQt9e36Lo^Fc$=>jK?#q*J znnKw!Wtj+LV`1eD(|?HcbU))w+!=-0NbC}Ma*8=-Mr$-qr z*Ao3qOvs&n3=n-?$!`0Pp-7ktU=2#1qk$V8Aht2IJb^mql_{3JrI$7 zMm;I$FDe`1qtO%O?`iq8c?)dHBuh6Z?Q3!2zyi7BCO literal 0 HcmV?d00001 diff --git a/previews/PR237/assets/inter-italic-greek.DJ8dCoTZ.woff2 b/previews/PR237/assets/inter-italic-greek.DJ8dCoTZ.woff2 new file mode 100644 index 0000000000000000000000000000000000000000..a3c16ca40b2a8f454c34cfa91996ec99ae2e4aa0 GIT binary patch literal 32564 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 b6r&82^QQ+ZZ1?Zre-i}g|91_a`#}W>14e7b literal 0 HcmV?d00001 diff --git a/previews/PR237/assets/inter-italic-latin-ext.CN1xVJS-.woff2 b/previews/PR237/assets/inter-italic-latin-ext.CN1xVJS-.woff2 new file mode 100644 index 0000000000000000000000000000000000000000..2210a899edaeb06655f7bc50e7f94444da140b94 GIT binary patch literal 120840 zcmV)DK*7IvPew8T0RR910oVut6951J1HHHa0oRcL1ONa400000000000000000000 z0000QnkE~8yA~XRZa+v?K~kD9KTTFaQh_K2U_Vn-K~#ZUCo}+yXfJ^_3WDlfg1iJU ziP&-hHUcCAmn;j5SO5ed1&nkDAX`75ljLkj62WJ0vx~-VI!9E=SqdN`qweRwECW*1?Beg^e9`m3$G=b$U&8Y^EjENIiAzM(Co1o4 z_Tpa*c#8eo${c)hudU1nG$~V<7q=e!wZdEU#C~;O;Lqq@_zp|PNRVd=qLmw78mz&* z^q=pnm?(cMp%kC7aeTa}8HwTHdJMuY(d2zar|3E_vU@%>xZ5|S3FG3-JS0^S<99=u zTzML?Q3llNqTdWAVkfew-;UpdPN)4B5ksT6LUE##n#3-&gvjD5XdE9C_va6r-7g+x zolZlRcH9x;p-=I*x?ci#vK>z~Bw@m`97HLXIz0a*;m^}@{-1Mw?j2pvM%W}!0>x|8 zf%d65v$Is5i1g_PkvzFq8AOR8*->l5cJ)Ym@-Fv@)53Qp`d)da!zzVd-y46Lw zigF!wJk9z4b9R$#6bMpiDHVn4HSZ>&?|l{7&4vgTAb5m`6L-Xewbbpp3=etxw>2#J z`$Fy{B;TDRe@Q}eB?;;BeaZDDNm9w*5Ni!7Lx=*lFhEq`s|pzQCZQLFRp!* z7itFV{qN_+YSTn{L8)G9X z1ZDsR;T>T8ul_si%l0CF7#B4_b8C0ExJAK=9mm&!HoC6{VdFoKaJ8xGO1m4t zIZaCoO#D9ion3U>MN?q%f4k`Jw(Y{lJyJI&#mx z9RvmJqasr&4=5$sxa?nbB~96x-Er#`AVYU#Lp$kE`ukDrZDXePjYHhF+4d_WL-%1-DBtM4Mvm*4!a1YVh$-4&`8p~Qt>gwm}5X(x$k zW3{<-p*ZaU8~Z{C5YE0N_-nua?S7L`%n@&pm~Osu?hqnPL!((qM3W=W{kwM*p8of1 zvu5yg)}P>6lcnF$xSiN2jnlU@q-E~?Y@fU3F{i>Eyhlt0c23kMMU@n7nkJ=~z&9VF zIcpG$*hUO-3j_!R31WeO2MMmhEZ{{nK}spbDpzQ)P`#F?sa&u1llH84m20nO{R9kA zfE_SvQI6*R$sD>97TT&RU8~55Y9RU#lNVl|odpUV^P$el2mjoDQC9bDMbs^D$hLT- z0fFr#3-o_FvjhBJV6U_k;_fP_uEzFDf9%m(OAuhsXezhzyDniTQV3bQx`nx=fQ1;S zZt3o*OptU~W@gQYs;KW4ghB@FOt?7FJq`oI2)is?OWXXGXo@3Cpw7E&)c&uG$+-f7 zG1ZD?88kXIu}17cbU3`fFH@`Qe?@{ykZer>YRx3rW((?`-A|26&AKb7?sdkT{Li0& zD(fdGW@SO$i7Zl)NQk?Mf~3hxQ0hdLI86{B1yZJ+UAfxVkmMX8IR zx)(;81;I8HsqS%3Z5+o*>~ThGoH-o#IJe_Eb8_~0-{Tw)>&*SS|7WUI+J#218sLgc zP!5vTNN3mBAj4?5#@gt7RP_tR>aK=qHVok?Qs5YX90MB7k{pLNpc)X!M>#XbdP?Vg zX0yBOf@HnTCcJmy1@T@GZZ_e)%Pviiho@=HX68{sR)sD!7GYYEZYNjsuZMn=)>lDa zp->i&L|6yU|9j)%zc3grh0xihL%FMIo29j-Xe2}!NiqMYvt10yLprR3 z%WuP4LSuBpg}I#bNU%~hTS6;*;%AN@PDumjqULvBuDZ@X5QZ%Za)_yDLjpUNaOa{l zPkaYUXY3DPU;${jFIwS%C=Td^@ZkSzuT?Z(=21$@-%fX&N32vmZ|oXZv4~Eo#;S9S zF@Vg%MQvWTt5z3Uo{LIK?{LcvT3 zwzk0a7Nk?KXqs66pMpzgBc$5@{@^VH0l?!;AYEW#lSo-C zjR*gK`{(}~bFy=Jv6JM;l5FYc>shSj_f)e*g`|-fH9jMt=y`7Q*X2((U!)?&XDP%Q z>|qwRgE=IKYT`f*uO#5hD!pc9GF;~9i}>8iM&`UxF{bdeQT_Y(RAt#N%;V8CL1YjS zDMXBjG}4jD{B8XiHs3rH`{z-0_fgs(j}Ukv7-@n8kznS!ZMbR$-tDyJSdc;}?9Ib} z#Ifej8ggQp+l2naF~$XJgg^6!5@l*YT{uFOLb*;fuJ zsWJ^$dT!j+Qb#NP0tAT^ElCQ80)>jT)m{(1^wG~y!;PA0!WdizX9Fr+{-6=r}#P&4>YW*kCCbwp1I5g3-fT6^cznv8gCF9mQs% z*kTmhhGP35d?))rY5+w|=Gdjx`ImD6@LghA4)72FC*-qmc$MZYe1xy}kNBU+4ShQQ z6+M2;`R~)Wz-Ra&EjQ}xFf7x=01Dme*5PYFdSY7q@M$ni36@WNZskxC{&*!kD%Ox z@I%Muzok!|dZbOY`@E5;o@{5cSb3{6?gyv-3#^WPgaUdLG0<_xo9X6vejpxG@45T@ zsqeeW_UwPDaoqF6KN7v~yRV8KDShyhk2YVTpN_QqJ7Sm&y6=dUR#7JtnxibL7J6x}O5gT?UMGJ^;7k>o>gtKDzlO zn&a-D9BRKz9v}Gh6VFNM^>;%eO?&{~29%j`oMAN5Zrink0N!c9VLy!P%_1OLD+l;% z(}5KLa0I|n9BtpdTRis6i~cYgO8(IB$Gb%S%Upb0^c#2THQ8^HvdwLNbN$`p8-KU) z#L=TSK8`za;{UJ49Y68rpN`#K`ThNqIr3&Z>gdV04}7&Sy?ykf%oJ~TV_%(q=jc;AM*s9h#L%`sFTQtw=FjU-PHzA6(^uMq{<8Y6efhs^(2O=e zJv#iC+aDPk{_Do$ySM-K=GhMUUmqU2f9ZWI04U~&md_;@kV{v;w|Dlj1{nUf3hCzT)fA7 zupx?jU+0BWYxjEhH7?!je_pvyosTz`?hQWEUcR^g@`=ee;?X^W_e+m9&)r`;f8qfI z?(JQEAY4C_+`rLe-UGX({&f%4ehN1p?ELu2g$KKv1@-;9Dm)bY0&YCix>B_t>Rrj9 z2wDH(W4jyL*AI_B-20JZ6EyRq$96Tm@Ad~DEYTkcPd{qx9~*cyc)B1rZvEI1MV+9w zAA9W9S>oTy-idcMf0*N~#|*?#4N*bN*@N!-ZU$`T^Xr&mnwU0362$ z1nUYJ^WHz!vG4+Z>2C6KE2k9Uiz{dE%G0xGqVqF`jF04}%sp!Qv*vzM{H(v9s(!RG z+$q0(V$nBMKRcpy1~U!a=lVbUzEoGgk+Npt141<^=cB6TD;l=>2<-?diVu z=RdF*_!YPIg6!5$y`a0kC@Qc2(ELPC^fCWlR=(GNfYnVc{pQcwWA^NDJie>vz+Fdn z^#&(%xOeMEUmNQqKIk6gM`P-IsLk*YAO;KM-QS@R#E0 z4`@?V*y7_m)$wRYJ|xg*tgVamE4QExwWqB65PZ_Q3+hjq_oY5}pJzT`9fB?iNqe7m ze}s=}Q<8g+c8}!Ur9CL${;R)`qW?XLTif1~2b>>pDi?w`FY{}-$= zSvX3pkYD}4IGe=(>Y<1ExiMR|zIbRse_?8TXno;~aJS01SGn;I|Kosv{+}IY|5DaZ z7Ko=mq94fnxPC~14<7|e_a*6o`LG+o{Diz$2{-oNr}UdAcMb0zSL8jcY{RDte@Yuf z_%m8RrSH}5S6i(U_iO&1kzp0?S4T$&G{b|sJkGPe_V+A4qaBsstLsOl_Zo|DLxumz zUzsf*k3Jy0&$#!Y<9jB!>Dj%<_Z&XD*K(Ej3X6VRe3xY&Vc%t!zc|13R6H@h_3ZSk z6CaG2ql0UR@ z?1XfXcu#ouDXoDH_tCxTt(T0k+IX^aqncA)+2qF!e6*hk>htloO`K1*G>Ag2r?Gdq z+gUogx4FDD+tXer#hzx6VO%Ef>3*8-(m`?y-CCX&gH{KG;}Z ziKk=Qg9B*LzVtJ<4VgR6Ifs`1BD<|8<@TA(ex0qO&CcrV-mufz1zVx2%BR_TVc z4<0dHq@E*&;&0FF`_w8*$45X85#!48f99;0`~G=2%-hdSnm~B>!9DwV^7-7h8N2YM z@ZlYBb-#aZLMV65*C};CB~frF?(PLJDAb%_Pff#G492?bFl`tSUlIUuufx9wtYD~p zY23{{_I@kw*H8GHdPKF+6B8zFW;otew-Q^3{9IZjL1n}C{&I&5i1*3rH^BT(FH__q zefL!X@92f(tuqzGXfR5C+O>W00L-$dDFy*b(iAVC0|(nYK&+hCtN?)rFeW)?*NR2E z6{xhoOlYnu$_#Xo3TK&ViJzLGVT~}{c0cJTNkv438h5CG$*}8i`HaB%nSTph0?1Vj8ATG!jYlsWEqj#%Y2kX*!yh$)W{mjK0t!Ek)mCFItYi zOI<%&k=|!U3(@AVd4-lMm$oKR%)G2*LvYy#c*AoC@CC)^rJnL&s`IK==Pf5y@ z`NO|o&_!L+qI(uWBJ2$(LM^&l(=fBBWv(u3l?;w`T&M0#kz$w8HQd5^Ok;8boZq|-;4rdwm9iIjbxRMFDkVAi93crsIs_9{n#$pLW16xVQ@YC4qF${} zsRD1!*0Mqk4HzA|s++I)Pr>M96X$N7Woj_D;f#^Zb4S1fcu^{S8qQY6VL zV+q^je822bzT}DC;YA~fAM+SGyX&&oj~glP0FEO2E`GNDRIo!G?`I9_K>};VH=`tK zQ;E{a92XC4yN^8B17Q%lL7sdEkRgU4=i^b93dp+ji-3q`N9G*Ut>k4N`=4&KYrmL)cIlqxA1Q=OYK?P$Kq>6jEP~^xWDuEAGQN^Re45Ba-q!MW} z*kvtrj=nJ@#>Lcofx3vqoJflF$d5yDE^a7{ZU7*nmH?=W`fI4hD^7{ppd1zJq6j@U zPqwj31q3Rl>Ue)TM)AZ-xST;1d`cmaEGITD%|eM#o*U=pZRtif$GHBw0EBxJilt;$ z;+;X@WSSTkv@u_odj!@Ix4hf&TGdj{1=mFUPM+oj(q*%GX*w zhWEjp@wx|M2cQ8j-_XJ2wU=$FV*k%8mI1klSN3D2`9+Un-b%bkD&>xtk@{09`C>0* z!RJ!(;Mp35EQ@hL&M}UCd17=DoMPz1)|)r}1A0+#fIU9I{C0L4yan&2x_`M9PWHQq z-7n)(Lo&`c-f-lq!I-COnV%1DWgF2C`W5}(thVp2B6*~Yq$-%;>s(c_FZ14)-Ntu} zxAV8dSE4@Is4n1*w&;g40CJ;07Ww!3U;L9^;q!dhUn=ENX{mRXiPogv&)d)M<-hO- z{2qTI7hB?=8~aGB5;O7lXY3MI_(grTcI5uck16@Jv#&*){K}`S@Lm5&|33UKmX6r| z2M!{-=WIyc9m{ZOOwM10WiO|qz-qR8|A;ftc)s*J#Mwmx7B*Zup8BmEzi^>RjCY6R zT)bU;f6Ttbu6qp!nD3HDaTad&J1Yh$jhM*WS@(M?#1rYo+r&S(Y`XARI{!N!psyRC z*V3=>IqvtB-n_X17Vk|i#UOIuOMTxk0Gjh%Ix`xe{bFnS@iDnOc+($F#h>^wAG=_} z+v5B{|1Li3Z+L#R;|+c++XKQEmY;l?2l;ax6JE}9dAwtjK^$msrGK@J-}+totA9`z z#Ba6UG4bHW9zpbxa#aO&yc~~;yKKq7EhEw6%LnjQ+{K3e8RGs*za7K3mjOW~ez@z$ z>8toU{)S>N+w%*36uWJ?2&(W@cJy!emDhMlezoB#z)n7?Kc_A}@>>@dwz->pqpip+ zyW%aufC=501lcCIM#=1k8nI15dIDyw6EA$VT-*< zRjcG;35ZE{=w;W(Jq)odbsa#s3}C#G-xiz#;J>Z}(6y|bUL>rVPO2 zI;|3>C)6!*7jr=`!f&{c46RstBb~P8XeW_(tJGevg#Z8aVK4!J&++j5^F_HVFm)%M z8TX1Qfy2vFboUkx@d+>N7=9!7?{dI9IL>@bk~n3&$^zG*cKjAwBmPC6J$;qkiap*# z{-8zCV`VSXc)Sn(5F1&Ow~bG9IZ6h6f#m+>a78l&UdvB>dF<)`!%T3Ee01Iu16c8e z%wIn(hq@#2Qa{JHDLzQgex#=y=hNnF1zy=%3AJVn{E<9&868nyC$_%FwkX0Njj>=zz|;+6N1z z5XSm(RNKXHAMx?#yfu!ol?UX4VNf2F2b+iw(;3t8Nz7hLRb1hZUoJWeS4)H6r_V06 zx>^DLt62D60Ig39drjNX=pUbN`+ITKrRcWqZJCYpAE_6Tjy)sq@_sl>78PqimDOS& zS6D&@5zN1HoUZ{>3r?yIZ|oE_dD9QB4hl`F1I-s-CkdVAqVRv1+q zra}e3i;J7#G)bjyN2UZeUixex4hK#;^cx1N`_POg4!xhf011uk+b^V1@mn^iq=!e= zgGSVPoDUCj>lEILbNxk!~41u7vzJ@J{RHvvv?IM z_Znp|uNF8R>-m z6-dCY;g9M!ZQ-z0raV+`TRZ4a1jp<*hMx6--UIwSwk*J|=u*XB3b^q)0Y3EjNe=q* zN@{ORdRn~hy|_Cuxze4HPiP-8b5;(IA-`kIvBEp9w3$M&6p`o&vY&v9H>!_0*4Q>x zlW;0p`>Imsy*)YyOtra19umJdfa)nQ`MCDdfV!1f=hPDAU3FlR$3*u-`kX;*{P*UW0WPAnZr#RqfYMPD-Hc6 zkIVX)8*(>ip18x?)5|`7H3Yd1JaLB3ALI2ZF-h-|v-B-1*N_P+vJVr7Atpz9OxZJ= z*}eJ)c6L9PU7^Fumr8w zyI}$(G|tZ>G;fGV(c;Dn#2|ZSUB`~?j$FBm&W}6i z{Fqy=IBXmR_!AvR*8DURkhh$w0ANmb0`>ZMpXAB!s26^i_X86L5{0JG8B7+N!{tdz z%gD;fD<~={ixjr(*mK~>6^p+BY=MFV3&E+vZvz1QT*M$27f*^*Y0~j!$dXMUN3J~i z3KS|*qEwj*m8w*$QL9e9MndBzOqwxk&b$R;5{s5B=be!ZNRVJ5LLE~MkAR4TjE0VZ ziG_`WOU=xxnoSM6TF%$%0S5p`Z^)2IGGlo8G-=kNRhur|0-Kr3jymSJ6HW#vVe=MLm^Krf z&GM2so*gFlM(ywo*-vGD7oTZ0b(`i;^Tae}%$lR7p`|lV&%nsU%)$!EwgD>*T8#bW zYZ(?KeL@xW5^rC-(r0n8Pa^p#Y;fnnGkcu{-20x=+8@em?o+*^gnng9&x~*PR zp-^AzwhkJdkHK0000000000005u0#xC2{pc6N6LpO3`H*r%pOE;hG z+Zp{%?RN@4&oK>`rf!yQUe-qvrd->fXSIxLX^EWc1YO+}iEjr!yJwo36h^8uG!nz*Beiwm?CG`>^&J2z`)=K%^+qV#EfwWbiXWAR&Ar3b6|bWFgm3 z5K5>*9SRL9Xrn5^$kYvz44EV|mU0y;)u>gcUL&C<&04f-)2^c*DcnFYgDjh>V7!Dk zl*ey@1Au!2P*y5-QMH#IeFpY1w4af`7&B$YoCQk=Frm~m9NaSso8 zI>pOr-p=rI-USy0x+26?p~8fV^q(l#M7u7=4Y6*zCEjg!+;vZ)`;z<*)uI72l98e? zicqXfIidi~M`j)i^H`WNFfk8hVivk_f`EXGRfJtFr+O}K9*w+wnlx+Csx3OZ8$IaN zXTYGL7_Ko!T#Sk_<0ed+GHu4Jam#3$(J`@bwCm7`>kXbR{M;S8x&wJUn{Sb~l$lgJ}u$Eji_yTe`Xc8_2Bm0$Z!{%y@4CU41uoQ~$XkYCpE<%5rc;$MXw zDzv9t1l%!)Kv) zBDkp^0{ogQ^~m+tI`K^zTG?b@2bSSRik;SO6wv{#UyhYx$qA}qf7pN@$%YkiFDTc)- zBSuM#88>0lXH%xr%-q|y{=?D?yFt)yx5k{d;*r}4>rJlGPXOMkH&~bl_O&>V7n=bv^!7BCl;m@x5{$<&-%YM?c;}kJI z)qJ31U~0kAimfd^zx21aI_-|PXt(5c@Y&*Q_%yJofgQJDC(=xdxJ{SwuYXJY+CZvc zz^5LIFW@;gDcDH7rhPq#H;8k8?Qi_8zw`J0!9V&Z|LkA6YQAT9nS>V)tQ>z4qB(GIcI= zy8C5WaX}LX-R7or{kaQ-WFJtcPMtb+>eQ)Ir>?ju^1KeLv_Z{Nj&Ae=zIlp*wlWP( zzP_;_03H|aX5N*Dt6k%IH@IKJP6bteGMBjlt*z2|7VCj(E89vx6GSy+(yPaZ_fF(?FhdH&vv~meVWB zu|9^}S+Z-aJjNMs!g>G4HHopNrgfd?^WWILWAlzrFY$R}{ooHnd+{*FNqxhV?T=wc z4pb9L`*U5osO(WU)FJoVY;DU-SB+aK-+T%_TOeXQ*+%XX#k2m4#wmbNc1{(XNrK^} z5O?t((8p&AxbTumz(PgB=NujQMM2n+=@&YaENC-7*N&ufYz#U}S7)J{*Qb5eri0X5m&@Mal4N%g<0e4 zr*fgIxbm-T66L|`j(Pq~3EB|2Noe2HYWtlcx6Ihq*e#?VW1xUJj69V0X5C+bYUZD% z>)OrGqkkV^TwbUcL54K8wDee6tX%+^Aws>&+forvqq?$-gYX##hl{-VO+4Hu2UmP* zdG{Bn>2}A+H~}RBf!C8&Qu!q=k^Cm+#$$x|(n}Zh1SRg-d(T}`bu$tonK=(}E)QJM z#jrr8Z4$+fzPfr|{ci#}Z?qJA`267Dr?|=Eq%QW>w!Q-H9@o-%ZxD4<&3)^S4$u4Y zVy(`fT)F;;pvCUrc36nSj~?=u$fvjTdV7uVi(K&5J7%i`Jkn({QuM~0P_H+HZQ-|drL#TClROH_q*kzRdauhJW+>TkU2 ztV??hc7AWX3a?JRmUjVtMRl@C+O3N-y3*XMN=JFPTEgqG!;By1>N|U_&yM?Ai}J(R zOkHx32!px|)gw})e)M$x;N3vHZmTA|rjpn>_0`3_HNJuzLubrA{^j1HyRg&qdHhBq z(ueaSwU>P)-z&7I-R!TKB+(Yr{9j(qZX17BVpaA#19)vG3WywE6oGQ=Iaj=2ip=+~p~ zhd&1pO92lj3#7Rh-Bo*VHdOJ3&wK zq5oM}V2WyU`(iYL?6yutXXN7O+kZp6&I^89NTf!uf&R6-{>g==Qra>QNyz z6nw+09Yz?1n+e=3C!%rI2hGRZL>lV%W5l+BI@K-~Z$LyY8#`jqb|H&_=!u&A5$@j` z0uo0CZ&8c4pkREaloYjC zbwF+ZLg(S3-r11|LjEkW-4X3>ugdO`?F&_G$gYv;HJ1=(0gH?P5!eDYY!|rQm0%q@ z_Tw-(tRajG{iMk(fsCQYJYHZCS1`kRgK|MWN>unDph5vcKtsVk+qR>uEI9I#N&jKX zF<)!*)f0^NizzhHq|L~mW@O2UTzM}YDMGM3+e!INMg7sBGF^zQWGR72)(&0aU$pz< z3i+z4=}r+&$w?n`i9boktRB93GukEKt~2YnGo(n#MDFw1qY|(!s??-XlS&0lH>%~@ zS>JL)IHsps+HOO*SVdX4Ok0AI8SP@|d$$PgfQ7(23xRX+(c-^1^u@~I+V(9B)#75} ziDTGpw+j0A9Q>_Od@9qR0e$PqkO|u+7c}a6UtH~F)xadO5gAd`oKhU7JT(ao0|u5{ zXhi1N4vlHW_>I~mzAUPM4&r|UTj0lbD}^L<=4o?`%Lz$@lzHNH15izGrP=}>aP7g= z1O9CS#05aHHTKDb3?24H1ZqLih(Ie+#56#SCb$B?-erC3fFN&0BkbP?4sIb_%IyS( z5G0||DKE9G)e+bX7f0F#CzuD91WCG5(k{7TUXYPbWgNEDkzz|yF*%W0SVNnj41h|p z!YG>H!4v?bywPSYa4nOK>O^ zNhP5`6EaDkOwEI|#)Gg2a29QsC5hx#bdcBpo~D)@2QkOL_e}b_$WLz^NG=g?gsTxnKD|p*=@)o{GtVlnbGgTLc$KDwnHeiNiAj9I#2;0oic!CT5No`Ph`N+8T`^^*Aua|xu8`LkI9TOW-&Blh+ zODD#@70aNXzm6%<8UI!+Ss(e|5bdMiqeHZgz8rTZsYke0-AZ%)|9GK4j9zXwS*ksb zU)TKiyyDNB-_M4b{Vsi(4FdqIg5W%zw;K=`>P0Q6hZ$BeC_Q;JDF-O>cYTilv3(mk zs9pH#MjPNO-Sq_qev{kwAOTWO&07NFuLQk%AlW$d)(qg3;{si<fHjcjCp78#sP1}f$2P?9a0V&=rp0F!@yY=VJ zbRgcbOSj|c-HAo0t;~D2*XLijEBBH$-WDHReJVc!*N4!e%X#8%qV)XXO2L}RM|$(_ z)Z<4>Iq9xHS{$2`ihHb>B@6_`lmhPe`SG_Ib2U@l%f&sBPs`Q#!~u8<)|01@q`UNj z+762enyY&7bgwsC+DC1h`gx6X6>Ueg22EY4XG*RSy`uKTT-wE^+WVyjBnJA~9!I@T z6u=CX=Z@J@Wm0^vDaPW(l9f+62m*Hq$dWVy-tZ#fcp00r>!mIt^oZF@L6RN2C#?0GA*tNhVD>`)T^QX#l<*~{WRvE`MT zKJ(6}OhV#+?&r$(og{qEV2Hsa*=N7p!X6~w-;>GHmrh$cmzn-?i8B1*A@FrY{PHn2 z{>flKfjQaD_MHUHtK6%PxjYp$KIOAuYiQkR^y%=~*T{88t(R!W;8d9Uxi7}oU%a|t zm*d|L;3ou5ETcWHch8QM=nF0JbKharZ4;6|+0N`AQ3P&&oY;qtU+GgOAE(Vxif6u! zJB&32xcBR{FfT3tv^Ar@lux6<=1j1m?&R@~iqkftt*cxn)76979)7B7_|LCxdX|kY z8(wc2?oNYcgRBRcSxhBihS{MpEn~gk026f*mv$t=uhUY7*4yS_hN<7MY3BAMSQrbc zJ!E`9NZ!H~cIL~^89m~6(qy}{BAVWxMX?@lu-fBB6UjRt0}IxhL=ujYbr~6V1Sut( zv~>9RAwA^3^n1o7BZZnC;~~xr=_pq!yGc-5=mBS**j@6RHO&bZGnqGq&7ywc3L+Ws)A7G zm1!8TxjSqs-{Hnj7Va2696X>ckB(MVW(ja~(4S^_V=5SSCrf0+;KazV zb8?gt^X&Gd9UE&8*A(Z@Sz$v&Z*7{RXBt!1Or1wbwe0Fvg7ZHzh_YaIZ&o!iyd(c; zNpQf!uOq6Wdj*}BZ000WBiRFqAQuqT6i@f8FsreK| z!f$`~tFz5cTb5GX^HcWeveJziEDd`P4Zm0k*lm9hu->Xa+(O)dIrHk1*nr>d`0#1E z;9BJN?!m3Jb*dd;!7*Q5|MEYuDeXd^`!vaoiolAK-1-m00mFICy1y9M3(sB$pdmx1 zkSKk&M3fb$CvSRlqfcdn54|eaq@v*eCwrHuM1-D~2K+@yRidkbMj2-2$K!1%)XJXg zZp(&n)9sXOy1f&TJCsIr8>wEO9442bNAJ`bb<>@9vHvdCo9=p0BX>K@MJOV!Z{krU z09rfrDQWm4-QT_3vFjL_iS{e6exkJC#d#g*85Cs-uMy_#%0KvZY#7$2y0N@zW}bD9 zx#nHw@GDr!NUJ-*s9^nqY?T=s|7$F&VKu4d)K+cQ;kxL z7$O;?n4+0uc%W%uVy#6|$zo}`_HTuV#`Zemm8uQ=JdRhfv&T)Xl*5bN}!9yRrP z**mp~&>GX+_;&QEj;3@rgWIe(&Ech%O@kc)o{jCfr71p6^=Vq|V&J-K0+H^Ux1TisEk~Yg~D~D9htkrL9w^Wp8Tvru~*#u*>#o5+}ZCq0ywT`HyJ=G+8 zqo-rS_X)dc73)~WyhhsGvPW6dXlowTiJaZ8N9O4btsKX1zmdx5o>@*SmrlNUh4hLU zYT*4f=6_EK5L91yC?(m9iL9sRi&$H+ld72|A~gG|4Qv7y1F9l0Jqn&b#sk=1L8FRt zQ_D-Es%m|`V2g{?8$B77Gr3eBdJ`+%u%C`GTl@C5`F%c-%s)?6GQJwxUK*&@V09kP zuGwMk>dC9y;#k%Iun%`3z}fihJY@VC6;F@ zuQcB2d@}fEYEoI#Dw)-41zfJnTru=`?sLBjgPuDBMH5jRpzGjB#9Pw1uy4Bb3 zRRbCt)YyBJ#28It_E}3)SWSDE8Ja~kD=Y+_4K*Ab8~}Glgu5fby+Lq)FgzF;9*qW% zM~9cQ_j$T6Gkl%drF}CB(dEa0{Y+xDo{sDFc;1Zf?F4)0&M$Enc7GSwvg3mdw_}^w ziPbl~vQ2hi&5aGQl66dKp1!8QyJ0fY!bM?z8EsZh`(YLo!4UiCq>1=Ui9 zzRx^zjc98?ja)0%fbLy?op=>*4+)T|=u;bRkc|F+{f$yX-3qAWzh4P}{~18uqHehPWuJ640M*X`@QUdJlhZCskiFy@6k=v^Q{+1zqdShT zmIBj&@c~`~)0nAhguB!?fHyQunIAYD!8N%CaG14AIQB$r0B}RKJUIbhfu7@9BgL`W zgs4qH!&;|m5%vt23xvPuI(0yfbpfpcwn5V37G{M8GmD-ae24pRRAWqHLUvnBHYtrI z!gnBPE8rgFh#om`ZFuN7#JIYWlM5D#1}aPn;Y)NS*B;|ydW<=yM9>Aeb+%Gq;bJ19 z%rPcfc)(!XwKlUVZ#j3+1O^kOi>XZ17b(|4DUm1_XtLQgH zoZfaA1raAD6apnQMCJ(K&vicUa>`APJk$b$nGG0_%DztI!eN_MdYT$!fdwxV%(2uU zrGZ4!WZoLR>;*j`Z~CjJf37h)~OKf5uLNvB=4(QcC~TTJuSbZ$DWw<@&TVpmN(uthOL z9Y~OxWQ<-QkvYTa&{j2p$U+AzsVzdIp8~82~px$iMfX)Lbbxk$Z#j$SrrwW-a$|zS%$(-KjRx zMAlLR8r8p7AN^U@>5g51Vu&D*-+KgIakht;QDv1_ZC<3ZO+c5F(qqx!bg{WI{!2~e zGw@=BCM|Glp(yNXi*b%2dB7Z=dQzc+Yp&OIfiygHIwcZva7Xt4tcV|k2nIDIa}Z!* zwUX?TQQ(~s*i3rl2=`d77*OY-aogy0v7i0Q-5S}j-DWH=6`92yj4@2Zss>1q)*KGf z_@`QzQp|6C<9TSeMFVrZ3QNI8Jjy{!Xb1~3NzV9deO*Jl7Nsjg3Pp3L7=vnrKcS!^^&d}IZ;a(pU7Wb)x&q^SZy2L!s_=r_(!)lGkjV}Qd@NbJH+q#WgC)2=xjZrm51#u-Zl&~_II=x^b zk4Z2m3OYRNk%R4T@Y05gm-Ji1Qei&YGw2YSBYk;WmJz5b|BV+BUqQiv^iwaX3tsxsZAR+j!^C=+@3 zO+<8I+&>O2%0gz6O$JDGy8^AJYV6Alg<-%10HhikWVK5HJ~-JoZ7n5aq#U8W?4=zm z3g^1pz=4^ME~7HB4ptc~43N%XCWPQiP! zkO&t#oPoe*A98m`dyrTu;9Hf@n%J{|C+_!huaserEIltXyHD{@DioecJw`HV1o}OA zN9RV?Y&-PdxiUixhP|s&(73(p!m~;e)XE4S=>tlE+V6yN@iG>`P>ozePqc}AjWyIS zH-&xpP*?Aa+VPpFI9VlXF2)7hacZXIiyL|^^<)I`Vw{?2=r2`ak5rX5nG9@)o_Qf` zfO3;PNz7WBiuV=2^?hu5R58Q2a$VSO5t)2!yR^VSO`~Pn(Fo7fr_1E; zbbGrqD6Eot1H;LU!CtyX=d~ZZ&g{aoM2kjD-*2UZ^e=6FTX=V%wYkHgCYlu~oGaIj zZaQw3t^^aPE+9W%2O}7}Y!lqWCW&Gh=G%0pZ7+v{%Z=l3Rn3c1RGgMomL9sk`mtp+ z9HHPC7Gs{{Rcv~}eWmy=P3k)YT(CC})9Y}RCjD85g!M8E_tT0ZL;2u`bSofQuWL}H zfpekr7|8>bC!s!2Q-{f!t*Lo^74PiC+-vzD9j_2dy>0+GtjcE&r4-u7r`|=8{j+Th zf*9&*B=;qELuBy>v76PoURJtLDOG>9*p`bifql4#!E+*ZFD|nXqS1cEDsqjvbW>|F zyIB9wIT(tfC3aa)z)2mFCD9rV#XH{P|6_&%wj?SN4bbQo#M)Czs9T&iJL>ZZi(sTh zFlQ)@ZMoKrh7vgVuTgH6^`%RBdk5J-WPMF$A+Qs07GVNzX(JIzzP z>lBs#egqq#i8Bg}Gey&8>@F!N^=MHwGg?EGJD3*F$@#kKx z;Alvkqn_dRHLK)KDS4-jEF5LKSls|~rMk7heWlL1sanIM<9^1O71f@>lc)pDS3OIv25^KdtZURW^uIsKf61FukoYJOv?@bct6!E3nTYF5e3AmE=lrZ1`~t zOB2M8pb5UJ5!}y5QL--7cY-s;XVZR_8uHCU{v7938Cg$QzDIdCZ!jwEq!^(s(pfX6 zaaMRgMcw(3@UDV@4un)ehv)b$j#?>YkKlPbHq3esHn6(HAq1H|!d1F5(S65emez4) zqSGN6OJM-<)PiOxIJGQIQzjniA}p-2{Hqhky*m#}Qwmc!A{j9xn4`5P+g}x~B2x_s z>PuKJA%#O7Tl=$AE+dpw3;}f08$3S(jP_%EBkeLXC8kk*S!0o66`NuVe5SaO*Tt(D zhuut*530PbDdOA0hVit`tnDPtS`XbG}Xk83j)Q)`O-f6=RF%c`14@! zN^wXQe#X;jVUbPl|7I|3&NrJThuPi+kKSuE_J8lz>{zwI9;JC8GcvcSz<6rSpsX8L z)2x#vBnp$?g!5(v2^4s7`(i4VOp1`7D89_sTx~~-m%{?5ZC(U@7x8ft&i1tZN|WZd zCUUqDKJYX3u`c$6%xq0{WcYaClMoIrrt5)(CRr~J=ZJy-Hwq{+iFq{j8VRZDP)A*h zk?_i`4%ZN=k|!PG=RjbvBq-~VL5nBjEX@n%!495ioorO+=99UVVp?BzK5?~)-a zF)0vMyk6->7^j?v@q;sCsa&@NM|tb~lF;~16Ro9=yt=x~!Q2%psB(0Qj4=|^$8km1 zo4f+X;Bj-#wJATWO|Sm)yVw%ZdW?c=e;sScf}ln+(|M_NeR6 z0-ktp+C37v=XK=swk=;**b_d?2VI^fhRmMZz&qpy6uu%x_?ez!nQ(I0{MMiyhf*V|=qng^CZeqQ zP6}-ZxBYeVU^?gowQqF8lH999?tE|4PwDMY*n)^V21e;k$M|KWkXiGb70qux#x-z| z7fFWm^Lc|bs43~ei&EeeZxWY!f|x8uD4&osn1HJAB?L$>2~poVWPKzoId6Fx59e)O zn?_-CR}3ndXoAQSA591j7vStV0H%J> z2)|S6J$XKy5kuqgq*F)v@{KNZZO&nPS3zvsPHKLs==)eZTJ!HAcJ4Ium!kFQ(#>PW zCXK$NUbEX}r6rdtQ`3zY3w9dr(t)mG0;-=5pC7n-yS3jfh`h@*Y$@iF2s$JZ%30pt z$G%iw9`u6`d}SpCDN|!1q>KF;4RO(!Cxc3=CFK|O`HJWm+)AcLGr{-_cN_Y6@&t}Q z<|H&~^^KQOPNs+R9+l)-`7e$HkgPwrSX7F$*%65&g#0EK2={bx0zd@Ktz!gnHQMgd zGs3V#IktmTxQJrZlrdfNUZabzBZPv}9Ljj8Ro; zb#6gP3C_WX+}2wL)?q<)D=p|fW!sUN;f6EmN8 zv;9c~vvCw7Tda9+q;URmiQ?|klZy}N=j|1tJpEcM&_8gMNHz(X=6BO*OD6M%+j*Zr z#iyd#8RR+;P6!>?9autKvd8EcjrWS@l*3`E`Nn10wg0MsbxjQNF=J)1@$WUYNl-wb zWPCOqxRf@5`8c^gNXIuZ0N!PXgz&L-JQgt`jnh_xW*RyVCcO$1Vf?sTi|+8{()kJQ zz(l9@lms7jMnkSSGJd1bzvUxrGi1kVH^=6vA6s-#x1wbZo{+j{JrEvBpnDBuVN8NQ-H zn1$4SOClbx)d(7!-o;7yULLQ`sz7dN_EB~Wq$J5v9bf?6jf=6X-6IXu!bDl$Hsjrr zVQN9lfHfkHkR|qinnCI6hs=lPRFuxO?@0I@6yB&uw0dV=F+d6Ptl?Y6()Fy>fv?}Z zN{VRbC=}$f5)llnft2tjP@u5uS|anOW4wc9 z`8>v=NZ~Cx_C65>hemUeY~$RiA=2l*wJ;(47F+I`16zObS)yK%eGj2`0&6~mCSdeO zq26npsUh|hmrx?5Jj8hfyuag5c0I8t#8~wfXYQly0>TWCu#LxPLgp95F&C93ZlC1A zzO^zmv&Gj^wU@`G17-3pjJk9hzatJe0P{6iKBHk7kCFK{Q!l3g#F-rx{WsL ziH*zI!S*>FKoR6O05g@$6P$okCwqP4%TV}zcOyxi`3~Us|JzK{495W7@%T_4aAW8 zPmWE+C-~!F7;qp8j*^wf@;!>rLTCQzeTdjv&%xhQP8;7Ty6%}-LtFzzd$Kq?b3DnB zjqZ9?GSYl4VUC=W&Z*J5*V1SU6KN+KV*II3>ru+_R@WtCe zR#>j_^ORhtgsi)#zQf!}* zPux&l^#_jHR!b93WxubzQGw6=TJPsWw);iwmr}GdjV&9=NipZ z_bdcmd@EuYN#pcNVI0SskljH1{N5;`6R z+vnf*wmV-xTy40YlXaEQ?6E~#a7kDqwpM+3cH*Zn5WZl%H&ccirysCpBovGhkz?{4 zy!@H7D6sUbMpV!C?%x>m7tne!NI4iK4MzcB*NFVu=-cU%X7EEtg%>`i&Z@4XDurcXDc(LraO zG#|ErpoLA+$26{CC6EKx2zju!x;lwjoe$}9XP;Q)I}A}+gxwL?F{rWbd2_#CA0Qu5 zjf2Fy_M*whbARu7anvx(^+={$cFbYf%w24(t2?;8#%~ z%zo~lguWZ9)2v+Jq1orlTA6w4-;azpcl88)mAUs~uSKqJdt+Usi*|OKezwW;1uF8hZ?Qw~2fg9EASiQv zKoH81?yugP*M?}PJIlts87}0AZNjnD$%$_4)70SSDPYOO$IaqDe?{<5sBV;*@6xYt z!Rz)FXu-NJ8+O{Fr?DDDf}=dxjuHZK(Q4Xk?KF8Da!&2O%@Bzmq(`ryjA!Mwvt><5 zqplJ`ARIvm64m9Cx(!?{c2;hAH%1NFhxh+60&~jR)1pf^pfZdqyGz6!v;Xh7(fMxM zs)RrS4CPQ!TPBE|veTzUAkPsEGaK*t{i6FBVVChv^6=|(TNanCsDy4uQA{8jSF_kN z6n)C3P7q1kr&ld}@h=}l!DvtDD_yUimE`4}b8AcM=vx;lZwhdm_brHdZBx@;sOXy^*LPRfRD!pU2sFau2l7^l|abU710M0O`NzxPicaZDG zR};qLy7{92f2b|_&&Ic)9>|7dCgdT29c4PXT%&{aPp*QaAv@Z~DX(?cbuU{IZ$kdo zEbQo-L?ZNV%kjJ)uB{YMOW=2f+ zRyv)c+`(8zrVxi z2g=J@*Kg;;`+;)5Nt;)HDkQGG9^7Rnm!OK%R93rFenj8<@IPr6BOOxeoGwZ6ZKseU z660)D)lRLO=&#&;XZ&D5Y5-w65fZTYCBBDiA^)D&&%ghSMBh7~pn4s@b3^geBc9eD zzGia8kV>Ha*K_m^;O~ho+bWHZg>{|5%Yb!VM`Yyc2RxqnQiI=rH5ea|%4XfBe-O;N z9ot{VsnR{F&Gy#f{aTVgqSNi2=cYdJS>+HC;&{Mr8JW+0icZ|vh7a)0)0PPC2!6Xy&P@75w(1Jxz&i|Hu2d?uGr95& zoC#;qzgA@cESgF?&i4fFN;*Zqupq@yGL(@9UPYsi=`fD-&9+Qr zYSYN|@I>d?Xxubb6BPmI2ey~rWKxvcE@a8JyN0;C<_;d@Ch4aASuOEGvG=R6qnS@h zt*1ZW`z()#xr4LtEWsSla1tYjLE$*Zu#T>QW`RHc08wI6-lQ@Lf=RjxWEuZCPIYw+ zZIy0uGef3>xn8Emv6?M;rL&R!hp1axQ9P46lBAxoxf<^-KiQBr%#%-AT}$#+Oaanm zN3T(4?1(0Uvp!PJr0f!OA^!=Uc6>o)Zf1oRT+QLO`&M@Dbp`HBJW0PWFaJYE>sa>5 zLiIm!rI1zsO0~XHGhO5n`$fp`dQDWw8@tu^2p*_rwOOPk|BgKP_BN6d`GS|=QNIe% zF|A+bhu`aH4*hkU`?NSCtiz~+12YGpPwHW{5gVZih3Vr76_d7?<7xTL1w>w{Ql0K_ zf^D+kn8MHBXUHnD&2=S$1d@@mk z`P_5-kvz(L!TPfkXPfb2uBcX+-Ur9oGq#;Ia5NKBkn8Vm$RK^C@MrNG4<$iq$hW7R zH(4}S(*VvAUU;VmZnb|boYY{k%feZQG7Sjr=DQ4N)$=ngZhtJhKj!APo;b=T)@0-2 zCtbBw!8`=nrfn>utu&_h*3Yy?%5-5=<2yt`irh3)YdbWB;^XV*E`Kr%SKbVY8@%PIzH#G}Kz7#bY8bV^TS-uA{c#6L60>q4 zYy_yzdc9JN@oFwU-OlQBr-65A+vV)=S9@6epbCPj;?y5?27VU^jXqI_XYP8*2Kj{& zgBZv`jffKd$@wr{76M*mIVOjZ+ZVzWh02hFT492u{$u`t#Q{&PcbwD<8&V_u)A(1< zHk@FnDr(2Vf{Ofe3MC!aTZk<>@4a`QVffrNWoyZbD{b|GPX;<~m!yVi4}m>XAw%9t zD<=`V8%W*b8{dZ^wfvzN>45oKoV#MAMlu|u9wh7I3K6eL?tk zS4-%x6P=F>v6Y)~nuWZLUMGHX4kBqZRy$(9mDtlaRL<{bNqk7wq*JWuJh6$?F?91; z4oI2Io!lx}9*Smp)blc`>w4{I1=DfxO;Tsct?i;q1W!SCF{zCy_5$Q;Ub8gM<&JE@ z=XuMe4VK$=IG&=&FQi1+#K@I4tdZ~cxMB<4Jri}L3v~@zsC7U*cP$l zw1$G7rSSpF*|~xX>bTL{!urCo_~To|cJDbPGol<0gJ?>~Lw5hyaZA%fu;UGIEMov) zpWRj=vlMw2u&6;hcVFV-YPvp_V!pN+L5a%^x6f|^>>=Slf5W%i8)+r26l^n#mTN@bXN z6)EXzao*IzhiHWig}Q$4Ih? zC?>l&qy|bf1R~1b*izo5faaxX*zg87K~*rP=w-mVeLT&4pCM8fKXJYQFJyIkY_YWg zrwoC+pHgX?aA&0qMZ%ZyZskk}vavAcz|ToC2Eb2q7gRbz8s@xb*ZS`>m`i}=b&xWW z&)mFQ(((9m9T?{?HSoIxwYow6l>-?{`tA&Mvdt35NiT`HfDS1}v2?f>R>bzh`s+ihhxh}Pn?*kZ)>KzijN#mNuZq^u z{U$A^23ssT#3qL|8?}=rUa~zCDFvR4e>`2a-yGyq-gYt})Emn4F;ulH0`aSzwZ!|K z16wBk9hSU%(s1rxyW;WST+hCJO@CU3d^4S+Eg}wuucyl+DQ{G_PF>XuX=iXPAY9QF zFwx?l0A~ zl%Xx<|6eBAyDmck^-1^7nuCPE0%f7OU&b*FenD=m1;PWV{=C>m;=vNIvOfxb#u8dYzaC-QrXX$Ay>11ncHkUa`VR!hx_-iQpYST{AHO}OV}@tlrgjG`qt!_x4y&N+Q4QRRCM zfhyxk^>+C$z}SXI9%aOi-c?zH(|tgAYbY~}l@c(#ePUJiN%QPqCnWo<@+>qWN?Dy{5o;ffqNziW|AD@)Fv28wRH$9vD!EMM~2j zyihqojqb1pvuB#*Mx(FNQ*$dfk*f_En@(a$W({jSL?zYryw zmeX!4VgxlN>3o`g1MkGUtu71GWDsi>ncYI~4~X|3T;ASWOdKf9&FAcyE5HD(H^ts-kPUX7@ErM)+M}M!j$}{SULO`>!rq(L*WR@A5MmMPvNm%(EZ7 zx}b5B*XZ)A5)wU$SW@8Vr$+mn^_tc|fA&c!Sn5S;1tU| zA<}^9J@GUlQa|!V3=VNfBt~yFwK#j{1I5XH+Q)XAwBHoLZ z1I<~Kq*IJpJB~Ru`v_YP?}7=7!d2@BoH~`;SSZMm=@YC7qm<-_zZ*1c^Wp&K#-4Z| z*CGF(&NQNqy*Zb{J^{B|;($mvum_$>fc6sF0}}j^{2tkx#4zXydhGWKSQTg~8FAc^ zrX+TTBX>{BY7!ItK(wcM_pbFUudI+NA!Xc6HQJO2UlH0!Bb=vu`1a1<`sO~7j}hCQ z9tr28GBfTHsS>+G4Y7v2)H{^PPQ{08S&c~aJQIJ>Mj1%I6dgf25)G%*W%Z`oAaaz> zXGg1Ts0yzMj0c;L-IW}#72PCVa%A1i%V+zUv#>7kN!@H4H&+B()kI=|52S$`Wqyw+ zGt~Ln=Wk8@G$Pt&Ky*kB9!9fzihgrkKSrIoRQ#BVvQx7qw^NPK5Sd`-VOogiFiOho z%*%K7ikak*K>0M*PFWUS>rEJoQJuxx)z-V0!5v6=F(j}DEvn9y@M+67o(Tl4CAj8A zOlSj=*pg63Q6GebwlC|a$2Yd``oj-72hGqyA;P*aRg35rJE?Zun_Blgebemupj1|c zVKgCtqyiTZO-)z>cm`FS^U*X!(y`SI0jIS26DV3W#%oFCf+0?Zk?-~6+6($fgC6YS z+EOqdU3&xgDJ&0tr4_}G`r=ePj zAFEYCbXp&$Pvst@G)^Z6VhfH?`8nhk1Z|>z!kQ2kA*~G+_x3&vf*hK_8Jf#{p#d-i zzD#7ObjPOR=FKv~tLj#~Yu%fH^j@?g>yR*k?6(5mL5pAZxCW@5*(5a6{#g`OWjhrg zghP?bH5NC5Hqtm@gAWUrREG$=L=Qt`4vk<94He$-=V34mU#vIHCQ4WE_D#Gy{+_7s z3OmWQ7Rczssu83V+lD6)Ec2m{_wfXQEc{Gr?5NpE5TV$o&#{PqJ+EMU?4?w2>W!CJ zYA28eA80qo6tq>=^|Z~zAx-#N#(GkY@sJwtWh!Z__c-!Fc9mV}+sgfppnz$|r0@1& z!x6{;VAt8k8dtc*UPCW8KPcrIe)n&2BukwINswu?GX$B*|M)`>S-ym@GsZun zW~sJ`dGFjlb9RB~LrdE7l@Y&W`xez8=}1<7^C`9oGnYm-<3SiCHAu#h#|)`U8##ek z7&09%+XtAZI>n9Ng3(^$3e(0Wf)vT{YX-9)7;-_*afv~U+&@p-qK<50b&yqXaxzSC zP>eduoY^nYVr23|gjgLgRFMAZlb(l#G(VwRdtK0dbYQG4+A^t-f4oIpaFd()P;RbA z{nDQRUzc0ptnqR(LO2S%;gH#+xT** zrt|vivi3Hr{~cWdeD4-`Ev*MGLGXfwR-98&J>o1V31$*KO@nhJ!piqsMEPGmMg?C)LZVn2RP#y!CjoXkn}~tUJ%nX*fa*_=_p>O;@sjjJKQLmyph=$Rr3OPA zU`Pat)R0N5T0^cIUqvgV#m~-`9J@`ZgBt2@ep?(A7P_RLP4HZIBV~}!r3Zo4|7taw z4JkVugyc8EARaaizsrW3+suJ^R4~hqCS4-y$T7Dl{e0gV$1Ah`eWo~)gqu+ZN1^#e zeXHRLcW0lyhd%EUKY!!(Y1mEq0Hzx9r7m6f5_~!m9+brAkH%W(Jh@FUk7P{J4;+~+a($P!8UiH;5pi1r&jp-sXK%36%jhR(2(D~!j*otqy zLhZ+&k}AQ+qd9ru)J21P(gWr6e#HK!{(aaUDX_|N$x2>OMeHK3t^4p{L0aLtIH@1x ztdaqK8ELdJMnsk-eU9@F=5s@vErSRI^5nwZXW_;uyeEG>rJ)GFkdpiz7(?V zA2YajUUpZ2gE^5@pN(z#wRK5x-=6wa&YtUO&8!ZC+90td33pyLyP#uhv-&m9nCq~Y z^O;%S>-_Q}%5~#nA%oFcLs$jg2X2({_XNtomk?#_J&7clTE%99JHBl#25H*hsM(W4{3d@JlIYLCO6!I|4ygvxgF%49f2)RDxRM@e$R zOln)1dWoX5i0VfWVQK$>5CUL%xwg^rX{`WizI?j;9ehokhIhj0BWOTzbH{h!^Sn!H z8*o=LuhAKm=`hDo5#3qb9%nMIHS*X+Vq5t;I~5-xX;xD1!50g9MF6YA^S&h7q+jst z-u3K83*AL=UX{n0mJ;XxcZ2X=u81EZs{H9f^-uJ*uQpGE$6u&jQeAfcZoZ_(e5VBe zv+4=8OP{_v?|R6m3kZ^Ldu$Uy+@wyJN!R0x)R%bVx_UZcK_M{ID%+dB`70?cYBK+ zLG*1x0#2L3sTIh9=2(tSA=@SPP zYIZ9e9m1?nr&1&9p`yZ|2Tu%dhj@Qtpo?Hwf-M1>&YOWs-B$(s1|H~M2fKbCSUNKE z4HS4zj)Ql;fsC*l&(1tMfakBhr5oo<0oWedv(WbM5TI|p>D{*-vk$QP{*6udRj+*? z99O8+;W%`M)NRxsGO$R~%wUjvK0$O@Zf!U(*-XlM&tsiJeR;MjT%2CjC-vW^>ZJK^ z26W_C+{!$Ajo=|P3|@JwpADbSmk$RC>jP0ZZTrYbKHzFHbC~P_ZY~@) zyiUE)N?lN5qM4)9gBTqQrB_>kl>-E*Uz!_o4YH#J34_B);^2gAP1Q-f6RT<8ewg=2 zcr_*TBFb`F8SSNT6yiAzF4P7mGr zq>|ZF?^1vWx+pVH7Ls^|aGj=-3T zI?&B--Poyr;1hpcX(N}O@g4nCJMGR@84bWOE~>~PhUddIb+4ADUdPvvx}#seR)jB% zA9MW~kw#xJi0(++mn2sFygVr+=>)N<>a(+wpJLNyey>Y-1U4nY_77h9o>Dj4@)Z{? zG5dnhLO=HfGG5-acHkbG>s6Y;ERy> z@g19lf@>`$a~K7|)7aY?*WtwE2f)6Ds;0I+qzsGhrChyE=_YyCUJ}mpJEr7qrPM@K ze(D8+Lv3mMFUpB*^P2|r;~QH0c+!rB%fvQ<$GQ`Q6zvc=7kMou-m}iT^7mq3aq2y& z;%m8x8j9cUdvR5J%#@WWd}jtc&isDpvRb!;AoDcCEsVU0ug970V+*xDylL+uzMl2k z)|)gXgkCA`#Y*NrN2{({RRfb|DOEy=m(*u3%-+g4dyUY5_Y7WrtDiFqX_oFG-!dyq z9S#<_0#H~@>&UPe7(heMvco^1ieZhP9>C^4(UwO>x_YmV(oW}{#>joJ_)w{AlB5(I zkk&r6Lto54O`SjcNI?hCzTA}Uhnm-~rYx-7O+R~!+=Z13PA(Se65rmXp7mDs`p~Nb zP&jLT-vTaZNc(-4w|o-q^LM1pKPVt3Cw41v|-=lv^OdECqqrlwO{=h+;Pzid^x z^J`CHSkh$`2>trC$b-T4CxQE^87b4MX8Eb#+p(1j+GLaiZhrb9OI;lja~NX>emj4moJ3-_vV~IW~mT zC!`lXtAHDTOGK4-7>#D6TN_9llx&%dAF%LshlS0tBq0JAeHu< zxtoQS91Js`k^9K~q@Ljq?{!rcH#XVZ57=FRL(2c4@Iw_2A*I~?LGR#)Uo1XI#X#4~ zkhxfvJUz;Imsn3~Z@>MlD8GCri8D`r1+8c!Po&0N_zpLDSyT3SZS1uy-(>hbd=;Sq zUvIXQ#e$NZU}}Ac0H?Pa$>IRdEOoqQezPN3YQ(@`UqjYIc8Gdn<0ILEm%Pka*f>gz z5|mDy;7Qc2DaR&JEVQ_Md^NUw!w{{V&lI94EHd~oPAAW|89@pp0O2HUHR`zFDTcPX z0UzM4&{r_^9B!MBu6?f~7@(h`uTIK8!X2B*oX%5S#aVG?z0Jx>t!jd=*uXm=hr#8_ z3IGR%XSgqQrj+lUhP;oqQF>tzjB=r>k#;78RV*VL+}CVdwAj{_mn<|rjgcUJ zunt{k>yo{8BgjchZ7RXlcidr!76$u=RC2 zA_q@FQeKsNe5W?1Ky@WsDVMaTGgdH0?Xa@or7!g06!kzNXBx~yx&=w& z=$#4ucc~=nDK|*Ocvs2rBvlgWf2V}FI$3x{NQX)~h>&a2C3LI&Qv_geF0#u|9(=?M zMoL{dFKtoll_MXU9NKSkxgY11`$MQe#n=X<(+ehdlhn zX_}MjFNtn_{+O1a*yk-Yr1v0cC>DQN()&09JZT-dn;(1&UklZa9(-GxtdQXOh}cn` z;IBx?K1~^}Xxa#sG$TkTjz>+iD=)IoMwuRgzC^EDTK}B~P)|P2jC8fX%^@@#XO-@_ zdj!TzB}&Sxwb&7%m|G}L4zBJr+7J8do)V+&%T7}dQ8(TU#UaoACm;D2@J z4T`ENVe=#pVvoD5zdl0np+$`Yw?fgpclBPS@L2+*B>W=R*DpV}Srct#ST_{7e>k8cTb z!-)*iDx&hTA~(5JpzF*bEu#2)FSNw3V*H=;?uZr%Ftl>0V#`ze!yeCQ-6DFI=#SUK z3yo`h(h5p{87AcWvUM%F__H`}AC`k%%+zzzczXB6yB08Ui#obtxTAV#79~V7A|+CY z@-QT9>=2t(HFYgA_4Ji($~d9*>Cc%jUR|pSQy=8)Q3p-`Tr+i9#m^j?Dpq%_K{m9| zxD`v(%)t% zW`vQ@mLNm^Pec_+i74K`PjZQ%mPSGx_%4z=?g~*Cc9cw+xXY9SbU#S9(bmJwSKBP% zO#E1YstqL~b`LFdcTTTUaOt$Ro{Xv z>OCAt30Y79nMX1RUbhE_<-jravYk0Mxd4^fQh;AVvxc!!!U|unv2=^5hJ8v+=Y`u@ z59W4(5%NX)`ESp!YP?O<6YJ#C!}28|!f$+XT>ePlcjr#1 z|NCQ_*t&okp)?Q9BAa`r@h;^ErIqq`kxWN&P#7#FV6@FAAWHa76l7X!Z@Rj zt}eqkC9a#JF+i~c=A2jN!Ye4|uKuy>E)(fzy4~U~j4;BkcL? zcPg_Z0}-R%2uk>h!H||^9A`oc8~d+?CM-)vFxAWYRzp6XemKl5cEN#wmjv2g>4+ zapL5ieqs-yXRdpUJaVs>)JN=`?JM!eO&V!)LZld#ua%P?KPK2YmxQ}S^pN{EPRSDb z4f}r#ieDl16FjY3`-#!J;>Y4s%|&4q7MSKww2xI zjTZaff7KvtU+i}IJ8#hr&m*s-t7UHSs)1emeFd_aH-rB-n5BP+t+Uo|$ZZdmvPG;?nno^jNG+4IEKri<58?mL$g@LQyIoI$XBDLLCNs@|-s z)QdAgX1}3aO+z2v7VztB7Dozp010)0nkaURFm~9yovS+F@c4S>xli;d(_U2ZA>VA0 zcYeFG&)ePd;3CHW1KmLS;<1>2+#v5y!7y=H=nZ^xMESoEP2^if|GQ8T_dd9kK#{It zn-eI|wS@}>sMsASpKIjiag$!aI6}}D=@-7+T~!AweYsCOV#~~vg$RFkri{h(w+2`r ztf;g1DYL`VC9h&QtP%P4Z&@2gE*2%v40^v!Xe4#E-)ZJAXOrs4CGlHt!NG$6i^Ii* zH%CUU@_&+tVGz6%x01<$(dwWSH;Svg1v*VU?MLdNYZ{x0Q<+Y@}kT+)w!oX8;CJkA^E0GS0F%?;ELPIih%aTF@h`ly7f+TqyUrUa2BiS$%qqn*89aiboC01~4Tt6IxWry3e4#+Ju_-L-yUC*?9boX3B%ggkrp~{e8mN{{T>9u>>(=S z^TlLp4&lJ5?q3gUFl~!%ZoiNh^O7FEQg$r=#~?2p*NbmFeUCVk7pzoY&QeQRE&|g9 z&`MT4@GbS8ZQXUwkLoxWpllzZtw(cc-w_zs=#+G+t!ppz0MZW|5A{%S%+rnj(KOkk zyPWOxY5RM|Qui{IK{Xnge(c5cwG-h=$1#MDVre_E7It*!6j+fxU9PJZIUyd-E=MRJ zA1$0w|5xq0+V1N1K%$wLIgYbXr>7MDS1?veP@~O1hcHH}-yyUj*%YuX%3m06s{Iv7 zhxn0cjD)yRkeD3XSFut=y-#c>55}m&|9en)_ww#J%*F*}Yl5}{?Ig3?QS3tmH5hfK zP~ZL^WiTvu0FhS#yNTEmHfD+3r=aZ7CE`G2`X+(X_V>}w?(NwHNVWu97oR#84Ox)m z!7!PaaDeJ_; zy?kbl7eP#R_xb~r1u;tt%QKN1j)*aMywC>OV2IaaObxC{r!Adju^dNQ<%jz=3SF>( zw(zF)Qp?>2d^^tCiTjNDX$Wf!D9&QkrA2>)g_W0tdVQJje-MMWi{uX?A=wo)2Qa^x zWS4~q;K;o@0W;V6bRogE!#F zJl*}*_j070@Rm5G{uMlZ?GacvMQHj9Bpd%bsm`e1QTnTApZ=u2h(2gLP8rt{ua!)b z^!C_-pqR(JPQLS7<SgoqEn-E%#$h3C;kOMU!OIy!qFmZDn^cp8B1W}-tL zCP9&N%rglasV_B*@1*bg$5vFpD?xhQHx}E)@g06#q>EAX8pVHCY2Hk5NJB(x(LA63 zgzscnn?O2RRdhxk7@p4j)ESL|+6x1^FmeCM{+SmYa5m$Y~ z(scpeIWT&2P#GP8l%fZQQ5nt2S~!mf{mr-sEN(NkS`qTiflN|$Mo%X7*Xl0foi#Dt z88=#mJ<(1i9b-|wC^|3AqpL|pEl64u0u#+gAgcMJ+yF;FxWBae=1XfC4hB>ny?>wm z$=iVUQ}qd0X|c6OoeN!FY#Rq?rGWEK*Vok`--}Vnh9@_7zS->4mdFkPk^S4e6ECgDdv$C?P`SPjE?Nrw;tL_O(Ygp7dk%59Ff~WEhmVA~ zSm*|y^;BxU43ok7VEwQl==!o){3Ga9vpT?Fxm_U>NWO_Z19IZMlw9mN?9=6q8LN3N zt6!3df7aRUn&G`$cg8#-2KN$`IvD;sIQ?HN5iWeD0(nob4qit&(ovG^y2}SIfTwVDnOuKFxfOPY0OBRkaWW1aFMo=nY{^V?v{7 zZ^RnS0&-D7ICmm3M$Y{X=j@~j{C}9RfJ+Nf>vE7Q101QFpsU{Fkh=JRC@iWPRoo2# zvOh3l&sUz&bI!1uFUkuh=g(;u)6FM!7vPdY>xoZUHvy;Plb%^E)zz`!x$p>Dkwhpp z*15}ofYqhg+rXYko{_;A>D_g-IEGobXd#KEL&OVWbp`Nhlv(?1ROtX+2^*tZA{fxs z_^-ikD;)4-P8LbS?AN)msU)&=6U=oJ?&~Iu=q897$-$oNRcu4x*g#f_W6)_1snHhI z1;`($1Y31~C~^@#oM({GP3iW+_AGlo@QkwmLUYyMx9`G?U7nXM4|4Jb?@hpl^b65A zv|5YwAne>@woyH!-i=Xo_=Y6JvFirVNQD?N$*fb15DZda(r@E*PU?rN;YmbuVQCa! z@in*ZgfL0KBJDbhIaW6?SpUc}OaQENh_6Nv{1cq7@?Dv!?Q2LA)AO`)m1pQ-;1Smx zp5v0(d7Vsg_rJ?iZb%LWlH7ZzehBLf;$18;&kgnCEHSo07NO>6T9^}tTu%fpTENgo`Ic5buOh>+U14`-$p?WpC&MKo6Qb& z9VY0~Q*GWMo!Z!-x{EvPCF7uZp|=hQ9KNi(|ICVIr~n+|1Cv5|SK(dB*|Hjy9u79O z9&-AkxAZab9=EG4$+`rFH-I85-cC8!aT?ayTNHbzSvM;BF z-g#O-5P8y)shwU_A(d6?V)OlIs8QP0ktdLrfg9ITug_l7ob3z)DNu=$tC!kual}0` zGL|sHfUz_QSlCd38CBwk;8qUfzLTI`GGl57w=M<1=$7)`b#EL}O7nx?<&~C0SW0z4 z5YG{%Ovgg;x1bfLkqK^v2FA!eoapX&Alr2IImx~VLD|TW1u8q(?y5P$#5=-N2iDn2 zfqS9Qi~;keh!?Qk<@}Y#7>M};1fMLhOv42t`>l;Ew?U$bXWOC*&28Ef!%}(;;FQxeA z3ieG(C})z!c9n#iFc`W;8HH^7der}dVN6G{3Ad;dKRUjBL~KIv4EK zcU&3IB6Flx!Oe!6en4wtm%}GS zH=X(0Gn%??jx$U|c)dQ2wp2_g=8;GUuMBdpwHGcULMf-XOqnVLRd|G(?q>AGl-W1z z!}AkrK51u+cM;=qN95e?ODGo`vfuV4gBH(37jTar`w2jen=3Qi^iAb6hrGn^J43~H zsAObJvSsj1=HK&)Kkw|M=ZPn_kA3R-v9-O=cK+huwdg;xzjn}NYxk~wYy0t)TR*UT zmmR*i{`G^wc7J31AcWhE+m_#Q;bhqRskbb0&;6gj-C+S7E+@eC&*ZbScp$Ro90%Ni zIvnhAiMnopE6u)hZ6i%OeUZ%MTCK&Wyv=%Z3l9OxpHh|jUmee}`lb~KCJMZ30RF;K zlZzn)I=9%e;eJCrx-95s)oEXqpSeHFFTQJl2-FG_hoL|LzZbHX3D8SO%};F*uJfM9 zp(HJMnySVI;31pne}2XA@|lki%YGPzpXTKx`&y{n=Z*=%4#eKnd*#__aHPLMV!sN>!r+Z@S(6Jl#?yb4u~4+=P>BusatV1xvd?B<{A|Gfsor= z|MZ!fOZ`?=re_lDeW1=X0KDU1WG+VTB=p3%1~KS|fsnEvy}&RMUrJ!vd^p_mf`9HOvjrHr zJ(T$*6*IZ_c4&WoVkp9fxU(C(jhe^=Y&fH&t0YLM~7RV`@C-M3W*90p{ytpkGjB3Mh z#hK8UrG5qBzLJ)%QYa<&+fpN2xJT22ok~^AX>x<~Fu^lD27YNg>X-btlBei9L4MF* z<+iFBnd6j6@F%ruOXmNZkW_P4dmp!IH1P0zE>Ch>)XGOza+M%=>VZC9ZcxRyjo##C zwJvpQ3krh1;qb^zu0nB((y2hmkCGqDxJXb%M*8P0wo(+gCVfi=L}s#;@s)lmBg94b z|B`uBdXjb85)ouSjKUW@%S)stzZv>Lz~9-Og3R3WlLcw7CZXUVVklUK6-Cr0@Yde|7zt2 zt5tfLkGKEkZy-iY7DD!K0>avtk2nJUo2cT6{f((QwK^P3D?3)To|02$#^G~f zXE;b%S`h0ixjw7;|0qw-_^O4J%kj4X42h>wb%t~s>9^g?4~$zlU4MaiyeiTF#^NR; zqQ`VqVzd9EXo*mr?reH#GBX`DFhmlQ+3OepVGgx(?3fdL&fHGgnjnp}Ty2e$##(N+#!F>2cN^oS zvYLkt$(;&c#VM4=2Tg}umdCP+Dv3l7oq~+KW zyIjxZxvXHOLIZ;=LcAjF6-!p4yE4Km6i3>OtnDRB5cga~Z?Saj#l~vvs!OJSub4G* zkVZioFNLLEn;LEv<56`Ckig(*oYB2vYU?YJ@wFKIt#cg7wd>#oa}m{n(A`wn;}Z6U zHy&(Vs}p2Sn6nWv?6iCD}Ayt)>>9J!c7un5yOpXdx4zBL#=0_2_r%_8Mx0&P2=fpMp1XM@S0WE zm(0y2ZXs=7k^5%dcW0AfZw2g!`F_H;HojjW{kAb&5|X6a2AG4eE#`&y&|}G1Czp#T zd4%q!!A(I)FR^e_glg|ysVt{tZX}dcFt7$M3*{+>j$wTUafk08L1jeEk!D7o8f7u6 zv7r(fiKeN)cqF51Pc3?yxODIc(uM0RN+xURSs86L8#9p3$Z#gIGeyqaZdTE=#?EFu zTRnp%GL@Zy!Im+egDehn7A2Fl+^meTnyK6kkmNyPe4aXE z%*@MZ-petqjJ1K~d@PBXZ*P7GJjW_q0KY&-QL>R1WanM!to=Puu#J#{aW14tDCLBY z8wsP1MU|D!McF1^Oe!w!#9M+`vh_`6l0|$knRGc&xk!0N@|g;KPccex%3#VdDjd~} zs0&aZsewhfrWvZWL_1Qaziz_mjkn)Q*)%e4Y{q!-CUPP$)oWVYth>1p^XkO1BvgxK zTM7*AEDtL@$2ab(DdBBRz0u+Bq)uwK4vW+&+ik?OKAW~&wo{XFXGA+kc;S4)-76y_ zyP(~GW@jEguGaICAL)*fdf?^Q?@(j8o_1bC5$BvdI9p~v9C77Np0~o_KCKP7Lv(U@nEae+r zQdU@r*_g9kVn4@$$1!0}u;4ida4F*I&&{2?*F3aK%5?)eFT|S4+S*YX7MrJ-?vPAV)!SqLa+ZXsR&u2Ke`sR)1G69U^%JH z0x-R02NC8}2(|m`!RmA!n6tec{G!+RAz=XEaz%i-{l{@Y`*`3aDSX;@d3dC8a0A>Z zjM50vbV-6p;9z?RUZ-ocHG_QDiB_;JoPSqjlN+2`Mj&JXw}SlDL;xbdtKdc+ZvP#M z15ZpGmlR1E*uzY5#0P+abg#A*M`>^*05V5{K@vbf;h0>4fVNB_dckO2KLHe%0NViQ zA;H@Kr7>}^*}$!TBEp{Gt%|!L^q3@j=e#ry0eG5#nSa40+aTxWQeZAVjcEpLmobTcwh20e&AVeBIvK&q}l^i)7^Ae?;WX!y4CEi;%BPf#(Y^QX3YeAIK&VrI-ydZT^t#z+EfO zkm>+LoxnEE%oOUX!n9{gor@-c=Xc$0$~)s~B%bcB?b9>$il+4&-Z6xMDe z;@LZUf5^AJ((Y*u`e*tR2^N}_&WG=SQ5g|SqWQp#*FZ;BhpKMzgc8AfVE_5(zJxNu zNZT>nj=AIN;%oDKH>+_qz^#@x#S)3Ql}H4pGW?g8Lwh+tyBa5FjQZ9ZovL#=;ftd_9gEY)Y6L znX-T;5-R7@ZNUz`K~&+!>k#4DBQN)fz>okGN!k;L@YsO<5BgMKle6Nf^?-2U4?*QV z4*=Wu4~Tw-|J@6yfju_R`~Hr_<}ev1!{kp-PyG@7M6!c$AF%n0(koGZft;Mpmeq;= z?v!%(pP)eK=W%PkN7Dt#s|{e-$*yZH%nDMbphnAo;<@&z4o$UJy}5ztbr-G6=i%3> zL_9Wh+9_Q5UKV;Ic6LYQJ(K$KrJ%VpyLQgPv(8wq_g1nw{B`i7CE3I>$C=3dY!UwK`!@sEhyCF4fo3`0QQp&9#)wNupLB%&}FTx}f<(3J3Yz zD!6hWpXC@1<{NZV!%_TRM5QsVTPAQUMzd-xsR_{qa$ZnikiaMkYS$yS;XAHTOhPap zBt%Azi+i3HhAgYXH9zA}Yts$m^;V52L^Kyoat^Kh-fvdj)2mtP&3-lSs>|OE>8D(uu4hx1|r!^-2msRmUxqrV-aQD3DqA{aJwfJGKX}s=6 zl3c7IM9#_;O5xt|xIqw$WT8&7xoLzoYAcmFI+EN+qUiB%(zETYwUy6jfL^3X|grKo|p2`Kq36q-n1=XP~oCyatA=x8rI1;m^W_ zHtd71fWfYlpvdE9Bf_A2?v#64DRU6Ey-mCnPFMi*m>M{V@K0RRpxcsw_x>l9c#5p% zvXnqq&@fnT+qtSa>Pr?SGo|t}m5+}OLZqpRd$0d788Ok=z=34YkKtv;Ru1mpaL$=r=p3RCv0Q+$HN2?nAN2IdbtEZK0RpmS}x_p(xA|ti(wNIZX&n4oW_u9Yru2dKzTfF}M1kyh~x}Z4!J& zCskg&hKxViq*mX-TYvp0Nsua3!NR6PD{YnY?$D)s$tkCBe%IE`C2#IlHTPTi%U9<7 zRBq#*cLsK{;v%YVNO-)wH2o~;ZV$b zyfwH+=Z)4Z4;iOmx7PO!_0QEW))Blp z!#)Lj6DtgDSgZvx167EJA6I4cDeUKB9O2rY2aC$Jgf;Mk5O&S5teX;vV7m}y`(9ZT z1u<67RIElDb6jDxFsYE7HpdUKghZC2IN@f~d5-}oK?z1-6-vzuTe5am+YnQFS>8YT zT+N&hdfWE^-WC+4Stc;;x`bEFG+6)=Ms8_+t(2MiGnd3O!5wS;=u~)`kS`KDWq&CI z%t`Z)3$tDsbg$^Y4IbhkW5nLVWv`8vj(%5WMA8Lz|J|Z9M!J;%`~0%EoZNZ$4<>L*8b{9MCO`P^n`9SJPgdlo>Tllo>#M#TzmN`U zjG{}H&Kc3|HW$(SJ>&55Jvjg~e^=zr>E`!9F_yo#(_FKGYuuQ5*A$`rMjL$e;szP! zG&cFdC?>S=)cZE_TN5Db+Bsf@^QC>fJA+UL6b+TabV1qQ$G8h^u+^eG>A4i`?G*PC zHGm@6v8kPNSWya|PeWu8U{0R_TTbBVAI!nM4fUGBWPZ~ZvgXgbd{#)8Z___TrSYcy z%^xEOsGnFqI=IELeVc;eg!tZLfVLg~Y&%c14~?|%m(SP@$B~YAWB1N=y?;&+V5Y=# z6lqD;Uuph=8*;BV&bCI05+zua&!CNAn34ikf{zY>w%LWTPzzQ&I!@$)7vta~x8JKNkZ1=XyX`4xz6A0D3iwYz0T^IVW;E7pt9zc>N(!G#^z^$m z;8E~u$J1@x-7dJd74UkEj1nj~ffGo922Rt_&*%@Ed-?msm)U!G&}g&erS$!2`$7dU&G@*%j+YS+urv6w09yU z+ykF;J8bF<`2e%9@-2rD^0)#E)g{$R+G?tj2MX~yG9a#-UE!!^6el@7{R>)wVI|@| z-3R7iMxdCwH@bwCUqQTHtS62?VHRo>v5EqXz51CMy7SmTz6@dJ54p24dvcJ3AJ0e@nB4EGvC;ZdvGzH`FF`o4)2 zOzmlK1WYM~cz~KMh#DLv+kFw|8dx&HGvFN7h@dRn`l&15P&%FD$KYhd7fA~%9 zwU@Tt>wU|bR-!vN+;7Hy`s|%1F6*YeUTqLzT_IOoMr^GL@9Vs>0eRU_1)5i>SV(>d zcWsD|=`V{MAK-&0@PS{2dPX0o9+eLr+RuTe7)|vwRL7YUgp?na7LBvi6+4{M)Um$S z{?%WgIa|+(6M~jHf9qys!MT|pJFzAwl`INY!VNPuXiB$%L=(eAXlgww$wEsR)g5Oh zY)~P#7!W5JOJtuQ0wQ2BL_ma!<8fM(uli7EVWjIEFDRO-?xRg{Yybq$Vax`&vw`jO z2j1#0DsED=Q|0d(Ew}es#e*PA@Xv;ZhlgDYD;xFXQGFxRzb0llzZzZjNkeFe_X+>e zmJYQLST{lfC)#?dYIh)tr%q*estDBnNxtgw)r%5@wq+`kEEkDQaUej!BO7z9FE&^n zec-Kp0bOpm6$)OPN;(!7;+dUc0}o2Z9rbne2n%nJg}5WSV^!l1?QuZY``fqeR8XEz zh6;d{um-k6EXs2LyofU+)7D%Z9{?F=1wkZ&fLI=)z&i2^ZlE2`1sL~%K|A`jngtXw z@+{bARYiS$$QZ{7us>yWL{jVP64P{kbXqx%X(JsLa=&*^$vfpcbIT~E^W7dS?F?&Q z%B*aatBleXO;~Xes;y=?Z2;n1uAE$AY}oRh&rT|Du8*EbrG67VBPK(w8lG=b3WY}9 zEqEgnx@tBuNup22lQ*y+B)0e9$h#i6n<9l9@^tf;pKB!=71&F&34U1-;U))2@z_ZI zpp&)U5*5ee$*Y-3<>UVGy)^v`7hl2swsmnam^3$k)!mxrez{!#=Jh2{{k@9tt`gdR zr<1w-GtapdSeaLf4coOkMXR_vORzl%T+$n2l+%*#MUsi!CrWxM=#_A+dSi5?yc~?x z+qWCbjB{8wUGTS=bt5Z#WX#0@iPi!iqdgw4(oLwl7{6iFTC1^mG#BiKwK0QN3C0x732HfKf39$Ek$YoSuk~%%d%@%L+|r6 z+kP`L4OliPc@CnS)l^`iwsRUc)nfUO4FrOtx#T-Sw>;lU&^)+zhci$onW_2pfv6yu z?48m8^@Xc1J%u^vH+D~qchF{2?^$%-j*Q{K~qrg;ialoJbH(IV@7=jQ)K0jS5 zhX8YwXnOO-=j?kJHTJ{Qv4C%ypNsr#H*|>q#)W?&0TjC|J#(OuLxC2D@V&UVv zfe*mOS7sA8uk`vuK&>_*C~tg0eP-d^?*}*6kCi5EzE71`~mlSNf-#p^u&$I6dCg3ax-s=2_ih6$l*a-3<{6DV^nNz1&1t^tbz zmLUSxffOMci%cs_W|4|?1~O2Y5=!>DO5p`uJoFff+U^x({LJHX+SeM6}qGH?Gwax?YHrF3Y(2iA|FR4vb z3nLvPXrILGLP4iGfw}bH?cHPuGs;bAmb|ZZ7re93Ey(>(6uD-%yU+C$D0z9-@jhq< z^d{B=(+2@#L}}06j-;)3zg4quu6+I*d_lzJahS~QvVcyx0=Z1!?RNecMp)TGGHbcy z)o>U#kC`*icq1wV-06#+@uuE-M__Vp?_MkF0gW&OJzp@wQ(U}@c{a&>%6l(B4+)Ry zaiq&qjsQRa0uX>;A3{a3k2zxh#ZIGpx_xa?0U?mec@+?5GCTl+QOXbrhSZy@XHCd5 zlsr#S7UX=$daaZP=pb+yUa4!XTD9^$hqI}r+M^do5?^jWn_yhJ&N$Xpo*-xnt6Wv7 zR9T)yL+!o{T=-mEI$wMm&?wscEMrdJvz(MBB8RuFSST%EHZ&_!sbn+7>NQW92KG@a zuFfEDVopTcK}Mz)68A*QC2~cM^sqG9S*{HdAqjvq-VOUBIg_Fp9LqFC!kpr;C}JSQ zdc+0`Q8EmkVpvtv=KvdzF(jm^C_pf=z_?xlYl%S5cEK;gIFk4b#~jcIRAGFlm9!KjXPBSjWedU$S*iBV+fzu41&_Ue55~A zB>1|p{2jBwX8Y#$jLf7Nb{FMeDJEm-S;Pr1iBB(o%_V>OZ$Aklw_M)&`c@7Uab5Iv zCKE)!$?Dx7tbpNHi!2_}s2i=u+4@&YLe5@5vark`KgasT0p{E5pg zz5;n&avKOY4b%;eOq@_qEAb03JdDgHG4w=|bu6^@{~!4S)rQ)EFlX-ol+%?~F(v>D zao<}6PFh~e$}S$j5lubr0=RpM+H>_&zeMY2MX+ba=53Qdx0#pup|9%BuE?jb(lX}r zdx2ZmScXwFg`;?erZHS%X%@sI7noJdz!uU`3S$Jz7Vf|G{Voz;fAOFF|I+@D8R`#h z{{dvQyk&ux1L7FjZKNoMBpN*aLXPEeU%64PNNYRsF?jcH9%E-&$^3_0Tw?Xn2-gSW~BB)Px> zvr0)B$H=7mWjmA?MHDXZGAl@eu9Jeu1HZpFWDY>1&@x;J(=BGq>|@5n{&SPg=p5UT zpk6sLtG)~=e_yx6fsL>E6RMWWdFD!)9aw?!+gDLS+c9*|XOd)j6&7lzYDJLa=zI#Z zFJU?xTX_P@hj1Vnje@@4ONJcHvQ7{Q>O1{q`3zWwE}gCuLHqO8&|4XaV0df}XxlUD ze=MX%n*8p!6YZHr#_hBN0N`uYee71N;`r_OVVw=Rtu>coyp9Efa24I9v%db|S_i6A z?>lV&9X6$g-yN)zxSVTIzqB8n)=B;%tT5O6$y$e>&E^ETt*QIwQ(Q<5ul%!(#X}eM z>E{3(ngZ8fInlKVbDH$`!mS2j0~r_Lrf(}o6WqXSEEFglC;kJB*Saz|9~bSMG=u7-Z-@J4Ob+^+4cS5= zD@nh{6>2aLQjk1&_~NU00x4#56_VpGz)9sY zYpk{#T~yHieoCg}goxEi=a>r>!6aFD)$}>&ZHgfrg@$KjS=`}uz`$QKT&~Eepr~s0 zOUE30%)tAani|@!PpbzkgcouuQXG5WX0lQiWXlxM#44HWH1x}tg>tQ7Hp@M_XfLYXXkYM}E_VRYRvO$U5X&ST@DsjN5Yq~r%Y zZB6)_S0$skKg>cI(#Oiuk^&@UTaJZBuFel1=4e&`4lnvt^*$T9+q{wzJV0d+FIQEh z0r5`9&ng{vYY^$vr45CkUY3*pkQj+#qy``p1#E7?^NW_4i4LAE@Q7p$!O$_DKm>Mw6VQS zH~p(WrG<`4vacK5dV z%UNMa6^sxJdKj^dFs7y0C#A4Xgtn9t+@n0@vaeAByEL5~3!63JL?q>NJRv}EN$Oo3 z-hz`$D~C&_{sDavhG77G6k<^n$2qbvie-h(DZ^gS}YeV1i?790;&7nCmVle2*%*%mF45$Gy<9b#z+JpG(KlZ^ z_uZ42D_Lk4;`+``58|Qo(Gs8-?wBSc>8{>O$ARlWK2?DH@>XP;;(w0;MSiI1h#xX0NePLEPl4qZl z5==H<-1tmxc}6nvKDfJ`6?QFOlL8jGLE=7H#@tcgL#MMM_Z=19>49e?f;X$4%4onV z11Gn$%rTmvLXVva$0C1nL*VrK{GxSHE_~|+=@(&YOpL9DJk^e|UX&EpHs&llG!^brvUG9nR(=tsX&l9@6FNqlA24wS& zo6>RxgFWGyG5*efUg|Bn4nO4D!@em&cncpZxEpNkDdC%leS4szGqgNKZ( zyxPbAyo5Z^56^hZ;I6|tQ^Nq2$z9u68N!E~%-*Jf6?VKtd!q05{pyl+UKzaFipO^+ z`4Y<8!W_K{Z4F}Wci(JgVf{x<%#w-J;dLB>H?x2(PnZ}HvK?ObJrw(M{VfL)Mz+H1 z&=%V=JUlQ|F`KOWe&GB=iNF3t^S+ah+O>3l@c}bLjZ0qQ9y`S-IvOpjbVlNVp#ly# z!~>%wrnf8VHqHC;aK0&9XZxMwGJtg0%7p?c^T(gJHr900XtZ9FIDK|#>bkb|oSOm#Z<1zpHS)bOg2|N$?@qU<0M_->DHWhE? z;ePy^v2jwAn?n60T8w_kg+>6`$KPJt^^AkwceVZfOyBxriK`|%>3msjpw0BX`m6ij z$|5Br$50FJ;2}a^>1GQ~vN-~{5$Na+9J&%94A#iHrCFom)>(E|YPkK>)&8MxzLbG$ zw`c$Srn&zw3sB@Ga#g}KTjSdjCrVo3H5mk=7-5_0b#3K=DZl$V&WctCN`63S7D=Xr z_c>;@Z90AWXZQ;JX`y`fx!&5X3_e1kH*=LvN2fu;p@l`w;7*xZ%OG>%E#((dfWMNxrjXL{ z-3B7zFbf;cKLl-J5$NiY0UWW~P3I8Fz$1MG`WgWoQ9u-DMdQyEax%bxE;P>Hpa^!t zK3KGiIFxjPVj8=gfXH^4vM86&FW1DG;A|tOZ1o@y8{VuqV`HgiyI9Rb3JruA`#b^h zPV9C%vt-3(nu66p&f@c48?iPYkhiL#o27i|Vg^_RSl+vOT*oFT6T3{#Cnz6dmlKec z4@)8y^Z#c!9w*ULd`+o?oU!4f6GahMV6Y#~z!}(aSR-IDT!fe)MFH7A)eWnr0l@1V ziY||vOCbrgLt@IYtQ_p77BDO*lmUt2kacL|6^ zIFhy&g|X9LN08P~1=gSTx{vNRxyQ9DZmwCC%|cqtpl6fyFI?NY~=0)j?Feyp!X*zfY~>GL0NrEyiPBcXqB5K1DBw`hNbc zFCJfs?4R-QoM>nN#+z@h@UKiX7AqDCJFg$-^J(^7kAUFafl^zaaS4 zxnA49kJEkHwCGCB2lXpcSn(tCSGlmYt2Z>$0Vf zGdNMEC8;Iq^M|a5f?4I5Q5?)2oS!@0Sklzmvk?bqZV`jdTU{yDXXAaptm_et9IrZ^ zT$g?Vfk|D{X3M#u@6_8>6zQV)gm_>?*9BpyvX>hnOc`KSMobA5q6FoM#0?X2E@I?3 z%oYrVl;>|vPEDCDv#pF$*sZ6tNK()H zOGYkLTnli)>FmG8$U{MvGCFipgiEccyr$qWnHp>cz3KD@y}20``B%}?m3l5a(!JJR zCG@~XT{kxCOCv+7=N!w{_AUEXStLQXjMz}gV5J;6ky1nyS;7H$a4huTFmZ{pI`q#w zLQ6kz2E&M`gLTYU8>bI*&gebvc>#G~ zok9_Ie~Q-!>hr04a74HtIE7jG!{6^QpPmQa4Sie5Q$VSO{gAFBFs=vrmC_GM8(LVS z-~hxx0%Sl8#O$?jlcK5$_|r9{>LFXBbMMy2k38}c(!JfS)ea2C9&njz&c9bSSEFAH zOOE@(D2$57v>!mK;zRtV^k0JyzluF`+^$+F$6j}bFZgHnrz(b&W!=tyFJPFT_y5^F zXp~-OPM%U7_xgZRmc%Og)8&e477nm6BqGUI$D*rJwb|rRlh=s#Rdb$qlE~!~qX1qu zp=zlB<;sBVa2fE=T_q5Bi0cB->+$Ll3~4_XcUevA$Cxs90T;gHVS)GN6E1U zV-E^j<|q0zQx#!E()3E&AE?bqms>x^U7s)<4{(6`o7asdiLZI&JyceO8-rux#wc|A z0-p896os5p6Ed|ZS!1boXNs9(LPQwljBR_@y*;_fOGC%jCxz2+(D~Q1Jt~L`dQ+% zGxcB?&nRFWmu9t|RPSmX_3MPn8EgS}avuu*#}Q=Fx9=yRY}PRzlP?_JMvf z9;3}>`ub*5hY+dMi$^sVN4a4yq_LCQHB(h`asn?k3#`=-s0VWZt0wwD?`7o${5_kG zBLwC2!+P;!d+>6Zti14b;4=?FXY=(wc(yU#P<8uN8F>ej5R6VX0Uo@>YEC1XzWEQ7 zM!WArZRO1~BbOV=$VPgP(%9oN`3;$6J>~C?-t4Q#Z=&t*+eXDj4?bVeP%5HL4b6{c z1n}--ggSe3_}%a*y#cqGYcXsCPzGgi8cI;fQi1E1Mh+$ZmL+<>`+PPc6-{NXYpPo- zf^N()ZXi6wtyXB3A+-@cmLLMuywPiQ_f2x1k=p=pYjDrTQp)z-XjE8N!BUue#{sgh z>>K4ciLJ+i!5zv=^wRj4?%3*?FLPnznkh}OW)IEZyJ?>~DHm6!`v#c!gzW@uIo# zMRGc197t_|AZuZjH^z|A8Mhlpa)EbS?yQ0_{WOn$4T9puLN`g?i6$ z($|DXSxY+^PG0IqDNQveOnhJA|Hev_E9491nz~$!)G%Go_qslRK7BFH-hAuRN&A;r zYUVVjssw$e=LAnTY$*ckbW#^AQ^DICyX5Ln`eoe(Cd?oYu^?xRoxSt3@89jtU;4Ba zCz~r@+AbLE1$c2LV;iYPBa=?1a@myW77E4WRwn9N$>k=rOhCI0t-b}&qa&LYy4+nt ztfV;^I-mj((O=(e+VP|jU|v7YqQJ*YYrTE8yF351+XjHuPy+`c0oH28S{$LWHLlsA zmdZG1o%f|AA7acod&w!6le(<^!4_|gufigA48qMZ=4>FVTaA4+9w=tf1U@fT4#E{f zdPc}bcGh>|w)Q7^WJkD4nmCMYmq=!0eA#@z&roR5x{iPA&sdalj8l(04_xGuq zpK$N^F4t9BaL$ha9Mr(g$IncCmhg(XbY+jA@~Yn%qOtbQaNr8-YRLB=Ez+lSfj~JVjBv#)eGJ+37=*6QJWYj^+;T!09?0`jAn>v60WM5aNNAt}CUNqB+M_tL)c_89O? z_(R;&6V(#Gf8jrG>Jq5?Lo2)y{GjwsQTju*Yc%aWY9@R}fh}Ay=fpdC;^VB(>l642 z2Q(q1kv9iK+-eF{l?L3og9*=)o!?L}U?0c=XjAruL;gIKKWRS={iH1A%e?Eo7YJCy907c#?ye%cQMPZAf$25&!0KcJH1vLiHtYB5_xAEa?Vn63ha>qww6=SC? z+Ldk&C2ETPcmO&;#lK(x%hj@K7p;O*&(Fvs6u&TfH0epPu>NeK7_FFd9m?-BkizS| zxn*g|g-cOYSLs$l8HzY5iS1}vffcu)#;`P3-?45Mid7AnO(f{?vAHs{f5iD=k300X z;K4Cds>}r+Qvf#?Szi9D;)s3BLEeha|Kq*yIiwElBhVA&7xvr7>@vPPI>g}}?a1t- zBj5+2lapK|Hh(3{@j+D##Th|SLl~N77!Zscp}wmp#n=Lyaa~}#Wq)U>NRV@KQhw+w zlyh&Fx4g^YnI*7Z7D#MQcD44->y)N7tXi`;z!*u`+WqLINH5D~#FS(A%F37Dl2Q$| zOHI;YXJC^oBCdilgS@tPuq%m0puUPWW^i5*h)HvFiLi}iISL^e$|69hQ?dwby~qrS zQgIm0_`2&jU$;pig6cHQFs!a=x`JuV4hk}|F3vd#)my%nNeMuH}rzWn-$A9XE&2jEE&JaE?;h7G6 zkG$~l$Ju%JY$DQGjO_+I_J@m{{qoo@*luBJ%pF@bn|WM4^cKl%%yfG4QruI|1;)BG zLSDFDJ;WsuxIWqo(Gqz4d<4!u?nE;YgZJhpLnr=kng<^=12zeO9_c|~oRtaU2;jC? z%cD>^i>ZjB4ZX%e@D3^Xkmg5oE*W_Q+7n;*!s;FDCxX#tULXs&VZ_TN{y0hjlP-M= zMLay<1FY)7ru*C2fwdj`@}@&SpChp)@yHmnU^g-HFX(rUlFe+RA}{uGE3orW_a*bx zSL4>R3GKUrxwDLrvy52&h@sWgzqO^W+P`nN{?_+ZE4-X7O471i&Zj&*n5g5DG$c(DDVyq1Tv6BX%UfY|l6 z?dYFh9oPQp9cje?6vC+Q&s7+$!S|+BDXUO(?@^shW4Sl2%mRwk)_WwBsi(Jz>vDGf zfBRxiX%!qLg)+_H0z-jh-ki6#q$?a&a0?yermS-J{bw0WS>bpw+UvJM4a4U8!r`%)#CI zEacRW)Js`(vR5tBxtv6D#jk@ja;ZZKE-vUNGE<=cjMV;H(xeY4%7e5;QlB1Sn9&{a z_o1)fMf|ZU&(Flz)i;|kl8G1FK^gi`m%90O!=%5|{w$3%K3sa{#yUm0)~K}E#VtRj zZ(N8pa)%u_ta!jMhrxk-+jjojKYmU+e`eODflIs5Tq5N>^^qtc{TOJ< zM4{NypZHiaMn8U3ASx!S!p>5g#(oEJ4Iko;aTu}#P=(GtWhzgZ|V_9jheeZ z4FI#>jx{*bmA~&s=4z$E`$qb3V5%jtk zr`@RD7HX0n1g{U;n%qk-zG-mDOnW1dLNXIGwjUi+lA`U#he)ziS}Lu~;M2?oa47Wr z12ZIN5ssLm(W#LxlG9Q8H=0)&SM1x(%}Ts|gY-Y9qvI3@?nw%8pymRO<(bc%s2z_Y zdq+O^m{%DUJh3JN1maxHv_%SKz1;I^x<2A?(7sN8fVY2o$&Ra)GQN=!FAG#k#X;l~ zN=oC~-W62L;zRZ!$^O@v1vnaO8k2cAto6E4eWBu$bf~I&psR(W+lwfX-&pthqnJ`6 zl<~m3Q-n-jv~g5u#g*cOSx9s4#U$-Ubum`i*}2*JI%0H5I2y6c(CEsER@42&rb59X zv&&oL0L%v)1z#!l*QENv+%vNfLlk5X3}O&hW!H6$5m?zWB~vw7PWRSD0VgJ~rn#gP zVYUmL7Uoer(N(%MMrX_8#3=Ecm)5k$rW5S*_u;cE1p;dTPC;0Q!x6cPe9Zkoqq?oUh+lt-1O=!wf*qDVj{xIJqhq5XXzqm=7aC05dJ}%`S|8nc|@n z<#}1U4T0lTULY_ahcbAFqlIptk23<}+WP0x1Y#7nO6HKJjHf(4wfXl71lQ%)ea90x zxo!MzT+{xHJaB!y!TFgeaD7}?w}D^J(4|loh8wFNC&6_zUKP5JGv918>}gqeVF4Cr zhUSH)aqFAyYK5O_QN>H;oU?vUHN&fmg>Bee{9QZH2#3!fHHd{;;w7?8|L2`AYl@fH z)Gt7xwxGMTU0|IS&+XS3KUJX$X$lVDJlQ)!Xb|#l~nSeTdGyRn2xuUWt626VVY!DY762|y z_wyR9G@$H94ENS5T~FpnJa!xyc-dyb{pY`tJ*VrsrP_X3JnM)^vvnfT*h*D=A#$$UP-l1^R0lw`N`f~)X)u4D z_|;rvj|^bI&!PuMVo)^}l#W)QSQKk9qDx6)ibjxe+PAlkEd;dN`_yeSOFnobh9Tr~@rwEQvcZKM+#xj4i#k=2r`t&_3g&yO~H)y=c}YiRd4FJlX1Zqakb z274x=&=OieHgjY+8<^agil| z1ph9~R)lA548uq-QEnzJE7C~!b~pjorD^QgO0!V5V=s&+?Y<0Lz!Iij*s#sArljkd zg4$E&(=4aCWLbtBB3^-tDF{-e#gV}&cNoul%?;jwrKuLwV%NnBnhEh*9os_!V$PMG z9^D4B^x(1HgX7`@Cq;vx7#m%@rjZoSW_*zG6Z0Mi1{q=u7mqt5&}qWk74a=iTk4vv?1LQ@v1(EK^`QnV}CQ&I}=_~Q2Y zvLDBpLj&Vmod+t zA@P*Pu}QL3uBw!BskQ*MfB+LS7e~E*=jq&>3~a*O4SA-_LeGMxnMG}uuiqj79Th?^ zIL_r22Hy1Tkv)g&_$oGF>Di)gUkN(BX6+1k-*%hYB^c|+p<~aH^y>uGyQtl)t1-Pl zW37`CLd$5~zH@bwm&3diO{Y%wSn8 z4Ox|o9b7cPtd6}_J(TNJ=z$4f0XyhePTP8XD&%$P9mkf7+z}mywC)>@RuZ>h^?)bqN{SD_;;0dy;-AL)QfjxIO416;xe`%O%RPva~bCfg+#NJ z%$2Z+E%!=x?%X`A(tKg0SQ=>>u9vi*dO_D4xadF76ZOLpJbOc@Yvsp#Q!=qqyykAi zykFR&qjM%%+CyMQ z$c=yg43WQZJo;@c#!H_l-H7vdpYpths>{~HKDuZ_{Hot#Q+4M-FQjvH)Q6M#*4QG? z@BLO(vo{s&f8~o3H@$6deb9LGK{Y)TEN+ht>L{~Slh~b#Ef+2{r9$v&4wEq7xWR@?%rBpYy*#1)4C_F z6JSI0^P%Z195$>(?mhp{k4N#Ot*B>cY0PrHR3`h1$g{LOQN5arw81v}zwzZgyC%Ke zQc4in$ZRGzMJpOz>!R>d0`$r4FOQeO<2328-Z5syL5i$--5Kzu+;q8%5j}TgB zivMj>(5C0eCBC$A1jlgCL~o=Qq?5@;cg(tlrBXY-S~pqS2|pVK-?0 z>RegUSt2b%ao604hwOSujk%9oL)II*Z|yR-Ug_D#X5ZPBQjp zTcKquWigSs1)^L^zM4pAs_N@ocHj?6`wk8_3=)E0RftR4h9`9i4rv4&jIq&8G$uyp z22zj*xljvvkQ>SCpPt#uae}U~WR~vHuX2gi2+GMKffjQ}|MFU8B19lTN!WOHhTrn( za4*-JW#r0M7%8;IZpV-l%mgX>Ef#6R8zyt!pLVy)zCEa#sJd)<(T%_tEy-bLG>1hy z^WrsI?TdgdjYC^+EglblGqSY}5|T$=5exfH$4Y;7BoWdC7KZU}QO~nV5m8Pq)7T>)UlpA5WtkGp3`#ewwt6>2b7=3)uG0yxyXtTl#iF$I`k;9rRg$TtLz&${I=PG^!7} z76L9VMtNSfR~L0#2GO#&eu2)pq-F6?P!82p>o%0#uXcmn8ihc@BqX9)32b8 zjz&=Iu!6(|?)u0FL<6f>#R=jlQ2DLbP!u5wV8t8&C8|aJLz&WK(mga%BS3?CiD5Z)(Gf|D*krP$T z(8>TY^5Z%2(eP;60XNfMTcrL}+|XJ`2oe3hFWz%Z;h%#gW7%A}Du@3-(V$7Y+pdN# zQ|)PnkQ}KtAfxm=CHoMOUxkycZv0=Bp2kWDW3@cal)83>d1I)N1$)w|&a3lfKYc{) z+G63kg+M6M!3fs4q-DW~fycj&g?y=jV{R^eG(~CkZrW&c1U+^NCUSkJDFCbTS^&&JQF|CZxXDwyYhOv;i-DOp}UIxbqTUVA3r z^2O55BP))awQIZ0-6nxxgyuUDLNx~=La3<8!OL^UT zauu?p9hdQH%!>$&)Tq;wt*R=hnu;lzQYLBV^D0j>EW-!{;(A#erX^addk&7V0w~mP zCENZy>gpk?dcnnf*^n9duz}Xp(x?9=zxh_Jk0n>jG;^TWNPzZ|?^fNOKEjsCt6FMn z=BDN*h)PxkHe?Ur_?==xF8E!o2Ve|wbd&0@c)P#6TDyAnFm{v9uUOXK8?}0q9*E!z zlVKH1M3WpeD?^4Mr-tZw&$Md)Q>gT0?ubGW-B~W?_EyihET+=aM>eos6d5Hv|Is*_ zFLy-X!AD>Qt`YP?gi!YTifW?OG1gz<6-8h}D?t12Lh$AAMuA$Irp^w_6W)&BoCbuPt?xL1)m7H9w^X~y#scxK8X6=O~I9QyVkE$?VF z5+RhCFyFmV>pB*SY|%x#eeHHXzD@;_4&B{Y+1^@qGqlYGyEq)~j-*;rrTq&J(nNiv z^)Hlb)T@LDZk9gcwyWK;UpyD#ig5COJbGowH-}FS-_%SjghIOdncJkBcWCn+T#`T) zMKpCPqC&|K1q#JzL1G9shv6)*7z%9|Ou~a$3B(!?{V3AhOY+~?8r-W&@TRY+BAFQO zMi@^sQ+HbllU^^6vO*k%D!+HHG4BZ0MVIO{Gx|eZxEkt&JPQPz!=AO@qkdh;2{2T3 zI^tRKBW10iPzyR&-bKUKe|T3Hexdte=r~Zp5i?ewH=U0+| z_~lDdQ{#5YxCyOzc-e@x0P?TtxM5X_+4BYg!=K$B(H!Q*DR7*ucLR@x?QLK1TYgl9 zvJ=-+#Ehv9kJl&JE%8_(X*-WN4^Z#bzr0Q)5e@{xu_*~CBel+n>nZf%JvtlH&o=T} zX_hRf`=~5>;9_gQ_x$M_C#)aJ;*=zAh@~@ZxYenbpirLRrlx_tEWqJsCqZoQVPk}6 z1bgxs$D8NyJ!E`dg|Q)l64%H@7ES1)i-<6wMzscTAF*^HRQkx zldUU5ozB%x`_e>c1)5$n57vA!p6=W*hCAPX_g@yN+BtLlAm)ChU1)MYj|`sVE^SkW)Ublg@WO zRd0jJpHXbb4ki-`Y?r-5u%^?lvHUl2!{`Xns@EwA5xmp3N;IQyCU9!v%xrPvj;tB7 zXAsU#s`-RMc9c`ZPe`elizX81CJmKXd}Rd>&23~y;#}aVSXu`7*ipCc4`)-~ z*Y?Qdf;uvbUfwe_XhqGc` zdYLjU$wRL?}8H=6NkmlnTP^2~l*)DeA7* zI3lDY-9*dq1^;px5uZCUD*k(#@b>`u4DGwU(?{_Ze+ z{kNIL8-Y+{R*JkVSWP7oGb+_QZ;!v4Xk~d<&ea$Gk?}Il|9xw#x6gUK0JfyC*+~9g zT_QIA``3M=|NImIbhX~g%{i7TX~L`TXh>FFU+r9c1B0Zf@aqSp(#Ib$ox1q*#jOiH zhm1w@LyjmfOl*C;Viom*jjt8}t)tFGREmW{z6GB~tyZnH8_j0*+Lb94%e7(HAtX-< zQ?DEcS?;?Nka+}aQw??&7b(5WbwEJM&2wU1Nd(z(9mg^ZU2`ql)@6ym9Z-#=2XQS` zfOMF)v@?sN8a#lPdv|l_8v#X-9dk+SexJ;`WE79b142KNP87?eGTAQ$PfG9gvV>tJ zr@RGRYa!aYe>8PNx#Sruwe!Qv8$Phv>m#=GxAfhV$H(lWdGL!SL8~^P?zK>#on6A= zGMs$H;Z@`Y&$`&(u<7N12qYkb0uZdj?=^omXwd9Y3u{o&ki*rl(FfZ^C4yZopF)v4 zWQ(dP4cedeIx&o9Ybx68`E+t3UM_ykC&bfU=viikz0S7hbkB(a%%nT~;=esm8_>!} z-q9~N!^4-SUi%8%av3^F)M<1Qb{==;`#d*UCKP;l|BW)Lf)3jEC#AlcS9AB?Jv=hBJ zX0bIp3zw3{;(%oyUycu?HT(cS!wVRLZ$sigi)EIIv@A<1iR)?O*eWJUvIND~HcOJ_ zY_^QWT_&hAlQveI=3c8+fQP8S$_Lg?0R4n;6Zo1n>);@i*G4-&k@tmG+`WqCtv`Y7 zhd$8wuYI+0JZR?x5xxDfi7De$;-YMAa~{Gll_YcT$ff>ZxsU7<8=NNvzx~e#>%)av z|MlxOrfH2g5lKmQ0jH|wxSp7~*yrVdV!;Ae#);I=e1EY3zgI^O5ASI4y(aYLE#)G8 z$JtL`n{=E&3!fAdj<*=dw$6R6b3XRRXJhS89LiVSnZek;#}n~7Dic^YQ*g%nvKR4( z)dscnE?$?Jv4I->qFw5qXw5F7)_IH1NS@kW)AT@2m4-7AV^BqSX@m>3bsp}=5a>nd7y94 zJDJ1VbN+_c34w@&a!Yf+m!P>sRdB*l4?7-80aNRKSKDRnUTHA@?l^D+jDl0g8>@i; z!yQ8=sP!2p0++(&a03M3(!q4ubY>k2!=A@+BH@QoZ}IFAbCYy2MU!32NH+>!8ELe9 zXjb{^s-kup`+la>LN7P(iSg{U){_!I26!6zTQ z8FO40jxSHvm%k+%Q~95nN?^bfuyXRe2T*rvScwnH!F>K1qFDCt8ZUr1a*OkYvtxdq zVA&WOw7JF3;=(buy=GmsFSOsgqr|xunJhN?8#_7R0`!il4h5_6`!4>?lYT6cZU%*8 z+te@Y=aN}w+59u^xw>`n5>vvxHoZ7^Y8Da)fib68c>PV`id;&tv0$816_zH~H&7)Q zN&saj0He}uSd-(JF}H8HKnQ*x;-90Mh+?@9zMJKD18jJdi7h&1?v&Jbw!4vzAbT zgzth(4NdJ0MX(XJLOc|`90Rr}njz*NNnPGO=$2H>mu<=@!4qELV45 zs8^hicbSd&z7^j4-5K(mox8piQvoYx1pbDAZG8Rzo4HEpxE)!r{lz>lQslN^YRo`2R73}`bJ z=?)we2uU$E9^uLh%$^Wbgz*Mi;azcLu&0P{|EG-zyJHy!R;gI@-?-ps1Gj>8`6x9V z`0{s6uDnKSYr}A35U2Qt4v!tZ>%olfzj2+6v53AQfkprd@oI{f+b3mXJ9dDgCFA_d zP89w2!^RGsx3TxjhB~CWOkfd(D-|u94!cxbSRw?anOYlpEsZ=$LZoB^i@C%R7D?y}hqY z5OzG!Z<`JVz|hdI+bLi%1fU``&Go(-mCH{ii+SSM(w7|;-aRVCTSsU5u_!0vJ_!w@ zjoFF9CEOEfn5Sojuk_;5IT*aqfDy}*8MFVKrmX$ypx12#qVZ<=#tG1gY7uEyQ%9)f zM}-Z`db|R+19P(s_|$V%>6`SOIHSPyuP$tr0b@H11JfZH$_(`@%wXuKo2D;PG#aLq zl8g^Xjm^RdX5#)hT}pGI!=)?6d2 zIzm}V)@t=~E;W5lRYg&A%fopVS47&fAm0z)@S@$jAh!|bngu+Dm^sZ0vt@-JWlkH) z-q!h%92!$2q(R2yZsnxpeBU0afl1u5jwnd!S*!I$OAMsB))Lga&lpc6 z+=#^jotHv?zs=@-ItjDfTwkbH<-q~HjJ?9L+t$M8^V>xoeOyl7STAotdq47aAh8Wv z!kY2io_4Uy!4Dr9hr(L4;wJ zqk=-;6()qCijhiA&Xt!+UV&t?Z|0Jjo za$r4_01Gnf}W0zb^&FyhgT{{LEj!(V|uKfcc@I} zjuhVgK91qvJRiywU0%(Q@fyD+rtufGG9FDP&)$Hq6Avd2(TE-pfLZL0Sf7HZmQa!j z`ouVR`egLXd^foadsUgQv|qlgOoLC=*9QA_9yq_aA=W|FdVt`eB;5*ER}?Dr8@_9GNdqA_d=?`0?4A9-XqY=u8z(uAEe~;=&hImuuCh62}V?w^imJLHU zDY#y|Rw?&6%a+OsvTlPy-NAVZ%2Jw6g7x=mpn#wRD011a!zO`ch?~LQej1o}90e)K z)=YBriOU-Xh{s+edQ{Odc@+GDm=1Fe{_eYwVjhgPhydjiuox|qt^_;|5g%x1#iIgn zKa6oP7$h6VOW(0gg0St^k4cnF$by-!hYzN$+J}WsS8`!FJ0C5OV`(W_Rm?}|94l{ zAoyJ8=bnFZ-p3nwqF9}%EL;8jg%KJjhY?6PL$-8<51Y1$*-@s?>|G&cS1t-YlHiW# zpaH#*cLn+%pL?iRWh|~@xTELp_+6tz2DeLZ{{I!=u&WADi#>nCt}SmJ?(MN~c0+`; zy;!PmW;d?9Zf>lDOP5ZIeSO2I=8g9Jo!}&$O_W)_VwD6n52bX$(_IYBPLS&+c=Vy; zUFI1z+%KbR_#QczYvi_-q?6e4&<%u9P-tEtVU1-iUu-qn!%14Uyg5V+5A`ZS0(CXc zD}4CrcbDSABmZV^tC7YNx-7Bbp6^~N=hb7PyBG}(-x*j$Sq}~_Dr$-)4I1kL)eMF! zB<4{h&F9DB{xy@mSeuq9<@#ivB2`Y;)m&LrWPxRiWLV~veWB=#A{IX%UaQ5x(QHfi zbuM0M7jqgKcp`5)q_)W0OUp6k1eR>**w#0yEsPOH zL=-BgiOkfRd(-z*P2pA604v69Op~&Pr#@wj5Ii-SY=cEMLUXxq zhXy{pV48m~?B>T>B4K=*Qr&ugsl>H+ndu=ER?FS}r8lskwb3S9u3L)#cAgZU@UIqM z(8Pfn%{j}mrUfiu%8e(ujnMGRzOGAdm?rb_OMf-V_&JrB`h-Az zRyA3_4%0)<6R`aYP6wqpdi6$dsg2F4=G(=(>+Y7gkvKJy&>dyhzN z>cF2L0wJ&nY#?NA9RB8Xox@fO*>pOZs>E_cp;#@W7!F*4{={ppq!St7S!9;;p;~N` zAR@c3Sleaac4hpbe6gHBO4*;iB0L|SOJ9OB`_XH*n-T|5f_!meh7-Q2ZKa*ZmTjp- zz0Q0o6C+oYMG_Zl3ICoSK&4S!-BQK)`V-S9b*pD6oWJ9QQu%+P4E;v z@1C?Fw9QQiK%!Vr8&vw1yV4D?>tFGUDe5;~Gp=M;>dU5@x%->ou_&r5aMdo>+D^hX zgaBkrL;*)br^$P^*%;T2uUyC4m_5y%i2Ahaz(4KwK+}E{*0wXC=X3xZVL9Z(0f>a9 zKHmScsw%N;h1B-~mjlJibh&_XI#b10in&xcQC`at`9h_HVi<6y-gNj(tj_Z5W0i7R zAm8hdkrQ5CJ~O{y8yRyu^m=>1W3`2B9kL(!v))A{o5@#@pSvQw5S;()GMu$+_MI<0 z)@~d`5MVJo!wH;dFGS9NET3g>mUm92$6OXzoT%Wt$mw++1T?s?V=mFu7gwX3aH2zq z(Saux!rqC(-G42H-0@G|F?LjcN54lfjoh2VW{mYNK7UroAwhDVPqd2!L5rfL@V&q| ztv`@#(X>Qp=$pm{$+}9Hfu|aZVt^s*PrR;!snQU;8K{CstFd}6b1QNpSd1o&fTRQu zq-w)%!kh4Tqr>%1O=ef~D(6!*?E*=8_RNlee`U+xu?qb^oIl@R$c=CoCx~3WNQrtJ zsZc@XFO_b!9vxH3bHV}Th`yy|+`z^UoA8Z(FKd>a3}VY8=_Kz>s_iU+clqnLIniq(E3pZ5&B_ z07-A~qVoXmA2s!YAtr=Nh#T)}M%BrK!6aS2Ubh^=OsyoM?P!ke z&2r-IMEX_+BrE4kxqVwcojs95eh(0(+e*~%)q_OoWL_}|ofsGVYK`@B-W;ZGUQ8B& zofmPYzcNz)^G*f9Ln_6f9uV_glUiH)G%G&YZj`?mT4LzFccO2&4z2d zsaEMzDS4jPDxmH}$EV)>%+J{zqt}XsjIF!hni!q42EF^ce-z0MO3lilF5Q>@=2|yy zeSkrom6>8b_|(H!_*%&l-Rz3Fak zWlTkO<<T|83w#-bn8lw%Oz zVF8+Mb4Y*JO2Dw}3c&UIiX^}iSPG?(4OvY}ce?`slYx^t#yU$>NX}>}I`z_V80|;US#~$sJ#k2^~n~u-brrRRpfTz9=51Dpv5VN%?^vSZvYCx@du@owEll}?=HW;*yc)B0zTvPz*%@&XBXYc z;{XDD!l?R9kjPOMn;jJTAkA;Qeie@NSzjN?{LijiYTy8EoKbiffQcbiB81jJ8uWBP zUt|MvIBj;Kd|WWYFD`}Ue8_$=oLc%5Kf$De{!%qj2WzX;hrp4<< zSJ%1mlW;Kf>C9<0fp3}yx5WWHt0>?&k_NE+hu+J|M_j#2$=CaE@#f;-K__5=2i(%< z{sZ#bl_%Tezg&>XX%@0Rk}E}~(P4731UyJ?M8jcHi=J4IwZk>O%_wDbeeQvWT zUz`}W$|3HP#bI$YcQ7;jegJC4jaVw^=5-bkk zOyV)F;6XI|xKd_=Y%~JXjm9IyN(Ncf&l`@1M-lXf)peUV|0-h~yuG?V>-%8UJN3iA z{4*K`feZ_1>7fs|vM9(#GSOV1!Gki33*Ge1b36jvz!jvR2Cl)3!{rhtbr;U4o7Jx9 zWiP8fcIRrl$JIpNB_cKcKh#gT7Q<*()DCN)NgBJnm5VTMXsI{Ko0=+LGpJEI?P^%KbxX=%h5`C^bIFs@Cd)K-Ir*WQz35ogt_CG& zcvt~G2i!I<3%E9=sj#VyM0eI^{J6uVs zXo<-AJUB?2s^TQ1D4npFa65Nd-Dk04ecxJMNijfTJ={V&}7{@fDWKd5bP9A?ASvct{a@=mP4O`_WbRicQV(LkE_ z00=<_L7)L{1*~2yn#+_iTUV!U+v6X&LIF1A}BSOm?|ap{1IEC=L@qf7pUHrI!7o#4GUVr2NJ}peswMBC0ZFMxY8M;7My|WX}=HU}CeESI`tu&2kOUY!K()7}$&+ zmwwBFH_gyU4WKky8OIdN6>?&stq{NMv>H<6au3A(4_>d*GdVfy_AjpB4Bs#K?ZWc* ziZky}2P8?x$SU6ob|un7*?~c$@jr<#$bsZIB^(N%%}a8(-v z*Kxzv%pSBI#R!KJ)45yycc0D_6s*S5bS=YkaBZ9juQNSdc#YfgX}qO)yM}sy@k|6! z&m<*2g<(Bf!LH*Gk-?urR+ed66=-S{2Ny91QK;Clu~cJ!Sleabt)wMhtiR5HRnRJ6 zK^7t&KR%}=2XAEn<$d6J^T06a({q?$a6K*n*!UO1oIo>pgZJdfgylMSlXSRMgX8(+ zwfHrbBUMi97Qfq|r+ahLD1v&5YWsHvH0{l-3~B?N{c3ajC%wV!I$uwa zV|gwKMl(IAz~+hHEo;#uhGgh4!+e8`898v2l%U*uaW@aA1Dr#}VaCU-;l%P*C7vsm z{SJnjhyn%Klmd#FIYV5x!u;%7*_%V%uP7V&qWgR=jKxf7!>vAK&Z z%Yx*?1#$@lE*CQ2%O1YUInYnUTN_DO0n5P`(lqh9K6a!Hj$HzTlFYsjBp&Io$FwXhm$}|hbT{m&0zFsLKOUXdEk}8H`Los<$Fej@5;#XQ41xG2L?Tk) zxko*AgLs?hU)+J{OuGZWb8pa6Fj7qNA&Z||9b|Y~NCOQm=_Y+(I`-H3{)IOYwS*M9;82r; zJNJ%aN{2;(0R2xKOzhvpz@*QJ0yu7KYnS|Cdcvm#S=GL`yjZzB(CA-S9`{2#inIfN z-3A{x^YUp=4ifN!NYDdGbavlJRx}nPpoJAOr=xcO6&zNx?OyNEdK^(!3Exb_%!@?9 z`Bq=|vRZuGW{i9Y{tQl>fB!=o@b?NAczATM|7!pztfD*mvGf;mipZQ8oOUD)T{nHJ z#eWh=>RSeww#z}5ExwebF+Gxqe=IyvB&W_kxL78caBvMyOO};fEapk-LRc7IfGHK| z8cATBDwDCQWJS9eNW`OlEoz8`kdnqt3&dLjpb%EVnRCPAZP!v^hh;#dV2p-$-dz?X zlyKbc*3?SLQoh@rv!HfqOK$j2UzAQe3e+%lR z1h>w5Qu9MCCgb9$S)-Eq$O+UNj z!fD%{{G(d9@(9O}HNG#AH&>l$?N|?%1irPxaW+C2Z{N7s0$ULp!u_lDUgI7v@wW-F z&PT`n`;dA(hD~Zwj*U-FOi)k7Ot+%JKB$H3P=WT^5L;K>^LtBu7h`p(X$;F7Y=Mfg z{ZXLh>H?IUINuH&cRBQZ(W)C6wSM$bWf(PMeNq71Npkd`$OH*nP*N3@%%o71Q-icLQ$l546rrrpC7NagQBo92 zM1pqle!<)5am$?J{mrzBfi`X!b*LTJV(S*Eg}xR!{XFsX&lW9)d^&4#BFoSeg$#PG z`z@<+Dtq0WkXIVNNledpW4=8`T#}t0f%l3I-iFU++Z@XfK#C$HE0DgHza9fFY{A{6udTJ;n zO@#zw>o2j6`h{MkLyRog=g`EpRTcHEK7b!@S`brR>$gkzw5uqbrb)8wubVQQO6i0W zgbp>vOhuNQ*UTBOHi=YE@f73GN}zNNvnjBeTs)TwxL`3sV9Jn;t}CBycOt=supn4z zgs|r$9&!vLBdU}&UJ=I;S4++n$<9+wtSNyTKkAHNYx7J1y5bZ?Kk1_c#%B#h9H4;J z%D~;et_$85LzT}jmcQ6k{%({fw5);pq8Jz!rSkbs3PKz>P%57{$%J9Skup>?tXqA6 zvhoAdZy`Q+HlPt8Sebw@$OuYEoddYJ#bDkaCb0~ke-k(3k5>81hgwvF5Q6%JBXS7^ zUcM3d^oA`SyaD*@UbnkXZVG*G!sI?Rl1o)N$2xXm_?|dfZJ)gRD?MQ!ztxD_9gfW>3C^-EpcuXfPS0d{cZg;5%e`C$ zCxzBDRvA6MG>6UiLSS7-G1{w8s_i;fc&$EuYSqxr8yyyf#OzEl+Jn%(_1aCkp@=CG zj#t;I#F~H*nLR3o-?C88P^JBn@wyljeW6d1z^bHqnBXAC8(eHD!*eF%n7NIbt<-xZ3$ze`nTI0=b85FWi69YW{O_Q3Y3zf~|C zCvv<>p;RhYkU~CRzMe`~F|?G)!lRH`2iO3bz3ImPnAHndJwcudPccHbA2@a<>BKUZMGPYUs52y?x{7y>=S~YJy1cK|6 z!T_Ys6T+>;8f=R=D1#^70~_q{E$Mk8c5SH=S&melLpfR0Gw(qQ96XQcH&xl0&*Zgv zm(32kj?@O63Itlwph`1f=gJ72f^678i3j$WnL@`fVox#>d}-ymryo5Lj6f;oxNoNY z`yTM9=9X^(#Bp`zTjfiBV+luHIMGs zo(A>HDkUGhznce6_dME30jZDy8L$r6kYS5T!ypv!>_uPyFDXbDm-yV)H~duUDWEPL zt5N#E77t$cd=yo^E?S>ziyccMtv@CnQzuIy8h?yF-?;28QO5c21=)F z30*QEZx`W*UWl#csyQ2@UN_bEltHFtAj)*il7F-4`pX`AG0qEGU96bGo zRCo|pQ|#Awgms}fAJNWa$l9W0H*MWni>HVghbL@hDyepe2<8;Q3i~GHnp-tM5^+6V z1%ZPZFz)R!tzS(9H%N{MO#v0onT{%Z6+zBclZNhOa95@TiK7h-q_&&+C=+>sYBm#i z_)2A$gM7lNqU!m@>x(r~2v7pw*WIuUjzcc&%t80&EAN=7si&`h&*L7CU3^{TInj-_ zM0|g>Sj;12$#N`)f4s`K%k#l_%UXImPvCob^y@ZfWRVd%C2S4L%Gt{6O?W0=*G`$9 zXq9YbelmKTG8~&JoEdPsoxgRF{o2WaH7o_;Ps{oo*c6*EHLht`beOq12TjHO(~anU8g0YB(LMyjl%1)=E za!mjo(8_VyO{c@$MBcS4Us25|4mhV2Y|%O_xbp!VwbURRPqCv8o5zPB zXZV!mSAI}<;QrPqLhmTVmQ?~4{Oj@O2Mz;XUJ9wfhS9_uywD4Zqbmz2L$PluYN{3YPih|KrsLu9!oPt%+$}p92G9A&K!>to9nHXk?GzUN z4@?5}{s~}=gb~Oi?{#S+Yk}<7B9b)}GUG~FhE0oLhHcz?xZd+&9J_?pQYJk)h2bUK6d=kI+ItQv6DobgXNRY z%G@804mo$c0jgiKESq`T9kr&ZeiFIxn~{yp!Kq(^W+UeQk{O~}8jcz~pPb^A;8||T zFpd!awdp`{b4^k;J!(g+DI&ZKUAcyXLCv2`2~EYwUE3UrdSB{5M(bquj#$lt73`JB zkBsSw>M+z)MR0%20Ilw!<;i7OD6J^e*=z{vuVy-!*UoyABEy0isk|ZAv z`b%wjv;JI4bFPL*pqgt`P-&vQnpNU9ulIMp1Q1~MZ@{3!gb}Y5a&qEU3ty0;h$d=u znKy68pu(FGuO%{Q-UO9Y&hfQCPIE9Kg0e++piXR%s3|b}Xa5tP>MS-Kn1nR{+cQE9 z?13-NtyGV3lEvM|OfgHv-U?kLxWp5td8V9xIo|MHS0GjoCw+9*C$wSCBfWtpUTtS% zPmIMe*gH>@)cj9PP0iPs=pG^+N6q)g+ghakqw zN^7B}uxAj7SDPJu%}m#(k9g}|`p(oddhFW!wn<^Aq6`YqxrL|JK5Z-Ef zI>DdD7Z2qP1`E`Nus)T2Y14}1I>I!L80w&#g&G0Cq_9Xk16Q**2-{8(JkCJ7cka)bef-V+^^E}U3WVbQ95*P0FR@f=aK&7<_ zRV5>FCSJdlLFyHUmrr@ZW4wLv!f^)7-0>w5mNZcDlKKZ10|`_gkb8ZFfl@zFxH^F0 zIIvR(F5K;+`Oa954?Dg*@z^S2)HTSO#>O5HdD~3ao<19g?4&t72o}3KJ#62MKKAsy z;Z_ixI)zF@>ingFzK=kOhGuX$JRaqn&2Hs)3ot$m3pt$XU3zBsx2)$79#P)mmC5+a zY6>9GNEPTt;z9s;0t^Uc>WzX~L+Uu}4A=k}!6ujwwg10QfXb)?jK=}cj#2_OaG`*P zi*0WYu3b`AKVz$v2mWF?I~U-+>13mU&ChD#Cl@#CeM!O0q+v)IayA4#t zxj^0h&@7*}iMkAMoP?lt!fSdzUS7*0o^P*1n+Y?@Eal@ugZ4h2xLvOS(T<=NvGnG( z2#t0__^uNn&u9c2iLVq(w%7&BYZazKyo+luU~MAFgfKXos?G=CH1b3{$B{M56kZ&u zmX-5ErBr~XcQQh}*a@D92oD#{8NhyDD-8q`rw1u6m(1kKd1b5Ph>7XIAqts0-PY-f zPNs%p+QnR*I|%7x%gq2AWQs@0LeG;9D=MA z^3%g(`FtT$m@5+IFDbUmbzP%7NR zAx&=m;Z{yR0*mF7F=8b)Zl=^ z?-~FQDIxqzfuVh)gcQ=mhi?5Z|4oh;Dv^jMQUD-aGGK-Jkw&hRX0N3w~!sj z+q$|Bj2#GTD5og8#KT(yr0mGo`zUiuB=~ta4US_e92-bT8v{i-iwcM9UM7oQz9H-Zo0!hyHqHEFK)bu3mrxLeKC z_Eg2@iL@C=HDc|0!9nXe}cmR)$Ud#*-;#r5B6&A_prI8Fr~d(*{sp8k$XvDKlgplQ8ec=~!&4W3 z9+XWkb#X!YF%Y^^-~`ihT%9Tq&wfHdcRPd9Juo*V;?QWxaOq{W!)DESlhH(L&pTm5 zqurit>lXF_9U6WFLRHh!)`!7Db$w;jR~Zu{oafXo0fN^#D!Ig4>O1PX*)0CR@bDN+ z^-pN)=Ad{ALQp4DDPy_ut@Em8x~g&}{03VcJUBg@ZElG8e0S{m=oBiSTD{Hr_PjKs zE795yn$gI^(!QN}gABa+`$y$z2OS(Nk&|CHhzZ~;mNj)#UgZ(DpZn?L`P`nLHAN*b zRSvUzj4$fz?>`P0fpKRzfBpwu=^FYvKF+6B6@Lx>14kl)n2@wIv*YKsrzMTvEa_OQ za<~8?5r?!6uV8Hjf6n*d@%4s9{E|tCw-wQKom^_~Pu$4{xAhKpH<(@7j!gV}cI^2# z$z!t4)viya&lVRWEZI|D%6-SNo$%~-af67{guqNW%{qPL4YHK~xR?h8Pq4>oNNKN?uMa&_uizw4!UmUwWb7T4g7usx!TIBV; zRIU9juyiz^)SVkrSWeUxWe`KpPi@OHC4lb@A0vpIr0uSv>?SjNa(B|<)JEa zEK5*$C2L0sa)~+ZAQ0ysX5N{YG&p94Mj<@CGH6lK7enEDnSLbT`4mzf;Cf{%pI#ZTUoBpH{K7*Kz7ZKy zG{+F`Ka}ew4NHw$qkMurUI!%t4>zxH$1swv!)t{@0=c_&Ck+wfg1=?oWS-0&MN1}i zXC{YY|6Z|<(zP@f3u7d(evN9+P^+bobBXVwHn&*f@nv}cWpf_g5M z$`?&+wQya(-j8ass=;Csia=~?+6=lTlP|pb2(j*rB*uh|r%;Xv`c`Z^9g@O1=Z32m zaH|yATrl{MKG|Q$?j^|}pASDKID;lgk*X7Jcjy8())`p;9>d6Z*BK8QgfB@4( zw1v@mk_}qEjbhAjMp)PC#GV?|#}R-YOuzzUW{uhtw%G!qB2!_yhpZO%R}!#S{tiK6 z6eaj`szY_`%a~>&n%;`aHrqI-{A87e(Kh#kAbzrp=#k@CV#77$>wIOK`$OUt_!Bc6f((P!sVnOlMd-Ku_kbXrgUzk zvLbs%rpr1NQzPeC<^+&_kehb(SPfCa_g5i3H{uawLn)L)Fl2uNlr%Jbir#-~!4($m zma-yy1x8omFzB-p=+r59@Or)7Z}N}EqnbaTBBU$Tj&OUCV(Ee4{J3}fq?QvX8SgHI zO>woXo>TNv@!C1*2NoNG0rmI(^(Sub?Tf{Q-SzUV5&U@P4gGLK=r;FXPZy+F8Ig16 zCIcNP{^e5=kl~22VAo;q_Y?5$Jk(bL zT82%O5`E`9fEm|WolyuLo%*%?g%hb$HzB(D@*5~H9qmuWO>B#)&9%JEtcKG$pLMYu z>3i#fbaP-+ne?k?S7o@+_dN|o(MVjkyZ}t^oc{s>Aqp0OB?N}^rRj@_?4%OuX$G6a zClw~eUd*Kh-PK5_R(8-tt{H4)^)fsgK%O*}D@Qt^l94*OyQL)6=YX6`+?HkLmADbc zLWE=M0r!2kmZ7gXLQM{@U9Z9Vkr}CwOl(x!_F0!-S972+RVs+Lv@S|m!$bFfKfEAz z)K1b^=5Vew4fk%g@gH$v1sN1jq>JdiUf;w2wgj;1=A{y{lNi0awJFL^`{P>H^0<}9 zr3edC`rC>>K#E-}3)sXe>HwQFz`zFs;;7SHCXC4hJ|vP$B*dKOb5xZQ0RHpbq$3+F zHw`|W-^4Z?{v88^{O1GDsFYsBMO(Ps%dTfP{$lXWFU7JEF8!aEzOitZIIe*r4OkJ+ z`Z&rw{`R2Wer)#`3_LLr*gA=|#%`udHSsY~BV>W7YR5$`YG4Z~haHX1crlpg&8vE% zA z*VDf2jH4yf$YOewC0m!7%eG+NpN zPVHr$e>}jMTGHJ!FHe|G_P}*ZpIoY7OXu(ku6t&q4fV~@sJFi_Qo4D)e8V&`SKX9opVMr`AzYnuvao*|+#NH|`ewxQ&dRS~(oNXMk3{FlkXX2qPgTESLv zA>!^sul|=~JdLCH`qXhU6!Ufq7P=dZ67+40=qFXaN}}^lw6o#@jKTkewDLIi<9x-S z2VueV-y`?=45p18SNUx-_SzqSQD<7Hqc{=f8*0R+$9dohfJ z30+_qP7(>ECWthO_yv|>69fqaM441xU?!$F<~m3ug8Lruu85~~ksV@*+vi+&#*ih^ z%$DhF^$1zOlBPn(gyw{$^;B|~)gqMm#U;tsBtZtxIVkRrf!Drsxku!9!6xy#&PKbw zH7bf`v*^&7Qa_@qsdzNs@1`@waz4XOI8Lrs9hGgFkZv>@3%F%xEbZrIgp(!AFO-P; z20(1Kk}I-&zBJ5l!#W%4)W!_Z41OM7Ojp5J9F)2 zHT}slBveHRhkTt}E|h)GFk#hC*(w|XJ6p`G#?UUAJHBehcpnWKH}A}u9iJ~k?5FJ~ zg|W9Zw=mTDS>#;O*6iER{IU%Q$#&u75IZ8Aie{5r7%fbt+xyTP@5B zTQ@+p>S_#1DwYsts~A2i^-kt80RKb=%j)!JLX8Z;X9yRS5L`F4`Grte1UX;}p?l+S zR0H&!>ZQVExygt!BtVJi>RCQ(+8Z+cwp;#bCVj53=}6j4=gjD3z#G2XTQ!CDrWeA# zJO9z3`onkz&))PVF<_nL>;;WLsG2ns{4fXFO`s3%#2RoarfrW0%p1mm^j2~U49ctF z#*EhQ9rz>gnqSn2VZe)9pxTUNaDa(x0S-R_&;;`)NpP*Ni(wgYV=0@r9=jdj zUbiMf+PJaJ!_1dI@-+pns<(0I@>yYA8r@<|L8p6HBU2Q%LJnUNucFml6hTXdQNv^}4FhL~Vv4B@*R`OrBW7bZb1#bp$Us3M}~fS9xl3$3LfsInXhdx|mCdfqPN zQ*euqMl7vlR{=hK77GMAz&Ygd$mmW{Xg7hs+ex4?60vsG#&&HOOB)CaAq@(_4U&gE z>)KkBVQoT%Y;CZ$KG1GwK2M0>_p5QKU~KW)zbk1QCyM_5(<8i8!u@icDjUR7_^@>? z(j-ClVPl})EnF*=<@78%QL6={AMRm064GWurL`v`c2l3jljal2r03br zWkMx)Kb|jC@8eE)n@W5T14)n#P7qbzdB|F~LL)-t)P&bR05M)DUJJL~2pH^`)peim z4=s#n#lD_(d9H~1aSBnV2;F6Cmdm(VMS$&A3KTi%`q3W8zw!JJOKqKWj0ih(maZ%6 z$=c~>Gk)+`KYgASGxgC|V_6C?1r#&~4=)yLTu$$`urSlTHm4pEFB4L*Advd!vtte} zsddIMBl#4%_ipfe(w(stRnt5_u+{V+#xNv=DOAQ*As;U7AJqxf*uMVmb%JF}RI;9) zZ=|qWPcTd}Z1L=`8H?*X*w754hsy|2JmI3pydH@LgQuSz_^pG<)u$t$a0bBTnWh*slzaOWp!fzJl(z!(9N-DPu{fa1tcF~&) zGV#5N48##!`kXe^Uh=1v!4H1&Qp3hD;gAbsZJTp|jgILI+$mvtT~gt^fhu$7!; z<&Y~64=p$8dqvdHqQ|A9b{go~I>C$ydp~LO|2UDiZh0|{`~4&xX~omY{8Ws%Y+xg7 z-oT2-un_2Sp|moC#BS$OX1mknk9e)NsmWj{5{^bfiA*_}%>SoJ+^TD;k1^HY5p&@o z^F!;oEuUH5n87EnMQ53MK6BOi3B*eI@5lUsws&Aq^TFz`B{7t0kaWKNXP@f7wv|Hp z3fKzGZ)D&paJ*kaf|bB$T%y9E+lMq`{*RXKm~?M#*Nsq}tBb@q%y8VxSdAW}z!TO<-r$h{VGX31_%h@!0R31;GtrxF=wFq#NNy&i|d%n3v{ zGRkZLf_FJsRtOMbcY{KLfb-ANg~Jvb_D@grLyUrnSk!I<(;HDx{Vi(_x<q*BRLCbp7{MtxaHXqT7>s;`(H%xeK>W&G$gym=w`$S-CI&*rJJjRg zeicR-#L7QogFjjp#p5L>e%#C#!rNy7_AOyD$hg+$?}mSTouna(BVU}L^jxJ?Z+0Qw zt2ac+a!Xx-z*%>vrD^dY$Er%%W8ThMuhIf+!Y4;YhQ6`>3y5Pn;+gQ|wo35!kS2neTFqRPdU)>ou45>sp^A)@dAqBfXVdF1Ftc~S^tCNUK4W#w zbFV4T*yd$P)M9A0${QJDdu-m+47rrDjFg?rS1RqUVazNrjO~Cf=P{_ZVe?d#lneyM zPB~_Vf~P6FRX{;)VTK_@?2EEiCQ@3c_i^hZe4(Q9$!kBs31h=8>?~2?x&r&7J6boW16$ml&b2R# zEA|<$S=@J`2wDe$egFNIo894}MFQs{LqehDuk=KQ>0(gSC#?g#_NPmAEB8^$S$O|_ zMH@wHUG{|-6$&cJXo(`o;5ZrQ#b|%9AGk_ERg)0M&dajB%bGzZ)m87Ty^@5!mYZ*b zX9qAbUhrcvI%y&Lp5+PIs$y|i9$b0~sCDSl?=6*Bo(Kj_m#rDJ^aUP!P}E99qO2%p z45diL_zEOm$TnmOqMI70kZlt z-oAe-b+r*2=#e0OMW^VUGJn}sr_5_SUwBPJW35{6b>08K$b@Zi{Q+XS%zk%SvGEq! z@$-|lag-wrqUbr=mG}46W^_P9OhDAinVaE?S6tS2EUUYMB^cz{+T*=lyDST#Y+>=9 z9C9M|%sO<3&{as!QyMs@GS_%1=51W)D$@M5E8$Amh%why^7??&*#)&^9z&E6rmnpr z+pT;c)~|2hN+tj~Cgw&lDpqZsy0X^t4VEo6F1GEcbMRPWPz)R44Deu0&VTt;mILs0 zf38+Dskfb}<$P+Pi0${Du5SW3Aq*q_5FZ&47=DjXeps+GWPqje!zu#1IPq zB6zvcLqqWl!V^qhE?k-UqJ2ODZ~bBth~LOrFP?&wkvrO7)@34 z&l3-3gMbI*<@t#z7GrDW<{WyHP;aJrEvX2cmcq5%gl2(KP)oA6x?9 zhX}N7iTT4x^MV3(OPp=h96xdU?WW4r7$MoW1C zRt7|WyU2CnoEgWvnsF;_!3piiYYR_39SCr(6Li_VK%49oxlzuRV<{#RwzBcenoYR% zdY=tvDT$}t^)NzDts zN|)o;tph-YXv8atn@jGsciJ{*Aa^Ij3>PAMm3tVteZar%f5V=R=|@OfeeO)E&Hxj= zrQ%Lt{{8nJG}ZWRf~wf6VU(`w)a%EGn!u!8Wk*fGWh*c+SWjEC9P3$Kc9Xe$bnCbf zSQs0R5*SyLSM5{>h|9!TUHGP3Uypl5fwYJa#h+AUbY&*MDHpo!@qmc=Gk{Euf_4k3 zba2%gL=FU`zL~ek-JJsST4$@nh%f0wLy7+()=XxnRzvwX-G`LsrTK&{lVUhurUz~> zX_uqeOQqeKB`2}g;&#g_AaQ6+?5)ye;0ErK{j3({X=k*H{^iVbqouX)X-6qpr{f{_ zE0tI*YuBp25@Nd(mW{7Ww**&zRn!jXlETmb-;=!ot$wJ7Pj_WL+CA)Om+j%NJ&UGp zfU5rY1h7H}E89oSZFC@=27@Hc-HDpfd-?w)-=90no_2vnhvVmJRhP`GNbsfti!PUO za?}uapKiqmf|tBb$Zs2%jG2c~7=L_o3YcD8p34x~81Uk|xC*Qoji&l=60im?GZHiB z4;RSfWY5G`!r7r~hF%22P!>exi&w&&)_gDF#QrJ?oRToAP|-~lyE0NFqpNE3jDy$H zv(1HA;PUZV&cxJLMKx=GV89t^&{4aHV#3!4Sc!mzf^fkK*|UeN+2UIE0nt`#3;!99 zG<9kUG%M%w#k%u(^;m9)X($7*k)FAY8c-Y4SGoY?qTm>kQW^HW#v3JlZVK znA&U<#40^3f>JnmZa_OcSsdYif_uKw%+Jk~3fXirkxFNBx635r!GJH3&Z1>S`c`Rk z9GW&W96mH?T)BNq8d&oDaC9jws1J%e(s7U=Ot<{Vk)2Efdc{BRvqJ5tu&+4rc(rI*Y$0nhdSEu-?qM#G6rB=x&navpMN-*N) zcaF8Am4&-^Fi##8omI#yFLQQvb9P(bKttQCnjlDlM?OSdi=fo_-dZ>fLqkfY&78A$ zw9>&Ff<^n29t!HT{LtX|v17e`eT=_r*ksz zTgOB^b*x(`?CPDJIi)g~ak&rWrM@4ikRJ(heFXP%wXJi_>1ocEcA_;8_}FJGgh}doA0V#DaNr9 z^8!C6^}|x`ALo-RB&*AL*>hQV7JWj*qMNXS;0fy>j`ZT`q1O)D=^@Uuytc2m5pOF4 zT96qrP3C-4ezQ%EdVBwA>loRLOHZ~RoSl<@KJc}t2|1~ABkHfU2&=MVcGPnHn+qge zFU)htq{pN0I9=}fF!^<9DHq!iSvFj+`?l+IV&#egLpWTh|M|xVLp>SDO!7Q_ zsEL$tX3s)%Jh^B-)5aMbN|mPVBR$K9)jS6l<gBk^Hqyy`vQmu+R zQrdWDv(Hm1w~8=NGIa?R{naeKc8Y_)ouqoINXT+~A@UCNW*3@iKn=QZ6YS+Da{$8Y zHONGaKh1J(mleUa<^nO(xE}oTDX?BHjD4NVO{J1kD4@w zxF&{ytK|(_b}^hdh_BER=(KAon&LdXJX~USmt>R8=CBd~Sa)@})+MT~<)O7ZJj|4L z>+3bSXb^&Z>cp!rs7VcmVREC2=^B$>#%pV1>Q8Mmq=V-vXi zBI&DwYkw=W_A#{zR@>2qV1HS0Y8vx$ts3Dd&kVy>Uc}CypZp1+RvX5{>VocM?fP-` z;MWp%us6WbdZF-Op0auw6+KlZqS772YmUFEw=FPHSW>kxQKEG;QY6JJrPZui5k-ND zcpv+wUxQXcbo?>)V)^c+TdTSFgZq;H&P3#RUJeKSSFTD|cZkJrKcMSR!$mV#dA_FH z^UnL7IASBofnACkHD-qnVTk)`r1h1(YEimdY9(MLX*!i2PN=%l4k62!{Cpv zy>2zfzWC9|!pr#$*G zWqC7Y^B2a~V`Z9S8OL(m0-YB5O)~JlpmISS?+8ZFz;#VuGg|Rl5QgOnntbm8&wbh^ z%?7Z&Ixkj`ys%Y|ez`#NoZ-TwLy5dP zY>kM#+}yMo`}G`)UhLN>YzxW=r+wQ|;&){`H89dfoagWh93%=pc)eT^kQNea)P@FgGMqVi^O{O&@cudrGOB>JUhK2d3H}U zK%0pq!f4efN&6}$*W$rL@uG2-VnPl;jbwVcRJg4 zvQ*f8y3ehPs?ChvGMZ3jLsZbKumOWT*e2`k>D2&ijqN-fPqmtE0bAtg` zIL)bo(CYb+bo_8t{9Q#Lcv1&Z02$XFuc!| z8qeT-LiY&*adRCr$0Ei3RjVq&V&hX7k4QW&YaOlAnQ2dg8#}w7eY1~*aoz!1C>qh$ z8!8F6a_}V+t9(2pxyXKYaZb0uuGt94 zHEX}7F5-X?zX7YD#xS9_)U8_8Jn=M>q&l6GFm10LA&MJ%-fs#S78wU1AE4 zDlmsHiYFs?>SU9JlV3@>sX`SjZKdkXq9AU6>rcV!@rr;^(hVm&mDrzO)Yrfc<5QHX zU|WLxbzl}T4+S)%kr|1a%vvE@cmIJUi%P4vPUnrXpW^91+7E#z;AoE(!QHLI9_*@n z7?Hob;V z*K9FT5)Qusq8RgBd-yCae{HL#@F=L0*DNQNiLeaeO_iguGV-FQxa!EELTatTG4Y~O z9+1^9j7_C3G%n{Vn!mRa{nfBs=dw9V+zKC^4j9QSb@Cu_V}-BkT|{bFyO0Zv5tR5_pfGdn+@jxT*^-@1DD!}Zc0QS&wiax&N`X1Hfx zPdildD&z5bN$^w5nQgSgr>u*?)BuVelyQFdIv*Y*7w9k*1g&PxPCKDqu@r{ZEE)k! z2)iCzu<}@IN+T!|9@x6#pe&M%KOd7gio-e}RSm-(3p&AJMQ7mQs46f{C>%mFG|q#t zwT8x!3H&L=a4@V`D;qLT^L!^Cr8&8ZIO;};omWwY!e5j@R7JC>0-|nPaO8Dq(BQ$x0;z*Fbp?4(BWAc zxin?5Oqe03wNGfLA^PZrjk$Yc&L`r9=sYoP?TZ`K=v48sHP&Q9{t$uqSYi1QuT{|F zNys5D7w(u(6;i?2CQpPjr;qmg3Bwg0|H+q^Qjtr&%Qw&vk?dM9b>oy*-^~Dlg8OPK z>Mj^f)W!{ekF1MxiBD89#6U;2Ep6XO`>p~>jzI+DBB?JGesNEA>;ZPzc%IJ|5BLM0 zn9xX?Cc@kINkdfE_cafF7aUb@LIK2*EJ~#gAQF9!ONV_n3KWt1M3T~7XR)?3n(iLr zqo~A%ivw)hi5&H{Y4+!FvP)b(ZYG~EOr}oKe13B*otXtq=LzcVDoe9llXj6Mr|8mV zr?zi%SgmfN{PK?^i7G^6$_6aXbF_5<#c?sT`OpnnlTlRDu-PHU&u=4XxhRl_U*H1V zhEe$bqe00lvAD-QsIc3;)7FV$!_>Hu*+Q&2_bPoYyuy|*Y4i(uIYwiNSeolLjOGu5 z#H!k2wvYd`+;fk-(pLA_o#_?wNQJHrQG|l|QWr-xlae0#wqYVo^P_nM(9C0*CP(I4 z734lPL>#YQ`>nB>HEz%tDZNfL8ta3gE9N%bDLhhBCxP>pwMlPs4gL3S+Kg(a zE7+5|7dYU*9X#Xp?Y=`pAyiQqN@Re_-N5its)B4f09f5NPF^Q z8u~Ao=~zZ7Pl=b4wOVg3rj@`frtWg5wr(U{CEQnrmN+ zu_`zr%aKI)Tm3yNkA25(48FJgYD)m&jMaCp$1{(K%4%&h(mq_>s$+xe*1;A2kbf*g zr$(-&(P6~jnwc8uRh{kC^B*yeD|HnA z*uhuHxVw@_tft?6hA=imRb55LyPH9~XLr37xOix4kXXuYs}8%#UQ^4wkDv`OHR z884+J#+2Uv(r<3fR`eZj*A*0bqe#1GKRj~G=x6RzT3&loov)W#Za?01n!$0KV@~*; zo$Yl^u0rl;fqgQ3C(DVFJ~ItYV)1G58=J>R(9`^6ac8@pLpGoMhFl8-3w1sQLtPqoh~sHlktI_E(Mxn$m**`9mUTE4GmnI4M0jZ; zwwo1TBLtkCT(zT@HbpBda_Z)820${R_UYW(HI;-87UOEqZAo-2+OdK{756Q}&a(w# ze~D<`FM(j#?>wOJo|SX(dp;LUFO-+^21ouQvhJH3B;nq6;<`k_n`yJl7g*gM&2Pq& zF6MvZ^)LA`n61NnaQdritE0A?s()=}n%}?c^en=q2LeN&&ce3stNtpyU_eppvPSPC zGV#NGsy&_c#;W=TpY5bgXUYbtPEB>H^uipDDGoZHE~7r1U*J&5InG(x%WJS1U@E>& z2qVBJ=$l78?sk|xxW9i`6EYXdr4ngV+a3;Qcb%Qy;bM+PQ3;~LBC@FN9i3iNT~A74 z3P;X80NAZ~F;QgY&F+rM!iOr^+Ar!TiwPl-u{dIDk0u5uQg$5^V$+D3Td{%KSdF;@ zLM4xgzs10fU!op9alj4|TIvNC9EOegyP$q=6OyR(CH9W?s0z!)K~rEZhAaNR^}Phc z5SG&dXhQ;UL!|t2=&9&ai5{dl#G{HAMsJSn4$HZEeDK%~GA`h{sd-vW^t0Oj5p#gJv_WGtfb zWF_(vrpp4#h;XE^rHo+!SNa2SAU0^d_7Vc>T3dO`H z$Ctt(arjK?GSLN9mjT|J@IALlzDGFbw#(+xgp7c zCQgy8mdCUvsAklzw_>N9uK2xj6F65#fF_(k}C2 zhgM)2vDwJ?Mw<2#FZYdJpYhrX6Y~tGwoyseC1q_$*OWBx&9m{KPAN9}@d^L0PT^4s6s4dd*ib;8TDx$<57V3FV3K6VeEZ8Fiu3;q9 z_%^o9a~$LwZgzi`8sNEj2LxMe*%wi!tv^iq?*Z)X-qp*XALallsj4~`sS-#9s$vgT zX%d|7v}70bCu4rI_!;lJ$&&(5CwwJtNYfZ*xOzR--hTsrX@%@`&-|z7y!7+`yY+ql zfwweZKUoRtzy@;3G@A&$2^p0m^0p<(M@vxw&kZ9;niwmP%)aNyootRpF+SY{3A}HR zUi3D2F|3AbEN70L+H%3MrKGa%JD?F=^}VhiLo+}n zsDwOzV606hoPLLK2G$tOr$?<#_{s#W)JPsqROn-hoAYE!dCKo>0$b--9bf=VK(oJD zKo&{BIFN`)0&`RWO6d$FvJ>2ZS}kBSY80($!V6nDlLmDwoIGsZA6f#r=5rPsZKUt} z1$tq~J!Ta}JG749<|D?JWB~>n8vm_84V1tsca{gs&&p5c?7MRFJoVn@PcSeN<;woz zxLeaWzdTx=C~Jerc3wV=bHfrm<$W5{KdhCl1dXz+EO#g(oI+WR7&#l5VbKJ{}2Tm7u6F`p+D7tXgKPypq1><#H zwmaPkU@_}`aY3uHLo}~B>!%x2f@LRDunA#ytD=_DK5|-dO3JH@8nY^Db8iCuk$f`{TG>9;R&;WiQR0{LI&o`$ zhD<;*3=PJZrKy>v1k?tx8Vj~BC6J;j-)1^k9usEPv1#}BH(m=B-D1(ErP3pV)*!Rr zZ(yg9BD5NjK#|y3JS+___jY%-w|DpV_YMyBkB`qTE-x?6jt&dv=DM+0n@0zGJC1gv zZSQSuFFDWa=Kkr$I-BXbtW9bL>EB4YMR@7F0fmKGAMYC22|>!7dLF3Llq~M0JaOx^ zQho+Sw0T0RkcSrZY{UlO2Z1Cg0MA&0Yn!EtlC*6iH909JEMTOorn#jbouDMMhaf;4 zY==0PtpEa>-K2?yp8U^`y8^Kb1K$~Vs7_QXC1%C_U86kR82b0ZZumb+fR18!)b4iG z&_A%V!;R9e-Xh?Oys+T6J14#Cn9;ota4;&!NU~h*a>Y981{hsS==YA(802VhTo2LM zSPUPGs2^FIjA$fwMXz<#n!}E)JuB`3I(8C)1#zGt||&gI1& zI#L|5_2W*AYulcUbfDvR&iemBfffb`jzz+YQO5V?CHcsUINrks*2j7C(*r_LpqZ2- zoT%Jj&Ct}-&=VdsWBGu#d@T8AFTu_Zn4ZkcK@S)%INCU6NQ&i%VjWFw*Yzd2R)H3A zLgs2M7OGT3#>fU+jRF?OH~|U9RGt$>l44a21l=boUlbO1U7mAT#hSX8PyKjN)Irse~qRnGe9Uz#(k&ALZ|Y0FotV<`TlA#7Jm2w#em%pdC7_UCQqh~x?XJW zN^dmt2XL?qTI~A4gMNScl)lhCJUBc(_aMf;0!q$M|K(Za!y+2A^-|n&XBB4f~C-5%SviN}X1l zIZF~fnZsxaE`zutZYIz?`g8TV5Dx}L*sC!NN>dcd0&3oiGVFsJNb3`>ha2FdK-~t| z;0SE!M&P%#%d%QGIVE=3ND+BK(|e2Mz?81&JiVf*wq=+%Vs{nyaXAP*67FLvli0l1 zH<`G&tok0PfOaM4QUZCC6lZnJz?eX5Jl``6G4edw8BC^ZgAM_H>2~bt>*>2Me)#&7 z!?oPpkVxqGSiV;IbEYKrFA)p1Qt*5ijCu5Pl`63|vK~#2i+k4Ii$93;W8P5^)*A~HrZZ^GY;Tk-x1m>LtNN9eR<(pHl*{+B3=gujD^ zHV=BMn2dc8LnNewE{MRGo$X3BAM~0^s`H-C@Cn8XJ`O=uo|!#euDoX z2R6GxTcHTkT}w2*D-klq>D@`0T~sFgLjl zxhVOgN(35~4nT%Qvi+YHlT_3D*UmW-GcI24PsCMAHGr8C&Ydw;W%u-hcZgyy)Z*JZ z9_CFi1(gQrmV?H4Bo?C0OQ4)aWl&(zuFp@puoE_wOsh0~86N5PRduYRlFO{2UO<6E z!TaA1c@OD?LO<6h8P}3yziS4gg*iTUdOTa}$behXb-iNdX2gZsA#S2 zyDaq-GyzRO{$6sZ={nfmThku|hxl2(mbQDgxi)^9J42c+`=s~hA1fcAX82rO%_fz7 zqg?F@ro^d^RpkOH+xN1+=Ufs7W3@|3RXNlu>Yk?=#``KxjwFI+MM_zB zftbPSb0erx-aqM*G{w3u*G}eHj3{_9%R=^ICJZZg3c$F^ig&rVhGV2urK$##du`Kf8y;R;5Bin8|`XFAi>^?)~7U75`n z^Do0Z3Ha@$+Xg;Ze8h!~25-WillZ-4S0iM~XIgYeq>w@h#ee$WPe1?A&ueXqrn0F7 zfo8!*yIs`iINA?o2>WS!y2m2N-uja~(HKv%-~u|1p+x`0(E(9a&YQ^5Xbe)%>E=gN zf#oG2eDIU~5J@px*h4afI@-d~BF;ACvQ{k0}(| zu1g+!LVG_Y>$bLu3qIE*t4=GAsIPbJ0LkkUEjqAosK-cJ7EV0IKjF& z&7h0tu%3{s)T{}1%D<-@r)S~YUBflIlkqk&HgnT|(Cb-v?}z=1rd%Bt^2&{JK)^CL z7YW?#@cD}d7YSSGAu|fLjSN|5{(BNl3 z-%kt9f=xvDoPzlHd_UbOBy1mKk$vCa%=><6 zbZs^Ukp)juqPaecc3>irb0{szX$O+S^ZJM|3v-dA(dGK?PQd7Hs9ZZZ{gbyXw{~9dZ>P3Ec8X8-y*Y}g+ZQ=cTohYzrb002Y=%l zucE}m+zXyuFENZj=JN#_RN%y=h0w>Zn*r_5f8kl2m$w}7JeiwikrbHwdTbIGBTf8! zG7H&<@46u5dfWTIbZsQcj3WMk*&j+ej4Do6w|?`<@CZu4Mnq)c-J2v#@?A2zMhe#; z^Z633yM8;V0=?a_zl%rc_;B;8&8lx{?*%l)Qfuw%Go51NT)I%b@^`i#dmG1ZCR${# zHgh-65pH_i#C=0Fi}sl&Z?(FZQO)Sq;3&M9j`9bEK17)mm)CwNqDaJE6-pzpf5bG%WI&QOxtGqtd9#p_n*B``qk4F8ukUk=>kB@o zx;$6;%+L5?_w?qsT~AeWCAO&#_~PJxs)~G`3LV@~Rf~otNl_bgqm@tPimJwl;TK4h zP_sL#VpMdp4Vs37;Vzpk%U%u39g99@FxuLZ95_bdXRFSFyd8o!HY^wO))lLkyo+*O z4aHQJtvV1rtL}VB%Y%$Q>#J#e=s6vnfgG;U#8=3Zxs|&KMwqg#l3AI&S~}zEHk>@w zU)8Sd18{M(H@}vZBv$e^uA;B;*ubAzB2=~03#zE$(GIICE9$APg(crLlP@U|(7}e5 zsIAeC)Ey6r)wx4IK#-_t+cus4bvxTdn+m2<@~NY1MT*Cfm6TD_<>SN<#}DP9vLSHg zRcxHl;Y>V7FVU0aaABy*{pEfLG}m*^S08WR5xnpI8@kNyZu97tt;1(>8GrPZDUJj( zQ$Kohw@hqFUW!EgF1yKe9f#&*-E`KP;}UCXqB#< zh;o?qso1vVMQJ6o%gx{mDtV_}Es}+Hw{M}xTWfXq2#`^=Qc@if0F$H32RizE^|_bxDDH&1i-pUKnhy$;ReC zQ7zUF7N9^?4ToGV<~XJ@=yXmhv-nou5;n`Flu5_7n-{ef@Quhg<0*z62o-AxDy~tkEhp#CeI&Mnf0&cQJ zroX?SPPX;Fi=JGT{4l0UyI8Lg7a=BL)}XPNG~F3F7)?o;Zn{T|GkJJgxHJ%eXO~;b zo|jA`7hhYMXWyjI;^rE6EL^eUT9(> zpFW4`VV?6cjgF1Yd0M8*UbnY4*F5D+-m54zS(9>@w@c>LEFj@*EwDw;CGZcG(VfYv zF|#f+A8#zwpU94Pc`d>7kHj~3{ zv1bZVe>mU^Rc^byuCsxqNo{cQGO%I>9+lu_-hFsj3AhBVN8yns%Wxod;wEOW8#5f1 zva_5zQ1|G*#F;`57Sz^N&N7>4Z)8C6qUvSp7t(X1Wh78+-1GdLJU@z3QF9kUl3Q0L zUpuRAB_J2fl7S0i$LrFx^OocoCuo2dMO_oKEcx(oOPa-q?YpyB!#m1bXOQ~RDVYP4 znQ!i&hvY1L*2$E^ERnpjR3FH2Qjz^@8}QHug=9I)O6FejGPtpKv5*IF2)eZ-)w^CQ z7r{0q5CVz!o?~1iL#_vzl>S}m{{DNpAVoX@P)7!%BbTczE*uoCHRL^m`@h6P zKQuvLf{k}vDL*Yg2_MV)zhvgm%UeL+U1#-|@O z-@=*w#}m$*p9|`&Am_&4H@F$yD8YD+iE@nE7%2^xmG^xSA>h6*0{%^vNHi1j!MhMd zhfsaxS5QsEv_wIWq;UWz2yq>tYO>?HNe9$Nv8;=V@h7r?(_k2mnd#L`ju{6M#+k{L4M>`QlUXP{N8v`$M9%GTCx+k)zlblXi?OB(P`7?`sgpcd?R z@nt5VO$|6AAx@Ai%L$?Y`$0s~+s{v9P!xCvE3Iqwo|}Fw45oF-u{qYY_43HY^1=b$ zEH6H+==x)w?$x67H0WFp?>28UC${aNJPx8r&s6Z+Babz3xO z8A#9a5a8ngpfp2e5FPlY^cBbQx{=2z`NGrS%pG8Q*C!W+8p8#-9JBW+x_1j=Q_0r| z?&@-wRaCh2_YV=ktp-%kn0{7n?!ZYk>{-hTGPmtL^1QBZzH(_Gpb2!oc~z~JQGEwV10gfhHY#mC+2|j!NauG|_1mVpX=aU1eC+Q>Q6NzbdgxF|Rp#WO(JzrAQax3;wX3^O zL!tm%7Bd|T^c5jkFpuoBew#*{UaHK{_#o)rY&I_FdEgTw$+BP&aU!1to$Ua}&_y6) z8#`7YWz5~o=3^DNtD1^i=LtT2yi1x!EXFrGw*+V zuRd)3-**jGj13D#AtR25fcL-5qN`zk&{p!sebdP#%;#KPUV|C)BTx6~ubeP583?)833!xCwAa&L~mKUxlw(Es_P9TfZ zu2?cRU!pZrQ=nY0-=4a{fc#MV7zgoEg*3KW;N6GGB+*E8vb6vA#mwu2b3N4`5|g2g zo#B!GmKa>Rvvx;zVlt7AGmGhTr6i~`K_HeFygRNc?1yE}QMcv(m9eo=j?Bm|p$ z+K{ffxl(>crBXD#k?%TzEN7B)YJX!QlYjm*k?X^SH?UAskdw6o5&bAN4;lggkS;&vh`3aJ29SY1b=lwAfP1JL>u3$Ed z^oiD`F&qnd+b`X$kpxI~Z=Lo6MeyH51q3fKktu!tD? zF8Mc^nABaT7?x!;4`>wR=GC*jdR?#%0J}kj$KHQ>fEKDG*mO&ij!r(^N^BsL)^#T zz}(xH%g32HgQ-@7!tnE`y`NNd`uno?~VVTvUgJY?bJrH0Qv?GE7ni)wzjbJqz<#QZo2@5|IL`(*g%$@K`TlG(gQ;bxB zTLmHX&Gu-aa6wsb1B#X&S^22(Ys&F21^JZ6>Gem0v6ik54vnPuD*ez5`$|oE^{eRf z?&xf>P%PdygITj~Ua7vH$>??vdm`74t0g{JoDtxdh>OM6y|(Mm1r;>?X=#v5D7`X; z3`O9@OuqYQGBJD-{os^&>G-w6MMaXS5;!Q;Y*qjn%tTr4#B}D8R)ulo(pj{S=SmRh zkTh};F6KFsR?9;sEP?gFhJ~{)8k$Q^XUb!+>0s`GexLu&>KAMPX#&Ytv_@6d6nO0} z#GaiFhsph?!5Sl4zUUra0}IKRr+T84$!9depQe@8oNe`A|Fn0_o~%xo?PEvmkGnlk zY&RJj4-0R5ywOZLv!sB{(%0=qN9ha z-0>p93=hg(n&Y=)!OWLG@z3}Vr&62KX?yLi5@#V`W6{)Wo%mYMa_-vgWezIVty8|+ z$X=gM+d9@C&Pr14rY+(;dL&uOXz_hVuEv6vVQa9IxD(AR=X2H6n@{Zub}{&FI94o) zr0DE*aAy~+&MesNrEt~Q;!$m&gp19}p6W*2Wi*!+$KPlsN7VU7BQucoGQ(*yBC5TE z#B=m;aD_itD927)&bkLG=|&Xo3d%wPHWwtCtKDhyf|GfXVR&aLOKzTWg!`>A4DU(_O0brZsnc`LSoaxulwSc9#7PZndO~@{-M!D zuv^$9yLCA5*S9r2V`snUQb!Q!IqS-0W2gkV4>`v5v7vCu4_H zlc$lD6leTdk(rfY73>nuSOzo#ql+O*uRwD*BEH5%+@ED7nktnmJO?%1;D9&qw(-*2 zCzLtKwr!qgBW*Sia-Ic9Kn+~wb*3F*d-LcfBbXq5Stn{|F+;eU#ScFAwnlPTxa$HO z&9UJKj>PdO+M7qvCfa*obJ=s|13E_spaT-<27%C^m(n^!6fJh6JOx4HmlD<88!U5c zeioJs^`!dgS`f(t5YD3Gcxrn&kPKy9hB!x7i%=YGew8zHL4-XOv~Z`PB4$H?x7H^D z&*AnT(_4oV2W@a=&&V-k+j-knf;^?yA%hQJK`H}r2W*;7!D`4US502Elz>)Gb zTdwdp@D`HeMn?tIrp*ek(pZjJg8y*ld4EF65BByKtyF&f1KxUC6(){VREIMliQmlL ze&88@bw3$Shg%$U%+eyTwh*5>tf@-xpZ<7TSSj(U2YM^*1bl1t_}%~h#V1duYbI1t z3=hMhyy4rSn6}#xX4IT}eyu7z#{%VPv%`7QRAahjnzrLPAyK@n&%WVsG=UHHYt#zP zg!$qSEsJdSy5BOY9k8d@QJO4PU;xS^;*d0}s)_;;7^-FtRWx@oRTtreOv|E}MeWKILD z!jTJlN+3p4yCUVr%@v(kVH#Tm7#Wa#HSJm*e~RP5 zELc#$kkJiCn6x2-Gn<;iVZ&p(UPPAqW)#EhcbqBRlWSxsNt&r>R-%Da@D9h6y^|?A zK}?WD&yoz!QV74sWW=KPv4L1V_DPIs8RA^nor^6abI?ybepg1qsVI6@lQx|B(jnq* zDwp$R@bet| z4HTbPGu{9If{#kychGY#2%}Dx%_)U#HnrwLidET#*mC|N4q+JSyU<$X!eeNqkS|~a zUMW{ltXe9TPStmj_{}aP7_b5UB;J0jZWwOGE=Rw!_0PG_mT%sgsvHkBr_uRD`sF{} zE4qN{GzbZHLz~}Y(3cv<3k-}hq9@|{+QvjGvP=ry8Ur~I>Z!NJzW3#@|Is%KP}=Q! zHC)Y1%kw?gc7m{E_iqLyfaPW%fOt$FQJ$2{Ov(|KXHeA}aY+)G7+spU{>H+PWheyj z@bJx8eub9uJkhyjZyKBSNJcx+qD2c4?bpz8NHP&%1SZjdkv}YA_|5y9hnQ{l?)#Oc zV`1^PE?}V?jqROb3o}NgnPF$7^ie8DP#Ar$p83SFQi7~-7nIf{8au=uejNA8Mn7CI zM4J%n4_$JD`XLm~GDhQn;kDVQ9FmzQjeN>V-5n{0FWY;uBT$z{W?nRHpQi4Mz$<<> zJWgFzcL^Lg0h|+nALal-Quc5KaB-o%HY-D%x^xaUdWp}dMM}AL{$nEyA>-1yaqH^0 zeu`~TXM0FXoQayecoYz~)?;g@<%yn}d;!6V+5Ai=E5*Q2E;`1p~L4)3lg8ZWg?YqQF-oU`oph!B*P#oNmMUdCHB0{W;2;lPbO2)K>eEsY6r`HL#_^%Vl0p> z8Cg2DXe|8-t3{d}IJ3}BqAZGmb8!*P%vM#FH%<-U#>%W!cS6P*K%e#EM7{`vg>)iKlVo$N)C&=!MFth zbw!kC*|6!@2J#u{WHi|gf*JjPwz%en-!$Z}**C!C&5?mj{+BJlANaq$iZqYR4+q8} z6v8Gi#OMY%)-?fgj4DGz|H*R`~OSf*s%La#rBE7rWK&WoS1`72e*pXHs>bPoi!!R$H0fc3xs4cD6p zjQcujPpOcF{`fYTsp`*m%JjW&CCZEY{~OykBkIyfVNTldkXRZytz)Zk=%pi;71^VN zhGsdE!lFzJGAO{Uito`RL z5`gRhW2JSkONP1_YnuZF;unAdk-m|bw9O0T{&h95F%Sj{$ObzIQyo`9dqCq9IYw4x zX{tkEDVm~4k^#BMffd)I%vqG_GF(9fTed|?rRD#gYTezZJG?dCdCyhs*Y7NQ-IFr? zR`TiP!XE}thtJu2$~NPxqzK+Z%Q|?p7;0(Z`WfLs2unH;jIn2iLRgb^dOxX;8jNy zE#k?-+|4)_P<$`|S2-}<0?0>3na}*C4MY){l*t}029BagdJ}g2U~+k7mSI`igupP>L!w%w^ZW?ZbRO9vt@@`K++O0G!GlA|QTB*=_;QK*%#BvPDs{N%B z8Py^MUA}}^-v}JWcnUBanNj1omrOGK4wy_aHy*{9bUoT3M|J0_%fs~Pm2~u@G0dlF z*~_FA498>bJ@oR(V2eEJYeMl}QPtqlvYC5~Ya7t19g7$YrwlF9~; zeCE1c`2riMw-*U%w|lq30;i-SoNI-&YxQalX05v5Q#&i<4gcZFaeT{Nl(d!j&R78X zRWczMnS(+-Wiy3aX_HKjaC081p{jr12SNY1^v$V{UdTaMgI}0YVz+ClxmQM5w2;eJ zc*|Ew1>RIQ) zhE~fCt_YKnQH-DrlNHhp?_Rt7@hN-p+3=B9EEWKH=oh-tsX6=tNpphgDtrmmgN+(z zeT=47IIkIPoMA^i)I@QF4>URgB~ zgkHT>Sq0*{Fe;ju30w#b(dw`Cj1@nj-AQ{=VKwZ6<*?ND-dj34j&a&CUND~X*l&79 z8=P|?R>EXiw|&1Agpjz3z>w{Ttvk835$RcGG)JN{q!+wMmHRjRQB!3e<>61MBpNQTr zRbM>X+_+%B8r5C2ID~kb^XAwVVPnZ!Y%C`VD3iZWV<$ePrm;uMF8rq(m`3JSRMvL5 z9k!8%0`;IFm8F8s`o&W`zilVLUYdt5yF1LTv>50>csMer5_{oc9OQLQ;^&M=&Y z?Qs(C86R33i^0Jr8vSqj(d(~8fZ_kCOg1wMX8(ZKl+~FRQJYh-Fgq*Fr^J~Mt}?04 zx@hsW_WLnE2Mc`KpPn{La@5pA`IyL4-*~L^!}jp!%lhN%Mh8mn-%GhSe!RoS>V|bP zudn<_-6^KiGYkJC9%yPO{cleiJ)>d!IV9*M^~0^*hj8ONufZk}fVW%-tDubYFJPgM z_^(U`DU>P%MJQG-q7|CPs)ZtgWRd)Jno_A;uAnHOQ*U#Y`Yq!jpKHcS;p2F4a2!+IE^ubO7|)vpM!i(y$a>`v?m$14G@wFG|REjjZ( zHg9z=j*8;u zuO(Zref9_-!RKvr7pK@Lz?y&**N~)Ti~wN!QW^(vh%R*85UyyBVRYU|Lr>pR*H@4A zhD>t4)V?D6hZn{MgLgNdxRHj8Y{k9Cu(&Eg<{#3crVD?xbRh(eo4zle#aueM7yExX z4LR!eNIG%kBgCFq$K)|d*vx2Gh01G_^(J1id^BhYttSo9GE2_F~>V7jM*}3mB-W@}* zmfH+>)VWEXw9U0d7=RsRn-;cI{t?dv!?VV$?Fe^~Y00`)b+>+&q%lV|2f3NM3E*rB zx;RwQ5iC|Age>^SK2V#x`S8wr>dx{mk8gbW?hho!q&{q(@z|o>8z^3|o_s2KZp!X^ z{D3@9-oGm-S*0!TU$}0+i(lQ{91R@NfIzcoCT2+9>xIgh)~GJI>0h22ChIp^C&2Mv z-sy^L;|B)-bRJ=-O z1ZYm8t1AEkhZy{e2ZD3+*^5#f!zZE|1VOha@pg#-a=M9~4(>^%+@|B71GQif$f&Yi zSo}BbX6uV)DlTNvs9tFm)w08)YrfDk3{=uft&B+HNs7-^E3VWd+#?&_rUdZ@#uCA* zCMje>m{K^_E6Ozxfx#R%gVlP|(gr9toBmuO%UxvZ$idgw>K<%25HCH^sCFN_laV?> ztK^_qZ-H|a21+hja7HL(tIzQ{3mE)F4hsP+Sm-U3LoV^c$OuNckwSx#ivJ9^SkNy8 z{RxK!M9punOn-fDO1DK{vYpSe#DFGuuvA?jahC&FWW{#W&RMb*|59)<+8FCY4mtNZ zL;z!{nVi<f zfVF26S~S!G!F%N^V!zZn;|hFy&(MHmTH~T!qO2*}`T&V7H>9jkT7CGeH0yx8^%k1D z-*+ng0wb}=LT}5hERd$nxYlv@YoYE{MBe?+&wsV|wp=cEWyIott$q2nRP<$bUpTus z-VvPQojF7so+WeDvLDP#v-=BlS0zp1r}ky;L|O(`@XR5L=l5Hi!TX{&exG)y#9oYI60*(GI2>W39SzLnKq;FFhEjo( zr}>Q%)Mf8emY7CKXamOaOQmxZ7t;kNfp7f#sSYB>5BYjCH~A!lr7UN+r!C-$j$g+BojCHcY!XlLsDoE)~25$E-6&d9wJ29!)i1q;(j z#thd}=)`29_c1_8if2}U2+kQL`*@_RpcJdYhWLIJwjXx=EKNLeqC{XwZm8l+n&2YR zIt2yf!3yvIh2_466VkY-8OJW5%E}}vvdM}ZbO#O!INPODcJ z=$6JXAh8HUDI_6%r^287z zV(@|_=CSsJAVc6JMKct^kY_qMQG^^zzfvVwRiQv8T@3&gj8j7JLAj6vP}CSS7M2~= ze5|NzAqvL1^5Hi+WfjEHQh62(lxC*V)^c&!Icubk7&H6|qk0|P3C|;>MM*kYtkt~? ziNhE{HNbtH#-a}<#|WT0a5UgLh;xk;XMH0V%eC1*e?WjzP>7^+3F7j{jZ^J6h^Nmh zy6^%TBBnOWhCh*)fqs$k17)FHW&nl$|0D{Jv_&%dc=4RnF&2e=S@Pv`_!FMT-kEY5 zh%rS-1o9mn#%LenD^=-=B|=PhF{HM}k)*pLMgpjp?iEf^t0iM`6VNn!xTz=OJjEHZ zMl8dcrx|aFqjMm8xB};}n5zLQAOsfY$=8V_DKMF{f-GejjijrL(w{OML`_Eo8cYY$ zf$>EQbucD?zNDPiZh@ax*}jz^$mSAvo4k+Rf59EBZh45EWZ8c0zMV|cY%IMU}xpRm- zRyAc*ViOgh@ij-j5*Z!xY+4x!DMAs$UoM@X=G+L@Sl|P+{ffE6S_KiC_P~ZqG zUBpm4n#D%ncNYU_9#BOSGYGLM>d#Jn>W!lduMN%&N|q%vnX|GWWVo`m!#fd59sgUW>;IM zHZNo!e|%RHeeUNoxU_L<>BLkiDe&AKEgtlGs!~(T9MkR@!fN-9?WjbBFOPEA$T5!7 ziE?aAXW~b0MC@Xet7zx|zLQRNb7i4p2)YCsh1NiIXghQ*RM|rg0S#j!!hRwl7yZcl zM|Mem-iRtZs3$qh%TU?0ZkAtK3SZi^FgWbO1Vz^yr%BKPc=FVAt*xGt7igB{=sq{- zl@Vh>PdO_Y`;ExB_C8gpa|NU%IV?(3qnVu>6^y2YLS%WGW_c14bHXj+fY%a|ws1m9 z*O)^78co#%UQ)|g3g4r98nYgd56!d1g6eJ*7NiB^J;v$sKnzQ3K^a7Kqd#ST_!m!| zsEd-EpxUC9Px=7NJ30sT@67ExJfNYZX&f@z#7qxvsDzu|_tSOpGUktGf8p=CiiU== z?W;Cv^wVEaRiFS1%}V-0M8U}H82|8$DouSQMjRh~M0bxI7MSy@h`T&1J=QHX*v&vS z9+Y*`JIk*2eW=(~XdiP;fk0fX88AoD6hW@Qrw>FUX`R4n_z(Vq4mi!?OCGc#oaRK9 zYHH+4dX*wd5)-1T2peie9hGm=P03E)YqFLDl9SF0Tx$$J%TmHHLg0*>Ghx#Sj0r03 zA~wL>$9H7fK>Fgf4T1p;zRLw{)?h^MRbmSjX;%9dzqw=NPwCA4gVuHe^!dHFvHG2F zbh@*P8GQ+GaJSQey}tky7NfFbzdI*{$U!=*N-h!6VW^yJb2C#ND`$6a&;p)?pU%b91G~Be7P%c^NiUM~s3J)O&-1 zRN*8je){;%#PMzC~ywz2k} zW?;FVRHEx3nx|h#OcCF1+*M^Ez{^2mm>Z00XEDjh@$MR_Wcc&2 zkvrv>_$<$Bm+xQo(^DM&56?n-63+h8!LO|5OSk8>eVI)(q%1eua#vw^JlXFw>mjoK z{7gx7pO0a?QBgFu@cKdR`m2l-!wh*fEoIg9UPK}b2h|EqQNO)}kJGqPQzf3Sx-hvm zl7cS+)BGGQtFtOvt2_yGTZdIt4BD4v882Qt7$4g*x(%#J_HUvqb+33amk zGDt&_^_FCPJy_!teHJMOHC*Xq=}!R#{1RtI#=w6y2Ncyd6$^@LL(7IMC0u!No6I7~ zvjm4CB_KQ4rYi`jyQSi0MniY2pqcsFoBy;G$GMGO+TJ%No^3~I0v%YpsAE1kZ5Q8_rX<=~T_mx@Dtc!J|7glYa%kyej4_{RXXtNT>YUNA@{xxA$H zEKq4FgQsw&Q0t|#Qlq0Ob1A2i=`JlP0bM#SM%gu@uF>i$CZSLU?@c#G*FxyQn4!Zf zGIBA9v;^rZcXa)yW^d)^Nc_n!v*Iv&QgJ(1L-XI<49Ai?+m^-cQ)bglB73+NUAYDl z;f_>+d#UdIuhe3DrA%Xkbm7KLTW>4-O@?z9)sa~7hja!x<4qYzlst}KVkzMw@hfJX z8p|o@^wM(cmvL3nSj@z_UPRt>rc?qc z@1!}l+xUtAnKqK?jQR2(mAkKi>Kl9AW>!t8=~8p=pvB#*cz>(+v+Y}~tfDMYecs>i z&dTrv7W5>wohL6Tq~H#U*R@1x{1;`#*DE-OcHBtc>#8T6B-+Oe&{?>rN~bn494w_$;N&o%j9vs)@_SJ zGfeb;Wgw=RXy;g94;#-;;tkRrs*llh%c_#Vs@#lNYL7@c99dJsi;CH}r)HjPrY`yt z_IBBKht$Rmqnf*6ce=ybE5AkUa>7p~7 z7uFA68iuD13m!m?P%Y5 zv%`hlKt^K}_QE%C3iiTYExyNGO{T)x(+k)@qLMTHU6z}el0KhD=zDDy=s~5nsLn_F zfGj@Cezc`13)-4dhve9>3?MGGxVchLFAg;7+XK17J(MRgwS9caX@KtLUYYqs&VM%g zir&6lTAj<96N~4rOeMxEoM3cH^}RGSbX$#O z4w(ZtD%wA;`w6|~l7&Cf{!M+Bd$h~B9KBuj~!9 zjeQODWM+F@Ire4);8;ofKzyi4epMhBquRq|2-3J-c^vG zXfq9P^dHr|rT!b9j$Bj+VdbX2k?zM%*(0*!i1Wo68QqXWEm$6?5GU295{}c}Tr<)b zeR-or3H8@_-mZSXUzmRR!IxfAGcf0>jqq{mpB~A}+j%zPDqTz0$703khZ6l$!|&$c z6Oocfw{rZVO-MMliuz%0z_!@VN-UZz{9HDBPQ*gML~gb^TW=%~wo&)IUchaq?#clu z3Yu2ur3qv}vkqd ziZ=M7LS z;krDTIYcJI91_n$$eK0oY*zvt|DrNLvxSEeu=Kh9o%7qC!jENp@NQ9q$U!?L4GW-+Kp=f9o_pMLI~FUzd<{Yz)bI$tYT@F5*tWj{IZI8=!O zUGnnOOg&TT9PI7yxsi^S5)!1M>0aHVJG4@DIm%Bia*>@5$y&zJjxNvk)$J%IN{L@` z*M1qwNV}vc8FhqTVZm1r4npT(e#0VB9MH}ere+agj{G~8v6HpB5LVLBW>}Z);ThEO z{N~~l=Bu+@>V{f#n4B9+UY)3nFu4Lsw-2PEHs@0EN5l1fk9QcBWtQ(qk*RXg=&>Y# zf$A+|TxwMpK!_Np*^6rdLP^4-vuw=4gcgX(Kp_na5tCO1D24a_ZT z;@T$7JE1az;&5jNy=iv^{PB4KBtjpx!s4H;Y8P1U+`qhV<<ML%2#`7R}N z;V4`W=dRx&b4Y+*GBPnqFCNeY!hzW{db<$Z=S{ZXmi}2tR;rV29s+-X;uC{=35!*F zmN`>?^(F?`+%?uu`QU-m6MN}KQ0FO*Jfix~=}`i1awc`aE^&$03A_Qt(=i!$#)R%k zCe@@3L({}S(2av+maZytjap|2tdh{qR;+9~tY!ch<2DB|L8$x7a~N!j%Cm69^E#PW zB&|heq*D~qvmoXf)s0IE*A7UQbl^1~&WucGJ{|kpp4BPO-Xx@m51HowKNg(!tX+}u zei@9)cj%jwI%I=5jv?`KG0hjqJ~Rh_ePRdzT8(J9$vP*)MzdMYqjl5Vi_j~xoh>#; zM{53cxo4aShQh<$a`0q*&(QY^KwsLZ7b3@g*sY9T8_X0ouJ9ONQ= zo-)UjSR7!9I~2tpzBRt~>86(tedWtX+}zOPYp)8Mq5k&FbN*hzqINVF%g3#*qUQO? z_gHV=gp<9^rv$ilvmvTL%|oIGD}9NOnl6T|Isyj5#v4Q^IOKH`3Fh6jEviDfqw`*AodtdAFYeECW(Xrlb1An62S5TbPN@La1UAS#HI{nz94I zpui3m`+};cQkH#_FGy(f;+4(oV!2a3!1b^oqqeMER%~FDL(Tr$ctq-%9)?J?9#J0_ z5_NDqYaR+Ve|dYW=T`MP1xbV$&PfMKlds1ldv?i-?h<$)ieC8*0Px{wuO82mE*hI# zW0l%vmaXw^QyE0wKxLEkgwT67U|IE(-ag8aaxRMb@d3mkDdWAwgHTykrkOg1ZC({Xs? zlU^U$lCc+586Y;Kr&3}-$Nx?FB%x7YRNN9^61`xQ8wdLE#+~FcXti3n<0tHcQpQJ; z2V=7}45y*-%wUHlKBexVRQS4w#9UO+Q;Wwy- z!@Xp8Y#A(lZTJD6>s#;l6)uy`+p71M%jkO_y=xv1CS4|@U-4E=_WwtgcEh?6uy zN#}TT%NOk5lutokRF-EHw&VmTC=rp@wtl$%MeTpa;DJ}q_OYa!w;FsoJsV9((ia$H zSRsKZn(Z!20|zh*{lKeRzmYyiGw-f+w~`Lv@_UkLSx}w(uBI*q`02(|&B^0I59H{g z2|swx)O=`oG*-o&+v>sd(*zUh*Z~=>AV@34dtsP5DkEl<;{ii33NiTjN$zcjh#n2% z`RJyVI4$f#1a&VM15Qde6RUP(I4cUzbM}z$rbOlLBI(lNy_d^Txl2Xm!lL#Z7s|T; z1VRAOdN0LSs7K#_`fvlA^1sz0w|&>Ey~On!N!Utx(?WtJ9m>_<>eOC$D}gMmAd@&G ztHp59*l}EBGT&Hmc5p{=N}Fr&(< z^{O=5b;IXxUUsf@nh7_uwP=J3v5T=y7s&81av@ls@1I(+i(;HtwZz{QZh@u!mZw8| zI>t7muk$eq{2O?FgN|*VIuq7EL^hL)u{v(@>#WKB^VM;4RElfmx`qpt%*Ts0}#%V{66h3_K z_^2_czx_0Ivp(qXwy{5Jo+SDI*Fl8U-d)h#<{oF9?2b+&=R4Zj)W%MbL(ks=I${QC z^F1@8OtFP#FcEBd9gCNyW7_0#H4oXn=U=Wny}=Io&p)B3ra_Q5SwdP8r}G)T`Z~Q8 zuB$=PGW7(S0ff3~ZR-+}XKMB{vTJb-U1g<@?HZVU@+8vh4Cnz21UfnbH~r(39kN9O zKtQ4Io}HbTSYpv`4GG+0m^Zb-l}E5eIsBnGJ*KRwAp7ttJ@`tj)w_r%25$9{e% zz3u&M%HbFFt)&k7OUf0G#}bKLE}4kM-Bxd+wK)<@wY5^jr;=Um&6P%L zu(j_E6@Vupkimva##N|L&LhTRmayEBv7*`IVAbrH>CzI5g=s{J^%_~&$GT3_Ji6ZN zHCnV%id%}B&@{(X#7Q=F$eP6S6dE^bysv9|p6S-gjm8yz4N|5UjtA@BSG>?ffbeu3 zunKIa4~#UYjPLc*xPG80`f8ikn(kuuo-od=q!hRr?6GO3i~^yJ8OyOx^CQ*0nFvow zGEVjSS!-`O2Lv5jDOB2VZm+k0!&5gqae06#(~sxBFY$)=+jf04a%6=OHN!!H6YS1~ z-gBYvg(U_?cmF8&o%!^~-D=fTnVWFUPfmsxz-DPKfv0u4QmTI>LfApTf28_lVYZ3o z{D$g2Z@(Hzs|v`RVV!f=1%7-==tM#G!LS! z!`FHOg?ciBDGD)tN)P62ner{a^y04M#T@Wq>nj>%c00K^cUa7?iD6~L<=m{A`Y;b{ zu_DTn!j|uNUEV}EG6TRo>5W9jP%jsoecJjjs7ZSH*+#-rPPN>%F7+}rDR&<0FQYV} z5%tahcsEifsB=GAbTL;VOfpr<>tRV~!dSt6A@?z3w_BBk^VaJf9$6#4;}p{o{u1Md zubzPxuz-a~_%Ha7LrmMcyBN}DWmS&f1sR@@7`4 zq;*~Pnf|b+qI&zs-fZ1rTP71fYwWD!38h~fChgghIAxWnQgV(;o})>|Q>8S}X90-I zoGb5deBwt}q>jfAc8rr#gCPgM!AqI=TCAkD(Z|*d{e9kdZ4w+i^;vz@@*m+kjxz54 z)90V6nIs49%CnE%^R@-D4+on5$=bX;N6pfZXy=FsqfDtLvxiu*69OhSlzM}bR<*jr zKqoAlS6)KzJ&Np1sA8`n((412~h=3wmr{P$zYl@hMugCSga;=F`F&w zLq}d#DvB=21caePA_HMbkJeL1@zL{{yKOQ|h(*n?dj8^e{J=3ZgT}|#YsT0t@^I~&n4;30(~euJ@ zK!6|!8hOANr_dBi2~dLb0S%I~Cd4OFrqp?~uo6cDAp0Nv!ZzW(SzccT^q~-@#vtV; zH{2aCBi0WW>K=2-&$c>y0%G<`jz*0vmSQtLbe;uPTr<3;Ax9jaJ@sW7!)6iYgW+BV z5)W0A@{to-rcH2CjMGMcs(@jpS@H{T$nW9lnE2Udr`JK#GsB9z&^@`*tFkCYf3Uz+ zOII{Qcpf+Grmd*hvul1aOO0Wo?hjn6g)~Vz_((r(bizec-xxh1cLgbsW}I~|n~K*3 zU22PxUz@*tW@ab2`i5pQgy9n-MGHer^MzKyeNO=`BgXm221DF4UuNS;OtLx<0G5@3 zcbVoM1{)iSsm6?G@@$jhiEA^lXl(8S&yO3LV~QffbldTQGmNzBv*vl9NSQ1tvW!I5 zvJC%6z_m}YIxk4UF-%&NS(BtO zDO0jPTJI3Y*E^m^Q6P_c8(IV|u^?kIuzU|mcp4%p_D-@a6ck1MGOz-ieclwa0N~ws z>6uZE=@P`~DOElr_aP3`>ql3iGQCd^VsA|JJzE|L2cGL1;ou5k;nKs2cC84!Z&!~S zd}(V`R_p4Fj5P4y5ez3g*?)#uNEx6X)ifycJojZF2FAKNM?x=CD1K4gQSaDat~zvG zp8ZltgPh5EKEAL#*6_0OoRO-g2pmn5hmqP~Sl*NPOdy}7>{P|ry2XlN4*B;ms6SfRHzkJ>^r`SYdb_5d9OqSTw7$BU%!Z@kc;V2_nwBa;FNGL4bVA#| zvrB;PDhb(K5FNM4lkIRnFtqt9tK%25a5xEKC(k`|)t3ydjwDA{c$4G}>S`mE;VrRb zAZptvx;=EzR@H5=L(SL4hb~w@+Y;FvRzq`1XKCmtu2r)1? zmY4V{5lxZW&^1L;Ka+`FDZ5iKfY_Hd5G$5JcL8G%bs^>Nmt>Y$hwKShW6DU^cm@&s`6sBh}ILc!v45t7(ZaHCi9@r81$2 zU0Y7|&_zep^1yCm?lJGcJH?U3sdx4a92?Ui(R^QK8^#LGPy{5lgrp@c2gR>uQ3UNa z0@i9xt1Y5F)f(d%kM7=)yth!G9TVad1yesMD3X@69Ev>ONB|y7+P1O_%U}htA=4#Y zFR7~1wm|Dyj5)F>n&p`m#IKA)uV)yRD$S?C>Hz>)(}fYdw3QpY$w6%x5fFH5cb3!b zu&^|}^+n_4gwf*km^(64Fa~3q7hoX_%Er%JJ~Z`d{%#1a=BT+*=6Oy~7R2fB!l3{) zt5=vTmq@O@e;ai=FE@YvwSSEyW17qnD2kW={rQ7~BYJNH%lpTol`IRwP={U#hMg+C z+~nHy&#(OFDD1Yf53eGUtQ$sxZ92mU5*g9FDWVpl`l3n23ym5$`*p=}r6@9)C@$y* z=u|Z#)oVh_FHA+EXLOA^ZR-XC0SqLR+g2*b2XEqmEc65GK!2KrxULsi+^;Y|4>Bx6 z8Lc3GWh4$=qbVA-9gAj%_?!51O9V4;T~&!IN7z3_3gkWugJK~36+Oz^XfVdc;6 zEbP|ecU}=aZdp-QfhVa4o7L!nuPk z`IvRV$p}J{I*_&)2{4C@6AQxyV|EF@vs{b{*-ri-#xNuS8{>Me>sM&l2k{cd#=<%) zw_HQff+)+hpC->S>{BAnV`Nril5AO}Ibu37IU))HKsgGl7}j4Q9ILHRaX^QYm0MQ= z!D#a5F21?*R=*7E9AHFP#Mgi0@^?sCjl@?ue{^eVEmq#?nVTi(0}Qjd&B780_qFa* z`!E|E-ZBqQwZTO2gtr>&>pHJw8WUGnG~xVj*MgS4&i2g*zelJ#!rF47m= z(XX|9Fci^6&}=$=HfQuZ5v###GwWx8!z>xYrqNp0P4ziKQFToasOgxMxhP054Rj?r zX=0jSO$Y1^ZMc zyrL2&TO7+O%@|XGnIW57^hcFC>&Q{KPJ%QCv9*VzYvG15w?XE_brxD44sK@WD4SSQl zUN5?s@LWL&)isi|(g#bJTGfE!eGpjeYxdp&-?Lnc9j5U0N4pIg2Ii^3Vd(AKS%~qW z5<6LDh0Su(_N!}91_Vp@iA&}ep{)n7PLUDD}vp6wv$hNcJ27&dmgx+}$xu7Is= zzzO@J^Rb5`09=+;pb491C?g83pkfpF3+1x-R7h7A@p^$yYY<2fuzr2-bk%2z0BF>( zA?Y~imQ)-)&t@<~v<$*RG3ksFv()Y29w!=;rb3`48GF2*BwW`6QDi%iOY&3VK!A7t z9kuf0)l>~%`W8aikJ|7dg`SGZ!<{tK)(uHK|XIUNalm{THdK$q2XgP?gVGp`3lH?qIk_ixP$NQ@In55 z=AAg}1v6jUC@C2PmTf_$6U~9a0*}~;a5RtBDM}`4-3x+%3$_A0z|YgVcxuEAxOCUj zSpGEs;!xx%2w9eAX^LNrOd8GR`h5_VM<}~|Sr%l%0vV?&K2Vr5Pt`+11k(U)`XCF$ zoqAG!W{Pjzn$`(+ds7-_B~?cD9V=J3w1iwLxp$A!eHl;{V;DgJ_TU+hUZf)B5?oM#H685g>!Z%R*yYH-6 zp+lna8b=}^DI+C;gg>rGY{dZHWIG(N4bB@UE<&T!^iEHf)aZgOq|>(AU%=2jQxV4h z*79e5W^8ibMWa1l(1xO!+lGTS%llz*bl2< z`-*^EonuwB15{!vAPXj%>m_5DRTQn13P_UU7~lzifu;pNlLo-(DU&D1C6W{g0l*l; zvXIb_Uj$xE999jqkY`O!;pzGM<12fr?(lt-!O7?TdYLQ+L)K4cQ54 zs4m|88>!{g)6lMPpf$im2L&pkMK-QSS#}l(K+YH29WY-#jMN6%5SOR7Qikb)!4aip zOASElhYQG=+3rkjsO&sBP@=` z3{{bM9$ii3hWVq7(>2{N%u-sG+iMS^mXq{vDC~#NTVk1fJ8K98iK5g5N%)yWv_N2_ z+zUfwh-_>zT&2PyI06IFa4q2h7~^{cqQzDnBxI@^yfmU(`UYaJ;y%m2)1_P0feG{F_3-?NeCfwz=Cf)lG~d`LMERe~^i6i4Su)nf_+feP zu%x{FE0>D*`r1$mFMw)FXuTJD_ecNySf3-FxPGiRIH!KsvvjSF~EcktrKAK3r%y z8rPX}{{V*W0FaTxOAUalxYdQhQY5BHgO_EPIg!+j)mEznnAqfvivUIoQoW^#iGDR^ z@8*ilXFBHSmPneTV>R5QRZ4qv`4jRA$_}@u$xPURufjTCIoZ{XRgj(tZ|!fOnrX0f82RoiEh_OWUT;7QGpuY*50s&RDdn6AXCUZGr0LSgu=qE?JQWX*czMCOMZD)s56pkTO2HhE6r z&o41LzjJ#LRzInJcKMdcgUs0opCz=1(7yW^3wYv72nUaT4XTZvNN-NslZ`v(jpV=V zFZAph*Q-Vu(-IX4)L3@90KZ)dk^+ObXIK5^1*0>)fg-gQ5t!R5Ds75IT{J zWT`|F0t*v>2$qrq;QB)|Nc9qxXY}iErqipqsvkTYLsK}4p}oQwfGV<%lk{tjqG=I^ z7@0U~JkJl^N)ayk8#h6RuVg}{OZil~9A@?wKjDiJ2lG6SVaO|e00!n!1o z56`yQ_K+5)LBS#vn`jrwf=y6PaK4Rfeo>by+`%0|Pi)&aNBo!s?p!DCI=7ox%p|g@ z?6x;X_~B;Sq^;;dHCf9er@o(V^b1US!b&oJLJP=JZH4u4hK|5>?FjQxpUT{tQ=ca8 z#I|;M+iA#|9%Jj3UawC?3%P1BDlA#Bgq>1kW1_SvTs+O4`RaK@5+7X3`sLXqwsH#U z^blPi9I3OaiquHR3F>em$~}qXloq5~txE)*@}RZcLuo6)ArqnCN-hcj5@07s>a8k) zHOQqxSJD(cQ0h%u0g-C9w=@9JQnt~+2UY8Q&ej)A4iZPp#S*N-c4P>UVqRx>F-1C& zda9qnEL*LDaA<_O9s`3y^AuXuxgh2OP*)oUnjC;83U-U$=i%XnG=0$lFZ6H>&Tw9a zV^c*tw$#y|H9#=;pkG{3O+iLu!&)5lHQs(aV@akNV=_MKVfg*M%`_$> z;VUjZbxD&(t=1PF$JJVo%yhe*jBxP-GYIbgc#M&DBXL*e$VwG;6?uulxhpqX_@%X? z7LSS%pNX)<l26Hyp~>^koZ^XeBK1^O%WInF zfgx!G(k7;G%0NT2%5_0kV}Ly%d7r>^B^z%nvvx=pC&+5$g(=KR29C0P@J!e_kxrzZ z66=@+p(sfLflHl8CP)b-3Vo!!CKqoVq$p9!(|W!El7fTS<=|?kHib*9j0v|^qVpdg zc%HLDMl|1DR5O7SYyv(P1J5TYUkZRQ0-uDwnKQ9FJAynEZPy_1uDpCK@3xCjk91Q&^9(!&P__ld^V?f z9G0Zh`bm%@LFKGS#d)~|xilJS-AWoZ>54av`cNMaurz~$U^N9T1XUZ08k9HFO>v;J zw~rfE91g!P%BnIN=)?KzK>oky%0+x9_)Ks$zI)3@c*6AyMX>r zn(N0OC>1FZX^U!1+KjCodSY4FV4c&yY;UFwYw+RhieSo?WE|wALY_B}YjNLM5=1Vo zL4dffWSaj8Ngk-W5!9fLYzM163#%VVEMeq-vVp zn1*gzOVVX+LsK!K%1UwSC7^ktZSZ8!X^CLi)?brasxW{IT+7thJ`iX@6uH>K3QOJg!*i~ zd)qT-Ycx}Tmw~attA-M#+F{e{tzOz}0d}JmH~K@y!eX@?@z0t7yKK_G4XqU75yN0u z=*KrgrW2q+5)>4|pv0QQi25YQHJ&8t>kr=3$f`tNW+8G#asWeB=PImyXD$b@pn!J- zOcb}ab#@wEf&-r;xdjD5e+%jp{RF*sUwuE+I_>{h!DXLYk!Q5wripmxR;HcBm1Qq! zaiq>7OFAg1tEblg8Zb0_8_Qx=uNA4GwX-*p*k0Du5f4j#40V41dXabO` zDkZ1Fc*Mcc(A*^&!$>Kw+i=ty1rW&4)7=$B%UM5t?G~xeE)+fE%#Z^D zDe{ceBE5?KTR-QDaTU9H>a%ESqX~GTwp-W*u_XeXwuK{}G0m7lsq&lseWYI1xNji< zZ0fTpG&ds&g&v*>O`Kcc+8~VU2r|vB8H00W}YoHr}@X5>Ac zWiTP67B*RgV36rD|9HjTgW|sDpC22o0?#RqQ#}DCGYScDQ@1G8GFq6ZrnQoI`8KPX zDJhy9frT(uqZOUvHMNj*y(-i^6BVo|zC$S|Krxo-Oww7JbAux36Najll-TnOl49E? zt^*)jRuYs0oNPG_MJ$lB!jfQ(jq(;Sfpb3NtgLv-tVn7WMH5MeI+xF&tb$x+1=<$w z<*Urifb0uN%y56Q%E9WG1lCnBNS*SQ=YCJ}Ep0;v@~7G+G~DV~tUNc4z{J1wR~+U1 zM3y^KR*!=c#TzDxT5O67(v2#ikBh*??y zuy$)}|I<)fV4l(S1NRkQK0P~U+2bctmPK&Sc4?K7iq|z5t_&&zjfy?{-HreulTGH0 z8iSwr5*ZA7sS`DFf;*G^KI^%_FL?U&DoS+C!kYpO36=e zkHwgYJG{jhZv8;y9)`{XYSZ%OlHVM|*LDUBkJ6Dv2;hRJdqvSe1h!pLGb`bUl1w$$ zYhqy1UDAZRNExTC0bw?h=;3~tcReU|VD5!t7L!^IzqYS>lWmyk)0E~>Q&w|H{Jrr@ zy%rSBoIAsT?RWCMdqHI@FxHK@`y7U$6n=)&P#Q$0wV|a_axJkGLknjc@^f8P%ZBnp z2zoCO+>{ojs4%lZG*9!d*C&MO$+cdz5TMY=Qhw{xj-hX7_?VkY8N0u)q`E{r^H122 zm%Vvphk$g{T7OUl%S_w~X!I6cNZvH;J>+43Nxi1Y=GO=MD@elF$BLmve@a)C=sEJ7 z!PLTAKVl?b9UC$QV#BKLUPEHxW6l%Di-txjVfNTn`yhNXk9TCNjcQusW5lpQs<5k6 z-Y0tjH2;)HS4Fea?Fr;a?zuNpO8=Q}w;GMGQ&uq0@E?kqUqP4+Ta}V;Mh|c?u7*B? z*5y+kb9hP|4IX+e^$qnSRZHCgy@FaziO_L$6s@H0f&#o(oNiZK3^0}tJi_mosq-4& zQxTG7LB04)5qW zjk(d*o@?5!WoW3ij+#>%W#+O1~SVt21!8nntGMLIf6E}x<} z*l);3pW%1;gB#zsBg?QtTVI?qmx$9i9RX*5J9es$kiP;>^3d2TCK1+iNa zt%Kv+6VwCc7qDWY8OW1rRPJR_Q+*Icbs8xbwq;VLAirPqR`*<8`JlbCmPpIZ`P!{D z6$-b_(DFgC7apj%=Fy*CJ$gl|Z2im8UHM`?#4PcL6WKz2S=<@F*rDa(PYB68madkD z3YcjKg=i=iON`Nh$;@{(~^>pyY#!OZr<3N9R8%k>P|OeWi9 z7O)d`_cz_k&WlIl@knE~)frpJr)2nVKo3HPz`Z*X3u$>Y7ZL=RB{15>aQY%{;k_cFaRjlOhwk@nD zZef8<1CN_0UQK=JZ2s!PSI-Z*h&v~E9$lRZ?8`S>P#FOk$E;myUmD+`A0M|wK^9Yq z1Gd{dU~M04tv=^ijZm8KV&S#Y%^ixQ60h67cK3g2PfVCJuIt?Q29Ij4&_*;PI>?i< zc=V<)Czez#qN4292i0r4e9R%R3z zob@kl3+9qgI1C4^KP`zATg+&6{fzHeY2)tNyAyna)N7Smzc_29-xI zPEUtQXzw(6H2ZsJTjcTrDhNIAgEAFhl2{(4fxQfZ_ zK4eAEC^GG@XR;!yl*z7++@}1Ma}Nz)$3exVgvz`f zSRmXxm0$_U!{ht)m@P}9$PqFbEycXB2;2IKtlE*o9}Tf^AK+qfm{g57~fsi^^aNhXxQ`B zU|B}i$pX<2laz^8VQ3$@+NhY($5s{Ttp^H7z%qH`s$g*0`c?c-g#i~8Qr|6 zm(NN9(RO8qX3`AZ?$`stA&ZE@zLKTWAB2N}HW>jS%&^p^>jW$7gi$a1QV3CoFD%pb zFrtWhoSBxAvx>jJFACXYPB+s3Ir7t;1r;YtJa_7y$G!GNcGJz8KU!lbmRotHBROT@ zqDe820vQE8?eW>MtoQH?{Y@V?FQ&?$o{>>oAF+{BXBNRwd$tc7FV7=a#j`m=W1=OM zm&HUeg+Qsjhs1u&XV-SZ_Cz=5fnCR`#A>fwsQaFgAtJw43Qkv0qU+mCJc$Tm?lbP# z2eOxgf`eTMYj3~@k+ic)a&`RXKt##Vql3HoAA|Cs%Z9Vc+8i+DM6#~Erc$jnlLIlA zW!=y-4=r!l1EJzQiGq@=EhEB=1=?f;&f*J8^gY%qNe|_h zNX{|*kY?x%^bR~P)W{kKaQbU_ZOe=>V*$|tJWNwZ5X8@g1GqrRu}k;~#g&HJ;8`jg z4bqY%ij$;N-72J)8IU!c)`NqTU@Wvj5}h0*$IQLj#fSn^c=9!sMm?0eHFWw$;}Ne6 z9bcBoDj?0tZ!hRk+!xtH^}41V$Xu=~;QxuojDx%Ss^iYbqJNDu?etG(rm7530)pCI zCqNJF(#Q#cMZF`_9AxyDM?eN{U7$gxvKl>M#F|PNvy-&xfz|8ydcAZy%gn=usI(15 zGh=wr5JgGoDW%(1p|Q+>9>ZiA6|`r^E<|af6Vn7rzmf>EHG*2(`4oc$Q9NKus;#2T z@*0A4p^4Jh$AYnau?J(rEfYZmK@bBvAezp;hFoY66txvn1<%3KOcaFzS4B%4!+42A zam#r}l-#K2`X~r`Ov-b7sTaY6@=Jz89zc;dcff*9{_YaUTU6P8Cr7)Bd}f^(@;9CzkHHj-v8%9O`QZzjc&o#ljQ5EKu!+usYt4|0ctdw~uyF9#3O#{nMAIJ&*7;Z2 zISYahbb=aX55vIZoU~4IjX!PS5SO;z{S8>_eo6u~pQ41{+eW#<8LK`p{vN=6LT?F= zl<-(5JR4Lb-~$Xv>b4hcom+#4Q1i&fYx3p>;CLGFcNq9-5`q& z8$i#8`5$}7-bA6?kdZD5K8<>n`kZQ@zM!6jN>CYcu?+OIvV$yjt7#S-G9~$EULTPo z`7_gvj$`Z#!E4+0cO81*TBtGmWm@Xl=fHOQM%@yBvi>60|rR?Mn&u+NV{K2xF`-oFGW~6N~P2u86N3$Y4+OC{^glW{e|sC7B)q4oVD>(A32AJ^$HH(>!b-U{TQ-G zwD+J>E2q_js%Fc(2LtA|t!$Br+GrbcKhc3JWU*Rt55Hr|)J3^M%5=Ea(l;t>A3@s6 zNumK$b$!>+K);lj*k1yokPxYGyMVnS7J`g(shQT1+)*)t$-WLpmPQKYN=Z17^o`2i zMf=|1AUFKg1^N!v*^)0=oWESpwlcrzLIk&pD!9>3L4aRoGh%~pWE@Q738zB9bcKN;Q2SZi{)v7Xv{!`R*G)3(2|BY_)Y`CYwuFhPy(Tu^V;40 zLh8mtbR(!TLOcf|8(DoVk=6HZeuH75$@vKR9+X6#v8f#zg7J;C7m}g5oK+c2^JZHY zBMrHoJ6pV8bc8vzjED?rH6h2OZszRvD(Zp3brN<#ju6=pwQGsq04>vt`NSK1LBK{L zD1kLAf+*#t$P%qomSs2!8CnN2IF4)*QBV1kf(BCMa2La@;`+Rgfzp2#g^+k;0a}VD z4W^_;T+DB6yFRS$ky=Mr4Zq`~dEc_L0o>*Z45~F&U!6W*7+{L_7IsR>@HBwA=zs)6 zs_`suyz-_TkXy@!@pKtBatd>+GY~&o;Xu?O1fd$kb(x*mGpx!0Bu~r02RMX~lya z69ODm=Rp9?f(JSXK8;fMFzH&r*tT#GtFK9&O~Ds)_B()BYm@?;?{& zfq#3aD9tqjT$5}>O22o4%lY(~vy7ZEdYMBLX2-V#^Dm#)CXeB9>*8)fu9t-$k7YQiu#%5%a zi!Oz;b5TwLrcmtqm>~RP5Xh=31QmboAkX|r{0kSo{dKrd*aEZfX16hKayELwD@jB< z&T0Pi)Ms#@uu^<6OVgOQ#$l2U9JX%p#ZC#}1 zyb7ETRtoXdYQ+7yoRF-j({{WbozUd5vI09ZMqcUuzyNz-00S6|K-r!Ft@R*{ogmN$ zS)TKyx1?cCUn;Sa#90;W61EDGQHBE*w5hSO@)kCZqQL#R9)42X;A#qPzm4-qP@|2w=m3WVZ}t-8%rIgE?$voiZP*s- z0VlVQ3AYh|`+T23WjH4-NvtGN2PPwqE@T5>qdw(*I=iWs5G*lPFiTxQqiR(7gZ#_s^Hm%apiux8R1)UiLhn?x4PThjy7ffuu!=*i{zYv>o4QqcdoThVXDr|W z7>vjrV|NWSf3MrC_qRMK=aX~VXzN&~48 z(xG(7knz?1!QFhSxOXIULZ~1dwbe>{FEZbmiObr>+VeEc7G$P%9b7JIBSy8=l-vlr z)gEWJpHVV}(#Y`e1U|H1jb<`Wma=Y_NM5#k+txL{q=G6b+L1O#cCQ3Q5-6G_5#KKh z8V7rx<5hJ-0>HI3xRiD{jpsB+kSFwW6VZ7VCfJ0 zO4xc-(ex4|%UlQ(ysF@XG*riMwnU43l{9OcU2bbC(d`i;1N-{;#)j%Z=Nn9?szM36 zLS5j{Z`3Dz6{RJ0)$8a|{zz!wRoc5zss4)zc%$wQ*s|Z;XAvtNAHBY>5IsNh$Ew4H zZdX`1^>^{=Fs%g?&7}VhA2Yvn2Gp@*^+Jq7gHQun3v3*1RQ?(o4yImRD|JOE_++%& z#%^|yXSR;WBD*t*TXjC(q*KUqTv3WpIW`FVy7BZ#->rMfa z^^>h=#CtIA5heiLK7{6WHC1XXB>4ov-+2y7e9Q<@k%6{=srlr7orR5(;5_?*;;dMT;@N$%28ih7qQY8heE2r7H;duYQl2) z@iIHRm%24Ko=T?^^3Dl7SA7u!zXNOnt>@OC1mE0pqt|}c%8~QK!86l}K^MtLq*OE$4fr8a67K zGd5?%^`jF6)&hxB7ZECC?92RgfS0VB`EeaO8k5w$TDIfJOa_V-I?XzoyFu{I3`^S? zi!28W%7s$5j&gvM5m$oeEEQVR3<`}>=afWjOum?JDS)bT3FplrX|`1zYYi@3oz+!A zR1}(46?^?Yqoa`TVLa%Tq7dTpYGdm7E+( z(hOCF2Z1xVg9kW)a|G&PsHv*R(3J{GM+99ofwVUzWhyHq8o~`MesEz@#lC+aPLZ=9 z-8>3L7E|^1wp;qK$XJYcg|P$+gtXO{(GSTy$ll&KHLSX+^MfTuFf7mvBdVI`xmpC- zTu)?$`Y?B?p_0B2GNe>R#0G+fqT?orzfz6IiV+wV)}I^zCksAloBzZjK8hUSJ}xA3 zxx^(^d<$NWxa8dj=wDpc00iIN48$D+JpVm+9ZQ79alS;J^H`1P%ArFCT;^Ta5KAoH zAh2AKtWAL=1($Ufb`RliU;VZwQgIlCR!Zv{qV#15CuN!Cq2^fX!)%3S)!91|KKdc| zKV6HzestZyu5as%b4E5LMUk+3FJR!4=JwyXs{&0(Q13e=VIz{qG4XaKE_6hBo{?pS z*L#xJYO{I^$4fPXg!of&6>!pGwQu1T7k=#^CQq8gG)F>XEo77d=={2ndr^^d`65hT zr36j#&%c#kW4lYyUvhKRNL@I1uIuG9sM*Ui^Q6@_Klz25@wWU~KRcL6R~owvI^jU_ zTMGMldys_+s;e^N#lC4i!ZS0aBnlkK)p zlyk8W${n-ry`)-Nu322AU6&Y#-e-rv9S<^CDWA-P|k ztllwZy!-8y5Wg*7zY7TlxYNr=($(C^$k$bBbvh^@1pQ!CuD;Ax4+ZK$7wAR>z_56d zIvuZ0Ztfn4MDublwRdoE^mc=WP++H8B`$e}L? z4NaD=uaNv(m4d;VrDWp;^>R=#+a$$^6gp)3&$F`Jm{Vlx+6KGnL^&BV9?+ZE4HiMR z?q#hOfg7|0sPx<#*)}(^bWral2#WHE_iiB$WFT?a@Af@27**Z7$u4fic5K>>)Oltj z1#CTJ-uYLH!*sG3)ah11RnNvJbQ6;XXEj3Ay%4W7qS5^xP{7xHlMwFvKBNr9}D3m~;65>GMp39iDJ&f(M3ok3>DDORN3b+JN&}WF>>B^p|~9k$a%6?g%Jx z75SsLJQ(3P*DFcCMU1@T2$uC&A2VA?oNwL;S4eaSo!%qRwE8DYyj@eaH|@dptjA zg(PS%mD17Mu~;AwD^yY?JW}gP;l8@|1kXh;MU$6CH=&7tt{1kUY0r)Lcif?5-^{s2 zVc_G1L;zSxyR3Z58igfb{c=b=g~hcLv%n9kU_c^?k+Y;Q2@{4%lIPh>NjyMH@XWTn zuo7NvQ(HownFh%{S5;q0g8$A*z`y|q-~b-@^^pEE9F2IrHU~pIDX*ClxQ6SokBfvLh~@ zhtCclE)|h10txE3tXA{I=-&UVtrkjapW)3l1A!9k?kTqdbm4yAZ)C0;00nR5IAA|H zpwS!5)TaRb*FBP^>nA4D(S^i|$^^*c2IoMjL>>JCt7j!(m5y+8i-Y3g{@!C)U4KOY z%Gk7GqE@!DX;<_uPF#PzW8@Q5Xhtg}%?$``9g>}1BjDL&cP{@pe@~&n!vYeJfIsMh zBr>~~mnDfKiDI!tR51bv+0;IZM;$FUl`B@_Z`kctMm(}3?dT^8m%F;P^WUEQcmM=D z#+0Arx1?G6ABG6$&no}o<_ZS|oY1?VeYfBRNI11miub|XHtIaTet7j~cP2I;7ehQn z(}JS9uA_F18KB2XRZF7|XN*e=FO?G|D_a^FZsru~76PfYh)r|=URtR~5hLldB$*z> zzmo83#(z9o#j&^Gt$GW7(cojvV|c}_1IfPZ<5PW>Ss_;WN!5WzA?Zk#W za5|!^#y)usrQBE;UMyvfkL13HpQM$&rRh7&YN@}Te^57DY!67a8o2H5!$%Fnira67 zTqE4elpl1&C;pK9BM>jZi?sm?6G4vn2ilzui`nAxxa~GO3ErMJ&MM?G>1^(E1*W(U zO7J<`X7XORV$GfE=aIpWifYsv=WVC;$nxL+@?#ceO}_uwl~skB$1*Q?g1X7#2fKqe zNm37>ML)0d)6kuH>?POEj3<-)wdr5#67;->hsVqFi<{eb6ta3w&5;%b9!>Vzsmjl+uQRC{s{x*+HYh`$c&{x3ZJbu*Ng#67PRRfJ=qN6 z$Or)7dhGhAPB@bGyg-^Jr{1cV-_T+S#qnYpw5IiDEE(-y*n5wpA?dt$IA8(8I}c`TXaFl+mU^nmJ_8)3!UMQRRty8LdW>#0gOP zlFYg_;Yu?+S}V>fs>Fy&#ffMg%*9RAX4RxAPacFb}`XT1ME^g+oxV!&(akl zo~Tx-wR={ZFO7vJ9M2ht+d~;7jM129GY~TuEI0^9I8IV5OJXRB_>PJq#`FCG)1g!_ zs8u8CYWf#18D}X)T@5%=&z*7Jsz#o|`EgC#Ija6sHTgf+_}rdzKYN1~M#%>}olJpW z{`w%@UP+}$X##SHog6r@q%u&|H!B8v)o$LalS+)K>T?r0XpX8!A5#rSU}V=&#G|+0 zICx)l_o@Mc2dCXhp{L4Z3`^Ee^bnxgS>C%SL98t@-?%Z@QbL9q*bl`C{BB zZr2;>lRzb#q9+P2F(crm+M^~EVVis&=lS&-1KN+E`HBu1K`_KUdGl=%wCEV|I5k>ode{BXdS!>^0D6eJV44C>goHP4N!t)WQbcivb4+f%Nb zS}jGC8jVUJOPW-uftj03gNsydepe^lOaYuWie5P4i>U;{c9#NIf_b-sX3nj$2E{Im zx#zSyYdaTb3u-b~Y3;LsS%(8fhkebg*Q;1Y!TKn?!-w6N`6xZ${2OJGwsauT8s9Ez@|W>W^^WccHB^H7&;`K zvRNLJ6>lz6?3f_r7N}%pqbCDx<&~BNHVE85=_jX4GIfDK)#;Y_$iG zgNIwKalsvpITaV4Tl9lZ$e5)#E$A9Uu&D>Z+6MXLX#51oXNkL7+Vnm%#i(1W5Faz> zv*TH44jWdKvR=2@DXj;Jy*MF^u^vAgT1;g`s+8!NI~po3w@R15I44WHF8e#^x-mws zyFIo%VH#r=dsWx<`6leeLb-Hl;Mb42Hk*rjEj!g(avhwP#yOgR#C-aia%0#Ip<01@ z{mzIGM<8x9O&pHSo-<8nS5S)5j~nQRV&cz>4-DxbL(1gm8jHz&us>Gb*a>*Ov3RM` zE7pnt@p&FKLf9@k1{bx77uKPZLeR3LZHM9cZktc!bA=?)cguRmG@ORVQ_r%SAlN25 zJSwBm!uOAoIdn)Svm~}A>w8}{ydqok9Anc~v-@KOk8=$SX*#|gXCL)1(G^nB(;HW4 z^YCgU7M)Zd3+eO)n^RCBCy2;NFwZ8`O$pmS^@R(fNspmtml?EXgRG?A9f-6t9jMT( zxO&yzOt$9<@WCbnUjp-4J1^-s|b#)m8>+8@C z4~vLn;#pyuH3KPQ*ezfF`Kl^Gx|CYUWG$;u1wa;$42T5nL4Bh<+=|F|r)fJahW^7aID5wx}!DSs<83T=m;v6rfc{>&aSqtO;9 znQNNYaUzBXZSEi@ZFw{nF9Cil^gJ5`yn+&#f~U!~DmAcOp5HC*M4=F$mK?w83Ae>V z9{LRv`cK(G?#9IUN2OFCmFIZ^t3h;zIk*Vo!tF!^t!gqbiU^%n1^h0nB!fLT=1|5% zk~uokNklSv)kEKKk3Fpzx*#Ea1V8pnEdY+Sp_Q!4vRVdNOa5xMG7!JcRY@{eNGZZ{ zHWRxAL-F)LD-Z?yun zt#*gqNysN2UmTW@pXE)kw_00PsOy{-3z>gg?1ztU`g^9Eiy&gP2Pe&-M`J#?21PRB zvD&l{Vc_z>5rvaqx~=bg(z?#&ssjoGWSUw4Ln#Wb43D8I21bL4(e76i`Kq_>kj!r( z3R1xW!WhTTG_Ig7oSC3DqGg6I2%;Wod{Im$3nW=ct`xGM)S)Fa`2s^KN^$B-lcadN zX<2<;KS{ucZyBVTkG*M*fiaDo1HB)Eq6}%8OWVzQ(K?i+p!i&!F)x@A+=bPiq-$u?A2D|7=7jbD30A)1h zx)IGNip&6f+(=lcane;0*BPAF{t98E6YSXqy~MzwS-SoAmS^tEgUarnafd&fNw@&a z?cRZKYvoAm+S{1ZZ;$dMaDR$Lps~lL0)-I0EVUmH5Qy}&J<+cuHR`6ywQAL7?HehW^Z^OA@R0lO zXtl}n22rY$Mlk4ALAa}2md$3=bj=Ki!Yw7Y)pRueHE3>MRcv)SO!+J#aUB4(@eG$J z@hMNd@x~UTe*6#L()~WgH{N;2tMMN;yu@&*yvQ5ee#1m#QVl4S_z_b*qcT$Ip!1Y* z$qpND`RLaf%x|8(lSgeqG_TQI^KzxXX9!)dO zQ`dHc(Qz2hT>AczNc4~%sl<*eIw&9z_3^Yc;yFRhf9N8YbZPBiWhT=D zX1Ah48ccI}dv%0s6tDLm`*FGfRCk7=;VN7nPR-Zz+=r@qCnlL+8sv5d&NS}7rOxff zl39O;Yr9^7ff1iYoisf7V6n3~!8IgfQTb6A?A7cvLR<}F3MX^(%nKH4z;S>pK1jd{0CVgy_$54@s6l}WkjWl{U&2n_7Xckycnp3C z=eF&DE{bXIYB;zbQN;7X{iqoO&yv947=Ef?7dBnx(sdNUU{D-MSegnJ`0H1Y2rhpD zeeVFx^fyCV1y)O4k2}vt*dOv}6EWUK$ws2!~tfvV9 z#&?%@$yg?WTw=S1VTb_CK{vIuEUZb`*Vs%@+W>-wbUWX{I>xX8bR3|>xYhxE@;FHX zImUIW$_b3gtfz@F;+e(Bu(Zv&R6fGyfv!DZSTby(>3@6?$2PAtKzfn2gk z`@|yyR;+q)8z4k*W%GO_L4oPsa2LVpQZ`YRdFMTUK{FWQ@|9;rpAS45`(VG0J;uaw z0qiWW)I~2vQiot$-Przzo>BY`S>vGHokVahaR7CNbrLoRhNElTB=&SY!%#S-f`iY= z(AMo_wl0Iy6b*Hl>Y|f?)|J66)8}dYUBZmjpMD-|c=j=GpY=MGFD4Kk?&;%?SaIjC!ZzdG_DK(72#7rogz{)aa%>1H8aToO)@loOVp|y` zCI6lP!XOM%!Hx?l6bCN648=gNB_V3@zcSFv94OlS)(Bfs)2TF*Qw^Pd+ZfrcWc3C) zES@ocSoor$vLx?MvJa&zV6!ty&;F*Qr`@$eNL+G$Ry@7>$RcFv0Wf8V|2Y!ZQg7l= zjU4l4%(Ly^tuA%OcV{F-O@g5reX$eDYkCutb2*06F$pgT))|JWDe9z})?j&-iY$pj zxRs_v834>czy%kaU%}}XNMINZ5dd1qbZ#N*Vp0T>@m12`ZLxK~ejE5Eb-vuB%BL2L7i+AqI6tol)ZA^Uy1JTSI5UvQuR z0wBOf2e^NoggSHK4QIHm`kPlwP(^$N#eA&5J&!T(yRXydKY(J0`ZBRoEe~RTOVX|#q~IdFHYWIr8=H@nGMmV!|KS=XU+6Y$z~ zO%*}i{dJDCiNdaC&4`EZ3N+&l{1vLo?sO#aQq??m9tLdOE-ay;$43Emh-;kkx0%TX-?wt3y$51nip`Kp6qp`05M&MOj*^D0Idb>}#&Wj}Q_NI-?z9G8LSgZ_2e~-Ks~@3J#bC-L zt!>p~;RwE`dxb;3@;y zqPh^rUG{`nP{lyRu!w)z(orH>`O{XXJq$BkX>31+E1iEgw#k{1L?JjbdEI^Q$0p_SCy3<8Nu)W zQ7K^SUjX&k4hK{An?EtHatC(t3t$>=?Kj>Mhn& zy{cj1U#gCl*Qx7LhYgOZj~ec3fCD--gcuBsun3XH zXhfbSIK^&xkmIr}R`D{M?wUz6lwsvH2L-DhEn1$I;3?M%7_5J`K5Zkl0Rfw?Ef{Xp z4rSP8?ZI*X{|>-lm;5gS!zA|RGdnn>Szg)rrDqBAu%LkSa>~81Q&v5(=x~&ccTYcQ zS5(Wik{XdAt{IKlHsJ zCg}dW6EHedkH;G9-$j}PeuXFFP=Q)vO6FaL&SG~!6)lE!`g~^Od8B(eT{B&LGgp&6 z`q_+L-|I%W3PNaO&(^yI!TJ*nHj8iOXs`#B!+W>~t=udyI{0^0=YA=Zom9Iydxk^xzwOu_fAARM4%U@_2ep}zs(L=e%gP((WI!p@<1%#T^utiVB=aH{$zoq`p#x-T)UQ&XOF@J-O>rH_l;h_*~ZY+GubIr*_ z$9_fg=hU9C^ttn+n5hq)5-WJ;F1v20ZFTc+@WzT>BFFrd^2cHh!Ls5%CO02S(TuR1 zCLPMoETwm{mLjKk2|L+(2DbTUQd7s6SxwIA@3a$Smi@}OklGvTo5CR37x9QBbs;$h zU?R#oi5(LShdkhB<|n*4F1ib3S__7f#fpjx6g}6yFxcIYI^rK)gDGYNwU`A!G-+Fb zSh!oJi5spF1}h3d#kstg z=%sBfpAs1|QFjypRP!}Y1uvT*8QYpjQVfJn5(7pN?@2az7u>9T|4cUL&$hpwA_1U( zU=IH_>MeMzf^v&EPwlmr+N!sxlOiah!3Q`N4}%3Vz4P<0O1;)k<_kvH#`?2_NmSwX z*?l3wRWiIUne_;i=H6%=MQsCwLCSHsM<@y*yM-(9iZPdSywq+A^dUaM4(d3$%Bg9q zQQdgC$=(sjH@OWY0a+P`H=^9lz(N$wRQ#azRbrabC}b^r55fHig+7hUgzTcVWH4w% zp71QW01T|KQMnIH=u~v1j)B#(@#c%q>q?!QtXEx~uw@nUSn?ssI)FrbLu9h*s-oRr zkXbt9IHWzeSKjX}IJF9}p%u`1WbE~;5)olg33CztTA7!;Bfu^a@&#U%GP#8Or(Y)5}&)F>SMIg}!A)+z-m>hwV@}?y z2A^0*;60it?Y7b<%Yp)(;MR~Iru~!snPYj0Z$UGb>F=@+g1h9frhAcY0HqOkg?wZS z)eyV#lrWd_ggxuwAyq;Ul4PhmI?7cvE`lkq3GL>npw#(h9LsuFpzM78l|MmvxQQ(D z{1y4W0n{gGvI(Z-Bxa@V#ZBJ=r&NT=F83fj1o2ix$)KzV^G(Sd#fxUtb{g)*wd#$U zBWu$cOH*F%lUj`C^>n{_YP)w_cS!Z068+d;!UXY;%i;*tA z@7%B#^YC~}WNkII3gT2R=<(cR#V3!Tg5jVQ`2I}Zugpb_RJQ52swXQaplRa>GjNU3 zL70K^!odNUlA#n6-&V@2zlA$5i}?3}eS_+t1RQU)XT5|FV~k5G5vqMKl7>L>W>Xpz z{DJii3f<02iAkc5v2o&8{}$ZTtKGey?YoZ)juJDxP`2a!b^uxw+6I>IxsNp-5)(=5 zoSQC36GdRJ<;C0&t3^vEolO8kMAR6yzI5#ElX>unVvxoc1%BUur{lue}hPct6o@Hs?pO=fAZd=1rQK*5TF|AX7lOrUo#r85) zvZu`uq0wT#AW>x{fr$}=!j(VqlEA5|`qWF!nLBvB-q4-ayoIWW-nNX)$n*jxl7`jE zmT<}9KQ0HpjXQ*&QFM(zWYID#w&HlpcwG4CrtcgRNY-PiJdgEU{Z-{L$ zf)osNy4T$WR~i|_lhMI`LlcYm14IuAfDeuLEWH|^o$4OmEfCmZWZ`3YgI16m`s~%D zxp=}=&QN<@$7by=aN$TM3QWb&*60mu1N8C6{GrlXEq~5PH=p8HxaXunD^M3rGgIy4 zSt}!lQulcPv#uAv%Y`6gc?>1ZvV8l_!EBE@DyO(!QF{}BLFl$&UycOVls8aoXKiSV zNrFM2MqT3DrSBHPq^qFb2dCJaUh)#wWo&%q3#u z4KOdCmiCV^59A|~)|xWx?jH+oUPNF-w>g*$)})M~3kAkom05%>jSF#Z!k__ti?s`= zq#7eI{vf+IjWt1duO4`ca(tj5L7qql2A@DWgegCfMteiIO1;2wu~iwq1t#Yop!c=r zGK?1^*YtyL$4#5i%VvFg`^lLCl-C%o@?zDln^(NR@OisD+cJwRM93*V%cm6541uqM@_$4R!u5D$NsRh%`F2EFeV{3y{7zyxz z55Y+~lHV5Km z{rLo=9ed2;xDO-YHtxJ$ZZAnBaumOthoBod-+CaaRPU-Q-azn1>P!$T27zyb>@d>9J+a$>fyb&G#6|qmxmNaQxY8lKaGbny?j>W{D8QH(yyHmBN*wJJ+K#<40bN7oD`UeFYU<00> z;)EA@Jc)318T~ThYFim)Y!7>93TvuBz@2w43?jK<<%-aHXrn? z5Q;lqu4i0Vf6WlJ9X;T=Ipob6@on(7_?hzJKDFuMl)lE|&&b$sIEhc58rXaAtlS(8 z-j;m1T+5mCzC}UqqzPuiS)_Zzf*7Bd(!BqDo;0=GfxGoZ{MZqD&xOh2%P$WSbEJH6 z)Ab+Q%0NOJ$Z2Qte8GhG4)cw^Qa#8sVovN$iHRS0x)eUw_G{*y`q8HEt+)JO2ewQh zeJmrPK8m{~;iveuuLA|2CV#DWK3Opcp}jZ?Wah>WKZkoLf^^se35#>I-rafRTf?UI zXVaiKWh}7L3!O^a=N&lib!2+UPFmM^UnE>QE#NeIEov(@Fk46B{=C|LqChbcY+2u$ ze9>@3?_!b6t=KOWO*@hCQe&#}9@K0ge+)l0mw4fPD8X4Q|7zxMEJ@D$W)P-dp;Sj^ zqfAw^^J_fM4KtafFS}5Gy(_e+saEIQ-%pQQX4c#Os&4mR#Z6`#&4@EoX|TQi9NGqH z{WKiEzkWkrT6&|KsDvvrds&N>C!{~f&NgVF|E)as@$7!#v2#OM`+e4VJ<$B)<~4l~ z@TsMJPx}7%PBB`eJ=V+KMs>ctaFP7HdqM>$Go7uR`&``+g=%&!ph4;}O>O?FIf2C_ zM=-H9I;BiN@gw@XD*4?dswc9Xi~RCgORTO+FK;}R*;x}zYEFE85u?Mzu7>c*+t zv;(#a2PQvSnuVu$pDd-XKnj~G>2D75`SWw`^J4Fz(JP>0)^S;y3G5f@(~A&>>e_gD zm^T0UxoOhg^T?mbdFMm{#R@Eq^&D#N@xAs02qEzLPVg)^n^N=WXR_%DhxN302Xs8k zHG-mp_$wQpP1d|A)*3G0H{iMJYE-!}DC8f(r^=JOAiz|9rn)@`F?-%2KKI`7eV$!R z^aQA91WW&TQh*RG6C?P8dHfNfx+9}FGaS)guFs9JEns1cH3d$lCh;MdWm%OY9MF_s zX{=XBTD8;fnAF{BmKRYD9F~w&8wICyxQbDP!7LN+4K~rd9GY@*6yK)=>vKr!)lSn zVSiX(=%O1 z(uH7^4vzk2w3mjsr|Ouw*;Q3&W~5edVx=3NvsA_iE=?@+O`{Gzy`*GVHqP_T2vad` zm(0GhIMqL0J}GwlXL3hvomjT^i#?w%a;;EeCZ%T0m{*uj?T0kmm1WFgp474Ioh4#a z$aRTD({*={3V$Jl()~{3I8w2Q`&;%Dq~!tY4Gb`eP?+trWyIXAUj>U?(1{0!_ye98 z)w4iRuZPI~5xZ)|u5gdmx~_gI<0X;ugWpk|4C^_N8=qeS=0JZ7y3XHUV%2W4;@kLn zSFh06p4AIcuC?VyL=t{EJC}`%ip+Dg&tkWxH~BgN$CG7+Pw0aCJ*xNE@cF7 zl4JT3{=?Vhr4@to2poKz4g9?q7rgoN{k;8g;j7g?r>Fs9ZOlPrJrqMm~$q?@g%{g%7v z#6ygI13%z|N~G?jpo3XOhC1PDM@sVyzvwCZXr)jvmrNALNVD&ql7|cv(o9}n!Iw%g zJre|NSJoFFt3;Z@3Q1wnYog;BxR6qid{1MuBCrb^*rAa|$v!GjGnSEV{Y0kY;`m$| zQ(;#FVp6XlVY#s!>9#Uo@Faa&lX*epho#n@G$Y_Tv)!HE_1rYC&W29)Qdcy}fDmJ4 zb*^MuMzs5t|{PN6bDZV?Io{sHY)!yx~*LSQeE}`kGPU zQEM{s>hlIY-{}Ccx4N9G_PC8Od70QYqFOkMP+hP*Po`T!cZ3Ja5d1vDjzHw$$eB({ zx#mu@AXzBC0dqn?0xVJcGhW&}R7zO!B|_ZKZ?U4}~I5zVMu9eK~S3QnF}o!)Wc zpO+V!-mHmF4;xl!#F#?kojZm4qimMeu}i5Wtc$`CG!=#}DBM+M8AEzvoEMhwBS#w) zx$caIV$sT+jBJ@l*>P>nDdR|}eDiDHm8KB=@zwTJ&_`e^;h;!4A4ekz58x-6^rZG+m@|b0S`r`IO=)ucP zN)Xg)$XALvb{*m;z*Y60KwKjBws2XzTBD|Gbq4H~kaFy@6=x6&8TaB|6bd=cz}&De zIo1&JR_8~}I6l?Qjk6WJ>+xv_N3fg6zYF5GKvJZNSYNL%6ydH6x3N)0ta|cPvsPQq zIbmykhxQLrKpcB^Of{*Bmp?TEu&=&@bZ-oA$>gk`Kaz8W^p|AEfLmYj7KLmsVnPA; zu-YNL5=X7B=RW&9@v^b|GV6>dcP^)pKitS~6*A!|KJP|kn$%+O@w(iki}~KI__L5K z=OY)D@bN*~{o>qKcR>kc;5OAM=G2J6gVyEB_|^TEeeYF0$49DWJRF({`RHStvazr$ z4%|%~ev~st1Ua+izdJ#UDPPO?^1iKfJ^&{rJfsRjqIh4{l%qX zm5Z#g0KSq%@4q1@>*2x%AlHi zQ=8chTteK><^5FSAzAqS1EYQ)TsV zFmGKx!SUMSgwlHfTz-YHREBb2v2HwyS~RI8=XFYJht`5CVV@_~GWY3{c> z7hAS{IeKG#9M7lL>O0Yt)iioGO4)s?wjf{kC_w-&q}NiYU$Ck#3nFX|*Q~o(Vr>oA zV&Y9-UXdC&*_K$@hGSz)E*V9q90ufi_L1lJ4blsz*Wg8?BA) zB;Y4kb}?kx>i9(@p+Z=(oek#bTv-K3IQ`6hmGw)$U6T$l8~>RH1<*({b48t(0r6oB zvf+NlKb)N7D5ij{(`@i}A+T*OXkZ_`PY{O0Hua~+Fo>wSrQa0;Pf-0!lF}ACp{tOR zjsy794AB0KU6drRk~z;Nf)87slYfLA>vmKOeWG|>5HV}2Jq<}!ZI#pS8su~wrP^Hn zCwG*J@uOkDtDepU(Uh3oB$;NNRHaa}DrD8U{y%cl2oQ^&ML%CKP4qF)Y`g5b^s(<#9fj zGmH||h?YpmCVgD0Kc2FwXOVRJxgE-?A0sT^t6MI-EWS|viw$QXgkyZk-H5j(@4`vE z{@`bSQs@rs8o$oaxaZn?3n6bKuizsl$Lq6pna4W!vgFT|F28a2vv_I93slEmoIQjS z;yJ0uN1CCZ-RnF!UK}Mgwn?$rLS2ptZ%$ZY$K5fyANF_}E`NhJ*woj}JUI;qdz|?F z&pBF{CGo6zw7{TxoDH&0wPY(6@Njam0iw>1Xxq9d+k8s`sjFlV!XYz<5$t#mE} ze~Hf#*SaT`R>1osc}FXH<;c6`^w=4ND#=^kD~YW7fCc=&cjs2-S;Ip|v>|-qJGA_p z*y=ci8#c93EqV6fa|ZjZ&j4E=>eQ7N}x3KR$wdYVvGUDUKK~_&jIbS%}UfuiYSIk02HM z-^X}Hj-l0jjaIf(N6YihpB9Gi;eQ>L^U%)mm&vWN8qn98_W#~=uT~6JaF&v8nm11Z za!{CNdD>Ts!gN`C!e}c@U(uTkXz9rtUd%u?CUw{I=>7N60vy9Z-QzT&M5F4mZE;G5 zZ(F{-n!|Ok-nE>4l};Oe!fD#|OKQz+Qiv_W3_E?MH=r-ECIqT7Xw7XW`x6#c@iZda z31;b<9gh1+ebIThC74|wR}1cEi`Wn)MI@WsYj?w8IeX`1Bp7|~nHd}cWVb!oL|K^5 zvYZzL2Lu@GsWl!Io5|lLpT#^H5Cu|V$r-H;dAd`bZ$`X%B*asg5<3u@6;%6*X zx^WV#6Bj5*DE4oax$*2&B|=BPvZUiYvNSCeQUQ8hMX5=jh3~2HrWE+;65R7yXFDrO z286BjEf5|Ky;Nl#XdWg+6b)&-y^|w}LJY2-D!>0|>{~vV@^biF#<}Rv6kLx=dxNKT zf9k@HUeRxn9w&I~H)SOZrEbVQ5h_LbuwI7qnC4pf6WKub$kTGU8Lq%?Ax_T49wD0O zsaNh1AfI&Ks5P}tW;$`7s<;r-P!D~@c<-+?r1n*fG5gvnJAfrzf__YKHgjB7Gc8G7 zWieuBrB-XtSudUcSVY$l>DzOUw)o-AH}-x1h;xQQJJv zz5aXYY$U!+;*@DFh?LvpYxKPV@2ntM(UuwS6)R|%Q*^$UU`gG)B7H0S)$JK#uvzt_ z>9esY6N%cog+c;TWGz41MlYSO5xK^a>Mv#uKgFl1>*?qao$7`2yorSIVvuqcm0%V&h8h>| zoQD{r*C}emWs7!6yVp|*sC5Aq!w=6zLX=)b}S>>xN6rh(*9DFYwLbe6C-2> zp731jFWQNp=}y@;iED!3WzSJ|&BFRyadPKP{OMT7DuLL1Q zB_fS}Zj-`s_B8SjsC3)q2Rk>eaV>YvSPPL^XGbt&OTlU@9GV=vq_tLAQ;zigCDS=G zFRsK=>_yvwVu=m%KE8=kSIIfQhx`#9NydPAU`QKo5ID_y`ti{&Ws8}`tV%GyqG#Qo zry~ktr2N;H<80!mLQcDgWEpMQ60j-i>@*8~%U5%m^nSXm_mnZuV%BU=-{BSwyWKFx zCK$X4?s9n>VfL>MYOIRmo!|S6&cWZ%N^xl;Oksvv;l(I5Z&#W?cx@D|CRomlLKp6@ zvz_pejIn{`N3h;(jp>IA?z&ap>?onzO*_u_JxC;RNk;_OS^E&=9b~H3HpfFl~EAwt!w3o)%%R^mOZHB(%|E^V)i}-g}$N5y3Pb ze%=!WpN^Cc(Eia9XT{DXPhoKEI-r4cXs2$uvUkDezs1ky1Op+rZx=G%t*k1A_M4Jd zOJ9SFz+Gc>V&y^o5mVUT!ApCc{hj;iV30CKuQFM&Ahll#C-L?~F>!MTitJDDd<)c- zM_R#L0}IY6nPm@-bjD9t`JL7mX8_Ge3ASe%0e$1~(ek+H^v&KjhzEQgl?n z{ze1wEMJ5XZRC9SFPA<@j}O#bLrnQklxJIl=Q>Z3(As$whqWkz5(jPN1DhqeDic&& zhfo@xIc}iN+(~it#)f{=dIqUV>S0F}lqjPLH9lfd?7~*2CCPLtjv})nmLhlvqv7cOgFyoxIYcbX@$zYx{>k|K_iui2LXtQpxH0V*& z=tmEMX8o0lqt2X{Q4pZ+y2M%jcj+C{y45S=A~#dZv~@@H7Z# z(-0Ux7*~gx{6AG=7y&1!9Hv447-1-nJtv~I2rolh`MQ8J2Ezh585jxt@bILPKe~QF zD*e=3cDj+{lF)c*d(yGG8AbiD1g#O^knJ;w2u{?d!m`I?$k32sy9qgXw_=tF10M{Q zPGe)P1Z`XWiWQ9sTmOPhruww~#>F`xcG86%KnPxpiN*5%A!G@xmeJ6I<;K?bpslh`6~7g`?nP12(B)?;(Xdj!cLIq1`=Tl~yVENdPV2 z0^wqALbAtDLy)l|RBf0vqOoJ}w|m)au;6sb6KuK4HzuzoT=aP%r!fLZ+*5*G_En5-Y! z8WJ)kvgf=z&3qsjDtr9r5YrHa1*5Rfu}C-^MJmW$WDt1#UTP9bBokNaWdX6SF%^d6 z%BqwSxb$)?HDCPrT;8HDSZY%N(J)9rK^1%uuTj`sEVzdea>xKQeCaej!Y3*ue`594 zUQxV+S!y>|A_#~tz!#jH-j#^|%>!#7$PoP|*mdsNS-Rv@g|hdpZC&JYLC=kMnIr ze%pYGca=r~Mgv@UEHN3^@L|d=-e59&`k9t<2PaDoFk^VfdZ%g$g(m}XF?5J}s0k*f zQr6j0j0qxE90?dveQC*{&w}#Q4fmkzWK`~pmU~E+QpU*IpOZ195U2?nLYE~dk|gaO z!8>fDt{L}&WltZLSYm}Mt5rkF1YKLSf$Gq_o3ekdyLs8QG#p@ZC)gtqmr1LIAf=!) zYI8i8fkT1#rI!s3TMfnfr})w+v6}_Z_Tfk3Q2mwzkwLKc4|4fOf_TL zBx0VIBHfs-_+?iMDwT{`=fIN1$!>F+<)-@U)}$OW)zvACmZ`hw`~>Y6MQk4T3OZ01 zeMTara0(NZo_(ifyTDXL@mSuAf;f_NI9iDDtgh<@Mf?02%4+kbQo5cCJGHlFwS98E+(`vNXl23o$OPnv{!o@Gmvxg4&U`bSXG6(5|Y+G#B|h z>M>e%)^WDQ6{P^#tCwbQeg%eum^nB6 z*Che{uWE^`FrWXALaIY{fhjyZC=``u$664p&KU7HE>jb>yoB;nvM`cI%}Q1mYh1>v zZLgFSEF+rjp09kQ`hF?Py7)?tzW4rEW2K{oqg=}@bs@AxL(_>ogAGA34Oe{fH5S1K5lq6`k0dQ*F!2F=&?Q99pm1rY~Lh$kny&nw%(guBA1aLt#qOjZViP zM(A4aht3A!mJL4g28ayt<%cC485o9}+kU<5E6EyBKJRJK?Jij{`MSP8y1KqsmMj6U zYO8+dU(?S_O-UvulfeK0C)qA;HhzZapscK{iDcwbpnyK^lg+k`rL1U?v8kzOGAXG< z0KjpETchxAvn{d8EV0r`HPZ?;!U{FA_z$Bhq2?#2+ckEY#+SndBfb6+{*cJJ#!DLD zh=%%Qvs&6#)P0Dg*)?)mol@P90P+{j8|dy0k@Vdt2cv%f$?-2-Ey0-&uPB82-RJBS zmcZeD6e;f5Y6FYyyJnqKV>l(#h-4yCdsB#l1R}oRzJ0(h?Y2wXmLHZPq&5*QE_mV~ zdjjsJQ<(x*ppgA>H=j)Y@{7=hpg0<(8msJ4+j{&c%wlt`YXdw|vKnr3bh$G$wE(J=WPXnk*>bk51=2y4^nt@o4csiflT{)int1Uj6Tc>R7ZoSP1&B-m zLaF0K`H&-_$m-8ck9mc95a{2GwFbwh^DOhiFPiGRzuf8@dqr>{wp;0M-muE}!jLQ~ zuG8urO&Lqg&1*+3t*l?%+fuT#VE%Gq^)i{ra&Hy`t&iVdxs7+^S5?46WoL*K?xtn@Xt z2-?p%jgPoLQrb-6gTOhDODGz3SLrby?d!VOGPCx>-?d}bt&gS$5-#$Pa; z6)c|AB%1{suA>jb;t!07mAoK`o{z4H>Co#35`xlbMv2|OmYy5Fi5^xvt7=jvW%xW# z@N`Vu(1C3?gA*Z}1;&dcS?H^Ho$bCdKYVe9TMO!FvQ5BXif9Xkd5b6?3XXj;o8 z)h3%rgPLdZWXAmV*Y&1BLGCPfvcNPpe6ZL>2(=A8v3_-1&~QT61}j^Cn6`r3w>{Ij zth%B6E<537*a$OC@p|MEoFk3Ty_ln~Y}QzI_fMz(PFZ@E&ez-GUi%;h8D!l+&REzM z3Haq@esLeu*&@~0zY$<~={Cg&IuQPj-@lno@f5s>_WaJ5-kVN=IgdV|e*^wdxv;3& zp}Bei!kKc}kkC=_rE@I(=6i zwC6Dx$cP|f!6Jc?!U^itKhhL3T0E6zIS(+ZVer}5d*|k3VpiO;c~wiXe*X$lEiPNXPhHKmHIr2+hn*yd7<1V;U)42M5bdfiO#Oy ziOzCnE`fq9@|O>d7Z4u=Injf1As!c~SuE~lnI z+2s$q*GXC)4dTu$A>?&8@S)RlG$?C_e76!9`0lF~fBRGTem560A=jFC8)czPaM>-v zy7%xUabYgo60M*ZbP05~*unp~h9X_nSt-k(uhnlP83jIh@kw`ivg6=?%vhhAY^45H z@NIfLJ8k~JyonRwbGzl0kpDSpe2@?Ub{h|ye?Q))F}{`pZw0j9dlkmws?hYNeG`VH8lAy@PM2~Ldvw7N$?xuaoB5SzmrzufaDkm(AS z3*YUiRDk=2w(4tDkoe4bE+>SEa-8v1SPuBURl&sX2a9$7^wUw`J#xbk7RR=*V=GdG z#R|Sl0FMX-HQGP9{ZVHI)k(htg!_kYJ)?371p7xzIp(?E+*MM7I?pMP51X)Tphu@Y zp+g`(Y2^E|*{pQfW8rsDIQA}d^HliPr;OVTMGSa39pcUO>h#JAcJ(&;&GZ|B zZ)FID>?88&4ijJx`!h822_^iY`rt*lE-V>rOZ^vNC`t8RMb}RCbG7px9B%596N8{dvYls+xY6)idwfgmEn&iH$s`Z9IS~c}&^RpY} zFaJ$l4~sIns?EWtsM6x=wuScgMlKiL=Qzgw^AU_T{X{3`=u+~EUl)JTeZ~7~R84c- z#${4<_&s*}jZbgI`FwwhJ=ZsXSF)<;hwvZCY3^^V9|AKaDyP#A8|>~~F2brcnxiy( zmn!eLIi8I_1#x0}%2l#_4EF_vZHH@?;k#H;SyA+6CQH$5`tK#YWmFM{HrqSMhW zRj-_w`i_jm4+TrVJ3pfBq^4#_1N(}Jx8>GqeSej?m%Nt>S(&1$L;FdE*gZnbLu+@PNf)6lXaZb+MyX7^oz zjN&AHGix@0Q*EOv&?{-td@TBYmUjkfm3IaZliTo7cX)Pzm(xI zHfBiYv&`|}VWXj+&P|A~@oC(#m91QIuNF|SFbR|;oyC6RN;G!Zht|-g0jRwfa=f%8Z`5^w#DNg|3VFcLp5%vLgh? zEUqfZu-beY3J?qYURl}EiC#f6V3TQ^f1}il4MVeJ-jTGSv{eYeJSv+kwJwUeSz*T- zsC^d?1X;;}0KiSDo8;b7RuB&d_F<~9$H1Q@(t{>0ETF&NYxgFlFCRhxj%WEYg+p+d z2-wsnX6`Q!6wX}txeUb1Up)M#sG4|Ny)p^9~>J*?P|#j0)&3d^MJGgj76kr{n!)7pHG@ zg`UsXPDS{XoC^Q6auWwV&dkm36phfP(d`ZM2Q5nYBBjhtvQAQFiQE$*w)DjI@3gHo_ zAc@H?#sg*-(PjdfCm?(RqdQMRKutD9!+ zBNyAGBa;CJb-FU_r7;yTMWL5d8GBx@S zKvJpBks{k1)bW@i-dX9*y8$`DEkkQk$ZLreG{zB<=CmSMK0^KqzC`JW?0~PXPr*eg z_JJhC*h_I+T*mQZNf$YPy%7^VnwoY_#MOqv60m@ZJJ#PxItcX&Tfxnqp4pMA(9{w_ zt=cHTps%_3K(MQBNC;b1ZsGD~8OV%Ow6H=|1r{cu2f`1sA_F6p#h1#|dJmJVUiO;s z5Z)&_@WC-ZSPUVK$sPeyRd4p!%}|a`^$K!1@tN3lg4DssAqEd&QKwe&?Yv`s8&>*I z^ZgoEd9nkJaF|yNLg=B%Xr>X$r7L-vhm@G8p0{NNdU7G<5Mvmk__^?v81vtAArmX# z4|uZcSw??nU0FwBm^pHC-7nP;(rAHG$=}n2ptG_Ii};PrS$usgw`+yWZ_T2AslnlX zJwTZ*hNG+UeW0f75bsS24$B|345EKGU9ZX|?_m-Q{ekh2s` zsIHG%7a2I`FW}7UcB6+O=iMRav(4KZcK!}K|FOtv~ z@KR{UcCT{pkiXN}q{Tu`PB-V-ve%&atG26KQClctcERm9|gk5=ZKKw=aFHhcwJ8$P1E^%r&TAToHsHjuDw{ZlNJDiMwLl)M2t!}(hl zkW&0f(>{I2>CWH3_?WB(T69(|$9Ln=j)B1iNpKi%uUm!&pi`KPUBg2ZQox~jZ{q|y zb;VLRZ>db1QepvN3y2C1^sh1`LmJa9sFp9Y!_azsF|xf{%6Fe<_pt^3?6Smk)L6PE zLs%}`gYvhxM!WH)7w3JVkLY(v6r@|VcXDmq(Kp=_Sl?HVl)nQT7(;E?`}r>-~fMyN#mF(-qOxJ00D>{JeI$k`@Y z?Slpg%;&xp2_~m&FBIo_KeYV1*gT^81S3r-pcd~_xkzGF6@iuW+ghZounK={eEX+S z-*4HPg2;A!{^X~J4dXJz6*z)Oq*Nr^96f1@MWybJ>Pu~y^v2Cq?cms&$xw`tl$>SMXSh3)M5ib#P;p8kSu7 zjV(bXh48R#R9ivQO(4VH;k(SH;UB1}>*yegBUed?ACQw<#4mB5nD{d8rjh2K$`7?%h{%q?&HI3-YR^K>arB($$SxcECtSsOZ(sVff@-y%m`(t=qhV>{IbzphN1h-C50s?-~GA@_zw;f-ey6N7<3 z5LX|0H1oY)fL&U5iZ1z_?{MSSHuU^!>oh-Mdn+otR1E$(K3{1NrfRvY_@eQW^SD&i zj6!wMmbQ-bYSwARy7f;FX#`%}l>X}1<2)VQ)j~I*K)%4i$V^FT${ZaVf~>;FK9frP!G()biXK)?i2^0dv*x@i-hlDl+u!554g|W2|+`2Mf?dY%F=OC z;1kP%UaJm_e!{<-6>f8j`{`x;Szb|ya`1G8ZL%jqTu&Sz`#iPH?G*?z=*LWO$Mb`2-c7=IT#S}6-+H{G$u?u)drBg*#FjX)ph|1_a3)r^bvWQn0 zW&`SNT&UM(!7n;}DQ0#X&rmc~TfA^lj^4?Qnp{KVbdIHU2x|N0+~Brb>AaL_=yXRi z%OB^01>&=6Ucy(%hy4!#CqUT0TgCTtB!7dUTVhfHx9on!hW)f$Dd`qLHKrh$jSm#w! zSy2TZ+~iSJ@8)b&eNwyC3vsn2qAICR46#wPUWszd?&IDz17dVuU3QA##HX9?-QP*>*Pz+>;MXAU4XdY9#>F3$OY~XM%0e$P3r3C6*N~(|j*|pt7cQ#|&O}P{4ZR$2PCxl~ zcN_e|a#89%h{xz@?G@a?TE;riZth5l(xx-3eJP!v)sH+$gSK}nF3-u;sfT>)mJKj8(IO>(JyVjUcVkpWgnlO)ru~`-3N=rN+la-8a!q*b7cG@lGe~+NwW2H}(TZ zWNtIxWZ4^=|87A&gDjZ=Za2(W-aCEi;pvk|PYAAMQ`_ncQG{0ewmkinfq@H7ABQOJ{x^g)8}g5uIe1bjYF%m zsoxTjJFl@)T4^mc41YzWHmWp4VdbWsM+)Hu$d-c!UF~3UFbwUNOCopUO)-VxF2^`C za1LkOdBp9qwE|UbV?s4pm)EDogf;lFhWWYALew#Xjso;fp7jXIRBxf}b)(@=wwtq> zBC3cB;YMf63cGVwrX0u?2AuaTX(uc6y*<{($+tlWc42kOeaOC%g(bfZU_m=N<(pAR zqfgQ-eg>o1oL7MPWytvghUaIVUw&dsI=6Lu`{eEJ=RMQAotK>#Qg>fXI&|A*lIq7_ zm-%nuP7Uo5y3w}r(1&jfi+N778I@yfeiwp=;QO^TuqvVu8v&r>0@wJ_+pAxmuKj4w zFX=|cl-ZZ>mQ&tCo1912ombk$0jCok<)cJiJ&Jbirs4UQH=L0_Cm#Pd0TLajo~cSM zz-qR3ahQb%BZS#=I87Ox2}{Nbt7GYQb77Og>t`HBQMD77UgY-le5fj3wbY#3S#YGh zSuvcTD1;H=bVf!^1hdPxzBx)SN$9r9MO6-N{jC9(J^@a%s$PEpebYAwZU@$0b>_cv zI1Kf8e-nzjZ(WExHY(OvZz<|dt}nX9tE(l@@Xs8E*MCMgfxo?vwmX#jbXFpd=UdKt zvNkIIt_G`eJCwH#d@bH=YmkKA-4w{+?h%mY;FK0S5zUoVShj?<6(f(acdcP2ASjRIx(od501on5CbzjB(_-h zC4!VLKR`gned*t4XV>ARr98Ot@Lzx7J|W$=1}CCUt52!~e-BVNdZ_O|p4!KX=(Q_J zjnicJ$EE7O{NYfRTB!iuc1?*9Gd@nU2)mX<;xYU0vB8&tj!OqqcRDY-tQ-Ts6n7MA z$r0kuk&V1lXj3pr&MDFIhRn?w$;98t5m9jsbb|hn^GH{&*f@0X!b0u zo^>37r%GDS@rI-1KtqSMF=ouD#luVl*HS1IXXhPEO{;|A@hV%jEZ;;f4NOV_P7*dhRgiv6rao$=gyLZ-vDWRKeNBb4>3)paz=TGNVZgL6tR%-tzqE0g zUqtG+*CpP_Nv61wlvll0pt#x5kor&0o$ZI?Q_91N+^LAobVJ2aWA>0tIUaUd(NsAB z2=;kea1|Va6Y88z8@)}b_xZ}A z0@au*`>bs>s>)}xvH&1uEmzgK_u8A-Z%5zxoY=+b^v_QtXrYuPZ<+^bmF*Oz8qLTb zkGz=9iD=O(8t?~wfisVvzke$A@7~+n51LCVC^6}u!zBS5 zNd5Mb%RH)-Eo~(xPh}4&vX6vc%`jCC*D8l(snSoDEJeK@WqF>oWVEQTra~;9j(ej1HW7 zNZ5^N&t@Qahygd0KIiB$PN5G879BclPBq`ll4MwAAqMtY7b^NjXyE3gaRHx`Up2x( zMAM3*6z%Ue+qHUr^vaONYf8#1U(d|G)M}u=?z`~;sgY9*cm*6{R*>{hw ze$6>hkTWRC?BBmGHB=t1RSb!82P4m<*VYbztnuRU^>tmP{07(X+?tx6D2`@QN<44h zrN6PEJ&kVAbnBSyBzYsi!}?|GzD)pmTebn$En4L%1}9iWo|qYTx=;Y;fWRKl&)tK6 z{^Ev>?R}cKC}tzm_6^h>Jp%UjqrmzfN(QiL*^Yp}hUm@%RGeo{ItXe!n4I`C5ScjNP_e0Uv#H-cH>3Jg|8x zXDlOcEb@Ys7ulj=N>!s!gXssdu5u2T-$ecn9!puZ&~U{ag#4iYX4PC&L5s<_Z=K0$ z@elv6$^p&MjZC^#BU{ph̍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�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

l(X_I+GK&R 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 H00000K--!s literal 0 HcmV?d00001 diff --git a/previews/PR237/assets/inter-roman-greek-ext.CqjqNYQ-.woff2 b/previews/PR237/assets/inter-roman-greek-ext.CqjqNYQ-.woff2 new file mode 100644 index 0000000000000000000000000000000000000000..36d67487dcf5fbe3dc6d0a6b01cf4d29dc997765 GIT binary patch literal 16272 zcmV;BKX1TyPew8T0RR9106&lb6951J0Hgo_06!c61ONa400000000000000000000 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 G0RR9|PM1{x literal 0 HcmV?d00001 diff --git a/previews/PR237/assets/inter-roman-greek.BBVDIX6e.woff2 b/previews/PR237/assets/inter-roman-greek.BBVDIX6e.woff2 new file mode 100644 index 0000000000000000000000000000000000000000..2bed1e85e8b20cb3903206a6cace251c52bdd8c3 GIT binary patch literal 29920 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 literal 0 HcmV?d00001 diff --git a/previews/PR237/assets/inter-roman-latin-ext.4ZJIpNVo.woff2 b/previews/PR237/assets/inter-roman-latin-ext.4ZJIpNVo.woff2 new file mode 100644 index 0000000000000000000000000000000000000000..9a8d1e2b5ef22b97801781478d477685dd6119f3 GIT binary patch literal 110160 zcmV)XK&`)bPew8T0RR910j^L06951J1C_)80j=5q1ONa400000000000000000000 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 literal 0 HcmV?d00001 diff --git a/previews/PR237/assets/inter-roman-latin.Di8DUHzh.woff2 b/previews/PR237/assets/inter-roman-latin.Di8DUHzh.woff2 new file mode 100644 index 0000000000000000000000000000000000000000..07d3c53aef14e7e3aec6b11684395f2833e0b3d5 GIT binary patch literal 67792 zcmZr%Lv$_-&#Z0Rwr$+nzO`-Jwr$(C+gsbV?LO`QF2BW}O|r{kPEImsChiJrN~#MhCo%}i{g(o%APfXmRE1Ro zbtu_@Lai7BIbZ@CxB`=Xm_imXfH^?OKx3g`!~Ot)5rIbvK@w?aP&tK{5%V?xxMP`I z<0g)aB@2n7+HGBkc?`q#WZdBGK?zF#s-!jO!gt`O49^gz0DgaeDJhbfS9dD5APQ(K zUwz3s_7l(}acaHlEhM9a#3jJUKkvzX2j{b}p%>CNAh!#5;)ju0%nw`1MKbleU^jc* zbEI5{wPK;s^I6t12VFfP(9(?}P@E@i@ClYJIgcHBb}sLtb-E=aFpt-3a99z<5+K?( zozj1MWYx+V|Cs~h&t~QV^@qa zw1o?bz3!v^hye)>F&JFjFh!olBSSNNp)|((+hQBn5S4>dLGDx0UJE<}b~E2dW|7fc zAsg?>9DE9F=6AoDJ0U{BrFQb-cvd3f$IG;o5aW?Js-|ZFF4Y@y0Z5`?F@@rA^k~cl zB!BL?tb|68NYm0pv!FwqP)Pp76k`1q6Ou02YIqp%To+1I5sOnf20bHoiU8&=!6zbd zlJ?s_d-b=gsgQzJHxPJMbLL!r+x_+PPZ8|8>&3-I2UWK*rZdta}+^WXK#90VRE{f=7ZlL}h>sp(LuE?s!}MbN$_ge{k?Y`Rmo!I#=1X zLny=+2V`2bi_4o0W%Ngk5QZ|OJItZ#mr|?EL<^$YWVYI_VQQk6vx z2^yHZh6^w&(98O{*XpJ8_`T-$+orJR?vG^>f}rh2r}Hly^4@JgPA4P_hZIN=1(wx~ zruVdY#*auKLT-Tbps5W)==MgjYuRDcUOawfV4TcYf4++Gt@7K#+UEM7~ z*Ap^j0L_r89+c{OCr|wuC_SNG-oWS|ERw=zBf%2C6*;Zt-4#9vzh_;f%vh70Q zQBNj0RitAC1LQnebUfL4f7%Ux0Y>T$1owJ!xnw$;r%|oM!8H!&J2QeQ(&HO4ed}+P z72W`OBf0h|5#EFpfxprHbxpE_*nx2qcbl;cOQeORTbXx6+2-$h8gYm?7f{recki13 z^JXGqfD@V(4#*nS6o^i3nu8mLCN0U-)G`w=NC+L%dWTM}R9}lgtK$UY@SLEmcG@oo zt#CVZa7(q(nL>uLW1Femshs@2z{OrAjT1$MgB90Kc8(19*?cU%Lmrp7^dbknU=l&z zUJusyQ;n}T?I~hA*=gZ^q$nw%yE!vVgFQPwBQ|Qk@jEDBYj=I!z(tw3xFn>xA}pp9 z2WUPNRT_J|oh2hKm4MP76Zb=Nfb9GCch{ceW_ng z!0sZ~m!LK=SU6BDrrbOhIGl_wGWe@s^=i9EA9V{knTIGu|64?XegmC;NhqDWnzHFH z;_^E=)e(4mJ0px7dj=gEibPI0u=)g#dR0Pt> zN0v`_y;S@7>#5lS;`O1ZxkLA2C9j-#!sXQeiYD0t|3E$i`vicOkR&h}CtF&@QBO)& zhD?wZX2c$c$SpH~QXZHjHFFlvFM;UJaaNN*4+Z#6aLZ z+Dbw&>th+~9UZD6D*6`KwZm8rRFHAO@uHo?s%FFNK$JNVjE6GF&@cYO>FsAQ7k+^$ z@*+ry(K=$sBm$1aw4T4WYpF9P*S<8#74N#D#iePFX!NdccANJ4j0WA;smj6@gPWam z!AKcX-C!e1o0>Eo4obVCtJnF&0j~}JHuc{;_~&0p#iQszpplqGpp1|4`<_~(dTunf z>RN1`T#RLrge?gEVA+1~eD$vJ7C~uI1dC()f4aL@r;}nS)A45JaeQVyOK4gvmq#rAzymL-90`PtwEDp2jN&{jFaFUBH=bMZy#dZItoJ7Fa{(pCDsIs z)CChWhA;)`>6`-~%UMA95Z-a_DfcmuKqdW%Vgp^kSU@L~i1vVTq1aH*r-T?moMAFJ z13!S?xd-}TLSOK%*dQJ3wJPd~s>u-HrvYzLOO(h|a^@)!Z%JoUB}j z&oGM~z;*;v*z@vp{NqG8z*-a$iES?de)Eg@IQv6 zjXv$l30ER0G(t55@@4PIQ&UbuedLtPR5omCheo3Vl1Dyl2Yy8=zkX%aU)FyaffnABHIdK;U7#9}mJ6^7VXZF7tvIAXEo4#`kY5wV>O=zk7YX9ygn%kqNMg z9e9D+ zC%|QZwv6@44 z%-2yp&vU1T=rzr1oS)c)k8cXOL);1*kAth43omp6-<1!JC9*m0wSFHnH|akJyl1Rk z{C0f>w9t!haSY@1^IMSRup3*wOQRvC<%UWvXjbs6Ky8|z|Ma>tnoSsRyOwfA84k(j zSDwh0`oBBMolMym)^K#akEx>TJ9$eET9ZgA^|zX%VSK}>1T&C=hW(BuC)Qf5ltx=_ zKi#D*PfiqT3^t(J)h{?n8fC#EHECK9$5fi=%@xeh>T{If@6Ft|BPQ=|IHeY40KP)J zBj=O;6R23y7yLttHLFN<1h^>AyK98_m$)i-*AuwW`9sd4i*NG8G0$Q(D5S{8vDqjT z_R=zUrDYT7n68OD_N!2Rg?4_yI1-77)U{K67yAwE8B#;BA{6i% zK#wK_46k!lRXMrusW2JQ*h!Q#N!%9GGH#1)AT*qgGMl@}FI1rs!X2{fD&lTNVJTL3 z73cVy$=7G4dX4%2ouXLA`t%!iwbJS*jA+sK`f_p!p6M(S%h258^}5PulS+xC`7b~E zI;{T^!D#ffJgo@tTQF)@m__+hbFlzJ&`uW=juFZxcaeg}lCb|A5;}-pfd_NikcNu= z9tr)u2y|;KZ%gr+DVaeBNIWcfJmS{@<9aqWqu=+q`ZYseFU4hKiq6B4d<1k9)U)0D zs@~dJDy3wLrsT&9k6F;0GdTrZxg*{4@$GPZkfOtI+bZxG@GRF0$78I(+<3xChh)t~qkacwS&KLN zHHFg?YAO#py*~K$zu0+CEBW8^xILF^k93TWVT4aLYoTnUCW=QiIY1MP&tv&R!(cDX zbm7o1ivD5TeT4Rgl9=h&nwdNmf%2==sEz|xR+fhGaZkh~5ZBU+f0U`&XsWY%7(GLA zD%EK=(B=cUh}qS6T-#GuwV14r*J)`P`>V9^9vaBC>m)vzn<_*F3?awl^FA#OWk^Dy z9$0E*rrcE3M00D?>2GQl-8fd8)&5?Yys+1M|654bh`DuP#X&4na3lGWI9sL1)028` zhzpo&LK*Y*5voOx!^vn*2SM$Vyy@XjbqC$-JX!!xN>BcU@{NZKYS(|c3SzhF&dg*F7q|@r6s$k8m^m@lq&d!50wo!`ZaEY)hCD30PWtCi-WHq?o85M1{C-G}$ImacMb*i+`j z4e?y%vx7M$Ic}7d8`6it?0h3=%%|N7Du4d@N_y|~C_cjGtc@jGJpY^2yFl4;Ge7Ot zF*u#YmUNZK@sgJ%nFJf{eVuY!DU7n6Q%^ZIw0}d6ayTXEaIOCL1MQ@JfwL*oY9|-F zw%@l%(OCINl4b+e3~@1IgFuIKtFtkBCj+1H@HulTxSQ9`j^R$lW5S{?FYIW(5V5)T zAm{amd17bU5-JuiJQh9N?mc$jb}&pNIuV&IGY*Y5-S@d_m%1_o4R$!zrCz-80_JlP z_#$GA-6a|*GNye!)IbT zoUp6wB_#z7rfNDuCd~QHAT@7Fm;8;NG&ZpBKtrF2iJo3GKgKIteWo8-Woj!3KD4E5 zlq<==A#r;7`w(7%?_Icl@_+^!O0igWF{%2TxfiynSeLnD;*cpWG-H+hAH5h#qmr#- z!o7Y7pJ&Vw0%CM9zA!E212G=AY3fOvfoP#FIGFF)aOg(Upg?IW?r?fX!R9fp_PzvU z*W^6hQ%cGz{qwqsja;&=YIrM7l!c({0o9vBl+LXdd8~!WOO43XZ78{LzU!gOW;uKN z-KK{2HWhYDmpIBQ3veMl0y*%i(Nd^BP=$_z&zl7_D0yQY3yve4y}u*^-hN<}rT-;2r&)U=7q0oa zstbKQTM!k4*;7J`9kR*fdQcZe;ClF$4||$ZH05f+0BQh3tNbhv?sWnhriR%{;_Dn7 zZR}KTjhObQw*&)phv(U!{(X~>?MTp=hj$~D@Q2f1((*SWrtUAeE5q`z5$l&At{l(I z9dd(N5#3gffGa-@iB{ZWoDaEwiR$I?3F@T3B7q_t(PWF9k8=j&+y=Kh(*y_ zzkLZioR3Jz#X!0rLATs*s>bPhL)eIk@EDfIHrsRSro6HF9Eod&!;nzU7(^MmXii6k-Z}bisNRsj&Ay7ZK}}WGK_heqe<;g?8}|o zhlUL!WGCEZ!dZ5G!{8&T?wk4fJ;@11zVX+Rsqp7D-#%zmN3didn{ z!`@--ds>ag^H0ODT~AG@jHjPrzHnbtR&o(RM82byWmU%vl$nNtiSadCo7dEpSI5S7 z(9?K%ut!(D-#Azua{j^BTt_~6lBo%d%lKuDr-N)( znbsmEEWC!gLwn#HwOi%teJI^gaOj4I4^Z+A+exd=Ox$ijemh|Uk4Hf4qGWS)y8~~D z8SMD>h|1?t@I=;slnTVD-Xa+S3H+4^7rZbLtVTS-Eaug?F_O-nUVcSd)9U%8aFTll zlJKR8!9J~BzgTp2PYQraG0C@pu#c~(T4gz4jYPeE*%LyJ~T!7jN`M z*;%3Tan4n4+eI8%FP2Z5ulpEJX74hmPu2QcS_`qiFUck^yFNfvMXlNy@AO&U0`V+P zW_MlA7{G3=&m!E^FD~+iMsN#K2?=v9S8+-E{2?SyJ(r~H zhwVEmr@nw?6VoI=dA63M#KWJYCkm-tvEd-Z-bLjF(Ij zKNrkx7SBWP0GZW=bJ>xL0<3-F>J343be*~CKp~Xy1wg*-?$UQ#kU=cg?bj|&HX>F# zrwa#dG%anlpoZsTwrF@P$_ss6mgG2hs@luuqNXQEnLxsUQ88?|N)qM&(9deofkMcNyXdJ2Q1g4F7uI*E>sS-_P9pWIS$3 zyq@UpT#Rn5SsGn-WI_Kbb|2q&;87_YO%J10@^t;7X-g#4Jqot&ktY6KvFfj~sQu)H zC6ARH#WEBBD{Cd2(`{%^trv(Px7`!0Ab**&dr2>fK7O)L${VD*%{84f6pW2uo;;D_ z57u+qWxRmW)}+AR)t$MQmk414q`!%wvLRj`-sIWH#e2?4bmg3`RkvNO5pukY+U@-A zzrp6brSmCw>sMF|vML_jJ(pr#*yhTg=p0#xmFCuQO1)$|CzgC$y}x6$s!;H@Zbx0x z*N4knL?1>h{{eq1YGYlkeKo<1p5lppnYi(9-S@goNC${7kY8@DovD`hYMbd$ z+u+H$9U>lA+H#==@_&31Nn+6;Vzio&6YZZLQF%$>l!kT^|$bJhtMn9<_0!eeOt-1L3S4ctR(b*+hG_9)=loEw9vcrhMD>GVtb>!+9Qz4rYr z5^T-I>Psfz>C6`HCpZE1evhI4e9%KjjBQ2v&dn^_ed_FDh!vheQ*l9_v2FiCnUDZG zJO0<$TwvN*2%k@SkrPZPDUYem(~YS#h!ZC&iuXZph#6^^-B%y@>5-<3{LRH&;|8^O zlvvbfo)a9OemSM z?8S6Aivp!wlB5?DtFZJ{R=gGU=JnDnZ-)^FtUkQFNEP1Q%^Sep_pSoAT(D)7UGs#4gX*a&Ab!^y!1wGp8rxpZh?H^M}h~v@iW5N9fhqur-!)n{s}P&?|=264HRh@DMZWLYCil{o%TrQKgj9$4~{ByV2;f4x; zV^%G|9Z^bgO{&Y3l{xE?*cj=}<6%%<7i;Ib5$g$qQH^!M1R6;I>&U0XEpQj|r^ zQmKi4(AZJM9e-Ubk-H=0m2<;gJ7hP;!K@^zeesMw1{8Y*mL`LNY9=00!B&!+>_RIX$u;%6~d-xU{Vq{;_;y%6i_kj5yWGG5~GWPbI zmh)f?3H8$ygt7B`cL1Yb{JM?UwE-Joz5Xm*i(suGvve3aVD<@q&ePEXgSH3NT`u24 z2V28*Fw^uf^l7~QsPs+}pDoAH66|uEbVsi+avU@NBrK}841BU2Htp5%RD&s$oLW1o z@xzz}Ba^VXN+L_aU*Be8LBILNf_^xvh-1RBNrQE4-@3&!q6dRu6_H8#p{jO{cU3|l zI&!^!0!rEHCszA%JUV%OTZaL4a)jIo&rFpS8-qC-3)^pG34f7pR|l$oEh&4;d*R*L z0*e~S9dW80??&el)5th4Oc8&)()7HWNmIt&Gdfxp|8}Jlj+t+TCHLAZhtTr!F3-GX z*Y4`B3ya_LAnKlbAY1{7Zq1ja1a@t*rK~?agNykg;0i^78s1bRO2-AUl0rI*yEQm3 zsI;tly|dDD$@N?0nWRL<#xhyY)=tXv);|m&C^h@xe3|oh`{u98AsxdLQhj#faT7*{JjS{+Ien4*a} zd;!wP=;MqB*!hLFa{DuUPszN_R>Bx?#bT5)xKKH+hrM$9+K`1Pfy?wO&xqAifolp2 z`wR$iz*a~P7}}?bB(*bbOEz?LxYkTeSu(YGHM#`IMhUVZ7!X*!w~Bs?V$->93-`sU zh=DkbYBl);$!zR=JJ0~A(8{6WQjixA2Jn0b8Bgkq&<4cM_$Fh}kZU$+0NWr&@K<0k zm5z3(NOO3-ZJq@y%H^k6CKORIM2(4HEi^cL$86r89qF3Q1QXKd)j+29I$K!|D?y(` zDi3mrcyESUzC~?NcKpH+Yxv@}Hl)T%FB3AJKT+zG$4_IrM3_Qn9kx{u?XA?`e0$BT z0{vmGPD{b9_HC%(Kqu6fJI}2QW)LP-${!IzH^)^lf}?Asb)5;==S=UFvt_Crdfm7w zIbZH}_PVzhZSjKdsOdVF_~G?GL7fYWFlM^64&=OAwyZ#BxSCQDEGdUEOwjW~gUBBs z20heBAsEWQvtN_Awf_xfNig^TEdx|bTS-c&7fL%ve*9^`#3D&3e1f+N58))gR+Ekk zoC#h>Ov*$#*sEd>99l}rf7Gg`eHV+gC0YnBkz%Iko$aE$MJFpS6s;B8bCwZ=6Co`{ zC|i<4i)byv=fd#5*o~HD)D(6yD9IuQQn$g1`tiDeICg-iWZ6?lc+DbqlF$|@({NOnunom8 zP*RaWF3(7inxr@!G$ox!LfzzGn1j!<0y}sM%RrXXCQUXzCoWX*&#O|n1`|6>MG|P- zlNf(C;!L8-i!InxKUX~H2SoqsCuQQ3y!o%RS?j=z z?Z^5zEv@dohCD>?T+3lNwq$7sx8Rua(9@5q(x|?;wX^m$L*LYMEjd5rElA902&k=|o(A3BV`rWoh9XlyV-t{u zLWc;KB0=gZ5No282|eWI@9lOlz@giQf<(D@V`hHAuRjzu*7N#~VWn!Dd@ht{7NSXj z3g9MVlb&OUrw(YwEP=}YQ&uj5BX~L-viXOBelmO*xY0qThqD6H$e@jAF%%Bbw$HKs z@KvCN1S1kjnMrJn)`rFB@o*4-6ktF+1YL?$rCv?o{7fXGJWrAGXhaEAcdJAIa)2}! z;Wd0!R)an@&DF~heM6LF@zLnrEB!1ICyaOa4pY%(6Q#m2Za$I5)I={h!mfP;GKzbL z!qgo{j8}BV=o=;j;r<<-Ve7?B8;aA6x#$IZn~0Md)>HobIY9%L0*uK`9F* zFw8c#hm%~?4v8rr)ccnjR3+5{6_u9XnjnN>f;ZP1TeRn zypf)NxgT>fQ%t&HW;WxOQ=881iN5ftFY~Rr42_n9gL;TtM6@&3Fu#qXf>h1^CxR2r=3$+>A{4eheLbUaF}+iSb73TlgL9>YdDZZKK-G%6>- zr*9@8AdR66;5CMQHU&!wJ!uEWw0NBR3Jk{K%2cGNAAjo+#r=lK@C}B z2FuR2FpLE$saQ111M8T5UBfY1im_1q?@}5=xhC?GJpC5@M88mioH^)mIjzwxS3%n> zRAT0H#kG0$hTFZAT)lINK_Z96ZZORHHoWJZdGYxVy67}@89uYyP>eFJWlLjE-!~6B zxqKEiEp`9MxARvu_0E|(Y;_vjO--!Ys-lFb90sk%a>35veLefHy$dUR4Y%LvIYhPI z6dUVI^E$*I*{s&jsG}T@zP9B2&k26Lk1k5Wu6qa#&sa*qo6K3)!mG|9WJ)}qyDW`w zb!^o3N0YpnXis+g(;c6T`ct>tBV>Uo;ysTFuk$idcf78 z+b4RQkSlsv_VPc4_N{35XfKcv*k=Hx6pY6mO9)#%IDw1%eo|Hbp@cnK4OVD-(HWQLly1)F^AGo%$7<*kL=qE777VDn`wA<5XvHPB!j!# zLZlWc!9w%)-HO?eDccPb%ioGjbqMu@5KTB3?1w4RMBp3iu(E;ilz%l5_D(^lTzX>J zDpCm)S3icVGN92G*QC9`K^qY^NE!~Oi1;r>1#W$EZB}>rGt;6mn-Zlo8jq&cZHasc zayPX8ZY>rC^Nd`~FmzxG0m+X0)8nkhEq}Qt~BR8EJ4P!@TA~RYjeuajS;Ct|BNUaWI5i15t)BIN_Lq!9%pG5t3H} zmy9&7CZf5FE(8WL_tE#@9L%tykqyx@$O5;!>b-u$;v+fhpRb?>KNO~r3*~NGY<5k@ zkIJ|NJ|7ukQw56(1ob-1$ktg*T~$cZ4{@WI%F;hQ3W~%%Ui6Xo8FFARn=2qUwXAys z9gV1=1^hQ8W9{MS#jggllnV*Mwtm;JPMB7UB8Y%~ zgYO@F%%jd{Xu9~j+u*_3pDC>Qi=P|Iq?dRD>GH33cyhrm6f-Eg5X{Wa$_Ck5a13Ss z_}5}#K@|25#WB9!5DK}3indUr(@B&Tsz5Pa!q-wy<`kwm2T(l&(lME!^1W!Qhd?{p zj*u$PGm9c@(Mis}NeXC=5zLd1e$IC@wkHpvAtv)0M-=W{F3uMN;5mX&O3g4sV(TbKNSJc9=Gob870w$wNrR+=# zk}k9070N6hb$q86)f%X{M=o zM0OwR+h#Z;TzD>8IuaTRhKGShufqm^uNy|+-DOBIB(#Hvlat|3+!K#O zQdto(?!=Lt7_RapFme$y+aabOqJ5?TVWB%&=?I&Ga|VwH5Kodj5_=!fJ6P*MP}WLW zjy<(sT&;QdfoYIabOUYRZus@JK){)PFT~@;z=Z$SnoR#exkk+Ju1u`Gl3?%570pNF ze4~yP&axJ5T<-<|=#gLrUdkiz$`kJ-@WvbO2V&P=N>dDhZs1KEq0Z2TXc(8OxTS&-3>s zo>A{(Vkw?}*UmxPWkc3|L24f zfZaZaG4>T6Zs_}Kzg}rAzL_KCbC_)S;zp3;)2}BK zd-}ZRkA^$#^FB72e_8+WF>`x29Wo!NTuA`9?$3*kUe9mj>hpEFVjBSdWcoEV_&q_) z?|y0*2Ta)u{;=1};qTBv+!2cZ(!KWGt&(R5a={*RIO;O_M{Yl;boO9h?&jLx1n<4R znIir?NO1xL?#t)sSqVYE`j_npLH7VRGmB6A{=60A*z@1I8<}qbjBXQl66uZMgWbFU zdd*%IkUDG1uQ)d%vhe<=@fG0~Uxf^q1OVW{{cpnWK*F;U092C;`Sn+E=gM?nVs0*- z_=qx|5^mg+aEnfCskBe=B6Jp>|&H7gh!eq@yZ=>?1t5T8NgasJl z9IVId^QYf7z#FrUKns}5@5_WrlGbnXVkNC!Wjj43I-mPc1-b0od~_TP`@P{9wvH%% zH~ZBHTE%@-EI5R(&*>Y-(GT!GoPB-*#B71-L)+5sH9Ycf`{%95R^H(w`RSHORl)bc z&K0SMT0cv&d;0tHWh!N}L8Q--^;G)bTQ(c_Ett5f}0L9gDu5#7X}CeTZWL&x(!Td0ad>kcNuQ=#r9RgJt}x_6V~_tC*T`)_Us zANDffEf=$R&}yyzhxY+F>-cLLJ$VdCLw{R;S~SgF21%{B(20ZM`YRY$=CSHbvN zj}hp4$+bari%CrOFrha5KkI90WsS}cYsP+zc398xCzdnI4|7Lc9J5nqN^LTZ50UN_ z4?TUNdQ+q+ymHGr5%C#H!$qP#3WT!m?)GONYvmNhKE%?yun`Jx`#x@_+6 z2*7%&e8-g~hK%=&$eHWxsG2PBbHR$8#$K(~&7`C{h(h!PbBq%BvgcWCMrsWE63>(k z1&zZvi>T?J>mmRx1zMWC6;+B*zT0J=DLI7>LCRgZPB_$Xj!gwc1x-XkH7g^9Od@p( zbo5MKjR|5l?Mx{ESsn+U_pXhn^}nMD(<1mUZY5 zpm*`0Tu<;uB>%cfs*4l7Fp!5|Noq=lIRrU)D=md>YfXZlYCAb8kf)$Shp7TT_*UvD z-zhVYogyg}o#_6ME+OQW9+TN88J8XadWG{z?5UO;Y`za~TLZmmCcP$r=;*Nk6IALtEKFE%#wsUk z!fQlBNew=p?rhP8C%WIP8a(T9@R2owLFX}MBrFp49o|bfc>${&K`ycN4vj(~p9Ghr zFlI)ohBR1P5e1V(Lq(^i2}zCP&E#ECBXt{*cea*3&8J*y?cZX$C* z>xw;n>!o?Kq7NE7x?e%5WN%ZGew+M5hAwTLo3kV6e(A8QqF#+GL>;H2+H5MywUYDb zEWy7c88j{1TB6gdQ@bBq%oKs(26pzNgE+u=r=LUM^}J|7^mRKv&?ZQnDgv}|=fdb~ z7GNVI@V#x~d;4ih)vN11XdiV{I2NSeArjI}!N++~=|A&%SS{Wfr1*$T9!U^vP63PI z4*_WbzV&87V}FY040o%b{L{2`t3mBv6ugg2_!D&9x(6%>jX@&Yg4O8fmNRdOVlKH5 zQkB`(L^VS}?-BlT{v!VPG>F^2x18lXmv~q!5NRJ& zm)m+&b+L&z?}6noSjkubN1@64G`TLCw8?~mojMU`@^7q9jm>ln^P{wTQ&Qsfgi3<* z`!RM+nvrJ)dTWTbD&fZ@Jb!yp4TXZA%YDaP)Clb{8IC|m6exOpp!QpKCH&`tU zJ}y^}+XP`AW%pMgy3@7AK*}#ozAlHo~=_F711=Xp{C>kB%UTJYY@FlG^1CS^6 zsPIZKRNZWeV0Rz65y^za+M1a|i4R;@GBSZH&^`WplQen`5J+qyODID8&8L|nA%9)o1&IXkn~Vw41Hrw{msIb-S=klG zVp2bNitcqAjN@->U1y7@myKEb6pXuW<+2#M+<)0j?)0wi<4(FlvG}XLzMq|RHTC;O z+RoT>*JuZkHL&-_Y4eh;2iv}KEPsi+w<;CUtlw|qGCYo`!a|jyEG1W>O81(`LO=6( zBab1oF}A!Tou{F4>S(RQ=R{5`v&X%+-deqA&K#{!{~;yf_RlSx(z}fU*Xo6yw?wzZ zLn0zKCh1ERss$<4sRq&#}U4T3-2( zo8G-M4!UB~Tvu8*fLo(NM`Hr*9=1)0GtoP15_yBqRO&)-%>3+8!k}&cmohXM z2qL444hTbk@Mp-Wx3;p#saj@4^2sGmXwsoIY1p_^0Xbl`?iX?R4T%dO=d@w)rfNjE z>R=4Two1n(NsDeS_TZqfuFk1oiGVYW;cC0jU{M<>lU_sn__Ax~OsoEEq$^ou8OOt+fH;{BE0tqv%0cOmZi@(Hobq;*x(dGF>eAjT@DQ3myY@qBmzDY#X3RbbrY1I*rv@tFiak=^%YEIy8)%s?ORx*H~(J5cw z%57TdvH)d~wE@0fU{}P_(N2y<-W8+0@^poXsp=aC5Gu#>&yDrL!WP}JQ7z{6@FI@3 zyKGH{fr97&OK?Y0t{4%o(n3vwyNTJ#u>9f?+Lf^0JaCy)G@PkN{Q5&+5!E7hK?S@i zLnW1&P?IROuC!^K&vi?*i)?yMHFM1Fi!4fLm7!9eaDL3Pwe{~>FqIS~lp-zKVd^Jd zJ6hIap;snUrfyAy&he8A9oQ7<>rlx`UF8mS>JN4q!cI1Md0HUhXRdV#d++WXCPXi< zN!*7tRbX*PiI>DTm%hXG2?h+s($Rh!oQ6%*28JRMMDHazOw?cf&KjGnCo~_2Q8e0V z{?KWJWv&&Fc%A!Ys@odG}F2CN2HugDti{tQqlJ7ZL6G7XvX7N zCefWuvX6zKw@lzxP7sZ1^Rv#9Kbo9#Z9Z_}ld_kNCtIHR93j}3puG&m1~|@0LJ$}^ zxT(8PFPhx8v*3BHcG#RL?*{!pFb7NV4GpXhvL=#s&&!_~hpOixpxFh-&=W<$bboDV z%Blx@BvM_?@!drX?OeQPAE;rD(2!DFXP24gyq(k9MXf^^t!8@Ib7n0iWlMpt&FQ!W zekK;Jmp=m`i9joL-|*vdm6wlMKlXHl3=4pqn2=iOudy7eqV3stxFyd%e5C<_MT&7} zi%yO&j+XM;%;!y@9hBGF4e!{e<&}wNR}7cm*!vLA!h9^Qqb=ooAqqYnNxoTp$NLYP z3!@N-?X~zf4fr|Vv&rr?NtnVZ&I#y8fDcJ>r zxBauZHvTZHL)Oo$B?pk*e}jxev|`8SLv4r~tdyt=jyOYkBiQnmV+lG}*#$#ZW|XQV zp_VJ3kHVADwhF3rbsmA~f?v`s&RNt0_xt`TCPG5kIz~W3b}8*YgJJnYkPSE+J8o;a z>>QMAyjPM@&QjzkO%#Rb(lZq`pF40a)D@dfSp;SA;h$*|XQjThpJ)HXCfQbRkp;sKSRy@&5yesk74H0iOTial_RT z>N%g!Jr>g>ZxE4xQG?PUX@L#U|HGh;bEqRlK9R`*J|wRLm5BfCXtg{TCf6Ikn5BX! zJ1G2)5s1vQO<9$~`PN&i`+WZi`kohKCV>Gk5m3|QZ2m)d>Fe|ZB&C>x_IL2`>v#$` zVS3U1+{ZpR&4Mh<`@?J$=tkuX2Ont=CAab?iXaE|OiY@~!DS6e89VIrkIl#xou4t# zIe+Vh4<*GR;@dSk#&s?vVv77ks9(92RUfrSg0fHdWb4!XUyxhlschhmf+fL>PoNp{ z?MSn@8~Pyl_YKN3p&l=|c*egIIeO%e;IW`DaR^FZ*fZFOv}R^G#=aSWnkC?09%a%7 zAD~~&)Qy=b)Z&D^wsxF%nWD~IWMRPUbrQ67@Z(Ch&lh{WKf}SIIL#Z^9zE@{FgfXN zuP=;F625QfYW51>w1@s*Cn(!lgT*P`9#YkWA}8lbYwp>=E$UYefJ35M%=NNtdwQgx zYQ$}zHAKIe{C*~r(+qSA)>mKkAbME-ex&6n+hP~roucMryg!WP`5S9aQ^f$S-%N{SK0Wv`U=RB4qgew z)5;0I?gL@yY0~6gIh-q6v!?%~<}bv%(%|{7`TN6br4fTyW0uJSVMP01w&hXSy5>!4 z>~2$Nm+I_I!NuiQBsg>f1xkC`OZzcsJsOFbH+&QGPHawT(uT9Pb`$3GehbDJGD#3; zsc!awC$A>)Yn?g|WeLLkO>rNQH%}j;;p>vh={M#jQ+!%$u{7Y#*=Q{9QRw8xrwhUS zN2HC><^Df}Y`{qc$Die8vFB@dZ`1v&!a28BkkbpF)zu7=Hx?rbhShb2SI2@i(B7gY z=Y^C0l)#7HQiM+Lr*Em@kp4a%z0g<`WL`Z|^YHNUh(VrkFI|8&^2&0jz_6|I@YJ^th(}-vf#* zZ_nO)8lMUgmi~5&nHWjB+2V7)dv-+Ysn}I*niztAE*`n&1esLqq%}9xDbw(3dg4Gk zBf~+XgjX^gjNdfi_J}zN_^W>KnfR1_Uk<5wtY;Z@kYS$~|6ta|{oYr%qJ}~93EWPL z|3l-uoSwW|7-{7@YVHy3tDEpRJz)H?>zcw#jGnud^XpK6u8=9Y?4``&ZY>4ZwnY_7 zKweO>ks(p1rc#g4Xd<&1xy@>nI*JLu((Cvm#U+=Jr>Rx4n)}6}s z502RO+k=6Tf0cEk%0k#1r#yI_a{06K*H~OOu&6KVFkuQ-g%ZAFI`_Z+jrL8_x4IAA zv5-($(L0KV6|k1S2d|nq6^T}2=p$S&>?SW(T2XWq?VSs@?Tu}(q<_75#{pH-42nlb zQ%P|~|8(1qZTW+38w!Jo49L06wv*O+)8d=_-*>6%OIxvbg0o_(8X`RCx!xMC6)>AKRTUS0 zDFjAt-iO79?*c>bHDKrs{wg?Wbm06?JrCEeW(y~0l2oecq{PYWt7{K?T7KGc065|J zq;pam0`=d}Ww+2Z%0c_O(;Gcpw@%leCtk?kgLCS1?A=MTG^IU#m(EYxY;XG`(~s@B zIOk5M-h(Nd>)*6?<4ouBFIwyL-{@{WX~_3`WYOelq4Uz)Wtn|E2@$Tv@Fr)G!_x<@ z0qE$YVEz}Uk>dg#p9*XX(z_hgH5Ac7Ob`N8Y!U``}&%}5D2sm{oPr|!># zsKj>9e4=L|>7YN+?fH}Dl2d_Zt=HHyUqpIMFr36UTt)>u4ioBZH{W)^NSYw1mM#94 zV0suHSWAvm(tGlf3Gxb5j}vLT$fSJdIa?!4NODF9nOYcxiQjh|>Yd(JG!wvvHrrHF z*!|iUv)v}{47x5nZZPct30sEhJB~LOnsJQV-M1FFBjaI_QKSqH@X%UvqFW`avLSwI zKb^^l-I)VF(Uh+L8r_yk8sw*!v5xg{(~;S3WFl_b*P2;cbs8sCZO}^F%#$1-t~9B9 z5SGS07TKVo-|r)wq11TN8L$KmCoQdxgegNMp@UPz9R7v{?{d~i93{?E=B6}yaqIyX zFkVoi#-RoN<|n3sp}x_>)DOw4#O5~MYfu=>-j;8^cW!bxtFZvHRw6~OH0DY&8Zt0T zWo6jaMhV?7gr<~vuvJQ>S$4l}soZ?LzH&?WzNwqm;w2-qiuU1-2d)HRF%Z68ctML4 zy;_imKHE}U08O;Vg#{7L9t*UHXG`VuHg5p4Y`EVf-+by9g~9#ohTKXlif3=?F%Jy& zbtlXnFoG%^Wmw!G!LF8-VU`*)G9-<;=oM)RX053J6kCq|zolZ+@!C?umlwLZ$0Hjx zjQf3rwC>G}@I2Jf+T`@~mQ;fNt>e8MF@lkPvpx}E%_yy0!~*X$VQ+iy&WqfSDLi!> zoCafIIXT}E1_1R@j5U#VqOTg-{US!gDiYk8zt9u(us`aFaW0QnbSAl zzr*e^&y6R~*i)@MW?osbX9QTd=_{FEf62{&KeP7nQf1XqI92B%3#HXwMwYS@&P^F& z2#;ufUAU#J$>0%kVk2|0U(bK(NMRDZC>ky2Zg6&&@B}cm217^2&7aK1e$ShTw#?L4 zZhrGSKU~;Wj6R!}k6vq&7FzmS4+f3{BQX7(xhL&ybhS@ZxVK9!La9gRDW|#DO^|PBTyWdEpPgyHYCnMpR(_;N0&=mXK`v? z_vHjI-?uz({$g@f#brV9F-2L$w8Yi4RcE%XSC+keF{^rFYC>9nAiJ=qO{+f2$7SN6 zQba~=v#g-KT0#YGX~JGa@6`5rCLtPy-Hm0qb}eJJyR?mT9{^T652Z6rYKK}@@uW3L zgA2lGGpmsPwMunv(EOQ9oK_W0Aj)D;n#{@hl<>cr?fYCC4pf$=d*{bACsQT+{rpTb zi5knl3$JITK}{ldJTC@nX^6jvOEuajabCD{s}ymG~mFo zG=2S}PzJfp3n}zQV%owOO^iSuFLlzyE;;vsj)h zyha4N)X5KXrOc1NCb2#&OicWLp_KLOui{9~O-|%?HBpRLTPP;M%>{0z>{xq5F|Gj5 z`$>;A{|^sm;|$}QUO$4~4L@4Zxw*CBDl{2iSRPGfm7$Pj%*ATul{+yy-OW7dnG#w= zciTB_1DaqES^n=zQgbGNC#aUr36F<;tUJ z#Og3+x&iL=W~p}ekx1KcH9vbnQc*oq=wu=^tvQN0BvfhF-{b+gf1l^YZN)#59EuH0 zil!?469LY50T}9`aIf~Zxb)PP!X-mEDWfcsz-wesI)urLu2!}X-Q+VnYmx9`*Hl69 zscrYO14-iJ_{tj0LQYH7vu9GEOHEuxb`SA)-@4=<*sQ-Ms4TxEDxcjgU9n1TP)m!( zbqW8>Wt8W04)~L*?v_`4+uBh2@`bExlGnmzbSCnt2b&UjC@CaC5GaFlXq_zraMdf_ z(d3`0-dQh}6Hx5!dMl|qqZAT`wb^vjZ8^4;%d(=9Q(uX7TH6rWsUlg`a+d8js;M@L zG%QqV&b*Zz8W**|$WjV}QPGAI2uX+@gF=$F!9;5mWh|zUKtSfIqG@ypi1_^*RAFf> z;O(uvBr2cVEjzm}wLvQ@8q;z9ozE!C=hOv~tL|4+eB07c{`#e?+kg*Fx9b|0Ohk0BG3oRnU#r+j3* z6pcscmB-MzV>op!VO??JAaa$Rdm|c0{+a|nwX@M&%c<+z#Q>c77A}0e33opxdAqm@Ck#uO`J%Loft09>J(;^}un90oe5YiLV<69t+11X~psJ zsu^N`0V68DT?aAC^JmS@R6Nq014;Whi@AZpJFD`uQ9gszKU4CTP8ttSAAMGRuIwIo zu@7uTHTS#(MtffNfcyvD&~8J~kJZ~$`@ZwdQwc1zei{(+<9TCS)+DKt(qwPNo*g{l zLBH&-3LunLIz-qDXvj`i2gX45L0_KGvm@iRJSn|MPub~4L)j-n?J9*Om5H;9bBo}S zZg5>^@pXp?hl)gLRabV0-+>grl_jUC++O{2h)f)PJLnJMC-GyeGD!uJ(q*qR`ud); z!`CqcHwPA<1Aqr_c$T32|Nl?0pWZ)7d;k5;vU|6jtM9zz+jnPMJV2eQ%aKBqjskqs zwxP4hg}PH(-t(p!$=wx|Jh=)zVay!th(>T>c#_Ee_E;JH{nYXo{n_I?GtXQ}aadeR zaX5F;Bz=Y2Z7+Ad=G~xgbsM)Dz@^AYVf`{iRE;bwfnLmvX=Dn5M)Fg^6|;1Gml;|g z@}ke`kihCt^zOdIsc7vStFr3i?dt+B_LeK?rPEov(IXFqWu=dVV@CvOD0n?~ zG{#jUit`mkcPrIQoKI57FP2H~sw+uxQR4KGDk;74)ydMW%R@QlOS7`%>cJjo0o>u_M{D;q_5C{aB6uteNX!Ea?8!sykA>~UN=QuXXs~u@#em=u=<3s zFR}W!`hZQfWfo!QEka9CUw!(g=Ph6)Ivrwjz0?NmL!Pcy+FS+hCVn4&s;htKleaP- zRsf~t!@E_Y!HG~s)TXCxFN64Y+;QPN!0Wg5(vz;BEW2#vFUFlnH;1hA(DjvqM=V8aC=T4-?zH$;Y1NsEhv_{f}S^dCKPRL=+}k;21B#PDz; zG0Xx|*ylf-2nCW57kaQ1e1$rE@^F*^X&v0h?eilKz_k}QmC_H@AmZbdF;oocvwJLt zn=rmf#W6Wu#Er9;dcqvTw3#qR8Mr6}%N^S9{G+FOIYnJNlTVuBtCN^GIR-1oKxsEQ76*tO~4BtlHkEyf?TIG{FS+$e6@#F27rl$nWXqB?`KDyq-1Sb$9J!he8-Z zL5vWH`HW!pnZeG7gfPtv0nhu|c#bDNEIpY~mX|_N5Gi2+SWJ+M^{|*26+?Cv#TY^)JbH`aw~QjJK+rTw%PJTb z@}|(=c)21UhS&^mP#mJEJ_cAePq?FdmgR(C0LQRt-xEFCzLs|1Dg|3bno@?z=RZfb zhb6|Mv7Fej$)d%&)~@;LOsBnwP(nJN7S)}%bs-zrjVV%xB7~Wn&?hakg7M_kn1CQj zjDT25B#EK}{a8>GCN<1%3ZQve-BH4n)@Vuw9F@+a8yiVX3R6gELH1}gFk)`2DRWeu zBkW^ri#TAfn~6t^`hwP0hWZ;YLp{`nyD#c*bY8mO)iwIyT4(j$?iylzOYMR9HX<>; zy{<048Q6+^eMiQ(ZxjrVmH|nQnL93$=^qdu5)k~ksxNo2tXOqOo9O09<;vMfSyE$6 zEocriwEkpv{8%Q{F))$>^@m_lBxVIO92E=ktq$@@a0~8@rt#GwL{?E;R9ZL&m-vk_ zYdc*`79G<9UYQ!{m$iYsnz-YZ?4PnRZ*rF}&_qazFm$3%Ul7XMCyGLdiDfa7yXFg< z93zyMYtc4~Tc0v5-H0+YN=YIURXQwa4*TcXil}k@>Q3%PC!b4HMv>EvVMDLsK_P^s zva%hn>ESR;F%m7O$i~JSG;vH;Tr`CRbBDQ3W3t#Opn~1Iqge)R z7?_Bq?Sr0a(Q(+6vTz!;9EweejX{bkws-kNcr$_#WO02YuM8C*1A)>|F>zEB6oQXI zXF*Vr!NG87I1~mA4n{-**>;jLij-*#AHEL@fdmu7eexN`sEnvsObH6DAT!9CdOX*l zD$+WQgy^sC=AP@|vpRg?-X2J26f+qGqqAdUNGxD6mSLr}%Dk>2Yk;royoRg++tOw$ zy(_)`>p7$bTgPK+sJ}6DI#?$MbZw-|3RBC#XS>IWEU- z7Cro97bB1Q3!u)$C28o019UPSS*M{3ldI_PIy#w-I8a3wYKSqJNHQWSi%fuJA;`$s zOgQox>QAkj4x5YHCHB03lY9AW3*MzY{WqOM6)AnM{^Lkb>lo@up%y`CbdVub47D}1 zvN%|A7hqgH(@=EnoE5N;{=D%*4Zp&GH+OTqn}Mg!$qi%m9Jkj-ZC7EyC6`b=;MT2p zYwJVtr3Q)gLcng&k5^o*zhkb+S7(N;chh&$w|N;%qF&>_2;H>nagG2lq6_Hh`a5XV z!eKCJO;D?$8%AxaPSbB(*DnCT@TR^S>bg1FJ31b+8=ufn!Q@Jsa7-wG2a$QlZ~>g`oAL_qYDFbm zPUv6NX2PO`t3=VaOe5&<_!>c2jyuRgv|GVf41>kayG3a#ZVQgK!aS~l(cTlFcXYO| zJ9(YS7?+Puck~wd>P$`Q-*uVo8gy^-NptTBy5jH4AMt0hPtO6NvlKDiyg-wo7X7U> z1ux`vik2Cq5Z1_@1gy3%Rw)@i$!FoTR`YKoQZhI zdf}xif9`pMl?2ZtQP@9K?#FbGdZPbdg=PcVH(FibD?3f?wh)`ZS2o((z`J&Fh18%Z zL}W}PBFH}y787y%WPLysJTfu{9uN?Nh>VOv^rQd-7{F`r>8hYw)%>7xe?@y#;A%v7@;w_CA8HBj+x&%BZH#O0uM3NYe z5dHkKV^SJAmqcJ(QCr8GoSvurbE9-PP^&D*`Pr0%QB9QEC?vfgI5S@Net?ll>xeo) zsfj{kN+1A2m0t29-%`hrgcP*T8sQKBp&ucMVoV+>o_4j$jsRk2?=xB%Gbh+d>FI2t z#Suma2x08lyE|RX7N)0z$laTUE)PWpy>|k;wGVx9-rhK0-$o5l-|VhH?;19qf&QO9 zN*-s3;b0HyfLVz}2)-K)#-lt~8K**Lq z`S>@Q{k!T=6$p59y4kz=yBd+pd-oaMBnr_R3S?SE8L*qha601zg8F*>dO>YY z^pglZCEFt?ntposFJ42<=PQURBd0UwbV7%MTNK}Z!+(R^56Vhrq9 zQI=KMV?|*KTra}kaeev}Z8ge5-&_%>3;XZCGh0BanAr4*{GL^^VKK4y9 zXGLI|#9jm?Ib@szd1D9Z0D8os+?lXd#XPKJ?8Q#7i@nqh86kb3L^#`5R8shk{Q=l; ztqRW!xfhVavwY9=;feGYm&58Hy8@1&Kr%oqwm-SqSh3|CuRr!kA#|z2J*3!AMCV>~ zG5fXiycZJF3yEzBAABu-RIwwlCOg10MnCu3yW;wR7S1k8jo9eHe5Pzd(I>#&FGMjrknPrSb3EcErA#%xurbkSsbjM_iRjP+yuQ_IHC?PX7*Octx;j&ddk zX06^WfT>*8tM9ItTLWX3iivXTw9aT3ANZ8lQk0GPxSpa2!L8}!c+_%R?%*yCZrn3+ zUmhU9Ubx~=4cWSL|5C&SuDBfAa0~gNpqic$Gcgwnu@ozziM7~}?XdkZOKXSG=|A&+ z4Y*Fr_E!s;S)V!}qWySS3Ke4uq^KnQs3Ssz3KK5EF+6;cq6nrjiW=wGQcS34oWL!YgyFcG-_H=tE`z)Md2?@~$|(O)z60H288Tl}u>c=h>& z7vhQkU-hr!pXYz_(?RXI{{U=INo>Odx1ay-f4wusO>I$X=A)Y{G;VOJ%{82QcX+*b zA~VdtC0WBun|up8;yaNfL$YAQs2h;B*--T#2@9JYBYifqO6K@lN@x>!9gk}CtkM6u zBKnemBb8sK5{GQD`MJcwunk3KKX&)JTThH^?mWn}dG;t~WkayO%DGC|5#WgZ;IU>y zZvi>;rN#t)&DGXGdQXGHUc23FB4^ZGy*~Alrv#eI-YCxXyN<+c+qr-Fw(Kq2_dySq zAP)Wo+E70|?ZX@We=gQK_e}z{@*ebKxmD1n?E**)Xb!Gl#*5wu*k6HwJkru(8>cGj zz}^;aE_dQ^kRSI!9r=`iU45d&MvR zZ8y1Q>7l1;jMZM-{DaW-{mo3>u;WH%CRXBg`n-N<+dG8G9S4Rxw!mlSI-`R-H6RZv zbbm|Bh#X{3sqOd1Gs-F$r`p|6Rt?Gc%{RfAF|NyidXbv4A6NUjKQCQ9Nd+7`lUQB0 zl%*kT;=}E_TWO8}k-@2|DE9f*j;hJs>4s9Q+&v$5g2(JoqBQfOhmx78T~ z_k{B0C;ZM1;E&G&Vi4xUmR=t-^4%vZf=#Rv(p=p&8w%qmijMi!QcbhAnV;#MKDF%i zup3v4v6WLCgz^7aee zDplXEx5L+Rz`qq|ob2PwcpCkO{m)Ww5?|Q!cra#LJ`DSZiG_XN-$!QrE#r;DeMg?i zYNJk5-#Gr~i8%9I_K6eI&A+kx_Jr+W?~(24-19g0Gr!yXTk|i%b&FPuS&KXSl$INo z-&+17+gL%Z60AzBI&2DUT5OeeB72m*$N}Z(;fQt=IjS9p99Q=Ydc;tFCcpUM#;_=q=j@O)b zv`@6}Uf*%w%YF%dMgHObEdOHvHvf|WrUAdE_5_{}d=b5C5e1Q9QR1k((dT3SZiU4ifjvSH5E{fU$UR6cavZgcdV=~JvkUVWOUGWp z{)vO)GI3-0>G(zBVd4eiGvZ$)3sNA7K$4KIkw?i_$lp`!C~!&|MMIgOT%g>i8c;o` zDC#ivADRs+DY1V+H1Nsok*{wkI*mB-!OJE0vO2*4dW!^4&x7|JCn{V zX7)1AvdmdgECH*6HNv{i`oOkjli4}!diKi%NJ4r-N5W#l-<%T83^#_$;TCh7xJS7c zxzD(N^2~VwJQlBncZF}k&*gs*XcOZS?+FpYCrPrTKaxqwr;HW3H+wi|B*6H;kklbd2V~|iQKEXuX6v(v(AI$ zrRM4K=JJj6W%+~oSMq-?oRpH~ZxujcqXD>p0cmElT}vPC(g@=!&qXezO) zQq`d9a`8#kb=5P~r)yezs;r=Ft=zr*WyN5{`$}5nih8RiNb^pss*crd(V6Iib$DH} zPOfX#P3X?*?&?11zD#aw{Avg_SzNo?oZ3ruCUt3bV|A-_U)MX;cQhC^P#ZQHo;7kB zZ#J=-q)ly2(@l??vCRX`uUouZCR*)U8`})p>RWoP!82`*2!ebbcqPmr z8)if`NdjCV%`?cEo~qrCTjR4?*xvc1E6%fgA^~I)@+%8{c;1#+XatRg!n4@wC%C_` zfrWoqlw`nn?VEq)8tqzTPyx+PxsQLrO+kz}h@_{^BjgQiU&F2;BrLjXgDnwKV@ke4 zBX`0bINr3anumS^R$k7dFp4l^Vl@hOIBCK#*kOS@JWwz%@_u*m2N-qvRT&Uq(kx3J zfy?hgI_4ao1r)4+0vf=G(bIb!X$AYr=Rl@15{ZFGiE|$Pe>sl_TUY?Ujc*uV_qx8% z>7Evzu<~Yl%KP?Ji?Df|u`J1Cg10c~@^(fM&$EMg0$kWvMuB&mntaLzdB$djNnwEk zn;n=020Vz(!j>H$ga!8V;%oxg%Y)$=PsScYUls)Em@QPvsg%^9E)0AaUQD6+pTl2# zl>fnj4-S6xn_;?ISWd&p9l(uyV7CDlzVH`POLno3pL0%`%|4>i?z!pR8u;8uT%7_G zJ|_}P%t*tG6o#Mbz!h=er~DQIYhSvCh$?uJOad+cC}iy2c$Il{?ntcKQjw2SX>(qr z;BN*_h9G0_n&R@i!kqcQ{_>ycX(z!_WAN57uzWfVd!ln*JXSK``4i|~{MPaRLVW2c zIH@&Ss~gp=waTcFMd%sz;T#?iB@|2C9czrG&Dddb$}pqU<@(#5N8l2IOx(AwV+0-8 zLBnD)XAZ00s@n;-nI)}y+Lj;8WTxni0Pe3A3Rrp-$3HzYzL{>f4?5_7>0VrDCHi|F z{R%80$fO;N16lK$rJ*;9ZdN;h6}){Y*2s=n<^iF*X4}X;XxW`wF*_z?Rb^JrcC?Hw zA)xK_&-n}+mx}PkMd%$%fBHv!UfJY}*L??UMUY8NN`A%aYDWj-6wmmPgS6gb8wOt| z`)IRxdiOG)3bAppA2LRyP3q!%8w0rn8REcEJz==9b7jHv(yM2Ke$}D}SOl59mh@EY zkaXCvqq6u%q5ln`s^#mHO4j$)R?y-%W`m)25pQ*`5E7h8y0O?fyZ^-1!4fmR|qT zbUHQyyioWo2j6QmW~ccFUg>ctn+c3AZs`TD4@4ObL#d~>U1_sT+dF#qzfCGowK~&1 zZLJTNmrl>l%`cq2_~f4t=#LGwJzQLvJ9&C(W%V3r>pm1|U9{kd0d^OALEso(p(ub! z+*1*(;9Lf-^WerfB38%2Itarkf~vqO&c5BF!C@#AL|G0^B1eG$3h%YxIc;Smg|(nvCR6E`qrY13L^zivZ9dJfHv5f9oUGZqO6ID!WD;P6^7 z)dk;N5zn~1$Uwlf2#!L4(WM!3WJKW&S=3MsB1@toF>s4y4wMZj^s8XYD_!sGEX-mz zHCxyHadpfz@!Cb*t52n^pZ2P#V}APNj(kPbybHlx%((9de0{4_bbUVEZw{*a$uihaCd(E0BV&*`SBAZ@VW6e}hTrs;4f(tQDZeurfZ`NzSwJnO z09FzSBDwg?gVXJ0+*`sh6%8_(Iec;O;;6iY-E+eC9+%_rms|Md&*0-t z#$!Fi%<*@kv70ys#%q{kSzclb9lY2vQ`kXv39<+KE-6w>k}MWuCk~%@m}|xk1$!8o z4=~CB9y; z9d3XPur~6%j~rO5+AU)}Fp5PEEA>pI=P00BI7qd_c^jK8z#{vLEX6QuT)?<2LvQKc@;c!@F~4;d%2~ z!;(1#iAQ$)@b!&gXg#&)e9#_^KI1;*BD$1q_`>EM61)wIc;l058C2!K-p$4ikhWCs z8=y9?>W0U53-LY&-qkV?^uKywVqI>p<12i+h_+@cduy z+btlSgP&D7T9q$n(#gbT%we(yl3Cs)%2Eh2yBhFEB8ign1kh-If5V86jl3xGvCrcW z9AV|s_?S~4yOD!4b-8M9Vb~3Y_K;KDMltRY6?#~06eUEc8}os{G`*EMNn?9^tBKj6 zHo~Zs#V|M%N}PWYh6+d7aLY6O=}z29cOyIf2hgNG0N6_A@w$b!4B`;8O2V@Y7^M8y zXWsnGYb#681H21Zwysuw^ut$pp~*T6rvS%4Z9TGcSx1q?927?!!Ab7%z+kuD0}4@m6Ge~&|= zX?x-V`1bZ=1dy1uD!2}}MFe;hou_yux!A%lk3iAS*;tJ|&hQ4#*lyN*bVg*>i7yj6(bBRQH#~ecy_;P|c&v24B!@TGc;{W~*goaeHFaOhPX`VpcF=Mx z%6k8K|IO3h`tPkJ2)q_V+#(?QglPIa+^s$bPC9_kx7Zvl%~>jAP@}%7>BF_Dr0=|ms*d7Ft6KO zV7D`s$1x?&l8?*Ui#7jg2_9uE^Ph#`_klhJ)0B0 zUGO0M3bw=cXO#?LmLO<`At}6q6IC&pEIs*j^-~;Cc>%|(1db_+?1c;rw4&38{JOs! zi8xFLYcHN|kJNC1kQVH11zBPSxHn0n+WsINB$LUC;%W_5wF>t!YRkqaouAChR#rZM zu8F0H!P6C(30)J?eMs8j40_!TyOlIx<(MvY#-g@pjX5R1w^oQUm(T99@EiA*H8JqX zGkFoennj`UU=g#dIc|JK^WflXB{)mSjgSU=^QPJ_5JEX=)9n_Rt-Q?K8&20Q5UFX^ zdh)PbS}aLZ`OkutdFMH|RHUK%)XU4OCS(v@-V_+i&XE#M1$8l(zF$icHAM#lAFwPj znIANgB4HJyWK28AFi0i67`ZP$5;n!pu^P{iuG_MliYD^hl;ymT8Q^66YT>M%Wi4a= zkJ*SIWlZ6oFQvp{(lem}Ht>yt2G-CX^bl59vb4L|k5!q>W;sIBWLFe9n%dR|i%#Mrj$GYH_JIf<=0%ZEp&-KiXBuOFoG60O?iN4A(|n2Ozr zeGw#kj+TjiRKDUjR7$`BuT)jvx_$qVy14BqcgI^HEr`bbR3*EZw+wzg?E?O!0NfQC zW}O>{z$WP8tHiep7B+VZ1$^5T70}3yx^7r2b;|}Oh040D8KP%!xopR1FMuf}4_XME zvb|Ltkf4Bc7?fn2&y93?6N&I{VG&70ShbVUE0B&IDgLgmKlLD3fWk2sX7y0yB{&M& zYq9sLmTO?+`1);PLlYyUk%OC)QXn|#H#19HR3g6iD?ZLXrYf%=jNL05_)>na9EfKF zjBL6NPpQ)k)PTV%O2$z>}@edwO-f2O235HMkBz6YLIi3QKjqx0dSj+Ev9P4YgsNU~z zlvBwW4RZyNZ!qkEF6bKZW~_;E9(JT8%T>BMlfjvvBG-M@y-$6{eo2AvpzyqoUEOX( z9C8#d1&pq`g-S(H6OG0s0A+!eS$i*;dg?)|KcU$6XXjkfuV9z!>U3AWbX}5vYnV~a zpygSa`8$KC@|n7;Qk`t=zbc~6h(sCOG*im1Y=8Xb+`v*60=n!NJ?m`0HgRh@0}2YO zc3E^)_Z`!CsaPHnpjBJYbIhvs2FRT*0tyFD_-LC>+An*97nQWz^ZYc$ny~CPEavmu z7bBkzskg?fEIVge(t==^9cTfgtV*GV?pz#_8sl@$F6$Qd9K=TI?71*QP}-wtbj>k& za9pLuvigFP*IQfL(9qgCbnRg9Qz+aXloi{-%`TK7o8i9JS|8=8>AsE zJ3`o>I^DF7<>;brjW&pKcQby(fI$Q~j3&~00v1F%FFI&+$IhlqW_Vq03*C6=yDu(; z18l4N!y?3rC2BSh%X)%6fxN?kY^-X#$USIzF_fL|q}ScJd+i#@=i0cC=D9^^GGH$P zZgE_=rBcgYKEj_V+!IhoZ?}IzPZeR`szFoQ%q)yH0{md&SDp=0g2{_FP z6StdQEX>-^+j{)gOkeWr}-%5p60z(;bT!%1bA)jbrhqF*ELd{o}cpLWdz*vig;u+1$*a+GDy5FO1GL2 zVS}Ki7Mk657WTdF!PL?kD@iM8oO)iFR#{L)kkfCJ_ZmhK%qt-^&miX^{B{`iwWs3F ziynuIEMvQe9D#tG<;=6Uq}{34Db-+gq~wwltC}yY=Jkm1>jXE#_uv}1R+0H&&{d(5 z-5QO0k_GBV`|yp6igX(1M2>@|j^m{)w%==}y{EjXEtO@00bYiw(Yz(VHWpDBrOO6F z&uRz6L8GHYLY*H}VzsZ>5vETCFII9i-}hbjYAEt+i86FyaMce=x#wc~u)@A6<*&BN z_l5A~>djUtLO4<0p_-Tc1vPCPlAk3HXB=0&RIWnZuel4crsk~1FIWh~CFhUcr;2Jc zm-%)%d0*SnZFqgvc$~Pll{$yu+yenc(DY7)$UceJlD;f_v>sQFn}}|rfZ9Nh;VZYdQ9ssUoC0L6Uj|eyKRtf4EbpGvVktuHU>@) z_!s7@+S*pKGMYMU1uTE{Q`wKKhNioB^ZByqp>rfrZxq&6bJKC4DA%i2V|%$V#9V4| zPACL%bAy1Wqr<7ohRD?z3aM2>o6(bsLAeAahqI(LKcER_+iF?7Ljkck!#l5XtS=MG z@&eT?xsxCY)ckltQP)_VN;kGP*La)S8mh2uUC?-DqGQ#nx(L{*)?9zNQCZo!FysT} z2!#<tn(yPgPhYrK%BGrr-xurRXTb$CwT1jyzc7iUm{D(@cjcHm)@_fgndAKf!LK1Y)32GTK zvLxw@xKcVz0Q@M;b-v_{++6jQd>7We7To-Tu6}i5jhXdtCzvyq^5YhwjDhQ=>y!c2DuRBSaMNr z6?>L#(JayvS=11n&4Js3iYH<>62g33x_T@qzzL=2-z zg6Ks451s)&(VVebMM1y@b(Q_Ps=1Q4N&c#JVo9%&Onv5ka+RKB++ylc23l0GN0@X@5`M=S73YA8+*?Q@3+8qo*S-HKIC727+ zNQvgx7bGu$H+-|cWiyS0d`8e;s1w!3nNe?MXx`Swx7_&ukB3_C{=KHU4~*q)s1&oS zB$Q??*RVpYW3z0H)Dq7^{!VjZN>_}zG>UuRDRQix`QSBPs8{Xiqd0=wQR}0aU^ijo zwNAUd0Q+X}3XiQ|7>6PUe-!7CGw+{S&CBnL-JvY2B$qGooFut{j2M=sHQ6x)Q4lI6jsg!LkuuJ##U4#eY4(IJWDqMe ztL#ZVce*X_bWF~=-yeS17p8aP!Q$%jrSlz68(gYeTVY=mWV?FftLL3}PS2gb4EvH* z2I`EeO&2$)VP7Q4+M=Pkx#6x_*cVA4J{~^Kor>p;b>m%2gcz$ZW3<+vEL>C`P0^C-ySW74bhKYV_4^OuFwS}=t^y_>aIwH8E}QVUG{`jya|UPtlJ7vgsm^w zQyVnk|6A@M8G1SulIn~W*s9I#u8YST{Oua#G?IW6YH*ReZrFd7VmQXRGz7N6gL$nAAG z42|V%exX4>B!|@m6s^!jWSp^e0|Sl}S7H>%@~%mJ(wA81mIYo2@W9k-eY?dDDk0%y zQ{y*a>R#;nlLlLvOtGRcw*M_1_HbQ=NG%~Ua>E%{v|jepQ<2Rl=9Q7_Txu7E92DNo zXL8WB0Q>ZgPGtKa;hXmm1qw>>#bYjuNGkNvLFYZVsv-P`uqf6>Wo*=&sdrO;uxj=j zR^D&gcAruCQiu3+F+l*9jO5HbM8kwtrWR)oe%ggraS}hc1fGAmtF6^+ls7-x{foB> zwRHR0XgKsn0t``X;Y&-3%*sj#V=v&gaZlLmaZ>cn|4(oad>`(Cd!nXSUPCyxURbuH z5XuTh@PZNqncq9kkI20YEtLw(Y96xIHImNI%=`!n2LXc$aF_bc#@4YJ2GUHviWAk` z8byd_ngKNL=zDruvpfmHWenzV;?|74%qpdn)hx63@I9^m1sO0V)SyLWz zJCilU`?W01W+ZF_VN@3}e6qUE{lWKZ)KSHOQkF?uTGE6dVhM^5FJLY{OjWvSAqZopl>P(Efs!j(%N=K zgZ&0$OGLZ3{AQ&aY3M6Fuuh%F?o{k&dNxYA)lUEUg3&to%Qx~BqDpY>E9vzM8}C?C zBF45l9wtUWsdIGx1bR;EK)2mN2cBSQIP4E=7Rl=uF&{m@iJBYNrd|vzJ2@?dh@?H> zDhTzy5jMpS?>o-7Ng?g);C(hur1L%zJBQN#Y#B;>Z7XY?av2*nWr5Q}%2+B9 zh$MYR+fLsQYZ*(>DoGq`4<k4RPXP28`zy@oz(UNIvz&fgj7Y`!w z!)fZP%Nqwuu5jfLvSQEd#NxaKw9|R#VsjRM9Q?-_9CC!kK7_OkptYetx?E+6Cu3g5 z;{k>srs4?_E^xm0&2B5XvS8A1iijX4y!kArLS+;;FZ1HFQmv^8TO)k!g-p8y6TS-_=k27e#rL@DaqDsHRlwDuo8?yp^9AnwBO#|Q=Y(ge;69Z zdSq~phgPknUE;8nGX=(D)HVEwhfASt)kvZIykvN|CGCq&bhPI71p^1||NBMJ_b$%I zmV1RehjhT|o@%wq-Qe;R&JQM-hmZfdX4G+3-aql^`Lm2kw?{5Nm~jTXbr|NeLok)~ zoGq3K&Appz3)s13@SVGld}mG0rif3$J_KMOA&JA`PBvkoZBX7OoHS>;AKpcSX{YnIL_AV< zPv|~jV27=t^kr9XAsZg$DdtX8T|=oFrmekG8^4Kjg(%$sa)Oq{ZYuiLk|?U+Q}$xo z_5_cbKFu29T@enfX->peui=bSwVQ54dfoahAt@gWar?Ip3sOT=eQ5lO_67R(=)oQ8 zr)0nR)hdxa;Ol6d=55zJA7%U5S@OMk8;pr8Vj|K{c`)?zhBqCj=Rx~Xy}CK&V4*5) zVtx}g7B`K>sukCpCK$X;8GH4E(ce6_2>M(&JBPe|Mv|f`aL^y@joUkz zrq)pnkR}f9Z4;8V`#a4ujP9NYQC-u7ZuDjMP9#~Uo8(~WNr_i(w{?wv({i?jYaFZk zB`8W@V6jM091eqs4GW>3(P(sBR2(uo%*Q_lfnXJ%j>QkwD8fcLS$jom{_b|$IcjUO z*UDwuo3i#F!$I3#od0ZLoWu)D9;OWb33!pdGl}yFT2|9=A((W2%94 znvmZ%#O*&IMB>^wHEqiN{7zQ16wOU!jNeN?eEp2s+=mZXUgXm-{3G28=F>57E`1)X zZ2&ev$-gtea_ELNa2s^PnwHR|j(wWpxK2f}0zcAsuxz4Gri|| z2w$dKET8&{?=EsE3XIVvyu=BE>XRyiunMwUn4kDmD_@d#b{+`*Lo3&fT15VV0puMF z23M0vnhWF&orY1NIna7cVaWRDBsT009h!nr6bsitCjwjE)3s1G+gC)()3iMNRE^*S z=b5=^sdTm|9Y4E7O(tpA&dEk{x_l|k)^hheaqg0Mx$g4Wg)CB}GB1ltdO!QHkzX0!`;4C}N2DUBzNyHX14vcKWNT zg7tLT?>0oLRWGO~$#A#+X*wB3A^BHBH(Wlvx)QuVwt=ffvdpM*HJ!;jFI zPg4}H4q7+uwFY{Hu7nH0blm@U_e@j4>#861FjN&*ZcXsu@_AaHhSJ<1dgIOJjJeJv zf9YFmHL{YYmU>34OWnKCdd*rb^$%O0amc-mg^Hl7r&@1o#g}%j>3(sywx|c~FcB`= zo@m?t2zIerB&JJ6>B6g4+iK$l%W^MG4GBmd++S!td3w05BgQ`wc5~BX zy>)hh$o2!%oz++N zH#7&0+Mx-A8*3h3;8<3|{RSIB_$^M-U0T4eatvsMS)wvrs*go`izRG`8fDrNr0V0# ziv9OukM?Il(3F^~2Byz}wyG06cV3(c1~07w@zXOyBa7Z;Z{-Rp$UsB{epR39=|Uor z%L$oF=CKma6si<)Ri%rHEG#p?gYmMPi#BfeDId?9Y&}Fg%4SGmN6q>fWA0I4(kX<- z&4APSJ87XDP$w12oYMj!cc}cE4W-VMDW~HBObTiny!7K{LEg2Avk*q@pG>Z;vCg%Y zr8nnyJ~zlfPb}YVY3eYjRR4bA*GfZsqwGlK>1CGpOy0hmg@&m8Zm7#n9D|9wLq?~> z{TStLM{(Td?ehHlBW~>jUo5yuaS8019UWlE{z=69yXnFZ=}IJiw@IbEty}0L4#NXW zW#Qdbv6%?Vl)4p!PGOt7Dc6nX*@LGe7^M-_X0#I2kHe%w#p>C|QcHEJ6*4QqYJ%*XESJ+eS&SrJSau_tD&qV|?MbGgb5-)-B0r*O@ip!vBV z**Q2BE5Hphx{rK()owMgbz4Yn-k&^b)ECw<(z@2rPOb<})WCJ9z1C0~UrW9FGopKO zWu11@(Rfb~>n*^CBYH6%_ybr(@soLPBQN_B$Q$*`%?p2Jxnn5lB6x1w=u5J?;tu9!VWj4(*#{vHO(%L&c01!~RqLu?CRbctBM`M4f=1>+R#oMS;b0k+WTMSB(V8228*#64 zhg;xI*ax@3&2-%j0k4=-bB;aa3)+OtCCfyGfdq$RS2|K`HoFCi4`2n1LghRrE3`_M zfJ(37ZoTP>UALPNxXB$SAI9bmS*}FT|9I;To=iTo8+TtWa3aSueIJI$6$)hhjqgVL zlKy<)yf4%HyMy`&-;^nmrTP_*B>kq4XPQDYN*%dNWv`Y7$$k)P+%_4F|KR(}Qh8|f z6}AJ{YJtYlpq7+|&lfaPnAz9R9>uLZDaP9uR~ME1r>5{<5DyvycNB}OXBLrD{^-r7 zhRMq|%cWHI!?F_Gq`!Ukpj+WCFjXJ7>EZ8lkL{#at3)`WtudFLdn0I@Osld-xbw6-K&`H zL0+wsf4R%YHVW(c^8O~}t{4@ozyLb}*yWJ=$P@ATam*5RI zz%f4wep@524nq(Ep#?rGY+#x+*+^HE+i8(`2t5EJ>4y~AcEG@4J@MOmU>uO)cTrf#L*yys)*4r9TMOXH>QFB>`}+e=#SL9^v>>b>k!;0ndlLmJBrX zM;r@9&c`?y=WD*jh*^b~X71efVH?r_6Mp4vMYl;jLJYhh@C`KI< zvTvVR%v9=fj6DQCp&xh&1Q8huDJ?@T1Gu#HWTjLgY0G5`99{%wF^4EBnbfou*IIT5jcQdQo<%_{t;9m%m0|M?$H zmw63&z+bhXRDUVf@o0Vp`R(hy8-~2eAHRNgDo0Ql&dDGyRE))zxXZ=$K(j1+IME^H z6N#+L4iGn4-U+`!OKt?u&Z(C=^lv{n1`cIA^WQ;2mahw)X;BXa%QV`uS`R-lMS^7b zvp3YA1CJJ4C+P=B@efl|fB*rl0m9dBU?V)lS8ZV9mr*MLj0;!Xr#K^hMvUYW{VY>q zd4}O?Au?r}QdOQ-B_)ozPi{JF7)&lnRJ1HIH4Y5=&t^dXnL<7V4z~>b*Pzo`{lV}g z$#YZ{=kS#5Pg_Hl{+)a5ElZwa?`sLT37tLBG#)`>Y}EQ_V>M<9I(17B*7BFc=ttk_ z2~DCGIgH)MEy}_1SVFcnJd% z1CT+aQuKxoN_x+T+TZ*Axq<0Y)k9D}!^&pK*pw~`Y95Azubm@3(|xeAdHlH!NE-FV z`(3XwvpmlsNJZ5BK(l?VuD0QLrDd!qq|HqSt)rQBq!310X@3->B|pn$H7(}hOsAT1 z$p-Ty+@zjGt8~LO6F~h2MI;b|`sZ^Md91|r+Bf8e+n#BzNeSEea-T|z-okT!BvrWr z!xxIQ!^wHeBb|P_5V`s|uHIULLZs(#PlAu*-?!L~&x^{{EuY&I_IR=-TJjaY1%7P$=48PHgn--$+ooyMa{HHWByC z7;iNk4E0R5>SG>vAfKafF8h@z)XRmfmvzpbo)B@h;4+xz03(kVhK8chvFE^#Z|Ub^ zu^mOaO!XnxFVzTgw6b=KCN~?_Put?tYJETB3+>}vdg9Q?A@<$N)~?u(jEdk8MwgAdC$< zit2V#`e(_n`<*&vIP2HxLb~73f|;9wnh{QI4;v1lqJYkZxgHljRc%3OBRK9x4STt? zLcg9(f4tM6I&vOfz)$)CT=CoBqb^}!!|R~4-n&N8J=2vo!fb@-ppl=!MGo@-Hm-4;&fyksI+Tz|?*ZpIq5#-f zOBB6&q&hHkH8}1p%eE?!&H?8+q7So1!CJJpZ0(Eg?Qo&MB>!OM+XrME5^}kO)~=@Z zl582dog$ee+l{~5?lft=y+T?39ZIot*7%W%PE6WiH#^d%)@BgG=pOg@gMOEr7jKIpd8T zckkF>_hdM?Om~Pw5*9)fqOP#*MNy@~o1JDwb90kiW*?HXWDRom;bbnCPL`F}9x9gV zyo9af=eN#UbNuY?52~talWO@ckH}ghR>7bTJK!0VBWm|o;$|gBSp5?;XIxDg{}jo8 zCP8|8oZmPxm1oez>-q4PCSsjn`o4};_2)&94Sr5v&Xmesem@L?sD4Ej{LyGE5M*XN z?cg>v_k!I}ma$b?t7}TIl7BI;v+PKAvM!%*cG5fQu9vZ85tpXXy|6Hekz#JCS{WL) z!8W)RcEAoYex0e3P{y)Eaa${pqrIuS>R zx1qwwvvs5?99|M_smtvBq*WzpR#F?L*&IE5vUWhz{;G*Dj$e<3@A*qUnjVL{SGBrL zJhb?^0y=(^l-sA``(e%tl|Qo7i+W)1>cu)3<6vJL+t z58N;gW7TzTKm-j3rq% zHJSGI_smCqfp92hgF&qBZc7g-0wN%@!?;_QsfT?cot(OwANjDTyNyJPoUkGXCRD#( z1Pel{<9@%4=kZCN6XW7Io&xE4hri!CFXmgS%f&4; zuuz=Je6{;v^t*)Mwp+ODUR$dP-PyM2gGD47cj4`HORA!~4c0Tq@3rd>VFs3;T*>aU zqyu$(t7uZu3(VhLJ}{M9>S#9=XIM-HLRym zPM&)ZQHn$_wacMr>Yp}QVy`1`@!#`EInlIHfqXpJTh07;yBGN8%z9PogoT4MiWq5Z zH@2F6$2JYeK_H29OR%0Dt877$1sg!owu%gDgt2^@(HU{O+|J)CRap{vS>`xNso6fq zx}XKRAa2B+)+K*eWPTJn+DDw`wW0|6#A>0SI8F)9v*%h9hY@TD@x7UrZnfsqF6nAD zNr${t*%FuV+~OE-?m<7~y!eIS89CV^ZEkw5={Z}>PP||DBEj+tNSX!nm~-D|8;!K} z+o*oieG3psE>hfi54%!r;BI|}-3q0W_7b^#2-BZ6yvQlEMsk*))m_^LnfKbmK+rS` zR}K|i9w?4n{vv)mqoKP>s3q(4nzK=dLJ+{BFZpobwJ0`6Vb}*2kBSXpCRlfCHJ|O9 z5@+ntR}*~+aYWOZr7IAm2w1eTQMyZL+QL`$B`n6w6C_?4yQS0RvT6E2uMLg68~!Qj zb}!^IHeN%Kk5#ARp=AG3I81mrIPY8cH|i7+|Cu&-J3(H=;7YNFYrq) zuK2yQYGJ*uNNX8;F48~*mtdtc)T`pA&2-Th;P#mZAp}k4&uEFq87SQY$5^vRMGbL6j{OHXl1J+mjz9%i6wQ1+| z_nZbB{&txmp+5p>APmP)3^B%80=>Jst!PR2DI%hn@N9lYZt0+BMb!m6Uv|W5F1su7EVgq8 zH=88W4<`o~mrPArj^!`Exvp>%iQi9`abf`v#7qCN!aOwV`?~YK&t9w$Aump!!$03L z?zX$Eoblu$L8f9v>O}J*qt0*SxD16_WS280ADiJIu(hxQ-c%3V%i1h-<55S4|K|Jw zE~+CZQQQNyUZ{FLFl*56T~Vwyv(biCuotd^C9v#8@?GGHxne4r&!sY%n>MG_;^7w2~oY&~&J$E;)TPsDDTJDya z+ZfN?v%LQF`wc#|%4fCz@{i@e`SFZ9AnUEDuKyBlDoaY&%-lY2Aq-ysug<*e-B#DW zHTnF1MVXHoa+7!y9Q+76BrOdI+AsM{c=4+@P2GoqfiR1Lf(HBeczh27bzuS)kBAF$ zw!I4n8{jMB*DLned-`LD38E|*XiWzSwFU<2Jy}L}c3wHWj8|MKN#vBaUB#I{;$=4* z3G&qE1KEX7m$fUp*bFDiG)i z9yY&pGoe6^qX=YF<7l#`^zN+=RM$7QE*z+>Yph=__ zR>IxvkWdg_3;I#XLIZ5B%4mnr_Rl;x2o#2_Flf+p2{sOv;eWiq`D2hekd<%-Ezki= zp&8m&)gLH|OtPg)h38FPB6Sd%H#Ci9i!2EoBDr6|WU{FBol~d9!~dz)v6orX$GKE0 zr*=kcUP$>#v3vYAo7s5ViOVKwWI;ZNJ`WL-fa zjbALYZWmg~aIU*}5j&B|lIJkYcliWIw?E-O^*Rn*xUkH>dBryrUg5EL3A90k7Kv>7 zJH=YYpR&k_MYcNf)K5C=xyaobXZLSj7s_s%tF_xG4C)GzvOc^n2)y+%&CXLR+dc!F zkicrAM{R2ed54bnAOoGDUv`h{Iz3oi*``PJzG01^uq9R_#sUXd$UU>&7z*bN{qt%t zmYqc&`)+6XoeKj2zS-Y{tp6Q_z8tUPp-D?!JS=1`X)`=o`4VW;0uYaevY=Gs`(1ir$KA}vG?f{okP%rPPu%f_lZ4Xl!0)wrGHgOvJUX`9Ke)tjLcNpd z@{9btU)Bn(j|SnBi9b$P$m%@miG}|tI|6gfjt}3!LVrXeuG459eXYLVJ|fHI-&RoQ zacg*6e={4Xs#B-(wCR7(XNb18uIAhq>DDD((va$Wjjjk5)GEmCk0vS+Q&DcDw^O{x zsP&sUE=Qpbnb3BlYd7f;~kEI_~bpZTJHzej5Rt>b6BHkVp*a4|1XM_ zRyRXS$L4uhlSEAC;ioE-a3eKF2UotfB&lNTEMY@kzCsOy<2tJyM3T)T*xiqe30< z*+SRrp$`&!_`lCq>)6fDpSJ?_l<%eTNO-g2V!2Etavqqc*Pt zl_jrtx!oWLnftDo0+@J@DIS5oqeVs(d5+p|B}fg^21fU5ux zYCua28Muz0e~cx9B=S5Yf%=qP zY#tQoiQaPeY3=O5Kv@em!bZ4;Zxq}3jRvA8GYF|s5Q3r!MY6%<+$uYtzH459mKToM zx55mm{c%Q+)#VmVP{|#R=_9%R6c3BQenRDw;b>H);$auqPfV1t2X@a2LQsS_(nyUg z`vqg}PyaYGO*?4rk9QL6k2gc}hAV8_=8UO4dMr>d>J@~bsB+o{AyK=Envzaex)nMx z_O7Vp@jg44hha;(8N?t3wGe~YTN7?c2trE|1wq#(Y1s$ZfW!(4g$$rMYA6|_uRI&& zjvaZKgblkpl*+@W5BYLyMiCq-)LD5q7yvo-ABz3!PiOdlZ2Yg9wCkj&sekSXF!$Xn z=TN0+bJm;Be{IsOY2t%Fw_Zm7-&5e6GCF=eR_CWqD(^PmYA%1(P#_cx)3RjQFpM4` z1&K)mG6TO4F?_}~QGYS=N{3tI<^KSq4uAEme){cP>0^T@GOd{Vo8jecbw1%YoK+7u@Y@%W%uTgJs({HpAD6iO2J?-E?V`O z=`%MVKBf8VGd_<9@2>b~vM3wmT-LPgL>z)b%#m+rBuwsR{<}QpDCj6N@b) zvnZ9;C+`EuOWqCwz}oP+H>$P3AD5;Pj?FcTmX0;Db6c*TZg?< z6|pmVJgt=RABkvQ#iKM!HoUT4J3H$h=)t~xr{|aP;?v0I1f)aN)D+D&plLxP^mSBu z+tG`Vp`&D`SQ4Y=51Sw^7N%5;l-dp_u)2zjbWp5yUF|qp14>c~zLAt+7kuB2Q=6=} zpyM`Oq+`ZLLmex}b3}?jOc;C*LfA$a&x9s3bvaOm4t6^_+Gvx6x8i4OsH|yl&nJ$C zpNOjs!R5o(K(`!zs6bVP!y*~Vq9hMG9dM$2an(7K#po=AVyOq%1lF^b1wp8EqTZ|} zLfI-(GbA^8Q8_%zsaprr>3?kw$FVp11f;tAV~G*!#IMKqqQo5lCe^bJw0kFgI1UuRl)$-XU`N9-Y(AT>S%uS+*WAg$ z)rSU=4Yr4TP6+2avJJBGaE|ab*hf0lO`~yYS%G8f7gw7zU5w5`D3*GHT>!}>gh~J@ zq&y_`04g-8Nt-h-DhF5|PFb2^=%LQhoWNHRA_H0AE-o`?oERM<6ic5Rz#CXLWuX%~ zAGO9<)ziFBZtW~?t#}7fyRNmsK`>dk5=l!gSRki3PBau;=<&*c5~UD!$PveJL>rkG zP3p_~mSo%Jc787j)E=Ml4(Q0b#$_%w%{b? zAr&p~6Vh<1ZK(c;PyX7{4V~h!xn<(b`e6kMpSQqSJ0IatG+;a-CH^3 zryQM4!0qMC+oI;ztA7xR)-jr<=HBkqG_?>@kbX~I^Ik^+ZFn(s8J&mrg)e&XP%MP} zBfC8sjie~ia7&V5_cwoQHfW{DZRC3lK}+7GCmuderPvAwaGVPh>6!{v#l zdcx>@R;UHBTRZ<0-&Sq(Z!f`~z_n$=3gEOpC zeOqCEsOgm}6GshQSMX9pv^w_sM~6|>*_B98J=sSUjE8EnEURs3s!1w#A3gWP7Meap zgAT|I6VHjF;bTiJvMiPoZ4MID@kV;#?z_oGJ>0~v7ymK*Cb8>OQ2WVM6`dzBv972{ z`>=@WRoRa{6^uT?ORS))3@ul`qXw(*36a~IwGJ~vWuDBpny=#9yY=!MUeug_&}N! z(MBD3Va{U(@A21tRmME11i}PBp7AHJe)v|{)H(Es+;+Qcj_{~zd4)nps(<=zm#ut? z`leiB9rXj(fTb`Dkbugi!}aw6d@2dGnebBOjKQE_b!nx&yWf`jKf5u7j_8g zeFyYC%8bNXN_^?a@KeT^rzi8y z@=ZOsjJ|GTnxB(yv|?T|oHciraxEuI9%JfVdWYh8BgbDQ$j+PZ^C)cB(Z^oDcHWE& z{5%}2%tl38QEkp082Yza>71(4$Od^YxV=fK{ZzIz60Rb3$Glo%H4UA%L%mW9 zFtd+ru!sDNmhCrn=$yFe%*0ksgN4cx6}9r|O#Of@UASO>FcQ&D{8Dc17g4b+kjXD` zts+$0i$HczuY+3Uxh=hD&aqEHDl+rsE#5O?W%I8v)LsN8tiZ3pgrqbqta}Hc+H?^U zp(-%Y&@GnaI4oBrXh~#1BrOOs_)=8U_3kJ{*jCdHpf*cR9EB9dLAdm`6{`!-6fSsY6+=RlD5WDSrS{G z#MS|!>D_=u{*j@Q5Ou1-)SU&jqL{3cnMkeApWhD=V=vqT=AIOZnyd*$swxK~cF7IsF#`(Pu;3<)3muWm zS3Bs=2`cN+^D*n!)f@{>Giok-@q5?7Bxj=`8N)VyF7p+bculEB2iRJP)zuCewV^qQ*j{C)6_V@232g>ME@ISa zX!-(LHs=B>D0&2%S+&+%f_bn;BLfhrxm=bV488xasKd0Y?>h;NMN#NF;)I2^sJtl3 zYjn(5No^-46_IpfLTnCA(}+&@UK(p`fkIDfL0BjywHIhA0c6(09JZztMYH>T~QUAFW?13i**$R$;aKj+8fdC?CAb`+nJuiw_;&?uvX^Vc}qb#a2V0Ad& z6^>@-%i(I6g+w2yR_jEl9rMK3%BPusI*z~=@D3!OgpwW*jMZ)2(dcmSnWzK^k~^6} z29IB~aS4K91cMQE+jUNy=#-MR7ZR(1ZY(q~ zyeO#}yXre&#JyPSLp6~iivq{!viuZ0M@fk;fbTk@XflLJj)~(4s5q2Tp%27R zkTs~J_W_A17g8}oDCZ>j@ZglFfL!6Ks;G#la>1szkyWd;_<|@t<&NI42+849@@fsT z&$;{ZZ$mvLmwl^xV@>C#z;UPyxN6I=ZB!hjIJJvSUP`io;YHMT6uy7WG#l)_x(S7+ z6!6z7k}2b;k=|N@3@Q!sZYrMLVq7Y*Aax?P8;{%XStOXkei7vK7y?fFzEVMk&J^W&QBgFskOA zO8Jg<1OT{s&WzpzUw9OX$r(?}uACyJPBLo}l6I2Nbn9j+S8{?V5vouOvpIq=g5hPz zLz)X}Qs$XV^eJ-8v+R;n77)iW6wQkF{Y-&J3C7p!Ng&W?T;L&uQ)dkuAfR=QG9c1H zpfPx5xFduPga8+eY#^l%RS}|55~duQwtM8;0UR9{Ryd(LIpV^2g&op z-#60z&}5b3N(C&>$sC6qTT}V7sbZ{geF(*rvaO4vq^N~NP83;cnq}lt0oG_;wT`8_ zFh23t>+0BsTx`&4EDS}N2m(k1(Z_=*&PA?$RoQpCKh!!$^o~+~*B{n)cfzC1w-Yp( zzE#Vo;Hu-lj!m;pjI&qcayor~rHE2Tihj#4K~Qr4{uOcLz&*8;K0f53y^tFkP+*3`kwGqAYL)fYQ=v2lQX=lo+g4j#<^C+ETUDw85UZq93nvo3=ZKVSOHrl-!+HW(I9*>2i%$R;8SH zR5ZBYxwarmX+k^U2~F{Moc8IqW#kMjh`Ufu{DNZE4x9ItJNaIi3Qq!=Rda3&YyB8p zco2)FcvBgUIztsoOI=+yjg7M&z*)wDhpo_fKasHj@&oWwco@F#9blEIhlVL=#o<}^L;#sI|_evr~78yoBnl1%}xDWHK&J8Zn|$QPP#is{tPv4 z@KEzj7fOR!4bGVG=|&aeti2iYotU*njVmuaucl67TVdX@KngS6$v?f{Fj073G4vx| z-5RBn7ld-DB-31+q({|vs?C8&?mXKb#*t1m)LZ*-x}}d3kAA|Knp%1v8(DkyWX@nG z(Cr63{qNX=rPcLk+Z`OS#cCx+xVrheo2%iVow_nvv2HddMkw|=I(hlKn3MdBKY#0J zqu0UCj>eiN_IAeZzSUO$jb8we+inh9*crUhTIm&+rXZz-g)nd^<>|ts@BaZUS^Gzk zIY%c7Ib`B`k0J`c0W5Ivg$3MF&R}Z1<7Jzw}sm@iGS)^eLr@GP|QhP|-GSzAmG2{^4^9 z6Oa$dgVig+<**!GGi&yP)Vi-5XQ>CHnxdFK+FiTav~^s_GRZJjyM8fHB;l5vp8gp4 zghI}R?Ow0e=aKnwSey+BLfm6WbB`eqqfeynx^*H4z$EDL*v|=!O#y`OeF|q4?K{;prP`gP zZ^7;sD*kqQ6x_@FNzV6cx0G^OK+R0YT`Op1?Szb&vlUHE7qzlqr)R+u9W^Np%$0&f zQ6e6uNEO-6MPL+sm5lYfIWsC=?N>rpoz@(CdJ{h8jOhOFEvLT&p>*8tPmjZL$^I*= zJUN>VB+XfM2;mLKQtQ#g4#J(pRhh$V4dnK0%DQ;(|Iz2r>s zP2u7>C_Fg#ui?A&<}f3vyV$Pb%Av|SHchFkxu434BL2yF^vt$`xWz~ISkxD+Davdz zA>#t>!A2%kL=EFY+f*te^W=S^Sj9M8lfzQQAO#fvVYhuWnts9V^XiRbT+JBjgIeWn zylsaTuWokZcR-$s+a2j~_~{$}3(c?xuHikv9@yh2o0pZS$t+T=lJv6Uf~?nEXLP_j zbCE}tRhLP_7cqT?F0HBqh2oDtYBS%m`x49q;mz`Pd?bwhu1d#gVxv~=%zvEm{4lKL zAd=RGx~BkFD?61D=>^gm%wYb3T`Qn%)98|y=W0#M-Q*8@_JF8z^MB>Q$4>j2Q;cs! zf_bh-O{^=15n9(9*N>$Fwd=l&@k{p_dKxr(gL^8L%Vf)()10{8!CRNl(x}9QqZRnp zvnv;^P|`UAG z7Yg8VTeoz-)jPrD2>;QS%Ni_gNE|9(FBZm3RU^e2Mr79*jh%Ca1mEzQkwmJXPJu2J zfAzaD`Hk&(YjTK2GWHLwFKU7*Ph+0kvYgQkjIUxV+HgvY z#dDZcMJ{?W7ACtU4e6PrsGYioEsCEVvg!_>36|fnIM<2u=21$2SJzh0LJ*4m@h5WQ zq-@tV2&^x&rY0yEWbTE$3Pco6LciTme}qT&6|d%Uz91i#R=`iscr~LA`8PeXn-REr zxYyX}el2TlTBNs%-%C$rb#<|-w1LSo7pZ`DWYWmWl*UC~MOr4m^PByZ>|Jx=7lF@p zBG!Glr49#!mQX)dxTm@|l_^z79!yqBnKk#E*11y}amz_p+JTF<=IhYR`ZtRlW;MTUmj zeO15F(N~OrM@+98WJ*iAqy;b5VyQ84mQXJvN{`G?>#JQ&GimLsly>g;J1j(5v?}V` zj$02Ls}yIHbE2qQT~4i8oF*&r{;TU{V@)#D-Z(wl*A<;7dQYN5wynbD;eM+_wL=-H z2Bq*!yJqL9xUMr={4RH&$Rg$Lc`8|Pm4|I}<65d`WmPh`b5IcwIn~~85z=w&R(W@~ zTw74O!O42fLdREiRjlUql6DQQL*CAl2luT+FKVngoRb~hbRD}rJxbj^^S5KrNtwmPGSufd7A=6^Wh)K^90;*q=j4f6g z@9(_Tq20d?zjU{r54shvcTp&pPfN6$H4LXRtD{CW|rO{>v%LaR*6C8r~)P$-*4a=b{zA|sA810A&3TKftcbu3Brm`%>y zZ-uUuj;QCiBtqWTX(+*Nkldc#kyGa#vOquKqb*k9vv;V2|()*@pft_D-W_8?OtPc70*MVHFA(>5wD(Jlck zN#?o1)0F}l+c_0DrC%f_Ytzwesjg3odH}2liVMVMPr=lx^{L93#}|=>;qA`1-@Fgm!93~yNN-w_X+L(6NfOdJtFlz|~HA)BSLNVJo4erQ%zXtUU zW+fZURU8$#0>=xTvgQ%1va_x_7MzdQffc}WjRxh3yCK10j^_mu7@)zn&!(5H&OWLS z>-GAyy{ncD0B3)Z=8qBY7Wy~8S_l07ujPEXZ5U`2E>*%!ljceEERyeDEmuRdVMX=Q zDRuC`o{uydg*owSkua+Lelc+ue3V@Zsp{9fKe?U#wNn!x{=_sfpJl3(d0s`}s>}xe z#NBqw!*oLIfC38earpL2TT>g!>;1Zsj?BN*E+$R#SHCQh-n%lp2*uI9sA^x}K0Z7> z979o!hMf2Ci4~IEOXpz<9PmKyLe9K19()$EvpN3u&WRJN?Cf@)oS3)?F)^<)E!&ea zt0GsGQE5`%`nc<|7VLl>XFaIMJSA*=ky1n!)IgS$^L|nBDoOHGY{jNolE7OWzK-D^ zYgT2wt_43vW#mBN>avPgZOeJ8sW93EwOZ$YyiSLrqM^uGX7=AMsLa}(bitb!QoVh} zH9k~^-`0KLn^o5r%`D(e;5|r_cv7_@{;Q?A@lQ`Q;8RF;=Fhd6t9aH3x4dhxa{)8;bw3}!#GY_(W&xw3&1e{MFW%60mGW1=g$Na8CW8vuexQ^Xrg4Tg9=0b zvY=pPhS=qSg|p=fR#Hw<=_*!q3m1=ky8~7!7Ye1tSd}W^c!9(P=tNOR3enc9vfdOu ze#4>`ga_ZytfOUDXcZ?Sl%({I;bJ>l&RI(GSzUc1B(^#^cKD{A2Ik)A1{Z>D`(zS^Rh;&W6_gt## z@eP_QhAcbVxn8+f;q-)z9b4)o1$dmCfp`*{smYx)jbht5Z+cI{_B^ z7Aj}{q+b>Ar`I@ki}Rr|V{(BzXtf2mUBGm3Ui#&$8>+Rq$LgkKz6sJ%le^;Jg>QFg zY9>V6xhaFLQUWf+X-St<$kJGwxscE@o+Ox<;Ks|+b;l$fF)mC?W1h!nRG#v|RXr^! zy6fyc^z9B&U3EIOKe>v;I}ttu;&7D0VbfrzF9R0+w>XHyP}!k|iL3yx!0YfOybP~M zZBM#b!m@>97!>2HDHT6c&R)?^@T$TPp(wG(zMt@-J%}vdcP8RC#nku6mb&DHPYp=k zVF_`ghH0GiuBDjcS-ThUaSxy=8S3tR1Q)JX*CrG1UzIs8&7l)DqDXS2<&ZeO4TpNm zZo`%zT+x7VqK?R#X#EcSEe@^wF zObuINz4_{VA<*Wk3JcgB4k3KS`ttH#t1CLMlx_B7qaA&^*=|MWpL#(;v56 zS_CCo)HD}_sqf^?5CCzt3-*ry{` zno!N4Rzdwa4XmX=Rv|a7vZA7lhJ$-q+Re@%hT~C)^44yFwW9WZ_42TdTN}Sy z56un{;80I|1Yxvb1Z@FSoeUFmyRd%Z{`(Ggdr5e_9yjaPH0^u%yt6OQ6?gyE5bo%} zhEg*!`LR2A=a!9uo3B!+F?%?8%(NfnK7}m6;>^5^&}G(Y^vj3 z8|}C}NwBh-<(_&sY6PEgRFNwv^fqW*sN^t4nOp^pN>~=@sWkFo8e8q&x@XbWoJXh9 zK-(@Np5V-yUKkd9XA_U#d7Tz3Lns`FMF4Szvdf1a-1Mv^-0_IIpD`be2Q_P6;v_vel5h2I@fSXgGkno>z z)L^mCo#5k^qMsR9&nKrJ(gSY}qq|sUFhpBKmh}E2xS}K@xo33%f*eE zfB4BX?Ae`=0FocvVgLjHn4S&>CawtrR7GiZJP1pGnJO1KZL;fXJ}4b7$@FP7EaZ9Y zd5}|c)2}}qFgO45{h|2duiqW>mf3UXzido<&Fwx8t}q|muj7?&^U1y1H(6YtYFSV- z4N?SsxT6%Yio9t;MNN@r1m3&=@S8ck>HONwN9@^z(;Ce8Gm83labhbMNt){0EGtZQ zrIRxiZ3#k9DI2h!pDgb~h!!oGIcLWJoYxsiGs~t)%=q{AzUp}Dcf2}u{^S%D9qsh% z=l*)cmqK@KsrtJ&U5%<~aN9e||)KDT_Rs=^Zu7U@}9!>5G=Jv2p4NaAgsFO2na2AT*9h)Zbh@ z=bod-p0)}l!J00S(}Be@Eo%lrb>Oj7%89|;B5o(x2R)M-J;sbi&;ALj%b=8REetA$FaCo-^xj=qQ`)uMe4c=pZShcnU=P*&_mk`f; zG`ES1KAcIYDvM?TY!6O1A_IOE9=kn4D}dQCDQ`?7-EIT!yp~Js10q3C0}KiuglW%D zLr}@8gD!-Bo+Ogv!NHl!#uxGYUsT|#A}5u*LO5b0B5SThP<{|>gg+Bl%zw9dTT4t| z&;a_**3YNg-UH~-{Il>6Z36I;nwZW9D4}LyRDdcWKjf!uTZ@k)?|q@|y%ERH8#awp zhB|x|P(+o7j!GC1tNe}Q6Mx|_f9MnbZYkn`Q5Es}*r&9K0bqau2AIJIpm%XX8_sZ$ zBapB_cVH4ev4ji&wnAiX2Ryompseh9`hrkr`nSIr;WyRW21=Y54cYg{QHYV16aoYcY<6Dx+t?E|p&(}|_Z5hJ_G5k&z6R)@3lwOGjM#zO z0?wO~|0dZfU!$*h3*ILu77GdB;_p<1Z&buZ)v6$c7YrB zu*|aEUR*`%8$)JNP3BPXK-PaHB!+O~hdi&qQTXS)qi3kv5HR^=q=M}gstUB{ z%_(NoYzcbT_JD$^+J?J5r;01psiiXaz*?Td1;ouk5qf_T1FSArt;Jf3^3Bmt3R(c^Nk0Lu{*nH2*%r`U%`A41g7;(Y5ya^E(X|_BU^r(WfozNXp+PDIBC{P%J)%MU zxs{n&S)exm7gPr~U1aXZ{ZKmsME%du23bq}F@OgwqTOJe-63tjUtTwxa#|Nm8Ygb# zz?)#*omH%YH#|iE@bIwOM8xi{pj)AUFwt1D=B2 zuP~iB!ykKO0QdFB;o$<3AnJ>CG>jZJoCL!{P?ZOieSiPj2>>lZZsXOmUz>u%?*sz_ znL+3l?08BJgNGG%PW=(j*fj-)GX?^P!^kHvE|E<_T_-z-}>K5UwAV3%gm7dD$!0a0b&a>;6%kS!~JQkTr50>OfPWdqotjsiJn9^+GNXWcsXloW18)3scAs z5@u@(a5N&>JM(90y6#Q}s-AztHlMz}X?1nt`Z;n$VbM ze#w+fhT{#22M(oMorbIg>2^gHB!~=xfk8|bVt3!Ts4&Ksh;iF({M*%R(xq&+%}aYf zGBF0z7C5$MxkINRkK_d9Kjd0|CpXRJiu{?@6z@_2;b>dr5g?&KkP0Fo^`Mb6vbpKN$bB_~cn8>l*gkCF5?@0^B4}$^0 zz+HfzujLR*Ax3XV<51iRFUCqBAA!H2-6LTy1%`oL_EWUFwOIVR~6E*mQ?TJs3!Zk>y0q|3J2rjPd zp&Wo2@H4GE(A<7RwA>T}{`=MnyD%Pc-Pn=?hmju2vS!dvje9U5fEci(-s$lG*$rpKE5JiCt zB&4VaBri?w{rjzkEt8W0toCmh5fUh#bNPvZl^)1|nUTKg*7Vhmj!yLW^WaJUXX5`g zP}97IG4kpW3%DNK%6+@7=MxTigi3s zsszC5r^S_g!BOtDj}?9O7lD82zk#F(>U{iTe+GQfAtD_^EgJ!kWh(f8ovaAnPvGW~ z0L6bsm_ccP&p)!~|3_knKl|<{0CM5qzxg+)ZKt05hj#(|wgt^}4CjsnBx=%vAK9>c z2Y_%O`5s(nBlKq8htsWZpnv+*;+DaGoO}S&EUC0;|LRl~Zgg%!ff1m@fUuYd6ijRk zU9vs;XfVpPzYQZ|MM9r(@BWf_XAU*L`BoNXrQvx-zX1U}sVCQxYCZYleP5+IXQAa; z(C|Q?m_?9OQi*5aX;BerUIG3OCSXb%-)90kLG!ec%x0=2Bkr+Pi~k-}pv=qDKE(A5 zxQwApP(h7>DE!*aa`HFZg>U9z&(&Y}Y3r4RX~0zZV9T5T@2vgSk(E-{6NL3<-vNL= zHTIP70(?!)X?N?@ronBxR-SRUMU@e>tG?+G>Tmr1m(KVLX&jHO7k{_*_4OU$9)CT2 z4!i)Lv~;*1Lje(w{SEC$U4^x5<%9P@&w`E}+z zDWEDrjy+3?-Txh#`|wNuJy8+>^ZGv_#RLDAlKkP#b0FRF>`EYSfw0qaW-GzOVaSWv zFZo~Rq-LQ_SZ>tBvnex7m&fl67Go^whl&b)N!QdrS|wQ&*2xW}ajT_R{GbEl8^!?W za~&zTS!(A#!XUcLeaQr z4z|5@r0}dgp{k}i;po3Q8Fu%jqKW2}u3$U~o+jTEo?A!e%uFW5rjwj_mzhjFaK(e& z@$7zxG+2kSY8o#+LpQDT(gqXfQV7n`_;B9=Ly}Lk3?15|29K|R=LFHe#Yq~A1S}jz zgan?hTAzxZqK``EX`$2eS|=(rMc)a`91g%*KKU$A5QNk|PLGnA7z!7j<81)zc}JKl z>r5+`ybm9D;@{2ntLm=-Yh%gSvm;XtN0zbU_5aX%tL^yb06U-K(%@N}VNrC{RKati z)trDig_m3f3CfS@wRih`^)xTCrbxgth6xaBIX|txwe_XY zf6>s`qFvsX4n>2CS`P zxu-GJ_xR?JfBVp90Q6t|{GLtjouLB5~dDM!7anZTe#e0!DATrZs zZS7j``h_)~i-A*!f!4S7{a~%O1n->SV}+d^P*BESkLORL8ES?JbyU|t%(8b51oM*1 zv;4b(W_W?-SONGU8&wEH7@8mq;ed<7DvvDCWZAir6IC3A9Altx%EvL+o zQOD^x1|LFBld>SPAd>l(@G218(!*>Cd<|;5D@Enr-j9q0s;)cNaH6^sBq77!n?*=` zwGhQDO`3xa?6Z9M0yz$NNH)$;3(e3BwNM*69;!qYWHRd0Rmbm9RbNqh@=)|u2sSBj z2NfX`6>bmfi8L;m$j~t3j_T)Jcz7px>0|5FgZO~{u%hoe0h?A!K&`9qmyOV@g3jjH znh(6QCcis{HX=*Z^$c;S{*`iP=LUCVrZGKq5MOzJq-pE_Oc-p*LSVb+2&mRjb>#|v zMZw2<{>{DKll)(8s8?0#b?cwJ_>$`*gL);t>6BJKhJAI4>Zj_GAyjq6qHai_f!!P0 zy)?2WDm!df_1!@o$ucq_(mhh7P|FhIZendhDKXs>WJ93Fv1tNaSl#SFqL=n|s&t3a zPFn4J+@4@O0%i#DE#^DSvu2^0rcf>ykyb!wv8aJ6YMerQn{a1UwM3-U#4;dlv$dXx z;+)B%1so;9MX+CyjfnlZbEdh2)^qO{qx#3&ew8)3aE6fS6ga=XgN!W4>0GRW+j1L( zr@833ad;Ilm4W*|Mg7u0!pq>vfu)=~*}P9H*f9fPw06NdlLO4jI8r&M=V z(`qYujoEquB`*Z(Xb}XIi&>g-Yuif+LzCYx%oy9`aBBIc4J-#&$)#~7Cye4f-%2b* zuy_wm%QT=Q3Zj%)&L~&}E~Ma49KmFz2^R&jH=#df#`;@iSU#^Re~alN|5PIJWChp8 z--G%%1d-0V$^C4#GZaeJYJv8XS41L-RvTVkM)qxZL!ksA-cPdtD}>|L752zwUz2{J zdG0%g-|W9_x>@i0`L_yhYnU-5)o`5LuL9eaMx$C$R0DzAvd;cz_k7|@WO%}yFg-Y} z``t!(uIIZ;%1Cj67$z@qm6j6k5bC&NL5Ec#3z8}yG&^+sZ+MTKH z=c~TI7FwyThbiR4@-p^uPd)RBh~=;(O3LO?x@IO!4A^l3t%YU@I1;9CIk9*@ zvqpKoX&7R;JCkL*Yu??ZESKIM-fJwgGb%5O>C~I)u)o@SXlHIlKAQ{n;SrERMww-% zQ5?P|nDa#Ss(38D{}$)uOjje-crHFF7_E|xh01om`1K8i!g}K@VB>9;vaTZpRVb8U z8fbUA%a zEGrJhw_t!`iJ@7iRO*PyL6Xzq;d#yll(7+(p3t1dGEs&GHPTWv7zn6U;8_QYVa*{c zHy#np6#|~(eX(p`!m`gp7CepEaL1h`SRaABn#C}5B4*5SrrjUqxEH>7^ASy+iNb`M zL(U7g7alHO)hbV&bGXIVbBA$B1_2=Nt0k4vk2H(geep5twNWiKL^jCd*Iq$5ocDHftR zUk&3MgQ6vcsW9JX5cdez$=0+Q-L;@CI}XUIva#U2r&&1}u2`fc z*byEv*1(9AgeCLRkY6K6f+*hr<~c%U-sAO+-uzXQ^!~_Sujr<}d?qidZ+rypE0A*` zuWqgu$gG)I!m#txpQ>Pfa!1cFr)#?INrS?iB@u-{V)C{qh$6f}1GC+d zP-e)N1*je%u6u9oLD`J2{zC|V-G`iA{sJQ$Q!{Kx++`oM=hBiH$knh?FLFLRzNkEQ*MTy~WR<0z$v$N6GN52%)$|a`>!MQ-%cW7jIFKil} zA2z{rt6VdShiqF^3W0RBhLB1L&aguR2CiIAh#qxNm`gT#?fnL9gTK|pMb*)nMR#WR zccI4N@tf*K-w+&seL>pmGN@Gvzf=yjUb__{N=XQ)AHGWI1nd6Bl}-gWDAr$#$+r(h zCog9ByT8%uJFouL4gr}ww%LJ6)Q&=qXkRw4yz#zLI>&6jkWIu&=bkE%~HM|jU&y9_EbyHl#n|jzW z)1A>?-SCO}?ll70?6foS@DuUp=RLBW_a*Occ#UB3IDRW5IUdKDSCV4gU6zI&|S_eU0QR$yuFbj+B3% zIWs>ojlb>To8pyk4b?yJT$htZnT#sadqK&4MM1asOcFPA!*(4*gLBd59i~hjK~=SF zUDw7e{j9PiUwuq;o7_o(=*(%uQk)(qk!KsGxmgYskY=m3?pP7!`D_tGqgv?`sZDW4 zZ5vWS9Bm}SjH+VSt=k+sh6FWvQ$fw!40s| zsrIj4N}ObKoH|cMVV$3cglUurM-*>}1b=gXc zxneq%lcE`tVI+y9Gdt*QB&5B2#9L;l*4BYQVksUX3yVx7C|}1Gt3@iDJ>$Agyiid} zr`#SWboc3c_@ydx_dl;7cRGjAqO)72_h-Q}TiKV!{CVCHY|}DWcGl7v4E(w)mU-Ia z$;lPY^{)`a3aUSuTyB5m^5j}}nnSaGC2>6orFRQB#@4CVdo}aUgiC25QM6b$)vR5t zLKwopK$sk0inQgZa*4ol5n?>UbZ$|)f>$-&GC8c0OQo?eipp&$dMjWB#irShHmzW4 zmSZ!|Gz~98h+zc7_d{N*-~7-!`RDE@g&9Bktv@SDzmtY%2d_*#NzbE~>sRS%ZcE#- z$zfUHGS}5u2D4cyQXckz0fj2@4GXb0w31>6@T@LX)G7dPtPfY5wMrysdh9O3T3)5 zdo>-2=&_!8FlM*VOszKTr`m*J!bJdUj|Od?v@Y&eN_F{Mh(#5w1DBQ@_nW%Lggaq` z#rv|?RM2K1GDnGp24RC@qAe{`rZtjVc1VvT!JCRPA$X`36qqOP6G~qkYxSk&>MP~G z_`l+dwwt;Ly0Th?fyRa<7zRa4q7EKV{Mi@f+;{ybgiO&rr0ECBA5~J?;X82M5DE@( zf7KK+=e!^|?4Jsb7=15Y17-mCCbnCpN*Io zwTv^uGSG{#XTKMZ_Z5!SlK8hxkD%%-QJC-j;5*fD=6$K=Mu{ zy&xzrRj(Lfo@r4}nHY|yl@Z`jL17=}Vu>L*C1W9D9(K&Yz1;Es@UoddO#H!&U1(h} zCl9lisebS_1=gCSNJGfpApFK}jCk{>v14oHD}qhOs7>?ev9_J2KERgDgFw?NLJO8d zJ;MA|C zRehYkG!$d)C2Ojh7W60e_ew$ zidgK#0tDkP@Q(|lktLjLcfi`ZUbsC$U0O0ao5Jk~*pRIvX|2)PZb@`0E`8rScy>ri zqdH$a8c2n735K?bII{>kuVziQUr^EsTCn}3Jc6Zd!(f^aQo6g93ps8w_=o)ouQVQ` zBSNHK3&$eQ)0%Ubfd^Wf*w9eO9f{O}OveM+_TZsY+JQ&9+S(XqqF+#hMOmI>B>9E7 zcT1%gfpzJ6Nh_SQhW=h(^x3+FraA-D-)6yfvId@WaDG}{!U4g+a8IH)+uFf|!eDyU zA)c3{-XZUQWDqjF&$>hdDBLZkC5@eG&YZk!)M}R1SD-S82N~vhQfm&VC*pzSVgM`v z!#FxC%~u43RH>4pz5c^J4L;Z&$X>Z@+zxvOdE4YlI)))wB&VWw=c=j@VZz8urJ_c5 zen(|udY|cW1x-QFvWqYs#q1KN4XVdmU^*qg{-kzRhiJ{rD)cjJPyHU6$6~=jhBhcTg`QA(oK5JW;Ln|My*Verf1R| z_jOoYYgcwfM}SF(D{40^UaUo`-N#-rZy-$ZStlTjRie+YZqIt^X5(|Cy*wQX6} z%BpIxKzXSQLA;%8!%aFhFiGRN;_#4at!ZkF)3%z+uW>{y7K31k+wcT5on*_cr?7U3 zm5xB;Fz0*c{!D_8K*5da^2!>_>}Dr&T-WDASt|m`br9oud_=I41Vokx*R>bLayeMI zwb{$NC3gyu>Yp9FOFeD}6y^?!Y^9CrG*n#pT#j4I&1RiMG03oMgTRq!_&kHuuF-`- z*hOfwD`izJJqHMs3>jl-g#U1yreBFDU>KS4Xe4r+eBX;U4@xD=dcsi+Dzt{3b?~fn zcmC#fwx z&mYK4Qd@_5o=25GjA)z&7d3^^B6I18;b!0fzcOTK&9M?OeWD|3vB97jGw1Re1^0bI z%9s?%ua;<-cnqVwVQ*3EC29nvy$Y@TrZKFh&rmHDqqb_Am1eEkD09=SmS(f5bftm2 z2e-2^L~%=i3K0x+007A80j?lpzMfD?wqMUnT!9K*bkJiPn5J?^_)wazA* z<8>5c7)v%1j9K9yX(8*Sakzalsa|_geXYF(OB7emJ10_72c`5qx$Cv%VB)J)ajH&L zaetfB7~WSiPhLiQ7v#r`kx9E}ZSVxCSPYEZBUSvigbd9q{)`8s517<-$YF2|>hQ4i zyuu$q-JMH<$ZC?jTyX?Nr`E@MHyq&Y<7BvRIQq5?&QkHCHPf~me!f0vWg9#%HSQ$S zL(|Bv*X$p!sh6zwvgW<1uJ*TQYoL9=PjQLcbHQL@1<32vwNY+O_(1Q+WA~6 z%3@(bXkd%|sH#?bA1fivBFuygF)i6^Zy$3oX<_2^+e~@vMhyu;71t;G5l&^1>eDts zl--tF{hlrJf3oaK^&GoOm;&Qge_{`@u-y(+XW1eFN-VGXsC|ryBHLR1krQ^Z|Zit0{ z;z^~M*jv=n$Mvs&*am_>cInLLa1HCJ7+D0Dx8VCVX-@NkGzbD;;AQ%zV5bq8vj`PQ zH5Ir)Gc5uH6@V#Zv4bD{zC^{w$m%Qarz!Y@DM*s}EeJae=|_Kh&gU?j{S6Ed_mPkvI?;oUh?MJ-A+<2kJ?y3T$E6NY0_ zQmLXyWX`<84SUZbzf+4=$apE;wZD9&ffwZtct<^9L(OGxvzmDGnuwFD&x#;bP_KLj z+mM_PeZ-il^V)XvjEd7&#PK}vkrPsPn9Pm0%-8b9AAC}|2ec37rhIIyg?8X~TR%}T zfC07a<^1M{TyQBS^F|1eo+PN9A{1*9@H^YGczX^ zH%9MG&m229a%1Krn;m$HIgvVyZ~}0%Q~rega0t<0%dv#+=7PaNJ}{Ys;tHuqikN(W ze_w_FlV#RD(;xM(yTc(-EQEujm1!7$FB;!hB(-kL3U4w}=uH?!DAwZ5s!ee2{mELQ zSz_a>_}b>Dhar+NYVmHXP%v61bp=rmD4^S8PN zK53XApH8Ut){xrgjembQ-Gx2%0SpcIctRiuu2`Ro=#%cd4PCO*LsC| zI=jPl>B~qw3ZpngC=oeA4&CoD>LAM!WjsZiL`DYH)T6UsvkomX&_wk@OS~*46V)U( z`<%JXu?!Yjld2}#6N_#8RwnkQcJFKcHk=*$`kUoPwRwwT)0j#qMOI_e#qcp{^N-=O z&63&jwhK9pO^eqtR3?o`<@i+6IZwfMA}xWjkOU6WV>^V{t$PM&AavkHxv?1#bPTT$?g2)$w*M+RgxxNpolnEWOD>(y3h9m(BhDVYQnq zB850h{%1UAq$js0`<@f2@khJ1-!?@cDa!crGU;z6ikq@=FD)wQ z&z(U4GkUsQ$$({dUy2d>K{`VpT1H6$8Bba|FhOm5rDlD3tKUDYc9R`3W;a0BJBZP1 zqTi9CbSEUpVxP%A<%PruVDHu>3E-LKFd0{GR*L>3`X8Qu(F6K>Uw;4GcgI;ClCZu zlR~63LDa5oOZg>`UMYVPEeC=eAp4S*?STOp|1_%~z#9Ejk}g$2RvEZ%JS+5=1c7U2 zM^I$V?mo{PNi;~@c%a!dnm~Nt_tEoX4ua@an&e(g3`>1$om|=s(Dmn7Gvyx>6y>Yuq45tdemS_^C;;q&1A@Wx{>OBLz}u;3ktt z#>F9#@!a_5%XZ&yC^PF$)G}5#*Kds8bL|lTkE2L1{gKmT5nwMwB7xQ9-M_L+Tt%$i zM~J+f*?H= zf>wQX^N$8KMxdr4YS{NsIit+FjCnU@Nm4YyZ#(wTv3x$4%cs*BKR77(6m-Cr+&u?i zdH_}n+&P^-FT;3&!{MuH7OPs*EUUgs{D5;5LW65L?d(A%Og$HbA2g0TgRbVH=~6F? zbyM_Sme2xNX0dpzIvLTp)=*W|bT*zo>`V4#CH$5*2C(=+5QagbIQ3||AI)}1{=C=c z^SC@djcME;CbpvM^uJ+izu|4e;A{nab_ivKe)~vBKw1;42MG&yUd3AtZe9R7tHpw1 zY_=E8_E&=?C?GIW-p9}r`dSveu*Eh-D3RJ$1BXYA&l0;e){6Goh0U;_!nXZ{)msc4 zv2A&)Elea!qQS5cwm>s9SJ(oeDq9hZsX5{=P5PlE)j40(Foq1~A6GiD%tg5C^G0cA zecWpmq6r~|^#MU^(C190QV^hu;bVV~cl$#=Cd~_Sy)s1Dy!my z-%tJh)x1-gU6~2G@m06pK_P>T^-V;0@s3WA=@U)76sol5)XQnqx)aE_rvR7LM)VpJ ziq(=biwIeI6X6ugJ&L|Kl|XDyN2eoo9n7w#`$=+0%og@ud|N+Z-OwwWv85r%P_z~8 zXZ0f$NQf>h?jfsGC42-{5mAuhF=OMLNp~tHYsb;anyUJ29}R7zSxr?&pBKnezyMKL z`(gl|)+IX!Ge`Xc@^vi+#evqYZOI;No94I4d$G3Ew&}}RiV>|J>8LsiG(qFL{Bivh zB&W;b+Lt6AtcirbPp4glz-55~ZjeFNz^_Arp&+CfkPzDf1v9pf80A<2ir-w&+^v#_ zhbQ^x-rD_4)3X91bnt;#U@bf2!_8fbwPhh>3w_m&Gx4!I(RAm)>UI#5?0TBJ= zswg{=YfunlEvlSRM$9Gme>N(Dq2fN7T~}86+(#l&(@+HaNEYS0ZT*rgy8}kI6ljPo zoHp$q9%U1=8(F79#<`c!cxpesh4wb0QWZmoFX@T>&zd?-W4xc~>_PkK6DRVIerU!1 z92yw+DE>``01ff2pyR>f|Ah-$d=WOztgXG2GHS<3}_PQ03 znO5Ky(vLSLe)c0DT(NJ1)6**Juk1HDe)-w8r(6=q-~;#VSZbgfq2+H8 zEXhLKvO}0dfBH_-Tf2WQ4&ZvC15VwBsmHA8 zU`N{8Js8@G_Fl@+K)KC<$lf4W50r)_1PF@9DL~-{5?~ycTDpjarnVdw^4uGb*)le! zSJD$*I4JG9wHz#gd@5Lr?91Xk7&B;cW!dbNg5nD6U;4AI)eRe2=Qb}ONJ}6WUgKxa z4GLyq;zB6HMxh{se-OEWO|2aI_?n8KE~)QKOpF8C))~HoG7n;XobVl%--KL>CO~o^ zeUZ;Wis<=xn3i!cG0H`j{Nrj?EqgB?uN()(*H52) zawRbM?n|wDSVV1y9gqLb!Z*=8l7_SVy8;lUG4bDIq6A8W1Oo`dGNU^I8_3TEWTwo( z(~TsBv*#z(`A>AfmJi*dV&jb<*BZDpX$6B=UY&)r>L*#<(bvU5-f+b$Z5fJ?9m+S4 zAZjx*7qF20TsfQ$9XFC7b~AR(V1b&|43O6p|obm3i-#T=OD;VTJQ<=?+!-fcK z3kb`~(0%NE$H_PeQdZ=urhzZ0!LE#8R}`#aMFm;YoT!T=OC-+WjH0Xa z#g~Q6WxZY*hDouE^ZQ;;+26*j^lGnAyx<$ zh_~IzxM|IaN6P{Zu&EDz;FSP=IPBt7^X>zJ--Gv#Mxttk z;Xn)F31OL#N2mF;oE!^o$L9A%gK+mvJR!o`BRG9;q!6o9OE3>T#>MEA{m;JtBa8dqGkh$4$&T~`wG5);l7sn@~7WrNO*BkeBn%G> zJAfCqnbYG#v9O&hRo92FgI!(~YM^sVm!YP~^5n|3ud0tdubIkZ0g>}0$|H*YtRl%E zDi%z}6SOv8m4o0b!#6e$_N7k^qiS{jXY)bnFW-I;-5k!aY({pI_ip%ioY&-gJ?o>D z^>gr1=OVmndh}I4sKwH>0p}Pu8phKHqEluVJ#QUjE~U>_zN=4xZ7QwTb^&C>XO8#*-Wq}jL?E;Ph9@+;j2F-b5%60#r&xz@#4Lf8>*=>%XnyRQNQzsr(9bD}H=vIb(tN^GTFG~zl3 zk*0_|2$8K~M;LU7ZH^Gn%fZx98bmT?>tFoLVADAKc8kW@*ngO(H?HIR61GEo-7TM; zLla+{iSrIrRAky9MK%ZpN7LoM6QWF$Q7T9v04Jj1^0>}Sk1(Oa-R4l*rsPo((xSkz zEbxouK*Thw9kbt6rD9DU9cF!#Ol>49Pljzb$;8(V=|#n0RCb_sZ@FBF7<>c!eJG1| zr60VWmgyEwUxVHC1$BJ1WgCqOw6q8ON6DO$-c;PD_UAPkw?|XHT<(BlnN#}M1G|`( z$@!<&-5TjKa`@VKY|8I{@1i zXNeH41v@I+{T%-TM263q$5dfCe{yr+35>NFa(eV!jZFN^StPyMcW4K*GPyYUJyR$7 z9#&a5zYrrNfKhQ=IU22lIgtXzS8szqtW!)W@Dbp z*%W*bmZg{{-ZBALog{Ba;ek2xade9oV&i@P^U*}fVXuUw#LS2AXUg1!SGRDoJK3qt zi&}^vB$HCRk6@Z|yya=RGT(~TSZ+>-X4)5jx?o;~^``KNgC@N)OM8GQlPVWV zAFRh!N~C0n0FkW%l&chFRTdSMrs}fHb5ui+Rb6+;Gf|1$6JU6pYC4#eBj@2Yz9FE` zZ>1+@&}8LJ>w1gT)9>gq&s6mDGQ6ylk$usB5lQ{3_pb(KT3U|e&OzIZ~ zIZu?&VY$ZDYRdBJP9rN;XVtjx1!$< zOo(~L@k6x<1NPKJ?*Idb{_vxG|iVX2lDE)g9N_($Lr+DIb#smi$LAfOviO?6AX%*H>cnx?n}n> z$14du8f-vw!uEBM9S%tV;Vn*CI?0F)JvSDNp6hmlr?44?I479DBc_01JyW=vjTR5n z9&0YKl;uoXbpX)UetP4{AK2)=1Bt8lvw@a5?v0y2zrXkp`DxY8UT^pDEt_<%)q_nG z&e3D9`o*1!k zc>M7FoaTIlK3x*>W}xy~Kel7@ACf{KF@eY#A|1NH@xql3LP-!-+oD-%6>S@xe&7o~ zsW%Om8C7NLyR*lck}MEdh05&$t+K|xqWv6JS<2U{)k@}I{(i<>HK%tu4zP6(Dk_iP zoDcHGOfc>94);%0*R(Bh*&PD@?yrlQUs9HFAv=^4p=%}|UxoF2I_KDyzJt)PtX!MD zDYI@t+6V+hLzYAh2cMT0#n8w5Kq1^+im@F8j^zYN5_vgA^72rpGAkzBT_O=c7O;aH z|20q4{8n+#eS3n8oXV4lIszRjoFzBkvz0*wvaEEe^}3!*2dNI)varZNLp${}tZp*v zt1kJ197_-JEE8|4(-woPEJsiASSLq1SdQyhhGE)zCeQ0qr!pbJySVpY2~+MVf5=O4lPj#G+-h{s6764g_E+@>=d9vbI`HRFEExem2f_W5qI4va z5Vkg0fsS z7LRX}2xPO`=XiU5`kvi?sPk%{yE(&04>`!*?#`Q6(CLO(a6?Y-9z@Q%62(~!bUuVg zaDFTHO|Ocos=|E_FK}&_Ng!W%Y}4R!a^Y89YoGp{kXq%@e{FZO8ZPY|4Sjq2SsJ8$ zAOLTmWjfHjwnU@a?rL{~m_koO-vRm85dDt|g*X&J)EhlJ9_fmI zGKi~}sA7oD>)Tx#jc=~5PGzajUUcW#Lyed@@%2?Ae*daVprC?6J2Vezf+B^I#2 za+iTUI%8NXWM*Ampzuof;Jx!w!S#9ax#Mrj1Mg*Z0p5=(tA(DE>a(cy&cAzicKEH& zj|BByYwvtF-yq(GywYtGQBTmr@wjIW`SIpWsXvX*Y8t=kS)C9~&Usii^l2CoQCz(b zEerA_35#balKhn>X5x$?CjaCq_>-Sr-M)AS10aUT`Cr$N&ut`7x0k~OEiI?!&p<(d zb{Ni=91vq7ig_#i=kK16;y+Hf4NYGAANYGonhx^ebvF<&I& zTl4X^?X8AQSI+W(B|JEUCJ~0<6FF?_4T+Z!sAm=S$lsjYV4t`2$F0u5m0>@&74y#F zcs48khAPji?0VS#O$>Sa>^Caiz0#~SS{s~E;f6v4B0S`wmJb&042dBVoS}OV^Mexs zYMqkzFYm0|+~KjE`~8(eI1>E^!LGmH{`xhsY|7R$1$xrSgA2Az{@614o{MI!={iNg zopg@<&!r_AWi9zfBjU)=yMI%yhILpe6J=;I6mE-R zNs(wl;CYdNT0lm%7Exg$aFkUO7#cTYhILSEZp&uq*g?JYs41$iZ6~}9n}T<-K)g?o zQGf`vLIC_e_wt5|Ea@QIwUi4cVyrmHuykZcx52~P+%noH0b^Taf1FjE`yNH30lWu8 z_yTo~#K{fsn0gcD$TK>){oh)Po%?cH>Q}&soMsWgSZ=2uH%IU>T<#}&(^b@Tur^mQ zP*D0znwM%{a=c4F> z#DzGA(+CIRT>5fZ5E|#7gxiVSoZ6zm%V}?I$GVqyUerQbe!a8%iHU=EN6dc$>F%9F zCg(`X9}(^OwBd z;@tS+CojL=yk<_sa?ga4U;C}S){Yz?#1?NRkfzD^l|Q)m)G{OcAS{7Co^Pnl)HhUD z)zsdy2eC_kS~_uHcf_zU60-Y#FsYD+_NNt&O!sDHW2@GK1B;Q_>vA>&&$^N-KJfc`2k*P5$nFs^ZE zga3`4x4Iv<7-J&+|8t8=dfZ}e-Go|Nj$^rn+Svo^dAMuqWVzFc|BXphQH53@Ewx&7 zRHZCb;%(p6D@mFQF)zCU7-+{Y< zL8%(;Jsm8a*jZ%WQdR**|J;Ti`}pX!i7iJz9W@K8q9gG*j23_c5@_HUy%?a)a1n{C zhyN?oB5ZcxbaT=FS>!k2qA>R<^|>6rplw|N1TDh)+cQ{>q!R67lT!=9-5Gu$wsQRc z>G}W=sp?qy?Z}llj1>ULmywjb9S4Q53VwQrq~d1?F`JmKQ`&Q=1Rv}U>dZ1Fm>(%(*$n)bF{DsNexv z?s%y2ET!a>=unYW(`W=`H*J;CSX_yjMn%SM8A^wU&f+tG?}#h>`C^fhtlq}?C>Km( zDw3P;Rl*o$j~jkG`h~ee9ZZ1=o{m>S*TYd0Up~||z+7}3(KDQZj^ebYg4{*Xea`;_3J6eI1%5sg=|LOav%JI~L$&QFqgSXV+9t4!>uSwdR}(%Q_S zT0+&h*C3U0f!M6w-D? zvsoer9)4@3-U?w?R?5JggADM+O}~{pn3cIJw<8kavjBtZGYQADsnlT)9d+7>U|FP&n~hsAO5ZR&uF59Z0=-Nt>yVqB9NFRSPbK#ig&P;i(2Ul zXy0FMl0-S!d0rmnnD%!Z2*?RS8O)^hh??-7$s6vL)OnaVJXcx{|V z1Fz##B!og%GYk#L2;#;7PW&0N42Ka?M2tBmiwV3mp`fL0*64b~w4}8NGLFh73(V-2 zDRcHkX91@NS+cAUR`g4ThF%KR@Y>D>t-9GVtOa&(hG-q4A+tv?mW%!1>*0;#9R*A# zTg@*mEEc4c6b7j$8GoTz*per$}ef+|N}={#b5LRhyzL)jq!%#Icj;v(m+sn3fRlLMe&P zTuet(WM!J=0H{rKf|5|6d%p6KL<$Jxds*N`<2Wy2z3F^5qg1sxmSAaE$fUMg(_5E0 IZR%D40KZ@npa1{> literal 0 HcmV?d00001 diff --git a/previews/PR237/assets/inter-roman-vietnamese.BjW4sHH5.woff2 b/previews/PR237/assets/inter-roman-vietnamese.BjW4sHH5.woff2 new file mode 100644 index 0000000000000000000000000000000000000000..57bdc22ae88555c6217307e4064a642f83d642b1 GIT binary patch literal 14072 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 literal 0 HcmV?d00001 diff --git a/previews/PR237/assets/introduction.md.CGS9TUwC.js b/previews/PR237/assets/introduction.md.CGS9TUwC.js new file mode 100644 index 000000000..bfe2b60c2 --- /dev/null +++ b/previews/PR237/assets/introduction.md.CGS9TUwC.js @@ -0,0 +1 @@ +import{_ as a,c as t,a5 as o,o as i}from"./chunks/framework.Cq8AuEls.js";const m=JSON.parse('{"title":"Introduction","description":"","frontmatter":{},"headers":[],"relativePath":"introduction.md","filePath":"introduction.md","lastUpdated":null}'),r={name:"introduction.md"};function n(c,e,s,p,l,d){return i(),t("div",null,e[0]||(e[0]=[o('

GeometryOps.jl is a package for geometric calculations on (primarily 2D) geometries.

The driving idea behind this package is to unify all the disparate packages for geometric calculations in Julia, and make them GeoInterface.jl-compatible. We seem to be focusing primarily on 2/2.5D geometries for now.

Most of the usecases are driven by GIS and similar Earth data workflows, so this might be a bit specialized towards that, but methods should always be general to any coordinate space.

We welcome contributions, either as pull requests or discussion on issues!

Main concepts

The apply paradigm

Note

See the Primitive Functions page for more information on this.

The apply function allows you to decompose a given collection of geometries down to a certain level, and then operate on it.

Functionally, it's similar to map in the way you apply it to geometries.

apply and applyreduce take any geometry, vector of geometries, collection of geometries, or table (like Shapefile.Table, DataFrame, or GeoTable)!

What's this GeoInterface.Wrapper thing?

Write a comment about GeoInterface.Wrapper and why it helps in type stability to guarantee a particular return type.

',13)]))}const u=a(r,[["render",n]]);export{m as __pageData,u as default}; diff --git a/previews/PR237/assets/introduction.md.CGS9TUwC.lean.js b/previews/PR237/assets/introduction.md.CGS9TUwC.lean.js new file mode 100644 index 000000000..bfe2b60c2 --- /dev/null +++ b/previews/PR237/assets/introduction.md.CGS9TUwC.lean.js @@ -0,0 +1 @@ +import{_ as a,c as t,a5 as o,o as i}from"./chunks/framework.Cq8AuEls.js";const m=JSON.parse('{"title":"Introduction","description":"","frontmatter":{},"headers":[],"relativePath":"introduction.md","filePath":"introduction.md","lastUpdated":null}'),r={name:"introduction.md"};function n(c,e,s,p,l,d){return i(),t("div",null,e[0]||(e[0]=[o('

Introduction

GeometryOps.jl is a package for geometric calculations on (primarily 2D) geometries.

The driving idea behind this package is to unify all the disparate packages for geometric calculations in Julia, and make them GeoInterface.jl-compatible. We seem to be focusing primarily on 2/2.5D geometries for now.

Most of the usecases are driven by GIS and similar Earth data workflows, so this might be a bit specialized towards that, but methods should always be general to any coordinate space.

We welcome contributions, either as pull requests or discussion on issues!

Main concepts

The apply paradigm

Note

See the Primitive Functions page for more information on this.

The apply function allows you to decompose a given collection of geometries down to a certain level, and then operate on it.

Functionally, it's similar to map in the way you apply it to geometries.

apply and applyreduce take any geometry, vector of geometries, collection of geometries, or table (like Shapefile.Table, DataFrame, or GeoTable)!

What's this GeoInterface.Wrapper thing?

Write a comment about GeoInterface.Wrapper and why it helps in type stability to guarantee a particular return type.

',13)]))}const u=a(r,[["render",n]]);export{m as __pageData,u as default}; diff --git a/previews/PR237/assets/jdkujxv.CULn5saZ.png b/previews/PR237/assets/jdkujxv.CULn5saZ.png new file mode 100644 index 0000000000000000000000000000000000000000..c834125d6b83f73ca50bef4a6c4deda4efdf9024 GIT binary patch literal 14528 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 Tu!?n~`#yPGO(9Lr_|E?VuSV`< literal 0 HcmV?d00001 diff --git a/previews/PR237/assets/kpqpxvx.Cx40vhB3.png b/previews/PR237/assets/kpqpxvx.Cx40vhB3.png new file mode 100644 index 0000000000000000000000000000000000000000..f60db5413a1e287580ee1d0bc1c479ecb43276c4 GIT binary patch literal 15689 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 literal 0 HcmV?d00001 diff --git a/previews/PR237/assets/lodwufu.DiwGEg2f.png b/previews/PR237/assets/lodwufu.DiwGEg2f.png new file mode 100644 index 0000000000000000000000000000000000000000..b9cc2026e0ce54e2cb4b69930300d7f9789e4599 GIT binary patch literal 13659 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 literal 0 HcmV?d00001 diff --git a/previews/PR237/assets/msahijx.Dig-DWOQ.png b/previews/PR237/assets/msahijx.Dig-DWOQ.png new file mode 100644 index 0000000000000000000000000000000000000000..13977e4c383123ad09e0fd376ba46fde6ea9986a GIT binary patch literal 11901 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 F{U7^&kc$8S literal 0 HcmV?d00001 diff --git a/previews/PR237/assets/mysefnd.BX1TCrz5.png b/previews/PR237/assets/mysefnd.BX1TCrz5.png new file mode 100644 index 0000000000000000000000000000000000000000..18340dd069a16dae18940b1bb702eb83a328ccb7 GIT binary patch literal 60301 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%0AM$Tj)`)wNV*lgAWHbdClEemI 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%0DJCfI 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 STU?jTQ<77YeI;|@#{ULBg77B* literal 0 HcmV?d00001 diff --git a/previews/PR237/assets/ownkpce.DTKLkKh_.png b/previews/PR237/assets/ownkpce.DTKLkKh_.png new file mode 100644 index 0000000000000000000000000000000000000000..ca49f1a1f4f753232d0b54c03b4e7e06b9b5f218 GIT binary patch literal 200857 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

`n%(A{67fl<345^-zIJU+0o^P$o>)1U&XD&H|Kf z&aF|GE?)d_Y{$Fy_wV)I>r;nMm>{KgiP+@&LKO5?_@J+O@_G6B;34?dAK=MTp_xeH zr&IK=qp78Q*bZIPnBeA;`F8JGTXpsI|2#Y5P1vG-=Z-&q&6sOgt=^E@yy9YGUE2jR zu>%T6!!ad#4eA}L=j?2<;Lkzyx&Z+J6oZ#89pa~> zDw`|$2fKp*i>t!qHTlXFg9pZ%Yi{?ccfawev~M&6kD{{X)r+xdl8;YgZpg8S3t9b7 z=j|C;M=P9e^r^?-2T<7*tvX(%vjq#Z->Z@> zsdprk*)4ML4+)XzjaXor$io;lEEG17YGdPGLj4C#Ce#u`2J1RSuz=_9-ofsA{ra`= zM8Eet`Zj9J`FmNxDBCJ4#{kdqMg-_9?onf7=A#V&4b5un`cKNk|MV{&DuIZHN<5`J z0KirsLpo2C1T1c)pw^46&hFfOQaep7!l~yc0 za9~?&t7<4|%gMD9Y9-^AVFkjep)&tW?8a7qc`k7A?O=F^a=f+UWArzacN}g|@Oif(e z#wOj?*0}~!Ln&-2O^-M3R`R09xDTA5t1DQ+-fxK9Tz65d@)4!4bNvh^4lEk``js+# zit+%_Y;mLMy^ECd3Ppvspx|OK52y-x6Pg=tTwX_j0#{_c9~R?${=RNrE*}+rr~ULS zo|orI)#1=WQ>XdT!$m=57$SCa3|MP6T;@Nqd$ud5urTniN@!oy6(g{Xsc5^r5)xP8jg=?S{ z_I7Q(g@)CN6+_$Q=-*eE5Av_N0luYbwIaZxZDT)?t#DpCII&J7I@*f|r!VHd(M?Mc9~$mm z?|eHIC8cwZUsELrzh&h7`n92sshkaMPy@6T2QA&HQxD$Lada>EsG#z?a+3VK|E8u{ zeWJ=SHqeVR_b47*tBPHmP8{OX&YOQYBy)pKRE>?Uz#ErQ@cr6aS1m=_@TOo{^$u|p zqLq@$pR+1nC!Anpf8$0|@23%_4R8Gc8zhtY8c|)57&}$J{z&aaaI5JrAyVxnJa0kH z)a@St4lyEJ{poS$HmafM3u|lVZVK^;_?;q)xZrnT+vd#^+g0Uq{J(fT7?ZSHwRc&s zu!OL{iH_ygX-&V!pns4=Pf}M0Qo>S_#XOX;F$?30mJv# zsu{esTy3PgM!>SS^dGYKf+%TGmVppgjTwJ-Z@y0n@0e?Fo1UWL`3KH6;xF!%s)mNR znzgNM|H7k(Te`mFl~86y`W)`Z`VO&nNx80i@5n- zuPhzy*&$x!HbCStSU7@d46b;XpFV9>3|%vQZ%W7L&rp_yZ^-8Iii*<=o0)eImW%P% zx$l0vvThxg)kN=;R{L*LqVmz~{hGxd7~6;=97+&VU#F<6rFDGyS)?1`z9)~G6D*A< zPMk;^j(6evZ6%v|Ifm?Lg0d?JZm+((vhks^#fl7DV&JEuJ_EnEF9{rec|{4{b$nVl ztY|JzjD3}sBuqMzUPi9_ar#7V?&qrcBbAp7tpb$V(c;90gaCX=O)WB2Z*=*ikLeolwW2Wp*~3`K@d z3=CA;<$V$QeJ6W7fANCWhuPUDRK5<`Ao(GtPoBC@tlYIHW&QBNM}M!V-W7)V+8`6K zT&wiiO2dbL#pV7>Q*j92nzuTvZv1jhg&pI>29|3aKEx;qK{mC zX_OrkkOvQ-o#_|aIhd&IcyocQYuKQP%`6#u_?KmwkCP02Wz;U=FVXLAZwBW#t+zGz za_Eoz_QR)7%THUgE)!bU$G*LdG5!zM@ZH^X`XJ?!Fx*$DVR5!jocW2WrqVNSKHQL+ zeBi6}otDnIqpC6*eLX$n;Nf%7gq1aLChhV(9O3OokBk~26jKWO4>`&bSS&YgJZqbA zxWZ{u{fhb;#fUOYEkf^`Rc%`cSooAxB1jXdpZp&G;Y+@m^|{_#eMKp@s9%^j1kg3) zJ$e1&MGg)#NdaFgo;~}qRpRfF!H6G{XB+(k{$PN0jIuk+L=GK1=-D!1F*RCXVBwJ? zL)}bzb6TZ$_X*1G5M38q38pbKXR6Hn-F7TpBUKyD>ktL_J*)vv&RHOD-Y0uVe3WWv zImc^ip3BHc6gWYea&ig^IW*o3#La)69=DeU_%99x*KPg!;H(ZR5y&b`OBXI# zlJwnL3F!B~ckfaB2gEO#8)D#x#-P;0Bj9Lm9RJH}nLH9#MC6a7zE(H>c<1Xs^B1kQ zKi_)3vhkD@knEhC<)a5j>{m^?g)t`jf}dX>7qY^-v9k=+1?lRw&WT?^n^}-*;tFd# zOG{EDgR_Dt?@nW5Anh&%5>Pjo`mut7ohBx|Evo6OgnG}-YjO|tFV%6Qi|qcu_)h18 zMUw|jXOis?ngdH7HGU#4j=UFG7G|l-{HG6CVkT0!(PbdKURmMwzKOl1`hA&9my_bI zMyG%Djy7!-7G=@#UO4+!G8t`Kd>W>Jrqe7FFOoVb46q5&Grjz*y1I+_0>)l0K*$Uv z(Tvr1S2H!juK+~>F?rPt7G5X`A=MK%;-Qj#L9MtOe3J&C_AnDi#P;Bg?V9I?Dl1Qv zl?1hX0!P3=>b01-c>lh^hYu^T7i2+Ji4T=}o_3chgG1yCOoO%-W*wb7s=3pT*C0^% zdKdko#6~z!-oh-vi?cx3@t-+z;BN85V3^d1a*}=ZV%ma+VE{-Nz)NHA-cei`=HC#t zVS5wN%v{vWGat|D{96tLb8WrGxN)bmvN{-n{Gg(<2b)V!ICqIae)#Z*FaEVklA?P8 zzfOsLB=Jy_s{a*ij&svfG9b3nfa_X7WTNKXPBuXg4&?mfT+nZ9pu&*BqS|kq!BwSM z0Y@L64i67^pP1M6#UB+_d>Ym*UU|nCRO^nIEY?eAgpv}I!PTH7HPW99v4 zGCZk)Zwu^4^)CeE>@0i62Ng~LfZiS+s{G3yJ9hZ{UyF{GYu5}Nz#i2xW1?nAyx2GS zdfv1BnLKHd z%#TldAo$cs_3H<{dBuuo868K=p`?nlqiogq7fmEV1uV8J$=sNr2xbJGp(zlqYY(wy zQqhu_?)7pul9kc@WMnjyLqD2+oz6g1_>*YGaKoFKG)oxEue=F=9dox*fEM@MDibfS z4~ka%J5sy}?=ZJ)CaQ~ymJ2xWJ7$uU6Oze@g+ZVmc-G#ntDCN&QRbv$9DVgU7GY2u zp-T01ijFhvJTfyf);)W)j|N88=$oP#rbaG(&##Av8*}OrQFRE;?}? zI#b8ytvXL!$;@1WrgHzL+rmh|Nr&R;N?sn+&j~mJ2nlReVNz@?n=XopPT%=W|ae2Tkw?m z!@xv1c~kWu4C!b)eH%4D@kYP@@K=WrVRS)_bcocz%$FL!hvR88(EZ5pkt1h)dO6Tz zKCm!GV*hmd-KUL&yOVG|n~Z_J$8X1u#&?q_kw+*hc64^`*}wmimw_nALf}DK^`5sB zo4BS<_PB4$YEBPB5ygg>9{8DQ^+#URHlqf{5)OZ7KlfOoWPjk^sN50W)3HLY^?a>I zvlvzW`sGV_0?{M)tYw)>ttwAsA50(UHcDCez3Ck?tkMsSKY%sXxMg5<(8SI6Yh@|R+VQ&#afQ_ z@%Ek)XP)bJy1xe2<+}#ZYNpYsKXcWEZ6g(C!rK@Kh?IKi(nANWz7i58jop7zC&etB zTD9Y}_4w3f6)l}FDwEtJtaIK_%u+(CY#DH#p!*`ug&mqvg(t_pnjHA$HUbEw#%1~r zRMAzg=4NK9->wf8X~hwHi{vl*b*_O;dF9F#lBw{i*)cO}RPXruVY@zO(_f~nht9FJ z>*Gf_*F0c{$6JmscC=9&0<3x-{C6pi%i)k-@66jd`Y&Iy z)0_XEZugmMeA&EZwUf4lRygr2Q}^v##2N^}W4`6v<_Od1g9ke)3{IvCD@lK(ooyk% zh=-^l-Mf2t^8+in>bklw0EUcsRj~3gGExe(g32Ce7&%^-0lA1*_qO7U(4G#TTCR%hgozI-9{(eNzHjn5XOe(MLO_+vAw3dn!HqpcN zPaM8?`wN>1WqW49+2%o)4R_KC{$$MXlL~Qzt7|u&(xfEju1Fml_!bc3N` z{GM$g#%)%9SCrPYc*)Cv%k``@l5G!LSRb@HPuM^3YI%dhcQ#1zX1?NCsIv( zSRd&A@%!%|Ar!-9_)K0CemF4jbFVLZhfIJ=5`y}X9VegIYlKZFmsTYz7c4Nic}yKN zKUk@7-lm+WdI|dW>J^SI0hKd8`=gPPOeV_Vi=?FQA!@YIh+gO9WW-NfJ5qRvADFUpi-$j z$z;OX0U4cMHSatCNXxf)Qx^T|j`}rLQ&T{b3x9sh1naDfpZa?1=Nli@?H2VuT$I#s z*QP=y=ws7_*_Ix;N&#DcyE;TduW9Hz#F$j{0}JDraJF_Hzu!4)5;bAV5h_eOuuT|F zD0s$YEI0h{W7hZPfqD&^K=-b?rt{{(PF=Fh@_}o7z{})tQ-xrtG0#|9Lvf7%O-Oe3 z6cbnABK3U<_`D`1BwTf^N-gdjYN9lSy(xkrOXw;ur+meT07REi~j`) zu=k%?$jS&mzuMua(_~O@t3THx#0rs3S~KXcY^zm>*UZTizbvyno9 zI#~ZhBH}f`@%y@OTUxRy^+WH|*dYO;+adV#E9|LVSUPu`0+yBO2O^jiv@MgK7ed1|OGmtMjY;ewqk$p?dv$FJX{rM6=jh zm_PBgOW|-0rx_On3t!durp)}_F=x-*U|E7cMgu~c(Dyy4{3UOO%RQyq*S&+rNjA9l z)*8al^Olp2e?=lej^YD#(2>cjcb_>LHdsz>kO_q$J1_Z1_&8~-d88<8!|nXne&wiH zvkEcQO!<5x1sjHU< zwlepm5QT_wI@>b8*v0z)xd0ehs0;UX2wS#bjVCwmzQyo)&9c+FYHGXE*1LM;vgNDL zBw0~W(c$rT&k^#&hc8_E5ISQIx1r@mOJ|4QeVnzhzT0>-IIW#n+C1w4m<{etKxof8 z?X%p+TQO~Nu!2F9*7W+I7HgozLy`d;QpWlhD8&lf68@uwfBpIwniO7Oc{gG7HPl~T z{QT?QU;kYnpBDYsUmZHt+H+`nCM-3m7>-hqfPp-y1?GFUy%WcYTsYqo?Psr&ln z3%)9}k>;m%xE=+Fj*XAMf|ooZ-<|Ltg_~hfy|z(|$!hSbJ;`(+ed#_>*tyK5CSRQ1 z_36{@--jyPxV;qyv{>{-_mj&`M`F5sHL0wu44+OO%%)aDT0Bl37D^Cuq6Z&132X5> z1dtOy$4;GkIV(#xaGG`{rTAsr&Cu-Z7WHws6)e;_kIB?;-@GBSmbv+h)>0_PPTit;Dvsnf(j-xP-rfA#il>C-=m&u)GP#16G;K7^G9q)9)Jn(Fmt z3zU80_R>H=v_M>1(ZY`?-1GD)`Sb4E&8dLr!WrFgIS~>t-o%&^U34;}ntBBQMQCRt zY9lKrDsmIv(<>-~w%7c$O#V{2=?#sl+e;7hLv`dkB(0hL^LjrdQ`$^ z&aAn8{${tj1q||^56&3+5VwUog8JR}&55>7Ka!QM1)71ClPj%Ra8;DX(sWbWo(H;b zpFiKyV!F>Eg_#9oagnbS7(SWS_VQyIM7QrUKQ+}A_EB(d{Neg{ z)5K+;v4MLXg};Na&6WJW>f+fPfTFYgS)nMMIrTqa(P1G5{D(me7p59uf7Pz3>Fn+v zl{*BB=~m@7>mcpXW5!s?r&^CsPOlwI$RaInxcp>)qRE~j^>u6`yyz^n=(t-5j?OJg ziwqD&h02=myD0nf5_M6LY18U?V}or@<>wDm!z6r;f#g-*I39@<(@0k-`Zl?`o?_i< z%GhhI^7SukCdk6)Tw>HY*V_7_)Z}X(EuYuN&)o7#-o%x#p%>}X_7?*TY(D*PPC0S? zGKX{Jf&~?T^%IR2QSmKIji0&G;7y}ckvzj5QJOAkEn^ibM{HkM;=9m5W*;Q?r=_K- z1qJ`j``38o`{N6?z2JI}oMI~w`~L_XI+Lgcj^UNRdiBWb_UlrE4U;P2Y`!0(>!!$= zqb$xEXGv2Nu;%Y2e-&-&UT1*N%SU$W1WipP6&3FC?p|y%+gGX=FibyWSJnV&2$ z#$reBC%d(BE?)-3_55%p%r>KeI6?h|8}`oEOE9Vjwn;pA(D946Ej{)6^`~d6vJax* zx6L0!BAK9ckthwBNiJ3%J$uvphOE1zAuHM8e~i8Z`P&0e8%@mW)D9&jx$6$6SieBP z2(?_d?zahPw>H)1U7+VVcka#^vCohTr?7C)#J4!FpB>2^%Lh;>o!;- z%sYI1{czllCf5}iQ4P5t+1offIHA6_S%8?@+S=%(Xb;+@1yvM_i! zQ4)^vyLUOJC&!s!vr@XIz&`Nm&ZnYS-Qf|4DBzm0R)xcNu7^yIr~HjAQi~X_!3w_l z+-uP%=e{IHFg{K^qghDGDPxZLjiTa(?aKTY`NDg*+##=+x6<+Qx){W2Oi%tuaSkQc z3HXRfpFi2_tsDD{U>Yb+Z(*4P=nU{slklAd)?JX0u1Dy(;onZ`&3c<&H+HXW&Zc1| zV+{>=cz7HT;>wI2(@b6plg5y&5m(c0)!$qw_WA4A?Ni<{j#unu!39GJuHIpll9@TV zUGTPkR{pcF#d-dvm2yh}nQ@7d;u8@9mAHF3qbtlm!%B1t3c zMjUiqa9!IvV))&o)4Mq1>^8p*=XKch_00FcIcBTY=6R~W(O|kr2o!;vxiMQkx&ABQ zYE8QjaBmE=K{jtJPB#qvX+#`RP*#TJjm_Duly{p(gdRDCM|9SjGv-9zo3d(S^SqhK z?26zLsSD+UYy5Su=l!uB5+tqH*i8b^v~2aK*4uaPJlt>@wi)v=#wv76ZH)N@>ui%` zKlm~LH0}ihk}4Zv3GswEVS=_qn6nDP;O`FsrTFV97Q#C8ED0TvNI;L80`DZvYJB?i zDifFgK)zbOuAh-T{N6jqwGw8lno;iGZ*?06dv3*w$BcXh>FdgOZ+H{Hhrd3q{`I?^ z-6kr3clXNfamSk$%bs_SG%y?zQ~_PqbT()hwJhfqz74LdoZu2GB`N|C@^(!@!)b+A zPD>|)WfP{u0F;pUhGDEyyEf_v`?`lmI6q7fNIT4IA;j5V@fnw0@Ey<+tuG?lqxi&x zgo}x?hBHzS{R$~>!6EQiW!q4B`Pdb4y(QJC+t}Z7qRQ_>>jDnBbl_IXY4W3xnM~vB z7f9r1^TI(}K-u0i9j4N)(GS};RE3t0svC4r^T&n0=iSjMACT#tX7GIxQz1yY+6=Vo z>MGj0l9z4TLt^aP<)jIPXw~n(BN(8B6e10U2v9YD{HIUrj>N=(y*MyZ;EJrR-vna& z3mEpCw$xdgIksL_wv}iN6BR`?Ez{zq;OfOlh!CcPH$9}AT+`@wYc22tOx!`;aX84y zygM58<0K;^w*Tr*nc~fGgroO6l2qWc+qZ6!+V+1|zr2#kk^DTeq%6xOFPDuY1lVWl zwM25AK_!vT1kG~EW`awxdhD1=*UzCM>8SAF^817NoLty9E`5Sz>3P9d;CsyJcD2%_XBf9a{i??Naj1n;A;yx=Yj z9H4QInqagMq)B}pE66t+S8kh@RwMv(N{0>7qrYbM5YOf+NVwp5|)B@VU zvUhW$m-M&9J*tWBsNC@^&Ub7>k&{!8t}t`S4}t2~c;@PWF{4LAE-c$`SW{Co zO;3-|#IGsJ8_v9Z`xf&GojA=N#i9aqKqV7e!Fi$HS#irwGY?)@YL#-AZ_F>SDwOMh zpBdY?Z^vH?hC9Z_%u82+X|_Fojt(5t3gQM?W=~o>PQ`o@dHJ5?elHY|ULc;e#4YDE zVw|Wk;jS`nza9VnyMND~ZLJ6AZ@P9>Or%vIECB8ZwCsWLfvG>Uh0)iyWV>S*Ls{xU z*0X^9Y}EYYsIUx%HRhCYJ9ZfQpV3PIhax2T`sTjPls|m?`Tn8x{8nIY%$wZf-*H!p z7SBLm-?iacFO!>9RR=5EUVq%~Cp~f3&@&}#UHcW-SGIKtG!;kPr;z%RDv#WL-k}(u zk)9r2*@obQeOdp8!A@QfMH z7Dn3>hL{lYLD-~IbiQ0xq}7i+D#}AydzF%bHLEt70Suu?1!iN`q@rWzjk9`!ozp|g zO5@uY`oTC)O-y|DKJeELOo$9*CctmPPI=Mj!3AuvnD(>yI@bUud2t_8SpUw>ASt$f zN)e`AYf1A1S5ZKe>E+;iIkbX#^g*9P4W{R8FuLt1G0LYAzrAr$%BG>EUAjDvj$uv9%WxOQdpGm7&jE|uS znzBXLNU{H92ZOj0yR}PN>+o!0a6laC?8_Uhd*fh;PBuI4FaS$4)UpoD+(Jld# zKUnFuDD!b3&AqhBeJJC_Cxqz`Rm0!H|97vKeX{p%+M^9rmaENGDFzI|DsO~1MjJVsA%sM;l5!)gcp zZL~1;VruHV@i9Pm2cRYpNg>@~k`Ibf_-r$-2ms?-SWWr8u6W_@@Ni+XjP7urY2DNV z5<);ETqrI=G-#4c+iAdKWi$yIrT6#F2*l)#(BPPjaixy>ng8p?*(47|9FdpB&{fgOW67fV~ZWBYkFzMPvY95G<5va9Jej~_F8TnPF~dCWJ!4;bul@K3)b)t5F; z%NO=<|EK0gO!2Go*Y`>w)wG#r!dgORmyCiAkL>?A_IQ)qv^ewKvTI&_l@K`x1z!#0 z?hT|+7_rRlpO3&ym-aN+>+IP|8nxXf+un|PlG<^oP&@j9?+hVwX(FHnfrUd#LxbEsL0q(7;@a|FqOx`DhM))J91EpA*F=|%Wz@W26BvLJ zJ}^bnd&V4C2VGQb+?CferIVg@e1P>V5^J8Wh870Dfis?p}S^#z#0Gui-CGE zbSQ^uCL{FB#=qbDE+}^#`QNysFIOXF?08sEbsaUQYbRu0TV`qLkQy>@z<`xrrBZ3P zY$QKfi1lq=ZDjOBGPc)?3Y$}xF3GDQRJ{FZsmk0~bB*sG2E2XyqF8wr!_RR?$m&a$ zEE;xKj_!WD58%7{ zit9bEn}HV5bEf)~iLBV^)4MlSM-q?^Rt-bc*gdm>c=^DS@F9>Oi~92Cm6ex|fQ=#{ zQ>5iPMH7?#@iG6**hiE~I;im(Wbj0l86T`E<_!=|N=mTL;VKk3w%=?I{U(MO?(+5P zDwAU4Bpw?$Hd@c_3$S5at&68m%C&2DnU7oQ+;}-rRjx)ftvx02{RX$)WFvZP;A#d) z0E#o!Pdw$bHU|$AIhZsJkrHWXGyTCqSvY||{*|*%)W8>R@~RwZHJ^X}-a}GkI4+@= zPr@x8BGpByqZW#^%1mO|v(eI0fV|VbU1u4cuzBqjCII5<7Rq@K(EJ2RG6YWnk-(Be zJTGCh(=q9G)pO9^s4k)Mu+q-hKS7T!w`eJ7m4;#8ld!$ySTu5pEajteEtjEaFR{z?gStwd#Wwyv%(f7dy7TxuLom)G>CiNAa^qk79ge(K-&p_4k~Q zf8yfu=6TWGVtN`H2vda*&W{%sb2T&wrvR24EhkHHe4BgAdC_Tt1}>AQEB7tN@G5AS zaDTPt!+48oL=|sdzEo8XUq>uqb}4HDz`HRpa8|p%=A5PS$Bg4x!U5@+(@y&& z*bLWobZE6}>Sf!1dxVK+J}!Em}*a^+oq)aH76MQrLqW*S5iBAWRFpcwWu(e|3EQSBP)SnBy5=**}pib8l_gY-3YP#n-92sKYDq)0sPp2@Z>(X!mwfaV=bmD~rmp!6J>mpX=&gSjRyw zs~;YYhH>31OTSaSNfZOkV|vZS=YLU?nr%(Om~3P%d^Z0S<}KY7W0LBx@4OmwZ|WE3 zc|9hal;}(N;3zESEfq+)*;z|KU2u|NrH^!U+}LYDS4kJu)!w+IW?kwna+t=HOLQk( z&oahrwBJo-P7zMK9RZ)|cPs=4SbDi%K!UKO4&24_YZ}|r8vPD1KzDHV*{~;)cJ z=D9q1@~WvxRz(Fe@VBEgcGNg%v2%dhg!`dG4~R?BY{?8bV|3O&N{6R|_ix#9xuD<& zgL|ocDI(Effi6-siUBHQ(aA}bs77;&`wf{ki32!l6s{xPK!&@Eb>uF?#n?6bxb=9@ zSdgP(Y$eEEmCjy7UjC7~wR=m~kP6ZwA?=NkmE@awF4BmVtzRRJ9-V60Z5k`f0Tl8RpjJC4EF6(lT69V^6>I{P+2)}aeQJ1j3JmP!y|IA+x5FG5`CX5z^mV_ zd3=Jqt&12K-0{e@4mTU35&L~uH7s`elquQV#b8wkgS!m&HTRQ}D)GE_{=A!)*WfLO z(+jA|yuSrekRB^hE(R)~p(HVqRnDt;H)EX{)Hgpu`plTjGAyK6 zhGD?s6D_U#04VMn4(5v&*F1XEtbg69V(`P2(%AC$GnOS3YxUcZqhjQT^%}Mb)XkPI z+FDffG|zpFnJ#pGOdK>oWTP*{$JjpfwnU>1m%kF)sW-ML&AHL+fq6@?qYV{^*=Q5x z@}hI>*ehMbFpO&Y#Jx2Rc)e3l;4v*$nI;91F8$6gA8GLxNUKmwk4Dc=Fj*Y4>+HKB z49SA}`s5YrdIfz<520y0Gm??MzfG(hVymhPp7KJ|5oa~yKvNabdzruJA z7y(+9IO!|Nywcx2cYMsT>E5Op%fol?=7FU|_7TMn?D_N~*uy}n4{)ZgJ|}fqa^zaU zrIH@$lI>ZEzgxHh?u%8@^YXgc zoB+|y`-7_$Agh-2#?70<7FcGlTfcq}qkwCkt-ncZsjM3%nSzwNM6g}uflC|9B5WOT`C)Sn?=4$! zAD!?@Ulg>hw}43G8>d&JxkWu`$iVf}8x*Yj3=XPc%c-7pg=SxP>`dNq1IO>{%Uy*# zM+xa+VWj}Mu-ac~E-{2I44oq2pAhu=1!;AeOsD;4u7<34{!raNUiq2|xS0KAmC(zt zPpen{veQl%Z0^6Gz6wm#-@hK2Moo=^@EUq3*LUvTb<9|k^RBUQmXXmWM@P;SCwUhF z-FUOn7jtqN*jeyOb2rwVjG5g$JUEZrVcC29g9+O`t)&0w0yvx(c!^pr`y(RgqrdnE z0M)}vJO0`Gg`#vBm`1F*Gd71uXBbZKF_;0LvLs7bfo^Wjg);L{S`Dne+mXujRJKus z=?RQy+#9ZaNjEZM@@V&bTmQ%wr)a~vZ~dIZlx`a8=mZ-`+Kj#VX{(p7SZvJcPoJh6 ziLc$2=lfn|w-F@^FSrDi%TPFMlN^_DWwo#AxkuRax>V z1J&%hO%L~oL|qd8y+xuszu~fX=n#hJ)+<)b4_G5U#cAzYq0w@zg_*|;o)a~ic89qG z-x4w}MAEOm`Xe8GAO_h6aC|z(Urh0qQG! zk2n47k3Z8{+`fUvYHRg@t#~2in*lKkpHqpicy?}oR8(~NqfND0#rN*Xa8sA{SUHq9 z=?Evs*?G4CY$1C@79xj8wl(1nod91X$wBylR3Bs;tJBtG3VEfo7VD67;vB{;%*-q@ zm^^I6i15%*heMmZ%C+|2bsnkj(G>H3(vjOF%a-YPx<{*-DZ;O(s$iD|Ls)zr8=jZE(Dl;B>N{dIf zU@N3Ibt=O{PWv>X!{0YN1v9o+|O-``^>WG3;X`?>*$j zg1*M`Lx$|cj*}7LRj=m@>HneA3YvGsdkK2(*CQMC-6^0ub{mI(JGr{(K z^nzhpACdh&niVoNyI)Y0=&$g2QM>6AK!%4BmR&iPW9Jg7&e<2lm$!f`7s-BKsTSpf zBQM*eO%k6^5BTSkeXwdkS3={RFT?MkBt_aA04zc+M`Hj5MCiLF9a*bb^Y9^if%s{$?i4fLByr9uoPL^Z=scgJ#%U#F;l>vYLd1yYgg6~Yz+B{6F2|!Q; zII)XnDY;lqoyV; zZEfS?IYT{^xF5gvtX9WFY#%oHxT=mhNbUtM0V?xUirTkt2OxrAw*x<&v9m8KevDs8 zs9EVdhHEP9yZxLk-+opi_oD9ZJll*Hoqk#tJC=u<2)>!1;TJEOB$gf^{wy&!udS;y z{^-4&>Ow8L0M~ABKkQ0mhiehtxgy|Qd zC~dlI*PwuFzK8&sY++J3p}ko{+Zm z*;A*EH?1!qi38Bm!ex4_1`_6q3!&!r^8nm^ye~h}m^SSb7!%DTd*XZTcEm@RJt-#1 z9n9R=4%d@qSG~|C)k&8Cv@VtC)irWkobe;S92gGT(joa}*(r}-SKM6!PG?z~kWXbm zpJ$LL2><;WoX@jbVXQne9}PB)xmrGo8UvpZ<@J?n>Tn5ajW;S+&Bc9FsVjKu7NLu|KX_?#r?E? z3~%|u%y1?h*=G>xXnES2C`K>ES>Vc31f7!WC3-QvC$JbQ?2Gy9uQd!62Jbs z?(Sl=e1ssy-5|o-92`VjltKpaWuTZS?0a9IPpMm6izrNOPBBwT9;kd^Bre(>xx8va(Q-c8#bKD&j(s(d#}qlziH}I*{?l$<;A%ts+?S0 zCdl{aXY>gvuBEJsY$38+Rwd-4Smiq%Gy@6QZE(Ab*vlA;h|d3lL;@fU{o#a43qj`YkRFC+na5L8#Y(hLFx2Kv z@n&qnbAa!vudld8Ap~1Hx5n!cjRh1*Nwp<2f)Z4d^lY~uIjlX_=u6#Dgd~pZmV&JP!NbxEK zdra-z(@;(Cye+xs4)l9Xo1=xhxC;eQzmRP@*%+zqa;zmHV;}fRQ@n-08XloR2*lrF zi$ck4*|`A$*XNEBbZ$LW>~7=C$BdqdX9wS|=AZ~~PNBbWIvbRvr1n8nmIdk6Qsl-od*%1u6?8Givi}p9D=0Z%y@IMaC$ZEaG%UlMT?x$hqALzn zIE{~?$Iwb*29rYG(w<*zO;FPAX5>=Nl;jZaJHT16MvHEaHXq+MJ1M4g&Yn%u-^(j6{%EfdoT zJ)&S$2&y)J{DCF@(fD{gsGd55BGkyWg_EXf&1qdU z?8`-Q=aj2gSEKyE*eSXvM7DK|_qzmF^wFSLEzZn6PovCh09oeS%uL zh2*wrD+RrU#Q?tXuDj0B(e>^^w}1P#a9EjA!iQ4*Q*d=6B?@;Arx|#Hzq)4q@{Tve zq$`tk)hK^?@ZZ|CX*g{(mjgwb$HYy)D88^}PA@-;n?sb@;rGy3diUH>(2=!Bswm1h ziU)R_A-0q`XH!y3W0XY;t*I~p{pZ%CJAae-w{FcbJ+bndUnd|ZZ&?JmaQygj6nf`! zuIA?_Qw!MqDbxb9OG-?a#~f-ic^(jXUlCle59+hvjTxB{Lnpn)ZDpOUzuvT=nQE?GRky23O(WN z-!k_XJ9HC86>E^xTdBAht8F|^&tN~nYo0{^cT;eWTq29HMh zQ~geNc6xfn-T^Ob_6UoMW#)(5J{1!8T~r=cXw*M^!a*h#txiVa7`7Q)rVJ_BVxh@<&5=s{dC{mHkt}`vwpX=-D_~$ zeBvKh{^idcI>}CQz<|WJI}t;oM&K4d`Sm5~7k=U^#>ZsJIzZ4-VI5M`7Z&vkKbFP2vCr3=SEG+KYyi}okcN+_c(4?Q_+>>d@g`*=uR&IKfm+KcU&3- zg>Lp07LH1UmjJxnzc^zKL7cXSsY+(fjb25IFiB=#AQiOGW$trSR8b+yZkjeiV{WA- zp7fSuTRrq!x3x5-f;-)BXt?*>E7@wtZk}1qg9qSAOdtnN*=JAh!9K6^`T22oozv6O z45m--Iga;xUf7*`_ue5Br>cXcPqnk*^6)LA&ak2ji@-HHaWq2l(fuBFsf3s8iHa)M zI>#EAv`v+v2M<>D)TR?APMmsfb1(f!_a~P~4d*aWeo^8`%gH*0o4+{RGg;V_GhYrv z@(+V<{p;K7PS#3?m3HCBfmKQ1!uyz@7seIOIYcb5m;rtN6qsk3Enu1tJ^=ht2Bq%vWQ*BnRJUCSt>@xllO0YerCjB2#XC9YhyLSH@ zAtX~0nq-P6l_Zr!MaD)Up@D>iMheMPQ7H*YDity(2_YdVlBB2+*{PXb@8-nuQ+3^4Nv-1QW6v>{kuqA7`g zvRp)yNqfg#oHtKG;-=pif5Y(D*w-EWNoYf2YAqsBhqQA0SRAJKZ#ere%FC$?zSC;( zP1p0QfleLGx=UTK1s}y|LN4b!2o@VAsYR!uN8%W>MB#7q_&ODj?RV`zzq;APeWw*7 zy5xi@v_o!CWBi9AP^WAYgVNk5Kxr@I+E(}K^!t!EV@9vO>QlobrLAn8_H3 zH=nBVrfmBQl+G_lbRv8cc7M?My2^sVO+KdDVo5bu9g+{Gu}C|@DIRQRGUN|9DN#{n z@kW7s8;jAMg^f#F6FQ5`_dt0FA3l>|9#ru#xyjx3B@_*BibA-qEEU9S4GRrTFrDs2 zhs;|L~%thnHpFDGiZ8;*r&N$E7mBftpY^X1%1s z#@jf+WU0@?Q}2aNr#p&$#jt3<t2Ii@3P;mUCM~=9rFXexn z#{TvD_jmK%86WZQ9w! zjSONrLN|Vx-6`mAMaw6oHc@-`TYI{Qlyh=(1*ZpPe@0tU84|SEraSu07q2zOa;VjfKiUB)5>$7g$ z{z>?tfmf~-^wpW9B0!LR(Oz~oxvi5xh!ZpbObS!W;3S*t$HvY%Nkk(TT%`|S6{Jh- z5nI|VM%Hsq{%C44Gc^scn1Os?=d~#!(ZIsm2GC+ac*~?B@Hi|vkDE?kLv-bvz=u@| z-y_?yN4MWeQWCTq*&Mz_?co4mYc#Q4{7*|8;gSolTgPTrXx?PxZK$jH#-&tpUD zkM9jo)1k#AJ*O}n&i>IZ!2?7hXF(*jJpn8l*GA|m9CuaK+gM*qh@!d$X3aJ+85u^< z`gMNcxfwieENz*eUo81VZ5Xfq$C3#Vy$+bC>-l?gnbCTCdqbGSwO2Sl7|oaLzIB>9 zPdx)R!-a*PYHNFR8EhM*H{+OTQqF@12~P~Y#vU4rs6DA@oZamTCQ@FqbI4z`k7)hr zD`?jcYI-TvDT%*@83lbPTOA7VD4=w$qu8Md_FAGjNN~z%Dh5j!Q|)itrY}1~yEl;b z;lqSc2(tKfC6|1%7@cs1Sptvxj1~Gz(OR9N2^|Wc(c%g0D-s@OtnRGP)uN(k-AMxp zOO zE?H$hIzbh=2SJZm$*JINYY!BOra|WGE;3&>ZQ3*ts*VyumkwspOR#RQ=QMad#X4(6!#&=|e+1S_W{Fq6lK^g+CMAX% zEdyh|<(+c-c5FwzX|s57yy^61oOLt`ykw3tAm`|?$DKr?v4V`@jtCTvf(VS&YvV>F zds2_Ai`a~7_P-|Twrf@A;))~(C#S2dZII1@#)FF>M_yAh(CDxXnq}uf*(}yGm)hF46&u|7YhY_CU`4ykV<1ol+I3_!LoWgZ2-$-N zPGC=*sFxhg4nUV=6j1o3=;^0MP8gJC2aPDUTri9!tS`bifL_ZC)8PCjDfcvmh+LyaDQp?M6* zZ2D38^k*UOn#uMK(;jJ}>|yvv_HS(T|NXM)$l0qA8O$-h^4Uwk70?AITAsn4wsP~Q zaitSFiPRN^8zIxb+pchctd5BjX`bdKen-O$J~@plf#ah`T(|U3Wjrfp+Eb@01k}%? zvl}^L#PoB|ZPVSmdP$!h9$f)Z$Gm&I?q$IPz+RH^hD7*J$Kx5Ch{ev7o$w)f%!70k zXCQc8yqJIcjdrMRzZvjWz{)69jM98JV~$C01r=V*fI$W>viGWCTy}s1ckaB=mS?e+ ze4>q=o!{SPH=$L;gm3a>MoHWAohE5&vZ|oYQ@41p@*{>@W5(>ws=|Jhie)H4t(-+4 zv>xJO^gzPvX2MYFvJq?<(qEm*K|J*F2Vj>6dl1c6b^5sj{qWGCIOVziebWHf2-RkA zwo<_{k=iqWGDrtbsccIL)9rQg6*Lb#C-a>~j~t2mfTJ07{wk)A2a-;EK}4Ww*O zJrFGdDr2PAYpyl|Bw_5d-QdUf?>g-DrZ~dK0CFG+gutcTy?Y>NmR9tu(o*lXzdona zGllwzn+l4~%dwZp)zp@K!gNMmf`0L+%>`q*z#GgtU0u}!96E+M{?Fc2SgBt-^|HL` zesOJh%LWkT<7+&JbSw=P&$@(lyBkG>+v#)sVxqcsD0nU4S${9tAfhZ&e8;pYT)(oi z!Cp#1Lu6(3SdoNTcwE6$E-(^^jte~YO@y-Ojybl$!cJfg8McBHK-G8c-Yn+6k;Y{u zlc;0=ukW93!30xqA`nkFetepWv=HsMwA3_~XRZLW5mp%V=eYevL+q+`r@{WL#1SL) zJHDeh(*V!N+HBwRSpkLl<#P|K7{vJBphSnOE4~vM4vhfMA;D938NZRq+~RecK+TGGle73m(ZtCL8ggZtVoB&!O5MrHBk-LgN?risZ_6s+8^A&yPuPN_J@ zldQY%`ex@yUu0ll0D%EAynDJVPf4jyXqMYw3T<{&dCAr>u*T}2O6`0ySf2kgy3O}} z(-(Ah)+}P>PxP^40zoDvMfk}0e{m5hq(L=Zj(9U!FpXU^7@^GaY~W?(IUP_l)5nyu z&*+;@U!59hnnbUp)aRqkWygnX<@MH+uQMlp*1bvWBD!;l>_+cR>?MSN1|5SJXnbR8 ziB;SdrXNgbI;ylF{=Td0qCt_TD}jLTJhXQZB)L6%_J9-<<+lIyP7((24%UG8vJWQr zzO2v4W z4^i)DYf~jEXwu#cq#eQnyGxg__Sli-WQU0gy#6KD)(yXY;f^|O;_n&8@-ff;#{~d= zBkTTYY2k5^doL1VDHT(!sfl;!_VQY6W8ntFdwl3Ljjx)n{xT(s>8R z5hJK0A$t4pR3dA@ui=iwKQXlUUz15o%ibUb$u8ciKk5rmjPXZEmRVQMeE?3ra3x}5blS1cbU^9hdULnuCCtLk#JC9Fclor!9u0~;K4oe`xU&Ty#aH_T!U>s znM6DOKq6n9!TF=dkI&<}`l*ouZyM)%;dyH}XvC0Ct+D2yEC@BSAX!|)IA&Yx=H<(k z>QstXE?=&pscE%j37Lj!!zd5a%t&UbMhcBsNXT)%VgJ3= zAZavEfQ6U(HY-h9U*X;Gv0rrlKZPa!d?b%2z@F>Ze+3sid2%HlK(@(&gX)t2I*Hqr zH#dbTieo2F?R`%ME#IvjS@QVFZ#7(hkhBRQ`{1k*NN9zTl95Fy`{t9A6*^)oYaBHu zPNb|2!u$v#98Lt#n%vwB_`*C2lxx4YwlTzXQ2XtHLWgl0Yc^RJDH*s+S8@jS4-^2D zWuQ=eFG9-_nE>q86rUJ4(1pR`CMGe7A=)2ADO&%g(>`Mg)xlRrWX|F`T8;IBCHDP0 zmofodkE)1PhJJEu$X3;;d8|P^SGc-)>o#-qzJJrF%uOuR)Y9S*fNx@2fN*7q{_M`8 z_X9A#7Crt?I~3~gW7biitLeXYI(R7w@9F(k6`nd{M071Xrd@(UrLFa4F zfr<}t#L&TmNuFx9w`4X}=&yzDdGVs@g@w^ajt~;>tePdd^S6uKSJC$0v*XPHTHs~9 z(?+2C2#(>i)vnIj?eQg_Konlsa%F*fz+|Z%gPcVg!b?s@C(* z&2P7R1urR>2>gP7)C8FjyVklzPpjLOQZB*v(1|f^XH-8}Vs&?)+k(f<{PrHPC!ae* z@b_TL3HFm6+4VH4dGzFwHWz*oDFP?%{V+scz74rDaQ>V*K_K$9pvBO9A)R3{fU~?y znFguuBWVS2tGL#anjF|^mzts(Ogw(BT(L?np$SIO)$2hnWQvjAjl5JdS;^5rTmVhl zq4@u=a&%-sa$Iu8IHnn#HNZNM3c;tSriKe*@y{;UOLy7EjlYDFLffjE!Nrgv4BZ(+ zh*mw;kA%3xV>eEO5oE}rgR?}B!M@|ahjuK|($+?%#($1~*`|ar2=hE}0`ql#svYx^ z(}k-A%ZBH_K9J5HJ$Zs1Gv;C2om)Hv&482?Js+Spc0)#Ktz!lZ7{K}gge!N|UHJGU zV)J!;p+)uGL=5TaG&44PL0Ina4{JuiK|nDNOpun%p{B>uIncqH0SN;RftFx?kV#Si z^$DXQWVs}m?1YF=c6{(u)>fH`PwNR&c$2@#cAD>}6 zR&ja3jqPQm2M^w>+iS+FbdRK)H&G}u(dg$TJ$8tk+!R0(%QI;2@dKMur+qN7s1`xe z^uq^`^$0dS10Ke~QvSiJ3_3oLXeuO`myio91z`8c2P}Rd3{N2lvF{9MwnLJ-Pgg1p z@c`YbMhDLTU`H6u_e*=D9lL-3n+_yq8{BrGknC5(Y=_YXpupU@1Rjf=cqRBnNIr-K z%a+lt36&<~7xqo)imO{0#`kS0@fV9-ux!~l)WToBIOx6fXl!c2&+4tVyn;fX=n=6a z56v-)(VeKTPaNVe6nQ;MQa<#EK^a^F3T~Eh=GmB`+@c|&Am*)c^D)1Q73d^FhTkkW z1gN)%uakm<2-AX?!Iq72ztd#r^^lO*3jG_*6ZR%G9}>jfd@*&I5I{`wN$9?PthGX) zMjq86%0M|_{WG2q+%9-TUzF zuI^ytbp40<0D{vspI@Tea4oIF6D+%^30Q#^aT>Vd()4N96g$O83}qE3QGJ(1XwC9&6oFJfA)C>bHTCsD6GX=#n1pv)Y>c+}K{T_)IW*O^Q4-?-yV!w8K_hQi?9__JmX zDb|2i;IepVZj)4|9_@U!MIF8SsQvm2_hoUFzoOMaT?{B}O*W>aKA+?m) z_Z2yHeOaDl(D%O8mdOWi#6G99oj-pwb#t$fGZ6dW5FI_BXHEdx(QC1qDBVq!C z03h&fiBz{;DM$tRi+3s_dw~J(pl~OGu7&!Q+bNjTGy2>3Xg(&f$fdVClnS;!0?#r2 z7_w4oD>?%d*rfG6=MUo-S>H3)YlwS(H$4cIED(r3dQ{cs3XstwJU_WUG6BT-hXTJ; z*12%CCbtPsMijZM$=E(#(Ttu3;ELj~_){YYGj#+r07JQ;vEna>A)GS@#x8Y&u!s)Ykwsv_euTG| zqh~8iVK%tc+grvtT0Djb=@9waS^&=-! zsRb`QHw8_vPtT7W6?@A^5wv(r3| zDWI*3NLuBOLR)?J;=v4$26MuhPe9BCk>Qbn!y$>44))g_G?HbWeA#$&W$9o7eM8w5SWsnZ}@BRA#-Ck*)o}T-& z961Nw6*k14pq&EeE-z1Cs;XlQ>e_P+YhE8cI`GhuUPw61|E+@YI0dcaj2Zq5&q4As znLRt@+O?T-J%OPFB-uWm)i`X*q^<_{VS@S(i$h&^Nk=M6T{?Im-Mp683%*`y>1oR| zB+iFH!``^3(@apd5^fQ#QmmVM#2HGLaozbeK!akz)@GN}(k@)QNRGOC?OLGWgZUf_ zCU(KuFl>!t{M}&}D*>2doy*dUO|008@u#q`A&F$wxC86=_-1Z)V9rUzE6!=U>`Vci zB@^wjxuEayUZU)F49#NKnlY&Rk#y0bBo(os^~x&swWcsz^#0Q-w-)RG9 z5DAZZp}a^W6aXTb00*8Bm7RO~EedBcR9f0|O6zV5m&+I@6`?VtcteNWF|fV~1X*l0 zTTi~AW4H2R=Ib~^b)^=tH2YUmQ^dJ`l<=2KC-|F^^k_JRUygwEOj-s(8hm~2 z+E4y}myVBmOfts{4kaFk8?J$xJ1mAnbJF17XcvEn4-6<}iW&Ta2lpguMneyyisAt= zszlUiv@2Wc&>Tut7Hyj>EU%I(8^b)DTaE(`hk-J)93K36`*3u5)Ri=xUb-=1VP@{` z8ZM{6fS=uKHSR7FnPJGxyad1%;6P4BMw@(zQX}NUC}LwqY}R!MekD!{2a+ZodU@v~PQSFh&2zoS4-|WSDV;Vg6lq8nIbDOZ}hc1LI8= zhbbt;2?m5-(;P{5=}Rwi$7hW=ohr(LX{4d0^`Of2_`s$yNVGXp+&-vG-0nQQA(*&4 ze*74sL)!j9+Hnb1W6k39P4p*_L;|Ls9z!e;KIXq>+Vi71g-YG@gU5?%8SFk>_2B+} zM`3wPldwtlvsa3zumEVG!W5>$Z-e;azb1D6YR#kJ;TEj5o;9MUxVSb# zOO_X!CS|F+aCfQtzg(*{M(rY-Lk?jgKt_|3l@(&bM^`_A*9{cHvm)GZKBjj7*bF`Q z4V}bXgi?AK13dZy>LTzqp(K$#3pzZ@%uJzUaHQv5uekN=$bMoZ1q*X?bse2rYDs8Q z>()`-jwF=}Bjb{i0b>1F?|$&0*ant|)Js`E>n_@!#8fsXJ6o7eB0o|J$2bW=6zEvO z6MrZUv-ukP_GP<44T6ocOf@o*YsQ@>%v?%KlLNKKalmRU-T7E{wqQp*Ug9RF91c;P zwiFNsMFB~K&8Hwhr`E$i7PR1fyBR^(mdm21KgQlphN3zM69CM$_l1O%mX{lu_&lQXqI-r-LGc9K z7^mmDau~oKo>(qx*JinGh5bW0L-{pbNCC=1$s(#Z)Etrz(pFNkNx+`G`ML%w()hyO z4UgwG!>Zsve~|E)rc zc7AF44?eD7a7%T~l=M|ag??*85%TXhtERR@u>-em`$zbd+&9RO@Jp0i^?LODS^zXc z!^pjY=p?j?Kj5*zWMh)e@I$S-q)wgwvzfgYpP3Kl%dzbMl)HN= zHHhzo*01N+cFQncF;2QvVu!;KtFakWA@FRgt4~Bk6hU1g>{NYYOn*uck&C>0u=|tF z*(sGg4JV6%_a28MuwFa2AA~yyJ`S=-OeP%gtU0T6Y33gcVU_Kl+mG;f`!=i%JSZi+ zlp6>L7!WO6_6m&zf1Q9hOy6+OHo5(M^oF+YVSchWFNFF1O=OV=;cg=XZAZuZAAZu0 z5Fr30#3pzo?a6*iy~NX_rXViB4J1l>ql z8g}ls@Wq{bT|IPY0Txbp-iqHVDjKlPstz!kFTse-l++EP*9y|Ahg|TyQrd(iu2nT>qJR{ycP_d+1YR3rZ zBLg;+klSK(*X3^u&s3=HiGSvNF zz6=b`26DiS5p-8z(P%p6{xpP0##!dB&z~QG{dwp1vtjS9Q)mTe_ZJrfVLxMKXx2Bt zfj6ZaW2!90*X6mX?#@1I$Jyw=*Rd}1#`WuZ3)E}AdovHhNDxe0UA^AqL*j^05oNDm z>jN}={(Nhiw38ERMl+OCEEn*?g%t@OZNG)JwQ~QxU}Um_kg(TCN~~2*PI!m`i{adQ zJam`5L0@_e8aVCHocs6B+hxjs89l)LeD9Z2>9vo+TY^StuP%@Gps0c$= zWr10>d zFz-*n6%-sCHSay-RB7+*{U^+opA{9s+~#yMqyFWQ0`90w?{$YI55-=d$?cIaXYrj&A(O#T8ho2gC@woa8Ef^6Pd{qz(H#tI` zx;7=@pU-x(i*}i9X9lY5qD%54XTe@^Byo24lcc;Iq zhY-Zbiew47XH}!qcu;4C#SkF~*n+1(%*EkSJ;9THuq#X-LmW{2S%+UIJ()RDTuDX6 z1@Z`yWrKb4Rv`3Wl=pG#Ty3{grV(;EHdGD*u~hd-Maw&U z<#4pU{n3u$LR?!zlCY9y{xvcry#fAGG=CGcwVU@jp3vN>*w&KSzC<;$y*#ru8paJE z@3f5%rzJ~}9;^M@oBVWSp8%?@{Qw-C$)-o?K-8!jJgFV zg?&GRGMlsSoe%FP_PzQLCLHE$M*Hv+i1bUzly|0yg#v9#SdMxk1wDdPDtf<&Zo?$L1kwsH-C^~v_R?c7rg@VVALA0ocK^F*C$+EShdFicn zOn92#_98BS`h@AF{|Pf;=gg%`$fsC^0RXR7e}Pu$?D_MbxjtlstSXkXuLmaxXuCm$ zmfI0J-b0>)Bk9{*A8(t?6p}2*{I%C_*|F(Mw_#yR&mfTnO#}0lTYbB2G&34|h(Z+< z5{4HH&k{kts&t>cWO__Hej(q+Hp3}@NU_^{OB}Kv>>Fy=&@b=Bi;c9{SPIt6?;SwR zMLW$SV`gIarp0g;%K(zuS{NK`q~Ek%iQIAmu^GPzO(dOJFR#Okil03@0RNM~$Xbt| zTc}rSn0A=GVxQe_7Qi7C{#KfTX3^7h#Sqb`{OL2)yB0#R6 zZ{`hjGHi#0NQr?&L2D<;K+ZH$bEn2jlm}4So;-ehYg_9LB)?w^sC|LYo;U_GM%X|` zFD^bZ)lKMi1JRDF?_g2Y(HlG^ybS>B6~>& z@Q~gS3JKOWWHfRnLUCI1UJNOYm?(7sPqkp$RNAz;V9>~WZLh5ESGP15|8;r&t<8i5 z{%gcUJgh!!@R92|5&{v}GaxTkaBk@pJ|3Ur=Z(VcqA7OCI%xPp4`ti1Kx@Q^6X=nc z7M(xu!e+T-ol~9afBhnMVWR@{>b-F8++G0=Oo&eJy47=^aVq69l9NT(H(vQ4Hi0@uz_S0S46Ykzv}{4F7@cwdl2BaObs0xz2@s= zXzCcKNo1kKm1}-|&hiYwG1Fe=7r?)2{jgdoP&g&S#p2*cm4txl;nW7kPT*z?|mmXH&^&e*`91-YPwuzBZN&#TO8HdSQo0e z2a?4&+gsjG{LV~Q`pucT{ip7~6l=Y#o37f&FdG5V9DPl7_J{)%>rBY`CuK5Gjvu;) zMUp5rkHp5dRmXMdD4MFv`heeXydSvTN=SGM3x;OMab)YjBhk@oHIK&iKO{9^z|Wki zZH2hkpnvi7#O*WUkex&pn-!r;ft%&#?lDb@z7cGBW<<#_@&n-@I$sOlarp7BuGXwL z@hBO3YJYS$#^ve~f_H^*Q{@*zhhKsj15-DLBWY<~6k&q$h3S}jrQrM^vhB4~5w{=$ z8RG-4czwNKQhhHzDi@D=^kK8lSY5VOxqMFCOX(n263h63Y}c)+!4vQLo#4G_{kXmi ztN+z1UdQ5)*3<2^m6da%h3e?pO}ljW8e%!cF44^9Qp~3LY?3cy!i=rnROuDlaI-Tz zlbl?TpAY5$0Yp@%qBfpQcrh_k#*fE-6thMHgS&ILB-pW?NmxuH?9&Ty5HmQY>m^7I zsRMYlvB9~;kXQ+L5RZrwA3vTZ+?+gFL%l@^q;bPixY&&53?2%e8{zZQQIh8xYDGN6 zEEo0>7@+2m-Z|g7S**=qzQVDF;qyUt3*{-V7tC_VJ_fM3+_`dEgn=9S=sq#)->;tq zyMv1N(TOoMKl1Pu8`m;1-D1t_{{5FkNk)1#@RErUYBJA&}Q|ZS&rWKqS zQ{&HxYin!DWQ6mdRFICJt85Mo9XwtDVeT(aiHp+B;NDm*rnw>^udC9Thh7!9Cht%K-n~Z{s0~I7{xu{tD^&x z5apOP+6`r+PC=C`@I%s#dmsLj4sL|Y&`zn;;xYL}Rm2A=e?trQbiTRUCBt?DU=^Fi zgob#>cyOLS|E|Dfurl5#f+3c&HHY-_HJ(prn0op0{pI7K@nmedhLWXjdTw7aH!1>j ziIRaHpuf9pw_yssj1^z$^S3+_yx%G1p49gPtUDGLS5V{b_dVE7rs8@?`pEEE!V|)7 zq|em9uEXLCOc*uHPA+M$QS$@9qN)`lq(#nMbqToR+$p+$8e`HEl}RhG2)y{p$4x4_ zF>S)S+ZoB~RKV=%vV$1DVa*z!H+Oabh|&;PR{J1UXH4za-cm_jJGs2a8#uz)-nk(P z8FZm2>-C)eWvxHa*#HPVTYZJ*D|vBhK+e1PC-BLBvV^>o=uK~C40v`TFdZSjGpmY? z+-l2icshK2dyGquC&!9+?K!VwawdAcZ|O3%Y(VD`Dh_>GRF&U!-Wl}P=Gxgb=L;JP zRYQFnH%8S~MClf7JeBw9_2dlG^1cxF=F=18X^0>Yc32TIGg)c{P9*4yUie3I%lo)EriOrnkB}f=C?(I2j+FT|L)*hOsfk z49~3>sp1D#)t)d$4LuI3v!;1-O~hqRzdB@R%2N3 zhBHgv+KX50MQ#L#oONU?SYsnO20Ho&M&C@Xfr{DJchkt(yDz3=w3X0RsZToTwPH}v zD0C)GXT_;&IEcKal}=6vq!mQF1}P{AgM3x?3+kO%!$yut?B%jor$`p^?^e}LAYx3w z1#{h(FXvbsgta}@ZyQ}~;-}6cnVEgT-y|jlXIrwij9*NnAA~EVus#%L_X(0KHsQAi zL*??l6KvpR*7)E{;10BI6kJ3188cRxxb{Uz`IvUtd-SE;L9QHL+YP7JpZ-B+l?CXUH$IsSFip8{^wRWE-S;NHYBUhEU6igPT?PoJv0YT zOI(V33>c+-Ln-H}a~g+>0F^k!1LMdhTWz@f6!2SMY%o)hZ}W_J*Z@*%bjIolWh)QK zXhF@MRVmhZZX{B;4zl&Wi}0YZM!SFKO+g8i83GrL!mNa?y#^a1xsm12w)r@40&qw> zp#OT|GYA^GTo~w6fG+&Nte$ZF-poK~4_v>OYc-?hp~Uz_gVHDaa*C*l`ln})9xT4K z0d*s#d~3N`SzPSd@UalsD&*l!q#0$nQIIUg1knpqD8V?8jcW?)EYgy9;dvAkCqR`-PB(lN3>49{fCN1 z5AWg^FCM>p%3B6Jdw)k-X}DPDO?4k8PethtM(p{`405G#bBQQ-Z`5FK-@-n-;$$N! zDXFbY@##rM|8&ebMA@=;x<<3x>Z5IOsGu>iFSl2h*rvI?6Z2_eI{CWk#}B1*_i#k| z#1>H9TQFd1@IQ9=X3eSjiU)D95Q)*p#?oIQ1{TiX-4NWCdESFy0ywi&l!?W zfuc}Kvz_3K)eYvn@?jr727NWVun-$#!C^JMBGPtqZ6CkpU0w^fFgWDus)g=9c(8%a z3TP=-#ilfmCFe9QU*Em^iJCpE;GCM&3_={-{C$g~IQ%SU3|)u9A_!2opK>swsO=Z+fTm5;Xgp$5lO>w6e;=B4TG*;RRQx{vtN zf^X2>u=$pjmw`8Vl6|%*ZyzSqPZk#AwMK2k@)?hGc#{@VBc*!s=wc5X*m+t`bf-!P zQ6W+zHUfwsu92Dnog0X6cR+ydjf+(aEiBxK?cajKaN(J*^q>2jeb@_#95+D(o82G2>JbCzV3=j(-ZB~`` z4Ph3kEXE*i_&(OT78GQ%)@E_UINCw4pnu& zP6wf&<9>o;c-Q{K$&>j|s$J$~*F_SIh#16V=7E&lA$J~UAd((GK7~o<4S#kUwYRlw zxb?jon}+!EOi^3(U-Ii&6+9QxOZh$^Gir&IDb}?13CnIw2{ESaN3=SZZQB!8g(j|b zlM(w0zzf;rsIFIChiNQvg#-#*U6$^#im5+D3X`Iy5CJotVWHsVWU$;%0;Ur5W+}*X350!AjoFN zv<(iQMLJ@4-L=Yl?$B}4a~Cdr!3AD@ludd|Xx@BphK8&Ib|%8te*O%Kwv3M@{D2ptBRY%;?~k@_bjF>_Elk54l27ay&t(5tv;KXy$Nt8=MHy|iKy}t z3u`?=N1alAyw7%(vBc%Ey{&cai}P-t!!pqed<7@1zJ<(vUYx$bzqUXjD8BoSoXEbq zuC|s}`7l5K`KQK?OFVdj6L?){T+|ck;E_|g0l$9&S3Y#4x%J_kQeTH&Tx*S@j;a-% z7nLC$Us%@rHgd0!DvT2$p$cr>xPncdGctUE7Wp8xUZyo~-wFi;N(T>0ESMO+3M{h_ zn(w;eGcSZaKnzIXHB-GzlMI1HRsi}{{&!l2vNIVT0Qg-FX5 zz6T=LDqjC4Bepjt8@i}#BaBLKH(TZ zZc})sgTV-jv-_}_ii#!-A1M8x@5o;;g7BBVzO>mzn$74ZAXvJanbTfuP81q=0${@YdntG9K}R#Mpncq z6G7@De(d8E_!okE2a9`HQ-!E{w_$wZe|3O6>+n6hn^7*fWdQ^EQPc>BwPiI3FBYkr ztNaI@UsU4k?2IyN30zDZu$auXNKHAr|DpzF$w$B&xbq=9x_)&^)gctohyZTzsBUfw zsolK24Bde?Z`woM*?8RYmN*5vX2TDj`zDRM4c5W0Z{oNWd! z3l?})K5`JTMka$52koEV4gE+Yvt`Bjw$?A5Winv7F{_nZHe-XPNhH>3t5#KJY>7-z zjyFF-k>XWnwPV_wj|h9-ICNwmlFJzudPC?-Ox%^A%((8r0S#)G!e{H<>ur`SLBoJ5 zhU%JH6HH_Dyd!TuCIp0KFGs&F%qK8?q>YEjj2U%e@Q{Vj9*KtQ)~@~8(6E(a2h);G z+PF9!KD?0;`xZYbIXPAz6jIK*@u*wtwvQ();l#EY54h?o3haZ?(VyTyf@yx=nC+jS zoW8W}`69c$(-VY6%zrCtR-F5`1O3$}vOGgLkR)N~{_0h0eJh8pRxR`If$Zf_!Ek=! ze@J5wpZv&n1+D1TCzHQnfWiz%z?^ZXzpxN(d0Cq=Orxio>nh*v9OviPPM(I981ax# z*;*e1SLrr8mX_9SciVZ_{x1o035#YL4``Vbg~q&Gt`*ITp_0x`j%RNH=r9YJ9#r)J znOWTt7c_^Bu7saLkt`($YN+8rBEsT)RKaE7SUVmyLnOo43)Eh2S#dpo4x-jVWho*L zZU)@TAyX&mnoFV6$o&0&sK4Pb>EO7{b!YT{8Odl-MSzDF`uah=5)LBEg2-J~05-nF z(BFZGJRlp>ATbrh8#i-H(?zesT(|7yDT1fb*h6&`J+0Y?i-v1? z6(?4M*Xte{rC3Av5ylXUx&x&_24k}|(FP`>)^roe#?8JC4pl78;kJ$mawl(Tt$TTJ z%=`z>^J7G!L^&Zh6$W~`v+G%7vH8KAcf=RkN`$f5g(rJ=KYEJSE)3tFI}et4K#%Z& zdu3`nd4>hMNI>U0+T2+u1u%y?R_Dg)Dy+YMqHh4V)Sf&UWkg}sms@nRAR}Zsw7&54 z71(KXds$;B?n;eCl$M{eL4yR5R~^bhS}- zK06|`4v=3Gl<8W@@XQgz&Xu9bU(rQ)kQO+Lg0uQx`992^ zO5$Q+@`;o!Ha0Jt*IZ)h8I-F)CckuibY9Tzb#Ek8tx%U?&c_^Zcwg~Y4iTiznG4(* z;c`rx%TxhNd89B zsAB=8F!LpT=-Zj`+IIT0HaX*cUEQ1_PugKT5MyIvOy0_D*ALpWr}sIDEzYJo6Mu-BOSb34;^B8jQA)-i3jw?dEp z3<061CnvGb40UIXC`mb89Q!C}N-iuJBrEIEWb{`F1NuRON-DeM&>hi#UJ4lQ_I$nKc_LTSEYx8)h^pr}npUD(3x30(|U zDG!YPEM2r{6G4UPdr$)WZi*P>84qUnjf#u&!`pM$-8ZmM*sa{6)zftkkGZwcX!fjBsH z!>z)~RbR?dKai?UDW4^YA$EfWzf>VE*HNR7to9|E6`l;kCi;VdxT#aejk}Q9HN=@I z4DpImM_7}bxHdgZNZpOk7lmHz{HBuWLf!4Wxiof&o>$RXwti{uBhr)KfF!KLpK;}* zgFE(3EAm9Of~K$9U1x?xhs&G(xN#;*;iYMoEZUancvf@J@bO2Wl>^}^3ory6MT)K; zv!YvEHsNl8^zwiBgPmO^O(2qo|2t}&Dm;y6T3F4S_n5ZAcvez46DLyO4*|3D^=%xL~r`4Fl5Ld3dy=jnZJAcoGz+`!Lr$8&o*(@$QH0VVQDqp2~mM? zfxH$2wzQJG!M~YDUfodn#9rOjuhlEw{NqRWwy=keKv?Cl8U`J+$(qGnfC=8;k?eaz zXM66sG`6CE-H>A7a8+A%68+iJVcT)hI%PS5p!MiT`?)yLU>H(U6F$lm2T#JTjt+$L zvNUU+?ud@3OS8mgto$cWMwukc-qM7!EihSKr}(jx$L!gACvJ@F;LJltryS2+ta6wU zDN&adzxr%sYWqt(?x&H%B6`7lt$h_nN1o@U#l?u4R5|>otSWJTL#865B7`e7I&SN; z=g-r^-tn2}!`OaK=ps1koJhMi=cKU8%i3D7E|1PXr94M9vLI?gV1hDBQXu=W)C_|# zQa%(>+k)1jxVGts?|v4@Qoh_siavfgq%@dsn-^;yNjOdTq8tRQP=?xEnD*C?%$R)Z z$0HCYxn(djOBL{H`Sy-mKlHIg1EWXEAqdJtB)SD9kiU~mq7PFVF8csy<-xym7)8Gg zHOPlRsFZ+vFF>`+Pq>9hPCMASGpGZGD}!gZRa4>8)S9`9eb3 zOrh(;BJ4M*nPvz&@YKfQ`72r?UoPb0AW|V4{zKn+VNOo(0VELp`A={bZ66=NX-G-} z=Mmhc;FWig$2bP*3MAZx3l^{}r`s-pwteha$V3YQlX}N-u-md_3-dzKer`T)QD31q z&ObE|B~Ga7I`P300X!ukQ{JjW+yVe9(cD&PapKCA21*RZE{Iln^%EyPx3D-50Scs3 zAfReR>&S*;MVeZ6Vi^^PQaE-xW8vuo7bEN%GiHst*I20_UKqGoEO7%67u^rMm1XSK zu3Yt~&xC(&I&zaY9;4S<+UHX;r9Y)?5?up%|Je8y54Z)NZL4#q7d7w*;BUqHwfO`t zorP5lxB?7=QUtiz%-1u77a0WtZ=5)BUKpPro#?y4W0PICUGZcB9KLTY20&|WZU(!g z=$Oo|CDCvxp+@*_m|Vj7;NgKQ1tnlFNB*RCxzKA-=xiKmp(Q{_|B@HC-C#^BBA$QytoXS5B2b>$43l~9zp5y71j@Xp&Wtu7{g3H`7YK&zC!{B0aKq1*C0$@ctS`T6q9Tot4?pvz z@ZLJ{+!^GUf&i?YZ)xNtwnXJHXDs9Q`)K#{zk@a%o;595QKSi8{=B;fkn^(Wl zmMnh>HHpyW6?_nQ%Wzz>Je~p;uBTqCZezS9GZbq&8Y#ALw6d?c_qOK>M^8cW{Q2`I zIL+*5{bgm3;lMv|;KTs4R0fi^LQ(br_dhqdRd3%e*T`q73f6A?xb2_dGgE`H5-fm( z1f`>=@W7;+X0wvnq;L`I1xElxlKC1aaQ_b3v_rSZFCTx^I zunY$`;$bl)sek6ow`D=I?UcgBx^;V*;{8uX?~4n+@4UFKopSEfVI(94`b%ncrF%)5|^HTafy!Y1LR7$Z;#tKFd!Fq!|#9xd`I1S#; zrq>@o-0{@mv4%yIdDzkL^AXwBSqLe>L0i_Oh(r$}l;x_zQ&eJM$k;=S9)%y+3cGhd zj+qQ2NphQGn$0p25hz(%*=!4`==@QyRv4G~jQZbX(anT@LUirIg?$Oi#87EzG6j1V z=p1F2z1okvWFDm*5iUBvx{)H>qrORU^8UN_kn|Weq4T?8amGrR_%Qhc8SUx+7LtI? zg^dVKc--`?;a)$kvm&Eo>-g0H$<*6aF95Jqi2^8~ky;-5TpkolC^(t88n?|B$6b2v zQ-}>#ks3y`)txZLl*)EnC_l2cpq2dg9CrW5kCd z2XsiTj~KnFFntAr4gvsr1g)DI_j|%LMND#HwALN{a_d#f3EcUi3DS5v&R)P(;d)R) z5e2HoyaC|ly-)z2swSUMTrv|f_*8Z@-|4`Grfa4heJwR;<*Qfu%TrFxi+Wa8CiID1 z8B1Yw0609_1y~%1HkLrs0(lZLNAHhmuSs$@4dZ!H{QRe)@|Ph9 z6Rt1XZQ8UL{C~Vj01I1BJeqdb0Yl(@#6DBn2b}n`KQ4LjosL0yQs=lNQ-) z0wmzl!-IiM3CHta-b~ptbCCNlOKWS~6~+XS0QuiJ*v!xeUyYc}AxsevraSEn7@-Vg zxV;OQ_^09L&uHT1)~$Mxd0sB-jCQDuz-4#f0kthYKJd2TsPtJAm(Q4DL;2M&ygxLh zxDPisQyVbFVC~nEQ4xij`S$AnAO*NFv*)hoRzgSPheQ4R`HTab_fCHcKweV=xdQza zKRU9eW@cdv&td8hqi0m|&b%6%57vd6;Kjx-Q(-2jWt!MvB_=#cj54~5iT!0~7a(dh zVGd4~pj2otSgtt)n%HHe4(HFS96i;2>YLJ0{r55hN3=W@;2aP)VjpP?Fq|z09H?0) zCSET7S#JP&sNm?!KkF111xzs=qW;PX4&qCb!^kN*lMJ=S_3ZT2vFRpN(Z5;6sENB6J z=zC>aZ6R+=pI-W8%C%tL?{J)dbUjyFCEv`oSI60hK-IW;$_xtrsPo3iN zfrK#k>Rc50vpj4$2tC+aF@5@dh!5~DXx9T8tf`*iX1<-in`8Ms-sgTN9M5{2jgFv(*IzX z^P3${U0ryN{}(WUg6YJr{8Cob z<3YB>PyFN{tV!M8PKRsuR1Vns5Bn0Bb0Ev+N3zkf$|*HHEp0)(`Dv@ML^H~@6yK)N zMBuK%mu_CklbN!$*%h5>6un9+dMg-CeE5JXEsyF`tyKu~FJ`E5s6jM6J+I6fQI|H_ zq)0eGu2nm&RZKa9Nats#uy|7#!qQ?zJgnY6Nd1Sawy^7DpYe+FL2bjh8i;qnZSUG^ z`~GP#kDN4w0i-~E95%mB)$aCE#!UE6&?U0-r0V>-BNL%O;(Vdlm*VopSHECj!rVt$ z4Cj8yp$h+#S6(hGIOAv7u)EOvPxqNw zINp9+BWfO3l{7^-tNxP3xDRW~Y4M@BppKFX3Mb1kHH-4*ZED_YmfdHVF- z>rOL3OJ^8-=JMqO3Cesz=F=Y9#{hwQn2fgHL%?Xq_{sNc`iI=-G2J0+Rc`%hLX`*v zAT0g3`XL=t8jS8)z2ibg-Z=OYgg|zjw11e|9u*U_uZCzZyC>hN05>>H${1|3tbB05 z@B@1XK?#6xcfw184Ua890XTu;uw=~ z#F#9jRgqzEVa@zZnBp;n4NO%y+CleEn{sI2-sxl~08ShsWMhZGO!(aKGB!Sa_RO7X zff5ih)m4^c3NIrkhkT-aRcrEryc(iDrXi#EjY6#+RlokG^9zbBs6Ith)Zy8SI(1VV zHY}dKg7xoKr@f@Kf&N8ePm0~_e0tGgkAnm>mLkFU#X<1pud7r>oaB!DQ$yzg6pSz| zDTxW|7^$Am{-Z^c4bFE`v%d5OTL0FD!kHH~^_5Ix3QdiE`LYJ4byuM{VYW5zsOIdk zheA`d_Cm@1E9BDcui)+wLMV8sO4e4WbmRriHP23rFPa6qOr6GbBc{T0o^&CR3fkn$ zOuu&i7C`+<6u2KX9K^oEMh*~n9JrW@mRRtt_rkb>RW5WYnMnP zq5mpNP0GkvHuewFPnnwh-RMh8XRiGu+BRaJCy8KOLV93Ja+964%_Df7p)TH2nP?6=3%Fp zOJzH1uu7JwPm-GXMzfsUg0))ZX`OXsDxxM?`=lhQ{Sd2#Ia$HnnUPNxbvtB zuyPgh=>%$iz9@F83?K@-wkf2R9gB+c0XU(o*c})Mc4QW%;eV=@cM8Hr*+UZ!d|`4_ za}BjM7wD?i8Aun74$sNMj7uNAwCa9563>5dK>kV7!ardmJKWrK`@)5FV9yC%ZsuruF7;#Y?j8qYc-m4S)I9e(kLQ^}Wp=ykacTfiI1T%$xm$#U9wt^TZJ~ z=2X|LB6kn#DB@i42~5Z3mdbD4x(j74qlWU}X8#b{VfRymqUN1~PNsmOUf}X=*x>hc zJz0Q{Pt}#Q2375%1q;|fyy>G|CtqM1>S^JD6cypd02-`yA`t9=xwqG%MUl)xK}d4u z1&{VOWM&%*j4{j^8`TsBNQm~HLmYEBy<$COI(sMFH-1_y8=NhWyr6@HhQ9y#+la3y z5_LqcfT+9n&^Sjb>^>iHmt;9>7P|+n$Q`7k75`n)kddIk!#4K~e-HjMiFrFxFs)R< zckTBFtVI0Uo;L1ZaPB!Q0mhl#o6YB{xVfM>SO(NokPg8e()C7%%@ZnjiRok$e5L!{}tg7yHUD~CKNai7( zKCI6lFV`mjZf=%%Wg#Rm+0ZQoBd9>ALsBHiibUFQ(12L=E-YL^QN`(D<4nx?u~I!L z$HBb#XJAr|C&dqT^+8ZD-D}8TlMBaL}MRU?5fjvjcX6v?;)bT*XnbG;eK0G_0 znnMtoXwCV7uo;}qu>L^2{uPLS*g&pXgRlWp+?w4z27J~Kxb2W4b6VO!hVwxgAT)$c z`Bl2T{Dq*s8$NuOW>r_w_I|32KbSgDjti47-_3#TLA2}f2b zJoolY68}dv0mo6_Nnm7eAnAul0}<Hd-W@P*5*auce;5v1FRUx{B)pryQm6*>Oit`GNES%}j`T%x*i{ zf_3#P7=0itpSl%SzQ6Q!ZB>2zWbPd0L-*!4(n}xjN~NLB1}46fH#2sM?uSmPUo=kH zT)24VOn3)Ds9J*lokvW30DfX-pc=V0vJ0*r67s^!lZlt=IfKl~=UTBM(aYu>70LAJ z(`U`vgL~(*HQ!h}11kWKkRP}KENO8W6r2r617TL^hErX`V6xcyCE%7MyDDvka^oQ8^X zt;LS4Ezv_GxdQTWUS3{7ftgbH{w-plfrt>sH-Bet%rT@u;FH5{En|cOWo34*{)tv+ zZhbci=pmvIPeRiOAKbrFuDZfX1p=UVp+3 z^JkU*dpT=y1%rC}<56&TDsb1(J92aTl)QR1E;0{M7C-FT^m^1auHc%flR{mpJ_2$B zL!l2$3@CFsoL55~PG3Oj@01$lvPxZs5b|*qnaao}z&1J4>(fGxU+pkl_(w(NjR^`0 z2{}e$09j`GP#PJwlQ#}t^RM2!dUYYRkmt^cg{MnC!H_Xd#2^A($LNoZ{cb$*g()(F z5*lM(;}?zbm%^a8&>G`e3pjUJ%}$K9Fh~KZWe0eIvb_(T$@yNu&(uxX|$h?&ri-}$6^4fBoMp}`$5jL`t^lU>Tetq*o-`IVHr=L$1=`$>6iz|IVS@XRRFsC7CC5&Hog?oZ zxsOLRSb;EvwatraOQ4H|G*INI;j?+ODcPH(fJ1ZUF2T=(ocOV1zO~8=U@)y?$VGunuV z$z2*(N?b1jldxzKP5yTV+ zyBPzrNUuRkqmW_l1zOg-z>SkeKd*E1%apCuS&E8^^{al_tb)jJ$D*SMIbvAk38pps zHK544tkujBzkM^)&*OxI9UdBioC!|`Ube4qMp|%abo3I|kzu`RHFlh`axT6|s9-&7 z`$rAxvm(S=B^JIV5G5%MehQ`O-_}-tLx;?69Q5DJikZZUi%HF(*2KxI4Flc$6SE_7 zWA)^}ok@y)NrkL-@%9OCzy4-^x8fUW3fWjo4)8CYDe7F9(?$TMDjYE zD3(``d3%6E67* zwq(H&dU5eM^ZGx-_2bMAG?C^Res|J*DzlAK%KblaE~L@0b7UT!s^E;*tJhj;F$Ayz zL+Jk3cRS3LdGULYA@1E9rS4#e;?L8wA!|?{axUgexop9V!QtiHcpQqawpIq@)m;3i zuV#)oyi=<$KDDTQG#S`@TiHu&C;U1n>zwdsm6e&_%w$Eo?p~tQ0G&ry1@-w-FAC~J z!4q%Ko+I#MI^r!GIPcYKI>K3H?!YdFc}~|#hfWr%!*nqNwl9Gb&j zR@N0za>^e(M441kQ9(lses|LH;k)mM(55NA`T5&9&4%|Z6+{vw1cSD?J7lgqN&Yo zbv9NZQ`*%?TB|LbZZu0ax`>h{Qq$V$MskGE_57Y)_QUlbT#sv?AJq5paQc4F=lglz zzuvER?4|YjBG#n2nYYJ#qfURRxx4-8w{Pvr_6;%qhPht&ldzR+dQ54V1k)lY#FrD&{$AP1$OVbe7US4n~2+xf*%sm4OTX> z$&IFwbrolBjwtssn=)#s`@>nJbhcP;<4nIcNNuSj$b(UgLi%%ZK3jI>j~fACPqyMX z(&xK%tG&r65mxg~>qhf*T0Ma6kaVZ36Th1%3n%!bC15>bSe~n4fmU2_M8y72KV>W= zXf{@3V`ED?nN`XjRG)<*qLp-^;Km6XdS4z-*+{G-4?JmMlt zm}D5ev9}JBXLK!`N}SA4ZCM@+53@L|+Te|@Lha^7IFlq&RyyGqRu&yKri+XIf9Vs( zM`DJ9d+s|f8kAH>xPN4EP{A%In8SP2*JGkCzB5W5 zIwc^SrD@fOF#a0ly0h^G1v7nLb}E%`Crgoe+lz`DNG2K+2XyxAv5s?P0y8-1Y`8c{ z3%PVJjg28g9n(vTbu=0iOcr1Q^Iw(>5cW(l)b_@ni(m!NTk8+j48<>kBf;UgY8j=; zpT#q#4QH8e8%zdJhct-j4^WMm`UI!VNzYqul^=LxScU z&{Wbo+xH$7eY915r8O}0SqoMfL1$gg(VBi?+?VXlU3L5}+)M=nl+cB+LGxBOX3Kf{ zY+NA*f61-2@QkrBvYI% zE3#kg(fsmwBuNufkr!ako|0bMy0$P<^on~b&kyQ`0)E%q&3VclYU%MK&vJ9D7<$AR ze|^=5&AVhvR9!CnA;K9%a=1>u+b=RnLcv`Ug7mM@YLN?RFL48*$H~n@9|S`!$I!}% zr9=pE>h$TaF0B)uJZp1MI&E_WNTKz$}BUlgo7Alny{Ni6N^ilc|F!{|V7bBZFy^e;SekCZr{c(j2ImM(wmY9 zJqGLZN&j1AbltnhuYeNOO%HHn&Gh7);EsMMIerd5tM1DHd9t_%4$*nh zTa5J0(;clf9+rE~(7V&OYK9&rlT_~M`u4;+U$fMU(F!!c!&SL14M$?B;?UV`o<4GL zJl+;A1`D$YzI)hChea9ZEn35h+ktuQfMQ z9C-iDpz?hl4wz+O@IX<)m)%?^(I*`Ux=k9tnGTX0A5l|lyn&`87MQ;%>3k(=5rF3=jJ49=g#_Q`ru@!Ty!Ww;Mr6kP6 zpF}HVP1~i}X`4xO&)8}0#ESL#{`;*D#EceWrq!8Op??z#iX>qxx`R0T3s=Cw`qVqx zD&ySh?k)59QZmWK!|RyY+&44jo6zDlN=t*{r_1QtI&+4=0i{kf^l+8QD2iZ-B?Onk z>2d0V+&n0?$;slEq&c2n*CZn?j=V$18l9~c#JUV@(M~iOp5;EzvBty{YCMx)T~FMo z{jn4V5ZVwjuO?+3scs#<(|S}18^Z_C#C;RQHqN+y9BjQR{AX((K0^zbx(lxx38dAy^#Rj#tGI_|D~_*HL=v@u26 z8yeE%!eLhhTzPg1$H*vTF$86of3Ipd)X|GvxD~;}E~uN;gn!wg1{LpbY53={{eBr_ z9?{Z{O}UW)-^Et9_VC@{=2;gr_o5x=Ej&dWu~^GSG2{{j=4pPxL#82NUHtVERMo)#8| zuh9PJWSO-RA@2xdUt=ma6+DeDDb&&5%CO&M&*BJ^0Q|SL*aa1!>eC zY3HE?o001CvL~!`PE&WIZl&q&92iba4^n${tl`hhNb`P?knM|qA&uB?^^QS;Ag%Yf2MEdAFT^0hgR3u z!#qbl_uHNARZS>oZO5A0AZbXz3!B+efAhXYW9^JWme$-A>*0bVOl{1{^tnT9{_#AO zvAd2-UY)$>*rLJq=!GAZUV6`CjIJ%noVIK61I?k`U42RILE}G(4$9kRD(I)OX$WBO z922cKb=WL<+GtMBgXPTz`Z~z?(HqZQJZjC-6R~GE*Tp zwsNd#F|0mw;n@dDn}Ygfx7w0QEUs6N3|C|47!H2A)A@*><&KWKilT;2*>CObhI)Fo z+TLf=Rj((nKiQnrp$IQf47&%3Cbo}0zuFUHisI#oy|Ff)R!dNF)Ra$^_6MO}Lkb2I zx0Oc@1yLJ3=MZN0aYR|-MCB-X;iL``MvW!0cs(sE!|UEm*eC925Ja4e;7yJ&%TJ5$ zP>rN5;P&=e#>Ek3RN_2`o5{UFarmVzTaU3-+9+4}fB&=Bw;1!Nv%B3Q3dW~?9(Jdr zHjg*}#pI>wXY{(V*Q9-Fyqn!=tM9Y}SI1#&uKJj4omDTL{=HT5o~qwMa!23D$@n0s zK>`(kUy9SqomFouBAR94qlaj|c#%QaE69FPTR=hbk(>9O)jg4E*;ON6XcTB~l<1%I zPMDPJBiWF$bP)Qixo(lRH0gwPi|W?Kg}aVPmpj#bhY4RhIBVJ^e{*G+ICe8?{=yBFqB0fYpXa`rUjWd8 lHTe9W67l!X|C4>tXh3L%k9{|^HPsLl>c5ogjA#Uc522-|Y;-$uekkbni`Ag@ zMdHH)A81dUHl;h5vgeJOV@BC)C+8QBJ70Sg?ITKp@)Ur=2D5EB_4 z^`2H{Kp@y+_-GLb2K1kJdD;d~3d2qDxWFh_Chd!sTT#Q|l`6Yy6OJHw8&w{EWMZ*9 z{B}o;ZJ0`t_gqhmfx5bS4Skr(_{lvva}fdT7W{wqqx{Rh8Xce=dBiTPD@P~_AXb;I z+C(Ytth1Y3bN@ug5jZZu8+XCJlQsBPczSwzYaAR$%F!2-0ih)#SBvb%>LXpN7Bz$& zbF0_-2V8MM6kcr5T3?!WZ19vEexr@D-PY99l&UBIN4bbx;k#Ds@SRM;<2U17gXYZ3 zIgcv@uD{iaR#^YUnroUr8b;4!TIoah!hzZDHq=|4?npJfM~6V17Np~hxOC~#Tu;tc zX~RjT&GuD zS5{S36^!0!)C+$8{!=2{PhtIMxSsst=Oo`@Bm>Q~PD{&7$v~$_>07Dci^$a$g8WFt zg#e#;3E>xqKh2S79=u`GL#L&sh3{j|+D_`>pv>DUY9o_Eb~Xew{*az-&rn#+j4`-$ zsb#VyA*%Bo!tJRq{*qxvdS2iu?v+sz+_cvsc4xk=vywPzFOHB_C3{%ns(xpMbt z1fdinvA(`Ort{ZG9V<%q#^(o}ot-hyg(DDNPbMcsqTTAoaBE!n8<--y?EkiLP~NTypN!kY4` zd+No^F+mdK&E6K?9k(eRTDlf3+NIpGaJRN(RCy$8;Lp7xqS6axV=UKvq=UBBoRx%(wWlj-$(B_K$gx$iX)kELA;V)xiV&GMM{`_Fufs07)0H<_RbA@;F?ItCU zgJFC02bIexwbu;|4IeXkAYWDL{&dNIrN(gACzZ_;{ zMl7YkgMWR>Umke`^Rv{KI6Rn!BR3;{+Evb^OCA{v^vw81gCM|qeq`ujVS|xrMYmew zRikn(DkV$Ld5nM6H1bjJMYxDo1J({Q2d3=F55k!b*C5jbdW*YW4wAu zGWB(PeV@mF`gKfaegn@|L&$bR66y#dEQsJ}zp-?|XP#JiHd@QNA)Q^g(*zga+lcsC z{YZg9NH00jAS*L-gGkvS?j=b{NDO(lp^#~Mfuo1214ylHZU{B+4)vLl`&}kAO9P6* z6T;M=?{Z9f3qoLa(2u}7oRyVjfQF>;1>)IL4j;Tl5YDUeXnrXYr!(n@*}7^;Ps^9f zgJKy*gx)b24<`~)aSGoXPfNzGmPGcI6MSdP-1bDggkw)01_uZ5=+UEm>jwC(>O=K=A-fo;vqcbmC#iRvjN3?t zYLp`Fb=O=23X=4mf60@7e*O7-G5=SWs3k{Wb>DFXW1BNciyWg-1J=Y~thNE&XTGVmcv9EuolTf^*1CzQF<; zZBI|nUCc@}?7)l12hdoRx(wahf2^~+yU1^Ovez=e`Ns#V7cX9H@GwJKNnt0m*A6l< z=qYTBC%D#>hfsE|T)6@uic9{so1foCaj)e-d;3!&4Wu4MBaU*F_0h*-!Q?rN9&&ZQ zZ~2w=lfGidUZ@N%IP%&l?U&i6`8TH9U*{-(o$o6g*w%2ZUNyeIf4_y!!puv9rdx$j zK^b+et)pW6-^OrqapC>npTmzSeR7BTId?+&l|j6ub3gp1o+5cgM{v28No?@;Sft`+ zM^uSZ-_k}~Nbp3{3%I#R>0sxiR1l$mINn69 z@zdcS3JN^7*B7S%B~|$?uMv;Sdf9n(QV3I&H6lI)&hWi)P6eT40FADw-39RXg*SyGWDW`HygF;8BAE~bx6;$wWJb80yBdwrO5jMhu}#lWY$Vzt-1vY+b7!sPuly(~a@AwHzedoC3KIOT&@pqK zMyVO-w%0q1MQl7?X1-(6x3dtlKxGaRuv4-6Dy_+ zno5dKC-{(EZTIg*I3I{Ww7U-v4dmKv`S4D_;w^SB;}I%$>~k0Tmv3r#wHnr3tXuLY zGTZu+#F-IA%4~a-8jv%|y47zYCF*i@P7TT0a3bu&`DjB~uB@(hlM?HAP*z@?-qu38 zdl5O*nO>utJMRj2J;mw7k&h z=&SQmRgd$xzTGAb`BFt0C_1Q(@o4Q>QK&3b){maq*&<>pyzFaiY5CqbNfP>&2MG7> z#k5R%!^@-9L2m`vsKj}|gG)g3$v1-h+7Igx;EJrr#80MO2-(>VY^7JaNLdn_={D>- z-?qILrKgy5k6BxB+sYEirRw1zHc_*JlWAW4_8CD-(O7x65HqvB@y2LFG<7*oxaF44 zA4e?SESzD&T&=+96=Ploeux?Op`|oX>ohx?tPw$@#oqG z=$4iiC@!<}`G^OzSc*&#sq#L`zt>`BI6%%F)_ujDeq=5Wx6@}}a0en=7 zO3eYVboWKmuo*}u)GS6y_G}N~{ZRafyKl=DG}9P?Pq!2C!F+{PvUg>v1veTaU8L9A+70BK=R!_3U=F%#%iC9Zf&3h+zy8d}IR%m+& z@)=)Vy^yD5IZsDKisu>Ar#q{dt`AnkJ{c#|tXy5+!Dkt9P`e<4V=evd(K8?+4Suky zQ@(#h{O!XK4#9C`;7<&r~V?4wTNQu!HbXWyV6(U+Q$E>Dy+JtUgR?(0v=@zcycf{nMRH!wiM(Uv&Vi zqXjR`_U7T6UI?4yUW+rR05naNI*7*ri7{S=mji9z6oUk%>AY=gc4lVzYL7X98CmaH z6lpMe(bxrEYmpg7Do#FUUH|#vAz~%5W_7NYI8<2*ht{br2G@Bmqd0&MjLcH;wCv2= z=v%FcaYQ8i>LZN~T;_iGK~v*Tl&t?QC;tg9`WN>t{tkkF7X(yCXYck(hGI@`uEJmk zzv{hjSVi3VDaa6~87=r3V#P2uw--n2xKVT2g|ePUp@!e+V87$GJPB!%X79fJJo4-9 zsde|5=jOwx@4T`JLoMX^n9gjoLeLRj5Y7IX33Ln%yR^lsV+=UY-B7EsrA{CS>CwEz z$==09mwG}!gMQyM*YFhMoA1dPc*?H|_mOlR-tKqIW9E{~E+`Pk?^4a8H#n770W>32 zRerfeibTZYva%co%iP21Sw+RfaBKaJP==OJe2|vHW>1(fU;-Dvim$oZ_?%tXct5vn(JFoU#7p!3Z4LO}*{5NzA7|#};j06DcPV)zl}1-c zNqFla)4E}d%kR1G_CHh+{#&A;|AWawH)wZACbU$?b4cs^SzC)TaB*?XC2Ia;(>?Lj z7q$juld*;0$AUy<8?oBZieFcF+7|h3IR2{K;xmAve<2?JIQf@*{pQNHOmZN7= z^79w7-sf(vmEwXv8%``(oqmTqefl^k7%(Pw2US#Q>o2z_RK*x%#YbmNPWl}^Ew6i` zy+Zf&v)T%k_073FstM*Sx+}oH&#S3uv4INA4PF;jSjx2+IM4;h?}fa}9?`(rjadC1wBP^UCZi7}xr$SJ>FWeDvI#AMNkZDwT z+?sdm2b5Dh1YUoCKW2NB1H>!yBD>4zne+q~&I@+>H9}OwPWnqwvmJV-5KEqiHFKOX z{q^~f-XC023m;WaojPTL30jS<6 z0yAD+{R?1lJ=AKqF4sX2)29zBvkeE4hVWa%BwhH{_>NoS^Hacn$4TsdbP9UQ2%04PDg_F_YxdFcWa>0D?2C{^rE(K^_;3>mpXFDy8HzL!hB74IVZcS@lgk4|1 z-^|n@1Hu@w&uq(db3>@J0@vK7gJ{2_vcDEsShZVd4~OE?R{>-ilUUWScGcKx9$M(k z@^ZiLSyy)N@Tmv;w%F6Ksl@9{LeDoXF_DGwhlrnUjEfc;0jrSnP4d>V1Ieqsc>lSa z-S!L?6cF#JTjFs}l9ez63(o-ri)~A9zv+ifNBi~+Ih(@>J5_#5ekU9-Mr7$Zx1S$X zqkMqBgCmSg%P}wYnKea36wifpLYF^Swl>`%P`bD_;96Ril9>ru3D(`iYYT!<&hZutMW@AFqm+LT{r}DLX{I+uie3}0 z27z{T>;=!QL)LuQ)SzRA9jU?gybU}z7 zo4}DLNxvhJ3%%yGmkm5Z!L_1GA@*f9&>N09=H$pMj6bijP5UEbzw|?;9qv`Wz_mVG zc%}L`;{|q-+W(DC;BhmG6+zTXKbdq+j=VJ6)05~P&Pki1bbOVM8vImYLGs>dRPDKa z`;St$9kwl!%lvj_2|(6C@-%2o@&yg_p(N*Ze0qOF*JDy~V9`=r=La#L1to-=sV0g+ zcy~k%k3}6je`{lDqC6@?@#{_!Gy}-^??rqJxQXt3#hZ3WBV!e>b4e~3hYP@Y)ic|F zz9P!HM_>BU)+HMQG{niw(nK>haH$ah@^P9h$tC zkQTl}-hNyxpj|2(JkmQi*0H=XYp4VZpL3*#J=l!Y4EN%K9EFuY%WfdtlVwjeJP`5Wp8M zTre^+O7!kAgN_*np3jYUa+}&DiyA=sECnjLIMzU#>6&7wsj^PCGh-R!-5KFEKrc_V zDc;GW(i!mKa1^ofq9QNI_5-D^#9#ccqfsmEsu|ee%`ghfF_iy`Sja~6nqqBE>9Bw8 zNYF|uFUr48Rnu?eE=PS7Z^(5TV_1NR2@c=jUXb#B6Gw59Gh_R_zBp!xrdq@Y0-ZIJ z)M%}m!FToK*cZjeKy_cql!nCHqYqD=!c~j;f~Bsze7G2FcOu1a0jdC1`W%29jVX4x zBFB3Z(pAp(quK1jR@p2H!>?QP(}^EdexCOB zGtcO(=#$k3#ry97LCh}TM0`!P^<72rLeoSZxaZfMQc0+*c6JlM1^Ma-T21kT6GzG)Lsi;3ov_aY;2&v=o^-@frUQA z4WNFw={JuRwntb?H~4gqcwOOMEhOAjjxDvSy9dJL0=Uf#H6`JCCx}uSl^;OQ4_bYX z0VRJljBUn0;C->pja;qvr=Mn`o&UvBmsm8Pj2w8XjqS^5m(J zSL_Bpi7}juXO}I`4Ex=8Pwa4)3nI=_hz^B44sGJe#aO>vxAMqkMMXsw6&0101Gw{5 zAr$ESvs43_d(1~~3KVtq&m(R|#>P(qvy^^bF*17aHS5ZIkOHRqYl6v}-Q7k9+>P&9 zdinSSZ!D>+b#`@W+QxsJHelix6?Gvk4CNB+?Wy|zp=YzR4v-+pCr>ib3g_HNxEaRh z13r#nhHhq5FIg^pQY+%lFAOy7a$H+?zXzd^84mfo!uyn5IzAzVmE#4_!kJm}@j z$+;x|rQ|{O)nc^T?Cfk{4Xca2{bl+c=V7L8?^#)#*Gy-7yMC!?F&jJ*R^CrMCYqsf zkFw_bAA)9l51jEeLuM}Tuo&i8m@1j#=V@MNV{dbnr-xwlz09 zIypJHxbQTd48y6wgg0$$nCDxXo8`P`jW8GtxbC-ZrN=J63s8CU<_*XJ+W-+b#4H1M zwq-;_TA-BZ2&Q&Ob4Jq_bwY>T@UUpO7_E2v;9%9w#)D#0{APTn_Ur?&8~Jycpev(H zpIb3-{nw9t>pIl#X6S2!y>#MvV&Z(hF9_r(mc|-b-+$*kbm&lf9F0Kg4fCDftfg8t z9)B6F<}>2me8Q_33{ni32e}q9GBQ(bSkg{g7_Rw7{=2^~K zu6|jACK0OD2gORnyritewXa|TT1!sc$T!^{==_ZVQOx$a_v){5wu?s?j88K0Aui~h zP!3=nfoz#${GN0!Gc(h{P&!9VL*voc>v}nEC7SB$_Ums#d7&p6@GQa8G&s1Xzt!|h z$&d??K;SMbA8oe|fPUO?Z*~q2URkfN4#hQr8=X_1Lvbo1w2R(Jq<_qH^^0WVo?j}< zCl40UjexfkINXD~)xzn_q_Wymo|;-`O@uR3|9t)I=lXgF>V(OPAvKP@qS!hQPtPkx za#)Y9j*e%qUQJ8tKrregN_P;EcOxQnl4QR-N#guhn~2ef)FyBK{qx?^$7dVu6*%@Z z?)mgPf_f+yFm}r3Y|t`9f;om8-lnD5Z@rn#WQUkpSr=)7P9L?CNF?&a36+6fx_iQM za$8Vu6z*S2mN(;;#(wSW@0b0+XOu5;0$x|{#_aAF!t(NgCxvJ<^w4Ousi~=+UX&-^ z!UPTig+hr(>>d@Pj#KoR6wi3Eq7)GZDc9lS>l`hutw)|ECntlR+nS6T$SI{}8mOx5 z>knyMAWMR;SoAtdDo%%=pC5$DTZMkmIO9_Ndx^ERHEQ7t(a7A~{PN{MZW;`Rg~|q^835h$Y{s#Nj~AMXMQSn~u1%8e~L7M1VOJ z6C2Aa|M0;D35iUsUt6M#VWHpNtLFJP?mm#e{p%-Geiw`1KSW1I2i2d2jYmgAxHG+pWx$NI11Pm60wHw@W*Me zw)G#60*A{bv|^JL0@l7cS6vkVx7c0smW|EBi`TAQGdE9|`w7BxTikg~H3I{KV9E|E zD}>?fL0*MG1}3IM&j8Ytmn5{@O6@p(0%~L~A&OVgnCW#|+Lz*_n_<@_vVWBHIXQ%t z*&KOJ=k=zf#JKvQgPq+kX}+_NjNSBynQEJw&=S`nedof_5@t2p-oAYsEu;rVAb^xJ zn3`+M3cd^1lqOm1+FVNCi~UwtR|iffz+PWS{h;M$xza5!FAvr0VHGUylA%2~F%lHq z*%mJ^uazD0)_ds45*B9Vkw418k+Bc@$%HirGtCK3q(x)kmD);LaA#+XX zdg<;9ANd%zH&xN``eAP`uXlRRLuV{1x>p^QzE~?yyGe^;YUbT}$KjAcjHdsUN3-3H z$KwDhgq=%_kKcq4EBzEc;Xx0F>NuT`GF6`DGgIQ-7G>a$7d&9CrPcWH%f3@my90@A zv?jtKc89L4c=fKqZbfoQfkEGMtMJ(Vd!IjlwrPHu1g!;K>6d8YB+gzvAt1oS#56WG z<}8^|H}W7d686jmw0`jSKVHgJJ1HcjnR8%OIq!ye9H5cf+S>Xj+>RGG$3{oN!8Ov? z2MM0eh2c}koln={Pd1!=e0+R;ONU&d9z6K^?b{hqQH7A5z`(%mkBd-*9r&ejgZk90 z2ipb(vRG+wtsb64=*Ep3-3N~<23IxE&|EyRuR#%W7x)a&fV&pd?rVfn#%U@Y`1>WgmJu>pZV zh@Lrp!UTa>`yPQ%A*0Lcjm1joJU_s+)XX@p7Z>=I0{oOFmKQtSLq* zF=+AjaLIGEPH&32&F;uEu&jR~DeY_EXX}x*@(9Gy^P!tzWqXc^AP}1ga%&L?5zJ=T z#M-|^Rv{3fzu$!?kF7tBK!m*h4?cdOwSCPkJAZ%w%Q~>O8=;N%2jh#1m3}O)kwLzE%b#DvjcsRu)K)k=4J3*BN5IyBTgk=(d( zW13-nz(h(k@p2jCp+Z7ezVp{kGLJ5=cfZeX_{p>dl~^{@&@ou|Y*(5=tm?Ja*J+9P zfG(}oiWo^vO)f_*+#BwLiajd0!_e3q<8Q+Sx@ff3m~7j)-R7L7zrlFf+@tDkADRu0tTk z!*42!VEsp55KJOubd*VRReC<##KmpA+b^I}qOtfA`bmgCo;!t2Bk0aQG?J?DZ6Kh! zCESQm*Ed!-mdII``M6=6$6Mbh#NTTB9@wHmjU%){A~0qtl!l!zUc8{w>8O-vyYyu$ ze80Uj77`Ld{bddX4*{PsJw*weEhn@MR^GAd)3UF7N@(M8*+uUC0dMVMBsAJIS5{Wm z2#aN9Wb}~yy{10V`bzSeZpX&N^k|PUuU)?$z(xKzKtEItz}I2CI$rdHd^f{6I66ja;7liwGcOe_R1_q&8@W=C+g(5a8sF} zd8V1GAt@N)UZo>%2`0|Y&c@C} z&T~pPoNr#sroQq(->|^gB3aJ0%3b?@Y`RVQvMMP@`0JXHtcC{8NaYfuzH4+L$m{yvk*mS%*>hTE%FdH6oad% z9P%KQP_feFkxHvfHxzoH~<9;d3dnhoNH}yHn`i z-$U~3$#;g{Xn^Vun982&$Zm9Zb#;w9;?hwzTM-)_?OQADE0u_bFFESoP%Rgyi(^sI z{1rl5yzhX8r6ucCOVF5|EW1lc!uq`zwHX?e_T0xc52VNtxP4ZIuHCsQB{HTMxOyUV zS=Y{-Ipg3k`p!7H8O`S`EG(EB>Cm6)%bY>s*u9hlbU8um>7#sL;laEQ?5!(xFF6HbL{%@Ll;{&)@~(r4K`-#b&tFaw=GpNhiagWV{+s zX`d6({9X#r$0-~MF%lh-UeGO%GqJK_a~507&CQpmdwr|!uHSX)v3jZZ0PMa!(|oqS ztSBps7MaMgZ%NS6vM13L;>Vh?R}2gcaJX{n=GB6{Y8cVDE66JqHikWV)WaVIC`KXq zFFs>1Cfi;9`TIBN1H0kQFCru#D|YE5qE{l({+#(**GPIueI*D$p@s6m!BP)Oh4a@`2bUWkLsoTSgSlNF>`XDSs&1vM$xLkE zbb${s&%M9YFz$B*;&p5zFi14(OGK0kHo+tY@Ed1kadBb61k)I;LSAT40$v>0xUY!A z>Lk0jXm-nyCQ@T{`71556-5A6q&1HSxNoG_v6uDsGZpL^LfbtF8)o?|PQ?mH+*#$4 zk%YjR6~ML})>Mv)RUvJmQN_b6oj%o>Mo=bm78p{1n>QOY_a9`z1Lgwdpkm=g&epA* z9Gi0Zstp@AnqoFeD7$*a11$X3(UD3x6)x4S5ea(4Ee{QeyDd7)){N>jU3$8n4}H3K z`T1F84d%;>0DSGSk9Qo&&=Ur2Mg7=F-@fEo(xM^8dGO=yHS0F12hINTa7*+)tBc0Q z&+6@CW_P<8GeqygD|Ia`iE17LE;;3lfxy{#?+%OMnkTUb>}uZIe$sTt0}`9rNe#UL ze?+D160-6M1i7Hlt=DpIjbpbQU|?-P>%O$EXZ^)js~-{C`bxa`Gqb#z4l55g9Tb36 zLswXJAcJ-W^@2diFD~*AbaQi?I`*>MVF{S>YX1VNK~z#TXjqa` z%;<43LUWhGUr9oql+~BW?NwGbL>*C8Ei5j2^G2SX^zPj|y0=Wg_!}Tic!kS#GD+Jefyet z(yO1w-lPf(BZPZdj$e2L6AbXAy^2q65@(j=tSf?6%9jUv$84A3Jm$WCGR2e!E*qk7 zz+d;tbOhPXon9uWN}}v)fuh`QrP)1VScczaP z1`0#!E^=d1MuuXF+4=LWEJ=~x!vRa<5I4wvsm7gxIQ-Df|z%M0tD}0kJ;BYvEHhEt`O5SaoIMziD<_nlRpIINNkS37F zE@oZwq_>;Pl9VFr?Gq)R>7;Ip0C5A$r(>y9Dw<8pgZ*lALTCk*kZ1Y9`yt7;oWq+V zZ@dGsMRdpEJt<3bpOCV-F5S5fP{Cm(1-2>eNocQJdqjD-Gr*7&xuwBc0Y>bJ3p@ zbOHq#;M5$%=Pu`2t=sg+Q=PG9ty$~$S1K!ofp{%qS#8lkO>F|4V{O;}kUU(t^&2iH zRaEe{Br^YjlDT;4(j^-kJSb2Vi_Kd6l|;S;XhmjbOP>$5NZo84e|f;}VvbF`i9o_& zOkQQsYtg)U+Jmp>614q+Qvvs6HhJI|p}jdAe1+$-%Ao@}K@EQR{0c`q@lzu6qpdxv zoSBt%PDX3h)67ENP$;+8Je6R$4{K}|U~C={+2)A~j|&vD#iSP(GwT%+fyj=5G$f&H z-NlhlNsIUCLGu^UMJwy7vMTQgqv_vFi-5*8yihXFy7UaUXnPS(UU0a!pYD4%{1BH; zD6g}{I0N@>(Ph&PwP@$r*FT4Rslc%fU+%YMElt27XmJJ~$l}%6eN}q8VWXl-sCNb@Eb7?CQg zsG$7<&zz}$y#0^~Mx}x|)RAo!F=_=c=$1>#A9q1(XZ9c4Z4h&7YnV0wQB(@d_GojL zJ8c5pFzM;(6XWiuV4S3WU}PxmvADQ6eq@)dGp{9?son~#k=9e7lydmbchzWgOqZj=%ta#l0jA}tz}U`*Igpf;v}(<|w**BcrHH9Z zu%41XC2}^)l<5RA?6CwOaDGQ&H~})hfW%EL%~HrsvjxDuky)lPhlMB!MB%6U2cT_?w?xJ;wZa<2GZ zTRS_uFyX_855FZmdi2N=>r@*qolR@9LA%ZqzbP97L59h^rDed@+0wOx>UF7CW;lb0 z!7Frn+BSw}c5!iWetv$YlLlT>Mm31Op7t;103p_zixrdBJj_li zEoIG>vzKRc($mkNM1i@jA)^Gx04xe<1g}9UC*Qvd#y*-q-jM(HtzfzWG`{(Jppv3u zuG(}Qj?pd6G!P_Lv>~!eK)a}Unp%A)B`*J9wZjw0FQoaTFlEgOJ$Pv3=@!OJ*A%f# zIVB%*T)_8orxegDXD}1PvV7)5TH=6Eq~N*xTjWJxw6Ej!gArBmdF&=h^4vWY`$Szd zuq~Lxk4>XF-;n~wz|9y&E5fR0)PIxF`T$i7^Pn^WWPJq?7zZ`ROh21V;qye*`sRQY zJdxJ&fzcTV4VMH{E{8@Fj42H557?bD7ZZhXQ@i0^Iqm0Y&L?zMc6Rx6VXva1VgOjB9`DKYG?|Hz9|VL{`3YS(WO;-1agR&@TRQ6#_n@G`6Hwm?CXE-<2Wy+Q1zez zO5(=W|DZ+X=e;BFaFmuqWI*~rAO^32$pB;}GqB!FOl}|l!~C*$dt1uc=)D#hz|tQYH%DGMC3Jt#TYci(CZ$wCwLJ=BFIL;EE=Q*1L4mbHVYads8`F-Afc|1?1EZ+ zVT(oRe%~X94_n`?|4Yf7_?bryS+xd+%P}||@5ygM8^uScMN{DvJ~M(3y1^-M5n<9n zb7V87Gjno`P;^@NBIt^v;ONkD3JTdmVbP})3}W(O#{`pO$Buzi<1^Fus^5FL-#2*L z1?$qXQ&QFS54e+*gth1Y+442jK#SqLDl~B9nSKScT18N(pVrwvh@19`lKXraO1}g; zg$X9lv8i-8T8wXnD-kZLLHa*B)BGjQp!pc$S+aoe%n3t&zWLl1)Js}0JL7Cs>4bktspgLXBK zdwP13MXJO!da1-s8qRQggAK(5lTIRWAoNYW;9S~$?&VXH9S7}C!{rb=1!|9iKm!B0 zNJWaog#o=kBRFI>n9r6*>l{UdiSKJjIL&8x@EL>Cphi!3=3p_-pmt1KKz6L4QovN= z)BFUm_f#g9 zdmWPw%^$SlYhLlSGJ$(j4#Sb_xr;(0toi%5T_%_&2a%5tp6gUbMMd$dv7GA4-WJWN ztckB_X#|0hXUsRG=xTqd_YXJCk4509S``1m+rk5Q_H?q%o8)GO#@Wqd?;v!VDYsY? zX%UiYGfywWbiF(95y&zftexAoZG(h3jWT$3aCEL5y08HX+)L!i4!-c3TQ6u2Ss9r` zO^#_ru0j_yMh2(x^2w7YG0tGziQm8L=q<1{@jvk?-eC6Hs&wmHx2}^v?L>G3e&;v{ z{76bW$bg>1HRU|klpD`ff3fyaVR3T`h-Vbs@-&4^PD;8;>-tcueekGUK|ukiWD|7? zU9>O()_bHxyoO7sZL0z=&n(=R^F!5w@V94nf-L|PITAGKa2YANC`tF?H!E~ND&or4 z%r_OJH7!3k?MuO_rQE97?v!7={P<9_AD7+|aWuy&UD&gwFm;u6j+nh2>R`WDyg%MYP19b~Vq;6x$KuvdaPCz#ofK+En1@1xcUX#TkFpPbahpf8QTC%ixTH82c`yoK22lmYLv%=nVe{%|Jg zgh@Ha({@f<2#4rxlGP=>d$&jW`&z3D7hZ7Ry|mM=ObD1v@0Nfp(2nv(sB6|zT`2`? zZNp>s+aAYEw3}mfIQUU8?Kq&j834>&aL*v=9cBXs8n76pY=K|kJNw!I=PC8k=%Go^ z1~DP|u&s%A{@&_5f8p=Q&`X|6U)~t%DhPde?Q`DK%S35U=$)&$5IM!rSdr~gr9L;Z z{@#;xtyg}T_h60uTO>_3+qs2$=pIFE*%gdjM8Xju%9$ME>ef0w?@h`+!x9kMt$+_RJo!8OPfmS0TABPUc-@KV? z$%nZO=*`DPpk8bWu3sq7J#gRvVD-a?mtextvnZwIv-j>Cz}Zq(flFsiO-;rc#LLWG z`r-cweVn|wYF~7tQG)h*c_}oWRLFzR>U!t0tfG5k@Tkc5PY;lw?q_Q8x$NcPlp5f1 zytb`~cSp3fr6lQ0reA@2r#pFWCuo+@+vH{i58MJ{O|c5QcjxYP zadYd32A*!3Hq%#Px>r0c91DI?*KbM}v)+lv#>TSQ?6R^lr56}5vA#J!PNUJLr^{hB z2QwK28&l4(SF7>Dn}$ zxp>~^{hx2=d_9L7f7^TQxn_^3v(vBg4&c+ZyJy+V$j$1{Duc zm+Y!~-PPfCcH0;3R~_we~mywFFSw_QK>HT*qcV+9x$jvU{JUpEj+6mCugVb zt{(VJoQZ8-h=#KcQ-+{0Xx)EGd$Ms@sW6cQi_>6w|I|NS@edz2w#tfss2tt=!Dgbn zW-azSq+BQ7e7AF-CyvsmPOl=%EpkD zIIL}|F=Fx_>49qSfc#b|L0_fP@>n~Oei(Cy-FT1Dorj=?RJewhpg)OZwZax#;}gTK zV~e4!(Ys<|17nwAmlxz0QWQ@*WXO1!Y;8(x)n1GQOxgJnfc?>n>5KSbjX_(|6Z$;= z!?fvoEot3F=^_@jxVm<60c-VwNDhLg%P{55M$+4O&K#OagQ|`&Ot77Vz;%iX*Wiz{glztX2I%KEQEK!Zxd9co zKh%Abt`kE1OSiMF2+qH&2sUPZb(DIwy_iq%n#s=1!tT-_bB|nEXcoLA`|0juC?iw& zcq9cCSM{t4g<)XC_jI>tyt9tRp-#~T_-1r zo>cDPtM%^rccGMR#=t@SfIvao(CJHUH~BN20(A!jA6Oq@Esr@?^~CM^G#h2-$_-vH zyggu6nponxo-^`S-PvvOim$u;A0rDUUEA{oSSTW0`y`Z_IfnGxLE{mDNG#*o_Sesa zoh&_rHkeXrW{TD{T*vl%_=vUnb2`%4yovtf82d}*xlqFS_zl$+s(Qfz_<TdZXR8i_(dC3jB_|rP5aAR?aJgqZN|O8MQJnmcwsi|SPwbQOfBL`7~E0_boOF-9pxA_Rw zRGTT`fFPcnoVlvFS5PzZgJ0Sk#Z=+^Uf1_ks7lC^h zIRm|rJpb1$w!O6;k&LAMS9e}@WiF-7Mk4?Y2N7K`$IMP1uNL>!Ney!PKPSj;d)C+Z z8%W)Nyeh$We)(QgsqY8YG^EQ~<_aKCn3;|Z$y8PgHBt5x_ncN%+1uYgT?s zI{5a`Rmq~Zl~><;Km2>H&PjAjV0)|B)!5ZS=vz*|T$k2`UB9g#qE%HRoB8%<2`=Z% z4L8DB-3*Ij4LO#KvSRdAUzM4CRjr&KM@814>O;z@0|8Dr@Iqn*$a7WJRam;dnhlGc z0Uo8N;Uo1_bKkvFqXwdiE4LPX`EUCikBJOr8Es^r+ShKxa(e6@9%^oHno=gD@rG44 z&fQ)Ax7}F07otr~6l!k%Z+vR33~YNx^{WTk8pq$?(~b0RTCSpsh&81sx+@d&Z8;_H z>B}(MfM5Osx89qO*W!Zs4SwR#)~c$5!u<7#vHpgf0^xH{PT^=O!r*O-^~vdxqlFPe zi93IsAC&#pycgc_AUZXVA!nB#*v`GD1do{>3+)b$WSc%Fi8Yv%U3aWNVZeK0?)}P0 z_KZB??0e0|ozv4o&}}4^#2wNamk5uyv zJ35Ogj9ZHfvY;xCwoSLM_We$QgMSy&tIbxKHf10jGh25qvLaf=I&hoXC!l3P&fM&{ zuj`xK-?Z!!D{fTTuh=!GDYJRm%b=%)#{6Ht;MPXcdJB% zT>ZpDr0J1nJAR1@#e3fQ5Lb}7!2M?qH@9F#$$XOTN?h*~P`+@$D&tP`y-Kb}%w#h& zlOAVDdw2V`r^hFb21k|+Zt)`{72U!m^mds;pR1F)dRz>oE1W#omt59TOMVw6!HEuu zj57H2mpW;fnfz0&Ei-8S*emifC6nNT>D#`M>=dN`;j#&EhTpeC0VA zw|n|9w4oyB!Y}WUw@_Vr;~ByFdLDGaUsZ< z!WS{IgeMWVW#(+6{z|V(+aZ>7c#sTsr9+8imZ_T7CiXMzRreaThn_r%^C%Epy)>hq z8lAZU`;_co9p(k|6BdelH}(94-DkNxWiG++4H=(6kc$|#&j{BMrqsO&!C&+>Jca$#9>SdTHuMHeY zt*MFgy~YBy%MZE<4!@{?^Ew zZZ#KqGg+%9(vE>Jc(k@b4~N4SQKxoB;pAH6(w=&YIJo^Cg)(jWpaoW?&UGrJ%4kv#}+e=fwG8JE@|%vC8;->dB)J5;Q2yfC!nJ$V%k?L9f|Xoz#2cxq$G*dY#&IW53wD zkXUl@9GZbK&O}nmvs~`N@uvi-V}oP+maLX_X^bnq`%i1C0HQ9)Kp+bitasbCM!ZgxoBC--h-j9D`Eu|N?WNU?ReVj z7hi%GWtdn}#)o%WYWb79?>tWlaM+HOF>tvwwcI9{sjwSeX+ZCCF--!AIHzZ~8J(``F3dJ#K>v z!W09e+p}6TGyR)!xe62=NI+9A_o>AhCq|~u3Pv3UF>h1^w72Tz z<6oGFHGo#3xdVBuNE?)+)3#b|7iAbY&*u)#4G-s6RIYAAkWxB=refIs#M0G3-I9t) z0LzPWH=n?Cc53J`eDLuCcas${BeGQZRlpUkn+Ri=k>VafLzU+>;sKR^29-0?lpMQT zZWM0ozE%*K#=K5!)+I zP3zp4o?;un7G$|xr#u^%CxW~bC8>S%P4Qi4CP!HWFuZ&KEcd9Ylyv}SmX!t(vV$nB zjY3s{7JP;7Vq!Yfi1HW*KH|q5sBkT2llk@Y8{q%xw7oqCmI%``5gulonu3Jq0Z4_QbkLeJLnHaeKoYgc+r8!E?EE1QN}Xq4u;G zZtBHfJc&_?t*B&xj@$r#B6PFsxEsPI53Tm@-Aul&2!7$yp*=1EnoD_O7#zR7!2t!$ zbfq{%;-(tqHRH75KJVPdrj9C@q_i+}R}d+xHbMIy7jv59~;U5g5|= zCmjbW^n#OVxgG3T+?xljtVf-CsuCG-Kzxg1tiyl0C z;)4v(@9L9&>YxTDo~r$G6w`lu8! zE6nYp-sZZk5?}?*7VI8+$~C}Zqn3VsOM3E1_S)9qua>{YX8I*J>O$4RER#`WvF%xv#W10PVwGz?-cTA7aLl)V;JCCJVwp*Omwf;nI^# z=uBg{8BV01eX;SoWcGX#-;NKsD^%S*I&%ro#Q^<%gUaO(!}70 zBQ!Y$QwI5V<4%It;jHx~>8=1o6pqZ?Om4KYi{PvmZC(7eiBsdA zK5gy}fI9-26^{#`=jD4kl5lzs4zDam8x`&2>b2cJ{s1r;GtI2w*}I6H3DipoYb6*Y z%CFwn{=!#4m(S6j5|IWXjr+cc9BPt#lZmcEx%NduOL_KZe*X--BUN7K94)oqkdMhu z`7z!kEmqZ(K6y2g!c8r1QEOnRio#IhTLEUK9%6L00L%^<5FOm!TDhE3g(`3IEH3M6 zZ;^#;>|Dgak?(3Nm)L5|>*$0c&fI7H{`&=I2|p?D*s>VDYzQnY>hH?yc@H0A`=WjH zYMz(2VrT#kNo#sw??}_Ur$Nl>D<$M7&OmxrJaVB^Ai&vUx0YKkvFIPl-0_(l>{g|h z(>VDB1qF^X&PFd@1ojwqb#&Z+_F>qu=}a@#a>pcS-s*VXpOWI)htGdL*z+f=s;ctL zI4yp>c`GVO^_7F;F+e%npM<|(T}<##P>{IUaax6*82INF54UTNA<0oQBDhsIQo7|m+ZP$eFDa0Hpk!ttm%;Am z1u{cr_HZJxuEpJhqoX>F!jKT$an-bEc(vHW&!@FtD zMo+&IDMc|}ZZeepI&rIJg(7o6MP1!>F_ed5pT}m>yb7=UXKV1iro$0+^-446rAR3b z4vu=Q?TS&Y$%zTZwZ3$rMABMIkNL$(t?7pJJZ*4R@|u%3b`*_rd(8KdX-`aa!|{0z z4Y3rKW#h?mPO8Vmyw!J=65W5pc~TTt+gF#{XWLEMSS32merrQH1cKGJE4_ht>Dv}} zO^X^(t@pGQFD={m;fep2Ul`P?>o{#c%IdKjT-KTCf9Ds7Ey1BS`f!U7*|NB6#rvHB zo7U&PO$dUWfHDPEO=De`)oh zLQP@Fx#w+S%Ix5M0}En^d1AQV{h}-}Rps5iAS(j| zg9$j0bm@)23VR;GCIe6ZcQE*QBl~;0t<0#8f?8ZvH6HP6(}7j9)^4`ZT{+)=FzW@V zm5GH#=yYykV#1h<(I+=I_juzKF)=ZqJey|wF7LLF$+IRg(H58|+Aama zuYS~CT3I1D{ow5Ee0X?hQFYcLd;rXt&!l)}X69``>OTOe589dK%q;@RuX=}_1Sx`B zi6kB{O#VOs1G;&1u($OqLSS!;pTd*tG&ts#5dRn|HBQkm`$04bE@}Vh=*po>k0ED1 z;rk9yKL*;z^73*kUM2w?JI24*I@;Q)2;GytzfG5iMZ^;Eg3fzi*!3nRCwVNU#)gJ$ zuP%ZkEJ!s)e5{DCw{oRma6(K>b@c{3wpV=we|MuZPsILUR0NTfhn0> z=~r<6_ zl2G6^XpdN5TLT33%mslt|BGq8Wh^yf`36^VTzB$!(t7g2+h(Peq`1r}6B9Fr! zo>@1r&q-Ld1U)a^tcTIQx979myd_Q(dG~7SY^!b?y$?TxlK)}Y&{=cVmyyeU_if7W z+xWOl9Uf>UD&6nd7=mmDX+I8qWq2t_!E+zCzAgf5*Xg{Y@-F?{?Y5@6(!U>ryH;== zAJg9-ws>D7;NKjXlEMOb@W({h@jZtA&DQnvcvJ&#@(~o{$Gz{_uD4uGO--NBnVG%4 zJ=hJbo+n)&kxomtd|)7_pKgw-$)4_B>@*Xk&W(RW9*--@C@qQjA8l0~RUCnXifQUS zTg##~HZ|c#WPrFp43fbItG$(Awy179D)OBilMIqESCff^lQdK|C)yp0ed*VHajUL1 zfAWSHmg*bR7=_FMUMqY3Up}{`s(#)8E?4WW3` zue2t9f5?EW%2hPZkM?fLeb2v!+3{d7*wmN~iT9to9HjMyJ>+|XH2@58Xo%J)_uDtp zFHCChcsh7o-o1P0>3J17`&AB50b9=QajY$96cAeg{m97k+HcA*e$0ANgXDGCP@xuo z^{Oikti&;2vTV-K6QAO7Gg?UyHJQ!SpOoFAbhbJ_-o5=YaeKL|2PfnQ&Af9bx0U^Dn=sQiZ9Z0rpti z>~amq3&Huy1%yZq`#(xj6!mM_i9QIh9Rul8cu(hmXU$1*d5Klxw7WoS`e#+jR&Gwc zXiMJ=0m%+zQc|c{r@e&-9mNbbm9_QmX4NcU3!I!EE-Id7gR zD{qAE-cl#mlIdZ8&#e?0T6KCzhmnAtl^rWGMs%3^hKVdw7{yaWD{%F>->AP?+ z)5T8^IBwdVg^_b$Ko8}ZC_HzP8wAwPV8BO}_nBylnx6=}Cso)J?B-PW4^!3FMfH2X z*6a6v>O!R zIZaKoe{D)O(fu@}r2J>M`?|XHCU4_1-hNH@R}#w?K@$9T+Hv;cq|Z}JQ}g*wK&L*b zu*dlkaFEREm2M6<1~)b~@W{BQ+>fUD`1m5FvxV}{3UN9Qp1VQ>kNi1vK7sfPs9-X!|FQ4TX2H-@wwY@3O#f=3WUrf}F|1DHFNjkj=m9rA(ge-ImmJ}9_ zY(|6lOOcf{*w!5nO1n#h4CP%#Jui!YT@JlB-q_x`G%$^Z4Uz7luRN{C;k+n|;mse2 z(~AUtg0mwCDi1^EVo;LreSbdn2n5x}L97oihWs$$m_V8dJN+M6DFAHYPyp|A9TnSV z(R5uI!dL!KnG*GIb?3M24Tuy3uqo5Ok^#xhoQe20^Oh`r038Yhc(OpVvH1E0Y+w0l zhpIzBs78YRay`8t*ihP_3fnQEFEZDnX!}Dn`3;C`>rm6Ygtve@L@#3u{ai#hC?}08~+R& z>Zij_R|917Gmr<84r0-E5+*wbV-7&(Dg%ISp)CzM&>vjkUxRrI>Zbx_H;r|CZ$i>3 z1wC&6KsVunb(5zCQV>KwJ~Tov076}{aPZJ|lJD6Kuch7NUoykDAY%ew`2y0qn;<6h zY8RH3V9L!%Sy&)RE4T*SWu(N=u zvD^=t`%?Mt)jUKsKFIv|KZOpkl}h77;f`%(sUL5E6~+TKX*dMK(wePVQpE#(Vu0^YPT``ED}@+{$Z^k8w=u`^ydNS^=v< zM4`nyF0}N^anWr^Y`IePuS^H9DGFjF?Khi^EB-PW*h&Myd}*g>(80{tZ7J&Eup(L3 zMCAl{)8?i$e>k20n~58Aok)Ve#rLN15cIV3kW2tHTbeGWg!5|9fP`$N69%-3<}3eJ z!=Z~7r%k0M9s%_Z^BBhU6||HcoKIv3sfcR6v_8*fh@ z>zT2v@A^k)+L|*ANVW^C#8#cY&-MHg`^qPhgpr~8S0p)Qu%MjPQUzxMP4dJIUHPCS`h#&r*p!+rYcrD`#XNab>J1hgnD*HoCsR|C z;R4>kVMb-;xMx2cApe^ZWL{!x&UR$G2YWQ z*;iEUpnK1EKd9Q31hbIkVCYdG2RY9Ij;!a%n@3ZxHIhs6yz$JSjLJwtvvC2mr2JKI>JT15(8zUIDc*vJ4Wx zb|=38uP&0IBI6gFZ)5RAjU$`t?RD6I?;8{@ZyeOTv2yw;zBy`B=i8g0H>b>mSzU$Zga*Hc}*|` z<=UyT-dANy?`Quy*2(f6ki0;gg2V#MuZGgPs`hL}K}}Vr@cpnh;t_QyjeEB`_Yj@G zvTDP8U3g=+C(lZ0#k!pekf2EF;R=vt13BvTx(UGlwk%kWTSM=$j*$ZZ?U9kydX}B; z?3hiiw39HAYOm^!FaVk;9q~_5n{5xIckWejySh<>38hl_S9{*1>V6E;Fszg@SAW*N zHkX;hxrPWe2A|ryL2V#xJ2=R0n}LFZ(fWPm=}_Q6vD~saJ0JT5mSx3AMV}rGqEeE_ zI{XVLe!x5z=h0IE%b`c4tBFcK)Dn@RwR(s`xVci3l^jfeKb3xvx(tZwJs*^;qC zz#oC5^ekm&*lJR{s_HuV>qSHeC|pe?*IBYU_xW594nopm)WfA#Tquw(7Owm!&(-$K z3cBACl+dewSsL@o5Q3&N5FeDO2;214A=Zl>QR+#aqP;`C$Rzlcf%d9 z_xS~!;g3a}D~CfJxHE5+|J15x;y`K6L`df2L#YaP84?Vybd)e9IkuFlH8_?)CJD~5 zH^JF<;3L!8EUunTs>5i7>Lcu^{p}CgmBBkLP9Ma?0z{FJmxBVqa=hzi`B6gXH>A^?d-t z;P(G!zXcs14|@22!y@V-b^yec4l*VFw<@*Jj@NP5BToy6Vv+<(IyD$|L;`aG5boQQ zU1GcvSd;6A))?{Ea~VRp906YON|yp9*9<^}LW}ODAFtA3!26%s{B80~iPIFY2Ta;R{3PTSEE*2`_=%k$PO%D1Cn@g4NBKF2cFa{KO0B{97w-F4$7Q3W5 znI8&YAN}8>m?kk|rbMuyei)K#3fGM3zZU~z3;>Y?=}8D^>K?%3LCGT$GDc`#=nOV$ zE8+9XU`=AdhMLnhiXE?xMnHZOJVx)>FhC;F9PFo#*Hvx?FH2yvei9w@Fixp#`Y9x` z$lyb2-PK)MYL*Cpa|cu61SO$_oe55{f=t8*pH}1Jt@;nWn$UacDYgoI8PV+PvmZD_ z0dQW9GvPqJS_ZPG1!aD)zYyU7fZ^{JPCldUAZ(Y!oDV*4YipUa?_GegU;r&!&c9Cj z)Tw&sedeku4!yPzQG%Tlw^wm2(-o$1eJgBZTC(Lhy~E~`jh3v=r3GKZXPl}o4OgUV=+S+(dCPM$!jP1 zCNB-aqFS1jm$&BB2lRHJL*khOfT~Oua4ghr@>m=E3W7esj3SWr2ZOJ`$Y1M@DOyi{ zp9kl73>?{I(siL$Gj^4uu^UNlK=+Y(mpw<5vzI79C6nFXB^$Qwd(I<&4<@WY&u|5e zxf8XW=6!>Lu&G<*JWq#~#9u!Fi#TvTQ1-hFmMIZ;l*Ut@{c?(%hA|e@89V4}HCm{7 zG-V4$cbs~4lDbH~KVe#Qn_4oQ;<@MLc_w9FM@Kbk!qgXGI$F57x+-lqOr+0EN}!l#f`97|Y^Ao7A{G-V9i`zq=u_qT#T=U6ibt-0t@rNM&D6Bab&N zJzd+w$lvD3y051DhdIiqtE)RYRv~l&p_A(FaC)#7lz~N!+MZ3VPI|&Jt?PFFFVGh3 zUT;X`cV}Pm`Q^k5B|ZoENQ`(afiq8LS-*R{7@m`pBYbtfZ@6!5`Onzc`2MlPix-_n zsTC?rfFeZ(oSvSd|5d~Qc30-RxE$UIvf$7gX?v~Hx1(}}Rs)zfpxW4=Gel*1`FU5< zc`#xDjHaNlQ0Qmm#l^+VrVfx6Iq(Vz2|=MyfRwp=B_6lFbkjIAG?f1N;}~~y4arzS zHy3pyCJN!*NWg*+1~LQ@3XezrSOaY9HQ}A~p7z09Hy{f!FORZr$vu5}70&0Jz7^KC zMJMk4&)(6|wLz95YLXla9hn|6Q`sx|Pr3$qKfE1`vaPqbH@~RSr8DXg zz0lb95y3ePGqZXBO-zcT6E}K~C+pAjN}rZ839C*o;N@TTp+VmKYcWg` zcit%*&DzKocBc6fIM7J}dZvA`L?z@1*YDvri*y{|w&;aVI`{r|1qTPGIxPf7Q@Aa? zdC5RTdf){(PoH8HCVCI@@OIlzMz`7sZY9TjcQ2q60FtVlhAXG`7F~7;1tJN) zpZc0$q__m6xR}vT{tCIJIppkZ{g&apoZC~FQVtz5sG2-GJJVzt-8H1UVZ_AD-19%` z;P3Xhd~ep1%s?iFK*=yYvRlbQ{KbR>5mk&KcN89CY)drVCkUrzKm~!G4cApC)QaYDN4h_e5rno3ZMYP`wZ*QJw3;s=YN4G?U zj!;M80UZ)hfs&b$nSc}IFUSVbZ{1c>2G`xArT17MQ$Z3V`pM4Dt~eK0mg@Fv@x$5A zfU)2Iv9(_{<6=sM;N3gk_Bg8hlm8Bf8YD!tOy(60Kp@+in0>Jmq+pEJ7?JIHI^eJrC=ZmgiCHB)NP70ayt*ryug zoIuJ=ZTx{!b6Nm6NLUIxT%4OfHjN&T|GV8Kiw@=dHsI_l`hB_gd2qpPIRFi^`lhH2 zNXk)7M@?<*S#rlIg|~0_%Tg~kIu^B02jeb*5fyh|tZ^_bWZ1O-&D=|%9RXrFca`<9 z;w4-!BJPq7>%*2`@y&y7?hP=u0utTaKz?i;&?}G?WDRT5T8(=2iiAmJXCat%YoelS z`zS6ZMibD@LpgGC7BU6#8XHL(8wba~EVs>F-Hp~otK=MLpkwi{X`Auf`ls#0iYo?K z)Gn^BClP4SoL!!t!h;&S(%kMlKi?M@6fiS07o?@lt+t!;H$45oAGf`o_Fy5TBp0_= z%cA!0`R^p>KQ%+I%J8IK-&ot++}zr7;C%>E1bc&`i7JYifz25lyd`v8cX~UmzDX`+ zhj+Zbs9U-_Y3BR*c+Ae!HrD4RI< z`D#z0!8N>Rhv*6O=(%)I{m}YOhH$ z7m5?eO|o^u%7Fx5H>YCEgp&;y3ldpSz+(Rl7y+Qoe<2a}_KLabwAf*-cceuEjYx*0o)ZK;yQ8aQEzrl-M+U1+LEC)ybF+u z0pM1;8t4a#fa(ii4G8xW63YaHv6GGo!TpeYUTTB(B7qc)+@Ncn5YW?ZZ*4{-qlrX; z-fPW_(7@Q1mjtLy1j}k7Uq6O4ogHkO*DPT93}Gmctkho28=TdoWA)z)XFV5kBt(NE zbb-?3{rDw5CN@Ow;vWdK3|aTFsp*c3N0>p7b9-de5rakp7sU0xu-a$dcw;eJ3q*s` zh>#YC%AG#S|0;t}$ExlW{RQLz>_cyE`yx6W(#o^}93OnRcMOxLP-+^`>VSY5K z^h9t0N90<*!{0y+q7CVxzXULg`5z_F2@=5T)pwpiiVf!B7%0FxNkZE}HB_%d%;RHmE&pb^k0 zojfps5x$okJT`-IASrJG9N+(W6vI;2+CfIppEqy<$19+ql~$O3*%w?re``ss)ksl= z;}rt1z_70BNvkZ}9ky&LZ-cKO)`vwyRs#VV@I$Ma9W(F={m7BWqW<~iJVYn{I~Ue! zZ~Z^P|9$*1BcMxa1>kh5yl?x1QcKw|WQT-&kyv~{CEB0H0GmgO@1h@2HbGFB1hvmY zu!EfcPQ6B7^=T zU2N9e-yq}g17SPPeAGh@$7K-j9UyM}<+!3$wv3+k2%zJie>33_6g2iD5G)KKz@L32 zVVq>nVrZnhfR^ECT(Dn$AigN2TpaFShdPjK7&3s!W|~g| zBv0WlRr7jZc^>Zr8WnXP128v0l*W9d$zj7{N{IID858H`yWqA-<_%5|i}Hgu)o_EH z07VPm4!L#1Y61-3!?CC3JcR4IS9uu-n!kW3)Yf=*IW^BDbt5;h%i`qlUVEJWILxj< zIUtLxsQ>JNM~T(L#Jgx86qd?ikMKLm?)v>TAX}4AmGMhux-Z}<^ARvVvby3Hr<6sB zT!M)uVBEw0$bex34hG?Bx8cz~vch6D>WFXIafZ)9C4yUIKyaN5Yes`;8XdNFDBUe& z5(1AHBWy_Io`7D^>t};22%r~60hZReKL9DrsDaw9uc<5SVg+#;wU0FC1Bx#^Q7@*! zF-4xqBJUsRyw=B*V$-_n2D%sU`{7w?lN&x@fg!y2K8SBRRrjyfZ8MEx>O3m<-owgI z{4}W`8WK5{ljRK?oU-a0P(M00wW8tWmvf*_hOetMds_fT(fvtR>2oWS!(qZ4nB02b zA&-?V1e~Te)5D{g#xNkBoSdQjOfL1wE?5C;9=-=MkbI8&%GDFZeYd+Mn|p>{TEwdw zvU9Kjb~k(H4}L|hnc~b-9=SSampoM?qg+Yvy@oEylV>d7b<&IVZXSoB45b_)0jRqmu&@MO?B(_(SEP?Lr`+ zFaM1nMF(yI0N#5cGq~+t^#&|_@$v!twH{j=cqg0$9m^3xGEC8BZ zx$LKYztl}x_6Hh&+#Tr@lvo$HU8h5Jv=D(wHcC-QyIhQsBxK$34eItxLsktPO@gCZM_j*5Ddb) zB>$S5Zn@h_bpbW)lgU3llFbK$-+>g1g*1}W>J=lnWXg$6eeg?Pep#^^`~qQk88 zevL3ctSQuAA%t&-=jqab`n6)W#ACnYS=)U%oA(bC)P989tKjL zJB!&fK%T5lT1VjQ_ChOR*q};=*;FhdZ02&<`wg2Nt?|LTyr+0R z*Ki?rl5t#KLu<>LE4Vf7ozrW;qpcWYtMEry`&-w&!fg}}>NwE_jk)0`i#9->d&j>n ztq#zSs?}cm*#$qDwCF93*L1M8sQucZ!)&7xTxRx2)|Aw=8Mu%kacXqT9EOa39cDWf zFq?QTBA#r7!R@|?c@;sDV1lGzf$z&%*+dJ!t(%pB0)V$aeknEoF6is6WhMHBn6k}f zvpVNDk$U|`?&-#KsJt5=q6gmd5Hv1<^u~_|nFur^23iB<$Q}QKqCd7<7~DydL^tohFtuapV8#y z!CzaJT+&Z?tDt*|KH#cj^t729IOn%(a)S&EWj}y3$%sVmL1f~8+9@ruevqabL<1a) zU>VcdPe;_2>2@4BJ+Z-f_mP(1!k&UNoFaree)iu;vyS0IT{U>@@fgLGovyO86!f~T zW#<8DB$Q?Z67>^C91K?+nHzfpC&H=<`>@u5cMo{{BMn9SEr9nxIfxD{i;Kci@#Tks zV{ii|yx`k({^)}&K+u8Ec2t&;;{g#kC?RMGlso0fWLjTqjh>wx-Ss~_^nWfiZXMOG z^UTxW0k|Bez# zfE;atR>Gf=dv3tlsk?&QC0eOiGIQOy6KGE2E_ORX*Js#$Q+);L3~=dJ)NrDp?01ug z)(OavfV*kx3X5BKJ_i2$&p`?lNa^8=Vu~@QRaTi)5L8*t3KG!&`F8<+bb<=pkP0oI z30J_cXLqQj#fFyZ;$`v3^u)c-$?M`AgEE|5rM*Snz&rTYp@TJ+#i5sjFm<>X05k)e z=<4hdEq<*#*?Jv_=qyeCt%3BG)LkT2*#O&PVZ9F~BhJlb^u&B28`R)kD@l<3kj-Fh z*NV}*+FM#s(HORKajZPpGTWR6`k;=*SIZn+68P(@pF##s9;^`Ywc~Zk=q29=)>kG8 zE=zyI4a)6(Rn+_HYM}+(hF~BS*x026%6JDC0#`R?_n#w;B5{^jTY}~H@g!tTRVxdI zO`i6YDlcWdTlvaK4p8v>4(m@CbGWJ@ejhy;B>$2-vmpYX9Ua$QM1mXQ0*Eb?e?z)4 z)kD1Yg^xhKk9Bh4Q8vEOEnSs>N5jHVkZl*tPTTX@f_*t#eQ$8cW{_F-DdlUh&YeG0 z?|G#IxCwau@T2de>-KfifF=P#s!kcOPF|wcckw~7|5yL|!MP`DOF$@y|BCY1$k0`8 zHe!Z4{V2?f0ekG{uW{Gsho1$SM(Sph9bFu4j9ABt--s(HintIU(CFx>eGe+f^<9%s z&uBgNTM>plom<_pNBci1J9~|cwCED`XU@RNgCDAwqM~5WU;ijzV}p3{`X}H`G5d3f zD&jju>7NCYG8Y+^U;omXECx3o7f?j$Adnr#j(5?iNrEe0)*xv>VEk7%ROVs+=awg5 zOR!(mzl^$*DLvA`E;Dy^UAG9A*CzzTCceon7xPm=&rZ>iFF!O4GdjO@!QsxqP9GET zd>+5EOGpNl!ZVH+nz`@7U%oMFWt8Ck9C+QEkLVcG&<}0NTh_S)b{T)(OnhKAuW*=X z5UoXsa^gLH=iOP+)R?m^8l%WXt;F+)+3v9!E!hgaLzXOys*f~s8BQN(N13B2g$AEPPQ5Gu$ z$YNcs=qK7wccKn+CK9?W(#vp>W#bp3)@?+Ik)KLWFw>bEBP0e2@y6c!v{~+*pc9x zy%$?sl*4c3R{{yfMt3)jGm@D@>Y~3sZx-fc32y%Tf<~!UI{DF{ez0P^?rUzvKxl^m zOhv}Mu8ic0wxe*a3wa$X6UkNHkHedEGeX11sPwkHHFkpD-}TPOZ*Le0`N1CZx#>sM zW5i(lz~K2SwQu*|sTUV6K4aIqYw-NclR$?i^6@*uw{&4o2-`#MnC!FRwz)tEJ9z{e zA`~m(q_%uh+qF;0Zo;>hP@`R)seM#k**wq9$zf!BWr^`j^8eF&L6y3#4WcDA|z6!OQ zY;*J)Uo@6x9fk{M-g)+whvclR7`8C_0AdpQrH4f}ZXdDAFHIW!;MZfjq)U}SNxQ8_ z{73wEe#JcDxDYhi6MQj6=hM9T6#9rRtN@AQL>USRjqHt*KQsTygwe{IJ=!s-N7PBG zTL1D}bg&*#)P3J9$6dK68Pl@TJ>7Gs%jteZ#j8UOKOOUw4^+ai{h~ILgqdSXXF8|bV&a6baC%=F@Cgh z)@jY&fx*J@6Sg!WFE6m?ymE_AWLAcR6;sx&F;V4t{3pjm=IL5*BXSv~6<6qUC5;Vu z{WQNf46SXf-N{${c6{s=BM^{mUJr_PhOepSDKN1HPvsSO3fi$VI%ZGTD+OeKQo(#38d zX22Gt`laN^M=|SW=vu)}W%RbIrL0WX$f*6bY;b&1_K>Om4L)<>7avrk)VTRxj~)d? zr^!{SzEWcXtAEyeh}#rBv<&12E~ueJW=jp8<=+ZcfFcOcXA&bcSD(fs^CWkh~ za^XJ$jc1gdQLK>$EOC!z@ABV)=3&=HL-K;NXru6KGE7a^>1jZawVAT=RMfAm6X)IN zA>Ec^2?5Ak>Jf2IXINr1`RJL6d6liD=27p&)}~RYG6CPx(1^W2+;={gi?KVFvuxaa zysgX-gca~rBV~DedPT@cP!nl%8$TB1umOHaOmIHeG(~^a3Vi?Y3FHlXu*kgnW`~v9 zw_giJs8dCs5Nj%BH95%aEhxMIP7^A_)AsnpC@g9}8zK{Bh)P}`e`9i7`CYH0YspQ0 zrlhHHC7G)so6r!m2fbwXKB_#`SHrDyQ-X6fgy{#JTc z2s-_#!p$~hLv!Cx2P=K`1nJzM<^7W?y7R!Lpl1m3zD$(Xl2d>9Ybp>nJW9=lF_rr`fPf zm5HQ4ne6UeT00ViiOl2Z=J|l&;J5jIkVd;V#cC28tw%k&on9lQ?)dR$%Rl?4@M6I( z-TS!Jn5%YrtEENU7ftyG=FPcu!jESZ5KT~z*mT|eLEF%#n3IJ|$imFpgCm(f=|7z} zDVWBra1&F>goSx7L)Y8B3;(&?ns3wViT#?hW32>L0BO0xQV z6qa;Z;n<@tr)6LYHnvjoV_v(9R9m9NKFrRt5>efk|SXwE*9hPqL&X?BF9E zaPslv*NA|vqy!J(E$ zGnLvt_=JpD%{Oe1tPL)wgQg~R){zkJk9u{8rsXH*P{=3&ekG~Km$>4y^!WCaFLkb&Jkv1= z-`^03y;(I-Nt#{;A!^}0MQE1C#^kasU1f_n!;$L?m_C{7)+FfBh=@bfzyH(~_^#2l zxw@>6>3BLzF$|CJOh*NkN6DBnrg7()t^W;ZKIp3kDw=gdPO#aj2NT4-)n52jJi271j?RejJgIvjcrML?(HBRabH3mh{ql;<(n2=r zs?X&@&h5-6&CxN@W~0ARQG;zmE0gg$CDG=_0;^u_RBh(E=CDiP>>p`*>~*uLJ*XwHRZvbn+LF9@zkOAn0HK15X$SpuW?;zW43>p9tz)3KzDyPjWom~Wzt#IVxED-IF`vfUbOGX5`~ zzB;VRW_x>sAe-KFHxklu;W z-q&mIJNnlQ>Y~ z%|MQvF%kYlJ?A60Lk)q4bM7!X@RL7JLOZkfCKH2E#=I?^dMZfp$=xo#{Md2os&P+# z#H?mvhZ+ORK6H3toqmztw*Bw)Hd>f89UkM?{4gs^;5fxu2E$d&`j~5slIRlD(88Fg zPrp(AnOBUyRt>b;{2gPLUb%RTRkh=|zfs$7$;J0gSkLsNjb}e^C7UGWOI9`xS*$EK z>w`=dLv|WxG&xdJf614;iKn{(*opyoqPt~an&AOIshY03E?R#4}42-C!2xc$R z$g$q)=w!YxBjgMzx<+|Br?32LG4=$KU}0?LM?YbLp4$08_x}UoRtN%|KWb0lNwnb6 zUtke1@xc@hKTsF?=j<#aJ)PHP_GJ2l{WwonTAIhrxn-8Z%*?~(f;|wYjN*v1XqLBv zO45Xc1h<3P)0vKksWpcmy}cS58Vrn#*o@ftaGWiQbbetzbzzv00NyEosXE^oZEbqq)bpcNOyIQ z{Fb~aMaFzymg-~$X<176Q{rQ{{geXzY05II<{WdtVB5?o)6& z^W(;2b6Z9E(UDzDA08D|g%T5|PGDFrD^dqe6!My?qHvw(g;kj3#Nwj2;pp<+_1V?o z0-wj9jrjQZvjrCXa3B-%MOiw7C7|u zPEva4ZbdFshGrNSmIY=VzD$vB_#+f1houng+NY&f=POYm_=G6I0%;5^105SCM>Kk; zq*~^+yX3r@N$jy@wY28DRXP-=3z)(UiL100-2?+~$Cr5+A`$;%1zHro!QyV}n&o?Wtk&Px$}-_K8V@@H6R3a%f0UdoE>`-!U&QdyZ_ zS5ecjQi|SvvaCsjYb_a0FGtF#LcjKhKJK}0{=2?SPyFCp=vzL@=W((7ulZf}@Wm}Q ze#SkCKFbvGxdGCcfx$t`biy!6Xs+!-Jq?_Y?Y;9F#dqLI>pVaYu%jceyuOoIVn4WB z`azN?@@ksg^=ijQ;BZ;gzQWg3^RSKk#bYfehdkq3=)I{I<`oB0na z4zqVjJW!wiO9*soTOz8}#x4aw4!U4PqDdy0KTM`I(HW1`EBxJ4tx-rUzn@?q?OByE z_~X)E$Cl{9^DE=e*fZDt3Obb_gu5SNw=fbnJ zv=m1i$Ur(OPYE=2#&5;6wMp>d<9QPXem;KPLI6r;&Dn0b( zbg%ZZn}a=26^913-+v9|`z%JEd$|2G8!x{&k|)b(F{`tke0|qUXes~H;@BP~PCzxC zUpJl;{1M=>pm^~nGh`-pr(Yx9b;i4DUbO5vj$*DgMfOQMQ!uo|;4JlNS1_;6`Fe2$ z{wE>k5QoxWbiYa0k-3v}JaCt}qu0qMUMvlQ5;!5Rft!cj_2>SD@70nUG*>2p;X*`3 zUte*ON1RE}%YQRhMMVW4EqLLuysQjUK@0Z2UX$#x=6I3gW$#b2<^9}LO}Cl*kBSs- zH46+yoxVZcDTN6gF88xZ`iV}p9)=5ZKfThbSm)Ij+Dhxa)Z%aYWu5FYGC?keAy#WB zBWTFV&>XF_)KmN6XR%vtUjLzm6Q9j@$rm!eF@Wos*g$^J3|UU5vM{$+!VA;`sTM&~ zLxkF{Z#~Gjmg{YoqnBz6oGk8#y8EgzOiK%F>b@F25tsfpoI*d6xMwbF)JG?@VfRPu zCtAh~+F&)9qP~}xpt!|UiFzA$x?D#)WOE=4*LxC z?-1^anSIw5k`UCq$3K_p*&WBl9F}#b9?D@*O&MQqz9bVZbIz7$O)Rm*O@HlEHsOEW zhBuv>mh8y;B!sqK(iw9MM=Yqjjq`a1>0-Wn)A*;Mf<4{zP%m4cZPfJ@<*e3a*L02I z@NlcSl~rS6uwBE#p{p!CZZUp{+*_^*DH3d@kha=lxG7?NE8bu=MmOisiQNqe-%@+u zWIGBT%Nv;#>4|cJU8&n<&h?UOlg1h32O}GE(PV=1KU3jfB5#Z9sVr12U+=x%^22;o zgBPS%stH<)_Ry0${?>`}4PdfE3kjX}T&G3~ek(RRHs%19=Xj}wh{hR|oO9^4HeQ`B zcVY6a2fy^X#_nMCW_U2iK>W^c_ z=l3|JFmsCn5&_FX1zvGB8I`d0q~DSSl8i*f^nZH@*Bo$bqYONC)EYAOoZ^Qy>?4va zs&VTWVuGN*sV+hb>1iA41Zz<^n|0VDK#8Ke_~XM?%p{&`4mWbe3EsMvYa}a&LULhJ zp=E(3sb#AQIUUh6rk?bGWX?m=vk9!gde1Zkl(|D%K?=3f;RTCRUhOcfxBe--hfXlR z`S&fJe(QOY=M9lz3GllTZmdv{#KzIf#M875ut3q0yIA{9j=k=;1JY{vcTu&$(aXk+xEZ8$Sg6hjRVFTkb1LL0R@m5UsCCo`oIJt`fSan)$<`^Rr zSlg!>3;kH35g1y^`3VtJsoCYN?ld?8K*cSd3q92&61PwZ`SYiB_OMQ;bPxkA+VG7` zcyaN(4D;S;e@QEUlgVe>H;sFyE$Ff8#*CKk%B-`6r2ltP>PL+DW+dRpQm5=Kfowc?`3%r&26f|(e8~IMh zOvBXg9nGFx?7wOxe$_l-=04qc*7)E=KaKS8oO&qOS*+3Za9+JsgCt4{u4HDm1%j=a z1_e2eq`evBQ_%V$PORr2yaWT z3$IWzW(LR--@23q2U!|FqoAFJhE4qYty|RY*jRsttuG6pX3T?m%OTJ5t^8GT_y|Z# z470D3Ws1|74J+lPSDKY_n+_#KV}^!T^t^0R8D&%k%PGtBg`QiA*?D`%YWfWm2M|6U z_pt|xEE~O2vY*#q`S`iLPXe=)-=^CAcvh|LEA?r|OeAF%`4>Jsm0~q|+|GKu@j%o5 z?DeCYil61(9asx^C|Ai(yDQHcvY_-|FsIsCx#U%1e5CUGuRHp*r#D!Q1MeOY?|%xJ z^PqN+@Jl%#xT>{=cxonMjx^-06f%g3)#h%!)LPgEfyu^P!>3;)Vy%QwKAM{kg)J?& zAn;ykc3}}`VrK_EAF{nbm~K-2z_;(?cX7*rcR4BO1+&AV?Qc%7jj=D^adHp+h?}HV zo3GT7&uMx3^9Rm+Kpz=OhFm1aPg$+ll#{Dxc~&i1`-=5`8WSoD!au4iW}*Y?Oc0L& zlK#Bd!s1Nam>@obq3~N~DzBg*A(2tPLV=pIjNKi;=%Je}P)|4AtLYkDfX$~5OHiq| z*7WkP)%hsu#h-zouG`dz=93WXAnZ_Z$%RUlmulZ8n5eqwSF2yai$^_x(X?e{Mz&<3 zUdAV_A|_tTt@K6C958vM?JTnBWI~KBV_F>ZiYyZ(MK#m>8u)u>ST$f2;#JhOTCC_q z?5rFdeVhjYD3tD-Nt({h0axxo(cHrsX*yR}Sco2z{;x4b0Bm4%6x+_|djw&`?V9|i zs0LQ$ZbA;vi_@vR3%*F%CL=W?>7|h^#;@5OtdC7^u2IP3{$al5t;UsEIovPSbYs3J zgq@-mH%nj!wa{cFgJq(_WoZ@!?3hLK9nAa0^C2Yo z-4E8IO~<3ozV7SrrdKq=f%uZy%PM2)w=}l@$s0KnOK*g$Z&S_wur#tpyLKIjA&ecl zCYy3%Fv^==;`tc~N#)`pQx3k6+!p!rF-J{Q^VJ`*D!cr#F#qr3<<$9>o^#cvo12@Y zQD*DCQ9k>97}B{)8=IR`)6?1fj=#I|e6XWQxEYwV5n=%I;ANqjHoR^uu;b5(F+3dI zVg3Fl{FJ!_mTekpXkn+YxR}}aG-3Z((0V4h_U09e95cc0MrDYWQa(oElk51!zeF4y zTB$@|jLUGui9^gxdPjan`W)_!dyTsIIoEoqYWKmU5~hi>&Q@OC?PPw_Od;r(C_F-r zi{hmGsQwUI{pLYL#YC}qb2STu>)iPgJFLoKxv)c;$e#L%Z5#<`7DFRI?Y``P=J5z9 zIk}=$PakviHvrST1HDVICDYzBvu~GX69w%J+B;Usg*Bstb19R$=x3_U~t2)Za@BH%p~Nb z)V6z6=Gw(}Cy^xktiSGV|0uj~pCR-@h9W-`LJhYtuc`Un0XOUz6Z_lUIA8XbQf+I6 z&Nkk+No8}i(kb$UX^hmz%;5?Jk+u9Nby39zH=6~pyTmycMZh!9{>uY zD0;u4c)Q*gqnN>qNprrHVJ~vCljjrT=Io45Ncg^NI+W6L=Pp<#^s}3Cn$oQ}a?H&B zOJa-{X>t`rzH#xYw)F%#Nf?(J1T={RMc&?amrIi`YX8J~%@`~3CbK_+<26A$P1tuVLs;K_UGp}L97=}hQ|KB?q4OvOR4E) zRC1NZc!aHfeI3u^5Ey;Q%j-Iv{?aE$4|I#l;ImI2+_Z1Im8t0ORrw~K&@{=3tcm|LlkAhGkljG zU$YRc2(ztUeFWG+*RgFYCmYmj9OKsK&2|O~>1Fn<3rdM(opbl0>ehD1%HyUH7H_KF zqDEVh-Pl4oC>r&;c$vph|B6xcGj$|qV$+c0jlG(M91%tqC~5T&Kb(3tHL4urMVJyg zoSO29$OYLDbep=o6W4cpqrAIv4O|d#?^A@bL3l)_yL%a%DP^tgXyuI zByDZskYpO!FejdH(1%Qs?BK_8s5t?B$fSjd=wb1`udnsRT5snCp`OSK$9vlZWBfpQ z^WZ>Eqe`ANq1)sJ!=;K_8Mwbviz!MRJ(9j|qgpBHeJ!hP*q9hZTv-bSTERT5Vf&rT zfj&`33-%qtk2s;-rxUUqWx6f(ZaJt`THYY0>bUze2&xi@eV;QyJ*38lvh;IqZcH*B z6_uqW{Tk`F(}F#$v>P?viD(Pwcgq&-!RP4dlxXv)C82RVlU5gSW5%)^Ey6OEaaDY2tVMPh}GTUz`QbZ7Nf z@^uMQBbjHe_*B~-dK|C{o{j#s*iW*W44s>`ak?lo(FI0p6Tq37_54lzT!@H(glx!P z!ZUlU?bmEiSgIIiwOfB{Cijla{c-l+ms_hM&kh!jn(M^3iM5zks)HPe_A1zQN=P09 zSr6akew5_+2RV3e27EQSQjwj;_(H1lin;EOBKl`iBBsuTZl6cr&;hIgWxRPAwE}m{P&E`(Yqwp%G_(LUgFbXP~kk7XgCN30Jf2$NOlX zaWJEpGcKlcxg3Y?W{0%u4G2}wzrF(+jDP^}#|C7kZC{R=WyP4->s3I8z^{I6af@nR z*M$#V7{4X=v~krFM`Az6eyyc6_#>w*v+*W0T^}WYR-$VFp!A~3PRdWdwrMKpI=P!3n^(nxM!ULcW34E*2*5#QJuwf6 z3+^}2KV7&9(!y>4qY}95ire7p5pU$}OdKW#6i~s)ZQs}Fx&4i9Euil^9N>UG#DqCt6?Q;Gl1Y-Ghz&PjL2_q z>SZb$kRZ91Ch_w*>9MBc;DquB7<|Hc%{n-%*#3IK>OT)fsJPCT-D?k5KtOx~b~W-U zng^h-t9C)gvy6O-jlKs^Us?o62sMjB(|Q1jNMAHihg{k4_bAfC1{SA|ak6f~S0PZy z+n$d8Bivk7e+U3Dp`Vwwu5)rmZfxpr(!YGT|FB94q5d2vvuAsyc-6EznT*yQqRRP> zvm{QKQO6|*4U~bvs4+}Ae3CEH;Ufqk=-^5GSNz<1_h_0H7P*DjPn%xdZ2;4n{GqnA z&BFM*ecH#Gsh#px;<|K>Go^caqH+4f5JQPB&C|cm*{J5d$3` z?yt!jk$vA3-Xb6P?q;(rfu7dg5fNsV{UNc#-GtUHqXGLRZ`u-gu-u>>fsMo2|NMj! zf9bM+gI5>n;>Ra?wn9t3U#14eA>CtOHKoS~JR*=F(8T4O70J59yr>kThvp{&sCnqJ zP2{G2L;}bVYAvmawQrshJNO1Wz(Vc}waqZ<|^rq$MT;j{9Cz!392wg_dh}*?&@gnfL8bK8kKi&Sj)aY&jCV1;1DLf1DY zWLNAj!5*nZ-p>BO_;*^{codll9C`j$*G4sPzGecTmDU6U*e{6Ur}CiMJZ-RAWBCM+zHyA!IP$7b<=x_Mf%d_llN=_1NK6j)fC_{q z{Ly-Rgl5=?u(Wcrj3LKgdo+p--Qjd`Vb2Z|FTRa21H-14ue_E_1>`SM*0`ASd>c6? z`>-N-d{E7^%N2fyMDRA~#mHO_wRhasiytrk%?9fKB1a5^25cD=VDO(=jyIauWXA{2 z_>YMYAclwWi|)~R>Q7PZWgt0B)=^`iu&2v_B)*yt99IlPd^q)vRg^+>-nvR{>oYL< zm|OGKc_^}>$rp-?|4bpol?O_J@ZV2jWUjwKPx$qp58C5zkGdB{?O#2C>PIe6J0n5- z4Tv=}#&EtA*qrv(!MLQ5v01&@Y21u6rW zGkg3NfBNS@Oh%woSrlC-#P0uq`<*cv-uWFO2_$0O-~?0eFr{1Pz6yh`v!O!#{fx+c zd-HGxo!SVXkWV%zUZSmFM5Lz+DoF9{AKQI2&K<}@ZDoOXBCtu}z?f!4kbz8$rscq^SJ!C=YqJGP8wPg#QiQx2%Y{w;AJ4zp_T z|ILu@l^c!Vyp0)u5itU!>ph?Y)|sx@gQ>mO_H1(Lz+t7E-a`AoH4Z=5S^p`|UR^si z@BxT9bBL3d)CcRRmUc{1&2iJ{tBk?VLSRoBG{S$q`e%y}5EwL@M6n7g^p6{??_vRq zh5U8?y!^}Z%84g69gBOIHi6$2qsuTu8}cQN-cG2i=YL;Y?Ox2}kIn;LpcQ{cFBs_E zE`a#5Pq|I1S2z#?=a8dMVHkk{Z}u88v2hKI;lFl2Auimf9JF+MT4na1v6L4M7adBn z@;Wz>!-#D(h?-0+HG#!|^Ma8goj?QyW`+fvFt#jO0zPi}Qtv}+TQ3F~E+R}j`yn^p zs4+RR*-;$L-VpMb-;d5oGIIihyxxe5Zp06zx^sB)#9QopEYGBcD__Rau$f!v(&Re5 zr%ryvXJPz91`=QqU;j3fFNg9a`T6YAQ=TD00(Z{v%0$(iof@uZvOiW(S$tBL{=rXJ zlt}+i0iZ1vNh_$AMo_9WxXPjC-t7?f;!4AOlMF~XAScM(i5}pnBVv%=H6crwyC(Ey zu=S<00TMmw>08@|g#1tu0*9sk`cvk4bHXiTP8!H-7+@7qI+)MqZ2Ww%`^F=+dMw(^ zhM>cVwW%a&RUl;jj*KJ}XI}0wQ(+9`Pya>{OLl6K{y+`Rs|7f(omHMc+gyZO_M6?N zTs27#0+z&1{CrDjEw_RPS2a-~hBoF=r$Ac59!R<6;TcM1BYbPk#wE_uLC@!_?A!Gv z@P`}|RyPuZ#@9X}TbAoQ5dA~MLS=rHd|?DP`agB%Y6?TmZD{xifIE&V_%Mse#u&Bi z@ckV^4O53Dknd_Kct-&mwXXp9FDXXra*71+rCFSWNoRx(7?gGQQ*d?dGZ5nigU|=c zelctA;PGXQ`MVN0ag9J27@~TppIA?6$AetY?eJR0YA(m%Clkc*XyOiT-A8XPvTlsH z=Ah<0&mwThar|vKTy>fE)nPreNMb=d-F}u`nJ3^Xq3Ih&5rnX>>KMcJIdex=EZ=Z^7d{W z(|!%h+INh8*w$P2^)et%Pa<&ZgXbd`Pr$WwENtN{ID@7B!ZkGC@LFB`q3lsOq^qrxtCI?<-% zxlbo^pQ;9`c+YGkG7=5Ewb;DV5qQptWcf-~o5fQ0nPq7nMbsynr!I(c^aQ(T&%!2g z)(f)A#KKV_t5hLtzZ+4B*=vqk(wulcixILls<=Arp(p^mVl*-0b0|bG6r8lG5#7b582S$m zlT9IdZNElci81Fhv``hwd0-9zxJfvy(G;cgNkutAmvIc_4`pykp&Zi-{>xx4`Q;2y8_;BT5quI<9w>quAlzzSnF0yBwYd?D@~76c`WFkQcIKEi9O2(6zXDI3TMhws z8A>LPAXFqyOPZEH5UFm~`#k<-HBu6f6ir;j8#L5tm=kX8uZJ30i2E2pPqTMKoJ);?8m9>pX#FL-P`biD_L{5vUa>g;%PvXPQ@5&uA-p0E~R;|`He5u9$o7B|F%sGXJ3lh$v&l! zwX4$N+DS}|7?<`NwUCm1^ZI^5Hwj(1p@m9`on;(wbidDsh>Mxt`%-tFfSe$taKd0k z+4!ztzOki#fje@E6(4terJVd?qczh)uP^%9;n5Ap66U`41iN!`B?7=5+*hYwBGI}e zzj(CM-XmZ_8xUuLN{Ii!hwFuVIDWY3xXLyTx$#SjBWZC`*{d^-H#`*KVq%_BskPcLv~K!Vu^|7&9R^u zsHo#F*vQLZ&=F*Kwc068INmg)U6t-yhfYDy+Q}verF3_}OrSSR_Z(8Cl`kI?3q(fi ziiIH{uZ^nfHu$JpImHF}{Ei%&?b|lf7qvr*L`OzI08v6?cT`~m7B5h#icJLVbN=8w zU;J_hlHXTf(?-`mxdJJ(9-V+IDg}My{{}&ZFsPW6DMfn{r7yUZlw0t6*T3sn!G3WYt{xgGg*xie~=XtC+!-$wKAeU|4qZGW^nH81$=j&$$D)mAUmsl5$CIwB zo(73ABmf&j!~((Te-TrQx_ONli>c%RTl1DXKf82=_KOD+`pvDMy{GQJzBfXE zz~Xx8t?QTh?iU1$ZaShZN~gH5$|OR`=!_2KlU-)Y>ZttCO2i*3H_KyK(hf9JB@+-#~vv>WS2)4cd-Uv0~_B z-$Yj%_GsWeh~nek(&2SDE~Oq`jY^N-OsQL(DQT9!dOu-=>RL%{D6}-)eU+da`Y%iX zg#p^VE|BJD8KbJHan+Nl%AxgUX`lI0K2RvAOkzs+Uof1q6E5y|P zzWQ7#NdKcjGU1+Vb|xQ}I?;g|z-SxYlg?WNiykh*l^<+gSvbYXiVB%kdU-$znQHGd z4}S(lwx|L$3<7h4c8gh`(y?xWv$_))$mt|>A+cFljpg@Vq=xf2)T^*pYOfuzFQ_dMtNipud6 ztqXd39X9=VRB<&Y2RA-m6wLs=d%Zk?kg;o0E~SY$?aWbBozp$oQ)Pn@BuY~tJu}IjrSW7mC&=`&(s)Rt{ipV zwqcVqV};9BuzC`Zye+yVLQfFcYYwrNA{%&zbfZME9i{1>YY{GxpI8{`$% zpMe|IAI7RA_a zNqNEIPnGXcS;8bhhyLL-5U3zv9e|Dt(TyzK@OZ%?-ORh~z85>BGRHHlz%Un7p%M!W z=pBE%iy31UN5+S*m2_@+uKUOMFo1Kt{6Qo-2YdupXqT3Hb8^6X#0%uOIpp?h&!VwM z_O2|wg8n7_)CV5v9ds=*s9CfCl_oCFzAhe+aAeCUjSuHt=6dst;FJ&*%=y<|>08Bj zla3AGb#is17nwm()oM+nJ~TE@A&^fn)_o?w;DR>sZ5SmG{T1i;0B%LlEyItMjXWuT zixCuI!(XNmKLW_uBr^eZ!8Uv9cI1@M62iLw^)H{1gkwM08|d5Gyg47cvN2{j3bLWr zO<%ddQJsmIX^-%4Ya~#vodJB>hzr z2eD$q81ugf>~Harla0t^|M+X#F41;Np=iU_H;Aj^mlNB9B0U1&Z#ulyb|EM~HK z=22fWPL+;^iL)Bdb;P^!ppio%`t-DSb)^xF3wLgQZPbHNo*x=suv2mWD>}mnD7y9% zX!h$A7b7+UvhV!_TXM|biSa}nS6q9j5Xx1wHlf?XO^}wJ4VN88=3UO&ASV$V+mvu7-7lpYv7!{b;*svkw zzw&a#cV==2^H0Ct|9x(F23d{i;2`N)0&1%Ew^6tuK8Z_xA`;-aLWU;qge7L-3N*x3 zV+h|@9qi!+abZ+xS;GJWXbdy%8<1i>cRkp<|D}Bq^21X>lI9&NuWZ4e+Jf*_LAX5h zdoV-c9y^QlqOx(TR#49K7SBw{)^`IR=-nn8T6MuI;=aISn?6lbZN6d&#-hd8p}}AT zJ}gd(`)!a{k@@Q@YAEwS*V~cDM4Ly{qdw@BrRJLDl3q6?>;U6ue(PCukY-b z$ZKTAH*iu%5-(mpYEaJp($cWr7kPASl5XX9**K2aVkeIyI>7jonQ==1XFYs*teZ=I zt+YZnvEecCBdt^6w`%F+O-}gz%F7hKS@~_za(vn3LIPnC&!dBU)_^Yv?QE23Kb2w0 z^-lK+Soqc3^w^qU75rgF+93zbaRoXI&aie6#PYu5NAE)RKn2KOZgJoKdriOUPD3Zv zjU>ywgGp z{U)_sy_Po`%=Id8&l)yC^#q6*O0RUCuR0QJy$`hBXg_yv1RmXAFR=g=vcZ}M1RCu` z3iEf}Wf8@rG8ptL_)n~^Dbd%Cd^WObLhXkrSGH;?_pHvZ&%xlMS^{qRrv}xuS`oNm zYL=iV(quFY9ow)GU$cM)?!c@_$3vcfrEh*&UOszF-PRVx`l|S08fpw*=er~R#8SRB{YE0REhP{LgcwA@PYfIrG)5tL z51wHTtfB$dgRHRPfnkai8=vhiD+j1T#(a*@O&b*^SC_+2<%g2I1FC5{>{~xy?Hlzc zR0fuV?Mbzz!;h+%bIQhN1q;h9m89f>-MUeuS+fFnXZ|ogS0v2_kJ6-lpXN2=MG7%t zQLt;i#1&x$!s11%!0^{{`-fZ>;=UxwN}iNO3Lr^T%$}w7@1y-f75(z*J!fk4{1j@WbQPB2S8oftSdF0q*Z=+Y^)IG<{ouqx&9XEedN z)hRyK2%i8s@@VlM!`0wNzk*y zW2|T5yY-N482mF2#f<%o!iVq6`oysHP24;4_M3AC~)r#RP`oHU7PCe`AVH$wWV5iE*~;vAQ_WuhU;mnccI1{*5V-IJ1PZI-tOS)+nrnz?VJEBSPD`#|^DC?0;OA-=PEX5^ zIhPKSMkat0RbNr#tLeoSZ8&2R`H@-5fg$1dfYK(m3;4$ID1 zj7L0Kidj1qcm5| zRX$V)<&6gU&5VqZgMFbQm~8nV@h!mj8Gagy+i%2%H!br%V@h7%IeD`t1bPj@C_j#y z3epk)69_PAv=jWn8Nex!ih7j+Uh4hr)jaN4Zp{7SM+b?OK6`bFo05l(au&)=Sc;P# zo(8Vy^<5GF^9T945|XX~T(e$lBLK!ZVXaNDTGo&^X5|G)rWBd0#&wnTw>L!`>3Qy&p)u_Hg(d55>*7 z*S~EOl8KGSVp^;T&7!s8geUFHJ_7{t9_QjVp-vn~ElxfsJNXo4B7ypy^5x}^o6*=5 z0Uu~SDn+~Ud0D<=xVd=46h={$b(4PhS9QAqr!UgXl5hVdcOsp;F&k%`PMlW;y& z#dYKT5j3K-9Uh8mYl2_oTwmbnkaHiS%T4%^Od#NdNRYoJnBzmvCv~1QQI7QeyG>H9 zZoG}|?gGafJo!CToxFDWME?n-$a3v;$< zqCz=brN6O_4c{2>(`f%FFJtql^Hz)+{#n_%gyFvcjCMIm^dk5)g}JBmPz144ipwS` zz*_f9D|{7;1-E!2$kP`X{r&2I8orOJ=;u&Qn~jgl9^}?*UZ*lJo6!`z7LQ{h^P#LR zjUZ^QUCfy%!L9w`na6Qac72YQXl%6BSIV=uqKe}GnkVf0hjLaucU^Pyb>-F@I*#C5 zadEiUwoa*>q89(TTHm2ke_I~35063!sc7x)tui5sHk@h0#rRv|b2lflQ31_?}^4$X*jt6=)Z1qEt&$aNmL z5e<|i|1oXU5aJi4yoHX0aIgL5ETrK!VrD223MQr-mDVV2fLAlSBxqQnHI%6sdZMFv zwuL~|CyC~^#CX)Ki0|RX?4*IUHngx%Ld8P)cLUJ~2e-8X7h@8{%H(g&&3gXCis1@I zbCPeYf!GxS6OaGO3e5%UEH}E^e0`!cG(t*eZ}|FzoSTJdlOE#)Snd4dp2Ngic|wuntTpxJ8&$uL zb<}>U2feG>SW!*Eyxz^OFJqnbqtVeJWE|C5zAC1-`~7)DhHI#0DpZr=ahzo_Ify7P z?x$W_wIrbPwSbz@ow zY_qy4EFO9j=a<&#{?inw2tk&TfucD*LaxpK%UvzYF7C+#+txJiN zgG_K-KHWQP4Cfz)&#$eK@8{yS)Dw-%a|Sw(02SgH2`bWqGi~->t~7bV(XlSo{S9 zR7THr_Bkm2(jn5Pr+|nx?u(dO9$&{8oPOlNdtg-}hj`!KmcKuG$`>iW#)v8|O|D8m z{boHA+=#0QwCkksx0afq#A*$xuTrou-;oDM##e+Fe`=CL?tYitH?Gj7N?Hs5sYDSF zel1J^1CB8iKCpf{tu~ofct1foW=l2 zn?YOwdvDSm<~{VK@;n!5d-d-`&8TTVzrr&kOn^29+nTSm8ItD|`}=Ek?b+$9+*Z-s z1p>gj(&NT4%V+ye(NPy?_>%)UQA7{zGfg+QSk7!a#j}PsDp}k@ncoJqw11-jTWKda zSeIXyRcmOrgdxyxmdi_>xtY9fIkTGr(OQr||fts4rio`1ks? zR`sKJBkQ#C!*kmT(A(`#KD<=+&AVm$BeAd5js1P?g5677K!W=61;T^#K#hibdV4N~ zj&%-5-G~uAZl(aY08kSo38`+-BqbH3O5~VYgu<0oLwl%AZ3nMonIe2wZV@E3hP=wn zEgQf>@UuKFG~9pI%An%D;)XXq6*@z}E0z+Tzol8k$#W-v_W) zQ4zk32BB@hSpV_UZw4L%5gD&EF^>{gAox4jQ&|rESK%LNX{`{` z;dYBCu5hwGPZ63?L?k<}Q%7~_8ySYrb;f6at2eXONNn2KmU=!TkBGXCqgo&LHK!eijMxaveNo<8S-2`b8?w$W zlt2?F+ z5Exn=hg!{??%z@2#TG0h;v4VH{1ti9MSSM}U;aJ1GBRk8N*q&VZTwW$>#0yl$DIFQ z!r$nPBNJvKaj2pD%9wZ2=cOwQq7C6w{IIgP4_`y}?WoON0{?Y`KBuYqqx;9etn75~!|yME1U?x+*97VSKUU@qyYA|pBbTCj zHR8WvNJ#KOyv?-SIzOy(X+ldU$@ENE=2tcq^8u9#pu~WpvJqbWzKZbC2#P?%)%?@Z zxbxb?Qg$P4=AZZq(nTIp+}A;TGer%w&KSlqBmLv~6%z*prS5 zf6P$a<5G+;4*#bVgc!=jd9|>b#{C!dG{oquRJ63{-(Vm(u~B#>d@uEiKmG6BNdH zuRi_aXk?Y-J5tx7>~#Z80%0VUlI^bN=+GeA9k-MBpO)+Bj40FMw&VxZTUg57uMBjH zw(+Q`RR+!lz1Yv+CWHt_SdvB39R@%5v5a|3JTP8$D>XmYDNFeslktt{&1Bk}9Kv*p z{J!4xc=6@;Jb^)KPhNjbI8PAyPGB=Q0nB4ZfmGxjpX*DhlY0MHPMN=0tFqwrui(AK z8l^9pnVI?ci10@Iu|>VsO1}Nk80=NeMnO9&w;(&6IN~FUYJ3CvxQUQM$0L!Cb6q~& zb%d=leUnV()Lel;T=x}&J(31apZf~ehhfg6{x&GFxO%fiPOik!FG5Bw4qfP*6hv~v zJ?nJDrBC4(S({}he#za@NR?BVgP%5Z7{{DXOMv+ZHqPI};+dtFe3Gr=vg1-zuF5Q@p zA6%i2yv(?#z;IBE`!%SOSKF5KLf!R#T_nkXIi67OhT7Kt;ePXl{;ClE33^_Z&V%vk ztft>tH7SPXpzrk=+`VmVlniS7?&q)3XE%o4fQo^LsnUIF{Jt@=6>Jc`Xa z3WTn0d9@df&aK&6*gK>38A*7wFVqG@@lvpult&f>uYXMkj3~VJOg8U8`Es>fHvsq0 zx|gGI{9E4Br+ZH*K|eBkih(-yh$soK=+u=vvjq?9PUg7Z#NreHXCUy%R1@0$T<*{Q z+8y`UNC>N-BhJ{=RPg#u{c+Pg=r1}q=dm-A1)7sXN50`PMUsgOxxR~pGUm=7C9_TK zr;JFB9>4x2>ua=qXdQ*8*7}2?wM^Y>sgnDTm918H@jm963pe>!;ldJ6gq$p`w+H%% z-xGwoUpe;d({f#Me;>>o;PB<)LajX;M=bs}(_D`ahQ#ik)IQpQ> z^Yr%1RG_}_sN0QQB4^3vUm2npGGSM;>q2EV)VuOuS4EEmDAuUBgXGY$w#k}JIzd4p zb*AgV_vT~vd7JmEMWPZ$LvaGxC|{DB@9v{R7XY)Oj7))WoJbo_9UIYs(h{_C@$Qj*+>X`{{d z7?wjBd&WmN-%pS1!;?O+6i}?Q6L*BMQbD^6v*r`q?jz#6xdI}W5}!2z;jkS9M49D_ z&QUVOYmQwNo!Yx;&#wHSLT|?(TWGsS=Z5k>BftAj^sA^(l}8C&FHcTuC=8j*Jv`r0 zzdqr~9<6=o=G>R#=RbsNKuE{QUUa^`p~w=`aV&i%oHHxbGGV$8%`#N9%EUTg5Ws~# z!Xg-*w5U6ztVZ=1=be&vAoBi_ka!-NueK!?v%ET(6)F&gjsRW^EHRgQZ_wRDka|5T zyrsF;>>^ClLhi)>0@XR%**zqXaKy>qt`}#kuGx@2#AuiWb=Mui78=d$!Pu{{U*~GO znR!c|Hl1iIIB5-x{Q}F10q^JN^c-(Ta>+K`YXVd&_6L`j;+~U|(LjS_`t<5wren0h zC_2yd!e|D*bTYnTNoBtJgh>Hi{h;18Hj+$?`}N#N*a-5jwAGAXeG4v&a|%)FZ4a8m z^KZ6fd7yuhvQ)CA^!|PU8t&-L5a@usJJk|wv@@D)HGh;&SV-JsD$4;|AS$}U2$)Dr zExw+XYT~4=^jUso4a^nYZoSt%B#9_uvEuM`{uP`ns$ICb2uI-M_~+#(kjTD^Cnr6(KKF;C4zIxioOLlfvR8ois>;6^G9}j{;2~mTK&0Ec-bZ&l2 z=PlQ)PTb*KK6?B_{fvPU$m}Rs9QxysKpLtex17|iM-i4TDKPiSLf~-c2k9ZIm2sL> za5-mAvP&}N<_|ro;7W3+sTtC~H@0@_=7G)E;_KH5-__)P;h2u9I=J7g_(E~I_bfEa z@t{aqf4}7R#0uS*^jhZs)Eb>sh!ngn-~Xfkv;T*ld6${-d(L$Z_V@@27Sv6#%5>VI zP#5+bg(aih^q%CP?@NlQR{2@B`!-fLJNg*km?)|5n9ceWYAHXRh`Lz0?t6!auigH1Ne%Zmy&T`y>>5_o5Gu9^R9PJJkVopjU%O^9=*kKdBOv*lZHb&<0bfsS*ppEObI_~D@cZ9v)znMX# z>*z)LXkzl?O-ptoikU$WGoHLB%${H*vsoz01=(yq{Wnm7ZbaA`an?q=LOs^(UgL>mq&UhO7D5sS z0w{KG=L7EK{jw7nsG)Yvaia$-vFPYNgq__u-O*|JHnQ1~CsD@CW5@ z%PGrN`w$CVZzPT$#(R^Jcqs*QUD~e6-dg$aeu?^lP_9u$xOEPSzA^8$SKG=GL1-(# z2x(P}`?SP_;Ee(wLwV$*|TK*;*!eZlh}6&8K_cpryj%C?@+7}182VuJ>2VKkbJA0B4k*THZoDW%#7(bsI>lbc@D8=H_KP}l>FGci=0# zlL7gOiHSLSlai9cy4c4i@8rZOMo&pexco|;v^rH-#N*dr6Ugvefh?RDa^6oo^#pm+ zAn<_AZyOQv?>)e(l@KTTrkz3`i*G6Q1b2Bp;cmEPCcWKZsl=0V_ldl zBJlhisn{ncC+pI!&p(|XnixFV8iGN8jbjOle}W%WxxaU8pBo*Pp`vp;XV(0P)&DIB zTTiMdez^Ac3oJ2glKX=#6@JOg=?r~sHbJ^B)r5Ug&zdATo+CV~o%ePbn>GwPOAeKY zGCN3*)XM`UaJ+_J&`v4}2iMZ>TeApU6YjY&4Cp^r?9Si>d%M1S3n&p;E606SQzO%- zb^3)JUBe(tnAfCY0pyNOPA|b96cpA)V98Qk6J$$Y3mbU-(D|r#onI0qaMwKJ`d!we zbEF6P>tC(pm8}&NG1N_at|LcZmayckS4|83bo{B;*Hy?=xD=dCU8ZS6r6T;I1}7^M z_04<^D{W+X&$6g0#rkXycQMS?kSn`=|e#}zDBcMh&0dS2Wvf(RTFc{1hVZ1j|o4mVP{!~IVO(6ZKAyJPh z2IUtOxfMUo+_9OP2fdd~`|`29M=sxBR#htB{-XHnDJF&~mQSo;9XaLWSerL{aN>gj zT!v3v{8NkEQmj}87({bR#{5?~g_G^S^Z=6RMf`2R=}P0b37Ud|dp2GBIAmlL+Dhd3 z`@+0DS|OpuUFRi0GjiN;ey?L5f=-$u=*}Uj0?6ug0f*Z^8-AVX8^Nc^qi@~Z>8HZK zHCWy4KlPO}FpTQBPX`_aD6=L>OH1F=(43&pYKys~Ng>HxB*!Y-ZR;A*e;n70ISShK zRL*0bQt%?CfcATF=59l@m=mk3xvO***Utu5Vo38BaN6ICIf2LjO{S!PK+2S4JyY*% zHSy;^gU@fo2wC^NlU2#NK*u;kwjJlcM@-}V@9+A5&Jh3y|9U%kb#iu;_-NpI72zd% ztqzKOcSa6rDQc2IG&RG3JGq0I^UP+dPz@X)aG_U~>^@qeRa;LmT-JjT$Br%P_eIwH zc3GJiC@XP+Kq0ns+D+#Bbi0iuCYQ*p-Qeb6YPtbB_8EBW(ge1$Iq!^^bVvSH3*0-U zNennygi{B8#F?x8IJT(yI zWvl-72G#REBOH%HzTj(J)$l6^zaJMmn15rq&PTKMo*z7ldp8aj+YtEJ_wC52@MIJ$ z3m^I%xA5S@Q0^iOm1eWZ4?qP~AU-R`_*OGLTK~F0&pUhNuc1x-^kO^778$>P|GovZ zlT&{HPv2llargMx7`N>lSI;M9<|aP<=N8xe1{*;JzJo_%DfH`6`Pc81N#2T_kc!G5 zOrAI*ARtFBays-VxH~*Q)NM2dsxLjLKdw5jKN2f?+h>nRldz%M@-_DPtP(c?6r-R0 zXynyU;Pt+g2vb;krz<`M3N!$-`*av|;tVGKe6ta!^ersRmiyy}4`TrcF9AJ;a1;~f zi{SRjV1Xw7t-)GRuxUIz=c~KFDKj`=N)72fYjO#m5XY6=0!PsHuOJV{R8UOuS<=hq zD=%ECi?}7a2^oUscB6>a7ObD~O-_qF`%)cCbw_S`7RQCtF4wDBd)PAxP5*}ls6@IH zG0%01w)G>N^Llvxt0WCNKmBm69Cy1QONn{bpw?@5#cf4~28`GOE{XH);cWo~3?hX{ z5V@Ia{I1HypmsZWXwpS@%I$-ClbY?rWNWv3`op}#q+kHit(VIFYL9GT{K`3>^sLR;7lNWBNAO^n}icpUL3i+8fM0LKYXp5a9yhjTUp3$6wu4<==PbREE#6rEYA@ zgbY~S+tgFAo>yp4S3W>>uJ#RR1-af%n#iRXeKzp?(`C3$uI{THrYQ;(IOMU7t#Y?x ze5h;D3lR&S9;wq7+~Q@%c|q=aegThdZ=8B18WdQJLrbTLr>tiB;&AljYJ5PoiPaK9 zFBg$*WN|Hx^yLG1Vs27CBie_zlxY&6`&#)_ccV`f;cpLGf1}sYI{!AyC|r{s;s9h~ z#23|;@s7uex7`&T#$S~TOF(1#cH_-981J*`fvf8lQ!X1WW6Nxxh{-RJfge4*XhqB0 zTt#TvhZ*%<2*lR2(xF*@Ma1S)KQt1_ zZ4i-}#_sH2pta*$)ucPk91O`R?`dL4&~}{C06%=r{*L%t?K|k10isSH?4y`ZLT^JD-vuq(9hf? z=7|QopU{}(L8lbMkt+>VEU!d;c<A5~bLz2t+zpg&f z-NPEF+7p*7w3|j>vE+L9BU3Ul_xSAcF=q<7KP2uI+u_N)+(dS&Z|byXAj^W-Jqfc^ z6)axOEy*Twl_eQmHyvGj6E)t}8O3eC}t{}Yr2E9#$9!c`| z;+}_BzxEaPsLpLyuE`|F4g(P`bH3&mZS7h<-al)e$elXGb;xX&p76R=yFhMs z*mv`jP@4(Jb0ASymq%@|b0QaQ^L4=zF9=}gYWfsfR`6;Qtq@*a+L~ZrpbSyMysqO{ zoBa>A}pL1si?!zxtxV6n)IVs>N2j+%7>it@x z%2x{6EAyx)=dM&dgGXrj+mFMI-P5B0dV0bZKkl{migrgJQcRRy_)ued-&085?qp}6 za@T5gVFRY2BF*Qw^-SvLw)wG>(TAZc)6-KGcC(C4E9~+~N3N>kw7!(17N>+S zkfdvMs<)<8c=u5`C9Bd!@OT{XePV!29uCGAwLUub;uL?NHW+q*keiNwXg^Np+Bke9(3)$gtTz@_MAiK2 zBTXa=1gTa8q}JdC_h)&`$|~3>-2|pYMd>*dzxg~H;(4a>;BSHuek)wu9_1G4hJYj) zn{LA8ba4zcyx)eYA>>`C#4k9C%adlgb`7UABuxoPUGMMffv{NGd~f#ab}4CUs3hNPav=M44P%9|p$^*MGl=3miXx zF@IZ9CkW8_@WgXdmLAQaypAO~8sf)+&(!jzfNK+XtK<1kGhNJs1hj*eo8(j5%ddC=1RkDy!H~13!Fd4;d==O{oOX<(z@`OMlUWqwta&UI?}pT zApO#JZrLl#laoN-C>e5Sn!-IOUkcDro45M% zff)@yV#COanH;lwZcl?`wxOtL;;~4vz|Hm{fKjfyg04D_Yw)Z?qkdEAzG-RM>#0#@ z8s~fSXV>>sU6^|keIM5A80b)R3SKiURMzY^+|S$B?G1hni>#U~;%`hfPoHgW{iNIA zsURvhx#uu#7;1~)MD9Xm{6%{-C6?C70L>+_%264U|06nO@S*0vmOdrQ=`@w&e*I!V z4Zj6y*u;)z{;+kGeXi2J+UoS(kMh{!5OnWnhuPJmgz!-_gTEzYlxf_G}-0#(llAh&%;jr@&ysUqvcXf~9Q&YW080h0$ zH%Bs+>RNK@Lsx=-+==ycR(tD%gamIoR7wvF(f77=h_6 z>&x-=8zr5Y{dH8Ux1^7B#fmE{0lI~Y9AC~q8ff5tDS3ft{^c~IWVk)q!!I@cRcHAn z;l4$AN$uP>US6O&AUx$2&|{?kq;BZ#wR;v31s6?FSUuA_%cF(*;vbzB)}|s}H{Cj6 z+fKTYZGzVXdD%?5husYeb6TZs4^yBE(U$UT9>E<-a^~@QeSzvh+z1G!s>IpfcCz;6lnrRzlqLxzNh+Dm&S~3| zS@EuK7Qa~8mtDR-dDv?E+IlUFAeM+zXf~^3a&k;6*0)x1{|v@zXsr!L-CYjzhJ}yo z3l%R6vQ=N(P|l6_n-ktq`>x~Nq*T%GP+4@`s?!Ki972V08jngmw!%>BdXu&Rl*d*5i!~tBTPl;(>9`NmI`B zw_IeOi)P2QvdDA7g2QVCS=+azVFZC|UT$;gDQanZvHt|NUH4n{TdXzcg7eKfEJC%)BR#Clj&P~uELNPG?NxROu4H4y5ubgP)VrP~BknLh?fpj~ z3Jc01_1ZU=@f;?xIA7?%uIXfHHqbM5NWf}r!_n>bk56*bW_oebetHFBvEqQfz@tVH zt`7~IM1X#4c~$2@(sJu^Oop#D*xeiaLrZ_av7=I-a9ByD#<0nZydoDeewFmN-`r?F zwv4#PXt&_P6)yxtS1F(M$OFoi#!mL!d}M2xpH;Eq^W0@j-=|~2a^Im-M!U8rW~IgI zd2U|szPnW7TYPyxa`O7kbY2SQGwa;h+|5$H8p2PUw!7Uu^2d5H^1}^dN>%dDsFEM| zZ_p`-;)}i>BfWzs92;_lF9t6@y5iJ0dW4s<-mc$?_WSMlLAwn0lk+4S@yXv&`3ulz zyCz9_e98zCB_eM=(XeZzFW6b8A5kF`6Gx?rGZ%O6IP+uaPZdvXGW1Ar!Mbfz#LJ3T ze3kQbgne&nszk}bZXXKZpQOY3wX~I9_P+$hGv5NCUqZU_d~G|ebh z%5S}GZE^M5wn)fss|b!-%+mM#7VAryW*5d6-~C_neIo=Gd>{S`a788E8!;fU|E6`` za{V4}JIE6?lsdOeKkNFZsCW#6N#4!QLfk!=)!0LxDC(78NoAShPHw{ewVma3Kqe4n z-axsxUeYT>xM2K3lX^wnWn>%-_#c_pazL4`=XYY?nVC%PMyTg!_SCQKs#K`dJpKGH z-URo?RZIYld4CA-0aGFOzLxK~Bv4$ab4^d!XkLESOz56cf9-2^Fxl^vcb<-bs$oVv zf7bD&e}m?iei>D zzBqwH+^?AHzwQwzpll$rnzXdsYR`QnCV$Ln|EnUAVLTC)cD}5d-(M~8Gpccha8pEZ zYvY>csJYQ>3enN>XUSTQxsv;T7+pA86{B)xpm)%YfY8Rb;E3T)l2$hnrF~-SEL)O< zryMip8D4&J$XC^pYzoVpBc0++V78zi~d4=2e21#U!48GmAt zWYr5GJI#B}bK9REOBZJPT%$9vCn?Gb{3B1ZWu$Aq%G8_C*YD262@`7m2J-!bS=J3CBlzZ+D7pooa#6NkC}ZjDOHD*2AWvB2mG!LOXl2m15+00D&3XP z+%orv$ezo8(#zn)<{-a1QGB3~FaG^xChR{L715pKS?J;P})MvNJs#t6m-Lh+eNnJUuJNF@We|{ zNihw7HL91nQCA_g0JUrxz!{i(3c<0Ke?`FWP1=UkL zxvK2Ub#`KiH~WmP-BEqZ7&(>L;9xk%XTo5n5Z&(CRbaI9G6d`PyTbo-(l}}&BQ5Ms zG7X0RtqrsKOv%!-@ZMVfCwh9_Yt;_&udm~RSIU*ck;eAz->obyxMqzX8C%(3L#b{2 z_Ue(d%wR1i+V;C2!E@3NH-aRbk)M z#J;7KOpzpBEeknBKe(%ch@7&8$148)lD^9Mn?X1~o~Oo5=KI6eed#VKYxi31e0hU! zSR6-Dpo9}9Y6LAoQejm9ArtIk=Dt)HZE)#jmB6%(eqBXcg&^c2GTN&9&qSp5Z{m8{ z)aGx;To5;x%Ifp=_P5MvY^aa>XQ)GG&eFe(@npi>__%k^oF;Z?)g(1_x6ZQRa=FYnr#?Xb>MeAG^*F<>ilo z8ywnI<5Tf}{`XkVY59(oSN;lsEdRXNMwYQ!{gn6uJ+{gFkev>JR2r~CF)2NI9H|Ay zB>?{n)<^@QwVbYmo~dm_?I7LQuK??%BzI+Z#VK+Fa(85FS3;QKnnH&*NgRZ8;L{WvW2mmD?njw*jvdFps zX23+!zEm%)8Bl@dZ${|6pCoyZ{sYL}_gR^{yWz;n@977FPwv_t4f?GL)GpYMY`lTs znQv`FQdm+&3YksC3II|0v$Ze2nMX#*C~<*l&!elfae=8o%E&2k2N%k>c2+;Zc~&g& zE>dyAPvpN(_6gxKCRt_xW%3;p$=9M753E27&#P*p%S9Qc>b;;)n>0#27ZnYOur>SF zTTiT?J7dYMAf_=QyhWtmJw6AIW z5sAWG&;eVeA6pEU({T-*!DG>wNq-0C=HK})%s)=9r*ilLatW8@|7{Zq+gDkhqc39V z9j=(IfSDE3kWi=I)Y+wS%A{Wvt*h7WKxEu>jT{ebRz$C;{`u(Y^~(am>Ug;myW^gy z2_$b=ezQ4jAbvOhP^|$W{m!>7{q6FlaG3 zqxNMcud&J(ge{|3*a2;UNpW`-zy-d&818fa4yex{cTg;p$6C#tnDtw9N@Zot7m@L7 zlU)McjJX*E%-nOmL7BM1jaBjHGx)|YKqW+3U5?eoo>2FGgHF4kuIma1a;J`~9Pn*yOD0G01oOp0~BS(HIQ=WJc`7hJfDlqig8LYpUa zP&uDg7I&fAoI!lOw-kq_{{=@9>G6wfpTKlPM`r_Xf}l&D&sldZW8^V8Fm5@uC#WBD zqE^mFh`~C2g4a_%*gCHuJufw%mJtGPA;j|(6W&c4M1->^&Pt8TSihc9L zl_B~0O-*dl1Dz|9*m@p26K`_BEA}rPBG_sVPQ7wnztfDrDLWLdtEG}M;~%yhd;O)l z@+A9lySP4js)HPwrjUSu$p`ok^c$n2qfh-W0^&N2t*os<1IN|XRRCD^@3Q0~LJdC0 ze+X)y(APMB*#KqUUBt^(!e5QS*)=DsMmJN;7ef!!D*YL>55=!MzZu+`}>UnNUat+ zJOUtf6A9@f&X`we`aLjGqGX*AuI1FfV=dir!$OeRGgPrmL=h9k`~o0=dzJN{^_*;+WSR+H4}?t%aZo)5FKE39p@Ln(!iBbw zq3iEx)m1#?b4ENqrYWMUdV5MgeTQ%Kbwq|0ueUMFoM99;qo-TemOxdU^?z=u@23N6 zq1{%|J}~n_JQboxLJ&Ow8O~7i?{vO=*KLt!FwBC4g{liYRy|`5GRPi5BIW)+U=b)z zC<^0rTpNx+b~ETLFqOUaH7>Sm!ckOZykE=v(T}^I?>_(4i8>*b__GpEdV|qW|KcT8 zJOj_~;Ke|h2`}l>mtZIg2#Q#Z-eyrvk&p(@k03;3(BI2)gY*{pJfz!AL=z1H)E3f< zDD&?^c(w-kleWCGhNWnxerfS7nHiimodXw!`*_DT3$_gI=^UEpq!M2LH4{|D1gVX4(vD;B3PIm7A}vm3{_?e7-<66pVH0R&izmp>Ou%C21r&0X#y zJL+6JS6WoLS^WSdC>gp^Kqt2WmpSTKiAVolhC=K;07vBqD=8xPM~s_E{E8DxkhOY4 z;HQhbXzHTjs#Pdpv#rBSqmZYHmgmG`{_ScoWMX2Xv<5$d5Q|t@br=m_fuG2Aj&VAc zH2*e|(%HTb{Q+@FZ>fz2m?H(1G_fNwUec?$|K=WzkToAe)V}OXzvSAqsC2K{i=7&q%6$b3jhYi zP*4ckS6Bj|)e58hY@gJMT*zptR3}*rgTM)yo9iV)-0o&sQvdq)`}VVd99PSde}nkF z0g8lr(96B@YWC2~D$krcV%%BE=wUs68tD71aDHH>f-qJAyw5eDPTsg3Ch{rZehEAdky3A**Z zT}r0C8{VQ>8DAM_vJ+hBXY`Qu?w{X=65mPGF?`4R2tb0uz@%{$SYt3QyV06F^# zGVGrPCwops&)2_%Rb19=(RE5d9lUnPTWjTW%F?(JR1=Bjbfo8rEIo-258k1ATbZCH z8J8=IrN6Tb#+*a7nt87&=f8RI@qL=Fyrg#@I=te+F{^Igc(@0;5xfzyp`W#R?7^p*@f9>DV82;9ZQp9DwZ0F#qn7+4EdilLJ^EqRpWG7 z^AqmgO79CZ{9(0PvrO@?@1g@%1uIWCYy)7lCyeI8IqfJ(zw&2(B?5^dnvJM)aE&61 zEsz9cW&h!D?VT+BFvU>C>*Z0+y1$2k9ze96G>q~EyGwmKPjyurUxd$YgJ+ax{i6|D z>R-muf5BNw436CKfErm!q`XSny_Tv)jr+t7TYP^FI2ZyjD-n#Goh$ESsNM$KDRJBI z&aNC|1rr9lEC@K5^E=}qX@NZrgd>=vYc5+}mPS^W-8Pe67G!+tGm60`5k~@zgn(T1 z&eqPmZK%X75j(&1Q*|NN@;^Ol+cct3ZEi^z^+H5`N1{dvr^`$Tp8)dN;3wg{T=6ZT zFW-E5Ri&AMS!()0Zqx`lJF16|G#|Jyp>wOB0yD3|jp*s5TsKR53M;bnbD(wm@5t>d z8)v=NtW-1s93aY48bm#C{(e0+W%|OKn%_v)6s=OH%1i zXbQ9;N>=~{*8I8GGV=fh(vpOjp9h*10LWDd-`WoC>^*|b5$tV8*d)|gGPWtB$t z#{vPHL34|++0ha{tF_B-gRW5+Ar(Rp3H0t#p5npZ$CbXme|^vUpucn2btJ_?DMd>L zLe((BCQzeB^Q3>Bkn8)%9_ZRiMh5G7<%5(L^OC= znnrb_aVMqc6e*%ma9s{QUP^fyc($-z+_GdFS2{kwK!Di8c9%vGY?Jyp@budWiCLa6 zu5)H{A!R8i;3iU_y{|6ExQzr6C-lReQoS3E1RsHA(Ra`9cnnsgDP*m}H8O~bKUMJ0 z4!^W}jVJOl7#$Y#omj#c!L~(34WEwndo<15;KCn7sP94AVb<~cF<^~S_2Fx))dPO zU~E7&TiRHeV7A|I@GBhYEeNJS7FyU3N>pRDiAW0f4@w;>btzUdDvSjF{hxyNTn8Hh zu>bALG9Sa=(qLPnJDO}9-j{HYl`#ePQ|2&nHdMx6dn+6mE2w70KmVZp+tibmNyq48 zq#wQ@3+UsTH+t~%?m&UHwTv%WMRyBKlUAN4Jq^2SY{gQ64$L44WRU*bCq%QN{6iM- zg-7t@pVY6>;`C27xHT%mR4l?`mgbe>L(PiJL8y*3rt3o!6|knoT{70e^boI#K77*LRIUU8K|oM#Rg)p=zh12!v6x#BU>wT(F& z=9^3TAk7O1l1=!_V7O4Af?AGsaofw)DQI~AFbE z)=tOm*LVfv8w`uXI(Y&-qZZ%pX4v*r*NxL`|f(4#U+jBDp?5 z4ga@rHf{R|m?ALOQm;WuLex$X!R025M|29b%Yw*9{MKVMEzu#pQ5*sYPMBOjH zgh0v!RP0P=Q+{YVCc@i)9YI|cfQ9(+K>7W_F_Zl}W*)BCB67h=Lk>PeLJA1X{(H3f zGdS&0wlQWltU0y+oz_n987a&K+`pX~qndD($vo!zW`31vx6Oe8@#Ews=zMx9%&0%C zP1r&MQZWAn@S!CE@cu%NasM|69o0$MSDVb2BI#CZ%z(#TuAXV`z%;WT!;r8qY}_Fk z(LPw2X6=lv2@tTkk%y6VyTXr%04tMKUIEQw_U`ew)KwJ<;7qSN(jx7jiYfbRKP8jz z7i#pK%aL-K0?2!`l;X<&-unoH3WAI-Wn0~Z900#K~uH-q@Tk|P~Y;%k-Fy)mDFcPg%sv02i zcQaK{wSN_kfcXk!GzdVv>kIdMidw2%3Mjba>xToOz7!+5-ea0~PZJ4DbegxL6m-G_!O1 zD9rqk!Ca%drVNP*B#GX^*RR3I$tOBHGs5Vj;l0;_dBdMzTsVp9LPvalh+JJtilOw?Ux zG9ETbJX1G0Khz<^xzVBZ$4RyPG=;zmZ;sTnBY!ktBL`0-T?H1A!k@S>b1ADCi)2_BskjOfj~E!t8GH3KN-L~oh875Ty?8Hs!nv+ep)BUx zdIp((W_vK0zg^LFZ|ZWA8wZ^<&DPjP-?LFvT7BEtzXe--LN$0I%_auIUu^Hdz>1P! zU?n9JyNbG;-N{Cqib*&KbQct2u9AJ5otKwKZ{(&+Oci{`JJEjB2_i;758ea`KFMki za5bs=`GZHz{t#HDAyCHIdBLmkWKy%De<8FRiNa3zM+@l#>cO!W?IUuU7VV3zlTNH?P51B;mK zc$tkuhsnZDb=Exn{3#0^P!_+3_`w(wIuGB)8Mv1j4$MzSAgRdmg~G$Xq{97MR%ow{ zv@8mN2$Q4r|1TVK0t3WBA_8*8%0+*{DP0KzQ&E_b~%%ASWiI10`pbAt4ZE67|ibm^&#kmSM16RPtCTcZV)Vm8rZ3euBO9W7LpuTNNM3= z<*?g*%T_FH6iY7r(_#AUF4iaX4=@fYw97w;T;BW(%RL6lsNJ2~$+k;_`qUe2uNMt`mAhhayYu8-|DJ76jFh`@WhDOuV(b%qQLS!b5GY36zm)15G_pZg%oWcQEL3=- z4~{c6t{eSGB}>uE>7NMC`|R$8SUg@pPO?0*y|3;O`hA&QR4RE6pV^rnMKs&KIkj+_ zouQ?$KX+1Rbfbfd6HvG&M(a&KYHVA(E~tA}y9L_R`+5Aq2kY{BQ~cWBYsQ6>DWKP|@6!W~Tw>4WSu0&D8!83$3_;&ED0cYIPl}4%D!Nt# z6WqhVNT||j@ckw$#hjT@?Il&9ziP|Qz?z9Sg{$T&=&PQ{!!`2Rz78Pl1#%qd2| zwqKQKJZ&VFTJv|?lI0wj`}w!KChc(g3w|B^Gbm>P8H3w5gaX;4mTZL1{Ce+^{vl}}D`W4(Ry`j3drn0&m{(=iiAVx+=E4~ro<+n6ff5b&pr` zoE#hl1qIwTGsyTaa5TXJQN>qhI)a``q+|i+p)KmK~g8-|j^DxtT%Q3I- zEP^_wY*psH$zXL%C{h&`d@_ucRCGqsjUQkmEdM5KNvA<8G7P{$Yw zEhewz{cW4eVt3qJ+W058WEfHv?&hJmRnE}+;dn{`izsmL64Y?iVCep`skpkXBMb(p z?k}4S%oGm?z(J=Dt^`F?<(kE2mcmJyo2&7p?YJ`2bA?UoJN7HSY+pa%a|ZU;kHaz` zIk^8~bV{al5Jp|YOEF|d%5>jKrpxrgZZFN2j*29DTX0VsOD!EqqW$3mhe=nsUcE~l znb&F%!P8}luMwdJ_*a{m(xXE<#WXEt<>-tIeGLun?*P_wR$M;l(Vy~De3BH-jWyCJ z$xPzGY%Ln0Jv+#LXfGG!XM7*MT*i}W?TDDDYrkv?s(AT@6_e|Nd(fpCu~az_J|^g@ zzE#Cn_VXsnUO?CO=EnXqCA$iL`(2{l*GUH9dcNatSuw&G+@N#X3%0%wwha1*HgnyY zkRzp8b!`mUiPJ7BrdmFd9agU^^z|}2-9bd~w`T+jR)94A*{AhQX5s-J@(0wC!}Fm2 z{_z7s5g!{nmJLWqWT<07K}$k>JT4v{JL)>Hb8Y8<#0$DRMuBR+O3Tro0RaJLXJ_T* z<$zW}aSg5+xW0!5-0lD&o9_b(avF7T>t7DC&C7nQPNjs3Z>QOf#0OVQW zfU&F{fR{B9;XUhk=I%KN7!^)AQIoodRV9a(J;$s)%UfbG^8kZm@18yNf2jp$NX+PmRq zvV6;Pl}?6T(7^uYGYH^s#Iqr@##0t_9z5K+E#4zc!V$Jgj>*eZ@X<-_M;VG9IcNVi zI8>S-wle^oK{JN{_PNyA=7UCMms0DCAC-WJ^&#_^;!$8!jBDfvRPuZY6<2diTzf1BkdQi}NGp)7yQRAJ ziiacgqH#DWrMmk`7tm9!HQo0CNyK4pkvE#u!Ti&RgCrXM&t@dVTmjwgO#<5}ROUSlF15E8gUyrUoB7LKnmZ9oOQ4-w$#I(j9 zYiER=KzaJfY!6$vbDmN3oh7^`=HFwOtGz*%8t<#jOThi1(py!#t%Y_nD34(jMv5()OeUPZ16sR;-(;bH8on4)LyN9=G z+U>(PFMba&89S^xDG~e@ql`p3GEd(qW8S)}o-!8veZrwjub7&o{ z#0GRXEt5l7uJ#!y{p)^khm&P*LN8DwmPe62Sx@7-AKi!@EBei!JqoqJ=7O4`ut517%65m$ts6O!vPZO)h}5XQC>H&heYKVN#Os z7{2|!Wo)C$k)rfZ>0s|(qRn%%d3pw;#8DGxpC`Uj1G5-=GmI_9FLSW3y^;1se7JUE zcIpqMUt`k}({pd|)?%57ss%%K-pBW^bSfsn+!b-?-K5asKr%PUgmZ5VZT&miQeN+q3y1k3?)>c^Ewr{QZ)(0mpJGdq-uWn{ zZ5(V=%cQyW#|5Q3J!hmEM_fRwIXmmY&A6vY=zsr3zctlpNPj3U?HKpmO)Om3`UBjjd@4M?R^IK z6ZF(Si&Q;MHDd33V(>tjQ(wb_)^oRgTv5<3MNFELy{E>c-;aLA&R5Lr@qUCI>7j*F z@p=9Y&xES(SHiPtDhSf_9TdC+VZ-4^5uY8km00Xb=``2+M^?{P+65 zMH|YF)v5Tz5*ky!on@gOiod-1btq+H{A`*-=?0npdB{Xvvg7#`+JsO)y<19J5GCSr7kn@^r5ZN-XK3$Q$YkB`0W_$Ba z7fsl;|x5I?X4YV|q z<=O1~#_1iSa^u`hn1~1B8gG#KS*saPqO*8O%BEOt&IHFo7IYajWV<}RiG+L*3Hl@x zWEyV2r}q`>nL8cuP=H2Hj`cNF7ITb}G#6q3mo z8@0wOcz!D`{D zurG^a5W@SCYm&nS$shA58CXRaL)%Fif2}ZB*Uyzs@%^z9n`;l6lUR|V>F}A@Ec9UH4cW7w*Luwlv8=IP%Faig`te>x1Gz$A3{zflInVxUvlOd{x zKCMB7Hp4_+*Q*?r4orvANuE6PHO{&Ux2>ArPj{Dx2Sm{zCwCQw@db<3!f=@fRXDYN zR07#d8XPyLJDgRvPU%X$S(2M8=FtD|=hC|zJR8?YXo}nj`_XH;O8Gmm=^@e5$(gCy z_ft*VF1|$=YJ|neyMrrDi#G7}drChKn??jvrUHDo3&>-S8A9y6m!=kYDH%?aL$p$Y z0+Mx7d{{V}-rn&<{x@Up`b}!gG~2oKPwmv&@j$5~yGWZLcuwf_J@_vU_^)3jZUPDr zmc}5Jf|3eQ@yQoGb%W*Uk7t!$D+AoFiuti|ah&}8gdYB|O2_f9e*B^PL*i8II(J}O zv$f9Pq_#0US;%&RnDE-`cJ++8g#}i{P&Iqn_}RspJ6~IP%a5|2s7K4bmOgpIW1Ml6 zx^!F5RtVuo)N)6PG{d|yQog^)>g(IHL4n>!hEJZPvg^_!_u(qNXq1Fy#(v$u;&%Rz z#pf>7gVJ7_xrFZ{n%mS)qGP4354M}-uzdwqZ=?`E>_?0@(P(F9=M15Ew<_^;6Z)I3 zi8NbZ6Q+8}j#f2~(&D)>685#G*}9wKC(%xCMrR`eTopcxG3(QO_;Q#`)9RB8ulwZG z)-t$YzQDa5qjUNbFCgIRTi%+Dv?}GVm|B~oyXm6cBW76H`t9Uq;F1M((dSy{w{^Q53n@u>AiEA)-gjMZ!f5~)?VHMga@O=W!()!&Lwy$h4{2IEy z?hAM1UDPL&CJf2#QCd5JudZqZ<5giz8-l_m$#CuB?>ZpO06FU*h_GZLhMFWg`vvGr2LVT*1x- z^Rvum^sicqqts3qI0@XmC^kl1iNo@ zc5Fxfbk;V%YD(#%oOKzzoLgH92i(5B;}t!cQhnk4&UNT$DyFx$7nF{Rh#-m*d_1=P zFf{M251mphco2&uFm&Y=~ylSs-O zT7Ac=Momp^XJfN9AE>QsO$9kie3XDms7_^CO$C$J;PHe$sd={eV+Y}$_)g9)F;#b2 zz!70lc}90(-RiEF`hWC7eKH?%M&?K?xOFL_`}ihNExXTCza@lbP#01zc=WAvx0)ix zaBkQ_hQ>mIgxRFiegmmV)SIS_?gv7uswg?GM_ujhyglm7(P$%MV{tLDm{+ezt~Frl zw8s6>nR_S?M0>0Jdl5w{OEF~~@CRXUWpHR{2vmE4^SuOz(c#P=Y-doY_QuB3)l7F# zqU$I%=Jf1Ly6(XTTS-yT!;{_R-QC^X&?B%vPJwn=Rq~iOcrc|gdJ_>b)?W4q*k2t= zVFQs7hpuR6TymDeG=DaS^T~sDFZUOdZC#u3y?^XI56CTB#X>#SlT}p-5)XqM0_qu2 zO=p+_X)lfJ%eMS7?Ubw0``Yl|;;x@Yqo|)6i3RZ0F!tCh_iS}U7g+#;Z5aIi=g@5zrZmt(y zH3+l4@0CnX#tiL}oFwT2(Yl6)2ENxSYHIb!M|kjl8yg#miHRv}g@uJGs;bzz`tr(3 zeaI!=*yjYU(v>`b9t8)kB%07TxAB$@@_ifREOqyhvaT@xc@1aIM6=i0@YYeO+x;=* zaAT?3ES;X$8h>JIqJ$7!MvT8MJ$*;&s2dsRuQB|zZjgX_s2*~jKp!R{Q>Et4 zH~2TeYj8Sk8#fHwVPR=(FM z5cO18VEP`@rnJnMyd;;v!$;uq(A%k%t39+;oTMc9jBNT~sCsl&ds-y@&EJl)Qs*Ca zD4g{1ljWQX44-ld#S^mR4rWaL)V;+fU9UboDa2V9k{9udQyXR6}oHe zt&cn5NbD+0mLZ(EMYS)9K{{~H#@pLFB;@=9r{S#Ii*Q~@G!!-=QlB!&FMHo)NQpqUqg+kt_iun2zu$72rU0?fu zvBeSoSZ#XQjtlyUAS31Atc?v1V$@VJC~qG?+F0xp~v6=VcBemTol@ z_0P1aOZu%!T-|)Ld=5-GJM#909YTFRJui^!LP2St#~z3)pU@k59hXaAO6~BCXc#1T zaHWZu%=K#mmhWft>Cc7#B(U{46}C)~&_A~!vR5OajOcv-WLK%_QuI&N?A7D?hw@^s zvAw1HYO?ImuqS%Hgu1N#No^#pjF8k0+EVA{MsGos2kYe=7F^DuTiN&Fpr5A4+0A6T zPkWdM`*;_$VoJ5QM*;FhQB|{f?A45SbqYsYWdDv5l8^&%TCnt zQHQnFd;3thJYjS7r2OW0gWR*tjbt6mL)Lc|+G#yUS!3^p!y1>+`^c6NYI>V_(0iXIBjmT1X$m<1e8GEEaGW*8))iL~H`hhTBjd=C}^yvaB2OiZNsHX&BJPxgv?S;=-JJZW`Y@~VB}ev*5>M;w?vD4a>Q;F*>&1XIjdNh z%ttm_Qq)~3+iEf9PGlib&aVq+?kf#`Qi%sRxb?D9Nch=C29{LjA!lOz4Rid(m*(Ey zqjuiGVc@(3Ep+)kQcsHxiA%16%%OI7P{Bn@_LMlG3y@F z-4W@t+J<*CPT_=;Lc&ZiAKFS=H{3Yor?ug08ENM)34WkQi1AytM9*KcF;~RJbDlYK zo(&*Z01AM{>~5O$Fs6|KvT@Rx*-N~{gBvJcRe{q+YjpZg}h@fg=& zrmEcZHzvQNK3l?MYR7b{r#_k5ID^M{7oFdRLu@lj2m5H1)5OSi)KLK#pY!XI)I1F{ zT+pnGf%((?)rndEhUZLnya?VAc-35ixt4{FV(Vgn<+an^zUy&P`E5}Ccd)1B3*BKx zyOPjgoedya>k7Gqd(s{{n-TO>Fj<1d%#6l(()<`^rVvdCN%Vn53llZZ8^ zqwJE+(Sj7?y{M&k;h%&*O)8&Vxx@lZ;wAZhG4Fo0p|v^_=lywjyz^r^rQh0ZN~`GZ z-iGE6C5p_^-q&Es3e3^^Lv`kd-NOIr6K{FCvml$JH+3Vp)*#LvF3M9Hi!4K|J7UAR}Y3V5oY6W90Ud!{QavAKsxp%5pxYbD&#eCO?peNxpBat zuD({Nq;@YBX@JHy&5ob+;FPt;)C$q8ZGA~EBek};dp80qm!zvIEy(6>`C2${?_zRtjMnJhott&3VbD zPV=^yjJ|}Dz6AU}Oz_pEjc@|bPfcOlz4#IfT(>)uV(wA_O8~BWe0i~a-^EYqYy6WL zP8NTj(38GyYNjUIxtj82^g8)5IUQEoCg;)%a4eO!EtR%*=BW|Qsus;j$M9vWvuqI8 z;yq_OUf>pQ&*m*PEiV0rkl_9U3)I{IMWIk>=X12IZ9K(6=*PPR#^#CV*jJeQ^D0H} z!USaY$|j~IzY$+8Z}~`0)FGKD*!4WiDK-Z;9G>QSv?^pa{xH}(qx9Rvf`OYjV%iLC zqnSN#%5J8uL(QLh5Sj8vckI*|Y(%WT^xn%CRCNk@AQBc;b7hx~n46dw`?LNbI5?UA z?n~xtm3bK+t7V1)d1=GOeVds-?^o_7+W8|U;i}nonvJm%1dBn^7%<( z86+(Chk8D_^G!8*w(7M$6%JBZ{P(j0h|kwsH|U{1%(SWJ zQWu7d%gGN$NoajLRpCB)x<(Phc~EPg2wn5o?YAE7Uw#p>2CIM}Hr$GYcGL({TFn@;lb?G+UQEXomzC2M|6U?^um5)VkSRc{_n(r-y+CQqS? z$qpx*n;(EDLCS`R!7W1LHaOW1j;j?yqQQ+Q&)^#D@~+2u6;RWNh>Gt-LND(|@d}`h z4G|HS3Nv7z5fP;V-vr$Lzxr|D{q4}Dur)USZ?Nmy^DO_*s8eiA{QSvxc!H0y*&rb} z@y)Oux5@2~c!{?gOydOw-Ezg<7cB96H2?e8&?nK$NaGG!Vmwlhf4%gH91kC6VqyE6!olGHYV?B*bf_U)i+*TmsGFPHlP6D% zj3yd9mqS8Bk?`9s$w;?$kEN~*Vf#0#%f&?#!(|0B)K#f58d z36Oi=UlXwVw+=KR=Wqb!<&B+q^9s_^(o(sNai^!XvTC4LLg-E>X?BvlKX$&feqr`V zItc8f(s<1-KVAUVpOlo8jAbG045LFj0$+c3S&Cg$v=-CoJoZH$L?^Q;@aOx(Ad^1h zw-bGXDv42cwog>)2_*WY=nUID?712D=FOXg1n+ZeCnqN*C8g%wWSPBKYXxQHXx07U zjlL*S%12b6OTn1psMzZ;e0{^Tw6tQGLr9V?G7fL*4|VU@I9XU&czAw~K9(n(4$mdZ z2Os@dUd`7jA|ogFy=BqtS89g87C;7=HaR(EKAJ_5Z?UjskiGBp#4t-pNN{jGKAm|k z;PWPMyY)B+oP>M+Ja5#&DC}r=ccwkO-E8wU9TdVcSam+C#>8o#)&HJ-ZEcO4lpo&Y zL%2BR?h8Mv&aGu2EWKvp>Kh*)PiByQGzg+8>EZjCC=OB(6~e@{U&+}-wBu{X?orAf z=y`fp@(hBIRki)_Q;Ie~Bf;`PEfzsE-H6T(5J_rlYX>^FwzlZq8Wbh*Q)ce94Dv6! zuCYX`7Mzaf;z2kEv}pl3_>`2C4^cBSGuRW>MF#v?J7Mnjjud&c4^7i{M6>a&WjOo`0s@*8 z6@0X%|Hl->XC0+az{dt;IwZYU4^)slFaS4`PPIvAk_^Nw$XARRLbmbH2a=MF;Keb! zAm(Q2_yq)|Bq-!|e^L#&uK9@*`)^I>-wFdU^0Q*M;#(zeU?4!AD-&n{sr1<}SQ#@i z18g0=Fo}?pioI^oUIRQR8VV51xjz0kSgu##ZQFrfl=0D9yg0@pwY9Zjv6Cgn(qB6v zEI@skLJ#y=lpP&6@E2#ur%WxKAOrHE@|kkx_&X&9g$|JHd<6x%lFkP=pm0OA!6CQr z-aRa_y!eh;{PN`scq<5t-}VA>etw=bwYwRdvgt@?*}uJrpnzzz+yvc;7c_;$~&F1}f!BiV9rI9!TX^6S@{e6AAs>yxnFP zriY!b@kaV0I1w7UxpJlVPY=d*Q<*?@(n+_SJjJNqBnIy2ldbAub0glCgfU)EPfw6g za6BFZlU{3DnrAk0cjf*=^)UcdQf=S0JfIAJ^g(Nn5{q(oaS2vdCCKR5SeGrtr{;O* z%g>)b0|4VPrj=3w!}i0@b4Ks%?+^a|?Q)#LrViFk*7I-l^0#;(-Z}E&7CuKS8s{a= z6!#@MR<1XIXvG5|A+MP#kiXw!mT+7Z-I9iaBzjO%7B- z`Cc0JJ~&x99v&_AI3Kbsdik((@KGr~!S4+oOE34Lypn)Gad2|pHeQ!nx%O~f%4cV@ zq`d8TAy{8u-@RqGH?#o2mK+k}RN>E*smI9gT~NgF)1!eP?|Y6%_$Q0mb%Vn8kq- ztsm64GR57K;^Vpa_^>|rfP4cBKn3G4qX;|S?K7)$kqpJvj5=s(YhRjN2LJg{zluFi z&ax4BQWUTNmyu^zq#hH9am~~?jyL(DqoF{5k9U^3Q=<+K4`H#~uVnjno0_Dqve41d zDH|gVjExaRqWSF(uCDNk=biPaFz)C8K-~I3`)lBah6JW*cGk3sg2Jvk5Kt6>=xe6) zwPNb#vfg}Y9$^ImP*^PZY4l!mo2wi04B1|2MNgGBucVn-1Y<<|_$>c4mtfMl5!B>Q z9zZ{P_w@9D#WiHKWCS6`-b8u^eop6TiKAY}zRJ^vejBgQj2#DFUS7XuxX&bS&CN2{ z)2CCPRT8SIt6xDWWp+A18QTxbU|1u*>vilo0S^Fi@?d>5{G^*HD;bO@w2FtDygG1y z6^FyEudfGV8`ql9WhKSMC+h{tN82a@KvEk!J4Pv=$BiEgZ%v^OU1^?sFAm-{kGF@6 z=JeYHt!CJ(zPXqGr4!JdLV>F?;52*FR*fNZXlkRpzOIf-ULp+>4ZR2DmaJUk#5xZf`#r(^M_kEeEN(RI40f z^WyUIT)EI73yTGiKWzuPQM)Rbq-G6l6BeYTFh zz&+5rYu_#Z$%yvTlEdWi^X2WZW9bzG9I(1mrDjE2|6%j8@|2C&IGQM6u>k%^83Pp3 zR%)FQmvpzmU0^td9Yi!z*aoZ0%eOP#+i2MeG5KLtRq^R9; zY}Fj5w6v4~QL%D4u?o|alT%Y%>@;f@0ZXsyB1ZtS0lzO(%=JH5bab=~0O|i(^>~=s zz(Ul@%1U;dtBFYl=m7b}&kU=O{eYEKQ$r)mUsG9G8AVM}Ze(GRlaUd)*l~qL85A}K z9fq(i`+t(U?`IbH&H7gH7#kTuz*|6AK>MN6`1tsdkr9x(5p|xDNRrN3oox-Suj+VH zb^AV8iT7;%AdgX5>3M##n?y>&P-BXr4BLq^1WZQ>Pgt6*ddjR{x;5ONbYEs#1WVt*;O{e;Qiejal=tt?>No;&fuw@e(7%8G)(>&OGmt-=FuWd>KmHCN z#6akVPIK9pFUm8^Ib~5$Sm3Y5uV3v>_g1ngrrScBtBg;8pBO{Ipy8jd25z4+Gv@@! zxjwv7qNk@vqtQ`OQK|gKuvkz~JtJU4U%iuWPoXr#ifGvZNuZxDQvRG z^WN|UxKSN<%`+Y#$e2gYap9OI;jr@)#=8-CE?!J2AobNV9S?F{->-^800n+6UtFKW5}*B9K3o# zLBT8NKo(6CnXFLI!8$N~=jZ1-mQREhBCZgBu%!d^l!Eb%AAriF^m-OvMMKyu+u7OS zc3r+^PDT6OUMw?}vZW`1#@{{!@SufKeSp!xSa`XV;MU{`GbE{9XCc7YYiNQ5ZwXQp zY%%mKxHvdGG+lS7B_$;_O17pe3#6Apd3DZcfqS=7Q&TY(04JKGFQJ)_gX-e-9&;=7 zFQy*lcKjcZ6TsX}fWpcVKw+DZns(JDGegc`gh^52NT2u62fVzc$mb=KboBJx(G9@7 zz%4|K;uIi(00;-zEnmENAs%i!`dI}A2@faKS*~FGg2C42($-bw=XZ+sbPZ0s)B$EC z%g^ab>(qycJEEeZ10O!t<-SrVqUJN7F4&%-;kPh)^g-@mM9DQ-I?dm*+Afi7K$)<_ z1|5U1x5dOh)-uR)T`DNx?qcTZhqELN19L%EXfiRJLS{&fDfG+M z_YXNampMBTa>Z`}KwY32!9(brZSkP|DxU5QAUTtM=p(#8~{O~*?;@b zz<_D3Q)*T9KCnUBkKWT0?gz-RN9uiT9-&Hlf&$=g7?m2}Ey%Wn>tLFh~jukDsJc?58nWZJl%_A@{u#dMh8VZ~rXCQT#&i~^o z9{;r{>WgX6`wV-s<81}l1OvW7uK^P_-7@SHaK-s}dC70y1m14&dj9K2+MoVaX)N^s zR+hNSvCTAS>tfKIUrvXm~_BOZ-G7#7WV%AQ7}6xA6P-KqY7L}H3m2i=;?q` zpYrLGl>MJ9?$Tu2%4fhX*8-2AzM?{}WD=Y_7zXYJu3pkxQ4=Rf*J9bd<|r&tLu@^QgD^ literal 0 HcmV?d00001 diff --git a/previews/PR237/assets/source_GeometryOps.md.DWxcJS4q.js b/previews/PR237/assets/source_GeometryOps.md.DWxcJS4q.js new file mode 100644 index 000000000..f349397d9 --- /dev/null +++ b/previews/PR237/assets/source_GeometryOps.md.DWxcJS4q.js @@ -0,0 +1,85 @@ +import{_ as i,c as a,a5 as n,o as l}from"./chunks/framework.Cq8AuEls.js";const g=JSON.parse('{"title":"GeometryOps.jl","description":"","frontmatter":{},"headers":[],"relativePath":"source/GeometryOps.md","filePath":"source/GeometryOps.md","lastUpdated":null}'),t={name:"source/GeometryOps.md"};function h(p,s,k,e,E,r){return l(),a("div",null,s[0]||(s[0]=[n(`

GeometryOps.jl

julia
module GeometryOps
+
+import GeometryOpsCore
+import GeometryOpsCore:
+                TraitTarget,
+                Manifold, Planar, Spherical, Geodesic,
+                BoolsAsTypes, _True, _False, _booltype,
+                apply, applyreduce,
+                flatten, reconstruct, rebuild, unwrap, _linearring,
+                APPLY_KEYWORDS, THREADED_KEYWORD, CRS_KEYWORD, CALC_EXTENT_KEYWORD
+
+export TraitTarget, Manifold, Planar, Spherical, Geodesic, apply, applyreduce, flatten, reconstruct, rebuild, unwrap
+
+using GeoInterface
+using GeometryBasics
+using LinearAlgebra, Statistics
+
+import Tables, DataAPI
+import GeometryBasics.StaticArrays
+import DelaunayTriangulation # for convex hull and triangulation
+import ExactPredicates
+import Base.@kwdef
+import GeoInterface.Extents: Extents
+
+const GI = GeoInterface
+const GB = GeometryBasics
+
+const TuplePoint{T} = Tuple{T, T} where T <: AbstractFloat
+const Edge{T} = Tuple{TuplePoint{T},TuplePoint{T}} where T
+
+include("types.jl")
+include("primitives.jl")
+include("utils.jl")
+include("not_implemented_yet.jl")
+
+include("methods/angles.jl")
+include("methods/area.jl")
+include("methods/barycentric.jl")
+include("methods/buffer.jl")
+include("methods/centroid.jl")
+include("methods/convex_hull.jl")
+include("methods/distance.jl")
+include("methods/equals.jl")
+include("methods/clipping/predicates.jl")
+include("methods/clipping/clipping_processor.jl")
+include("methods/clipping/coverage.jl")
+include("methods/clipping/cut.jl")
+include("methods/clipping/intersection.jl")
+include("methods/clipping/difference.jl")
+include("methods/clipping/union.jl")
+include("methods/geom_relations/contains.jl")
+include("methods/geom_relations/coveredby.jl")
+include("methods/geom_relations/covers.jl")
+include("methods/geom_relations/crosses.jl")
+include("methods/geom_relations/disjoint.jl")
+include("methods/geom_relations/geom_geom_processors.jl")
+include("methods/geom_relations/intersects.jl")
+include("methods/geom_relations/overlaps.jl")
+include("methods/geom_relations/touches.jl")
+include("methods/geom_relations/within.jl")
+include("methods/orientation.jl")
+include("methods/polygonize.jl")
+
+include("transformations/extent.jl")
+include("transformations/flip.jl")
+include("transformations/reproject.jl")
+include("transformations/segmentize.jl")
+include("transformations/simplify.jl")
+include("transformations/tuples.jl")
+include("transformations/transform.jl")
+include("transformations/correction/geometry_correction.jl")
+include("transformations/correction/closed_ring.jl")
+include("transformations/correction/intersecting_polygons.jl")

Import all names from GeoInterface and Extents, so users can do GO.extent or GO.trait.

julia
for name in names(GeoInterface)
+    @eval using GeoInterface: $name
+end
+for name in names(Extents)
+    @eval using GeoInterface.Extents: $name
+end
+
+function __init__()

Handle all available errors!

julia
    Base.Experimental.register_error_hint(_reproject_error_hinter, MethodError)
+    Base.Experimental.register_error_hint(_geodesic_segments_error_hinter, MethodError)
+    Base.Experimental.register_error_hint(_buffer_error_hinter, MethodError)
+end
+
+end

This page was generated using Literate.jl.

`,8)]))}const o=i(t,[["render",h]]);export{g as __pageData,o as default}; diff --git a/previews/PR237/assets/source_GeometryOps.md.DWxcJS4q.lean.js b/previews/PR237/assets/source_GeometryOps.md.DWxcJS4q.lean.js new file mode 100644 index 000000000..f349397d9 --- /dev/null +++ b/previews/PR237/assets/source_GeometryOps.md.DWxcJS4q.lean.js @@ -0,0 +1,85 @@ +import{_ as i,c as a,a5 as n,o as l}from"./chunks/framework.Cq8AuEls.js";const g=JSON.parse('{"title":"GeometryOps.jl","description":"","frontmatter":{},"headers":[],"relativePath":"source/GeometryOps.md","filePath":"source/GeometryOps.md","lastUpdated":null}'),t={name:"source/GeometryOps.md"};function h(p,s,k,e,E,r){return l(),a("div",null,s[0]||(s[0]=[n(`

GeometryOps.jl

julia
module GeometryOps
+
+import GeometryOpsCore
+import GeometryOpsCore:
+                TraitTarget,
+                Manifold, Planar, Spherical, Geodesic,
+                BoolsAsTypes, _True, _False, _booltype,
+                apply, applyreduce,
+                flatten, reconstruct, rebuild, unwrap, _linearring,
+                APPLY_KEYWORDS, THREADED_KEYWORD, CRS_KEYWORD, CALC_EXTENT_KEYWORD
+
+export TraitTarget, Manifold, Planar, Spherical, Geodesic, apply, applyreduce, flatten, reconstruct, rebuild, unwrap
+
+using GeoInterface
+using GeometryBasics
+using LinearAlgebra, Statistics
+
+import Tables, DataAPI
+import GeometryBasics.StaticArrays
+import DelaunayTriangulation # for convex hull and triangulation
+import ExactPredicates
+import Base.@kwdef
+import GeoInterface.Extents: Extents
+
+const GI = GeoInterface
+const GB = GeometryBasics
+
+const TuplePoint{T} = Tuple{T, T} where T <: AbstractFloat
+const Edge{T} = Tuple{TuplePoint{T},TuplePoint{T}} where T
+
+include("types.jl")
+include("primitives.jl")
+include("utils.jl")
+include("not_implemented_yet.jl")
+
+include("methods/angles.jl")
+include("methods/area.jl")
+include("methods/barycentric.jl")
+include("methods/buffer.jl")
+include("methods/centroid.jl")
+include("methods/convex_hull.jl")
+include("methods/distance.jl")
+include("methods/equals.jl")
+include("methods/clipping/predicates.jl")
+include("methods/clipping/clipping_processor.jl")
+include("methods/clipping/coverage.jl")
+include("methods/clipping/cut.jl")
+include("methods/clipping/intersection.jl")
+include("methods/clipping/difference.jl")
+include("methods/clipping/union.jl")
+include("methods/geom_relations/contains.jl")
+include("methods/geom_relations/coveredby.jl")
+include("methods/geom_relations/covers.jl")
+include("methods/geom_relations/crosses.jl")
+include("methods/geom_relations/disjoint.jl")
+include("methods/geom_relations/geom_geom_processors.jl")
+include("methods/geom_relations/intersects.jl")
+include("methods/geom_relations/overlaps.jl")
+include("methods/geom_relations/touches.jl")
+include("methods/geom_relations/within.jl")
+include("methods/orientation.jl")
+include("methods/polygonize.jl")
+
+include("transformations/extent.jl")
+include("transformations/flip.jl")
+include("transformations/reproject.jl")
+include("transformations/segmentize.jl")
+include("transformations/simplify.jl")
+include("transformations/tuples.jl")
+include("transformations/transform.jl")
+include("transformations/correction/geometry_correction.jl")
+include("transformations/correction/closed_ring.jl")
+include("transformations/correction/intersecting_polygons.jl")

Import all names from GeoInterface and Extents, so users can do GO.extent or GO.trait.

julia
for name in names(GeoInterface)
+    @eval using GeoInterface: $name
+end
+for name in names(Extents)
+    @eval using GeoInterface.Extents: $name
+end
+
+function __init__()

Handle all available errors!

julia
    Base.Experimental.register_error_hint(_reproject_error_hinter, MethodError)
+    Base.Experimental.register_error_hint(_geodesic_segments_error_hinter, MethodError)
+    Base.Experimental.register_error_hint(_buffer_error_hinter, MethodError)
+end
+
+end

This page was generated using Literate.jl.

`,8)]))}const o=i(t,[["render",h]]);export{g as __pageData,o as default}; diff --git a/previews/PR237/assets/source_GeometryOpsFlexiJoinsExt_GeometryOpsFlexiJoinsExt.md.Cb0F4T1E.js b/previews/PR237/assets/source_GeometryOpsFlexiJoinsExt_GeometryOpsFlexiJoinsExt.md.Cb0F4T1E.js new file mode 100644 index 000000000..dab314569 --- /dev/null +++ b/previews/PR237/assets/source_GeometryOpsFlexiJoinsExt_GeometryOpsFlexiJoinsExt.md.Cb0F4T1E.js @@ -0,0 +1,16 @@ +import{_ as i,c as a,a5 as h,o as t}from"./chunks/framework.Cq8AuEls.js";const g=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"source/GeometryOpsFlexiJoinsExt/GeometryOpsFlexiJoinsExt.md","filePath":"source/GeometryOpsFlexiJoinsExt/GeometryOpsFlexiJoinsExt.md","lastUpdated":null}'),n={name:"source/GeometryOpsFlexiJoinsExt/GeometryOpsFlexiJoinsExt.md"};function e(k,s,p,l,d,r){return t(),a("div",null,s[0]||(s[0]=[h(`
julia
module GeometryOpsFlexiJoinsExt
+
+using GeometryOps
+using FlexiJoins
+
+import GeometryOps as GO, GeoInterface as GI
+using SortTileRecursiveTree, Tables

This module defines the FlexiJoins APIs for GeometryOps' boolean comparison functions, taken from DE-9IM.

First, we define the joining modes (Tree, NestedLoopFast) that the GO DE-9IM functions support.

julia
const GO_DE9IM_FUNCS = Union{typeof(GO.contains), typeof(GO.within), typeof(GO.intersects), typeof(GO.disjoint), typeof(GO.touches), typeof(GO.crosses), typeof(GO.overlaps), typeof(GO.covers), typeof(GO.coveredby), typeof(GO.equals)}

NestedLoopFast is the naive fallback method

julia
FlexiJoins.supports_mode(::FlexiJoins.Mode.NestedLoopFast, ::FlexiJoins.ByPred{F}, datas) where F <: GO_DE9IM_FUNCS = true

This method allows you to cache a tree, which we do by using an STRtree. TODO: wrap GO predicate functions in a TreeJoiner struct or something, to indicate that we want to use trees, since they can be slower in some situations.

julia
FlexiJoins.supports_mode(::FlexiJoins.Mode.Tree, ::FlexiJoins.ByPred{F}, datas) where F <: GO_DE9IM_FUNCS = true

Nested loop support is simple, and needs no further support. However, for trees, we need to define how the tree is prepared and how it is used. This is done by defining the prepare_for_join function to return an STRTree, and by defining the findmatchix function as querying that tree before checking intersections.

In theory, one could extract the tree from e.g a GeoPackage or some future GeoDataFrame.

julia
FlexiJoins.prepare_for_join(::FlexiJoins.Mode.Tree, X, cond::FlexiJoins.ByPred{<: GO_DE9IM_FUNCS}) = (X, SortTileRecursiveTree.STRtree(map(cond.Rf, X)))
+function FlexiJoins.findmatchix(::FlexiJoins.Mode.Tree, cond::FlexiJoins.ByPred{F}, ix_a, a, (B, tree)::Tuple, multi::typeof(identity)) where F <: GO_DE9IM_FUNCS

Implementation note: here, a is a row, and b is the full table. We extract the relevant columns using cond.Lf and cond.Rf.

julia
    idxs = SortTileRecursiveTree.query(tree, cond.Lf(a))
+    intersecting_idxs = filter!(idxs) do idx
+        cond.pred(cond.Lf(a), cond.Rf(B[idx]))
+    end
+    return intersecting_idxs
+end

Finally, for completeness, we define the swap_sides function for those predicates which are defined as inversions.

julia
FlexiJoins.swap_sides(::typeof(GO.contains)) = GO.within
+FlexiJoins.swap_sides(::typeof(GO.within)) = GO.contains
+FlexiJoins.swap_sides(::typeof(GO.coveredby)) = GO.covers
+FlexiJoins.swap_sides(::typeof(GO.covers)) = GO.coveredby

That's a wrap, folks!

julia
end

This page was generated using Literate.jl.

`,19)]))}const y=i(n,[["render",e]]);export{g as __pageData,y as default}; diff --git a/previews/PR237/assets/source_GeometryOpsFlexiJoinsExt_GeometryOpsFlexiJoinsExt.md.Cb0F4T1E.lean.js b/previews/PR237/assets/source_GeometryOpsFlexiJoinsExt_GeometryOpsFlexiJoinsExt.md.Cb0F4T1E.lean.js new file mode 100644 index 000000000..dab314569 --- /dev/null +++ b/previews/PR237/assets/source_GeometryOpsFlexiJoinsExt_GeometryOpsFlexiJoinsExt.md.Cb0F4T1E.lean.js @@ -0,0 +1,16 @@ +import{_ as i,c as a,a5 as h,o as t}from"./chunks/framework.Cq8AuEls.js";const g=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"source/GeometryOpsFlexiJoinsExt/GeometryOpsFlexiJoinsExt.md","filePath":"source/GeometryOpsFlexiJoinsExt/GeometryOpsFlexiJoinsExt.md","lastUpdated":null}'),n={name:"source/GeometryOpsFlexiJoinsExt/GeometryOpsFlexiJoinsExt.md"};function e(k,s,p,l,d,r){return t(),a("div",null,s[0]||(s[0]=[h(`
julia
module GeometryOpsFlexiJoinsExt
+
+using GeometryOps
+using FlexiJoins
+
+import GeometryOps as GO, GeoInterface as GI
+using SortTileRecursiveTree, Tables

This module defines the FlexiJoins APIs for GeometryOps' boolean comparison functions, taken from DE-9IM.

First, we define the joining modes (Tree, NestedLoopFast) that the GO DE-9IM functions support.

julia
const GO_DE9IM_FUNCS = Union{typeof(GO.contains), typeof(GO.within), typeof(GO.intersects), typeof(GO.disjoint), typeof(GO.touches), typeof(GO.crosses), typeof(GO.overlaps), typeof(GO.covers), typeof(GO.coveredby), typeof(GO.equals)}

NestedLoopFast is the naive fallback method

julia
FlexiJoins.supports_mode(::FlexiJoins.Mode.NestedLoopFast, ::FlexiJoins.ByPred{F}, datas) where F <: GO_DE9IM_FUNCS = true

This method allows you to cache a tree, which we do by using an STRtree. TODO: wrap GO predicate functions in a TreeJoiner struct or something, to indicate that we want to use trees, since they can be slower in some situations.

julia
FlexiJoins.supports_mode(::FlexiJoins.Mode.Tree, ::FlexiJoins.ByPred{F}, datas) where F <: GO_DE9IM_FUNCS = true

Nested loop support is simple, and needs no further support. However, for trees, we need to define how the tree is prepared and how it is used. This is done by defining the prepare_for_join function to return an STRTree, and by defining the findmatchix function as querying that tree before checking intersections.

In theory, one could extract the tree from e.g a GeoPackage or some future GeoDataFrame.

julia
FlexiJoins.prepare_for_join(::FlexiJoins.Mode.Tree, X, cond::FlexiJoins.ByPred{<: GO_DE9IM_FUNCS}) = (X, SortTileRecursiveTree.STRtree(map(cond.Rf, X)))
+function FlexiJoins.findmatchix(::FlexiJoins.Mode.Tree, cond::FlexiJoins.ByPred{F}, ix_a, a, (B, tree)::Tuple, multi::typeof(identity)) where F <: GO_DE9IM_FUNCS

Implementation note: here, a is a row, and b is the full table. We extract the relevant columns using cond.Lf and cond.Rf.

julia
    idxs = SortTileRecursiveTree.query(tree, cond.Lf(a))
+    intersecting_idxs = filter!(idxs) do idx
+        cond.pred(cond.Lf(a), cond.Rf(B[idx]))
+    end
+    return intersecting_idxs
+end

Finally, for completeness, we define the swap_sides function for those predicates which are defined as inversions.

julia
FlexiJoins.swap_sides(::typeof(GO.contains)) = GO.within
+FlexiJoins.swap_sides(::typeof(GO.within)) = GO.contains
+FlexiJoins.swap_sides(::typeof(GO.coveredby)) = GO.covers
+FlexiJoins.swap_sides(::typeof(GO.covers)) = GO.coveredby

That's a wrap, folks!

julia
end

This page was generated using Literate.jl.

`,19)]))}const y=i(n,[["render",e]]);export{g as __pageData,y as default}; diff --git a/previews/PR237/assets/source_GeometryOpsLibGEOSExt_GeometryOpsLibGEOSExt.md.SUH-wZv2.js b/previews/PR237/assets/source_GeometryOpsLibGEOSExt_GeometryOpsLibGEOSExt.md.SUH-wZv2.js new file mode 100644 index 000000000..943b900bd --- /dev/null +++ b/previews/PR237/assets/source_GeometryOpsLibGEOSExt_GeometryOpsLibGEOSExt.md.SUH-wZv2.js @@ -0,0 +1,31 @@ +import{_ as i,c as a,a5 as n,o as t}from"./chunks/framework.Cq8AuEls.js";const o=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"source/GeometryOpsLibGEOSExt/GeometryOpsLibGEOSExt.md","filePath":"source/GeometryOpsLibGEOSExt/GeometryOpsLibGEOSExt.md","lastUpdated":null}'),e={name:"source/GeometryOpsLibGEOSExt/GeometryOpsLibGEOSExt.md"};function l(h,s,p,k,r,E){return t(),a("div",null,s[0]||(s[0]=[n(`
julia
module GeometryOpsLibGEOSExt
+
+import GeometryOps as GO, LibGEOS as LG
+import GeoInterface as GI
+
+import GeometryOps: GEOS, enforce, _True, _False, _booltype
+
+using GeometryOps

The filter statement is required because in Julia, each module has its own versions of these functions, which serve to evaluate or include code inside the scope of the module. However, if you import those from another module (which you would with all=true), that creates an ambiguity which causes a warning during precompile/load time. In order to avoid this, we filter out these special functions.

julia
for name in filter(!in((:var"#eval", :eval, :var"#include", :include)), names(GeometryOps))
+    @eval import GeometryOps: $name
+end
+
+"""
+    _wrap(geom; crs, calc_extent)
+
+Wraps \`geom\` in a GI wrapper geometry of its geometry trait.  This allows us
+to attach CRS and extent info to geometry types which otherwise could not hold
+those, like LibGEOS and WKB geometries.
+
+Returns a GI wrapper geometry, for which \`parent(result) == geom\`.
+"""
+function _wrap(geom; crs=GI.crs(geom), calc_extent = true)
+    return GI.geointerface_geomtype(GI.geomtrait(geom))(geom; crs, extent = GI.extent(geom, calc_extent))
+end
+
+include("buffer.jl")
+include("segmentize.jl")
+include("simplify.jl")
+
+include("simple_overrides.jl")
+
+end

This page was generated using Literate.jl.

`,5)]))}const g=i(e,[["render",l]]);export{o as __pageData,g as default}; diff --git a/previews/PR237/assets/source_GeometryOpsLibGEOSExt_GeometryOpsLibGEOSExt.md.SUH-wZv2.lean.js b/previews/PR237/assets/source_GeometryOpsLibGEOSExt_GeometryOpsLibGEOSExt.md.SUH-wZv2.lean.js new file mode 100644 index 000000000..943b900bd --- /dev/null +++ b/previews/PR237/assets/source_GeometryOpsLibGEOSExt_GeometryOpsLibGEOSExt.md.SUH-wZv2.lean.js @@ -0,0 +1,31 @@ +import{_ as i,c as a,a5 as n,o as t}from"./chunks/framework.Cq8AuEls.js";const o=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"source/GeometryOpsLibGEOSExt/GeometryOpsLibGEOSExt.md","filePath":"source/GeometryOpsLibGEOSExt/GeometryOpsLibGEOSExt.md","lastUpdated":null}'),e={name:"source/GeometryOpsLibGEOSExt/GeometryOpsLibGEOSExt.md"};function l(h,s,p,k,r,E){return t(),a("div",null,s[0]||(s[0]=[n(`
julia
module GeometryOpsLibGEOSExt
+
+import GeometryOps as GO, LibGEOS as LG
+import GeoInterface as GI
+
+import GeometryOps: GEOS, enforce, _True, _False, _booltype
+
+using GeometryOps

The filter statement is required because in Julia, each module has its own versions of these functions, which serve to evaluate or include code inside the scope of the module. However, if you import those from another module (which you would with all=true), that creates an ambiguity which causes a warning during precompile/load time. In order to avoid this, we filter out these special functions.

julia
for name in filter(!in((:var"#eval", :eval, :var"#include", :include)), names(GeometryOps))
+    @eval import GeometryOps: $name
+end
+
+"""
+    _wrap(geom; crs, calc_extent)
+
+Wraps \`geom\` in a GI wrapper geometry of its geometry trait.  This allows us
+to attach CRS and extent info to geometry types which otherwise could not hold
+those, like LibGEOS and WKB geometries.
+
+Returns a GI wrapper geometry, for which \`parent(result) == geom\`.
+"""
+function _wrap(geom; crs=GI.crs(geom), calc_extent = true)
+    return GI.geointerface_geomtype(GI.geomtrait(geom))(geom; crs, extent = GI.extent(geom, calc_extent))
+end
+
+include("buffer.jl")
+include("segmentize.jl")
+include("simplify.jl")
+
+include("simple_overrides.jl")
+
+end

This page was generated using Literate.jl.

`,5)]))}const g=i(e,[["render",l]]);export{o as __pageData,g as default}; diff --git a/previews/PR237/assets/source_GeometryOpsLibGEOSExt_buffer.md.BBYR_g1c.js b/previews/PR237/assets/source_GeometryOpsLibGEOSExt_buffer.md.BBYR_g1c.js new file mode 100644 index 000000000..8ee1eb096 --- /dev/null +++ b/previews/PR237/assets/source_GeometryOpsLibGEOSExt_buffer.md.BBYR_g1c.js @@ -0,0 +1,31 @@ +import{_ as i,c as a,a5 as n,o as h}from"./chunks/framework.Cq8AuEls.js";const d=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"source/GeometryOpsLibGEOSExt/buffer.md","filePath":"source/GeometryOpsLibGEOSExt/buffer.md","lastUpdated":null}'),k={name:"source/GeometryOpsLibGEOSExt/buffer.md"};function t(l,s,p,e,E,r){return h(),a("div",null,s[0]||(s[0]=[n(`
julia
const _GEOS_CAPSTYLE_LOOKUP = Dict{Symbol, LG.GEOSBufCapStyles}(
+    :round => LG.GEOSBUF_CAP_ROUND,
+    :flat => LG.GEOSBUF_CAP_FLAT,
+    :square => LG.GEOSBUF_CAP_SQUARE,
+)
+
+const _GEOS_JOINSTYLE_LOOKUP = Dict{Symbol, LG.GEOSBufJoinStyles}(
+    :round => LG.GEOSBUF_JOIN_ROUND,
+    :mitre => LG.GEOSBUF_JOIN_MITRE,
+    :bevel => LG.GEOSBUF_JOIN_BEVEL,
+)
+
+to_cap_style(style::Symbol) = _GEOS_CAPSTYLE_LOOKUP[style]
+to_cap_style(style::LG.GEOSBufCapStyles) = style
+to_cap_style(num::Integer) = num
+
+to_join_style(style::Symbol) = _GEOS_JOINSTYLE_LOOKUP[style]
+to_join_style(style::LG.GEOSBufJoinStyles) = style
+to_join_style(num::Integer) = num
+
+function GO.buffer(alg::GEOS, geometry, distance; calc_extent = true, kwargs...)

The reason we use apply here is so that this also works with featurecollections, tables, vectors of geometries, etc!

julia
    return apply(TraitTarget{GI.AbstractGeometryTrait}(), geometry; kwargs...) do geom
+        newgeom = LG.bufferWithStyle(
+            GI.convert(LG, geom), distance;
+            quadsegs = get(alg, :quadsegs, 8),
+            endCapStyle = to_cap_style(get(alg, :endCapStyle, :round)),
+            joinStyle = to_join_style(get(alg, :joinStyle, :round)),
+            mitreLimit = get(alg, :mitreLimit, 5.0),
+        )
+        return _wrap(newgeom; crs = GI.crs(geom), calc_extent)
+    end
+end

This page was generated using Literate.jl.

`,5)]))}const y=i(k,[["render",t]]);export{d as __pageData,y as default}; diff --git a/previews/PR237/assets/source_GeometryOpsLibGEOSExt_buffer.md.BBYR_g1c.lean.js b/previews/PR237/assets/source_GeometryOpsLibGEOSExt_buffer.md.BBYR_g1c.lean.js new file mode 100644 index 000000000..8ee1eb096 --- /dev/null +++ b/previews/PR237/assets/source_GeometryOpsLibGEOSExt_buffer.md.BBYR_g1c.lean.js @@ -0,0 +1,31 @@ +import{_ as i,c as a,a5 as n,o as h}from"./chunks/framework.Cq8AuEls.js";const d=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"source/GeometryOpsLibGEOSExt/buffer.md","filePath":"source/GeometryOpsLibGEOSExt/buffer.md","lastUpdated":null}'),k={name:"source/GeometryOpsLibGEOSExt/buffer.md"};function t(l,s,p,e,E,r){return h(),a("div",null,s[0]||(s[0]=[n(`
julia
const _GEOS_CAPSTYLE_LOOKUP = Dict{Symbol, LG.GEOSBufCapStyles}(
+    :round => LG.GEOSBUF_CAP_ROUND,
+    :flat => LG.GEOSBUF_CAP_FLAT,
+    :square => LG.GEOSBUF_CAP_SQUARE,
+)
+
+const _GEOS_JOINSTYLE_LOOKUP = Dict{Symbol, LG.GEOSBufJoinStyles}(
+    :round => LG.GEOSBUF_JOIN_ROUND,
+    :mitre => LG.GEOSBUF_JOIN_MITRE,
+    :bevel => LG.GEOSBUF_JOIN_BEVEL,
+)
+
+to_cap_style(style::Symbol) = _GEOS_CAPSTYLE_LOOKUP[style]
+to_cap_style(style::LG.GEOSBufCapStyles) = style
+to_cap_style(num::Integer) = num
+
+to_join_style(style::Symbol) = _GEOS_JOINSTYLE_LOOKUP[style]
+to_join_style(style::LG.GEOSBufJoinStyles) = style
+to_join_style(num::Integer) = num
+
+function GO.buffer(alg::GEOS, geometry, distance; calc_extent = true, kwargs...)

The reason we use apply here is so that this also works with featurecollections, tables, vectors of geometries, etc!

julia
    return apply(TraitTarget{GI.AbstractGeometryTrait}(), geometry; kwargs...) do geom
+        newgeom = LG.bufferWithStyle(
+            GI.convert(LG, geom), distance;
+            quadsegs = get(alg, :quadsegs, 8),
+            endCapStyle = to_cap_style(get(alg, :endCapStyle, :round)),
+            joinStyle = to_join_style(get(alg, :joinStyle, :round)),
+            mitreLimit = get(alg, :mitreLimit, 5.0),
+        )
+        return _wrap(newgeom; crs = GI.crs(geom), calc_extent)
+    end
+end

This page was generated using Literate.jl.

`,5)]))}const y=i(k,[["render",t]]);export{d as __pageData,y as default}; diff --git a/previews/PR237/assets/source_GeometryOpsLibGEOSExt_segmentize.md.BqXn7mYP.js b/previews/PR237/assets/source_GeometryOpsLibGEOSExt_segmentize.md.BqXn7mYP.js new file mode 100644 index 000000000..2fe2a01e3 --- /dev/null +++ b/previews/PR237/assets/source_GeometryOpsLibGEOSExt_segmentize.md.BqXn7mYP.js @@ -0,0 +1,21 @@ +import{_ as i,c as a,a5 as n,o as t}from"./chunks/framework.Cq8AuEls.js";const g=JSON.parse('{"title":"Segmentize","description":"","frontmatter":{},"headers":[],"relativePath":"source/GeometryOpsLibGEOSExt/segmentize.md","filePath":"source/GeometryOpsLibGEOSExt/segmentize.md","lastUpdated":null}'),e={name:"source/GeometryOpsLibGEOSExt/segmentize.md"};function h(k,s,l,p,r,E){return t(),a("div",null,s[0]||(s[0]=[n(`

Segmentize

julia
import GeometryOps: segmentize, apply

This file implements the LibGEOS segmentization method for GeometryOps.

julia
function _segmentize_geos(geom::LG.AbstractGeometry, max_distance)
+    context = LG.get_context(geom)
+    result = LG.GEOSDensify_r(context, geom, max_distance)
+    if result == C_NULL
+        error("LibGEOS: Error in GEOSDensify")
+    end
+    return LG.geomFromGEOS(result, context)
+end
+
+_segmentize_geos(geom, max_distance) = _segmentize_geos(GI.convert(LG, geom), max_distance)
+
+function _wrap_and_segmentize_geos(geom, max_distance)
+    _wrap(_segmentize_geos(geom, max_distance); crs = GI.crs(geom), calc_extent = false)
+end

2 behaviours:

  • enforce: enforce the presence of a kwargs

  • fetch: fetch the value of a kwargs, or return a default value

julia
@inline function GO.segmentize(alg::GEOS, geom; threaded::Union{Bool, GO.BoolsAsTypes} = _False())
+    max_distance = enforce(alg, :max_distance, GO.segmentize)
+    return GO.apply(
+        Base.Fix2(_wrap_and_segmentize_geos, max_distance),

TODO: should this just be a target on GI.AbstractGeometryTrait()? But Geos doesn't support eg RectangleTrait Maybe we need an abstract trait GI.AbstractWKBGeomTrait?

julia
        GO.TraitTarget(GI.GeometryCollectionTrait(), GI.MultiPolygonTrait(), GI.PolygonTrait(), GI.MultiLineStringTrait(), GI.LineStringTrait(), GI.LinearRingTrait(), GI.MultiPointTrait(), GI.PointTrait()),
+        geom;
+        threaded
+    )
+end

This page was generated using Literate.jl.

`,11)]))}const y=i(e,[["render",h]]);export{g as __pageData,y as default}; diff --git a/previews/PR237/assets/source_GeometryOpsLibGEOSExt_segmentize.md.BqXn7mYP.lean.js b/previews/PR237/assets/source_GeometryOpsLibGEOSExt_segmentize.md.BqXn7mYP.lean.js new file mode 100644 index 000000000..2fe2a01e3 --- /dev/null +++ b/previews/PR237/assets/source_GeometryOpsLibGEOSExt_segmentize.md.BqXn7mYP.lean.js @@ -0,0 +1,21 @@ +import{_ as i,c as a,a5 as n,o as t}from"./chunks/framework.Cq8AuEls.js";const g=JSON.parse('{"title":"Segmentize","description":"","frontmatter":{},"headers":[],"relativePath":"source/GeometryOpsLibGEOSExt/segmentize.md","filePath":"source/GeometryOpsLibGEOSExt/segmentize.md","lastUpdated":null}'),e={name:"source/GeometryOpsLibGEOSExt/segmentize.md"};function h(k,s,l,p,r,E){return t(),a("div",null,s[0]||(s[0]=[n(`

Segmentize

julia
import GeometryOps: segmentize, apply

This file implements the LibGEOS segmentization method for GeometryOps.

julia
function _segmentize_geos(geom::LG.AbstractGeometry, max_distance)
+    context = LG.get_context(geom)
+    result = LG.GEOSDensify_r(context, geom, max_distance)
+    if result == C_NULL
+        error("LibGEOS: Error in GEOSDensify")
+    end
+    return LG.geomFromGEOS(result, context)
+end
+
+_segmentize_geos(geom, max_distance) = _segmentize_geos(GI.convert(LG, geom), max_distance)
+
+function _wrap_and_segmentize_geos(geom, max_distance)
+    _wrap(_segmentize_geos(geom, max_distance); crs = GI.crs(geom), calc_extent = false)
+end

2 behaviours:

  • enforce: enforce the presence of a kwargs

  • fetch: fetch the value of a kwargs, or return a default value

julia
@inline function GO.segmentize(alg::GEOS, geom; threaded::Union{Bool, GO.BoolsAsTypes} = _False())
+    max_distance = enforce(alg, :max_distance, GO.segmentize)
+    return GO.apply(
+        Base.Fix2(_wrap_and_segmentize_geos, max_distance),

TODO: should this just be a target on GI.AbstractGeometryTrait()? But Geos doesn't support eg RectangleTrait Maybe we need an abstract trait GI.AbstractWKBGeomTrait?

julia
        GO.TraitTarget(GI.GeometryCollectionTrait(), GI.MultiPolygonTrait(), GI.PolygonTrait(), GI.MultiLineStringTrait(), GI.LineStringTrait(), GI.LinearRingTrait(), GI.MultiPointTrait(), GI.PointTrait()),
+        geom;
+        threaded
+    )
+end

This page was generated using Literate.jl.

`,11)]))}const y=i(e,[["render",h]]);export{g as __pageData,y as default}; diff --git a/previews/PR237/assets/source_GeometryOpsLibGEOSExt_simple_overrides.md.B0O49YKH.js b/previews/PR237/assets/source_GeometryOpsLibGEOSExt_simple_overrides.md.B0O49YKH.js new file mode 100644 index 000000000..b502c4609 --- /dev/null +++ b/previews/PR237/assets/source_GeometryOpsLibGEOSExt_simple_overrides.md.B0O49YKH.js @@ -0,0 +1,46 @@ +import{_ as i,c as a,a5 as h,o as n}from"./chunks/framework.Cq8AuEls.js";const g=JSON.parse('{"title":"Simple overrides","description":"","frontmatter":{},"headers":[],"relativePath":"source/GeometryOpsLibGEOSExt/simple_overrides.md","filePath":"source/GeometryOpsLibGEOSExt/simple_overrides.md","lastUpdated":null}'),t={name:"source/GeometryOpsLibGEOSExt/simple_overrides.md"};function k(l,s,e,p,r,d){return n(),a("div",null,s[0]||(s[0]=[h(`

Simple overrides

This file contains simple overrides for GEOS, essentially only those functions which have direct counterparts in LG and only require conversion before calling.

Polygon set operations

Difference

julia
function GO.difference(::GEOS, geom_a, geom_b; target=nothing, calc_extent = false)
+    return _wrap(LG.difference(GI.convert(LG, geom_a), GI.convert(LG, geom_b)); crs = GI.crs(geom_a), calc_extent)
+end

Union

julia
function GO.union(::GEOS, geom_a, geom_b; target=nothing, calc_extent = false)
+    return _wrap(LG.union(GI.convert(LG, geom_a), GI.convert(LG, geom_b)); crs = GI.crs(geom_a), calc_extent)
+end

Intersection

julia
function GO.intersection(::GEOS, geom_a, geom_b; target=nothing, calc_extent = false)
+    return _wrap(LG.intersection(GI.convert(LG, geom_a), GI.convert(LG, geom_b)); crs = GI.crs(geom_a), calc_extent)
+end

Symmetric difference

julia
function GO.symdifference(::GEOS, geom_a, geom_b; target=nothing, calc_extent = false)
+    return _wrap(LG.symmetric_difference(GI.convert(LG, geom_a), GI.convert(LG, geom_b)); crs = GI.crs(geom_a), calc_extent)
+end

DE-9IM boolean methods

Equals

julia
function GO.equals(::GEOS, geom_a, geom_b)
+    return LG.equals(GI.convert(LG, geom_a), GI.convert(LG, geom_b))
+end

Disjoint

julia
function GO.disjoint(::GEOS, geom_a, geom_b)
+    return LG.disjoint(GI.convert(LG, geom_a), GI.convert(LG, geom_b))
+end

Touches

julia
function GO.touches(::GEOS, geom_a, geom_b)
+    return LG.touches(GI.convert(LG, geom_a), GI.convert(LG, geom_b))
+end

Crosses

julia
function GO.crosses(::GEOS, geom_a, geom_b)
+    return LG.crosses(GI.convert(LG, geom_a), GI.convert(LG, geom_b))
+end

Within

julia
function GO.within(::GEOS, geom_a, geom_b)
+    return LG.within(GI.convert(LG, geom_a), GI.convert(LG, geom_b))
+end

Contains

julia
function GO.contains(::GEOS, geom_a, geom_b)
+    return LG.contains(GI.convert(LG, geom_a), GI.convert(LG, geom_b))
+end

Overlaps

julia
function GO.overlaps(::GEOS, geom_a, geom_b)
+    return LG.overlaps(GI.convert(LG, geom_a), GI.convert(LG, geom_b))
+end

Covers

julia
function GO.covers(::GEOS, geom_a, geom_b)
+    return LG.covers(GI.convert(LG, geom_a), GI.convert(LG, geom_b))
+end

CoveredBy

julia
function GO.coveredby(::GEOS, geom_a, geom_b)
+    return LG.coveredby(GI.convert(LG, geom_a), GI.convert(LG, geom_b))
+end

Intersects

julia
function GO.intersects(::GEOS, geom_a, geom_b)
+    return LG.intersects(GI.convert(LG, geom_a), GI.convert(LG, geom_b))
+end

Convex hull

julia
function GO.convex_hull(::GEOS, geoms)
+    chull = LG.convexhull(
+        LG.MultiPoint(
+            collect(
+                GO.flatten(
+                    x -> GI.convert(LG.Point, x),
+                    GI.PointTrait,
+                    geoms
+                )
+            )
+        )
+    );
+    return _wrap(
+        chull;
+        crs = GI.crs(geoms),
+        calc_extent = false
+    )
+end

This page was generated using Literate.jl.

`,36)]))}const o=i(t,[["render",k]]);export{g as __pageData,o as default}; diff --git a/previews/PR237/assets/source_GeometryOpsLibGEOSExt_simple_overrides.md.B0O49YKH.lean.js b/previews/PR237/assets/source_GeometryOpsLibGEOSExt_simple_overrides.md.B0O49YKH.lean.js new file mode 100644 index 000000000..b502c4609 --- /dev/null +++ b/previews/PR237/assets/source_GeometryOpsLibGEOSExt_simple_overrides.md.B0O49YKH.lean.js @@ -0,0 +1,46 @@ +import{_ as i,c as a,a5 as h,o as n}from"./chunks/framework.Cq8AuEls.js";const g=JSON.parse('{"title":"Simple overrides","description":"","frontmatter":{},"headers":[],"relativePath":"source/GeometryOpsLibGEOSExt/simple_overrides.md","filePath":"source/GeometryOpsLibGEOSExt/simple_overrides.md","lastUpdated":null}'),t={name:"source/GeometryOpsLibGEOSExt/simple_overrides.md"};function k(l,s,e,p,r,d){return n(),a("div",null,s[0]||(s[0]=[h(`

Simple overrides

This file contains simple overrides for GEOS, essentially only those functions which have direct counterparts in LG and only require conversion before calling.

Polygon set operations

Difference

julia
function GO.difference(::GEOS, geom_a, geom_b; target=nothing, calc_extent = false)
+    return _wrap(LG.difference(GI.convert(LG, geom_a), GI.convert(LG, geom_b)); crs = GI.crs(geom_a), calc_extent)
+end

Union

julia
function GO.union(::GEOS, geom_a, geom_b; target=nothing, calc_extent = false)
+    return _wrap(LG.union(GI.convert(LG, geom_a), GI.convert(LG, geom_b)); crs = GI.crs(geom_a), calc_extent)
+end

Intersection

julia
function GO.intersection(::GEOS, geom_a, geom_b; target=nothing, calc_extent = false)
+    return _wrap(LG.intersection(GI.convert(LG, geom_a), GI.convert(LG, geom_b)); crs = GI.crs(geom_a), calc_extent)
+end

Symmetric difference

julia
function GO.symdifference(::GEOS, geom_a, geom_b; target=nothing, calc_extent = false)
+    return _wrap(LG.symmetric_difference(GI.convert(LG, geom_a), GI.convert(LG, geom_b)); crs = GI.crs(geom_a), calc_extent)
+end

DE-9IM boolean methods

Equals

julia
function GO.equals(::GEOS, geom_a, geom_b)
+    return LG.equals(GI.convert(LG, geom_a), GI.convert(LG, geom_b))
+end

Disjoint

julia
function GO.disjoint(::GEOS, geom_a, geom_b)
+    return LG.disjoint(GI.convert(LG, geom_a), GI.convert(LG, geom_b))
+end

Touches

julia
function GO.touches(::GEOS, geom_a, geom_b)
+    return LG.touches(GI.convert(LG, geom_a), GI.convert(LG, geom_b))
+end

Crosses

julia
function GO.crosses(::GEOS, geom_a, geom_b)
+    return LG.crosses(GI.convert(LG, geom_a), GI.convert(LG, geom_b))
+end

Within

julia
function GO.within(::GEOS, geom_a, geom_b)
+    return LG.within(GI.convert(LG, geom_a), GI.convert(LG, geom_b))
+end

Contains

julia
function GO.contains(::GEOS, geom_a, geom_b)
+    return LG.contains(GI.convert(LG, geom_a), GI.convert(LG, geom_b))
+end

Overlaps

julia
function GO.overlaps(::GEOS, geom_a, geom_b)
+    return LG.overlaps(GI.convert(LG, geom_a), GI.convert(LG, geom_b))
+end

Covers

julia
function GO.covers(::GEOS, geom_a, geom_b)
+    return LG.covers(GI.convert(LG, geom_a), GI.convert(LG, geom_b))
+end

CoveredBy

julia
function GO.coveredby(::GEOS, geom_a, geom_b)
+    return LG.coveredby(GI.convert(LG, geom_a), GI.convert(LG, geom_b))
+end

Intersects

julia
function GO.intersects(::GEOS, geom_a, geom_b)
+    return LG.intersects(GI.convert(LG, geom_a), GI.convert(LG, geom_b))
+end

Convex hull

julia
function GO.convex_hull(::GEOS, geoms)
+    chull = LG.convexhull(
+        LG.MultiPoint(
+            collect(
+                GO.flatten(
+                    x -> GI.convert(LG.Point, x),
+                    GI.PointTrait,
+                    geoms
+                )
+            )
+        )
+    );
+    return _wrap(
+        chull;
+        crs = GI.crs(geoms),
+        calc_extent = false
+    )
+end

This page was generated using Literate.jl.

`,36)]))}const o=i(t,[["render",k]]);export{g as __pageData,o as default}; diff --git a/previews/PR237/assets/source_GeometryOpsLibGEOSExt_simplify.md.0759lT_4.js b/previews/PR237/assets/source_GeometryOpsLibGEOSExt_simplify.md.0759lT_4.js new file mode 100644 index 000000000..8e808465f --- /dev/null +++ b/previews/PR237/assets/source_GeometryOpsLibGEOSExt_simplify.md.0759lT_4.js @@ -0,0 +1,29 @@ +import{_ as i,c as a,a5 as n,o as h}from"./chunks/framework.Cq8AuEls.js";const g=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"source/GeometryOpsLibGEOSExt/simplify.md","filePath":"source/GeometryOpsLibGEOSExt/simplify.md","lastUpdated":null}'),k={name:"source/GeometryOpsLibGEOSExt/simplify.md"};function l(t,s,p,e,E,r){return h(),a("div",null,s[0]||(s[0]=[n(`

Address potential ambiguities

julia
GO._simplify(::GI.PointTrait, ::GO.GEOS, geom; kw...) = geom
+GO._simplify(::GI.MultiPointTrait, ::GO.GEOS, geom; kw...) = geom
+
+function GO._simplify(::GI.AbstractGeometryTrait, alg::GO.GEOS, geom; kwargs...)
+    method = get(alg, :method, :TopologyPreserve)
+    @assert haskey(alg.params, :tol) """
+        The \`:tol\` parameter is required for the GEOS algorithm in \`simplify\`,
+        but it was not provided.
+
+        Provide it by passing \`GEOS(; tol = ...,) as the algorithm.
+        """
+    tol = alg.params.tol
+    if method == :TopologyPreserve
+        return LG.topologyPreserveSimplify(GI.convert(LG, geom), tol)
+    elseif method == :DouglasPeucker
+        return LG.simplify(GI.convert(LG, geom), tol)
+    else
+        error("Invalid method passed to \`GO.simplify(GEOS(...), ...)\`: $method. Please use :TopologyPreserve or :DouglasPeucker")
+    end
+end
+
+function GO._simplify(trait::GI.AbstractCurveTrait, alg::GO.GEOS, geom; kw...)
+    Base.invoke(
+        GO._simplify,
+        Tuple{GI.AbstractGeometryTrait, GO.GEOS, typeof(geom)},
+        trait, alg, geom;
+        kw...
+    )
+end

This page was generated using Literate.jl.

`,4)]))}const y=i(k,[["render",l]]);export{g as __pageData,y as default}; diff --git a/previews/PR237/assets/source_GeometryOpsLibGEOSExt_simplify.md.0759lT_4.lean.js b/previews/PR237/assets/source_GeometryOpsLibGEOSExt_simplify.md.0759lT_4.lean.js new file mode 100644 index 000000000..8e808465f --- /dev/null +++ b/previews/PR237/assets/source_GeometryOpsLibGEOSExt_simplify.md.0759lT_4.lean.js @@ -0,0 +1,29 @@ +import{_ as i,c as a,a5 as n,o as h}from"./chunks/framework.Cq8AuEls.js";const g=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"source/GeometryOpsLibGEOSExt/simplify.md","filePath":"source/GeometryOpsLibGEOSExt/simplify.md","lastUpdated":null}'),k={name:"source/GeometryOpsLibGEOSExt/simplify.md"};function l(t,s,p,e,E,r){return h(),a("div",null,s[0]||(s[0]=[n(`

Address potential ambiguities

julia
GO._simplify(::GI.PointTrait, ::GO.GEOS, geom; kw...) = geom
+GO._simplify(::GI.MultiPointTrait, ::GO.GEOS, geom; kw...) = geom
+
+function GO._simplify(::GI.AbstractGeometryTrait, alg::GO.GEOS, geom; kwargs...)
+    method = get(alg, :method, :TopologyPreserve)
+    @assert haskey(alg.params, :tol) """
+        The \`:tol\` parameter is required for the GEOS algorithm in \`simplify\`,
+        but it was not provided.
+
+        Provide it by passing \`GEOS(; tol = ...,) as the algorithm.
+        """
+    tol = alg.params.tol
+    if method == :TopologyPreserve
+        return LG.topologyPreserveSimplify(GI.convert(LG, geom), tol)
+    elseif method == :DouglasPeucker
+        return LG.simplify(GI.convert(LG, geom), tol)
+    else
+        error("Invalid method passed to \`GO.simplify(GEOS(...), ...)\`: $method. Please use :TopologyPreserve or :DouglasPeucker")
+    end
+end
+
+function GO._simplify(trait::GI.AbstractCurveTrait, alg::GO.GEOS, geom; kw...)
+    Base.invoke(
+        GO._simplify,
+        Tuple{GI.AbstractGeometryTrait, GO.GEOS, typeof(geom)},
+        trait, alg, geom;
+        kw...
+    )
+end

This page was generated using Literate.jl.

`,4)]))}const y=i(k,[["render",l]]);export{g as __pageData,y as default}; diff --git a/previews/PR237/assets/source_GeometryOpsProjExt_GeometryOpsProjExt.md.T9WAXhCV.js b/previews/PR237/assets/source_GeometryOpsProjExt_GeometryOpsProjExt.md.T9WAXhCV.js new file mode 100644 index 000000000..511a6e3c3 --- /dev/null +++ b/previews/PR237/assets/source_GeometryOpsProjExt_GeometryOpsProjExt.md.T9WAXhCV.js @@ -0,0 +1,8 @@ +import{_ as e,c as a,a5 as i,o as t}from"./chunks/framework.Cq8AuEls.js";const c=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"source/GeometryOpsProjExt/GeometryOpsProjExt.md","filePath":"source/GeometryOpsProjExt/GeometryOpsProjExt.md","lastUpdated":null}'),n={name:"source/GeometryOpsProjExt/GeometryOpsProjExt.md"};function p(l,s,r,o,h,k){return t(),a("div",null,s[0]||(s[0]=[i(`
julia
module GeometryOpsProjExt
+
+using GeometryOps, Proj
+
+include("reproject.jl")
+include("segmentize.jl")
+
+end

This page was generated using Literate.jl.

`,3)]))}const E=e(n,[["render",p]]);export{c as __pageData,E as default}; diff --git a/previews/PR237/assets/source_GeometryOpsProjExt_GeometryOpsProjExt.md.T9WAXhCV.lean.js b/previews/PR237/assets/source_GeometryOpsProjExt_GeometryOpsProjExt.md.T9WAXhCV.lean.js new file mode 100644 index 000000000..511a6e3c3 --- /dev/null +++ b/previews/PR237/assets/source_GeometryOpsProjExt_GeometryOpsProjExt.md.T9WAXhCV.lean.js @@ -0,0 +1,8 @@ +import{_ as e,c as a,a5 as i,o as t}from"./chunks/framework.Cq8AuEls.js";const c=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"source/GeometryOpsProjExt/GeometryOpsProjExt.md","filePath":"source/GeometryOpsProjExt/GeometryOpsProjExt.md","lastUpdated":null}'),n={name:"source/GeometryOpsProjExt/GeometryOpsProjExt.md"};function p(l,s,r,o,h,k){return t(),a("div",null,s[0]||(s[0]=[i(`
julia
module GeometryOpsProjExt
+
+using GeometryOps, Proj
+
+include("reproject.jl")
+include("segmentize.jl")
+
+end

This page was generated using Literate.jl.

`,3)]))}const E=e(n,[["render",p]]);export{c as __pageData,E as default}; diff --git a/previews/PR237/assets/source_GeometryOpsProjExt_reproject.md.CtArVbVw.js b/previews/PR237/assets/source_GeometryOpsProjExt_reproject.md.CtArVbVw.js new file mode 100644 index 000000000..4535bcf34 --- /dev/null +++ b/previews/PR237/assets/source_GeometryOpsProjExt_reproject.md.CtArVbVw.js @@ -0,0 +1,44 @@ +import{_ as i,c as a,a5 as n,o as h}from"./chunks/framework.Cq8AuEls.js";const d=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"source/GeometryOpsProjExt/reproject.md","filePath":"source/GeometryOpsProjExt/reproject.md","lastUpdated":null}'),k={name:"source/GeometryOpsProjExt/reproject.md"};function t(p,s,l,e,r,E){return h(),a("div",null,s[0]||(s[0]=[n(`
julia
import GeometryOps: GI, GeoInterface, reproject, apply, transform, _is3d, _True, _False
+import Proj
+
+function reproject(geom;
+    source_crs=nothing, target_crs=nothing, transform=nothing, kw...
+)
+    if isnothing(transform)
+        if isnothing(source_crs)
+            source_crs = if GI.trait(geom) isa Nothing && geom isa AbstractArray
+                GeoInterface.crs(first(geom))
+            else
+                GeoInterface.crs(geom)
+            end
+        end

If its still nothing, error

julia
        isnothing(source_crs) && throw(ArgumentError("geom has no crs attached. Pass a \`source_crs\` keyword"))

Otherwise reproject

julia
        reproject(geom, source_crs, target_crs; kw...)
+    else
+        reproject(geom, transform; kw...)
+    end
+end
+function reproject(geom, source_crs, target_crs;
+    time=Inf,
+    always_xy=true,
+    transform=nothing,
+    kw...
+)
+    transform = if isnothing(transform)
+        s = source_crs isa Proj.CRS ? source_crs : convert(String, source_crs)
+        t = target_crs isa Proj.CRS ? target_crs : convert(String, target_crs)
+        Proj.Transformation(s, t; always_xy)
+    else
+        transform
+    end
+    reproject(geom, transform; time, target_crs, kw...)
+end
+function reproject(geom, transform::Proj.Transformation; time=Inf, target_crs=nothing, kw...)
+    if _is3d(geom)
+        return apply(GI.PointTrait(), geom; crs=target_crs, kw...) do p
+            transform(GI.x(p), GI.y(p), GI.z(p))
+        end
+    else
+        return apply(GI.PointTrait(), geom; crs=target_crs, kw...) do p
+            transform(GI.x(p), GI.y(p))
+        end
+    end
+end

This page was generated using Literate.jl.

`,7)]))}const y=i(k,[["render",t]]);export{d as __pageData,y as default}; diff --git a/previews/PR237/assets/source_GeometryOpsProjExt_reproject.md.CtArVbVw.lean.js b/previews/PR237/assets/source_GeometryOpsProjExt_reproject.md.CtArVbVw.lean.js new file mode 100644 index 000000000..4535bcf34 --- /dev/null +++ b/previews/PR237/assets/source_GeometryOpsProjExt_reproject.md.CtArVbVw.lean.js @@ -0,0 +1,44 @@ +import{_ as i,c as a,a5 as n,o as h}from"./chunks/framework.Cq8AuEls.js";const d=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"source/GeometryOpsProjExt/reproject.md","filePath":"source/GeometryOpsProjExt/reproject.md","lastUpdated":null}'),k={name:"source/GeometryOpsProjExt/reproject.md"};function t(p,s,l,e,r,E){return h(),a("div",null,s[0]||(s[0]=[n(`
julia
import GeometryOps: GI, GeoInterface, reproject, apply, transform, _is3d, _True, _False
+import Proj
+
+function reproject(geom;
+    source_crs=nothing, target_crs=nothing, transform=nothing, kw...
+)
+    if isnothing(transform)
+        if isnothing(source_crs)
+            source_crs = if GI.trait(geom) isa Nothing && geom isa AbstractArray
+                GeoInterface.crs(first(geom))
+            else
+                GeoInterface.crs(geom)
+            end
+        end

If its still nothing, error

julia
        isnothing(source_crs) && throw(ArgumentError("geom has no crs attached. Pass a \`source_crs\` keyword"))

Otherwise reproject

julia
        reproject(geom, source_crs, target_crs; kw...)
+    else
+        reproject(geom, transform; kw...)
+    end
+end
+function reproject(geom, source_crs, target_crs;
+    time=Inf,
+    always_xy=true,
+    transform=nothing,
+    kw...
+)
+    transform = if isnothing(transform)
+        s = source_crs isa Proj.CRS ? source_crs : convert(String, source_crs)
+        t = target_crs isa Proj.CRS ? target_crs : convert(String, target_crs)
+        Proj.Transformation(s, t; always_xy)
+    else
+        transform
+    end
+    reproject(geom, transform; time, target_crs, kw...)
+end
+function reproject(geom, transform::Proj.Transformation; time=Inf, target_crs=nothing, kw...)
+    if _is3d(geom)
+        return apply(GI.PointTrait(), geom; crs=target_crs, kw...) do p
+            transform(GI.x(p), GI.y(p), GI.z(p))
+        end
+    else
+        return apply(GI.PointTrait(), geom; crs=target_crs, kw...) do p
+            transform(GI.x(p), GI.y(p))
+        end
+    end
+end

This page was generated using Literate.jl.

`,7)]))}const y=i(k,[["render",t]]);export{d as __pageData,y as default}; diff --git a/previews/PR237/assets/source_GeometryOpsProjExt_segmentize.md.5tB78318.js b/previews/PR237/assets/source_GeometryOpsProjExt_segmentize.md.5tB78318.js new file mode 100644 index 000000000..0850292f4 --- /dev/null +++ b/previews/PR237/assets/source_GeometryOpsProjExt_segmentize.md.5tB78318.js @@ -0,0 +1,31 @@ +import{_ as i,c as a,a5 as n,o as h}from"./chunks/framework.Cq8AuEls.js";const g=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"source/GeometryOpsProjExt/segmentize.md","filePath":"source/GeometryOpsProjExt/segmentize.md","lastUpdated":null}'),t={name:"source/GeometryOpsProjExt/segmentize.md"};function k(e,s,l,p,d,r){return h(),a("div",null,s[0]||(s[0]=[n(`

This holds the segmentize geodesic functionality.

julia
import GeometryOps: GeodesicSegments, _segmentize, _fill_linear_kernel!
+import Proj
+
+function GeometryOps.GeodesicSegments(; max_distance, equatorial_radius::Real=6378137, flattening::Real=1/298.257223563, geodesic::Proj.geod_geodesic = Proj.geod_geodesic(equatorial_radius, flattening))
+    return GeometryOps.GeodesicSegments{Proj.geod_geodesic}(geodesic, max_distance)
+end

This is the same method as in transformations/segmentize.jl, but it constructs a Proj geodesic line every time. Maybe this should be better...

julia
function _segmentize(method::Geodesic, geom, ::Union{GI.LineStringTrait, GI.LinearRingTrait}; max_distance)
+    proj_geodesic = Proj.geod_geodesic(method.semimajor_axis #= same thing as equatorial radius =#, 1/method.inv_flattening)
+    first_coord = GI.getpoint(geom, 1)
+    x1, y1 = GI.x(first_coord), GI.y(first_coord)
+    new_coords = NTuple{2, Float64}[]
+    sizehint!(new_coords, GI.npoint(geom))
+    push!(new_coords, (x1, y1))
+    for coord in Iterators.drop(GI.getpoint(geom), 1)
+        x2, y2 = GI.x(coord), GI.y(coord)
+        _fill_linear_kernel!(method, new_coords, x1, y1, x2, y2; max_distance, proj_geodesic)
+        x1, y1 = x2, y2
+    end
+    return rebuild(geom, new_coords)
+end
+
+function GeometryOps._fill_linear_kernel!(method::Geodesic, new_coords::Vector, x1, y1, x2, y2; max_distance, proj_geodesic)
+    geod_line = Proj.geod_inverseline(proj_geodesic, y1, x1, y2, x2)

This is the distance in meters computed between the two points. It's s13 because geod_inverseline sets point 3 to the second input point.

julia
    distance = geod_line.s13
+    if distance > max_distance
+        n_segments = ceil(Int, distance / max_distance)
+        for i in 1:(n_segments - 1)
+            y, x, _ = Proj.geod_position(geod_line, i / n_segments * distance)
+            push!(new_coords, (x, y))
+        end
+    end

End the line with the original coordinate, to avoid any multiplication errors.

julia
    push!(new_coords, (x2, y2))
+    return nothing
+end

This page was generated using Literate.jl.

`,10)]))}const y=i(t,[["render",k]]);export{g as __pageData,y as default}; diff --git a/previews/PR237/assets/source_GeometryOpsProjExt_segmentize.md.5tB78318.lean.js b/previews/PR237/assets/source_GeometryOpsProjExt_segmentize.md.5tB78318.lean.js new file mode 100644 index 000000000..0850292f4 --- /dev/null +++ b/previews/PR237/assets/source_GeometryOpsProjExt_segmentize.md.5tB78318.lean.js @@ -0,0 +1,31 @@ +import{_ as i,c as a,a5 as n,o as h}from"./chunks/framework.Cq8AuEls.js";const g=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"source/GeometryOpsProjExt/segmentize.md","filePath":"source/GeometryOpsProjExt/segmentize.md","lastUpdated":null}'),t={name:"source/GeometryOpsProjExt/segmentize.md"};function k(e,s,l,p,d,r){return h(),a("div",null,s[0]||(s[0]=[n(`

This holds the segmentize geodesic functionality.

julia
import GeometryOps: GeodesicSegments, _segmentize, _fill_linear_kernel!
+import Proj
+
+function GeometryOps.GeodesicSegments(; max_distance, equatorial_radius::Real=6378137, flattening::Real=1/298.257223563, geodesic::Proj.geod_geodesic = Proj.geod_geodesic(equatorial_radius, flattening))
+    return GeometryOps.GeodesicSegments{Proj.geod_geodesic}(geodesic, max_distance)
+end

This is the same method as in transformations/segmentize.jl, but it constructs a Proj geodesic line every time. Maybe this should be better...

julia
function _segmentize(method::Geodesic, geom, ::Union{GI.LineStringTrait, GI.LinearRingTrait}; max_distance)
+    proj_geodesic = Proj.geod_geodesic(method.semimajor_axis #= same thing as equatorial radius =#, 1/method.inv_flattening)
+    first_coord = GI.getpoint(geom, 1)
+    x1, y1 = GI.x(first_coord), GI.y(first_coord)
+    new_coords = NTuple{2, Float64}[]
+    sizehint!(new_coords, GI.npoint(geom))
+    push!(new_coords, (x1, y1))
+    for coord in Iterators.drop(GI.getpoint(geom), 1)
+        x2, y2 = GI.x(coord), GI.y(coord)
+        _fill_linear_kernel!(method, new_coords, x1, y1, x2, y2; max_distance, proj_geodesic)
+        x1, y1 = x2, y2
+    end
+    return rebuild(geom, new_coords)
+end
+
+function GeometryOps._fill_linear_kernel!(method::Geodesic, new_coords::Vector, x1, y1, x2, y2; max_distance, proj_geodesic)
+    geod_line = Proj.geod_inverseline(proj_geodesic, y1, x1, y2, x2)

This is the distance in meters computed between the two points. It's s13 because geod_inverseline sets point 3 to the second input point.

julia
    distance = geod_line.s13
+    if distance > max_distance
+        n_segments = ceil(Int, distance / max_distance)
+        for i in 1:(n_segments - 1)
+            y, x, _ = Proj.geod_position(geod_line, i / n_segments * distance)
+            push!(new_coords, (x, y))
+        end
+    end

End the line with the original coordinate, to avoid any multiplication errors.

julia
    push!(new_coords, (x2, y2))
+    return nothing
+end

This page was generated using Literate.jl.

`,10)]))}const y=i(t,[["render",k]]);export{g as __pageData,y as default}; diff --git a/previews/PR237/assets/source_methods_angles.md.C2l1TSM1.js b/previews/PR237/assets/source_methods_angles.md.C2l1TSM1.js new file mode 100644 index 000000000..d0fd15ce3 --- /dev/null +++ b/previews/PR237/assets/source_methods_angles.md.C2l1TSM1.js @@ -0,0 +1,124 @@ +import{_ as i,c as a,a5 as n,o as h}from"./chunks/framework.Cq8AuEls.js";const l="/GeometryOps.jl/previews/PR237/assets/msahijx.Dig-DWOQ.png",y=JSON.parse('{"title":"Angles","description":"","frontmatter":{},"headers":[],"relativePath":"source/methods/angles.md","filePath":"source/methods/angles.md","lastUpdated":null}'),k={name:"source/methods/angles.md"};function t(p,s,e,r,E,g){return h(),a("div",null,s[0]||(s[0]=[n(`

Angles

julia
export angles

What is angles?

Angles are the angles formed by a given geometries line segments, if it has line segments.

To provide an example, consider this rectangle:

julia
import GeometryOps as GO
+import GeoInterface as GI
+using Makie, CairoMakie
+
+rect = GI.Polygon([[(0.0, 0.0), (0.0, 1.0), (1.0, 1.0), (1.0, 0.0), (0.0, 0.0)]])
+f, a, p = poly(collect(GI.getpoint(rect)); axis = (; aspect = DataAspect()))

This is clearly a rectangle, with angles of 90 degrees.

julia
GO.angles(rect)  # [90, 90, 90, 90]
4-element Vector{Float64}:
+ 90.0
+ 90.0
+ 90.0
+ 90.0

Implementation

This is the GeoInterface-compatible implementation. First, we implement a wrapper method that dispatches to the correct implementation based on the geometry trait. This is also used in the implementation, since it's a lot less work!

julia
const _ANGLE_TARGETS = TraitTarget{Union{GI.PolygonTrait,GI.AbstractCurveTrait,GI.MultiPointTrait,GI.PointTrait}}()
+
+"""
+    angles(geom, ::Type{T} = Float64)
+
+Returns the angles of a geometry or collection of geometries.
+This is computed differently for different geometries:
+
+    - The angles of a point is an empty vector.
+    - The angles of a single line segment is an empty vector.
+    - The angles of a linestring or linearring is a vector of angles formed by the curve.
+    - The angles of a polygon is a vector of vectors of angles formed by each ring.
+    - The angles of a multi-geometry collection is a vector of the angles of each of the
+        sub-geometries as defined above.
+
+Result will be a Vector, or nested set of vectors, of type T where an optional argument with
+a default value of Float64.
+"""
+function angles(geom, ::Type{T} = Float64; threaded =false) where T <: AbstractFloat
+    applyreduce(vcat, _ANGLE_TARGETS, geom; threaded, init = Vector{T}()) do g
+        _angles(T, GI.trait(g), g)
+    end
+end

Points and single line segments have no angles

julia
_angles(::Type{T}, ::Union{GI.PointTrait, GI.MultiPointTrait, GI.LineTrait}, geom) where T = T[]
+
+#= The angles of a linestring are the angles formed by the line. If the first and last point
+are not explicitly repeated, the geom is not considered closed. The angles should all be on
+one side of the line, but a particular side is not guaranteed by this function. =#
+function _angles(::Type{T}, ::GI.LineStringTrait, geom) where T
+    npoints = GI.npoint(geom)
+    first_last_equal = equals(GI.getpoint(geom, 1), GI.getpoint(geom, npoints))
+    angle_list = Vector{T}(undef, npoints - (first_last_equal ? 1 : 2))
+    _find_angles!(
+        T, angle_list, geom;
+        offset = first_last_equal, close_geom = false,
+    )
+    return angle_list
+end
+
+#= The angles of a linearring are the angles within the closed line and include the angles
+formed by connecting the first and last points of the curve. =#
+function _angles(::Type{T}, ::GI.LinearRingTrait, geom; interior = true) where T
+    npoints = GI.npoint(geom)
+    first_last_equal = equals(GI.getpoint(geom, 1), GI.getpoint(geom, npoints))
+    angle_list = Vector{T}(undef, npoints - (first_last_equal ? 1 : 0))
+    _find_angles!(
+        T, angle_list, geom;
+        offset = true, close_geom = !first_last_equal, interior = interior,
+    )
+    return angle_list
+end
+
+#= The angles of a polygon is a vector of polygon angles. Note that if there are holes
+within the polygon, the angles will be listed after the exterior ring angles in order of the
+holes. All angles, including the hole angles, are interior angles of the polygon.=#
+function _angles(::Type{T}, ::GI.PolygonTrait, geom) where T
+    angles = _angles(T, GI.LinearRingTrait(), GI.getexterior(geom); interior = true)
+    for h in GI.gethole(geom)
+        append!(angles, _angles(T, GI.LinearRingTrait(), h; interior = false))
+    end
+    return angles
+end

Find angles of a curve and insert the values into the angle_list. If offset is true, then save space for the angle at the first vertex, as the curve is closed, at the front of angle_list. If close_geom is true, then despite the first and last point not being explicitly repeated, the curve is closed and the angle of the last point should be added to angle_list. If interior is true, then all angles will be on the same side of the line

julia
function _find_angles!(
+    ::Type{T}, angle_list, geom;
+    offset, close_geom, interior = true,
+) where T
+    local p1, prev_p1_diff, p2_p1_diff
+    local start_point, start_diff
+    local extreem_idx, extreem_x, extreem_y
+    i_offset = offset ? 1 : 0

Loop through the curve and find each of the angels

julia
    for (i, p2) in enumerate(GI.getpoint(geom))
+        xp2, yp2 = GI.x(p2), GI.y(p2)
+        #= Find point with smallest x values (and smallest y in case of a tie) as this point
+        is know to be convex. =#
+        if i == 1 || (xp2 < extreem_x || (xp2 == extreem_x && yp2 < extreem_y))
+            extreem_idx = i
+            extreem_x, extreem_y = xp2, yp2
+        end
+        if i > 1
+            p2_p1_diff = (xp2 - GI.x(p1), yp2 - GI.y(p1))
+            if i == 2
+                start_point = p1
+                start_diff = p2_p1_diff
+            else
+                angle_list[i - 2 + i_offset] = _diffs_calc_angle(T, prev_p1_diff, p2_p1_diff)
+            end
+            prev_p1_diff = -1 .* p2_p1_diff
+        end
+        p1 = p2
+    end

If the last point of geometry should be the same as the first, calculate closing angle

julia
    if close_geom
+        p2_p1_diff = (GI.x(start_point) - GI.x(p1), GI.y(start_point) - GI.y(p1))
+        angle_list[end] = _diffs_calc_angle(T, prev_p1_diff, p2_p1_diff)
+        prev_p1_diff = -1 .* p2_p1_diff
+    end

If needed, calculate first angle corresponding to the first point

julia
    if offset
+        angle_list[1] = _diffs_calc_angle(T, prev_p1_diff, start_diff)
+    end
+    #= Make sure that all of the angles are on the same side of the line and inside of the
+    closed ring if the input geometry is closed. =#
+    inside_sgn = sign(angle_list[extreem_idx]) * (interior ? 1 : -1)
+    for i in eachindex(angle_list)
+        idx_sgn = sign(angle_list[i])
+        if idx_sgn == -1
+            angle_list[i] = abs(angle_list[i])
+        end
+        if idx_sgn != inside_sgn
+            angle_list[i] = 360 - angle_list[i]
+        end
+    end
+    return
+end

Calculate the angle between two vectors defined by the previous and current Δx and Δys. Angle will have a sign corresponding to the sign of the cross product between the two vectors. All angles of one sign in a given geometry are convex, while those of the other sign are concave. However, the sign corresponding to each of these can vary based on geometry and thus you must compare to an angle that is know to be convex or concave.

julia
function _diffs_calc_angle(::Type{T}, (Δx_prev, Δy_prev), (Δx_curr, Δy_curr)) where T
+    cross_prod = Δx_prev * Δy_curr - Δy_prev * Δx_curr
+    dot_prod = Δx_prev * Δx_curr + Δy_prev * Δy_curr
+    prev_mag = max(sqrt(Δx_prev^2 + Δy_prev^2), eps(T))
+    curr_mag = max(sqrt(Δx_curr^2 + Δy_curr^2), eps(T))
+    val = clamp(dot_prod / (prev_mag * curr_mag), -one(T), one(T))
+    angle = real(acos(val) * 180 / π)
+    return angle * (cross_prod < 0 ? -1 : 1)
+end

This page was generated using Literate.jl.

`,27)]))}const F=i(k,[["render",t]]);export{y as __pageData,F as default}; diff --git a/previews/PR237/assets/source_methods_angles.md.C2l1TSM1.lean.js b/previews/PR237/assets/source_methods_angles.md.C2l1TSM1.lean.js new file mode 100644 index 000000000..d0fd15ce3 --- /dev/null +++ b/previews/PR237/assets/source_methods_angles.md.C2l1TSM1.lean.js @@ -0,0 +1,124 @@ +import{_ as i,c as a,a5 as n,o as h}from"./chunks/framework.Cq8AuEls.js";const l="/GeometryOps.jl/previews/PR237/assets/msahijx.Dig-DWOQ.png",y=JSON.parse('{"title":"Angles","description":"","frontmatter":{},"headers":[],"relativePath":"source/methods/angles.md","filePath":"source/methods/angles.md","lastUpdated":null}'),k={name:"source/methods/angles.md"};function t(p,s,e,r,E,g){return h(),a("div",null,s[0]||(s[0]=[n(`

Angles

julia
export angles

What is angles?

Angles are the angles formed by a given geometries line segments, if it has line segments.

To provide an example, consider this rectangle:

julia
import GeometryOps as GO
+import GeoInterface as GI
+using Makie, CairoMakie
+
+rect = GI.Polygon([[(0.0, 0.0), (0.0, 1.0), (1.0, 1.0), (1.0, 0.0), (0.0, 0.0)]])
+f, a, p = poly(collect(GI.getpoint(rect)); axis = (; aspect = DataAspect()))

This is clearly a rectangle, with angles of 90 degrees.

julia
GO.angles(rect)  # [90, 90, 90, 90]
4-element Vector{Float64}:
+ 90.0
+ 90.0
+ 90.0
+ 90.0

Implementation

This is the GeoInterface-compatible implementation. First, we implement a wrapper method that dispatches to the correct implementation based on the geometry trait. This is also used in the implementation, since it's a lot less work!

julia
const _ANGLE_TARGETS = TraitTarget{Union{GI.PolygonTrait,GI.AbstractCurveTrait,GI.MultiPointTrait,GI.PointTrait}}()
+
+"""
+    angles(geom, ::Type{T} = Float64)
+
+Returns the angles of a geometry or collection of geometries.
+This is computed differently for different geometries:
+
+    - The angles of a point is an empty vector.
+    - The angles of a single line segment is an empty vector.
+    - The angles of a linestring or linearring is a vector of angles formed by the curve.
+    - The angles of a polygon is a vector of vectors of angles formed by each ring.
+    - The angles of a multi-geometry collection is a vector of the angles of each of the
+        sub-geometries as defined above.
+
+Result will be a Vector, or nested set of vectors, of type T where an optional argument with
+a default value of Float64.
+"""
+function angles(geom, ::Type{T} = Float64; threaded =false) where T <: AbstractFloat
+    applyreduce(vcat, _ANGLE_TARGETS, geom; threaded, init = Vector{T}()) do g
+        _angles(T, GI.trait(g), g)
+    end
+end

Points and single line segments have no angles

julia
_angles(::Type{T}, ::Union{GI.PointTrait, GI.MultiPointTrait, GI.LineTrait}, geom) where T = T[]
+
+#= The angles of a linestring are the angles formed by the line. If the first and last point
+are not explicitly repeated, the geom is not considered closed. The angles should all be on
+one side of the line, but a particular side is not guaranteed by this function. =#
+function _angles(::Type{T}, ::GI.LineStringTrait, geom) where T
+    npoints = GI.npoint(geom)
+    first_last_equal = equals(GI.getpoint(geom, 1), GI.getpoint(geom, npoints))
+    angle_list = Vector{T}(undef, npoints - (first_last_equal ? 1 : 2))
+    _find_angles!(
+        T, angle_list, geom;
+        offset = first_last_equal, close_geom = false,
+    )
+    return angle_list
+end
+
+#= The angles of a linearring are the angles within the closed line and include the angles
+formed by connecting the first and last points of the curve. =#
+function _angles(::Type{T}, ::GI.LinearRingTrait, geom; interior = true) where T
+    npoints = GI.npoint(geom)
+    first_last_equal = equals(GI.getpoint(geom, 1), GI.getpoint(geom, npoints))
+    angle_list = Vector{T}(undef, npoints - (first_last_equal ? 1 : 0))
+    _find_angles!(
+        T, angle_list, geom;
+        offset = true, close_geom = !first_last_equal, interior = interior,
+    )
+    return angle_list
+end
+
+#= The angles of a polygon is a vector of polygon angles. Note that if there are holes
+within the polygon, the angles will be listed after the exterior ring angles in order of the
+holes. All angles, including the hole angles, are interior angles of the polygon.=#
+function _angles(::Type{T}, ::GI.PolygonTrait, geom) where T
+    angles = _angles(T, GI.LinearRingTrait(), GI.getexterior(geom); interior = true)
+    for h in GI.gethole(geom)
+        append!(angles, _angles(T, GI.LinearRingTrait(), h; interior = false))
+    end
+    return angles
+end

Find angles of a curve and insert the values into the angle_list. If offset is true, then save space for the angle at the first vertex, as the curve is closed, at the front of angle_list. If close_geom is true, then despite the first and last point not being explicitly repeated, the curve is closed and the angle of the last point should be added to angle_list. If interior is true, then all angles will be on the same side of the line

julia
function _find_angles!(
+    ::Type{T}, angle_list, geom;
+    offset, close_geom, interior = true,
+) where T
+    local p1, prev_p1_diff, p2_p1_diff
+    local start_point, start_diff
+    local extreem_idx, extreem_x, extreem_y
+    i_offset = offset ? 1 : 0

Loop through the curve and find each of the angels

julia
    for (i, p2) in enumerate(GI.getpoint(geom))
+        xp2, yp2 = GI.x(p2), GI.y(p2)
+        #= Find point with smallest x values (and smallest y in case of a tie) as this point
+        is know to be convex. =#
+        if i == 1 || (xp2 < extreem_x || (xp2 == extreem_x && yp2 < extreem_y))
+            extreem_idx = i
+            extreem_x, extreem_y = xp2, yp2
+        end
+        if i > 1
+            p2_p1_diff = (xp2 - GI.x(p1), yp2 - GI.y(p1))
+            if i == 2
+                start_point = p1
+                start_diff = p2_p1_diff
+            else
+                angle_list[i - 2 + i_offset] = _diffs_calc_angle(T, prev_p1_diff, p2_p1_diff)
+            end
+            prev_p1_diff = -1 .* p2_p1_diff
+        end
+        p1 = p2
+    end

If the last point of geometry should be the same as the first, calculate closing angle

julia
    if close_geom
+        p2_p1_diff = (GI.x(start_point) - GI.x(p1), GI.y(start_point) - GI.y(p1))
+        angle_list[end] = _diffs_calc_angle(T, prev_p1_diff, p2_p1_diff)
+        prev_p1_diff = -1 .* p2_p1_diff
+    end

If needed, calculate first angle corresponding to the first point

julia
    if offset
+        angle_list[1] = _diffs_calc_angle(T, prev_p1_diff, start_diff)
+    end
+    #= Make sure that all of the angles are on the same side of the line and inside of the
+    closed ring if the input geometry is closed. =#
+    inside_sgn = sign(angle_list[extreem_idx]) * (interior ? 1 : -1)
+    for i in eachindex(angle_list)
+        idx_sgn = sign(angle_list[i])
+        if idx_sgn == -1
+            angle_list[i] = abs(angle_list[i])
+        end
+        if idx_sgn != inside_sgn
+            angle_list[i] = 360 - angle_list[i]
+        end
+    end
+    return
+end

Calculate the angle between two vectors defined by the previous and current Δx and Δys. Angle will have a sign corresponding to the sign of the cross product between the two vectors. All angles of one sign in a given geometry are convex, while those of the other sign are concave. However, the sign corresponding to each of these can vary based on geometry and thus you must compare to an angle that is know to be convex or concave.

julia
function _diffs_calc_angle(::Type{T}, (Δx_prev, Δy_prev), (Δx_curr, Δy_curr)) where T
+    cross_prod = Δx_prev * Δy_curr - Δy_prev * Δx_curr
+    dot_prod = Δx_prev * Δx_curr + Δy_prev * Δy_curr
+    prev_mag = max(sqrt(Δx_prev^2 + Δy_prev^2), eps(T))
+    curr_mag = max(sqrt(Δx_curr^2 + Δy_curr^2), eps(T))
+    val = clamp(dot_prod / (prev_mag * curr_mag), -one(T), one(T))
+    angle = real(acos(val) * 180 / π)
+    return angle * (cross_prod < 0 ? -1 : 1)
+end

This page was generated using Literate.jl.

`,27)]))}const F=i(k,[["render",t]]);export{y as __pageData,F as default}; diff --git a/previews/PR237/assets/source_methods_area.md.Lwj3szS1.js b/previews/PR237/assets/source_methods_area.md.Lwj3szS1.js new file mode 100644 index 000000000..62ea25aad --- /dev/null +++ b/previews/PR237/assets/source_methods_area.md.Lwj3szS1.js @@ -0,0 +1,87 @@ +import{_ as i,c as a,a5 as n,o as h}from"./chunks/framework.Cq8AuEls.js";const t="/GeometryOps.jl/previews/PR237/assets/msahijx.Dig-DWOQ.png",e="/GeometryOps.jl/previews/PR237/assets/jdkujxv.CULn5saZ.png",y=JSON.parse('{"title":"Area and signed area","description":"","frontmatter":{},"headers":[],"relativePath":"source/methods/area.md","filePath":"source/methods/area.md","lastUpdated":null}'),l={name:"source/methods/area.md"};function p(k,s,r,d,g,E){return h(),a("div",null,s[0]||(s[0]=[n(`

Area and signed area

julia
export area, signed_area

What is area? What is signed area?

Area is the amount of space occupied by a two-dimensional figure. It is always a positive value. Signed area is simply the integral over the exterior path of a polygon, minus the sum of integrals over its interior holes. It is signed such that a clockwise path has a positive area, and a counterclockwise path has a negative area. The area is the absolute value of the signed area.

To provide an example, consider this rectangle:

julia
import GeometryOps as GO
+import GeoInterface as GI
+using Makie
+using CairoMakie
+
+rect = GI.Polygon([[(0,0), (0,1), (1,1), (1,0), (0, 0)]])
+f, a, p = poly(collect(GI.getpoint(rect)); axis = (; aspect = DataAspect()))

This is clearly a rectangle, etc. But now let's look at how the points look:

julia
lines!(
+    collect(GI.getpoint(rect));
+    color = 1:GI.npoint(rect), linewidth = 10.0)
+f

The points are ordered in a counterclockwise fashion, which means that the signed area is negative. If we reverse the order of the points, we get a positive area.

julia
GO.signed_area(rect)  # -1.0
-1.0

Implementation

This is the GeoInterface-compatible implementation. First, we implement a wrapper method that dispatches to the correct implementation based on the geometry trait. This is also used in the implementation, since it's a lot less work!

Note that area and signed area are zero for all points and curves, even if the curves are closed like with a linear ring. Also note that signed area really only makes sense for polygons, given with a multipolygon can have several polygons each with a different orientation and thus the absolute value of the signed area might not be the area. This is why signed area is only implemented for polygons.

Targets for applys functions

julia
const _AREA_TARGETS = TraitTarget{Union{GI.PolygonTrait,GI.AbstractCurveTrait,GI.MultiPointTrait,GI.PointTrait}}()
+
+"""
+    area(geom, [T = Float64])::T
+
+Returns the area of a geometry or collection of geometries.
+This is computed slightly differently for different geometries:
+
+    - The area of a point/multipoint is always zero.
+    - The area of a curve/multicurve is always zero.
+    - The area of a polygon is the absolute value of the signed area.
+    - The area multi-polygon is the sum of the areas of all of the sub-polygons.
+    - The area of a geometry collection, feature collection of array/iterable
+        is the sum of the areas of all of the sub-geometries.
+
+Result will be of type T, where T is an optional argument with a default value
+of Float64.
+"""
+function area(geom, ::Type{T} = Float64; threaded=false) where T <: AbstractFloat
+    applyreduce(+, _AREA_TARGETS, geom; threaded, init=zero(T)) do g
+        _area(T, GI.trait(g), g)
+    end
+end
+
+"""
+    signed_area(geom, [T = Float64])::T
+
+Returns the signed area of a single geometry, based on winding order.
+This is computed slightly differently for different geometries:
+
+    - The signed area of a point is always zero.
+    - The signed area of a curve is always zero.
+    - The signed area of a polygon is computed with the shoelace formula and is
+    positive if the polygon coordinates wind clockwise and negative if
+    counterclockwise.
+    - You cannot compute the signed area of a multipolygon as it doesn't have a
+    meaning as each sub-polygon could have a different winding order.
+
+Result will be of type T, where T is an optional argument with a default value
+of Float64.
+"""
+signed_area(geom, ::Type{T} = Float64) where T <: AbstractFloat =
+    _signed_area(T, GI.trait(geom), geom)

Points, MultiPoints, Curves, MultiCurves

julia
_area(::Type{T}, ::GI.AbstractGeometryTrait, geom) where T = zero(T)
+
+_signed_area(::Type{T}, ::GI.AbstractGeometryTrait, geom) where T = zero(T)

LibGEOS treats linear rings as zero area. I disagree with that but we should probably maintain compatibility...

julia
_area(::Type{T}, tr::GI.LinearRingTrait, geom) where T = 0 # could be abs(_signed_area(T, tr, geom))
+
+_signed_area(::Type{T}, ::GI.LinearRingTrait, geom) where T = 0 # could be _signed_area(T, tr, geom)

Polygons

julia
_area(::Type{T}, trait::GI.PolygonTrait, poly) where T =
+    abs(_signed_area(T, trait, poly))
+
+function _signed_area(::Type{T}, ::GI.PolygonTrait, poly) where T
+    GI.isempty(poly) && return zero(T)
+    s_area = _signed_area(T, GI.getexterior(poly))
+    area = abs(s_area)
+    area == 0 && return area

Remove hole areas from total

julia
    for hole in GI.gethole(poly)
+        area -= abs(_signed_area(T, hole))
+    end

Winding of exterior ring determines sign

julia
    return area * sign(s_area)
+end

One term of the shoelace area formula

julia
_area_component(p1, p2) = GI.x(p1) * GI.y(p2) - GI.y(p1) * GI.x(p2)
+
+#= Calculates the signed area of a given curve. This is equivalent to integrating
+to find the area under the curve. Even if curve isn't explicitly closed by
+repeating the first point at the end of the coordinates, curve is still assumed
+to be closed. =#
+function _signed_area(::Type{T}, geom) where T
+    area = zero(T)
+    np = GI.npoint(geom)
+    np == 0 && return area
+
+    first = true
+    local pfirst, p1

Integrate the area under the curve

julia
    for p2 in GI.getpoint(geom)

Skip the first and do it later This lets us work within one iteration over geom, which means on C call when using points from external libraries.

julia
        if first
+            p1 = pfirst = p2
+            first = false
+            continue
+        end

Accumulate the area into area

julia
        area += _area_component(p1, p2)
+        p1 = p2
+    end

Complete the last edge. If the first and last where the same this will be zero

julia
    p2 = pfirst
+    area += _area_component(p1, p2)
+    return T(area / 2)
+end

This page was generated using Literate.jl.

`,40)]))}const F=i(l,[["render",p]]);export{y as __pageData,F as default}; diff --git a/previews/PR237/assets/source_methods_area.md.Lwj3szS1.lean.js b/previews/PR237/assets/source_methods_area.md.Lwj3szS1.lean.js new file mode 100644 index 000000000..62ea25aad --- /dev/null +++ b/previews/PR237/assets/source_methods_area.md.Lwj3szS1.lean.js @@ -0,0 +1,87 @@ +import{_ as i,c as a,a5 as n,o as h}from"./chunks/framework.Cq8AuEls.js";const t="/GeometryOps.jl/previews/PR237/assets/msahijx.Dig-DWOQ.png",e="/GeometryOps.jl/previews/PR237/assets/jdkujxv.CULn5saZ.png",y=JSON.parse('{"title":"Area and signed area","description":"","frontmatter":{},"headers":[],"relativePath":"source/methods/area.md","filePath":"source/methods/area.md","lastUpdated":null}'),l={name:"source/methods/area.md"};function p(k,s,r,d,g,E){return h(),a("div",null,s[0]||(s[0]=[n(`

Area and signed area

julia
export area, signed_area

What is area? What is signed area?

Area is the amount of space occupied by a two-dimensional figure. It is always a positive value. Signed area is simply the integral over the exterior path of a polygon, minus the sum of integrals over its interior holes. It is signed such that a clockwise path has a positive area, and a counterclockwise path has a negative area. The area is the absolute value of the signed area.

To provide an example, consider this rectangle:

julia
import GeometryOps as GO
+import GeoInterface as GI
+using Makie
+using CairoMakie
+
+rect = GI.Polygon([[(0,0), (0,1), (1,1), (1,0), (0, 0)]])
+f, a, p = poly(collect(GI.getpoint(rect)); axis = (; aspect = DataAspect()))

This is clearly a rectangle, etc. But now let's look at how the points look:

julia
lines!(
+    collect(GI.getpoint(rect));
+    color = 1:GI.npoint(rect), linewidth = 10.0)
+f

The points are ordered in a counterclockwise fashion, which means that the signed area is negative. If we reverse the order of the points, we get a positive area.

julia
GO.signed_area(rect)  # -1.0
-1.0

Implementation

This is the GeoInterface-compatible implementation. First, we implement a wrapper method that dispatches to the correct implementation based on the geometry trait. This is also used in the implementation, since it's a lot less work!

Note that area and signed area are zero for all points and curves, even if the curves are closed like with a linear ring. Also note that signed area really only makes sense for polygons, given with a multipolygon can have several polygons each with a different orientation and thus the absolute value of the signed area might not be the area. This is why signed area is only implemented for polygons.

Targets for applys functions

julia
const _AREA_TARGETS = TraitTarget{Union{GI.PolygonTrait,GI.AbstractCurveTrait,GI.MultiPointTrait,GI.PointTrait}}()
+
+"""
+    area(geom, [T = Float64])::T
+
+Returns the area of a geometry or collection of geometries.
+This is computed slightly differently for different geometries:
+
+    - The area of a point/multipoint is always zero.
+    - The area of a curve/multicurve is always zero.
+    - The area of a polygon is the absolute value of the signed area.
+    - The area multi-polygon is the sum of the areas of all of the sub-polygons.
+    - The area of a geometry collection, feature collection of array/iterable
+        is the sum of the areas of all of the sub-geometries.
+
+Result will be of type T, where T is an optional argument with a default value
+of Float64.
+"""
+function area(geom, ::Type{T} = Float64; threaded=false) where T <: AbstractFloat
+    applyreduce(+, _AREA_TARGETS, geom; threaded, init=zero(T)) do g
+        _area(T, GI.trait(g), g)
+    end
+end
+
+"""
+    signed_area(geom, [T = Float64])::T
+
+Returns the signed area of a single geometry, based on winding order.
+This is computed slightly differently for different geometries:
+
+    - The signed area of a point is always zero.
+    - The signed area of a curve is always zero.
+    - The signed area of a polygon is computed with the shoelace formula and is
+    positive if the polygon coordinates wind clockwise and negative if
+    counterclockwise.
+    - You cannot compute the signed area of a multipolygon as it doesn't have a
+    meaning as each sub-polygon could have a different winding order.
+
+Result will be of type T, where T is an optional argument with a default value
+of Float64.
+"""
+signed_area(geom, ::Type{T} = Float64) where T <: AbstractFloat =
+    _signed_area(T, GI.trait(geom), geom)

Points, MultiPoints, Curves, MultiCurves

julia
_area(::Type{T}, ::GI.AbstractGeometryTrait, geom) where T = zero(T)
+
+_signed_area(::Type{T}, ::GI.AbstractGeometryTrait, geom) where T = zero(T)

LibGEOS treats linear rings as zero area. I disagree with that but we should probably maintain compatibility...

julia
_area(::Type{T}, tr::GI.LinearRingTrait, geom) where T = 0 # could be abs(_signed_area(T, tr, geom))
+
+_signed_area(::Type{T}, ::GI.LinearRingTrait, geom) where T = 0 # could be _signed_area(T, tr, geom)

Polygons

julia
_area(::Type{T}, trait::GI.PolygonTrait, poly) where T =
+    abs(_signed_area(T, trait, poly))
+
+function _signed_area(::Type{T}, ::GI.PolygonTrait, poly) where T
+    GI.isempty(poly) && return zero(T)
+    s_area = _signed_area(T, GI.getexterior(poly))
+    area = abs(s_area)
+    area == 0 && return area

Remove hole areas from total

julia
    for hole in GI.gethole(poly)
+        area -= abs(_signed_area(T, hole))
+    end

Winding of exterior ring determines sign

julia
    return area * sign(s_area)
+end

One term of the shoelace area formula

julia
_area_component(p1, p2) = GI.x(p1) * GI.y(p2) - GI.y(p1) * GI.x(p2)
+
+#= Calculates the signed area of a given curve. This is equivalent to integrating
+to find the area under the curve. Even if curve isn't explicitly closed by
+repeating the first point at the end of the coordinates, curve is still assumed
+to be closed. =#
+function _signed_area(::Type{T}, geom) where T
+    area = zero(T)
+    np = GI.npoint(geom)
+    np == 0 && return area
+
+    first = true
+    local pfirst, p1

Integrate the area under the curve

julia
    for p2 in GI.getpoint(geom)

Skip the first and do it later This lets us work within one iteration over geom, which means on C call when using points from external libraries.

julia
        if first
+            p1 = pfirst = p2
+            first = false
+            continue
+        end

Accumulate the area into area

julia
        area += _area_component(p1, p2)
+        p1 = p2
+    end

Complete the last edge. If the first and last where the same this will be zero

julia
    p2 = pfirst
+    area += _area_component(p1, p2)
+    return T(area / 2)
+end

This page was generated using Literate.jl.

`,40)]))}const F=i(l,[["render",p]]);export{y as __pageData,F as default}; diff --git a/previews/PR237/assets/source_methods_barycentric.md.BBVjpi4w.js b/previews/PR237/assets/source_methods_barycentric.md.BBVjpi4w.js new file mode 100644 index 000000000..b0a244112 --- /dev/null +++ b/previews/PR237/assets/source_methods_barycentric.md.BBVjpi4w.js @@ -0,0 +1,415 @@ +import{_ as k,c as n,a5 as t,j as s,a,o as h}from"./chunks/framework.Cq8AuEls.js";const l="/GeometryOps.jl/previews/PR237/assets/tztfann.pAYw0Yqf.png",m=JSON.parse('{"title":"Barycentric coordinates","description":"","frontmatter":{},"headers":[],"relativePath":"source/methods/barycentric.md","filePath":"source/methods/barycentric.md","lastUpdated":null}'),p={name:"source/methods/barycentric.md"},e={class:"MathJax",jax:"SVG",style:{direction:"ltr",position:"relative"}},E={style:{overflow:"visible","min-height":"1px","min-width":"1px","vertical-align":"-0.566ex"},xmlns:"http://www.w3.org/2000/svg",width:"10.692ex",height:"2.262ex",role:"img",focusable:"false",viewBox:"0 -750 4726 1000","aria-hidden":"true"},r={class:"MathJax",jax:"SVG",style:{direction:"ltr",position:"relative"}},d={style:{overflow:"visible","min-height":"1px","min-width":"1px","vertical-align":"-0.025ex"},xmlns:"http://www.w3.org/2000/svg",width:"1.357ex",height:"1.025ex",role:"img",focusable:"false",viewBox:"0 -442 600 453","aria-hidden":"true"},g={class:"MathJax",jax:"SVG",style:{direction:"ltr",position:"relative"}},y={style:{overflow:"visible","min-height":"1px","min-width":"1px","vertical-align":"-0.025ex"},xmlns:"http://www.w3.org/2000/svg",width:"1.357ex",height:"1.025ex",role:"img",focusable:"false",viewBox:"0 -442 600 453","aria-hidden":"true"},F={class:"MathJax",jax:"SVG",style:{direction:"ltr",position:"relative"}},o={style:{overflow:"visible","min-height":"1px","min-width":"1px","vertical-align":"-0.566ex"},xmlns:"http://www.w3.org/2000/svg",width:"14.876ex",height:"2.262ex",role:"img",focusable:"false",viewBox:"0 -750 6575.4 1000","aria-hidden":"true"};function C(c,i,B,A,D,u){return h(),n("div",null,[i[14]||(i[14]=t(`

Barycentric coordinates

julia
export barycentric_coordinates, barycentric_coordinates!, barycentric_interpolate
+export MeanValue

Generalized barycentric coordinates are a generalization of barycentric coordinates, which are typically used in triangles, to arbitrary polygons.

They provide a way to express a point within a polygon as a weighted average of the polygon's vertices.

`,4)),s("p",null,[i[2]||(i[2]=a("In the case of a triangle, barycentric coordinates are a set of three numbers ")),s("mjx-container",e,[(h(),n("svg",E,i[0]||(i[0]=[t('',1)]))),i[1]||(i[1]=s("mjx-assistive-mml",{unselectable:"on",display:"inline",style:{top:"0px",left:"0px",clip:"rect(1px, 1px, 1px, 1px)","-webkit-touch-callout":"none","-webkit-user-select":"none","-khtml-user-select":"none","-moz-user-select":"none","-ms-user-select":"none","user-select":"none",position:"absolute",padding:"1px 0px 0px 0px",border:"0px",display:"block",width:"auto",overflow:"hidden"}},[s("math",{xmlns:"http://www.w3.org/1998/Math/MathML"},[s("mo",{stretchy:"false"},"("),s("msub",null,[s("mi",null,"λ"),s("mn",null,"1")]),s("mo",null,","),s("msub",null,[s("mi",null,"λ"),s("mn",null,"2")]),s("mo",null,","),s("msub",null,[s("mi",null,"λ"),s("mn",null,"3")]),s("mo",{stretchy:"false"},")")])],-1))]),i[3]||(i[3]=a(", each associated with a vertex of the triangle. Any point within the triangle can be expressed as a weighted average of the vertices, where the weights are the barycentric coordinates. The weights sum to 1, and each is non-negative."))]),s("p",null,[i[10]||(i[10]=a("For a polygon with ")),s("mjx-container",r,[(h(),n("svg",d,i[4]||(i[4]=[s("g",{stroke:"currentColor",fill:"currentColor","stroke-width":"0",transform:"scale(1,-1)"},[s("g",{"data-mml-node":"math"},[s("g",{"data-mml-node":"mi"},[s("path",{"data-c":"1D45B",d:"M21 287Q22 293 24 303T36 341T56 388T89 425T135 442Q171 442 195 424T225 390T231 369Q231 367 232 367L243 378Q304 442 382 442Q436 442 469 415T503 336T465 179T427 52Q427 26 444 26Q450 26 453 27Q482 32 505 65T540 145Q542 153 560 153Q580 153 580 145Q580 144 576 130Q568 101 554 73T508 17T439 -10Q392 -10 371 17T350 73Q350 92 386 193T423 345Q423 404 379 404H374Q288 404 229 303L222 291L189 157Q156 26 151 16Q138 -11 108 -11Q95 -11 87 -5T76 7T74 17Q74 30 112 180T152 343Q153 348 153 366Q153 405 129 405Q91 405 66 305Q60 285 60 284Q58 278 41 278H27Q21 284 21 287Z",style:{"stroke-width":"3"}})])])],-1)]))),i[5]||(i[5]=s("mjx-assistive-mml",{unselectable:"on",display:"inline",style:{top:"0px",left:"0px",clip:"rect(1px, 1px, 1px, 1px)","-webkit-touch-callout":"none","-webkit-user-select":"none","-khtml-user-select":"none","-moz-user-select":"none","-ms-user-select":"none","user-select":"none",position:"absolute",padding:"1px 0px 0px 0px",border:"0px",display:"block",width:"auto",overflow:"hidden"}},[s("math",{xmlns:"http://www.w3.org/1998/Math/MathML"},[s("mi",null,"n")])],-1))]),i[11]||(i[11]=a(" vertices, generalized barycentric coordinates are a set of ")),s("mjx-container",g,[(h(),n("svg",y,i[6]||(i[6]=[s("g",{stroke:"currentColor",fill:"currentColor","stroke-width":"0",transform:"scale(1,-1)"},[s("g",{"data-mml-node":"math"},[s("g",{"data-mml-node":"mi"},[s("path",{"data-c":"1D45B",d:"M21 287Q22 293 24 303T36 341T56 388T89 425T135 442Q171 442 195 424T225 390T231 369Q231 367 232 367L243 378Q304 442 382 442Q436 442 469 415T503 336T465 179T427 52Q427 26 444 26Q450 26 453 27Q482 32 505 65T540 145Q542 153 560 153Q580 153 580 145Q580 144 576 130Q568 101 554 73T508 17T439 -10Q392 -10 371 17T350 73Q350 92 386 193T423 345Q423 404 379 404H374Q288 404 229 303L222 291L189 157Q156 26 151 16Q138 -11 108 -11Q95 -11 87 -5T76 7T74 17Q74 30 112 180T152 343Q153 348 153 366Q153 405 129 405Q91 405 66 305Q60 285 60 284Q58 278 41 278H27Q21 284 21 287Z",style:{"stroke-width":"3"}})])])],-1)]))),i[7]||(i[7]=s("mjx-assistive-mml",{unselectable:"on",display:"inline",style:{top:"0px",left:"0px",clip:"rect(1px, 1px, 1px, 1px)","-webkit-touch-callout":"none","-webkit-user-select":"none","-khtml-user-select":"none","-moz-user-select":"none","-ms-user-select":"none","user-select":"none",position:"absolute",padding:"1px 0px 0px 0px",border:"0px",display:"block",width:"auto",overflow:"hidden"}},[s("math",{xmlns:"http://www.w3.org/1998/Math/MathML"},[s("mi",null,"n")])],-1))]),i[12]||(i[12]=a(" numbers ")),s("mjx-container",F,[(h(),n("svg",o,i[8]||(i[8]=[t('',1)]))),i[9]||(i[9]=s("mjx-assistive-mml",{unselectable:"on",display:"inline",style:{top:"0px",left:"0px",clip:"rect(1px, 1px, 1px, 1px)","-webkit-touch-callout":"none","-webkit-user-select":"none","-khtml-user-select":"none","-moz-user-select":"none","-ms-user-select":"none","user-select":"none",position:"absolute",padding:"1px 0px 0px 0px",border:"0px",display:"block",width:"auto",overflow:"hidden"}},[s("math",{xmlns:"http://www.w3.org/1998/Math/MathML"},[s("mo",{stretchy:"false"},"("),s("msub",null,[s("mi",null,"λ"),s("mn",null,"1")]),s("mo",null,","),s("msub",null,[s("mi",null,"λ"),s("mn",null,"2")]),s("mo",null,","),s("mo",null,"."),s("mo",null,"."),s("mo",null,"."),s("mo",null,","),s("msub",null,[s("mi",null,"λ"),s("mi",null,"n")]),s("mo",{stretchy:"false"},")")])],-1))]),i[13]||(i[13]=a(", each associated with a vertex of the polygon. Any point within the polygon can be expressed as a weighted average of the vertices, where the weights are the generalized barycentric coordinates."))]),i[15]||(i[15]=t(`

As with the triangle case, the weights sum to 1, and each is non-negative.

Example

This example was taken from this page of CGAL's documentation.

julia
using GeometryOps
+using GeometryOps.GeometryBasics
+using Makie
+using CairoMakie
+# Define a polygon
+polygon_points = Point3f[
+(0.03, 0.05, 0.00), (0.07, 0.04, 0.02), (0.10, 0.04, 0.04),
+(0.14, 0.04, 0.06), (0.17, 0.07, 0.08), (0.20, 0.09, 0.10),
+(0.22, 0.11, 0.12), (0.25, 0.11, 0.14), (0.27, 0.10, 0.16),
+(0.30, 0.07, 0.18), (0.31, 0.04, 0.20), (0.34, 0.03, 0.22),
+(0.37, 0.02, 0.24), (0.40, 0.03, 0.26), (0.42, 0.04, 0.28),
+(0.44, 0.07, 0.30), (0.45, 0.10, 0.32), (0.46, 0.13, 0.34),
+(0.46, 0.19, 0.36), (0.47, 0.26, 0.38), (0.47, 0.31, 0.40),
+(0.47, 0.35, 0.42), (0.45, 0.37, 0.44), (0.41, 0.38, 0.46),
+(0.38, 0.37, 0.48), (0.35, 0.36, 0.50), (0.32, 0.35, 0.52),
+(0.30, 0.37, 0.54), (0.28, 0.39, 0.56), (0.25, 0.40, 0.58),
+(0.23, 0.39, 0.60), (0.21, 0.37, 0.62), (0.21, 0.34, 0.64),
+(0.23, 0.32, 0.66), (0.24, 0.29, 0.68), (0.27, 0.24, 0.70),
+(0.29, 0.21, 0.72), (0.29, 0.18, 0.74), (0.26, 0.16, 0.76),
+(0.24, 0.17, 0.78), (0.23, 0.19, 0.80), (0.24, 0.22, 0.82),
+(0.24, 0.25, 0.84), (0.21, 0.26, 0.86), (0.17, 0.26, 0.88),
+(0.12, 0.24, 0.90), (0.07, 0.20, 0.92), (0.03, 0.15, 0.94),
+(0.01, 0.10, 0.97), (0.02, 0.07, 1.00)]
+# Plot it!
+# First, we'll plot the polygon using Makie's rendering:
+f, a1, p1 = poly(
+    Point2d.(polygon_points);
+    color = last.(polygon_points),
+    colormap = cgrad(:jet, 18; categorical = true),
+    axis = (;
+       type = Axis, aspect = DataAspect(), title = "Makie mesh based polygon rendering", subtitle = "CairoMakie"
+    ),
+    figure = (; size = (800, 400),)
+)
+hidedecorations!(a1)
+
+ext = GeometryOps.GI.Extent(X = (0, 0.5), Y = (0, 0.42))
+
+a2 = Axis(
+        f[1, 2],
+        aspect = DataAspect(),
+        title = "Barycentric coordinate based polygon rendering", subtitle = "GeometryOps",
+        limits = (ext.X, ext.Y)
+    )
+hidedecorations!(a2)
+
+p2box = poly!( # Now, we plot a cropping rectangle around the axis so we only show the polygon
+    a2,
+    GeometryOps.GeometryBasics.Polygon( # This is a rectangle with an internal hole shaped like the polygon.
+        Point2f[(ext.X[1], ext.Y[1]), (ext.X[2], ext.Y[1]), (ext.X[2], ext.Y[2]), (ext.X[1], ext.Y[2]), (ext.X[1], ext.Y[1])], # exterior
+        [reverse(Point2f.(polygon_points))] # hole
+    ); color = :white, xautolimits = false, yautolimits = false
+)
+cb = Colorbar(f[2, :], p1.plots[1]; vertical = false, flipaxis = true)
+# Finally, we perform barycentric interpolation on a grid,
+xrange = LinRange(ext.X..., 400)
+yrange = LinRange(ext.Y..., 400)
+@time mean_values = barycentric_interpolate.(
+    (MeanValue(),), # The barycentric coordinate algorithm (MeanValue is the only one for now)
+    (Point2f.(polygon_points),), # The polygon points as \`Point2f\`
+    (last.(polygon_points,),),   # The values per polygon point - can be anything which supports addition and division
+    Point2f.(xrange, yrange')    # The points at which to interpolate
+)
+# and render!
+hm = heatmap!(a2, xrange, yrange, mean_values; colormap = p1.colormap, colorrange = p1.plots[1].colorrange[], xautolimits = false, yautolimits = false)
+translate!(hm, 0, 0, -1) # translate the heatmap behind the cropping polygon!
+f # finally, display the figure

Barycentric-coordinate API

In some cases, we actually want barycentric interpolation, and have no interest in the coordinates themselves.

However, the coordinates can be useful for debugging, and when performing 3D rendering, multiple barycentric values (depth, uv) are needed for depth buffering.

julia
const _VecTypes = Union{Tuple{Vararg{T, N}}, GeometryBasics.StaticArraysCore.StaticArray{Tuple{N}, T, 1}} where {N, T}
+
+"""
+    abstract type AbstractBarycentricCoordinateMethod
+
+Abstract supertype for barycentric coordinate methods.
+The subtypes may serve as dispatch types, or may cache
+some information about the target polygon.
+
+# API
+The following methods must be implemented for all subtypes:
+- \`barycentric_coordinates!(λs::Vector{<: Real}, method::AbstractBarycentricCoordinateMethod, exterior::Vector{<: Point{2, T1}}, point::Point{2, T2})\`
+- \`barycentric_interpolate(method::AbstractBarycentricCoordinateMethod, exterior::Vector{<: Point{2, T1}}, values::Vector{V}, point::Point{2, T2})::V\`
+- \`barycentric_interpolate(method::AbstractBarycentricCoordinateMethod, exterior::Vector{<: Point{2, T1}}, interiors::Vector{<: Vector{<: Point{2, T1}}} values::Vector{V}, point::Point{2, T2})::V\`
+The rest of the methods will be implemented in terms of these, and have efficient dispatches for broadcasting.
+"""
+abstract type AbstractBarycentricCoordinateMethod end
+
+Base.@propagate_inbounds function barycentric_coordinates!(λs::Vector{<: Real}, method::AbstractBarycentricCoordinateMethod, polypoints::AbstractVector{<: Point{N1, T1}}, point::Point{N2, T2}) where {N1, N2, T1 <: Real, T2 <: Real}
+    @boundscheck @assert length(λs) == length(polypoints)
+    @boundscheck @assert length(polypoints) >= 3
+
+    @error("Not implemented yet for method $(method).")
+end
+Base.@propagate_inbounds barycentric_coordinates!(λs::Vector{<: Real}, polypoints::AbstractVector{<: Point{N1, T1}}, point::Point{N2, T2}) where {N1, N2, T1 <: Real, T2 <: Real} = barycentric_coordinates!(λs, MeanValue(), polypoints, point)

This is the GeoInterface-compatible method.

julia
"""
+    barycentric_coordinates!(λs::Vector{<: Real}, method::AbstractBarycentricCoordinateMethod, polygon, point)
+
+Loads the barycentric coordinates of \`point\` in \`polygon\` into \`λs\` using the barycentric coordinate method \`method\`.
+
+\`λs\` must be of the length of the polygon plus its holes.
+
+!!! tip
+    Use this method to avoid excess allocations when you need to calculate barycentric coordinates for many points.
+"""
+Base.@propagate_inbounds function barycentric_coordinates!(λs::Vector{<: Real}, method::AbstractBarycentricCoordinateMethod, polygon, point)
+    @assert GeoInterface.trait(polygon) isa GeoInterface.PolygonTrait
+    @assert GeoInterface.trait(point) isa GeoInterface.PointTrait
+    passable_polygon = GeoInterface.convert(GeometryBasics, polygon)
+    @assert passable_polygon isa GeometryBasics.Polygon "The polygon was converted to a $(typeof(passable_polygon)), which is not a \`GeometryBasics.Polygon\`."
+    passable_point = GeoInterface.convert(GeometryBasics, point)
+    return barycentric_coordinates!(λs, method, passable_polygon, Point2(passable_point))
+end
+
+Base.@propagate_inbounds function barycentric_coordinates(method::AbstractBarycentricCoordinateMethod, polypoints::AbstractVector{<: Point{N1, T1}}, point::Point{N2, T2}) where {N1, N2, T1 <: Real, T2 <: Real}
+    λs = zeros(promote_type(T1, T2), length(polypoints))
+    barycentric_coordinates!(λs, method, polypoints, point)
+    return λs
+end
+Base.@propagate_inbounds barycentric_coordinates(polypoints::AbstractVector{<: Point{N1, T1}}, point::Point{N2, T2}) where {N1, N2, T1 <: Real, T2 <: Real} = barycentric_coordinates(MeanValue(), polypoints, point)

This is the GeoInterface-compatible method.

julia
"""
+    barycentric_coordinates(method = MeanValue(), polygon, point)
+
+Returns the barycentric coordinates of \`point\` in \`polygon\` using the barycentric coordinate method \`method\`.
+"""
+Base.@propagate_inbounds function barycentric_coordinates(method::AbstractBarycentricCoordinateMethod, polygon, point)
+    @assert GeoInterface.trait(polygon) isa GeoInterface.PolygonTrait
+    @assert GeoInterface.trait(point) isa GeoInterface.PointTrait
+    passable_polygon = GeoInterface.convert(GeometryBasics, polygon)
+    @assert passable_polygon isa GeometryBasics.Polygon "The polygon was converted to a $(typeof(passable_polygon)), which is not a \`GeometryBasics.Polygon\`."
+    passable_point = GeoInterface.convert(GeometryBasics, point)
+    return barycentric_coordinates(method, passable_polygon, Point2(passable_point))
+end
+
+Base.@propagate_inbounds function barycentric_interpolate(method::AbstractBarycentricCoordinateMethod, polypoints::AbstractVector{<: Point{N, T1}}, values::AbstractVector{V}, point::Point{N, T2}) where {N, T1 <: Real, T2 <: Real, V}
+    @boundscheck @assert length(values) == length(polypoints)
+    @boundscheck @assert length(polypoints) >= 3
+    λs = barycentric_coordinates(method, polypoints, point)
+    return sum(λs .* values)
+end
+Base.@propagate_inbounds barycentric_interpolate(polypoints::AbstractVector{<: Point{N, T1}}, values::AbstractVector{V}, point::Point{N, T2}) where {N, T1 <: Real, T2 <: Real, V} = barycentric_interpolate(MeanValue(), polypoints, values, point)
+
+Base.@propagate_inbounds function barycentric_interpolate(method::AbstractBarycentricCoordinateMethod, exterior::AbstractVector{<: Point{N, T1}}, interiors::AbstractVector{<: Point{N, T1}}, values::AbstractVector{V}, point::Point{N, T2}) where {N, T1 <: Real, T2 <: Real, V}
+    @boundscheck @assert length(values) == length(exterior) + isempty(interiors) ? 0 : sum(length.(interiors))
+    @boundscheck @assert length(exterior) >= 3
+    λs = barycentric_coordinates(method, exterior, interiors, point)
+    return sum(λs .* values)
+end
+Base.@propagate_inbounds barycentric_interpolate(exterior::AbstractVector{<: Point{N, T1}}, interiors::AbstractVector{<: Point{N, T1}}, values::AbstractVector{V}, point::Point{N, T2}) where {N, T1 <: Real, T2 <: Real, V} = barycentric_interpolate(MeanValue(), exterior, interiors, values, point)
+
+Base.@propagate_inbounds function barycentric_interpolate(method::AbstractBarycentricCoordinateMethod, polygon::Polygon{2, T1}, values::AbstractVector{V}, point::Point{2, T2}) where {T1 <: Real, T2 <: Real, V}
+    exterior = decompose(Point{2, promote_type(T1, T2)}, polygon.exterior)
+    if isempty(polygon.interiors)
+        @boundscheck @assert length(values) == length(exterior)
+        return barycentric_interpolate(method, exterior, values, point)
+    else # the poly has interiors
+        interiors = reverse.(decompose.((Point{2, promote_type(T1, T2)},), polygon.interiors))
+        @boundscheck @assert length(values) == length(exterior) + sum(length.(interiors))
+        return barycentric_interpolate(method, exterior, interiors, values, point)
+    end
+end
+Base.@propagate_inbounds barycentric_interpolate(polygon::Polygon{2, T1}, values::AbstractVector{V}, point::Point{2, T2}) where {T1 <: Real, T2 <: Real, V} = barycentric_interpolate(MeanValue(), polygon, values, point)

3D polygons are considered to have their vertices in the XY plane, and the Z coordinate must represent some value. This is to say that the Z coordinate is interpreted as an M coordinate.

julia
Base.@propagate_inbounds function barycentric_interpolate(method::AbstractBarycentricCoordinateMethod, polygon::Polygon{3, T1}, point::Point{2, T2}) where {T1 <: Real, T2 <: Real}
+    exterior_point3s = decompose(Point{3, promote_type(T1, T2)}, polygon.exterior)
+    exterior_values = getindex.(exterior_point3s, 3)
+    exterior_points = Point2f.(exterior_point3s)
+    if isempty(polygon.interiors)
+        return barycentric_interpolate(method, exterior_points, exterior_values, point)
+    else # the poly has interiors
+        interior_point3s = decompose.((Point{3, promote_type(T1, T2)},), polygon.interiors)
+        interior_values = collect(Iterators.flatten((getindex.(point3s, 3) for point3s in interior_point3s)))
+        interior_points = map(point3s -> Point2f.(point3s), interior_point3s)
+        return barycentric_interpolate(method, exterior_points, interior_points, vcat(exterior_values, interior_values), point)
+    end
+end
+Base.@propagate_inbounds barycentric_interpolate(polygon::Polygon{3, T1}, point::Point{2, T2}) where {T1 <: Real, T2 <: Real} = barycentric_interpolate(MeanValue(), polygon, point)

This method is the one which supports GeoInterface.

julia
"""
+    barycentric_interpolate(method = MeanValue(), polygon, values::AbstractVector{V}, point)
+
+Returns the interpolated value at \`point\` within \`polygon\` using the barycentric coordinate method \`method\`.
+\`values\` are the per-point values for the polygon which are to be interpolated.
+
+Returns an object of type \`V\`.
+
+!!! warning
+    Barycentric interpolation is currently defined only for 2-dimensional polygons.
+    If you pass a 3-D polygon in, the Z coordinate will be used as per-vertex value to be interpolated
+    (the M coordinate in GIS parlance).
+"""
+Base.@propagate_inbounds function barycentric_interpolate(method::AbstractBarycentricCoordinateMethod, polygon, values::AbstractVector{V}, point) where V
+    @assert GeoInterface.trait(polygon) isa GeoInterface.PolygonTrait
+    @assert GeoInterface.trait(point) isa GeoInterface.PointTrait
+    passable_polygon = GeoInterface.convert(GeometryBasics, polygon)
+    @assert passable_polygon isa GeometryBasics.Polygon "The polygon was converted to a $(typeof(passable_polygon)), which is not a \`GeometryBasics.Polygon\`."
+    # first_poly_point = GeoInterface.getpoint(GeoInterface.getexterior(polygon))
+    passable_point = GeoInterface.convert(GeometryBasics, point)
+    return barycentric_interpolate(method, passable_polygon, Point2(passable_point))
+end
+Base.@propagate_inbounds barycentric_interpolate(polygon, values::AbstractVector{V}, point) where V = barycentric_interpolate(MeanValue(), polygon, values, point)
+
+"""
+    weighted_mean(weight::Real, x1, x2)
+
+Returns the weighted mean of \`x1\` and \`x2\`, where \`weight\` is the weight of \`x1\`.
+
+Specifically, calculates \`x1 * weight + x2 * (1 - weight)\`.
+
+!!! note
+    The idea for this method is that you can override this for custom types, like Color types, in extension modules.
+"""
+function weighted_mean(weight::WT, x1, x2) where {WT <: Real}
+    return muladd(x1, weight, x2 * (oneunit(WT) - weight))
+end
+
+
+"""
+    MeanValue() <: AbstractBarycentricCoordinateMethod
+
+This method calculates barycentric coordinates using the mean value method.
+
+# References
+
+"""
+struct MeanValue <: AbstractBarycentricCoordinateMethod
+end

Before we go to the actual implementation, there are some quick and simple utility functions that we need to implement. These are mainly for convenience and code brevity.

julia
"""
+    _det(s1::Point2{T1}, s2::Point2{T2}) where {T1 <: Real, T2 <: Real}
+
+Returns the determinant of the matrix formed by \`hcat\`'ing two points \`s1\` and \`s2\`.
+
+Specifically, this is:
+\`\`\`julia
+s1[1] * s2[2] - s1[2] * s2[1]
+\`\`\`
+"""
+function _det(s1::_VecTypes{2, T1}, s2::_VecTypes{2, T2}) where {T1 <: Real, T2 <: Real}
+    return s1[1] * s2[2] - s1[2] * s2[1]
+end
+
+"""
+    t_value(sᵢ, sᵢ₊₁, rᵢ, rᵢ₊₁)
+
+Returns the "T-value" as described in Hormann's presentation [^HormannPresentation] on how to calculate
+the mean-value coordinate.
+
+Here, \`sᵢ\` is the vector from vertex \`vᵢ\` to the point, and \`rᵢ\` is the norm (length) of \`sᵢ\`.
+\`s\` must be \`Point\` and \`r\` must be real numbers.
+
+\`\`\`math
+tᵢ = \\\\frac{\\\\mathrm{det}\\\\left(sᵢ, sᵢ₊₁\\\\right)}{rᵢ * rᵢ₊₁ + sᵢ ⋅ sᵢ₊₁}
+\`\`\`
+
+[^HormannPresentation]: K. Hormann and N. Sukumar. Generalized Barycentric Coordinates in Computer Graphics and Computational Mechanics. Taylor & Fancis, CRC Press, 2017.
+\`\`\`
+
+"""
+function t_value(sᵢ::_VecTypes{N, T1}, sᵢ₊₁::_VecTypes{N, T1}, rᵢ::T2, rᵢ₊₁::T2) where {N, T1 <: Real, T2 <: Real}
+    return _det(sᵢ, sᵢ₊₁) / muladd(rᵢ, rᵢ₊₁, dot(sᵢ, sᵢ₊₁))
+end
+
+
+function barycentric_coordinates!(λs::Vector{<: Real}, ::MeanValue, polypoints::AbstractVector{<: Point{2, T1}}, point::Point{2, T2}) where {T1 <: Real, T2 <: Real}
+    @boundscheck @assert length(λs) == length(polypoints)
+    @boundscheck @assert length(polypoints) >= 3
+    n_points = length(polypoints)
+    # Initialize counters and register variables
+    # Points - these are actually vectors from point to vertices
+    #  polypoints[i-1], polypoints[i], polypoints[i+1]
+    sᵢ₋₁ = polypoints[end] - point
+    sᵢ   = polypoints[begin] - point
+    sᵢ₊₁ = polypoints[begin+1] - point
+    # radius / Euclidean distance between points.
+    rᵢ₋₁ = norm(sᵢ₋₁)
+    rᵢ   = norm(sᵢ  )
+    rᵢ₊₁ = norm(sᵢ₊₁)
+    # Perform the first computation explicitly, so we can cut down on
+    # a mod in the loop.
+    λs[1] = (t_value(sᵢ₋₁, sᵢ, rᵢ₋₁, rᵢ) + t_value(sᵢ, sᵢ₊₁, rᵢ, rᵢ₊₁)) / rᵢ
+    # Loop through the rest of the vertices, compute, store in λs
+    for i in 2:n_points
+        # Increment counters + set variables
+        sᵢ₋₁ = sᵢ
+        sᵢ   = sᵢ₊₁
+        sᵢ₊₁ = polypoints[mod1(i+1, n_points)] - point
+        rᵢ₋₁ = rᵢ
+        rᵢ   = rᵢ₊₁
+        rᵢ₊₁ = norm(sᵢ₊₁) # radius / Euclidean distance between points.
+        λs[i] = (t_value(sᵢ₋₁, sᵢ, rᵢ₋₁, rᵢ) + t_value(sᵢ, sᵢ₊₁, rᵢ, rᵢ₊₁)) / rᵢ
+    end
+    # Normalize λs to the 1-norm (sum=1)
+    λs ./= sum(λs)
+    return λs
+end
julia
function barycentric_coordinates(::MeanValue, polypoints::NTuple{N, Point{2, T2}}, point::Point{2, T1},) where {N, T1, T2}
+    ## Initialize counters and register variables
+    ## Points - these are actually vectors from point to vertices
+    ##  polypoints[i-1], polypoints[i], polypoints[i+1]
+    sᵢ₋₁ = polypoints[end] - point
+    sᵢ   = polypoints[begin] - point
+    sᵢ₊₁ = polypoints[begin+1] - point
+    ## radius / Euclidean distance between points.
+    rᵢ₋₁ = norm(sᵢ₋₁)
+    rᵢ   = norm(sᵢ  )
+    rᵢ₊₁ = norm(sᵢ₊₁)
+    λ₁ = (t_value(sᵢ₋₁, sᵢ, rᵢ₋₁, rᵢ) + t_value(sᵢ, sᵢ₊₁, rᵢ, rᵢ₊₁)) / rᵢ
+    λs = ntuple(N) do i
+        if i == 1
+            return λ₁
+        end
+        ## Increment counters + set variables
+        sᵢ₋₁ = sᵢ
+        sᵢ   = sᵢ₊₁
+        sᵢ₊₁ = polypoints[mod1(i+1, N)] - point
+        rᵢ₋₁ = rᵢ
+        rᵢ   = rᵢ₊₁
+        rᵢ₊₁ = norm(sᵢ₊₁) # radius / Euclidean distance between points.
+        return (t_value(sᵢ₋₁, sᵢ, rᵢ₋₁, rᵢ) + t_value(sᵢ, sᵢ₊₁, rᵢ, rᵢ₊₁)) / rᵢ
+    end
+
+    ∑λ = sum(λs)
+
+    return ntuple(N) do i
+        λs[i] / ∑λ
+    end
+end

This performs an inplace accumulation, using less memory and is faster. That's particularly good if you are using a polygon with a large number of points...

julia
function barycentric_interpolate(::MeanValue, polypoints::AbstractVector{<: Point{2, T1}}, values::AbstractVector{V}, point::Point{2, T2}) where {T1 <: Real, T2 <: Real, V}
+    @boundscheck @assert length(values) == length(polypoints)
+    @boundscheck @assert length(polypoints) >= 3
+
+    n_points = length(polypoints)
+    # Initialize counters and register variables
+    # Points - these are actually vectors from point to vertices
+    #  polypoints[i-1], polypoints[i], polypoints[i+1]
+    sᵢ₋₁ = polypoints[end] - point
+    sᵢ   = polypoints[begin] - point
+    sᵢ₊₁ = polypoints[begin+1] - point
+    # radius / Euclidean distance between points.
+    rᵢ₋₁ = norm(sᵢ₋₁)
+    rᵢ   = norm(sᵢ  )
+    rᵢ₊₁ = norm(sᵢ₊₁)
+    # Now, we set the interpolated value to the first point's value, multiplied
+    # by the weight computed relative to the first point in the polygon.
+    wᵢ = (t_value(sᵢ₋₁, sᵢ, rᵢ₋₁, rᵢ) + t_value(sᵢ, sᵢ₊₁, rᵢ, rᵢ₊₁)) / rᵢ
+    wₜₒₜ = wᵢ
+    interpolated_value = values[begin] * wᵢ
+    for i in 2:n_points
+        # Increment counters + set variables
+        sᵢ₋₁ = sᵢ
+        sᵢ   = sᵢ₊₁
+        sᵢ₊₁ = polypoints[mod1(i+1, n_points)] - point
+        rᵢ₋₁ = rᵢ
+        rᵢ   = rᵢ₊₁
+        rᵢ₊₁ = norm(sᵢ₊₁)
+        # Now, we calculate the weight:
+        wᵢ = (t_value(sᵢ₋₁, sᵢ, rᵢ₋₁, rᵢ) + t_value(sᵢ, sᵢ₊₁, rᵢ, rᵢ₊₁)) / rᵢ
+        # perform a weighted sum with the interpolated value:
+        interpolated_value += values[i] * wᵢ
+        # and add the weight to the total weight accumulator.
+        wₜₒₜ += wᵢ
+    end
+    # Return the normalized interpolated value.
+    return interpolated_value / wₜₒₜ
+end

When you have holes, then you have to be careful about the order you iterate around points.

Specifically, you have to iterate around each linear ring separately and ensure there are no degenerate/repeated points at the start and end!

julia
function barycentric_interpolate(::MeanValue, exterior::AbstractVector{<: Point{N, T1}}, interiors::AbstractVector{<: AbstractVector{<: Point{N, T1}}}, values::AbstractVector{V}, point::Point{N, T2}) where {N, T1 <: Real, T2 <: Real, V}
+    # @boundscheck @assert length(values) == (length(exterior) + isempty(interiors) ? 0 : sum(length.(interiors)))
+    # @boundscheck @assert length(exterior) >= 3
+
+    current_index = 1
+    l_exterior = length(exterior)
+
+    sᵢ₋₁ = exterior[end] - point
+    sᵢ   = exterior[begin] - point
+    sᵢ₊₁ = exterior[begin+1] - point
+    rᵢ₋₁ = norm(sᵢ₋₁) # radius / Euclidean distance between points.
+    rᵢ   = norm(sᵢ  ) # radius / Euclidean distance between points.
+    rᵢ₊₁ = norm(sᵢ₊₁) # radius / Euclidean distance between points.

Now, we set the interpolated value to the first point's value, multiplied by the weight computed relative to the first point in the polygon.

julia
    wᵢ = (t_value(sᵢ₋₁, sᵢ, rᵢ₋₁, rᵢ) + t_value(sᵢ, sᵢ₊₁, rᵢ, rᵢ₊₁)) / rᵢ
+    wₜₒₜ = wᵢ
+    interpolated_value = values[begin] * wᵢ
+
+    for i in 2:l_exterior

Increment counters + set variables

julia
        sᵢ₋₁ = sᵢ
+        sᵢ   = sᵢ₊₁
+        sᵢ₊₁ = exterior[mod1(i+1, l_exterior)] - point
+        rᵢ₋₁ = rᵢ
+        rᵢ   = rᵢ₊₁
+        rᵢ₊₁ = norm(sᵢ₊₁) # radius / Euclidean distance between points.
+        wᵢ = (t_value(sᵢ₋₁, sᵢ, rᵢ₋₁, rᵢ) + t_value(sᵢ, sᵢ₊₁, rᵢ, rᵢ₊₁)) / rᵢ

Updates - first the interpolated value,

julia
        interpolated_value += values[current_index] * wᵢ

then the accumulators for total weight and current index.

julia
        wₜₒₜ += wᵢ
+        current_index += 1
+
+    end
+    for hole in interiors
+        l_hole = length(hole)
+        sᵢ₋₁ = hole[end] - point
+        sᵢ   = hole[begin] - point
+        sᵢ₊₁ = hole[begin+1] - point
+        rᵢ₋₁ = norm(sᵢ₋₁) # radius / Euclidean distance between points.
+        rᵢ   = norm(sᵢ  ) # radius / Euclidean distance between points.
+        rᵢ₊₁ = norm(sᵢ₊₁) # radius / Euclidean distance between points.
+        # Now, we set the interpolated value to the first point's value, multiplied
+        # by the weight computed relative to the first point in the polygon.
+        wᵢ = (t_value(sᵢ₋₁, sᵢ, rᵢ₋₁, rᵢ) + t_value(sᵢ, sᵢ₊₁, rᵢ, rᵢ₊₁)) / rᵢ
+
+        interpolated_value += values[current_index] * wᵢ
+
+        wₜₒₜ += wᵢ
+        current_index += 1
+
+        for i in 2:l_hole
+            # Increment counters + set variables
+            sᵢ₋₁ = sᵢ
+            sᵢ   = sᵢ₊₁
+            sᵢ₊₁ = hole[mod1(i+1, l_hole)] - point
+            rᵢ₋₁ = rᵢ
+            rᵢ   = rᵢ₊₁
+            rᵢ₊₁ = norm(sᵢ₊₁) ## radius / Euclidean distance between points.
+            wᵢ = (t_value(sᵢ₋₁, sᵢ, rᵢ₋₁, rᵢ) + t_value(sᵢ, sᵢ₊₁, rᵢ, rᵢ₊₁)) / rᵢ
+            interpolated_value += values[current_index] * wᵢ
+            wₜₒₜ += wᵢ
+            current_index += 1
+        end
+    end
+    return interpolated_value / wₜₒₜ
+
+end
+
+struct Wachspress <: AbstractBarycentricCoordinateMethod
+end

This page was generated using Literate.jl.

`,35))])}const b=k(p,[["render",C]]);export{m as __pageData,b as default}; diff --git a/previews/PR237/assets/source_methods_barycentric.md.BBVjpi4w.lean.js b/previews/PR237/assets/source_methods_barycentric.md.BBVjpi4w.lean.js new file mode 100644 index 000000000..b0a244112 --- /dev/null +++ b/previews/PR237/assets/source_methods_barycentric.md.BBVjpi4w.lean.js @@ -0,0 +1,415 @@ +import{_ as k,c as n,a5 as t,j as s,a,o as h}from"./chunks/framework.Cq8AuEls.js";const l="/GeometryOps.jl/previews/PR237/assets/tztfann.pAYw0Yqf.png",m=JSON.parse('{"title":"Barycentric coordinates","description":"","frontmatter":{},"headers":[],"relativePath":"source/methods/barycentric.md","filePath":"source/methods/barycentric.md","lastUpdated":null}'),p={name:"source/methods/barycentric.md"},e={class:"MathJax",jax:"SVG",style:{direction:"ltr",position:"relative"}},E={style:{overflow:"visible","min-height":"1px","min-width":"1px","vertical-align":"-0.566ex"},xmlns:"http://www.w3.org/2000/svg",width:"10.692ex",height:"2.262ex",role:"img",focusable:"false",viewBox:"0 -750 4726 1000","aria-hidden":"true"},r={class:"MathJax",jax:"SVG",style:{direction:"ltr",position:"relative"}},d={style:{overflow:"visible","min-height":"1px","min-width":"1px","vertical-align":"-0.025ex"},xmlns:"http://www.w3.org/2000/svg",width:"1.357ex",height:"1.025ex",role:"img",focusable:"false",viewBox:"0 -442 600 453","aria-hidden":"true"},g={class:"MathJax",jax:"SVG",style:{direction:"ltr",position:"relative"}},y={style:{overflow:"visible","min-height":"1px","min-width":"1px","vertical-align":"-0.025ex"},xmlns:"http://www.w3.org/2000/svg",width:"1.357ex",height:"1.025ex",role:"img",focusable:"false",viewBox:"0 -442 600 453","aria-hidden":"true"},F={class:"MathJax",jax:"SVG",style:{direction:"ltr",position:"relative"}},o={style:{overflow:"visible","min-height":"1px","min-width":"1px","vertical-align":"-0.566ex"},xmlns:"http://www.w3.org/2000/svg",width:"14.876ex",height:"2.262ex",role:"img",focusable:"false",viewBox:"0 -750 6575.4 1000","aria-hidden":"true"};function C(c,i,B,A,D,u){return h(),n("div",null,[i[14]||(i[14]=t(`

Barycentric coordinates

julia
export barycentric_coordinates, barycentric_coordinates!, barycentric_interpolate
+export MeanValue

Generalized barycentric coordinates are a generalization of barycentric coordinates, which are typically used in triangles, to arbitrary polygons.

They provide a way to express a point within a polygon as a weighted average of the polygon's vertices.

`,4)),s("p",null,[i[2]||(i[2]=a("In the case of a triangle, barycentric coordinates are a set of three numbers ")),s("mjx-container",e,[(h(),n("svg",E,i[0]||(i[0]=[t('',1)]))),i[1]||(i[1]=s("mjx-assistive-mml",{unselectable:"on",display:"inline",style:{top:"0px",left:"0px",clip:"rect(1px, 1px, 1px, 1px)","-webkit-touch-callout":"none","-webkit-user-select":"none","-khtml-user-select":"none","-moz-user-select":"none","-ms-user-select":"none","user-select":"none",position:"absolute",padding:"1px 0px 0px 0px",border:"0px",display:"block",width:"auto",overflow:"hidden"}},[s("math",{xmlns:"http://www.w3.org/1998/Math/MathML"},[s("mo",{stretchy:"false"},"("),s("msub",null,[s("mi",null,"λ"),s("mn",null,"1")]),s("mo",null,","),s("msub",null,[s("mi",null,"λ"),s("mn",null,"2")]),s("mo",null,","),s("msub",null,[s("mi",null,"λ"),s("mn",null,"3")]),s("mo",{stretchy:"false"},")")])],-1))]),i[3]||(i[3]=a(", each associated with a vertex of the triangle. Any point within the triangle can be expressed as a weighted average of the vertices, where the weights are the barycentric coordinates. The weights sum to 1, and each is non-negative."))]),s("p",null,[i[10]||(i[10]=a("For a polygon with ")),s("mjx-container",r,[(h(),n("svg",d,i[4]||(i[4]=[s("g",{stroke:"currentColor",fill:"currentColor","stroke-width":"0",transform:"scale(1,-1)"},[s("g",{"data-mml-node":"math"},[s("g",{"data-mml-node":"mi"},[s("path",{"data-c":"1D45B",d:"M21 287Q22 293 24 303T36 341T56 388T89 425T135 442Q171 442 195 424T225 390T231 369Q231 367 232 367L243 378Q304 442 382 442Q436 442 469 415T503 336T465 179T427 52Q427 26 444 26Q450 26 453 27Q482 32 505 65T540 145Q542 153 560 153Q580 153 580 145Q580 144 576 130Q568 101 554 73T508 17T439 -10Q392 -10 371 17T350 73Q350 92 386 193T423 345Q423 404 379 404H374Q288 404 229 303L222 291L189 157Q156 26 151 16Q138 -11 108 -11Q95 -11 87 -5T76 7T74 17Q74 30 112 180T152 343Q153 348 153 366Q153 405 129 405Q91 405 66 305Q60 285 60 284Q58 278 41 278H27Q21 284 21 287Z",style:{"stroke-width":"3"}})])])],-1)]))),i[5]||(i[5]=s("mjx-assistive-mml",{unselectable:"on",display:"inline",style:{top:"0px",left:"0px",clip:"rect(1px, 1px, 1px, 1px)","-webkit-touch-callout":"none","-webkit-user-select":"none","-khtml-user-select":"none","-moz-user-select":"none","-ms-user-select":"none","user-select":"none",position:"absolute",padding:"1px 0px 0px 0px",border:"0px",display:"block",width:"auto",overflow:"hidden"}},[s("math",{xmlns:"http://www.w3.org/1998/Math/MathML"},[s("mi",null,"n")])],-1))]),i[11]||(i[11]=a(" vertices, generalized barycentric coordinates are a set of ")),s("mjx-container",g,[(h(),n("svg",y,i[6]||(i[6]=[s("g",{stroke:"currentColor",fill:"currentColor","stroke-width":"0",transform:"scale(1,-1)"},[s("g",{"data-mml-node":"math"},[s("g",{"data-mml-node":"mi"},[s("path",{"data-c":"1D45B",d:"M21 287Q22 293 24 303T36 341T56 388T89 425T135 442Q171 442 195 424T225 390T231 369Q231 367 232 367L243 378Q304 442 382 442Q436 442 469 415T503 336T465 179T427 52Q427 26 444 26Q450 26 453 27Q482 32 505 65T540 145Q542 153 560 153Q580 153 580 145Q580 144 576 130Q568 101 554 73T508 17T439 -10Q392 -10 371 17T350 73Q350 92 386 193T423 345Q423 404 379 404H374Q288 404 229 303L222 291L189 157Q156 26 151 16Q138 -11 108 -11Q95 -11 87 -5T76 7T74 17Q74 30 112 180T152 343Q153 348 153 366Q153 405 129 405Q91 405 66 305Q60 285 60 284Q58 278 41 278H27Q21 284 21 287Z",style:{"stroke-width":"3"}})])])],-1)]))),i[7]||(i[7]=s("mjx-assistive-mml",{unselectable:"on",display:"inline",style:{top:"0px",left:"0px",clip:"rect(1px, 1px, 1px, 1px)","-webkit-touch-callout":"none","-webkit-user-select":"none","-khtml-user-select":"none","-moz-user-select":"none","-ms-user-select":"none","user-select":"none",position:"absolute",padding:"1px 0px 0px 0px",border:"0px",display:"block",width:"auto",overflow:"hidden"}},[s("math",{xmlns:"http://www.w3.org/1998/Math/MathML"},[s("mi",null,"n")])],-1))]),i[12]||(i[12]=a(" numbers ")),s("mjx-container",F,[(h(),n("svg",o,i[8]||(i[8]=[t('',1)]))),i[9]||(i[9]=s("mjx-assistive-mml",{unselectable:"on",display:"inline",style:{top:"0px",left:"0px",clip:"rect(1px, 1px, 1px, 1px)","-webkit-touch-callout":"none","-webkit-user-select":"none","-khtml-user-select":"none","-moz-user-select":"none","-ms-user-select":"none","user-select":"none",position:"absolute",padding:"1px 0px 0px 0px",border:"0px",display:"block",width:"auto",overflow:"hidden"}},[s("math",{xmlns:"http://www.w3.org/1998/Math/MathML"},[s("mo",{stretchy:"false"},"("),s("msub",null,[s("mi",null,"λ"),s("mn",null,"1")]),s("mo",null,","),s("msub",null,[s("mi",null,"λ"),s("mn",null,"2")]),s("mo",null,","),s("mo",null,"."),s("mo",null,"."),s("mo",null,"."),s("mo",null,","),s("msub",null,[s("mi",null,"λ"),s("mi",null,"n")]),s("mo",{stretchy:"false"},")")])],-1))]),i[13]||(i[13]=a(", each associated with a vertex of the polygon. Any point within the polygon can be expressed as a weighted average of the vertices, where the weights are the generalized barycentric coordinates."))]),i[15]||(i[15]=t(`

As with the triangle case, the weights sum to 1, and each is non-negative.

Example

This example was taken from this page of CGAL's documentation.

julia
using GeometryOps
+using GeometryOps.GeometryBasics
+using Makie
+using CairoMakie
+# Define a polygon
+polygon_points = Point3f[
+(0.03, 0.05, 0.00), (0.07, 0.04, 0.02), (0.10, 0.04, 0.04),
+(0.14, 0.04, 0.06), (0.17, 0.07, 0.08), (0.20, 0.09, 0.10),
+(0.22, 0.11, 0.12), (0.25, 0.11, 0.14), (0.27, 0.10, 0.16),
+(0.30, 0.07, 0.18), (0.31, 0.04, 0.20), (0.34, 0.03, 0.22),
+(0.37, 0.02, 0.24), (0.40, 0.03, 0.26), (0.42, 0.04, 0.28),
+(0.44, 0.07, 0.30), (0.45, 0.10, 0.32), (0.46, 0.13, 0.34),
+(0.46, 0.19, 0.36), (0.47, 0.26, 0.38), (0.47, 0.31, 0.40),
+(0.47, 0.35, 0.42), (0.45, 0.37, 0.44), (0.41, 0.38, 0.46),
+(0.38, 0.37, 0.48), (0.35, 0.36, 0.50), (0.32, 0.35, 0.52),
+(0.30, 0.37, 0.54), (0.28, 0.39, 0.56), (0.25, 0.40, 0.58),
+(0.23, 0.39, 0.60), (0.21, 0.37, 0.62), (0.21, 0.34, 0.64),
+(0.23, 0.32, 0.66), (0.24, 0.29, 0.68), (0.27, 0.24, 0.70),
+(0.29, 0.21, 0.72), (0.29, 0.18, 0.74), (0.26, 0.16, 0.76),
+(0.24, 0.17, 0.78), (0.23, 0.19, 0.80), (0.24, 0.22, 0.82),
+(0.24, 0.25, 0.84), (0.21, 0.26, 0.86), (0.17, 0.26, 0.88),
+(0.12, 0.24, 0.90), (0.07, 0.20, 0.92), (0.03, 0.15, 0.94),
+(0.01, 0.10, 0.97), (0.02, 0.07, 1.00)]
+# Plot it!
+# First, we'll plot the polygon using Makie's rendering:
+f, a1, p1 = poly(
+    Point2d.(polygon_points);
+    color = last.(polygon_points),
+    colormap = cgrad(:jet, 18; categorical = true),
+    axis = (;
+       type = Axis, aspect = DataAspect(), title = "Makie mesh based polygon rendering", subtitle = "CairoMakie"
+    ),
+    figure = (; size = (800, 400),)
+)
+hidedecorations!(a1)
+
+ext = GeometryOps.GI.Extent(X = (0, 0.5), Y = (0, 0.42))
+
+a2 = Axis(
+        f[1, 2],
+        aspect = DataAspect(),
+        title = "Barycentric coordinate based polygon rendering", subtitle = "GeometryOps",
+        limits = (ext.X, ext.Y)
+    )
+hidedecorations!(a2)
+
+p2box = poly!( # Now, we plot a cropping rectangle around the axis so we only show the polygon
+    a2,
+    GeometryOps.GeometryBasics.Polygon( # This is a rectangle with an internal hole shaped like the polygon.
+        Point2f[(ext.X[1], ext.Y[1]), (ext.X[2], ext.Y[1]), (ext.X[2], ext.Y[2]), (ext.X[1], ext.Y[2]), (ext.X[1], ext.Y[1])], # exterior
+        [reverse(Point2f.(polygon_points))] # hole
+    ); color = :white, xautolimits = false, yautolimits = false
+)
+cb = Colorbar(f[2, :], p1.plots[1]; vertical = false, flipaxis = true)
+# Finally, we perform barycentric interpolation on a grid,
+xrange = LinRange(ext.X..., 400)
+yrange = LinRange(ext.Y..., 400)
+@time mean_values = barycentric_interpolate.(
+    (MeanValue(),), # The barycentric coordinate algorithm (MeanValue is the only one for now)
+    (Point2f.(polygon_points),), # The polygon points as \`Point2f\`
+    (last.(polygon_points,),),   # The values per polygon point - can be anything which supports addition and division
+    Point2f.(xrange, yrange')    # The points at which to interpolate
+)
+# and render!
+hm = heatmap!(a2, xrange, yrange, mean_values; colormap = p1.colormap, colorrange = p1.plots[1].colorrange[], xautolimits = false, yautolimits = false)
+translate!(hm, 0, 0, -1) # translate the heatmap behind the cropping polygon!
+f # finally, display the figure

Barycentric-coordinate API

In some cases, we actually want barycentric interpolation, and have no interest in the coordinates themselves.

However, the coordinates can be useful for debugging, and when performing 3D rendering, multiple barycentric values (depth, uv) are needed for depth buffering.

julia
const _VecTypes = Union{Tuple{Vararg{T, N}}, GeometryBasics.StaticArraysCore.StaticArray{Tuple{N}, T, 1}} where {N, T}
+
+"""
+    abstract type AbstractBarycentricCoordinateMethod
+
+Abstract supertype for barycentric coordinate methods.
+The subtypes may serve as dispatch types, or may cache
+some information about the target polygon.
+
+# API
+The following methods must be implemented for all subtypes:
+- \`barycentric_coordinates!(λs::Vector{<: Real}, method::AbstractBarycentricCoordinateMethod, exterior::Vector{<: Point{2, T1}}, point::Point{2, T2})\`
+- \`barycentric_interpolate(method::AbstractBarycentricCoordinateMethod, exterior::Vector{<: Point{2, T1}}, values::Vector{V}, point::Point{2, T2})::V\`
+- \`barycentric_interpolate(method::AbstractBarycentricCoordinateMethod, exterior::Vector{<: Point{2, T1}}, interiors::Vector{<: Vector{<: Point{2, T1}}} values::Vector{V}, point::Point{2, T2})::V\`
+The rest of the methods will be implemented in terms of these, and have efficient dispatches for broadcasting.
+"""
+abstract type AbstractBarycentricCoordinateMethod end
+
+Base.@propagate_inbounds function barycentric_coordinates!(λs::Vector{<: Real}, method::AbstractBarycentricCoordinateMethod, polypoints::AbstractVector{<: Point{N1, T1}}, point::Point{N2, T2}) where {N1, N2, T1 <: Real, T2 <: Real}
+    @boundscheck @assert length(λs) == length(polypoints)
+    @boundscheck @assert length(polypoints) >= 3
+
+    @error("Not implemented yet for method $(method).")
+end
+Base.@propagate_inbounds barycentric_coordinates!(λs::Vector{<: Real}, polypoints::AbstractVector{<: Point{N1, T1}}, point::Point{N2, T2}) where {N1, N2, T1 <: Real, T2 <: Real} = barycentric_coordinates!(λs, MeanValue(), polypoints, point)

This is the GeoInterface-compatible method.

julia
"""
+    barycentric_coordinates!(λs::Vector{<: Real}, method::AbstractBarycentricCoordinateMethod, polygon, point)
+
+Loads the barycentric coordinates of \`point\` in \`polygon\` into \`λs\` using the barycentric coordinate method \`method\`.
+
+\`λs\` must be of the length of the polygon plus its holes.
+
+!!! tip
+    Use this method to avoid excess allocations when you need to calculate barycentric coordinates for many points.
+"""
+Base.@propagate_inbounds function barycentric_coordinates!(λs::Vector{<: Real}, method::AbstractBarycentricCoordinateMethod, polygon, point)
+    @assert GeoInterface.trait(polygon) isa GeoInterface.PolygonTrait
+    @assert GeoInterface.trait(point) isa GeoInterface.PointTrait
+    passable_polygon = GeoInterface.convert(GeometryBasics, polygon)
+    @assert passable_polygon isa GeometryBasics.Polygon "The polygon was converted to a $(typeof(passable_polygon)), which is not a \`GeometryBasics.Polygon\`."
+    passable_point = GeoInterface.convert(GeometryBasics, point)
+    return barycentric_coordinates!(λs, method, passable_polygon, Point2(passable_point))
+end
+
+Base.@propagate_inbounds function barycentric_coordinates(method::AbstractBarycentricCoordinateMethod, polypoints::AbstractVector{<: Point{N1, T1}}, point::Point{N2, T2}) where {N1, N2, T1 <: Real, T2 <: Real}
+    λs = zeros(promote_type(T1, T2), length(polypoints))
+    barycentric_coordinates!(λs, method, polypoints, point)
+    return λs
+end
+Base.@propagate_inbounds barycentric_coordinates(polypoints::AbstractVector{<: Point{N1, T1}}, point::Point{N2, T2}) where {N1, N2, T1 <: Real, T2 <: Real} = barycentric_coordinates(MeanValue(), polypoints, point)

This is the GeoInterface-compatible method.

julia
"""
+    barycentric_coordinates(method = MeanValue(), polygon, point)
+
+Returns the barycentric coordinates of \`point\` in \`polygon\` using the barycentric coordinate method \`method\`.
+"""
+Base.@propagate_inbounds function barycentric_coordinates(method::AbstractBarycentricCoordinateMethod, polygon, point)
+    @assert GeoInterface.trait(polygon) isa GeoInterface.PolygonTrait
+    @assert GeoInterface.trait(point) isa GeoInterface.PointTrait
+    passable_polygon = GeoInterface.convert(GeometryBasics, polygon)
+    @assert passable_polygon isa GeometryBasics.Polygon "The polygon was converted to a $(typeof(passable_polygon)), which is not a \`GeometryBasics.Polygon\`."
+    passable_point = GeoInterface.convert(GeometryBasics, point)
+    return barycentric_coordinates(method, passable_polygon, Point2(passable_point))
+end
+
+Base.@propagate_inbounds function barycentric_interpolate(method::AbstractBarycentricCoordinateMethod, polypoints::AbstractVector{<: Point{N, T1}}, values::AbstractVector{V}, point::Point{N, T2}) where {N, T1 <: Real, T2 <: Real, V}
+    @boundscheck @assert length(values) == length(polypoints)
+    @boundscheck @assert length(polypoints) >= 3
+    λs = barycentric_coordinates(method, polypoints, point)
+    return sum(λs .* values)
+end
+Base.@propagate_inbounds barycentric_interpolate(polypoints::AbstractVector{<: Point{N, T1}}, values::AbstractVector{V}, point::Point{N, T2}) where {N, T1 <: Real, T2 <: Real, V} = barycentric_interpolate(MeanValue(), polypoints, values, point)
+
+Base.@propagate_inbounds function barycentric_interpolate(method::AbstractBarycentricCoordinateMethod, exterior::AbstractVector{<: Point{N, T1}}, interiors::AbstractVector{<: Point{N, T1}}, values::AbstractVector{V}, point::Point{N, T2}) where {N, T1 <: Real, T2 <: Real, V}
+    @boundscheck @assert length(values) == length(exterior) + isempty(interiors) ? 0 : sum(length.(interiors))
+    @boundscheck @assert length(exterior) >= 3
+    λs = barycentric_coordinates(method, exterior, interiors, point)
+    return sum(λs .* values)
+end
+Base.@propagate_inbounds barycentric_interpolate(exterior::AbstractVector{<: Point{N, T1}}, interiors::AbstractVector{<: Point{N, T1}}, values::AbstractVector{V}, point::Point{N, T2}) where {N, T1 <: Real, T2 <: Real, V} = barycentric_interpolate(MeanValue(), exterior, interiors, values, point)
+
+Base.@propagate_inbounds function barycentric_interpolate(method::AbstractBarycentricCoordinateMethod, polygon::Polygon{2, T1}, values::AbstractVector{V}, point::Point{2, T2}) where {T1 <: Real, T2 <: Real, V}
+    exterior = decompose(Point{2, promote_type(T1, T2)}, polygon.exterior)
+    if isempty(polygon.interiors)
+        @boundscheck @assert length(values) == length(exterior)
+        return barycentric_interpolate(method, exterior, values, point)
+    else # the poly has interiors
+        interiors = reverse.(decompose.((Point{2, promote_type(T1, T2)},), polygon.interiors))
+        @boundscheck @assert length(values) == length(exterior) + sum(length.(interiors))
+        return barycentric_interpolate(method, exterior, interiors, values, point)
+    end
+end
+Base.@propagate_inbounds barycentric_interpolate(polygon::Polygon{2, T1}, values::AbstractVector{V}, point::Point{2, T2}) where {T1 <: Real, T2 <: Real, V} = barycentric_interpolate(MeanValue(), polygon, values, point)

3D polygons are considered to have their vertices in the XY plane, and the Z coordinate must represent some value. This is to say that the Z coordinate is interpreted as an M coordinate.

julia
Base.@propagate_inbounds function barycentric_interpolate(method::AbstractBarycentricCoordinateMethod, polygon::Polygon{3, T1}, point::Point{2, T2}) where {T1 <: Real, T2 <: Real}
+    exterior_point3s = decompose(Point{3, promote_type(T1, T2)}, polygon.exterior)
+    exterior_values = getindex.(exterior_point3s, 3)
+    exterior_points = Point2f.(exterior_point3s)
+    if isempty(polygon.interiors)
+        return barycentric_interpolate(method, exterior_points, exterior_values, point)
+    else # the poly has interiors
+        interior_point3s = decompose.((Point{3, promote_type(T1, T2)},), polygon.interiors)
+        interior_values = collect(Iterators.flatten((getindex.(point3s, 3) for point3s in interior_point3s)))
+        interior_points = map(point3s -> Point2f.(point3s), interior_point3s)
+        return barycentric_interpolate(method, exterior_points, interior_points, vcat(exterior_values, interior_values), point)
+    end
+end
+Base.@propagate_inbounds barycentric_interpolate(polygon::Polygon{3, T1}, point::Point{2, T2}) where {T1 <: Real, T2 <: Real} = barycentric_interpolate(MeanValue(), polygon, point)

This method is the one which supports GeoInterface.

julia
"""
+    barycentric_interpolate(method = MeanValue(), polygon, values::AbstractVector{V}, point)
+
+Returns the interpolated value at \`point\` within \`polygon\` using the barycentric coordinate method \`method\`.
+\`values\` are the per-point values for the polygon which are to be interpolated.
+
+Returns an object of type \`V\`.
+
+!!! warning
+    Barycentric interpolation is currently defined only for 2-dimensional polygons.
+    If you pass a 3-D polygon in, the Z coordinate will be used as per-vertex value to be interpolated
+    (the M coordinate in GIS parlance).
+"""
+Base.@propagate_inbounds function barycentric_interpolate(method::AbstractBarycentricCoordinateMethod, polygon, values::AbstractVector{V}, point) where V
+    @assert GeoInterface.trait(polygon) isa GeoInterface.PolygonTrait
+    @assert GeoInterface.trait(point) isa GeoInterface.PointTrait
+    passable_polygon = GeoInterface.convert(GeometryBasics, polygon)
+    @assert passable_polygon isa GeometryBasics.Polygon "The polygon was converted to a $(typeof(passable_polygon)), which is not a \`GeometryBasics.Polygon\`."
+    # first_poly_point = GeoInterface.getpoint(GeoInterface.getexterior(polygon))
+    passable_point = GeoInterface.convert(GeometryBasics, point)
+    return barycentric_interpolate(method, passable_polygon, Point2(passable_point))
+end
+Base.@propagate_inbounds barycentric_interpolate(polygon, values::AbstractVector{V}, point) where V = barycentric_interpolate(MeanValue(), polygon, values, point)
+
+"""
+    weighted_mean(weight::Real, x1, x2)
+
+Returns the weighted mean of \`x1\` and \`x2\`, where \`weight\` is the weight of \`x1\`.
+
+Specifically, calculates \`x1 * weight + x2 * (1 - weight)\`.
+
+!!! note
+    The idea for this method is that you can override this for custom types, like Color types, in extension modules.
+"""
+function weighted_mean(weight::WT, x1, x2) where {WT <: Real}
+    return muladd(x1, weight, x2 * (oneunit(WT) - weight))
+end
+
+
+"""
+    MeanValue() <: AbstractBarycentricCoordinateMethod
+
+This method calculates barycentric coordinates using the mean value method.
+
+# References
+
+"""
+struct MeanValue <: AbstractBarycentricCoordinateMethod
+end

Before we go to the actual implementation, there are some quick and simple utility functions that we need to implement. These are mainly for convenience and code brevity.

julia
"""
+    _det(s1::Point2{T1}, s2::Point2{T2}) where {T1 <: Real, T2 <: Real}
+
+Returns the determinant of the matrix formed by \`hcat\`'ing two points \`s1\` and \`s2\`.
+
+Specifically, this is:
+\`\`\`julia
+s1[1] * s2[2] - s1[2] * s2[1]
+\`\`\`
+"""
+function _det(s1::_VecTypes{2, T1}, s2::_VecTypes{2, T2}) where {T1 <: Real, T2 <: Real}
+    return s1[1] * s2[2] - s1[2] * s2[1]
+end
+
+"""
+    t_value(sᵢ, sᵢ₊₁, rᵢ, rᵢ₊₁)
+
+Returns the "T-value" as described in Hormann's presentation [^HormannPresentation] on how to calculate
+the mean-value coordinate.
+
+Here, \`sᵢ\` is the vector from vertex \`vᵢ\` to the point, and \`rᵢ\` is the norm (length) of \`sᵢ\`.
+\`s\` must be \`Point\` and \`r\` must be real numbers.
+
+\`\`\`math
+tᵢ = \\\\frac{\\\\mathrm{det}\\\\left(sᵢ, sᵢ₊₁\\\\right)}{rᵢ * rᵢ₊₁ + sᵢ ⋅ sᵢ₊₁}
+\`\`\`
+
+[^HormannPresentation]: K. Hormann and N. Sukumar. Generalized Barycentric Coordinates in Computer Graphics and Computational Mechanics. Taylor & Fancis, CRC Press, 2017.
+\`\`\`
+
+"""
+function t_value(sᵢ::_VecTypes{N, T1}, sᵢ₊₁::_VecTypes{N, T1}, rᵢ::T2, rᵢ₊₁::T2) where {N, T1 <: Real, T2 <: Real}
+    return _det(sᵢ, sᵢ₊₁) / muladd(rᵢ, rᵢ₊₁, dot(sᵢ, sᵢ₊₁))
+end
+
+
+function barycentric_coordinates!(λs::Vector{<: Real}, ::MeanValue, polypoints::AbstractVector{<: Point{2, T1}}, point::Point{2, T2}) where {T1 <: Real, T2 <: Real}
+    @boundscheck @assert length(λs) == length(polypoints)
+    @boundscheck @assert length(polypoints) >= 3
+    n_points = length(polypoints)
+    # Initialize counters and register variables
+    # Points - these are actually vectors from point to vertices
+    #  polypoints[i-1], polypoints[i], polypoints[i+1]
+    sᵢ₋₁ = polypoints[end] - point
+    sᵢ   = polypoints[begin] - point
+    sᵢ₊₁ = polypoints[begin+1] - point
+    # radius / Euclidean distance between points.
+    rᵢ₋₁ = norm(sᵢ₋₁)
+    rᵢ   = norm(sᵢ  )
+    rᵢ₊₁ = norm(sᵢ₊₁)
+    # Perform the first computation explicitly, so we can cut down on
+    # a mod in the loop.
+    λs[1] = (t_value(sᵢ₋₁, sᵢ, rᵢ₋₁, rᵢ) + t_value(sᵢ, sᵢ₊₁, rᵢ, rᵢ₊₁)) / rᵢ
+    # Loop through the rest of the vertices, compute, store in λs
+    for i in 2:n_points
+        # Increment counters + set variables
+        sᵢ₋₁ = sᵢ
+        sᵢ   = sᵢ₊₁
+        sᵢ₊₁ = polypoints[mod1(i+1, n_points)] - point
+        rᵢ₋₁ = rᵢ
+        rᵢ   = rᵢ₊₁
+        rᵢ₊₁ = norm(sᵢ₊₁) # radius / Euclidean distance between points.
+        λs[i] = (t_value(sᵢ₋₁, sᵢ, rᵢ₋₁, rᵢ) + t_value(sᵢ, sᵢ₊₁, rᵢ, rᵢ₊₁)) / rᵢ
+    end
+    # Normalize λs to the 1-norm (sum=1)
+    λs ./= sum(λs)
+    return λs
+end
julia
function barycentric_coordinates(::MeanValue, polypoints::NTuple{N, Point{2, T2}}, point::Point{2, T1},) where {N, T1, T2}
+    ## Initialize counters and register variables
+    ## Points - these are actually vectors from point to vertices
+    ##  polypoints[i-1], polypoints[i], polypoints[i+1]
+    sᵢ₋₁ = polypoints[end] - point
+    sᵢ   = polypoints[begin] - point
+    sᵢ₊₁ = polypoints[begin+1] - point
+    ## radius / Euclidean distance between points.
+    rᵢ₋₁ = norm(sᵢ₋₁)
+    rᵢ   = norm(sᵢ  )
+    rᵢ₊₁ = norm(sᵢ₊₁)
+    λ₁ = (t_value(sᵢ₋₁, sᵢ, rᵢ₋₁, rᵢ) + t_value(sᵢ, sᵢ₊₁, rᵢ, rᵢ₊₁)) / rᵢ
+    λs = ntuple(N) do i
+        if i == 1
+            return λ₁
+        end
+        ## Increment counters + set variables
+        sᵢ₋₁ = sᵢ
+        sᵢ   = sᵢ₊₁
+        sᵢ₊₁ = polypoints[mod1(i+1, N)] - point
+        rᵢ₋₁ = rᵢ
+        rᵢ   = rᵢ₊₁
+        rᵢ₊₁ = norm(sᵢ₊₁) # radius / Euclidean distance between points.
+        return (t_value(sᵢ₋₁, sᵢ, rᵢ₋₁, rᵢ) + t_value(sᵢ, sᵢ₊₁, rᵢ, rᵢ₊₁)) / rᵢ
+    end
+
+    ∑λ = sum(λs)
+
+    return ntuple(N) do i
+        λs[i] / ∑λ
+    end
+end

This performs an inplace accumulation, using less memory and is faster. That's particularly good if you are using a polygon with a large number of points...

julia
function barycentric_interpolate(::MeanValue, polypoints::AbstractVector{<: Point{2, T1}}, values::AbstractVector{V}, point::Point{2, T2}) where {T1 <: Real, T2 <: Real, V}
+    @boundscheck @assert length(values) == length(polypoints)
+    @boundscheck @assert length(polypoints) >= 3
+
+    n_points = length(polypoints)
+    # Initialize counters and register variables
+    # Points - these are actually vectors from point to vertices
+    #  polypoints[i-1], polypoints[i], polypoints[i+1]
+    sᵢ₋₁ = polypoints[end] - point
+    sᵢ   = polypoints[begin] - point
+    sᵢ₊₁ = polypoints[begin+1] - point
+    # radius / Euclidean distance between points.
+    rᵢ₋₁ = norm(sᵢ₋₁)
+    rᵢ   = norm(sᵢ  )
+    rᵢ₊₁ = norm(sᵢ₊₁)
+    # Now, we set the interpolated value to the first point's value, multiplied
+    # by the weight computed relative to the first point in the polygon.
+    wᵢ = (t_value(sᵢ₋₁, sᵢ, rᵢ₋₁, rᵢ) + t_value(sᵢ, sᵢ₊₁, rᵢ, rᵢ₊₁)) / rᵢ
+    wₜₒₜ = wᵢ
+    interpolated_value = values[begin] * wᵢ
+    for i in 2:n_points
+        # Increment counters + set variables
+        sᵢ₋₁ = sᵢ
+        sᵢ   = sᵢ₊₁
+        sᵢ₊₁ = polypoints[mod1(i+1, n_points)] - point
+        rᵢ₋₁ = rᵢ
+        rᵢ   = rᵢ₊₁
+        rᵢ₊₁ = norm(sᵢ₊₁)
+        # Now, we calculate the weight:
+        wᵢ = (t_value(sᵢ₋₁, sᵢ, rᵢ₋₁, rᵢ) + t_value(sᵢ, sᵢ₊₁, rᵢ, rᵢ₊₁)) / rᵢ
+        # perform a weighted sum with the interpolated value:
+        interpolated_value += values[i] * wᵢ
+        # and add the weight to the total weight accumulator.
+        wₜₒₜ += wᵢ
+    end
+    # Return the normalized interpolated value.
+    return interpolated_value / wₜₒₜ
+end

When you have holes, then you have to be careful about the order you iterate around points.

Specifically, you have to iterate around each linear ring separately and ensure there are no degenerate/repeated points at the start and end!

julia
function barycentric_interpolate(::MeanValue, exterior::AbstractVector{<: Point{N, T1}}, interiors::AbstractVector{<: AbstractVector{<: Point{N, T1}}}, values::AbstractVector{V}, point::Point{N, T2}) where {N, T1 <: Real, T2 <: Real, V}
+    # @boundscheck @assert length(values) == (length(exterior) + isempty(interiors) ? 0 : sum(length.(interiors)))
+    # @boundscheck @assert length(exterior) >= 3
+
+    current_index = 1
+    l_exterior = length(exterior)
+
+    sᵢ₋₁ = exterior[end] - point
+    sᵢ   = exterior[begin] - point
+    sᵢ₊₁ = exterior[begin+1] - point
+    rᵢ₋₁ = norm(sᵢ₋₁) # radius / Euclidean distance between points.
+    rᵢ   = norm(sᵢ  ) # radius / Euclidean distance between points.
+    rᵢ₊₁ = norm(sᵢ₊₁) # radius / Euclidean distance between points.

Now, we set the interpolated value to the first point's value, multiplied by the weight computed relative to the first point in the polygon.

julia
    wᵢ = (t_value(sᵢ₋₁, sᵢ, rᵢ₋₁, rᵢ) + t_value(sᵢ, sᵢ₊₁, rᵢ, rᵢ₊₁)) / rᵢ
+    wₜₒₜ = wᵢ
+    interpolated_value = values[begin] * wᵢ
+
+    for i in 2:l_exterior

Increment counters + set variables

julia
        sᵢ₋₁ = sᵢ
+        sᵢ   = sᵢ₊₁
+        sᵢ₊₁ = exterior[mod1(i+1, l_exterior)] - point
+        rᵢ₋₁ = rᵢ
+        rᵢ   = rᵢ₊₁
+        rᵢ₊₁ = norm(sᵢ₊₁) # radius / Euclidean distance between points.
+        wᵢ = (t_value(sᵢ₋₁, sᵢ, rᵢ₋₁, rᵢ) + t_value(sᵢ, sᵢ₊₁, rᵢ, rᵢ₊₁)) / rᵢ

Updates - first the interpolated value,

julia
        interpolated_value += values[current_index] * wᵢ

then the accumulators for total weight and current index.

julia
        wₜₒₜ += wᵢ
+        current_index += 1
+
+    end
+    for hole in interiors
+        l_hole = length(hole)
+        sᵢ₋₁ = hole[end] - point
+        sᵢ   = hole[begin] - point
+        sᵢ₊₁ = hole[begin+1] - point
+        rᵢ₋₁ = norm(sᵢ₋₁) # radius / Euclidean distance between points.
+        rᵢ   = norm(sᵢ  ) # radius / Euclidean distance between points.
+        rᵢ₊₁ = norm(sᵢ₊₁) # radius / Euclidean distance between points.
+        # Now, we set the interpolated value to the first point's value, multiplied
+        # by the weight computed relative to the first point in the polygon.
+        wᵢ = (t_value(sᵢ₋₁, sᵢ, rᵢ₋₁, rᵢ) + t_value(sᵢ, sᵢ₊₁, rᵢ, rᵢ₊₁)) / rᵢ
+
+        interpolated_value += values[current_index] * wᵢ
+
+        wₜₒₜ += wᵢ
+        current_index += 1
+
+        for i in 2:l_hole
+            # Increment counters + set variables
+            sᵢ₋₁ = sᵢ
+            sᵢ   = sᵢ₊₁
+            sᵢ₊₁ = hole[mod1(i+1, l_hole)] - point
+            rᵢ₋₁ = rᵢ
+            rᵢ   = rᵢ₊₁
+            rᵢ₊₁ = norm(sᵢ₊₁) ## radius / Euclidean distance between points.
+            wᵢ = (t_value(sᵢ₋₁, sᵢ, rᵢ₋₁, rᵢ) + t_value(sᵢ, sᵢ₊₁, rᵢ, rᵢ₊₁)) / rᵢ
+            interpolated_value += values[current_index] * wᵢ
+            wₜₒₜ += wᵢ
+            current_index += 1
+        end
+    end
+    return interpolated_value / wₜₒₜ
+
+end
+
+struct Wachspress <: AbstractBarycentricCoordinateMethod
+end

This page was generated using Literate.jl.

`,35))])}const b=k(p,[["render",C]]);export{m as __pageData,b as default}; diff --git a/previews/PR237/assets/source_methods_buffer.md.BAri0anf.js b/previews/PR237/assets/source_methods_buffer.md.BAri0anf.js new file mode 100644 index 000000000..6078487ef --- /dev/null +++ b/previews/PR237/assets/source_methods_buffer.md.BAri0anf.js @@ -0,0 +1,11 @@ +import{_ as i,c as a,a5 as n,o as t}from"./chunks/framework.Cq8AuEls.js";const g=JSON.parse('{"title":"Buffer","description":"","frontmatter":{},"headers":[],"relativePath":"source/methods/buffer.md","filePath":"source/methods/buffer.md","lastUpdated":null}'),e={name:"source/methods/buffer.md"};function h(k,s,p,l,r,d){return t(),a("div",null,s[0]||(s[0]=[n(`

Buffer

Buffering a geometry means computing the region distance away from it, and returning that region as the new geometry.

As of now, we only support GEOS as the backend, meaning that LibGEOS must be loaded.

julia
function buffer(geometry, distance; kwargs...)
+    buffered = buffer(GEOS(; kwargs...), geometry, distance)
+    return tuples(buffered)
+end

Below is an error handler similar to the others we have for e.g. segmentize, which checks if there is a method error for the geos backend.

Add an error hint for buffer if LibGEOS is not loaded!

julia
function _buffer_error_hinter(io, exc, argtypes, kwargs)
+    if isnothing(Base.get_extension(GeometryOps, :GeometryOpsLibGEOSExt)) && exc.f == buffer && first(argtypes) == GEOS
+        print(io, "\\n\\nThe \`buffer\` method requires the LibGEOS.jl package to be explicitly loaded.\\n")
+        print(io, "You can do this by simply typing ")
+        printstyled(io, "using LibGEOS"; color = :cyan, bold = true)
+        println(io, " in your REPL, \\nor otherwise loading LibGEOS.jl via using or import.")
+    end
+end

This page was generated using Literate.jl.

`,9)]))}const o=i(e,[["render",h]]);export{g as __pageData,o as default}; diff --git a/previews/PR237/assets/source_methods_buffer.md.BAri0anf.lean.js b/previews/PR237/assets/source_methods_buffer.md.BAri0anf.lean.js new file mode 100644 index 000000000..6078487ef --- /dev/null +++ b/previews/PR237/assets/source_methods_buffer.md.BAri0anf.lean.js @@ -0,0 +1,11 @@ +import{_ as i,c as a,a5 as n,o as t}from"./chunks/framework.Cq8AuEls.js";const g=JSON.parse('{"title":"Buffer","description":"","frontmatter":{},"headers":[],"relativePath":"source/methods/buffer.md","filePath":"source/methods/buffer.md","lastUpdated":null}'),e={name:"source/methods/buffer.md"};function h(k,s,p,l,r,d){return t(),a("div",null,s[0]||(s[0]=[n(`

Buffer

Buffering a geometry means computing the region distance away from it, and returning that region as the new geometry.

As of now, we only support GEOS as the backend, meaning that LibGEOS must be loaded.

julia
function buffer(geometry, distance; kwargs...)
+    buffered = buffer(GEOS(; kwargs...), geometry, distance)
+    return tuples(buffered)
+end

Below is an error handler similar to the others we have for e.g. segmentize, which checks if there is a method error for the geos backend.

Add an error hint for buffer if LibGEOS is not loaded!

julia
function _buffer_error_hinter(io, exc, argtypes, kwargs)
+    if isnothing(Base.get_extension(GeometryOps, :GeometryOpsLibGEOSExt)) && exc.f == buffer && first(argtypes) == GEOS
+        print(io, "\\n\\nThe \`buffer\` method requires the LibGEOS.jl package to be explicitly loaded.\\n")
+        print(io, "You can do this by simply typing ")
+        printstyled(io, "using LibGEOS"; color = :cyan, bold = true)
+        println(io, " in your REPL, \\nor otherwise loading LibGEOS.jl via using or import.")
+    end
+end

This page was generated using Literate.jl.

`,9)]))}const o=i(e,[["render",h]]);export{g as __pageData,o as default}; diff --git a/previews/PR237/assets/source_methods_centroid.md.BZPe_QHV.js b/previews/PR237/assets/source_methods_centroid.md.BZPe_QHV.js new file mode 100644 index 000000000..30edbaa5e --- /dev/null +++ b/previews/PR237/assets/source_methods_centroid.md.BZPe_QHV.js @@ -0,0 +1,93 @@ +import{_ as i,c as a,a5 as n,o as h}from"./chunks/framework.Cq8AuEls.js";const t="/GeometryOps.jl/previews/PR237/assets/icuhega.BD0hVfse.png",k="/GeometryOps.jl/previews/PR237/assets/hkffoiq.DHcwB147.png",o=JSON.parse('{"title":"Centroid","description":"","frontmatter":{},"headers":[],"relativePath":"source/methods/centroid.md","filePath":"source/methods/centroid.md","lastUpdated":null}'),p={name:"source/methods/centroid.md"};function l(e,s,r,E,d,g){return h(),a("div",null,s[0]||(s[0]=[n(`

Centroid

julia
export centroid, centroid_and_length, centroid_and_area

What is the centroid?

The centroid is the geometric center of a line string or area(s). Note that the centroid does not need to be inside of a concave area.

Further note that by convention a line, or linear ring, is calculated by weighting the line segments by their length, while polygons and multipolygon centroids are calculated by weighting edge's by their 'area components'.

To provide an example, consider this concave polygon in the shape of a 'C':

julia
import GeometryOps as GO
+import GeoInterface as GI
+using Makie
+using CairoMakie
+
+cshape = GI.Polygon([[(0,0), (0,3), (3,3), (3,2), (1,2), (1,1), (3,1), (3,0), (0,0)]])
+f, a, p = poly(collect(GI.getpoint(cshape)); axis = (; aspect = DataAspect()))

Let's see what the centroid looks like (plotted in red):

julia
cent = GO.centroid(cshape)
+scatter!(GI.x(cent), GI.y(cent), color = :red)
+f

Implementation

This is the GeoInterface-compatible implementation.

First, we implement a wrapper method that dispatches to the correct implementation based on the geometry trait. This is also used in the implementation, since it's a lot less work!

Note that if you call centroid on a LineString or LinearRing, the centroid_and_length function will be called due to the weighting scheme described above, while centroid_and_area is called for polygons and multipolygons. However, centroid_and_area can still be called on a LineString or LinearRing when they are closed, for example as the interior hole of a polygon.

The helper functions centroid_and_length and centroid_and_area are made available just in case the user also needs the area or length to decrease repeat computation.

julia
"""
+    centroid(geom, [T=Float64])::Tuple{T, T}
+
+Returns the centroid of a given line segment, linear ring, polygon, or
+mutlipolygon.
+"""
+centroid(geom, ::Type{T} = Float64; threaded=false) where T =
+    centroid(GI.trait(geom), geom, T; threaded)
+function centroid(
+    trait::Union{GI.LineStringTrait, GI.LinearRingTrait}, geom, ::Type{T}=Float64; threaded=false
+) where T
+    centroid_and_length(trait, geom, T)[1]
+end
+centroid(trait, geom, ::Type{T}; threaded=false) where T =
+    centroid_and_area(geom, T; threaded)[1]
+
+"""
+    centroid_and_length(geom, [T=Float64])::(::Tuple{T, T}, ::Real)
+
+Returns the centroid and length of a given line/ring. Note this is only valid
+for line strings and linear rings.
+"""
+centroid_and_length(geom, ::Type{T}=Float64) where T =
+    centroid_and_length(GI.trait(geom), geom, T)
+function centroid_and_length(
+    ::Union{GI.LineStringTrait, GI.LinearRingTrait}, geom, ::Type{T},
+) where T

Initialize starting values

julia
    xcentroid = T(0)
+    ycentroid = T(0)
+    length = T(0)
+    point₁ = GI.getpoint(geom, 1)

Loop over line segments of line string

julia
    for point₂ in GI.getpoint(geom)

Calculate length of line segment

julia
        length_component = sqrt(
+            (GI.x(point₂) - GI.x(point₁))^2 +
+            (GI.y(point₂) - GI.y(point₁))^2
+        )

Accumulate the line segment length into length

julia
        length += length_component

Weighted average of line segment centroids

julia
        xcentroid += (GI.x(point₁) + GI.x(point₂)) * (length_component / 2)
+        ycentroid += (GI.y(point₁) + GI.y(point₂)) * (length_component / 2)
+        #centroid = centroid .+ ((point₁ .+ point₂) .* (length_component / 2))

Advance the point buffer by 1 point to move to next line segment

julia
        point₁ = point₂
+    end
+    xcentroid /= length
+    ycentroid /= length
+    return (xcentroid, ycentroid), length
+end
+
+"""
+    centroid_and_area(geom, [T=Float64])::(::Tuple{T, T}, ::Real)
+
+Returns the centroid and area of a given geometry.
+"""
+function centroid_and_area(geom, ::Type{T}=Float64; threaded=false) where T
+    target = TraitTarget{Union{GI.PolygonTrait,GI.LineStringTrait,GI.LinearRingTrait}}()
+    init = (zero(T), zero(T)), zero(T)
+    applyreduce(_combine_centroid_and_area, target, geom; threaded, init) do g
+        _centroid_and_area(GI.trait(g), g, T)
+    end
+end
+
+function _centroid_and_area(
+    ::Union{GI.LineStringTrait, GI.LinearRingTrait}, geom, ::Type{T}
+) where T

Check that the geometry is closed

julia
    @assert(
+        GI.getpoint(geom, 1) == GI.getpoint(geom, GI.ngeom(geom)),
+        "centroid_and_area should only be used with closed geometries"
+    )

Initialize starting values

julia
    xcentroid = T(0)
+    ycentroid = T(0)
+    area = T(0)
+    point₁ = GI.getpoint(geom, 1)

Loop over line segments of linear ring

julia
    for point₂ in GI.getpoint(geom)
+        area_component = GI.x(point₁) * GI.y(point₂) -
+            GI.x(point₂) * GI.y(point₁)

Accumulate the area component into area

julia
        area += area_component

Weighted average of centroid components

julia
        xcentroid += (GI.x(point₁) + GI.x(point₂)) * area_component
+        ycentroid += (GI.y(point₁) + GI.y(point₂)) * area_component

Advance the point buffer by 1 point

julia
        point₁ = point₂
+    end
+    area /= 2
+    xcentroid /= 6area
+    ycentroid /= 6area
+    return (xcentroid, ycentroid), abs(area)
+end
+function _centroid_and_area(::GI.PolygonTrait, geom, ::Type{T}) where T

Exterior ring's centroid and area

julia
    (xcentroid, ycentroid), area = centroid_and_area(GI.getexterior(geom), T)

Weight exterior centroid by area

julia
    xcentroid *= area
+    ycentroid *= area

Loop over any holes within the polygon

julia
    for hole in GI.gethole(geom)

Hole polygon's centroid and area

julia
        (xinterior, yinterior), interior_area = centroid_and_area(hole, T)

Accumulate the area component into area

julia
        area -= interior_area

Weighted average of centroid components

julia
        xcentroid -= xinterior * interior_area
+        ycentroid -= yinterior * interior_area
+    end
+    xcentroid /= area
+    ycentroid /= area
+    return (xcentroid, ycentroid), area
+end

The op argument for _applyreduce and point / area It combines two (point, area) tuples into one, taking the average of the centroid points weighted by the area of the geom they are from.

julia
function _combine_centroid_and_area(((x1, y1), area1), ((x2, y2), area2))
+    area = area1 + area2
+    x = (x1 * area1 + x2 * area2) / area
+    y = (y1 * area1 + y2 * area2) / area
+    return (x, y), area
+end

This page was generated using Literate.jl.

`,57)]))}const c=i(p,[["render",l]]);export{o as __pageData,c as default}; diff --git a/previews/PR237/assets/source_methods_centroid.md.BZPe_QHV.lean.js b/previews/PR237/assets/source_methods_centroid.md.BZPe_QHV.lean.js new file mode 100644 index 000000000..30edbaa5e --- /dev/null +++ b/previews/PR237/assets/source_methods_centroid.md.BZPe_QHV.lean.js @@ -0,0 +1,93 @@ +import{_ as i,c as a,a5 as n,o as h}from"./chunks/framework.Cq8AuEls.js";const t="/GeometryOps.jl/previews/PR237/assets/icuhega.BD0hVfse.png",k="/GeometryOps.jl/previews/PR237/assets/hkffoiq.DHcwB147.png",o=JSON.parse('{"title":"Centroid","description":"","frontmatter":{},"headers":[],"relativePath":"source/methods/centroid.md","filePath":"source/methods/centroid.md","lastUpdated":null}'),p={name:"source/methods/centroid.md"};function l(e,s,r,E,d,g){return h(),a("div",null,s[0]||(s[0]=[n(`

Centroid

julia
export centroid, centroid_and_length, centroid_and_area

What is the centroid?

The centroid is the geometric center of a line string or area(s). Note that the centroid does not need to be inside of a concave area.

Further note that by convention a line, or linear ring, is calculated by weighting the line segments by their length, while polygons and multipolygon centroids are calculated by weighting edge's by their 'area components'.

To provide an example, consider this concave polygon in the shape of a 'C':

julia
import GeometryOps as GO
+import GeoInterface as GI
+using Makie
+using CairoMakie
+
+cshape = GI.Polygon([[(0,0), (0,3), (3,3), (3,2), (1,2), (1,1), (3,1), (3,0), (0,0)]])
+f, a, p = poly(collect(GI.getpoint(cshape)); axis = (; aspect = DataAspect()))

Let's see what the centroid looks like (plotted in red):

julia
cent = GO.centroid(cshape)
+scatter!(GI.x(cent), GI.y(cent), color = :red)
+f

Implementation

This is the GeoInterface-compatible implementation.

First, we implement a wrapper method that dispatches to the correct implementation based on the geometry trait. This is also used in the implementation, since it's a lot less work!

Note that if you call centroid on a LineString or LinearRing, the centroid_and_length function will be called due to the weighting scheme described above, while centroid_and_area is called for polygons and multipolygons. However, centroid_and_area can still be called on a LineString or LinearRing when they are closed, for example as the interior hole of a polygon.

The helper functions centroid_and_length and centroid_and_area are made available just in case the user also needs the area or length to decrease repeat computation.

julia
"""
+    centroid(geom, [T=Float64])::Tuple{T, T}
+
+Returns the centroid of a given line segment, linear ring, polygon, or
+mutlipolygon.
+"""
+centroid(geom, ::Type{T} = Float64; threaded=false) where T =
+    centroid(GI.trait(geom), geom, T; threaded)
+function centroid(
+    trait::Union{GI.LineStringTrait, GI.LinearRingTrait}, geom, ::Type{T}=Float64; threaded=false
+) where T
+    centroid_and_length(trait, geom, T)[1]
+end
+centroid(trait, geom, ::Type{T}; threaded=false) where T =
+    centroid_and_area(geom, T; threaded)[1]
+
+"""
+    centroid_and_length(geom, [T=Float64])::(::Tuple{T, T}, ::Real)
+
+Returns the centroid and length of a given line/ring. Note this is only valid
+for line strings and linear rings.
+"""
+centroid_and_length(geom, ::Type{T}=Float64) where T =
+    centroid_and_length(GI.trait(geom), geom, T)
+function centroid_and_length(
+    ::Union{GI.LineStringTrait, GI.LinearRingTrait}, geom, ::Type{T},
+) where T

Initialize starting values

julia
    xcentroid = T(0)
+    ycentroid = T(0)
+    length = T(0)
+    point₁ = GI.getpoint(geom, 1)

Loop over line segments of line string

julia
    for point₂ in GI.getpoint(geom)

Calculate length of line segment

julia
        length_component = sqrt(
+            (GI.x(point₂) - GI.x(point₁))^2 +
+            (GI.y(point₂) - GI.y(point₁))^2
+        )

Accumulate the line segment length into length

julia
        length += length_component

Weighted average of line segment centroids

julia
        xcentroid += (GI.x(point₁) + GI.x(point₂)) * (length_component / 2)
+        ycentroid += (GI.y(point₁) + GI.y(point₂)) * (length_component / 2)
+        #centroid = centroid .+ ((point₁ .+ point₂) .* (length_component / 2))

Advance the point buffer by 1 point to move to next line segment

julia
        point₁ = point₂
+    end
+    xcentroid /= length
+    ycentroid /= length
+    return (xcentroid, ycentroid), length
+end
+
+"""
+    centroid_and_area(geom, [T=Float64])::(::Tuple{T, T}, ::Real)
+
+Returns the centroid and area of a given geometry.
+"""
+function centroid_and_area(geom, ::Type{T}=Float64; threaded=false) where T
+    target = TraitTarget{Union{GI.PolygonTrait,GI.LineStringTrait,GI.LinearRingTrait}}()
+    init = (zero(T), zero(T)), zero(T)
+    applyreduce(_combine_centroid_and_area, target, geom; threaded, init) do g
+        _centroid_and_area(GI.trait(g), g, T)
+    end
+end
+
+function _centroid_and_area(
+    ::Union{GI.LineStringTrait, GI.LinearRingTrait}, geom, ::Type{T}
+) where T

Check that the geometry is closed

julia
    @assert(
+        GI.getpoint(geom, 1) == GI.getpoint(geom, GI.ngeom(geom)),
+        "centroid_and_area should only be used with closed geometries"
+    )

Initialize starting values

julia
    xcentroid = T(0)
+    ycentroid = T(0)
+    area = T(0)
+    point₁ = GI.getpoint(geom, 1)

Loop over line segments of linear ring

julia
    for point₂ in GI.getpoint(geom)
+        area_component = GI.x(point₁) * GI.y(point₂) -
+            GI.x(point₂) * GI.y(point₁)

Accumulate the area component into area

julia
        area += area_component

Weighted average of centroid components

julia
        xcentroid += (GI.x(point₁) + GI.x(point₂)) * area_component
+        ycentroid += (GI.y(point₁) + GI.y(point₂)) * area_component

Advance the point buffer by 1 point

julia
        point₁ = point₂
+    end
+    area /= 2
+    xcentroid /= 6area
+    ycentroid /= 6area
+    return (xcentroid, ycentroid), abs(area)
+end
+function _centroid_and_area(::GI.PolygonTrait, geom, ::Type{T}) where T

Exterior ring's centroid and area

julia
    (xcentroid, ycentroid), area = centroid_and_area(GI.getexterior(geom), T)

Weight exterior centroid by area

julia
    xcentroid *= area
+    ycentroid *= area

Loop over any holes within the polygon

julia
    for hole in GI.gethole(geom)

Hole polygon's centroid and area

julia
        (xinterior, yinterior), interior_area = centroid_and_area(hole, T)

Accumulate the area component into area

julia
        area -= interior_area

Weighted average of centroid components

julia
        xcentroid -= xinterior * interior_area
+        ycentroid -= yinterior * interior_area
+    end
+    xcentroid /= area
+    ycentroid /= area
+    return (xcentroid, ycentroid), area
+end

The op argument for _applyreduce and point / area It combines two (point, area) tuples into one, taking the average of the centroid points weighted by the area of the geom they are from.

julia
function _combine_centroid_and_area(((x1, y1), area1), ((x2, y2), area2))
+    area = area1 + area2
+    x = (x1 * area1 + x2 * area2) / area
+    y = (y1 * area1 + y2 * area2) / area
+    return (x, y), area
+end

This page was generated using Literate.jl.

`,57)]))}const c=i(p,[["render",l]]);export{o as __pageData,c as default}; diff --git a/previews/PR237/assets/source_methods_clipping_clipping_processor.md.Cn8s_AHy.js b/previews/PR237/assets/source_methods_clipping_clipping_processor.md.Cn8s_AHy.js new file mode 100644 index 000000000..d8dd9e1ed --- /dev/null +++ b/previews/PR237/assets/source_methods_clipping_clipping_processor.md.Cn8s_AHy.js @@ -0,0 +1,508 @@ +import{_ as i,c as a,a5 as n,o as h}from"./chunks/framework.Cq8AuEls.js";const g=JSON.parse('{"title":"Polygon clipping helpers","description":"","frontmatter":{},"headers":[],"relativePath":"source/methods/clipping/clipping_processor.md","filePath":"source/methods/clipping/clipping_processor.md","lastUpdated":null}'),t={name:"source/methods/clipping/clipping_processor.md"};function p(l,s,k,e,E,r){return h(),a("div",null,s[0]||(s[0]=[n(`

Polygon clipping helpers

This file contains the shared helper functions for the polygon clipping functionalities.

This enum defines which side of an edge a point is on

julia
@enum PointEdgeSide left=1 right=2 unknown=3

Constants assigned for readability

julia
const enter, exit = true, false
+const crossing, bouncing = true, false
+
+#= A point can either be the start or end of an overlapping chain of points between two
+polygons, or not an endpoint of a chain. =#
+@enum EndPointType start_chain=1 end_chain=2 not_endpoint=3
+
+#= This is the struct that makes up a_list and b_list. Many values are only used if point is
+an intersection point (ipt). =#
+@kwdef struct PolyNode{T <: AbstractFloat}
+    point::Tuple{T,T}          # (x, y) values of given point
+    inter::Bool = false        # If ipt, true, else 0
+    neighbor::Int = 0          # If ipt, index of equivalent point in a_list or b_list, else 0
+    idx::Int = 0               # If crossing point, index within sorted a_idx_list
+    ent_exit::Bool = false     # If ipt, true if enter and false if exit, else false
+    crossing::Bool = false     # If ipt, true if intersection crosses from out/in polygon, else false
+    endpoint::EndPointType = not_endpoint # If ipt, denotes if point is the start or end of an overlapping chain
+    fracs::Tuple{T,T} = (0., 0.) # If ipt, fractions along edges to ipt (a_frac, b_frac), else (0, 0)
+end
+
+#= Create a new node with all of the same field values as the given PolyNode unless
+alternative values are provided, in which case those should be used. =#
+PolyNode(node::PolyNode{T};
+    point = node.point, inter = node.inter, neighbor = node.neighbor, idx = node.idx,
+    ent_exit = node.ent_exit, crossing = node.crossing, endpoint = node.endpoint,
+    fracs = node.fracs,
+) where T = PolyNode{T}(;
+    point = point, inter = inter, neighbor = neighbor, idx = idx, ent_exit = ent_exit,
+    crossing = crossing, endpoint = endpoint, fracs = fracs)

Checks equality of two PolyNodes by backing point value, fractional value, and intersection status

julia
equals(pn1::PolyNode, pn2::PolyNode) = pn1.point == pn2.point && pn1.inter == pn2.inter && pn1.fracs == pn2.fracs
_build_ab_list(::Type{T}, poly_a, poly_b, delay_cross_f, delay_bounce_f; exact) ->
+    (a_list, b_list, a_idx_list)

This function takes in two polygon rings and calls '_build_a_list', '_build_b_list', and '_flag_ent_exit' in order to fully form a_list and b_list. The 'a_list' and 'b_list' that it returns are the fully updated vectors of PolyNodes that represent the rings 'poly_a' and 'poly_b', respectively. This function also returns 'a_idx_list', which at its "ith" index stores the index in 'a_list' at which the "ith" intersection point lies.

julia
function _build_ab_list(::Type{T}, poly_a, poly_b, delay_cross_f::F1, delay_bounce_f::F2; exact) where {T, F1, F2}

Make a list for nodes of each polygon

julia
    a_list, a_idx_list, n_b_intrs = _build_a_list(T, poly_a, poly_b; exact)
+    b_list = _build_b_list(T, a_idx_list, a_list, n_b_intrs, poly_b)

Flag crossings

julia
    _classify_crossing!(T, a_list, b_list; exact)

Flag the entry and exits

julia
    _flag_ent_exit!(T, GI.LinearRingTrait(), poly_b, a_list, delay_cross_f, Base.Fix2(delay_bounce_f, true); exact)
+    _flag_ent_exit!(T, GI.LinearRingTrait(), poly_a, b_list, delay_cross_f, Base.Fix2(delay_bounce_f, false); exact)

Set node indices and filter a_idx_list to just crossing points

julia
    _index_crossing_intrs!(a_list, b_list, a_idx_list)
+
+    return a_list, b_list, a_idx_list
+end
_build_a_list(::Type{T}, poly_a, poly_b) -> (a_list, a_idx_list)

This function take in two polygon rings and creates a vector of PolyNodes to represent poly_a, including its intersection points with poly_b. The information stored in each PolyNode is needed for clipping using the Greiner-Hormann clipping algorithm.

Note: After calling this function, a_list is not fully formed because the neighboring indices of the intersection points in b_list still need to be updated. Also we still have not update the entry and exit flags for a_list.

The a_idx_list is a list of the indices of intersection points in a_list. The value at index i of a_idx_list is the location in a_list where the ith intersection point lies.

julia
function _build_a_list(::Type{T}, poly_a, poly_b; exact) where T
+    n_a_edges = _nedge(poly_a)
+    a_list = PolyNode{T}[]  # list of points in poly_a
+    sizehint!(a_list, n_a_edges)
+    a_idx_list = Vector{Int}()  # finds indices of intersection points in a_list
+    a_count = 0  # number of points added to a_list
+    n_b_intrs = 0

Loop through points of poly_a

julia
    local a_pt1
+    for (i, a_p2) in enumerate(GI.getpoint(poly_a))
+        a_pt2 = (T(GI.x(a_p2)), T(GI.y(a_p2)))
+        if i <= 1 || (a_pt1 == a_pt2)  # don't repeat points
+            a_pt1 = a_pt2
+            continue
+        end

Add the first point of the edge to the list of points in a_list

julia
        new_point = PolyNode{T}(;point = a_pt1)
+        a_count += 1
+        push!(a_list, new_point)

Find intersections with edges of poly_b

julia
        local b_pt1
+        prev_counter = a_count
+        for (j, b_p2) in enumerate(GI.getpoint(poly_b))
+            b_pt2 = _tuple_point(b_p2, T)
+            if j <= 1 || (b_pt1 == b_pt2)  # don't repeat points
+                b_pt1 = b_pt2
+                continue
+            end

Determine if edges intersect and how they intersect

julia
            line_orient, intr1, intr2 = _intersection_point(T, (a_pt1, a_pt2), (b_pt1, b_pt2); exact)
+            if line_orient != line_out  # edges intersect
+                if line_orient == line_cross  # Intersection point that isn't a vertex
+                    int_pt, fracs = intr1
+                    new_intr = PolyNode{T}(;
+                        point = int_pt, inter = true, neighbor = j - 1,
+                        crossing = true, fracs = fracs,
+                    )
+                    a_count += 1
+                    n_b_intrs += 1
+                    push!(a_list, new_intr)
+                    push!(a_idx_list, a_count)
+                else
+                    (_, (α1, β1)) = intr1

Determine if a1 or b1 should be added to a_list

julia
                    add_a1 = α1 == 0 && 0 β1 < 1
+                    a1_β = add_a1 ? β1 : zero(T)
+                    add_b1 = β1 == 0 && 0 < α1 < 1
+                    b1_α = add_b1 ? α1 : zero(T)

If lines are collinear and overlapping, a second intersection exists

julia
                    if line_orient == line_over
+                        (_, (α2, β2)) = intr2
+                        if α2 == 0 && 0 β2 < 1
+                            add_a1, a1_β = true, β2
+                        end
+                        if β2 == 0 && 0 < α2 < 1
+                            add_b1, b1_α = true, α2
+                        end
+                    end

Add intersection points determined above

julia
                    if add_a1
+                        n_b_intrs += a1_β == 0 ? 0 : 1
+                        a_list[prev_counter] = PolyNode{T}(;
+                            point = a_pt1, inter = true, neighbor = j - 1,
+                            fracs = (zero(T), a1_β),
+                        )
+                        push!(a_idx_list, prev_counter)
+                    end
+                    if add_b1
+                        new_intr = PolyNode{T}(;
+                            point = b_pt1, inter = true, neighbor = j - 1,
+                            fracs = (b1_α, zero(T)),
+                        )
+                        a_count += 1
+                        push!(a_list, new_intr)
+                        push!(a_idx_list, a_count)
+                    end
+                end
+            end
+            b_pt1 = b_pt2
+        end

Order intersection points by placement along edge using fracs value

julia
        if prev_counter < a_count
+            Δintrs = a_count - prev_counter
+            inter_points = @view a_list[(a_count - Δintrs + 1):a_count]
+            sort!(inter_points, by = x -> x.fracs[1])
+        end
+        a_pt1 = a_pt2
+    end
+    return a_list, a_idx_list, n_b_intrs
+end
_build_b_list(::Type{T}, a_idx_list, a_list, poly_b) -> b_list

This function takes in the a_list and a_idx_list build in _build_a_list and poly_b and creates a vector of PolyNodes to represent poly_b. The information stored in each PolyNode is needed for clipping using the Greiner-Hormann clipping algorithm.

Note: after calling this function, b_list is not fully updated. The entry/exit flags still need to be updated. However, the neighbor value in a_list is now updated.

julia
function _build_b_list(::Type{T}, a_idx_list, a_list, n_b_intrs, poly_b) where T

Sort intersection points by insertion order in b_list

julia
    sort!(a_idx_list, by = x-> a_list[x].neighbor + a_list[x].fracs[2])

Initialize needed values and lists

julia
    n_b_edges = _nedge(poly_b)
+    n_intr_pts = length(a_idx_list)
+    b_list = PolyNode{T}[]
+    sizehint!(b_list, n_b_edges + n_b_intrs)
+    intr_curr = 1
+    b_count = 0

Loop over points in poly_b and add each point and intersection point

julia
    local b_pt1
+    for (i, b_p2) in enumerate(GI.getpoint(poly_b))
+        b_pt2 = _tuple_point(b_p2, T)
+        if i  1 || (b_pt1 == b_pt2)  # don't repeat points
+            b_pt1 = b_pt2
+            continue
+        end
+        b_count += 1
+        push!(b_list, PolyNode{T}(; point = b_pt1))
+        if intr_curr  n_intr_pts
+            curr_idx = a_idx_list[intr_curr]
+            curr_node = a_list[curr_idx]
+            prev_counter = b_count
+            while curr_node.neighbor == i - 1  # Add all intersection points on current edge
+                b_idx = 0
+                new_intr = PolyNode(curr_node; neighbor = curr_idx)
+                if curr_node.fracs[2] == 0  # if curr_node is segment start point

intersection point is vertex of b

julia
                    b_idx = prev_counter
+                    b_list[b_idx] = new_intr
+                else
+                    b_count += 1
+                    b_idx = b_count
+                    push!(b_list, new_intr)
+                end
+                a_list[curr_idx] = PolyNode(curr_node; neighbor = b_idx)
+                intr_curr += 1
+                intr_curr > n_intr_pts && break
+                curr_idx = a_idx_list[intr_curr]
+                curr_node = a_list[curr_idx]
+            end
+        end
+        b_pt1 = b_pt2
+    end
+    sort!(a_idx_list)  # return a_idx_list to order of points in a_list
+    return b_list
+end
_classify_crossing!(T, poly_b, a_list; exact)

This function marks all intersection points as either bouncing or crossing points. "Delayed" crossing or bouncing intersections (a chain of edges where the central edges overlap and thus only the first and last edge of the chain determine if the chain is bounding or crossing) are marked as follows: the first and the last points are marked as crossing if the chain is crossing and delayed otherwise and all middle points are marked as bouncing. Additionally, the start and end points of the chain are marked as endpoints using the endpoints field.

julia
function _classify_crossing!(::Type{T}, a_list, b_list; exact) where T
+    napts = length(a_list)
+    nbpts = length(b_list)

start centered on last point

julia
    a_prev = a_list[end - 1]
+    curr_pt = a_list[end]
+    i = napts

keep track of unmatched bouncing chains

julia
    start_chain_edge, start_chain_idx = unknown, 0
+    unmatched_end_chain_edge, unmatched_end_chain_idx = unknown, 0
+    same_winding = true

loop over list points

julia
    for next_idx in 1:napts
+        a_next = a_list[next_idx]
+        if curr_pt.inter && !curr_pt.crossing
+            j = curr_pt.neighbor
+            b_prev = j == 1 ? b_list[end] : b_list[j-1]
+            b_next = j == nbpts ? b_list[1] : b_list[j+1]

determine if any segments are on top of one another

julia
            a_prev_is_b_prev = a_prev.inter && equals(a_prev, b_prev)
+            a_prev_is_b_next = a_prev.inter && equals(a_prev, b_next)
+            a_next_is_b_prev = a_next.inter && equals(a_next, b_prev)
+            a_next_is_b_next = a_next.inter && equals(a_next, b_next)

determine which side of a segments the p points are on

julia
            b_prev_side, b_next_side = _get_sides(b_prev, b_next, a_prev, curr_pt, a_next,
+                i, j, a_list, b_list; exact)

no sides overlap

julia
            if !a_prev_is_b_prev && !a_prev_is_b_next && !a_next_is_b_prev && !a_next_is_b_next
+                if b_prev_side != b_next_side  # lines cross
+                    a_list[i] = PolyNode(curr_pt; crossing = true)
+                    b_list[j] = PolyNode(b_list[j]; crossing = true)
+                end

end of overlapping chain

julia
            elseif !a_next_is_b_prev && !a_next_is_b_next
+                b_side = a_prev_is_b_prev ? b_next_side : b_prev_side
+                if start_chain_edge == unknown  # start loop on overlapping chain
+                    unmatched_end_chain_edge = b_side
+                    unmatched_end_chain_idx = i
+                    same_winding = a_prev_is_b_prev
+                else  # close overlapping chain

update end of chain with endpoint and crossing / bouncing tags

julia
                    crossing = b_side != start_chain_edge
+                    a_list[i] = PolyNode(curr_pt;
+                        crossing = crossing,
+                        endpoint = end_chain,
+                    )
+                    b_list[j] = PolyNode(b_list[j];
+                        crossing = crossing,
+                        endpoint = same_winding ? end_chain : start_chain,
+                    )

update start of chain with endpoint and crossing / bouncing tags

julia
                    start_pt = a_list[start_chain_idx]
+                    a_list[start_chain_idx] = PolyNode(start_pt;
+                        crossing = crossing,
+                        endpoint = start_chain,
+                    )
+                    b_list[start_pt.neighbor] = PolyNode(b_list[start_pt.neighbor];
+                        crossing = crossing,
+                        endpoint = same_winding ? start_chain : end_chain,
+                    )
+                end

start of overlapping chain

julia
            elseif !a_prev_is_b_prev && !a_prev_is_b_next
+                b_side = a_next_is_b_prev ? b_next_side : b_prev_side
+                start_chain_edge = b_side
+                start_chain_idx = i
+                same_winding = a_next_is_b_next
+            end
+        end
+        a_prev = curr_pt
+        curr_pt = a_next
+        i = next_idx
+    end

if we started in the middle of overlapping chain, close chain

julia
    if unmatched_end_chain_edge != unknown
+        crossing = unmatched_end_chain_edge != start_chain_edge

update end of chain with endpoint and crossing / bouncing tags

julia
        end_chain_pt = a_list[unmatched_end_chain_idx]
+        a_list[unmatched_end_chain_idx] = PolyNode(end_chain_pt;
+            crossing = crossing,
+            endpoint = end_chain,
+        )
+        b_list[end_chain_pt.neighbor] = PolyNode(b_list[end_chain_pt.neighbor];
+            crossing = crossing,
+            endpoint = same_winding ? end_chain : start_chain,
+        )

update start of chain with endpoint and crossing / bouncing tags

julia
        start_pt = a_list[start_chain_idx]
+        a_list[start_chain_idx] = PolyNode(start_pt;
+            crossing = crossing,
+            endpoint = start_chain,
+        )
+        b_list[start_pt.neighbor] = PolyNode(b_list[start_pt.neighbor];
+            crossing = crossing,
+            endpoint = same_winding ? start_chain : end_chain,
+        )
+    end
+end

Check if PolyNode is a vertex of original polygon

julia
_is_vertex(pt) = !pt.inter || pt.fracs[1] == 0 || pt.fracs[1] == 1 || pt.fracs[2] == 0 || pt.fracs[2] == 1
+
+#= Determines which side (right or left) of the segment a_prev-curr_pt-a_next the points
+b_prev and b_next are on. Given this is only called when curr_pt is an intersection point
+that wasn't initially classified as crossing, we know that curr_pt is either from a hinge or
+overlapping intersection and thus is an original vertex of either poly_a or poly_b. Due to
+floating point error when calculating new intersection points, we only want to use original
+vertices to determine orientation. Thus, for other points, find nearest point that is a
+vertex. Given other intersection points will be collinear along existing segments, this
+won't change the orientation. =#
+function _get_sides(b_prev, b_next, a_prev, curr_pt, a_next, i, j, a_list, b_list; exact)
+    b_prev_pt = if _is_vertex(b_prev)
+        b_prev.point
+    else  # Find original start point of segment formed by b_prev and curr_pt
+        prev_idx = findprev(_is_vertex, b_list, j - 1)
+        prev_idx = isnothing(prev_idx) ? findlast(_is_vertex, b_list) : prev_idx
+        b_list[prev_idx].point
+    end
+    b_next_pt = if _is_vertex(b_next)
+        b_next.point
+    else  # Find original end point of segment formed by curr_pt and b_next
+        next_idx = findnext(_is_vertex, b_list, j + 1)
+        next_idx = isnothing(next_idx) ? findfirst(_is_vertex, b_list) : next_idx
+        b_list[next_idx].point
+    end
+    a_prev_pt = if _is_vertex(a_prev)
+        a_prev.point
+    else   # Find original start point of segment formed by a_prev and curr_pt
+        prev_idx = findprev(_is_vertex, a_list, i - 1)
+        prev_idx = isnothing(prev_idx) ? findlast(_is_vertex, a_list) : prev_idx
+        a_list[prev_idx].point
+    end
+    a_next_pt = if _is_vertex(a_next)
+        a_next.point
+    else  # Find original end point of segment formed by curr_pt and a_next
+        next_idx = findnext(_is_vertex, a_list, i + 1)
+        next_idx = isnothing(next_idx) ? findfirst(_is_vertex, a_list) : next_idx
+        a_list[next_idx].point
+    end

Determine side orientation of b_prev and b_next

julia
    b_prev_side = _get_side(b_prev_pt, a_prev_pt, curr_pt.point, a_next_pt; exact)
+    b_next_side = _get_side(b_next_pt, a_prev_pt, curr_pt.point, a_next_pt; exact)
+    return b_prev_side, b_next_side
+end

Determines if Q lies to the left or right of the line formed by P1-P2-P3

julia
function _get_side(Q, P1, P2, P3; exact)
+    s1 = Predicates.orient(Q, P1, P2; exact)
+    s2 = Predicates.orient(Q, P2, P3; exact)
+    s3 = Predicates.orient(P1, P2, P3; exact)
+
+    side = if s3  0
+        (s1 < 0) || (s2 < 0) ? right : left
+    else #  s3 < 0
+        (s1 > 0) || (s2 > 0) ? left : right
+    end
+    return side
+end
+
+#= Given a list of PolyNodes, find the first element that isn't an intersection point. Then,
+test if this element is in or out of the given polygon. Return the next index, as well as
+the enter/exit status of the next intersection point (the opposite of the in/out check). If
+all points are intersection points, find the first element that either is the end of a chain
+or a crossing point that isn't in a chain. Then take the midpoint of this point and the next
+point in the list and perform the in/out check. If none of these points exist, return
+a \`next_idx\` of \`nothing\`. =#
+function _pt_off_edge_status(::Type{T}, pt_list, poly, npts; exact) where T
+    start_idx, is_non_intr_pt = findfirst(_is_not_intr, pt_list), true
+    if isnothing(start_idx)
+        start_idx, is_non_intr_pt = findfirst(_next_edge_off, pt_list), false
+        isnothing(start_idx) && return (start_idx, false)
+    end
+    next_idx = start_idx < npts ? (start_idx + 1) : 1
+    start_pt = if is_non_intr_pt
+        pt_list[start_idx].point
+    else
+        (pt_list[start_idx].point .+ pt_list[next_idx].point) ./ 2
+    end
+    start_status = !_point_filled_curve_orientation(start_pt, poly; in = true, on = false, out = false, exact)
+    return next_idx, start_status
+end

Check if a PolyNode is an intersection point

julia
_is_not_intr(pt) = !pt.inter
+#= Check if a PolyNode is the last point of a chain or a non-overlapping crossing point.
+The next midpoint of one of these points and the next point within a polygon must not be on
+the polygon edge. =#
+_next_edge_off(pt) = (pt.endpoint == end_chain) || (pt.crossing && pt.endpoint == not_endpoint)
_flag_ent_exit!(::Type{T}, ::GI.LinearRingTrait, poly, pt_list, delay_cross_f, delay_bounce_f; exact)

This function flags all the intersection points as either an 'entry' or 'exit' point in relation to the given polygon. For non-delayed crossings we simply alternate the enter/exit status. This also holds true for the first and last points of a delayed bouncing, where they both have an opposite entry/exit flag. Conversely, the first and last point of a delayed crossing have the same entry/exit status. Furthermore, the crossing/bouncing flag of delayed crossings and bouncings may be updated. This depends on function specific rules that determine which of the start or end points (if any) should be marked as crossing for used during polygon tracing. A consistent rule is that the start and end points of a delayed crossing will have different crossing/bouncing flags, while a the endpoints of a delayed bounce will be the same.

Used for clipping polygons by other polygons.

julia
function _flag_ent_exit!(::Type{T}, ::GI.LinearRingTrait, poly, pt_list, delay_cross_f, delay_bounce_f; exact) where T
+    npts = length(pt_list)

Find starting index if there is one

julia
    next_idx, status = _pt_off_edge_status(T, pt_list, poly, npts; exact)
+    isnothing(next_idx) && return
+    start_idx = next_idx - 1

Loop over points and mark entry and exit status

julia
    start_chain_idx = 0
+    for ii in Iterators.flatten((next_idx:npts, 1:start_idx))
+        curr_pt = pt_list[ii]
+        if curr_pt.endpoint == start_chain
+            start_chain_idx = ii
+        elseif curr_pt.crossing || curr_pt.endpoint == end_chain
+            start_crossing, end_crossing = curr_pt.crossing, curr_pt.crossing
+            if curr_pt.endpoint == end_chain  # ending overlapping chain
+                start_pt = pt_list[start_chain_idx]
+                if curr_pt.crossing  # delayed crossing
+                    #= start and end crossing status are different and depend on current
+                    entry/exit status =#
+                    start_crossing, end_crossing = delay_cross_f(status)
+                else  # delayed bouncing
+                    next_idx = ii < npts ? (ii + 1) : 1
+                    next_val = (curr_pt.point .+ pt_list[next_idx].point) ./ 2
+                    pt_in_poly = _point_filled_curve_orientation(next_val, poly; in = true, on = false, out = false, exact)
+                    #= start and end crossing status are the same and depend on if adjacent
+                    edges of pt_list are within poly =#
+                    start_crossing = delay_bounce_f(pt_in_poly)
+                    end_crossing = start_crossing
+                end

update start of chain point

julia
                pt_list[start_chain_idx] = PolyNode(start_pt; ent_exit = status, crossing = start_crossing)
+                if !curr_pt.crossing
+                    status = !status
+                end
+            end
+            pt_list[ii] = PolyNode(curr_pt; ent_exit = status, crossing = end_crossing)
+            status = !status
+        end
+    end
+    return
+end
_flag_ent_exit!(::GI.LineTrait, line, pt_list; exact)

This function flags all the intersection points as either an 'entry' or 'exit' point in relation to the given line. Returns true if there are crossing points to classify, else returns false. Used for cutting polygons by lines.

Assumes that the first point is outside of the polygon and not on an edge.

julia
function _flag_ent_exit!(::GI.LineTrait, poly, pt_list; exact)
+    status = !_point_filled_curve_orientation(pt_list[1].point, poly; in = true, on = false, out = false, exact)

Loop over points and mark entry and exit status

julia
    for (ii, curr_pt) in enumerate(pt_list)
+        if curr_pt.crossing
+            pt_list[ii] = PolyNode(curr_pt; ent_exit = status)
+            status = !status
+        end
+    end
+    return
+end
+
+#= Filters a_idx_list to just include crossing points and sets the index of all crossing
+points (which element they correspond to within a_idx_list). =#
+function _index_crossing_intrs!(a_list, b_list, a_idx_list)
+    filter!(x -> a_list[x].crossing, a_idx_list)
+    for (i, a_idx) in enumerate(a_idx_list)
+        curr_node = a_list[a_idx]
+        neighbor_node = b_list[curr_node.neighbor]
+        a_list[a_idx] = PolyNode(curr_node; idx = i)
+        b_list[curr_node.neighbor] = PolyNode(neighbor_node; idx = i)
+    end
+    return
+end
_trace_polynodes(::Type{T}, a_list, b_list, a_idx_list, f_step)::Vector{GI.Polygon}

This function takes the outputs of _build_ab_list and traces the lists to determine which polygons are formed as described in Greiner and Hormann. The function f_step determines in which direction the lists are traced. This function is different for intersection, difference, and union. f_step must take in two arguments: the most recent intersection node's entry/exit status and a boolean that is true if we are currently tracing a_list and false if we are tracing b_list. The functions used for each clipping operation are follows: - Intersection: (x, y) -> x ? 1 : (-1) - Difference: (x, y) -> (x ⊻ y) ? 1 : (-1) - Union: (x, y) -> x ? (-1) : 1

A list of GeoInterface polygons is returned from this function.

Note: poly_a and poly_b are temporary inputs used for debugging and can be removed eventually.

julia
function _trace_polynodes(::Type{T}, a_list, b_list, a_idx_list, f_step, poly_a, poly_b) where T
+    n_a_pts, n_b_pts = length(a_list), length(b_list)
+    total_pts = n_a_pts + n_b_pts
+    n_cross_pts = length(a_idx_list)
+    return_polys = Vector{_get_poly_type(T)}(undef, 0)

Keep track of number of processed intersection points

julia
    visited_pts = 0
+    processed_pts = 0
+    first_idx = 1
+    while processed_pts < n_cross_pts
+        curr_list, curr_npoints = a_list, n_a_pts
+        on_a_list = true

Find first unprocessed intersecting point in subject polygon

julia
        visited_pts += 1
+        processed_pts += 1
+        first_idx = findnext(x -> x != 0, a_idx_list, first_idx)
+        idx = a_idx_list[first_idx]
+        a_idx_list[first_idx] = 0
+        start_pt = a_list[idx]

Set first point in polygon

julia
        curr = curr_list[idx]
+        pt_list = [curr.point]
+
+        curr_not_start = true
+        while curr_not_start
+            step = f_step(curr.ent_exit, on_a_list)

changed curr_not_intr to curr_not_same_ent_flag

julia
            same_status, prev_status = true, curr.ent_exit
+            while same_status
+                @assert visited_pts < total_pts "Clipping tracing hit every point - clipping error. Please open an issue with polygons: $(GI.coordinates(poly_a)) and $(GI.coordinates(poly_b))."

Traverse polygon either forwards or backwards

julia
                idx += step
+                idx = (idx > curr_npoints) ? mod(idx, curr_npoints) : idx
+                idx = (idx == 0) ? curr_npoints : idx

Get current node and add to pt_list

julia
                curr = curr_list[idx]
+                push!(pt_list, curr.point)
+                if (curr.crossing || curr.endpoint != not_endpoint)

Keep track of processed intersection points

julia
                    same_status = curr.ent_exit == prev_status
+                    curr_not_start = curr != start_pt && curr != b_list[start_pt.neighbor]
+                    !curr_not_start && break
+                    if (on_a_list && curr.crossing) || (!on_a_list && a_list[curr.neighbor].crossing)
+                        processed_pts += 1
+                        a_idx_list[curr.idx] = 0
+                    end
+                end
+                visited_pts += 1
+            end

Switch to next list and next point

julia
            curr_list, curr_npoints = on_a_list ? (b_list, n_b_pts) : (a_list, n_a_pts)
+            on_a_list = !on_a_list
+            idx = curr.neighbor
+            curr = curr_list[idx]
+        end
+        push!(return_polys, GI.Polygon([pt_list]))
+    end
+    return return_polys
+end

Get type of polygons that will be made TODO: Increase type options

julia
_get_poly_type(::Type{T}) where T =
+    GI.Polygon{false, false, Vector{GI.LinearRing{false, false, Vector{Tuple{T, T}}, Nothing, Nothing}}, Nothing, Nothing}
_find_non_cross_orientation(a_list, b_list, a_poly, b_poly; exact)

For polygons with no crossing intersection points, either one polygon is inside of another, or they are separate polygons with no intersection (other than an edge or point).

Return two booleans that represent if a is inside b (potentially with shared edges / points) and visa versa if b is inside of a.

julia
function _find_non_cross_orientation(a_list, b_list, a_poly, b_poly; exact)
+    non_intr_a_idx = findfirst(x -> !x.inter, a_list)
+    non_intr_b_idx = findfirst(x -> !x.inter, b_list)
+    #= Determine if non-intersection point is in or outside of polygon - if there isn't A
+    non-intersection point, then all points are on the polygon edge =#
+    a_pt_orient = isnothing(non_intr_a_idx) ? point_on :
+        _point_filled_curve_orientation(a_list[non_intr_a_idx].point, b_poly; exact)
+    b_pt_orient = isnothing(non_intr_b_idx) ? point_on :
+        _point_filled_curve_orientation(b_list[non_intr_b_idx].point, a_poly; exact)
+    a_in_b = a_pt_orient != point_out && b_pt_orient != point_in
+    b_in_a = b_pt_orient != point_out && a_pt_orient != point_in
+    return a_in_b, b_in_a
+end
_add_holes_to_polys!(::Type{T}, return_polys, hole_iterator, remove_poly_idx; exact)

The holes specified by the hole iterator are added to the polygons in the return_polys list. If this creates more polygons, they are added to the end of the list. If this removes polygons, they are removed from the list

julia
function _add_holes_to_polys!(::Type{T}, return_polys, hole_iterator, remove_poly_idx; exact) where T
+    n_polys = length(return_polys)
+    remove_hole_idx = Int[]

Remove set of holes from all polygons

julia
    for i in 1:n_polys
+        n_new_per_poly = 0
+        for curr_hole in Iterators.map(tuples, hole_iterator) # loop through all holes
+            curr_hole = _linearring(curr_hole)

loop through all pieces of original polygon (new pieces added to end of list)

julia
            for j in Iterators.flatten((i:i, (n_polys + 1):(n_polys + n_new_per_poly)))
+                curr_poly = return_polys[j]
+                remove_poly_idx[j] && continue
+                curr_poly_ext = GI.nhole(curr_poly) > 0 ? GI.Polygon(StaticArrays.SVector(GI.getexterior(curr_poly))) : curr_poly
+                in_ext, on_ext, out_ext = _line_polygon_interactions(curr_hole, curr_poly_ext; exact, closed_line = true)
+                if in_ext  # hole is at least partially within the polygon's exterior
+                    new_hole, new_hole_poly, n_new_pieces = _combine_holes!(T, curr_hole, curr_poly, return_polys, remove_hole_idx)
+                    if n_new_pieces > 0
+                        append!(remove_poly_idx, falses(n_new_pieces))
+                        n_new_per_poly += n_new_pieces
+                    end
+                    if !on_ext && !out_ext  # hole is completely within exterior
+                        push!(curr_poly.geom, new_hole)
+                    else  # hole is partially within and outside of polygon's exterior
+                        new_polys = difference(curr_poly_ext, new_hole_poly, T; target=GI.PolygonTrait())
+                        n_new_polys = length(new_polys) - 1

replace original

julia
                        curr_poly.geom[1] = GI.getexterior(new_polys[1])
+                        append!(curr_poly.geom, GI.gethole(new_polys[1]))
+                        if n_new_polys > 0  # add any extra pieces
+                            append!(return_polys, @view new_polys[2:end])
+                            append!(remove_poly_idx, falses(n_new_polys))
+                            n_new_per_poly += n_new_polys
+                        end
+                    end

polygon is completely within hole

julia
                elseif coveredby(curr_poly_ext, GI.Polygon(StaticArrays.SVector(curr_hole)))
+                    remove_poly_idx[j] = true
+                end
+            end
+        end
+        n_polys += n_new_per_poly
+    end

Remove all polygon that were marked for removal

julia
    deleteat!(return_polys, remove_poly_idx)
+    return
+end
_combine_holes!(::Type{T}, new_hole, curr_poly, return_polys)

The new hole is combined with any existing holes in curr_poly. The holes can be combined into a larger hole if they are intersecting. If this happens, then the new, combined hole is returned with the original holes making up the new hole removed from curr_poly. Additionally, if the combined holes form a ring, the interior is added to the return_polys as a new polygon piece. Additionally, holes leftover after combination will be checked for it they are in the "main" polygon or in one of these new pieces and moved accordingly.

If the holes don't touch or curr_poly has no holes, then new_hole is returned without any changes.

julia
function _combine_holes!(::Type{T}, new_hole, curr_poly, return_polys, remove_hole_idx) where T
+    n_new_polys = 0
+    empty!(remove_hole_idx)
+    new_hole_poly = GI.Polygon(StaticArrays.SVector(new_hole))

Combine any existing holes in curr_poly with new hole

julia
    for (k, old_hole) in enumerate(GI.gethole(curr_poly))
+        old_hole_poly = GI.Polygon(StaticArrays.SVector(old_hole))
+        if intersects(new_hole_poly, old_hole_poly)

If the holes intersect, combine them into a bigger hole

julia
            hole_union = union(new_hole_poly, old_hole_poly, T; target = GI.PolygonTrait())[1]
+            push!(remove_hole_idx, k + 1)
+            new_hole = GI.getexterior(hole_union)
+            new_hole_poly = GI.Polygon(StaticArrays.SVector(new_hole))
+            n_pieces = GI.nhole(hole_union)
+            if n_pieces > 0  # if the hole has a hole, then this is a new polygon piece!
+                append!(return_polys, [GI.Polygon([h]) for h in GI.gethole(hole_union)])
+                n_new_polys += n_pieces
+            end
+        end
+    end

Remove redundant holes

julia
    deleteat!(curr_poly.geom, remove_hole_idx)
+    empty!(remove_hole_idx)

If new polygon pieces created, make sure remaining holes are in the correct piece

julia
    @views for piece in return_polys[end - n_new_polys + 1:end]
+        for (k, old_hole) in enumerate(GI.gethole(curr_poly))
+            if !(k in remove_hole_idx) && within(old_hole, piece)
+                push!(remove_hole_idx, k + 1)
+                push!(piece.geom, old_hole)
+            end
+        end
+    end
+    deleteat!(curr_poly.geom, remove_hole_idx)
+    return new_hole, new_hole_poly, n_new_polys
+end
+
+#= Remove collinear edge points, other than the first and last edge vertex, to simplify
+polygon - including both the exterior ring and any holes=#
+function _remove_collinear_points!(polys, remove_idx, poly_a, poly_b)
+    for (i, poly) in Iterators.reverse(enumerate(polys))
+        for (j, ring) in Iterators.reverse(enumerate(GI.getring(poly)))
+            n = length(ring.geom)

resize and reset removing index buffer

julia
            resize!(remove_idx, n)
+            fill!(remove_idx, false)
+            local p1, p2
+            for (i, p) in enumerate(ring.geom)
+                if i == 1
+                    p1 = p
+                    continue
+                elseif i == 2
+                    p2 = p
+                    continue
+                else
+                    p3 = p

check if p2 is approximately on the edge formed by p1 and p3 - remove if so

julia
                    if Predicates.orient(p1, p2, p3; exact = _False()) == 0
+                        remove_idx[i - 1] = true
+                    end
+                end
+                p1, p2 = p2, p3
+            end

Check if the first point (which is repeated as the last point) is needed

julia
            if Predicates.orient(ring.geom[end - 1], ring.geom[1], ring.geom[2]; exact = _False()) == 0
+                remove_idx[1], remove_idx[end] = true, true
+            end

Remove unneeded collinear points

julia
            deleteat!(ring.geom, remove_idx)

Check if enough points are left to form a polygon

julia
            if length(ring.geom)  (remove_idx[1] ? 2 : 3)
+                if j == 1
+                    deleteat!(polys, i)
+                    break
+                else
+                    deleteat!(poly.geom, j)
+                    continue
+                end
+            end
+            if remove_idx[1]  # make sure the last point is repeated
+                push!(ring.geom, ring.geom[1])
+            end
+        end
+    end
+    return
+end

This page was generated using Literate.jl.

`,169)]))}const y=i(t,[["render",p]]);export{g as __pageData,y as default}; diff --git a/previews/PR237/assets/source_methods_clipping_clipping_processor.md.Cn8s_AHy.lean.js b/previews/PR237/assets/source_methods_clipping_clipping_processor.md.Cn8s_AHy.lean.js new file mode 100644 index 000000000..d8dd9e1ed --- /dev/null +++ b/previews/PR237/assets/source_methods_clipping_clipping_processor.md.Cn8s_AHy.lean.js @@ -0,0 +1,508 @@ +import{_ as i,c as a,a5 as n,o as h}from"./chunks/framework.Cq8AuEls.js";const g=JSON.parse('{"title":"Polygon clipping helpers","description":"","frontmatter":{},"headers":[],"relativePath":"source/methods/clipping/clipping_processor.md","filePath":"source/methods/clipping/clipping_processor.md","lastUpdated":null}'),t={name:"source/methods/clipping/clipping_processor.md"};function p(l,s,k,e,E,r){return h(),a("div",null,s[0]||(s[0]=[n(`

Polygon clipping helpers

This file contains the shared helper functions for the polygon clipping functionalities.

This enum defines which side of an edge a point is on

julia
@enum PointEdgeSide left=1 right=2 unknown=3

Constants assigned for readability

julia
const enter, exit = true, false
+const crossing, bouncing = true, false
+
+#= A point can either be the start or end of an overlapping chain of points between two
+polygons, or not an endpoint of a chain. =#
+@enum EndPointType start_chain=1 end_chain=2 not_endpoint=3
+
+#= This is the struct that makes up a_list and b_list. Many values are only used if point is
+an intersection point (ipt). =#
+@kwdef struct PolyNode{T <: AbstractFloat}
+    point::Tuple{T,T}          # (x, y) values of given point
+    inter::Bool = false        # If ipt, true, else 0
+    neighbor::Int = 0          # If ipt, index of equivalent point in a_list or b_list, else 0
+    idx::Int = 0               # If crossing point, index within sorted a_idx_list
+    ent_exit::Bool = false     # If ipt, true if enter and false if exit, else false
+    crossing::Bool = false     # If ipt, true if intersection crosses from out/in polygon, else false
+    endpoint::EndPointType = not_endpoint # If ipt, denotes if point is the start or end of an overlapping chain
+    fracs::Tuple{T,T} = (0., 0.) # If ipt, fractions along edges to ipt (a_frac, b_frac), else (0, 0)
+end
+
+#= Create a new node with all of the same field values as the given PolyNode unless
+alternative values are provided, in which case those should be used. =#
+PolyNode(node::PolyNode{T};
+    point = node.point, inter = node.inter, neighbor = node.neighbor, idx = node.idx,
+    ent_exit = node.ent_exit, crossing = node.crossing, endpoint = node.endpoint,
+    fracs = node.fracs,
+) where T = PolyNode{T}(;
+    point = point, inter = inter, neighbor = neighbor, idx = idx, ent_exit = ent_exit,
+    crossing = crossing, endpoint = endpoint, fracs = fracs)

Checks equality of two PolyNodes by backing point value, fractional value, and intersection status

julia
equals(pn1::PolyNode, pn2::PolyNode) = pn1.point == pn2.point && pn1.inter == pn2.inter && pn1.fracs == pn2.fracs
_build_ab_list(::Type{T}, poly_a, poly_b, delay_cross_f, delay_bounce_f; exact) ->
+    (a_list, b_list, a_idx_list)

This function takes in two polygon rings and calls '_build_a_list', '_build_b_list', and '_flag_ent_exit' in order to fully form a_list and b_list. The 'a_list' and 'b_list' that it returns are the fully updated vectors of PolyNodes that represent the rings 'poly_a' and 'poly_b', respectively. This function also returns 'a_idx_list', which at its "ith" index stores the index in 'a_list' at which the "ith" intersection point lies.

julia
function _build_ab_list(::Type{T}, poly_a, poly_b, delay_cross_f::F1, delay_bounce_f::F2; exact) where {T, F1, F2}

Make a list for nodes of each polygon

julia
    a_list, a_idx_list, n_b_intrs = _build_a_list(T, poly_a, poly_b; exact)
+    b_list = _build_b_list(T, a_idx_list, a_list, n_b_intrs, poly_b)

Flag crossings

julia
    _classify_crossing!(T, a_list, b_list; exact)

Flag the entry and exits

julia
    _flag_ent_exit!(T, GI.LinearRingTrait(), poly_b, a_list, delay_cross_f, Base.Fix2(delay_bounce_f, true); exact)
+    _flag_ent_exit!(T, GI.LinearRingTrait(), poly_a, b_list, delay_cross_f, Base.Fix2(delay_bounce_f, false); exact)

Set node indices and filter a_idx_list to just crossing points

julia
    _index_crossing_intrs!(a_list, b_list, a_idx_list)
+
+    return a_list, b_list, a_idx_list
+end
_build_a_list(::Type{T}, poly_a, poly_b) -> (a_list, a_idx_list)

This function take in two polygon rings and creates a vector of PolyNodes to represent poly_a, including its intersection points with poly_b. The information stored in each PolyNode is needed for clipping using the Greiner-Hormann clipping algorithm.

Note: After calling this function, a_list is not fully formed because the neighboring indices of the intersection points in b_list still need to be updated. Also we still have not update the entry and exit flags for a_list.

The a_idx_list is a list of the indices of intersection points in a_list. The value at index i of a_idx_list is the location in a_list where the ith intersection point lies.

julia
function _build_a_list(::Type{T}, poly_a, poly_b; exact) where T
+    n_a_edges = _nedge(poly_a)
+    a_list = PolyNode{T}[]  # list of points in poly_a
+    sizehint!(a_list, n_a_edges)
+    a_idx_list = Vector{Int}()  # finds indices of intersection points in a_list
+    a_count = 0  # number of points added to a_list
+    n_b_intrs = 0

Loop through points of poly_a

julia
    local a_pt1
+    for (i, a_p2) in enumerate(GI.getpoint(poly_a))
+        a_pt2 = (T(GI.x(a_p2)), T(GI.y(a_p2)))
+        if i <= 1 || (a_pt1 == a_pt2)  # don't repeat points
+            a_pt1 = a_pt2
+            continue
+        end

Add the first point of the edge to the list of points in a_list

julia
        new_point = PolyNode{T}(;point = a_pt1)
+        a_count += 1
+        push!(a_list, new_point)

Find intersections with edges of poly_b

julia
        local b_pt1
+        prev_counter = a_count
+        for (j, b_p2) in enumerate(GI.getpoint(poly_b))
+            b_pt2 = _tuple_point(b_p2, T)
+            if j <= 1 || (b_pt1 == b_pt2)  # don't repeat points
+                b_pt1 = b_pt2
+                continue
+            end

Determine if edges intersect and how they intersect

julia
            line_orient, intr1, intr2 = _intersection_point(T, (a_pt1, a_pt2), (b_pt1, b_pt2); exact)
+            if line_orient != line_out  # edges intersect
+                if line_orient == line_cross  # Intersection point that isn't a vertex
+                    int_pt, fracs = intr1
+                    new_intr = PolyNode{T}(;
+                        point = int_pt, inter = true, neighbor = j - 1,
+                        crossing = true, fracs = fracs,
+                    )
+                    a_count += 1
+                    n_b_intrs += 1
+                    push!(a_list, new_intr)
+                    push!(a_idx_list, a_count)
+                else
+                    (_, (α1, β1)) = intr1

Determine if a1 or b1 should be added to a_list

julia
                    add_a1 = α1 == 0 && 0 β1 < 1
+                    a1_β = add_a1 ? β1 : zero(T)
+                    add_b1 = β1 == 0 && 0 < α1 < 1
+                    b1_α = add_b1 ? α1 : zero(T)

If lines are collinear and overlapping, a second intersection exists

julia
                    if line_orient == line_over
+                        (_, (α2, β2)) = intr2
+                        if α2 == 0 && 0 β2 < 1
+                            add_a1, a1_β = true, β2
+                        end
+                        if β2 == 0 && 0 < α2 < 1
+                            add_b1, b1_α = true, α2
+                        end
+                    end

Add intersection points determined above

julia
                    if add_a1
+                        n_b_intrs += a1_β == 0 ? 0 : 1
+                        a_list[prev_counter] = PolyNode{T}(;
+                            point = a_pt1, inter = true, neighbor = j - 1,
+                            fracs = (zero(T), a1_β),
+                        )
+                        push!(a_idx_list, prev_counter)
+                    end
+                    if add_b1
+                        new_intr = PolyNode{T}(;
+                            point = b_pt1, inter = true, neighbor = j - 1,
+                            fracs = (b1_α, zero(T)),
+                        )
+                        a_count += 1
+                        push!(a_list, new_intr)
+                        push!(a_idx_list, a_count)
+                    end
+                end
+            end
+            b_pt1 = b_pt2
+        end

Order intersection points by placement along edge using fracs value

julia
        if prev_counter < a_count
+            Δintrs = a_count - prev_counter
+            inter_points = @view a_list[(a_count - Δintrs + 1):a_count]
+            sort!(inter_points, by = x -> x.fracs[1])
+        end
+        a_pt1 = a_pt2
+    end
+    return a_list, a_idx_list, n_b_intrs
+end
_build_b_list(::Type{T}, a_idx_list, a_list, poly_b) -> b_list

This function takes in the a_list and a_idx_list build in _build_a_list and poly_b and creates a vector of PolyNodes to represent poly_b. The information stored in each PolyNode is needed for clipping using the Greiner-Hormann clipping algorithm.

Note: after calling this function, b_list is not fully updated. The entry/exit flags still need to be updated. However, the neighbor value in a_list is now updated.

julia
function _build_b_list(::Type{T}, a_idx_list, a_list, n_b_intrs, poly_b) where T

Sort intersection points by insertion order in b_list

julia
    sort!(a_idx_list, by = x-> a_list[x].neighbor + a_list[x].fracs[2])

Initialize needed values and lists

julia
    n_b_edges = _nedge(poly_b)
+    n_intr_pts = length(a_idx_list)
+    b_list = PolyNode{T}[]
+    sizehint!(b_list, n_b_edges + n_b_intrs)
+    intr_curr = 1
+    b_count = 0

Loop over points in poly_b and add each point and intersection point

julia
    local b_pt1
+    for (i, b_p2) in enumerate(GI.getpoint(poly_b))
+        b_pt2 = _tuple_point(b_p2, T)
+        if i  1 || (b_pt1 == b_pt2)  # don't repeat points
+            b_pt1 = b_pt2
+            continue
+        end
+        b_count += 1
+        push!(b_list, PolyNode{T}(; point = b_pt1))
+        if intr_curr  n_intr_pts
+            curr_idx = a_idx_list[intr_curr]
+            curr_node = a_list[curr_idx]
+            prev_counter = b_count
+            while curr_node.neighbor == i - 1  # Add all intersection points on current edge
+                b_idx = 0
+                new_intr = PolyNode(curr_node; neighbor = curr_idx)
+                if curr_node.fracs[2] == 0  # if curr_node is segment start point

intersection point is vertex of b

julia
                    b_idx = prev_counter
+                    b_list[b_idx] = new_intr
+                else
+                    b_count += 1
+                    b_idx = b_count
+                    push!(b_list, new_intr)
+                end
+                a_list[curr_idx] = PolyNode(curr_node; neighbor = b_idx)
+                intr_curr += 1
+                intr_curr > n_intr_pts && break
+                curr_idx = a_idx_list[intr_curr]
+                curr_node = a_list[curr_idx]
+            end
+        end
+        b_pt1 = b_pt2
+    end
+    sort!(a_idx_list)  # return a_idx_list to order of points in a_list
+    return b_list
+end
_classify_crossing!(T, poly_b, a_list; exact)

This function marks all intersection points as either bouncing or crossing points. "Delayed" crossing or bouncing intersections (a chain of edges where the central edges overlap and thus only the first and last edge of the chain determine if the chain is bounding or crossing) are marked as follows: the first and the last points are marked as crossing if the chain is crossing and delayed otherwise and all middle points are marked as bouncing. Additionally, the start and end points of the chain are marked as endpoints using the endpoints field.

julia
function _classify_crossing!(::Type{T}, a_list, b_list; exact) where T
+    napts = length(a_list)
+    nbpts = length(b_list)

start centered on last point

julia
    a_prev = a_list[end - 1]
+    curr_pt = a_list[end]
+    i = napts

keep track of unmatched bouncing chains

julia
    start_chain_edge, start_chain_idx = unknown, 0
+    unmatched_end_chain_edge, unmatched_end_chain_idx = unknown, 0
+    same_winding = true

loop over list points

julia
    for next_idx in 1:napts
+        a_next = a_list[next_idx]
+        if curr_pt.inter && !curr_pt.crossing
+            j = curr_pt.neighbor
+            b_prev = j == 1 ? b_list[end] : b_list[j-1]
+            b_next = j == nbpts ? b_list[1] : b_list[j+1]

determine if any segments are on top of one another

julia
            a_prev_is_b_prev = a_prev.inter && equals(a_prev, b_prev)
+            a_prev_is_b_next = a_prev.inter && equals(a_prev, b_next)
+            a_next_is_b_prev = a_next.inter && equals(a_next, b_prev)
+            a_next_is_b_next = a_next.inter && equals(a_next, b_next)

determine which side of a segments the p points are on

julia
            b_prev_side, b_next_side = _get_sides(b_prev, b_next, a_prev, curr_pt, a_next,
+                i, j, a_list, b_list; exact)

no sides overlap

julia
            if !a_prev_is_b_prev && !a_prev_is_b_next && !a_next_is_b_prev && !a_next_is_b_next
+                if b_prev_side != b_next_side  # lines cross
+                    a_list[i] = PolyNode(curr_pt; crossing = true)
+                    b_list[j] = PolyNode(b_list[j]; crossing = true)
+                end

end of overlapping chain

julia
            elseif !a_next_is_b_prev && !a_next_is_b_next
+                b_side = a_prev_is_b_prev ? b_next_side : b_prev_side
+                if start_chain_edge == unknown  # start loop on overlapping chain
+                    unmatched_end_chain_edge = b_side
+                    unmatched_end_chain_idx = i
+                    same_winding = a_prev_is_b_prev
+                else  # close overlapping chain

update end of chain with endpoint and crossing / bouncing tags

julia
                    crossing = b_side != start_chain_edge
+                    a_list[i] = PolyNode(curr_pt;
+                        crossing = crossing,
+                        endpoint = end_chain,
+                    )
+                    b_list[j] = PolyNode(b_list[j];
+                        crossing = crossing,
+                        endpoint = same_winding ? end_chain : start_chain,
+                    )

update start of chain with endpoint and crossing / bouncing tags

julia
                    start_pt = a_list[start_chain_idx]
+                    a_list[start_chain_idx] = PolyNode(start_pt;
+                        crossing = crossing,
+                        endpoint = start_chain,
+                    )
+                    b_list[start_pt.neighbor] = PolyNode(b_list[start_pt.neighbor];
+                        crossing = crossing,
+                        endpoint = same_winding ? start_chain : end_chain,
+                    )
+                end

start of overlapping chain

julia
            elseif !a_prev_is_b_prev && !a_prev_is_b_next
+                b_side = a_next_is_b_prev ? b_next_side : b_prev_side
+                start_chain_edge = b_side
+                start_chain_idx = i
+                same_winding = a_next_is_b_next
+            end
+        end
+        a_prev = curr_pt
+        curr_pt = a_next
+        i = next_idx
+    end

if we started in the middle of overlapping chain, close chain

julia
    if unmatched_end_chain_edge != unknown
+        crossing = unmatched_end_chain_edge != start_chain_edge

update end of chain with endpoint and crossing / bouncing tags

julia
        end_chain_pt = a_list[unmatched_end_chain_idx]
+        a_list[unmatched_end_chain_idx] = PolyNode(end_chain_pt;
+            crossing = crossing,
+            endpoint = end_chain,
+        )
+        b_list[end_chain_pt.neighbor] = PolyNode(b_list[end_chain_pt.neighbor];
+            crossing = crossing,
+            endpoint = same_winding ? end_chain : start_chain,
+        )

update start of chain with endpoint and crossing / bouncing tags

julia
        start_pt = a_list[start_chain_idx]
+        a_list[start_chain_idx] = PolyNode(start_pt;
+            crossing = crossing,
+            endpoint = start_chain,
+        )
+        b_list[start_pt.neighbor] = PolyNode(b_list[start_pt.neighbor];
+            crossing = crossing,
+            endpoint = same_winding ? start_chain : end_chain,
+        )
+    end
+end

Check if PolyNode is a vertex of original polygon

julia
_is_vertex(pt) = !pt.inter || pt.fracs[1] == 0 || pt.fracs[1] == 1 || pt.fracs[2] == 0 || pt.fracs[2] == 1
+
+#= Determines which side (right or left) of the segment a_prev-curr_pt-a_next the points
+b_prev and b_next are on. Given this is only called when curr_pt is an intersection point
+that wasn't initially classified as crossing, we know that curr_pt is either from a hinge or
+overlapping intersection and thus is an original vertex of either poly_a or poly_b. Due to
+floating point error when calculating new intersection points, we only want to use original
+vertices to determine orientation. Thus, for other points, find nearest point that is a
+vertex. Given other intersection points will be collinear along existing segments, this
+won't change the orientation. =#
+function _get_sides(b_prev, b_next, a_prev, curr_pt, a_next, i, j, a_list, b_list; exact)
+    b_prev_pt = if _is_vertex(b_prev)
+        b_prev.point
+    else  # Find original start point of segment formed by b_prev and curr_pt
+        prev_idx = findprev(_is_vertex, b_list, j - 1)
+        prev_idx = isnothing(prev_idx) ? findlast(_is_vertex, b_list) : prev_idx
+        b_list[prev_idx].point
+    end
+    b_next_pt = if _is_vertex(b_next)
+        b_next.point
+    else  # Find original end point of segment formed by curr_pt and b_next
+        next_idx = findnext(_is_vertex, b_list, j + 1)
+        next_idx = isnothing(next_idx) ? findfirst(_is_vertex, b_list) : next_idx
+        b_list[next_idx].point
+    end
+    a_prev_pt = if _is_vertex(a_prev)
+        a_prev.point
+    else   # Find original start point of segment formed by a_prev and curr_pt
+        prev_idx = findprev(_is_vertex, a_list, i - 1)
+        prev_idx = isnothing(prev_idx) ? findlast(_is_vertex, a_list) : prev_idx
+        a_list[prev_idx].point
+    end
+    a_next_pt = if _is_vertex(a_next)
+        a_next.point
+    else  # Find original end point of segment formed by curr_pt and a_next
+        next_idx = findnext(_is_vertex, a_list, i + 1)
+        next_idx = isnothing(next_idx) ? findfirst(_is_vertex, a_list) : next_idx
+        a_list[next_idx].point
+    end

Determine side orientation of b_prev and b_next

julia
    b_prev_side = _get_side(b_prev_pt, a_prev_pt, curr_pt.point, a_next_pt; exact)
+    b_next_side = _get_side(b_next_pt, a_prev_pt, curr_pt.point, a_next_pt; exact)
+    return b_prev_side, b_next_side
+end

Determines if Q lies to the left or right of the line formed by P1-P2-P3

julia
function _get_side(Q, P1, P2, P3; exact)
+    s1 = Predicates.orient(Q, P1, P2; exact)
+    s2 = Predicates.orient(Q, P2, P3; exact)
+    s3 = Predicates.orient(P1, P2, P3; exact)
+
+    side = if s3  0
+        (s1 < 0) || (s2 < 0) ? right : left
+    else #  s3 < 0
+        (s1 > 0) || (s2 > 0) ? left : right
+    end
+    return side
+end
+
+#= Given a list of PolyNodes, find the first element that isn't an intersection point. Then,
+test if this element is in or out of the given polygon. Return the next index, as well as
+the enter/exit status of the next intersection point (the opposite of the in/out check). If
+all points are intersection points, find the first element that either is the end of a chain
+or a crossing point that isn't in a chain. Then take the midpoint of this point and the next
+point in the list and perform the in/out check. If none of these points exist, return
+a \`next_idx\` of \`nothing\`. =#
+function _pt_off_edge_status(::Type{T}, pt_list, poly, npts; exact) where T
+    start_idx, is_non_intr_pt = findfirst(_is_not_intr, pt_list), true
+    if isnothing(start_idx)
+        start_idx, is_non_intr_pt = findfirst(_next_edge_off, pt_list), false
+        isnothing(start_idx) && return (start_idx, false)
+    end
+    next_idx = start_idx < npts ? (start_idx + 1) : 1
+    start_pt = if is_non_intr_pt
+        pt_list[start_idx].point
+    else
+        (pt_list[start_idx].point .+ pt_list[next_idx].point) ./ 2
+    end
+    start_status = !_point_filled_curve_orientation(start_pt, poly; in = true, on = false, out = false, exact)
+    return next_idx, start_status
+end

Check if a PolyNode is an intersection point

julia
_is_not_intr(pt) = !pt.inter
+#= Check if a PolyNode is the last point of a chain or a non-overlapping crossing point.
+The next midpoint of one of these points and the next point within a polygon must not be on
+the polygon edge. =#
+_next_edge_off(pt) = (pt.endpoint == end_chain) || (pt.crossing && pt.endpoint == not_endpoint)
_flag_ent_exit!(::Type{T}, ::GI.LinearRingTrait, poly, pt_list, delay_cross_f, delay_bounce_f; exact)

This function flags all the intersection points as either an 'entry' or 'exit' point in relation to the given polygon. For non-delayed crossings we simply alternate the enter/exit status. This also holds true for the first and last points of a delayed bouncing, where they both have an opposite entry/exit flag. Conversely, the first and last point of a delayed crossing have the same entry/exit status. Furthermore, the crossing/bouncing flag of delayed crossings and bouncings may be updated. This depends on function specific rules that determine which of the start or end points (if any) should be marked as crossing for used during polygon tracing. A consistent rule is that the start and end points of a delayed crossing will have different crossing/bouncing flags, while a the endpoints of a delayed bounce will be the same.

Used for clipping polygons by other polygons.

julia
function _flag_ent_exit!(::Type{T}, ::GI.LinearRingTrait, poly, pt_list, delay_cross_f, delay_bounce_f; exact) where T
+    npts = length(pt_list)

Find starting index if there is one

julia
    next_idx, status = _pt_off_edge_status(T, pt_list, poly, npts; exact)
+    isnothing(next_idx) && return
+    start_idx = next_idx - 1

Loop over points and mark entry and exit status

julia
    start_chain_idx = 0
+    for ii in Iterators.flatten((next_idx:npts, 1:start_idx))
+        curr_pt = pt_list[ii]
+        if curr_pt.endpoint == start_chain
+            start_chain_idx = ii
+        elseif curr_pt.crossing || curr_pt.endpoint == end_chain
+            start_crossing, end_crossing = curr_pt.crossing, curr_pt.crossing
+            if curr_pt.endpoint == end_chain  # ending overlapping chain
+                start_pt = pt_list[start_chain_idx]
+                if curr_pt.crossing  # delayed crossing
+                    #= start and end crossing status are different and depend on current
+                    entry/exit status =#
+                    start_crossing, end_crossing = delay_cross_f(status)
+                else  # delayed bouncing
+                    next_idx = ii < npts ? (ii + 1) : 1
+                    next_val = (curr_pt.point .+ pt_list[next_idx].point) ./ 2
+                    pt_in_poly = _point_filled_curve_orientation(next_val, poly; in = true, on = false, out = false, exact)
+                    #= start and end crossing status are the same and depend on if adjacent
+                    edges of pt_list are within poly =#
+                    start_crossing = delay_bounce_f(pt_in_poly)
+                    end_crossing = start_crossing
+                end

update start of chain point

julia
                pt_list[start_chain_idx] = PolyNode(start_pt; ent_exit = status, crossing = start_crossing)
+                if !curr_pt.crossing
+                    status = !status
+                end
+            end
+            pt_list[ii] = PolyNode(curr_pt; ent_exit = status, crossing = end_crossing)
+            status = !status
+        end
+    end
+    return
+end
_flag_ent_exit!(::GI.LineTrait, line, pt_list; exact)

This function flags all the intersection points as either an 'entry' or 'exit' point in relation to the given line. Returns true if there are crossing points to classify, else returns false. Used for cutting polygons by lines.

Assumes that the first point is outside of the polygon and not on an edge.

julia
function _flag_ent_exit!(::GI.LineTrait, poly, pt_list; exact)
+    status = !_point_filled_curve_orientation(pt_list[1].point, poly; in = true, on = false, out = false, exact)

Loop over points and mark entry and exit status

julia
    for (ii, curr_pt) in enumerate(pt_list)
+        if curr_pt.crossing
+            pt_list[ii] = PolyNode(curr_pt; ent_exit = status)
+            status = !status
+        end
+    end
+    return
+end
+
+#= Filters a_idx_list to just include crossing points and sets the index of all crossing
+points (which element they correspond to within a_idx_list). =#
+function _index_crossing_intrs!(a_list, b_list, a_idx_list)
+    filter!(x -> a_list[x].crossing, a_idx_list)
+    for (i, a_idx) in enumerate(a_idx_list)
+        curr_node = a_list[a_idx]
+        neighbor_node = b_list[curr_node.neighbor]
+        a_list[a_idx] = PolyNode(curr_node; idx = i)
+        b_list[curr_node.neighbor] = PolyNode(neighbor_node; idx = i)
+    end
+    return
+end
_trace_polynodes(::Type{T}, a_list, b_list, a_idx_list, f_step)::Vector{GI.Polygon}

This function takes the outputs of _build_ab_list and traces the lists to determine which polygons are formed as described in Greiner and Hormann. The function f_step determines in which direction the lists are traced. This function is different for intersection, difference, and union. f_step must take in two arguments: the most recent intersection node's entry/exit status and a boolean that is true if we are currently tracing a_list and false if we are tracing b_list. The functions used for each clipping operation are follows: - Intersection: (x, y) -> x ? 1 : (-1) - Difference: (x, y) -> (x ⊻ y) ? 1 : (-1) - Union: (x, y) -> x ? (-1) : 1

A list of GeoInterface polygons is returned from this function.

Note: poly_a and poly_b are temporary inputs used for debugging and can be removed eventually.

julia
function _trace_polynodes(::Type{T}, a_list, b_list, a_idx_list, f_step, poly_a, poly_b) where T
+    n_a_pts, n_b_pts = length(a_list), length(b_list)
+    total_pts = n_a_pts + n_b_pts
+    n_cross_pts = length(a_idx_list)
+    return_polys = Vector{_get_poly_type(T)}(undef, 0)

Keep track of number of processed intersection points

julia
    visited_pts = 0
+    processed_pts = 0
+    first_idx = 1
+    while processed_pts < n_cross_pts
+        curr_list, curr_npoints = a_list, n_a_pts
+        on_a_list = true

Find first unprocessed intersecting point in subject polygon

julia
        visited_pts += 1
+        processed_pts += 1
+        first_idx = findnext(x -> x != 0, a_idx_list, first_idx)
+        idx = a_idx_list[first_idx]
+        a_idx_list[first_idx] = 0
+        start_pt = a_list[idx]

Set first point in polygon

julia
        curr = curr_list[idx]
+        pt_list = [curr.point]
+
+        curr_not_start = true
+        while curr_not_start
+            step = f_step(curr.ent_exit, on_a_list)

changed curr_not_intr to curr_not_same_ent_flag

julia
            same_status, prev_status = true, curr.ent_exit
+            while same_status
+                @assert visited_pts < total_pts "Clipping tracing hit every point - clipping error. Please open an issue with polygons: $(GI.coordinates(poly_a)) and $(GI.coordinates(poly_b))."

Traverse polygon either forwards or backwards

julia
                idx += step
+                idx = (idx > curr_npoints) ? mod(idx, curr_npoints) : idx
+                idx = (idx == 0) ? curr_npoints : idx

Get current node and add to pt_list

julia
                curr = curr_list[idx]
+                push!(pt_list, curr.point)
+                if (curr.crossing || curr.endpoint != not_endpoint)

Keep track of processed intersection points

julia
                    same_status = curr.ent_exit == prev_status
+                    curr_not_start = curr != start_pt && curr != b_list[start_pt.neighbor]
+                    !curr_not_start && break
+                    if (on_a_list && curr.crossing) || (!on_a_list && a_list[curr.neighbor].crossing)
+                        processed_pts += 1
+                        a_idx_list[curr.idx] = 0
+                    end
+                end
+                visited_pts += 1
+            end

Switch to next list and next point

julia
            curr_list, curr_npoints = on_a_list ? (b_list, n_b_pts) : (a_list, n_a_pts)
+            on_a_list = !on_a_list
+            idx = curr.neighbor
+            curr = curr_list[idx]
+        end
+        push!(return_polys, GI.Polygon([pt_list]))
+    end
+    return return_polys
+end

Get type of polygons that will be made TODO: Increase type options

julia
_get_poly_type(::Type{T}) where T =
+    GI.Polygon{false, false, Vector{GI.LinearRing{false, false, Vector{Tuple{T, T}}, Nothing, Nothing}}, Nothing, Nothing}
_find_non_cross_orientation(a_list, b_list, a_poly, b_poly; exact)

For polygons with no crossing intersection points, either one polygon is inside of another, or they are separate polygons with no intersection (other than an edge or point).

Return two booleans that represent if a is inside b (potentially with shared edges / points) and visa versa if b is inside of a.

julia
function _find_non_cross_orientation(a_list, b_list, a_poly, b_poly; exact)
+    non_intr_a_idx = findfirst(x -> !x.inter, a_list)
+    non_intr_b_idx = findfirst(x -> !x.inter, b_list)
+    #= Determine if non-intersection point is in or outside of polygon - if there isn't A
+    non-intersection point, then all points are on the polygon edge =#
+    a_pt_orient = isnothing(non_intr_a_idx) ? point_on :
+        _point_filled_curve_orientation(a_list[non_intr_a_idx].point, b_poly; exact)
+    b_pt_orient = isnothing(non_intr_b_idx) ? point_on :
+        _point_filled_curve_orientation(b_list[non_intr_b_idx].point, a_poly; exact)
+    a_in_b = a_pt_orient != point_out && b_pt_orient != point_in
+    b_in_a = b_pt_orient != point_out && a_pt_orient != point_in
+    return a_in_b, b_in_a
+end
_add_holes_to_polys!(::Type{T}, return_polys, hole_iterator, remove_poly_idx; exact)

The holes specified by the hole iterator are added to the polygons in the return_polys list. If this creates more polygons, they are added to the end of the list. If this removes polygons, they are removed from the list

julia
function _add_holes_to_polys!(::Type{T}, return_polys, hole_iterator, remove_poly_idx; exact) where T
+    n_polys = length(return_polys)
+    remove_hole_idx = Int[]

Remove set of holes from all polygons

julia
    for i in 1:n_polys
+        n_new_per_poly = 0
+        for curr_hole in Iterators.map(tuples, hole_iterator) # loop through all holes
+            curr_hole = _linearring(curr_hole)

loop through all pieces of original polygon (new pieces added to end of list)

julia
            for j in Iterators.flatten((i:i, (n_polys + 1):(n_polys + n_new_per_poly)))
+                curr_poly = return_polys[j]
+                remove_poly_idx[j] && continue
+                curr_poly_ext = GI.nhole(curr_poly) > 0 ? GI.Polygon(StaticArrays.SVector(GI.getexterior(curr_poly))) : curr_poly
+                in_ext, on_ext, out_ext = _line_polygon_interactions(curr_hole, curr_poly_ext; exact, closed_line = true)
+                if in_ext  # hole is at least partially within the polygon's exterior
+                    new_hole, new_hole_poly, n_new_pieces = _combine_holes!(T, curr_hole, curr_poly, return_polys, remove_hole_idx)
+                    if n_new_pieces > 0
+                        append!(remove_poly_idx, falses(n_new_pieces))
+                        n_new_per_poly += n_new_pieces
+                    end
+                    if !on_ext && !out_ext  # hole is completely within exterior
+                        push!(curr_poly.geom, new_hole)
+                    else  # hole is partially within and outside of polygon's exterior
+                        new_polys = difference(curr_poly_ext, new_hole_poly, T; target=GI.PolygonTrait())
+                        n_new_polys = length(new_polys) - 1

replace original

julia
                        curr_poly.geom[1] = GI.getexterior(new_polys[1])
+                        append!(curr_poly.geom, GI.gethole(new_polys[1]))
+                        if n_new_polys > 0  # add any extra pieces
+                            append!(return_polys, @view new_polys[2:end])
+                            append!(remove_poly_idx, falses(n_new_polys))
+                            n_new_per_poly += n_new_polys
+                        end
+                    end

polygon is completely within hole

julia
                elseif coveredby(curr_poly_ext, GI.Polygon(StaticArrays.SVector(curr_hole)))
+                    remove_poly_idx[j] = true
+                end
+            end
+        end
+        n_polys += n_new_per_poly
+    end

Remove all polygon that were marked for removal

julia
    deleteat!(return_polys, remove_poly_idx)
+    return
+end
_combine_holes!(::Type{T}, new_hole, curr_poly, return_polys)

The new hole is combined with any existing holes in curr_poly. The holes can be combined into a larger hole if they are intersecting. If this happens, then the new, combined hole is returned with the original holes making up the new hole removed from curr_poly. Additionally, if the combined holes form a ring, the interior is added to the return_polys as a new polygon piece. Additionally, holes leftover after combination will be checked for it they are in the "main" polygon or in one of these new pieces and moved accordingly.

If the holes don't touch or curr_poly has no holes, then new_hole is returned without any changes.

julia
function _combine_holes!(::Type{T}, new_hole, curr_poly, return_polys, remove_hole_idx) where T
+    n_new_polys = 0
+    empty!(remove_hole_idx)
+    new_hole_poly = GI.Polygon(StaticArrays.SVector(new_hole))

Combine any existing holes in curr_poly with new hole

julia
    for (k, old_hole) in enumerate(GI.gethole(curr_poly))
+        old_hole_poly = GI.Polygon(StaticArrays.SVector(old_hole))
+        if intersects(new_hole_poly, old_hole_poly)

If the holes intersect, combine them into a bigger hole

julia
            hole_union = union(new_hole_poly, old_hole_poly, T; target = GI.PolygonTrait())[1]
+            push!(remove_hole_idx, k + 1)
+            new_hole = GI.getexterior(hole_union)
+            new_hole_poly = GI.Polygon(StaticArrays.SVector(new_hole))
+            n_pieces = GI.nhole(hole_union)
+            if n_pieces > 0  # if the hole has a hole, then this is a new polygon piece!
+                append!(return_polys, [GI.Polygon([h]) for h in GI.gethole(hole_union)])
+                n_new_polys += n_pieces
+            end
+        end
+    end

Remove redundant holes

julia
    deleteat!(curr_poly.geom, remove_hole_idx)
+    empty!(remove_hole_idx)

If new polygon pieces created, make sure remaining holes are in the correct piece

julia
    @views for piece in return_polys[end - n_new_polys + 1:end]
+        for (k, old_hole) in enumerate(GI.gethole(curr_poly))
+            if !(k in remove_hole_idx) && within(old_hole, piece)
+                push!(remove_hole_idx, k + 1)
+                push!(piece.geom, old_hole)
+            end
+        end
+    end
+    deleteat!(curr_poly.geom, remove_hole_idx)
+    return new_hole, new_hole_poly, n_new_polys
+end
+
+#= Remove collinear edge points, other than the first and last edge vertex, to simplify
+polygon - including both the exterior ring and any holes=#
+function _remove_collinear_points!(polys, remove_idx, poly_a, poly_b)
+    for (i, poly) in Iterators.reverse(enumerate(polys))
+        for (j, ring) in Iterators.reverse(enumerate(GI.getring(poly)))
+            n = length(ring.geom)

resize and reset removing index buffer

julia
            resize!(remove_idx, n)
+            fill!(remove_idx, false)
+            local p1, p2
+            for (i, p) in enumerate(ring.geom)
+                if i == 1
+                    p1 = p
+                    continue
+                elseif i == 2
+                    p2 = p
+                    continue
+                else
+                    p3 = p

check if p2 is approximately on the edge formed by p1 and p3 - remove if so

julia
                    if Predicates.orient(p1, p2, p3; exact = _False()) == 0
+                        remove_idx[i - 1] = true
+                    end
+                end
+                p1, p2 = p2, p3
+            end

Check if the first point (which is repeated as the last point) is needed

julia
            if Predicates.orient(ring.geom[end - 1], ring.geom[1], ring.geom[2]; exact = _False()) == 0
+                remove_idx[1], remove_idx[end] = true, true
+            end

Remove unneeded collinear points

julia
            deleteat!(ring.geom, remove_idx)

Check if enough points are left to form a polygon

julia
            if length(ring.geom)  (remove_idx[1] ? 2 : 3)
+                if j == 1
+                    deleteat!(polys, i)
+                    break
+                else
+                    deleteat!(poly.geom, j)
+                    continue
+                end
+            end
+            if remove_idx[1]  # make sure the last point is repeated
+                push!(ring.geom, ring.geom[1])
+            end
+        end
+    end
+    return
+end

This page was generated using Literate.jl.

`,169)]))}const y=i(t,[["render",p]]);export{g as __pageData,y as default}; diff --git a/previews/PR237/assets/source_methods_clipping_coverage.md.DV_tWTFE.js b/previews/PR237/assets/source_methods_clipping_coverage.md.DV_tWTFE.js new file mode 100644 index 000000000..ed6edf444 --- /dev/null +++ b/previews/PR237/assets/source_methods_clipping_coverage.md.DV_tWTFE.js @@ -0,0 +1,223 @@ +import{_ as i,c as a,a5 as n,o as h}from"./chunks/framework.Cq8AuEls.js";const l="/GeometryOps.jl/previews/PR237/assets/bcsrpqr.Cb0_DiYE.png",y=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"source/methods/clipping/coverage.md","filePath":"source/methods/clipping/coverage.md","lastUpdated":null}'),k={name:"source/methods/clipping/coverage.md"};function p(t,s,e,E,r,d){return h(),a("div",null,s[0]||(s[0]=[n(`
julia
export coverage

What is coverage?

Coverage is the amount of geometry area within a bounding box defined by the minimum and maximum x and y-coordinates of that bounding box, or an Extent containing that information.

To provide an example, consider this rectangle:

julia
import GeometryOps as GO
+import GeoInterface as GI
+using Makie
+using CairoMakie
+
+rect = GI.Polygon([[(-1,0), (-1,1), (1,1), (1,0), (-1,0)]])
+cell = GI.Polygon([[(0, 0), (0, 2), (2, 2), (2, 0), (0, 0)]])
+xmin, xmax, ymin, ymax = 0, 2, 0, 2
+f, a, p = poly(collect(GI.getpoint(cell)); axis = (; aspect = DataAspect()))
+poly!(collect(GI.getpoint(rect)))
+f

It is clear that half of the polygon is within the cell, so the coverage should be 1.0, half of the area of the rectangle.

julia
GO.coverage(rect, xmin, xmax, ymin, ymax)
1.0

Implementation

This is the GeoInterface-compatible implementation. First, we implement a wrapper method that dispatches to the correct implementation based on the geometry trait. This is also used in the implementation, since it's a lot less work!

Note that the coverage is zero for all points and curves, even if the curves are closed like with a linear ring.

Targets for applys functions

julia
const _COVERAGE_TARGETS = TraitTarget{Union{GI.PolygonTrait,GI.AbstractCurveTrait,GI.MultiPointTrait,GI.PointTrait}}()

Wall types for coverage

julia
const UNKNOWN, NORTH, EAST, SOUTH, WEST = 0:4
+
+"""
+    coverage(geom, xmin, xmax, ymin, ymax, [T = Float64])::T
+
+Returns the area of intersection between given geometry and grid cell defined by its minimum
+and maximum x and y-values. This is computed differently for different geometries:
+
+- The signed area of a point is always zero.
+- The signed area of a curve is always zero.
+- The signed area of a polygon is calculated by tracing along its edges and switching to the
+    cell edges if needed.
+- The coverage of a geometry collection, multi-geometry, feature collection of
+    array/iterable is the sum of the coverages of all of the sub-geometries.
+
+Result will be of type T, where T is an optional argument with a default value
+of Float64.
+"""
+function coverage(geom, xmin, xmax, ymin, ymax,::Type{T} = Float64; threaded=false) where T <: AbstractFloat
+    applyreduce(+, _COVERAGE_TARGETS, geom; threaded, init=zero(T)) do g
+        _coverage(T, GI.trait(g), g, T(xmin), T(xmax), T(ymin), T(ymax))
+    end
+end
+
+function coverage(geom, cell_ext::Extents.Extent, ::Type{T} = Float64; threaded=false) where T <: AbstractFloat
+    (xmin, xmax), (ymin, ymax) = values(cell_ext)
+    return coverage(geom, xmin, xmax, ymin, ymax, T; threaded = threaded)
+end

Points, MultiPoints, Curves, MultiCurves

julia
_coverage(::Type{T}, ::GI.AbstractGeometryTrait, geom, xmin, xmax, ymin, ymax; kwargs...) where T = zero(T)

Polygons

julia
function _coverage(::Type{T}, ::GI.PolygonTrait, poly, xmin, xmax, ymin, ymax; exact = _False()) where T
+    GI.isempty(poly) && return zero(T)
+    cov_area = _coverage(T, GI.getexterior(poly), xmin, xmax, ymin, ymax; exact)
+    cov_area == 0 && return cov_area

Remove hole coverage from total

julia
    for hole in GI.gethole(poly)
+        cov_area -= _coverage(T, hole, xmin, xmax, ymin, ymax; exact)
+    end
+    return cov_area
+end
+
+#= Calculates the area of the filled ring within the cell defined by corners with (xmin, ymin),
+(xmin, ymax), (xmax, ymax), and (xmax, ymin). =#
+function _coverage(::Type{T}, ring, xmin, xmax, ymin, ymax; exact) where T
+    cov_area = zero(T)
+    unmatched_out_wall, unmatched_out_point = UNKNOWN, (zero(T), zero(T))
+    unmatched_in_wall, unmatched_in_point = unmatched_out_wall, unmatched_out_point

Loop over edges of polygon

julia
    start_idx = 1
+    for (i, p) in enumerate(GI.getpoint(ring))
+        if !_point_in_cell(p, xmin, xmax, ymin, ymax)
+            start_idx = i
+            break
+        end
+    end
+    ring_cw = isclockwise(ring)
+    p1 = _tuple_point(GI.getpoint(ring, start_idx), T)

Must rotate clockwise for the algorithm to work

julia
    point_idx = ring_cw ? Iterators.flatten((start_idx + 1:GI.npoint(ring), 1:start_idx)) :
+        Iterators.flatten((start_idx - 1:-1:1, GI.npoint(ring):-1:start_idx))
+    for i in point_idx
+        p2 = _tuple_point(GI.getpoint(ring, i), T)

Determine if edge points are within the cell

julia
        p1_in_cell = _point_in_cell(p1, xmin, xmax, ymin, ymax)
+        p2_in_cell = _point_in_cell(p2, xmin, xmax, ymin, ymax)

If entire line segment is inside cell

julia
        if p1_in_cell && p2_in_cell
+            cov_area += _area_component(p1, p2)
+            p1 = p2
+            continue
+        end

If edge passes outside of rectangle, determine which edge segments are added

julia
        inter1, inter2 = _line_intersect_cell(T, p1, p2, xmin, xmax, ymin, ymax)

Endpoints of segment within the cell and wall they are on if known

julia
        (start_wall, start_point), (end_wall, end_point) =
+            if p1_in_cell
+                ((UNKNOWN, p1), inter1)
+            elseif p2_in_cell
+                (inter1, (UNKNOWN, p2))
+            else
+                i1_to_p1 = _squared_euclid_distance(T, inter1[2], p1)
+                i2_to_p1 = _squared_euclid_distance(T, inter2[2], p1)
+                i1_to_p1 < i2_to_p1 ? (inter1, inter2) : (inter2, inter1)
+            end

Add edge component

julia
        cov_area += _area_component(start_point, end_point)
+
+        if start_wall != UNKNOWN  # p1 out of cell
+            if unmatched_out_wall == UNKNOWN
+                unmatched_in_point = start_point
+                unmatched_in_wall = start_wall
+            else
+                check_point = find_point_on_cell(unmatched_out_point, start_point,
+                    unmatched_out_wall, start_wall,xmin, xmax, ymin, ymax)
+                if _point_filled_curve_orientation(check_point, ring; in = true, on = false, out = false, exact)
+                    cov_area += connect_edges(T, unmatched_out_point, start_point,
+                        unmatched_out_wall, start_wall,xmin, xmax, ymin, ymax)
+                else
+                    cov_area += connect_edges(T, unmatched_out_point, unmatched_in_point,
+                        unmatched_out_wall, unmatched_in_wall,xmin, xmax, ymin, ymax)
+                    unmatched_out_wall == UNKNOWN
+                end
+            end
+        end
+        if end_wall != UNKNOWN  # p2 out of cell
+            unmatched_out_wall, unmatched_out_point = end_wall, end_point
+        end
+        p1 = p2
+    end

if unmatched in-point at beginning, close polygon with last out point

julia
    if unmatched_in_wall != UNKNOWN
+        cov_area += connect_edges(T, unmatched_out_point, unmatched_in_point,
+            unmatched_out_wall, unmatched_in_wall,xmin, xmax, ymin, ymax)
+    end
+    cov_area = abs(cov_area) / 2

if grid cell is within polygon then the area is grid cell area

julia
    if cov_area == 0
+        if _point_filled_curve_orientation((xmin, ymin), ring; in = true, on = true, out = false, exact)
+            cov_area = abs((xmax - xmin) * (ymax - ymin))
+        end
+    end
+    return cov_area
+end

Returns true of the given point is within the bounding box determined by x and y values

julia
_point_in_cell(p, xmin, xmax, ymin, ymax) = xmin <= GI.x(p) <= xmax && ymin <= GI.y(p) <= ymax

Returns true if b is between a and c, exclusive of the maximum value, else false.

julia
_between(b, a, c) = a  b < c || c  b < a
+
+#= Determine intersections of the line from (x1, y1) to (x2, y2) with the bounding box
+defined by the minimum and maximum x/y values. Since we are dealing with a single line
+segment, we know that there is at maximum two intersection points.
+
+For each intersection point that we find, return the wall that it passes through, as well as
+the intersection point itself as a a tuple. If an intersection point isn't found, return the
+wall as UNKNOWN and the point as a pair of zeros. =#
+function _line_intersect_cell(::Type{T}, (x1, y1), (x2, y2), xmin, xmax, ymin, ymax) where T
+    Δx, Δy = x2 - x1, y2 - y1
+    inter1 = (UNKNOWN, (zero(T), zero(T)))
+    inter2 = inter1
+    if Δx == 0  # If line is vertical, only consider north and south
+        if xmin  x1  xmax
+            inter1 = _between(ymax, y1, y2) ? (NORTH, (x1, ymax)) : inter1
+            inter2 = _between(ymin, y1, y2) ? (SOUTH, (x1, ymin)) : inter2
+        end
+    elseif Δy == 0 # If line is horizontal, only consider east and west
+        if ymin  y1  ymax
+            inter1 = _between(xmax, x1, x2) ? (EAST, (xmax, y1)) : inter1
+            inter2 = _between(xmin, x1, x2) ? (WEST, (xmin, y1)) : inter2
+        end
+    else  # Line is tilted, must consider all edges, but only two can intersect
+        m = Δy / Δx
+        b = y1 - m * x1

Calculate and check potential intersections

julia
        xn = (ymax - b) / m
+        if xmin  xn  xmax && _between(xn, x1, x2) && _between(ymax, y1, y2)
+            inter1 = (NORTH, (xn, ymax))
+        end
+        xs = (ymin - b) / m
+        if xmin  xs  xmax && _between(xs, x1, x2) && _between(ymin, y1, y2)
+            new_intr = (SOUTH, (xs, ymin))
+            (inter1[1] == UNKNOWN) ? (inter1 = new_intr) : (inter2 = new_intr)
+        end
+        ye =  m * xmax + b
+        if ymin  ye  ymax && _between(ye, y1, y2) && _between(xmax, x1, x2)
+            new_intr = (EAST, (xmax, ye))
+            (inter1[1] == UNKNOWN) ? (inter1 = new_intr) : (inter2 = new_intr)
+        end
+        yw = m * xmin + b
+        if ymin  yw  ymax && _between(yw, y1, y2) && _between(xmin, x1, x2)
+            new_intr = (WEST, (xmin, yw))
+            (inter1[1] == UNKNOWN) ? (inter1 = new_intr) : (inter2 = new_intr)
+        end
+    end
+    if inter1[1] == UNKNOWN  # first intersection must be known, if one exists
+        inter1, inter2 = inter2, inter1
+    end
+    return inter1, inter2
+end

Finds point of cell edge between p1 and p2 given which walls they are on

julia
function find_point_on_cell(p1, p2, wall1, wall2, xmin, xmax, ymin, ymax)
+    x1, y1 = p1
+    x2, y2 = p2
+    mid_point = if wall1 == wall2 && _is_clockwise_from(p1, p2, wall1)
+        (x1 + x2) / 2, (y1 + y2) / 2
+    elseif wall1 == NORTH
+        (xmax, ymax)
+    elseif wall1 == EAST
+        (xmax, ymin)
+    elseif wall1 == SOUTH
+        (xmin, ymin)
+    else
+        (xmin, ymax)
+    end
+    return mid_point
+end
+
+#= Area component of shoelace formula coming from the distance between point 1 and point 2
+along grid cell walls in between the two points. =#
+function connect_edges(::Type{T}, p1, p2, wall1, wall2, xmin, xmax, ymin, ymax) where {T}
+    connect_area = zero(T)
+    if wall1 == wall2 && _is_clockwise_from(p1, p2, wall1)
+        connect_area += _area_component(p1, p2)
+    else

From the point to the corner of wall 1

julia
        connect_area += _partial_edge_out_area(p1, xmin, xmax, ymin, ymax, wall1)

Any intermediate walls (full length)

julia
        next_wall, last_wall = wall1 + 1, wall2 - 1
+        if wall2 > wall1
+            for wall in next_wall:last_wall
+                connect_area += _full_edge_area(xmin, xmax, ymin, ymax, wall)
+            end
+        else
+            for wall in Iterators.flatten((next_wall:WEST, NORTH:last_wall))
+                connect_area += _full_edge_area(xmin, xmax, ymin, ymax, wall)
+            end
+        end

From the corner of wall 2 to the point

julia
        connect_area += _partial_edge_in_area(p2, xmin, xmax, ymin, ymax, wall2)
+    end
+    return connect_area
+end

True if (x1, y1) is clockwise from (x2, y2) on the same wall

julia
_is_clockwise_from((x1, y1), (x2, y2), wall) = (wall == NORTH && x2 > x1) ||
+    (wall == EAST && y2 < y1) || (wall == SOUTH && x2 < x1) || (wall == WEST && y2 > y1)
+
+#= Returns the area component of a full edge of the bounding box defined by the min and max
+values and the wall. =#
+_full_edge_area(xmin, xmax, ymin, ymax, wall) = if wall == NORTH
+        ymax * (xmin - xmax)
+    elseif wall == EAST
+        xmax * (ymin - ymax)
+    elseif wall == SOUTH
+        ymin * (xmax - xmin)
+    else
+        xmin * (ymax - ymin)
+    end
+
+#= Returns the area component of part of one wall, from its "starting corner" (going
+clockwise) to the point (x2, y2). =#
+function _partial_edge_in_area((x2, y2), xmin, xmax, ymin, ymax, wall)
+    x_wall = (wall == NORTH || wall == WEST) ? xmin : xmax
+    y_wall = (wall == NORTH || wall == EAST) ? ymax : ymin
+    return x_wall * y2 - x2 * y_wall
+end
+
+#= Returns the area component of part of one wall, from the point (x1, y1) to its
+"ending corner" (going clockwise). =#
+function _partial_edge_out_area((x1, y1), xmin, xmax, ymin, ymax, wall)
+    x_wall = (wall == NORTH || wall == EAST) ? xmax : xmin
+    y_wall = (wall == NORTH || wall == WEST) ? ymax : ymin
+    return x1 * y_wall - x_wall * y1
+end

This page was generated using Literate.jl.

`,58)]))}const F=i(k,[["render",p]]);export{y as __pageData,F as default}; diff --git a/previews/PR237/assets/source_methods_clipping_coverage.md.DV_tWTFE.lean.js b/previews/PR237/assets/source_methods_clipping_coverage.md.DV_tWTFE.lean.js new file mode 100644 index 000000000..ed6edf444 --- /dev/null +++ b/previews/PR237/assets/source_methods_clipping_coverage.md.DV_tWTFE.lean.js @@ -0,0 +1,223 @@ +import{_ as i,c as a,a5 as n,o as h}from"./chunks/framework.Cq8AuEls.js";const l="/GeometryOps.jl/previews/PR237/assets/bcsrpqr.Cb0_DiYE.png",y=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"source/methods/clipping/coverage.md","filePath":"source/methods/clipping/coverage.md","lastUpdated":null}'),k={name:"source/methods/clipping/coverage.md"};function p(t,s,e,E,r,d){return h(),a("div",null,s[0]||(s[0]=[n(`
julia
export coverage

What is coverage?

Coverage is the amount of geometry area within a bounding box defined by the minimum and maximum x and y-coordinates of that bounding box, or an Extent containing that information.

To provide an example, consider this rectangle:

julia
import GeometryOps as GO
+import GeoInterface as GI
+using Makie
+using CairoMakie
+
+rect = GI.Polygon([[(-1,0), (-1,1), (1,1), (1,0), (-1,0)]])
+cell = GI.Polygon([[(0, 0), (0, 2), (2, 2), (2, 0), (0, 0)]])
+xmin, xmax, ymin, ymax = 0, 2, 0, 2
+f, a, p = poly(collect(GI.getpoint(cell)); axis = (; aspect = DataAspect()))
+poly!(collect(GI.getpoint(rect)))
+f

It is clear that half of the polygon is within the cell, so the coverage should be 1.0, half of the area of the rectangle.

julia
GO.coverage(rect, xmin, xmax, ymin, ymax)
1.0

Implementation

This is the GeoInterface-compatible implementation. First, we implement a wrapper method that dispatches to the correct implementation based on the geometry trait. This is also used in the implementation, since it's a lot less work!

Note that the coverage is zero for all points and curves, even if the curves are closed like with a linear ring.

Targets for applys functions

julia
const _COVERAGE_TARGETS = TraitTarget{Union{GI.PolygonTrait,GI.AbstractCurveTrait,GI.MultiPointTrait,GI.PointTrait}}()

Wall types for coverage

julia
const UNKNOWN, NORTH, EAST, SOUTH, WEST = 0:4
+
+"""
+    coverage(geom, xmin, xmax, ymin, ymax, [T = Float64])::T
+
+Returns the area of intersection between given geometry and grid cell defined by its minimum
+and maximum x and y-values. This is computed differently for different geometries:
+
+- The signed area of a point is always zero.
+- The signed area of a curve is always zero.
+- The signed area of a polygon is calculated by tracing along its edges and switching to the
+    cell edges if needed.
+- The coverage of a geometry collection, multi-geometry, feature collection of
+    array/iterable is the sum of the coverages of all of the sub-geometries.
+
+Result will be of type T, where T is an optional argument with a default value
+of Float64.
+"""
+function coverage(geom, xmin, xmax, ymin, ymax,::Type{T} = Float64; threaded=false) where T <: AbstractFloat
+    applyreduce(+, _COVERAGE_TARGETS, geom; threaded, init=zero(T)) do g
+        _coverage(T, GI.trait(g), g, T(xmin), T(xmax), T(ymin), T(ymax))
+    end
+end
+
+function coverage(geom, cell_ext::Extents.Extent, ::Type{T} = Float64; threaded=false) where T <: AbstractFloat
+    (xmin, xmax), (ymin, ymax) = values(cell_ext)
+    return coverage(geom, xmin, xmax, ymin, ymax, T; threaded = threaded)
+end

Points, MultiPoints, Curves, MultiCurves

julia
_coverage(::Type{T}, ::GI.AbstractGeometryTrait, geom, xmin, xmax, ymin, ymax; kwargs...) where T = zero(T)

Polygons

julia
function _coverage(::Type{T}, ::GI.PolygonTrait, poly, xmin, xmax, ymin, ymax; exact = _False()) where T
+    GI.isempty(poly) && return zero(T)
+    cov_area = _coverage(T, GI.getexterior(poly), xmin, xmax, ymin, ymax; exact)
+    cov_area == 0 && return cov_area

Remove hole coverage from total

julia
    for hole in GI.gethole(poly)
+        cov_area -= _coverage(T, hole, xmin, xmax, ymin, ymax; exact)
+    end
+    return cov_area
+end
+
+#= Calculates the area of the filled ring within the cell defined by corners with (xmin, ymin),
+(xmin, ymax), (xmax, ymax), and (xmax, ymin). =#
+function _coverage(::Type{T}, ring, xmin, xmax, ymin, ymax; exact) where T
+    cov_area = zero(T)
+    unmatched_out_wall, unmatched_out_point = UNKNOWN, (zero(T), zero(T))
+    unmatched_in_wall, unmatched_in_point = unmatched_out_wall, unmatched_out_point

Loop over edges of polygon

julia
    start_idx = 1
+    for (i, p) in enumerate(GI.getpoint(ring))
+        if !_point_in_cell(p, xmin, xmax, ymin, ymax)
+            start_idx = i
+            break
+        end
+    end
+    ring_cw = isclockwise(ring)
+    p1 = _tuple_point(GI.getpoint(ring, start_idx), T)

Must rotate clockwise for the algorithm to work

julia
    point_idx = ring_cw ? Iterators.flatten((start_idx + 1:GI.npoint(ring), 1:start_idx)) :
+        Iterators.flatten((start_idx - 1:-1:1, GI.npoint(ring):-1:start_idx))
+    for i in point_idx
+        p2 = _tuple_point(GI.getpoint(ring, i), T)

Determine if edge points are within the cell

julia
        p1_in_cell = _point_in_cell(p1, xmin, xmax, ymin, ymax)
+        p2_in_cell = _point_in_cell(p2, xmin, xmax, ymin, ymax)

If entire line segment is inside cell

julia
        if p1_in_cell && p2_in_cell
+            cov_area += _area_component(p1, p2)
+            p1 = p2
+            continue
+        end

If edge passes outside of rectangle, determine which edge segments are added

julia
        inter1, inter2 = _line_intersect_cell(T, p1, p2, xmin, xmax, ymin, ymax)

Endpoints of segment within the cell and wall they are on if known

julia
        (start_wall, start_point), (end_wall, end_point) =
+            if p1_in_cell
+                ((UNKNOWN, p1), inter1)
+            elseif p2_in_cell
+                (inter1, (UNKNOWN, p2))
+            else
+                i1_to_p1 = _squared_euclid_distance(T, inter1[2], p1)
+                i2_to_p1 = _squared_euclid_distance(T, inter2[2], p1)
+                i1_to_p1 < i2_to_p1 ? (inter1, inter2) : (inter2, inter1)
+            end

Add edge component

julia
        cov_area += _area_component(start_point, end_point)
+
+        if start_wall != UNKNOWN  # p1 out of cell
+            if unmatched_out_wall == UNKNOWN
+                unmatched_in_point = start_point
+                unmatched_in_wall = start_wall
+            else
+                check_point = find_point_on_cell(unmatched_out_point, start_point,
+                    unmatched_out_wall, start_wall,xmin, xmax, ymin, ymax)
+                if _point_filled_curve_orientation(check_point, ring; in = true, on = false, out = false, exact)
+                    cov_area += connect_edges(T, unmatched_out_point, start_point,
+                        unmatched_out_wall, start_wall,xmin, xmax, ymin, ymax)
+                else
+                    cov_area += connect_edges(T, unmatched_out_point, unmatched_in_point,
+                        unmatched_out_wall, unmatched_in_wall,xmin, xmax, ymin, ymax)
+                    unmatched_out_wall == UNKNOWN
+                end
+            end
+        end
+        if end_wall != UNKNOWN  # p2 out of cell
+            unmatched_out_wall, unmatched_out_point = end_wall, end_point
+        end
+        p1 = p2
+    end

if unmatched in-point at beginning, close polygon with last out point

julia
    if unmatched_in_wall != UNKNOWN
+        cov_area += connect_edges(T, unmatched_out_point, unmatched_in_point,
+            unmatched_out_wall, unmatched_in_wall,xmin, xmax, ymin, ymax)
+    end
+    cov_area = abs(cov_area) / 2

if grid cell is within polygon then the area is grid cell area

julia
    if cov_area == 0
+        if _point_filled_curve_orientation((xmin, ymin), ring; in = true, on = true, out = false, exact)
+            cov_area = abs((xmax - xmin) * (ymax - ymin))
+        end
+    end
+    return cov_area
+end

Returns true of the given point is within the bounding box determined by x and y values

julia
_point_in_cell(p, xmin, xmax, ymin, ymax) = xmin <= GI.x(p) <= xmax && ymin <= GI.y(p) <= ymax

Returns true if b is between a and c, exclusive of the maximum value, else false.

julia
_between(b, a, c) = a  b < c || c  b < a
+
+#= Determine intersections of the line from (x1, y1) to (x2, y2) with the bounding box
+defined by the minimum and maximum x/y values. Since we are dealing with a single line
+segment, we know that there is at maximum two intersection points.
+
+For each intersection point that we find, return the wall that it passes through, as well as
+the intersection point itself as a a tuple. If an intersection point isn't found, return the
+wall as UNKNOWN and the point as a pair of zeros. =#
+function _line_intersect_cell(::Type{T}, (x1, y1), (x2, y2), xmin, xmax, ymin, ymax) where T
+    Δx, Δy = x2 - x1, y2 - y1
+    inter1 = (UNKNOWN, (zero(T), zero(T)))
+    inter2 = inter1
+    if Δx == 0  # If line is vertical, only consider north and south
+        if xmin  x1  xmax
+            inter1 = _between(ymax, y1, y2) ? (NORTH, (x1, ymax)) : inter1
+            inter2 = _between(ymin, y1, y2) ? (SOUTH, (x1, ymin)) : inter2
+        end
+    elseif Δy == 0 # If line is horizontal, only consider east and west
+        if ymin  y1  ymax
+            inter1 = _between(xmax, x1, x2) ? (EAST, (xmax, y1)) : inter1
+            inter2 = _between(xmin, x1, x2) ? (WEST, (xmin, y1)) : inter2
+        end
+    else  # Line is tilted, must consider all edges, but only two can intersect
+        m = Δy / Δx
+        b = y1 - m * x1

Calculate and check potential intersections

julia
        xn = (ymax - b) / m
+        if xmin  xn  xmax && _between(xn, x1, x2) && _between(ymax, y1, y2)
+            inter1 = (NORTH, (xn, ymax))
+        end
+        xs = (ymin - b) / m
+        if xmin  xs  xmax && _between(xs, x1, x2) && _between(ymin, y1, y2)
+            new_intr = (SOUTH, (xs, ymin))
+            (inter1[1] == UNKNOWN) ? (inter1 = new_intr) : (inter2 = new_intr)
+        end
+        ye =  m * xmax + b
+        if ymin  ye  ymax && _between(ye, y1, y2) && _between(xmax, x1, x2)
+            new_intr = (EAST, (xmax, ye))
+            (inter1[1] == UNKNOWN) ? (inter1 = new_intr) : (inter2 = new_intr)
+        end
+        yw = m * xmin + b
+        if ymin  yw  ymax && _between(yw, y1, y2) && _between(xmin, x1, x2)
+            new_intr = (WEST, (xmin, yw))
+            (inter1[1] == UNKNOWN) ? (inter1 = new_intr) : (inter2 = new_intr)
+        end
+    end
+    if inter1[1] == UNKNOWN  # first intersection must be known, if one exists
+        inter1, inter2 = inter2, inter1
+    end
+    return inter1, inter2
+end

Finds point of cell edge between p1 and p2 given which walls they are on

julia
function find_point_on_cell(p1, p2, wall1, wall2, xmin, xmax, ymin, ymax)
+    x1, y1 = p1
+    x2, y2 = p2
+    mid_point = if wall1 == wall2 && _is_clockwise_from(p1, p2, wall1)
+        (x1 + x2) / 2, (y1 + y2) / 2
+    elseif wall1 == NORTH
+        (xmax, ymax)
+    elseif wall1 == EAST
+        (xmax, ymin)
+    elseif wall1 == SOUTH
+        (xmin, ymin)
+    else
+        (xmin, ymax)
+    end
+    return mid_point
+end
+
+#= Area component of shoelace formula coming from the distance between point 1 and point 2
+along grid cell walls in between the two points. =#
+function connect_edges(::Type{T}, p1, p2, wall1, wall2, xmin, xmax, ymin, ymax) where {T}
+    connect_area = zero(T)
+    if wall1 == wall2 && _is_clockwise_from(p1, p2, wall1)
+        connect_area += _area_component(p1, p2)
+    else

From the point to the corner of wall 1

julia
        connect_area += _partial_edge_out_area(p1, xmin, xmax, ymin, ymax, wall1)

Any intermediate walls (full length)

julia
        next_wall, last_wall = wall1 + 1, wall2 - 1
+        if wall2 > wall1
+            for wall in next_wall:last_wall
+                connect_area += _full_edge_area(xmin, xmax, ymin, ymax, wall)
+            end
+        else
+            for wall in Iterators.flatten((next_wall:WEST, NORTH:last_wall))
+                connect_area += _full_edge_area(xmin, xmax, ymin, ymax, wall)
+            end
+        end

From the corner of wall 2 to the point

julia
        connect_area += _partial_edge_in_area(p2, xmin, xmax, ymin, ymax, wall2)
+    end
+    return connect_area
+end

True if (x1, y1) is clockwise from (x2, y2) on the same wall

julia
_is_clockwise_from((x1, y1), (x2, y2), wall) = (wall == NORTH && x2 > x1) ||
+    (wall == EAST && y2 < y1) || (wall == SOUTH && x2 < x1) || (wall == WEST && y2 > y1)
+
+#= Returns the area component of a full edge of the bounding box defined by the min and max
+values and the wall. =#
+_full_edge_area(xmin, xmax, ymin, ymax, wall) = if wall == NORTH
+        ymax * (xmin - xmax)
+    elseif wall == EAST
+        xmax * (ymin - ymax)
+    elseif wall == SOUTH
+        ymin * (xmax - xmin)
+    else
+        xmin * (ymax - ymin)
+    end
+
+#= Returns the area component of part of one wall, from its "starting corner" (going
+clockwise) to the point (x2, y2). =#
+function _partial_edge_in_area((x2, y2), xmin, xmax, ymin, ymax, wall)
+    x_wall = (wall == NORTH || wall == WEST) ? xmin : xmax
+    y_wall = (wall == NORTH || wall == EAST) ? ymax : ymin
+    return x_wall * y2 - x2 * y_wall
+end
+
+#= Returns the area component of part of one wall, from the point (x1, y1) to its
+"ending corner" (going clockwise). =#
+function _partial_edge_out_area((x1, y1), xmin, xmax, ymin, ymax, wall)
+    x_wall = (wall == NORTH || wall == EAST) ? xmax : xmin
+    y_wall = (wall == NORTH || wall == WEST) ? ymax : ymin
+    return x1 * y_wall - x_wall * y1
+end

This page was generated using Literate.jl.

`,58)]))}const F=i(k,[["render",p]]);export{y as __pageData,F as default}; diff --git a/previews/PR237/assets/source_methods_clipping_cut.md.C35jjvPO.js b/previews/PR237/assets/source_methods_clipping_cut.md.C35jjvPO.js new file mode 100644 index 000000000..4edcb8370 --- /dev/null +++ b/previews/PR237/assets/source_methods_clipping_cut.md.C35jjvPO.js @@ -0,0 +1,87 @@ +import{_ as i,c as a,a5 as n,o as h}from"./chunks/framework.Cq8AuEls.js";const t="/GeometryOps.jl/previews/PR237/assets/hmidtfb.-VpeHhXX.png",y=JSON.parse('{"title":"Polygon cutting","description":"","frontmatter":{},"headers":[],"relativePath":"source/methods/clipping/cut.md","filePath":"source/methods/clipping/cut.md","lastUpdated":null}'),l={name:"source/methods/clipping/cut.md"};function p(k,s,e,r,E,d){return h(),a("div",null,s[0]||(s[0]=[n(`

Polygon cutting

julia
export cut

What is cut?

The cut function cuts a polygon through a line segment. This is inspired by functions such as Matlab's cutpolygon function.

To provide an example, consider the following polygon and line:

julia
import GeoInterface as GI, GeometryOps as GO
+using CairoMakie
+using Makie
+
+poly = GI.Polygon([[(0.0, 0.0), (10.0, 0.0), (10.0, 10.0), (0.0, 10.0), (0.0, 0.0)]])
+line = GI.Line([(5.0, -5.0), (5.0, 15.0)])
+cut_polys = GO.cut(poly, line)
+
+f, a, p1 = Makie.poly(collect(GI.getpoint(cut_polys[1])); color = (:blue, 0.5))
+Makie.poly!(collect(GI.getpoint(cut_polys[2])); color = (:orange, 0.5))
+Makie.lines!(GI.getpoint(line); color = :black)
+f

Implementation

This function depends on polygon clipping helper function and is inspired by the Greiner-Hormann clipping algorithm used elsewhere in this library. The inspiration came from this Stack Overflow discussion.

julia
"""
+    cut(geom, line, [T::Type])
+
+Return given geom cut by given line as a list of geometries of the same type as the input
+geom. Return the original geometry as only list element if none are found. Line must cut
+fully through given geometry or the original geometry will be returned.
+
+Note: This currently doesn't work for degenerate cases there line crosses through vertices.
+
+# Example
+
+\`\`\`jldoctest
+import GeoInterface as GI, GeometryOps as GO
+
+poly = GI.Polygon([[(0.0, 0.0), (10.0, 0.0), (10.0, 10.0), (0.0, 10.0), (0.0, 0.0)]])
+line = GI.Line([(5.0, -5.0), (5.0, 15.0)])
+cut_polys = GO.cut(poly, line)
+GI.coordinates.(cut_polys)

output

julia
2-element Vector{Vector{Vector{Vector{Float64}}}}:
+ [[[0.0, 0.0], [5.0, 0.0], [5.0, 10.0], [0.0, 10.0], [0.0, 0.0]]]
+ [[[5.0, 0.0], [10.0, 0.0], [10.0, 10.0], [5.0, 10.0], [5.0, 0.0]]]
+\`\`\`
+"""
+cut(geom, line, ::Type{T} = Float64) where {T <: AbstractFloat} =
+    _cut(T, GI.trait(geom), geom, GI.trait(line), line; exact = _True())
+
+#= Cut a given polygon by given line. Add polygon holes back into resulting pieces if there
+are any holes. =#
+function _cut(::Type{T}, ::GI.PolygonTrait, poly, ::GI.LineTrait, line; exact) where T
+    ext_poly = GI.getexterior(poly)
+    poly_list, intr_list = _build_a_list(T, ext_poly, line; exact)
+    n_intr_pts = length(intr_list)

If an impossible number of intersection points, return original polygon

julia
    if n_intr_pts < 2 || isodd(n_intr_pts)
+        return [tuples(poly)]
+    end

Cut polygon by line

julia
    cut_coords = _cut(T, ext_poly, line, poly_list, intr_list, n_intr_pts; exact)

Close coords and create polygons

julia
    for c in cut_coords
+        push!(c, c[1])
+    end
+    cut_polys = [GI.Polygon([c]) for c in cut_coords]

Add original polygon holes back in

julia
    remove_idx = falses(length(cut_polys))
+    _add_holes_to_polys!(T, cut_polys, GI.gethole(poly), remove_idx; exact)
+    return cut_polys
+end

Many types aren't implemented

julia
function _cut(::Type{T}, trait::GI.AbstractTrait, geom, line; kwargs...) where T
+    @assert(
+        false,
+        "Cutting of $trait isn't implemented yet.",
+    )
+    return nothing
+end
+
+#= Cutting algorithm inspired by Greiner and Hormann clipping algorithm. Returns coordinates
+of cut geometry in Vector{Vector{Tuple}} format.
+
+Note: degenerate cases where intersection points are vertices do not work right now. =#
+function _cut(::Type{T}, geom, line, geom_list, intr_list, n_intr_pts; exact) where T

Sort and categorize the intersection points

julia
    sort!(intr_list, by = x -> geom_list[x].fracs[2])
+    _flag_ent_exit!(GI.LineTrait(), line, geom_list; exact)

Add first point to output list

julia
    return_coords = [[geom_list[1].point]]
+    cross_backs = [(T(Inf),T(Inf))]
+    poly_idx = 1
+    n_polys = 1

Walk around original polygon to find split polygons

julia
    for (pt_idx, curr) in enumerate(geom_list)
+        if pt_idx > 1
+            push!(return_coords[poly_idx], curr.point)
+        end
+        if curr.inter

Find cross back point for current polygon

julia
            intr_idx = findfirst(x -> equals(curr.point, geom_list[x].point), intr_list)
+            cross_idx = intr_idx + (curr.ent_exit ? 1 : -1)
+            cross_idx = cross_idx < 1 ? n_intr_pts : cross_idx
+            cross_idx = cross_idx > n_intr_pts ? 1 : cross_idx
+            cross_backs[poly_idx] = geom_list[intr_list[cross_idx]].point

Check if current point is a cross back point

julia
            next_poly_idx = findfirst(x -> equals(x, curr.point), cross_backs)
+            if isnothing(next_poly_idx)
+                push!(return_coords, [curr.point])
+                push!(cross_backs, curr.point)
+                n_polys += 1
+                poly_idx = n_polys
+            else
+                push!(return_coords[next_poly_idx], curr.point)
+                poly_idx = next_poly_idx
+            end
+        end
+    end
+    return return_coords
+end

This page was generated using Literate.jl.

`,34)]))}const o=i(l,[["render",p]]);export{y as __pageData,o as default}; diff --git a/previews/PR237/assets/source_methods_clipping_cut.md.C35jjvPO.lean.js b/previews/PR237/assets/source_methods_clipping_cut.md.C35jjvPO.lean.js new file mode 100644 index 000000000..4edcb8370 --- /dev/null +++ b/previews/PR237/assets/source_methods_clipping_cut.md.C35jjvPO.lean.js @@ -0,0 +1,87 @@ +import{_ as i,c as a,a5 as n,o as h}from"./chunks/framework.Cq8AuEls.js";const t="/GeometryOps.jl/previews/PR237/assets/hmidtfb.-VpeHhXX.png",y=JSON.parse('{"title":"Polygon cutting","description":"","frontmatter":{},"headers":[],"relativePath":"source/methods/clipping/cut.md","filePath":"source/methods/clipping/cut.md","lastUpdated":null}'),l={name:"source/methods/clipping/cut.md"};function p(k,s,e,r,E,d){return h(),a("div",null,s[0]||(s[0]=[n(`

Polygon cutting

julia
export cut

What is cut?

The cut function cuts a polygon through a line segment. This is inspired by functions such as Matlab's cutpolygon function.

To provide an example, consider the following polygon and line:

julia
import GeoInterface as GI, GeometryOps as GO
+using CairoMakie
+using Makie
+
+poly = GI.Polygon([[(0.0, 0.0), (10.0, 0.0), (10.0, 10.0), (0.0, 10.0), (0.0, 0.0)]])
+line = GI.Line([(5.0, -5.0), (5.0, 15.0)])
+cut_polys = GO.cut(poly, line)
+
+f, a, p1 = Makie.poly(collect(GI.getpoint(cut_polys[1])); color = (:blue, 0.5))
+Makie.poly!(collect(GI.getpoint(cut_polys[2])); color = (:orange, 0.5))
+Makie.lines!(GI.getpoint(line); color = :black)
+f

Implementation

This function depends on polygon clipping helper function and is inspired by the Greiner-Hormann clipping algorithm used elsewhere in this library. The inspiration came from this Stack Overflow discussion.

julia
"""
+    cut(geom, line, [T::Type])
+
+Return given geom cut by given line as a list of geometries of the same type as the input
+geom. Return the original geometry as only list element if none are found. Line must cut
+fully through given geometry or the original geometry will be returned.
+
+Note: This currently doesn't work for degenerate cases there line crosses through vertices.
+
+# Example
+
+\`\`\`jldoctest
+import GeoInterface as GI, GeometryOps as GO
+
+poly = GI.Polygon([[(0.0, 0.0), (10.0, 0.0), (10.0, 10.0), (0.0, 10.0), (0.0, 0.0)]])
+line = GI.Line([(5.0, -5.0), (5.0, 15.0)])
+cut_polys = GO.cut(poly, line)
+GI.coordinates.(cut_polys)

output

julia
2-element Vector{Vector{Vector{Vector{Float64}}}}:
+ [[[0.0, 0.0], [5.0, 0.0], [5.0, 10.0], [0.0, 10.0], [0.0, 0.0]]]
+ [[[5.0, 0.0], [10.0, 0.0], [10.0, 10.0], [5.0, 10.0], [5.0, 0.0]]]
+\`\`\`
+"""
+cut(geom, line, ::Type{T} = Float64) where {T <: AbstractFloat} =
+    _cut(T, GI.trait(geom), geom, GI.trait(line), line; exact = _True())
+
+#= Cut a given polygon by given line. Add polygon holes back into resulting pieces if there
+are any holes. =#
+function _cut(::Type{T}, ::GI.PolygonTrait, poly, ::GI.LineTrait, line; exact) where T
+    ext_poly = GI.getexterior(poly)
+    poly_list, intr_list = _build_a_list(T, ext_poly, line; exact)
+    n_intr_pts = length(intr_list)

If an impossible number of intersection points, return original polygon

julia
    if n_intr_pts < 2 || isodd(n_intr_pts)
+        return [tuples(poly)]
+    end

Cut polygon by line

julia
    cut_coords = _cut(T, ext_poly, line, poly_list, intr_list, n_intr_pts; exact)

Close coords and create polygons

julia
    for c in cut_coords
+        push!(c, c[1])
+    end
+    cut_polys = [GI.Polygon([c]) for c in cut_coords]

Add original polygon holes back in

julia
    remove_idx = falses(length(cut_polys))
+    _add_holes_to_polys!(T, cut_polys, GI.gethole(poly), remove_idx; exact)
+    return cut_polys
+end

Many types aren't implemented

julia
function _cut(::Type{T}, trait::GI.AbstractTrait, geom, line; kwargs...) where T
+    @assert(
+        false,
+        "Cutting of $trait isn't implemented yet.",
+    )
+    return nothing
+end
+
+#= Cutting algorithm inspired by Greiner and Hormann clipping algorithm. Returns coordinates
+of cut geometry in Vector{Vector{Tuple}} format.
+
+Note: degenerate cases where intersection points are vertices do not work right now. =#
+function _cut(::Type{T}, geom, line, geom_list, intr_list, n_intr_pts; exact) where T

Sort and categorize the intersection points

julia
    sort!(intr_list, by = x -> geom_list[x].fracs[2])
+    _flag_ent_exit!(GI.LineTrait(), line, geom_list; exact)

Add first point to output list

julia
    return_coords = [[geom_list[1].point]]
+    cross_backs = [(T(Inf),T(Inf))]
+    poly_idx = 1
+    n_polys = 1

Walk around original polygon to find split polygons

julia
    for (pt_idx, curr) in enumerate(geom_list)
+        if pt_idx > 1
+            push!(return_coords[poly_idx], curr.point)
+        end
+        if curr.inter

Find cross back point for current polygon

julia
            intr_idx = findfirst(x -> equals(curr.point, geom_list[x].point), intr_list)
+            cross_idx = intr_idx + (curr.ent_exit ? 1 : -1)
+            cross_idx = cross_idx < 1 ? n_intr_pts : cross_idx
+            cross_idx = cross_idx > n_intr_pts ? 1 : cross_idx
+            cross_backs[poly_idx] = geom_list[intr_list[cross_idx]].point

Check if current point is a cross back point

julia
            next_poly_idx = findfirst(x -> equals(x, curr.point), cross_backs)
+            if isnothing(next_poly_idx)
+                push!(return_coords, [curr.point])
+                push!(cross_backs, curr.point)
+                n_polys += 1
+                poly_idx = n_polys
+            else
+                push!(return_coords[next_poly_idx], curr.point)
+                poly_idx = next_poly_idx
+            end
+        end
+    end
+    return return_coords
+end

This page was generated using Literate.jl.

`,34)]))}const o=i(l,[["render",p]]);export{y as __pageData,o as default}; diff --git a/previews/PR237/assets/source_methods_clipping_difference.md.DWZJEyKa.js b/previews/PR237/assets/source_methods_clipping_difference.md.DWZJEyKa.js new file mode 100644 index 000000000..45d3c9014 --- /dev/null +++ b/previews/PR237/assets/source_methods_clipping_difference.md.DWZJEyKa.js @@ -0,0 +1,166 @@ +import{_ as i,c as a,a5 as n,o as l}from"./chunks/framework.Cq8AuEls.js";const y=JSON.parse('{"title":"Difference Polygon Clipping","description":"","frontmatter":{},"headers":[],"relativePath":"source/methods/clipping/difference.md","filePath":"source/methods/clipping/difference.md","lastUpdated":null}'),p={name:"source/methods/clipping/difference.md"};function t(h,s,e,k,r,d){return l(),a("div",null,s[0]||(s[0]=[n(`

Difference Polygon Clipping

julia
export difference
+
+
+"""
+    difference(geom_a, geom_b, [T::Type]; target::Type, fix_multipoly = UnionIntersectingPolygons())
+
+Return the difference between two geometries as a list of geometries. Return an empty list
+if none are found. The type of the list will be constrained as much as possible given the
+input geometries. Furthermore, the user can provide a \`taget\` type as a keyword argument and
+a list of target geometries found in the difference will be returned. The user can also
+provide a float type that they would like the points of returned geometries to be. If the
+user is taking a intersection involving one or more multipolygons, and the multipolygon
+might be comprised of polygons that intersect, if \`fix_multipoly\` is set to an
+\`IntersectingPolygons\` correction (the default is \`UnionIntersectingPolygons()\`), then the
+needed multipolygons will be fixed to be valid before performing the intersection to ensure
+a correct answer. Only set \`fix_multipoly\` to false if you know that the multipolygons are
+valid, as it will avoid unneeded computation.
+
+# Example
+
+\`\`\`jldoctest
+import GeoInterface as GI, GeometryOps as GO
+
+poly1 = GI.Polygon([[[0.0, 0.0], [5.0, 5.0], [10.0, 0.0], [5.0, -5.0], [0.0, 0.0]]])
+poly2 = GI.Polygon([[[3.0, 0.0], [8.0, 5.0], [13.0, 0.0], [8.0, -5.0], [3.0, 0.0]]])
+diff_poly = GO.difference(poly1, poly2; target = GI.PolygonTrait())
+GI.coordinates.(diff_poly)

output

julia
1-element Vector{Vector{Vector{Vector{Float64}}}}:
+ [[[6.5, 3.5], [5.0, 5.0], [0.0, 0.0], [5.0, -5.0], [6.5, -3.5], [3.0, 0.0], [6.5, 3.5]]]
+\`\`\`
+"""
+function difference(
+    geom_a, geom_b, ::Type{T} = Float64; target=nothing, kwargs...,
+) where {T<:AbstractFloat}
+    return _difference(
+        TraitTarget(target), T, GI.trait(geom_a), geom_a, GI.trait(geom_b), geom_b;
+        exact = _True(), kwargs...,
+    )
+end
+
+#= The 'difference' function returns the difference of two polygons as a list of polygons.
+The algorithm to determine the difference was adapted from "Efficient clipping of efficient
+polygons," by Greiner and Hormann (1998). DOI: https://doi.org/10.1145/274363.274364 =#
+function _difference(
+    ::TraitTarget{GI.PolygonTrait}, ::Type{T},
+    ::GI.PolygonTrait, poly_a,
+    ::GI.PolygonTrait, poly_b;
+    exact, kwargs...
+) where T

Get the exterior of the polygons

julia
    ext_a = GI.getexterior(poly_a)
+    ext_b = GI.getexterior(poly_b)

Find the difference of the exterior of the polygons

julia
    a_list, b_list, a_idx_list = _build_ab_list(T, ext_a, ext_b, _diff_delay_cross_f, _diff_delay_bounce_f; exact)
+    polys = _trace_polynodes(T, a_list, b_list, a_idx_list, _diff_step, poly_a, poly_b)

if no crossing points, determine if either poly is inside of the other

julia
    if isempty(polys)
+        a_in_b, b_in_a = _find_non_cross_orientation(a_list, b_list, ext_a, ext_b; exact)

add case for if they polygons are the same (all intersection points!) add a find_first check to find first non-inter poly!

julia
        if b_in_a && !a_in_b  # b in a and can't be the same polygon
+            poly_a_b_hole = GI.Polygon([tuples(ext_a), tuples(ext_b)])
+            push!(polys, poly_a_b_hole)
+        elseif !b_in_a && !a_in_b # polygons don't intersect
+            push!(polys, tuples(poly_a))
+            return polys
+        end
+    end
+    remove_idx = falses(length(polys))

If the original polygons had holes, take that into account.

julia
    if GI.nhole(poly_a) != 0
+        _add_holes_to_polys!(T, polys, GI.gethole(poly_a), remove_idx; exact)
+    end
+    if GI.nhole(poly_b) != 0
+        for hole in GI.gethole(poly_b)
+            hole_poly = GI.Polygon(StaticArrays.SVector(hole))
+            new_polys = intersection(hole_poly, poly_a, T; target = GI.PolygonTrait)
+            if length(new_polys) > 0
+                append!(polys, new_polys)
+            end
+        end
+    end

Remove unneeded collinear points on same edge

julia
    _remove_collinear_points!(polys, remove_idx, poly_a, poly_b)
+    return polys
+end

Helper functions for Differences with Greiner and Hormann Polygon Clipping

julia
#= When marking the crossing status of a delayed crossing, the chain start point is crossing
+when the start point is a entry point and is a bouncing point when the start point is an
+exit point. The end of the chain has the opposite crossing / bouncing status. =#
+_diff_delay_cross_f(x) = (x, !x)
+#= When marking the crossing status of a delayed bouncing, the chain start and end points
+are crossing if the current polygon's adjacent edges are within the non-tracing polygon and
+we are tracing b_list or if the edges are outside and we are on a_list. Otherwise the
+endpoints are marked as crossing. x is a boolean representing if the edges are inside or
+outside of the polygon and y is a variable that is true if we are on a_list and false if we
+are on b_list. =#
+_diff_delay_bounce_f(x, y) = x  y
+#= When tracing polygons, step forwards if the most recent intersection point was an entry
+point and we are currently tracing b_list or if it was an exit point and we are currently
+tracing a_list, else step backwards, where x is the entry/exit status and y is a variable
+that is true if we are on a_list and false if we are on b_list. =#
+_diff_step(x, y) = (x  y) ? 1 : (-1)
+
+#= Polygon with multipolygon difference - note that all intersection regions between
+\`poly_a\` and any of the sub-polygons of \`multipoly_b\` are removed from \`poly_a\`. =#
+function _difference(
+    target::TraitTarget{GI.PolygonTrait}, ::Type{T},
+    ::GI.PolygonTrait, poly_a,
+    ::GI.MultiPolygonTrait, multipoly_b;
+    kwargs...,
+) where T
+    polys = [tuples(poly_a, T)]
+    for poly_b in GI.getpolygon(multipoly_b)
+        isempty(polys) && break
+        polys = mapreduce(p -> difference(p, poly_b; target), append!, polys)
+    end
+    return polys
+end
+
+#= Multipolygon with polygon difference - note that all intersection regions between
+sub-polygons of \`multipoly_a\` and \`poly_b\` will be removed from the corresponding
+sub-polygon. Unless specified with \`fix_multipoly = nothing\`, \`multipolygon_a\` will be
+validated using the given (default is \`UnionIntersectingPolygons()\`) correction. =#
+function _difference(
+    target::TraitTarget{GI.PolygonTrait}, ::Type{T},
+    ::GI.MultiPolygonTrait, multipoly_a,
+    ::GI.PolygonTrait, poly_b;
+    fix_multipoly = UnionIntersectingPolygons(), kwargs...,
+) where T
+    if !isnothing(fix_multipoly) # Fix multipoly_a to prevent returning an invalid multipolygon
+        multipoly_a = fix_multipoly(multipoly_a)
+    end
+    polys = Vector{_get_poly_type(T)}()
+    sizehint!(polys, GI.npolygon(multipoly_a))
+    for poly_a in GI.getpolygon(multipoly_a)
+        append!(polys, difference(poly_a, poly_b; target))
+    end
+    return polys
+end
+
+#= Multipolygon with multipolygon difference - note that all intersection regions between
+sub-polygons of \`multipoly_a\` and sub-polygons of \`multipoly_b\` will be removed from the
+corresponding sub-polygon of \`multipoly_a\`. Unless specified with \`fix_multipoly = nothing\`,
+\`multipolygon_a\` will be validated using the given (default is \`UnionIntersectingPolygons()\`)
+correction. =#
+function _difference(
+    target::TraitTarget{GI.PolygonTrait}, ::Type{T},
+    ::GI.MultiPolygonTrait, multipoly_a,
+    ::GI.MultiPolygonTrait, multipoly_b;
+    fix_multipoly = UnionIntersectingPolygons(), kwargs...,
+) where T
+    if !isnothing(fix_multipoly) # Fix multipoly_a to prevent returning an invalid multipolygon
+        multipoly_a = fix_multipoly(multipoly_a)
+        fix_multipoly = nothing
+    end
+    local polys
+    for (i, poly_b) in enumerate(GI.getpolygon(multipoly_b))
+        #= Removing intersections of \`multipoly_a\`\` with pieces of \`multipoly_b\`\` - as
+        pieces of \`multipolygon_a\`\` are removed, continue to take difference with new shape
+        \`polys\` =#
+        polys = if i == 1
+            difference(multipoly_a, poly_b; target, fix_multipoly)
+        else
+            difference(GI.MultiPolygon(polys), poly_b; target, fix_multipoly)
+        end
+        #= One multipoly_a has been completely covered (and thus removed) there is no need to
+        continue taking the difference =#
+        isempty(polys) && break
+    end
+    return polys
+end

Many type and target combos aren't implemented

julia
function _difference(
+    ::TraitTarget{Target}, ::Type{T},
+    trait_a::GI.AbstractTrait, geom_a,
+    trait_b::GI.AbstractTrait, geom_b,
+) where {Target, T}
+    @assert(
+        false,
+        "Difference between $trait_a and $trait_b with target $Target isn't implemented yet.",
+    )
+    return nothing
+end

This page was generated using Literate.jl.

`,22)]))}const E=i(p,[["render",t]]);export{y as __pageData,E as default}; diff --git a/previews/PR237/assets/source_methods_clipping_difference.md.DWZJEyKa.lean.js b/previews/PR237/assets/source_methods_clipping_difference.md.DWZJEyKa.lean.js new file mode 100644 index 000000000..45d3c9014 --- /dev/null +++ b/previews/PR237/assets/source_methods_clipping_difference.md.DWZJEyKa.lean.js @@ -0,0 +1,166 @@ +import{_ as i,c as a,a5 as n,o as l}from"./chunks/framework.Cq8AuEls.js";const y=JSON.parse('{"title":"Difference Polygon Clipping","description":"","frontmatter":{},"headers":[],"relativePath":"source/methods/clipping/difference.md","filePath":"source/methods/clipping/difference.md","lastUpdated":null}'),p={name:"source/methods/clipping/difference.md"};function t(h,s,e,k,r,d){return l(),a("div",null,s[0]||(s[0]=[n(`

Difference Polygon Clipping

julia
export difference
+
+
+"""
+    difference(geom_a, geom_b, [T::Type]; target::Type, fix_multipoly = UnionIntersectingPolygons())
+
+Return the difference between two geometries as a list of geometries. Return an empty list
+if none are found. The type of the list will be constrained as much as possible given the
+input geometries. Furthermore, the user can provide a \`taget\` type as a keyword argument and
+a list of target geometries found in the difference will be returned. The user can also
+provide a float type that they would like the points of returned geometries to be. If the
+user is taking a intersection involving one or more multipolygons, and the multipolygon
+might be comprised of polygons that intersect, if \`fix_multipoly\` is set to an
+\`IntersectingPolygons\` correction (the default is \`UnionIntersectingPolygons()\`), then the
+needed multipolygons will be fixed to be valid before performing the intersection to ensure
+a correct answer. Only set \`fix_multipoly\` to false if you know that the multipolygons are
+valid, as it will avoid unneeded computation.
+
+# Example
+
+\`\`\`jldoctest
+import GeoInterface as GI, GeometryOps as GO
+
+poly1 = GI.Polygon([[[0.0, 0.0], [5.0, 5.0], [10.0, 0.0], [5.0, -5.0], [0.0, 0.0]]])
+poly2 = GI.Polygon([[[3.0, 0.0], [8.0, 5.0], [13.0, 0.0], [8.0, -5.0], [3.0, 0.0]]])
+diff_poly = GO.difference(poly1, poly2; target = GI.PolygonTrait())
+GI.coordinates.(diff_poly)

output

julia
1-element Vector{Vector{Vector{Vector{Float64}}}}:
+ [[[6.5, 3.5], [5.0, 5.0], [0.0, 0.0], [5.0, -5.0], [6.5, -3.5], [3.0, 0.0], [6.5, 3.5]]]
+\`\`\`
+"""
+function difference(
+    geom_a, geom_b, ::Type{T} = Float64; target=nothing, kwargs...,
+) where {T<:AbstractFloat}
+    return _difference(
+        TraitTarget(target), T, GI.trait(geom_a), geom_a, GI.trait(geom_b), geom_b;
+        exact = _True(), kwargs...,
+    )
+end
+
+#= The 'difference' function returns the difference of two polygons as a list of polygons.
+The algorithm to determine the difference was adapted from "Efficient clipping of efficient
+polygons," by Greiner and Hormann (1998). DOI: https://doi.org/10.1145/274363.274364 =#
+function _difference(
+    ::TraitTarget{GI.PolygonTrait}, ::Type{T},
+    ::GI.PolygonTrait, poly_a,
+    ::GI.PolygonTrait, poly_b;
+    exact, kwargs...
+) where T

Get the exterior of the polygons

julia
    ext_a = GI.getexterior(poly_a)
+    ext_b = GI.getexterior(poly_b)

Find the difference of the exterior of the polygons

julia
    a_list, b_list, a_idx_list = _build_ab_list(T, ext_a, ext_b, _diff_delay_cross_f, _diff_delay_bounce_f; exact)
+    polys = _trace_polynodes(T, a_list, b_list, a_idx_list, _diff_step, poly_a, poly_b)

if no crossing points, determine if either poly is inside of the other

julia
    if isempty(polys)
+        a_in_b, b_in_a = _find_non_cross_orientation(a_list, b_list, ext_a, ext_b; exact)

add case for if they polygons are the same (all intersection points!) add a find_first check to find first non-inter poly!

julia
        if b_in_a && !a_in_b  # b in a and can't be the same polygon
+            poly_a_b_hole = GI.Polygon([tuples(ext_a), tuples(ext_b)])
+            push!(polys, poly_a_b_hole)
+        elseif !b_in_a && !a_in_b # polygons don't intersect
+            push!(polys, tuples(poly_a))
+            return polys
+        end
+    end
+    remove_idx = falses(length(polys))

If the original polygons had holes, take that into account.

julia
    if GI.nhole(poly_a) != 0
+        _add_holes_to_polys!(T, polys, GI.gethole(poly_a), remove_idx; exact)
+    end
+    if GI.nhole(poly_b) != 0
+        for hole in GI.gethole(poly_b)
+            hole_poly = GI.Polygon(StaticArrays.SVector(hole))
+            new_polys = intersection(hole_poly, poly_a, T; target = GI.PolygonTrait)
+            if length(new_polys) > 0
+                append!(polys, new_polys)
+            end
+        end
+    end

Remove unneeded collinear points on same edge

julia
    _remove_collinear_points!(polys, remove_idx, poly_a, poly_b)
+    return polys
+end

Helper functions for Differences with Greiner and Hormann Polygon Clipping

julia
#= When marking the crossing status of a delayed crossing, the chain start point is crossing
+when the start point is a entry point and is a bouncing point when the start point is an
+exit point. The end of the chain has the opposite crossing / bouncing status. =#
+_diff_delay_cross_f(x) = (x, !x)
+#= When marking the crossing status of a delayed bouncing, the chain start and end points
+are crossing if the current polygon's adjacent edges are within the non-tracing polygon and
+we are tracing b_list or if the edges are outside and we are on a_list. Otherwise the
+endpoints are marked as crossing. x is a boolean representing if the edges are inside or
+outside of the polygon and y is a variable that is true if we are on a_list and false if we
+are on b_list. =#
+_diff_delay_bounce_f(x, y) = x  y
+#= When tracing polygons, step forwards if the most recent intersection point was an entry
+point and we are currently tracing b_list or if it was an exit point and we are currently
+tracing a_list, else step backwards, where x is the entry/exit status and y is a variable
+that is true if we are on a_list and false if we are on b_list. =#
+_diff_step(x, y) = (x  y) ? 1 : (-1)
+
+#= Polygon with multipolygon difference - note that all intersection regions between
+\`poly_a\` and any of the sub-polygons of \`multipoly_b\` are removed from \`poly_a\`. =#
+function _difference(
+    target::TraitTarget{GI.PolygonTrait}, ::Type{T},
+    ::GI.PolygonTrait, poly_a,
+    ::GI.MultiPolygonTrait, multipoly_b;
+    kwargs...,
+) where T
+    polys = [tuples(poly_a, T)]
+    for poly_b in GI.getpolygon(multipoly_b)
+        isempty(polys) && break
+        polys = mapreduce(p -> difference(p, poly_b; target), append!, polys)
+    end
+    return polys
+end
+
+#= Multipolygon with polygon difference - note that all intersection regions between
+sub-polygons of \`multipoly_a\` and \`poly_b\` will be removed from the corresponding
+sub-polygon. Unless specified with \`fix_multipoly = nothing\`, \`multipolygon_a\` will be
+validated using the given (default is \`UnionIntersectingPolygons()\`) correction. =#
+function _difference(
+    target::TraitTarget{GI.PolygonTrait}, ::Type{T},
+    ::GI.MultiPolygonTrait, multipoly_a,
+    ::GI.PolygonTrait, poly_b;
+    fix_multipoly = UnionIntersectingPolygons(), kwargs...,
+) where T
+    if !isnothing(fix_multipoly) # Fix multipoly_a to prevent returning an invalid multipolygon
+        multipoly_a = fix_multipoly(multipoly_a)
+    end
+    polys = Vector{_get_poly_type(T)}()
+    sizehint!(polys, GI.npolygon(multipoly_a))
+    for poly_a in GI.getpolygon(multipoly_a)
+        append!(polys, difference(poly_a, poly_b; target))
+    end
+    return polys
+end
+
+#= Multipolygon with multipolygon difference - note that all intersection regions between
+sub-polygons of \`multipoly_a\` and sub-polygons of \`multipoly_b\` will be removed from the
+corresponding sub-polygon of \`multipoly_a\`. Unless specified with \`fix_multipoly = nothing\`,
+\`multipolygon_a\` will be validated using the given (default is \`UnionIntersectingPolygons()\`)
+correction. =#
+function _difference(
+    target::TraitTarget{GI.PolygonTrait}, ::Type{T},
+    ::GI.MultiPolygonTrait, multipoly_a,
+    ::GI.MultiPolygonTrait, multipoly_b;
+    fix_multipoly = UnionIntersectingPolygons(), kwargs...,
+) where T
+    if !isnothing(fix_multipoly) # Fix multipoly_a to prevent returning an invalid multipolygon
+        multipoly_a = fix_multipoly(multipoly_a)
+        fix_multipoly = nothing
+    end
+    local polys
+    for (i, poly_b) in enumerate(GI.getpolygon(multipoly_b))
+        #= Removing intersections of \`multipoly_a\`\` with pieces of \`multipoly_b\`\` - as
+        pieces of \`multipolygon_a\`\` are removed, continue to take difference with new shape
+        \`polys\` =#
+        polys = if i == 1
+            difference(multipoly_a, poly_b; target, fix_multipoly)
+        else
+            difference(GI.MultiPolygon(polys), poly_b; target, fix_multipoly)
+        end
+        #= One multipoly_a has been completely covered (and thus removed) there is no need to
+        continue taking the difference =#
+        isempty(polys) && break
+    end
+    return polys
+end

Many type and target combos aren't implemented

julia
function _difference(
+    ::TraitTarget{Target}, ::Type{T},
+    trait_a::GI.AbstractTrait, geom_a,
+    trait_b::GI.AbstractTrait, geom_b,
+) where {Target, T}
+    @assert(
+        false,
+        "Difference between $trait_a and $trait_b with target $Target isn't implemented yet.",
+    )
+    return nothing
+end

This page was generated using Literate.jl.

`,22)]))}const E=i(p,[["render",t]]);export{y as __pageData,E as default}; diff --git a/previews/PR237/assets/source_methods_clipping_intersection.md.CyyVQZLK.js b/previews/PR237/assets/source_methods_clipping_intersection.md.CyyVQZLK.js new file mode 100644 index 000000000..3df30b450 --- /dev/null +++ b/previews/PR237/assets/source_methods_clipping_intersection.md.CyyVQZLK.js @@ -0,0 +1,383 @@ +import{_ as i,c as a,a5 as n,o as t}from"./chunks/framework.Cq8AuEls.js";const g=JSON.parse('{"title":"Geometry Intersection","description":"","frontmatter":{},"headers":[],"relativePath":"source/methods/clipping/intersection.md","filePath":"source/methods/clipping/intersection.md","lastUpdated":null}'),h={name:"source/methods/clipping/intersection.md"};function l(p,s,k,e,r,E){return t(),a("div",null,s[0]||(s[0]=[n(`

Geometry Intersection

julia
export intersection, intersection_points
+
+"""
+    Enum LineOrientation
+Enum for the orientation of a line with respect to a curve. A line can be
+\`line_cross\` (crossing over the curve), \`line_hinge\` (crossing the endpoint of the curve),
+\`line_over\` (collinear with the curve), or \`line_out\` (not interacting with the curve).
+"""
+@enum LineOrientation line_cross=1 line_hinge=2 line_over=3 line_out=4
+
+"""
+    intersection(geom_a, geom_b, [T::Type]; target::Type, fix_multipoly = UnionIntersectingPolygons())
+
+Return the intersection between two geometries as a list of geometries. Return an empty list
+if none are found. The type of the list will be constrained as much as possible given the
+input geometries. Furthermore, the user can provide a \`target\` type as a keyword argument and
+a list of target geometries found in the intersection will be returned. The user can also
+provide a float type that they would like the points of returned geometries to be. If the
+user is taking a intersection involving one or more multipolygons, and the multipolygon
+might be comprised of polygons that intersect, if \`fix_multipoly\` is set to an
+\`IntersectingPolygons\` correction (the default is \`UnionIntersectingPolygons()\`), then the
+needed multipolygons will be fixed to be valid before performing the intersection to ensure
+a correct answer. Only set \`fix_multipoly\` to nothing if you know that the multipolygons are
+valid, as it will avoid unneeded computation.
+
+# Example
+
+\`\`\`jldoctest
+import GeoInterface as GI, GeometryOps as GO
+
+line1 = GI.Line([(124.584961,-12.768946), (126.738281,-17.224758)])
+line2 = GI.Line([(123.354492,-15.961329), (127.22168,-14.008696)])
+inter_points = GO.intersection(line1, line2; target = GI.PointTrait())
+GI.coordinates.(inter_points)

output

julia
1-element Vector{Vector{Float64}}:
+ [125.58375366067548, -14.83572303404496]
+\`\`\`
+"""
+function intersection(
+    geom_a, geom_b, ::Type{T}=Float64; target=nothing, kwargs...,
+) where {T<:AbstractFloat}
+    return _intersection(
+        TraitTarget(target), T, GI.trait(geom_a), geom_a, GI.trait(geom_b), geom_b;
+        exact = _True(), kwargs...,
+    )
+end

Curve-Curve Intersections with target Point

julia
_intersection(
+    ::TraitTarget{GI.PointTrait}, ::Type{T},
+    trait_a::Union{GI.LineTrait, GI.LineStringTrait, GI.LinearRingTrait}, geom_a,
+    trait_b::Union{GI.LineTrait, GI.LineStringTrait, GI.LinearRingTrait}, geom_b;
+    kwargs...,
+) where T = _intersection_points(T, trait_a, geom_a, trait_b, geom_b)
+
+#= Polygon-Polygon Intersections with target Polygon
+The algorithm to determine the intersection was adapted from "Efficient clipping
+of efficient polygons," by Greiner and Hormann (1998).
+DOI: https://doi.org/10.1145/274363.274364 =#
+function _intersection(
+    ::TraitTarget{GI.PolygonTrait}, ::Type{T},
+    ::GI.PolygonTrait, poly_a,
+    ::GI.PolygonTrait, poly_b;
+    exact, kwargs...,
+) where {T}

First we get the exteriors of 'poly_a' and 'poly_b'

julia
    ext_a = GI.getexterior(poly_a)
+    ext_b = GI.getexterior(poly_b)

Then we find the intersection of the exteriors

julia
    a_list, b_list, a_idx_list = _build_ab_list(T, ext_a, ext_b, _inter_delay_cross_f, _inter_delay_bounce_f; exact)
+    polys = _trace_polynodes(T, a_list, b_list, a_idx_list, _inter_step, poly_a, poly_b)
+    if isempty(polys) # no crossing points, determine if either poly is inside the other
+        a_in_b, b_in_a = _find_non_cross_orientation(a_list, b_list, ext_a, ext_b; exact)
+        if a_in_b
+            push!(polys, GI.Polygon([tuples(ext_a)]))
+        elseif b_in_a
+            push!(polys, GI.Polygon([tuples(ext_b)]))
+        end
+    end
+    remove_idx = falses(length(polys))

If the original polygons had holes, take that into account.

julia
    if GI.nhole(poly_a) != 0 || GI.nhole(poly_b) != 0
+        hole_iterator = Iterators.flatten((GI.gethole(poly_a), GI.gethole(poly_b)))
+        _add_holes_to_polys!(T, polys, hole_iterator, remove_idx; exact)
+    end

Remove unneeded collinear points on same edge

julia
    _remove_collinear_points!(polys, remove_idx, poly_a, poly_b)
+    return polys
+end

Helper functions for Intersections with Greiner and Hormann Polygon Clipping

julia
#= When marking the crossing status of a delayed crossing, the chain start point is bouncing
+when the start point is a entry point and is a crossing point when the start point is an
+exit point. The end of the chain has the opposite crossing / bouncing status. x is the
+entry/exit status. =#
+_inter_delay_cross_f(x) = (!x, x)
+#= When marking the crossing status of a delayed bouncing, the chain start and end points
+are crossing if the current polygon's adjacent edges are within the non-tracing polygon. If
+the edges are outside then the chain endpoints are marked as bouncing. x is a boolean
+representing if the edges are inside or outside of the polygon. =#
+_inter_delay_bounce_f(x, _) = x
+#= When tracing polygons, step forward if the most recent intersection point was an entry
+point, else step backwards where x is the entry/exit status. =#
+_inter_step(x, _) =  x ? 1 : (-1)
+
+#= Polygon with multipolygon intersection - note that all intersection regions between
+\`poly_a\` and any of the sub-polygons of \`multipoly_b\` are counted as intersection polygons.
+Unless specified with \`fix_multipoly = nothing\`, \`multipolygon_b\` will be validated using
+the given (default is \`UnionIntersectingPolygons()\`) correction. =#
+function _intersection(
+    target::TraitTarget{GI.PolygonTrait}, ::Type{T},
+    ::GI.PolygonTrait, poly_a,
+    ::GI.MultiPolygonTrait, multipoly_b;
+    fix_multipoly = UnionIntersectingPolygons(), kwargs...,
+) where T
+    if !isnothing(fix_multipoly) # Fix multipoly_b to prevent duplicated intersection regions
+        multipoly_b = fix_multipoly(multipoly_b)
+    end
+    polys = Vector{_get_poly_type(T)}()
+    for poly_b in GI.getpolygon(multipoly_b)
+        append!(polys, intersection(poly_a, poly_b; target))
+    end
+    return polys
+end
+
+#= Multipolygon with polygon intersection is equivalent to taking the intersection of the
+polygon with the multipolygon and thus simply switches the order of operations and calls the
+above method. =#
+_intersection(
+    target::TraitTarget{GI.PolygonTrait}, ::Type{T},
+    ::GI.MultiPolygonTrait, multipoly_a,
+    ::GI.PolygonTrait, poly_b;
+    kwargs...,
+) where T = intersection(poly_b, multipoly_a; target , kwargs...)
+
+#= Multipolygon with multipolygon intersection - note that all intersection regions between
+any sub-polygons of \`multipoly_a\` and any of the sub-polygons of \`multipoly_b\` are counted
+as intersection polygons. Unless specified with \`fix_multipoly = nothing\`, both
+\`multipolygon_a\` and \`multipolygon_b\` will be validated using the given (default is
+\`UnionIntersectingPolygons()\`) correction. =#
+function _intersection(
+    target::TraitTarget{GI.PolygonTrait}, ::Type{T},
+    ::GI.MultiPolygonTrait, multipoly_a,
+    ::GI.MultiPolygonTrait, multipoly_b;
+    fix_multipoly = UnionIntersectingPolygons(), kwargs...,
+) where T
+    if !isnothing(fix_multipoly) # Fix both multipolygons to prevent duplicated regions
+        multipoly_a = fix_multipoly(multipoly_a)
+        multipoly_b = fix_multipoly(multipoly_b)
+        fix_multipoly = nothing
+    end
+    polys = Vector{_get_poly_type(T)}()
+    for poly_a in GI.getpolygon(multipoly_a)
+        append!(polys, intersection(poly_a, multipoly_b; target, fix_multipoly))
+    end
+    return polys
+end

Many type and target combos aren't implemented

julia
function _intersection(
+    ::TraitTarget{Target}, ::Type{T},
+    trait_a::GI.AbstractTrait, geom_a,
+    trait_b::GI.AbstractTrait, geom_b;
+    kwargs...,
+) where {Target, T}
+    @assert(
+        false,
+        "Intersection between $trait_a and $trait_b with target $Target isn't implemented yet.",
+    )
+    return nothing
+end
+
+"""
+    intersection_points(geom_a, geom_b, [T::Type])
+
+Return a list of intersection tuple points between two geometries. If no intersection points
+exist, returns an empty list.
+
+# Example
+
+\`\`\`jldoctest
+import GeoInterface as GI, GeometryOps as GO
+
+line1 = GI.Line([(124.584961,-12.768946), (126.738281,-17.224758)])
+line2 = GI.Line([(123.354492,-15.961329), (127.22168,-14.008696)])
+inter_points = GO.intersection_points(line1, line2)

output

julia
1-element Vector{Tuple{Float64, Float64}}:
+ (125.58375366067548, -14.83572303404496)
+"""
+intersection_points(geom_a, geom_b, ::Type{T} = Float64) where T <: AbstractFloat =
+    _intersection_points(T, GI.trait(geom_a), geom_a, GI.trait(geom_b), geom_b)
+
+
+#= Calculates the list of intersection points between two geometries, including line
+segments, line strings, linear rings, polygons, and multipolygons. =#
+function _intersection_points(::Type{T}, ::GI.AbstractTrait, a, ::GI.AbstractTrait, b; exact = _True()) where T

Initialize an empty list of points

julia
    result = Tuple{T, T}[]

Check if the geometries extents even overlap

julia
    Extents.intersects(GI.extent(a), GI.extent(b)) || return result

Create a list of edges from the two input geometries

julia
    edges_a, edges_b = map(sort!  to_edges, (a, b))

Loop over pairs of edges and add any unique intersection points to results

julia
    for a_edge in edges_a, b_edge in edges_b
+        line_orient, intr1, intr2 = _intersection_point(T, a_edge, b_edge; exact)
+        line_orient == line_out && continue  # no intersection points
+        pt1, _ = intr1
+        push!(result, pt1)  # if not line_out, there is at least one intersection point
+        if line_orient == line_over # if line_over, there are two intersection points
+            pt2, _ = intr2
+            push!(result, pt2)
+        end
+    end
+    #= TODO: We might be able to just add unique points with checks on the α and β values
+    returned from \`_intersection_point\`, but this would be different for curves vs polygons
+    vs multipolygons depending on if the shape is closed. This then wouldn't allow using the
+    \`to_edges\` functionality.  =#
+    unique!(sort!(result))
+    return result
+end
+
+#= Calculates the intersection points between two lines if they exists and the fractional
+component of each line from the initial end point to the intersection point where α is the
+fraction along (a1, a2) and β is the fraction along (b1, b2).
+
+Note that the first return is the type of intersection (line_cross, line_hinge, line_over,
+or line_out). The type of intersection determines how many intersection points there are.
+If the intersection is line_out, then there are no intersection points and the two
+intersections aren't valid and shouldn't be used. If the intersection is line_cross or
+line_hinge then the lines meet at one point and the first intersection is valid, while the
+second isn't. Finally, if the intersection is line_over, then both points are valid and they
+are the two points that define the endpoints of the overlapping region between the two
+lines.
+
+Also note again that each intersection is a tuple of two tuples. The first is the
+intersection point (x,y) while the second is the ratio along the initial lines (α, β) for
+that point.
+
+Calculation derivation can be found here: https://stackoverflow.com/questions/563198/ =#
+function _intersection_point(::Type{T}, (a1, a2)::Edge, (b1, b2)::Edge; exact) where T

Default answer for no intersection

julia
    line_orient = line_out
+    intr1 = ((zero(T), zero(T)), (zero(T), zero(T)))
+    intr2 = intr1
+    no_intr_result = (line_orient, intr1, intr2)

Seperate out line segment points

julia
    (a1x, a1y), (a2x, a2y) = _tuple_point(a1, T), _tuple_point(a2, T)
+    (b1x, b1y), (b2x, b2y) = _tuple_point(b1, T), _tuple_point(b2, T)

Check if envelopes of lines intersect

julia
    a_ext = Extent(X = minmax(a1x, a2x), Y = minmax(a1y, a2y))
+    b_ext = Extent(X = minmax(b1x, b2x), Y = minmax(b1y, b2y))
+    !Extents.intersects(a_ext, b_ext) && return no_intr_result

Check orientation of two line segments with respect to one another

julia
    a1_orient = Predicates.orient(b1, b2, a1; exact)
+    a2_orient = Predicates.orient(b1, b2, a2; exact)
+    a1_orient != 0 && a1_orient == a2_orient && return no_intr_result  # α < 0 or α > 1
+    b1_orient = Predicates.orient(a1, a2, b1; exact)
+    b2_orient = Predicates.orient(a1, a2, b2; exact)
+    b1_orient != 0 && b1_orient == b2_orient && return no_intr_result  # β < 0 or β > 1

Determine intersection type and intersection point(s)

julia
    if a1_orient == a2_orient == b1_orient == b2_orient == 0

Intersection is collinear if all endpoints lie on the same line

julia
        line_orient, intr1, intr2 = _find_collinear_intersection(T, a1, a2, b1, b2, a_ext, b_ext, no_intr_result)
+    elseif a1_orient == 0 || a2_orient == 0 || b1_orient == 0 || b2_orient == 0

Intersection is a hinge if the intersection point is an endpoint

julia
        line_orient = line_hinge
+        intr1 = _find_hinge_intersection(T, a1, a2, b1, b2, a1_orient, a2_orient, b1_orient)
+    else

Intersection is a cross if there is only one non-endpoint intersection point

julia
        line_orient = line_cross
+        intr1 = _find_cross_intersection(T, a1, a2, b1, b2, a_ext, b_ext)
+    end
+    return line_orient, intr1, intr2
+end
+
+#= If lines defined by (a1, a2) and (b1, b2) are collinear, find endpoints of overlapping
+region if they exist. This could result in three possibilities. First, there could be no
+overlapping region, in which case, the default 'no_intr_result' intersection information is
+returned. Second, the two regions could just meet at one shared endpoint, in which case it
+is a hinge intersection with one intersection point. Otherwise, it is a overlapping
+intersection defined by two of the endpoints of the line segments. =#
+function _find_collinear_intersection(::Type{T}, a1, a2, b1, b2, a_ext, b_ext, no_intr_result) where T

Define default return for no intersection points

julia
    line_orient, intr1, intr2 = no_intr_result

Determine collinear line overlaps

julia
    a1_in_b = _point_in_extent(a1, b_ext)
+    a2_in_b = _point_in_extent(a2, b_ext)
+    b1_in_a = _point_in_extent(b1, a_ext)
+    b2_in_a = _point_in_extent(b2, a_ext)

Determine line distances

julia
    a_dist, b_dist = distance(a1, a2, T), distance(b1, b2, T)

Set collinear intersection points if they exist

julia
    if a1_in_b && a2_in_b      # 1st vertex of a and 2nd vertex of a form overlap
+        line_orient = line_over
+        β1 = _clamped_frac(distance(a1, b1, T), b_dist)
+        β2 = _clamped_frac(distance(a2, b1, T), b_dist)
+        intr1 = (_tuple_point(a1, T), (zero(T), β1))
+        intr2 = (_tuple_point(a2, T), (one(T), β2))
+    elseif b1_in_a && b2_in_a  # 1st vertex of b and 2nd vertex of b form overlap
+        line_orient = line_over
+        α1 = _clamped_frac(distance(b1, a1, T), a_dist)
+        α2 = _clamped_frac(distance(b2, a1, T), a_dist)
+        intr1 = (_tuple_point(b1, T), (α1, zero(T)))
+        intr2 = (_tuple_point(b2, T), (α2, one(T)))
+    elseif a1_in_b && b1_in_a  # 1st vertex of a and 1st vertex of b form overlap
+        if equals(a1, b1)
+            line_orient = line_hinge
+            intr1 = (_tuple_point(a1, T), (zero(T), zero(T)))
+        else
+            line_orient = line_over
+            intr1, intr2 = _set_ab_collinear_intrs(T, a1, b1, zero(T), zero(T), a1, b1, a_dist, b_dist)
+        end
+    elseif a1_in_b && b2_in_a  # 1st vertex of a and 2nd vertex of b form overlap
+        if equals(a1, b2)
+            line_orient = line_hinge
+            intr1 = (_tuple_point(a1, T), (zero(T), one(T)))
+        else
+            line_orient = line_over
+            intr1, intr2 = _set_ab_collinear_intrs(T, a1, b2, zero(T), one(T), a1, b1, a_dist, b_dist)
+        end
+    elseif a2_in_b && b1_in_a  # 2nd vertex of a and 1st vertex of b form overlap
+        if equals(a2, b1)
+            line_orient = line_hinge
+            intr1 = (_tuple_point(a2, T), (one(T), zero(T)))
+        else
+            line_orient = line_over
+            intr1, intr2 = _set_ab_collinear_intrs(T, a2, b1, one(T), zero(T), a1, b1, a_dist, b_dist)
+        end
+    elseif a2_in_b && b2_in_a  # 2nd vertex of a and 2nd vertex of b form overlap
+        if equals(a2, b2)
+            line_orient = line_hinge
+            intr1 = (_tuple_point(a2, T), (one(T), one(T)))
+        else
+            line_orient = line_over
+            intr1, intr2 = _set_ab_collinear_intrs(T, a2, b2, one(T), one(T), a1, b1, a_dist, b_dist)
+        end
+    end
+    return line_orient, intr1, intr2
+end
+
+#= Determine intersection points and segment fractions when overlap is made up one one
+endpoint of segment (a1, a2) and one endpoint of segment (b1, b2). =#
+_set_ab_collinear_intrs(::Type{T}, a_pt, b_pt, a_pt_α, b_pt_β, a1, b1, a_dist, b_dist) where T =
+    (
+        (_tuple_point(a_pt, T), (a_pt_α, _clamped_frac(distance(a_pt, b1, T), b_dist))),
+        (_tuple_point(b_pt, T), (_clamped_frac(distance(b_pt, a1, T), a_dist), b_pt_β))
+    )
+
+#= If lines defined by (a1, a2) and (b1, b2) are just touching at one of those endpoints and
+are not collinear, then they form a hinge, with just that one shared intersection point.
+Point equality is checked before segment orientation to have maximal accurary on fractions
+to avoid floating point errors. If the points are not equal, we know that the hinge does not
+take place at an endpoint and the fractions must be between 0 or 1 (exclusive). =#
+function _find_hinge_intersection(::Type{T}, a1, a2, b1, b2, a1_orient, a2_orient, b1_orient) where T
+    pt, α, β = if equals(a1, b1)
+        _tuple_point(a1, T), zero(T), zero(T)
+    elseif equals(a1, b2)
+        _tuple_point(a1, T), zero(T), one(T)
+    elseif equals(a2, b1)
+        _tuple_point(a2, T), one(T), zero(T)
+    elseif equals(a2, b2)
+        _tuple_point(a2, T), one(T), one(T)
+    elseif a1_orient == 0
+        β_val = _clamped_frac(distance(b1, a1, T), distance(b1, b2, T), eps(T))
+        _tuple_point(a1, T), zero(T), β_val
+    elseif a2_orient == 0
+        β_val = _clamped_frac(distance(b1, a2, T), distance(b1, b2, T), eps(T))
+        _tuple_point(a2, T), one(T), β_val
+    elseif b1_orient == 0
+        α_val = _clamped_frac(distance(a1, b1, T), distance(a1, a2, T), eps(T))
+        _tuple_point(b1, T), α_val, zero(T)
+    else  # b2_orient == 0
+        α_val = _clamped_frac(distance(a1, b2, T), distance(a1, a2, T), eps(T))
+        _tuple_point(b2, T), α_val, one(T)
+    end
+    return pt, (α, β)
+end
+
+#= If lines defined by (a1, a2) and (b1, b2) meet at one point that is not an endpoint of
+either segment, they form a crossing intersection with a singular intersection point. That
+point is calculated by finding the fractional distance along each segment the point occurs
+at (α, β). If the point is too close to an endpoint to be distinct, the point shares a value
+with the endpoint, but with a non-zero and non-one fractional value. If the intersection
+point calculated is outside of the envelope of the two segments due to floating point error,
+it is set to the endpoint of the two segments that is closest to the other segment.
+Regardless of point value, we know that it does not actually occur at an endpoint so the
+fractions must be between 0 or 1 (exclusive). =#
+function _find_cross_intersection(::Type{T}, a1, a2, b1, b2, a_ext, b_ext) where T

First line runs from a to a + Δa

julia
    (a1x, a1y), (a2x, a2y) = _tuple_point(a1, T), _tuple_point(a2, T)
+    Δax, Δay = a2x - a1x, a2y - a1y

Second line runs from b to b + Δb

julia
    (b1x, b1y), (b2x, b2y) = _tuple_point(b1, T), _tuple_point(b2, T)
+    Δbx, Δby = b2x - b1x, b2y - b1y

Differences between starting points

julia
    Δbax = b1x - a1x
+    Δbay = b1y - a1y
+    a_cross_b = Δax * Δby - Δay * Δbx

Determine α value where 0 < α < 1 and β value where 0 < β < 1

julia
    α = _clamped_frac(Δbax * Δby - Δbay * Δbx, a_cross_b, eps(T))
+    β = _clamped_frac(Δbax * Δay - Δbay * Δax, a_cross_b, eps(T))
+
+    #= Intersection will be where a1 + α * Δa = b1 + β * Δb. However, due to floating point
+    inaccuracies, α and β calculations may yield different intersection points. Average
+    both points together to minimize difference from real value, as long as segment isn't
+    vertical or horizontal as this will almost certainly lead to the point being outside the
+    envelope due to floating point error. Also note that floating point limitations could
+    make intersection be endpoint if α≈0 or α≈1.=#
+    x = if Δax == 0
+        a1x
+    elseif Δbx == 0
+        b1x
+    else
+        (a1x + α * Δax + b1x + β * Δbx) / 2
+    end
+    y = if Δay == 0
+        a1y
+    elseif Δby == 0
+        b1y
+    else
+        (a1y + α * Δay + b1y + β * Δby) / 2
+    end
+    pt = (x, y)

Check if point is within segment envelopes and adjust to endpoint if not

julia
    if !_point_in_extent(pt, a_ext) || !_point_in_extent(pt, b_ext)
+        pt, α, β = _nearest_endpoint(T, a1, a2, b1, b2)
+    end
+    return (pt, (α, β))
+end

Find endpoint of either segment that is closest to the opposite segment

julia
function _nearest_endpoint(::Type{T}, a1, a2, b1, b2) where T

Create lines from segments and calculate segment length

julia
    a_line, a_dist = GI.Line(StaticArrays.SVector(a1, a2)), distance(a1, a2, T)
+    b_line, b_dist = GI.Line(StaticArrays.SVector(b1, b2)), distance(b1, b2, T)

Determine distance from a1 to segment b

julia
    min_pt, min_dist = a1, distance(a1, b_line, T)
+    α, β = eps(T), _clamped_frac(distance(min_pt, b1, T), b_dist, eps(T))

Determine distance from a2 to segment b

julia
    dist = distance(a2, b_line, T)
+    if dist < min_dist
+        min_pt, min_dist = a2, dist
+        α, β = one(T) - eps(T), _clamped_frac(distance(min_pt, b1, T), b_dist, eps(T))
+    end

Determine distance from b1 to segment a

julia
    dist = distance(b1, a_line, T)
+    if dist < min_dist
+        min_pt, min_dist = b1, dist
+        α, β = _clamped_frac(distance(min_pt, a1, T), a_dist, eps(T)), eps(T)
+    end

Determine distance from b2 to segment a

julia
    dist = distance(b2, a_line, T)
+    if dist < min_dist
+        min_pt, min_dist = b2, dist
+        α, β = _clamped_frac(distance(min_pt, a2, T), a_dist, eps(T)), one(T) - eps(T)
+    end

Return point with smallest distance

julia
    return _tuple_point(min_pt, T), α, β
+end

Return value of x/y clamped between ϵ and 1 - ϵ

julia
_clamped_frac(x::T, y::T, ϵ = zero(T)) where T = clamp(x / y, ϵ, one(T) - ϵ)

This page was generated using Literate.jl.

`,80)]))}const y=i(h,[["render",l]]);export{g as __pageData,y as default}; diff --git a/previews/PR237/assets/source_methods_clipping_intersection.md.CyyVQZLK.lean.js b/previews/PR237/assets/source_methods_clipping_intersection.md.CyyVQZLK.lean.js new file mode 100644 index 000000000..3df30b450 --- /dev/null +++ b/previews/PR237/assets/source_methods_clipping_intersection.md.CyyVQZLK.lean.js @@ -0,0 +1,383 @@ +import{_ as i,c as a,a5 as n,o as t}from"./chunks/framework.Cq8AuEls.js";const g=JSON.parse('{"title":"Geometry Intersection","description":"","frontmatter":{},"headers":[],"relativePath":"source/methods/clipping/intersection.md","filePath":"source/methods/clipping/intersection.md","lastUpdated":null}'),h={name:"source/methods/clipping/intersection.md"};function l(p,s,k,e,r,E){return t(),a("div",null,s[0]||(s[0]=[n(`

Geometry Intersection

julia
export intersection, intersection_points
+
+"""
+    Enum LineOrientation
+Enum for the orientation of a line with respect to a curve. A line can be
+\`line_cross\` (crossing over the curve), \`line_hinge\` (crossing the endpoint of the curve),
+\`line_over\` (collinear with the curve), or \`line_out\` (not interacting with the curve).
+"""
+@enum LineOrientation line_cross=1 line_hinge=2 line_over=3 line_out=4
+
+"""
+    intersection(geom_a, geom_b, [T::Type]; target::Type, fix_multipoly = UnionIntersectingPolygons())
+
+Return the intersection between two geometries as a list of geometries. Return an empty list
+if none are found. The type of the list will be constrained as much as possible given the
+input geometries. Furthermore, the user can provide a \`target\` type as a keyword argument and
+a list of target geometries found in the intersection will be returned. The user can also
+provide a float type that they would like the points of returned geometries to be. If the
+user is taking a intersection involving one or more multipolygons, and the multipolygon
+might be comprised of polygons that intersect, if \`fix_multipoly\` is set to an
+\`IntersectingPolygons\` correction (the default is \`UnionIntersectingPolygons()\`), then the
+needed multipolygons will be fixed to be valid before performing the intersection to ensure
+a correct answer. Only set \`fix_multipoly\` to nothing if you know that the multipolygons are
+valid, as it will avoid unneeded computation.
+
+# Example
+
+\`\`\`jldoctest
+import GeoInterface as GI, GeometryOps as GO
+
+line1 = GI.Line([(124.584961,-12.768946), (126.738281,-17.224758)])
+line2 = GI.Line([(123.354492,-15.961329), (127.22168,-14.008696)])
+inter_points = GO.intersection(line1, line2; target = GI.PointTrait())
+GI.coordinates.(inter_points)

output

julia
1-element Vector{Vector{Float64}}:
+ [125.58375366067548, -14.83572303404496]
+\`\`\`
+"""
+function intersection(
+    geom_a, geom_b, ::Type{T}=Float64; target=nothing, kwargs...,
+) where {T<:AbstractFloat}
+    return _intersection(
+        TraitTarget(target), T, GI.trait(geom_a), geom_a, GI.trait(geom_b), geom_b;
+        exact = _True(), kwargs...,
+    )
+end

Curve-Curve Intersections with target Point

julia
_intersection(
+    ::TraitTarget{GI.PointTrait}, ::Type{T},
+    trait_a::Union{GI.LineTrait, GI.LineStringTrait, GI.LinearRingTrait}, geom_a,
+    trait_b::Union{GI.LineTrait, GI.LineStringTrait, GI.LinearRingTrait}, geom_b;
+    kwargs...,
+) where T = _intersection_points(T, trait_a, geom_a, trait_b, geom_b)
+
+#= Polygon-Polygon Intersections with target Polygon
+The algorithm to determine the intersection was adapted from "Efficient clipping
+of efficient polygons," by Greiner and Hormann (1998).
+DOI: https://doi.org/10.1145/274363.274364 =#
+function _intersection(
+    ::TraitTarget{GI.PolygonTrait}, ::Type{T},
+    ::GI.PolygonTrait, poly_a,
+    ::GI.PolygonTrait, poly_b;
+    exact, kwargs...,
+) where {T}

First we get the exteriors of 'poly_a' and 'poly_b'

julia
    ext_a = GI.getexterior(poly_a)
+    ext_b = GI.getexterior(poly_b)

Then we find the intersection of the exteriors

julia
    a_list, b_list, a_idx_list = _build_ab_list(T, ext_a, ext_b, _inter_delay_cross_f, _inter_delay_bounce_f; exact)
+    polys = _trace_polynodes(T, a_list, b_list, a_idx_list, _inter_step, poly_a, poly_b)
+    if isempty(polys) # no crossing points, determine if either poly is inside the other
+        a_in_b, b_in_a = _find_non_cross_orientation(a_list, b_list, ext_a, ext_b; exact)
+        if a_in_b
+            push!(polys, GI.Polygon([tuples(ext_a)]))
+        elseif b_in_a
+            push!(polys, GI.Polygon([tuples(ext_b)]))
+        end
+    end
+    remove_idx = falses(length(polys))

If the original polygons had holes, take that into account.

julia
    if GI.nhole(poly_a) != 0 || GI.nhole(poly_b) != 0
+        hole_iterator = Iterators.flatten((GI.gethole(poly_a), GI.gethole(poly_b)))
+        _add_holes_to_polys!(T, polys, hole_iterator, remove_idx; exact)
+    end

Remove unneeded collinear points on same edge

julia
    _remove_collinear_points!(polys, remove_idx, poly_a, poly_b)
+    return polys
+end

Helper functions for Intersections with Greiner and Hormann Polygon Clipping

julia
#= When marking the crossing status of a delayed crossing, the chain start point is bouncing
+when the start point is a entry point and is a crossing point when the start point is an
+exit point. The end of the chain has the opposite crossing / bouncing status. x is the
+entry/exit status. =#
+_inter_delay_cross_f(x) = (!x, x)
+#= When marking the crossing status of a delayed bouncing, the chain start and end points
+are crossing if the current polygon's adjacent edges are within the non-tracing polygon. If
+the edges are outside then the chain endpoints are marked as bouncing. x is a boolean
+representing if the edges are inside or outside of the polygon. =#
+_inter_delay_bounce_f(x, _) = x
+#= When tracing polygons, step forward if the most recent intersection point was an entry
+point, else step backwards where x is the entry/exit status. =#
+_inter_step(x, _) =  x ? 1 : (-1)
+
+#= Polygon with multipolygon intersection - note that all intersection regions between
+\`poly_a\` and any of the sub-polygons of \`multipoly_b\` are counted as intersection polygons.
+Unless specified with \`fix_multipoly = nothing\`, \`multipolygon_b\` will be validated using
+the given (default is \`UnionIntersectingPolygons()\`) correction. =#
+function _intersection(
+    target::TraitTarget{GI.PolygonTrait}, ::Type{T},
+    ::GI.PolygonTrait, poly_a,
+    ::GI.MultiPolygonTrait, multipoly_b;
+    fix_multipoly = UnionIntersectingPolygons(), kwargs...,
+) where T
+    if !isnothing(fix_multipoly) # Fix multipoly_b to prevent duplicated intersection regions
+        multipoly_b = fix_multipoly(multipoly_b)
+    end
+    polys = Vector{_get_poly_type(T)}()
+    for poly_b in GI.getpolygon(multipoly_b)
+        append!(polys, intersection(poly_a, poly_b; target))
+    end
+    return polys
+end
+
+#= Multipolygon with polygon intersection is equivalent to taking the intersection of the
+polygon with the multipolygon and thus simply switches the order of operations and calls the
+above method. =#
+_intersection(
+    target::TraitTarget{GI.PolygonTrait}, ::Type{T},
+    ::GI.MultiPolygonTrait, multipoly_a,
+    ::GI.PolygonTrait, poly_b;
+    kwargs...,
+) where T = intersection(poly_b, multipoly_a; target , kwargs...)
+
+#= Multipolygon with multipolygon intersection - note that all intersection regions between
+any sub-polygons of \`multipoly_a\` and any of the sub-polygons of \`multipoly_b\` are counted
+as intersection polygons. Unless specified with \`fix_multipoly = nothing\`, both
+\`multipolygon_a\` and \`multipolygon_b\` will be validated using the given (default is
+\`UnionIntersectingPolygons()\`) correction. =#
+function _intersection(
+    target::TraitTarget{GI.PolygonTrait}, ::Type{T},
+    ::GI.MultiPolygonTrait, multipoly_a,
+    ::GI.MultiPolygonTrait, multipoly_b;
+    fix_multipoly = UnionIntersectingPolygons(), kwargs...,
+) where T
+    if !isnothing(fix_multipoly) # Fix both multipolygons to prevent duplicated regions
+        multipoly_a = fix_multipoly(multipoly_a)
+        multipoly_b = fix_multipoly(multipoly_b)
+        fix_multipoly = nothing
+    end
+    polys = Vector{_get_poly_type(T)}()
+    for poly_a in GI.getpolygon(multipoly_a)
+        append!(polys, intersection(poly_a, multipoly_b; target, fix_multipoly))
+    end
+    return polys
+end

Many type and target combos aren't implemented

julia
function _intersection(
+    ::TraitTarget{Target}, ::Type{T},
+    trait_a::GI.AbstractTrait, geom_a,
+    trait_b::GI.AbstractTrait, geom_b;
+    kwargs...,
+) where {Target, T}
+    @assert(
+        false,
+        "Intersection between $trait_a and $trait_b with target $Target isn't implemented yet.",
+    )
+    return nothing
+end
+
+"""
+    intersection_points(geom_a, geom_b, [T::Type])
+
+Return a list of intersection tuple points between two geometries. If no intersection points
+exist, returns an empty list.
+
+# Example
+
+\`\`\`jldoctest
+import GeoInterface as GI, GeometryOps as GO
+
+line1 = GI.Line([(124.584961,-12.768946), (126.738281,-17.224758)])
+line2 = GI.Line([(123.354492,-15.961329), (127.22168,-14.008696)])
+inter_points = GO.intersection_points(line1, line2)

output

julia
1-element Vector{Tuple{Float64, Float64}}:
+ (125.58375366067548, -14.83572303404496)
+"""
+intersection_points(geom_a, geom_b, ::Type{T} = Float64) where T <: AbstractFloat =
+    _intersection_points(T, GI.trait(geom_a), geom_a, GI.trait(geom_b), geom_b)
+
+
+#= Calculates the list of intersection points between two geometries, including line
+segments, line strings, linear rings, polygons, and multipolygons. =#
+function _intersection_points(::Type{T}, ::GI.AbstractTrait, a, ::GI.AbstractTrait, b; exact = _True()) where T

Initialize an empty list of points

julia
    result = Tuple{T, T}[]

Check if the geometries extents even overlap

julia
    Extents.intersects(GI.extent(a), GI.extent(b)) || return result

Create a list of edges from the two input geometries

julia
    edges_a, edges_b = map(sort!  to_edges, (a, b))

Loop over pairs of edges and add any unique intersection points to results

julia
    for a_edge in edges_a, b_edge in edges_b
+        line_orient, intr1, intr2 = _intersection_point(T, a_edge, b_edge; exact)
+        line_orient == line_out && continue  # no intersection points
+        pt1, _ = intr1
+        push!(result, pt1)  # if not line_out, there is at least one intersection point
+        if line_orient == line_over # if line_over, there are two intersection points
+            pt2, _ = intr2
+            push!(result, pt2)
+        end
+    end
+    #= TODO: We might be able to just add unique points with checks on the α and β values
+    returned from \`_intersection_point\`, but this would be different for curves vs polygons
+    vs multipolygons depending on if the shape is closed. This then wouldn't allow using the
+    \`to_edges\` functionality.  =#
+    unique!(sort!(result))
+    return result
+end
+
+#= Calculates the intersection points between two lines if they exists and the fractional
+component of each line from the initial end point to the intersection point where α is the
+fraction along (a1, a2) and β is the fraction along (b1, b2).
+
+Note that the first return is the type of intersection (line_cross, line_hinge, line_over,
+or line_out). The type of intersection determines how many intersection points there are.
+If the intersection is line_out, then there are no intersection points and the two
+intersections aren't valid and shouldn't be used. If the intersection is line_cross or
+line_hinge then the lines meet at one point and the first intersection is valid, while the
+second isn't. Finally, if the intersection is line_over, then both points are valid and they
+are the two points that define the endpoints of the overlapping region between the two
+lines.
+
+Also note again that each intersection is a tuple of two tuples. The first is the
+intersection point (x,y) while the second is the ratio along the initial lines (α, β) for
+that point.
+
+Calculation derivation can be found here: https://stackoverflow.com/questions/563198/ =#
+function _intersection_point(::Type{T}, (a1, a2)::Edge, (b1, b2)::Edge; exact) where T

Default answer for no intersection

julia
    line_orient = line_out
+    intr1 = ((zero(T), zero(T)), (zero(T), zero(T)))
+    intr2 = intr1
+    no_intr_result = (line_orient, intr1, intr2)

Seperate out line segment points

julia
    (a1x, a1y), (a2x, a2y) = _tuple_point(a1, T), _tuple_point(a2, T)
+    (b1x, b1y), (b2x, b2y) = _tuple_point(b1, T), _tuple_point(b2, T)

Check if envelopes of lines intersect

julia
    a_ext = Extent(X = minmax(a1x, a2x), Y = minmax(a1y, a2y))
+    b_ext = Extent(X = minmax(b1x, b2x), Y = minmax(b1y, b2y))
+    !Extents.intersects(a_ext, b_ext) && return no_intr_result

Check orientation of two line segments with respect to one another

julia
    a1_orient = Predicates.orient(b1, b2, a1; exact)
+    a2_orient = Predicates.orient(b1, b2, a2; exact)
+    a1_orient != 0 && a1_orient == a2_orient && return no_intr_result  # α < 0 or α > 1
+    b1_orient = Predicates.orient(a1, a2, b1; exact)
+    b2_orient = Predicates.orient(a1, a2, b2; exact)
+    b1_orient != 0 && b1_orient == b2_orient && return no_intr_result  # β < 0 or β > 1

Determine intersection type and intersection point(s)

julia
    if a1_orient == a2_orient == b1_orient == b2_orient == 0

Intersection is collinear if all endpoints lie on the same line

julia
        line_orient, intr1, intr2 = _find_collinear_intersection(T, a1, a2, b1, b2, a_ext, b_ext, no_intr_result)
+    elseif a1_orient == 0 || a2_orient == 0 || b1_orient == 0 || b2_orient == 0

Intersection is a hinge if the intersection point is an endpoint

julia
        line_orient = line_hinge
+        intr1 = _find_hinge_intersection(T, a1, a2, b1, b2, a1_orient, a2_orient, b1_orient)
+    else

Intersection is a cross if there is only one non-endpoint intersection point

julia
        line_orient = line_cross
+        intr1 = _find_cross_intersection(T, a1, a2, b1, b2, a_ext, b_ext)
+    end
+    return line_orient, intr1, intr2
+end
+
+#= If lines defined by (a1, a2) and (b1, b2) are collinear, find endpoints of overlapping
+region if they exist. This could result in three possibilities. First, there could be no
+overlapping region, in which case, the default 'no_intr_result' intersection information is
+returned. Second, the two regions could just meet at one shared endpoint, in which case it
+is a hinge intersection with one intersection point. Otherwise, it is a overlapping
+intersection defined by two of the endpoints of the line segments. =#
+function _find_collinear_intersection(::Type{T}, a1, a2, b1, b2, a_ext, b_ext, no_intr_result) where T

Define default return for no intersection points

julia
    line_orient, intr1, intr2 = no_intr_result

Determine collinear line overlaps

julia
    a1_in_b = _point_in_extent(a1, b_ext)
+    a2_in_b = _point_in_extent(a2, b_ext)
+    b1_in_a = _point_in_extent(b1, a_ext)
+    b2_in_a = _point_in_extent(b2, a_ext)

Determine line distances

julia
    a_dist, b_dist = distance(a1, a2, T), distance(b1, b2, T)

Set collinear intersection points if they exist

julia
    if a1_in_b && a2_in_b      # 1st vertex of a and 2nd vertex of a form overlap
+        line_orient = line_over
+        β1 = _clamped_frac(distance(a1, b1, T), b_dist)
+        β2 = _clamped_frac(distance(a2, b1, T), b_dist)
+        intr1 = (_tuple_point(a1, T), (zero(T), β1))
+        intr2 = (_tuple_point(a2, T), (one(T), β2))
+    elseif b1_in_a && b2_in_a  # 1st vertex of b and 2nd vertex of b form overlap
+        line_orient = line_over
+        α1 = _clamped_frac(distance(b1, a1, T), a_dist)
+        α2 = _clamped_frac(distance(b2, a1, T), a_dist)
+        intr1 = (_tuple_point(b1, T), (α1, zero(T)))
+        intr2 = (_tuple_point(b2, T), (α2, one(T)))
+    elseif a1_in_b && b1_in_a  # 1st vertex of a and 1st vertex of b form overlap
+        if equals(a1, b1)
+            line_orient = line_hinge
+            intr1 = (_tuple_point(a1, T), (zero(T), zero(T)))
+        else
+            line_orient = line_over
+            intr1, intr2 = _set_ab_collinear_intrs(T, a1, b1, zero(T), zero(T), a1, b1, a_dist, b_dist)
+        end
+    elseif a1_in_b && b2_in_a  # 1st vertex of a and 2nd vertex of b form overlap
+        if equals(a1, b2)
+            line_orient = line_hinge
+            intr1 = (_tuple_point(a1, T), (zero(T), one(T)))
+        else
+            line_orient = line_over
+            intr1, intr2 = _set_ab_collinear_intrs(T, a1, b2, zero(T), one(T), a1, b1, a_dist, b_dist)
+        end
+    elseif a2_in_b && b1_in_a  # 2nd vertex of a and 1st vertex of b form overlap
+        if equals(a2, b1)
+            line_orient = line_hinge
+            intr1 = (_tuple_point(a2, T), (one(T), zero(T)))
+        else
+            line_orient = line_over
+            intr1, intr2 = _set_ab_collinear_intrs(T, a2, b1, one(T), zero(T), a1, b1, a_dist, b_dist)
+        end
+    elseif a2_in_b && b2_in_a  # 2nd vertex of a and 2nd vertex of b form overlap
+        if equals(a2, b2)
+            line_orient = line_hinge
+            intr1 = (_tuple_point(a2, T), (one(T), one(T)))
+        else
+            line_orient = line_over
+            intr1, intr2 = _set_ab_collinear_intrs(T, a2, b2, one(T), one(T), a1, b1, a_dist, b_dist)
+        end
+    end
+    return line_orient, intr1, intr2
+end
+
+#= Determine intersection points and segment fractions when overlap is made up one one
+endpoint of segment (a1, a2) and one endpoint of segment (b1, b2). =#
+_set_ab_collinear_intrs(::Type{T}, a_pt, b_pt, a_pt_α, b_pt_β, a1, b1, a_dist, b_dist) where T =
+    (
+        (_tuple_point(a_pt, T), (a_pt_α, _clamped_frac(distance(a_pt, b1, T), b_dist))),
+        (_tuple_point(b_pt, T), (_clamped_frac(distance(b_pt, a1, T), a_dist), b_pt_β))
+    )
+
+#= If lines defined by (a1, a2) and (b1, b2) are just touching at one of those endpoints and
+are not collinear, then they form a hinge, with just that one shared intersection point.
+Point equality is checked before segment orientation to have maximal accurary on fractions
+to avoid floating point errors. If the points are not equal, we know that the hinge does not
+take place at an endpoint and the fractions must be between 0 or 1 (exclusive). =#
+function _find_hinge_intersection(::Type{T}, a1, a2, b1, b2, a1_orient, a2_orient, b1_orient) where T
+    pt, α, β = if equals(a1, b1)
+        _tuple_point(a1, T), zero(T), zero(T)
+    elseif equals(a1, b2)
+        _tuple_point(a1, T), zero(T), one(T)
+    elseif equals(a2, b1)
+        _tuple_point(a2, T), one(T), zero(T)
+    elseif equals(a2, b2)
+        _tuple_point(a2, T), one(T), one(T)
+    elseif a1_orient == 0
+        β_val = _clamped_frac(distance(b1, a1, T), distance(b1, b2, T), eps(T))
+        _tuple_point(a1, T), zero(T), β_val
+    elseif a2_orient == 0
+        β_val = _clamped_frac(distance(b1, a2, T), distance(b1, b2, T), eps(T))
+        _tuple_point(a2, T), one(T), β_val
+    elseif b1_orient == 0
+        α_val = _clamped_frac(distance(a1, b1, T), distance(a1, a2, T), eps(T))
+        _tuple_point(b1, T), α_val, zero(T)
+    else  # b2_orient == 0
+        α_val = _clamped_frac(distance(a1, b2, T), distance(a1, a2, T), eps(T))
+        _tuple_point(b2, T), α_val, one(T)
+    end
+    return pt, (α, β)
+end
+
+#= If lines defined by (a1, a2) and (b1, b2) meet at one point that is not an endpoint of
+either segment, they form a crossing intersection with a singular intersection point. That
+point is calculated by finding the fractional distance along each segment the point occurs
+at (α, β). If the point is too close to an endpoint to be distinct, the point shares a value
+with the endpoint, but with a non-zero and non-one fractional value. If the intersection
+point calculated is outside of the envelope of the two segments due to floating point error,
+it is set to the endpoint of the two segments that is closest to the other segment.
+Regardless of point value, we know that it does not actually occur at an endpoint so the
+fractions must be between 0 or 1 (exclusive). =#
+function _find_cross_intersection(::Type{T}, a1, a2, b1, b2, a_ext, b_ext) where T

First line runs from a to a + Δa

julia
    (a1x, a1y), (a2x, a2y) = _tuple_point(a1, T), _tuple_point(a2, T)
+    Δax, Δay = a2x - a1x, a2y - a1y

Second line runs from b to b + Δb

julia
    (b1x, b1y), (b2x, b2y) = _tuple_point(b1, T), _tuple_point(b2, T)
+    Δbx, Δby = b2x - b1x, b2y - b1y

Differences between starting points

julia
    Δbax = b1x - a1x
+    Δbay = b1y - a1y
+    a_cross_b = Δax * Δby - Δay * Δbx

Determine α value where 0 < α < 1 and β value where 0 < β < 1

julia
    α = _clamped_frac(Δbax * Δby - Δbay * Δbx, a_cross_b, eps(T))
+    β = _clamped_frac(Δbax * Δay - Δbay * Δax, a_cross_b, eps(T))
+
+    #= Intersection will be where a1 + α * Δa = b1 + β * Δb. However, due to floating point
+    inaccuracies, α and β calculations may yield different intersection points. Average
+    both points together to minimize difference from real value, as long as segment isn't
+    vertical or horizontal as this will almost certainly lead to the point being outside the
+    envelope due to floating point error. Also note that floating point limitations could
+    make intersection be endpoint if α≈0 or α≈1.=#
+    x = if Δax == 0
+        a1x
+    elseif Δbx == 0
+        b1x
+    else
+        (a1x + α * Δax + b1x + β * Δbx) / 2
+    end
+    y = if Δay == 0
+        a1y
+    elseif Δby == 0
+        b1y
+    else
+        (a1y + α * Δay + b1y + β * Δby) / 2
+    end
+    pt = (x, y)

Check if point is within segment envelopes and adjust to endpoint if not

julia
    if !_point_in_extent(pt, a_ext) || !_point_in_extent(pt, b_ext)
+        pt, α, β = _nearest_endpoint(T, a1, a2, b1, b2)
+    end
+    return (pt, (α, β))
+end

Find endpoint of either segment that is closest to the opposite segment

julia
function _nearest_endpoint(::Type{T}, a1, a2, b1, b2) where T

Create lines from segments and calculate segment length

julia
    a_line, a_dist = GI.Line(StaticArrays.SVector(a1, a2)), distance(a1, a2, T)
+    b_line, b_dist = GI.Line(StaticArrays.SVector(b1, b2)), distance(b1, b2, T)

Determine distance from a1 to segment b

julia
    min_pt, min_dist = a1, distance(a1, b_line, T)
+    α, β = eps(T), _clamped_frac(distance(min_pt, b1, T), b_dist, eps(T))

Determine distance from a2 to segment b

julia
    dist = distance(a2, b_line, T)
+    if dist < min_dist
+        min_pt, min_dist = a2, dist
+        α, β = one(T) - eps(T), _clamped_frac(distance(min_pt, b1, T), b_dist, eps(T))
+    end

Determine distance from b1 to segment a

julia
    dist = distance(b1, a_line, T)
+    if dist < min_dist
+        min_pt, min_dist = b1, dist
+        α, β = _clamped_frac(distance(min_pt, a1, T), a_dist, eps(T)), eps(T)
+    end

Determine distance from b2 to segment a

julia
    dist = distance(b2, a_line, T)
+    if dist < min_dist
+        min_pt, min_dist = b2, dist
+        α, β = _clamped_frac(distance(min_pt, a2, T), a_dist, eps(T)), one(T) - eps(T)
+    end

Return point with smallest distance

julia
    return _tuple_point(min_pt, T), α, β
+end

Return value of x/y clamped between ϵ and 1 - ϵ

julia
_clamped_frac(x::T, y::T, ϵ = zero(T)) where T = clamp(x / y, ϵ, one(T) - ϵ)

This page was generated using Literate.jl.

`,80)]))}const y=i(h,[["render",l]]);export{g as __pageData,y as default}; diff --git a/previews/PR237/assets/source_methods_clipping_predicates.md.Dyq9YrPd.js b/previews/PR237/assets/source_methods_clipping_predicates.md.Dyq9YrPd.js new file mode 100644 index 000000000..ae23f32fc --- /dev/null +++ b/previews/PR237/assets/source_methods_clipping_predicates.md.Dyq9YrPd.js @@ -0,0 +1,44 @@ +import{_ as i,c as a,a5 as n,o as t}from"./chunks/framework.Cq8AuEls.js";const c=JSON.parse('{"title":"If we want to inject adaptivity, we would do something like:","description":"","frontmatter":{},"headers":[],"relativePath":"source/methods/clipping/predicates.md","filePath":"source/methods/clipping/predicates.md","lastUpdated":null}'),h={name:"source/methods/clipping/predicates.md"};function e(p,s,l,k,r,d){return t(),a("div",null,s[0]||(s[0]=[n(`
julia
module Predicates
+    using ExactPredicates, ExactPredicates.Codegen
+    import ExactPredicates: ext
+    import ExactPredicates.Codegen: group!, @genpredicate
+    import GeometryOps: _False, _True, _booltype, _tuple_point
+    import GeoInterface as GI
+
+    #= Determine the orientation of c with regards to the oriented segment (a, b).
+    Return 1 if c is to the left of (a, b).
+    Return -1 if c is to the right of (a, b).
+    Return 0 if c is on (a, b) or if a == b. =#
+    orient(a, b, c; exact) = _orient(_booltype(exact), a, b, c)

If exact is true, use ExactPredicates to calculate the orientation.

julia
    _orient(::_True, a, b, c) = ExactPredicates.orient(_tuple_point(a, Float64), _tuple_point(b, Float64), _tuple_point(c, Float64))

If exact is false, calculate the orientation without using ExactPredicates.

julia
    function _orient(exact::_False, a, b, c)
+        a = a .- c
+        b = b .- c
+        return _cross(exact, a, b)
+    end
+
+    #= Determine the sign of the cross product of a and b.
+    Return 1 if the cross product is positive.
+    Return -1 if the cross product is negative.
+    Return 0 if the cross product is 0. =#
+    cross(a, b; exact) = _cross(_booltype(exact), a, b)
+
+    #= If \`exact\` is \`true\`, use exact cross product calculation created using
+    \`ExactPredicates\`generated predicate. Note that as of now \`ExactPredicates\` requires
+    Float64 so we must convert points a and b. =#
+    _cross(::_True, a, b) = _cross_exact(_tuple_point(a, Float64), _tuple_point(b, Float64))

Exact cross product calculation using ExactPredicates.

julia
    @genpredicate function _cross_exact(a :: 2, b :: 2)
+        group!(a...)
+        group!(b...)
+        ext(a, b)
+    end

If exact is false, calculate the cross product without using ExactPredicates.

julia
    function _cross(::_False, a, b)
+        c_t1 = GI.x(a) * GI.y(b)
+        c_t2 = GI.y(a) * GI.x(b)
+        c_val = if isapprox(c_t1, c_t2)
+            0
+        else
+            sign(c_t1 - c_t2)
+        end
+        return c_val
+    end
+
+end
+
+import .Predicates

If we want to inject adaptivity, we would do something like:

function cross(a, b, c) # try Predicates._cross_naive(a, b, c) # check the error bound there # then try Predicates._cross_adaptive(a, b, c) # then try Predicates._cross_exact end


This page was generated using Literate.jl.

`,13)]))}const g=i(h,[["render",e]]);export{c as __pageData,g as default}; diff --git a/previews/PR237/assets/source_methods_clipping_predicates.md.Dyq9YrPd.lean.js b/previews/PR237/assets/source_methods_clipping_predicates.md.Dyq9YrPd.lean.js new file mode 100644 index 000000000..ae23f32fc --- /dev/null +++ b/previews/PR237/assets/source_methods_clipping_predicates.md.Dyq9YrPd.lean.js @@ -0,0 +1,44 @@ +import{_ as i,c as a,a5 as n,o as t}from"./chunks/framework.Cq8AuEls.js";const c=JSON.parse('{"title":"If we want to inject adaptivity, we would do something like:","description":"","frontmatter":{},"headers":[],"relativePath":"source/methods/clipping/predicates.md","filePath":"source/methods/clipping/predicates.md","lastUpdated":null}'),h={name:"source/methods/clipping/predicates.md"};function e(p,s,l,k,r,d){return t(),a("div",null,s[0]||(s[0]=[n(`
julia
module Predicates
+    using ExactPredicates, ExactPredicates.Codegen
+    import ExactPredicates: ext
+    import ExactPredicates.Codegen: group!, @genpredicate
+    import GeometryOps: _False, _True, _booltype, _tuple_point
+    import GeoInterface as GI
+
+    #= Determine the orientation of c with regards to the oriented segment (a, b).
+    Return 1 if c is to the left of (a, b).
+    Return -1 if c is to the right of (a, b).
+    Return 0 if c is on (a, b) or if a == b. =#
+    orient(a, b, c; exact) = _orient(_booltype(exact), a, b, c)

If exact is true, use ExactPredicates to calculate the orientation.

julia
    _orient(::_True, a, b, c) = ExactPredicates.orient(_tuple_point(a, Float64), _tuple_point(b, Float64), _tuple_point(c, Float64))

If exact is false, calculate the orientation without using ExactPredicates.

julia
    function _orient(exact::_False, a, b, c)
+        a = a .- c
+        b = b .- c
+        return _cross(exact, a, b)
+    end
+
+    #= Determine the sign of the cross product of a and b.
+    Return 1 if the cross product is positive.
+    Return -1 if the cross product is negative.
+    Return 0 if the cross product is 0. =#
+    cross(a, b; exact) = _cross(_booltype(exact), a, b)
+
+    #= If \`exact\` is \`true\`, use exact cross product calculation created using
+    \`ExactPredicates\`generated predicate. Note that as of now \`ExactPredicates\` requires
+    Float64 so we must convert points a and b. =#
+    _cross(::_True, a, b) = _cross_exact(_tuple_point(a, Float64), _tuple_point(b, Float64))

Exact cross product calculation using ExactPredicates.

julia
    @genpredicate function _cross_exact(a :: 2, b :: 2)
+        group!(a...)
+        group!(b...)
+        ext(a, b)
+    end

If exact is false, calculate the cross product without using ExactPredicates.

julia
    function _cross(::_False, a, b)
+        c_t1 = GI.x(a) * GI.y(b)
+        c_t2 = GI.y(a) * GI.x(b)
+        c_val = if isapprox(c_t1, c_t2)
+            0
+        else
+            sign(c_t1 - c_t2)
+        end
+        return c_val
+    end
+
+end
+
+import .Predicates

If we want to inject adaptivity, we would do something like:

function cross(a, b, c) # try Predicates._cross_naive(a, b, c) # check the error bound there # then try Predicates._cross_adaptive(a, b, c) # then try Predicates._cross_exact end


This page was generated using Literate.jl.

`,13)]))}const g=i(h,[["render",e]]);export{c as __pageData,g as default}; diff --git a/previews/PR237/assets/source_methods_clipping_union.md.DfnvhyrM.js b/previews/PR237/assets/source_methods_clipping_union.md.DfnvhyrM.js new file mode 100644 index 000000000..5a8f56c3f --- /dev/null +++ b/previews/PR237/assets/source_methods_clipping_union.md.DfnvhyrM.js @@ -0,0 +1,251 @@ +import{_ as i,c as a,a5 as n,o as l}from"./chunks/framework.Cq8AuEls.js";const y=JSON.parse('{"title":"Union Polygon Clipping","description":"","frontmatter":{},"headers":[],"relativePath":"source/methods/clipping/union.md","filePath":"source/methods/clipping/union.md","lastUpdated":null}'),h={name:"source/methods/clipping/union.md"};function p(t,s,k,e,r,E){return l(),a("div",null,s[0]||(s[0]=[n(`

Union Polygon Clipping

julia
export union
+
+"""
+    union(geom_a, geom_b, [::Type{T}]; target::Type, fix_multipoly = UnionIntersectingPolygons())
+
+Return the union between two geometries as a list of geometries. Return an empty list if
+none are found. The type of the list will be constrained as much as possible given the input
+geometries. Furthermore, the user can provide a \`taget\` type as a keyword argument and a
+list of target geometries found in the difference will be returned. The user can also
+provide a float type 'T' that they would like the points of returned geometries to be. If
+the user is taking a intersection involving one or more multipolygons, and the multipolygon
+might be comprised of polygons that intersect, if \`fix_multipoly\` is set to an
+\`IntersectingPolygons\` correction (the default is \`UnionIntersectingPolygons()\`), then the
+needed multipolygons will be fixed to be valid before performing the intersection to ensure
+a correct answer. Only set \`fix_multipoly\` to false if you know that the multipolygons are
+valid, as it will avoid unneeded computation.
+
+Calculates the union between two polygons.
+# Example
+
+\`\`\`jldoctest
+import GeoInterface as GI, GeometryOps as GO
+
+p1 = GI.Polygon([[(0.0, 0.0), (5.0, 5.0), (10.0, 0.0), (5.0, -5.0), (0.0, 0.0)]])
+p2 = GI.Polygon([[(3.0, 0.0), (8.0, 5.0), (13.0, 0.0), (8.0, -5.0), (3.0, 0.0)]])
+union_poly = GO.union(p1, p2; target = GI.PolygonTrait())
+GI.coordinates.(union_poly)

output

julia
1-element Vector{Vector{Vector{Vector{Float64}}}}:
+ [[[6.5, 3.5], [5.0, 5.0], [0.0, 0.0], [5.0, -5.0], [6.5, -3.5], [8.0, -5.0], [13.0, 0.0], [8.0, 5.0], [6.5, 3.5]]]
+\`\`\`
+"""
+function union(
+    geom_a, geom_b, ::Type{T}=Float64; target=nothing, kwargs...
+) where {T<:AbstractFloat}
+    return _union(
+        TraitTarget(target), T, GI.trait(geom_a), geom_a, GI.trait(geom_b), geom_b;
+        exact = _True(), kwargs...,
+    )
+end
+
+#= This 'union' implementation returns the union of two polygons. The algorithm to determine
+the union was adapted from "Efficient clipping of efficient polygons," by Greiner and
+Hormann (1998). DOI: https://doi.org/10.1145/274363.274364 =#
+function _union(
+    ::TraitTarget{GI.PolygonTrait}, ::Type{T},
+    ::GI.PolygonTrait, poly_a,
+    ::GI.PolygonTrait, poly_b;
+    exact, kwargs...,
+) where T

First, I get the exteriors of the two polygons

julia
    ext_a = GI.getexterior(poly_a)
+    ext_b = GI.getexterior(poly_b)

Then, I get the union of the exteriors

julia
    a_list, b_list, a_idx_list = _build_ab_list(T, ext_a, ext_b, _union_delay_cross_f, _union_delay_bounce_f; exact)
+    polys = _trace_polynodes(T, a_list, b_list, a_idx_list, _union_step, poly_a, poly_b)
+    n_pieces = length(polys)

Check if one polygon totally within other and if so, return the larger polygon

julia
    a_in_b, b_in_a = false, false
+    if n_pieces == 0 # no crossing points, determine if either poly is inside the other
+        a_in_b, b_in_a = _find_non_cross_orientation(a_list, b_list, ext_a, ext_b; exact)
+        if a_in_b
+            push!(polys, GI.Polygon([_linearring(tuples(ext_b))]))
+        elseif b_in_a
+            push!(polys,  GI.Polygon([_linearring(tuples(ext_a))]))
+        else
+            push!(polys, tuples(poly_a))
+            push!(polys, tuples(poly_b))
+            return polys
+        end
+    elseif n_pieces > 1
+        #= extra polygons are holes (n_pieces == 1 is the desired state) and since
+        holes are formed by regions exterior to both poly_a and poly_b, they can't interact
+        with pre-existing holes =#
+        sort!(polys, by = area, rev = true)  # sort by area so first element is the exterior

the first element is the exterior, the rest are holes

julia
        @views append!(polys[1].geom, (GI.getexterior(p) for p in polys[2:end]))
+        keepat!(polys, 1)
+    end

Add in holes

julia
    if GI.nhole(poly_a) != 0 || GI.nhole(poly_b) != 0
+        _add_union_holes!(polys, a_in_b, b_in_a, poly_a, poly_b; exact)
+    end

Remove unneeded collinear points on same edge

julia
    _remove_collinear_points!(polys, [false], poly_a, poly_b)
+    return polys
+end

Helper functions for Unions with Greiner and Hormann Polygon Clipping

julia
#= When marking the crossing status of a delayed crossing, the chain start point is crossing
+when the start point is a entry point and is a bouncing point when the start point is an
+exit point. The end of the chain has the opposite crossing / bouncing status. =#
+_union_delay_cross_f(x) = (x, !x)
+
+#= When marking the crossing status of a delayed bouncing, the chain start and end points
+are bouncing if the current polygon's adjacent edges are within the non-tracing polygon. If
+the edges are outside then the chain endpoints are marked as crossing. x is a boolean
+representing if the edges are inside or outside of the polygon. =#
+_union_delay_bounce_f(x, _) = !x
+
+#= When tracing polygons, step backwards if the most recent intersection point was an entry
+point, else step forwards where x is the entry/exit status. =#
+_union_step(x, _) = x ? (-1) : 1
+
+#= Add holes from two polygons to the exterior polygon formed by their union. If adding the
+the holes reveals that the polygons aren't actually intersecting, return the original
+polygons. =#
+function _add_union_holes!(polys, a_in_b, b_in_a, poly_a, poly_b; exact)
+    if a_in_b
+        _add_union_holes_contained_polys!(polys, poly_a, poly_b; exact)
+    elseif b_in_a
+        _add_union_holes_contained_polys!(polys, poly_b, poly_a; exact)
+    else  # Polygons intersect, but neither is contained in the other
+        n_a_holes = GI.nhole(poly_a)
+        ext_poly_a = GI.Polygon(StaticArrays.SVector(GI.getexterior(poly_a)))
+        ext_poly_b = GI.Polygon(StaticArrays.SVector(GI.getexterior(poly_b)))
+        #= Start with poly_b when comparing with holes from poly_a and then switch to poly_a
+        to compare with holes from poly_b. For current_poly, use ext_poly_b to avoid
+        repeating overlapping holes in poly_a and poly_b =#
+        curr_exterior_poly = n_a_holes > 0 ? ext_poly_b : ext_poly_a
+        current_poly = n_a_holes > 0 ? ext_poly_b : poly_a

Loop over all holes in both original polygons

julia
        for (i, ih) in enumerate(Iterators.flatten((GI.gethole(poly_a), GI.gethole(poly_b))))
+            ih = _linearring(ih)
+            in_ext, _, _ = _line_polygon_interactions(ih, curr_exterior_poly; exact, closed_line = true)
+            if !in_ext
+                #= if the hole isn't in the overlapping region between the two polygons, add
+                the hole to the resulting polygon as we know it can't interact with any
+                other holes =#
+                push!(polys[1].geom, ih)
+            else
+                #= if the hole is at least partially in the overlapping region, take the
+                difference of the hole from the polygon it didn't originate from - note that
+                when current_poly is poly_a this includes poly_a holes so overlapping holes
+                between poly_a and poly_b within the overlap are added, in addition to all
+                holes in non-overlapping regions =#
+                h_poly = GI.Polygon(StaticArrays.SVector(ih))
+                new_holes = difference(h_poly, current_poly; target = GI.PolygonTrait())
+                append!(polys[1].geom, (GI.getexterior(new_h) for new_h in new_holes))
+            end
+            if i == n_a_holes
+                curr_exterior_poly = ext_poly_a
+                current_poly = poly_a
+            end
+        end
+    end
+    return
+end
+
+#= Add holes holes to the union of two polygons where one of the original polygons was
+inside of the other. If adding the the holes reveal that the polygons aren't actually
+intersecting, return the original polygons.=#
+function _add_union_holes_contained_polys!(polys, interior_poly, exterior_poly; exact)
+    union_poly = polys[1]
+    ext_int_ring = GI.getexterior(interior_poly)
+    for (i, ih) in enumerate(GI.gethole(exterior_poly))
+        poly_ih = GI.Polygon(StaticArrays.SVector(ih))
+        in_ih, on_ih, out_ih = _line_polygon_interactions(ext_int_ring, poly_ih; exact, closed_line = true)
+        if in_ih  # at least part of interior polygon exterior is within the ith hole
+            if !on_ih && !out_ih
+                #= interior polygon is completely within the ith hole - polygons aren't
+                touching and do not actually form a union =#
+                polys[1] = tuples(interior_poly)
+                push!(polys, tuples(exterior_poly))
+                return polys
+            else
+                #= interior polygon is partially within the ith hole - area of interior
+                polygon reduces the size of the hole =#
+                new_holes = difference(poly_ih, interior_poly; target = GI.PolygonTrait())
+                append!(union_poly.geom, (GI.getexterior(new_h) for new_h in new_holes))
+            end
+        else  # none of interior polygon exterior is within the ith hole
+            if !out_ih
+                #= interior polygon's exterior is the same as the ith hole - polygons do
+                form a union, but do not overlap so all holes stay in final polygon =#
+                append!(union_poly.geom, Iterators.drop(GI.gethole(exterior_poly), i))
+                append!(union_poly.geom, GI.gethole(interior_poly))
+                return polys
+            else
+                #= interior polygon's exterior is outside of the ith hole - the interior
+                polygon could either be disjoint from the hole, or contain the hole =#
+                ext_int_poly = GI.Polygon(StaticArrays.SVector(ext_int_ring))
+                in_int, _, _ = _line_polygon_interactions(ih, ext_int_poly; exact, closed_line = true)
+                if in_int
+                    #= interior polygon contains the hole - overlapping holes between the
+                    interior and exterior polygons will be added =#
+                    for jh in GI.gethole(interior_poly)
+                        poly_jh = GI.Polygon(StaticArrays.SVector(jh))
+                        if intersects(poly_ih, poly_jh)
+                            new_holes = intersection(poly_ih, poly_jh; target = GI.PolygonTrait())
+                            append!(union_poly.geom, (GI.getexterior(new_h) for new_h in new_holes))
+                        end
+                    end
+                else
+                    #= interior polygon and the exterior polygon are disjoint - add the ith
+                    hole as it is not covered by the interior polygon =#
+                    push!(union_poly.geom, ih)
+                end
+            end
+        end
+    end
+    return
+end
+
+#= Polygon with multipolygon union - note that all sub-polygons of \`multipoly_b\` will be
+included, unioning these sub-polygons with \`poly_a\` where they intersect. Unless specified
+with \`fix_multipoly = nothing\`, \`multipolygon_b\` will be validated using the given (default
+is \`UnionIntersectingPolygons()\`) correction. =#
+function _union(
+    target::TraitTarget{GI.PolygonTrait}, ::Type{T},
+    ::GI.PolygonTrait, poly_a,
+    ::GI.MultiPolygonTrait, multipoly_b;
+    fix_multipoly = UnionIntersectingPolygons(), kwargs...,
+) where T
+    if !isnothing(fix_multipoly) # Fix multipoly_b to prevent repeated regions in the output
+        multipoly_b = fix_multipoly(multipoly_b)
+    end
+    polys = [tuples(poly_a, T)]
+    for poly_b in GI.getpolygon(multipoly_b)
+        if intersects(polys[1], poly_b)

If polygons intersect and form a new polygon, swap out polygon

julia
            new_polys = union(polys[1], poly_b; target)
+            if length(new_polys) > 1 # case where they intersect by just one point
+                push!(polys, tuples(poly_b, T))  # add poly_b to list
+            else
+                polys[1] = new_polys[1]
+            end
+        else

If they don't intersect, poly_b is now a part of the union as its own polygon

julia
            push!(polys, tuples(poly_b, T))
+        end
+    end
+    return polys
+end
+
+#= Multipolygon with polygon union is equivalent to taking the union of the polygon with the
+multipolygon and thus simply switches the order of operations and calls the above method. =#
+_union(
+    target::TraitTarget{GI.PolygonTrait}, ::Type{T},
+    ::GI.MultiPolygonTrait, multipoly_a,
+    ::GI.PolygonTrait, poly_b;
+    kwargs...,
+) where T = union(poly_b, multipoly_a; target, kwargs...)
+
+#= Multipolygon with multipolygon union - note that all of the sub-polygons of \`multipoly_a\`
+and the sub-polygons of \`multipoly_b\` are included and combined together where there are
+intersections. Unless specified with \`fix_multipoly = nothing\`, \`multipolygon_b\` will be
+validated using the given (default is \`UnionIntersectingPolygons()\`) correction. =#
+function _union(
+    target::TraitTarget{GI.PolygonTrait}, ::Type{T},
+    ::GI.MultiPolygonTrait, multipoly_a,
+    ::GI.MultiPolygonTrait, multipoly_b;
+    fix_multipoly = UnionIntersectingPolygons(), kwargs...,
+) where T
+    if !isnothing(fix_multipoly) # Fix multipoly_b to prevent repeated regions in the output
+        multipoly_b = fix_multipoly(multipoly_b)
+        fix_multipoly = nothing
+    end
+    multipolys = multipoly_b
+    local polys
+    for poly_a in GI.getpolygon(multipoly_a)
+        polys = union(poly_a, multipolys; target, fix_multipoly)
+        multipolys = GI.MultiPolygon(polys)
+    end
+    return polys
+end

Many type and target combos aren't implemented

julia
function _union(
+    ::TraitTarget{Target}, ::Type{T},
+    trait_a::GI.AbstractTrait, geom_a,
+    trait_b::GI.AbstractTrait, geom_b;
+    kwargs...
+) where {Target,T}
+    throw(ArgumentError("Union between $trait_a and $trait_b with target $Target isn't implemented yet."))
+    return nothing
+end

This page was generated using Literate.jl.

`,28)]))}const d=i(h,[["render",p]]);export{y as __pageData,d as default}; diff --git a/previews/PR237/assets/source_methods_clipping_union.md.DfnvhyrM.lean.js b/previews/PR237/assets/source_methods_clipping_union.md.DfnvhyrM.lean.js new file mode 100644 index 000000000..5a8f56c3f --- /dev/null +++ b/previews/PR237/assets/source_methods_clipping_union.md.DfnvhyrM.lean.js @@ -0,0 +1,251 @@ +import{_ as i,c as a,a5 as n,o as l}from"./chunks/framework.Cq8AuEls.js";const y=JSON.parse('{"title":"Union Polygon Clipping","description":"","frontmatter":{},"headers":[],"relativePath":"source/methods/clipping/union.md","filePath":"source/methods/clipping/union.md","lastUpdated":null}'),h={name:"source/methods/clipping/union.md"};function p(t,s,k,e,r,E){return l(),a("div",null,s[0]||(s[0]=[n(`

Union Polygon Clipping

julia
export union
+
+"""
+    union(geom_a, geom_b, [::Type{T}]; target::Type, fix_multipoly = UnionIntersectingPolygons())
+
+Return the union between two geometries as a list of geometries. Return an empty list if
+none are found. The type of the list will be constrained as much as possible given the input
+geometries. Furthermore, the user can provide a \`taget\` type as a keyword argument and a
+list of target geometries found in the difference will be returned. The user can also
+provide a float type 'T' that they would like the points of returned geometries to be. If
+the user is taking a intersection involving one or more multipolygons, and the multipolygon
+might be comprised of polygons that intersect, if \`fix_multipoly\` is set to an
+\`IntersectingPolygons\` correction (the default is \`UnionIntersectingPolygons()\`), then the
+needed multipolygons will be fixed to be valid before performing the intersection to ensure
+a correct answer. Only set \`fix_multipoly\` to false if you know that the multipolygons are
+valid, as it will avoid unneeded computation.
+
+Calculates the union between two polygons.
+# Example
+
+\`\`\`jldoctest
+import GeoInterface as GI, GeometryOps as GO
+
+p1 = GI.Polygon([[(0.0, 0.0), (5.0, 5.0), (10.0, 0.0), (5.0, -5.0), (0.0, 0.0)]])
+p2 = GI.Polygon([[(3.0, 0.0), (8.0, 5.0), (13.0, 0.0), (8.0, -5.0), (3.0, 0.0)]])
+union_poly = GO.union(p1, p2; target = GI.PolygonTrait())
+GI.coordinates.(union_poly)

output

julia
1-element Vector{Vector{Vector{Vector{Float64}}}}:
+ [[[6.5, 3.5], [5.0, 5.0], [0.0, 0.0], [5.0, -5.0], [6.5, -3.5], [8.0, -5.0], [13.0, 0.0], [8.0, 5.0], [6.5, 3.5]]]
+\`\`\`
+"""
+function union(
+    geom_a, geom_b, ::Type{T}=Float64; target=nothing, kwargs...
+) where {T<:AbstractFloat}
+    return _union(
+        TraitTarget(target), T, GI.trait(geom_a), geom_a, GI.trait(geom_b), geom_b;
+        exact = _True(), kwargs...,
+    )
+end
+
+#= This 'union' implementation returns the union of two polygons. The algorithm to determine
+the union was adapted from "Efficient clipping of efficient polygons," by Greiner and
+Hormann (1998). DOI: https://doi.org/10.1145/274363.274364 =#
+function _union(
+    ::TraitTarget{GI.PolygonTrait}, ::Type{T},
+    ::GI.PolygonTrait, poly_a,
+    ::GI.PolygonTrait, poly_b;
+    exact, kwargs...,
+) where T

First, I get the exteriors of the two polygons

julia
    ext_a = GI.getexterior(poly_a)
+    ext_b = GI.getexterior(poly_b)

Then, I get the union of the exteriors

julia
    a_list, b_list, a_idx_list = _build_ab_list(T, ext_a, ext_b, _union_delay_cross_f, _union_delay_bounce_f; exact)
+    polys = _trace_polynodes(T, a_list, b_list, a_idx_list, _union_step, poly_a, poly_b)
+    n_pieces = length(polys)

Check if one polygon totally within other and if so, return the larger polygon

julia
    a_in_b, b_in_a = false, false
+    if n_pieces == 0 # no crossing points, determine if either poly is inside the other
+        a_in_b, b_in_a = _find_non_cross_orientation(a_list, b_list, ext_a, ext_b; exact)
+        if a_in_b
+            push!(polys, GI.Polygon([_linearring(tuples(ext_b))]))
+        elseif b_in_a
+            push!(polys,  GI.Polygon([_linearring(tuples(ext_a))]))
+        else
+            push!(polys, tuples(poly_a))
+            push!(polys, tuples(poly_b))
+            return polys
+        end
+    elseif n_pieces > 1
+        #= extra polygons are holes (n_pieces == 1 is the desired state) and since
+        holes are formed by regions exterior to both poly_a and poly_b, they can't interact
+        with pre-existing holes =#
+        sort!(polys, by = area, rev = true)  # sort by area so first element is the exterior

the first element is the exterior, the rest are holes

julia
        @views append!(polys[1].geom, (GI.getexterior(p) for p in polys[2:end]))
+        keepat!(polys, 1)
+    end

Add in holes

julia
    if GI.nhole(poly_a) != 0 || GI.nhole(poly_b) != 0
+        _add_union_holes!(polys, a_in_b, b_in_a, poly_a, poly_b; exact)
+    end

Remove unneeded collinear points on same edge

julia
    _remove_collinear_points!(polys, [false], poly_a, poly_b)
+    return polys
+end

Helper functions for Unions with Greiner and Hormann Polygon Clipping

julia
#= When marking the crossing status of a delayed crossing, the chain start point is crossing
+when the start point is a entry point and is a bouncing point when the start point is an
+exit point. The end of the chain has the opposite crossing / bouncing status. =#
+_union_delay_cross_f(x) = (x, !x)
+
+#= When marking the crossing status of a delayed bouncing, the chain start and end points
+are bouncing if the current polygon's adjacent edges are within the non-tracing polygon. If
+the edges are outside then the chain endpoints are marked as crossing. x is a boolean
+representing if the edges are inside or outside of the polygon. =#
+_union_delay_bounce_f(x, _) = !x
+
+#= When tracing polygons, step backwards if the most recent intersection point was an entry
+point, else step forwards where x is the entry/exit status. =#
+_union_step(x, _) = x ? (-1) : 1
+
+#= Add holes from two polygons to the exterior polygon formed by their union. If adding the
+the holes reveals that the polygons aren't actually intersecting, return the original
+polygons. =#
+function _add_union_holes!(polys, a_in_b, b_in_a, poly_a, poly_b; exact)
+    if a_in_b
+        _add_union_holes_contained_polys!(polys, poly_a, poly_b; exact)
+    elseif b_in_a
+        _add_union_holes_contained_polys!(polys, poly_b, poly_a; exact)
+    else  # Polygons intersect, but neither is contained in the other
+        n_a_holes = GI.nhole(poly_a)
+        ext_poly_a = GI.Polygon(StaticArrays.SVector(GI.getexterior(poly_a)))
+        ext_poly_b = GI.Polygon(StaticArrays.SVector(GI.getexterior(poly_b)))
+        #= Start with poly_b when comparing with holes from poly_a and then switch to poly_a
+        to compare with holes from poly_b. For current_poly, use ext_poly_b to avoid
+        repeating overlapping holes in poly_a and poly_b =#
+        curr_exterior_poly = n_a_holes > 0 ? ext_poly_b : ext_poly_a
+        current_poly = n_a_holes > 0 ? ext_poly_b : poly_a

Loop over all holes in both original polygons

julia
        for (i, ih) in enumerate(Iterators.flatten((GI.gethole(poly_a), GI.gethole(poly_b))))
+            ih = _linearring(ih)
+            in_ext, _, _ = _line_polygon_interactions(ih, curr_exterior_poly; exact, closed_line = true)
+            if !in_ext
+                #= if the hole isn't in the overlapping region between the two polygons, add
+                the hole to the resulting polygon as we know it can't interact with any
+                other holes =#
+                push!(polys[1].geom, ih)
+            else
+                #= if the hole is at least partially in the overlapping region, take the
+                difference of the hole from the polygon it didn't originate from - note that
+                when current_poly is poly_a this includes poly_a holes so overlapping holes
+                between poly_a and poly_b within the overlap are added, in addition to all
+                holes in non-overlapping regions =#
+                h_poly = GI.Polygon(StaticArrays.SVector(ih))
+                new_holes = difference(h_poly, current_poly; target = GI.PolygonTrait())
+                append!(polys[1].geom, (GI.getexterior(new_h) for new_h in new_holes))
+            end
+            if i == n_a_holes
+                curr_exterior_poly = ext_poly_a
+                current_poly = poly_a
+            end
+        end
+    end
+    return
+end
+
+#= Add holes holes to the union of two polygons where one of the original polygons was
+inside of the other. If adding the the holes reveal that the polygons aren't actually
+intersecting, return the original polygons.=#
+function _add_union_holes_contained_polys!(polys, interior_poly, exterior_poly; exact)
+    union_poly = polys[1]
+    ext_int_ring = GI.getexterior(interior_poly)
+    for (i, ih) in enumerate(GI.gethole(exterior_poly))
+        poly_ih = GI.Polygon(StaticArrays.SVector(ih))
+        in_ih, on_ih, out_ih = _line_polygon_interactions(ext_int_ring, poly_ih; exact, closed_line = true)
+        if in_ih  # at least part of interior polygon exterior is within the ith hole
+            if !on_ih && !out_ih
+                #= interior polygon is completely within the ith hole - polygons aren't
+                touching and do not actually form a union =#
+                polys[1] = tuples(interior_poly)
+                push!(polys, tuples(exterior_poly))
+                return polys
+            else
+                #= interior polygon is partially within the ith hole - area of interior
+                polygon reduces the size of the hole =#
+                new_holes = difference(poly_ih, interior_poly; target = GI.PolygonTrait())
+                append!(union_poly.geom, (GI.getexterior(new_h) for new_h in new_holes))
+            end
+        else  # none of interior polygon exterior is within the ith hole
+            if !out_ih
+                #= interior polygon's exterior is the same as the ith hole - polygons do
+                form a union, but do not overlap so all holes stay in final polygon =#
+                append!(union_poly.geom, Iterators.drop(GI.gethole(exterior_poly), i))
+                append!(union_poly.geom, GI.gethole(interior_poly))
+                return polys
+            else
+                #= interior polygon's exterior is outside of the ith hole - the interior
+                polygon could either be disjoint from the hole, or contain the hole =#
+                ext_int_poly = GI.Polygon(StaticArrays.SVector(ext_int_ring))
+                in_int, _, _ = _line_polygon_interactions(ih, ext_int_poly; exact, closed_line = true)
+                if in_int
+                    #= interior polygon contains the hole - overlapping holes between the
+                    interior and exterior polygons will be added =#
+                    for jh in GI.gethole(interior_poly)
+                        poly_jh = GI.Polygon(StaticArrays.SVector(jh))
+                        if intersects(poly_ih, poly_jh)
+                            new_holes = intersection(poly_ih, poly_jh; target = GI.PolygonTrait())
+                            append!(union_poly.geom, (GI.getexterior(new_h) for new_h in new_holes))
+                        end
+                    end
+                else
+                    #= interior polygon and the exterior polygon are disjoint - add the ith
+                    hole as it is not covered by the interior polygon =#
+                    push!(union_poly.geom, ih)
+                end
+            end
+        end
+    end
+    return
+end
+
+#= Polygon with multipolygon union - note that all sub-polygons of \`multipoly_b\` will be
+included, unioning these sub-polygons with \`poly_a\` where they intersect. Unless specified
+with \`fix_multipoly = nothing\`, \`multipolygon_b\` will be validated using the given (default
+is \`UnionIntersectingPolygons()\`) correction. =#
+function _union(
+    target::TraitTarget{GI.PolygonTrait}, ::Type{T},
+    ::GI.PolygonTrait, poly_a,
+    ::GI.MultiPolygonTrait, multipoly_b;
+    fix_multipoly = UnionIntersectingPolygons(), kwargs...,
+) where T
+    if !isnothing(fix_multipoly) # Fix multipoly_b to prevent repeated regions in the output
+        multipoly_b = fix_multipoly(multipoly_b)
+    end
+    polys = [tuples(poly_a, T)]
+    for poly_b in GI.getpolygon(multipoly_b)
+        if intersects(polys[1], poly_b)

If polygons intersect and form a new polygon, swap out polygon

julia
            new_polys = union(polys[1], poly_b; target)
+            if length(new_polys) > 1 # case where they intersect by just one point
+                push!(polys, tuples(poly_b, T))  # add poly_b to list
+            else
+                polys[1] = new_polys[1]
+            end
+        else

If they don't intersect, poly_b is now a part of the union as its own polygon

julia
            push!(polys, tuples(poly_b, T))
+        end
+    end
+    return polys
+end
+
+#= Multipolygon with polygon union is equivalent to taking the union of the polygon with the
+multipolygon and thus simply switches the order of operations and calls the above method. =#
+_union(
+    target::TraitTarget{GI.PolygonTrait}, ::Type{T},
+    ::GI.MultiPolygonTrait, multipoly_a,
+    ::GI.PolygonTrait, poly_b;
+    kwargs...,
+) where T = union(poly_b, multipoly_a; target, kwargs...)
+
+#= Multipolygon with multipolygon union - note that all of the sub-polygons of \`multipoly_a\`
+and the sub-polygons of \`multipoly_b\` are included and combined together where there are
+intersections. Unless specified with \`fix_multipoly = nothing\`, \`multipolygon_b\` will be
+validated using the given (default is \`UnionIntersectingPolygons()\`) correction. =#
+function _union(
+    target::TraitTarget{GI.PolygonTrait}, ::Type{T},
+    ::GI.MultiPolygonTrait, multipoly_a,
+    ::GI.MultiPolygonTrait, multipoly_b;
+    fix_multipoly = UnionIntersectingPolygons(), kwargs...,
+) where T
+    if !isnothing(fix_multipoly) # Fix multipoly_b to prevent repeated regions in the output
+        multipoly_b = fix_multipoly(multipoly_b)
+        fix_multipoly = nothing
+    end
+    multipolys = multipoly_b
+    local polys
+    for poly_a in GI.getpolygon(multipoly_a)
+        polys = union(poly_a, multipolys; target, fix_multipoly)
+        multipolys = GI.MultiPolygon(polys)
+    end
+    return polys
+end

Many type and target combos aren't implemented

julia
function _union(
+    ::TraitTarget{Target}, ::Type{T},
+    trait_a::GI.AbstractTrait, geom_a,
+    trait_b::GI.AbstractTrait, geom_b;
+    kwargs...
+) where {Target,T}
+    throw(ArgumentError("Union between $trait_a and $trait_b with target $Target isn't implemented yet."))
+    return nothing
+end

This page was generated using Literate.jl.

`,28)]))}const d=i(h,[["render",p]]);export{y as __pageData,d as default}; diff --git a/previews/PR237/assets/source_methods_convex_hull.md.CW7Bt5Ex.js b/previews/PR237/assets/source_methods_convex_hull.md.CW7Bt5Ex.js new file mode 100644 index 000000000..0c4aa9340 --- /dev/null +++ b/previews/PR237/assets/source_methods_convex_hull.md.CW7Bt5Ex.js @@ -0,0 +1,57 @@ +import{_ as i,c as a,a5 as n,o as l}from"./chunks/framework.Cq8AuEls.js";const h="/GeometryOps.jl/previews/PR237/assets/xoyljyv.BxObbkJu.png",t="/GeometryOps.jl/previews/PR237/assets/ehnzxhs.mCtKcWOr.png",e="/GeometryOps.jl/previews/PR237/assets/grtdpgq.UKfqMM__.png",c=JSON.parse('{"title":"Convex hull","description":"","frontmatter":{},"headers":[],"relativePath":"source/methods/convex_hull.md","filePath":"source/methods/convex_hull.md","lastUpdated":null}'),p={name:"source/methods/convex_hull.md"};function k(r,s,o,d,E,g){return l(),a("div",null,s[0]||(s[0]=[n(`

Convex hull

The convex hull of a set of points is the smallest convex polygon that contains all the points.

GeometryOps.jl provides a number of methods for computing the convex hull of a set of points, usually linked to other Julia packages.

For now, we expose one algorithm, MonotoneChainMethod, which uses the DelaunayTriangulation.jl package. The GEOS() interface also supports convex hulls.

Future work could include other algorithms, such as Quickhull.jl, or similar, via package extensions.

Example

Simple hull

julia
import GeometryOps as GO, GeoInterface as GI
+using CairoMakie # to plot
+
+points = randn(GO.Point2f, 100)
+f, a, p = plot(points; label = "Points")
+hull_poly = GO.convex_hull(points)
+lines!(a, hull_poly; label = "Convex hull", color = Makie.wong_colors()[2])
+axislegend(a)
+f

Convex hull of the USA

julia
import GeometryOps as GO, GeoInterface as GI
+using CairoMakie # to plot
+using NaturalEarth # for data
+
+all_adm0 = naturalearth("admin_0_countries", 110)
+usa = all_adm0.geometry[findfirst(==("USA"), all_adm0.ADM0_A3)]
+f, a, p = lines(usa)
+lines!(a, GO.convex_hull(usa); color = Makie.wong_colors()[2])
+f

Investigating the winding order

The winding order of the monotone chain method is counterclockwise, while the winding order of the GEOS method is clockwise.

GeometryOps' convexity detection says that the GEOS hull is convex, while the monotone chain method hull is not. However, they are both going over the same points (we checked), it's just that the winding order is different.

In reality, both sets are convex, but we need to fix the GeometryOps convexity detector (isconcave)!

We may also decide at a later date to change the returned winding order of the polygon, but most algorithms are robust to that, and you can always fix it...

julia
import GeoInterface as GI, GeometryOps as GO, LibGEOS as LG
+using CairoMakie # to plot
+
+points = rand(Point2{Float64}, 100)
+go_hull = GO.convex_hull(GO.MonotoneChainMethod(), points)
+lg_hull = GO.convex_hull(GO.GEOS(), points)
+
+fig = Figure()
+a1, p1 = lines(fig[1, 1], go_hull; color = 1:GI.npoint(go_hull), axis = (; title = "MonotoneChainMethod()"))
+a2, p2 = lines(fig[2, 1], lg_hull; color = 1:GI.npoint(lg_hull), axis = (; title = "GEOS()"))
+cb = Colorbar(fig[1:2, 2], p1; label = "Vertex number")
+fig

Implementation

julia
"""
+    convex_hull([method], geometries)
+
+Compute the convex hull of the points in \`geometries\`.
+Returns a \`GI.Polygon\` representing the convex hull.
+
+Note that the polygon returned is wound counterclockwise
+as in the Simple Features standard by default.  If you
+choose GEOS, the winding order will be inverted.
+
+!!! warning
+    This interface only computes the 2-dimensional convex hull!
+
+    For higher dimensional hulls, use the relevant package (Qhull.jl, Quickhull.jl, or similar).
+"""
+function convex_hull end
+
+"""
+    MonotoneChainMethod()
+
+This is an algorithm for the \`convex_hull\` function.
+
+Uses [\`DelaunayTriangulation.jl\`](https://github.com/JuliaGeometry/DelaunayTriangulation.jl) to compute the convex hull.
+This is a pure Julia algorithm which provides an optimal Delaunay triangulation.
+
+See also \`convex_hull\`
+"""
+struct MonotoneChainMethod end

GrahamScanMethod, etc. can be implemented in GO as well, if someone wants to. If we add an extension on Quickhull.jl, then that would be another algorithm.

julia
convex_hull(geometries) = convex_hull(MonotoneChainMethod(), geometries)

TODO: have this respect the CRS by pulling it out of geometries.

julia
function convex_hull(::MonotoneChainMethod, geometries)

Extract all points as tuples. We have to collect and allocate here, because DelaunayTriangulation only accepts vectors of point-like geoms.

Cleanest would be to use the iterable from GO.flatten directly, but that would require us to implement the convex hull algorithm directly.

TODO: create a specialized method that extracts only the information required, GeometryBasics points can be passed through directly.

julia
    points = collect(flatten(tuples, GI.PointTrait, geometries))

Compute the convex hull using DelTri (shorthand for DelaunayTriangulation.jl).

julia
    hull = DelaunayTriangulation.convex_hull(points)

Convert the result to a GI.Polygon and return it. View would be more efficient here, but re-allocating is cleaner.

julia
    point_vec = DelaunayTriangulation.get_points(hull)[DelaunayTriangulation.get_vertices(hull)]
+    return GI.Polygon([GI.LinearRing(point_vec)])
+end

This page was generated using Literate.jl.

`,35)]))}const u=i(p,[["render",k]]);export{c as __pageData,u as default}; diff --git a/previews/PR237/assets/source_methods_convex_hull.md.CW7Bt5Ex.lean.js b/previews/PR237/assets/source_methods_convex_hull.md.CW7Bt5Ex.lean.js new file mode 100644 index 000000000..0c4aa9340 --- /dev/null +++ b/previews/PR237/assets/source_methods_convex_hull.md.CW7Bt5Ex.lean.js @@ -0,0 +1,57 @@ +import{_ as i,c as a,a5 as n,o as l}from"./chunks/framework.Cq8AuEls.js";const h="/GeometryOps.jl/previews/PR237/assets/xoyljyv.BxObbkJu.png",t="/GeometryOps.jl/previews/PR237/assets/ehnzxhs.mCtKcWOr.png",e="/GeometryOps.jl/previews/PR237/assets/grtdpgq.UKfqMM__.png",c=JSON.parse('{"title":"Convex hull","description":"","frontmatter":{},"headers":[],"relativePath":"source/methods/convex_hull.md","filePath":"source/methods/convex_hull.md","lastUpdated":null}'),p={name:"source/methods/convex_hull.md"};function k(r,s,o,d,E,g){return l(),a("div",null,s[0]||(s[0]=[n(`

Convex hull

The convex hull of a set of points is the smallest convex polygon that contains all the points.

GeometryOps.jl provides a number of methods for computing the convex hull of a set of points, usually linked to other Julia packages.

For now, we expose one algorithm, MonotoneChainMethod, which uses the DelaunayTriangulation.jl package. The GEOS() interface also supports convex hulls.

Future work could include other algorithms, such as Quickhull.jl, or similar, via package extensions.

Example

Simple hull

julia
import GeometryOps as GO, GeoInterface as GI
+using CairoMakie # to plot
+
+points = randn(GO.Point2f, 100)
+f, a, p = plot(points; label = "Points")
+hull_poly = GO.convex_hull(points)
+lines!(a, hull_poly; label = "Convex hull", color = Makie.wong_colors()[2])
+axislegend(a)
+f

Convex hull of the USA

julia
import GeometryOps as GO, GeoInterface as GI
+using CairoMakie # to plot
+using NaturalEarth # for data
+
+all_adm0 = naturalearth("admin_0_countries", 110)
+usa = all_adm0.geometry[findfirst(==("USA"), all_adm0.ADM0_A3)]
+f, a, p = lines(usa)
+lines!(a, GO.convex_hull(usa); color = Makie.wong_colors()[2])
+f

Investigating the winding order

The winding order of the monotone chain method is counterclockwise, while the winding order of the GEOS method is clockwise.

GeometryOps' convexity detection says that the GEOS hull is convex, while the monotone chain method hull is not. However, they are both going over the same points (we checked), it's just that the winding order is different.

In reality, both sets are convex, but we need to fix the GeometryOps convexity detector (isconcave)!

We may also decide at a later date to change the returned winding order of the polygon, but most algorithms are robust to that, and you can always fix it...

julia
import GeoInterface as GI, GeometryOps as GO, LibGEOS as LG
+using CairoMakie # to plot
+
+points = rand(Point2{Float64}, 100)
+go_hull = GO.convex_hull(GO.MonotoneChainMethod(), points)
+lg_hull = GO.convex_hull(GO.GEOS(), points)
+
+fig = Figure()
+a1, p1 = lines(fig[1, 1], go_hull; color = 1:GI.npoint(go_hull), axis = (; title = "MonotoneChainMethod()"))
+a2, p2 = lines(fig[2, 1], lg_hull; color = 1:GI.npoint(lg_hull), axis = (; title = "GEOS()"))
+cb = Colorbar(fig[1:2, 2], p1; label = "Vertex number")
+fig

Implementation

julia
"""
+    convex_hull([method], geometries)
+
+Compute the convex hull of the points in \`geometries\`.
+Returns a \`GI.Polygon\` representing the convex hull.
+
+Note that the polygon returned is wound counterclockwise
+as in the Simple Features standard by default.  If you
+choose GEOS, the winding order will be inverted.
+
+!!! warning
+    This interface only computes the 2-dimensional convex hull!
+
+    For higher dimensional hulls, use the relevant package (Qhull.jl, Quickhull.jl, or similar).
+"""
+function convex_hull end
+
+"""
+    MonotoneChainMethod()
+
+This is an algorithm for the \`convex_hull\` function.
+
+Uses [\`DelaunayTriangulation.jl\`](https://github.com/JuliaGeometry/DelaunayTriangulation.jl) to compute the convex hull.
+This is a pure Julia algorithm which provides an optimal Delaunay triangulation.
+
+See also \`convex_hull\`
+"""
+struct MonotoneChainMethod end

GrahamScanMethod, etc. can be implemented in GO as well, if someone wants to. If we add an extension on Quickhull.jl, then that would be another algorithm.

julia
convex_hull(geometries) = convex_hull(MonotoneChainMethod(), geometries)

TODO: have this respect the CRS by pulling it out of geometries.

julia
function convex_hull(::MonotoneChainMethod, geometries)

Extract all points as tuples. We have to collect and allocate here, because DelaunayTriangulation only accepts vectors of point-like geoms.

Cleanest would be to use the iterable from GO.flatten directly, but that would require us to implement the convex hull algorithm directly.

TODO: create a specialized method that extracts only the information required, GeometryBasics points can be passed through directly.

julia
    points = collect(flatten(tuples, GI.PointTrait, geometries))

Compute the convex hull using DelTri (shorthand for DelaunayTriangulation.jl).

julia
    hull = DelaunayTriangulation.convex_hull(points)

Convert the result to a GI.Polygon and return it. View would be more efficient here, but re-allocating is cleaner.

julia
    point_vec = DelaunayTriangulation.get_points(hull)[DelaunayTriangulation.get_vertices(hull)]
+    return GI.Polygon([GI.LinearRing(point_vec)])
+end

This page was generated using Literate.jl.

`,35)]))}const u=i(p,[["render",k]]);export{c as __pageData,u as default}; diff --git a/previews/PR237/assets/source_methods_distance.md.CFtY9lnQ.js b/previews/PR237/assets/source_methods_distance.md.CFtY9lnQ.js new file mode 100644 index 000000000..bd19d0400 --- /dev/null +++ b/previews/PR237/assets/source_methods_distance.md.CFtY9lnQ.js @@ -0,0 +1,181 @@ +import{_ as i,c as a,a5 as n,o as h}from"./chunks/framework.Cq8AuEls.js";const t="/GeometryOps.jl/previews/PR237/assets/lodwufu.DiwGEg2f.png",k="/GeometryOps.jl/previews/PR237/assets/ajtctyp.DuBHk1fh.png",F=JSON.parse('{"title":"Distance and signed distance","description":"","frontmatter":{},"headers":[],"relativePath":"source/methods/distance.md","filePath":"source/methods/distance.md","lastUpdated":null}'),p={name:"source/methods/distance.md"};function l(e,s,d,E,r,g){return h(),a("div",null,s[0]||(s[0]=[n(`

Distance and signed distance

julia
export distance, signed_distance

What is distance? What is signed distance?

Distance is the distance of a point to another geometry. This is always a positive number. If a point is inside of geometry, so on a curve or inside of a polygon, the distance will be zero. Signed distance is mainly used for polygons and multipolygons. If a point is outside of a geometry, signed distance has the same value as distance. However, points within the geometry have a negative distance representing the distance of a point to the closest boundary. Therefore, for all "non-filled" geometries, like curves, the distance will either be positive or 0.

To provide an example, consider this rectangle:

julia
import GeometryOps as GO
+import GeoInterface as GI
+using Makie
+using CairoMakie
+
+rect = GI.Polygon([[(0,0), (0,1), (1,1), (1,0), (0, 0)]])
+point_in = (0.5, 0.5)
+point_out = (0.5, 1.5)
+f, a, p = poly(collect(GI.getpoint(rect)); axis = (; aspect = DataAspect()))
+scatter!(GI.x(point_in), GI.y(point_in); color = :red)
+scatter!(GI.x(point_out), GI.y(point_out); color = :orange)
+f

This is clearly a rectangle with one point inside and one point outside. The points are both an equal distance to the polygon. The distance to point_in is negative while the distance to point_out is positive.

julia
(
+GO.distance(point_in, rect),  # == 0
+GO.signed_distance(point_in, rect),  # < 0
+GO.signed_distance(point_out, rect)  # > 0
+)
(0.0, -0.5, 0.5)

Consider also a heatmap of signed distances around this object:

julia
xrange = yrange = LinRange(-0.5, 1.5, 300)
+f, a, p = heatmap(xrange, yrange, GO.signed_distance.(Point2f.(xrange, yrange'), Ref(rect)); colormap = :RdBu, colorrange = (-0.75, 0.75))
+a.aspect = DataAspect(); Colorbar(f[1, 2], p, label = "Signed distance"); lines!(a, GI.convert(GO.GeometryBasics, rect)); f

Implementation

This is the GeoInterface-compatible implementation. First, we implement a wrapper method that dispatches to the correct implementation based on the geometry trait. This is also used in the implementation, since it's a lot less work!

Distance and signed distance are only implemented for points to other geometries right now. This could be extended to include distance from other geometries in the future.

The distance calculated is the Euclidean distance using the Pythagorean theorem. Also note that singed_distance only makes sense for "filled-in" shapes, like polygons, so it isn't implemented for curves.

julia
const _DISTANCE_TARGETS = TraitTarget{Union{GI.AbstractPolygonTrait,GI.LineStringTrait,GI.LinearRingTrait,GI.LineTrait,GI.PointTrait}}()
+
+"""
+    distance(point, geom, ::Type{T} = Float64)::T
+
+Calculates the  ditance from the geometry \`g1\` to the \`point\`. The distance
+will always be positive or zero.
+
+The method will differ based on the type of the geometry provided:
+    - The distance from a point to a point is just the Euclidean distance
+    between the points.
+    - The distance from a point to a line is the minimum distance from the point
+    to the closest point on the given line.
+    - The distance from a point to a linestring is the minimum distance from the
+    point to the closest segment of the linestring.
+    - The distance from a point to a linear ring is the minimum distance from
+    the point to the closest segment of the linear ring.
+    - The distance from a point to a polygon is zero if the point is within the
+    polygon and otherwise is the minimum distance from the point to an edge of
+    the polygon. This includes edges created by holes.
+    - The distance from a point to a multigeometry or a geometry collection is
+    the minimum distance between the point and any of the sub-geometries.
+
+Result will be of type T, where T is an optional argument with a default value
+of Float64.
+"""
+function distance(
+    geom1, geom2, ::Type{T} = Float64; threaded=false
+) where T<:AbstractFloat
+    distance(GI.trait(geom1), geom1, GI.trait(geom2), geom2, T; threaded)
+end
+function distance(
+    trait1, geom, trait2::GI.PointTrait, point, ::Type{T} = Float64;
+    threaded=false
+) where T<:AbstractFloat
+    distance(trait2, point, trait1, geom, T) # Swap order
+end
+function distance(
+    trait1::GI.PointTrait, point, trait2, geom, ::Type{T} = Float64;
+    threaded=false
+) where T<:AbstractFloat
+    applyreduce(min, _DISTANCE_TARGETS, geom; threaded, init=typemax(T)) do g
+        _distance(T, trait1, point, GI.trait(g), g)
+    end
+end

Needed for method ambiguity

julia
function distance(
+    trait1::GI.PointTrait, point1, trait2::GI.PointTrait, point2, ::Type{T} = Float64;
+    threaded=false
+) where T<:AbstractFloat
+    _distance(T, trait1, point1, trait2, point2)
+end

Point-Point, Point-Line, Point-LineString, Point-LinearRing

julia
_distance(::Type{T}, ::GI.PointTrait, point, ::GI.PointTrait, geom) where T =
+    _euclid_distance(T, point, geom)
+_distance(::Type{T}, ::GI.PointTrait, point, ::GI.LineTrait, geom) where T =
+    _distance_line(T, point, GI.getpoint(geom, 1), GI.getpoint(geom, 2))
+_distance(::Type{T}, ::GI.PointTrait, point, ::GI.LineStringTrait, geom) where T =
+    _distance_curve(T, point, geom; close_curve = false)
+_distance(::Type{T}, ::GI.PointTrait, point, ::GI.LinearRingTrait, geom) where T =
+    _distance_curve(T, point, geom; close_curve = true)

Point-Polygon

julia
function _distance(::Type{T}, ::GI.PointTrait, point, ::GI.PolygonTrait, geom) where T
+    within(point, geom) && return zero(T)
+    return _distance_polygon(T, point, geom)
+end
+
+"""
+    signed_distance(point, geom, ::Type{T} = Float64)::T
+
+Calculates the signed distance from the geometry \`geom\` to the given point.
+Points within \`geom\` have a negative signed distance, and points outside of
+\`geom\` have a positive signed distance.
+    - The signed distance from a point to a point, line, linestring, or linear
+    ring is equal to the distance between the two.
+    - The signed distance from a point to a polygon is negative if the point is
+    within the polygon and is positive otherwise. The value of the distance is
+    the minimum distance from the point to an edge of the polygon. This includes
+    edges created by holes.
+    - The signed distance from a point to a multigeometry or a geometry
+    collection is the minimum signed distance between the point and any of the
+    sub-geometries.
+
+Result will be of type T, where T is an optional argument with a default value
+of Float64.
+"""
+function signed_distance(
+    geom1, geom2, ::Type{T} = Float64; threaded=false
+) where T<:AbstractFloat
+    signed_distance(GI.trait(geom1), geom1, GI.trait(geom2), geom2, T; threaded)
+end
+function signed_distance(
+    trait1, geom, trait2::GI.PointTrait, point, ::Type{T} = Float64;
+    threaded=false
+) where T<:AbstractFloat
+    signed_distance(trait2, point, trait1, geom, T; threaded) # Swap order
+end
+function signed_distance(
+    trait1::GI.PointTrait, point, trait2, geom, ::Type{T} = Float64;
+    threaded=false
+) where T<:AbstractFloat
+    applyreduce(min, _DISTANCE_TARGETS, geom; threaded, init=typemax(T)) do g
+        _signed_distance(T, trait1, point, GI.trait(g), g)
+    end
+end

Needed for method ambiguity

julia
function signed_distance(
+    trait1::GI.PointTrait, point1, trait2::GI.PointTrait, point2, ::Type{T} = Float64;
+    threaded=false
+) where T<:AbstractFloat
+    _signed_distance(T, trait1, point1, trait2, point2)
+end

Point-Geom (just calls _distance)

julia
function _signed_distance(
+    ::Type{T}, ptrait::GI.PointTrait, point, gtrait::GI.AbstractGeometryTrait, geom
+) where T
+    _distance(T, ptrait, point, gtrait, geom)
+end

Point-Polygon

julia
function _signed_distance(::Type{T}, ::GI.PointTrait, point, ::GI.PolygonTrait, geom) where T
+    min_dist = _distance_polygon(T, point, geom)
+    return within(point, geom) ? -min_dist : min_dist

negative if point is inside polygon

julia
end

Returns the Euclidean distance between two points.

julia
Base.@propagate_inbounds _euclid_distance(::Type{T}, p1, p2) where T =
+    sqrt(_squared_euclid_distance(T, p1, p2))

Returns the square of the euclidean distance between two points

julia
Base.@propagate_inbounds _squared_euclid_distance(::Type{T}, p1, p2) where T =
+    _squared_euclid_distance(
+        T,
+        GeoInterface.x(p1), GeoInterface.y(p1),
+        GeoInterface.x(p2), GeoInterface.y(p2),
+    )

Returns the Euclidean distance between two points given their x and y values.

julia
Base.@propagate_inbounds _euclid_distance(::Type{T}, x1, y1, x2, y2) where T =
+    sqrt(_squared_euclid_distance(T, x1, y1, x2, y2))

Returns the squared Euclidean distance between two points given their x and y values.

julia
Base.@propagate_inbounds _squared_euclid_distance(::Type{T}, x1, y1, x2, y2) where T =
+    T((x2 - x1)^2 + (y2 - y1)^2)

Returns the minimum distance from point p0 to the line defined by endpoints p1 and p2.

julia
_distance_line(::Type{T}, p0, p1, p2) where T =
+    sqrt(_squared_distance_line(T, p0, p1, p2))

Returns the squared minimum distance from point p0 to the line defined by endpoints p1 and p2.

julia
function _squared_distance_line(::Type{T}, p0, p1, p2) where T
+    x0, y0 = GeoInterface.x(p0), GeoInterface.y(p0)
+    x1, y1 = GeoInterface.x(p1), GeoInterface.y(p1)
+    x2, y2 = GeoInterface.x(p2), GeoInterface.y(p2)
+
+    xfirst, yfirst, xlast, ylast = x1 < x2 ? (x1, y1, x2, y2) : (x2, y2, x1, y1)
+
+    #=
+    Vectors from first point to last point (v) and from first point to point of
+    interest (w) to find the projection of w onto v to find closest point
+    =#
+    v = (xlast - xfirst, ylast - yfirst)
+    w = (x0 - xfirst, y0 - yfirst)
+
+    c1 = sum(w .* v)
+    if c1 <= 0  # p0 is closest to first endpoint
+        return _squared_euclid_distance(T, x0, y0, xfirst, yfirst)
+    end
+
+    c2 = sum(v .* v)
+    if c2 <= c1 # p0 is closest to last endpoint
+        return _squared_euclid_distance(T, x0, y0, xlast, ylast)
+    end
+
+    b2 = c1 / c2  # projection fraction
+    return _squared_euclid_distance(T, x0, y0, xfirst + (b2 * v[1]), yfirst + (b2 * v[2]))
+end

Returns the minimum distance from the given point to the given curve. If close_curve is true, make sure to include the edge from the first to last point of the curve, even if it isn't explicitly repeated.

julia
function _distance_curve(::Type{T}, point, curve; close_curve = false) where T

see if linear ring has explicitly repeated last point in coordinates

julia
    np = GI.npoint(curve)
+    first_last_equal = equals(GI.getpoint(curve, 1), GI.getpoint(curve, np))
+    close_curve &= first_last_equal
+    np -= first_last_equal ? 1 : 0

find minimum distance

julia
    min_dist = typemax(T)
+    p1 = GI.getpoint(curve, close_curve ? np : 1)
+    for i in (close_curve ? 1 : 2):np
+        p2 = GI.getpoint(curve, i)
+        dist = _distance_line(T, point, p1, p2)
+        min_dist = dist < min_dist ? dist : min_dist
+        p1 = p2
+    end
+    return min_dist
+end

Returns the minimum distance from the given point to an edge of the given polygon, including from edges created by holes. Assumes polygon isn't filled and treats the exterior and each hole as a linear ring.

julia
function _distance_polygon(::Type{T}, point, poly) where T
+    min_dist = _distance_curve(T, point, GI.getexterior(poly); close_curve = true)
+    @inbounds for hole in GI.gethole(poly)
+        dist = _distance_curve(T, point, hole; close_curve = true)
+        min_dist = dist < min_dist ? dist : min_dist
+    end
+    return min_dist
+end

This page was generated using Literate.jl.

`,54)]))}const o=i(p,[["render",l]]);export{F as __pageData,o as default}; diff --git a/previews/PR237/assets/source_methods_distance.md.CFtY9lnQ.lean.js b/previews/PR237/assets/source_methods_distance.md.CFtY9lnQ.lean.js new file mode 100644 index 000000000..bd19d0400 --- /dev/null +++ b/previews/PR237/assets/source_methods_distance.md.CFtY9lnQ.lean.js @@ -0,0 +1,181 @@ +import{_ as i,c as a,a5 as n,o as h}from"./chunks/framework.Cq8AuEls.js";const t="/GeometryOps.jl/previews/PR237/assets/lodwufu.DiwGEg2f.png",k="/GeometryOps.jl/previews/PR237/assets/ajtctyp.DuBHk1fh.png",F=JSON.parse('{"title":"Distance and signed distance","description":"","frontmatter":{},"headers":[],"relativePath":"source/methods/distance.md","filePath":"source/methods/distance.md","lastUpdated":null}'),p={name:"source/methods/distance.md"};function l(e,s,d,E,r,g){return h(),a("div",null,s[0]||(s[0]=[n(`

Distance and signed distance

julia
export distance, signed_distance

What is distance? What is signed distance?

Distance is the distance of a point to another geometry. This is always a positive number. If a point is inside of geometry, so on a curve or inside of a polygon, the distance will be zero. Signed distance is mainly used for polygons and multipolygons. If a point is outside of a geometry, signed distance has the same value as distance. However, points within the geometry have a negative distance representing the distance of a point to the closest boundary. Therefore, for all "non-filled" geometries, like curves, the distance will either be positive or 0.

To provide an example, consider this rectangle:

julia
import GeometryOps as GO
+import GeoInterface as GI
+using Makie
+using CairoMakie
+
+rect = GI.Polygon([[(0,0), (0,1), (1,1), (1,0), (0, 0)]])
+point_in = (0.5, 0.5)
+point_out = (0.5, 1.5)
+f, a, p = poly(collect(GI.getpoint(rect)); axis = (; aspect = DataAspect()))
+scatter!(GI.x(point_in), GI.y(point_in); color = :red)
+scatter!(GI.x(point_out), GI.y(point_out); color = :orange)
+f

This is clearly a rectangle with one point inside and one point outside. The points are both an equal distance to the polygon. The distance to point_in is negative while the distance to point_out is positive.

julia
(
+GO.distance(point_in, rect),  # == 0
+GO.signed_distance(point_in, rect),  # < 0
+GO.signed_distance(point_out, rect)  # > 0
+)
(0.0, -0.5, 0.5)

Consider also a heatmap of signed distances around this object:

julia
xrange = yrange = LinRange(-0.5, 1.5, 300)
+f, a, p = heatmap(xrange, yrange, GO.signed_distance.(Point2f.(xrange, yrange'), Ref(rect)); colormap = :RdBu, colorrange = (-0.75, 0.75))
+a.aspect = DataAspect(); Colorbar(f[1, 2], p, label = "Signed distance"); lines!(a, GI.convert(GO.GeometryBasics, rect)); f

Implementation

This is the GeoInterface-compatible implementation. First, we implement a wrapper method that dispatches to the correct implementation based on the geometry trait. This is also used in the implementation, since it's a lot less work!

Distance and signed distance are only implemented for points to other geometries right now. This could be extended to include distance from other geometries in the future.

The distance calculated is the Euclidean distance using the Pythagorean theorem. Also note that singed_distance only makes sense for "filled-in" shapes, like polygons, so it isn't implemented for curves.

julia
const _DISTANCE_TARGETS = TraitTarget{Union{GI.AbstractPolygonTrait,GI.LineStringTrait,GI.LinearRingTrait,GI.LineTrait,GI.PointTrait}}()
+
+"""
+    distance(point, geom, ::Type{T} = Float64)::T
+
+Calculates the  ditance from the geometry \`g1\` to the \`point\`. The distance
+will always be positive or zero.
+
+The method will differ based on the type of the geometry provided:
+    - The distance from a point to a point is just the Euclidean distance
+    between the points.
+    - The distance from a point to a line is the minimum distance from the point
+    to the closest point on the given line.
+    - The distance from a point to a linestring is the minimum distance from the
+    point to the closest segment of the linestring.
+    - The distance from a point to a linear ring is the minimum distance from
+    the point to the closest segment of the linear ring.
+    - The distance from a point to a polygon is zero if the point is within the
+    polygon and otherwise is the minimum distance from the point to an edge of
+    the polygon. This includes edges created by holes.
+    - The distance from a point to a multigeometry or a geometry collection is
+    the minimum distance between the point and any of the sub-geometries.
+
+Result will be of type T, where T is an optional argument with a default value
+of Float64.
+"""
+function distance(
+    geom1, geom2, ::Type{T} = Float64; threaded=false
+) where T<:AbstractFloat
+    distance(GI.trait(geom1), geom1, GI.trait(geom2), geom2, T; threaded)
+end
+function distance(
+    trait1, geom, trait2::GI.PointTrait, point, ::Type{T} = Float64;
+    threaded=false
+) where T<:AbstractFloat
+    distance(trait2, point, trait1, geom, T) # Swap order
+end
+function distance(
+    trait1::GI.PointTrait, point, trait2, geom, ::Type{T} = Float64;
+    threaded=false
+) where T<:AbstractFloat
+    applyreduce(min, _DISTANCE_TARGETS, geom; threaded, init=typemax(T)) do g
+        _distance(T, trait1, point, GI.trait(g), g)
+    end
+end

Needed for method ambiguity

julia
function distance(
+    trait1::GI.PointTrait, point1, trait2::GI.PointTrait, point2, ::Type{T} = Float64;
+    threaded=false
+) where T<:AbstractFloat
+    _distance(T, trait1, point1, trait2, point2)
+end

Point-Point, Point-Line, Point-LineString, Point-LinearRing

julia
_distance(::Type{T}, ::GI.PointTrait, point, ::GI.PointTrait, geom) where T =
+    _euclid_distance(T, point, geom)
+_distance(::Type{T}, ::GI.PointTrait, point, ::GI.LineTrait, geom) where T =
+    _distance_line(T, point, GI.getpoint(geom, 1), GI.getpoint(geom, 2))
+_distance(::Type{T}, ::GI.PointTrait, point, ::GI.LineStringTrait, geom) where T =
+    _distance_curve(T, point, geom; close_curve = false)
+_distance(::Type{T}, ::GI.PointTrait, point, ::GI.LinearRingTrait, geom) where T =
+    _distance_curve(T, point, geom; close_curve = true)

Point-Polygon

julia
function _distance(::Type{T}, ::GI.PointTrait, point, ::GI.PolygonTrait, geom) where T
+    within(point, geom) && return zero(T)
+    return _distance_polygon(T, point, geom)
+end
+
+"""
+    signed_distance(point, geom, ::Type{T} = Float64)::T
+
+Calculates the signed distance from the geometry \`geom\` to the given point.
+Points within \`geom\` have a negative signed distance, and points outside of
+\`geom\` have a positive signed distance.
+    - The signed distance from a point to a point, line, linestring, or linear
+    ring is equal to the distance between the two.
+    - The signed distance from a point to a polygon is negative if the point is
+    within the polygon and is positive otherwise. The value of the distance is
+    the minimum distance from the point to an edge of the polygon. This includes
+    edges created by holes.
+    - The signed distance from a point to a multigeometry or a geometry
+    collection is the minimum signed distance between the point and any of the
+    sub-geometries.
+
+Result will be of type T, where T is an optional argument with a default value
+of Float64.
+"""
+function signed_distance(
+    geom1, geom2, ::Type{T} = Float64; threaded=false
+) where T<:AbstractFloat
+    signed_distance(GI.trait(geom1), geom1, GI.trait(geom2), geom2, T; threaded)
+end
+function signed_distance(
+    trait1, geom, trait2::GI.PointTrait, point, ::Type{T} = Float64;
+    threaded=false
+) where T<:AbstractFloat
+    signed_distance(trait2, point, trait1, geom, T; threaded) # Swap order
+end
+function signed_distance(
+    trait1::GI.PointTrait, point, trait2, geom, ::Type{T} = Float64;
+    threaded=false
+) where T<:AbstractFloat
+    applyreduce(min, _DISTANCE_TARGETS, geom; threaded, init=typemax(T)) do g
+        _signed_distance(T, trait1, point, GI.trait(g), g)
+    end
+end

Needed for method ambiguity

julia
function signed_distance(
+    trait1::GI.PointTrait, point1, trait2::GI.PointTrait, point2, ::Type{T} = Float64;
+    threaded=false
+) where T<:AbstractFloat
+    _signed_distance(T, trait1, point1, trait2, point2)
+end

Point-Geom (just calls _distance)

julia
function _signed_distance(
+    ::Type{T}, ptrait::GI.PointTrait, point, gtrait::GI.AbstractGeometryTrait, geom
+) where T
+    _distance(T, ptrait, point, gtrait, geom)
+end

Point-Polygon

julia
function _signed_distance(::Type{T}, ::GI.PointTrait, point, ::GI.PolygonTrait, geom) where T
+    min_dist = _distance_polygon(T, point, geom)
+    return within(point, geom) ? -min_dist : min_dist

negative if point is inside polygon

julia
end

Returns the Euclidean distance between two points.

julia
Base.@propagate_inbounds _euclid_distance(::Type{T}, p1, p2) where T =
+    sqrt(_squared_euclid_distance(T, p1, p2))

Returns the square of the euclidean distance between two points

julia
Base.@propagate_inbounds _squared_euclid_distance(::Type{T}, p1, p2) where T =
+    _squared_euclid_distance(
+        T,
+        GeoInterface.x(p1), GeoInterface.y(p1),
+        GeoInterface.x(p2), GeoInterface.y(p2),
+    )

Returns the Euclidean distance between two points given their x and y values.

julia
Base.@propagate_inbounds _euclid_distance(::Type{T}, x1, y1, x2, y2) where T =
+    sqrt(_squared_euclid_distance(T, x1, y1, x2, y2))

Returns the squared Euclidean distance between two points given their x and y values.

julia
Base.@propagate_inbounds _squared_euclid_distance(::Type{T}, x1, y1, x2, y2) where T =
+    T((x2 - x1)^2 + (y2 - y1)^2)

Returns the minimum distance from point p0 to the line defined by endpoints p1 and p2.

julia
_distance_line(::Type{T}, p0, p1, p2) where T =
+    sqrt(_squared_distance_line(T, p0, p1, p2))

Returns the squared minimum distance from point p0 to the line defined by endpoints p1 and p2.

julia
function _squared_distance_line(::Type{T}, p0, p1, p2) where T
+    x0, y0 = GeoInterface.x(p0), GeoInterface.y(p0)
+    x1, y1 = GeoInterface.x(p1), GeoInterface.y(p1)
+    x2, y2 = GeoInterface.x(p2), GeoInterface.y(p2)
+
+    xfirst, yfirst, xlast, ylast = x1 < x2 ? (x1, y1, x2, y2) : (x2, y2, x1, y1)
+
+    #=
+    Vectors from first point to last point (v) and from first point to point of
+    interest (w) to find the projection of w onto v to find closest point
+    =#
+    v = (xlast - xfirst, ylast - yfirst)
+    w = (x0 - xfirst, y0 - yfirst)
+
+    c1 = sum(w .* v)
+    if c1 <= 0  # p0 is closest to first endpoint
+        return _squared_euclid_distance(T, x0, y0, xfirst, yfirst)
+    end
+
+    c2 = sum(v .* v)
+    if c2 <= c1 # p0 is closest to last endpoint
+        return _squared_euclid_distance(T, x0, y0, xlast, ylast)
+    end
+
+    b2 = c1 / c2  # projection fraction
+    return _squared_euclid_distance(T, x0, y0, xfirst + (b2 * v[1]), yfirst + (b2 * v[2]))
+end

Returns the minimum distance from the given point to the given curve. If close_curve is true, make sure to include the edge from the first to last point of the curve, even if it isn't explicitly repeated.

julia
function _distance_curve(::Type{T}, point, curve; close_curve = false) where T

see if linear ring has explicitly repeated last point in coordinates

julia
    np = GI.npoint(curve)
+    first_last_equal = equals(GI.getpoint(curve, 1), GI.getpoint(curve, np))
+    close_curve &= first_last_equal
+    np -= first_last_equal ? 1 : 0

find minimum distance

julia
    min_dist = typemax(T)
+    p1 = GI.getpoint(curve, close_curve ? np : 1)
+    for i in (close_curve ? 1 : 2):np
+        p2 = GI.getpoint(curve, i)
+        dist = _distance_line(T, point, p1, p2)
+        min_dist = dist < min_dist ? dist : min_dist
+        p1 = p2
+    end
+    return min_dist
+end

Returns the minimum distance from the given point to an edge of the given polygon, including from edges created by holes. Assumes polygon isn't filled and treats the exterior and each hole as a linear ring.

julia
function _distance_polygon(::Type{T}, point, poly) where T
+    min_dist = _distance_curve(T, point, GI.getexterior(poly); close_curve = true)
+    @inbounds for hole in GI.gethole(poly)
+        dist = _distance_curve(T, point, hole; close_curve = true)
+        min_dist = dist < min_dist ? dist : min_dist
+    end
+    return min_dist
+end

This page was generated using Literate.jl.

`,54)]))}const o=i(p,[["render",l]]);export{F as __pageData,o as default}; diff --git a/previews/PR237/assets/source_methods_equals.md.VAVTT70r.js b/previews/PR237/assets/source_methods_equals.md.VAVTT70r.js new file mode 100644 index 000000000..0e6d81eeb --- /dev/null +++ b/previews/PR237/assets/source_methods_equals.md.VAVTT70r.js @@ -0,0 +1,265 @@ +import{_ as i,c as a,a5 as n,o as l}from"./chunks/framework.Cq8AuEls.js";const t="/GeometryOps.jl/previews/PR237/assets/qhlrwrc.CgiryX2p.png",F=JSON.parse('{"title":"Equals","description":"","frontmatter":{},"headers":[],"relativePath":"source/methods/equals.md","filePath":"source/methods/equals.md","lastUpdated":null}'),p={name:"source/methods/equals.md"};function h(k,s,e,r,d,g){return l(),a("div",null,s[0]||(s[0]=[n(`

Equals

julia
export equals

What is equals?

The equals function checks if two geometries are equal. They are equal if they share the same set of points and edges to define the same shape.

To provide an example, consider these two lines:

julia
import GeometryOps as GO
+import GeoInterface as GI
+using Makie
+using CairoMakie
+
+l1 = GI.LineString([(0.0, 0.0), (0.0, 10.0)])
+l2 = GI.LineString([(0.0, -10.0), (0.0, 3.0)])
+f, a, p = lines(GI.getpoint(l1), color = :blue)
+scatter!(GI.getpoint(l1), color = :blue)
+lines!(GI.getpoint(l2), color = :orange)
+scatter!(GI.getpoint(l2), color = :orange)
+f

We can see that the two lines do not share a common set of points and edges in the plot, so they are not equal:

julia
GO.equals(l1, l2)  # returns false
false

Implementation

This is the GeoInterface-compatible implementation.

First, we implement a wrapper method that dispatches to the correct implementation based on the geometry trait. This is also used in the implementation, since it's a lot less work!

Note that while we need the same set of points and edges, they don't need to be provided in the same order for polygons. For for example, we need the same set points for two multipoints to be equal, but they don't have to be saved in the same order. The winding order also doesn't have to be the same to represent the same geometry. This requires checking every point against every other point in the two geometries we are comparing. Also, some geometries must be "closed" like polygons and linear rings. These will be assumed to be closed, even if they don't have a repeated last point explicitly written in the coordinates. Additionally, geometries and multi-geometries can be equal if the multi-geometry only includes that single geometry.

julia
"""
+    equals(geom1, geom2)::Bool
+
+Compare two Geometries return true if they are the same geometry.
+
+# Examples
+\`\`\`jldoctest
+import GeometryOps as GO, GeoInterface as GI
+poly1 = GI.Polygon([[(0,0), (0,5), (5,5), (5,0), (0,0)]])
+poly2 = GI.Polygon([[(0,0), (0,5), (5,5), (5,0), (0,0)]])
+
+GO.equals(poly1, poly2)

output

julia
true
+\`\`\`
+"""
+equals(geom_a, geom_b) = equals(
+    GI.trait(geom_a), geom_a,
+    GI.trait(geom_b), geom_b,
+)
+
+"""
+    equals(::T, geom_a, ::T, geom_b)::Bool
+
+Two geometries of the same type, which don't have a equals function to dispatch
+off of should throw an error.
+"""
+equals(::T, geom_a, ::T, geom_b) where T = error("Cant compare $T yet")
+
+"""
+    equals(trait_a, geom_a, trait_b, geom_b)
+
+Two geometries which are not of the same type cannot be equal so they always
+return false.
+"""
+equals(trait_a, geom_a, trait_b, geom_b) = false
+
+"""
+    equals(::GI.PointTrait, p1, ::GI.PointTrait, p2)::Bool
+
+Two points are the same if they have the same x and y (and z if 3D) coordinates.
+"""
+function equals(::GI.PointTrait, p1, ::GI.PointTrait, p2)
+    GI.ncoord(p1) == GI.ncoord(p2) || return false
+    GI.x(p1) == GI.x(p2) || return false
+    GI.y(p1) == GI.y(p2) || return false
+    if GI.is3d(p1)
+        GI.z(p1) == GI.z(p2) || return false
+    end
+    return true
+end
+
+"""
+    equals(::GI.PointTrait, p1, ::GI.MultiPointTrait, mp2)::Bool
+
+A point and a multipoint are equal if the multipoint is composed of a single
+point that is equivalent to the given point.
+"""
+function equals(::GI.PointTrait, p1, ::GI.MultiPointTrait, mp2)
+    GI.npoint(mp2) == 1 || return false
+    return equals(p1, GI.getpoint(mp2, 1))
+end
+
+"""
+    equals(::GI.MultiPointTrait, mp1, ::GI.PointTrait, p2)::Bool
+
+A point and a multipoint are equal if the multipoint is composed of a single
+point that is equivalent to the given point.
+"""
+equals(trait1::GI.MultiPointTrait, mp1, trait2::GI.PointTrait, p2) =
+    equals(trait2, p2, trait1, mp1)
+
+"""
+    equals(::GI.MultiPointTrait, mp1, ::GI.MultiPointTrait, mp2)::Bool
+
+Two multipoints are equal if they share the same set of points.
+"""
+function equals(::GI.MultiPointTrait, mp1, ::GI.MultiPointTrait, mp2)
+    GI.npoint(mp1) == GI.npoint(mp2) || return false
+    for p1 in GI.getpoint(mp1)
+        has_match = false  # if point has a matching point in other multipoint
+        for p2 in GI.getpoint(mp2)
+            if equals(p1, p2)
+                has_match = true
+                break
+            end
+        end
+        has_match || return false  # if no matching point, can't be equal
+    end
+    return true  # all points had a match
+end
+
+"""
+    _equals_curves(c1, c2, closed_type1, closed_type2)::Bool
+
+Two curves are equal if they share the same set of point, representing the same
+geometry. Both curves must must be composed of the same set of points, however,
+they do not have to wind in the same direction, or start on the same point to be
+equivalent.
+Inputs:
+    c1 first geometry
+    c2 second geometry
+    closed_type1::Bool true if c1 is closed by definition (polygon, linear ring)
+    closed_type2::Bool true if c2 is closed by definition (polygon, linear ring)
+"""
+function _equals_curves(c1, c2, closed_type1, closed_type2)

Check if both curves are closed or not

julia
    n1 = GI.npoint(c1)
+    n2 = GI.npoint(c2)
+    c1_repeat_point = GI.getpoint(c1, 1) == GI.getpoint(c1, n1)
+    n2 = GI.npoint(c2)
+    c2_repeat_point = GI.getpoint(c2, 1) == GI.getpoint(c2, n2)
+    closed1 = closed_type1 || c1_repeat_point
+    closed2 = closed_type2 || c2_repeat_point
+    closed1 == closed2 || return false

How many points in each curve

julia
    n1 -= c1_repeat_point ? 1 : 0
+    n2 -= c2_repeat_point ? 1 : 0
+    n1 == n2 || return false
+    n1 == 0 && return true

Find offset between curves

julia
    jstart = nothing
+    p1 = GI.getpoint(c1, 1)
+    for i in 1:n2
+        if equals(p1, GI.getpoint(c2, i))
+            jstart = i
+            break
+        end
+    end

no point matches the first point

julia
    isnothing(jstart) && return false

found match for only point

julia
    n1 == 1 && return true

if isn't closed and first or last point don't match, not same curve

julia
    !closed_type1 && (jstart != 1 && jstart != n1) && return false

Check if curves are going in same direction

julia
    i = 2
+    j = jstart + 1
+    j -= j > n2 ? n2 : 0
+    same_direction = equals(GI.getpoint(c1, i), GI.getpoint(c2, j))

if only 2 points, we have already compared both

julia
    n1 == 2 && return same_direction

Check all remaining points are the same wrapping around line

julia
    jstep = same_direction ? 1 : -1
+    for i in 2:n1
+        ip = GI.getpoint(c1, i)
+        j = jstart + (i - 1) * jstep
+        j += (0 < j <= n2) ? 0 : (n2 * -jstep)
+        jp = GI.getpoint(c2, j)
+        equals(ip, jp) || return false
+    end
+    return true
+end
+
+"""
+    equals(
+        ::Union{GI.LineTrait, GI.LineStringTrait}, l1,
+        ::Union{GI.LineTrait, GI.LineStringTrait}, l2,
+    )::Bool
+
+Two lines/linestrings are equal if they share the same set of points going
+along the curve. Note that lines/linestrings aren't closed by definition.
+"""
+equals(
+    ::Union{GI.LineTrait, GI.LineStringTrait}, l1,
+    ::Union{GI.LineTrait, GI.LineStringTrait}, l2,
+) = _equals_curves(l1, l2, false, false)
+
+"""
+    equals(
+        ::Union{GI.LineTrait, GI.LineStringTrait}, l1,
+        ::GI.LinearRingTrait, l2,
+    )::Bool
+
+A line/linestring and a linear ring are equal if they share the same set of
+points going along the curve. Note that lines aren't closed by definition, but
+rings are, so the line must have a repeated last point to be equal
+"""
+equals(
+    ::Union{GI.LineTrait, GI.LineStringTrait}, l1,
+    ::GI.LinearRingTrait, l2,
+) = _equals_curves(l1, l2, false, true)
+
+"""
+    equals(
+        ::GI.LinearRingTrait, l1,
+        ::Union{GI.LineTrait, GI.LineStringTrait}, l2,
+    )::Bool
+
+A linear ring and a line/linestring are equal if they share the same set of
+points going along the curve. Note that lines aren't closed by definition, but
+rings are, so the line must have a repeated last point to be equal
+"""
+equals(
+    ::GI.LinearRingTrait, l1,
+    ::Union{GI.LineTrait, GI.LineStringTrait}, l2,
+) = _equals_curves(l1, l2, true, false)
+
+"""
+    equals(
+        ::GI.LinearRingTrait, l1,
+        ::GI.LinearRingTrait, l2,
+    )::Bool
+
+Two linear rings are equal if they share the same set of points going along the
+curve. Note that rings are closed by definition, so they can have, but don't
+need, a repeated last point to be equal.
+"""
+equals(
+    ::GI.LinearRingTrait, l1,
+    ::GI.LinearRingTrait, l2,
+) = _equals_curves(l1, l2, true, true)
+
+"""
+    equals(::GI.PolygonTrait, geom_a, ::GI.PolygonTrait, geom_b)::Bool
+
+Two polygons are equal if they share the same exterior edge and holes.
+"""
+function equals(::GI.PolygonTrait, geom_a, ::GI.PolygonTrait, geom_b)

Check if exterior is equal

julia
    _equals_curves(
+        GI.getexterior(geom_a), GI.getexterior(geom_b),
+        true, true,  # linear rings are closed by definition
+    ) || return false

Check if number of holes are equal

julia
    GI.nhole(geom_a) == GI.nhole(geom_b) || return false

Check if holes are equal

julia
    for ihole in GI.gethole(geom_a)
+        has_match = false
+        for jhole in GI.gethole(geom_b)
+            if _equals_curves(
+                ihole, jhole,
+                true, true,  # linear rings are closed by definition
+            )
+                has_match = true
+                break
+            end
+        end
+        has_match || return false
+    end
+    return true
+end
+
+"""
+    equals(::GI.PolygonTrait, geom_a, ::GI.MultiPolygonTrait, geom_b)::Bool
+
+A polygon and a multipolygon are equal if the multipolygon is composed of a
+single polygon that is equivalent to the given polygon.
+"""
+function equals(::GI.PolygonTrait, geom_a, ::MultiPolygonTrait, geom_b)
+    GI.npolygon(geom_b) == 1 || return false
+    return equals(geom_a, GI.getpolygon(geom_b, 1))
+end
+
+"""
+    equals(::GI.MultiPolygonTrait, geom_a, ::GI.PolygonTrait, geom_b)::Bool
+
+A polygon and a multipolygon are equal if the multipolygon is composed of a
+single polygon that is equivalent to the given polygon.
+"""
+equals(trait_a::GI.MultiPolygonTrait, geom_a, trait_b::PolygonTrait, geom_b) =
+    equals(trait_b, geom_b, trait_a, geom_a)
+
+"""
+    equals(::GI.PolygonTrait, geom_a, ::GI.PolygonTrait, geom_b)::Bool
+
+Two multipolygons are equal if they share the same set of polygons.
+"""
+function equals(::GI.MultiPolygonTrait, geom_a, ::GI.MultiPolygonTrait, geom_b)

Check if same number of polygons

julia
    GI.npolygon(geom_a) == GI.npolygon(geom_b) || return false

Check if each polygon has a matching polygon

julia
    for poly_a in GI.getpolygon(geom_a)
+        has_match = false
+        for poly_b in GI.getpolygon(geom_b)
+            if equals(poly_a, poly_b)
+                has_match = true
+                break
+            end
+        end
+        has_match || return false
+    end
+    return true
+end

This page was generated using Literate.jl.

`,47)]))}const o=i(p,[["render",h]]);export{F as __pageData,o as default}; diff --git a/previews/PR237/assets/source_methods_equals.md.VAVTT70r.lean.js b/previews/PR237/assets/source_methods_equals.md.VAVTT70r.lean.js new file mode 100644 index 000000000..0e6d81eeb --- /dev/null +++ b/previews/PR237/assets/source_methods_equals.md.VAVTT70r.lean.js @@ -0,0 +1,265 @@ +import{_ as i,c as a,a5 as n,o as l}from"./chunks/framework.Cq8AuEls.js";const t="/GeometryOps.jl/previews/PR237/assets/qhlrwrc.CgiryX2p.png",F=JSON.parse('{"title":"Equals","description":"","frontmatter":{},"headers":[],"relativePath":"source/methods/equals.md","filePath":"source/methods/equals.md","lastUpdated":null}'),p={name:"source/methods/equals.md"};function h(k,s,e,r,d,g){return l(),a("div",null,s[0]||(s[0]=[n(`

Equals

julia
export equals

What is equals?

The equals function checks if two geometries are equal. They are equal if they share the same set of points and edges to define the same shape.

To provide an example, consider these two lines:

julia
import GeometryOps as GO
+import GeoInterface as GI
+using Makie
+using CairoMakie
+
+l1 = GI.LineString([(0.0, 0.0), (0.0, 10.0)])
+l2 = GI.LineString([(0.0, -10.0), (0.0, 3.0)])
+f, a, p = lines(GI.getpoint(l1), color = :blue)
+scatter!(GI.getpoint(l1), color = :blue)
+lines!(GI.getpoint(l2), color = :orange)
+scatter!(GI.getpoint(l2), color = :orange)
+f

We can see that the two lines do not share a common set of points and edges in the plot, so they are not equal:

julia
GO.equals(l1, l2)  # returns false
false

Implementation

This is the GeoInterface-compatible implementation.

First, we implement a wrapper method that dispatches to the correct implementation based on the geometry trait. This is also used in the implementation, since it's a lot less work!

Note that while we need the same set of points and edges, they don't need to be provided in the same order for polygons. For for example, we need the same set points for two multipoints to be equal, but they don't have to be saved in the same order. The winding order also doesn't have to be the same to represent the same geometry. This requires checking every point against every other point in the two geometries we are comparing. Also, some geometries must be "closed" like polygons and linear rings. These will be assumed to be closed, even if they don't have a repeated last point explicitly written in the coordinates. Additionally, geometries and multi-geometries can be equal if the multi-geometry only includes that single geometry.

julia
"""
+    equals(geom1, geom2)::Bool
+
+Compare two Geometries return true if they are the same geometry.
+
+# Examples
+\`\`\`jldoctest
+import GeometryOps as GO, GeoInterface as GI
+poly1 = GI.Polygon([[(0,0), (0,5), (5,5), (5,0), (0,0)]])
+poly2 = GI.Polygon([[(0,0), (0,5), (5,5), (5,0), (0,0)]])
+
+GO.equals(poly1, poly2)

output

julia
true
+\`\`\`
+"""
+equals(geom_a, geom_b) = equals(
+    GI.trait(geom_a), geom_a,
+    GI.trait(geom_b), geom_b,
+)
+
+"""
+    equals(::T, geom_a, ::T, geom_b)::Bool
+
+Two geometries of the same type, which don't have a equals function to dispatch
+off of should throw an error.
+"""
+equals(::T, geom_a, ::T, geom_b) where T = error("Cant compare $T yet")
+
+"""
+    equals(trait_a, geom_a, trait_b, geom_b)
+
+Two geometries which are not of the same type cannot be equal so they always
+return false.
+"""
+equals(trait_a, geom_a, trait_b, geom_b) = false
+
+"""
+    equals(::GI.PointTrait, p1, ::GI.PointTrait, p2)::Bool
+
+Two points are the same if they have the same x and y (and z if 3D) coordinates.
+"""
+function equals(::GI.PointTrait, p1, ::GI.PointTrait, p2)
+    GI.ncoord(p1) == GI.ncoord(p2) || return false
+    GI.x(p1) == GI.x(p2) || return false
+    GI.y(p1) == GI.y(p2) || return false
+    if GI.is3d(p1)
+        GI.z(p1) == GI.z(p2) || return false
+    end
+    return true
+end
+
+"""
+    equals(::GI.PointTrait, p1, ::GI.MultiPointTrait, mp2)::Bool
+
+A point and a multipoint are equal if the multipoint is composed of a single
+point that is equivalent to the given point.
+"""
+function equals(::GI.PointTrait, p1, ::GI.MultiPointTrait, mp2)
+    GI.npoint(mp2) == 1 || return false
+    return equals(p1, GI.getpoint(mp2, 1))
+end
+
+"""
+    equals(::GI.MultiPointTrait, mp1, ::GI.PointTrait, p2)::Bool
+
+A point and a multipoint are equal if the multipoint is composed of a single
+point that is equivalent to the given point.
+"""
+equals(trait1::GI.MultiPointTrait, mp1, trait2::GI.PointTrait, p2) =
+    equals(trait2, p2, trait1, mp1)
+
+"""
+    equals(::GI.MultiPointTrait, mp1, ::GI.MultiPointTrait, mp2)::Bool
+
+Two multipoints are equal if they share the same set of points.
+"""
+function equals(::GI.MultiPointTrait, mp1, ::GI.MultiPointTrait, mp2)
+    GI.npoint(mp1) == GI.npoint(mp2) || return false
+    for p1 in GI.getpoint(mp1)
+        has_match = false  # if point has a matching point in other multipoint
+        for p2 in GI.getpoint(mp2)
+            if equals(p1, p2)
+                has_match = true
+                break
+            end
+        end
+        has_match || return false  # if no matching point, can't be equal
+    end
+    return true  # all points had a match
+end
+
+"""
+    _equals_curves(c1, c2, closed_type1, closed_type2)::Bool
+
+Two curves are equal if they share the same set of point, representing the same
+geometry. Both curves must must be composed of the same set of points, however,
+they do not have to wind in the same direction, or start on the same point to be
+equivalent.
+Inputs:
+    c1 first geometry
+    c2 second geometry
+    closed_type1::Bool true if c1 is closed by definition (polygon, linear ring)
+    closed_type2::Bool true if c2 is closed by definition (polygon, linear ring)
+"""
+function _equals_curves(c1, c2, closed_type1, closed_type2)

Check if both curves are closed or not

julia
    n1 = GI.npoint(c1)
+    n2 = GI.npoint(c2)
+    c1_repeat_point = GI.getpoint(c1, 1) == GI.getpoint(c1, n1)
+    n2 = GI.npoint(c2)
+    c2_repeat_point = GI.getpoint(c2, 1) == GI.getpoint(c2, n2)
+    closed1 = closed_type1 || c1_repeat_point
+    closed2 = closed_type2 || c2_repeat_point
+    closed1 == closed2 || return false

How many points in each curve

julia
    n1 -= c1_repeat_point ? 1 : 0
+    n2 -= c2_repeat_point ? 1 : 0
+    n1 == n2 || return false
+    n1 == 0 && return true

Find offset between curves

julia
    jstart = nothing
+    p1 = GI.getpoint(c1, 1)
+    for i in 1:n2
+        if equals(p1, GI.getpoint(c2, i))
+            jstart = i
+            break
+        end
+    end

no point matches the first point

julia
    isnothing(jstart) && return false

found match for only point

julia
    n1 == 1 && return true

if isn't closed and first or last point don't match, not same curve

julia
    !closed_type1 && (jstart != 1 && jstart != n1) && return false

Check if curves are going in same direction

julia
    i = 2
+    j = jstart + 1
+    j -= j > n2 ? n2 : 0
+    same_direction = equals(GI.getpoint(c1, i), GI.getpoint(c2, j))

if only 2 points, we have already compared both

julia
    n1 == 2 && return same_direction

Check all remaining points are the same wrapping around line

julia
    jstep = same_direction ? 1 : -1
+    for i in 2:n1
+        ip = GI.getpoint(c1, i)
+        j = jstart + (i - 1) * jstep
+        j += (0 < j <= n2) ? 0 : (n2 * -jstep)
+        jp = GI.getpoint(c2, j)
+        equals(ip, jp) || return false
+    end
+    return true
+end
+
+"""
+    equals(
+        ::Union{GI.LineTrait, GI.LineStringTrait}, l1,
+        ::Union{GI.LineTrait, GI.LineStringTrait}, l2,
+    )::Bool
+
+Two lines/linestrings are equal if they share the same set of points going
+along the curve. Note that lines/linestrings aren't closed by definition.
+"""
+equals(
+    ::Union{GI.LineTrait, GI.LineStringTrait}, l1,
+    ::Union{GI.LineTrait, GI.LineStringTrait}, l2,
+) = _equals_curves(l1, l2, false, false)
+
+"""
+    equals(
+        ::Union{GI.LineTrait, GI.LineStringTrait}, l1,
+        ::GI.LinearRingTrait, l2,
+    )::Bool
+
+A line/linestring and a linear ring are equal if they share the same set of
+points going along the curve. Note that lines aren't closed by definition, but
+rings are, so the line must have a repeated last point to be equal
+"""
+equals(
+    ::Union{GI.LineTrait, GI.LineStringTrait}, l1,
+    ::GI.LinearRingTrait, l2,
+) = _equals_curves(l1, l2, false, true)
+
+"""
+    equals(
+        ::GI.LinearRingTrait, l1,
+        ::Union{GI.LineTrait, GI.LineStringTrait}, l2,
+    )::Bool
+
+A linear ring and a line/linestring are equal if they share the same set of
+points going along the curve. Note that lines aren't closed by definition, but
+rings are, so the line must have a repeated last point to be equal
+"""
+equals(
+    ::GI.LinearRingTrait, l1,
+    ::Union{GI.LineTrait, GI.LineStringTrait}, l2,
+) = _equals_curves(l1, l2, true, false)
+
+"""
+    equals(
+        ::GI.LinearRingTrait, l1,
+        ::GI.LinearRingTrait, l2,
+    )::Bool
+
+Two linear rings are equal if they share the same set of points going along the
+curve. Note that rings are closed by definition, so they can have, but don't
+need, a repeated last point to be equal.
+"""
+equals(
+    ::GI.LinearRingTrait, l1,
+    ::GI.LinearRingTrait, l2,
+) = _equals_curves(l1, l2, true, true)
+
+"""
+    equals(::GI.PolygonTrait, geom_a, ::GI.PolygonTrait, geom_b)::Bool
+
+Two polygons are equal if they share the same exterior edge and holes.
+"""
+function equals(::GI.PolygonTrait, geom_a, ::GI.PolygonTrait, geom_b)

Check if exterior is equal

julia
    _equals_curves(
+        GI.getexterior(geom_a), GI.getexterior(geom_b),
+        true, true,  # linear rings are closed by definition
+    ) || return false

Check if number of holes are equal

julia
    GI.nhole(geom_a) == GI.nhole(geom_b) || return false

Check if holes are equal

julia
    for ihole in GI.gethole(geom_a)
+        has_match = false
+        for jhole in GI.gethole(geom_b)
+            if _equals_curves(
+                ihole, jhole,
+                true, true,  # linear rings are closed by definition
+            )
+                has_match = true
+                break
+            end
+        end
+        has_match || return false
+    end
+    return true
+end
+
+"""
+    equals(::GI.PolygonTrait, geom_a, ::GI.MultiPolygonTrait, geom_b)::Bool
+
+A polygon and a multipolygon are equal if the multipolygon is composed of a
+single polygon that is equivalent to the given polygon.
+"""
+function equals(::GI.PolygonTrait, geom_a, ::MultiPolygonTrait, geom_b)
+    GI.npolygon(geom_b) == 1 || return false
+    return equals(geom_a, GI.getpolygon(geom_b, 1))
+end
+
+"""
+    equals(::GI.MultiPolygonTrait, geom_a, ::GI.PolygonTrait, geom_b)::Bool
+
+A polygon and a multipolygon are equal if the multipolygon is composed of a
+single polygon that is equivalent to the given polygon.
+"""
+equals(trait_a::GI.MultiPolygonTrait, geom_a, trait_b::PolygonTrait, geom_b) =
+    equals(trait_b, geom_b, trait_a, geom_a)
+
+"""
+    equals(::GI.PolygonTrait, geom_a, ::GI.PolygonTrait, geom_b)::Bool
+
+Two multipolygons are equal if they share the same set of polygons.
+"""
+function equals(::GI.MultiPolygonTrait, geom_a, ::GI.MultiPolygonTrait, geom_b)

Check if same number of polygons

julia
    GI.npolygon(geom_a) == GI.npolygon(geom_b) || return false

Check if each polygon has a matching polygon

julia
    for poly_a in GI.getpolygon(geom_a)
+        has_match = false
+        for poly_b in GI.getpolygon(geom_b)
+            if equals(poly_a, poly_b)
+                has_match = true
+                break
+            end
+        end
+        has_match || return false
+    end
+    return true
+end

This page was generated using Literate.jl.

`,47)]))}const o=i(p,[["render",h]]);export{F as __pageData,o as default}; diff --git a/previews/PR237/assets/source_methods_geom_relations_contains.md.BFVDAiB9.js b/previews/PR237/assets/source_methods_geom_relations_contains.md.BFVDAiB9.js new file mode 100644 index 000000000..d9acdc929 --- /dev/null +++ b/previews/PR237/assets/source_methods_geom_relations_contains.md.BFVDAiB9.js @@ -0,0 +1,33 @@ +import{_ as i,c as a,a5 as n,o as t}from"./chunks/framework.Cq8AuEls.js";const e="/GeometryOps.jl/previews/PR237/assets/xeijnvc._0R9BbFk.png",E=JSON.parse('{"title":"Contains","description":"","frontmatter":{},"headers":[],"relativePath":"source/methods/geom_relations/contains.md","filePath":"source/methods/geom_relations/contains.md","lastUpdated":null}'),h={name:"source/methods/geom_relations/contains.md"};function l(p,s,k,r,o,d){return t(),a("div",null,s[0]||(s[0]=[n(`

Contains

julia
export contains

What is contains?

The contains function checks if a given geometry completely contains another geometry, or in other words, that the second geometry is completely within the first. This requires that the two interiors intersect and that the interior and boundary of the second geometry is not in the exterior of the first geometry.

To provide an example, consider these two lines:

julia
import GeometryOps as GO
+import GeoInterface as GI
+using Makie
+using CairoMakie
+
+l1 = GI.LineString([(0.0, 0.0), (1.0, 0.0), (0.0, 0.1)])
+l2 = GI.LineString([(0.25, 0.0), (0.75, 0.0)])
+f, a, p = lines(GI.getpoint(l1), color = :blue)
+scatter!(GI.getpoint(l1), color = :blue)
+lines!(GI.getpoint(l2), color = :orange)
+scatter!(GI.getpoint(l2), color = :orange)
+f

We can see that all of the points and edges of l2 are within l1, so l1 contains l2. However, l2 does not contain l1.

julia
GO.contains(l1, l2)  # returns true
+GO.contains(l2, l1)  # returns false
false

Implementation

This is the GeoInterface-compatible implementation.

Given that contains is the exact opposite of within, we simply pass the two inputs variables, swapped in order, to within.

julia
"""
+    contains(g1::AbstractGeometry, g2::AbstractGeometry)::Bool
+
+Return true if the second geometry is completely contained by the first
+geometry. The interiors of both geometries must intersect and the interior and
+boundary of the secondary (g2) must not intersect the exterior of the first
+(g1).
+
+\`contains\` returns the exact opposite result of \`within\`.
+
+# Examples
+
+\`\`\`jldoctest
+import GeometryOps as GO, GeoInterface as GI
+line = GI.LineString([(1, 1), (1, 2), (1, 3), (1, 4)])
+point = GI.Point((1, 2))
+
+GO.contains(line, point)

output

julia
true
+\`\`\`
+"""
+contains(g1, g2) = GeometryOps.within(g2, g1)

This page was generated using Literate.jl.

`,18)]))}const c=i(h,[["render",l]]);export{E as __pageData,c as default}; diff --git a/previews/PR237/assets/source_methods_geom_relations_contains.md.BFVDAiB9.lean.js b/previews/PR237/assets/source_methods_geom_relations_contains.md.BFVDAiB9.lean.js new file mode 100644 index 000000000..d9acdc929 --- /dev/null +++ b/previews/PR237/assets/source_methods_geom_relations_contains.md.BFVDAiB9.lean.js @@ -0,0 +1,33 @@ +import{_ as i,c as a,a5 as n,o as t}from"./chunks/framework.Cq8AuEls.js";const e="/GeometryOps.jl/previews/PR237/assets/xeijnvc._0R9BbFk.png",E=JSON.parse('{"title":"Contains","description":"","frontmatter":{},"headers":[],"relativePath":"source/methods/geom_relations/contains.md","filePath":"source/methods/geom_relations/contains.md","lastUpdated":null}'),h={name:"source/methods/geom_relations/contains.md"};function l(p,s,k,r,o,d){return t(),a("div",null,s[0]||(s[0]=[n(`

Contains

julia
export contains

What is contains?

The contains function checks if a given geometry completely contains another geometry, or in other words, that the second geometry is completely within the first. This requires that the two interiors intersect and that the interior and boundary of the second geometry is not in the exterior of the first geometry.

To provide an example, consider these two lines:

julia
import GeometryOps as GO
+import GeoInterface as GI
+using Makie
+using CairoMakie
+
+l1 = GI.LineString([(0.0, 0.0), (1.0, 0.0), (0.0, 0.1)])
+l2 = GI.LineString([(0.25, 0.0), (0.75, 0.0)])
+f, a, p = lines(GI.getpoint(l1), color = :blue)
+scatter!(GI.getpoint(l1), color = :blue)
+lines!(GI.getpoint(l2), color = :orange)
+scatter!(GI.getpoint(l2), color = :orange)
+f

We can see that all of the points and edges of l2 are within l1, so l1 contains l2. However, l2 does not contain l1.

julia
GO.contains(l1, l2)  # returns true
+GO.contains(l2, l1)  # returns false
false

Implementation

This is the GeoInterface-compatible implementation.

Given that contains is the exact opposite of within, we simply pass the two inputs variables, swapped in order, to within.

julia
"""
+    contains(g1::AbstractGeometry, g2::AbstractGeometry)::Bool
+
+Return true if the second geometry is completely contained by the first
+geometry. The interiors of both geometries must intersect and the interior and
+boundary of the secondary (g2) must not intersect the exterior of the first
+(g1).
+
+\`contains\` returns the exact opposite result of \`within\`.
+
+# Examples
+
+\`\`\`jldoctest
+import GeometryOps as GO, GeoInterface as GI
+line = GI.LineString([(1, 1), (1, 2), (1, 3), (1, 4)])
+point = GI.Point((1, 2))
+
+GO.contains(line, point)

output

julia
true
+\`\`\`
+"""
+contains(g1, g2) = GeometryOps.within(g2, g1)

This page was generated using Literate.jl.

`,18)]))}const c=i(h,[["render",l]]);export{E as __pageData,c as default}; diff --git a/previews/PR237/assets/source_methods_geom_relations_coveredby.md.CqbNTbTy.js b/previews/PR237/assets/source_methods_geom_relations_coveredby.md.CqbNTbTy.js new file mode 100644 index 000000000..3c9ca5fcb --- /dev/null +++ b/previews/PR237/assets/source_methods_geom_relations_coveredby.md.CqbNTbTy.js @@ -0,0 +1,183 @@ +import{_ as i,c as a,a5 as n,o as e}from"./chunks/framework.Cq8AuEls.js";const l="/GeometryOps.jl/previews/PR237/assets/arirdaj.DC3TvBOO.png",o=JSON.parse('{"title":"CoveredBy","description":"","frontmatter":{},"headers":[],"relativePath":"source/methods/geom_relations/coveredby.md","filePath":"source/methods/geom_relations/coveredby.md","lastUpdated":null}'),h={name:"source/methods/geom_relations/coveredby.md"};function t(p,s,k,r,E,d){return e(),a("div",null,s[0]||(s[0]=[n(`

CoveredBy

julia
export coveredby

What is coveredby?

The coveredby function checks if one geometry is covered by another geometry. This is an extension of within that does not require the interiors of the two geometries to intersect, but still does require that the interior and boundary of the first geometry isn't outside of the second geometry.

To provide an example, consider this point and line:

julia
import GeometryOps as GO
+import GeoInterface as GI
+using Makie
+using CairoMakie
+
+p1 = (0.0, 0.0)
+l1 = GI.Line([p1, (1.0, 1.0)])
+f, a, p = lines(GI.getpoint(l1))
+scatter!(p1, color = :red)
+f

As we can see, p1 is on the endpoint of l1. This means it is not within, but it does meet the definition of coveredby.

julia
GO.coveredby(p1, l1)  # true
true

Implementation

This is the GeoInterface-compatible implementation.

First, we implement a wrapper method that dispatches to the correct implementation based on the geometry trait.

Each of these calls a method in the geom_geom_processors file. The methods in this file determine if the given geometries meet a set of criteria. For the coveredby function and arguments g1 and g2, this criteria is as follows: - points of g1 are allowed to be in the interior of g2 (either through overlap or crossing for lines) - points of g1 are allowed to be on the boundary of g2 - points of g1 are not allowed to be in the exterior of g2 - no points of g1 are required to be in the interior of g2 - no points of g1 are required to be on the boundary of g2 - no points of g1 are required to be in the exterior of g2

The code for the specific implementations is in the geom_geom_processors file.

julia
const COVEREDBY_ALLOWS = (in_allow = true, on_allow = true, out_allow = false)
+const COVEREDBY_CURVE_ALLOWS = (over_allow = true, cross_allow = true, on_allow = true, out_allow = false)
+const COVEREDBY_CURVE_REQUIRES = (in_require = false, on_require = false, out_require = false)
+const COVEREDBY_POLYGON_REQUIRES = (in_require = true, on_require = false, out_require = false,)
+const COVEREDBY_EXACT = (exact = _False(),)
+
+"""
+    coveredby(g1, g2)::Bool
+
+Return \`true\` if the first geometry is completely covered by the second
+geometry. The interior and boundary of the primary geometry (g1) must not
+intersect the exterior of the secondary geometry (g2).
+
+Furthermore, \`coveredby\` returns the exact opposite result of \`covers\`. They are
+equivalent with the order of the arguments swapped.
+
+# Examples
+\`\`\`jldoctest setup=:(using GeometryOps, GeometryBasics)
+import GeometryOps as GO, GeoInterface as GI
+p1 = GI.Point(0.0, 0.0)
+p2 = GI.Point(1.0, 1.0)
+l1 = GI.Line([p1, p2])
+
+GO.coveredby(p1, l1)

output

julia
true
+\`\`\`
+"""
+coveredby(g1, g2) = _coveredby(trait(g1), g1, trait(g2), g2)

Convert features to geometries

julia
_coveredby(::GI.FeatureTrait, g1, ::Any, g2) = coveredby(GI.geometry(g1), g2)
+_coveredby(::Any, g1, t2::GI.FeatureTrait, g2) = coveredby(g1, GI.geometry(g2))
+_coveredby(::FeatureTrait, g1, ::FeatureTrait, g2) = coveredby(GI.geometry(g1), GI.geometry(g2))

Points coveredby geometries

Point is coveredby another point if those points are equal

julia
_coveredby(
+    ::GI.PointTrait, g1,
+    ::GI.PointTrait, g2,
+) = equals(g1, g2)

Point is coveredby a line/linestring if it is on a line vertex or an edge

julia
_coveredby(
+    ::GI.PointTrait, g1,
+    ::Union{GI.LineTrait, GI.LineStringTrait}, g2,
+) = _point_curve_process(
+    g1, g2;
+    COVEREDBY_ALLOWS...,
+    closed_curve = false,
+)

Point is coveredby a linearring if it is on a vertex or an edge of ring

julia
_coveredby(
+    ::GI.PointTrait, g1,
+    ::GI.LinearRingTrait, g2,
+) = _point_curve_process(
+    g1, g2;
+    COVEREDBY_ALLOWS...,
+    closed_curve = true,
+)

Point is coveredby a polygon if it is inside polygon, including edges/vertices

julia
_coveredby(
+    ::GI.PointTrait, g1,
+    ::GI.PolygonTrait, g2,
+) = _point_polygon_process(
+    g1, g2;
+    COVEREDBY_ALLOWS...,
+    COVEREDBY_EXACT...,
+)

Points cannot cover any geometry other than points

julia
_coveredby(
+    ::Union{GI.AbstractCurveTrait, GI.PolygonTrait}, g1,
+    ::GI.PointTrait, g2,
+) = false

Lines coveredby geometries

julia
#= Linestring is coveredby a line if all interior and boundary points of the
+first line are on the interior/boundary points of the second line. =#
+_coveredby(
+    ::Union{GI.LineTrait, GI.LineStringTrait}, g1,
+    ::Union{GI.LineTrait, GI.LineStringTrait}, g2,
+) = _line_curve_process(
+    g1, g2;
+    COVEREDBY_CURVE_ALLOWS...,
+    COVEREDBY_CURVE_REQUIRES...,
+    COVEREDBY_EXACT...,
+    closed_line = false,
+    closed_curve = false,
+)
+
+#= Linestring is coveredby a ring if all interior and boundary points of the
+line are on the edges of the ring. =#
+_coveredby(
+    ::Union{GI.LineTrait, GI.LineStringTrait}, g1,
+    ::GI.LinearRingTrait, g2,
+) = _line_curve_process(
+    g1, g2;
+    COVEREDBY_CURVE_ALLOWS...,
+    COVEREDBY_CURVE_REQUIRES...,
+    COVEREDBY_EXACT...,
+    closed_line = false,
+    closed_curve = true,
+)
+
+#= Linestring is coveredby a polygon if all interior and boundary points of the
+line are in the polygon interior or on its edges, including hole edges. =#
+_coveredby(
+    ::Union{GI.LineTrait, GI.LineStringTrait}, g1,
+    ::GI.PolygonTrait, g2,
+) = _line_polygon_process(
+    g1, g2;
+    COVEREDBY_ALLOWS...,
+    COVEREDBY_CURVE_REQUIRES...,
+    COVEREDBY_EXACT...,
+    closed_line = false,
+)

Rings covered by geometries

julia
#= Linearring is covered by a line if all vertices and edges of the ring are on
+the edges and vertices of the line. =#
+_coveredby(
+    ::GI.LinearRingTrait, g1,
+    ::Union{GI.LineTrait, GI.LineStringTrait}, g2,
+) = _line_curve_process(
+    g1, g2;
+    COVEREDBY_CURVE_ALLOWS...,
+    COVEREDBY_CURVE_REQUIRES...,
+    COVEREDBY_EXACT...,
+    closed_line = true,
+    closed_curve = false,
+)
+
+#= Linearring is covered by another linear ring if all vertices and edges of the
+first ring are on the edges/vertices of the second ring. =#
+_coveredby(
+    ::GI.LinearRingTrait, g1,
+    ::GI.LinearRingTrait, g2,
+) = _line_curve_process(
+    g1, g2;
+    COVEREDBY_CURVE_ALLOWS...,
+    COVEREDBY_CURVE_REQUIRES...,
+    COVEREDBY_EXACT...,
+    closed_line = true,
+    closed_curve = true,
+)
+
+#= Linearring is coveredby a polygon if all vertices and edges of the ring are
+in the polygon interior or on the polygon edges, including hole edges. =#
+_coveredby(
+    ::GI.LinearRingTrait, g1,
+    ::GI.PolygonTrait, g2,
+) = _line_polygon_process(
+    g1, g2;
+    COVEREDBY_ALLOWS...,
+    COVEREDBY_CURVE_REQUIRES...,
+    COVEREDBY_EXACT...,
+    closed_line = true,
+)

Polygons covered by geometries

julia
#= Polygon is covered by another polygon if if the interior and edges of the
+first polygon are in the second polygon interior or on polygon edges, including
+hole edges.=#
+_coveredby(
+    ::GI.PolygonTrait, g1,
+    ::GI.PolygonTrait, g2,
+) = _polygon_polygon_process(
+    g1, g2;
+    COVEREDBY_ALLOWS...,
+    COVEREDBY_POLYGON_REQUIRES...,
+    COVEREDBY_EXACT...,
+)

Polygons cannot covered by any curves

julia
_coveredby(
+    ::GI.PolygonTrait, g1,
+    ::GI.AbstractCurveTrait, g2,
+) = false

Geometries coveredby multi-geometry/geometry collections

julia
#= Geometry is covered by a multi-geometry or a collection if one of the elements
+of the collection cover the geometry. =#
+function _coveredby(
+    ::Union{GI.PointTrait, GI.AbstractCurveTrait, GI.PolygonTrait}, g1,
+    ::Union{
+        GI.MultiPointTrait, GI.AbstractMultiCurveTrait,
+        GI.MultiPolygonTrait, GI.GeometryCollectionTrait,
+    }, g2,
+)
+    for sub_g2 in GI.getgeom(g2)
+        coveredby(g1, sub_g2) && return true
+    end
+    return false
+end

Multi-geometry/geometry collections coveredby geometries

julia
#= Multi-geometry or a geometry collection is covered by a geometry if all
+elements of the collection are covered by the geometry. =#
+function _coveredby(
+    ::Union{
+        GI.MultiPointTrait, GI.AbstractMultiCurveTrait,
+        GI.MultiPolygonTrait, GI.GeometryCollectionTrait,
+    }, g1,
+    ::GI.AbstractGeometryTrait, g2,
+)
+    for sub_g1 in GI.getgeom(g1)
+        !coveredby(sub_g1, g2) && return false
+    end
+    return true
+end

This page was generated using Literate.jl.

`,45)]))}const y=i(h,[["render",t]]);export{o as __pageData,y as default}; diff --git a/previews/PR237/assets/source_methods_geom_relations_coveredby.md.CqbNTbTy.lean.js b/previews/PR237/assets/source_methods_geom_relations_coveredby.md.CqbNTbTy.lean.js new file mode 100644 index 000000000..3c9ca5fcb --- /dev/null +++ b/previews/PR237/assets/source_methods_geom_relations_coveredby.md.CqbNTbTy.lean.js @@ -0,0 +1,183 @@ +import{_ as i,c as a,a5 as n,o as e}from"./chunks/framework.Cq8AuEls.js";const l="/GeometryOps.jl/previews/PR237/assets/arirdaj.DC3TvBOO.png",o=JSON.parse('{"title":"CoveredBy","description":"","frontmatter":{},"headers":[],"relativePath":"source/methods/geom_relations/coveredby.md","filePath":"source/methods/geom_relations/coveredby.md","lastUpdated":null}'),h={name:"source/methods/geom_relations/coveredby.md"};function t(p,s,k,r,E,d){return e(),a("div",null,s[0]||(s[0]=[n(`

CoveredBy

julia
export coveredby

What is coveredby?

The coveredby function checks if one geometry is covered by another geometry. This is an extension of within that does not require the interiors of the two geometries to intersect, but still does require that the interior and boundary of the first geometry isn't outside of the second geometry.

To provide an example, consider this point and line:

julia
import GeometryOps as GO
+import GeoInterface as GI
+using Makie
+using CairoMakie
+
+p1 = (0.0, 0.0)
+l1 = GI.Line([p1, (1.0, 1.0)])
+f, a, p = lines(GI.getpoint(l1))
+scatter!(p1, color = :red)
+f

As we can see, p1 is on the endpoint of l1. This means it is not within, but it does meet the definition of coveredby.

julia
GO.coveredby(p1, l1)  # true
true

Implementation

This is the GeoInterface-compatible implementation.

First, we implement a wrapper method that dispatches to the correct implementation based on the geometry trait.

Each of these calls a method in the geom_geom_processors file. The methods in this file determine if the given geometries meet a set of criteria. For the coveredby function and arguments g1 and g2, this criteria is as follows: - points of g1 are allowed to be in the interior of g2 (either through overlap or crossing for lines) - points of g1 are allowed to be on the boundary of g2 - points of g1 are not allowed to be in the exterior of g2 - no points of g1 are required to be in the interior of g2 - no points of g1 are required to be on the boundary of g2 - no points of g1 are required to be in the exterior of g2

The code for the specific implementations is in the geom_geom_processors file.

julia
const COVEREDBY_ALLOWS = (in_allow = true, on_allow = true, out_allow = false)
+const COVEREDBY_CURVE_ALLOWS = (over_allow = true, cross_allow = true, on_allow = true, out_allow = false)
+const COVEREDBY_CURVE_REQUIRES = (in_require = false, on_require = false, out_require = false)
+const COVEREDBY_POLYGON_REQUIRES = (in_require = true, on_require = false, out_require = false,)
+const COVEREDBY_EXACT = (exact = _False(),)
+
+"""
+    coveredby(g1, g2)::Bool
+
+Return \`true\` if the first geometry is completely covered by the second
+geometry. The interior and boundary of the primary geometry (g1) must not
+intersect the exterior of the secondary geometry (g2).
+
+Furthermore, \`coveredby\` returns the exact opposite result of \`covers\`. They are
+equivalent with the order of the arguments swapped.
+
+# Examples
+\`\`\`jldoctest setup=:(using GeometryOps, GeometryBasics)
+import GeometryOps as GO, GeoInterface as GI
+p1 = GI.Point(0.0, 0.0)
+p2 = GI.Point(1.0, 1.0)
+l1 = GI.Line([p1, p2])
+
+GO.coveredby(p1, l1)

output

julia
true
+\`\`\`
+"""
+coveredby(g1, g2) = _coveredby(trait(g1), g1, trait(g2), g2)

Convert features to geometries

julia
_coveredby(::GI.FeatureTrait, g1, ::Any, g2) = coveredby(GI.geometry(g1), g2)
+_coveredby(::Any, g1, t2::GI.FeatureTrait, g2) = coveredby(g1, GI.geometry(g2))
+_coveredby(::FeatureTrait, g1, ::FeatureTrait, g2) = coveredby(GI.geometry(g1), GI.geometry(g2))

Points coveredby geometries

Point is coveredby another point if those points are equal

julia
_coveredby(
+    ::GI.PointTrait, g1,
+    ::GI.PointTrait, g2,
+) = equals(g1, g2)

Point is coveredby a line/linestring if it is on a line vertex or an edge

julia
_coveredby(
+    ::GI.PointTrait, g1,
+    ::Union{GI.LineTrait, GI.LineStringTrait}, g2,
+) = _point_curve_process(
+    g1, g2;
+    COVEREDBY_ALLOWS...,
+    closed_curve = false,
+)

Point is coveredby a linearring if it is on a vertex or an edge of ring

julia
_coveredby(
+    ::GI.PointTrait, g1,
+    ::GI.LinearRingTrait, g2,
+) = _point_curve_process(
+    g1, g2;
+    COVEREDBY_ALLOWS...,
+    closed_curve = true,
+)

Point is coveredby a polygon if it is inside polygon, including edges/vertices

julia
_coveredby(
+    ::GI.PointTrait, g1,
+    ::GI.PolygonTrait, g2,
+) = _point_polygon_process(
+    g1, g2;
+    COVEREDBY_ALLOWS...,
+    COVEREDBY_EXACT...,
+)

Points cannot cover any geometry other than points

julia
_coveredby(
+    ::Union{GI.AbstractCurveTrait, GI.PolygonTrait}, g1,
+    ::GI.PointTrait, g2,
+) = false

Lines coveredby geometries

julia
#= Linestring is coveredby a line if all interior and boundary points of the
+first line are on the interior/boundary points of the second line. =#
+_coveredby(
+    ::Union{GI.LineTrait, GI.LineStringTrait}, g1,
+    ::Union{GI.LineTrait, GI.LineStringTrait}, g2,
+) = _line_curve_process(
+    g1, g2;
+    COVEREDBY_CURVE_ALLOWS...,
+    COVEREDBY_CURVE_REQUIRES...,
+    COVEREDBY_EXACT...,
+    closed_line = false,
+    closed_curve = false,
+)
+
+#= Linestring is coveredby a ring if all interior and boundary points of the
+line are on the edges of the ring. =#
+_coveredby(
+    ::Union{GI.LineTrait, GI.LineStringTrait}, g1,
+    ::GI.LinearRingTrait, g2,
+) = _line_curve_process(
+    g1, g2;
+    COVEREDBY_CURVE_ALLOWS...,
+    COVEREDBY_CURVE_REQUIRES...,
+    COVEREDBY_EXACT...,
+    closed_line = false,
+    closed_curve = true,
+)
+
+#= Linestring is coveredby a polygon if all interior and boundary points of the
+line are in the polygon interior or on its edges, including hole edges. =#
+_coveredby(
+    ::Union{GI.LineTrait, GI.LineStringTrait}, g1,
+    ::GI.PolygonTrait, g2,
+) = _line_polygon_process(
+    g1, g2;
+    COVEREDBY_ALLOWS...,
+    COVEREDBY_CURVE_REQUIRES...,
+    COVEREDBY_EXACT...,
+    closed_line = false,
+)

Rings covered by geometries

julia
#= Linearring is covered by a line if all vertices and edges of the ring are on
+the edges and vertices of the line. =#
+_coveredby(
+    ::GI.LinearRingTrait, g1,
+    ::Union{GI.LineTrait, GI.LineStringTrait}, g2,
+) = _line_curve_process(
+    g1, g2;
+    COVEREDBY_CURVE_ALLOWS...,
+    COVEREDBY_CURVE_REQUIRES...,
+    COVEREDBY_EXACT...,
+    closed_line = true,
+    closed_curve = false,
+)
+
+#= Linearring is covered by another linear ring if all vertices and edges of the
+first ring are on the edges/vertices of the second ring. =#
+_coveredby(
+    ::GI.LinearRingTrait, g1,
+    ::GI.LinearRingTrait, g2,
+) = _line_curve_process(
+    g1, g2;
+    COVEREDBY_CURVE_ALLOWS...,
+    COVEREDBY_CURVE_REQUIRES...,
+    COVEREDBY_EXACT...,
+    closed_line = true,
+    closed_curve = true,
+)
+
+#= Linearring is coveredby a polygon if all vertices and edges of the ring are
+in the polygon interior or on the polygon edges, including hole edges. =#
+_coveredby(
+    ::GI.LinearRingTrait, g1,
+    ::GI.PolygonTrait, g2,
+) = _line_polygon_process(
+    g1, g2;
+    COVEREDBY_ALLOWS...,
+    COVEREDBY_CURVE_REQUIRES...,
+    COVEREDBY_EXACT...,
+    closed_line = true,
+)

Polygons covered by geometries

julia
#= Polygon is covered by another polygon if if the interior and edges of the
+first polygon are in the second polygon interior or on polygon edges, including
+hole edges.=#
+_coveredby(
+    ::GI.PolygonTrait, g1,
+    ::GI.PolygonTrait, g2,
+) = _polygon_polygon_process(
+    g1, g2;
+    COVEREDBY_ALLOWS...,
+    COVEREDBY_POLYGON_REQUIRES...,
+    COVEREDBY_EXACT...,
+)

Polygons cannot covered by any curves

julia
_coveredby(
+    ::GI.PolygonTrait, g1,
+    ::GI.AbstractCurveTrait, g2,
+) = false

Geometries coveredby multi-geometry/geometry collections

julia
#= Geometry is covered by a multi-geometry or a collection if one of the elements
+of the collection cover the geometry. =#
+function _coveredby(
+    ::Union{GI.PointTrait, GI.AbstractCurveTrait, GI.PolygonTrait}, g1,
+    ::Union{
+        GI.MultiPointTrait, GI.AbstractMultiCurveTrait,
+        GI.MultiPolygonTrait, GI.GeometryCollectionTrait,
+    }, g2,
+)
+    for sub_g2 in GI.getgeom(g2)
+        coveredby(g1, sub_g2) && return true
+    end
+    return false
+end

Multi-geometry/geometry collections coveredby geometries

julia
#= Multi-geometry or a geometry collection is covered by a geometry if all
+elements of the collection are covered by the geometry. =#
+function _coveredby(
+    ::Union{
+        GI.MultiPointTrait, GI.AbstractMultiCurveTrait,
+        GI.MultiPolygonTrait, GI.GeometryCollectionTrait,
+    }, g1,
+    ::GI.AbstractGeometryTrait, g2,
+)
+    for sub_g1 in GI.getgeom(g1)
+        !coveredby(sub_g1, g2) && return false
+    end
+    return true
+end

This page was generated using Literate.jl.

`,45)]))}const y=i(h,[["render",t]]);export{o as __pageData,y as default}; diff --git a/previews/PR237/assets/source_methods_geom_relations_covers.md.lXjO6TJl.js b/previews/PR237/assets/source_methods_geom_relations_covers.md.lXjO6TJl.js new file mode 100644 index 000000000..76d80cfa3 --- /dev/null +++ b/previews/PR237/assets/source_methods_geom_relations_covers.md.lXjO6TJl.js @@ -0,0 +1,33 @@ +import{_ as i,c as a,a5 as e,o as n}from"./chunks/framework.Cq8AuEls.js";const t="/GeometryOps.jl/previews/PR237/assets/arirdaj.DC3TvBOO.png",g=JSON.parse('{"title":"Covers","description":"","frontmatter":{},"headers":[],"relativePath":"source/methods/geom_relations/covers.md","filePath":"source/methods/geom_relations/covers.md","lastUpdated":null}'),p={name:"source/methods/geom_relations/covers.md"};function l(h,s,k,r,o,d){return n(),a("div",null,s[0]||(s[0]=[e(`

Covers

julia
export covers

What is covers?

The covers function checks if a given geometry completely covers another geometry. For this to be true, the "contained" geometry's interior and boundaries must be covered by the "covering" geometry's interior and boundaries. The interiors do not need to overlap.

To provide an example, consider these two lines:

julia
import GeometryOps as GO
+import GeoInterface as GI
+using Makie
+using CairoMakie
+
+p1 = (0.0, 0.0)
+p2 = (1.0, 1.0)
+l1 = GI.Line([p1, p2])
+
+f, a, p = lines(GI.getpoint(l1))
+scatter!(p1, color = :red)
+f

julia
GO.covers(l1, p1)  # returns true
+GO.covers(p1, l1)  # returns false
false

Implementation

This is the GeoInterface-compatible implementation.

Given that covers is the exact opposite of coveredby, we simply pass the two inputs variables, swapped in order, to coveredby.

julia
"""
+    covers(g1::AbstractGeometry, g2::AbstractGeometry)::Bool
+
+Return true if the first geometry is completely covers the second geometry,
+The exterior and boundary of the second geometry must not be outside of the
+interior and boundary of the first geometry. However, the interiors need not
+intersect.
+
+\`covers\` returns the exact opposite result of \`coveredby\`.
+
+# Examples
+
+\`\`\`jldoctest
+import GeometryOps as GO, GeoInterface as GI
+l1 = GI.LineString([(1.0, 1.0), (1.0, 2.0), (1.0, 3.0), (1.0, 4.0)])
+l2 = GI.LineString([(1.0, 1.0), (1.0, 2.0)])
+
+GO.covers(l1, l2)

output

julia
true
+\`\`\`
+"""
+covers(g1, g2)::Bool = GeometryOps.coveredby(g2, g1)

This page was generated using Literate.jl.

`,17)]))}const E=i(p,[["render",l]]);export{g as __pageData,E as default}; diff --git a/previews/PR237/assets/source_methods_geom_relations_covers.md.lXjO6TJl.lean.js b/previews/PR237/assets/source_methods_geom_relations_covers.md.lXjO6TJl.lean.js new file mode 100644 index 000000000..76d80cfa3 --- /dev/null +++ b/previews/PR237/assets/source_methods_geom_relations_covers.md.lXjO6TJl.lean.js @@ -0,0 +1,33 @@ +import{_ as i,c as a,a5 as e,o as n}from"./chunks/framework.Cq8AuEls.js";const t="/GeometryOps.jl/previews/PR237/assets/arirdaj.DC3TvBOO.png",g=JSON.parse('{"title":"Covers","description":"","frontmatter":{},"headers":[],"relativePath":"source/methods/geom_relations/covers.md","filePath":"source/methods/geom_relations/covers.md","lastUpdated":null}'),p={name:"source/methods/geom_relations/covers.md"};function l(h,s,k,r,o,d){return n(),a("div",null,s[0]||(s[0]=[e(`

Covers

julia
export covers

What is covers?

The covers function checks if a given geometry completely covers another geometry. For this to be true, the "contained" geometry's interior and boundaries must be covered by the "covering" geometry's interior and boundaries. The interiors do not need to overlap.

To provide an example, consider these two lines:

julia
import GeometryOps as GO
+import GeoInterface as GI
+using Makie
+using CairoMakie
+
+p1 = (0.0, 0.0)
+p2 = (1.0, 1.0)
+l1 = GI.Line([p1, p2])
+
+f, a, p = lines(GI.getpoint(l1))
+scatter!(p1, color = :red)
+f

julia
GO.covers(l1, p1)  # returns true
+GO.covers(p1, l1)  # returns false
false

Implementation

This is the GeoInterface-compatible implementation.

Given that covers is the exact opposite of coveredby, we simply pass the two inputs variables, swapped in order, to coveredby.

julia
"""
+    covers(g1::AbstractGeometry, g2::AbstractGeometry)::Bool
+
+Return true if the first geometry is completely covers the second geometry,
+The exterior and boundary of the second geometry must not be outside of the
+interior and boundary of the first geometry. However, the interiors need not
+intersect.
+
+\`covers\` returns the exact opposite result of \`coveredby\`.
+
+# Examples
+
+\`\`\`jldoctest
+import GeometryOps as GO, GeoInterface as GI
+l1 = GI.LineString([(1.0, 1.0), (1.0, 2.0), (1.0, 3.0), (1.0, 4.0)])
+l2 = GI.LineString([(1.0, 1.0), (1.0, 2.0)])
+
+GO.covers(l1, l2)

output

julia
true
+\`\`\`
+"""
+covers(g1, g2)::Bool = GeometryOps.coveredby(g2, g1)

This page was generated using Literate.jl.

`,17)]))}const E=i(p,[["render",l]]);export{g as __pageData,E as default}; diff --git a/previews/PR237/assets/source_methods_geom_relations_crosses.md.D0wTvJKv.js b/previews/PR237/assets/source_methods_geom_relations_crosses.md.D0wTvJKv.js new file mode 100644 index 000000000..00dc2975d --- /dev/null +++ b/previews/PR237/assets/source_methods_geom_relations_crosses.md.D0wTvJKv.js @@ -0,0 +1,120 @@ +import{_ as i,c as a,a5 as n,o as l}from"./chunks/framework.Cq8AuEls.js";const d=JSON.parse('{"title":"Crossing checks","description":"","frontmatter":{},"headers":[],"relativePath":"source/methods/geom_relations/crosses.md","filePath":"source/methods/geom_relations/crosses.md","lastUpdated":null}'),p={name:"source/methods/geom_relations/crosses.md"};function h(t,s,k,e,r,E){return l(),a("div",null,s[0]||(s[0]=[n(`

Crossing checks

julia
"""
+     crosses(geom1, geom2)::Bool
+
+Return \`true\` if the intersection results in a geometry whose dimension is one less than
+the maximum dimension of the two source geometries and the intersection set is interior to
+both source geometries.
+
+TODO: broken
+
+# Examples
+\`\`\`julia
+import GeoInterface as GI, GeometryOps as GO

TODO: Add working example

julia
\`\`\`
+"""
+crosses(g1, g2)::Bool = crosses(trait(g1), g1, trait(g2), g2)::Bool
+crosses(t1::FeatureTrait, g1, t2, g2)::Bool = crosses(GI.geometry(g1), g2)
+crosses(t1, g1, t2::FeatureTrait, g2)::Bool = crosses(g1, geometry(g2))
+crosses(::MultiPointTrait, g1, ::LineStringTrait, g2)::Bool = multipoint_crosses_line(g1, g2)
+crosses(::MultiPointTrait, g1, ::PolygonTrait, g2)::Bool = multipoint_crosses_poly(g1, g2)
+crosses(::LineStringTrait, g1, ::MultiPointTrait, g2)::Bool = multipoint_crosses_lines(g2, g1)
+crosses(::LineStringTrait, g1, ::PolygonTrait, g2)::Bool = line_crosses_poly(g1, g2)
+crosses(::LineStringTrait, g1, ::LineStringTrait, g2)::Bool = line_crosses_line(g1, g2)
+crosses(::PolygonTrait, g1, ::MultiPointTrait, g2)::Bool = multipoint_crosses_poly(g2, g1)
+crosses(::PolygonTrait, g1, ::LineStringTrait, g2)::Bool = line_crosses_poly(g2, g1)
+
+function multipoint_crosses_line(geom1, geom2)
+    int_point = false
+    ext_point = false
+    i = 1
+    np2 = GI.npoint(geom2)
+
+    while i < GI.npoint(geom1) && !int_point && !ext_point
+        for j in 1:GI.npoint(geom2) - 1
+            exclude_boundary = (j === 1 || j === np2 - 2) ? :none : :both
+            if _point_on_segment(GI.getpoint(geom1, i), (GI.getpoint(geom2, j), GI.getpoint(geom2, j + 1)); exclude_boundary)
+                int_point = true
+            else
+                ext_point = true
+            end
+        end
+        i += 1
+    end
+    return int_point && ext_point
+end
+
+function line_crosses_line(line1, line2)
+    np2 = GI.npoint(line2)
+    if GeometryOps.intersects(line1, line2)
+        for i in 1:GI.npoint(line1) - 1
+            for j in 1:GI.npoint(line2) - 1
+                exclude_boundary = (j === 1 || j === np2 - 2) ? :none : :both
+                pa = GI.getpoint(line1, i)
+                pb = GI.getpoint(line1, i + 1)
+                p = GI.getpoint(line2, j)
+                _point_on_segment(p, (pa, pb); exclude_boundary) && return true
+            end
+        end
+    end
+    return false
+end
+
+function line_crosses_poly(line, poly)
+    for l in flatten(AbstractCurveTrait, poly)
+        intersects(line, l) && return true
+    end
+    return false
+end
+
+function multipoint_crosses_poly(mp, poly)
+    int_point = false
+    ext_point = false
+
+    for p in GI.getpoint(mp)
+        if _point_polygon_process(
+            p, poly;
+            in_allow = true, on_allow = true, out_allow = false, exact = _False()
+        )
+            int_point = true
+        else
+            ext_point = true
+        end
+        int_point && ext_point && return true
+    end
+    return false
+end
+
+#= TODO: Once crosses is swapped over to use the geom relations workflow, can
+delete these helpers. =#
+
+function _point_on_segment(point, (start, stop); exclude_boundary::Symbol=:none)::Bool
+    x, y = GI.x(point), GI.y(point)
+    x1, y1 = GI.x(start), GI.y(start)
+    x2, y2 = GI.x(stop), GI.y(stop)
+
+    dxc = x - x1
+    dyc = y - y1
+    dx1 = x2 - x1
+    dy1 = y2 - y1

TODO use better predicate for crossing here

julia
    cross = dxc * dy1 - dyc * dx1
+    cross != 0 && return false

Will constprop optimise these away?

julia
    if exclude_boundary === :none
+        if abs(dx1) >= abs(dy1)
+            return dx1 > 0 ? x1 <= x && x <= x2 : x2 <= x && x <= x1
+        end
+        return dy1 > 0 ? y1 <= y && y <= y2 : y2 <= y && y <= y1
+    elseif exclude_boundary === :start
+        if abs(dx1) >= abs(dy1)
+             return dx1 > 0 ? x1 < x && x <= x2 : x2 <= x && x < x1
+        end
+        return dy1 > 0 ? y1 < y && y <= y2 : y2 <= y && y < y1
+    elseif exclude_boundary === :end
+        if abs(dx1) >= abs(dy1)
+            return dx1 > 0 ? x1 <= x && x < x2 : x2 < x && x <= x1
+        end
+        return dy1 > 0 ? y1 <= y && y < y2 : y2 < y && y <= y1
+    elseif exclude_boundary === :both
+        if abs(dx1) >= abs(dy1)
+            return dx1 > 0 ? x1 < x && x < x2 : x2 < x && x < x1
+        end
+        return dy1 > 0 ? y1 < y && y < y2 : y2 < y && y < y1
+    end
+    return false
+end

This page was generated using Literate.jl.

`,10)]))}const F=i(p,[["render",h]]);export{d as __pageData,F as default}; diff --git a/previews/PR237/assets/source_methods_geom_relations_crosses.md.D0wTvJKv.lean.js b/previews/PR237/assets/source_methods_geom_relations_crosses.md.D0wTvJKv.lean.js new file mode 100644 index 000000000..00dc2975d --- /dev/null +++ b/previews/PR237/assets/source_methods_geom_relations_crosses.md.D0wTvJKv.lean.js @@ -0,0 +1,120 @@ +import{_ as i,c as a,a5 as n,o as l}from"./chunks/framework.Cq8AuEls.js";const d=JSON.parse('{"title":"Crossing checks","description":"","frontmatter":{},"headers":[],"relativePath":"source/methods/geom_relations/crosses.md","filePath":"source/methods/geom_relations/crosses.md","lastUpdated":null}'),p={name:"source/methods/geom_relations/crosses.md"};function h(t,s,k,e,r,E){return l(),a("div",null,s[0]||(s[0]=[n(`

Crossing checks

julia
"""
+     crosses(geom1, geom2)::Bool
+
+Return \`true\` if the intersection results in a geometry whose dimension is one less than
+the maximum dimension of the two source geometries and the intersection set is interior to
+both source geometries.
+
+TODO: broken
+
+# Examples
+\`\`\`julia
+import GeoInterface as GI, GeometryOps as GO

TODO: Add working example

julia
\`\`\`
+"""
+crosses(g1, g2)::Bool = crosses(trait(g1), g1, trait(g2), g2)::Bool
+crosses(t1::FeatureTrait, g1, t2, g2)::Bool = crosses(GI.geometry(g1), g2)
+crosses(t1, g1, t2::FeatureTrait, g2)::Bool = crosses(g1, geometry(g2))
+crosses(::MultiPointTrait, g1, ::LineStringTrait, g2)::Bool = multipoint_crosses_line(g1, g2)
+crosses(::MultiPointTrait, g1, ::PolygonTrait, g2)::Bool = multipoint_crosses_poly(g1, g2)
+crosses(::LineStringTrait, g1, ::MultiPointTrait, g2)::Bool = multipoint_crosses_lines(g2, g1)
+crosses(::LineStringTrait, g1, ::PolygonTrait, g2)::Bool = line_crosses_poly(g1, g2)
+crosses(::LineStringTrait, g1, ::LineStringTrait, g2)::Bool = line_crosses_line(g1, g2)
+crosses(::PolygonTrait, g1, ::MultiPointTrait, g2)::Bool = multipoint_crosses_poly(g2, g1)
+crosses(::PolygonTrait, g1, ::LineStringTrait, g2)::Bool = line_crosses_poly(g2, g1)
+
+function multipoint_crosses_line(geom1, geom2)
+    int_point = false
+    ext_point = false
+    i = 1
+    np2 = GI.npoint(geom2)
+
+    while i < GI.npoint(geom1) && !int_point && !ext_point
+        for j in 1:GI.npoint(geom2) - 1
+            exclude_boundary = (j === 1 || j === np2 - 2) ? :none : :both
+            if _point_on_segment(GI.getpoint(geom1, i), (GI.getpoint(geom2, j), GI.getpoint(geom2, j + 1)); exclude_boundary)
+                int_point = true
+            else
+                ext_point = true
+            end
+        end
+        i += 1
+    end
+    return int_point && ext_point
+end
+
+function line_crosses_line(line1, line2)
+    np2 = GI.npoint(line2)
+    if GeometryOps.intersects(line1, line2)
+        for i in 1:GI.npoint(line1) - 1
+            for j in 1:GI.npoint(line2) - 1
+                exclude_boundary = (j === 1 || j === np2 - 2) ? :none : :both
+                pa = GI.getpoint(line1, i)
+                pb = GI.getpoint(line1, i + 1)
+                p = GI.getpoint(line2, j)
+                _point_on_segment(p, (pa, pb); exclude_boundary) && return true
+            end
+        end
+    end
+    return false
+end
+
+function line_crosses_poly(line, poly)
+    for l in flatten(AbstractCurveTrait, poly)
+        intersects(line, l) && return true
+    end
+    return false
+end
+
+function multipoint_crosses_poly(mp, poly)
+    int_point = false
+    ext_point = false
+
+    for p in GI.getpoint(mp)
+        if _point_polygon_process(
+            p, poly;
+            in_allow = true, on_allow = true, out_allow = false, exact = _False()
+        )
+            int_point = true
+        else
+            ext_point = true
+        end
+        int_point && ext_point && return true
+    end
+    return false
+end
+
+#= TODO: Once crosses is swapped over to use the geom relations workflow, can
+delete these helpers. =#
+
+function _point_on_segment(point, (start, stop); exclude_boundary::Symbol=:none)::Bool
+    x, y = GI.x(point), GI.y(point)
+    x1, y1 = GI.x(start), GI.y(start)
+    x2, y2 = GI.x(stop), GI.y(stop)
+
+    dxc = x - x1
+    dyc = y - y1
+    dx1 = x2 - x1
+    dy1 = y2 - y1

TODO use better predicate for crossing here

julia
    cross = dxc * dy1 - dyc * dx1
+    cross != 0 && return false

Will constprop optimise these away?

julia
    if exclude_boundary === :none
+        if abs(dx1) >= abs(dy1)
+            return dx1 > 0 ? x1 <= x && x <= x2 : x2 <= x && x <= x1
+        end
+        return dy1 > 0 ? y1 <= y && y <= y2 : y2 <= y && y <= y1
+    elseif exclude_boundary === :start
+        if abs(dx1) >= abs(dy1)
+             return dx1 > 0 ? x1 < x && x <= x2 : x2 <= x && x < x1
+        end
+        return dy1 > 0 ? y1 < y && y <= y2 : y2 <= y && y < y1
+    elseif exclude_boundary === :end
+        if abs(dx1) >= abs(dy1)
+            return dx1 > 0 ? x1 <= x && x < x2 : x2 < x && x <= x1
+        end
+        return dy1 > 0 ? y1 <= y && y < y2 : y2 < y && y <= y1
+    elseif exclude_boundary === :both
+        if abs(dx1) >= abs(dy1)
+            return dx1 > 0 ? x1 < x && x < x2 : x2 < x && x < x1
+        end
+        return dy1 > 0 ? y1 < y && y < y2 : y2 < y && y < y1
+    end
+    return false
+end

This page was generated using Literate.jl.

`,10)]))}const F=i(p,[["render",h]]);export{d as __pageData,F as default}; diff --git a/previews/PR237/assets/source_methods_geom_relations_disjoint.md.D-2b0dzW.js b/previews/PR237/assets/source_methods_geom_relations_disjoint.md.D-2b0dzW.js new file mode 100644 index 000000000..3550d422c --- /dev/null +++ b/previews/PR237/assets/source_methods_geom_relations_disjoint.md.D-2b0dzW.js @@ -0,0 +1,178 @@ +import{_ as i,c as a,a5 as n,o as t}from"./chunks/framework.Cq8AuEls.js";const h="/GeometryOps.jl/previews/PR237/assets/ijvdjav.C3SxJ3x-.png",o=JSON.parse('{"title":"Disjoint","description":"","frontmatter":{},"headers":[],"relativePath":"source/methods/geom_relations/disjoint.md","filePath":"source/methods/geom_relations/disjoint.md","lastUpdated":null}'),l={name:"source/methods/geom_relations/disjoint.md"};function p(k,s,e,r,E,g){return t(),a("div",null,s[0]||(s[0]=[n(`

Disjoint

julia
export disjoint

What is disjoint?

The disjoint function checks if one geometry is outside of another geometry, without sharing any boundaries or interiors.

To provide an example, consider these two lines:

julia
import GeometryOps as GO
+import GeoInterface as GI
+using Makie
+using CairoMakie
+
+l1 = GI.LineString([(0.0, 0.0), (1.0, 0.0), (0.0, 0.1)])
+l2 = GI.LineString([(2.0, 0.0), (2.75, 0.0)])
+f, a, p = lines(GI.getpoint(l1), color = :blue)
+scatter!(GI.getpoint(l1), color = :blue)
+lines!(GI.getpoint(l2), color = :orange)
+scatter!(GI.getpoint(l2), color = :orange)
+f

We can see that none of the edges or vertices of l1 interact with l2 so they are disjoint.

julia
GO.disjoint(l1, l2)  # returns true
true

Implementation

This is the GeoInterface-compatible implementation.

First, we implement a wrapper method that dispatches to the correct implementation based on the geometry trait.

Each of these calls a method in the geom_geom_processors file. The methods in this file determine if the given geometries meet a set of criteria. For the disjoint function and arguments g1 and g2, this criteria is as follows: - points of g1 are not allowed to be in the interior of g2 - points of g1 are not allowed to be on the boundary of g2 - points of g1 are allowed to be in the exterior of g2 - no points required to be in the interior of g2 - no points of g1 are required to be on the boundary of g2 - no points of g1 are required to be in the exterior of g2

The code for the specific implementations is in the geom_geom_processors file.

julia
const DISJOINT_ALLOWS = (in_allow = false, on_allow = false, out_allow = true)
+const DISJOINT_CURVE_ALLOWS = (over_allow = false, cross_allow = false, on_allow = false, out_allow = true)
+const DISJOINT_REQUIRES = (in_require = false, on_require = false, out_require = false)
+const DISJOINT_EXACT = (exact = _False(),)
+
+"""
+    disjoint(geom1, geom2)::Bool
+
+Return \`true\` if the first geometry is disjoint from the second geometry.
+
+Return \`true\` if the first geometry is disjoint from the second geometry. The
+interiors and boundaries of both geometries must not intersect.
+
+# Examples
+\`\`\`jldoctest setup=:(using GeometryOps, GeoInterface)
+import GeometryOps as GO, GeoInterface as GI
+
+line = GI.LineString([(1, 1), (1, 2), (1, 3), (1, 4)])
+point = (2, 2)
+GO.disjoint(point, line)

output

julia
true
+\`\`\`
+"""
+disjoint(g1, g2) = _disjoint(trait(g1), g1, trait(g2), g2)

Convert features to geometries

julia
_disjoint(::FeatureTrait, g1, ::Any, g2) = disjoint(GI.geometry(g1), g2)
+_disjoint(::Any, g1, ::FeatureTrait, g2) = disjoint(g1, geometry(g2))
+_disjoint(::FeatureTrait, g1, ::FeatureTrait, g2) = disjoint(GI.geometry(g1), GI.geometry(g2))

Point disjoint geometries

Point is disjoint from another point if the points are not equal.

julia
_disjoint(
+    ::GI.PointTrait, g1,
+    ::GI.PointTrait, g2,
+) = !equals(g1, g2)

Point is disjoint from a linestring if it is not on the line's edges/vertices.

julia
_disjoint(
+    ::GI.PointTrait, g1,
+    ::Union{GI.LineTrait, GI.LineStringTrait}, g2,
+) = _point_curve_process(
+    g1, g2;
+    DISJOINT_ALLOWS...,
+    closed_curve = false,
+)

Point is disjoint from a linearring if it is not on the ring's edges/vertices.

julia
_disjoint(
+    ::GI.PointTrait, g1,
+    ::GI.LinearRingTrait, g2,
+) = _point_curve_process(
+    g1, g2;
+    DISJOINT_ALLOWS...,
+    closed_curve = true,
+)
+
+#= Point is disjoint from a polygon if it is not on any edges, vertices, or
+within the polygon's interior. =#
+_disjoint(
+    ::GI.PointTrait, g1,
+    ::GI.PolygonTrait, g2,
+) = _point_polygon_process(
+    g1, g2;
+    DISJOINT_ALLOWS...,
+    DISJOINT_EXACT...,
+)
+
+#= Geometry is disjoint from a point if the point is not in the interior or on
+the boundary of the geometry. =#
+_disjoint(
+    trait1::Union{GI.AbstractCurveTrait, GI.PolygonTrait}, g1,
+    trait2::GI.PointTrait, g2,
+) = _disjoint(trait2, g2, trait1, g1)

Lines disjoint geometries

julia
#= Linestring is disjoint from another line if they do not share any interior
+edge/vertex points or boundary points. =#
+_disjoint(
+    ::Union{GI.LineTrait, GI.LineStringTrait}, g1,
+    ::Union{GI.LineTrait, GI.LineStringTrait}, g2,
+) = _line_curve_process(
+    g1, g2;
+    DISJOINT_CURVE_ALLOWS...,
+    DISJOINT_REQUIRES...,
+    DISJOINT_EXACT...,
+    closed_line = false,
+    closed_curve = false,
+)
+
+#= Linestring is disjoint from a linearring if they do not share any interior
+edge/vertex points or boundary points. =#
+_disjoint(
+    ::Union{GI.LineTrait, GI.LineStringTrait}, g1,
+    ::GI.LinearRingTrait, g2,
+) = _line_curve_process(
+    g1, g2;
+    DISJOINT_CURVE_ALLOWS...,
+    DISJOINT_REQUIRES...,
+    DISJOINT_EXACT...,
+    closed_line = false,
+    closed_curve = true,
+)
+
+#= Linestring is disjoint from a polygon if the interior and boundary points of
+the line are not in the polygon's interior or on the polygon's boundary. =#
+_disjoint(
+    ::Union{GI.LineTrait, GI.LineStringTrait}, g1,
+    ::GI.PolygonTrait, g2,
+) = _line_polygon_process(
+    g1, g2;
+    DISJOINT_ALLOWS...,
+    DISJOINT_REQUIRES...,
+    DISJOINT_EXACT...,
+    closed_line = false,
+)
+
+#= Geometry is disjoint from a linestring if the line's interior and boundary
+points don't intersect with the geometry's interior and boundary points. =#
+_disjoint(
+    trait1::Union{GI.LinearRingTrait, GI.PolygonTrait}, g1,
+    trait2::Union{GI.LineTrait, GI.LineStringTrait}, g2,
+) = _disjoint(trait2, g2, trait1, g1)

Rings disjoint geometries

julia
#= Linearrings is disjoint from another linearring if they do not share any
+interior edge/vertex points or boundary points.=#
+_disjoint(
+    ::GI.LinearRingTrait, g1,
+    ::GI.LinearRingTrait, g2,
+) = _line_curve_process(
+    g1, g2;
+    DISJOINT_CURVE_ALLOWS...,
+    DISJOINT_REQUIRES...,
+    DISJOINT_EXACT...,
+    closed_line = true,
+    closed_curve = true,
+)
+
+#= Linearring is disjoint from a polygon if the interior and boundary points of
+the ring are not in the polygon's interior or on the polygon's boundary. =#
+_disjoint(
+    ::GI.LinearRingTrait, g1,
+    ::GI.PolygonTrait, g2,
+) = _line_polygon_process(
+    g1, g2;
+    DISJOINT_ALLOWS...,
+    DISJOINT_REQUIRES...,
+    DISJOINT_EXACT...,
+    closed_line = true,
+)

Polygon disjoint geometries

julia
#= Polygon is disjoint from another polygon if they do not share any edges or
+vertices and if their interiors do not intersect, excluding any holes. =#
+_disjoint(
+    ::GI.PolygonTrait, g1,
+    ::GI.PolygonTrait, g2,
+) = _polygon_polygon_process(
+    g1, g2;
+    DISJOINT_ALLOWS...,
+    DISJOINT_REQUIRES...,
+    DISJOINT_EXACT...,
+)

Geometries disjoint multi-geometry/geometry collections

julia
#= Geometry is disjoint from a multi-geometry or a collection if all of the
+elements of the collection are disjoint from the geometry. =#
+function _disjoint(
+    ::Union{GI.PointTrait, GI.AbstractCurveTrait, GI.PolygonTrait}, g1,
+    ::Union{
+        GI.MultiPointTrait, GI.AbstractMultiCurveTrait,
+        GI.MultiPolygonTrait, GI.GeometryCollectionTrait,
+    }, g2,
+)
+    for sub_g2 in GI.getgeom(g2)
+        !disjoint(g1, sub_g2) && return false
+    end
+    return true
+end

Multi-geometry/geometry collections coveredby geometries

julia
#= Multi-geometry or a geometry collection is covered by a geometry if all
+elements of the collection are covered by the geometry. =#
+function _disjoint(
+    ::Union{
+        GI.MultiPointTrait, GI.AbstractMultiCurveTrait,
+        GI.MultiPolygonTrait, GI.GeometryCollectionTrait,
+    }, g1,
+    ::GI.AbstractGeometryTrait, g2,
+)
+    for sub_g1 in GI.getgeom(g1)
+        !disjoint(sub_g1, g2) && return false
+    end
+    return true
+end

This page was generated using Literate.jl.

`,39)]))}const y=i(l,[["render",p]]);export{o as __pageData,y as default}; diff --git a/previews/PR237/assets/source_methods_geom_relations_disjoint.md.D-2b0dzW.lean.js b/previews/PR237/assets/source_methods_geom_relations_disjoint.md.D-2b0dzW.lean.js new file mode 100644 index 000000000..3550d422c --- /dev/null +++ b/previews/PR237/assets/source_methods_geom_relations_disjoint.md.D-2b0dzW.lean.js @@ -0,0 +1,178 @@ +import{_ as i,c as a,a5 as n,o as t}from"./chunks/framework.Cq8AuEls.js";const h="/GeometryOps.jl/previews/PR237/assets/ijvdjav.C3SxJ3x-.png",o=JSON.parse('{"title":"Disjoint","description":"","frontmatter":{},"headers":[],"relativePath":"source/methods/geom_relations/disjoint.md","filePath":"source/methods/geom_relations/disjoint.md","lastUpdated":null}'),l={name:"source/methods/geom_relations/disjoint.md"};function p(k,s,e,r,E,g){return t(),a("div",null,s[0]||(s[0]=[n(`

Disjoint

julia
export disjoint

What is disjoint?

The disjoint function checks if one geometry is outside of another geometry, without sharing any boundaries or interiors.

To provide an example, consider these two lines:

julia
import GeometryOps as GO
+import GeoInterface as GI
+using Makie
+using CairoMakie
+
+l1 = GI.LineString([(0.0, 0.0), (1.0, 0.0), (0.0, 0.1)])
+l2 = GI.LineString([(2.0, 0.0), (2.75, 0.0)])
+f, a, p = lines(GI.getpoint(l1), color = :blue)
+scatter!(GI.getpoint(l1), color = :blue)
+lines!(GI.getpoint(l2), color = :orange)
+scatter!(GI.getpoint(l2), color = :orange)
+f

We can see that none of the edges or vertices of l1 interact with l2 so they are disjoint.

julia
GO.disjoint(l1, l2)  # returns true
true

Implementation

This is the GeoInterface-compatible implementation.

First, we implement a wrapper method that dispatches to the correct implementation based on the geometry trait.

Each of these calls a method in the geom_geom_processors file. The methods in this file determine if the given geometries meet a set of criteria. For the disjoint function and arguments g1 and g2, this criteria is as follows: - points of g1 are not allowed to be in the interior of g2 - points of g1 are not allowed to be on the boundary of g2 - points of g1 are allowed to be in the exterior of g2 - no points required to be in the interior of g2 - no points of g1 are required to be on the boundary of g2 - no points of g1 are required to be in the exterior of g2

The code for the specific implementations is in the geom_geom_processors file.

julia
const DISJOINT_ALLOWS = (in_allow = false, on_allow = false, out_allow = true)
+const DISJOINT_CURVE_ALLOWS = (over_allow = false, cross_allow = false, on_allow = false, out_allow = true)
+const DISJOINT_REQUIRES = (in_require = false, on_require = false, out_require = false)
+const DISJOINT_EXACT = (exact = _False(),)
+
+"""
+    disjoint(geom1, geom2)::Bool
+
+Return \`true\` if the first geometry is disjoint from the second geometry.
+
+Return \`true\` if the first geometry is disjoint from the second geometry. The
+interiors and boundaries of both geometries must not intersect.
+
+# Examples
+\`\`\`jldoctest setup=:(using GeometryOps, GeoInterface)
+import GeometryOps as GO, GeoInterface as GI
+
+line = GI.LineString([(1, 1), (1, 2), (1, 3), (1, 4)])
+point = (2, 2)
+GO.disjoint(point, line)

output

julia
true
+\`\`\`
+"""
+disjoint(g1, g2) = _disjoint(trait(g1), g1, trait(g2), g2)

Convert features to geometries

julia
_disjoint(::FeatureTrait, g1, ::Any, g2) = disjoint(GI.geometry(g1), g2)
+_disjoint(::Any, g1, ::FeatureTrait, g2) = disjoint(g1, geometry(g2))
+_disjoint(::FeatureTrait, g1, ::FeatureTrait, g2) = disjoint(GI.geometry(g1), GI.geometry(g2))

Point disjoint geometries

Point is disjoint from another point if the points are not equal.

julia
_disjoint(
+    ::GI.PointTrait, g1,
+    ::GI.PointTrait, g2,
+) = !equals(g1, g2)

Point is disjoint from a linestring if it is not on the line's edges/vertices.

julia
_disjoint(
+    ::GI.PointTrait, g1,
+    ::Union{GI.LineTrait, GI.LineStringTrait}, g2,
+) = _point_curve_process(
+    g1, g2;
+    DISJOINT_ALLOWS...,
+    closed_curve = false,
+)

Point is disjoint from a linearring if it is not on the ring's edges/vertices.

julia
_disjoint(
+    ::GI.PointTrait, g1,
+    ::GI.LinearRingTrait, g2,
+) = _point_curve_process(
+    g1, g2;
+    DISJOINT_ALLOWS...,
+    closed_curve = true,
+)
+
+#= Point is disjoint from a polygon if it is not on any edges, vertices, or
+within the polygon's interior. =#
+_disjoint(
+    ::GI.PointTrait, g1,
+    ::GI.PolygonTrait, g2,
+) = _point_polygon_process(
+    g1, g2;
+    DISJOINT_ALLOWS...,
+    DISJOINT_EXACT...,
+)
+
+#= Geometry is disjoint from a point if the point is not in the interior or on
+the boundary of the geometry. =#
+_disjoint(
+    trait1::Union{GI.AbstractCurveTrait, GI.PolygonTrait}, g1,
+    trait2::GI.PointTrait, g2,
+) = _disjoint(trait2, g2, trait1, g1)

Lines disjoint geometries

julia
#= Linestring is disjoint from another line if they do not share any interior
+edge/vertex points or boundary points. =#
+_disjoint(
+    ::Union{GI.LineTrait, GI.LineStringTrait}, g1,
+    ::Union{GI.LineTrait, GI.LineStringTrait}, g2,
+) = _line_curve_process(
+    g1, g2;
+    DISJOINT_CURVE_ALLOWS...,
+    DISJOINT_REQUIRES...,
+    DISJOINT_EXACT...,
+    closed_line = false,
+    closed_curve = false,
+)
+
+#= Linestring is disjoint from a linearring if they do not share any interior
+edge/vertex points or boundary points. =#
+_disjoint(
+    ::Union{GI.LineTrait, GI.LineStringTrait}, g1,
+    ::GI.LinearRingTrait, g2,
+) = _line_curve_process(
+    g1, g2;
+    DISJOINT_CURVE_ALLOWS...,
+    DISJOINT_REQUIRES...,
+    DISJOINT_EXACT...,
+    closed_line = false,
+    closed_curve = true,
+)
+
+#= Linestring is disjoint from a polygon if the interior and boundary points of
+the line are not in the polygon's interior or on the polygon's boundary. =#
+_disjoint(
+    ::Union{GI.LineTrait, GI.LineStringTrait}, g1,
+    ::GI.PolygonTrait, g2,
+) = _line_polygon_process(
+    g1, g2;
+    DISJOINT_ALLOWS...,
+    DISJOINT_REQUIRES...,
+    DISJOINT_EXACT...,
+    closed_line = false,
+)
+
+#= Geometry is disjoint from a linestring if the line's interior and boundary
+points don't intersect with the geometry's interior and boundary points. =#
+_disjoint(
+    trait1::Union{GI.LinearRingTrait, GI.PolygonTrait}, g1,
+    trait2::Union{GI.LineTrait, GI.LineStringTrait}, g2,
+) = _disjoint(trait2, g2, trait1, g1)

Rings disjoint geometries

julia
#= Linearrings is disjoint from another linearring if they do not share any
+interior edge/vertex points or boundary points.=#
+_disjoint(
+    ::GI.LinearRingTrait, g1,
+    ::GI.LinearRingTrait, g2,
+) = _line_curve_process(
+    g1, g2;
+    DISJOINT_CURVE_ALLOWS...,
+    DISJOINT_REQUIRES...,
+    DISJOINT_EXACT...,
+    closed_line = true,
+    closed_curve = true,
+)
+
+#= Linearring is disjoint from a polygon if the interior and boundary points of
+the ring are not in the polygon's interior or on the polygon's boundary. =#
+_disjoint(
+    ::GI.LinearRingTrait, g1,
+    ::GI.PolygonTrait, g2,
+) = _line_polygon_process(
+    g1, g2;
+    DISJOINT_ALLOWS...,
+    DISJOINT_REQUIRES...,
+    DISJOINT_EXACT...,
+    closed_line = true,
+)

Polygon disjoint geometries

julia
#= Polygon is disjoint from another polygon if they do not share any edges or
+vertices and if their interiors do not intersect, excluding any holes. =#
+_disjoint(
+    ::GI.PolygonTrait, g1,
+    ::GI.PolygonTrait, g2,
+) = _polygon_polygon_process(
+    g1, g2;
+    DISJOINT_ALLOWS...,
+    DISJOINT_REQUIRES...,
+    DISJOINT_EXACT...,
+)

Geometries disjoint multi-geometry/geometry collections

julia
#= Geometry is disjoint from a multi-geometry or a collection if all of the
+elements of the collection are disjoint from the geometry. =#
+function _disjoint(
+    ::Union{GI.PointTrait, GI.AbstractCurveTrait, GI.PolygonTrait}, g1,
+    ::Union{
+        GI.MultiPointTrait, GI.AbstractMultiCurveTrait,
+        GI.MultiPolygonTrait, GI.GeometryCollectionTrait,
+    }, g2,
+)
+    for sub_g2 in GI.getgeom(g2)
+        !disjoint(g1, sub_g2) && return false
+    end
+    return true
+end

Multi-geometry/geometry collections coveredby geometries

julia
#= Multi-geometry or a geometry collection is covered by a geometry if all
+elements of the collection are covered by the geometry. =#
+function _disjoint(
+    ::Union{
+        GI.MultiPointTrait, GI.AbstractMultiCurveTrait,
+        GI.MultiPolygonTrait, GI.GeometryCollectionTrait,
+    }, g1,
+    ::GI.AbstractGeometryTrait, g2,
+)
+    for sub_g1 in GI.getgeom(g1)
+        !disjoint(sub_g1, g2) && return false
+    end
+    return true
+end

This page was generated using Literate.jl.

`,39)]))}const y=i(l,[["render",p]]);export{o as __pageData,y as default}; diff --git a/previews/PR237/assets/source_methods_geom_relations_geom_geom_processors.md.B0gKT2XJ.js b/previews/PR237/assets/source_methods_geom_relations_geom_geom_processors.md.B0gKT2XJ.js new file mode 100644 index 000000000..7a337e869 --- /dev/null +++ b/previews/PR237/assets/source_methods_geom_relations_geom_geom_processors.md.B0gKT2XJ.js @@ -0,0 +1,437 @@ +import{_ as i,c as a,a5 as n,o as h}from"./chunks/framework.Cq8AuEls.js";const g=JSON.parse('{"title":"Line-curve interaction","description":"","frontmatter":{},"headers":[],"relativePath":"source/methods/geom_relations/geom_geom_processors.md","filePath":"source/methods/geom_relations/geom_geom_processors.md","lastUpdated":null}'),l={name:"source/methods/geom_relations/geom_geom_processors.md"};function t(p,s,k,e,r,E){return h(),a("div",null,s[0]||(s[0]=[n(`

Line-curve interaction

julia
#= Code is based off of DE-9IM Standards (https://en.wikipedia.org/wiki/DE-9IM)
+and attempts a standardized solution for most of the functions.
+=#
+
+"""
+    Enum PointOrientation
+
+Enum for the orientation of a point with respect to a curve. A point can be
+\`point_in\` the curve, \`point_on\` the curve, or \`point_out\` of the curve.
+"""
+@enum PointOrientation point_in=1 point_on=2 point_out=3

Determines if a point meets the given checks with respect to a curve.

If in_allow is true, the point can be on the curve interior. If on_allow is true, the point can be on the curve boundary. If out_allow is true, the point can be disjoint from the curve.

If the point is in an "allowed" location, return true. Else, return false.

If closed_curve is true, curve is treated as a closed curve where the first and last point are connected by a segment.

julia
function _point_curve_process(
+    point, curve;
+    in_allow, on_allow, out_allow,
+    closed_curve = false,
+)

Determine if curve is closed

julia
    n = GI.npoint(curve)
+    first_last_equal = equals(GI.getpoint(curve, 1), GI.getpoint(curve, n))
+    closed_curve |= first_last_equal
+    n -= first_last_equal ? 1 : 0

Loop through all curve segments

julia
    p_start = GI.getpoint(curve, closed_curve ? n : 1)
+    @inbounds for i in (closed_curve ? 1 : 2):n
+        p_end = GI.getpoint(curve, i)
+        seg_val = _point_segment_orientation(point, p_start, p_end)
+        seg_val == point_in && return in_allow
+        if seg_val == point_on
+            if !closed_curve  # if point is on curve endpoints, it is "on"
+                i == 2 && equals(point, p_start) && return on_allow
+                i == n && equals(point, p_end) && return on_allow
+            end
+            return in_allow
+        end
+        p_start = p_end
+    end
+    return out_allow
+end

Determines if a point meets the given checks with respect to a polygon.

If in_allow is true, the point can be within the polygon interior If on_allow is true, the point can be on the polygon boundary. If out_allow is true, the point can be disjoint from the polygon.

If the point is in an "allowed" location, return true. Else, return false.

julia
function _point_polygon_process(
+    point, polygon;
+    in_allow, on_allow, out_allow, exact,
+)

Check interaction of geom with polygon's exterior boundary

julia
    ext_val = _point_filled_curve_orientation(point, GI.getexterior(polygon); exact)

If a point is outside, it isn't interacting with any holes

julia
    ext_val == point_out && return out_allow

if a point is on an external boundary, it isn't interacting with any holes

julia
    ext_val == point_on && return on_allow

If geom is within the polygon, need to check interactions with holes

julia
    for hole in GI.gethole(polygon)
+        hole_val = _point_filled_curve_orientation(point, hole; exact)

If a point in in a hole, it is outside of the polygon

julia
        hole_val == point_in && return out_allow

If a point in on a hole edge, it is on the edge of the polygon

julia
        hole_val == point_on && return on_allow
+    end

Point is within external boundary and on in/on any holes

julia
    return in_allow
+end

Determines if a line meets the given checks with respect to a curve.

If over_allow is true, segments of the line and curve can be co-linear. If cross_allow is true, segments of the line and curve can cross. If on_allow is true, endpoints of either the line or curve can intersect a segment of the other geometry. If cross_allow is true, segments of the line and curve can be disjoint.

If in_require is true, the interiors of the line and curve must meet in at least one point. If on_require is true, the boundary of one of the two geometries can meet the interior or boundary of the other geometry in at least one point. If out_require is true, there must be at least one point of the given line that is exterior of the curve.

If the point is in an "allowed" location and meets all requirements, return true. Else, return false.

If closed_line is true, line is treated as a closed line where the first and last point are connected by a segment. Same with closed_curve.

julia
@inline function _line_curve_process(line, curve;
+    over_allow, cross_allow, kw...
+)
+    skip, returnval = _maybe_skip_disjoint_extents(line, curve;
+        in_allow=(over_allow | cross_allow), kw...
+    )
+    skip && return returnval
+
+    return _inner_line_curve_process(line, curve; over_allow, cross_allow, kw...)
+end
+
+function _inner_line_curve_process(
+    line, curve;
+    over_allow, cross_allow, on_allow, out_allow,
+    in_require, on_require, out_require,
+    closed_line = false, closed_curve = false,
+    exact,
+)

Set up requirements

julia
    in_req_met = !in_require
+    on_req_met = !on_require
+    out_req_met = !out_require

Determine curve endpoints

julia
    nl = GI.npoint(line)
+    nc = GI.npoint(curve)
+    first_last_equal_line = equals(GI.getpoint(line, 1), GI.getpoint(line, nl))
+    first_last_equal_curve = equals(GI.getpoint(curve, 1), GI.getpoint(curve, nc))
+    nl -= first_last_equal_line ? 1 : 0
+    nc -= first_last_equal_curve ? 1 : 0
+    closed_line |= first_last_equal_line
+    closed_curve |= first_last_equal_curve

Loop over each line segment

julia
    l_start = _tuple_point(GI.getpoint(line, closed_line ? nl : 1))
+    i = closed_line ? 1 : 2
+    while i  nl
+        l_end = _tuple_point(GI.getpoint(line, i))
+        c_start = _tuple_point(GI.getpoint(curve, closed_curve ? nc : 1))

Loop over each curve segment

julia
        for j in (closed_curve ? 1 : 2):nc
+            c_end = _tuple_point(GI.getpoint(curve, j))

Check if line and curve segments meet

julia
            seg_val, intr1, _ = _intersection_point(Float64, (l_start, l_end), (c_start, c_end); exact)

If segments are co-linear

julia
            if seg_val == line_over
+                !over_allow && return false

at least one point in, meets requirements

julia
                in_req_met = true
+                point_val = _point_segment_orientation(l_start, c_start, c_end)

If entire segment isn't covered, consider remaining section

julia
                if point_val != point_out
+                    i, l_start, break_off = _find_new_seg(i, l_start, l_end, c_start, c_end)
+                    break_off && break
+                end
+            else
+                if seg_val == line_cross
+                    !cross_allow && return false
+                    in_req_met = true
+                elseif seg_val == line_hinge  # could cross or overlap

Determine location of intersection point on each segment

julia
                    (_, (α, β)) = intr1
+                    if ( # Don't consider edges of curves as they can't cross
+                        (!closed_line && ((α == 0 && i == 2) ||== 1 && i == nl))) ||
+                        (!closed_curve && ((β == 0 && j == 2) ||== 1 && j == nc)))
+                    )
+                        !on_allow && return false
+                        on_req_met = true
+                    else
+                        in_req_met = true

If needed, determine if hinge actually crosses

julia
                        if (!cross_allow || !over_allow) && α != 0 && β != 0

Find next pieces of hinge to see if line and curve cross

julia
                            l, c = _find_hinge_next_segments(
+                                α, β, l_start, l_end, c_start, c_end,
+                                i, line, j, curve,
+                            )
+                            next_val, _, _ = _intersection_point(Float64, l, c; exact)
+                            if next_val == line_hinge
+                                !cross_allow && return false
+                            else
+                                !over_allow && return false
+                            end
+                        end
+                    end
+                end

no overlap for a give segment, some of segment must be out of curve

julia
                if j == nc
+                    !out_allow && return false
+                    out_req_met = true
+                end
+            end
+            c_start = c_end  # consider next segment of curve
+            if j == nc  # move on to next line segment
+                i += 1
+                l_start = l_end
+            end
+        end
+    end
+    return in_req_met && on_req_met && out_req_met
+end
+
+#= If entire segment (le to ls) isn't covered by segment (cs to ce), find remaining section
+part of section outside of cs to ce. If completely covered, increase segment index i. =#
+function _find_new_seg(i, ls, le, cs, ce)
+    break_off = true
+    if _point_segment_orientation(le, cs, ce) != point_out
+        ls = le
+        i += 1
+    elseif !equals(ls, cs) && _point_segment_orientation(cs, ls, le) != point_out
+        ls = cs
+    elseif !equals(ls, ce) && _point_segment_orientation(ce, ls, le) != point_out
+        ls = ce
+    else
+        break_off = false
+    end
+    return i, ls, break_off
+end
+
+#= Find next set of segments needed to determine if given hinge segments cross or not.=#
+function _find_hinge_next_segments(α, β, ls, le, cs, ce, i, line, j, curve)
+    next_seg = if β == 1
+        if α == 1  # hinge at endpoints, so next segment of both is needed
+            ((le, _tuple_point(GI.getpoint(line, i + 1))), (ce, _tuple_point(GI.getpoint(curve, j + 1))))
+        else  # hinge at curve endpoint and line interior point, curve next segment needed
+            ((ls, le), (ce, _tuple_point(GI.getpoint(curve, j + 1))))
+        end
+    else  # hinge at curve interior point and line endpoint, line next segment needed
+        ((le, _tuple_point(GI.getpoint(line, i + 1))), (cs, ce))
+    end
+    return next_seg
+end

Determines if a line meets the given checks with respect to a polygon.

If in_allow is true, segments of the line can be in the polygon interior. If on_allow is true, segments of the line can be on the polygon's boundary. If out_allow is true, segments of the line can be outside of the polygon.

If in_require is true, the interiors of the line and polygon must meet in at least one point. If on_require is true, the line must have at least one point on the polygon'same boundary. If out_require is true, the line must have at least one point outside of the polygon.

If the point is in an "allowed" location and meets all requirements, return true. Else, return false.

If closed_line is true, line is treated as a closed line where the first and last point are connected by a segment.

julia
@inline function _line_polygon_process(line, polygon; kw...)
+    skip, returnval = _maybe_skip_disjoint_extents(line, polygon; kw...)
+    skip && return returnval
+    return _inner_line_polygon_process(line, polygon; kw...)
+end
+
+function _inner_line_polygon_process(
+    line, polygon;
+    in_allow, on_allow, out_allow,
+    in_require, on_require, out_require,
+    exact, closed_line = false,
+)
+    in_req_met = !in_require
+    on_req_met = !on_require
+    out_req_met = !out_require

Check interaction of line with polygon's exterior boundary

julia
    in_curve, on_curve, out_curve = _line_filled_curve_interactions(
+        line, GI.getexterior(polygon);
+        exact, closed_line = closed_line,
+    )
+    if on_curve
+        !on_allow && return false
+        on_req_met = true
+    end
+    if out_curve
+        !out_allow && return false
+        out_req_met = true
+    end

If no points within the polygon, the line is disjoint and we are done

julia
    !in_curve && return in_req_met && on_req_met && out_req_met

Loop over polygon holes

julia
    for hole in GI.gethole(polygon)
+        in_hole, on_hole, out_hole =_line_filled_curve_interactions(
+            line, hole;
+            exact, closed_line = closed_line,
+        )
+        if in_hole  # line in hole is equivalent to being out of polygon
+            !out_allow && return false
+            out_req_met = true
+        end
+        if on_hole  # hole boundary is polygon boundary
+            !on_allow && return false
+            on_req_met = true
+        end
+        if !out_hole  # entire line is in/on hole, can't be in/on other holes
+            in_curve = false
+            break
+        end
+    end
+    if in_curve  # entirely of curve isn't within a hole
+        !in_allow && return false
+        in_req_met = true
+    end
+    return in_req_met && on_req_met && out_req_met
+end

Determines if a polygon meets the given checks with respect to a polygon.

If in_allow is true, the polygon's interiors must intersect. If on_allow is true, the one of the polygon's boundaries must either interact with the other polygon's boundary or interior. If out_allow is true, the first polygon must have interior regions outside of the second polygon.

If in_require is true, the polygon interiors must meet in at least one point. If on_require is true, one of the polygon's must have at least one boundary point in or on the other polygon. If out_require is true, the first polygon must have at least one interior point outside of the second polygon.

If the point is in an "allowed" location and meets all requirements, return true. Else, return false.

julia
@inline function _polygon_polygon_process(poly1, poly2; kw...)
+    skip, returnval = _maybe_skip_disjoint_extents(poly1, poly2; kw...)
+    skip && return returnval
+    return _inner_polygon_polygon_process(poly1, poly2; kw...)
+end
+
+function _inner_polygon_polygon_process(
+    poly1, poly2;
+    in_allow, on_allow, out_allow,
+    in_require, on_require, out_require,
+    exact,
+)
+    in_req_met = !in_require
+    on_req_met = !on_require
+    out_req_met = !out_require

Check if exterior of poly1 is within poly2

julia
    ext1 = GI.getexterior(poly1)
+    ext2 = GI.getexterior(poly2)

Check if exterior of poly1 is in polygon 2

julia
    e1_in_p2, e1_on_p2, e1_out_p2 = _line_polygon_interactions(
+        ext1, poly2;
+        exact, closed_line = true,
+    )
+    if e1_on_p2
+        !on_allow && return false
+        on_req_met = true
+    end
+    if e1_out_p2
+        !out_allow && return false
+        out_req_met = true
+    end
+
+    if !e1_in_p2

if exterior ring isn't in poly2, check if it surrounds poly2

julia
        _, _, e2_out_e1 = _line_filled_curve_interactions(
+            ext2, ext1;
+            exact, closed_line = true,
+        )  # if they really are disjoint, we are done
+        e2_out_e1 && return in_req_met && on_req_met && out_req_met
+    end

If interiors interact, check if poly2 interacts with any of poly1's holes

julia
    for h1 in GI.gethole(poly1)
+        h1_in_p2, h1_on_p2, h1_out_p2 = _line_polygon_interactions(
+            h1, poly2;
+            exact, closed_line = true,
+        )
+        if h1_on_p2
+            !on_allow && return false
+            on_req_met = true
+        end
+        if h1_out_p2
+            !out_allow && return false
+            out_req_met = true
+        end
+        if !h1_in_p2

If hole isn't in poly2, see if poly2 is in hole

julia
            _, _, e2_out_h1 = _line_filled_curve_interactions(
+                ext2, h1;
+                exact, closed_line = true,
+            )

hole encompasses all of poly2

julia
            !e2_out_h1 && return in_req_met && on_req_met && out_req_met
+            break
+        end
+    end
+    #=
+    poly2 isn't outside of poly1 and isn't in a hole, poly1 interior must
+    interact with poly2 interior
+    =#
+    !in_allow && return false
+    in_req_met = true

If any of poly2 holes are within poly1, part of poly1 is exterior to poly2

julia
    for h2 in GI.gethole(poly2)
+        h2_in_p1, h2_on_p1, _ = _line_polygon_interactions(
+            h2, poly1;
+            exact, closed_line = true,
+        )
+        if h2_on_p1
+            !on_allow && return false
+            on_req_met = true
+        end
+        if h2_in_p1
+            !out_allow && return false
+            out_req_met = true
+        end
+    end
+    return in_req_met && on_req_met && out_req_met
+end

Determines if a point is in, on, or out of a segment. If the point is on the segment it is on one of the segments endpoints. If it is in, it is on any other point of the segment. If the point is not on any part of the segment, it is out of the segment.

Point should be an object of point trait and curve should be an object with a linestring or linearring trait.

Can provide values of in, on, and out keywords, which determines return values for each scenario.

julia
function _point_segment_orientation(
+    point, start, stop;
+    in::T = point_in, on::T = point_on, out::T = point_out,
+) where {T}

Parse out points

julia
    x, y = GI.x(point), GI.y(point)
+    x1, y1 = GI.x(start), GI.y(start)
+    x2, y2 = GI.x(stop), GI.y(stop)
+    Δx_seg = x2 - x1
+    Δy_seg = y2 - y1
+    Δx_pt = x - x1
+    Δy_pt = y - y1
+    if (Δx_pt == 0 && Δy_pt == 0) || (Δx_pt == Δx_seg && Δy_pt == Δy_seg)

If point is equal to the segment start or end points

julia
        return on
+    else
+        #=
+        Determine if the point is on the segment -> see if vector from segment
+        start to point is parallel to segment and if point is between the
+        segment endpoints
+        =#
+        on_line = _isparallel(Δx_seg, Δy_seg, Δx_pt, Δy_pt)
+        !on_line && return out
+        between_endpoints =
+            (x2 > x1 ? x1 <= x <= x2 : x2 <= x <= x1) &&
+            (y2 > y1 ? y1 <= y <= y2 : y2 <= y <= y1)
+        !between_endpoints && return out
+    end
+    return in
+end

Determine if point is in, on, or out of a closed curve, which includes the space enclosed by the closed curve.

In means the point is within the closed curve (excluding edges and vertices). On means the point is on an edge or a vertex of the closed curve. Out means the point is outside of the closed curve.

Point should be an object of point trait and curve should be an object with a linestring or linearring trait, that is assumed to be closed, regardless of repeated last point.

Can provide values of in, on, and out keywords, which determines return values for each scenario.

Note that this uses the Algorithm by Hao and Sun (2018): https://doi.org/10.3390/sym10100477 Paper separates orientation of point and edge into 26 cases. For each case, it is either a case where the point is on the edge (returns on), where a ray from the point (x, y) to infinity along the line y = y cut through the edge (k += 1), or the ray does not pass through the edge (do nothing and continue). If the ray passes through an odd number of edges, it is within the curve, else outside of of the curve if it didn't return 'on'. See paper for more information on cases denoted in comments.

julia
function _point_filled_curve_orientation(
+    point, curve;
+    in::T = point_in, on::T = point_on, out::T = point_out, exact,
+) where {T}
+    x, y = GI.x(point), GI.y(point)
+    n = GI.npoint(curve)
+    n -= equals(GI.getpoint(curve, 1), GI.getpoint(curve, n)) ? 1 : 0
+    k = 0  # counter for ray crossings
+    p_start = GI.getpoint(curve, n)
+    for (i, p_end) in enumerate(GI.getpoint(curve))
+        i > n && break
+        v1 = GI.y(p_start) - y
+        v2 = GI.y(p_end) - y
+        if !((v1 < 0 && v2 < 0) || (v1 > 0 && v2 > 0)) # if not cases 11 or 26
+            u1, u2 = GI.x(p_start) - x, GI.x(p_end) - x
+            f = Predicates.cross((u1, u2), (v1, v2); exact)
+            if v2 > 0 && v1  0                # Case 3, 9, 16, 21, 13, or 24
+                f == 0 && return on         # Case 16 or 21
+                f > 0 && (k += 1)              # Case 3 or 9
+            elseif v1 > 0 && v2  0            # Case 4, 10, 19, 20, 12, or 25
+                f == 0 && return on         # Case 19 or 20
+                f < 0 && (k += 1)              # Case 4 or 10
+            elseif v2 == 0 && v1 < 0           # Case 7, 14, or 17
+                f == 0 && return on         # Case 17
+            elseif v1 == 0 && v2 < 0           # Case 8, 15, or 18
+                f == 0 && return on         # Case 18
+            elseif v1 == 0 && v2 == 0          # Case 1, 2, 5, 6, 22, or 23
+                u2  0 && u1  0 && return on  # Case 1
+                u1  0 && u2  0 && return on  # Case 2
+            end
+        end
+        p_start = p_end
+    end
+    return iseven(k) ? out : in
+end

Determines the types of interactions of a line with a filled-in curve. By filled-in curve, I am referring to the exterior ring of a poylgon, for example.

Returns a tuple of booleans: (in_curve, on_curve, out_curve).

If in_curve is true, some of the lines interior points interact with the curve's interior points. If on_curve is true, endpoints of either the line intersect with the curve or the line interacts with the polygon boundary. If out_curve is true, at least one segments of the line is outside the curve.

If closed_line is true, line is treated as a closed line where the first and last point are connected by a segment.

julia
function _line_filled_curve_interactions(
+    line, curve;
+    exact, closed_line = false,
+)
+    in_curve = false
+    on_curve = false
+    out_curve = false

Determine number of points in curve and line

julia
    nl = GI.npoint(line)
+    nc = GI.npoint(curve)
+    first_last_equal_line = equals(GI.getpoint(line, 1), GI.getpoint(line, nl))
+    first_last_equal_curve = equals(GI.getpoint(curve, 1), GI.getpoint(curve, nc))
+    nl -= first_last_equal_line ? 1 : 0
+    nc -= first_last_equal_curve ? 1 : 0
+    closed_line |= first_last_equal_line

See if first point is in an acceptable orientation

julia
    l_start = _tuple_point(GI.getpoint(line, closed_line ? nl : 1))
+    point_val = _point_filled_curve_orientation(l_start, curve; exact)
+    if point_val == point_in
+        in_curve = true
+    elseif point_val == point_on
+        on_curve = true
+    else  # point_val == point_out
+        out_curve = true
+    end

Check for any intersections between line and curve

julia
    for i in (closed_line ? 1 : 2):nl
+        l_end = _tuple_point(GI.getpoint(line, i))
+        c_start = _tuple_point(GI.getpoint(curve, nc))

If already interacted with all regions of curve, can stop

julia
        in_curve && on_curve && out_curve && break

Check next segment of line against curve

julia
        for j in 1:nc
+            c_end = _tuple_point(GI.getpoint(curve, j))

Check if two line and curve segments meet

julia
            seg_val, _, _ = _intersection_point(Float64, (l_start, l_end), (c_start, c_end); exact)
+            if seg_val != line_out

If line and curve meet, then at least one point is on boundary

julia
                on_curve = true
+                if seg_val == line_cross

When crossing boundary, line is both in and out of curve

julia
                    in_curve = true
+                    out_curve = true
+                else
+                    if seg_val == line_over
+                        sp = _point_segment_orientation(l_start, c_start, c_end)
+                        lp = _point_segment_orientation(l_end, c_start, c_end)
+                        if sp != point_in || lp != point_in
+                            #=
+                            Line crosses over segment endpoint, creating a hinge
+                            with another segment.
+                            =#
+                            seg_val = line_hinge
+                        end
+                    end
+                    if seg_val == line_hinge
+                        #=
+                        Can't determine all types of interactions (in, out) with
+                        hinge as it could pass through multiple other segments
+                        so calculate if segment endpoints and intersections are
+                        in/out of filled curve
+                        =#
+                        ipoints = intersection_points(GI.Line(StaticArrays.SVector(l_start, l_end)), curve)
+                        npoints = length(ipoints)  # since hinge, at least one
+                        dist_from_lstart = let l_start = l_start
+                            x -> _euclid_distance(Float64, x, l_start)
+                        end
+                        sort!(ipoints, by = dist_from_lstart)
+                        p_start = _tuple_point(l_start)
+                        for i in 1:(npoints + 1)
+                            p_end = i  npoints ? _tuple_point(ipoints[i]) : l_end
+                            mid_val = _point_filled_curve_orientation((p_start .+ p_end) ./ 2, curve; exact)
+                            if mid_val == point_in
+                                in_curve = true
+                            elseif mid_val == point_out
+                                out_curve = true
+                            end
+                        end

already checked segment against whole filled curve

julia
                        l_start = l_end
+                        break
+                    end
+                end
+            end
+            c_start = c_end
+        end
+        l_start = l_end
+    end
+    return in_curve, on_curve, out_curve
+end

Determines the types of interactions of a line with a polygon.

Returns a tuple of booleans: (in_poly, on_poly, out_poly).

If in_poly is true, some of the lines interior points interact with the polygon interior points. If in_poly is true, endpoints of either the line intersect with the polygon or the line interacts with the polygon boundary, including hole boundaries. If out_curve is true, at least one segments of the line is outside the polygon, including inside of holes.

If closed_line is true, line is treated as a closed line where the first and last point are connected by a segment.

julia
function _line_polygon_interactions(
+    line, polygon;
+    exact, closed_line = false,
+)
+
+    in_poly, on_poly, out_poly = _line_filled_curve_interactions(
+        line, GI.getexterior(polygon);
+        exact, closed_line = closed_line,
+    )
+    !in_poly && return (in_poly, on_poly, out_poly)

Loop over polygon holes

julia
    for hole in GI.gethole(polygon)
+        in_hole, on_hole, out_hole =_line_filled_curve_interactions(
+            line, hole;
+            exact, closed_line = closed_line,
+        )
+        if in_hole
+            out_poly = true
+        end
+        if on_hole
+            on_poly = true
+        end
+        if !out_hole  # entire line is in/on hole, can't be in/on other holes
+            in_poly = false
+            return (in_poly, on_poly, out_poly)
+        end
+    end
+    return in_poly, on_poly, out_poly
+end

Disjoint extent optimisation: skip work based on geom extent intersection returns Tuple{Bool, Bool} for (skip, returnval)

julia
@inline function _maybe_skip_disjoint_extents(a, b;
+    in_allow, on_allow, out_allow,
+    in_require, on_require, out_require,
+    kw...
+)
+    ext_disjoint = Extents.disjoint(GI.extent(a), GI.extent(b))
+    skip, returnval = if !ext_disjoint

can't tell anything about this case

julia
        false, false
+    elseif out_allow # && ext_disjoint
+        if in_require || on_require
+            true, false
+        else
+            true, true
+        end
+    else  # !out_allow && ext_disjoint

points not allowed in exterior, but geoms are disjoint

julia
        true, false
+    end
+    return skip, returnval
+end

This page was generated using Literate.jl.

`,142)]))}const y=i(l,[["render",t]]);export{g as __pageData,y as default}; diff --git a/previews/PR237/assets/source_methods_geom_relations_geom_geom_processors.md.B0gKT2XJ.lean.js b/previews/PR237/assets/source_methods_geom_relations_geom_geom_processors.md.B0gKT2XJ.lean.js new file mode 100644 index 000000000..7a337e869 --- /dev/null +++ b/previews/PR237/assets/source_methods_geom_relations_geom_geom_processors.md.B0gKT2XJ.lean.js @@ -0,0 +1,437 @@ +import{_ as i,c as a,a5 as n,o as h}from"./chunks/framework.Cq8AuEls.js";const g=JSON.parse('{"title":"Line-curve interaction","description":"","frontmatter":{},"headers":[],"relativePath":"source/methods/geom_relations/geom_geom_processors.md","filePath":"source/methods/geom_relations/geom_geom_processors.md","lastUpdated":null}'),l={name:"source/methods/geom_relations/geom_geom_processors.md"};function t(p,s,k,e,r,E){return h(),a("div",null,s[0]||(s[0]=[n(`

Line-curve interaction

julia
#= Code is based off of DE-9IM Standards (https://en.wikipedia.org/wiki/DE-9IM)
+and attempts a standardized solution for most of the functions.
+=#
+
+"""
+    Enum PointOrientation
+
+Enum for the orientation of a point with respect to a curve. A point can be
+\`point_in\` the curve, \`point_on\` the curve, or \`point_out\` of the curve.
+"""
+@enum PointOrientation point_in=1 point_on=2 point_out=3

Determines if a point meets the given checks with respect to a curve.

If in_allow is true, the point can be on the curve interior. If on_allow is true, the point can be on the curve boundary. If out_allow is true, the point can be disjoint from the curve.

If the point is in an "allowed" location, return true. Else, return false.

If closed_curve is true, curve is treated as a closed curve where the first and last point are connected by a segment.

julia
function _point_curve_process(
+    point, curve;
+    in_allow, on_allow, out_allow,
+    closed_curve = false,
+)

Determine if curve is closed

julia
    n = GI.npoint(curve)
+    first_last_equal = equals(GI.getpoint(curve, 1), GI.getpoint(curve, n))
+    closed_curve |= first_last_equal
+    n -= first_last_equal ? 1 : 0

Loop through all curve segments

julia
    p_start = GI.getpoint(curve, closed_curve ? n : 1)
+    @inbounds for i in (closed_curve ? 1 : 2):n
+        p_end = GI.getpoint(curve, i)
+        seg_val = _point_segment_orientation(point, p_start, p_end)
+        seg_val == point_in && return in_allow
+        if seg_val == point_on
+            if !closed_curve  # if point is on curve endpoints, it is "on"
+                i == 2 && equals(point, p_start) && return on_allow
+                i == n && equals(point, p_end) && return on_allow
+            end
+            return in_allow
+        end
+        p_start = p_end
+    end
+    return out_allow
+end

Determines if a point meets the given checks with respect to a polygon.

If in_allow is true, the point can be within the polygon interior If on_allow is true, the point can be on the polygon boundary. If out_allow is true, the point can be disjoint from the polygon.

If the point is in an "allowed" location, return true. Else, return false.

julia
function _point_polygon_process(
+    point, polygon;
+    in_allow, on_allow, out_allow, exact,
+)

Check interaction of geom with polygon's exterior boundary

julia
    ext_val = _point_filled_curve_orientation(point, GI.getexterior(polygon); exact)

If a point is outside, it isn't interacting with any holes

julia
    ext_val == point_out && return out_allow

if a point is on an external boundary, it isn't interacting with any holes

julia
    ext_val == point_on && return on_allow

If geom is within the polygon, need to check interactions with holes

julia
    for hole in GI.gethole(polygon)
+        hole_val = _point_filled_curve_orientation(point, hole; exact)

If a point in in a hole, it is outside of the polygon

julia
        hole_val == point_in && return out_allow

If a point in on a hole edge, it is on the edge of the polygon

julia
        hole_val == point_on && return on_allow
+    end

Point is within external boundary and on in/on any holes

julia
    return in_allow
+end

Determines if a line meets the given checks with respect to a curve.

If over_allow is true, segments of the line and curve can be co-linear. If cross_allow is true, segments of the line and curve can cross. If on_allow is true, endpoints of either the line or curve can intersect a segment of the other geometry. If cross_allow is true, segments of the line and curve can be disjoint.

If in_require is true, the interiors of the line and curve must meet in at least one point. If on_require is true, the boundary of one of the two geometries can meet the interior or boundary of the other geometry in at least one point. If out_require is true, there must be at least one point of the given line that is exterior of the curve.

If the point is in an "allowed" location and meets all requirements, return true. Else, return false.

If closed_line is true, line is treated as a closed line where the first and last point are connected by a segment. Same with closed_curve.

julia
@inline function _line_curve_process(line, curve;
+    over_allow, cross_allow, kw...
+)
+    skip, returnval = _maybe_skip_disjoint_extents(line, curve;
+        in_allow=(over_allow | cross_allow), kw...
+    )
+    skip && return returnval
+
+    return _inner_line_curve_process(line, curve; over_allow, cross_allow, kw...)
+end
+
+function _inner_line_curve_process(
+    line, curve;
+    over_allow, cross_allow, on_allow, out_allow,
+    in_require, on_require, out_require,
+    closed_line = false, closed_curve = false,
+    exact,
+)

Set up requirements

julia
    in_req_met = !in_require
+    on_req_met = !on_require
+    out_req_met = !out_require

Determine curve endpoints

julia
    nl = GI.npoint(line)
+    nc = GI.npoint(curve)
+    first_last_equal_line = equals(GI.getpoint(line, 1), GI.getpoint(line, nl))
+    first_last_equal_curve = equals(GI.getpoint(curve, 1), GI.getpoint(curve, nc))
+    nl -= first_last_equal_line ? 1 : 0
+    nc -= first_last_equal_curve ? 1 : 0
+    closed_line |= first_last_equal_line
+    closed_curve |= first_last_equal_curve

Loop over each line segment

julia
    l_start = _tuple_point(GI.getpoint(line, closed_line ? nl : 1))
+    i = closed_line ? 1 : 2
+    while i  nl
+        l_end = _tuple_point(GI.getpoint(line, i))
+        c_start = _tuple_point(GI.getpoint(curve, closed_curve ? nc : 1))

Loop over each curve segment

julia
        for j in (closed_curve ? 1 : 2):nc
+            c_end = _tuple_point(GI.getpoint(curve, j))

Check if line and curve segments meet

julia
            seg_val, intr1, _ = _intersection_point(Float64, (l_start, l_end), (c_start, c_end); exact)

If segments are co-linear

julia
            if seg_val == line_over
+                !over_allow && return false

at least one point in, meets requirements

julia
                in_req_met = true
+                point_val = _point_segment_orientation(l_start, c_start, c_end)

If entire segment isn't covered, consider remaining section

julia
                if point_val != point_out
+                    i, l_start, break_off = _find_new_seg(i, l_start, l_end, c_start, c_end)
+                    break_off && break
+                end
+            else
+                if seg_val == line_cross
+                    !cross_allow && return false
+                    in_req_met = true
+                elseif seg_val == line_hinge  # could cross or overlap

Determine location of intersection point on each segment

julia
                    (_, (α, β)) = intr1
+                    if ( # Don't consider edges of curves as they can't cross
+                        (!closed_line && ((α == 0 && i == 2) ||== 1 && i == nl))) ||
+                        (!closed_curve && ((β == 0 && j == 2) ||== 1 && j == nc)))
+                    )
+                        !on_allow && return false
+                        on_req_met = true
+                    else
+                        in_req_met = true

If needed, determine if hinge actually crosses

julia
                        if (!cross_allow || !over_allow) && α != 0 && β != 0

Find next pieces of hinge to see if line and curve cross

julia
                            l, c = _find_hinge_next_segments(
+                                α, β, l_start, l_end, c_start, c_end,
+                                i, line, j, curve,
+                            )
+                            next_val, _, _ = _intersection_point(Float64, l, c; exact)
+                            if next_val == line_hinge
+                                !cross_allow && return false
+                            else
+                                !over_allow && return false
+                            end
+                        end
+                    end
+                end

no overlap for a give segment, some of segment must be out of curve

julia
                if j == nc
+                    !out_allow && return false
+                    out_req_met = true
+                end
+            end
+            c_start = c_end  # consider next segment of curve
+            if j == nc  # move on to next line segment
+                i += 1
+                l_start = l_end
+            end
+        end
+    end
+    return in_req_met && on_req_met && out_req_met
+end
+
+#= If entire segment (le to ls) isn't covered by segment (cs to ce), find remaining section
+part of section outside of cs to ce. If completely covered, increase segment index i. =#
+function _find_new_seg(i, ls, le, cs, ce)
+    break_off = true
+    if _point_segment_orientation(le, cs, ce) != point_out
+        ls = le
+        i += 1
+    elseif !equals(ls, cs) && _point_segment_orientation(cs, ls, le) != point_out
+        ls = cs
+    elseif !equals(ls, ce) && _point_segment_orientation(ce, ls, le) != point_out
+        ls = ce
+    else
+        break_off = false
+    end
+    return i, ls, break_off
+end
+
+#= Find next set of segments needed to determine if given hinge segments cross or not.=#
+function _find_hinge_next_segments(α, β, ls, le, cs, ce, i, line, j, curve)
+    next_seg = if β == 1
+        if α == 1  # hinge at endpoints, so next segment of both is needed
+            ((le, _tuple_point(GI.getpoint(line, i + 1))), (ce, _tuple_point(GI.getpoint(curve, j + 1))))
+        else  # hinge at curve endpoint and line interior point, curve next segment needed
+            ((ls, le), (ce, _tuple_point(GI.getpoint(curve, j + 1))))
+        end
+    else  # hinge at curve interior point and line endpoint, line next segment needed
+        ((le, _tuple_point(GI.getpoint(line, i + 1))), (cs, ce))
+    end
+    return next_seg
+end

Determines if a line meets the given checks with respect to a polygon.

If in_allow is true, segments of the line can be in the polygon interior. If on_allow is true, segments of the line can be on the polygon's boundary. If out_allow is true, segments of the line can be outside of the polygon.

If in_require is true, the interiors of the line and polygon must meet in at least one point. If on_require is true, the line must have at least one point on the polygon'same boundary. If out_require is true, the line must have at least one point outside of the polygon.

If the point is in an "allowed" location and meets all requirements, return true. Else, return false.

If closed_line is true, line is treated as a closed line where the first and last point are connected by a segment.

julia
@inline function _line_polygon_process(line, polygon; kw...)
+    skip, returnval = _maybe_skip_disjoint_extents(line, polygon; kw...)
+    skip && return returnval
+    return _inner_line_polygon_process(line, polygon; kw...)
+end
+
+function _inner_line_polygon_process(
+    line, polygon;
+    in_allow, on_allow, out_allow,
+    in_require, on_require, out_require,
+    exact, closed_line = false,
+)
+    in_req_met = !in_require
+    on_req_met = !on_require
+    out_req_met = !out_require

Check interaction of line with polygon's exterior boundary

julia
    in_curve, on_curve, out_curve = _line_filled_curve_interactions(
+        line, GI.getexterior(polygon);
+        exact, closed_line = closed_line,
+    )
+    if on_curve
+        !on_allow && return false
+        on_req_met = true
+    end
+    if out_curve
+        !out_allow && return false
+        out_req_met = true
+    end

If no points within the polygon, the line is disjoint and we are done

julia
    !in_curve && return in_req_met && on_req_met && out_req_met

Loop over polygon holes

julia
    for hole in GI.gethole(polygon)
+        in_hole, on_hole, out_hole =_line_filled_curve_interactions(
+            line, hole;
+            exact, closed_line = closed_line,
+        )
+        if in_hole  # line in hole is equivalent to being out of polygon
+            !out_allow && return false
+            out_req_met = true
+        end
+        if on_hole  # hole boundary is polygon boundary
+            !on_allow && return false
+            on_req_met = true
+        end
+        if !out_hole  # entire line is in/on hole, can't be in/on other holes
+            in_curve = false
+            break
+        end
+    end
+    if in_curve  # entirely of curve isn't within a hole
+        !in_allow && return false
+        in_req_met = true
+    end
+    return in_req_met && on_req_met && out_req_met
+end

Determines if a polygon meets the given checks with respect to a polygon.

If in_allow is true, the polygon's interiors must intersect. If on_allow is true, the one of the polygon's boundaries must either interact with the other polygon's boundary or interior. If out_allow is true, the first polygon must have interior regions outside of the second polygon.

If in_require is true, the polygon interiors must meet in at least one point. If on_require is true, one of the polygon's must have at least one boundary point in or on the other polygon. If out_require is true, the first polygon must have at least one interior point outside of the second polygon.

If the point is in an "allowed" location and meets all requirements, return true. Else, return false.

julia
@inline function _polygon_polygon_process(poly1, poly2; kw...)
+    skip, returnval = _maybe_skip_disjoint_extents(poly1, poly2; kw...)
+    skip && return returnval
+    return _inner_polygon_polygon_process(poly1, poly2; kw...)
+end
+
+function _inner_polygon_polygon_process(
+    poly1, poly2;
+    in_allow, on_allow, out_allow,
+    in_require, on_require, out_require,
+    exact,
+)
+    in_req_met = !in_require
+    on_req_met = !on_require
+    out_req_met = !out_require

Check if exterior of poly1 is within poly2

julia
    ext1 = GI.getexterior(poly1)
+    ext2 = GI.getexterior(poly2)

Check if exterior of poly1 is in polygon 2

julia
    e1_in_p2, e1_on_p2, e1_out_p2 = _line_polygon_interactions(
+        ext1, poly2;
+        exact, closed_line = true,
+    )
+    if e1_on_p2
+        !on_allow && return false
+        on_req_met = true
+    end
+    if e1_out_p2
+        !out_allow && return false
+        out_req_met = true
+    end
+
+    if !e1_in_p2

if exterior ring isn't in poly2, check if it surrounds poly2

julia
        _, _, e2_out_e1 = _line_filled_curve_interactions(
+            ext2, ext1;
+            exact, closed_line = true,
+        )  # if they really are disjoint, we are done
+        e2_out_e1 && return in_req_met && on_req_met && out_req_met
+    end

If interiors interact, check if poly2 interacts with any of poly1's holes

julia
    for h1 in GI.gethole(poly1)
+        h1_in_p2, h1_on_p2, h1_out_p2 = _line_polygon_interactions(
+            h1, poly2;
+            exact, closed_line = true,
+        )
+        if h1_on_p2
+            !on_allow && return false
+            on_req_met = true
+        end
+        if h1_out_p2
+            !out_allow && return false
+            out_req_met = true
+        end
+        if !h1_in_p2

If hole isn't in poly2, see if poly2 is in hole

julia
            _, _, e2_out_h1 = _line_filled_curve_interactions(
+                ext2, h1;
+                exact, closed_line = true,
+            )

hole encompasses all of poly2

julia
            !e2_out_h1 && return in_req_met && on_req_met && out_req_met
+            break
+        end
+    end
+    #=
+    poly2 isn't outside of poly1 and isn't in a hole, poly1 interior must
+    interact with poly2 interior
+    =#
+    !in_allow && return false
+    in_req_met = true

If any of poly2 holes are within poly1, part of poly1 is exterior to poly2

julia
    for h2 in GI.gethole(poly2)
+        h2_in_p1, h2_on_p1, _ = _line_polygon_interactions(
+            h2, poly1;
+            exact, closed_line = true,
+        )
+        if h2_on_p1
+            !on_allow && return false
+            on_req_met = true
+        end
+        if h2_in_p1
+            !out_allow && return false
+            out_req_met = true
+        end
+    end
+    return in_req_met && on_req_met && out_req_met
+end

Determines if a point is in, on, or out of a segment. If the point is on the segment it is on one of the segments endpoints. If it is in, it is on any other point of the segment. If the point is not on any part of the segment, it is out of the segment.

Point should be an object of point trait and curve should be an object with a linestring or linearring trait.

Can provide values of in, on, and out keywords, which determines return values for each scenario.

julia
function _point_segment_orientation(
+    point, start, stop;
+    in::T = point_in, on::T = point_on, out::T = point_out,
+) where {T}

Parse out points

julia
    x, y = GI.x(point), GI.y(point)
+    x1, y1 = GI.x(start), GI.y(start)
+    x2, y2 = GI.x(stop), GI.y(stop)
+    Δx_seg = x2 - x1
+    Δy_seg = y2 - y1
+    Δx_pt = x - x1
+    Δy_pt = y - y1
+    if (Δx_pt == 0 && Δy_pt == 0) || (Δx_pt == Δx_seg && Δy_pt == Δy_seg)

If point is equal to the segment start or end points

julia
        return on
+    else
+        #=
+        Determine if the point is on the segment -> see if vector from segment
+        start to point is parallel to segment and if point is between the
+        segment endpoints
+        =#
+        on_line = _isparallel(Δx_seg, Δy_seg, Δx_pt, Δy_pt)
+        !on_line && return out
+        between_endpoints =
+            (x2 > x1 ? x1 <= x <= x2 : x2 <= x <= x1) &&
+            (y2 > y1 ? y1 <= y <= y2 : y2 <= y <= y1)
+        !between_endpoints && return out
+    end
+    return in
+end

Determine if point is in, on, or out of a closed curve, which includes the space enclosed by the closed curve.

In means the point is within the closed curve (excluding edges and vertices). On means the point is on an edge or a vertex of the closed curve. Out means the point is outside of the closed curve.

Point should be an object of point trait and curve should be an object with a linestring or linearring trait, that is assumed to be closed, regardless of repeated last point.

Can provide values of in, on, and out keywords, which determines return values for each scenario.

Note that this uses the Algorithm by Hao and Sun (2018): https://doi.org/10.3390/sym10100477 Paper separates orientation of point and edge into 26 cases. For each case, it is either a case where the point is on the edge (returns on), where a ray from the point (x, y) to infinity along the line y = y cut through the edge (k += 1), or the ray does not pass through the edge (do nothing and continue). If the ray passes through an odd number of edges, it is within the curve, else outside of of the curve if it didn't return 'on'. See paper for more information on cases denoted in comments.

julia
function _point_filled_curve_orientation(
+    point, curve;
+    in::T = point_in, on::T = point_on, out::T = point_out, exact,
+) where {T}
+    x, y = GI.x(point), GI.y(point)
+    n = GI.npoint(curve)
+    n -= equals(GI.getpoint(curve, 1), GI.getpoint(curve, n)) ? 1 : 0
+    k = 0  # counter for ray crossings
+    p_start = GI.getpoint(curve, n)
+    for (i, p_end) in enumerate(GI.getpoint(curve))
+        i > n && break
+        v1 = GI.y(p_start) - y
+        v2 = GI.y(p_end) - y
+        if !((v1 < 0 && v2 < 0) || (v1 > 0 && v2 > 0)) # if not cases 11 or 26
+            u1, u2 = GI.x(p_start) - x, GI.x(p_end) - x
+            f = Predicates.cross((u1, u2), (v1, v2); exact)
+            if v2 > 0 && v1  0                # Case 3, 9, 16, 21, 13, or 24
+                f == 0 && return on         # Case 16 or 21
+                f > 0 && (k += 1)              # Case 3 or 9
+            elseif v1 > 0 && v2  0            # Case 4, 10, 19, 20, 12, or 25
+                f == 0 && return on         # Case 19 or 20
+                f < 0 && (k += 1)              # Case 4 or 10
+            elseif v2 == 0 && v1 < 0           # Case 7, 14, or 17
+                f == 0 && return on         # Case 17
+            elseif v1 == 0 && v2 < 0           # Case 8, 15, or 18
+                f == 0 && return on         # Case 18
+            elseif v1 == 0 && v2 == 0          # Case 1, 2, 5, 6, 22, or 23
+                u2  0 && u1  0 && return on  # Case 1
+                u1  0 && u2  0 && return on  # Case 2
+            end
+        end
+        p_start = p_end
+    end
+    return iseven(k) ? out : in
+end

Determines the types of interactions of a line with a filled-in curve. By filled-in curve, I am referring to the exterior ring of a poylgon, for example.

Returns a tuple of booleans: (in_curve, on_curve, out_curve).

If in_curve is true, some of the lines interior points interact with the curve's interior points. If on_curve is true, endpoints of either the line intersect with the curve or the line interacts with the polygon boundary. If out_curve is true, at least one segments of the line is outside the curve.

If closed_line is true, line is treated as a closed line where the first and last point are connected by a segment.

julia
function _line_filled_curve_interactions(
+    line, curve;
+    exact, closed_line = false,
+)
+    in_curve = false
+    on_curve = false
+    out_curve = false

Determine number of points in curve and line

julia
    nl = GI.npoint(line)
+    nc = GI.npoint(curve)
+    first_last_equal_line = equals(GI.getpoint(line, 1), GI.getpoint(line, nl))
+    first_last_equal_curve = equals(GI.getpoint(curve, 1), GI.getpoint(curve, nc))
+    nl -= first_last_equal_line ? 1 : 0
+    nc -= first_last_equal_curve ? 1 : 0
+    closed_line |= first_last_equal_line

See if first point is in an acceptable orientation

julia
    l_start = _tuple_point(GI.getpoint(line, closed_line ? nl : 1))
+    point_val = _point_filled_curve_orientation(l_start, curve; exact)
+    if point_val == point_in
+        in_curve = true
+    elseif point_val == point_on
+        on_curve = true
+    else  # point_val == point_out
+        out_curve = true
+    end

Check for any intersections between line and curve

julia
    for i in (closed_line ? 1 : 2):nl
+        l_end = _tuple_point(GI.getpoint(line, i))
+        c_start = _tuple_point(GI.getpoint(curve, nc))

If already interacted with all regions of curve, can stop

julia
        in_curve && on_curve && out_curve && break

Check next segment of line against curve

julia
        for j in 1:nc
+            c_end = _tuple_point(GI.getpoint(curve, j))

Check if two line and curve segments meet

julia
            seg_val, _, _ = _intersection_point(Float64, (l_start, l_end), (c_start, c_end); exact)
+            if seg_val != line_out

If line and curve meet, then at least one point is on boundary

julia
                on_curve = true
+                if seg_val == line_cross

When crossing boundary, line is both in and out of curve

julia
                    in_curve = true
+                    out_curve = true
+                else
+                    if seg_val == line_over
+                        sp = _point_segment_orientation(l_start, c_start, c_end)
+                        lp = _point_segment_orientation(l_end, c_start, c_end)
+                        if sp != point_in || lp != point_in
+                            #=
+                            Line crosses over segment endpoint, creating a hinge
+                            with another segment.
+                            =#
+                            seg_val = line_hinge
+                        end
+                    end
+                    if seg_val == line_hinge
+                        #=
+                        Can't determine all types of interactions (in, out) with
+                        hinge as it could pass through multiple other segments
+                        so calculate if segment endpoints and intersections are
+                        in/out of filled curve
+                        =#
+                        ipoints = intersection_points(GI.Line(StaticArrays.SVector(l_start, l_end)), curve)
+                        npoints = length(ipoints)  # since hinge, at least one
+                        dist_from_lstart = let l_start = l_start
+                            x -> _euclid_distance(Float64, x, l_start)
+                        end
+                        sort!(ipoints, by = dist_from_lstart)
+                        p_start = _tuple_point(l_start)
+                        for i in 1:(npoints + 1)
+                            p_end = i  npoints ? _tuple_point(ipoints[i]) : l_end
+                            mid_val = _point_filled_curve_orientation((p_start .+ p_end) ./ 2, curve; exact)
+                            if mid_val == point_in
+                                in_curve = true
+                            elseif mid_val == point_out
+                                out_curve = true
+                            end
+                        end

already checked segment against whole filled curve

julia
                        l_start = l_end
+                        break
+                    end
+                end
+            end
+            c_start = c_end
+        end
+        l_start = l_end
+    end
+    return in_curve, on_curve, out_curve
+end

Determines the types of interactions of a line with a polygon.

Returns a tuple of booleans: (in_poly, on_poly, out_poly).

If in_poly is true, some of the lines interior points interact with the polygon interior points. If in_poly is true, endpoints of either the line intersect with the polygon or the line interacts with the polygon boundary, including hole boundaries. If out_curve is true, at least one segments of the line is outside the polygon, including inside of holes.

If closed_line is true, line is treated as a closed line where the first and last point are connected by a segment.

julia
function _line_polygon_interactions(
+    line, polygon;
+    exact, closed_line = false,
+)
+
+    in_poly, on_poly, out_poly = _line_filled_curve_interactions(
+        line, GI.getexterior(polygon);
+        exact, closed_line = closed_line,
+    )
+    !in_poly && return (in_poly, on_poly, out_poly)

Loop over polygon holes

julia
    for hole in GI.gethole(polygon)
+        in_hole, on_hole, out_hole =_line_filled_curve_interactions(
+            line, hole;
+            exact, closed_line = closed_line,
+        )
+        if in_hole
+            out_poly = true
+        end
+        if on_hole
+            on_poly = true
+        end
+        if !out_hole  # entire line is in/on hole, can't be in/on other holes
+            in_poly = false
+            return (in_poly, on_poly, out_poly)
+        end
+    end
+    return in_poly, on_poly, out_poly
+end

Disjoint extent optimisation: skip work based on geom extent intersection returns Tuple{Bool, Bool} for (skip, returnval)

julia
@inline function _maybe_skip_disjoint_extents(a, b;
+    in_allow, on_allow, out_allow,
+    in_require, on_require, out_require,
+    kw...
+)
+    ext_disjoint = Extents.disjoint(GI.extent(a), GI.extent(b))
+    skip, returnval = if !ext_disjoint

can't tell anything about this case

julia
        false, false
+    elseif out_allow # && ext_disjoint
+        if in_require || on_require
+            true, false
+        else
+            true, true
+        end
+    else  # !out_allow && ext_disjoint

points not allowed in exterior, but geoms are disjoint

julia
        true, false
+    end
+    return skip, returnval
+end

This page was generated using Literate.jl.

`,142)]))}const y=i(l,[["render",t]]);export{g as __pageData,y as default}; diff --git a/previews/PR237/assets/source_methods_geom_relations_intersects.md.ClSocZGa.js b/previews/PR237/assets/source_methods_geom_relations_intersects.md.ClSocZGa.js new file mode 100644 index 000000000..ed0afb6db --- /dev/null +++ b/previews/PR237/assets/source_methods_geom_relations_intersects.md.ClSocZGa.js @@ -0,0 +1,27 @@ +import{_ as i,c as a,a5 as e,o as n}from"./chunks/framework.Cq8AuEls.js";const t="/GeometryOps.jl/previews/PR237/assets/hmxjqbb.DeeQUply.png",g=JSON.parse('{"title":"Intersection checks","description":"","frontmatter":{},"headers":[],"relativePath":"source/methods/geom_relations/intersects.md","filePath":"source/methods/geom_relations/intersects.md","lastUpdated":null}'),p={name:"source/methods/geom_relations/intersects.md"};function l(h,s,k,r,o,d){return n(),a("div",null,s[0]||(s[0]=[e(`

Intersection checks

julia
export intersects

What is intersects?

The intersects function checks if a given geometry intersects with another geometry, or in other words, the either the interiors or boundaries of the two geometries intersect.

To provide an example, consider these two lines:

julia
import GeometryOps as GO
+import GeoInterface as GI
+using Makie
+using CairoMakie
+
+line1 = GI.Line([(124.584961,-12.768946), (126.738281,-17.224758)])
+line2 = GI.Line([(123.354492,-15.961329), (127.22168,-14.008696)])
+f, a, p = lines(GI.getpoint(line1))
+lines!(GI.getpoint(line2))
+f

We can see that they intersect, so we expect intersects to return true, and we can visualize the intersection point in red.

julia
GO.intersects(line1, line2)  # true
true

Implementation

This is the GeoInterface-compatible implementation.

Given that intersects is the exact opposite of disjoint, we simply pass the two inputs variables, swapped in order, to disjoint.

julia
"""
+    intersects(geom1, geom2)::Bool
+
+Return true if the interiors or boundaries of the two geometries interact.
+
+\`intersects\` returns the exact opposite result of \`disjoint\`.
+
+# Example
+
+\`\`\`jldoctest
+import GeoInterface as GI, GeometryOps as GO
+
+line1 = GI.Line([(124.584961,-12.768946), (126.738281,-17.224758)])
+line2 = GI.Line([(123.354492,-15.961329), (127.22168,-14.008696)])
+GO.intersects(line1, line2)

output

julia
true
+\`\`\`
+"""
+intersects(geom1, geom2) = !disjoint(geom1, geom2)

This page was generated using Literate.jl.

`,18)]))}const E=i(p,[["render",l]]);export{g as __pageData,E as default}; diff --git a/previews/PR237/assets/source_methods_geom_relations_intersects.md.ClSocZGa.lean.js b/previews/PR237/assets/source_methods_geom_relations_intersects.md.ClSocZGa.lean.js new file mode 100644 index 000000000..ed0afb6db --- /dev/null +++ b/previews/PR237/assets/source_methods_geom_relations_intersects.md.ClSocZGa.lean.js @@ -0,0 +1,27 @@ +import{_ as i,c as a,a5 as e,o as n}from"./chunks/framework.Cq8AuEls.js";const t="/GeometryOps.jl/previews/PR237/assets/hmxjqbb.DeeQUply.png",g=JSON.parse('{"title":"Intersection checks","description":"","frontmatter":{},"headers":[],"relativePath":"source/methods/geom_relations/intersects.md","filePath":"source/methods/geom_relations/intersects.md","lastUpdated":null}'),p={name:"source/methods/geom_relations/intersects.md"};function l(h,s,k,r,o,d){return n(),a("div",null,s[0]||(s[0]=[e(`

Intersection checks

julia
export intersects

What is intersects?

The intersects function checks if a given geometry intersects with another geometry, or in other words, the either the interiors or boundaries of the two geometries intersect.

To provide an example, consider these two lines:

julia
import GeometryOps as GO
+import GeoInterface as GI
+using Makie
+using CairoMakie
+
+line1 = GI.Line([(124.584961,-12.768946), (126.738281,-17.224758)])
+line2 = GI.Line([(123.354492,-15.961329), (127.22168,-14.008696)])
+f, a, p = lines(GI.getpoint(line1))
+lines!(GI.getpoint(line2))
+f

We can see that they intersect, so we expect intersects to return true, and we can visualize the intersection point in red.

julia
GO.intersects(line1, line2)  # true
true

Implementation

This is the GeoInterface-compatible implementation.

Given that intersects is the exact opposite of disjoint, we simply pass the two inputs variables, swapped in order, to disjoint.

julia
"""
+    intersects(geom1, geom2)::Bool
+
+Return true if the interiors or boundaries of the two geometries interact.
+
+\`intersects\` returns the exact opposite result of \`disjoint\`.
+
+# Example
+
+\`\`\`jldoctest
+import GeoInterface as GI, GeometryOps as GO
+
+line1 = GI.Line([(124.584961,-12.768946), (126.738281,-17.224758)])
+line2 = GI.Line([(123.354492,-15.961329), (127.22168,-14.008696)])
+GO.intersects(line1, line2)

output

julia
true
+\`\`\`
+"""
+intersects(geom1, geom2) = !disjoint(geom1, geom2)

This page was generated using Literate.jl.

`,18)]))}const E=i(p,[["render",l]]);export{g as __pageData,E as default}; diff --git a/previews/PR237/assets/source_methods_geom_relations_overlaps.md.Cw9LQh0J.js b/previews/PR237/assets/source_methods_geom_relations_overlaps.md.Cw9LQh0J.js new file mode 100644 index 000000000..2a8f5a463 --- /dev/null +++ b/previews/PR237/assets/source_methods_geom_relations_overlaps.md.Cw9LQh0J.js @@ -0,0 +1,212 @@ +import{_ as i,c as a,a5 as n,o as l}from"./chunks/framework.Cq8AuEls.js";const p="/GeometryOps.jl/previews/PR237/assets/qhlrwrc.CgiryX2p.png",o=JSON.parse('{"title":"Overlaps","description":"","frontmatter":{},"headers":[],"relativePath":"source/methods/geom_relations/overlaps.md","filePath":"source/methods/geom_relations/overlaps.md","lastUpdated":null}'),t={name:"source/methods/geom_relations/overlaps.md"};function e(h,s,k,r,d,g){return l(),a("div",null,s[0]||(s[0]=[n(`

Overlaps

julia
export overlaps

What is overlaps?

The overlaps function checks if two geometries overlap. Two geometries can only overlap if they have the same dimension, and if they overlap, but one is not contained, within, or equal to the other.

Note that this means it is impossible for a single point to overlap with a single point and a line only overlaps with another line if only a section of each line is collinear.

To provide an example, consider these two lines:

julia
import GeometryOps as GO
+import GeoInterface as GI
+using Makie
+using CairoMakie
+
+l1 = GI.LineString([(0.0, 0.0), (0.0, 10.0)])
+l2 = GI.LineString([(0.0, -10.0), (0.0, 3.0)])
+f, a, p = lines(GI.getpoint(l1), color = :blue)
+scatter!(GI.getpoint(l1), color = :blue)
+lines!(GI.getpoint(l2), color = :orange)
+scatter!(GI.getpoint(l2), color = :orange)
+f

We can see that the two lines overlap in the plot:

julia
GO.overlaps(l1, l2)  # true
true

Implementation

This is the GeoInterface-compatible implementation.

First, we implement a wrapper method that dispatches to the correct implementation based on the geometry trait. This is also used in the implementation, since it's a lot less work!

Note that that since only elements of the same dimension can overlap, any two geometries with traits that are of different dimensions automatically can return false.

For geometries with the same trait dimension, we must make sure that they share a point, an edge, or area for points, lines, and polygons/multipolygons respectively, without being contained.

julia
"""
+    overlaps(geom1, geom2)::Bool
+
+Compare two Geometries of the same dimension and return true if their
+intersection set results in a geometry different from both but of the same
+dimension. This means one geometry cannot be within or contain the other and
+they cannot be equal
+
+# Examples
+\`\`\`jldoctest
+import GeometryOps as GO, GeoInterface as GI
+poly1 = GI.Polygon([[(0,0), (0,5), (5,5), (5,0), (0,0)]])
+poly2 = GI.Polygon([[(1,1), (1,6), (6,6), (6,1), (1,1)]])
+
+GO.overlaps(poly1, poly2)

output

julia
true
+\`\`\`
+"""
+overlaps(geom1, geom2)::Bool = overlaps(
+    GI.trait(geom1),
+    geom1,
+    GI.trait(geom2),
+    geom2,
+)
+
+"""
+    overlaps(::GI.AbstractTrait, geom1, ::GI.AbstractTrait, geom2)::Bool
+
+For any non-specified pair, all have non-matching dimensions, return false.
+"""
+overlaps(::GI.AbstractTrait, geom1, ::GI.AbstractTrait, geom2) = false
+
+"""
+    overlaps(
+        ::GI.MultiPointTrait, points1,
+        ::GI.MultiPointTrait, points2,
+    )::Bool
+
+If the multipoints overlap, meaning some, but not all, of the points within the
+multipoints are shared, return true.
+"""
+function overlaps(
+    ::GI.MultiPointTrait, points1,
+    ::GI.MultiPointTrait, points2,
+)
+    one_diff = false  # assume that all the points are the same
+    one_same = false  # assume that all points are different
+    for p1 in GI.getpoint(points1)
+        match_point = false
+        for p2 in GI.getpoint(points2)
+            if equals(p1, p2)  # Point is shared
+                one_same = true
+                match_point = true
+                break
+            end
+        end
+        one_diff |= !match_point  # Point isn't shared
+        one_same && one_diff && return true
+    end
+    return false
+end
+
+"""
+    overlaps(::GI.LineTrait, line1, ::GI.LineTrait, line)::Bool
+
+If the lines overlap, meaning that they are collinear but each have one endpoint
+outside of the other line, return true. Else false.
+"""
+overlaps(::GI.LineTrait, line1, ::GI.LineTrait, line) =
+    _overlaps((a1, a2), (b1, b2))
+
+"""
+    overlaps(
+        ::Union{GI.LineStringTrait, GI.LinearRing}, line1,
+        ::Union{GI.LineStringTrait, GI.LinearRing}, line2,
+    )::Bool
+
+If the curves overlap, meaning that at least one edge of each curve overlaps,
+return true. Else false.
+"""
+function overlaps(
+    ::Union{GI.LineStringTrait, GI.LinearRing}, line1,
+    ::Union{GI.LineStringTrait, GI.LinearRing}, line2,
+)
+    edges_a, edges_b = map(sort! ∘ to_edges, (line1, line2))
+    for edge_a in edges_a
+        for edge_b in edges_b
+            _overlaps(edge_a, edge_b) && return true
+        end
+    end
+    return false
+end
+
+"""
+    overlaps(
+        trait_a::GI.PolygonTrait, poly_a,
+        trait_b::GI.PolygonTrait, poly_b,
+    )::Bool
+
+If the two polygons intersect with one another, but are not equal, return true.
+Else false.
+"""
+function overlaps(
+    trait_a::GI.PolygonTrait, poly_a,
+    trait_b::GI.PolygonTrait, poly_b,
+)
+    edges_a, edges_b = map(sort! ∘ to_edges, (poly_a, poly_b))
+    return _line_intersects(edges_a, edges_b) &&
+        !equals(trait_a, poly_a, trait_b, poly_b)
+end
+
+"""
+    overlaps(
+        ::GI.PolygonTrait, poly1,
+        ::GI.MultiPolygonTrait, polys2,
+    )::Bool
+
+Return true if polygon overlaps with at least one of the polygons within the
+multipolygon. Else false.
+"""
+function overlaps(
+    ::GI.PolygonTrait, poly1,
+    ::GI.MultiPolygonTrait, polys2,
+)
+    for poly2 in GI.getgeom(polys2)
+        overlaps(poly1, poly2) && return true
+    end
+    return false
+end
+
+"""
+    overlaps(
+        ::GI.MultiPolygonTrait, polys1,
+        ::GI.PolygonTrait, poly2,
+    )::Bool
+
+Return true if polygon overlaps with at least one of the polygons within the
+multipolygon. Else false.
+"""
+overlaps(trait1::GI.MultiPolygonTrait, polys1, trait2::GI.PolygonTrait, poly2) =
+    overlaps(trait2, poly2, trait1, polys1)
+
+"""
+    overlaps(
+        ::GI.MultiPolygonTrait, polys1,
+        ::GI.MultiPolygonTrait, polys2,
+    )::Bool
+
+Return true if at least one pair of polygons from multipolygons overlap. Else
+false.
+"""
+function overlaps(
+    ::GI.MultiPolygonTrait, polys1,
+    ::GI.MultiPolygonTrait, polys2,
+)
+    for poly1 in GI.getgeom(polys1)
+        overlaps(poly1, polys2) && return true
+    end
+    return false
+end
+
+#= If the edges overlap, meaning that they are collinear but each have one endpoint
+outside of the other edge, return true. Else false. =#
+function _overlaps(
+    (a1, a2)::Edge,
+    (b1, b2)::Edge,
+    exact = _False(),
+)

meets in more than one point

julia
    seg_val, _, _ = _intersection_point(Float64, (a1, a2), (b1, b2); exact)

one end point is outside of other segment

julia
    a_fully_within = _point_on_seg(a1, b1, b2) && _point_on_seg(a2, b1, b2)
+    b_fully_within = _point_on_seg(b1, a1, a2) && _point_on_seg(b2, a1, a2)
+    return seg_val == line_over && (!a_fully_within && !b_fully_within)
+end
+
+#= TODO: Once overlaps is swapped over to use the geom relations workflow, can
+delete these helpers. =#

Checks if point is on a segment

julia
function _point_on_seg(point, start, stop)

Parse out points

julia
    x, y = GI.x(point), GI.y(point)
+    x1, y1 = GI.x(start), GI.y(start)
+    x2, y2 = GI.x(stop), GI.y(stop)
+    Δxl = x2 - x1
+    Δyl = y2 - y1

Determine if point is on segment

julia
    cross = (x - x1) * Δyl - (y - y1) * Δxl
+    if cross == 0  # point is on line extending to infinity

is line between endpoints

julia
        if abs(Δxl) >= abs(Δyl)  # is line between endpoints
+            return Δxl > 0 ? x1 <= x <= x2 : x2 <= x <= x1
+        else
+            return Δyl > 0 ? y1 <= y <= y2 : y2 <= y <= y1
+        end
+    end
+    return false
+end
+
+#= Returns true if there is at least one intersection between edges within the
+two lists of edges. =#
+function _line_intersects(
+    edges_a::Vector{<:Edge},
+    edges_b::Vector{<:Edge};
+)

Extents.intersects(to_extent(edges_a), to_extent(edges_b)) || return false

julia
    for edge_a in edges_a
+        for edge_b in edges_b
+            _line_intersects(edge_a, edge_b) && return true
+        end
+    end
+    return false
+end

Returns true if there is at least one intersection between two edges.

julia
function _line_intersects(edge_a::Edge, edge_b::Edge)
+    seg_val, _, _ = _intersection_point(Float64, edge_a, edge_b; exact = _False())
+    return seg_val != line_out
+end

This page was generated using Literate.jl.

`,37)]))}const E=i(t,[["render",e]]);export{o as __pageData,E as default}; diff --git a/previews/PR237/assets/source_methods_geom_relations_overlaps.md.Cw9LQh0J.lean.js b/previews/PR237/assets/source_methods_geom_relations_overlaps.md.Cw9LQh0J.lean.js new file mode 100644 index 000000000..2a8f5a463 --- /dev/null +++ b/previews/PR237/assets/source_methods_geom_relations_overlaps.md.Cw9LQh0J.lean.js @@ -0,0 +1,212 @@ +import{_ as i,c as a,a5 as n,o as l}from"./chunks/framework.Cq8AuEls.js";const p="/GeometryOps.jl/previews/PR237/assets/qhlrwrc.CgiryX2p.png",o=JSON.parse('{"title":"Overlaps","description":"","frontmatter":{},"headers":[],"relativePath":"source/methods/geom_relations/overlaps.md","filePath":"source/methods/geom_relations/overlaps.md","lastUpdated":null}'),t={name:"source/methods/geom_relations/overlaps.md"};function e(h,s,k,r,d,g){return l(),a("div",null,s[0]||(s[0]=[n(`

Overlaps

julia
export overlaps

What is overlaps?

The overlaps function checks if two geometries overlap. Two geometries can only overlap if they have the same dimension, and if they overlap, but one is not contained, within, or equal to the other.

Note that this means it is impossible for a single point to overlap with a single point and a line only overlaps with another line if only a section of each line is collinear.

To provide an example, consider these two lines:

julia
import GeometryOps as GO
+import GeoInterface as GI
+using Makie
+using CairoMakie
+
+l1 = GI.LineString([(0.0, 0.0), (0.0, 10.0)])
+l2 = GI.LineString([(0.0, -10.0), (0.0, 3.0)])
+f, a, p = lines(GI.getpoint(l1), color = :blue)
+scatter!(GI.getpoint(l1), color = :blue)
+lines!(GI.getpoint(l2), color = :orange)
+scatter!(GI.getpoint(l2), color = :orange)
+f

We can see that the two lines overlap in the plot:

julia
GO.overlaps(l1, l2)  # true
true

Implementation

This is the GeoInterface-compatible implementation.

First, we implement a wrapper method that dispatches to the correct implementation based on the geometry trait. This is also used in the implementation, since it's a lot less work!

Note that that since only elements of the same dimension can overlap, any two geometries with traits that are of different dimensions automatically can return false.

For geometries with the same trait dimension, we must make sure that they share a point, an edge, or area for points, lines, and polygons/multipolygons respectively, without being contained.

julia
"""
+    overlaps(geom1, geom2)::Bool
+
+Compare two Geometries of the same dimension and return true if their
+intersection set results in a geometry different from both but of the same
+dimension. This means one geometry cannot be within or contain the other and
+they cannot be equal
+
+# Examples
+\`\`\`jldoctest
+import GeometryOps as GO, GeoInterface as GI
+poly1 = GI.Polygon([[(0,0), (0,5), (5,5), (5,0), (0,0)]])
+poly2 = GI.Polygon([[(1,1), (1,6), (6,6), (6,1), (1,1)]])
+
+GO.overlaps(poly1, poly2)

output

julia
true
+\`\`\`
+"""
+overlaps(geom1, geom2)::Bool = overlaps(
+    GI.trait(geom1),
+    geom1,
+    GI.trait(geom2),
+    geom2,
+)
+
+"""
+    overlaps(::GI.AbstractTrait, geom1, ::GI.AbstractTrait, geom2)::Bool
+
+For any non-specified pair, all have non-matching dimensions, return false.
+"""
+overlaps(::GI.AbstractTrait, geom1, ::GI.AbstractTrait, geom2) = false
+
+"""
+    overlaps(
+        ::GI.MultiPointTrait, points1,
+        ::GI.MultiPointTrait, points2,
+    )::Bool
+
+If the multipoints overlap, meaning some, but not all, of the points within the
+multipoints are shared, return true.
+"""
+function overlaps(
+    ::GI.MultiPointTrait, points1,
+    ::GI.MultiPointTrait, points2,
+)
+    one_diff = false  # assume that all the points are the same
+    one_same = false  # assume that all points are different
+    for p1 in GI.getpoint(points1)
+        match_point = false
+        for p2 in GI.getpoint(points2)
+            if equals(p1, p2)  # Point is shared
+                one_same = true
+                match_point = true
+                break
+            end
+        end
+        one_diff |= !match_point  # Point isn't shared
+        one_same && one_diff && return true
+    end
+    return false
+end
+
+"""
+    overlaps(::GI.LineTrait, line1, ::GI.LineTrait, line)::Bool
+
+If the lines overlap, meaning that they are collinear but each have one endpoint
+outside of the other line, return true. Else false.
+"""
+overlaps(::GI.LineTrait, line1, ::GI.LineTrait, line) =
+    _overlaps((a1, a2), (b1, b2))
+
+"""
+    overlaps(
+        ::Union{GI.LineStringTrait, GI.LinearRing}, line1,
+        ::Union{GI.LineStringTrait, GI.LinearRing}, line2,
+    )::Bool
+
+If the curves overlap, meaning that at least one edge of each curve overlaps,
+return true. Else false.
+"""
+function overlaps(
+    ::Union{GI.LineStringTrait, GI.LinearRing}, line1,
+    ::Union{GI.LineStringTrait, GI.LinearRing}, line2,
+)
+    edges_a, edges_b = map(sort! ∘ to_edges, (line1, line2))
+    for edge_a in edges_a
+        for edge_b in edges_b
+            _overlaps(edge_a, edge_b) && return true
+        end
+    end
+    return false
+end
+
+"""
+    overlaps(
+        trait_a::GI.PolygonTrait, poly_a,
+        trait_b::GI.PolygonTrait, poly_b,
+    )::Bool
+
+If the two polygons intersect with one another, but are not equal, return true.
+Else false.
+"""
+function overlaps(
+    trait_a::GI.PolygonTrait, poly_a,
+    trait_b::GI.PolygonTrait, poly_b,
+)
+    edges_a, edges_b = map(sort! ∘ to_edges, (poly_a, poly_b))
+    return _line_intersects(edges_a, edges_b) &&
+        !equals(trait_a, poly_a, trait_b, poly_b)
+end
+
+"""
+    overlaps(
+        ::GI.PolygonTrait, poly1,
+        ::GI.MultiPolygonTrait, polys2,
+    )::Bool
+
+Return true if polygon overlaps with at least one of the polygons within the
+multipolygon. Else false.
+"""
+function overlaps(
+    ::GI.PolygonTrait, poly1,
+    ::GI.MultiPolygonTrait, polys2,
+)
+    for poly2 in GI.getgeom(polys2)
+        overlaps(poly1, poly2) && return true
+    end
+    return false
+end
+
+"""
+    overlaps(
+        ::GI.MultiPolygonTrait, polys1,
+        ::GI.PolygonTrait, poly2,
+    )::Bool
+
+Return true if polygon overlaps with at least one of the polygons within the
+multipolygon. Else false.
+"""
+overlaps(trait1::GI.MultiPolygonTrait, polys1, trait2::GI.PolygonTrait, poly2) =
+    overlaps(trait2, poly2, trait1, polys1)
+
+"""
+    overlaps(
+        ::GI.MultiPolygonTrait, polys1,
+        ::GI.MultiPolygonTrait, polys2,
+    )::Bool
+
+Return true if at least one pair of polygons from multipolygons overlap. Else
+false.
+"""
+function overlaps(
+    ::GI.MultiPolygonTrait, polys1,
+    ::GI.MultiPolygonTrait, polys2,
+)
+    for poly1 in GI.getgeom(polys1)
+        overlaps(poly1, polys2) && return true
+    end
+    return false
+end
+
+#= If the edges overlap, meaning that they are collinear but each have one endpoint
+outside of the other edge, return true. Else false. =#
+function _overlaps(
+    (a1, a2)::Edge,
+    (b1, b2)::Edge,
+    exact = _False(),
+)

meets in more than one point

julia
    seg_val, _, _ = _intersection_point(Float64, (a1, a2), (b1, b2); exact)

one end point is outside of other segment

julia
    a_fully_within = _point_on_seg(a1, b1, b2) && _point_on_seg(a2, b1, b2)
+    b_fully_within = _point_on_seg(b1, a1, a2) && _point_on_seg(b2, a1, a2)
+    return seg_val == line_over && (!a_fully_within && !b_fully_within)
+end
+
+#= TODO: Once overlaps is swapped over to use the geom relations workflow, can
+delete these helpers. =#

Checks if point is on a segment

julia
function _point_on_seg(point, start, stop)

Parse out points

julia
    x, y = GI.x(point), GI.y(point)
+    x1, y1 = GI.x(start), GI.y(start)
+    x2, y2 = GI.x(stop), GI.y(stop)
+    Δxl = x2 - x1
+    Δyl = y2 - y1

Determine if point is on segment

julia
    cross = (x - x1) * Δyl - (y - y1) * Δxl
+    if cross == 0  # point is on line extending to infinity

is line between endpoints

julia
        if abs(Δxl) >= abs(Δyl)  # is line between endpoints
+            return Δxl > 0 ? x1 <= x <= x2 : x2 <= x <= x1
+        else
+            return Δyl > 0 ? y1 <= y <= y2 : y2 <= y <= y1
+        end
+    end
+    return false
+end
+
+#= Returns true if there is at least one intersection between edges within the
+two lists of edges. =#
+function _line_intersects(
+    edges_a::Vector{<:Edge},
+    edges_b::Vector{<:Edge};
+)

Extents.intersects(to_extent(edges_a), to_extent(edges_b)) || return false

julia
    for edge_a in edges_a
+        for edge_b in edges_b
+            _line_intersects(edge_a, edge_b) && return true
+        end
+    end
+    return false
+end

Returns true if there is at least one intersection between two edges.

julia
function _line_intersects(edge_a::Edge, edge_b::Edge)
+    seg_val, _, _ = _intersection_point(Float64, edge_a, edge_b; exact = _False())
+    return seg_val != line_out
+end

This page was generated using Literate.jl.

`,37)]))}const E=i(t,[["render",e]]);export{o as __pageData,E as default}; diff --git a/previews/PR237/assets/source_methods_geom_relations_touches.md.B6goQM2o.js b/previews/PR237/assets/source_methods_geom_relations_touches.md.B6goQM2o.js new file mode 100644 index 000000000..1955597e6 --- /dev/null +++ b/previews/PR237/assets/source_methods_geom_relations_touches.md.B6goQM2o.js @@ -0,0 +1,174 @@ +import{_ as i,c as a,a5 as n,o as t}from"./chunks/framework.Cq8AuEls.js";const h="/GeometryOps.jl/previews/PR237/assets/qvfopfk.BEFUMtlf.png",o=JSON.parse('{"title":"Touches","description":"","frontmatter":{},"headers":[],"relativePath":"source/methods/geom_relations/touches.md","filePath":"source/methods/geom_relations/touches.md","lastUpdated":null}'),l={name:"source/methods/geom_relations/touches.md"};function e(p,s,k,r,E,g){return t(),a("div",null,s[0]||(s[0]=[n(`

Touches

julia
export touches

What is touches?

The touches function checks if one geometry touches another geometry. In other words, the interiors of the two geometries don't interact, but one of the geometries must have a boundary point that interacts with either the other geometry's interior or boundary.

To provide an example, consider these two lines:

julia
import GeometryOps as GO
+import GeoInterface as GI
+using Makie
+using CairoMakie
+
+l1 = GI.Line([(0.0, 0.0), (1.0, 0.0)])
+l2 = GI.Line([(1.0, 0.0), (1.0, -1.0)])
+
+f, a, p = lines(GI.getpoint(l1))
+lines!(GI.getpoint(l2))
+f

We can see that these two lines touch only at their endpoints.

julia
GO.touches(l1, l2)  # true
true

Implementation

This is the GeoInterface-compatible implementation.

First, we implement a wrapper method that dispatches to the correct implementation based on the geometry trait.

Each of these calls a method in the geom_geom_processors file. The methods in this file determine if the given geometries meet a set of criteria. For the touches function and arguments g1 and g2, this criteria is as follows: - points of g1 are not allowed to be in the interior of g2 - points of g1 are allowed to be on the boundary of g2 - points of g1 are allowed to be in the exterior of g2 - no points of g1 are required to be in the interior of g2 - at least one point of g1 is required to be on the boundary of g2 - no points of g1 are required to be in the exterior of g2

The code for the specific implementations is in the geom_geom_processors file.

julia
const TOUCHES_POINT_ALLOWED = (in_allow = false, on_allow = true, out_allow = false)
+const TOUCHES_CURVE_ALLOWED = (over_allow = false, cross_allow = false, on_allow = true, out_allow = true)
+const TOUCHES_POLYGON_ALLOWS = (in_allow = false, on_allow = true, out_allow = true)
+const TOUCHES_REQUIRES = (in_require = false, on_require = true, out_require = false)
+const TOUCHES_EXACT = (exact = _False(),)
+
+"""
+    touches(geom1, geom2)::Bool
+
+Return \`true\` if the first geometry touches the second geometry. In other words,
+the two interiors cannot interact, but one of the geometries must have a
+boundary point that interacts with either the other geometry's interior or
+boundary.
+
+# Examples
+\`\`\`jldoctest setup=:(using GeometryOps, GeometryBasics)
+import GeometryOps as GO, GeoInterface as GI
+
+l1 = GI.Line([(0.0, 0.0), (1.0, 0.0)])
+l2 = GI.Line([(1.0, 1.0), (1.0, -1.0)])
+
+GO.touches(l1, l2)

output

julia
true
+\`\`\`
+"""
+touches(g1, g2)::Bool = _touches(trait(g1), g1, trait(g2), g2)

Convert features to geometries

julia
_touches(::GI.FeatureTrait, g1, ::Any, g2) = touches(GI.geometry(g1), g2)
+_touches(::Any, g1, t2::GI.FeatureTrait, g2) = touches(g1, GI.geometry(g2))
+_touches(::FeatureTrait, g1, ::FeatureTrait, g2) = touches(GI.geometry(g1), GI.geometry(g2))

Point touches geometries

Point cannot touch another point as if they are equal, interiors interact

julia
_touches(
+    ::GI.PointTrait, g1,
+    ::GI.PointTrait, g2,
+) = false

Point touches a linestring if it equal to the first of last point of the line

julia
function _touches(
+    ::GI.PointTrait, g1,
+    ::Union{GI.LineTrait, GI.LineStringTrait}, g2,
+)
+    n = GI.npoint(g2)
+    p1 = GI.getpoint(g2, 1)
+    pn = GI.getpoint(g2, n)
+    equals(p1, pn) && return false
+    return equals(g1, p1) || equals(g1, pn)
+end

Point cannot 'touch' a linearring given that the ring has no boundary points

julia
_touches(
+    ::GI.PointTrait, g1,
+    ::GI.LinearRingTrait, g2,
+) = false

Point touches a polygon if it is on the boundary of that polygon

julia
_touches(
+    ::GI.PointTrait, g1,
+    ::GI.PolygonTrait, g2,
+) = _point_polygon_process(
+    g1, g2;
+    TOUCHES_POINT_ALLOWED...,
+    TOUCHES_EXACT...,
+)
+
+#= Geometry touches a point if the point is on the geometry boundary. =#
+_touches(
+    trait1::Union{GI.AbstractCurveTrait, GI.PolygonTrait}, g1,
+    trait2::GI.PointTrait, g2,
+) = _touches(trait2, g2, trait1, g1)

Lines touching geometries

julia
#= Linestring touches another line if at least one boundary point interacts with
+the boundary of interior of the other line, but the interiors don't interact. =#
+_touches(
+    ::Union{GI.LineTrait, GI.LineStringTrait}, g1,
+    ::Union{GI.LineTrait, GI.LineStringTrait}, g2,
+) = _line_curve_process(
+    g1, g2;
+    TOUCHES_CURVE_ALLOWED...,
+    TOUCHES_REQUIRES...,
+    TOUCHES_EXACT...,
+    closed_line = false,
+    closed_curve = false,
+)
+
+
+#= Linestring touches a linearring if at least one of the boundary points of the
+line interacts with the linear ring, but their interiors can't interact. =#
+_touches(
+    ::Union{GI.LineTrait, GI.LineStringTrait}, g1,
+    ::GI.LinearRingTrait, g2,
+) = _line_curve_process(
+    g1, g2;
+    TOUCHES_CURVE_ALLOWED...,
+    TOUCHES_REQUIRES...,
+    TOUCHES_EXACT...,
+    closed_line = false,
+    closed_curve = true,
+)
+
+#= Linestring touches a polygon if at least one of the boundary points of the
+line interacts with the boundary of the polygon. =#
+_touches(
+    ::Union{GI.LineTrait, GI.LineStringTrait}, g1,
+    ::GI.PolygonTrait, g2,
+) = _line_polygon_process(
+    g1, g2;
+    TOUCHES_POLYGON_ALLOWS...,
+    TOUCHES_REQUIRES...,
+    TOUCHES_EXACT...,
+    closed_line = false,
+)

Rings touch geometries

julia
#= Linearring touches a linestring if at least one of the boundary points of the
+line interacts with the linear ring, but their interiors can't interact. =#
+_touches(
+    trait1::GI.LinearRingTrait, g1,
+    trait2::Union{GI.LineTrait, GI.LineStringTrait}, g2,
+) = _touches(trait2, g2, trait1, g1)
+
+#= Linearring cannot touch another linear ring since they are both exclusively
+made up of interior points and no boundary points =#
+_touches(
+    ::GI.LinearRingTrait, g1,
+    ::GI.LinearRingTrait, g2,
+) = false
+
+#= Linearring touches a polygon if at least one of the points of the ring
+interact with the polygon boundary and non are in the polygon interior. =#
+_touches(
+    ::GI.LinearRingTrait, g1,
+    ::GI.PolygonTrait, g2,
+) = _line_polygon_process(
+    g1, g2;
+    TOUCHES_POLYGON_ALLOWS...,
+    TOUCHES_REQUIRES...,
+    TOUCHES_EXACT...,
+    closed_line = true,
+)

Polygons touch geometries

julia
#= Polygon touches a curve if at least one of the curve boundary points interacts
+with the polygon's boundary and no curve points interact with the interior.=#
+_touches(
+    trait1::GI.PolygonTrait, g1,
+    trait2::GI.AbstractCurveTrait, g2
+) = _touches(trait2, g2, trait1, g1)
+
+
+#= Polygon touches another polygon if they share at least one boundary point and
+no interior points. =#
+_touches(
+    ::GI.PolygonTrait, g1,
+    ::GI.PolygonTrait, g2,
+) = _polygon_polygon_process(
+    g1, g2;
+    TOUCHES_POLYGON_ALLOWS...,
+    TOUCHES_REQUIRES...,
+    TOUCHES_EXACT...,
+)

Geometries touch multi-geometry/geometry collections

julia
#= Geometry touch a multi-geometry or a collection if the geometry touches at
+least one of the elements of the collection. =#
+function _touches(
+    ::Union{GI.PointTrait, GI.AbstractCurveTrait, GI.PolygonTrait}, g1,
+    ::Union{
+        GI.MultiPointTrait, GI.AbstractMultiCurveTrait,
+        GI.MultiPolygonTrait, GI.GeometryCollectionTrait,
+    }, g2,
+)
+    for sub_g2 in GI.getgeom(g2)
+        !touches(g1, sub_g2) && return false
+    end
+    return true
+end

Multi-geometry/geometry collections cross geometries

julia
#= Multi-geometry or a geometry collection touches a geometry if at least one
+elements of the collection touches the geometry. =#
+function _touches(
+    ::Union{
+        GI.MultiPointTrait, GI.AbstractMultiCurveTrait,
+        GI.MultiPolygonTrait, GI.GeometryCollectionTrait,
+    }, g1,
+    ::GI.AbstractGeometryTrait, g2,
+)
+    for sub_g1 in GI.getgeom(g1)
+        !touches(sub_g1, g2) && return false
+    end
+    return true
+end

This page was generated using Literate.jl.

`,41)]))}const y=i(l,[["render",e]]);export{o as __pageData,y as default}; diff --git a/previews/PR237/assets/source_methods_geom_relations_touches.md.B6goQM2o.lean.js b/previews/PR237/assets/source_methods_geom_relations_touches.md.B6goQM2o.lean.js new file mode 100644 index 000000000..1955597e6 --- /dev/null +++ b/previews/PR237/assets/source_methods_geom_relations_touches.md.B6goQM2o.lean.js @@ -0,0 +1,174 @@ +import{_ as i,c as a,a5 as n,o as t}from"./chunks/framework.Cq8AuEls.js";const h="/GeometryOps.jl/previews/PR237/assets/qvfopfk.BEFUMtlf.png",o=JSON.parse('{"title":"Touches","description":"","frontmatter":{},"headers":[],"relativePath":"source/methods/geom_relations/touches.md","filePath":"source/methods/geom_relations/touches.md","lastUpdated":null}'),l={name:"source/methods/geom_relations/touches.md"};function e(p,s,k,r,E,g){return t(),a("div",null,s[0]||(s[0]=[n(`

Touches

julia
export touches

What is touches?

The touches function checks if one geometry touches another geometry. In other words, the interiors of the two geometries don't interact, but one of the geometries must have a boundary point that interacts with either the other geometry's interior or boundary.

To provide an example, consider these two lines:

julia
import GeometryOps as GO
+import GeoInterface as GI
+using Makie
+using CairoMakie
+
+l1 = GI.Line([(0.0, 0.0), (1.0, 0.0)])
+l2 = GI.Line([(1.0, 0.0), (1.0, -1.0)])
+
+f, a, p = lines(GI.getpoint(l1))
+lines!(GI.getpoint(l2))
+f

We can see that these two lines touch only at their endpoints.

julia
GO.touches(l1, l2)  # true
true

Implementation

This is the GeoInterface-compatible implementation.

First, we implement a wrapper method that dispatches to the correct implementation based on the geometry trait.

Each of these calls a method in the geom_geom_processors file. The methods in this file determine if the given geometries meet a set of criteria. For the touches function and arguments g1 and g2, this criteria is as follows: - points of g1 are not allowed to be in the interior of g2 - points of g1 are allowed to be on the boundary of g2 - points of g1 are allowed to be in the exterior of g2 - no points of g1 are required to be in the interior of g2 - at least one point of g1 is required to be on the boundary of g2 - no points of g1 are required to be in the exterior of g2

The code for the specific implementations is in the geom_geom_processors file.

julia
const TOUCHES_POINT_ALLOWED = (in_allow = false, on_allow = true, out_allow = false)
+const TOUCHES_CURVE_ALLOWED = (over_allow = false, cross_allow = false, on_allow = true, out_allow = true)
+const TOUCHES_POLYGON_ALLOWS = (in_allow = false, on_allow = true, out_allow = true)
+const TOUCHES_REQUIRES = (in_require = false, on_require = true, out_require = false)
+const TOUCHES_EXACT = (exact = _False(),)
+
+"""
+    touches(geom1, geom2)::Bool
+
+Return \`true\` if the first geometry touches the second geometry. In other words,
+the two interiors cannot interact, but one of the geometries must have a
+boundary point that interacts with either the other geometry's interior or
+boundary.
+
+# Examples
+\`\`\`jldoctest setup=:(using GeometryOps, GeometryBasics)
+import GeometryOps as GO, GeoInterface as GI
+
+l1 = GI.Line([(0.0, 0.0), (1.0, 0.0)])
+l2 = GI.Line([(1.0, 1.0), (1.0, -1.0)])
+
+GO.touches(l1, l2)

output

julia
true
+\`\`\`
+"""
+touches(g1, g2)::Bool = _touches(trait(g1), g1, trait(g2), g2)

Convert features to geometries

julia
_touches(::GI.FeatureTrait, g1, ::Any, g2) = touches(GI.geometry(g1), g2)
+_touches(::Any, g1, t2::GI.FeatureTrait, g2) = touches(g1, GI.geometry(g2))
+_touches(::FeatureTrait, g1, ::FeatureTrait, g2) = touches(GI.geometry(g1), GI.geometry(g2))

Point touches geometries

Point cannot touch another point as if they are equal, interiors interact

julia
_touches(
+    ::GI.PointTrait, g1,
+    ::GI.PointTrait, g2,
+) = false

Point touches a linestring if it equal to the first of last point of the line

julia
function _touches(
+    ::GI.PointTrait, g1,
+    ::Union{GI.LineTrait, GI.LineStringTrait}, g2,
+)
+    n = GI.npoint(g2)
+    p1 = GI.getpoint(g2, 1)
+    pn = GI.getpoint(g2, n)
+    equals(p1, pn) && return false
+    return equals(g1, p1) || equals(g1, pn)
+end

Point cannot 'touch' a linearring given that the ring has no boundary points

julia
_touches(
+    ::GI.PointTrait, g1,
+    ::GI.LinearRingTrait, g2,
+) = false

Point touches a polygon if it is on the boundary of that polygon

julia
_touches(
+    ::GI.PointTrait, g1,
+    ::GI.PolygonTrait, g2,
+) = _point_polygon_process(
+    g1, g2;
+    TOUCHES_POINT_ALLOWED...,
+    TOUCHES_EXACT...,
+)
+
+#= Geometry touches a point if the point is on the geometry boundary. =#
+_touches(
+    trait1::Union{GI.AbstractCurveTrait, GI.PolygonTrait}, g1,
+    trait2::GI.PointTrait, g2,
+) = _touches(trait2, g2, trait1, g1)

Lines touching geometries

julia
#= Linestring touches another line if at least one boundary point interacts with
+the boundary of interior of the other line, but the interiors don't interact. =#
+_touches(
+    ::Union{GI.LineTrait, GI.LineStringTrait}, g1,
+    ::Union{GI.LineTrait, GI.LineStringTrait}, g2,
+) = _line_curve_process(
+    g1, g2;
+    TOUCHES_CURVE_ALLOWED...,
+    TOUCHES_REQUIRES...,
+    TOUCHES_EXACT...,
+    closed_line = false,
+    closed_curve = false,
+)
+
+
+#= Linestring touches a linearring if at least one of the boundary points of the
+line interacts with the linear ring, but their interiors can't interact. =#
+_touches(
+    ::Union{GI.LineTrait, GI.LineStringTrait}, g1,
+    ::GI.LinearRingTrait, g2,
+) = _line_curve_process(
+    g1, g2;
+    TOUCHES_CURVE_ALLOWED...,
+    TOUCHES_REQUIRES...,
+    TOUCHES_EXACT...,
+    closed_line = false,
+    closed_curve = true,
+)
+
+#= Linestring touches a polygon if at least one of the boundary points of the
+line interacts with the boundary of the polygon. =#
+_touches(
+    ::Union{GI.LineTrait, GI.LineStringTrait}, g1,
+    ::GI.PolygonTrait, g2,
+) = _line_polygon_process(
+    g1, g2;
+    TOUCHES_POLYGON_ALLOWS...,
+    TOUCHES_REQUIRES...,
+    TOUCHES_EXACT...,
+    closed_line = false,
+)

Rings touch geometries

julia
#= Linearring touches a linestring if at least one of the boundary points of the
+line interacts with the linear ring, but their interiors can't interact. =#
+_touches(
+    trait1::GI.LinearRingTrait, g1,
+    trait2::Union{GI.LineTrait, GI.LineStringTrait}, g2,
+) = _touches(trait2, g2, trait1, g1)
+
+#= Linearring cannot touch another linear ring since they are both exclusively
+made up of interior points and no boundary points =#
+_touches(
+    ::GI.LinearRingTrait, g1,
+    ::GI.LinearRingTrait, g2,
+) = false
+
+#= Linearring touches a polygon if at least one of the points of the ring
+interact with the polygon boundary and non are in the polygon interior. =#
+_touches(
+    ::GI.LinearRingTrait, g1,
+    ::GI.PolygonTrait, g2,
+) = _line_polygon_process(
+    g1, g2;
+    TOUCHES_POLYGON_ALLOWS...,
+    TOUCHES_REQUIRES...,
+    TOUCHES_EXACT...,
+    closed_line = true,
+)

Polygons touch geometries

julia
#= Polygon touches a curve if at least one of the curve boundary points interacts
+with the polygon's boundary and no curve points interact with the interior.=#
+_touches(
+    trait1::GI.PolygonTrait, g1,
+    trait2::GI.AbstractCurveTrait, g2
+) = _touches(trait2, g2, trait1, g1)
+
+
+#= Polygon touches another polygon if they share at least one boundary point and
+no interior points. =#
+_touches(
+    ::GI.PolygonTrait, g1,
+    ::GI.PolygonTrait, g2,
+) = _polygon_polygon_process(
+    g1, g2;
+    TOUCHES_POLYGON_ALLOWS...,
+    TOUCHES_REQUIRES...,
+    TOUCHES_EXACT...,
+)

Geometries touch multi-geometry/geometry collections

julia
#= Geometry touch a multi-geometry or a collection if the geometry touches at
+least one of the elements of the collection. =#
+function _touches(
+    ::Union{GI.PointTrait, GI.AbstractCurveTrait, GI.PolygonTrait}, g1,
+    ::Union{
+        GI.MultiPointTrait, GI.AbstractMultiCurveTrait,
+        GI.MultiPolygonTrait, GI.GeometryCollectionTrait,
+    }, g2,
+)
+    for sub_g2 in GI.getgeom(g2)
+        !touches(g1, sub_g2) && return false
+    end
+    return true
+end

Multi-geometry/geometry collections cross geometries

julia
#= Multi-geometry or a geometry collection touches a geometry if at least one
+elements of the collection touches the geometry. =#
+function _touches(
+    ::Union{
+        GI.MultiPointTrait, GI.AbstractMultiCurveTrait,
+        GI.MultiPolygonTrait, GI.GeometryCollectionTrait,
+    }, g1,
+    ::GI.AbstractGeometryTrait, g2,
+)
+    for sub_g1 in GI.getgeom(g1)
+        !touches(sub_g1, g2) && return false
+    end
+    return true
+end

This page was generated using Literate.jl.

`,41)]))}const y=i(l,[["render",e]]);export{o as __pageData,y as default}; diff --git a/previews/PR237/assets/source_methods_geom_relations_within.md.BPrebRYc.js b/previews/PR237/assets/source_methods_geom_relations_within.md.BPrebRYc.js new file mode 100644 index 000000000..69fa8ca67 --- /dev/null +++ b/previews/PR237/assets/source_methods_geom_relations_within.md.BPrebRYc.js @@ -0,0 +1,193 @@ +import{_ as i,c as a,a5 as n,o as h}from"./chunks/framework.Cq8AuEls.js";const t="/GeometryOps.jl/previews/PR237/assets/xeijnvc._0R9BbFk.png",o=JSON.parse('{"title":"Within","description":"","frontmatter":{},"headers":[],"relativePath":"source/methods/geom_relations/within.md","filePath":"source/methods/geom_relations/within.md","lastUpdated":null}'),l={name:"source/methods/geom_relations/within.md"};function e(p,s,k,r,E,g){return h(),a("div",null,s[0]||(s[0]=[n(`

Within

julia
export within

What is within?

The within function checks if one geometry is inside another geometry. This requires that the two interiors intersect and that the interior and boundary of the first geometry is not in the exterior of the second geometry.

To provide an example, consider these two lines:

julia
import GeometryOps as GO
+import GeoInterface as GI
+using Makie
+using CairoMakie
+
+l1 = GI.LineString([(0.0, 0.0), (1.0, 0.0), (0.0, 0.1)])
+l2 = GI.LineString([(0.25, 0.0), (0.75, 0.0)])
+f, a, p = lines(GI.getpoint(l1), color = :blue)
+scatter!(GI.getpoint(l1), color = :blue)
+lines!(GI.getpoint(l2), color = :orange)
+scatter!(GI.getpoint(l2), color = :orange)
+f

We can see that all of the points and edges of l2 are within l1, so l2 is within l1, but l1 is not within l2

julia
GO.within(l1, l2)  # false
+GO.within(l2, l1)  # true
true

Implementation

This is the GeoInterface-compatible implementation.

First, we implement a wrapper method that dispatches to the correct implementation based on the geometry trait.

Each of these calls a method in the geom_geom_processors file. The methods in this file determine if the given geometries meet a set of criteria. For the within function and arguments g1 and g2, this criteria is as follows: - points of g1 are allowed to be in the interior of g2 (either through overlap or crossing for lines) - points of g1 are allowed to be on the boundary of g2 - points of g1 are not allowed to be in the exterior of g2 - at least one point of g1 is required to be in the interior of g2 - no points of g1 are required to be on the boundary of g2 - no points of g1 are required to be in the exterior of g2

The code for the specific implementations is in the geom_geom_processors file.

julia
const WITHIN_POINT_ALLOWS = (in_allow = true, on_allow = false, out_allow = false)
+const WITHIN_CURVE_ALLOWS = (over_allow = true, cross_allow = true, on_allow = true, out_allow = false)
+const WITHIN_POLYGON_ALLOWS = (in_allow = true, on_allow = true, out_allow = false)
+const WITHIN_REQUIRES = (in_require = true, on_require = false, out_require = false)
+const WITHIN_EXACT = (exact = _False(),)
+
+"""
+    within(geom1, geom2)::Bool
+
+Return \`true\` if the first geometry is completely within the second geometry.
+The interiors of both geometries must intersect and the interior and boundary of
+the primary geometry (geom1) must not intersect the exterior of the secondary
+geometry (geom2).
+
+Furthermore, \`within\` returns the exact opposite result of \`contains\`.
+
+# Examples
+\`\`\`jldoctest setup=:(using GeometryOps, GeometryBasics)
+import GeometryOps as GO, GeoInterface as GI
+
+line = GI.LineString([(1, 1), (1, 2), (1, 3), (1, 4)])
+point = (1, 2)
+GO.within(point, line)

output

julia
true
+\`\`\`
+"""
+within(g1, g2) = _within(trait(g1), g1, trait(g2), g2)

Convert features to geometries

julia
_within(::GI.FeatureTrait, g1, ::Any, g2) = within(GI.geometry(g1), g2)
+_within(::Any, g1, t2::GI.FeatureTrait, g2) = within(g1, GI.geometry(g2))
+_within(::FeatureTrait, g1, ::FeatureTrait, g2) = within(GI.geometry(g1), GI.geometry(g2))

Points within geometries

Point is within another point if those points are equal.

julia
_within(
+    ::GI.PointTrait, g1,
+    ::GI.PointTrait, g2,
+) = equals(g1, g2)
+
+#= Point is within a linestring if it is on a vertex or an edge of that line,
+excluding the start and end vertex if the line is not closed. =#
+_within(
+    ::GI.PointTrait, g1,
+    ::Union{GI.LineTrait, GI.LineStringTrait}, g2,
+) = _point_curve_process(
+    g1, g2;
+    WITHIN_POINT_ALLOWS...,
+    closed_curve = false,
+)

Point is within a linearring if it is on a vertex or an edge of that ring.

julia
_within(
+    ::GI.PointTrait, g1,
+    ::GI.LinearRingTrait, g2,
+) = _point_curve_process(
+    g1, g2;
+    WITHIN_POINT_ALLOWS...,
+    closed_curve = true,
+)
+
+#= Point is within a polygon if it is inside of that polygon, excluding edges,
+vertices, and holes. =#
+_within(
+    ::GI.PointTrait, g1,
+    ::GI.PolygonTrait, g2,
+) = _point_polygon_process(
+    g1, g2;
+    WITHIN_POINT_ALLOWS...,
+    WITHIN_EXACT...,
+)

No geometries other than points can be within points

julia
_within(
+    ::Union{GI.AbstractCurveTrait, GI.PolygonTrait}, g1,
+    ::GI.PointTrait, g2,
+) = false

Lines within geometries

julia
#= Linestring is within another linestring if their interiors intersect and no
+points of the first line are in the exterior of the second line. =#
+_within(
+    ::Union{GI.LineTrait, GI.LineStringTrait}, g1,
+    ::Union{GI.LineTrait, GI.LineStringTrait}, g2,
+) = _line_curve_process(
+    g1, g2;
+    WITHIN_CURVE_ALLOWS...,
+    WITHIN_REQUIRES...,
+    WITHIN_EXACT...,
+    closed_line = false,
+    closed_curve = false,
+)
+
+#= Linestring is within a linear ring if their interiors intersect and no points
+of the line are in the exterior of the ring. =#
+_within(
+    ::Union{GI.LineTrait, GI.LineStringTrait}, g1,
+    ::GI.LinearRingTrait, g2,
+) = _line_curve_process(
+    g1, g2;
+    WITHIN_CURVE_ALLOWS...,
+    WITHIN_REQUIRES...,
+    WITHIN_EXACT...,
+    closed_line = false,
+    closed_curve = true,
+)
+
+#= Linestring is within a polygon if their interiors intersect and no points of
+the line are in the exterior of the polygon, although they can be on an edge. =#
+_within(
+    ::Union{GI.LineTrait, GI.LineStringTrait}, g1,
+    ::GI.PolygonTrait, g2,
+) = _line_polygon_process(
+    g1, g2;
+    WITHIN_POLYGON_ALLOWS...,
+    WITHIN_REQUIRES...,
+    WITHIN_EXACT...,
+    closed_line = false,
+)

Rings covered by geometries

julia
#= Linearring is within a linestring if their interiors intersect and no points
+of the ring are in the exterior of the line. =#
+_within(
+    ::GI.LinearRingTrait, g1,
+    ::Union{GI.LineTrait, GI.LineStringTrait}, g2,
+) = _line_curve_process(
+    g1, g2;
+    WITHIN_CURVE_ALLOWS...,
+    WITHIN_REQUIRES...,
+    WITHIN_EXACT...,
+    closed_line = true,
+    closed_curve = false,
+)
+
+#= Linearring is within another linearring if their interiors intersect and no
+points of the first ring are in the exterior of the second ring. =#
+_within(
+    ::GI.LinearRingTrait, g1,
+    ::GI.LinearRingTrait, g2,
+) = _line_curve_process(
+    g1, g2;
+    WITHIN_CURVE_ALLOWS...,
+    WITHIN_REQUIRES...,
+    WITHIN_EXACT...,
+    closed_line = true,
+    closed_curve = true,
+)
+
+#= Linearring is within a polygon if their interiors intersect and no points of
+the ring are in the exterior of the polygon, although they can be on an edge. =#
+_within(
+    ::GI.LinearRingTrait, g1,
+    ::GI.PolygonTrait, g2,
+) = _line_polygon_process(
+    g1, g2;
+    WITHIN_POLYGON_ALLOWS...,
+    WITHIN_REQUIRES...,
+    WITHIN_EXACT...,
+    closed_line = true,
+)

Polygons within geometries

julia
#= Polygon is within another polygon if the interior of the first polygon
+intersects with the interior of the second and no points of the first polygon
+are outside of the second polygon. =#
+_within(
+    ::GI.PolygonTrait, g1,
+    ::GI.PolygonTrait, g2,
+) = _polygon_polygon_process(
+    g1, g2;
+    WITHIN_POLYGON_ALLOWS...,
+    WITHIN_REQUIRES...,
+    WITHIN_EXACT...,
+)

Polygons cannot be within any curves

julia
_within(
+    ::GI.PolygonTrait, g1,
+    ::GI.AbstractCurveTrait, g2,
+) = false

Geometries within multi-geometry/geometry collections

julia
#= Geometry is within a multi-geometry or a collection if the geometry is within
+at least one of the collection elements. =#
+function _within(
+    ::Union{GI.PointTrait, GI.AbstractCurveTrait, GI.PolygonTrait}, g1,
+    ::Union{
+        GI.MultiPointTrait, GI.AbstractMultiCurveTrait,
+        GI.MultiPolygonTrait, GI.GeometryCollectionTrait,
+    }, g2,
+)
+    for sub_g2 in GI.getgeom(g2)
+        within(g1, sub_g2) && return true
+    end
+    return false
+end

Multi-geometry/geometry collections within geometries

julia
#= Multi-geometry or a geometry collection is within a geometry if all
+elements of the collection are within the geometry. =#
+function _within(
+    ::Union{
+        GI.MultiPointTrait, GI.AbstractMultiCurveTrait,
+        GI.MultiPolygonTrait, GI.GeometryCollectionTrait,
+    }, g1,
+    ::GI.AbstractGeometryTrait, g2,
+)
+    for sub_g1 in GI.getgeom(g1)
+        !within(sub_g1, g2) && return false
+    end
+    return true
+end

This page was generated using Literate.jl.

`,41)]))}const y=i(l,[["render",e]]);export{o as __pageData,y as default}; diff --git a/previews/PR237/assets/source_methods_geom_relations_within.md.BPrebRYc.lean.js b/previews/PR237/assets/source_methods_geom_relations_within.md.BPrebRYc.lean.js new file mode 100644 index 000000000..69fa8ca67 --- /dev/null +++ b/previews/PR237/assets/source_methods_geom_relations_within.md.BPrebRYc.lean.js @@ -0,0 +1,193 @@ +import{_ as i,c as a,a5 as n,o as h}from"./chunks/framework.Cq8AuEls.js";const t="/GeometryOps.jl/previews/PR237/assets/xeijnvc._0R9BbFk.png",o=JSON.parse('{"title":"Within","description":"","frontmatter":{},"headers":[],"relativePath":"source/methods/geom_relations/within.md","filePath":"source/methods/geom_relations/within.md","lastUpdated":null}'),l={name:"source/methods/geom_relations/within.md"};function e(p,s,k,r,E,g){return h(),a("div",null,s[0]||(s[0]=[n(`

Within

julia
export within

What is within?

The within function checks if one geometry is inside another geometry. This requires that the two interiors intersect and that the interior and boundary of the first geometry is not in the exterior of the second geometry.

To provide an example, consider these two lines:

julia
import GeometryOps as GO
+import GeoInterface as GI
+using Makie
+using CairoMakie
+
+l1 = GI.LineString([(0.0, 0.0), (1.0, 0.0), (0.0, 0.1)])
+l2 = GI.LineString([(0.25, 0.0), (0.75, 0.0)])
+f, a, p = lines(GI.getpoint(l1), color = :blue)
+scatter!(GI.getpoint(l1), color = :blue)
+lines!(GI.getpoint(l2), color = :orange)
+scatter!(GI.getpoint(l2), color = :orange)
+f

We can see that all of the points and edges of l2 are within l1, so l2 is within l1, but l1 is not within l2

julia
GO.within(l1, l2)  # false
+GO.within(l2, l1)  # true
true

Implementation

This is the GeoInterface-compatible implementation.

First, we implement a wrapper method that dispatches to the correct implementation based on the geometry trait.

Each of these calls a method in the geom_geom_processors file. The methods in this file determine if the given geometries meet a set of criteria. For the within function and arguments g1 and g2, this criteria is as follows: - points of g1 are allowed to be in the interior of g2 (either through overlap or crossing for lines) - points of g1 are allowed to be on the boundary of g2 - points of g1 are not allowed to be in the exterior of g2 - at least one point of g1 is required to be in the interior of g2 - no points of g1 are required to be on the boundary of g2 - no points of g1 are required to be in the exterior of g2

The code for the specific implementations is in the geom_geom_processors file.

julia
const WITHIN_POINT_ALLOWS = (in_allow = true, on_allow = false, out_allow = false)
+const WITHIN_CURVE_ALLOWS = (over_allow = true, cross_allow = true, on_allow = true, out_allow = false)
+const WITHIN_POLYGON_ALLOWS = (in_allow = true, on_allow = true, out_allow = false)
+const WITHIN_REQUIRES = (in_require = true, on_require = false, out_require = false)
+const WITHIN_EXACT = (exact = _False(),)
+
+"""
+    within(geom1, geom2)::Bool
+
+Return \`true\` if the first geometry is completely within the second geometry.
+The interiors of both geometries must intersect and the interior and boundary of
+the primary geometry (geom1) must not intersect the exterior of the secondary
+geometry (geom2).
+
+Furthermore, \`within\` returns the exact opposite result of \`contains\`.
+
+# Examples
+\`\`\`jldoctest setup=:(using GeometryOps, GeometryBasics)
+import GeometryOps as GO, GeoInterface as GI
+
+line = GI.LineString([(1, 1), (1, 2), (1, 3), (1, 4)])
+point = (1, 2)
+GO.within(point, line)

output

julia
true
+\`\`\`
+"""
+within(g1, g2) = _within(trait(g1), g1, trait(g2), g2)

Convert features to geometries

julia
_within(::GI.FeatureTrait, g1, ::Any, g2) = within(GI.geometry(g1), g2)
+_within(::Any, g1, t2::GI.FeatureTrait, g2) = within(g1, GI.geometry(g2))
+_within(::FeatureTrait, g1, ::FeatureTrait, g2) = within(GI.geometry(g1), GI.geometry(g2))

Points within geometries

Point is within another point if those points are equal.

julia
_within(
+    ::GI.PointTrait, g1,
+    ::GI.PointTrait, g2,
+) = equals(g1, g2)
+
+#= Point is within a linestring if it is on a vertex or an edge of that line,
+excluding the start and end vertex if the line is not closed. =#
+_within(
+    ::GI.PointTrait, g1,
+    ::Union{GI.LineTrait, GI.LineStringTrait}, g2,
+) = _point_curve_process(
+    g1, g2;
+    WITHIN_POINT_ALLOWS...,
+    closed_curve = false,
+)

Point is within a linearring if it is on a vertex or an edge of that ring.

julia
_within(
+    ::GI.PointTrait, g1,
+    ::GI.LinearRingTrait, g2,
+) = _point_curve_process(
+    g1, g2;
+    WITHIN_POINT_ALLOWS...,
+    closed_curve = true,
+)
+
+#= Point is within a polygon if it is inside of that polygon, excluding edges,
+vertices, and holes. =#
+_within(
+    ::GI.PointTrait, g1,
+    ::GI.PolygonTrait, g2,
+) = _point_polygon_process(
+    g1, g2;
+    WITHIN_POINT_ALLOWS...,
+    WITHIN_EXACT...,
+)

No geometries other than points can be within points

julia
_within(
+    ::Union{GI.AbstractCurveTrait, GI.PolygonTrait}, g1,
+    ::GI.PointTrait, g2,
+) = false

Lines within geometries

julia
#= Linestring is within another linestring if their interiors intersect and no
+points of the first line are in the exterior of the second line. =#
+_within(
+    ::Union{GI.LineTrait, GI.LineStringTrait}, g1,
+    ::Union{GI.LineTrait, GI.LineStringTrait}, g2,
+) = _line_curve_process(
+    g1, g2;
+    WITHIN_CURVE_ALLOWS...,
+    WITHIN_REQUIRES...,
+    WITHIN_EXACT...,
+    closed_line = false,
+    closed_curve = false,
+)
+
+#= Linestring is within a linear ring if their interiors intersect and no points
+of the line are in the exterior of the ring. =#
+_within(
+    ::Union{GI.LineTrait, GI.LineStringTrait}, g1,
+    ::GI.LinearRingTrait, g2,
+) = _line_curve_process(
+    g1, g2;
+    WITHIN_CURVE_ALLOWS...,
+    WITHIN_REQUIRES...,
+    WITHIN_EXACT...,
+    closed_line = false,
+    closed_curve = true,
+)
+
+#= Linestring is within a polygon if their interiors intersect and no points of
+the line are in the exterior of the polygon, although they can be on an edge. =#
+_within(
+    ::Union{GI.LineTrait, GI.LineStringTrait}, g1,
+    ::GI.PolygonTrait, g2,
+) = _line_polygon_process(
+    g1, g2;
+    WITHIN_POLYGON_ALLOWS...,
+    WITHIN_REQUIRES...,
+    WITHIN_EXACT...,
+    closed_line = false,
+)

Rings covered by geometries

julia
#= Linearring is within a linestring if their interiors intersect and no points
+of the ring are in the exterior of the line. =#
+_within(
+    ::GI.LinearRingTrait, g1,
+    ::Union{GI.LineTrait, GI.LineStringTrait}, g2,
+) = _line_curve_process(
+    g1, g2;
+    WITHIN_CURVE_ALLOWS...,
+    WITHIN_REQUIRES...,
+    WITHIN_EXACT...,
+    closed_line = true,
+    closed_curve = false,
+)
+
+#= Linearring is within another linearring if their interiors intersect and no
+points of the first ring are in the exterior of the second ring. =#
+_within(
+    ::GI.LinearRingTrait, g1,
+    ::GI.LinearRingTrait, g2,
+) = _line_curve_process(
+    g1, g2;
+    WITHIN_CURVE_ALLOWS...,
+    WITHIN_REQUIRES...,
+    WITHIN_EXACT...,
+    closed_line = true,
+    closed_curve = true,
+)
+
+#= Linearring is within a polygon if their interiors intersect and no points of
+the ring are in the exterior of the polygon, although they can be on an edge. =#
+_within(
+    ::GI.LinearRingTrait, g1,
+    ::GI.PolygonTrait, g2,
+) = _line_polygon_process(
+    g1, g2;
+    WITHIN_POLYGON_ALLOWS...,
+    WITHIN_REQUIRES...,
+    WITHIN_EXACT...,
+    closed_line = true,
+)

Polygons within geometries

julia
#= Polygon is within another polygon if the interior of the first polygon
+intersects with the interior of the second and no points of the first polygon
+are outside of the second polygon. =#
+_within(
+    ::GI.PolygonTrait, g1,
+    ::GI.PolygonTrait, g2,
+) = _polygon_polygon_process(
+    g1, g2;
+    WITHIN_POLYGON_ALLOWS...,
+    WITHIN_REQUIRES...,
+    WITHIN_EXACT...,
+)

Polygons cannot be within any curves

julia
_within(
+    ::GI.PolygonTrait, g1,
+    ::GI.AbstractCurveTrait, g2,
+) = false

Geometries within multi-geometry/geometry collections

julia
#= Geometry is within a multi-geometry or a collection if the geometry is within
+at least one of the collection elements. =#
+function _within(
+    ::Union{GI.PointTrait, GI.AbstractCurveTrait, GI.PolygonTrait}, g1,
+    ::Union{
+        GI.MultiPointTrait, GI.AbstractMultiCurveTrait,
+        GI.MultiPolygonTrait, GI.GeometryCollectionTrait,
+    }, g2,
+)
+    for sub_g2 in GI.getgeom(g2)
+        within(g1, sub_g2) && return true
+    end
+    return false
+end

Multi-geometry/geometry collections within geometries

julia
#= Multi-geometry or a geometry collection is within a geometry if all
+elements of the collection are within the geometry. =#
+function _within(
+    ::Union{
+        GI.MultiPointTrait, GI.AbstractMultiCurveTrait,
+        GI.MultiPolygonTrait, GI.GeometryCollectionTrait,
+    }, g1,
+    ::GI.AbstractGeometryTrait, g2,
+)
+    for sub_g1 in GI.getgeom(g1)
+        !within(sub_g1, g2) && return false
+    end
+    return true
+end

This page was generated using Literate.jl.

`,41)]))}const y=i(l,[["render",e]]);export{o as __pageData,y as default}; diff --git a/previews/PR237/assets/source_methods_orientation.md.D1GOBoW6.js b/previews/PR237/assets/source_methods_orientation.md.D1GOBoW6.js new file mode 100644 index 000000000..b32b2ad7a --- /dev/null +++ b/previews/PR237/assets/source_methods_orientation.md.D1GOBoW6.js @@ -0,0 +1,100 @@ +import{_ as i,c as a,a5 as n,o as l}from"./chunks/framework.Cq8AuEls.js";const E=JSON.parse('{"title":"Orientation","description":"","frontmatter":{},"headers":[],"relativePath":"source/methods/orientation.md","filePath":"source/methods/orientation.md","lastUpdated":null}'),p={name:"source/methods/orientation.md"};function h(t,s,e,k,r,d){return l(),a("div",null,s[0]||(s[0]=[n(`

Orientation

julia
export isclockwise, isconcave

isclockwise

The orientation of a geometry is whether it runs clockwise or counter-clockwise.

This is defined for linestrings, linear rings, or vectors of points.

isconcave

A polygon is concave if it has at least one interior angle greater than 180 degrees, meaning that the interior of the polygon is not a convex set.

These are all adapted from Turf.jl.

The may not necessarily be what want in the end but work for now!

julia
"""
+    isclockwise(line::Union{LineString, Vector{Position}})::Bool
+
+Take a ring and return \`true\` if the line goes clockwise, or \`false\` if the line goes
+counter-clockwise.  "Going clockwise" means, mathematically,
+
+\`\`\`math
+\\\\left(\\\\sum_{i=2}^n (x_i - x_{i-1}) \\\\cdot (y_i + y_{i-1})\\\\right) > 0
+\`\`\`
+
+# Example
+
+\`\`\`julia
+julia> import GeoInterface as GI, GeometryOps as GO
+julia> ring = GI.LinearRing([(0, 0), (1, 1), (1, 0), (0, 0)]);
+julia> GO.isclockwise(ring)

output

julia
true
+\`\`\`
+"""
+isclockwise(geom)::Bool = isclockwise(GI.trait(geom), geom)
+
+function isclockwise(::AbstractCurveTrait, line)::Bool
+    sum = 0.0
+    prev = GI.getpoint(line, 1)
+    for p in GI.getpoint(line)

sum will be zero for the first point as x is subtracted from itself

julia
        sum += (GI.x(p) - GI.x(prev)) * (GI.y(p) + GI.y(prev))
+        prev = p
+    end
+
+    return sum > 0.0
+end
+
+"""
+    isconcave(poly::Polygon)::Bool
+
+Take a polygon and return true or false as to whether it is concave or not.
+
+# Examples
+\`\`\`jldoctest
+import GeoInterface as GI, GeometryOps as GO
+
+poly = GI.Polygon([[(0, 0), (0, 1), (1, 1), (1, 0), (0, 0)]])
+GO.isconcave(poly)

output

julia
false
+\`\`\`
+"""
+function isconcave(poly)::Bool
+    sign = false
+
+    exterior = GI.getexterior(poly)

FIXME handle not closed polygons

julia
    GI.npoint(exterior) <= 4 && return false
+    n = GI.npoint(exterior) - 1
+
+    for i in 1:n
+        j = ((i + 1) % n) === 0 ? 1 : (i + 1) % n
+        m = ((i + 2) % n) === 0 ? 1 : (i + 2) % n
+
+        pti = GI.getpoint(exterior, i)
+        ptj = GI.getpoint(exterior, j)
+        ptm = GI.getpoint(exterior, m)
+
+        dx1 = GI.x(ptm) - GI.x(ptj)
+        dy1 = GI.y(ptm) - GI.y(ptj)
+        dx2 = GI.x(pti) - GI.x(ptj)
+        dy2 = GI.y(pti) - GI.y(ptj)
+
+        cross = (dx1 * dy2) - (dy1 * dx2)
+
+        if i === 0
+            sign = cross > 0
+        elseif sign !== (cross > 0)
+            return true
+        end
+    end
+
+    return false
+end

This is commented out.

julia
"""
+    isparallel(line1::LineString, line2::LineString)::Bool
+
+Return \`true\` if each segment of \`line1\` is parallel to the correspondent segment of \`line2\`
+
+## Examples

julia import GeoInterface as GI, GeometryOps as GO julia> line1 = GI.LineString([(9.170356, 45.477985), (9.164434, 45.482551), (9.166644, 45.484003)]) GeoInterface.Wrappers.LineString{false, false, Vector{Tuple{Float64, Float64}}, Nothing, Nothing}([(9.170356, 45.477985), (9.164434, 45.482551), (9.166644, 45.484003)], nothing, nothing)

julia> line2 = GI.LineString([(9.169356, 45.477985), (9.163434, 45.482551), (9.165644, 45.484003)]) GeoInterface.Wrappers.LineString{false, false, Vector{Tuple{Float64, Float64}}, Nothing, Nothing}([(9.169356, 45.477985), (9.163434, 45.482551), (9.165644, 45.484003)], nothing, nothing)

julia> GO.isparallel(line1, line2) true

"""
+function isparallel(line1, line2)::Bool
+    seg1 = linesegment(line1)
+    seg2 = linesegment(line2)
+
+    for i in eachindex(seg1)
+        coors2 = nothing
+        coors1 = seg1[i]
+        coors2 = seg2[i]
+        _isparallel(coors1, coors2) == false && return false
+    end
+    return true
+end
+
+@inline function _isparallel(p1, p2)
+    slope1 = bearing_to_azimuth(rhumb_bearing(GI.x(p1), GI.x(p2)))
+    slope2 = bearing_to_azimuth(rhumb_bearing(GI.y(p1), GI.y(p2)))
+
+    return slope1 === slope2
+end

This is actual code:

julia
_isparallel(((ax, ay), (bx, by)), ((cx, cy), (dx, dy))) =
+    _isparallel(bx - ax, by - ay, dx - cx, dy - cy)
+
+_isparallel(Δx1, Δy1, Δx2, Δy2) = (Δx1 * Δy2 == Δy1 * Δx2)

This page was generated using Literate.jl.

`,28)]))}const o=i(p,[["render",h]]);export{E as __pageData,o as default}; diff --git a/previews/PR237/assets/source_methods_orientation.md.D1GOBoW6.lean.js b/previews/PR237/assets/source_methods_orientation.md.D1GOBoW6.lean.js new file mode 100644 index 000000000..b32b2ad7a --- /dev/null +++ b/previews/PR237/assets/source_methods_orientation.md.D1GOBoW6.lean.js @@ -0,0 +1,100 @@ +import{_ as i,c as a,a5 as n,o as l}from"./chunks/framework.Cq8AuEls.js";const E=JSON.parse('{"title":"Orientation","description":"","frontmatter":{},"headers":[],"relativePath":"source/methods/orientation.md","filePath":"source/methods/orientation.md","lastUpdated":null}'),p={name:"source/methods/orientation.md"};function h(t,s,e,k,r,d){return l(),a("div",null,s[0]||(s[0]=[n(`

Orientation

julia
export isclockwise, isconcave

isclockwise

The orientation of a geometry is whether it runs clockwise or counter-clockwise.

This is defined for linestrings, linear rings, or vectors of points.

isconcave

A polygon is concave if it has at least one interior angle greater than 180 degrees, meaning that the interior of the polygon is not a convex set.

These are all adapted from Turf.jl.

The may not necessarily be what want in the end but work for now!

julia
"""
+    isclockwise(line::Union{LineString, Vector{Position}})::Bool
+
+Take a ring and return \`true\` if the line goes clockwise, or \`false\` if the line goes
+counter-clockwise.  "Going clockwise" means, mathematically,
+
+\`\`\`math
+\\\\left(\\\\sum_{i=2}^n (x_i - x_{i-1}) \\\\cdot (y_i + y_{i-1})\\\\right) > 0
+\`\`\`
+
+# Example
+
+\`\`\`julia
+julia> import GeoInterface as GI, GeometryOps as GO
+julia> ring = GI.LinearRing([(0, 0), (1, 1), (1, 0), (0, 0)]);
+julia> GO.isclockwise(ring)

output

julia
true
+\`\`\`
+"""
+isclockwise(geom)::Bool = isclockwise(GI.trait(geom), geom)
+
+function isclockwise(::AbstractCurveTrait, line)::Bool
+    sum = 0.0
+    prev = GI.getpoint(line, 1)
+    for p in GI.getpoint(line)

sum will be zero for the first point as x is subtracted from itself

julia
        sum += (GI.x(p) - GI.x(prev)) * (GI.y(p) + GI.y(prev))
+        prev = p
+    end
+
+    return sum > 0.0
+end
+
+"""
+    isconcave(poly::Polygon)::Bool
+
+Take a polygon and return true or false as to whether it is concave or not.
+
+# Examples
+\`\`\`jldoctest
+import GeoInterface as GI, GeometryOps as GO
+
+poly = GI.Polygon([[(0, 0), (0, 1), (1, 1), (1, 0), (0, 0)]])
+GO.isconcave(poly)

output

julia
false
+\`\`\`
+"""
+function isconcave(poly)::Bool
+    sign = false
+
+    exterior = GI.getexterior(poly)

FIXME handle not closed polygons

julia
    GI.npoint(exterior) <= 4 && return false
+    n = GI.npoint(exterior) - 1
+
+    for i in 1:n
+        j = ((i + 1) % n) === 0 ? 1 : (i + 1) % n
+        m = ((i + 2) % n) === 0 ? 1 : (i + 2) % n
+
+        pti = GI.getpoint(exterior, i)
+        ptj = GI.getpoint(exterior, j)
+        ptm = GI.getpoint(exterior, m)
+
+        dx1 = GI.x(ptm) - GI.x(ptj)
+        dy1 = GI.y(ptm) - GI.y(ptj)
+        dx2 = GI.x(pti) - GI.x(ptj)
+        dy2 = GI.y(pti) - GI.y(ptj)
+
+        cross = (dx1 * dy2) - (dy1 * dx2)
+
+        if i === 0
+            sign = cross > 0
+        elseif sign !== (cross > 0)
+            return true
+        end
+    end
+
+    return false
+end

This is commented out.

julia
"""
+    isparallel(line1::LineString, line2::LineString)::Bool
+
+Return \`true\` if each segment of \`line1\` is parallel to the correspondent segment of \`line2\`
+
+## Examples

julia import GeoInterface as GI, GeometryOps as GO julia> line1 = GI.LineString([(9.170356, 45.477985), (9.164434, 45.482551), (9.166644, 45.484003)]) GeoInterface.Wrappers.LineString{false, false, Vector{Tuple{Float64, Float64}}, Nothing, Nothing}([(9.170356, 45.477985), (9.164434, 45.482551), (9.166644, 45.484003)], nothing, nothing)

julia> line2 = GI.LineString([(9.169356, 45.477985), (9.163434, 45.482551), (9.165644, 45.484003)]) GeoInterface.Wrappers.LineString{false, false, Vector{Tuple{Float64, Float64}}, Nothing, Nothing}([(9.169356, 45.477985), (9.163434, 45.482551), (9.165644, 45.484003)], nothing, nothing)

julia> GO.isparallel(line1, line2) true

"""
+function isparallel(line1, line2)::Bool
+    seg1 = linesegment(line1)
+    seg2 = linesegment(line2)
+
+    for i in eachindex(seg1)
+        coors2 = nothing
+        coors1 = seg1[i]
+        coors2 = seg2[i]
+        _isparallel(coors1, coors2) == false && return false
+    end
+    return true
+end
+
+@inline function _isparallel(p1, p2)
+    slope1 = bearing_to_azimuth(rhumb_bearing(GI.x(p1), GI.x(p2)))
+    slope2 = bearing_to_azimuth(rhumb_bearing(GI.y(p1), GI.y(p2)))
+
+    return slope1 === slope2
+end

This is actual code:

julia
_isparallel(((ax, ay), (bx, by)), ((cx, cy), (dx, dy))) =
+    _isparallel(bx - ax, by - ay, dx - cx, dy - cy)
+
+_isparallel(Δx1, Δy1, Δx2, Δy2) = (Δx1 * Δy2 == Δy1 * Δx2)

This page was generated using Literate.jl.

`,28)]))}const o=i(p,[["render",h]]);export{E as __pageData,o as default}; diff --git a/previews/PR237/assets/source_methods_polygonize.md.U6uoZhWE.js b/previews/PR237/assets/source_methods_polygonize.md.U6uoZhWE.js new file mode 100644 index 000000000..50df37663 --- /dev/null +++ b/previews/PR237/assets/source_methods_polygonize.md.U6uoZhWE.js @@ -0,0 +1,289 @@ +import{_ as i,c as a,a5 as n,o as h}from"./chunks/framework.Cq8AuEls.js";const g=JSON.parse('{"title":"Polygonizing raster data","description":"","frontmatter":{},"headers":[],"relativePath":"source/methods/polygonize.md","filePath":"source/methods/polygonize.md","lastUpdated":null}'),l={name:"source/methods/polygonize.md"};function p(t,s,k,e,d,E){return h(),a("div",null,s[0]||(s[0]=[n(`

Polygonizing raster data

julia
export polygonize
+
+#=
+The methods in this file convert a raster image into a set of polygons,
+by contour detection using a clockwise Moore neighborhood method.
+
+The resulting polygons are snapped to the boundaries of the cells of the input raster,
+so they will look different from traditional contours from a plotting package.
+
+The main entry point is the \`polygonize\` function.
+
+\`\`\`@docs
+polygonize
+\`\`\`
+
+# Example
+
+Here's a basic example, using the \`Makie.peaks()\` function.  First, let's investigate the nature of the function:
+\`\`\`@example polygonize
+using Makie, GeometryOps
+n = 49
+xs, ys = LinRange(-3, 3, n), LinRange(-3, 3, n)
+zs = Makie.peaks(n)
+z_max_value = maximum(abs.(extrema(zs)))
+f, a, p = heatmap(
+    xs, ys, zs;
+    axis = (; aspect = DataAspect(), title = "Exact function")
+)
+cb = Colorbar(f[1, 2], p; label = "Z-value")
+f
+\`\`\`
+
+Now, we can use the \`polygonize\` function to convert the raster data into polygons.
+
+For this particular example, we chose a range of z-values between 0.8 and 3.2,
+which would provide two distinct polygons with holes.
+
+\`\`\`@example polygonize
+polygons = polygonize(xs, ys, 0.8 .< zs .< 3.2)
+\`\`\`
+This returns a \`GI.MultiPolygon\`, which is directly plottable.  Let's see how these look:
+
+\`\`\`@example polygonize
+f, a, p = poly(polygons; label = "Polygonized polygons", axis = (; aspect = DataAspect()))
+\`\`\`
+
+Finally, let's plot the Makie contour lines on top, to see how the polygonization compares:
+\`\`\`@example polygonize
+contour!(a, xs, ys, zs; labels = true, levels = [0.8, 3.2], label = "Contour lines")
+f
+\`\`\`
+
+# Implementation
+
+The implementation follows:
+=#
+
+"""
+    polygonize(A::AbstractMatrix{Bool}; kw...)
+    polygonize(f, A::AbstractMatrix; kw...)
+    polygonize(xs, ys, A::AbstractMatrix{Bool}; kw...)
+    polygonize(f, xs, ys, A::AbstractMatrix; kw...)
+
+Polygonize an \`AbstractMatrix\` of values, currently to a single class of polygons.
+
+Returns a \`MultiPolygon\` for \`Bool\` values and \`f\` return values, and
+a \`FeatureCollection\` of \`Feature\`s holding \`MultiPolygon\` for all other values.
+
+
+Function \`f\` should return either \`true\` or \`false\` or a transformation
+of values into simpler groups, especially useful for floating point arrays.
+
+If \`xs\` and \`ys\` are ranges, they are used as the pixel/cell center points.
+If they are \`Vector\` of \`Tuple\` they are used as the lower and upper bounds of each pixel/cell.

Keywords

julia
- \`minpoints\`: ignore polygons with less than \`minpoints\` points.
+- \`values\`: the values to turn into polygons. By default these are \`union(A)\`,
+    If function \`f\` is passed these refer to the return values of \`f\`, by
+    default \`union(map(f, A)\`. If values \`Bool\`, false is ignored and a single
+    \`MultiPolygon\` is returned rather than a \`FeatureCollection\`.

Example

julia
\`\`\`julia
+using GeometryOps
+A = rand(100, 100)
+multipolygon = polygonize(>(0.5), A);
+\`\`\`
+"""
+polygonize(A::AbstractMatrix{Bool}; kw...) = polygonize(identity, A; kw...)
+polygonize(f::Base.Callable, A::AbstractMatrix; kw...) = polygonize(f, axes(A)..., A; kw...)
+polygonize(A::AbstractMatrix; kw...) = polygonize(axes(A)..., A; kw...)
+polygonize(xs::AbstractVector, ys::AbstractVector, A::AbstractMatrix{Bool}; kw...) =
+    _polygonize(identity, xs, ys, A)
+function polygonize(xs::AbstractVector, ys::AbstractVector, A::AbstractMatrix;
+    values=sort!(Base.union(A)), kw...
+)
+    _polygonize_featurecollection(identity, xs, ys, A; values, kw...)
+end
+function polygonize(f::Base.Callable, xs::AbstractRange, ys::AbstractRange, A::AbstractMatrix;
+    values=_default_values(f, A), kw...
+)
+    if isnothing(values)
+        _polygonize(f, xs, ys, A; kw...)
+    else
+        _polygonize_featurecollection(f, xs, ys, A; kw...)
+    end
+end
+function _polygonize(f::Base.Callable, xs::AbstractRange, ys::AbstractRange, A::AbstractMatrix;
+    kw...
+)

Make vectors of pixel bounds

julia
    xhalf = step(xs) / 2
+    yhalf = step(ys) / 2

Make bounds ranges first to avoid floating point error making gaps or overlaps

julia
    xbounds = range(first(xs) - xhalf; step = step(xs), length = length(xs) + 1)
+    ybounds = range(first(ys) - yhalf; step = step(ys), length = length(ys) + 1)
+    Tx = eltype(xbounds)
+    Ty = eltype(ybounds)
+    xvec = similar(Vector{Tuple{Tx,Tx}}, length(xs))
+    yvec = similar(Vector{Tuple{Ty,Ty}}, length(ys))
+    for (xind, i) in enumerate(eachindex(xvec))
+        xvec[i] = xbounds[xind], xbounds[xind+1]
+    end
+    for (yind, i) in enumerate(eachindex(yvec))
+        yvec[i] = ybounds[yind], ybounds[yind+1]
+    end
+    return _polygonize(f, xvec, yvec, A; kw...)
+end
+function _polygonize(f, xs::AbstractVector{T}, ys::AbstractVector{T}, A::AbstractMatrix;
+    minpoints=0,
+) where T<:Tuple
+    (length(xs), length(ys)) == size(A) || throw(ArgumentError("length of xs and ys must match the array size"))

Extract the CRS of the array (if it is some kind of geo array / raster)

julia
    crs = GI.crs(A)

Define buffers for edges and rings

julia
    rings = Vector{T}[]
+
+    strait = true
+    turning = false

Get edges from the array A

julia
    edges = _pixel_edges(f, xs, ys, A)

Keep dict keys separately in a vector for performance

julia
    edgekeys = collect(keys(edges))

We don't delete keys we just reduce length with nkeys

julia
    nkeys = length(edgekeys)

Now create rings from the edges, looping until there are no edge keys left

julia
    while nkeys > 0
+        found = false
+        local firstnode, nextnodes, nodestatus

Loop until we find a key that hasn't been removed, decrementing nkeys as we go.

julia
        while nkeys > 0

Take the first node from the array

julia
            firstnode::T = edgekeys[nkeys]
+            nextnodes = edges[firstnode]
+            nodestatus = map(!=(typemax(first(firstnode)))  first, nextnodes)
+            if any(nodestatus)
+                found = true
+                break
+            else
+                nkeys -= 1
+            end
+        end

If we found nothing this time, we are done

julia
        found == false && break

Check if there are one or two lines going through this node and take one of them, then update the status

julia
        if nodestatus[2]
+            nextnode = nextnodes[2]
+            edges[firstnode] = (nextnodes[1], map(typemax, nextnode))
+        else
+            nkeys -= 1
+            nextnode = nextnodes[1]
+            edges[firstnode] = (map(typemax, nextnode), map(typemax, nextnode))
+        end

Start a new ring

julia
        currentnode = firstnode
+        ring = [currentnode, nextnode]
+        push!(rings, ring)

Loop until we close a the ring and break

julia
        while true

Find a node that matches the next node

julia
            (c1, c2) = possiblenodes = edges[nextnode]
+            nodestatus = map(!=(typemax(first(firstnode)))  first, possiblenodes)
+            if nodestatus[2]

When there are two possible node, choose the node that is the furthest to the left We also need to check if we are on a straight line to avoid adding unnecessary points.

julia
                selectednode, remainingnode, straightline = if currentnode[1] == nextnode[1] # vertical
+                    wasincreasing = nextnode[2] > currentnode[2]
+                    firstisstraight = nextnode[1] == c1[1]
+                    firstisleft = nextnode[1] > c1[1]
+                    secondisstraight = nextnode[1] == c2[1]
+                    secondisleft = nextnode[1] > c2[1]
+                    if firstisstraight
+                        if secondisleft
+                            if wasincreasing
+                                (c2, c1, turning)
+                            else
+                                (c1, c2, straight)
+                            end
+                        else
+                            if wasincreasing
+                                (c1, c2, straight)
+                            else
+                                (c2, c1, secondisstraight)
+                            end
+                        end
+                    elseif firstisleft
+                        if wasincreasing
+                            (c1, c2, turning)
+                        else
+                            (c2, c1, secondisstraight)
+                        end
+                    else # firstisright
+                        if wasincreasing
+                            (c2, c1, secondisstraight)
+                        else
+                            (c1, c2, turning)
+                        end
+                    end
+                else # horizontal
+                    wasincreasing = nextnode[1] > currentnode[1]
+                    firstisstraight = nextnode[2] == c1[2]
+                    firstisleft = nextnode[2] > c1[2]
+                    secondisleft = nextnode[2] > c2[2]
+                    secondisstraight = nextnode[2] == c2[2]
+                    if firstisstraight
+                        if secondisleft
+                            if wasincreasing
+                                (c1, c2, straight)
+                            else
+                                (c2, c1, turning)
+                            end
+                        else
+                            if wasincreasing
+                                (c2, c1, turning)
+                            else
+                                (c1, c2, straight)
+                            end
+                        end
+                    elseif firstisleft
+                        if wasincreasing
+                            (c2, c1, secondisstraight)
+                        else
+                            (c1, c2, turning)
+                        end
+                    else # firstisright
+                        if wasincreasing
+                            (c1, c2, turning)
+                        else
+                            (c2, c1, secondisstraight)
+                        end
+                    end
+                end

Update edges

julia
                edges[nextnode] = (remainingnode, map(typemax, remainingnode))
+            else

Here we simply choose the first (and only valid) node

julia
                selectednode = c1

Replace the edge nodes with empty nodes, they will be skipped later

julia
                edges[nextnode] = (map(typemax, c1), map(typemax, c1))

Check if we are on a straight line

julia
                straightline = currentnode[1] == nextnode[1] == c1[1] ||
+                               currentnode[2] == nextnode[2] == c1[2]
+            end

Update the current and next nodes with the next and selected nodes

julia
            currentnode, nextnode = nextnode, selectednode

Update the current node or add a new node to the ring

julia
            if straightline

replace the last node we don't need it

julia
                ring[end] = nextnode
+            else

add a new node, we have turned a corner

julia
                push!(ring, nextnode)
+            end

If the ring is closed, break the loop and start a new one

julia
            nextnode == firstnode && break
+        end
+    end

Define wrapped LinearRings, with embedded extents so we only calculate them once

julia
    linearrings = map(rings) do ring
+        extent = GI.extent(GI.LinearRing(ring))
+        GI.LinearRing(ring; extent, crs)
+    end

Separate exteriors from holes by winding direction

julia
    direction = (last(last(xs)) - first(first(xs))) * (last(last(ys)) - first(first(ys)))
+    exterior_inds = if direction > 0
+        .!isclockwise.(linearrings)
+    else
+        isclockwise.(linearrings)
+    end
+    holes = linearrings[.!exterior_inds]
+    polygons = map(view(linearrings, exterior_inds)) do lr
+        GI.Polygon([lr]; extent=GI.extent(lr), crs)
+    end

Then we add the holes to the polygons they are inside of

julia
    assigned = fill(false, length(holes))
+    for i in eachindex(holes)
+        hole = holes[i]
+        prepared_hole = GI.LinearRing(holes[i]; extent=GI.extent(holes[i]))
+        for poly in polygons
+            exterior = GI.Polygon(StaticArrays.SVector(GI.getexterior(poly)); extent=GI.extent(poly))
+            if covers(exterior, prepared_hole)

Hole is in the exterior, so add it to the polygon

julia
                push!(poly.geom, hole)
+                assigned[i] = true
+                break
+            end
+        end
+    end
+
+    assigned_holes = count(assigned)
+    assigned_holes == length(holes) || @warn "Not all holes were assigned to polygons, $(length(holes) - assigned_holes) where missed from $(length(holes)) holes and $(length(polygons)) polygons"
+
+    if isempty(polygons)

TODO: this really should return an empty MultiPolygon but GeoInterface wrappers cant do that yet, which is not ideal...

julia
        @warn "No polgons found, check your data or try another function for \`f\`"
+        return nothing
+    else

Otherwise return a wrapped MultiPolygon

julia
        return GI.MultiPolygon(polygons; crs, extent = mapreduce(GI.extent, Extents.union, polygons))
+    end
+end
+
+function _polygonize_featurecollection(f::Base.Callable, xs::AbstractRange, ys::AbstractRange, A::AbstractMatrix;
+    values=_default_values(f, A), kw...
+)
+    crs = GI.crs(A)

Create one feature per value

julia
    features = map(values) do value
+        multipolygon = _polygonize(x -> isequal(f(x), value), xs, ys, A; kw...)
+        GI.Feature(multipolygon; properties=(; value), extent = GI.extent(multipolygon), crs)
+    end
+
+    return GI.FeatureCollection(features; extent = mapreduce(GI.extent, Extents.union, features), crs)
+end
+
+function _default_values(f, A)

Get union of f return values with resolved eltype

julia
    values = map(identity, sort!(Base.union(Iterators.map(f, A))))

We ignore pure Bool

julia
    return eltype(values) == Bool ? nothing : collect(skipmissing(values))
+end
+
+function update_edge!(dict, key, node)
+    newnodes = (node, map(typemax, node))

Get or write in one go, to skip a hash lookup

julia
    existingnodes = get!(() -> newnodes, dict, key)

If we actually fetched an existing node, update it

julia
    if existingnodes[1] != node
+        dict[key] = (existingnodes[1], node)
+    end
+end
+
+function _pixel_edges(f, xs::AbstractVector{T}, ys::AbstractVector{T}, A) where T<:Tuple
+    edges = Dict{T,Tuple{T,T}}()

First we collect all the edges around target pixels

julia
    fi, fj = map(first, axes(A))
+    li, lj = map(last, axes(A))
+    for j in axes(A, 2)
+        y1, y2 = ys[j]
+        for i in axes(A, 1)
+            if f(A[i, j]) # This is a pixel inside a polygon

xs and ys hold pixel bounds

julia
                x1, x2 = xs[i]

We check the Von Neumann neighborhood to decide what edges are needed, if any.

julia
                (j == fi || !f(A[i, j-1])) && update_edge!(edges, (x1, y1), (x2, y1)) # S
+                (i == fj || !f(A[i-1, j])) && update_edge!(edges, (x1, y2), (x1, y1)) # W
+                (j == lj || !f(A[i, j+1])) && update_edge!(edges, (x2, y2), (x1, y2)) # N
+                (i == li || !f(A[i+1, j])) && update_edge!(edges, (x2, y1), (x2, y2)) # E
+            end
+        end
+    end
+    return edges
+end

This page was generated using Literate.jl.

`,86)]))}const y=i(l,[["render",p]]);export{g as __pageData,y as default}; diff --git a/previews/PR237/assets/source_methods_polygonize.md.U6uoZhWE.lean.js b/previews/PR237/assets/source_methods_polygonize.md.U6uoZhWE.lean.js new file mode 100644 index 000000000..50df37663 --- /dev/null +++ b/previews/PR237/assets/source_methods_polygonize.md.U6uoZhWE.lean.js @@ -0,0 +1,289 @@ +import{_ as i,c as a,a5 as n,o as h}from"./chunks/framework.Cq8AuEls.js";const g=JSON.parse('{"title":"Polygonizing raster data","description":"","frontmatter":{},"headers":[],"relativePath":"source/methods/polygonize.md","filePath":"source/methods/polygonize.md","lastUpdated":null}'),l={name:"source/methods/polygonize.md"};function p(t,s,k,e,d,E){return h(),a("div",null,s[0]||(s[0]=[n(`

Polygonizing raster data

julia
export polygonize
+
+#=
+The methods in this file convert a raster image into a set of polygons,
+by contour detection using a clockwise Moore neighborhood method.
+
+The resulting polygons are snapped to the boundaries of the cells of the input raster,
+so they will look different from traditional contours from a plotting package.
+
+The main entry point is the \`polygonize\` function.
+
+\`\`\`@docs
+polygonize
+\`\`\`
+
+# Example
+
+Here's a basic example, using the \`Makie.peaks()\` function.  First, let's investigate the nature of the function:
+\`\`\`@example polygonize
+using Makie, GeometryOps
+n = 49
+xs, ys = LinRange(-3, 3, n), LinRange(-3, 3, n)
+zs = Makie.peaks(n)
+z_max_value = maximum(abs.(extrema(zs)))
+f, a, p = heatmap(
+    xs, ys, zs;
+    axis = (; aspect = DataAspect(), title = "Exact function")
+)
+cb = Colorbar(f[1, 2], p; label = "Z-value")
+f
+\`\`\`
+
+Now, we can use the \`polygonize\` function to convert the raster data into polygons.
+
+For this particular example, we chose a range of z-values between 0.8 and 3.2,
+which would provide two distinct polygons with holes.
+
+\`\`\`@example polygonize
+polygons = polygonize(xs, ys, 0.8 .< zs .< 3.2)
+\`\`\`
+This returns a \`GI.MultiPolygon\`, which is directly plottable.  Let's see how these look:
+
+\`\`\`@example polygonize
+f, a, p = poly(polygons; label = "Polygonized polygons", axis = (; aspect = DataAspect()))
+\`\`\`
+
+Finally, let's plot the Makie contour lines on top, to see how the polygonization compares:
+\`\`\`@example polygonize
+contour!(a, xs, ys, zs; labels = true, levels = [0.8, 3.2], label = "Contour lines")
+f
+\`\`\`
+
+# Implementation
+
+The implementation follows:
+=#
+
+"""
+    polygonize(A::AbstractMatrix{Bool}; kw...)
+    polygonize(f, A::AbstractMatrix; kw...)
+    polygonize(xs, ys, A::AbstractMatrix{Bool}; kw...)
+    polygonize(f, xs, ys, A::AbstractMatrix; kw...)
+
+Polygonize an \`AbstractMatrix\` of values, currently to a single class of polygons.
+
+Returns a \`MultiPolygon\` for \`Bool\` values and \`f\` return values, and
+a \`FeatureCollection\` of \`Feature\`s holding \`MultiPolygon\` for all other values.
+
+
+Function \`f\` should return either \`true\` or \`false\` or a transformation
+of values into simpler groups, especially useful for floating point arrays.
+
+If \`xs\` and \`ys\` are ranges, they are used as the pixel/cell center points.
+If they are \`Vector\` of \`Tuple\` they are used as the lower and upper bounds of each pixel/cell.

Keywords

julia
- \`minpoints\`: ignore polygons with less than \`minpoints\` points.
+- \`values\`: the values to turn into polygons. By default these are \`union(A)\`,
+    If function \`f\` is passed these refer to the return values of \`f\`, by
+    default \`union(map(f, A)\`. If values \`Bool\`, false is ignored and a single
+    \`MultiPolygon\` is returned rather than a \`FeatureCollection\`.

Example

julia
\`\`\`julia
+using GeometryOps
+A = rand(100, 100)
+multipolygon = polygonize(>(0.5), A);
+\`\`\`
+"""
+polygonize(A::AbstractMatrix{Bool}; kw...) = polygonize(identity, A; kw...)
+polygonize(f::Base.Callable, A::AbstractMatrix; kw...) = polygonize(f, axes(A)..., A; kw...)
+polygonize(A::AbstractMatrix; kw...) = polygonize(axes(A)..., A; kw...)
+polygonize(xs::AbstractVector, ys::AbstractVector, A::AbstractMatrix{Bool}; kw...) =
+    _polygonize(identity, xs, ys, A)
+function polygonize(xs::AbstractVector, ys::AbstractVector, A::AbstractMatrix;
+    values=sort!(Base.union(A)), kw...
+)
+    _polygonize_featurecollection(identity, xs, ys, A; values, kw...)
+end
+function polygonize(f::Base.Callable, xs::AbstractRange, ys::AbstractRange, A::AbstractMatrix;
+    values=_default_values(f, A), kw...
+)
+    if isnothing(values)
+        _polygonize(f, xs, ys, A; kw...)
+    else
+        _polygonize_featurecollection(f, xs, ys, A; kw...)
+    end
+end
+function _polygonize(f::Base.Callable, xs::AbstractRange, ys::AbstractRange, A::AbstractMatrix;
+    kw...
+)

Make vectors of pixel bounds

julia
    xhalf = step(xs) / 2
+    yhalf = step(ys) / 2

Make bounds ranges first to avoid floating point error making gaps or overlaps

julia
    xbounds = range(first(xs) - xhalf; step = step(xs), length = length(xs) + 1)
+    ybounds = range(first(ys) - yhalf; step = step(ys), length = length(ys) + 1)
+    Tx = eltype(xbounds)
+    Ty = eltype(ybounds)
+    xvec = similar(Vector{Tuple{Tx,Tx}}, length(xs))
+    yvec = similar(Vector{Tuple{Ty,Ty}}, length(ys))
+    for (xind, i) in enumerate(eachindex(xvec))
+        xvec[i] = xbounds[xind], xbounds[xind+1]
+    end
+    for (yind, i) in enumerate(eachindex(yvec))
+        yvec[i] = ybounds[yind], ybounds[yind+1]
+    end
+    return _polygonize(f, xvec, yvec, A; kw...)
+end
+function _polygonize(f, xs::AbstractVector{T}, ys::AbstractVector{T}, A::AbstractMatrix;
+    minpoints=0,
+) where T<:Tuple
+    (length(xs), length(ys)) == size(A) || throw(ArgumentError("length of xs and ys must match the array size"))

Extract the CRS of the array (if it is some kind of geo array / raster)

julia
    crs = GI.crs(A)

Define buffers for edges and rings

julia
    rings = Vector{T}[]
+
+    strait = true
+    turning = false

Get edges from the array A

julia
    edges = _pixel_edges(f, xs, ys, A)

Keep dict keys separately in a vector for performance

julia
    edgekeys = collect(keys(edges))

We don't delete keys we just reduce length with nkeys

julia
    nkeys = length(edgekeys)

Now create rings from the edges, looping until there are no edge keys left

julia
    while nkeys > 0
+        found = false
+        local firstnode, nextnodes, nodestatus

Loop until we find a key that hasn't been removed, decrementing nkeys as we go.

julia
        while nkeys > 0

Take the first node from the array

julia
            firstnode::T = edgekeys[nkeys]
+            nextnodes = edges[firstnode]
+            nodestatus = map(!=(typemax(first(firstnode)))  first, nextnodes)
+            if any(nodestatus)
+                found = true
+                break
+            else
+                nkeys -= 1
+            end
+        end

If we found nothing this time, we are done

julia
        found == false && break

Check if there are one or two lines going through this node and take one of them, then update the status

julia
        if nodestatus[2]
+            nextnode = nextnodes[2]
+            edges[firstnode] = (nextnodes[1], map(typemax, nextnode))
+        else
+            nkeys -= 1
+            nextnode = nextnodes[1]
+            edges[firstnode] = (map(typemax, nextnode), map(typemax, nextnode))
+        end

Start a new ring

julia
        currentnode = firstnode
+        ring = [currentnode, nextnode]
+        push!(rings, ring)

Loop until we close a the ring and break

julia
        while true

Find a node that matches the next node

julia
            (c1, c2) = possiblenodes = edges[nextnode]
+            nodestatus = map(!=(typemax(first(firstnode)))  first, possiblenodes)
+            if nodestatus[2]

When there are two possible node, choose the node that is the furthest to the left We also need to check if we are on a straight line to avoid adding unnecessary points.

julia
                selectednode, remainingnode, straightline = if currentnode[1] == nextnode[1] # vertical
+                    wasincreasing = nextnode[2] > currentnode[2]
+                    firstisstraight = nextnode[1] == c1[1]
+                    firstisleft = nextnode[1] > c1[1]
+                    secondisstraight = nextnode[1] == c2[1]
+                    secondisleft = nextnode[1] > c2[1]
+                    if firstisstraight
+                        if secondisleft
+                            if wasincreasing
+                                (c2, c1, turning)
+                            else
+                                (c1, c2, straight)
+                            end
+                        else
+                            if wasincreasing
+                                (c1, c2, straight)
+                            else
+                                (c2, c1, secondisstraight)
+                            end
+                        end
+                    elseif firstisleft
+                        if wasincreasing
+                            (c1, c2, turning)
+                        else
+                            (c2, c1, secondisstraight)
+                        end
+                    else # firstisright
+                        if wasincreasing
+                            (c2, c1, secondisstraight)
+                        else
+                            (c1, c2, turning)
+                        end
+                    end
+                else # horizontal
+                    wasincreasing = nextnode[1] > currentnode[1]
+                    firstisstraight = nextnode[2] == c1[2]
+                    firstisleft = nextnode[2] > c1[2]
+                    secondisleft = nextnode[2] > c2[2]
+                    secondisstraight = nextnode[2] == c2[2]
+                    if firstisstraight
+                        if secondisleft
+                            if wasincreasing
+                                (c1, c2, straight)
+                            else
+                                (c2, c1, turning)
+                            end
+                        else
+                            if wasincreasing
+                                (c2, c1, turning)
+                            else
+                                (c1, c2, straight)
+                            end
+                        end
+                    elseif firstisleft
+                        if wasincreasing
+                            (c2, c1, secondisstraight)
+                        else
+                            (c1, c2, turning)
+                        end
+                    else # firstisright
+                        if wasincreasing
+                            (c1, c2, turning)
+                        else
+                            (c2, c1, secondisstraight)
+                        end
+                    end
+                end

Update edges

julia
                edges[nextnode] = (remainingnode, map(typemax, remainingnode))
+            else

Here we simply choose the first (and only valid) node

julia
                selectednode = c1

Replace the edge nodes with empty nodes, they will be skipped later

julia
                edges[nextnode] = (map(typemax, c1), map(typemax, c1))

Check if we are on a straight line

julia
                straightline = currentnode[1] == nextnode[1] == c1[1] ||
+                               currentnode[2] == nextnode[2] == c1[2]
+            end

Update the current and next nodes with the next and selected nodes

julia
            currentnode, nextnode = nextnode, selectednode

Update the current node or add a new node to the ring

julia
            if straightline

replace the last node we don't need it

julia
                ring[end] = nextnode
+            else

add a new node, we have turned a corner

julia
                push!(ring, nextnode)
+            end

If the ring is closed, break the loop and start a new one

julia
            nextnode == firstnode && break
+        end
+    end

Define wrapped LinearRings, with embedded extents so we only calculate them once

julia
    linearrings = map(rings) do ring
+        extent = GI.extent(GI.LinearRing(ring))
+        GI.LinearRing(ring; extent, crs)
+    end

Separate exteriors from holes by winding direction

julia
    direction = (last(last(xs)) - first(first(xs))) * (last(last(ys)) - first(first(ys)))
+    exterior_inds = if direction > 0
+        .!isclockwise.(linearrings)
+    else
+        isclockwise.(linearrings)
+    end
+    holes = linearrings[.!exterior_inds]
+    polygons = map(view(linearrings, exterior_inds)) do lr
+        GI.Polygon([lr]; extent=GI.extent(lr), crs)
+    end

Then we add the holes to the polygons they are inside of

julia
    assigned = fill(false, length(holes))
+    for i in eachindex(holes)
+        hole = holes[i]
+        prepared_hole = GI.LinearRing(holes[i]; extent=GI.extent(holes[i]))
+        for poly in polygons
+            exterior = GI.Polygon(StaticArrays.SVector(GI.getexterior(poly)); extent=GI.extent(poly))
+            if covers(exterior, prepared_hole)

Hole is in the exterior, so add it to the polygon

julia
                push!(poly.geom, hole)
+                assigned[i] = true
+                break
+            end
+        end
+    end
+
+    assigned_holes = count(assigned)
+    assigned_holes == length(holes) || @warn "Not all holes were assigned to polygons, $(length(holes) - assigned_holes) where missed from $(length(holes)) holes and $(length(polygons)) polygons"
+
+    if isempty(polygons)

TODO: this really should return an empty MultiPolygon but GeoInterface wrappers cant do that yet, which is not ideal...

julia
        @warn "No polgons found, check your data or try another function for \`f\`"
+        return nothing
+    else

Otherwise return a wrapped MultiPolygon

julia
        return GI.MultiPolygon(polygons; crs, extent = mapreduce(GI.extent, Extents.union, polygons))
+    end
+end
+
+function _polygonize_featurecollection(f::Base.Callable, xs::AbstractRange, ys::AbstractRange, A::AbstractMatrix;
+    values=_default_values(f, A), kw...
+)
+    crs = GI.crs(A)

Create one feature per value

julia
    features = map(values) do value
+        multipolygon = _polygonize(x -> isequal(f(x), value), xs, ys, A; kw...)
+        GI.Feature(multipolygon; properties=(; value), extent = GI.extent(multipolygon), crs)
+    end
+
+    return GI.FeatureCollection(features; extent = mapreduce(GI.extent, Extents.union, features), crs)
+end
+
+function _default_values(f, A)

Get union of f return values with resolved eltype

julia
    values = map(identity, sort!(Base.union(Iterators.map(f, A))))

We ignore pure Bool

julia
    return eltype(values) == Bool ? nothing : collect(skipmissing(values))
+end
+
+function update_edge!(dict, key, node)
+    newnodes = (node, map(typemax, node))

Get or write in one go, to skip a hash lookup

julia
    existingnodes = get!(() -> newnodes, dict, key)

If we actually fetched an existing node, update it

julia
    if existingnodes[1] != node
+        dict[key] = (existingnodes[1], node)
+    end
+end
+
+function _pixel_edges(f, xs::AbstractVector{T}, ys::AbstractVector{T}, A) where T<:Tuple
+    edges = Dict{T,Tuple{T,T}}()

First we collect all the edges around target pixels

julia
    fi, fj = map(first, axes(A))
+    li, lj = map(last, axes(A))
+    for j in axes(A, 2)
+        y1, y2 = ys[j]
+        for i in axes(A, 1)
+            if f(A[i, j]) # This is a pixel inside a polygon

xs and ys hold pixel bounds

julia
                x1, x2 = xs[i]

We check the Von Neumann neighborhood to decide what edges are needed, if any.

julia
                (j == fi || !f(A[i, j-1])) && update_edge!(edges, (x1, y1), (x2, y1)) # S
+                (i == fj || !f(A[i-1, j])) && update_edge!(edges, (x1, y2), (x1, y1)) # W
+                (j == lj || !f(A[i, j+1])) && update_edge!(edges, (x2, y2), (x1, y2)) # N
+                (i == li || !f(A[i+1, j])) && update_edge!(edges, (x2, y1), (x2, y2)) # E
+            end
+        end
+    end
+    return edges
+end

This page was generated using Literate.jl.

`,86)]))}const y=i(l,[["render",p]]);export{g as __pageData,y as default}; diff --git a/previews/PR237/assets/source_not_implemented_yet.md.DVmFgcZJ.js b/previews/PR237/assets/source_not_implemented_yet.md.DVmFgcZJ.js new file mode 100644 index 000000000..758df5e58 --- /dev/null +++ b/previews/PR237/assets/source_not_implemented_yet.md.DVmFgcZJ.js @@ -0,0 +1 @@ +import{_ as t,c as i,a5 as a,o as n}from"./chunks/framework.Cq8AuEls.js";const c=JSON.parse('{"title":"Not implemented yet","description":"","frontmatter":{},"headers":[],"relativePath":"source/not_implemented_yet.md","filePath":"source/not_implemented_yet.md","lastUpdated":null}'),s={name:"source/not_implemented_yet.md"};function l(o,e,r,p,m,d){return n(),i("div",null,e[0]||(e[0]=[a('

Not implemented yet

All of the functions in this file are not implemented in Julia yet. Some of them may have implementations in LibGEOS which we can use via an extension, but there is no native-Julia implementation for them.

julia
function symdifference end

This page was generated using Literate.jl.

',5)]))}const u=t(s,[["render",l]]);export{c as __pageData,u as default}; diff --git a/previews/PR237/assets/source_not_implemented_yet.md.DVmFgcZJ.lean.js b/previews/PR237/assets/source_not_implemented_yet.md.DVmFgcZJ.lean.js new file mode 100644 index 000000000..758df5e58 --- /dev/null +++ b/previews/PR237/assets/source_not_implemented_yet.md.DVmFgcZJ.lean.js @@ -0,0 +1 @@ +import{_ as t,c as i,a5 as a,o as n}from"./chunks/framework.Cq8AuEls.js";const c=JSON.parse('{"title":"Not implemented yet","description":"","frontmatter":{},"headers":[],"relativePath":"source/not_implemented_yet.md","filePath":"source/not_implemented_yet.md","lastUpdated":null}'),s={name:"source/not_implemented_yet.md"};function l(o,e,r,p,m,d){return n(),i("div",null,e[0]||(e[0]=[a('

Not implemented yet

All of the functions in this file are not implemented in Julia yet. Some of them may have implementations in LibGEOS which we can use via an extension, but there is no native-Julia implementation for them.

julia
function symdifference end

This page was generated using Literate.jl.

',5)]))}const u=t(s,[["render",l]]);export{c as __pageData,u as default}; diff --git a/previews/PR237/assets/source_primitives.md.D4c57Awv.js b/previews/PR237/assets/source_primitives.md.D4c57Awv.js new file mode 100644 index 000000000..6b373b84c --- /dev/null +++ b/previews/PR237/assets/source_primitives.md.D4c57Awv.js @@ -0,0 +1 @@ +import{_ as a,c as s,j as e,a as r,o as i}from"./chunks/framework.Cq8AuEls.js";const f=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"source/primitives.md","filePath":"source/primitives.md","lastUpdated":null}'),n={name:"source/primitives.md"};function l(o,t,p,c,d,m){return i(),s("div",null,t[0]||(t[0]=[e("hr",null,null,-1),e("p",null,[e("em",null,[r("This page was generated using "),e("a",{href:"https://github.com/fredrikekre/Literate.jl",target:"_blank",rel:"noreferrer"},"Literate.jl"),r(".")])],-1)]))}const _=a(n,[["render",l]]);export{f as __pageData,_ as default}; diff --git a/previews/PR237/assets/source_primitives.md.D4c57Awv.lean.js b/previews/PR237/assets/source_primitives.md.D4c57Awv.lean.js new file mode 100644 index 000000000..6b373b84c --- /dev/null +++ b/previews/PR237/assets/source_primitives.md.D4c57Awv.lean.js @@ -0,0 +1 @@ +import{_ as a,c as s,j as e,a as r,o as i}from"./chunks/framework.Cq8AuEls.js";const f=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"source/primitives.md","filePath":"source/primitives.md","lastUpdated":null}'),n={name:"source/primitives.md"};function l(o,t,p,c,d,m){return i(),s("div",null,t[0]||(t[0]=[e("hr",null,null,-1),e("p",null,[e("em",null,[r("This page was generated using "),e("a",{href:"https://github.com/fredrikekre/Literate.jl",target:"_blank",rel:"noreferrer"},"Literate.jl"),r(".")])],-1)]))}const _=a(n,[["render",l]]);export{f as __pageData,_ as default}; diff --git a/previews/PR237/assets/source_src_GeometryOpsCore.md.D72HXpHZ.js b/previews/PR237/assets/source_src_GeometryOpsCore.md.D72HXpHZ.js new file mode 100644 index 000000000..22a39c16c --- /dev/null +++ b/previews/PR237/assets/source_src_GeometryOpsCore.md.D72HXpHZ.js @@ -0,0 +1,25 @@ +import{_ as i,c as a,a5 as n,o as t}from"./chunks/framework.Cq8AuEls.js";const g=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"source/src/GeometryOpsCore.md","filePath":"source/src/GeometryOpsCore.md","lastUpdated":null}'),l={name:"source/src/GeometryOpsCore.md"};function e(p,s,h,k,r,E){return t(),a("div",null,s[0]||(s[0]=[n(`
julia
module GeometryOpsCore
+
+using Base.Threads: nthreads, @threads, @spawn
+
+import GeoInterface
+import GeoInterface as GI
+import GeoInterface: Extents

Import all names from GeoInterface and Extents, so users can do GO.extent or GO.trait.

julia
for name in names(GeoInterface)
+    @eval using GeoInterface: $name
+end
+for name in names(Extents)
+    @eval using GeoInterface.Extents: $name
+end
+
+using Tables
+using DataAPI
+
+include("keyword_docs.jl")
+include("types.jl")
+
+include("apply.jl")
+include("applyreduce.jl")
+include("other_primitives.jl")
+include("geometry_utils.jl")
+
+end

This page was generated using Literate.jl.

`,5)]))}const y=i(l,[["render",e]]);export{g as __pageData,y as default}; diff --git a/previews/PR237/assets/source_src_GeometryOpsCore.md.D72HXpHZ.lean.js b/previews/PR237/assets/source_src_GeometryOpsCore.md.D72HXpHZ.lean.js new file mode 100644 index 000000000..22a39c16c --- /dev/null +++ b/previews/PR237/assets/source_src_GeometryOpsCore.md.D72HXpHZ.lean.js @@ -0,0 +1,25 @@ +import{_ as i,c as a,a5 as n,o as t}from"./chunks/framework.Cq8AuEls.js";const g=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"source/src/GeometryOpsCore.md","filePath":"source/src/GeometryOpsCore.md","lastUpdated":null}'),l={name:"source/src/GeometryOpsCore.md"};function e(p,s,h,k,r,E){return t(),a("div",null,s[0]||(s[0]=[n(`
julia
module GeometryOpsCore
+
+using Base.Threads: nthreads, @threads, @spawn
+
+import GeoInterface
+import GeoInterface as GI
+import GeoInterface: Extents

Import all names from GeoInterface and Extents, so users can do GO.extent or GO.trait.

julia
for name in names(GeoInterface)
+    @eval using GeoInterface: $name
+end
+for name in names(Extents)
+    @eval using GeoInterface.Extents: $name
+end
+
+using Tables
+using DataAPI
+
+include("keyword_docs.jl")
+include("types.jl")
+
+include("apply.jl")
+include("applyreduce.jl")
+include("other_primitives.jl")
+include("geometry_utils.jl")
+
+end

This page was generated using Literate.jl.

`,5)]))}const y=i(l,[["render",e]]);export{g as __pageData,y as default}; diff --git a/previews/PR237/assets/source_src_apply.md.B_9nF_39.js b/previews/PR237/assets/source_src_apply.md.B_9nF_39.js new file mode 100644 index 000000000..65113dc3a --- /dev/null +++ b/previews/PR237/assets/source_src_apply.md.B_9nF_39.js @@ -0,0 +1,144 @@ +import{_ as h,c as l,a5 as a,j as i,a as t,G as n,B as p,o as k}from"./chunks/framework.Cq8AuEls.js";const b=JSON.parse('{"title":"apply","description":"","frontmatter":{},"headers":[],"relativePath":"source/src/apply.md","filePath":"source/src/apply.md","lastUpdated":null}'),r={name:"source/src/apply.md"},d={class:"jldocstring custom-block",open:""},g={class:"jldocstring custom-block",open:""};function o(E,s,c,y,F,u){const e=p("Badge");return k(),l("div",null,[s[6]||(s[6]=a('

apply

julia
export apply

This file mainly defines the apply function.

In general, the idea behind the apply framework is to take as input any geometry, vector of geometries, or feature collection, deconstruct it to the given trait target (any arbitrary GI.AbstractTrait or TraitTarget union thereof, like PointTrait or PolygonTrait) and perform some operation on it. Then, the geometry or structure is rebuilt.

This allows for a simple and consistent framework within which users can define their own operations trivially easily, and removes a lot of the complexity involved with handling complex geometry structures.

For example, a simple way to flip the x and y coordinates of a geometry is:

julia
flipped_geom = GO.apply(GI.PointTrait(), geom) do p\n    (GI.y(p), GI.x(p))\nend

As simple as that. There's no need to implement your own decomposition because it's done for you.

Functions like flip, reproject, transform, even segmentize and simplify have been implemented using the apply framework. Similarly, centroid, area and distance have been implemented using the applyreduce framework.

Docstrings

Functions

',11)),i("details",d,[i("summary",null,[s[0]||(s[0]=i("a",{id:"GeometryOpsCore.apply-source-src-apply",href:"#GeometryOpsCore.apply-source-src-apply"},[i("span",{class:"jlbinding"},"GeometryOpsCore.apply")],-1)),s[1]||(s[1]=t()),n(e,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[2]||(s[2]=a(`
julia
apply(f, target::Union{TraitTarget, GI.AbstractTrait}, obj; kw...)

Reconstruct a geometry, feature, feature collection, or nested vectors of either using the function f on the target trait.

f(target_geom) => x where x also has the target trait, or a trait that can be substituted. For example, swapping PolgonTrait to MultiPointTrait will fail if the outer object has MultiPolygonTrait, but should work if it has FeatureTrait.

Objects "shallower" than the target trait are always completely rebuilt, like a Vector of FeatureCollectionTrait of FeatureTrait when the target has PolygonTrait and is held in the features. These will always be GeoInterface geometries/feature/feature collections. But "deeper" objects may remain unchanged or be whatever GeoInterface compatible objects f returns.

The result is a functionally similar geometry with values depending on f.

  • threaded: true or false. Whether to use multithreading. Defaults to false.

  • crs: The CRS to attach to geometries. Defaults to nothing.

  • calc_extent: true or false. Whether to calculate the extent. Defaults to false.

Example

Flipped point the order in any feature or geometry, or iterables of either:

julia
import GeoInterface as GI
+import GeometryOps as GO
+geom = GI.Polygon([GI.LinearRing([(1, 2), (3, 4), (5, 6), (1, 2)]),
+                   GI.LinearRing([(3, 4), (5, 6), (6, 7), (3, 4)])])
+
+flipped_geom = GO.apply(GI.PointTrait, geom) do p
+    (GI.y(p), GI.x(p))
+end

source

`,10))]),i("details",g,[i("summary",null,[s[3]||(s[3]=i("a",{id:"GeometryOpsCore.applyreduce-source-src-apply",href:"#GeometryOpsCore.applyreduce-source-src-apply"},[i("span",{class:"jlbinding"},"GeometryOpsCore.applyreduce")],-1)),s[4]||(s[4]=t()),n(e,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[5]||(s[5]=a('
julia
applyreduce(f, op, target::Union{TraitTarget, GI.AbstractTrait}, obj; threaded)

Apply function f to all objects with the target trait, and reduce the result with an op like +.

The order and grouping of application of op is not guaranteed.

If threaded==true threads will be used over arrays and iterables, feature collections and nested geometries.

source

',5))]),s[7]||(s[7]=a(`

What is apply?

apply applies some function to every geometry matching the Target GeoInterface trait, in some arbitrarily nested object made up of:

  • AbstractArrays (we also try to iterate other non-GeoInteface compatible object)

  • FeatureCollectionTrait objects

  • FeatureTrait objects

  • AbstractGeometryTrait objects

apply recursively calls itself through these nested layers until it reaches objects with the Target GeoInterface trait. When found apply applies the function f, and stops.

The outer recursive functions then progressively rebuild the object using GeoInterface objects matching the original traits.

If PointTrait is found but it is not the Target, an error is thrown. This likely means the object contains a different geometry trait to the target, such as MultiPointTrait when LineStringTrait was specified.

To handle this possibility it may be necessary to make Target a Union of traits found at the same level of nesting, and define methods of f to handle all cases.

Be careful making a union across "levels" of nesting, e.g. Union{FeatureTrait,PolygonTrait}, as _apply will just never reach PolygonTrait when all the polygons are wrapped in a FeatureTrait object.

Embedding:

extent and crs can be embedded in all geometries, features, and feature collections as part of apply. Geometries deeper than Target will of course not have new extent or crs embedded.

  • calc_extent signals to recalculate an Extent and embed it.

  • crs will be embedded as-is

Threading

Threading is used at the outermost level possible - over an array, feature collection, or e.g. a MultiPolygonTrait where each PolygonTrait sub-geometry may be calculated on a different thread.

Currently, threading defaults to false for all objects, but can be turned on by passing the keyword argument threaded=true to apply.

julia
"""
+    apply(f, target::Union{TraitTarget, GI.AbstractTrait}, obj; kw...)
+
+Reconstruct a geometry, feature, feature collection, or nested vectors of
+either using the function \`f\` on the \`target\` trait.
+
+\`f(target_geom) => x\` where \`x\` also has the \`target\` trait, or a trait that can
+be substituted. For example, swapping \`PolgonTrait\` to \`MultiPointTrait\` will fail
+if the outer object has \`MultiPolygonTrait\`, but should work if it has \`FeatureTrait\`.
+
+Objects "shallower" than the target trait are always completely rebuilt, like
+a \`Vector\` of \`FeatureCollectionTrait\` of \`FeatureTrait\` when the target
+has \`PolygonTrait\` and is held in the features. These will always be GeoInterface
+geometries/feature/feature collections. But "deeper" objects may remain
+unchanged or be whatever GeoInterface compatible objects \`f\` returns.
+
+The result is a functionally similar geometry with values depending on \`f\`.
+
+$APPLY_KEYWORDS
+
+# Example
+
+Flipped point the order in any feature or geometry, or iterables of either:
+
+\`\`\`julia
+import GeoInterface as GI
+import GeometryOps as GO
+geom = GI.Polygon([GI.LinearRing([(1, 2), (3, 4), (5, 6), (1, 2)]),
+                   GI.LinearRing([(3, 4), (5, 6), (6, 7), (3, 4)])])
+
+flipped_geom = GO.apply(GI.PointTrait, geom) do p
+    (GI.y(p), GI.x(p))
+end
+\`\`\`
+"""
+@inline function apply(
+    f::F, target, geom; calc_extent=false, threaded=false, kw...
+) where F
+    threaded = _booltype(threaded)
+    calc_extent = _booltype(calc_extent)
+    _apply(f, TraitTarget(target), geom; threaded, calc_extent, kw...)
+end

Call _apply again with the trait of geom

julia
@inline _apply(f::F, target, geom; kw...)  where F =
+    _apply(f, target, GI.trait(geom), geom; kw...)

There is no trait and this is an AbstractArray - so just iterate over it calling _apply on the contents

julia
@inline function _apply(f::F, target, ::Nothing, A::AbstractArray; threaded, kw...) where F

For an Array there is nothing else to do but map _apply over all values _maptasks may run this level threaded if threaded==true, but deeper _apply called in the closure will not be threaded

julia
    apply_to_array(i) = _apply(f, target, A[i]; threaded=_False(), kw...)
+    _maptasks(apply_to_array, eachindex(A), threaded)
+end

There is no trait and this is not an AbstractArray. Try to call _apply over it. We can't use threading as we don't know if we can can index into it. So just map.

julia
@inline function _apply(f::F, target, ::Nothing, iterable::IterableType; threaded, kw...) where {F, IterableType}

Try the Tables.jl interface first

julia
    if Tables.istable(iterable)
+    _apply_table(f, target, iterable; threaded, kw...)
+    else # this is probably some form of iterable...
+        if threaded isa _True

collect first so we can use threads

julia
            _apply(f, target, collect(iterable); threaded, kw...)
+        else
+            apply_to_iterable(x) = _apply(f, target, x; kw...)
+            map(apply_to_iterable, iterable)
+        end
+    end
+end
+#=
+Doing this inline in \`_apply\` is _heavily_ type unstable, so it's best to separate this
+by a function barrier.
+
+This function operates \`apply\` on the \`geometry\` column of the table, and returns a new table
+with the same schema, but with the new geometry column.
+
+This new table may be of the same type as the old one iff \`Tables.materializer\` is defined for
+that table.  If not, then a \`NamedTuple\` is returned.
+=#
+function _apply_table(f::F, target, iterable::IterableType; threaded, kw...) where {F, IterableType}
+    _get_col_pair(colname) = colname => Tables.getcolumn(iterable, colname)

We extract the geometry column and run apply on it.

julia
    geometry_column = first(GI.geometrycolumns(iterable))
+    new_geometry = _apply(f, target, Tables.getcolumn(iterable, geometry_column); threaded, kw...)

Then, we obtain the schema of the table,

julia
    old_schema = Tables.schema(iterable)

filter the geometry column out,

julia
    new_names = filter(Base.Fix1(!==, geometry_column), old_schema.names)

and try to rebuild the same table as the best type - either the original type of iterable, or a named tuple which is the default fallback.

julia
    result = Tables.materializer(iterable)(
+        merge(
+            NamedTuple{(geometry_column,), Base.Tuple{typeof(new_geometry)}}((new_geometry,)),
+            NamedTuple(Iterators.map(_get_col_pair, new_names))
+        )
+    )

Finally, we ensure that metadata is propagated correctly. This can only happen if the original table supports metadata reads, and the result supports metadata writes.

julia
    if DataAPI.metadatasupport(typeof(result)).write

Copy over all metadata from the original table to the new table, if the original table supports metadata reading.

julia
        if DataAPI.metadatasupport(IterableType).read
+            for (key, (value, style)) in DataAPI.metadata(iterable; style = true)

Default styles are not preserved on data transformation, so we must skip them!

julia
                style == :default && continue

We assume that any other style is preserved.

julia
                DataAPI.metadata!(result, key, value; style)
+            end
+        end

We don't usually care about the original table's metadata for GEOINTERFACE namespaced keys, so we should set the crs and geometrycolumns metadata if they are present. Ensure that GEOINTERFACE:geometrycolumns and GEOINTERFACE:crs are set!

julia
        mdk = DataAPI.metadatakeys(result)

If the user has asked for geometry columns to persist, they would be here, so we don't need to set them.

julia
        if !("GEOINTERFACE:geometrycolumns" in mdk)

If the geometry columns are not already set, we need to set them.

julia
            DataAPI.metadata!(result, "GEOINTERFACE:geometrycolumns", (geometry_column,); style = :default)
+        end

Force reset CRS always, since you can pass crs to apply.

julia
        new_crs = if haskey(kw, :crs)
+            kw[:crs]
+        else
+            GI.crs(iterable) # this will automatically check \`GEOINTERFACE:crs\` unless the type has a specialized implementation.
+        end
+
+        DataAPI.metadata!(result, "GEOINTERFACE:crs", new_crs; style = :default)
+    end
+
+    return result
+end

Rewrap all FeatureCollectionTrait feature collections as GI.FeatureCollection Maybe use threads to call _apply on component features

julia
@inline function _apply(f::F, target, ::GI.FeatureCollectionTrait, fc;
+    crs=GI.crs(fc), calc_extent=_False(), threaded
+) where F

Run _apply on all features in the feature collection, possibly threaded

julia
    apply_to_feature(i) =
+        _apply(f, target, GI.getfeature(fc, i); crs, calc_extent, threaded=_False())::GI.Feature
+    features = _maptasks(apply_to_feature, 1:GI.nfeature(fc), threaded)
+    if calc_extent isa _True

Calculate the extent of the features

julia
        extent = mapreduce(GI.extent, Extents.union, features)

Return a FeatureCollection with features, crs and calculated extent

julia
        return GI.FeatureCollection(features; crs, extent)
+    else

Return a FeatureCollection with features and crs

julia
        return GI.FeatureCollection(features; crs)
+    end
+end

Rewrap all FeatureTrait features as GI.Feature, keeping the properties

julia
@inline function _apply(f::F, target, ::GI.FeatureTrait, feature;
+    crs=GI.crs(feature), calc_extent=_False(), threaded
+) where F

Run _apply on the contained geometry

julia
    geometry = _apply(f, target, GI.geometry(feature); crs, calc_extent, threaded)

Get the feature properties

julia
    properties = GI.properties(feature)
+    if calc_extent isa _True

Calculate the extent of the geometry

julia
        extent = GI.extent(geometry)

Return a new Feature with the new geometry and calculated extent, but the original properties and crs

julia
        return GI.Feature(geometry; properties, crs, extent)
+    else

Return a new Feature with the new geometry, but the original properties and crs

julia
        return GI.Feature(geometry; properties, crs)
+    end
+end

Reconstruct nested geometries, maybe using threads to call _apply on component geoms

julia
@inline function _apply(f::F, target, trait, geom;
+    crs=GI.crs(geom), calc_extent=_False(), threaded
+)::(GI.geointerface_geomtype(trait)) where F

Map _apply over all sub geometries of geom to create a new vector of geometries TODO handle zero length

julia
    apply_to_geom(i) = _apply(f, target, GI.getgeom(geom, i); crs, calc_extent, threaded=_False())
+    geoms = _maptasks(apply_to_geom, 1:GI.ngeom(geom), threaded)
+    return _apply_inner(geom, geoms, crs, calc_extent)
+end
+@inline function _apply(f::F, target::TraitTarget{<:PointTrait}, trait::GI.PolygonTrait, geom;
+    crs=GI.crs(geom), calc_extent=_False(), threaded
+)::(GI.geointerface_geomtype(trait)) where F

We need to force rebuilding a LinearRing not a LineString

julia
    geoms = _maptasks(1:GI.ngeom(geom), threaded) do i
+        lr = GI.getgeom(geom, i)
+        points = map(GI.getgeom(lr)) do p
+            _apply(f, target, p; crs, calc_extent, threaded=_False())
+        end
+        _linearring(_apply_inner(lr, points, crs, calc_extent))
+    end
+    return _apply_inner(geom, geoms, crs, calc_extent)
+end
+function _apply_inner(geom, geoms, crs, calc_extent::_True)

Calculate the extent of the sub geometries

julia
    extent = mapreduce(GI.extent, Extents.union, geoms)

Return a new geometry of the same trait as geom, holding the new geoms with crs and calculated extent

julia
    return rebuild(geom, geoms; crs, extent)
+end
+function _apply_inner(geom, geoms, crs, calc_extent::_False)

Return a new geometry of the same trait as geom, holding the new geoms with crs

julia
    return rebuild(geom, geoms; crs)
+end

Fail loudly if we hit PointTrait without running f (after PointTrait there is no further to dig with _apply) @inline _apply(f, ::TraitTarget{Target}, trait::GI.PointTrait, geom; crs=nothing, kw...) where Target = throw(ArgumentError("target Target not found, but reached a PointTrait leaf")) Finally, these short methods are the main purpose of apply. The Trait is a subtype of the Target (or identical to it) So the Target is found. We apply f to geom and return it to previous _apply calls to be wrapped with the outer geometries/feature/featurecollection/array.

julia
_apply(f::F, ::TraitTarget{Target}, ::Trait, geom; crs=GI.crs(geom), kw...) where {F,Target,Trait<:Target} = f(geom)

Define some specific cases of this match to avoid method ambiguity

julia
for T in (
+    GI.PointTrait, GI.LinearRing, GI.LineString,
+    GI.MultiPoint, GI.FeatureTrait, GI.FeatureCollectionTrait
+)
+    @eval _apply(f::F, target::TraitTarget{<:$T}, trait::$T, x; kw...) where F = f(x)
+end
+
+
+### \`_maptasks\` - flexible, threaded \`map\`
+
+using Base.Threads: nthreads, @threads, @spawn

Threading utility, modified Mason Protters threading PSA run f over ntasks, where f receives an AbstractArray/range of linear indices

julia
@inline function _maptasks(f::F, taskrange, threaded::_True)::Vector where F
+    ntasks = length(taskrange)

Customize this as needed. More tasks have more overhead, but better load balancing

julia
    tasks_per_thread = 2
+    chunk_size = max(1, ntasks ÷ (tasks_per_thread * nthreads()))

partition the range into chunks

julia
    task_chunks = Iterators.partition(taskrange, chunk_size)

Map over the chunks

julia
    tasks = map(task_chunks) do chunk

Spawn a task to process this chunk

julia
        @spawn begin

Where we map f over the chunk indices

julia
            map(f, chunk)
+        end
+    end

Finally we join the results into a new vector

julia
    return mapreduce(fetch, vcat, tasks)
+end

Here we use the compiler directive @assume_effects :foldable to force the compiler to lookup through the closure. This alone makes e.g. flip 2.5x faster!

julia
Base.@assume_effects :foldable @inline function _maptasks(f::F, taskrange, threaded::_False)::Vector where F
+    map(f, taskrange)
+end

This page was generated using Literate.jl.

`,107))])}const m=h(r,[["render",o]]);export{b as __pageData,m as default}; diff --git a/previews/PR237/assets/source_src_apply.md.B_9nF_39.lean.js b/previews/PR237/assets/source_src_apply.md.B_9nF_39.lean.js new file mode 100644 index 000000000..65113dc3a --- /dev/null +++ b/previews/PR237/assets/source_src_apply.md.B_9nF_39.lean.js @@ -0,0 +1,144 @@ +import{_ as h,c as l,a5 as a,j as i,a as t,G as n,B as p,o as k}from"./chunks/framework.Cq8AuEls.js";const b=JSON.parse('{"title":"apply","description":"","frontmatter":{},"headers":[],"relativePath":"source/src/apply.md","filePath":"source/src/apply.md","lastUpdated":null}'),r={name:"source/src/apply.md"},d={class:"jldocstring custom-block",open:""},g={class:"jldocstring custom-block",open:""};function o(E,s,c,y,F,u){const e=p("Badge");return k(),l("div",null,[s[6]||(s[6]=a('

apply

julia
export apply

This file mainly defines the apply function.

In general, the idea behind the apply framework is to take as input any geometry, vector of geometries, or feature collection, deconstruct it to the given trait target (any arbitrary GI.AbstractTrait or TraitTarget union thereof, like PointTrait or PolygonTrait) and perform some operation on it. Then, the geometry or structure is rebuilt.

This allows for a simple and consistent framework within which users can define their own operations trivially easily, and removes a lot of the complexity involved with handling complex geometry structures.

For example, a simple way to flip the x and y coordinates of a geometry is:

julia
flipped_geom = GO.apply(GI.PointTrait(), geom) do p\n    (GI.y(p), GI.x(p))\nend

As simple as that. There's no need to implement your own decomposition because it's done for you.

Functions like flip, reproject, transform, even segmentize and simplify have been implemented using the apply framework. Similarly, centroid, area and distance have been implemented using the applyreduce framework.

Docstrings

Functions

',11)),i("details",d,[i("summary",null,[s[0]||(s[0]=i("a",{id:"GeometryOpsCore.apply-source-src-apply",href:"#GeometryOpsCore.apply-source-src-apply"},[i("span",{class:"jlbinding"},"GeometryOpsCore.apply")],-1)),s[1]||(s[1]=t()),n(e,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[2]||(s[2]=a(`
julia
apply(f, target::Union{TraitTarget, GI.AbstractTrait}, obj; kw...)

Reconstruct a geometry, feature, feature collection, or nested vectors of either using the function f on the target trait.

f(target_geom) => x where x also has the target trait, or a trait that can be substituted. For example, swapping PolgonTrait to MultiPointTrait will fail if the outer object has MultiPolygonTrait, but should work if it has FeatureTrait.

Objects "shallower" than the target trait are always completely rebuilt, like a Vector of FeatureCollectionTrait of FeatureTrait when the target has PolygonTrait and is held in the features. These will always be GeoInterface geometries/feature/feature collections. But "deeper" objects may remain unchanged or be whatever GeoInterface compatible objects f returns.

The result is a functionally similar geometry with values depending on f.

  • threaded: true or false. Whether to use multithreading. Defaults to false.

  • crs: The CRS to attach to geometries. Defaults to nothing.

  • calc_extent: true or false. Whether to calculate the extent. Defaults to false.

Example

Flipped point the order in any feature or geometry, or iterables of either:

julia
import GeoInterface as GI
+import GeometryOps as GO
+geom = GI.Polygon([GI.LinearRing([(1, 2), (3, 4), (5, 6), (1, 2)]),
+                   GI.LinearRing([(3, 4), (5, 6), (6, 7), (3, 4)])])
+
+flipped_geom = GO.apply(GI.PointTrait, geom) do p
+    (GI.y(p), GI.x(p))
+end

source

`,10))]),i("details",g,[i("summary",null,[s[3]||(s[3]=i("a",{id:"GeometryOpsCore.applyreduce-source-src-apply",href:"#GeometryOpsCore.applyreduce-source-src-apply"},[i("span",{class:"jlbinding"},"GeometryOpsCore.applyreduce")],-1)),s[4]||(s[4]=t()),n(e,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[5]||(s[5]=a('
julia
applyreduce(f, op, target::Union{TraitTarget, GI.AbstractTrait}, obj; threaded)

Apply function f to all objects with the target trait, and reduce the result with an op like +.

The order and grouping of application of op is not guaranteed.

If threaded==true threads will be used over arrays and iterables, feature collections and nested geometries.

source

',5))]),s[7]||(s[7]=a(`

What is apply?

apply applies some function to every geometry matching the Target GeoInterface trait, in some arbitrarily nested object made up of:

  • AbstractArrays (we also try to iterate other non-GeoInteface compatible object)

  • FeatureCollectionTrait objects

  • FeatureTrait objects

  • AbstractGeometryTrait objects

apply recursively calls itself through these nested layers until it reaches objects with the Target GeoInterface trait. When found apply applies the function f, and stops.

The outer recursive functions then progressively rebuild the object using GeoInterface objects matching the original traits.

If PointTrait is found but it is not the Target, an error is thrown. This likely means the object contains a different geometry trait to the target, such as MultiPointTrait when LineStringTrait was specified.

To handle this possibility it may be necessary to make Target a Union of traits found at the same level of nesting, and define methods of f to handle all cases.

Be careful making a union across "levels" of nesting, e.g. Union{FeatureTrait,PolygonTrait}, as _apply will just never reach PolygonTrait when all the polygons are wrapped in a FeatureTrait object.

Embedding:

extent and crs can be embedded in all geometries, features, and feature collections as part of apply. Geometries deeper than Target will of course not have new extent or crs embedded.

  • calc_extent signals to recalculate an Extent and embed it.

  • crs will be embedded as-is

Threading

Threading is used at the outermost level possible - over an array, feature collection, or e.g. a MultiPolygonTrait where each PolygonTrait sub-geometry may be calculated on a different thread.

Currently, threading defaults to false for all objects, but can be turned on by passing the keyword argument threaded=true to apply.

julia
"""
+    apply(f, target::Union{TraitTarget, GI.AbstractTrait}, obj; kw...)
+
+Reconstruct a geometry, feature, feature collection, or nested vectors of
+either using the function \`f\` on the \`target\` trait.
+
+\`f(target_geom) => x\` where \`x\` also has the \`target\` trait, or a trait that can
+be substituted. For example, swapping \`PolgonTrait\` to \`MultiPointTrait\` will fail
+if the outer object has \`MultiPolygonTrait\`, but should work if it has \`FeatureTrait\`.
+
+Objects "shallower" than the target trait are always completely rebuilt, like
+a \`Vector\` of \`FeatureCollectionTrait\` of \`FeatureTrait\` when the target
+has \`PolygonTrait\` and is held in the features. These will always be GeoInterface
+geometries/feature/feature collections. But "deeper" objects may remain
+unchanged or be whatever GeoInterface compatible objects \`f\` returns.
+
+The result is a functionally similar geometry with values depending on \`f\`.
+
+$APPLY_KEYWORDS
+
+# Example
+
+Flipped point the order in any feature or geometry, or iterables of either:
+
+\`\`\`julia
+import GeoInterface as GI
+import GeometryOps as GO
+geom = GI.Polygon([GI.LinearRing([(1, 2), (3, 4), (5, 6), (1, 2)]),
+                   GI.LinearRing([(3, 4), (5, 6), (6, 7), (3, 4)])])
+
+flipped_geom = GO.apply(GI.PointTrait, geom) do p
+    (GI.y(p), GI.x(p))
+end
+\`\`\`
+"""
+@inline function apply(
+    f::F, target, geom; calc_extent=false, threaded=false, kw...
+) where F
+    threaded = _booltype(threaded)
+    calc_extent = _booltype(calc_extent)
+    _apply(f, TraitTarget(target), geom; threaded, calc_extent, kw...)
+end

Call _apply again with the trait of geom

julia
@inline _apply(f::F, target, geom; kw...)  where F =
+    _apply(f, target, GI.trait(geom), geom; kw...)

There is no trait and this is an AbstractArray - so just iterate over it calling _apply on the contents

julia
@inline function _apply(f::F, target, ::Nothing, A::AbstractArray; threaded, kw...) where F

For an Array there is nothing else to do but map _apply over all values _maptasks may run this level threaded if threaded==true, but deeper _apply called in the closure will not be threaded

julia
    apply_to_array(i) = _apply(f, target, A[i]; threaded=_False(), kw...)
+    _maptasks(apply_to_array, eachindex(A), threaded)
+end

There is no trait and this is not an AbstractArray. Try to call _apply over it. We can't use threading as we don't know if we can can index into it. So just map.

julia
@inline function _apply(f::F, target, ::Nothing, iterable::IterableType; threaded, kw...) where {F, IterableType}

Try the Tables.jl interface first

julia
    if Tables.istable(iterable)
+    _apply_table(f, target, iterable; threaded, kw...)
+    else # this is probably some form of iterable...
+        if threaded isa _True

collect first so we can use threads

julia
            _apply(f, target, collect(iterable); threaded, kw...)
+        else
+            apply_to_iterable(x) = _apply(f, target, x; kw...)
+            map(apply_to_iterable, iterable)
+        end
+    end
+end
+#=
+Doing this inline in \`_apply\` is _heavily_ type unstable, so it's best to separate this
+by a function barrier.
+
+This function operates \`apply\` on the \`geometry\` column of the table, and returns a new table
+with the same schema, but with the new geometry column.
+
+This new table may be of the same type as the old one iff \`Tables.materializer\` is defined for
+that table.  If not, then a \`NamedTuple\` is returned.
+=#
+function _apply_table(f::F, target, iterable::IterableType; threaded, kw...) where {F, IterableType}
+    _get_col_pair(colname) = colname => Tables.getcolumn(iterable, colname)

We extract the geometry column and run apply on it.

julia
    geometry_column = first(GI.geometrycolumns(iterable))
+    new_geometry = _apply(f, target, Tables.getcolumn(iterable, geometry_column); threaded, kw...)

Then, we obtain the schema of the table,

julia
    old_schema = Tables.schema(iterable)

filter the geometry column out,

julia
    new_names = filter(Base.Fix1(!==, geometry_column), old_schema.names)

and try to rebuild the same table as the best type - either the original type of iterable, or a named tuple which is the default fallback.

julia
    result = Tables.materializer(iterable)(
+        merge(
+            NamedTuple{(geometry_column,), Base.Tuple{typeof(new_geometry)}}((new_geometry,)),
+            NamedTuple(Iterators.map(_get_col_pair, new_names))
+        )
+    )

Finally, we ensure that metadata is propagated correctly. This can only happen if the original table supports metadata reads, and the result supports metadata writes.

julia
    if DataAPI.metadatasupport(typeof(result)).write

Copy over all metadata from the original table to the new table, if the original table supports metadata reading.

julia
        if DataAPI.metadatasupport(IterableType).read
+            for (key, (value, style)) in DataAPI.metadata(iterable; style = true)

Default styles are not preserved on data transformation, so we must skip them!

julia
                style == :default && continue

We assume that any other style is preserved.

julia
                DataAPI.metadata!(result, key, value; style)
+            end
+        end

We don't usually care about the original table's metadata for GEOINTERFACE namespaced keys, so we should set the crs and geometrycolumns metadata if they are present. Ensure that GEOINTERFACE:geometrycolumns and GEOINTERFACE:crs are set!

julia
        mdk = DataAPI.metadatakeys(result)

If the user has asked for geometry columns to persist, they would be here, so we don't need to set them.

julia
        if !("GEOINTERFACE:geometrycolumns" in mdk)

If the geometry columns are not already set, we need to set them.

julia
            DataAPI.metadata!(result, "GEOINTERFACE:geometrycolumns", (geometry_column,); style = :default)
+        end

Force reset CRS always, since you can pass crs to apply.

julia
        new_crs = if haskey(kw, :crs)
+            kw[:crs]
+        else
+            GI.crs(iterable) # this will automatically check \`GEOINTERFACE:crs\` unless the type has a specialized implementation.
+        end
+
+        DataAPI.metadata!(result, "GEOINTERFACE:crs", new_crs; style = :default)
+    end
+
+    return result
+end

Rewrap all FeatureCollectionTrait feature collections as GI.FeatureCollection Maybe use threads to call _apply on component features

julia
@inline function _apply(f::F, target, ::GI.FeatureCollectionTrait, fc;
+    crs=GI.crs(fc), calc_extent=_False(), threaded
+) where F

Run _apply on all features in the feature collection, possibly threaded

julia
    apply_to_feature(i) =
+        _apply(f, target, GI.getfeature(fc, i); crs, calc_extent, threaded=_False())::GI.Feature
+    features = _maptasks(apply_to_feature, 1:GI.nfeature(fc), threaded)
+    if calc_extent isa _True

Calculate the extent of the features

julia
        extent = mapreduce(GI.extent, Extents.union, features)

Return a FeatureCollection with features, crs and calculated extent

julia
        return GI.FeatureCollection(features; crs, extent)
+    else

Return a FeatureCollection with features and crs

julia
        return GI.FeatureCollection(features; crs)
+    end
+end

Rewrap all FeatureTrait features as GI.Feature, keeping the properties

julia
@inline function _apply(f::F, target, ::GI.FeatureTrait, feature;
+    crs=GI.crs(feature), calc_extent=_False(), threaded
+) where F

Run _apply on the contained geometry

julia
    geometry = _apply(f, target, GI.geometry(feature); crs, calc_extent, threaded)

Get the feature properties

julia
    properties = GI.properties(feature)
+    if calc_extent isa _True

Calculate the extent of the geometry

julia
        extent = GI.extent(geometry)

Return a new Feature with the new geometry and calculated extent, but the original properties and crs

julia
        return GI.Feature(geometry; properties, crs, extent)
+    else

Return a new Feature with the new geometry, but the original properties and crs

julia
        return GI.Feature(geometry; properties, crs)
+    end
+end

Reconstruct nested geometries, maybe using threads to call _apply on component geoms

julia
@inline function _apply(f::F, target, trait, geom;
+    crs=GI.crs(geom), calc_extent=_False(), threaded
+)::(GI.geointerface_geomtype(trait)) where F

Map _apply over all sub geometries of geom to create a new vector of geometries TODO handle zero length

julia
    apply_to_geom(i) = _apply(f, target, GI.getgeom(geom, i); crs, calc_extent, threaded=_False())
+    geoms = _maptasks(apply_to_geom, 1:GI.ngeom(geom), threaded)
+    return _apply_inner(geom, geoms, crs, calc_extent)
+end
+@inline function _apply(f::F, target::TraitTarget{<:PointTrait}, trait::GI.PolygonTrait, geom;
+    crs=GI.crs(geom), calc_extent=_False(), threaded
+)::(GI.geointerface_geomtype(trait)) where F

We need to force rebuilding a LinearRing not a LineString

julia
    geoms = _maptasks(1:GI.ngeom(geom), threaded) do i
+        lr = GI.getgeom(geom, i)
+        points = map(GI.getgeom(lr)) do p
+            _apply(f, target, p; crs, calc_extent, threaded=_False())
+        end
+        _linearring(_apply_inner(lr, points, crs, calc_extent))
+    end
+    return _apply_inner(geom, geoms, crs, calc_extent)
+end
+function _apply_inner(geom, geoms, crs, calc_extent::_True)

Calculate the extent of the sub geometries

julia
    extent = mapreduce(GI.extent, Extents.union, geoms)

Return a new geometry of the same trait as geom, holding the new geoms with crs and calculated extent

julia
    return rebuild(geom, geoms; crs, extent)
+end
+function _apply_inner(geom, geoms, crs, calc_extent::_False)

Return a new geometry of the same trait as geom, holding the new geoms with crs

julia
    return rebuild(geom, geoms; crs)
+end

Fail loudly if we hit PointTrait without running f (after PointTrait there is no further to dig with _apply) @inline _apply(f, ::TraitTarget{Target}, trait::GI.PointTrait, geom; crs=nothing, kw...) where Target = throw(ArgumentError("target Target not found, but reached a PointTrait leaf")) Finally, these short methods are the main purpose of apply. The Trait is a subtype of the Target (or identical to it) So the Target is found. We apply f to geom and return it to previous _apply calls to be wrapped with the outer geometries/feature/featurecollection/array.

julia
_apply(f::F, ::TraitTarget{Target}, ::Trait, geom; crs=GI.crs(geom), kw...) where {F,Target,Trait<:Target} = f(geom)

Define some specific cases of this match to avoid method ambiguity

julia
for T in (
+    GI.PointTrait, GI.LinearRing, GI.LineString,
+    GI.MultiPoint, GI.FeatureTrait, GI.FeatureCollectionTrait
+)
+    @eval _apply(f::F, target::TraitTarget{<:$T}, trait::$T, x; kw...) where F = f(x)
+end
+
+
+### \`_maptasks\` - flexible, threaded \`map\`
+
+using Base.Threads: nthreads, @threads, @spawn

Threading utility, modified Mason Protters threading PSA run f over ntasks, where f receives an AbstractArray/range of linear indices

julia
@inline function _maptasks(f::F, taskrange, threaded::_True)::Vector where F
+    ntasks = length(taskrange)

Customize this as needed. More tasks have more overhead, but better load balancing

julia
    tasks_per_thread = 2
+    chunk_size = max(1, ntasks ÷ (tasks_per_thread * nthreads()))

partition the range into chunks

julia
    task_chunks = Iterators.partition(taskrange, chunk_size)

Map over the chunks

julia
    tasks = map(task_chunks) do chunk

Spawn a task to process this chunk

julia
        @spawn begin

Where we map f over the chunk indices

julia
            map(f, chunk)
+        end
+    end

Finally we join the results into a new vector

julia
    return mapreduce(fetch, vcat, tasks)
+end

Here we use the compiler directive @assume_effects :foldable to force the compiler to lookup through the closure. This alone makes e.g. flip 2.5x faster!

julia
Base.@assume_effects :foldable @inline function _maptasks(f::F, taskrange, threaded::_False)::Vector where F
+    map(f, taskrange)
+end

This page was generated using Literate.jl.

`,107))])}const m=h(r,[["render",o]]);export{b as __pageData,m as default}; diff --git a/previews/PR237/assets/source_src_applyreduce.md.DZQXF3zb.js b/previews/PR237/assets/source_src_applyreduce.md.DZQXF3zb.js new file mode 100644 index 000000000..3a9967acd --- /dev/null +++ b/previews/PR237/assets/source_src_applyreduce.md.DZQXF3zb.js @@ -0,0 +1,72 @@ +import{_ as i,c as a,a5 as t,o as n}from"./chunks/framework.Cq8AuEls.js";const E=JSON.parse('{"title":"applyreduce","description":"","frontmatter":{},"headers":[],"relativePath":"source/src/applyreduce.md","filePath":"source/src/applyreduce.md","lastUpdated":null}'),h={name:"source/src/applyreduce.md"};function e(p,s,l,k,r,d){return n(),a("div",null,s[0]||(s[0]=[t(`

applyreduce

julia
export applyreduce

This file mainly defines the applyreduce function.

This performs apply, but then reduces the result after flattening instead of rebuilding the geometry.

In general, the idea behind the apply framework is to take as input any geometry, vector of geometries, or feature collection, deconstruct it to the given trait target (any arbitrary GI.AbstractTrait or TraitTarget union thereof, like PointTrait or PolygonTrait) and perform some operation on it.

centroid, area and distance have been implemented using the applyreduce framework.

julia
"""
+    applyreduce(f, op, target::Union{TraitTarget, GI.AbstractTrait}, obj; threaded)
+
+Apply function \`f\` to all objects with the \`target\` trait,
+and reduce the result with an \`op\` like \`+\`.
+
+The order and grouping of application of \`op\` is not guaranteed.
+
+If \`threaded==true\` threads will be used over arrays and iterables,
+feature collections and nested geometries.
+"""
+@inline function applyreduce(
+    f::F, op::O, target, geom; threaded=false, init=nothing
+) where {F, O}
+    threaded = _booltype(threaded)
+    _applyreduce(f, op, TraitTarget(target), geom; threaded, init)
+end
+
+@inline _applyreduce(f::F, op::O, target, geom; threaded, init) where {F, O} =
+    _applyreduce(f, op, target, GI.trait(geom), geom; threaded, init)

Maybe use threads reducing over arrays

julia
@inline function _applyreduce(f::F, op::O, target, ::Nothing, A::AbstractArray; threaded, init) where {F, O}
+    applyreduce_array(i) = _applyreduce(f, op, target, A[i]; threaded=_False(), init)
+    _mapreducetasks(applyreduce_array, op, eachindex(A), threaded; init)
+end

Try to applyreduce over iterables

julia
@inline function _applyreduce(f::F, op::O, target, ::Nothing, iterable::IterableType; threaded, init) where {F, O, IterableType}
+    if Tables.istable(iterable)
+        _applyreduce_table(f, op, target, iterable; threaded, init)
+    else
+        applyreduce_iterable(i) = _applyreduce(f, op, target, i; threaded=_False(), init)
+        if threaded isa _True # Try to \`collect\` and reduce over the vector with threads
+            _applyreduce(f, op, target, collect(iterable); threaded, init)
+        else

Try to mapreduce the iterable as-is

julia
            mapreduce(applyreduce_iterable, op, iterable; init)
+        end
+    end
+end

In this case, we don't reconstruct the table, but only operate on the geometry column.

julia
function _applyreduce_table(f::F, op::O, target, iterable::IterableType; threaded, init) where {F, O, IterableType}

We extract the geometry column and run applyreduce on it.

julia
    geometry_column = first(GI.geometrycolumns(iterable))
+    return _applyreduce(f, op, target, Tables.getcolumn(iterable, geometry_column); threaded, init)
+end

If applyreduce wants features, then applyreduce over the rows as GI.Features.

julia
function _applyreduce_table(f::F, op::O, target::GI.FeatureTrait, iterable::IterableType; threaded, init) where {F, O, IterableType}

We extract the geometry column and run apply on it.

julia
    geometry_column = first(GI.geometrycolumns(iterable))
+    property_names = Iterators.filter(!=(geometry_column), Tables.schema(iterable).names)
+    features = map(Tables.rows(iterable)) do row
+        GI.Feature(Tables.getcolumn(row, geometry_column), properties=NamedTuple(Iterators.map(Base.Fix1(_get_col_pair, row), property_names)))
+    end
+    return _applyreduce(f, op, target, features; threaded, init)
+end

Maybe use threads reducing over features of feature collections

julia
@inline function _applyreduce(f::F, op::O, target, ::GI.FeatureCollectionTrait, fc; threaded, init) where {F, O}
+    applyreduce_fc(i) = _applyreduce(f, op, target, GI.getfeature(fc, i); threaded=_False(), init)
+    _mapreducetasks(applyreduce_fc, op, 1:GI.nfeature(fc), threaded; init)
+end

Features just applyreduce to their geometry

julia
@inline _applyreduce(f::F, op::O, target, ::GI.FeatureTrait, feature; threaded, init) where {F, O} =
+    _applyreduce(f, op, target, GI.geometry(feature); threaded, init)

Maybe use threads over components of nested geometries

julia
@inline function _applyreduce(f::F, op::O, target, trait, geom; threaded, init) where {F, O}
+    applyreduce_geom(i) = _applyreduce(f, op, target, GI.getgeom(geom, i); threaded=_False(), init)
+    _mapreducetasks(applyreduce_geom, op, 1:GI.ngeom(geom), threaded; init)
+end

Don't thread over points it won't pay off

julia
@inline function _applyreduce(
+    f::F, op::O, target, trait::Union{GI.LinearRing,GI.LineString,GI.MultiPoint}, geom;
+    threaded, init
+) where {F, O}
+    _applyreduce(f, op, target, GI.getgeom(geom); threaded=_False(), init)
+end

Apply f to the target

julia
@inline function _applyreduce(f::F, op::O, ::TraitTarget{Target}, ::Trait, x; kw...) where {F,O,Target,Trait<:Target}
+    f(x)
+end

Fail if we hit PointTrait _applyreduce(f, op, target::TraitTarget{Target}, trait::PointTrait, geom; kw...) where Target = throw(ArgumentError("target target not found")) Specific cases to avoid method ambiguity

julia
for T in (
+    GI.PointTrait, GI.LinearRing, GI.LineString,
+    GI.MultiPoint, GI.FeatureTrait, GI.FeatureCollectionTrait
+)
+    @eval _applyreduce(f::F, op::O, ::TraitTarget{<:$T}, trait::$T, x; kw...) where {F, O} = f(x)
+end
+
+### \`_mapreducetasks\` - flexible, threaded mapreduce
+
+import Base.Threads: nthreads, @threads, @spawn

Threading utility, modified Mason Protters threading PSA run f over ntasks, where f receives an AbstractArray/range of linear indices

WARNING: this will not work for mean/median - only ops where grouping is possible. That's because the implementation operates in chunks, and not globally.

If you absolutely need a single chunk, then threaded = false will always decompose to straight mapreduce without grouping.

julia
@inline function _mapreducetasks(f::F, op, taskrange, threaded::_True; init) where F
+    ntasks = length(taskrange)

Customize this as needed. More tasks have more overhead, but better load balancing

julia
    tasks_per_thread = 2
+    chunk_size = max(1, ntasks ÷ (tasks_per_thread * nthreads()))

partition the range into chunks

julia
    task_chunks = Iterators.partition(taskrange, chunk_size)

Map over the chunks

julia
    tasks = map(task_chunks) do chunk

Spawn a task to process this chunk

julia
        @spawn begin

Where we map f over the chunk indices

julia
            mapreduce(f, op, chunk; init)
+        end
+    end

Finally we join the results into a new vector

julia
    return mapreduce(fetch, op, tasks; init)
+end
+Base.@assume_effects :foldable function _mapreducetasks(f::F, op, taskrange, threaded::_False; init) where F
+    mapreduce(f, op, taskrange; init)
+end

This page was generated using Literate.jl.

`,51)]))}const y=i(h,[["render",e]]);export{E as __pageData,y as default}; diff --git a/previews/PR237/assets/source_src_applyreduce.md.DZQXF3zb.lean.js b/previews/PR237/assets/source_src_applyreduce.md.DZQXF3zb.lean.js new file mode 100644 index 000000000..3a9967acd --- /dev/null +++ b/previews/PR237/assets/source_src_applyreduce.md.DZQXF3zb.lean.js @@ -0,0 +1,72 @@ +import{_ as i,c as a,a5 as t,o as n}from"./chunks/framework.Cq8AuEls.js";const E=JSON.parse('{"title":"applyreduce","description":"","frontmatter":{},"headers":[],"relativePath":"source/src/applyreduce.md","filePath":"source/src/applyreduce.md","lastUpdated":null}'),h={name:"source/src/applyreduce.md"};function e(p,s,l,k,r,d){return n(),a("div",null,s[0]||(s[0]=[t(`

applyreduce

julia
export applyreduce

This file mainly defines the applyreduce function.

This performs apply, but then reduces the result after flattening instead of rebuilding the geometry.

In general, the idea behind the apply framework is to take as input any geometry, vector of geometries, or feature collection, deconstruct it to the given trait target (any arbitrary GI.AbstractTrait or TraitTarget union thereof, like PointTrait or PolygonTrait) and perform some operation on it.

centroid, area and distance have been implemented using the applyreduce framework.

julia
"""
+    applyreduce(f, op, target::Union{TraitTarget, GI.AbstractTrait}, obj; threaded)
+
+Apply function \`f\` to all objects with the \`target\` trait,
+and reduce the result with an \`op\` like \`+\`.
+
+The order and grouping of application of \`op\` is not guaranteed.
+
+If \`threaded==true\` threads will be used over arrays and iterables,
+feature collections and nested geometries.
+"""
+@inline function applyreduce(
+    f::F, op::O, target, geom; threaded=false, init=nothing
+) where {F, O}
+    threaded = _booltype(threaded)
+    _applyreduce(f, op, TraitTarget(target), geom; threaded, init)
+end
+
+@inline _applyreduce(f::F, op::O, target, geom; threaded, init) where {F, O} =
+    _applyreduce(f, op, target, GI.trait(geom), geom; threaded, init)

Maybe use threads reducing over arrays

julia
@inline function _applyreduce(f::F, op::O, target, ::Nothing, A::AbstractArray; threaded, init) where {F, O}
+    applyreduce_array(i) = _applyreduce(f, op, target, A[i]; threaded=_False(), init)
+    _mapreducetasks(applyreduce_array, op, eachindex(A), threaded; init)
+end

Try to applyreduce over iterables

julia
@inline function _applyreduce(f::F, op::O, target, ::Nothing, iterable::IterableType; threaded, init) where {F, O, IterableType}
+    if Tables.istable(iterable)
+        _applyreduce_table(f, op, target, iterable; threaded, init)
+    else
+        applyreduce_iterable(i) = _applyreduce(f, op, target, i; threaded=_False(), init)
+        if threaded isa _True # Try to \`collect\` and reduce over the vector with threads
+            _applyreduce(f, op, target, collect(iterable); threaded, init)
+        else

Try to mapreduce the iterable as-is

julia
            mapreduce(applyreduce_iterable, op, iterable; init)
+        end
+    end
+end

In this case, we don't reconstruct the table, but only operate on the geometry column.

julia
function _applyreduce_table(f::F, op::O, target, iterable::IterableType; threaded, init) where {F, O, IterableType}

We extract the geometry column and run applyreduce on it.

julia
    geometry_column = first(GI.geometrycolumns(iterable))
+    return _applyreduce(f, op, target, Tables.getcolumn(iterable, geometry_column); threaded, init)
+end

If applyreduce wants features, then applyreduce over the rows as GI.Features.

julia
function _applyreduce_table(f::F, op::O, target::GI.FeatureTrait, iterable::IterableType; threaded, init) where {F, O, IterableType}

We extract the geometry column and run apply on it.

julia
    geometry_column = first(GI.geometrycolumns(iterable))
+    property_names = Iterators.filter(!=(geometry_column), Tables.schema(iterable).names)
+    features = map(Tables.rows(iterable)) do row
+        GI.Feature(Tables.getcolumn(row, geometry_column), properties=NamedTuple(Iterators.map(Base.Fix1(_get_col_pair, row), property_names)))
+    end
+    return _applyreduce(f, op, target, features; threaded, init)
+end

Maybe use threads reducing over features of feature collections

julia
@inline function _applyreduce(f::F, op::O, target, ::GI.FeatureCollectionTrait, fc; threaded, init) where {F, O}
+    applyreduce_fc(i) = _applyreduce(f, op, target, GI.getfeature(fc, i); threaded=_False(), init)
+    _mapreducetasks(applyreduce_fc, op, 1:GI.nfeature(fc), threaded; init)
+end

Features just applyreduce to their geometry

julia
@inline _applyreduce(f::F, op::O, target, ::GI.FeatureTrait, feature; threaded, init) where {F, O} =
+    _applyreduce(f, op, target, GI.geometry(feature); threaded, init)

Maybe use threads over components of nested geometries

julia
@inline function _applyreduce(f::F, op::O, target, trait, geom; threaded, init) where {F, O}
+    applyreduce_geom(i) = _applyreduce(f, op, target, GI.getgeom(geom, i); threaded=_False(), init)
+    _mapreducetasks(applyreduce_geom, op, 1:GI.ngeom(geom), threaded; init)
+end

Don't thread over points it won't pay off

julia
@inline function _applyreduce(
+    f::F, op::O, target, trait::Union{GI.LinearRing,GI.LineString,GI.MultiPoint}, geom;
+    threaded, init
+) where {F, O}
+    _applyreduce(f, op, target, GI.getgeom(geom); threaded=_False(), init)
+end

Apply f to the target

julia
@inline function _applyreduce(f::F, op::O, ::TraitTarget{Target}, ::Trait, x; kw...) where {F,O,Target,Trait<:Target}
+    f(x)
+end

Fail if we hit PointTrait _applyreduce(f, op, target::TraitTarget{Target}, trait::PointTrait, geom; kw...) where Target = throw(ArgumentError("target target not found")) Specific cases to avoid method ambiguity

julia
for T in (
+    GI.PointTrait, GI.LinearRing, GI.LineString,
+    GI.MultiPoint, GI.FeatureTrait, GI.FeatureCollectionTrait
+)
+    @eval _applyreduce(f::F, op::O, ::TraitTarget{<:$T}, trait::$T, x; kw...) where {F, O} = f(x)
+end
+
+### \`_mapreducetasks\` - flexible, threaded mapreduce
+
+import Base.Threads: nthreads, @threads, @spawn

Threading utility, modified Mason Protters threading PSA run f over ntasks, where f receives an AbstractArray/range of linear indices

WARNING: this will not work for mean/median - only ops where grouping is possible. That's because the implementation operates in chunks, and not globally.

If you absolutely need a single chunk, then threaded = false will always decompose to straight mapreduce without grouping.

julia
@inline function _mapreducetasks(f::F, op, taskrange, threaded::_True; init) where F
+    ntasks = length(taskrange)

Customize this as needed. More tasks have more overhead, but better load balancing

julia
    tasks_per_thread = 2
+    chunk_size = max(1, ntasks ÷ (tasks_per_thread * nthreads()))

partition the range into chunks

julia
    task_chunks = Iterators.partition(taskrange, chunk_size)

Map over the chunks

julia
    tasks = map(task_chunks) do chunk

Spawn a task to process this chunk

julia
        @spawn begin

Where we map f over the chunk indices

julia
            mapreduce(f, op, chunk; init)
+        end
+    end

Finally we join the results into a new vector

julia
    return mapreduce(fetch, op, tasks; init)
+end
+Base.@assume_effects :foldable function _mapreducetasks(f::F, op, taskrange, threaded::_False; init) where F
+    mapreduce(f, op, taskrange; init)
+end

This page was generated using Literate.jl.

`,51)]))}const y=i(h,[["render",e]]);export{E as __pageData,y as default}; diff --git a/previews/PR237/assets/source_src_geometry_utils.md.DStHZN_K.js b/previews/PR237/assets/source_src_geometry_utils.md.DStHZN_K.js new file mode 100644 index 000000000..bed042a7d --- /dev/null +++ b/previews/PR237/assets/source_src_geometry_utils.md.DStHZN_K.js @@ -0,0 +1,2 @@ +import{_ as i,c as a,a5 as t,o as e}from"./chunks/framework.Cq8AuEls.js";const E=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"source/src/geometry_utils.md","filePath":"source/src/geometry_utils.md","lastUpdated":null}'),n={name:"source/src/geometry_utils.md"};function h(l,s,k,p,r,g){return e(),a("div",null,s[0]||(s[0]=[t(`
julia
_linearring(geom::GI.LineString) = GI.LinearRing(parent(geom); extent=geom.extent, crs=geom.crs)
+_linearring(geom::GI.LinearRing) = geom

This page was generated using Literate.jl.

`,3)]))}const o=i(n,[["render",h]]);export{E as __pageData,o as default}; diff --git a/previews/PR237/assets/source_src_geometry_utils.md.DStHZN_K.lean.js b/previews/PR237/assets/source_src_geometry_utils.md.DStHZN_K.lean.js new file mode 100644 index 000000000..bed042a7d --- /dev/null +++ b/previews/PR237/assets/source_src_geometry_utils.md.DStHZN_K.lean.js @@ -0,0 +1,2 @@ +import{_ as i,c as a,a5 as t,o as e}from"./chunks/framework.Cq8AuEls.js";const E=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"source/src/geometry_utils.md","filePath":"source/src/geometry_utils.md","lastUpdated":null}'),n={name:"source/src/geometry_utils.md"};function h(l,s,k,p,r,g){return e(),a("div",null,s[0]||(s[0]=[t(`
julia
_linearring(geom::GI.LineString) = GI.LinearRing(parent(geom); extent=geom.extent, crs=geom.crs)
+_linearring(geom::GI.LinearRing) = geom

This page was generated using Literate.jl.

`,3)]))}const o=i(n,[["render",h]]);export{E as __pageData,o as default}; diff --git a/previews/PR237/assets/source_src_keyword_docs.md.Cu2o_Mxm.js b/previews/PR237/assets/source_src_keyword_docs.md.Cu2o_Mxm.js new file mode 100644 index 000000000..5b627fc25 --- /dev/null +++ b/previews/PR237/assets/source_src_keyword_docs.md.Cu2o_Mxm.js @@ -0,0 +1 @@ +import{_ as a,c as i,a5 as t,o as e}from"./chunks/framework.Cq8AuEls.js";const c=JSON.parse('{"title":"Keyword docs","description":"","frontmatter":{},"headers":[],"relativePath":"source/src/keyword_docs.md","filePath":"source/src/keyword_docs.md","lastUpdated":null}'),n={name:"source/src/keyword_docs.md"};function l(h,s,o,r,p,d){return e(),i("div",null,s[0]||(s[0]=[t('

Keyword docs

This file defines common keyword documentation, that can be spliced into docstrings.

julia
const THREADED_KEYWORD = "- `threaded`: `true` or `false`. Whether to use multithreading. Defaults to `false`."\nconst CRS_KEYWORD = "- `crs`: The CRS to attach to geometries. Defaults to `nothing`."\nconst CALC_EXTENT_KEYWORD = "- `calc_extent`: `true` or `false`. Whether to calculate the extent. Defaults to `false`."\n\nconst APPLY_KEYWORDS = """\n$THREADED_KEYWORD\n$CRS_KEYWORD\n$CALC_EXTENT_KEYWORD\n"""

This page was generated using Literate.jl.

',5)]))}const u=a(n,[["render",l]]);export{c as __pageData,u as default}; diff --git a/previews/PR237/assets/source_src_keyword_docs.md.Cu2o_Mxm.lean.js b/previews/PR237/assets/source_src_keyword_docs.md.Cu2o_Mxm.lean.js new file mode 100644 index 000000000..5b627fc25 --- /dev/null +++ b/previews/PR237/assets/source_src_keyword_docs.md.Cu2o_Mxm.lean.js @@ -0,0 +1 @@ +import{_ as a,c as i,a5 as t,o as e}from"./chunks/framework.Cq8AuEls.js";const c=JSON.parse('{"title":"Keyword docs","description":"","frontmatter":{},"headers":[],"relativePath":"source/src/keyword_docs.md","filePath":"source/src/keyword_docs.md","lastUpdated":null}'),n={name:"source/src/keyword_docs.md"};function l(h,s,o,r,p,d){return e(),i("div",null,s[0]||(s[0]=[t('

Keyword docs

This file defines common keyword documentation, that can be spliced into docstrings.

julia
const THREADED_KEYWORD = "- `threaded`: `true` or `false`. Whether to use multithreading. Defaults to `false`."\nconst CRS_KEYWORD = "- `crs`: The CRS to attach to geometries. Defaults to `nothing`."\nconst CALC_EXTENT_KEYWORD = "- `calc_extent`: `true` or `false`. Whether to calculate the extent. Defaults to `false`."\n\nconst APPLY_KEYWORDS = """\n$THREADED_KEYWORD\n$CRS_KEYWORD\n$CALC_EXTENT_KEYWORD\n"""

This page was generated using Literate.jl.

',5)]))}const u=a(n,[["render",l]]);export{c as __pageData,u as default}; diff --git a/previews/PR237/assets/source_src_other_primitives.md.x4-eP4Xq.js b/previews/PR237/assets/source_src_other_primitives.md.x4-eP4Xq.js new file mode 100644 index 000000000..b13574271 --- /dev/null +++ b/previews/PR237/assets/source_src_other_primitives.md.x4-eP4Xq.js @@ -0,0 +1,118 @@ +import{_ as e,c as p,j as i,a,G as h,a5 as t,B as l,o as k}from"./chunks/framework.Cq8AuEls.js";const B=JSON.parse('{"title":"Other primitives (unwrap, flatten, etc)","description":"","frontmatter":{},"headers":[],"relativePath":"source/src/other_primitives.md","filePath":"source/src/other_primitives.md","lastUpdated":null}'),r={name:"source/src/other_primitives.md"},d={class:"jldocstring custom-block",open:""},g={class:"jldocstring custom-block",open:""},E={class:"jldocstring custom-block",open:""},y={class:"jldocstring custom-block",open:""};function o(F,s,c,C,u,m){const n=l("Badge");return k(),p("div",null,[s[12]||(s[12]=i("h1",{id:"Other-primitives-(unwrap,-flatten,-etc)",tabindex:"-1"},[a("Other primitives (unwrap, flatten, etc) "),i("a",{class:"header-anchor",href:"#Other-primitives-(unwrap,-flatten,-etc)","aria-label":'Permalink to "Other primitives (unwrap, flatten, etc) {#Other-primitives-(unwrap,-flatten,-etc)}"'},"​")],-1)),s[13]||(s[13]=i("p",null,"This file defines the following primitives:",-1)),i("details",d,[i("summary",null,[s[0]||(s[0]=i("a",{id:"GeometryOpsCore.unwrap-source-src-other_primitives",href:"#GeometryOpsCore.unwrap-source-src-other_primitives"},[i("span",{class:"jlbinding"},"GeometryOpsCore.unwrap")],-1)),s[1]||(s[1]=a()),h(n,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[2]||(s[2]=t(`
julia
unwrap(target::Type{<:AbstractTrait}, obj)
+unwrap(f, target::Type{<:AbstractTrait}, obj)

Unwrap the object to vectors, down to the target trait.

If f is passed in it will be applied to the target geometries as they are found.

source

`,4))]),i("details",g,[i("summary",null,[s[3]||(s[3]=i("a",{id:"GeometryOpsCore.flatten-source-src-other_primitives",href:"#GeometryOpsCore.flatten-source-src-other_primitives"},[i("span",{class:"jlbinding"},"GeometryOpsCore.flatten")],-1)),s[4]||(s[4]=a()),h(n,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[5]||(s[5]=t(`
julia
flatten(target::Type{<:GI.AbstractTrait}, obj)
+flatten(f, target::Type{<:GI.AbstractTrait}, obj)

Lazily flatten any AbstractArray, iterator, FeatureCollectionTrait, FeatureTrait or AbstractGeometryTrait object obj, so that objects with the target trait are returned by the iterator.

If f is passed in it will be applied to the target geometries.

source

`,4))]),i("details",E,[i("summary",null,[s[6]||(s[6]=i("a",{id:"GeometryOpsCore.reconstruct-source-src-other_primitives",href:"#GeometryOpsCore.reconstruct-source-src-other_primitives"},[i("span",{class:"jlbinding"},"GeometryOpsCore.reconstruct")],-1)),s[7]||(s[7]=a()),h(n,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[8]||(s[8]=t('
julia
reconstruct(geom, components)

Reconstruct geom from an iterable of component objects that match its structure.

All objects in components must have the same GeoInterface.trait.

Usually used in combination with flatten.

source

',5))]),i("details",y,[i("summary",null,[s[9]||(s[9]=i("a",{id:"GeometryOpsCore.rebuild-source-src-other_primitives",href:"#GeometryOpsCore.rebuild-source-src-other_primitives"},[i("span",{class:"jlbinding"},"GeometryOpsCore.rebuild")],-1)),s[10]||(s[10]=a()),h(n,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[11]||(s[11]=t('
julia
rebuild(geom, child_geoms)

Rebuild a geometry from child geometries.

By default geometries will be rebuilt as a GeoInterface.Wrappers geometry, but rebuild can have methods added to it to dispatch on geometries from other packages and specify how to rebuild them.

(Maybe it should go into GeoInterface.jl)

source

',5))]),s[14]||(s[14]=t(`
julia
"""
+    unwrap(target::Type{<:AbstractTrait}, obj)
+    unwrap(f, target::Type{<:AbstractTrait}, obj)
+
+Unwrap the object to vectors, down to the target trait.
+
+If \`f\` is passed in it will be applied to the target geometries
+as they are found.
+"""
+function unwrap end
+unwrap(target::Type, geom) = unwrap(identity, target, geom)

Add dispatch argument for trait

julia
unwrap(f, target::Type, geom) = unwrap(f, target, GI.trait(geom), geom)

Try to unwrap over iterables

julia
unwrap(f, target::Type, ::Nothing, iterable) =
+    map(x -> unwrap(f, target, x), iterable)

Rewrap feature collections

julia
unwrap(f, target::Type, ::GI.FeatureCollectionTrait, fc) =
+    map(x -> unwrap(f, target, x), GI.getfeature(fc))
+unwrap(f, target::Type, ::GI.FeatureTrait, feature) =
+    unwrap(f, target, GI.geometry(feature))
+unwrap(f, target::Type, trait, geom) = map(g -> unwrap(f, target, g), GI.getgeom(geom))

Apply f to the target geometry

julia
unwrap(f, ::Type{Target}, ::Trait, geom) where {Target,Trait<:Target} = f(geom)

Fail if we hit PointTrait

julia
unwrap(f, target::Type, trait::GI.PointTrait, geom) =
+    throw(ArgumentError("target $target not found, but reached a \`PointTrait\` leaf"))

Specific cases to avoid method ambiguity

julia
unwrap(f, target::Type{GI.PointTrait}, trait::GI.PointTrait, geom) = f(geom)
+unwrap(f, target::Type{GI.FeatureTrait}, ::GI.FeatureTrait, feature) = f(feature)
+unwrap(f, target::Type{GI.FeatureCollectionTrait}, ::GI.FeatureCollectionTrait, fc) = f(fc)
+
+"""
+    flatten(target::Type{<:GI.AbstractTrait}, obj)
+    flatten(f, target::Type{<:GI.AbstractTrait}, obj)
+
+Lazily flatten any \`AbstractArray\`, iterator, \`FeatureCollectionTrait\`,
+\`FeatureTrait\` or \`AbstractGeometryTrait\` object \`obj\`, so that objects
+with the \`target\` trait are returned by the iterator.
+
+If \`f\` is passed in it will be applied to the target geometries.
+"""
+flatten(::Type{Target}, geom) where {Target<:GI.AbstractTrait} = flatten(identity, Target, geom)
+flatten(f, ::Type{Target}, geom) where {Target<:GI.AbstractTrait} = _flatten(f, Target, geom)
+
+_flatten(f, ::Type{Target}, geom) where Target = _flatten(f, Target, GI.trait(geom), geom)

Try to flatten over iterables

julia
function _flatten(f, ::Type{Target}, ::Nothing, iterable) where Target
+    if Tables.istable(iterable)
+        column = Tables.getcolumn(iterable, first(GI.geometrycolumns(iterable)))
+        Iterators.map(x -> _flatten(f, Target, x), column) |> Iterators.flatten
+    else
+        Iterators.map(x -> _flatten(f, Target, x), iterable) |> Iterators.flatten
+    end
+end

Flatten feature collections

julia
function _flatten(f, ::Type{Target}, ::GI.FeatureCollectionTrait, fc) where Target
+    Iterators.map(GI.getfeature(fc)) do feature
+        _flatten(f, Target, feature)
+    end |> Iterators.flatten
+end
+_flatten(f, ::Type{Target}, ::GI.FeatureTrait, feature) where Target =
+    _flatten(f, Target, GI.geometry(feature))

Apply f to the target geometry

julia
_flatten(f, ::Type{Target}, ::Trait, geom) where {Target,Trait<:Target} = (f(geom),)
+_flatten(f, ::Type{Target}, trait, geom) where Target =
+    Iterators.flatten(Iterators.map(g -> _flatten(f, Target, g), GI.getgeom(geom)))

Fail if we hit PointTrait without running f

julia
_flatten(f, ::Type{Target}, trait::GI.PointTrait, geom) where Target =
+    throw(ArgumentError("target $Target not found, but reached a \`PointTrait\` leaf"))

Specific cases to avoid method ambiguity

julia
_flatten(f, ::Type{<:GI.PointTrait}, ::GI.PointTrait, geom) = (f(geom),)
+_flatten(f, ::Type{<:GI.FeatureTrait}, ::GI.FeatureTrait, feature) = (f(feature),)
+_flatten(f, ::Type{<:GI.FeatureCollectionTrait}, ::GI.FeatureCollectionTrait, fc) = (f(fc),)
+
+
+"""
+    reconstruct(geom, components)
+
+Reconstruct \`geom\` from an iterable of component objects that match its structure.
+
+All objects in \`components\` must have the same \`GeoInterface.trait\`.
+
+Usually used in combination with \`flatten\`.
+"""
+function reconstruct(geom, components)
+    obj, iter = _reconstruct(geom, components)
+    return obj
+end
+
+_reconstruct(geom, components) =
+    _reconstruct(typeof(GI.trait(first(components))), geom, components, 1)
+_reconstruct(::Type{Target}, geom, components, iter) where Target =
+    _reconstruct(Target, GI.trait(geom), geom, components, iter)

Try to reconstruct over iterables

julia
function _reconstruct(::Type{Target}, ::Nothing, iterable, components, iter) where Target
+    vect = map(iterable) do x

iter is updated by _reconstruct here

julia
        obj, iter = _reconstruct(Target, x, components, iter)
+        obj
+    end
+    return vect, iter
+end

Reconstruct feature collections

julia
function _reconstruct(::Type{Target}, ::GI.FeatureCollectionTrait, fc, components, iter) where Target
+    features = map(GI.getfeature(fc)) do feature

iter is updated by _reconstruct here

julia
        newfeature, iter = _reconstruct(Target, feature, components, iter)
+        newfeature
+    end
+    return GI.FeatureCollection(features; crs=GI.crs(fc)), iter
+end
+function _reconstruct(::Type{Target}, ::GI.FeatureTrait, feature, components, iter) where Target
+    geom, iter = _reconstruct(Target, GI.geometry(feature), components, iter)
+    return GI.Feature(geom; properties=GI.properties(feature), crs=GI.crs(feature)), iter
+end
+function _reconstruct(::Type{Target}, trait, geom, components, iter) where Target
+    geoms = map(GI.getgeom(geom)) do subgeom

iter is updated by _reconstruct here

julia
        subgeom1, iter = _reconstruct(Target, GI.trait(subgeom), subgeom, components, iter)
+        subgeom1
+    end
+    return rebuild(geom, geoms), iter
+end

Apply f to the target geometry

julia
_reconstruct(::Type{Target}, ::Trait, geom, components, iter) where {Target,Trait<:Target} =
+    iterate(components, iter)

Specific cases to avoid method ambiguity

julia
_reconstruct(::Type{<:GI.PointTrait}, ::GI.PointTrait, geom, components, iter) = iterate(components, iter)
+_reconstruct(::Type{<:GI.FeatureTrait}, ::GI.FeatureTrait, feature, components, iter) = iterate(feature, iter)
+_reconstruct(::Type{<:GI.FeatureCollectionTrait}, ::GI.FeatureCollectionTrait, fc, components, iter) = iterate(fc, iter)

Fail if we hit PointTrait without running f

julia
_reconstruct(::Type{Target}, trait::GI.PointTrait, geom, components, iter) where Target =
+    throw(ArgumentError("target $Target not found, but reached a \`PointTrait\` leaf"))
+
+"""
+    rebuild(geom, child_geoms)
+
+Rebuild a geometry from child geometries.
+
+By default geometries will be rebuilt as a \`GeoInterface.Wrappers\`
+geometry, but \`rebuild\` can have methods added to it to dispatch
+on geometries from other packages and specify how to rebuild them.
+
+(Maybe it should go into GeoInterface.jl)
+"""
+rebuild(geom, child_geoms; kw...) = rebuild(GI.trait(geom), geom, child_geoms; kw...)
+function rebuild(trait::GI.AbstractTrait, geom, child_geoms; crs=GI.crs(geom), extent=nothing)
+    T = GI.geointerface_geomtype(trait)
+    if GI.is3d(geom)

The Boolean type parameters here indicate "3d-ness" and "measure" coordinate, respectively.

julia
        return T{true,false}(child_geoms; crs, extent)
+    else
+        return T{false,false}(child_geoms; crs, extent)
+    end
+end

This page was generated using Literate.jl.

`,43))])}const A=e(r,[["render",o]]);export{B as __pageData,A as default}; diff --git a/previews/PR237/assets/source_src_other_primitives.md.x4-eP4Xq.lean.js b/previews/PR237/assets/source_src_other_primitives.md.x4-eP4Xq.lean.js new file mode 100644 index 000000000..b13574271 --- /dev/null +++ b/previews/PR237/assets/source_src_other_primitives.md.x4-eP4Xq.lean.js @@ -0,0 +1,118 @@ +import{_ as e,c as p,j as i,a,G as h,a5 as t,B as l,o as k}from"./chunks/framework.Cq8AuEls.js";const B=JSON.parse('{"title":"Other primitives (unwrap, flatten, etc)","description":"","frontmatter":{},"headers":[],"relativePath":"source/src/other_primitives.md","filePath":"source/src/other_primitives.md","lastUpdated":null}'),r={name:"source/src/other_primitives.md"},d={class:"jldocstring custom-block",open:""},g={class:"jldocstring custom-block",open:""},E={class:"jldocstring custom-block",open:""},y={class:"jldocstring custom-block",open:""};function o(F,s,c,C,u,m){const n=l("Badge");return k(),p("div",null,[s[12]||(s[12]=i("h1",{id:"Other-primitives-(unwrap,-flatten,-etc)",tabindex:"-1"},[a("Other primitives (unwrap, flatten, etc) "),i("a",{class:"header-anchor",href:"#Other-primitives-(unwrap,-flatten,-etc)","aria-label":'Permalink to "Other primitives (unwrap, flatten, etc) {#Other-primitives-(unwrap,-flatten,-etc)}"'},"​")],-1)),s[13]||(s[13]=i("p",null,"This file defines the following primitives:",-1)),i("details",d,[i("summary",null,[s[0]||(s[0]=i("a",{id:"GeometryOpsCore.unwrap-source-src-other_primitives",href:"#GeometryOpsCore.unwrap-source-src-other_primitives"},[i("span",{class:"jlbinding"},"GeometryOpsCore.unwrap")],-1)),s[1]||(s[1]=a()),h(n,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[2]||(s[2]=t(`
julia
unwrap(target::Type{<:AbstractTrait}, obj)
+unwrap(f, target::Type{<:AbstractTrait}, obj)

Unwrap the object to vectors, down to the target trait.

If f is passed in it will be applied to the target geometries as they are found.

source

`,4))]),i("details",g,[i("summary",null,[s[3]||(s[3]=i("a",{id:"GeometryOpsCore.flatten-source-src-other_primitives",href:"#GeometryOpsCore.flatten-source-src-other_primitives"},[i("span",{class:"jlbinding"},"GeometryOpsCore.flatten")],-1)),s[4]||(s[4]=a()),h(n,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[5]||(s[5]=t(`
julia
flatten(target::Type{<:GI.AbstractTrait}, obj)
+flatten(f, target::Type{<:GI.AbstractTrait}, obj)

Lazily flatten any AbstractArray, iterator, FeatureCollectionTrait, FeatureTrait or AbstractGeometryTrait object obj, so that objects with the target trait are returned by the iterator.

If f is passed in it will be applied to the target geometries.

source

`,4))]),i("details",E,[i("summary",null,[s[6]||(s[6]=i("a",{id:"GeometryOpsCore.reconstruct-source-src-other_primitives",href:"#GeometryOpsCore.reconstruct-source-src-other_primitives"},[i("span",{class:"jlbinding"},"GeometryOpsCore.reconstruct")],-1)),s[7]||(s[7]=a()),h(n,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[8]||(s[8]=t('
julia
reconstruct(geom, components)

Reconstruct geom from an iterable of component objects that match its structure.

All objects in components must have the same GeoInterface.trait.

Usually used in combination with flatten.

source

',5))]),i("details",y,[i("summary",null,[s[9]||(s[9]=i("a",{id:"GeometryOpsCore.rebuild-source-src-other_primitives",href:"#GeometryOpsCore.rebuild-source-src-other_primitives"},[i("span",{class:"jlbinding"},"GeometryOpsCore.rebuild")],-1)),s[10]||(s[10]=a()),h(n,{type:"info",class:"jlObjectType jlFunction",text:"Function"})]),s[11]||(s[11]=t('
julia
rebuild(geom, child_geoms)

Rebuild a geometry from child geometries.

By default geometries will be rebuilt as a GeoInterface.Wrappers geometry, but rebuild can have methods added to it to dispatch on geometries from other packages and specify how to rebuild them.

(Maybe it should go into GeoInterface.jl)

source

',5))]),s[14]||(s[14]=t(`
julia
"""
+    unwrap(target::Type{<:AbstractTrait}, obj)
+    unwrap(f, target::Type{<:AbstractTrait}, obj)
+
+Unwrap the object to vectors, down to the target trait.
+
+If \`f\` is passed in it will be applied to the target geometries
+as they are found.
+"""
+function unwrap end
+unwrap(target::Type, geom) = unwrap(identity, target, geom)

Add dispatch argument for trait

julia
unwrap(f, target::Type, geom) = unwrap(f, target, GI.trait(geom), geom)

Try to unwrap over iterables

julia
unwrap(f, target::Type, ::Nothing, iterable) =
+    map(x -> unwrap(f, target, x), iterable)

Rewrap feature collections

julia
unwrap(f, target::Type, ::GI.FeatureCollectionTrait, fc) =
+    map(x -> unwrap(f, target, x), GI.getfeature(fc))
+unwrap(f, target::Type, ::GI.FeatureTrait, feature) =
+    unwrap(f, target, GI.geometry(feature))
+unwrap(f, target::Type, trait, geom) = map(g -> unwrap(f, target, g), GI.getgeom(geom))

Apply f to the target geometry

julia
unwrap(f, ::Type{Target}, ::Trait, geom) where {Target,Trait<:Target} = f(geom)

Fail if we hit PointTrait

julia
unwrap(f, target::Type, trait::GI.PointTrait, geom) =
+    throw(ArgumentError("target $target not found, but reached a \`PointTrait\` leaf"))

Specific cases to avoid method ambiguity

julia
unwrap(f, target::Type{GI.PointTrait}, trait::GI.PointTrait, geom) = f(geom)
+unwrap(f, target::Type{GI.FeatureTrait}, ::GI.FeatureTrait, feature) = f(feature)
+unwrap(f, target::Type{GI.FeatureCollectionTrait}, ::GI.FeatureCollectionTrait, fc) = f(fc)
+
+"""
+    flatten(target::Type{<:GI.AbstractTrait}, obj)
+    flatten(f, target::Type{<:GI.AbstractTrait}, obj)
+
+Lazily flatten any \`AbstractArray\`, iterator, \`FeatureCollectionTrait\`,
+\`FeatureTrait\` or \`AbstractGeometryTrait\` object \`obj\`, so that objects
+with the \`target\` trait are returned by the iterator.
+
+If \`f\` is passed in it will be applied to the target geometries.
+"""
+flatten(::Type{Target}, geom) where {Target<:GI.AbstractTrait} = flatten(identity, Target, geom)
+flatten(f, ::Type{Target}, geom) where {Target<:GI.AbstractTrait} = _flatten(f, Target, geom)
+
+_flatten(f, ::Type{Target}, geom) where Target = _flatten(f, Target, GI.trait(geom), geom)

Try to flatten over iterables

julia
function _flatten(f, ::Type{Target}, ::Nothing, iterable) where Target
+    if Tables.istable(iterable)
+        column = Tables.getcolumn(iterable, first(GI.geometrycolumns(iterable)))
+        Iterators.map(x -> _flatten(f, Target, x), column) |> Iterators.flatten
+    else
+        Iterators.map(x -> _flatten(f, Target, x), iterable) |> Iterators.flatten
+    end
+end

Flatten feature collections

julia
function _flatten(f, ::Type{Target}, ::GI.FeatureCollectionTrait, fc) where Target
+    Iterators.map(GI.getfeature(fc)) do feature
+        _flatten(f, Target, feature)
+    end |> Iterators.flatten
+end
+_flatten(f, ::Type{Target}, ::GI.FeatureTrait, feature) where Target =
+    _flatten(f, Target, GI.geometry(feature))

Apply f to the target geometry

julia
_flatten(f, ::Type{Target}, ::Trait, geom) where {Target,Trait<:Target} = (f(geom),)
+_flatten(f, ::Type{Target}, trait, geom) where Target =
+    Iterators.flatten(Iterators.map(g -> _flatten(f, Target, g), GI.getgeom(geom)))

Fail if we hit PointTrait without running f

julia
_flatten(f, ::Type{Target}, trait::GI.PointTrait, geom) where Target =
+    throw(ArgumentError("target $Target not found, but reached a \`PointTrait\` leaf"))

Specific cases to avoid method ambiguity

julia
_flatten(f, ::Type{<:GI.PointTrait}, ::GI.PointTrait, geom) = (f(geom),)
+_flatten(f, ::Type{<:GI.FeatureTrait}, ::GI.FeatureTrait, feature) = (f(feature),)
+_flatten(f, ::Type{<:GI.FeatureCollectionTrait}, ::GI.FeatureCollectionTrait, fc) = (f(fc),)
+
+
+"""
+    reconstruct(geom, components)
+
+Reconstruct \`geom\` from an iterable of component objects that match its structure.
+
+All objects in \`components\` must have the same \`GeoInterface.trait\`.
+
+Usually used in combination with \`flatten\`.
+"""
+function reconstruct(geom, components)
+    obj, iter = _reconstruct(geom, components)
+    return obj
+end
+
+_reconstruct(geom, components) =
+    _reconstruct(typeof(GI.trait(first(components))), geom, components, 1)
+_reconstruct(::Type{Target}, geom, components, iter) where Target =
+    _reconstruct(Target, GI.trait(geom), geom, components, iter)

Try to reconstruct over iterables

julia
function _reconstruct(::Type{Target}, ::Nothing, iterable, components, iter) where Target
+    vect = map(iterable) do x

iter is updated by _reconstruct here

julia
        obj, iter = _reconstruct(Target, x, components, iter)
+        obj
+    end
+    return vect, iter
+end

Reconstruct feature collections

julia
function _reconstruct(::Type{Target}, ::GI.FeatureCollectionTrait, fc, components, iter) where Target
+    features = map(GI.getfeature(fc)) do feature

iter is updated by _reconstruct here

julia
        newfeature, iter = _reconstruct(Target, feature, components, iter)
+        newfeature
+    end
+    return GI.FeatureCollection(features; crs=GI.crs(fc)), iter
+end
+function _reconstruct(::Type{Target}, ::GI.FeatureTrait, feature, components, iter) where Target
+    geom, iter = _reconstruct(Target, GI.geometry(feature), components, iter)
+    return GI.Feature(geom; properties=GI.properties(feature), crs=GI.crs(feature)), iter
+end
+function _reconstruct(::Type{Target}, trait, geom, components, iter) where Target
+    geoms = map(GI.getgeom(geom)) do subgeom

iter is updated by _reconstruct here

julia
        subgeom1, iter = _reconstruct(Target, GI.trait(subgeom), subgeom, components, iter)
+        subgeom1
+    end
+    return rebuild(geom, geoms), iter
+end

Apply f to the target geometry

julia
_reconstruct(::Type{Target}, ::Trait, geom, components, iter) where {Target,Trait<:Target} =
+    iterate(components, iter)

Specific cases to avoid method ambiguity

julia
_reconstruct(::Type{<:GI.PointTrait}, ::GI.PointTrait, geom, components, iter) = iterate(components, iter)
+_reconstruct(::Type{<:GI.FeatureTrait}, ::GI.FeatureTrait, feature, components, iter) = iterate(feature, iter)
+_reconstruct(::Type{<:GI.FeatureCollectionTrait}, ::GI.FeatureCollectionTrait, fc, components, iter) = iterate(fc, iter)

Fail if we hit PointTrait without running f

julia
_reconstruct(::Type{Target}, trait::GI.PointTrait, geom, components, iter) where Target =
+    throw(ArgumentError("target $Target not found, but reached a \`PointTrait\` leaf"))
+
+"""
+    rebuild(geom, child_geoms)
+
+Rebuild a geometry from child geometries.
+
+By default geometries will be rebuilt as a \`GeoInterface.Wrappers\`
+geometry, but \`rebuild\` can have methods added to it to dispatch
+on geometries from other packages and specify how to rebuild them.
+
+(Maybe it should go into GeoInterface.jl)
+"""
+rebuild(geom, child_geoms; kw...) = rebuild(GI.trait(geom), geom, child_geoms; kw...)
+function rebuild(trait::GI.AbstractTrait, geom, child_geoms; crs=GI.crs(geom), extent=nothing)
+    T = GI.geointerface_geomtype(trait)
+    if GI.is3d(geom)

The Boolean type parameters here indicate "3d-ness" and "measure" coordinate, respectively.

julia
        return T{true,false}(child_geoms; crs, extent)
+    else
+        return T{false,false}(child_geoms; crs, extent)
+    end
+end

This page was generated using Literate.jl.

`,43))])}const A=e(r,[["render",o]]);export{B as __pageData,A as default}; diff --git a/previews/PR237/assets/source_src_types.md.DBsi_VC7.js b/previews/PR237/assets/source_src_types.md.DBsi_VC7.js new file mode 100644 index 000000000..3f59f6c3d --- /dev/null +++ b/previews/PR237/assets/source_src_types.md.DBsi_VC7.js @@ -0,0 +1,111 @@ +import{_ as a,c as i,a5 as n,o as e}from"./chunks/framework.Cq8AuEls.js";const c=JSON.parse('{"title":"Types","description":"","frontmatter":{},"headers":[],"relativePath":"source/src/types.md","filePath":"source/src/types.md","lastUpdated":null}'),t={name:"source/src/types.md"};function l(p,s,h,k,r,o){return e(),i("div",null,s[0]||(s[0]=[n(`

Types

This defines core types that the GeometryOps ecosystem uses, and that are usable in more than just GeometryOps.

Manifold

A manifold is mathematically defined as a topological space that resembles Euclidean space locally.

In GeometryOps (and geodesy more generally), there are three manifolds we care about:

  • Planar: the 2d plane, a completely Euclidean manifold

  • Spherical: the unit sphere, but one where areas are multiplied by the radius of the Earth. This is not Euclidean globally, but all map projections attempt to represent the sphere on the Euclidean 2D plane to varying degrees of success.

  • Geodesic: the ellipsoid, the closest we can come to representing the Earth by a simple geometric shape. Parametrized by semimajor_axis and inv_flattening.

Generally, we aim to have Linear and Spherical be operable everywhere, whereas Geodesic will only apply in specific circumstances. Currently, those circumstances are area and segmentize, but this could be extended with time and https://github.com/JuliaGeo/SphericalGeodesics.jl.

julia
export Planar, Spherical, Geodesic
+export TraitTarget
+export BoolsAsTypes, _True, _False, _booltype
+
+"""
+    abstract type Manifold
+
+A manifold is mathematically defined as a topological space that resembles Euclidean space locally.
+
+We use the manifold definition to define the space in which an operation should be performed, or where a geometry lies.
+
+Currently we have \`Planar\`, \`Spherical\`, and \`Geodesic\` manifolds.
+"""
+abstract type Manifold end
+
+"""
+    Planar()
+
+A planar manifold refers to the 2D Euclidean plane.
+
+Z coordinates may be accepted but will not influence geometry calculations, which
+are done purely on 2D geometry.  This is the standard "2.5D" model used by e.g. GEOS.
+"""
+struct Planar <: Manifold
+end
+
+"""
+    Spherical(; radius)
+
+A spherical manifold means that the geometry is on the 3-sphere (but is represented by 2-D longitude and latitude).
+
+By default, the radius is defined as the mean radius of the Earth, \`6371008.8 m\`.
+
+# Extended help
+
+!!! note
+    The traditional definition of spherical coordinates in physics and mathematics,
+    \`\`r, \\\\theta, \\\\phi\`\`, uses the _colatitude_, that measures angular displacement from the \`z\`-axis.
+
+    Here, we use the geographic definition of longitude and latitude, meaning
+    that \`lon\` is longitude between -180 and 180, and \`lat\` is latitude between
+    \`-90\` (south pole) and \`90\` (north pole).
+"""
+Base.@kwdef struct Spherical{T} <: Manifold
+    radius::T = 6371008.8
+end
+
+"""
+    Geodesic(; semimajor_axis, inv_flattening)
+
+A geodesic manifold means that the geometry is on a 3-dimensional ellipsoid, parameterized by \`semimajor_axis\` (\`\`a\`\` in mathematical parlance)
+and \`inv_flattening\` (\`\`1/f\`\`).
+
+Usually, this is only relevant for area and segmentization calculations.  It becomes more relevant as one grows closer to the poles (or equator).
+"""
+Base.@kwdef struct Geodesic{T} <: Manifold
+    semimajor_axis::T = 6378137.0
+    inv_flattening::T = 298.257223563
+end

TraitTarget

This struct holds a trait parameter or a union of trait parameters. It's essentially a way to construct unions.

julia
"""
+    TraitTarget{T}
+
+This struct holds a trait parameter or a union of trait parameters.
+
+It is primarily used for dispatch into methods which select trait levels,
+like \`apply\`, or as a parameter to \`target\`.
+
+# Constructors
+\`\`\`julia
+TraitTarget(GI.PointTrait())
+TraitTarget(GI.LineStringTrait(), GI.LinearRingTrait()) # and other traits as you may like
+TraitTarget(TraitTarget(...))

There are also type based constructors available, but that's not advised.

julia
TraitTarget(GI.PointTrait)
+TraitTarget(Union{GI.LineStringTrait, GI.LinearRingTrait})

etc.

julia
\`\`\`
+
+"""
+struct TraitTarget{T} end
+TraitTarget(::Type{T}) where T = TraitTarget{T}()
+TraitTarget(::T) where T<:GI.AbstractTrait = TraitTarget{T}()
+TraitTarget(::TraitTarget{T}) where T = TraitTarget{T}()
+TraitTarget(::Type{<:TraitTarget{T}}) where T = TraitTarget{T}()
+TraitTarget(traits::GI.AbstractTrait...) = TraitTarget{Union{map(typeof, traits)...}}()
+
+
+Base.in(::Trait, ::TraitTarget{Target}) where {Trait <: GI.AbstractTrait, Target} = Trait <: Target

BoolsAsTypes

In apply and applyreduce, we pass threading and calc_extent as types, not simple boolean values.

This is to help compilation - with a type to hold on to, it's easier for the compiler to separate threaded and non-threaded code paths.

Note that if we didn't include the parent abstract type, this would have been really type unstable, since the compiler couldn't tell what would be returned!

We had to add the type annotation on the _booltype(::Bool) method for this reason as well.

TODO: should we switch to Static.jl?

julia
"""
+    abstract type BoolsAsTypes
+
+"""
+abstract type BoolsAsTypes end
+
+"""
+    struct _True <: BoolsAsTypes
+
+A struct that means \`true\`.
+"""
+struct _True <: BoolsAsTypes end
+
+"""
+    struct _False <: BoolsAsTypes
+
+A struct that means \`false\`.
+"""
+struct _False <: BoolsAsTypes end
+
+"""
+    _booltype(x)
+
+Returns a \`BoolsAsTypes\` from \`x\`, whether it's a boolean or a BoolsAsTypes.
+"""
+function _booltype end
+
+@inline _booltype(x::Bool)::BoolsAsTypes = x ? _True() : _False()
+@inline _booltype(x::BoolsAsTypes)::BoolsAsTypes = x

This page was generated using Literate.jl.

`,24)]))}const F=a(t,[["render",l]]);export{c as __pageData,F as default}; diff --git a/previews/PR237/assets/source_src_types.md.DBsi_VC7.lean.js b/previews/PR237/assets/source_src_types.md.DBsi_VC7.lean.js new file mode 100644 index 000000000..3f59f6c3d --- /dev/null +++ b/previews/PR237/assets/source_src_types.md.DBsi_VC7.lean.js @@ -0,0 +1,111 @@ +import{_ as a,c as i,a5 as n,o as e}from"./chunks/framework.Cq8AuEls.js";const c=JSON.parse('{"title":"Types","description":"","frontmatter":{},"headers":[],"relativePath":"source/src/types.md","filePath":"source/src/types.md","lastUpdated":null}'),t={name:"source/src/types.md"};function l(p,s,h,k,r,o){return e(),i("div",null,s[0]||(s[0]=[n(`

Types

This defines core types that the GeometryOps ecosystem uses, and that are usable in more than just GeometryOps.

Manifold

A manifold is mathematically defined as a topological space that resembles Euclidean space locally.

In GeometryOps (and geodesy more generally), there are three manifolds we care about:

  • Planar: the 2d plane, a completely Euclidean manifold

  • Spherical: the unit sphere, but one where areas are multiplied by the radius of the Earth. This is not Euclidean globally, but all map projections attempt to represent the sphere on the Euclidean 2D plane to varying degrees of success.

  • Geodesic: the ellipsoid, the closest we can come to representing the Earth by a simple geometric shape. Parametrized by semimajor_axis and inv_flattening.

Generally, we aim to have Linear and Spherical be operable everywhere, whereas Geodesic will only apply in specific circumstances. Currently, those circumstances are area and segmentize, but this could be extended with time and https://github.com/JuliaGeo/SphericalGeodesics.jl.

julia
export Planar, Spherical, Geodesic
+export TraitTarget
+export BoolsAsTypes, _True, _False, _booltype
+
+"""
+    abstract type Manifold
+
+A manifold is mathematically defined as a topological space that resembles Euclidean space locally.
+
+We use the manifold definition to define the space in which an operation should be performed, or where a geometry lies.
+
+Currently we have \`Planar\`, \`Spherical\`, and \`Geodesic\` manifolds.
+"""
+abstract type Manifold end
+
+"""
+    Planar()
+
+A planar manifold refers to the 2D Euclidean plane.
+
+Z coordinates may be accepted but will not influence geometry calculations, which
+are done purely on 2D geometry.  This is the standard "2.5D" model used by e.g. GEOS.
+"""
+struct Planar <: Manifold
+end
+
+"""
+    Spherical(; radius)
+
+A spherical manifold means that the geometry is on the 3-sphere (but is represented by 2-D longitude and latitude).
+
+By default, the radius is defined as the mean radius of the Earth, \`6371008.8 m\`.
+
+# Extended help
+
+!!! note
+    The traditional definition of spherical coordinates in physics and mathematics,
+    \`\`r, \\\\theta, \\\\phi\`\`, uses the _colatitude_, that measures angular displacement from the \`z\`-axis.
+
+    Here, we use the geographic definition of longitude and latitude, meaning
+    that \`lon\` is longitude between -180 and 180, and \`lat\` is latitude between
+    \`-90\` (south pole) and \`90\` (north pole).
+"""
+Base.@kwdef struct Spherical{T} <: Manifold
+    radius::T = 6371008.8
+end
+
+"""
+    Geodesic(; semimajor_axis, inv_flattening)
+
+A geodesic manifold means that the geometry is on a 3-dimensional ellipsoid, parameterized by \`semimajor_axis\` (\`\`a\`\` in mathematical parlance)
+and \`inv_flattening\` (\`\`1/f\`\`).
+
+Usually, this is only relevant for area and segmentization calculations.  It becomes more relevant as one grows closer to the poles (or equator).
+"""
+Base.@kwdef struct Geodesic{T} <: Manifold
+    semimajor_axis::T = 6378137.0
+    inv_flattening::T = 298.257223563
+end

TraitTarget

This struct holds a trait parameter or a union of trait parameters. It's essentially a way to construct unions.

julia
"""
+    TraitTarget{T}
+
+This struct holds a trait parameter or a union of trait parameters.
+
+It is primarily used for dispatch into methods which select trait levels,
+like \`apply\`, or as a parameter to \`target\`.
+
+# Constructors
+\`\`\`julia
+TraitTarget(GI.PointTrait())
+TraitTarget(GI.LineStringTrait(), GI.LinearRingTrait()) # and other traits as you may like
+TraitTarget(TraitTarget(...))

There are also type based constructors available, but that's not advised.

julia
TraitTarget(GI.PointTrait)
+TraitTarget(Union{GI.LineStringTrait, GI.LinearRingTrait})

etc.

julia
\`\`\`
+
+"""
+struct TraitTarget{T} end
+TraitTarget(::Type{T}) where T = TraitTarget{T}()
+TraitTarget(::T) where T<:GI.AbstractTrait = TraitTarget{T}()
+TraitTarget(::TraitTarget{T}) where T = TraitTarget{T}()
+TraitTarget(::Type{<:TraitTarget{T}}) where T = TraitTarget{T}()
+TraitTarget(traits::GI.AbstractTrait...) = TraitTarget{Union{map(typeof, traits)...}}()
+
+
+Base.in(::Trait, ::TraitTarget{Target}) where {Trait <: GI.AbstractTrait, Target} = Trait <: Target

BoolsAsTypes

In apply and applyreduce, we pass threading and calc_extent as types, not simple boolean values.

This is to help compilation - with a type to hold on to, it's easier for the compiler to separate threaded and non-threaded code paths.

Note that if we didn't include the parent abstract type, this would have been really type unstable, since the compiler couldn't tell what would be returned!

We had to add the type annotation on the _booltype(::Bool) method for this reason as well.

TODO: should we switch to Static.jl?

julia
"""
+    abstract type BoolsAsTypes
+
+"""
+abstract type BoolsAsTypes end
+
+"""
+    struct _True <: BoolsAsTypes
+
+A struct that means \`true\`.
+"""
+struct _True <: BoolsAsTypes end
+
+"""
+    struct _False <: BoolsAsTypes
+
+A struct that means \`false\`.
+"""
+struct _False <: BoolsAsTypes end
+
+"""
+    _booltype(x)
+
+Returns a \`BoolsAsTypes\` from \`x\`, whether it's a boolean or a BoolsAsTypes.
+"""
+function _booltype end
+
+@inline _booltype(x::Bool)::BoolsAsTypes = x ? _True() : _False()
+@inline _booltype(x::BoolsAsTypes)::BoolsAsTypes = x

This page was generated using Literate.jl.

`,24)]))}const F=a(t,[["render",l]]);export{c as __pageData,F as default}; diff --git a/previews/PR237/assets/source_transformations_correction_closed_ring.md.uikVr-1e.js b/previews/PR237/assets/source_transformations_correction_closed_ring.md.uikVr-1e.js new file mode 100644 index 000000000..97cb53224 --- /dev/null +++ b/previews/PR237/assets/source_transformations_correction_closed_ring.md.uikVr-1e.js @@ -0,0 +1,30 @@ +import{_ as l,c as a,a5 as n,j as i,a as t,o as e}from"./chunks/framework.Cq8AuEls.js";const m=JSON.parse('{"title":"Closed Rings","description":"","frontmatter":{},"headers":[],"relativePath":"source/transformations/correction/closed_ring.md","filePath":"source/transformations/correction/closed_ring.md","lastUpdated":null}'),h={name:"source/transformations/correction/closed_ring.md"},p={class:"MathJax",jax:"SVG",style:{direction:"ltr",position:"relative"}},k={style:{overflow:"visible","min-height":"1px","min-width":"1px","vertical-align":"-0.025ex"},xmlns:"http://www.w3.org/2000/svg",width:"1.357ex",height:"1.025ex",role:"img",focusable:"false",viewBox:"0 -442 600 453","aria-hidden":"true"},r={class:"MathJax",jax:"SVG",style:{direction:"ltr",position:"relative"}},o={style:{overflow:"visible","min-height":"1px","min-width":"1px","vertical-align":"-0.186ex"},xmlns:"http://www.w3.org/2000/svg",width:"5.254ex",height:"1.692ex",role:"img",focusable:"false",viewBox:"0 -666 2322.4 748","aria-hidden":"true"};function d(g,s,c,E,y,u){return e(),a("div",null,[s[7]||(s[7]=n(`

Closed Rings

julia
export ClosedRing

A closed ring is a ring that has the same start and end point. This is a requirement for a valid polygon (technically, for a valid LinearRing). This correction is used to ensure that the polygon is valid.

The reason this operates on the polygon level is that several packages are loose about whether they return LinearRings (which is correct) or LineStrings (which is incorrect) for the contents of a polygon. Therefore, we decompose manually to ensure correctness.

Example

Many polygon providers do not close their polygons, which makes them invalid according to the specification. Quite a few geometry algorithms assume that polygons are closed, and leaving them open can lead to incorrect results!

For example, the following polygon is not valid:

julia
import GeoInterface as GI
+polygon = GI.Polygon([[(0, 0), (1, 0), (1, 1), (0, 1)]])
GeoInterface.Wrappers.Polygon{false, false, Vector{GeoInterface.Wrappers.LinearRing{false, false, Vector{Tuple{Int64, Int64}}, Nothing, Nothing}}, Nothing, Nothing}(GeoInterface.Wrappers.LinearRing{false, false, Vector{Tuple{Int64, Int64}}, Nothing, Nothing}[GeoInterface.Wrappers.LinearRing{false, false, Vector{Tuple{Int64, Int64}}, Nothing, Nothing}([(0, 0), (1, 0), (1, 1), (0, 1)], nothing, nothing)], nothing, nothing)

even though it will look correct when visualized, and indeed appears correct.

julia
import GeometryOps as GO
+GO.fix(polygon, corrections = [GO.ClosedRing()])
GeoInterface.Wrappers.Polygon{false, false, Vector{GeoInterface.Wrappers.LinearRing{false, false, Vector{Tuple{Float64, Float64}}, Nothing, Nothing}}, Nothing, Nothing}(GeoInterface.Wrappers.LinearRing{false, false, Vector{Tuple{Float64, Float64}}, Nothing, Nothing}[GeoInterface.Wrappers.LinearRing{false, false, Vector{Tuple{Float64, Float64}}, Nothing, Nothing}([(0.0, 0.0), (1.0, 0.0), (1.0, 1.0), (0.0, 1.0), (0.0, 0.0)], nothing, nothing)], nothing, nothing)
`,12)),i("p",null,[s[4]||(s[4]=t("You can see that the last point of the ring here is equal to the first point. For a polygon with ")),i("mjx-container",p,[(e(),a("svg",k,s[0]||(s[0]=[i("g",{stroke:"currentColor",fill:"currentColor","stroke-width":"0",transform:"scale(1,-1)"},[i("g",{"data-mml-node":"math"},[i("g",{"data-mml-node":"mi"},[i("path",{"data-c":"1D45B",d:"M21 287Q22 293 24 303T36 341T56 388T89 425T135 442Q171 442 195 424T225 390T231 369Q231 367 232 367L243 378Q304 442 382 442Q436 442 469 415T503 336T465 179T427 52Q427 26 444 26Q450 26 453 27Q482 32 505 65T540 145Q542 153 560 153Q580 153 580 145Q580 144 576 130Q568 101 554 73T508 17T439 -10Q392 -10 371 17T350 73Q350 92 386 193T423 345Q423 404 379 404H374Q288 404 229 303L222 291L189 157Q156 26 151 16Q138 -11 108 -11Q95 -11 87 -5T76 7T74 17Q74 30 112 180T152 343Q153 348 153 366Q153 405 129 405Q91 405 66 305Q60 285 60 284Q58 278 41 278H27Q21 284 21 287Z",style:{"stroke-width":"3"}})])])],-1)]))),s[1]||(s[1]=i("mjx-assistive-mml",{unselectable:"on",display:"inline",style:{top:"0px",left:"0px",clip:"rect(1px, 1px, 1px, 1px)","-webkit-touch-callout":"none","-webkit-user-select":"none","-khtml-user-select":"none","-moz-user-select":"none","-ms-user-select":"none","user-select":"none",position:"absolute",padding:"1px 0px 0px 0px",border:"0px",display:"block",width:"auto",overflow:"hidden"}},[i("math",{xmlns:"http://www.w3.org/1998/Math/MathML"},[i("mi",null,"n")])],-1))]),s[5]||(s[5]=t(" sides, there should be ")),i("mjx-container",r,[(e(),a("svg",o,s[2]||(s[2]=[n('',1)]))),s[3]||(s[3]=i("mjx-assistive-mml",{unselectable:"on",display:"inline",style:{top:"0px",left:"0px",clip:"rect(1px, 1px, 1px, 1px)","-webkit-touch-callout":"none","-webkit-user-select":"none","-khtml-user-select":"none","-moz-user-select":"none","-ms-user-select":"none","user-select":"none",position:"absolute",padding:"1px 0px 0px 0px",border:"0px",display:"block",width:"auto",overflow:"hidden"}},[i("math",{xmlns:"http://www.w3.org/1998/Math/MathML"},[i("mi",null,"n"),i("mo",null,"+"),i("mn",null,"1")])],-1))]),s[6]||(s[6]=t(" vertices."))]),s[8]||(s[8]=n(`

Implementation

julia
"""
+    ClosedRing() <: GeometryCorrection
+
+This correction ensures that a polygon's exterior and interior rings are closed.
+
+It can be called on any geometry correction as usual.
+
+See also \`GeometryCorrection\`.
+"""
+struct ClosedRing <: GeometryCorrection end
+
+application_level(::ClosedRing) = GI.PolygonTrait
+
+function (::ClosedRing)(::GI.PolygonTrait, polygon)
+    exterior = _close_linear_ring(GI.getexterior(polygon))
+
+    holes = map(GI.gethole(polygon)) do hole
+        _close_linear_ring(hole) # TODO: make this more efficient, or use tuples!
+    end
+
+    return GI.Wrappers.Polygon([exterior, holes...])
+end
+
+function _close_linear_ring(ring)
+    if GI.getpoint(ring, 1) == GI.getpoint(ring, GI.npoint(ring))

the ring is closed, all hail the ring

julia
        return ring
+    else

Assemble the ring as a vector

julia
        tups = tuples.(GI.getpoint(ring))

Close the ring

julia
        push!(tups, tups[1])

Return an actual ring

julia
        return GI.LinearRing(tups)
+    end
+end

This page was generated using Literate.jl.

`,12))])}const C=l(h,[["render",d]]);export{m as __pageData,C as default}; diff --git a/previews/PR237/assets/source_transformations_correction_closed_ring.md.uikVr-1e.lean.js b/previews/PR237/assets/source_transformations_correction_closed_ring.md.uikVr-1e.lean.js new file mode 100644 index 000000000..97cb53224 --- /dev/null +++ b/previews/PR237/assets/source_transformations_correction_closed_ring.md.uikVr-1e.lean.js @@ -0,0 +1,30 @@ +import{_ as l,c as a,a5 as n,j as i,a as t,o as e}from"./chunks/framework.Cq8AuEls.js";const m=JSON.parse('{"title":"Closed Rings","description":"","frontmatter":{},"headers":[],"relativePath":"source/transformations/correction/closed_ring.md","filePath":"source/transformations/correction/closed_ring.md","lastUpdated":null}'),h={name:"source/transformations/correction/closed_ring.md"},p={class:"MathJax",jax:"SVG",style:{direction:"ltr",position:"relative"}},k={style:{overflow:"visible","min-height":"1px","min-width":"1px","vertical-align":"-0.025ex"},xmlns:"http://www.w3.org/2000/svg",width:"1.357ex",height:"1.025ex",role:"img",focusable:"false",viewBox:"0 -442 600 453","aria-hidden":"true"},r={class:"MathJax",jax:"SVG",style:{direction:"ltr",position:"relative"}},o={style:{overflow:"visible","min-height":"1px","min-width":"1px","vertical-align":"-0.186ex"},xmlns:"http://www.w3.org/2000/svg",width:"5.254ex",height:"1.692ex",role:"img",focusable:"false",viewBox:"0 -666 2322.4 748","aria-hidden":"true"};function d(g,s,c,E,y,u){return e(),a("div",null,[s[7]||(s[7]=n(`

Closed Rings

julia
export ClosedRing

A closed ring is a ring that has the same start and end point. This is a requirement for a valid polygon (technically, for a valid LinearRing). This correction is used to ensure that the polygon is valid.

The reason this operates on the polygon level is that several packages are loose about whether they return LinearRings (which is correct) or LineStrings (which is incorrect) for the contents of a polygon. Therefore, we decompose manually to ensure correctness.

Example

Many polygon providers do not close their polygons, which makes them invalid according to the specification. Quite a few geometry algorithms assume that polygons are closed, and leaving them open can lead to incorrect results!

For example, the following polygon is not valid:

julia
import GeoInterface as GI
+polygon = GI.Polygon([[(0, 0), (1, 0), (1, 1), (0, 1)]])
GeoInterface.Wrappers.Polygon{false, false, Vector{GeoInterface.Wrappers.LinearRing{false, false, Vector{Tuple{Int64, Int64}}, Nothing, Nothing}}, Nothing, Nothing}(GeoInterface.Wrappers.LinearRing{false, false, Vector{Tuple{Int64, Int64}}, Nothing, Nothing}[GeoInterface.Wrappers.LinearRing{false, false, Vector{Tuple{Int64, Int64}}, Nothing, Nothing}([(0, 0), (1, 0), (1, 1), (0, 1)], nothing, nothing)], nothing, nothing)

even though it will look correct when visualized, and indeed appears correct.

julia
import GeometryOps as GO
+GO.fix(polygon, corrections = [GO.ClosedRing()])
GeoInterface.Wrappers.Polygon{false, false, Vector{GeoInterface.Wrappers.LinearRing{false, false, Vector{Tuple{Float64, Float64}}, Nothing, Nothing}}, Nothing, Nothing}(GeoInterface.Wrappers.LinearRing{false, false, Vector{Tuple{Float64, Float64}}, Nothing, Nothing}[GeoInterface.Wrappers.LinearRing{false, false, Vector{Tuple{Float64, Float64}}, Nothing, Nothing}([(0.0, 0.0), (1.0, 0.0), (1.0, 1.0), (0.0, 1.0), (0.0, 0.0)], nothing, nothing)], nothing, nothing)
`,12)),i("p",null,[s[4]||(s[4]=t("You can see that the last point of the ring here is equal to the first point. For a polygon with ")),i("mjx-container",p,[(e(),a("svg",k,s[0]||(s[0]=[i("g",{stroke:"currentColor",fill:"currentColor","stroke-width":"0",transform:"scale(1,-1)"},[i("g",{"data-mml-node":"math"},[i("g",{"data-mml-node":"mi"},[i("path",{"data-c":"1D45B",d:"M21 287Q22 293 24 303T36 341T56 388T89 425T135 442Q171 442 195 424T225 390T231 369Q231 367 232 367L243 378Q304 442 382 442Q436 442 469 415T503 336T465 179T427 52Q427 26 444 26Q450 26 453 27Q482 32 505 65T540 145Q542 153 560 153Q580 153 580 145Q580 144 576 130Q568 101 554 73T508 17T439 -10Q392 -10 371 17T350 73Q350 92 386 193T423 345Q423 404 379 404H374Q288 404 229 303L222 291L189 157Q156 26 151 16Q138 -11 108 -11Q95 -11 87 -5T76 7T74 17Q74 30 112 180T152 343Q153 348 153 366Q153 405 129 405Q91 405 66 305Q60 285 60 284Q58 278 41 278H27Q21 284 21 287Z",style:{"stroke-width":"3"}})])])],-1)]))),s[1]||(s[1]=i("mjx-assistive-mml",{unselectable:"on",display:"inline",style:{top:"0px",left:"0px",clip:"rect(1px, 1px, 1px, 1px)","-webkit-touch-callout":"none","-webkit-user-select":"none","-khtml-user-select":"none","-moz-user-select":"none","-ms-user-select":"none","user-select":"none",position:"absolute",padding:"1px 0px 0px 0px",border:"0px",display:"block",width:"auto",overflow:"hidden"}},[i("math",{xmlns:"http://www.w3.org/1998/Math/MathML"},[i("mi",null,"n")])],-1))]),s[5]||(s[5]=t(" sides, there should be ")),i("mjx-container",r,[(e(),a("svg",o,s[2]||(s[2]=[n('',1)]))),s[3]||(s[3]=i("mjx-assistive-mml",{unselectable:"on",display:"inline",style:{top:"0px",left:"0px",clip:"rect(1px, 1px, 1px, 1px)","-webkit-touch-callout":"none","-webkit-user-select":"none","-khtml-user-select":"none","-moz-user-select":"none","-ms-user-select":"none","user-select":"none",position:"absolute",padding:"1px 0px 0px 0px",border:"0px",display:"block",width:"auto",overflow:"hidden"}},[i("math",{xmlns:"http://www.w3.org/1998/Math/MathML"},[i("mi",null,"n"),i("mo",null,"+"),i("mn",null,"1")])],-1))]),s[6]||(s[6]=t(" vertices."))]),s[8]||(s[8]=n(`

Implementation

julia
"""
+    ClosedRing() <: GeometryCorrection
+
+This correction ensures that a polygon's exterior and interior rings are closed.
+
+It can be called on any geometry correction as usual.
+
+See also \`GeometryCorrection\`.
+"""
+struct ClosedRing <: GeometryCorrection end
+
+application_level(::ClosedRing) = GI.PolygonTrait
+
+function (::ClosedRing)(::GI.PolygonTrait, polygon)
+    exterior = _close_linear_ring(GI.getexterior(polygon))
+
+    holes = map(GI.gethole(polygon)) do hole
+        _close_linear_ring(hole) # TODO: make this more efficient, or use tuples!
+    end
+
+    return GI.Wrappers.Polygon([exterior, holes...])
+end
+
+function _close_linear_ring(ring)
+    if GI.getpoint(ring, 1) == GI.getpoint(ring, GI.npoint(ring))

the ring is closed, all hail the ring

julia
        return ring
+    else

Assemble the ring as a vector

julia
        tups = tuples.(GI.getpoint(ring))

Close the ring

julia
        push!(tups, tups[1])

Return an actual ring

julia
        return GI.LinearRing(tups)
+    end
+end

This page was generated using Literate.jl.

`,12))])}const C=l(h,[["render",d]]);export{m as __pageData,C as default}; diff --git a/previews/PR237/assets/source_transformations_correction_geometry_correction.md.C2ysKw1R.js b/previews/PR237/assets/source_transformations_correction_geometry_correction.md.C2ysKw1R.js new file mode 100644 index 000000000..b25ea8fa3 --- /dev/null +++ b/previews/PR237/assets/source_transformations_correction_geometry_correction.md.C2ysKw1R.js @@ -0,0 +1,31 @@ +import{_ as r,c as o,a5 as e,j as i,a as t,G as n,B as l,o as p}from"./chunks/framework.Cq8AuEls.js";const G=JSON.parse('{"title":"Geometry Corrections","description":"","frontmatter":{},"headers":[],"relativePath":"source/transformations/correction/geometry_correction.md","filePath":"source/transformations/correction/geometry_correction.md","lastUpdated":null}'),h={name:"source/transformations/correction/geometry_correction.md"},c={class:"jldocstring custom-block",open:""},k={class:"jldocstring custom-block",open:""},d={class:"jldocstring custom-block",open:""},y={class:"jldocstring custom-block",open:""},g={class:"jldocstring custom-block",open:""};function m(E,s,u,F,C,f){const a=l("Badge");return p(),o("div",null,[s[15]||(s[15]=e('

Geometry Corrections

julia
export fix

This file simply defines the GeometryCorrection abstract type, and the interface that any GeometryCorrection must implement.

A geometry correction is a transformation that is applied to a geometry to correct it in some way.

For example, a ClosedRing correction might be applied to a Polygon to ensure that its exterior ring is closed.

Interface

All GeometryCorrections are callable structs which, when called, apply the correction to the given geometry, and return either a copy or the original geometry (if nothing needed to be corrected).

See below for the full interface specification.

',8)),i("details",c,[i("summary",null,[s[0]||(s[0]=i("a",{id:"GeometryOps.GeometryCorrection-source-transformations-correction-geometry_correction",href:"#GeometryOps.GeometryCorrection-source-transformations-correction-geometry_correction"},[i("span",{class:"jlbinding"},"GeometryOps.GeometryCorrection")],-1)),s[1]||(s[1]=t()),n(a,{type:"info",class:"jlObjectType jlType",text:"Type"})]),s[2]||(s[2]=e('
julia
abstract type GeometryCorrection

This abstract type represents a geometry correction.

Interface

Any GeometryCorrection must implement two functions: * application_level(::GeometryCorrection)::AbstractGeometryTrait: This function should return the GeoInterface trait that the correction is intended to be applied to, like PointTrait or LineStringTrait or PolygonTrait. * (::GeometryCorrection)(::AbstractGeometryTrait, geometry)::(some_geometry): This function should apply the correction to the given geometry, and return a new geometry.

source

',5))]),s[16]||(s[16]=e(`

Any geometry correction must implement the interface as given above.

julia
"""
+    abstract type GeometryCorrection
+
+This abstract type represents a geometry correction.
+
+# Interface
+
+Any \`GeometryCorrection\` must implement two functions:
+    * \`application_level(::GeometryCorrection)::AbstractGeometryTrait\`: This function should return the \`GeoInterface\` trait that the correction is intended to be applied to, like \`PointTrait\` or \`LineStringTrait\` or \`PolygonTrait\`.
+    * \`(::GeometryCorrection)(::AbstractGeometryTrait, geometry)::(some_geometry)\`: This function should apply the correction to the given geometry, and return a new geometry.
+"""
+abstract type GeometryCorrection end
+
+application_level(gc::GeometryCorrection) = error("Not implemented yet for $(gc)")
+
+(gc::GeometryCorrection)(geometry) = gc(GI.trait(geometry), geometry)
+
+(gc::GeometryCorrection)(trait::GI.AbstractGeometryTrait, geometry) = error("Not implemented yet for $(gc) and $(trait).")
+
+function fix(geometry; corrections = GeometryCorrection[ClosedRing(),], kwargs...)
+    traits = application_level.(corrections)
+    final_geometry = geometry
+    for Trait in (GI.PointTrait, GI.MultiPointTrait, GI.LineStringTrait, GI.LinearRingTrait, GI.MultiLineStringTrait, GI.PolygonTrait, GI.MultiPolygonTrait)
+        available_corrections = findall(x -> x == Trait, traits)
+        isempty(available_corrections) && continue
+        @debug "Correcting for $(Trait)"
+        net_function = reduce(, corrections[available_corrections])
+        final_geometry = apply(net_function, Trait, final_geometry; kwargs...)
+    end
+    return final_geometry
+end

Available corrections

`,3)),i("details",k,[i("summary",null,[s[3]||(s[3]=i("a",{id:"GeometryOps.ClosedRing-source-transformations-correction-geometry_correction",href:"#GeometryOps.ClosedRing-source-transformations-correction-geometry_correction"},[i("span",{class:"jlbinding"},"GeometryOps.ClosedRing")],-1)),s[4]||(s[4]=t()),n(a,{type:"info",class:"jlObjectType jlType",text:"Type"})]),s[5]||(s[5]=e('
julia
ClosedRing() <: GeometryCorrection

This correction ensures that a polygon's exterior and interior rings are closed.

It can be called on any geometry correction as usual.

See also GeometryCorrection.

source

',5))]),i("details",d,[i("summary",null,[s[6]||(s[6]=i("a",{id:"GeometryOps.DiffIntersectingPolygons-source-transformations-correction-geometry_correction",href:"#GeometryOps.DiffIntersectingPolygons-source-transformations-correction-geometry_correction"},[i("span",{class:"jlbinding"},"GeometryOps.DiffIntersectingPolygons")],-1)),s[7]||(s[7]=t()),n(a,{type:"info",class:"jlObjectType jlType",text:"Type"})]),s[8]||(s[8]=e('
julia
DiffIntersectingPolygons() <: GeometryCorrection

This correction ensures that the polygons included in a multipolygon aren't intersecting. If any polygon's are intersecting, they will be made nonintersecting through the difference operation to create a unique set of disjoint (other than potentially connections by a single point) polygons covering the same area. See also GeometryCorrection, UnionIntersectingPolygons.

source

',3))]),i("details",y,[i("summary",null,[s[9]||(s[9]=i("a",{id:"GeometryOps.GeometryCorrection-source-transformations-correction-geometry_correction-2",href:"#GeometryOps.GeometryCorrection-source-transformations-correction-geometry_correction-2"},[i("span",{class:"jlbinding"},"GeometryOps.GeometryCorrection")],-1)),s[10]||(s[10]=t()),n(a,{type:"info",class:"jlObjectType jlType",text:"Type"})]),s[11]||(s[11]=e('
julia
abstract type GeometryCorrection

This abstract type represents a geometry correction.

Interface

Any GeometryCorrection must implement two functions: * application_level(::GeometryCorrection)::AbstractGeometryTrait: This function should return the GeoInterface trait that the correction is intended to be applied to, like PointTrait or LineStringTrait or PolygonTrait. * (::GeometryCorrection)(::AbstractGeometryTrait, geometry)::(some_geometry): This function should apply the correction to the given geometry, and return a new geometry.

source

',5))]),i("details",g,[i("summary",null,[s[12]||(s[12]=i("a",{id:"GeometryOps.UnionIntersectingPolygons-source-transformations-correction-geometry_correction",href:"#GeometryOps.UnionIntersectingPolygons-source-transformations-correction-geometry_correction"},[i("span",{class:"jlbinding"},"GeometryOps.UnionIntersectingPolygons")],-1)),s[13]||(s[13]=t()),n(a,{type:"info",class:"jlObjectType jlType",text:"Type"})]),s[14]||(s[14]=e('
julia
UnionIntersectingPolygons() <: GeometryCorrection

This correction ensures that the polygon's included in a multipolygon aren't intersecting. If any polygon's are intersecting, they will be combined through the union operation to create a unique set of disjoint (other than potentially connections by a single point) polygons covering the same area.

See also GeometryCorrection.

source

',4))]),s[17]||(s[17]=i("hr",null,null,-1)),s[18]||(s[18]=i("p",null,[i("em",null,[t("This page was generated using "),i("a",{href:"https://github.com/fredrikekre/Literate.jl",target:"_blank",rel:"noreferrer"},"Literate.jl"),t(".")])],-1))])}const A=r(h,[["render",m]]);export{G as __pageData,A as default}; diff --git a/previews/PR237/assets/source_transformations_correction_geometry_correction.md.C2ysKw1R.lean.js b/previews/PR237/assets/source_transformations_correction_geometry_correction.md.C2ysKw1R.lean.js new file mode 100644 index 000000000..b25ea8fa3 --- /dev/null +++ b/previews/PR237/assets/source_transformations_correction_geometry_correction.md.C2ysKw1R.lean.js @@ -0,0 +1,31 @@ +import{_ as r,c as o,a5 as e,j as i,a as t,G as n,B as l,o as p}from"./chunks/framework.Cq8AuEls.js";const G=JSON.parse('{"title":"Geometry Corrections","description":"","frontmatter":{},"headers":[],"relativePath":"source/transformations/correction/geometry_correction.md","filePath":"source/transformations/correction/geometry_correction.md","lastUpdated":null}'),h={name:"source/transformations/correction/geometry_correction.md"},c={class:"jldocstring custom-block",open:""},k={class:"jldocstring custom-block",open:""},d={class:"jldocstring custom-block",open:""},y={class:"jldocstring custom-block",open:""},g={class:"jldocstring custom-block",open:""};function m(E,s,u,F,C,f){const a=l("Badge");return p(),o("div",null,[s[15]||(s[15]=e('

Geometry Corrections

julia
export fix

This file simply defines the GeometryCorrection abstract type, and the interface that any GeometryCorrection must implement.

A geometry correction is a transformation that is applied to a geometry to correct it in some way.

For example, a ClosedRing correction might be applied to a Polygon to ensure that its exterior ring is closed.

Interface

All GeometryCorrections are callable structs which, when called, apply the correction to the given geometry, and return either a copy or the original geometry (if nothing needed to be corrected).

See below for the full interface specification.

',8)),i("details",c,[i("summary",null,[s[0]||(s[0]=i("a",{id:"GeometryOps.GeometryCorrection-source-transformations-correction-geometry_correction",href:"#GeometryOps.GeometryCorrection-source-transformations-correction-geometry_correction"},[i("span",{class:"jlbinding"},"GeometryOps.GeometryCorrection")],-1)),s[1]||(s[1]=t()),n(a,{type:"info",class:"jlObjectType jlType",text:"Type"})]),s[2]||(s[2]=e('
julia
abstract type GeometryCorrection

This abstract type represents a geometry correction.

Interface

Any GeometryCorrection must implement two functions: * application_level(::GeometryCorrection)::AbstractGeometryTrait: This function should return the GeoInterface trait that the correction is intended to be applied to, like PointTrait or LineStringTrait or PolygonTrait. * (::GeometryCorrection)(::AbstractGeometryTrait, geometry)::(some_geometry): This function should apply the correction to the given geometry, and return a new geometry.

source

',5))]),s[16]||(s[16]=e(`

Any geometry correction must implement the interface as given above.

julia
"""
+    abstract type GeometryCorrection
+
+This abstract type represents a geometry correction.
+
+# Interface
+
+Any \`GeometryCorrection\` must implement two functions:
+    * \`application_level(::GeometryCorrection)::AbstractGeometryTrait\`: This function should return the \`GeoInterface\` trait that the correction is intended to be applied to, like \`PointTrait\` or \`LineStringTrait\` or \`PolygonTrait\`.
+    * \`(::GeometryCorrection)(::AbstractGeometryTrait, geometry)::(some_geometry)\`: This function should apply the correction to the given geometry, and return a new geometry.
+"""
+abstract type GeometryCorrection end
+
+application_level(gc::GeometryCorrection) = error("Not implemented yet for $(gc)")
+
+(gc::GeometryCorrection)(geometry) = gc(GI.trait(geometry), geometry)
+
+(gc::GeometryCorrection)(trait::GI.AbstractGeometryTrait, geometry) = error("Not implemented yet for $(gc) and $(trait).")
+
+function fix(geometry; corrections = GeometryCorrection[ClosedRing(),], kwargs...)
+    traits = application_level.(corrections)
+    final_geometry = geometry
+    for Trait in (GI.PointTrait, GI.MultiPointTrait, GI.LineStringTrait, GI.LinearRingTrait, GI.MultiLineStringTrait, GI.PolygonTrait, GI.MultiPolygonTrait)
+        available_corrections = findall(x -> x == Trait, traits)
+        isempty(available_corrections) && continue
+        @debug "Correcting for $(Trait)"
+        net_function = reduce(, corrections[available_corrections])
+        final_geometry = apply(net_function, Trait, final_geometry; kwargs...)
+    end
+    return final_geometry
+end

Available corrections

`,3)),i("details",k,[i("summary",null,[s[3]||(s[3]=i("a",{id:"GeometryOps.ClosedRing-source-transformations-correction-geometry_correction",href:"#GeometryOps.ClosedRing-source-transformations-correction-geometry_correction"},[i("span",{class:"jlbinding"},"GeometryOps.ClosedRing")],-1)),s[4]||(s[4]=t()),n(a,{type:"info",class:"jlObjectType jlType",text:"Type"})]),s[5]||(s[5]=e('
julia
ClosedRing() <: GeometryCorrection

This correction ensures that a polygon's exterior and interior rings are closed.

It can be called on any geometry correction as usual.

See also GeometryCorrection.

source

',5))]),i("details",d,[i("summary",null,[s[6]||(s[6]=i("a",{id:"GeometryOps.DiffIntersectingPolygons-source-transformations-correction-geometry_correction",href:"#GeometryOps.DiffIntersectingPolygons-source-transformations-correction-geometry_correction"},[i("span",{class:"jlbinding"},"GeometryOps.DiffIntersectingPolygons")],-1)),s[7]||(s[7]=t()),n(a,{type:"info",class:"jlObjectType jlType",text:"Type"})]),s[8]||(s[8]=e('
julia
DiffIntersectingPolygons() <: GeometryCorrection

This correction ensures that the polygons included in a multipolygon aren't intersecting. If any polygon's are intersecting, they will be made nonintersecting through the difference operation to create a unique set of disjoint (other than potentially connections by a single point) polygons covering the same area. See also GeometryCorrection, UnionIntersectingPolygons.

source

',3))]),i("details",y,[i("summary",null,[s[9]||(s[9]=i("a",{id:"GeometryOps.GeometryCorrection-source-transformations-correction-geometry_correction-2",href:"#GeometryOps.GeometryCorrection-source-transformations-correction-geometry_correction-2"},[i("span",{class:"jlbinding"},"GeometryOps.GeometryCorrection")],-1)),s[10]||(s[10]=t()),n(a,{type:"info",class:"jlObjectType jlType",text:"Type"})]),s[11]||(s[11]=e('
julia
abstract type GeometryCorrection

This abstract type represents a geometry correction.

Interface

Any GeometryCorrection must implement two functions: * application_level(::GeometryCorrection)::AbstractGeometryTrait: This function should return the GeoInterface trait that the correction is intended to be applied to, like PointTrait or LineStringTrait or PolygonTrait. * (::GeometryCorrection)(::AbstractGeometryTrait, geometry)::(some_geometry): This function should apply the correction to the given geometry, and return a new geometry.

source

',5))]),i("details",g,[i("summary",null,[s[12]||(s[12]=i("a",{id:"GeometryOps.UnionIntersectingPolygons-source-transformations-correction-geometry_correction",href:"#GeometryOps.UnionIntersectingPolygons-source-transformations-correction-geometry_correction"},[i("span",{class:"jlbinding"},"GeometryOps.UnionIntersectingPolygons")],-1)),s[13]||(s[13]=t()),n(a,{type:"info",class:"jlObjectType jlType",text:"Type"})]),s[14]||(s[14]=e('
julia
UnionIntersectingPolygons() <: GeometryCorrection

This correction ensures that the polygon's included in a multipolygon aren't intersecting. If any polygon's are intersecting, they will be combined through the union operation to create a unique set of disjoint (other than potentially connections by a single point) polygons covering the same area.

See also GeometryCorrection.

source

',4))]),s[17]||(s[17]=i("hr",null,null,-1)),s[18]||(s[18]=i("p",null,[i("em",null,[t("This page was generated using "),i("a",{href:"https://github.com/fredrikekre/Literate.jl",target:"_blank",rel:"noreferrer"},"Literate.jl"),t(".")])],-1))])}const A=r(h,[["render",m]]);export{G as __pageData,A as default}; diff --git a/previews/PR237/assets/source_transformations_correction_intersecting_polygons.md.Cfjz8cbj.js b/previews/PR237/assets/source_transformations_correction_intersecting_polygons.md.Cfjz8cbj.js new file mode 100644 index 000000000..2b8bb5f03 --- /dev/null +++ b/previews/PR237/assets/source_transformations_correction_intersecting_polygons.md.Cfjz8cbj.js @@ -0,0 +1,97 @@ +import{_ as i,c as a,a5 as n,o as l}from"./chunks/framework.Cq8AuEls.js";const E=JSON.parse('{"title":"Intersecting Polygons","description":"","frontmatter":{},"headers":[],"relativePath":"source/transformations/correction/intersecting_polygons.md","filePath":"source/transformations/correction/intersecting_polygons.md","lastUpdated":null}'),t={name:"source/transformations/correction/intersecting_polygons.md"};function h(p,s,e,k,r,g){return l(),a("div",null,s[0]||(s[0]=[n(`

Intersecting Polygons

julia
export UnionIntersectingPolygons

If the sub-polygons of a multipolygon are intersecting, this makes them invalid according to specification. Each sub-polygon of a multipolygon being disjoint (other than by a single point) is a requirement for a valid multipolygon. However, different libraries may achieve this in different ways.

For example, taking the union of all sub-polygons of a multipolygon will create a new multipolygon where each sub-polygon is disjoint. This can be done with the UnionIntersectingPolygons correction.

The reason this operates on a multipolygon level is that it is easy for users to mistakenly create multipolygon's that overlap, which can then be detrimental to polygon clipping performance and even create wrong answers.

Example

Multipolygon providers may not check that the polygons making up their multipolygons do not intersect, which makes them invalid according to the specification.

For example, the following multipolygon is not valid:

julia
import GeoInterface as GI
+polygon = GI.Polygon([[(0.0, 0.0), (3.0, 0.0), (3.0, 3.0), (0.0, 3.0), (0.0, 0.0)]])
+multipolygon = GI.MultiPolygon([polygon, polygon])
GeoInterface.Wrappers.MultiPolygon{false, false, Vector{GeoInterface.Wrappers.Polygon{false, false, Vector{GeoInterface.Wrappers.LinearRing{false, false, Vector{Tuple{Float64, Float64}}, Nothing, Nothing}}, Nothing, Nothing}}, Nothing, Nothing}(GeoInterface.Wrappers.Polygon{false, false, Vector{GeoInterface.Wrappers.LinearRing{false, false, Vector{Tuple{Float64, Float64}}, Nothing, Nothing}}, Nothing, Nothing}[GeoInterface.Wrappers.Polygon{false, false, Vector{GeoInterface.Wrappers.LinearRing{false, false, Vector{Tuple{Float64, Float64}}, Nothing, Nothing}}, Nothing, Nothing}(GeoInterface.Wrappers.LinearRing{false, false, Vector{Tuple{Float64, Float64}}, Nothing, Nothing}[GeoInterface.Wrappers.LinearRing{false, false, Vector{Tuple{Float64, Float64}}, Nothing, Nothing}([(0.0, 0.0), (3.0, 0.0), (3.0, 3.0), (0.0, 3.0), (0.0, 0.0)], nothing, nothing)], nothing, nothing), GeoInterface.Wrappers.Polygon{false, false, Vector{GeoInterface.Wrappers.LinearRing{false, false, Vector{Tuple{Float64, Float64}}, Nothing, Nothing}}, Nothing, Nothing}(GeoInterface.Wrappers.LinearRing{false, false, Vector{Tuple{Float64, Float64}}, Nothing, Nothing}[GeoInterface.Wrappers.LinearRing{false, false, Vector{Tuple{Float64, Float64}}, Nothing, Nothing}([(0.0, 0.0), (3.0, 0.0), (3.0, 3.0), (0.0, 3.0), (0.0, 0.0)], nothing, nothing)], nothing, nothing)], nothing, nothing)

given that the two sub-polygons are the exact same shape.

julia
import GeometryOps as GO
+GO.fix(multipolygon, corrections = [GO.UnionIntersectingPolygons()])
GeoInterface.Wrappers.MultiPolygon{false, false, Vector{GeoInterface.Wrappers.Polygon{false, false, Vector{GeoInterface.Wrappers.LinearRing{false, false, Vector{Tuple{Float64, Float64}}, Nothing, Nothing}}, Nothing, Nothing}}, Nothing, Nothing}(GeoInterface.Wrappers.Polygon{false, false, Vector{GeoInterface.Wrappers.LinearRing{false, false, Vector{Tuple{Float64, Float64}}, Nothing, Nothing}}, Nothing, Nothing}[GeoInterface.Wrappers.Polygon{false, false, Vector{GeoInterface.Wrappers.LinearRing{false, false, Vector{Tuple{Float64, Float64}}, Nothing, Nothing}}, Nothing, Nothing}(GeoInterface.Wrappers.LinearRing{false, false, Vector{Tuple{Float64, Float64}}, Nothing, Nothing}[GeoInterface.Wrappers.LinearRing{false, false, Vector{Tuple{Float64, Float64}}, Nothing, Nothing}([(0.0, 0.0), (3.0, 0.0), (3.0, 3.0), (0.0, 3.0), (0.0, 0.0)], nothing, nothing)], nothing, nothing)], nothing, nothing)

You can see that the the multipolygon now only contains one sub-polygon, rather than the two identical ones provided.

Implementation

julia
"""
+    UnionIntersectingPolygons() <: GeometryCorrection
+
+This correction ensures that the polygon's included in a multipolygon aren't intersecting.
+If any polygon's are intersecting, they will be combined through the union operation to
+create a unique set of disjoint (other than potentially connections by a single point)
+polygons covering the same area.
+
+See also \`GeometryCorrection\`.
+"""
+struct UnionIntersectingPolygons <: GeometryCorrection end
+
+application_level(::UnionIntersectingPolygons) = GI.MultiPolygonTrait
+
+function (::UnionIntersectingPolygons)(::GI.MultiPolygonTrait, multipoly)
+    union_multipoly = tuples(multipoly)
+    n_polys = GI.npolygon(multipoly)
+    if n_polys > 1
+        keep_idx = trues(n_polys)  # keep track of sub-polygons to remove

Combine any sub-polygons that intersect

julia
        for (curr_idx, _) in Iterators.filter(last, Iterators.enumerate(keep_idx))
+            curr_poly = union_multipoly.geom[curr_idx]
+            poly_disjoint = false
+            while !poly_disjoint
+                poly_disjoint = true  # assume current polygon is disjoint from others
+                for (next_idx, _) in Iterators.filter(last, Iterators.drop(Iterators.enumerate(keep_idx), curr_idx))
+                    next_poly = union_multipoly.geom[next_idx]
+                    if intersects(curr_poly, next_poly)  # if two polygons intersect
+                        new_polys = union(curr_poly, next_poly; target = GI.PolygonTrait())
+                        n_new_polys = length(new_polys)
+                        if n_new_polys == 1  # if polygons combined
+                            poly_disjoint = false
+                            union_multipoly.geom[curr_idx] = new_polys[1]
+                            curr_poly = union_multipoly.geom[curr_idx]
+                            keep_idx[next_idx] = false
+                        end
+                    end
+                end
+            end
+        end
+        keepat!(union_multipoly.geom, keep_idx)
+    end
+    return union_multipoly
+end
+
+"""
+    DiffIntersectingPolygons() <: GeometryCorrection
+This correction ensures that the polygons included in a multipolygon aren't intersecting.
+If any polygon's are intersecting, they will be made nonintersecting through the \`difference\`
+operation to create a unique set of disjoint (other than potentially connections by a single point)
+polygons covering the same area.
+See also \`GeometryCorrection\`, \`UnionIntersectingPolygons\`.
+"""
+struct DiffIntersectingPolygons <: GeometryCorrection end
+
+application_level(::DiffIntersectingPolygons) = GI.MultiPolygonTrait
+
+function (::DiffIntersectingPolygons)(::GI.MultiPolygonTrait, multipoly)
+    diff_multipoly = tuples(multipoly)
+    n_starting_polys = GI.npolygon(multipoly)
+    n_polys = n_starting_polys
+    if n_polys > 1
+        keep_idx = trues(n_polys)  # keep track of sub-polygons to remove

Break apart any sub-polygons that intersect

julia
        for curr_idx in 1:n_starting_polys
+            !keep_idx[curr_idx] && continue
+            for next_idx in (curr_idx + 1):n_starting_polys
+                !keep_idx[next_idx] && continue
+                next_poly = diff_multipoly.geom[next_idx]
+                n_new_polys = 0
+                curr_pieces_added = (n_polys + 1):(n_polys + n_new_polys)
+                for curr_piece_idx in Iterators.flatten((curr_idx:curr_idx, curr_pieces_added))
+                    !keep_idx[curr_piece_idx] && continue
+                    curr_poly = diff_multipoly.geom[curr_piece_idx]
+                    if intersects(curr_poly, next_poly)  # if two polygons intersect
+                        new_polys = difference(curr_poly, next_poly; target = GI.PolygonTrait())
+                        n_new_pieces = length(new_polys) - 1
+                        if n_new_pieces < 0  # current polygon is covered by next_polygon
+                            keep_idx[curr_piece_idx] = false
+                            break
+                        elseif n_new_pieces  0
+                            diff_multipoly.geom[curr_piece_idx] = new_polys[1]
+                            curr_poly = diff_multipoly.geom[curr_piece_idx]
+                            if n_new_pieces > 0 # current polygon breaks into several pieces
+                                append!(diff_multipoly.geom, @view new_polys[2:end])
+                                append!(keep_idx, trues(n_new_pieces))
+                                n_new_polys += n_new_pieces
+                            end
+                        end
+                    end
+                end
+                n_polys += n_new_polys
+            end
+        end
+        keepat!(diff_multipoly.geom, keep_idx)
+    end
+    return diff_multipoly
+end

This page was generated using Literate.jl.

`,22)]))}const d=i(t,[["render",h]]);export{E as __pageData,d as default}; diff --git a/previews/PR237/assets/source_transformations_correction_intersecting_polygons.md.Cfjz8cbj.lean.js b/previews/PR237/assets/source_transformations_correction_intersecting_polygons.md.Cfjz8cbj.lean.js new file mode 100644 index 000000000..2b8bb5f03 --- /dev/null +++ b/previews/PR237/assets/source_transformations_correction_intersecting_polygons.md.Cfjz8cbj.lean.js @@ -0,0 +1,97 @@ +import{_ as i,c as a,a5 as n,o as l}from"./chunks/framework.Cq8AuEls.js";const E=JSON.parse('{"title":"Intersecting Polygons","description":"","frontmatter":{},"headers":[],"relativePath":"source/transformations/correction/intersecting_polygons.md","filePath":"source/transformations/correction/intersecting_polygons.md","lastUpdated":null}'),t={name:"source/transformations/correction/intersecting_polygons.md"};function h(p,s,e,k,r,g){return l(),a("div",null,s[0]||(s[0]=[n(`

Intersecting Polygons

julia
export UnionIntersectingPolygons

If the sub-polygons of a multipolygon are intersecting, this makes them invalid according to specification. Each sub-polygon of a multipolygon being disjoint (other than by a single point) is a requirement for a valid multipolygon. However, different libraries may achieve this in different ways.

For example, taking the union of all sub-polygons of a multipolygon will create a new multipolygon where each sub-polygon is disjoint. This can be done with the UnionIntersectingPolygons correction.

The reason this operates on a multipolygon level is that it is easy for users to mistakenly create multipolygon's that overlap, which can then be detrimental to polygon clipping performance and even create wrong answers.

Example

Multipolygon providers may not check that the polygons making up their multipolygons do not intersect, which makes them invalid according to the specification.

For example, the following multipolygon is not valid:

julia
import GeoInterface as GI
+polygon = GI.Polygon([[(0.0, 0.0), (3.0, 0.0), (3.0, 3.0), (0.0, 3.0), (0.0, 0.0)]])
+multipolygon = GI.MultiPolygon([polygon, polygon])
GeoInterface.Wrappers.MultiPolygon{false, false, Vector{GeoInterface.Wrappers.Polygon{false, false, Vector{GeoInterface.Wrappers.LinearRing{false, false, Vector{Tuple{Float64, Float64}}, Nothing, Nothing}}, Nothing, Nothing}}, Nothing, Nothing}(GeoInterface.Wrappers.Polygon{false, false, Vector{GeoInterface.Wrappers.LinearRing{false, false, Vector{Tuple{Float64, Float64}}, Nothing, Nothing}}, Nothing, Nothing}[GeoInterface.Wrappers.Polygon{false, false, Vector{GeoInterface.Wrappers.LinearRing{false, false, Vector{Tuple{Float64, Float64}}, Nothing, Nothing}}, Nothing, Nothing}(GeoInterface.Wrappers.LinearRing{false, false, Vector{Tuple{Float64, Float64}}, Nothing, Nothing}[GeoInterface.Wrappers.LinearRing{false, false, Vector{Tuple{Float64, Float64}}, Nothing, Nothing}([(0.0, 0.0), (3.0, 0.0), (3.0, 3.0), (0.0, 3.0), (0.0, 0.0)], nothing, nothing)], nothing, nothing), GeoInterface.Wrappers.Polygon{false, false, Vector{GeoInterface.Wrappers.LinearRing{false, false, Vector{Tuple{Float64, Float64}}, Nothing, Nothing}}, Nothing, Nothing}(GeoInterface.Wrappers.LinearRing{false, false, Vector{Tuple{Float64, Float64}}, Nothing, Nothing}[GeoInterface.Wrappers.LinearRing{false, false, Vector{Tuple{Float64, Float64}}, Nothing, Nothing}([(0.0, 0.0), (3.0, 0.0), (3.0, 3.0), (0.0, 3.0), (0.0, 0.0)], nothing, nothing)], nothing, nothing)], nothing, nothing)

given that the two sub-polygons are the exact same shape.

julia
import GeometryOps as GO
+GO.fix(multipolygon, corrections = [GO.UnionIntersectingPolygons()])
GeoInterface.Wrappers.MultiPolygon{false, false, Vector{GeoInterface.Wrappers.Polygon{false, false, Vector{GeoInterface.Wrappers.LinearRing{false, false, Vector{Tuple{Float64, Float64}}, Nothing, Nothing}}, Nothing, Nothing}}, Nothing, Nothing}(GeoInterface.Wrappers.Polygon{false, false, Vector{GeoInterface.Wrappers.LinearRing{false, false, Vector{Tuple{Float64, Float64}}, Nothing, Nothing}}, Nothing, Nothing}[GeoInterface.Wrappers.Polygon{false, false, Vector{GeoInterface.Wrappers.LinearRing{false, false, Vector{Tuple{Float64, Float64}}, Nothing, Nothing}}, Nothing, Nothing}(GeoInterface.Wrappers.LinearRing{false, false, Vector{Tuple{Float64, Float64}}, Nothing, Nothing}[GeoInterface.Wrappers.LinearRing{false, false, Vector{Tuple{Float64, Float64}}, Nothing, Nothing}([(0.0, 0.0), (3.0, 0.0), (3.0, 3.0), (0.0, 3.0), (0.0, 0.0)], nothing, nothing)], nothing, nothing)], nothing, nothing)

You can see that the the multipolygon now only contains one sub-polygon, rather than the two identical ones provided.

Implementation

julia
"""
+    UnionIntersectingPolygons() <: GeometryCorrection
+
+This correction ensures that the polygon's included in a multipolygon aren't intersecting.
+If any polygon's are intersecting, they will be combined through the union operation to
+create a unique set of disjoint (other than potentially connections by a single point)
+polygons covering the same area.
+
+See also \`GeometryCorrection\`.
+"""
+struct UnionIntersectingPolygons <: GeometryCorrection end
+
+application_level(::UnionIntersectingPolygons) = GI.MultiPolygonTrait
+
+function (::UnionIntersectingPolygons)(::GI.MultiPolygonTrait, multipoly)
+    union_multipoly = tuples(multipoly)
+    n_polys = GI.npolygon(multipoly)
+    if n_polys > 1
+        keep_idx = trues(n_polys)  # keep track of sub-polygons to remove

Combine any sub-polygons that intersect

julia
        for (curr_idx, _) in Iterators.filter(last, Iterators.enumerate(keep_idx))
+            curr_poly = union_multipoly.geom[curr_idx]
+            poly_disjoint = false
+            while !poly_disjoint
+                poly_disjoint = true  # assume current polygon is disjoint from others
+                for (next_idx, _) in Iterators.filter(last, Iterators.drop(Iterators.enumerate(keep_idx), curr_idx))
+                    next_poly = union_multipoly.geom[next_idx]
+                    if intersects(curr_poly, next_poly)  # if two polygons intersect
+                        new_polys = union(curr_poly, next_poly; target = GI.PolygonTrait())
+                        n_new_polys = length(new_polys)
+                        if n_new_polys == 1  # if polygons combined
+                            poly_disjoint = false
+                            union_multipoly.geom[curr_idx] = new_polys[1]
+                            curr_poly = union_multipoly.geom[curr_idx]
+                            keep_idx[next_idx] = false
+                        end
+                    end
+                end
+            end
+        end
+        keepat!(union_multipoly.geom, keep_idx)
+    end
+    return union_multipoly
+end
+
+"""
+    DiffIntersectingPolygons() <: GeometryCorrection
+This correction ensures that the polygons included in a multipolygon aren't intersecting.
+If any polygon's are intersecting, they will be made nonintersecting through the \`difference\`
+operation to create a unique set of disjoint (other than potentially connections by a single point)
+polygons covering the same area.
+See also \`GeometryCorrection\`, \`UnionIntersectingPolygons\`.
+"""
+struct DiffIntersectingPolygons <: GeometryCorrection end
+
+application_level(::DiffIntersectingPolygons) = GI.MultiPolygonTrait
+
+function (::DiffIntersectingPolygons)(::GI.MultiPolygonTrait, multipoly)
+    diff_multipoly = tuples(multipoly)
+    n_starting_polys = GI.npolygon(multipoly)
+    n_polys = n_starting_polys
+    if n_polys > 1
+        keep_idx = trues(n_polys)  # keep track of sub-polygons to remove

Break apart any sub-polygons that intersect

julia
        for curr_idx in 1:n_starting_polys
+            !keep_idx[curr_idx] && continue
+            for next_idx in (curr_idx + 1):n_starting_polys
+                !keep_idx[next_idx] && continue
+                next_poly = diff_multipoly.geom[next_idx]
+                n_new_polys = 0
+                curr_pieces_added = (n_polys + 1):(n_polys + n_new_polys)
+                for curr_piece_idx in Iterators.flatten((curr_idx:curr_idx, curr_pieces_added))
+                    !keep_idx[curr_piece_idx] && continue
+                    curr_poly = diff_multipoly.geom[curr_piece_idx]
+                    if intersects(curr_poly, next_poly)  # if two polygons intersect
+                        new_polys = difference(curr_poly, next_poly; target = GI.PolygonTrait())
+                        n_new_pieces = length(new_polys) - 1
+                        if n_new_pieces < 0  # current polygon is covered by next_polygon
+                            keep_idx[curr_piece_idx] = false
+                            break
+                        elseif n_new_pieces  0
+                            diff_multipoly.geom[curr_piece_idx] = new_polys[1]
+                            curr_poly = diff_multipoly.geom[curr_piece_idx]
+                            if n_new_pieces > 0 # current polygon breaks into several pieces
+                                append!(diff_multipoly.geom, @view new_polys[2:end])
+                                append!(keep_idx, trues(n_new_pieces))
+                                n_new_polys += n_new_pieces
+                            end
+                        end
+                    end
+                end
+                n_polys += n_new_polys
+            end
+        end
+        keepat!(diff_multipoly.geom, keep_idx)
+    end
+    return diff_multipoly
+end

This page was generated using Literate.jl.

`,22)]))}const d=i(t,[["render",h]]);export{E as __pageData,d as default}; diff --git a/previews/PR237/assets/source_transformations_extent.md.D6fK7i3a.js b/previews/PR237/assets/source_transformations_extent.md.D6fK7i3a.js new file mode 100644 index 000000000..d44af0b7f --- /dev/null +++ b/previews/PR237/assets/source_transformations_extent.md.D6fK7i3a.js @@ -0,0 +1,13 @@ +import{_ as e,c as a,a5 as n,o as t}from"./chunks/framework.Cq8AuEls.js";const k=JSON.parse('{"title":"Extent embedding","description":"","frontmatter":{},"headers":[],"relativePath":"source/transformations/extent.md","filePath":"source/transformations/extent.md","lastUpdated":null}'),i={name:"source/transformations/extent.md"};function l(p,s,r,h,d,o){return t(),a("div",null,s[0]||(s[0]=[n(`

Extent embedding

julia
"""
+    embed_extent(obj)
+
+Recursively wrap the object with a GeoInterface.jl geometry,
+calculating and adding an \`Extents.Extent\` to all objects.
+
+This can improve performance when extents need to be checked multiple times,
+such when needing to check if many points are in geometries, and using their extents
+as a quick filter for obviously exterior points.

Keywords

julia
$THREADED_KEYWORD
+$CRS_KEYWORD
+"""
+embed_extent(x; threaded=false, crs=nothing) =
+    apply(identity, GI.PointTrait(), x; calc_extent=true, threaded, crs)

This page was generated using Literate.jl.

`,6)]))}const g=e(i,[["render",l]]);export{k as __pageData,g as default}; diff --git a/previews/PR237/assets/source_transformations_extent.md.D6fK7i3a.lean.js b/previews/PR237/assets/source_transformations_extent.md.D6fK7i3a.lean.js new file mode 100644 index 000000000..d44af0b7f --- /dev/null +++ b/previews/PR237/assets/source_transformations_extent.md.D6fK7i3a.lean.js @@ -0,0 +1,13 @@ +import{_ as e,c as a,a5 as n,o as t}from"./chunks/framework.Cq8AuEls.js";const k=JSON.parse('{"title":"Extent embedding","description":"","frontmatter":{},"headers":[],"relativePath":"source/transformations/extent.md","filePath":"source/transformations/extent.md","lastUpdated":null}'),i={name:"source/transformations/extent.md"};function l(p,s,r,h,d,o){return t(),a("div",null,s[0]||(s[0]=[n(`

Extent embedding

julia
"""
+    embed_extent(obj)
+
+Recursively wrap the object with a GeoInterface.jl geometry,
+calculating and adding an \`Extents.Extent\` to all objects.
+
+This can improve performance when extents need to be checked multiple times,
+such when needing to check if many points are in geometries, and using their extents
+as a quick filter for obviously exterior points.

Keywords

julia
$THREADED_KEYWORD
+$CRS_KEYWORD
+"""
+embed_extent(x; threaded=false, crs=nothing) =
+    apply(identity, GI.PointTrait(), x; calc_extent=true, threaded, crs)

This page was generated using Literate.jl.

`,6)]))}const g=e(i,[["render",l]]);export{k as __pageData,g as default}; diff --git a/previews/PR237/assets/source_transformations_flip.md.Drqj7zVo.js b/previews/PR237/assets/source_transformations_flip.md.Drqj7zVo.js new file mode 100644 index 000000000..c9d588776 --- /dev/null +++ b/previews/PR237/assets/source_transformations_flip.md.Drqj7zVo.js @@ -0,0 +1,22 @@ +import{_ as i,c as a,a5 as n,o as p}from"./chunks/framework.Cq8AuEls.js";const g=JSON.parse('{"title":"Coordinate flipping","description":"","frontmatter":{},"headers":[],"relativePath":"source/transformations/flip.md","filePath":"source/transformations/flip.md","lastUpdated":null}'),t={name:"source/transformations/flip.md"};function l(h,s,e,k,r,d){return p(),a("div",null,s[0]||(s[0]=[n(`

Coordinate flipping

This is a simple example of how to use the apply functionality in a function, by flipping the x and y coordinates of a geometry.

julia
"""
+    flip(obj)
+
+Swap all of the x and y coordinates in obj, otherwise
+keeping the original structure (but not necessarily the
+original type).
+
+# Keywords
+
+$APPLY_KEYWORDS
+"""
+function flip(geom; kw...)
+    if _is3d(geom)
+        return apply(PointTrait(), geom; kw...) do p
+            (GI.y(p), GI.x(p), GI.z(p))
+        end
+    else
+        return apply(PointTrait(), geom; kw...) do p
+            (GI.y(p), GI.x(p))
+        end
+    end
+end

This page was generated using Literate.jl.

`,5)]))}const E=i(t,[["render",l]]);export{g as __pageData,E as default}; diff --git a/previews/PR237/assets/source_transformations_flip.md.Drqj7zVo.lean.js b/previews/PR237/assets/source_transformations_flip.md.Drqj7zVo.lean.js new file mode 100644 index 000000000..c9d588776 --- /dev/null +++ b/previews/PR237/assets/source_transformations_flip.md.Drqj7zVo.lean.js @@ -0,0 +1,22 @@ +import{_ as i,c as a,a5 as n,o as p}from"./chunks/framework.Cq8AuEls.js";const g=JSON.parse('{"title":"Coordinate flipping","description":"","frontmatter":{},"headers":[],"relativePath":"source/transformations/flip.md","filePath":"source/transformations/flip.md","lastUpdated":null}'),t={name:"source/transformations/flip.md"};function l(h,s,e,k,r,d){return p(),a("div",null,s[0]||(s[0]=[n(`

Coordinate flipping

This is a simple example of how to use the apply functionality in a function, by flipping the x and y coordinates of a geometry.

julia
"""
+    flip(obj)
+
+Swap all of the x and y coordinates in obj, otherwise
+keeping the original structure (but not necessarily the
+original type).
+
+# Keywords
+
+$APPLY_KEYWORDS
+"""
+function flip(geom; kw...)
+    if _is3d(geom)
+        return apply(PointTrait(), geom; kw...) do p
+            (GI.y(p), GI.x(p), GI.z(p))
+        end
+    else
+        return apply(PointTrait(), geom; kw...) do p
+            (GI.y(p), GI.x(p))
+        end
+    end
+end

This page was generated using Literate.jl.

`,5)]))}const E=i(t,[["render",l]]);export{g as __pageData,E as default}; diff --git a/previews/PR237/assets/source_transformations_reproject.md.CmgYJAT2.js b/previews/PR237/assets/source_transformations_reproject.md.CmgYJAT2.js new file mode 100644 index 000000000..3241dde27 --- /dev/null +++ b/previews/PR237/assets/source_transformations_reproject.md.CmgYJAT2.js @@ -0,0 +1 @@ +import{_ as i,c as a,a5 as e,o as n}from"./chunks/framework.Cq8AuEls.js";const c=JSON.parse('{"title":"Geometry reprojection","description":"","frontmatter":{},"headers":[],"relativePath":"source/transformations/reproject.md","filePath":"source/transformations/reproject.md","lastUpdated":null}'),t={name:"source/transformations/reproject.md"};function p(l,s,r,h,k,o){return n(),a("div",null,s[0]||(s[0]=[e('

Geometry reprojection

julia
export reproject

This file is pretty simple - it simply reprojects a geometry pointwise from one CRS to another. It uses the Proj package for the transformation, but this could be moved to an extension if needed.

Note that the actual implementation is in the GeometryOpsProjExt extension module.

This works using the apply functionality.

julia
"""\n    reproject(geometry; source_crs, target_crs, transform, always_xy, time)\n    reproject(geometry, source_crs, target_crs; always_xy, time)\n    reproject(geometry, transform; always_xy, time)\n\nReproject any GeoInterface.jl compatible `geometry` from `source_crs` to `target_crs`.\n\nThe returned object will be constructed from `GeoInterface.WrapperGeometry`\ngeometries, wrapping views of a `Vector{Proj.Point{D}}`, where `D` is the dimension.\n\n!!! tip\n    The `Proj.jl` package must be loaded for this method to work,\n    since it is implemented in a package extension.\n\n# Arguments\n\n- `geometry`: Any GeoInterface.jl compatible geometries.\n- `source_crs`: the source coordinate reference system, as a GeoFormatTypes.jl object or a string.\n- `target_crs`: the target coordinate reference system, as a GeoFormatTypes.jl object or a string.\n\nIf these a passed as keywords, `transform` will take priority.\nWithout it `target_crs` is always needed, and `source_crs` is\nneeded if it is not retrievable from the geometry with `GeoInterface.crs(geometry)`.\n\n# Keywords\n\n- `always_xy`: force x, y coordinate order, `true` by default.\n    `false` will expect and return points in the crs coordinate order.\n- `time`: the time for the coordinates. `Inf` by default.\n$APPLY_KEYWORDS\n"""\nfunction reproject end

Method error handling

We also inject a method error handler, which prints a suggestion if the Proj extension is not loaded.

julia
function _reproject_error_hinter(io, exc, argtypes, kwargs)\n    if isnothing(Base.get_extension(GeometryOps, :GeometryOpsProjExt)) && exc.f == reproject\n        print(io, "\\n\\nThe `reproject` method requires the Proj.jl package to be explicitly loaded.\\n")\n        print(io, "You can do this by simply typing ")\n        printstyled(io, "using Proj"; color = :cyan, bold = true)\n        println(io, " in your REPL, \\nor otherwise loading Proj.jl via using or import.")\n    else # this is a more general error\n        nothing\n    end\nend

This page was generated using Literate.jl.

',11)]))}const g=i(t,[["render",p]]);export{c as __pageData,g as default}; diff --git a/previews/PR237/assets/source_transformations_reproject.md.CmgYJAT2.lean.js b/previews/PR237/assets/source_transformations_reproject.md.CmgYJAT2.lean.js new file mode 100644 index 000000000..3241dde27 --- /dev/null +++ b/previews/PR237/assets/source_transformations_reproject.md.CmgYJAT2.lean.js @@ -0,0 +1 @@ +import{_ as i,c as a,a5 as e,o as n}from"./chunks/framework.Cq8AuEls.js";const c=JSON.parse('{"title":"Geometry reprojection","description":"","frontmatter":{},"headers":[],"relativePath":"source/transformations/reproject.md","filePath":"source/transformations/reproject.md","lastUpdated":null}'),t={name:"source/transformations/reproject.md"};function p(l,s,r,h,k,o){return n(),a("div",null,s[0]||(s[0]=[e('

Geometry reprojection

julia
export reproject

This file is pretty simple - it simply reprojects a geometry pointwise from one CRS to another. It uses the Proj package for the transformation, but this could be moved to an extension if needed.

Note that the actual implementation is in the GeometryOpsProjExt extension module.

This works using the apply functionality.

julia
"""\n    reproject(geometry; source_crs, target_crs, transform, always_xy, time)\n    reproject(geometry, source_crs, target_crs; always_xy, time)\n    reproject(geometry, transform; always_xy, time)\n\nReproject any GeoInterface.jl compatible `geometry` from `source_crs` to `target_crs`.\n\nThe returned object will be constructed from `GeoInterface.WrapperGeometry`\ngeometries, wrapping views of a `Vector{Proj.Point{D}}`, where `D` is the dimension.\n\n!!! tip\n    The `Proj.jl` package must be loaded for this method to work,\n    since it is implemented in a package extension.\n\n# Arguments\n\n- `geometry`: Any GeoInterface.jl compatible geometries.\n- `source_crs`: the source coordinate reference system, as a GeoFormatTypes.jl object or a string.\n- `target_crs`: the target coordinate reference system, as a GeoFormatTypes.jl object or a string.\n\nIf these a passed as keywords, `transform` will take priority.\nWithout it `target_crs` is always needed, and `source_crs` is\nneeded if it is not retrievable from the geometry with `GeoInterface.crs(geometry)`.\n\n# Keywords\n\n- `always_xy`: force x, y coordinate order, `true` by default.\n    `false` will expect and return points in the crs coordinate order.\n- `time`: the time for the coordinates. `Inf` by default.\n$APPLY_KEYWORDS\n"""\nfunction reproject end

Method error handling

We also inject a method error handler, which prints a suggestion if the Proj extension is not loaded.

julia
function _reproject_error_hinter(io, exc, argtypes, kwargs)\n    if isnothing(Base.get_extension(GeometryOps, :GeometryOpsProjExt)) && exc.f == reproject\n        print(io, "\\n\\nThe `reproject` method requires the Proj.jl package to be explicitly loaded.\\n")\n        print(io, "You can do this by simply typing ")\n        printstyled(io, "using Proj"; color = :cyan, bold = true)\n        println(io, " in your REPL, \\nor otherwise loading Proj.jl via using or import.")\n    else # this is a more general error\n        nothing\n    end\nend

This page was generated using Literate.jl.

',11)]))}const g=i(t,[["render",p]]);export{c as __pageData,g as default}; diff --git a/previews/PR237/assets/source_transformations_segmentize.md.A3Zwf5SL.js b/previews/PR237/assets/source_transformations_segmentize.md.A3Zwf5SL.js new file mode 100644 index 000000000..3b958ed53 --- /dev/null +++ b/previews/PR237/assets/source_transformations_segmentize.md.A3Zwf5SL.js @@ -0,0 +1,161 @@ +import{_ as i,c as a,a5 as n,o as h}from"./chunks/framework.Cq8AuEls.js";const t="/GeometryOps.jl/previews/PR237/assets/xvmpyqb.D5-bot8v.png",l="/GeometryOps.jl/previews/PR237/assets/fhlxvsp.BC9L2R1H.png",o=JSON.parse('{"title":"Segmentize","description":"","frontmatter":{},"headers":[],"relativePath":"source/transformations/segmentize.md","filePath":"source/transformations/segmentize.md","lastUpdated":null}'),k={name:"source/transformations/segmentize.md"};function e(p,s,r,d,E,g){return h(),a("div",null,s[0]||(s[0]=[n(`

Segmentize

julia
export segmentize
+export LinearSegments, GeodesicSegments

This function "segmentizes" or "densifies" a geometry by adding extra vertices to the geometry so that no segment is longer than a given distance. This is useful for plotting geometries with a limited number of vertices, or for ensuring that a geometry is not too "coarse" for a given application.

Info

We plan to add interpolated segmentization from DataInterpolations.jl in the future, which will be available to any vector of point-like objects.

For now, this function only works on 2D geometries.  We will also support 3D geometries, as well as measure interpolation, in the future.

Examples

julia
import GeometryOps as GO, GeoInterface as GI
+rectangle = GI.Wrappers.Polygon([[(0.0, 50.0), (7.071, 57.07), (0, 64.14), (-7.07, 57.07), (0.0, 50.0)]])
+linear = GO.segmentize(rectangle; max_distance = 5)
+collect(GI.getpoint(linear))
9-element Vector{Tuple{Float64, Float64}}:
+ (0.0, 50.0)
+ (3.5355, 53.535)
+ (7.071, 57.07)
+ (3.5355, 60.605000000000004)
+ (0.0, 64.14)
+ (-3.535, 60.605000000000004)
+ (-7.07, 57.07)
+ (-3.535, 53.535)
+ (0.0, 50.0)

You can see that this geometry was segmentized correctly, and now has 8 vertices where it previously had only 4.

Now, we'll also segmentize this using the geodesic method, which is more accurate for lat/lon coordinates.

julia
using Proj # required to activate the \`GeodesicSegments\` method!
+geodesic = GO.segmentize(GO.GeodesicSegments(max_distance = 1000), rectangle)
+length(GI.getpoint(geodesic) |> collect)
3585

This has a lot of points! It's important to keep in mind that the max_distance is in meters, so this is a very fine-grained segmentation.

Now, let's see what they look like! To make this fair, we'll use approximately the same number of points for both.

julia
using CairoMakie
+linear = GO.segmentize(rectangle; max_distance = 0.01)
+geodesic = GO.segmentize(GO.GeodesicSegments(; max_distance = 1000), rectangle)
+f, a, p = poly(collect(GI.getpoint(linear)); label = "Linear", axis = (; aspect = DataAspect()))
+p2 = poly!(collect(GI.getpoint(geodesic)); label = "Geodesic")
+axislegend(a; position = :lt)
+f

There are two methods available for segmentizing geometries at the moment:

Missing docstring.

Missing docstring for LinearSegments. Check Documenter's build log for details.

Missing docstring.

Missing docstring for GeodesicSegments. Check Documenter's build log for details.

Benchmark

We benchmark our method against LibGEOS's GEOSDensify method, which is a similar method for densifying geometries.

julia
using BenchmarkTools: BenchmarkGroup
+using Chairmarks: @be
+using Main: plot_trials
+using CairoMakie
+
+import GeometryOps as GO, GeoInterface as GI, LibGEOS as LG
+
+segmentize_suite = BenchmarkGroup(["title:Segmentize", "subtitle:Segmentize a rectangle"])
+
+rectangle = GI.Wrappers.Polygon([[(0.0, 50.0), (7.071, 57.07), (0.0, 64.14), (-7.07, 57.07), (0.0, 50.0)]])
+lg_rectangle = GI.convert(LG, rectangle)
POLYGON ((0 50, 7.071 57.07, 0 64.14, -7.07 57.07, 0 50))
julia
# These are initial distances, which yield similar numbers of points
+# in the final geometry.
+init_lin = 0.01
+init_geo = 900
+
+# LibGEOS.jl doesn't offer this function, so we just wrap it ourselves!
+function densify(obj::LG.Geometry, tol::Real, context::LG.GEOSContext = LG.get_context(obj))
+    result = LG.GEOSDensify_r(context, obj, tol)
+    if result == C_NULL
+        error("LibGEOS: Error in GEOSDensify")
+    end
+    LG.geomFromGEOS(result, context)
+end
+# now, we get to the actual benchmarking:
+for scalefactor in exp10.(LinRange(log10(0.1), log10(10), 5))
+    lin_dist = init_lin * scalefactor
+    geo_dist = init_geo * scalefactor
+
+    npoints_linear = GI.npoint(GO.segmentize(rectangle; max_distance = lin_dist))
+    npoints_geodesic = GO.segmentize(GO.GeodesicSegments(; max_distance = geo_dist), rectangle) |> GI.npoint
+    npoints_libgeos = GI.npoint(densify(lg_rectangle, lin_dist))
+
+    segmentize_suite["Linear"][npoints_linear] = @be GO.segmentize(GO.LinearSegments(; max_distance = $lin_dist), $rectangle) seconds=1
+    segmentize_suite["Geodesic"][npoints_geodesic] = @be GO.segmentize(GO.GeodesicSegments(; max_distance = $geo_dist), $rectangle) seconds=1
+    segmentize_suite["LibGEOS"][npoints_libgeos] = @be densify($lg_rectangle, $lin_dist) seconds=1
+
+end
+
+plot_trials(segmentize_suite)

julia
abstract type SegmentizeMethod end
+"""
+    LinearSegments(; max_distance::Real)
+
+A method for segmentizing geometries by adding extra vertices to the geometry so that no segment is longer than a given distance.
+
+Here, \`max_distance\` is a purely nondimensional quantity and will apply in the input space.   This is to say, that if the polygon is
+provided in lat/lon coordinates then the \`max_distance\` will be in degrees of arc.  If the polygon is provided in meters, then the
+\`max_distance\` will be in meters.
+"""
+Base.@kwdef struct LinearSegments <: SegmentizeMethod
+    max_distance::Float64
+end
+
+"""
+    GeodesicSegments(; max_distance::Real, equatorial_radius::Real=6378137, flattening::Real=1/298.257223563)
+
+A method for segmentizing geometries by adding extra vertices to the geometry so that no segment is longer than a given distance.
+This method calculates the distance between points on the geodesic, and assumes input in lat/long coordinates.
+
+!!! warning
+    Any input geometries must be in lon/lat coordinates!  If not, the method may fail or error.
+
+# Arguments
+- \`max_distance::Real\`: The maximum distance, **in meters**, between vertices in the geometry.
+- \`equatorial_radius::Real=6378137\`: The equatorial radius of the Earth, in meters.  Passed to \`Proj.geod_geodesic\`.
+- \`flattening::Real=1/298.257223563\`: The flattening of the Earth, which is the ratio of the difference between the equatorial and polar radii to the equatorial radius.  Passed to \`Proj.geod_geodesic\`.
+
+One can also omit the \`equatorial_radius\` and \`flattening\` keyword arguments, and pass a \`geodesic\` object directly to the eponymous keyword.
+
+This method uses the Proj/GeographicLib API for geodesic calculations.
+"""
+struct GeodesicSegments{T} <: SegmentizeMethod
+    geodesic::T# ::Proj.geod_geodesic
+    max_distance::Float64
+end

Add an error hint for GeodesicSegments if Proj is not loaded!

julia
function _geodesic_segments_error_hinter(io, exc, argtypes, kwargs)
+    if isnothing(Base.get_extension(GeometryOps, :GeometryOpsProjExt)) && exc.f == GeodesicSegments
+        print(io, "\\n\\nThe \`Geodesic\` method requires the Proj.jl package to be explicitly loaded.\\n")
+        print(io, "You can do this by simply typing ")
+        printstyled(io, "using Proj"; color = :cyan, bold = true)
+        println(io, " in your REPL, \\nor otherwise loading Proj.jl via using or import.")
+    end
+end

Implementation

julia
"""
+    segmentize([method = Planar()], geom; max_distance::Real, threaded)
+
+Segmentize a geometry by adding extra vertices to the geometry so that no segment is longer than a given distance.
+This is useful for plotting geometries with a limited number of vertices, or for ensuring that a geometry is not too "coarse" for a given application.
+
+# Arguments
+- \`method::Manifold = Planar()\`: The method to use for segmentizing the geometry.  At the moment, only \`Planar\` (assumes a flat plane) and \`Geodesic\` (assumes geometry on the ellipsoidal Earth and uses Vincenty's formulae) are available.
+- \`geom\`: The geometry to segmentize.  Must be a \`LineString\`, \`LinearRing\`, \`Polygon\`, \`MultiPolygon\`, or \`GeometryCollection\`, or some vector or table of those.
+- \`max_distance::Real\`: The maximum distance between vertices in the geometry.  **Beware: for \`Planar\`, this is in the units of the geometry, but for \`Geodesic\` and \`Spherical\` it's in units of the radius of the sphere.**
+
+Returns a geometry of similar type to the input geometry, but resampled.
+"""
+function segmentize(geom; max_distance, threaded::Union{Bool, BoolsAsTypes} = _False())
+    return segmentize(Planar(), geom; max_distance, threaded = _booltype(threaded))
+end

allow three-arg method as well, just in case

julia
segmentize(geom, max_distance::Real; threaded = _False()) = segmentize(Planar(), geom, max_distance; threaded)
+segmentize(method::Manifold, geom, max_distance::Real; threaded = _False()) = segmentize(Planar(), geom; max_distance, threaded)

generic implementation

julia
function segmentize(method::Manifold, geom; max_distance, threaded::Union{Bool, BoolsAsTypes} = _False())
+    @assert max_distance > 0 "\`max_distance\` should be positive and nonzero!  Found $(method.max_distance)."
+    _segmentize_function(geom) = _segmentize(method, geom, GI.trait(geom); max_distance)
+    return apply(_segmentize_function, TraitTarget(GI.LinearRingTrait(), GI.LineStringTrait()), geom; threaded)
+end
+
+function segmentize(method::SegmentizeMethod, geom; threaded::Union{Bool, BoolsAsTypes} = _False())
+    @warn "\`segmentize(method::$(typeof(method)), geom) is deprecated; use \`segmentize($(method isa LinearSegments ? "Planar()" : "Geodesic()"), geom; max_distance, threaded) instead!"  maxlog=3
+    @assert method.max_distance > 0 "\`max_distance\` should be positive and nonzero!  Found $(method.max_distance)."
+    new_method = method isa LinearSegments ? Planar() : Geodesic()
+    segmentize(new_method, geom; max_distance = method.max_distance, threaded)
+end
+
+_segmentize(method, geom) = _segmentize(method, geom, GI.trait(geom))
+#=
+This is a method which performs the common functionality for both linear and geodesic algorithms,
+and calls out to the "kernel" function which we've defined per linesegment.
+=#
+function _segmentize(method::Union{Planar, Spherical}, geom, T::Union{GI.LineStringTrait, GI.LinearRingTrait}; max_distance)
+    first_coord = GI.getpoint(geom, 1)
+    x1, y1 = GI.x(first_coord), GI.y(first_coord)
+    new_coords = NTuple{2, Float64}[]
+    sizehint!(new_coords, GI.npoint(geom))
+    push!(new_coords, (x1, y1))
+    for coord in Iterators.drop(GI.getpoint(geom), 1)
+        x2, y2 = GI.x(coord), GI.y(coord)
+        _fill_linear_kernel!(method, new_coords, x1, y1, x2, y2; max_distance)
+        x1, y1 = x2, y2
+    end
+    return rebuild(geom, new_coords)
+end
+
+function _fill_linear_kernel!(::Planar, new_coords::Vector, x1, y1, x2, y2; max_distance)
+    dx, dy = x2 - x1, y2 - y1
+    distance = hypot(dx, dy) # this is a more stable way to compute the Euclidean distance
+    if distance > max_distance
+        n_segments = ceil(Int, distance / max_distance)
+        for i in 1:(n_segments - 1)
+            t = i / n_segments
+            push!(new_coords, (x1 + t * dx, y1 + t * dy))
+        end
+    end

End the line with the original coordinate, to avoid any multiplication errors.

julia
    push!(new_coords, (x2, y2))
+    return nothing
+end

Note

The _fill_linear_kernel definition for GeodesicSegments is in the GeometryOpsProjExt extension module, in the segmentize.jl file.


This page was generated using Literate.jl.

`,39)]))}const F=i(k,[["render",e]]);export{o as __pageData,F as default}; diff --git a/previews/PR237/assets/source_transformations_segmentize.md.A3Zwf5SL.lean.js b/previews/PR237/assets/source_transformations_segmentize.md.A3Zwf5SL.lean.js new file mode 100644 index 000000000..3b958ed53 --- /dev/null +++ b/previews/PR237/assets/source_transformations_segmentize.md.A3Zwf5SL.lean.js @@ -0,0 +1,161 @@ +import{_ as i,c as a,a5 as n,o as h}from"./chunks/framework.Cq8AuEls.js";const t="/GeometryOps.jl/previews/PR237/assets/xvmpyqb.D5-bot8v.png",l="/GeometryOps.jl/previews/PR237/assets/fhlxvsp.BC9L2R1H.png",o=JSON.parse('{"title":"Segmentize","description":"","frontmatter":{},"headers":[],"relativePath":"source/transformations/segmentize.md","filePath":"source/transformations/segmentize.md","lastUpdated":null}'),k={name:"source/transformations/segmentize.md"};function e(p,s,r,d,E,g){return h(),a("div",null,s[0]||(s[0]=[n(`

Segmentize

julia
export segmentize
+export LinearSegments, GeodesicSegments

This function "segmentizes" or "densifies" a geometry by adding extra vertices to the geometry so that no segment is longer than a given distance. This is useful for plotting geometries with a limited number of vertices, or for ensuring that a geometry is not too "coarse" for a given application.

Info

We plan to add interpolated segmentization from DataInterpolations.jl in the future, which will be available to any vector of point-like objects.

For now, this function only works on 2D geometries.  We will also support 3D geometries, as well as measure interpolation, in the future.

Examples

julia
import GeometryOps as GO, GeoInterface as GI
+rectangle = GI.Wrappers.Polygon([[(0.0, 50.0), (7.071, 57.07), (0, 64.14), (-7.07, 57.07), (0.0, 50.0)]])
+linear = GO.segmentize(rectangle; max_distance = 5)
+collect(GI.getpoint(linear))
9-element Vector{Tuple{Float64, Float64}}:
+ (0.0, 50.0)
+ (3.5355, 53.535)
+ (7.071, 57.07)
+ (3.5355, 60.605000000000004)
+ (0.0, 64.14)
+ (-3.535, 60.605000000000004)
+ (-7.07, 57.07)
+ (-3.535, 53.535)
+ (0.0, 50.0)

You can see that this geometry was segmentized correctly, and now has 8 vertices where it previously had only 4.

Now, we'll also segmentize this using the geodesic method, which is more accurate for lat/lon coordinates.

julia
using Proj # required to activate the \`GeodesicSegments\` method!
+geodesic = GO.segmentize(GO.GeodesicSegments(max_distance = 1000), rectangle)
+length(GI.getpoint(geodesic) |> collect)
3585

This has a lot of points! It's important to keep in mind that the max_distance is in meters, so this is a very fine-grained segmentation.

Now, let's see what they look like! To make this fair, we'll use approximately the same number of points for both.

julia
using CairoMakie
+linear = GO.segmentize(rectangle; max_distance = 0.01)
+geodesic = GO.segmentize(GO.GeodesicSegments(; max_distance = 1000), rectangle)
+f, a, p = poly(collect(GI.getpoint(linear)); label = "Linear", axis = (; aspect = DataAspect()))
+p2 = poly!(collect(GI.getpoint(geodesic)); label = "Geodesic")
+axislegend(a; position = :lt)
+f

There are two methods available for segmentizing geometries at the moment:

Missing docstring.

Missing docstring for LinearSegments. Check Documenter's build log for details.

Missing docstring.

Missing docstring for GeodesicSegments. Check Documenter's build log for details.

Benchmark

We benchmark our method against LibGEOS's GEOSDensify method, which is a similar method for densifying geometries.

julia
using BenchmarkTools: BenchmarkGroup
+using Chairmarks: @be
+using Main: plot_trials
+using CairoMakie
+
+import GeometryOps as GO, GeoInterface as GI, LibGEOS as LG
+
+segmentize_suite = BenchmarkGroup(["title:Segmentize", "subtitle:Segmentize a rectangle"])
+
+rectangle = GI.Wrappers.Polygon([[(0.0, 50.0), (7.071, 57.07), (0.0, 64.14), (-7.07, 57.07), (0.0, 50.0)]])
+lg_rectangle = GI.convert(LG, rectangle)
POLYGON ((0 50, 7.071 57.07, 0 64.14, -7.07 57.07, 0 50))
julia
# These are initial distances, which yield similar numbers of points
+# in the final geometry.
+init_lin = 0.01
+init_geo = 900
+
+# LibGEOS.jl doesn't offer this function, so we just wrap it ourselves!
+function densify(obj::LG.Geometry, tol::Real, context::LG.GEOSContext = LG.get_context(obj))
+    result = LG.GEOSDensify_r(context, obj, tol)
+    if result == C_NULL
+        error("LibGEOS: Error in GEOSDensify")
+    end
+    LG.geomFromGEOS(result, context)
+end
+# now, we get to the actual benchmarking:
+for scalefactor in exp10.(LinRange(log10(0.1), log10(10), 5))
+    lin_dist = init_lin * scalefactor
+    geo_dist = init_geo * scalefactor
+
+    npoints_linear = GI.npoint(GO.segmentize(rectangle; max_distance = lin_dist))
+    npoints_geodesic = GO.segmentize(GO.GeodesicSegments(; max_distance = geo_dist), rectangle) |> GI.npoint
+    npoints_libgeos = GI.npoint(densify(lg_rectangle, lin_dist))
+
+    segmentize_suite["Linear"][npoints_linear] = @be GO.segmentize(GO.LinearSegments(; max_distance = $lin_dist), $rectangle) seconds=1
+    segmentize_suite["Geodesic"][npoints_geodesic] = @be GO.segmentize(GO.GeodesicSegments(; max_distance = $geo_dist), $rectangle) seconds=1
+    segmentize_suite["LibGEOS"][npoints_libgeos] = @be densify($lg_rectangle, $lin_dist) seconds=1
+
+end
+
+plot_trials(segmentize_suite)

julia
abstract type SegmentizeMethod end
+"""
+    LinearSegments(; max_distance::Real)
+
+A method for segmentizing geometries by adding extra vertices to the geometry so that no segment is longer than a given distance.
+
+Here, \`max_distance\` is a purely nondimensional quantity and will apply in the input space.   This is to say, that if the polygon is
+provided in lat/lon coordinates then the \`max_distance\` will be in degrees of arc.  If the polygon is provided in meters, then the
+\`max_distance\` will be in meters.
+"""
+Base.@kwdef struct LinearSegments <: SegmentizeMethod
+    max_distance::Float64
+end
+
+"""
+    GeodesicSegments(; max_distance::Real, equatorial_radius::Real=6378137, flattening::Real=1/298.257223563)
+
+A method for segmentizing geometries by adding extra vertices to the geometry so that no segment is longer than a given distance.
+This method calculates the distance between points on the geodesic, and assumes input in lat/long coordinates.
+
+!!! warning
+    Any input geometries must be in lon/lat coordinates!  If not, the method may fail or error.
+
+# Arguments
+- \`max_distance::Real\`: The maximum distance, **in meters**, between vertices in the geometry.
+- \`equatorial_radius::Real=6378137\`: The equatorial radius of the Earth, in meters.  Passed to \`Proj.geod_geodesic\`.
+- \`flattening::Real=1/298.257223563\`: The flattening of the Earth, which is the ratio of the difference between the equatorial and polar radii to the equatorial radius.  Passed to \`Proj.geod_geodesic\`.
+
+One can also omit the \`equatorial_radius\` and \`flattening\` keyword arguments, and pass a \`geodesic\` object directly to the eponymous keyword.
+
+This method uses the Proj/GeographicLib API for geodesic calculations.
+"""
+struct GeodesicSegments{T} <: SegmentizeMethod
+    geodesic::T# ::Proj.geod_geodesic
+    max_distance::Float64
+end

Add an error hint for GeodesicSegments if Proj is not loaded!

julia
function _geodesic_segments_error_hinter(io, exc, argtypes, kwargs)
+    if isnothing(Base.get_extension(GeometryOps, :GeometryOpsProjExt)) && exc.f == GeodesicSegments
+        print(io, "\\n\\nThe \`Geodesic\` method requires the Proj.jl package to be explicitly loaded.\\n")
+        print(io, "You can do this by simply typing ")
+        printstyled(io, "using Proj"; color = :cyan, bold = true)
+        println(io, " in your REPL, \\nor otherwise loading Proj.jl via using or import.")
+    end
+end

Implementation

julia
"""
+    segmentize([method = Planar()], geom; max_distance::Real, threaded)
+
+Segmentize a geometry by adding extra vertices to the geometry so that no segment is longer than a given distance.
+This is useful for plotting geometries with a limited number of vertices, or for ensuring that a geometry is not too "coarse" for a given application.
+
+# Arguments
+- \`method::Manifold = Planar()\`: The method to use for segmentizing the geometry.  At the moment, only \`Planar\` (assumes a flat plane) and \`Geodesic\` (assumes geometry on the ellipsoidal Earth and uses Vincenty's formulae) are available.
+- \`geom\`: The geometry to segmentize.  Must be a \`LineString\`, \`LinearRing\`, \`Polygon\`, \`MultiPolygon\`, or \`GeometryCollection\`, or some vector or table of those.
+- \`max_distance::Real\`: The maximum distance between vertices in the geometry.  **Beware: for \`Planar\`, this is in the units of the geometry, but for \`Geodesic\` and \`Spherical\` it's in units of the radius of the sphere.**
+
+Returns a geometry of similar type to the input geometry, but resampled.
+"""
+function segmentize(geom; max_distance, threaded::Union{Bool, BoolsAsTypes} = _False())
+    return segmentize(Planar(), geom; max_distance, threaded = _booltype(threaded))
+end

allow three-arg method as well, just in case

julia
segmentize(geom, max_distance::Real; threaded = _False()) = segmentize(Planar(), geom, max_distance; threaded)
+segmentize(method::Manifold, geom, max_distance::Real; threaded = _False()) = segmentize(Planar(), geom; max_distance, threaded)

generic implementation

julia
function segmentize(method::Manifold, geom; max_distance, threaded::Union{Bool, BoolsAsTypes} = _False())
+    @assert max_distance > 0 "\`max_distance\` should be positive and nonzero!  Found $(method.max_distance)."
+    _segmentize_function(geom) = _segmentize(method, geom, GI.trait(geom); max_distance)
+    return apply(_segmentize_function, TraitTarget(GI.LinearRingTrait(), GI.LineStringTrait()), geom; threaded)
+end
+
+function segmentize(method::SegmentizeMethod, geom; threaded::Union{Bool, BoolsAsTypes} = _False())
+    @warn "\`segmentize(method::$(typeof(method)), geom) is deprecated; use \`segmentize($(method isa LinearSegments ? "Planar()" : "Geodesic()"), geom; max_distance, threaded) instead!"  maxlog=3
+    @assert method.max_distance > 0 "\`max_distance\` should be positive and nonzero!  Found $(method.max_distance)."
+    new_method = method isa LinearSegments ? Planar() : Geodesic()
+    segmentize(new_method, geom; max_distance = method.max_distance, threaded)
+end
+
+_segmentize(method, geom) = _segmentize(method, geom, GI.trait(geom))
+#=
+This is a method which performs the common functionality for both linear and geodesic algorithms,
+and calls out to the "kernel" function which we've defined per linesegment.
+=#
+function _segmentize(method::Union{Planar, Spherical}, geom, T::Union{GI.LineStringTrait, GI.LinearRingTrait}; max_distance)
+    first_coord = GI.getpoint(geom, 1)
+    x1, y1 = GI.x(first_coord), GI.y(first_coord)
+    new_coords = NTuple{2, Float64}[]
+    sizehint!(new_coords, GI.npoint(geom))
+    push!(new_coords, (x1, y1))
+    for coord in Iterators.drop(GI.getpoint(geom), 1)
+        x2, y2 = GI.x(coord), GI.y(coord)
+        _fill_linear_kernel!(method, new_coords, x1, y1, x2, y2; max_distance)
+        x1, y1 = x2, y2
+    end
+    return rebuild(geom, new_coords)
+end
+
+function _fill_linear_kernel!(::Planar, new_coords::Vector, x1, y1, x2, y2; max_distance)
+    dx, dy = x2 - x1, y2 - y1
+    distance = hypot(dx, dy) # this is a more stable way to compute the Euclidean distance
+    if distance > max_distance
+        n_segments = ceil(Int, distance / max_distance)
+        for i in 1:(n_segments - 1)
+            t = i / n_segments
+            push!(new_coords, (x1 + t * dx, y1 + t * dy))
+        end
+    end

End the line with the original coordinate, to avoid any multiplication errors.

julia
    push!(new_coords, (x2, y2))
+    return nothing
+end

Note

The _fill_linear_kernel definition for GeodesicSegments is in the GeometryOpsProjExt extension module, in the segmentize.jl file.


This page was generated using Literate.jl.

`,39)]))}const F=i(k,[["render",e]]);export{o as __pageData,F as default}; diff --git a/previews/PR237/assets/source_transformations_simplify.md.Bjsi40yW.js b/previews/PR237/assets/source_transformations_simplify.md.Bjsi40yW.js new file mode 100644 index 000000000..6f6512a8d --- /dev/null +++ b/previews/PR237/assets/source_transformations_simplify.md.Bjsi40yW.js @@ -0,0 +1,490 @@ +import{_ as i,c as a,a5 as n,o as h}from"./chunks/framework.Cq8AuEls.js";const l="/GeometryOps.jl/previews/PR237/assets/ttyjkgn.Bglvb-jp.png",k="/GeometryOps.jl/previews/PR237/assets/cmuiohu.B94PsR1K.png",t="/GeometryOps.jl/previews/PR237/assets/hrgkwjx.eNayRHGS.png",p="/GeometryOps.jl/previews/PR237/assets/nicwgxr.DmInwsY_.png",c=JSON.parse('{"title":"Geometry simplification","description":"","frontmatter":{},"headers":[],"relativePath":"source/transformations/simplify.md","filePath":"source/transformations/simplify.md","lastUpdated":null}'),e={name:"source/transformations/simplify.md"};function E(r,s,d,g,y,F){return h(),a("div",null,s[0]||(s[0]=[n(`

Geometry simplification

This file holds implementations for the RadialDistance, Douglas-Peucker, and Visvalingam-Whyatt algorithms for simplifying geometries (specifically for polygons and lines).

The GEOS extension also allows for GEOS's topology preserving simplification as well as Douglas-Peucker simplification implemented in GEOS. Call this by passing GEOS(; method = :TopologyPreserve) or GEOS(; method = :DouglasPeucker) to the algorithm.

Examples

A quick and dirty example is:

julia
using Makie, GeoInterfaceMakie
+import GeoInterface as GI
+import GeometryOps as GO
+
+original = GI.Polygon([[[-70.603637, -33.399918], [-70.614624, -33.395332], [-70.639343, -33.392466], [-70.659942, -33.394759], [-70.683975, -33.404504], [-70.697021, -33.419406], [-70.701141, -33.434306], [-70.700454, -33.446339], [-70.694274, -33.458369], [-70.682601, -33.465816], [-70.668869, -33.472117], [-70.646209, -33.473835], [-70.624923, -33.472117], [-70.609817, -33.468107], [-70.595397, -33.458369], [-70.587158, -33.442901], [-70.587158, -33.426283], [-70.590591, -33.414248], [-70.594711, -33.406224], [-70.603637, -33.399918]]])
+
+simple = GO.simplify(original; number=6)
+
+f, a, p = poly(original; label = "Original")
+poly!(simple; label = "Simplified")
+axislegend(a)
+f

Benchmark

We benchmark these methods against LibGEOS's simplify implementation, which uses the Douglas-Peucker algorithm.

julia
using BenchmarkTools, Chairmarks, GeoJSON, CairoMakie
+import GeometryOps as GO, LibGEOS as LG, GeoInterface as GI
+using CoordinateTransformations
+using NaturalEarth
+lg_and_go(geometry) = (GI.convert(LG, geometry), GO.tuples(geometry))
+# Load in the Natural Earth admin GeoJSON, then extract the USA's geometry
+fc = NaturalEarth.naturalearth("admin_0_countries", 10)
+usa_multipoly = fc.geometry[findfirst(==("United States of America"), fc.NAME)] |> x -> GI.convert(LG, x) |> LG.makeValid |> GO.tuples
+include(joinpath(dirname(dirname(pathof(GO))), "test", "data", "polygon_generation.jl"))
+
+usa_poly = GI.getgeom(usa_multipoly, findmax(GO.area.(GI.getgeom(usa_multipoly)))[2]) # isolate the poly with the most area
+usa_centroid = GO.centroid(usa_poly)
+usa_reflected = GO.transform(Translation(usa_centroid...)  LinearMap(Makie.rotmatrix2d(π))  Translation((-).(usa_centroid)...), usa_poly)
+f, a, p = plot(usa_poly; label = "Original", axis = (; aspect = DataAspect()))#; plot!(usa_reflected; label = "Reflected")

This is the complex polygon we'll be benchmarking.

julia
simplify_suite = BenchmarkGroup(["Simplify"])
+singlepoly_suite = BenchmarkGroup(["Polygon", "title:Polygon simplify", "subtitle:Random blob"])
+
+include(joinpath(dirname(dirname(pathof(GO))), "test", "data", "polygon_generation.jl"))
+
+for n_verts in round.(Int, exp10.(LinRange(log10(10), log10(10_000), 10)))
+    geom = GI.Wrappers.Polygon(generate_random_poly(0, 0, n_verts, 2, 0.2, 0.3))
+    geom_lg, geom_go = lg_and_go(LG.makeValid(GI.convert(LG, geom)))
+    singlepoly_suite["GO-DP"][GI.npoint(geom)] = @be GO.simplify($geom_go; tol = 0.1) seconds=1
+    singlepoly_suite["GO-VW"][GI.npoint(geom)] = @be GO.simplify($(GO.VisvalingamWhyatt(; tol = 0.1)), $geom_go) seconds=1
+    singlepoly_suite["GO-RD"][GI.npoint(geom)] = @be GO.simplify($(GO.RadialDistance(; tol = 0.1)), $geom_go) seconds=1
+    singlepoly_suite["LibGEOS"][GI.npoint(geom)] = @be LG.simplify($geom_lg, 0.1) seconds=1
+end
+
+plot_trials(singlepoly_suite; legend_position=(1, 1, TopRight()), legend_valign = -2, legend_halign = 1.2, legend_orientation = :horizontal)

julia
multipoly_suite = BenchmarkGroup(["MultiPolygon", "title:Multipolygon simplify", "subtitle:USA multipolygon"])
+
+for frac in exp10.(LinRange(log10(0.3), log10(1), 6)) # TODO: this example isn't the best.  How can we get this better?
+    geom = GO.simplify(usa_multipoly; ratio = frac)
+    geom_lg, geom_go = lg_and_go(geom)
+    _tol = 0.001
+    multipoly_suite["GO-DP"][GI.npoint(geom)] = @be GO.simplify($geom_go; tol = $_tol) seconds=1
+    # multipoly_suite["GO-VW"][GI.npoint(geom)] = @be GO.simplify($(GO.VisvalingamWhyatt(; tol = $_tol)), $geom_go) seconds=1
+    multipoly_suite["GO-RD"][GI.npoint(geom)] = @be GO.simplify($(GO.RadialDistance(; tol = _tol)), $geom_go) seconds=1
+    multipoly_suite["LibGEOS"][GI.npoint(geom)] = @be LG.simplify($geom_lg, $_tol) seconds=1
+    println("""
+    For $(GI.npoint(geom)) points, the algorithms generated polygons with the following number of vertices:
+    GO-DP : $(GI.npoint( GO.simplify(geom_go; tol = _tol)))
+    GO-RD : $(GI.npoint( GO.simplify((GO.RadialDistance(; tol = _tol)), geom_go)))
+    LGeos : $(GI.npoint( LG.simplify(geom_lg, _tol)))
+    """)
+    # GO-VW : $(GI.npoint( GO.simplify((GO.VisvalingamWhyatt(; tol = _tol)), geom_go)))
+    println()
+end
+plot_trials(multipoly_suite)

julia
export simplify, VisvalingamWhyatt, DouglasPeucker, RadialDistance
+
+const _SIMPLIFY_TARGET = TraitTarget{Union{GI.PolygonTrait, GI.AbstractCurveTrait, GI.MultiPointTrait, GI.PointTrait}}()
+const MIN_POINTS = 3
+const SIMPLIFY_ALG_KEYWORDS = """
+# Keywords
+
+- \`ratio\`: the fraction of points that should remain after \`simplify\`.
+    Useful as it will generalise for large collections of objects.
+- \`number\`: the number of points that should remain after \`simplify\`.
+    Less useful for large collections of mixed size objects.
+"""
+const DOUGLAS_PEUCKER_KEYWORDS = """
+$SIMPLIFY_ALG_KEYWORDS
+- \`tol\`: the minimum distance a point will be from the line
+    joining its neighboring points.
+"""
+
+"""
+    abstract type SimplifyAlg
+
+Abstract type for simplification algorithms.
+
+# API
+
+For now, the algorithm must hold the \`number\`, \`ratio\` and \`tol\` properties.
+
+Simplification algorithm types can hook into the interface by implementing
+the \`_simplify(trait, alg, geom)\` methods for whichever traits are necessary.
+"""
+abstract type SimplifyAlg end
+
+"""
+    simplify(obj; kw...)
+    simplify(::SimplifyAlg, obj; kw...)
+
+Simplify a geometry, feature, feature collection,
+or nested vectors or a table of these.
+
+\`RadialDistance\`, \`DouglasPeucker\`, or
+\`VisvalingamWhyatt\` algorithms are available,
+listed in order of increasing quality but decreasing performance.
+
+\`PoinTrait\` and \`MultiPointTrait\` are returned unchanged.
+
+The default behaviour is \`simplify(DouglasPeucker(; kw...), obj)\`.
+Pass in other \`SimplifyAlg\` to use other algorithms.

Keywords

julia
- \`prefilter_alg\`: \`SimplifyAlg\` algorithm used to pre-filter object before
+    using primary filtering algorithm.
+$APPLY_KEYWORDS
+
+
+Keywords for DouglasPeucker are allowed when no algorithm is specified:
+
+$DOUGLAS_PEUCKER_KEYWORDS

Example

julia
Simplify a polygon to have six points:
+
+\`\`\`jldoctest
+import GeoInterface as GI
+import GeometryOps as GO
+
+poly = GI.Polygon([[
+    [-70.603637, -33.399918],
+    [-70.614624, -33.395332],
+    [-70.639343, -33.392466],
+    [-70.659942, -33.394759],
+    [-70.683975, -33.404504],
+    [-70.697021, -33.419406],
+    [-70.701141, -33.434306],
+    [-70.700454, -33.446339],
+    [-70.694274, -33.458369],
+    [-70.682601, -33.465816],
+    [-70.668869, -33.472117],
+    [-70.646209, -33.473835],
+    [-70.624923, -33.472117],
+    [-70.609817, -33.468107],
+    [-70.595397, -33.458369],
+    [-70.587158, -33.442901],
+    [-70.587158, -33.426283],
+    [-70.590591, -33.414248],
+    [-70.594711, -33.406224],
+    [-70.603637, -33.399918]]])
+
+simple = GO.simplify(poly; number=6)
+GI.npoint(simple)

output

julia
6
+\`\`\`
+"""
+simplify(alg::SimplifyAlg, data; kw...) = _simplify(alg, data; kw...)
+simplify(alg::GEOS, data; kw...) = _simplify(alg, data; kw...)

Default algorithm is DouglasPeucker

julia
simplify(
+    data; prefilter_alg = nothing,
+    calc_extent=false, threaded=false, crs=nothing, kw...,
+ ) = _simplify(DouglasPeucker(; kw...), data; prefilter_alg, calc_extent, threaded, crs)
+
+
+#= For each algorithm, apply simplification to all curves, multipoints, and
+points, reconstructing everything else around them. =#
+function _simplify(alg::Union{SimplifyAlg, GEOS}, data; prefilter_alg=nothing, kw...)
+    simplifier(geom) = _simplify(GI.trait(geom), alg, geom; prefilter_alg)
+    return apply(simplifier, _SIMPLIFY_TARGET, data; kw...)
+end
+
+
+# For Point and MultiPoint traits we do nothing
+_simplify(::GI.PointTrait, alg, geom; kw...) = geom
+_simplify(::GI.MultiPointTrait, alg, geom; kw...) = geom
+
+# For curves, rings, and polygon we simplify
+function _simplify(
+    ::GI.AbstractCurveTrait, alg, geom;
+    prefilter_alg, preserve_endpoint = true,
+)
+    points = if isnothing(prefilter_alg)
+        tuple_points(geom)
+    else
+        _simplify(prefilter_alg, tuple_points(geom), preserve_endpoint)
+    end
+    return rebuild(geom, _simplify(alg, points, preserve_endpoint))
+end
+
+function _simplify(::GI.PolygonTrait, alg, geom;  kw...)
+    # Force treating children as LinearRing
+    simplifier(g) = _simplify(
+        GI.LinearRingTrait(), alg, g;
+        kw..., preserve_endpoint = false,
+    )
+    lrs = map(simplifier, GI.getgeom(geom))
+    return rebuild(geom, lrs)
+end

Simplify with RadialDistance Algorithm

julia
"""
+    RadialDistance <: SimplifyAlg
+
+Simplifies geometries by removing points less than
+\`tol\` distance from the line between its neighboring points.
+
+$SIMPLIFY_ALG_KEYWORDS
+- \`tol\`: the minimum distance between points.
+
+Note: user input \`tol\` is squared to avoid unnecessary computation in algorithm.
+"""
+@kwdef struct RadialDistance <: SimplifyAlg
+    number::Union{Int64,Nothing} = nothing
+    ratio::Union{Float64,Nothing} = nothing
+    tol::Union{Float64,Nothing} = nothing
+
+    function RadialDistance(number, ratio, tol)
+        _checkargs(number, ratio, tol)

square tolerance for reduced computation

julia
        tol = isnothing(tol) ? tol : tol^2
+        new(number, ratio, tol)
+    end
+end
+
+function _simplify(alg::RadialDistance, points::Vector, _)
+    previous = first(points)
+    distances = Array{Float64}(undef, length(points))
+    for i in eachindex(points)
+        point = points[i]
+        distances[i] = _squared_euclid_distance(Float64, point, previous)
+        previous = point
+    end
+    # Never remove the end points
+    distances[begin] = distances[end] = Inf
+    return _get_points(alg, points, distances)
+end

Simplify with DouglasPeucker Algorithm

julia
"""
+    DouglasPeucker <: SimplifyAlg
+
+    DouglasPeucker(; number, ratio, tol)
+
+Simplifies geometries by removing points below \`tol\`
+distance from the line between its neighboring points.
+
+$DOUGLAS_PEUCKER_KEYWORDS
+Note: user input \`tol\` is squared to avoid unnecessary computation in algorithm.
+"""
+@kwdef struct DouglasPeucker <: SimplifyAlg
+    number::Union{Int64,Nothing} = nothing
+    ratio::Union{Float64,Nothing} = nothing
+    tol::Union{Float64,Nothing} = nothing
+
+    function DouglasPeucker(number, ratio, tol)
+        _checkargs(number, ratio, tol)

square tolerance for reduced computation

julia
        tol = isnothing(tol) ? tol : tol^2
+        return new(number, ratio, tol)
+    end
+end
+
+#= Simplify using the DouglasPeucker algorithm - nice gif of process on wikipedia:
+(https://en.wikipedia.org/wiki/Ramer-Douglas-Peucker_algorithm). =#
+function _simplify(alg::DouglasPeucker, points::Vector, preserve_endpoint)
+    npoints = length(points)
+    npoints <= MIN_POINTS && return points

Determine stopping criteria

julia
    max_points = if !isnothing(alg.tol)
+        npoints
+    else
+        npts = !isnothing(alg.number) ? alg.number : max(3, round(Int, alg.ratio * npoints))
+        npts  npoints && return points
+        npts
+    end
+    max_tol = !isnothing(alg.tol) ? alg.tol : zero(Float64)

Set up queue

julia
    queue = Vector{Tuple{Int, Int, Int, Float64}}()
+    queue_idx, queue_dist = 0, zero(Float64)
+    len_queue = 0

Set up results vector

julia
    results = Vector{Int}(undef, max_points + (preserve_endpoint ? 0 : 1))
+    results[1], results[2] = 1, npoints

Loop through points until stopping criteria are fulfilled

julia
    i = 2  # already have first and last point added
+    start_idx, end_idx = 1, npoints
+    max_idx, max_dist = _find_max_squared_dist(points, start_idx, end_idx)
+    while i  min(MIN_POINTS + 1, max_points) || (i < max_points && max_dist > max_tol)

Add next point to results

julia
        i += 1
+        results[i] = max_idx

Determine which point to add next by checking left and right of point

julia
        left_idx, left_dist = _find_max_squared_dist(points, start_idx, max_idx)
+        right_idx, right_dist = _find_max_squared_dist(points, max_idx, end_idx)
+        left_vals = (start_idx, left_idx, max_idx, left_dist)
+        right_vals = (max_idx, right_idx, end_idx, right_dist)

Add and remove values from queue

julia
        if queue_dist > left_dist && queue_dist > right_dist

Value in queue is next value to add to results

julia
            start_idx, max_idx, end_idx, max_dist = queue[queue_idx]

Add left and/or right values to queue or delete used queue value

julia
            if left_dist > 0
+                queue[queue_idx] = left_vals
+                if right_dist > 0
+                    push!(queue, right_vals)
+                    len_queue += 1
+                end
+            elseif right_dist > 0
+                queue[queue_idx] = right_vals
+            else
+                deleteat!(queue, queue_idx)
+                len_queue -= 1
+            end

Determine new maximum queue value

julia
            queue_dist, queue_idx = !isempty(queue) ?
+                findmax(x -> x[4], queue) : (zero(Float64), 0)
+        elseif left_dist > right_dist  # use left value as next value to add to results
+            push!(queue, right_vals)  # add right value to queue
+            len_queue += 1
+            if right_dist > queue_dist
+                queue_dist = right_dist
+                queue_idx = len_queue
+            end
+            start_idx, max_idx, end_idx, max_dist = left_vals
+        else  # use right value as next value to add to results
+            push!(queue, left_vals)  # add left value to queue
+            len_queue += 1
+            if left_dist > queue_dist
+                queue_dist = left_dist
+                queue_idx = len_queue
+            end
+            start_idx, max_idx, end_idx, max_dist = right_vals
+        end
+    end
+    sorted_results = sort!(@view results[1:i])
+    if !preserve_endpoint && i > 3

Check start/endpoint distance to other points to see if it meets criteria

julia
        pre_pt, post_pt = points[sorted_results[end - 1]], points[sorted_results[2]]
+        endpt_dist = _squared_distance_line(Float64, points[1], pre_pt, post_pt)
+        if !isnothing(alg.tol)

Remove start point and replace with second point

julia
            if endpt_dist < max_tol
+                results[i] = results[2]
+                sorted_results = @view results[2:i]
+            end
+        else

Remove start point and add point with maximum distance still remaining

julia
            if endpt_dist < max_dist
+                insert!(results, searchsortedfirst(sorted_results, max_idx), max_idx)
+                results[i+1] = results[2]
+                sorted_results = @view results[2:i+1]
+            end
+        end
+    end
+    return points[sorted_results]
+end
+
+#= find maximum distance of any point between the start_idx and end_idx to the line formed
+by connecting the points at start_idx and end_idx. Note that the first index of maximum
+value will be used, which might cause differences in results from other algorithms.=#
+function _find_max_squared_dist(points, start_idx, end_idx)
+    max_idx = start_idx
+    max_dist = zero(Float64)
+    for i in (start_idx + 1):(end_idx - 1)
+        d = _squared_distance_line(Float64, points[i], points[start_idx], points[end_idx])
+        if d > max_dist
+            max_dist = d
+            max_idx = i
+        end
+    end
+    return max_idx, max_dist
+end

Simplify with VisvalingamWhyatt Algorithm

julia
"""
+    VisvalingamWhyatt <: SimplifyAlg
+
+    VisvalingamWhyatt(; kw...)
+
+Simplifies geometries by removing points below \`tol\`
+distance from the line between its neighboring points.
+
+$SIMPLIFY_ALG_KEYWORDS
+- \`tol\`: the minimum area of a triangle made with a point and
+    its neighboring points.
+Note: user input \`tol\` is doubled to avoid unnecessary computation in algorithm.
+"""
+@kwdef struct VisvalingamWhyatt <: SimplifyAlg
+    number::Union{Int,Nothing} = nothing
+    ratio::Union{Float64,Nothing} = nothing
+    tol::Union{Float64,Nothing} = nothing
+
+    function VisvalingamWhyatt(number, ratio, tol)
+        _checkargs(number, ratio, tol)

double tolerance for reduced computation

julia
        tol = isnothing(tol) ? tol : tol*2
+        return new(number, ratio, tol)
+    end
+end
+
+function _simplify(alg::VisvalingamWhyatt, points::Vector, _)
+    length(points) <= MIN_POINTS && return points
+    areas = _build_tolerances(_triangle_double_area, points)
+    return _get_points(alg, points, areas)
+end

Calculates double the area of a triangle given its vertices

julia
_triangle_double_area(p1, p2, p3) =
+    abs(p1[1] * (p2[2] - p3[2]) + p2[1] * (p3[2] - p1[2]) + p3[1] * (p1[2] - p2[2]))

Shared utils

julia
function _build_tolerances(f, points)
+    nmax = length(points)
+    real_tolerances = _flat_tolerances(f, points)
+
+    tolerances = copy(real_tolerances)
+    i = [n for n in 1:nmax]
+
+    this_tolerance, min_vert = findmin(tolerances)
+    _remove!(tolerances, min_vert)
+    deleteat!(i, min_vert)
+
+    while this_tolerance < Inf
+        skip = false
+
+        if min_vert < length(i)
+            right_tolerance = f(
+                points[i[min_vert - 1]],
+                points[i[min_vert]],
+                points[i[min_vert + 1]],
+            )
+            if right_tolerance <= this_tolerance
+                right_tolerance = this_tolerance
+                skip = min_vert == 1
+            end
+
+            real_tolerances[i[min_vert]] = right_tolerance
+            tolerances[min_vert] = right_tolerance
+        end
+
+        if min_vert > 2
+            left_tolerance = f(
+                points[i[min_vert - 2]],
+                points[i[min_vert - 1]],
+                points[i[min_vert]],
+            )
+            if left_tolerance <= this_tolerance
+                left_tolerance = this_tolerance
+                skip = min_vert == 2
+            end
+            real_tolerances[i[min_vert - 1]] = left_tolerance
+            tolerances[min_vert - 1] = left_tolerance
+        end
+
+        if !skip
+            min_vert = argmin(tolerances)
+        end
+        deleteat!(i, min_vert)
+        this_tolerance = tolerances[min_vert]
+        _remove!(tolerances, min_vert)
+    end
+
+    return real_tolerances
+end
+
+function tuple_points(geom)
+    points = Array{Tuple{Float64,Float64}}(undef, GI.npoint(geom))
+    for (i, p) in enumerate(GI.getpoint(geom))
+        points[i] = (GI.x(p), GI.y(p))
+    end
+    return points
+end
+
+function _get_points(alg, points, tolerances)
+    # This assumes that \`alg\` has the properties
+    # \`tol\`, \`number\`, and \`ratio\` available...
+    tol = alg.tol
+    number = alg.number
+    ratio = alg.ratio
+    bit_indices = if !isnothing(tol)
+        _tol_indices(alg.tol::Float64, points, tolerances)
+    elseif !isnothing(number)
+        _number_indices(alg.number::Int64, points, tolerances)
+    else
+        _ratio_indices(alg.ratio::Float64, points, tolerances)
+    end
+    return points[bit_indices]
+end
+
+function _tol_indices(tol, points, tolerances)
+    tolerances .>= tol
+end
+
+function _number_indices(n, points, tolerances)
+    tol = partialsort(tolerances, length(points) - n + 1)
+    bit_indices = _tol_indices(tol, points, tolerances)
+    nselected = sum(bit_indices)
+    # If there are multiple values exactly at \`tol\` we will get
+    # the wrong output length. So we need to remove some.
+    while nselected > n
+        min_tol = Inf
+        min_i = 0
+        for i in eachindex(bit_indices)
+            bit_indices[i] || continue
+            if tolerances[i] < min_tol
+                min_tol = tolerances[i]
+                min_i = i
+            end
+        end
+        nselected -= 1
+        bit_indices[min_i] = false
+    end
+    return bit_indices
+end
+
+function _ratio_indices(r, points, tolerances)
+    n = max(3, round(Int, r * length(points)))
+    return _number_indices(n, points, tolerances)
+end
+
+function _flat_tolerances(f, points)::Vector{Float64}
+    result = Vector{Float64}(undef, length(points))
+    result[1] = result[end] = Inf
+
+    for i in 2:length(result) - 1
+        result[i] = f(points[i-1], points[i], points[i+1])
+    end
+    return result
+end
+
+function _remove!(s, i)
+    for j in i:lastindex(s)-1
+        s[j] = s[j+1]
+    end
+end

Check SimplifyAlgs inputs to make sure they are valid for below algorithms

julia
function _checkargs(number, ratio, tol)
+    count(isnothing, (number, ratio, tol)) == 2 ||
+        error("Must provide one of \`number\`, \`ratio\` or \`tol\` keywords")
+    if !isnothing(number)
+        if number < MIN_POINTS
+            error("\`number\` must be $MIN_POINTS or larger. Got $number")
+        end
+    elseif !isnothing(ratio)
+        if ratio <= 0 || ratio > 1
+            error("\`ratio\` must be 0 < ratio <= 1. Got $ratio")
+        end
+    else  # !isnothing(tol)
+        if tol  0
+            error("\`tol\` must be a positive number. Got $tol")
+        end
+    end
+    return nothing
+end

This page was generated using Literate.jl.

`,71)]))}const C=i(e,[["render",E]]);export{c as __pageData,C as default}; diff --git a/previews/PR237/assets/source_transformations_simplify.md.Bjsi40yW.lean.js b/previews/PR237/assets/source_transformations_simplify.md.Bjsi40yW.lean.js new file mode 100644 index 000000000..6f6512a8d --- /dev/null +++ b/previews/PR237/assets/source_transformations_simplify.md.Bjsi40yW.lean.js @@ -0,0 +1,490 @@ +import{_ as i,c as a,a5 as n,o as h}from"./chunks/framework.Cq8AuEls.js";const l="/GeometryOps.jl/previews/PR237/assets/ttyjkgn.Bglvb-jp.png",k="/GeometryOps.jl/previews/PR237/assets/cmuiohu.B94PsR1K.png",t="/GeometryOps.jl/previews/PR237/assets/hrgkwjx.eNayRHGS.png",p="/GeometryOps.jl/previews/PR237/assets/nicwgxr.DmInwsY_.png",c=JSON.parse('{"title":"Geometry simplification","description":"","frontmatter":{},"headers":[],"relativePath":"source/transformations/simplify.md","filePath":"source/transformations/simplify.md","lastUpdated":null}'),e={name:"source/transformations/simplify.md"};function E(r,s,d,g,y,F){return h(),a("div",null,s[0]||(s[0]=[n(`

Geometry simplification

This file holds implementations for the RadialDistance, Douglas-Peucker, and Visvalingam-Whyatt algorithms for simplifying geometries (specifically for polygons and lines).

The GEOS extension also allows for GEOS's topology preserving simplification as well as Douglas-Peucker simplification implemented in GEOS. Call this by passing GEOS(; method = :TopologyPreserve) or GEOS(; method = :DouglasPeucker) to the algorithm.

Examples

A quick and dirty example is:

julia
using Makie, GeoInterfaceMakie
+import GeoInterface as GI
+import GeometryOps as GO
+
+original = GI.Polygon([[[-70.603637, -33.399918], [-70.614624, -33.395332], [-70.639343, -33.392466], [-70.659942, -33.394759], [-70.683975, -33.404504], [-70.697021, -33.419406], [-70.701141, -33.434306], [-70.700454, -33.446339], [-70.694274, -33.458369], [-70.682601, -33.465816], [-70.668869, -33.472117], [-70.646209, -33.473835], [-70.624923, -33.472117], [-70.609817, -33.468107], [-70.595397, -33.458369], [-70.587158, -33.442901], [-70.587158, -33.426283], [-70.590591, -33.414248], [-70.594711, -33.406224], [-70.603637, -33.399918]]])
+
+simple = GO.simplify(original; number=6)
+
+f, a, p = poly(original; label = "Original")
+poly!(simple; label = "Simplified")
+axislegend(a)
+f

Benchmark

We benchmark these methods against LibGEOS's simplify implementation, which uses the Douglas-Peucker algorithm.

julia
using BenchmarkTools, Chairmarks, GeoJSON, CairoMakie
+import GeometryOps as GO, LibGEOS as LG, GeoInterface as GI
+using CoordinateTransformations
+using NaturalEarth
+lg_and_go(geometry) = (GI.convert(LG, geometry), GO.tuples(geometry))
+# Load in the Natural Earth admin GeoJSON, then extract the USA's geometry
+fc = NaturalEarth.naturalearth("admin_0_countries", 10)
+usa_multipoly = fc.geometry[findfirst(==("United States of America"), fc.NAME)] |> x -> GI.convert(LG, x) |> LG.makeValid |> GO.tuples
+include(joinpath(dirname(dirname(pathof(GO))), "test", "data", "polygon_generation.jl"))
+
+usa_poly = GI.getgeom(usa_multipoly, findmax(GO.area.(GI.getgeom(usa_multipoly)))[2]) # isolate the poly with the most area
+usa_centroid = GO.centroid(usa_poly)
+usa_reflected = GO.transform(Translation(usa_centroid...)  LinearMap(Makie.rotmatrix2d(π))  Translation((-).(usa_centroid)...), usa_poly)
+f, a, p = plot(usa_poly; label = "Original", axis = (; aspect = DataAspect()))#; plot!(usa_reflected; label = "Reflected")

This is the complex polygon we'll be benchmarking.

julia
simplify_suite = BenchmarkGroup(["Simplify"])
+singlepoly_suite = BenchmarkGroup(["Polygon", "title:Polygon simplify", "subtitle:Random blob"])
+
+include(joinpath(dirname(dirname(pathof(GO))), "test", "data", "polygon_generation.jl"))
+
+for n_verts in round.(Int, exp10.(LinRange(log10(10), log10(10_000), 10)))
+    geom = GI.Wrappers.Polygon(generate_random_poly(0, 0, n_verts, 2, 0.2, 0.3))
+    geom_lg, geom_go = lg_and_go(LG.makeValid(GI.convert(LG, geom)))
+    singlepoly_suite["GO-DP"][GI.npoint(geom)] = @be GO.simplify($geom_go; tol = 0.1) seconds=1
+    singlepoly_suite["GO-VW"][GI.npoint(geom)] = @be GO.simplify($(GO.VisvalingamWhyatt(; tol = 0.1)), $geom_go) seconds=1
+    singlepoly_suite["GO-RD"][GI.npoint(geom)] = @be GO.simplify($(GO.RadialDistance(; tol = 0.1)), $geom_go) seconds=1
+    singlepoly_suite["LibGEOS"][GI.npoint(geom)] = @be LG.simplify($geom_lg, 0.1) seconds=1
+end
+
+plot_trials(singlepoly_suite; legend_position=(1, 1, TopRight()), legend_valign = -2, legend_halign = 1.2, legend_orientation = :horizontal)

julia
multipoly_suite = BenchmarkGroup(["MultiPolygon", "title:Multipolygon simplify", "subtitle:USA multipolygon"])
+
+for frac in exp10.(LinRange(log10(0.3), log10(1), 6)) # TODO: this example isn't the best.  How can we get this better?
+    geom = GO.simplify(usa_multipoly; ratio = frac)
+    geom_lg, geom_go = lg_and_go(geom)
+    _tol = 0.001
+    multipoly_suite["GO-DP"][GI.npoint(geom)] = @be GO.simplify($geom_go; tol = $_tol) seconds=1
+    # multipoly_suite["GO-VW"][GI.npoint(geom)] = @be GO.simplify($(GO.VisvalingamWhyatt(; tol = $_tol)), $geom_go) seconds=1
+    multipoly_suite["GO-RD"][GI.npoint(geom)] = @be GO.simplify($(GO.RadialDistance(; tol = _tol)), $geom_go) seconds=1
+    multipoly_suite["LibGEOS"][GI.npoint(geom)] = @be LG.simplify($geom_lg, $_tol) seconds=1
+    println("""
+    For $(GI.npoint(geom)) points, the algorithms generated polygons with the following number of vertices:
+    GO-DP : $(GI.npoint( GO.simplify(geom_go; tol = _tol)))
+    GO-RD : $(GI.npoint( GO.simplify((GO.RadialDistance(; tol = _tol)), geom_go)))
+    LGeos : $(GI.npoint( LG.simplify(geom_lg, _tol)))
+    """)
+    # GO-VW : $(GI.npoint( GO.simplify((GO.VisvalingamWhyatt(; tol = _tol)), geom_go)))
+    println()
+end
+plot_trials(multipoly_suite)

julia
export simplify, VisvalingamWhyatt, DouglasPeucker, RadialDistance
+
+const _SIMPLIFY_TARGET = TraitTarget{Union{GI.PolygonTrait, GI.AbstractCurveTrait, GI.MultiPointTrait, GI.PointTrait}}()
+const MIN_POINTS = 3
+const SIMPLIFY_ALG_KEYWORDS = """
+# Keywords
+
+- \`ratio\`: the fraction of points that should remain after \`simplify\`.
+    Useful as it will generalise for large collections of objects.
+- \`number\`: the number of points that should remain after \`simplify\`.
+    Less useful for large collections of mixed size objects.
+"""
+const DOUGLAS_PEUCKER_KEYWORDS = """
+$SIMPLIFY_ALG_KEYWORDS
+- \`tol\`: the minimum distance a point will be from the line
+    joining its neighboring points.
+"""
+
+"""
+    abstract type SimplifyAlg
+
+Abstract type for simplification algorithms.
+
+# API
+
+For now, the algorithm must hold the \`number\`, \`ratio\` and \`tol\` properties.
+
+Simplification algorithm types can hook into the interface by implementing
+the \`_simplify(trait, alg, geom)\` methods for whichever traits are necessary.
+"""
+abstract type SimplifyAlg end
+
+"""
+    simplify(obj; kw...)
+    simplify(::SimplifyAlg, obj; kw...)
+
+Simplify a geometry, feature, feature collection,
+or nested vectors or a table of these.
+
+\`RadialDistance\`, \`DouglasPeucker\`, or
+\`VisvalingamWhyatt\` algorithms are available,
+listed in order of increasing quality but decreasing performance.
+
+\`PoinTrait\` and \`MultiPointTrait\` are returned unchanged.
+
+The default behaviour is \`simplify(DouglasPeucker(; kw...), obj)\`.
+Pass in other \`SimplifyAlg\` to use other algorithms.

Keywords

julia
- \`prefilter_alg\`: \`SimplifyAlg\` algorithm used to pre-filter object before
+    using primary filtering algorithm.
+$APPLY_KEYWORDS
+
+
+Keywords for DouglasPeucker are allowed when no algorithm is specified:
+
+$DOUGLAS_PEUCKER_KEYWORDS

Example

julia
Simplify a polygon to have six points:
+
+\`\`\`jldoctest
+import GeoInterface as GI
+import GeometryOps as GO
+
+poly = GI.Polygon([[
+    [-70.603637, -33.399918],
+    [-70.614624, -33.395332],
+    [-70.639343, -33.392466],
+    [-70.659942, -33.394759],
+    [-70.683975, -33.404504],
+    [-70.697021, -33.419406],
+    [-70.701141, -33.434306],
+    [-70.700454, -33.446339],
+    [-70.694274, -33.458369],
+    [-70.682601, -33.465816],
+    [-70.668869, -33.472117],
+    [-70.646209, -33.473835],
+    [-70.624923, -33.472117],
+    [-70.609817, -33.468107],
+    [-70.595397, -33.458369],
+    [-70.587158, -33.442901],
+    [-70.587158, -33.426283],
+    [-70.590591, -33.414248],
+    [-70.594711, -33.406224],
+    [-70.603637, -33.399918]]])
+
+simple = GO.simplify(poly; number=6)
+GI.npoint(simple)

output

julia
6
+\`\`\`
+"""
+simplify(alg::SimplifyAlg, data; kw...) = _simplify(alg, data; kw...)
+simplify(alg::GEOS, data; kw...) = _simplify(alg, data; kw...)

Default algorithm is DouglasPeucker

julia
simplify(
+    data; prefilter_alg = nothing,
+    calc_extent=false, threaded=false, crs=nothing, kw...,
+ ) = _simplify(DouglasPeucker(; kw...), data; prefilter_alg, calc_extent, threaded, crs)
+
+
+#= For each algorithm, apply simplification to all curves, multipoints, and
+points, reconstructing everything else around them. =#
+function _simplify(alg::Union{SimplifyAlg, GEOS}, data; prefilter_alg=nothing, kw...)
+    simplifier(geom) = _simplify(GI.trait(geom), alg, geom; prefilter_alg)
+    return apply(simplifier, _SIMPLIFY_TARGET, data; kw...)
+end
+
+
+# For Point and MultiPoint traits we do nothing
+_simplify(::GI.PointTrait, alg, geom; kw...) = geom
+_simplify(::GI.MultiPointTrait, alg, geom; kw...) = geom
+
+# For curves, rings, and polygon we simplify
+function _simplify(
+    ::GI.AbstractCurveTrait, alg, geom;
+    prefilter_alg, preserve_endpoint = true,
+)
+    points = if isnothing(prefilter_alg)
+        tuple_points(geom)
+    else
+        _simplify(prefilter_alg, tuple_points(geom), preserve_endpoint)
+    end
+    return rebuild(geom, _simplify(alg, points, preserve_endpoint))
+end
+
+function _simplify(::GI.PolygonTrait, alg, geom;  kw...)
+    # Force treating children as LinearRing
+    simplifier(g) = _simplify(
+        GI.LinearRingTrait(), alg, g;
+        kw..., preserve_endpoint = false,
+    )
+    lrs = map(simplifier, GI.getgeom(geom))
+    return rebuild(geom, lrs)
+end

Simplify with RadialDistance Algorithm

julia
"""
+    RadialDistance <: SimplifyAlg
+
+Simplifies geometries by removing points less than
+\`tol\` distance from the line between its neighboring points.
+
+$SIMPLIFY_ALG_KEYWORDS
+- \`tol\`: the minimum distance between points.
+
+Note: user input \`tol\` is squared to avoid unnecessary computation in algorithm.
+"""
+@kwdef struct RadialDistance <: SimplifyAlg
+    number::Union{Int64,Nothing} = nothing
+    ratio::Union{Float64,Nothing} = nothing
+    tol::Union{Float64,Nothing} = nothing
+
+    function RadialDistance(number, ratio, tol)
+        _checkargs(number, ratio, tol)

square tolerance for reduced computation

julia
        tol = isnothing(tol) ? tol : tol^2
+        new(number, ratio, tol)
+    end
+end
+
+function _simplify(alg::RadialDistance, points::Vector, _)
+    previous = first(points)
+    distances = Array{Float64}(undef, length(points))
+    for i in eachindex(points)
+        point = points[i]
+        distances[i] = _squared_euclid_distance(Float64, point, previous)
+        previous = point
+    end
+    # Never remove the end points
+    distances[begin] = distances[end] = Inf
+    return _get_points(alg, points, distances)
+end

Simplify with DouglasPeucker Algorithm

julia
"""
+    DouglasPeucker <: SimplifyAlg
+
+    DouglasPeucker(; number, ratio, tol)
+
+Simplifies geometries by removing points below \`tol\`
+distance from the line between its neighboring points.
+
+$DOUGLAS_PEUCKER_KEYWORDS
+Note: user input \`tol\` is squared to avoid unnecessary computation in algorithm.
+"""
+@kwdef struct DouglasPeucker <: SimplifyAlg
+    number::Union{Int64,Nothing} = nothing
+    ratio::Union{Float64,Nothing} = nothing
+    tol::Union{Float64,Nothing} = nothing
+
+    function DouglasPeucker(number, ratio, tol)
+        _checkargs(number, ratio, tol)

square tolerance for reduced computation

julia
        tol = isnothing(tol) ? tol : tol^2
+        return new(number, ratio, tol)
+    end
+end
+
+#= Simplify using the DouglasPeucker algorithm - nice gif of process on wikipedia:
+(https://en.wikipedia.org/wiki/Ramer-Douglas-Peucker_algorithm). =#
+function _simplify(alg::DouglasPeucker, points::Vector, preserve_endpoint)
+    npoints = length(points)
+    npoints <= MIN_POINTS && return points

Determine stopping criteria

julia
    max_points = if !isnothing(alg.tol)
+        npoints
+    else
+        npts = !isnothing(alg.number) ? alg.number : max(3, round(Int, alg.ratio * npoints))
+        npts  npoints && return points
+        npts
+    end
+    max_tol = !isnothing(alg.tol) ? alg.tol : zero(Float64)

Set up queue

julia
    queue = Vector{Tuple{Int, Int, Int, Float64}}()
+    queue_idx, queue_dist = 0, zero(Float64)
+    len_queue = 0

Set up results vector

julia
    results = Vector{Int}(undef, max_points + (preserve_endpoint ? 0 : 1))
+    results[1], results[2] = 1, npoints

Loop through points until stopping criteria are fulfilled

julia
    i = 2  # already have first and last point added
+    start_idx, end_idx = 1, npoints
+    max_idx, max_dist = _find_max_squared_dist(points, start_idx, end_idx)
+    while i  min(MIN_POINTS + 1, max_points) || (i < max_points && max_dist > max_tol)

Add next point to results

julia
        i += 1
+        results[i] = max_idx

Determine which point to add next by checking left and right of point

julia
        left_idx, left_dist = _find_max_squared_dist(points, start_idx, max_idx)
+        right_idx, right_dist = _find_max_squared_dist(points, max_idx, end_idx)
+        left_vals = (start_idx, left_idx, max_idx, left_dist)
+        right_vals = (max_idx, right_idx, end_idx, right_dist)

Add and remove values from queue

julia
        if queue_dist > left_dist && queue_dist > right_dist

Value in queue is next value to add to results

julia
            start_idx, max_idx, end_idx, max_dist = queue[queue_idx]

Add left and/or right values to queue or delete used queue value

julia
            if left_dist > 0
+                queue[queue_idx] = left_vals
+                if right_dist > 0
+                    push!(queue, right_vals)
+                    len_queue += 1
+                end
+            elseif right_dist > 0
+                queue[queue_idx] = right_vals
+            else
+                deleteat!(queue, queue_idx)
+                len_queue -= 1
+            end

Determine new maximum queue value

julia
            queue_dist, queue_idx = !isempty(queue) ?
+                findmax(x -> x[4], queue) : (zero(Float64), 0)
+        elseif left_dist > right_dist  # use left value as next value to add to results
+            push!(queue, right_vals)  # add right value to queue
+            len_queue += 1
+            if right_dist > queue_dist
+                queue_dist = right_dist
+                queue_idx = len_queue
+            end
+            start_idx, max_idx, end_idx, max_dist = left_vals
+        else  # use right value as next value to add to results
+            push!(queue, left_vals)  # add left value to queue
+            len_queue += 1
+            if left_dist > queue_dist
+                queue_dist = left_dist
+                queue_idx = len_queue
+            end
+            start_idx, max_idx, end_idx, max_dist = right_vals
+        end
+    end
+    sorted_results = sort!(@view results[1:i])
+    if !preserve_endpoint && i > 3

Check start/endpoint distance to other points to see if it meets criteria

julia
        pre_pt, post_pt = points[sorted_results[end - 1]], points[sorted_results[2]]
+        endpt_dist = _squared_distance_line(Float64, points[1], pre_pt, post_pt)
+        if !isnothing(alg.tol)

Remove start point and replace with second point

julia
            if endpt_dist < max_tol
+                results[i] = results[2]
+                sorted_results = @view results[2:i]
+            end
+        else

Remove start point and add point with maximum distance still remaining

julia
            if endpt_dist < max_dist
+                insert!(results, searchsortedfirst(sorted_results, max_idx), max_idx)
+                results[i+1] = results[2]
+                sorted_results = @view results[2:i+1]
+            end
+        end
+    end
+    return points[sorted_results]
+end
+
+#= find maximum distance of any point between the start_idx and end_idx to the line formed
+by connecting the points at start_idx and end_idx. Note that the first index of maximum
+value will be used, which might cause differences in results from other algorithms.=#
+function _find_max_squared_dist(points, start_idx, end_idx)
+    max_idx = start_idx
+    max_dist = zero(Float64)
+    for i in (start_idx + 1):(end_idx - 1)
+        d = _squared_distance_line(Float64, points[i], points[start_idx], points[end_idx])
+        if d > max_dist
+            max_dist = d
+            max_idx = i
+        end
+    end
+    return max_idx, max_dist
+end

Simplify with VisvalingamWhyatt Algorithm

julia
"""
+    VisvalingamWhyatt <: SimplifyAlg
+
+    VisvalingamWhyatt(; kw...)
+
+Simplifies geometries by removing points below \`tol\`
+distance from the line between its neighboring points.
+
+$SIMPLIFY_ALG_KEYWORDS
+- \`tol\`: the minimum area of a triangle made with a point and
+    its neighboring points.
+Note: user input \`tol\` is doubled to avoid unnecessary computation in algorithm.
+"""
+@kwdef struct VisvalingamWhyatt <: SimplifyAlg
+    number::Union{Int,Nothing} = nothing
+    ratio::Union{Float64,Nothing} = nothing
+    tol::Union{Float64,Nothing} = nothing
+
+    function VisvalingamWhyatt(number, ratio, tol)
+        _checkargs(number, ratio, tol)

double tolerance for reduced computation

julia
        tol = isnothing(tol) ? tol : tol*2
+        return new(number, ratio, tol)
+    end
+end
+
+function _simplify(alg::VisvalingamWhyatt, points::Vector, _)
+    length(points) <= MIN_POINTS && return points
+    areas = _build_tolerances(_triangle_double_area, points)
+    return _get_points(alg, points, areas)
+end

Calculates double the area of a triangle given its vertices

julia
_triangle_double_area(p1, p2, p3) =
+    abs(p1[1] * (p2[2] - p3[2]) + p2[1] * (p3[2] - p1[2]) + p3[1] * (p1[2] - p2[2]))

Shared utils

julia
function _build_tolerances(f, points)
+    nmax = length(points)
+    real_tolerances = _flat_tolerances(f, points)
+
+    tolerances = copy(real_tolerances)
+    i = [n for n in 1:nmax]
+
+    this_tolerance, min_vert = findmin(tolerances)
+    _remove!(tolerances, min_vert)
+    deleteat!(i, min_vert)
+
+    while this_tolerance < Inf
+        skip = false
+
+        if min_vert < length(i)
+            right_tolerance = f(
+                points[i[min_vert - 1]],
+                points[i[min_vert]],
+                points[i[min_vert + 1]],
+            )
+            if right_tolerance <= this_tolerance
+                right_tolerance = this_tolerance
+                skip = min_vert == 1
+            end
+
+            real_tolerances[i[min_vert]] = right_tolerance
+            tolerances[min_vert] = right_tolerance
+        end
+
+        if min_vert > 2
+            left_tolerance = f(
+                points[i[min_vert - 2]],
+                points[i[min_vert - 1]],
+                points[i[min_vert]],
+            )
+            if left_tolerance <= this_tolerance
+                left_tolerance = this_tolerance
+                skip = min_vert == 2
+            end
+            real_tolerances[i[min_vert - 1]] = left_tolerance
+            tolerances[min_vert - 1] = left_tolerance
+        end
+
+        if !skip
+            min_vert = argmin(tolerances)
+        end
+        deleteat!(i, min_vert)
+        this_tolerance = tolerances[min_vert]
+        _remove!(tolerances, min_vert)
+    end
+
+    return real_tolerances
+end
+
+function tuple_points(geom)
+    points = Array{Tuple{Float64,Float64}}(undef, GI.npoint(geom))
+    for (i, p) in enumerate(GI.getpoint(geom))
+        points[i] = (GI.x(p), GI.y(p))
+    end
+    return points
+end
+
+function _get_points(alg, points, tolerances)
+    # This assumes that \`alg\` has the properties
+    # \`tol\`, \`number\`, and \`ratio\` available...
+    tol = alg.tol
+    number = alg.number
+    ratio = alg.ratio
+    bit_indices = if !isnothing(tol)
+        _tol_indices(alg.tol::Float64, points, tolerances)
+    elseif !isnothing(number)
+        _number_indices(alg.number::Int64, points, tolerances)
+    else
+        _ratio_indices(alg.ratio::Float64, points, tolerances)
+    end
+    return points[bit_indices]
+end
+
+function _tol_indices(tol, points, tolerances)
+    tolerances .>= tol
+end
+
+function _number_indices(n, points, tolerances)
+    tol = partialsort(tolerances, length(points) - n + 1)
+    bit_indices = _tol_indices(tol, points, tolerances)
+    nselected = sum(bit_indices)
+    # If there are multiple values exactly at \`tol\` we will get
+    # the wrong output length. So we need to remove some.
+    while nselected > n
+        min_tol = Inf
+        min_i = 0
+        for i in eachindex(bit_indices)
+            bit_indices[i] || continue
+            if tolerances[i] < min_tol
+                min_tol = tolerances[i]
+                min_i = i
+            end
+        end
+        nselected -= 1
+        bit_indices[min_i] = false
+    end
+    return bit_indices
+end
+
+function _ratio_indices(r, points, tolerances)
+    n = max(3, round(Int, r * length(points)))
+    return _number_indices(n, points, tolerances)
+end
+
+function _flat_tolerances(f, points)::Vector{Float64}
+    result = Vector{Float64}(undef, length(points))
+    result[1] = result[end] = Inf
+
+    for i in 2:length(result) - 1
+        result[i] = f(points[i-1], points[i], points[i+1])
+    end
+    return result
+end
+
+function _remove!(s, i)
+    for j in i:lastindex(s)-1
+        s[j] = s[j+1]
+    end
+end

Check SimplifyAlgs inputs to make sure they are valid for below algorithms

julia
function _checkargs(number, ratio, tol)
+    count(isnothing, (number, ratio, tol)) == 2 ||
+        error("Must provide one of \`number\`, \`ratio\` or \`tol\` keywords")
+    if !isnothing(number)
+        if number < MIN_POINTS
+            error("\`number\` must be $MIN_POINTS or larger. Got $number")
+        end
+    elseif !isnothing(ratio)
+        if ratio <= 0 || ratio > 1
+            error("\`ratio\` must be 0 < ratio <= 1. Got $ratio")
+        end
+    else  # !isnothing(tol)
+        if tol  0
+            error("\`tol\` must be a positive number. Got $tol")
+        end
+    end
+    return nothing
+end

This page was generated using Literate.jl.

`,71)]))}const C=i(e,[["render",E]]);export{c as __pageData,C as default}; diff --git a/previews/PR237/assets/source_transformations_transform.md.fQuX-Pz6.js b/previews/PR237/assets/source_transformations_transform.md.fQuX-Pz6.js new file mode 100644 index 000000000..e5d8ed798 --- /dev/null +++ b/previews/PR237/assets/source_transformations_transform.md.fQuX-Pz6.js @@ -0,0 +1,55 @@ +import{_ as i,c as a,a5 as n,o as t}from"./chunks/framework.Cq8AuEls.js";const F=JSON.parse('{"title":"Pointwise transformation","description":"","frontmatter":{},"headers":[],"relativePath":"source/transformations/transform.md","filePath":"source/transformations/transform.md","lastUpdated":null}'),l={name:"source/transformations/transform.md"};function e(p,s,h,r,k,o){return t(),a("div",null,s[0]||(s[0]=[n(`

Pointwise transformation

julia
"""
+    transform(f, obj)
+
+Apply a function \`f\` to all the points in \`obj\`.
+
+Points will be passed to \`f\` as an \`SVector\` to allow
+using CoordinateTransformations.jl and Rotations.jl
+without hassle.
+
+\`SVector\` is also a valid GeoInterface.jl point, so will
+work in all GeoInterface.jl methods.
+
+# Example
+
+\`\`\`julia
+julia> import GeoInterface as GI
+
+julia> import GeometryOps as GO
+
+julia> geom = GI.Polygon([GI.LinearRing([(1, 2), (3, 4), (5, 6), (1, 2)]), GI.LinearRing([(3, 4), (5, 6), (6, 7), (3, 4)])]);
+
+julia> f = CoordinateTransformations.Translation(3.5, 1.5)
+Translation(3.5, 1.5)
+
+julia> GO.transform(f, geom)
+GeoInterface.Wrappers.Polygon{false, false, Vector{GeoInterface.Wrappers.LinearRing{false, false, Vector{StaticArraysCore.SVector{2, Float64}}, Nothing, Nothing}}, Nothing, Nothing}(GeoInterface.Wrappers.Linea
+rRing{false, false, Vector{StaticArraysCore.SVector{2, Float64}}, Nothing, Nothing}[GeoInterface.Wrappers.LinearRing{false, false, Vector{StaticArraysCore.SVector{2, Float64}}, Nothing, Nothing}(StaticArraysCo
+re.SVector{2, Float64}[[4.5, 3.5], [6.5, 5.5], [8.5, 7.5], [4.5, 3.5]], nothing, nothing), GeoInterface.Wrappers.LinearRing{false, false, Vector{StaticArraysCore.SVector{2, Float64}}, Nothing, Nothing}(StaticA
+rraysCore.SVector{2, Float64}[[6.5, 5.5], [8.5, 7.5], [9.5, 8.5], [6.5, 5.5]], nothing, nothing)], nothing, nothing)
+\`\`\`
+
+With Rotations.jl you need to actually multiply the Rotation
+by the \`SVector\` point, which is easy using an anonymous function.
+
+\`\`\`julia
+julia> using Rotations
+
+julia> GO.transform(p -> one(RotMatrix{2}) * p, geom)
+GeoInterface.Wrappers.Polygon{false, false, Vector{GeoInterface.Wrappers.LinearRing{false, false, Vector{StaticArraysCore.SVector{2, Int64}}, Nothing, Nothing}}, Nothing, Nothing}(GeoInterface.Wrappers.LinearR
+ing{false, false, Vector{StaticArraysCore.SVector{2, Int64}}, Nothing, Nothing}[GeoInterface.Wrappers.LinearRing{false, false, Vector{StaticArraysCore.SVector{2, Int64}}, Nothing, Nothing}(StaticArraysCore.SVe
+ctor{2, Int64}[[2, 1], [4, 3], [6, 5], [2, 1]], nothing, nothing), GeoInterface.Wrappers.LinearRing{false, false, Vector{StaticArraysCore.SVector{2, Int64}}, Nothing, Nothing}(StaticArraysCore.SVector{2, Int64
+}[[4, 3], [6, 5], [7, 6], [4, 3]], nothing, nothing)], nothing, nothing)
+\`\`\`
+"""
+function transform(f, geom; kw...)
+    if _is3d(geom)
+        return apply(PointTrait(), geom; kw...) do p
+            f(StaticArrays.SVector{3}((GI.x(p), GI.y(p), GI.z(p))))
+        end
+    else
+        return apply(PointTrait(), geom; kw...) do p
+            f(StaticArrays.SVector{2}((GI.x(p), GI.y(p))))
+        end
+    end
+end

This page was generated using Literate.jl.

`,4)]))}const c=i(l,[["render",e]]);export{F as __pageData,c as default}; diff --git a/previews/PR237/assets/source_transformations_transform.md.fQuX-Pz6.lean.js b/previews/PR237/assets/source_transformations_transform.md.fQuX-Pz6.lean.js new file mode 100644 index 000000000..e5d8ed798 --- /dev/null +++ b/previews/PR237/assets/source_transformations_transform.md.fQuX-Pz6.lean.js @@ -0,0 +1,55 @@ +import{_ as i,c as a,a5 as n,o as t}from"./chunks/framework.Cq8AuEls.js";const F=JSON.parse('{"title":"Pointwise transformation","description":"","frontmatter":{},"headers":[],"relativePath":"source/transformations/transform.md","filePath":"source/transformations/transform.md","lastUpdated":null}'),l={name:"source/transformations/transform.md"};function e(p,s,h,r,k,o){return t(),a("div",null,s[0]||(s[0]=[n(`

Pointwise transformation

julia
"""
+    transform(f, obj)
+
+Apply a function \`f\` to all the points in \`obj\`.
+
+Points will be passed to \`f\` as an \`SVector\` to allow
+using CoordinateTransformations.jl and Rotations.jl
+without hassle.
+
+\`SVector\` is also a valid GeoInterface.jl point, so will
+work in all GeoInterface.jl methods.
+
+# Example
+
+\`\`\`julia
+julia> import GeoInterface as GI
+
+julia> import GeometryOps as GO
+
+julia> geom = GI.Polygon([GI.LinearRing([(1, 2), (3, 4), (5, 6), (1, 2)]), GI.LinearRing([(3, 4), (5, 6), (6, 7), (3, 4)])]);
+
+julia> f = CoordinateTransformations.Translation(3.5, 1.5)
+Translation(3.5, 1.5)
+
+julia> GO.transform(f, geom)
+GeoInterface.Wrappers.Polygon{false, false, Vector{GeoInterface.Wrappers.LinearRing{false, false, Vector{StaticArraysCore.SVector{2, Float64}}, Nothing, Nothing}}, Nothing, Nothing}(GeoInterface.Wrappers.Linea
+rRing{false, false, Vector{StaticArraysCore.SVector{2, Float64}}, Nothing, Nothing}[GeoInterface.Wrappers.LinearRing{false, false, Vector{StaticArraysCore.SVector{2, Float64}}, Nothing, Nothing}(StaticArraysCo
+re.SVector{2, Float64}[[4.5, 3.5], [6.5, 5.5], [8.5, 7.5], [4.5, 3.5]], nothing, nothing), GeoInterface.Wrappers.LinearRing{false, false, Vector{StaticArraysCore.SVector{2, Float64}}, Nothing, Nothing}(StaticA
+rraysCore.SVector{2, Float64}[[6.5, 5.5], [8.5, 7.5], [9.5, 8.5], [6.5, 5.5]], nothing, nothing)], nothing, nothing)
+\`\`\`
+
+With Rotations.jl you need to actually multiply the Rotation
+by the \`SVector\` point, which is easy using an anonymous function.
+
+\`\`\`julia
+julia> using Rotations
+
+julia> GO.transform(p -> one(RotMatrix{2}) * p, geom)
+GeoInterface.Wrappers.Polygon{false, false, Vector{GeoInterface.Wrappers.LinearRing{false, false, Vector{StaticArraysCore.SVector{2, Int64}}, Nothing, Nothing}}, Nothing, Nothing}(GeoInterface.Wrappers.LinearR
+ing{false, false, Vector{StaticArraysCore.SVector{2, Int64}}, Nothing, Nothing}[GeoInterface.Wrappers.LinearRing{false, false, Vector{StaticArraysCore.SVector{2, Int64}}, Nothing, Nothing}(StaticArraysCore.SVe
+ctor{2, Int64}[[2, 1], [4, 3], [6, 5], [2, 1]], nothing, nothing), GeoInterface.Wrappers.LinearRing{false, false, Vector{StaticArraysCore.SVector{2, Int64}}, Nothing, Nothing}(StaticArraysCore.SVector{2, Int64
+}[[4, 3], [6, 5], [7, 6], [4, 3]], nothing, nothing)], nothing, nothing)
+\`\`\`
+"""
+function transform(f, geom; kw...)
+    if _is3d(geom)
+        return apply(PointTrait(), geom; kw...) do p
+            f(StaticArrays.SVector{3}((GI.x(p), GI.y(p), GI.z(p))))
+        end
+    else
+        return apply(PointTrait(), geom; kw...) do p
+            f(StaticArrays.SVector{2}((GI.x(p), GI.y(p))))
+        end
+    end
+end

This page was generated using Literate.jl.

`,4)]))}const c=i(l,[["render",e]]);export{F as __pageData,c as default}; diff --git a/previews/PR237/assets/source_transformations_tuples.md.k24FH2eZ.js b/previews/PR237/assets/source_transformations_tuples.md.k24FH2eZ.js new file mode 100644 index 000000000..aacd3ec66 --- /dev/null +++ b/previews/PR237/assets/source_transformations_tuples.md.k24FH2eZ.js @@ -0,0 +1,19 @@ +import{_ as a,c as n,a5 as i,o as e}from"./chunks/framework.Cq8AuEls.js";const d=JSON.parse('{"title":"Tuple conversion","description":"","frontmatter":{},"headers":[],"relativePath":"source/transformations/tuples.md","filePath":"source/transformations/tuples.md","lastUpdated":null}'),t={name:"source/transformations/tuples.md"};function p(l,s,r,o,h,k){return e(),n("div",null,s[0]||(s[0]=[i(`

Tuple conversion

julia
"""
+    tuples(obj)
+
+Convert all points in \`obj\` to \`Tuple\`s, wherever the are nested.
+
+Returns a similar object or collection of objects using GeoInterface.jl
+geometries wrapping \`Tuple\` points.

Keywords

julia
$APPLY_KEYWORDS
+"""
+function tuples(geom, ::Type{T} = Float64; kw...) where T
+    if _is3d(geom)
+        return apply(PointTrait(), geom; kw...) do p
+            (T(GI.x(p)), T(GI.y(p)), T(GI.z(p)))
+        end
+    else
+        return apply(PointTrait(), geom; kw...) do p
+            (T(GI.x(p)), T(GI.y(p)))
+        end
+    end
+end

This page was generated using Literate.jl.

`,6)]))}const F=a(t,[["render",p]]);export{d as __pageData,F as default}; diff --git a/previews/PR237/assets/source_transformations_tuples.md.k24FH2eZ.lean.js b/previews/PR237/assets/source_transformations_tuples.md.k24FH2eZ.lean.js new file mode 100644 index 000000000..aacd3ec66 --- /dev/null +++ b/previews/PR237/assets/source_transformations_tuples.md.k24FH2eZ.lean.js @@ -0,0 +1,19 @@ +import{_ as a,c as n,a5 as i,o as e}from"./chunks/framework.Cq8AuEls.js";const d=JSON.parse('{"title":"Tuple conversion","description":"","frontmatter":{},"headers":[],"relativePath":"source/transformations/tuples.md","filePath":"source/transformations/tuples.md","lastUpdated":null}'),t={name:"source/transformations/tuples.md"};function p(l,s,r,o,h,k){return e(),n("div",null,s[0]||(s[0]=[i(`

Tuple conversion

julia
"""
+    tuples(obj)
+
+Convert all points in \`obj\` to \`Tuple\`s, wherever the are nested.
+
+Returns a similar object or collection of objects using GeoInterface.jl
+geometries wrapping \`Tuple\` points.

Keywords

julia
$APPLY_KEYWORDS
+"""
+function tuples(geom, ::Type{T} = Float64; kw...) where T
+    if _is3d(geom)
+        return apply(PointTrait(), geom; kw...) do p
+            (T(GI.x(p)), T(GI.y(p)), T(GI.z(p)))
+        end
+    else
+        return apply(PointTrait(), geom; kw...) do p
+            (T(GI.x(p)), T(GI.y(p)))
+        end
+    end
+end

This page was generated using Literate.jl.

`,6)]))}const F=a(t,[["render",p]]);export{d as __pageData,F as default}; diff --git a/previews/PR237/assets/source_types.md.CL-ODfd9.js b/previews/PR237/assets/source_types.md.CL-ODfd9.js new file mode 100644 index 000000000..11e41090d --- /dev/null +++ b/previews/PR237/assets/source_types.md.CL-ODfd9.js @@ -0,0 +1,38 @@ +import{_ as i,c as a,a5 as n,o as e}from"./chunks/framework.Cq8AuEls.js";const E=JSON.parse('{"title":"Types","description":"","frontmatter":{},"headers":[],"relativePath":"source/types.md","filePath":"source/types.md","lastUpdated":null}'),t={name:"source/types.md"};function l(h,s,p,k,r,d){return e(),a("div",null,s[0]||(s[0]=[n(`

Types

This file defines some fundamental types used in GeometryOps.

Warning

Unlike in other Julia packages, only some types are defined in this file, not all. This is because we define types in the files where they are used, to make it easier to understand the code.

julia
export GEOS

GEOS

GEOS is a struct which instructs the method it's passed to as an algorithm to use the appropriate GEOS function via LibGEOS.jl for the operation.

It's generally a lot slower than the native Julia implementations, but it's useful for two reasons:

  1. Functionality which doesn't exist in GeometryOps can be accessed through the GeometryOps API, but use GEOS in the backend until someone implements a native Julia version.

  2. It's a good way to test the correctness of the native implementations.

julia
"""
+    GEOS(; params...)
+
+A struct which instructs the method it's passed to as an algorithm
+to use the appropriate GEOS function via \`LibGEOS.jl\` for the operation.
+
+Dispatch is generally carried out using the names of the keyword arguments.
+For example, \`segmentize\` will only accept a \`GEOS\` struct with only a
+\`max_distance\` keyword, and no other.
+
+It's generally a lot slower than the native Julia implementations, since
+it must convert to the LibGEOS implementation and back - so be warned!
+"""
+struct GEOS
+    params::NamedTuple
+end
+
+function GEOS(; params...)
+    nt = NamedTuple(params)
+    return GEOS(nt)
+end

These are definitions for convenience, so we don't have to type out alg.params every time.

julia
Base.get(alg::GEOS, key, value) = Base.get(alg.params, key, value)
+Base.get(f::Function, alg::GEOS, key) = Base.get(f, alg.params, key)
+
+"""
+    enforce(alg::GO.GEOS, kw::Symbol, f)
+
+Enforce the presence of a keyword argument in a \`GEOS\` algorithm, and return \`alg.params[kw]\`.
+
+Throws an error if the key is not present, and mentions \`f\` in the error message (since there isn't
+a good way to get the name of the function that called this method).
+"""
+function enforce(alg::GEOS, kw::Symbol, f)
+    if haskey(alg.params, kw)
+        return alg.params[kw]
+    else
+        error("$(f) requires a \`$(kw)\` keyword argument to the \`GEOS\` algorithm, which was not provided.")
+    end
+end

This page was generated using Literate.jl.

`,13)]))}const g=i(t,[["render",l]]);export{E as __pageData,g as default}; diff --git a/previews/PR237/assets/source_types.md.CL-ODfd9.lean.js b/previews/PR237/assets/source_types.md.CL-ODfd9.lean.js new file mode 100644 index 000000000..11e41090d --- /dev/null +++ b/previews/PR237/assets/source_types.md.CL-ODfd9.lean.js @@ -0,0 +1,38 @@ +import{_ as i,c as a,a5 as n,o as e}from"./chunks/framework.Cq8AuEls.js";const E=JSON.parse('{"title":"Types","description":"","frontmatter":{},"headers":[],"relativePath":"source/types.md","filePath":"source/types.md","lastUpdated":null}'),t={name:"source/types.md"};function l(h,s,p,k,r,d){return e(),a("div",null,s[0]||(s[0]=[n(`

Types

This file defines some fundamental types used in GeometryOps.

Warning

Unlike in other Julia packages, only some types are defined in this file, not all. This is because we define types in the files where they are used, to make it easier to understand the code.

julia
export GEOS

GEOS

GEOS is a struct which instructs the method it's passed to as an algorithm to use the appropriate GEOS function via LibGEOS.jl for the operation.

It's generally a lot slower than the native Julia implementations, but it's useful for two reasons:

  1. Functionality which doesn't exist in GeometryOps can be accessed through the GeometryOps API, but use GEOS in the backend until someone implements a native Julia version.

  2. It's a good way to test the correctness of the native implementations.

julia
"""
+    GEOS(; params...)
+
+A struct which instructs the method it's passed to as an algorithm
+to use the appropriate GEOS function via \`LibGEOS.jl\` for the operation.
+
+Dispatch is generally carried out using the names of the keyword arguments.
+For example, \`segmentize\` will only accept a \`GEOS\` struct with only a
+\`max_distance\` keyword, and no other.
+
+It's generally a lot slower than the native Julia implementations, since
+it must convert to the LibGEOS implementation and back - so be warned!
+"""
+struct GEOS
+    params::NamedTuple
+end
+
+function GEOS(; params...)
+    nt = NamedTuple(params)
+    return GEOS(nt)
+end

These are definitions for convenience, so we don't have to type out alg.params every time.

julia
Base.get(alg::GEOS, key, value) = Base.get(alg.params, key, value)
+Base.get(f::Function, alg::GEOS, key) = Base.get(f, alg.params, key)
+
+"""
+    enforce(alg::GO.GEOS, kw::Symbol, f)
+
+Enforce the presence of a keyword argument in a \`GEOS\` algorithm, and return \`alg.params[kw]\`.
+
+Throws an error if the key is not present, and mentions \`f\` in the error message (since there isn't
+a good way to get the name of the function that called this method).
+"""
+function enforce(alg::GEOS, kw::Symbol, f)
+    if haskey(alg.params, kw)
+        return alg.params[kw]
+    else
+        error("$(f) requires a \`$(kw)\` keyword argument to the \`GEOS\` algorithm, which was not provided.")
+    end
+end

This page was generated using Literate.jl.

`,13)]))}const g=i(t,[["render",l]]);export{E as __pageData,g as default}; diff --git a/previews/PR237/assets/source_utils.md.DLZcNIzl.js b/previews/PR237/assets/source_utils.md.DLZcNIzl.js new file mode 100644 index 000000000..52b8273d1 --- /dev/null +++ b/previews/PR237/assets/source_utils.md.DLZcNIzl.js @@ -0,0 +1,120 @@ +import{_ as i,c as a,a5 as n,o as t}from"./chunks/framework.Cq8AuEls.js";const d=JSON.parse('{"title":"Utility functions","description":"","frontmatter":{},"headers":[],"relativePath":"source/utils.md","filePath":"source/utils.md","lastUpdated":null}'),p={name:"source/utils.md"};function l(h,s,k,e,r,F){return t(),a("div",null,s[0]||(s[0]=[n(`

Utility functions

julia
_is3d(geom)::Bool = _is3d(GI.trait(geom), geom)
+_is3d(::GI.AbstractGeometryTrait, geom)::Bool = GI.is3d(geom)
+_is3d(::GI.FeatureTrait, feature)::Bool = _is3d(GI.geometry(feature))
+_is3d(::GI.FeatureCollectionTrait, fc)::Bool = _is3d(GI.getfeature(fc, 1))
+_is3d(::Nothing, geom)::Bool = _is3d(first(geom)) # Otherwise step into an itererable
+
+_npoint(x) = _npoint(trait(x), x)
+_npoint(::Nothing, xs::AbstractArray) = sum(_npoint, xs)
+_npoint(::GI.FeatureCollectionTrait, fc) = sum(_npoint, GI.getfeature(fc))
+_npoint(::GI.FeatureTrait, f) = _npoint(GI.geometry(f))
+_npoint(::GI.AbstractGeometryTrait, x) = GI.npoint(trait(x), x)
+
+_nedge(x) = _nedge(trait(x), x)
+_nedge(::Nothing, xs::AbstractArray) = sum(_nedge, xs)
+_nedge(::GI.FeatureCollectionTrait, fc) = sum(_nedge, GI.getfeature(fc))
+_nedge(::GI.FeatureTrait, f) = _nedge(GI.geometry(f))
+function _nedge(::GI.AbstractGeometryTrait, x)
+    n = 0
+    for g in GI.getgeom(x)
+        n += _nedge(g)
+    end
+    return n
+end
+_nedge(::GI.AbstractCurveTrait, x) = GI.npoint(x) - 1
+_nedge(::GI.PointTrait, x) = error("Cant get edges from points")
+
+
+"""
+    polygon_to_line(poly::Polygon)
+
+Converts a Polygon to LineString or MultiLineString

Examples

julia
\`\`\`jldoctest
+import GeometryOps as GO, GeoInterface as GI
+
+poly = GI.Polygon([[(-2.275543, 53.464547), (-2.275543, 53.489271), (-2.215118, 53.489271), (-2.215118, 53.464547), (-2.275543, 53.464547)]])
+GO.polygon_to_line(poly)

output

julia
GeoInterface.Wrappers.LineString{false, false, Vector{Tuple{Float64, Float64}}, Nothing, Nothing}([(-2.275543, 53.464547), (-2.275543, 53.489271), (-2.215118, 53.489271), (-2.215118, 53.464547), (-2.275543, 53.464547)], nothing, nothing)
+\`\`\`
+"""
+function polygon_to_line(poly)
+    @assert GI.trait(poly) isa PolygonTrait
+    GI.ngeom(poly) > 1 && return GI.MultiLineString(collect(GI.getgeom(poly)))
+    return GI.LineString(collect(GI.getgeom(GI.getgeom(poly, 1))))
+end
+
+
+"""
+    to_edges()
+
+Convert any geometry or collection of geometries into a flat
+vector of \`Tuple{Tuple{Float64,Float64},Tuple{Float64,Float64}}\` edges.
+"""
+function to_edges(x, ::Type{T} = Float64) where T
+    edges = Vector{Edge{T}}(undef, _nedge(x))
+    _to_edges!(edges, x, 1)
+    return edges
+end
+
+_to_edges!(edges::Vector, x, n) = _to_edges!(edges, trait(x), x, n)
+function _to_edges!(edges::Vector, ::GI.FeatureCollectionTrait, fc, n)
+    for f in GI.getfeature(fc)
+        n = _to_edges!(edges, f, n)
+    end
+end
+_to_edges!(edges::Vector, ::GI.FeatureTrait, f, n) = _to_edges!(edges, GI.geometry(f), n)
+function _to_edges!(edges::Vector, ::GI.AbstractGeometryTrait, fc, n)
+    for f in GI.getgeom(fc)
+        n = _to_edges!(edges, f, n)
+    end
+end
+function _to_edges!(edges::Vector, ::GI.AbstractCurveTrait, geom, n)
+    p1 = GI.getpoint(geom, 1)
+    p1x, p1y = GI.x(p1), GI.y(p1)
+    for i in 2:GI.npoint(geom)
+        p2 = GI.getpoint(geom, i)
+        p2x, p2y = GI.x(p2), GI.y(p2)
+        edges[n] = (p1x, p1y), (p2x, p2y)
+        p1x, p1y = p2x, p2y
+        n += 1
+    end
+    return n
+end
+
+_tuple_point(p) = GI.x(p), GI.y(p)
+_tuple_point(p, ::Type{T}) where T = T(GI.x(p)), T(GI.y(p))
+
+function to_extent(edges::Vector{Edge})
+    x, y = extrema(first, edges)
+    Extents.Extent(X=x, Y=y)
+end
+
+function to_points(x, ::Type{T} = Float64) where T
+    points = Vector{TuplePoint{T}}(undef, _npoint(x))
+    _to_points!(points, x, 1)
+    return points
+end
+
+_to_points!(points::Vector, x, n) = _to_points!(points, trait(x), x, n)
+function _to_points!(points::Vector, ::FeatureCollectionTrait, fc, n)
+    for f in GI.getfeature(fc)
+        n = _to_points!(points, f, n)
+    end
+end
+_to_points!(points::Vector, ::FeatureTrait, f, n) = _to_points!(points, GI.geometry(f), n)
+function _to_points!(points::Vector, ::AbstractGeometryTrait, fc, n)
+    for f in GI.getgeom(fc)
+        n = _to_points!(points, f, n)
+    end
+end
+function _to_points!(points::Vector, ::Union{AbstractCurveTrait,MultiPointTrait}, geom, n)
+    n = 0
+    for p in GI.getpoint(geom)
+        n += 1
+        points[n] = _tuple_point(p)
+    end
+    return n
+end
+
+function _point_in_extent(p, extent::Extents.Extent)
+    (x1, x2), (y1, y2) = extent.X, extent.Y
+    return x1 ≤ GI.x(p) ≤ x2 && y1 ≤ GI.y(p) ≤ y2
+end

This page was generated using Literate.jl.

`,8)]))}const E=i(p,[["render",l]]);export{d as __pageData,E as default}; diff --git a/previews/PR237/assets/source_utils.md.DLZcNIzl.lean.js b/previews/PR237/assets/source_utils.md.DLZcNIzl.lean.js new file mode 100644 index 000000000..52b8273d1 --- /dev/null +++ b/previews/PR237/assets/source_utils.md.DLZcNIzl.lean.js @@ -0,0 +1,120 @@ +import{_ as i,c as a,a5 as n,o as t}from"./chunks/framework.Cq8AuEls.js";const d=JSON.parse('{"title":"Utility functions","description":"","frontmatter":{},"headers":[],"relativePath":"source/utils.md","filePath":"source/utils.md","lastUpdated":null}'),p={name:"source/utils.md"};function l(h,s,k,e,r,F){return t(),a("div",null,s[0]||(s[0]=[n(`

Utility functions

julia
_is3d(geom)::Bool = _is3d(GI.trait(geom), geom)
+_is3d(::GI.AbstractGeometryTrait, geom)::Bool = GI.is3d(geom)
+_is3d(::GI.FeatureTrait, feature)::Bool = _is3d(GI.geometry(feature))
+_is3d(::GI.FeatureCollectionTrait, fc)::Bool = _is3d(GI.getfeature(fc, 1))
+_is3d(::Nothing, geom)::Bool = _is3d(first(geom)) # Otherwise step into an itererable
+
+_npoint(x) = _npoint(trait(x), x)
+_npoint(::Nothing, xs::AbstractArray) = sum(_npoint, xs)
+_npoint(::GI.FeatureCollectionTrait, fc) = sum(_npoint, GI.getfeature(fc))
+_npoint(::GI.FeatureTrait, f) = _npoint(GI.geometry(f))
+_npoint(::GI.AbstractGeometryTrait, x) = GI.npoint(trait(x), x)
+
+_nedge(x) = _nedge(trait(x), x)
+_nedge(::Nothing, xs::AbstractArray) = sum(_nedge, xs)
+_nedge(::GI.FeatureCollectionTrait, fc) = sum(_nedge, GI.getfeature(fc))
+_nedge(::GI.FeatureTrait, f) = _nedge(GI.geometry(f))
+function _nedge(::GI.AbstractGeometryTrait, x)
+    n = 0
+    for g in GI.getgeom(x)
+        n += _nedge(g)
+    end
+    return n
+end
+_nedge(::GI.AbstractCurveTrait, x) = GI.npoint(x) - 1
+_nedge(::GI.PointTrait, x) = error("Cant get edges from points")
+
+
+"""
+    polygon_to_line(poly::Polygon)
+
+Converts a Polygon to LineString or MultiLineString

Examples

julia
\`\`\`jldoctest
+import GeometryOps as GO, GeoInterface as GI
+
+poly = GI.Polygon([[(-2.275543, 53.464547), (-2.275543, 53.489271), (-2.215118, 53.489271), (-2.215118, 53.464547), (-2.275543, 53.464547)]])
+GO.polygon_to_line(poly)

output

julia
GeoInterface.Wrappers.LineString{false, false, Vector{Tuple{Float64, Float64}}, Nothing, Nothing}([(-2.275543, 53.464547), (-2.275543, 53.489271), (-2.215118, 53.489271), (-2.215118, 53.464547), (-2.275543, 53.464547)], nothing, nothing)
+\`\`\`
+"""
+function polygon_to_line(poly)
+    @assert GI.trait(poly) isa PolygonTrait
+    GI.ngeom(poly) > 1 && return GI.MultiLineString(collect(GI.getgeom(poly)))
+    return GI.LineString(collect(GI.getgeom(GI.getgeom(poly, 1))))
+end
+
+
+"""
+    to_edges()
+
+Convert any geometry or collection of geometries into a flat
+vector of \`Tuple{Tuple{Float64,Float64},Tuple{Float64,Float64}}\` edges.
+"""
+function to_edges(x, ::Type{T} = Float64) where T
+    edges = Vector{Edge{T}}(undef, _nedge(x))
+    _to_edges!(edges, x, 1)
+    return edges
+end
+
+_to_edges!(edges::Vector, x, n) = _to_edges!(edges, trait(x), x, n)
+function _to_edges!(edges::Vector, ::GI.FeatureCollectionTrait, fc, n)
+    for f in GI.getfeature(fc)
+        n = _to_edges!(edges, f, n)
+    end
+end
+_to_edges!(edges::Vector, ::GI.FeatureTrait, f, n) = _to_edges!(edges, GI.geometry(f), n)
+function _to_edges!(edges::Vector, ::GI.AbstractGeometryTrait, fc, n)
+    for f in GI.getgeom(fc)
+        n = _to_edges!(edges, f, n)
+    end
+end
+function _to_edges!(edges::Vector, ::GI.AbstractCurveTrait, geom, n)
+    p1 = GI.getpoint(geom, 1)
+    p1x, p1y = GI.x(p1), GI.y(p1)
+    for i in 2:GI.npoint(geom)
+        p2 = GI.getpoint(geom, i)
+        p2x, p2y = GI.x(p2), GI.y(p2)
+        edges[n] = (p1x, p1y), (p2x, p2y)
+        p1x, p1y = p2x, p2y
+        n += 1
+    end
+    return n
+end
+
+_tuple_point(p) = GI.x(p), GI.y(p)
+_tuple_point(p, ::Type{T}) where T = T(GI.x(p)), T(GI.y(p))
+
+function to_extent(edges::Vector{Edge})
+    x, y = extrema(first, edges)
+    Extents.Extent(X=x, Y=y)
+end
+
+function to_points(x, ::Type{T} = Float64) where T
+    points = Vector{TuplePoint{T}}(undef, _npoint(x))
+    _to_points!(points, x, 1)
+    return points
+end
+
+_to_points!(points::Vector, x, n) = _to_points!(points, trait(x), x, n)
+function _to_points!(points::Vector, ::FeatureCollectionTrait, fc, n)
+    for f in GI.getfeature(fc)
+        n = _to_points!(points, f, n)
+    end
+end
+_to_points!(points::Vector, ::FeatureTrait, f, n) = _to_points!(points, GI.geometry(f), n)
+function _to_points!(points::Vector, ::AbstractGeometryTrait, fc, n)
+    for f in GI.getgeom(fc)
+        n = _to_points!(points, f, n)
+    end
+end
+function _to_points!(points::Vector, ::Union{AbstractCurveTrait,MultiPointTrait}, geom, n)
+    n = 0
+    for p in GI.getpoint(geom)
+        n += 1
+        points[n] = _tuple_point(p)
+    end
+    return n
+end
+
+function _point_in_extent(p, extent::Extents.Extent)
+    (x1, x2), (y1, y2) = extent.X, extent.Y
+    return x1 ≤ GI.x(p) ≤ x2 && y1 ≤ GI.y(p) ≤ y2
+end

This page was generated using Literate.jl.

`,8)]))}const E=i(p,[["render",l]]);export{d as __pageData,E as default}; diff --git a/previews/PR237/assets/style.BK3-A7nA.css b/previews/PR237/assets/style.BK3-A7nA.css new file mode 100644 index 000000000..18c0e3f47 --- /dev/null +++ b/previews/PR237/assets/style.BK3-A7nA.css @@ -0,0 +1 @@ +@import"https://fonts.googleapis.com/css?family=Space+Mono:regular,italic,700,700italic";@import"https://fonts.googleapis.com/css?family=Space+Grotesk:regular,italic,700,700italic";@font-face{font-family:Inter;font-style:normal;font-weight:100 900;font-display:swap;src:url(/GeometryOps.jl/previews/PR237/assets/inter-roman-cyrillic-ext.BBPuwvHQ.woff2) format("woff2");unicode-range:U+0460-052F,U+1C80-1C88,U+20B4,U+2DE0-2DFF,U+A640-A69F,U+FE2E-FE2F}@font-face{font-family:Inter;font-style:normal;font-weight:100 900;font-display:swap;src:url(/GeometryOps.jl/previews/PR237/assets/inter-roman-cyrillic.C5lxZ8CY.woff2) format("woff2");unicode-range:U+0301,U+0400-045F,U+0490-0491,U+04B0-04B1,U+2116}@font-face{font-family:Inter;font-style:normal;font-weight:100 900;font-display:swap;src:url(/GeometryOps.jl/previews/PR237/assets/inter-roman-greek-ext.CqjqNYQ-.woff2) format("woff2");unicode-range:U+1F00-1FFF}@font-face{font-family:Inter;font-style:normal;font-weight:100 900;font-display:swap;src:url(/GeometryOps.jl/previews/PR237/assets/inter-roman-greek.BBVDIX6e.woff2) format("woff2");unicode-range:U+0370-0377,U+037A-037F,U+0384-038A,U+038C,U+038E-03A1,U+03A3-03FF}@font-face{font-family:Inter;font-style:normal;font-weight:100 900;font-display:swap;src:url(/GeometryOps.jl/previews/PR237/assets/inter-roman-vietnamese.BjW4sHH5.woff2) format("woff2");unicode-range:U+0102-0103,U+0110-0111,U+0128-0129,U+0168-0169,U+01A0-01A1,U+01AF-01B0,U+0300-0301,U+0303-0304,U+0308-0309,U+0323,U+0329,U+1EA0-1EF9,U+20AB}@font-face{font-family:Inter;font-style:normal;font-weight:100 900;font-display:swap;src:url(/GeometryOps.jl/previews/PR237/assets/inter-roman-latin-ext.4ZJIpNVo.woff2) format("woff2");unicode-range:U+0100-02AF,U+0304,U+0308,U+0329,U+1E00-1E9F,U+1EF2-1EFF,U+2020,U+20A0-20AB,U+20AD-20C0,U+2113,U+2C60-2C7F,U+A720-A7FF}@font-face{font-family:Inter;font-style:normal;font-weight:100 900;font-display:swap;src:url(/GeometryOps.jl/previews/PR237/assets/inter-roman-latin.Di8DUHzh.woff2) format("woff2");unicode-range:U+0000-00FF,U+0131,U+0152-0153,U+02BB-02BC,U+02C6,U+02DA,U+02DC,U+0304,U+0308,U+0329,U+2000-206F,U+2074,U+20AC,U+2122,U+2191,U+2193,U+2212,U+2215,U+FEFF,U+FFFD}@font-face{font-family:Inter;font-style:italic;font-weight:100 900;font-display:swap;src:url(/GeometryOps.jl/previews/PR237/assets/inter-italic-cyrillic-ext.r48I6akx.woff2) format("woff2");unicode-range:U+0460-052F,U+1C80-1C88,U+20B4,U+2DE0-2DFF,U+A640-A69F,U+FE2E-FE2F}@font-face{font-family:Inter;font-style:italic;font-weight:100 900;font-display:swap;src:url(/GeometryOps.jl/previews/PR237/assets/inter-italic-cyrillic.By2_1cv3.woff2) format("woff2");unicode-range:U+0301,U+0400-045F,U+0490-0491,U+04B0-04B1,U+2116}@font-face{font-family:Inter;font-style:italic;font-weight:100 900;font-display:swap;src:url(/GeometryOps.jl/previews/PR237/assets/inter-italic-greek-ext.1u6EdAuj.woff2) format("woff2");unicode-range:U+1F00-1FFF}@font-face{font-family:Inter;font-style:italic;font-weight:100 900;font-display:swap;src:url(/GeometryOps.jl/previews/PR237/assets/inter-italic-greek.DJ8dCoTZ.woff2) format("woff2");unicode-range:U+0370-0377,U+037A-037F,U+0384-038A,U+038C,U+038E-03A1,U+03A3-03FF}@font-face{font-family:Inter;font-style:italic;font-weight:100 900;font-display:swap;src:url(/GeometryOps.jl/previews/PR237/assets/inter-italic-vietnamese.BSbpV94h.woff2) format("woff2");unicode-range:U+0102-0103,U+0110-0111,U+0128-0129,U+0168-0169,U+01A0-01A1,U+01AF-01B0,U+0300-0301,U+0303-0304,U+0308-0309,U+0323,U+0329,U+1EA0-1EF9,U+20AB}@font-face{font-family:Inter;font-style:italic;font-weight:100 900;font-display:swap;src:url(/GeometryOps.jl/previews/PR237/assets/inter-italic-latin-ext.CN1xVJS-.woff2) format("woff2");unicode-range:U+0100-02AF,U+0304,U+0308,U+0329,U+1E00-1E9F,U+1EF2-1EFF,U+2020,U+20A0-20AB,U+20AD-20C0,U+2113,U+2C60-2C7F,U+A720-A7FF}@font-face{font-family:Inter;font-style:italic;font-weight:100 900;font-display:swap;src:url(/GeometryOps.jl/previews/PR237/assets/inter-italic-latin.C2AdPX0b.woff2) format("woff2");unicode-range:U+0000-00FF,U+0131,U+0152-0153,U+02BB-02BC,U+02C6,U+02DA,U+02DC,U+0304,U+0308,U+0329,U+2000-206F,U+2074,U+20AC,U+2122,U+2191,U+2193,U+2212,U+2215,U+FEFF,U+FFFD}@font-face{font-family:Punctuation SC;font-weight:400;src:local("PingFang SC Regular"),local("Noto Sans CJK SC"),local("Microsoft YaHei");unicode-range:U+201C,U+201D,U+2018,U+2019,U+2E3A,U+2014,U+2013,U+2026,U+00B7,U+007E,U+002F}@font-face{font-family:Punctuation SC;font-weight:500;src:local("PingFang SC Medium"),local("Noto Sans CJK SC"),local("Microsoft YaHei");unicode-range:U+201C,U+201D,U+2018,U+2019,U+2E3A,U+2014,U+2013,U+2026,U+00B7,U+007E,U+002F}@font-face{font-family:Punctuation SC;font-weight:600;src:local("PingFang SC Semibold"),local("Noto Sans CJK SC Bold"),local("Microsoft YaHei Bold");unicode-range:U+201C,U+201D,U+2018,U+2019,U+2E3A,U+2014,U+2013,U+2026,U+00B7,U+007E,U+002F}@font-face{font-family:Punctuation SC;font-weight:700;src:local("PingFang SC Semibold"),local("Noto Sans CJK SC Bold"),local("Microsoft YaHei Bold");unicode-range:U+201C,U+201D,U+2018,U+2019,U+2E3A,U+2014,U+2013,U+2026,U+00B7,U+007E,U+002F}:root{--vp-c-white: #ffffff;--vp-c-black: #000000;--vp-c-neutral: var(--vp-c-black);--vp-c-neutral-inverse: var(--vp-c-white)}.dark{--vp-c-neutral: var(--vp-c-white);--vp-c-neutral-inverse: var(--vp-c-black)}:root{--vp-c-gray-1: #dddde3;--vp-c-gray-2: #e4e4e9;--vp-c-gray-3: #ebebef;--vp-c-gray-soft: rgba(142, 150, 170, .14);--vp-c-indigo-1: #3451b2;--vp-c-indigo-2: #3a5ccc;--vp-c-indigo-3: #5672cd;--vp-c-indigo-soft: rgba(100, 108, 255, .14);--vp-c-purple-1: #6f42c1;--vp-c-purple-2: #7e4cc9;--vp-c-purple-3: #8e5cd9;--vp-c-purple-soft: rgba(159, 122, 234, .14);--vp-c-green-1: #18794e;--vp-c-green-2: #299764;--vp-c-green-3: #30a46c;--vp-c-green-soft: rgba(16, 185, 129, .14);--vp-c-yellow-1: #915930;--vp-c-yellow-2: #946300;--vp-c-yellow-3: #9f6a00;--vp-c-yellow-soft: rgba(234, 179, 8, .14);--vp-c-red-1: #b8272c;--vp-c-red-2: #d5393e;--vp-c-red-3: #e0575b;--vp-c-red-soft: rgba(244, 63, 94, .14);--vp-c-sponsor: #db2777}.dark{--vp-c-gray-1: #515c67;--vp-c-gray-2: #414853;--vp-c-gray-3: #32363f;--vp-c-gray-soft: rgba(101, 117, 133, .16);--vp-c-indigo-1: #a8b1ff;--vp-c-indigo-2: #5c73e7;--vp-c-indigo-3: #3e63dd;--vp-c-indigo-soft: rgba(100, 108, 255, .16);--vp-c-purple-1: #c8abfa;--vp-c-purple-2: #a879e6;--vp-c-purple-3: #8e5cd9;--vp-c-purple-soft: rgba(159, 122, 234, .16);--vp-c-green-1: #3dd68c;--vp-c-green-2: #30a46c;--vp-c-green-3: #298459;--vp-c-green-soft: rgba(16, 185, 129, .16);--vp-c-yellow-1: #f9b44e;--vp-c-yellow-2: #da8b17;--vp-c-yellow-3: #a46a0a;--vp-c-yellow-soft: rgba(234, 179, 8, .16);--vp-c-red-1: #f66f81;--vp-c-red-2: #f14158;--vp-c-red-3: #b62a3c;--vp-c-red-soft: rgba(244, 63, 94, .16)}:root{--vp-c-bg: #ffffff;--vp-c-bg-alt: #f6f6f7;--vp-c-bg-elv: #ffffff;--vp-c-bg-soft: #f6f6f7}.dark{--vp-c-bg: #1b1b1f;--vp-c-bg-alt: #161618;--vp-c-bg-elv: #202127;--vp-c-bg-soft: #202127}:root{--vp-c-border: #c2c2c4;--vp-c-divider: #e2e2e3;--vp-c-gutter: #e2e2e3}.dark{--vp-c-border: #3c3f44;--vp-c-divider: #2e2e32;--vp-c-gutter: #000000}:root{--vp-c-text-1: rgba(60, 60, 67);--vp-c-text-2: rgba(60, 60, 67, .78);--vp-c-text-3: rgba(60, 60, 67, .56)}.dark{--vp-c-text-1: rgba(255, 255, 245, .86);--vp-c-text-2: rgba(235, 235, 245, .6);--vp-c-text-3: rgba(235, 235, 245, .38)}:root{--vp-c-default-1: var(--vp-c-gray-1);--vp-c-default-2: var(--vp-c-gray-2);--vp-c-default-3: var(--vp-c-gray-3);--vp-c-default-soft: var(--vp-c-gray-soft);--vp-c-brand-1: var(--vp-c-indigo-1);--vp-c-brand-2: var(--vp-c-indigo-2);--vp-c-brand-3: var(--vp-c-indigo-3);--vp-c-brand-soft: var(--vp-c-indigo-soft);--vp-c-brand: var(--vp-c-brand-1);--vp-c-tip-1: var(--vp-c-brand-1);--vp-c-tip-2: var(--vp-c-brand-2);--vp-c-tip-3: var(--vp-c-brand-3);--vp-c-tip-soft: var(--vp-c-brand-soft);--vp-c-note-1: var(--vp-c-brand-1);--vp-c-note-2: var(--vp-c-brand-2);--vp-c-note-3: var(--vp-c-brand-3);--vp-c-note-soft: var(--vp-c-brand-soft);--vp-c-success-1: var(--vp-c-green-1);--vp-c-success-2: var(--vp-c-green-2);--vp-c-success-3: var(--vp-c-green-3);--vp-c-success-soft: var(--vp-c-green-soft);--vp-c-important-1: var(--vp-c-purple-1);--vp-c-important-2: var(--vp-c-purple-2);--vp-c-important-3: var(--vp-c-purple-3);--vp-c-important-soft: var(--vp-c-purple-soft);--vp-c-warning-1: var(--vp-c-yellow-1);--vp-c-warning-2: var(--vp-c-yellow-2);--vp-c-warning-3: var(--vp-c-yellow-3);--vp-c-warning-soft: var(--vp-c-yellow-soft);--vp-c-danger-1: var(--vp-c-red-1);--vp-c-danger-2: var(--vp-c-red-2);--vp-c-danger-3: var(--vp-c-red-3);--vp-c-danger-soft: var(--vp-c-red-soft);--vp-c-caution-1: var(--vp-c-red-1);--vp-c-caution-2: var(--vp-c-red-2);--vp-c-caution-3: var(--vp-c-red-3);--vp-c-caution-soft: var(--vp-c-red-soft)}:root{--vp-font-family-base: "Inter", ui-sans-serif, system-ui, sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji";--vp-font-family-mono: ui-monospace, "Menlo", "Monaco", "Consolas", "Liberation Mono", "Courier New", monospace;font-optical-sizing:auto}:root:where(:lang(zh)){--vp-font-family-base: "Punctuation SC", "Inter", ui-sans-serif, system-ui, sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji"}:root{--vp-shadow-1: 0 1px 2px rgba(0, 0, 0, .04), 0 1px 2px rgba(0, 0, 0, .06);--vp-shadow-2: 0 3px 12px rgba(0, 0, 0, .07), 0 1px 4px rgba(0, 0, 0, .07);--vp-shadow-3: 0 12px 32px rgba(0, 0, 0, .1), 0 2px 6px rgba(0, 0, 0, .08);--vp-shadow-4: 0 14px 44px rgba(0, 0, 0, .12), 0 3px 9px rgba(0, 0, 0, .12);--vp-shadow-5: 0 18px 56px rgba(0, 0, 0, .16), 0 4px 12px rgba(0, 0, 0, .16)}:root{--vp-z-index-footer: 10;--vp-z-index-local-nav: 20;--vp-z-index-nav: 30;--vp-z-index-layout-top: 40;--vp-z-index-backdrop: 50;--vp-z-index-sidebar: 60}@media (min-width: 960px){:root{--vp-z-index-sidebar: 25}}:root{--vp-layout-max-width: 1440px}:root{--vp-header-anchor-symbol: "#"}:root{--vp-code-line-height: 1.7;--vp-code-font-size: .875em;--vp-code-color: var(--vp-c-brand-1);--vp-code-link-color: var(--vp-c-brand-1);--vp-code-link-hover-color: var(--vp-c-brand-2);--vp-code-bg: var(--vp-c-default-soft);--vp-code-block-color: var(--vp-c-text-2);--vp-code-block-bg: var(--vp-c-bg-alt);--vp-code-block-divider-color: var(--vp-c-gutter);--vp-code-lang-color: var(--vp-c-text-3);--vp-code-line-highlight-color: var(--vp-c-default-soft);--vp-code-line-number-color: var(--vp-c-text-3);--vp-code-line-diff-add-color: var(--vp-c-success-soft);--vp-code-line-diff-add-symbol-color: var(--vp-c-success-1);--vp-code-line-diff-remove-color: var(--vp-c-danger-soft);--vp-code-line-diff-remove-symbol-color: var(--vp-c-danger-1);--vp-code-line-warning-color: var(--vp-c-warning-soft);--vp-code-line-error-color: var(--vp-c-danger-soft);--vp-code-copy-code-border-color: var(--vp-c-divider);--vp-code-copy-code-bg: var(--vp-c-bg-soft);--vp-code-copy-code-hover-border-color: var(--vp-c-divider);--vp-code-copy-code-hover-bg: var(--vp-c-bg);--vp-code-copy-code-active-text: var(--vp-c-text-2);--vp-code-copy-copied-text-content: "Copied";--vp-code-tab-divider: var(--vp-code-block-divider-color);--vp-code-tab-text-color: var(--vp-c-text-2);--vp-code-tab-bg: var(--vp-code-block-bg);--vp-code-tab-hover-text-color: var(--vp-c-text-1);--vp-code-tab-active-text-color: var(--vp-c-text-1);--vp-code-tab-active-bar-color: var(--vp-c-brand-1)}:root{--vp-button-brand-border: transparent;--vp-button-brand-text: var(--vp-c-white);--vp-button-brand-bg: var(--vp-c-brand-3);--vp-button-brand-hover-border: transparent;--vp-button-brand-hover-text: var(--vp-c-white);--vp-button-brand-hover-bg: var(--vp-c-brand-2);--vp-button-brand-active-border: transparent;--vp-button-brand-active-text: var(--vp-c-white);--vp-button-brand-active-bg: var(--vp-c-brand-1);--vp-button-alt-border: transparent;--vp-button-alt-text: var(--vp-c-text-1);--vp-button-alt-bg: var(--vp-c-default-3);--vp-button-alt-hover-border: transparent;--vp-button-alt-hover-text: var(--vp-c-text-1);--vp-button-alt-hover-bg: var(--vp-c-default-2);--vp-button-alt-active-border: transparent;--vp-button-alt-active-text: var(--vp-c-text-1);--vp-button-alt-active-bg: var(--vp-c-default-1);--vp-button-sponsor-border: var(--vp-c-text-2);--vp-button-sponsor-text: var(--vp-c-text-2);--vp-button-sponsor-bg: transparent;--vp-button-sponsor-hover-border: var(--vp-c-sponsor);--vp-button-sponsor-hover-text: var(--vp-c-sponsor);--vp-button-sponsor-hover-bg: transparent;--vp-button-sponsor-active-border: var(--vp-c-sponsor);--vp-button-sponsor-active-text: var(--vp-c-sponsor);--vp-button-sponsor-active-bg: transparent}:root{--vp-custom-block-font-size: 14px;--vp-custom-block-code-font-size: 13px;--vp-custom-block-info-border: transparent;--vp-custom-block-info-text: var(--vp-c-text-1);--vp-custom-block-info-bg: var(--vp-c-default-soft);--vp-custom-block-info-code-bg: var(--vp-c-default-soft);--vp-custom-block-note-border: transparent;--vp-custom-block-note-text: var(--vp-c-text-1);--vp-custom-block-note-bg: var(--vp-c-default-soft);--vp-custom-block-note-code-bg: var(--vp-c-default-soft);--vp-custom-block-tip-border: transparent;--vp-custom-block-tip-text: var(--vp-c-text-1);--vp-custom-block-tip-bg: var(--vp-c-tip-soft);--vp-custom-block-tip-code-bg: var(--vp-c-tip-soft);--vp-custom-block-important-border: transparent;--vp-custom-block-important-text: var(--vp-c-text-1);--vp-custom-block-important-bg: var(--vp-c-important-soft);--vp-custom-block-important-code-bg: var(--vp-c-important-soft);--vp-custom-block-warning-border: transparent;--vp-custom-block-warning-text: var(--vp-c-text-1);--vp-custom-block-warning-bg: var(--vp-c-warning-soft);--vp-custom-block-warning-code-bg: var(--vp-c-warning-soft);--vp-custom-block-danger-border: transparent;--vp-custom-block-danger-text: var(--vp-c-text-1);--vp-custom-block-danger-bg: var(--vp-c-danger-soft);--vp-custom-block-danger-code-bg: var(--vp-c-danger-soft);--vp-custom-block-caution-border: transparent;--vp-custom-block-caution-text: var(--vp-c-text-1);--vp-custom-block-caution-bg: var(--vp-c-caution-soft);--vp-custom-block-caution-code-bg: var(--vp-c-caution-soft);--vp-custom-block-details-border: var(--vp-custom-block-info-border);--vp-custom-block-details-text: var(--vp-custom-block-info-text);--vp-custom-block-details-bg: var(--vp-custom-block-info-bg);--vp-custom-block-details-code-bg: var(--vp-custom-block-info-code-bg)}:root{--vp-input-border-color: var(--vp-c-border);--vp-input-bg-color: var(--vp-c-bg-alt);--vp-input-switch-bg-color: var(--vp-c-default-soft)}:root{--vp-nav-height: 64px;--vp-nav-bg-color: var(--vp-c-bg);--vp-nav-screen-bg-color: var(--vp-c-bg);--vp-nav-logo-height: 24px}.hide-nav{--vp-nav-height: 0px}.hide-nav .VPSidebar{--vp-nav-height: 22px}:root{--vp-local-nav-bg-color: var(--vp-c-bg)}:root{--vp-sidebar-width: 272px;--vp-sidebar-bg-color: var(--vp-c-bg-alt)}:root{--vp-backdrop-bg-color: rgba(0, 0, 0, .6)}:root{--vp-home-hero-name-color: var(--vp-c-brand-1);--vp-home-hero-name-background: transparent;--vp-home-hero-image-background-image: none;--vp-home-hero-image-filter: none}:root{--vp-badge-info-border: transparent;--vp-badge-info-text: var(--vp-c-text-2);--vp-badge-info-bg: var(--vp-c-default-soft);--vp-badge-tip-border: transparent;--vp-badge-tip-text: var(--vp-c-tip-1);--vp-badge-tip-bg: var(--vp-c-tip-soft);--vp-badge-warning-border: transparent;--vp-badge-warning-text: var(--vp-c-warning-1);--vp-badge-warning-bg: var(--vp-c-warning-soft);--vp-badge-danger-border: transparent;--vp-badge-danger-text: var(--vp-c-danger-1);--vp-badge-danger-bg: var(--vp-c-danger-soft)}:root{--vp-carbon-ads-text-color: var(--vp-c-text-1);--vp-carbon-ads-poweredby-color: var(--vp-c-text-2);--vp-carbon-ads-bg-color: var(--vp-c-bg-soft);--vp-carbon-ads-hover-text-color: var(--vp-c-brand-1);--vp-carbon-ads-hover-poweredby-color: var(--vp-c-text-1)}:root{--vp-local-search-bg: var(--vp-c-bg);--vp-local-search-result-bg: var(--vp-c-bg);--vp-local-search-result-border: var(--vp-c-divider);--vp-local-search-result-selected-bg: var(--vp-c-bg);--vp-local-search-result-selected-border: var(--vp-c-brand-1);--vp-local-search-highlight-bg: var(--vp-c-brand-1);--vp-local-search-highlight-text: var(--vp-c-neutral-inverse)}@media (prefers-reduced-motion: reduce){*,:before,:after{animation-delay:-1ms!important;animation-duration:1ms!important;animation-iteration-count:1!important;background-attachment:initial!important;scroll-behavior:auto!important;transition-duration:0s!important;transition-delay:0s!important}}*,:before,:after{box-sizing:border-box}html{line-height:1.4;font-size:16px;-webkit-text-size-adjust:100%}html.dark{color-scheme:dark}body{margin:0;width:100%;min-width:320px;min-height:100vh;line-height:24px;font-family:var(--vp-font-family-base);font-size:16px;font-weight:400;color:var(--vp-c-text-1);background-color:var(--vp-c-bg);font-synthesis:style;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}main{display:block}h1,h2,h3,h4,h5,h6{margin:0;line-height:24px;font-size:16px;font-weight:400}p{margin:0}strong,b{font-weight:600}a,area,button,[role=button],input,label,select,summary,textarea{touch-action:manipulation}a{color:inherit;text-decoration:inherit}ol,ul{list-style:none;margin:0;padding:0}blockquote{margin:0}pre,code,kbd,samp{font-family:var(--vp-font-family-mono)}img,svg,video,canvas,audio,iframe,embed,object{display:block}figure{margin:0}img,video{max-width:100%;height:auto}button,input,optgroup,select,textarea{border:0;padding:0;line-height:inherit;color:inherit}button{padding:0;font-family:inherit;background-color:transparent;background-image:none}button:enabled,[role=button]:enabled{cursor:pointer}button:focus,button:focus-visible{outline:1px dotted;outline:4px auto -webkit-focus-ring-color}button:focus:not(:focus-visible){outline:none!important}input:focus,textarea:focus,select:focus{outline:none}table{border-collapse:collapse}input{background-color:transparent}input:-ms-input-placeholder,textarea:-ms-input-placeholder{color:var(--vp-c-text-3)}input::-ms-input-placeholder,textarea::-ms-input-placeholder{color:var(--vp-c-text-3)}input::placeholder,textarea::placeholder{color:var(--vp-c-text-3)}input::-webkit-outer-spin-button,input::-webkit-inner-spin-button{-webkit-appearance:none;margin:0}input[type=number]{-moz-appearance:textfield}textarea{resize:vertical}select{-webkit-appearance:none}fieldset{margin:0;padding:0}h1,h2,h3,h4,h5,h6,li,p{overflow-wrap:break-word}vite-error-overlay{z-index:9999}mjx-container{overflow-x:auto}mjx-container>svg{display:inline-block;margin:auto}[class^=vpi-],[class*=" vpi-"],.vp-icon{width:1em;height:1em}[class^=vpi-].bg,[class*=" vpi-"].bg,.vp-icon.bg{background-size:100% 100%;background-color:transparent}[class^=vpi-]:not(.bg),[class*=" vpi-"]:not(.bg),.vp-icon:not(.bg){-webkit-mask:var(--icon) no-repeat;mask:var(--icon) no-repeat;-webkit-mask-size:100% 100%;mask-size:100% 100%;background-color:currentColor;color:inherit}.vpi-align-left{--icon: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' fill='none' stroke='currentColor' stroke-linecap='round' stroke-linejoin='round' stroke-width='2' viewBox='0 0 24 24'%3E%3Cpath d='M21 6H3M15 12H3M17 18H3'/%3E%3C/svg%3E")}.vpi-arrow-right,.vpi-arrow-down,.vpi-arrow-left,.vpi-arrow-up{--icon: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' fill='none' stroke='currentColor' stroke-linecap='round' stroke-linejoin='round' stroke-width='2' viewBox='0 0 24 24'%3E%3Cpath d='M5 12h14M12 5l7 7-7 7'/%3E%3C/svg%3E")}.vpi-chevron-right,.vpi-chevron-down,.vpi-chevron-left,.vpi-chevron-up{--icon: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' fill='none' stroke='currentColor' stroke-linecap='round' stroke-linejoin='round' stroke-width='2' viewBox='0 0 24 24'%3E%3Cpath d='m9 18 6-6-6-6'/%3E%3C/svg%3E")}.vpi-chevron-down,.vpi-arrow-down{transform:rotate(90deg)}.vpi-chevron-left,.vpi-arrow-left{transform:rotate(180deg)}.vpi-chevron-up,.vpi-arrow-up{transform:rotate(-90deg)}.vpi-square-pen{--icon: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' fill='none' stroke='currentColor' stroke-linecap='round' stroke-linejoin='round' stroke-width='2' viewBox='0 0 24 24'%3E%3Cpath d='M12 3H5a2 2 0 0 0-2 2v14a2 2 0 0 0 2 2h14a2 2 0 0 0 2-2v-7'/%3E%3Cpath d='M18.375 2.625a2.121 2.121 0 1 1 3 3L12 15l-4 1 1-4Z'/%3E%3C/svg%3E")}.vpi-plus{--icon: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' fill='none' stroke='currentColor' stroke-linecap='round' stroke-linejoin='round' stroke-width='2' viewBox='0 0 24 24'%3E%3Cpath d='M5 12h14M12 5v14'/%3E%3C/svg%3E")}.vpi-sun{--icon: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' fill='none' stroke='currentColor' stroke-linecap='round' stroke-linejoin='round' stroke-width='2' viewBox='0 0 24 24'%3E%3Ccircle cx='12' cy='12' r='4'/%3E%3Cpath d='M12 2v2M12 20v2M4.93 4.93l1.41 1.41M17.66 17.66l1.41 1.41M2 12h2M20 12h2M6.34 17.66l-1.41 1.41M19.07 4.93l-1.41 1.41'/%3E%3C/svg%3E")}.vpi-moon{--icon: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' fill='none' stroke='currentColor' stroke-linecap='round' stroke-linejoin='round' stroke-width='2' viewBox='0 0 24 24'%3E%3Cpath d='M12 3a6 6 0 0 0 9 9 9 9 0 1 1-9-9Z'/%3E%3C/svg%3E")}.vpi-more-horizontal{--icon: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' fill='none' stroke='currentColor' stroke-linecap='round' stroke-linejoin='round' stroke-width='2' viewBox='0 0 24 24'%3E%3Ccircle cx='12' cy='12' r='1'/%3E%3Ccircle cx='19' cy='12' r='1'/%3E%3Ccircle cx='5' cy='12' r='1'/%3E%3C/svg%3E")}.vpi-languages{--icon: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' fill='none' stroke='currentColor' stroke-linecap='round' stroke-linejoin='round' stroke-width='2' viewBox='0 0 24 24'%3E%3Cpath d='m5 8 6 6M4 14l6-6 2-3M2 5h12M7 2h1M22 22l-5-10-5 10M14 18h6'/%3E%3C/svg%3E")}.vpi-heart{--icon: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' fill='none' stroke='currentColor' stroke-linecap='round' stroke-linejoin='round' stroke-width='2' viewBox='0 0 24 24'%3E%3Cpath d='M19 14c1.49-1.46 3-3.21 3-5.5A5.5 5.5 0 0 0 16.5 3c-1.76 0-3 .5-4.5 2-1.5-1.5-2.74-2-4.5-2A5.5 5.5 0 0 0 2 8.5c0 2.3 1.5 4.05 3 5.5l7 7Z'/%3E%3C/svg%3E")}.vpi-search{--icon: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' fill='none' stroke='currentColor' stroke-linecap='round' stroke-linejoin='round' stroke-width='2' viewBox='0 0 24 24'%3E%3Ccircle cx='11' cy='11' r='8'/%3E%3Cpath d='m21 21-4.3-4.3'/%3E%3C/svg%3E")}.vpi-layout-list{--icon: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' fill='none' stroke='currentColor' stroke-linecap='round' stroke-linejoin='round' stroke-width='2' viewBox='0 0 24 24'%3E%3Crect width='7' height='7' x='3' y='3' rx='1'/%3E%3Crect width='7' height='7' x='3' y='14' rx='1'/%3E%3Cpath d='M14 4h7M14 9h7M14 15h7M14 20h7'/%3E%3C/svg%3E")}.vpi-delete{--icon: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' fill='none' stroke='currentColor' stroke-linecap='round' stroke-linejoin='round' stroke-width='2' viewBox='0 0 24 24'%3E%3Cpath d='M20 5H9l-7 7 7 7h11a2 2 0 0 0 2-2V7a2 2 0 0 0-2-2ZM18 9l-6 6M12 9l6 6'/%3E%3C/svg%3E")}.vpi-corner-down-left{--icon: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' fill='none' stroke='currentColor' stroke-linecap='round' stroke-linejoin='round' stroke-width='2' viewBox='0 0 24 24'%3E%3Cpath d='m9 10-5 5 5 5'/%3E%3Cpath d='M20 4v7a4 4 0 0 1-4 4H4'/%3E%3C/svg%3E")}:root{--vp-icon-copy: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' fill='none' stroke='rgba(128,128,128,1)' stroke-linecap='round' stroke-linejoin='round' stroke-width='2' viewBox='0 0 24 24'%3E%3Crect width='8' height='4' x='8' y='2' rx='1' ry='1'/%3E%3Cpath d='M16 4h2a2 2 0 0 1 2 2v14a2 2 0 0 1-2 2H6a2 2 0 0 1-2-2V6a2 2 0 0 1 2-2h2'/%3E%3C/svg%3E");--vp-icon-copied: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' fill='none' stroke='rgba(128,128,128,1)' stroke-linecap='round' stroke-linejoin='round' stroke-width='2' viewBox='0 0 24 24'%3E%3Crect width='8' height='4' x='8' y='2' rx='1' ry='1'/%3E%3Cpath d='M16 4h2a2 2 0 0 1 2 2v14a2 2 0 0 1-2 2H6a2 2 0 0 1-2-2V6a2 2 0 0 1 2-2h2'/%3E%3Cpath d='m9 14 2 2 4-4'/%3E%3C/svg%3E")}.visually-hidden{position:absolute;width:1px;height:1px;white-space:nowrap;clip:rect(0 0 0 0);clip-path:inset(50%);overflow:hidden}.custom-block{border:1px solid transparent;border-radius:8px;padding:16px 16px 8px;line-height:24px;font-size:var(--vp-custom-block-font-size);color:var(--vp-c-text-2)}.custom-block.info{border-color:var(--vp-custom-block-info-border);color:var(--vp-custom-block-info-text);background-color:var(--vp-custom-block-info-bg)}.custom-block.info a,.custom-block.info code{color:var(--vp-c-brand-1)}.custom-block.info a:hover,.custom-block.info a:hover>code{color:var(--vp-c-brand-2)}.custom-block.info code{background-color:var(--vp-custom-block-info-code-bg)}.custom-block.note{border-color:var(--vp-custom-block-note-border);color:var(--vp-custom-block-note-text);background-color:var(--vp-custom-block-note-bg)}.custom-block.note a,.custom-block.note code{color:var(--vp-c-brand-1)}.custom-block.note a:hover,.custom-block.note a:hover>code{color:var(--vp-c-brand-2)}.custom-block.note code{background-color:var(--vp-custom-block-note-code-bg)}.custom-block.tip{border-color:var(--vp-custom-block-tip-border);color:var(--vp-custom-block-tip-text);background-color:var(--vp-custom-block-tip-bg)}.custom-block.tip a,.custom-block.tip code{color:var(--vp-c-tip-1)}.custom-block.tip a:hover,.custom-block.tip a:hover>code{color:var(--vp-c-tip-2)}.custom-block.tip code{background-color:var(--vp-custom-block-tip-code-bg)}.custom-block.important{border-color:var(--vp-custom-block-important-border);color:var(--vp-custom-block-important-text);background-color:var(--vp-custom-block-important-bg)}.custom-block.important a,.custom-block.important code{color:var(--vp-c-important-1)}.custom-block.important a:hover,.custom-block.important a:hover>code{color:var(--vp-c-important-2)}.custom-block.important code{background-color:var(--vp-custom-block-important-code-bg)}.custom-block.warning{border-color:var(--vp-custom-block-warning-border);color:var(--vp-custom-block-warning-text);background-color:var(--vp-custom-block-warning-bg)}.custom-block.warning a,.custom-block.warning code{color:var(--vp-c-warning-1)}.custom-block.warning a:hover,.custom-block.warning a:hover>code{color:var(--vp-c-warning-2)}.custom-block.warning code{background-color:var(--vp-custom-block-warning-code-bg)}.custom-block.danger{border-color:var(--vp-custom-block-danger-border);color:var(--vp-custom-block-danger-text);background-color:var(--vp-custom-block-danger-bg)}.custom-block.danger a,.custom-block.danger code{color:var(--vp-c-danger-1)}.custom-block.danger a:hover,.custom-block.danger a:hover>code{color:var(--vp-c-danger-2)}.custom-block.danger code{background-color:var(--vp-custom-block-danger-code-bg)}.custom-block.caution{border-color:var(--vp-custom-block-caution-border);color:var(--vp-custom-block-caution-text);background-color:var(--vp-custom-block-caution-bg)}.custom-block.caution a,.custom-block.caution code{color:var(--vp-c-caution-1)}.custom-block.caution a:hover,.custom-block.caution a:hover>code{color:var(--vp-c-caution-2)}.custom-block.caution code{background-color:var(--vp-custom-block-caution-code-bg)}.custom-block.details{border-color:var(--vp-custom-block-details-border);color:var(--vp-custom-block-details-text);background-color:var(--vp-custom-block-details-bg)}.custom-block.details a{color:var(--vp-c-brand-1)}.custom-block.details a:hover,.custom-block.details a:hover>code{color:var(--vp-c-brand-2)}.custom-block.details code{background-color:var(--vp-custom-block-details-code-bg)}.custom-block-title{font-weight:600}.custom-block p+p{margin:8px 0}.custom-block.details summary{margin:0 0 8px;font-weight:700;cursor:pointer;-webkit-user-select:none;user-select:none}.custom-block.details summary+p{margin:8px 0}.custom-block a{color:inherit;font-weight:600;text-decoration:underline;text-underline-offset:2px;transition:opacity .25s}.custom-block a:hover{opacity:.75}.custom-block code{font-size:var(--vp-custom-block-code-font-size)}.custom-block.custom-block th,.custom-block.custom-block blockquote>p{font-size:var(--vp-custom-block-font-size);color:inherit}.dark .vp-code span{color:var(--shiki-dark, inherit)}html:not(.dark) .vp-code span{color:var(--shiki-light, inherit)}.vp-code-group{margin-top:16px}.vp-code-group .tabs{position:relative;display:flex;margin-right:-24px;margin-left:-24px;padding:0 12px;background-color:var(--vp-code-tab-bg);overflow-x:auto;overflow-y:hidden;box-shadow:inset 0 -1px var(--vp-code-tab-divider)}@media (min-width: 640px){.vp-code-group .tabs{margin-right:0;margin-left:0;border-radius:8px 8px 0 0}}.vp-code-group .tabs input{position:fixed;opacity:0;pointer-events:none}.vp-code-group .tabs label{position:relative;display:inline-block;border-bottom:1px solid transparent;padding:0 12px;line-height:48px;font-size:14px;font-weight:500;color:var(--vp-code-tab-text-color);white-space:nowrap;cursor:pointer;transition:color .25s}.vp-code-group .tabs label:after{position:absolute;right:8px;bottom:-1px;left:8px;z-index:1;height:2px;border-radius:2px;content:"";background-color:transparent;transition:background-color .25s}.vp-code-group label:hover{color:var(--vp-code-tab-hover-text-color)}.vp-code-group input:checked+label{color:var(--vp-code-tab-active-text-color)}.vp-code-group input:checked+label:after{background-color:var(--vp-code-tab-active-bar-color)}.vp-code-group div[class*=language-],.vp-block{display:none;margin-top:0!important;border-top-left-radius:0!important;border-top-right-radius:0!important}.vp-code-group div[class*=language-].active,.vp-block.active{display:block}.vp-block{padding:20px 24px}.vp-doc h1,.vp-doc h2,.vp-doc h3,.vp-doc h4,.vp-doc h5,.vp-doc h6{position:relative;font-weight:600;outline:none}.vp-doc h1{letter-spacing:-.02em;line-height:40px;font-size:28px}.vp-doc h2{margin:48px 0 16px;border-top:1px solid var(--vp-c-divider);padding-top:24px;letter-spacing:-.02em;line-height:32px;font-size:24px}.vp-doc h3{margin:32px 0 0;letter-spacing:-.01em;line-height:28px;font-size:20px}.vp-doc h4{margin:24px 0 0;letter-spacing:-.01em;line-height:24px;font-size:18px}.vp-doc .header-anchor{position:absolute;top:0;left:0;margin-left:-.87em;font-weight:500;-webkit-user-select:none;user-select:none;opacity:0;text-decoration:none;transition:color .25s,opacity .25s}.vp-doc .header-anchor:before{content:var(--vp-header-anchor-symbol)}.vp-doc h1:hover .header-anchor,.vp-doc h1 .header-anchor:focus,.vp-doc h2:hover .header-anchor,.vp-doc h2 .header-anchor:focus,.vp-doc h3:hover .header-anchor,.vp-doc h3 .header-anchor:focus,.vp-doc h4:hover .header-anchor,.vp-doc h4 .header-anchor:focus,.vp-doc h5:hover .header-anchor,.vp-doc h5 .header-anchor:focus,.vp-doc h6:hover .header-anchor,.vp-doc h6 .header-anchor:focus{opacity:1}@media (min-width: 768px){.vp-doc h1{letter-spacing:-.02em;line-height:40px;font-size:32px}}.vp-doc h2 .header-anchor{top:24px}.vp-doc p,.vp-doc summary{margin:16px 0}.vp-doc p{line-height:28px}.vp-doc blockquote{margin:16px 0;border-left:2px solid var(--vp-c-divider);padding-left:16px;transition:border-color .5s;color:var(--vp-c-text-2)}.vp-doc blockquote>p{margin:0;font-size:16px;transition:color .5s}.vp-doc a{font-weight:500;color:var(--vp-c-brand-1);text-decoration:underline;text-underline-offset:2px;transition:color .25s,opacity .25s}.vp-doc a:hover{color:var(--vp-c-brand-2)}.vp-doc strong{font-weight:600}.vp-doc ul,.vp-doc ol{padding-left:1.25rem;margin:16px 0}.vp-doc ul{list-style:disc}.vp-doc ol{list-style:decimal}.vp-doc li+li{margin-top:8px}.vp-doc li>ol,.vp-doc li>ul{margin:8px 0 0}.vp-doc table{display:block;border-collapse:collapse;margin:20px 0;overflow-x:auto}.vp-doc tr{background-color:var(--vp-c-bg);border-top:1px solid var(--vp-c-divider);transition:background-color .5s}.vp-doc tr:nth-child(2n){background-color:var(--vp-c-bg-soft)}.vp-doc th,.vp-doc td{border:1px solid var(--vp-c-divider);padding:8px 16px}.vp-doc th{text-align:left;font-size:14px;font-weight:600;color:var(--vp-c-text-2);background-color:var(--vp-c-bg-soft)}.vp-doc td{font-size:14px}.vp-doc hr{margin:16px 0;border:none;border-top:1px solid var(--vp-c-divider)}.vp-doc .custom-block{margin:16px 0}.vp-doc .custom-block p{margin:8px 0;line-height:24px}.vp-doc .custom-block p:first-child{margin:0}.vp-doc .custom-block div[class*=language-]{margin:8px 0;border-radius:8px}.vp-doc .custom-block div[class*=language-] code{font-weight:400;background-color:transparent}.vp-doc .custom-block .vp-code-group .tabs{margin:0;border-radius:8px 8px 0 0}.vp-doc :not(pre,h1,h2,h3,h4,h5,h6)>code{font-size:var(--vp-code-font-size);color:var(--vp-code-color)}.vp-doc :not(pre)>code{border-radius:4px;padding:3px 6px;background-color:var(--vp-code-bg);transition:color .25s,background-color .5s}.vp-doc a>code{color:var(--vp-code-link-color)}.vp-doc a:hover>code{color:var(--vp-code-link-hover-color)}.vp-doc h1>code,.vp-doc h2>code,.vp-doc h3>code,.vp-doc h4>code{font-size:.9em}.vp-doc div[class*=language-],.vp-block{position:relative;margin:16px -24px;background-color:var(--vp-code-block-bg);overflow-x:auto;transition:background-color .5s}@media (min-width: 640px){.vp-doc div[class*=language-],.vp-block{border-radius:8px;margin:16px 0}}@media (max-width: 639px){.vp-doc li div[class*=language-]{border-radius:8px 0 0 8px}}.vp-doc div[class*=language-]+div[class*=language-],.vp-doc div[class$=-api]+div[class*=language-],.vp-doc div[class*=language-]+div[class$=-api]>div[class*=language-]{margin-top:-8px}.vp-doc [class*=language-] pre,.vp-doc [class*=language-] code{direction:ltr;text-align:left;white-space:pre;word-spacing:normal;word-break:normal;word-wrap:normal;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-hyphens:none;-moz-hyphens:none;-ms-hyphens:none;hyphens:none}.vp-doc [class*=language-] pre{position:relative;z-index:1;margin:0;padding:20px 0;background:transparent;overflow-x:auto}.vp-doc [class*=language-] code{display:block;padding:0 24px;width:fit-content;min-width:100%;line-height:var(--vp-code-line-height);font-size:var(--vp-code-font-size);color:var(--vp-code-block-color);transition:color .5s}.vp-doc [class*=language-] code .highlighted{background-color:var(--vp-code-line-highlight-color);transition:background-color .5s;margin:0 -24px;padding:0 24px;width:calc(100% + 48px);display:inline-block}.vp-doc [class*=language-] code .highlighted.error{background-color:var(--vp-code-line-error-color)}.vp-doc [class*=language-] code .highlighted.warning{background-color:var(--vp-code-line-warning-color)}.vp-doc [class*=language-] code .diff{transition:background-color .5s;margin:0 -24px;padding:0 24px;width:calc(100% + 48px);display:inline-block}.vp-doc [class*=language-] code .diff:before{position:absolute;left:10px}.vp-doc [class*=language-] .has-focused-lines .line:not(.has-focus){filter:blur(.095rem);opacity:.4;transition:filter .35s,opacity .35s}.vp-doc [class*=language-] .has-focused-lines .line:not(.has-focus){opacity:.7;transition:filter .35s,opacity .35s}.vp-doc [class*=language-]:hover .has-focused-lines .line:not(.has-focus){filter:blur(0);opacity:1}.vp-doc [class*=language-] code .diff.remove{background-color:var(--vp-code-line-diff-remove-color);opacity:.7}.vp-doc [class*=language-] code .diff.remove:before{content:"-";color:var(--vp-code-line-diff-remove-symbol-color)}.vp-doc [class*=language-] code .diff.add{background-color:var(--vp-code-line-diff-add-color)}.vp-doc [class*=language-] code .diff.add:before{content:"+";color:var(--vp-code-line-diff-add-symbol-color)}.vp-doc div[class*=language-].line-numbers-mode{padding-left:32px}.vp-doc .line-numbers-wrapper{position:absolute;top:0;bottom:0;left:0;z-index:3;border-right:1px solid var(--vp-code-block-divider-color);padding-top:20px;width:32px;text-align:center;font-family:var(--vp-font-family-mono);line-height:var(--vp-code-line-height);font-size:var(--vp-code-font-size);color:var(--vp-code-line-number-color);transition:border-color .5s,color .5s}.vp-doc [class*=language-]>button.copy{direction:ltr;position:absolute;top:12px;right:12px;z-index:3;border:1px solid var(--vp-code-copy-code-border-color);border-radius:4px;width:40px;height:40px;background-color:var(--vp-code-copy-code-bg);opacity:0;cursor:pointer;background-image:var(--vp-icon-copy);background-position:50%;background-size:20px;background-repeat:no-repeat;transition:border-color .25s,background-color .25s,opacity .25s}.vp-doc [class*=language-]:hover>button.copy,.vp-doc [class*=language-]>button.copy:focus{opacity:1}.vp-doc [class*=language-]>button.copy:hover,.vp-doc [class*=language-]>button.copy.copied{border-color:var(--vp-code-copy-code-hover-border-color);background-color:var(--vp-code-copy-code-hover-bg)}.vp-doc [class*=language-]>button.copy.copied,.vp-doc [class*=language-]>button.copy:hover.copied{border-radius:0 4px 4px 0;background-color:var(--vp-code-copy-code-hover-bg);background-image:var(--vp-icon-copied)}.vp-doc [class*=language-]>button.copy.copied:before,.vp-doc [class*=language-]>button.copy:hover.copied:before{position:relative;top:-1px;transform:translate(calc(-100% - 1px));display:flex;justify-content:center;align-items:center;border:1px solid var(--vp-code-copy-code-hover-border-color);border-right:0;border-radius:4px 0 0 4px;padding:0 10px;width:fit-content;height:40px;text-align:center;font-size:12px;font-weight:500;color:var(--vp-code-copy-code-active-text);background-color:var(--vp-code-copy-code-hover-bg);white-space:nowrap;content:var(--vp-code-copy-copied-text-content)}.vp-doc [class*=language-]>span.lang{position:absolute;top:2px;right:8px;z-index:2;font-size:12px;font-weight:500;-webkit-user-select:none;user-select:none;color:var(--vp-code-lang-color);transition:color .4s,opacity .4s}.vp-doc [class*=language-]:hover>button.copy+span.lang,.vp-doc [class*=language-]>button.copy:focus+span.lang{opacity:0}.vp-doc .VPTeamMembers{margin-top:24px}.vp-doc .VPTeamMembers.small.count-1 .container{margin:0!important;max-width:calc((100% - 24px)/2)!important}.vp-doc .VPTeamMembers.small.count-2 .container,.vp-doc .VPTeamMembers.small.count-3 .container{max-width:100%!important}.vp-doc .VPTeamMembers.medium.count-1 .container{margin:0!important;max-width:calc((100% - 24px)/2)!important}:is(.vp-external-link-icon,.vp-doc a[href*="://"],.vp-doc a[target=_blank]):not(.no-icon):after{display:inline-block;margin-top:-1px;margin-left:4px;width:11px;height:11px;background:currentColor;color:var(--vp-c-text-3);flex-shrink:0;--icon: url("data:image/svg+xml, %3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24' %3E%3Cpath d='M0 0h24v24H0V0z' fill='none' /%3E%3Cpath d='M9 5v2h6.59L4 18.59 5.41 20 17 8.41V15h2V5H9z' /%3E%3C/svg%3E");-webkit-mask-image:var(--icon);mask-image:var(--icon)}.vp-external-link-icon:after{content:""}.external-link-icon-enabled :is(.vp-doc a[href*="://"],.vp-doc a[target=_blank]):after{content:"";color:currentColor}.vp-sponsor{border-radius:16px;overflow:hidden}.vp-sponsor.aside{border-radius:12px}.vp-sponsor-section+.vp-sponsor-section{margin-top:4px}.vp-sponsor-tier{margin:0 0 4px!important;text-align:center;letter-spacing:1px!important;line-height:24px;width:100%;font-weight:600;color:var(--vp-c-text-2);background-color:var(--vp-c-bg-soft)}.vp-sponsor.normal .vp-sponsor-tier{padding:13px 0 11px;font-size:14px}.vp-sponsor.aside .vp-sponsor-tier{padding:9px 0 7px;font-size:12px}.vp-sponsor-grid+.vp-sponsor-tier{margin-top:4px}.vp-sponsor-grid{display:flex;flex-wrap:wrap;gap:4px}.vp-sponsor-grid.xmini .vp-sponsor-grid-link{height:64px}.vp-sponsor-grid.xmini .vp-sponsor-grid-image{max-width:64px;max-height:22px}.vp-sponsor-grid.mini .vp-sponsor-grid-link{height:72px}.vp-sponsor-grid.mini .vp-sponsor-grid-image{max-width:96px;max-height:24px}.vp-sponsor-grid.small .vp-sponsor-grid-link{height:96px}.vp-sponsor-grid.small .vp-sponsor-grid-image{max-width:96px;max-height:24px}.vp-sponsor-grid.medium .vp-sponsor-grid-link{height:112px}.vp-sponsor-grid.medium .vp-sponsor-grid-image{max-width:120px;max-height:36px}.vp-sponsor-grid.big .vp-sponsor-grid-link{height:184px}.vp-sponsor-grid.big .vp-sponsor-grid-image{max-width:192px;max-height:56px}.vp-sponsor-grid[data-vp-grid="2"] .vp-sponsor-grid-item{width:calc((100% - 4px)/2)}.vp-sponsor-grid[data-vp-grid="3"] .vp-sponsor-grid-item{width:calc((100% - 4px * 2) / 3)}.vp-sponsor-grid[data-vp-grid="4"] .vp-sponsor-grid-item{width:calc((100% - 12px)/4)}.vp-sponsor-grid[data-vp-grid="5"] .vp-sponsor-grid-item{width:calc((100% - 16px)/5)}.vp-sponsor-grid[data-vp-grid="6"] .vp-sponsor-grid-item{width:calc((100% - 4px * 5) / 6)}.vp-sponsor-grid-item{flex-shrink:0;width:100%;background-color:var(--vp-c-bg-soft);transition:background-color .25s}.vp-sponsor-grid-item:hover{background-color:var(--vp-c-default-soft)}.vp-sponsor-grid-item:hover .vp-sponsor-grid-image{filter:grayscale(0) invert(0)}.vp-sponsor-grid-item.empty:hover{background-color:var(--vp-c-bg-soft)}.dark .vp-sponsor-grid-item:hover{background-color:var(--vp-c-white)}.dark .vp-sponsor-grid-item.empty:hover{background-color:var(--vp-c-bg-soft)}.vp-sponsor-grid-link{display:flex}.vp-sponsor-grid-box{display:flex;justify-content:center;align-items:center;width:100%}.vp-sponsor-grid-image{max-width:100%;filter:grayscale(1);transition:filter .25s}.dark .vp-sponsor-grid-image{filter:grayscale(1) invert(1)}.VPBadge{display:inline-block;margin-left:2px;border:1px solid transparent;border-radius:12px;padding:0 10px;line-height:22px;font-size:12px;font-weight:500;transform:translateY(-2px)}.VPBadge.small{padding:0 6px;line-height:18px;font-size:10px;transform:translateY(-8px)}.VPDocFooter .VPBadge{display:none}.vp-doc h1>.VPBadge{margin-top:4px;vertical-align:top}.vp-doc h2>.VPBadge{margin-top:3px;padding:0 8px;vertical-align:top}.vp-doc h3>.VPBadge{vertical-align:middle}.vp-doc h4>.VPBadge,.vp-doc h5>.VPBadge,.vp-doc h6>.VPBadge{vertical-align:middle;line-height:18px}.VPBadge.info{border-color:var(--vp-badge-info-border);color:var(--vp-badge-info-text);background-color:var(--vp-badge-info-bg)}.VPBadge.tip{border-color:var(--vp-badge-tip-border);color:var(--vp-badge-tip-text);background-color:var(--vp-badge-tip-bg)}.VPBadge.warning{border-color:var(--vp-badge-warning-border);color:var(--vp-badge-warning-text);background-color:var(--vp-badge-warning-bg)}.VPBadge.danger{border-color:var(--vp-badge-danger-border);color:var(--vp-badge-danger-text);background-color:var(--vp-badge-danger-bg)}.VPBackdrop[data-v-b06cdb19]{position:fixed;top:0;right:0;bottom:0;left:0;z-index:var(--vp-z-index-backdrop);background:var(--vp-backdrop-bg-color);transition:opacity .5s}.VPBackdrop.fade-enter-from[data-v-b06cdb19],.VPBackdrop.fade-leave-to[data-v-b06cdb19]{opacity:0}.VPBackdrop.fade-leave-active[data-v-b06cdb19]{transition-duration:.25s}@media (min-width: 1280px){.VPBackdrop[data-v-b06cdb19]{display:none}}.NotFound[data-v-951cab6c]{padding:64px 24px 96px;text-align:center}@media (min-width: 768px){.NotFound[data-v-951cab6c]{padding:96px 32px 168px}}.code[data-v-951cab6c]{line-height:64px;font-size:64px;font-weight:600}.title[data-v-951cab6c]{padding-top:12px;letter-spacing:2px;line-height:20px;font-size:20px;font-weight:700}.divider[data-v-951cab6c]{margin:24px auto 18px;width:64px;height:1px;background-color:var(--vp-c-divider)}.quote[data-v-951cab6c]{margin:0 auto;max-width:256px;font-size:14px;font-weight:500;color:var(--vp-c-text-2)}.action[data-v-951cab6c]{padding-top:20px}.link[data-v-951cab6c]{display:inline-block;border:1px solid var(--vp-c-brand-1);border-radius:16px;padding:3px 16px;font-size:14px;font-weight:500;color:var(--vp-c-brand-1);transition:border-color .25s,color .25s}.link[data-v-951cab6c]:hover{border-color:var(--vp-c-brand-2);color:var(--vp-c-brand-2)}.root[data-v-3f927ebe]{position:relative;z-index:1}.nested[data-v-3f927ebe]{padding-right:16px;padding-left:16px}.outline-link[data-v-3f927ebe]{display:block;line-height:32px;font-size:14px;font-weight:400;color:var(--vp-c-text-2);white-space:nowrap;overflow:hidden;text-overflow:ellipsis;transition:color .5s}.outline-link[data-v-3f927ebe]:hover,.outline-link.active[data-v-3f927ebe]{color:var(--vp-c-text-1);transition:color .25s}.outline-link.nested[data-v-3f927ebe]{padding-left:13px}.VPDocAsideOutline[data-v-b38bf2ff]{display:none}.VPDocAsideOutline.has-outline[data-v-b38bf2ff]{display:block}.content[data-v-b38bf2ff]{position:relative;border-left:1px solid var(--vp-c-divider);padding-left:16px;font-size:13px;font-weight:500}.outline-marker[data-v-b38bf2ff]{position:absolute;top:32px;left:-1px;z-index:0;opacity:0;width:2px;border-radius:2px;height:18px;background-color:var(--vp-c-brand-1);transition:top .25s cubic-bezier(0,1,.5,1),background-color .5s,opacity .25s}.outline-title[data-v-b38bf2ff]{line-height:32px;font-size:14px;font-weight:600}.VPDocAside[data-v-6d7b3c46]{display:flex;flex-direction:column;flex-grow:1}.spacer[data-v-6d7b3c46]{flex-grow:1}.VPDocAside[data-v-6d7b3c46] .spacer+.VPDocAsideSponsors,.VPDocAside[data-v-6d7b3c46] .spacer+.VPDocAsideCarbonAds{margin-top:24px}.VPDocAside[data-v-6d7b3c46] .VPDocAsideSponsors+.VPDocAsideCarbonAds{margin-top:16px}.VPLastUpdated[data-v-475f71b8]{line-height:24px;font-size:14px;font-weight:500;color:var(--vp-c-text-2)}@media (min-width: 640px){.VPLastUpdated[data-v-475f71b8]{line-height:32px;font-size:14px;font-weight:500}}.VPDocFooter[data-v-4f9813fa]{margin-top:64px}.edit-info[data-v-4f9813fa]{padding-bottom:18px}@media (min-width: 640px){.edit-info[data-v-4f9813fa]{display:flex;justify-content:space-between;align-items:center;padding-bottom:14px}}.edit-link-button[data-v-4f9813fa]{display:flex;align-items:center;border:0;line-height:32px;font-size:14px;font-weight:500;color:var(--vp-c-brand-1);transition:color .25s}.edit-link-button[data-v-4f9813fa]:hover{color:var(--vp-c-brand-2)}.edit-link-icon[data-v-4f9813fa]{margin-right:8px}.prev-next[data-v-4f9813fa]{border-top:1px solid var(--vp-c-divider);padding-top:24px;display:grid;grid-row-gap:8px}@media (min-width: 640px){.prev-next[data-v-4f9813fa]{grid-template-columns:repeat(2,1fr);grid-column-gap:16px}}.pager-link[data-v-4f9813fa]{display:block;border:1px solid var(--vp-c-divider);border-radius:8px;padding:11px 16px 13px;width:100%;height:100%;transition:border-color .25s}.pager-link[data-v-4f9813fa]:hover{border-color:var(--vp-c-brand-1)}.pager-link.next[data-v-4f9813fa]{margin-left:auto;text-align:right}.desc[data-v-4f9813fa]{display:block;line-height:20px;font-size:12px;font-weight:500;color:var(--vp-c-text-2)}.title[data-v-4f9813fa]{display:block;line-height:20px;font-size:14px;font-weight:500;color:var(--vp-c-brand-1);transition:color .25s}.VPDoc[data-v-83890dd9]{padding:32px 24px 96px;width:100%}@media (min-width: 768px){.VPDoc[data-v-83890dd9]{padding:48px 32px 128px}}@media (min-width: 960px){.VPDoc[data-v-83890dd9]{padding:48px 32px 0}.VPDoc:not(.has-sidebar) .container[data-v-83890dd9]{display:flex;justify-content:center;max-width:992px}.VPDoc:not(.has-sidebar) .content[data-v-83890dd9]{max-width:752px}}@media (min-width: 1280px){.VPDoc .container[data-v-83890dd9]{display:flex;justify-content:center}.VPDoc .aside[data-v-83890dd9]{display:block}}@media (min-width: 1440px){.VPDoc:not(.has-sidebar) .content[data-v-83890dd9]{max-width:784px}.VPDoc:not(.has-sidebar) .container[data-v-83890dd9]{max-width:1104px}}.container[data-v-83890dd9]{margin:0 auto;width:100%}.aside[data-v-83890dd9]{position:relative;display:none;order:2;flex-grow:1;padding-left:32px;width:100%;max-width:256px}.left-aside[data-v-83890dd9]{order:1;padding-left:unset;padding-right:32px}.aside-container[data-v-83890dd9]{position:fixed;top:0;padding-top:calc(var(--vp-nav-height) + var(--vp-layout-top-height, 0px) + var(--vp-doc-top-height, 0px) + 48px);width:224px;height:100vh;overflow-x:hidden;overflow-y:auto;scrollbar-width:none}.aside-container[data-v-83890dd9]::-webkit-scrollbar{display:none}.aside-curtain[data-v-83890dd9]{position:fixed;bottom:0;z-index:10;width:224px;height:32px;background:linear-gradient(transparent,var(--vp-c-bg) 70%)}.aside-content[data-v-83890dd9]{display:flex;flex-direction:column;min-height:calc(100vh - (var(--vp-nav-height) + var(--vp-layout-top-height, 0px) + 48px));padding-bottom:32px}.content[data-v-83890dd9]{position:relative;margin:0 auto;width:100%}@media (min-width: 960px){.content[data-v-83890dd9]{padding:0 32px 128px}}@media (min-width: 1280px){.content[data-v-83890dd9]{order:1;margin:0;min-width:640px}}.content-container[data-v-83890dd9]{margin:0 auto}.VPDoc.has-aside .content-container[data-v-83890dd9]{max-width:688px}.VPButton[data-v-906d7fb4]{display:inline-block;border:1px solid transparent;text-align:center;font-weight:600;white-space:nowrap;transition:color .25s,border-color .25s,background-color .25s}.VPButton[data-v-906d7fb4]:active{transition:color .1s,border-color .1s,background-color .1s}.VPButton.medium[data-v-906d7fb4]{border-radius:20px;padding:0 20px;line-height:38px;font-size:14px}.VPButton.big[data-v-906d7fb4]{border-radius:24px;padding:0 24px;line-height:46px;font-size:16px}.VPButton.brand[data-v-906d7fb4]{border-color:var(--vp-button-brand-border);color:var(--vp-button-brand-text);background-color:var(--vp-button-brand-bg)}.VPButton.brand[data-v-906d7fb4]:hover{border-color:var(--vp-button-brand-hover-border);color:var(--vp-button-brand-hover-text);background-color:var(--vp-button-brand-hover-bg)}.VPButton.brand[data-v-906d7fb4]:active{border-color:var(--vp-button-brand-active-border);color:var(--vp-button-brand-active-text);background-color:var(--vp-button-brand-active-bg)}.VPButton.alt[data-v-906d7fb4]{border-color:var(--vp-button-alt-border);color:var(--vp-button-alt-text);background-color:var(--vp-button-alt-bg)}.VPButton.alt[data-v-906d7fb4]:hover{border-color:var(--vp-button-alt-hover-border);color:var(--vp-button-alt-hover-text);background-color:var(--vp-button-alt-hover-bg)}.VPButton.alt[data-v-906d7fb4]:active{border-color:var(--vp-button-alt-active-border);color:var(--vp-button-alt-active-text);background-color:var(--vp-button-alt-active-bg)}.VPButton.sponsor[data-v-906d7fb4]{border-color:var(--vp-button-sponsor-border);color:var(--vp-button-sponsor-text);background-color:var(--vp-button-sponsor-bg)}.VPButton.sponsor[data-v-906d7fb4]:hover{border-color:var(--vp-button-sponsor-hover-border);color:var(--vp-button-sponsor-hover-text);background-color:var(--vp-button-sponsor-hover-bg)}.VPButton.sponsor[data-v-906d7fb4]:active{border-color:var(--vp-button-sponsor-active-border);color:var(--vp-button-sponsor-active-text);background-color:var(--vp-button-sponsor-active-bg)}html:not(.dark) .VPImage.dark[data-v-35a7d0b8]{display:none}.dark .VPImage.light[data-v-35a7d0b8]{display:none}.VPHero[data-v-955009fc]{margin-top:calc((var(--vp-nav-height) + var(--vp-layout-top-height, 0px)) * -1);padding:calc(var(--vp-nav-height) + var(--vp-layout-top-height, 0px) + 48px) 24px 48px}@media (min-width: 640px){.VPHero[data-v-955009fc]{padding:calc(var(--vp-nav-height) + var(--vp-layout-top-height, 0px) + 80px) 48px 64px}}@media (min-width: 960px){.VPHero[data-v-955009fc]{padding:calc(var(--vp-nav-height) + var(--vp-layout-top-height, 0px) + 80px) 64px 64px}}.container[data-v-955009fc]{display:flex;flex-direction:column;margin:0 auto;max-width:1152px}@media (min-width: 960px){.container[data-v-955009fc]{flex-direction:row}}.main[data-v-955009fc]{position:relative;z-index:10;order:2;flex-grow:1;flex-shrink:0}.VPHero.has-image .container[data-v-955009fc]{text-align:center}@media (min-width: 960px){.VPHero.has-image .container[data-v-955009fc]{text-align:left}}@media (min-width: 960px){.main[data-v-955009fc]{order:1;width:calc((100% / 3) * 2)}.VPHero.has-image .main[data-v-955009fc]{max-width:592px}}.name[data-v-955009fc],.text[data-v-955009fc]{max-width:392px;letter-spacing:-.4px;line-height:40px;font-size:32px;font-weight:700;white-space:pre-wrap}.VPHero.has-image .name[data-v-955009fc],.VPHero.has-image .text[data-v-955009fc]{margin:0 auto}.name[data-v-955009fc]{color:var(--vp-home-hero-name-color)}.clip[data-v-955009fc]{background:var(--vp-home-hero-name-background);-webkit-background-clip:text;background-clip:text;-webkit-text-fill-color:var(--vp-home-hero-name-color)}@media (min-width: 640px){.name[data-v-955009fc],.text[data-v-955009fc]{max-width:576px;line-height:56px;font-size:48px}}@media (min-width: 960px){.name[data-v-955009fc],.text[data-v-955009fc]{line-height:64px;font-size:56px}.VPHero.has-image .name[data-v-955009fc],.VPHero.has-image .text[data-v-955009fc]{margin:0}}.tagline[data-v-955009fc]{padding-top:8px;max-width:392px;line-height:28px;font-size:18px;font-weight:500;white-space:pre-wrap;color:var(--vp-c-text-2)}.VPHero.has-image .tagline[data-v-955009fc]{margin:0 auto}@media (min-width: 640px){.tagline[data-v-955009fc]{padding-top:12px;max-width:576px;line-height:32px;font-size:20px}}@media (min-width: 960px){.tagline[data-v-955009fc]{line-height:36px;font-size:24px}.VPHero.has-image .tagline[data-v-955009fc]{margin:0}}.actions[data-v-955009fc]{display:flex;flex-wrap:wrap;margin:-6px;padding-top:24px}.VPHero.has-image .actions[data-v-955009fc]{justify-content:center}@media (min-width: 640px){.actions[data-v-955009fc]{padding-top:32px}}@media (min-width: 960px){.VPHero.has-image .actions[data-v-955009fc]{justify-content:flex-start}}.action[data-v-955009fc]{flex-shrink:0;padding:6px}.image[data-v-955009fc]{order:1;margin:-76px -24px -48px}@media (min-width: 640px){.image[data-v-955009fc]{margin:-108px -24px -48px}}@media (min-width: 960px){.image[data-v-955009fc]{flex-grow:1;order:2;margin:0;min-height:100%}}.image-container[data-v-955009fc]{position:relative;margin:0 auto;width:320px;height:320px}@media (min-width: 640px){.image-container[data-v-955009fc]{width:392px;height:392px}}@media (min-width: 960px){.image-container[data-v-955009fc]{display:flex;justify-content:center;align-items:center;width:100%;height:100%;transform:translate(-32px,-32px)}}.image-bg[data-v-955009fc]{position:absolute;top:50%;left:50%;border-radius:50%;width:192px;height:192px;background-image:var(--vp-home-hero-image-background-image);filter:var(--vp-home-hero-image-filter);transform:translate(-50%,-50%)}@media (min-width: 640px){.image-bg[data-v-955009fc]{width:256px;height:256px}}@media (min-width: 960px){.image-bg[data-v-955009fc]{width:320px;height:320px}}[data-v-955009fc] .image-src{position:absolute;top:50%;left:50%;max-width:192px;max-height:192px;transform:translate(-50%,-50%)}@media (min-width: 640px){[data-v-955009fc] .image-src{max-width:256px;max-height:256px}}@media (min-width: 960px){[data-v-955009fc] .image-src{max-width:320px;max-height:320px}}.VPFeature[data-v-f5e9645b]{display:block;border:1px solid var(--vp-c-bg-soft);border-radius:12px;height:100%;background-color:var(--vp-c-bg-soft);transition:border-color .25s,background-color .25s}.VPFeature.link[data-v-f5e9645b]:hover{border-color:var(--vp-c-brand-1)}.box[data-v-f5e9645b]{display:flex;flex-direction:column;padding:24px;height:100%}.box[data-v-f5e9645b]>.VPImage{margin-bottom:20px}.icon[data-v-f5e9645b]{display:flex;justify-content:center;align-items:center;margin-bottom:20px;border-radius:6px;background-color:var(--vp-c-default-soft);width:48px;height:48px;font-size:24px;transition:background-color .25s}.title[data-v-f5e9645b]{line-height:24px;font-size:16px;font-weight:600}.details[data-v-f5e9645b]{flex-grow:1;padding-top:8px;line-height:24px;font-size:14px;font-weight:500;color:var(--vp-c-text-2)}.link-text[data-v-f5e9645b]{padding-top:8px}.link-text-value[data-v-f5e9645b]{display:flex;align-items:center;font-size:14px;font-weight:500;color:var(--vp-c-brand-1)}.link-text-icon[data-v-f5e9645b]{margin-left:6px}.VPFeatures[data-v-d0a190d7]{position:relative;padding:0 24px}@media (min-width: 640px){.VPFeatures[data-v-d0a190d7]{padding:0 48px}}@media (min-width: 960px){.VPFeatures[data-v-d0a190d7]{padding:0 64px}}.container[data-v-d0a190d7]{margin:0 auto;max-width:1152px}.items[data-v-d0a190d7]{display:flex;flex-wrap:wrap;margin:-8px}.item[data-v-d0a190d7]{padding:8px;width:100%}@media (min-width: 640px){.item.grid-2[data-v-d0a190d7],.item.grid-4[data-v-d0a190d7],.item.grid-6[data-v-d0a190d7]{width:50%}}@media (min-width: 768px){.item.grid-2[data-v-d0a190d7],.item.grid-4[data-v-d0a190d7]{width:50%}.item.grid-3[data-v-d0a190d7],.item.grid-6[data-v-d0a190d7]{width:calc(100% / 3)}}@media (min-width: 960px){.item.grid-4[data-v-d0a190d7]{width:25%}}.container[data-v-7a48a447]{margin:auto;width:100%;max-width:1280px;padding:0 24px}@media (min-width: 640px){.container[data-v-7a48a447]{padding:0 48px}}@media (min-width: 960px){.container[data-v-7a48a447]{width:100%;padding:0 64px}}.vp-doc[data-v-7a48a447] .VPHomeSponsors,.vp-doc[data-v-7a48a447] .VPTeamPage{margin-left:var(--vp-offset, calc(50% - 50vw) );margin-right:var(--vp-offset, calc(50% - 50vw) )}.vp-doc[data-v-7a48a447] .VPHomeSponsors h2{border-top:none;letter-spacing:normal}.vp-doc[data-v-7a48a447] .VPHomeSponsors a,.vp-doc[data-v-7a48a447] .VPTeamPage a{text-decoration:none}.VPHome[data-v-cbb6ec48]{margin-bottom:96px}@media (min-width: 768px){.VPHome[data-v-cbb6ec48]{margin-bottom:128px}}.VPContent[data-v-91765379]{flex-grow:1;flex-shrink:0;margin:var(--vp-layout-top-height, 0px) auto 0;width:100%}.VPContent.is-home[data-v-91765379]{width:100%;max-width:100%}.VPContent.has-sidebar[data-v-91765379]{margin:0}@media (min-width: 960px){.VPContent[data-v-91765379]{padding-top:var(--vp-nav-height)}.VPContent.has-sidebar[data-v-91765379]{margin:var(--vp-layout-top-height, 0px) 0 0;padding-left:var(--vp-sidebar-width)}}@media (min-width: 1440px){.VPContent.has-sidebar[data-v-91765379]{padding-right:calc((100vw - var(--vp-layout-max-width)) / 2);padding-left:calc((100vw - var(--vp-layout-max-width)) / 2 + var(--vp-sidebar-width))}}.VPFooter[data-v-c970a860]{position:relative;z-index:var(--vp-z-index-footer);border-top:1px solid var(--vp-c-gutter);padding:32px 24px;background-color:var(--vp-c-bg)}.VPFooter.has-sidebar[data-v-c970a860]{display:none}.VPFooter[data-v-c970a860] a{text-decoration-line:underline;text-underline-offset:2px;transition:color .25s}.VPFooter[data-v-c970a860] a:hover{color:var(--vp-c-text-1)}@media (min-width: 768px){.VPFooter[data-v-c970a860]{padding:32px}}.container[data-v-c970a860]{margin:0 auto;max-width:var(--vp-layout-max-width);text-align:center}.message[data-v-c970a860],.copyright[data-v-c970a860]{line-height:24px;font-size:14px;font-weight:500;color:var(--vp-c-text-2)}.VPLocalNavOutlineDropdown[data-v-bc9dc845]{padding:12px 20px 11px}@media (min-width: 960px){.VPLocalNavOutlineDropdown[data-v-bc9dc845]{padding:12px 36px 11px}}.VPLocalNavOutlineDropdown button[data-v-bc9dc845]{display:block;font-size:12px;font-weight:500;line-height:24px;color:var(--vp-c-text-2);transition:color .5s;position:relative}.VPLocalNavOutlineDropdown button[data-v-bc9dc845]:hover{color:var(--vp-c-text-1);transition:color .25s}.VPLocalNavOutlineDropdown button.open[data-v-bc9dc845]{color:var(--vp-c-text-1)}.icon[data-v-bc9dc845]{display:inline-block;vertical-align:middle;margin-left:2px;font-size:14px;transform:rotate(0);transition:transform .25s}@media (min-width: 960px){.VPLocalNavOutlineDropdown button[data-v-bc9dc845]{font-size:14px}.icon[data-v-bc9dc845]{font-size:16px}}.open>.icon[data-v-bc9dc845]{transform:rotate(90deg)}.items[data-v-bc9dc845]{position:absolute;top:40px;right:16px;left:16px;display:grid;gap:1px;border:1px solid var(--vp-c-border);border-radius:8px;background-color:var(--vp-c-gutter);max-height:calc(var(--vp-vh, 100vh) - 86px);overflow:hidden auto;box-shadow:var(--vp-shadow-3)}@media (min-width: 960px){.items[data-v-bc9dc845]{right:auto;left:calc(var(--vp-sidebar-width) + 32px);width:320px}}.header[data-v-bc9dc845]{background-color:var(--vp-c-bg-soft)}.top-link[data-v-bc9dc845]{display:block;padding:0 16px;line-height:48px;font-size:14px;font-weight:500;color:var(--vp-c-brand-1)}.outline[data-v-bc9dc845]{padding:8px 0;background-color:var(--vp-c-bg-soft)}.flyout-enter-active[data-v-bc9dc845]{transition:all .2s ease-out}.flyout-leave-active[data-v-bc9dc845]{transition:all .15s ease-in}.flyout-enter-from[data-v-bc9dc845],.flyout-leave-to[data-v-bc9dc845]{opacity:0;transform:translateY(-16px)}.VPLocalNav[data-v-070ab83d]{position:sticky;top:0;left:0;z-index:var(--vp-z-index-local-nav);border-bottom:1px solid var(--vp-c-gutter);padding-top:var(--vp-layout-top-height, 0px);width:100%;background-color:var(--vp-local-nav-bg-color)}.VPLocalNav.fixed[data-v-070ab83d]{position:fixed}@media (min-width: 960px){.VPLocalNav[data-v-070ab83d]{top:var(--vp-nav-height)}.VPLocalNav.has-sidebar[data-v-070ab83d]{padding-left:var(--vp-sidebar-width)}.VPLocalNav.empty[data-v-070ab83d]{display:none}}@media (min-width: 1280px){.VPLocalNav[data-v-070ab83d]{display:none}}@media (min-width: 1440px){.VPLocalNav.has-sidebar[data-v-070ab83d]{padding-left:calc((100vw - var(--vp-layout-max-width)) / 2 + var(--vp-sidebar-width))}}.container[data-v-070ab83d]{display:flex;justify-content:space-between;align-items:center}.menu[data-v-070ab83d]{display:flex;align-items:center;padding:12px 24px 11px;line-height:24px;font-size:12px;font-weight:500;color:var(--vp-c-text-2);transition:color .5s}.menu[data-v-070ab83d]:hover{color:var(--vp-c-text-1);transition:color .25s}@media (min-width: 768px){.menu[data-v-070ab83d]{padding:0 32px}}@media (min-width: 960px){.menu[data-v-070ab83d]{display:none}}.menu-icon[data-v-070ab83d]{margin-right:8px;font-size:14px}.VPOutlineDropdown[data-v-070ab83d]{padding:12px 24px 11px}@media (min-width: 768px){.VPOutlineDropdown[data-v-070ab83d]{padding:12px 32px 11px}}.VPSwitch[data-v-4a1c76db]{position:relative;border-radius:11px;display:block;width:40px;height:22px;flex-shrink:0;border:1px solid var(--vp-input-border-color);background-color:var(--vp-input-switch-bg-color);transition:border-color .25s!important}.VPSwitch[data-v-4a1c76db]:hover{border-color:var(--vp-c-brand-1)}.check[data-v-4a1c76db]{position:absolute;top:1px;left:1px;width:18px;height:18px;border-radius:50%;background-color:var(--vp-c-neutral-inverse);box-shadow:var(--vp-shadow-1);transition:transform .25s!important}.icon[data-v-4a1c76db]{position:relative;display:block;width:18px;height:18px;border-radius:50%;overflow:hidden}.icon[data-v-4a1c76db] [class^=vpi-]{position:absolute;top:3px;left:3px;width:12px;height:12px;color:var(--vp-c-text-2)}.dark .icon[data-v-4a1c76db] [class^=vpi-]{color:var(--vp-c-text-1);transition:opacity .25s!important}.sun[data-v-e40a8bb6]{opacity:1}.moon[data-v-e40a8bb6],.dark .sun[data-v-e40a8bb6]{opacity:0}.dark .moon[data-v-e40a8bb6]{opacity:1}.dark .VPSwitchAppearance[data-v-e40a8bb6] .check{transform:translate(18px)}.VPNavBarAppearance[data-v-af096f4a]{display:none}@media (min-width: 1280px){.VPNavBarAppearance[data-v-af096f4a]{display:flex;align-items:center}}.VPMenuGroup+.VPMenuLink[data-v-acbfed09]{margin:12px -12px 0;border-top:1px solid var(--vp-c-divider);padding:12px 12px 0}.link[data-v-acbfed09]{display:block;border-radius:6px;padding:0 12px;line-height:32px;font-size:14px;font-weight:500;color:var(--vp-c-text-1);white-space:nowrap;transition:background-color .25s,color .25s}.link[data-v-acbfed09]:hover{color:var(--vp-c-brand-1);background-color:var(--vp-c-default-soft)}.link.active[data-v-acbfed09]{color:var(--vp-c-brand-1)}.VPMenuGroup[data-v-48c802d0]{margin:12px -12px 0;border-top:1px solid var(--vp-c-divider);padding:12px 12px 0}.VPMenuGroup[data-v-48c802d0]:first-child{margin-top:0;border-top:0;padding-top:0}.VPMenuGroup+.VPMenuGroup[data-v-48c802d0]{margin-top:12px;border-top:1px solid var(--vp-c-divider)}.title[data-v-48c802d0]{padding:0 12px;line-height:32px;font-size:14px;font-weight:600;color:var(--vp-c-text-2);white-space:nowrap;transition:color .25s}.VPMenu[data-v-7dd3104a]{border-radius:12px;padding:12px;min-width:128px;border:1px solid var(--vp-c-divider);background-color:var(--vp-c-bg-elv);box-shadow:var(--vp-shadow-3);transition:background-color .5s;max-height:calc(100vh - var(--vp-nav-height));overflow-y:auto}.VPMenu[data-v-7dd3104a] .group{margin:0 -12px;padding:0 12px 12px}.VPMenu[data-v-7dd3104a] .group+.group{border-top:1px solid var(--vp-c-divider);padding:11px 12px 12px}.VPMenu[data-v-7dd3104a] .group:last-child{padding-bottom:0}.VPMenu[data-v-7dd3104a] .group+.item{border-top:1px solid var(--vp-c-divider);padding:11px 16px 0}.VPMenu[data-v-7dd3104a] .item{padding:0 16px;white-space:nowrap}.VPMenu[data-v-7dd3104a] .label{flex-grow:1;line-height:28px;font-size:12px;font-weight:500;color:var(--vp-c-text-2);transition:color .5s}.VPMenu[data-v-7dd3104a] .action{padding-left:24px}.VPFlyout[data-v-04f5c5e9]{position:relative}.VPFlyout[data-v-04f5c5e9]:hover{color:var(--vp-c-brand-1);transition:color .25s}.VPFlyout:hover .text[data-v-04f5c5e9]{color:var(--vp-c-text-2)}.VPFlyout:hover .icon[data-v-04f5c5e9]{fill:var(--vp-c-text-2)}.VPFlyout.active .text[data-v-04f5c5e9]{color:var(--vp-c-brand-1)}.VPFlyout.active:hover .text[data-v-04f5c5e9]{color:var(--vp-c-brand-2)}.button[aria-expanded=false]+.menu[data-v-04f5c5e9]{opacity:0;visibility:hidden;transform:translateY(0)}.VPFlyout:hover .menu[data-v-04f5c5e9],.button[aria-expanded=true]+.menu[data-v-04f5c5e9]{opacity:1;visibility:visible;transform:translateY(0)}.button[data-v-04f5c5e9]{display:flex;align-items:center;padding:0 12px;height:var(--vp-nav-height);color:var(--vp-c-text-1);transition:color .5s}.text[data-v-04f5c5e9]{display:flex;align-items:center;line-height:var(--vp-nav-height);font-size:14px;font-weight:500;color:var(--vp-c-text-1);transition:color .25s}.option-icon[data-v-04f5c5e9]{margin-right:0;font-size:16px}.text-icon[data-v-04f5c5e9]{margin-left:4px;font-size:14px}.icon[data-v-04f5c5e9]{font-size:20px;transition:fill .25s}.menu[data-v-04f5c5e9]{position:absolute;top:calc(var(--vp-nav-height) / 2 + 20px);right:0;opacity:0;visibility:hidden;transition:opacity .25s,visibility .25s,transform .25s}.VPSocialLink[data-v-d26d30cb]{display:flex;justify-content:center;align-items:center;width:36px;height:36px;color:var(--vp-c-text-2);transition:color .5s}.VPSocialLink[data-v-d26d30cb]:hover{color:var(--vp-c-text-1);transition:color .25s}.VPSocialLink[data-v-d26d30cb]>svg,.VPSocialLink[data-v-d26d30cb]>[class^=vpi-social-]{width:20px;height:20px;fill:currentColor}.VPSocialLinks[data-v-ee7a9424]{display:flex;justify-content:center}.VPNavBarExtra[data-v-925effce]{display:none;margin-right:-12px}@media (min-width: 768px){.VPNavBarExtra[data-v-925effce]{display:block}}@media (min-width: 1280px){.VPNavBarExtra[data-v-925effce]{display:none}}.trans-title[data-v-925effce]{padding:0 24px 0 12px;line-height:32px;font-size:14px;font-weight:700;color:var(--vp-c-text-1)}.item.appearance[data-v-925effce],.item.social-links[data-v-925effce]{display:flex;align-items:center;padding:0 12px}.item.appearance[data-v-925effce]{min-width:176px}.appearance-action[data-v-925effce]{margin-right:-2px}.social-links-list[data-v-925effce]{margin:-4px -8px}.VPNavBarHamburger[data-v-5dea55bf]{display:flex;justify-content:center;align-items:center;width:48px;height:var(--vp-nav-height)}@media (min-width: 768px){.VPNavBarHamburger[data-v-5dea55bf]{display:none}}.container[data-v-5dea55bf]{position:relative;width:16px;height:14px;overflow:hidden}.VPNavBarHamburger:hover .top[data-v-5dea55bf]{top:0;left:0;transform:translate(4px)}.VPNavBarHamburger:hover .middle[data-v-5dea55bf]{top:6px;left:0;transform:translate(0)}.VPNavBarHamburger:hover .bottom[data-v-5dea55bf]{top:12px;left:0;transform:translate(8px)}.VPNavBarHamburger.active .top[data-v-5dea55bf]{top:6px;transform:translate(0) rotate(225deg)}.VPNavBarHamburger.active .middle[data-v-5dea55bf]{top:6px;transform:translate(16px)}.VPNavBarHamburger.active .bottom[data-v-5dea55bf]{top:6px;transform:translate(0) rotate(135deg)}.VPNavBarHamburger.active:hover .top[data-v-5dea55bf],.VPNavBarHamburger.active:hover .middle[data-v-5dea55bf],.VPNavBarHamburger.active:hover .bottom[data-v-5dea55bf]{background-color:var(--vp-c-text-2);transition:top .25s,background-color .25s,transform .25s}.top[data-v-5dea55bf],.middle[data-v-5dea55bf],.bottom[data-v-5dea55bf]{position:absolute;width:16px;height:2px;background-color:var(--vp-c-text-1);transition:top .25s,background-color .5s,transform .25s}.top[data-v-5dea55bf]{top:0;left:0;transform:translate(0)}.middle[data-v-5dea55bf]{top:6px;left:0;transform:translate(8px)}.bottom[data-v-5dea55bf]{top:12px;left:0;transform:translate(4px)}.VPNavBarMenuLink[data-v-956ec74c]{display:flex;align-items:center;padding:0 12px;line-height:var(--vp-nav-height);font-size:14px;font-weight:500;color:var(--vp-c-text-1);transition:color .25s}.VPNavBarMenuLink.active[data-v-956ec74c],.VPNavBarMenuLink[data-v-956ec74c]:hover{color:var(--vp-c-brand-1)}.VPNavBarMenu[data-v-e6d46098]{display:none}@media (min-width: 768px){.VPNavBarMenu[data-v-e6d46098]{display:flex}}/*! @docsearch/css 3.8.0 | MIT License | © Algolia, Inc. and contributors | https://docsearch.algolia.com */:root{--docsearch-primary-color:#5468ff;--docsearch-text-color:#1c1e21;--docsearch-spacing:12px;--docsearch-icon-stroke-width:1.4;--docsearch-highlight-color:var(--docsearch-primary-color);--docsearch-muted-color:#969faf;--docsearch-container-background:rgba(101,108,133,.8);--docsearch-logo-color:#5468ff;--docsearch-modal-width:560px;--docsearch-modal-height:600px;--docsearch-modal-background:#f5f6f7;--docsearch-modal-shadow:inset 1px 1px 0 0 hsla(0,0%,100%,.5),0 3px 8px 0 #555a64;--docsearch-searchbox-height:56px;--docsearch-searchbox-background:#ebedf0;--docsearch-searchbox-focus-background:#fff;--docsearch-searchbox-shadow:inset 0 0 0 2px var(--docsearch-primary-color);--docsearch-hit-height:56px;--docsearch-hit-color:#444950;--docsearch-hit-active-color:#fff;--docsearch-hit-background:#fff;--docsearch-hit-shadow:0 1px 3px 0 #d4d9e1;--docsearch-key-gradient:linear-gradient(-225deg,#d5dbe4,#f8f8f8);--docsearch-key-shadow:inset 0 -2px 0 0 #cdcde6,inset 0 0 1px 1px #fff,0 1px 2px 1px rgba(30,35,90,.4);--docsearch-key-pressed-shadow:inset 0 -2px 0 0 #cdcde6,inset 0 0 1px 1px #fff,0 1px 1px 0 rgba(30,35,90,.4);--docsearch-footer-height:44px;--docsearch-footer-background:#fff;--docsearch-footer-shadow:0 -1px 0 0 #e0e3e8,0 -3px 6px 0 rgba(69,98,155,.12)}html[data-theme=dark]{--docsearch-text-color:#f5f6f7;--docsearch-container-background:rgba(9,10,17,.8);--docsearch-modal-background:#15172a;--docsearch-modal-shadow:inset 1px 1px 0 0 #2c2e40,0 3px 8px 0 #000309;--docsearch-searchbox-background:#090a11;--docsearch-searchbox-focus-background:#000;--docsearch-hit-color:#bec3c9;--docsearch-hit-shadow:none;--docsearch-hit-background:#090a11;--docsearch-key-gradient:linear-gradient(-26.5deg,#565872,#31355b);--docsearch-key-shadow:inset 0 -2px 0 0 #282d55,inset 0 0 1px 1px #51577d,0 2px 2px 0 rgba(3,4,9,.3);--docsearch-key-pressed-shadow:inset 0 -2px 0 0 #282d55,inset 0 0 1px 1px #51577d,0 1px 1px 0 #0304094d;--docsearch-footer-background:#1e2136;--docsearch-footer-shadow:inset 0 1px 0 0 rgba(73,76,106,.5),0 -4px 8px 0 rgba(0,0,0,.2);--docsearch-logo-color:#fff;--docsearch-muted-color:#7f8497}.DocSearch-Button{align-items:center;background:var(--docsearch-searchbox-background);border:0;border-radius:40px;color:var(--docsearch-muted-color);cursor:pointer;display:flex;font-weight:500;height:36px;justify-content:space-between;margin:0 0 0 16px;padding:0 8px;-webkit-user-select:none;user-select:none}.DocSearch-Button:active,.DocSearch-Button:focus,.DocSearch-Button:hover{background:var(--docsearch-searchbox-focus-background);box-shadow:var(--docsearch-searchbox-shadow);color:var(--docsearch-text-color);outline:none}.DocSearch-Button-Container{align-items:center;display:flex}.DocSearch-Search-Icon{stroke-width:1.6}.DocSearch-Button .DocSearch-Search-Icon{color:var(--docsearch-text-color)}.DocSearch-Button-Placeholder{font-size:1rem;padding:0 12px 0 6px}.DocSearch-Button-Keys{display:flex;min-width:calc(40px + .8em)}.DocSearch-Button-Key{align-items:center;background:var(--docsearch-key-gradient);border:0;border-radius:3px;box-shadow:var(--docsearch-key-shadow);color:var(--docsearch-muted-color);display:flex;height:18px;justify-content:center;margin-right:.4em;padding:0 0 2px;position:relative;top:-1px;width:20px}.DocSearch-Button-Key--pressed{box-shadow:var(--docsearch-key-pressed-shadow);transform:translate3d(0,1px,0)}@media (max-width:768px){.DocSearch-Button-Keys,.DocSearch-Button-Placeholder{display:none}}.DocSearch--active{overflow:hidden!important}.DocSearch-Container,.DocSearch-Container *{box-sizing:border-box}.DocSearch-Container{background-color:var(--docsearch-container-background);height:100vh;left:0;position:fixed;top:0;width:100vw;z-index:200}.DocSearch-Container a{text-decoration:none}.DocSearch-Link{-webkit-appearance:none;-moz-appearance:none;appearance:none;background:none;border:0;color:var(--docsearch-highlight-color);cursor:pointer;font:inherit;margin:0;padding:0}.DocSearch-Modal{background:var(--docsearch-modal-background);border-radius:6px;box-shadow:var(--docsearch-modal-shadow);flex-direction:column;margin:60px auto auto;max-width:var(--docsearch-modal-width);position:relative}.DocSearch-SearchBar{display:flex;padding:var(--docsearch-spacing) var(--docsearch-spacing) 0}.DocSearch-Form{align-items:center;background:var(--docsearch-searchbox-focus-background);border-radius:4px;box-shadow:var(--docsearch-searchbox-shadow);display:flex;height:var(--docsearch-searchbox-height);margin:0;padding:0 var(--docsearch-spacing);position:relative;width:100%}.DocSearch-Input{-webkit-appearance:none;-moz-appearance:none;appearance:none;background:transparent;border:0;color:var(--docsearch-text-color);flex:1;font:inherit;font-size:1.2em;height:100%;outline:none;padding:0 0 0 8px;width:80%}.DocSearch-Input::placeholder{color:var(--docsearch-muted-color);opacity:1}.DocSearch-Input::-webkit-search-cancel-button,.DocSearch-Input::-webkit-search-decoration,.DocSearch-Input::-webkit-search-results-button,.DocSearch-Input::-webkit-search-results-decoration{display:none}.DocSearch-LoadingIndicator,.DocSearch-MagnifierLabel,.DocSearch-Reset{margin:0;padding:0}.DocSearch-MagnifierLabel,.DocSearch-Reset{align-items:center;color:var(--docsearch-highlight-color);display:flex;justify-content:center}.DocSearch-Container--Stalled .DocSearch-MagnifierLabel,.DocSearch-LoadingIndicator{display:none}.DocSearch-Container--Stalled .DocSearch-LoadingIndicator{align-items:center;color:var(--docsearch-highlight-color);display:flex;justify-content:center}@media screen and (prefers-reduced-motion:reduce){.DocSearch-Reset{animation:none;-webkit-appearance:none;-moz-appearance:none;appearance:none;background:none;border:0;border-radius:50%;color:var(--docsearch-icon-color);cursor:pointer;right:0;stroke-width:var(--docsearch-icon-stroke-width)}}.DocSearch-Reset{animation:fade-in .1s ease-in forwards;-webkit-appearance:none;-moz-appearance:none;appearance:none;background:none;border:0;border-radius:50%;color:var(--docsearch-icon-color);cursor:pointer;padding:2px;right:0;stroke-width:var(--docsearch-icon-stroke-width)}.DocSearch-Reset[hidden]{display:none}.DocSearch-Reset:hover{color:var(--docsearch-highlight-color)}.DocSearch-LoadingIndicator svg,.DocSearch-MagnifierLabel svg{height:24px;width:24px}.DocSearch-Cancel{display:none}.DocSearch-Dropdown{max-height:calc(var(--docsearch-modal-height) - var(--docsearch-searchbox-height) - var(--docsearch-spacing) - var(--docsearch-footer-height));min-height:var(--docsearch-spacing);overflow-y:auto;overflow-y:overlay;padding:0 var(--docsearch-spacing);scrollbar-color:var(--docsearch-muted-color) var(--docsearch-modal-background);scrollbar-width:thin}.DocSearch-Dropdown::-webkit-scrollbar{width:12px}.DocSearch-Dropdown::-webkit-scrollbar-track{background:transparent}.DocSearch-Dropdown::-webkit-scrollbar-thumb{background-color:var(--docsearch-muted-color);border:3px solid var(--docsearch-modal-background);border-radius:20px}.DocSearch-Dropdown ul{list-style:none;margin:0;padding:0}.DocSearch-Label{font-size:.75em;line-height:1.6em}.DocSearch-Help,.DocSearch-Label{color:var(--docsearch-muted-color)}.DocSearch-Help{font-size:.9em;margin:0;-webkit-user-select:none;user-select:none}.DocSearch-Title{font-size:1.2em}.DocSearch-Logo a{display:flex}.DocSearch-Logo svg{color:var(--docsearch-logo-color);margin-left:8px}.DocSearch-Hits:last-of-type{margin-bottom:24px}.DocSearch-Hits mark{background:none;color:var(--docsearch-highlight-color)}.DocSearch-HitsFooter{color:var(--docsearch-muted-color);display:flex;font-size:.85em;justify-content:center;margin-bottom:var(--docsearch-spacing);padding:var(--docsearch-spacing)}.DocSearch-HitsFooter a{border-bottom:1px solid;color:inherit}.DocSearch-Hit{border-radius:4px;display:flex;padding-bottom:4px;position:relative}@media screen and (prefers-reduced-motion:reduce){.DocSearch-Hit--deleting{transition:none}}.DocSearch-Hit--deleting{opacity:0;transition:all .25s linear}@media screen and (prefers-reduced-motion:reduce){.DocSearch-Hit--favoriting{transition:none}}.DocSearch-Hit--favoriting{transform:scale(0);transform-origin:top center;transition:all .25s linear;transition-delay:.25s}.DocSearch-Hit a{background:var(--docsearch-hit-background);border-radius:4px;box-shadow:var(--docsearch-hit-shadow);display:block;padding-left:var(--docsearch-spacing);width:100%}.DocSearch-Hit-source{background:var(--docsearch-modal-background);color:var(--docsearch-highlight-color);font-size:.85em;font-weight:600;line-height:32px;margin:0 -4px;padding:8px 4px 0;position:sticky;top:0;z-index:10}.DocSearch-Hit-Tree{color:var(--docsearch-muted-color);height:var(--docsearch-hit-height);opacity:.5;stroke-width:var(--docsearch-icon-stroke-width);width:24px}.DocSearch-Hit[aria-selected=true] a{background-color:var(--docsearch-highlight-color)}.DocSearch-Hit[aria-selected=true] mark{text-decoration:underline}.DocSearch-Hit-Container{align-items:center;color:var(--docsearch-hit-color);display:flex;flex-direction:row;height:var(--docsearch-hit-height);padding:0 var(--docsearch-spacing) 0 0}.DocSearch-Hit-icon{height:20px;width:20px}.DocSearch-Hit-action,.DocSearch-Hit-icon{color:var(--docsearch-muted-color);stroke-width:var(--docsearch-icon-stroke-width)}.DocSearch-Hit-action{align-items:center;display:flex;height:22px;width:22px}.DocSearch-Hit-action svg{display:block;height:18px;width:18px}.DocSearch-Hit-action+.DocSearch-Hit-action{margin-left:6px}.DocSearch-Hit-action-button{-webkit-appearance:none;-moz-appearance:none;appearance:none;background:none;border:0;border-radius:50%;color:inherit;cursor:pointer;padding:2px}svg.DocSearch-Hit-Select-Icon{display:none}.DocSearch-Hit[aria-selected=true] .DocSearch-Hit-Select-Icon{display:block}.DocSearch-Hit-action-button:focus,.DocSearch-Hit-action-button:hover{background:#0003;transition:background-color .1s ease-in}@media screen and (prefers-reduced-motion:reduce){.DocSearch-Hit-action-button:focus,.DocSearch-Hit-action-button:hover{transition:none}}.DocSearch-Hit-action-button:focus path,.DocSearch-Hit-action-button:hover path{fill:#fff}.DocSearch-Hit-content-wrapper{display:flex;flex:1 1 auto;flex-direction:column;font-weight:500;justify-content:center;line-height:1.2em;margin:0 8px;overflow-x:hidden;position:relative;text-overflow:ellipsis;white-space:nowrap;width:80%}.DocSearch-Hit-title{font-size:.9em}.DocSearch-Hit-path{color:var(--docsearch-muted-color);font-size:.75em}.DocSearch-Hit[aria-selected=true] .DocSearch-Hit-Tree,.DocSearch-Hit[aria-selected=true] .DocSearch-Hit-action,.DocSearch-Hit[aria-selected=true] .DocSearch-Hit-icon,.DocSearch-Hit[aria-selected=true] .DocSearch-Hit-path,.DocSearch-Hit[aria-selected=true] .DocSearch-Hit-text,.DocSearch-Hit[aria-selected=true] .DocSearch-Hit-title,.DocSearch-Hit[aria-selected=true] mark{color:var(--docsearch-hit-active-color)!important}@media screen and (prefers-reduced-motion:reduce){.DocSearch-Hit-action-button:focus,.DocSearch-Hit-action-button:hover{background:#0003;transition:none}}.DocSearch-ErrorScreen,.DocSearch-NoResults,.DocSearch-StartScreen{font-size:.9em;margin:0 auto;padding:36px 0;text-align:center;width:80%}.DocSearch-Screen-Icon{color:var(--docsearch-muted-color);padding-bottom:12px}.DocSearch-NoResults-Prefill-List{display:inline-block;padding-bottom:24px;text-align:left}.DocSearch-NoResults-Prefill-List ul{display:inline-block;padding:8px 0 0}.DocSearch-NoResults-Prefill-List li{list-style-position:inside;list-style-type:"» "}.DocSearch-Prefill{-webkit-appearance:none;-moz-appearance:none;appearance:none;background:none;border:0;border-radius:1em;color:var(--docsearch-highlight-color);cursor:pointer;display:inline-block;font-size:1em;font-weight:700;padding:0}.DocSearch-Prefill:focus,.DocSearch-Prefill:hover{outline:none;text-decoration:underline}.DocSearch-Footer{align-items:center;background:var(--docsearch-footer-background);border-radius:0 0 8px 8px;box-shadow:var(--docsearch-footer-shadow);display:flex;flex-direction:row-reverse;flex-shrink:0;height:var(--docsearch-footer-height);justify-content:space-between;padding:0 var(--docsearch-spacing);position:relative;-webkit-user-select:none;user-select:none;width:100%;z-index:300}.DocSearch-Commands{color:var(--docsearch-muted-color);display:flex;list-style:none;margin:0;padding:0}.DocSearch-Commands li{align-items:center;display:flex}.DocSearch-Commands li:not(:last-of-type){margin-right:.8em}.DocSearch-Commands-Key{align-items:center;background:var(--docsearch-key-gradient);border:0;border-radius:2px;box-shadow:var(--docsearch-key-shadow);color:var(--docsearch-muted-color);display:flex;height:18px;justify-content:center;margin-right:.4em;padding:0 0 1px;width:20px}.DocSearch-VisuallyHiddenForAccessibility{clip:rect(0 0 0 0);clip-path:inset(50%);height:1px;overflow:hidden;position:absolute;white-space:nowrap;width:1px}@media (max-width:768px){:root{--docsearch-spacing:10px;--docsearch-footer-height:40px}.DocSearch-Dropdown{height:100%}.DocSearch-Container{height:100vh;height:-webkit-fill-available;height:calc(var(--docsearch-vh, 1vh)*100);position:absolute}.DocSearch-Footer{border-radius:0;bottom:0;position:absolute}.DocSearch-Hit-content-wrapper{display:flex;position:relative;width:80%}.DocSearch-Modal{border-radius:0;box-shadow:none;height:100vh;height:-webkit-fill-available;height:calc(var(--docsearch-vh, 1vh)*100);margin:0;max-width:100%;width:100%}.DocSearch-Dropdown{max-height:calc(var(--docsearch-vh, 1vh)*100 - var(--docsearch-searchbox-height) - var(--docsearch-spacing) - var(--docsearch-footer-height))}.DocSearch-Cancel{-webkit-appearance:none;-moz-appearance:none;appearance:none;background:none;border:0;color:var(--docsearch-highlight-color);cursor:pointer;display:inline-block;flex:none;font:inherit;font-size:1em;font-weight:500;margin-left:var(--docsearch-spacing);outline:none;overflow:hidden;padding:0;-webkit-user-select:none;user-select:none;white-space:nowrap}.DocSearch-Commands,.DocSearch-Hit-Tree{display:none}}@keyframes fade-in{0%{opacity:0}to{opacity:1}}[class*=DocSearch]{--docsearch-primary-color: var(--vp-c-brand-1);--docsearch-highlight-color: var(--docsearch-primary-color);--docsearch-text-color: var(--vp-c-text-1);--docsearch-muted-color: var(--vp-c-text-2);--docsearch-searchbox-shadow: none;--docsearch-searchbox-background: transparent;--docsearch-searchbox-focus-background: transparent;--docsearch-key-gradient: transparent;--docsearch-key-shadow: none;--docsearch-modal-background: var(--vp-c-bg-soft);--docsearch-footer-background: var(--vp-c-bg)}.dark [class*=DocSearch]{--docsearch-modal-shadow: none;--docsearch-footer-shadow: none;--docsearch-logo-color: var(--vp-c-text-2);--docsearch-hit-background: var(--vp-c-default-soft);--docsearch-hit-color: var(--vp-c-text-2);--docsearch-hit-shadow: none}.DocSearch-Button{display:flex;justify-content:center;align-items:center;margin:0;padding:0;width:48px;height:55px;background:transparent;transition:border-color .25s}.DocSearch-Button:hover{background:transparent}.DocSearch-Button:focus{outline:1px dotted;outline:5px auto -webkit-focus-ring-color}.DocSearch-Button-Key--pressed{transform:none;box-shadow:none}.DocSearch-Button:focus:not(:focus-visible){outline:none!important}@media (min-width: 768px){.DocSearch-Button{justify-content:flex-start;border:1px solid transparent;border-radius:8px;padding:0 10px 0 12px;width:100%;height:40px;background-color:var(--vp-c-bg-alt)}.DocSearch-Button:hover{border-color:var(--vp-c-brand-1);background:var(--vp-c-bg-alt)}}.DocSearch-Button .DocSearch-Button-Container{display:flex;align-items:center}.DocSearch-Button .DocSearch-Search-Icon{position:relative;width:16px;height:16px;color:var(--vp-c-text-1);fill:currentColor;transition:color .5s}.DocSearch-Button:hover .DocSearch-Search-Icon{color:var(--vp-c-text-1)}@media (min-width: 768px){.DocSearch-Button .DocSearch-Search-Icon{top:1px;margin-right:8px;width:14px;height:14px;color:var(--vp-c-text-2)}}.DocSearch-Button .DocSearch-Button-Placeholder{display:none;margin-top:2px;padding:0 16px 0 0;font-size:13px;font-weight:500;color:var(--vp-c-text-2);transition:color .5s}.DocSearch-Button:hover .DocSearch-Button-Placeholder{color:var(--vp-c-text-1)}@media (min-width: 768px){.DocSearch-Button .DocSearch-Button-Placeholder{display:inline-block}}.DocSearch-Button .DocSearch-Button-Keys{direction:ltr;display:none;min-width:auto}@media (min-width: 768px){.DocSearch-Button .DocSearch-Button-Keys{display:flex;align-items:center}}.DocSearch-Button .DocSearch-Button-Key{display:block;margin:2px 0 0;border:1px solid var(--vp-c-divider);border-right:none;border-radius:4px 0 0 4px;padding-left:6px;min-width:0;width:auto;height:22px;line-height:22px;font-family:var(--vp-font-family-base);font-size:12px;font-weight:500;transition:color .5s,border-color .5s}.DocSearch-Button .DocSearch-Button-Key+.DocSearch-Button-Key{border-right:1px solid var(--vp-c-divider);border-left:none;border-radius:0 4px 4px 0;padding-left:2px;padding-right:6px}.DocSearch-Button .DocSearch-Button-Key:first-child{font-size:0!important}.DocSearch-Button .DocSearch-Button-Key:first-child:after{content:"Ctrl";font-size:12px;letter-spacing:normal;color:var(--docsearch-muted-color)}.mac .DocSearch-Button .DocSearch-Button-Key:first-child:after{content:"⌘"}.DocSearch-Button .DocSearch-Button-Key:first-child>*{display:none}.DocSearch-Search-Icon{--icon: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' stroke-width='1.6' viewBox='0 0 20 20'%3E%3Cpath fill='none' stroke='currentColor' stroke-linecap='round' stroke-linejoin='round' d='m14.386 14.386 4.088 4.088-4.088-4.088A7.533 7.533 0 1 1 3.733 3.733a7.533 7.533 0 0 1 10.653 10.653z'/%3E%3C/svg%3E")}.VPNavBarSearch{display:flex;align-items:center}@media (min-width: 768px){.VPNavBarSearch{flex-grow:1;padding-left:24px}}@media (min-width: 960px){.VPNavBarSearch{padding-left:32px}}.dark .DocSearch-Footer{border-top:1px solid var(--vp-c-divider)}.DocSearch-Form{border:1px solid var(--vp-c-brand-1);background-color:var(--vp-c-white)}.dark .DocSearch-Form{background-color:var(--vp-c-default-soft)}.DocSearch-Screen-Icon>svg{margin:auto}.VPNavBarSocialLinks[data-v-164c457f]{display:none}@media (min-width: 1280px){.VPNavBarSocialLinks[data-v-164c457f]{display:flex;align-items:center}}.title[data-v-0f4f798b]{display:flex;align-items:center;border-bottom:1px solid transparent;width:100%;height:var(--vp-nav-height);font-size:16px;font-weight:600;color:var(--vp-c-text-1);transition:opacity .25s}@media (min-width: 960px){.title[data-v-0f4f798b]{flex-shrink:0}.VPNavBarTitle.has-sidebar .title[data-v-0f4f798b]{border-bottom-color:var(--vp-c-divider)}}[data-v-0f4f798b] .logo{margin-right:8px;height:var(--vp-nav-logo-height)}.VPNavBarTranslations[data-v-c80d9ad0]{display:none}@media (min-width: 1280px){.VPNavBarTranslations[data-v-c80d9ad0]{display:flex;align-items:center}}.title[data-v-c80d9ad0]{padding:0 24px 0 12px;line-height:32px;font-size:14px;font-weight:700;color:var(--vp-c-text-1)}.VPNavBar[data-v-822684d1]{position:relative;height:var(--vp-nav-height);pointer-events:none;white-space:nowrap;transition:background-color .25s}.VPNavBar.screen-open[data-v-822684d1]{transition:none;background-color:var(--vp-nav-bg-color);border-bottom:1px solid var(--vp-c-divider)}.VPNavBar[data-v-822684d1]:not(.home){background-color:var(--vp-nav-bg-color)}@media (min-width: 960px){.VPNavBar[data-v-822684d1]:not(.home){background-color:transparent}.VPNavBar[data-v-822684d1]:not(.has-sidebar):not(.home.top){background-color:var(--vp-nav-bg-color)}}.wrapper[data-v-822684d1]{padding:0 8px 0 24px}@media (min-width: 768px){.wrapper[data-v-822684d1]{padding:0 32px}}@media (min-width: 960px){.VPNavBar.has-sidebar .wrapper[data-v-822684d1]{padding:0}}.container[data-v-822684d1]{display:flex;justify-content:space-between;margin:0 auto;max-width:calc(var(--vp-layout-max-width) - 64px);height:var(--vp-nav-height);pointer-events:none}.container>.title[data-v-822684d1],.container>.content[data-v-822684d1]{pointer-events:none}.container[data-v-822684d1] *{pointer-events:auto}@media (min-width: 960px){.VPNavBar.has-sidebar .container[data-v-822684d1]{max-width:100%}}.title[data-v-822684d1]{flex-shrink:0;height:calc(var(--vp-nav-height) - 1px);transition:background-color .5s}@media (min-width: 960px){.VPNavBar.has-sidebar .title[data-v-822684d1]{position:absolute;top:0;left:0;z-index:2;padding:0 32px;width:var(--vp-sidebar-width);height:var(--vp-nav-height);background-color:transparent}}@media (min-width: 1440px){.VPNavBar.has-sidebar .title[data-v-822684d1]{padding-left:max(32px,calc((100% - (var(--vp-layout-max-width) - 64px)) / 2));width:calc((100% - (var(--vp-layout-max-width) - 64px)) / 2 + var(--vp-sidebar-width) - 32px)}}.content[data-v-822684d1]{flex-grow:1}@media (min-width: 960px){.VPNavBar.has-sidebar .content[data-v-822684d1]{position:relative;z-index:1;padding-right:32px;padding-left:var(--vp-sidebar-width)}}@media (min-width: 1440px){.VPNavBar.has-sidebar .content[data-v-822684d1]{padding-right:calc((100vw - var(--vp-layout-max-width)) / 2 + 32px);padding-left:calc((100vw - var(--vp-layout-max-width)) / 2 + var(--vp-sidebar-width))}}.content-body[data-v-822684d1]{display:flex;justify-content:flex-end;align-items:center;height:var(--vp-nav-height);transition:background-color .5s}@media (min-width: 960px){.VPNavBar:not(.home.top) .content-body[data-v-822684d1]{position:relative;background-color:var(--vp-nav-bg-color)}.VPNavBar:not(.has-sidebar):not(.home.top) .content-body[data-v-822684d1]{background-color:transparent}}@media (max-width: 767px){.content-body[data-v-822684d1]{column-gap:.5rem}}.menu+.translations[data-v-822684d1]:before,.menu+.appearance[data-v-822684d1]:before,.menu+.social-links[data-v-822684d1]:before,.translations+.appearance[data-v-822684d1]:before,.appearance+.social-links[data-v-822684d1]:before{margin-right:8px;margin-left:8px;width:1px;height:24px;background-color:var(--vp-c-divider);content:""}.menu+.appearance[data-v-822684d1]:before,.translations+.appearance[data-v-822684d1]:before{margin-right:16px}.appearance+.social-links[data-v-822684d1]:before{margin-left:16px}.social-links[data-v-822684d1]{margin-right:-8px}.divider[data-v-822684d1]{width:100%;height:1px}@media (min-width: 960px){.VPNavBar.has-sidebar .divider[data-v-822684d1]{padding-left:var(--vp-sidebar-width)}}@media (min-width: 1440px){.VPNavBar.has-sidebar .divider[data-v-822684d1]{padding-left:calc((100vw - var(--vp-layout-max-width)) / 2 + var(--vp-sidebar-width))}}.divider-line[data-v-822684d1]{width:100%;height:1px;transition:background-color .5s}.VPNavBar:not(.home) .divider-line[data-v-822684d1]{background-color:var(--vp-c-gutter)}@media (min-width: 960px){.VPNavBar:not(.home.top) .divider-line[data-v-822684d1]{background-color:var(--vp-c-gutter)}.VPNavBar:not(.has-sidebar):not(.home.top) .divider[data-v-822684d1]{background-color:var(--vp-c-gutter)}}.VPNavScreenAppearance[data-v-ffb44008]{display:flex;justify-content:space-between;align-items:center;border-radius:8px;padding:12px 14px 12px 16px;background-color:var(--vp-c-bg-soft)}.text[data-v-ffb44008]{line-height:24px;font-size:12px;font-weight:500;color:var(--vp-c-text-2)}.VPNavScreenMenuLink[data-v-735512b8]{display:block;border-bottom:1px solid var(--vp-c-divider);padding:12px 0 11px;line-height:24px;font-size:14px;font-weight:500;color:var(--vp-c-text-1);transition:border-color .25s,color .25s}.VPNavScreenMenuLink[data-v-735512b8]:hover{color:var(--vp-c-brand-1)}.VPNavScreenMenuGroupLink[data-v-372ae7c0]{display:block;margin-left:12px;line-height:32px;font-size:14px;font-weight:400;color:var(--vp-c-text-1);transition:color .25s}.VPNavScreenMenuGroupLink[data-v-372ae7c0]:hover{color:var(--vp-c-brand-1)}.VPNavScreenMenuGroupSection[data-v-4b8941ac]{display:block}.title[data-v-4b8941ac]{line-height:32px;font-size:13px;font-weight:700;color:var(--vp-c-text-2);transition:color .25s}.VPNavScreenMenuGroup[data-v-875057a5]{border-bottom:1px solid var(--vp-c-divider);height:48px;overflow:hidden;transition:border-color .5s}.VPNavScreenMenuGroup .items[data-v-875057a5]{visibility:hidden}.VPNavScreenMenuGroup.open .items[data-v-875057a5]{visibility:visible}.VPNavScreenMenuGroup.open[data-v-875057a5]{padding-bottom:10px;height:auto}.VPNavScreenMenuGroup.open .button[data-v-875057a5]{padding-bottom:6px;color:var(--vp-c-brand-1)}.VPNavScreenMenuGroup.open .button-icon[data-v-875057a5]{transform:rotate(45deg)}.button[data-v-875057a5]{display:flex;justify-content:space-between;align-items:center;padding:12px 4px 11px 0;width:100%;line-height:24px;font-size:14px;font-weight:500;color:var(--vp-c-text-1);transition:color .25s}.button[data-v-875057a5]:hover{color:var(--vp-c-brand-1)}.button-icon[data-v-875057a5]{transition:transform .25s}.group[data-v-875057a5]:first-child{padding-top:0}.group+.group[data-v-875057a5],.group+.item[data-v-875057a5]{padding-top:4px}.VPNavScreenTranslations[data-v-362991c2]{height:24px;overflow:hidden}.VPNavScreenTranslations.open[data-v-362991c2]{height:auto}.title[data-v-362991c2]{display:flex;align-items:center;font-size:14px;font-weight:500;color:var(--vp-c-text-1)}.icon[data-v-362991c2]{font-size:16px}.icon.lang[data-v-362991c2]{margin-right:8px}.icon.chevron[data-v-362991c2]{margin-left:4px}.list[data-v-362991c2]{padding:4px 0 0 24px}.link[data-v-362991c2]{line-height:32px;font-size:13px;color:var(--vp-c-text-1)}.VPNavScreen[data-v-833aabba]{position:fixed;top:calc(var(--vp-nav-height) + var(--vp-layout-top-height, 0px));right:0;bottom:0;left:0;padding:0 32px;width:100%;background-color:var(--vp-nav-screen-bg-color);overflow-y:auto;transition:background-color .25s;pointer-events:auto}.VPNavScreen.fade-enter-active[data-v-833aabba],.VPNavScreen.fade-leave-active[data-v-833aabba]{transition:opacity .25s}.VPNavScreen.fade-enter-active .container[data-v-833aabba],.VPNavScreen.fade-leave-active .container[data-v-833aabba]{transition:transform .25s ease}.VPNavScreen.fade-enter-from[data-v-833aabba],.VPNavScreen.fade-leave-to[data-v-833aabba]{opacity:0}.VPNavScreen.fade-enter-from .container[data-v-833aabba],.VPNavScreen.fade-leave-to .container[data-v-833aabba]{transform:translateY(-8px)}@media (min-width: 768px){.VPNavScreen[data-v-833aabba]{display:none}}.container[data-v-833aabba]{margin:0 auto;padding:24px 0 96px;max-width:288px}.menu+.translations[data-v-833aabba],.menu+.appearance[data-v-833aabba],.translations+.appearance[data-v-833aabba]{margin-top:24px}.menu+.social-links[data-v-833aabba]{margin-top:16px}.appearance+.social-links[data-v-833aabba]{margin-top:16px}.VPNav[data-v-f1e365da]{position:relative;top:var(--vp-layout-top-height, 0px);left:0;z-index:var(--vp-z-index-nav);width:100%;pointer-events:none;transition:background-color .5s}@media (min-width: 960px){.VPNav[data-v-f1e365da]{position:fixed}}.VPSidebarItem.level-0[data-v-196b2e5f]{padding-bottom:24px}.VPSidebarItem.collapsed.level-0[data-v-196b2e5f]{padding-bottom:10px}.item[data-v-196b2e5f]{position:relative;display:flex;width:100%}.VPSidebarItem.collapsible>.item[data-v-196b2e5f]{cursor:pointer}.indicator[data-v-196b2e5f]{position:absolute;top:6px;bottom:6px;left:-17px;width:2px;border-radius:2px;transition:background-color .25s}.VPSidebarItem.level-2.is-active>.item>.indicator[data-v-196b2e5f],.VPSidebarItem.level-3.is-active>.item>.indicator[data-v-196b2e5f],.VPSidebarItem.level-4.is-active>.item>.indicator[data-v-196b2e5f],.VPSidebarItem.level-5.is-active>.item>.indicator[data-v-196b2e5f]{background-color:var(--vp-c-brand-1)}.link[data-v-196b2e5f]{display:flex;align-items:center;flex-grow:1}.text[data-v-196b2e5f]{flex-grow:1;padding:4px 0;line-height:24px;font-size:14px;transition:color .25s}.VPSidebarItem.level-0 .text[data-v-196b2e5f]{font-weight:700;color:var(--vp-c-text-1)}.VPSidebarItem.level-1 .text[data-v-196b2e5f],.VPSidebarItem.level-2 .text[data-v-196b2e5f],.VPSidebarItem.level-3 .text[data-v-196b2e5f],.VPSidebarItem.level-4 .text[data-v-196b2e5f],.VPSidebarItem.level-5 .text[data-v-196b2e5f]{font-weight:500;color:var(--vp-c-text-2)}.VPSidebarItem.level-0.is-link>.item>.link:hover .text[data-v-196b2e5f],.VPSidebarItem.level-1.is-link>.item>.link:hover .text[data-v-196b2e5f],.VPSidebarItem.level-2.is-link>.item>.link:hover .text[data-v-196b2e5f],.VPSidebarItem.level-3.is-link>.item>.link:hover .text[data-v-196b2e5f],.VPSidebarItem.level-4.is-link>.item>.link:hover .text[data-v-196b2e5f],.VPSidebarItem.level-5.is-link>.item>.link:hover .text[data-v-196b2e5f]{color:var(--vp-c-brand-1)}.VPSidebarItem.level-0.has-active>.item>.text[data-v-196b2e5f],.VPSidebarItem.level-1.has-active>.item>.text[data-v-196b2e5f],.VPSidebarItem.level-2.has-active>.item>.text[data-v-196b2e5f],.VPSidebarItem.level-3.has-active>.item>.text[data-v-196b2e5f],.VPSidebarItem.level-4.has-active>.item>.text[data-v-196b2e5f],.VPSidebarItem.level-5.has-active>.item>.text[data-v-196b2e5f],.VPSidebarItem.level-0.has-active>.item>.link>.text[data-v-196b2e5f],.VPSidebarItem.level-1.has-active>.item>.link>.text[data-v-196b2e5f],.VPSidebarItem.level-2.has-active>.item>.link>.text[data-v-196b2e5f],.VPSidebarItem.level-3.has-active>.item>.link>.text[data-v-196b2e5f],.VPSidebarItem.level-4.has-active>.item>.link>.text[data-v-196b2e5f],.VPSidebarItem.level-5.has-active>.item>.link>.text[data-v-196b2e5f]{color:var(--vp-c-text-1)}.VPSidebarItem.level-0.is-active>.item .link>.text[data-v-196b2e5f],.VPSidebarItem.level-1.is-active>.item .link>.text[data-v-196b2e5f],.VPSidebarItem.level-2.is-active>.item .link>.text[data-v-196b2e5f],.VPSidebarItem.level-3.is-active>.item .link>.text[data-v-196b2e5f],.VPSidebarItem.level-4.is-active>.item .link>.text[data-v-196b2e5f],.VPSidebarItem.level-5.is-active>.item .link>.text[data-v-196b2e5f]{color:var(--vp-c-brand-1)}.caret[data-v-196b2e5f]{display:flex;justify-content:center;align-items:center;margin-right:-7px;width:32px;height:32px;color:var(--vp-c-text-3);cursor:pointer;transition:color .25s;flex-shrink:0}.item:hover .caret[data-v-196b2e5f]{color:var(--vp-c-text-2)}.item:hover .caret[data-v-196b2e5f]:hover{color:var(--vp-c-text-1)}.caret-icon[data-v-196b2e5f]{font-size:18px;transform:rotate(90deg);transition:transform .25s}.VPSidebarItem.collapsed .caret-icon[data-v-196b2e5f]{transform:rotate(0)}.VPSidebarItem.level-1 .items[data-v-196b2e5f],.VPSidebarItem.level-2 .items[data-v-196b2e5f],.VPSidebarItem.level-3 .items[data-v-196b2e5f],.VPSidebarItem.level-4 .items[data-v-196b2e5f],.VPSidebarItem.level-5 .items[data-v-196b2e5f]{border-left:1px solid var(--vp-c-divider);padding-left:16px}.VPSidebarItem.collapsed .items[data-v-196b2e5f]{display:none}.no-transition[data-v-9e426adc] .caret-icon{transition:none}.group+.group[data-v-9e426adc]{border-top:1px solid var(--vp-c-divider);padding-top:10px}@media (min-width: 960px){.group[data-v-9e426adc]{padding-top:10px;width:calc(var(--vp-sidebar-width) - 64px)}}.VPSidebar[data-v-18756405]{position:fixed;top:var(--vp-layout-top-height, 0px);bottom:0;left:0;z-index:var(--vp-z-index-sidebar);padding:32px 32px 96px;width:calc(100vw - 64px);max-width:320px;background-color:var(--vp-sidebar-bg-color);opacity:0;box-shadow:var(--vp-c-shadow-3);overflow-x:hidden;overflow-y:auto;transform:translate(-100%);transition:opacity .5s,transform .25s ease;overscroll-behavior:contain}.VPSidebar.open[data-v-18756405]{opacity:1;visibility:visible;transform:translate(0);transition:opacity .25s,transform .5s cubic-bezier(.19,1,.22,1)}.dark .VPSidebar[data-v-18756405]{box-shadow:var(--vp-shadow-1)}@media (min-width: 960px){.VPSidebar[data-v-18756405]{padding-top:var(--vp-nav-height);width:var(--vp-sidebar-width);max-width:100%;background-color:var(--vp-sidebar-bg-color);opacity:1;visibility:visible;box-shadow:none;transform:translate(0)}}@media (min-width: 1440px){.VPSidebar[data-v-18756405]{padding-left:max(32px,calc((100% - (var(--vp-layout-max-width) - 64px)) / 2));width:calc((100% - (var(--vp-layout-max-width) - 64px)) / 2 + var(--vp-sidebar-width) - 32px)}}@media (min-width: 960px){.curtain[data-v-18756405]{position:sticky;top:-64px;left:0;z-index:1;margin-top:calc(var(--vp-nav-height) * -1);margin-right:-32px;margin-left:-32px;height:var(--vp-nav-height);background-color:var(--vp-sidebar-bg-color)}}.nav[data-v-18756405]{outline:0}.VPSkipLink[data-v-c3508ec8]{top:8px;left:8px;padding:8px 16px;z-index:999;border-radius:8px;font-size:12px;font-weight:700;text-decoration:none;color:var(--vp-c-brand-1);box-shadow:var(--vp-shadow-3);background-color:var(--vp-c-bg)}.VPSkipLink[data-v-c3508ec8]:focus{height:auto;width:auto;clip:auto;clip-path:none}@media (min-width: 1280px){.VPSkipLink[data-v-c3508ec8]{top:14px;left:16px}}.Layout[data-v-a9a9e638]{display:flex;flex-direction:column;min-height:100vh}.VPHomeSponsors[data-v-db81191c]{border-top:1px solid var(--vp-c-gutter);padding-top:88px!important}.VPHomeSponsors[data-v-db81191c]{margin:96px 0}@media (min-width: 768px){.VPHomeSponsors[data-v-db81191c]{margin:128px 0}}.VPHomeSponsors[data-v-db81191c]{padding:0 24px}@media (min-width: 768px){.VPHomeSponsors[data-v-db81191c]{padding:0 48px}}@media (min-width: 960px){.VPHomeSponsors[data-v-db81191c]{padding:0 64px}}.container[data-v-db81191c]{margin:0 auto;max-width:1152px}.love[data-v-db81191c]{margin:0 auto;width:fit-content;font-size:28px;color:var(--vp-c-text-3)}.icon[data-v-db81191c]{display:inline-block}.message[data-v-db81191c]{margin:0 auto;padding-top:10px;max-width:320px;text-align:center;line-height:24px;font-size:16px;font-weight:500;color:var(--vp-c-text-2)}.sponsors[data-v-db81191c]{padding-top:32px}.action[data-v-db81191c]{padding-top:40px;text-align:center}.VPTeamPage[data-v-c2f8e101]{margin:96px 0}@media (min-width: 768px){.VPTeamPage[data-v-c2f8e101]{margin:128px 0}}.VPHome .VPTeamPageTitle[data-v-c2f8e101-s]{border-top:1px solid var(--vp-c-gutter);padding-top:88px!important}.VPTeamPageSection+.VPTeamPageSection[data-v-c2f8e101-s],.VPTeamMembers+.VPTeamPageSection[data-v-c2f8e101-s]{margin-top:64px}.VPTeamMembers+.VPTeamMembers[data-v-c2f8e101-s]{margin-top:24px}@media (min-width: 768px){.VPTeamPageTitle+.VPTeamPageSection[data-v-c2f8e101-s]{margin-top:16px}.VPTeamPageSection+.VPTeamPageSection[data-v-c2f8e101-s],.VPTeamMembers+.VPTeamPageSection[data-v-c2f8e101-s]{margin-top:96px}}.VPTeamMembers[data-v-c2f8e101-s]{padding:0 24px}@media (min-width: 768px){.VPTeamMembers[data-v-c2f8e101-s]{padding:0 48px}}@media (min-width: 960px){.VPTeamMembers[data-v-c2f8e101-s]{padding:0 64px}}.VPTeamPageTitle[data-v-e277e15c]{padding:48px 32px;text-align:center}@media (min-width: 768px){.VPTeamPageTitle[data-v-e277e15c]{padding:64px 48px 48px}}@media (min-width: 960px){.VPTeamPageTitle[data-v-e277e15c]{padding:80px 64px 48px}}.title[data-v-e277e15c]{letter-spacing:0;line-height:44px;font-size:36px;font-weight:500}@media (min-width: 768px){.title[data-v-e277e15c]{letter-spacing:-.5px;line-height:56px;font-size:48px}}.lead[data-v-e277e15c]{margin:0 auto;max-width:512px;padding-top:12px;line-height:24px;font-size:16px;font-weight:500;color:var(--vp-c-text-2)}@media (min-width: 768px){.lead[data-v-e277e15c]{max-width:592px;letter-spacing:.15px;line-height:28px;font-size:20px}}.VPTeamPageSection[data-v-d43bc49d]{padding:0 32px}@media (min-width: 768px){.VPTeamPageSection[data-v-d43bc49d]{padding:0 48px}}@media (min-width: 960px){.VPTeamPageSection[data-v-d43bc49d]{padding:0 64px}}.title[data-v-d43bc49d]{position:relative;margin:0 auto;max-width:1152px;text-align:center;color:var(--vp-c-text-2)}.title-line[data-v-d43bc49d]{position:absolute;top:16px;left:0;width:100%;height:1px;background-color:var(--vp-c-divider)}.title-text[data-v-d43bc49d]{position:relative;display:inline-block;padding:0 24px;letter-spacing:0;line-height:32px;font-size:20px;font-weight:500;background-color:var(--vp-c-bg)}.lead[data-v-d43bc49d]{margin:0 auto;max-width:480px;padding-top:12px;text-align:center;line-height:24px;font-size:16px;font-weight:500;color:var(--vp-c-text-2)}.members[data-v-d43bc49d]{padding-top:40px}.VPTeamMembersItem[data-v-f9987cb6]{display:flex;flex-direction:column;gap:2px;border-radius:12px;width:100%;height:100%;overflow:hidden}.VPTeamMembersItem.small .profile[data-v-f9987cb6]{padding:32px}.VPTeamMembersItem.small .data[data-v-f9987cb6]{padding-top:20px}.VPTeamMembersItem.small .avatar[data-v-f9987cb6]{width:64px;height:64px}.VPTeamMembersItem.small .name[data-v-f9987cb6]{line-height:24px;font-size:16px}.VPTeamMembersItem.small .affiliation[data-v-f9987cb6]{padding-top:4px;line-height:20px;font-size:14px}.VPTeamMembersItem.small .desc[data-v-f9987cb6]{padding-top:12px;line-height:20px;font-size:14px}.VPTeamMembersItem.small .links[data-v-f9987cb6]{margin:0 -16px -20px;padding:10px 0 0}.VPTeamMembersItem.medium .profile[data-v-f9987cb6]{padding:48px 32px}.VPTeamMembersItem.medium .data[data-v-f9987cb6]{padding-top:24px;text-align:center}.VPTeamMembersItem.medium .avatar[data-v-f9987cb6]{width:96px;height:96px}.VPTeamMembersItem.medium .name[data-v-f9987cb6]{letter-spacing:.15px;line-height:28px;font-size:20px}.VPTeamMembersItem.medium .affiliation[data-v-f9987cb6]{padding-top:4px;font-size:16px}.VPTeamMembersItem.medium .desc[data-v-f9987cb6]{padding-top:16px;max-width:288px;font-size:16px}.VPTeamMembersItem.medium .links[data-v-f9987cb6]{margin:0 -16px -12px;padding:16px 12px 0}.profile[data-v-f9987cb6]{flex-grow:1;background-color:var(--vp-c-bg-soft)}.data[data-v-f9987cb6]{text-align:center}.avatar[data-v-f9987cb6]{position:relative;flex-shrink:0;margin:0 auto;border-radius:50%;box-shadow:var(--vp-shadow-3)}.avatar-img[data-v-f9987cb6]{position:absolute;top:0;right:0;bottom:0;left:0;border-radius:50%;object-fit:cover}.name[data-v-f9987cb6]{margin:0;font-weight:600}.affiliation[data-v-f9987cb6]{margin:0;font-weight:500;color:var(--vp-c-text-2)}.org.link[data-v-f9987cb6]{color:var(--vp-c-text-2);transition:color .25s}.org.link[data-v-f9987cb6]:hover{color:var(--vp-c-brand-1)}.desc[data-v-f9987cb6]{margin:0 auto}.desc[data-v-f9987cb6] a{font-weight:500;color:var(--vp-c-brand-1);text-decoration-style:dotted;transition:color .25s}.links[data-v-f9987cb6]{display:flex;justify-content:center;height:56px}.sp-link[data-v-f9987cb6]{display:flex;justify-content:center;align-items:center;text-align:center;padding:16px;font-size:14px;font-weight:500;color:var(--vp-c-sponsor);background-color:var(--vp-c-bg-soft);transition:color .25s,background-color .25s}.sp .sp-link.link[data-v-f9987cb6]:hover,.sp .sp-link.link[data-v-f9987cb6]:focus{outline:none;color:var(--vp-c-white);background-color:var(--vp-c-sponsor)}.sp-icon[data-v-f9987cb6]{margin-right:8px;font-size:16px}.VPTeamMembers.small .container[data-v-fba19bad]{grid-template-columns:repeat(auto-fit,minmax(224px,1fr))}.VPTeamMembers.small.count-1 .container[data-v-fba19bad]{max-width:276px}.VPTeamMembers.small.count-2 .container[data-v-fba19bad]{max-width:576px}.VPTeamMembers.small.count-3 .container[data-v-fba19bad]{max-width:876px}.VPTeamMembers.medium .container[data-v-fba19bad]{grid-template-columns:repeat(auto-fit,minmax(256px,1fr))}@media (min-width: 375px){.VPTeamMembers.medium .container[data-v-fba19bad]{grid-template-columns:repeat(auto-fit,minmax(288px,1fr))}}.VPTeamMembers.medium.count-1 .container[data-v-fba19bad]{max-width:368px}.VPTeamMembers.medium.count-2 .container[data-v-fba19bad]{max-width:760px}.container[data-v-fba19bad]{display:grid;gap:24px;margin:0 auto;max-width:1152px}:root{--vp-plugin-tabs-tab-text-color: var(--vp-c-text-2);--vp-plugin-tabs-tab-active-text-color: var(--vp-c-text-1);--vp-plugin-tabs-tab-hover-text-color: var(--vp-c-text-1);--vp-plugin-tabs-tab-bg: var(--vp-c-bg-soft);--vp-plugin-tabs-tab-divider: var(--vp-c-divider);--vp-plugin-tabs-tab-active-bar-color: var(--vp-c-brand-1)}.plugin-tabs{margin:16px 0;background-color:var(--vp-plugin-tabs-tab-bg);border-radius:8px}.plugin-tabs--tab-list{position:relative;padding:0 12px;overflow-x:auto;overflow-y:hidden}.plugin-tabs--tab-list:after{content:"";position:absolute;bottom:0;left:0;right:0;height:2px;background-color:var(--vp-plugin-tabs-tab-divider)}.plugin-tabs--tab{position:relative;padding:0 12px;line-height:48px;border-bottom:2px solid transparent;color:var(--vp-plugin-tabs-tab-text-color);font-size:14px;font-weight:500;white-space:nowrap;transition:color .25s}.plugin-tabs--tab[aria-selected=true]{color:var(--vp-plugin-tabs-tab-active-text-color)}.plugin-tabs--tab:hover{color:var(--vp-plugin-tabs-tab-hover-text-color)}.plugin-tabs--tab:after{content:"";position:absolute;bottom:-2px;left:8px;right:8px;height:2px;background-color:transparent;transition:background-color .25s;z-index:1}.plugin-tabs--tab[aria-selected=true]:after{background-color:var(--vp-plugin-tabs-tab-active-bar-color)}.plugin-tabs--content[data-v-9b0d03d2]{padding:16px}.plugin-tabs--content[data-v-9b0d03d2]>:first-child:first-child{margin-top:0}.plugin-tabs--content[data-v-9b0d03d2]>:last-child:last-child{margin-bottom:0}.plugin-tabs--content[data-v-9b0d03d2]>div[class*=language-]{border-radius:8px;margin:16px 0}:root:not(.dark) .plugin-tabs--content[data-v-9b0d03d2] div[class*=language-]{background-color:var(--vp-c-bg)}.VPHero .clip{white-space:pre;max-width:500px}:root{--vp-font-family-base: "Barlow", "Inter var experimental", "Inter var", -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Oxygen, Ubuntu, Cantarell, "Fira Sans", "Droid Sans", "Helvetica Neue", sans-serif;--vp-font-family-mono: "Space Mono", Menlo, Monaco, Consolas, "Courier New", monospace}:root{--julia-blue: #4063D8;--julia-purple: #9558B2;--julia-red: #CB3C33;--julia-green: #389826;--vp-c-brand: #389826;--vp-c-brand-light: #3dd027;--vp-c-brand-lighter: #9499ff;--vp-c-brand-lightest: #bcc0ff;--vp-c-brand-dark: #535bf2;--vp-c-brand-darker: #454ce1;--vp-c-brand-dimm: #212425}:root{--vp-button-brand-border: var(--vp-c-brand-light);--vp-button-brand-text: var(--vp-c-white);--vp-button-brand-bg: var(--vp-c-brand);--vp-button-brand-hover-border: var(--vp-c-brand-light);--vp-button-brand-hover-text: var(--vp-c-white);--vp-button-brand-hover-bg: var(--vp-c-brand-light);--vp-button-brand-active-border: var(--vp-c-brand-light);--vp-button-brand-active-text: var(--vp-c-white);--vp-button-brand-active-bg: var(--vp-button-brand-bg)}:root{--vp-home-hero-name-color: transparent;--vp-home-hero-name-background: -webkit-linear-gradient( 120deg, #459c55 30%, #dccc50 );--vp-home-hero-image-background-image: linear-gradient( -45deg, #9558B2 30%, #389826 30%, #CB3C33 );--vp-home-hero-image-filter: blur(40px)}@media (min-width: 640px){:root{--vp-home-hero-image-filter: blur(56px)}}@media (min-width: 960px){:root{--vp-home-hero-image-filter: blur(72px)}}:root.dark{--vp-custom-block-tip-border: var(--vp-c-brand);--vp-custom-block-tip-text: var(--vp-c-brand-lightest);--vp-custom-block-tip-bg: var(--vp-c-brand-dimm);--vp-c-black: hsl(220 20% 9%);--vp-c-black-pure: hsl(220, 24%, 4%);--vp-c-black-soft: hsl(220 16% 13%);--vp-c-black-mute: hsl(220 14% 17%);--vp-c-gray: hsl(220 8% 56%);--vp-c-gray-dark-1: hsl(220 10% 39%);--vp-c-gray-dark-2: hsl(220 12% 28%);--vp-c-gray-dark-3: hsl(220 12% 23%);--vp-c-gray-dark-4: hsl(220 14% 17%);--vp-c-gray-dark-5: hsl(220 16% 13%);--vp-custom-block-info-bg: hsl(220 14% 17%)}.DocSearch{--docsearch-primary-color: var(--vp-c-brand) !important}mjx-container>svg{display:block;margin:auto}mjx-container{padding:.5rem 0}mjx-container{display:inline-block;margin:auto 2px -2px}mjx-container>svg{margin:auto;display:inline-block}:root{--vp-c-brand-1: #CB3C33;--vp-c-brand-2: #CB3C33;--vp-c-brand-3: #CB3C33;--vp-c-sponsor: #ca2971;--vitest-c-sponsor-hover: #c13071}.dark{--vp-c-brand-1: #91dd33;--vp-c-brand-2: #91dd33;--vp-c-brand-3: #91dd33;--vp-c-sponsor: #91dd33;--vitest-c-sponsor-hover: #e51370}.VPLocalSearchBox[data-v-42e65fb9]{position:fixed;z-index:100;top:0;right:0;bottom:0;left:0;display:flex}.backdrop[data-v-42e65fb9]{position:absolute;top:0;right:0;bottom:0;left:0;background:var(--vp-backdrop-bg-color);transition:opacity .5s}.shell[data-v-42e65fb9]{position:relative;padding:12px;margin:64px auto;display:flex;flex-direction:column;gap:16px;background:var(--vp-local-search-bg);width:min(100vw - 60px,900px);height:min-content;max-height:min(100vh - 128px,900px);border-radius:6px}@media (max-width: 767px){.shell[data-v-42e65fb9]{margin:0;width:100vw;height:100vh;max-height:none;border-radius:0}}.search-bar[data-v-42e65fb9]{border:1px solid var(--vp-c-divider);border-radius:4px;display:flex;align-items:center;padding:0 12px;cursor:text}@media (max-width: 767px){.search-bar[data-v-42e65fb9]{padding:0 8px}}.search-bar[data-v-42e65fb9]:focus-within{border-color:var(--vp-c-brand-1)}.local-search-icon[data-v-42e65fb9]{display:block;font-size:18px}.navigate-icon[data-v-42e65fb9]{display:block;font-size:14px}.search-icon[data-v-42e65fb9]{margin:8px}@media (max-width: 767px){.search-icon[data-v-42e65fb9]{display:none}}.search-input[data-v-42e65fb9]{padding:6px 12px;font-size:inherit;width:100%}@media (max-width: 767px){.search-input[data-v-42e65fb9]{padding:6px 4px}}.search-actions[data-v-42e65fb9]{display:flex;gap:4px}@media (any-pointer: coarse){.search-actions[data-v-42e65fb9]{gap:8px}}@media (min-width: 769px){.search-actions.before[data-v-42e65fb9]{display:none}}.search-actions button[data-v-42e65fb9]{padding:8px}.search-actions button[data-v-42e65fb9]:not([disabled]):hover,.toggle-layout-button.detailed-list[data-v-42e65fb9]{color:var(--vp-c-brand-1)}.search-actions button.clear-button[data-v-42e65fb9]:disabled{opacity:.37}.search-keyboard-shortcuts[data-v-42e65fb9]{font-size:.8rem;opacity:75%;display:flex;flex-wrap:wrap;gap:16px;line-height:14px}.search-keyboard-shortcuts span[data-v-42e65fb9]{display:flex;align-items:center;gap:4px}@media (max-width: 767px){.search-keyboard-shortcuts[data-v-42e65fb9]{display:none}}.search-keyboard-shortcuts kbd[data-v-42e65fb9]{background:#8080801a;border-radius:4px;padding:3px 6px;min-width:24px;display:inline-block;text-align:center;vertical-align:middle;border:1px solid rgba(128,128,128,.15);box-shadow:0 2px 2px #0000001a}.results[data-v-42e65fb9]{display:flex;flex-direction:column;gap:6px;overflow-x:hidden;overflow-y:auto;overscroll-behavior:contain}.result[data-v-42e65fb9]{display:flex;align-items:center;gap:8px;border-radius:4px;transition:none;line-height:1rem;border:solid 2px var(--vp-local-search-result-border);outline:none}.result>div[data-v-42e65fb9]{margin:12px;width:100%;overflow:hidden}@media (max-width: 767px){.result>div[data-v-42e65fb9]{margin:8px}}.titles[data-v-42e65fb9]{display:flex;flex-wrap:wrap;gap:4px;position:relative;z-index:1001;padding:2px 0}.title[data-v-42e65fb9]{display:flex;align-items:center;gap:4px}.title.main[data-v-42e65fb9]{font-weight:500}.title-icon[data-v-42e65fb9]{opacity:.5;font-weight:500;color:var(--vp-c-brand-1)}.title svg[data-v-42e65fb9]{opacity:.5}.result.selected[data-v-42e65fb9]{--vp-local-search-result-bg: var(--vp-local-search-result-selected-bg);border-color:var(--vp-local-search-result-selected-border)}.excerpt-wrapper[data-v-42e65fb9]{position:relative}.excerpt[data-v-42e65fb9]{opacity:50%;pointer-events:none;max-height:140px;overflow:hidden;position:relative;margin-top:4px}.result.selected .excerpt[data-v-42e65fb9]{opacity:1}.excerpt[data-v-42e65fb9] *{font-size:.8rem!important;line-height:130%!important}.titles[data-v-42e65fb9] mark,.excerpt[data-v-42e65fb9] mark{background-color:var(--vp-local-search-highlight-bg);color:var(--vp-local-search-highlight-text);border-radius:2px;padding:0 2px}.excerpt[data-v-42e65fb9] .vp-code-group .tabs{display:none}.excerpt[data-v-42e65fb9] .vp-code-group div[class*=language-]{border-radius:8px!important}.excerpt-gradient-bottom[data-v-42e65fb9]{position:absolute;bottom:-1px;left:0;width:100%;height:8px;background:linear-gradient(transparent,var(--vp-local-search-result-bg));z-index:1000}.excerpt-gradient-top[data-v-42e65fb9]{position:absolute;top:-1px;left:0;width:100%;height:8px;background:linear-gradient(var(--vp-local-search-result-bg),transparent);z-index:1000}.result.selected .titles[data-v-42e65fb9],.result.selected .title-icon[data-v-42e65fb9]{color:var(--vp-c-brand-1)!important}.no-results[data-v-42e65fb9]{font-size:.9rem;text-align:center;padding:12px}svg[data-v-42e65fb9]{flex:none} diff --git a/previews/PR237/assets/ttyjkgn.Bglvb-jp.png b/previews/PR237/assets/ttyjkgn.Bglvb-jp.png new file mode 100644 index 0000000000000000000000000000000000000000..07de5081966cc2531eef8ee125d88c40ce962435 GIT binary patch literal 44112 zcmeFZbzGHe*9N#1MFbU4K|(=9r9rv{w}gOnH%Nzcw+ey+B2ogd)+Ipb*;6Y4{|c%*Kx^k5eUR}i5DUY2*jm)1Om$! z=OX;(DZVZWKCoX&iHji4G5;i1W`rRS_Yo2z&y-xgt&BQ*C>af%Z@NDY!i+F54IUl8~4FH&JX zd1(Lt&;NIFh#2`NTCV3wat+!SS3Y){h8H7La4x`IYo7f;;=rex*q-vefeQ@kuZ{f( zFi*RC`_2D1pW%{g7$rlvZ})Y^3jG~7J3Y>gb!$JrVAHHuZN3P$12N5 z&<*eYJ&-4PYinzFx!-!E-M&lJ0{7#n5kxcgUZJg&n&(HR&VIfq$Y85WF z(-$X)&=!6KSlHK0BnY@} zQHKa9$jNPNHM4|}ac1dOd(CNi^kykvzI+*pBP-i3)-$)bSZdTvOeJ!>w@SXbYI+H? zo=?dNCMAmL5-eFS7#L+)a$m4yeb!;P{n2X7s_UE&ZM!&9mlj*Bx&G<3ma+r&l@&QT zxsGYO9Hw^bmHS@Xt=#M;ZHx>Inm-L2f4#fXT6zEn5UUWIoxPlJwv&;r zbs_Qr!9|3g^%AbvqlmJys zLj6D3RK9_M%^;vLh#74h9Y>2^ zYr+D}%ohI!-ti;2!>kn$5U{bi8O>{NjL!Ci@4N4>RXQ%K3>UqIBPg(${B1Q_c8}NY zAusRYuPc;y*$e|5hT;X??d->{!+v9+}|>#|N5rNV4Kn~d;; zQ9&ySMS5FXNz&}<4|o23E1mP;K*6EXV#itO%X(N-Q&YLR)y%#wi)m4AyGy+jhm>9i zlYj7qET53vxXW{&iAF_5rRr!Y8yPTIU{ZZ{w5;o~=|}Lpu~CBWyyguSIk(kaPIIMR z;qNNhx-OG`6BByfq1_p>-kX2#z~)a^3fg79@oeUKpElpd!I%gIMU`RWO~w1+xre{; zSX|uQWn;OR1O>JED2R!RywA@=1e^7ok8^H| z<2Pwz8L{0cAV(l9`n!I$KOl>HMn7REsoy)DJ}c6l-VM4`$ya1+Fixi@EtBw+sq!nU z!F%5M5K5t{=l(Yi4-ZY+<55M`JIi_1XH$VJ-@bi=opb8d_>|@9agb5E&V+8yx8qSg zmX6uk_=C^S&!6zr^Qa@~xvapZZ%9Z;bj1AJoJ=eiDksMh%sNFZn4XSqu*`8elv=#2 zyBp;5H|sgIO0E`N+AsK3TMTD&e}8de;sogE6?}@9va;Ssiy6e95tZ=nIJvH82 zA7@GXb)B56VzZ9C>z8OCvFC2DD&8GtMtXX-f~`OP_{WEbe(&GMh*7tFWu5*&6VKza zF#+mSsDUadC~)xTPM1ao&?%q;KAB}%?n8l5NvNr*>Fev4JFT`<I?kkV(7T ziPO_S8NBD|+3|X1Ma9zj9#|6|6@|yfGexrSik&Vga6~+|Q@+tgFQVAeo;98vZsSu3 zsHv+*hlX|*n8;?zpfyH+7}Ueo=)BH48E@O|;}yv@Yh{QA= zrHz6B72WZwZkg9we8rBemqqvDF1CLE`BMQ$U*3Qy(?|+@IeHpAiN`y$C+zHsF^cE? z)o18ARbAIvqHU}sh0Je4-d^Z;qvg&~IwZkji=r7aad!6h7L{)~@Kcr=2`(WKh?q|k z{aUHBwK4UB&bS;=pYHMFQhogR@f!9!1+zYJCNNlJz>Rx+O8gWgBm)!sj~_plWWl~p zrnH@nrpS>Bp%B#4)@~Kjef5MyK~eG6&6~MerCW#d37SW%pM1dk`;_8%+3Andb!eTO zocI!8zoTMi&IOa0^N`Zg`nE`(y|ughdcz&Qn0n{z?2NN|2&KuLreOAjq=oL!$sRj0 zKq`v)^-$p=*bn#tvf#QCYX{+z+DnK;zTmOXni_%!vym!ebko{?M42YzW*J<}aYH<+ z*FQQtZrC_GeaTj;aSOV~ui~~j9U>HS3kQ@Wjg=_fnuC?oHq&1xFG^>@0o8wZIhcFw zU|#5)u5xd0j{=NeSh!~5*E@fF%BNN%B`OSmR0sekd=JOEh}Tz zDzRye;mpj;B(##&bqB6lEqZ_P9Ym&DN#y!Z3#z2+Ml8X8<;eCo6^ zK;=uqV>1C^_uDtGVwS{QWA+=L;BfLOFA1q-<$7i?%QUrdzI|{kqfe>heYy+kK07y; zt6pHdGVo)%J|u6q5FCn0f~U&RcByeI89RT6()98&zs*F=a(~|WvhI1-AoUJx)V!8+ zIVvoS+84aNFq(tbm&fD4reM7721a^C{uBO@>6y+?u;Dq~e9mhX2KArBDLs`?Dj0ZS zU46PoZe20CxM;@rOYh0bc(wQD)ZfO&Mq~ikis0G7ba2&ZmU4EwY=Rd!byXeLSvXRz z*+MYD1VMKdHyX78-TP)Ql3gF}&`=-`L%Y_amuogL`{FDh{6@7sdS1b(9 z{!gnymxw;?;CuY?D{SQrul-zjL`3EJ*|9}`uIECMzuW%W>e5n7Xy|6b`H8rO$t@(K zPKC>8nWJ=Rf1z17IMdrVZ(_7P0We6CKZTv6qoDJemXcCW03o%OmKL*4#Xx}TO~+_K z_r1N<;jpldK(hxFn zCAO|gaUeNUF+-=+&S#iIm;kVtkx=*d zuf%gkUxKj5(nH{F3_=7S`+hGA?-vQ9k=6O}3Vb|+)mTNT!=l1sA~MNkI+$AprGa+c zo`Y!2%gVY5hxvd&^0q?%eFQ?|!Y_P+6@IjB*IXU;II`MtXHIt0StBiZT%CJ2{`~5K zVQ29ODA&LbgUQLs!NEbY;B<@xkN4u(jG90c=A(_7{mbof{4~BK0xmYKX1gCgd;lfZ z(a{0L&)Z7_2Y;8(ftH#&1yll77|&yyj7(Ypzbz(Khc9&UMF01t#lnq^jW1trdV8Ob zRl0M#w0`;WWn;sJs&=6>WprfZW&QN@H2z(l&!0ah_L>9crSv}81Zis?b(PxBKcJ>| z-(7lS)HyIP(9+TZ4(%F+z(DeNaXR~UyFy?Tl{=&c$Imyg82?r&YU+Ex$xkC9A|eeI z!^g+Jb0^ANm!6RkY$4^B-U|td#m*Fe#@WUO$%|B)Viyp>;u}~ofuhGU?nV0>HsI?l z|4^Q7_%}2(T*f1Qaf>l)sKge&h=YS;Q^R2@h~ta!c~5wPDD7CkU1YV?lL=<}?AbHG z7g0`Tl0{ad^wOWb*GlJSvTs=HgP}vja2A3OVP!Q519$F{7%L zBxu95EaoI3CNC;xD{AW}v-T0e5#OelFI^X^owdS~mTpmO*2Y6< z8p&5HQp&2*aK&FN@-e}=P!k`avb3k$JVX>4uc<-j%mg_@L0DIPcW-+$N|V3XN(Up8 zQ@-L|>vd*l?baH}_~W)`FXGJ~hzhb~J(DII!?dGR&|%nW58?|N%cLU}oXrxPF2|&P%V~WJ&tKWS%}q_a z9gaEph6!`A&1HY)X7YI+2@FkEZ_n_UTRy7uV>OKwLa=3>Uj84j*5 zR;s-vT#ZHcVcSYG$izbkYc*x5#F6WtT6k=j3KYcKNe~Cp=K623GMRyW@~ zU2BuEQ@u2R1z}w+uwf^8q9G_@%KrLJ&;=hpLt<4+fv}QAg{JQ3r^eS;=T_^=)e|KS z7%m~$!rbaS$Ro)j~p<|2!mH1t@T zlcH;c+aj7XIje)2J=UI{>)aEV$!*xvs>CEh*_)f2i;Ig8z?Qo++I=oytyS*plrCq5 z$z({qctL<1aqQQ&va-4!pAZ)p7a0lemmAXi$Xq5NAt4%?`oDkEoY%*gJoAh(`bK*D zJ9=EyXa!`H4Clll-P`HcKHhKeIWKC2Xz)GcILzulXTUjgR_}B?$4BW@9=*9j@!f6X zXm=U>9WsE`pzbAP91&SLR16HuYvt?2NG(YCcNRL4IB1Q^SATJ-AT?>X$g4EwW9R30 zAFFT${CX29u+>0KMMdQpH>gzwxm%i4)ZSvZ_{W?g;NuV|dQ`r^S5W7Ukt~ovzO(q{ z$`{K{5H+t*ddOw>;!<72!t%dyZ)tiuEHaY#9_Gh$Z)Ff-*fwyyUnI_#F9*)oXQCvtZ@o;4{`J{qGkDmSAv%LE?oEeAFh_&ffO zaf_-Lw#N$sw?d4x1Uw0ues2|@>()%A`#wPWqWpZDKku(6cx-)eI2m(aAN^?*NPryr zVJ0XbD46zpsMy+?PYv*rg2Dq|m#GglFU|7%*q>pZ{9rd|(2jT4sY(OmQ3%uSC}Y%h z)~>0A%FF(};rDvto^>+g?81-D9oFKft_KuRYbOy;;YQd(fr9&-c4yAAoF;m@|O zA$7U4)$#&6{i|26d#NRW(XKFe2?>b=?=x3ZQ&Uk<(e<%P5KUu7 zyj#{%W!1@+RGbXA^;m_|>d-wQFAqr7uU@^%%*+fF)K?+zsvh2SFZaC_z;C3iuWC>C z$60(2cDiLbV*oh1&oqQWfCKtNCXNq17p)Ars?~VaDX5c?k&*MLWB+&g6ktiJhFG7Yn4~WYiuArJ)63Cnb(>KUU+y3r*FA13djQsWM7p~tFs80OOVKhiGL#-0zrH+@dMV2bd>(K%&y^P0=zU3e z?F?O94&ZbS%4S63K(LAF4cffj|GbvHIHg17w&z}ffe zEg)XhRiC%Hso?k#U>G-m#TI<7LxpDIpY9SO4}eke_m6%5`y6=BE}d35gQLH9bi;2* zGWa3`p1s5N^Yw*mBCcWoK{DRMfs`Wj_Cw<*WD+>t@Z6u(0mNFdAL= zRZhB@h20}?Gt8PrmJmAP_#EA~8fhSx9NyZp+h%d;*LDV)(L2wrwkOvZxZHHeN=XFW z3d5IyudvWD0oEDwtBvh#JX~A_+S>s8fiEhUi86ijNGcMCio#{$4d|jVdz!>w5)jq|>VKqN8%ThGID;CDx-WI4AybsF>&cqA7{ z1InD&t02{6&*L&~`I^-#;73qZRn-+}J6)&DuYRO}&e%<57Y`zlU!4GEmx=QoE6Ri` z4+tFaZt6Hc^nSgKk)`-VAy@{Si}JeHV%H<8T1aN+omR8*=w-o2LFUOMZzwfQ3h+!= z%=T{^!=it#Nrc6&UH?Udsmur0rCF*Uy4o+}*>i?(z4I8otLLB(Y#3M+knD_9B1q(K z$V`FnhaY+dhVAX`JB(_dV`Go^hON0>?kS!WEJ*bR-R1q+H%%=Tgy91e6uw0F|A2bf z+d_ka{Cqh#wtO;h4wjZV1dygdnc*dU=3F$;ga;dw09cshO#*@V_ECRjFX^l$!A}^w ze4mm6%g3OJHfzA;vF-M3c*gsKR*Iq4=2rPJCdew_=Vbi+R99ZU)1T6-#CBRNP6k5K zIxJZ#hN83UWp;S)3uhKa%uh}!bH7OX$zE~wDJs4j7Z1;mAYD$Q-}=S!i5Mrp_#yQT zM6dzJ$Bv%g+JuV$EN5~rBRV8;dxr8@9$)dxkS3qlUTL7v9x7|lmM{1a5)w63(-O^I z-;0h64H_F81JefR(G0wXyt=w8YzU|fG*aL3x+ur4R_Ai8xAmvRDPU%u?d`Ld3&H#1 zQoY2#ZjK((kj*Z|?|TdYGto(-a?-zK1eKI2;kxv`9UC!l4=wh;pm~0MyE^-w{|FK1 zJ4naoIoP$dTk2gmEx)le7M9pT{P(?F>lA0OkBvZc-~ z+(d9uu~nK{s0|%z-r)E`f|zI^X4Y~!J2{+~n1J%%Vt2+q{0sFjh(dj)9FQ|4B_;9l z@*)EOqO1=WxBpFxAX|d$o&D)kFF>!;b-{Sot_6MkSY|Vc6czO&cm+WofSPI2F`&;q z2|xAeYsM3#2O$dISM# zz_x%QnQu?%H%H3~?)Es3d-fw8i|%IQ`NBN_`7J?3B1m~GMi3GMOzj54J%#}oh-A_n z^EzG~8PV$g1&j})X3Ty z&{z)_wK`OQv&H~YsPSaQSAdd3t)^mc$l~wczv&7QlCwbG0cEKd_(o2@Fg>IeDraoK zQg?MJQ27E#15O@FHofL(Ohs$4p3?g+x0P1!HsFGCi+<)sbY5PbWSXS3bi|oGfCJzl zO>48_bn?7`@bo%6G@+^miOjdgs;>Ih*4E0Wh|SKjI{y+=3s?xJ_|oF8TV`|<(4o@Hj)a7SfXp!^v)!!FnfZBf zQPHbZ6mAPi=I;By|NN1Xlyuu$F)Q=?hf33S>W;yzFqKKq<09ar0H-B*9hohD5D#l= zY6`r=f=l%tpK@(>R(UrDYy{LgH)BYnoud>gj&HE8B&Vcsl1T#$d5wEN5+xd({z`NinbOGv5gJrH4GMDb zF$`R;CTZB*Dj|^ecM_Jg&QVTO>m76%I@0l&|09wcDQHYL;vVxC1 zBNOFlA*Q1-1!ECAyRF0RdFgrYjbB%g0X{xHQ1_BBlf#*upDzX#%4AsuO=d(*0+!BJ z&C4~>W_|c@W^1+?835TqHPpa>*p*D%sybc+eg9fqT>MK<4Q(Eg#(lX1cgntb?D~i3 zt=2S%pkdh1eDP4_Hcp;)`D0(GK6}nZn`C(|LS65(4saH|4stQXY~E)l=Iyv;rKQp_ z91>-TP#mcCdHeS5`RVvMoXxJ~@d&sNf@CNZDa=0#10oudA4MDtk&w0e0nxzBR=Hs9 zZ`CqN=q11>Zjv7jTwNxPQeE`1f@ zh4Lj86*7UBL9ODLd)%V{uo<&<8RYY#DVd&Rj*zpuxs?&T8pzk@tmgANaaj}vrULMN zO9hLMaYo+){%FGxVSJ=0uuupeH+A{@JD?LA8{eJeGP>ggT0W@A>q98-AQ`pGdRjE=Yilu{1{nb5m?Dss%Ucb;r4VK-V2O-$c-yBM51sjOI$&Z0j zySSJbB#99b5m%{zAQ!S6E<)uteueBxz0g!1bVf|6(4;LG5G81O zic0qRQGd1MYpG=gEiJ~%@0@{>^>}!A(#IOhG=l6`6V+2Ama40@y;uvrWL&y{$Y+9t zGPL{>FDD5u1mwZw%WBs5gTSDJgClgH_C4;tUI{#xW1N2&9^T^KEDx`lW7t zA5*sh=m-(a`|NN&F)FpZWPusHpU}=UTzJL4Y6l zY1FKeqb7f@{fScOY_p#7Kly1vd<`9|;5e;dhgw+ApY-@lB4zZ>6pP;YH8BGbr`b0L zUwn~^>v2TrhKq;+T9c&LDN5xGJrt6TA0@T~f*5V@~c1P^nNrUTPtFc49Jt;m)os3H6LQ~%I>dOAe!XnQgr z^BywK7cXTxA_~Lb+EFR3t@R!MB1Q=7v>}(1Xzf+Mj}k3$CAVm2IuUC`bhy#>QvCam zJLdRC(f)Gf488FmUx{w-rtaM>Z7V3vyG zqRc*Bisy*BkQYqrcoV(8lywh3=?@iJ?>@$*LzPbVoHt!N2J{`A{vAx-o7R_fqw86v zPC|6_V2XGMrWRM`(AeFrXfCWFy}vff@3`au&o4XjlT7`w3vEY^yVRrL+&DgXL4DE_ zaBXjPRA6ABSc-(CWR|NPxC4&7@l&Pd$=0J#i`0ybBrI(pX%xd{Hg<;(y zdHqr0;W$)KzF#WM1YiUa!<-^7C+B1~O4pa*6t+2p&L&8P!W|Nah9(1wGQRKMOX{NL zy3(Y&0s$a%pWtEZ#s8Q0UZlW96#afHDj=E}7Ah(rETgis(h5aFumLaFphh*sb#*F{ z^Rv^mdgipXZ0vWFprh>o(X-<`Ab&MWtcL?#E}e$x1G3WGb^*{1n8%l3y<)o!c%v*Y zv!-x50IWi12L?Ji@!>b6fq|s<-Pqr!WHWq$Rjq`$&I(n6u&wIrQo&8MksvJ_hq)^P z&hm4NjDx+hHCQvoqHk=Vm=2B+|N3=Idz6mbVp^8&5HRP!JNOY`+GZRK8$MHcd3iy+ zu!eRO3|PB?4SgzZvk|KQXv*(p2*A{?nT@UBqhV{^B@ZAgKZF=*!4ZRLmcz6iEgk@Y zoodAm6>Gcc+-t(gouo2#^Hx>iU$o?yF}#057Pf$iU*F&FnKaX!*4adeJ~92mnCeMj zdmzF=M+-85Cc(oFC_U)&kd>Cce)TG^&4drZD_C6=i!N7dx)2yI&=SnP3q$B--LtJI zOj$HZZUjyeOeQR*Y6a2{s2Oup`W4IvaF;^47 z<;VcQ9If$!nduFjMcfF16R$zeu}rzr zHYtgDwQ!9+XQ{)b%9&^4u#Do!k=YZHQYl0(%*@=reVYRu478hJlxn=XdPx<)=>e!& zOjjboD-a+9cuTaovXj#uc+RZ&5y+SEpB^NdlUa%Z_x4g+dbG;Z9h%qVV&@H%bbqF7VQm=dT2FlVN7P&j3!@5*0=JrCf&t zI)q~aBQ7BshS+dx2ww;q6luv+#^qrY``{kk1TTXFeUh0CVIGQB9@nW9E8i6!h)T`Z za$j)k1Adv`hzzj%1g(aR&c(a2g+*8c7cNry5J%}K{a|>EL51Y>`6v zh)n=j#6$}PvH6I?TR%$OV(Jjz-(5zjh-8K(_TsLDBR6##haMP|zi+=i73viiCA~7A zu2AG4Z*vKr+bX+6dh2eq7jK#zR1^w}u(9F`I(Qh+)yz{wbS^X(aj1L;bb05$8COKp zTye50_gWH!`m;viL!OJUsJYZ$a<72qQL>oGaMj0P9x?s}9a+A0qDe+N7dw)z7O|eH zR2!Wg>R4sBSt$StkX1ZcG=f$grm$4$2zjL+><>;M!?9y(zUU*6byGT@xw_LUfaI2DRA3}o;uLQNAN}G_%6%t zIQeF<;BdM1SFS|WD)N`$9PeMcJM_`>AM&RMG0G!`GHyF|VY9?+N)E0v~m+Rno8+#jMbB;>5JClpEjt`m{HG;P}i% zSuIp0t&FB?>09RAV4z%GZ>08ng8zm<7;7!u4C>+|j*lu+zxapi8N9sEu5PM~`}&mh zpJu%qd4%Pornu)-^sAUob;EkS%4^Bz={?s}g6mMt{jR8GWhUn`g#V+I&#kV;9Hj3v zir4v)U;a?-7R%J+RH4VKYX9S{7gS_$TymH?DN5gL-gPat^L56DPNzsP=hc{<}JuV zZnW&@Z1j7pR=Z5X(aQdpr5Tm}_61tk_xy!%gmI{PG)|M2)t^n84L*th;xpSorbh8< zTw&sTCauB-KGdmOC0b{uBSN_Qdp!iS`=u-A<8$L%9iI){x=1y#u+m(l}6SUrc9e-HPF)A8e0EUE6EBB793^QLCtmyZ!%U{==#!?bc450ridy(gXTb){U z%s=@fH7)A4m2NW}oZm#OG(U;T@A+ta!}mCa&3ZPo|EZJg6$-lAJT;VN*w3rI#ET;%jq{r7XDEC5kM`K2L~LX z=SVoh8q33TOBWT;fH4Wi?enI{5w0Dx4-Dns!>xnyT|DlG+=g!rlzX6^td+!UMBHpI zhXixB{5R4ggz@;YJr9Kc=0ujCg}w6}KY30G4VTTM7yG~f22kN|w**z$_r#6(?Al2% z&#+YevEfy1hsQdNQKWNd!dA0lzxrRgk_r{s>@~Z9ns$6;sItNC0YSC;qr+W&Uvv}$qwBdjDbw7%w>6|#D zyxeiEH&1GKH)M2rezlLU_#G#7&KA+5^F5pm>)u#INALx@*L@}3P(m)}^tgRUj{HuE zKzyCPvpO(J)Lt~SI#kM^7e8|T^n4HHB;F7RGW=hZbse%)&dUNONy>DEyDU>^qDPXG zC7$A#+-UZ zA9y;*Ox@c(%G`ID4n>xWOxg3TsI)=1Fjl6rWt6OPnB^@unvCuvLVma}QogdmdEQPhK z7PAy>VGhBl3{w?DkX}>tYjU)BC-33O>be;kn-;;uGmUEpz2kkkCCKBs(AX}^tGYCp zu@4&&thl_g07+6jp4hM4-m0}I4|EV`;v>&=Iz!YKeY_ahE;7Y=K8&LDY`pWvr>7U5u|Tdk6~OVOF!#LsT2V)WT+Hw zAztr5aoknxHw5`QQ3|+cr&2!`g%)YC5I)r9nnbhAO|!X3lHgYsrc2{DMrkKOVBiFE zl#Ffv^4A+&Q-12XZQB%{cNYjqc9W#?`opXd<&%Ct&BJYH(T8)JFOpip!}h&M;jVDx zD9b-_zUA)`Zf4hug+S!I;anl(l%S*aX6BiyccGvwd<{xThB~FA;ww)bdPez(!50== zc-F=ZVaiT*lN>E}zQ?*4iY%3SW&mcEZ9kzg2fnfQMj0Lb5Z$&><`o!|xk{7b_1QiZ zR`F@)#pLfw)$Lxu5YG%i6wA<`P&E1SRqOQAj}Dg;DlZ@=Hr_XJCsk2Qnu)fr1eK^8 zc;CvQ1W7#jOH}sP-}(jnLbm=xK?H&TxuYmrtbDs!Ta@Xi6#bo*Dz_Q2U2U0sJ6N&? zNl=})2W6bRmi)4+Cp6I^gmL^jc?NiqYxL$Bo#bQZR93qon|$$fh4(O*!|@-^4_|il z>=h3kivj8uk}u>#A=W?N>3)c8D(s<%;6uHvCZ3 zue9*Dc*SP#O~}CqoUjElMEci~ES)`UeJ(#|79op=Q8kj_cX4?Q+9Fs*{=NGW+&Nd? z5PXgnvv%2TXidh|7MwqzA7laY$ID>0T+ELEw%=c1%4d!RH*D!U`AQI`sBzBg5DwO$ zJenrClvqLSOmuyKF#fUgRZ|kURW~$}{V{eh*;Bp=+FE0MTZ~o2Xti9-JE&cnfibEa zmjgPi8|K7R8tcw`*xpq=ro?pk`HYj#S;AG<#eQt#uIuOAgFA`a`dKahFqMAIzF@H> zZ(QU6(yl4mk$dc{VhGa4x-s5B&)DCjeR=8m{Y!>=PsqkI-LXA6<3CPueZ;0<1I@o- z8em^C@`xi5X)-|mcYa7E7#=;*oDjy+C-|<4OqXU)12`v*YtA>q%6;FjerWm5VJ&sr z5U`NOaA|4IUY*1nm;=6s4F` zLmy2-x4y8`b7g(59~L`m4$xd1Jfb||46DQAiw*A&U){phPy9=ZK$yz$i#}sfP99O_ zc$vb!@?qwW)iM$!EGhZsFWA~*VuL-Q$46`gf{d$&*eMv7YER54i_@(%yT%%B7Wln~ zG?F5O8EpeQsrt8*7Ir0~+}pv6di_lw84CTGC~N&9K~XenmlQXD5Vs}f{o6v#OVF36 zGMjd)`jK&ji*E0(3v4djhdXW$-;1_of+t3w zS>G;7FE>4C4#^JBYMl$)mWWay6Z)sfd`)25&DRvP<*%Yfl)uh`6R|CoUaj#@2Orxy zE%d<^pa4KQ%FFneWj2=tZk@?+&*uKt;?LXIEIxsCvcI5X)b&c1z?_>t4oryUkH`%V za+2K)3)AirXdg=Kgo_lR#vX`2ZaM{8jB#g)gxFaR;$9o}e{a(pxz|We5e+(=ezZ}4 zkSgG~tBz(;2vvmXPNOIY%;$z7>`2A+AG%ocO1=&0r^jKk5`#$Z;T5-U{dC~wS9 zy4&idjzCP{SQ;TK36fu?2-yVlYTChegYQJhpEMp0GuayHK5AEk7$jCE?%1lV)S&HG z>Li-V-F(f21EYSa9_YPQgI0F%EELf2hX|fyUURS50C9-)}8w zG6-xuv{Ri-1lRbt?cv;NkZBv~PA?DMYw<_qG@$m=nL%aG+6dv%Z&vl04(4!o0V+jG zfS4(6b|;sUd4!YV7D|D6TWtqRT=|n><_90F%EBTdy zR$$dIdq>0=bFQYuMZFe1dbfXtdN7U+!Q$1E*#d*%i zZx+#Cr0PIa{yNy}To@saeWn{6qWJ#p4UE@_zGiR39qiI)C7Dyqgfr!}{S%bTc7!@?FPin3{Ougaw`P4NlXLxUNMCUin3yRmL}HBwf{5Vj z4>?GJQ6np(te}?T3)kw3L&V1Ex*L=c|6DsB>7-%_JV|QaL_8} zd!4aAy$@#oc*%pzzwpu9mD4GL!M_6MW5;=74^#>dUy6Lioty5>xG`kM^n(w;6>9W7 zF(F^(r1ym;ZJxOMe|$`@JiG6kGE5eE6y|smuqn^xNd)4|nQV(95*yZhJxp9ToEnL| z@B182is@u(ei#6t?lmf~btY8hgYogjq7h}a6=SEy2o7G&U&E{ysqU)EWX`SE8{`;D zx$zslDW?S(f6=?iS0z8dsC1d`~l-{2D!@F~`S5oA`&8UU0|c z&tJc-8^%4;y@m0-J}L%*l>n>iQwr=QQAX}jqxT7ZPd*%>I~HCe-Qhg^7xD`u_1lsp z$wxS|*h%(9w!)>^sR@4n_>Mj*4iQyd$XTXIM3R)T`C@b|k}J6|L@@_~W}UMtyCj1n zXpt(8ug!hX+I5kY*9@Sx(&9!{fqLgPDQhT*mZe?4X|$O4ffz_^fC%K& z5ZMu)Fok-BfdjZ)Lf~~&IF*Rj9$MOEGSLbso7^+_vx4=8;L`&R^oCS+G{&gI934vl z3_7)If5%d0wNvdR;Z2JP`%wxD5rT!_05{<+MDZG(@Ca}@LU@^c$ujKLk{`kFZ^hug zqpG$!0v!Ew2khxCgU-w5s1d)O51B9&p16BmMU;mjXaBl_AQWGjGl;>d#euBOP{(vs z^xYqg0V3UgpDP(348alADy_6*Uqt zg~b3NtSKtZFjzDhg9knb26l{~%9!Di4s2Z9x~&iA(;pE0eo7kr>My>n86@3zx}H!z z!pz|})Hyi^FI}t4??IMkV`$8Q4CyFE2pHhX)d$!>6Ac|g=$oYFG3&n_sqxVHDi?4I z{0_Wn6U%|c5NjA^kmC~30JI^D+VbL!A~Lc;&@XZbxB!{$JBoSOExpK-oA zYxHn(&&lU*0w@m-S5S*rG|!f{&AIf3z)3WPy~1%uOuw}CrL7(&fBCHKov}>uk*ze_ zG}Xo_nCm)RWHh?y8#`FU5n31Zi46jol?+lyj)?Bx^6GLsA5#(h_PQI=_S8jC3bg%C z%TdNmA3Iq_#AYv_tAwBXw z|H23x!3+Z+RBBD{PI-u~Js_hlPwgV+4phGiSE*qV*dh#o(53l@s~FhAwNpNU)oZ3f z%Em|b`Z;L9E6l4F)FR5i-5h3s2D@a|uVMqhzYb)fg&v8RL^WuOPM3cCxF;EV@&?kb zm5AT8@A>>8Z87joC%_?xS(aD_$Wf^@|3yYNMg4+U?F$H>%AcJ&Db7tC7}iErKMd4U z(6-cwyzL=qqvGNBf37!22H(hz#t7me2X+V{7l0nF^b%z8!A7to=5ApjZ!w2fLv~$x za3;4iU#YH}8&de9T0M@l>EnfB%E<0ejMbGhy{X@Ecc2= z&t|*?s1XRka;Wv_SvF`IcFrLy)#D5$cv4u%@4dZQa9;jwExa!w+^HxfNj1SllwUAh zIJ6qrB;fI<$OO>16vlb$jlR!hX0WtD2WzLmYY2X4jW*B^9#F<6fHTI-!1+Whf3N5s zr4t1u7Q0^vFU{!720`wq71r%R3f3(qKO{ELdqWNG6!pGzU<~xJ@WH!PltmL9AA=Dj zoIj!ft_)034}rWd3{K^Cev#DnU{0vegdCS)cecIp&Z-eu<-dHy5(x>8Y{oR9bLaN2}{N93AzEzj^LHPHKz@&po z(s7k>$t@NL;x)d{^CAlfarCw69p9(bCri<#1`}OKt!V};(RA$PvNyS&J{+mWwHpwZM zw62mpB8UN}WC2~1GrA_P^MWJNJpQ2*OG$E3Gu;dlc+yKlvCvQTIIYj``zq6Bb)24- z-1~2uH8(JlD-YBxJ2YL=TS5%kVkZd(oYO}8^A9HQ(VJnQj%AD9JcG>dI=3^{;0{Q1 z8`cZ(ioGR@+Cj{;L3Oz@g(R3rTc;hquP6$~ZsZd5@3Iw3g|VV1TsmpmQ+b0j_Ym3<3fFzg>{B_9+J8+dY&%J5&V zPN8ky4|(UN;}iyF>V^HI^BiH9*UH6OL6VkFPgtM!Yl$rX*f;n5pEed?XXTdRYMSGDGi9fKsmCEt{!;EU6cH6wUtbSRbnuRV z%h=d%ZfwPk?g6}2j;yWHALmJ6)4aF$;z66c$x!-ghmn#Vm_9J?JeseNmSRu48OFr?6-XD z-_Em{YvxT5o?u-+^r}vt@teG)N6#cudLbojtKSt2O}diY?1 z^ki*qOM`);vL+O;&;60vfug^Xl}q$x`p@P4*Ow;slZ6+Y$}#o&p`oFfnHlaem+6De zX_)89M4>!a(fu%0tf8q1Wmz>%_n%i9q01eL&QuRzS_9sQLC4Je6#8GF&5pTzg^f@h zX76vw3Ut0>J3FpEcONZtyjQ8AqT&Rv^eEHH&B@7uBD#vI>iTGTaeDe3%xi!8@PXHD zX91cN$jE-1nK=dsZZ1}_+|U3Hpxbs1d=`!~mvghJJ5Q_k3N0$r+Dcj5FEg5!0A63> z53K{G0hqq_aj44+9wRuV%a^jUDco0B38CI!1HDE=T>l0vLZM+4rS{|Zq>T$ROsaUp ztT)Vl-3o=?!nAVElWl1KPdGoMl+-ej2Z8E0qX;@X4pnX^@EZ-xiZ zyQfy=;p&`VLAbm}>F%1M+?FU5_vatQgyTNxi1f72wve(#FVVkj6?tO=Q!NjmwbQee zv)`qX!+!2%`<>N0hA{l3EdtHOrp3d<_^|!bjo)~J+zzE>Kjc?oUL5)eEMC7pJ#6--A+H~|eXO)uoSWtbP03u7oVGlqof)la{jh5B~IXwUZXzB_Y}seIvxiGh`zU3| zVWX^fIalFk>b1 zkcw(@XA@r7K!7>OuVLj~VPj7a#D1;R^SQ%i>jE7^m8uPl^||xRDxG! zTJRzlXlR0-UQD-PD9nshL8GX=y!_KEFsNS-3&p%^2HI;!t(;+Y=sCWi16bqHc4A#! z9lV&Kr?+?1u9*ou-?BOy(_IT~;v$9}iO=AzMH}la>BFapM*i=g5wQMLvY5#8Wp3aa%+Me zMm@`^qNNMl>bQb??`$eUHXU$}A>*P7L?9s92+_RpKi;2)^i;3C??8Zj2qOsWF`yy) z0Hx_reNx&82;JRaD{Jtpr^Q!rUgmagMKV)8v z`?31#HG#UEE8Z$~08nfiU2jXV07=@hdM1?3aU1yjkm%*v-QA5)`t=>_hj+ifeEIT5 zakUxr00Y?Mmyn<2&i%f;oEuWb>gs^E^_FkaO?_e;lJP)CjMx+MM1ax%d-ETX9hoC~ zm^Y8!hs*;Z;BX-tHpjwtg})|W&qa=`s2PUb_9)to72&hi5^)8ORVw8Lq4r_s?tXs3 z`iLXjmBUFcH4SZ38SxZ)ADA-0-}$j%C$bb8`)rw_+m-p2w z@Qc@Rnvum3FSawFzz&|nKj7$9R{jMe?NDoE==)>+GkjtDpot}L$E;GEWhMe3wPr2* zm4l6)9XEkFP-#I5%NST{wFhj4c7yZ^w8wG9FP;IRSuD6SMvqn|&`DC2Ij}E>4!8M6 zN!@Lr+HG>$7jRQiQ6+%h4+EK@o2sAR(ITTTnZCY0(Ahy6;VVdz!43zsp!Pw?lL3#! z#>NI#jO?L=@SXOrw2)$#>6eA%=Ru+*8w2EZTAvR_G8O%g=KX6X*Xru(=F|MAtSZ*u z_m8)KM7;={gq})&_hUi}} z4JO)RlKpaPFdtWnatjI_*Qji@4Z{`_fuatqIjs_-Ltsts`XEhs5@um#<^6Zjv!(>L zR~3<63*dwq1%2H4alZE)9w-&PzT*s8H{de}A9_vDG#dkH*vK1A>$}wtv-8`xZ`#Jb z6`L;#9++<|iW56y1Jz8Qs~ph@Vhb*{e6;y{F{U$|X%u&_E|t%Ay2FI<2ReG4(cWO% zQMt#e9x-U3WzXMra45F=`@2WzcVXcjW=9Q8%}J0?VTemf`Q~?eeNaWz7s#KGe6UDE zi+Z%smkvOD34_aWQB@r7Vb$WjilvLBuH;WNkfR0Wk?vj~cafs|r6aT9T$QVLc}5`b z8<^(Ruu&knu#h_P5jIRn4g|LINTF_-%iLY!&hBoYpLpL1f=tv@ucf>$wpxVE4U|=6 zi76{T&9(*$^$2*~kl!lx^Me15q|H)iFUrV!wE|o(H7Rgt`Wqypj`8vFVLYXOLgvXw z$T}3H^ng_<3W+Mh)&5!I8WxLBZ>tU@X3$>p`V3}5?zz=;b!De_eX0O4+81_PSOs8g zz)=P5u1$CZq+B{y`ENfy&-MsLAu?(P2Fp1FwrD6IFeyjVcsseNz` zY;vTruva*YzMFxBNqE|YziX5FT3Wn7$Xr=j0rznM*0iwi0c3!IYrVfS8-wg`KyD6? zi1-X?+t59r_mueZl5d zGg-d~igwi0o*~nUu9T&dde^6V)u=$J&qf0wg=Q zz7rh`f~dgVKPyz*PC7h#29x&;hTqiSm(gJuSSv}jt91PE(og)-ch5xhwkg_Zz%dG` zu(L-8qa&1_B!-dUaRtK@%>JxWX(W6{-c1j;^1j#9Zt0}Q{?azaOEHjN6H)AZ$Cv6f z{pphQ){4PDRA^}?tU%^XXyp}$i9ERA#W43}O%Ru9CWWWh6}4)17n#0G z&G+#t+ev zMwxbuOc;h|qhbr<$khRM6MuCCifba+>{tukbiHZm12Lxtms}igS)NIM@Wbo^_-+C8 zMdqve8ruCKOQA38FIlP-iA%!=tlTUqvPF(YUU}oDueb|}5g)7GN2oxi`>9x10L-^1 zpG>?UrYI(55nRe8UZ83yO~y;Ax2JRy-XSSVap8$L(y1t7Vnc&jyI0^4hA2JBH@G|{ z4P9$e{jC{S;zEuLwv{9>=`<4hLdM%(PR?1TwGq(3XPH0rR8lgJgo95YP+?I4yr1lA zl- z?rz0vFf-+UiKhFxs%l1R{v*DKCPuMUc`I-R-jiyveuu=pzmo>pd+#sGLQ9isetk8Z z1KV;hNGuFBs_$HvA85@Qs>(^xaSp10Q1+YYxU)0$rLeG2DA8I8m`AGK=^rc z*YA1W1tz-(&c2$Kt@gn<5?fyzGTmjDlfjtbQ^@48X&sorsqBq{XCWmIGd#pLGbF}- z<44~p^78K!sCrgOb{GdMK)zM_RI>@Kl%ZSPnt#^IRFP`)={i!u_}6RR`-0m{LJeF_ zRKQcEcm8=b!9Cm+HI)fNxy1}a=-`DHXWEx8jPT||AfK8Nf$LC$&x;e1eWZtRm+eCt zAeoC-&*g1}ibv74R{jiZ*Q;~w1_odLhOC+rJ2uNRGv}1+bzrV*!uu1)AGwxLPHL$Q z_L&u7zv{E4;OB!^l6>2H@YN_Txqc!mN<8TH^j}&dl^1P!I_NMN^F*3F&%eG4T*s=v z28inL*j$GWp=QBU&T}sSsSDLt;j{16-9lyml-g0vP(qFv-R}wmk*dyuPzKzJ(mdSW z*rzRBcRC%25w2Rq1g;0`eKKDoD?cFy1a-`OcNk+{vUHseR(VXnYPK+Tl-t$w6PlZ^mVwS%Km!3i!0h&NEtb=iN!=!kd408b-(lyY*AII z(U1b}6QtL+xGeGVQXVL8jEIlra~w0C#*#bqq<>;JB*L;EB?464I*CbtCSn; zVF>NLs=0!YrmCz?vRYMp$u}5VJU99_; zhc$H|0zUaJFZXlnQIp5slC1d-H$WF}Ms#@c@!^-obHPT~iGsn5{k`H$d83~c<`vZf z>uf7FbdAROG%5Ji2==%e5NtPg?=Gsn0Q+#W0W~GIFK}dNScVE9>irR)NVDpF(7FZ@ z7GA;WK$~kn)+(yO?}8}4F*W~;G>LX7)-s?8z}BsRtuqzCk=ThO3^r2RieR-?!?ycp zht=?d4r267Lg?j@Vi#UaYI743KSQ13`SRC2&I3GD-~t32!)6Pc1LD7&jFriUNqD9P zndvQf=6!SeW$AhW0_?2AAuo`T1StEX6Vu^hA_9J(tD7nv#H%lnxXVh zMob2m@r$oRd{r=%Zv3vu7vub~zD42#t0R;I?dyVd_ULy0*c;n8R4rX+pbo^mPS1=| zAtJ)|U;}AALzjn``z2!7=ZGq5zUfDt3!YlhQ;#r8$J#oD@4C`|oFc-m*hQ0$TiC}r@vokC{ST3Ge$JX#u!b;zQng}^qZckta#s_f$;|3+cI$dex zel8ZqaN5A(;i6JsTg5OFd4HJ@e}H^Y34M#bHkT2wnxt?TTq93~#{2QZ>g!_keF3>Zo$OXDERKi*6#&9JaT_r~jJr%8X!;#gaHHyFK7dpzJcG!#+-oU2v?V zXHP|eH*-=W;8wIirG0)u7&nf@qs&Z2*%U!+1DWA27|ALAxCTa|m&ne`$}?Wcqelr} zq>2vamo~lc>uC=*O7U}gLM|Ij^u~de0q)N|`Tb%Hm>;CCBEV_Vr!5jRD$qohYrycF ztAwu@G1@sInwr1=R1VgGL~XmQOqjnla=#P{=1Kis;5$a5Xav4QEscG<1r8!K40hHO z4TIr(YTZ{2r>S`ndmC`=oeg&Yv?81YE!2b%22fWyn;W={gupjLi_^8pyFFh7U(%`% zS#6Ef1P_;WCa%Kh!!DoDlG6S(6a2pD4dy}ciLXC^~>8M}L`TYTOm>)QnXrUPk z?7(%Vm`=RPx}t6|s=~H)g#_q*1!!@*WwO#^<=>4N6~cz%WdqgE7Q;wlYYt_0`m9pGOBz94tDH-Ctj|X@dnJ2ICkg3E115K%-FZT$fH#p?1Bfio!qb)|NRwP zF?Xg0_B^m~FZK1;+rqL00cft^D++^M_G_?Wpw(|A3n^C#Pt!|{N{({oVEtm0y6aLa zQL@Mu>>vy{%})imk6fV>Icj}`;)8{y=z_!Ke7FPq`0$Ve1xnHJ@u9*nbMOs#Mk4(R zIOXtJ2WsV?&TIwc7ob6sGAyh`wqK(SPf|~9+vVh?w!2%DtHf}J)Q^lr`Yn1xcCK$l z*u$#WNZZ86A;dWfriI`6pS(Mx{2JT8GwF!WQflmeY32zziuh%eM*wyRO_|suj4~%> zpj~0Rkq_wz(QKT#7M{(eFffe0sD^rzgXWF^YxD|&k}T}a#$IcFa0=s_cZvT{pweWZ>_LP%^ z4>wmZ3;#9))?m`1-bb%GkApjv2o{c|Wz@}Z5b^E5AP$ifuB2Z3C_enR4Sd=gTRnmT z8ELTd8)^mEQNw9_1g9?{NjS))+@YtI2PzsyHd02_fbN9>73!@(nLdD~09t-hyF_Kn27n(vzP2nWjo; zq(R=D_^LEqzCyoJa3%7E7j|mXHU81z8HY2BG6P2N#1WBt)6~XySk8#-7x4Fpm`X1? zw+md*K=U{y<>nXk5TnH^@;OTMLV63<-In9&8%@hk(5@cPBr{{nK97P-*1FwauONUw=j#dh z5E4Oy0OXLZleBaz07M(0(&lZL1`#Vqzs*+wQT#0o1u>5uhzURZV4$9@xWR%!LToX2 z{)B}=j=r$z74&SzO<~F0@Ebvrh(Tu1PW7F|i$;c*?H7J90)}d88!|J1*w%cCYY*s; zK(tYG_h&pPsHsTQ&V*8p;{vMX2hhZHje9}ZPxv=CH)dA}x&IJYvxS&HfPWM3?<;@? z*h5=>KsZ5l(2y-5Z5FB{`~!^9?ccRu78|Z;^{veR8f6@XRD0pTzR2*?jT^J=5cXFl zM&fdSqCh79A><(c1wAtm%9r)IuNyrgHX2~mRFUlD?g)caFj#5bDj z5?L_~pbZ8=c82$W%R}LfDnrN;??CdU8Qk4L9;V2)wgI$!h?79$d$nr1*gAPWBikB8 zi2i+;Prbna`iJ5VZFdmK=Y)?3Z{rUmjQk*AOvCTgc)W4dYJ)kGCPPZCKQ~_6W4Qz6C8K!2RG~&J#evvq7lASgHrmuj4Z_kQ}`UGJr~n98GCN zoJvYc2TJ@7U}8v{R_~6Q^ouK;e~yJ$+)_c0Gug?sQ6V1smDeBL9#yahJKz zAl!LZ3dDDup-c9uzkv{vy1FZHFW4J)en2c9FuSnmXg~pE4}HEO2ot1Zx3#w;64oBI z^<5hu_l8S=Six=ih5VS-S+F-$UftTp{h@8FJyU027s10!eRpv2Q0U4#vyqz7gWrzV zB!0ZDsTtRB9D>MvkeB}^ZZlwjAbrxhSuyGG5wtP=K;X-Rdk6XfshcvvjwG@VsjGm1 zO=lY3i|5Y`AQsQ?XMg&*A@gj(Dk3@maktwM^i3f)PfS8G+so*4{noA3jo*Yc+P0Bh zae1u5H68Yyj*tP?Xan23vi)(>%bRH>Ux$Vgmwdh6okSwzC4 zjmnXmm)ApJVAaFewVMYNYJkU3vsSZQLv3ti1PZhgRTK3VopE4Hc63$9!#REY)h=%A zO*{}o9J)&+=Dc}qO*g*?NrF^B8(=6D<` zv_NkEUlJ(XL+KTuCX@oU31tLimQC13X934K1S5z?K)w!ISRT4@6RQm%HKU-QkOPwb zgGzkc2i_#H->nW)7hl~Q@u`Cl0KUa|m*BA~*etP@MAF*b*P*&1+R;~;neSWvz2GaK z4>*M3U;b1^EQ%7mg zj#nR$H5;2HU8~msO>BdSs)I3rfm;LcO~`8xWJ52r8x=0^b+La;0c2-X%647IP{4U!$jQN^u+t zVhRg%0qH?6#(n4FKJ0!?}Y3NnP0Kj*(MEG)q7NLv8o5;-#iiVV_BAUxL?aEbv@Z3WXG zAqN)R#wLH{I}kiz+ag}9vt4+8O&x*f2TQcIwU0sJ@lq@lig^m^bE_gCxhT3^Sf)(- z5iC3iY(;c{X-`c|WMu$Gf}wwJHYx4>Df_ogpRiF7t$0@OSnH?DJ$yflS#b5&9)pYu zQn3kaNe^h;nwgs;Zu7STfUY&A+MZr1Sgx^pH~$tP7g>q!Cyf*#9152YQcNJB1gwj>XVT$>H^q&35g#Y9esAvfXu0Iu8;+I?)iqu5V!hm~S zRV6H#$hK7?$e3Rwo?L^j9ZiwkaicDa4e`EvmPlK=?q0%Aw$DCZ2$e+QBf@)E#WfiR^6dTz?fJ-}g_C?U1q+#WIZ zwxk5r>ldl1Q}U-kHZJx4Ti{=SIE>+C*l#P5Enfhz)rnsD(9DtZ5eYu!+U}R=UszMu zajl7Cy;re7uW)^XO&!}>&-Yzz{A;^`A-tE9ZA1IaVL%yWpKiInn{-G63|f>CDNF-W zs{S%EKqrcNex1{Ey7;9SZS# zNb&%x@aA*_gm=Th06)L^ao{uLu!6b~`LfM!!edyI zRg$jdT4ALHH=L3dPfkgw7g$j34M89#=bfH91wckg#l1-BLJ6BFdxdiD++qnrTX=oK zkIX_I$pw=$^e~m@#@<>#w|}*CeF%>Eq*_9WQ>Iv;0~JSmzh5&Gd3m<2D)0G2jXnf- zMKQ$L+hLu2R+IFqqxJZ=l+l9j*ieet%E0aM1_(amW6(3*f`J@bPg$%ru_i9yn$Bjh z*J=8?R#|;!j9}D7>_MmTrp$Ol#K==PU;(1AZuy!*f(3gj=jv3u)!O}}7rp##>+Gz$Mw856AO5)6Z#NCF@l+v)q#PDQ z3+t$SS$Bbot$cC(+lE#O4H5ye3dz2$jE$u07=7s4u=&JLm95m<>2$R%mrXXh!+$wu z?R|5c>XRnq+>BD#i9*3)t_QqX)AisZs~H1UvS@dPd6DM6+kYLt&XLkDZ@%iN}kylN%= z$kF#0CbMLUu$e!H+SVstSdb9*LrJt3#72b?$VKcng>i>4C&{)n{FZfuwyhAP$75%T z){kL$|4i0RNh_~=kP@24P@PABMcQ=2vTuo2!0k-!W9*+h?`g)4A+KPNYvlFlw zEK2;L7b8VX!R8)|l*7j;8sr=0ggqFP*txPav4Jo&TUxY*6jNKa@e4jNdHHNDAR%UXn!Sf+FX9VCo@p7}J9AHveX-!pG3Y_N8s3L@27@48w@xpjW`)M$ zGQ{0h@ZLz7`}})SPpWA)A;;^9oZ;=IJ{=?_2vaI(!^Fr?lYJ}Y`K7(MFTlO0Wq6+# zWoWC+L-e19_p8DKeiN!(8Rg?`VGcP9G3c-kie|SWDc4#}1bPUdTd0nWYHtotO25ex zg>+qc`m%`S_$MlC9FAdln$mK|j%n7p=ljo;D3SC+>_tJ@o$KW|!*V21BixToUSPI)GE0KhHuq^vQp&A|7k5h#O;|J)102 z9e1ltW_!_wopm|IlCpQrADiN?S<2nfUzDkQW1pFC9gcE|z_A@^A_ zj=jm~nu{8kOb6s+?W%d!-N{dSKy=cEX|~jap%$+;8h)0GC^h81E(v7mS?tC^x8jxq z^I0Hhf6ij-oRM^F1i+&oEG4qnerMHR;}<|uBI&-lfx&67h{watOYDGN{s*=v$x9|5 z_$%}$2%A=A)z7_YFdBtioc>~J&z8dN5TrMzd44c~spz(HfjZW59cZq()D1YjMq2IX zV>wzU&I2Ty8hZ^HiE1CzY!;FRD7Ld8j?A^x%l@#2=w6U+z+4Nry&5cwcal369KFT| zgX%HR=%CE{g9$+BA3~Dq$c|8)VS57H28Rz%I>N+16K4jUlOkx42swDd>DIR$4^Y5~ zh{o>G&CP#be!EaJCf7DA8~;9P-R7|)cspBtnlG^BY(IiJI$F%55l*IY3SK1gl^&?;mRbqs8q7v{v`F)>j_c%@$8xi zB7v`eHDF=bjg75omo_!o^-P1zjaGnVFNfW})LR}r`g3p>KlJDUiYc6*J)_@6l4KK^|&H7XVYo!rD zUXX$CUv`J~+Opg~n?+p?jWuDTT3#Tr2ZTRNF5k#ft^gZGa*|*Ndlj{umdHnUjc)r5 zOp#M0R(zJx%d0ser)IE|F~EAO0h%1sOFgvzsu3KXK<0T{Zy{&g#47)9^I9 zQ?RBtGUasz2ZNf#>7>3Ja*5Abrz7+mwh+Wapu2}`ufp_RUc7Jx&_KTb$LejnJ!!*w zC@(%wQj~mUU-E^H+9kQ2Y1i`7WJcw(IH&O>6Ft^bVEt*$q|RP?>Vv*n)arZArvcya zMG!XLG3QO50!Nc0vIVvi-1S8xcDg!>89XP>t(|cL-dRX-=eLbB&+m+KtL;+bu{jg>l2MoGdnVQmYI*h` z75T6?`~5!y(>?DM4zVn~NcX%9mzav(4)2T!;nRDWD7nH$M!`CQu5$ z@K^nWK|+jCyVNHD5V^?!G@DecL?-#Y_wl7Q_&LXrQrS&zyasp(+{TkLnO}N1t zerYJ3rcJ#ZC6q}5jp-?L?%}T`&Uz(8h~1bTFG?{cnfSK&uV&qRz1Z}O5yRki(R?K# zn$YLQ^$RC+Fn|u<2-&|?!jeU<3P^MDfz0&&vuKOP5X@S?e0LiD+>g16nCiiO?N=jUYY&b-Z!-MY|lL7Tbq zQ9yOBiF>lxJalWtjP*wR`#s#hso{E>b<`JDgrR>iE3k$y+VT~DIlmV;ya3D;{F{l1 zmqw`svHT%A>~m%#46M|mZso>^v7m$ReJ>P0l*wknSr4_NgIEc=+Jq1Kh4qyP-=5S` z3N#KSFD0&#wkZArE;gUq5j*O7$bsGb?=?BV=I^X5qbK2Zk2bJ}7@gjBmT~Zk@9DoW z)9DE~OIk2v(8w+beuF4I7rYPv=zE{CZCy`u%jbTWq=4*Wc!Ahs*mA*0E}q#x%jcQ_ zC@(9QYhjs+8;Te6Z#bq+&iD84Gw>*4&#IX?q;xYO)6>=f2!slUjldpy=JRp4$1snpq_peBw-mkwjZa#1Z>(Uu&FymX2I-O`ylm z)WeJ2@kbvvcePJH-5MSt!ga06-waI?%m&{!`Zzqv>-RW?&gfl4#>%ZO@kS14=N>ati#m_j;#~=-TT>3e?)=!8dk;^B-WnEbIB(meRAl4iAVtbC*!7|5{f1x=czjW8ZU}bZZ zSDD9wxFMWn}8+rA@P!bI{C^#z4cz+svzxVg2Kf?(#G=S!u{ePzD%kHf=A0SH` zzvimzAMe}p9az*Z^&I%cF}7DN$Gm-Uc}_=uypY)X)|}ece06f~R!#Ll)O$KaeGStj z@eSrF7#}VfA&Fh79q^jU!Vr^ITV+O%B{n_QfCVO&h3^c{6PV?i&4{`uLVN^AC#m8d zT8!=QHh+>6wpwu?GR<^q`zK?Lh$(R-66MsQ?7ft0j%QzEXT=*K3B=ZTI2>n@>xa?e z159kn2DWK;I(#&J5Fu~8p^`ujp&532DL&bFN)cjcSMcn)+;#HPg0N=s`^PKvjxa`@ zxl!f83w@$wNITs8xUJuaezF@#$xpzmMU>?`?ydDaV*UwTEHz>Qr$w;eM{wkFLkt_C z+>(n0lvd#N|tTojR=D_ibIegs-*eME!@9g6IJYOp zW+PjUAnh#ncrK=`0h^MES0BhQapWzIE#_^gz9w*TLd1H+a**E=pCvt?5LNBWoDqeA zzy3MfIB8_&?!(%z&oi`x-_yY7t!KQ$n#4n!D;Fx@F(o(J1ZFb`(%1#I&75l`4UqAw zzBdYeEv0vmbY?%#OYi`q0G`ZkqgGKKJ3ir9xbO9&5>;Kqs;BYD4U&q`9zi%_=$A@I z`J%`XJE*__4b(zbVQoM9Gwl5xZ~RKtd*xJhP{@<=?r(*Qz{ayUas?NAyzsdP8ya$~ zf4$qpAx;-Ob}J>(eeak>85<>4&a8tSHj70{sY_W~2UQaSbBrqWvgow}$Nd|edXjN| zike{RQNOa_y7tH6x*kE#iFtPlB*=A~mSVGsR-c{hLh9EXVNaCjtW*$sfRA>CU6UY% zCwIDIE4b2FP#_Mv=DWsc@SMI}NgL}gHRXW8Z2nZYab~>117!bDsBun7STkT>%3NRD z*or-b{fLH*JZWu#WOesH4#9UEF63OsFp@-Wu5Ea>2GRr8O~4I3PGvfw`8?5&zjXBh zG((lw7mRmtdy@rNZYr*J!F{QTALX;YKq#nyZ%J(Sj!tk;odh#D(Ek+cw!fJ`u5|X8 z{o|~h(}QKi5)Zw}aM2o>HMyHS(S2?j&E-F> zzwv!sc$n~3smmSB61lH8)V4oe^OBCxO3l)KyKo5!-Y_B?Z8guX`sDW2F+u+8nZ2LL z=C@R$R1MKyu;;$h&>P$_w)FrW?4RAGMR88)5;@MNXwg+z9tTC%HCy#lZ@2Cm|3Cv;hy^)}AG<9$1iTl33f!`qk)xdyCiQ?A_IW|v(bvboQ)z7V2Y zzGl#3Hmpq)cJMb6nNr7pci3N~iHi!e9BR+Ugq4;ma!Vv~Vvw|*qN=I!|HG_+)WIJB z3jP(SE-l?aaP|MguGrl4{}Z3q(%QP69co+r!4k4c0si{%Gfu&WC^s+96Xds{%%HlC z4pN~5aA1HG{GirWy(g>JY>@Di>yUb<1-!3|()F`iSlbrwqTzr!Q? z$Wy5Qb+l&o$Sn?MomcEI2n3Xn77C`8hW-5Y3(Cg4fEt2O0otI!XBS8m(mz9~93Cy@ z<&5J(+Mpc(2ml!X@B+LDLqETUZp(dWAks7dHG+eKZ|PSOToEj<<$;id>l*!TZ@ zcTJ;RFX>n8^DGil8oExheLctMOA~xcqdyoA#oo@HxqnYu#|bsh(mhfnMMKF5$lur1 z*5(83AF|&jAz`q%s=WLQWKbjd$?pOA16cs?;%Vqrs7Jy>FpH%1L950*(vac~fWWza zFo1^o0rj9pQ_|P>FiSojFyEQox4mNg?n^_ED9Ci}+9G6Vf9~!5X8>vWP>bUayh|8T z`Qh>I$F;I__BZkxU=cjY{~{#Rj%}`r4OOQU#a{O`#cdY9;UQ<~&I(q##zR1Ti2eA0+3k0JLZX8u<@xt7o4AYh{!Z z%CrwAq=nM8!5dyXgN1@ zG~^O9Ge99P$Yl*3Q2=Br)D$6`eETry`Zhh?6ecmlkFv2ZfM-D+v{g{x9~l{GZ`<4d zJ&)7`fV9TfiHX%farh13pGfGpRSPDXVe9laP%8H0lo&70t#rj?>wtF zx-Q$IgfxO~3pLBdB(XpTv4P?TR|uiZ%Rea#=*`u64q-@NE~);3FG~BQubP#G@uUBM z@b9&8J+-2mm#MawYkS`;xK3J&9_F%52`7Qg2UJ5-@L1nv-1Yz8D3*ZF!IVvi}CnifFR8$ zk`EyLp{=3u(^W@O@)K0|VPpVEkCeD-!Vu~e=;$oC3ARU3%=+(0v2LqG?9RUUki7&0 zeWg%H*qK8nPAe%_vqDHbHi#2W2rNQ+F4MMZefb=jDqF|Oy%Zy&oLe!W7XcwP5&`rQ z@O2nKs8a=N{3B`X6B;j8DBnE)9sb@cvcCdgB2YwHp`Ea@1)w+tQkt~a>hSmR(QhCf z+<|5B*HBUAAIw{?o=;Bv)Ce=c@ZqE;w9-?4WE*O%9L`+uUl;haI0z)61M2XpSIIZ? z;`fgH4rds*XG(p_`JO6B#4&b&R$AD6G4MR_StMmpb*shc%s_{)SBU|wC< zZIz6*1gfScNq@{MJGD#+Ub~iE>DHS%fDxs<0@Zb;?)`S05_>dZUuFLva*c7RSu5nh z3Q`_`Pz0g_VE++eQE3(F&CMG%^okxI0EdH%U=|9!$t$j`ls$vGB%TdBAbL@UarV2ChyDc=+~G!R zci9}3FH=k%d8KG2*ig&!Tpx&Hye1=UTz|bY*Mt16DmB!D31EQb=QbA;QzfH-t_oa8 z{=(1b(AGz;Eosj~OQs+0dBzmVh1l7x0Hg4(g2Jm;ub@=sI`r}s)ZG@r%gM@0ftCOt z1-KFg1qJ(H8hYS^V6M1=(1A#MRbFv%s?b9R;2c8TiHAJ`^KK$LAYPKn4)lVtkN(Hg z$4CDX3|!>h+}ywnLLMF=5aFGd#CFaehi%_lzLkfH`nuPZzBv1w zfx&&PI_Q=&o_?KGW&LBbWTRN*8=pq3&*P%RFdx8k89s>9l4Ye$CVxB4!Di}qSA&%n zKc1ssAo$7{7%ljQ2AkpQ#Ga6J?Ekkc&HXlXaQ(rbuBu57q-ZeIxq{-US4c<(J9nUV z2vX1xVH$!8#)VJ(&O?@}sX-WG!6+zboI5UwKyLA}XNqQPt6phg9rD zb0nK7=l-RNatnN|HD^%F*yM?-Cu4kRdE$3QI|L8tFx301%dO6Im607Ztf z_wR{l?u^duKmxfv6g^^i4-`NZxy?oR(o~RyQBzYB7jFWlK+n0^h<8? zE5)BBDRa2Df65wZ}UQ=|aoIUq{*o{GGDYi}dQ|0V;_NK<(2^<-p1=e>-KrWS#i0W=Jduo-Lc ztreXn9eTew?w`uTTH^ns{`abYfr7*0i{t63dOTU(X>V%(RI8FPrrNPdCeR7hb(_yJ>pWm5H0BC3H{yJ19-%R+1>L-M>@YyT46F@^$jUgUcdozyBS+M|Od5TYRNG_1_=c z3kkEC7io-j9~rKp{Yzw;BhBc)VaY=ivb!cR?dDJz-sm^%Mu$MzBJdM4rr3OR=P{if zRA&Kp)#XU$Iu|F@Yh|kny;sS}%@=5lILPY;KKV2_&f5e>+Cnj)CX@9?cO3rp@!3nO zlH$>7zuM)r-)o^fyl#<>1a*raY38^>()zcvZ{pXp_U0r9zp(JM-)cc}CL!-{)oQ91H zwy#4K@6d{h3LqArd+Y>46-1jEhztzWFc;ieR?gYP6Ws}?`6rl8|I6OKnva!worJWZ}2C1jstUuJp#dRj0oI=J(b<&uMFnt`;TSRXgu;H!|W zQ^q6s4dvqV%3N7jGy85RK(3|PRVIALnxi64erDVf=7?rP*D_jG=LZ5T_~Mx7>gcoL zu)?55?HJ;kf?fvX(I1Jw^s{)dmlV=!T!Vb zuXp71g<6{69q%0v{rh-)2>Z`Rpi3hb8fZcAN2nN>qMSpAp79P1W4DdC+MWEoW+sSh zK1JBYO7+??YtL)F7LT$a)A(c-g>6Cc=w(S1>f9pZzg6Si`S$N2Y6RoaRX?Y>UB4f{ z3`xHB;PV4d&t1@Z5T@yUeD=J@+BX5vnOGlDNxky{YSe+zhobNZWyZY@?E5~j)dnAM zzk-VKRSvI}b4YNSmbXQq!Z}n6-P-k;-kH(O4_xGnP`4e<0j4z50|PGL1D_{jgDT>nO>=PI6GVTR zBpxb2x$kXRS4{{*1!p*NUcGxr;&Lt|_+v`G|F5$1iplaOH`_pul$i-#{_BNesCPgQ?cr*u=_+|(jqlUYwkUCV84y~F7N6!QH|lN4>2ux zm(5WqT(Dx(TX();Dz0o5MBJurSiBx@MDliC_D4GAv^fUg!y_IOJUwjeU| z#J3)0eWnS?b5C(mVKuo#as9S$_Z`3N_t&jFxFc|pJOo2tcK%lJ_HTdJ^j7AF7$zck zO917{##F-u$qVt@x|Xx?wh_fiDU{JHvSyi>)3Y-hcxlH6KlF{ie!hZp?kSkoXB-)P za@j4W({8p6W4Vz#T#|&W!HqkxCMu57P%}N;8so3vWZ~t}W zrmIETWgAI)oU7OGSX)j6MmC^wcHT(&&MSY?=WNDWdJL5+B~uxHdyS`NdUp$_sv>C! zCM?R4vX*A|U0qFdj2VVc2YfwF%!c^wIMzZ#LEqIl>TuVLFdTe(3@4lMcfS1_)55y! z4>2YO$c4nDa3OE}(T3((n7*-I5&;rusnLebZXkY)bY@X7U4|}e)RFdi_T?b&C5sl> zTb5-z>ODboYG{14aq<1cnHRCb7y?-&ZSXSg_ ziM7=L0UcUfCn}bWhq;vejF?&Yce*6qc(uynB%W5YsE)EzL8|D$g{2ML)N$>NrlhMM zf>56?i9Dp7is;uSWs%?Zg0_cA#!@0pf(_-kj9(=ud{mLrgabO`d|HaD!){ha*QYEB z69VW9x-}`AXNvEQ$~Im;p3{CS%XEo@0Ip-)e!X@)M;LeQi{e;K_5&NembUoQpWa|jmy)1EjcyhB&2=#2cB6>fVW|J$hd0~S z|9ifBS#jM{i|oEbwZQZn_-M0W33SVN-d+##(W_2fS8(o~MH(I*ej$!?k%!8m=VJvO zqgrf0KRoyL!rz^$HKC8SDe_zacA+;TV103jkkB&4TXDhiy7^?1v`M4!!9Db;u{!_k zjXd9Z!>NF8;wYa;n9FUZKY}da%_4ON`An~`KF$kJ&A^;?$zOI8{Ug5Hxu*;rNKORf zXwZp+*SWwm;D76tGnmtk?9(za66lU7c`mU7Gfvz$E+o`U@$oOWhV09VKg&I}yKbV$ z8XUktU1B|5U0av;N`)$*I*0hQR$g=~c>txN#j`IDt+GYE6#OE@smA0QbyU%(-ol5Z zjp}do>*hf7q*|Xva^B98$!z>$O2-!M{VdAp#-zXbRLrmYvW%BFv`8hybf-iItKEO^ z8qvmEqAJLJ!1}w7zO^j+9xp^0aKi%vcsPsplw!Q z=on26-Fk>YxgcMlGfTsye*06y;!B@0RkCP}#vSM~=0A9nLJ9@O0%})&3XzJ5Lf=~O zHDK5ASX@elf(w&slp2SL4}7c33#}^Qn)#Hn2}XG2-2|pBoh+iVq5hAo;4p@TIujs^ zTJ(eE*OY72Bq0~!gQabMZwvqJ|8V%?mJ8k~Oaja}sjvLFoi~$TR^E4yMHVwFvY5~O zPP6v;6OUgd$_h^oe{*a`0Di}1p(E_0$$ND0I^{Cnc`Uj;4VRc<4HomM9$gw=Z%T6Q zp@HF((}6~Za()%Rtrfqv@ghVaM?W(eKan3MGGATbcZDbH^?nDpp$A(oMsfy}62&Ef zIQ)H0Q<(_*{JelLm|@Pp{=3m~u$~V10?phWovpX8nm3l&lv5>LOMZ1I7A|?iS&?)j z5GHP#R>Hs1m>yrhQq46w6vs1}b^W&+0RMmORi`jyp$1X0*LcWrc$dZcWklsHzh(^;Rb5izq%wboA4UglZ~vdo3grw_ z`QH2f3vnM@J-!BYSuSv!>&TvB#eu$q)3_6uO@Fq6IeiMT<^}yIQ{stkGue+B9cBbA zJ*;@0Ov^kmg&oGRX~eHI#9F|7NI6yK+YhFe-D11ijgqs_Yf88ZwubX|viR+@N!MV{ zR8mlgP-3E^gl0c}@V~Y!R9MBSdF5`iTHU3NxFwyaKxe9Mx+D-bUUux^vk|x&u_Hr| zb5WL+sZLX?cC}I3I6$5YG=2!82E&3Z6ur9l=Cq4$eu=t&o$f9?IwQ|+ad$OcAt- zgHo``io#7C&H^@EKaf_$(-?_x$>)T_15yg0_A8Gfrw)<-#BBMLbA0%N|pV5I8eg+rDn=6giWV4Dg zGXKpBcmO-5jjG;c!{O#<*n#HY!RKIXHf$5cZ+BUa($-hd4Zn%@y-tS<3#R6|R+Z?( zH-GF%DljNBtBzLk__toK8;^9Ps|V;PqM43n=fW>KL-wDyf+; z?lsqQ8kOH>M!*c0Cduc8vS^car<%QlOS$0Ew~y2N8X|s?5oryVtDiq5CJwU+vC*fs zn=;Kh#Ba9}?H_;BGvRenBn<~EmYXa}zPCR@SVCRouw+>*h+<7v-qMx2Y%VqW{r@cW z=bYro^HGo4F+RWDX1iqBc>X!PI*a;25XsqQzfMQ-O8%p#X44Pqf~dRza_Ea4trGV2 zkrFD87hlV3azjv<>E=jIwN{U^QLI_W?1kr_&v|RFYxsa~@xJ2O7Mc)Dqo}jz8ApH3 zfBWVjb75z|Tj#zpo=X}oLpa0k0wf{q%ukr67iN$P<+!~Q> zn=Ym!MRszUMky7I25oZdLRev#kit}}FlZ37E@NFcmt5O1nMLGMcG6{#5t@ooE{!F* zM(6os+O8N{E_JQ40n>mXScF1oX}DRc z=TDYxL70W3k-&!483k$?otX_R<9YQY>q8=o`l`PK&cG4{grAYJ!n*F6`52*p`0>$+ zpl_GCG|{RMM5PUV769q=dZ-d>YQxfc5_x$H!q2r@8q*b}y-~5o5>o}Gm)0H{e}*@( zV?3*P=BNq=q1S8W`Lp8)$|3FT5!uZ-(o8~UJVnXfeuUKjM?%-9_oLUyY%^7)0ekZv zDtS0|&mR-1pE5ju6LOW7F0MR`bcItJ`@!D%fCdo*!*Jgou4@pN^IkUn$LXrqS-L&tkC z5}_^!6VZzUrfZ#?7Te6xffTI*dfnzr+P~N9n6O)}`9%Lvzzv zb8|tlnzz}cZ?l~NUWqv670WjjMIlJfFY$sFb8ptI0;7yHKa=6X1bG4;`WjqjnG>$j z4x>8oZM?KvFy0P|)g^v9T!Yn-t)TatP4(DVf_V_sLG#bX8DZc#fC)0E}&^iTZq zXn#C7KIJ~w&0a0X z)EV9(>hle%Y>Mc3G-X|+STleWLk+Ee?;7#RW6{XH@P4e)WP$=x>~1p5u|2YxE-rs^ zCylX2dD$5d%f_9@%Oq>d=SGXdoD7ifit8GjY?);g zW0}J|3Izb68)`gm!H)lMu$G23PGuYI{&k9q3C$d*On|sxic-3QYeNf1nx$%x%#mxJ zod;3BT&Paco}M~W*GEU8?EU&h4p;___$#&Xw{tNPWZh%ckX{o>ywz@u_ZIr zG4t#RQy>cyP)U`v<_gC2+kQEM7o%TH-$fbWjm2v7DY*4_HPWhxRhuAs#&2jDa^bXcYOJf4`;lrOV5`n-$mx03ECkzJSNQkAIfaQUQUk zB42vlr7wwpJQ8`s*|WJl?G!Os%yCOeOv~kf=R<)wvya}=6}Xx^g=bgoL(4Kn(_}yI zS*llAd;VK0ff<9U#7q9j-Kux{2geQ~6qkqNst~NcD2t_aVX3q3c{72(TX}G18+t zM6n-yC28LLj9 zPC|$Jr=Y{T>w^W0F0PS5{O+EC#r^SP)4vO98CLqXs_!mpx6M!C!i!xGN#wEJU}h}s z%RuEF?^PmO#bc9dvlW#sQfa()w8gw0avq$;tO}KHOmKCRSlgey!56Obi<3l%#bT*! zLUAx*MRQt!1T=%CdAk)pTphWO_8EC!Q>V$OQaJjSVn~+AGbg~rv0({%UJ@JkIHk-F~=H45ba!595^6lB#%& zrjG6p{lvAJI>u}29JlGdyNF~{!6&dX4$3k9bhX;mjoDNb!>V77(4i!NZ5cafuc>8o z9}Xmzbd92uFMm=b^2j$(#vupR$P>3ub8T!oRpP_q&&bSvH8E^qXWcf_ z<-q_A1b`eeBKnMKt?J?Gl|PO_a#4*Mc2CS-#rwHQzHe>R)ZzAL5pP7k*@}~0e4Wnm zdHQq)K`J4eBJPjE!Y?~=%DbfJg63ZIFAeD(xmbR$w7Yj`l6SZEech5N=h)_$=`(fx z`TTUo>-Q?&RxVbtFFi#kk{QEoVacwBGjJ4ob}-BnE}&i++9JpWurxGev?zls`{-8z zz$;vZumnU~`&dvFu1yfkXqy5cfQESxoz~yxcBdNo!e?;4#*xgO1|jG{lnC9u5jM;< ziE*N2nvzEVJe2|`Ftl;exs%t-c9lnH)KMNL!c)npP5)_dv+;hE%6QFNy&4+&RkZxG ug-|M1!5F8!Z@dRJ6cXF=Rr>F2;Q8J9bE%5nZUHCIIa}|u-CIU+zw$3cK!3vk literal 0 HcmV?d00001 diff --git a/previews/PR237/assets/tutorials_creating_geometry.md.kdUBQRWQ.js b/previews/PR237/assets/tutorials_creating_geometry.md.kdUBQRWQ.js new file mode 100644 index 000000000..5c60dbb2b --- /dev/null +++ b/previews/PR237/assets/tutorials_creating_geometry.md.kdUBQRWQ.js @@ -0,0 +1,89 @@ +import{_ as i,c as a,a5 as e,o as t}from"./chunks/framework.Cq8AuEls.js";const n="/GeometryOps.jl/previews/PR237/assets/fhnaafw.Dz86q2IX.png",l="/GeometryOps.jl/previews/PR237/assets/kpqpxvx.Cx40vhB3.png",p="/GeometryOps.jl/previews/PR237/assets/aecehxl.0OJvb21A.png",h="/GeometryOps.jl/previews/PR237/assets/dxmotlj.DaovVbE6.png",o="/GeometryOps.jl/previews/PR237/assets/vhavubn.rOsRk89v.png",k="/GeometryOps.jl/previews/PR237/assets/vfshmbk.4wfjCtJV.png",r="/GeometryOps.jl/previews/PR237/assets/rukbfux.3sfpQl2i.png",g="/GeometryOps.jl/previews/PR237/assets/brxrvlc.Dab1-ETk.png",d="/GeometryOps.jl/previews/PR237/assets/yinaqkl.D9AE7i2o.png",E="/GeometryOps.jl/previews/PR237/assets/ownkpce.DTKLkKh_.png",c="/GeometryOps.jl/previews/PR237/assets/ujdqybe.0f3Lq4Lw.png",G=JSON.parse('{"title":"Creating Geometry","description":"","frontmatter":{},"headers":[],"relativePath":"tutorials/creating_geometry.md","filePath":"tutorials/creating_geometry.md","lastUpdated":null}'),y={name:"tutorials/creating_geometry.md"};function F(u,s,f,C,m,b){return t(),a("div",null,s[0]||(s[0]=[e(`

Creating Geometry

In this tutorial, we're going to:

  1. Create and plot geometries

  2. Plot geometries on a map using GeoMakie and coordinate reference system (CRS)

  3. Create geospatial geometries with embedded coordinate reference system information

  4. Assign attributes to geospatial geometries

  5. Save geospatial geometries to common geospatial file formats

First, we load some required packages.

julia
# Geospatial packages from Julia
+import GeoInterface as GI
+import GeometryOps as GO
+import GeoFormatTypes as GFT
+using GeoJSON # to load some data
+# Packages for coordinate transformation and projection
+import CoordinateTransformations
+import Proj
+# Plotting
+using CairoMakie
+using GeoMakie

Creating and plotting geometries

Let's start by making a single Point.

julia
point = GI.Point(0, 0)
GeoInterface.Wrappers.Point{false, false, Tuple{Int64, Int64}, Nothing}((0, 0), nothing)

Now, let's plot our point.

julia
fig, ax, plt = plot(point)

Let's create a set of points, and have a bit more fun with plotting.

julia
x = [-5, 0, 5, 0];
+y = [0, -5, 0, 5];
+points = GI.Point.(zip(x,y));
+plot!(ax, points; marker = '✈', markersize = 30)
+fig

Points can be combined into a single MultiPoint geometry.

julia
x = [-5, -5, 5, 5];
+y = [-5, 5, 5, -5];
+multipoint = GI.MultiPoint(GI.Point.(zip(x, y)));
+plot!(ax, multipoint; marker = '☁', markersize = 30)
+fig

Let's create a LineString connecting two points.

julia
p1 = GI.Point.(-5, 0);
+p2 = GI.Point.(5, 0);
+line = GI.LineString([p1,p2])
+plot!(ax, line; color = :red)
+fig

Now, let's create a line connecting multiple points (i.e. a LineString). This time we get a bit more fancy with point creation.

julia
r = 2;
+k = 10;
+ϴ = 0:0.01:2pi;
+x = r .* (k + 1) .* cos.(ϴ) .- r .* cos.((k + 1) .* ϴ);
+y = r .* (k + 1) .* sin.(ϴ) .- r .* sin.((k + 1) .* ϴ);
+lines = GI.LineString(GI.Point.(zip(x,y)));
+plot!(ax, lines; linewidth = 5)
+fig

We can also create a single LinearRing trait, the building block of a polygon. A LinearRing is simply a LineString with the same beginning and endpoint, i.e., an arbitrary closed shape composed of point pairs.

A LinearRing is composed of a series of points.

julia
ring1 = GI.LinearRing(GI.getpoint(lines));
GeoInterface.Wrappers.LinearRing{false, false, Vector{GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}}, Nothing, Nothing}(GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}[GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.0, 0.0), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.010987813253244, 0.0004397316773170068), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.043805248003498, 0.0035114210915891397), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.098016055420953, 0.011814947665167774), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.172899020101585, 0.027886421973952302), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.267456684570245, 0.05416726609360478), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.380427415579764, 0.09297443860091348), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.51030066635026, 0.1464721641710074), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.655335250260467, 0.21664550952386064), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.813580405100698, 0.30527612515520186), nothing)  …  GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.866418416586406, -0.3376428491230612), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.704405820024185, -0.24279488312757858), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.55494217175954, -0.16692537029320365), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.420040147662014, -0.10832215707812454), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.30151010318639, -0.0650624499034016), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.200938172182195, -0.03503632062070827), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.119667078681967, -0.01597247419241532), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.058779893613323, -0.005465967083412071), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.019086932781654, -0.0010075412835199304), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.001115954499138, -1.4219350464667047e-5), nothing)], nothing, nothing)

Now, let's make the LinearRing into a Polygon.

julia
polygon1 = GI.Polygon([ring1]);
GeoInterface.Wrappers.Polygon{false, false, Vector{GeoInterface.Wrappers.LinearRing{false, false, Vector{GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}}, Nothing, Nothing}}, Nothing, Nothing}(GeoInterface.Wrappers.LinearRing{false, false, Vector{GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}}, Nothing, Nothing}[GeoInterface.Wrappers.LinearRing{false, false, Vector{GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}}, Nothing, Nothing}(GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}[GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.0, 0.0), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.010987813253244, 0.0004397316773170068), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.043805248003498, 0.0035114210915891397), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.098016055420953, 0.011814947665167774), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.172899020101585, 0.027886421973952302), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.267456684570245, 0.05416726609360478), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.380427415579764, 0.09297443860091348), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.51030066635026, 0.1464721641710074), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.655335250260467, 0.21664550952386064), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.813580405100698, 0.30527612515520186), nothing)  …  GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.866418416586406, -0.3376428491230612), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.704405820024185, -0.24279488312757858), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.55494217175954, -0.16692537029320365), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.420040147662014, -0.10832215707812454), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.30151010318639, -0.0650624499034016), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.200938172182195, -0.03503632062070827), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.119667078681967, -0.01597247419241532), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.058779893613323, -0.005465967083412071), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.019086932781654, -0.0010075412835199304), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.001115954499138, -1.4219350464667047e-5), nothing)], nothing, nothing)], nothing, nothing)

Now, we can use GeometryOps and CoordinateTransformations to shift polygon1 up, to avoid plotting over our earlier results. This is done through the GeometryOps.transform function.

julia
xoffset = 0.;
+yoffset = 50.;
+f = CoordinateTransformations.Translation(xoffset, yoffset);
+polygon1 = GO.transform(f, polygon1);
+plot!(polygon1)
+fig

Polygons can contain "holes". The first LinearRing in a polygon is the exterior, and all subsequent LinearRings are treated as holes in the leading LinearRing.

GeoInterface offers the GI.getexterior(poly) and GI.gethole(poly) methods to get the exterior ring and an iterable of holes, respectively.

julia
hole = GI.LinearRing(GI.getpoint(multipoint))
+polygon2 = GI.Polygon([ring1, hole])
GeoInterface.Wrappers.Polygon{false, false, Vector{GeoInterface.Wrappers.LinearRing{false, false, T, Nothing, Nothing} where T}, Nothing, Nothing}(GeoInterface.Wrappers.LinearRing{false, false, T, Nothing, Nothing} where T[GeoInterface.Wrappers.LinearRing{false, false, Vector{GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}}, Nothing, Nothing}(GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}[GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.0, 0.0), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.010987813253244, 0.0004397316773170068), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.043805248003498, 0.0035114210915891397), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.098016055420953, 0.011814947665167774), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.172899020101585, 0.027886421973952302), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.267456684570245, 0.05416726609360478), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.380427415579764, 0.09297443860091348), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.51030066635026, 0.1464721641710074), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.655335250260467, 0.21664550952386064), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.813580405100698, 0.30527612515520186), nothing)  …  GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.866418416586406, -0.3376428491230612), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.704405820024185, -0.24279488312757858), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.55494217175954, -0.16692537029320365), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.420040147662014, -0.10832215707812454), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.30151010318639, -0.0650624499034016), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.200938172182195, -0.03503632062070827), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.119667078681967, -0.01597247419241532), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.058779893613323, -0.005465967083412071), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.019086932781654, -0.0010075412835199304), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.001115954499138, -1.4219350464667047e-5), nothing)], nothing, nothing), GeoInterface.Wrappers.LinearRing{false, false, Vector{GeoInterface.Wrappers.Point{false, false, Tuple{Int64, Int64}, Nothing}}, Nothing, Nothing}(GeoInterface.Wrappers.Point{false, false, Tuple{Int64, Int64}, Nothing}[GeoInterface.Wrappers.Point{false, false, Tuple{Int64, Int64}, Nothing}((-5, -5), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Int64, Int64}, Nothing}((-5, 5), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Int64, Int64}, Nothing}((5, 5), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Int64, Int64}, Nothing}((5, -5), nothing)], nothing, nothing)], nothing, nothing)

Shift polygon2 to the right, to avoid plotting over our earlier results.

julia
xoffset = 50.;
+yoffset = 0.;
+f = CoordinateTransformations.Translation(xoffset, yoffset);
+polygon2 = GO.transform(f, polygon2);
+plot!(polygon2)
+fig

Polygons can also be grouped together as a MultiPolygon.

julia
r = 5;
+x = cos.(reverse(ϴ)) .* r .+ xoffset;
+y = sin.(reverse(ϴ)) .* r .+ yoffset;
+ring2 =  GI.LinearRing(GI.Point.(zip(x,y)));
+polygon3 = GI.Polygon([ring2]);
+multipolygon = GI.MultiPolygon([polygon2, polygon3])
GeoInterface.Wrappers.MultiPolygon{false, false, Vector{GeoInterface.Wrappers.Polygon{false, false, _A, Nothing, Nothing} where _A}, Nothing, Nothing}(GeoInterface.Wrappers.Polygon{false, false, _A, Nothing, Nothing} where _A[GeoInterface.Wrappers.Polygon{false, false, Vector{GeoInterface.Wrappers.LinearRing{false, false, Vector{StaticArraysCore.SVector{2, Float64}}, Nothing, Nothing}}, Nothing, Nothing}(GeoInterface.Wrappers.LinearRing{false, false, Vector{StaticArraysCore.SVector{2, Float64}}, Nothing, Nothing}[GeoInterface.Wrappers.LinearRing{false, false, Vector{StaticArraysCore.SVector{2, Float64}}, Nothing, Nothing}(StaticArraysCore.SVector{2, Float64}[[70.0, 0.0], [70.01098781325325, 0.0004397316773170068], [70.0438052480035, 0.0035114210915891397], [70.09801605542096, 0.011814947665167774], [70.17289902010158, 0.027886421973952302], [70.26745668457025, 0.05416726609360478], [70.38042741557976, 0.09297443860091348], [70.51030066635026, 0.1464721641710074], [70.65533525026046, 0.21664550952386064], [70.8135804051007, 0.30527612515520186]  …  [70.86641841658641, -0.3376428491230612], [70.70440582002419, -0.24279488312757858], [70.55494217175954, -0.16692537029320365], [70.42004014766201, -0.10832215707812454], [70.30151010318639, -0.0650624499034016], [70.20093817218219, -0.03503632062070827], [70.11966707868197, -0.01597247419241532], [70.05877989361332, -0.005465967083412071], [70.01908693278165, -0.0010075412835199304], [70.00111595449914, -1.4219350464667047e-5]], nothing, nothing), GeoInterface.Wrappers.LinearRing{false, false, Vector{StaticArraysCore.SVector{2, Float64}}, Nothing, Nothing}(StaticArraysCore.SVector{2, Float64}[[45.0, -5.0], [45.0, 5.0], [55.0, 5.0], [55.0, -5.0]], nothing, nothing)], nothing, nothing), GeoInterface.Wrappers.Polygon{false, false, Vector{GeoInterface.Wrappers.LinearRing{false, false, Vector{GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}}, Nothing, Nothing}}, Nothing, Nothing}(GeoInterface.Wrappers.LinearRing{false, false, Vector{GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}}, Nothing, Nothing}[GeoInterface.Wrappers.LinearRing{false, false, Vector{GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}}, Nothing, Nothing}(GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}[GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((54.999974634566875, -0.01592650896568995), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((54.999565375483215, -0.06592462566760626), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((54.99865616402829, -0.11591614996189725), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((54.997247091122496, -0.16589608273778408), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((54.99533829767195, -0.2158594260436434), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((54.99292997455441, -0.2658011835867806), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((54.990022362600165, -0.31571636123306385), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((54.98661575256801, -0.3655999675063154), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((54.98271048511609, -0.41544701408748197), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((54.9783069507679, -0.46525251631344455), nothing)  …  GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((54.97976366505997, 0.4493927459900552), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((54.9840085315131, 0.3995734698458635), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((54.9877550012664, 0.3497142366876638), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((54.991002699676024, 0.299820032397223), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((54.99375130197483, 0.24989584635339165), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((54.99600053330489, 0.1999466709331708), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((54.997750168744936, 0.1499775010124783), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((54.99900003333289, 0.0999933334666654), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((54.999750002083324, 0.049999166670833324), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((55.0, 0.0), nothing)], nothing, nothing)], nothing, nothing)], nothing, nothing)

Shift multipolygon up, to avoid plotting over our earlier results.

julia
xoffset = 0.;
+yoffset = 50.;
+f = CoordinateTransformations.Translation(xoffset, yoffset);
+multipolygon = GO.transform(f, multipolygon);
+plot!(multipolygon)
+fig

Great, now we can make Points, MultiPoints, Lines, LineStrings, Polygons (with holes), and MultiPolygons and modify them using [CoordinateTransformations] and [GeometryOps].

Plot geometries on a map using GeoMakie and coordinate reference system (CRS)

In geospatial sciences we often have data in one Coordinate Reference System (CRS) (source) and would like to display it in different (destination) CRS. GeoMakie allows us to do this by automatically projecting from source to destination CRS.

Here, our source CRS is common geographic (i.e. coordinates of latitude and longitude), WGS84.

julia
source_crs1 = GFT.EPSG(4326)
GeoFormatTypes.EPSG{1}((4326,))

Now let's pick a destination CRS for displaying our map. Here we'll pick natearth2.

julia
destination_crs = "+proj=natearth2"
"+proj=natearth2"

Let's add land area for context. First, download and open the Natural Earth global land polygons at 110 m resolution.GeoMakie ships with this particular dataset, so we will access it from there.

julia
land_path = GeoMakie.assetpath("ne_110m_land.geojson")
"/home/runner/.julia/packages/GeoMakie/t8Vkb/assets/ne_110m_land.geojson"

Note

Natural Earth has lots of other datasets, and there is a Julia package that provides an interface to it called NaturalEarth.jl.

Read the land MultiPolygons as a GeoJSON.FeatureCollection.

julia
land_geo = GeoJSON.read(land_path)
FeatureCollection with 127 Features

We then need to create a figure with a GeoAxis that can handle the projection between source and destination CRS. For GeoMakie, source is the CRS of the input and dest is the CRS you want to visualize in.

julia
fig = Figure(size=(1000, 500));
+ga = GeoAxis(
+    fig[1, 1];
+    source = source_crs1,
+    dest = destination_crs,
+    xticklabelsvisible = false,
+    yticklabelsvisible = false,
+);

Plot land for context.

julia
poly!(ga, land_geo, color=:black)
+fig

Now let's plot a Polygon like before, but this time with a CRS that differs from our source data

julia
plot!(multipolygon; color = :green)
+fig

But what if we want to plot geometries with a different source CRS on the same figure?

To show how to do this let's create a geometry with coordinates in UTM (Universal Transverse Mercator) zone 10N EPSG:32610.

julia
source_crs2 = GFT.EPSG(32610)
GeoFormatTypes.EPSG{1}((32610,))

Create a polygon (we're working in meters now, not latitude and longitude)

julia
r = 1000000;
+ϴ = 0:0.01:2pi;
+x = r .* cos.(ϴ).^3 .+ 500000;
+y = r .* sin.(ϴ) .^ 3 .+5000000;
629-element Vector{Float64}:
+ 5.0e6
+ 5.0e6
+ 5.00001e6
+
+ 5.0e6
+ 5.0e6

Now create a LinearRing from Points

julia
ring3 = GI.LinearRing(Point.(zip(x, y)))
GeoInterface.Wrappers.LinearRing{false, false, Vector{Point{2, Float64}}, Nothing, Nothing}(Point{2, Float64}[[1.5e6, 5.0e6], [1.4998500087497458e6, 5.000000999950001e6], [1.4994001399837343e6, 5.000007998400139e6], [1.4986507085647392e6, 5.000026987852369e6], [1.4976022389592e6, 5.000063948817746e6], [1.4962554647802354e6, 5.000124843834609e6], [1.4946113281484335e6, 5.000215611503127e6], [1.4926709788709967e6, 5.000342160541625e6], [1.4904357734399722e6, 5.000510363870095e6], [1.4879072738504685e6, 5.0007260527263e6]  …  [1.4870405593989636e6, 4.999194331880103e6], [1.4896621210021754e6, 4.999426363321033e6], [1.491990928929295e6, 4.999609061508909e6], [1.4940253560034204e6, 4.999748243174828e6], [1.4957639801366436e6, 4.999849768598615e6], [1.497205585568957e6, 4.999919535736425e6], [1.4983491639274692e6, 4.999963474314044e6], [1.4991939151049731e6, 4.999987539891298e6], [1.4997392479570867e6, 4.999997707902938e6], [1.499984780817334e6, 4.999999967681458e6]], nothing, nothing)

Now create a Polygon from the LineRing

julia
polygon3 = GI.Polygon([ring3])
GeoInterface.Wrappers.Polygon{false, false, Vector{GeoInterface.Wrappers.LinearRing{false, false, Vector{Point{2, Float64}}, Nothing, Nothing}}, Nothing, Nothing}(GeoInterface.Wrappers.LinearRing{false, false, Vector{Point{2, Float64}}, Nothing, Nothing}[GeoInterface.Wrappers.LinearRing{false, false, Vector{Point{2, Float64}}, Nothing, Nothing}(Point{2, Float64}[[1.5e6, 5.0e6], [1.4998500087497458e6, 5.000000999950001e6], [1.4994001399837343e6, 5.000007998400139e6], [1.4986507085647392e6, 5.000026987852369e6], [1.4976022389592e6, 5.000063948817746e6], [1.4962554647802354e6, 5.000124843834609e6], [1.4946113281484335e6, 5.000215611503127e6], [1.4926709788709967e6, 5.000342160541625e6], [1.4904357734399722e6, 5.000510363870095e6], [1.4879072738504685e6, 5.0007260527263e6]  …  [1.4870405593989636e6, 4.999194331880103e6], [1.4896621210021754e6, 4.999426363321033e6], [1.491990928929295e6, 4.999609061508909e6], [1.4940253560034204e6, 4.999748243174828e6], [1.4957639801366436e6, 4.999849768598615e6], [1.497205585568957e6, 4.999919535736425e6], [1.4983491639274692e6, 4.999963474314044e6], [1.4991939151049731e6, 4.999987539891298e6], [1.4997392479570867e6, 4.999997707902938e6], [1.499984780817334e6, 4.999999967681458e6]], nothing, nothing)], nothing, nothing)

Now plot on the existing GeoAxis.

Note

The keyword argument source is used to specify the source CRS of that particular plot, when plotting on an existing GeoAxis.

julia
plot!(ga,polygon3; color=:red, source = source_crs2)
+fig

Create geospatial geometries with embedded coordinate reference system information

Great, we can make geometries and plot them on a map... now let's export the data to common geospatial data formats. To do this we now need to create geometries with embedded CRS information, making it a geospatial geometry. All that's needed is to include ; crs = crs as a keyword argument when constructing the geometry.

Let's do this for a new Polygon

julia
r = 3;
+k = 7;
+ϴ = 0:0.01:2pi;
+x = r .* (k + 1) .* cos.(ϴ) .- r .* cos.((k + 1) .* ϴ);
+y = r .* (k + 1) .* sin.(ϴ) .- r .* sin.((k + 1) .* ϴ);
+ring4 = GI.LinearRing(Point.(zip(x, y)))
GeoInterface.Wrappers.LinearRing{false, false, Vector{Point{2, Float64}}, Nothing, Nothing}(Point{2, Float64}[[21.0, 0.0], [21.00839489109211, 0.00025191811248184703], [21.033518309870985, 0.0020133807972559925], [21.075186885419612, 0.006784125578492062], [21.13309630561615, 0.016044338630866517], [21.206823267470536, 0.031245035570328428], [21.29582819010705, 0.053798628882221644], [21.39945867303846, 0.08506974233813636], [21.516953677609987, 0.12636633117296836], [21.64744840486518, 0.17893116483784577]  …  [21.69159119078359, -0.19823293781563178], [21.557153362189904, -0.14182952335952814], [21.43541888381864, -0.09707519809793252], [21.327284472232776, -0.06274967861547665], [21.233544778745394, -0.03756486776283019], [21.15488729606723, -0.020173244847778715], [21.091887951911644, -0.0091766360295773], [21.045007417743918, -0.0031353088009582475], [21.01458815628695, -0.0005773323690041465], [21.00085222666982, -8.14404531208901e-6]], nothing, nothing)

But this time when we create the Polygon we need to specify the CRS at the time of creation, making it a geospatial polygon

julia
geopoly1 = GI.Polygon([ring4], crs = source_crs1)
GeoInterface.Wrappers.Polygon{false, false, Vector{GeoInterface.Wrappers.LinearRing{false, false, Vector{Point{2, Float64}}, Nothing, Nothing}}, Nothing, GeoFormatTypes.EPSG{1}}(GeoInterface.Wrappers.LinearRing{false, false, Vector{Point{2, Float64}}, Nothing, Nothing}[GeoInterface.Wrappers.LinearRing{false, false, Vector{Point{2, Float64}}, Nothing, Nothing}(Point{2, Float64}[[21.0, 0.0], [21.00839489109211, 0.00025191811248184703], [21.033518309870985, 0.0020133807972559925], [21.075186885419612, 0.006784125578492062], [21.13309630561615, 0.016044338630866517], [21.206823267470536, 0.031245035570328428], [21.29582819010705, 0.053798628882221644], [21.39945867303846, 0.08506974233813636], [21.516953677609987, 0.12636633117296836], [21.64744840486518, 0.17893116483784577]  …  [21.69159119078359, -0.19823293781563178], [21.557153362189904, -0.14182952335952814], [21.43541888381864, -0.09707519809793252], [21.327284472232776, -0.06274967861547665], [21.233544778745394, -0.03756486776283019], [21.15488729606723, -0.020173244847778715], [21.091887951911644, -0.0091766360295773], [21.045007417743918, -0.0031353088009582475], [21.01458815628695, -0.0005773323690041465], [21.00085222666982, -8.14404531208901e-6]], nothing, nothing)], nothing, GeoFormatTypes.EPSG{1}((4326,)))

Note

It is good practice to only include CRS information with the highest-level geometry. Not doing so can bloat the memory footprint of the geometry. CRS information can be included at the individual Point level but is discouraged.

And let's create second Polygon by shifting the first using CoordinateTransformations

julia
xoffset = 20.;
+yoffset = -25.;
+f = CoordinateTransformations.Translation(xoffset, yoffset);
+geopoly2 = GO.transform(f, geopoly1);
GeoInterface.Wrappers.Polygon{false, false, Vector{GeoInterface.Wrappers.LinearRing{false, false, Vector{StaticArraysCore.SVector{2, Float64}}, Nothing, GeoFormatTypes.EPSG{1}}}, Nothing, GeoFormatTypes.EPSG{1}}(GeoInterface.Wrappers.LinearRing{false, false, Vector{StaticArraysCore.SVector{2, Float64}}, Nothing, GeoFormatTypes.EPSG{1}}[GeoInterface.Wrappers.LinearRing{false, false, Vector{StaticArraysCore.SVector{2, Float64}}, Nothing, GeoFormatTypes.EPSG{1}}(StaticArraysCore.SVector{2, Float64}[[41.0, -25.0], [41.00839489109211, -24.999748081887518], [41.033518309870985, -24.997986619202745], [41.07518688541961, -24.99321587442151], [41.13309630561615, -24.983955661369134], [41.20682326747054, -24.96875496442967], [41.295828190107045, -24.946201371117777], [41.39945867303846, -24.914930257661865], [41.51695367760999, -24.873633668827033], [41.64744840486518, -24.821068835162155]  …  [41.69159119078359, -25.198232937815632], [41.55715336218991, -25.14182952335953], [41.43541888381864, -25.097075198097933], [41.327284472232776, -25.062749678615475], [41.2335447787454, -25.037564867762832], [41.15488729606723, -25.02017324484778], [41.091887951911644, -25.009176636029576], [41.04500741774392, -25.003135308800957], [41.01458815628695, -25.000577332369005], [41.00085222666982, -25.000008144045314]], nothing, GeoFormatTypes.EPSG{1}((4326,)))], nothing, GeoFormatTypes.EPSG{1}((4326,)))

Creating a table with attributes and geometry

Typically, you'll also want to include attributes with your geometries. Attributes are simply data that are attributed to each geometry. The easiest way to do this is to create a table with a :geometry column. Let's do this using DataFrames.

julia
using DataFrames
+df = DataFrame(geometry=[geopoly1, geopoly2])

Now let's add a couple of attributes to the geometries. We do this using DataFrames' ! mutation syntax that allows you to add a new column to an existing data frame.

julia
df[!,:id] = ["a", "b"]
+df[!, :name] = ["polygon 1", "polygon 2"]
+df

Saving your geospatial data

There are Julia packages for most commonly used geographic data formats. Below, we show how to export that data to each of these.

We begin with GeoJSON, which is a JSON format for geospatial feature collections. It's human-readable and widely supported by most web-based and desktop geospatial libraries.

julia
import GeoJSON
+fn = "shapes.json"
+GeoJSON.write(fn, df)
"shapes.json"

Now, let's save as a Shapefile. Shapefiles are actually a set of files (usually 4) that hold geometry information, a CRS, and additional attribute information as a separate table. When you give Shapefile.write a file name, it will write 4 files of the same name but with different extensions.

julia
import Shapefile
+fn = "shapes.shp"
+Shapefile.write(fn, df)
20340

Now, let's save as a GeoParquet. GeoParquet is a geospatial extension to the Parquet format, which is a high-performance data store. It's great for storing large amounts of data in a single file.

julia
import GeoParquet
+fn = "shapes.parquet"
+GeoParquet.write(fn, df, (:geometry,))
"shapes.parquet"

Finally, if there's no Julia-native package that can write data to your desired format (e.g. .gpkg, .gml, etc), you can use GeoDataFrames. This package uses the GDAL library under the hood which supports writing to nearly all geospatial formats.

julia
import GeoDataFrames
+fn = "shapes.gpkg"
+GeoDataFrames.write(fn, df)
"shapes.gpkg"

And there we go, you can now create mapped geometries from scratch, manipulate them, plot them on a map, and save them in multiple geospatial data formats.

`,120)]))}const A=i(y,[["render",F]]);export{G as __pageData,A as default}; diff --git a/previews/PR237/assets/tutorials_creating_geometry.md.kdUBQRWQ.lean.js b/previews/PR237/assets/tutorials_creating_geometry.md.kdUBQRWQ.lean.js new file mode 100644 index 000000000..5c60dbb2b --- /dev/null +++ b/previews/PR237/assets/tutorials_creating_geometry.md.kdUBQRWQ.lean.js @@ -0,0 +1,89 @@ +import{_ as i,c as a,a5 as e,o as t}from"./chunks/framework.Cq8AuEls.js";const n="/GeometryOps.jl/previews/PR237/assets/fhnaafw.Dz86q2IX.png",l="/GeometryOps.jl/previews/PR237/assets/kpqpxvx.Cx40vhB3.png",p="/GeometryOps.jl/previews/PR237/assets/aecehxl.0OJvb21A.png",h="/GeometryOps.jl/previews/PR237/assets/dxmotlj.DaovVbE6.png",o="/GeometryOps.jl/previews/PR237/assets/vhavubn.rOsRk89v.png",k="/GeometryOps.jl/previews/PR237/assets/vfshmbk.4wfjCtJV.png",r="/GeometryOps.jl/previews/PR237/assets/rukbfux.3sfpQl2i.png",g="/GeometryOps.jl/previews/PR237/assets/brxrvlc.Dab1-ETk.png",d="/GeometryOps.jl/previews/PR237/assets/yinaqkl.D9AE7i2o.png",E="/GeometryOps.jl/previews/PR237/assets/ownkpce.DTKLkKh_.png",c="/GeometryOps.jl/previews/PR237/assets/ujdqybe.0f3Lq4Lw.png",G=JSON.parse('{"title":"Creating Geometry","description":"","frontmatter":{},"headers":[],"relativePath":"tutorials/creating_geometry.md","filePath":"tutorials/creating_geometry.md","lastUpdated":null}'),y={name:"tutorials/creating_geometry.md"};function F(u,s,f,C,m,b){return t(),a("div",null,s[0]||(s[0]=[e(`

Creating Geometry

In this tutorial, we're going to:

  1. Create and plot geometries

  2. Plot geometries on a map using GeoMakie and coordinate reference system (CRS)

  3. Create geospatial geometries with embedded coordinate reference system information

  4. Assign attributes to geospatial geometries

  5. Save geospatial geometries to common geospatial file formats

First, we load some required packages.

julia
# Geospatial packages from Julia
+import GeoInterface as GI
+import GeometryOps as GO
+import GeoFormatTypes as GFT
+using GeoJSON # to load some data
+# Packages for coordinate transformation and projection
+import CoordinateTransformations
+import Proj
+# Plotting
+using CairoMakie
+using GeoMakie

Creating and plotting geometries

Let's start by making a single Point.

julia
point = GI.Point(0, 0)
GeoInterface.Wrappers.Point{false, false, Tuple{Int64, Int64}, Nothing}((0, 0), nothing)

Now, let's plot our point.

julia
fig, ax, plt = plot(point)

Let's create a set of points, and have a bit more fun with plotting.

julia
x = [-5, 0, 5, 0];
+y = [0, -5, 0, 5];
+points = GI.Point.(zip(x,y));
+plot!(ax, points; marker = '✈', markersize = 30)
+fig

Points can be combined into a single MultiPoint geometry.

julia
x = [-5, -5, 5, 5];
+y = [-5, 5, 5, -5];
+multipoint = GI.MultiPoint(GI.Point.(zip(x, y)));
+plot!(ax, multipoint; marker = '☁', markersize = 30)
+fig

Let's create a LineString connecting two points.

julia
p1 = GI.Point.(-5, 0);
+p2 = GI.Point.(5, 0);
+line = GI.LineString([p1,p2])
+plot!(ax, line; color = :red)
+fig

Now, let's create a line connecting multiple points (i.e. a LineString). This time we get a bit more fancy with point creation.

julia
r = 2;
+k = 10;
+ϴ = 0:0.01:2pi;
+x = r .* (k + 1) .* cos.(ϴ) .- r .* cos.((k + 1) .* ϴ);
+y = r .* (k + 1) .* sin.(ϴ) .- r .* sin.((k + 1) .* ϴ);
+lines = GI.LineString(GI.Point.(zip(x,y)));
+plot!(ax, lines; linewidth = 5)
+fig

We can also create a single LinearRing trait, the building block of a polygon. A LinearRing is simply a LineString with the same beginning and endpoint, i.e., an arbitrary closed shape composed of point pairs.

A LinearRing is composed of a series of points.

julia
ring1 = GI.LinearRing(GI.getpoint(lines));
GeoInterface.Wrappers.LinearRing{false, false, Vector{GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}}, Nothing, Nothing}(GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}[GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.0, 0.0), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.010987813253244, 0.0004397316773170068), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.043805248003498, 0.0035114210915891397), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.098016055420953, 0.011814947665167774), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.172899020101585, 0.027886421973952302), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.267456684570245, 0.05416726609360478), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.380427415579764, 0.09297443860091348), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.51030066635026, 0.1464721641710074), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.655335250260467, 0.21664550952386064), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.813580405100698, 0.30527612515520186), nothing)  …  GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.866418416586406, -0.3376428491230612), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.704405820024185, -0.24279488312757858), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.55494217175954, -0.16692537029320365), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.420040147662014, -0.10832215707812454), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.30151010318639, -0.0650624499034016), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.200938172182195, -0.03503632062070827), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.119667078681967, -0.01597247419241532), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.058779893613323, -0.005465967083412071), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.019086932781654, -0.0010075412835199304), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.001115954499138, -1.4219350464667047e-5), nothing)], nothing, nothing)

Now, let's make the LinearRing into a Polygon.

julia
polygon1 = GI.Polygon([ring1]);
GeoInterface.Wrappers.Polygon{false, false, Vector{GeoInterface.Wrappers.LinearRing{false, false, Vector{GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}}, Nothing, Nothing}}, Nothing, Nothing}(GeoInterface.Wrappers.LinearRing{false, false, Vector{GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}}, Nothing, Nothing}[GeoInterface.Wrappers.LinearRing{false, false, Vector{GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}}, Nothing, Nothing}(GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}[GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.0, 0.0), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.010987813253244, 0.0004397316773170068), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.043805248003498, 0.0035114210915891397), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.098016055420953, 0.011814947665167774), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.172899020101585, 0.027886421973952302), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.267456684570245, 0.05416726609360478), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.380427415579764, 0.09297443860091348), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.51030066635026, 0.1464721641710074), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.655335250260467, 0.21664550952386064), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.813580405100698, 0.30527612515520186), nothing)  …  GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.866418416586406, -0.3376428491230612), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.704405820024185, -0.24279488312757858), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.55494217175954, -0.16692537029320365), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.420040147662014, -0.10832215707812454), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.30151010318639, -0.0650624499034016), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.200938172182195, -0.03503632062070827), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.119667078681967, -0.01597247419241532), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.058779893613323, -0.005465967083412071), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.019086932781654, -0.0010075412835199304), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.001115954499138, -1.4219350464667047e-5), nothing)], nothing, nothing)], nothing, nothing)

Now, we can use GeometryOps and CoordinateTransformations to shift polygon1 up, to avoid plotting over our earlier results. This is done through the GeometryOps.transform function.

julia
xoffset = 0.;
+yoffset = 50.;
+f = CoordinateTransformations.Translation(xoffset, yoffset);
+polygon1 = GO.transform(f, polygon1);
+plot!(polygon1)
+fig

Polygons can contain "holes". The first LinearRing in a polygon is the exterior, and all subsequent LinearRings are treated as holes in the leading LinearRing.

GeoInterface offers the GI.getexterior(poly) and GI.gethole(poly) methods to get the exterior ring and an iterable of holes, respectively.

julia
hole = GI.LinearRing(GI.getpoint(multipoint))
+polygon2 = GI.Polygon([ring1, hole])
GeoInterface.Wrappers.Polygon{false, false, Vector{GeoInterface.Wrappers.LinearRing{false, false, T, Nothing, Nothing} where T}, Nothing, Nothing}(GeoInterface.Wrappers.LinearRing{false, false, T, Nothing, Nothing} where T[GeoInterface.Wrappers.LinearRing{false, false, Vector{GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}}, Nothing, Nothing}(GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}[GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.0, 0.0), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.010987813253244, 0.0004397316773170068), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.043805248003498, 0.0035114210915891397), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.098016055420953, 0.011814947665167774), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.172899020101585, 0.027886421973952302), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.267456684570245, 0.05416726609360478), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.380427415579764, 0.09297443860091348), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.51030066635026, 0.1464721641710074), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.655335250260467, 0.21664550952386064), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.813580405100698, 0.30527612515520186), nothing)  …  GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.866418416586406, -0.3376428491230612), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.704405820024185, -0.24279488312757858), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.55494217175954, -0.16692537029320365), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.420040147662014, -0.10832215707812454), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.30151010318639, -0.0650624499034016), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.200938172182195, -0.03503632062070827), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.119667078681967, -0.01597247419241532), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.058779893613323, -0.005465967083412071), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.019086932781654, -0.0010075412835199304), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.001115954499138, -1.4219350464667047e-5), nothing)], nothing, nothing), GeoInterface.Wrappers.LinearRing{false, false, Vector{GeoInterface.Wrappers.Point{false, false, Tuple{Int64, Int64}, Nothing}}, Nothing, Nothing}(GeoInterface.Wrappers.Point{false, false, Tuple{Int64, Int64}, Nothing}[GeoInterface.Wrappers.Point{false, false, Tuple{Int64, Int64}, Nothing}((-5, -5), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Int64, Int64}, Nothing}((-5, 5), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Int64, Int64}, Nothing}((5, 5), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Int64, Int64}, Nothing}((5, -5), nothing)], nothing, nothing)], nothing, nothing)

Shift polygon2 to the right, to avoid plotting over our earlier results.

julia
xoffset = 50.;
+yoffset = 0.;
+f = CoordinateTransformations.Translation(xoffset, yoffset);
+polygon2 = GO.transform(f, polygon2);
+plot!(polygon2)
+fig

Polygons can also be grouped together as a MultiPolygon.

julia
r = 5;
+x = cos.(reverse(ϴ)) .* r .+ xoffset;
+y = sin.(reverse(ϴ)) .* r .+ yoffset;
+ring2 =  GI.LinearRing(GI.Point.(zip(x,y)));
+polygon3 = GI.Polygon([ring2]);
+multipolygon = GI.MultiPolygon([polygon2, polygon3])
GeoInterface.Wrappers.MultiPolygon{false, false, Vector{GeoInterface.Wrappers.Polygon{false, false, _A, Nothing, Nothing} where _A}, Nothing, Nothing}(GeoInterface.Wrappers.Polygon{false, false, _A, Nothing, Nothing} where _A[GeoInterface.Wrappers.Polygon{false, false, Vector{GeoInterface.Wrappers.LinearRing{false, false, Vector{StaticArraysCore.SVector{2, Float64}}, Nothing, Nothing}}, Nothing, Nothing}(GeoInterface.Wrappers.LinearRing{false, false, Vector{StaticArraysCore.SVector{2, Float64}}, Nothing, Nothing}[GeoInterface.Wrappers.LinearRing{false, false, Vector{StaticArraysCore.SVector{2, Float64}}, Nothing, Nothing}(StaticArraysCore.SVector{2, Float64}[[70.0, 0.0], [70.01098781325325, 0.0004397316773170068], [70.0438052480035, 0.0035114210915891397], [70.09801605542096, 0.011814947665167774], [70.17289902010158, 0.027886421973952302], [70.26745668457025, 0.05416726609360478], [70.38042741557976, 0.09297443860091348], [70.51030066635026, 0.1464721641710074], [70.65533525026046, 0.21664550952386064], [70.8135804051007, 0.30527612515520186]  …  [70.86641841658641, -0.3376428491230612], [70.70440582002419, -0.24279488312757858], [70.55494217175954, -0.16692537029320365], [70.42004014766201, -0.10832215707812454], [70.30151010318639, -0.0650624499034016], [70.20093817218219, -0.03503632062070827], [70.11966707868197, -0.01597247419241532], [70.05877989361332, -0.005465967083412071], [70.01908693278165, -0.0010075412835199304], [70.00111595449914, -1.4219350464667047e-5]], nothing, nothing), GeoInterface.Wrappers.LinearRing{false, false, Vector{StaticArraysCore.SVector{2, Float64}}, Nothing, Nothing}(StaticArraysCore.SVector{2, Float64}[[45.0, -5.0], [45.0, 5.0], [55.0, 5.0], [55.0, -5.0]], nothing, nothing)], nothing, nothing), GeoInterface.Wrappers.Polygon{false, false, Vector{GeoInterface.Wrappers.LinearRing{false, false, Vector{GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}}, Nothing, Nothing}}, Nothing, Nothing}(GeoInterface.Wrappers.LinearRing{false, false, Vector{GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}}, Nothing, Nothing}[GeoInterface.Wrappers.LinearRing{false, false, Vector{GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}}, Nothing, Nothing}(GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}[GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((54.999974634566875, -0.01592650896568995), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((54.999565375483215, -0.06592462566760626), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((54.99865616402829, -0.11591614996189725), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((54.997247091122496, -0.16589608273778408), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((54.99533829767195, -0.2158594260436434), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((54.99292997455441, -0.2658011835867806), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((54.990022362600165, -0.31571636123306385), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((54.98661575256801, -0.3655999675063154), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((54.98271048511609, -0.41544701408748197), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((54.9783069507679, -0.46525251631344455), nothing)  …  GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((54.97976366505997, 0.4493927459900552), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((54.9840085315131, 0.3995734698458635), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((54.9877550012664, 0.3497142366876638), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((54.991002699676024, 0.299820032397223), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((54.99375130197483, 0.24989584635339165), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((54.99600053330489, 0.1999466709331708), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((54.997750168744936, 0.1499775010124783), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((54.99900003333289, 0.0999933334666654), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((54.999750002083324, 0.049999166670833324), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((55.0, 0.0), nothing)], nothing, nothing)], nothing, nothing)], nothing, nothing)

Shift multipolygon up, to avoid plotting over our earlier results.

julia
xoffset = 0.;
+yoffset = 50.;
+f = CoordinateTransformations.Translation(xoffset, yoffset);
+multipolygon = GO.transform(f, multipolygon);
+plot!(multipolygon)
+fig

Great, now we can make Points, MultiPoints, Lines, LineStrings, Polygons (with holes), and MultiPolygons and modify them using [CoordinateTransformations] and [GeometryOps].

Plot geometries on a map using GeoMakie and coordinate reference system (CRS)

In geospatial sciences we often have data in one Coordinate Reference System (CRS) (source) and would like to display it in different (destination) CRS. GeoMakie allows us to do this by automatically projecting from source to destination CRS.

Here, our source CRS is common geographic (i.e. coordinates of latitude and longitude), WGS84.

julia
source_crs1 = GFT.EPSG(4326)
GeoFormatTypes.EPSG{1}((4326,))

Now let's pick a destination CRS for displaying our map. Here we'll pick natearth2.

julia
destination_crs = "+proj=natearth2"
"+proj=natearth2"

Let's add land area for context. First, download and open the Natural Earth global land polygons at 110 m resolution.GeoMakie ships with this particular dataset, so we will access it from there.

julia
land_path = GeoMakie.assetpath("ne_110m_land.geojson")
"/home/runner/.julia/packages/GeoMakie/t8Vkb/assets/ne_110m_land.geojson"

Note

Natural Earth has lots of other datasets, and there is a Julia package that provides an interface to it called NaturalEarth.jl.

Read the land MultiPolygons as a GeoJSON.FeatureCollection.

julia
land_geo = GeoJSON.read(land_path)
FeatureCollection with 127 Features

We then need to create a figure with a GeoAxis that can handle the projection between source and destination CRS. For GeoMakie, source is the CRS of the input and dest is the CRS you want to visualize in.

julia
fig = Figure(size=(1000, 500));
+ga = GeoAxis(
+    fig[1, 1];
+    source = source_crs1,
+    dest = destination_crs,
+    xticklabelsvisible = false,
+    yticklabelsvisible = false,
+);

Plot land for context.

julia
poly!(ga, land_geo, color=:black)
+fig

Now let's plot a Polygon like before, but this time with a CRS that differs from our source data

julia
plot!(multipolygon; color = :green)
+fig

But what if we want to plot geometries with a different source CRS on the same figure?

To show how to do this let's create a geometry with coordinates in UTM (Universal Transverse Mercator) zone 10N EPSG:32610.

julia
source_crs2 = GFT.EPSG(32610)
GeoFormatTypes.EPSG{1}((32610,))

Create a polygon (we're working in meters now, not latitude and longitude)

julia
r = 1000000;
+ϴ = 0:0.01:2pi;
+x = r .* cos.(ϴ).^3 .+ 500000;
+y = r .* sin.(ϴ) .^ 3 .+5000000;
629-element Vector{Float64}:
+ 5.0e6
+ 5.0e6
+ 5.00001e6
+
+ 5.0e6
+ 5.0e6

Now create a LinearRing from Points

julia
ring3 = GI.LinearRing(Point.(zip(x, y)))
GeoInterface.Wrappers.LinearRing{false, false, Vector{Point{2, Float64}}, Nothing, Nothing}(Point{2, Float64}[[1.5e6, 5.0e6], [1.4998500087497458e6, 5.000000999950001e6], [1.4994001399837343e6, 5.000007998400139e6], [1.4986507085647392e6, 5.000026987852369e6], [1.4976022389592e6, 5.000063948817746e6], [1.4962554647802354e6, 5.000124843834609e6], [1.4946113281484335e6, 5.000215611503127e6], [1.4926709788709967e6, 5.000342160541625e6], [1.4904357734399722e6, 5.000510363870095e6], [1.4879072738504685e6, 5.0007260527263e6]  …  [1.4870405593989636e6, 4.999194331880103e6], [1.4896621210021754e6, 4.999426363321033e6], [1.491990928929295e6, 4.999609061508909e6], [1.4940253560034204e6, 4.999748243174828e6], [1.4957639801366436e6, 4.999849768598615e6], [1.497205585568957e6, 4.999919535736425e6], [1.4983491639274692e6, 4.999963474314044e6], [1.4991939151049731e6, 4.999987539891298e6], [1.4997392479570867e6, 4.999997707902938e6], [1.499984780817334e6, 4.999999967681458e6]], nothing, nothing)

Now create a Polygon from the LineRing

julia
polygon3 = GI.Polygon([ring3])
GeoInterface.Wrappers.Polygon{false, false, Vector{GeoInterface.Wrappers.LinearRing{false, false, Vector{Point{2, Float64}}, Nothing, Nothing}}, Nothing, Nothing}(GeoInterface.Wrappers.LinearRing{false, false, Vector{Point{2, Float64}}, Nothing, Nothing}[GeoInterface.Wrappers.LinearRing{false, false, Vector{Point{2, Float64}}, Nothing, Nothing}(Point{2, Float64}[[1.5e6, 5.0e6], [1.4998500087497458e6, 5.000000999950001e6], [1.4994001399837343e6, 5.000007998400139e6], [1.4986507085647392e6, 5.000026987852369e6], [1.4976022389592e6, 5.000063948817746e6], [1.4962554647802354e6, 5.000124843834609e6], [1.4946113281484335e6, 5.000215611503127e6], [1.4926709788709967e6, 5.000342160541625e6], [1.4904357734399722e6, 5.000510363870095e6], [1.4879072738504685e6, 5.0007260527263e6]  …  [1.4870405593989636e6, 4.999194331880103e6], [1.4896621210021754e6, 4.999426363321033e6], [1.491990928929295e6, 4.999609061508909e6], [1.4940253560034204e6, 4.999748243174828e6], [1.4957639801366436e6, 4.999849768598615e6], [1.497205585568957e6, 4.999919535736425e6], [1.4983491639274692e6, 4.999963474314044e6], [1.4991939151049731e6, 4.999987539891298e6], [1.4997392479570867e6, 4.999997707902938e6], [1.499984780817334e6, 4.999999967681458e6]], nothing, nothing)], nothing, nothing)

Now plot on the existing GeoAxis.

Note

The keyword argument source is used to specify the source CRS of that particular plot, when plotting on an existing GeoAxis.

julia
plot!(ga,polygon3; color=:red, source = source_crs2)
+fig

Create geospatial geometries with embedded coordinate reference system information

Great, we can make geometries and plot them on a map... now let's export the data to common geospatial data formats. To do this we now need to create geometries with embedded CRS information, making it a geospatial geometry. All that's needed is to include ; crs = crs as a keyword argument when constructing the geometry.

Let's do this for a new Polygon

julia
r = 3;
+k = 7;
+ϴ = 0:0.01:2pi;
+x = r .* (k + 1) .* cos.(ϴ) .- r .* cos.((k + 1) .* ϴ);
+y = r .* (k + 1) .* sin.(ϴ) .- r .* sin.((k + 1) .* ϴ);
+ring4 = GI.LinearRing(Point.(zip(x, y)))
GeoInterface.Wrappers.LinearRing{false, false, Vector{Point{2, Float64}}, Nothing, Nothing}(Point{2, Float64}[[21.0, 0.0], [21.00839489109211, 0.00025191811248184703], [21.033518309870985, 0.0020133807972559925], [21.075186885419612, 0.006784125578492062], [21.13309630561615, 0.016044338630866517], [21.206823267470536, 0.031245035570328428], [21.29582819010705, 0.053798628882221644], [21.39945867303846, 0.08506974233813636], [21.516953677609987, 0.12636633117296836], [21.64744840486518, 0.17893116483784577]  …  [21.69159119078359, -0.19823293781563178], [21.557153362189904, -0.14182952335952814], [21.43541888381864, -0.09707519809793252], [21.327284472232776, -0.06274967861547665], [21.233544778745394, -0.03756486776283019], [21.15488729606723, -0.020173244847778715], [21.091887951911644, -0.0091766360295773], [21.045007417743918, -0.0031353088009582475], [21.01458815628695, -0.0005773323690041465], [21.00085222666982, -8.14404531208901e-6]], nothing, nothing)

But this time when we create the Polygon we need to specify the CRS at the time of creation, making it a geospatial polygon

julia
geopoly1 = GI.Polygon([ring4], crs = source_crs1)
GeoInterface.Wrappers.Polygon{false, false, Vector{GeoInterface.Wrappers.LinearRing{false, false, Vector{Point{2, Float64}}, Nothing, Nothing}}, Nothing, GeoFormatTypes.EPSG{1}}(GeoInterface.Wrappers.LinearRing{false, false, Vector{Point{2, Float64}}, Nothing, Nothing}[GeoInterface.Wrappers.LinearRing{false, false, Vector{Point{2, Float64}}, Nothing, Nothing}(Point{2, Float64}[[21.0, 0.0], [21.00839489109211, 0.00025191811248184703], [21.033518309870985, 0.0020133807972559925], [21.075186885419612, 0.006784125578492062], [21.13309630561615, 0.016044338630866517], [21.206823267470536, 0.031245035570328428], [21.29582819010705, 0.053798628882221644], [21.39945867303846, 0.08506974233813636], [21.516953677609987, 0.12636633117296836], [21.64744840486518, 0.17893116483784577]  …  [21.69159119078359, -0.19823293781563178], [21.557153362189904, -0.14182952335952814], [21.43541888381864, -0.09707519809793252], [21.327284472232776, -0.06274967861547665], [21.233544778745394, -0.03756486776283019], [21.15488729606723, -0.020173244847778715], [21.091887951911644, -0.0091766360295773], [21.045007417743918, -0.0031353088009582475], [21.01458815628695, -0.0005773323690041465], [21.00085222666982, -8.14404531208901e-6]], nothing, nothing)], nothing, GeoFormatTypes.EPSG{1}((4326,)))

Note

It is good practice to only include CRS information with the highest-level geometry. Not doing so can bloat the memory footprint of the geometry. CRS information can be included at the individual Point level but is discouraged.

And let's create second Polygon by shifting the first using CoordinateTransformations

julia
xoffset = 20.;
+yoffset = -25.;
+f = CoordinateTransformations.Translation(xoffset, yoffset);
+geopoly2 = GO.transform(f, geopoly1);
GeoInterface.Wrappers.Polygon{false, false, Vector{GeoInterface.Wrappers.LinearRing{false, false, Vector{StaticArraysCore.SVector{2, Float64}}, Nothing, GeoFormatTypes.EPSG{1}}}, Nothing, GeoFormatTypes.EPSG{1}}(GeoInterface.Wrappers.LinearRing{false, false, Vector{StaticArraysCore.SVector{2, Float64}}, Nothing, GeoFormatTypes.EPSG{1}}[GeoInterface.Wrappers.LinearRing{false, false, Vector{StaticArraysCore.SVector{2, Float64}}, Nothing, GeoFormatTypes.EPSG{1}}(StaticArraysCore.SVector{2, Float64}[[41.0, -25.0], [41.00839489109211, -24.999748081887518], [41.033518309870985, -24.997986619202745], [41.07518688541961, -24.99321587442151], [41.13309630561615, -24.983955661369134], [41.20682326747054, -24.96875496442967], [41.295828190107045, -24.946201371117777], [41.39945867303846, -24.914930257661865], [41.51695367760999, -24.873633668827033], [41.64744840486518, -24.821068835162155]  …  [41.69159119078359, -25.198232937815632], [41.55715336218991, -25.14182952335953], [41.43541888381864, -25.097075198097933], [41.327284472232776, -25.062749678615475], [41.2335447787454, -25.037564867762832], [41.15488729606723, -25.02017324484778], [41.091887951911644, -25.009176636029576], [41.04500741774392, -25.003135308800957], [41.01458815628695, -25.000577332369005], [41.00085222666982, -25.000008144045314]], nothing, GeoFormatTypes.EPSG{1}((4326,)))], nothing, GeoFormatTypes.EPSG{1}((4326,)))

Creating a table with attributes and geometry

Typically, you'll also want to include attributes with your geometries. Attributes are simply data that are attributed to each geometry. The easiest way to do this is to create a table with a :geometry column. Let's do this using DataFrames.

julia
using DataFrames
+df = DataFrame(geometry=[geopoly1, geopoly2])

Now let's add a couple of attributes to the geometries. We do this using DataFrames' ! mutation syntax that allows you to add a new column to an existing data frame.

julia
df[!,:id] = ["a", "b"]
+df[!, :name] = ["polygon 1", "polygon 2"]
+df

Saving your geospatial data

There are Julia packages for most commonly used geographic data formats. Below, we show how to export that data to each of these.

We begin with GeoJSON, which is a JSON format for geospatial feature collections. It's human-readable and widely supported by most web-based and desktop geospatial libraries.

julia
import GeoJSON
+fn = "shapes.json"
+GeoJSON.write(fn, df)
"shapes.json"

Now, let's save as a Shapefile. Shapefiles are actually a set of files (usually 4) that hold geometry information, a CRS, and additional attribute information as a separate table. When you give Shapefile.write a file name, it will write 4 files of the same name but with different extensions.

julia
import Shapefile
+fn = "shapes.shp"
+Shapefile.write(fn, df)
20340

Now, let's save as a GeoParquet. GeoParquet is a geospatial extension to the Parquet format, which is a high-performance data store. It's great for storing large amounts of data in a single file.

julia
import GeoParquet
+fn = "shapes.parquet"
+GeoParquet.write(fn, df, (:geometry,))
"shapes.parquet"

Finally, if there's no Julia-native package that can write data to your desired format (e.g. .gpkg, .gml, etc), you can use GeoDataFrames. This package uses the GDAL library under the hood which supports writing to nearly all geospatial formats.

julia
import GeoDataFrames
+fn = "shapes.gpkg"
+GeoDataFrames.write(fn, df)
"shapes.gpkg"

And there we go, you can now create mapped geometries from scratch, manipulate them, plot them on a map, and save them in multiple geospatial data formats.

`,120)]))}const A=i(y,[["render",F]]);export{G as __pageData,A as default}; diff --git a/previews/PR237/assets/tutorials_geodesic_paths.md.0IfaH3DB.js b/previews/PR237/assets/tutorials_geodesic_paths.md.0IfaH3DB.js new file mode 100644 index 000000000..efb707ef3 --- /dev/null +++ b/previews/PR237/assets/tutorials_geodesic_paths.md.0IfaH3DB.js @@ -0,0 +1,11 @@ +import{_ as i,c as a,a5 as n,o as h}from"./chunks/framework.Cq8AuEls.js";const t="/GeometryOps.jl/previews/PR237/assets/uyetcvi.CPClNl7F.png",o=JSON.parse('{"title":"Geodesic paths","description":"","frontmatter":{},"headers":[],"relativePath":"tutorials/geodesic_paths.md","filePath":"tutorials/geodesic_paths.md","lastUpdated":null}'),p={name:"tutorials/geodesic_paths.md"};function k(l,s,e,E,r,d){return h(),a("div",null,s[0]||(s[0]=[n(`

Geodesic paths

Geodesic paths are paths computed on an ellipsoid, as opposed to a plane.

julia
import GeometryOps as GO, GeoInterface as GI
+using CairoMakie, GeoMakie
+
+
+IAH = (-95.358421, 29.749907)
+AMS = (4.897070, 52.377956)
+
+
+fig, ga, _cp = lines(GeoMakie.coastlines(); axis = (; type = GeoAxis))
+lines!(ga, GO.segmentize(GO.GeodesicSegments(; max_distance = 100_000), GI.LineString([IAH, AMS])); color = Makie.wong_colors()[2])
+fig

',4)]))}const y=i(p,[["render",k]]);export{o as __pageData,y as default}; diff --git a/previews/PR237/assets/tutorials_geodesic_paths.md.0IfaH3DB.lean.js b/previews/PR237/assets/tutorials_geodesic_paths.md.0IfaH3DB.lean.js new file mode 100644 index 000000000..efb707ef3 --- /dev/null +++ b/previews/PR237/assets/tutorials_geodesic_paths.md.0IfaH3DB.lean.js @@ -0,0 +1,11 @@ +import{_ as i,c as a,a5 as n,o as h}from"./chunks/framework.Cq8AuEls.js";const t="/GeometryOps.jl/previews/PR237/assets/uyetcvi.CPClNl7F.png",o=JSON.parse('{"title":"Geodesic paths","description":"","frontmatter":{},"headers":[],"relativePath":"tutorials/geodesic_paths.md","filePath":"tutorials/geodesic_paths.md","lastUpdated":null}'),p={name:"tutorials/geodesic_paths.md"};function k(l,s,e,E,r,d){return h(),a("div",null,s[0]||(s[0]=[n(`

Geodesic paths

Geodesic paths are paths computed on an ellipsoid, as opposed to a plane.

julia
import GeometryOps as GO, GeoInterface as GI
+using CairoMakie, GeoMakie
+
+
+IAH = (-95.358421, 29.749907)
+AMS = (4.897070, 52.377956)
+
+
+fig, ga, _cp = lines(GeoMakie.coastlines(); axis = (; type = GeoAxis))
+lines!(ga, GO.segmentize(GO.GeodesicSegments(; max_distance = 100_000), GI.LineString([IAH, AMS])); color = Makie.wong_colors()[2])
+fig

',4)]))}const y=i(p,[["render",k]]);export{o as __pageData,y as default}; diff --git a/previews/PR237/assets/tutorials_spatial_joins.md.Bs6yD1m0.js b/previews/PR237/assets/tutorials_spatial_joins.md.Bs6yD1m0.js new file mode 100644 index 000000000..df39bfaa4 --- /dev/null +++ b/previews/PR237/assets/tutorials_spatial_joins.md.Bs6yD1m0.js @@ -0,0 +1,52 @@ +import{_ as l,c as t,j as i,a,a5 as n,o as h}from"./chunks/framework.Cq8AuEls.js";const e="/GeometryOps.jl/previews/PR237/assets/gwxtpci.3UVIT8DR.png",p="/GeometryOps.jl/previews/PR237/assets/ebapxoz.bkAEKDbV.png",k="/GeometryOps.jl/previews/PR237/assets/hjnwfgx.B8m6QFVZ.png",C=JSON.parse('{"title":"Spatial joins","description":"","frontmatter":{},"headers":[],"relativePath":"tutorials/spatial_joins.md","filePath":"tutorials/spatial_joins.md","lastUpdated":null}'),r={name:"tutorials/spatial_joins.md"},E={class:"MathJax",jax:"SVG",style:{direction:"ltr",position:"relative"}},d={style:{overflow:"visible","min-height":"1px","min-width":"1px","vertical-align":"-0.566ex"},xmlns:"http://www.w3.org/2000/svg",width:"6.307ex",height:"2.262ex",role:"img",focusable:"false",viewBox:"0 -750 2787.7 1000","aria-hidden":"true"};function o(g,s,y,F,c,u){return h(),t("div",null,[s[12]||(s[12]=i("h1",{id:"Spatial-joins",tabindex:"-1"},[a("Spatial joins "),i("a",{class:"header-anchor",href:"#Spatial-joins","aria-label":'Permalink to "Spatial joins {#Spatial-joins}"'},"​")],-1)),i("p",null,[s[2]||(s[2]=a("Spatial joins are ")),s[3]||(s[3]=i("a",{href:"https://www.geeksforgeeks.org/sql-join-set-1-inner-left-right-and-full-joins/",target:"_blank",rel:"noreferrer"},"table joins",-1)),s[4]||(s[4]=a(" which are based not on equality, but on some predicate ")),i("mjx-container",E,[(h(),t("svg",d,s[0]||(s[0]=[n('',1)]))),s[1]||(s[1]=i("mjx-assistive-mml",{unselectable:"on",display:"inline",style:{top:"0px",left:"0px",clip:"rect(1px, 1px, 1px, 1px)","-webkit-touch-callout":"none","-webkit-user-select":"none","-khtml-user-select":"none","-moz-user-select":"none","-ms-user-select":"none","user-select":"none",position:"absolute",padding:"1px 0px 0px 0px",border:"0px",display:"block",width:"auto",overflow:"hidden"}},[i("math",{xmlns:"http://www.w3.org/1998/Math/MathML"},[i("mi",null,"p"),i("mo",{stretchy:"false"},"("),i("mi",null,"x"),i("mo",null,","),i("mi",null,"y"),i("mo",{stretchy:"false"},")")])],-1))]),s[5]||(s[5]=a(", which takes two geometries, and returns a value of either ")),s[6]||(s[6]=i("code",null,"true",-1)),s[7]||(s[7]=a(" or ")),s[8]||(s[8]=i("code",null,"false",-1)),s[9]||(s[9]=a(". For geometries, the ")),s[10]||(s[10]=i("a",{href:"https://en.wikipedia.org/wiki/DE-9IM",target:"_blank",rel:"noreferrer"},[i("code",null,"DE-9IM")],-1)),s[11]||(s[11]=a(" spatial relationship model is used to determine the spatial relationship between two geometries."))]),s[13]||(s[13]=n(`

Spatial joins can be done between any geometry types (from geometrycollections to points), just as geometrical predicates can be evaluated on any geometries.

In this tutorial, we will show how to perform a spatial join on first a toy dataset and then two Natural Earth datasets, to show how this can be used in the real world.

In order to perform the spatial join, we use FlexiJoins.jl to perform the join, specifically using its by_pred joining method. This allows the user to specify a predicate in the following manner, for any kind of table join operation:

julia
using FlexiJoins
+innerjoin((table1, table1),
+    by_pred(:table1_column, predicate_function, :table2_column) # & add other conditions here
+)
+leftjoin((table1, table1),
+    by_pred(:table1_column, predicate_function, :table2_column) # & add other conditions here
+)
+rightjoin((table1, table1),
+    by_pred(:table1_column, predicate_function, :table2_column) # & add other conditions here
+)
+outerjoin((table1, table1),
+    by_pred(:table1_column, predicate_function, :table2_column) # & add other conditions here
+)

We have enabled the use of all of GeometryOps' boolean comparisons here. These are:

julia
GO.contains, GO.within, GO.intersects, GO.touches, GO.crosses, GO.disjoint, GO.overlaps, GO.covers, GO.coveredby, GO.equals

Tip

Always place the dataframe with more complex geometries second, as that is the one which will be sorted into a tree.

Simple example

This example demonstrates how to perform a spatial join between two datasets: a set of polygons and a set of randomly generated points.

The polygons are represented as a DataFrame with geometries and colors, while the points are stored in a separate DataFrame.

The spatial join is performed using the contains predicate from GeometryOps, which checks if each point is contained within any of the polygons. The resulting joined DataFrame is then used to plot the points, colored according to the containing polygon.

First, we generate our data. We create two triangle polygons which, together, span the rectangle (0, 0, 1, 1), and a set of points which are randomly distributed within this rectangle.

julia
import GeoInterface as GI, GeometryOps as GO
+using FlexiJoins, DataFrames
+
+using CairoMakie, GeoInterfaceMakie
+
+pl = GI.Polygon([GI.LinearRing([(0, 0), (1, 0), (1, 1), (0, 0)])])
+pu = GI.Polygon([GI.LinearRing([(0, 0), (0, 1), (1, 1), (0, 0)])])
+poly_df = DataFrame(geometry = [pl, pu], color = [:red, :blue])
+f, a, p = poly(poly_df.geometry; color = tuple.(poly_df.color, 0.3))

Here, the upper polygon is blue, and the lower polygon is red. Keep this in mind!

Now, we generate the points.

julia
points = tuple.(rand(1000), rand(1000))
+points_df = DataFrame(geometry = points)
+scatter!(points_df.geometry)
+f

You can see that they are evenly distributed around the box. But how do we know which points are in which polygons?

We have to join the two dataframes based on which polygon (if any) each point lies within.

Now, we can perform the "spatial join" using FlexiJoins. We are performing an outer join here

julia
@time joined_df = FlexiJoins.innerjoin(
+    (points_df, poly_df),
+    by_pred(:geometry, GO.within, :geometry)
+)
julia
scatter!(a, joined_df.geometry; color = joined_df.color)
+f

Here, you can see that the colors were assigned appropriately to the scattered points!

Real-world example

Suppose I have a list of polygons representing administrative regions (or mining sites, or what have you), and I have a list of polygons for each country. I want to find the country each region is in.

julia
import GeoInterface as GI, GeometryOps as GO
+using FlexiJoins, DataFrames, GADM # GADM gives us country and sublevel geometry
+
+using CairoMakie, GeoInterfaceMakie
+
+country_df = GADM.get.(["JPN", "USA", "IND", "DEU", "FRA"]) |> DataFrame
+country_df.geometry = GI.GeometryCollection.(GO.tuples.(country_df.geom))
+
+state_doublets = [
+    ("USA", "New York"),
+    ("USA", "California"),
+    ("IND", "Karnataka"),
+    ("DEU", "Berlin"),
+    ("FRA", "Grand Est"),
+    ("JPN", "Tokyo"),
+]
+
+state_full_df = (x -> GADM.get(x...)).(state_doublets) |> DataFrame
+state_full_df.geom = GO.tuples.(only.(state_full_df.geom))
+state_compact_df = state_full_df[:, [:geom, :NAME_1]]
julia
innerjoin((state_compact_df, country_df), by_pred(:geom, GO.within, :geometry))
+innerjoin((state_compact_df,  view(country_df, 1:1, :)), by_pred(:geom, GO.within, :geometry))

Warning

This is how you would do this, but it doesn't work yet, since the GeometryOps predicates are quite slow on large polygons. If you try this, the code will continue to run for a very, very long time (it took 12 hours on my laptop, but with minimal CPU usage).

Enabling custom predicates

In case you want to use a custom predicate, you only need to define a method to tell FlexiJoins how to use it.

For example, let's suppose you wanted to perform a spatial join on geometries which are some distance away from each other:

julia
my_predicate_function = <(5)  abs  GO.distance

You would need to define FlexiJoins.supports_mode on your predicate:

julia
FlexiJoins.supports_mode(
+    ::FlexiJoins.Mode.NestedLoopFast, 
+    ::FlexiJoins.ByPred{typeof(my_predicate_function)}, 
+    datas
+) = true

This will enable FlexiJoins to support your custom function, when it's passed to by_pred(:geometry, my_predicate_function, :geometry).

`,37))])}const b=l(r,[["render",o]]);export{C as __pageData,b as default}; diff --git a/previews/PR237/assets/tutorials_spatial_joins.md.Bs6yD1m0.lean.js b/previews/PR237/assets/tutorials_spatial_joins.md.Bs6yD1m0.lean.js new file mode 100644 index 000000000..df39bfaa4 --- /dev/null +++ b/previews/PR237/assets/tutorials_spatial_joins.md.Bs6yD1m0.lean.js @@ -0,0 +1,52 @@ +import{_ as l,c as t,j as i,a,a5 as n,o as h}from"./chunks/framework.Cq8AuEls.js";const e="/GeometryOps.jl/previews/PR237/assets/gwxtpci.3UVIT8DR.png",p="/GeometryOps.jl/previews/PR237/assets/ebapxoz.bkAEKDbV.png",k="/GeometryOps.jl/previews/PR237/assets/hjnwfgx.B8m6QFVZ.png",C=JSON.parse('{"title":"Spatial joins","description":"","frontmatter":{},"headers":[],"relativePath":"tutorials/spatial_joins.md","filePath":"tutorials/spatial_joins.md","lastUpdated":null}'),r={name:"tutorials/spatial_joins.md"},E={class:"MathJax",jax:"SVG",style:{direction:"ltr",position:"relative"}},d={style:{overflow:"visible","min-height":"1px","min-width":"1px","vertical-align":"-0.566ex"},xmlns:"http://www.w3.org/2000/svg",width:"6.307ex",height:"2.262ex",role:"img",focusable:"false",viewBox:"0 -750 2787.7 1000","aria-hidden":"true"};function o(g,s,y,F,c,u){return h(),t("div",null,[s[12]||(s[12]=i("h1",{id:"Spatial-joins",tabindex:"-1"},[a("Spatial joins "),i("a",{class:"header-anchor",href:"#Spatial-joins","aria-label":'Permalink to "Spatial joins {#Spatial-joins}"'},"​")],-1)),i("p",null,[s[2]||(s[2]=a("Spatial joins are ")),s[3]||(s[3]=i("a",{href:"https://www.geeksforgeeks.org/sql-join-set-1-inner-left-right-and-full-joins/",target:"_blank",rel:"noreferrer"},"table joins",-1)),s[4]||(s[4]=a(" which are based not on equality, but on some predicate ")),i("mjx-container",E,[(h(),t("svg",d,s[0]||(s[0]=[n('',1)]))),s[1]||(s[1]=i("mjx-assistive-mml",{unselectable:"on",display:"inline",style:{top:"0px",left:"0px",clip:"rect(1px, 1px, 1px, 1px)","-webkit-touch-callout":"none","-webkit-user-select":"none","-khtml-user-select":"none","-moz-user-select":"none","-ms-user-select":"none","user-select":"none",position:"absolute",padding:"1px 0px 0px 0px",border:"0px",display:"block",width:"auto",overflow:"hidden"}},[i("math",{xmlns:"http://www.w3.org/1998/Math/MathML"},[i("mi",null,"p"),i("mo",{stretchy:"false"},"("),i("mi",null,"x"),i("mo",null,","),i("mi",null,"y"),i("mo",{stretchy:"false"},")")])],-1))]),s[5]||(s[5]=a(", which takes two geometries, and returns a value of either ")),s[6]||(s[6]=i("code",null,"true",-1)),s[7]||(s[7]=a(" or ")),s[8]||(s[8]=i("code",null,"false",-1)),s[9]||(s[9]=a(". For geometries, the ")),s[10]||(s[10]=i("a",{href:"https://en.wikipedia.org/wiki/DE-9IM",target:"_blank",rel:"noreferrer"},[i("code",null,"DE-9IM")],-1)),s[11]||(s[11]=a(" spatial relationship model is used to determine the spatial relationship between two geometries."))]),s[13]||(s[13]=n(`

Spatial joins can be done between any geometry types (from geometrycollections to points), just as geometrical predicates can be evaluated on any geometries.

In this tutorial, we will show how to perform a spatial join on first a toy dataset and then two Natural Earth datasets, to show how this can be used in the real world.

In order to perform the spatial join, we use FlexiJoins.jl to perform the join, specifically using its by_pred joining method. This allows the user to specify a predicate in the following manner, for any kind of table join operation:

julia
using FlexiJoins
+innerjoin((table1, table1),
+    by_pred(:table1_column, predicate_function, :table2_column) # & add other conditions here
+)
+leftjoin((table1, table1),
+    by_pred(:table1_column, predicate_function, :table2_column) # & add other conditions here
+)
+rightjoin((table1, table1),
+    by_pred(:table1_column, predicate_function, :table2_column) # & add other conditions here
+)
+outerjoin((table1, table1),
+    by_pred(:table1_column, predicate_function, :table2_column) # & add other conditions here
+)

We have enabled the use of all of GeometryOps' boolean comparisons here. These are:

julia
GO.contains, GO.within, GO.intersects, GO.touches, GO.crosses, GO.disjoint, GO.overlaps, GO.covers, GO.coveredby, GO.equals

Tip

Always place the dataframe with more complex geometries second, as that is the one which will be sorted into a tree.

Simple example

This example demonstrates how to perform a spatial join between two datasets: a set of polygons and a set of randomly generated points.

The polygons are represented as a DataFrame with geometries and colors, while the points are stored in a separate DataFrame.

The spatial join is performed using the contains predicate from GeometryOps, which checks if each point is contained within any of the polygons. The resulting joined DataFrame is then used to plot the points, colored according to the containing polygon.

First, we generate our data. We create two triangle polygons which, together, span the rectangle (0, 0, 1, 1), and a set of points which are randomly distributed within this rectangle.

julia
import GeoInterface as GI, GeometryOps as GO
+using FlexiJoins, DataFrames
+
+using CairoMakie, GeoInterfaceMakie
+
+pl = GI.Polygon([GI.LinearRing([(0, 0), (1, 0), (1, 1), (0, 0)])])
+pu = GI.Polygon([GI.LinearRing([(0, 0), (0, 1), (1, 1), (0, 0)])])
+poly_df = DataFrame(geometry = [pl, pu], color = [:red, :blue])
+f, a, p = poly(poly_df.geometry; color = tuple.(poly_df.color, 0.3))

Here, the upper polygon is blue, and the lower polygon is red. Keep this in mind!

Now, we generate the points.

julia
points = tuple.(rand(1000), rand(1000))
+points_df = DataFrame(geometry = points)
+scatter!(points_df.geometry)
+f

You can see that they are evenly distributed around the box. But how do we know which points are in which polygons?

We have to join the two dataframes based on which polygon (if any) each point lies within.

Now, we can perform the "spatial join" using FlexiJoins. We are performing an outer join here

julia
@time joined_df = FlexiJoins.innerjoin(
+    (points_df, poly_df),
+    by_pred(:geometry, GO.within, :geometry)
+)
julia
scatter!(a, joined_df.geometry; color = joined_df.color)
+f

Here, you can see that the colors were assigned appropriately to the scattered points!

Real-world example

Suppose I have a list of polygons representing administrative regions (or mining sites, or what have you), and I have a list of polygons for each country. I want to find the country each region is in.

julia
import GeoInterface as GI, GeometryOps as GO
+using FlexiJoins, DataFrames, GADM # GADM gives us country and sublevel geometry
+
+using CairoMakie, GeoInterfaceMakie
+
+country_df = GADM.get.(["JPN", "USA", "IND", "DEU", "FRA"]) |> DataFrame
+country_df.geometry = GI.GeometryCollection.(GO.tuples.(country_df.geom))
+
+state_doublets = [
+    ("USA", "New York"),
+    ("USA", "California"),
+    ("IND", "Karnataka"),
+    ("DEU", "Berlin"),
+    ("FRA", "Grand Est"),
+    ("JPN", "Tokyo"),
+]
+
+state_full_df = (x -> GADM.get(x...)).(state_doublets) |> DataFrame
+state_full_df.geom = GO.tuples.(only.(state_full_df.geom))
+state_compact_df = state_full_df[:, [:geom, :NAME_1]]
julia
innerjoin((state_compact_df, country_df), by_pred(:geom, GO.within, :geometry))
+innerjoin((state_compact_df,  view(country_df, 1:1, :)), by_pred(:geom, GO.within, :geometry))

Warning

This is how you would do this, but it doesn't work yet, since the GeometryOps predicates are quite slow on large polygons. If you try this, the code will continue to run for a very, very long time (it took 12 hours on my laptop, but with minimal CPU usage).

Enabling custom predicates

In case you want to use a custom predicate, you only need to define a method to tell FlexiJoins how to use it.

For example, let's suppose you wanted to perform a spatial join on geometries which are some distance away from each other:

julia
my_predicate_function = <(5)  abs  GO.distance

You would need to define FlexiJoins.supports_mode on your predicate:

julia
FlexiJoins.supports_mode(
+    ::FlexiJoins.Mode.NestedLoopFast, 
+    ::FlexiJoins.ByPred{typeof(my_predicate_function)}, 
+    datas
+) = true

This will enable FlexiJoins to support your custom function, when it's passed to by_pred(:geometry, my_predicate_function, :geometry).

`,37))])}const b=l(r,[["render",o]]);export{C as __pageData,b as default}; diff --git a/previews/PR237/assets/tztfann.pAYw0Yqf.png b/previews/PR237/assets/tztfann.pAYw0Yqf.png new file mode 100644 index 0000000000000000000000000000000000000000..5fb95f2cc8d8510fbda128c8a1ed88fd84a3d3fe GIT binary patch literal 162783 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ⅆ2*=6x^$YR5O8ysE| zOCPM)z3o1aBIT8gX@mTlY4uIgc@sKSOaKtEBRhw|xm0X7if$*zOx|Q004~>W_`_K+ zTeCp0un@OohBZzP{wJ~gRY$pO#?k4Zdz$LM=U-wPhaF)@Up7Gu!DWRj;Kq7cXj`-< zy=D~GynS60@aQo?VmF8hJ`G3xF4A_O6T*&(;3+sn=+e!+qe1?PH+F*{qC4KkbEXz5 zJfkDzLUjFdu0|_cSVN^nuRw58KU9Z6_tx>E^gjN&p-53n{~UL7fFPgwwXZ~8{#D1& zEif^pfHbu7UZ9Pt$49+d>*^EM_CvX~7wK|HjFXX`H2EBsDEN!eWMWkCD}g|dSZ0Y% zMo8^WJLgRR@M*dBBgh7@`bf0V=@q$1DbMfcu>LyU(zc;H%~6j`mU}jHQ$?7oJgK}F z*{WXc%ep*UgzfENHdy6(zn26~>k?D<*mIF-@e}*g~qzC#C zNJc%rF=(4tc&$Ae&Ly~GRv<37z`(^!dL3r(U^DF88p`jW&mdjoHvX_|I}D{v0s$UR6rV#N^gwsEc z%k9!2fI#DuPV|?yl#W&OTFHpbiHUpGXr36Ak(pj05K6D;PYK}@(F3Wg;f0aNZ(Yk| z`Ifc<(aB5XWIi2M9qpU%xQ#r}Oa5MWlNQU;lf`zm|I3AWRR36A+tt3Z6YoPYFvz?TlV~ndH1X3-L{rfhjRph<)U<#>)#^nN>04rY~^Xyq!TAw|e!e{h% zms_m~Lo{fg$pFy37Sf95VA>NIJ=LAowd9{!53MaUseD5L@e@k191=L*$3?7R?z2ve zpX@^DpT%0&X4-`!h{6_=-bXN$7zb4`-|mHcV0LyeRr_Lz+2yFxrHI^K=Lt z=BFb1?k)4!g- z#$O5=f;50J%e%;6Vh`xR-7pr0PwAB`YT%B0`c@TdgrT+V>O-6x2%@gLr=&t zX`Y(!30LLyimJQ)iA%(naL@rXR)bhUIJ6&^8`1;M({@|>TLEAsgg_r6CFRA|3U59C z@Bl%h!AloLPZ&l0syvl02SSX-KdG|9gp;NhAWgJSchUBf)6)0T z^>gf7l*Lovi2D9qR7IMJ)~vqezK~MA8aB=u^@ij~RwH2OT%f!>>V#;8HiFFuH%%oJ;Mca@oh>{132W~)9jmtX2kNov zwmRB8`|i;8+;uCnwGIK7;m}m@@oZP?s`v_)X+>~9o3fj8`-3V!_i>i^fIY~|H>}c@ z|6TVUS0TYTug`f7(SpZZtfKsqaj}XiR%R^4zXd6<@5zYu+hV=%7t9(2-NCb_Oi>PH z$f_}A%*u#%nJmx)0}|%hQ|-L9n2%JWBPH7#r5dd~=zg>>5GFR&nI+JPl!K@=suLKT z1j{!#qBj2*H04pA7SuNbtnR7W$(!b83q2Sh4lUes2ibERaxa53EKh;j4tw-r zF1aDx@COPxU&Z%24&zb00;B{i=WrzQC~-I@A{ba|NFRYfj;i<`A3Q^zMJHYW3KgPH zM0dm&Kv%#hXa~(6=NO``uM$uFnIu8u+WB{lxLe!|RND_9i>H}kmzTLx&Hzq8R)5#U zWzr)6V4pl65b@h~YZ1N(<^B7H+~j8bte5{`*-DAu>E~<1t{dg&p;#0D$L;oH4B?$= zX3H6sy4kuhdgap@D4-g4yE#iA6F3PbIdp27p9IB{ciLDEUr2=kntW(;(3++@1^vOp z(PaFmlB5vQZ67UlZBu&|9p}lO7GDmo5uZy0!}u|eF}lA`iO<+bv^iQW#>E)CtO!=# zCO>GF{GuOOvy6$5nHh**$Gs>34Pk}N1%|T}K5yo`SXQ@DfV+y)@H1ZQLD)-q=@9td z(Efd2b2ihn1uZyB!+4SY>}T@}2p(qhZ>`zQQrXeEeA#jm%^^N3uZj)*NE@2)pgjS) z%ThhWWT)XGk`8-W6}>S*;S-QKQCGEr&0DNrHqN1=+E5zNM-WbXL>y;c?4?r8myHN# zjwD?SO%>fNC>28c>oggK)TX~aD3vnHmKaA2s&jal0kad=DTd6DN%yG2F-%m?yprjl zi<@yHQ#k3Pa`9?Zfy7eY5G3p4g!HCGStbY@4tD^G zvbA=?$-;E#$mD_aOw`3N0E-uwYLs!IYFpw@O05a~+EwxQ2-AK^XB0~7)PW1qOuC4J zA`SHV;<@VW*#wtc^cYK4xWssFrqWib{kO6x$yfRsbD2rxQL{8OHUQ)-Gq@4LYuRP7 zn%J2t0>Y|2J1=`4IvDnE|F1jymS#8SeDTInoX3p@;VprKY4@*}Gxq0hzk9#$T2q6d z{L9D#5F0{wl|sXQ!!$Xk*Xg*@Ap{GHR#xe2fD8{!uiB8@oS=sFJ3IyO+G{1~|0tO) z#)3)ssQXX$A`w-E(6~+-6r{tgRc3&tpL}N9k@%)r=oxwMPkUgTgymGhnH%-FG`vzt};zv zhK~Sf%Mr(AsA0&}of#h4{L)tHoKxb&(YxW+wJ+H_LfPy zt7x}YDEqhP_=@a|UdxIy){o)}ozc280ewLTx^;g)t@M zx9Cn6u5}KB#AEh%}JLZ1gQ5hV;vYzm;btp~*)GEk|}OWb;rrSzelk@0COH zH4wdn|NSn7KeiAMh+sz1;R{nnrX?)XBJEft>A=j;W)E8ciSHH0PB11z{Rwwx`n^Px z$+L|kO@0bR|8;TqlQbq~VVR?jjDJ=)cO#pDID`r*{NvIR>ZW+!G>bnYyK#ko*{&Xl zcygPy->t-R$kH3_jKx&UHbz1$N_Z%XdT}OBW-Gs z{U-5S9Ho!G>soRpnwRUBtl9nZa8FguOmR|=4Y^6R0s`mEz<2ibzdJj0y4NqNOeAoB zuvzI>J_nHauCDR$mY-sRZJatYK09u7wX)Yt6l;dUMkRJ;5l3j8$&HqV>ABLWgA6>w5Ks!a{Y!QQtZBsGuPkJg$tcAnd}GcLhq z%{$dc*m_zJ-gX!hl&;SmZUefpife6u(DEws+eOB1iIjs$2wx5a3R^*UJM!k}2jI#b zgaSnL*;5~c4Gx-&yliw^h^0_jMuBb@o#Ca6e~Y;W!yJUMU(L`QXmtKmeYA<#WsKs z^*$TKs+2RV$NQ*52&oBGtb&3k#z0^#qhE*Yw%-3_9G8;&zi}%ML8S^<1`PUsqhN=w z;EgS$zY94*o{)t7ucZb3#wm0;Uon`HAQ3KL96t3@D+9>_cF|!*MbXy~CBY4nhUs~^ zfkaT*E4LY~A^C&?!9-y=)Xj3n!0DXoF7KHl4|b@Tj-_bDaZya+zd8;2A zL6GorLu|G}8wC{Xl3l_>3>oldGn6b&P)%@J>!n?dqw8ol#ybl-gpc#;T z2EFI18J7(wW(`lh>{&>WDg+SXjdL5ZxIQNM%)4e_Ztv)nqXL0<=ZCpxuBizh zcS3h8fW7r}EN%yFi*OtSAP0aQY0bCEGogYmtK897hesGMUO;f_=Kl_&1?g8@+5Gx@ zz_fm0p$Lt=Dpkq-u(#l=tHvPz-`m^0)IGGtadY34bwI6r4y41A12QU04WXHKKtRYl z*W5G-pxH@t0BQOtrFMW;AqV@M?pWtfv2Ol({m;R(=2O?z%o@Y>=1v?+f>W~&bqRxV z{m%wIS~X0Wfj(oZRV~%H*#yRZtL;$WiTBsCNqmzQzYhlo!1{p2QJqRq>OA{2Qgo23 zHQ060#|T#19+ScK{l>f0M$ROET&bC!O4)qa#l=uV!Ysyex@x>&_cwk$_9l zSs9l|(7ZAaZ??;U9k1FfK5wkdV-F#X`rJfKZ31y|fVQ6GEWK2{VO7x0RAls%_0#3s ze|Y8mbiMJDpw4B}sS@AXb!ZL?&{zDx!&1A2p`GVNf4t~BedQ(0*919Fb4@SfHlW^} zO#1l{%#OoDZJz))k?>f=LW8`qP#elJ}n3v_bc-^$ML$fxhWn+a|TY^ z8w04EfQ%9tPB-)8$JiFqlN7`qnQiG15IkkPU5~Ht&YxF=gWovAnI9~;vOuRDe_@i= zIppgWHI68``fZJEZK=3=q!#)fY|;MYK@TSyE$Vco)eSF#zb2&mfh}cX$|jet)m(}P zSaACQZiG+Mqzx?Q0KQ$?00tnV9;Kmtu?O3vyveD#fBQN>Y$`u47Jee2vW8++77c6I zLujR3?l8yemBm^K2;8SwY-K{KD>-&uPz>HbmG=hp*>u?{3;Kg48@CQQk;zq@YeRtD z{yf$iljVx7PIeD*-!!=N({^5* z`num?`~5DlT4tvNx)GtfjOS&E=1u6;Ld4PpIx65~IPE1c_o&S4;;9du4eswKTUa=? z{;F7ZPG4NV>gt)A6Rvc}3wJ_4lQWx}wN}H>)!H1Pc1$(w`hxx&} z0^tms@zdldEb|Op$PsiMVrFEr8Q(~x>wpt%#8@pJIerxq(uDUPy$HSHAftNyCZ-S6 zltbzcQFdpOS~-`!^{+0+s`)RSV#<~_H3QNsdij0`5*aA%yS6)-ODUo}2KF1*VB z3mY79XRrN>V2vq9 z1UO@FruJL~n*skyUNclZDk8V@m4sSSe`7l@x^b{|$6YLGH&01~6LD+l65NIm<(uc(dzvJR<@1QE< z=77?7d^4{-8II1IYP;Qz+PA#gzHAiL@P!JO_t?+k+ z5N8uxG2_%Jty2@k+hKaLQVDxy1l#FpBX6RuCKruR%}`sbofEq?m(t;cdA*RHyh5Q& zRlvQj@h!n2mx|u^&2U^XzWs>YA6Dsb8vr&~bk2=SqDwSz$yc|>eT?c&J_EBmQ7W*H zF*}jCV)75g_JXVE$Ben-KLSAhC9S;;h9?=)%Yn{GxJKy-U?Fy??02rTet)(jO7?+` z%|g+6Q5;JXW`=4$qJreFYYtje27;$iXB>J77XR@bDT?BdQ2AR2;4gxdWvO?JldC_} zm$(1k?i5e!!MnxXKx*(KTEp7)S=GsbrrQ-Sidq6-k!!U$H});6ni$;cUf0TToXg%5 zj>@#uy~^u;kCCGrNmHKb4(Q9>DFmP>UT40{|5~iZ>uUDfj&R{2`4XxlQ~nt&Mnw+- zecWbrYnC#;RYysCxW?3|0keZYMZoFhPawn!>oD0{N_wa62Bp-9Lshh_Eia`E9Qm2p zM&9qa6QLsEJ@WHlQrrhbTxvr)JR*^QD?ep52c!{XAKX*2)^gO1&7_IW0`y;oj&v(2 zLm(z}3@`-KMd`BFia=Y|B#&Ex{^QYj!J+G^8RR)ii-)$Qp_wh4{2g%DHa%^#>y`_Z z%TW{e69Xz6^AL(q5}ZhH0_5s_@MkYR6?{zrqWS^T%y7CDj@zoiOweOr*Vhs-zBz2zYC`KtR|;jrdP{Yh`Mty)$WYvyE#ckyiz6-yD|)&4$|glu zQL2a?u3&_IWe`p=jd421o2{te$*KALVf((-kzMvbkv2mTOr^?!Fq*Q9|4vp>E8yrc zT6O1^pw?WGetjE8Tng+_F*U4~o_=hKDO8%de+-HCOnXR*uxg~vzjc>AEcWfxE3%`g zHTf8r?@A$nF=*GwDEO>i6L*#V?QL^EZ2XjUFN!;NN|4+HnLjiInOv`=VqiG2#} z&H<=yrQf>Ja3;`Ti6t&Ze}-<3Cx{j-#F|r_lqpL(Mm|&%exIq&tvZnr>4ff<`R3*T zL_%dY5-DbXq&gj0j50Y04275ycr2w?XQJj8a?odTQ3FsM(~#Ol5plb@mpYJGk>=GOP+1y(QGnkXrio^O!P29QDDT8wE?m85ClY& zEwLLdK-c8Nc7NW%a5O$bhdmRzE4cz`=zTJ>6jY7w2$8~gP=k575U&x9ZN@5SKw)O6+yK76Vn02EsuR__sY zx6L>_dK6lI0)RpiiQ-!#af)+cZVsjrsNokBp+|BQ<6*?vCIHCyQ@{>AFW8bvafyUg zRPdGfJwJ!eknjxV(u>usX6l7qJJAdyeL8w&ndDnVXmvfQP0eu&|&=rl)g zObofzOY#^(&cnQyU+`X?&E$o-C4b8F`*zuQr^c20++JWlPp~tAXG(ogv`LD0%Csm@ zrAtbiC9%dU7~LXN2Q3YXi3DYVOa?nUNSWK%T+WkrFE+wO%tK>!ky>3sr{QHG`Ss;O z-Ke7xjqVMi9&5LF^pxqL>8Ir78^$rNSd83nGjYq#Vf_k_2Hh^=WE3XLPTm&{7n#Baq~Y(uGNhr#{eb5?{M+em z`<&gP^J3~D^i3+{B9xeN1S7uRIN8uMg~l%7e!Vf5-7TV{gOCMHrX!W43JRwo&~H|} z3mwHYYFh^>BMVJfxGn8V{4-3UPuZ(}l*T%k0rqEx*Ug`EiMAc_m78Jaf5#bT zXAeI|&dWwC&z;3459$5z0QL`Jp3dDHkN|?BZ2;vbw#}m5X1DY2oE&_vr?)*>fIlbS zc!!_Or5cbyoJpYG7PVr6hdBqXJMYVLv*15#w{P_rwikCoMSCB;Aw*>U@k0>s z_}_+vGUN~92i!>i9^8vL#XH0aTmJDcyP?f00S#PRHl!O@8&cGrybVT@z2h<_HO%M351FSmQ&d#cpUTEo z&~hx$%EfFo9eY<#1rl`VsKqRZeiBD$C2D=V<)i+fwaNAthm(Y#quZ`V83wEF)@ zpk#nv`mTl+LJ`K4O6x0z2y#IZ5n56!*i&ijgzKV}n%M-hE&6+Xa-Rhr5S7dsK4W1; z*=jr%>%s1#GMzSVD&i6DcG53e^E1b}Y7822P~~EM(<@&D{o9_uy+vP6F&y z5-bC!O_1vfAng`~nCf&HLo7T&1C3eiB7TqedkND;QlBQF@D4P-L-3Dm8FpGx%2B zBP?xB6QjqdIxXj!AS~d5Y4!qpXK!^D;`jr_|E>?F*NHU)(hsh$mcqN{+C0CaVzC+w z%E{n@FU3hORp9LAWzlC~j%a}1W&D1Sy}7bgh#s#Gz$h41_e!1e7ULhnA-TqEIueC~ z89eUcSF*|!Gp<%<3-h{dXZpb?x=~HhQU9W5g=z=gamu5Il>@3tx0t0smcNI$?xa|h zXc%0q;VkL)>pzfNp|5>A=k{Vf#BzrFW|fHUF#1#>D;9iU$ah3^JA!h!Xa3I%K-kU7 zqJ~(OFD5$V@I;(0@94d6FE+6$bs-BVenF}FAetRpU9p9m!4UbwDtM^#hY$_JBZQybCyP7(UKEmQlCpL@FH1 zqVryEym^A4>pxF`UT8|TVY3>4Pb;px)Sl}|+-huM9v0Hn#L>IYB`PQ>)ZZqE3EGIs z)1X+BUCt{JxiJ4R3KKF8d!keN%cjtreSB|-)y&a9bRj?}MiYZkgb%{fr{7I%O#jC* zT>BJsp0UDbqTDZe%!s3Mw}LF^%G;3n;=~buR#q^i zjs#d5H2P!WjL?RQm#m`d`0Tf7!_n zjMpTEgb{WkEXICku2{#Y0&}Z=AqQuE$4wUWh$gFa2d!L}j!OIBvM7JHnJSUUtc)W& zf@2$CO1XwWP~rW!4eFHLFHhSZG~JHCmw*1B-*N!g*hHD@feS#s_tEE*hN_23Z8rC} z-ObK(J+>32=gLxgRbKD31qwjl^s*Z#%tqj!i`9h?CoaD|zhNl*yC@6o9oB0HfaV41 zmu{Zxa|+$5Ri{Efe05;8;`Xi7e0UfN`fnsw<`{u zF9H)m5RzxF>aPrgzfR{PKdRrQXDYSiakZj>RRjXrXkli{Ch3=v`>cZ&Lw5}aw3WLW zV7Y%`JLZiy>RTs^24t1E#XK_K^XOa^Pv%7 z2!b4wJ{d{q^O!Y@z817gb5}@_W^&C6V5x1GIY}Mf<}eJMz!DdQZ_Pi{=M3mrnv^gr z**yaVc89;t?}xfjP$!zk$#$9Ssti>DehSq8D)=ep*4dqPMI9}^Rv@BZO|IY}+UR=$ z9=QgK?jjU4xReN>&QF&_Az(V#QxOP?P~y3nXDaMD_4pCFzxmaHCz)m0i1bt)y@zC> z1VeD|x@f===lWP&Rcgg$3a_>EaWx>OcyH}Tv~%eneX1EYX{2R)xi3?q6EW|?@t$2^ zS^4ZwZ(q!I3=>Xxw_}DaArsdDBe-nLqcK7VGW=+CH;ip*?+FA?Igd?Y5(D>AU2XW9 zc)A(twdLuA-fC#1o?6V zhx&Enfo6+v#M66t69^>K2Xne~B_FOKkyjS7=cx!Zu09HY)qF4)=A{f7U!tImWH^#< zzHbo+>`M=ce6zYfLm7+-H`1H@86em+Z%!tey_z`WVbPwIR0#AU(6+=v!xG@Q-Uc@9 zKMaaVI%U*7=#t<%QxvBYzYFuUu9cxHI15y+P#jF)P<7bp}zBxOl9 zKM2|?-8#1|2H%GbrRwe?EkQPN{X59d@r$d9(}OS&7`@nk(AubU@|=eew7hNbo z617NN^w#g*u?;-17Yl?&#d(jwo*oB%g_=s{c-nfsOS_*rZRo(*p-!n(4ogOiA8gt4I*2s7G`WIItn7DB80~Qm=xw5ct)5!9z4sDp$^|(#!{|*{);2J#jWLE@H^U)^wqg@3B4jLbL8A5XDmW=KW zEJ1-+wa9V))|47MoviV&wCw~Xw-!s}@JFUJ);`=gcUqO_O4~Jjn=sdUS&0ecm2AjB zGD+VQ75hfahr#Cn?|u8<-Rmh(2_xp=Jgr#( z#ajHv`%>hC6=1MktC#hrEeTw1crXG3H#WFV`2MOb22Bw8##$OJlP5>#h{7u5J!cq_ z2m`gz*NETf8xW!NIn_xjWDIh5hc41)0q_4U>!$V4HWPIafQe$cNDd`W(D_+2s>xGb zytu?0FxIh;xt^{)(E=YP(^~xM_>DW0XE38PpgcJ%Mw5&pgc=hCSIEUwB(d~& z)3n5hNG`&*te5wqNt+!}%RP3Inqkm#H2(?W5afygEP* z8LN*S?7F@rv$)I;gude=gkDdW*$quDtyPE?UmX1}JN7Btm9SQh;x~q{iS9D2`8v}EJ0Q$;%{I5N}*5B$Xqak9= z*$#D5n1_CvM`3|wr{jc(c88>?n=kE$Rg`blR*c%?B5T37rx?oz%Ct)m7?bU&LpQFO zK3t=ls5@cg^phZ0HGZ=F!*r4WYL^Rzz!oc1o;b8|oAcJM{;I2pYDyUkf>ki% zbx}!;m}KG}*ewc<5?=YvZK5zkjvE~F%@^35R`Ve!{rXr@L7R^%==0|kIEOg9TdcVI zgVB@W z?MmE!G5&7Mi?NA8-BPGz&Z5n~Njw?0UkFj2B5x!z8Vivma8@aU^3?zdXB|NTbCOU) z4nKlS6ZbKWb+r|0zX0{MN-oMyrCFiv*rFAd>lGuP7`R4WQt0XFj!k>RYdaFQ41F=p z#YV$NXsarm-Wo{GMa9=JD;nS$XwuJV!dxwdj63Y@zpKl_g-gv)WXAuMa4c3*nE`0U z@tE9=M`;m~^yrQtMIszJqD(u^{3&2Qwi@9{l-s2G`f^79TZ4WTYR4WyQ!nf?kn}IJ zb`6iYR*q1A3s^u~DW>;%8|G%%+~nibp;?ySK-~e1zAd&Rc6q`m61MV|>*_#Xdp-XV zkG?W^KH&`_4d&>OieOB=5zqCR1z$2z5u8Z{n9) z$wK7J5U&B~LZX%f##}*=$dL9VgNo8V&S*tn*b*F@`{utt;1U>cSsgFXPKBB%2B*dH zr=K}HBg~Z*vVa@w1Wtd9vVX%ceTc%9x|cQ0@iMbCmW~!C{G<4qGpv=)UptiI2z|i~d zQ`cL=B^&^0A|c4yRU8hK=+T^xv!E`4dbcwjEU)-hUZ~skir8Vl#jeE3wBffw=@*Q1 zbTU@llcD`zTfyw^eiZKM>I2vuwY911Hev^Y{s8WbWDrI;5{JeT>uQBT`9T8Q-P-oF ziZq0o_`*P+PVZwB@4uOL*g!1S8mUziKF6;ZfE_q4FMXoQnXaBgWj@D?-W;`RNsb@R z3NW6B*nr4lt9(92y-7bYIw|`krW>ff@qum$P4EtQjs0`$%(Kyb+BDrLxIByWMsW|* zfn_|@^9ye#$7#Z$4BkWvw(a;3)HzW&F{U9P=|{e^r0trWXueLKhE=hzCi~PIFm?LK z!-xAoMO2e~_EeE*73rz+74F*K)Eo{IaRmDylj|0iTZ-5V(w2 z`ro-lfj(h<|Md=`e&VqQ`GK`Ho=nf12p2CUj-MQm))#kuAR>4C3a{uS+xiUfNXQ%4U8+}kE0ABE?6LZsxK84yQHcP2(g zN)woxmQ^p~mP-W#wv{96;sauJeR*671Cn~RL zYq2FrdkHgj@42%BsWDfWDH*8KwNBy7t;%m4f|}{f-+B-{n52H}cBKSsovxV{S#B=p z57FI_3}7f#R(vZ2H9iCZW@arfG{F^&8-V{~nqTY(&NFB1v1$ppKZ0pj6!9C)X$_c1 zpV#w--6`y;IPU~y>gku_gl;|5YrIiyHJ{(y^0U7pK64!mMiF<3QouP5d11p=4iWTSKDMn==zr$jT1KK%H1eSyA3Mnsgd-3cEy-Acq7uj`N*ZYG?$4#Bl8663u+EpWJ9tvO{$uw49(Yk8`Im*ue zG14Jx% zW50cw_x$987VxjBf6e~kIJcwp1UN^P(6XMB zzo1cDG61O2#23+LhDSEo*s|3o1<_)+|6aS*|C5|L8a)XOq?n{EOT^J04_n|9x{^R) z0i)=#J=4TY3refTx4yd`j13M_EnSzT>BK2LPI6B8fbc1MOmbj7?7Gu)bbpCEf1Tpm$u^7EnY zRBOlehv`>Ka(a&~pN_j69*FcY#*sOvv%CVVugzvyp;Q@1eV{@k?gZ0}os^<{<%*{8Eyz~4Gc}`2|007Y ze5II!jIjSLwmug%Sf;S?56aIU+4)T`X#;g^@xzv7b;&2Rb}2X+KaQ{avpRf7J^7|o zby8UUD2~Z|zK*#K64`&{>d-g^#?QoHp@xH^ee2h}g<`c}>d+kp(KQJZ&1mwOH)R#3 zzU3g7AGCKd!s3%hu4Vx%(-AYq;PC0@g>(59qqeNlq zPyLt0+1K@ZE38m9J&ZSr!1Zi0{(qRhA5=F(-QY}3;09Cg)%ShBH?}%5wPL2>2i&&q zDryeRG936ncdo-?38rk!K}qeGnykN5mlqcFAWTNOswmzTwrK3dqu(U2TtuWtwu`fXOd|?snlXI!MFc%6P~yWmjl8mDRK17$cG*u_gwh zxZsx!zcYy!#rA2}!_#qM0?@O$+^W*ZZxZj&;ooj-Qonq0NW~E7`o1e|DIh!jQS?$X zJ*5TVV7lccNK;O%DEzc_3^u}s(| za6R|7`|DcB1No?X1p?#x7s{ zQM){yZ1jG2{N2x4!9aI~13a_(D=XqVcN`nnI{K_4K9BklZoe(IIW=XV=-u_Q>k_DU zJ5~Q|`FtmLZv!(W)e2&$QT3>iZIuJHGH5PXDW#cwiKYBxv9w1^xSo42)1^~M1xP=! z5%Wi~jmfx)mN7F*Vr2yrIlV$NSfZbJMV1yLav0EtjrHm%q3V>zD#kPrZ42oXl}{UA zIG`GahD^9S0^9J-3|9Rn8-*sj>5iP1Hss;Q>YvuGM%(ch`5d77<~HcE^6SF%D&fL} z=sgbw9}6^0OiDO)5S$~8)Au-Fp(ZNEMT(N3kg^b$y{DEd#ec09ocCz}2$&SR z3N@}me$y3SJ>&Ww*6w=wesj|psyi@-&KZEDxu~c>>V7`x;4kATIl~w*KDWEA5@#C> z<`0+l^IVxzzMB6;P}9WXDzSFr|G9NaJv+aS?dmk>6mD~c_6izPzG{UF$!kK($dxVa#(Au`y*4S-WeXe@pV(4^XIz3n{yz}l-@AcSEKEsP)Pu|;go zQ3$bikTgl;3^tW@#hH}u%;&d1OisqBi~)C~KX6SXHR;S~&l+rYJ+zV1W)v#PLcXnH z$h<`=;q7WbfA&<_0GAye4x-%e{1!tx?=<&zX#v+^&#L=2zUZ^9cc0yl`g{7Dqc1Oi zQtxN}O4?oU*Xd-A&aDHycb2#Qbk(^G*5Y+_3lL{P)e_atdu8cybBDTMIA|(DlsRYu zC+Bnhp#QTX{Z+5qfLT$A;2OQwRI@$e&NIXP?%?Av~ z9Kb-CJ@}3nCoJ#v?64xqcjn2pPsTJj`qiPgXtCr6;%ArJo4&#m00Pp>2lDQ$v{p}L zjalKP28&HNJhq0{)45=c$GhLla1m2C&5SC@zeILNqfU%SF z&FswsSSq?dX#B5L)^5X_psz|-a>5!UaW--4HDG|)XI!|tay(+QgW>N{vyKY%JZyFh zh1qfWhd*stsHoCYr5HI}{h_ zGK$)Zxh&mI`QB4yZ(f`UNf&N%jE_WJxI#byE15;v^zNrVdP_k;ay0=aN=i1#)vsi$ zL1zbln3A%gr9B^9${?Q&5COVe0KO_XTx%qSiDwbc2l94N6pkT*h>xX?Wfv)@%X8dm zuT6tHrB%LRnGAat?;m9+XE{ma25Vyj-b- z^a&2;W)}kEwt60ZgC|>otevV#0RF4sPtS6ZBd(_8{H`BHTQ{fip)qd%-+L}?cjSL} zTEiD^`;D#AL=(liqimwoiYKe$g`*stl$4xh`YN!@6(k6<{p$OI#uEQ=z#T2);u-tc z^w*M0vwtci`DvYvk;sb6%uGg4{D~yCfKE;w-E0tEjhc~9j@Q&=F}BLhVl;89czv!L zH7j;1m$`#aGG$FxZ#1SXd5=~zzEp034)*7yzS{}5{pex$t>2Go46;0kZw4Y{oa&*j zT-LY~?MjuU+;L@W68w7OJ}r;3-5?$D(4Ru_TqDlp>V;K&psJB24Rg4e2f63^qjpVh zqP(sQN$XvwS$13j(EGafvfOd1PnWi?pk^~Y|H~d2uq${h`QNyF|5Dvt?4LjGC!aF; z67=4RauBO8<0<_odjSP?kCw#c>;^vgt2@gf=K{z6y%5vn`}dTpo_CRP3cEE4@{DsG zOuM$4n7(~y81prSj$i)qTQT-EL1wl&WaH;bXH)zX>U~AG3N>C;q2Z)dgUlh+l_fqz zdYT8uQ_@jIchPoLNmDAc$;-<;gwE|D?wci@jP|&-kVI(R_N-e;AE`Yw0ffQls!~ei zQ>(=r2`Lh$zX*bki6$~RKesf;;~R^6#8=~+Vp`CsR@FM4+PP)yJ1Tk%f#h zzmAHZ0RqpP7N4Tsk#nZ3-=3a(PFKp{s@!g_)2w=fxS@hUSia3}b;vsp_=*5LC4uUg zUX=gy0zhm&DAU%Ws_6vj7{o@odm8)LZrs{Vb*?<5%hXOdBAo~C)#d!u!T~;YfNv*T z1z3_jI$>(MmoXtD0p)TG6+dO0&`3 zC`h-kjgs!}4k?kA7#&gqV{~`d=`6A2)MSvMt9c z47nmkOC(Rw8e_#D4o>7RWlER16JdtIi_gw@U5e(rxp411&wVUJL+jmp6>06-`fT?E zb%?x(cbWU7GhHwIck9YjBaHK5F7txAmf`)-HhVP%bR`A+jNajb3>oT0v5e^D|dSP~Us(UD6 zLO2}$7$V#94u1p~6%A@Q$q~shI&rY?9Mc62EADNFF%ouFvEX+#t?UP8=QfG77@hii zK-7}|PAQWyy$?E)0KQf0k&SCr_>xad2TT2whsp>J&JwH!tvm6l^qS)ulFcu51Y^e3vd z$i8$m>HwAfYCo1R1GESwww`ZZBdI&DO4wc>jIn=l&7wxxk|db78hhq-f$MbT|B_vV z=LJ7e<~v*`#2a(})%#GLWI}|+AKKGUmeGCH72PS$g+Gb5aUeA5pBW6pIG2*cnl!&- z0(L5?yqR>e?8_l@MPLRc92vnX74XTnNHH|1!Sp=k$9`mj&32*^wZ`JJHZ&Gm$8*>W zE`qW^bnR904K!%zez=f~v9(6-iaJNmJmCdxEa_i`!$0NJR2BT)zD{d2zaxs@K!|?$ zj@r=RxMnz70p=kpuN8L!yIr*lJNL0d&XRdQMf?5Zg%B7yRv3BGX(hByO}~=e8KyqX zt^J$GM>G450Vsw1#q5@RQT7H}twm;OstGDqZ4LkXH}Bgut54T8f?M&~{Uz7#bQ(W( zo3HuO*8zG&39-x4es_TveC2X?e;IVC~-a!evi=VW8sfM2+?cskR(oT zdWwewkVe#4Ftjn|&xM?=P=^Tv60)S{DF`0@)ake^(L`je_$xaD@TAc@ojmt;+{2rM zqmP&SI;yS|r^8BKe^tvUaI>%pTnc<~TL7*dpI%jbwdJ&#k-GhxD z^w1iD1@cyQ$;XlZX)nFkhExUyju?YQ#YtLQOc^EooIz|XdN7i+3*-B0uf*W`EU^<& z{d7?XI2t5q_wVv{$$@!}jh%IMhX2X({?I>)(K-_45Vq(C`CkX2oRq&YksbtdFF5%A z=}misS1%k;2Kxud*?<**flMi%$dZdN`w>M<;NFz_xJ4QpM}1-XB~E%3n~^@f)<`Dng)mr_pF78&shuV>UCkrkSKmVJS!ODCB- zNgX_(IUdyfP{;l}=1HzyNxPJ-&H}7~lda*~#T022ZI#~uiZ|vv5o9;vJ1s&C{jgH* z4z()$^9Cx8(@W03*WuE7>NoSZ7&g5ZcJjHZ=06&i2*=s^TlYwCukYV9QGA0Wnb|g3 z_R|18fA%Qv`?#hBj%wGIwIfNkG!=$Ov9qy8NaZ=S6t_rtgi^<}P zt|Di~JEAJ97beg$V)+xlWk`fBk%qG+UyQeV6%v)}~z=y8EshI(x?qt9`t8(;BIWA}FEPrT5k-6wAm4Tm?t zdLJiOFX&jeE~Hd|HFTPQ!B5@?D_@sBZ&t1i1c#VkK+ZDS?SFUB9`mZ~Osv}6~uQkT1c65vVJ)PgS%;~-Q zV8x~0j9fQrdl!X-yQAg~WJYaT>%X@A8C1>HyDfaa9Qb={3jV z>rx66G#pv&{xO8v^{#4-FRl37{RX~|Xj1LEO-aSfDvf(4JlgQ8U#i!3*)WZ&jS zz4!Y3$C}g_dQ)#rgF^l04Wu9nZ}gXc%S68rekFL?2x+AX6DU;m!1bEW=;x#;SP~I( zy)V_GkQcyZY}l&mvJ;cdA3p<42<~aCIS^>g+P%{SGb55lwcmu|pijw`e!|r{dTXS2 z53jU~AJJG+n5AR*Dc@isq<%J&f^y=E!3B)^Q_lvGf0$QUhf-S$Bgs7s%12kb`J)|& zA4+xU_NE`#Lx8i&;U?9Yn%_>@RjS-X>lz!ys3|HMn|a*a)+zih#M|+oo~1VGnabU+ zly!_gJ$u|AEsZm502RMB7S)<11Cjn0!)!#=PlXpo@q_s45HWlf4fykKeyC}Tj#Cjz z^&6;nh;iK|XziYspq6F->EOC!%}#$u#q}9A4|JMj(5lw?OAk#CXrQ&4+sWmo-snT7 zMbaj~1lh#<*UELnoo`pIqdZOpXC`EQAfMq{6-hcy@?;=Z)qvO5+wasB6@$^J;C+^4 z^4;jmMh#z2(eSb1Ps-z1!6ujYG&Me+P9!1Q^yN@6_cf$&X*kBjfe_$O1OjuDh4HGV zO0lhzHRAt3h0|cL&HbSNnb3H1RKfen%3|Y~^F`J5m(g)+k5_v-MKW!k>4Ycp_A4k# zDraIPenz)j19h({q)^96u>JP)h|K}(+20Ya62Gq5HFG~gYCo?OzT#&-tBj}Tn)F>x zv)N4~BhO<>P`0xQ{{8^v1(zc7-%l4LXLTUIqQO(3_=67=h7(@V@krLM;z2SBp}jmO z_ODFnOsmnkQZ%lDO6eF-Ro0tzCL>{m1SD@#L=*de!?9ZMHlu9Vu71Vmn&lL82tj86 z73`wbe>m$>P8KKG=n7a@W7)q=6#FKfhTkj#TC^LlkMKTydT}-RENV2E2%9mO0Z$~Z zAd!2L<2ABEmsWR*(rLwbv~}Ki0Pom0g(--wkzKwx?Dj|9CbM$*jC?LoNw$rI;!H=2 zxKJczf5?ff&TI}|R0dPl)WP3~y&a2zakC_y?(_S>CW=9OcVb~#PXVd;#a5yyAvt-D z3i=}ZPk%Zr(w$^6&2vWcv90AdU2&l0ZYe2c{(aS&jlH7A-yD!^l4!d4__HLPM-GE9 zTV>nO4*Zf0i2)k^`ax5#punsRInl26D$VIPqGauW^qZw_`3!EN7ypj>%gO=aDe%&e zvmxdqlC{mu0b{DYm?(U8;dft5r}}*-#&`Tz?~nvn1KBi@sEWpV*!L`&Fs!8ZpWFR9 z2_kB?h9DsHs>zTq`%r3#_K)I?Dt*llHE=XLGp87bAe~sGw8C=c0yL8$^R_gGy?MW(#qc2{J2ysG$y9#a`dnHPL;od%kkN?`L?w;Zo>!O z_Z~HQLrTEeCNb&5%Ud4@XIIML}0A-u8v&WKFK!(NFGri}fCFSv^2*G=yXIYjOtU}N9Fv_=h zgV;8w{ZG-8r>2=1b58E)9-se(h)3m4vx>E>pVw!VVJ#O6p?VmvzVC-#yt`m_I~>rH zN@izFHyy-U4wt}~pl(oReInH*5twT(`1sH5^InWEVNb1N#NivS_Zr*5gO$2D-cGtU zT5Q9S)kE{QV%HT8o{jP=WRo;IcwxS-Rz{R+YL`LPTTk{UD_!(O*xn~k;H%8}F5E7u zPi7bm!b1+EY&3x$IDw3@gTO*#4l+fa9Seb-;d2Tlo>MfBXsURTvVr(ena!6`z1LI( zUB#JnfZi{;Ie{ zuRNsHfW5zYNG~uSMNReLYt zzxe1q<)iv>hf-N=R5n`aPv*;*sF6(JG26-B7$NQ9ybCf%E*V)`#9e@5T^s9hVsF?aL_NJtvRUB+>etdv@8T3VJ>%T#WG zH_fT{Q@gIr+PqIW$n7uGTbr3Kn2m46aUL{!$@NS!gywgd_(^0}){kS-S8WW0Z_C9G z5(-9D$qecf@6@Rdt*$k92*(NR_Rx;>M5acADl@L4`2$w8i{eSq%&KT%OQeDG_41EX zvO6;jJMza~F*I!s-Y!Dh_(md`ReEWqg9##ZC0Mh|>i5jSR|kc0@ivnaXL`7tm$2D` zmAl=FAS&Ku#(YeAC6}}1PdODXG2O;x(pNW*(43DDar;AOjGp#lIqxIp3DaDPP$FNJ zZ81~o;PAcE%AlIK3XgN@=V0UL*^EsO5E92U^Um{zvRb-xg3C#DE+4A$v z2Nw5BpDEKb@2V0gCdk!nG)32qATmCDfq#A`(7dkUCTL}T(ERmnEO;-MyWuiuHR7xf z+P_1(qN5iw0R%Uva@<9f3et>}FNrYW$zmgv8r#~`h{!!}l)cK@kY>~js?3WTLYIRW zH0iokreT_z!!miQ*7To~lW-H4SgjCuPGp6GCX1_ zjgD5&RYigYj9!E3V%I@ridJw8F@~mOq2iw(KTE0nw+-Y}Ya`2yZ6)i>#Xjb9(M z_?H(ImnTEl6M?Pt<-*28e<^;u*&*X`U%o`Ja@~yc*SMMHI1Oox!gy##^!63``O9<6 z_ZVn!GhNdoQ18X<$vXr(ONdkP&`PF|G?ytSSdAk71r1US!eIjl(>Oa-QhUMoMV06f zRF1Ev!K15ama*t#-}OlDkd0i&rHg>U}Ib2Nt#4Vckwq)?}(>Y#@{KX3**63DFy$h?r zTG_bc_$dc-5|3#BEp=!Oy`Ci-S`FTI*@-`_wv%E>1# z`8FY5#Ln5hZHB+??`DHV@1UL1c96?!+8Z1vqD&f51-o{&Xf;Rs^MF|YaE}La_kjTSk>vZq>hQnv&) zwaw-h`Mzxrd$%}MhBi8N-M%cM-6=#hleTcI~!1QO|lShDT z`4ST)`_`lCTtHoXLFUq#=F3I-6Eh>yr#A!wBG7J`J=%do+)Po?x*BCqvvl>^&~?7e zrU&J2f6lv@oWhW6Lcc~LQBU$T@awE8lT;@ewFVh_XxHq=1+tkF#Z;x31pKB9}1w2xn1> zm=>#%xSq!SHjclr{Fy9(T-#~Gcx0E?*EmAoEz8`ti)8khs@Dq=pTAEhTM)00H=gK; z@+V7&U<1+MdF8o!d;PgvwOkwkY+r!WUhlD~J&@RJ)n?=oDQ7O8yH(AvYJ zB?}F)?78m<34T^=7*W008{``v&+Oi{g&hK@h&ICi(JH8;Il%h=CLDa<`mqC5Gh>(DQ$Z!T!;4gUd=nN z#Ch$39y6+&P8BcoQ}Q6^fh`5b(Fggf`+h~veJXHl#4-ucA$9*1Gb%2w>;)Q&ZfhG^ zcQwh>3p!29yWV^jRPpV4N{&h+{S$M_=r@L_BUou1K^}61NXqi~N^0*fFpV0T=u`Be z7p?cCT)}1V1aZ8#8f7+JQYf&Cks-M2`S`71wrHm6o7|P1nA_N8S57v?m25bs`w-6f zMSCBeTukjD?c1#A9b7)4(AWUT`N)AXR64;>%9t*x#~I6$T7)-Qy#CkUh{ZgV7Lh$1 z76|Dnqt-hc$h|x;L|R=ghRw`5iRBFG6v?~VEj#puLBjVT7$ADdM#Lfy$Td6=c9uM} zWf$?^E8M40o8x=2^Gm>{xM@Vh20%rug{Cpp{O}uPRqwD&`q9PSNAllXjA=H~++T+3`~ zwHGo6YE#JVk)r%tWijN&&k5cR(=6SOJ~WNXoSCA-`>sU$g)Qockvf1>DiUAKb+;q+ zmDs*a!7mf>I{5HIry7(QcV60#XmK?9=W(xPV@oh>*vzl}_cteQb84G3)KIEKl>P`P zcb4T>&cW&L5b&|xYUQhK)HYhfTTr!{wkDOqO{jomMciTzYViz(x>%XRm{zE3XR45O zBIJcok9plZePQ?pET`)IFvZ0J`=0XyeJSD~*@xw0kw6OoQI*rABjv>_KA%NeHFLT1 zj^Sg%5-yFFU^7faUeD_^rf+QzWahM@x(=Dh-KPV(&kE_Jbj6Diy)<-e7@pxwX==C$ zn-3nm%Xd_B0g$G(aksUu+XC*i>#u)nNx~4NO27n%-VzqO>D<2d;t+ zALGdHOA;+^4$$BIoAZslrqZIseRer5x)`p`N=AC&fX*5v$McCLyqL;|v=*a^<0XvAmRZvr&``3X)BF`AH?hU=`Eg3*>ht{L zVz1)e@n)sv!>7R;V<;7p`nZ}PSuj~R;`H{nZW3LOy^!}v+SS^X>PzytTKPq~iDJ*8 z71AB)jNQRPV-rPjsKelLXWmjbay(r2TW&P}>%Io-^PSOuG7r=1lXo4qP-v5QQ;jmI zNb|_)jnL_d%mtH892*hk@$iUq>35}ghO5TG8-0ueDyHJRRA>d?!(8VheBFS5Nq=`~ z6G68;BiL|vG~B1zo(FII^5Y5EqsgiT7k{*Gd{jqi{K|py^p3wece75<5(i3P*2}_w zNL9U389S=mGXX{Aa6L+UR2o_;sS6PT@n8uh#*=lR$Hjay^rTLO&&Uxfkr^D{Gw(qi z<^2TQ>&kyWl%Uo6^E;oZGhEHSU|{(4c#Q}vU$qns+tD>G;StC{cCgRWABs2`&HA=T z>4TinLhKp_?g`j6sruL+s7cw+e_AmZ2j*xwC=(kiwq-xc(ri9$A#OghGS}^K|E|cU zcDpLjYiP0yaIa4qfnsMZ95}R!l)Opx*yYJ8&KgXPQ%`PRKIG|A{GFKMy32=T0PA^4 z{RkOI71a#A59jl*GW&P0(Shk=(z>8LEZ-;-Qml2fH!OR5liN3SWFEV?nXPzqm5}Gr zKTR-kDR-H_U?(@>d)oJbFEjvxGlT-48n4Y&9?{p<5qTaI#Kz9VJlpteA}=&)D>N2! z4TX8pSlor%)LQBalrQveK!)lL_G%g$;>v(5)L;er(m-ySpv4Zc_o71lYv=pPV|ww{ zZM)bnf&lFIm2!8SX}+t6%-AJMQIwI5+Omg7z3B-<^e%4o>f>n0nI|l#!T5SQyASWX zy9FVQM|4Ku}6v$Z#b$LmDy`M~m z??s2~(qmc^ks>=go$qB?#-le~AP#5-cH0I6bRCc1bc`$4^<1GNE`$E0JHT?tI;q>h zN?wRxgFHF=T$*6f#H6YANZs1ZPz?)m0a6=yRlg(@$J%Oi9MFr{j#ip1+{itHNY?sK z_;^A6U%&t=t>nUTWyDl>)Y5U0YJJ_4=*wmGBC5${S-`sE6zp1%rX8FhQ8V|G0RiQ^ ztM&|Ma~uYAZPQez1CKVgfswQJVgtz8;N}zAw4m;MSA3_?Y{^qzyiytbw3z5nes)0K zF8BRk0~h*Uy=-1^OR82dNsT)Apm%g1@ucWg!|`xyd7H-1mGq{|0EH)AS%kw8W^dUh z`N&mFCST1sj`GjN$4-SwlA;<4drq4EWJNUn|5^Yp6X zQm}`V9QnAx@K$+yhmHKG-a6KNe{pD3dwmZ_hA#hOBwlH`UV6sdqb4gkzsY^0<0m2t z2$FEFUfb(=;ATnlpSS|$1Kp{6wGMUR0@+N@hmVjBTXK9og+J8N^mhIx6ZZ0#=h*p& zmB(+{TL4r6FBLUgw1W8$E`*|pq6Wfo8}#nj>E)g{hq5=TxcRqWr_ho<1C$?ZZuB3#T?Cy zX+O&?O=#6&#VtV?!$tETIGGO>Lq$&8?|N@SlTJL4DV;tK0(hJ=`X08wj~qVN^1K%p zbd3zm(%7Y1D^TNGC0O+TqQ;jvd>9@Fw~4oFU@in7{LLX`iEf0e8%0p%>S#W`IopGt zP6D^_bBH9WUY!WJ)Ofq6T{@m%1i^kx7NaP(H-@kUMUHtmFp!Wv8ZvyQCn&iUN4Jy0xy1lYK&;KfUSSi&_r__|`?g}B}Hb@aevq!y#%*}nU9jAp288Q0sd zWRrxZqR8Q1d?q~xF`s%l>pRy-lalwr4T7m*{xRWPHM`o01!^Hk>6srYl&kUl;Q$X# z$*8-oGWe7$3~9_lbU~4v04kedeFC|uIP5$KEwtSEW@MD96MhqIIMRxv^1fYrE_D9= zBH}qLMzZ>i3Rm@h3JO>ah4V1!c-u6E(aZj*pOYr$nQ!PfGW8neY@k&>q9SI`rN5g$ z#QsES({!!g6Kl_#x1gJk(;=eFch5r@!qk2svIDDjmWUBCtX3VvUW&C!^v`uE0LUu_ zR+A0D)!|F-yDbWkz-FaDl)O$U_a4_`k?d`$5TSCB2d!7qqmyCkT$-u!XjH2jUrOA$ zalV1)u?#2kiGBBtat58k{3D%rvs{Rz{rh7s`p~o??X!U60kbDQC2{-l{s+90bA!oE zr|0qMC*Su_mEi^5I44zJ6>nmzLPV@%?o@zK*ykH3`x z_k{8+CP|rp3Th8*_0wI%$Gjqhy?9Zang$K7wl}~sep%CaULfRH_!AbO0lZ~tew+Zx z?ft@0n_krstcEdt0iNiXjwpC`AutU?Pr?9}u_wJ0^3y95F3X+0H(sK0nqTw!WczAoouI)9y; zMERu3W$W-=Fvwjlj&HU^Oj|`kMK(NCmo@JcT)N9CHg}IMVp`LBqekiTscYDX>SmOE z>aJ{(R)@^W&f4w8OgXh-cx}Um2g-^nzR=7)6Sp~8HamTH^poMD2oQxJdhPf#Jh1#w z6)t2rse4Hr@Uc3UwT}6dTr1zJS^|(RX$5h zQh}~2O+}UFxX$|vs>+c6OQ72e6DVHbYsie8#E?4`8E(O=Q}TK#N0}QjyT@K;U)p2A z31{lnM%-DwDX)vPEVH9B+rzhE7=&CEkRf-J~!dY@1F))dyI?n__iqemc+r5Rblo@1jCdiDeOB#P$RS=--fS#qgcKo7G01?~lG}$e z(j{KNP;Ryz;bG@npz4%i~Ym8FmaD`)H4 z$iBon@g%`8%M6=~?K)l5Vm!nT-4ub>3MyMXYt2vUT{2>71pj>6r-) zP5d?#Z=ESw@CnThnmECgRa^mQx9JzvW^WQjA%EZJinJiIL>ExJW5x8s&vCO#hMIS` zR2>Q)l!1iAF!1Cv*&Fu00|Oc2Vh2 zw%I=gjLZ1d6L-XL=C7OnEYUy&|({dvEF9C9ToXX_!-L!UVR|(0JVQ z3o7}iccQ5dVnkWGUTHiY#_|4>s)3oII@Pm*AU?Znk!mOYaKy3)FoXGvS4jCiek!?n z9+9Gt@q<%*LsrSj5AYxA^$Una3_&S^ZqRq5Y6Q!gN-uAXkZ2m9qUNRaTqb(M{MUCjLVaj!1-$fSQdL;GN+L6T8+Az#XFeY*f3 zdNEZy;Z9fA9rRrqaLd#qv)KVANY9!BkmrZeM_HwA4HW-l&x4@4*&9tV#4aDC$)hqq zCCV$%%SDjeQfxZyKlgeckNKVl4L-hKWSr0YAH025Dp1Rogjtix?YmUZ694!-F5OdK zupwmm3V95B>qHbHuUAbNSs3^kq&8R!U?`59yMLuvWWWHmskgT}C)yf%OVc8uDfFt? zUz|K0BXp~NK;xF20-$0HEQkv`x!g#mOUG;wM@h@hyiJ|iH7Mol%c{)vT7|hs+RLW3 z#GN)AgvjwD7phy&to@HG@xa&S*#jMZyBP&|!gBcp%>=M|_G^m;wWxoSof9Lj*q@;I zqdS+OO|L|6*`D-{MLId95@h<7i^xZ|#*EIe0Q#H`_VJ&MO0**QdqjaVSwgALthJgy zf9J&?Ch^^OVZdi|@bQ*8$aOoX8fKZk%oIAFT{&FNY!q$lW*?$_ch3bq`l9d6Qw7P$ z(O`O%KmWjA9DZ_Z8GD!SQN&#EXV&RMzLQg_U)fn7U@}m`H-56RA|P>64>_`%IqMNB ztUn`ae~eb>LF=9|(f(V~DE|{yxzw()4u)rJLN_Kin$-`>gFK| z+LX*Cl^hti0RrG4yFF)snwc{9h)I|@M8VUb6S6<_;EWY<38u2v5NIp&kT7>>cTMu|Ny<_eQ2C@gv&p1`PHE5FFu)NVV(Slu(o=@Eh%QDfj(hsBMVq<#I9H{=QN@u3C`FwZ=HOKq>xF29FykFjol>Nz^xz|g_|Pe#DVgt|;+#^WyPWxaw0RtIuOd$d(+no zQgUoP7!AqTca|ya!#?1D=g1EfmHr&bZKq3Gseyasbvt|UWFh(FUYNT z&`)aC)@72R(=|mlGEmKL-lb-pHKd3K!6M*sOn5w=)zo`zqqj?s9q7Q?6L3 zbiz~@JuoA8^bS&&^tkB2_wBUV?F@Ld5L8 zd96)P@!#2%h0uhuVo*cy4At-^W<1d_Tu9>KE(o{q$f89-tYVws`O3&-Bn zYj+BjZo3g3x*ArRbP^rbe?|^_v+RZQjnnx}6zpCufuJvWY}B}~TR$IpjL?!ZEEk6^ z+G%CnzBEjzp$`>^jTydgG=0+l;9uVagA_9IP0?O`m9aMcH(7k0*AZ&(+|>LVKw_+A z>G%XqUxy^iuuT-96nw$@NbPo}Pqs{zHC5^rho=LK1I=3TF{b6l=R8nPoU_`>%(3{- zYe(zUXs_%yfH$Z)$Y8%qeFyuDb!})B8OY0KV8!7DvCmY+*0TT24{u2J@9>l$i)g$k zd~Cb=ILWxD{_^?d@tC%(+Al#rD)V~6VzLl6p?!u>2Yh#bBw9f~Z~Ba~|3k!q zseg7$1~R4QO1dz#oX$RLDVQ4 zYi(Q9%axO2BEpUw|^L_cCvq;}~)K-XcF;srPLbR}zS@yC32&0ZzIYC8^KMw;b!1G+5<1qc=$2I^PxVW@T}QiHvrVSWxsR|It6x({EmTc8`KscH=FdlmkY28 zN@^;^+^Hz)hlj9uWaTVznOJd`sjk__&G2vYO#svJ7y#nupx~+6GxV8V2dRGeHbb^VRQ{@9JHRlBlg&v zX4xYm4qTnC(yO)9`cvpLvgV-Bpi*G5d~3lnJ>o&O_S#%>!p-vJMI$j`J_LxL=_1a7 zUm_05y6$+j5QX94MO&^p)}mw2({bAk>+w(Pc0t ziF(y!qU+vzs|q!TQV}k`gf*ygSDj5c+c`?}uT9oV%S85vq}J4- z(q17A0_KEOuLyKDcL9wVVY9swIL+p)sQY^Rd`8oE)o;^t`)R+3TjL863&qB-fW^H5 z+5L-EsYdF*Ni#saxMo%6=DKR6UotW=xb{J4o;&dnFS>F63dYkL?%@a;whYRHkmTpc z_L!zy(Ti_)kPI%Lg=+Pv03P(q^75$HuhHwzD8aSH#{%%rK^$prGE$$DuW-Kkc*L2Q zMl+4BHD3To%;-bpSfFBZCT%Yx@=K>ouZf6%UL8){%$i3KuW%H%IQ~iqmT#(ZzY0D+ zPBH&DH8w*b=M^FtX7)DP*W zwv&3nPou_weBDg88*zb6ON-!r&Dm4$1c@9d@ z`#Opfj+6o4lAg^FWXP zdtBoshLTF6=QA&s4BN`vJe$tNtiL}4ddQZJ37s&6Vs#=^mJiCpiIRkJacw>f0kob0 zMfvngFYtTLQo=%5`&bhw4>VZfg28Gvc9&(#i2p1cNm7nR&!UdAB=5UY**?KMcI?pf z^{;x(rj?-@=90Z-w8oq9*AD~bdu>o=&_FGQAYI!>M$`~jHK#OOWaL%BNlxwsZ169T zMX^jbo7+E|ym@z@Q*I&yFQdyhkjB^wa{|ayxHw)svlmaBDn$}z1TQ^jFleBARIo%- zo{Jd>QjdCO&GmYWoqD!vO7%NYTM-JOQGk*IkCx_$soFy1;xD4d6ePE`2U7qtiQ)e>(GGMWb%oSmFLP6l2&oGy# zL-^@%RwU+OLGeu1ej=MXZ}$WwBm_Nkp=7njQ8vNHvVHL|sf`Ev&-xED$f4}kRnfw} z+P3mU#`aX&WwA)S6xM5XjCzRVhgfgMHevU=Et%HcS(W*ywG(-|`zq?PU?L`-8iwxq zz@r>4az={|;M&$XUsP>S+jxzpV1)DhZZFP|qEiW1Qyk82J|w)Zq*|ag^P8CG8=RRN z#@!*>|Mihc3Q4W@Q~Z zWEGF7sxTThvu(R0m=71ekfmHm(u;k9+9-spIk^r zp0%IA#^hl_4z#wp&8>f=cjFrAg^$va%nH7X)%o*uPBqQ3%h1}nX7Bd3BER9Y5Af!4 z|K-Xfjr9E77I22H0P-cM<4iHcr-4Aq^~`m@`XsXPY~=&S2}Y-%;x$}DaD-6gNSKtUrH@}WPIsj3I2<5^+e>+c z+Kz)_8l*z$D>fg`z76T!WsIi6MFF24_l%m>p)j8~XoAkp zwW5KE#>JB?y`_d*lfEjWAA&NIZA|aZrQy;k3?{c z$AJ&Xl?y)mo=Ccq^w?|JJ1}iaCrP9wv7w31nt#cES<|PTsp`$70~9w3rbB~=p%Re0 zX%`v#wyxsR(Wb27=xql<`z-3cw7~}@lzf_}PIS;0&P~XZnzpfRtS(on-28-u_zgZrDgY;OehO6UzWL zRhkm~zGgAL;0>~L0A6L{eYTErD3V{VUiWUC_!L|n*f4(aGmKma``q z6nbC|#f-D8=_CW&_SM71U3H%)=9R=%o*2e0`rhPKGoS)Jm$pWSa42L!g)5 zw;B9<=SGd+xYe-#s3AiWj#=%O#1;6d!l5jmLCw<8ga?*#lQME+W8b#xlD}y7 zx)0G$qD3nO)FKl9NUaV&un&nd%O@=&Uv=B$Eq_(clchKR{yU%Uk$L7g zzW?0aHoy0*{%X_ukCo$PXA5gNnYhiPX9R1l-kY5y>Ug!ReD5PL zQ0m|B`gar)uV)DN+p+&wRDstikD_!#r-QEN4Y+Nvv0BJcEKR#r5t$*lQ>CWz6x3kq0>sR0W2h5UVcyS#c#D39|no zd&Dm35D*iLaF+_?1pC2^z2KlH^hXISh=uocwx;yg`98wNFzDUeU`t;1mT-i56}3Qe z9%S-iAgJ`^UxZjp^^KMIL$zJK;cG*%krwLI_x24|NTRw?|Gy;WfCF_nv###@v#6Dk z1Sho2?+v8tA{fWBUIwU8!Hb5=7NTg|Q!z2Hs@`=)O{X51bj3-ilNhIX48ZnNf^Ket z1}f&=r;khCe=F*(Jm~nwn_IkV9&>?BFy`Wzk97w&{XE5|B7d1E|$ zOz#ah)Nb+7TB^0VJf1#Bui<0?PahQK$Y;f%g#Hrbx`0(nVFFcVWl=1$vVD(NfNi^I z;Q7uN)dGhEw;@!h(p|+IehmcW|Jj1J&~M*O+u4{Tatf8x%H6rsS*}K#DP%%FpxD?; z2EGW63Z~ppuG(kM$jarueAZ~9o2m3L-s|?_IdO?XpivktIe z8j|PX01w^}j8aEU@A-eqc3Mwx*C8yiJ-lCynE=1 zO$TZbFbZcrCR=}pCg5i9Ao1=Pv2=S&focV30D1HF|!UnzA{u$Sm{ynf5KN3^ic zsy|j>pX|a&_(WRH!k^0_UrDU=NByX8tK&246y)dw8vLc52}%={i@+j;gN0t75-U## zH!%Q}1*xa%4-%-dk7)oJDp0F7@S9WJFSmKb!Q9b4X!LY|+uw9cBUL)ZpeCm)1J9k< z&}-3^i$!XaH@yQKQAvQ6B0|y$yc1CBn$FZruK9!x-=QkC_f;JAyv)0Mj_OMHE6@|1 z*9wl^olSaX{f094q*;+&$YSCl8S-ZxB#g=)NJ&$h(PJpo2vwd&b}Ek#b=cU^oA-mp z={gKnG`KEdex|5Ig|=}}xdtsHwf_e>uIGb$)<0X17T7+=ATxWq28jsxD{|}eCfu8s zfGoHNb>q#IF_YEbj%287_?HaYu3EyPhXDM>6IfwR8zm_M_lPCXA1C*%w{vR1|1MoE zH0oC5(>K(m_Yip*E#}?D$}-?1P~oJes`x!M>lW*%$K-(^^i&wc77fnK+sgq|tJU`5 zAyjZQ0&(mkB1#qa=8FHXyDJZ8Gkw=lQ@V_*QKeK(2lZYvW_5zjBIi7x=>=00yz#hpobgGYR%ln<&Gw2Y*W>}g80t*LU|3ZIc%HA+75TbV6tliE9r^MGTeMyT`ya2Bl}e- zzpuZ{;>tOz4juPV6LL*JftXA1+X=WSe~GeY^oA#IaaC}s>N^1nUdmo;c;0ata0NK=9e^^s(X`=@j?4 zs*91GxXAK|d2&sx0l&EM3#DJHN3kXgCRH;g_uj8z?g6Ipnh7;WtZ$o!l27bSxqM>T z1)o3l74gt6yxM2+v_H%-W1?CUq3HT8k$l;FAF{)c@v^kVH z*QWqmIYC{`_RjQxw<^g7@DtBuu^w5=-Cy21x6-@c4lm`Jfm{g>4@J_Ba+WTAZX$0$JIp?d;dM=sv ztG(e;R@wKo_x_=*gpa$0+)kOnKfF-uiml}^)!O2s>Lx<=!RNALb2CFhQ`k&T+2E+J z8J)rDc`UmwN$uvhr;W8^@SfkwTB3Wm3tx~5X$8m8DGrgf@#PEA+?uuH5#?qRuQ3XI zJ{;#+K*>4lqEe(*q$QelPW!{ndHOzdZANRD=|9~oE-6U5(p-1Q-7?#o+8<69&=&3m zW~1bFPZW9E%CzgqySwN>e~eD9-f@i0!%X6B%#Ej0LbKkCKwjxcqKcdsFfZ#2CE`4t zfKqet*u?i5<6L>|*qS#x#Vl@nnUv)_J~%aIB9U{caBRr}rBpMul(LK!!aKpbqfX-% z-#1?N*S^brfa;ZOlo%1?@4TvkDoWtByDhZS=I;c$lM5$p;zth5Ld5V{v*X;Rot}Lv zzX_H&^v8F$Cy#EtFi%lg&_SjCrfEZ;d_jyE0W~gBA|HN{(r;A1)j^v{B-3*+3cd3! zk$iT*$qtsas{>*fgQ%DHKfXlq-1E)F+|5$BSo=B|KK~Y+1Yr_ zzwU|@%g8gXrcX@&r;Xe8HcapMg<)CR_qP!G6tQ+!BHCQ*GC`zRyj~DEo!8$z}c)^WWa*K=Ob+J)(tZe+~5TZR8a=h$O$%UWMw$(?= zAdu>OZBy0ed+KkE!t6iYHJgn>8x&v1fezHhB7jYn|9~5iOYs-+I;z?I^dDP7X9C>t z?|YSx~&c5a;j2=$m>QQ0l|a3h11%T9DH@z zi-xby3o7Sg?Py4-xes*8gdhWzJFayeBqt1h7)xg>VBGB^C zaB&q`)PyxrP`zFu)@Aik8)Y8j zQW3i}c`I82F>4QMCM!U{X89LQ0L)t$5GLv-MRcQ4U(~`umuUhFNm!zPz(Nx9E|u z_>gOc*D+r?QWO$S@LKW9VmdE9$$nw)BVR`dxw0>dkZ_)>rH`1m&@c!(zxS8V#jbK9-!3)bNK-;Xc2zf6S}HLz{s;eQL5knKKz8Sw}uplpyA-q_i_^iOje4&o^DV=8n8_ltpI& zN$Cd>Ra8jcaoLsau;AP$~utE^y*qC9s4@j0#jx0vvuFH$+Fa{m`^ua zMft*?@Fw4vz9^6kwf2N+^a5{@f9AZY-H|`jJ)D52Q*5<_^C}bjX}r}8jp8wXgYot@ zeO62@-NdYP7inG&UHM}VByVA;5oTLnGp_8--}FH7mrj%^X*!7%k|kW|F_v`=`ggHGpb@37mtN+*Gvr(EgDchR2R=|L8g4 z2#}P$(eL{2G1sG4&o1f^m*K+?9GeqoBmlRITaNr0WM=uGK|S}r*ATVyn*Zuh{@p6T=*S#bZxK!RD-LTdI-<{!)J$)Gf65FddpM_niC+dO;qqu}7 zsJ;Frmeq?~h=5i#93ZzqwkCs7x3hxPnlyqy!sqDtoLxLPG3t8R@UBxhkNHytgevW8 zUaiNd-+;D6D062L-WU>S97ZrP!!hZrX`B4Wb^azwaFf|^?<$kAirj7$N!?s9MAB-J zJGFT&(dUA`c3k6>;gWN@1U?_&88!xb+_m**sX zur~I3mDvC?fe|A^72l8g3O3$7P$b14IYcCjaVZ_b?0I&33`QCc->IRXXPA)AgQO3OUs?Rsl2&I3|WoWE_ zuaO5}ecH0#XCbLvom<7{(P_axyXOhc2IQ7TfYS*|@j!~=ZWmd zG|sKMJ(VD=EGFzf=0(N14Hji&WZaEEtg~8Al-7o(As63a@*9&lco3_NVm!U;!TMj&TmBr;d710;WgK4X63DwFpd z6YwaquDjZ=Q@|VlpWrV^T8mY@?ivGV6O7pMaOM05Es^43S%3hK%i?OzWvd$Zi3W=S z<%#tKN)warKkhrUGL8kM71YY5uuIKhQjbbxozyq}1_Cj^a)6Unt!KP^1U@4_bZfYy z*mS}mP}Fw>tSbW5uNaJ&D7f|_IS3I-v?|4IjVQ0Y`HX?n7iZJp6AM1_9wR;rFVj@l zn%R4N!3!hpT7X4I*TKx4FXh41AE;3mi{RBB@T+=bh3~PYMO0OVLq`0o4{-alONao zOf?*bxKTG|KePkoh~UfJ$hQnso{j(Hvacwhf(ooRU7~_1E4a@I%5wwY(Vc3+a{F0G z09EU34-|!p8?8kos;Ws80-VZtw7FF_f6oWfg-SG zB{s8j$EiBa*Nl30tKmz(feWifA_(p-o?zukm4*w%qm&2(g>p%`5Zgd)X zzYI%}bfPD{!cjUR46M z*xUx)p!5;p%ph$zwbRVAiSCCO0^&oS=0=(iNZPJHz8!lS`iD1|?kLFXneUtHfff%H zTS+Vw1D=ihPYUy`j8qdn5W%CNlyRrHz}4VM;vkZOoy7h0?lGUFDWD46t80?dNYSPN zqXF;u%$CNn3YQwDql6~NCH~q<%w3WpjK2AI$aPBpYA}H7M|A(kV?#Kg%fZuC?~vAaw&x+XTxk zcHz}iM<*xPMp9z8mw3QlRh%(oTvH1dcNwqu9fBk2q-T^HZp-=#@bzEr@Y@DV`wrRg zzqApOcYm`E9=V5@kXl%(>}#A&wF)EFhPnBG_sBxhpKy>wKI>}~EdXj`L1R#hm<(&< z(Q5c2E|Za+Eu5QFkP}A3PSRIexnT`}I@w{gg$}^^lly9`C5mK@11Chg$5p^zpPnF@1-sL3 zBc;s=PcMu=jLBRM9{2B!ncSvXVG9CCN_WWbeIq zM*QyQy1wr};&;1!Uhntqy1H_l^Ljm>k8!`>ANS`8xTK-Hmx`H+f`VeN$^`{23JS^} z6cpP=c5TJq?3S7Pi+}AjRZ~`=*d+h&RdGr<1;r5x6@|0fZm|=c?oRE^ahsbVTs4Ka ztAdNBt@~ty`?)l>2GG-8P(6BJr~aFoOD8^EQT3~j9(6LSS5JxaJ*5A0)T!rF3d;{I zi-e>z7ruW9dpI#ms9YnsN8WJ{&Dq$TXo|5oPz zg5dwsgW~^xK_G8SgEH3h+%&s2O(&I0MI*)0#YHF9QY>j8vGc)63 z4CGQ_46HEC+P-7QMRj!v)_t>qeP6_4E{1Uxb_&!JTW#ictAw%c^YhxW;@|hM&MffB z6T@t?pgJ>0sklC7{2(vs55N6^*{g=x>V{`ZqVgWi%*+%O73C8n^3K`sN^Rx|=E%4d zD_G);*YC8Kio>UkI_=!CgMop8e@@;sN57)(L`lJ2>+DwCOlhf)z5T57dd#MvU%8O1 ztgK_j!osJf(V}QxL$*i(Bdrq$K7amvR(CrkC2xedaj4_yPj360t1Bz-nypBggl>U3 zDqdb*b2GC8RKBI9rRNeZz0F@8y&l4{B-@t1FGF6%S)a|#dn3_`bZS7-TUtectW>!*C`Z_o`ejxH$rjFcW zuev_wfz*hQ*V;U%nd@q6pWp*=aj9%6^s5X3amn>PR$$>+=*QY z=}Bjxp!ky%6&)Szd_ydzLN})FSmlq5R-(j>EWLpVPa!79o5Xg-_v6fS)k4I)bD^qg z0xNlW_qhXv2DUNF3I^=k8CSCNB?irlv`}D$Boq{lcBr`5t`qAu4hE_U&IQD){F{_W9j( za&j^?{o>^twP}~E&BNs58))DAWrs?bs;a7tTO2<>f1mtRb$7S?3{{X4JuPk4pIs%{ z*;l+R_|7Oa|Ff&|HlFzC(W4Gi-Azp*l9KMlK9S>>2Pljl_H=f3iin6{y%R2-I6x&C zXL2Ob3zqVoUH8XHqfXTD)yON(HGcUc|w%@W) zrv0dfKXu{dciJ3-Oy&EJZ{50eKysU8N$F6<)@|FiZQc4+H(JIKOKWF+rDJB86@RkL zYPE5&5O8oLa&<1MuY5`g7NE-L6n0uMpcM^t95`Yia3rGtl;jb|zoVuC$2e@{<>fDr z^BbM?bCqD_SRm^0^=%DPOHRLVkULV?&eEyPN7M$}dZ)|Uu77`MYlasUet-9q9BR;ph z+)!IvTVJoCqLM!p--L~uKHpH+v9ennJCWL)p`WAr%hftZ-^a&C$dhZzn=w#Prtd3J zC-rK_WSv=dlr?R4eX*I4P=7&Nx$`?e{dAXNU4Pq(PR%FoE-o$3E56NE3?eRlmj(0F zj?ntq#qoq^$hdJwMsTBabWAEf=4a!x%4r*QdR*X*I^wt3r^*!>E$OaNznBu3AC;$J z&o}$lHK@Py=L$=dU)~FMb`L^+QG2v@_cn@q41Q#!=GNL_Gxb8KAohe26H!k&D25?+G(EYyIDxb?`3pVTg`SS=y zydVC6i?HdDtaS(%14E8gGf%#N!MZ_3T}f0TU+t)q3ziTUiKMBi87R`<*Y`0y8|4vo z*(&G8jT>xxxQ7=THrE^GNXh+9QWuXk{U%>gjTX3-iScoId8&Q;>Z_`%YHHLpG)k)E zb<$`~Rw%dpys%ZA@3x4t>ud@zCYr&(~I5Xt&9mI;bbt_Fi)ns8&QSH>`YI>eNZ#G;94sact|GMpplP{fpX_Pa4eo+yhk`wC- zTrXd~jE#+b@q#Wrn(^4w?~Dd6Z*Ol@<@@*Vn~JH)JWvVaY7j;6`LldB&8p4YFTPep z|I|TXn(;^A`M1qhLay9wq`qs~375VfSLi=tUtYbbLmZy5-bi+=sw^-Qon{{FF1wE; zmht^J45FH?PDiVUhlg{tgo;GEa~=$(G7`M($n$X`Kca?UUcK_dU|?Wr@-%g_QOFeI zt3vPbB~Icel38|8aBy%?P{5Bn4h~v!M}_m;*M8<{@kDSaxd#0jr2nU5ruT*Vv8J-J zd#q_SN7tIelzq<$iMt=@y=h@F!a?J4S}Z0#B}Mt`_&)}GZ^2RY)2+welg5Yd1ozV3 zy?eL0xp{GMk)EEuFZS)*w`h2{{Qdp8rAC_hG<)PoBO?}f$k${~&npS##KwVvfddB) zxaFD$^CBUJbO-XEXJrWyL-^4pF6$~ND<9|L>hLH8K=$H$?ct!p0{`aM9epDxD1@n!Oxy#%Xc{I<-c1-H86 z+|gR^V%JzlR?}s+4KMMWay|6WYp5?|s(SKjS$ai~1TAg{J&lnu_s_*0SZ>A#R^=PlujxYX7CMTXPk4DY>t;S_joNGGu{$HT6WF0i7HIXoyR$SB*YIq18| z&>Ka^`31%2nr)LViH#CcQc}Xg96pEH*-id*>LQyuzSo{srry2#T5aR-pp#UPQsU?9 zBh%ANCYdcqq$MPN=Y;7dHu^u6<>RaE-?IGYkDKGam#1f;L3ZemA3shoc@%rQTj?Sp zyFI6i3ksxW?L)&dzA&iHV7Qu^k;9MujfEetv@G zjppX&evcmQG|KCA{`>dul`B`!lW@t(0p<{dqX&*Nk|NmWUQ>#j#@zq?TW|JiN>gX; zM+(})!us0$izNQ_wA4!{zLb}9a&T~Pat>xn#Sub7Zo5ltEh` zkcEZ*UBRvv#Y1Zy1=ki zPi(g8{J5Abu;L`aYGh=D=3ZAW@l$>WS-;~vE|ixczRk}SqT^yoglpa`0*pZK`x(9(9FWZ0ut*& zZ^f5gD~=a|Er2zFp0u>WDBDLG@TLXHGboza3PQsL({KvflFD!2(3GmPw`I55WHiq@ zh{~TneOr_ne?25;8K|^EOH0e~57Wsaoz&tg^Dn+kbOG*x@7}#jH9CLk($jW_E$*^) zeUw8^Qkl8oe%5CMzX62g&m^U(COg#hb<(XQ8{FDPL7{VkOz`Cb6he%`tGN6|Gg4CC zykVTW-ZMPRZb8UDW=PpFRK+$zUm~fA37v-a1Tlahq)_@9^M(1 z7%3AN7#I}PJie&b>DAG^u;AqB>4|W>awRgvY?BLy??}jErsRR@z&I-^P*hhpN4ixPwwAp;P%+tsnXN zRwWo48g|U3$ZMoDT|f0HC+GC()6TB0HMVljQbzjv`Z_u~9v-V<8t3>PeZDT?G;+z@ z9E2w;E6cUZ-Q2<9qpRP*H_}$u1R`;{)3tkYbTpLfq@3JFM&Xp|g$pxNPl3JAld&5H z1~EnbpiUmea?;Y$$PjMs+wW?+hUv1M9Jb5L$V{xBRG;|E!o+m^<#{@K`p6r1{5lEo zQBih5J*YE7alf1{_9|`{%%wJdonq*o+q~HPIWRljbTh;~+wJlPpE_<6g5%GO6rhmj zn_asoD4sKumx(v3X*4z}>Yy{g+)>qEOu-btta934yO9>>P(NN?)MDLNIWqEgm(xy4 z$_fdlrmJTN$BuZseCX@TZz*;oM}P0m^R~9OCMNL*hl`xYv4NjVo)#W$=nS`0xu~g0 z%+1aH^vTK9l_f}tI6!EAf7M}lBq}PZtgP%dOH>R3Wq!E9q{Qpm2KLmd(L$P&^L$E^ zyY=;q3755m^L_$`c|A^2i1wPA8d8SQc!la@>TF$^Q5aWB)3wW&?brXzR#mC^p1Z82 zC>mpsk)garEq!PN44|84L7&nr!VT9 zI3N`#fTu=u$;#f9WZ?}kiW`(Y{&lx|({){|94VAt9v&V60RcHV??aClE*=XX`OPWL zXmCqjNJvBI>V8_<-c}~sl%|u+fAS`8bBN!HSyogyw%UxP39zpgWe%c|quxSsPmu${ z-}T%3Ww$783MMwXt9fEy^;z3f)jrUlEaa$KC8{EOWOrvy|~RFadEty|J&R~POzTOB@l zaDQ*%=j#VqS)axKW}s3uG&DrL#pUHyr29T0T_@FgL!hMKj((~(PvYy>eVIST7i+|R zjkgIIfC+;QJe+pO*$CU`3}~8T6l0yjoHaRFR7$4HO`{wef+5RGP)XGuk}*O&_-Vzy z*o>jhMUAi|@{-UD=%?%48n4l@n{<*=Y+?varzQybolE#(mE%xG3lt1Q$;@0J!|5a< zCU)%j#LfqwbL5|Vf6~|2M@L6zdh;gQ>T@SEQ=wzWjvWB0*`fPettvj*>_Y`Ha`Qny*t+qaV~7Rk3o=qv~eqw5~c;Xk$&pNmgN z$`8_wzIyfQ)2B~pWlx?wxlK@!CrwODAo~DaMn`GY{xLM?MgKx=9$fD<@I0!np%EMs z67uB9clt8?B_ZDDFYvdnKhw!L4Wdo+Ac#@Y3_);}Fn{Qu-;VA4z9g$0<9H#+=mfF? zJ#&mGP(VF#`*{8*!AMVE!HVElq+7z#hW(4k%Y50o3bO?Puto>lAY@Eh0m<4d)TtlM&8Ka{S5b=qr<0PB(B2+CeE9U~ ze!*bJTelQmvaqqTIyF#!7Xx6i!XtM)fVnHAGo ze*Wa>{*Fq6BE-vUy*Sp~^`6e?9_dOA)<01>giY3C;Q@`@ewKrV=~ZDYfabVD)1W(L z?c#*sQS+Q19lD~TLaupLNni4QA(x6+%w*a9ZRk({Ay!v(ThVvXjc3Ut|-Bq&t=SNS5_qzbZ`2wJ5ZE%x)!-NaCWRqT-|_ z-(AK9FYgk#!RfOu#J$8GGbsaNbISh3|m{^)sR6b(p7d-yPa zf!Oh5$BZZIQJat)g#`s)H!@JG`!}!4 z5apyxQM`HAo&)U*my}f72Z2xhM*r!~UD4>O|(@SyR zl;>Zx@3ow4%ONlJ=W7BgVG}N%uCB!2jW@1eKjXa%q~R7Wq<(Vp%CEfyQRYDx}}(u;`+q zzX-(Tg#`;yX7@*B1Y*3r&qncbm$b`-9wejB*Y$E6A%%F4U5WQt9ZeCx({?LMPa{^s zeyH|P=mfU$`Sa&P0|Olce4(9$OwL`=p@yJi#?8iaA>=oj1fe@izYu3pb6gk+*6 zLz$bCQzdO@CHmr@fBt#>`t{XR9d}nZM@iOTRIief68D%=Wktn+;j)2&Tiuoy!Mzx> zjun0T_6?oqMNAC3`k-pny?ggi{85M?xq%Rxj8k&N#KonjrlzK)O^l7v4X5en@CXVD zf<(&56aiVyJ$~_mnKu4zKTG%by1Kj5#mm9$@(8eE;R#gc!s(JVgYMOqk&%(v{z|m6 za|w7=XOa7S-!k)Q<{*yh^@SAq!wd|AtBI&Ka*MyNKweNgwWLUUxU0g_{ZV;$w@?4K zpuxdG?6ZGh;C##PhY<(!)WUu>HqOq~2)5hgN>An8oFA&|VyibjwCB;46b(dRUXS5*bDs;;YBY&GV90(Je=!qSqUewTkvN{adQ>t)VuM`UCSZK%QkSn28eIYmk^XD~HASKnR1 z$T#;S^Oe@SuerR!CVHQDQj|SD-?NXR?DhBb+TlCY0{NoJXwcXRq`_j#rQy@k(!6v* zh=_~~f&9%(r{uDW3qLQas?No2bK5AyL$tIi5Ll z23XA^PE<;2OsbtrztwBCDc*ao>Nv(5w{H*TI}X>!NxN>WuM7>D&Az>y+U&VJ^|xbK zj_9#ChI|wRBt~&SFnjRn^Bt z%A6D6l2@VhH#Z~b!np8Ax6RF&4ji~;X103akF=oBp$;^ZU%y0MOD(!vkGcp1R{ZSl z7W8OA;D1-!o5U+y2dEVu7N&LO%H2Er44m4hAtp}W8JcPpC?(FC&U=6%vyvI|P_LcD zH;A8Z#hID5Q>(N7{<~;1E79D(e*JU3VGB?_-O|()fi!b2EQ#DyZh+V>wl*}(PjQY- zPsamY0N92;f1kYd&9o{nA!e_S@B6@#+3Rs`S@-Zey<<#8G!p z0b`fD^A#il5s1;>RSt;w`l&owzd)nP!Ci9blaVO}0ELX?-QcpU_fsbtbtXx&3j@1* zeW1$;K*^ZqO=8gU zqM#_7<3vyJI@dbslD|-hk>ZrF6^4DboQx<_*%7}O1C!I!(-RYKPCZY7GB?LYfIuL} zrlqN&0Zm>Uih_$vb*KVnXdWH~MImopl}F5=Dx}E&9Yy5)`IA@Pdn#JpwbPlDBDeSs zQ3={iYH2B%{l>y1U^ugMsx$e`8$wr6ep;FhU}1iKJ^pdVZ^}nMjZ3OgOHFn|MZ8jFf$LtXBZVOHS3y0NJqrW zdM^D)IB(3FuAb7wz{tqRz<}Sl(^VuXAV9#Iym>R!$6(y?e&KmSqlK!Pn(I_YzWe+T z9xZuSjgChTKx3Vm=WGQNP%bKE>5Q+S8}EA;skqAE!{Z|(Cr+HmyYHWynK_LQd7b5{ zqthb0+|ge{{b=Ym#{fySho~2E(nv zDx@0VlBK1`o!NtrEHQtPl`Vet>NM{nZiuYGj z!@|QWI4rttX#2mJWh2PN0Jp`(1M4YpzY)~{I^eqhA|5vr<7?B^qfWU*qOPtkScm`4 z!#oi@A|j4;FHV!80K;{N?1yFCW`1YgWcU7qg)C~Tz+%nM&9$Umqi16)0jWkSvh|*i zLB|c_f(nmmJEo1ZuIO=~7eFXvNyY68r#4UX9b#uLdM!{QE>t6kv-;uGlarG#W&4hY z$H#YLg|8SJd#_CrhX)4uoV_Nf@2{blL=98Z&M zS2=EBzCm6dS};2I#TYUE&P$Uno*uAsM6l8m&hl{Sb>}0nyCt7$4sR6j`;47mZ$&-n86HLlbySym5txpMNs9ouHmcxhd;&yGjQR4hYp^yW>*Gwxk; z--b|_P|D`U&w;6+HbBqB?D4T%q%fu=-QC@QZmq4OZKcM^S^*o9AV|=Gcn6E&&J%wG z7HCIJ$8HD-qvM=Q)^AD3zEJin*P;qv#Kziy)md3NbV`VxIC0@qW?gl){3St5-+l<-1)sI9&?=)<%oi7B99K*cLk*?dVZW{+N_B5Wg`R4;caa zDEvc58(q8TseIu)xd>>8n(bEiFbZMt+5YX)sBjH}8* zbYoQ0XSJMt!*1YvXvL?)mCf6C?u7EsBP=Y;!=su>3Z$ozUAUyA^zCENXM_77Z_C*Y za=brl0S#A5-fO)B;=9G0xY8|| zW3X2?+KF{X)S-cRrRt={-(70Ounv)CeXK@TL`VpA+ZH1V6dKe3OpMZhOdV=!Y9eDl z&!serpB%;L75ev9uYs}xA7=M$J0ycpSVP;_&oH8~o|BWUqls?``EAZ2_>j~Nfgj`S8STILc=)XOTLXwgv ztA8sRxUB5ZfQO*uZC_$si1_2sfIEESZ;tf zbF4|LZDA|@l_8re@tgUdujgf%_$)Lkmo67i%Ysmlb)5DPbcMP3d0rl#fgM!h4Gj&p z2u~WBnKHzwVdDA3#y|1+ZJ+gicEt!;LX>_w;O)}#GKR{=*=BVi-V2co9*Gf0nkp3+Bp3QylwBO_YroER7<2M#k21Pc( zb&Lv}PKt>wH7c_k@H&Pu zCugFOH>?-%4;|Nhd0@A#x_T`-nWKXP5UZe3!9q1}=6WxUk6!Kbo!~AU?jUK)I_<8F zr`5W+bi%lbjRmEwSKPu~#s8fl)E3^b!QH#KEKzwJzn-P1FwgpVu}UGODIo49f*?mf zor!Wc#k~}AN7FeKUiGWFnfq~yp{_t`^B9KmC{|gUzp3=|`NrB5>Zb}gJ07Q6hqu~@ zU3T~lY3F@AEGoEJYHI4cj#-;z^)d7Aq_y~dKB@-PG^}}bbu~6pM*7rfb%qD#YJei3 zr9g5Z7tl0}-M+m}P9C&2S!)aBRF;u@sd>Qn+$@^jCd?m^#I4daJExG@+mpTq>sDxp_9j+> zAVl&B-|+m#ZoR(vbmT4mKRL9?F+Daq>i&0;6r^+$liaRiPiiVEsC+EuS$YE4!?9l{ zv*OLQwSNuO#XtdvY}jf;uG8dLpKmi=c}9OX61e~?`?d0x|H>v}x#T>pzfG!pO4&V^%H-3KCgp{jgOpy(Kt!-{oa~xlL+_ zDQHRPJm^gbqYQ>;ykD>b3StrOy1U%D+~F8vE%;)54ov;- z`fMerQNZz+diIWw=L_t5zx0;-rR!M3jZjV_KhaX;U6Iv33E)Xi&CE-9EryH^saMIA zyFKHjl=IlaXj4Y#I@$f@Gpc5?I_$FnDgO5ZN}8#5qGoFIw~7i(Uzq;8;FVnD7n7AW z0vt0k0>b344|wvVfn1WEn9XWLPFhi9mm}b!_wUj3O91A}Y$l3UN*#SX(32`f5?!pFKNpxi*6| zu6yZFqz$AJEZUnlN>g+Q1Bm@-y+~BukxFlsFpv?lRx;bC*tkbIwHdIR@xTGT62&zr z&F9aT_el>M7C2d=0A)}gez-VJ@|kjsU&A~BIEg=A5;MO)GrbrQ!t4Q+j>Ntj;&}y= z$$F&EN@RU~y)~PDV&gfQ9Xm<{?(r^}o|T@}i;#*w{8^%4xc{$_imteDPwPGW%Vw zp-bpKF4JAI(^o!q5~hJ$ArM-=>o}E^o$Y94#RJL!YaSB3`%tv4&ssZy zw4a5gaOyGQOTfrjMp#%2bHb}vxp@{)!^!MSU%$X%_yY38)6)}<7?=dsU%>Mb1BXat zB#~}Y00U1Q(Z`<8M(nv%!t~QM)YNJ~JAmy1e3&o@`3L#gV~~-n81QLN8q`lUB-j!Alyg#mPf>7@~sXEzNVU&O@TU~|cKb7_%eQku~X1hxvH zPWM03(0!}Nd1Y>pJgvfftNYJ4ah>Ym7Lurl$oyDpCgKDbRBqwNdDN{gwouC7lS`oV z$p^Dx|Upg`oBuZw!@)sH>@gHe748eGQic8#xg* z_g7pa+<1-MM0g?gYikYjoz>w+1LZ=1my{U)8eLmi!N(7RK@SY1jYKpOEPWv;*Vc9v zI9sD7a%6tC5M`71HdL2Kc`?Ue>eem8c`?WrG9C*fK#Q39HH|{qqG^bg?DyDGZ0s}f zJ8OO2OC=0(F_l03GDL3m!p6IE33>g&(k~INkdH~-Qcfd31btT2E+@1?S9~-uJiQV3X>*OA@QP;g*R~3Fd z(sceR-_MP|YnhUi**4EP?3n6b%C0RmY5JhH1{ST8N|tis*9VTz5uxitSb;rff73ZU z3t0?dlILIT3lzkF0VNjmp78>|sZ<-W_88leYX%0XTJNTcmyKr)ov5MIV0gzsAA}Bz z#!F~=P8!Gat+fzKa>^)wV$R^l<}ng&{_@(-9Fv_7dO>@z&Zcocoa+v)@vRgq!z8Nr z-NCwO`RVd=TN|5a;;(n@+eh9Sl+gP6eS7vSOzql2@stcdx?ouP59}it2Ok}Tr2$+7 zc_%B|8R<$gj555fbL9%>>eDXft7iXHm?D}a@2-COoyC9T$g8(+Ef6lGj-T)twfy=O zE9v+K(iI*WmyJ!@hYxn3k}TqcqO8w|&%bNSzw-Gc(hf!|*?= zACLE7VjAwG-AW->Mc&4mNvrr!K+>*ti8)*+oG?a*9{1tY$vaaMytb(?0gD}ElLUk z5||y3F5!|zP8-a$f?mDUjy|36+5r~~RE3Mh@Si$mhebe=m;Rl!-5j#r_;&piWCHKm zK$G>KktNS!V+|otUb*6Ebd!4T-n#=3Tah=A6AZIAh_E-A%dfSP`gb9WeyWktZ>P(ZT{JX4 zcyn-sjj0!w6Zf}KqH;qY+?Z(CsO9wWotAJMss;3ck>Jr@mZ_rodWJTdJ7`STpzNZj z!+IT|dR0qH3zfLs;4sYF0ziY%fI_l_G{oddC<82j>RS>P-k(OzNYU*g_#w;0%p0 zRuGevgd+*!GJgXHl$3%001^C!g*WH@fl=v?Yy2XSFf#+_&ThpHu)-C2>BN76rLFBW z;3T_S&wW&f{L&3*Aml=iY=wUbRecf297%ye%JZZ5A)j~*M(Cn!s$*V!i)!y)a=e|V zksWZ!0?LFM4i7D)1*F#0?<`I(u3G@Mn(}`?jjwShYvn^65;3p$U&V72wzvBL5TBqnp&mtpT`@RNP3$*Ep)zFit7QJ75 z1rZ@oiXD9x(Anx^0x+4ms;dj2jD~ImS@pw*nI>c(*d1eQt|`Q&O8Jdh$l50B6(--U zuMiHQ`k|P-sWXGb(GLBJE{AjZF`oTqW$;yPZJe(RQgVd53yp`b;yw&U-jE8&!WoX1 zXe%i_`h69WqAM!0+9#ebqfStASAZCRYr?pIq_NT%5O-}Y>`@I9#q<#H5e0Es3C>A? zf0UfP7zj@NCWN)x5HNKC9JREh4W#B)!R+?}=0wx7I#VSJ6!#*?-tZ5faP|W269o;( zXym$pik6eprxRvy;h5ytMBm1T4mZSSW@a)uUj=CcSi$&+*Q5WmE{GAtTxpL53*c#t z8FY0c4T$tUKAW&w%}95z)Q>f%7N5Q#4g;u-nBT*Pd~eoDL2L2Y3Kbsb&V4a*?POqL zA~iM5hoeKGdE{qpS#OR1+lplsyVFMAnDQKFC>eFS@L}R$$H5?_m^w)AwPqrdosn(8 zb~NmA6Pz*b0tP)0@E4KPeW0J|Z)cpH$9}y7XeW(BrK%dpfHRywk6 z%q&~-`0-)x%!?9jgKz{&4({4S-Q^wL?8PcO4MbTry3_^nvCw44&%bGzN^bPOXO)$ zhDN#$pajT;`K?=*=8=I~@I2h(#;g!dII;=Yq=e5UhwgAKRAA(X?fvA|pAo*p*aIdO z8=i=2L>Z=b(3lN4HHFZYgIV1tb4Y0V?M+QLvs;IZvD{vRye2EDrK`N%mfI1r-1-GI z)F(xm>&Pp{Dsjs8jwQTdX!4R6w(06Jv9ij*NduG)_s;Y;mu)|rn!pS}N1iD4V}mn@ zm%owGh{?uWBoOIB_%&|?0w4s07IYzuQ@|&F=R2klDY;c@4(3s#q|Ee|3!?tvGfp-{ z0AE0)6KL#(q9PBHqQ;o77Iq7UGOyVRNN~^)k-$czYBmT%U}a5BfYJRi^La3*paa1J z@Up@bBc0_gPg{5kQZkC5VhRe{cCn8xuEGs5x`^``?1vAhlg5b<%x_li(>$y%21Dv> zCA&$HTccSvat4AO<_ME5ZpS%Q!peJbtf1IwRO{x=M2k5#_`$sYu43B_64@{jE5cUi z=ITr((;qyThZ!|~00rEje=iF~8Huc5$)q72AiQK`Xk;iO=|H!UcSQBezrTOKpr}|; z5y+&-J`WOx5B=8@Cuc7LpHi2{c=|TVeejT&c0I+654{*%kL)mkHbUZ9ThdThXN5ru z=mHRm-0kNgOTEfD;bjGO*|Tq7%cv7@G<;kcX`8K3!6GufZg+J%tWnsnDlzK1Sfg3B7{g6J%(L_kJ20I!h+lYEHZU)w4#EBhAdsAxV?5 zuCItI@JCPCefISpO2{E|k2&P!OR=%!s&7Cf7(G8~5|5Qdp$vicMCJQBFV78zu9uIk zm#4eQq7TWzcFH&6*)y-T_UfhExqtuur=WLm4HzVbV({Fzix-P; z=j!1Y;Z`zXF!zr;hoRo!^H%_z;^M@&Z%10l)iA7S)W+6U-f>7Bwjj4HaGsMN28dAA zB*sRRIfPZxVdTeATK~e03u!{#pDdfuxL{m`lNyZ(_~$=%i?}Yv9*|Ml{i;V~R8YFw zoT(8f#XWWl#n;5=?_$L-ODWc1y{||*o2F*@WX7($wWHH^{ z^~lT)921EQYPIPq^&wYun4BQy7t6+SH+FXZ1%|uE_Z+nZyz={S`{WXS835tI=Tn%z zkVwn;d2>sP@uUZw&>xVmw-3!N;zTQ2wyeW|e2}Qb?+lEqrt5&zIdtekcjB z{WsjTx3|Zg(#ZYkK}j7DE(5oNV`VYUwM)`{ZUFOeFIkwF(eeQoeBe0iB!mOWce=FS zagf_6+eT9aG#OZR8tq|yBryaK*Xn)^yqz*+JxzA$ce6l`odharhv~Q{(lNo04H}fO z1l>pdbZT8G>;eWaj~`PdHs&ECz(X7A3k{3hW&wDGn1i75f~$bk2-9@k!^(NLXv2?X!yfZmR>a$*4As2 zwmvwG>?CCb-Rj+y6op>`@+tyHq@+BsxiDY3VMq~q? zCSdR;GFa3k%U>t8uBN6i;;|wHh4ES70cm^ygPU0s1Yahl;xQWB#0{8W+*boiN`&rBv>vpt_5 zP?HQd$4fWHT}$Qpl5(e&ECNY4X7d~X(&LkLH zaOVD$%=|VR4C8Zim+--+p%ssfj}PwCAR0?6P?R~4&5VYWffZW7 zrI#=F7R>%aZe!d@$O=kRZKebub6K31rliq@)hj_*2{}4pMQ@LxF1P)uzEr z&>3OZ_!^=SFGntGm;zWk%#yy~t@g3W9K>NNIyw%OpJee$esf;lQSi;B6D6}jwledz zB92Ws!}kYk%?^@^LdwdOEAzvGK*7cr(MMstg|(p6VLG1dc!hcjAcd}&Wnb{G)yc5Xq#Rr>q)QjSAUcD<^2^cHNX zI6_P*9H@v>IT*0|LKx2WIb!yP@hg0xU0oaGQ7D?KwXJPwmNllhq){iZWWu!QKMx*E zqX3~OExg$4zxk(9UheNglS3-UQ4Wqih&e+TIW@yl2|NaGX}pX(7>Sm#W#f+@N5&TG zVC01z;uM0{@mjHur~RcgbHw zz;w-{sCHwrdjl#IiGholgu%~nybns>#-Pc@VESy@xSd27Mu^aka$mnT?Nu9dDgZE= zLX|?^64jBpOoDO{FJYAEV*9=qXPf2RX0F4Bb6OCl`c;_y@Th8GI1OP}dDs;rEP=li z!o=!NpPCm=|VSjcjcrCt}A{iA- zdHWBf5P}^8Af5M?bYQGFp@l)DzacDJurHu!60*WvK3nB%_)K)V8eSo-Nz8ng z`1j|<#QkT^&^}GBkhQ<3|En!T$2uptZ7Jn&uui&X&)Zj*7`E(CxHY|(!}I&8i9@>% zmC8>MS7x^CIl7&0rf747nouvhe4k@LZaH=s<=K)zP#SBnvaoo<*8_xq$;c>(t1nBB zj~y-;d3pR37rvb1`Y8|zWIj*_DARYIQ$zoKO$5H-LS0?`AVY67OxO^mS>3mXR2pFP z)&|4>Z>$OE9sHD+BT@2UPE<&^q`)z|G})fE{hOE!TPe7W44eGj$m^OWCML$lY!Rx> z5Dav5aI9k;I#o2&@csQ5J(1td)U;@&hX3f%EfhTi178Ov-k4Zgo(#Q!UI-;)*oE&3 z3f-3vMI+REbhwePnaAbt1r9PvGOQb1tnZ^VQ;=0q3u^vse%*yX_% zVK&BhPyosx!3eishYH&R7JT;!{piMrBYXxWUXofm!56r2G9Sm}$X9Nz@KA4me|fJR zh!nnd0e4`dien;kp<5EJYj9YuZ;l`#BoBHeKp%)Lw%St~hojZm+?9DaI9|iSAt)$+{0h!Z!Ra~(Sr_xy69=ri z;0y%!m1YxCh-rs2=S3Zc0|#&>49-pa&2uljIM_eXn&UPC6zIq!H%3Mr zr_v6A9}5TsgILZQ;R`A%w7a$gSYlq4(gd{_tOrV3Yu?mDeEA2o6DB^rvIovaX!K}U znBW{>V1Q!r^Z}?28YULKBPeJY?{#;vSyv|Jd_Yjp4vM^j0te}*mZaupfJxs9Q=Aqa zI+Oen%TyV{E^?Byys{ESi0Ck=`tomUOd7a0=0XnAkKbXT9bH}H?L=Diw0Uqq71wj6 zL{NvL4RZNwE~aj7c?cym5rDpojD0JXxSP|$!gLG_+@Ti|zd>QcfZNtqkdsqnP9jLj z8iD%X%o4%v;S_!$skiqAo(Zx$+7C>vlJns*TCkl#W->8h|JZpyBt%nL*?g+`qaU_O zV#l$Lqr3ijwRx5UU$dfis59$nUj%v;cG=OU^wjI@Y!O74xHwb(ruOB_NB8f7ZM-Ac zx&S5+y#3KlM?|8mjLfk#4QdL=^m-`is;X3TC$&Czz@C8mX=2h{Tf67oZ@F+e?{z(6 zIC(Na+j1J7L(C9( zdBa0P8=IQWm*{~IVn4gow}w>>fYPA_;Wo@V-(WD8w)j$0QP) zMi1`!hC1{4^Nspvip&A3$iKtiS``-Zt#2oE-ulzW|;cf zsupLMAvh!MU?@SN3ta!v$nqC2$cnafj!{nqO-(_4!pj< z1kz71z*K0}0NlS2ouGZD8x=kmj~~9MgQ$t%)kVin$@xSQot>Xw`?W2s$^&r&?K^Z* z2PG4~s<;tWuY!-qZ*q3)@Ehh`Qc($Lx4#$&FC=1dV!|frD$a*B;&_0N5W*;iW%D69 z^iTe?+ZF$6FhWzpeQRj!b2#sRE&&nF&&LPPfVn5t+!bI{@J4vX4yt8+n~Hhqj23}K z`7J@~SB}vlsHCGz(kKpKptgWd;)w9IVjP~-Tteq+lcxOahG{Jp5eLM*;MWD) zyLXR*P5pPy-cQB0KAOzOwonYrI55*Oe_8M6BfyJif`Kj6?UW&SAe)<-wozb~)RkwS zSX$bR0$*2mXO$!V1{xgVxx{U@FKJcR@i1fHRqWelB;FmV_T3}_Zp^e&a~x#B(E`*c zoX5oE{mhZy?d=W4`onv^fBTHdLDE!5N0)?unhxMG4h7tF3Pm!bgT$6=>Y&CP(J6Z< zz5VQu;Z)46IXM%Hidb72c#j^vKk-=c`QLgKKw`W#IuVQ*jMj(-YwMb7I$O5oxj{92 znMB3snOD+gY#ob%%9%88JcL#hQ3+bPV+b* z0EXvl(Bm-{uCC6&)Z*4sv;xOb1{=H>iTjP;1Gxz}O9>fa;0i}*RAeNnvGM4NAS#b> zVW`scZ8uLv!7+RE&Xm&1Oz#66(W|8tGdOtgAiU(WZp~@fjC~aTIKH8xf?jhC-II88 zMgGCFbSwnJTf9E?FS!Ac1^Tsf>)4|fg~<~O)1hfSlqVU!N<%DQ$2CPeruj~BC+ zU~+bLry^7rXJ>`P#p7E9Z;jy`7CaSDk>M%x^YaU(j7Pj(u)VWqXVb4=4?kf%KzPY= zF(&l!Fgg|%4|5s)T$@%*nk(PVXe3+$|LHFE38^sU##e4|aiP=U4+ooT3kwTzJR9Rc z3JQQPNZ~g(j5H7B#6}%Rrl7kaTU(n|+QH6_tndJ5HpI)D-%7;ymjRk$`1Dj0(Y-NHMK8*1q^<3Q z5iVfgkV#@z)+|oNyh}-meERfEVj~*GT`w<~LUEAL7zqIGX<)E6+pi4RhSmh(_ef3{ zmKm!C8U)t{E^G@J5+Iqiwe=PX1TYxf&H3A?3qUP2R8%kKmY-~cUloi?G2zm4egiWr zE2*g{_{5CA_skqYm>)hI2QrSYL9>^BzT1nidl_nh{KlULAtAOXZACvGWWCR>9=47D z*`hU6{&2-Na-5&$6pfv>^LC1-Rky&vploMx!T|Rd>>*etEIuCAlq-e} zP7+RLoYVVnVue6KnkP0?&&-_K`QTcfT|!`B&7O5PRy0P;wm3s};hSyr^!W5XlwmYi zUj86rU=1Z6_H7u(=YA+&xzbco;Y+!kW=Hk02WWzrmbS;elH>Ssa~vPFv61mx7Cl48 zivOaQFs>4{6oJ)npSw#PkQCn`gVu+yNJX^(`mwcbpdO8Rhtp_z zWKE&aH6|wJxTgSfkeH|_*Zy6&1&FzTayTLYNQD)TwRw<-rAC+o-QkFoX_g+ox9aE5 z%^D@zT@N!$R;}Qa>F>H#T~!6(X+InbLGld>fo<0l(Ul^MwL!R_ay#^YF(uorP%3d= z6%-DpRSF7A%TYil*nV&n^4kU0eK?#3%gE6~hoTXj=xpR^Aa3#I{2x6&7dyMB8Y#Rd zPXfMpjs1kS2IktGXW$;7z(F=)XJ5+>tCHPy~8;i z<-?#V@JZ1zF`<80m-gfUBO?qIM4S~O5Cm|TkCyft zY|C0Y{t0j1n8DGBvSTV7f))!k30HV{lj!NT(UB2=?xS=8ahudD(t!8{@bNMRHln)& z^Wdy&(yP)(kG_R*tD%&paN4jnc6YR(0ZzoVu-To*$fYtwx zsWXquaecS=(>$nTN>NHBQ%Hp<8juiWE<%(FAw@-l2$?F$P{>p%ga#6#uv3{T)0Ps- zSVWFSBoK3BFVOE_wITD;zbmL(Q_?}o^&%5 zFOVe=P255{Sjmk><%f+OXm)t)gaFu?!;csG=odHe%U7<9Dp*Vcfh$M97o#FZJ5bG^ z(8Y+8(4)iqCMPA?p0ytPeQZ&2aqpuBefo$~V#i;%KXhPB4|)GJjsXSzY{twfaSVRE zCO*|X^}SKkL>mnfF|J1xUlwNZMc#%Dl@oWrXr;9yYJ$bT*X;rK)*VnbD!8R8U~eAA(T7}64JBf^xVEMb>UC*Y_&C)Bvd=*$1Q0hlrat9 z7O-#HsmI_7Ok;rho~PW>t9XDTR@%6e@Cd=C(5G#pI`5f@`o#~>f3iRb7#nTt`&XJ^E4(dK1b$Yza3Zcmk4il;jkC%NA0VJn%D?~>X$9ebGk5vA4DDRAWM9!WzEoRT2 zO*02gIPM78cJx+ID+dpSW|C)j+3=x^t@-*Md~)$4N`aM-A7l#ZsHY_lOG}+{12bY` zrZJ1fM`n^O)i4Wh3(hM*SVTu{@Hx_DU0vN$)8`z@-EY^9(;bQt4-bY?k%>4%LnWcH z;e|Ou1f~IEW`L4lFU8f3TsCH+K`ih5aBOTMQuu)b&!nc>B~Ry{Sgg$Npk^rFp~KkW zccZ8HcaWEdrn$i|1f@Ar;Fuk{F?KvwemC;EDOeY!R8<@%|2RAULPKNMZN5RellQuH zmuZk=>@c(0kD`wg&ukhrCq??%vn$8}L}ZnSo|jx(c1@f#X?<(UMMkKA<#S4mY+FD8 zQMZ|xY-})ZX`TWXzl+P4`W5AR=T z`b0`qIe%NL9bpeOU0seFB?H%dl#x+7rXl3}??YPPOfJDL#7rR7(#)ltKE2G{9p##3 zAKq|Vg!=r0O z_%C-{UP>JWm@{aQvh&Sd^&ZrgZ!da8YerPw<(DXR?5H<6Rc*)ui!-0!GAl5|CCBIe z11;Ote($KW0c!mlDnGt@g(fwK56zs?@U}|rF~MdCS3gx;+BHgFbir6#I}vM*@pud&Cy76bCbb?C}Tc<-T-Bgad9Cbjn1%@0U`cm zgMFTYz*j6974nW&kUR}zrZIsDGVyWs=&_@#-=(Z9^T5VqmoAOS?0j_IvgOM`Ek);%|Chh#XMkl3wYWg)oh3>t*?C_gFFdF|R}Fc^LhTpRH=CGagu z2pGxG+F8`@2qj`lRQQNjp%AFUkB;=)x=*Hv5J39k4j)~7xb!g{8o}f{@am(ove)(Z zuKItv;`>(d>*VNrH%-QHhCPx##=N^Cgdyd@-osr=H*>(v@^X#nLcif23m#Qe9Ey#- zmFg8;SVKE^HZ4v4r5as?*WitR8@0Ni(npI}2HI;&Jw@oNF0Of)7YmYs9C{DsU9w(!6y zFn26y8dGlc2~VEPLN9pg)JG@};vGg6l`1P9jw#uUU)m!WD;i0J{_Q?zWDk<;(@q*b zxc5XM-%_a96uEu7#=QIx(Yk>LOi)%=H!B!3kSd7lWq)J>r47>AsQO#+adA1`>Y3I76%SxI7q-vfN9T4vf=X3NWFlC>C$uuWU#==Gc#v0uo!KD4++&aF07- zTRcX5yDP)~d%KCm?2#iiPHEgs?Ui`$+=Ce1^xR#Ol0Dqrxl}QB`a&2HnDVp!+S=pO zPf>2dkRjPmhXN%1eq1EFC3JIu|?Hp+eDNSzw6HDJ*c|f?WpHX zh7?Uwub%!tEdT+78zD+z>gxRZ2!Bd`w!IFGnleF3N5M{Q;z@%PW9O~*iDeBh^A^sZ zf0i@2^wG)w4JoUAePLq<#Y)g~OG|ESTFMX@N)bDK+JKi-CZvB93I%T*I;%wBeNB6Z z-%QSi_O|!G0;5yXoU`7MWD=ie_>LnTl5=m}ym|Y3PtQY?t{{>;#3M(lC=*wBd%p`l z+ig_B0t9A9j?f%!)ORN>)_?l+KDc;-h?~g$1$ytV2ft;uk3rLnj81}%j*cs^LS_wIv-XS~@rB;dT8sYl&9HQ6QGH&Uk}|n?@1p3&cZ@b{PHX#yts#L(%^qyy?SMT`*san6ATTh zB1cQ!d`!h={_qw+CMwK-)0|Dd&iSnOWBZ@Hr61a-NzF8#mDxEHCmqXSNoYCY&ncKG zY4mowOqmUlw@Ic$T*?H5cF3Y)qDfW&VJPcStCSp>XlJ*pe$Rbr`eH}Nu-5o>n{m0J z$9Q^fzIj8>n`Fm}r%&JEaF>;>p7}PQ^Y)o8E*5lT)4KgiommUQ{PxWodP__v16x~~ znITt^-Bnlv3ZNi;6Fm(%)6C4IWErgy^>#_gg#9Z0-~cNs>S}8r{JLmN!u0F)-)mb8 z2%VEdFdRupWdfUtb85V)QyWNA_kNuIdW;!m35kspU$`={o43AMvA+S5?rZMFo#{S4 z?pSrZ`Nt22yQ=xuYdj`WKhsv=#sJ5_JLCf~gHJ35#_;?ymoNVUGyvJX`S26Lg$LaVaKm9fetZ#;3t`-tkc~}U4Vqg3?WywP z_m;eKKDy%OHQpZzE6Pd+uHt}*KPCBpT$t3iSK-!`#}1xeA9(jQ*)+JeSj>*-3myAC zCIFNN?Wd;kUb1A^>(EmSjMTrl+FdAp@d8qFOy;$03blz7iyIq#tgM8A1vhjSgcmHv z!2Jr7_E;T6r46<_?s%P<5UfSSQ+tr?&JR?olhZSpj~L5B$^)ntsDPpk#qOCA5pq2u zL0@7I9N-E$OrCrws_=@L=2Q?Das}Upl4*F`?IU~XYMJh(_y_W&)M9Lg=)_!1`PDuh zz?%Onl$;g%OT_=}Qx8&7r>&3^j+G&-`_ygV?BMp+AGr%JB#hG~>;oD>#27H=G-(nw z@<2#ze93-o=kZd^fE=7C^Fq49*QYaow^HuzN3l+(flE@$@Zrj;st1LI zs4>UssH%4yKx8H?gQ9Q;X$Nj+4}YtpzboeKcLRtd23bG~Z##7o)$&9vB*!7O%EiRz z34=c29=Lty&gCmtVr2mug}-q~Ys;{KOBy_H16QOB=`#v^lnk4lJ^cH6JCPPe5zyLt zcwp3xGa{X>t1G73sNcD#v$OrDTVArLHkp_+qu*Xs%*g!|w`6*i>AL?e;w5wP0CVo$ zzwc>wgpmBFjv;ckR0(Dj8hlAYt`@?!cJXNYF^Lh`O z{%w{IF4;ZHh}?j_k;!5pAMO^1iAqPrWDE=ruZS%GKoIryl-slx+}Kqj=k{(2ljo^h zrqL8rA91oMp}E1dz5Eqsa+jghzDc}yaVDs=R8=-SgCpzjf8@;MqvS#2B@qY1DvB*Z zSTkxgbldRZ`zIyS`mv;d4}^Mr0O&C7S97PPILKSn-#4Vt@O6@lc;?6U))Lj%1n-U4up;#cuHI8-mHs>akl;gWC;&q)vO=4betA+W5V zA1f8N=nfvNB5*zM4#pkKaL5qP3qSsGHKL(w{Pqppjo%6t`;zB%FXGPY9u0|(5`l_V zoxl>w0DPh5FJF563fgCL95GK~agT1f)0`|ArRY z%)l@b!r>D<@~2P4P9!v9)34QaGK&MI``xap3cayOhCEABf%?C8E#!?H06qBy_>@;z zv^bcz2vSezB^NC?_teH9ww>;s+nIzSV$!6}^3sG0nGR~qS>F5QpD88+rT-E^4?dmU zM|J&)XL&QOHzav+RW9W(aLpy;P&o2KRbD-Pc~aj6u+d*AkUvnDURqJHRlgFXxgE4V z$u$*dAtIvC@NB`oBUJY&?;JwN~)9p#mj-1}C?>jL=H)?OhGaaRCSqV6&7 z&;%#0B#Sdc{$ht$d2KDrdE7-Kod3GE&{0lbxUijqfl5Sk`wltA%jcsoE+~)@9G#u{ z|C|>rz@f|4h(d&Fo8*xY`DEk!={H9su*O-Y_*Qntxbfow>%^k_XG_b}rpvyQ#@^Za zrTfS!BO|Xxj@{e4fA9XYhR!mPG3max`@r!7O_zN;Ix}{l!4~b5p<3G|Qwv&mzQ1@M zoT2X1r}>wDjuha|ffBUZdBW z7W5IF&H)h_0(f4w4No zM_Nw5{>)3?E_p`B+r2Cf_(!Q2T>o)naeBr5OWF$qU1mF}2|kPgS&b8VN;oL0g-6cS zzGxTHNeHt^R9)H0xaWkKlT)M|<*oV(dj$3NlI_c?mzfU=kd2eGQ#3xaLIjmyC^D`) z&gaXfrposp-%V5V-oC|SR83z{t%BvCSu+V)br!u6_Mf(6WIe`G7!nzI93R$1!%g-fy6O z#Knu|9O;1V+0G^=S%~rs=U>@d6BNM?A|M7TIA;Iu-noPJ+|tNM5YiduA>ID<7Ij&( z#c0?~-mRTBE+*9g-KkYyb|G z?!|jhyyslKir>9$wpPR~;Qk{qIofluc%w+7c|$=%ITB+B?b`OUNiW7u^U$^fAP%vy zs7zTlv+%O-Tlz9IWAs=j8&~{HqNOLirH8ENn=>%Z-@_RUYnTx^jbR}&wB1~_2IHL zqeAMwo(=f&*}isewOP}``5RuWynZd?(zIV`#slM9`gbne?&)1py8mIQ(>I@xpDkrW zI!f$T&NmXS2u0DM)8ZBeM!b!Z@|Ww{c=TRRlxwhOS=TSQB4!7}mKHGJf564Q*`#VZ zdHaqXz0Cc+Nve;^j(jUioWKi3+qLh&0jyLQ`I>_t9UheRT?#g!Pgb9jFe>ca8_HsJc#O<^6QPOn_CU9TnuDK zj*Rhbyt8j06?jZEC61=1#nkPxWK8_ym?Ohk{q*TciDd+|xlT?jw7@1B^XGr`<0xM! zcDFU%wk6uI4vBZZaN!1$fSD!|J>9#1fB*m=3a_0Wn2Td(Gm+eU&pQaKT?z}oqFBb8Ku zmOg--j~>(akSprR4>>X8l*-} z08QR`QS-NI^~iaRU%$?CcE;WmO-WFt1P4GQoH(9Sri8S&jrLWIv@JO_f(f+qiHYIY z>h2U3QTOOv>`LM|FlZj;nX?uw0BH-aEQ-XPeY}pUrj{08pm2UXdYKzd2kX-qbhyG5 z&B^(h`s69`7jqR@+#Ww(Y{|_HMh5w%iP!WMJ)2P;cD&EQ(x8Pioa*8I`P1W-uEQV0 z52aK+A-j*CFd^%@^*`w1jvWgtxRLgZeuh5wnfVBm0whoBO~x?Xnz|0y$C!oxyL<5z zlmtUMSG2)sbM&>=F&M$DOGfv5X-1y=FGSz0QTV}ugBmcIyP(7Z0R_@wZYYqS*{igZ)x(AhNy5)>k46~E)D5f+ zdR&tlv#~5yaVAL|%?Ye2F@wWeGrY3bMCOIz+o=5U{NmBk>c+OM*YQ##GG|`6Kt|pb z6~!FwBIC}^$(Xx=&QKFSMCb7GCC*<63qPPgLFZfag5v{PAoN!)TriX1OW?O_oA2Pj ztBTI(L?JAW7N;i<;B0*UTRH0-2}^oTYN6eUnR%5Oq=(vRP$Vi+7{O%LO9mC~tWPcUf^hHm^5$e6 z;Lqi_@ffhf3tm}xbDhN@AC@S)eGwQc1d++zF*$x->s!Qs05EO+Lp~yHPRl_dHF7P0*^)GZS(eoqb z&78@6`-nviCHL?7RI zy}B*p-^OBfY~_B$x_lMB-p1`2VjULTX#Eo&vIdSiRw`t^|4u%u({ z>^|h3f8>R(!}G!6Mc3Da6z}Q72;1s4YsQV~(;4XuS`uxw_>DSG>DSgn#X#)Ny&xZP zi$qS-?mM7oxXp1&U@&q}7Erpw2?kDqznsilMOIO8&{l+FO*LkQ^QCHv#1`Ba=&xCWQPp=nMP=(P5Da;FY z2P*c87Kbqb9bD$mPicGcF2o|vX9HH4FkLvltiXCftYXGBnIx^YI}EfHxUczvK%60$Cl`)+Bzbl}<1gIq-5t=Mz^4jki)Y?M+=q zD5Br^_^g{g6FH!CG@MNCzIr7*5;cXD|FyO*My95s4w?xmf*38U?OMC1XBOBOz}Hi4 zE_8A-d(nN9M;Hh+-vuQ!z0UN)*k3=108n}q<-w=FeqyzclZ%1nBu3y~ZfH-4k9VFs zS9C}1+Vuhwo|yT$9Od(QZRcN363;(~1ji!qDn(|c%W``CB1myjPv z+02oBx8O?;E?-iJ=EDvFoN>K>Yagt$*yr>4p=4`ZpxawsOrixXXhsUGpDdpfNtN3?R0O+GhTIt)4xpb4D(+TDx{w;EatHUv|Mq^aMb>2;CYQLvr$D;FzO;_aAK>aBm&Aekn;5Q zXj_mQxn};G{OBWLLEnu8KoEGxNC*K`Vk5OS9n&x(Wm4)ZD@XFb(h}HzKPykoVcPBQfPkqVUzns0 zA_K*em6>^aN_TGML!ROlJtE9dQ`5r@XRIFGC@%i^&-O0hzV60br>4-JVUf=dz+1Fo zJJaopSFW6D5No-1uxxnD-n~eC$B!Xrj>e0LLD|^5-MV*YDY4AR~E<)MI`~eG2YhJ*Iadfv9Ed9(k+r!9l~6M9>Q)ZtH5d#L9kK`6NDo| zewyaL(v(d_?#606WrSBvKRJ|i+04PDTj~*a!fg{Fa{-ufi^bxAZiQ@1iQ{WNnBwbl z$G_^olXGa(h_{3^nlbPqu?A@}$r|?i--R0zHge)4?DTEvk|#`XFatC_fseDHVH)-K zwdDk0qDkcMhe)LONew58(V-wpTKw5p4@Vz>O_VfX$Z%m(f^X*0W-{+O{B=4yD3i=j zl-Rd!)zI~-U+yh*>e=&dOLF{g>`Cz5$PbSB4f4d;3<{&7Emdj#1`h__@L2N8(t#at ziV6ypcy0?xCFmBo3`b|3^*4g zcQ`!=_)XfMBd`1Oe*r=99?|&m1g8)wfrW*h!~1z@QuyO5D|IO`PQTMiIU}jZ5?(UL zdJ4LNui?=xviThZ3qhgYg(AuCO$xR}_4g#LOYhY-G>BylBmB(nFx=EnLk&4x# zM0m>I`1sE{R*?f`_wLP!l{lqu^144dYqIoCwLvZK4y}Tb273ZF;Z;*lkS^#YK{$#} zH3H}GNO#+-NjI52&H6-~6-%YdzRB0FjUHG-7~{jlD+N*%Aulm&8}gPD0d|eIzUa2w zr3*c=TbeP-J)7B&hB#-sXD+`&bpZl%VR6BZ@@XzT1yd-tA1}3ek~5b0;nMJM_FM+> zJjRCG;>uRVj+FX=4*1rw@YWuZ#SQ6}uM{^w7J1yxzsFNf4@`&6Pq3IFD}MQ7U& z<|iWOq^_15@DaE)5i)d3oA`j)B2e{cQ5y)AI{UCf!h$uVx{xFQQJDERRT} zkBSA0CvH&ywGb0By|-rk3XBd9ipZ*VMR|E-+MF)h+Ak|A&OpgviGBMX&o8S_#Y$Fs z<8ecNGjJn?5x5zmLu&0|Xyj$sdHdfcZnWu96V?a?AEHQH?e_p?OB@6qexnqOiFA2 zy##9;$OcxOaQxDCUAk}qfWjlqz5QpC+w9qDJtCRSbFVr1<3A;MT)nf2y^YOcG-8A+ z<6*-Re0>ReT(~J};naA7PF4(houZX^4MM3!sC9%70KMtAm0|G|Wy|z~EzHa?` z7O*%lsQ~58x6P>!w2mxXr<(}0k9JS{A z_!W6nBlHD1S~BL$Y|1~k48ML#-a^B6 z7bBX*tpYQJXOgg%Z{y09qoNz~Rds(YH<#<{|b$O5pPu>|2hyW%MpA-yfY4)7d zIdev!KftIZFfg$8D?}mZ8mz{5=2IHu(W4RfOlh5~`p*pHs-d(Tv`ZUK z-yY#fN$@nF-WnAw&;AEvdF8dA zgfMDl{IkA3I5djdpF{ZO^+w(U%F*21KS>@yfFlDMG%wE_kVI&!LP1im~a9?fKPkxg}Cq6hg zh?)r4hTd3ZrS@iKOq6bjvx=&}kz1p(0O|sq8*O2+fAIYE_+yDXG+O7NPCALj9ww9F z;ZoW!Hw5Srj+stt;we%PJ~|-1QK!Ksv5X?il57tWmF|>w^r-gNDZMl|7A!6gw96(^ z0vJV)VpISKf~0P%MaW=mY*gqU!JFHjg-h(bZe_z$6o0HgC}4f zOzc8d+eKcQk%Ru{qVKYCt?kccicb_t&X&trDvMf+(cu|V{Bl^T;9!d_#+MiCQAm>4 z-mUz;Xls`SrngahLYa*+U<#-*cOAP3`>5?)qKQ3b4sRWxgI{Cj7vC({uMhvn`>9~n zO|TK1B=c{(P3j>;3;o^)yO4c#`M1z7l|f54HkLkq{KnsmfSc9rFP)Q-h=iSEi5`## zL<*)GG-cNXt87{EMcUvtGe1B;w6n9bwwCyMYWEwi!d{Lhf2C1}r2q4)X2h7uQ>QXB z6}NQ=5orrrKh7G|B#enVdih(g`9r{UoQ90QsfbqSZx{O%(2tt>`STtkRC!2u_39={ zzl;(oY9v6I-Ju2B`b^%>)J16Jq-sDwvIhv8IC4`Y=N$`Dd?F=fgm3Y8CH$Lt_m~e} zf`OR%=FQw{C`iC?I)0RO6BEo#O=t4zfigj%nXqP_XV)&JsLiCbAFpmmA;XKhcYABR zeGbd2o|Tth+t405%3xu}VpeW{Na@jyc9cGyeCzXS(vkMzGOhNdLXl*cbeNhj$@{*M zbp90K&xiUJchMWXGw~wZJ?{NIK*6xB$|)G6^Ep&`}naOgAWeg z9z7FNQ_XliR^eb`;l9U*u}8CzmNh67>y$fBm>s&|gyAnxl3?cJvOVJr@tUIP>!G2sI@klH&x{#T zf~(t#1b&;?{A`r?vJ|BQV#x_75Jjc%(-VY37mDWTz5_^}d9Deq#(I$!`wIzlNt4b}UM zbvq@kRljL$$}>enVQ?G))2LAg?exDlH?Io{GI9P^R$jgoG0g1Q!yC?ER6%2kiR_`h zkKYV9>uVq`}t3$}c;B3NTeWLx0!yCtg`m4Pe;NA6!n zL+(?h|HL+fG)n3mzD1F3T8EOOps)~AR-B(8uCH9Z zin7$toN#)~+0Ed}Zm|%TplKDS#Z**8Q`&v|l#&0#EyNDmPc1?p@3&@+=I=e{&NaX) zGo>}U+&c)V5bQx;O$IyNmoM+h$Rt%Z1g+1qwSA?hbOH5i$2*yGO$$UqqT}*#XLlYm z4eP!n?b}BS_jt1(g%e=t0|p5vW+z0tH>5B%bTB?%YxMdx7*o7i4dsdgO~0aw!tig$ z%l$v8PWPjttejA-ZwP+%l^NocArb#y&J;HA_rhds|S;yN(^(-3MGsPA&k7L99bAK784!i*R(&CwpZ<5F&;27xpjI zg$Ju#HtKlI7Nb*XDeO}q5G)D@vy0ZM%s@N{A11nS7~mrSwzD8FbTlKZykuII6)Wy9 zuFK`R;Dli^hOb=7SwX*Y%fH(z4iVO9Tn*D648|~kCc0(l>iRamvSyxzRD*lr$J$!@ zmhbo!14bb0sGm;`3`4_5e<@xTzLWru`u)on77`{jjzc-YWT26AXOd}#@7p`mK7Nj& z8Q1^|Mq3Pm=ht|xRCIy@6Mb4Jib2Sy=t^mtj#el0yqHDL>_7G92`DS3<~|;32l1s0 zV=b-gkoQs0^87|V3g`y^)Vl;wp3D%6Sc?ts-}Ni`GIrM^lTE|)g~1X=*RG-_sOE;;K{~*BL`5GM zh#$tnS+j=Grva#3?l$*=R}7;2!yEo6akR&$Cn*s|O_=-B)s^foh*BjCN>0htzypx4 zxPNFq=pu;}Uf=d+tG#ae$!Q@-u7A9mGJ+2s_lL1g82-a|w&-}x1rQePVyL1Qd3Rx* z2@x#Ky+T6Z@}k7GmkkUGLc3H;@3g0V4?;E=V?Z5|#*! z-uHFn!^{N-Gfhg*+~}z(Pz?OA=?FEqCmIoi+!PSpOD6Sc<;b6$e3C9B9hE9-n{>7X z{H>=-f2Ph{#)r1Ck=$a#kSy3MlTb(N_0eyD={)LG)lYA^Ir$H{tefm$MQcOSFc~fj zc~N@0Dm^x4!)0YRYT6IUE%WyN1C5B-xNvlWl@9j)a?;YfEPMee!0X_m5gA7YJ!N%c# zoIRUd=0!n~*1b-94r@R1@+=<;VQZPHVUCyY2g+yib#ync2n zC@5@aN2)d^Z{T-i4hTZT3LG(x41=wk?$0DN+?Lre(neJ}G7;uZS9g=0K7+Uv+Mr_$ zke;%)(~V)lDP9JG07z&jp&TXRY1|>OS#HCcdmXJ~(c%KYiVKe^wM8k*_UF`K7$TEO zJiUK)Cs4kA-Gl&cl$n_zMD-edr{9Q9I4;cG#8(gHDR=!UD*Ne(+uHy0>#7hM`)*Dj z(JwQl-wE9lCywQ)T06S$P?DH->g?5q?77QVJegg$pkSj?yzVA>ukrtE>^InbK+l=O zjc>|Ntg>vF7uwZMzIU;*&-D#Id;h>cFmX_C3kkG1Ho^nD zff)>FwioY}@uBYnY7OqW-=>vDOdZA4NoJ!Ga_79{iwSCMO;^ z5b?>W)_VN-B|ydKNszFNX-IYp1SLV7@4=jaeeICdo2mKpFwPjXm@)5*85xUKb&x!> zLzpWe+bk9AHC^tflB05|yiP%b{!XFoox7v_CZ+N8-pp;AvGWZN5!6BiN;H{=Spfhz z!rw6O0s2?1r3b3~(pn)v+In|8vv2_R{0yXm9K^^T0xII_WUkewu2Y+D#k*yy*_=xe6J155PG?;q0D5gSr5QkliOHonpYUk4c zFk%@^JKk)DchFS^6&pM%B*GMT%NRvo9r1d?O<@30sz8V>PZ%fTs%h0r?v{%`DZt1eJR_3Se~Tavr3*$lI5DxnA0MXmU!==*rq=f)#Y#Y zp-)4rL_ee2x$|61vGU@*Fx5v|z}uiXM|-23dAP_5F*zMNV-H5!_@dMxZzgbPv&H~K zY4iiu=2+nPv~T@OLMzxC*epuY89&xLhOc2+1RfEqmt_y;E)s%7J71(vg?&FC2a7JT zY-bdU5~2I^t-&lHsu|yj%km` z;&gfogz3id!PvZrXu;*n8s>uy3`Deo+Ie=vTAnR6HQJi2=}V5Rr3j)>yH!QhCW(OAQ9u!=)0`0 z7mscC*1wN!H?V5=?h_1RL5qbr(^8%k2%`w4T zr@+P;84YlD)Iee_6(6rLZHlEG_;MJND=BNpY&qYHSmv%woYzEvXfpNrqo*|U*y zF@G%QhsFGoPU-S$q#)yJ9Hx0S)P6mA|wB>)< zSh`@ow6!hyHJe6naR(bn3Jz3;MUN;()7rshMXke-zL7e?HWMbi&)+BoVqJe{>!Xj~ z=+?pWNEqlCH%`UsDFAB?_L>;J#i{KozzPP^>3dc%O;~jI?xCS>NQ3^d`n;1yTHK6F za|QmTrm9+M-q#5Pl4UZ$eZub8*sr|%=4L*`l56L`P{<4Uk00;t`D7~7BcE8Q{qy22 zqU?``*Sp^)mj)9 zW)rr@TEDW{@ursb&nR*T6%{TxOiQ9M|13pVd5A&TfB}ry!c((@8^NnjK!98rs%H>U z)Iyz}Y}T|^O_Do&z(-ep)2r09w0aOvjs;WHycDQPGmna;rgN!oXsYneLaehX^OJl# zg62^H4K8SEuhOD=|D@jnprSZKFH`OmyVAo$O~M zwpbHXKS~|rLjD}OJK{ck3JP@IPXciksK=@LI$p165-2K|{JeJe{0}3JIW-%YkBD5u zR*w#K1N%W-{W)}Vvv&{;Aj5y#wiR7iTDhzS4DrSdhnsc5{R9Eo01E-3+sLR*Z4I}& zeZPP6uJ=_2`o8uUM`lehUZPl1{cA&jgssP;E=vUKu=B#g@&s!Mq0fEQ%|{8-G>iN~ zn39**fa-eAM8FQSge)N~EAchZtK0DgeD0kg1rD!g(`Pkz%b z`_v?mTfI*EL`Rm8Zy!2E+M;gDV12NoWB$N6;x8c`j4W`Y2smj^Z?r?kZ|zOXqiT@`yze!9@a)U6q=mQ z(}(3edv-p^`o3cnIv7HvQ?d+A0vKfml=hwkf_;S^R!eAkA?rMAR^drR|5V7irrwN> zyz8vbZ160XBcq7~&ldYF;8jsjm6nw?ef##N>1>4b@JV-Y%6F%Eci9mUgJhW7VWj<) z+G3>NyT+D(RZYUiTU_g%*RLgD%Wrpo&m8&E61Pdx)`2Wn`V2_tbnzSc&}rU0w^@(Z ziRS4v>BR$*X{G6ad6u~KxZU1G=s!OA1CP?`Lu5zm-JS3h88B*83y+N^fq9)Hlxs0| z|Mc0zcN6dR%e;1)%^c}49q;rD7jlDt!3r$Qyv+rp&*m*4P@YSc z;B(7B3U8&8d0^Y0bp|g~5aI_tK6~!$S%5vfQP=wTxc1SfA0d2EGEjF&SS{&uNLe~B z_!o29I?$U$IVWYwfgzsuMdkBV7>dIEq-Iu+=?@C9Q zIL>;emqe;;Kba!Ae(!yfRj~uS3}di~0QOR-Gcd@JV-c`7<8QdDx#FS!E8|0ayvelRHz7)den!Ms`bMrEh&IT5uLReLOSPdj$If# z#I4@rw*=0M)WQ27ws}2U`$KdHqWLAy)?G6R%OXF?`dtRzrga|KO{p$@SaZME5BgI_ z5IWzrh7cX@-brWq&enOIyd=`(oFrTY9c3#)RiNVQ5mW9j=t#JBYo1)5uxL1l-uKlL zHLbejYq~1udkB6)!}X)Ri{y3t^ttF&c7o~{sEVinR&Ts?ey<)qoV9 zPGn;?Z*Ei+y+_JU#9YqO(m3r=azu+aboT6huY9rvHeXnHeyFd%7wLa2j>`twe*JgM zt5>hS`1s+^7?`8+mSSPt~ekX(E)dcH>ICIFvEy| zqvP(0SySAPp~+cSY42cbd$KT~pI+tq=POi2?R2gChg}*b9!UA-5Bc$_0$lTH zVxdwB@XeNeFD8$sPel9#Nozp|&9edK0VMVH^$ze6bMmB8McNtL%_8t&x#44P8RJ8k^4iLT4(DkSRzqsnD*(jWn%UqsVNX)yANF5il&Gv z``Pu}>(|?;Er{nxtZ0PT+LAK;@{>83JnfsB0?N_!s)Dw*6@fwh{JNT&@W~3zM3Nqn zCn3UgV*)q)cs+@oMuh=%P(SHq1A`y6m&q87EB}67USgL-n6;s==O$^RF0NhjT`nB# zVErs9ElvD_RSvp12ck5=43O~r#BJCug2&55&)<}dw7d_Ro?*p>5dK!xMg7jj-~lgQ zAg9VCx$=O)zh8R?QUm`{2r-~$jsvF7A?H!GN{HH%+qbt?6lk`HXeaRItDfO;anH!f zNdFCb_eO_xftXBjGiCxIn2Kh@pPw;>opgg2v*QY?^ur~cAO>ME9|ApPOW(RK>ilP~ ziR#|ihTrXOZhrOL0sYSX87l`yIV}IlQXK7wk7p1X)Zc8(x>fj5(*X#(VTo#Hl1xz1 zBzB2K7i}nwOHH>hjtOpj^3pfSN^AyUq`N9;7n~#X95k3KFuA8aXwwit zCHyWlG&J7b635;7NTdsFXe2kL?3_IE>e}^u_R6AcDXaDCN3pXC@-(kK?l7{N^aaaC zi~2P*@HWT4tt;kR6%>qgTD4e6zhV`hHYWNT1&mYG%e_-m&eJ75PMt>oYrmBhUJv3; za5ULx5->|DPHwkMX;J*It-U*il?nTVZo(*+t2;Hr>cYr^f@Z7*|C z%5a>15ny>ZXrE8~C|Qoo9OfmeFdMPb4F_G=J+x~nDG`G<)AGbZzo$-1l(nQ6liy$? zq6}NlViW*^jp-~*4!q*4hvvMkx;ko!jPvmBD5)CnWCQ+wdMUcX`ZGHKP`PU>{v@D5 zDM8T&ojS#Q_~6AhAd2ONZk1L)BSE8}+49V7K#dq5&1lL!zwa9i@YE@cs$GQGntK1K z))t#}C=moK!hGD?BoJpKb70G8eQWwBhL%k{?&bFxfY{;VqrQ?G^Ha5l-0bBtJ4Z^` zVgu?^L3>C8d(TTb5lWuSK+hdOc%pe9bF|HW#G;#z%O8ThqCCeZ@fZFMwM6&}}qBx^-&-(`pYEIB>^z@&o&SYeMZ!i)gAJGnhR@Dy) z{0R^)y?N{n&J)yFndb)zWmRsS*w!SJDjkzOmfspQ zP2!>OC1-=4v_=aDJ!7tqH@XqeCON>o+P2WiI;wzBY-H)Hqfgu4d-) zlnm0V{=<_Q+Y;^_90o|!;o>U#?4N(ZwXKKvHqe92R-yl)IdgeBIg}fMa@e$ovaoHO z*zmw8`ky97pzD?tBsc2dr@riQDvq-0nUQ-%SH2l1?UBAoRdeNl0bJv5KhR46=*HPo8?c&(ctOYarO?^X2#6dH#k1GvQPnbGn@ZiuN4GA1c za*gZax*0r!(9r8N!yx($t}Y0Q0e8!h-nUmo;Xv%EE|)G}K4Z?DOPQIqr{CTTiZz(B zo>GfvjR53oU)_&u5P|0a$@7i&SB;`cLeb#)nY}YtajW2f8ut9(ww`ymMw^aj1pOqL z7R^076c?@YQ$yANeGINUWQ?uJ&C}k-AIB1-7Sh|T&#=m;PuZi25O3wOWv3HwUE7l% z0+Ht0)P3@7CNu}n%T9Z_h!GfA1*be?0Y>7}C52_YmPLz>Q_teO)i~GkLHiMlbx?c5 z=@JG%Db?-;Q7z$mEF?hhuLIKME}bUlUc2VJy&QZA&!*Y4_wS1w_G0|C9m}TwxzsgW z-AX1*U#OMIcaaNII^Sz@szj<(l3-N-beE1ik2;ll^~{;9(Nc+?$m&iY2$Kxs$niuV z69G-p`{rD}%;Y&kFb0$5s7RGDU`d#)?JAZ5C_s=<{ra*5|Buk_t%NP5-hY#<5p?!C zA_56jigbFN{s|^As>!JT`LfaTT9K_$yZY9iWEzwy1R??jO2gc=g9!;Zdd!_OM^1o= zqTZl+M3aa3Msvua9OkLPhnZ)bpBE}t^#7y*%*l+&R@2fuW$XPXtegraIXXDlOSlk(_g-iD)mEhqq@~WDA_VmnWX%D~1#JsEl$HtZ!nBpcWwc~BON^0J4g7gNN$OY!Rq4{3XUuiwH~9Gb zKYjQRzkL?eY15r^1ZWs}J)a$lsMJZIjJQ{1d3FpM_K4A$iuX;t9S$z&y0X^_;TC~qo zmIWeWmooah8w&+Snwfp5tHblwA>KHdr*-=Dj&Zt}Px`s}_45EFrViV{&^tv$&YBLJ zC*v@7cX77X^t)67^SGOHc(l5@UJi2>;^f^W3=Dhy-xPy zrm%4%#XkOKyj6tWU-jVx-57KpO;JnK=VrPq)UEi&MFj^3Df4ft9v@X1LYkAh&(zr^ z%fLnyr3P$xKvMR?fjXgCbC68>#fr%a0-G8H8DWXHx`vdaQYi_dbVCX-LX#ZKqQz)b1GMX9HhdbMP5ri#fQCNIh1{Vm;-8kn8ox9av{qziG^*KR7Xl! zNxm9rr6)|*(y-OH4jU@GrB=;Ndu^(i-}6 z0eL{I>EN&m4ijphn~LaX;Ow+#Iji*|Z7Z0S`Ft4DSz{w3_8f<$GXwy z=#Qv@hzwa{dJo~;qoL@-8a$u*~7x9h=llx&~cH+tvaWIZh*M(d+d_|Ag9b*yC zc&%K?ex3J$vvdtYVbh^-VrH1zT*2kUMLe1^9hjO68u2NZoERCYoM^aV+&JmP%|QfX zFgd)vc0cnA*Yoa%yh^cZqmt;}h}BdMYR%Z8gjXUc5~H5q?}gjxgS}Dl?3}hy@*PtP zSSqYSkK^e%qI6TekPh%6pvbrf{&ifT;qDcO zv;zpHJjaoK(%wF;E}2?BI=Y0G#xnE|YC3{BK6M_F8&x}XIt~q&lw|60Pn~Tt@W|+H z(&sxSznt)!*8E+?W^(}|lfA+em~6(C`)fdzF=wuvwd!UERmY7W_FMa5To)I&t=ozb z>`6c;>FBKWivUKgg1vV9p+jy*Pk;UTRlg-&Of`%k9v(*=>oq}(y+~E2TUwUvBhG`pfQqRKzWfG zCR;sw^C3ki)@C&V5kH03Z&xi6%|W!aOWYHwPHbrgkIq`c`~-9y(R9w)xdmspMQq{M zP_6TyPC0DW>9bSd01Jy;)W2v_paV{yRt&0mnZ8IW@#qrE_CJ3A9+m3M8a;-7QjM>I zpXBA`9Xd2Gx`xUplZvl#E^r>&w)HXOIsZ3 zr!n{xDm^fziU}wLRKEk43U8kCu^~Hfb~UB_G`>lALcV1+mQ7e`G14Dd zB-UrteIm{Jcs~zZfweea+aEF>=y2F9BcM-mD8*)m_CO)VPFx|$FKz${wJ*GJ8eOuX#cEDxnRcTMqy&Y^;4UP+%(y zsZc281#xOI`RZ}zOK-`IjnuqjzJ4U9?ZS_L@7_ud=I4QCOkDD0FQ=vL3cADu0>$K_ z3u-wIoEI~;fJcY_M==vqpIuoyaPHxPaqzUvE%c{!UHK6@K64dwf^}A$$cj2s!{VD-?XW zn-8=rwZZDu_#R#$$mkrFFO$0DZ?dn`<9rNA%Hh1~mR4{1wtOGjAp@+=Pl5 zISa7G<$wE&bDFps@Ho;!qN(vFgi z3Mrd^D}@aa&Nt=^+mxQqgiuehgn+JXVUZxOn;tIw-epEm#33B+BR|Q>L$xcPJiM z*ZcY`M@Lsr&wt(Iu7S`JM-vjD^}jMkO;Jo^PoENp zPRRqj)mPU<#wO?p8w2_iL=RL1MCW|3iwGcqYIFeo+RF~td3eZMM<;k5R^!Gb8=Iw! zRinC%fZ4)kMLbU4!-v%7N4dH6^@H!;U@A~sSJnG&_e~a+XhsPx+6_K|Fxy{mMpxag z5i6$Sg=aD@{Z-Fw#_+_8@O_!?g#8-MS*-x`qav8m$P!7J(DMYkiweUs`bt!9zi74S zVYs>?f-(`#EL^*G$SyNPZd)}=5mj1yRc65m0?7gs$L-m}Sg_+Tm2in~pA&zMn$`^H zDBdG~R`#r%Lv}CG7|{x8dy%Zs+hF~hq+r}D@>{5_eSnq>h<<-`w7h}>Kh?EZ9|YFu z0gm7Z01I@^B-vFkxeOViA%e6<@xcXrc)vVA0?R_{MqQ?1LwLJr_3BH956`oXPoS@C zmi_d{6oH+WD^&)ZWcl*bTwiiFC<8mDq#U;IODNQa-2MIFvaIm##;itF)?Q656NHt_ z;j4v)yKNhO{-n8C?36NZ&YS=sIxr7P278ce4yu3K>oR{nUL9bc_R+PviBVv`RV-h9&jz? zJ7z8`)Oj{)e;0o?ta@^GjQ*swB-PTn_2~)IU3<5eell~F`_g?y>8ZwZ-?o#Y5nyMh z6g+m3=Mnk>bb*OFwsYskbMf5WjZ4kEx^I=lnXM4ChKY$@%(h%VYwK?RUDXX1q54Xh zV0T=0e6aiX?)CQb!;hY0W$=V7FVfdXd%sso$?Al86o}skCW1t|hurXe^Ra zQ~lPiW$VzQ+SgC<`(f`rdD7;;IO1IePQ`EIQ^&_Ovve3|2TQXuBK`uC^4%CXVFQ}) z$+MO;>eDbJOW;#EF|Gi*vz(mpMuj8ks7-60hlGYk3bP+S^ZSdCJg6fYtvv3BYs=0v ze4>l`2%R>!v*t}LO;361UYyEcQ9&UgNv4Y;_2#$!hEySTpuE)%Bgx12ug)iGrKl!t@xm5N(#y=lm}og{9``R_5&doc-&Hv4m0lZYy-%kCxdqRUr%TDA7#1m z5)J~;PWajrw!7;wUnrD7+BGr=lhJ~{UEuzmQ`jE;q`Z6->>7U^F~F@(n#{$51RSMb z{Rd=_nb>4&r@eQsD*yXeh=QSI9$ka$Axl*z5&d-DCWZ#WsTYzzh4jrA8E zG-VJ@5xGe4CHy!RiX%cQ!-Qz-)bsivC`5>9UUY04%YBEOs5QBpS+sn^?cF_Zsf%nu zn%g3`rajv6W3#+m)o|$h3eWAX+dh;r_`>B8mofg#i;}pL*!TA=LR^V=YRR95<``Hm zPD8Yn44xGKoZJ_y=oES!TOh9?SG53rA5_6=H#eqLAB{tg8g4D_q{%O z(1bNQMl~<#hia1}WdjEh1m3PQXDT^%58iE8_+1!#c1r+^#n-8;%Aa1Fy>*GGiw` z>Pdxv$)=MBMe{gC5!~kGSzQ~;9eNnmYu;eC(LG#xji$xqRYbPzt9Sb}etD7*qN}C# z@T8kGEbI|oSb(P50sERw!uLbTJxcd{%kSS$j*N){9rG)1S$*U7K4o*Y)Fd~uZ_8&^ zcH1tJ_PH$9R}zWPQdT{81Z841?B^AR5h4-N8P-TaXw z^^r=Tds_WE872*3C8zjX9gS`Jc6tskW^pt>;WiParzWC0r6eY1SsfDdx7fT$Wo$(d z&hf-tkLs;>4yXbBIr-XSHtW|^Vdv&}Mz2c!1g@#9%r9$%=Sy-r-?6F_kOg?^e<67+G~w!5_IWDKO~Ost&?a{x}IkvEJ^02=n*{rlv4kx)vEhO3RuN${#w ziLi~r+}kM&ITe2;Ble26sIOXOj#vpG+E`>YN@+seGZ51C{;3Cw6rRdAhb|B)-EG)l zTFyAQhJJ=2mtMJ(hQ@&r>y5t^cMQwnF(8KkqVcMq--yFg4We+&v z(+o@+?BLihD@5tN#Q!~u6PP}U|D&Ph@q&ye#{EY`XdfC1hAH6E@{B6J=MxsFT3N+U zJwrl_rIi(Fx%=Mj7W396s!rzQl>O}*k-J{_A)P$EaeOAh}Oi* z_aEFS)9(*ZphJga-T~~gUhgkhEiY$e_hC~piqwYgkRk!Y?+BQCr?{}2H$TgT87d)~{4N@^7e(zc}6&(iY>xKcZG5?T{g6@+~eEElvbGKB) zo#IDjYX0t;e{ylSNU9}iFVdFmEw8jy?I{{Ab&(p2X1n$}unTGKk^7N)p39f-SR!Jr zO5c5t=xvcOqK)DwUD4`-;Q-9%ML|Jibq2DQ!qU>YbQ9Iu{vQ00d>^{|fWOUaSFO4L z@b}dzQeUY}Qp@6$y7t|6YwGA6j*4RSGCcean-n%9`oXY)-7-E9^sP?B&-LqsCwdTv zwPsBX_l6gfW|8w}^s1KwB36_#k{R^s#o98#yz%7FqmoDImyREo+0<8eDjKBWj16x# z|Jgn1l=srR+-)3yT1aQMq}-a!9shf&&^iw=Cyn4NWN7YW(Cro(tt-haBwK*Fh+ z&NbC>`k!|3!ELVBmmm9ct@iemKI6&jAS z6`D>Lx{F-=A4tO&a&-4-OB?OLTXo3FZ_sXAVN^MLR_m!C_h&#{_U9$9gMeQB@pfgM zZbn)fLjz+o>VwT&7r9bC5)f~VH#(^75 zdxgIVw*dG6)nVDPFT5ihm`tR=Eb+RM-5xf_#3SWD%f*SM zp0U3-O4VIuCAP+hHyFlr3+oq;=XJKV1v}1Rlvnt9e{$b_%<;%KN^T1y8;*kswzq7X zXCewBjw>)QgBcTZ`@SddQ8SJFPuO1>Iq4L)94S660r>)F&%ez`NcY5Z2rSCg9yI9k z>C*}#+uhwhaN)jxC*jCLcT3_bPfuYL6W9^>!kIIlp0+xt)4lTWz15Mw+nzTVHhk}1 zm0ea2=L(U|@hwoctKFLwsK%dB@u_3;7;_Q6R8-ZSfF%H#hb%h7iG5{FTz0$2*6B(#rD{!wW{DHi0>>yxWF&GDkyQ1m zszgCQ$@h|}v{7fus6Xj2s5O_UfGTB(WomB(sm@lsSzmH=B43`IxLV<}-Hf8mr-aiQV9vw^!^? zm%F1)r-%gl@#8KU8t8LpktJev{0J-t+0ks(fzuIzh2@sc`QcfmD{}5^2L(1mw{1mpI0K3}Q+R}ly58OX=BvH<|s`*t@nmU+uDtsB< zFu%mTrrFn*xZ~y|P8=X8BZ4_^c&pTE}go+y7r0ML3IW|=@@42^U)sUgRDgu$|WoKdj81m z?(C>geJaw=s~nIrV&AZ?8}}((qw<>$OW>S-mp{{9nw z>M=JENR2)R5y=7bm3tw<_!SeQdHaJ7!~*gTj19c;*@l1Sm(b%aT)MQdR%Y5#t;Cd+ zh{(v=hFO@NA+ZrC2lVJTxSg^xRcHOtmfWgKgniQH@&i-b@7!8A=mFm={l<;k0S%`M zk^~ng+P%V7I}89Qr-UvL*+%373>sW?P&f*^w0-|FF$*?N(5n9dmDr5)O%Tb$hD9#w ztQ-uYXvM$f0>OZZj!CxZT_zy8n)P4lrc39}u}eN8RLEBdQQa1RhO zt`_H+@Q5s&bX;vdJ3sMR2Fmw_$Rq&hmD_C)BZTl@F1I?5gV0;RUEl{})PhZ$({dmf z6;>YsFH>3rtW0Zy-hviN;A}!JHSh@tS=wiyb(4IOBtRADF)zBOYz5#ZG^zBv3>iFQ`@wF3S ze?bd4=$mP+N7owk?p-*$bJ~PKM>h2py$ml{E;1KuiS2wot~vBx&7q?B$20QOWPg`U z7kPz@>7Y4Hba<WuSl1z=cAaYa^U5Mi@%MMfUZd*xv(KW7 zig6Xi=iZ8^2G90CuUk30%!JkP`s3Oio@%}JZ4fYPh+12T-8B$Duo=n+O+K!9xQ~ir z_U!2CB_QM&bN}eYi+B^fWw!1?3>hD9^)!#xcgx$Hb}#+*V&=eLvg)W`Rewq+lQMk= zu(7k@Y+*!P8Z>sevfLQ2r)Wg9v>@Sn4;(0%idm-3U+itstJn6&mA^X?GJoRNkI^@{R|t(M2p1*<9Adhn z_N;l8c#Lglv{&3vR-7%akK4NIyr`RY!iP^mfwdhs$cY|oT~Ruux2U`5!TftZ%8Hhe zDpGZkwkWbKuI<<^Kao=X6>t`9MEb8@VKsS=lOFQdc?X-0-XQ=0`r#{+J=~#DKYbSh zRB&H{Qvi|`wMhrL!!=+@5V#&&A0&f?txWKJbH2CO9CO&XX%pgJMcux7cf46}@f@my zI^gz9cAI|Mf07&j4s%O!%Jvm@yjHVNF4E6toP?GO=_QmK?m5I0KUB|b!8-;tQM&I8DCqjRm){P7&CRNR|z8eIJM6{D_@zI(fKGUhCs^Rl&$KT?HQaw$CSLz zI(RZ&b6o9eP_z}^jSQzf=A4^w;u%luax&G)V?p05m_MH$8|RVlL((0VS;Q(PUz>A# z1%yxg;dA#^lXBBJ(bw(qJ{_f9B~5EI62uDo-3&wv-|U~=s`CEE5Rn1hwtgF~u-%c7 zc$re+`L=Bv>lC{Zh>0yMoKY1d>}O<7#tiVfpum%xM$@IcR7980VfDX_*_(X-EX3f? z{zQAb&{Hw0a7H5_RkN177o1?As+^}h?Lf{*r~D@b=|2qJ-fb9YhTy*8P2eK)Hvmgp zPaCQWi{)?t;H_nE#R8UxS5zgwr-5H;s{IGOWGk-ZFFvpIUzmr8?yGGS>)l<_8q;GF zY5AT8ccwF*3+3LmjNrQDWUng`;hFSyTJ!1VywauM;_hW zwM?{BY$Lvra$8;e(R;DWY>}t*Tic-NXTc^sN+DU45<;5{e8;wKWal#+)K6tXyXhq32~@9uL}&EJ zjzRSWFf=NCa$KOlh{Gp04MF9-4#(1xQc}n*k(DCsFmr!dSXL%rFiD$s$%+EScYo`J zR)&#l6Td*WT{}OO;IU!5ci*#8{>wB*o>lvH?I>$iI_(WH?EIW-n3`C(B~l6EMzHZA zyGCEI1UDQv8C*Dj@D`?BY0MW`=0gNrXJst}6Bc?mAV?ncjBC|dhT08djF-F4w$+j< zJrzq9nTRIHiK5pG{w22jRW7|guS;uFpYF4l*@-S~tUJ0*FaD3doi)b{Pn4ho;dwGM z1EanAPS7clNqr*a)kWGx2tkS_@DE!L)ViCoH3F1e*sEZ**T#S}vukVHZ|=pyO5zO( zAjc~Wax{9^8G-3(_aErd3xNb*1ce)@JNe=SP=P$`UOs~FS5M-G@bvp)Uzn#T zFmv=KciwO0lsE(qBvmuWF2=cDgp<~DB6$nR~dWN=)LAO%pN!Bb! z$DLteLtg)2s|itZPwpqnN%x6f4HmbE5)?Ih-tA5ywSVG>q@<|m#{jL3#K)scd8Z@) zFL8rucJ0;v(UX?V=*!LMP2RrE?*%g_Q)VnI23D6OO>l8}ouBUkL;?U~Z>u0D2UM%N z?qAP-veIYPBOPb&u+B^K>r*yS)MK#uDRH8lNOWGILfqxg%bZbF5h-H~#%b@iotuP; zeCVom>)VQDnnB*mXV!Tzpi^DYrtm0#A2^p6l7$`B4SrY2e&YVa#CJ$~-k(+#xB<|C zwqjT0gjMT#7d7@X1q5|vJ8v5n2pDA$-1Wc4SjczpNAJ$Oz<(P~IkDKF&U-=4(S*_7o~*xm_}h z@%q%zrN+4I%Y~s`2$>aiR;wF32iavWk>ZA*s@vRz=O^KRK?JzYZvROt5?XE8Hj@{m z@7bd&J#hl7g~!p-lO_y~G|qHTqap}0^LU+nu3++x5nydt7XU8M?BI^7)KLXel=<)N zTF?0dT6Odki(?bConYD-fipUpw1GCFVqwSS3;wdVEf z+KtzdwB zFt)ZPi+>A}jB>R#K)}_iuRx%>lU?xowTnlu0o~2QyALD2?z&&>VWe;Zciz|HHiumB zuPJ~|fd~yMsxVdlMgFl(zw8%J6_q$dqCbGh{IkO{KAoa-K(GMhg^_1*=%BEBxjH8O z5=A1QER0+i|DHEdsO%{%+M=dv9wMzY08=b@N7Z92&M(eXGwftI6=Mmt`L+r1Jj@l} zljd!`dUdTtk|kh|CpP5sGeMe=W8FwHQe%yszWQ>|z|Y@-5=!EI&z@KKY_=u1Pubeq zwnvby$+h0OhxFwV!!PN@{B@YEFx$m;M=&iiBh=J*i%Z|^Aa{{=2JU(>1lc#J0bm#) zJ8t4do*nt&kX?aX>OP>r+x2azj{kTRBd;aknUd1Nz$-sg702vZq$+4-tB%v`vJ3^O z2FkLD`}$VtJlQiHH15zLdzRbu=<)vj4)@|jIuaHTm~3%Lgtvm>YqTn|k(x^@PF?A* zsG)n;45|RZTlLyKQ_rx~C}NNAIRFo=sRZc{-SAn7%Xt0vZD^*2pKquC;=p@x;?Rx% z@@;B4;lV-EiMi4J<;6sR5l&c(?JFyb(2$EpZ`c&ji0-u4+PuHkBAr{RJH_gv*IF01 zJkW{pihciaU@`z(-1X<5ca0Q@kBX(I6mFH>*=*5qO!H(qpoI$;Hgy~XH_=uVqNiYX zhRFk??N$lq^fA*l;wL+xGR05CfL+?kD%US2^F;()dM;TqPG6mA%l6?J2e~nI+k^lJ zugMc9wtLxrGhoZvY5Lz-z0N|k-L_`KhSmOP=N~t5%9K%?|N3WU$B0IXKPN5u?iBGL z$V(hNc22rCLB?B-L<+gIKoS1IIc8uHTt#e?>wJ6yDfd1NlEAL2<7kx3yRqJNx#h2= zpaIyv0#GjS9GAhYWCBoujN$S-Y&dA8=<00a_H1EZ{UPaEI05yDFO!mdkWKshNOLpFw zqr5_PY})DL$M3=#jy)!lU_~JoG4Pf_h&uj6AZT3GS70xpDZqN^xe=VTuUK1!*+CPV zR=SgotRC+G1ONe)ufR~~*?$j=6AnLJ$qGW{<8uiXv_~H3b3xqQPj1cDN0l{1RB0dd(_cfV;)ZgdG`{ z|9b~VnjYXy0|qC|GL?m?H?y@T(adlUSc$@)$jR+!nY(WD=F$6-3`E7^e+v(WR{BQB zR2{{$fHV4aMFm#mHhR}=@0LrzbRbX&16vS1fZxzow2{$+S`-Cf=M+(g^}Ba$=~R<_ z?ube$Zb|q!R4L=ejztNtaIk+r6rDFt@`{WeT~S=@GxLRRbrUc|i)h*T;PA zlofr|l_;0oB&2b63|N6QwPB>Vczlb-6JOe((i0Gr^9z;%;hUSR0hQV$KWR8jjBfDQ zbVLTQddLOg;}Q$H`9Sy=aTCP?3`I$&ls zGzh)&IaWm>oZvOYCc)-i&Nw1Nfc-;l7GvMW>0Gg>UjCwcOWoY6Cp&;E@_99Q;x2kL zeIdR3`|IoEwVvj$nV2B|3izLa6amqlBa0InVM?N9m0i7U%p~%lN>?rmfi_hIE&3{95#iYGnDZ4d#n7Xkrb?Yv6j5Nsho4`vVxE359y zl>ePjJ*u&=hsg2dnNCMLO4JvsJX!l|w~9no>v3!M^)gBw>N=WAI!R4LwZ)>7;?DJd zPb=NkL3Cth1{8JS!n(Kv2j-A2my8HCdLnmviSB{I^t*Dube(Qf62tfyYE*dZXIakJN>+oreu8QF5|z<+p*}j z-lyC?`xpH_u;^vODgf_WU5#eGED5{>)s$;-n~+OR58670Al`R(>)j8JuAZx%lI>=! z8~LfKDvJF#5Y@EroNkX^%neo_`}J7#nIQG?zZv*QKSG+>ciIsT5BqPCr-bVPiV1Sx zL3d3F9L(!)j>is|Q_n$ot@F_l$Gg;sfJIBdq$WiEi*oQNIxob3ZT|g* zy>XGSyltPX+tLBXxc%sZ;42X2SpqU3FhiYZVrdx{kP8e{qO_n>Z`ml%;`9qX6EXRo z|ElWVyLG1fh1|2w+FtWM?CW^k9?0o67UA+<0xAW|>N6L|d;G9klGLID{sO}Q%K=qV z4ANzaOev4laSKyZVYfW<*elf#_2$2ywmU~{wSvWE8%$YMQ zJU!nuCJz!Y-1L+yM_r67rFyRZQN8FC;gYbs0V9tPrc`=0@gw~_ z_)K6+{V7Z=dwPxo_D*-b3?_!#o$|}lq&EzH!tlXjbD{ZalpT5=!UFmH`Eb|l-m-yG zQ;A-s$Wzp_wCB+C*UxvXF*Q*H_d1%Z(|KstkfDRbHlY{6Vw_T~&mieRM)dWFVEzK@ zPb98s$DLJ~HsD<4Ed8l)z8=P3L5I}Sva>YxRQdgqIcu+KR9CV3 zm2Dp2i5Affm(HH`$GpZxXYh~fjvp?S+4g_GyuHs~zI>Z)bdizMvX_2FSzy5`jxroA z#Q@LH;j|M|%Liyd${0jF#MiKDOHX<=T1%*PaMssXmxN$JWyPxZR*8Pmc%>-2Wd3lc za_*#^(WH+2mc5bH{pgI-vnz7%x30JsaH^wd#=IAw#2+Q2_gp!@ZR9CQ?>b2zAC2QK z^u&Uh?Ao%))lmfbV4`p1XTClGc{}AP(euq{?Obn^W<1)>$UDGk1;lxWuftA(AH{A= z;UjwRK48O(7yGJ1m3j^o_bF@FQyJBx&(F`(qwG3!aHpFs8*>V%gHHwkLKyiCzuG6h zmbpdL1DbYP50K^8BQ?~Tb(3@ExjR9-1B>-&8}N)+=JI}k25NG`0y2Y;P&m~ z*!@KJguW6u(sWBauBTmML+>J1Ho`XIp}BxI{QsTzMLZ!%TmF6j;p>7 zI6(puB6Z-LsRvAhjrUHz%>4rL2mhi+VRpTEsd1cAPtzCAKa3Ajmq%A%=~XGA_dpvq z*DG~eAHkUN^D`*qGdPNpi1A;5*}9URLt~2|-E_hsY5S~9@#UY$X!nThX8qf)F3KX{ ze=YB{?W%QbZx*s%5QG90v1up{k?zbAd%}qJS780P5P0+AMGwpxoOk)<+)FM53Rhg2 zB->3-Ieh1R=j7p4szliSVp1p>`j2tuQfmLR#86;qeDb7byV~fZ9vLUgwiZ-aI9yt4 z6?ZyWJpY=`xS0b)B6;KVw8yeH#0jEWaiKzJGG0PA#GC6Q5jOw}7Fi7>Wdi*arP9=X z$l@F&R?l)x`T&CIo^||Mno3VHjb4VgBsZ@prB<=0%@U#38N|{q^7vu>1k-aLm+O3$ zSA!rpF-wDX_A4x{N8LkY(=^cx|>6#d}DhrSQ$q+}xoOo|S_> zllV%5Ef%})F5N?{*eg{VSqAOoRmE!<8O9zn>DO;15d+|>yTig3`L@f z03o}nfc28MxYpNKRYj$T$-*pQ2thIhM$AAS+E}_A`^jL|-(GT2$1xq3QhFoWng$G?ZplpA0fu0E`0+{Z+Th z%hGK5-`WNbhyubn-3a|=n3GDSuPwgs{r2>jY{QU`9M(VY_v|t{!FthMIrM%!c!x&? z##DPL^*p#+xO63;k;H(;Jb1TT$0|m-uN}Vup?CmBJ8p-{A}h_J5k3m@ZhY1oZcv~# zL^8Zm<)&iV&@CgLjo``3q?LyJA*=lEy8kvFFzKS2LB$OiLfNQBFH>E8i=d(#)A%Rz zfUHnHAd(WKWVKt`=CZxDrX2>X<`tt3Fx)*RICA4i0j#?0dhV8>E@%30*rL;F2M+-^VbP5Zt zdW;QKIC1)1kh(U^3>iP2L_1Vf!`m@reQ>(U*(nmcv(f+bD3o;Ry??O z4=evD{4`Wv)M@-eQ;A%Yp~{}f?CTNI$%ixYOFjDN&nW(WNoSAD&qY?@wnN%A8AzIa zA4rW`WJXrT<$mg8vl2XnC?C`da{_b71VWF=l;2<2NVa16a#DeA;AhOp5NPTh{cx0r zbm*Q!qm2xVE|v2yc>EQ4WDWddp;<(hRf6xQv@}Uaqo+-;XUcwKLkB>x5M*VjuEarE z^X*$6m(!LP*49>8P6nr^VA9E+9{t&EUG>i0-9O+$OjA;lMo4>!7AhR=@3-#cJue@h zjLoeh_N^9{7i0V)LL5l6!i{jZgaV}G*MqjR!q-M$ogz$(0Q%de&(Fr~@W?=2&cv=c zcs`pUbyg-^ct$%1;1Cwpu1IeQCm2eplG4)5riwsZX(QKtev0E}hnn6Rz(G$>Yw!1V zqZ1tOKQ#WF;Fm5Pq%TupzInu-?_0YYue4W|=znM#Asyl%+qr+ALmvZVT~fO2N%j|n zTeo^$aJ+PWUe-EfhAn5@-rT;0VFKa|DS4Nes2G031Ij%Y3bbqf%T;l$3Pn%4~};X4vrflyIt|!k0mXNdGdS3gPzt_ zYs_7E{O`NHn#Z_FAn^$50JvBj!QCpqzRHPJhC@3;ItX4Wf*?*GJoj>Dsx%OUm-A+s zQawi%U9GS}t-o<$`rY8S)5T32XpDr-sGrB72IHJY6ydPeZeURVr(UvQ2c4p?%GPgH z%uNWDHUF0|b--ki@!)s!oz#x5Xjq|fyx-I#Bj?nH(jvoJ`;XM^yx&Wae9XnD)){qC zc=cZ@xx{h9AWHY%QCD}+$9=tf2AKy773$n!iaV_tt`$MgIl61dM+j=>;V#dv3hyy| zM*p3UdW;B)(7C$)!r%6#+FhmHj&^tO^Z7p3A|<`kdNZV{bYaSJ+YoH|z1fty=J8Kk zq2~f6zaG7!_w->^HE-WON1Lhrw)3slxh8BYt@?6sSIJUIyCxSGXGgp7H@jOo&z)^M z>Wl0p>4n?`7I{u;8<3KlRyo95UzEn z$_rMLCIzliqa^pa?^^kTSv7a z7KKRS8&kT@J$-RNxYpLIOOBLs z+)e<)lav1O?xO~*YuSh-40!K4FQa#(0UI@9K7HvHGUD`0oSS7QCa9&Ha9isy3ArEf zP1fNZe(^y4_Is9B7?ly=-t9qZ`mYUz)>SoVlS8C?khnKc3~q)Z_i4|H%NC38zTkWAp8U z)F;BP>y217c+9fD_;vg8r8|$OAhI zyh5_l^g)BB^l)km$`~cmSF{uDPi?5`;vhS6rB<62^obdHzUJpwL?ryW@a0A0{uBba-;Db zx&NK26s0aaEqmef5T~akCzEGvS$fs&B$NT|DvHYu7hLB?oSF9HSFxp+WMcLL|BRcr z&P6|3AX1cC_L(xRFcRM{vndP>rh`-E8_CljP`wVCN&!ojjK03U}TB%9eN$L&O>H|w>QdAB}g_k8H+SZVY0ST@(^oOS&79tSNi|7+*hU8*)q z_S05X>E3@1aS`VZJU1+3m9nx?|ADDvBqJQ|`f3F|%q=X$u-dqIs`Is_kJuU~FLMXm zCJ$%E>Qam07p^j*lHCYecZi{-(CD?H!F5_$R%{s<8h+y2AxrcK8K?A2W!8)x>IPBJ z25e!eYxxTd^Yz=X8*}4B8)zpWBx&;a5Sq@zj^6AsIreV$xPX#ICrLLHQ|6mg)n2u; zJ8awM;7aNW-6qLNz>l%V3RhMu`?YiG#59BkYHz>FK~*har3av@h{PaP4Q&mk+cpHG zuRGz=8YkUB}0qC9Mym`_PZvI*ByDZgQ&8D zm(B3CjxQ&sO`fcin`ZV?%Aq9*?Sbki-F0n%7EWq3uBL)hm3;M1T@7nD?0x#w0rCoB z$h7)R*en`H4zCL*PV6JjWbaKJCQbJ-PAn z!ToDjth?NhVPNyZZicfrE~1V9wp`GFDDF)r-8r$1=-`^h+^mA14J=wZ2FsOH&c^?-Ith*Bfl1?2$nn9F9@C5Np-YRZSKH}1V^ zX1}CZ&)C$-_21%E@@Kl62dy@U`pncVY>wwKoO2*~;)%B0f`WoakF=R#m`ho@hTbAAp zYUeTG*w&obMbq2Po37vYuvi+;cKc&bR%>gfn`O>lf7Uo#ysac+tNNTiq=E$!YyF3f z197E7p)M+F{hn0t-t|)j96CN3QaVO;uWX zUl6Rq@zQed)*7;{+S&X$O$IhV%N|eopaCOwORJ3R78_IqDBih~wsxF+(!Bj10fCpI zMMYg~f!-W--N>TwH-0BuiNKSf2Mv_kOX^jOl?UOpzh$3X0x(xFlv1i_=%eIDP;xvnL z{aE#1F=%L@HNLMzokT#6f*=nhynsXeN&K*BM=rm19W;!_B)bY2^B26CY2=B=%pG&D zyGQTa*K6F6abrVMptgJ39KvMCkwht2Q)Y>Pi4)e2Ymw?;^quLV{kh_epH%OMZ_TuR za%lSFpetL~NhWywYTV$THUDU4$L$8)YWWbf!1RoW#Axbiv(_S<`rTOl=aFFog47|O z;EblknXq&V0@sLvtl*QCrFqewDD&+T(`G)H^$38dgT55ECK2fc&F3lZw%%PdU*F3X`mr!I3QFKnz&=Wu?2?wpq2`TYT<6{Riq3Z#gH&Vw(l@vB*QSI$46s&3K4tG8`koWvTHy_OA|C0l9vp={y{ zM0CJJEITTu`NUmGyj(s})BsE<9no@$ur;F3nK^s5{6fGUd}>EylMUEP8+ zW&y$wzFqHnW-Q|ZgoW7~VLKxoPMbOM!VemS*1cfnznPQF5>hBR&96b+|_eFY@Pd7e& zmbkF+toKKQO4Tg+4U^hjdsTL>yZm;$!9W|R;mo$yTEX#dz2)DD$kDF>mO;2#*1%O+ zFzujuzuvu1HU@T%%_}1NEah}z#P_o&!#%!NpBsA8JSTSblEyFR8kGIaU$#$HuoTaAd%>_l7jGuQ)Cn2fe7Dr%Tym z3Xz2jS!rxDD4tKkCXU$XXzGyt5d&+$pWT}78e_Y~#>HX&-h{hCqnGW&wvwqjhz*l zU1fjBa{Bo*$b0+yZaLwFSD_lcz|QNaTA&lW8vjkvI>Hof z*9(=`fm0cJdKffK3djM$%7l-#v+r?N-6^5DTY8&r3dGd zoj7rNEXwO+uO_T=O1sdoA?I|edGn3t<$wFXdlj@~^y-bhwI3DbtdD5v5qoA3xDNQ; z?sadYE`?i3-+sKj`fT{KIv8{I>K`hjCv;DC-t;GOSz@;10A7!tfsG5cvCugzxe7`#*t3>+xO+t>Ft z00@5$BC{9?wz2ZFXGZ-NS#>@s@)HHh&$<#UuIrzuX*XTsYGcM~DzH_4rL25$pY}Z~ z3k>*&|4m_^SXuf^`wRV9F@ngG@5Na&mo?q|5C1{)Va+Zf<9D7DL6`o=-kqHspWLz2 zhb^r$P3T_ukzZCkE+|kmSyPsV6r9y0vmLM9kd9PK8{8OVaI{-mvFmj|Uv2U3J};>% z!qR13|H;*{6)$f2Rs9GK`qVChvh2*X%Q3chF5B zft}rEmMR6`1rDQ?@!@nId8GOH@*wp~Uh4p4NN-+JNES}6wd@y)?8ju{wcz_FXFmZ4LPB`CC~jFGozIiRP_GMArZ>+D3a%t3KE-qJ;zbhi?0~OJhFI*EDOo(tNcOz+jAvfn*)u7-J0Apx zvfl6g*&+AX4aIqtiw%=6oV~1GsAOZH5u07~?wfX92mdSn(Z?sHwbkaoJ)L_wQ{iNF zi&MM(qB&oa*M?uP=wH)LV^_f^di1U3FJzAUW6Nzrgg_l0R=LpsQR6o+iRm9;83 z!oE;3BwOgtsL1a97Xv1HmZntGnRF=jCs3T=mBv~Wb8K-)D(=*!%e_wm_IV|1*|OKj z=&=Ygs%(#61{NjG*lAs%NKHAnv$7YEW z9j4n{bNfEQ$YxQ;y(hJ70{T176-SEAvZkz@Y4>eN-G1TKmUwy9@pCK-tijJtEoHy@ zEE3pIwalG6x8)t31u9kHW$T^Oc&99~(K;w$$BG z{QY~%AYUZ3yabSN{FF+U+V-+AmEQpTAG^Q!`C_wxasl$$+2Y6B^NIXh=L=uwtG*I1 zj@j%e8k=SBdT!nGa7T%5)~Xt(OOtf?DCXIG@qwj(7Q)5gPXjU$>kl6u0AoU(V87PR zLkr9~T1fFERMdauk%WYVk>ggHajPKrguWYB|LS#L6nffNJzHi!_F@)tTmpmQ5eqTWA zX&I%bv%c(aJ6|0?Y3XUT&tjRQ+p6u{pB$v|0D=ycc{mdd9ablHiu(@eSm|B$Ika+NenRAl2|vDed6Mwp;+%z6 zsah<6>i6L7a1AfnW_c}@IN5UPfh@hO;gv%q3;Mb2#R~>+I0}ms$5n^o6*$_8ZsmPy zfUjgkH9-V8asFpyAqs3#nZ8xLs^`Z%>zV6=?8Xmm=ZEW$>;Z1+MRa4#`G8n2U%cql z={fUGx79%+X?7J@j!}PyiJ^lvZQJ<;n~0y5UGFg4ecS@~Fa_c)501QEjCyHC?L$x# z9#SEfffd#?d@y>vwNnq8ucV^yRV$^!60?A#hS=}}OI~<`pP^V9sXG{A7;sJi6{dIn zSrVi!q-$5g6d6Q?rrQ*NF`s8o9X*anK~4AK9$(w@_dlK3vc;n;^i#prwY{9rJGXZB zSJ0A~cXG>R^-zV;@;yWgDy=F9IGk?QYWD}Z8u)?WKcLFUx7Rc;@-gVy^H^gFG7Buu z&dzc8E`yRx+W9FeDz?bJBo8fixBJ&)$XO?hAAjAm?M?kW3MEx^BO*#JaO>&qseX_RlZKjxWT(SxzMuSVB5D~6u~=*nWyIFTMrHM}TKl~W zgG5<^&%VAsu0R>A{SHtrva@>wx9ld;u;ny|FHp_SF2U4w5sczFC0SXVk@1Z@=+6~A;%Ei5+I z-fGGzjK$;YN(TUVQ|5KfDkOUjqZ{R^v)i;fpwJ?a z)Ztd{^(}vq$b=3*mYn>P0WiNBPL!wA&hi@WN9+a?{e|ZjcPuH?j2XV=-^kLd>SGJH z-FVrxZ_wGNJcQU~(_L$@yq=2-&xbMI1Uaf3IShV3Wyy5)(PS_${O&x!HFS6PXEtK- zJ!84&B3=DOpH7=D9Gs|;cC0Kd^hWc~7t>Jo46b@aJ>zwPq9LVst&h(>UrwR(w01xI zN4{?ArFP80+0pU-2X9oCf=B?d6;A_ExpPE9{+h5Z$gGRY|0o^2gc!L2CFs{MK_RB( z*8xX=cuQti*1?vQZ3J*JHTCF8VnOoXW_>dyO-n5urw$=AGMpvL%adka} zHtA5Y6QUE*nRCkFLFxmiv!4y)HD7|vI8`kZX|g?+Hw{_U) zW>IcI{2}pW@%*fe$A?=~oE1I9%F#NVrgtZGgL%4Z?1kea=dc5blMJneU=}LMe`P>q z6uT(th3(Iuzt(MnQRjb9sltNR{!7w#c8SeHp^Ux))y25hzkiVxU^5ZI@o12UqoMq8 zy*85T&81nBlH|v=Olq}*#N@ySr0TvY8JjM%3@rMt-MgcIe2Ti`k#+vdge$V1(j%Tu z8J$Xci~C529qrqC@`~(~`P~g{x==HSWbZ!z=rc2X#6Wd7+)(g_>u!`{oQwCg#r<0UUco6^IK zw!kUSB#V6`_OZ_FZ!CnFaLakM-+gq2f;Qh+7P-Ye1EM4y>BTl z?o_jZfaeZ<%04Vn-Y**OzR%0E<p+3X3!a3ulLJIRffx z@ofI2vB|HwoY2F(@_eC#^S;;~H0T%>_iF$c_v%MOJN3|6`=z6Tnq!5^u&tA_v=djo z4N}bdBQacPwXF1dILc%$(X5+}pQ&r2oRfXSdK2IwY#~Y12_=$Oo1-kO+DNqU`N@fI zFNnP?dkkqiMP>*u%O;TP*S*MTb@QG5QNZR&>-#7-C>HF0=nS>|DEmQ{l}l z<9CA$KPtPl%bWgp+Pk>}l%~s*SU{}`3EWo9!Mf;iRBPnVGRf8Nz8DxH`n3mqy3q;aA5?WN=$9c-wxV=2MMVvS*hD_ntm@yF!N< ztwjS|sxGU)PQ0s=h55<(%CCY?4f9-Gmu}vG`yI&+5D;4C*@0ewLV}C1d0hd+266-! z=U4Wdt^n)^u39>8bOQT^+l4I+n<6*!?!2CH)^5MP#828~t27x#5(cE=#Dg}A6(fcZ zuP)DMqBQZ+`uh3BZrQoRX%yw2n_XBJ&8hdK-o7wt#WdP6reU`4<(fsr5cF3|%Us=c zbxL;6phWg!2Dx3KU*T`yoF-ZNs?IKj3+K+IdsWFu0WmHa6|wv#JLK7g*t?2PjlNEjkE&?=O{?c2NGH|*NCs^S{r4wE567PYP*v@H75 zYBz2QtdWctVB3ucXQsqA(h}?{NEh6ytY61O^Y%=omnB(xlkDwBZuoh2Y`w$o3*s7! zR->fOHzv*5x2pXniQ?HA@sqnI>&7PLpgAmgbMo}Gg!#3hu%(b*RH)46x9xGFzkcUk zWAOahvqh7_S)(0cdas^0Bq2DMH(_w$v6nr11`VV&u$j#JJ7ncs@`){qzJ=Spr7Pqu zw?GxbPGl?1*+a~s_YWQJVr86kv%D#x)_#ICB1=t_H&3ZuDGi$J(Hk!7i(N4jiV;Ul zz8xKJKB@bpT$B0zGA||jBb}@7JQ1<_iZulJW>kzz*wk18s&Q|N3+t+;!m2U3zxZxr z|GJfb3NIKt{PptQ!&=oZc{wRPDZTc^{o2FBjkh(xjuNYwJ!Ur!pe$Z0cHdR9^;1pF zZQd4CI;_+r3T$ndN5?M~vK6 zk3YIR|CVwkDB6sYCe73Jrw`AY*+D+^WL!|-uEG6)Q6W%r)~HYw87oY!Z>8Ldr(evT zAOQLN;9+fk8+iwz7buW-ks`ATb@WD~k4p&|hqdds>Tsay(?a*akGnxY>t|jtt?A;S zC`q0M%w*m2ejm+^QJ?{8E+lR@7MOq4R2*hz77x*h+yRe%+~(r?${+su+gdqb&Ypd| zzI_oo1$5ek(ZfJo(`nx`NJqHk-O&&73rMVk<8oR1)q7w}!R@HGOt~Dqxh;R*h3Iu2 z>TIAdH$vvVq(h?WXO%-U3P0O4;D3FbU~O$-;Yh1D)a>PDFQ>=r2F7t*p1XW``K`P% zBy29JYX&yFKyLQr`zI}Sbe%9%>0w!iRQPS15l5|H5&%p>@WOa++V*=2yDP~ET^1uY zuK3kA!mNMUxs&04<1$wcotXAwwB>Pcn!+QwAM1boIKcAk>Uqn91Lr~cf)~zw=nBlt zj$z;#`>C2qPNC+W5BK!Md%?M2H+k|BMkuBB%&nm>k-TvWhDqt0H8bBkoWsAv)@GT7 zSyHj>YOX{rU(m|XcDye&YGHySGKfH z4jA8<<~nF*?KgZZGFv4RliXxEy-v$(BqbdZF!S@LqqPmjCU>7X`3XHlad9kc(OmK~ z@I&n0J>^73?RA-i$TwSJx5Ujls+B17M0S4GvX%+G59XJZ-GuGe+gNu8bkN7!o70~_ zu6=v=ZbtDlJY(y`LG0wZc8&b?8h`eo4gb3Ftli zi};4*`iA{JkCs`9j&EXh$c5Z5?55y=_{8ir0NEJB7(!wfn4-PDjsY7s0Cw`wAsO$t zWMlO+MEPVWyslUY_=kIIZ1QAqE!OtL=IK~?#KjECb=*V$%>XIFlH*c7^Qz~9@E-j> zX@${(Sk^_o{yxRfc=@trzW`4j+`ms|WHrI|3??+m36^V*kNh>{{TTVOF5?47oR$%y zm2yA6ZD@gar4f6CI1)g6*rwm>f>ru=Rz}tNlMwMAXVzLC5_+D*#5#I00g2^{&0N7Y z7P^sDbe_b!O*zcU`9Xm>Z_CBr-K?h0UeDXc7+vHdV4U}TgpxfMk5}HQ;ts56?ZrxU}X7NnFaakKjXQG>Uv#F_^DG#8e zw5}}<1$9+jwv}P6$AERBS+i|53QvarStW^Sv$2`GjxP!Po2%90H{Rpten-SsQ>JwA z31keKK7CS)94-PO#U9!Hkl4v#y=lD>ynx{WCO_J6rR&&GW1-&}=uP`Bq@2aYnXJ+b z&6kt8Lk}%}>e*3r^Oi=B0S!r81( zF)`gOJocCs(oULQ5d@mcNRlMdAWBL~iI5}-r8JPpkWeW?iG)x@q?9p;k?fCyqxb^J*YZPE$=imXdFcGmv`<6HYgC7 zJOs$8Ss-oueWsJ6b`n!I_KF@;QSOq?*apf9r{i<@s@&ogi6w1X8f_->)`0=J2XW-( zFTl2nU*z)~vNEPdxYJ!w?Qf+yd)6#DQH_k&B>ko%rHfS#jEDzcKE<(Y5uxFan1Qc6Q$*2iN&CzwUK> z<^F2Yj6J)&wlkw4KVDRwIt026Tsj&kaGB3X!Z*PE_LWKsfXYBkTY6$Di;ejQrn0kt z6n|~jk2`dT^)L5F&B8FtZ~65(#6(&pM<*x9%L>ZMuq^AS-f9j=AGm(>-(x0FeWq~N zMU2=`OcZ|{oxwa{H7+`IIam-7BpCt&Q^Bkhdm%2nUh(%E=k)q49kbBE>Yll)eZ<=0 z3aWRj%x9PzDkjl9xCx)5B%fg0_%UTTSZGX{zLNDjU!x$NLjs>WU>$zxqKMtQPfcxI z+gy{If%*eA8Bk1hRJeSSrcir~fcHQQS~vDMa;ePLwlrzNEKd%SFSnYEoqOu^j_-A` zzrP%|nDi>Y{Fa8wKQCY2tTSC=@=rzVsm2!BQxiwjJ}EDEe$?BKD9VHkB5SXlhF<$^ zlHe)O1PVNc7dsYh{@QQX?ays(N4SO*# zBE+v6d9Yl|YJ_m>G6lgLY)Li+>{Oe$+d0fqBPV?%Xz)n)-?xin6iyrw`yzHAPNnB# zNuUgm@nLrjy`7fnX;xa+x&C91qXZDf;U0I{gO2ycQz-%nLL#mKd}P8(^5fCK z;O2Or0Etv?1tp!|ctoL9_Rgx86>CF%+@rfQc#-O<98K8DGoAzghNycxmf?^&=r@?q zUS-3i>KFm#0v>?CDtxe*J~O@fSr4KTufF{^Vg4o!r)@{3wt|u!^n2bnZ5bHzn>Rxg zWsj~O9u}>%pC;{62)2>6ONfBjrUC94Ak( zD(FRZ4gb$~+T*cwr50`%ZxtjZdGI4kPn;pTO&Dyy@lDmA6$iQ!Kf(iTSbIf8=W9Z% z%x8FNo($WXU|czVD`Y>ug0GM9Hj4{LbVUEF2|Y%37YO?MfFX;%<{i! z*%g)CM}TO6z3`MqwAeCv@cw((bqry(DCxT?Li|feC?HkhQ-Hbyo6=TLQo*{`X~_No zqph!;ntAv3?bG!cUT7rXEh(DMW#GaC1rbcEPyM}p#|{pd+QeX@!QJ(GVe)4Lwut@$ zmdg-_#pq)aoBQ0KuA_MO&YjRhd8Va>q8Ha9Cp8Xx)Y~DrtXt9{aI?9;6kuY*QO-KC z6{%0e^n5hl*{U;V7HZYb|1JA{xKqlgf{Af}&NI{ARAp)m*?Q{*%n{JP2Q55{0L-b( z%-kLb;(aXp&KDiO00SGf-RD@u(|^E0?aUX5eH3p$yYrf5_A}G3L*-N3r|+)8CuqyN zgdkdt?t(0jOD2)*o1%ohJBY8MT5kZ`yh`6ZdGg5%{ ze)_q{E71?kC|!1{IRmMH;9dE0I69YMfphj<>4I-21wW1YDN8n_87U`qr)|Xk?&x#$kBH@g6`~>{ zMvWS^*mRU31P~eBS6S+A7q9=J1l5cw@Be*|RT7xnh`>DzD{U`nsbUtm)|!0ur1u3L050@V%28gI11qOpTOoqC7XWCTEi<8P(-y8qz8xoZ^# zv+dkpU0?HN=Z+n>QK72KODq2DTb%UR-U)*;*~Ez3^`j2fLPc?I+fsEAY$4^HA2aV` z3$AN~>BtOyCGA}z*nF{=l|V*0a(U_F4K&n@ocY`&C7_eQ#`?$a>-83o+H6ocqpS1b zR-YcGgaoy*{)++O!Q?(#4;?(Twx7*Rg;vgA`cWNfwDIHTZ+w%tvZ|HaVLNB428}AE zZm-3pIw3H6KD|!01y&M&HGMNR&sBZ-c&rExBqkcP?v+&+D^6;EDSPYp?!#$5S5?%- zZCsuPSoPI|N?wm8rNPL<@uWbewxJK-L5C77Kqvvq2W-T3Q~dUI$BBa z#UR%$7#T#5?R&3WVbuNS0I^dybvst^Y|kz6#nNrIjoI>nkBA@uXEoQBEz`Y!uNbd* zsW|_+^7_;BgFaN+nZ%Dli=4?m53_KOm#+kI#hW)`zj?t#>6i=A6<9hFII7-Hp^U&_ z@oM5niH z@-3S3Y)+nM&bDoniTd+;T3bGl4T7g}S;AZ9l2*O2b&-q^IXo;$o&tqY=mAoW~w2-_b!NitA_T7|4t{5UM4Yco0G-tj&}!!8E$=DI*Wet zT4DEBrw(Xqs(68_atBv$INoHk`NN@#!(Q0NuYt7l`5g>?7JD|r94nX0(&^Q=_0#o^ zsP+_kr1(>(>iI)1m(OQ(qu#^iVzr&!z8~vfhsp0_v}@^>LOBcS{=TWn(64d#@gt2b z^mty?nOzM<^@ZgZTem&j*2A~k6xYU2pI&CnH9(fnfJX#WMet!nIPv)!lhbrp7|KnX zmdbeJztgfw1z9)x%%&Tt^Qh{Ank%Mnbn<19S$gBq(mC`-9OaW z(_c26sVM8Vk2vobVYO`8&>Zdaz$KF!%g(|M`t)gk-lE8eFY<^XqmCy2bp82(#=Z_-KfyjCTwu{H9R)LNjvBA058w229M=nFi<#hM};Q^2Eeiw zY_E&fJCxloDe1G@3SPAHxEUIkJj2KDxc6q<*s(g^ZCvCrE_O%sDH+<^+C~xGX$h%3 zzI;KQf@_PQ;)jn`$YCfk7v?@L{Z|uwtX#}p{}q&6JLlYCfX4`ERa1MSfKYV*c zErLY&a355A_U=8mIr%}&X{J6-8j77vR=%>@x{xv_t)D*Qug!^C$=#?X=B!_T8QP!I z%KgPn_*0Oxs;9w>@cHC-WrwC|p24$yVHaRx?782FQ8!)e*3QPmzPpC>N!LE@>UPk7 zmr>U{oAOo8MXO%kD67@c*T-#(Uu>(|s%k^6#ghS!`vLaSwqe46yQ_h@PEYTkDW#hf zb~SkfTY`Qwox`8pX6MG)5)C5n!d~kAHgpS+G){}|JyX%e#k#k$*mX(AZSyTu+GNkh zY;sL9;im~M@9==PLY{ljCneo>#*94{>Y%2AjQ?nvX_?9xUspC{@j$x1p5MxY{K)TK z?Q@%z$4{A(xXc@Z`wtq7AR&a86(o#T2>Ao??Ydxe42CMu%C7MvYn6`lci0%DUX?=jv=XOsFRPZrkyDN#R1VrI$kXw8Yo!zmcr4Q6}7S z>((xSQra%Cv9Bblz-#d!jTm2yr?tm9ipL)rwzPY(J$uwo zy(u=4j`QY~e90bQ?B#H}$bPpoKr8uE^aX`57_`;G!P|ETJglfF-(8lj9H-G(;(uKo z=N8#H>wdkz4%0%-7@G`*Rz4D~-MNB{)YSfi2I<*E15M-3x$^&j$ks3ygv~=g zI=D}t+20=npa4w%4?dZ{O+||1l1}!O;u)-lgAde^eCx zV%+EoGz1X8)4pZdXvxaS2@8W@wuB9NaD1Fo-C^}Vd1;=SgFEKyN+>!;JX2_MxHH!3 z8iEDE)t-TC7bX&Ha(!9hE!eW$_IPh6BP~4^_}A&YB^`s><}WcGAJ!a>iwkJ3XaYul z@PgzN`DtD-mo&v~fsSlPF3UXA($km3duysf^6`44E&`09KK+l&q{WD;Jc;52;s#eB zV}6iHuR!L7rKK}a?+S9mrH>_T&6dBh_8(iiaN-q3+Vi`2&kH-03wb|nJbO#d1H-gzf;$1P|{a$MCx3p{q3D0d`yPDGt3t=J_LRFl`@!>R)4{plY7iQN3x|@U_QJB z(l@_tVYbKA9Q%^8GMB}oUPyjXg}BU_GsCr4Vnh`j0SuP8;~ea4rejtymtK#M*KkW> zcWHGkhw#CAJ^gJqS{_>xoeSI@d#k<9IRENx_fUn_2FM>kFh00)J>O=tCrx{)pI_N} zb^Wl*{rp)Ww`A=#Kw|exUb9<1b8z+lCwuQTS{=BTHI*Wt{`=!uu&r;+fMW%-zvbGH zjmnT3s{Ij678sI!7#YXxa)6Pi4OXPgMF+~U9F=L_dJ~hWcmcx3fD=W|c;Y(&1dpPG zjNuR1o})cexTYAbPE3o!o|Y*V%Z)mBs}780--f;oN~1T~zG z31lqj9AuS^x321_5g!&RKBI4+a>4flaG)oRErtDq$Q@x> z3$7SpwYU6(z0(a8$)t+m%`NBGx7?~{E~#d&SK?H9RD6FaQ}~Dc<&4?M`cG1PIt5V@ zX@k$oa@CrSe|Gl{cyxDp2`t%eJ&weGNsJaf zI(MV&!S@y9a2+=nd+P~2Ne~tKiLBO`W%mzp))Vg^T$9s8CjzDy@~Tj5x>+t?vAEc# zdKf(}J8xdFh^k?HKkNO2^`9>g7TDR@*tlL<+en~+oy)2Wb8w$DYgW~+d~uEQ+jX<+ z*UhU{lUTvV(yZIHyiLJD3>@w6e8uhBtAD%QkuH`h6-~XA-c71aq@ZZ1sL{*z$fzY; zexnKOlddCz^iT9R7(RR)^dkg9o;_O=J)h|nU+>aA2uBUS{)G$ccyJ#o`wqFtX!H{h zE@uF`!qI&m;9#LMO6AKf*?|mb%7}^b0o10)KVPywBZM5Mkra3}=-%_BLx7E!UWI#A zT1$a^xyJdQ|M21b&C9I6Sv7FL0A#nF@vCpdw3H3S7zVpBJ{KA6u-5aDH(_C2+@vvM z+O&6^7B2cc|>X*fo#Yw+co|N$uiY)A&-Pz#b@BkfvvDzJ(F-@UDk-o29JQnD&-P95JZi zd%EIqO`Dw4ck8ZYe;;g8W_8-|@!8#mmD<)$A$r-vj#-^PtEJ?7R%6Co3o{+};DW24 z)P8L+m{hu^wxw?2(T9sJT+17;vG!xxzd^%>@2+X{>?<3de*L)Yv+8PrnI(7wRAwRu zbNV0w;Y$fa*#QGKwl<7=x+^uU_+_AM-&XgteNbvUA5?d^^`JRZIrRJF&R}K6+K4BzyL8B zR5RDQSqB+=Zdd;gGaTMDH9a!!{1ht{yPO(X^i?eF855s5+3wxbLBne2BMW6)<=Kpk zO}|?5#(%ZkW+7m}YFmEPQ-0!=KvkV0{k((NhyJ?XBIjkfU5ILns`5!PWKfxbfpht6FNav~{|c0yeCj16_txkE*Y`#j$qPJ4CI8J0Q($ zFqC1NG##P^3aw6&-GTffaHx@+t*)A8$#13h!v z-W&*dCfX^I6oq%Fd>$q~+lS&3YJXXAvBO_yI<5mR#(zc@9oywAIT`#o5oi~5X%H?^ z%ufU;TwsFmh4+{!8;)`)y7LZr_oC}LsI&d{dOz((r3U`U?s-C_?Y-^tNun+3RyJ=A z#>L@MM1S22+@Z*rh5Gx-%z>3xb*CWbVZkF6l82f69T9qdEGAP7!4x`-oh&L2(eyMux9Gcaq&GVd@ z-NWFT!`nk(fGmXZ-Vd)x+Xat@Hks)+nmIxiwKe zg7K`J)DQKI@{*sirw|pkuW!tB%WWpuX-FS8OP&ABS7;CfZc2c9f<;!Hun^2lzGa)t z_qSx%L-Fw={#;H<(!}?*Qw-o2@I}SY!wOSPn9sZuUS5#Pv}*IfU(a5Wbb*UmwHGze zH0$I^i>n3jC`hRccKy~bUw!I!*fkri8kh->?`yWDX!)ov?&)Cd9e!$jQUp&o} z_N`d8Dyn+D>LtQHmg9!1Q{OGVm9X}R|6xsON}L-9Hruj{hiHl!nvZ3(Uf|69|E*~{ zu!yo2Va06#AD&KWsji{n?0>(jp*<9No$q^#a5d@2D>hy%mR@|zeWA6;qN&z-Nb{`l zfVz{DcOVFX3`OaJBYFGOR%#)#vTt@w*>bWT{1ChyHeOsbOWtZ%_4;n$^ui`mO76JC zD|Q$$a5eZ^;G}e0PGwVb=d&4%g9D)B?L9o}x|Pl8`YASH#?JwlFI-P>gET7^O6R-e z=uTlgdQ?s<4TP(T2SN)qB}Jmi*r+~A%~!|jtzpUWl&EU~O$SmQ#xaXmexh;deqG&- zbLaFJL8A*XGHM4dp*TDIF8tz%T8a~#R>VbZ2d=v24(<%ucS|;CaA2yX*(dA^gmLWG zuiZkiF=(_OyY=sHCBIq;adE5#DPAx8R==*V*Z9>acAkLb1pbtiZysU zS|NF-q2yvQWAO;FvChY%55%ftfDiJ`nZ<>mx2&v3PBjGU8Cm~O$;OXe^O^~8$!Zw9 zzoF+{NK*GZ_nY6daLzNvinR#`NMjO(VVI5;N2D~e z1?Wj@bQ3BByQzor!1e@(cY>Y`M#&i&!cOnNz-4Ai`j4UM#m56V0LRbMt0W17@ZIcu zJ22&qWoda;RqviX1sxnroBRd)7U}Pj2`Y^lV5@4Mj~P)|SQv&Bqg5juX?AV}NE>Ue z=y|E?uDj2%m&Ow>pO~Rp9@0?J9oJLE%R8pM7hES^URjsge122?t!@NIjKFA(ac&}9 z1EaBTSX)aAiE{vTp`h;%MPr08(}%Vkjt&-T2X55fy$geWVtViSP;pIRGyVJ-yl>&- zGjo`{uzpWVVLGnuPqNj+6vJeK!ihUi1TdAo z3=W*BcQH2S){B3itvYU+_2@wF&bZ7S)0Ed{oO(Y&I(HdbW!)`@vv5;wdxhC4TiR!F zNwIIG56$y?o^t+t7xe&$%nI}kWiNe+&n1m(F=R3D&Nu`YEMtY!>Ol!Jt}sHD+Z7uZ zC+r&(UhLGxyx4tT+Ulq5wkn6mt+zV0loP`iSjrS)2Zi9K=)jTu4XbY$qCwEsUV)o% z&u-z0_m<}f=m0|*uX&9|o%Kq6TNO1&AGvzee}6>8`?>-?$Mf8!%O*~iCo+u>`O(G{ zurNTcf-k8ms*_n+{ZuS>UyW?g10xNy&z-;fjhJ((^~|i;A3uJ8v_&v8xA_9X&0k_V zbZB@jgW{(l$=0$NNqwHc~*D=H4#vf(35O0ncY?g;@BNd zO>BEFX(DNq#~vR)KYqGkBgHKHthsLT1#&vh8j(#pXXipEREoqV>dTi4(?%~V?wNAw zaNI};NrJ=}6y>N~7HxQgM$r|%;vd1iI%NP$hkX+;6UD&x?AfT z)eum#T^|JKx!r;~h6BBp0&WhYRC`#SeIj&dJL@|-X?;bHh|I$CU=%|M3=@k-DtuM0 zuBZ@S+yV*X4^Ckt*-8Xwql&M9!^+X9@Zg4;6$@5R)^}ey93iL~;G=os!vOU!ti~CO zi5Hty;h59%0FeX7GG?$_*|=%VnrsK1&-^+Ta}@ zscgFZ!4Zmi+;zejxU2TiA5}j~Dq%)`q*W5g%BW`Kq{+1UfkL-J!| zV_9hf=%Vv+G=j@(=!$4c*vE}JhB5)w(x3?&+ISt#?&4-g{oh>}du`gsl(uHK$n>yH zJIhyC*qBrJyQHS zV6JcZ6U+}e5*2QJ#6NY%tf95^65p|&NjbeZlv90UA68kf5f;djD&*uKXGI)%=mh`Z z=eL$k+}hgO1tNKANd|(#IuiaU+5w{5>c$<~G4A^tY}(EFxC0*86AXp@aId`ewYJew*Izsj~dNN%M;ebx|w&t*%NtU*5v8kQn4 zJDdT*-MiNCruz2nD+C~jR62^yFjyGktM+K2WhzO%e3qTyW(h~I+_7Z`!-Q!FY>9m9 zKUD71J9~WeiYW2vBL?s1flm7yd9cgnQ&>S?kG)eC)!dVKB_1J?+;ifTqG-iP&7EX7 ze`W;%K~`%50}pP|m)H57krYL;#!`duM7<+qak^hp6X1NxnI$>;VaDBsQeGLxVQ&!~ z@BXs8FBgKZzeq*yns$SzHu)E?m~A>9wt7vNelp1WBWtLH+C3nt$BxE41n< zMGi{X^T%H2&hngJUq48#RuGrg*ca+OKFoLu^()(8PMumpStr~wc68GwDn<5FRxTz_ zgxlr|gqLqi05sX}t3L*Z^090&!Lmq~ZL%2|pbM(*vy(0(oLhP)qL1ygQ)bT!6XZNw z4?I}vW18*CFwZ;Xw8Kgur??ktDdF6?;USrnm8BiM_zUO+fkT1C1!jp+&A*U^vB26l zXq+%um@pWZG{O1$VpkqCt>bZnesnuIy?$|Sf|2{Owf+lqJr)86q}E+C8!>jQtJ~zK z6FRe0i)WVk=wecgLws2cgr#?G#vv?Q}S zPOOmMnm>GiEe|JwR(1S@v8;hDIt0EFy9fy-z#rE})jZ_LPo3HGfd%JeEhq_4)SWu4 z_OoiJ+tnw9f2g_`webil@%E#&#oG1;UjwnX-2UD&GHU_?lAD{k5L9*pCk9`Fj6wRG z-@kihMTH>JK^`QSZ&5@tR+>FqV3#AvI)oQKfnS(l6-}73U7ddYKy>ykshnmth0hTpPK%_0n6`u#lqx==G#hz$~QlwI3J-DNeNF!Bisj8>|yfi ze`Uee|4JfVxE|`$CJk`>ARB~(n$mnUW0R*ZK05`J!P89A<@Oq3^7g!H9rTC63{5>I@-?8si3`-3C|~v zRDCsw72n4y)ozIUi+hc04I8&n*f0Ejp z^7bGWcPvcgD#VTxYNMQ-oXNYxHhs{4W<7lwUN%SMCZAy+)ri{cGd*(yQqR~j0i18Y z#adM%vPh^N(Ap6Vfz5`$fE6|h)6tE?5_IAHmi~J=XqHmpLy<{b!l$nM-VW0q9_<&~ zqisRd?PUFB4F(Uliuv1RACXUTr6ge`eQ4mUQiz*v-@Xl#wmh-i!)6PWrc~&&XRaUj z?~nd@o2I0BB<>fdPW=P#FEUbHd2(IXl1T%6FzhikF#(l8>`}b#I`Ce{If0k;p}P@P zr1Q?RonSj9uOIa`|FM|31((Tp%yYOOtf+?SPEB_Nzch~(mAQYF;XYcPdQ?&2{J$n= zPpfl&$A$^qqmzj@>nKt^dQ^NP$?+B7iOq7+Z5XDd{!wiCT`E%clVsX^DxBZhKwSLloVW zm_bRgeEG1>T;#O?3-bp>AD*^RZi*A*h^@GamZd)CDa(uQc&zC#dQRK$rTM8K&Cqw8 z%Pm#+bQxHezh($+Wb@glbNK;2KIsVwsyD7V3izX`X%!`eQ*3I&5+9$^0BIG$Mi6vH zVfW4z^H+*(>E0&se%5TMBSxaNo=cCL?OU$jU0(b+YcSM*Eph5+G10;(bo#V+A!5;I zmuEJ|{QI1VCma1fEIVwoMRGC`6HT;=vhw?y2z58A2G+b_ycE83=S5e&l-rY~b9+$f zrsWc2xnm6Dn3mI8a?A%e^sX!_>Xy?|v1i{t)~Bn@T^_3!B7A%+miw77iW$CFZ`e|I#VkX$MP-p<&0-%#6`q&Yt;spRNUTEq%jy+-efkuR5batoTVEtf6J@Xc zetdF-435I^_qP6M)3|)X$(ALz@LDi1!Nq5L?lZ-;K|v2oOM`!Y8BX2ixI*avHsce` zP?iTnN{BxakgwUlWCX_9&XyS3CRmJMCYPqK0d*Cws~LeBwYUn z1}wh3-%(g)e=W%1V7Ae{s;VH^Nr1I}H)eHCf>ixK7>|Mv9}mtZ?0Z+Ynu}{zGaZOb z-0KSWc`VZW?_>e7~}DJo3V;Ou>GetMrr1FTX?%#+zJEh9r;PO?@Z z9kax2detzs_q2ECKn%7pX7g+1ZLjXA*AZEmTbPHA;6WOMPIyw?Df%qxE#@=7rBv*F z-R=wC6&~AHnpkLs_O)0fniTqWtDmdLMbtgBwBv)Af|!RW-MhDvMkB;6%5TQtDH4yJ zaa;Ib3D3FU=eN{1HEqPmks2vIU3c8OeTyen`pAQWVdwb z5E1ojtVe}2#3SIIJ9AdMo#(5-L4ro&*ZP9OMC$xjnKtdhg`rPGy+s#AK7Uu|tTngj zQ|J`h!FuSwJ|mvX5v-dZEwKBsbwuqMS+SAgAG_s?+6*kjEc%MZnOx~35;cp~iY1B7 z68k8TzpZ+G@^lObj>=8m5o6Np+3i?2FdR~@!fq}0x(aYo3qzT(ia1w2$p2EIkczms z3_ijJ^{B3Uw<1{?Tq!nIBEddiB9v8ATrm)Zl5H8VRVEOeX;qV@{I95VRqeT5AJS1~ zDsZ}v-{VeU?S#1W+U3jNc)H9B1R^@(R>om*z2Ab5aKzd^RO$bE+w44I-FEe2-{Ieu zpIPAK)K`Q@hmoo@mij&*9+Ph@(#Q-VAu{#C7xsJ+IJo`BYqNLrbS~C~-0!Y_%_%}m zvb~#zWJGu6p)ddWQgU$Ijf1_T#nn}>+x>m993N7zsgYZfb4Jx?^@RHeM}{}f4BYzf z&e*e4s4H3h6}4}lD)LRG5C=<}5%u#2Tl(m-X*MfM5QyV*&yk-2-~@idB`zrV`9S?i zcZzC)45PL^PkVH1xDG}*^QJ&WjQ{lXORh8>C6d+l70;&wa{Z6Q|%3CdcpR$|PBm2m`H*3ZYA~qEDh`j1(!ad(iRcC|IelO z2Xwu7vX~ARN+RP3*&9oe)?;=&&djW`s_Kp2fUpWBArLwJ-yqOXHR7_yVdKkQ@3+NG z`xZNUdB8))|6uHPTmA@jMXLSGAU+b}$R#tZi=~w!P1d}=Bk;4}k?l!1b@HT0#PoXj zz8+A6s)A3u>VZla<@R@+&!r9hnGtVRGtD`wN? z(=^_=Vg5EeZK%R-0T%pK^2j2)d#gUHf@l2VCC*55;4K@TLo>*O!(B#>~{`xJMIrXg$<>$9RLC(1^9x0R9G@KaGSi7PNmYSW&cSy*U+SuJ%cqxh7ilnRq$ z5A>IAlDl|a7-s=6(CE2fZ3SS;9u?MMQsrmh_`ZF+xZJKct*u!PHZo1o{1Z%B+puB2 zBd;CcC+$Iri#KtPIhH_LZGZUSy-j{!$ACkNtaXk1WLQ{Ga zV3rJqeeCxZIi%c_^65KHD($Q7xQ(b*@TU>5Ug$?$rm~=1uNRA1@xeW2e!|ey;;5H* zF5i^~GCaM#?!S$8i=BAVprk40q)0qj^% zzU5VKNN`jnlLFq$i_j#=i|DZ1v4qUcTO2X+sc40m^RtPAFN!V%D>NlDiMw32y?5Xq z*5`_7qTg5=`p{=w$YaBwXHcG(Rd|=a4R14M=&yOnq8+t5d)+q6oZ>&E&%zW(r5H0In{! zH5kNQzkPa8XG7w-3l@st`G^sovO{;xn%S=!p<2l9&)jD-u3lpY^~+`B z(ZXz3oQAxVBArIVn@a%7JXR=$9}5f=-e4d}hly<_g<(%6><-ed)U#iFt^;^x1;rD(UCWX-VIz ztv!CLQ92^Io6L7X%jmT_Tz)u~f^e=@7QDdV`exUk)scD=T4sp;_GmkBxx-Zacy}G| zO{wW!OZzxNhjN;E%>S@}qzZR_A)iiWyZYRcAz>9#TmH4O*#}dA$<2lwDBbB?aLf)}2v$5tYCmc`5G#Wi~*}0Z` zMee6%GupFU-ZGtmeOQI`xE4sHlKq<1|>omvy3OUWk-e!#d+`m%KQy>$=u&sO!6ZlxyZwiS{g4GND7)b}K zQOGQUM>kB6_tMi3UbvND?iqeR!#en&T_qtvEjE`lmL2J}VKcGUrz@=7aFce6@v+kAP9OKQAvY5e1;*VJjPb z;$KC@qlsFR-`QL%eHEuziq=6)wEo~^n@piu4V(>n5);F=rW)UK+v0>~+TGo6)vB!K zqsz@g^;Ul>KhtAq!3C69EgwJ9mb?8{VlZ{}>p!?DL9RLRb3#Hhza>{&>sN_`x#2<2 z6)ObBUFCCNx?@$tZbI+oiu1_H&M0it0IKhIK^?!oH2CF z7;t+1BQ9r^$Hp6a)XP^^lG!PdoYzd~nj+E?A4F1%e%dr_^paUiQd5ox-+0^kY}L{d zecv&gAeR#kkhx8_w^tj#-nZioen%y_>Wqq#-%k>0n3O|BY**?(n^|}XCPsw#z-u=w(WsK2w;Tfz ze%RaCp2c6hR?^|1Bf*rRe78P%#7ExJBNz>ATgW-r+(}4=1&U8LfB2AH_sK%h&{k;C6JH&Dy|KQfhv~bQ zw)10^1`Y5H`DcSum)*pV!2!*+6luteHCJR^a6Lz4d(!bTRDQI$gv7=PgEvM-o<$kh zOT-k4nkKy1Sp2A?g>;&PP{}CaML@3w?W5$HywxeNDD1bm*rlh%H(U2A#B=9UMD1QSZW87RH`{Q39cY@{&G_@9YvOXk9;u-U5fgnK{_&9t#mep55*LaS zy0g?_(9HPb$01TkYlwtXAO|4cH4-}lC|*jMze-+}i!|BUKO&_#}Ox^NPOoW7GzxmII*86D^7thX^xNga@D7_y~ z&*`ECl1-Unam%b@+oVF-PL?K9)%!L3GGi4WPOJZ#?h0cvXY-`@H} zfvYu@FJrcnInl2MMb#t}M*rURUcOvOS$V8?c`|39OTeu-`QR|B^MG{U)__NMy0q=oF3f9=};XF<|v@iCxQmREsD=U&;+%AJ90PySuC zV#hR_S$L?1nm*MkySIs*Uq+Phw1W^ApPYMF+MEIc4Z+CN^zg%XZ|o1a3Cbx`)AQ-+ z!JX|x?bII0Teb^RjR&z&GhJfeD%WVSeM3tD4(s&s`!v%9v(7_@a05VaXZG()&H61| zAh4Rt88ViHw{HV77k!m}>EEv%`x#;HBZk&vp-iM|n4` z$z9#@>J&Yt)Z}E*x7brsR~E!9xEgWxAT|>*Hozd>KIJ|h9_7EESI(@8C!ilYeR_!M zk^nDCNPSC}!IR}ZpZdiQeW$zr{UZ%g1ooe1@}-Nz$8R>yI%5mY_#dNL+0X3>cj?=wz}Wp@>q^A!n}6}WuRb^ z;iPp@-~DP_`#L6x7{W00yE}I|K#mc#ILS~CK`abf{`<8Zu!q5>5)<@PCSJon&@4)&ZmVBcAxrGfcgu(nYa z^vchl0}OC*sZQ8P!QpebA-l(oVf@O+BT~j~S3jgT&ygAR+d4qYw;gkzTivKWu=={9 z3Zk<3Sa*5Hy?iUwuM|;d<`>TwDEF8%F7x!X$um_O6RJpzLcy?*+2Dc&0>v)ER2e0SC=G1|8QyHd#dxlgmSj@Q2D&%f{^#_ zpAE0RxwVV=l=r^WaNK&z*SLLc(v}d>v~yU|&AD_Ok2x;A9S+p8Y*!*L{Z_c~nKM2A z%LQ)%LyyWydhh31#s;bCU*{pxlMx$So^NRlG2e<)3vJ9j#t(R8VORHt0_WYk{z^(? z0F1fE>_c<8d!IS}jew?dF84RNQKLsM&32`At2lHKfl#l3V;nYECf~>6oWcuplK9o+ z%O%;a)c@t%q_j+~OneeR7;SrdTP2BIl#?Qhf^t2EtTSB0e+QBMx^ zYo+B1IKDuPC|r5$gvw3d>Xs0(>{ zHz`~;B^DJ29*4(JW}0q4G0eIH%3V&i!J->l@sBlpVlv(V#vYNA)cB7;t4#kc5Ti~8 zPVeTpkO_dR-ug9b{+SgSpst-#{=(jRPucRs2^-7lRYces;?+3h%`0f>JlC`8y39As z2EPLVp>L$^N`@)T%D4XcD>-@MMoV)q{2^Pgo!mX%2Ng(PW`1dpVN%yR!^_uSfh%~ z3v9rO%|pwUf0*U?gN#86(zuy2zFtm*SrIXZnc*#?9$KkL^USyWcKvo%yWKi(s`bLn z%^Jq4)mie-PdxeuAiktz_rrHf4~K*)3k-ba9n1ix))jc$z46Xp1Qi zn=*Ih_8wO24FL)_p(Aq1?)1`keGIH(iA{ToJgVBhL6Z0?oj$_@J@k>F90kFsAPe|BIGsUSurGR1C%+APk zK)NS0{*0)7+POqj9)LU|5nqfcQ+DiK$~7T^x+p2+U~J2<0{uqG$c3KM46d@N>pSS{ z)eh&=S3u5dF+?A}KL;AJ?X%M0kiXX3NKJKrrtuVwYmi;({CTLl1cMW0t&t5iV z%yJfe?o~0-H8VS=E`2a?^g4h4=+O!3%g$wHvP0URnuzJ($GU>}CjTSaf0kBocK8n~ z{Wzk~^+RyNX+OL-I`0}uO#50t63S!6OgYjegx9vWI|e2lVu(bKXQ5uGW?*Uik5D#a zt}P+L0UT^$76(FPanE9=ZNY&`fH>x2oYRr@ClGVK$(=Rtf-J*F1>iQ-qSC(vP?qrWtiA2 zb|c0cEtAdpJnB9i41zHL6FGpB+oM-67hf->jn{A<`Of>1u)xAsN6tAfMy=9+6~iXy z+j!dvK~^76i9S10)uoxETQ;n_2iOojbgZ;SzbBd3CWckq;iK{%3Az6pGWCPr zDOl%KPN0FHW%>syc=ik>t@$vMot$E!2mDOc^DgsZO7>_?4a_<7#MMaskee3XhXl8) z=YWf=UYIdl1S;eRFQKbjFfy;xkfK9yEoGjBuz^uJ;-qC0j;gP$Wb1tM#G7n6NBDQN$s#%n|CN~R(mfyTPL0QpQz&1+eFhG6 z@gMi1q;@mRIx4rXZEY-Gy1-41yu1lwHOFy&oq%tf#b+DMZ7R;HQdL1}ZDFq-J-@KX3QGS$l<<0pS3c4Z!=)>qrBt3}8|` zrP_r--PjE*v59-IctvzZ#>&X6VgoQK3j{-9&GuV0vp8-2wRyR@MLvT|192It3kjJL zH$>ZJDVhF1rm(Wb-?Aq$TZ}UMNInLHrd~Rd(h(cv+wfvw((x2ye<>09v-R4i@__cM zSIx|tZ_GCprdnh%h@4>2|FPHr%rohI%MRl#EXLazIOd#FW9+bD!+39aE5U_;xbcg4 zGYJv?TPeubB#B=jU9x{n)A|VIjZuBp30UHndl)7aEDvUYtQ!?J8BP#;Fy<_~rCQfe z%ck7Z$L>EaD=%M5HUs>FmCqvqsQ8zz=;1@{M74Ee2N`A5AqRRLPAa)17oB=AFYh~T z0bFD7O9QMdFv1y=p#!a%8+OQG(O>xJ)Yy?xea4rEjc;6G9qL!>Z9V4)L_7#1mRD`+ z?iFG0kD~!87=GB5t5=cjj&{|f7%e7ONQ#R!=0-z(F)-+TVcU4W;)erOV*I6!JNMu5L5wHuLZf_ybW~8;%-gAt9>OnJm+syzcPc+oszkptB{#?{QGY{(2%*O0dw;9tg0BT$A9i#hBpc4K+ zqTU1=%eMXEz73&Ck_Mp>Ng8MnN@%1+p@Eb{2}L3*g=iiPC23GesFb3Rj8BCILIWvO zij>f#6yNXa{eR!rTJKuV`_!ZRzOM5;hQ0T(k7fTX1rtCS)(v7c7$fxFFs(;-#*Twg z10tJwPwZXZWUtU=-6>xTH@uOw4}B7cvj?Gg_+ZuJQBmfn*&P0^P;`XWKtW-KVYQGd zz@q?O)C0O^IuaS{j{cpPe&8Bst&KS!VK-sX|PNpP119hr-IGO7ovORWNp*b?^OfOXs*eP4touxjw5{MN`x+B5H> zvnDPXrZ-(dl`t^MKAsIoG!Xz_`3+JDX z4JNWOId`V`{zOS{+61S?iaK3_{+wIE=_QdFZ{rSkY@idKY&2a$H{TUH&}4+&rk6a$jJ9zA=K4bHteqLB09D-v=iWh3>fmzO6Jb=XBAtem#E!K^?ghp!D0RGp!-* z@SfEfVs380D=}Af@026q08)kiuY|6Klzk>W1rI|eA{qIzcHS>iTe;KV3Qt4G;(TQX z{cf=vf3vUl&70EqV<@1nKi}8SZTVe`_ZBv12y{4gaX~H+<{;Sg^@TGy4MGd+&eFg zR2KHX@`hQMr%!E$g~EM~XI?X-iy(lu7QjI!=unYu0d?U-14vzO^wqbrG&38Yb?h^RAASioBsUF?nFx>_$1`5 z8Dg*^+(v$nm!$ELGZQA9yD+a&bCUkD?Cn!^bi%@{xF7NPs~Fr-l#??mta~Takr=N$ zsQ1ZtOlAOoqGP%~9qomVu0N^vpLR+OwO3c@=3JZr3;<@b%*15Jr0*NSD!dvGx<-3S ze_!5jEenh}>8S91{bE0b7>K^n^nqAiZ@jN4c#8?T~^8qyu(tGKr2RtLy ztCA(7)ge~`?VVl9uGr~{IHx%QIWh_IpQqpHZL*L$0N~attYWO-P5?lg zs)q4?MtRD&jyagQYI+1oVZFOM)55W$yb<-YrN+A!zmF$-KXWlTD_1T67bK~9y92!+@EG*{ z2USo6(kMdTJ{W&*`rlve?YCaXU%hJ4vEcpJUmqtmu;OCok2woxU90%SVIqK+(XpI< zYak4f;wz- zD9vM@Bb3rs<(*O=SWavKx281r#;!ACENz0do!zB()A!I}kR}TaSEJHQ?7SstF(_wK zUkF3bievRqY!WhJ`>sI>1<-~NvNTJu>}(^r-^t7rP>I4G5TdkDK)!_j7ZHBD+aT z8vv^|#A8F@-J(6Rgl5DQK>H_J7sw7B9TVq<)0^3g9D6A`xrXP|CA0GDe+WA3#f#xl z2|Jbp2mT)X$c)!UM6)RwKrN)PLh%+YfNZ#yu+{PMW$RWG&1MW*d4{a&J@ID|t1x+y zk8TfO4Uk~h2cx#`Z*tTkr#$=N&(^qTe78uuWOt%h!w%qny^ZyBV1f+4{?P0$m5oQ@ zZrVGSU%Bv*zm6`cdcN~ZDQ8mC1Z?&u zQkl`BY-}F8aL~;Sv;W6m??Vep*_T}5&hR!aHM8GI3poT-1jh}}^i#_NhOethI`MM7 zO6-QN{E?sJrGoK+b4^iUEN-nM!+vVMhVClimxJy|dMjC_HN7RZ$(JCv!eWNRy%b>$ zvkVt4_z-gY&Yh_@y{Bu^ll^FGS*6!&IShEes{EAaL(SLqX>v`~xenAz?p52J-|(qB zgFhASn`~^3PU+=`cJ*oEhTT)T{sc!!dENHR&g0QZz3^RoDk&6fQ3$j?>3?&>MYcVR z*qvWkT#V9yp}r9BE`lO1^yEq9-oM*&F9c(2iznv6p>}DaBn*1 z$M|C*)wU^_c{VF+P~{h&z=(^zr&c9jQd)S2&iujVSW=>^`u4Jr%g0>C4o|q*)wg0> zskP~f6$0bY&FQ5W-g_)QoU1CoxmyS{7yI$n3C;M<`VxXxt+uhT@fF>~)}K2w#ne4^ z^;RjEy}~Kja)uu23w*>7)8nfGL*LL%VCaVlfDoYgXMC|=aQu&M9>_eXElcQ_V;B<& z5Q1aNDQ266EsxLzC5tC5v9l8lUf&PT)Q<=aP3HVkpdfYxOOZWH>v#%OSzbG_64RXi zqit1-Lsta+^}%$IIUEHS)u$stD58JgiU`uR?=QEIVa_py0nH#m_4`8>5eCpI43Q!K z^jSB^DC=*S$6Z(9kI?eYn=K}~MjK5^8TH5O`mMB+DtfFh|Izg7QgdoNvd)Uv)07g3 z($ADAMeFy*_k<3jdP+>(_h;2^joI_9EH`8upE6M&MmK+?NDyH4%?-Kjt}Ht{%0J#x zgAHcRH!4op1Y9wuKa|;lG0+0{zhXE1ro7gz_P@a}{_imx03?xc;J^vL{I3~bg=CFc z#}AAUb;bhoVrZWnczl`N9hz3mCKBa7^5&b0f z$x*%O7qJ_=Mw?2@rMYotw=4FyC+X=ey(e~MR8{-82DaGE(GUJT4bFs%Z7fG2q)XQCOid2^qT2@5zhOP59w>~7o`4?}km zyS3yc?j9ajZnaISC{Ty@v(f8m}a?P!~Sz`X6FP=mg`@za8k&rcR%m9m-+wFcAV4nI#T)S z{S`-+H7%bd<6FG-RU@BdY6nf?ckf~&3schyxE{>O$o9>{fsvM_dtJaX2o8W0E{qj( zKHwjVvK|wcFby8bI-b*EN}C`)XzK*qj>cz?s;fIe6T+|iZincjJYxLnc3N8f$BzKU zY-0&P^adMx`9>@cEX!-f;>AC4qwFaob6nSh!ObJQ@GDo=eXe6}7)Do5ndNREQ4 zJ;(Ghu4Y;{ao>!D|K=##r1utgh@#A0_d0XwvBoHva5ntaU)|#<@JSzM?vqQKdp0R) zdvlGkUXz2hQip%|-;R&UvLEP2z>@d5M`-f0C|bgGHWc8;!oQxp>4WEFD1+M@KOBmR zQp_FLc}wYl?_T!y95{H;z`On$caaf&vIjd8!nAg6D}VabF2!Z2LN~RoPXcX03izaL ze}3JNKlDR9@TkJ?^Rl8NPk=`5Iwpfy?ATfwqutgzeexOO!T#RHZ8^Jasj|p&z`t1T zjJxv6ltr0@7wUVNUcE3v2;Jc(xP+lil&Nm7rM+V6Y_<%JwaNj>#Cohfu=~E=k%xIl z8lR1}Q?Mk2t){91ElqW=@B)hhd)mKuZ|>I$CQMow!3A2MF=GZOdE$@MT8gA+rKO2e zuhdgpwM{CJ5wv93`jA$jz;HlY*c6~3+2n1tSJqdiN^Cd=4*^^@qQA1f_Z(2~-+64{ zti0v1BK%&2_WWaCTZ)v^1p0yTKflGhdxKVP^!B#)R5SnVIa`L^=Yp>j6#J(|D2>8UZLBD@~_(RYJDfJsOoBcn;F?LJEBqd>kHi0sy z)h5{##RWAPa7V<)MfWbBjf;DRFoAr(y^Sr7uTM94p<^iM5DgL2-EC`UH{M>x4e~rD zU`?l({`#5GYa8~9-aa?I7KqI*>md(pxOn*B!Jd*$A~}g51CeTu z$Ty=lM@7G?A^%X0%G@pCgjMCHutbATx z?v8zRS?aZLqahkvT8IP8basVp6E;4XnXxLux@G?Q(u2HFQiqvRZ&=mmgHlY6vwjAN zEz&T-;RNLTXJ-dTU(hzWy16BClNb*kba-}$SI}w`Re2^H$3$Lw7hc8}z3<&MCLOZn z=!IxMC?Nz)^aYY;Vfl>ILzNxm1|K-!l$j(@1oz)!1fuytrT42>uL`UC2_iArJnMCw zjK!=YpbsEmn~wd)TurRV3~&_2ZMojnSvnIY@I|;xJ=OEzbqgOpR9(?G`uK?xumv=@ zc}F&!NLl~N*2-!;SfuHViy~2LP>zbIvUXzurQy4uZ=<^wihllnt0huXm8e?!OP27{ z$!8Zt6a7m?M+co4dlti!nh68$)=u|bw{G3)2M*dtT|8!&Jna%;#3B*`(&z_av_uD% zy;I$fidS#>&S@b>$IqRpt-Zm^YgqbS!JUZJUBw@)QcVhXx|km*0B^ zPgdmA*V81t3m!e1>E1O!shmjD+3_=5P+Q-;;Yhxn7nvhJ&SKYkP3;_@gsF%I8#F~m zkg~bH;T@V3avA$WgXx1|_Lax}H#o0IF>QDV`#oo^o<3!e2mC1q;e6&{G3h3PllhjT z0KC_ItUpy}cQQXGeC*8eRWF`;ft#V&0;E<2fyW>odNk> zwo{a|T`o<+=qksJroCs+gLHe^_TAl#Yv$j2FPF9oeFPzM-`>3~t*ttfCaum;o&fk3 zH`k%7OjW}!318iPt^A*dMRmCng9bB!AbvPgyY>Lg~8>Z_~22SDKI4Afn(taiz!HOHQ;z~pJu6(ov~ zG$koszx1mvNH+N$#?pHYMa;f_&%J@RDWTXoF(SL+Ud^dm1`O}n5;zwhVK6%`j_N_X zO82PxvN6v=EwuW*y&WSasu#ldw;h{xyu(v&je7ab^cfy2h`!!1?^soZh{N7Hc^UU0|zcYz3 zUQ^SRDy}?f(cHP+M{cM&RDVXZ4CDr^iq+&nao??!(%OFuF3XCY4a$06s=v-m4=Euh zBj@?aZoxfw9b4_L7Qc8gnG=d`Dc9i@Qv9aIX(ASc*xq#CTc0T>nX>L>zg%lYQN6VE zAW=zo>87@;17jp)t5!Pp+Quq5T*3hGZrm|DPv+n$K~jDu6R&!ZLgt6UMQl}EP%zoM z-V**=p~8_Oh<~U&J6(F_B5~LJU$T$4h*Tn`c`}~8pml4;j`!-UfxD*$J~GEm%?INZ z7<2t+2hQ6$XFUta%6U~-*uZQbrPC*Fn0d5Ot5g#>lg}Vx5d{h+it*dd3EO@5E!Nmg zjfg9vFo3MM-Rpnjgo65*wnyIr4I^{WasvYuq*rk#wu;qeC5TFTiu;OOtO@l;k1~~m zl|sJv=*ve>ojT|cXdvt~Ey>p1>w1%N6Q1!5P8(2nD2|^Q=9U4f^7`)h{}NcZ|8WZ_ zkM=S)cKC3l!7#RQkj^mgh5zN2VKlnh(ed27k}glKB4_YJQ`2jQ1L$PA z=nNgO*yvH*`a109Dp{_Gm3VnV_`5oO5O;ug95z3ta{L-r-MczF`_Q1amU&o<3l(uk z&NlJ@;W(#r#MrUL2r0Pam!2CJwfN5H{ms54?oW_`i3^xNxEY8>#N~D9$GO+%ooudK z0?IypI+}86^ys61rLHlo%x{8Q(4A6olu|_Ay5-@S%!{U2T4?Llht!gdobx*eM5KM} zF1QGPA1k)@=EnXF4B_5;+XA54So~ScI#A87irqyv#Xg5$Vp znp#@!PtJAuG^XSOwIDgVZ{NPntF+EAR_@{9p%XkCY@L>ADpLr*7w^#B2-3(qLi6s~ zJS&`Tm!6B!Y_&fz0G^g%#*(7)NCxF7^@-wh(|^r&b=7<&3?5RJYT2g9oKcNy=%0?h zgS~C4@*``dXRhNek^KRs_6awCU-Pt^#D(~H0rWCIp*ei`z1eY;YV3Dhp6<0XcOa$a z%T%|YfDVOc|DHSveb~QYU?ct3>*!ydMqn81Bdj$PG}BJw>`1mVGYfk{+-VEs>EMo>|deKYaA)&ot#loxxW$VIhcy_KOxt1sRx2 ziW@W3^)Os4aFLL{`v)0WLesLfk!8Ow6EB!z?a3-ZFf<3>Aa&|~taqucX`liJuS#EP zYs+9USb5}&ehBVrXTt+}iI+{Y^jo6M%wY>?Oe3b8z|Hs%g&Ks6!ZHia zAtivuNYfvqxxoVm4lMn)wu)|z@p}DdTDMW4n5GX4S&uUhrvwEamr6kp?hF{pK=dL@ z%aZf6d&MO>Msc9fr82pAp)$dtPx6wJY{Fi$1P+>ko8x1oMVoeTL^44CIfgyPM_y~<}&^i>tTB!PSc3ICvE{rh7 z+sB8pF)C?iDseFJ{Q2?jFUGY>?7!egZwXV~?7vwQQO$wkgd?)B%GO@M_NLK?@8^U%pmAoO8vt8vmWQ4&)cW{w6NS{i%QNikqMOg02F0E+YZm6R2UHA> z9r{jt0|rr+yt;yFcUQ%k~ z=Zt>O@>Y2;lTbT(py-5#&l)k2X3ydo<8^h{WXMfw|MP3SNjzVFUjIB>m~NS&LdDm8 z!Dh~jU{vt()`)8yhQQ9ZqFvJUZfnT($r@7V4YUS)Et;k;9^1Yy^ zbd%G1)uhRU&@RvA1`j6A%rw>3$=iDOTbCxlENI0ESC(x8Fm&{6OzU$YCMKt%Vl#s< zZP{swiAC6W)1rey1092`bnVq^_X~SN5*f)BfK)svu)%go_xlQ-)z<&3V!d;N3=DmG z)FY4$mUAVZKkRqW!q`}Bhpg{M)(jJ47!kO@t3o9lw|4a#(&fYn6Y7`T*q3)Dq67}P zs&;w6j}#qt4(-^xw<}dli6rlbBj|r>?Hn&(yY^qdz}$HIf*luifVG0gw5Q#w2zFO$ zdM+UI#j9j>+N9;*NlQDPWsWQ7lUrVj+Dd6}=POhlUD#gQC&)+;m2&js_yV!9{%FDx zii79{7p^v^mV*_PGYQ)-C93nRkyT-Hg|txWEnuJn*ZvC^oLyWBDD}F0b&?5`^(|r& z;>z+n`n(@H@|c(!+M)90(yKf?ifc~&7t!ZH#89KP235UHIHI2YyTy13+omursXWZK zwi^kN-^9Hl z(m9939+2^Z z9L#5R8H*lqpqdb&KCSPG+Cx2+CtK!DM3=NH%*<)`{h}wjHusQXF?l1L#~zc?d11agb=w-EjRNDLXln)8J5>l@nGa5o=*N#aLJLs^JnX=}w zvVY^~hh=3qD1OatS0ej}Pg+oy+rw8p;%i)j{KMDFdx_Hj;+({URj9Km(;dLK^!CuG z?3lBslH>6(OmyLPUR>Uz>_?iOLWWj5S|BUklp>og+q367&j5)P3jmO`Jzh`wee)33 z+9h}P-ow(A@&r{1C08n*nA}6K;IO&fW*r#74B|Q$mjOyjpqBdwU%ulj?G&^ow>E#O zQ8?D0=K}7hh>J8X#@?SPir4?++r6`=#DrXxrg2e`hSW%y;}V$HPM^>ZH;$Q|gOsSm zvB(><7%4RIIx)%*bp=body0YLXd{FXY*?&Ls?n7R&fzX zwyET1_+Qi?OR%M40Lk$`nd1{R4P>gi3N@Ck@oo-rV9u%ad?mj5ltH~tTy3zjwhoco zu}Z?Wc6e!}uSF`ehP-Ji7~UWz1xW#71rvP0{x6 zAN!iPaCyG>udhsP1dgyCwr+Okc7-zC>SkQdgR5hZ#;v zDlRFx#xg?lk4?GhBjV{%#UrK&VzX5llA?Dk8rcYj#DIZE)~{J!SN%{Z;}JnUyB?#s zmgEut#aGQy3@M>>RP;|*ZeHpyKK1?gFSC{}TC^)W#$!jOWKckiLfYU96xir!;elt$ z5Rph?Pgj(_d?^5cG^pcj;!K%9r@vUD^|-iL$ZMo1W~V8QgKrEJl^B~I-Y>FT%K~o( z5a4yLt(ZCZ_=xEu@3cOa+4*-4k^0bSAnh}~*Z0}9-(Av<%8UE{dkj}7qT(#htY5R{ zCyf_u7gJLem6c}e3*$|!*T?oSabcG&C|`S9%X$B?gD1Kwq<;7B8>HB@2SqP|xHg%DsEHpqSI0+|#soQAzEgtyYX?MB3~-)Rvh{bNYDJ_JrihOEQ%LD zXGT1}N3xfXPb&8Il&(}s<7rnbEmQ!E{ilvwxJ#s*HtMsFy}rIal*DS9PlcJ)1MWbf z>a?hJ48LG9zA8B|FpyPNMJ*-_614_wlc}1}_tM}P#)EWkzJpH#Cw+t?Lgf}8pNYX6 z$Egl?Zob7O0xjg*ziu#H{WvmM!LLY2=AtKBcb5cPkK+NYco zC;7+h{;)^<#Q*^v{LwS1r*sLqv_r8;QsdVgMJ+;7gS_ZS`2PJ5 zs3uWz&8*djdSPaP{Vm7F*lYINuXZORW#JQ9-w@ibNaYcqn>#dDPOgir%8oGPM5TT? zLJU8A_4G?2!r7QJND4-=;JT(>&8t`XU)3Dzi$|| z@M*2Y)LGm2p6I2#w5Cm5WHcHsGiJ%=&FMx%(5D9;4>N?Ig%5_Zx&B{-ks$$}W`lsg zKF{!R9#YBT|Ibke@Y$hbUT1Y>a?zG z;FU8$STJ>df#mQ1PYdv_fHRuQqw4Z|XAJATJO8Z5>n>_6muwac za!wiaf1D*c%C6<-97uX2jq72AZl+2QNCP?ols_pba3N!mz;cS;Y$)`$TDtb3zft$|EJO5&^yO>Ggg`W1VLYjZj?|@$P9&l@e6MV9=r3{ z-z^&r&jjFxOw~ED?Nh92xJ>676{>Xz0q|pCR}De{s(dvI*1FIm2Vh9q_L44qG+h@$ zPMNc?VO)BqcW`s}qN4Zi-<9IpvSYK3JS}b;VVXfO(FeDnBI+S$Ko0;6jr(q-6h6i; zf5F_~^XJbrK|XYt`Wx+SQ(TM}Tv!oQtUZ46HoNs;g61k(`PLi9G#wjK@^1N7&x2Y5 z%*SrFZcRx5?XWNqEwe(8YMjf=`~zf4yH{VW^1iaoe>>_p<_KZ;64^7>-TCFPXvGJ;#z3PF9vZeYCi(?@28Xafd~Qq6q>qw+}jY_5QMMUwp6w|JRMa zl}@t^UX&IYYbvoE%5e4LlNB{q)K=vY-zPGG7p1*wS9W$MN+D_!eQMEwfKG(&<;&IC z<~CtMN^I;q5El9u=8Rrq&O$|h%H}WnKn%5YuRMJ-k7mWTHphPLm*ci)Zr^T4AX&3$ zlu?~EFB@}|d-1j!3f#C&M0xrR(guBVX(ZL*#dG(rTD?lpkvR*#G^xQ`Ww=Vyo*L^Y zwr>_b*O6)hQ<>J$cD~9E?I!w&5gQ)_-6KagaB~iJX_6UQcv%U+2p`ZtK6I6+uVVYJ zM6~pO%Jh{^`xGX7?!L8WQCq9}@uR&&bwW6HYVa4EXw%&WWjn7ao;KTiSWRT! z9O@Y^{*!wRK&IPPjy6DMp2IRU3y4&16aUeM{ubM^4wWf)wP&|(88kPm9$*ZJ>I!10 z+bDky5jlkE)Mon!o^it;lnff8J0;aJ!- zfEBUh-HVg3V$68CRv$h^jo%yiC`>->?awp$wFofkxyc;ic3?HcFDNWgic)RA=JTSl z;WTdEvc;r(s6yMLAX#7A+(&E0V)k}h_NRNGYv_T9l?3%*SzmFo-f_@?cQRF&s^ReY z#NoW7x%nfMz8B4-XD!|KU5n&EU#K(29n`bm{_Kn;{5G$Raif2&D5xoKW}byb=eLIN z-MeT1oq}r`so@;OA=Mq#2-?mS8YS#|<)H#_q~E@M@xq0nA@7UN9FEC9CDV7{NGrOC z3N-Jv^AnBg@Ix$t&ysHk^dhT$2S4LkV8Ld8%2@mQ@JSIp&WPCvsiK5&1n2BYbG7XC?Z5j*U$-L+%h~0} za#V&+z)VbPa5av@92E}#!uDKh_%};jDFQ#%k)qkdCICa zl;0=jX(-?l(m*^$IK#pYz623_-&F#0!oI6B`f0wRKpZ&P(*fF!I?;LQ5^mEFxoZ&lT65O!`gGmVqp?{PNd_G!RT6%I{F_61ncWFTVzY0%e)Mvm* z3DHruOn~6*&es+Q;(q^5ASIyDAtCceEWbvoW8vB;+eO3S4@b5a3`7NsKV+BUea>sv z+)hs?8z>Kc$kMQFKVSKBr?1{v!Z~DeY5q&9kke67d*wAd1mkFNBk^pT>WBb$hXC=?|I-M(7^p=GJl~{d6UMraymz zxIXi3%cqL*-@f$h%fe6U^W_ZdYh(D2ghSG8u_+Z~Ah^^&scdA`R*}dErd%v$Aq!?K zHPF8g+4MHyeOKuw0m_>4psx^(hu6k!O6#SlBN_0drm7fSXe|SE5fO{;Lrgd?Tga+v zIxfaGs;jdTMtk@OGv54V|AWYyUL?Pz*HK#LPP)P#V$9gFx)UZ;5fk|tWWW|b$*LJ$ zRhm*3zT$j(zrEMfQE#}&Y_5E?d`zjX`CYaeWo0~sEoydhnpI=pU3`2M7<6wF^dxB8 z_g%jK>eXM8^Q1|WzMnav<6K1kR#>XHlj4@;j)V{!%7V;rt-ANpL>h`Z8MZ|YOkR>n zwuS+(xrk_rDT#{msX41T@Lj$cO=Q9|S@w5~^+SB$LBjI*K6r9cDfEH8KB z4CUYN<#&BjOjp^e=*rqGlyS(@*Z}#xp==GcgwJVswwC7Rn77wa@Gen|1kFa-@vq%n zF!4MgX~?u`*~x2otuWY3ir-;tJ4_)IayH;e+ej|6<=yBwGsH41pn6IEp4VSo6b|(| z%iXR`VrkJIxw_|^2BNOnQX_kNVZ1-g19WRnnvcSWbgy3DB2`|8_wKfH-|lu&Ecy1* zR|hz1>_yJjoJeRz=tP?h;*-cmn)>QfPC-T`FIp+;{HUZmDoaY5cMskkpWQ=kas0L8 zSQ(uu#=B`)bAHvy+`T>jhXGsfSTI7eW|S@yDImLb%`FmDMSB;u)fgYLnvK&7sm-1p zqi8w*M!e%JP}Z$bIShzi!Js)a-Cx2fxUY}t2Q@af~=FZPaZ6X=<%^Sds>!< z=5O7ypqx{SCeK;;gtI{(xT&eC>(?sdjqlMA@ECL~pPs5cWa{As+!D+6dG}Jd4=e+4 za@^xPTE@MF-k@zivcgemn(XJHKC3+JvUV-wAoEOr%tY-84n#s52Uqb&X8rLa@@d2# zyHabM-z#d8=D4`jbM9hO3MKs2jDyc_71=m=_Y!#vFpXyJqbXejE8a-rQ;gn<>No8` z;36;SCYiHL3c9Xc%akZc@i$5xpCmgpZo;F8h=f!wL7>izFaE6zP9XKhhuC6O|2Fnf zQhe*O&i7s=k&puTpd4$5vc2l|9k_bVlJ#1!<;{xXCmV8(kF`zsHb-&Z^yzOAaGS|D zii`#o=A7!HLJ@0YR2G<$p9M0CsrdivZ8a% z-<5)V%G5I zoFGux&`remyEX*9Cv4joyPF4)RyhQQhA!Y^?p=3CMWu;9eN4wDj;@ppbaw^Gd;9Ni zU55%QKz|3`t`o5IlCVGU7?RfiYI}D35afq*2kA<$x^Y= z!cc`WX05jQWPYs+nC4x_k+=2HD6hEb9)%|-_71__Ym|JmxBh(m{CWTNODl#55TC5C zs6J;^hDfxe3(*FgPXuzb%U{=goh4-!*pLuPDtjf_-AdwqqDfGKx-zLJ)dIUkDl6eF zOjR)?1ehc6a3S&Y&Ye4)49)Z%?})O9%)C+x1SJD6GdCb&2mUF0glb1QZSD^Fr@~ku zUi^34Cx}^&X0UbW=DY(u8R6J;vR<=%^SB{H95@;bj~$u9;z!kA`as@5QVf2?-kzir zw3V&N?-~V};DH_?mZ)mEFQe{bv)MQaQk&JG7|`PnI$2L|!J>Famc$MpHVjeKqJTq3 z4jmFS8Ad~ncsaB}lyR=gJyurmU-I_U4$5)}_!|GbPw(Cky&k!4;Y(>3&3bBVSpf-G z`(HkngL_hp@J^dsZWw!?F{uM`Z@&H_@Xnh*|1m27rZBTjF`@0h>;u2*>UN^-eDg-C z*C2l?lu7FuVWq^WrAGPZJZj{~vam_&s zJ-I>kl%)nUv_Q*wlmH*6?eDyLVa3DywVs}CGg09?#co}>vX<(H%`~6YzP!3E9kg|u zfblf-48_)h01%7GrS%!2(2Z?@0IKn>S(F>=n_DOcfJL6p ze+eDMehE#z_(o{9&!z*BDgld=pDQYsUbs4XD$~LsCE#vEC>}zJ{|wvgib+c9j+(o4!fgsDnO1p*k! z(|!~+{^E~d;r226eoD>F)iplxU~f8v1DrcEGlG0ckc6~LPn8pT6g!sog4EkT*xO$! zg0N*$kdsqG{t4^tN?86LxtT?7r)HZ>pWbysTOSuM=4(){e*fBn=&A6p?&69~hP!(z zy=Q{>#f|HdO=K)$1)t#{-wC+=#AiQ1UaxoRp?p@CmUv%Ax#;&+{thROw%#m=cIFkf) z(zxB$D5?THdmz-G2Ye=C$0yFH*fZlCgWX9p>uE@dtB=|q8)% z*Q<{md_M+i$^-fyzMtQxc7} zs7mO5RgK|#s>-i*bGvc==)$$ak*!l{>iNcVGC2*lqkE4Y{~h*6tWJ^Q(+@cB;G+@F z;lw7Y(AvQsMnfn0@Ro>BGyL+TMDrAh`L6IdXm z1--#_X&hVA)WllCF*QNeN8g`ZH9v(R0NR|HPh5A)kjPoGi>p5r(+gpgqzxyu`CLU1%OVEav1AKMu`s z#B2XKCbO0Nfd7TQ0?oK!!BBilSj4eAYEe-IunT%vi88e#L*)0Wo1YN6=(z4HCHhG> z9Y^m$jD95%DK=yma1uakkM*bSzXi&E-=|T_?&jsk=BF8@sz&8yt83PVJ^x;N$u4jy#LGG}o# z)c?9hgdRhTKL$3d)sJCk9sBMgt=vjNj!gbmkuV71SKiedr1fXo)&CYhO;AAPtnucthR_su=`cKd6yG(^J+*02ge?05>v=K z*hN4J5}UKKWJE?%e4~e%aY|0Pk{atiOngwY%E5oiWoufRs4+n&@vmVrno)yuM9i=j zL&V{@AtS0>jXzR&co`w;Xmhq{LQT5dP@{Lx42Mx|m=w{PH0c1*KVWVCiH?A96 z_dX@iq|LuqX0gb!3;8cz?8e=~oUI~~y_w#c{WlJy&28%_el!~;%c1hyK8v@#FPhzJM)Hm3mN*;Sk>kfsT`2VeZ=& zywVIIcFEG>sbY0p+rjrd9=@p3C#rB^Ajed16}Z>DUb1>bzx^n|D!GBEWaY+~&fEMaj)dSMP@4E{#EH7VJQ6>XoY-QI^;T9(WAtjXQ`hA`WtHZuMzBrRiZn|F{ zJgFVSmXXu!cBGR=IG66WUKYSpLU>(IwPX)6CA@lnxEOV5PLKg#)Lc)(cTD8Vd5%_k z7<1tYh1;y~XvmQBBG1n_Q8-7jtB=oj3SbKD-7orqTQC*$!ds=gLZy)zDWPRF2 zVVWUce7LhHM(QE3gH}JxGQB1%7wlNOGuoS+yZ+xW74E%dWo1!GCJ7+?Z2E2o&8YVO z+OsTGW9RCpwTIBMfzlGyfC%oGj)hX#;OXhYKLePWXh0n5>)USGQ$oc>tMRh3631zc zgNnQ-b+59)}uud}w< z$uB^sBGsh}yijCVFDE8wxI(Y916H)yi1nSgwp3M3@nlcVQ;bvWLvl7E;$d z=0{KZO#gClTPt0$!T&ZrEnJl4*YbwLGcGHCDQ5zEN@k7<(lQx1fZwXTxo-dA*$Rpy zC7k}N^P->S8?pyyKxfcO?XJ;?%y#KWH_eNT8Aui2;1IJ!tAje} zc+$?5kFMpby!D(+<46d5NjQadY#i(0;sUKQ?eUpu)!3&bAFXd_Fh4#{EP#*jiBBG~ zb0@neEuwTTz-E`9z9;-yJfp^{1(ubUD{DK>VCr(GQWvv4m~b$Vd5c@73Ca*NabY78 zNR=Qb>9B%0qhFc!_nXzKt6ZGV6dtiB7j5qB*yir8^>#$iiHMuSL+GrqvLF3xQEsS? z(JbCFk^nZYdWM(`7O)T7M@=O%q7yY%x%>r-;2&RUW#rCL)M?fpmvwo00+OAb4f57f zkE>Rm-um^E@M0ee`wggUfO9ban=^=m+#~YY!v9wb@E6=2>p-|x-;ry#ZUYuTHV5iE zV4Q=f&O^}S3l78jz1~_ZWNv~%Qvq-*&%DFKLevpBPxqbbN)a(ZxCX}m?{ zIoo=c_?wTC*->a&`Pl7Pu5qxuR1@LBAw$w;nEYPZK~oC6`}T0VsnR5m#DyJ4c4lTp z5Zs7|y+D!~i>Du+tLXVKg8a1A&kqD%ao|9>0k%0^U|tX(5j8dEC+B7|(m`FGPMy86 zquNOg?HUk#+@-c@ZPN3K0zG0TCq8z?1>+3KIro)G=o|$(Ibk;D-tzXRZtsuxtYYo4 z!04&p`R~!A&xFO);$3fkF3s(uRCB3WY)EEt$_^!YBpxrKqyh)FjqT%tN#>550=sxO?k5suK8N+kb%htx_pm zE`Bomg-94+j04fVpB5s|@E*hO3Fc)@O^+Qy1JP31^6D%T&zOQN#&}w0MMvAMT317l ziPsIe+@*Obrk4$Ft2fzx>ox7q5IGsAWykYtL3LU=Ayjr(|4ugSEA}|OZyv422i=S zGm{dZJXGGOjwL4*Y&2=m?3hM(Ve~oX4+UXm@B_EG=H@C>{5)yD|6U~F5BqB|ot&jH z(n8puduZRjux*=3R`Arn55JY|%lxJkpl*$>;$v5l5&u^##>m|K;6L-FqGP9$dys|2 z_yc=p;9v2u&g*Dmo!pIU*8&?3df}+(hw8D+W*jN+hoZi>3oc=xY{$n)Y82(?uRshXqr4&WFz_2sQ|E7C*sHI)9&XUu9?U+x3{$| z^6smdQ1N;ywA!N5^7227uQO{FHAb?a_~FA(m@zHPt2PJg46f{>q%134U7DV2zu{y$ zAac^L9Z3*2uQE4>H^?8Sz_DBF>e_+z`@F?s@8Dag zSkVOE^&Z-jezk||#Ucl~rKy`+oq{b8o(uk8)ZVFsQB;uI%bq-0+pOl(Pkj|#yzcrc zm(sc0JAQq*cN%fC@QivWyX3U@5UB~!m-sk-9-nf0RP@!Q)Ac0S;^QUrTww#f(EH5= zJ%bGPXAAYOwnEK&#z)%o}Dgb?oU z5a%A$P765Azb%JXbvZUxP_8#<4xmTg&sb_+&@Ii6PtM=xk3=P%TOgMfZd`r&594eT zHuX92=8Yp~S6??6HOyMiS~5w=-&LL@J>*vu3k1i_etwtjZ!bFJ=}$W1H{6;>lFk$X ze5DRVhy|JmP`4PtFz~UPPIHhVVI^;Oq?vpgEz}nR9e_^J$;a{g-s{;&iTm~w>cBF! zKy?_B43>yt)>*c50$wFL_1&vzf+%&BwoV#3axMQ^>foh>7UIKSHE>oVBhj{X4@g}~ zxFPcfY2^AYJ&a$izK?70t%%*c8^Qtq6N$PB&2^U{GV0UyE_z<;Whh#Ic|%uAlZ4mr zgkq4{k@{@Byw z_v1l9l{MR>0!_>|#PX{Z)u!#=iaB*RS6$ zP*q5m+T3T(yi5Iil3B4+r(ice)zuw6ecBLDBF4b%>|R#RC0m>}@SUIQh|Hq#Wb=G; z^9w≺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 z%0DiI_Ukzbz83joZMt+@@$^4e!4 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 literal 0 HcmV?d00001 diff --git a/previews/PR237/assets/xeijnvc._0R9BbFk.png b/previews/PR237/assets/xeijnvc._0R9BbFk.png new file mode 100644 index 0000000000000000000000000000000000000000..6752dc80d3da3267f2b9254ee93cfb56f90c9876 GIT binary patch literal 30821 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 i6_FPm|D}K63u4kOJ9iLJ?r`~LtTevA_U literal 0 HcmV?d00001 diff --git a/previews/PR237/assets/xoyljyv.BxObbkJu.png b/previews/PR237/assets/xoyljyv.BxObbkJu.png new file mode 100644 index 0000000000000000000000000000000000000000..13add0e3d72f9c2914e88cf6cc320bcc11a0d105 GIT binary patch literal 76708 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 #%G=;Q0|k-*CXmyhXV4LrzcmQaWF(wT9zB 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
  • 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ⅅnf_vB7XR*HMLJGe-E>6@ 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 + + + + + GeometryOps.jl + + + + + + + + + + + + + + +
    + + + + \ No newline at end of file diff --git a/previews/PR237/experiments/accurate_accumulators.html b/previews/PR237/experiments/accurate_accumulators.html new file mode 100644 index 000000000..d6bf9c770 --- /dev/null +++ b/previews/PR237/experiments/accurate_accumulators.html @@ -0,0 +1,30 @@ + + + + + + Accurate accumulation | GeometryOps.jl + + + + + + + + + + + + + + +
    Skip to content

    Accurate accumulation

    Accurate arithmetic is a technique which allows you to calculate using more precision than the provided numeric type.

    We will use the accurate sum routines from AccurateArithmetic.jl to show the difference!

    julia
    import GeometryOps as GO, GeoInterface as GI
    +using GeoJSON
    +using AccurateArithmetic
    +using NaturalEarth
    +
    +all_adm0 = naturalearth("admin_0_countries", 10)
    FeatureCollection with 258 Features
    julia
    GO.area(all_adm0)
    21427.909318372607
    julia
    AccurateArithmetic.sum_oro(GO.area.(all_adm0.geometry))
    21427.909318372607
    julia
    AccurateArithmetic.sum_kbn(GO.area.(all_adm0.geometry))
    21427.909318372607
    julia
    GI.Polygon.(GO.flatten(Union{GI.LineStringTrait, GI.LinearRingTrait}, all_adm0) |> collect .|> x -> [x]) .|> GO.signed_area |> sum
    -21427.90063612163
    julia
    GI.Polygon.(GO.flatten(Union{GI.LineStringTrait, GI.LinearRingTrait}, all_adm0) |> collect .|> x -> [x]) .|> GO.signed_area |> sum_oro
    -21427.90063612163

    @example accurate GI.Polygon.(GO.flatten(Union{GI.LineStringTrait, GI.LinearRingTrait}, all_adm0) |> collect .|> x -> [x]) .|> GO.signed_area |> sum_kbn ```

    + + + + \ No newline at end of file diff --git a/previews/PR237/experiments/predicates.html b/previews/PR237/experiments/predicates.html new file mode 100644 index 000000000..ba402fd8b --- /dev/null +++ b/previews/PR237/experiments/predicates.html @@ -0,0 +1,122 @@ + + + + + + Predicates | GeometryOps.jl + + + + + + + + + + + + + + +
    Skip to content

    Predicates

    Exact vs fast predicates

    Orient

    julia
    using CairoMakie
    +import GeometryOps as GO, GeoInterface as GI, LibGEOS as LG
    +import ExactPredicates
    +using MultiFloats
    +using Chairmarks: @be
    +using BenchmarkTools: prettytime
    +using Statistics
    +
    +function orient_f64(p, q, r)
    +    return sign((GI.x(p) - GI.x(r))*(GI.y(q) - GI.y(r)) - (GI.y(p) - GI.y(r))*(GI.x(q) - GI.x(r)))
    +end
    +
    +function orient_adaptive(p, q, r)
    +    px, py = Float64x2(GI.x(p)), Float64x2(GI.y(p))
    +    qx, qy = Float64x2(GI.x(q)), Float64x2(GI.y(q))
    +    rx, ry = Float64x2(GI.x(r)), Float64x2(GI.y(r))
    +    return sign((px - rx)*(qy - ry) - (py - ry)*(qx - rx))
    +end
    +# Create an interactive Makie dashboard which can show what is done here
    +labels = ["Float64", "Adaptive", "Exact"]
    +funcs = [orient_f64, orient_adaptive, ExactPredicates.orient]
    +fig = Figure()
    +axs = [Axis(fig[1, i]; aspect = DataAspect(), xticklabelrotation = pi/4, title) for (i, title) in enumerate(labels)]
    +w, r, q, p = 42.0, 0.95, 18.0, 16.8
    +function generate_heatmap_args(func, w, r, q, p, heatmap_size = 1000)
    +    w_range = LinRange(0, 0+2.0^(-w), heatmap_size)
    +    orient_field = [func((p, p), (q, q), (r+x, r+y)) for x in w_range, y in w_range]
    +    return (w_range, w_range, orient_field)
    +end
    +for (i, (ax, func)) in enumerate(zip(axs, funcs))
    +    heatmap!(ax, generate_heatmap_args(func, w, r, q, p)...)
    +    # now get timing
    +    w_range = LinRange(0, 0+2.0^(-w), 5) # for timing - we want to sample stable + unstable points
    +    @time timings = [@be $(func)($((p, p)), $((q, q)), $((r+x, r+y))) for x in w_range, y in w_range]
    +    median_timings = map.(x -> getproperty(x, :time), getproperty.(timings, :samples)) |> Iterators.flatten |> collect
    +    ax.subtitle = prettytime(Statistics.median(median_timings)*10^9)
    +    # create time histogram plot
    +    # hist(fig[2, i], median_timings; axis = (; xticklabelrotation = pi/4))
    +    display(fig)
    +end
    +resize!(fig, 1000, 450)
    +fig

    Dashboard

    julia
    using WGLMakie
    +import GeometryOps as GO, GeoInterface as GI, LibGEOS as LG
    +import ExactPredicates
    +using MultiFloats
    +
    +function orient_f64(p, q, r)
    +    return sign((GI.x(p) - GI.x(r))*(GI.y(q) - GI.y(r)) - (GI.y(p) - GI.y(r))*(GI.x(q) - GI.x(r)))
    +end
    +
    +function orient_adaptive(p, q, r)
    +    px, py = Float64x2(GI.x(p)), Float64x2(GI.y(p))
    +    qx, qy = Float64x2(GI.x(q)), Float64x2(GI.y(q))
    +    rx, ry = Float64x2(GI.x(r)), Float64x2(GI.y(r))
    +    return sign((px - rx)*(qy - ry) - (py - ry)*(qx - rx))
    +end
    +# Create an interactive Makie dashboard which can show what is done here
    +fig = Figure()
    +ax = Axis(fig[1, 1]; aspect = DataAspect())
    +sliders = SliderGrid(fig[2, 1],
    +        (label = L"w = 2^{-v} (zoom)", range = LinRange(40, 44, 100), startvalue = 42),
    +        (label = L"r = (x, y),~ x, y ∈ v + [0..w)", range = 0:0.01:3, startvalue = 0.95),
    +        (label = L"q = (k, k),~ k = v", range = LinRange(0, 30, 100), startvalue = 18),
    +        (label = L"p = (k, k),~ k = v", range = LinRange(0, 30, 100), startvalue = 16.8),
    +)
    +orient_funcs = [orient_f64, orient_adaptive, ExactPredicates.orient]
    +menu = Menu(fig[3, 1], options = zip(string.(orient_funcs), orient_funcs))
    +w_obs, r_obs, q_obs, p_obs = getproperty.(sliders.sliders, :value)
    +orient_obs = menu.selection
    +
    +heatmap_size = @lift maximum(widths($(ax.scene.viewport)))*4
    +
    +matrix_observable = lift(orient_obs, w_obs, r_obs, q_obs, p_obs, heatmap_size) do orient, w, r, q, p, heatmap_size
    +    return [orient((p, p), (q, q), (r+x, r+y)) for x in LinRange(0, 0+2.0^(-w), heatmap_size), y in LinRange(0, 0+2.0^(-w), heatmap_size)]
    +end
    +heatmap!(ax, matrix_observable; colormap = [:red, :green, :blue])
    +resize!(fig, 500, 700)
    +fig

    Testing robust vs regular predicates

    julia
    
    +import GeoInterface as GI, GeometryOps as GO, LibGEOS as LG
    +using MultiFloats
    +c1 = [[-28083.868447876892, -58059.13401805979], [-9833.052704767595, -48001.726711609794], [-16111.439295815226, -2.856614689791036e-11], [-76085.95770326033, -2.856614689791036e-11], [-28083.868447876892, -58059.13401805979]]
    +c2 = [[-53333.333333333336, 0.0], [0.0, 0.0], [0.0, -80000.0], [-60000.0, -80000.0], [-53333.333333333336, 0.0]]
    +
    +p1 = GI.Polygon([c1])
    +p2 = GI.Polygon([c2])
    +GO.intersection(p1, p2; target = GI.PolygonTrait(), fix_multipoly = nothing)
    +
    +p1_m, p2_m = GO.transform(x -> (Float64x2.(x)), [p1, p2])
    +GO.intersection(p1_m, p2_m; target = GI.PolygonTrait(), fix_multipoly = nothing)
    +
    +p1 = GI.Polygon([[[-57725.80869813739, -52709.704377648755], [-53333.333333333336, 0.0], [-41878.01362848005, 0.0], [-36022.23699059147, -43787.61366192682], [-48268.44121252392, -52521.18593721105], [-57725.80869813739, -52709.704377648755]]])
    +p2 = GI.Polygon([[[-60000.0, 80000.0], [0.0, 80000.0], [0.0, 0.0], [-53333.33333333333, 0.0], [-50000.0, 40000.0], [-60000.0, 80000.0]]])
    +p1_m, p2_m = GO.transform(x -> (Float64x2.(x)), [p1, p2])
    +f, a, p__1 = poly(p1; label = "p1")
    +p__2 = poly!(a, p2; label = "p2")
    +
    +GO.intersection(p1_m, p2_m; target = GI.PolygonTrait(), fix_multipoly = nothing)
    +LG.intersection(p1_m, p2_m)

    Incircle

    + + + + \ No newline at end of file diff --git a/previews/PR237/explanations/crs.html b/previews/PR237/explanations/crs.html new file mode 100644 index 000000000..fc2a5cbd3 --- /dev/null +++ b/previews/PR237/explanations/crs.html @@ -0,0 +1,25 @@ + + + + + + GeometryOps.jl + + + + + + + + + + + + + + +
    Skip to content
    + + + + \ No newline at end of file diff --git a/previews/PR237/explanations/paradigms.html b/previews/PR237/explanations/paradigms.html new file mode 100644 index 000000000..9f3ccce20 --- /dev/null +++ b/previews/PR237/explanations/paradigms.html @@ -0,0 +1,25 @@ + + + + + + Paradigms | GeometryOps.jl + + + + + + + + + + + + + + +
    Skip to content

    Paradigms

    GeometryOps exposes functions like apply and applyreduce, as well as the fix and prepare APIs, that represent paradigms of programming, by which we mean the ability to program in a certain way, and in so doing, fit neatly into the tools we've built without needing to re-implement the wheel.

    Below, we'll describe some of the foundational paradigms of GeometryOps, and why you should care!

    apply

    The apply function allows you to decompose a given collection of geometries down to a certain level, operate on it, and reconstruct it back to the same nested form as the original. In general, its invocation is:

    julia
    apply(f, trait::Trait, geom)

    Functionally, it's similar to map in the way you apply it to geometries - except that you tell it at which level it should stop, by passing a trait to it.

    apply will start by decomposing the geometry, feature, featurecollection, iterable, or table that you pass to it, and stop when it encounters a geometry for which GI.trait(geom) isa Trait. This encompasses unions of traits especially, but beware that any geometry which is not explicitly handled, and hits GI.PointTrait, will cause an error.

    apply is unlike map in that it returns reconstructed geometries, instead of the raw output of the function. If you want a purely map-like behaviour, like calculating the length of each linestring in your feature collection, then call GO.flatten(f, trait, geom), which will decompose each geometry to the given trait and apply f to it, returning the decomposition as a flattened vector.

    applyreduce

    applyreduce is like the previous map-based approach that we mentioned, except that it reduces the result of f by op. Note that applyreduce does not guarantee associativity, so it's best to have typeof(init) == returntype(op).

    fix and prepare

    The fix and prepare paradigms are different from apply, though they are built on top of it. They involve the use of structs as "actions", where a constructed object indicates an action that should be taken. A trait like interface prescribes the level (polygon, linestring, point, etc) at which each action should be applied.

    In general, the idea here is to be able to invoke several actions efficiently and simultaneously, for example when correcting invalid geometries, or instantiating a Prepared geometry with several preparations (sorted edge lists, rtrees, monotone chains, etc.)

    + + + + \ No newline at end of file diff --git a/previews/PR237/explanations/peculiarities.html b/previews/PR237/explanations/peculiarities.html new file mode 100644 index 000000000..22d60073d --- /dev/null +++ b/previews/PR237/explanations/peculiarities.html @@ -0,0 +1,25 @@ + + + + + + Peculiarities | GeometryOps.jl + + + + + + + + + + + + + + +
    Skip to content

    Peculiarities

    What does apply return and why?

    apply returns the target geometries returned by f, whatever type/package they are from, but geometries, features or feature collections that wrapped the target are replaced with GeoInterace.jl wrappers with matching GeoInterface.trait to the originals. All non-geointerface iterables become Arrays. Tables.jl compatible tables are converted either back to the original type if a Tables.materializer is defined, and if not then returned as generic NamedTuple column tables (i.e., a NamedTuple of vectors).

    It is recommended for consistency that f returns GeoInterface geometries unless there is a performance/conversion overhead to doing that.

    Why do you want me to provide a target in set operations?

    In polygon set operations like intersection, difference, and union, many different geometry types may be obtained - depending on the relationship between the polygons. For example, when performing an union on two nonintersecting polygons, one would technically have two disjoint polygons as an output.

    We use the target keyword to allow the user to control which kinds of geometry they want back. For example, setting target to PolygonTrait will cause a vector of polygons to be returned (this is the only currently supported behaviour). In future, we may implement MultiPolygonTrait or GeometryCollectionTrait targets which will return a single geometry, as LibGEOS and ArchGDAL do.

    This also allows for a lot more type stability - when you ask for polygons, we won't return a geometrycollection with line segments. Especially in simulation workflows, this is excellent for simplified data processing.

    _True and _False (or BoolsAsTypes)

    Warning

    These are internals and explicitly not public API, meaning they may change at any time!

    When dispatch can be controlled by the value of a boolean variable, this introduces type instability. Instead of introducing type instability, we chose to encode our boolean decision variables, like threaded and calc_extent in apply, as types. This allows the compiler to reason about what will happen, and call the correct compiled method, in a stable way without worrying about

    + + + + \ No newline at end of file diff --git a/previews/PR237/explanations/winding_order.html b/previews/PR237/explanations/winding_order.html new file mode 100644 index 000000000..f991ae9e0 --- /dev/null +++ b/previews/PR237/explanations/winding_order.html @@ -0,0 +1,25 @@ + + + + + + GeometryOps.jl + + + + + + + + + + + + + + +
    Skip to content
    + + + + \ No newline at end of file diff --git a/previews/PR237/favicon.ico b/previews/PR237/favicon.ico new file mode 100644 index 0000000000000000000000000000000000000000..468a7af73ea3037f8f9e2f22674a92565d1b3163 GIT binary patch literal 23866 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 literal 0 HcmV?d00001 diff --git a/previews/PR237/hashmap.json b/previews/PR237/hashmap.json new file mode 100644 index 000000000..62cfb3dc4 --- /dev/null +++ b/previews/PR237/hashmap.json @@ -0,0 +1 @@ +{"api.md":"CJkYwQvX","call_notes.md":"BcP_ugKX","experiments_accurate_accumulators.md":"BXYktaVF","experiments_predicates.md":"B9dtjjXk","explanations_crs.md":"DiYuqaex","explanations_paradigms.md":"DW4pGVk2","explanations_peculiarities.md":"DpkElEdT","explanations_winding_order.md":"DlVqRHt9","index.md":"DjUkOUxW","introduction.md":"CGS9TUwC","source_geometryops.md":"DWxcJS4q","source_geometryopsflexijoinsext_geometryopsflexijoinsext.md":"Cb0F4T1E","source_geometryopslibgeosext_buffer.md":"BBYR_g1c","source_geometryopslibgeosext_geometryopslibgeosext.md":"SUH-wZv2","source_geometryopslibgeosext_segmentize.md":"BqXn7mYP","source_geometryopslibgeosext_simple_overrides.md":"B0O49YKH","source_geometryopslibgeosext_simplify.md":"0759lT_4","source_geometryopsprojext_geometryopsprojext.md":"T9WAXhCV","source_geometryopsprojext_reproject.md":"CtArVbVw","source_geometryopsprojext_segmentize.md":"5tB78318","source_methods_angles.md":"C2l1TSM1","source_methods_area.md":"Lwj3szS1","source_methods_barycentric.md":"BBVjpi4w","source_methods_buffer.md":"BAri0anf","source_methods_centroid.md":"BZPe_QHV","source_methods_clipping_clipping_processor.md":"Cn8s_AHy","source_methods_clipping_coverage.md":"DV_tWTFE","source_methods_clipping_cut.md":"C35jjvPO","source_methods_clipping_difference.md":"DWZJEyKa","source_methods_clipping_intersection.md":"CyyVQZLK","source_methods_clipping_predicates.md":"Dyq9YrPd","source_methods_clipping_union.md":"DfnvhyrM","source_methods_convex_hull.md":"CW7Bt5Ex","source_methods_distance.md":"CFtY9lnQ","source_methods_equals.md":"VAVTT70r","source_methods_geom_relations_contains.md":"BFVDAiB9","source_methods_geom_relations_coveredby.md":"CqbNTbTy","source_methods_geom_relations_covers.md":"lXjO6TJl","source_methods_geom_relations_crosses.md":"D0wTvJKv","source_methods_geom_relations_disjoint.md":"D-2b0dzW","source_methods_geom_relations_geom_geom_processors.md":"B0gKT2XJ","source_methods_geom_relations_intersects.md":"ClSocZGa","source_methods_geom_relations_overlaps.md":"Cw9LQh0J","source_methods_geom_relations_touches.md":"B6goQM2o","source_methods_geom_relations_within.md":"BPrebRYc","source_methods_orientation.md":"D1GOBoW6","source_methods_polygonize.md":"U6uoZhWE","source_not_implemented_yet.md":"DVmFgcZJ","source_primitives.md":"D4c57Awv","source_src_apply.md":"B_9nF_39","source_src_applyreduce.md":"DZQXF3zb","source_src_geometry_utils.md":"DStHZN_K","source_src_geometryopscore.md":"D72HXpHZ","source_src_keyword_docs.md":"Cu2o_Mxm","source_src_other_primitives.md":"x4-eP4Xq","source_src_types.md":"DBsi_VC7","source_transformations_correction_closed_ring.md":"uikVr-1e","source_transformations_correction_geometry_correction.md":"C2ysKw1R","source_transformations_correction_intersecting_polygons.md":"Cfjz8cbj","source_transformations_extent.md":"D6fK7i3a","source_transformations_flip.md":"Drqj7zVo","source_transformations_reproject.md":"CmgYJAT2","source_transformations_segmentize.md":"A3Zwf5SL","source_transformations_simplify.md":"Bjsi40yW","source_transformations_transform.md":"fQuX-Pz6","source_transformations_tuples.md":"k24FH2eZ","source_types.md":"CL-ODfd9","source_utils.md":"DLZcNIzl","tutorials_creating_geometry.md":"kdUBQRWQ","tutorials_geodesic_paths.md":"0IfaH3DB","tutorials_spatial_joins.md":"Bs6yD1m0"} diff --git a/previews/PR237/index.html b/previews/PR237/index.html new file mode 100644 index 000000000..7543babe9 --- /dev/null +++ b/previews/PR237/index.html @@ -0,0 +1,25 @@ + + + + + + What is GeometryOps.jl? | GeometryOps.jl + + + + + + + + + + + + + + +
    Skip to content

    GeometryOps.jl

    Blazing fast geometry operations in pure Julia

    GeometryOps

    What is GeometryOps.jl?

    GeometryOps.jl is a package for geometric calculations on (primarily 2D) geometries.

    The driving idea behind this package is to unify all the disparate packages for geometric calculations in Julia, and make them GeoInterface.jl-compatible. We seem to be focusing primarily on 2/2.5D geometries for now.

    Most of the usecases are driven by GIS and similar Earth data workflows, so this might be a bit specialized towards that, but methods should always be general to any coordinate space.

    We welcome contributions, either as pull requests or discussion on issues!

    How to navigate the docs

    GeometryOps' docs are divided into three main sections: tutorials, explanations and source code.
    Documentation and examples for many functions can be found in the source code section, since we use literate programming in GeometryOps.

    • Tutorials are meant to teach the fundamental concepts behind GeometryOps, and how to perform certain operations.
    • Explanations usually contain little code, and explain in more detail how GeometryOps works.
    • Source code usually contains explanations and examples at the top of the page, followed by annotated source code from that file.
    + + + + \ No newline at end of file diff --git a/previews/PR237/introduction.html b/previews/PR237/introduction.html new file mode 100644 index 000000000..7974ae0f5 --- /dev/null +++ b/previews/PR237/introduction.html @@ -0,0 +1,25 @@ + + + + + + Introduction | GeometryOps.jl + + + + + + + + + + + + + + +
    Skip to content

    Introduction

    GeometryOps.jl is a package for geometric calculations on (primarily 2D) geometries.

    The driving idea behind this package is to unify all the disparate packages for geometric calculations in Julia, and make them GeoInterface.jl-compatible. We seem to be focusing primarily on 2/2.5D geometries for now.

    Most of the usecases are driven by GIS and similar Earth data workflows, so this might be a bit specialized towards that, but methods should always be general to any coordinate space.

    We welcome contributions, either as pull requests or discussion on issues!

    Main concepts

    The apply paradigm

    Note

    See the Primitive Functions page for more information on this.

    The apply function allows you to decompose a given collection of geometries down to a certain level, and then operate on it.

    Functionally, it's similar to map in the way you apply it to geometries.

    apply and applyreduce take any geometry, vector of geometries, collection of geometries, or table (like Shapefile.Table, DataFrame, or GeoTable)!

    What's this GeoInterface.Wrapper thing?

    Write a comment about GeoInterface.Wrapper and why it helps in type stability to guarantee a particular return type.

    + + + + \ No newline at end of file diff --git a/previews/PR237/logo.png b/previews/PR237/logo.png new file mode 100644 index 0000000000000000000000000000000000000000..8a3120119f5fb9fc512cf7c86c6adb6396b1c663 GIT binary patch literal 87252 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 G%zps%(o>rN literal 0 HcmV?d00001 diff --git a/previews/PR237/siteinfo.js b/previews/PR237/siteinfo.js new file mode 100644 index 000000000..775bce87f --- /dev/null +++ b/previews/PR237/siteinfo.js @@ -0,0 +1 @@ +var DOCUMENTER_CURRENT_VERSION = "previews/PR237"; diff --git a/previews/PR237/source/GeometryOps.html b/previews/PR237/source/GeometryOps.html new file mode 100644 index 000000000..ec872a3cb --- /dev/null +++ b/previews/PR237/source/GeometryOps.html @@ -0,0 +1,109 @@ + + + + + + GeometryOps.jl + + + + + + + + + + + + + + +
    Skip to content

    GeometryOps.jl

    julia
    module GeometryOps
    +
    +import GeometryOpsCore
    +import GeometryOpsCore:
    +                TraitTarget,
    +                Manifold, Planar, Spherical, Geodesic,
    +                BoolsAsTypes, _True, _False, _booltype,
    +                apply, applyreduce,
    +                flatten, reconstruct, rebuild, unwrap, _linearring,
    +                APPLY_KEYWORDS, THREADED_KEYWORD, CRS_KEYWORD, CALC_EXTENT_KEYWORD
    +
    +export TraitTarget, Manifold, Planar, Spherical, Geodesic, apply, applyreduce, flatten, reconstruct, rebuild, unwrap
    +
    +using GeoInterface
    +using GeometryBasics
    +using LinearAlgebra, Statistics
    +
    +import Tables, DataAPI
    +import GeometryBasics.StaticArrays
    +import DelaunayTriangulation # for convex hull and triangulation
    +import ExactPredicates
    +import Base.@kwdef
    +import GeoInterface.Extents: Extents
    +
    +const GI = GeoInterface
    +const GB = GeometryBasics
    +
    +const TuplePoint{T} = Tuple{T, T} where T <: AbstractFloat
    +const Edge{T} = Tuple{TuplePoint{T},TuplePoint{T}} where T
    +
    +include("types.jl")
    +include("primitives.jl")
    +include("utils.jl")
    +include("not_implemented_yet.jl")
    +
    +include("methods/angles.jl")
    +include("methods/area.jl")
    +include("methods/barycentric.jl")
    +include("methods/buffer.jl")
    +include("methods/centroid.jl")
    +include("methods/convex_hull.jl")
    +include("methods/distance.jl")
    +include("methods/equals.jl")
    +include("methods/clipping/predicates.jl")
    +include("methods/clipping/clipping_processor.jl")
    +include("methods/clipping/coverage.jl")
    +include("methods/clipping/cut.jl")
    +include("methods/clipping/intersection.jl")
    +include("methods/clipping/difference.jl")
    +include("methods/clipping/union.jl")
    +include("methods/geom_relations/contains.jl")
    +include("methods/geom_relations/coveredby.jl")
    +include("methods/geom_relations/covers.jl")
    +include("methods/geom_relations/crosses.jl")
    +include("methods/geom_relations/disjoint.jl")
    +include("methods/geom_relations/geom_geom_processors.jl")
    +include("methods/geom_relations/intersects.jl")
    +include("methods/geom_relations/overlaps.jl")
    +include("methods/geom_relations/touches.jl")
    +include("methods/geom_relations/within.jl")
    +include("methods/orientation.jl")
    +include("methods/polygonize.jl")
    +
    +include("transformations/extent.jl")
    +include("transformations/flip.jl")
    +include("transformations/reproject.jl")
    +include("transformations/segmentize.jl")
    +include("transformations/simplify.jl")
    +include("transformations/tuples.jl")
    +include("transformations/transform.jl")
    +include("transformations/correction/geometry_correction.jl")
    +include("transformations/correction/closed_ring.jl")
    +include("transformations/correction/intersecting_polygons.jl")

    Import all names from GeoInterface and Extents, so users can do GO.extent or GO.trait.

    julia
    for name in names(GeoInterface)
    +    @eval using GeoInterface: $name
    +end
    +for name in names(Extents)
    +    @eval using GeoInterface.Extents: $name
    +end
    +
    +function __init__()

    Handle all available errors!

    julia
        Base.Experimental.register_error_hint(_reproject_error_hinter, MethodError)
    +    Base.Experimental.register_error_hint(_geodesic_segments_error_hinter, MethodError)
    +    Base.Experimental.register_error_hint(_buffer_error_hinter, MethodError)
    +end
    +
    +end

    This page was generated using Literate.jl.

    + + + + \ No newline at end of file diff --git a/previews/PR237/source/GeometryOpsFlexiJoinsExt/GeometryOpsFlexiJoinsExt.html b/previews/PR237/source/GeometryOpsFlexiJoinsExt/GeometryOpsFlexiJoinsExt.html new file mode 100644 index 000000000..59eb6dd88 --- /dev/null +++ b/previews/PR237/source/GeometryOpsFlexiJoinsExt/GeometryOpsFlexiJoinsExt.html @@ -0,0 +1,40 @@ + + + + + + GeometryOps.jl + + + + + + + + + + + + + + +
    Skip to content
    julia
    module GeometryOpsFlexiJoinsExt
    +
    +using GeometryOps
    +using FlexiJoins
    +
    +import GeometryOps as GO, GeoInterface as GI
    +using SortTileRecursiveTree, Tables

    This module defines the FlexiJoins APIs for GeometryOps' boolean comparison functions, taken from DE-9IM.

    First, we define the joining modes (Tree, NestedLoopFast) that the GO DE-9IM functions support.

    julia
    const GO_DE9IM_FUNCS = Union{typeof(GO.contains), typeof(GO.within), typeof(GO.intersects), typeof(GO.disjoint), typeof(GO.touches), typeof(GO.crosses), typeof(GO.overlaps), typeof(GO.covers), typeof(GO.coveredby), typeof(GO.equals)}

    NestedLoopFast is the naive fallback method

    julia
    FlexiJoins.supports_mode(::FlexiJoins.Mode.NestedLoopFast, ::FlexiJoins.ByPred{F}, datas) where F <: GO_DE9IM_FUNCS = true

    This method allows you to cache a tree, which we do by using an STRtree. TODO: wrap GO predicate functions in a TreeJoiner struct or something, to indicate that we want to use trees, since they can be slower in some situations.

    julia
    FlexiJoins.supports_mode(::FlexiJoins.Mode.Tree, ::FlexiJoins.ByPred{F}, datas) where F <: GO_DE9IM_FUNCS = true

    Nested loop support is simple, and needs no further support. However, for trees, we need to define how the tree is prepared and how it is used. This is done by defining the prepare_for_join function to return an STRTree, and by defining the findmatchix function as querying that tree before checking intersections.

    In theory, one could extract the tree from e.g a GeoPackage or some future GeoDataFrame.

    julia
    FlexiJoins.prepare_for_join(::FlexiJoins.Mode.Tree, X, cond::FlexiJoins.ByPred{<: GO_DE9IM_FUNCS}) = (X, SortTileRecursiveTree.STRtree(map(cond.Rf, X)))
    +function FlexiJoins.findmatchix(::FlexiJoins.Mode.Tree, cond::FlexiJoins.ByPred{F}, ix_a, a, (B, tree)::Tuple, multi::typeof(identity)) where F <: GO_DE9IM_FUNCS

    Implementation note: here, a is a row, and b is the full table. We extract the relevant columns using cond.Lf and cond.Rf.

    julia
        idxs = SortTileRecursiveTree.query(tree, cond.Lf(a))
    +    intersecting_idxs = filter!(idxs) do idx
    +        cond.pred(cond.Lf(a), cond.Rf(B[idx]))
    +    end
    +    return intersecting_idxs
    +end

    Finally, for completeness, we define the swap_sides function for those predicates which are defined as inversions.

    julia
    FlexiJoins.swap_sides(::typeof(GO.contains)) = GO.within
    +FlexiJoins.swap_sides(::typeof(GO.within)) = GO.contains
    +FlexiJoins.swap_sides(::typeof(GO.coveredby)) = GO.covers
    +FlexiJoins.swap_sides(::typeof(GO.covers)) = GO.coveredby

    That's a wrap, folks!

    julia
    end

    This page was generated using Literate.jl.

    + + + + \ No newline at end of file diff --git a/previews/PR237/source/GeometryOpsLibGEOSExt/GeometryOpsLibGEOSExt.html b/previews/PR237/source/GeometryOpsLibGEOSExt/GeometryOpsLibGEOSExt.html new file mode 100644 index 000000000..59245d14b --- /dev/null +++ b/previews/PR237/source/GeometryOpsLibGEOSExt/GeometryOpsLibGEOSExt.html @@ -0,0 +1,55 @@ + + + + + + GeometryOps.jl + + + + + + + + + + + + + + +
    Skip to content
    julia
    module GeometryOpsLibGEOSExt
    +
    +import GeometryOps as GO, LibGEOS as LG
    +import GeoInterface as GI
    +
    +import GeometryOps: GEOS, enforce, _True, _False, _booltype
    +
    +using GeometryOps

    The filter statement is required because in Julia, each module has its own versions of these functions, which serve to evaluate or include code inside the scope of the module. However, if you import those from another module (which you would with all=true), that creates an ambiguity which causes a warning during precompile/load time. In order to avoid this, we filter out these special functions.

    julia
    for name in filter(!in((:var"#eval", :eval, :var"#include", :include)), names(GeometryOps))
    +    @eval import GeometryOps: $name
    +end
    +
    +"""
    +    _wrap(geom; crs, calc_extent)
    +
    +Wraps `geom` in a GI wrapper geometry of its geometry trait.  This allows us
    +to attach CRS and extent info to geometry types which otherwise could not hold
    +those, like LibGEOS and WKB geometries.
    +
    +Returns a GI wrapper geometry, for which `parent(result) == geom`.
    +"""
    +function _wrap(geom; crs=GI.crs(geom), calc_extent = true)
    +    return GI.geointerface_geomtype(GI.geomtrait(geom))(geom; crs, extent = GI.extent(geom, calc_extent))
    +end
    +
    +include("buffer.jl")
    +include("segmentize.jl")
    +include("simplify.jl")
    +
    +include("simple_overrides.jl")
    +
    +end

    This page was generated using Literate.jl.

    + + + + \ No newline at end of file diff --git a/previews/PR237/source/GeometryOpsLibGEOSExt/buffer.html b/previews/PR237/source/GeometryOpsLibGEOSExt/buffer.html new file mode 100644 index 000000000..e49fc1721 --- /dev/null +++ b/previews/PR237/source/GeometryOpsLibGEOSExt/buffer.html @@ -0,0 +1,55 @@ + + + + + + GeometryOps.jl + + + + + + + + + + + + + + +
    Skip to content
    julia
    const _GEOS_CAPSTYLE_LOOKUP = Dict{Symbol, LG.GEOSBufCapStyles}(
    +    :round => LG.GEOSBUF_CAP_ROUND,
    +    :flat => LG.GEOSBUF_CAP_FLAT,
    +    :square => LG.GEOSBUF_CAP_SQUARE,
    +)
    +
    +const _GEOS_JOINSTYLE_LOOKUP = Dict{Symbol, LG.GEOSBufJoinStyles}(
    +    :round => LG.GEOSBUF_JOIN_ROUND,
    +    :mitre => LG.GEOSBUF_JOIN_MITRE,
    +    :bevel => LG.GEOSBUF_JOIN_BEVEL,
    +)
    +
    +to_cap_style(style::Symbol) = _GEOS_CAPSTYLE_LOOKUP[style]
    +to_cap_style(style::LG.GEOSBufCapStyles) = style
    +to_cap_style(num::Integer) = num
    +
    +to_join_style(style::Symbol) = _GEOS_JOINSTYLE_LOOKUP[style]
    +to_join_style(style::LG.GEOSBufJoinStyles) = style
    +to_join_style(num::Integer) = num
    +
    +function GO.buffer(alg::GEOS, geometry, distance; calc_extent = true, kwargs...)

    The reason we use apply here is so that this also works with featurecollections, tables, vectors of geometries, etc!

    julia
        return apply(TraitTarget{GI.AbstractGeometryTrait}(), geometry; kwargs...) do geom
    +        newgeom = LG.bufferWithStyle(
    +            GI.convert(LG, geom), distance;
    +            quadsegs = get(alg, :quadsegs, 8),
    +            endCapStyle = to_cap_style(get(alg, :endCapStyle, :round)),
    +            joinStyle = to_join_style(get(alg, :joinStyle, :round)),
    +            mitreLimit = get(alg, :mitreLimit, 5.0),
    +        )
    +        return _wrap(newgeom; crs = GI.crs(geom), calc_extent)
    +    end
    +end

    This page was generated using Literate.jl.

    + + + + \ No newline at end of file diff --git a/previews/PR237/source/GeometryOpsLibGEOSExt/segmentize.html b/previews/PR237/source/GeometryOpsLibGEOSExt/segmentize.html new file mode 100644 index 000000000..8750bdd32 --- /dev/null +++ b/previews/PR237/source/GeometryOpsLibGEOSExt/segmentize.html @@ -0,0 +1,45 @@ + + + + + + Segmentize | GeometryOps.jl + + + + + + + + + + + + + + +
    Skip to content

    Segmentize

    julia
    import GeometryOps: segmentize, apply

    This file implements the LibGEOS segmentization method for GeometryOps.

    julia
    function _segmentize_geos(geom::LG.AbstractGeometry, max_distance)
    +    context = LG.get_context(geom)
    +    result = LG.GEOSDensify_r(context, geom, max_distance)
    +    if result == C_NULL
    +        error("LibGEOS: Error in GEOSDensify")
    +    end
    +    return LG.geomFromGEOS(result, context)
    +end
    +
    +_segmentize_geos(geom, max_distance) = _segmentize_geos(GI.convert(LG, geom), max_distance)
    +
    +function _wrap_and_segmentize_geos(geom, max_distance)
    +    _wrap(_segmentize_geos(geom, max_distance); crs = GI.crs(geom), calc_extent = false)
    +end

    2 behaviours:

    • enforce: enforce the presence of a kwargs

    • fetch: fetch the value of a kwargs, or return a default value

    julia
    @inline function GO.segmentize(alg::GEOS, geom; threaded::Union{Bool, GO.BoolsAsTypes} = _False())
    +    max_distance = enforce(alg, :max_distance, GO.segmentize)
    +    return GO.apply(
    +        Base.Fix2(_wrap_and_segmentize_geos, max_distance),

    TODO: should this just be a target on GI.AbstractGeometryTrait()? But Geos doesn't support eg RectangleTrait Maybe we need an abstract trait GI.AbstractWKBGeomTrait?

    julia
            GO.TraitTarget(GI.GeometryCollectionTrait(), GI.MultiPolygonTrait(), GI.PolygonTrait(), GI.MultiLineStringTrait(), GI.LineStringTrait(), GI.LinearRingTrait(), GI.MultiPointTrait(), GI.PointTrait()),
    +        geom;
    +        threaded
    +    )
    +end

    This page was generated using Literate.jl.

    + + + + \ No newline at end of file diff --git a/previews/PR237/source/GeometryOpsLibGEOSExt/simple_overrides.html b/previews/PR237/source/GeometryOpsLibGEOSExt/simple_overrides.html new file mode 100644 index 000000000..f62464c0c --- /dev/null +++ b/previews/PR237/source/GeometryOpsLibGEOSExt/simple_overrides.html @@ -0,0 +1,70 @@ + + + + + + Simple overrides | GeometryOps.jl + + + + + + + + + + + + + + +
    Skip to content

    Simple overrides

    This file contains simple overrides for GEOS, essentially only those functions which have direct counterparts in LG and only require conversion before calling.

    Polygon set operations

    Difference

    julia
    function GO.difference(::GEOS, geom_a, geom_b; target=nothing, calc_extent = false)
    +    return _wrap(LG.difference(GI.convert(LG, geom_a), GI.convert(LG, geom_b)); crs = GI.crs(geom_a), calc_extent)
    +end

    Union

    julia
    function GO.union(::GEOS, geom_a, geom_b; target=nothing, calc_extent = false)
    +    return _wrap(LG.union(GI.convert(LG, geom_a), GI.convert(LG, geom_b)); crs = GI.crs(geom_a), calc_extent)
    +end

    Intersection

    julia
    function GO.intersection(::GEOS, geom_a, geom_b; target=nothing, calc_extent = false)
    +    return _wrap(LG.intersection(GI.convert(LG, geom_a), GI.convert(LG, geom_b)); crs = GI.crs(geom_a), calc_extent)
    +end

    Symmetric difference

    julia
    function GO.symdifference(::GEOS, geom_a, geom_b; target=nothing, calc_extent = false)
    +    return _wrap(LG.symmetric_difference(GI.convert(LG, geom_a), GI.convert(LG, geom_b)); crs = GI.crs(geom_a), calc_extent)
    +end

    DE-9IM boolean methods

    Equals

    julia
    function GO.equals(::GEOS, geom_a, geom_b)
    +    return LG.equals(GI.convert(LG, geom_a), GI.convert(LG, geom_b))
    +end

    Disjoint

    julia
    function GO.disjoint(::GEOS, geom_a, geom_b)
    +    return LG.disjoint(GI.convert(LG, geom_a), GI.convert(LG, geom_b))
    +end

    Touches

    julia
    function GO.touches(::GEOS, geom_a, geom_b)
    +    return LG.touches(GI.convert(LG, geom_a), GI.convert(LG, geom_b))
    +end

    Crosses

    julia
    function GO.crosses(::GEOS, geom_a, geom_b)
    +    return LG.crosses(GI.convert(LG, geom_a), GI.convert(LG, geom_b))
    +end

    Within

    julia
    function GO.within(::GEOS, geom_a, geom_b)
    +    return LG.within(GI.convert(LG, geom_a), GI.convert(LG, geom_b))
    +end

    Contains

    julia
    function GO.contains(::GEOS, geom_a, geom_b)
    +    return LG.contains(GI.convert(LG, geom_a), GI.convert(LG, geom_b))
    +end

    Overlaps

    julia
    function GO.overlaps(::GEOS, geom_a, geom_b)
    +    return LG.overlaps(GI.convert(LG, geom_a), GI.convert(LG, geom_b))
    +end

    Covers

    julia
    function GO.covers(::GEOS, geom_a, geom_b)
    +    return LG.covers(GI.convert(LG, geom_a), GI.convert(LG, geom_b))
    +end

    CoveredBy

    julia
    function GO.coveredby(::GEOS, geom_a, geom_b)
    +    return LG.coveredby(GI.convert(LG, geom_a), GI.convert(LG, geom_b))
    +end

    Intersects

    julia
    function GO.intersects(::GEOS, geom_a, geom_b)
    +    return LG.intersects(GI.convert(LG, geom_a), GI.convert(LG, geom_b))
    +end

    Convex hull

    julia
    function GO.convex_hull(::GEOS, geoms)
    +    chull = LG.convexhull(
    +        LG.MultiPoint(
    +            collect(
    +                GO.flatten(
    +                    x -> GI.convert(LG.Point, x),
    +                    GI.PointTrait,
    +                    geoms
    +                )
    +            )
    +        )
    +    );
    +    return _wrap(
    +        chull;
    +        crs = GI.crs(geoms),
    +        calc_extent = false
    +    )
    +end

    This page was generated using Literate.jl.

    + + + + \ No newline at end of file diff --git a/previews/PR237/source/GeometryOpsLibGEOSExt/simplify.html b/previews/PR237/source/GeometryOpsLibGEOSExt/simplify.html new file mode 100644 index 000000000..8a5132477 --- /dev/null +++ b/previews/PR237/source/GeometryOpsLibGEOSExt/simplify.html @@ -0,0 +1,53 @@ + + + + + + GeometryOps.jl + + + + + + + + + + + + + + +
    Skip to content

    Address potential ambiguities

    julia
    GO._simplify(::GI.PointTrait, ::GO.GEOS, geom; kw...) = geom
    +GO._simplify(::GI.MultiPointTrait, ::GO.GEOS, geom; kw...) = geom
    +
    +function GO._simplify(::GI.AbstractGeometryTrait, alg::GO.GEOS, geom; kwargs...)
    +    method = get(alg, :method, :TopologyPreserve)
    +    @assert haskey(alg.params, :tol) """
    +        The `:tol` parameter is required for the GEOS algorithm in `simplify`,
    +        but it was not provided.
    +
    +        Provide it by passing `GEOS(; tol = ...,) as the algorithm.
    +        """
    +    tol = alg.params.tol
    +    if method == :TopologyPreserve
    +        return LG.topologyPreserveSimplify(GI.convert(LG, geom), tol)
    +    elseif method == :DouglasPeucker
    +        return LG.simplify(GI.convert(LG, geom), tol)
    +    else
    +        error("Invalid method passed to `GO.simplify(GEOS(...), ...)`: $method. Please use :TopologyPreserve or :DouglasPeucker")
    +    end
    +end
    +
    +function GO._simplify(trait::GI.AbstractCurveTrait, alg::GO.GEOS, geom; kw...)
    +    Base.invoke(
    +        GO._simplify,
    +        Tuple{GI.AbstractGeometryTrait, GO.GEOS, typeof(geom)},
    +        trait, alg, geom;
    +        kw...
    +    )
    +end

    This page was generated using Literate.jl.

    + + + + \ No newline at end of file diff --git a/previews/PR237/source/GeometryOpsProjExt/GeometryOpsProjExt.html b/previews/PR237/source/GeometryOpsProjExt/GeometryOpsProjExt.html new file mode 100644 index 000000000..6aec00c2f --- /dev/null +++ b/previews/PR237/source/GeometryOpsProjExt/GeometryOpsProjExt.html @@ -0,0 +1,32 @@ + + + + + + GeometryOps.jl + + + + + + + + + + + + + + +
    Skip to content
    julia
    module GeometryOpsProjExt
    +
    +using GeometryOps, Proj
    +
    +include("reproject.jl")
    +include("segmentize.jl")
    +
    +end

    This page was generated using Literate.jl.

    + + + + \ No newline at end of file diff --git a/previews/PR237/source/GeometryOpsProjExt/reproject.html b/previews/PR237/source/GeometryOpsProjExt/reproject.html new file mode 100644 index 000000000..63e81e80b --- /dev/null +++ b/previews/PR237/source/GeometryOpsProjExt/reproject.html @@ -0,0 +1,68 @@ + + + + + + GeometryOps.jl + + + + + + + + + + + + + + +
    Skip to content
    julia
    import GeometryOps: GI, GeoInterface, reproject, apply, transform, _is3d, _True, _False
    +import Proj
    +
    +function reproject(geom;
    +    source_crs=nothing, target_crs=nothing, transform=nothing, kw...
    +)
    +    if isnothing(transform)
    +        if isnothing(source_crs)
    +            source_crs = if GI.trait(geom) isa Nothing && geom isa AbstractArray
    +                GeoInterface.crs(first(geom))
    +            else
    +                GeoInterface.crs(geom)
    +            end
    +        end

    If its still nothing, error

    julia
            isnothing(source_crs) && throw(ArgumentError("geom has no crs attached. Pass a `source_crs` keyword"))

    Otherwise reproject

    julia
            reproject(geom, source_crs, target_crs; kw...)
    +    else
    +        reproject(geom, transform; kw...)
    +    end
    +end
    +function reproject(geom, source_crs, target_crs;
    +    time=Inf,
    +    always_xy=true,
    +    transform=nothing,
    +    kw...
    +)
    +    transform = if isnothing(transform)
    +        s = source_crs isa Proj.CRS ? source_crs : convert(String, source_crs)
    +        t = target_crs isa Proj.CRS ? target_crs : convert(String, target_crs)
    +        Proj.Transformation(s, t; always_xy)
    +    else
    +        transform
    +    end
    +    reproject(geom, transform; time, target_crs, kw...)
    +end
    +function reproject(geom, transform::Proj.Transformation; time=Inf, target_crs=nothing, kw...)
    +    if _is3d(geom)
    +        return apply(GI.PointTrait(), geom; crs=target_crs, kw...) do p
    +            transform(GI.x(p), GI.y(p), GI.z(p))
    +        end
    +    else
    +        return apply(GI.PointTrait(), geom; crs=target_crs, kw...) do p
    +            transform(GI.x(p), GI.y(p))
    +        end
    +    end
    +end

    This page was generated using Literate.jl.

    + + + + \ No newline at end of file diff --git a/previews/PR237/source/GeometryOpsProjExt/segmentize.html b/previews/PR237/source/GeometryOpsProjExt/segmentize.html new file mode 100644 index 000000000..8f3414415 --- /dev/null +++ b/previews/PR237/source/GeometryOpsProjExt/segmentize.html @@ -0,0 +1,55 @@ + + + + + + GeometryOps.jl + + + + + + + + + + + + + + +
    Skip to content

    This holds the segmentize geodesic functionality.

    julia
    import GeometryOps: GeodesicSegments, _segmentize, _fill_linear_kernel!
    +import Proj
    +
    +function GeometryOps.GeodesicSegments(; max_distance, equatorial_radius::Real=6378137, flattening::Real=1/298.257223563, geodesic::Proj.geod_geodesic = Proj.geod_geodesic(equatorial_radius, flattening))
    +    return GeometryOps.GeodesicSegments{Proj.geod_geodesic}(geodesic, max_distance)
    +end

    This is the same method as in transformations/segmentize.jl, but it constructs a Proj geodesic line every time. Maybe this should be better...

    julia
    function _segmentize(method::Geodesic, geom, ::Union{GI.LineStringTrait, GI.LinearRingTrait}; max_distance)
    +    proj_geodesic = Proj.geod_geodesic(method.semimajor_axis #= same thing as equatorial radius =#, 1/method.inv_flattening)
    +    first_coord = GI.getpoint(geom, 1)
    +    x1, y1 = GI.x(first_coord), GI.y(first_coord)
    +    new_coords = NTuple{2, Float64}[]
    +    sizehint!(new_coords, GI.npoint(geom))
    +    push!(new_coords, (x1, y1))
    +    for coord in Iterators.drop(GI.getpoint(geom), 1)
    +        x2, y2 = GI.x(coord), GI.y(coord)
    +        _fill_linear_kernel!(method, new_coords, x1, y1, x2, y2; max_distance, proj_geodesic)
    +        x1, y1 = x2, y2
    +    end
    +    return rebuild(geom, new_coords)
    +end
    +
    +function GeometryOps._fill_linear_kernel!(method::Geodesic, new_coords::Vector, x1, y1, x2, y2; max_distance, proj_geodesic)
    +    geod_line = Proj.geod_inverseline(proj_geodesic, y1, x1, y2, x2)

    This is the distance in meters computed between the two points. It's s13 because geod_inverseline sets point 3 to the second input point.

    julia
        distance = geod_line.s13
    +    if distance > max_distance
    +        n_segments = ceil(Int, distance / max_distance)
    +        for i in 1:(n_segments - 1)
    +            y, x, _ = Proj.geod_position(geod_line, i / n_segments * distance)
    +            push!(new_coords, (x, y))
    +        end
    +    end

    End the line with the original coordinate, to avoid any multiplication errors.

    julia
        push!(new_coords, (x2, y2))
    +    return nothing
    +end

    This page was generated using Literate.jl.

    + + + + \ No newline at end of file diff --git a/previews/PR237/source/methods/angles.html b/previews/PR237/source/methods/angles.html new file mode 100644 index 000000000..8e9ce2540 --- /dev/null +++ b/previews/PR237/source/methods/angles.html @@ -0,0 +1,148 @@ + + + + + + Angles | GeometryOps.jl + + + + + + + + + + + + + + +
    Skip to content

    Angles

    julia
    export angles

    What is angles?

    Angles are the angles formed by a given geometries line segments, if it has line segments.

    To provide an example, consider this rectangle:

    julia
    import GeometryOps as GO
    +import GeoInterface as GI
    +using Makie, CairoMakie
    +
    +rect = GI.Polygon([[(0.0, 0.0), (0.0, 1.0), (1.0, 1.0), (1.0, 0.0), (0.0, 0.0)]])
    +f, a, p = poly(collect(GI.getpoint(rect)); axis = (; aspect = DataAspect()))

    This is clearly a rectangle, with angles of 90 degrees.

    julia
    GO.angles(rect)  # [90, 90, 90, 90]
    4-element Vector{Float64}:
    + 90.0
    + 90.0
    + 90.0
    + 90.0

    Implementation

    This is the GeoInterface-compatible implementation. First, we implement a wrapper method that dispatches to the correct implementation based on the geometry trait. This is also used in the implementation, since it's a lot less work!

    julia
    const _ANGLE_TARGETS = TraitTarget{Union{GI.PolygonTrait,GI.AbstractCurveTrait,GI.MultiPointTrait,GI.PointTrait}}()
    +
    +"""
    +    angles(geom, ::Type{T} = Float64)
    +
    +Returns the angles of a geometry or collection of geometries.
    +This is computed differently for different geometries:
    +
    +    - The angles of a point is an empty vector.
    +    - The angles of a single line segment is an empty vector.
    +    - The angles of a linestring or linearring is a vector of angles formed by the curve.
    +    - The angles of a polygon is a vector of vectors of angles formed by each ring.
    +    - The angles of a multi-geometry collection is a vector of the angles of each of the
    +        sub-geometries as defined above.
    +
    +Result will be a Vector, or nested set of vectors, of type T where an optional argument with
    +a default value of Float64.
    +"""
    +function angles(geom, ::Type{T} = Float64; threaded =false) where T <: AbstractFloat
    +    applyreduce(vcat, _ANGLE_TARGETS, geom; threaded, init = Vector{T}()) do g
    +        _angles(T, GI.trait(g), g)
    +    end
    +end

    Points and single line segments have no angles

    julia
    _angles(::Type{T}, ::Union{GI.PointTrait, GI.MultiPointTrait, GI.LineTrait}, geom) where T = T[]
    +
    +#= The angles of a linestring are the angles formed by the line. If the first and last point
    +are not explicitly repeated, the geom is not considered closed. The angles should all be on
    +one side of the line, but a particular side is not guaranteed by this function. =#
    +function _angles(::Type{T}, ::GI.LineStringTrait, geom) where T
    +    npoints = GI.npoint(geom)
    +    first_last_equal = equals(GI.getpoint(geom, 1), GI.getpoint(geom, npoints))
    +    angle_list = Vector{T}(undef, npoints - (first_last_equal ? 1 : 2))
    +    _find_angles!(
    +        T, angle_list, geom;
    +        offset = first_last_equal, close_geom = false,
    +    )
    +    return angle_list
    +end
    +
    +#= The angles of a linearring are the angles within the closed line and include the angles
    +formed by connecting the first and last points of the curve. =#
    +function _angles(::Type{T}, ::GI.LinearRingTrait, geom; interior = true) where T
    +    npoints = GI.npoint(geom)
    +    first_last_equal = equals(GI.getpoint(geom, 1), GI.getpoint(geom, npoints))
    +    angle_list = Vector{T}(undef, npoints - (first_last_equal ? 1 : 0))
    +    _find_angles!(
    +        T, angle_list, geom;
    +        offset = true, close_geom = !first_last_equal, interior = interior,
    +    )
    +    return angle_list
    +end
    +
    +#= The angles of a polygon is a vector of polygon angles. Note that if there are holes
    +within the polygon, the angles will be listed after the exterior ring angles in order of the
    +holes. All angles, including the hole angles, are interior angles of the polygon.=#
    +function _angles(::Type{T}, ::GI.PolygonTrait, geom) where T
    +    angles = _angles(T, GI.LinearRingTrait(), GI.getexterior(geom); interior = true)
    +    for h in GI.gethole(geom)
    +        append!(angles, _angles(T, GI.LinearRingTrait(), h; interior = false))
    +    end
    +    return angles
    +end

    Find angles of a curve and insert the values into the angle_list. If offset is true, then save space for the angle at the first vertex, as the curve is closed, at the front of angle_list. If close_geom is true, then despite the first and last point not being explicitly repeated, the curve is closed and the angle of the last point should be added to angle_list. If interior is true, then all angles will be on the same side of the line

    julia
    function _find_angles!(
    +    ::Type{T}, angle_list, geom;
    +    offset, close_geom, interior = true,
    +) where T
    +    local p1, prev_p1_diff, p2_p1_diff
    +    local start_point, start_diff
    +    local extreem_idx, extreem_x, extreem_y
    +    i_offset = offset ? 1 : 0

    Loop through the curve and find each of the angels

    julia
        for (i, p2) in enumerate(GI.getpoint(geom))
    +        xp2, yp2 = GI.x(p2), GI.y(p2)
    +        #= Find point with smallest x values (and smallest y in case of a tie) as this point
    +        is know to be convex. =#
    +        if i == 1 || (xp2 < extreem_x || (xp2 == extreem_x && yp2 < extreem_y))
    +            extreem_idx = i
    +            extreem_x, extreem_y = xp2, yp2
    +        end
    +        if i > 1
    +            p2_p1_diff = (xp2 - GI.x(p1), yp2 - GI.y(p1))
    +            if i == 2
    +                start_point = p1
    +                start_diff = p2_p1_diff
    +            else
    +                angle_list[i - 2 + i_offset] = _diffs_calc_angle(T, prev_p1_diff, p2_p1_diff)
    +            end
    +            prev_p1_diff = -1 .* p2_p1_diff
    +        end
    +        p1 = p2
    +    end

    If the last point of geometry should be the same as the first, calculate closing angle

    julia
        if close_geom
    +        p2_p1_diff = (GI.x(start_point) - GI.x(p1), GI.y(start_point) - GI.y(p1))
    +        angle_list[end] = _diffs_calc_angle(T, prev_p1_diff, p2_p1_diff)
    +        prev_p1_diff = -1 .* p2_p1_diff
    +    end

    If needed, calculate first angle corresponding to the first point

    julia
        if offset
    +        angle_list[1] = _diffs_calc_angle(T, prev_p1_diff, start_diff)
    +    end
    +    #= Make sure that all of the angles are on the same side of the line and inside of the
    +    closed ring if the input geometry is closed. =#
    +    inside_sgn = sign(angle_list[extreem_idx]) * (interior ? 1 : -1)
    +    for i in eachindex(angle_list)
    +        idx_sgn = sign(angle_list[i])
    +        if idx_sgn == -1
    +            angle_list[i] = abs(angle_list[i])
    +        end
    +        if idx_sgn != inside_sgn
    +            angle_list[i] = 360 - angle_list[i]
    +        end
    +    end
    +    return
    +end

    Calculate the angle between two vectors defined by the previous and current Δx and Δys. Angle will have a sign corresponding to the sign of the cross product between the two vectors. All angles of one sign in a given geometry are convex, while those of the other sign are concave. However, the sign corresponding to each of these can vary based on geometry and thus you must compare to an angle that is know to be convex or concave.

    julia
    function _diffs_calc_angle(::Type{T}, (Δx_prev, Δy_prev), (Δx_curr, Δy_curr)) where T
    +    cross_prod = Δx_prev * Δy_curr - Δy_prev * Δx_curr
    +    dot_prod = Δx_prev * Δx_curr + Δy_prev * Δy_curr
    +    prev_mag = max(sqrt(Δx_prev^2 + Δy_prev^2), eps(T))
    +    curr_mag = max(sqrt(Δx_curr^2 + Δy_curr^2), eps(T))
    +    val = clamp(dot_prod / (prev_mag * curr_mag), -one(T), one(T))
    +    angle = real(acos(val) * 180 / π)
    +    return angle * (cross_prod < 0 ? -1 : 1)
    +end

    This page was generated using Literate.jl.

    + + + + \ No newline at end of file diff --git a/previews/PR237/source/methods/area.html b/previews/PR237/source/methods/area.html new file mode 100644 index 000000000..41ee4b8f1 --- /dev/null +++ b/previews/PR237/source/methods/area.html @@ -0,0 +1,111 @@ + + + + + + Area and signed area | GeometryOps.jl + + + + + + + + + + + + + + +
    Skip to content

    Area and signed area

    julia
    export area, signed_area

    What is area? What is signed area?

    Area is the amount of space occupied by a two-dimensional figure. It is always a positive value. Signed area is simply the integral over the exterior path of a polygon, minus the sum of integrals over its interior holes. It is signed such that a clockwise path has a positive area, and a counterclockwise path has a negative area. The area is the absolute value of the signed area.

    To provide an example, consider this rectangle:

    julia
    import GeometryOps as GO
    +import GeoInterface as GI
    +using Makie
    +using CairoMakie
    +
    +rect = GI.Polygon([[(0,0), (0,1), (1,1), (1,0), (0, 0)]])
    +f, a, p = poly(collect(GI.getpoint(rect)); axis = (; aspect = DataAspect()))

    This is clearly a rectangle, etc. But now let's look at how the points look:

    julia
    lines!(
    +    collect(GI.getpoint(rect));
    +    color = 1:GI.npoint(rect), linewidth = 10.0)
    +f

    The points are ordered in a counterclockwise fashion, which means that the signed area is negative. If we reverse the order of the points, we get a positive area.

    julia
    GO.signed_area(rect)  # -1.0
    -1.0

    Implementation

    This is the GeoInterface-compatible implementation. First, we implement a wrapper method that dispatches to the correct implementation based on the geometry trait. This is also used in the implementation, since it's a lot less work!

    Note that area and signed area are zero for all points and curves, even if the curves are closed like with a linear ring. Also note that signed area really only makes sense for polygons, given with a multipolygon can have several polygons each with a different orientation and thus the absolute value of the signed area might not be the area. This is why signed area is only implemented for polygons.

    Targets for applys functions

    julia
    const _AREA_TARGETS = TraitTarget{Union{GI.PolygonTrait,GI.AbstractCurveTrait,GI.MultiPointTrait,GI.PointTrait}}()
    +
    +"""
    +    area(geom, [T = Float64])::T
    +
    +Returns the area of a geometry or collection of geometries.
    +This is computed slightly differently for different geometries:
    +
    +    - The area of a point/multipoint is always zero.
    +    - The area of a curve/multicurve is always zero.
    +    - The area of a polygon is the absolute value of the signed area.
    +    - The area multi-polygon is the sum of the areas of all of the sub-polygons.
    +    - The area of a geometry collection, feature collection of array/iterable
    +        is the sum of the areas of all of the sub-geometries.
    +
    +Result will be of type T, where T is an optional argument with a default value
    +of Float64.
    +"""
    +function area(geom, ::Type{T} = Float64; threaded=false) where T <: AbstractFloat
    +    applyreduce(+, _AREA_TARGETS, geom; threaded, init=zero(T)) do g
    +        _area(T, GI.trait(g), g)
    +    end
    +end
    +
    +"""
    +    signed_area(geom, [T = Float64])::T
    +
    +Returns the signed area of a single geometry, based on winding order.
    +This is computed slightly differently for different geometries:
    +
    +    - The signed area of a point is always zero.
    +    - The signed area of a curve is always zero.
    +    - The signed area of a polygon is computed with the shoelace formula and is
    +    positive if the polygon coordinates wind clockwise and negative if
    +    counterclockwise.
    +    - You cannot compute the signed area of a multipolygon as it doesn't have a
    +    meaning as each sub-polygon could have a different winding order.
    +
    +Result will be of type T, where T is an optional argument with a default value
    +of Float64.
    +"""
    +signed_area(geom, ::Type{T} = Float64) where T <: AbstractFloat =
    +    _signed_area(T, GI.trait(geom), geom)

    Points, MultiPoints, Curves, MultiCurves

    julia
    _area(::Type{T}, ::GI.AbstractGeometryTrait, geom) where T = zero(T)
    +
    +_signed_area(::Type{T}, ::GI.AbstractGeometryTrait, geom) where T = zero(T)

    LibGEOS treats linear rings as zero area. I disagree with that but we should probably maintain compatibility...

    julia
    _area(::Type{T}, tr::GI.LinearRingTrait, geom) where T = 0 # could be abs(_signed_area(T, tr, geom))
    +
    +_signed_area(::Type{T}, ::GI.LinearRingTrait, geom) where T = 0 # could be _signed_area(T, tr, geom)

    Polygons

    julia
    _area(::Type{T}, trait::GI.PolygonTrait, poly) where T =
    +    abs(_signed_area(T, trait, poly))
    +
    +function _signed_area(::Type{T}, ::GI.PolygonTrait, poly) where T
    +    GI.isempty(poly) && return zero(T)
    +    s_area = _signed_area(T, GI.getexterior(poly))
    +    area = abs(s_area)
    +    area == 0 && return area

    Remove hole areas from total

    julia
        for hole in GI.gethole(poly)
    +        area -= abs(_signed_area(T, hole))
    +    end

    Winding of exterior ring determines sign

    julia
        return area * sign(s_area)
    +end

    One term of the shoelace area formula

    julia
    _area_component(p1, p2) = GI.x(p1) * GI.y(p2) - GI.y(p1) * GI.x(p2)
    +
    +#= Calculates the signed area of a given curve. This is equivalent to integrating
    +to find the area under the curve. Even if curve isn't explicitly closed by
    +repeating the first point at the end of the coordinates, curve is still assumed
    +to be closed. =#
    +function _signed_area(::Type{T}, geom) where T
    +    area = zero(T)
    +    np = GI.npoint(geom)
    +    np == 0 && return area
    +
    +    first = true
    +    local pfirst, p1

    Integrate the area under the curve

    julia
        for p2 in GI.getpoint(geom)

    Skip the first and do it later This lets us work within one iteration over geom, which means on C call when using points from external libraries.

    julia
            if first
    +            p1 = pfirst = p2
    +            first = false
    +            continue
    +        end

    Accumulate the area into area

    julia
            area += _area_component(p1, p2)
    +        p1 = p2
    +    end

    Complete the last edge. If the first and last where the same this will be zero

    julia
        p2 = pfirst
    +    area += _area_component(p1, p2)
    +    return T(area / 2)
    +end

    This page was generated using Literate.jl.

    + + + + \ No newline at end of file diff --git a/previews/PR237/source/methods/barycentric.html b/previews/PR237/source/methods/barycentric.html new file mode 100644 index 000000000..ea5c22b3d --- /dev/null +++ b/previews/PR237/source/methods/barycentric.html @@ -0,0 +1,439 @@ + + + + + + Barycentric coordinates | GeometryOps.jl + + + + + + + + + + + + + + +
    Skip to content

    Barycentric coordinates

    julia
    export barycentric_coordinates, barycentric_coordinates!, barycentric_interpolate
    +export MeanValue

    Generalized barycentric coordinates are a generalization of barycentric coordinates, which are typically used in triangles, to arbitrary polygons.

    They provide a way to express a point within a polygon as a weighted average of the polygon's vertices.

    In the case of a triangle, barycentric coordinates are a set of three numbers (λ1,λ2,λ3), each associated with a vertex of the triangle. Any point within the triangle can be expressed as a weighted average of the vertices, where the weights are the barycentric coordinates. The weights sum to 1, and each is non-negative.

    For a polygon with n vertices, generalized barycentric coordinates are a set of n numbers (λ1,λ2,...,λn), each associated with a vertex of the polygon. Any point within the polygon can be expressed as a weighted average of the vertices, where the weights are the generalized barycentric coordinates.

    As with the triangle case, the weights sum to 1, and each is non-negative.

    Example

    This example was taken from this page of CGAL's documentation.

    julia
    using GeometryOps
    +using GeometryOps.GeometryBasics
    +using Makie
    +using CairoMakie
    +# Define a polygon
    +polygon_points = Point3f[
    +(0.03, 0.05, 0.00), (0.07, 0.04, 0.02), (0.10, 0.04, 0.04),
    +(0.14, 0.04, 0.06), (0.17, 0.07, 0.08), (0.20, 0.09, 0.10),
    +(0.22, 0.11, 0.12), (0.25, 0.11, 0.14), (0.27, 0.10, 0.16),
    +(0.30, 0.07, 0.18), (0.31, 0.04, 0.20), (0.34, 0.03, 0.22),
    +(0.37, 0.02, 0.24), (0.40, 0.03, 0.26), (0.42, 0.04, 0.28),
    +(0.44, 0.07, 0.30), (0.45, 0.10, 0.32), (0.46, 0.13, 0.34),
    +(0.46, 0.19, 0.36), (0.47, 0.26, 0.38), (0.47, 0.31, 0.40),
    +(0.47, 0.35, 0.42), (0.45, 0.37, 0.44), (0.41, 0.38, 0.46),
    +(0.38, 0.37, 0.48), (0.35, 0.36, 0.50), (0.32, 0.35, 0.52),
    +(0.30, 0.37, 0.54), (0.28, 0.39, 0.56), (0.25, 0.40, 0.58),
    +(0.23, 0.39, 0.60), (0.21, 0.37, 0.62), (0.21, 0.34, 0.64),
    +(0.23, 0.32, 0.66), (0.24, 0.29, 0.68), (0.27, 0.24, 0.70),
    +(0.29, 0.21, 0.72), (0.29, 0.18, 0.74), (0.26, 0.16, 0.76),
    +(0.24, 0.17, 0.78), (0.23, 0.19, 0.80), (0.24, 0.22, 0.82),
    +(0.24, 0.25, 0.84), (0.21, 0.26, 0.86), (0.17, 0.26, 0.88),
    +(0.12, 0.24, 0.90), (0.07, 0.20, 0.92), (0.03, 0.15, 0.94),
    +(0.01, 0.10, 0.97), (0.02, 0.07, 1.00)]
    +# Plot it!
    +# First, we'll plot the polygon using Makie's rendering:
    +f, a1, p1 = poly(
    +    Point2d.(polygon_points);
    +    color = last.(polygon_points),
    +    colormap = cgrad(:jet, 18; categorical = true),
    +    axis = (;
    +       type = Axis, aspect = DataAspect(), title = "Makie mesh based polygon rendering", subtitle = "CairoMakie"
    +    ),
    +    figure = (; size = (800, 400),)
    +)
    +hidedecorations!(a1)
    +
    +ext = GeometryOps.GI.Extent(X = (0, 0.5), Y = (0, 0.42))
    +
    +a2 = Axis(
    +        f[1, 2],
    +        aspect = DataAspect(),
    +        title = "Barycentric coordinate based polygon rendering", subtitle = "GeometryOps",
    +        limits = (ext.X, ext.Y)
    +    )
    +hidedecorations!(a2)
    +
    +p2box = poly!( # Now, we plot a cropping rectangle around the axis so we only show the polygon
    +    a2,
    +    GeometryOps.GeometryBasics.Polygon( # This is a rectangle with an internal hole shaped like the polygon.
    +        Point2f[(ext.X[1], ext.Y[1]), (ext.X[2], ext.Y[1]), (ext.X[2], ext.Y[2]), (ext.X[1], ext.Y[2]), (ext.X[1], ext.Y[1])], # exterior
    +        [reverse(Point2f.(polygon_points))] # hole
    +    ); color = :white, xautolimits = false, yautolimits = false
    +)
    +cb = Colorbar(f[2, :], p1.plots[1]; vertical = false, flipaxis = true)
    +# Finally, we perform barycentric interpolation on a grid,
    +xrange = LinRange(ext.X..., 400)
    +yrange = LinRange(ext.Y..., 400)
    +@time mean_values = barycentric_interpolate.(
    +    (MeanValue(),), # The barycentric coordinate algorithm (MeanValue is the only one for now)
    +    (Point2f.(polygon_points),), # The polygon points as `Point2f`
    +    (last.(polygon_points,),),   # The values per polygon point - can be anything which supports addition and division
    +    Point2f.(xrange, yrange')    # The points at which to interpolate
    +)
    +# and render!
    +hm = heatmap!(a2, xrange, yrange, mean_values; colormap = p1.colormap, colorrange = p1.plots[1].colorrange[], xautolimits = false, yautolimits = false)
    +translate!(hm, 0, 0, -1) # translate the heatmap behind the cropping polygon!
    +f # finally, display the figure

    Barycentric-coordinate API

    In some cases, we actually want barycentric interpolation, and have no interest in the coordinates themselves.

    However, the coordinates can be useful for debugging, and when performing 3D rendering, multiple barycentric values (depth, uv) are needed for depth buffering.

    julia
    const _VecTypes = Union{Tuple{Vararg{T, N}}, GeometryBasics.StaticArraysCore.StaticArray{Tuple{N}, T, 1}} where {N, T}
    +
    +"""
    +    abstract type AbstractBarycentricCoordinateMethod
    +
    +Abstract supertype for barycentric coordinate methods.
    +The subtypes may serve as dispatch types, or may cache
    +some information about the target polygon.
    +
    +# API
    +The following methods must be implemented for all subtypes:
    +- `barycentric_coordinates!(λs::Vector{<: Real}, method::AbstractBarycentricCoordinateMethod, exterior::Vector{<: Point{2, T1}}, point::Point{2, T2})`
    +- `barycentric_interpolate(method::AbstractBarycentricCoordinateMethod, exterior::Vector{<: Point{2, T1}}, values::Vector{V}, point::Point{2, T2})::V`
    +- `barycentric_interpolate(method::AbstractBarycentricCoordinateMethod, exterior::Vector{<: Point{2, T1}}, interiors::Vector{<: Vector{<: Point{2, T1}}} values::Vector{V}, point::Point{2, T2})::V`
    +The rest of the methods will be implemented in terms of these, and have efficient dispatches for broadcasting.
    +"""
    +abstract type AbstractBarycentricCoordinateMethod end
    +
    +Base.@propagate_inbounds function barycentric_coordinates!(λs::Vector{<: Real}, method::AbstractBarycentricCoordinateMethod, polypoints::AbstractVector{<: Point{N1, T1}}, point::Point{N2, T2}) where {N1, N2, T1 <: Real, T2 <: Real}
    +    @boundscheck @assert length(λs) == length(polypoints)
    +    @boundscheck @assert length(polypoints) >= 3
    +
    +    @error("Not implemented yet for method $(method).")
    +end
    +Base.@propagate_inbounds barycentric_coordinates!(λs::Vector{<: Real}, polypoints::AbstractVector{<: Point{N1, T1}}, point::Point{N2, T2}) where {N1, N2, T1 <: Real, T2 <: Real} = barycentric_coordinates!(λs, MeanValue(), polypoints, point)

    This is the GeoInterface-compatible method.

    julia
    """
    +    barycentric_coordinates!(λs::Vector{<: Real}, method::AbstractBarycentricCoordinateMethod, polygon, point)
    +
    +Loads the barycentric coordinates of `point` in `polygon` into `λs` using the barycentric coordinate method `method`.
    +
    +`λs` must be of the length of the polygon plus its holes.
    +
    +!!! tip
    +    Use this method to avoid excess allocations when you need to calculate barycentric coordinates for many points.
    +"""
    +Base.@propagate_inbounds function barycentric_coordinates!(λs::Vector{<: Real}, method::AbstractBarycentricCoordinateMethod, polygon, point)
    +    @assert GeoInterface.trait(polygon) isa GeoInterface.PolygonTrait
    +    @assert GeoInterface.trait(point) isa GeoInterface.PointTrait
    +    passable_polygon = GeoInterface.convert(GeometryBasics, polygon)
    +    @assert passable_polygon isa GeometryBasics.Polygon "The polygon was converted to a $(typeof(passable_polygon)), which is not a `GeometryBasics.Polygon`."
    +    passable_point = GeoInterface.convert(GeometryBasics, point)
    +    return barycentric_coordinates!(λs, method, passable_polygon, Point2(passable_point))
    +end
    +
    +Base.@propagate_inbounds function barycentric_coordinates(method::AbstractBarycentricCoordinateMethod, polypoints::AbstractVector{<: Point{N1, T1}}, point::Point{N2, T2}) where {N1, N2, T1 <: Real, T2 <: Real}
    +    λs = zeros(promote_type(T1, T2), length(polypoints))
    +    barycentric_coordinates!(λs, method, polypoints, point)
    +    return λs
    +end
    +Base.@propagate_inbounds barycentric_coordinates(polypoints::AbstractVector{<: Point{N1, T1}}, point::Point{N2, T2}) where {N1, N2, T1 <: Real, T2 <: Real} = barycentric_coordinates(MeanValue(), polypoints, point)

    This is the GeoInterface-compatible method.

    julia
    """
    +    barycentric_coordinates(method = MeanValue(), polygon, point)
    +
    +Returns the barycentric coordinates of `point` in `polygon` using the barycentric coordinate method `method`.
    +"""
    +Base.@propagate_inbounds function barycentric_coordinates(method::AbstractBarycentricCoordinateMethod, polygon, point)
    +    @assert GeoInterface.trait(polygon) isa GeoInterface.PolygonTrait
    +    @assert GeoInterface.trait(point) isa GeoInterface.PointTrait
    +    passable_polygon = GeoInterface.convert(GeometryBasics, polygon)
    +    @assert passable_polygon isa GeometryBasics.Polygon "The polygon was converted to a $(typeof(passable_polygon)), which is not a `GeometryBasics.Polygon`."
    +    passable_point = GeoInterface.convert(GeometryBasics, point)
    +    return barycentric_coordinates(method, passable_polygon, Point2(passable_point))
    +end
    +
    +Base.@propagate_inbounds function barycentric_interpolate(method::AbstractBarycentricCoordinateMethod, polypoints::AbstractVector{<: Point{N, T1}}, values::AbstractVector{V}, point::Point{N, T2}) where {N, T1 <: Real, T2 <: Real, V}
    +    @boundscheck @assert length(values) == length(polypoints)
    +    @boundscheck @assert length(polypoints) >= 3
    +    λs = barycentric_coordinates(method, polypoints, point)
    +    return sum(λs .* values)
    +end
    +Base.@propagate_inbounds barycentric_interpolate(polypoints::AbstractVector{<: Point{N, T1}}, values::AbstractVector{V}, point::Point{N, T2}) where {N, T1 <: Real, T2 <: Real, V} = barycentric_interpolate(MeanValue(), polypoints, values, point)
    +
    +Base.@propagate_inbounds function barycentric_interpolate(method::AbstractBarycentricCoordinateMethod, exterior::AbstractVector{<: Point{N, T1}}, interiors::AbstractVector{<: Point{N, T1}}, values::AbstractVector{V}, point::Point{N, T2}) where {N, T1 <: Real, T2 <: Real, V}
    +    @boundscheck @assert length(values) == length(exterior) + isempty(interiors) ? 0 : sum(length.(interiors))
    +    @boundscheck @assert length(exterior) >= 3
    +    λs = barycentric_coordinates(method, exterior, interiors, point)
    +    return sum(λs .* values)
    +end
    +Base.@propagate_inbounds barycentric_interpolate(exterior::AbstractVector{<: Point{N, T1}}, interiors::AbstractVector{<: Point{N, T1}}, values::AbstractVector{V}, point::Point{N, T2}) where {N, T1 <: Real, T2 <: Real, V} = barycentric_interpolate(MeanValue(), exterior, interiors, values, point)
    +
    +Base.@propagate_inbounds function barycentric_interpolate(method::AbstractBarycentricCoordinateMethod, polygon::Polygon{2, T1}, values::AbstractVector{V}, point::Point{2, T2}) where {T1 <: Real, T2 <: Real, V}
    +    exterior = decompose(Point{2, promote_type(T1, T2)}, polygon.exterior)
    +    if isempty(polygon.interiors)
    +        @boundscheck @assert length(values) == length(exterior)
    +        return barycentric_interpolate(method, exterior, values, point)
    +    else # the poly has interiors
    +        interiors = reverse.(decompose.((Point{2, promote_type(T1, T2)},), polygon.interiors))
    +        @boundscheck @assert length(values) == length(exterior) + sum(length.(interiors))
    +        return barycentric_interpolate(method, exterior, interiors, values, point)
    +    end
    +end
    +Base.@propagate_inbounds barycentric_interpolate(polygon::Polygon{2, T1}, values::AbstractVector{V}, point::Point{2, T2}) where {T1 <: Real, T2 <: Real, V} = barycentric_interpolate(MeanValue(), polygon, values, point)

    3D polygons are considered to have their vertices in the XY plane, and the Z coordinate must represent some value. This is to say that the Z coordinate is interpreted as an M coordinate.

    julia
    Base.@propagate_inbounds function barycentric_interpolate(method::AbstractBarycentricCoordinateMethod, polygon::Polygon{3, T1}, point::Point{2, T2}) where {T1 <: Real, T2 <: Real}
    +    exterior_point3s = decompose(Point{3, promote_type(T1, T2)}, polygon.exterior)
    +    exterior_values = getindex.(exterior_point3s, 3)
    +    exterior_points = Point2f.(exterior_point3s)
    +    if isempty(polygon.interiors)
    +        return barycentric_interpolate(method, exterior_points, exterior_values, point)
    +    else # the poly has interiors
    +        interior_point3s = decompose.((Point{3, promote_type(T1, T2)},), polygon.interiors)
    +        interior_values = collect(Iterators.flatten((getindex.(point3s, 3) for point3s in interior_point3s)))
    +        interior_points = map(point3s -> Point2f.(point3s), interior_point3s)
    +        return barycentric_interpolate(method, exterior_points, interior_points, vcat(exterior_values, interior_values), point)
    +    end
    +end
    +Base.@propagate_inbounds barycentric_interpolate(polygon::Polygon{3, T1}, point::Point{2, T2}) where {T1 <: Real, T2 <: Real} = barycentric_interpolate(MeanValue(), polygon, point)

    This method is the one which supports GeoInterface.

    julia
    """
    +    barycentric_interpolate(method = MeanValue(), polygon, values::AbstractVector{V}, point)
    +
    +Returns the interpolated value at `point` within `polygon` using the barycentric coordinate method `method`.
    +`values` are the per-point values for the polygon which are to be interpolated.
    +
    +Returns an object of type `V`.
    +
    +!!! warning
    +    Barycentric interpolation is currently defined only for 2-dimensional polygons.
    +    If you pass a 3-D polygon in, the Z coordinate will be used as per-vertex value to be interpolated
    +    (the M coordinate in GIS parlance).
    +"""
    +Base.@propagate_inbounds function barycentric_interpolate(method::AbstractBarycentricCoordinateMethod, polygon, values::AbstractVector{V}, point) where V
    +    @assert GeoInterface.trait(polygon) isa GeoInterface.PolygonTrait
    +    @assert GeoInterface.trait(point) isa GeoInterface.PointTrait
    +    passable_polygon = GeoInterface.convert(GeometryBasics, polygon)
    +    @assert passable_polygon isa GeometryBasics.Polygon "The polygon was converted to a $(typeof(passable_polygon)), which is not a `GeometryBasics.Polygon`."
    +    # first_poly_point = GeoInterface.getpoint(GeoInterface.getexterior(polygon))
    +    passable_point = GeoInterface.convert(GeometryBasics, point)
    +    return barycentric_interpolate(method, passable_polygon, Point2(passable_point))
    +end
    +Base.@propagate_inbounds barycentric_interpolate(polygon, values::AbstractVector{V}, point) where V = barycentric_interpolate(MeanValue(), polygon, values, point)
    +
    +"""
    +    weighted_mean(weight::Real, x1, x2)
    +
    +Returns the weighted mean of `x1` and `x2`, where `weight` is the weight of `x1`.
    +
    +Specifically, calculates `x1 * weight + x2 * (1 - weight)`.
    +
    +!!! note
    +    The idea for this method is that you can override this for custom types, like Color types, in extension modules.
    +"""
    +function weighted_mean(weight::WT, x1, x2) where {WT <: Real}
    +    return muladd(x1, weight, x2 * (oneunit(WT) - weight))
    +end
    +
    +
    +"""
    +    MeanValue() <: AbstractBarycentricCoordinateMethod
    +
    +This method calculates barycentric coordinates using the mean value method.
    +
    +# References
    +
    +"""
    +struct MeanValue <: AbstractBarycentricCoordinateMethod
    +end

    Before we go to the actual implementation, there are some quick and simple utility functions that we need to implement. These are mainly for convenience and code brevity.

    julia
    """
    +    _det(s1::Point2{T1}, s2::Point2{T2}) where {T1 <: Real, T2 <: Real}
    +
    +Returns the determinant of the matrix formed by `hcat`'ing two points `s1` and `s2`.
    +
    +Specifically, this is:
    +```julia
    +s1[1] * s2[2] - s1[2] * s2[1]
    +```
    +"""
    +function _det(s1::_VecTypes{2, T1}, s2::_VecTypes{2, T2}) where {T1 <: Real, T2 <: Real}
    +    return s1[1] * s2[2] - s1[2] * s2[1]
    +end
    +
    +"""
    +    t_value(sᵢ, sᵢ₊₁, rᵢ, rᵢ₊₁)
    +
    +Returns the "T-value" as described in Hormann's presentation [^HormannPresentation] on how to calculate
    +the mean-value coordinate.
    +
    +Here, `sᵢ` is the vector from vertex `vᵢ` to the point, and `rᵢ` is the norm (length) of `sᵢ`.
    +`s` must be `Point` and `r` must be real numbers.
    +
    +```math
    +tᵢ = \\frac{\\mathrm{det}\\left(sᵢ, sᵢ₊₁\\right)}{rᵢ * rᵢ₊₁ + sᵢ ⋅ sᵢ₊₁}
    +```
    +
    +[^HormannPresentation]: K. Hormann and N. Sukumar. Generalized Barycentric Coordinates in Computer Graphics and Computational Mechanics. Taylor & Fancis, CRC Press, 2017.
    +```
    +
    +"""
    +function t_value(sᵢ::_VecTypes{N, T1}, sᵢ₊₁::_VecTypes{N, T1}, rᵢ::T2, rᵢ₊₁::T2) where {N, T1 <: Real, T2 <: Real}
    +    return _det(sᵢ, sᵢ₊₁) / muladd(rᵢ, rᵢ₊₁, dot(sᵢ, sᵢ₊₁))
    +end
    +
    +
    +function barycentric_coordinates!(λs::Vector{<: Real}, ::MeanValue, polypoints::AbstractVector{<: Point{2, T1}}, point::Point{2, T2}) where {T1 <: Real, T2 <: Real}
    +    @boundscheck @assert length(λs) == length(polypoints)
    +    @boundscheck @assert length(polypoints) >= 3
    +    n_points = length(polypoints)
    +    # Initialize counters and register variables
    +    # Points - these are actually vectors from point to vertices
    +    #  polypoints[i-1], polypoints[i], polypoints[i+1]
    +    sᵢ₋₁ = polypoints[end] - point
    +    sᵢ   = polypoints[begin] - point
    +    sᵢ₊₁ = polypoints[begin+1] - point
    +    # radius / Euclidean distance between points.
    +    rᵢ₋₁ = norm(sᵢ₋₁)
    +    rᵢ   = norm(sᵢ  )
    +    rᵢ₊₁ = norm(sᵢ₊₁)
    +    # Perform the first computation explicitly, so we can cut down on
    +    # a mod in the loop.
    +    λs[1] = (t_value(sᵢ₋₁, sᵢ, rᵢ₋₁, rᵢ) + t_value(sᵢ, sᵢ₊₁, rᵢ, rᵢ₊₁)) / rᵢ
    +    # Loop through the rest of the vertices, compute, store in λs
    +    for i in 2:n_points
    +        # Increment counters + set variables
    +        sᵢ₋₁ = sᵢ
    +        sᵢ   = sᵢ₊₁
    +        sᵢ₊₁ = polypoints[mod1(i+1, n_points)] - point
    +        rᵢ₋₁ = rᵢ
    +        rᵢ   = rᵢ₊₁
    +        rᵢ₊₁ = norm(sᵢ₊₁) # radius / Euclidean distance between points.
    +        λs[i] = (t_value(sᵢ₋₁, sᵢ, rᵢ₋₁, rᵢ) + t_value(sᵢ, sᵢ₊₁, rᵢ, rᵢ₊₁)) / rᵢ
    +    end
    +    # Normalize λs to the 1-norm (sum=1)
    +    λs ./= sum(λs)
    +    return λs
    +end
    julia
    function barycentric_coordinates(::MeanValue, polypoints::NTuple{N, Point{2, T2}}, point::Point{2, T1},) where {N, T1, T2}
    +    ## Initialize counters and register variables
    +    ## Points - these are actually vectors from point to vertices
    +    ##  polypoints[i-1], polypoints[i], polypoints[i+1]
    +    sᵢ₋₁ = polypoints[end] - point
    +    sᵢ   = polypoints[begin] - point
    +    sᵢ₊₁ = polypoints[begin+1] - point
    +    ## radius / Euclidean distance between points.
    +    rᵢ₋₁ = norm(sᵢ₋₁)
    +    rᵢ   = norm(sᵢ  )
    +    rᵢ₊₁ = norm(sᵢ₊₁)
    +    λ₁ = (t_value(sᵢ₋₁, sᵢ, rᵢ₋₁, rᵢ) + t_value(sᵢ, sᵢ₊₁, rᵢ, rᵢ₊₁)) / rᵢ
    +    λs = ntuple(N) do i
    +        if i == 1
    +            return λ₁
    +        end
    +        ## Increment counters + set variables
    +        sᵢ₋₁ = sᵢ
    +        sᵢ   = sᵢ₊₁
    +        sᵢ₊₁ = polypoints[mod1(i+1, N)] - point
    +        rᵢ₋₁ = rᵢ
    +        rᵢ   = rᵢ₊₁
    +        rᵢ₊₁ = norm(sᵢ₊₁) # radius / Euclidean distance between points.
    +        return (t_value(sᵢ₋₁, sᵢ, rᵢ₋₁, rᵢ) + t_value(sᵢ, sᵢ₊₁, rᵢ, rᵢ₊₁)) / rᵢ
    +    end
    +
    +    ∑λ = sum(λs)
    +
    +    return ntuple(N) do i
    +        λs[i] / ∑λ
    +    end
    +end

    This performs an inplace accumulation, using less memory and is faster. That's particularly good if you are using a polygon with a large number of points...

    julia
    function barycentric_interpolate(::MeanValue, polypoints::AbstractVector{<: Point{2, T1}}, values::AbstractVector{V}, point::Point{2, T2}) where {T1 <: Real, T2 <: Real, V}
    +    @boundscheck @assert length(values) == length(polypoints)
    +    @boundscheck @assert length(polypoints) >= 3
    +
    +    n_points = length(polypoints)
    +    # Initialize counters and register variables
    +    # Points - these are actually vectors from point to vertices
    +    #  polypoints[i-1], polypoints[i], polypoints[i+1]
    +    sᵢ₋₁ = polypoints[end] - point
    +    sᵢ   = polypoints[begin] - point
    +    sᵢ₊₁ = polypoints[begin+1] - point
    +    # radius / Euclidean distance between points.
    +    rᵢ₋₁ = norm(sᵢ₋₁)
    +    rᵢ   = norm(sᵢ  )
    +    rᵢ₊₁ = norm(sᵢ₊₁)
    +    # Now, we set the interpolated value to the first point's value, multiplied
    +    # by the weight computed relative to the first point in the polygon.
    +    wᵢ = (t_value(sᵢ₋₁, sᵢ, rᵢ₋₁, rᵢ) + t_value(sᵢ, sᵢ₊₁, rᵢ, rᵢ₊₁)) / rᵢ
    +    wₜₒₜ = wᵢ
    +    interpolated_value = values[begin] * wᵢ
    +    for i in 2:n_points
    +        # Increment counters + set variables
    +        sᵢ₋₁ = sᵢ
    +        sᵢ   = sᵢ₊₁
    +        sᵢ₊₁ = polypoints[mod1(i+1, n_points)] - point
    +        rᵢ₋₁ = rᵢ
    +        rᵢ   = rᵢ₊₁
    +        rᵢ₊₁ = norm(sᵢ₊₁)
    +        # Now, we calculate the weight:
    +        wᵢ = (t_value(sᵢ₋₁, sᵢ, rᵢ₋₁, rᵢ) + t_value(sᵢ, sᵢ₊₁, rᵢ, rᵢ₊₁)) / rᵢ
    +        # perform a weighted sum with the interpolated value:
    +        interpolated_value += values[i] * wᵢ
    +        # and add the weight to the total weight accumulator.
    +        wₜₒₜ += wᵢ
    +    end
    +    # Return the normalized interpolated value.
    +    return interpolated_value / wₜₒₜ
    +end

    When you have holes, then you have to be careful about the order you iterate around points.

    Specifically, you have to iterate around each linear ring separately and ensure there are no degenerate/repeated points at the start and end!

    julia
    function barycentric_interpolate(::MeanValue, exterior::AbstractVector{<: Point{N, T1}}, interiors::AbstractVector{<: AbstractVector{<: Point{N, T1}}}, values::AbstractVector{V}, point::Point{N, T2}) where {N, T1 <: Real, T2 <: Real, V}
    +    # @boundscheck @assert length(values) == (length(exterior) + isempty(interiors) ? 0 : sum(length.(interiors)))
    +    # @boundscheck @assert length(exterior) >= 3
    +
    +    current_index = 1
    +    l_exterior = length(exterior)
    +
    +    sᵢ₋₁ = exterior[end] - point
    +    sᵢ   = exterior[begin] - point
    +    sᵢ₊₁ = exterior[begin+1] - point
    +    rᵢ₋₁ = norm(sᵢ₋₁) # radius / Euclidean distance between points.
    +    rᵢ   = norm(sᵢ  ) # radius / Euclidean distance between points.
    +    rᵢ₊₁ = norm(sᵢ₊₁) # radius / Euclidean distance between points.

    Now, we set the interpolated value to the first point's value, multiplied by the weight computed relative to the first point in the polygon.

    julia
        wᵢ = (t_value(sᵢ₋₁, sᵢ, rᵢ₋₁, rᵢ) + t_value(sᵢ, sᵢ₊₁, rᵢ, rᵢ₊₁)) / rᵢ
    +    wₜₒₜ = wᵢ
    +    interpolated_value = values[begin] * wᵢ
    +
    +    for i in 2:l_exterior

    Increment counters + set variables

    julia
            sᵢ₋₁ = sᵢ
    +        sᵢ   = sᵢ₊₁
    +        sᵢ₊₁ = exterior[mod1(i+1, l_exterior)] - point
    +        rᵢ₋₁ = rᵢ
    +        rᵢ   = rᵢ₊₁
    +        rᵢ₊₁ = norm(sᵢ₊₁) # radius / Euclidean distance between points.
    +        wᵢ = (t_value(sᵢ₋₁, sᵢ, rᵢ₋₁, rᵢ) + t_value(sᵢ, sᵢ₊₁, rᵢ, rᵢ₊₁)) / rᵢ

    Updates - first the interpolated value,

    julia
            interpolated_value += values[current_index] * wᵢ

    then the accumulators for total weight and current index.

    julia
            wₜₒₜ += wᵢ
    +        current_index += 1
    +
    +    end
    +    for hole in interiors
    +        l_hole = length(hole)
    +        sᵢ₋₁ = hole[end] - point
    +        sᵢ   = hole[begin] - point
    +        sᵢ₊₁ = hole[begin+1] - point
    +        rᵢ₋₁ = norm(sᵢ₋₁) # radius / Euclidean distance between points.
    +        rᵢ   = norm(sᵢ  ) # radius / Euclidean distance between points.
    +        rᵢ₊₁ = norm(sᵢ₊₁) # radius / Euclidean distance between points.
    +        # Now, we set the interpolated value to the first point's value, multiplied
    +        # by the weight computed relative to the first point in the polygon.
    +        wᵢ = (t_value(sᵢ₋₁, sᵢ, rᵢ₋₁, rᵢ) + t_value(sᵢ, sᵢ₊₁, rᵢ, rᵢ₊₁)) / rᵢ
    +
    +        interpolated_value += values[current_index] * wᵢ
    +
    +        wₜₒₜ += wᵢ
    +        current_index += 1
    +
    +        for i in 2:l_hole
    +            # Increment counters + set variables
    +            sᵢ₋₁ = sᵢ
    +            sᵢ   = sᵢ₊₁
    +            sᵢ₊₁ = hole[mod1(i+1, l_hole)] - point
    +            rᵢ₋₁ = rᵢ
    +            rᵢ   = rᵢ₊₁
    +            rᵢ₊₁ = norm(sᵢ₊₁) ## radius / Euclidean distance between points.
    +            wᵢ = (t_value(sᵢ₋₁, sᵢ, rᵢ₋₁, rᵢ) + t_value(sᵢ, sᵢ₊₁, rᵢ, rᵢ₊₁)) / rᵢ
    +            interpolated_value += values[current_index] * wᵢ
    +            wₜₒₜ += wᵢ
    +            current_index += 1
    +        end
    +    end
    +    return interpolated_value / wₜₒₜ
    +
    +end
    +
    +struct Wachspress <: AbstractBarycentricCoordinateMethod
    +end

    This page was generated using Literate.jl.

    + + + + \ No newline at end of file diff --git a/previews/PR237/source/methods/buffer.html b/previews/PR237/source/methods/buffer.html new file mode 100644 index 000000000..81f95b32e --- /dev/null +++ b/previews/PR237/source/methods/buffer.html @@ -0,0 +1,35 @@ + + + + + + Buffer | GeometryOps.jl + + + + + + + + + + + + + + +
    Skip to content

    Buffer

    Buffering a geometry means computing the region distance away from it, and returning that region as the new geometry.

    As of now, we only support GEOS as the backend, meaning that LibGEOS must be loaded.

    julia
    function buffer(geometry, distance; kwargs...)
    +    buffered = buffer(GEOS(; kwargs...), geometry, distance)
    +    return tuples(buffered)
    +end

    Below is an error handler similar to the others we have for e.g. segmentize, which checks if there is a method error for the geos backend.

    Add an error hint for buffer if LibGEOS is not loaded!

    julia
    function _buffer_error_hinter(io, exc, argtypes, kwargs)
    +    if isnothing(Base.get_extension(GeometryOps, :GeometryOpsLibGEOSExt)) && exc.f == buffer && first(argtypes) == GEOS
    +        print(io, "\n\nThe `buffer` method requires the LibGEOS.jl package to be explicitly loaded.\n")
    +        print(io, "You can do this by simply typing ")
    +        printstyled(io, "using LibGEOS"; color = :cyan, bold = true)
    +        println(io, " in your REPL, \nor otherwise loading LibGEOS.jl via using or import.")
    +    end
    +end

    This page was generated using Literate.jl.

    + + + + \ No newline at end of file diff --git a/previews/PR237/source/methods/centroid.html b/previews/PR237/source/methods/centroid.html new file mode 100644 index 000000000..dce1d5878 --- /dev/null +++ b/previews/PR237/source/methods/centroid.html @@ -0,0 +1,117 @@ + + + + + + Centroid | GeometryOps.jl + + + + + + + + + + + + + + +
    Skip to content

    Centroid

    julia
    export centroid, centroid_and_length, centroid_and_area

    What is the centroid?

    The centroid is the geometric center of a line string or area(s). Note that the centroid does not need to be inside of a concave area.

    Further note that by convention a line, or linear ring, is calculated by weighting the line segments by their length, while polygons and multipolygon centroids are calculated by weighting edge's by their 'area components'.

    To provide an example, consider this concave polygon in the shape of a 'C':

    julia
    import GeometryOps as GO
    +import GeoInterface as GI
    +using Makie
    +using CairoMakie
    +
    +cshape = GI.Polygon([[(0,0), (0,3), (3,3), (3,2), (1,2), (1,1), (3,1), (3,0), (0,0)]])
    +f, a, p = poly(collect(GI.getpoint(cshape)); axis = (; aspect = DataAspect()))

    Let's see what the centroid looks like (plotted in red):

    julia
    cent = GO.centroid(cshape)
    +scatter!(GI.x(cent), GI.y(cent), color = :red)
    +f

    Implementation

    This is the GeoInterface-compatible implementation.

    First, we implement a wrapper method that dispatches to the correct implementation based on the geometry trait. This is also used in the implementation, since it's a lot less work!

    Note that if you call centroid on a LineString or LinearRing, the centroid_and_length function will be called due to the weighting scheme described above, while centroid_and_area is called for polygons and multipolygons. However, centroid_and_area can still be called on a LineString or LinearRing when they are closed, for example as the interior hole of a polygon.

    The helper functions centroid_and_length and centroid_and_area are made available just in case the user also needs the area or length to decrease repeat computation.

    julia
    """
    +    centroid(geom, [T=Float64])::Tuple{T, T}
    +
    +Returns the centroid of a given line segment, linear ring, polygon, or
    +mutlipolygon.
    +"""
    +centroid(geom, ::Type{T} = Float64; threaded=false) where T =
    +    centroid(GI.trait(geom), geom, T; threaded)
    +function centroid(
    +    trait::Union{GI.LineStringTrait, GI.LinearRingTrait}, geom, ::Type{T}=Float64; threaded=false
    +) where T
    +    centroid_and_length(trait, geom, T)[1]
    +end
    +centroid(trait, geom, ::Type{T}; threaded=false) where T =
    +    centroid_and_area(geom, T; threaded)[1]
    +
    +"""
    +    centroid_and_length(geom, [T=Float64])::(::Tuple{T, T}, ::Real)
    +
    +Returns the centroid and length of a given line/ring. Note this is only valid
    +for line strings and linear rings.
    +"""
    +centroid_and_length(geom, ::Type{T}=Float64) where T =
    +    centroid_and_length(GI.trait(geom), geom, T)
    +function centroid_and_length(
    +    ::Union{GI.LineStringTrait, GI.LinearRingTrait}, geom, ::Type{T},
    +) where T

    Initialize starting values

    julia
        xcentroid = T(0)
    +    ycentroid = T(0)
    +    length = T(0)
    +    point₁ = GI.getpoint(geom, 1)

    Loop over line segments of line string

    julia
        for point₂ in GI.getpoint(geom)

    Calculate length of line segment

    julia
            length_component = sqrt(
    +            (GI.x(point₂) - GI.x(point₁))^2 +
    +            (GI.y(point₂) - GI.y(point₁))^2
    +        )

    Accumulate the line segment length into length

    julia
            length += length_component

    Weighted average of line segment centroids

    julia
            xcentroid += (GI.x(point₁) + GI.x(point₂)) * (length_component / 2)
    +        ycentroid += (GI.y(point₁) + GI.y(point₂)) * (length_component / 2)
    +        #centroid = centroid .+ ((point₁ .+ point₂) .* (length_component / 2))

    Advance the point buffer by 1 point to move to next line segment

    julia
            point₁ = point₂
    +    end
    +    xcentroid /= length
    +    ycentroid /= length
    +    return (xcentroid, ycentroid), length
    +end
    +
    +"""
    +    centroid_and_area(geom, [T=Float64])::(::Tuple{T, T}, ::Real)
    +
    +Returns the centroid and area of a given geometry.
    +"""
    +function centroid_and_area(geom, ::Type{T}=Float64; threaded=false) where T
    +    target = TraitTarget{Union{GI.PolygonTrait,GI.LineStringTrait,GI.LinearRingTrait}}()
    +    init = (zero(T), zero(T)), zero(T)
    +    applyreduce(_combine_centroid_and_area, target, geom; threaded, init) do g
    +        _centroid_and_area(GI.trait(g), g, T)
    +    end
    +end
    +
    +function _centroid_and_area(
    +    ::Union{GI.LineStringTrait, GI.LinearRingTrait}, geom, ::Type{T}
    +) where T

    Check that the geometry is closed

    julia
        @assert(
    +        GI.getpoint(geom, 1) == GI.getpoint(geom, GI.ngeom(geom)),
    +        "centroid_and_area should only be used with closed geometries"
    +    )

    Initialize starting values

    julia
        xcentroid = T(0)
    +    ycentroid = T(0)
    +    area = T(0)
    +    point₁ = GI.getpoint(geom, 1)

    Loop over line segments of linear ring

    julia
        for point₂ in GI.getpoint(geom)
    +        area_component = GI.x(point₁) * GI.y(point₂) -
    +            GI.x(point₂) * GI.y(point₁)

    Accumulate the area component into area

    julia
            area += area_component

    Weighted average of centroid components

    julia
            xcentroid += (GI.x(point₁) + GI.x(point₂)) * area_component
    +        ycentroid += (GI.y(point₁) + GI.y(point₂)) * area_component

    Advance the point buffer by 1 point

    julia
            point₁ = point₂
    +    end
    +    area /= 2
    +    xcentroid /= 6area
    +    ycentroid /= 6area
    +    return (xcentroid, ycentroid), abs(area)
    +end
    +function _centroid_and_area(::GI.PolygonTrait, geom, ::Type{T}) where T

    Exterior ring's centroid and area

    julia
        (xcentroid, ycentroid), area = centroid_and_area(GI.getexterior(geom), T)

    Weight exterior centroid by area

    julia
        xcentroid *= area
    +    ycentroid *= area

    Loop over any holes within the polygon

    julia
        for hole in GI.gethole(geom)

    Hole polygon's centroid and area

    julia
            (xinterior, yinterior), interior_area = centroid_and_area(hole, T)

    Accumulate the area component into area

    julia
            area -= interior_area

    Weighted average of centroid components

    julia
            xcentroid -= xinterior * interior_area
    +        ycentroid -= yinterior * interior_area
    +    end
    +    xcentroid /= area
    +    ycentroid /= area
    +    return (xcentroid, ycentroid), area
    +end

    The op argument for _applyreduce and point / area It combines two (point, area) tuples into one, taking the average of the centroid points weighted by the area of the geom they are from.

    julia
    function _combine_centroid_and_area(((x1, y1), area1), ((x2, y2), area2))
    +    area = area1 + area2
    +    x = (x1 * area1 + x2 * area2) / area
    +    y = (y1 * area1 + y2 * area2) / area
    +    return (x, y), area
    +end

    This page was generated using Literate.jl.

    + + + + \ No newline at end of file diff --git a/previews/PR237/source/methods/clipping/clipping_processor.html b/previews/PR237/source/methods/clipping/clipping_processor.html new file mode 100644 index 000000000..e744ab614 --- /dev/null +++ b/previews/PR237/source/methods/clipping/clipping_processor.html @@ -0,0 +1,532 @@ + + + + + + Polygon clipping helpers | GeometryOps.jl + + + + + + + + + + + + + + +
    Skip to content

    Polygon clipping helpers

    This file contains the shared helper functions for the polygon clipping functionalities.

    This enum defines which side of an edge a point is on

    julia
    @enum PointEdgeSide left=1 right=2 unknown=3

    Constants assigned for readability

    julia
    const enter, exit = true, false
    +const crossing, bouncing = true, false
    +
    +#= A point can either be the start or end of an overlapping chain of points between two
    +polygons, or not an endpoint of a chain. =#
    +@enum EndPointType start_chain=1 end_chain=2 not_endpoint=3
    +
    +#= This is the struct that makes up a_list and b_list. Many values are only used if point is
    +an intersection point (ipt). =#
    +@kwdef struct PolyNode{T <: AbstractFloat}
    +    point::Tuple{T,T}          # (x, y) values of given point
    +    inter::Bool = false        # If ipt, true, else 0
    +    neighbor::Int = 0          # If ipt, index of equivalent point in a_list or b_list, else 0
    +    idx::Int = 0               # If crossing point, index within sorted a_idx_list
    +    ent_exit::Bool = false     # If ipt, true if enter and false if exit, else false
    +    crossing::Bool = false     # If ipt, true if intersection crosses from out/in polygon, else false
    +    endpoint::EndPointType = not_endpoint # If ipt, denotes if point is the start or end of an overlapping chain
    +    fracs::Tuple{T,T} = (0., 0.) # If ipt, fractions along edges to ipt (a_frac, b_frac), else (0, 0)
    +end
    +
    +#= Create a new node with all of the same field values as the given PolyNode unless
    +alternative values are provided, in which case those should be used. =#
    +PolyNode(node::PolyNode{T};
    +    point = node.point, inter = node.inter, neighbor = node.neighbor, idx = node.idx,
    +    ent_exit = node.ent_exit, crossing = node.crossing, endpoint = node.endpoint,
    +    fracs = node.fracs,
    +) where T = PolyNode{T}(;
    +    point = point, inter = inter, neighbor = neighbor, idx = idx, ent_exit = ent_exit,
    +    crossing = crossing, endpoint = endpoint, fracs = fracs)

    Checks equality of two PolyNodes by backing point value, fractional value, and intersection status

    julia
    equals(pn1::PolyNode, pn2::PolyNode) = pn1.point == pn2.point && pn1.inter == pn2.inter && pn1.fracs == pn2.fracs
    _build_ab_list(::Type{T}, poly_a, poly_b, delay_cross_f, delay_bounce_f; exact) ->
    +    (a_list, b_list, a_idx_list)

    This function takes in two polygon rings and calls '_build_a_list', '_build_b_list', and '_flag_ent_exit' in order to fully form a_list and b_list. The 'a_list' and 'b_list' that it returns are the fully updated vectors of PolyNodes that represent the rings 'poly_a' and 'poly_b', respectively. This function also returns 'a_idx_list', which at its "ith" index stores the index in 'a_list' at which the "ith" intersection point lies.

    julia
    function _build_ab_list(::Type{T}, poly_a, poly_b, delay_cross_f::F1, delay_bounce_f::F2; exact) where {T, F1, F2}

    Make a list for nodes of each polygon

    julia
        a_list, a_idx_list, n_b_intrs = _build_a_list(T, poly_a, poly_b; exact)
    +    b_list = _build_b_list(T, a_idx_list, a_list, n_b_intrs, poly_b)

    Flag crossings

    julia
        _classify_crossing!(T, a_list, b_list; exact)

    Flag the entry and exits

    julia
        _flag_ent_exit!(T, GI.LinearRingTrait(), poly_b, a_list, delay_cross_f, Base.Fix2(delay_bounce_f, true); exact)
    +    _flag_ent_exit!(T, GI.LinearRingTrait(), poly_a, b_list, delay_cross_f, Base.Fix2(delay_bounce_f, false); exact)

    Set node indices and filter a_idx_list to just crossing points

    julia
        _index_crossing_intrs!(a_list, b_list, a_idx_list)
    +
    +    return a_list, b_list, a_idx_list
    +end
    _build_a_list(::Type{T}, poly_a, poly_b) -> (a_list, a_idx_list)

    This function take in two polygon rings and creates a vector of PolyNodes to represent poly_a, including its intersection points with poly_b. The information stored in each PolyNode is needed for clipping using the Greiner-Hormann clipping algorithm.

    Note: After calling this function, a_list is not fully formed because the neighboring indices of the intersection points in b_list still need to be updated. Also we still have not update the entry and exit flags for a_list.

    The a_idx_list is a list of the indices of intersection points in a_list. The value at index i of a_idx_list is the location in a_list where the ith intersection point lies.

    julia
    function _build_a_list(::Type{T}, poly_a, poly_b; exact) where T
    +    n_a_edges = _nedge(poly_a)
    +    a_list = PolyNode{T}[]  # list of points in poly_a
    +    sizehint!(a_list, n_a_edges)
    +    a_idx_list = Vector{Int}()  # finds indices of intersection points in a_list
    +    a_count = 0  # number of points added to a_list
    +    n_b_intrs = 0

    Loop through points of poly_a

    julia
        local a_pt1
    +    for (i, a_p2) in enumerate(GI.getpoint(poly_a))
    +        a_pt2 = (T(GI.x(a_p2)), T(GI.y(a_p2)))
    +        if i <= 1 || (a_pt1 == a_pt2)  # don't repeat points
    +            a_pt1 = a_pt2
    +            continue
    +        end

    Add the first point of the edge to the list of points in a_list

    julia
            new_point = PolyNode{T}(;point = a_pt1)
    +        a_count += 1
    +        push!(a_list, new_point)

    Find intersections with edges of poly_b

    julia
            local b_pt1
    +        prev_counter = a_count
    +        for (j, b_p2) in enumerate(GI.getpoint(poly_b))
    +            b_pt2 = _tuple_point(b_p2, T)
    +            if j <= 1 || (b_pt1 == b_pt2)  # don't repeat points
    +                b_pt1 = b_pt2
    +                continue
    +            end

    Determine if edges intersect and how they intersect

    julia
                line_orient, intr1, intr2 = _intersection_point(T, (a_pt1, a_pt2), (b_pt1, b_pt2); exact)
    +            if line_orient != line_out  # edges intersect
    +                if line_orient == line_cross  # Intersection point that isn't a vertex
    +                    int_pt, fracs = intr1
    +                    new_intr = PolyNode{T}(;
    +                        point = int_pt, inter = true, neighbor = j - 1,
    +                        crossing = true, fracs = fracs,
    +                    )
    +                    a_count += 1
    +                    n_b_intrs += 1
    +                    push!(a_list, new_intr)
    +                    push!(a_idx_list, a_count)
    +                else
    +                    (_, (α1, β1)) = intr1

    Determine if a1 or b1 should be added to a_list

    julia
                        add_a1 = α1 == 0 && 0 β1 < 1
    +                    a1_β = add_a1 ? β1 : zero(T)
    +                    add_b1 = β1 == 0 && 0 < α1 < 1
    +                    b1_α = add_b1 ? α1 : zero(T)

    If lines are collinear and overlapping, a second intersection exists

    julia
                        if line_orient == line_over
    +                        (_, (α2, β2)) = intr2
    +                        if α2 == 0 && 0 β2 < 1
    +                            add_a1, a1_β = true, β2
    +                        end
    +                        if β2 == 0 && 0 < α2 < 1
    +                            add_b1, b1_α = true, α2
    +                        end
    +                    end

    Add intersection points determined above

    julia
                        if add_a1
    +                        n_b_intrs += a1_β == 0 ? 0 : 1
    +                        a_list[prev_counter] = PolyNode{T}(;
    +                            point = a_pt1, inter = true, neighbor = j - 1,
    +                            fracs = (zero(T), a1_β),
    +                        )
    +                        push!(a_idx_list, prev_counter)
    +                    end
    +                    if add_b1
    +                        new_intr = PolyNode{T}(;
    +                            point = b_pt1, inter = true, neighbor = j - 1,
    +                            fracs = (b1_α, zero(T)),
    +                        )
    +                        a_count += 1
    +                        push!(a_list, new_intr)
    +                        push!(a_idx_list, a_count)
    +                    end
    +                end
    +            end
    +            b_pt1 = b_pt2
    +        end

    Order intersection points by placement along edge using fracs value

    julia
            if prev_counter < a_count
    +            Δintrs = a_count - prev_counter
    +            inter_points = @view a_list[(a_count - Δintrs + 1):a_count]
    +            sort!(inter_points, by = x -> x.fracs[1])
    +        end
    +        a_pt1 = a_pt2
    +    end
    +    return a_list, a_idx_list, n_b_intrs
    +end
    _build_b_list(::Type{T}, a_idx_list, a_list, poly_b) -> b_list

    This function takes in the a_list and a_idx_list build in _build_a_list and poly_b and creates a vector of PolyNodes to represent poly_b. The information stored in each PolyNode is needed for clipping using the Greiner-Hormann clipping algorithm.

    Note: after calling this function, b_list is not fully updated. The entry/exit flags still need to be updated. However, the neighbor value in a_list is now updated.

    julia
    function _build_b_list(::Type{T}, a_idx_list, a_list, n_b_intrs, poly_b) where T

    Sort intersection points by insertion order in b_list

    julia
        sort!(a_idx_list, by = x-> a_list[x].neighbor + a_list[x].fracs[2])

    Initialize needed values and lists

    julia
        n_b_edges = _nedge(poly_b)
    +    n_intr_pts = length(a_idx_list)
    +    b_list = PolyNode{T}[]
    +    sizehint!(b_list, n_b_edges + n_b_intrs)
    +    intr_curr = 1
    +    b_count = 0

    Loop over points in poly_b and add each point and intersection point

    julia
        local b_pt1
    +    for (i, b_p2) in enumerate(GI.getpoint(poly_b))
    +        b_pt2 = _tuple_point(b_p2, T)
    +        if i  1 || (b_pt1 == b_pt2)  # don't repeat points
    +            b_pt1 = b_pt2
    +            continue
    +        end
    +        b_count += 1
    +        push!(b_list, PolyNode{T}(; point = b_pt1))
    +        if intr_curr  n_intr_pts
    +            curr_idx = a_idx_list[intr_curr]
    +            curr_node = a_list[curr_idx]
    +            prev_counter = b_count
    +            while curr_node.neighbor == i - 1  # Add all intersection points on current edge
    +                b_idx = 0
    +                new_intr = PolyNode(curr_node; neighbor = curr_idx)
    +                if curr_node.fracs[2] == 0  # if curr_node is segment start point

    intersection point is vertex of b

    julia
                        b_idx = prev_counter
    +                    b_list[b_idx] = new_intr
    +                else
    +                    b_count += 1
    +                    b_idx = b_count
    +                    push!(b_list, new_intr)
    +                end
    +                a_list[curr_idx] = PolyNode(curr_node; neighbor = b_idx)
    +                intr_curr += 1
    +                intr_curr > n_intr_pts && break
    +                curr_idx = a_idx_list[intr_curr]
    +                curr_node = a_list[curr_idx]
    +            end
    +        end
    +        b_pt1 = b_pt2
    +    end
    +    sort!(a_idx_list)  # return a_idx_list to order of points in a_list
    +    return b_list
    +end
    _classify_crossing!(T, poly_b, a_list; exact)

    This function marks all intersection points as either bouncing or crossing points. "Delayed" crossing or bouncing intersections (a chain of edges where the central edges overlap and thus only the first and last edge of the chain determine if the chain is bounding or crossing) are marked as follows: the first and the last points are marked as crossing if the chain is crossing and delayed otherwise and all middle points are marked as bouncing. Additionally, the start and end points of the chain are marked as endpoints using the endpoints field.

    julia
    function _classify_crossing!(::Type{T}, a_list, b_list; exact) where T
    +    napts = length(a_list)
    +    nbpts = length(b_list)

    start centered on last point

    julia
        a_prev = a_list[end - 1]
    +    curr_pt = a_list[end]
    +    i = napts

    keep track of unmatched bouncing chains

    julia
        start_chain_edge, start_chain_idx = unknown, 0
    +    unmatched_end_chain_edge, unmatched_end_chain_idx = unknown, 0
    +    same_winding = true

    loop over list points

    julia
        for next_idx in 1:napts
    +        a_next = a_list[next_idx]
    +        if curr_pt.inter && !curr_pt.crossing
    +            j = curr_pt.neighbor
    +            b_prev = j == 1 ? b_list[end] : b_list[j-1]
    +            b_next = j == nbpts ? b_list[1] : b_list[j+1]

    determine if any segments are on top of one another

    julia
                a_prev_is_b_prev = a_prev.inter && equals(a_prev, b_prev)
    +            a_prev_is_b_next = a_prev.inter && equals(a_prev, b_next)
    +            a_next_is_b_prev = a_next.inter && equals(a_next, b_prev)
    +            a_next_is_b_next = a_next.inter && equals(a_next, b_next)

    determine which side of a segments the p points are on

    julia
                b_prev_side, b_next_side = _get_sides(b_prev, b_next, a_prev, curr_pt, a_next,
    +                i, j, a_list, b_list; exact)

    no sides overlap

    julia
                if !a_prev_is_b_prev && !a_prev_is_b_next && !a_next_is_b_prev && !a_next_is_b_next
    +                if b_prev_side != b_next_side  # lines cross
    +                    a_list[i] = PolyNode(curr_pt; crossing = true)
    +                    b_list[j] = PolyNode(b_list[j]; crossing = true)
    +                end

    end of overlapping chain

    julia
                elseif !a_next_is_b_prev && !a_next_is_b_next
    +                b_side = a_prev_is_b_prev ? b_next_side : b_prev_side
    +                if start_chain_edge == unknown  # start loop on overlapping chain
    +                    unmatched_end_chain_edge = b_side
    +                    unmatched_end_chain_idx = i
    +                    same_winding = a_prev_is_b_prev
    +                else  # close overlapping chain

    update end of chain with endpoint and crossing / bouncing tags

    julia
                        crossing = b_side != start_chain_edge
    +                    a_list[i] = PolyNode(curr_pt;
    +                        crossing = crossing,
    +                        endpoint = end_chain,
    +                    )
    +                    b_list[j] = PolyNode(b_list[j];
    +                        crossing = crossing,
    +                        endpoint = same_winding ? end_chain : start_chain,
    +                    )

    update start of chain with endpoint and crossing / bouncing tags

    julia
                        start_pt = a_list[start_chain_idx]
    +                    a_list[start_chain_idx] = PolyNode(start_pt;
    +                        crossing = crossing,
    +                        endpoint = start_chain,
    +                    )
    +                    b_list[start_pt.neighbor] = PolyNode(b_list[start_pt.neighbor];
    +                        crossing = crossing,
    +                        endpoint = same_winding ? start_chain : end_chain,
    +                    )
    +                end

    start of overlapping chain

    julia
                elseif !a_prev_is_b_prev && !a_prev_is_b_next
    +                b_side = a_next_is_b_prev ? b_next_side : b_prev_side
    +                start_chain_edge = b_side
    +                start_chain_idx = i
    +                same_winding = a_next_is_b_next
    +            end
    +        end
    +        a_prev = curr_pt
    +        curr_pt = a_next
    +        i = next_idx
    +    end

    if we started in the middle of overlapping chain, close chain

    julia
        if unmatched_end_chain_edge != unknown
    +        crossing = unmatched_end_chain_edge != start_chain_edge

    update end of chain with endpoint and crossing / bouncing tags

    julia
            end_chain_pt = a_list[unmatched_end_chain_idx]
    +        a_list[unmatched_end_chain_idx] = PolyNode(end_chain_pt;
    +            crossing = crossing,
    +            endpoint = end_chain,
    +        )
    +        b_list[end_chain_pt.neighbor] = PolyNode(b_list[end_chain_pt.neighbor];
    +            crossing = crossing,
    +            endpoint = same_winding ? end_chain : start_chain,
    +        )

    update start of chain with endpoint and crossing / bouncing tags

    julia
            start_pt = a_list[start_chain_idx]
    +        a_list[start_chain_idx] = PolyNode(start_pt;
    +            crossing = crossing,
    +            endpoint = start_chain,
    +        )
    +        b_list[start_pt.neighbor] = PolyNode(b_list[start_pt.neighbor];
    +            crossing = crossing,
    +            endpoint = same_winding ? start_chain : end_chain,
    +        )
    +    end
    +end

    Check if PolyNode is a vertex of original polygon

    julia
    _is_vertex(pt) = !pt.inter || pt.fracs[1] == 0 || pt.fracs[1] == 1 || pt.fracs[2] == 0 || pt.fracs[2] == 1
    +
    +#= Determines which side (right or left) of the segment a_prev-curr_pt-a_next the points
    +b_prev and b_next are on. Given this is only called when curr_pt is an intersection point
    +that wasn't initially classified as crossing, we know that curr_pt is either from a hinge or
    +overlapping intersection and thus is an original vertex of either poly_a or poly_b. Due to
    +floating point error when calculating new intersection points, we only want to use original
    +vertices to determine orientation. Thus, for other points, find nearest point that is a
    +vertex. Given other intersection points will be collinear along existing segments, this
    +won't change the orientation. =#
    +function _get_sides(b_prev, b_next, a_prev, curr_pt, a_next, i, j, a_list, b_list; exact)
    +    b_prev_pt = if _is_vertex(b_prev)
    +        b_prev.point
    +    else  # Find original start point of segment formed by b_prev and curr_pt
    +        prev_idx = findprev(_is_vertex, b_list, j - 1)
    +        prev_idx = isnothing(prev_idx) ? findlast(_is_vertex, b_list) : prev_idx
    +        b_list[prev_idx].point
    +    end
    +    b_next_pt = if _is_vertex(b_next)
    +        b_next.point
    +    else  # Find original end point of segment formed by curr_pt and b_next
    +        next_idx = findnext(_is_vertex, b_list, j + 1)
    +        next_idx = isnothing(next_idx) ? findfirst(_is_vertex, b_list) : next_idx
    +        b_list[next_idx].point
    +    end
    +    a_prev_pt = if _is_vertex(a_prev)
    +        a_prev.point
    +    else   # Find original start point of segment formed by a_prev and curr_pt
    +        prev_idx = findprev(_is_vertex, a_list, i - 1)
    +        prev_idx = isnothing(prev_idx) ? findlast(_is_vertex, a_list) : prev_idx
    +        a_list[prev_idx].point
    +    end
    +    a_next_pt = if _is_vertex(a_next)
    +        a_next.point
    +    else  # Find original end point of segment formed by curr_pt and a_next
    +        next_idx = findnext(_is_vertex, a_list, i + 1)
    +        next_idx = isnothing(next_idx) ? findfirst(_is_vertex, a_list) : next_idx
    +        a_list[next_idx].point
    +    end

    Determine side orientation of b_prev and b_next

    julia
        b_prev_side = _get_side(b_prev_pt, a_prev_pt, curr_pt.point, a_next_pt; exact)
    +    b_next_side = _get_side(b_next_pt, a_prev_pt, curr_pt.point, a_next_pt; exact)
    +    return b_prev_side, b_next_side
    +end

    Determines if Q lies to the left or right of the line formed by P1-P2-P3

    julia
    function _get_side(Q, P1, P2, P3; exact)
    +    s1 = Predicates.orient(Q, P1, P2; exact)
    +    s2 = Predicates.orient(Q, P2, P3; exact)
    +    s3 = Predicates.orient(P1, P2, P3; exact)
    +
    +    side = if s3  0
    +        (s1 < 0) || (s2 < 0) ? right : left
    +    else #  s3 < 0
    +        (s1 > 0) || (s2 > 0) ? left : right
    +    end
    +    return side
    +end
    +
    +#= Given a list of PolyNodes, find the first element that isn't an intersection point. Then,
    +test if this element is in or out of the given polygon. Return the next index, as well as
    +the enter/exit status of the next intersection point (the opposite of the in/out check). If
    +all points are intersection points, find the first element that either is the end of a chain
    +or a crossing point that isn't in a chain. Then take the midpoint of this point and the next
    +point in the list and perform the in/out check. If none of these points exist, return
    +a `next_idx` of `nothing`. =#
    +function _pt_off_edge_status(::Type{T}, pt_list, poly, npts; exact) where T
    +    start_idx, is_non_intr_pt = findfirst(_is_not_intr, pt_list), true
    +    if isnothing(start_idx)
    +        start_idx, is_non_intr_pt = findfirst(_next_edge_off, pt_list), false
    +        isnothing(start_idx) && return (start_idx, false)
    +    end
    +    next_idx = start_idx < npts ? (start_idx + 1) : 1
    +    start_pt = if is_non_intr_pt
    +        pt_list[start_idx].point
    +    else
    +        (pt_list[start_idx].point .+ pt_list[next_idx].point) ./ 2
    +    end
    +    start_status = !_point_filled_curve_orientation(start_pt, poly; in = true, on = false, out = false, exact)
    +    return next_idx, start_status
    +end

    Check if a PolyNode is an intersection point

    julia
    _is_not_intr(pt) = !pt.inter
    +#= Check if a PolyNode is the last point of a chain or a non-overlapping crossing point.
    +The next midpoint of one of these points and the next point within a polygon must not be on
    +the polygon edge. =#
    +_next_edge_off(pt) = (pt.endpoint == end_chain) || (pt.crossing && pt.endpoint == not_endpoint)
    _flag_ent_exit!(::Type{T}, ::GI.LinearRingTrait, poly, pt_list, delay_cross_f, delay_bounce_f; exact)

    This function flags all the intersection points as either an 'entry' or 'exit' point in relation to the given polygon. For non-delayed crossings we simply alternate the enter/exit status. This also holds true for the first and last points of a delayed bouncing, where they both have an opposite entry/exit flag. Conversely, the first and last point of a delayed crossing have the same entry/exit status. Furthermore, the crossing/bouncing flag of delayed crossings and bouncings may be updated. This depends on function specific rules that determine which of the start or end points (if any) should be marked as crossing for used during polygon tracing. A consistent rule is that the start and end points of a delayed crossing will have different crossing/bouncing flags, while a the endpoints of a delayed bounce will be the same.

    Used for clipping polygons by other polygons.

    julia
    function _flag_ent_exit!(::Type{T}, ::GI.LinearRingTrait, poly, pt_list, delay_cross_f, delay_bounce_f; exact) where T
    +    npts = length(pt_list)

    Find starting index if there is one

    julia
        next_idx, status = _pt_off_edge_status(T, pt_list, poly, npts; exact)
    +    isnothing(next_idx) && return
    +    start_idx = next_idx - 1

    Loop over points and mark entry and exit status

    julia
        start_chain_idx = 0
    +    for ii in Iterators.flatten((next_idx:npts, 1:start_idx))
    +        curr_pt = pt_list[ii]
    +        if curr_pt.endpoint == start_chain
    +            start_chain_idx = ii
    +        elseif curr_pt.crossing || curr_pt.endpoint == end_chain
    +            start_crossing, end_crossing = curr_pt.crossing, curr_pt.crossing
    +            if curr_pt.endpoint == end_chain  # ending overlapping chain
    +                start_pt = pt_list[start_chain_idx]
    +                if curr_pt.crossing  # delayed crossing
    +                    #= start and end crossing status are different and depend on current
    +                    entry/exit status =#
    +                    start_crossing, end_crossing = delay_cross_f(status)
    +                else  # delayed bouncing
    +                    next_idx = ii < npts ? (ii + 1) : 1
    +                    next_val = (curr_pt.point .+ pt_list[next_idx].point) ./ 2
    +                    pt_in_poly = _point_filled_curve_orientation(next_val, poly; in = true, on = false, out = false, exact)
    +                    #= start and end crossing status are the same and depend on if adjacent
    +                    edges of pt_list are within poly =#
    +                    start_crossing = delay_bounce_f(pt_in_poly)
    +                    end_crossing = start_crossing
    +                end

    update start of chain point

    julia
                    pt_list[start_chain_idx] = PolyNode(start_pt; ent_exit = status, crossing = start_crossing)
    +                if !curr_pt.crossing
    +                    status = !status
    +                end
    +            end
    +            pt_list[ii] = PolyNode(curr_pt; ent_exit = status, crossing = end_crossing)
    +            status = !status
    +        end
    +    end
    +    return
    +end
    _flag_ent_exit!(::GI.LineTrait, line, pt_list; exact)

    This function flags all the intersection points as either an 'entry' or 'exit' point in relation to the given line. Returns true if there are crossing points to classify, else returns false. Used for cutting polygons by lines.

    Assumes that the first point is outside of the polygon and not on an edge.

    julia
    function _flag_ent_exit!(::GI.LineTrait, poly, pt_list; exact)
    +    status = !_point_filled_curve_orientation(pt_list[1].point, poly; in = true, on = false, out = false, exact)

    Loop over points and mark entry and exit status

    julia
        for (ii, curr_pt) in enumerate(pt_list)
    +        if curr_pt.crossing
    +            pt_list[ii] = PolyNode(curr_pt; ent_exit = status)
    +            status = !status
    +        end
    +    end
    +    return
    +end
    +
    +#= Filters a_idx_list to just include crossing points and sets the index of all crossing
    +points (which element they correspond to within a_idx_list). =#
    +function _index_crossing_intrs!(a_list, b_list, a_idx_list)
    +    filter!(x -> a_list[x].crossing, a_idx_list)
    +    for (i, a_idx) in enumerate(a_idx_list)
    +        curr_node = a_list[a_idx]
    +        neighbor_node = b_list[curr_node.neighbor]
    +        a_list[a_idx] = PolyNode(curr_node; idx = i)
    +        b_list[curr_node.neighbor] = PolyNode(neighbor_node; idx = i)
    +    end
    +    return
    +end
    _trace_polynodes(::Type{T}, a_list, b_list, a_idx_list, f_step)::Vector{GI.Polygon}

    This function takes the outputs of _build_ab_list and traces the lists to determine which polygons are formed as described in Greiner and Hormann. The function f_step determines in which direction the lists are traced. This function is different for intersection, difference, and union. f_step must take in two arguments: the most recent intersection node's entry/exit status and a boolean that is true if we are currently tracing a_list and false if we are tracing b_list. The functions used for each clipping operation are follows: - Intersection: (x, y) -> x ? 1 : (-1) - Difference: (x, y) -> (x ⊻ y) ? 1 : (-1) - Union: (x, y) -> x ? (-1) : 1

    A list of GeoInterface polygons is returned from this function.

    Note: poly_a and poly_b are temporary inputs used for debugging and can be removed eventually.

    julia
    function _trace_polynodes(::Type{T}, a_list, b_list, a_idx_list, f_step, poly_a, poly_b) where T
    +    n_a_pts, n_b_pts = length(a_list), length(b_list)
    +    total_pts = n_a_pts + n_b_pts
    +    n_cross_pts = length(a_idx_list)
    +    return_polys = Vector{_get_poly_type(T)}(undef, 0)

    Keep track of number of processed intersection points

    julia
        visited_pts = 0
    +    processed_pts = 0
    +    first_idx = 1
    +    while processed_pts < n_cross_pts
    +        curr_list, curr_npoints = a_list, n_a_pts
    +        on_a_list = true

    Find first unprocessed intersecting point in subject polygon

    julia
            visited_pts += 1
    +        processed_pts += 1
    +        first_idx = findnext(x -> x != 0, a_idx_list, first_idx)
    +        idx = a_idx_list[first_idx]
    +        a_idx_list[first_idx] = 0
    +        start_pt = a_list[idx]

    Set first point in polygon

    julia
            curr = curr_list[idx]
    +        pt_list = [curr.point]
    +
    +        curr_not_start = true
    +        while curr_not_start
    +            step = f_step(curr.ent_exit, on_a_list)

    changed curr_not_intr to curr_not_same_ent_flag

    julia
                same_status, prev_status = true, curr.ent_exit
    +            while same_status
    +                @assert visited_pts < total_pts "Clipping tracing hit every point - clipping error. Please open an issue with polygons: $(GI.coordinates(poly_a)) and $(GI.coordinates(poly_b))."

    Traverse polygon either forwards or backwards

    julia
                    idx += step
    +                idx = (idx > curr_npoints) ? mod(idx, curr_npoints) : idx
    +                idx = (idx == 0) ? curr_npoints : idx

    Get current node and add to pt_list

    julia
                    curr = curr_list[idx]
    +                push!(pt_list, curr.point)
    +                if (curr.crossing || curr.endpoint != not_endpoint)

    Keep track of processed intersection points

    julia
                        same_status = curr.ent_exit == prev_status
    +                    curr_not_start = curr != start_pt && curr != b_list[start_pt.neighbor]
    +                    !curr_not_start && break
    +                    if (on_a_list && curr.crossing) || (!on_a_list && a_list[curr.neighbor].crossing)
    +                        processed_pts += 1
    +                        a_idx_list[curr.idx] = 0
    +                    end
    +                end
    +                visited_pts += 1
    +            end

    Switch to next list and next point

    julia
                curr_list, curr_npoints = on_a_list ? (b_list, n_b_pts) : (a_list, n_a_pts)
    +            on_a_list = !on_a_list
    +            idx = curr.neighbor
    +            curr = curr_list[idx]
    +        end
    +        push!(return_polys, GI.Polygon([pt_list]))
    +    end
    +    return return_polys
    +end

    Get type of polygons that will be made TODO: Increase type options

    julia
    _get_poly_type(::Type{T}) where T =
    +    GI.Polygon{false, false, Vector{GI.LinearRing{false, false, Vector{Tuple{T, T}}, Nothing, Nothing}}, Nothing, Nothing}
    _find_non_cross_orientation(a_list, b_list, a_poly, b_poly; exact)

    For polygons with no crossing intersection points, either one polygon is inside of another, or they are separate polygons with no intersection (other than an edge or point).

    Return two booleans that represent if a is inside b (potentially with shared edges / points) and visa versa if b is inside of a.

    julia
    function _find_non_cross_orientation(a_list, b_list, a_poly, b_poly; exact)
    +    non_intr_a_idx = findfirst(x -> !x.inter, a_list)
    +    non_intr_b_idx = findfirst(x -> !x.inter, b_list)
    +    #= Determine if non-intersection point is in or outside of polygon - if there isn't A
    +    non-intersection point, then all points are on the polygon edge =#
    +    a_pt_orient = isnothing(non_intr_a_idx) ? point_on :
    +        _point_filled_curve_orientation(a_list[non_intr_a_idx].point, b_poly; exact)
    +    b_pt_orient = isnothing(non_intr_b_idx) ? point_on :
    +        _point_filled_curve_orientation(b_list[non_intr_b_idx].point, a_poly; exact)
    +    a_in_b = a_pt_orient != point_out && b_pt_orient != point_in
    +    b_in_a = b_pt_orient != point_out && a_pt_orient != point_in
    +    return a_in_b, b_in_a
    +end
    _add_holes_to_polys!(::Type{T}, return_polys, hole_iterator, remove_poly_idx; exact)

    The holes specified by the hole iterator are added to the polygons in the return_polys list. If this creates more polygons, they are added to the end of the list. If this removes polygons, they are removed from the list

    julia
    function _add_holes_to_polys!(::Type{T}, return_polys, hole_iterator, remove_poly_idx; exact) where T
    +    n_polys = length(return_polys)
    +    remove_hole_idx = Int[]

    Remove set of holes from all polygons

    julia
        for i in 1:n_polys
    +        n_new_per_poly = 0
    +        for curr_hole in Iterators.map(tuples, hole_iterator) # loop through all holes
    +            curr_hole = _linearring(curr_hole)

    loop through all pieces of original polygon (new pieces added to end of list)

    julia
                for j in Iterators.flatten((i:i, (n_polys + 1):(n_polys + n_new_per_poly)))
    +                curr_poly = return_polys[j]
    +                remove_poly_idx[j] && continue
    +                curr_poly_ext = GI.nhole(curr_poly) > 0 ? GI.Polygon(StaticArrays.SVector(GI.getexterior(curr_poly))) : curr_poly
    +                in_ext, on_ext, out_ext = _line_polygon_interactions(curr_hole, curr_poly_ext; exact, closed_line = true)
    +                if in_ext  # hole is at least partially within the polygon's exterior
    +                    new_hole, new_hole_poly, n_new_pieces = _combine_holes!(T, curr_hole, curr_poly, return_polys, remove_hole_idx)
    +                    if n_new_pieces > 0
    +                        append!(remove_poly_idx, falses(n_new_pieces))
    +                        n_new_per_poly += n_new_pieces
    +                    end
    +                    if !on_ext && !out_ext  # hole is completely within exterior
    +                        push!(curr_poly.geom, new_hole)
    +                    else  # hole is partially within and outside of polygon's exterior
    +                        new_polys = difference(curr_poly_ext, new_hole_poly, T; target=GI.PolygonTrait())
    +                        n_new_polys = length(new_polys) - 1

    replace original

    julia
                            curr_poly.geom[1] = GI.getexterior(new_polys[1])
    +                        append!(curr_poly.geom, GI.gethole(new_polys[1]))
    +                        if n_new_polys > 0  # add any extra pieces
    +                            append!(return_polys, @view new_polys[2:end])
    +                            append!(remove_poly_idx, falses(n_new_polys))
    +                            n_new_per_poly += n_new_polys
    +                        end
    +                    end

    polygon is completely within hole

    julia
                    elseif coveredby(curr_poly_ext, GI.Polygon(StaticArrays.SVector(curr_hole)))
    +                    remove_poly_idx[j] = true
    +                end
    +            end
    +        end
    +        n_polys += n_new_per_poly
    +    end

    Remove all polygon that were marked for removal

    julia
        deleteat!(return_polys, remove_poly_idx)
    +    return
    +end
    _combine_holes!(::Type{T}, new_hole, curr_poly, return_polys)

    The new hole is combined with any existing holes in curr_poly. The holes can be combined into a larger hole if they are intersecting. If this happens, then the new, combined hole is returned with the original holes making up the new hole removed from curr_poly. Additionally, if the combined holes form a ring, the interior is added to the return_polys as a new polygon piece. Additionally, holes leftover after combination will be checked for it they are in the "main" polygon or in one of these new pieces and moved accordingly.

    If the holes don't touch or curr_poly has no holes, then new_hole is returned without any changes.

    julia
    function _combine_holes!(::Type{T}, new_hole, curr_poly, return_polys, remove_hole_idx) where T
    +    n_new_polys = 0
    +    empty!(remove_hole_idx)
    +    new_hole_poly = GI.Polygon(StaticArrays.SVector(new_hole))

    Combine any existing holes in curr_poly with new hole

    julia
        for (k, old_hole) in enumerate(GI.gethole(curr_poly))
    +        old_hole_poly = GI.Polygon(StaticArrays.SVector(old_hole))
    +        if intersects(new_hole_poly, old_hole_poly)

    If the holes intersect, combine them into a bigger hole

    julia
                hole_union = union(new_hole_poly, old_hole_poly, T; target = GI.PolygonTrait())[1]
    +            push!(remove_hole_idx, k + 1)
    +            new_hole = GI.getexterior(hole_union)
    +            new_hole_poly = GI.Polygon(StaticArrays.SVector(new_hole))
    +            n_pieces = GI.nhole(hole_union)
    +            if n_pieces > 0  # if the hole has a hole, then this is a new polygon piece!
    +                append!(return_polys, [GI.Polygon([h]) for h in GI.gethole(hole_union)])
    +                n_new_polys += n_pieces
    +            end
    +        end
    +    end

    Remove redundant holes

    julia
        deleteat!(curr_poly.geom, remove_hole_idx)
    +    empty!(remove_hole_idx)

    If new polygon pieces created, make sure remaining holes are in the correct piece

    julia
        @views for piece in return_polys[end - n_new_polys + 1:end]
    +        for (k, old_hole) in enumerate(GI.gethole(curr_poly))
    +            if !(k in remove_hole_idx) && within(old_hole, piece)
    +                push!(remove_hole_idx, k + 1)
    +                push!(piece.geom, old_hole)
    +            end
    +        end
    +    end
    +    deleteat!(curr_poly.geom, remove_hole_idx)
    +    return new_hole, new_hole_poly, n_new_polys
    +end
    +
    +#= Remove collinear edge points, other than the first and last edge vertex, to simplify
    +polygon - including both the exterior ring and any holes=#
    +function _remove_collinear_points!(polys, remove_idx, poly_a, poly_b)
    +    for (i, poly) in Iterators.reverse(enumerate(polys))
    +        for (j, ring) in Iterators.reverse(enumerate(GI.getring(poly)))
    +            n = length(ring.geom)

    resize and reset removing index buffer

    julia
                resize!(remove_idx, n)
    +            fill!(remove_idx, false)
    +            local p1, p2
    +            for (i, p) in enumerate(ring.geom)
    +                if i == 1
    +                    p1 = p
    +                    continue
    +                elseif i == 2
    +                    p2 = p
    +                    continue
    +                else
    +                    p3 = p

    check if p2 is approximately on the edge formed by p1 and p3 - remove if so

    julia
                        if Predicates.orient(p1, p2, p3; exact = _False()) == 0
    +                        remove_idx[i - 1] = true
    +                    end
    +                end
    +                p1, p2 = p2, p3
    +            end

    Check if the first point (which is repeated as the last point) is needed

    julia
                if Predicates.orient(ring.geom[end - 1], ring.geom[1], ring.geom[2]; exact = _False()) == 0
    +                remove_idx[1], remove_idx[end] = true, true
    +            end

    Remove unneeded collinear points

    julia
                deleteat!(ring.geom, remove_idx)

    Check if enough points are left to form a polygon

    julia
                if length(ring.geom)  (remove_idx[1] ? 2 : 3)
    +                if j == 1
    +                    deleteat!(polys, i)
    +                    break
    +                else
    +                    deleteat!(poly.geom, j)
    +                    continue
    +                end
    +            end
    +            if remove_idx[1]  # make sure the last point is repeated
    +                push!(ring.geom, ring.geom[1])
    +            end
    +        end
    +    end
    +    return
    +end

    This page was generated using Literate.jl.

    + + + + \ No newline at end of file diff --git a/previews/PR237/source/methods/clipping/coverage.html b/previews/PR237/source/methods/clipping/coverage.html new file mode 100644 index 000000000..198ffeeab --- /dev/null +++ b/previews/PR237/source/methods/clipping/coverage.html @@ -0,0 +1,247 @@ + + + + + + GeometryOps.jl + + + + + + + + + + + + + + +
    Skip to content
    julia
    export coverage

    What is coverage?

    Coverage is the amount of geometry area within a bounding box defined by the minimum and maximum x and y-coordinates of that bounding box, or an Extent containing that information.

    To provide an example, consider this rectangle:

    julia
    import GeometryOps as GO
    +import GeoInterface as GI
    +using Makie
    +using CairoMakie
    +
    +rect = GI.Polygon([[(-1,0), (-1,1), (1,1), (1,0), (-1,0)]])
    +cell = GI.Polygon([[(0, 0), (0, 2), (2, 2), (2, 0), (0, 0)]])
    +xmin, xmax, ymin, ymax = 0, 2, 0, 2
    +f, a, p = poly(collect(GI.getpoint(cell)); axis = (; aspect = DataAspect()))
    +poly!(collect(GI.getpoint(rect)))
    +f

    It is clear that half of the polygon is within the cell, so the coverage should be 1.0, half of the area of the rectangle.

    julia
    GO.coverage(rect, xmin, xmax, ymin, ymax)
    1.0

    Implementation

    This is the GeoInterface-compatible implementation. First, we implement a wrapper method that dispatches to the correct implementation based on the geometry trait. This is also used in the implementation, since it's a lot less work!

    Note that the coverage is zero for all points and curves, even if the curves are closed like with a linear ring.

    Targets for applys functions

    julia
    const _COVERAGE_TARGETS = TraitTarget{Union{GI.PolygonTrait,GI.AbstractCurveTrait,GI.MultiPointTrait,GI.PointTrait}}()

    Wall types for coverage

    julia
    const UNKNOWN, NORTH, EAST, SOUTH, WEST = 0:4
    +
    +"""
    +    coverage(geom, xmin, xmax, ymin, ymax, [T = Float64])::T
    +
    +Returns the area of intersection between given geometry and grid cell defined by its minimum
    +and maximum x and y-values. This is computed differently for different geometries:
    +
    +- The signed area of a point is always zero.
    +- The signed area of a curve is always zero.
    +- The signed area of a polygon is calculated by tracing along its edges and switching to the
    +    cell edges if needed.
    +- The coverage of a geometry collection, multi-geometry, feature collection of
    +    array/iterable is the sum of the coverages of all of the sub-geometries.
    +
    +Result will be of type T, where T is an optional argument with a default value
    +of Float64.
    +"""
    +function coverage(geom, xmin, xmax, ymin, ymax,::Type{T} = Float64; threaded=false) where T <: AbstractFloat
    +    applyreduce(+, _COVERAGE_TARGETS, geom; threaded, init=zero(T)) do g
    +        _coverage(T, GI.trait(g), g, T(xmin), T(xmax), T(ymin), T(ymax))
    +    end
    +end
    +
    +function coverage(geom, cell_ext::Extents.Extent, ::Type{T} = Float64; threaded=false) where T <: AbstractFloat
    +    (xmin, xmax), (ymin, ymax) = values(cell_ext)
    +    return coverage(geom, xmin, xmax, ymin, ymax, T; threaded = threaded)
    +end

    Points, MultiPoints, Curves, MultiCurves

    julia
    _coverage(::Type{T}, ::GI.AbstractGeometryTrait, geom, xmin, xmax, ymin, ymax; kwargs...) where T = zero(T)

    Polygons

    julia
    function _coverage(::Type{T}, ::GI.PolygonTrait, poly, xmin, xmax, ymin, ymax; exact = _False()) where T
    +    GI.isempty(poly) && return zero(T)
    +    cov_area = _coverage(T, GI.getexterior(poly), xmin, xmax, ymin, ymax; exact)
    +    cov_area == 0 && return cov_area

    Remove hole coverage from total

    julia
        for hole in GI.gethole(poly)
    +        cov_area -= _coverage(T, hole, xmin, xmax, ymin, ymax; exact)
    +    end
    +    return cov_area
    +end
    +
    +#= Calculates the area of the filled ring within the cell defined by corners with (xmin, ymin),
    +(xmin, ymax), (xmax, ymax), and (xmax, ymin). =#
    +function _coverage(::Type{T}, ring, xmin, xmax, ymin, ymax; exact) where T
    +    cov_area = zero(T)
    +    unmatched_out_wall, unmatched_out_point = UNKNOWN, (zero(T), zero(T))
    +    unmatched_in_wall, unmatched_in_point = unmatched_out_wall, unmatched_out_point

    Loop over edges of polygon

    julia
        start_idx = 1
    +    for (i, p) in enumerate(GI.getpoint(ring))
    +        if !_point_in_cell(p, xmin, xmax, ymin, ymax)
    +            start_idx = i
    +            break
    +        end
    +    end
    +    ring_cw = isclockwise(ring)
    +    p1 = _tuple_point(GI.getpoint(ring, start_idx), T)

    Must rotate clockwise for the algorithm to work

    julia
        point_idx = ring_cw ? Iterators.flatten((start_idx + 1:GI.npoint(ring), 1:start_idx)) :
    +        Iterators.flatten((start_idx - 1:-1:1, GI.npoint(ring):-1:start_idx))
    +    for i in point_idx
    +        p2 = _tuple_point(GI.getpoint(ring, i), T)

    Determine if edge points are within the cell

    julia
            p1_in_cell = _point_in_cell(p1, xmin, xmax, ymin, ymax)
    +        p2_in_cell = _point_in_cell(p2, xmin, xmax, ymin, ymax)

    If entire line segment is inside cell

    julia
            if p1_in_cell && p2_in_cell
    +            cov_area += _area_component(p1, p2)
    +            p1 = p2
    +            continue
    +        end

    If edge passes outside of rectangle, determine which edge segments are added

    julia
            inter1, inter2 = _line_intersect_cell(T, p1, p2, xmin, xmax, ymin, ymax)

    Endpoints of segment within the cell and wall they are on if known

    julia
            (start_wall, start_point), (end_wall, end_point) =
    +            if p1_in_cell
    +                ((UNKNOWN, p1), inter1)
    +            elseif p2_in_cell
    +                (inter1, (UNKNOWN, p2))
    +            else
    +                i1_to_p1 = _squared_euclid_distance(T, inter1[2], p1)
    +                i2_to_p1 = _squared_euclid_distance(T, inter2[2], p1)
    +                i1_to_p1 < i2_to_p1 ? (inter1, inter2) : (inter2, inter1)
    +            end

    Add edge component

    julia
            cov_area += _area_component(start_point, end_point)
    +
    +        if start_wall != UNKNOWN  # p1 out of cell
    +            if unmatched_out_wall == UNKNOWN
    +                unmatched_in_point = start_point
    +                unmatched_in_wall = start_wall
    +            else
    +                check_point = find_point_on_cell(unmatched_out_point, start_point,
    +                    unmatched_out_wall, start_wall,xmin, xmax, ymin, ymax)
    +                if _point_filled_curve_orientation(check_point, ring; in = true, on = false, out = false, exact)
    +                    cov_area += connect_edges(T, unmatched_out_point, start_point,
    +                        unmatched_out_wall, start_wall,xmin, xmax, ymin, ymax)
    +                else
    +                    cov_area += connect_edges(T, unmatched_out_point, unmatched_in_point,
    +                        unmatched_out_wall, unmatched_in_wall,xmin, xmax, ymin, ymax)
    +                    unmatched_out_wall == UNKNOWN
    +                end
    +            end
    +        end
    +        if end_wall != UNKNOWN  # p2 out of cell
    +            unmatched_out_wall, unmatched_out_point = end_wall, end_point
    +        end
    +        p1 = p2
    +    end

    if unmatched in-point at beginning, close polygon with last out point

    julia
        if unmatched_in_wall != UNKNOWN
    +        cov_area += connect_edges(T, unmatched_out_point, unmatched_in_point,
    +            unmatched_out_wall, unmatched_in_wall,xmin, xmax, ymin, ymax)
    +    end
    +    cov_area = abs(cov_area) / 2

    if grid cell is within polygon then the area is grid cell area

    julia
        if cov_area == 0
    +        if _point_filled_curve_orientation((xmin, ymin), ring; in = true, on = true, out = false, exact)
    +            cov_area = abs((xmax - xmin) * (ymax - ymin))
    +        end
    +    end
    +    return cov_area
    +end

    Returns true of the given point is within the bounding box determined by x and y values

    julia
    _point_in_cell(p, xmin, xmax, ymin, ymax) = xmin <= GI.x(p) <= xmax && ymin <= GI.y(p) <= ymax

    Returns true if b is between a and c, exclusive of the maximum value, else false.

    julia
    _between(b, a, c) = a  b < c || c  b < a
    +
    +#= Determine intersections of the line from (x1, y1) to (x2, y2) with the bounding box
    +defined by the minimum and maximum x/y values. Since we are dealing with a single line
    +segment, we know that there is at maximum two intersection points.
    +
    +For each intersection point that we find, return the wall that it passes through, as well as
    +the intersection point itself as a a tuple. If an intersection point isn't found, return the
    +wall as UNKNOWN and the point as a pair of zeros. =#
    +function _line_intersect_cell(::Type{T}, (x1, y1), (x2, y2), xmin, xmax, ymin, ymax) where T
    +    Δx, Δy = x2 - x1, y2 - y1
    +    inter1 = (UNKNOWN, (zero(T), zero(T)))
    +    inter2 = inter1
    +    if Δx == 0  # If line is vertical, only consider north and south
    +        if xmin  x1  xmax
    +            inter1 = _between(ymax, y1, y2) ? (NORTH, (x1, ymax)) : inter1
    +            inter2 = _between(ymin, y1, y2) ? (SOUTH, (x1, ymin)) : inter2
    +        end
    +    elseif Δy == 0 # If line is horizontal, only consider east and west
    +        if ymin  y1  ymax
    +            inter1 = _between(xmax, x1, x2) ? (EAST, (xmax, y1)) : inter1
    +            inter2 = _between(xmin, x1, x2) ? (WEST, (xmin, y1)) : inter2
    +        end
    +    else  # Line is tilted, must consider all edges, but only two can intersect
    +        m = Δy / Δx
    +        b = y1 - m * x1

    Calculate and check potential intersections

    julia
            xn = (ymax - b) / m
    +        if xmin  xn  xmax && _between(xn, x1, x2) && _between(ymax, y1, y2)
    +            inter1 = (NORTH, (xn, ymax))
    +        end
    +        xs = (ymin - b) / m
    +        if xmin  xs  xmax && _between(xs, x1, x2) && _between(ymin, y1, y2)
    +            new_intr = (SOUTH, (xs, ymin))
    +            (inter1[1] == UNKNOWN) ? (inter1 = new_intr) : (inter2 = new_intr)
    +        end
    +        ye =  m * xmax + b
    +        if ymin  ye  ymax && _between(ye, y1, y2) && _between(xmax, x1, x2)
    +            new_intr = (EAST, (xmax, ye))
    +            (inter1[1] == UNKNOWN) ? (inter1 = new_intr) : (inter2 = new_intr)
    +        end
    +        yw = m * xmin + b
    +        if ymin  yw  ymax && _between(yw, y1, y2) && _between(xmin, x1, x2)
    +            new_intr = (WEST, (xmin, yw))
    +            (inter1[1] == UNKNOWN) ? (inter1 = new_intr) : (inter2 = new_intr)
    +        end
    +    end
    +    if inter1[1] == UNKNOWN  # first intersection must be known, if one exists
    +        inter1, inter2 = inter2, inter1
    +    end
    +    return inter1, inter2
    +end

    Finds point of cell edge between p1 and p2 given which walls they are on

    julia
    function find_point_on_cell(p1, p2, wall1, wall2, xmin, xmax, ymin, ymax)
    +    x1, y1 = p1
    +    x2, y2 = p2
    +    mid_point = if wall1 == wall2 && _is_clockwise_from(p1, p2, wall1)
    +        (x1 + x2) / 2, (y1 + y2) / 2
    +    elseif wall1 == NORTH
    +        (xmax, ymax)
    +    elseif wall1 == EAST
    +        (xmax, ymin)
    +    elseif wall1 == SOUTH
    +        (xmin, ymin)
    +    else
    +        (xmin, ymax)
    +    end
    +    return mid_point
    +end
    +
    +#= Area component of shoelace formula coming from the distance between point 1 and point 2
    +along grid cell walls in between the two points. =#
    +function connect_edges(::Type{T}, p1, p2, wall1, wall2, xmin, xmax, ymin, ymax) where {T}
    +    connect_area = zero(T)
    +    if wall1 == wall2 && _is_clockwise_from(p1, p2, wall1)
    +        connect_area += _area_component(p1, p2)
    +    else

    From the point to the corner of wall 1

    julia
            connect_area += _partial_edge_out_area(p1, xmin, xmax, ymin, ymax, wall1)

    Any intermediate walls (full length)

    julia
            next_wall, last_wall = wall1 + 1, wall2 - 1
    +        if wall2 > wall1
    +            for wall in next_wall:last_wall
    +                connect_area += _full_edge_area(xmin, xmax, ymin, ymax, wall)
    +            end
    +        else
    +            for wall in Iterators.flatten((next_wall:WEST, NORTH:last_wall))
    +                connect_area += _full_edge_area(xmin, xmax, ymin, ymax, wall)
    +            end
    +        end

    From the corner of wall 2 to the point

    julia
            connect_area += _partial_edge_in_area(p2, xmin, xmax, ymin, ymax, wall2)
    +    end
    +    return connect_area
    +end

    True if (x1, y1) is clockwise from (x2, y2) on the same wall

    julia
    _is_clockwise_from((x1, y1), (x2, y2), wall) = (wall == NORTH && x2 > x1) ||
    +    (wall == EAST && y2 < y1) || (wall == SOUTH && x2 < x1) || (wall == WEST && y2 > y1)
    +
    +#= Returns the area component of a full edge of the bounding box defined by the min and max
    +values and the wall. =#
    +_full_edge_area(xmin, xmax, ymin, ymax, wall) = if wall == NORTH
    +        ymax * (xmin - xmax)
    +    elseif wall == EAST
    +        xmax * (ymin - ymax)
    +    elseif wall == SOUTH
    +        ymin * (xmax - xmin)
    +    else
    +        xmin * (ymax - ymin)
    +    end
    +
    +#= Returns the area component of part of one wall, from its "starting corner" (going
    +clockwise) to the point (x2, y2). =#
    +function _partial_edge_in_area((x2, y2), xmin, xmax, ymin, ymax, wall)
    +    x_wall = (wall == NORTH || wall == WEST) ? xmin : xmax
    +    y_wall = (wall == NORTH || wall == EAST) ? ymax : ymin
    +    return x_wall * y2 - x2 * y_wall
    +end
    +
    +#= Returns the area component of part of one wall, from the point (x1, y1) to its
    +"ending corner" (going clockwise). =#
    +function _partial_edge_out_area((x1, y1), xmin, xmax, ymin, ymax, wall)
    +    x_wall = (wall == NORTH || wall == EAST) ? xmax : xmin
    +    y_wall = (wall == NORTH || wall == WEST) ? ymax : ymin
    +    return x1 * y_wall - x_wall * y1
    +end

    This page was generated using Literate.jl.

    + + + + \ No newline at end of file diff --git a/previews/PR237/source/methods/clipping/cut.html b/previews/PR237/source/methods/clipping/cut.html new file mode 100644 index 000000000..c7407b24c --- /dev/null +++ b/previews/PR237/source/methods/clipping/cut.html @@ -0,0 +1,111 @@ + + + + + + Polygon cutting | GeometryOps.jl + + + + + + + + + + + + + + +
    Skip to content

    Polygon cutting

    julia
    export cut

    What is cut?

    The cut function cuts a polygon through a line segment. This is inspired by functions such as Matlab's cutpolygon function.

    To provide an example, consider the following polygon and line:

    julia
    import GeoInterface as GI, GeometryOps as GO
    +using CairoMakie
    +using Makie
    +
    +poly = GI.Polygon([[(0.0, 0.0), (10.0, 0.0), (10.0, 10.0), (0.0, 10.0), (0.0, 0.0)]])
    +line = GI.Line([(5.0, -5.0), (5.0, 15.0)])
    +cut_polys = GO.cut(poly, line)
    +
    +f, a, p1 = Makie.poly(collect(GI.getpoint(cut_polys[1])); color = (:blue, 0.5))
    +Makie.poly!(collect(GI.getpoint(cut_polys[2])); color = (:orange, 0.5))
    +Makie.lines!(GI.getpoint(line); color = :black)
    +f

    Implementation

    This function depends on polygon clipping helper function and is inspired by the Greiner-Hormann clipping algorithm used elsewhere in this library. The inspiration came from this Stack Overflow discussion.

    julia
    """
    +    cut(geom, line, [T::Type])
    +
    +Return given geom cut by given line as a list of geometries of the same type as the input
    +geom. Return the original geometry as only list element if none are found. Line must cut
    +fully through given geometry or the original geometry will be returned.
    +
    +Note: This currently doesn't work for degenerate cases there line crosses through vertices.
    +
    +# Example
    +
    +```jldoctest
    +import GeoInterface as GI, GeometryOps as GO
    +
    +poly = GI.Polygon([[(0.0, 0.0), (10.0, 0.0), (10.0, 10.0), (0.0, 10.0), (0.0, 0.0)]])
    +line = GI.Line([(5.0, -5.0), (5.0, 15.0)])
    +cut_polys = GO.cut(poly, line)
    +GI.coordinates.(cut_polys)

    output

    julia
    2-element Vector{Vector{Vector{Vector{Float64}}}}:
    + [[[0.0, 0.0], [5.0, 0.0], [5.0, 10.0], [0.0, 10.0], [0.0, 0.0]]]
    + [[[5.0, 0.0], [10.0, 0.0], [10.0, 10.0], [5.0, 10.0], [5.0, 0.0]]]
    +```
    +"""
    +cut(geom, line, ::Type{T} = Float64) where {T <: AbstractFloat} =
    +    _cut(T, GI.trait(geom), geom, GI.trait(line), line; exact = _True())
    +
    +#= Cut a given polygon by given line. Add polygon holes back into resulting pieces if there
    +are any holes. =#
    +function _cut(::Type{T}, ::GI.PolygonTrait, poly, ::GI.LineTrait, line; exact) where T
    +    ext_poly = GI.getexterior(poly)
    +    poly_list, intr_list = _build_a_list(T, ext_poly, line; exact)
    +    n_intr_pts = length(intr_list)

    If an impossible number of intersection points, return original polygon

    julia
        if n_intr_pts < 2 || isodd(n_intr_pts)
    +        return [tuples(poly)]
    +    end

    Cut polygon by line

    julia
        cut_coords = _cut(T, ext_poly, line, poly_list, intr_list, n_intr_pts; exact)

    Close coords and create polygons

    julia
        for c in cut_coords
    +        push!(c, c[1])
    +    end
    +    cut_polys = [GI.Polygon([c]) for c in cut_coords]

    Add original polygon holes back in

    julia
        remove_idx = falses(length(cut_polys))
    +    _add_holes_to_polys!(T, cut_polys, GI.gethole(poly), remove_idx; exact)
    +    return cut_polys
    +end

    Many types aren't implemented

    julia
    function _cut(::Type{T}, trait::GI.AbstractTrait, geom, line; kwargs...) where T
    +    @assert(
    +        false,
    +        "Cutting of $trait isn't implemented yet.",
    +    )
    +    return nothing
    +end
    +
    +#= Cutting algorithm inspired by Greiner and Hormann clipping algorithm. Returns coordinates
    +of cut geometry in Vector{Vector{Tuple}} format.
    +
    +Note: degenerate cases where intersection points are vertices do not work right now. =#
    +function _cut(::Type{T}, geom, line, geom_list, intr_list, n_intr_pts; exact) where T

    Sort and categorize the intersection points

    julia
        sort!(intr_list, by = x -> geom_list[x].fracs[2])
    +    _flag_ent_exit!(GI.LineTrait(), line, geom_list; exact)

    Add first point to output list

    julia
        return_coords = [[geom_list[1].point]]
    +    cross_backs = [(T(Inf),T(Inf))]
    +    poly_idx = 1
    +    n_polys = 1

    Walk around original polygon to find split polygons

    julia
        for (pt_idx, curr) in enumerate(geom_list)
    +        if pt_idx > 1
    +            push!(return_coords[poly_idx], curr.point)
    +        end
    +        if curr.inter

    Find cross back point for current polygon

    julia
                intr_idx = findfirst(x -> equals(curr.point, geom_list[x].point), intr_list)
    +            cross_idx = intr_idx + (curr.ent_exit ? 1 : -1)
    +            cross_idx = cross_idx < 1 ? n_intr_pts : cross_idx
    +            cross_idx = cross_idx > n_intr_pts ? 1 : cross_idx
    +            cross_backs[poly_idx] = geom_list[intr_list[cross_idx]].point

    Check if current point is a cross back point

    julia
                next_poly_idx = findfirst(x -> equals(x, curr.point), cross_backs)
    +            if isnothing(next_poly_idx)
    +                push!(return_coords, [curr.point])
    +                push!(cross_backs, curr.point)
    +                n_polys += 1
    +                poly_idx = n_polys
    +            else
    +                push!(return_coords[next_poly_idx], curr.point)
    +                poly_idx = next_poly_idx
    +            end
    +        end
    +    end
    +    return return_coords
    +end

    This page was generated using Literate.jl.

    + + + + \ No newline at end of file diff --git a/previews/PR237/source/methods/clipping/difference.html b/previews/PR237/source/methods/clipping/difference.html new file mode 100644 index 000000000..fd1530e59 --- /dev/null +++ b/previews/PR237/source/methods/clipping/difference.html @@ -0,0 +1,190 @@ + + + + + + Difference Polygon Clipping | GeometryOps.jl + + + + + + + + + + + + + + +
    Skip to content

    Difference Polygon Clipping

    julia
    export difference
    +
    +
    +"""
    +    difference(geom_a, geom_b, [T::Type]; target::Type, fix_multipoly = UnionIntersectingPolygons())
    +
    +Return the difference between two geometries as a list of geometries. Return an empty list
    +if none are found. The type of the list will be constrained as much as possible given the
    +input geometries. Furthermore, the user can provide a `taget` type as a keyword argument and
    +a list of target geometries found in the difference will be returned. The user can also
    +provide a float type that they would like the points of returned geometries to be. If the
    +user is taking a intersection involving one or more multipolygons, and the multipolygon
    +might be comprised of polygons that intersect, if `fix_multipoly` is set to an
    +`IntersectingPolygons` correction (the default is `UnionIntersectingPolygons()`), then the
    +needed multipolygons will be fixed to be valid before performing the intersection to ensure
    +a correct answer. Only set `fix_multipoly` to false if you know that the multipolygons are
    +valid, as it will avoid unneeded computation.
    +
    +# Example
    +
    +```jldoctest
    +import GeoInterface as GI, GeometryOps as GO
    +
    +poly1 = GI.Polygon([[[0.0, 0.0], [5.0, 5.0], [10.0, 0.0], [5.0, -5.0], [0.0, 0.0]]])
    +poly2 = GI.Polygon([[[3.0, 0.0], [8.0, 5.0], [13.0, 0.0], [8.0, -5.0], [3.0, 0.0]]])
    +diff_poly = GO.difference(poly1, poly2; target = GI.PolygonTrait())
    +GI.coordinates.(diff_poly)

    output

    julia
    1-element Vector{Vector{Vector{Vector{Float64}}}}:
    + [[[6.5, 3.5], [5.0, 5.0], [0.0, 0.0], [5.0, -5.0], [6.5, -3.5], [3.0, 0.0], [6.5, 3.5]]]
    +```
    +"""
    +function difference(
    +    geom_a, geom_b, ::Type{T} = Float64; target=nothing, kwargs...,
    +) where {T<:AbstractFloat}
    +    return _difference(
    +        TraitTarget(target), T, GI.trait(geom_a), geom_a, GI.trait(geom_b), geom_b;
    +        exact = _True(), kwargs...,
    +    )
    +end
    +
    +#= The 'difference' function returns the difference of two polygons as a list of polygons.
    +The algorithm to determine the difference was adapted from "Efficient clipping of efficient
    +polygons," by Greiner and Hormann (1998). DOI: https://doi.org/10.1145/274363.274364 =#
    +function _difference(
    +    ::TraitTarget{GI.PolygonTrait}, ::Type{T},
    +    ::GI.PolygonTrait, poly_a,
    +    ::GI.PolygonTrait, poly_b;
    +    exact, kwargs...
    +) where T

    Get the exterior of the polygons

    julia
        ext_a = GI.getexterior(poly_a)
    +    ext_b = GI.getexterior(poly_b)

    Find the difference of the exterior of the polygons

    julia
        a_list, b_list, a_idx_list = _build_ab_list(T, ext_a, ext_b, _diff_delay_cross_f, _diff_delay_bounce_f; exact)
    +    polys = _trace_polynodes(T, a_list, b_list, a_idx_list, _diff_step, poly_a, poly_b)

    if no crossing points, determine if either poly is inside of the other

    julia
        if isempty(polys)
    +        a_in_b, b_in_a = _find_non_cross_orientation(a_list, b_list, ext_a, ext_b; exact)

    add case for if they polygons are the same (all intersection points!) add a find_first check to find first non-inter poly!

    julia
            if b_in_a && !a_in_b  # b in a and can't be the same polygon
    +            poly_a_b_hole = GI.Polygon([tuples(ext_a), tuples(ext_b)])
    +            push!(polys, poly_a_b_hole)
    +        elseif !b_in_a && !a_in_b # polygons don't intersect
    +            push!(polys, tuples(poly_a))
    +            return polys
    +        end
    +    end
    +    remove_idx = falses(length(polys))

    If the original polygons had holes, take that into account.

    julia
        if GI.nhole(poly_a) != 0
    +        _add_holes_to_polys!(T, polys, GI.gethole(poly_a), remove_idx; exact)
    +    end
    +    if GI.nhole(poly_b) != 0
    +        for hole in GI.gethole(poly_b)
    +            hole_poly = GI.Polygon(StaticArrays.SVector(hole))
    +            new_polys = intersection(hole_poly, poly_a, T; target = GI.PolygonTrait)
    +            if length(new_polys) > 0
    +                append!(polys, new_polys)
    +            end
    +        end
    +    end

    Remove unneeded collinear points on same edge

    julia
        _remove_collinear_points!(polys, remove_idx, poly_a, poly_b)
    +    return polys
    +end

    Helper functions for Differences with Greiner and Hormann Polygon Clipping

    julia
    #= When marking the crossing status of a delayed crossing, the chain start point is crossing
    +when the start point is a entry point and is a bouncing point when the start point is an
    +exit point. The end of the chain has the opposite crossing / bouncing status. =#
    +_diff_delay_cross_f(x) = (x, !x)
    +#= When marking the crossing status of a delayed bouncing, the chain start and end points
    +are crossing if the current polygon's adjacent edges are within the non-tracing polygon and
    +we are tracing b_list or if the edges are outside and we are on a_list. Otherwise the
    +endpoints are marked as crossing. x is a boolean representing if the edges are inside or
    +outside of the polygon and y is a variable that is true if we are on a_list and false if we
    +are on b_list. =#
    +_diff_delay_bounce_f(x, y) = x  y
    +#= When tracing polygons, step forwards if the most recent intersection point was an entry
    +point and we are currently tracing b_list or if it was an exit point and we are currently
    +tracing a_list, else step backwards, where x is the entry/exit status and y is a variable
    +that is true if we are on a_list and false if we are on b_list. =#
    +_diff_step(x, y) = (x  y) ? 1 : (-1)
    +
    +#= Polygon with multipolygon difference - note that all intersection regions between
    +`poly_a` and any of the sub-polygons of `multipoly_b` are removed from `poly_a`. =#
    +function _difference(
    +    target::TraitTarget{GI.PolygonTrait}, ::Type{T},
    +    ::GI.PolygonTrait, poly_a,
    +    ::GI.MultiPolygonTrait, multipoly_b;
    +    kwargs...,
    +) where T
    +    polys = [tuples(poly_a, T)]
    +    for poly_b in GI.getpolygon(multipoly_b)
    +        isempty(polys) && break
    +        polys = mapreduce(p -> difference(p, poly_b; target), append!, polys)
    +    end
    +    return polys
    +end
    +
    +#= Multipolygon with polygon difference - note that all intersection regions between
    +sub-polygons of `multipoly_a` and `poly_b` will be removed from the corresponding
    +sub-polygon. Unless specified with `fix_multipoly = nothing`, `multipolygon_a` will be
    +validated using the given (default is `UnionIntersectingPolygons()`) correction. =#
    +function _difference(
    +    target::TraitTarget{GI.PolygonTrait}, ::Type{T},
    +    ::GI.MultiPolygonTrait, multipoly_a,
    +    ::GI.PolygonTrait, poly_b;
    +    fix_multipoly = UnionIntersectingPolygons(), kwargs...,
    +) where T
    +    if !isnothing(fix_multipoly) # Fix multipoly_a to prevent returning an invalid multipolygon
    +        multipoly_a = fix_multipoly(multipoly_a)
    +    end
    +    polys = Vector{_get_poly_type(T)}()
    +    sizehint!(polys, GI.npolygon(multipoly_a))
    +    for poly_a in GI.getpolygon(multipoly_a)
    +        append!(polys, difference(poly_a, poly_b; target))
    +    end
    +    return polys
    +end
    +
    +#= Multipolygon with multipolygon difference - note that all intersection regions between
    +sub-polygons of `multipoly_a` and sub-polygons of `multipoly_b` will be removed from the
    +corresponding sub-polygon of `multipoly_a`. Unless specified with `fix_multipoly = nothing`,
    +`multipolygon_a` will be validated using the given (default is `UnionIntersectingPolygons()`)
    +correction. =#
    +function _difference(
    +    target::TraitTarget{GI.PolygonTrait}, ::Type{T},
    +    ::GI.MultiPolygonTrait, multipoly_a,
    +    ::GI.MultiPolygonTrait, multipoly_b;
    +    fix_multipoly = UnionIntersectingPolygons(), kwargs...,
    +) where T
    +    if !isnothing(fix_multipoly) # Fix multipoly_a to prevent returning an invalid multipolygon
    +        multipoly_a = fix_multipoly(multipoly_a)
    +        fix_multipoly = nothing
    +    end
    +    local polys
    +    for (i, poly_b) in enumerate(GI.getpolygon(multipoly_b))
    +        #= Removing intersections of `multipoly_a`` with pieces of `multipoly_b`` - as
    +        pieces of `multipolygon_a`` are removed, continue to take difference with new shape
    +        `polys` =#
    +        polys = if i == 1
    +            difference(multipoly_a, poly_b; target, fix_multipoly)
    +        else
    +            difference(GI.MultiPolygon(polys), poly_b; target, fix_multipoly)
    +        end
    +        #= One multipoly_a has been completely covered (and thus removed) there is no need to
    +        continue taking the difference =#
    +        isempty(polys) && break
    +    end
    +    return polys
    +end

    Many type and target combos aren't implemented

    julia
    function _difference(
    +    ::TraitTarget{Target}, ::Type{T},
    +    trait_a::GI.AbstractTrait, geom_a,
    +    trait_b::GI.AbstractTrait, geom_b,
    +) where {Target, T}
    +    @assert(
    +        false,
    +        "Difference between $trait_a and $trait_b with target $Target isn't implemented yet.",
    +    )
    +    return nothing
    +end

    This page was generated using Literate.jl.

    + + + + \ No newline at end of file diff --git a/previews/PR237/source/methods/clipping/intersection.html b/previews/PR237/source/methods/clipping/intersection.html new file mode 100644 index 000000000..2ff3cedd4 --- /dev/null +++ b/previews/PR237/source/methods/clipping/intersection.html @@ -0,0 +1,407 @@ + + + + + + Geometry Intersection | GeometryOps.jl + + + + + + + + + + + + + + +
    Skip to content

    Geometry Intersection

    julia
    export intersection, intersection_points
    +
    +"""
    +    Enum LineOrientation
    +Enum for the orientation of a line with respect to a curve. A line can be
    +`line_cross` (crossing over the curve), `line_hinge` (crossing the endpoint of the curve),
    +`line_over` (collinear with the curve), or `line_out` (not interacting with the curve).
    +"""
    +@enum LineOrientation line_cross=1 line_hinge=2 line_over=3 line_out=4
    +
    +"""
    +    intersection(geom_a, geom_b, [T::Type]; target::Type, fix_multipoly = UnionIntersectingPolygons())
    +
    +Return the intersection between two geometries as a list of geometries. Return an empty list
    +if none are found. The type of the list will be constrained as much as possible given the
    +input geometries. Furthermore, the user can provide a `target` type as a keyword argument and
    +a list of target geometries found in the intersection will be returned. The user can also
    +provide a float type that they would like the points of returned geometries to be. If the
    +user is taking a intersection involving one or more multipolygons, and the multipolygon
    +might be comprised of polygons that intersect, if `fix_multipoly` is set to an
    +`IntersectingPolygons` correction (the default is `UnionIntersectingPolygons()`), then the
    +needed multipolygons will be fixed to be valid before performing the intersection to ensure
    +a correct answer. Only set `fix_multipoly` to nothing if you know that the multipolygons are
    +valid, as it will avoid unneeded computation.
    +
    +# Example
    +
    +```jldoctest
    +import GeoInterface as GI, GeometryOps as GO
    +
    +line1 = GI.Line([(124.584961,-12.768946), (126.738281,-17.224758)])
    +line2 = GI.Line([(123.354492,-15.961329), (127.22168,-14.008696)])
    +inter_points = GO.intersection(line1, line2; target = GI.PointTrait())
    +GI.coordinates.(inter_points)

    output

    julia
    1-element Vector{Vector{Float64}}:
    + [125.58375366067548, -14.83572303404496]
    +```
    +"""
    +function intersection(
    +    geom_a, geom_b, ::Type{T}=Float64; target=nothing, kwargs...,
    +) where {T<:AbstractFloat}
    +    return _intersection(
    +        TraitTarget(target), T, GI.trait(geom_a), geom_a, GI.trait(geom_b), geom_b;
    +        exact = _True(), kwargs...,
    +    )
    +end

    Curve-Curve Intersections with target Point

    julia
    _intersection(
    +    ::TraitTarget{GI.PointTrait}, ::Type{T},
    +    trait_a::Union{GI.LineTrait, GI.LineStringTrait, GI.LinearRingTrait}, geom_a,
    +    trait_b::Union{GI.LineTrait, GI.LineStringTrait, GI.LinearRingTrait}, geom_b;
    +    kwargs...,
    +) where T = _intersection_points(T, trait_a, geom_a, trait_b, geom_b)
    +
    +#= Polygon-Polygon Intersections with target Polygon
    +The algorithm to determine the intersection was adapted from "Efficient clipping
    +of efficient polygons," by Greiner and Hormann (1998).
    +DOI: https://doi.org/10.1145/274363.274364 =#
    +function _intersection(
    +    ::TraitTarget{GI.PolygonTrait}, ::Type{T},
    +    ::GI.PolygonTrait, poly_a,
    +    ::GI.PolygonTrait, poly_b;
    +    exact, kwargs...,
    +) where {T}

    First we get the exteriors of 'poly_a' and 'poly_b'

    julia
        ext_a = GI.getexterior(poly_a)
    +    ext_b = GI.getexterior(poly_b)

    Then we find the intersection of the exteriors

    julia
        a_list, b_list, a_idx_list = _build_ab_list(T, ext_a, ext_b, _inter_delay_cross_f, _inter_delay_bounce_f; exact)
    +    polys = _trace_polynodes(T, a_list, b_list, a_idx_list, _inter_step, poly_a, poly_b)
    +    if isempty(polys) # no crossing points, determine if either poly is inside the other
    +        a_in_b, b_in_a = _find_non_cross_orientation(a_list, b_list, ext_a, ext_b; exact)
    +        if a_in_b
    +            push!(polys, GI.Polygon([tuples(ext_a)]))
    +        elseif b_in_a
    +            push!(polys, GI.Polygon([tuples(ext_b)]))
    +        end
    +    end
    +    remove_idx = falses(length(polys))

    If the original polygons had holes, take that into account.

    julia
        if GI.nhole(poly_a) != 0 || GI.nhole(poly_b) != 0
    +        hole_iterator = Iterators.flatten((GI.gethole(poly_a), GI.gethole(poly_b)))
    +        _add_holes_to_polys!(T, polys, hole_iterator, remove_idx; exact)
    +    end

    Remove unneeded collinear points on same edge

    julia
        _remove_collinear_points!(polys, remove_idx, poly_a, poly_b)
    +    return polys
    +end

    Helper functions for Intersections with Greiner and Hormann Polygon Clipping

    julia
    #= When marking the crossing status of a delayed crossing, the chain start point is bouncing
    +when the start point is a entry point and is a crossing point when the start point is an
    +exit point. The end of the chain has the opposite crossing / bouncing status. x is the
    +entry/exit status. =#
    +_inter_delay_cross_f(x) = (!x, x)
    +#= When marking the crossing status of a delayed bouncing, the chain start and end points
    +are crossing if the current polygon's adjacent edges are within the non-tracing polygon. If
    +the edges are outside then the chain endpoints are marked as bouncing. x is a boolean
    +representing if the edges are inside or outside of the polygon. =#
    +_inter_delay_bounce_f(x, _) = x
    +#= When tracing polygons, step forward if the most recent intersection point was an entry
    +point, else step backwards where x is the entry/exit status. =#
    +_inter_step(x, _) =  x ? 1 : (-1)
    +
    +#= Polygon with multipolygon intersection - note that all intersection regions between
    +`poly_a` and any of the sub-polygons of `multipoly_b` are counted as intersection polygons.
    +Unless specified with `fix_multipoly = nothing`, `multipolygon_b` will be validated using
    +the given (default is `UnionIntersectingPolygons()`) correction. =#
    +function _intersection(
    +    target::TraitTarget{GI.PolygonTrait}, ::Type{T},
    +    ::GI.PolygonTrait, poly_a,
    +    ::GI.MultiPolygonTrait, multipoly_b;
    +    fix_multipoly = UnionIntersectingPolygons(), kwargs...,
    +) where T
    +    if !isnothing(fix_multipoly) # Fix multipoly_b to prevent duplicated intersection regions
    +        multipoly_b = fix_multipoly(multipoly_b)
    +    end
    +    polys = Vector{_get_poly_type(T)}()
    +    for poly_b in GI.getpolygon(multipoly_b)
    +        append!(polys, intersection(poly_a, poly_b; target))
    +    end
    +    return polys
    +end
    +
    +#= Multipolygon with polygon intersection is equivalent to taking the intersection of the
    +polygon with the multipolygon and thus simply switches the order of operations and calls the
    +above method. =#
    +_intersection(
    +    target::TraitTarget{GI.PolygonTrait}, ::Type{T},
    +    ::GI.MultiPolygonTrait, multipoly_a,
    +    ::GI.PolygonTrait, poly_b;
    +    kwargs...,
    +) where T = intersection(poly_b, multipoly_a; target , kwargs...)
    +
    +#= Multipolygon with multipolygon intersection - note that all intersection regions between
    +any sub-polygons of `multipoly_a` and any of the sub-polygons of `multipoly_b` are counted
    +as intersection polygons. Unless specified with `fix_multipoly = nothing`, both
    +`multipolygon_a` and `multipolygon_b` will be validated using the given (default is
    +`UnionIntersectingPolygons()`) correction. =#
    +function _intersection(
    +    target::TraitTarget{GI.PolygonTrait}, ::Type{T},
    +    ::GI.MultiPolygonTrait, multipoly_a,
    +    ::GI.MultiPolygonTrait, multipoly_b;
    +    fix_multipoly = UnionIntersectingPolygons(), kwargs...,
    +) where T
    +    if !isnothing(fix_multipoly) # Fix both multipolygons to prevent duplicated regions
    +        multipoly_a = fix_multipoly(multipoly_a)
    +        multipoly_b = fix_multipoly(multipoly_b)
    +        fix_multipoly = nothing
    +    end
    +    polys = Vector{_get_poly_type(T)}()
    +    for poly_a in GI.getpolygon(multipoly_a)
    +        append!(polys, intersection(poly_a, multipoly_b; target, fix_multipoly))
    +    end
    +    return polys
    +end

    Many type and target combos aren't implemented

    julia
    function _intersection(
    +    ::TraitTarget{Target}, ::Type{T},
    +    trait_a::GI.AbstractTrait, geom_a,
    +    trait_b::GI.AbstractTrait, geom_b;
    +    kwargs...,
    +) where {Target, T}
    +    @assert(
    +        false,
    +        "Intersection between $trait_a and $trait_b with target $Target isn't implemented yet.",
    +    )
    +    return nothing
    +end
    +
    +"""
    +    intersection_points(geom_a, geom_b, [T::Type])
    +
    +Return a list of intersection tuple points between two geometries. If no intersection points
    +exist, returns an empty list.
    +
    +# Example
    +
    +```jldoctest
    +import GeoInterface as GI, GeometryOps as GO
    +
    +line1 = GI.Line([(124.584961,-12.768946), (126.738281,-17.224758)])
    +line2 = GI.Line([(123.354492,-15.961329), (127.22168,-14.008696)])
    +inter_points = GO.intersection_points(line1, line2)

    output

    julia
    1-element Vector{Tuple{Float64, Float64}}:
    + (125.58375366067548, -14.83572303404496)
    +"""
    +intersection_points(geom_a, geom_b, ::Type{T} = Float64) where T <: AbstractFloat =
    +    _intersection_points(T, GI.trait(geom_a), geom_a, GI.trait(geom_b), geom_b)
    +
    +
    +#= Calculates the list of intersection points between two geometries, including line
    +segments, line strings, linear rings, polygons, and multipolygons. =#
    +function _intersection_points(::Type{T}, ::GI.AbstractTrait, a, ::GI.AbstractTrait, b; exact = _True()) where T

    Initialize an empty list of points

    julia
        result = Tuple{T, T}[]

    Check if the geometries extents even overlap

    julia
        Extents.intersects(GI.extent(a), GI.extent(b)) || return result

    Create a list of edges from the two input geometries

    julia
        edges_a, edges_b = map(sort!  to_edges, (a, b))

    Loop over pairs of edges and add any unique intersection points to results

    julia
        for a_edge in edges_a, b_edge in edges_b
    +        line_orient, intr1, intr2 = _intersection_point(T, a_edge, b_edge; exact)
    +        line_orient == line_out && continue  # no intersection points
    +        pt1, _ = intr1
    +        push!(result, pt1)  # if not line_out, there is at least one intersection point
    +        if line_orient == line_over # if line_over, there are two intersection points
    +            pt2, _ = intr2
    +            push!(result, pt2)
    +        end
    +    end
    +    #= TODO: We might be able to just add unique points with checks on the α and β values
    +    returned from `_intersection_point`, but this would be different for curves vs polygons
    +    vs multipolygons depending on if the shape is closed. This then wouldn't allow using the
    +    `to_edges` functionality.  =#
    +    unique!(sort!(result))
    +    return result
    +end
    +
    +#= Calculates the intersection points between two lines if they exists and the fractional
    +component of each line from the initial end point to the intersection point where α is the
    +fraction along (a1, a2) and β is the fraction along (b1, b2).
    +
    +Note that the first return is the type of intersection (line_cross, line_hinge, line_over,
    +or line_out). The type of intersection determines how many intersection points there are.
    +If the intersection is line_out, then there are no intersection points and the two
    +intersections aren't valid and shouldn't be used. If the intersection is line_cross or
    +line_hinge then the lines meet at one point and the first intersection is valid, while the
    +second isn't. Finally, if the intersection is line_over, then both points are valid and they
    +are the two points that define the endpoints of the overlapping region between the two
    +lines.
    +
    +Also note again that each intersection is a tuple of two tuples. The first is the
    +intersection point (x,y) while the second is the ratio along the initial lines (α, β) for
    +that point.
    +
    +Calculation derivation can be found here: https://stackoverflow.com/questions/563198/ =#
    +function _intersection_point(::Type{T}, (a1, a2)::Edge, (b1, b2)::Edge; exact) where T

    Default answer for no intersection

    julia
        line_orient = line_out
    +    intr1 = ((zero(T), zero(T)), (zero(T), zero(T)))
    +    intr2 = intr1
    +    no_intr_result = (line_orient, intr1, intr2)

    Seperate out line segment points

    julia
        (a1x, a1y), (a2x, a2y) = _tuple_point(a1, T), _tuple_point(a2, T)
    +    (b1x, b1y), (b2x, b2y) = _tuple_point(b1, T), _tuple_point(b2, T)

    Check if envelopes of lines intersect

    julia
        a_ext = Extent(X = minmax(a1x, a2x), Y = minmax(a1y, a2y))
    +    b_ext = Extent(X = minmax(b1x, b2x), Y = minmax(b1y, b2y))
    +    !Extents.intersects(a_ext, b_ext) && return no_intr_result

    Check orientation of two line segments with respect to one another

    julia
        a1_orient = Predicates.orient(b1, b2, a1; exact)
    +    a2_orient = Predicates.orient(b1, b2, a2; exact)
    +    a1_orient != 0 && a1_orient == a2_orient && return no_intr_result  # α < 0 or α > 1
    +    b1_orient = Predicates.orient(a1, a2, b1; exact)
    +    b2_orient = Predicates.orient(a1, a2, b2; exact)
    +    b1_orient != 0 && b1_orient == b2_orient && return no_intr_result  # β < 0 or β > 1

    Determine intersection type and intersection point(s)

    julia
        if a1_orient == a2_orient == b1_orient == b2_orient == 0

    Intersection is collinear if all endpoints lie on the same line

    julia
            line_orient, intr1, intr2 = _find_collinear_intersection(T, a1, a2, b1, b2, a_ext, b_ext, no_intr_result)
    +    elseif a1_orient == 0 || a2_orient == 0 || b1_orient == 0 || b2_orient == 0

    Intersection is a hinge if the intersection point is an endpoint

    julia
            line_orient = line_hinge
    +        intr1 = _find_hinge_intersection(T, a1, a2, b1, b2, a1_orient, a2_orient, b1_orient)
    +    else

    Intersection is a cross if there is only one non-endpoint intersection point

    julia
            line_orient = line_cross
    +        intr1 = _find_cross_intersection(T, a1, a2, b1, b2, a_ext, b_ext)
    +    end
    +    return line_orient, intr1, intr2
    +end
    +
    +#= If lines defined by (a1, a2) and (b1, b2) are collinear, find endpoints of overlapping
    +region if they exist. This could result in three possibilities. First, there could be no
    +overlapping region, in which case, the default 'no_intr_result' intersection information is
    +returned. Second, the two regions could just meet at one shared endpoint, in which case it
    +is a hinge intersection with one intersection point. Otherwise, it is a overlapping
    +intersection defined by two of the endpoints of the line segments. =#
    +function _find_collinear_intersection(::Type{T}, a1, a2, b1, b2, a_ext, b_ext, no_intr_result) where T

    Define default return for no intersection points

    julia
        line_orient, intr1, intr2 = no_intr_result

    Determine collinear line overlaps

    julia
        a1_in_b = _point_in_extent(a1, b_ext)
    +    a2_in_b = _point_in_extent(a2, b_ext)
    +    b1_in_a = _point_in_extent(b1, a_ext)
    +    b2_in_a = _point_in_extent(b2, a_ext)

    Determine line distances

    julia
        a_dist, b_dist = distance(a1, a2, T), distance(b1, b2, T)

    Set collinear intersection points if they exist

    julia
        if a1_in_b && a2_in_b      # 1st vertex of a and 2nd vertex of a form overlap
    +        line_orient = line_over
    +        β1 = _clamped_frac(distance(a1, b1, T), b_dist)
    +        β2 = _clamped_frac(distance(a2, b1, T), b_dist)
    +        intr1 = (_tuple_point(a1, T), (zero(T), β1))
    +        intr2 = (_tuple_point(a2, T), (one(T), β2))
    +    elseif b1_in_a && b2_in_a  # 1st vertex of b and 2nd vertex of b form overlap
    +        line_orient = line_over
    +        α1 = _clamped_frac(distance(b1, a1, T), a_dist)
    +        α2 = _clamped_frac(distance(b2, a1, T), a_dist)
    +        intr1 = (_tuple_point(b1, T), (α1, zero(T)))
    +        intr2 = (_tuple_point(b2, T), (α2, one(T)))
    +    elseif a1_in_b && b1_in_a  # 1st vertex of a and 1st vertex of b form overlap
    +        if equals(a1, b1)
    +            line_orient = line_hinge
    +            intr1 = (_tuple_point(a1, T), (zero(T), zero(T)))
    +        else
    +            line_orient = line_over
    +            intr1, intr2 = _set_ab_collinear_intrs(T, a1, b1, zero(T), zero(T), a1, b1, a_dist, b_dist)
    +        end
    +    elseif a1_in_b && b2_in_a  # 1st vertex of a and 2nd vertex of b form overlap
    +        if equals(a1, b2)
    +            line_orient = line_hinge
    +            intr1 = (_tuple_point(a1, T), (zero(T), one(T)))
    +        else
    +            line_orient = line_over
    +            intr1, intr2 = _set_ab_collinear_intrs(T, a1, b2, zero(T), one(T), a1, b1, a_dist, b_dist)
    +        end
    +    elseif a2_in_b && b1_in_a  # 2nd vertex of a and 1st vertex of b form overlap
    +        if equals(a2, b1)
    +            line_orient = line_hinge
    +            intr1 = (_tuple_point(a2, T), (one(T), zero(T)))
    +        else
    +            line_orient = line_over
    +            intr1, intr2 = _set_ab_collinear_intrs(T, a2, b1, one(T), zero(T), a1, b1, a_dist, b_dist)
    +        end
    +    elseif a2_in_b && b2_in_a  # 2nd vertex of a and 2nd vertex of b form overlap
    +        if equals(a2, b2)
    +            line_orient = line_hinge
    +            intr1 = (_tuple_point(a2, T), (one(T), one(T)))
    +        else
    +            line_orient = line_over
    +            intr1, intr2 = _set_ab_collinear_intrs(T, a2, b2, one(T), one(T), a1, b1, a_dist, b_dist)
    +        end
    +    end
    +    return line_orient, intr1, intr2
    +end
    +
    +#= Determine intersection points and segment fractions when overlap is made up one one
    +endpoint of segment (a1, a2) and one endpoint of segment (b1, b2). =#
    +_set_ab_collinear_intrs(::Type{T}, a_pt, b_pt, a_pt_α, b_pt_β, a1, b1, a_dist, b_dist) where T =
    +    (
    +        (_tuple_point(a_pt, T), (a_pt_α, _clamped_frac(distance(a_pt, b1, T), b_dist))),
    +        (_tuple_point(b_pt, T), (_clamped_frac(distance(b_pt, a1, T), a_dist), b_pt_β))
    +    )
    +
    +#= If lines defined by (a1, a2) and (b1, b2) are just touching at one of those endpoints and
    +are not collinear, then they form a hinge, with just that one shared intersection point.
    +Point equality is checked before segment orientation to have maximal accurary on fractions
    +to avoid floating point errors. If the points are not equal, we know that the hinge does not
    +take place at an endpoint and the fractions must be between 0 or 1 (exclusive). =#
    +function _find_hinge_intersection(::Type{T}, a1, a2, b1, b2, a1_orient, a2_orient, b1_orient) where T
    +    pt, α, β = if equals(a1, b1)
    +        _tuple_point(a1, T), zero(T), zero(T)
    +    elseif equals(a1, b2)
    +        _tuple_point(a1, T), zero(T), one(T)
    +    elseif equals(a2, b1)
    +        _tuple_point(a2, T), one(T), zero(T)
    +    elseif equals(a2, b2)
    +        _tuple_point(a2, T), one(T), one(T)
    +    elseif a1_orient == 0
    +        β_val = _clamped_frac(distance(b1, a1, T), distance(b1, b2, T), eps(T))
    +        _tuple_point(a1, T), zero(T), β_val
    +    elseif a2_orient == 0
    +        β_val = _clamped_frac(distance(b1, a2, T), distance(b1, b2, T), eps(T))
    +        _tuple_point(a2, T), one(T), β_val
    +    elseif b1_orient == 0
    +        α_val = _clamped_frac(distance(a1, b1, T), distance(a1, a2, T), eps(T))
    +        _tuple_point(b1, T), α_val, zero(T)
    +    else  # b2_orient == 0
    +        α_val = _clamped_frac(distance(a1, b2, T), distance(a1, a2, T), eps(T))
    +        _tuple_point(b2, T), α_val, one(T)
    +    end
    +    return pt, (α, β)
    +end
    +
    +#= If lines defined by (a1, a2) and (b1, b2) meet at one point that is not an endpoint of
    +either segment, they form a crossing intersection with a singular intersection point. That
    +point is calculated by finding the fractional distance along each segment the point occurs
    +at (α, β). If the point is too close to an endpoint to be distinct, the point shares a value
    +with the endpoint, but with a non-zero and non-one fractional value. If the intersection
    +point calculated is outside of the envelope of the two segments due to floating point error,
    +it is set to the endpoint of the two segments that is closest to the other segment.
    +Regardless of point value, we know that it does not actually occur at an endpoint so the
    +fractions must be between 0 or 1 (exclusive). =#
    +function _find_cross_intersection(::Type{T}, a1, a2, b1, b2, a_ext, b_ext) where T

    First line runs from a to a + Δa

    julia
        (a1x, a1y), (a2x, a2y) = _tuple_point(a1, T), _tuple_point(a2, T)
    +    Δax, Δay = a2x - a1x, a2y - a1y

    Second line runs from b to b + Δb

    julia
        (b1x, b1y), (b2x, b2y) = _tuple_point(b1, T), _tuple_point(b2, T)
    +    Δbx, Δby = b2x - b1x, b2y - b1y

    Differences between starting points

    julia
        Δbax = b1x - a1x
    +    Δbay = b1y - a1y
    +    a_cross_b = Δax * Δby - Δay * Δbx

    Determine α value where 0 < α < 1 and β value where 0 < β < 1

    julia
        α = _clamped_frac(Δbax * Δby - Δbay * Δbx, a_cross_b, eps(T))
    +    β = _clamped_frac(Δbax * Δay - Δbay * Δax, a_cross_b, eps(T))
    +
    +    #= Intersection will be where a1 + α * Δa = b1 + β * Δb. However, due to floating point
    +    inaccuracies, α and β calculations may yield different intersection points. Average
    +    both points together to minimize difference from real value, as long as segment isn't
    +    vertical or horizontal as this will almost certainly lead to the point being outside the
    +    envelope due to floating point error. Also note that floating point limitations could
    +    make intersection be endpoint if α≈0 or α≈1.=#
    +    x = if Δax == 0
    +        a1x
    +    elseif Δbx == 0
    +        b1x
    +    else
    +        (a1x + α * Δax + b1x + β * Δbx) / 2
    +    end
    +    y = if Δay == 0
    +        a1y
    +    elseif Δby == 0
    +        b1y
    +    else
    +        (a1y + α * Δay + b1y + β * Δby) / 2
    +    end
    +    pt = (x, y)

    Check if point is within segment envelopes and adjust to endpoint if not

    julia
        if !_point_in_extent(pt, a_ext) || !_point_in_extent(pt, b_ext)
    +        pt, α, β = _nearest_endpoint(T, a1, a2, b1, b2)
    +    end
    +    return (pt, (α, β))
    +end

    Find endpoint of either segment that is closest to the opposite segment

    julia
    function _nearest_endpoint(::Type{T}, a1, a2, b1, b2) where T

    Create lines from segments and calculate segment length

    julia
        a_line, a_dist = GI.Line(StaticArrays.SVector(a1, a2)), distance(a1, a2, T)
    +    b_line, b_dist = GI.Line(StaticArrays.SVector(b1, b2)), distance(b1, b2, T)

    Determine distance from a1 to segment b

    julia
        min_pt, min_dist = a1, distance(a1, b_line, T)
    +    α, β = eps(T), _clamped_frac(distance(min_pt, b1, T), b_dist, eps(T))

    Determine distance from a2 to segment b

    julia
        dist = distance(a2, b_line, T)
    +    if dist < min_dist
    +        min_pt, min_dist = a2, dist
    +        α, β = one(T) - eps(T), _clamped_frac(distance(min_pt, b1, T), b_dist, eps(T))
    +    end

    Determine distance from b1 to segment a

    julia
        dist = distance(b1, a_line, T)
    +    if dist < min_dist
    +        min_pt, min_dist = b1, dist
    +        α, β = _clamped_frac(distance(min_pt, a1, T), a_dist, eps(T)), eps(T)
    +    end

    Determine distance from b2 to segment a

    julia
        dist = distance(b2, a_line, T)
    +    if dist < min_dist
    +        min_pt, min_dist = b2, dist
    +        α, β = _clamped_frac(distance(min_pt, a2, T), a_dist, eps(T)), one(T) - eps(T)
    +    end

    Return point with smallest distance

    julia
        return _tuple_point(min_pt, T), α, β
    +end

    Return value of x/y clamped between ϵ and 1 - ϵ

    julia
    _clamped_frac(x::T, y::T, ϵ = zero(T)) where T = clamp(x / y, ϵ, one(T) - ϵ)

    This page was generated using Literate.jl.

    + + + + \ No newline at end of file diff --git a/previews/PR237/source/methods/clipping/predicates.html b/previews/PR237/source/methods/clipping/predicates.html new file mode 100644 index 000000000..28b132e90 --- /dev/null +++ b/previews/PR237/source/methods/clipping/predicates.html @@ -0,0 +1,68 @@ + + + + + + If we want to inject adaptivity, we would do something like: | GeometryOps.jl + + + + + + + + + + + + + + +
    Skip to content
    julia
    module Predicates
    +    using ExactPredicates, ExactPredicates.Codegen
    +    import ExactPredicates: ext
    +    import ExactPredicates.Codegen: group!, @genpredicate
    +    import GeometryOps: _False, _True, _booltype, _tuple_point
    +    import GeoInterface as GI
    +
    +    #= Determine the orientation of c with regards to the oriented segment (a, b).
    +    Return 1 if c is to the left of (a, b).
    +    Return -1 if c is to the right of (a, b).
    +    Return 0 if c is on (a, b) or if a == b. =#
    +    orient(a, b, c; exact) = _orient(_booltype(exact), a, b, c)

    If exact is true, use ExactPredicates to calculate the orientation.

    julia
        _orient(::_True, a, b, c) = ExactPredicates.orient(_tuple_point(a, Float64), _tuple_point(b, Float64), _tuple_point(c, Float64))

    If exact is false, calculate the orientation without using ExactPredicates.

    julia
        function _orient(exact::_False, a, b, c)
    +        a = a .- c
    +        b = b .- c
    +        return _cross(exact, a, b)
    +    end
    +
    +    #= Determine the sign of the cross product of a and b.
    +    Return 1 if the cross product is positive.
    +    Return -1 if the cross product is negative.
    +    Return 0 if the cross product is 0. =#
    +    cross(a, b; exact) = _cross(_booltype(exact), a, b)
    +
    +    #= If `exact` is `true`, use exact cross product calculation created using
    +    `ExactPredicates`generated predicate. Note that as of now `ExactPredicates` requires
    +    Float64 so we must convert points a and b. =#
    +    _cross(::_True, a, b) = _cross_exact(_tuple_point(a, Float64), _tuple_point(b, Float64))

    Exact cross product calculation using ExactPredicates.

    julia
        @genpredicate function _cross_exact(a :: 2, b :: 2)
    +        group!(a...)
    +        group!(b...)
    +        ext(a, b)
    +    end

    If exact is false, calculate the cross product without using ExactPredicates.

    julia
        function _cross(::_False, a, b)
    +        c_t1 = GI.x(a) * GI.y(b)
    +        c_t2 = GI.y(a) * GI.x(b)
    +        c_val = if isapprox(c_t1, c_t2)
    +            0
    +        else
    +            sign(c_t1 - c_t2)
    +        end
    +        return c_val
    +    end
    +
    +end
    +
    +import .Predicates

    If we want to inject adaptivity, we would do something like:

    function cross(a, b, c) # try Predicates._cross_naive(a, b, c) # check the error bound there # then try Predicates._cross_adaptive(a, b, c) # then try Predicates._cross_exact end


    This page was generated using Literate.jl.

    + + + + \ No newline at end of file diff --git a/previews/PR237/source/methods/clipping/union.html b/previews/PR237/source/methods/clipping/union.html new file mode 100644 index 000000000..a877970c5 --- /dev/null +++ b/previews/PR237/source/methods/clipping/union.html @@ -0,0 +1,275 @@ + + + + + + Union Polygon Clipping | GeometryOps.jl + + + + + + + + + + + + + + +
    Skip to content

    Union Polygon Clipping

    julia
    export union
    +
    +"""
    +    union(geom_a, geom_b, [::Type{T}]; target::Type, fix_multipoly = UnionIntersectingPolygons())
    +
    +Return the union between two geometries as a list of geometries. Return an empty list if
    +none are found. The type of the list will be constrained as much as possible given the input
    +geometries. Furthermore, the user can provide a `taget` type as a keyword argument and a
    +list of target geometries found in the difference will be returned. The user can also
    +provide a float type 'T' that they would like the points of returned geometries to be. If
    +the user is taking a intersection involving one or more multipolygons, and the multipolygon
    +might be comprised of polygons that intersect, if `fix_multipoly` is set to an
    +`IntersectingPolygons` correction (the default is `UnionIntersectingPolygons()`), then the
    +needed multipolygons will be fixed to be valid before performing the intersection to ensure
    +a correct answer. Only set `fix_multipoly` to false if you know that the multipolygons are
    +valid, as it will avoid unneeded computation.
    +
    +Calculates the union between two polygons.
    +# Example
    +
    +```jldoctest
    +import GeoInterface as GI, GeometryOps as GO
    +
    +p1 = GI.Polygon([[(0.0, 0.0), (5.0, 5.0), (10.0, 0.0), (5.0, -5.0), (0.0, 0.0)]])
    +p2 = GI.Polygon([[(3.0, 0.0), (8.0, 5.0), (13.0, 0.0), (8.0, -5.0), (3.0, 0.0)]])
    +union_poly = GO.union(p1, p2; target = GI.PolygonTrait())
    +GI.coordinates.(union_poly)

    output

    julia
    1-element Vector{Vector{Vector{Vector{Float64}}}}:
    + [[[6.5, 3.5], [5.0, 5.0], [0.0, 0.0], [5.0, -5.0], [6.5, -3.5], [8.0, -5.0], [13.0, 0.0], [8.0, 5.0], [6.5, 3.5]]]
    +```
    +"""
    +function union(
    +    geom_a, geom_b, ::Type{T}=Float64; target=nothing, kwargs...
    +) where {T<:AbstractFloat}
    +    return _union(
    +        TraitTarget(target), T, GI.trait(geom_a), geom_a, GI.trait(geom_b), geom_b;
    +        exact = _True(), kwargs...,
    +    )
    +end
    +
    +#= This 'union' implementation returns the union of two polygons. The algorithm to determine
    +the union was adapted from "Efficient clipping of efficient polygons," by Greiner and
    +Hormann (1998). DOI: https://doi.org/10.1145/274363.274364 =#
    +function _union(
    +    ::TraitTarget{GI.PolygonTrait}, ::Type{T},
    +    ::GI.PolygonTrait, poly_a,
    +    ::GI.PolygonTrait, poly_b;
    +    exact, kwargs...,
    +) where T

    First, I get the exteriors of the two polygons

    julia
        ext_a = GI.getexterior(poly_a)
    +    ext_b = GI.getexterior(poly_b)

    Then, I get the union of the exteriors

    julia
        a_list, b_list, a_idx_list = _build_ab_list(T, ext_a, ext_b, _union_delay_cross_f, _union_delay_bounce_f; exact)
    +    polys = _trace_polynodes(T, a_list, b_list, a_idx_list, _union_step, poly_a, poly_b)
    +    n_pieces = length(polys)

    Check if one polygon totally within other and if so, return the larger polygon

    julia
        a_in_b, b_in_a = false, false
    +    if n_pieces == 0 # no crossing points, determine if either poly is inside the other
    +        a_in_b, b_in_a = _find_non_cross_orientation(a_list, b_list, ext_a, ext_b; exact)
    +        if a_in_b
    +            push!(polys, GI.Polygon([_linearring(tuples(ext_b))]))
    +        elseif b_in_a
    +            push!(polys,  GI.Polygon([_linearring(tuples(ext_a))]))
    +        else
    +            push!(polys, tuples(poly_a))
    +            push!(polys, tuples(poly_b))
    +            return polys
    +        end
    +    elseif n_pieces > 1
    +        #= extra polygons are holes (n_pieces == 1 is the desired state) and since
    +        holes are formed by regions exterior to both poly_a and poly_b, they can't interact
    +        with pre-existing holes =#
    +        sort!(polys, by = area, rev = true)  # sort by area so first element is the exterior

    the first element is the exterior, the rest are holes

    julia
            @views append!(polys[1].geom, (GI.getexterior(p) for p in polys[2:end]))
    +        keepat!(polys, 1)
    +    end

    Add in holes

    julia
        if GI.nhole(poly_a) != 0 || GI.nhole(poly_b) != 0
    +        _add_union_holes!(polys, a_in_b, b_in_a, poly_a, poly_b; exact)
    +    end

    Remove unneeded collinear points on same edge

    julia
        _remove_collinear_points!(polys, [false], poly_a, poly_b)
    +    return polys
    +end

    Helper functions for Unions with Greiner and Hormann Polygon Clipping

    julia
    #= When marking the crossing status of a delayed crossing, the chain start point is crossing
    +when the start point is a entry point and is a bouncing point when the start point is an
    +exit point. The end of the chain has the opposite crossing / bouncing status. =#
    +_union_delay_cross_f(x) = (x, !x)
    +
    +#= When marking the crossing status of a delayed bouncing, the chain start and end points
    +are bouncing if the current polygon's adjacent edges are within the non-tracing polygon. If
    +the edges are outside then the chain endpoints are marked as crossing. x is a boolean
    +representing if the edges are inside or outside of the polygon. =#
    +_union_delay_bounce_f(x, _) = !x
    +
    +#= When tracing polygons, step backwards if the most recent intersection point was an entry
    +point, else step forwards where x is the entry/exit status. =#
    +_union_step(x, _) = x ? (-1) : 1
    +
    +#= Add holes from two polygons to the exterior polygon formed by their union. If adding the
    +the holes reveals that the polygons aren't actually intersecting, return the original
    +polygons. =#
    +function _add_union_holes!(polys, a_in_b, b_in_a, poly_a, poly_b; exact)
    +    if a_in_b
    +        _add_union_holes_contained_polys!(polys, poly_a, poly_b; exact)
    +    elseif b_in_a
    +        _add_union_holes_contained_polys!(polys, poly_b, poly_a; exact)
    +    else  # Polygons intersect, but neither is contained in the other
    +        n_a_holes = GI.nhole(poly_a)
    +        ext_poly_a = GI.Polygon(StaticArrays.SVector(GI.getexterior(poly_a)))
    +        ext_poly_b = GI.Polygon(StaticArrays.SVector(GI.getexterior(poly_b)))
    +        #= Start with poly_b when comparing with holes from poly_a and then switch to poly_a
    +        to compare with holes from poly_b. For current_poly, use ext_poly_b to avoid
    +        repeating overlapping holes in poly_a and poly_b =#
    +        curr_exterior_poly = n_a_holes > 0 ? ext_poly_b : ext_poly_a
    +        current_poly = n_a_holes > 0 ? ext_poly_b : poly_a

    Loop over all holes in both original polygons

    julia
            for (i, ih) in enumerate(Iterators.flatten((GI.gethole(poly_a), GI.gethole(poly_b))))
    +            ih = _linearring(ih)
    +            in_ext, _, _ = _line_polygon_interactions(ih, curr_exterior_poly; exact, closed_line = true)
    +            if !in_ext
    +                #= if the hole isn't in the overlapping region between the two polygons, add
    +                the hole to the resulting polygon as we know it can't interact with any
    +                other holes =#
    +                push!(polys[1].geom, ih)
    +            else
    +                #= if the hole is at least partially in the overlapping region, take the
    +                difference of the hole from the polygon it didn't originate from - note that
    +                when current_poly is poly_a this includes poly_a holes so overlapping holes
    +                between poly_a and poly_b within the overlap are added, in addition to all
    +                holes in non-overlapping regions =#
    +                h_poly = GI.Polygon(StaticArrays.SVector(ih))
    +                new_holes = difference(h_poly, current_poly; target = GI.PolygonTrait())
    +                append!(polys[1].geom, (GI.getexterior(new_h) for new_h in new_holes))
    +            end
    +            if i == n_a_holes
    +                curr_exterior_poly = ext_poly_a
    +                current_poly = poly_a
    +            end
    +        end
    +    end
    +    return
    +end
    +
    +#= Add holes holes to the union of two polygons where one of the original polygons was
    +inside of the other. If adding the the holes reveal that the polygons aren't actually
    +intersecting, return the original polygons.=#
    +function _add_union_holes_contained_polys!(polys, interior_poly, exterior_poly; exact)
    +    union_poly = polys[1]
    +    ext_int_ring = GI.getexterior(interior_poly)
    +    for (i, ih) in enumerate(GI.gethole(exterior_poly))
    +        poly_ih = GI.Polygon(StaticArrays.SVector(ih))
    +        in_ih, on_ih, out_ih = _line_polygon_interactions(ext_int_ring, poly_ih; exact, closed_line = true)
    +        if in_ih  # at least part of interior polygon exterior is within the ith hole
    +            if !on_ih && !out_ih
    +                #= interior polygon is completely within the ith hole - polygons aren't
    +                touching and do not actually form a union =#
    +                polys[1] = tuples(interior_poly)
    +                push!(polys, tuples(exterior_poly))
    +                return polys
    +            else
    +                #= interior polygon is partially within the ith hole - area of interior
    +                polygon reduces the size of the hole =#
    +                new_holes = difference(poly_ih, interior_poly; target = GI.PolygonTrait())
    +                append!(union_poly.geom, (GI.getexterior(new_h) for new_h in new_holes))
    +            end
    +        else  # none of interior polygon exterior is within the ith hole
    +            if !out_ih
    +                #= interior polygon's exterior is the same as the ith hole - polygons do
    +                form a union, but do not overlap so all holes stay in final polygon =#
    +                append!(union_poly.geom, Iterators.drop(GI.gethole(exterior_poly), i))
    +                append!(union_poly.geom, GI.gethole(interior_poly))
    +                return polys
    +            else
    +                #= interior polygon's exterior is outside of the ith hole - the interior
    +                polygon could either be disjoint from the hole, or contain the hole =#
    +                ext_int_poly = GI.Polygon(StaticArrays.SVector(ext_int_ring))
    +                in_int, _, _ = _line_polygon_interactions(ih, ext_int_poly; exact, closed_line = true)
    +                if in_int
    +                    #= interior polygon contains the hole - overlapping holes between the
    +                    interior and exterior polygons will be added =#
    +                    for jh in GI.gethole(interior_poly)
    +                        poly_jh = GI.Polygon(StaticArrays.SVector(jh))
    +                        if intersects(poly_ih, poly_jh)
    +                            new_holes = intersection(poly_ih, poly_jh; target = GI.PolygonTrait())
    +                            append!(union_poly.geom, (GI.getexterior(new_h) for new_h in new_holes))
    +                        end
    +                    end
    +                else
    +                    #= interior polygon and the exterior polygon are disjoint - add the ith
    +                    hole as it is not covered by the interior polygon =#
    +                    push!(union_poly.geom, ih)
    +                end
    +            end
    +        end
    +    end
    +    return
    +end
    +
    +#= Polygon with multipolygon union - note that all sub-polygons of `multipoly_b` will be
    +included, unioning these sub-polygons with `poly_a` where they intersect. Unless specified
    +with `fix_multipoly = nothing`, `multipolygon_b` will be validated using the given (default
    +is `UnionIntersectingPolygons()`) correction. =#
    +function _union(
    +    target::TraitTarget{GI.PolygonTrait}, ::Type{T},
    +    ::GI.PolygonTrait, poly_a,
    +    ::GI.MultiPolygonTrait, multipoly_b;
    +    fix_multipoly = UnionIntersectingPolygons(), kwargs...,
    +) where T
    +    if !isnothing(fix_multipoly) # Fix multipoly_b to prevent repeated regions in the output
    +        multipoly_b = fix_multipoly(multipoly_b)
    +    end
    +    polys = [tuples(poly_a, T)]
    +    for poly_b in GI.getpolygon(multipoly_b)
    +        if intersects(polys[1], poly_b)

    If polygons intersect and form a new polygon, swap out polygon

    julia
                new_polys = union(polys[1], poly_b; target)
    +            if length(new_polys) > 1 # case where they intersect by just one point
    +                push!(polys, tuples(poly_b, T))  # add poly_b to list
    +            else
    +                polys[1] = new_polys[1]
    +            end
    +        else

    If they don't intersect, poly_b is now a part of the union as its own polygon

    julia
                push!(polys, tuples(poly_b, T))
    +        end
    +    end
    +    return polys
    +end
    +
    +#= Multipolygon with polygon union is equivalent to taking the union of the polygon with the
    +multipolygon and thus simply switches the order of operations and calls the above method. =#
    +_union(
    +    target::TraitTarget{GI.PolygonTrait}, ::Type{T},
    +    ::GI.MultiPolygonTrait, multipoly_a,
    +    ::GI.PolygonTrait, poly_b;
    +    kwargs...,
    +) where T = union(poly_b, multipoly_a; target, kwargs...)
    +
    +#= Multipolygon with multipolygon union - note that all of the sub-polygons of `multipoly_a`
    +and the sub-polygons of `multipoly_b` are included and combined together where there are
    +intersections. Unless specified with `fix_multipoly = nothing`, `multipolygon_b` will be
    +validated using the given (default is `UnionIntersectingPolygons()`) correction. =#
    +function _union(
    +    target::TraitTarget{GI.PolygonTrait}, ::Type{T},
    +    ::GI.MultiPolygonTrait, multipoly_a,
    +    ::GI.MultiPolygonTrait, multipoly_b;
    +    fix_multipoly = UnionIntersectingPolygons(), kwargs...,
    +) where T
    +    if !isnothing(fix_multipoly) # Fix multipoly_b to prevent repeated regions in the output
    +        multipoly_b = fix_multipoly(multipoly_b)
    +        fix_multipoly = nothing
    +    end
    +    multipolys = multipoly_b
    +    local polys
    +    for poly_a in GI.getpolygon(multipoly_a)
    +        polys = union(poly_a, multipolys; target, fix_multipoly)
    +        multipolys = GI.MultiPolygon(polys)
    +    end
    +    return polys
    +end

    Many type and target combos aren't implemented

    julia
    function _union(
    +    ::TraitTarget{Target}, ::Type{T},
    +    trait_a::GI.AbstractTrait, geom_a,
    +    trait_b::GI.AbstractTrait, geom_b;
    +    kwargs...
    +) where {Target,T}
    +    throw(ArgumentError("Union between $trait_a and $trait_b with target $Target isn't implemented yet."))
    +    return nothing
    +end

    This page was generated using Literate.jl.

    + + + + \ No newline at end of file diff --git a/previews/PR237/source/methods/convex_hull.html b/previews/PR237/source/methods/convex_hull.html new file mode 100644 index 000000000..49e208602 --- /dev/null +++ b/previews/PR237/source/methods/convex_hull.html @@ -0,0 +1,81 @@ + + + + + + Convex hull | GeometryOps.jl + + + + + + + + + + + + + + +
    Skip to content

    Convex hull

    The convex hull of a set of points is the smallest convex polygon that contains all the points.

    GeometryOps.jl provides a number of methods for computing the convex hull of a set of points, usually linked to other Julia packages.

    For now, we expose one algorithm, MonotoneChainMethod, which uses the DelaunayTriangulation.jl package. The GEOS() interface also supports convex hulls.

    Future work could include other algorithms, such as Quickhull.jl, or similar, via package extensions.

    Example

    Simple hull

    julia
    import GeometryOps as GO, GeoInterface as GI
    +using CairoMakie # to plot
    +
    +points = randn(GO.Point2f, 100)
    +f, a, p = plot(points; label = "Points")
    +hull_poly = GO.convex_hull(points)
    +lines!(a, hull_poly; label = "Convex hull", color = Makie.wong_colors()[2])
    +axislegend(a)
    +f

    Convex hull of the USA

    julia
    import GeometryOps as GO, GeoInterface as GI
    +using CairoMakie # to plot
    +using NaturalEarth # for data
    +
    +all_adm0 = naturalearth("admin_0_countries", 110)
    +usa = all_adm0.geometry[findfirst(==("USA"), all_adm0.ADM0_A3)]
    +f, a, p = lines(usa)
    +lines!(a, GO.convex_hull(usa); color = Makie.wong_colors()[2])
    +f

    Investigating the winding order

    The winding order of the monotone chain method is counterclockwise, while the winding order of the GEOS method is clockwise.

    GeometryOps' convexity detection says that the GEOS hull is convex, while the monotone chain method hull is not. However, they are both going over the same points (we checked), it's just that the winding order is different.

    In reality, both sets are convex, but we need to fix the GeometryOps convexity detector (isconcave)!

    We may also decide at a later date to change the returned winding order of the polygon, but most algorithms are robust to that, and you can always fix it...

    julia
    import GeoInterface as GI, GeometryOps as GO, LibGEOS as LG
    +using CairoMakie # to plot
    +
    +points = rand(Point2{Float64}, 100)
    +go_hull = GO.convex_hull(GO.MonotoneChainMethod(), points)
    +lg_hull = GO.convex_hull(GO.GEOS(), points)
    +
    +fig = Figure()
    +a1, p1 = lines(fig[1, 1], go_hull; color = 1:GI.npoint(go_hull), axis = (; title = "MonotoneChainMethod()"))
    +a2, p2 = lines(fig[2, 1], lg_hull; color = 1:GI.npoint(lg_hull), axis = (; title = "GEOS()"))
    +cb = Colorbar(fig[1:2, 2], p1; label = "Vertex number")
    +fig

    Implementation

    julia
    """
    +    convex_hull([method], geometries)
    +
    +Compute the convex hull of the points in `geometries`.
    +Returns a `GI.Polygon` representing the convex hull.
    +
    +Note that the polygon returned is wound counterclockwise
    +as in the Simple Features standard by default.  If you
    +choose GEOS, the winding order will be inverted.
    +
    +!!! warning
    +    This interface only computes the 2-dimensional convex hull!
    +
    +    For higher dimensional hulls, use the relevant package (Qhull.jl, Quickhull.jl, or similar).
    +"""
    +function convex_hull end
    +
    +"""
    +    MonotoneChainMethod()
    +
    +This is an algorithm for the `convex_hull` function.
    +
    +Uses [`DelaunayTriangulation.jl`](https://github.com/JuliaGeometry/DelaunayTriangulation.jl) to compute the convex hull.
    +This is a pure Julia algorithm which provides an optimal Delaunay triangulation.
    +
    +See also `convex_hull`
    +"""
    +struct MonotoneChainMethod end

    GrahamScanMethod, etc. can be implemented in GO as well, if someone wants to. If we add an extension on Quickhull.jl, then that would be another algorithm.

    julia
    convex_hull(geometries) = convex_hull(MonotoneChainMethod(), geometries)

    TODO: have this respect the CRS by pulling it out of geometries.

    julia
    function convex_hull(::MonotoneChainMethod, geometries)

    Extract all points as tuples. We have to collect and allocate here, because DelaunayTriangulation only accepts vectors of point-like geoms.

    Cleanest would be to use the iterable from GO.flatten directly, but that would require us to implement the convex hull algorithm directly.

    TODO: create a specialized method that extracts only the information required, GeometryBasics points can be passed through directly.

    julia
        points = collect(flatten(tuples, GI.PointTrait, geometries))

    Compute the convex hull using DelTri (shorthand for DelaunayTriangulation.jl).

    julia
        hull = DelaunayTriangulation.convex_hull(points)

    Convert the result to a GI.Polygon and return it. View would be more efficient here, but re-allocating is cleaner.

    julia
        point_vec = DelaunayTriangulation.get_points(hull)[DelaunayTriangulation.get_vertices(hull)]
    +    return GI.Polygon([GI.LinearRing(point_vec)])
    +end

    This page was generated using Literate.jl.

    + + + + \ No newline at end of file diff --git a/previews/PR237/source/methods/distance.html b/previews/PR237/source/methods/distance.html new file mode 100644 index 000000000..fa66077c9 --- /dev/null +++ b/previews/PR237/source/methods/distance.html @@ -0,0 +1,205 @@ + + + + + + Distance and signed distance | GeometryOps.jl + + + + + + + + + + + + + + +
    Skip to content

    Distance and signed distance

    julia
    export distance, signed_distance

    What is distance? What is signed distance?

    Distance is the distance of a point to another geometry. This is always a positive number. If a point is inside of geometry, so on a curve or inside of a polygon, the distance will be zero. Signed distance is mainly used for polygons and multipolygons. If a point is outside of a geometry, signed distance has the same value as distance. However, points within the geometry have a negative distance representing the distance of a point to the closest boundary. Therefore, for all "non-filled" geometries, like curves, the distance will either be positive or 0.

    To provide an example, consider this rectangle:

    julia
    import GeometryOps as GO
    +import GeoInterface as GI
    +using Makie
    +using CairoMakie
    +
    +rect = GI.Polygon([[(0,0), (0,1), (1,1), (1,0), (0, 0)]])
    +point_in = (0.5, 0.5)
    +point_out = (0.5, 1.5)
    +f, a, p = poly(collect(GI.getpoint(rect)); axis = (; aspect = DataAspect()))
    +scatter!(GI.x(point_in), GI.y(point_in); color = :red)
    +scatter!(GI.x(point_out), GI.y(point_out); color = :orange)
    +f

    This is clearly a rectangle with one point inside and one point outside. The points are both an equal distance to the polygon. The distance to point_in is negative while the distance to point_out is positive.

    julia
    (
    +GO.distance(point_in, rect),  # == 0
    +GO.signed_distance(point_in, rect),  # < 0
    +GO.signed_distance(point_out, rect)  # > 0
    +)
    (0.0, -0.5, 0.5)

    Consider also a heatmap of signed distances around this object:

    julia
    xrange = yrange = LinRange(-0.5, 1.5, 300)
    +f, a, p = heatmap(xrange, yrange, GO.signed_distance.(Point2f.(xrange, yrange'), Ref(rect)); colormap = :RdBu, colorrange = (-0.75, 0.75))
    +a.aspect = DataAspect(); Colorbar(f[1, 2], p, label = "Signed distance"); lines!(a, GI.convert(GO.GeometryBasics, rect)); f

    Implementation

    This is the GeoInterface-compatible implementation. First, we implement a wrapper method that dispatches to the correct implementation based on the geometry trait. This is also used in the implementation, since it's a lot less work!

    Distance and signed distance are only implemented for points to other geometries right now. This could be extended to include distance from other geometries in the future.

    The distance calculated is the Euclidean distance using the Pythagorean theorem. Also note that singed_distance only makes sense for "filled-in" shapes, like polygons, so it isn't implemented for curves.

    julia
    const _DISTANCE_TARGETS = TraitTarget{Union{GI.AbstractPolygonTrait,GI.LineStringTrait,GI.LinearRingTrait,GI.LineTrait,GI.PointTrait}}()
    +
    +"""
    +    distance(point, geom, ::Type{T} = Float64)::T
    +
    +Calculates the  ditance from the geometry `g1` to the `point`. The distance
    +will always be positive or zero.
    +
    +The method will differ based on the type of the geometry provided:
    +    - The distance from a point to a point is just the Euclidean distance
    +    between the points.
    +    - The distance from a point to a line is the minimum distance from the point
    +    to the closest point on the given line.
    +    - The distance from a point to a linestring is the minimum distance from the
    +    point to the closest segment of the linestring.
    +    - The distance from a point to a linear ring is the minimum distance from
    +    the point to the closest segment of the linear ring.
    +    - The distance from a point to a polygon is zero if the point is within the
    +    polygon and otherwise is the minimum distance from the point to an edge of
    +    the polygon. This includes edges created by holes.
    +    - The distance from a point to a multigeometry or a geometry collection is
    +    the minimum distance between the point and any of the sub-geometries.
    +
    +Result will be of type T, where T is an optional argument with a default value
    +of Float64.
    +"""
    +function distance(
    +    geom1, geom2, ::Type{T} = Float64; threaded=false
    +) where T<:AbstractFloat
    +    distance(GI.trait(geom1), geom1, GI.trait(geom2), geom2, T; threaded)
    +end
    +function distance(
    +    trait1, geom, trait2::GI.PointTrait, point, ::Type{T} = Float64;
    +    threaded=false
    +) where T<:AbstractFloat
    +    distance(trait2, point, trait1, geom, T) # Swap order
    +end
    +function distance(
    +    trait1::GI.PointTrait, point, trait2, geom, ::Type{T} = Float64;
    +    threaded=false
    +) where T<:AbstractFloat
    +    applyreduce(min, _DISTANCE_TARGETS, geom; threaded, init=typemax(T)) do g
    +        _distance(T, trait1, point, GI.trait(g), g)
    +    end
    +end

    Needed for method ambiguity

    julia
    function distance(
    +    trait1::GI.PointTrait, point1, trait2::GI.PointTrait, point2, ::Type{T} = Float64;
    +    threaded=false
    +) where T<:AbstractFloat
    +    _distance(T, trait1, point1, trait2, point2)
    +end

    Point-Point, Point-Line, Point-LineString, Point-LinearRing

    julia
    _distance(::Type{T}, ::GI.PointTrait, point, ::GI.PointTrait, geom) where T =
    +    _euclid_distance(T, point, geom)
    +_distance(::Type{T}, ::GI.PointTrait, point, ::GI.LineTrait, geom) where T =
    +    _distance_line(T, point, GI.getpoint(geom, 1), GI.getpoint(geom, 2))
    +_distance(::Type{T}, ::GI.PointTrait, point, ::GI.LineStringTrait, geom) where T =
    +    _distance_curve(T, point, geom; close_curve = false)
    +_distance(::Type{T}, ::GI.PointTrait, point, ::GI.LinearRingTrait, geom) where T =
    +    _distance_curve(T, point, geom; close_curve = true)

    Point-Polygon

    julia
    function _distance(::Type{T}, ::GI.PointTrait, point, ::GI.PolygonTrait, geom) where T
    +    within(point, geom) && return zero(T)
    +    return _distance_polygon(T, point, geom)
    +end
    +
    +"""
    +    signed_distance(point, geom, ::Type{T} = Float64)::T
    +
    +Calculates the signed distance from the geometry `geom` to the given point.
    +Points within `geom` have a negative signed distance, and points outside of
    +`geom` have a positive signed distance.
    +    - The signed distance from a point to a point, line, linestring, or linear
    +    ring is equal to the distance between the two.
    +    - The signed distance from a point to a polygon is negative if the point is
    +    within the polygon and is positive otherwise. The value of the distance is
    +    the minimum distance from the point to an edge of the polygon. This includes
    +    edges created by holes.
    +    - The signed distance from a point to a multigeometry or a geometry
    +    collection is the minimum signed distance between the point and any of the
    +    sub-geometries.
    +
    +Result will be of type T, where T is an optional argument with a default value
    +of Float64.
    +"""
    +function signed_distance(
    +    geom1, geom2, ::Type{T} = Float64; threaded=false
    +) where T<:AbstractFloat
    +    signed_distance(GI.trait(geom1), geom1, GI.trait(geom2), geom2, T; threaded)
    +end
    +function signed_distance(
    +    trait1, geom, trait2::GI.PointTrait, point, ::Type{T} = Float64;
    +    threaded=false
    +) where T<:AbstractFloat
    +    signed_distance(trait2, point, trait1, geom, T; threaded) # Swap order
    +end
    +function signed_distance(
    +    trait1::GI.PointTrait, point, trait2, geom, ::Type{T} = Float64;
    +    threaded=false
    +) where T<:AbstractFloat
    +    applyreduce(min, _DISTANCE_TARGETS, geom; threaded, init=typemax(T)) do g
    +        _signed_distance(T, trait1, point, GI.trait(g), g)
    +    end
    +end

    Needed for method ambiguity

    julia
    function signed_distance(
    +    trait1::GI.PointTrait, point1, trait2::GI.PointTrait, point2, ::Type{T} = Float64;
    +    threaded=false
    +) where T<:AbstractFloat
    +    _signed_distance(T, trait1, point1, trait2, point2)
    +end

    Point-Geom (just calls _distance)

    julia
    function _signed_distance(
    +    ::Type{T}, ptrait::GI.PointTrait, point, gtrait::GI.AbstractGeometryTrait, geom
    +) where T
    +    _distance(T, ptrait, point, gtrait, geom)
    +end

    Point-Polygon

    julia
    function _signed_distance(::Type{T}, ::GI.PointTrait, point, ::GI.PolygonTrait, geom) where T
    +    min_dist = _distance_polygon(T, point, geom)
    +    return within(point, geom) ? -min_dist : min_dist

    negative if point is inside polygon

    julia
    end

    Returns the Euclidean distance between two points.

    julia
    Base.@propagate_inbounds _euclid_distance(::Type{T}, p1, p2) where T =
    +    sqrt(_squared_euclid_distance(T, p1, p2))

    Returns the square of the euclidean distance between two points

    julia
    Base.@propagate_inbounds _squared_euclid_distance(::Type{T}, p1, p2) where T =
    +    _squared_euclid_distance(
    +        T,
    +        GeoInterface.x(p1), GeoInterface.y(p1),
    +        GeoInterface.x(p2), GeoInterface.y(p2),
    +    )

    Returns the Euclidean distance between two points given their x and y values.

    julia
    Base.@propagate_inbounds _euclid_distance(::Type{T}, x1, y1, x2, y2) where T =
    +    sqrt(_squared_euclid_distance(T, x1, y1, x2, y2))

    Returns the squared Euclidean distance between two points given their x and y values.

    julia
    Base.@propagate_inbounds _squared_euclid_distance(::Type{T}, x1, y1, x2, y2) where T =
    +    T((x2 - x1)^2 + (y2 - y1)^2)

    Returns the minimum distance from point p0 to the line defined by endpoints p1 and p2.

    julia
    _distance_line(::Type{T}, p0, p1, p2) where T =
    +    sqrt(_squared_distance_line(T, p0, p1, p2))

    Returns the squared minimum distance from point p0 to the line defined by endpoints p1 and p2.

    julia
    function _squared_distance_line(::Type{T}, p0, p1, p2) where T
    +    x0, y0 = GeoInterface.x(p0), GeoInterface.y(p0)
    +    x1, y1 = GeoInterface.x(p1), GeoInterface.y(p1)
    +    x2, y2 = GeoInterface.x(p2), GeoInterface.y(p2)
    +
    +    xfirst, yfirst, xlast, ylast = x1 < x2 ? (x1, y1, x2, y2) : (x2, y2, x1, y1)
    +
    +    #=
    +    Vectors from first point to last point (v) and from first point to point of
    +    interest (w) to find the projection of w onto v to find closest point
    +    =#
    +    v = (xlast - xfirst, ylast - yfirst)
    +    w = (x0 - xfirst, y0 - yfirst)
    +
    +    c1 = sum(w .* v)
    +    if c1 <= 0  # p0 is closest to first endpoint
    +        return _squared_euclid_distance(T, x0, y0, xfirst, yfirst)
    +    end
    +
    +    c2 = sum(v .* v)
    +    if c2 <= c1 # p0 is closest to last endpoint
    +        return _squared_euclid_distance(T, x0, y0, xlast, ylast)
    +    end
    +
    +    b2 = c1 / c2  # projection fraction
    +    return _squared_euclid_distance(T, x0, y0, xfirst + (b2 * v[1]), yfirst + (b2 * v[2]))
    +end

    Returns the minimum distance from the given point to the given curve. If close_curve is true, make sure to include the edge from the first to last point of the curve, even if it isn't explicitly repeated.

    julia
    function _distance_curve(::Type{T}, point, curve; close_curve = false) where T

    see if linear ring has explicitly repeated last point in coordinates

    julia
        np = GI.npoint(curve)
    +    first_last_equal = equals(GI.getpoint(curve, 1), GI.getpoint(curve, np))
    +    close_curve &= first_last_equal
    +    np -= first_last_equal ? 1 : 0

    find minimum distance

    julia
        min_dist = typemax(T)
    +    p1 = GI.getpoint(curve, close_curve ? np : 1)
    +    for i in (close_curve ? 1 : 2):np
    +        p2 = GI.getpoint(curve, i)
    +        dist = _distance_line(T, point, p1, p2)
    +        min_dist = dist < min_dist ? dist : min_dist
    +        p1 = p2
    +    end
    +    return min_dist
    +end

    Returns the minimum distance from the given point to an edge of the given polygon, including from edges created by holes. Assumes polygon isn't filled and treats the exterior and each hole as a linear ring.

    julia
    function _distance_polygon(::Type{T}, point, poly) where T
    +    min_dist = _distance_curve(T, point, GI.getexterior(poly); close_curve = true)
    +    @inbounds for hole in GI.gethole(poly)
    +        dist = _distance_curve(T, point, hole; close_curve = true)
    +        min_dist = dist < min_dist ? dist : min_dist
    +    end
    +    return min_dist
    +end

    This page was generated using Literate.jl.

    + + + + \ No newline at end of file diff --git a/previews/PR237/source/methods/equals.html b/previews/PR237/source/methods/equals.html new file mode 100644 index 000000000..a7098719d --- /dev/null +++ b/previews/PR237/source/methods/equals.html @@ -0,0 +1,289 @@ + + + + + + Equals | GeometryOps.jl + + + + + + + + + + + + + + +
    Skip to content

    Equals

    julia
    export equals

    What is equals?

    The equals function checks if two geometries are equal. They are equal if they share the same set of points and edges to define the same shape.

    To provide an example, consider these two lines:

    julia
    import GeometryOps as GO
    +import GeoInterface as GI
    +using Makie
    +using CairoMakie
    +
    +l1 = GI.LineString([(0.0, 0.0), (0.0, 10.0)])
    +l2 = GI.LineString([(0.0, -10.0), (0.0, 3.0)])
    +f, a, p = lines(GI.getpoint(l1), color = :blue)
    +scatter!(GI.getpoint(l1), color = :blue)
    +lines!(GI.getpoint(l2), color = :orange)
    +scatter!(GI.getpoint(l2), color = :orange)
    +f

    We can see that the two lines do not share a common set of points and edges in the plot, so they are not equal:

    julia
    GO.equals(l1, l2)  # returns false
    false

    Implementation

    This is the GeoInterface-compatible implementation.

    First, we implement a wrapper method that dispatches to the correct implementation based on the geometry trait. This is also used in the implementation, since it's a lot less work!

    Note that while we need the same set of points and edges, they don't need to be provided in the same order for polygons. For for example, we need the same set points for two multipoints to be equal, but they don't have to be saved in the same order. The winding order also doesn't have to be the same to represent the same geometry. This requires checking every point against every other point in the two geometries we are comparing. Also, some geometries must be "closed" like polygons and linear rings. These will be assumed to be closed, even if they don't have a repeated last point explicitly written in the coordinates. Additionally, geometries and multi-geometries can be equal if the multi-geometry only includes that single geometry.

    julia
    """
    +    equals(geom1, geom2)::Bool
    +
    +Compare two Geometries return true if they are the same geometry.
    +
    +# Examples
    +```jldoctest
    +import GeometryOps as GO, GeoInterface as GI
    +poly1 = GI.Polygon([[(0,0), (0,5), (5,5), (5,0), (0,0)]])
    +poly2 = GI.Polygon([[(0,0), (0,5), (5,5), (5,0), (0,0)]])
    +
    +GO.equals(poly1, poly2)

    output

    julia
    true
    +```
    +"""
    +equals(geom_a, geom_b) = equals(
    +    GI.trait(geom_a), geom_a,
    +    GI.trait(geom_b), geom_b,
    +)
    +
    +"""
    +    equals(::T, geom_a, ::T, geom_b)::Bool
    +
    +Two geometries of the same type, which don't have a equals function to dispatch
    +off of should throw an error.
    +"""
    +equals(::T, geom_a, ::T, geom_b) where T = error("Cant compare $T yet")
    +
    +"""
    +    equals(trait_a, geom_a, trait_b, geom_b)
    +
    +Two geometries which are not of the same type cannot be equal so they always
    +return false.
    +"""
    +equals(trait_a, geom_a, trait_b, geom_b) = false
    +
    +"""
    +    equals(::GI.PointTrait, p1, ::GI.PointTrait, p2)::Bool
    +
    +Two points are the same if they have the same x and y (and z if 3D) coordinates.
    +"""
    +function equals(::GI.PointTrait, p1, ::GI.PointTrait, p2)
    +    GI.ncoord(p1) == GI.ncoord(p2) || return false
    +    GI.x(p1) == GI.x(p2) || return false
    +    GI.y(p1) == GI.y(p2) || return false
    +    if GI.is3d(p1)
    +        GI.z(p1) == GI.z(p2) || return false
    +    end
    +    return true
    +end
    +
    +"""
    +    equals(::GI.PointTrait, p1, ::GI.MultiPointTrait, mp2)::Bool
    +
    +A point and a multipoint are equal if the multipoint is composed of a single
    +point that is equivalent to the given point.
    +"""
    +function equals(::GI.PointTrait, p1, ::GI.MultiPointTrait, mp2)
    +    GI.npoint(mp2) == 1 || return false
    +    return equals(p1, GI.getpoint(mp2, 1))
    +end
    +
    +"""
    +    equals(::GI.MultiPointTrait, mp1, ::GI.PointTrait, p2)::Bool
    +
    +A point and a multipoint are equal if the multipoint is composed of a single
    +point that is equivalent to the given point.
    +"""
    +equals(trait1::GI.MultiPointTrait, mp1, trait2::GI.PointTrait, p2) =
    +    equals(trait2, p2, trait1, mp1)
    +
    +"""
    +    equals(::GI.MultiPointTrait, mp1, ::GI.MultiPointTrait, mp2)::Bool
    +
    +Two multipoints are equal if they share the same set of points.
    +"""
    +function equals(::GI.MultiPointTrait, mp1, ::GI.MultiPointTrait, mp2)
    +    GI.npoint(mp1) == GI.npoint(mp2) || return false
    +    for p1 in GI.getpoint(mp1)
    +        has_match = false  # if point has a matching point in other multipoint
    +        for p2 in GI.getpoint(mp2)
    +            if equals(p1, p2)
    +                has_match = true
    +                break
    +            end
    +        end
    +        has_match || return false  # if no matching point, can't be equal
    +    end
    +    return true  # all points had a match
    +end
    +
    +"""
    +    _equals_curves(c1, c2, closed_type1, closed_type2)::Bool
    +
    +Two curves are equal if they share the same set of point, representing the same
    +geometry. Both curves must must be composed of the same set of points, however,
    +they do not have to wind in the same direction, or start on the same point to be
    +equivalent.
    +Inputs:
    +    c1 first geometry
    +    c2 second geometry
    +    closed_type1::Bool true if c1 is closed by definition (polygon, linear ring)
    +    closed_type2::Bool true if c2 is closed by definition (polygon, linear ring)
    +"""
    +function _equals_curves(c1, c2, closed_type1, closed_type2)

    Check if both curves are closed or not

    julia
        n1 = GI.npoint(c1)
    +    n2 = GI.npoint(c2)
    +    c1_repeat_point = GI.getpoint(c1, 1) == GI.getpoint(c1, n1)
    +    n2 = GI.npoint(c2)
    +    c2_repeat_point = GI.getpoint(c2, 1) == GI.getpoint(c2, n2)
    +    closed1 = closed_type1 || c1_repeat_point
    +    closed2 = closed_type2 || c2_repeat_point
    +    closed1 == closed2 || return false

    How many points in each curve

    julia
        n1 -= c1_repeat_point ? 1 : 0
    +    n2 -= c2_repeat_point ? 1 : 0
    +    n1 == n2 || return false
    +    n1 == 0 && return true

    Find offset between curves

    julia
        jstart = nothing
    +    p1 = GI.getpoint(c1, 1)
    +    for i in 1:n2
    +        if equals(p1, GI.getpoint(c2, i))
    +            jstart = i
    +            break
    +        end
    +    end

    no point matches the first point

    julia
        isnothing(jstart) && return false

    found match for only point

    julia
        n1 == 1 && return true

    if isn't closed and first or last point don't match, not same curve

    julia
        !closed_type1 && (jstart != 1 && jstart != n1) && return false

    Check if curves are going in same direction

    julia
        i = 2
    +    j = jstart + 1
    +    j -= j > n2 ? n2 : 0
    +    same_direction = equals(GI.getpoint(c1, i), GI.getpoint(c2, j))

    if only 2 points, we have already compared both

    julia
        n1 == 2 && return same_direction

    Check all remaining points are the same wrapping around line

    julia
        jstep = same_direction ? 1 : -1
    +    for i in 2:n1
    +        ip = GI.getpoint(c1, i)
    +        j = jstart + (i - 1) * jstep
    +        j += (0 < j <= n2) ? 0 : (n2 * -jstep)
    +        jp = GI.getpoint(c2, j)
    +        equals(ip, jp) || return false
    +    end
    +    return true
    +end
    +
    +"""
    +    equals(
    +        ::Union{GI.LineTrait, GI.LineStringTrait}, l1,
    +        ::Union{GI.LineTrait, GI.LineStringTrait}, l2,
    +    )::Bool
    +
    +Two lines/linestrings are equal if they share the same set of points going
    +along the curve. Note that lines/linestrings aren't closed by definition.
    +"""
    +equals(
    +    ::Union{GI.LineTrait, GI.LineStringTrait}, l1,
    +    ::Union{GI.LineTrait, GI.LineStringTrait}, l2,
    +) = _equals_curves(l1, l2, false, false)
    +
    +"""
    +    equals(
    +        ::Union{GI.LineTrait, GI.LineStringTrait}, l1,
    +        ::GI.LinearRingTrait, l2,
    +    )::Bool
    +
    +A line/linestring and a linear ring are equal if they share the same set of
    +points going along the curve. Note that lines aren't closed by definition, but
    +rings are, so the line must have a repeated last point to be equal
    +"""
    +equals(
    +    ::Union{GI.LineTrait, GI.LineStringTrait}, l1,
    +    ::GI.LinearRingTrait, l2,
    +) = _equals_curves(l1, l2, false, true)
    +
    +"""
    +    equals(
    +        ::GI.LinearRingTrait, l1,
    +        ::Union{GI.LineTrait, GI.LineStringTrait}, l2,
    +    )::Bool
    +
    +A linear ring and a line/linestring are equal if they share the same set of
    +points going along the curve. Note that lines aren't closed by definition, but
    +rings are, so the line must have a repeated last point to be equal
    +"""
    +equals(
    +    ::GI.LinearRingTrait, l1,
    +    ::Union{GI.LineTrait, GI.LineStringTrait}, l2,
    +) = _equals_curves(l1, l2, true, false)
    +
    +"""
    +    equals(
    +        ::GI.LinearRingTrait, l1,
    +        ::GI.LinearRingTrait, l2,
    +    )::Bool
    +
    +Two linear rings are equal if they share the same set of points going along the
    +curve. Note that rings are closed by definition, so they can have, but don't
    +need, a repeated last point to be equal.
    +"""
    +equals(
    +    ::GI.LinearRingTrait, l1,
    +    ::GI.LinearRingTrait, l2,
    +) = _equals_curves(l1, l2, true, true)
    +
    +"""
    +    equals(::GI.PolygonTrait, geom_a, ::GI.PolygonTrait, geom_b)::Bool
    +
    +Two polygons are equal if they share the same exterior edge and holes.
    +"""
    +function equals(::GI.PolygonTrait, geom_a, ::GI.PolygonTrait, geom_b)

    Check if exterior is equal

    julia
        _equals_curves(
    +        GI.getexterior(geom_a), GI.getexterior(geom_b),
    +        true, true,  # linear rings are closed by definition
    +    ) || return false

    Check if number of holes are equal

    julia
        GI.nhole(geom_a) == GI.nhole(geom_b) || return false

    Check if holes are equal

    julia
        for ihole in GI.gethole(geom_a)
    +        has_match = false
    +        for jhole in GI.gethole(geom_b)
    +            if _equals_curves(
    +                ihole, jhole,
    +                true, true,  # linear rings are closed by definition
    +            )
    +                has_match = true
    +                break
    +            end
    +        end
    +        has_match || return false
    +    end
    +    return true
    +end
    +
    +"""
    +    equals(::GI.PolygonTrait, geom_a, ::GI.MultiPolygonTrait, geom_b)::Bool
    +
    +A polygon and a multipolygon are equal if the multipolygon is composed of a
    +single polygon that is equivalent to the given polygon.
    +"""
    +function equals(::GI.PolygonTrait, geom_a, ::MultiPolygonTrait, geom_b)
    +    GI.npolygon(geom_b) == 1 || return false
    +    return equals(geom_a, GI.getpolygon(geom_b, 1))
    +end
    +
    +"""
    +    equals(::GI.MultiPolygonTrait, geom_a, ::GI.PolygonTrait, geom_b)::Bool
    +
    +A polygon and a multipolygon are equal if the multipolygon is composed of a
    +single polygon that is equivalent to the given polygon.
    +"""
    +equals(trait_a::GI.MultiPolygonTrait, geom_a, trait_b::PolygonTrait, geom_b) =
    +    equals(trait_b, geom_b, trait_a, geom_a)
    +
    +"""
    +    equals(::GI.PolygonTrait, geom_a, ::GI.PolygonTrait, geom_b)::Bool
    +
    +Two multipolygons are equal if they share the same set of polygons.
    +"""
    +function equals(::GI.MultiPolygonTrait, geom_a, ::GI.MultiPolygonTrait, geom_b)

    Check if same number of polygons

    julia
        GI.npolygon(geom_a) == GI.npolygon(geom_b) || return false

    Check if each polygon has a matching polygon

    julia
        for poly_a in GI.getpolygon(geom_a)
    +        has_match = false
    +        for poly_b in GI.getpolygon(geom_b)
    +            if equals(poly_a, poly_b)
    +                has_match = true
    +                break
    +            end
    +        end
    +        has_match || return false
    +    end
    +    return true
    +end

    This page was generated using Literate.jl.

    + + + + \ No newline at end of file diff --git a/previews/PR237/source/methods/geom_relations/contains.html b/previews/PR237/source/methods/geom_relations/contains.html new file mode 100644 index 000000000..4fbf7450c --- /dev/null +++ b/previews/PR237/source/methods/geom_relations/contains.html @@ -0,0 +1,57 @@ + + + + + + Contains | GeometryOps.jl + + + + + + + + + + + + + + +
    Skip to content

    Contains

    julia
    export contains

    What is contains?

    The contains function checks if a given geometry completely contains another geometry, or in other words, that the second geometry is completely within the first. This requires that the two interiors intersect and that the interior and boundary of the second geometry is not in the exterior of the first geometry.

    To provide an example, consider these two lines:

    julia
    import GeometryOps as GO
    +import GeoInterface as GI
    +using Makie
    +using CairoMakie
    +
    +l1 = GI.LineString([(0.0, 0.0), (1.0, 0.0), (0.0, 0.1)])
    +l2 = GI.LineString([(0.25, 0.0), (0.75, 0.0)])
    +f, a, p = lines(GI.getpoint(l1), color = :blue)
    +scatter!(GI.getpoint(l1), color = :blue)
    +lines!(GI.getpoint(l2), color = :orange)
    +scatter!(GI.getpoint(l2), color = :orange)
    +f

    We can see that all of the points and edges of l2 are within l1, so l1 contains l2. However, l2 does not contain l1.

    julia
    GO.contains(l1, l2)  # returns true
    +GO.contains(l2, l1)  # returns false
    false

    Implementation

    This is the GeoInterface-compatible implementation.

    Given that contains is the exact opposite of within, we simply pass the two inputs variables, swapped in order, to within.

    julia
    """
    +    contains(g1::AbstractGeometry, g2::AbstractGeometry)::Bool
    +
    +Return true if the second geometry is completely contained by the first
    +geometry. The interiors of both geometries must intersect and the interior and
    +boundary of the secondary (g2) must not intersect the exterior of the first
    +(g1).
    +
    +`contains` returns the exact opposite result of `within`.
    +
    +# Examples
    +
    +```jldoctest
    +import GeometryOps as GO, GeoInterface as GI
    +line = GI.LineString([(1, 1), (1, 2), (1, 3), (1, 4)])
    +point = GI.Point((1, 2))
    +
    +GO.contains(line, point)

    output

    julia
    true
    +```
    +"""
    +contains(g1, g2) = GeometryOps.within(g2, g1)

    This page was generated using Literate.jl.

    + + + + \ No newline at end of file diff --git a/previews/PR237/source/methods/geom_relations/coveredby.html b/previews/PR237/source/methods/geom_relations/coveredby.html new file mode 100644 index 000000000..ce084c4d3 --- /dev/null +++ b/previews/PR237/source/methods/geom_relations/coveredby.html @@ -0,0 +1,207 @@ + + + + + + CoveredBy | GeometryOps.jl + + + + + + + + + + + + + + +
    Skip to content

    CoveredBy

    julia
    export coveredby

    What is coveredby?

    The coveredby function checks if one geometry is covered by another geometry. This is an extension of within that does not require the interiors of the two geometries to intersect, but still does require that the interior and boundary of the first geometry isn't outside of the second geometry.

    To provide an example, consider this point and line:

    julia
    import GeometryOps as GO
    +import GeoInterface as GI
    +using Makie
    +using CairoMakie
    +
    +p1 = (0.0, 0.0)
    +l1 = GI.Line([p1, (1.0, 1.0)])
    +f, a, p = lines(GI.getpoint(l1))
    +scatter!(p1, color = :red)
    +f

    As we can see, p1 is on the endpoint of l1. This means it is not within, but it does meet the definition of coveredby.

    julia
    GO.coveredby(p1, l1)  # true
    true

    Implementation

    This is the GeoInterface-compatible implementation.

    First, we implement a wrapper method that dispatches to the correct implementation based on the geometry trait.

    Each of these calls a method in the geom_geom_processors file. The methods in this file determine if the given geometries meet a set of criteria. For the coveredby function and arguments g1 and g2, this criteria is as follows: - points of g1 are allowed to be in the interior of g2 (either through overlap or crossing for lines) - points of g1 are allowed to be on the boundary of g2 - points of g1 are not allowed to be in the exterior of g2 - no points of g1 are required to be in the interior of g2 - no points of g1 are required to be on the boundary of g2 - no points of g1 are required to be in the exterior of g2

    The code for the specific implementations is in the geom_geom_processors file.

    julia
    const COVEREDBY_ALLOWS = (in_allow = true, on_allow = true, out_allow = false)
    +const COVEREDBY_CURVE_ALLOWS = (over_allow = true, cross_allow = true, on_allow = true, out_allow = false)
    +const COVEREDBY_CURVE_REQUIRES = (in_require = false, on_require = false, out_require = false)
    +const COVEREDBY_POLYGON_REQUIRES = (in_require = true, on_require = false, out_require = false,)
    +const COVEREDBY_EXACT = (exact = _False(),)
    +
    +"""
    +    coveredby(g1, g2)::Bool
    +
    +Return `true` if the first geometry is completely covered by the second
    +geometry. The interior and boundary of the primary geometry (g1) must not
    +intersect the exterior of the secondary geometry (g2).
    +
    +Furthermore, `coveredby` returns the exact opposite result of `covers`. They are
    +equivalent with the order of the arguments swapped.
    +
    +# Examples
    +```jldoctest setup=:(using GeometryOps, GeometryBasics)
    +import GeometryOps as GO, GeoInterface as GI
    +p1 = GI.Point(0.0, 0.0)
    +p2 = GI.Point(1.0, 1.0)
    +l1 = GI.Line([p1, p2])
    +
    +GO.coveredby(p1, l1)

    output

    julia
    true
    +```
    +"""
    +coveredby(g1, g2) = _coveredby(trait(g1), g1, trait(g2), g2)

    Convert features to geometries

    julia
    _coveredby(::GI.FeatureTrait, g1, ::Any, g2) = coveredby(GI.geometry(g1), g2)
    +_coveredby(::Any, g1, t2::GI.FeatureTrait, g2) = coveredby(g1, GI.geometry(g2))
    +_coveredby(::FeatureTrait, g1, ::FeatureTrait, g2) = coveredby(GI.geometry(g1), GI.geometry(g2))

    Points coveredby geometries

    Point is coveredby another point if those points are equal

    julia
    _coveredby(
    +    ::GI.PointTrait, g1,
    +    ::GI.PointTrait, g2,
    +) = equals(g1, g2)

    Point is coveredby a line/linestring if it is on a line vertex or an edge

    julia
    _coveredby(
    +    ::GI.PointTrait, g1,
    +    ::Union{GI.LineTrait, GI.LineStringTrait}, g2,
    +) = _point_curve_process(
    +    g1, g2;
    +    COVEREDBY_ALLOWS...,
    +    closed_curve = false,
    +)

    Point is coveredby a linearring if it is on a vertex or an edge of ring

    julia
    _coveredby(
    +    ::GI.PointTrait, g1,
    +    ::GI.LinearRingTrait, g2,
    +) = _point_curve_process(
    +    g1, g2;
    +    COVEREDBY_ALLOWS...,
    +    closed_curve = true,
    +)

    Point is coveredby a polygon if it is inside polygon, including edges/vertices

    julia
    _coveredby(
    +    ::GI.PointTrait, g1,
    +    ::GI.PolygonTrait, g2,
    +) = _point_polygon_process(
    +    g1, g2;
    +    COVEREDBY_ALLOWS...,
    +    COVEREDBY_EXACT...,
    +)

    Points cannot cover any geometry other than points

    julia
    _coveredby(
    +    ::Union{GI.AbstractCurveTrait, GI.PolygonTrait}, g1,
    +    ::GI.PointTrait, g2,
    +) = false

    Lines coveredby geometries

    julia
    #= Linestring is coveredby a line if all interior and boundary points of the
    +first line are on the interior/boundary points of the second line. =#
    +_coveredby(
    +    ::Union{GI.LineTrait, GI.LineStringTrait}, g1,
    +    ::Union{GI.LineTrait, GI.LineStringTrait}, g2,
    +) = _line_curve_process(
    +    g1, g2;
    +    COVEREDBY_CURVE_ALLOWS...,
    +    COVEREDBY_CURVE_REQUIRES...,
    +    COVEREDBY_EXACT...,
    +    closed_line = false,
    +    closed_curve = false,
    +)
    +
    +#= Linestring is coveredby a ring if all interior and boundary points of the
    +line are on the edges of the ring. =#
    +_coveredby(
    +    ::Union{GI.LineTrait, GI.LineStringTrait}, g1,
    +    ::GI.LinearRingTrait, g2,
    +) = _line_curve_process(
    +    g1, g2;
    +    COVEREDBY_CURVE_ALLOWS...,
    +    COVEREDBY_CURVE_REQUIRES...,
    +    COVEREDBY_EXACT...,
    +    closed_line = false,
    +    closed_curve = true,
    +)
    +
    +#= Linestring is coveredby a polygon if all interior and boundary points of the
    +line are in the polygon interior or on its edges, including hole edges. =#
    +_coveredby(
    +    ::Union{GI.LineTrait, GI.LineStringTrait}, g1,
    +    ::GI.PolygonTrait, g2,
    +) = _line_polygon_process(
    +    g1, g2;
    +    COVEREDBY_ALLOWS...,
    +    COVEREDBY_CURVE_REQUIRES...,
    +    COVEREDBY_EXACT...,
    +    closed_line = false,
    +)

    Rings covered by geometries

    julia
    #= Linearring is covered by a line if all vertices and edges of the ring are on
    +the edges and vertices of the line. =#
    +_coveredby(
    +    ::GI.LinearRingTrait, g1,
    +    ::Union{GI.LineTrait, GI.LineStringTrait}, g2,
    +) = _line_curve_process(
    +    g1, g2;
    +    COVEREDBY_CURVE_ALLOWS...,
    +    COVEREDBY_CURVE_REQUIRES...,
    +    COVEREDBY_EXACT...,
    +    closed_line = true,
    +    closed_curve = false,
    +)
    +
    +#= Linearring is covered by another linear ring if all vertices and edges of the
    +first ring are on the edges/vertices of the second ring. =#
    +_coveredby(
    +    ::GI.LinearRingTrait, g1,
    +    ::GI.LinearRingTrait, g2,
    +) = _line_curve_process(
    +    g1, g2;
    +    COVEREDBY_CURVE_ALLOWS...,
    +    COVEREDBY_CURVE_REQUIRES...,
    +    COVEREDBY_EXACT...,
    +    closed_line = true,
    +    closed_curve = true,
    +)
    +
    +#= Linearring is coveredby a polygon if all vertices and edges of the ring are
    +in the polygon interior or on the polygon edges, including hole edges. =#
    +_coveredby(
    +    ::GI.LinearRingTrait, g1,
    +    ::GI.PolygonTrait, g2,
    +) = _line_polygon_process(
    +    g1, g2;
    +    COVEREDBY_ALLOWS...,
    +    COVEREDBY_CURVE_REQUIRES...,
    +    COVEREDBY_EXACT...,
    +    closed_line = true,
    +)

    Polygons covered by geometries

    julia
    #= Polygon is covered by another polygon if if the interior and edges of the
    +first polygon are in the second polygon interior or on polygon edges, including
    +hole edges.=#
    +_coveredby(
    +    ::GI.PolygonTrait, g1,
    +    ::GI.PolygonTrait, g2,
    +) = _polygon_polygon_process(
    +    g1, g2;
    +    COVEREDBY_ALLOWS...,
    +    COVEREDBY_POLYGON_REQUIRES...,
    +    COVEREDBY_EXACT...,
    +)

    Polygons cannot covered by any curves

    julia
    _coveredby(
    +    ::GI.PolygonTrait, g1,
    +    ::GI.AbstractCurveTrait, g2,
    +) = false

    Geometries coveredby multi-geometry/geometry collections

    julia
    #= Geometry is covered by a multi-geometry or a collection if one of the elements
    +of the collection cover the geometry. =#
    +function _coveredby(
    +    ::Union{GI.PointTrait, GI.AbstractCurveTrait, GI.PolygonTrait}, g1,
    +    ::Union{
    +        GI.MultiPointTrait, GI.AbstractMultiCurveTrait,
    +        GI.MultiPolygonTrait, GI.GeometryCollectionTrait,
    +    }, g2,
    +)
    +    for sub_g2 in GI.getgeom(g2)
    +        coveredby(g1, sub_g2) && return true
    +    end
    +    return false
    +end

    Multi-geometry/geometry collections coveredby geometries

    julia
    #= Multi-geometry or a geometry collection is covered by a geometry if all
    +elements of the collection are covered by the geometry. =#
    +function _coveredby(
    +    ::Union{
    +        GI.MultiPointTrait, GI.AbstractMultiCurveTrait,
    +        GI.MultiPolygonTrait, GI.GeometryCollectionTrait,
    +    }, g1,
    +    ::GI.AbstractGeometryTrait, g2,
    +)
    +    for sub_g1 in GI.getgeom(g1)
    +        !coveredby(sub_g1, g2) && return false
    +    end
    +    return true
    +end

    This page was generated using Literate.jl.

    + + + + \ No newline at end of file diff --git a/previews/PR237/source/methods/geom_relations/covers.html b/previews/PR237/source/methods/geom_relations/covers.html new file mode 100644 index 000000000..656d8f0b5 --- /dev/null +++ b/previews/PR237/source/methods/geom_relations/covers.html @@ -0,0 +1,57 @@ + + + + + + Covers | GeometryOps.jl + + + + + + + + + + + + + + +
    Skip to content

    Covers

    julia
    export covers

    What is covers?

    The covers function checks if a given geometry completely covers another geometry. For this to be true, the "contained" geometry's interior and boundaries must be covered by the "covering" geometry's interior and boundaries. The interiors do not need to overlap.

    To provide an example, consider these two lines:

    julia
    import GeometryOps as GO
    +import GeoInterface as GI
    +using Makie
    +using CairoMakie
    +
    +p1 = (0.0, 0.0)
    +p2 = (1.0, 1.0)
    +l1 = GI.Line([p1, p2])
    +
    +f, a, p = lines(GI.getpoint(l1))
    +scatter!(p1, color = :red)
    +f

    julia
    GO.covers(l1, p1)  # returns true
    +GO.covers(p1, l1)  # returns false
    false

    Implementation

    This is the GeoInterface-compatible implementation.

    Given that covers is the exact opposite of coveredby, we simply pass the two inputs variables, swapped in order, to coveredby.

    julia
    """
    +    covers(g1::AbstractGeometry, g2::AbstractGeometry)::Bool
    +
    +Return true if the first geometry is completely covers the second geometry,
    +The exterior and boundary of the second geometry must not be outside of the
    +interior and boundary of the first geometry. However, the interiors need not
    +intersect.
    +
    +`covers` returns the exact opposite result of `coveredby`.
    +
    +# Examples
    +
    +```jldoctest
    +import GeometryOps as GO, GeoInterface as GI
    +l1 = GI.LineString([(1.0, 1.0), (1.0, 2.0), (1.0, 3.0), (1.0, 4.0)])
    +l2 = GI.LineString([(1.0, 1.0), (1.0, 2.0)])
    +
    +GO.covers(l1, l2)

    output

    julia
    true
    +```
    +"""
    +covers(g1, g2)::Bool = GeometryOps.coveredby(g2, g1)

    This page was generated using Literate.jl.

    + + + + \ No newline at end of file diff --git a/previews/PR237/source/methods/geom_relations/crosses.html b/previews/PR237/source/methods/geom_relations/crosses.html new file mode 100644 index 000000000..a8272264c --- /dev/null +++ b/previews/PR237/source/methods/geom_relations/crosses.html @@ -0,0 +1,144 @@ + + + + + + Crossing checks | GeometryOps.jl + + + + + + + + + + + + + + +
    Skip to content

    Crossing checks

    julia
    """
    +     crosses(geom1, geom2)::Bool
    +
    +Return `true` if the intersection results in a geometry whose dimension is one less than
    +the maximum dimension of the two source geometries and the intersection set is interior to
    +both source geometries.
    +
    +TODO: broken
    +
    +# Examples
    +```julia
    +import GeoInterface as GI, GeometryOps as GO

    TODO: Add working example

    julia
    ```
    +"""
    +crosses(g1, g2)::Bool = crosses(trait(g1), g1, trait(g2), g2)::Bool
    +crosses(t1::FeatureTrait, g1, t2, g2)::Bool = crosses(GI.geometry(g1), g2)
    +crosses(t1, g1, t2::FeatureTrait, g2)::Bool = crosses(g1, geometry(g2))
    +crosses(::MultiPointTrait, g1, ::LineStringTrait, g2)::Bool = multipoint_crosses_line(g1, g2)
    +crosses(::MultiPointTrait, g1, ::PolygonTrait, g2)::Bool = multipoint_crosses_poly(g1, g2)
    +crosses(::LineStringTrait, g1, ::MultiPointTrait, g2)::Bool = multipoint_crosses_lines(g2, g1)
    +crosses(::LineStringTrait, g1, ::PolygonTrait, g2)::Bool = line_crosses_poly(g1, g2)
    +crosses(::LineStringTrait, g1, ::LineStringTrait, g2)::Bool = line_crosses_line(g1, g2)
    +crosses(::PolygonTrait, g1, ::MultiPointTrait, g2)::Bool = multipoint_crosses_poly(g2, g1)
    +crosses(::PolygonTrait, g1, ::LineStringTrait, g2)::Bool = line_crosses_poly(g2, g1)
    +
    +function multipoint_crosses_line(geom1, geom2)
    +    int_point = false
    +    ext_point = false
    +    i = 1
    +    np2 = GI.npoint(geom2)
    +
    +    while i < GI.npoint(geom1) && !int_point && !ext_point
    +        for j in 1:GI.npoint(geom2) - 1
    +            exclude_boundary = (j === 1 || j === np2 - 2) ? :none : :both
    +            if _point_on_segment(GI.getpoint(geom1, i), (GI.getpoint(geom2, j), GI.getpoint(geom2, j + 1)); exclude_boundary)
    +                int_point = true
    +            else
    +                ext_point = true
    +            end
    +        end
    +        i += 1
    +    end
    +    return int_point && ext_point
    +end
    +
    +function line_crosses_line(line1, line2)
    +    np2 = GI.npoint(line2)
    +    if GeometryOps.intersects(line1, line2)
    +        for i in 1:GI.npoint(line1) - 1
    +            for j in 1:GI.npoint(line2) - 1
    +                exclude_boundary = (j === 1 || j === np2 - 2) ? :none : :both
    +                pa = GI.getpoint(line1, i)
    +                pb = GI.getpoint(line1, i + 1)
    +                p = GI.getpoint(line2, j)
    +                _point_on_segment(p, (pa, pb); exclude_boundary) && return true
    +            end
    +        end
    +    end
    +    return false
    +end
    +
    +function line_crosses_poly(line, poly)
    +    for l in flatten(AbstractCurveTrait, poly)
    +        intersects(line, l) && return true
    +    end
    +    return false
    +end
    +
    +function multipoint_crosses_poly(mp, poly)
    +    int_point = false
    +    ext_point = false
    +
    +    for p in GI.getpoint(mp)
    +        if _point_polygon_process(
    +            p, poly;
    +            in_allow = true, on_allow = true, out_allow = false, exact = _False()
    +        )
    +            int_point = true
    +        else
    +            ext_point = true
    +        end
    +        int_point && ext_point && return true
    +    end
    +    return false
    +end
    +
    +#= TODO: Once crosses is swapped over to use the geom relations workflow, can
    +delete these helpers. =#
    +
    +function _point_on_segment(point, (start, stop); exclude_boundary::Symbol=:none)::Bool
    +    x, y = GI.x(point), GI.y(point)
    +    x1, y1 = GI.x(start), GI.y(start)
    +    x2, y2 = GI.x(stop), GI.y(stop)
    +
    +    dxc = x - x1
    +    dyc = y - y1
    +    dx1 = x2 - x1
    +    dy1 = y2 - y1

    TODO use better predicate for crossing here

    julia
        cross = dxc * dy1 - dyc * dx1
    +    cross != 0 && return false

    Will constprop optimise these away?

    julia
        if exclude_boundary === :none
    +        if abs(dx1) >= abs(dy1)
    +            return dx1 > 0 ? x1 <= x && x <= x2 : x2 <= x && x <= x1
    +        end
    +        return dy1 > 0 ? y1 <= y && y <= y2 : y2 <= y && y <= y1
    +    elseif exclude_boundary === :start
    +        if abs(dx1) >= abs(dy1)
    +             return dx1 > 0 ? x1 < x && x <= x2 : x2 <= x && x < x1
    +        end
    +        return dy1 > 0 ? y1 < y && y <= y2 : y2 <= y && y < y1
    +    elseif exclude_boundary === :end
    +        if abs(dx1) >= abs(dy1)
    +            return dx1 > 0 ? x1 <= x && x < x2 : x2 < x && x <= x1
    +        end
    +        return dy1 > 0 ? y1 <= y && y < y2 : y2 < y && y <= y1
    +    elseif exclude_boundary === :both
    +        if abs(dx1) >= abs(dy1)
    +            return dx1 > 0 ? x1 < x && x < x2 : x2 < x && x < x1
    +        end
    +        return dy1 > 0 ? y1 < y && y < y2 : y2 < y && y < y1
    +    end
    +    return false
    +end

    This page was generated using Literate.jl.

    + + + + \ No newline at end of file diff --git a/previews/PR237/source/methods/geom_relations/disjoint.html b/previews/PR237/source/methods/geom_relations/disjoint.html new file mode 100644 index 000000000..097e9f9bc --- /dev/null +++ b/previews/PR237/source/methods/geom_relations/disjoint.html @@ -0,0 +1,202 @@ + + + + + + Disjoint | GeometryOps.jl + + + + + + + + + + + + + + +
    Skip to content

    Disjoint

    julia
    export disjoint

    What is disjoint?

    The disjoint function checks if one geometry is outside of another geometry, without sharing any boundaries or interiors.

    To provide an example, consider these two lines:

    julia
    import GeometryOps as GO
    +import GeoInterface as GI
    +using Makie
    +using CairoMakie
    +
    +l1 = GI.LineString([(0.0, 0.0), (1.0, 0.0), (0.0, 0.1)])
    +l2 = GI.LineString([(2.0, 0.0), (2.75, 0.0)])
    +f, a, p = lines(GI.getpoint(l1), color = :blue)
    +scatter!(GI.getpoint(l1), color = :blue)
    +lines!(GI.getpoint(l2), color = :orange)
    +scatter!(GI.getpoint(l2), color = :orange)
    +f

    We can see that none of the edges or vertices of l1 interact with l2 so they are disjoint.

    julia
    GO.disjoint(l1, l2)  # returns true
    true

    Implementation

    This is the GeoInterface-compatible implementation.

    First, we implement a wrapper method that dispatches to the correct implementation based on the geometry trait.

    Each of these calls a method in the geom_geom_processors file. The methods in this file determine if the given geometries meet a set of criteria. For the disjoint function and arguments g1 and g2, this criteria is as follows: - points of g1 are not allowed to be in the interior of g2 - points of g1 are not allowed to be on the boundary of g2 - points of g1 are allowed to be in the exterior of g2 - no points required to be in the interior of g2 - no points of g1 are required to be on the boundary of g2 - no points of g1 are required to be in the exterior of g2

    The code for the specific implementations is in the geom_geom_processors file.

    julia
    const DISJOINT_ALLOWS = (in_allow = false, on_allow = false, out_allow = true)
    +const DISJOINT_CURVE_ALLOWS = (over_allow = false, cross_allow = false, on_allow = false, out_allow = true)
    +const DISJOINT_REQUIRES = (in_require = false, on_require = false, out_require = false)
    +const DISJOINT_EXACT = (exact = _False(),)
    +
    +"""
    +    disjoint(geom1, geom2)::Bool
    +
    +Return `true` if the first geometry is disjoint from the second geometry.
    +
    +Return `true` if the first geometry is disjoint from the second geometry. The
    +interiors and boundaries of both geometries must not intersect.
    +
    +# Examples
    +```jldoctest setup=:(using GeometryOps, GeoInterface)
    +import GeometryOps as GO, GeoInterface as GI
    +
    +line = GI.LineString([(1, 1), (1, 2), (1, 3), (1, 4)])
    +point = (2, 2)
    +GO.disjoint(point, line)

    output

    julia
    true
    +```
    +"""
    +disjoint(g1, g2) = _disjoint(trait(g1), g1, trait(g2), g2)

    Convert features to geometries

    julia
    _disjoint(::FeatureTrait, g1, ::Any, g2) = disjoint(GI.geometry(g1), g2)
    +_disjoint(::Any, g1, ::FeatureTrait, g2) = disjoint(g1, geometry(g2))
    +_disjoint(::FeatureTrait, g1, ::FeatureTrait, g2) = disjoint(GI.geometry(g1), GI.geometry(g2))

    Point disjoint geometries

    Point is disjoint from another point if the points are not equal.

    julia
    _disjoint(
    +    ::GI.PointTrait, g1,
    +    ::GI.PointTrait, g2,
    +) = !equals(g1, g2)

    Point is disjoint from a linestring if it is not on the line's edges/vertices.

    julia
    _disjoint(
    +    ::GI.PointTrait, g1,
    +    ::Union{GI.LineTrait, GI.LineStringTrait}, g2,
    +) = _point_curve_process(
    +    g1, g2;
    +    DISJOINT_ALLOWS...,
    +    closed_curve = false,
    +)

    Point is disjoint from a linearring if it is not on the ring's edges/vertices.

    julia
    _disjoint(
    +    ::GI.PointTrait, g1,
    +    ::GI.LinearRingTrait, g2,
    +) = _point_curve_process(
    +    g1, g2;
    +    DISJOINT_ALLOWS...,
    +    closed_curve = true,
    +)
    +
    +#= Point is disjoint from a polygon if it is not on any edges, vertices, or
    +within the polygon's interior. =#
    +_disjoint(
    +    ::GI.PointTrait, g1,
    +    ::GI.PolygonTrait, g2,
    +) = _point_polygon_process(
    +    g1, g2;
    +    DISJOINT_ALLOWS...,
    +    DISJOINT_EXACT...,
    +)
    +
    +#= Geometry is disjoint from a point if the point is not in the interior or on
    +the boundary of the geometry. =#
    +_disjoint(
    +    trait1::Union{GI.AbstractCurveTrait, GI.PolygonTrait}, g1,
    +    trait2::GI.PointTrait, g2,
    +) = _disjoint(trait2, g2, trait1, g1)

    Lines disjoint geometries

    julia
    #= Linestring is disjoint from another line if they do not share any interior
    +edge/vertex points or boundary points. =#
    +_disjoint(
    +    ::Union{GI.LineTrait, GI.LineStringTrait}, g1,
    +    ::Union{GI.LineTrait, GI.LineStringTrait}, g2,
    +) = _line_curve_process(
    +    g1, g2;
    +    DISJOINT_CURVE_ALLOWS...,
    +    DISJOINT_REQUIRES...,
    +    DISJOINT_EXACT...,
    +    closed_line = false,
    +    closed_curve = false,
    +)
    +
    +#= Linestring is disjoint from a linearring if they do not share any interior
    +edge/vertex points or boundary points. =#
    +_disjoint(
    +    ::Union{GI.LineTrait, GI.LineStringTrait}, g1,
    +    ::GI.LinearRingTrait, g2,
    +) = _line_curve_process(
    +    g1, g2;
    +    DISJOINT_CURVE_ALLOWS...,
    +    DISJOINT_REQUIRES...,
    +    DISJOINT_EXACT...,
    +    closed_line = false,
    +    closed_curve = true,
    +)
    +
    +#= Linestring is disjoint from a polygon if the interior and boundary points of
    +the line are not in the polygon's interior or on the polygon's boundary. =#
    +_disjoint(
    +    ::Union{GI.LineTrait, GI.LineStringTrait}, g1,
    +    ::GI.PolygonTrait, g2,
    +) = _line_polygon_process(
    +    g1, g2;
    +    DISJOINT_ALLOWS...,
    +    DISJOINT_REQUIRES...,
    +    DISJOINT_EXACT...,
    +    closed_line = false,
    +)
    +
    +#= Geometry is disjoint from a linestring if the line's interior and boundary
    +points don't intersect with the geometry's interior and boundary points. =#
    +_disjoint(
    +    trait1::Union{GI.LinearRingTrait, GI.PolygonTrait}, g1,
    +    trait2::Union{GI.LineTrait, GI.LineStringTrait}, g2,
    +) = _disjoint(trait2, g2, trait1, g1)

    Rings disjoint geometries

    julia
    #= Linearrings is disjoint from another linearring if they do not share any
    +interior edge/vertex points or boundary points.=#
    +_disjoint(
    +    ::GI.LinearRingTrait, g1,
    +    ::GI.LinearRingTrait, g2,
    +) = _line_curve_process(
    +    g1, g2;
    +    DISJOINT_CURVE_ALLOWS...,
    +    DISJOINT_REQUIRES...,
    +    DISJOINT_EXACT...,
    +    closed_line = true,
    +    closed_curve = true,
    +)
    +
    +#= Linearring is disjoint from a polygon if the interior and boundary points of
    +the ring are not in the polygon's interior or on the polygon's boundary. =#
    +_disjoint(
    +    ::GI.LinearRingTrait, g1,
    +    ::GI.PolygonTrait, g2,
    +) = _line_polygon_process(
    +    g1, g2;
    +    DISJOINT_ALLOWS...,
    +    DISJOINT_REQUIRES...,
    +    DISJOINT_EXACT...,
    +    closed_line = true,
    +)

    Polygon disjoint geometries

    julia
    #= Polygon is disjoint from another polygon if they do not share any edges or
    +vertices and if their interiors do not intersect, excluding any holes. =#
    +_disjoint(
    +    ::GI.PolygonTrait, g1,
    +    ::GI.PolygonTrait, g2,
    +) = _polygon_polygon_process(
    +    g1, g2;
    +    DISJOINT_ALLOWS...,
    +    DISJOINT_REQUIRES...,
    +    DISJOINT_EXACT...,
    +)

    Geometries disjoint multi-geometry/geometry collections

    julia
    #= Geometry is disjoint from a multi-geometry or a collection if all of the
    +elements of the collection are disjoint from the geometry. =#
    +function _disjoint(
    +    ::Union{GI.PointTrait, GI.AbstractCurveTrait, GI.PolygonTrait}, g1,
    +    ::Union{
    +        GI.MultiPointTrait, GI.AbstractMultiCurveTrait,
    +        GI.MultiPolygonTrait, GI.GeometryCollectionTrait,
    +    }, g2,
    +)
    +    for sub_g2 in GI.getgeom(g2)
    +        !disjoint(g1, sub_g2) && return false
    +    end
    +    return true
    +end

    Multi-geometry/geometry collections coveredby geometries

    julia
    #= Multi-geometry or a geometry collection is covered by a geometry if all
    +elements of the collection are covered by the geometry. =#
    +function _disjoint(
    +    ::Union{
    +        GI.MultiPointTrait, GI.AbstractMultiCurveTrait,
    +        GI.MultiPolygonTrait, GI.GeometryCollectionTrait,
    +    }, g1,
    +    ::GI.AbstractGeometryTrait, g2,
    +)
    +    for sub_g1 in GI.getgeom(g1)
    +        !disjoint(sub_g1, g2) && return false
    +    end
    +    return true
    +end

    This page was generated using Literate.jl.

    + + + + \ No newline at end of file diff --git a/previews/PR237/source/methods/geom_relations/geom_geom_processors.html b/previews/PR237/source/methods/geom_relations/geom_geom_processors.html new file mode 100644 index 000000000..1a5404af5 --- /dev/null +++ b/previews/PR237/source/methods/geom_relations/geom_geom_processors.html @@ -0,0 +1,461 @@ + + + + + + Line-curve interaction | GeometryOps.jl + + + + + + + + + + + + + + +
    Skip to content

    Line-curve interaction

    julia
    #= Code is based off of DE-9IM Standards (https://en.wikipedia.org/wiki/DE-9IM)
    +and attempts a standardized solution for most of the functions.
    +=#
    +
    +"""
    +    Enum PointOrientation
    +
    +Enum for the orientation of a point with respect to a curve. A point can be
    +`point_in` the curve, `point_on` the curve, or `point_out` of the curve.
    +"""
    +@enum PointOrientation point_in=1 point_on=2 point_out=3

    Determines if a point meets the given checks with respect to a curve.

    If in_allow is true, the point can be on the curve interior. If on_allow is true, the point can be on the curve boundary. If out_allow is true, the point can be disjoint from the curve.

    If the point is in an "allowed" location, return true. Else, return false.

    If closed_curve is true, curve is treated as a closed curve where the first and last point are connected by a segment.

    julia
    function _point_curve_process(
    +    point, curve;
    +    in_allow, on_allow, out_allow,
    +    closed_curve = false,
    +)

    Determine if curve is closed

    julia
        n = GI.npoint(curve)
    +    first_last_equal = equals(GI.getpoint(curve, 1), GI.getpoint(curve, n))
    +    closed_curve |= first_last_equal
    +    n -= first_last_equal ? 1 : 0

    Loop through all curve segments

    julia
        p_start = GI.getpoint(curve, closed_curve ? n : 1)
    +    @inbounds for i in (closed_curve ? 1 : 2):n
    +        p_end = GI.getpoint(curve, i)
    +        seg_val = _point_segment_orientation(point, p_start, p_end)
    +        seg_val == point_in && return in_allow
    +        if seg_val == point_on
    +            if !closed_curve  # if point is on curve endpoints, it is "on"
    +                i == 2 && equals(point, p_start) && return on_allow
    +                i == n && equals(point, p_end) && return on_allow
    +            end
    +            return in_allow
    +        end
    +        p_start = p_end
    +    end
    +    return out_allow
    +end

    Determines if a point meets the given checks with respect to a polygon.

    If in_allow is true, the point can be within the polygon interior If on_allow is true, the point can be on the polygon boundary. If out_allow is true, the point can be disjoint from the polygon.

    If the point is in an "allowed" location, return true. Else, return false.

    julia
    function _point_polygon_process(
    +    point, polygon;
    +    in_allow, on_allow, out_allow, exact,
    +)

    Check interaction of geom with polygon's exterior boundary

    julia
        ext_val = _point_filled_curve_orientation(point, GI.getexterior(polygon); exact)

    If a point is outside, it isn't interacting with any holes

    julia
        ext_val == point_out && return out_allow

    if a point is on an external boundary, it isn't interacting with any holes

    julia
        ext_val == point_on && return on_allow

    If geom is within the polygon, need to check interactions with holes

    julia
        for hole in GI.gethole(polygon)
    +        hole_val = _point_filled_curve_orientation(point, hole; exact)

    If a point in in a hole, it is outside of the polygon

    julia
            hole_val == point_in && return out_allow

    If a point in on a hole edge, it is on the edge of the polygon

    julia
            hole_val == point_on && return on_allow
    +    end

    Point is within external boundary and on in/on any holes

    julia
        return in_allow
    +end

    Determines if a line meets the given checks with respect to a curve.

    If over_allow is true, segments of the line and curve can be co-linear. If cross_allow is true, segments of the line and curve can cross. If on_allow is true, endpoints of either the line or curve can intersect a segment of the other geometry. If cross_allow is true, segments of the line and curve can be disjoint.

    If in_require is true, the interiors of the line and curve must meet in at least one point. If on_require is true, the boundary of one of the two geometries can meet the interior or boundary of the other geometry in at least one point. If out_require is true, there must be at least one point of the given line that is exterior of the curve.

    If the point is in an "allowed" location and meets all requirements, return true. Else, return false.

    If closed_line is true, line is treated as a closed line where the first and last point are connected by a segment. Same with closed_curve.

    julia
    @inline function _line_curve_process(line, curve;
    +    over_allow, cross_allow, kw...
    +)
    +    skip, returnval = _maybe_skip_disjoint_extents(line, curve;
    +        in_allow=(over_allow | cross_allow), kw...
    +    )
    +    skip && return returnval
    +
    +    return _inner_line_curve_process(line, curve; over_allow, cross_allow, kw...)
    +end
    +
    +function _inner_line_curve_process(
    +    line, curve;
    +    over_allow, cross_allow, on_allow, out_allow,
    +    in_require, on_require, out_require,
    +    closed_line = false, closed_curve = false,
    +    exact,
    +)

    Set up requirements

    julia
        in_req_met = !in_require
    +    on_req_met = !on_require
    +    out_req_met = !out_require

    Determine curve endpoints

    julia
        nl = GI.npoint(line)
    +    nc = GI.npoint(curve)
    +    first_last_equal_line = equals(GI.getpoint(line, 1), GI.getpoint(line, nl))
    +    first_last_equal_curve = equals(GI.getpoint(curve, 1), GI.getpoint(curve, nc))
    +    nl -= first_last_equal_line ? 1 : 0
    +    nc -= first_last_equal_curve ? 1 : 0
    +    closed_line |= first_last_equal_line
    +    closed_curve |= first_last_equal_curve

    Loop over each line segment

    julia
        l_start = _tuple_point(GI.getpoint(line, closed_line ? nl : 1))
    +    i = closed_line ? 1 : 2
    +    while i  nl
    +        l_end = _tuple_point(GI.getpoint(line, i))
    +        c_start = _tuple_point(GI.getpoint(curve, closed_curve ? nc : 1))

    Loop over each curve segment

    julia
            for j in (closed_curve ? 1 : 2):nc
    +            c_end = _tuple_point(GI.getpoint(curve, j))

    Check if line and curve segments meet

    julia
                seg_val, intr1, _ = _intersection_point(Float64, (l_start, l_end), (c_start, c_end); exact)

    If segments are co-linear

    julia
                if seg_val == line_over
    +                !over_allow && return false

    at least one point in, meets requirements

    julia
                    in_req_met = true
    +                point_val = _point_segment_orientation(l_start, c_start, c_end)

    If entire segment isn't covered, consider remaining section

    julia
                    if point_val != point_out
    +                    i, l_start, break_off = _find_new_seg(i, l_start, l_end, c_start, c_end)
    +                    break_off && break
    +                end
    +            else
    +                if seg_val == line_cross
    +                    !cross_allow && return false
    +                    in_req_met = true
    +                elseif seg_val == line_hinge  # could cross or overlap

    Determine location of intersection point on each segment

    julia
                        (_, (α, β)) = intr1
    +                    if ( # Don't consider edges of curves as they can't cross
    +                        (!closed_line && ((α == 0 && i == 2) ||== 1 && i == nl))) ||
    +                        (!closed_curve && ((β == 0 && j == 2) ||== 1 && j == nc)))
    +                    )
    +                        !on_allow && return false
    +                        on_req_met = true
    +                    else
    +                        in_req_met = true

    If needed, determine if hinge actually crosses

    julia
                            if (!cross_allow || !over_allow) && α != 0 && β != 0

    Find next pieces of hinge to see if line and curve cross

    julia
                                l, c = _find_hinge_next_segments(
    +                                α, β, l_start, l_end, c_start, c_end,
    +                                i, line, j, curve,
    +                            )
    +                            next_val, _, _ = _intersection_point(Float64, l, c; exact)
    +                            if next_val == line_hinge
    +                                !cross_allow && return false
    +                            else
    +                                !over_allow && return false
    +                            end
    +                        end
    +                    end
    +                end

    no overlap for a give segment, some of segment must be out of curve

    julia
                    if j == nc
    +                    !out_allow && return false
    +                    out_req_met = true
    +                end
    +            end
    +            c_start = c_end  # consider next segment of curve
    +            if j == nc  # move on to next line segment
    +                i += 1
    +                l_start = l_end
    +            end
    +        end
    +    end
    +    return in_req_met && on_req_met && out_req_met
    +end
    +
    +#= If entire segment (le to ls) isn't covered by segment (cs to ce), find remaining section
    +part of section outside of cs to ce. If completely covered, increase segment index i. =#
    +function _find_new_seg(i, ls, le, cs, ce)
    +    break_off = true
    +    if _point_segment_orientation(le, cs, ce) != point_out
    +        ls = le
    +        i += 1
    +    elseif !equals(ls, cs) && _point_segment_orientation(cs, ls, le) != point_out
    +        ls = cs
    +    elseif !equals(ls, ce) && _point_segment_orientation(ce, ls, le) != point_out
    +        ls = ce
    +    else
    +        break_off = false
    +    end
    +    return i, ls, break_off
    +end
    +
    +#= Find next set of segments needed to determine if given hinge segments cross or not.=#
    +function _find_hinge_next_segments(α, β, ls, le, cs, ce, i, line, j, curve)
    +    next_seg = if β == 1
    +        if α == 1  # hinge at endpoints, so next segment of both is needed
    +            ((le, _tuple_point(GI.getpoint(line, i + 1))), (ce, _tuple_point(GI.getpoint(curve, j + 1))))
    +        else  # hinge at curve endpoint and line interior point, curve next segment needed
    +            ((ls, le), (ce, _tuple_point(GI.getpoint(curve, j + 1))))
    +        end
    +    else  # hinge at curve interior point and line endpoint, line next segment needed
    +        ((le, _tuple_point(GI.getpoint(line, i + 1))), (cs, ce))
    +    end
    +    return next_seg
    +end

    Determines if a line meets the given checks with respect to a polygon.

    If in_allow is true, segments of the line can be in the polygon interior. If on_allow is true, segments of the line can be on the polygon's boundary. If out_allow is true, segments of the line can be outside of the polygon.

    If in_require is true, the interiors of the line and polygon must meet in at least one point. If on_require is true, the line must have at least one point on the polygon'same boundary. If out_require is true, the line must have at least one point outside of the polygon.

    If the point is in an "allowed" location and meets all requirements, return true. Else, return false.

    If closed_line is true, line is treated as a closed line where the first and last point are connected by a segment.

    julia
    @inline function _line_polygon_process(line, polygon; kw...)
    +    skip, returnval = _maybe_skip_disjoint_extents(line, polygon; kw...)
    +    skip && return returnval
    +    return _inner_line_polygon_process(line, polygon; kw...)
    +end
    +
    +function _inner_line_polygon_process(
    +    line, polygon;
    +    in_allow, on_allow, out_allow,
    +    in_require, on_require, out_require,
    +    exact, closed_line = false,
    +)
    +    in_req_met = !in_require
    +    on_req_met = !on_require
    +    out_req_met = !out_require

    Check interaction of line with polygon's exterior boundary

    julia
        in_curve, on_curve, out_curve = _line_filled_curve_interactions(
    +        line, GI.getexterior(polygon);
    +        exact, closed_line = closed_line,
    +    )
    +    if on_curve
    +        !on_allow && return false
    +        on_req_met = true
    +    end
    +    if out_curve
    +        !out_allow && return false
    +        out_req_met = true
    +    end

    If no points within the polygon, the line is disjoint and we are done

    julia
        !in_curve && return in_req_met && on_req_met && out_req_met

    Loop over polygon holes

    julia
        for hole in GI.gethole(polygon)
    +        in_hole, on_hole, out_hole =_line_filled_curve_interactions(
    +            line, hole;
    +            exact, closed_line = closed_line,
    +        )
    +        if in_hole  # line in hole is equivalent to being out of polygon
    +            !out_allow && return false
    +            out_req_met = true
    +        end
    +        if on_hole  # hole boundary is polygon boundary
    +            !on_allow && return false
    +            on_req_met = true
    +        end
    +        if !out_hole  # entire line is in/on hole, can't be in/on other holes
    +            in_curve = false
    +            break
    +        end
    +    end
    +    if in_curve  # entirely of curve isn't within a hole
    +        !in_allow && return false
    +        in_req_met = true
    +    end
    +    return in_req_met && on_req_met && out_req_met
    +end

    Determines if a polygon meets the given checks with respect to a polygon.

    If in_allow is true, the polygon's interiors must intersect. If on_allow is true, the one of the polygon's boundaries must either interact with the other polygon's boundary or interior. If out_allow is true, the first polygon must have interior regions outside of the second polygon.

    If in_require is true, the polygon interiors must meet in at least one point. If on_require is true, one of the polygon's must have at least one boundary point in or on the other polygon. If out_require is true, the first polygon must have at least one interior point outside of the second polygon.

    If the point is in an "allowed" location and meets all requirements, return true. Else, return false.

    julia
    @inline function _polygon_polygon_process(poly1, poly2; kw...)
    +    skip, returnval = _maybe_skip_disjoint_extents(poly1, poly2; kw...)
    +    skip && return returnval
    +    return _inner_polygon_polygon_process(poly1, poly2; kw...)
    +end
    +
    +function _inner_polygon_polygon_process(
    +    poly1, poly2;
    +    in_allow, on_allow, out_allow,
    +    in_require, on_require, out_require,
    +    exact,
    +)
    +    in_req_met = !in_require
    +    on_req_met = !on_require
    +    out_req_met = !out_require

    Check if exterior of poly1 is within poly2

    julia
        ext1 = GI.getexterior(poly1)
    +    ext2 = GI.getexterior(poly2)

    Check if exterior of poly1 is in polygon 2

    julia
        e1_in_p2, e1_on_p2, e1_out_p2 = _line_polygon_interactions(
    +        ext1, poly2;
    +        exact, closed_line = true,
    +    )
    +    if e1_on_p2
    +        !on_allow && return false
    +        on_req_met = true
    +    end
    +    if e1_out_p2
    +        !out_allow && return false
    +        out_req_met = true
    +    end
    +
    +    if !e1_in_p2

    if exterior ring isn't in poly2, check if it surrounds poly2

    julia
            _, _, e2_out_e1 = _line_filled_curve_interactions(
    +            ext2, ext1;
    +            exact, closed_line = true,
    +        )  # if they really are disjoint, we are done
    +        e2_out_e1 && return in_req_met && on_req_met && out_req_met
    +    end

    If interiors interact, check if poly2 interacts with any of poly1's holes

    julia
        for h1 in GI.gethole(poly1)
    +        h1_in_p2, h1_on_p2, h1_out_p2 = _line_polygon_interactions(
    +            h1, poly2;
    +            exact, closed_line = true,
    +        )
    +        if h1_on_p2
    +            !on_allow && return false
    +            on_req_met = true
    +        end
    +        if h1_out_p2
    +            !out_allow && return false
    +            out_req_met = true
    +        end
    +        if !h1_in_p2

    If hole isn't in poly2, see if poly2 is in hole

    julia
                _, _, e2_out_h1 = _line_filled_curve_interactions(
    +                ext2, h1;
    +                exact, closed_line = true,
    +            )

    hole encompasses all of poly2

    julia
                !e2_out_h1 && return in_req_met && on_req_met && out_req_met
    +            break
    +        end
    +    end
    +    #=
    +    poly2 isn't outside of poly1 and isn't in a hole, poly1 interior must
    +    interact with poly2 interior
    +    =#
    +    !in_allow && return false
    +    in_req_met = true

    If any of poly2 holes are within poly1, part of poly1 is exterior to poly2

    julia
        for h2 in GI.gethole(poly2)
    +        h2_in_p1, h2_on_p1, _ = _line_polygon_interactions(
    +            h2, poly1;
    +            exact, closed_line = true,
    +        )
    +        if h2_on_p1
    +            !on_allow && return false
    +            on_req_met = true
    +        end
    +        if h2_in_p1
    +            !out_allow && return false
    +            out_req_met = true
    +        end
    +    end
    +    return in_req_met && on_req_met && out_req_met
    +end

    Determines if a point is in, on, or out of a segment. If the point is on the segment it is on one of the segments endpoints. If it is in, it is on any other point of the segment. If the point is not on any part of the segment, it is out of the segment.

    Point should be an object of point trait and curve should be an object with a linestring or linearring trait.

    Can provide values of in, on, and out keywords, which determines return values for each scenario.

    julia
    function _point_segment_orientation(
    +    point, start, stop;
    +    in::T = point_in, on::T = point_on, out::T = point_out,
    +) where {T}

    Parse out points

    julia
        x, y = GI.x(point), GI.y(point)
    +    x1, y1 = GI.x(start), GI.y(start)
    +    x2, y2 = GI.x(stop), GI.y(stop)
    +    Δx_seg = x2 - x1
    +    Δy_seg = y2 - y1
    +    Δx_pt = x - x1
    +    Δy_pt = y - y1
    +    if (Δx_pt == 0 && Δy_pt == 0) || (Δx_pt == Δx_seg && Δy_pt == Δy_seg)

    If point is equal to the segment start or end points

    julia
            return on
    +    else
    +        #=
    +        Determine if the point is on the segment -> see if vector from segment
    +        start to point is parallel to segment and if point is between the
    +        segment endpoints
    +        =#
    +        on_line = _isparallel(Δx_seg, Δy_seg, Δx_pt, Δy_pt)
    +        !on_line && return out
    +        between_endpoints =
    +            (x2 > x1 ? x1 <= x <= x2 : x2 <= x <= x1) &&
    +            (y2 > y1 ? y1 <= y <= y2 : y2 <= y <= y1)
    +        !between_endpoints && return out
    +    end
    +    return in
    +end

    Determine if point is in, on, or out of a closed curve, which includes the space enclosed by the closed curve.

    In means the point is within the closed curve (excluding edges and vertices). On means the point is on an edge or a vertex of the closed curve. Out means the point is outside of the closed curve.

    Point should be an object of point trait and curve should be an object with a linestring or linearring trait, that is assumed to be closed, regardless of repeated last point.

    Can provide values of in, on, and out keywords, which determines return values for each scenario.

    Note that this uses the Algorithm by Hao and Sun (2018): https://doi.org/10.3390/sym10100477 Paper separates orientation of point and edge into 26 cases. For each case, it is either a case where the point is on the edge (returns on), where a ray from the point (x, y) to infinity along the line y = y cut through the edge (k += 1), or the ray does not pass through the edge (do nothing and continue). If the ray passes through an odd number of edges, it is within the curve, else outside of of the curve if it didn't return 'on'. See paper for more information on cases denoted in comments.

    julia
    function _point_filled_curve_orientation(
    +    point, curve;
    +    in::T = point_in, on::T = point_on, out::T = point_out, exact,
    +) where {T}
    +    x, y = GI.x(point), GI.y(point)
    +    n = GI.npoint(curve)
    +    n -= equals(GI.getpoint(curve, 1), GI.getpoint(curve, n)) ? 1 : 0
    +    k = 0  # counter for ray crossings
    +    p_start = GI.getpoint(curve, n)
    +    for (i, p_end) in enumerate(GI.getpoint(curve))
    +        i > n && break
    +        v1 = GI.y(p_start) - y
    +        v2 = GI.y(p_end) - y
    +        if !((v1 < 0 && v2 < 0) || (v1 > 0 && v2 > 0)) # if not cases 11 or 26
    +            u1, u2 = GI.x(p_start) - x, GI.x(p_end) - x
    +            f = Predicates.cross((u1, u2), (v1, v2); exact)
    +            if v2 > 0 && v1  0                # Case 3, 9, 16, 21, 13, or 24
    +                f == 0 && return on         # Case 16 or 21
    +                f > 0 && (k += 1)              # Case 3 or 9
    +            elseif v1 > 0 && v2  0            # Case 4, 10, 19, 20, 12, or 25
    +                f == 0 && return on         # Case 19 or 20
    +                f < 0 && (k += 1)              # Case 4 or 10
    +            elseif v2 == 0 && v1 < 0           # Case 7, 14, or 17
    +                f == 0 && return on         # Case 17
    +            elseif v1 == 0 && v2 < 0           # Case 8, 15, or 18
    +                f == 0 && return on         # Case 18
    +            elseif v1 == 0 && v2 == 0          # Case 1, 2, 5, 6, 22, or 23
    +                u2  0 && u1  0 && return on  # Case 1
    +                u1  0 && u2  0 && return on  # Case 2
    +            end
    +        end
    +        p_start = p_end
    +    end
    +    return iseven(k) ? out : in
    +end

    Determines the types of interactions of a line with a filled-in curve. By filled-in curve, I am referring to the exterior ring of a poylgon, for example.

    Returns a tuple of booleans: (in_curve, on_curve, out_curve).

    If in_curve is true, some of the lines interior points interact with the curve's interior points. If on_curve is true, endpoints of either the line intersect with the curve or the line interacts with the polygon boundary. If out_curve is true, at least one segments of the line is outside the curve.

    If closed_line is true, line is treated as a closed line where the first and last point are connected by a segment.

    julia
    function _line_filled_curve_interactions(
    +    line, curve;
    +    exact, closed_line = false,
    +)
    +    in_curve = false
    +    on_curve = false
    +    out_curve = false

    Determine number of points in curve and line

    julia
        nl = GI.npoint(line)
    +    nc = GI.npoint(curve)
    +    first_last_equal_line = equals(GI.getpoint(line, 1), GI.getpoint(line, nl))
    +    first_last_equal_curve = equals(GI.getpoint(curve, 1), GI.getpoint(curve, nc))
    +    nl -= first_last_equal_line ? 1 : 0
    +    nc -= first_last_equal_curve ? 1 : 0
    +    closed_line |= first_last_equal_line

    See if first point is in an acceptable orientation

    julia
        l_start = _tuple_point(GI.getpoint(line, closed_line ? nl : 1))
    +    point_val = _point_filled_curve_orientation(l_start, curve; exact)
    +    if point_val == point_in
    +        in_curve = true
    +    elseif point_val == point_on
    +        on_curve = true
    +    else  # point_val == point_out
    +        out_curve = true
    +    end

    Check for any intersections between line and curve

    julia
        for i in (closed_line ? 1 : 2):nl
    +        l_end = _tuple_point(GI.getpoint(line, i))
    +        c_start = _tuple_point(GI.getpoint(curve, nc))

    If already interacted with all regions of curve, can stop

    julia
            in_curve && on_curve && out_curve && break

    Check next segment of line against curve

    julia
            for j in 1:nc
    +            c_end = _tuple_point(GI.getpoint(curve, j))

    Check if two line and curve segments meet

    julia
                seg_val, _, _ = _intersection_point(Float64, (l_start, l_end), (c_start, c_end); exact)
    +            if seg_val != line_out

    If line and curve meet, then at least one point is on boundary

    julia
                    on_curve = true
    +                if seg_val == line_cross

    When crossing boundary, line is both in and out of curve

    julia
                        in_curve = true
    +                    out_curve = true
    +                else
    +                    if seg_val == line_over
    +                        sp = _point_segment_orientation(l_start, c_start, c_end)
    +                        lp = _point_segment_orientation(l_end, c_start, c_end)
    +                        if sp != point_in || lp != point_in
    +                            #=
    +                            Line crosses over segment endpoint, creating a hinge
    +                            with another segment.
    +                            =#
    +                            seg_val = line_hinge
    +                        end
    +                    end
    +                    if seg_val == line_hinge
    +                        #=
    +                        Can't determine all types of interactions (in, out) with
    +                        hinge as it could pass through multiple other segments
    +                        so calculate if segment endpoints and intersections are
    +                        in/out of filled curve
    +                        =#
    +                        ipoints = intersection_points(GI.Line(StaticArrays.SVector(l_start, l_end)), curve)
    +                        npoints = length(ipoints)  # since hinge, at least one
    +                        dist_from_lstart = let l_start = l_start
    +                            x -> _euclid_distance(Float64, x, l_start)
    +                        end
    +                        sort!(ipoints, by = dist_from_lstart)
    +                        p_start = _tuple_point(l_start)
    +                        for i in 1:(npoints + 1)
    +                            p_end = i  npoints ? _tuple_point(ipoints[i]) : l_end
    +                            mid_val = _point_filled_curve_orientation((p_start .+ p_end) ./ 2, curve; exact)
    +                            if mid_val == point_in
    +                                in_curve = true
    +                            elseif mid_val == point_out
    +                                out_curve = true
    +                            end
    +                        end

    already checked segment against whole filled curve

    julia
                            l_start = l_end
    +                        break
    +                    end
    +                end
    +            end
    +            c_start = c_end
    +        end
    +        l_start = l_end
    +    end
    +    return in_curve, on_curve, out_curve
    +end

    Determines the types of interactions of a line with a polygon.

    Returns a tuple of booleans: (in_poly, on_poly, out_poly).

    If in_poly is true, some of the lines interior points interact with the polygon interior points. If in_poly is true, endpoints of either the line intersect with the polygon or the line interacts with the polygon boundary, including hole boundaries. If out_curve is true, at least one segments of the line is outside the polygon, including inside of holes.

    If closed_line is true, line is treated as a closed line where the first and last point are connected by a segment.

    julia
    function _line_polygon_interactions(
    +    line, polygon;
    +    exact, closed_line = false,
    +)
    +
    +    in_poly, on_poly, out_poly = _line_filled_curve_interactions(
    +        line, GI.getexterior(polygon);
    +        exact, closed_line = closed_line,
    +    )
    +    !in_poly && return (in_poly, on_poly, out_poly)

    Loop over polygon holes

    julia
        for hole in GI.gethole(polygon)
    +        in_hole, on_hole, out_hole =_line_filled_curve_interactions(
    +            line, hole;
    +            exact, closed_line = closed_line,
    +        )
    +        if in_hole
    +            out_poly = true
    +        end
    +        if on_hole
    +            on_poly = true
    +        end
    +        if !out_hole  # entire line is in/on hole, can't be in/on other holes
    +            in_poly = false
    +            return (in_poly, on_poly, out_poly)
    +        end
    +    end
    +    return in_poly, on_poly, out_poly
    +end

    Disjoint extent optimisation: skip work based on geom extent intersection returns Tuple{Bool, Bool} for (skip, returnval)

    julia
    @inline function _maybe_skip_disjoint_extents(a, b;
    +    in_allow, on_allow, out_allow,
    +    in_require, on_require, out_require,
    +    kw...
    +)
    +    ext_disjoint = Extents.disjoint(GI.extent(a), GI.extent(b))
    +    skip, returnval = if !ext_disjoint

    can't tell anything about this case

    julia
            false, false
    +    elseif out_allow # && ext_disjoint
    +        if in_require || on_require
    +            true, false
    +        else
    +            true, true
    +        end
    +    else  # !out_allow && ext_disjoint

    points not allowed in exterior, but geoms are disjoint

    julia
            true, false
    +    end
    +    return skip, returnval
    +end

    This page was generated using Literate.jl.

    + + + + \ No newline at end of file diff --git a/previews/PR237/source/methods/geom_relations/intersects.html b/previews/PR237/source/methods/geom_relations/intersects.html new file mode 100644 index 000000000..0817cc7c0 --- /dev/null +++ b/previews/PR237/source/methods/geom_relations/intersects.html @@ -0,0 +1,51 @@ + + + + + + Intersection checks | GeometryOps.jl + + + + + + + + + + + + + + +
    Skip to content

    Intersection checks

    julia
    export intersects

    What is intersects?

    The intersects function checks if a given geometry intersects with another geometry, or in other words, the either the interiors or boundaries of the two geometries intersect.

    To provide an example, consider these two lines:

    julia
    import GeometryOps as GO
    +import GeoInterface as GI
    +using Makie
    +using CairoMakie
    +
    +line1 = GI.Line([(124.584961,-12.768946), (126.738281,-17.224758)])
    +line2 = GI.Line([(123.354492,-15.961329), (127.22168,-14.008696)])
    +f, a, p = lines(GI.getpoint(line1))
    +lines!(GI.getpoint(line2))
    +f

    We can see that they intersect, so we expect intersects to return true, and we can visualize the intersection point in red.

    julia
    GO.intersects(line1, line2)  # true
    true

    Implementation

    This is the GeoInterface-compatible implementation.

    Given that intersects is the exact opposite of disjoint, we simply pass the two inputs variables, swapped in order, to disjoint.

    julia
    """
    +    intersects(geom1, geom2)::Bool
    +
    +Return true if the interiors or boundaries of the two geometries interact.
    +
    +`intersects` returns the exact opposite result of `disjoint`.
    +
    +# Example
    +
    +```jldoctest
    +import GeoInterface as GI, GeometryOps as GO
    +
    +line1 = GI.Line([(124.584961,-12.768946), (126.738281,-17.224758)])
    +line2 = GI.Line([(123.354492,-15.961329), (127.22168,-14.008696)])
    +GO.intersects(line1, line2)

    output

    julia
    true
    +```
    +"""
    +intersects(geom1, geom2) = !disjoint(geom1, geom2)

    This page was generated using Literate.jl.

    + + + + \ No newline at end of file diff --git a/previews/PR237/source/methods/geom_relations/overlaps.html b/previews/PR237/source/methods/geom_relations/overlaps.html new file mode 100644 index 000000000..55fd77229 --- /dev/null +++ b/previews/PR237/source/methods/geom_relations/overlaps.html @@ -0,0 +1,236 @@ + + + + + + Overlaps | GeometryOps.jl + + + + + + + + + + + + + + +
    Skip to content

    Overlaps

    julia
    export overlaps

    What is overlaps?

    The overlaps function checks if two geometries overlap. Two geometries can only overlap if they have the same dimension, and if they overlap, but one is not contained, within, or equal to the other.

    Note that this means it is impossible for a single point to overlap with a single point and a line only overlaps with another line if only a section of each line is collinear.

    To provide an example, consider these two lines:

    julia
    import GeometryOps as GO
    +import GeoInterface as GI
    +using Makie
    +using CairoMakie
    +
    +l1 = GI.LineString([(0.0, 0.0), (0.0, 10.0)])
    +l2 = GI.LineString([(0.0, -10.0), (0.0, 3.0)])
    +f, a, p = lines(GI.getpoint(l1), color = :blue)
    +scatter!(GI.getpoint(l1), color = :blue)
    +lines!(GI.getpoint(l2), color = :orange)
    +scatter!(GI.getpoint(l2), color = :orange)
    +f

    We can see that the two lines overlap in the plot:

    julia
    GO.overlaps(l1, l2)  # true
    true

    Implementation

    This is the GeoInterface-compatible implementation.

    First, we implement a wrapper method that dispatches to the correct implementation based on the geometry trait. This is also used in the implementation, since it's a lot less work!

    Note that that since only elements of the same dimension can overlap, any two geometries with traits that are of different dimensions automatically can return false.

    For geometries with the same trait dimension, we must make sure that they share a point, an edge, or area for points, lines, and polygons/multipolygons respectively, without being contained.

    julia
    """
    +    overlaps(geom1, geom2)::Bool
    +
    +Compare two Geometries of the same dimension and return true if their
    +intersection set results in a geometry different from both but of the same
    +dimension. This means one geometry cannot be within or contain the other and
    +they cannot be equal
    +
    +# Examples
    +```jldoctest
    +import GeometryOps as GO, GeoInterface as GI
    +poly1 = GI.Polygon([[(0,0), (0,5), (5,5), (5,0), (0,0)]])
    +poly2 = GI.Polygon([[(1,1), (1,6), (6,6), (6,1), (1,1)]])
    +
    +GO.overlaps(poly1, poly2)

    output

    julia
    true
    +```
    +"""
    +overlaps(geom1, geom2)::Bool = overlaps(
    +    GI.trait(geom1),
    +    geom1,
    +    GI.trait(geom2),
    +    geom2,
    +)
    +
    +"""
    +    overlaps(::GI.AbstractTrait, geom1, ::GI.AbstractTrait, geom2)::Bool
    +
    +For any non-specified pair, all have non-matching dimensions, return false.
    +"""
    +overlaps(::GI.AbstractTrait, geom1, ::GI.AbstractTrait, geom2) = false
    +
    +"""
    +    overlaps(
    +        ::GI.MultiPointTrait, points1,
    +        ::GI.MultiPointTrait, points2,
    +    )::Bool
    +
    +If the multipoints overlap, meaning some, but not all, of the points within the
    +multipoints are shared, return true.
    +"""
    +function overlaps(
    +    ::GI.MultiPointTrait, points1,
    +    ::GI.MultiPointTrait, points2,
    +)
    +    one_diff = false  # assume that all the points are the same
    +    one_same = false  # assume that all points are different
    +    for p1 in GI.getpoint(points1)
    +        match_point = false
    +        for p2 in GI.getpoint(points2)
    +            if equals(p1, p2)  # Point is shared
    +                one_same = true
    +                match_point = true
    +                break
    +            end
    +        end
    +        one_diff |= !match_point  # Point isn't shared
    +        one_same && one_diff && return true
    +    end
    +    return false
    +end
    +
    +"""
    +    overlaps(::GI.LineTrait, line1, ::GI.LineTrait, line)::Bool
    +
    +If the lines overlap, meaning that they are collinear but each have one endpoint
    +outside of the other line, return true. Else false.
    +"""
    +overlaps(::GI.LineTrait, line1, ::GI.LineTrait, line) =
    +    _overlaps((a1, a2), (b1, b2))
    +
    +"""
    +    overlaps(
    +        ::Union{GI.LineStringTrait, GI.LinearRing}, line1,
    +        ::Union{GI.LineStringTrait, GI.LinearRing}, line2,
    +    )::Bool
    +
    +If the curves overlap, meaning that at least one edge of each curve overlaps,
    +return true. Else false.
    +"""
    +function overlaps(
    +    ::Union{GI.LineStringTrait, GI.LinearRing}, line1,
    +    ::Union{GI.LineStringTrait, GI.LinearRing}, line2,
    +)
    +    edges_a, edges_b = map(sort! ∘ to_edges, (line1, line2))
    +    for edge_a in edges_a
    +        for edge_b in edges_b
    +            _overlaps(edge_a, edge_b) && return true
    +        end
    +    end
    +    return false
    +end
    +
    +"""
    +    overlaps(
    +        trait_a::GI.PolygonTrait, poly_a,
    +        trait_b::GI.PolygonTrait, poly_b,
    +    )::Bool
    +
    +If the two polygons intersect with one another, but are not equal, return true.
    +Else false.
    +"""
    +function overlaps(
    +    trait_a::GI.PolygonTrait, poly_a,
    +    trait_b::GI.PolygonTrait, poly_b,
    +)
    +    edges_a, edges_b = map(sort! ∘ to_edges, (poly_a, poly_b))
    +    return _line_intersects(edges_a, edges_b) &&
    +        !equals(trait_a, poly_a, trait_b, poly_b)
    +end
    +
    +"""
    +    overlaps(
    +        ::GI.PolygonTrait, poly1,
    +        ::GI.MultiPolygonTrait, polys2,
    +    )::Bool
    +
    +Return true if polygon overlaps with at least one of the polygons within the
    +multipolygon. Else false.
    +"""
    +function overlaps(
    +    ::GI.PolygonTrait, poly1,
    +    ::GI.MultiPolygonTrait, polys2,
    +)
    +    for poly2 in GI.getgeom(polys2)
    +        overlaps(poly1, poly2) && return true
    +    end
    +    return false
    +end
    +
    +"""
    +    overlaps(
    +        ::GI.MultiPolygonTrait, polys1,
    +        ::GI.PolygonTrait, poly2,
    +    )::Bool
    +
    +Return true if polygon overlaps with at least one of the polygons within the
    +multipolygon. Else false.
    +"""
    +overlaps(trait1::GI.MultiPolygonTrait, polys1, trait2::GI.PolygonTrait, poly2) =
    +    overlaps(trait2, poly2, trait1, polys1)
    +
    +"""
    +    overlaps(
    +        ::GI.MultiPolygonTrait, polys1,
    +        ::GI.MultiPolygonTrait, polys2,
    +    )::Bool
    +
    +Return true if at least one pair of polygons from multipolygons overlap. Else
    +false.
    +"""
    +function overlaps(
    +    ::GI.MultiPolygonTrait, polys1,
    +    ::GI.MultiPolygonTrait, polys2,
    +)
    +    for poly1 in GI.getgeom(polys1)
    +        overlaps(poly1, polys2) && return true
    +    end
    +    return false
    +end
    +
    +#= If the edges overlap, meaning that they are collinear but each have one endpoint
    +outside of the other edge, return true. Else false. =#
    +function _overlaps(
    +    (a1, a2)::Edge,
    +    (b1, b2)::Edge,
    +    exact = _False(),
    +)

    meets in more than one point

    julia
        seg_val, _, _ = _intersection_point(Float64, (a1, a2), (b1, b2); exact)

    one end point is outside of other segment

    julia
        a_fully_within = _point_on_seg(a1, b1, b2) && _point_on_seg(a2, b1, b2)
    +    b_fully_within = _point_on_seg(b1, a1, a2) && _point_on_seg(b2, a1, a2)
    +    return seg_val == line_over && (!a_fully_within && !b_fully_within)
    +end
    +
    +#= TODO: Once overlaps is swapped over to use the geom relations workflow, can
    +delete these helpers. =#

    Checks if point is on a segment

    julia
    function _point_on_seg(point, start, stop)

    Parse out points

    julia
        x, y = GI.x(point), GI.y(point)
    +    x1, y1 = GI.x(start), GI.y(start)
    +    x2, y2 = GI.x(stop), GI.y(stop)
    +    Δxl = x2 - x1
    +    Δyl = y2 - y1

    Determine if point is on segment

    julia
        cross = (x - x1) * Δyl - (y - y1) * Δxl
    +    if cross == 0  # point is on line extending to infinity

    is line between endpoints

    julia
            if abs(Δxl) >= abs(Δyl)  # is line between endpoints
    +            return Δxl > 0 ? x1 <= x <= x2 : x2 <= x <= x1
    +        else
    +            return Δyl > 0 ? y1 <= y <= y2 : y2 <= y <= y1
    +        end
    +    end
    +    return false
    +end
    +
    +#= Returns true if there is at least one intersection between edges within the
    +two lists of edges. =#
    +function _line_intersects(
    +    edges_a::Vector{<:Edge},
    +    edges_b::Vector{<:Edge};
    +)

    Extents.intersects(to_extent(edges_a), to_extent(edges_b)) || return false

    julia
        for edge_a in edges_a
    +        for edge_b in edges_b
    +            _line_intersects(edge_a, edge_b) && return true
    +        end
    +    end
    +    return false
    +end

    Returns true if there is at least one intersection between two edges.

    julia
    function _line_intersects(edge_a::Edge, edge_b::Edge)
    +    seg_val, _, _ = _intersection_point(Float64, edge_a, edge_b; exact = _False())
    +    return seg_val != line_out
    +end

    This page was generated using Literate.jl.

    + + + + \ No newline at end of file diff --git a/previews/PR237/source/methods/geom_relations/touches.html b/previews/PR237/source/methods/geom_relations/touches.html new file mode 100644 index 000000000..071353e6b --- /dev/null +++ b/previews/PR237/source/methods/geom_relations/touches.html @@ -0,0 +1,198 @@ + + + + + + Touches | GeometryOps.jl + + + + + + + + + + + + + + +
    Skip to content

    Touches

    julia
    export touches

    What is touches?

    The touches function checks if one geometry touches another geometry. In other words, the interiors of the two geometries don't interact, but one of the geometries must have a boundary point that interacts with either the other geometry's interior or boundary.

    To provide an example, consider these two lines:

    julia
    import GeometryOps as GO
    +import GeoInterface as GI
    +using Makie
    +using CairoMakie
    +
    +l1 = GI.Line([(0.0, 0.0), (1.0, 0.0)])
    +l2 = GI.Line([(1.0, 0.0), (1.0, -1.0)])
    +
    +f, a, p = lines(GI.getpoint(l1))
    +lines!(GI.getpoint(l2))
    +f

    We can see that these two lines touch only at their endpoints.

    julia
    GO.touches(l1, l2)  # true
    true

    Implementation

    This is the GeoInterface-compatible implementation.

    First, we implement a wrapper method that dispatches to the correct implementation based on the geometry trait.

    Each of these calls a method in the geom_geom_processors file. The methods in this file determine if the given geometries meet a set of criteria. For the touches function and arguments g1 and g2, this criteria is as follows: - points of g1 are not allowed to be in the interior of g2 - points of g1 are allowed to be on the boundary of g2 - points of g1 are allowed to be in the exterior of g2 - no points of g1 are required to be in the interior of g2 - at least one point of g1 is required to be on the boundary of g2 - no points of g1 are required to be in the exterior of g2

    The code for the specific implementations is in the geom_geom_processors file.

    julia
    const TOUCHES_POINT_ALLOWED = (in_allow = false, on_allow = true, out_allow = false)
    +const TOUCHES_CURVE_ALLOWED = (over_allow = false, cross_allow = false, on_allow = true, out_allow = true)
    +const TOUCHES_POLYGON_ALLOWS = (in_allow = false, on_allow = true, out_allow = true)
    +const TOUCHES_REQUIRES = (in_require = false, on_require = true, out_require = false)
    +const TOUCHES_EXACT = (exact = _False(),)
    +
    +"""
    +    touches(geom1, geom2)::Bool
    +
    +Return `true` if the first geometry touches the second geometry. In other words,
    +the two interiors cannot interact, but one of the geometries must have a
    +boundary point that interacts with either the other geometry's interior or
    +boundary.
    +
    +# Examples
    +```jldoctest setup=:(using GeometryOps, GeometryBasics)
    +import GeometryOps as GO, GeoInterface as GI
    +
    +l1 = GI.Line([(0.0, 0.0), (1.0, 0.0)])
    +l2 = GI.Line([(1.0, 1.0), (1.0, -1.0)])
    +
    +GO.touches(l1, l2)

    output

    julia
    true
    +```
    +"""
    +touches(g1, g2)::Bool = _touches(trait(g1), g1, trait(g2), g2)

    Convert features to geometries

    julia
    _touches(::GI.FeatureTrait, g1, ::Any, g2) = touches(GI.geometry(g1), g2)
    +_touches(::Any, g1, t2::GI.FeatureTrait, g2) = touches(g1, GI.geometry(g2))
    +_touches(::FeatureTrait, g1, ::FeatureTrait, g2) = touches(GI.geometry(g1), GI.geometry(g2))

    Point touches geometries

    Point cannot touch another point as if they are equal, interiors interact

    julia
    _touches(
    +    ::GI.PointTrait, g1,
    +    ::GI.PointTrait, g2,
    +) = false

    Point touches a linestring if it equal to the first of last point of the line

    julia
    function _touches(
    +    ::GI.PointTrait, g1,
    +    ::Union{GI.LineTrait, GI.LineStringTrait}, g2,
    +)
    +    n = GI.npoint(g2)
    +    p1 = GI.getpoint(g2, 1)
    +    pn = GI.getpoint(g2, n)
    +    equals(p1, pn) && return false
    +    return equals(g1, p1) || equals(g1, pn)
    +end

    Point cannot 'touch' a linearring given that the ring has no boundary points

    julia
    _touches(
    +    ::GI.PointTrait, g1,
    +    ::GI.LinearRingTrait, g2,
    +) = false

    Point touches a polygon if it is on the boundary of that polygon

    julia
    _touches(
    +    ::GI.PointTrait, g1,
    +    ::GI.PolygonTrait, g2,
    +) = _point_polygon_process(
    +    g1, g2;
    +    TOUCHES_POINT_ALLOWED...,
    +    TOUCHES_EXACT...,
    +)
    +
    +#= Geometry touches a point if the point is on the geometry boundary. =#
    +_touches(
    +    trait1::Union{GI.AbstractCurveTrait, GI.PolygonTrait}, g1,
    +    trait2::GI.PointTrait, g2,
    +) = _touches(trait2, g2, trait1, g1)

    Lines touching geometries

    julia
    #= Linestring touches another line if at least one boundary point interacts with
    +the boundary of interior of the other line, but the interiors don't interact. =#
    +_touches(
    +    ::Union{GI.LineTrait, GI.LineStringTrait}, g1,
    +    ::Union{GI.LineTrait, GI.LineStringTrait}, g2,
    +) = _line_curve_process(
    +    g1, g2;
    +    TOUCHES_CURVE_ALLOWED...,
    +    TOUCHES_REQUIRES...,
    +    TOUCHES_EXACT...,
    +    closed_line = false,
    +    closed_curve = false,
    +)
    +
    +
    +#= Linestring touches a linearring if at least one of the boundary points of the
    +line interacts with the linear ring, but their interiors can't interact. =#
    +_touches(
    +    ::Union{GI.LineTrait, GI.LineStringTrait}, g1,
    +    ::GI.LinearRingTrait, g2,
    +) = _line_curve_process(
    +    g1, g2;
    +    TOUCHES_CURVE_ALLOWED...,
    +    TOUCHES_REQUIRES...,
    +    TOUCHES_EXACT...,
    +    closed_line = false,
    +    closed_curve = true,
    +)
    +
    +#= Linestring touches a polygon if at least one of the boundary points of the
    +line interacts with the boundary of the polygon. =#
    +_touches(
    +    ::Union{GI.LineTrait, GI.LineStringTrait}, g1,
    +    ::GI.PolygonTrait, g2,
    +) = _line_polygon_process(
    +    g1, g2;
    +    TOUCHES_POLYGON_ALLOWS...,
    +    TOUCHES_REQUIRES...,
    +    TOUCHES_EXACT...,
    +    closed_line = false,
    +)

    Rings touch geometries

    julia
    #= Linearring touches a linestring if at least one of the boundary points of the
    +line interacts with the linear ring, but their interiors can't interact. =#
    +_touches(
    +    trait1::GI.LinearRingTrait, g1,
    +    trait2::Union{GI.LineTrait, GI.LineStringTrait}, g2,
    +) = _touches(trait2, g2, trait1, g1)
    +
    +#= Linearring cannot touch another linear ring since they are both exclusively
    +made up of interior points and no boundary points =#
    +_touches(
    +    ::GI.LinearRingTrait, g1,
    +    ::GI.LinearRingTrait, g2,
    +) = false
    +
    +#= Linearring touches a polygon if at least one of the points of the ring
    +interact with the polygon boundary and non are in the polygon interior. =#
    +_touches(
    +    ::GI.LinearRingTrait, g1,
    +    ::GI.PolygonTrait, g2,
    +) = _line_polygon_process(
    +    g1, g2;
    +    TOUCHES_POLYGON_ALLOWS...,
    +    TOUCHES_REQUIRES...,
    +    TOUCHES_EXACT...,
    +    closed_line = true,
    +)

    Polygons touch geometries

    julia
    #= Polygon touches a curve if at least one of the curve boundary points interacts
    +with the polygon's boundary and no curve points interact with the interior.=#
    +_touches(
    +    trait1::GI.PolygonTrait, g1,
    +    trait2::GI.AbstractCurveTrait, g2
    +) = _touches(trait2, g2, trait1, g1)
    +
    +
    +#= Polygon touches another polygon if they share at least one boundary point and
    +no interior points. =#
    +_touches(
    +    ::GI.PolygonTrait, g1,
    +    ::GI.PolygonTrait, g2,
    +) = _polygon_polygon_process(
    +    g1, g2;
    +    TOUCHES_POLYGON_ALLOWS...,
    +    TOUCHES_REQUIRES...,
    +    TOUCHES_EXACT...,
    +)

    Geometries touch multi-geometry/geometry collections

    julia
    #= Geometry touch a multi-geometry or a collection if the geometry touches at
    +least one of the elements of the collection. =#
    +function _touches(
    +    ::Union{GI.PointTrait, GI.AbstractCurveTrait, GI.PolygonTrait}, g1,
    +    ::Union{
    +        GI.MultiPointTrait, GI.AbstractMultiCurveTrait,
    +        GI.MultiPolygonTrait, GI.GeometryCollectionTrait,
    +    }, g2,
    +)
    +    for sub_g2 in GI.getgeom(g2)
    +        !touches(g1, sub_g2) && return false
    +    end
    +    return true
    +end

    Multi-geometry/geometry collections cross geometries

    julia
    #= Multi-geometry or a geometry collection touches a geometry if at least one
    +elements of the collection touches the geometry. =#
    +function _touches(
    +    ::Union{
    +        GI.MultiPointTrait, GI.AbstractMultiCurveTrait,
    +        GI.MultiPolygonTrait, GI.GeometryCollectionTrait,
    +    }, g1,
    +    ::GI.AbstractGeometryTrait, g2,
    +)
    +    for sub_g1 in GI.getgeom(g1)
    +        !touches(sub_g1, g2) && return false
    +    end
    +    return true
    +end

    This page was generated using Literate.jl.

    + + + + \ No newline at end of file diff --git a/previews/PR237/source/methods/geom_relations/within.html b/previews/PR237/source/methods/geom_relations/within.html new file mode 100644 index 000000000..62e722803 --- /dev/null +++ b/previews/PR237/source/methods/geom_relations/within.html @@ -0,0 +1,217 @@ + + + + + + Within | GeometryOps.jl + + + + + + + + + + + + + + +
    Skip to content

    Within

    julia
    export within

    What is within?

    The within function checks if one geometry is inside another geometry. This requires that the two interiors intersect and that the interior and boundary of the first geometry is not in the exterior of the second geometry.

    To provide an example, consider these two lines:

    julia
    import GeometryOps as GO
    +import GeoInterface as GI
    +using Makie
    +using CairoMakie
    +
    +l1 = GI.LineString([(0.0, 0.0), (1.0, 0.0), (0.0, 0.1)])
    +l2 = GI.LineString([(0.25, 0.0), (0.75, 0.0)])
    +f, a, p = lines(GI.getpoint(l1), color = :blue)
    +scatter!(GI.getpoint(l1), color = :blue)
    +lines!(GI.getpoint(l2), color = :orange)
    +scatter!(GI.getpoint(l2), color = :orange)
    +f

    We can see that all of the points and edges of l2 are within l1, so l2 is within l1, but l1 is not within l2

    julia
    GO.within(l1, l2)  # false
    +GO.within(l2, l1)  # true
    true

    Implementation

    This is the GeoInterface-compatible implementation.

    First, we implement a wrapper method that dispatches to the correct implementation based on the geometry trait.

    Each of these calls a method in the geom_geom_processors file. The methods in this file determine if the given geometries meet a set of criteria. For the within function and arguments g1 and g2, this criteria is as follows: - points of g1 are allowed to be in the interior of g2 (either through overlap or crossing for lines) - points of g1 are allowed to be on the boundary of g2 - points of g1 are not allowed to be in the exterior of g2 - at least one point of g1 is required to be in the interior of g2 - no points of g1 are required to be on the boundary of g2 - no points of g1 are required to be in the exterior of g2

    The code for the specific implementations is in the geom_geom_processors file.

    julia
    const WITHIN_POINT_ALLOWS = (in_allow = true, on_allow = false, out_allow = false)
    +const WITHIN_CURVE_ALLOWS = (over_allow = true, cross_allow = true, on_allow = true, out_allow = false)
    +const WITHIN_POLYGON_ALLOWS = (in_allow = true, on_allow = true, out_allow = false)
    +const WITHIN_REQUIRES = (in_require = true, on_require = false, out_require = false)
    +const WITHIN_EXACT = (exact = _False(),)
    +
    +"""
    +    within(geom1, geom2)::Bool
    +
    +Return `true` if the first geometry is completely within the second geometry.
    +The interiors of both geometries must intersect and the interior and boundary of
    +the primary geometry (geom1) must not intersect the exterior of the secondary
    +geometry (geom2).
    +
    +Furthermore, `within` returns the exact opposite result of `contains`.
    +
    +# Examples
    +```jldoctest setup=:(using GeometryOps, GeometryBasics)
    +import GeometryOps as GO, GeoInterface as GI
    +
    +line = GI.LineString([(1, 1), (1, 2), (1, 3), (1, 4)])
    +point = (1, 2)
    +GO.within(point, line)

    output

    julia
    true
    +```
    +"""
    +within(g1, g2) = _within(trait(g1), g1, trait(g2), g2)

    Convert features to geometries

    julia
    _within(::GI.FeatureTrait, g1, ::Any, g2) = within(GI.geometry(g1), g2)
    +_within(::Any, g1, t2::GI.FeatureTrait, g2) = within(g1, GI.geometry(g2))
    +_within(::FeatureTrait, g1, ::FeatureTrait, g2) = within(GI.geometry(g1), GI.geometry(g2))

    Points within geometries

    Point is within another point if those points are equal.

    julia
    _within(
    +    ::GI.PointTrait, g1,
    +    ::GI.PointTrait, g2,
    +) = equals(g1, g2)
    +
    +#= Point is within a linestring if it is on a vertex or an edge of that line,
    +excluding the start and end vertex if the line is not closed. =#
    +_within(
    +    ::GI.PointTrait, g1,
    +    ::Union{GI.LineTrait, GI.LineStringTrait}, g2,
    +) = _point_curve_process(
    +    g1, g2;
    +    WITHIN_POINT_ALLOWS...,
    +    closed_curve = false,
    +)

    Point is within a linearring if it is on a vertex or an edge of that ring.

    julia
    _within(
    +    ::GI.PointTrait, g1,
    +    ::GI.LinearRingTrait, g2,
    +) = _point_curve_process(
    +    g1, g2;
    +    WITHIN_POINT_ALLOWS...,
    +    closed_curve = true,
    +)
    +
    +#= Point is within a polygon if it is inside of that polygon, excluding edges,
    +vertices, and holes. =#
    +_within(
    +    ::GI.PointTrait, g1,
    +    ::GI.PolygonTrait, g2,
    +) = _point_polygon_process(
    +    g1, g2;
    +    WITHIN_POINT_ALLOWS...,
    +    WITHIN_EXACT...,
    +)

    No geometries other than points can be within points

    julia
    _within(
    +    ::Union{GI.AbstractCurveTrait, GI.PolygonTrait}, g1,
    +    ::GI.PointTrait, g2,
    +) = false

    Lines within geometries

    julia
    #= Linestring is within another linestring if their interiors intersect and no
    +points of the first line are in the exterior of the second line. =#
    +_within(
    +    ::Union{GI.LineTrait, GI.LineStringTrait}, g1,
    +    ::Union{GI.LineTrait, GI.LineStringTrait}, g2,
    +) = _line_curve_process(
    +    g1, g2;
    +    WITHIN_CURVE_ALLOWS...,
    +    WITHIN_REQUIRES...,
    +    WITHIN_EXACT...,
    +    closed_line = false,
    +    closed_curve = false,
    +)
    +
    +#= Linestring is within a linear ring if their interiors intersect and no points
    +of the line are in the exterior of the ring. =#
    +_within(
    +    ::Union{GI.LineTrait, GI.LineStringTrait}, g1,
    +    ::GI.LinearRingTrait, g2,
    +) = _line_curve_process(
    +    g1, g2;
    +    WITHIN_CURVE_ALLOWS...,
    +    WITHIN_REQUIRES...,
    +    WITHIN_EXACT...,
    +    closed_line = false,
    +    closed_curve = true,
    +)
    +
    +#= Linestring is within a polygon if their interiors intersect and no points of
    +the line are in the exterior of the polygon, although they can be on an edge. =#
    +_within(
    +    ::Union{GI.LineTrait, GI.LineStringTrait}, g1,
    +    ::GI.PolygonTrait, g2,
    +) = _line_polygon_process(
    +    g1, g2;
    +    WITHIN_POLYGON_ALLOWS...,
    +    WITHIN_REQUIRES...,
    +    WITHIN_EXACT...,
    +    closed_line = false,
    +)

    Rings covered by geometries

    julia
    #= Linearring is within a linestring if their interiors intersect and no points
    +of the ring are in the exterior of the line. =#
    +_within(
    +    ::GI.LinearRingTrait, g1,
    +    ::Union{GI.LineTrait, GI.LineStringTrait}, g2,
    +) = _line_curve_process(
    +    g1, g2;
    +    WITHIN_CURVE_ALLOWS...,
    +    WITHIN_REQUIRES...,
    +    WITHIN_EXACT...,
    +    closed_line = true,
    +    closed_curve = false,
    +)
    +
    +#= Linearring is within another linearring if their interiors intersect and no
    +points of the first ring are in the exterior of the second ring. =#
    +_within(
    +    ::GI.LinearRingTrait, g1,
    +    ::GI.LinearRingTrait, g2,
    +) = _line_curve_process(
    +    g1, g2;
    +    WITHIN_CURVE_ALLOWS...,
    +    WITHIN_REQUIRES...,
    +    WITHIN_EXACT...,
    +    closed_line = true,
    +    closed_curve = true,
    +)
    +
    +#= Linearring is within a polygon if their interiors intersect and no points of
    +the ring are in the exterior of the polygon, although they can be on an edge. =#
    +_within(
    +    ::GI.LinearRingTrait, g1,
    +    ::GI.PolygonTrait, g2,
    +) = _line_polygon_process(
    +    g1, g2;
    +    WITHIN_POLYGON_ALLOWS...,
    +    WITHIN_REQUIRES...,
    +    WITHIN_EXACT...,
    +    closed_line = true,
    +)

    Polygons within geometries

    julia
    #= Polygon is within another polygon if the interior of the first polygon
    +intersects with the interior of the second and no points of the first polygon
    +are outside of the second polygon. =#
    +_within(
    +    ::GI.PolygonTrait, g1,
    +    ::GI.PolygonTrait, g2,
    +) = _polygon_polygon_process(
    +    g1, g2;
    +    WITHIN_POLYGON_ALLOWS...,
    +    WITHIN_REQUIRES...,
    +    WITHIN_EXACT...,
    +)

    Polygons cannot be within any curves

    julia
    _within(
    +    ::GI.PolygonTrait, g1,
    +    ::GI.AbstractCurveTrait, g2,
    +) = false

    Geometries within multi-geometry/geometry collections

    julia
    #= Geometry is within a multi-geometry or a collection if the geometry is within
    +at least one of the collection elements. =#
    +function _within(
    +    ::Union{GI.PointTrait, GI.AbstractCurveTrait, GI.PolygonTrait}, g1,
    +    ::Union{
    +        GI.MultiPointTrait, GI.AbstractMultiCurveTrait,
    +        GI.MultiPolygonTrait, GI.GeometryCollectionTrait,
    +    }, g2,
    +)
    +    for sub_g2 in GI.getgeom(g2)
    +        within(g1, sub_g2) && return true
    +    end
    +    return false
    +end

    Multi-geometry/geometry collections within geometries

    julia
    #= Multi-geometry or a geometry collection is within a geometry if all
    +elements of the collection are within the geometry. =#
    +function _within(
    +    ::Union{
    +        GI.MultiPointTrait, GI.AbstractMultiCurveTrait,
    +        GI.MultiPolygonTrait, GI.GeometryCollectionTrait,
    +    }, g1,
    +    ::GI.AbstractGeometryTrait, g2,
    +)
    +    for sub_g1 in GI.getgeom(g1)
    +        !within(sub_g1, g2) && return false
    +    end
    +    return true
    +end

    This page was generated using Literate.jl.

    + + + + \ No newline at end of file diff --git a/previews/PR237/source/methods/orientation.html b/previews/PR237/source/methods/orientation.html new file mode 100644 index 000000000..680ae85e5 --- /dev/null +++ b/previews/PR237/source/methods/orientation.html @@ -0,0 +1,124 @@ + + + + + + Orientation | GeometryOps.jl + + + + + + + + + + + + + + +
    Skip to content

    Orientation

    julia
    export isclockwise, isconcave

    isclockwise

    The orientation of a geometry is whether it runs clockwise or counter-clockwise.

    This is defined for linestrings, linear rings, or vectors of points.

    isconcave

    A polygon is concave if it has at least one interior angle greater than 180 degrees, meaning that the interior of the polygon is not a convex set.

    These are all adapted from Turf.jl.

    The may not necessarily be what want in the end but work for now!

    julia
    """
    +    isclockwise(line::Union{LineString, Vector{Position}})::Bool
    +
    +Take a ring and return `true` if the line goes clockwise, or `false` if the line goes
    +counter-clockwise.  "Going clockwise" means, mathematically,
    +
    +```math
    +\\left(\\sum_{i=2}^n (x_i - x_{i-1}) \\cdot (y_i + y_{i-1})\\right) > 0
    +```
    +
    +# Example
    +
    +```julia
    +julia> import GeoInterface as GI, GeometryOps as GO
    +julia> ring = GI.LinearRing([(0, 0), (1, 1), (1, 0), (0, 0)]);
    +julia> GO.isclockwise(ring)

    output

    julia
    true
    +```
    +"""
    +isclockwise(geom)::Bool = isclockwise(GI.trait(geom), geom)
    +
    +function isclockwise(::AbstractCurveTrait, line)::Bool
    +    sum = 0.0
    +    prev = GI.getpoint(line, 1)
    +    for p in GI.getpoint(line)

    sum will be zero for the first point as x is subtracted from itself

    julia
            sum += (GI.x(p) - GI.x(prev)) * (GI.y(p) + GI.y(prev))
    +        prev = p
    +    end
    +
    +    return sum > 0.0
    +end
    +
    +"""
    +    isconcave(poly::Polygon)::Bool
    +
    +Take a polygon and return true or false as to whether it is concave or not.
    +
    +# Examples
    +```jldoctest
    +import GeoInterface as GI, GeometryOps as GO
    +
    +poly = GI.Polygon([[(0, 0), (0, 1), (1, 1), (1, 0), (0, 0)]])
    +GO.isconcave(poly)

    output

    julia
    false
    +```
    +"""
    +function isconcave(poly)::Bool
    +    sign = false
    +
    +    exterior = GI.getexterior(poly)

    FIXME handle not closed polygons

    julia
        GI.npoint(exterior) <= 4 && return false
    +    n = GI.npoint(exterior) - 1
    +
    +    for i in 1:n
    +        j = ((i + 1) % n) === 0 ? 1 : (i + 1) % n
    +        m = ((i + 2) % n) === 0 ? 1 : (i + 2) % n
    +
    +        pti = GI.getpoint(exterior, i)
    +        ptj = GI.getpoint(exterior, j)
    +        ptm = GI.getpoint(exterior, m)
    +
    +        dx1 = GI.x(ptm) - GI.x(ptj)
    +        dy1 = GI.y(ptm) - GI.y(ptj)
    +        dx2 = GI.x(pti) - GI.x(ptj)
    +        dy2 = GI.y(pti) - GI.y(ptj)
    +
    +        cross = (dx1 * dy2) - (dy1 * dx2)
    +
    +        if i === 0
    +            sign = cross > 0
    +        elseif sign !== (cross > 0)
    +            return true
    +        end
    +    end
    +
    +    return false
    +end

    This is commented out.

    julia
    """
    +    isparallel(line1::LineString, line2::LineString)::Bool
    +
    +Return `true` if each segment of `line1` is parallel to the correspondent segment of `line2`
    +
    +## Examples

    julia import GeoInterface as GI, GeometryOps as GO julia> line1 = GI.LineString([(9.170356, 45.477985), (9.164434, 45.482551), (9.166644, 45.484003)]) GeoInterface.Wrappers.LineString{false, false, Vector{Tuple{Float64, Float64}}, Nothing, Nothing}([(9.170356, 45.477985), (9.164434, 45.482551), (9.166644, 45.484003)], nothing, nothing)

    julia> line2 = GI.LineString([(9.169356, 45.477985), (9.163434, 45.482551), (9.165644, 45.484003)]) GeoInterface.Wrappers.LineString{false, false, Vector{Tuple{Float64, Float64}}, Nothing, Nothing}([(9.169356, 45.477985), (9.163434, 45.482551), (9.165644, 45.484003)], nothing, nothing)

    julia> GO.isparallel(line1, line2) true

    """
    +function isparallel(line1, line2)::Bool
    +    seg1 = linesegment(line1)
    +    seg2 = linesegment(line2)
    +
    +    for i in eachindex(seg1)
    +        coors2 = nothing
    +        coors1 = seg1[i]
    +        coors2 = seg2[i]
    +        _isparallel(coors1, coors2) == false && return false
    +    end
    +    return true
    +end
    +
    +@inline function _isparallel(p1, p2)
    +    slope1 = bearing_to_azimuth(rhumb_bearing(GI.x(p1), GI.x(p2)))
    +    slope2 = bearing_to_azimuth(rhumb_bearing(GI.y(p1), GI.y(p2)))
    +
    +    return slope1 === slope2
    +end

    This is actual code:

    julia
    _isparallel(((ax, ay), (bx, by)), ((cx, cy), (dx, dy))) =
    +    _isparallel(bx - ax, by - ay, dx - cx, dy - cy)
    +
    +_isparallel(Δx1, Δy1, Δx2, Δy2) = (Δx1 * Δy2 == Δy1 * Δx2)

    This page was generated using Literate.jl.

    + + + + \ No newline at end of file diff --git a/previews/PR237/source/methods/polygonize.html b/previews/PR237/source/methods/polygonize.html new file mode 100644 index 000000000..1798f7a72 --- /dev/null +++ b/previews/PR237/source/methods/polygonize.html @@ -0,0 +1,313 @@ + + + + + + Polygonizing raster data | GeometryOps.jl + + + + + + + + + + + + + + +
    Skip to content

    Polygonizing raster data

    julia
    export polygonize
    +
    +#=
    +The methods in this file convert a raster image into a set of polygons,
    +by contour detection using a clockwise Moore neighborhood method.
    +
    +The resulting polygons are snapped to the boundaries of the cells of the input raster,
    +so they will look different from traditional contours from a plotting package.
    +
    +The main entry point is the `polygonize` function.
    +
    +```@docs
    +polygonize
    +```
    +
    +# Example
    +
    +Here's a basic example, using the `Makie.peaks()` function.  First, let's investigate the nature of the function:
    +```@example polygonize
    +using Makie, GeometryOps
    +n = 49
    +xs, ys = LinRange(-3, 3, n), LinRange(-3, 3, n)
    +zs = Makie.peaks(n)
    +z_max_value = maximum(abs.(extrema(zs)))
    +f, a, p = heatmap(
    +    xs, ys, zs;
    +    axis = (; aspect = DataAspect(), title = "Exact function")
    +)
    +cb = Colorbar(f[1, 2], p; label = "Z-value")
    +f
    +```
    +
    +Now, we can use the `polygonize` function to convert the raster data into polygons.
    +
    +For this particular example, we chose a range of z-values between 0.8 and 3.2,
    +which would provide two distinct polygons with holes.
    +
    +```@example polygonize
    +polygons = polygonize(xs, ys, 0.8 .< zs .< 3.2)
    +```
    +This returns a `GI.MultiPolygon`, which is directly plottable.  Let's see how these look:
    +
    +```@example polygonize
    +f, a, p = poly(polygons; label = "Polygonized polygons", axis = (; aspect = DataAspect()))
    +```
    +
    +Finally, let's plot the Makie contour lines on top, to see how the polygonization compares:
    +```@example polygonize
    +contour!(a, xs, ys, zs; labels = true, levels = [0.8, 3.2], label = "Contour lines")
    +f
    +```
    +
    +# Implementation
    +
    +The implementation follows:
    +=#
    +
    +"""
    +    polygonize(A::AbstractMatrix{Bool}; kw...)
    +    polygonize(f, A::AbstractMatrix; kw...)
    +    polygonize(xs, ys, A::AbstractMatrix{Bool}; kw...)
    +    polygonize(f, xs, ys, A::AbstractMatrix; kw...)
    +
    +Polygonize an `AbstractMatrix` of values, currently to a single class of polygons.
    +
    +Returns a `MultiPolygon` for `Bool` values and `f` return values, and
    +a `FeatureCollection` of `Feature`s holding `MultiPolygon` for all other values.
    +
    +
    +Function `f` should return either `true` or `false` or a transformation
    +of values into simpler groups, especially useful for floating point arrays.
    +
    +If `xs` and `ys` are ranges, they are used as the pixel/cell center points.
    +If they are `Vector` of `Tuple` they are used as the lower and upper bounds of each pixel/cell.

    Keywords

    julia
    - `minpoints`: ignore polygons with less than `minpoints` points.
    +- `values`: the values to turn into polygons. By default these are `union(A)`,
    +    If function `f` is passed these refer to the return values of `f`, by
    +    default `union(map(f, A)`. If values `Bool`, false is ignored and a single
    +    `MultiPolygon` is returned rather than a `FeatureCollection`.

    Example

    julia
    ```julia
    +using GeometryOps
    +A = rand(100, 100)
    +multipolygon = polygonize(>(0.5), A);
    +```
    +"""
    +polygonize(A::AbstractMatrix{Bool}; kw...) = polygonize(identity, A; kw...)
    +polygonize(f::Base.Callable, A::AbstractMatrix; kw...) = polygonize(f, axes(A)..., A; kw...)
    +polygonize(A::AbstractMatrix; kw...) = polygonize(axes(A)..., A; kw...)
    +polygonize(xs::AbstractVector, ys::AbstractVector, A::AbstractMatrix{Bool}; kw...) =
    +    _polygonize(identity, xs, ys, A)
    +function polygonize(xs::AbstractVector, ys::AbstractVector, A::AbstractMatrix;
    +    values=sort!(Base.union(A)), kw...
    +)
    +    _polygonize_featurecollection(identity, xs, ys, A; values, kw...)
    +end
    +function polygonize(f::Base.Callable, xs::AbstractRange, ys::AbstractRange, A::AbstractMatrix;
    +    values=_default_values(f, A), kw...
    +)
    +    if isnothing(values)
    +        _polygonize(f, xs, ys, A; kw...)
    +    else
    +        _polygonize_featurecollection(f, xs, ys, A; kw...)
    +    end
    +end
    +function _polygonize(f::Base.Callable, xs::AbstractRange, ys::AbstractRange, A::AbstractMatrix;
    +    kw...
    +)

    Make vectors of pixel bounds

    julia
        xhalf = step(xs) / 2
    +    yhalf = step(ys) / 2

    Make bounds ranges first to avoid floating point error making gaps or overlaps

    julia
        xbounds = range(first(xs) - xhalf; step = step(xs), length = length(xs) + 1)
    +    ybounds = range(first(ys) - yhalf; step = step(ys), length = length(ys) + 1)
    +    Tx = eltype(xbounds)
    +    Ty = eltype(ybounds)
    +    xvec = similar(Vector{Tuple{Tx,Tx}}, length(xs))
    +    yvec = similar(Vector{Tuple{Ty,Ty}}, length(ys))
    +    for (xind, i) in enumerate(eachindex(xvec))
    +        xvec[i] = xbounds[xind], xbounds[xind+1]
    +    end
    +    for (yind, i) in enumerate(eachindex(yvec))
    +        yvec[i] = ybounds[yind], ybounds[yind+1]
    +    end
    +    return _polygonize(f, xvec, yvec, A; kw...)
    +end
    +function _polygonize(f, xs::AbstractVector{T}, ys::AbstractVector{T}, A::AbstractMatrix;
    +    minpoints=0,
    +) where T<:Tuple
    +    (length(xs), length(ys)) == size(A) || throw(ArgumentError("length of xs and ys must match the array size"))

    Extract the CRS of the array (if it is some kind of geo array / raster)

    julia
        crs = GI.crs(A)

    Define buffers for edges and rings

    julia
        rings = Vector{T}[]
    +
    +    strait = true
    +    turning = false

    Get edges from the array A

    julia
        edges = _pixel_edges(f, xs, ys, A)

    Keep dict keys separately in a vector for performance

    julia
        edgekeys = collect(keys(edges))

    We don't delete keys we just reduce length with nkeys

    julia
        nkeys = length(edgekeys)

    Now create rings from the edges, looping until there are no edge keys left

    julia
        while nkeys > 0
    +        found = false
    +        local firstnode, nextnodes, nodestatus

    Loop until we find a key that hasn't been removed, decrementing nkeys as we go.

    julia
            while nkeys > 0

    Take the first node from the array

    julia
                firstnode::T = edgekeys[nkeys]
    +            nextnodes = edges[firstnode]
    +            nodestatus = map(!=(typemax(first(firstnode)))  first, nextnodes)
    +            if any(nodestatus)
    +                found = true
    +                break
    +            else
    +                nkeys -= 1
    +            end
    +        end

    If we found nothing this time, we are done

    julia
            found == false && break

    Check if there are one or two lines going through this node and take one of them, then update the status

    julia
            if nodestatus[2]
    +            nextnode = nextnodes[2]
    +            edges[firstnode] = (nextnodes[1], map(typemax, nextnode))
    +        else
    +            nkeys -= 1
    +            nextnode = nextnodes[1]
    +            edges[firstnode] = (map(typemax, nextnode), map(typemax, nextnode))
    +        end

    Start a new ring

    julia
            currentnode = firstnode
    +        ring = [currentnode, nextnode]
    +        push!(rings, ring)

    Loop until we close a the ring and break

    julia
            while true

    Find a node that matches the next node

    julia
                (c1, c2) = possiblenodes = edges[nextnode]
    +            nodestatus = map(!=(typemax(first(firstnode)))  first, possiblenodes)
    +            if nodestatus[2]

    When there are two possible node, choose the node that is the furthest to the left We also need to check if we are on a straight line to avoid adding unnecessary points.

    julia
                    selectednode, remainingnode, straightline = if currentnode[1] == nextnode[1] # vertical
    +                    wasincreasing = nextnode[2] > currentnode[2]
    +                    firstisstraight = nextnode[1] == c1[1]
    +                    firstisleft = nextnode[1] > c1[1]
    +                    secondisstraight = nextnode[1] == c2[1]
    +                    secondisleft = nextnode[1] > c2[1]
    +                    if firstisstraight
    +                        if secondisleft
    +                            if wasincreasing
    +                                (c2, c1, turning)
    +                            else
    +                                (c1, c2, straight)
    +                            end
    +                        else
    +                            if wasincreasing
    +                                (c1, c2, straight)
    +                            else
    +                                (c2, c1, secondisstraight)
    +                            end
    +                        end
    +                    elseif firstisleft
    +                        if wasincreasing
    +                            (c1, c2, turning)
    +                        else
    +                            (c2, c1, secondisstraight)
    +                        end
    +                    else # firstisright
    +                        if wasincreasing
    +                            (c2, c1, secondisstraight)
    +                        else
    +                            (c1, c2, turning)
    +                        end
    +                    end
    +                else # horizontal
    +                    wasincreasing = nextnode[1] > currentnode[1]
    +                    firstisstraight = nextnode[2] == c1[2]
    +                    firstisleft = nextnode[2] > c1[2]
    +                    secondisleft = nextnode[2] > c2[2]
    +                    secondisstraight = nextnode[2] == c2[2]
    +                    if firstisstraight
    +                        if secondisleft
    +                            if wasincreasing
    +                                (c1, c2, straight)
    +                            else
    +                                (c2, c1, turning)
    +                            end
    +                        else
    +                            if wasincreasing
    +                                (c2, c1, turning)
    +                            else
    +                                (c1, c2, straight)
    +                            end
    +                        end
    +                    elseif firstisleft
    +                        if wasincreasing
    +                            (c2, c1, secondisstraight)
    +                        else
    +                            (c1, c2, turning)
    +                        end
    +                    else # firstisright
    +                        if wasincreasing
    +                            (c1, c2, turning)
    +                        else
    +                            (c2, c1, secondisstraight)
    +                        end
    +                    end
    +                end

    Update edges

    julia
                    edges[nextnode] = (remainingnode, map(typemax, remainingnode))
    +            else

    Here we simply choose the first (and only valid) node

    julia
                    selectednode = c1

    Replace the edge nodes with empty nodes, they will be skipped later

    julia
                    edges[nextnode] = (map(typemax, c1), map(typemax, c1))

    Check if we are on a straight line

    julia
                    straightline = currentnode[1] == nextnode[1] == c1[1] ||
    +                               currentnode[2] == nextnode[2] == c1[2]
    +            end

    Update the current and next nodes with the next and selected nodes

    julia
                currentnode, nextnode = nextnode, selectednode

    Update the current node or add a new node to the ring

    julia
                if straightline

    replace the last node we don't need it

    julia
                    ring[end] = nextnode
    +            else

    add a new node, we have turned a corner

    julia
                    push!(ring, nextnode)
    +            end

    If the ring is closed, break the loop and start a new one

    julia
                nextnode == firstnode && break
    +        end
    +    end

    Define wrapped LinearRings, with embedded extents so we only calculate them once

    julia
        linearrings = map(rings) do ring
    +        extent = GI.extent(GI.LinearRing(ring))
    +        GI.LinearRing(ring; extent, crs)
    +    end

    Separate exteriors from holes by winding direction

    julia
        direction = (last(last(xs)) - first(first(xs))) * (last(last(ys)) - first(first(ys)))
    +    exterior_inds = if direction > 0
    +        .!isclockwise.(linearrings)
    +    else
    +        isclockwise.(linearrings)
    +    end
    +    holes = linearrings[.!exterior_inds]
    +    polygons = map(view(linearrings, exterior_inds)) do lr
    +        GI.Polygon([lr]; extent=GI.extent(lr), crs)
    +    end

    Then we add the holes to the polygons they are inside of

    julia
        assigned = fill(false, length(holes))
    +    for i in eachindex(holes)
    +        hole = holes[i]
    +        prepared_hole = GI.LinearRing(holes[i]; extent=GI.extent(holes[i]))
    +        for poly in polygons
    +            exterior = GI.Polygon(StaticArrays.SVector(GI.getexterior(poly)); extent=GI.extent(poly))
    +            if covers(exterior, prepared_hole)

    Hole is in the exterior, so add it to the polygon

    julia
                    push!(poly.geom, hole)
    +                assigned[i] = true
    +                break
    +            end
    +        end
    +    end
    +
    +    assigned_holes = count(assigned)
    +    assigned_holes == length(holes) || @warn "Not all holes were assigned to polygons, $(length(holes) - assigned_holes) where missed from $(length(holes)) holes and $(length(polygons)) polygons"
    +
    +    if isempty(polygons)

    TODO: this really should return an empty MultiPolygon but GeoInterface wrappers cant do that yet, which is not ideal...

    julia
            @warn "No polgons found, check your data or try another function for `f`"
    +        return nothing
    +    else

    Otherwise return a wrapped MultiPolygon

    julia
            return GI.MultiPolygon(polygons; crs, extent = mapreduce(GI.extent, Extents.union, polygons))
    +    end
    +end
    +
    +function _polygonize_featurecollection(f::Base.Callable, xs::AbstractRange, ys::AbstractRange, A::AbstractMatrix;
    +    values=_default_values(f, A), kw...
    +)
    +    crs = GI.crs(A)

    Create one feature per value

    julia
        features = map(values) do value
    +        multipolygon = _polygonize(x -> isequal(f(x), value), xs, ys, A; kw...)
    +        GI.Feature(multipolygon; properties=(; value), extent = GI.extent(multipolygon), crs)
    +    end
    +
    +    return GI.FeatureCollection(features; extent = mapreduce(GI.extent, Extents.union, features), crs)
    +end
    +
    +function _default_values(f, A)

    Get union of f return values with resolved eltype

    julia
        values = map(identity, sort!(Base.union(Iterators.map(f, A))))

    We ignore pure Bool

    julia
        return eltype(values) == Bool ? nothing : collect(skipmissing(values))
    +end
    +
    +function update_edge!(dict, key, node)
    +    newnodes = (node, map(typemax, node))

    Get or write in one go, to skip a hash lookup

    julia
        existingnodes = get!(() -> newnodes, dict, key)

    If we actually fetched an existing node, update it

    julia
        if existingnodes[1] != node
    +        dict[key] = (existingnodes[1], node)
    +    end
    +end
    +
    +function _pixel_edges(f, xs::AbstractVector{T}, ys::AbstractVector{T}, A) where T<:Tuple
    +    edges = Dict{T,Tuple{T,T}}()

    First we collect all the edges around target pixels

    julia
        fi, fj = map(first, axes(A))
    +    li, lj = map(last, axes(A))
    +    for j in axes(A, 2)
    +        y1, y2 = ys[j]
    +        for i in axes(A, 1)
    +            if f(A[i, j]) # This is a pixel inside a polygon

    xs and ys hold pixel bounds

    julia
                    x1, x2 = xs[i]

    We check the Von Neumann neighborhood to decide what edges are needed, if any.

    julia
                    (j == fi || !f(A[i, j-1])) && update_edge!(edges, (x1, y1), (x2, y1)) # S
    +                (i == fj || !f(A[i-1, j])) && update_edge!(edges, (x1, y2), (x1, y1)) # W
    +                (j == lj || !f(A[i, j+1])) && update_edge!(edges, (x2, y2), (x1, y2)) # N
    +                (i == li || !f(A[i+1, j])) && update_edge!(edges, (x2, y1), (x2, y2)) # E
    +            end
    +        end
    +    end
    +    return edges
    +end

    This page was generated using Literate.jl.

    + + + + \ No newline at end of file diff --git a/previews/PR237/source/not_implemented_yet.html b/previews/PR237/source/not_implemented_yet.html new file mode 100644 index 000000000..b2d794d6d --- /dev/null +++ b/previews/PR237/source/not_implemented_yet.html @@ -0,0 +1,25 @@ + + + + + + Not implemented yet | GeometryOps.jl + + + + + + + + + + + + + + +
    Skip to content

    Not implemented yet

    All of the functions in this file are not implemented in Julia yet. Some of them may have implementations in LibGEOS which we can use via an extension, but there is no native-Julia implementation for them.

    julia
    function symdifference end

    This page was generated using Literate.jl.

    + + + + \ No newline at end of file diff --git a/previews/PR237/source/primitives.html b/previews/PR237/source/primitives.html new file mode 100644 index 000000000..06dd05061 --- /dev/null +++ b/previews/PR237/source/primitives.html @@ -0,0 +1,25 @@ + + + + + + GeometryOps.jl + + + + + + + + + + + + + + +
    Skip to content
    + + + + \ No newline at end of file diff --git a/previews/PR237/source/src/GeometryOpsCore.html b/previews/PR237/source/src/GeometryOpsCore.html new file mode 100644 index 000000000..4966876d4 --- /dev/null +++ b/previews/PR237/source/src/GeometryOpsCore.html @@ -0,0 +1,49 @@ + + + + + + GeometryOps.jl + + + + + + + + + + + + + + +
    Skip to content
    julia
    module GeometryOpsCore
    +
    +using Base.Threads: nthreads, @threads, @spawn
    +
    +import GeoInterface
    +import GeoInterface as GI
    +import GeoInterface: Extents

    Import all names from GeoInterface and Extents, so users can do GO.extent or GO.trait.

    julia
    for name in names(GeoInterface)
    +    @eval using GeoInterface: $name
    +end
    +for name in names(Extents)
    +    @eval using GeoInterface.Extents: $name
    +end
    +
    +using Tables
    +using DataAPI
    +
    +include("keyword_docs.jl")
    +include("types.jl")
    +
    +include("apply.jl")
    +include("applyreduce.jl")
    +include("other_primitives.jl")
    +include("geometry_utils.jl")
    +
    +end

    This page was generated using Literate.jl.

    + + + + \ No newline at end of file diff --git a/previews/PR237/source/src/apply.html b/previews/PR237/source/src/apply.html new file mode 100644 index 000000000..a491e28bf --- /dev/null +++ b/previews/PR237/source/src/apply.html @@ -0,0 +1,170 @@ + + + + + + apply | GeometryOps.jl + + + + + + + + + + + + + + +
    Skip to content

    apply

    julia
    export apply

    This file mainly defines the apply function.

    In general, the idea behind the apply framework is to take as input any geometry, vector of geometries, or feature collection, deconstruct it to the given trait target (any arbitrary GI.AbstractTrait or TraitTarget union thereof, like PointTrait or PolygonTrait) and perform some operation on it. Then, the geometry or structure is rebuilt.

    This allows for a simple and consistent framework within which users can define their own operations trivially easily, and removes a lot of the complexity involved with handling complex geometry structures.

    For example, a simple way to flip the x and y coordinates of a geometry is:

    julia
    flipped_geom = GO.apply(GI.PointTrait(), geom) do p
    +    (GI.y(p), GI.x(p))
    +end

    As simple as that. There's no need to implement your own decomposition because it's done for you.

    Functions like flip, reproject, transform, even segmentize and simplify have been implemented using the apply framework. Similarly, centroid, area and distance have been implemented using the applyreduce framework.

    Docstrings

    Functions

    GeometryOpsCore.apply Function
    julia
    apply(f, target::Union{TraitTarget, GI.AbstractTrait}, obj; kw...)

    Reconstruct a geometry, feature, feature collection, or nested vectors of either using the function f on the target trait.

    f(target_geom) => x where x also has the target trait, or a trait that can be substituted. For example, swapping PolgonTrait to MultiPointTrait will fail if the outer object has MultiPolygonTrait, but should work if it has FeatureTrait.

    Objects "shallower" than the target trait are always completely rebuilt, like a Vector of FeatureCollectionTrait of FeatureTrait when the target has PolygonTrait and is held in the features. These will always be GeoInterface geometries/feature/feature collections. But "deeper" objects may remain unchanged or be whatever GeoInterface compatible objects f returns.

    The result is a functionally similar geometry with values depending on f.

    • threaded: true or false. Whether to use multithreading. Defaults to false.

    • crs: The CRS to attach to geometries. Defaults to nothing.

    • calc_extent: true or false. Whether to calculate the extent. Defaults to false.

    Example

    Flipped point the order in any feature or geometry, or iterables of either:

    julia
    import GeoInterface as GI
    +import GeometryOps as GO
    +geom = GI.Polygon([GI.LinearRing([(1, 2), (3, 4), (5, 6), (1, 2)]),
    +                   GI.LinearRing([(3, 4), (5, 6), (6, 7), (3, 4)])])
    +
    +flipped_geom = GO.apply(GI.PointTrait, geom) do p
    +    (GI.y(p), GI.x(p))
    +end

    source

    GeometryOpsCore.applyreduce Function
    julia
    applyreduce(f, op, target::Union{TraitTarget, GI.AbstractTrait}, obj; threaded)

    Apply function f to all objects with the target trait, and reduce the result with an op like +.

    The order and grouping of application of op is not guaranteed.

    If threaded==true threads will be used over arrays and iterables, feature collections and nested geometries.

    source

    What is apply?

    apply applies some function to every geometry matching the Target GeoInterface trait, in some arbitrarily nested object made up of:

    • AbstractArrays (we also try to iterate other non-GeoInteface compatible object)

    • FeatureCollectionTrait objects

    • FeatureTrait objects

    • AbstractGeometryTrait objects

    apply recursively calls itself through these nested layers until it reaches objects with the Target GeoInterface trait. When found apply applies the function f, and stops.

    The outer recursive functions then progressively rebuild the object using GeoInterface objects matching the original traits.

    If PointTrait is found but it is not the Target, an error is thrown. This likely means the object contains a different geometry trait to the target, such as MultiPointTrait when LineStringTrait was specified.

    To handle this possibility it may be necessary to make Target a Union of traits found at the same level of nesting, and define methods of f to handle all cases.

    Be careful making a union across "levels" of nesting, e.g. Union{FeatureTrait,PolygonTrait}, as _apply will just never reach PolygonTrait when all the polygons are wrapped in a FeatureTrait object.

    Embedding:

    extent and crs can be embedded in all geometries, features, and feature collections as part of apply. Geometries deeper than Target will of course not have new extent or crs embedded.

    • calc_extent signals to recalculate an Extent and embed it.

    • crs will be embedded as-is

    Threading

    Threading is used at the outermost level possible - over an array, feature collection, or e.g. a MultiPolygonTrait where each PolygonTrait sub-geometry may be calculated on a different thread.

    Currently, threading defaults to false for all objects, but can be turned on by passing the keyword argument threaded=true to apply.

    julia
    """
    +    apply(f, target::Union{TraitTarget, GI.AbstractTrait}, obj; kw...)
    +
    +Reconstruct a geometry, feature, feature collection, or nested vectors of
    +either using the function `f` on the `target` trait.
    +
    +`f(target_geom) => x` where `x` also has the `target` trait, or a trait that can
    +be substituted. For example, swapping `PolgonTrait` to `MultiPointTrait` will fail
    +if the outer object has `MultiPolygonTrait`, but should work if it has `FeatureTrait`.
    +
    +Objects "shallower" than the target trait are always completely rebuilt, like
    +a `Vector` of `FeatureCollectionTrait` of `FeatureTrait` when the target
    +has `PolygonTrait` and is held in the features. These will always be GeoInterface
    +geometries/feature/feature collections. But "deeper" objects may remain
    +unchanged or be whatever GeoInterface compatible objects `f` returns.
    +
    +The result is a functionally similar geometry with values depending on `f`.
    +
    +$APPLY_KEYWORDS
    +
    +# Example
    +
    +Flipped point the order in any feature or geometry, or iterables of either:
    +
    +```julia
    +import GeoInterface as GI
    +import GeometryOps as GO
    +geom = GI.Polygon([GI.LinearRing([(1, 2), (3, 4), (5, 6), (1, 2)]),
    +                   GI.LinearRing([(3, 4), (5, 6), (6, 7), (3, 4)])])
    +
    +flipped_geom = GO.apply(GI.PointTrait, geom) do p
    +    (GI.y(p), GI.x(p))
    +end
    +```
    +"""
    +@inline function apply(
    +    f::F, target, geom; calc_extent=false, threaded=false, kw...
    +) where F
    +    threaded = _booltype(threaded)
    +    calc_extent = _booltype(calc_extent)
    +    _apply(f, TraitTarget(target), geom; threaded, calc_extent, kw...)
    +end

    Call _apply again with the trait of geom

    julia
    @inline _apply(f::F, target, geom; kw...)  where F =
    +    _apply(f, target, GI.trait(geom), geom; kw...)

    There is no trait and this is an AbstractArray - so just iterate over it calling _apply on the contents

    julia
    @inline function _apply(f::F, target, ::Nothing, A::AbstractArray; threaded, kw...) where F

    For an Array there is nothing else to do but map _apply over all values _maptasks may run this level threaded if threaded==true, but deeper _apply called in the closure will not be threaded

    julia
        apply_to_array(i) = _apply(f, target, A[i]; threaded=_False(), kw...)
    +    _maptasks(apply_to_array, eachindex(A), threaded)
    +end

    There is no trait and this is not an AbstractArray. Try to call _apply over it. We can't use threading as we don't know if we can can index into it. So just map.

    julia
    @inline function _apply(f::F, target, ::Nothing, iterable::IterableType; threaded, kw...) where {F, IterableType}

    Try the Tables.jl interface first

    julia
        if Tables.istable(iterable)
    +    _apply_table(f, target, iterable; threaded, kw...)
    +    else # this is probably some form of iterable...
    +        if threaded isa _True

    collect first so we can use threads

    julia
                _apply(f, target, collect(iterable); threaded, kw...)
    +        else
    +            apply_to_iterable(x) = _apply(f, target, x; kw...)
    +            map(apply_to_iterable, iterable)
    +        end
    +    end
    +end
    +#=
    +Doing this inline in `_apply` is _heavily_ type unstable, so it's best to separate this
    +by a function barrier.
    +
    +This function operates `apply` on the `geometry` column of the table, and returns a new table
    +with the same schema, but with the new geometry column.
    +
    +This new table may be of the same type as the old one iff `Tables.materializer` is defined for
    +that table.  If not, then a `NamedTuple` is returned.
    +=#
    +function _apply_table(f::F, target, iterable::IterableType; threaded, kw...) where {F, IterableType}
    +    _get_col_pair(colname) = colname => Tables.getcolumn(iterable, colname)

    We extract the geometry column and run apply on it.

    julia
        geometry_column = first(GI.geometrycolumns(iterable))
    +    new_geometry = _apply(f, target, Tables.getcolumn(iterable, geometry_column); threaded, kw...)

    Then, we obtain the schema of the table,

    julia
        old_schema = Tables.schema(iterable)

    filter the geometry column out,

    julia
        new_names = filter(Base.Fix1(!==, geometry_column), old_schema.names)

    and try to rebuild the same table as the best type - either the original type of iterable, or a named tuple which is the default fallback.

    julia
        result = Tables.materializer(iterable)(
    +        merge(
    +            NamedTuple{(geometry_column,), Base.Tuple{typeof(new_geometry)}}((new_geometry,)),
    +            NamedTuple(Iterators.map(_get_col_pair, new_names))
    +        )
    +    )

    Finally, we ensure that metadata is propagated correctly. This can only happen if the original table supports metadata reads, and the result supports metadata writes.

    julia
        if DataAPI.metadatasupport(typeof(result)).write

    Copy over all metadata from the original table to the new table, if the original table supports metadata reading.

    julia
            if DataAPI.metadatasupport(IterableType).read
    +            for (key, (value, style)) in DataAPI.metadata(iterable; style = true)

    Default styles are not preserved on data transformation, so we must skip them!

    julia
                    style == :default && continue

    We assume that any other style is preserved.

    julia
                    DataAPI.metadata!(result, key, value; style)
    +            end
    +        end

    We don't usually care about the original table's metadata for GEOINTERFACE namespaced keys, so we should set the crs and geometrycolumns metadata if they are present. Ensure that GEOINTERFACE:geometrycolumns and GEOINTERFACE:crs are set!

    julia
            mdk = DataAPI.metadatakeys(result)

    If the user has asked for geometry columns to persist, they would be here, so we don't need to set them.

    julia
            if !("GEOINTERFACE:geometrycolumns" in mdk)

    If the geometry columns are not already set, we need to set them.

    julia
                DataAPI.metadata!(result, "GEOINTERFACE:geometrycolumns", (geometry_column,); style = :default)
    +        end

    Force reset CRS always, since you can pass crs to apply.

    julia
            new_crs = if haskey(kw, :crs)
    +            kw[:crs]
    +        else
    +            GI.crs(iterable) # this will automatically check `GEOINTERFACE:crs` unless the type has a specialized implementation.
    +        end
    +
    +        DataAPI.metadata!(result, "GEOINTERFACE:crs", new_crs; style = :default)
    +    end
    +
    +    return result
    +end

    Rewrap all FeatureCollectionTrait feature collections as GI.FeatureCollection Maybe use threads to call _apply on component features

    julia
    @inline function _apply(f::F, target, ::GI.FeatureCollectionTrait, fc;
    +    crs=GI.crs(fc), calc_extent=_False(), threaded
    +) where F

    Run _apply on all features in the feature collection, possibly threaded

    julia
        apply_to_feature(i) =
    +        _apply(f, target, GI.getfeature(fc, i); crs, calc_extent, threaded=_False())::GI.Feature
    +    features = _maptasks(apply_to_feature, 1:GI.nfeature(fc), threaded)
    +    if calc_extent isa _True

    Calculate the extent of the features

    julia
            extent = mapreduce(GI.extent, Extents.union, features)

    Return a FeatureCollection with features, crs and calculated extent

    julia
            return GI.FeatureCollection(features; crs, extent)
    +    else

    Return a FeatureCollection with features and crs

    julia
            return GI.FeatureCollection(features; crs)
    +    end
    +end

    Rewrap all FeatureTrait features as GI.Feature, keeping the properties

    julia
    @inline function _apply(f::F, target, ::GI.FeatureTrait, feature;
    +    crs=GI.crs(feature), calc_extent=_False(), threaded
    +) where F

    Run _apply on the contained geometry

    julia
        geometry = _apply(f, target, GI.geometry(feature); crs, calc_extent, threaded)

    Get the feature properties

    julia
        properties = GI.properties(feature)
    +    if calc_extent isa _True

    Calculate the extent of the geometry

    julia
            extent = GI.extent(geometry)

    Return a new Feature with the new geometry and calculated extent, but the original properties and crs

    julia
            return GI.Feature(geometry; properties, crs, extent)
    +    else

    Return a new Feature with the new geometry, but the original properties and crs

    julia
            return GI.Feature(geometry; properties, crs)
    +    end
    +end

    Reconstruct nested geometries, maybe using threads to call _apply on component geoms

    julia
    @inline function _apply(f::F, target, trait, geom;
    +    crs=GI.crs(geom), calc_extent=_False(), threaded
    +)::(GI.geointerface_geomtype(trait)) where F

    Map _apply over all sub geometries of geom to create a new vector of geometries TODO handle zero length

    julia
        apply_to_geom(i) = _apply(f, target, GI.getgeom(geom, i); crs, calc_extent, threaded=_False())
    +    geoms = _maptasks(apply_to_geom, 1:GI.ngeom(geom), threaded)
    +    return _apply_inner(geom, geoms, crs, calc_extent)
    +end
    +@inline function _apply(f::F, target::TraitTarget{<:PointTrait}, trait::GI.PolygonTrait, geom;
    +    crs=GI.crs(geom), calc_extent=_False(), threaded
    +)::(GI.geointerface_geomtype(trait)) where F

    We need to force rebuilding a LinearRing not a LineString

    julia
        geoms = _maptasks(1:GI.ngeom(geom), threaded) do i
    +        lr = GI.getgeom(geom, i)
    +        points = map(GI.getgeom(lr)) do p
    +            _apply(f, target, p; crs, calc_extent, threaded=_False())
    +        end
    +        _linearring(_apply_inner(lr, points, crs, calc_extent))
    +    end
    +    return _apply_inner(geom, geoms, crs, calc_extent)
    +end
    +function _apply_inner(geom, geoms, crs, calc_extent::_True)

    Calculate the extent of the sub geometries

    julia
        extent = mapreduce(GI.extent, Extents.union, geoms)

    Return a new geometry of the same trait as geom, holding the new geoms with crs and calculated extent

    julia
        return rebuild(geom, geoms; crs, extent)
    +end
    +function _apply_inner(geom, geoms, crs, calc_extent::_False)

    Return a new geometry of the same trait as geom, holding the new geoms with crs

    julia
        return rebuild(geom, geoms; crs)
    +end

    Fail loudly if we hit PointTrait without running f (after PointTrait there is no further to dig with _apply) @inline _apply(f, ::TraitTarget{Target}, trait::GI.PointTrait, geom; crs=nothing, kw...) where Target = throw(ArgumentError("target Target not found, but reached a PointTrait leaf")) Finally, these short methods are the main purpose of apply. The Trait is a subtype of the Target (or identical to it) So the Target is found. We apply f to geom and return it to previous _apply calls to be wrapped with the outer geometries/feature/featurecollection/array.

    julia
    _apply(f::F, ::TraitTarget{Target}, ::Trait, geom; crs=GI.crs(geom), kw...) where {F,Target,Trait<:Target} = f(geom)

    Define some specific cases of this match to avoid method ambiguity

    julia
    for T in (
    +    GI.PointTrait, GI.LinearRing, GI.LineString,
    +    GI.MultiPoint, GI.FeatureTrait, GI.FeatureCollectionTrait
    +)
    +    @eval _apply(f::F, target::TraitTarget{<:$T}, trait::$T, x; kw...) where F = f(x)
    +end
    +
    +
    +### `_maptasks` - flexible, threaded `map`
    +
    +using Base.Threads: nthreads, @threads, @spawn

    Threading utility, modified Mason Protters threading PSA run f over ntasks, where f receives an AbstractArray/range of linear indices

    julia
    @inline function _maptasks(f::F, taskrange, threaded::_True)::Vector where F
    +    ntasks = length(taskrange)

    Customize this as needed. More tasks have more overhead, but better load balancing

    julia
        tasks_per_thread = 2
    +    chunk_size = max(1, ntasks ÷ (tasks_per_thread * nthreads()))

    partition the range into chunks

    julia
        task_chunks = Iterators.partition(taskrange, chunk_size)

    Map over the chunks

    julia
        tasks = map(task_chunks) do chunk

    Spawn a task to process this chunk

    julia
            @spawn begin

    Where we map f over the chunk indices

    julia
                map(f, chunk)
    +        end
    +    end

    Finally we join the results into a new vector

    julia
        return mapreduce(fetch, vcat, tasks)
    +end

    Here we use the compiler directive @assume_effects :foldable to force the compiler to lookup through the closure. This alone makes e.g. flip 2.5x faster!

    julia
    Base.@assume_effects :foldable @inline function _maptasks(f::F, taskrange, threaded::_False)::Vector where F
    +    map(f, taskrange)
    +end

    This page was generated using Literate.jl.

    + + + + \ No newline at end of file diff --git a/previews/PR237/source/src/applyreduce.html b/previews/PR237/source/src/applyreduce.html new file mode 100644 index 000000000..6c14679bb --- /dev/null +++ b/previews/PR237/source/src/applyreduce.html @@ -0,0 +1,96 @@ + + + + + + applyreduce | GeometryOps.jl + + + + + + + + + + + + + + +
    Skip to content

    applyreduce

    julia
    export applyreduce

    This file mainly defines the applyreduce function.

    This performs apply, but then reduces the result after flattening instead of rebuilding the geometry.

    In general, the idea behind the apply framework is to take as input any geometry, vector of geometries, or feature collection, deconstruct it to the given trait target (any arbitrary GI.AbstractTrait or TraitTarget union thereof, like PointTrait or PolygonTrait) and perform some operation on it.

    centroid, area and distance have been implemented using the applyreduce framework.

    julia
    """
    +    applyreduce(f, op, target::Union{TraitTarget, GI.AbstractTrait}, obj; threaded)
    +
    +Apply function `f` to all objects with the `target` trait,
    +and reduce the result with an `op` like `+`.
    +
    +The order and grouping of application of `op` is not guaranteed.
    +
    +If `threaded==true` threads will be used over arrays and iterables,
    +feature collections and nested geometries.
    +"""
    +@inline function applyreduce(
    +    f::F, op::O, target, geom; threaded=false, init=nothing
    +) where {F, O}
    +    threaded = _booltype(threaded)
    +    _applyreduce(f, op, TraitTarget(target), geom; threaded, init)
    +end
    +
    +@inline _applyreduce(f::F, op::O, target, geom; threaded, init) where {F, O} =
    +    _applyreduce(f, op, target, GI.trait(geom), geom; threaded, init)

    Maybe use threads reducing over arrays

    julia
    @inline function _applyreduce(f::F, op::O, target, ::Nothing, A::AbstractArray; threaded, init) where {F, O}
    +    applyreduce_array(i) = _applyreduce(f, op, target, A[i]; threaded=_False(), init)
    +    _mapreducetasks(applyreduce_array, op, eachindex(A), threaded; init)
    +end

    Try to applyreduce over iterables

    julia
    @inline function _applyreduce(f::F, op::O, target, ::Nothing, iterable::IterableType; threaded, init) where {F, O, IterableType}
    +    if Tables.istable(iterable)
    +        _applyreduce_table(f, op, target, iterable; threaded, init)
    +    else
    +        applyreduce_iterable(i) = _applyreduce(f, op, target, i; threaded=_False(), init)
    +        if threaded isa _True # Try to `collect` and reduce over the vector with threads
    +            _applyreduce(f, op, target, collect(iterable); threaded, init)
    +        else

    Try to mapreduce the iterable as-is

    julia
                mapreduce(applyreduce_iterable, op, iterable; init)
    +        end
    +    end
    +end

    In this case, we don't reconstruct the table, but only operate on the geometry column.

    julia
    function _applyreduce_table(f::F, op::O, target, iterable::IterableType; threaded, init) where {F, O, IterableType}

    We extract the geometry column and run applyreduce on it.

    julia
        geometry_column = first(GI.geometrycolumns(iterable))
    +    return _applyreduce(f, op, target, Tables.getcolumn(iterable, geometry_column); threaded, init)
    +end

    If applyreduce wants features, then applyreduce over the rows as GI.Features.

    julia
    function _applyreduce_table(f::F, op::O, target::GI.FeatureTrait, iterable::IterableType; threaded, init) where {F, O, IterableType}

    We extract the geometry column and run apply on it.

    julia
        geometry_column = first(GI.geometrycolumns(iterable))
    +    property_names = Iterators.filter(!=(geometry_column), Tables.schema(iterable).names)
    +    features = map(Tables.rows(iterable)) do row
    +        GI.Feature(Tables.getcolumn(row, geometry_column), properties=NamedTuple(Iterators.map(Base.Fix1(_get_col_pair, row), property_names)))
    +    end
    +    return _applyreduce(f, op, target, features; threaded, init)
    +end

    Maybe use threads reducing over features of feature collections

    julia
    @inline function _applyreduce(f::F, op::O, target, ::GI.FeatureCollectionTrait, fc; threaded, init) where {F, O}
    +    applyreduce_fc(i) = _applyreduce(f, op, target, GI.getfeature(fc, i); threaded=_False(), init)
    +    _mapreducetasks(applyreduce_fc, op, 1:GI.nfeature(fc), threaded; init)
    +end

    Features just applyreduce to their geometry

    julia
    @inline _applyreduce(f::F, op::O, target, ::GI.FeatureTrait, feature; threaded, init) where {F, O} =
    +    _applyreduce(f, op, target, GI.geometry(feature); threaded, init)

    Maybe use threads over components of nested geometries

    julia
    @inline function _applyreduce(f::F, op::O, target, trait, geom; threaded, init) where {F, O}
    +    applyreduce_geom(i) = _applyreduce(f, op, target, GI.getgeom(geom, i); threaded=_False(), init)
    +    _mapreducetasks(applyreduce_geom, op, 1:GI.ngeom(geom), threaded; init)
    +end

    Don't thread over points it won't pay off

    julia
    @inline function _applyreduce(
    +    f::F, op::O, target, trait::Union{GI.LinearRing,GI.LineString,GI.MultiPoint}, geom;
    +    threaded, init
    +) where {F, O}
    +    _applyreduce(f, op, target, GI.getgeom(geom); threaded=_False(), init)
    +end

    Apply f to the target

    julia
    @inline function _applyreduce(f::F, op::O, ::TraitTarget{Target}, ::Trait, x; kw...) where {F,O,Target,Trait<:Target}
    +    f(x)
    +end

    Fail if we hit PointTrait _applyreduce(f, op, target::TraitTarget{Target}, trait::PointTrait, geom; kw...) where Target = throw(ArgumentError("target target not found")) Specific cases to avoid method ambiguity

    julia
    for T in (
    +    GI.PointTrait, GI.LinearRing, GI.LineString,
    +    GI.MultiPoint, GI.FeatureTrait, GI.FeatureCollectionTrait
    +)
    +    @eval _applyreduce(f::F, op::O, ::TraitTarget{<:$T}, trait::$T, x; kw...) where {F, O} = f(x)
    +end
    +
    +### `_mapreducetasks` - flexible, threaded mapreduce
    +
    +import Base.Threads: nthreads, @threads, @spawn

    Threading utility, modified Mason Protters threading PSA run f over ntasks, where f receives an AbstractArray/range of linear indices

    WARNING: this will not work for mean/median - only ops where grouping is possible. That's because the implementation operates in chunks, and not globally.

    If you absolutely need a single chunk, then threaded = false will always decompose to straight mapreduce without grouping.

    julia
    @inline function _mapreducetasks(f::F, op, taskrange, threaded::_True; init) where F
    +    ntasks = length(taskrange)

    Customize this as needed. More tasks have more overhead, but better load balancing

    julia
        tasks_per_thread = 2
    +    chunk_size = max(1, ntasks ÷ (tasks_per_thread * nthreads()))

    partition the range into chunks

    julia
        task_chunks = Iterators.partition(taskrange, chunk_size)

    Map over the chunks

    julia
        tasks = map(task_chunks) do chunk

    Spawn a task to process this chunk

    julia
            @spawn begin

    Where we map f over the chunk indices

    julia
                mapreduce(f, op, chunk; init)
    +        end
    +    end

    Finally we join the results into a new vector

    julia
        return mapreduce(fetch, op, tasks; init)
    +end
    +Base.@assume_effects :foldable function _mapreducetasks(f::F, op, taskrange, threaded::_False; init) where F
    +    mapreduce(f, op, taskrange; init)
    +end

    This page was generated using Literate.jl.

    + + + + \ No newline at end of file diff --git a/previews/PR237/source/src/geometry_utils.html b/previews/PR237/source/src/geometry_utils.html new file mode 100644 index 000000000..6dd066f29 --- /dev/null +++ b/previews/PR237/source/src/geometry_utils.html @@ -0,0 +1,26 @@ + + + + + + GeometryOps.jl + + + + + + + + + + + + + + +
    Skip to content
    julia
    _linearring(geom::GI.LineString) = GI.LinearRing(parent(geom); extent=geom.extent, crs=geom.crs)
    +_linearring(geom::GI.LinearRing) = geom

    This page was generated using Literate.jl.

    + + + + \ No newline at end of file diff --git a/previews/PR237/source/src/keyword_docs.html b/previews/PR237/source/src/keyword_docs.html new file mode 100644 index 000000000..4d39b1844 --- /dev/null +++ b/previews/PR237/source/src/keyword_docs.html @@ -0,0 +1,33 @@ + + + + + + Keyword docs | GeometryOps.jl + + + + + + + + + + + + + + +
    Skip to content

    Keyword docs

    This file defines common keyword documentation, that can be spliced into docstrings.

    julia
    const THREADED_KEYWORD = "- `threaded`: `true` or `false`. Whether to use multithreading. Defaults to `false`."
    +const CRS_KEYWORD = "- `crs`: The CRS to attach to geometries. Defaults to `nothing`."
    +const CALC_EXTENT_KEYWORD = "- `calc_extent`: `true` or `false`. Whether to calculate the extent. Defaults to `false`."
    +
    +const APPLY_KEYWORDS = """
    +$THREADED_KEYWORD
    +$CRS_KEYWORD
    +$CALC_EXTENT_KEYWORD
    +"""

    This page was generated using Literate.jl.

    + + + + \ No newline at end of file diff --git a/previews/PR237/source/src/other_primitives.html b/previews/PR237/source/src/other_primitives.html new file mode 100644 index 000000000..82da840dc --- /dev/null +++ b/previews/PR237/source/src/other_primitives.html @@ -0,0 +1,142 @@ + + + + + + Other primitives (unwrap, flatten, etc) | GeometryOps.jl + + + + + + + + + + + + + + +
    Skip to content

    Other primitives (unwrap, flatten, etc)

    This file defines the following primitives:

    GeometryOpsCore.unwrap Function
    julia
    unwrap(target::Type{<:AbstractTrait}, obj)
    +unwrap(f, target::Type{<:AbstractTrait}, obj)

    Unwrap the object to vectors, down to the target trait.

    If f is passed in it will be applied to the target geometries as they are found.

    source

    GeometryOpsCore.flatten Function
    julia
    flatten(target::Type{<:GI.AbstractTrait}, obj)
    +flatten(f, target::Type{<:GI.AbstractTrait}, obj)

    Lazily flatten any AbstractArray, iterator, FeatureCollectionTrait, FeatureTrait or AbstractGeometryTrait object obj, so that objects with the target trait are returned by the iterator.

    If f is passed in it will be applied to the target geometries.

    source

    GeometryOpsCore.reconstruct Function
    julia
    reconstruct(geom, components)

    Reconstruct geom from an iterable of component objects that match its structure.

    All objects in components must have the same GeoInterface.trait.

    Usually used in combination with flatten.

    source

    GeometryOpsCore.rebuild Function
    julia
    rebuild(geom, child_geoms)

    Rebuild a geometry from child geometries.

    By default geometries will be rebuilt as a GeoInterface.Wrappers geometry, but rebuild can have methods added to it to dispatch on geometries from other packages and specify how to rebuild them.

    (Maybe it should go into GeoInterface.jl)

    source

    julia
    """
    +    unwrap(target::Type{<:AbstractTrait}, obj)
    +    unwrap(f, target::Type{<:AbstractTrait}, obj)
    +
    +Unwrap the object to vectors, down to the target trait.
    +
    +If `f` is passed in it will be applied to the target geometries
    +as they are found.
    +"""
    +function unwrap end
    +unwrap(target::Type, geom) = unwrap(identity, target, geom)

    Add dispatch argument for trait

    julia
    unwrap(f, target::Type, geom) = unwrap(f, target, GI.trait(geom), geom)

    Try to unwrap over iterables

    julia
    unwrap(f, target::Type, ::Nothing, iterable) =
    +    map(x -> unwrap(f, target, x), iterable)

    Rewrap feature collections

    julia
    unwrap(f, target::Type, ::GI.FeatureCollectionTrait, fc) =
    +    map(x -> unwrap(f, target, x), GI.getfeature(fc))
    +unwrap(f, target::Type, ::GI.FeatureTrait, feature) =
    +    unwrap(f, target, GI.geometry(feature))
    +unwrap(f, target::Type, trait, geom) = map(g -> unwrap(f, target, g), GI.getgeom(geom))

    Apply f to the target geometry

    julia
    unwrap(f, ::Type{Target}, ::Trait, geom) where {Target,Trait<:Target} = f(geom)

    Fail if we hit PointTrait

    julia
    unwrap(f, target::Type, trait::GI.PointTrait, geom) =
    +    throw(ArgumentError("target $target not found, but reached a `PointTrait` leaf"))

    Specific cases to avoid method ambiguity

    julia
    unwrap(f, target::Type{GI.PointTrait}, trait::GI.PointTrait, geom) = f(geom)
    +unwrap(f, target::Type{GI.FeatureTrait}, ::GI.FeatureTrait, feature) = f(feature)
    +unwrap(f, target::Type{GI.FeatureCollectionTrait}, ::GI.FeatureCollectionTrait, fc) = f(fc)
    +
    +"""
    +    flatten(target::Type{<:GI.AbstractTrait}, obj)
    +    flatten(f, target::Type{<:GI.AbstractTrait}, obj)
    +
    +Lazily flatten any `AbstractArray`, iterator, `FeatureCollectionTrait`,
    +`FeatureTrait` or `AbstractGeometryTrait` object `obj`, so that objects
    +with the `target` trait are returned by the iterator.
    +
    +If `f` is passed in it will be applied to the target geometries.
    +"""
    +flatten(::Type{Target}, geom) where {Target<:GI.AbstractTrait} = flatten(identity, Target, geom)
    +flatten(f, ::Type{Target}, geom) where {Target<:GI.AbstractTrait} = _flatten(f, Target, geom)
    +
    +_flatten(f, ::Type{Target}, geom) where Target = _flatten(f, Target, GI.trait(geom), geom)

    Try to flatten over iterables

    julia
    function _flatten(f, ::Type{Target}, ::Nothing, iterable) where Target
    +    if Tables.istable(iterable)
    +        column = Tables.getcolumn(iterable, first(GI.geometrycolumns(iterable)))
    +        Iterators.map(x -> _flatten(f, Target, x), column) |> Iterators.flatten
    +    else
    +        Iterators.map(x -> _flatten(f, Target, x), iterable) |> Iterators.flatten
    +    end
    +end

    Flatten feature collections

    julia
    function _flatten(f, ::Type{Target}, ::GI.FeatureCollectionTrait, fc) where Target
    +    Iterators.map(GI.getfeature(fc)) do feature
    +        _flatten(f, Target, feature)
    +    end |> Iterators.flatten
    +end
    +_flatten(f, ::Type{Target}, ::GI.FeatureTrait, feature) where Target =
    +    _flatten(f, Target, GI.geometry(feature))

    Apply f to the target geometry

    julia
    _flatten(f, ::Type{Target}, ::Trait, geom) where {Target,Trait<:Target} = (f(geom),)
    +_flatten(f, ::Type{Target}, trait, geom) where Target =
    +    Iterators.flatten(Iterators.map(g -> _flatten(f, Target, g), GI.getgeom(geom)))

    Fail if we hit PointTrait without running f

    julia
    _flatten(f, ::Type{Target}, trait::GI.PointTrait, geom) where Target =
    +    throw(ArgumentError("target $Target not found, but reached a `PointTrait` leaf"))

    Specific cases to avoid method ambiguity

    julia
    _flatten(f, ::Type{<:GI.PointTrait}, ::GI.PointTrait, geom) = (f(geom),)
    +_flatten(f, ::Type{<:GI.FeatureTrait}, ::GI.FeatureTrait, feature) = (f(feature),)
    +_flatten(f, ::Type{<:GI.FeatureCollectionTrait}, ::GI.FeatureCollectionTrait, fc) = (f(fc),)
    +
    +
    +"""
    +    reconstruct(geom, components)
    +
    +Reconstruct `geom` from an iterable of component objects that match its structure.
    +
    +All objects in `components` must have the same `GeoInterface.trait`.
    +
    +Usually used in combination with `flatten`.
    +"""
    +function reconstruct(geom, components)
    +    obj, iter = _reconstruct(geom, components)
    +    return obj
    +end
    +
    +_reconstruct(geom, components) =
    +    _reconstruct(typeof(GI.trait(first(components))), geom, components, 1)
    +_reconstruct(::Type{Target}, geom, components, iter) where Target =
    +    _reconstruct(Target, GI.trait(geom), geom, components, iter)

    Try to reconstruct over iterables

    julia
    function _reconstruct(::Type{Target}, ::Nothing, iterable, components, iter) where Target
    +    vect = map(iterable) do x

    iter is updated by _reconstruct here

    julia
            obj, iter = _reconstruct(Target, x, components, iter)
    +        obj
    +    end
    +    return vect, iter
    +end

    Reconstruct feature collections

    julia
    function _reconstruct(::Type{Target}, ::GI.FeatureCollectionTrait, fc, components, iter) where Target
    +    features = map(GI.getfeature(fc)) do feature

    iter is updated by _reconstruct here

    julia
            newfeature, iter = _reconstruct(Target, feature, components, iter)
    +        newfeature
    +    end
    +    return GI.FeatureCollection(features; crs=GI.crs(fc)), iter
    +end
    +function _reconstruct(::Type{Target}, ::GI.FeatureTrait, feature, components, iter) where Target
    +    geom, iter = _reconstruct(Target, GI.geometry(feature), components, iter)
    +    return GI.Feature(geom; properties=GI.properties(feature), crs=GI.crs(feature)), iter
    +end
    +function _reconstruct(::Type{Target}, trait, geom, components, iter) where Target
    +    geoms = map(GI.getgeom(geom)) do subgeom

    iter is updated by _reconstruct here

    julia
            subgeom1, iter = _reconstruct(Target, GI.trait(subgeom), subgeom, components, iter)
    +        subgeom1
    +    end
    +    return rebuild(geom, geoms), iter
    +end

    Apply f to the target geometry

    julia
    _reconstruct(::Type{Target}, ::Trait, geom, components, iter) where {Target,Trait<:Target} =
    +    iterate(components, iter)

    Specific cases to avoid method ambiguity

    julia
    _reconstruct(::Type{<:GI.PointTrait}, ::GI.PointTrait, geom, components, iter) = iterate(components, iter)
    +_reconstruct(::Type{<:GI.FeatureTrait}, ::GI.FeatureTrait, feature, components, iter) = iterate(feature, iter)
    +_reconstruct(::Type{<:GI.FeatureCollectionTrait}, ::GI.FeatureCollectionTrait, fc, components, iter) = iterate(fc, iter)

    Fail if we hit PointTrait without running f

    julia
    _reconstruct(::Type{Target}, trait::GI.PointTrait, geom, components, iter) where Target =
    +    throw(ArgumentError("target $Target not found, but reached a `PointTrait` leaf"))
    +
    +"""
    +    rebuild(geom, child_geoms)
    +
    +Rebuild a geometry from child geometries.
    +
    +By default geometries will be rebuilt as a `GeoInterface.Wrappers`
    +geometry, but `rebuild` can have methods added to it to dispatch
    +on geometries from other packages and specify how to rebuild them.
    +
    +(Maybe it should go into GeoInterface.jl)
    +"""
    +rebuild(geom, child_geoms; kw...) = rebuild(GI.trait(geom), geom, child_geoms; kw...)
    +function rebuild(trait::GI.AbstractTrait, geom, child_geoms; crs=GI.crs(geom), extent=nothing)
    +    T = GI.geointerface_geomtype(trait)
    +    if GI.is3d(geom)

    The Boolean type parameters here indicate "3d-ness" and "measure" coordinate, respectively.

    julia
            return T{true,false}(child_geoms; crs, extent)
    +    else
    +        return T{false,false}(child_geoms; crs, extent)
    +    end
    +end

    This page was generated using Literate.jl.

    + + + + \ No newline at end of file diff --git a/previews/PR237/source/src/types.html b/previews/PR237/source/src/types.html new file mode 100644 index 000000000..808d438e5 --- /dev/null +++ b/previews/PR237/source/src/types.html @@ -0,0 +1,135 @@ + + + + + + Types | GeometryOps.jl + + + + + + + + + + + + + + +
    Skip to content

    Types

    This defines core types that the GeometryOps ecosystem uses, and that are usable in more than just GeometryOps.

    Manifold

    A manifold is mathematically defined as a topological space that resembles Euclidean space locally.

    In GeometryOps (and geodesy more generally), there are three manifolds we care about:

    • Planar: the 2d plane, a completely Euclidean manifold

    • Spherical: the unit sphere, but one where areas are multiplied by the radius of the Earth. This is not Euclidean globally, but all map projections attempt to represent the sphere on the Euclidean 2D plane to varying degrees of success.

    • Geodesic: the ellipsoid, the closest we can come to representing the Earth by a simple geometric shape. Parametrized by semimajor_axis and inv_flattening.

    Generally, we aim to have Linear and Spherical be operable everywhere, whereas Geodesic will only apply in specific circumstances. Currently, those circumstances are area and segmentize, but this could be extended with time and https://github.com/JuliaGeo/SphericalGeodesics.jl.

    julia
    export Planar, Spherical, Geodesic
    +export TraitTarget
    +export BoolsAsTypes, _True, _False, _booltype
    +
    +"""
    +    abstract type Manifold
    +
    +A manifold is mathematically defined as a topological space that resembles Euclidean space locally.
    +
    +We use the manifold definition to define the space in which an operation should be performed, or where a geometry lies.
    +
    +Currently we have `Planar`, `Spherical`, and `Geodesic` manifolds.
    +"""
    +abstract type Manifold end
    +
    +"""
    +    Planar()
    +
    +A planar manifold refers to the 2D Euclidean plane.
    +
    +Z coordinates may be accepted but will not influence geometry calculations, which
    +are done purely on 2D geometry.  This is the standard "2.5D" model used by e.g. GEOS.
    +"""
    +struct Planar <: Manifold
    +end
    +
    +"""
    +    Spherical(; radius)
    +
    +A spherical manifold means that the geometry is on the 3-sphere (but is represented by 2-D longitude and latitude).
    +
    +By default, the radius is defined as the mean radius of the Earth, `6371008.8 m`.
    +
    +# Extended help
    +
    +!!! note
    +    The traditional definition of spherical coordinates in physics and mathematics,
    +    ``r, \\theta, \\phi``, uses the _colatitude_, that measures angular displacement from the `z`-axis.
    +
    +    Here, we use the geographic definition of longitude and latitude, meaning
    +    that `lon` is longitude between -180 and 180, and `lat` is latitude between
    +    `-90` (south pole) and `90` (north pole).
    +"""
    +Base.@kwdef struct Spherical{T} <: Manifold
    +    radius::T = 6371008.8
    +end
    +
    +"""
    +    Geodesic(; semimajor_axis, inv_flattening)
    +
    +A geodesic manifold means that the geometry is on a 3-dimensional ellipsoid, parameterized by `semimajor_axis` (``a`` in mathematical parlance)
    +and `inv_flattening` (``1/f``).
    +
    +Usually, this is only relevant for area and segmentization calculations.  It becomes more relevant as one grows closer to the poles (or equator).
    +"""
    +Base.@kwdef struct Geodesic{T} <: Manifold
    +    semimajor_axis::T = 6378137.0
    +    inv_flattening::T = 298.257223563
    +end

    TraitTarget

    This struct holds a trait parameter or a union of trait parameters. It's essentially a way to construct unions.

    julia
    """
    +    TraitTarget{T}
    +
    +This struct holds a trait parameter or a union of trait parameters.
    +
    +It is primarily used for dispatch into methods which select trait levels,
    +like `apply`, or as a parameter to `target`.
    +
    +# Constructors
    +```julia
    +TraitTarget(GI.PointTrait())
    +TraitTarget(GI.LineStringTrait(), GI.LinearRingTrait()) # and other traits as you may like
    +TraitTarget(TraitTarget(...))

    There are also type based constructors available, but that's not advised.

    julia
    TraitTarget(GI.PointTrait)
    +TraitTarget(Union{GI.LineStringTrait, GI.LinearRingTrait})

    etc.

    julia
    ```
    +
    +"""
    +struct TraitTarget{T} end
    +TraitTarget(::Type{T}) where T = TraitTarget{T}()
    +TraitTarget(::T) where T<:GI.AbstractTrait = TraitTarget{T}()
    +TraitTarget(::TraitTarget{T}) where T = TraitTarget{T}()
    +TraitTarget(::Type{<:TraitTarget{T}}) where T = TraitTarget{T}()
    +TraitTarget(traits::GI.AbstractTrait...) = TraitTarget{Union{map(typeof, traits)...}}()
    +
    +
    +Base.in(::Trait, ::TraitTarget{Target}) where {Trait <: GI.AbstractTrait, Target} = Trait <: Target

    BoolsAsTypes

    In apply and applyreduce, we pass threading and calc_extent as types, not simple boolean values.

    This is to help compilation - with a type to hold on to, it's easier for the compiler to separate threaded and non-threaded code paths.

    Note that if we didn't include the parent abstract type, this would have been really type unstable, since the compiler couldn't tell what would be returned!

    We had to add the type annotation on the _booltype(::Bool) method for this reason as well.

    TODO: should we switch to Static.jl?

    julia
    """
    +    abstract type BoolsAsTypes
    +
    +"""
    +abstract type BoolsAsTypes end
    +
    +"""
    +    struct _True <: BoolsAsTypes
    +
    +A struct that means `true`.
    +"""
    +struct _True <: BoolsAsTypes end
    +
    +"""
    +    struct _False <: BoolsAsTypes
    +
    +A struct that means `false`.
    +"""
    +struct _False <: BoolsAsTypes end
    +
    +"""
    +    _booltype(x)
    +
    +Returns a `BoolsAsTypes` from `x`, whether it's a boolean or a BoolsAsTypes.
    +"""
    +function _booltype end
    +
    +@inline _booltype(x::Bool)::BoolsAsTypes = x ? _True() : _False()
    +@inline _booltype(x::BoolsAsTypes)::BoolsAsTypes = x

    This page was generated using Literate.jl.

    + + + + \ No newline at end of file diff --git a/previews/PR237/source/transformations/correction/closed_ring.html b/previews/PR237/source/transformations/correction/closed_ring.html new file mode 100644 index 000000000..3f42e3ef6 --- /dev/null +++ b/previews/PR237/source/transformations/correction/closed_ring.html @@ -0,0 +1,54 @@ + + + + + + Closed Rings | GeometryOps.jl + + + + + + + + + + + + + + +
    Skip to content

    Closed Rings

    julia
    export ClosedRing

    A closed ring is a ring that has the same start and end point. This is a requirement for a valid polygon (technically, for a valid LinearRing). This correction is used to ensure that the polygon is valid.

    The reason this operates on the polygon level is that several packages are loose about whether they return LinearRings (which is correct) or LineStrings (which is incorrect) for the contents of a polygon. Therefore, we decompose manually to ensure correctness.

    Example

    Many polygon providers do not close their polygons, which makes them invalid according to the specification. Quite a few geometry algorithms assume that polygons are closed, and leaving them open can lead to incorrect results!

    For example, the following polygon is not valid:

    julia
    import GeoInterface as GI
    +polygon = GI.Polygon([[(0, 0), (1, 0), (1, 1), (0, 1)]])
    GeoInterface.Wrappers.Polygon{false, false, Vector{GeoInterface.Wrappers.LinearRing{false, false, Vector{Tuple{Int64, Int64}}, Nothing, Nothing}}, Nothing, Nothing}(GeoInterface.Wrappers.LinearRing{false, false, Vector{Tuple{Int64, Int64}}, Nothing, Nothing}[GeoInterface.Wrappers.LinearRing{false, false, Vector{Tuple{Int64, Int64}}, Nothing, Nothing}([(0, 0), (1, 0), (1, 1), (0, 1)], nothing, nothing)], nothing, nothing)

    even though it will look correct when visualized, and indeed appears correct.

    julia
    import GeometryOps as GO
    +GO.fix(polygon, corrections = [GO.ClosedRing()])
    GeoInterface.Wrappers.Polygon{false, false, Vector{GeoInterface.Wrappers.LinearRing{false, false, Vector{Tuple{Float64, Float64}}, Nothing, Nothing}}, Nothing, Nothing}(GeoInterface.Wrappers.LinearRing{false, false, Vector{Tuple{Float64, Float64}}, Nothing, Nothing}[GeoInterface.Wrappers.LinearRing{false, false, Vector{Tuple{Float64, Float64}}, Nothing, Nothing}([(0.0, 0.0), (1.0, 0.0), (1.0, 1.0), (0.0, 1.0), (0.0, 0.0)], nothing, nothing)], nothing, nothing)

    You can see that the last point of the ring here is equal to the first point. For a polygon with n sides, there should be n+1 vertices.

    Implementation

    julia
    """
    +    ClosedRing() <: GeometryCorrection
    +
    +This correction ensures that a polygon's exterior and interior rings are closed.
    +
    +It can be called on any geometry correction as usual.
    +
    +See also `GeometryCorrection`.
    +"""
    +struct ClosedRing <: GeometryCorrection end
    +
    +application_level(::ClosedRing) = GI.PolygonTrait
    +
    +function (::ClosedRing)(::GI.PolygonTrait, polygon)
    +    exterior = _close_linear_ring(GI.getexterior(polygon))
    +
    +    holes = map(GI.gethole(polygon)) do hole
    +        _close_linear_ring(hole) # TODO: make this more efficient, or use tuples!
    +    end
    +
    +    return GI.Wrappers.Polygon([exterior, holes...])
    +end
    +
    +function _close_linear_ring(ring)
    +    if GI.getpoint(ring, 1) == GI.getpoint(ring, GI.npoint(ring))

    the ring is closed, all hail the ring

    julia
            return ring
    +    else

    Assemble the ring as a vector

    julia
            tups = tuples.(GI.getpoint(ring))

    Close the ring

    julia
            push!(tups, tups[1])

    Return an actual ring

    julia
            return GI.LinearRing(tups)
    +    end
    +end

    This page was generated using Literate.jl.

    + + + + \ No newline at end of file diff --git a/previews/PR237/source/transformations/correction/geometry_correction.html b/previews/PR237/source/transformations/correction/geometry_correction.html new file mode 100644 index 000000000..ae6dd9f75 --- /dev/null +++ b/previews/PR237/source/transformations/correction/geometry_correction.html @@ -0,0 +1,55 @@ + + + + + + Geometry Corrections | GeometryOps.jl + + + + + + + + + + + + + + +
    Skip to content

    Geometry Corrections

    julia
    export fix

    This file simply defines the GeometryCorrection abstract type, and the interface that any GeometryCorrection must implement.

    A geometry correction is a transformation that is applied to a geometry to correct it in some way.

    For example, a ClosedRing correction might be applied to a Polygon to ensure that its exterior ring is closed.

    Interface

    All GeometryCorrections are callable structs which, when called, apply the correction to the given geometry, and return either a copy or the original geometry (if nothing needed to be corrected).

    See below for the full interface specification.

    GeometryOps.GeometryCorrection Type
    julia
    abstract type GeometryCorrection

    This abstract type represents a geometry correction.

    Interface

    Any GeometryCorrection must implement two functions: * application_level(::GeometryCorrection)::AbstractGeometryTrait: This function should return the GeoInterface trait that the correction is intended to be applied to, like PointTrait or LineStringTrait or PolygonTrait. * (::GeometryCorrection)(::AbstractGeometryTrait, geometry)::(some_geometry): This function should apply the correction to the given geometry, and return a new geometry.

    source

    Any geometry correction must implement the interface as given above.

    julia
    """
    +    abstract type GeometryCorrection
    +
    +This abstract type represents a geometry correction.
    +
    +# Interface
    +
    +Any `GeometryCorrection` must implement two functions:
    +    * `application_level(::GeometryCorrection)::AbstractGeometryTrait`: This function should return the `GeoInterface` trait that the correction is intended to be applied to, like `PointTrait` or `LineStringTrait` or `PolygonTrait`.
    +    * `(::GeometryCorrection)(::AbstractGeometryTrait, geometry)::(some_geometry)`: This function should apply the correction to the given geometry, and return a new geometry.
    +"""
    +abstract type GeometryCorrection end
    +
    +application_level(gc::GeometryCorrection) = error("Not implemented yet for $(gc)")
    +
    +(gc::GeometryCorrection)(geometry) = gc(GI.trait(geometry), geometry)
    +
    +(gc::GeometryCorrection)(trait::GI.AbstractGeometryTrait, geometry) = error("Not implemented yet for $(gc) and $(trait).")
    +
    +function fix(geometry; corrections = GeometryCorrection[ClosedRing(),], kwargs...)
    +    traits = application_level.(corrections)
    +    final_geometry = geometry
    +    for Trait in (GI.PointTrait, GI.MultiPointTrait, GI.LineStringTrait, GI.LinearRingTrait, GI.MultiLineStringTrait, GI.PolygonTrait, GI.MultiPolygonTrait)
    +        available_corrections = findall(x -> x == Trait, traits)
    +        isempty(available_corrections) && continue
    +        @debug "Correcting for $(Trait)"
    +        net_function = reduce(, corrections[available_corrections])
    +        final_geometry = apply(net_function, Trait, final_geometry; kwargs...)
    +    end
    +    return final_geometry
    +end

    Available corrections

    GeometryOps.ClosedRing Type
    julia
    ClosedRing() <: GeometryCorrection

    This correction ensures that a polygon's exterior and interior rings are closed.

    It can be called on any geometry correction as usual.

    See also GeometryCorrection.

    source

    GeometryOps.DiffIntersectingPolygons Type
    julia
    DiffIntersectingPolygons() <: GeometryCorrection

    This correction ensures that the polygons included in a multipolygon aren't intersecting. If any polygon's are intersecting, they will be made nonintersecting through the difference operation to create a unique set of disjoint (other than potentially connections by a single point) polygons covering the same area. See also GeometryCorrection, UnionIntersectingPolygons.

    source

    GeometryOps.GeometryCorrection Type
    julia
    abstract type GeometryCorrection

    This abstract type represents a geometry correction.

    Interface

    Any GeometryCorrection must implement two functions: * application_level(::GeometryCorrection)::AbstractGeometryTrait: This function should return the GeoInterface trait that the correction is intended to be applied to, like PointTrait or LineStringTrait or PolygonTrait. * (::GeometryCorrection)(::AbstractGeometryTrait, geometry)::(some_geometry): This function should apply the correction to the given geometry, and return a new geometry.

    source

    GeometryOps.UnionIntersectingPolygons Type
    julia
    UnionIntersectingPolygons() <: GeometryCorrection

    This correction ensures that the polygon's included in a multipolygon aren't intersecting. If any polygon's are intersecting, they will be combined through the union operation to create a unique set of disjoint (other than potentially connections by a single point) polygons covering the same area.

    See also GeometryCorrection.

    source


    This page was generated using Literate.jl.

    + + + + \ No newline at end of file diff --git a/previews/PR237/source/transformations/correction/intersecting_polygons.html b/previews/PR237/source/transformations/correction/intersecting_polygons.html new file mode 100644 index 000000000..fca4d7c4f --- /dev/null +++ b/previews/PR237/source/transformations/correction/intersecting_polygons.html @@ -0,0 +1,121 @@ + + + + + + Intersecting Polygons | GeometryOps.jl + + + + + + + + + + + + + + +
    Skip to content

    Intersecting Polygons

    julia
    export UnionIntersectingPolygons

    If the sub-polygons of a multipolygon are intersecting, this makes them invalid according to specification. Each sub-polygon of a multipolygon being disjoint (other than by a single point) is a requirement for a valid multipolygon. However, different libraries may achieve this in different ways.

    For example, taking the union of all sub-polygons of a multipolygon will create a new multipolygon where each sub-polygon is disjoint. This can be done with the UnionIntersectingPolygons correction.

    The reason this operates on a multipolygon level is that it is easy for users to mistakenly create multipolygon's that overlap, which can then be detrimental to polygon clipping performance and even create wrong answers.

    Example

    Multipolygon providers may not check that the polygons making up their multipolygons do not intersect, which makes them invalid according to the specification.

    For example, the following multipolygon is not valid:

    julia
    import GeoInterface as GI
    +polygon = GI.Polygon([[(0.0, 0.0), (3.0, 0.0), (3.0, 3.0), (0.0, 3.0), (0.0, 0.0)]])
    +multipolygon = GI.MultiPolygon([polygon, polygon])
    GeoInterface.Wrappers.MultiPolygon{false, false, Vector{GeoInterface.Wrappers.Polygon{false, false, Vector{GeoInterface.Wrappers.LinearRing{false, false, Vector{Tuple{Float64, Float64}}, Nothing, Nothing}}, Nothing, Nothing}}, Nothing, Nothing}(GeoInterface.Wrappers.Polygon{false, false, Vector{GeoInterface.Wrappers.LinearRing{false, false, Vector{Tuple{Float64, Float64}}, Nothing, Nothing}}, Nothing, Nothing}[GeoInterface.Wrappers.Polygon{false, false, Vector{GeoInterface.Wrappers.LinearRing{false, false, Vector{Tuple{Float64, Float64}}, Nothing, Nothing}}, Nothing, Nothing}(GeoInterface.Wrappers.LinearRing{false, false, Vector{Tuple{Float64, Float64}}, Nothing, Nothing}[GeoInterface.Wrappers.LinearRing{false, false, Vector{Tuple{Float64, Float64}}, Nothing, Nothing}([(0.0, 0.0), (3.0, 0.0), (3.0, 3.0), (0.0, 3.0), (0.0, 0.0)], nothing, nothing)], nothing, nothing), GeoInterface.Wrappers.Polygon{false, false, Vector{GeoInterface.Wrappers.LinearRing{false, false, Vector{Tuple{Float64, Float64}}, Nothing, Nothing}}, Nothing, Nothing}(GeoInterface.Wrappers.LinearRing{false, false, Vector{Tuple{Float64, Float64}}, Nothing, Nothing}[GeoInterface.Wrappers.LinearRing{false, false, Vector{Tuple{Float64, Float64}}, Nothing, Nothing}([(0.0, 0.0), (3.0, 0.0), (3.0, 3.0), (0.0, 3.0), (0.0, 0.0)], nothing, nothing)], nothing, nothing)], nothing, nothing)

    given that the two sub-polygons are the exact same shape.

    julia
    import GeometryOps as GO
    +GO.fix(multipolygon, corrections = [GO.UnionIntersectingPolygons()])
    GeoInterface.Wrappers.MultiPolygon{false, false, Vector{GeoInterface.Wrappers.Polygon{false, false, Vector{GeoInterface.Wrappers.LinearRing{false, false, Vector{Tuple{Float64, Float64}}, Nothing, Nothing}}, Nothing, Nothing}}, Nothing, Nothing}(GeoInterface.Wrappers.Polygon{false, false, Vector{GeoInterface.Wrappers.LinearRing{false, false, Vector{Tuple{Float64, Float64}}, Nothing, Nothing}}, Nothing, Nothing}[GeoInterface.Wrappers.Polygon{false, false, Vector{GeoInterface.Wrappers.LinearRing{false, false, Vector{Tuple{Float64, Float64}}, Nothing, Nothing}}, Nothing, Nothing}(GeoInterface.Wrappers.LinearRing{false, false, Vector{Tuple{Float64, Float64}}, Nothing, Nothing}[GeoInterface.Wrappers.LinearRing{false, false, Vector{Tuple{Float64, Float64}}, Nothing, Nothing}([(0.0, 0.0), (3.0, 0.0), (3.0, 3.0), (0.0, 3.0), (0.0, 0.0)], nothing, nothing)], nothing, nothing)], nothing, nothing)

    You can see that the the multipolygon now only contains one sub-polygon, rather than the two identical ones provided.

    Implementation

    julia
    """
    +    UnionIntersectingPolygons() <: GeometryCorrection
    +
    +This correction ensures that the polygon's included in a multipolygon aren't intersecting.
    +If any polygon's are intersecting, they will be combined through the union operation to
    +create a unique set of disjoint (other than potentially connections by a single point)
    +polygons covering the same area.
    +
    +See also `GeometryCorrection`.
    +"""
    +struct UnionIntersectingPolygons <: GeometryCorrection end
    +
    +application_level(::UnionIntersectingPolygons) = GI.MultiPolygonTrait
    +
    +function (::UnionIntersectingPolygons)(::GI.MultiPolygonTrait, multipoly)
    +    union_multipoly = tuples(multipoly)
    +    n_polys = GI.npolygon(multipoly)
    +    if n_polys > 1
    +        keep_idx = trues(n_polys)  # keep track of sub-polygons to remove

    Combine any sub-polygons that intersect

    julia
            for (curr_idx, _) in Iterators.filter(last, Iterators.enumerate(keep_idx))
    +            curr_poly = union_multipoly.geom[curr_idx]
    +            poly_disjoint = false
    +            while !poly_disjoint
    +                poly_disjoint = true  # assume current polygon is disjoint from others
    +                for (next_idx, _) in Iterators.filter(last, Iterators.drop(Iterators.enumerate(keep_idx), curr_idx))
    +                    next_poly = union_multipoly.geom[next_idx]
    +                    if intersects(curr_poly, next_poly)  # if two polygons intersect
    +                        new_polys = union(curr_poly, next_poly; target = GI.PolygonTrait())
    +                        n_new_polys = length(new_polys)
    +                        if n_new_polys == 1  # if polygons combined
    +                            poly_disjoint = false
    +                            union_multipoly.geom[curr_idx] = new_polys[1]
    +                            curr_poly = union_multipoly.geom[curr_idx]
    +                            keep_idx[next_idx] = false
    +                        end
    +                    end
    +                end
    +            end
    +        end
    +        keepat!(union_multipoly.geom, keep_idx)
    +    end
    +    return union_multipoly
    +end
    +
    +"""
    +    DiffIntersectingPolygons() <: GeometryCorrection
    +This correction ensures that the polygons included in a multipolygon aren't intersecting.
    +If any polygon's are intersecting, they will be made nonintersecting through the `difference`
    +operation to create a unique set of disjoint (other than potentially connections by a single point)
    +polygons covering the same area.
    +See also `GeometryCorrection`, `UnionIntersectingPolygons`.
    +"""
    +struct DiffIntersectingPolygons <: GeometryCorrection end
    +
    +application_level(::DiffIntersectingPolygons) = GI.MultiPolygonTrait
    +
    +function (::DiffIntersectingPolygons)(::GI.MultiPolygonTrait, multipoly)
    +    diff_multipoly = tuples(multipoly)
    +    n_starting_polys = GI.npolygon(multipoly)
    +    n_polys = n_starting_polys
    +    if n_polys > 1
    +        keep_idx = trues(n_polys)  # keep track of sub-polygons to remove

    Break apart any sub-polygons that intersect

    julia
            for curr_idx in 1:n_starting_polys
    +            !keep_idx[curr_idx] && continue
    +            for next_idx in (curr_idx + 1):n_starting_polys
    +                !keep_idx[next_idx] && continue
    +                next_poly = diff_multipoly.geom[next_idx]
    +                n_new_polys = 0
    +                curr_pieces_added = (n_polys + 1):(n_polys + n_new_polys)
    +                for curr_piece_idx in Iterators.flatten((curr_idx:curr_idx, curr_pieces_added))
    +                    !keep_idx[curr_piece_idx] && continue
    +                    curr_poly = diff_multipoly.geom[curr_piece_idx]
    +                    if intersects(curr_poly, next_poly)  # if two polygons intersect
    +                        new_polys = difference(curr_poly, next_poly; target = GI.PolygonTrait())
    +                        n_new_pieces = length(new_polys) - 1
    +                        if n_new_pieces < 0  # current polygon is covered by next_polygon
    +                            keep_idx[curr_piece_idx] = false
    +                            break
    +                        elseif n_new_pieces  0
    +                            diff_multipoly.geom[curr_piece_idx] = new_polys[1]
    +                            curr_poly = diff_multipoly.geom[curr_piece_idx]
    +                            if n_new_pieces > 0 # current polygon breaks into several pieces
    +                                append!(diff_multipoly.geom, @view new_polys[2:end])
    +                                append!(keep_idx, trues(n_new_pieces))
    +                                n_new_polys += n_new_pieces
    +                            end
    +                        end
    +                    end
    +                end
    +                n_polys += n_new_polys
    +            end
    +        end
    +        keepat!(diff_multipoly.geom, keep_idx)
    +    end
    +    return diff_multipoly
    +end

    This page was generated using Literate.jl.

    + + + + \ No newline at end of file diff --git a/previews/PR237/source/transformations/extent.html b/previews/PR237/source/transformations/extent.html new file mode 100644 index 000000000..36fc90edc --- /dev/null +++ b/previews/PR237/source/transformations/extent.html @@ -0,0 +1,37 @@ + + + + + + Extent embedding | GeometryOps.jl + + + + + + + + + + + + + + +
    Skip to content

    Extent embedding

    julia
    """
    +    embed_extent(obj)
    +
    +Recursively wrap the object with a GeoInterface.jl geometry,
    +calculating and adding an `Extents.Extent` to all objects.
    +
    +This can improve performance when extents need to be checked multiple times,
    +such when needing to check if many points are in geometries, and using their extents
    +as a quick filter for obviously exterior points.

    Keywords

    julia
    $THREADED_KEYWORD
    +$CRS_KEYWORD
    +"""
    +embed_extent(x; threaded=false, crs=nothing) =
    +    apply(identity, GI.PointTrait(), x; calc_extent=true, threaded, crs)

    This page was generated using Literate.jl.

    + + + + \ No newline at end of file diff --git a/previews/PR237/source/transformations/flip.html b/previews/PR237/source/transformations/flip.html new file mode 100644 index 000000000..6f19a962d --- /dev/null +++ b/previews/PR237/source/transformations/flip.html @@ -0,0 +1,46 @@ + + + + + + Coordinate flipping | GeometryOps.jl + + + + + + + + + + + + + + +
    Skip to content

    Coordinate flipping

    This is a simple example of how to use the apply functionality in a function, by flipping the x and y coordinates of a geometry.

    julia
    """
    +    flip(obj)
    +
    +Swap all of the x and y coordinates in obj, otherwise
    +keeping the original structure (but not necessarily the
    +original type).
    +
    +# Keywords
    +
    +$APPLY_KEYWORDS
    +"""
    +function flip(geom; kw...)
    +    if _is3d(geom)
    +        return apply(PointTrait(), geom; kw...) do p
    +            (GI.y(p), GI.x(p), GI.z(p))
    +        end
    +    else
    +        return apply(PointTrait(), geom; kw...) do p
    +            (GI.y(p), GI.x(p))
    +        end
    +    end
    +end

    This page was generated using Literate.jl.

    + + + + \ No newline at end of file diff --git a/previews/PR237/source/transformations/reproject.html b/previews/PR237/source/transformations/reproject.html new file mode 100644 index 000000000..637598588 --- /dev/null +++ b/previews/PR237/source/transformations/reproject.html @@ -0,0 +1,65 @@ + + + + + + Geometry reprojection | GeometryOps.jl + + + + + + + + + + + + + + +
    Skip to content

    Geometry reprojection

    julia
    export reproject

    This file is pretty simple - it simply reprojects a geometry pointwise from one CRS to another. It uses the Proj package for the transformation, but this could be moved to an extension if needed.

    Note that the actual implementation is in the GeometryOpsProjExt extension module.

    This works using the apply functionality.

    julia
    """
    +    reproject(geometry; source_crs, target_crs, transform, always_xy, time)
    +    reproject(geometry, source_crs, target_crs; always_xy, time)
    +    reproject(geometry, transform; always_xy, time)
    +
    +Reproject any GeoInterface.jl compatible `geometry` from `source_crs` to `target_crs`.
    +
    +The returned object will be constructed from `GeoInterface.WrapperGeometry`
    +geometries, wrapping views of a `Vector{Proj.Point{D}}`, where `D` is the dimension.
    +
    +!!! tip
    +    The `Proj.jl` package must be loaded for this method to work,
    +    since it is implemented in a package extension.
    +
    +# Arguments
    +
    +- `geometry`: Any GeoInterface.jl compatible geometries.
    +- `source_crs`: the source coordinate reference system, as a GeoFormatTypes.jl object or a string.
    +- `target_crs`: the target coordinate reference system, as a GeoFormatTypes.jl object or a string.
    +
    +If these a passed as keywords, `transform` will take priority.
    +Without it `target_crs` is always needed, and `source_crs` is
    +needed if it is not retrievable from the geometry with `GeoInterface.crs(geometry)`.
    +
    +# Keywords
    +
    +- `always_xy`: force x, y coordinate order, `true` by default.
    +    `false` will expect and return points in the crs coordinate order.
    +- `time`: the time for the coordinates. `Inf` by default.
    +$APPLY_KEYWORDS
    +"""
    +function reproject end

    Method error handling

    We also inject a method error handler, which prints a suggestion if the Proj extension is not loaded.

    julia
    function _reproject_error_hinter(io, exc, argtypes, kwargs)
    +    if isnothing(Base.get_extension(GeometryOps, :GeometryOpsProjExt)) && exc.f == reproject
    +        print(io, "\n\nThe `reproject` method requires the Proj.jl package to be explicitly loaded.\n")
    +        print(io, "You can do this by simply typing ")
    +        printstyled(io, "using Proj"; color = :cyan, bold = true)
    +        println(io, " in your REPL, \nor otherwise loading Proj.jl via using or import.")
    +    else # this is a more general error
    +        nothing
    +    end
    +end

    This page was generated using Literate.jl.

    + + + + \ No newline at end of file diff --git a/previews/PR237/source/transformations/segmentize.html b/previews/PR237/source/transformations/segmentize.html new file mode 100644 index 000000000..b77c49e77 --- /dev/null +++ b/previews/PR237/source/transformations/segmentize.html @@ -0,0 +1,185 @@ + + + + + + Segmentize | GeometryOps.jl + + + + + + + + + + + + + + +
    Skip to content

    Segmentize

    julia
    export segmentize
    +export LinearSegments, GeodesicSegments

    This function "segmentizes" or "densifies" a geometry by adding extra vertices to the geometry so that no segment is longer than a given distance. This is useful for plotting geometries with a limited number of vertices, or for ensuring that a geometry is not too "coarse" for a given application.

    Info

    We plan to add interpolated segmentization from DataInterpolations.jl in the future, which will be available to any vector of point-like objects.

    For now, this function only works on 2D geometries.  We will also support 3D geometries, as well as measure interpolation, in the future.

    Examples

    julia
    import GeometryOps as GO, GeoInterface as GI
    +rectangle = GI.Wrappers.Polygon([[(0.0, 50.0), (7.071, 57.07), (0, 64.14), (-7.07, 57.07), (0.0, 50.0)]])
    +linear = GO.segmentize(rectangle; max_distance = 5)
    +collect(GI.getpoint(linear))
    9-element Vector{Tuple{Float64, Float64}}:
    + (0.0, 50.0)
    + (3.5355, 53.535)
    + (7.071, 57.07)
    + (3.5355, 60.605000000000004)
    + (0.0, 64.14)
    + (-3.535, 60.605000000000004)
    + (-7.07, 57.07)
    + (-3.535, 53.535)
    + (0.0, 50.0)

    You can see that this geometry was segmentized correctly, and now has 8 vertices where it previously had only 4.

    Now, we'll also segmentize this using the geodesic method, which is more accurate for lat/lon coordinates.

    julia
    using Proj # required to activate the `GeodesicSegments` method!
    +geodesic = GO.segmentize(GO.GeodesicSegments(max_distance = 1000), rectangle)
    +length(GI.getpoint(geodesic) |> collect)
    3585

    This has a lot of points! It's important to keep in mind that the max_distance is in meters, so this is a very fine-grained segmentation.

    Now, let's see what they look like! To make this fair, we'll use approximately the same number of points for both.

    julia
    using CairoMakie
    +linear = GO.segmentize(rectangle; max_distance = 0.01)
    +geodesic = GO.segmentize(GO.GeodesicSegments(; max_distance = 1000), rectangle)
    +f, a, p = poly(collect(GI.getpoint(linear)); label = "Linear", axis = (; aspect = DataAspect()))
    +p2 = poly!(collect(GI.getpoint(geodesic)); label = "Geodesic")
    +axislegend(a; position = :lt)
    +f

    There are two methods available for segmentizing geometries at the moment:

    Missing docstring.

    Missing docstring for LinearSegments. Check Documenter's build log for details.

    Missing docstring.

    Missing docstring for GeodesicSegments. Check Documenter's build log for details.

    Benchmark

    We benchmark our method against LibGEOS's GEOSDensify method, which is a similar method for densifying geometries.

    julia
    using BenchmarkTools: BenchmarkGroup
    +using Chairmarks: @be
    +using Main: plot_trials
    +using CairoMakie
    +
    +import GeometryOps as GO, GeoInterface as GI, LibGEOS as LG
    +
    +segmentize_suite = BenchmarkGroup(["title:Segmentize", "subtitle:Segmentize a rectangle"])
    +
    +rectangle = GI.Wrappers.Polygon([[(0.0, 50.0), (7.071, 57.07), (0.0, 64.14), (-7.07, 57.07), (0.0, 50.0)]])
    +lg_rectangle = GI.convert(LG, rectangle)
    POLYGON ((0 50, 7.071 57.07, 0 64.14, -7.07 57.07, 0 50))
    julia
    # These are initial distances, which yield similar numbers of points
    +# in the final geometry.
    +init_lin = 0.01
    +init_geo = 900
    +
    +# LibGEOS.jl doesn't offer this function, so we just wrap it ourselves!
    +function densify(obj::LG.Geometry, tol::Real, context::LG.GEOSContext = LG.get_context(obj))
    +    result = LG.GEOSDensify_r(context, obj, tol)
    +    if result == C_NULL
    +        error("LibGEOS: Error in GEOSDensify")
    +    end
    +    LG.geomFromGEOS(result, context)
    +end
    +# now, we get to the actual benchmarking:
    +for scalefactor in exp10.(LinRange(log10(0.1), log10(10), 5))
    +    lin_dist = init_lin * scalefactor
    +    geo_dist = init_geo * scalefactor
    +
    +    npoints_linear = GI.npoint(GO.segmentize(rectangle; max_distance = lin_dist))
    +    npoints_geodesic = GO.segmentize(GO.GeodesicSegments(; max_distance = geo_dist), rectangle) |> GI.npoint
    +    npoints_libgeos = GI.npoint(densify(lg_rectangle, lin_dist))
    +
    +    segmentize_suite["Linear"][npoints_linear] = @be GO.segmentize(GO.LinearSegments(; max_distance = $lin_dist), $rectangle) seconds=1
    +    segmentize_suite["Geodesic"][npoints_geodesic] = @be GO.segmentize(GO.GeodesicSegments(; max_distance = $geo_dist), $rectangle) seconds=1
    +    segmentize_suite["LibGEOS"][npoints_libgeos] = @be densify($lg_rectangle, $lin_dist) seconds=1
    +
    +end
    +
    +plot_trials(segmentize_suite)

    julia
    abstract type SegmentizeMethod end
    +"""
    +    LinearSegments(; max_distance::Real)
    +
    +A method for segmentizing geometries by adding extra vertices to the geometry so that no segment is longer than a given distance.
    +
    +Here, `max_distance` is a purely nondimensional quantity and will apply in the input space.   This is to say, that if the polygon is
    +provided in lat/lon coordinates then the `max_distance` will be in degrees of arc.  If the polygon is provided in meters, then the
    +`max_distance` will be in meters.
    +"""
    +Base.@kwdef struct LinearSegments <: SegmentizeMethod
    +    max_distance::Float64
    +end
    +
    +"""
    +    GeodesicSegments(; max_distance::Real, equatorial_radius::Real=6378137, flattening::Real=1/298.257223563)
    +
    +A method for segmentizing geometries by adding extra vertices to the geometry so that no segment is longer than a given distance.
    +This method calculates the distance between points on the geodesic, and assumes input in lat/long coordinates.
    +
    +!!! warning
    +    Any input geometries must be in lon/lat coordinates!  If not, the method may fail or error.
    +
    +# Arguments
    +- `max_distance::Real`: The maximum distance, **in meters**, between vertices in the geometry.
    +- `equatorial_radius::Real=6378137`: The equatorial radius of the Earth, in meters.  Passed to `Proj.geod_geodesic`.
    +- `flattening::Real=1/298.257223563`: The flattening of the Earth, which is the ratio of the difference between the equatorial and polar radii to the equatorial radius.  Passed to `Proj.geod_geodesic`.
    +
    +One can also omit the `equatorial_radius` and `flattening` keyword arguments, and pass a `geodesic` object directly to the eponymous keyword.
    +
    +This method uses the Proj/GeographicLib API for geodesic calculations.
    +"""
    +struct GeodesicSegments{T} <: SegmentizeMethod
    +    geodesic::T# ::Proj.geod_geodesic
    +    max_distance::Float64
    +end

    Add an error hint for GeodesicSegments if Proj is not loaded!

    julia
    function _geodesic_segments_error_hinter(io, exc, argtypes, kwargs)
    +    if isnothing(Base.get_extension(GeometryOps, :GeometryOpsProjExt)) && exc.f == GeodesicSegments
    +        print(io, "\n\nThe `Geodesic` method requires the Proj.jl package to be explicitly loaded.\n")
    +        print(io, "You can do this by simply typing ")
    +        printstyled(io, "using Proj"; color = :cyan, bold = true)
    +        println(io, " in your REPL, \nor otherwise loading Proj.jl via using or import.")
    +    end
    +end

    Implementation

    julia
    """
    +    segmentize([method = Planar()], geom; max_distance::Real, threaded)
    +
    +Segmentize a geometry by adding extra vertices to the geometry so that no segment is longer than a given distance.
    +This is useful for plotting geometries with a limited number of vertices, or for ensuring that a geometry is not too "coarse" for a given application.
    +
    +# Arguments
    +- `method::Manifold = Planar()`: The method to use for segmentizing the geometry.  At the moment, only `Planar` (assumes a flat plane) and `Geodesic` (assumes geometry on the ellipsoidal Earth and uses Vincenty's formulae) are available.
    +- `geom`: The geometry to segmentize.  Must be a `LineString`, `LinearRing`, `Polygon`, `MultiPolygon`, or `GeometryCollection`, or some vector or table of those.
    +- `max_distance::Real`: The maximum distance between vertices in the geometry.  **Beware: for `Planar`, this is in the units of the geometry, but for `Geodesic` and `Spherical` it's in units of the radius of the sphere.**
    +
    +Returns a geometry of similar type to the input geometry, but resampled.
    +"""
    +function segmentize(geom; max_distance, threaded::Union{Bool, BoolsAsTypes} = _False())
    +    return segmentize(Planar(), geom; max_distance, threaded = _booltype(threaded))
    +end

    allow three-arg method as well, just in case

    julia
    segmentize(geom, max_distance::Real; threaded = _False()) = segmentize(Planar(), geom, max_distance; threaded)
    +segmentize(method::Manifold, geom, max_distance::Real; threaded = _False()) = segmentize(Planar(), geom; max_distance, threaded)

    generic implementation

    julia
    function segmentize(method::Manifold, geom; max_distance, threaded::Union{Bool, BoolsAsTypes} = _False())
    +    @assert max_distance > 0 "`max_distance` should be positive and nonzero!  Found $(method.max_distance)."
    +    _segmentize_function(geom) = _segmentize(method, geom, GI.trait(geom); max_distance)
    +    return apply(_segmentize_function, TraitTarget(GI.LinearRingTrait(), GI.LineStringTrait()), geom; threaded)
    +end
    +
    +function segmentize(method::SegmentizeMethod, geom; threaded::Union{Bool, BoolsAsTypes} = _False())
    +    @warn "`segmentize(method::$(typeof(method)), geom) is deprecated; use `segmentize($(method isa LinearSegments ? "Planar()" : "Geodesic()"), geom; max_distance, threaded) instead!"  maxlog=3
    +    @assert method.max_distance > 0 "`max_distance` should be positive and nonzero!  Found $(method.max_distance)."
    +    new_method = method isa LinearSegments ? Planar() : Geodesic()
    +    segmentize(new_method, geom; max_distance = method.max_distance, threaded)
    +end
    +
    +_segmentize(method, geom) = _segmentize(method, geom, GI.trait(geom))
    +#=
    +This is a method which performs the common functionality for both linear and geodesic algorithms,
    +and calls out to the "kernel" function which we've defined per linesegment.
    +=#
    +function _segmentize(method::Union{Planar, Spherical}, geom, T::Union{GI.LineStringTrait, GI.LinearRingTrait}; max_distance)
    +    first_coord = GI.getpoint(geom, 1)
    +    x1, y1 = GI.x(first_coord), GI.y(first_coord)
    +    new_coords = NTuple{2, Float64}[]
    +    sizehint!(new_coords, GI.npoint(geom))
    +    push!(new_coords, (x1, y1))
    +    for coord in Iterators.drop(GI.getpoint(geom), 1)
    +        x2, y2 = GI.x(coord), GI.y(coord)
    +        _fill_linear_kernel!(method, new_coords, x1, y1, x2, y2; max_distance)
    +        x1, y1 = x2, y2
    +    end
    +    return rebuild(geom, new_coords)
    +end
    +
    +function _fill_linear_kernel!(::Planar, new_coords::Vector, x1, y1, x2, y2; max_distance)
    +    dx, dy = x2 - x1, y2 - y1
    +    distance = hypot(dx, dy) # this is a more stable way to compute the Euclidean distance
    +    if distance > max_distance
    +        n_segments = ceil(Int, distance / max_distance)
    +        for i in 1:(n_segments - 1)
    +            t = i / n_segments
    +            push!(new_coords, (x1 + t * dx, y1 + t * dy))
    +        end
    +    end

    End the line with the original coordinate, to avoid any multiplication errors.

    julia
        push!(new_coords, (x2, y2))
    +    return nothing
    +end

    Note

    The _fill_linear_kernel definition for GeodesicSegments is in the GeometryOpsProjExt extension module, in the segmentize.jl file.


    This page was generated using Literate.jl.

    + + + + \ No newline at end of file diff --git a/previews/PR237/source/transformations/simplify.html b/previews/PR237/source/transformations/simplify.html new file mode 100644 index 000000000..dcb29c0da --- /dev/null +++ b/previews/PR237/source/transformations/simplify.html @@ -0,0 +1,514 @@ + + + + + + Geometry simplification | GeometryOps.jl + + + + + + + + + + + + + + +
    Skip to content

    Geometry simplification

    This file holds implementations for the RadialDistance, Douglas-Peucker, and Visvalingam-Whyatt algorithms for simplifying geometries (specifically for polygons and lines).

    The GEOS extension also allows for GEOS's topology preserving simplification as well as Douglas-Peucker simplification implemented in GEOS. Call this by passing GEOS(; method = :TopologyPreserve) or GEOS(; method = :DouglasPeucker) to the algorithm.

    Examples

    A quick and dirty example is:

    julia
    using Makie, GeoInterfaceMakie
    +import GeoInterface as GI
    +import GeometryOps as GO
    +
    +original = GI.Polygon([[[-70.603637, -33.399918], [-70.614624, -33.395332], [-70.639343, -33.392466], [-70.659942, -33.394759], [-70.683975, -33.404504], [-70.697021, -33.419406], [-70.701141, -33.434306], [-70.700454, -33.446339], [-70.694274, -33.458369], [-70.682601, -33.465816], [-70.668869, -33.472117], [-70.646209, -33.473835], [-70.624923, -33.472117], [-70.609817, -33.468107], [-70.595397, -33.458369], [-70.587158, -33.442901], [-70.587158, -33.426283], [-70.590591, -33.414248], [-70.594711, -33.406224], [-70.603637, -33.399918]]])
    +
    +simple = GO.simplify(original; number=6)
    +
    +f, a, p = poly(original; label = "Original")
    +poly!(simple; label = "Simplified")
    +axislegend(a)
    +f

    Benchmark

    We benchmark these methods against LibGEOS's simplify implementation, which uses the Douglas-Peucker algorithm.

    julia
    using BenchmarkTools, Chairmarks, GeoJSON, CairoMakie
    +import GeometryOps as GO, LibGEOS as LG, GeoInterface as GI
    +using CoordinateTransformations
    +using NaturalEarth
    +lg_and_go(geometry) = (GI.convert(LG, geometry), GO.tuples(geometry))
    +# Load in the Natural Earth admin GeoJSON, then extract the USA's geometry
    +fc = NaturalEarth.naturalearth("admin_0_countries", 10)
    +usa_multipoly = fc.geometry[findfirst(==("United States of America"), fc.NAME)] |> x -> GI.convert(LG, x) |> LG.makeValid |> GO.tuples
    +include(joinpath(dirname(dirname(pathof(GO))), "test", "data", "polygon_generation.jl"))
    +
    +usa_poly = GI.getgeom(usa_multipoly, findmax(GO.area.(GI.getgeom(usa_multipoly)))[2]) # isolate the poly with the most area
    +usa_centroid = GO.centroid(usa_poly)
    +usa_reflected = GO.transform(Translation(usa_centroid...)  LinearMap(Makie.rotmatrix2d(π))  Translation((-).(usa_centroid)...), usa_poly)
    +f, a, p = plot(usa_poly; label = "Original", axis = (; aspect = DataAspect()))#; plot!(usa_reflected; label = "Reflected")

    This is the complex polygon we'll be benchmarking.

    julia
    simplify_suite = BenchmarkGroup(["Simplify"])
    +singlepoly_suite = BenchmarkGroup(["Polygon", "title:Polygon simplify", "subtitle:Random blob"])
    +
    +include(joinpath(dirname(dirname(pathof(GO))), "test", "data", "polygon_generation.jl"))
    +
    +for n_verts in round.(Int, exp10.(LinRange(log10(10), log10(10_000), 10)))
    +    geom = GI.Wrappers.Polygon(generate_random_poly(0, 0, n_verts, 2, 0.2, 0.3))
    +    geom_lg, geom_go = lg_and_go(LG.makeValid(GI.convert(LG, geom)))
    +    singlepoly_suite["GO-DP"][GI.npoint(geom)] = @be GO.simplify($geom_go; tol = 0.1) seconds=1
    +    singlepoly_suite["GO-VW"][GI.npoint(geom)] = @be GO.simplify($(GO.VisvalingamWhyatt(; tol = 0.1)), $geom_go) seconds=1
    +    singlepoly_suite["GO-RD"][GI.npoint(geom)] = @be GO.simplify($(GO.RadialDistance(; tol = 0.1)), $geom_go) seconds=1
    +    singlepoly_suite["LibGEOS"][GI.npoint(geom)] = @be LG.simplify($geom_lg, 0.1) seconds=1
    +end
    +
    +plot_trials(singlepoly_suite; legend_position=(1, 1, TopRight()), legend_valign = -2, legend_halign = 1.2, legend_orientation = :horizontal)

    julia
    multipoly_suite = BenchmarkGroup(["MultiPolygon", "title:Multipolygon simplify", "subtitle:USA multipolygon"])
    +
    +for frac in exp10.(LinRange(log10(0.3), log10(1), 6)) # TODO: this example isn't the best.  How can we get this better?
    +    geom = GO.simplify(usa_multipoly; ratio = frac)
    +    geom_lg, geom_go = lg_and_go(geom)
    +    _tol = 0.001
    +    multipoly_suite["GO-DP"][GI.npoint(geom)] = @be GO.simplify($geom_go; tol = $_tol) seconds=1
    +    # multipoly_suite["GO-VW"][GI.npoint(geom)] = @be GO.simplify($(GO.VisvalingamWhyatt(; tol = $_tol)), $geom_go) seconds=1
    +    multipoly_suite["GO-RD"][GI.npoint(geom)] = @be GO.simplify($(GO.RadialDistance(; tol = _tol)), $geom_go) seconds=1
    +    multipoly_suite["LibGEOS"][GI.npoint(geom)] = @be LG.simplify($geom_lg, $_tol) seconds=1
    +    println("""
    +    For $(GI.npoint(geom)) points, the algorithms generated polygons with the following number of vertices:
    +    GO-DP : $(GI.npoint( GO.simplify(geom_go; tol = _tol)))
    +    GO-RD : $(GI.npoint( GO.simplify((GO.RadialDistance(; tol = _tol)), geom_go)))
    +    LGeos : $(GI.npoint( LG.simplify(geom_lg, _tol)))
    +    """)
    +    # GO-VW : $(GI.npoint( GO.simplify((GO.VisvalingamWhyatt(; tol = _tol)), geom_go)))
    +    println()
    +end
    +plot_trials(multipoly_suite)

    julia
    export simplify, VisvalingamWhyatt, DouglasPeucker, RadialDistance
    +
    +const _SIMPLIFY_TARGET = TraitTarget{Union{GI.PolygonTrait, GI.AbstractCurveTrait, GI.MultiPointTrait, GI.PointTrait}}()
    +const MIN_POINTS = 3
    +const SIMPLIFY_ALG_KEYWORDS = """
    +# Keywords
    +
    +- `ratio`: the fraction of points that should remain after `simplify`.
    +    Useful as it will generalise for large collections of objects.
    +- `number`: the number of points that should remain after `simplify`.
    +    Less useful for large collections of mixed size objects.
    +"""
    +const DOUGLAS_PEUCKER_KEYWORDS = """
    +$SIMPLIFY_ALG_KEYWORDS
    +- `tol`: the minimum distance a point will be from the line
    +    joining its neighboring points.
    +"""
    +
    +"""
    +    abstract type SimplifyAlg
    +
    +Abstract type for simplification algorithms.
    +
    +# API
    +
    +For now, the algorithm must hold the `number`, `ratio` and `tol` properties.
    +
    +Simplification algorithm types can hook into the interface by implementing
    +the `_simplify(trait, alg, geom)` methods for whichever traits are necessary.
    +"""
    +abstract type SimplifyAlg end
    +
    +"""
    +    simplify(obj; kw...)
    +    simplify(::SimplifyAlg, obj; kw...)
    +
    +Simplify a geometry, feature, feature collection,
    +or nested vectors or a table of these.
    +
    +`RadialDistance`, `DouglasPeucker`, or
    +`VisvalingamWhyatt` algorithms are available,
    +listed in order of increasing quality but decreasing performance.
    +
    +`PoinTrait` and `MultiPointTrait` are returned unchanged.
    +
    +The default behaviour is `simplify(DouglasPeucker(; kw...), obj)`.
    +Pass in other `SimplifyAlg` to use other algorithms.

    Keywords

    julia
    - `prefilter_alg`: `SimplifyAlg` algorithm used to pre-filter object before
    +    using primary filtering algorithm.
    +$APPLY_KEYWORDS
    +
    +
    +Keywords for DouglasPeucker are allowed when no algorithm is specified:
    +
    +$DOUGLAS_PEUCKER_KEYWORDS

    Example

    julia
    Simplify a polygon to have six points:
    +
    +```jldoctest
    +import GeoInterface as GI
    +import GeometryOps as GO
    +
    +poly = GI.Polygon([[
    +    [-70.603637, -33.399918],
    +    [-70.614624, -33.395332],
    +    [-70.639343, -33.392466],
    +    [-70.659942, -33.394759],
    +    [-70.683975, -33.404504],
    +    [-70.697021, -33.419406],
    +    [-70.701141, -33.434306],
    +    [-70.700454, -33.446339],
    +    [-70.694274, -33.458369],
    +    [-70.682601, -33.465816],
    +    [-70.668869, -33.472117],
    +    [-70.646209, -33.473835],
    +    [-70.624923, -33.472117],
    +    [-70.609817, -33.468107],
    +    [-70.595397, -33.458369],
    +    [-70.587158, -33.442901],
    +    [-70.587158, -33.426283],
    +    [-70.590591, -33.414248],
    +    [-70.594711, -33.406224],
    +    [-70.603637, -33.399918]]])
    +
    +simple = GO.simplify(poly; number=6)
    +GI.npoint(simple)

    output

    julia
    6
    +```
    +"""
    +simplify(alg::SimplifyAlg, data; kw...) = _simplify(alg, data; kw...)
    +simplify(alg::GEOS, data; kw...) = _simplify(alg, data; kw...)

    Default algorithm is DouglasPeucker

    julia
    simplify(
    +    data; prefilter_alg = nothing,
    +    calc_extent=false, threaded=false, crs=nothing, kw...,
    + ) = _simplify(DouglasPeucker(; kw...), data; prefilter_alg, calc_extent, threaded, crs)
    +
    +
    +#= For each algorithm, apply simplification to all curves, multipoints, and
    +points, reconstructing everything else around them. =#
    +function _simplify(alg::Union{SimplifyAlg, GEOS}, data; prefilter_alg=nothing, kw...)
    +    simplifier(geom) = _simplify(GI.trait(geom), alg, geom; prefilter_alg)
    +    return apply(simplifier, _SIMPLIFY_TARGET, data; kw...)
    +end
    +
    +
    +# For Point and MultiPoint traits we do nothing
    +_simplify(::GI.PointTrait, alg, geom; kw...) = geom
    +_simplify(::GI.MultiPointTrait, alg, geom; kw...) = geom
    +
    +# For curves, rings, and polygon we simplify
    +function _simplify(
    +    ::GI.AbstractCurveTrait, alg, geom;
    +    prefilter_alg, preserve_endpoint = true,
    +)
    +    points = if isnothing(prefilter_alg)
    +        tuple_points(geom)
    +    else
    +        _simplify(prefilter_alg, tuple_points(geom), preserve_endpoint)
    +    end
    +    return rebuild(geom, _simplify(alg, points, preserve_endpoint))
    +end
    +
    +function _simplify(::GI.PolygonTrait, alg, geom;  kw...)
    +    # Force treating children as LinearRing
    +    simplifier(g) = _simplify(
    +        GI.LinearRingTrait(), alg, g;
    +        kw..., preserve_endpoint = false,
    +    )
    +    lrs = map(simplifier, GI.getgeom(geom))
    +    return rebuild(geom, lrs)
    +end

    Simplify with RadialDistance Algorithm

    julia
    """
    +    RadialDistance <: SimplifyAlg
    +
    +Simplifies geometries by removing points less than
    +`tol` distance from the line between its neighboring points.
    +
    +$SIMPLIFY_ALG_KEYWORDS
    +- `tol`: the minimum distance between points.
    +
    +Note: user input `tol` is squared to avoid unnecessary computation in algorithm.
    +"""
    +@kwdef struct RadialDistance <: SimplifyAlg
    +    number::Union{Int64,Nothing} = nothing
    +    ratio::Union{Float64,Nothing} = nothing
    +    tol::Union{Float64,Nothing} = nothing
    +
    +    function RadialDistance(number, ratio, tol)
    +        _checkargs(number, ratio, tol)

    square tolerance for reduced computation

    julia
            tol = isnothing(tol) ? tol : tol^2
    +        new(number, ratio, tol)
    +    end
    +end
    +
    +function _simplify(alg::RadialDistance, points::Vector, _)
    +    previous = first(points)
    +    distances = Array{Float64}(undef, length(points))
    +    for i in eachindex(points)
    +        point = points[i]
    +        distances[i] = _squared_euclid_distance(Float64, point, previous)
    +        previous = point
    +    end
    +    # Never remove the end points
    +    distances[begin] = distances[end] = Inf
    +    return _get_points(alg, points, distances)
    +end

    Simplify with DouglasPeucker Algorithm

    julia
    """
    +    DouglasPeucker <: SimplifyAlg
    +
    +    DouglasPeucker(; number, ratio, tol)
    +
    +Simplifies geometries by removing points below `tol`
    +distance from the line between its neighboring points.
    +
    +$DOUGLAS_PEUCKER_KEYWORDS
    +Note: user input `tol` is squared to avoid unnecessary computation in algorithm.
    +"""
    +@kwdef struct DouglasPeucker <: SimplifyAlg
    +    number::Union{Int64,Nothing} = nothing
    +    ratio::Union{Float64,Nothing} = nothing
    +    tol::Union{Float64,Nothing} = nothing
    +
    +    function DouglasPeucker(number, ratio, tol)
    +        _checkargs(number, ratio, tol)

    square tolerance for reduced computation

    julia
            tol = isnothing(tol) ? tol : tol^2
    +        return new(number, ratio, tol)
    +    end
    +end
    +
    +#= Simplify using the DouglasPeucker algorithm - nice gif of process on wikipedia:
    +(https://en.wikipedia.org/wiki/Ramer-Douglas-Peucker_algorithm). =#
    +function _simplify(alg::DouglasPeucker, points::Vector, preserve_endpoint)
    +    npoints = length(points)
    +    npoints <= MIN_POINTS && return points

    Determine stopping criteria

    julia
        max_points = if !isnothing(alg.tol)
    +        npoints
    +    else
    +        npts = !isnothing(alg.number) ? alg.number : max(3, round(Int, alg.ratio * npoints))
    +        npts  npoints && return points
    +        npts
    +    end
    +    max_tol = !isnothing(alg.tol) ? alg.tol : zero(Float64)

    Set up queue

    julia
        queue = Vector{Tuple{Int, Int, Int, Float64}}()
    +    queue_idx, queue_dist = 0, zero(Float64)
    +    len_queue = 0

    Set up results vector

    julia
        results = Vector{Int}(undef, max_points + (preserve_endpoint ? 0 : 1))
    +    results[1], results[2] = 1, npoints

    Loop through points until stopping criteria are fulfilled

    julia
        i = 2  # already have first and last point added
    +    start_idx, end_idx = 1, npoints
    +    max_idx, max_dist = _find_max_squared_dist(points, start_idx, end_idx)
    +    while i  min(MIN_POINTS + 1, max_points) || (i < max_points && max_dist > max_tol)

    Add next point to results

    julia
            i += 1
    +        results[i] = max_idx

    Determine which point to add next by checking left and right of point

    julia
            left_idx, left_dist = _find_max_squared_dist(points, start_idx, max_idx)
    +        right_idx, right_dist = _find_max_squared_dist(points, max_idx, end_idx)
    +        left_vals = (start_idx, left_idx, max_idx, left_dist)
    +        right_vals = (max_idx, right_idx, end_idx, right_dist)

    Add and remove values from queue

    julia
            if queue_dist > left_dist && queue_dist > right_dist

    Value in queue is next value to add to results

    julia
                start_idx, max_idx, end_idx, max_dist = queue[queue_idx]

    Add left and/or right values to queue or delete used queue value

    julia
                if left_dist > 0
    +                queue[queue_idx] = left_vals
    +                if right_dist > 0
    +                    push!(queue, right_vals)
    +                    len_queue += 1
    +                end
    +            elseif right_dist > 0
    +                queue[queue_idx] = right_vals
    +            else
    +                deleteat!(queue, queue_idx)
    +                len_queue -= 1
    +            end

    Determine new maximum queue value

    julia
                queue_dist, queue_idx = !isempty(queue) ?
    +                findmax(x -> x[4], queue) : (zero(Float64), 0)
    +        elseif left_dist > right_dist  # use left value as next value to add to results
    +            push!(queue, right_vals)  # add right value to queue
    +            len_queue += 1
    +            if right_dist > queue_dist
    +                queue_dist = right_dist
    +                queue_idx = len_queue
    +            end
    +            start_idx, max_idx, end_idx, max_dist = left_vals
    +        else  # use right value as next value to add to results
    +            push!(queue, left_vals)  # add left value to queue
    +            len_queue += 1
    +            if left_dist > queue_dist
    +                queue_dist = left_dist
    +                queue_idx = len_queue
    +            end
    +            start_idx, max_idx, end_idx, max_dist = right_vals
    +        end
    +    end
    +    sorted_results = sort!(@view results[1:i])
    +    if !preserve_endpoint && i > 3

    Check start/endpoint distance to other points to see if it meets criteria

    julia
            pre_pt, post_pt = points[sorted_results[end - 1]], points[sorted_results[2]]
    +        endpt_dist = _squared_distance_line(Float64, points[1], pre_pt, post_pt)
    +        if !isnothing(alg.tol)

    Remove start point and replace with second point

    julia
                if endpt_dist < max_tol
    +                results[i] = results[2]
    +                sorted_results = @view results[2:i]
    +            end
    +        else

    Remove start point and add point with maximum distance still remaining

    julia
                if endpt_dist < max_dist
    +                insert!(results, searchsortedfirst(sorted_results, max_idx), max_idx)
    +                results[i+1] = results[2]
    +                sorted_results = @view results[2:i+1]
    +            end
    +        end
    +    end
    +    return points[sorted_results]
    +end
    +
    +#= find maximum distance of any point between the start_idx and end_idx to the line formed
    +by connecting the points at start_idx and end_idx. Note that the first index of maximum
    +value will be used, which might cause differences in results from other algorithms.=#
    +function _find_max_squared_dist(points, start_idx, end_idx)
    +    max_idx = start_idx
    +    max_dist = zero(Float64)
    +    for i in (start_idx + 1):(end_idx - 1)
    +        d = _squared_distance_line(Float64, points[i], points[start_idx], points[end_idx])
    +        if d > max_dist
    +            max_dist = d
    +            max_idx = i
    +        end
    +    end
    +    return max_idx, max_dist
    +end

    Simplify with VisvalingamWhyatt Algorithm

    julia
    """
    +    VisvalingamWhyatt <: SimplifyAlg
    +
    +    VisvalingamWhyatt(; kw...)
    +
    +Simplifies geometries by removing points below `tol`
    +distance from the line between its neighboring points.
    +
    +$SIMPLIFY_ALG_KEYWORDS
    +- `tol`: the minimum area of a triangle made with a point and
    +    its neighboring points.
    +Note: user input `tol` is doubled to avoid unnecessary computation in algorithm.
    +"""
    +@kwdef struct VisvalingamWhyatt <: SimplifyAlg
    +    number::Union{Int,Nothing} = nothing
    +    ratio::Union{Float64,Nothing} = nothing
    +    tol::Union{Float64,Nothing} = nothing
    +
    +    function VisvalingamWhyatt(number, ratio, tol)
    +        _checkargs(number, ratio, tol)

    double tolerance for reduced computation

    julia
            tol = isnothing(tol) ? tol : tol*2
    +        return new(number, ratio, tol)
    +    end
    +end
    +
    +function _simplify(alg::VisvalingamWhyatt, points::Vector, _)
    +    length(points) <= MIN_POINTS && return points
    +    areas = _build_tolerances(_triangle_double_area, points)
    +    return _get_points(alg, points, areas)
    +end

    Calculates double the area of a triangle given its vertices

    julia
    _triangle_double_area(p1, p2, p3) =
    +    abs(p1[1] * (p2[2] - p3[2]) + p2[1] * (p3[2] - p1[2]) + p3[1] * (p1[2] - p2[2]))

    Shared utils

    julia
    function _build_tolerances(f, points)
    +    nmax = length(points)
    +    real_tolerances = _flat_tolerances(f, points)
    +
    +    tolerances = copy(real_tolerances)
    +    i = [n for n in 1:nmax]
    +
    +    this_tolerance, min_vert = findmin(tolerances)
    +    _remove!(tolerances, min_vert)
    +    deleteat!(i, min_vert)
    +
    +    while this_tolerance < Inf
    +        skip = false
    +
    +        if min_vert < length(i)
    +            right_tolerance = f(
    +                points[i[min_vert - 1]],
    +                points[i[min_vert]],
    +                points[i[min_vert + 1]],
    +            )
    +            if right_tolerance <= this_tolerance
    +                right_tolerance = this_tolerance
    +                skip = min_vert == 1
    +            end
    +
    +            real_tolerances[i[min_vert]] = right_tolerance
    +            tolerances[min_vert] = right_tolerance
    +        end
    +
    +        if min_vert > 2
    +            left_tolerance = f(
    +                points[i[min_vert - 2]],
    +                points[i[min_vert - 1]],
    +                points[i[min_vert]],
    +            )
    +            if left_tolerance <= this_tolerance
    +                left_tolerance = this_tolerance
    +                skip = min_vert == 2
    +            end
    +            real_tolerances[i[min_vert - 1]] = left_tolerance
    +            tolerances[min_vert - 1] = left_tolerance
    +        end
    +
    +        if !skip
    +            min_vert = argmin(tolerances)
    +        end
    +        deleteat!(i, min_vert)
    +        this_tolerance = tolerances[min_vert]
    +        _remove!(tolerances, min_vert)
    +    end
    +
    +    return real_tolerances
    +end
    +
    +function tuple_points(geom)
    +    points = Array{Tuple{Float64,Float64}}(undef, GI.npoint(geom))
    +    for (i, p) in enumerate(GI.getpoint(geom))
    +        points[i] = (GI.x(p), GI.y(p))
    +    end
    +    return points
    +end
    +
    +function _get_points(alg, points, tolerances)
    +    # This assumes that `alg` has the properties
    +    # `tol`, `number`, and `ratio` available...
    +    tol = alg.tol
    +    number = alg.number
    +    ratio = alg.ratio
    +    bit_indices = if !isnothing(tol)
    +        _tol_indices(alg.tol::Float64, points, tolerances)
    +    elseif !isnothing(number)
    +        _number_indices(alg.number::Int64, points, tolerances)
    +    else
    +        _ratio_indices(alg.ratio::Float64, points, tolerances)
    +    end
    +    return points[bit_indices]
    +end
    +
    +function _tol_indices(tol, points, tolerances)
    +    tolerances .>= tol
    +end
    +
    +function _number_indices(n, points, tolerances)
    +    tol = partialsort(tolerances, length(points) - n + 1)
    +    bit_indices = _tol_indices(tol, points, tolerances)
    +    nselected = sum(bit_indices)
    +    # If there are multiple values exactly at `tol` we will get
    +    # the wrong output length. So we need to remove some.
    +    while nselected > n
    +        min_tol = Inf
    +        min_i = 0
    +        for i in eachindex(bit_indices)
    +            bit_indices[i] || continue
    +            if tolerances[i] < min_tol
    +                min_tol = tolerances[i]
    +                min_i = i
    +            end
    +        end
    +        nselected -= 1
    +        bit_indices[min_i] = false
    +    end
    +    return bit_indices
    +end
    +
    +function _ratio_indices(r, points, tolerances)
    +    n = max(3, round(Int, r * length(points)))
    +    return _number_indices(n, points, tolerances)
    +end
    +
    +function _flat_tolerances(f, points)::Vector{Float64}
    +    result = Vector{Float64}(undef, length(points))
    +    result[1] = result[end] = Inf
    +
    +    for i in 2:length(result) - 1
    +        result[i] = f(points[i-1], points[i], points[i+1])
    +    end
    +    return result
    +end
    +
    +function _remove!(s, i)
    +    for j in i:lastindex(s)-1
    +        s[j] = s[j+1]
    +    end
    +end

    Check SimplifyAlgs inputs to make sure they are valid for below algorithms

    julia
    function _checkargs(number, ratio, tol)
    +    count(isnothing, (number, ratio, tol)) == 2 ||
    +        error("Must provide one of `number`, `ratio` or `tol` keywords")
    +    if !isnothing(number)
    +        if number < MIN_POINTS
    +            error("`number` must be $MIN_POINTS or larger. Got $number")
    +        end
    +    elseif !isnothing(ratio)
    +        if ratio <= 0 || ratio > 1
    +            error("`ratio` must be 0 < ratio <= 1. Got $ratio")
    +        end
    +    else  # !isnothing(tol)
    +        if tol  0
    +            error("`tol` must be a positive number. Got $tol")
    +        end
    +    end
    +    return nothing
    +end

    This page was generated using Literate.jl.

    + + + + \ No newline at end of file diff --git a/previews/PR237/source/transformations/transform.html b/previews/PR237/source/transformations/transform.html new file mode 100644 index 000000000..fb283d790 --- /dev/null +++ b/previews/PR237/source/transformations/transform.html @@ -0,0 +1,79 @@ + + + + + + Pointwise transformation | GeometryOps.jl + + + + + + + + + + + + + + +
    Skip to content

    Pointwise transformation

    julia
    """
    +    transform(f, obj)
    +
    +Apply a function `f` to all the points in `obj`.
    +
    +Points will be passed to `f` as an `SVector` to allow
    +using CoordinateTransformations.jl and Rotations.jl
    +without hassle.
    +
    +`SVector` is also a valid GeoInterface.jl point, so will
    +work in all GeoInterface.jl methods.
    +
    +# Example
    +
    +```julia
    +julia> import GeoInterface as GI
    +
    +julia> import GeometryOps as GO
    +
    +julia> geom = GI.Polygon([GI.LinearRing([(1, 2), (3, 4), (5, 6), (1, 2)]), GI.LinearRing([(3, 4), (5, 6), (6, 7), (3, 4)])]);
    +
    +julia> f = CoordinateTransformations.Translation(3.5, 1.5)
    +Translation(3.5, 1.5)
    +
    +julia> GO.transform(f, geom)
    +GeoInterface.Wrappers.Polygon{false, false, Vector{GeoInterface.Wrappers.LinearRing{false, false, Vector{StaticArraysCore.SVector{2, Float64}}, Nothing, Nothing}}, Nothing, Nothing}(GeoInterface.Wrappers.Linea
    +rRing{false, false, Vector{StaticArraysCore.SVector{2, Float64}}, Nothing, Nothing}[GeoInterface.Wrappers.LinearRing{false, false, Vector{StaticArraysCore.SVector{2, Float64}}, Nothing, Nothing}(StaticArraysCo
    +re.SVector{2, Float64}[[4.5, 3.5], [6.5, 5.5], [8.5, 7.5], [4.5, 3.5]], nothing, nothing), GeoInterface.Wrappers.LinearRing{false, false, Vector{StaticArraysCore.SVector{2, Float64}}, Nothing, Nothing}(StaticA
    +rraysCore.SVector{2, Float64}[[6.5, 5.5], [8.5, 7.5], [9.5, 8.5], [6.5, 5.5]], nothing, nothing)], nothing, nothing)
    +```
    +
    +With Rotations.jl you need to actually multiply the Rotation
    +by the `SVector` point, which is easy using an anonymous function.
    +
    +```julia
    +julia> using Rotations
    +
    +julia> GO.transform(p -> one(RotMatrix{2}) * p, geom)
    +GeoInterface.Wrappers.Polygon{false, false, Vector{GeoInterface.Wrappers.LinearRing{false, false, Vector{StaticArraysCore.SVector{2, Int64}}, Nothing, Nothing}}, Nothing, Nothing}(GeoInterface.Wrappers.LinearR
    +ing{false, false, Vector{StaticArraysCore.SVector{2, Int64}}, Nothing, Nothing}[GeoInterface.Wrappers.LinearRing{false, false, Vector{StaticArraysCore.SVector{2, Int64}}, Nothing, Nothing}(StaticArraysCore.SVe
    +ctor{2, Int64}[[2, 1], [4, 3], [6, 5], [2, 1]], nothing, nothing), GeoInterface.Wrappers.LinearRing{false, false, Vector{StaticArraysCore.SVector{2, Int64}}, Nothing, Nothing}(StaticArraysCore.SVector{2, Int64
    +}[[4, 3], [6, 5], [7, 6], [4, 3]], nothing, nothing)], nothing, nothing)
    +```
    +"""
    +function transform(f, geom; kw...)
    +    if _is3d(geom)
    +        return apply(PointTrait(), geom; kw...) do p
    +            f(StaticArrays.SVector{3}((GI.x(p), GI.y(p), GI.z(p))))
    +        end
    +    else
    +        return apply(PointTrait(), geom; kw...) do p
    +            f(StaticArrays.SVector{2}((GI.x(p), GI.y(p))))
    +        end
    +    end
    +end

    This page was generated using Literate.jl.

    + + + + \ No newline at end of file diff --git a/previews/PR237/source/transformations/tuples.html b/previews/PR237/source/transformations/tuples.html new file mode 100644 index 000000000..0aa276838 --- /dev/null +++ b/previews/PR237/source/transformations/tuples.html @@ -0,0 +1,43 @@ + + + + + + Tuple conversion | GeometryOps.jl + + + + + + + + + + + + + + +
    Skip to content

    Tuple conversion

    julia
    """
    +    tuples(obj)
    +
    +Convert all points in `obj` to `Tuple`s, wherever the are nested.
    +
    +Returns a similar object or collection of objects using GeoInterface.jl
    +geometries wrapping `Tuple` points.

    Keywords

    julia
    $APPLY_KEYWORDS
    +"""
    +function tuples(geom, ::Type{T} = Float64; kw...) where T
    +    if _is3d(geom)
    +        return apply(PointTrait(), geom; kw...) do p
    +            (T(GI.x(p)), T(GI.y(p)), T(GI.z(p)))
    +        end
    +    else
    +        return apply(PointTrait(), geom; kw...) do p
    +            (T(GI.x(p)), T(GI.y(p)))
    +        end
    +    end
    +end

    This page was generated using Literate.jl.

    + + + + \ No newline at end of file diff --git a/previews/PR237/source/types.html b/previews/PR237/source/types.html new file mode 100644 index 000000000..98e069341 --- /dev/null +++ b/previews/PR237/source/types.html @@ -0,0 +1,62 @@ + + + + + + Types | GeometryOps.jl + + + + + + + + + + + + + + +
    Skip to content

    Types

    This file defines some fundamental types used in GeometryOps.

    Warning

    Unlike in other Julia packages, only some types are defined in this file, not all. This is because we define types in the files where they are used, to make it easier to understand the code.

    julia
    export GEOS

    GEOS

    GEOS is a struct which instructs the method it's passed to as an algorithm to use the appropriate GEOS function via LibGEOS.jl for the operation.

    It's generally a lot slower than the native Julia implementations, but it's useful for two reasons:

    1. Functionality which doesn't exist in GeometryOps can be accessed through the GeometryOps API, but use GEOS in the backend until someone implements a native Julia version.

    2. It's a good way to test the correctness of the native implementations.

    julia
    """
    +    GEOS(; params...)
    +
    +A struct which instructs the method it's passed to as an algorithm
    +to use the appropriate GEOS function via `LibGEOS.jl` for the operation.
    +
    +Dispatch is generally carried out using the names of the keyword arguments.
    +For example, `segmentize` will only accept a `GEOS` struct with only a
    +`max_distance` keyword, and no other.
    +
    +It's generally a lot slower than the native Julia implementations, since
    +it must convert to the LibGEOS implementation and back - so be warned!
    +"""
    +struct GEOS
    +    params::NamedTuple
    +end
    +
    +function GEOS(; params...)
    +    nt = NamedTuple(params)
    +    return GEOS(nt)
    +end

    These are definitions for convenience, so we don't have to type out alg.params every time.

    julia
    Base.get(alg::GEOS, key, value) = Base.get(alg.params, key, value)
    +Base.get(f::Function, alg::GEOS, key) = Base.get(f, alg.params, key)
    +
    +"""
    +    enforce(alg::GO.GEOS, kw::Symbol, f)
    +
    +Enforce the presence of a keyword argument in a `GEOS` algorithm, and return `alg.params[kw]`.
    +
    +Throws an error if the key is not present, and mentions `f` in the error message (since there isn't
    +a good way to get the name of the function that called this method).
    +"""
    +function enforce(alg::GEOS, kw::Symbol, f)
    +    if haskey(alg.params, kw)
    +        return alg.params[kw]
    +    else
    +        error("$(f) requires a `$(kw)` keyword argument to the `GEOS` algorithm, which was not provided.")
    +    end
    +end

    This page was generated using Literate.jl.

    + + + + \ No newline at end of file diff --git a/previews/PR237/source/utils.html b/previews/PR237/source/utils.html new file mode 100644 index 000000000..fa12594fa --- /dev/null +++ b/previews/PR237/source/utils.html @@ -0,0 +1,144 @@ + + + + + + Utility functions | GeometryOps.jl + + + + + + + + + + + + + + +
    Skip to content

    Utility functions

    julia
    _is3d(geom)::Bool = _is3d(GI.trait(geom), geom)
    +_is3d(::GI.AbstractGeometryTrait, geom)::Bool = GI.is3d(geom)
    +_is3d(::GI.FeatureTrait, feature)::Bool = _is3d(GI.geometry(feature))
    +_is3d(::GI.FeatureCollectionTrait, fc)::Bool = _is3d(GI.getfeature(fc, 1))
    +_is3d(::Nothing, geom)::Bool = _is3d(first(geom)) # Otherwise step into an itererable
    +
    +_npoint(x) = _npoint(trait(x), x)
    +_npoint(::Nothing, xs::AbstractArray) = sum(_npoint, xs)
    +_npoint(::GI.FeatureCollectionTrait, fc) = sum(_npoint, GI.getfeature(fc))
    +_npoint(::GI.FeatureTrait, f) = _npoint(GI.geometry(f))
    +_npoint(::GI.AbstractGeometryTrait, x) = GI.npoint(trait(x), x)
    +
    +_nedge(x) = _nedge(trait(x), x)
    +_nedge(::Nothing, xs::AbstractArray) = sum(_nedge, xs)
    +_nedge(::GI.FeatureCollectionTrait, fc) = sum(_nedge, GI.getfeature(fc))
    +_nedge(::GI.FeatureTrait, f) = _nedge(GI.geometry(f))
    +function _nedge(::GI.AbstractGeometryTrait, x)
    +    n = 0
    +    for g in GI.getgeom(x)
    +        n += _nedge(g)
    +    end
    +    return n
    +end
    +_nedge(::GI.AbstractCurveTrait, x) = GI.npoint(x) - 1
    +_nedge(::GI.PointTrait, x) = error("Cant get edges from points")
    +
    +
    +"""
    +    polygon_to_line(poly::Polygon)
    +
    +Converts a Polygon to LineString or MultiLineString

    Examples

    julia
    ```jldoctest
    +import GeometryOps as GO, GeoInterface as GI
    +
    +poly = GI.Polygon([[(-2.275543, 53.464547), (-2.275543, 53.489271), (-2.215118, 53.489271), (-2.215118, 53.464547), (-2.275543, 53.464547)]])
    +GO.polygon_to_line(poly)

    output

    julia
    GeoInterface.Wrappers.LineString{false, false, Vector{Tuple{Float64, Float64}}, Nothing, Nothing}([(-2.275543, 53.464547), (-2.275543, 53.489271), (-2.215118, 53.489271), (-2.215118, 53.464547), (-2.275543, 53.464547)], nothing, nothing)
    +```
    +"""
    +function polygon_to_line(poly)
    +    @assert GI.trait(poly) isa PolygonTrait
    +    GI.ngeom(poly) > 1 && return GI.MultiLineString(collect(GI.getgeom(poly)))
    +    return GI.LineString(collect(GI.getgeom(GI.getgeom(poly, 1))))
    +end
    +
    +
    +"""
    +    to_edges()
    +
    +Convert any geometry or collection of geometries into a flat
    +vector of `Tuple{Tuple{Float64,Float64},Tuple{Float64,Float64}}` edges.
    +"""
    +function to_edges(x, ::Type{T} = Float64) where T
    +    edges = Vector{Edge{T}}(undef, _nedge(x))
    +    _to_edges!(edges, x, 1)
    +    return edges
    +end
    +
    +_to_edges!(edges::Vector, x, n) = _to_edges!(edges, trait(x), x, n)
    +function _to_edges!(edges::Vector, ::GI.FeatureCollectionTrait, fc, n)
    +    for f in GI.getfeature(fc)
    +        n = _to_edges!(edges, f, n)
    +    end
    +end
    +_to_edges!(edges::Vector, ::GI.FeatureTrait, f, n) = _to_edges!(edges, GI.geometry(f), n)
    +function _to_edges!(edges::Vector, ::GI.AbstractGeometryTrait, fc, n)
    +    for f in GI.getgeom(fc)
    +        n = _to_edges!(edges, f, n)
    +    end
    +end
    +function _to_edges!(edges::Vector, ::GI.AbstractCurveTrait, geom, n)
    +    p1 = GI.getpoint(geom, 1)
    +    p1x, p1y = GI.x(p1), GI.y(p1)
    +    for i in 2:GI.npoint(geom)
    +        p2 = GI.getpoint(geom, i)
    +        p2x, p2y = GI.x(p2), GI.y(p2)
    +        edges[n] = (p1x, p1y), (p2x, p2y)
    +        p1x, p1y = p2x, p2y
    +        n += 1
    +    end
    +    return n
    +end
    +
    +_tuple_point(p) = GI.x(p), GI.y(p)
    +_tuple_point(p, ::Type{T}) where T = T(GI.x(p)), T(GI.y(p))
    +
    +function to_extent(edges::Vector{Edge})
    +    x, y = extrema(first, edges)
    +    Extents.Extent(X=x, Y=y)
    +end
    +
    +function to_points(x, ::Type{T} = Float64) where T
    +    points = Vector{TuplePoint{T}}(undef, _npoint(x))
    +    _to_points!(points, x, 1)
    +    return points
    +end
    +
    +_to_points!(points::Vector, x, n) = _to_points!(points, trait(x), x, n)
    +function _to_points!(points::Vector, ::FeatureCollectionTrait, fc, n)
    +    for f in GI.getfeature(fc)
    +        n = _to_points!(points, f, n)
    +    end
    +end
    +_to_points!(points::Vector, ::FeatureTrait, f, n) = _to_points!(points, GI.geometry(f), n)
    +function _to_points!(points::Vector, ::AbstractGeometryTrait, fc, n)
    +    for f in GI.getgeom(fc)
    +        n = _to_points!(points, f, n)
    +    end
    +end
    +function _to_points!(points::Vector, ::Union{AbstractCurveTrait,MultiPointTrait}, geom, n)
    +    n = 0
    +    for p in GI.getpoint(geom)
    +        n += 1
    +        points[n] = _tuple_point(p)
    +    end
    +    return n
    +end
    +
    +function _point_in_extent(p, extent::Extents.Extent)
    +    (x1, x2), (y1, y2) = extent.X, extent.Y
    +    return x1 ≤ GI.x(p) ≤ x2 && y1 ≤ GI.y(p) ≤ y2
    +end

    This page was generated using Literate.jl.

    + + + + \ No newline at end of file diff --git a/previews/PR237/tutorials/creating_geometry.html b/previews/PR237/tutorials/creating_geometry.html new file mode 100644 index 000000000..b51ddcef3 --- /dev/null +++ b/previews/PR237/tutorials/creating_geometry.html @@ -0,0 +1,113 @@ + + + + + + Creating Geometry | GeometryOps.jl + + + + + + + + + + + + + + +
    Skip to content

    Creating Geometry

    In this tutorial, we're going to:

    1. Create and plot geometries

    2. Plot geometries on a map using GeoMakie and coordinate reference system (CRS)

    3. Create geospatial geometries with embedded coordinate reference system information

    4. Assign attributes to geospatial geometries

    5. Save geospatial geometries to common geospatial file formats

    First, we load some required packages.

    julia
    # Geospatial packages from Julia
    +import GeoInterface as GI
    +import GeometryOps as GO
    +import GeoFormatTypes as GFT
    +using GeoJSON # to load some data
    +# Packages for coordinate transformation and projection
    +import CoordinateTransformations
    +import Proj
    +# Plotting
    +using CairoMakie
    +using GeoMakie

    Creating and plotting geometries

    Let's start by making a single Point.

    julia
    point = GI.Point(0, 0)
    GeoInterface.Wrappers.Point{false, false, Tuple{Int64, Int64}, Nothing}((0, 0), nothing)

    Now, let's plot our point.

    julia
    fig, ax, plt = plot(point)

    Let's create a set of points, and have a bit more fun with plotting.

    julia
    x = [-5, 0, 5, 0];
    +y = [0, -5, 0, 5];
    +points = GI.Point.(zip(x,y));
    +plot!(ax, points; marker = '✈', markersize = 30)
    +fig

    Points can be combined into a single MultiPoint geometry.

    julia
    x = [-5, -5, 5, 5];
    +y = [-5, 5, 5, -5];
    +multipoint = GI.MultiPoint(GI.Point.(zip(x, y)));
    +plot!(ax, multipoint; marker = '☁', markersize = 30)
    +fig

    Let's create a LineString connecting two points.

    julia
    p1 = GI.Point.(-5, 0);
    +p2 = GI.Point.(5, 0);
    +line = GI.LineString([p1,p2])
    +plot!(ax, line; color = :red)
    +fig

    Now, let's create a line connecting multiple points (i.e. a LineString). This time we get a bit more fancy with point creation.

    julia
    r = 2;
    +k = 10;
    +ϴ = 0:0.01:2pi;
    +x = r .* (k + 1) .* cos.(ϴ) .- r .* cos.((k + 1) .* ϴ);
    +y = r .* (k + 1) .* sin.(ϴ) .- r .* sin.((k + 1) .* ϴ);
    +lines = GI.LineString(GI.Point.(zip(x,y)));
    +plot!(ax, lines; linewidth = 5)
    +fig

    We can also create a single LinearRing trait, the building block of a polygon. A LinearRing is simply a LineString with the same beginning and endpoint, i.e., an arbitrary closed shape composed of point pairs.

    A LinearRing is composed of a series of points.

    julia
    ring1 = GI.LinearRing(GI.getpoint(lines));
    GeoInterface.Wrappers.LinearRing{false, false, Vector{GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}}, Nothing, Nothing}(GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}[GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.0, 0.0), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.010987813253244, 0.0004397316773170068), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.043805248003498, 0.0035114210915891397), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.098016055420953, 0.011814947665167774), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.172899020101585, 0.027886421973952302), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.267456684570245, 0.05416726609360478), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.380427415579764, 0.09297443860091348), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.51030066635026, 0.1464721641710074), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.655335250260467, 0.21664550952386064), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.813580405100698, 0.30527612515520186), nothing)  …  GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.866418416586406, -0.3376428491230612), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.704405820024185, -0.24279488312757858), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.55494217175954, -0.16692537029320365), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.420040147662014, -0.10832215707812454), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.30151010318639, -0.0650624499034016), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.200938172182195, -0.03503632062070827), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.119667078681967, -0.01597247419241532), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.058779893613323, -0.005465967083412071), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.019086932781654, -0.0010075412835199304), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.001115954499138, -1.4219350464667047e-5), nothing)], nothing, nothing)

    Now, let's make the LinearRing into a Polygon.

    julia
    polygon1 = GI.Polygon([ring1]);
    GeoInterface.Wrappers.Polygon{false, false, Vector{GeoInterface.Wrappers.LinearRing{false, false, Vector{GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}}, Nothing, Nothing}}, Nothing, Nothing}(GeoInterface.Wrappers.LinearRing{false, false, Vector{GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}}, Nothing, Nothing}[GeoInterface.Wrappers.LinearRing{false, false, Vector{GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}}, Nothing, Nothing}(GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}[GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.0, 0.0), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.010987813253244, 0.0004397316773170068), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.043805248003498, 0.0035114210915891397), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.098016055420953, 0.011814947665167774), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.172899020101585, 0.027886421973952302), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.267456684570245, 0.05416726609360478), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.380427415579764, 0.09297443860091348), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.51030066635026, 0.1464721641710074), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.655335250260467, 0.21664550952386064), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.813580405100698, 0.30527612515520186), nothing)  …  GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.866418416586406, -0.3376428491230612), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.704405820024185, -0.24279488312757858), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.55494217175954, -0.16692537029320365), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.420040147662014, -0.10832215707812454), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.30151010318639, -0.0650624499034016), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.200938172182195, -0.03503632062070827), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.119667078681967, -0.01597247419241532), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.058779893613323, -0.005465967083412071), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.019086932781654, -0.0010075412835199304), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.001115954499138, -1.4219350464667047e-5), nothing)], nothing, nothing)], nothing, nothing)

    Now, we can use GeometryOps and CoordinateTransformations to shift polygon1 up, to avoid plotting over our earlier results. This is done through the GeometryOps.transform function.

    julia
    xoffset = 0.;
    +yoffset = 50.;
    +f = CoordinateTransformations.Translation(xoffset, yoffset);
    +polygon1 = GO.transform(f, polygon1);
    +plot!(polygon1)
    +fig

    Polygons can contain "holes". The first LinearRing in a polygon is the exterior, and all subsequent LinearRings are treated as holes in the leading LinearRing.

    GeoInterface offers the GI.getexterior(poly) and GI.gethole(poly) methods to get the exterior ring and an iterable of holes, respectively.

    julia
    hole = GI.LinearRing(GI.getpoint(multipoint))
    +polygon2 = GI.Polygon([ring1, hole])
    GeoInterface.Wrappers.Polygon{false, false, Vector{GeoInterface.Wrappers.LinearRing{false, false, T, Nothing, Nothing} where T}, Nothing, Nothing}(GeoInterface.Wrappers.LinearRing{false, false, T, Nothing, Nothing} where T[GeoInterface.Wrappers.LinearRing{false, false, Vector{GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}}, Nothing, Nothing}(GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}[GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.0, 0.0), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.010987813253244, 0.0004397316773170068), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.043805248003498, 0.0035114210915891397), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.098016055420953, 0.011814947665167774), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.172899020101585, 0.027886421973952302), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.267456684570245, 0.05416726609360478), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.380427415579764, 0.09297443860091348), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.51030066635026, 0.1464721641710074), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.655335250260467, 0.21664550952386064), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.813580405100698, 0.30527612515520186), nothing)  …  GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.866418416586406, -0.3376428491230612), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.704405820024185, -0.24279488312757858), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.55494217175954, -0.16692537029320365), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.420040147662014, -0.10832215707812454), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.30151010318639, -0.0650624499034016), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.200938172182195, -0.03503632062070827), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.119667078681967, -0.01597247419241532), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.058779893613323, -0.005465967083412071), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.019086932781654, -0.0010075412835199304), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((20.001115954499138, -1.4219350464667047e-5), nothing)], nothing, nothing), GeoInterface.Wrappers.LinearRing{false, false, Vector{GeoInterface.Wrappers.Point{false, false, Tuple{Int64, Int64}, Nothing}}, Nothing, Nothing}(GeoInterface.Wrappers.Point{false, false, Tuple{Int64, Int64}, Nothing}[GeoInterface.Wrappers.Point{false, false, Tuple{Int64, Int64}, Nothing}((-5, -5), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Int64, Int64}, Nothing}((-5, 5), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Int64, Int64}, Nothing}((5, 5), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Int64, Int64}, Nothing}((5, -5), nothing)], nothing, nothing)], nothing, nothing)

    Shift polygon2 to the right, to avoid plotting over our earlier results.

    julia
    xoffset = 50.;
    +yoffset = 0.;
    +f = CoordinateTransformations.Translation(xoffset, yoffset);
    +polygon2 = GO.transform(f, polygon2);
    +plot!(polygon2)
    +fig

    Polygons can also be grouped together as a MultiPolygon.

    julia
    r = 5;
    +x = cos.(reverse(ϴ)) .* r .+ xoffset;
    +y = sin.(reverse(ϴ)) .* r .+ yoffset;
    +ring2 =  GI.LinearRing(GI.Point.(zip(x,y)));
    +polygon3 = GI.Polygon([ring2]);
    +multipolygon = GI.MultiPolygon([polygon2, polygon3])
    GeoInterface.Wrappers.MultiPolygon{false, false, Vector{GeoInterface.Wrappers.Polygon{false, false, _A, Nothing, Nothing} where _A}, Nothing, Nothing}(GeoInterface.Wrappers.Polygon{false, false, _A, Nothing, Nothing} where _A[GeoInterface.Wrappers.Polygon{false, false, Vector{GeoInterface.Wrappers.LinearRing{false, false, Vector{StaticArraysCore.SVector{2, Float64}}, Nothing, Nothing}}, Nothing, Nothing}(GeoInterface.Wrappers.LinearRing{false, false, Vector{StaticArraysCore.SVector{2, Float64}}, Nothing, Nothing}[GeoInterface.Wrappers.LinearRing{false, false, Vector{StaticArraysCore.SVector{2, Float64}}, Nothing, Nothing}(StaticArraysCore.SVector{2, Float64}[[70.0, 0.0], [70.01098781325325, 0.0004397316773170068], [70.0438052480035, 0.0035114210915891397], [70.09801605542096, 0.011814947665167774], [70.17289902010158, 0.027886421973952302], [70.26745668457025, 0.05416726609360478], [70.38042741557976, 0.09297443860091348], [70.51030066635026, 0.1464721641710074], [70.65533525026046, 0.21664550952386064], [70.8135804051007, 0.30527612515520186]  …  [70.86641841658641, -0.3376428491230612], [70.70440582002419, -0.24279488312757858], [70.55494217175954, -0.16692537029320365], [70.42004014766201, -0.10832215707812454], [70.30151010318639, -0.0650624499034016], [70.20093817218219, -0.03503632062070827], [70.11966707868197, -0.01597247419241532], [70.05877989361332, -0.005465967083412071], [70.01908693278165, -0.0010075412835199304], [70.00111595449914, -1.4219350464667047e-5]], nothing, nothing), GeoInterface.Wrappers.LinearRing{false, false, Vector{StaticArraysCore.SVector{2, Float64}}, Nothing, Nothing}(StaticArraysCore.SVector{2, Float64}[[45.0, -5.0], [45.0, 5.0], [55.0, 5.0], [55.0, -5.0]], nothing, nothing)], nothing, nothing), GeoInterface.Wrappers.Polygon{false, false, Vector{GeoInterface.Wrappers.LinearRing{false, false, Vector{GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}}, Nothing, Nothing}}, Nothing, Nothing}(GeoInterface.Wrappers.LinearRing{false, false, Vector{GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}}, Nothing, Nothing}[GeoInterface.Wrappers.LinearRing{false, false, Vector{GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}}, Nothing, Nothing}(GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}[GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((54.999974634566875, -0.01592650896568995), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((54.999565375483215, -0.06592462566760626), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((54.99865616402829, -0.11591614996189725), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((54.997247091122496, -0.16589608273778408), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((54.99533829767195, -0.2158594260436434), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((54.99292997455441, -0.2658011835867806), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((54.990022362600165, -0.31571636123306385), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((54.98661575256801, -0.3655999675063154), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((54.98271048511609, -0.41544701408748197), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((54.9783069507679, -0.46525251631344455), nothing)  …  GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((54.97976366505997, 0.4493927459900552), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((54.9840085315131, 0.3995734698458635), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((54.9877550012664, 0.3497142366876638), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((54.991002699676024, 0.299820032397223), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((54.99375130197483, 0.24989584635339165), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((54.99600053330489, 0.1999466709331708), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((54.997750168744936, 0.1499775010124783), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((54.99900003333289, 0.0999933334666654), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((54.999750002083324, 0.049999166670833324), nothing), GeoInterface.Wrappers.Point{false, false, Tuple{Float64, Float64}, Nothing}((55.0, 0.0), nothing)], nothing, nothing)], nothing, nothing)], nothing, nothing)

    Shift multipolygon up, to avoid plotting over our earlier results.

    julia
    xoffset = 0.;
    +yoffset = 50.;
    +f = CoordinateTransformations.Translation(xoffset, yoffset);
    +multipolygon = GO.transform(f, multipolygon);
    +plot!(multipolygon)
    +fig

    Great, now we can make Points, MultiPoints, Lines, LineStrings, Polygons (with holes), and MultiPolygons and modify them using [CoordinateTransformations] and [GeometryOps].

    Plot geometries on a map using GeoMakie and coordinate reference system (CRS)

    In geospatial sciences we often have data in one Coordinate Reference System (CRS) (source) and would like to display it in different (destination) CRS. GeoMakie allows us to do this by automatically projecting from source to destination CRS.

    Here, our source CRS is common geographic (i.e. coordinates of latitude and longitude), WGS84.

    julia
    source_crs1 = GFT.EPSG(4326)
    GeoFormatTypes.EPSG{1}((4326,))

    Now let's pick a destination CRS for displaying our map. Here we'll pick natearth2.

    julia
    destination_crs = "+proj=natearth2"
    "+proj=natearth2"

    Let's add land area for context. First, download and open the Natural Earth global land polygons at 110 m resolution.GeoMakie ships with this particular dataset, so we will access it from there.

    julia
    land_path = GeoMakie.assetpath("ne_110m_land.geojson")
    "/home/runner/.julia/packages/GeoMakie/t8Vkb/assets/ne_110m_land.geojson"

    Note

    Natural Earth has lots of other datasets, and there is a Julia package that provides an interface to it called NaturalEarth.jl.

    Read the land MultiPolygons as a GeoJSON.FeatureCollection.

    julia
    land_geo = GeoJSON.read(land_path)
    FeatureCollection with 127 Features

    We then need to create a figure with a GeoAxis that can handle the projection between source and destination CRS. For GeoMakie, source is the CRS of the input and dest is the CRS you want to visualize in.

    julia
    fig = Figure(size=(1000, 500));
    +ga = GeoAxis(
    +    fig[1, 1];
    +    source = source_crs1,
    +    dest = destination_crs,
    +    xticklabelsvisible = false,
    +    yticklabelsvisible = false,
    +);

    Plot land for context.

    julia
    poly!(ga, land_geo, color=:black)
    +fig

    Now let's plot a Polygon like before, but this time with a CRS that differs from our source data

    julia
    plot!(multipolygon; color = :green)
    +fig

    But what if we want to plot geometries with a different source CRS on the same figure?

    To show how to do this let's create a geometry with coordinates in UTM (Universal Transverse Mercator) zone 10N EPSG:32610.

    julia
    source_crs2 = GFT.EPSG(32610)
    GeoFormatTypes.EPSG{1}((32610,))

    Create a polygon (we're working in meters now, not latitude and longitude)

    julia
    r = 1000000;
    +ϴ = 0:0.01:2pi;
    +x = r .* cos.(ϴ).^3 .+ 500000;
    +y = r .* sin.(ϴ) .^ 3 .+5000000;
    629-element Vector{Float64}:
    + 5.0e6
    + 5.0e6
    + 5.00001e6
    +
    + 5.0e6
    + 5.0e6

    Now create a LinearRing from Points

    julia
    ring3 = GI.LinearRing(Point.(zip(x, y)))
    GeoInterface.Wrappers.LinearRing{false, false, Vector{Point{2, Float64}}, Nothing, Nothing}(Point{2, Float64}[[1.5e6, 5.0e6], [1.4998500087497458e6, 5.000000999950001e6], [1.4994001399837343e6, 5.000007998400139e6], [1.4986507085647392e6, 5.000026987852369e6], [1.4976022389592e6, 5.000063948817746e6], [1.4962554647802354e6, 5.000124843834609e6], [1.4946113281484335e6, 5.000215611503127e6], [1.4926709788709967e6, 5.000342160541625e6], [1.4904357734399722e6, 5.000510363870095e6], [1.4879072738504685e6, 5.0007260527263e6]  …  [1.4870405593989636e6, 4.999194331880103e6], [1.4896621210021754e6, 4.999426363321033e6], [1.491990928929295e6, 4.999609061508909e6], [1.4940253560034204e6, 4.999748243174828e6], [1.4957639801366436e6, 4.999849768598615e6], [1.497205585568957e6, 4.999919535736425e6], [1.4983491639274692e6, 4.999963474314044e6], [1.4991939151049731e6, 4.999987539891298e6], [1.4997392479570867e6, 4.999997707902938e6], [1.499984780817334e6, 4.999999967681458e6]], nothing, nothing)

    Now create a Polygon from the LineRing

    julia
    polygon3 = GI.Polygon([ring3])
    GeoInterface.Wrappers.Polygon{false, false, Vector{GeoInterface.Wrappers.LinearRing{false, false, Vector{Point{2, Float64}}, Nothing, Nothing}}, Nothing, Nothing}(GeoInterface.Wrappers.LinearRing{false, false, Vector{Point{2, Float64}}, Nothing, Nothing}[GeoInterface.Wrappers.LinearRing{false, false, Vector{Point{2, Float64}}, Nothing, Nothing}(Point{2, Float64}[[1.5e6, 5.0e6], [1.4998500087497458e6, 5.000000999950001e6], [1.4994001399837343e6, 5.000007998400139e6], [1.4986507085647392e6, 5.000026987852369e6], [1.4976022389592e6, 5.000063948817746e6], [1.4962554647802354e6, 5.000124843834609e6], [1.4946113281484335e6, 5.000215611503127e6], [1.4926709788709967e6, 5.000342160541625e6], [1.4904357734399722e6, 5.000510363870095e6], [1.4879072738504685e6, 5.0007260527263e6]  …  [1.4870405593989636e6, 4.999194331880103e6], [1.4896621210021754e6, 4.999426363321033e6], [1.491990928929295e6, 4.999609061508909e6], [1.4940253560034204e6, 4.999748243174828e6], [1.4957639801366436e6, 4.999849768598615e6], [1.497205585568957e6, 4.999919535736425e6], [1.4983491639274692e6, 4.999963474314044e6], [1.4991939151049731e6, 4.999987539891298e6], [1.4997392479570867e6, 4.999997707902938e6], [1.499984780817334e6, 4.999999967681458e6]], nothing, nothing)], nothing, nothing)

    Now plot on the existing GeoAxis.

    Note

    The keyword argument source is used to specify the source CRS of that particular plot, when plotting on an existing GeoAxis.

    julia
    plot!(ga,polygon3; color=:red, source = source_crs2)
    +fig

    Create geospatial geometries with embedded coordinate reference system information

    Great, we can make geometries and plot them on a map... now let's export the data to common geospatial data formats. To do this we now need to create geometries with embedded CRS information, making it a geospatial geometry. All that's needed is to include ; crs = crs as a keyword argument when constructing the geometry.

    Let's do this for a new Polygon

    julia
    r = 3;
    +k = 7;
    +ϴ = 0:0.01:2pi;
    +x = r .* (k + 1) .* cos.(ϴ) .- r .* cos.((k + 1) .* ϴ);
    +y = r .* (k + 1) .* sin.(ϴ) .- r .* sin.((k + 1) .* ϴ);
    +ring4 = GI.LinearRing(Point.(zip(x, y)))
    GeoInterface.Wrappers.LinearRing{false, false, Vector{Point{2, Float64}}, Nothing, Nothing}(Point{2, Float64}[[21.0, 0.0], [21.00839489109211, 0.00025191811248184703], [21.033518309870985, 0.0020133807972559925], [21.075186885419612, 0.006784125578492062], [21.13309630561615, 0.016044338630866517], [21.206823267470536, 0.031245035570328428], [21.29582819010705, 0.053798628882221644], [21.39945867303846, 0.08506974233813636], [21.516953677609987, 0.12636633117296836], [21.64744840486518, 0.17893116483784577]  …  [21.69159119078359, -0.19823293781563178], [21.557153362189904, -0.14182952335952814], [21.43541888381864, -0.09707519809793252], [21.327284472232776, -0.06274967861547665], [21.233544778745394, -0.03756486776283019], [21.15488729606723, -0.020173244847778715], [21.091887951911644, -0.0091766360295773], [21.045007417743918, -0.0031353088009582475], [21.01458815628695, -0.0005773323690041465], [21.00085222666982, -8.14404531208901e-6]], nothing, nothing)

    But this time when we create the Polygon we need to specify the CRS at the time of creation, making it a geospatial polygon

    julia
    geopoly1 = GI.Polygon([ring4], crs = source_crs1)
    GeoInterface.Wrappers.Polygon{false, false, Vector{GeoInterface.Wrappers.LinearRing{false, false, Vector{Point{2, Float64}}, Nothing, Nothing}}, Nothing, GeoFormatTypes.EPSG{1}}(GeoInterface.Wrappers.LinearRing{false, false, Vector{Point{2, Float64}}, Nothing, Nothing}[GeoInterface.Wrappers.LinearRing{false, false, Vector{Point{2, Float64}}, Nothing, Nothing}(Point{2, Float64}[[21.0, 0.0], [21.00839489109211, 0.00025191811248184703], [21.033518309870985, 0.0020133807972559925], [21.075186885419612, 0.006784125578492062], [21.13309630561615, 0.016044338630866517], [21.206823267470536, 0.031245035570328428], [21.29582819010705, 0.053798628882221644], [21.39945867303846, 0.08506974233813636], [21.516953677609987, 0.12636633117296836], [21.64744840486518, 0.17893116483784577]  …  [21.69159119078359, -0.19823293781563178], [21.557153362189904, -0.14182952335952814], [21.43541888381864, -0.09707519809793252], [21.327284472232776, -0.06274967861547665], [21.233544778745394, -0.03756486776283019], [21.15488729606723, -0.020173244847778715], [21.091887951911644, -0.0091766360295773], [21.045007417743918, -0.0031353088009582475], [21.01458815628695, -0.0005773323690041465], [21.00085222666982, -8.14404531208901e-6]], nothing, nothing)], nothing, GeoFormatTypes.EPSG{1}((4326,)))

    Note

    It is good practice to only include CRS information with the highest-level geometry. Not doing so can bloat the memory footprint of the geometry. CRS information can be included at the individual Point level but is discouraged.

    And let's create second Polygon by shifting the first using CoordinateTransformations

    julia
    xoffset = 20.;
    +yoffset = -25.;
    +f = CoordinateTransformations.Translation(xoffset, yoffset);
    +geopoly2 = GO.transform(f, geopoly1);
    GeoInterface.Wrappers.Polygon{false, false, Vector{GeoInterface.Wrappers.LinearRing{false, false, Vector{StaticArraysCore.SVector{2, Float64}}, Nothing, GeoFormatTypes.EPSG{1}}}, Nothing, GeoFormatTypes.EPSG{1}}(GeoInterface.Wrappers.LinearRing{false, false, Vector{StaticArraysCore.SVector{2, Float64}}, Nothing, GeoFormatTypes.EPSG{1}}[GeoInterface.Wrappers.LinearRing{false, false, Vector{StaticArraysCore.SVector{2, Float64}}, Nothing, GeoFormatTypes.EPSG{1}}(StaticArraysCore.SVector{2, Float64}[[41.0, -25.0], [41.00839489109211, -24.999748081887518], [41.033518309870985, -24.997986619202745], [41.07518688541961, -24.99321587442151], [41.13309630561615, -24.983955661369134], [41.20682326747054, -24.96875496442967], [41.295828190107045, -24.946201371117777], [41.39945867303846, -24.914930257661865], [41.51695367760999, -24.873633668827033], [41.64744840486518, -24.821068835162155]  …  [41.69159119078359, -25.198232937815632], [41.55715336218991, -25.14182952335953], [41.43541888381864, -25.097075198097933], [41.327284472232776, -25.062749678615475], [41.2335447787454, -25.037564867762832], [41.15488729606723, -25.02017324484778], [41.091887951911644, -25.009176636029576], [41.04500741774392, -25.003135308800957], [41.01458815628695, -25.000577332369005], [41.00085222666982, -25.000008144045314]], nothing, GeoFormatTypes.EPSG{1}((4326,)))], nothing, GeoFormatTypes.EPSG{1}((4326,)))

    Creating a table with attributes and geometry

    Typically, you'll also want to include attributes with your geometries. Attributes are simply data that are attributed to each geometry. The easiest way to do this is to create a table with a :geometry column. Let's do this using DataFrames.

    julia
    using DataFrames
    +df = DataFrame(geometry=[geopoly1, geopoly2])

    Now let's add a couple of attributes to the geometries. We do this using DataFrames' ! mutation syntax that allows you to add a new column to an existing data frame.

    julia
    df[!,:id] = ["a", "b"]
    +df[!, :name] = ["polygon 1", "polygon 2"]
    +df

    Saving your geospatial data

    There are Julia packages for most commonly used geographic data formats. Below, we show how to export that data to each of these.

    We begin with GeoJSON, which is a JSON format for geospatial feature collections. It's human-readable and widely supported by most web-based and desktop geospatial libraries.

    julia
    import GeoJSON
    +fn = "shapes.json"
    +GeoJSON.write(fn, df)
    "shapes.json"

    Now, let's save as a Shapefile. Shapefiles are actually a set of files (usually 4) that hold geometry information, a CRS, and additional attribute information as a separate table. When you give Shapefile.write a file name, it will write 4 files of the same name but with different extensions.

    julia
    import Shapefile
    +fn = "shapes.shp"
    +Shapefile.write(fn, df)
    20340

    Now, let's save as a GeoParquet. GeoParquet is a geospatial extension to the Parquet format, which is a high-performance data store. It's great for storing large amounts of data in a single file.

    julia
    import GeoParquet
    +fn = "shapes.parquet"
    +GeoParquet.write(fn, df, (:geometry,))
    "shapes.parquet"

    Finally, if there's no Julia-native package that can write data to your desired format (e.g. .gpkg, .gml, etc), you can use GeoDataFrames. This package uses the GDAL library under the hood which supports writing to nearly all geospatial formats.

    julia
    import GeoDataFrames
    +fn = "shapes.gpkg"
    +GeoDataFrames.write(fn, df)
    "shapes.gpkg"

    And there we go, you can now create mapped geometries from scratch, manipulate them, plot them on a map, and save them in multiple geospatial data formats.

    + + + + \ No newline at end of file diff --git a/previews/PR237/tutorials/geodesic_paths.html b/previews/PR237/tutorials/geodesic_paths.html new file mode 100644 index 000000000..504f653e7 --- /dev/null +++ b/previews/PR237/tutorials/geodesic_paths.html @@ -0,0 +1,35 @@ + + + + + + Geodesic paths | GeometryOps.jl + + + + + + + + + + + + + + +
    Skip to content

    Geodesic paths

    Geodesic paths are paths computed on an ellipsoid, as opposed to a plane.

    julia
    import GeometryOps as GO, GeoInterface as GI
    +using CairoMakie, GeoMakie
    +
    +
    +IAH = (-95.358421, 29.749907)
    +AMS = (4.897070, 52.377956)
    +
    +
    +fig, ga, _cp = lines(GeoMakie.coastlines(); axis = (; type = GeoAxis))
    +lines!(ga, GO.segmentize(GO.GeodesicSegments(; max_distance = 100_000), GI.LineString([IAH, AMS])); color = Makie.wong_colors()[2])
    +fig

    + + + + \ No newline at end of file diff --git a/previews/PR237/tutorials/spatial_joins.html b/previews/PR237/tutorials/spatial_joins.html new file mode 100644 index 000000000..cb102b94a --- /dev/null +++ b/previews/PR237/tutorials/spatial_joins.html @@ -0,0 +1,76 @@ + + + + + + Spatial joins | GeometryOps.jl + + + + + + + + + + + + + + +
    Skip to content

    Spatial joins

    Spatial joins are table joins which are based not on equality, but on some predicate p(x,y), which takes two geometries, and returns a value of either true or false. For geometries, the DE-9IM spatial relationship model is used to determine the spatial relationship between two geometries.

    Spatial joins can be done between any geometry types (from geometrycollections to points), just as geometrical predicates can be evaluated on any geometries.

    In this tutorial, we will show how to perform a spatial join on first a toy dataset and then two Natural Earth datasets, to show how this can be used in the real world.

    In order to perform the spatial join, we use FlexiJoins.jl to perform the join, specifically using its by_pred joining method. This allows the user to specify a predicate in the following manner, for any kind of table join operation:

    julia
    using FlexiJoins
    +innerjoin((table1, table1),
    +    by_pred(:table1_column, predicate_function, :table2_column) # & add other conditions here
    +)
    +leftjoin((table1, table1),
    +    by_pred(:table1_column, predicate_function, :table2_column) # & add other conditions here
    +)
    +rightjoin((table1, table1),
    +    by_pred(:table1_column, predicate_function, :table2_column) # & add other conditions here
    +)
    +outerjoin((table1, table1),
    +    by_pred(:table1_column, predicate_function, :table2_column) # & add other conditions here
    +)

    We have enabled the use of all of GeometryOps' boolean comparisons here. These are:

    julia
    GO.contains, GO.within, GO.intersects, GO.touches, GO.crosses, GO.disjoint, GO.overlaps, GO.covers, GO.coveredby, GO.equals

    Tip

    Always place the dataframe with more complex geometries second, as that is the one which will be sorted into a tree.

    Simple example

    This example demonstrates how to perform a spatial join between two datasets: a set of polygons and a set of randomly generated points.

    The polygons are represented as a DataFrame with geometries and colors, while the points are stored in a separate DataFrame.

    The spatial join is performed using the contains predicate from GeometryOps, which checks if each point is contained within any of the polygons. The resulting joined DataFrame is then used to plot the points, colored according to the containing polygon.

    First, we generate our data. We create two triangle polygons which, together, span the rectangle (0, 0, 1, 1), and a set of points which are randomly distributed within this rectangle.

    julia
    import GeoInterface as GI, GeometryOps as GO
    +using FlexiJoins, DataFrames
    +
    +using CairoMakie, GeoInterfaceMakie
    +
    +pl = GI.Polygon([GI.LinearRing([(0, 0), (1, 0), (1, 1), (0, 0)])])
    +pu = GI.Polygon([GI.LinearRing([(0, 0), (0, 1), (1, 1), (0, 0)])])
    +poly_df = DataFrame(geometry = [pl, pu], color = [:red, :blue])
    +f, a, p = poly(poly_df.geometry; color = tuple.(poly_df.color, 0.3))

    Here, the upper polygon is blue, and the lower polygon is red. Keep this in mind!

    Now, we generate the points.

    julia
    points = tuple.(rand(1000), rand(1000))
    +points_df = DataFrame(geometry = points)
    +scatter!(points_df.geometry)
    +f

    You can see that they are evenly distributed around the box. But how do we know which points are in which polygons?

    We have to join the two dataframes based on which polygon (if any) each point lies within.

    Now, we can perform the "spatial join" using FlexiJoins. We are performing an outer join here

    julia
    @time joined_df = FlexiJoins.innerjoin(
    +    (points_df, poly_df),
    +    by_pred(:geometry, GO.within, :geometry)
    +)
    julia
    scatter!(a, joined_df.geometry; color = joined_df.color)
    +f

    Here, you can see that the colors were assigned appropriately to the scattered points!

    Real-world example

    Suppose I have a list of polygons representing administrative regions (or mining sites, or what have you), and I have a list of polygons for each country. I want to find the country each region is in.

    julia
    import GeoInterface as GI, GeometryOps as GO
    +using FlexiJoins, DataFrames, GADM # GADM gives us country and sublevel geometry
    +
    +using CairoMakie, GeoInterfaceMakie
    +
    +country_df = GADM.get.(["JPN", "USA", "IND", "DEU", "FRA"]) |> DataFrame
    +country_df.geometry = GI.GeometryCollection.(GO.tuples.(country_df.geom))
    +
    +state_doublets = [
    +    ("USA", "New York"),
    +    ("USA", "California"),
    +    ("IND", "Karnataka"),
    +    ("DEU", "Berlin"),
    +    ("FRA", "Grand Est"),
    +    ("JPN", "Tokyo"),
    +]
    +
    +state_full_df = (x -> GADM.get(x...)).(state_doublets) |> DataFrame
    +state_full_df.geom = GO.tuples.(only.(state_full_df.geom))
    +state_compact_df = state_full_df[:, [:geom, :NAME_1]]
    julia
    innerjoin((state_compact_df, country_df), by_pred(:geom, GO.within, :geometry))
    +innerjoin((state_compact_df,  view(country_df, 1:1, :)), by_pred(:geom, GO.within, :geometry))

    Warning

    This is how you would do this, but it doesn't work yet, since the GeometryOps predicates are quite slow on large polygons. If you try this, the code will continue to run for a very, very long time (it took 12 hours on my laptop, but with minimal CPU usage).

    Enabling custom predicates

    In case you want to use a custom predicate, you only need to define a method to tell FlexiJoins how to use it.

    For example, let's suppose you wanted to perform a spatial join on geometries which are some distance away from each other:

    julia
    my_predicate_function = <(5)  abs  GO.distance

    You would need to define FlexiJoins.supports_mode on your predicate:

    julia
    FlexiJoins.supports_mode(
    +    ::FlexiJoins.Mode.NestedLoopFast, 
    +    ::FlexiJoins.ByPred{typeof(my_predicate_function)}, 
    +    datas
    +) = true

    This will enable FlexiJoins to support your custom function, when it's passed to by_pred(:geometry, my_predicate_function, :geometry).

    + + + + \ No newline at end of file diff --git a/previews/PR237/vp-icons.css b/previews/PR237/vp-icons.css new file mode 100644 index 000000000..ddc5bd8ed --- /dev/null +++ b/previews/PR237/vp-icons.css @@ -0,0 +1 @@ +.vpi-social-github{--icon:url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24' width='24' height='24'%3E%3Cpath fill='black' d='M12 .297c-6.63 0-12 5.373-12 12c0 5.303 3.438 9.8 8.205 11.385c.6.113.82-.258.82-.577c0-.285-.01-1.04-.015-2.04c-3.338.724-4.042-1.61-4.042-1.61C4.422 18.07 3.633 17.7 3.633 17.7c-1.087-.744.084-.729.084-.729c1.205.084 1.838 1.236 1.838 1.236c1.07 1.835 2.809 1.305 3.495.998c.108-.776.417-1.305.76-1.605c-2.665-.3-5.466-1.332-5.466-5.93c0-1.31.465-2.38 1.235-3.22c-.135-.303-.54-1.523.105-3.176c0 0 1.005-.322 3.3 1.23c.96-.267 1.98-.399 3-.405c1.02.006 2.04.138 3 .405c2.28-1.552 3.285-1.23 3.285-1.23c.645 1.653.24 2.873.12 3.176c.765.84 1.23 1.91 1.23 3.22c0 4.61-2.805 5.625-5.475 5.92c.42.36.81 1.096.81 2.22c0 1.606-.015 2.896-.015 3.286c0 .315.21.69.825.57C20.565 22.092 24 17.592 24 12.297c0-6.627-5.373-12-12-12'/%3E%3C/svg%3E")} \ No newline at end of file
    Skip to content

    20th April, 2024

    See GeometryOps#114.

    • [ ] Exact predicates can be defined for lower-level, more atomic predicates within GeometryOps.

    • [ ] Add Shewchuck's adaptive math as a stage for exact predicates.

    • [x] @skygering to write docstrings for the predicates

    29th Feb, 2024

    To do

    • [ ] Finish clipping degeneracies

    • [ ] Fix cross & overlap functions

    • [x] Benchmarks to show why things you couldn't concieve of in R are doable in Julia

    • [x] profile functions for exponential improvements

    • [ ] A list of projects people can work on...the beauty here is that each function is kind of self-contained so it's an undergrad level project

    • [ ] Doc improvements

      • more

      • benchmarks page

    • Methods to validate and fix geometry

      • [ ] Polygons and LinearRings:

        • [ ] self-intersection

        • [ ] holes are actually within the polygon

        • [ ] Polygon exteriors must be counterclockwise, holes clockwise.

        • [ ] length of all rings > 4

        • [ ] repeated last point

      • [ ] LineStrings: NaN/Inf points

      • [x] Fix linear rings at some point to make sure the ring is closed, i.e., points[end] == points[begin]

    • Tests

      • [x] Simplify functions

      • [x] Polygonize

      • Barycentric tests for n_vertices > 4

    Done

    • Rename bools.jl to something more relevant to the actual code -> orientation.jl

    • Doc improvements:

      • organise sections
  • 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 bnBbnT9?bsxkurQtp`hU9=7Vp>-7feKyl0t0 literal 0 HcmV?d00001 diff --git a/previews/PR237/assets/xvmpyqb.D5-bot8v.png b/previews/PR237/assets/xvmpyqb.D5-bot8v.png new file mode 100644 index 0000000000000000000000000000000000000000..d68832de027d2e357fca5304ba468dca81f9638b GIT binary patch literal 41516 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 literal 0 HcmV?d00001 diff --git a/previews/PR237/assets/yinaqkl.D9AE7i2o.png b/previews/PR237/assets/yinaqkl.D9AE7i2o.png new file mode 100644 index 0000000000000000000000000000000000000000..9219565ca140677180da4e61d3585d5a21e90e1e GIT binary patch literal 198219 zcmeFZhdISxHC;sgTM_;@C8#va&k1Y_j*} zd!1gt_aE`Q-9FFv`}TVE;&jgQ`FPyNbzS%CaRM)BDDTQBm1}OzplJ+^y4K}|C*R#C-WNhlz6{``t`$3e?F!#|I)I2 znRMdZ_s`+?N2drCD+KqbTkc^w>+5-?UL{N|_Hk!&`zF0syE!U9D3CtQl47&#|6U^Ze=q;PmHEFQ z_`md^`2SxJDBA8r8T<3pEW0I5CzVr0BgN6hMJMj2L~Oi93a5%rY7>Fj)mLtAZqCmT z%&EcgrM~d#8eXK1;-&59ciG5Ue4#*i7$K31`{s@3me@jXoVMPAaPfc^fd%ZAzNh9^p*^Bzo2P8Jmv=xWiX{oQh{gm@+?1qs47h!pM zdB^hE*^dpwMKOGatWknST1WSP`t<3f?p8`lzDP;qFvsC~F8gcCOG|H?tVo%JF2U(t ze0+Qs=H~l%`IVNIo_cxVt+rK;{>uxCc!@S|q-y`*V2UnBg1G@IPCY16b{`CI_=85ZH=$0xakwqsX9 z|D@AXP%I`z$Hc@qUzLb0*Nv^_uK1PFLX^6irPnv=Da`12jo7C2ZiH$2r!X<^RG6xo z;8I@RZLgB=AIkg7g$j1<-u=Y?NPx+H5_baipwJ1HbB0$hUv8S~EOPJ=v>58KIwnG3 z$;r&@vzK4=hF!8YFQcztuzmOEZ7Sias;Y8s@d5$@J&NN$ySfx7cZHm#qoK)K+)_sa`M_wSO9 zH#wYW(){b!W4GDBO?(WTMuDwLc0w9?hn&X0Tv<2xni;$$(Bw&kxAdo|%nQ%AP~R++ zYdfM5Kvj70tu}i<;}>e4&6_v(NpF!ZDIF-^yk*Ol&6~gK#>hEhY3-~pwNDPR;7_($ zEjA98f)0*E&W<_trH?6(1b1b0h&U}7(1-;)_8m45JRI43T>7x%+OU}*H@l6ZqTG!)HmpYozA|r~JRvwYA9#3kxeKDA@b`xb6@uIlZt@ zTUAw6Q=_4xl0T5pfQ_3tU0dD0v{Mp0k=m4@pQGC7YMrC+>+37*$vN)B5UeEE^OdNR zdbxe9+B`ejnx?C!*j!k+x1jZl^IL!YbeCe?0Ne5o&4=zTF29|Z{F3gxFA zrt!Cn=Z(mabK{DNUX&rV7D)2!a@t^Ba<&27vcGswxO9{@8&eO2x zpL*jO(%VtL#2oFP_spHmgOFd;7Ngy@h2l27KN+dHwY1xeKNBv9J8Hy8)Kkv*w7)Lg zQi5HEh^P9=bLOF-)+rR1&4u|t7TZ-XpKNsAjw_$~$1_e9_6H1sv79Qn0rTv@)6vxf z!^1bH#t`={HVh_%I;AzqI;p2mokCXJyLV5i_`THQH>cXTE z{c1%;MgIvG8yg!3hiR)##Ds)|IB{z+rZC;0QRDl8?3edPe8|p5c|={d z%DH;=D(h~p!MWOv)!J!Na<7xjdG3a0@)ccYiCY;R8KG0$wRdmLj~_oOE7deKN`5Hn zq|t;;)K4e2*+?L&_U+yK=;6b>j%pOGS&w4l%+R2qphu5>kIZ2gg_UUy}GSezf+b(av=FMMeB)omigX zdj9-*TwL6iUM=738wz8vO7p( zIlq5l5Zz=Y9-|%+5yAdDOf<@!<3QLhBcY3qydOsMBP$6OKbM{v^!3e;iBlyTg^n}4 zDD)Yb=OBJ0nP-PQdh{qHB=FZQ2L~;MBO-b3EA@F=ypil@T|*lC>F%~qc0W_+ZYV3e z&5~AmWTh!w+3%FFr2GEvYnGNn?E5^#C1TT4Qk1`r+%@2T1CFAfZvFQiX=L!$qiz~+ zZ||n2rn$K}Iy$_Vp#TT|4>QqM+5E8)Zq_D~gS( zuC5MY5iIwn+$^Txlty0rC1yjwq(xFx>fUV z#b~{aTVWYmPM6yP9)YSt-2h-yXZ@+ow6nttxC$TWc!>*7vxV(ocA|xclDBG$jNB!!O3Y>gvHyqb65KfWT3ONGn#o~Vq#BRdwaW4p^KltztERD z3kwVX2M@Lz<#jl(t*u?UbO}8Pm%IXC4nZWQkB5O2$u|9pQqnB;PII%~)a8_hj;aq7 zG=+sVRr%*h0;_4M7mj}Z@`Zz)ot=ZDKT{^25EgpFUHWrTV9|(lu-CM!(H@THdVRw| z`4N7E^wa^J>e~3<#pbo_lGtGE9-1Rl2sbAuCqF+wQtkSb*{+#_j6D<-|9ECzcH0=i zy};mIiQSKvs51e)XF|G*lKnD-mwOzK`hPh>iYuUhC3xYOklB9W=i5|;Y+p|WeCa;G z%uM&TV8?HzgDdR?+L5ZsO;)HQhOfq%-cnLhdgflu!fRMrB@XOnH)a&bH4>u6rqj_S zHd%Fim`fI1a*|>(GBQGQudc4f+V!aWojRf#sg%ol=+Ge+mZGFD(Un#?&*j{wdqWj- z_0z3#JUR-TmzI{Mrlu<89_AOZ=2d!ldRkjq2^tq2CA|9Z;e&udF28Tcvc>@D&2jgc?Qs;PfBPNJ)A9 znql1Z&)^`Vi;|_KCEknWbO4=XOV5>>lMl}()>-bqCdw27Y)BoTnH5HitY+_5+HRY2hKRI+pwX2^$pY!pf zn7DXOZtl-)RiM#h$BwnMv;c52g_uiMToZ};dhLB?rly>3-nw?OmeQFs0TnM63z9?` zfCIg}+K0?K&n}snGKHM=DWM&UMbyhH$R92p`mQ;RGR(ojLDl%3a@)2anxkfJJv&WO zn>zar)nZFa_7)UN3I4ip&d&2>+)9s|=rt@kAI%+E3JM}OaqFkCS#jBv%IaH#um5&; zce4h*x8-)U4>6L9%&)RWc=QcB6e-Bb$=Q}}rnz4DZ3HQQ@TU(Fw_nC2Y&`$6^#eb@ zA1{p!4cn(v6g5&BOpkxe$q^S9cXoBHv{i7HG1Ax9*U{1O@K_GlIK}_qlc|)`&;<(% z5T2~8EZ0tV3kQb}uKs=BNSj?>5{U~Pu3clp!(p7q6cpAo3ddE?otqqg4D5xTjNLFW zh%M>`b@C`ykd>81hH!D+cw5;yNSp2CuvJk`ZglyW`sf-nBO}lA)3kJSQCDyIcMuYy zqwPZepw0}$H#(i~R@y3*OJ)2j#n3&sX|Cy0aCW-cMyPwX+r{_3)m$b7$NG#Eppd5< zojWKfo-&b_i7&cgI4(N+fHT0{5!FVg-63y;)xMA)gE*VH8D z=H`C<=;Z3k9CDV}M`(I?*if1G3x?Uj|4qzt2xa@Dcasp>MLaL$y5D;F=?uP#pg_@Ux=>Y|pG z!(hDY^0|mTiFHR?8FGlk%FzDDj~_Rs>SmghDsXduGuR>;TRp9?Yx}*cZf?!u=XH+m zmx&j|QzN?M<-Mhu`2vmN`{jAQ?sRW3)wRlzLD}Wyj3(ug5MZo#9??!qNoV{}f{i*{49YiQ={rJA^;e z8`Scf&Ta@L*16>jWSdo<&u>dR*VNyjRxp$FrTg&+S2+psnNLSS%CYUN-{Wj)`DP&q ztdq$8^VhEnq+8p|1N&`t1s=4vwYAm%yGSISQoos*nc$!x+K`u^TCWlli$&ygT?&g| zzU*$#cSM!#VTsq^amiL!QJGqvG{kn4F8@u9kB{e#wEFU353$1~mT{1WVIccXp{Ycy z;_^^pwnc60*gS9pC7YMs(#nKTnN^O9lT$#kd;hqgii%2dahn)5Bz0QE9IYzP8DNI>oV@0K8y4*0#zAhBHFb|bf?LHYJB!Him?~ThC z=$O+8Pa-eLzCQhQo$Di&I(B1DGD;2fVd+!^VgFMve_7=?l+geM15q+D707WoiAqRt z^Neo4_bEs5;rE9l+xfwYD0@KIh@#Nx_wzEMW28 z8GAnb*^i1*$aw!%LsL`Jix=w(oJW9giT)CyFJHdYHFm$@SrAHdMl zi{(6iz}US%GB7X@_^j4vK3ieMx72OQ?8c2`%Q^CG5jqOO!)d#Qa|F0I<8$%pNcn!+ z;TJDneEj$kt?c2$hc^f+iloueQDh&W%kVIb+Fe5nKJ+it=Kj?V1J5Js8XAv6Lqi`v z{7zSf9}*IL*MPru0~n9RYY=Uk`az76CJ92zgqeePn;qK({76iQ2C=5r0XIvhP`vh%Y6Cja`TrCJ~VW6*)~cejxp5(0Nfe>u96Z3 z;^ET-`{z%dJbC>1Pr3b1!`KVVySEcx58k|a6Kijru+y%AL~@-UZNb9{3w*R{dKVrZ zjymuC;O3;^JaJoP?z+3-tdY`BzIVHn{}_1q~^h3kwTs;Yr%Oq9P&^g!brX z&;DLYmrK*Jc6D_{eKk6T;B-<_658AS`}ZF|rWShS zc>VgB=gh1uEKbbtoNlNYO!aUX40!rA_ntB4&EqTu}Gc)ti1_7W?eEY=5wQPS)j7cf&cYQs3 z*LPGJ6d^u7>$$&8o$qLkZj&xmV*L}9Ls{iLX7BA&pk_W`nEoT28PFV8SQ>PvtQ{N> zJSv|GphK6Jmn$?apVgPXQ^=_z5j$3PXA3$MK*+*)2eX9DBsnBy9hFF8($d(BR;V$p zt-L>HlKC`guvuu*CD}=3&d;)mMAEH_y`-BpU%#H2Q22eO&0}gaiA0hV6BCmp&HL>z zE_m)u;7W*jNlEc1B9NSvwRA>0ySLwKUvTNB?;)h?0|ydy0u0iBBR*(k0`|=~_RhV3 ze_Yy?n#b$q*c>pnfq{XhW^KF9C>{_G?clhDttIu6ofHeU9LOI%kBp)L326=;5-5=1 z;pR3Tt3ho-augO6d|l5#t?pUpX1bu4u45n7U@6AM#g*ZzWZ!C*WtpR2H>AkPc}9$b zHbv>0w>>-B7cLo@*0CWZhehr4^fzzxUX`$Dq-3LxefTh4pR5)c8HvS0o>V;wurmx# z0>gd%`gO9KBr^+(p}s!v=YfJnw%uBu13nt;#4n>M%-i0n<$`#t`qa|-;`&b zwe7h%)|x|J>`zw&Rl-MIJY8Lh&2?8zO;7mj0BN|63#p%+ywtddAjZ^x)|e3ds&8Oo z=gytjf|5x+bf%1kDlmEOh#zAjWD$?g6y?;=Fpl_o&!|gbouyM-`we0FArJvPOH{V+ zUerXEt>e%vZUgqQu!tSljmm&)=INcdnjA0h&k@OK!!KXHU`@a@|Iy4pe@yEHxv}VCVvPji z!tAW27?b;hG6FF{(RaOgp;OjnR1cETCsV!LI!GZte=j9?EDxth-fF#`rKb@mWj|1L zFl-dt`1I-1fxf=>KK`%{LMCbm04H(|*SmMmm>t~xwBA-#R(g(RRg|pu3wch}lzsqW zdiU;cIKtxO?$hu|}78-A5jp@!HMV?udkXHwnB{NL zw{PFjd7j0_qO13-{ZQhtfqsWJ!7It@a|>q`d(e_JyE>yh)odzRxC1#%3L^6vSQG+{Cj9t~x;8KbPB1byD=KcHk z)6>(hUa_;eZ!Tp@X=uTwwYM9h%gM>{*Ql$i0$Ba5uAXZ#W`_c0dVF?%-sK;O{^8h! z(g2bL=72t;kXK{s;i2Cdkdu;PVQO0D+=o?bP0i%KwGEEx?NJApKq`+Z?hTvnEkHUtro zks+ABk?E9Nc7C@0ysGMS{AL&3jFo_bF_vg#LVWz#rT)i`c&34Y0j$z-CsG=uMMcr+B#$5eqcc3L1Q6%$?hd-@=jVri;?MXAKDKnFV*(OImAT`I6DNSx zEaSywWd6#uaq72tEjJ|iO#k4)c;m*6{(Q&5ns`~)_0^?;0rROh7gL)&7sl7x2Nj4O zbAOR9!^6W^S%f6lvg31)zi$yOz#&wOg3UI$5Z{onD4x{R@2`G&P#r5-E1*2~_pjBh zTOB3dE3|utx2OFAc1}Xv>6&;q4Lfy0*}$D*`<#cy#^k*g-$yfpDs~imx~i%M5h-(y zf=gb8(%;mCpbO{3Bi*pDVBEj|y1DuCxkXta;e+jHD2!#Y{%XnN&Y_{F8_K=j_i^9S-Wu~OOppXziVMgoCz=3Df?qda! zEC>YfwG;pgT&Op1-~LFacDRaQ#53dZUyW6L27H+x?=Ubj^2YY`CpcW-jl6Q@3R;jg zDI-2QTFQ5Q6Pa`K>4Yq_$5Qb(G}m%jg8vM%KkgL%0J%eOO^dv!)5HXjX3NMDq!s5 zJyT915P=v2Tor(bO^@fv`v)6U^zTqWpNvW=04QW2?*`}18h>@7QAd(An+UMG*ZZ0p z0&(B&-6&?@zOGJAVEjK6wccu@q&dX#N+isl*GbJmP3{}bC?EYFgRQOzZrK)FJ>Sc= zvDntNp4)cl2P4=~x=CqCQW7WBg0wV#NlDV!d|F0EXQ8XDre-Md?2xlZ@jBajH`{Z! zo1g=!_B~%mMbQsv#0)P>H2c)cbL#5*M|8dH-Zh6D^<<1y z!?P7e76*F^dF5Vx#HnJQeTAQ&PN+I#$r*WzPlcKky)pku!;(-=i9pGi;7g*{@}i(9 zo8~}I@H*8p=8`{Kh>_yBh!uu?wj2y7Q`wP?48h6i>FJ4y*T$cwK$)9nB|sohVAayp z(10c{2}QxhP}5i>L%` zCjI_hGWCs_QP6O5{&+|7>(_+NqWrWp8^FT+{CogFQ`0{nFXZ5To`p%!hY$6)R4RB> zp^Kp|IXccHt3{nLnsKhP6pNL#?F6w&3|091iM>6NHBUCarfXw;0kNl_K3{3F?x3d^ zO;mR309itdF}{2mk}8CRpOux+mb}wXxo-lh0(L{kefjdFT*daSTl@O^vC&}O=Hq^7 zVWEd)%|&8ER6g&! zrF%(B3vAa*BA1noZDL{~iWuPP`2ZqxSXfw3$R#r~GeD%!(kTiG(?IIHEffkT0rjD# zK!O?C+^uiY*Zq;!M9mPab2 zO5l?D`Jj&M{s%WPf036je(}N-yhA}xKq0Em@`an3r!#V>z*YdN@oQX1j$Bn*y+lDVxdSDmOn~6xlAD^U_VFHCNhDPn{jTzNms7(d zBFfnWb^jqAHxuJ46F-NYa*0G;U0tw_fbEBP zBY8zd9jl*-lc4~;DMa=|a&D8&S=ZQn7O{{;t>sv(nd#}@X;{so%?*Ogh0oIF&9se&uG1OX=yBMY>Li*pWywWZ;w04Y%KV0=o+fOykOH= zw3I_KM)x&ZjYRq(7Rdslxj8pK|0on$we#nVo|Rs^xo6+L;46}KOS}RCW4UbvH5C;s z&J_&&K9@2dI^>Ppwe3Qwn;!$Ss}$*6!gG_QSu%^0431g^#)Q%fNj~ZI>x?H{JEp%4 zpfI77O^=)cQ$cNjo{8CGkXw`prX*cmU4U*aEyJy)#>rZN>(U@d(1G~+i{Z|bd;k_` zM@7qK2nnP8luK5#G-O{W`xPtEh0o&RY{2TQtQ*?s^-fZ9wIos>u2j*J3RBem6(k+>$ zw^ugWj&(=Wp@Dd%>ZB%k&$nP$he)&LuGAG37DnB+#fSoh1~mW^qx4_n2OAn1$k@+w zKFzY8-IyI1q90uJ+qbh>cP2mg^!7pmRaztmSszEqE?8G20&m&cGO{_q3Gz(b8Uxo1 z>r>?;uTxUMCa@t)%*_4c#%5od(PV|wM>=Q(>&-eJqD?@^^>mE`b7X=3`-eeTTKd?} zW+elcrEMDU5R|;>NsJGb3hzpc!$2q0E0vsd+;vnK8C1qo!bYlhS&z$es)bm#R9qwLDs(bO2L~WlA)|uXpM06C-TQp?s-A8KcVTx2Nn6lqbFC9s z>*Ul4=PWiBlCfTLi*S|vH$$i@ylR8HcX65D<-uc`rFUkA<athBi_xqiiLetxT`6G(BS$5y{abz}mC9L^*VSTc& zxOeyN{6tr&fMi2`{ZqF;Gb1A-sR*C+ zbo$`q`*$e;I{=9J_>|O+t9ppPa@0VDv9?Yv(gEvL1g4jj^}Lbp3>>-r-bv00aElD8 z_i)9WaX({b*7G6#_9lw5Ub2YFR|PeCkREc$^b&-dSCVfmD@(MjN|N}vY+i{vz!J4u zUj&^n%c6A`@6`ySbR|!GuDSVZA<0*3^Tg7%m97orI7~l{)Rj_FO*WQE`xI9vTXU>2 z;v~532Du}vSkSTJHR8^lKi`3&8wjTJ&P9gw~fXx8-_pXkD-p7c{K4l zHFZR{bUBh!B~)%Yz?IlFyMyK|(57m*ww_*|>qIAg)L;Q*84yD=arlxjmEyaxcp{4Gj&n_V3@Di#->roqp%)@k2=&C-;=~l?hT~BmY3WmcD-L z^4y3TtZJ&Ns53t6GYO^BKlvnoi*|H%ZG56+Tm7qB>QTI+qM!bIe0&_;94QCM27iDe zPNJkDG=B?W?sDthleutv-bO73NM92J!i09MB@fiD5N63v?}d(qcE?a_p=Tr0VCvqh zQx%{_fjrOk>>Yz<3hcT+cYpCu*Rh5h;mbb7(ceWr&!VF(tq|t~g0(eLt)~jb{mGO47ppQz zBf1w3M%h3r!J@r>eRiA{VF0lotrv-^J5=GL5)Lv#)=H*&l(TAU==D+{vcfY@abtCcT#6W5n6Dedx-{}TePx+cx}IO_ zJ-&TF_Lf8&88V89d;n<$AYf*Fpm~smWp!=BS5ZuCKP&6{40fHjYUqt|3(&IBAS!F?dc)_0|i zK%!=5E*uX+dFXCb44y-tczSxm5d)LJ>N9vgV&M>p ziXzf(2x8!=BNpWOWXPUVC0svULrtv`v;){K(3cT|kh{pwKL#1OO3}^yVlc)E3)^!& z7{%nKdH}K$!vE=02AE5XhRvUY_{GHJ_xzkOLM?-YrG5Ew;I2XxvOUZa0lB55)eh9E zg)ZL>ge?#r0bYr>+MuqAi=X!80_B$3LY4!ZjNs8!SQ*VmVR00~e%dY1-mLpn)@@g` z*b}_57`oBi(7@sI?!r-sj=QL+jC}h66G{^xp7|-qhK1Q9>jnn~pg)o|BBbX%TMP$2 z2%40Px-3Y^0W%`t**syk~%*h{U(Wtiq8B^%|x64gDTAaI*q#3$r?u4JT?zX zPp&X%-7vjCR5i%8x#H#c9)JQPDWd3Lb-NLSDfy*7wAZCRT7laThfv}WGPkU)BREws zR5dR4Xn1{|ub?8VVR(OPe7g(@+y!8tzg#A}Ul?k?@%liCsJfaOXv38{+gET&u#yu| zle+v0;p!{wCc+D`UsYw8@2n0t8YmY6yrjgqad>5E2_N4N2Hn?}HWXP$xakK$xvHwY zz}Xrtkv;R1r5LNCkD&PYJMkn@-w0$Rk(uVEO<*1p;}>0Xab#m2s) z%~`9fUMk^;i}C!y=b;MA=hokzdYRYzNcK6x74k8uOU7yFmyqw0+QpYG&=nu_O-!&I zIPiuv!sa#k2^Cq9n|lBabiLMheFn8(X+4DWS1veN?9li1}`xJvFZ>(yPW)juM5 zqReJ4^VhGhtz=45X4^bvw_~h%F26F{py`X+8eFtWDw)qoSncDPCPLSTumXDyb;Bt< z3t0?dR1{e52^PYD0VNjmo{<9o@l+d$wpiPeD+UIsT5rdT7mTM2ov5JHV0cGQ7lICp z#!F~;N*clQt^6jIM;~!@%&1Cj>-0W-Jm^KXS4WU&eaE3_?L>6VG`B* z?qFTC@Oa^=t&PnS$yYn}?j>&xN@z{Z-rc)r$9HU^cua;LoiHr@2lf$+{SOYn(f}@k zypxyjh;k(vMjPJHxpawR`Ee)HW%Ik`W{4(f@8yrpSptU-zj*V;65&E>uZPFzcVlCm zwBu_?S9oY#Ha2PR-`jyoGD{MQvOXa`*H#wDEe<{{41|=Flx$0u%;9fY97ZAB$0~PJ zMGO8`;M%KKyRU`H=bBeP+m>O6-UQ78VH(bfk^f(^>qS#DAtq)g{K-qfU%H#YAmAw? z*py+h$PnUIFq$gNsU3pIm8 z;5`@_2RmpsQz-l(Z)4?{RYDjb>DNbkd~2fhkn#Ts?~z6H?~F5r;NRotH>?>o4aCIX zIM1%zgJWk(!&1GP&>;n{Md%^yuW7LME@Q28enMVXA$+nPGZl+bha1`XI22oy6a*wN zJ0RW53zj*pFw+WobyGR|cED=~T+sI;LLye+_;EWd0+PIRZOnFKz;^wc>2b&eK2yOa ztMySOPvYVXAy8hr7K3}{! zIKuk)vzw!LwosySLmylptzEC;@b#OJavZ1v^nsD!!5-%EqL~`{)_u3on65zCMNfzI zI#TtrmX;PO@fU+bFmDSExWZvxTDqY{`E^EvCn_>hz`=sX1n8y%ND=MN^~O#rs!9OJ z>T2=~Xnu$g1RtIeNk&%IHtX*min3iw7$)g)GX(cf_oLOD5U`k3M=-I4LUx8DEYkRl zgtRmqNf4I>YT2Qr^!*2j;4dt^HWL7hO2?zoNFrfo2GE_|f*oLiEAqn8{{%~0+X=u) zHn%@_P#yA1*P(%s3q7(G{v}lPIUsW+1qLZkkKBQL;?WCh(!j-I*4{=D;q9$NIkF=kb7OO-C9Tlve zP%e!~-$CYLQ9wOCS5{UaxMQgMl?42X`;ToIrzJg!igNAw8fY!pswYuNN1j@AfA$kX zgg_~F^qoa#tBDQ7WahH2E`Tx`x)Eg6_wOegkbPix3@y245SJ{arY?Y^H*eAeQ*o(a_InOd77s5x9XCi#^yH}Ii@wF#M-nT*btLD~RTFh1h*=oQxmF@l&Y>oIEyJdH7f zu5Oe8k`Mzt<{m^j#RAmnUpH6-^cbJ4Mms8(RR zeQXM&9I@_#27e&n&mpOMKtI#pOgcONZF~#JlPopl4`mf32PUYEa%_*5VW}&ubY$C@ zdA2kU&mewRy3KgbaBhB{>=HFo`wQ{|n&jcKyxREo5)?}Sj-<9FND9~<-;JhBA7>TY z+Rn~Sa>$Wf{Z54?B$R^Y!xxn-+v5PDk9`g!>eA2b8X;wx3~!qV=ftqSv(q?B^l?#! zM!F851jvQO_3IaAkbzq8Jly8OtPoB(vI*Fvgx@8H_D~g6VC0AGo#dAKNWVes0VA^w zZ{$xz8K!p7m<>2Ih0&HDvAB=rkkIto8XB%;w+t9#xxM=NOqNnhm-)JGZbig$=@(Q| z9TQ`!Ca)Na)N$KeH{lIKlb6P@O;?wZg+&fd8lZHzcP75MY^iT(05b#~d3d%L8=OJB z_>GK4OxCBPfJkQ}uJ|Aj03jf>pbKG~0zT24@0dcQwP{0j(_b^kGk;n>`TpH2=!b?VmMuswy4s;uNM^wMq{QdhmC8hH6 zU`8dj8IUl1=s!=Kg1snwN}V1f>02oG!b4)#`4}@k^kQ&5vcm-02#I}VUPE1-1qLag z3qUAxx1WwG_4>jAFDtOi?!9||4?6)z!^f48w$TC=EHcyUMrW793Z?hjh)EZ860*k; zQc}c^SybCVBQ5z;$y$JGw^}~jfSf_*9dkPMU?!hGpURh{d3qAGmn@!DR!Z75zyE&r zXr)ce7T1_hrf*VHp-&sK;iniG~up~HyhBnU|fZh8jT3}=RbCfxGu&XkWty49}mc=pmez@ zQzKr6>+f|GUlZT8x$?%FGAxgfQ|RBxTEO3)^FcUlanXuDU8Rk={-?R#?j5xCS;R&c8jGL1PlpDN!S?B zNOv%j)i)Sj_pdD*wdJ8YBLc4eXTOV;xTUYo7rTuGpb==<>86PUG&@bXsjtM6xpa5e z!;{-^Oe89##ip~=mt4_da)Ov&EFZ^J*U_;C40nb9DQXFL<@dq1v3dMu0EBy=j$`^l zA}!$eO}~E|k9oie{T}&xw0yt?UpUS>2oXT?9WHIR z92C~ew(KhcnhgFSj`pxRlo$$#Yjvj*-cC8Po+dxv+$8wNP70N@-E71Y>G;y06&jSW z6zvE7bShmL>;eWaK|#9`>++Bh;GwlOg@#3LQvkfeOd(Kt!Bs%&arz7%WB_V0CK|8% z4<7uyhvE|ryb%`%@Qvhgax2}0*WnYRqaRMq>$P`GlWm0PLegltX!wKUH@zw?t*uwa zY<+PW*-6F-y4BlDDQ6l56;%We%gA_Ob78)6!;m8C>KjQLjP$Ws*L;0Twchgc@wK5K zwZCxb*%k3a49*4#iPxkNOs0++6O54~(22B*{s`{N(T_*dbsqUmc7$POSU4aOg&@P~ zz9=c_#L4KbThmNR$)Z&7!_g?Tz(~Dxu2S^?-4N(r7|xDZC5Xt$c|p&`noN<;Z-MpX zp$Qngj(Q|!k`NAxP4lsCn^7Cl|-obKBRPG*+pw5GLV|_?j5kfe!{S06r(Lb9LAVAY+I$~q3Ys1+< z%}E^V3<3>1K6$i*!hN8@YY-Tj13@+CK zF1>iMyI`sjxs7orAuA*WPF7T8sBh&w>R=9d6UeA3NlERh3CFoq9Ax65hXU2osZD^H zpfkd*@ikNFa@x7m?C|~TkU0)JAlJfw6yFh^X}*Vm~9J;cS2m`-%uYU6Yzw z@;A1+giB=^BPyKrlTX%)dHQr76^TX4&Qy3Vn;J~Z>;3&1?73R_?0De>On?%KiW}IJ zhs27WtH4~HFak`@x7k+4{xS|hYQk@XvlPJWIjGr@Z54^d#cS1)T`X`Z*md89RjO_5 ziy%WwL`N_jWh-PT{_Iedtc(oIHG+Tl0eqtD0aFys>2w1ehAOVRSy&9R3kkjB>f50p zB$SCWHRI(7A!X%?rI|q?pkU+k=%X;+!dg)3Fp)rZyh1$%kV03?vM=~&buuh;xkVt1 zr)T-`Q<%Dw!5IT=Nn`Lq|0fcFFE#yzn2Q1ixE0x1(jL-emHzIXjN`z=9WTlsya8J( zj+8hX0aV1H{0Ol6TsY45Ib!yP@hg0xot^9CQ7D?KwXJPwmNllhq+utpWWt2l-Fx>Y zP=HXBW}oc|*jTJkR9KsBa7bl8!p`0UF=qfHrzTh`fydx2O^|a3BhfOxS@-ML;lFb= zands=>xR0@chT^J%RemU4wE%GvWi=7vhm@jjg41th$N><0ayvRz`ydx>VCh>oBTxt zj8{C0s@BK4)}ca?=sAf=82k(-_@eZ!_nWNur%$Dg*hzI_gb3{@_th)2ZneKo1pr3l zs8YyVqB=5{QAh#eC5#fCtl#(GY_o#fq$zwj;zBUhFT?DIM^y{QX$ZTDL#`NM39eBL zVzR!ZxiPCr4qjUu)!sXltj)jxXA^Pq!DD@C5PXaU<_(BR7%T&kH(7yq?b&`W&mrV& zHhj$ho(b_jCBkO&#gJh0^RHAr-UeUQzyP!(98huhbi%=P@>$OJ)Y&cIwfJU=WK=Na zt-p{$2zCsBbl%;h1!KhtEes+93}M-VeE~(2kQMIo$tq{vceKM*@6zDP@yUp-pLcmq zaCzDuxqbUX)Nj8(FZMRR`t6f`D?MGR)mY!4-0D!Cy|(tzAd#(M#s0fDwVdAZ!S%b( zhLrBiKt;f&%{v#p)+gC{2IU4d?mt|StM!Jd4KyupJq-bPZIeH$5#}UPG@)k`-QC>W zz>M)vH@9DwVi4uJq1g-%kByag+fDKxAAl_gXE6|n>gwu4^xZM%&Yi-R4~xAD7w|1fm`jOD-s*|g1RSC2<`6uMqJ9=#-6J_^g_lc!Jd zJsx1~Ad>)%*i8|knk{AR9UUkSs2ce*<&aJH+&zpP*jpjIfg*{jf>wwECw-{W5PVwB zYw>Ysbl6TP!&pomW7d4Ouya)y46(8CMEn52X;+Mh-^sy|sLAm3>MR`Bc-+l*Zl5>| zBOLi%A_E^(e#QC7&l{g_OzCm*@)np^Gv%cjqU>VM0^J3dtE;3pY6L54ld-We1~@z zxMEb3F$?it)KpfcTr-etzkV6F0-^KVxquBty9mui|0`buzjRN!6=Bwb3kIHIkKK`~ z-gAF1!>x4f%63d+`5CNl-UQOqOss<(16`~RQ}y5(9~ifz-@YA&hL-<6gYV9X@3pl& z)H_h=AT&*W13#_^WrO$2PC{aw=h(3&3|1U(?d6h|K6v*q)=7g>WCAb55U0-aFMVtCl~w7(taG>ulnzl zw~uNUujnZ5Fu=Kec0XQ9eyfx~i&nXEc{QR`6NX zgK_~!NmElYoK(ZZ($d2IU%JP;N;gJZve6v?PVU^<#C_xP86_nyoD+xbfs^wO?-;aa z*z|CLm%ws6c~4weIP2rbz8cQMVdrqlQwRP^pa=*g2UBj6nwqk-XgBGV`mDhQBz>s7 zQ6Yk9{5@h6HXg79?6{rG)BIOjZvlkjGN|6f$9DkE3F9OH2S+v}z8|*)7!q+G!2BA@ z!k!Qi$N<@Eani6L5r7AM{C88+Now3(|M2imU7KDh+CUf)&asCzyPZsZ`}P=YjLFG< zXA|*lFGx;GN`J0P41qL$r?4wMr>goaCdR(+9yM0KtopxQxP5rXt2)bn zRpADZsomczdV0;+jP~|8s+6e@#CLv*i;?0MM37O?>^ zQXHY)!Ot+#({qYD0@SMeayRwXsmaMQ`d6@yVJq^ogLaHqis@@>Ys1QL|Nd8CNYJ8# z6NuKnaKn8>fU3IsdidCBLEvd<;OFl0SxLw7D}>Bvi%2`6W5?XrSM%@QJ$3Hfj+ARL zbaJevAl5h$a%=)7f3n7Lo|D$Lv#6z^Au%~Q2X?mcqUVyA5X_LBLmobiBh?$vTnEo; zFghIb7SaRG@_epL$0_LIqM|>p^;~bWvqdE(qo%Gk1<~{Er>B=bL@GMK#6&)(!pnQt zp!~&!qgY?a3FJ+h;@OSWucA2z;NWhd`#ZLtg2@0K58`N6%HfoT z*4Af{k&uy<6N1FuJ7!>25*6&3eyi9o-M5PUN7n_(L1rxxIlox#GYRwf8znH zsn*u`j;XoXSt#OYct{&`mDRPid{N(@#;8z`q42Ff=#H|3KVpB2aX_=qGRKzCft;T zg)5uCNtN13wUb8$Mg?Mt>rE{FXA_aojT_exFW0YsU8HU8=%`+{*uKk83nQdw&r~^S z(G#=u(ts4}Q=K&^g;@9n1s{ym2#opNo3x39jENicV7!8UfRQ_w*A4PFXqayMZ!JsU z(}Ts%+St^9k zJjqE5MI07p_5=+Mny;KN`rXq3XXikPDpKy!vxE)qjd zVf)^*-$q4QL;d-h0fI0z(6}=D0x62C~qhjq#?N%<)}*tp(0} z?E{3nKtV_O_=LPngZ=K@IeGKuu_)c@aAQnJm`tB(a~vFvL7^LRc#MEvkYhm zi9*^a1GAputgJ8}oaN&Z5eYx_5?`Se6B{d}9i4suOE-cFN?T`%w;FrcAF2c-o}KNj z{kxj#>NXKuzINNGCEgS@oNE8|3kxEC?AT3spcU5_If_5a#;9kcr+aU#%QJ-lW|1!h zFYuPGC{EdV;dM|B5AO(n{CIM1F20>EuejJ7vqB9G!n9I@A0rzZPNLK|Hy`Eax4}kX zKj2SXcD{>Bi?0R&$;;dK7(RjE;7Zz(aal|wKwJASlPyOgen6B&(Ayoc1u_5wB|G;!7Ty*Y%ZrQCk24=Tdi1}qeUX1T`t8+e?g-2P zY}@m~9zQ-|dsXI=rC2MzHU=WAVl1leI8Bf#8URUV#l4 zNk%^CH!y(WXm&gr17lxM1G{w2&37ipI|>2lK?ZR_uAHBnd;9Jk6t>gU7}ytJbopaR z1jAJ*N05T06)kLj)z#UL{1y<2De{=Jx^$`G*uwD0NbiH)dl^yg>g($A?Ry`@#2iey zwsgN%pt}>UE0T#Xswaz#ljYRBDJN|pv;er&BPLq$d02ph#3Jt%tT2PIvv5BjPt;-R z9Z+zvAaQ%|&mij`vC1>i(>t#%J8!;o+?^6KkH>UJYb)7NfpUz6-?8;GHnFKGa>_MU zo!cLmpWnr!`>$NNg2cc-Jrd|?1Mi=DsgtJHjW1ZDC}kx#GVf)vUIySeDym?V1AO(2 zn}^4Ta4*yoK7iVzM{f%izyno~m&e~J&X=%N(+x!%)$ER9*7u)3Tbr99nhAA_<6B!O z%AWjdTYoTe6wyLY(9^@$-XOEL-xL1#%^Sv>FBQcMjgP~U1E(W88}=SoXQ$89YgvnJKiIjhKe~ z!EV(yna|aJWJl1$hX8o9@VWxVIPqtne0c%K!=;QiEr96K^XaHJF9MUI{Q&5|Z9^#G zgeAXZeR-sGV?DOvj@>pInlQ++I`bHrBAgO%l1D{lXN)>5XYZ)8gPSMS>py7SPiFqv^~8 zYHYhMo`g^&RE7p=Focw$l&DCE%t|2|4N-P_S$Q&3t3(3sbd^m)H#96dWZOCQ>8LAlH>WCuC4^y#Di{LJaog+)b-7XyDNI{1xMhD*%MHqvTzG!s9lTP&R zzISKqSBy_4SGfe5s?dwBMS8QikLdMA8lbOlZV00Z9%1JFqk#j|4LE)3);t515hLpO zsU@Sn-{0E<0OqLiUel6hDXs_tTw$}A-wvV~vU8_y5A9nmCUI;KguklI(;R6gu_E09 z4(mmi)**Np^F&%TYE9N%2;3=CR^S$b9`^JR`&^C%x&x-Abl=@YK1O&ASsuD@#Bsm? zz-HZs4Vz!w@E`N2n6rb)(82pQPupWIU3z$8^nSDpl{C`D?#(YAK&VHmxZlW7Ns5R` zOacp#=U|n=6(9~d36QJW#EIWSjE4oA62QjYYhC;0)m`gXZz88F4Umyx6{W?+#6+V7 zYV=Lgjj&aG2J(1%x_)c6w6wqVt&Pvwl#o|C@`HKanqNAPzs*RtJBJzhy32oC`0E!g zeAo3XM_ht7=zxbCD42APi^a^9r@YZzP#_W7H?Lc_rfr0ztzF^{1C zNporc2arMoWMzpQ1rHw*+7^sB&c87m^p&qc|GOp!GoP0%7UO2be_?oW@#2`+bCg+3 z)&jF%rSDw4Y}urjj;FqUb)izHIJm!bTg3F3Qa%&QOAIE2Euxxy@?_DnWhkQfXb^m# zzkC6taTFHIn61`i?_>EQBPAu?vuDJ&!QEr%X$u;w-u>k!*S>ovC`1TXI`R(#y$|^h_H655l>!ak19?&JPpc;_>^5zCv{~0GePG?%%XofTF;niF; zx%ug}S_X8X_d`ycIB=!Plr{{oj_DfyF?)7?L4o(Tsp1^16U2nDupU18dt*ft+#B9Z zTvHyv9s~apj~tgj6pW;sd#Ruy5;<{^WKOOl0cR}^ulX+?_*GTj5d69N%N78HigeFN zBL;;o&um+H?cTk1W&@c+iG=$2vq*#ZygC7j-4t&&y||=g8Z6+dRj-EDioHLA0t2W3jEtdX_n5^% z>lb!HMAXUgz0Er;nWv7t=y&Rqkrb{A;laUO#!cVnIFqHc)s*{@Tj)$N1ZJ%t_<6is zAfY=nbYR;$;n|*$J_N5vQC)0pNEW8i)z$Of?mEw8EGgSou^3v0pM@j_t7cWM zoA81nt>f2+C=L%tN;#OVI7c}cqS4FK(|YAfyfTR&J=}HWGcAcxB+7<)wa4<`Qbe<^ zsn(Xb8rq$f9jB%?NnbxOua_x5e3wg^lR(s(2(b*g`O zvb!&I`FCuOu=yC$N^uasyDN|;wbh}_E!w^IAA?Sai15#=9VQOkg&na>U%e6ri|!d? z=14&;p09=i?HpBjn3d&g60`E|E^G}>-5o~wKnf4)0=MtlGF673AqQyZ16Pj|)EIuy z(#5Q}ga1wB$FF$BioyDyB=;MwNvxbadj*W(T$YpFv{85+ZNv(Hd8EN?D{0Y?-mw&X0*H(XQ!Z_?RUp zY#^ODd;NMzy@ka@O-&nWBb7fI!-fTigk;+d)(V|-*Qdi9l?f#)+|q}X$lUyV*qt-^ zeSjSn8YjG)c^3q6xwTDnBD~OfBQK?08lJA&)ZEP5Gd@e<`ZB|(qd7f2Zz+kGKFXwM z`O$g0%`5+>1+XGOFdK^Dt$E{QgAHsa51|?4hxu@T~iv+HI3^uMqhA{i-y+u@Q zzft1t+fiE_PBTOdB>MTe5`uIawH%!=cx6K=B${rtNUvwK?<(lRU+1im|BA1reojXF zhuhDc%&Q-Tl40>;m`!E|itPFfx0YQ?A|7U2y9JC&xhB+Y+mw=^zIu^ zl))Jp(>%Kj@jZ)J!9O5C+b!Qg6vp?_qrL5g)>#Dw>uER>c20ilT0?kYqIxJVd3p6E z-g&i6@agC)PAv!yGK%*6+q#fh%b1v2I#r0o7zB5;&6JZc0fGeN04uXGemp#U>s4fC zJWVoS*5V#;QHU7$7GZy_2XWX``*t2Sneh-VmX;B4OVBQ$V_2BHJoV9|iA}|xSEtAh zR#f~@TYIWhR$^$Mu;a(YWc!C5JGN!(*0S>Q$m^{#RsY;ncxbVO$M`NV@N{#K3R1(- zR>dt8&k881F>m$KPMla~V$waJNCH+8)ioJyyOxpHOCxU}Z|DNgRm;ExubuR%w zY1<#hc<3>s28LX+b8?cCmHi2HdI~`$D1hhA1^vxK;6W7`6l9JWpTB?4=B{*f5c@G#i9&Ao?o3K!qP%Y9 z{VfJdmM@2<%DmZ1EitA&21k+5(ElncA7y9PzJ0qdXKlUgC`9tej)h(d@U^^rQtHi- zL+-E9y!GObVBmt;3(N64u$2soeitHs-p@TMsQ)AK|_n9jm$es7uO5~hOino&%24P{K4^bh`BQ}Agi5K8;^-FMPa zv$M{asWGf{&*SG2Gqvm1snV+qw(#6&)L}5jlbqi}XNZb4{LE#JJ2r?=omqD&LQ$er zfNGAnEu`JgnSi1O8fXXH{w_$eVxzp*+M7eT3xfe|zrWjQ{X*01SbRF#=Z2KDv=&Uu zZr|TXb>GY(#q6M zYbOzpObUnkU~M9}7=0GSH@oU|AAuVQAO8;~*;QL=k}Oz2I2kcfL%%u8t_&H`~@kvR?W+1yJXqWv)mMd1!JsbC5oH?+R^Gz|wIe}-C5+f~8im=Ig?Z>Vw+3oWRm=bmp=$73L z{RL~%t@jsv+CV;AEx-Q-2qF4FvN->C*IxTEnE<`CjNw}_8w4+IZhoCl$^MC7qHAHw zz6SCnGx{DhdODzh{7p;&?8KXU4pCGjbh_B@Mj_5SE?KrLY3ihF-=MPLs_4(`!p(^e zcK^mPqedkqBvhN)Y)yP1-N;)|hYSzN=MhVZ5voH>&ja6x7{BdY2K2fKCqu^*T*d4+ zDFF4Z>x7S~%2MJ`WVD$>zHp2nI~bk(+SIhhbERrXK9ZNZhK7BWA;m3$XvcYQ_Fg{J zq!1fDd-fFFL20 z_D#SBFX5&NkxmLF0LFfV^_1@O7m+s!(Nzy09@KMm!$c4^OqMXtOI9{n=fA;?{>zsx z?e=;=zkU#UEuf0(eSd(yaKkme(SrvM#{MDThD>t$M^{o_}Se)7fYSc{o|1}Q#qI|!}Cq{ zcaMfYCp6xncafF`dzfHf$p7=}t9Wj~CF;t=ivFzyp`&>YyQAz_=FXCGF8wFYteU!d zvg)X@=VN1c;C;iF6Za)uu^IS~#KGtV1Q$*Ohs-MQzdd1#vZjt6{U|TbFF)s2K7A~{ zQ2Wn}j$eQNZ2hp^UMAQSI33US<;DJoMkR&?2ls1zPvH)ou+$QG>L))WZ`fgqUbC2~Bn2nQynXPXHpeajy$R_dmb4D+E*r^&F+zK@51i6osI8IWlc@Zqo+<;Em|bHTrfn&2wuCbeCl;{ z;?SDH>(r^&cRd(EfBN`w=80g!13gvn0dwK(DKuv^!GXkZn&d$p+Q`A=tdeh% z6>1=m-Srjr-ls+>3)rzZZprVQz|zu%JQ!ZkyY43X@w6i7d%-y)+@sC2sjoc&AcpWl z1W5E251rG7c*r779bZY$KR=vXk3x;YWN^eby_`aW48G&8ciWw7*EY3}RZnIHC*LTHDKJR( zr?>O?L_6t5%6hC@Bet&_-mTkyq1U0LwEI+ST#|g1F0lS9BB-_2E!n+Bh3>*r7ea0S z_b*-?9U=^o_G^(aLV-h*L%*&fJNge8z+|uRUFtGERK?LjA?RPbcI1B@SVT!9)2fBM zYu&9Abfv5yTXR6|?NvkP?0@8xIZsVjURKOd3OM-ip*shY5{%~{Yp|Q{B-c48zC76;eN{&$gN(%M!p%%>Smav>qMY*0X*M7Sn$ljvYhVVZC^ z>fnR@%Q;A?p1*qynjJ4^M(or$VxJ>S3&2681_IgzO)`O%tdjigkLUZs2q9OGb+q2b zE+=MF75@Eu(BJ?5H0<{v3UCe}$Z5zts@HVfT&h~duEk)7lLdOF{{_4k3`|W06yPxV zjLd!`=a+XTLe6S$R56VyrSbpz@#C`>E({znU_wB@$Z0-8O;@gd8N!YpPv(V7Y*$&2 z@rokh(xQ7RFba&&c6|ROW;^YE&{eH{wIx%v6nT^#69!BA&&XQ0gB0b~O}PFnLB6vS z=^~g@(OUfWZOf?8Lq^d!DYDY3Yv#;l#0fH;6cu&)G;_yU^)BswRixK#+VqOJ{^G@) z>r2-VdkahFcvZ2rz(G0Gedw{}_+0?4Cvb`oT%;Ir%j$GH2ZS_wOd4Y1i zy6bx=zA&ScMy&&q*4$KBQqq^pQjQ#XUt5b(`T>Pk&8J@Q&ux4OgO>~Fo)i^1^O=b5 zrYgrGotgIP+pE_(^~P8xaqv22%s_E9{Au9bxa0JdaGWKOqx zA7!MalMoVVW_xu(4|31FNg3IYwsy#>!)I1Lb`o?*8Gjn}bUdiH7vQ|r&`@~h!haPT z+}(v#!S5it!CJ%MYI{9p@53F&UmsI}G9NN{nE3k5o0l(Ibkg;KNP;N@%}@{^xTU!? zvZXX;7JNDRkm7wYNsT|3ETOJlxM-1YM~;mqAxlgY2UL-uJoq7Y*jVP7w`h`a05;_J z0lm8U&%mSRx<#Vsy-~t7MJ_`+AzbwoP9dR=kr{qwzY+UQS4ZdIp+j4yjJ=ea`U^=b zB=E`YBSre4qyOg|hAx8;V0%~01z`1F0wkUuOzyM zY2HtAt#}0Z;_ljmkh|M)H`QX8GI&6k(XvDLUw2rP{&)EFh0KFT! zYWI^Fq~E~6!sD;6P;g>!qCa)2W4oOuGdQgTmFMz$T3X*|m((`3LR}|WnA9`jN$}`D ziLM}6i|PO0t*wZ@+tKqT2RQZ%K5+u-_Z3X_U9qxrxotgn=qvctJ&uNKDgODh6A8A{zr4T3Jp5@D9JEr@Lj68RB1FOF?H;FQujpT=V7r)JSh1TTPThHtqb9fF6b76L=R(K0f?`f`YW>C2uj~YwW zfY$79GqLjz?i8BS(5bxe@2}3$p>4;(V+)0xq2Z6bTI*%(V1moOePZRZ2ho(A2n|h4 z(H>3p?FO)WE|1Q1>B^PlMZDV|z8N;4mnyjnE}LgY@j?j$7X*-XnevU9V*Kt-uG9?3 zIu`N7pi7u~l`slEV8D#cJMVtglq)4+ zfdG15RP+5uEuiM60;+aNA$*fhV+qf`TA`D;%N$s}#KYU0D>-}@e2~pvfp0#+CxLQgca^;P3Xg(~#B-6CM#uQNzG))L3HOeEI7M)dhdO$R!{+ zcl}i)Yqo)bL1cb0{}fzZ;3eoi==Z&is+!*tRoF)5!nH$)b*USu%t^Q-uS<0m(NrZD zf%xe#f?HcfEr@hvAPgnnS6I)Yq(BV3aA7cP4A|b(^dU2ba6+L^giF{mJ-hZ4E>Z1+ zl3JMIE-cibHcCu{W?7ZG@`f>-2$@ZxE;%wPTg!j93#fRKpsC<9Mg_fA0=N_Hpc z@W82y@rf{swn?m@BglN3`DCsAMmv8rM8E+YIWnIhjBx);RVrlB4S)`s!PdDpl-VvW zUr{Gt9755>y*&_2SE+L8U2NO7#L6m-9a-QI4e-ZxV|4RqNn|UOiCf&<9NKRH85y?2 z5g;WaBkEUV)cI@InA~n8qrZ8h^+`*X1!iL^P((C0quGnHHJvc{Gf83^{u~Y03S6{% z_Vi~)g!#vA0XbvM{OpcY7w^O1XBHnR@bYn&Lr@qHI)b_P=FKHjC%&exLIn&r)x1bk zN{pTx3P;Hz$2t9?d*V0l`<)`k# zQ@Y>1=O9b^%|nMu94ZtM`NR)GQWGzhU9*OtQN%Lg%a@XC8zn^d96fPjlBOm+>TRq; z-P~|0*f6* z>gZ1&KaveV&**H`q7Is>;9`j~)k`ayQm_ClSz_m>f= z4;}37=@)3ve=v6B$cV?&ooaG%&;o1|+WQTb+HfJ&Ss)}-M z%-i4dC&c{cs?_AzSiiD8g@G(2=j`IVQ)=nwHD{r&tys`+(@WQP1))U1!H07z-mKN4 z^Mgc+adBLw+2~O|?Lh1lj#@=UD}Gjx4)IaTIi8OmZD6T+;(>R~2&-+MZwscBC-M_5 zG=AhM`cNS3TYcnW!$4fr)cH%gdU|wAO7bo%0a9q3lO%Cxk;8@Af!BAhStNPSlq7qp=+^5*aV0IX(lnr6qcoWh-PH@-PS2_mdqnmgb<+ec&NL zlG#>qiKZ~jCD7@{93-Fb|1BpNM0}IZQU^Co>-b9{%9VfqFbhn(N>gcln&IN?Jf=$4 z6^a#UX0qHctUCqet*L4F_Ed{a!$*zkbvtOUM-9Br_~QRoeoGluV?gBzxZ#us@M!#D z1epBe(OAS8KCP%oAz;v|1XPUauHB~k_iK&uj2RCAb#+t6@J$KKbxUv2Z88}*0H=6N zB7omi%W^$nm$=^vsTC^}QTn`|MkUBmaEGm}?RtGG*L(_M2!owxu zig8j;KNcFwxBBndv)e?XK4cW#@(nTt{sE(15EtCI(DSjP^zIRW7 zaPn8LPo@c2fVIjmD!Q;>g!b>(QAck@7Ut&CjR!vg41j$yepGx>)=KW|x&gi3kpT#R zWK;;gWOp#uG2pa={xce{Y$pTDep!zmT_Miqw4##eD?jCJr?DtBr(|v#gsG#gt#-h} zVd7d7Co+kAs=lM&VUyuf;$R_mm!NQ{Ph?}yxuBrC#m;T~)}ezBp;b)#` zG8P1XEk=c&JbwHJ!*ltvH4rD+Sy|UW-b_PMlq9WkiX7AJIK?}oxL;nT&D#9Ab+*9Z zDI%+rZgwjNu|6gwF(xLo;YmZ5o&yA3z&yv6U4B=Ib9O9Q2h?9V=o9Aq2x6d_7_nID^dBKL3 zx{%8u<|A$M7aIJWXQ<6nIg{U#amn|oVud5Y25f&X^kcQzSjtKC?#+2WRo|S@;$oad zqTWWVn0s@9fwccNS66C$n|76<2A=NU5|Ly?eZ6BydwScqxA_;IK3opp(q3ngE{YrN zEM^ms#?n1m$*69K;s+KM<>YmECl0XV!mek6sjS)i zf47qB@ItcqQu+)rR=yWlbkfF(%!)BbgMz-W@PQW&4-;1oHr4Rc-w(t9i;;W9effRd zoLA`CLAb?FOH8!p-Mfip6NDiR+?+U(@iFhj>4OM88jAP+C+_wa-$%nqMLPBPvCsh7 z&^a%;E&v8jSN@@A^dcgo@IuUo4^QmRm`EF=B3#_YBfgk07@PYP8XCWa(GhAGQmTWU z-QyF>BufCQ%E98R(QiVw0`Be>R@s9QW~~F!YmccAYX-kU#wE z$i7ElWkYo0p-_jw*!lQOYi@(zlTo@XNC+}5cmHC7CG_ag%sJQ70Tcvyel^VV^D_Zv zYJ_&PozEa`cr>dtC$u_~ zVfZ+AeFGE^=wEN$I+3V7sz3B4O`B$U3u!t2%#H zq6@~uxWMB>FyYrVLLbG;WKPn(UoaNbR`c)avzKlx>E9^8hRIX`x&t8=<2iHV|NVY&K8|hqH%2GLG{> zAxaK$VhR5|^oWR3$B2I7V(ydf!gH8?*oNgsd)v>~AYChsoY8QxCDS@QnPsmpc)uX- z>F?jW#C?fyGLt6QoZ}-1o9nvC%@#E7m(QNfL~Wkswr*X$;AidG>H@#WE}Nn3ior8q zj!)F`@dt5(l+;_{n`p#Qm%ifS*nx@0`gReqF(FOSwP3$fHA`{X@X$+l4+)i+3F;F*B=CmbysuI8bSZq2BpgrL5Cg)uXPq%sq1-l-Vq~$G z`YrBnz$wyVWJ(v2DsxPXY4n1USj2{p@3>=Iu-FEYCfMKTN%&&$TfAcdQVXXuKbzG&B+eIu--PFJIn;KxvouZAcJcVF=5# zI~i*xYCh&kWEB+Vt4Q|~-$zF8q^{cOC#$K z`p;O)nZmV-gAf_1@TmvtP!ozwRY5yNi#zL4KLN3*)jv}eCuwrHg{6joLa@m?I6@K1BIZ)}@9$^ySQAnlwQOC6T*dH4k9rQiW(^yzo zkeW4=&F9Q{^Zt7^j~(&}K5ksFsa>048=r{NNn=LaYZ4_P+m74hW{g`#uK}E`ThjpR zK<*7=E{yI0EpDb_30H89Tm$fSt`2)xTXOGbPBkx?*7IRwSFZT_TGs7YSXc%ozi(v^ z(?X}2+JU$py7b~tkLgNMY=HLV z$7XX4r6dI{PA>9@CWZ`w9!|>KJb}fYEA4x0#&SI(sfNU;P{QYLfG?~8vu5l$M)JTI z@QKp?6Mi;P4^P$C=UOi$=Q%0zL3xa-BBsEa3%Tn%6 z)V*6bN$w7>8=)eNsEu0rQObB_<+W_FGI{Q3b0s$7dovO? z9ZZ7(Br7SGZr=RXWvUhLLtF18040ptI7^BdMp1;0Db zL3r-jtTv$oqt=$ zPn+gLl>r6fG4~>BULGeeqKUw*H8#R=S$d8DA9#>H-+t=CR0jXnC1Y(kGzG-y@z4h# z0vc6lrSARyI6AlYM(rohpT|L*>)3mA`P$s9sN<5!+acgx6}ESb;GoOxI<>X7>(=SU zbnPi-MARa*uv|nc6erBSK9_z%vQX4_&!qWtqSRr{u>Otw6p^q0`s2xu7;fNQ^jF4+ zDhH>qHz4C~Mg7DPk)msAfF2_Gl+@Hcv~O#OGJD-M^9|o~+q;5+ zol3_y$QC!FjpM#38ill1!*dkTmVZV$H$hOzsh|U#yuwBnqDL!2|JPF*VdyQS#4uqb z0neAMp`7M;QZRGpv}2RVAZ~d&a5(5w2*;j0`$4Yx_=o`oOdjzQb?^Q-I=j1vAMVQ| zh}fIsEE|6SBk+`%nBhaBCYykG=^PYx#X|o~5JvwS%)PT=A&AV254bY&w_qVLvP6dN zbU?sdroh3c7yl$NrYvIScp_Oi&j#jvJTfoB78JH*2{Sb>F8Ql`{+w2$+0Jov%xSbJ z`urUqZQY<=ly`obNOgCRB~T9dJXB5&aa2ANI=3;#;AJQUE4d9F0DmJmv3s|z)aEad zt|Ex=>?Ua_C1&p+w8zNMa&mH-n`ozzebB|bZrf(3HD(I;Kw@pj#$a`i1ar4biL00l z8ck$C1VnF{ckeBmYO;IiD+ta3Twz>h>#8F(oA~r>6<%;hY3JU2_y7v}u0PeT(J-b| zuwml->>S+jz`ws)r17XwVd#$VSezHfimAs-GkF9KYlS01)66h6?=whtJw~tn_uk)# z(ajinOIAuomI~(NNygR%zs*&v8f$8zuU;*xKP&vV!~5%u*jou=D5VT`wTvJWac!81 zi5k=t3Z8svq18eZoTodRj^IxKGK&(q?iRzoP3+;Qs(A|*JVrkWK}OSo$HYmEEVUG| z*~7EJFuh~6aM}F?Tr^hQTt9GXWif7m4SXN+1`I^h(5+5RBajL)gE9M-mrQJWENcWl&qPiHbC6OFz%h;s)wBp(tAYF%@FV_iX*B z4dd0>5114XI3NI+n@{|tyzkyUZ=81abnS6*^u8p!p%@jyl}2PVkw-43T}e(Zd->8! zV8frCZ$Y&ZI2pW-9%H@|LP=?O9u9|{t!*R_mIB}i{t$|~yWKHsKe7mqeTGeTNHRu)5!-#zO$n+PT2SZm>abUQnhA=7%dG06=B zZ|~KCsNyyx6J-Hq&Q|^JY`E}e32S5M_+Uf(Ye)y#9QKAs9l5eto|$75s=|HO=gy&= zaGctQe!8TjFujE(Q+$s#0o^Xuc=N#_f{I?ZN{L|wLqyIue=l^JH@y_bn0HQ11&%pa3s8LVKI_5SMpG$q#A z+uwXUZW>{tu-}N0{3FwhgUZ>U2o*D=94A$1pVY*X+Y4_V1akTc8C%}X(U1w4QH;xM z_r1?ka1A&-M1A9q?b~rVjqTgc7V6pDDzf_uT0if$@6QPNvE%x4+Z9hf}iL7uj@w7r1K-+N4)^(_pF^`}XoZJMzPO^H^ZWxpSiXjgVFq zwLPV0wN-K7K(c%Dln*;RJ%{>bGc?GRWvPLCF*^wiB%L`vGetf$21z8R;Pva(vt~Jt z4c6#IE1S;&8gJeuBhkHozkcI~Rl@ao<7OmKdR;DdAxM&3F-6)%mAPvdH$0%4$k^Fz zf|ScIdwk<_)OXjy;N*7C+-DL4P0H)^G@n zUyyn*zu=C4e3nFaCE7dX+*W;UeN zZX@N3pyfmoMBHY2!=d$|+A*AAygnf1 zk)&1eK65xNMhyWa)@rAo zE!HL-lc#yXqVo&{>tEz)kafDlI?VzivTK|8_q@QW=uQ4mFfeh$r0ySLB@0XB;>k?W z)ouE^`?NIcIAHp0VK`zWbFZL#>R=p6=o6xS>e6LTs>H#(TChRe-@iCq)YtFn?Ub+* zG{#&%oYH)?kPo(=BH<(X%KQ}~2aR}C$7b`NqSYi*zeh?L@+bqYnDHZYZCy5P8KJH| zIkk$XRKjHk&yRKR?WheLp4eg>mxRU6FQwO>%|)PE3*D8d2x-`Y3(*;jQ&!eWwus$A z#FW=_EA$$wM!N@v?`lM4JEzXY`y4TVFlwgOPME9V1HwTG_Y8Lm$EK#QT_=jbfc7%_ zcG^ov!j41~dmcZ|sRC3_VfrED_uP$%NPDoTF|$x+=CT%fMw+Vl#(guCDFdkLbcYDF z>166*VPWw>W@El)UUk6&##1SxNrm759eKgs=UJEK!wJdleWm@669Ga(5G;a=U?r%S zKj=7cZ1GU|ucE?f%^EsqIvB4*^}vqn_Nin%zJLGW(0XUjex)R(|IToHv8$PgjjWic z>xW`_f-_7OGZP>%^Z5bvV(c9q*+hgqZ9Tm|WbChQRAKD=1N-*TEPT9!u3|p0f=Kr8 zA0*Y#Bele4oL%;5{pj^pv#ype zyz230y4_xJQPD*U`^_BCEjUhTvEA_Dfk)r|%xk;5bLXJ(`;N}7{?%TiuB-d=bPubL zuT@(kw{A^O{w(f$cEgjr_S}F)FgObqSlsi}y?KFI0fZ!QToA$NM?gOuO>PNWTd=JG zzMYGPg@Z%%^X*wp?E7MFUBwo~r?`)hD;iFZB*GLb<5cl4+ZWF4{S z#U&d5G*wyqC)%R^GcI4h9(MF-HST7gKhuCpqfv=wwPLi5i01r0G;B6)itL=fM@aJL zr5S@V%W32B&`|<`+VU*s+ub1bqDA5xIPGZu@q?=$@UZwHXb^9R?57{kF{+RI$ptRk z8CZei2c1a9_n2t%53<{oJ1wDO%%;|Nsou@7eOV91^Ynj#A~kQ{N{EZ^Uiopart5wW zAQy*D*g>!S9XR2{38V!>X-ZSvFIl*7{Iz6~n_OR=p~VR4NisS^8@WzHMVju66BRn8 zn}r|eqyIm>FEeRZu8by`jvLq4P>SgXwrbF<^>OLxWD|2fENnV#oAFkuy|g0*x|EPi z;^qBj&tAs^g&e>?Y|XBXBAWe9MoISSMdX8n1P{Nyt72gA3TS}TwOfs3fKjyI5KWzL zrxjsxn|=uK9SDb4DbvZ|tp0*B)2F2loYQaW)|dCZ(omw1i(8gN#IE-7>7a2}`g8n6 zbgjINEk)2?^YZ%_c^u zlP6w-EA@{CCB;gFCrZeE=`w|7t;B`mCr#1zFLA|e-+Dz5Yv z2^Va}6bw8MjumIm-A+t2Y<7}E^_$8OrKoob3+Zm-%gqyd+y(<0jC<~a>QX`BRcUE7 zK$(u*i!KaCW3~c%_Pv-+lohN_aI@N#B&d2IiC<{PzhaixMpG|yZuOY9dBxa}%z8eXd ztd!JQHzjF*;s(0!t+WPij#pF5EiBx~B`mZCF+sAr;Z#b?h8V~;D}CTaQYX(+PXd$t zPOMg(VQgHBq!`^StznL}Ldy_a{2S3NWXk+b{>(GsKk+FDS+UK>O3AukD|*~lQG7wY z&UjW)5x3Sn`u$vebcF|wZH$6L@mfJ9|_ zoV|7}G9to~G^`{A?Tu;JK<>+8NF9e~VgW@Mzmsne6MMERxKT{iUPNRuECvo0?x^h| z%mCB3xmn}*@du;Aq3ZcjN@8xNmbfA(A~%q+NUltc^8UT9Zch~4nK08L?N6)_a*oYc zM8r%NV8SQqu@mMHGL)&oLx;FyS?y#5*D{^LH_7yS81fWcUjRyRJ$FGPFvc>;F8`RSg!O!NzV3S0ow;UF2J$O67S922 z5f5lPph(k*JUK>l!J_xLbf6L#6zgu1#L2-a^@SI146p<>&+xso31oyAPOx-+J^1Zb zQj*b?OUb+U?lrctQ98VI4oVA%WKg%x&`sRx0p8uc_;DAJ#Zu`_T|_RjaSuSpGq1qz z;mTW%<(npVGiB;Q(EWQpH>-bWHm&x|tgJTxU%HFNtNDgO{{F+H{ekC!_Lcp_qP-gH z*pP5yAa1r3we#Ld3=T)+t`jcQ-urPGrvOd`$qiFEW&NcY8e_G2;jQPZM3QK+p7@lf zfO8zdQ)o3;h;PFUX{c@7CbRNzrnH8MpTh^@cbxhK`22E5eyJsbfE|A@Qo?=d?1c#8 zkwgwNtI-Qg?u ztJ#s>Yeiajk?{3r&r68d^rCy&-pPL!Hg%&c!;T`R7l+je0h+=-3#B zoIQWO!lcS0N|bkVyu9v0&e`_3@Pr^M57hI4Z=6_3V@Pm~d*OO;#yM_t!@95Qc<|c- zN5xPYgGi)_8+~66%Cx3hvQ4$7&Y%lb*z16I-N{|1DcS*;VL(@Y`Y=&jJ0`ZW@3g;~ zuY&o`9$+Hu7jjU5Fuutr#0AJ{=t{QF{He}4j7cR9zgchR?A!*;0(ttyp>ko}<%?h$ zJ}GpI826R!{APE)wvJxoBHw}B!x485n>XH$_^C5=KH^POJD?SdZq2*}1(VH0JrM~6 zDLs4jTC{Yjd|Wmd3e23HpAYLYK_PF?IfugV@wT~vd&aQ2!3z=+jJpxWeHFguh_Y>| zNjgL3f!e8Icu;Y#U3M7uZ^$W6`8Per?lTq#ODdGyHK%NDa80VEXLuxS?6W@6!|#9G zG#T_ZU665Ob${eYapq4GTiaT?q98m#l;p~@+RiVwjlc6hEx?Nj6#gH}2x`>ueW%zS zuw>lTu%z*VA?*!1gHZ-vw0nP{qz8ZV_yJ8#2RT-1gDt4O!lfAqV1&?`9Ic{)N$)Le z%OnI8o6x>3CYW|HRo<+bGbN|UNQ;cZ=?r&L?A4B&+`3D@0pkv%XpPnPPKTx)7&)K- zQeW;~I)hc*%Rw52t{IJ0kF&FCu&J5E=Cf#KxDf&h+1IC?aN*+Wx~5?T+EKGPm)QTo z`F3O*7=iK<1IxH8SCZXxK_f`CliU{(1a{E;=KiEXyVQ?ip;}p)#$HiUvU$Az010I0 z`!Bf^*?u(gk3$2_l8up*2~bUR}7&emxPJW58)F1q&ZN zGM1V_;YRhJ9-!;_jJJYvIpi$C-sf*|o$q0Y7f=*HgSOv+&m*x&8aAw{zD!+ambltM zB#KzAdEHj>AjzR$A?KZ&8DP<0ZWLC^G+QKAGqA86!sg>*u8v0R0!((;_rr(YHHb|y zC=YC-?e#SpMV*-_FEh*>aHcaVSu{jNO--25Mq5xZ z7u?S@pk{liWY?>`C**!?wvi&!m7C9rUchss+(NCiZkyoDG;t!{DmIojMENz`3*>V< z2pd=$&GZ`t<0GV}l5Ob}DI1{#c5MWKf2!zF^Wg(q4oUS4StGAs-*TQm#|vkD!*H_k z12JKB&VMI_Ft>(7Bp`_L+^qPBvDEpSH~$62a%zHIz!h<#xQmU=6jXl<3nXbcv9POMblfe3meJ!OA7&^wA%vFbk+9`m0mxslXq+(N21W)iHmzB6|AE#-Ru&&OX4|MI z>9zoI{-aM9K2eAGHbSSOxTi?CCx(4ALC~(l#8NY&4h;wprS!ok9N5JRKOJHaH(~Tz zsmraGiQMzNtovT2gDgCL!W5mxb{^Wd#@;-rfuyqj=LEq#=-OP2Ia)Ca91OX{Dn%Hxsq#&5F&CvV$LOSxw6fLpUFzgq;(YhTTtTy+_O`72IAUj(dw+g0hX9mbfdgzGlH=1p3F0`g>)z#T)V#qNL zmHXOS;4gYcQHto&_4Q^~ozp0|z!mhLwqIfv09t|ak1IGJRgb79L^BLV+W^-fUnS5F zOpc3ZZxNes0tIQ4#N^@;o_ldIatH=}a_sKDCERVQN-AINBA zj^zTE4ZOIqPTQd{bJPL;Zb#LHQKmxEkY#>Td+DuJ59-s#op`LvvjhxpHUL#rGG7NiYyJ;~O`ov0 zqp2|X-Nfz=SHNe#$mb683UYD;w>bbL4`)7-LV#pbQ*-~#l5hXIg0G%G&yVi{e|OJH zI`;N$hI{s&gyTC8r=GSPs)xIZ{=)<2{G53rhDY(<6*EN6dtl5E(FIWG;zfPK*1+-w zj;bl9!SmqU8g`t%`&Xr#X7?{)Tu8SIk4C`)c;G->`?)gCgDeb9!QN(d06dQ{tbl!bjb$v&%8q!q|dWRTNF(O4mzQ#geVgqrNc%%;A_cyy4 zrrmE@+rV{FM@DKcIL(hN;)oIyKJweEq&784DI^*7xIvN<=0mJ0ow054EL`1*?u)) zpFm84VCNO~+@^&*4@Aa^;q+VNY4zmF*F){LEp!)fQNzb*J9h+JEW8IBRq9ZQ?uDl6 zP@IZ5Fr-)sPj2K19Z4fz#1@qyY&tK>W;Pe4AfJg3#Ora7x+sv4xGzKa8X#@p7LjL$ z@(BY;2(YLAFjq<+3n`My>vnxmdn5{rstDd$`p#tElKR zZX&q$P;5}=J$}qQP+*M$i*F+%@O2dmzh|D9uEY$!o~~|Uj%YqcC7@h%Q7v(lh76d= z?Pvob_r2;Z$YvHS*qv94+>TKU*dZhZo$a?b7VppH2^#F``&}=M$u^<%*`uKObtT^g zNGI-#$c&b1;8yDn?(X&CJ|eSe@(a265la#iKjc^pcCsfW*3;JT{{C^`;R~N2`OYmE z!6v z60N&~H$xqcuLNxuc-zAtRYtw|o&qn3+!y1KSslCMC-}5`GND8GVylq zo6?euR^8MJB?ncijW!8AbZ)r2{wt;gob>J(?K4%uTM_Riesohs!k&q-($Px=*Eb7I zS(`(^9Ym%d>*@-*ehk)l!l*t|z5k|Ac0+ubU7s@}o4#fnx;^a;vmQ<-m4n+521VfD z{n%KzJ%g%j>Y@|V2$tvfdBBO$S7%<=sv-5h)SW|?t5zv|ny#i!xrea@{ApR;-s~Ep zn-@L@Es;GGg8E8I3hI!!>0O*zf8lbY&X>Hip_`Z?M$%mbggnCrX9T>kyN~^Mt8AZOa%8jb?Hg-gB=vx1Fo;8=H|1e2)`!-y76~?nc)visN>Oew*< zaI2k`K6RpI4layX^k&7EqO)Z`0ru!+^AzEwA|`5mq?{HmFj=>a?$B3SHpNx5BdGEz z`U#=21A5Vq^r3fxtIVgf^kDl5eWuJ4%pNlIO2d~Lo@*W|t{5bNJr5kn&6K%u8VcbL zG*O(YE4CkSkJhN!pXd;O5s;z6CfyAG4%x<&U|}dnnX@~7?AY4klIe;x0jP;U^?++* z=RrTTp4<;)0DS!TU^6wKN}?8=)Iqf6Bu{cw-sVGaY}05VaHzoHf(JXtcgHvei?~mj z(M!4Ci{{VA#VsMdE$#8Z#*GUl1N~vg;DdYI8-MPKd|qvFB26`zbI1(rmM2}h6^JH? z=#kJ7#{YNY$rz6w=@ka#uT4}IR|xV!X@cLZ&<oa3W1WVzm!y_Flr(t z*;k1;z%hmPa!L3o#&rWg9<7ZAZNL(cHgC=xuDw^cSYRw|a0GBcuLm$V0mvJEwVOh@ z;MB+^%7%v_CRkhg5=1j~jpB2hpJsLq^E;B_;x_N<(<-R=kUf$=hE%k|X`g1EGk2-P zb(dIFAcFZ1fT894cixyUOu}?(A)ajCx^>8B4d`J2jh&9^C`?kRF_=iVZ!l)w(ur;k zjO~H?Y~1&Ibn8YP56}FvsOYf&>IB|mnZiM8ooDzbVc!~6HMKtTQerYLl$@H}H|g_@XrCHbuEpwt zHiZM(-M*4TAEYpK%B#h5O-;EW0BZ~5Z9i7iCBoT-ZLV|KGW>gLA$;TXp6+bAUQFjU z$t^Q7T1)u}!n=mHw`b2mw#9d8Z1O_!#cTBF0JjeeE{2X?jvRZJySt|T@J9~|3O2pC zF;ZVYo!S}ymshX6>qeqk(G0$S+d@P{Pw+OH%{A;Jh!^x(?OQFPdtTvGK`1=#vx}wX z?fLDhb5DRmAx!`L`jwL_FnH(W0rWjotJIg=@>0QEkIKbjR+j_Ov9Xgk{(;^T7xN_$ z!FdN5pF6pG|18{s!SLOexq-?^|2jjDg!&aEjhygBKRC$M_72p=U!?S1tr#n%iwy@C z3){nIzTrv?hrC$hX z(^0MJC)RJ^z?mB!f!to+^}yBQOwDNzESnkK2MwKR<5)4(mO$$I)q!!Rji`6B5vOLS zhX-cLN|c|<%7W;M*3-wT$Q~jIdYuT&*vCiE9Aeu*IN&ZnfB$@yKlehZcR9!mkllFG z%U1~kfdVU$#)i2uz!y6eNJ%q{H@=Trwd$3y;if!}!;W4@C*|Tr6P&=x$`+fM1%^%& zZ-exomF6OykekrsE4Mro*ifUn<&Elf;t(LY0I@&4O1>th-FiK_=Va=BVTiwg#5 zRC7@6zml4JdwJgdjbMB+{keQ z(K55Tjj#u`0B%P-M{6`@99E8j>qiK?5KWe=R}Xwwn9wsu1HtaVJk-yxhpp}o+KGb4 z{i^g@~6QHyuMsu4MXpi55RumhPtoJk(t#;oY zMO9bFwMu>aUcYn+r2<~F&z?NVnxcFWB@kjH^l2u5n44H&|E0S}lj^CARzyQhO;cUz z@bv)zX58z^rF0m3^f?%L4A)$=kncIl!OdO?>0ViMt{E~VR1%PQ5rRq9^j0wHBEjMn zn_Z!)e`xms!=69E4fJlVUk_S2V`JBqH3r+I8|}1oxt(Rf@a<{R1G#3HVTLQdMp9yY zHbiDTd6)(E^)9#3T#Zg{hGL%gK}X_gi0+oR4^a-6=21EF`_Q#GHTD#crkUo?l&5Rx zdq#h%VgqwIAf?fu%2d$Hn$4Si@W#u{Vm&Z#V6-Bd3#4p^2TmT^$C1_pB0eZu&Im`0 z>9;SDQoSL-_X=dtISgG=JbrGXp@SzUq!J8$dB5?qs0k3mqc|+>7CC~BEe_GkUg)aIuHIy-N0_sjo1Y7FSlx?@+U(wLHxh>(hQ+}}rxIiyg zs~EStCofW5ZMo2o?Mro!lRm1V&Pu?kCUXiL!`TZ6eQ6(3S|Xqz+=M7qzN)Mg*l~b5 zXw#W-*P>g@FykA6;TfG~!I;h|D+}JNtV|oKlJfxFB#<;2!7=-HkTckCOs=T8-vayI z(n(skp8Kg3!@Z1YIgvW(XH#JIO`rQ<&J5-8BSwga#I5@SfQ=h+ng`fV49Q2I?T0nx zdfrL*0+xov&ybU34*gK?_GFE5c-Ex0W-|938afJkUb7s}X$z2g>g zIDY;4L)oHEWw#`TBwT@lL&9swP<5x`l?xUmaJdDX=73)N_XwiVTsadDk2D(DccyL5 zVj{VTDmyqhu9N&7Jaxx)3S{H2SCm9--Ut#2=shS00yKfG>yZD{`}Eq+kVZ3tJ45cL zyni24_-og%bAPuml!J_yh2@}acXLyyPtc)Ug21ps1ybQm^7xJ081+9UTK<-9wnw=u zLh`a-S2ZTF2hcpFdkLdhUV?=P_A(j5r7t9a$9Y^VFttU%7~$P>6ds>U?w>riLx-WV zvZqhazjUNv+FN{IVOsXGVLCL_0GF7tT^fVfQ!rNBF)O>qg_BVjh%2W>F&t-T8KNS* zRG>&0<>`A>*CYszLff-p6b(?`lzjWKP*zj-*+)b#VxU}{zv}U4Wdq`wt z`?q&<^%cG}G-zNQADEdZPwPuX_4$%ct6J@VD{1gVnebkA0Ee5<8C7P3X2fWq8NpC@&}ZfntWZs6ekVMPeyanBcgMY{X|R<6FI0 zge}f zEe&#>cSLI*sByK}jp_(HNMZt?A6yE_cygMLLAfFO z#73B-Hq*g6kWPlN6w!lw|Au~YF&U<={(-jyoI_Buy*O|t z18lT4x$E~H>TkXaW+m|Oy+56;5D7L#75Kio8h@MIDKg83tXtlnk3&4PM>emj3SMAn z#^6=3#2LXmi?)r^y*PNDVZ&(s4|oMp=8z@qul3(#3Ya^_aN(-3rzwzjyH zoa9IyJ<1S9?y3xJQIU(H0zy-hf-`_oz{;PWpF*ZuC-3pr^>RdOSW=wyp)on zUDWtr9uZ=V(L;|+nW=0U_lFq!r;(S01K&EM?}`l)@zN>1ENaa{OHfm*nMz1&04EX6wn;FL$EvBdXx9XY&~w zFJcBe(Rbj218QKnIrUIqS~66QQyjKUc3Zk(LT8UtFdRmJt#TgRHVv2$$BfC)jUJjQ z6)PCTfnAN&6Qxa)E9-gqSCQEkk&uy8G&X`GY4|EqiMi+zn{pn%eS757q8GL+=`iKX{@~QL z!6byz02^rX78N3OiHlAlViYmCqZ7wSjh^A(P>RVh2mT7a*Qo0zY0%EX0NzOT#mNVZ z$UZPW7U#Z44D_Il)>ul0aP?VEL*J*+zCDFG^Amczv!uX&{pd3z4xf07X#^n`I^kG{ zXRbIhh@Co2nV2kreivc}MOpWR!aRLus^Niu4maCqu%Mz>zivA?HY~fG1GW5!3%e?P zTU-39pVH1xYjvf-7JC2=9SR=}Ue6ZDlZV@~Q!tHH8(zQDw{NF*+RCTsxXd;KEG(sH z2hz1q4E2~0%$f3Vr>?LnxPPCuB&AFtPQUR{kO^X66W=6zx`0k;`k?zc`N%wHe#^Im zoLp2`Na25K?O>X?BtTmmwXiVVsh%(pPj z!Q9>XTbJvUhny&ky6ItkeSDI>ym-L)=gqZs?Q42V#JW31D*TP%&jM|_kJ|9vfXb8& zM>^AMgZbYG9*`u?&$&E~iEE9A;W2_OOdH5JG+T)-ngh9YVxSB{rYins`dd1|;Z0PR z(IijrowX-VofMA8`gJ;)VT-An%aSkTSzF*nMS zlLMy>%S}TiYWc9W-rmaicbo5Mjj-vCNgn=*%m#n|`i1uKiT^4Vyh5IKoUo2DBTj%X z5e1d2I(}gah@gWuf=2>@aC*{Q9Xf)*+Q0lpAVc1i$txsqgQPCk@;HfAf=MxKn4r?~ z8(Efv9Dsy3V161fZ_c|-!>-*=xp{LTBnd3EJ|ASFWrLikMn$rdAilKNeFP++@#859 z53xK0LsZZQLn|si*K&8uN{WFV-Mh2v zMDuV4-3fzYESz|f4oJG0d(dH#KFRVlG@_J=sTLd~$wdAuFfRWSo^V`t`g2FydVdNK zGcz-IN_=TCq$70!EzHEpDD{R5)gh=c#Ae}YcJJow96~N7u%CBeuNWENP}=2fe$di| z^Ro1iwb9DtTG}0q29lLr+kC34!?)LL*sw;tqy`O)dFVxvN5{tJ&%W7&2(krdMCo~) zM_9t->;izTlvb2Nbj8SA;qYw<%WlU>1i1uyF36>16`UBdHfd-0X>3EaV-DzzCsNVd zL;XMM`bZ3jQ2oV6FjwOe#i|PAD3-wxzZ1h(GRVk%yFa?Tc>Y`+4^Ky_@$I%=La!vN z^p?0Yn(bQaEYyA3yRg#3!vo?hM*^M4s3UXuEt5rIoT(UPCk&Sc4kQK?2i@Mt7>=`rIDj1B+St92;(elnL#}x{<2q1nTp~bqY^zx|?D6i7!mMp~HqvGC zkR5FY1p<I+TT@o96pS%S{{DT}IQQ*+Z^g{ewa5f&|FWg34cS^>us zYr(C&YhU8R0AeK+sE|V-UgjMdF^ug^FNauIyhXgXaA6D8k9HqHJB4*q)2eYwq~VzD zs3(Sd=G?pYk-32ME2^|U1_n@Rdf;!eYSkgubJow*R;q%FM#q<acCB{ zzQ1Apa*)TgPQCUJXq`~;3*NDv3NPw>&#*uRf*G%Afeim<_i-k#b^S&v7zB` z;?Pa87{?EQwPA0_b@AetIfnf3L%t;zJ@V2q>IN*-@6%`ef>+yL@=)*GC~Ol`bKQH^ zN$Vw{3e!5Se}}%;#&EV&Bc3M29Hv=MJ_5{kRZ+1_2&VB1pN*}ThGLyBuVY((6|udX zDo3!Grfd-Az1P#yP%cBC*-XLC2L~%lSbLBvx%dSyK~V8mtrB7ZA~c!qm}Ub63Q!Hi z>-=p()s_)u&$w+b(6+8FgV~}%vPTmVE_;2N_Rko4`n-7~UOptIY{rz%JbzPnwNRSA z&kH3wkJ5K;-~K<4w2S&E?xz^_NzTQud;YZ%QjTC!?YhSTjJx>YgsgaM-%<_TcLU>6oGRsqSj z=r%jfVtWNCi&zVVo1O$BOy=zI22T+A&^0>5nGO27fac=m+qeEaQh0P-T_jMaSt!s3q>GW3Kl>DztHDXhG1tCU%H}^y{i6{~c9LKkIbXLr zu(a>5)%OdTpeGrsDGoI?1?4g{Fkn?V1)Y{Kh;Mf{BNBl%b!^44l48{nb5HfAbsA0prjrwVp_;og* z1bA*YY&5x^eUu)Y4lddVbMx-<-{G->brZb-WB7{(oqSDnd;R1IY}L*>IzhHlPBBxOGzB%lqNC4Rf@IW z6&i}?0>S!gLjxcFj(PWnuOADAt{Qj{ffKW^#O(Nqm}!!Q11%AL{9wSot(NVLXHK3p zb(0$q;|i13d-{LW=wSaYlSamjARtjuCGBeC!YShAR#aAkzYT2Ox}=w|;m0Mguw@0z z(i-5{ga}B!e9&=MiWpGCb=&oL<_`HF=pb$7nrN?y)a|c2h1-nE&Yrw>8g>az4((M zql|+m6F)&WXd>R+i9cnk(cPu^YV{D&!c;YK`mW5Zo?K9{*chQ!Oj_d zBmqlAes_wZAR^ol6d213{*jK7FAB6B;o;a_fQf>OIfe`|2L+_g>e1hT{o*8Q=e2f{ zjwxNH6@l(z#%`qHt{^XuC%TJH+lGRTgQLHs_6xN+Hq~$^j&)ckP#V63H8ZKI&w6Qr zxlp?l7yED;=#@-1;`qb*q=@yKc=|3x794|VL<|{Ttf(MJ$ek?HJbL;x+E)}9w6YrW zQUU#sL`4ny{ADrkkcYs$J36s`2l3_L!LG{6`6L7+3rR|H662Y|J}0vsgGFkUI~Cu^ zr3Xj*nLjU23ZXQmP~!iC{9|k9r1SW6==SZDeBt$d<>YK<&Dw|X*kInfcH360T6N-E zHRbCZb%jcSG#S4&Uoz?WmOuPS(#5!qKj}RWFuToEhmgj$l;FTnya0$|qQqn*7}dmZ zj{iE?7!t1J6sWKs6j523)tzwZ|2gl=!v$ zjm>#HhZ8`+hKqDB-C?!KtTcaI$9O1-in8Tu^PL`q4HuscVOOra*-m4k8rt3q*a(OAwY!7|dThmmv-dI!KL z#Zh;KUBc+mn~jnuIYNy5n0^NQpO2htt}V%YFDHmAzcvyHNF^cJq1^%e!>6* zT^3ChxOwi$iHi&WlQU^&q%U@{Q7%b7bn1m0M56O6LS60W&u$m}kJvK=hDj2%u2aXX z(TKR{rx+>#rwuag!H^KSn%zY_H4Y~`lg*8%azB1=`9S^-~F4B=I@&^A|xNiH*Hqtj|}WMS#2){L&wiQ=7m{5BH9-#D(Bs zX@JpdjaoGxu=2D;mt64?Q37=)x>)@4A@VtfWSdfj#~nTl7YFJhXiTzFh!tZGW|Jvj z)Ny9`!xYe{y@Hbvt@4h8wfc10!MW@-e85a*Yz%d2N`nvXk`E%`K7T%o4A9``*_B|m zddl#1)DG~;7(v1tV2J8GWmGAz1z8I{&!9~Kf#BJjHr)XAOuD%F?=RKVJi&dQ3ej3y zdt}mxyw0axRE0#;k#UgNMc%v@h{qrN; z6$bPd_9G-(FV@6G54R51q)_;?ego1&$C~X)Vg-z0G<8p}r?KuNM2IA49pS<=0!I@| zp)`}37tLKr?Z9r`lKH;LGoBJXKpr$d74bJd?OjE660nzP&a%9iZ!}qfdhNttOES+L zoCt#kfb1V3&?tN569$r)V-Geq#>JJS2isdg2$;~eVml1vNc;8gGN$~yj9myzq<%V3 zPVX?5*O+Ukir`gI!QhDL!Rn<;x2-d)r~w*r43Rj(nt#q%%+8>@{Iq}avi#yXQSLSr zO?W4#q&x%A0@frr10CRQ((n0N=Zop-npP@=&qQhG!Fb;jdx~GZ;wbo1kiP97S z>^x#NfCcn)3anjyTLCgXu=kIrQm#ct>M}A)>^AEN6GUIW`@n&yn?0c}r9@fByO*YY zgHqw5xdECCN1Q*P*u@iQVe;fUGBpqU<8%~6rstQAw}9DzNS5D+y;e#d;&)>maoF=P z!=Z?#_@&#PeSYrNb!MLpSh<*%Cd6^LWd^(KzBLxNg2g&*oDRWXUsak`h~^iVAK_~B zf4|S8q(r-5f$=t6Oprbvrg%a0d(_!ux*WZIrtn^?L20k)qcpcsPEowTccTu3Ll|K? zd)mTeJObfx<9@~{#3-qQ#=>$H{Fqi+%wqo$VDv@TnzULd!# zqP4qxP;LdV2NY!E@U_Q8rAy6#r76|G_H{-Yf0}-tV?QK%RkwlQ)bugJ+XvS((mQ6w z7-RsJ<@B)Q+q%%A5%6FEk6kq!%UT{L#j|!D7x|gdNNLbVykHr$katZ;y~$ge2$ER2 zY%=PRr26YbXNmEJudqMvm{S+M=NKcDK}|`Wh8H+-nU-S}8}vZmP+hiduU>FE?_nK@ z0`eJF7%DQ%LvWPZW}xb{66P66|2pQS0Cl<%wq2Prv2p@$>-I8M9%l3ZQR(`fbe^nF zvWBQW#Mn6I-Of_}wtaXU&X{3yy(@?dB{W4X0+oM&;#>r;%u_h&1=^43c3}(_zj%?m z`!rEJObg*|em=7D{a+!Yy5`1*>wm+xeS61SXLo8Hw-xC>W=ip!gae+C4m?;aa2LoH4HlKzo zi)SGv!u|XBXM-tgXULc;@JQzQ(Do2_Pp4>iUY?FJsq z{zZTU_>lP4VP5hyP385z39sW`K7ESm5#y3kE!~7QML%TKWP?E46{zMe0QNZP(e1(n zpqv|QJo<{s3B(Q@v|O#a8SMYn)YdM2`&M`{!HrJLmXg@3h27XovYbK&0{8z|I4W|L z-d@5YhVBq?FU%hvDzu#Rgi4$EyF2oLI(Ocxe-FYblHu>v`Unidj!947ilPT%11t{c z-`i>-F)u)=!OyH&+eV*0e||4pfx%B$sx{hgBcvwu;@AlmxcfRfY7BkF!So^0GY{e^ zJCwZtu21HHDvCJeLCaQvfZF2Z3UCP;GR`NpynK*~ybL?bpR`71Lk6c}3&cZOlC+b0 z17RM!7Y@CA_xZCnfN9sR6IZ2EByk$~yQG&42TJX4WW?Z!AHEIWJho$FCwTBFY=i-g zhkZ|f^K#fN`j*LJT54~G2+DK||Cadx*Xb7RM_AX~xBpOG3nT|CV>2sO z*bn*hf;1g&a}QY3Sm@yqatyKHrp2IM#sjF&lbP8BzSRRw`GuZ0aN;!14#aN8nwgfh zR|tA^4V*mGY>Y87Wk)nYLp;Y#*8KT#b8DeXYnYDR-$hCibDCbPdv}_cHMES; zzf$toey0Hj{>DU!_voVYFpYSPSF;cBIBuy&_Y<)2E8u;?6ALjMBjvOMz;mpvt@0lW zv3m{P*eyCHa3v_x@Xf>aJVLhQ_G#77p;rQHDUFECDC|B8oi;NqhGjp#f7czcUhz_G zZM_u-WV#?$1JkqYJEf^t=*KbI4|qtN8S(W8$X>Vs6q{=&ii4;A{MS zJUglfW8=FBkw}xw^MqjA=jim^ph<@hV_v(6!xLzkNs%vk^^g2y&sc~dA`^Fn5HsvF zhs@@L;f52W4g9TdXd05|+Ihd-5n$ zaUaop#>SmY#DGjjQYr)??^e`_lP9yP?z*8n=Yin3#G8t~?<(R((y)Iuu>n&~YEW8u zK10S*psZDmWwsYvYc&_P!@YMUV3H*;k`gjJKB$;};n#I-R;V89Q?;2JKL? z*X553v#-aGH~(p1KR|ZoepLGO+PvJ;{mrxo=&kpNbfotjfHq%WwtN; zP)mxI?kcu9vk1&x5$O*(o+T1+oQNgDTxo zuxU|4W20b5>FeV$&A^H0=T^>Ue02o=iv*5}a*thq~ek*oE&cKtdA2&WxrMwzna zw76W-0pYQzKBLPyc-Q~O=l{nAC>{sdIUw}$5etjc!X}|0h7sGSUek(u)krkTPehWr?$4<&_Uz#bgnnQ8^yePwzDMz98+re1L|qkshq!n4Z>ZmKdgxh1$+k-%in2en=xSxmnD zBki8+chDmbvwuvlWP5$8MrQ61d9Tt`vMGVT933Rvp2+mOcW0Rk%AP&TNv?B}1N-wP ziOwG@DBb`9ddMG(k1wyN@Pt(TgZ2U5&U#^tZ z=s}32lF`!C>?Z%6xe$(Y)az`=y#bAtqf1{Vu!Z~xs8>n#(DQQWg7@RZ6ANEq7 zJlLUC&$m&t%iYdH6*r}3J~`NC+Smj7`ZH&oePUxdNPR{plNHZSPaU*RV`5n6p{aM? z+*NBo)vD7}ce^hOR3iJ1-Dq33s;=>ktU9rHRwbul|Lr}i#SGn&N}ULzjWHDzvBo0-YTi_BCxOtd3p!r>6j2C5K7PE6sr*1VjHsJ;?nFWP zVUuM%#==4oj2$(2Hp;5o{efi8i7|1&5>#s7J@o zUbt{IY8Y0878bI|@5wx^5r&4cuQDZXV?kB8DS*~wpv}L^L%LnAwfOsW49V07tzBdtsUNKJxtRwD`UUPzRn^}=-&&NxftXJ_P2`6Z^m&>uf98W zH#9V*c+pnkmeTlcd@R?guiO5?fNB&8Zb#cmoc@VC6IqSKRw#U!nBp*PAZv`qaFCe7 z(m#qCzo%oJ8|c=7MOT76ZzV7L+A+`#z}pcNkPp*3%!(8$W?mx=6qES* zv39n$a{Z0K+n@X1(lZ_p{*7=Swk!;%@aI<~l5PU;leDLmFPK!vc$QNO7UmCN$)phP zLx!r!yOtdPczKIlvvK61L$6MY3tQ-!eOfH3sSn^AIdAtaWi7p(uBxrFJ&7A!N* zo$DBShvSaKIN2+mClVT}&>VH+#>iPNWh*~gtp6A@VIXi4^jVG~#k!fck^tusb z6qd>srQ^D;Dgzq|1qOW-aOub9c%iT;VRHaVetshN?`PzDi|IK0zOB|)DmD%dUm$bS z!Smw2=p^A=P^9ro%b-;5IAmW&0qoPGhgitk5AIx&JP|?Wl~X@t7lVcl6-WN1QzbST zVs`m;eIoECYe{(FkYN}S%XQr|han#w$zl3a?hXuJs|sFR^uN$M>z`s3u}2p7KWW$2 zf$*zSu3kmb`E$;PzVE5jKIzejLd!)rZ&h) z?8J$!`rFxsTM>fD6}d@y8|J@FSxz;Z zNl^u02B<(1rs*j3%_7Ml_jK%V(4XMUNdR5WdDABTJDoA+N-`~vzqjSOQ5!&IL$USY ze>_xF8+S|%Ojq}8BiR;tjr>^>ZTU=j5w4_R8r>2J)uJWg#hvBF2vPCD! zX2uLJYzsI^Ak=)P|9x@M$0?q_>IK?$o$L0z{Ogf7v&Pa-kQH*w<5Uf(?-CM%TkJT^ zN6yws>I1XOnNTfTy_((9i@8==S=J4*Rw{6}Aet79IlKudld+{%IHY~OrAsa?AjZf=%Gh_yltSt5VXpV`n;Hxr=moH?=q`rE+{VOBCwRJ_gP6+{#= zGS7ft1O4hXGfBv=$vbSJ@_~dB)@f5ilynBe8{4yI#`NjbaB63LeI;R=@;dD+y}V30 z>X${4JQoiFE2PkS_m86(1Von)LKd!VIyD&+Y|Z|ay6Wn(cLk`KX%!2m=7OFIG?CJc zHTCV)jc9Lf)^o@pZ}seX0&)jkc4D@s)$@ysAV6+NOps*Vd;EBSnVBQ_!HgO3wGP{K z@36j-&L0~?A=P8Sj043yldsQ@ijg8SlA-5>4+d6~p!aHvEk3SFYkp5qstT+$8bNt#w!P?T7#C7*~T1h0I{iibye9a5`h^-ERmHN#U$1N)^0d6 zqZ*JLL;S)9C zgxIw^E4HwPq387JE8X4in5*b>XT#u;!|kDu!G4Ph4yg^*92W?^%bL&z&Nqk$g+2fe za~ZHg?epbIj(d0S{{FdS2pSBK=|q=uWqJ*`Qk)M*x$XhvVc+P_Ob3{w{E6I8?Lt>H z%faDd>vYoi-``b7m@lMhf0)AN$7KwV=zl+bf-9Z*%N6ww|B9l6lO&)U9UnZaA)`Yk zoOm2Fs0RrPvdPSu>j)skYl1@Do|7z5Vuz)P?H+%~r$R&a)v&IgB2exXJ@844& zE#s)bFsawG0wrc9X=4}-QinzfjLfOM-R($jx$4K52kn?x(AilI@?I!t&>wHLK=bZ^x~vy*uT&a7Om^N*-+E|H{cO_;r6u1Pe?IIo(4%PvV`) zy&V^>wRN=UIl{v`gj{B-L3xMZk~(p%*&Yw*#Ov3tWi7+`AHnO)Bmq(FQIiD(vMm(1 zJpwsbX7Yo!?S>4F{aansPsR#wlgIY{2Jvh^@7l3r@VZWxry*gsaw;L7(84ajh>w9j zJiraiJ^+7yH#O0bHg4XPRq>6GO;1uRoA&}`b)?6#z1TlI?ImfoVG5=} z-SpRHD7bG2a3_ETJ}linW-10jKYkoES+4eDzhXmwuIt;~JtxLklu%kCjcDxF>!+*0 zCESJyvM7U4CEJdZdFjueK3$0buBpDy9yeKuqOAG~DTyrCTucWUF^j=?%bUq&ASx)X z`u6EVaBYPKJ5tv3@-Zu0KBT&eXL_yL{@x1*IAlS%5`! zx80au(s1z9nEp&ZGb1s0@eb5lh`yZi0n!g)tNMRF%2nt zZ{<%{j$0`U+#vK*d;Pn&p`uwjI*@(7ojS395T*WfK1raZ|LOj>d70{C0RDlC5a*&Z7D z8gcuuVY3-DBEremyrmDw`wIyaf6i;U%S`b3=iTaicJHpHqx1StQhdCW6*~iu2!Y-4 z|ZXtLRC2z_8O%STvuL*%BgtddPQYADCO=G4dP?!_8*z zS{8A_Fl0jqPh17*RBtXkiiOV6^)iwkw^<27aC6M4rk^72z{?d(#H-yuq5A6APi)Qt z?!B7R$&`68zlU#z!Ghlbf4U1X4D|yqxj>haoUE!DrT6o?%?oH4jtsMr3K-@7w-0%p@m&+O90`@Emp-kwV@Ni?3H~pS8I8u;(MLVFgM1I)))rxI z`8-)78TZdfrzL{32z?y)dR`M>)I~>W(XnY~AZ;KO!B27Uuwl98aZ#+Z!ueOLslC); z7GF_`0-=6BzrBcYH+h+Ip?*c>y<@Ck)N(dLK?=C6Es2B z_r=mBOW2Ig6cNKK_N6$W-T2|df97f089agR5ic?HHFP+P#)m|aaPAxnb{qw=9HuWy z^}qgrG(4UY)6Vem=#^pDY~D+C!P>vDFbraDzt**FQ%2!PK~1cZQGc0J&EybtXKVz; zC8Yh&_*^&F4Cd>&v$_CEHpOIc2fKtqa8fL_%sngZ9b50Fk_x!N9Ah`5oU>8;Zj4iL z&Dx@%xOo>x9|W<-*|Ru>)-#+axY$)oi&cIsSGfOcHkQFt$Baq9+8vD}t(>R;KIefx zA?TNb<;Urwku43sv7a{r1lJnougA0(cVV{d@)IOGQW9p#2Xp!IMKpf!xVP2KA3t#- zwz=>=SZSvhqGy6mhH4J)AG9n?W_pcLz_sl@PgS_7P}1spe3F$|n%!PyFUf4}^3Q7X z^s!^_%E|)P8T~zrG7<<#J}B+lHS5%j2r6kFi<3@U6?-x*Q+QkgHo=-&BSaL;`>_K# z>X7;xIF`psOowvi94U;&cnk>%0u8!U8|Suq^*9xo!2#|XsVC1+gg}>oj?Kwgwy6?% zSApKg0H$8W3vb=;K?9PpD52lCki?7cDl36(>mjGW!jvspzb7W9m~@BZ3qY|cyFcEy zTAC6&&`3t#Ze34M-ME_@q=X)iSx4-X@kLj@8z34iGay{Xb}coR`NALd)I#s@9ANP z+vOVVq>Pn`iAkD9l8Uv(U*%atyBZshRPZJmao{OB!FkRiDB%hlsD)bDG5FI>9IT-f z^7P4*cQcQ=JNGDu+Q<(r2t4H<9Vf*Ymvcj)f-q%wzjNOa_T1I0jgh04(|(K9iZCQD zFv%(_!0TZ6nT)!ssuxvult`k@9y*l93PJ~y0iG@PW*~Agdh0pU0IkFYN_+QQ!}mZ? zlo;|d)?7$*M`9p8uAOLeRAj86gQN4AkWg4KuO2k(;#}xZ@7_`6dU{q&7}3LO+SI9Q z8RO6m293d(ZNXi3s9l9`e0$?$p32Y7tK8f)Q1T+w*re8BQW{^&Q#Z+&p_%WtQ@Yo9 zx8N;nc0soiEMjUFT-Dw>?YzP`jM!xEIJX>xhQn7rHO2ko5f8op&Y1NwoE#U!GI8*V z3lV>T`mnpi?^m`8vKZ_d5=-_$70I|xu=d$sbzdGNPWomM2^WQQ1K*Q^mH`cL1d4uL zEv*Mn?lD#}HC4aX@A4$jNJu>65)kBPE(8V?M?@lH6-lcEV=3WFXAq$Xk@hIf7xWF{ zcucmmw8RhR`BaHjSydGt@hF?tbCC$1vKvl7{qdUKRw?8af`3fv!7V0wT4f#Tx213S zE&+Onkl8td!)9Fyx zqXl{X^5xltgzW111a;b0cF`w&3F+9W-3b7$h}? z6b>=`0sCE_D=P(bU0+|{XZp$Befq3bN%(4QF##4h7BjaC3L>-r^pi-W0=g!)=^?SS zW78r$Z0N|ar}!++I!b!i0ZCC#Gq0y>3g!4sWC<7mPOqGAF7xA1StJ1<3&1x$F57YiIT%A-tjwGznSB=z>vrO#Updvae8 zu#tF5Zr;Dj+z`h+q|B8Moy))ZFxG)gyZ`q-HIOYkdwcwAghi9@+BPy)98-3G37vFjaog);$yO4mjZVFq6D%?C*cQ1q(eq;j$sDIa1wlQW2Y z`A#M4`|f@DX8~Ia6-%V9;G~KGJ$Mw8pldKhVU@7pK(ST*8qGuf{nQ?b^^-n`9lR8( zB#7UC{&@EMExe*nOp6`<17L$kb&V3zeW6Ui3kK9cBQS_I&~!H4^5%t#B;fT?rB|yW z50~~O&ps7!Td19cw-HwZ-kjr#vXK;TY;s_}4z`q})7Qhxi^(|VS|LrCm=o>wpRv6_ zOAiO}3XHOcyq_@4SVJp(+l6Jxuv51kP{>OtbmLg}88|T4TqU!Ss#$lWk8$40tp!Vt zQ|o3AKU21R)vB>7HWUXnmOge+J@4I;^q@X0kG6AVv6z}^nOfb zsFIHPv%l|Q)jhD<44T^cay{XkGd4QckdOjTg(Z;{76hxW}arFe~gMG zLDFX3BoG3s&RT}FB?)eW%6mf3l(vDZWZK+jk8?zB?%lhC(z_~1^iKo!1bn4lhs-mh zFVclGkyGE@0qWs&&{& zbn9|_2pe7S6l~#cQp>&x26s(^OIG2}p?6m%u2|$gyh0mVd!1Nk6 zA+Rf9$n40m)&&muyYd-ZF6IHt#MzrHdC&=XjjtnI83yl)4rsUQ|8W7#*RA*> zw@Q@fPO_v&`HR?RpFN8^{cto$K$I>s`u+sql@BsAH_x&y8J+g3kCOc5@-N1PFcqFZ zXEpbLfdeh_rnlEHx!k8%Ol_htdid)LNw55UegO}@a6%g<^YyuahESR2EhY5 z6YT6V%~`y+RJ{5~T<69;y#tpl_@}vao>0R>Xp4?!vtG9OKGjqB^3|vW1OQ_rrg0s- zp?E3qfQ<@kO2dDjFLkoaV(Rj<_SGI~-bpjd-8Uu8PD z%Ecx6(4kT9ZQNc$74wDR=x+Nk3>^mj(Ybu9`q`?{o$F4MWcWS*naS^+uprf4bK=mT zr z8Jn1VZv9LIU3A0e_OB|(sZ)gq6-gK@kBy_i;!1IySxr=_4r>RVK6J z^3~lXao|VuuCK4fjl^e^s#3@Zzb2DrxeiV55Z+&6dePU&h;|}s&z|=l1KI=z3@G+* ztkdb`?GZ>XijxNs1!yFBS6kMLiy#_Cal{XOZNP^~Qa|YKC=JF%=&r(9n!unGKJGfU z8q`KoAk@jcaLAQ}j$k9f$!2 zx7c!*g(tDeD13V}eY&L|IPj7CLI37f#rQ@=*@+|zk}&NO*W>_93ue_^vvf6CN!D`k zf^5_MXzpp?eDxYGmasVf9iAI|(;3!KTO%XpOQ#J!T7Y=yBw`GDXWY{S0Aef=CuuT| z3{YED0OhK`dWMV~YZ#3J1A92O7wRexJmm+qEc?&I%x)ufFCrTzSO5p`j2QhWIbWJiXpzZ&c&49_uf@a znKsTWTuE&EUxfwUH|d_I_^MC_$!8j2vApxzT2zlM_`I1;t3p19 zIdjoDS=Nw=6%wr-273VJHm&(fj{;a-x=P99RzwE2HQyFbyD`l(U{RCJWu|5RaE?yKqnuhyx#_+ zuXNIBQ#O$|gMbZ5I*sE(Fa#iIrf*o#G9?}USvKbeya+HnfRI3kjz8uSksTZ&s5p#G z+S5Ybc3sF~I4&38`@hl8_@W32DU3AZ5>B7i(9&uGHBsEqSi{R^=F1-lbErA5li%J% zt3P@ujPUpvHam?u6}#<@lafFY-aKU*4$`knhxhl|PdEj1dyExW;9qNAv4W>o6JtaQLvGaMH^CZ9Tb)C2ynKy9cGn6Fak zfr!gQte*vO5~(WrA6WG3;!Wj)mOn9I5Ad5e%O#TdHsWwi*|nzTB$IFX?yl)!))@YwszRMP62Cr_wBp-RVs7y(Wa&ibdkId0{{FQK7)Gw9AqZd zwlsaLk2#Ws!BpDL2Y1>TfahMMk_VT@{D24X{y`Ea!psar<-oV)AnZ^o`P&KL%*9xz z)%9~8eLT1YrkGS59oA2VK=DU)NELyH)Jm<0+WQQx3D^)d9cRV|RUO`W)IhNZ4<>|n zciemM;Pu6K+i?ci3d1ih92Sc)A6bq)ZH)W-g^ydw>HM&N5#X8q+w?v2m@%?TFUP)m z6@_fQGBpxYEU?17pOF$3AGrBYFtRN!QnPbpp^L%V+xY&T>Oy-a+y!In0JPm+Y|PZ9 zb;jN5-y-H1ajI1`%<>*iV)EXB@P!RE8Z!VjBu3EC{`RMp9z1y3m@&cgmMcl2`WAM| zi*?$TDKlB%I0Aq1Y zP_G^u+aEu63}GIIPmk{oYHg|+2(m$kf6M1v*29N2Ol0yFy(%bhTDGhazkS&%R+RA1 z^vu1e22bZt=L6Jtki^;;sGYKp1qqu1-5+;j#P6pjgu!QkdqQJGg63!Y_Ip&Gq{Q@@ z7Jimw9O6582xSfMS4NSB9e9n+;`xP#J?TFh*@!dv{c_}pB#HWS17KoSl$T3&Rt`9N zfZ+!E!D~~tT}PbE!lVa3oi*Y4C5ok3xGiy-%L;R^k;PbO!idc{?OeMUasg(s42f<+ z$9Fu{HsEW(&+`&_fp3B+(e`>hYU4BymdyP5+ClnX{r|JXY7myY(>CxpygPh-eKAbL z28x&suEW<%Ex|myV5VJC)*(;pD_MtrU+b=o$H<4(0^kFRg7uQ&^R10lBwI=Ltq4MA zggr$atQp02iT@^gDnRg1usk%*(t9+`{l=V-y#5*%B<&c)meCccOggKpo3hA9N9PcX zA0(do@@m@Jc~6CqnD(9)+5c;qFs=5ht>9ApFh{q04@v>WQpm_!l0LD+ZTt?VAbd5- zP^Q9x26Ra@Tg?Btj`-V$T@Qvt5dNc!iD|*x`NyZ7;Tr=c+=!8Hj_KH?i`?GQ;U)m! zl>4-Igr7tgDT$(dYNCZ?wx0SrBJu7nE9@=nUDQVMd3d*5g>eE(cr>gpQSbr_xXh5X@s z3b%uDTyaG3a1hcdnaGZW7%mO?9CgpqmJ#o0Qx}kuV}NEk;F?Exh*yb0J{vc}Cq3#t zN1`&4BMT$c|L?aDfWuImYY>f`ob<0g?^5yY7cbK3`)Dip=`GGov_-8m_19Q1s_D}& zXJj1evNdVT4tO5dqz2$bbMD-~Nq)AlrI+6+VEfcm2rR}w?yDPP6%Fo4?)LJ!W41Y|?74NF{z%(|!n9Wko|f>>jf~vM z!SnS>pbxh=fc!zO0FQ}$+#RkpWQ#5Fe-;UDn`1G-_%Mpc;^C2XQr3%G zTbg+V^|pqS4%|5(bd9HuMOWE_DT(H5-`O1LLF?f6a)`%H;FTbK-bB*9Lt|(!wc%&+ z;AYI|BubiX3QWRO+Ci7*Uq=G_`n68q+_i!*1E|K!o;|xujpMju00pYBXEHoF$Q^sGPPNwMyqF9_9FCZZyS}<5LeOKiT za>m4pPX?(o+o_7N7}Eyz3}2~$qtq7oNY!|HKr)Jp`269+PfA9LThGy*e38X*q5o(@ zq+dK`ipq;BWC=8eLe({KVntJ#b=zi*UAPyjscoG2Razp`_1|ORJmR;8p+W0BhfKA0 zTZ1l~#rkH;ye`tf#+tEnW*9#~4UDgo?6#AWHY9I%lvl`a*BBS4z0jeXq2cpe6}_)g zYwQRO{W;nISHRgv4jMZPwj_+q!VoGhLP32GYR6wpGBa+mfKSK+;7Tdxgl*sci#tLe z3=N7|4K&I|x~{TV#{OMR-Eo>(I?!jcZTG0{Hr*>cVSDh~c%&h{3?$o*Kp~5crpQzE zTb{^p5nQIF7YF*HWAZz0HzW_;|K4*DQKo$k(c7#aWmg&&GZq(;YX5w9@@~ek!Rhh~ z-s|erJy|8lkiU6zz3iZ$mLQ^oHa|m zMkUj37>f(=$4E@j&`9*C>fUWmIon<~R6pypFn_VTd*0LLG4&RPkNsVRjl2u+v8XV1k$V)q)#(KccQpj7MRMyXx*mH#$(t*qEMwI z(Ki67Tgr$tE?t3Q$JRLU4*P^I20K<1%7?)%b|DxLR%1#dBL?Ah=r4)m@DSL zDu{J)aw=$@nF5Caq2-6B`Fs~NYpa(p58QSn4iiX#m0wtj{@+f(M@hsMGngXSH2q_W zDE-_%+$Mesb2$~qH;+~JPVl46dOkHk)s|(rjXm$Ze%(wU=!-;Xbds)vl7tzni1|DdJJSoO+OwiiRl zFZ{N!UM$zJ06RMu-%hQvu_ut$*TE_hGaGKWok3#&e^x~XCID^ze7!}2yPdFV zA~(}1S0ZVnES^9b^Zq+3W83U)Jnq;T3Ec)m|wiVc_p9e4E%h<3TOS=C9}NqiDR4;nXzYOIG5xiS zq(6!8cd5{@KjWvjZYEky7Eke$cfF9O)9v3}Lf+}PcnnXUjuH9WgIycQ3$OyBsz?nS zgvcb^Qp$UP>h2GgrL{&p-3v*x9p9H5YF+j3&Yx zRr~-}1b{H0`z%&qPtZd`jHWVM@>IHZ?H4!P8$J+OXYhtgp`qh()q_~bL}7zgXGyjb z5?oFLnYt9Q2sI#^(8@i~BFYEVzd1qP+Q{OlKxsKJ`cM0>DZ3?gjiU&qR3&xOttrpG zCB0tp*XjxE(yi%O?qOEnGM}}Q#(y(9y0a&vb^{~wA=azkNF+WoY911KVV>jH+QM!l z(V$^E)<_)VZ=rVKB*8ngnLc}VuDOiyw7(D*GPWK>&ZRffCkfj``T_TZ#foZm^9>9X z8lBH=Z6>y2&HpAGJ2d+E2X|-Y<4egFbSo9uIUhf|EuHl!qU*2$y?eVQU4ID&C1FjV znFgg7@cgWV&JyAR5y1JA8tg(a?ytRdCEFe`i2S2RV!m7PjY=9C0ea1UO9xSXiG^nO zq%etO28A3VJ$(a7dHSizcW)?qw{9V!nMb6SGxEka5w3>SttF4~QlzggqlcoPq*IVc zl&x?>37p9g3Q^5Jc~#P`u_{L&z9J&G^KGkf5TTe?dr5EP>AZwDA#gS{WV4UMC!@fb z-`zmLoByS}BxMkzXO8dT$+uryct95>q00wpkMzOhb>Dq!l=ll^zetaUk%^deKF`!= z3l%eJh$OA^5`p)1oo#i*Q(rP*(aqAw>Qo$W*Dj+p& zC_KJrLvw5W(TS%vNJZoV;%iz(iVc=-?c(26S5MGaA@Y10v4dQycsyL9;)tdL)R~#g zjh0OV6v=An%cz6ldM6<&h>nc>T3>$$le+E&``sDA(|~3hYZ%7&D}_6gtYo7iKR#>0 z`0>lh?TYQ@h{KTsb znxeho=RiPZgfUhIz*S3b;lif?4T(x(dW+mWrwTIwB;ccbz6KQCPCwzF!h$e`Cv z5%VB4ZdoTUabb?exxh{)X1J$ekiJZta;O{BiH^BLx6rA9l&GpkL0xgy*{N^YXd<7z zZ$B$c7@i^X__lfnD)mb#BcoryLgRXTx_W-fnP;?aP|KLUEg_0?bZsW~qE3n}y3Hxj zoIexS3OoQw_)s2r(F?*uQ zaH?UUA3rX$HzCd1ZdO`?yiA)f=8h01lxI!S=!f+jL@!Pt5FM>KKcHt!>kp0gYXZ;X z{9QmJjGra`i--nxhJRyJE}Qs%SDnGpDZPVdI#53D3J-@9?Cdga^Xvr+{1`*cy2vJ; z;8|ZSjkSmW=gL+W-ZX=p0S5+kVbp43VxwX(WJvUhc>M7YG?{|gUQv<7&wNgr8hA`^A^aOM!#~_J3Pr0o@a>}guMuo-H0l6TyK_@LoY1XNo-7+HU z;alycFT<5CCng%z??gGnWD{9UQ=4}@6aIAq_{jg>%LiIIx%@@htr%lMLiG3XNh3oB zA65Y(1TM+i@U{_@irUy{L3cok73XG3#tArqx>>mSLF)aensU}2)C1TP8st8sIYFy$ zYVO{@e>Qttg~vhN>v?b}n9^xfDT-ZocX3Xlq$x_{O_k7Wr5RrOc> zXF$#_2$i87&H5tm|4R+(X+UvD9wELh2?aB*$W@xv93CFOVhu1+tA>Kcg4IihDY<_|+ zruOPvrosSVyG%dOR3e-BY{91SImpA{J77z|v~ptvz836XUaL_JdI{&nR}Y>ii37x$ zhi_=>h}*GVhRoV7dnZi79r*iq)>jut76rnK2l3k0bAV)9K6na}q?0U?U=YH8QCk0! zL;I)87`-rzB3aGlbkUk_3~pZ8>QQx2lz}5qRUcDs{9KZqwru(Q`K3<%2c)%acEk@Q zYlT$50zIV=PeC(dvFyqJ3!RjTrOq-F7>F>gAw1a5^&UEUFCG`T<1)*D{y?oi52ts=6=4#|D{ zww2=tn0sKzvR#3Jw}BNtdGDt~}0!e9&Y3f`LO`<~!9^A(R; z@B|rZG3YQnS1z4H@d$J0MM;S!OUmIXNmgfBjd7L8utMYy#Y!`en5&!BwD>W|Cchqj z6XJ6F7-Oj#k6(GbT_Mn2*GVG$ItbK`wzm_3pD1H29URusMT$-nfi?>ahEcntrglOh zj8Xx{Z__eM?k|u-h`!yIcWWt!Qtp1_K=C>M#N7hNeA9Xi7;+&p-4CrzEKp+r(QG}O zS_OZf$`2oefn8A4+M!)l(=Q@!E1f00JN`Irtnh+YCZmsp08=e44il};TxELn4mq|Op4I))*) zraObwe||JnpYoZif^RR_X&A9XS%Z>k6z&1W(G)@+Xl1JM@r(cb>+2t3G}L^+-tbFl z`VX2w=?mk<)))RyMTQC4@|7$9v^3+a8^oo1__p&nkS2aCHvI}%r!R4Grx_%XEvvAm zt0iRRC^S;ZLLh}9by>5t^={5mtNJek9pIbe;>4?f81v*sN9oT~r%&%{v3V0+2NH&B zfU5cuL1k)lEIoZV0XZc5_NB$Et$bfN&YO4nkc#S3%8{h9wqIv2>6YShcK2?z=YjI_ zc4DvO&GjR3U%jMBsC->KDGWdlb%6)&EoT4yZz=@b8?|_LhESV3)vOl=x6@PoqlW_&<)FN z_6TB4;8dY1X(N5fP9ndZH-XCt^F%5zCrWz(>M_OUlYX=ak*-L_muDl(7B!xaC=WD<6d z!1$j_(=WFw2txFvNgc4=%*#u}&8V(UsB0-uo8I;qzUh~7=>pk+TMYip*@f$uj)_6@ zt`kxe1X1(+REr(UH{+!aoPHtiaR65XQ4m;S#m|-i7>W~EcGIcd5{CIbiIgYdR`c9(03R_Mb*oT}n!!aWs)fxWl}B zscz($`D81}gSHisj}Jo^A0M+=`^u?Xf=TwQ_SCH$A0qWq$uH?;dol~(hmV11PjOl` z^(Clr&x_VF5|38^FlaaLIp4pIqrjleJx>+7(HOmV-LcR;(c{##Gj8Ad9mXsPjWPKS z)zu46g;1)Cj`CaT>%CHnhD!q8if-KME0M16UZ^s(6WrpUqs)-{^=r?m)mk+fJT-H% zvolJBZR_NX(3n8%=g=&^Ic2C5V1yq=71|-$d~6OWxEJ<`Q_L)h;~7Xv2`sZD2P0=|$Ca5LMneLI9rPHTYOq)D}Pb;!zsuUv=&C#I^9 zS5!n08Xz@wY9X@i4mG_UB}6sg(E8q;Caej*i5UVSMtVwqe@bZ2AbmP6CXX$<85mMY zrk_9GA=u+jwTl~=h?k2usPK|$10P5ix#vi8_V;sw}xU{c0^#TvMPraGB!{V z^C&Vxy#t#Vk1a~Ns_~XRD&pC!c-9*ZCFL|zPbRC*F;mMhGo#eyQ9OV4%<0vrwvx+F|fpI*KceX*>f_m>WjRCFZ@!ja2X+9J`5%<;}P=!jh5T@+YnbFd<$Q)^$5^ zw@QNWWNL~l{lI?xFatWVCM-`E!iB6tBLWAd;aTLk2<_onzqA{!xhXn`y~1#6corlV zhE11VC}I|C+o;;UZ_f>`s$Pkjw2 z0HY*We1HQ$XS@sJ-%UO6snEaYv{$7Cze&i>Pg@nbCLLGSjTkm$NXL6xjS_hc9wj|3 z)7<~H!jHS8Q<~m{ewuGJQg;nA%769bw4D7<-BOUzx|6GmAryfeq>ug{fY^fmgFMHM z1j_Yo%ckAtQ0*t6A3XSn;Y;xb1<9h|gOQT2S1Cs_zpt+&99pZmJ~=)<$v)VVQF#_H zWg@>upkXR1Bv2!u{;#*U?JO8+c;IQL|M=(Sjfek(cEZwt-h3VuUjK)t^A5pcYzdW0DGHSmMOH#qQE3R3k_eTAL?k1XLL@4)LhAQA@9*#N z*Ymv}>blPJGmhiE4rot$Wqh3U>jbAy*rfVSu}SaW&%>O~e|{w{JjXm&F8P@?$3d`N zB#0HZrfcgdD@*XHzPuW5;D;EF@jsCsQzuM-2FLRH^19C@Ue3E>&XilA1CI*o$qUWl zNaU9Rb;C({daRaY#`V^}eX53Zp9aIZhA8KAPcWEb{E8xR($v`jEerv-bDcAXJiJe`^=@~lMuea5sd}jF0h|%Sct0?IvO*7zpLgP=m zAusozPdE`PsVK>KVYqG)8FSBbb#uHP-u{c{3KlB_t*%;y399|8l!`C3EBGauO~72S z=afY4f>-!!8t>gA$qKFmjz^QdYo$?6qWMg{O(D=4tVxD1MO=rz zR0jXb>e1g3aJ`7ugL!+6Kj_R!N3j1>hWnOcjNJjKEg;V#-7nd%9rD0IfSz%YrcERvL4t~vN7o9E=m0Luz+2<-=zlPKd^;Q_ve;q%f+doC+3ww1Y z;ie3{$=7QW224^K-(Nj3^j*y8622NO=JAJFNG(0Ufw!eMBHaPsm8S7zxGFVlZf-7d zRbZZ2Hkm5-apo`-7%uNuzh3xXp+<(QXU8pt7~U>(%&`dI_z_s}mqNeWrkHc1sb(VCNS%|%m@eG z-)(gBjV4h#7iUd6W_a2iDhEvzJavJ#d<1C?B0MnE@yO_`h0OSjUaI{;)Ds zwL>~C_s335>f^eN8$W(lb{rN)nT1;Ih*?NNrReK8lqI*1LZkA{a7;CCpLKismDfGF z!Gu0T;|OZtD*GZkwhtpnY4*re8VTlS$(SSV0p{P)`OBGPZ&HrVQ>chY;++VJ4OEAe zAw*y-;+DlfU2%EEPW`dz@7zQDsADL2vj;E(qHPe1@z}C>4rLCSmsM5ds-K`3Lezyx zotq9-9zgd^Od`-IKgVSu?_$^n4dWNha!;Eu|c&e-Ge{ic+9ZbO4`4 z%i!5#Etz_daQVh5d-y0g25=nWhIoB)UZ;wKW%|_jta$ZG@jr8p@O;@>;a_p+tU02 zBbWc%ko3cZ$e>%d^p4LPari#8_Q{EB%-r0@{&@!e@#*R;rgop}kt2i!7u15S3>`L% zHA~hmE#LRrJyDCPY1Mi&kj+Y^`O!+l`STx9{F}w!y>o|tT@;`U(GbuHRsir^<30@y z2j|Ejs5j{#rGWzvo2UuL3hx6_#aEY*$6JpV0f#UFWZ0$nq`v>SabTs6Uxvk7AZRY!q0XH zWT;2Sj2R<@e)*9PTmJOvcThqrjUzWV{s2`0!$e;((mYy7jBOcwh7OgzG23OdXYW1S z=fNsGssX}_VW;X2W^FyGs0b6To+zOJ??5`j)B(0T9e9ZMm@YwP@gN&RrAdv5pdLR* zSw3$B!5VVMyr5+D=%K&Pk$8z`RoP9j<0!CEwQC?+dagx(lS4K#S##d%-d^7)y)W;CIH!jT< zJpiywZX#+{uJUVFE8l`a@x1@1QzVGhcYu;l>=R~~EmBtyUIzs`d<7ij|3@gt2#Bu# z2YPw-iF6R`Ih9ilo%4nb8?d=p3QT9;Jj^1YD)$htNa+OLnrSROi6R$qQD;&0Hc2B7 z@1EkfUMJ2yT5TX^Y$3l;Vbz6~qg#~x)J9BLzcPG6)}6$K{*(7;wj470ai_O}&J=|` zDlhf79@bFq`_ggq$A9iaS|87~>$lly?dI0@nRySZjt|RkdU$-(`2b%N~@z`DE$|jN(YyX+;e@2l-f?kZ8Gt&BIKSjkog)774 zF3t=2i}wi-;XV&AW<4((NS-q~rb)qN%3o|ESSvPqZ$wiUUigRd1P=YSQ^uMNPg1JR z{*;rG16}A6s4xC}+zL6}bN`TMu?D<~x`>Janz&u2!6WqyJB}Ll-op$Z zWmU-H^5@6ou9iq7PbPht>J>b2)3iZ3t6~wXB*iS2X~i6ZUx_TDT}}E{ABB({>r~)> z3@~LJq>L$`X5>^i`7-GQwgsGv6y@x(nP-}tn?dl}IfhB|-hE+_N?q?J_HduiK6mve5s@g^Cx)A5te>ms}deR^|5Hx{o+Hk(AJCN_Nf+PQOnP zA%+Ls&j(o#uk8H$rjsz%C(05%&=!7i)g3;(j@UPdGQfO7mMp(-VG4;0q8fBkQOqNh zM+QnaMCSM3@5SRNSOB&z`hQhw+WIUlSSO-~D5gJ;WyHK=`s*}J$TeYEGQNpG^a?M( zGE-e{^YrS84T)gj4r8aH?jYQ($#(J_43mcS)F01ETDyoW#Dwp47`GXfJOwq8Z8@u+ z4C2>XCS9QstjM}KB%bAdpz{0X-~)8Z$@yZ9P6WaLtq~V~tVv%T@y#yzpy3nl#q;i9 z?sH}>Kfuo;Z-oGk9ly$Lx*B-ZNDFSY7=xX(&-PVw(^hudIjhDb~p-`hAzUF z=#gX<_HkTKrSSo2qo1WH2dO{-?pl7$%CcA2Sd;u*yTG2yCyR+omMZVo&=1j3 z{HhUo!2QJ%4pHhKW!q2-wceU`=|&wI2{hgm5>%Y9WEcrH^4Z)^D$mabIb-_Q=C&Ky zbaHldcI@soj7nI2MmR!BdZaJ*Jx1H#)zn6xrrq*T@rvwYxBU?jQD*VN*04|jhOrpP zdmKv&($uNV6`7-}(wrl>_vywtg^x|vKg-g_ag<19n(?bzy^UTeuDxWeg zHb;D+M4-L}(LU$T7k&KkDZ+Tu?!uL6whwU%>JF|-vlu&ldVjr43C(|u?r7Y0AJhaP zhGPFw3bIpOUY5qs?dMf6}qf^+h)*#5hyqB$4PiHwQ*ui>h9QPo6An z$%N|q>7W6L2JlBAkG;*7nLCfV1?N-OA6{dLB2=sSRXVZ z@89Z}8>bwWlrQ)I66zIt+W~y8=;+w6&$lZwR;EoO0hs0YlH|7!I&>Q>%&@p8C$c|Tq z2us%Hf~~>g$QUiE*#1*ol&Tgc%1w4Z-{q0xTipaF?tC;NXLV#}zs~VaY3~?cvUl)| zoPv*kn6O#-<`YODDOUUTm2gQ3i{pIb-qWX-f}%pTK#TL5sDlxYs&(GVBm?EDxwyzV z8FgmX=iHQBRAH+Xt;`QMM~m4A*TA}$8C|#HaWA`lTZQ#5z92zNbR~e>tU=6YV{>`R zQD)x>i|+mV)dx+ucUO~FFMMAWd0Z3UeRXl@waT@CH)qAe1hsXWdFFAgI~nD_fU6D- z8ScD~^NmORDZ((`Jzu$6>|Xqg9+mJ9j8@n8QP|70xfO11GYKEU8He!uZSFgqkLVii zYx^OohfJKkSBV*{f9W}{j_D5ONrlvT?EodA2HH<q88LKQjPXETW>ot z>Q!_P3W9UvnLd;Wy7dz!bRScB5(>KIy&k;2PwtbMd@zXm(8d!~jMXmWG@F{gIMO9@ z0C~35<-Ag>EnB7s$@-+%249b|$}Uq58i0yhaQlNP2{hr)`ZP8MpFc}7!*(eqa(9)c69tWLkf%0 z?Ae$#+A!Fv&47F_tGv1G#M5{5X4A%wl{;TGYDO>3uP0q>-vv7m>O>=o5V}E2QY4D2 zdCDM>ntwdfWekjC0`JO|hQh8*NEk7Cba-(c(j?!Se>&FwU!h0s(<-DE_!Cy(j-`S607zY%>T%{=%)>+nGa6W+w; zLB;6p&C;GwRqHIxfE~PKLaEL3!3hwr!-yk4PHWM;k$uAfZ^Go6Ce@QS7fJ1J8gGeo z)%N&dp~3)P8g6EuZ8J5Cz;;Y$~ zH12{9;z8EOj~|IfU3~D!{3B|8!|T>EKdj;*Dp*=_i;r>L5dtHd4pLEAH$qZ@#!fHT z!rx!_XOUFEZ=t0r1IT0M9*pHW_g-B!zy2EX^RTK7ohfD&WKpchq3@{pPdL?4@fS-@ zq@!KEE3u=ps>;Ko9_=uBXmt$@51cZD_)d~EX3b*eix&NTgtFc1KdT6^3ol&Bs2Ifg z!eLagsP-b$#_Q`%d=%Dyp+o{59D-^eJq!o=vlN?g)2p2H{XDK!Mmbi9M9mCL%!M7x zIcMRQozne+ufbRZsG+v~N zq&hn4RSP!}`wEHU+>B?6;e|t`4Ih1jsKN1QwE5XX1~RezT?mP8zWAOAYRra)tbM-g zebT{$y{c3bb8#U!!0Txod8)iS;rQfrmK1L29w8>S=puSr%;@PV15Wb%f&xlW`}x1k;m=s|49^sOR*q(Xoclr&-A$!|sNOLcknY!Kg5 zsw0m)1pTa24zO=s0&hdne@hQfn6#M^&5wjhC)Y}eE@H=3lQW=H8yeP2?8t&#&_>bn z=rZ9jt-K8IA0X}PBrDsmYvmZL={tG}vk_vL;#1-@>xld{K0I*+bokWa)QX;T-7LiFz%Vq{LDX)I5vLS{!9D_Yf)DF?Av6*}JpV;+Kq4J1> zCKOmmwYtqceE^#y-v;G3rK;;^NtuAH0vNov1#>sJEAImMjYHsriu7BGegByNTK6@N z)^}ANAur8Op;ICTB&BWg<{%YLkTrbizf;DHx$x>3UNgX#r(M=aLY{&qg5~l9Ik73( zB{!~3v*kul{a{4OH&<4i?*tre5EaL$1n@_9@6n@|ApjS{nXp!^OnJw~V(nJP?%1~k zSO66&GN8bzww`IW7r;RAz5rU6DtF6d(INi&6w$@v9Y;5wU$w7$H%hU;xS#n)Lg^-rYp?2YE(r z3!u;U-~KrTPX-ah24==fn6;~WV7OlI8QcCm0|G8CPT|N2yM-dG9%V?n*AL2EVuDTgzRr(&o!8L7qVr^C1!x#*Z>jD|IK-ZQ$)x%(**@_* z8T*!F`u^~}kuXrWEjW;}v^NH*NT)6-XB_K&nhQ1#f4qv$E<_%_KtA}^tsPVp^|Tk9 zE!;WfSx0(aA#?C9uZg1PO#?F+93}hiJsKGq7avc;QAXWGavFrORKBj8L;*wZtekM> z@qYzqU}6eo!2b$R;^2k)pUadhaK5>D>V*qd?o|Y`G~^j-i^kiqM={;EwCr-xxdzD| zBHvJ*tFxNR^Weci`Ss0lAe=8aDMEMcdb^SORqyYY3@66{fShx!5B!Xtx^XE|G!j0d zy(QLUyrPG&&vswI+#+zL(9j~XG@_@xo`3<=%S%WP@bmMUOhiU7#m~(XrtxGFtB6dE z46K;yY%R6H{4*qS(K%f2eBUW~H(_y8Yet9sWvN0i3jBDTx<2(X4b(7(jSI4e2`DVG$akMU?YV{Vww9YQTCT>keEZD4jKiYK z1`}31d4wU9bl;g!N8CM-Ii8=M#?xuBaG9=TJ@Xi25Od0(u1a0MX1;vaM^T0wt)F6H zRSCv%^hqvQ12KspSng&dzR&0Vy@M1DS1Nf?k6yZ2F}-8`h8OsA=n@zA?=EV9=6i5k zrj@*9+mxLS92v8v3yX@TPMPu)fGWmYSo^Vbywt70m&}Q%k1#&B+Q~__YY?arsUt#l z00hpXg6{fkn|nDT;t?ND<8KSbJ@eM&zYblY$~g%x-Tag6c-6}?lA&qiFVwbx)m&T=)wB>de{xResB zQy&$5V-jv_X|o~rT>LPXZGZSspW9mSb9wg*FO==s)24O7Vv!Y=%DqkU&yJztVGHZ4 zEdMevA)2lj1EQjI*UM4eMSF!%0i^~?iTbLH4f;cMlNRPmgo5mloP#1!7Ust?lMG_8@ zIB~G(S+wn#1f8zGcCA&MWz+vDXID2>1rRkK6;Z%*0bd(I`se+U65f5tjq%rL(U;xY zzAxrXcM0w1w{r#7t@!4A(&TfLs=(i0xp@D1NGuULs2#{Wab0tnY5NNZVlY7u%3ESp zgAW7-8l=3Yl(;{m*D3?O{$bAU`NFW4@V=Vsv+}!^O5$wC8oRNj24L{;{Y61?gQgK3 zQue$W<)P1~r^ZLViDGWXtO-5z^`8r6bi3O9y3e0e&YwSulgYtho)3qGb>gD$T||w6 z#jmM|W0zlF8xteYbh{*hX*m6a3dS&Yyq?~ff?A{v8k)V51;(Wsye+qEtf>i30ch^BSRmR z07-x>l1n+JUH_S(IPx}L+2m@(GDZcN{6GOd_dvqrQ$h`LzrYf(GDmwB@L z4vq>q;wv;s)Lm4ciaD~*86eOg?PsQMk{p@j$AaK3qGH|g{rKNDC6 zRO6W%@5J;QFF0P$LTtsi_L4f=vU=`$p+L&}6hy&sd$_Eq`+o%v%|Q}eHh&&G5O5%T zTSECSJ*w=D_!ZepJD+))PdBE{grGvO;QX~F4+iDaMW@t(WIwZky~qVY0yw&lX8cUR z9AQlBh40nqV-K1zqRq_h&v!s~*G8s64F6^{4}E8tGYBK~nWWsH?Dgfz6!K(~o?jO_ zI_8uhu4SK)xh|nPnO-Bf)aT7MAAV)li0)4=qSfRrc}lvF(F{lg4VWAzEz+7qidNQ= zuYsFCftnbqYiTKt2s=pe^dK(}1cE^;?cKK@9$SY~Q27N>RB;EChJN1lxaf1w(^Kf?*J)7hB( zZCr+~xdp4&tl?1hTu`JBD%I71D2fBql*N`0IN<&!ea+mA7HiRRNNLI|o8m@bJ)vsL z7^Az1mO=;wY*wCv;u83hAPeJ&`!9El5v`_PzP4J%C&|jpXUqU(|L4I&x*F8jeHV#7 z1pJ*RQZmvw0uyxBXHkJ@50_5YE`cE-5?*&lo|^b?^<^-&${SlUgxBpuGCg7FF|Pz* zd;H~IJHVc6Ol{F=Y?K={MA#QJojE~A>qsYVZ??d6O_o`Zs9_1{nx z_g&*8MYE7bjo&mg9$0Z=>Ec~pIIvMTq4f0(a}tS?g%K)BT`z5Z+uYoi`HFTnx=?0K$>wT-C$&zvaM}x7@cY5?Q{8Pkq+Tay zJud=+HQ&)e5X>}`aquV0a<>ley=Ob2VRQ!mEw9#E1;?3j`YSusUQ7s2=)fl@fL2ut zMG3EIDpOwn_U{0iKkhFhoQ51Dw|tIqU!%UFC14^5AR~D&xWfDe`|Xa-DmsHtCJ2G} zM~nK76J7CecTc={F+oSxeAs6V@szj&7x}c(s`VP;|9is;h#Jry50X1yes_R=e;oC! z5!UcShq8I8wcj^W|66WdfzS`A7vx6k?`U;RP1otZ_YSC1oUNL_p6RZ~E5+Y#pBQ)P zSQzhm+t)lP&8vUg+9s!(cf1WBcY5YFf;&${M*b|B`sS;zF4rJJAq_*z;V0cgWqmYi zg0EL-&JwsNI#2;{5g*|$N)|w(!otj)4Yvctc-4zMbQ>8qG)!Vn`l~NoIzpSmA1y6! zyr1T+cZ-VNT~mR79-(I@s{iozZO}Lmu|0GN6miu1_F3Uw%^IGZlL{>`H8&42b`~v% z2N%Ds0Dp@_6NPue*=@m51$B*RULTr1TECZ5HO@i2HA>sNLGalojP76a(|ImWZq59C zdqE$rNySaBjgXIqBre`pGTyx(sidZqMBGC}gPAz?SnI7&WUB>;p@fU97(bdUZM?^IQts#Fn+=@(ky z;prJ<{Vr}*nk`t(O)YV?w?BSU=l9<89*9Mt5!wWX?Y07H`8f(+@uK>w#i!1nA6XUX zta8$QWN!BB{QS4{!08+9PnC~8XhOxbplQpIUVZw^Y7+Apd+t^Hw%+C^r=_j2InD)W z(UG!CPB~dDRmfqJhk=WYkZA>tHC!oir5MPMu-qk81TYr8A3K_Yr>$F%O3==of(Sm) zxEnrhdt2MxFC12+*-}3aoo*&_7K*`h=XUZ&t`Qy}FSMsrC4ue(#Lg=)y-e^ADa9gn z($iap`es>(s5dJRa|!~>L#Gua*`GWr5Cki$6;mBklFOqea-2iP#GSdiiitzl)^q^w zP!8)3-k&q`9S9Np*oGy!k3Rkg?J;mf=VA_r1ogp3dW9FVmmS73WBUNr&OW1|{1=xg z_WPbMBp+o%%J8WoS5@hiXzpD}zY7iJg0U-99fgFEpz*G%%!mC-gHN{5mx|03$2oL5 z7_Q&IU;%4%B(kP}5>Ax-wTN8GLmq4aa{{ z&>;eMB5zb?6h~qlE05usn0?9pA)6@6tty9oS)iq9F=tHQ4fMW1CDN)N6gE3Ui@y8t zVOPw(Q(YX!_8T|%FSWC9@v8_`=rJ&j_G|UTlyIX;w;m2m61Tc-uB0BVUHa2dmsXST zt-51iS~GEWwsbnoJadb15zqa5CIvkEb@*W3)fv*Nq>9jVhBcH;5F4Ak(rN6xs@kAs zzmh#&E1nJr*!&6)jQuS=2muV^HXgdN+VpS8_s9LU{&qw)#ITl3ZTH62h@YEE$`wwO z0J6!+$oxjA$b+CyAgY(yK<@#dS%Xi zr2;lH;jo3$#?#ZVdBDgA45BSnh@72gK2x=JzC`8X4?=E`-8)&4>)m(;#fq3+g2t4Y zGP_QXjO(+hp=FM3a>cMB!uA%wk9OsiVz(zgCKwP9Q zL^zZ#$a2t_6}`&&5S=7~C!j~W^9%K(_`Qg|#vUDQAGptIOG#nILWw%aD#%sY~nl?8T{c~T5S;TpQXTeoiARjc#}(YbKUOu~C!w&0la z3Kczj34@GP<~dAT)O9|SlAoi^qD8|#mw#w(zI1Oc=lfQNmrGm6itRJrgE$ z+u2bv!QSDcbJjI zS5u=-ro1F%DoCDAHbzJODMX9+vy1WbJUzd257b9=Nt|%dgp`WC;Gfp55kvHr7JgF~ zUT|AC1Vw=(nJL*6z5{(!N|9xVxw9kT6buhZ-D>O9eI z@H<^AK_3vB>@I@0)}HlDI(wj++h3V`<>%(~3@+tivxYtqbLc9RXwFeEp*A*a5qt(& zTD#7YH`=;Y+fewjVs8R1Y-W6;+-rV)b${`{H}l3I1ev~bi*7Y9O+C!$CXgx{WX)AO#Lv7j_4n>KF5jLFO+N;eU4CCGK#oa?t~oyq%PvkNFz>MI zi(|#A18RdYw`;eLH(g7?wQAL(|8#jU%OYnTu5bMexB=B*aNYSnDg(d<60@?N(*nq> z$&Z$L6X>()F3Is4Wt?}Vkn;q%GHwX<)YaYn z>l$?jj~hBPpQ`ZeSwj{1Qf0a66hyta)&uPyBpQeK&7QrB5nwc@vjExpoYdVS4Aa)U zieS<8&COFk?JVANUYcYqonX$0JG3-VnbxfWfd1)EN^1VbthRkejTqpUdhtsa{UW3k zII6B?XWz@JnOh0eL=Y0v{8udr;XMK((!d5LOc3VRYiOL+>Dwc?Pd87uXew_pUTZy; zirpj2F!%4{c9xI4x@eBZ5xTN;+c9hmvjt?sMhXx^aUG&M5@5W5vpm-5`;UV5;1cc|zJ@o>C1c{ahL*2Onl8M%b+G6wX z?`x)y!}R-u(c84$6$6%&jk7Wh^~XKUHEYsrktq%R7NCCu_;il3F(r#uRXvHBE7QmU zSkrCr^6uAk7x_@g)mN1aP&vv49$pA!5ZE$DR2m*@vt8u82P!Sr!kHTUKT3Xp^s<85 z&(rlUBKBhiV{r*OJrbxxaF;J*1f4^+du-}K67>tkx`h0r|Sn!`7jeC>+zmJROzs z<1JQoM0D+9z}|r$zF^-=yVVU;y+Yoz@o-5)@K7W-xThVe&>q2tlVsBMdWhOiLj^&llB zlcp7cSuBAZj}M#!%@0NsYay+-R8%hj zw)Mg1x00M(ro3B{G$%me6&bI-`|a2nLFLusZ2FmblX%(#&{=eBMTp^<{GO#pC7zmY zXc*SJX>YRo9O-RzUFmhdo+-O+5Y;s*EDR6!Bi)2&MJKIaM!EUu#MA|k0?0d5p60H< z=3AmIx45nCF_aiY`GTc$M5zOR_>F4ND5!PE`9vVg2`W7W1*4|Cz^KbvSv-=>_N^;@ z2d_nw#>-{{RZdx`Gg#-ao)ZAtfLl&j)T$`vg~k-A z@~a^Ow%;|~n(vrEi-WF)E>+98NGkdPk_3QA&khZbHN+pU%jwm-DXz4vY?He?cMO!6 zP^HAAbpKx!?|e8a3WFITC$VR`E4u6T*LCc5KyGB^VryC@@b@F-L*V9r@8sY@nv^KF z=j`_u&f+v%7sLq0&(m4e=oNA(;*0eD2(HI`So59oL9rlmP={LT$%D&vELsWyl|3 zf)QkCKFU+9O2T>SR^zsDT+2#dSz&&DhFb{x5x!mp+2%Uw8ZSOu!kWWJT zuD7?4$^iu1%4J&oUHLx{#162GKOh~0r@1d@LNeV)q~53khDumIyyU+2dx0pXiFpJ> z*xeEAi8N=Au&P@1?VZd0jY+}U(lY3}Z*9a*r%R8(?n`mK+A>hml41dZIIaQ zZgFw=*-xY5)GEOz*ayn;@?R0QhZU|w(?Gk&;YKNfMCj<_k5~Qg^Y6KNnBqEY&7)%f zX|+s{HS$r3mKnG0?)zY!r3aNnVF;LElj2Z?KRSlzIyqf+U@l7;8Ei0Zuy`Vwh)CJXMp&=Jq`t49J|7+LD>a0vnK8ZMs=8%FouQ&ZGU+$sfx2g z_55ni?VowJsfNI$xcYn37M)uiT8iTV9Oj)<>k$912LAr-JR8j81M#^G9?aC|*9|Fm zR(_*Kpjw$ho(ga-8AeP`Ta&*$hI_WFVpC+VJx0>1cZrhg+n315&?fbOU4HFt9yrF| zt4+&xxM=-L*A!LDmyE}J)^D#bt;Zwx!0b@w98!O__n9rN$@Px;|L5IV;}}H`6-{SJ z%qWCnJik@hesZ^EP2YWQz+U%KtLC4Ra%Lh$z!QlnBl{L&nFh z)bV>J%@l~8lb=^Oh3FW_zw!UEPhW+KI_5XP046E?&9QHHxm?MhM&fR^%Xd^)m>)g) z6P;f2bmdK$RqvhlNw>X#?{;FR<-VZ~V_PXm&>-hB2ZY_H?Qb5!dn91(X4~6v{u^7- zq0LDXMVE>+sDpmnHAcV4j?EJjB_7-C*vKe7iVy%52rdp4_J(YiKoywgH6@!6c+kw# z(`Z}Y@A7{1xN+Dw$4{KNa{GfrPxsFD@R*<&ntJgf6VvIh;A@qAw>UX{psisB7O~RA zg}vtd2=bsuZD(+SzYZ@ zwWdrlQ=?-mzTE-o<_>m%8Rk5XNs|v%_b@#_chr?4b_XQ`-R-t*xw7-m&o~Za-vX4D zS5o3y+0f5=VzE82zOu+4GRXWS*<0dyb4|Q>eX~w z3}y0wbVH4ID8H+;Dm9fGs#Y7DIZwPZqZqYEP6z<0?>|jZK$yV34yf5av0~DT@`n$< zAV#KEJnYI)Czq6@kndc0m3`z7%y)e7x|bnG&$E967^b;sp+?H;E!R1_z}DOm39%DV zzuoe=!Dc5K1LB{D_XI-Tn(pT=+jr( zr=^P}MN0%$U_i}dUCmD;%X%BgQ%1r%QY;kNxU@C&;M)&C{lLlJZ<)WrlRUf;Nr`{m zUfqUNn!x-N4zsMRC>18nUjVouvOV*UCj+Q>L9pysQv44+{)njgJ753`D-dqnubl{L zqvaT#z9?aypqdHoFz?=Fbb_Vq$jald7D%qYF4C-6pMZxt=B$o3xX;v=HCmdC_IEB1&p%OZrWG?s|G3+^0=Tp__d1C4@yCIaX!CC{&pMMIYb4 z=d2V4dZTbE*N{c;#(*b6{%3#%(F9nHNgFmd`|$SF0Wte@3f)7NF-Nf~P!zLIVVeVi z3B_D+Fp;b_*g0fegU9qOCia9vnb^;tOH7iiqRFj_3DjBh_1~@~YL&eTT`S?Ww3v?o zw$-PJ4ax%mf+WImE0+4=PbwS&2}A!iVrgh@-Y-u`#+%FyHf4@%7}|J%!ht9gK7Cx= z-??V~s1cWrMISvn$46R!AmX8ARPrv@auK~~><<|XDZ;)qYEI~z%TVv8%HL4!2PTOY>@7I_KDs}!6Z)&fu)PymujEC`Za+ZFql+q$ z8Hy^w+%#1LAh!EYRadX);d6{HywUaMs;^h(J9u<42|aUe_1d*_<1Jn7-xx~30P=Xi zzqoBr^!+IkS&6Ejh%B@!7u=;ZIx%h(6jwXOPRK&8S`LmYsncI5WBXN6kk#>S=;}Bu zQ3WzRER5TaCT5i5q*VM2KUXmxUGUBVF)XB0Bd7$>p&K6Q zObtXxtkzp5euCh6h(yIJiY6st{V&<`)O>Mzm)59EIkAmWiL&yn&&C_R(FY$~S^V+Q z$~0zRwLzw_g1uY{6%_qC+NW>d>Duklx!ScYC3^==w`?4{2esK?MaA;RiMC-;J`sRSz#9*ah2lXN0(8V{TPCxeinA8PsVR}?dsIgU>g zB%8i#(%PZoLrAsk@^Z0Jn`FKjAo(yxOH4{Cfclck7@SKx{x)8HrhMk7SuV{F2+nuj zsc+P-K^o3;zH)tKR?@u?p@3&@(z>T{ogJ;Wtcvut+kfJgP*~v^;)f9=ybw)#j5n(m z-RY95Oe$8naW7)W!r4z-ep}S8wf$YZ+rQIUbW2N7Y9Rqg{~X21Hh#p24P2%FU)inVCt1x^=t&(AHF^$}?3^LFE(!xEA?-{!wP#qUH`2_2!Oxd})iC+5nu z?D9DS^tV9HSx##dxnhl&L8%^N33La&GDr@KEP@OrwejNxEMAaPc341MGKnD)A&`;u zE1~t-Z8-n5uAQZ&VbwR&1=#{ht2yv;*0WqcpN6ev#loC#gnv-izgeNv2hA@Q!x6+) zKhxuFu!enCbs3GyQHAeiTfucOJfEO=dH(6er8BVUDc3o++%GBiczz{p$j1eX&(KqT zYG@FqfrG6>zToS?fJfK4ZM7e@Vf>#1+A%k7I6PX)i6a-f$j**_?WJckMH{#BcJo$&Ryo;zq`rDFJJanSKSeNinV3awMs<&Xmi2M^{)#@ z@DT)u2bh`t=+VOqVsXXT06Ca>w#9K(y$>@x#}Ktf9mofOpz~3>f(Ng3fKO=`Q^qJALAJ@|2w)qnyCvOa7^~)+ znC8*qU*EocBFZkKas5GeR*3~!sVBu;rqDzMtL&!6jqrEk8n>Q5qjo+@`K9m`(yT(U94 z_5z4{$*~DLi{2$o)JWE3(NQk^Pe`41eyq~L6Ibt+J)2L+%qTt(Dl8U-+1dn-8UNdRq(uP_ zgvC*=DvjAp+#o-<2ciaSx-aNHwEeqQ{vKdsDtg+hYhd%_XJ_N*6>Ch8h7Wjl{wlRvxV)!*U6J;=nM*&(kHy|`->!; z_J6>~@h52|o%zd6u*7Y(OTO|1za?>*nZNkW^l>fK2fz1el8)slJ+19+w*B9T| zUYEH>R24r)dM8)2nkgHF5RLsa|CneT;r(0}m&&tQ*A~{}z(t5m40#lLnoE`w^ucJ7 zkGWd!9{l}qV&m+HK}qc%C}_v+5bZBov~8OkDqQY=!sAv#pd>9C$@O&5BoZv~zcI}` z^mp&yD<~m0Xi3m!06HvQ-M{CDA1y6z*AUP4+o9eq#4sWC zC&5iBJ4`K?Tz>UM;7Y1;grUC&zcrgvZ!v?T9Wzc-MP_(l$VEX}&|DAzP=|k{z4cZn z0pEvQ$*&>Ret6*%RlWmu0vuzgoNGFzo%_*bakF4zYiX)FL5s|o_akHrbEtWEq%C=9 zC8|g7_8OR1(obJ(I)CddAsc@lHj{fHlPg>BHM|(P&WtJ-jKmLef z?gfFU<7?;pNS83!j+h8NdaQ3p)emuOLs#)<&Dyoh5Tqc9KdZK%@DpI&y8R59BWAmX z6&39&ByrtDnbJ4h*v_ky=XRK}OANx6LAEg0LD#OoMIHzlXDTzp8azi!1xPNhKRHn} zx%XuEqoi6}wrGVH9x5B3BMgz|X|g)l$V0Uzf7NR^!ly{J%a|>(&jV)W`w>3kr4tb4^(UW;ffpdYhH|l9}-} zq-r%tPW9_);VQcU&{h=e5=zzNJ+c~=NxO!mjGtcX=IYu*vnn7=7%e$s#O%C07SxM? z4ac&y<0ee0eUy0oAT8iOT6Au4zh%x&PIsL$5QQjixxH$`hT_D#%3*4i#7&oaz9TAs z8Z!uGhpv|pjOL(Tkp{f&ZDL_U2S$jiNwlZ72_anjug!2#=M0SMcZ#4WEmJ zy6lSRhGu%SM`jH>ta<_?n?cjz)_j@BB%7m7OzyMIm&9XqGwW;R9IFBvD4R|54x&y< zw)=KsX!eq`se9E{^=bP4H!g`h#U>1M+RQ_i_Lw$^Gnd$Olfd!&iztaB5e7-kHws~y zwMGaaLh-)jcE7xSx7$`KS%~TV$?st(_KAoa>sTyzl})@=svHkFV|>zAj#GiWS55I~dHS^I+OJ9@&&?b;--VLQ#BKc6a@Xbq3g&ow2aC`BBVkFIX7KPQZ( zQ`_Ozhs7Wr3z1!_+~t2d`}m1-oNXvW@M}&X6Kl;Qle2;bntQ@i^2!DG=CbpTsSuO8 zH*~UZd708dzSKew<|i*^_d~TadHM8sDU;AXy{3&4!vg-R_=G41q9~6xc8l)m|FQ*~ z6UfqL43VpA$;-I79A>N-NGEy!eaFXNSS3CKDHd!HKq8O(jy=X4ti?>s=!(w@VJ(9j zh)Kd)TDTv<`;JEhf&yDS3$Dzei2~=UCsL7EOlID}M0;L*Bn+h*G)nfdkp*4>!1tAVDqUsX&ImC zzPi<%X*!pK7A|W0Xa4P1x!suO!p`$c2+j+hF-J^E^VQA%Pr%6q{Wg?iK8L(ivW_)yL(L0VAQ?=f&7Ee|=ib*3PVm@y{ z+}=+t=3wL>3n`I0xii3cEc@Y?;tcG+{+#7|+CbUgC-&{Yfu7Jjf=QMO3+^NCiZ-qX z7ar)a*?Xrk7Zhnoq;AE=TmJ-xQt{G1VdOVu$FZ&E*V!4-F8<$Y*rAu$F*e~Q` zFO}@Cibs;^-0WKzVrmVY_WcM=%AcLhSMJ>u(065;FP$`<7UC?tEm3;DsFJXauD3Zc zv0~JB-P89872Ng*v1sjF)(XWdYJJHJv&zH;RmG1Yo{J81Ta(*uX#oZB!ZVa*Q*b`hc@)OBbm2Nlpn zAK~_9MK93Qs64TGMi>3UMJsF6h-(;8FVi>RLj;{ot)ow!9c$F!i+XE^QjRg&G6V$y*>7H3cW9JFt4 zSLZV$W5qx*c;BF3-e|@UpZu@&SR5ePWK|&Jljwdv!bz=i0+%36yZMPJJyc`2&Nz8ykNAoxvU$`l zK9!!p+$5ma%B9W~%LQ{H{-lF0ws^=CJm#zpik#Lkuh`fS&SV~0X!rg>x2#u7j^xWr z#|mQfL+)ot9krW#tmbij%ZN%Owg{2Y?3nB^*n(VxdUB=H6pJYLqvrV=!U}2=b%&bo z+;IM@t8z@2D;`q%M`A*CM3E^ViQ~q-0N2UP#2r?mCNGUd38t+7(_NN77;f_7*)!zh ziSNwZz9S9P*3~_kHp&nxDPfH`V>8(7?b<}wLY@7u6-WQDKihdDVV z)ZFNcjS>-*g6#2YL*H^vEWS0Soy`stY5aW4Z~vM5i!iqLkqv3wD)=BxWdaoV=ny|^ zKe(u2gAwY!h6d|N`BHL&AW1B?Sw+VIoYCu0%9gG^Ih41-{~-LTv4N1qdL@BUo!;J^ z{bTp*#kVDfn32}#bkmo$6ZhHIE(0yn4(bhD;U)D{Hq$M7+^W^9<5o{qs;jm4!6CM_ zpmh2Ah1C%;$=$~5uUJt_T#7>f{sRV>6|0RjMwH-Hv$)Ot*zs#ta80zUN#FNU`O`J- zMQ~;(6=`m?VWWmCyJ~OpBbu-Bqsz9N`Y5C>M=+axzC3hZm%!y5ff_x{&Rw=0gVDLG zaZ@D3dRx?aJ9{;eNKxgVl&B7klpwJ0y|j4nvNK{Dw0uL&O*^uZc_|DTZ)V3GZ?SUW zmw1K7sDi$6wgvhj7`C$`2tX7-AVP@E;q8}baV?eSNr80l9in$reB7Ol`48vOqwVTB z3 z+JV~so1_v04)>mBASQ}Y$e7qoeN7 z8Ph4Hk$%66;(t4GmrXXn-{B^C5fv1fO3HT1auXdP#8HKzTEiqPwS>8!f4GN1x9FkRgv0ADcVCc=H<)96;kLe0 zPRszA4U?-*ll7S{kK#bcyo*;6c|TZJ^i znQZ};1$^OQk{}_!9M_PPNrz4_{^qcV1#bDoC;tSzZacRLD^GIg3?pfh(|$I;*@5Sv zt3hJN7ftXoth4;djJ733^z+yDo&iW;Ae@ZqjO1(T>vs!+fM+`g_7o+C^l55a)Wbq- zWM%BCp5DNW#4Q0EKY#SJp35G2DU&s@Pus5|eL-+rQ+gn9XS9is#s1)A8XXKL?q@<- zCQ6B!*S5<&`X$mBuUA|B^5wm+T8@EP@KWhP!(f=y_r>++eQ=>^MC@I3b>8U>hK~8U zbO<0j^nIkkpRZR)JSQUrT|3!hDTM_l;pW9pgI{QLkLtk3u&g| zXyYt}UJ}_qP7aOhnSuimBPeX*r6kul3*;HHarB0kO z#VO4eON3>T)i)c+ZosV#s6_6>E7IR`c>N{i%+_r>ksrvp02Hpfdu#K@08)^uQQIo!&(Hp^+n?MQ z$*-2{hMKWwm;uYL6yQAK8DXp7k9#U>Un!sL2BU-zcn}*DhNn8?0*oc)CxH+I=e2lp z@p8)}Y_c1^r0n!0<`1}U-rPagWA*0WY|a1L-UZn}OaUClZJn@;JqAp!=OH$ql6n>R zxYrtssj>Th%lHJBa+9DoL0~-V!4sw!p*Pci5UapIFSrxtM7X-9zU_7!Y@FtbKS+cq zkC>#)(7fF871%oYpK4m~H&4TYh*}4bwO&>PSc|%5-IRT|@7*^!N`LiZ@roH+Cl3ULUP*7f`*}IAAT(AABxZNB`pCNXkmhz7> zn5Np@iP3*_0tCj}@*RtY4J$a*^K#6u|I-2tpG(JMy0JTo4$boc&aQ8aHEfqG@w`?E z2_Lo1Ph{tQTDgM4WmF>fl7Po@9%2c}8&wdKE8DFb>z}xT8qYv&z%XuVR`b^ll@kPj z5`oA10sBFPp^fQgQ|jiqYuZ3gQaUYJB0F`X!hM9e;LeGO%WDQ2&zdDZixkaLONLv) z`LmMh#&jG!eR{sP5^W<^s%3EK+fC*@8RE%{#rzF6 zJ~#d;w-2y0`(c*WTB~jd*RW4P!9(fhX8##)fk3&M4xdK({S@O01M z-?v^i2puEN8_EtudAs#hXmTWe9u^C*6rO?xrsnkYr2b3r_tHB_rip+)hGL_ zT9I(W>fp-ZzTv~ENCyMrIvN{?Fgwa|;X0*Q3)^MO5ck|m43{;>V}wWqyhL9GiD{hB z_6ipF7&8L{F+*qWUhpZJn|Z%#9tDgFL~fJ3(RNG`D8=@+TB*uqgGC?wfI>}v zcD}s+Bj8v|r$_sxMP)ZPW+|9DAJn{_eSiDhkl^Ds7|?=F3MXm>gydiuxTTTg!s_XCj3 z$-Gb112-4{S-%?x>h;ZgKupWqL|@n z2}okj+k~`Eb~fhL5iMhGvcERpD#a&+)B0^=qcA*5Po$oZ%YS5H7Y+b&F41)1*jYR`$#+|J)7jg ztxR(i1j z4t{5j=Kr>a9Ov4D3fRr!0zUtc@+(meZ}nS#R+%O6h; z!@7I zBWg&L_$k*`Gm&K9wz&Og6ESztkU)WHj2+vA(K%jgwrNf1zW2jx=P!H~ASNDHX-cxN zX5Mbo{}6~%#dW9@CwfT}=k{E$kyqV8R8>~Q*b4%8wj?u|y&9-rM%`Qy;@b1YH*XB`4e4 z{e$Jl?htj)+ka(Nh|aA4N7H%0_1L#<{NElzQV69oDwL$GqLi{Sl9`nhEu?5kiV_js zLN*o2Xc(oWw5SMWh0;K_hE*cH-;3wHKcDw`pXa{a_5WYj?{|*lJdWc8aXt z=dulZnaaC7+oP5D*EY_!^{oFBJA=+F`EoRo6!l(B8BIyh?N4HS{KG`UE=*JDj`_*M z6%W6DofvNNllS+KhP;K#uN8?UkPJ_oYM@jsK~iFtCq;IF`j(1v=b zs4!07j5O19!w2P@*NQzZK$|kdEGx;SUU^Q&h{!md-;(!1@SdTGx+$nAdxdmwU=qE; zMA7QU_mA^Kqeu<}lA+9a=ggUC%V0>1H+g}HgdSM%nti!ooehB z&U%4UCf1oU*vUw*mzUxLqsM{_2``qU*Ku zXA=`CrUk>5LJ1Ee(;vE%wlA&7dDRbMl!?!7Q0jkYL_5Gz8V0wW42T{ae;U2>-dxHDP=nO3A~loRzJupSi-TS^`c6WsUcerJcXUNi}hnZFHr6wL>|El_hi4A zJMBL{AK}rjH(7p<(1(Wxl}vtQgK_Q>Qm$i#v5|m5B)cXiF1dvi@BvhLoXE80sJ~`jAYP1c(`qD(>Cj zhdL~)fl(2!qbM$wpgL#nT&V8y@x4U`6RaC|ilW@1D$yN2dZe6u{-8v=lWefO zulR>~85NgkpZOOkvUX$^T=TslikWSZf6P{>OKpK_sQa&`rEMaL(uFebabY>f(Y?02 z|9y4@Nvz*#VG%^h$bQ2eC9|7HUA&WUwKgR(tlP)fCp4;JS2vTU2~y--Pc2tHRp7K{T;S?Pj5D#eO}c^d5|x{N$E6 zY1Zu?w!fQ&0P8?ans{NR?Y{W<71YcO4%Dcg)zus7>!s2v>Z%b1XmxU}rxYYA0-dll2T*#Uam`q^bp7-@ zd0Ihibe;a?`x^uw!LYE4K$Z_2lOvZx{5(vCO?wjL#bkE77FZb_c*-d^|(JM{WWFg(syHL1Oi3Ps~Fk{Wo!KYv8&Lem23JeT9 z_|#wT%K}th{6`RpWr8e4%tf{BTI>}v zmo0h!_0gBO#6($5*mC!MG$Isc4*O9MYGP4bRJ4j2TU^Ci|5rs3{76qFA*NT0E;;Qm z*HC=&!Eovff%wRwQBrtb_i=8%=YeITH|u(XUb^3lD#!4s-|p2Z3odR+*7BvY9)Duy zo#X+*!}c_v_R@pQ4QI`t`qQ$~=lz45EIHNu#!Q4nYS8o4^@33W7k+os?RxZ5?)y$6 zQMLfW-u=gp29(g8UUC%N5&sXsLLI2wDc@fX0J?|{n&-+ZnJG| zS-RGvT>eQxK|I6xE7DJ8{VdF=@&lJWLbAft1RSQ~_W%@%6J^!L2MSYU$maQj{j8h) zu47xu_g1|xb;lT==eJ*VBOH@!r1WmFbdPqhw$`E7CNVE_68m>N9Lu3IOef&(ASPVvpWhfCl55 z$lbdMkQq(o;iR$fS%qGcam)DYR%xRi{_b@cEgi8A7ze-RN@y=GPHj1|BLC160W6d| zeQ}azqSUHyus!PrjG%h!rO84Z8SO)3T5VmLPmIDcq!s+`Ib4KBto?IBJ1z@4H`LHP zUn<%Sjn$j@V)<8LOaSQe=^{5%YxrZ|#V$OHcg%5c^e3hYPn&te!7fT|C5jrq+MPmq zt~c09fwgn4pI(%S05hX}10Wjsbfk$1me5NqE#r~60tYbM-yRv6^tj?Q&4!Uxn}px4 zLpK{LmFOC+R`j`(I``<#^8;m-Gb=n6_n(okrg?=)gYK~TL}ARH;W_HwopB2H-am-Q zSg91-vBaR_RBUYdg@q&3_XyAxqx;KJV`A>m!tP+x0k_=KGc_~wCoy6BHvRcJ5&79) z7H-~R7hJ)X>#Xa}>%)^3+R)ZNV(O0^l#>U#&e=MjnKg6dC%@)V zQH@*PUJMsZTwI)h0d{+paKlihU%wM{Jx>%wirAJW(&o?w#;kE=%g=?O5;x=jGuV)YqF`K+;Gncst;j9Y=I%s}w-5NA} zxb3$#RB`JITUUIkoGYzqgj~V8bH&Bkb-QJK_GhwUtSRlFTnm#?O5H^-`@=`2AlrM$ z>!c?9kez$>tkog1DgC%s{`fJ=sEbnmF|7w)uwuzfK4~AWsJNcp#9TSw(N??i_l%m5 z5-4){YgMpKCcMP-!1*hoDh+?T+WAuhhl%yt(iqxjzh}z1bFfurXRlrT;@W<5nOkrf zZ4Mi`asmhw8@j(U7FcA!4tU;?4BcE`%(saRj^qKxM9;#~$ zuSzrDEwItJd1wKA-<5@YHW#@Z#b*NOeA+j8ehRL;E|uw@Y3}urGOt{x6EbGx@S~nF zMe@F(Q8_t(DCG;6-C*b4`yBo6S_eFDkbi>8*~~a{_4DnSbAchi(g%z_O1CVG5533x z%tMewLoj1vz8X@=I7mB9FrL=q^G!A+1;esLuk<{9^&+@Eh>c^&}$j+!<1med&JiQYrDguJg|)CnI-f@}@6zppZ2>V1R(JQ9b*5d!IkjbrUigoKYyJ z(OV!J;jgBx;$RR*`EpfKKOEF6H0k*BLev$zVZK!vu$ zXEcHn7h)cT5E+L9&aADnG0i8PBS;SmvlQBn><}JcZC4!^T?x_W*Pouqik@*8#ZTrR z6Hz1wbNEd3RulX!*K*m0$9VRXl}sD-N9k@}-h`v1PnX=R~0vjpfN-R1+6P-g?y>xM>r-1dJvBi;ngN>4Y@) z-uGi;WDOuo#kel{>{(Z5XVUMG&{^mwdZ#7f_YHXi zl>wZk$Vjp&@*X!AXXHR|fl7*7T^NbDx}L?l35X3~_QUjyVfI%N`G?G9_-3r4v9w%) z2!ZsOzj*~w1zv}+$(e)a`<;Jztqc5*scuxuD;BazZydxjhYu&mrczov^VlVbbWH*<19QNm#7i{YI zqqeFtMsE@F+?|TThM*G#RCr=vj(GkxF-+2{v=x=PAY!MHLF&NJK6YSbHH9+IXxfc_ z>xwsqnONBhEbclt^f3%5=$Jr0v=ry+wLTCx6T6iN_VKD`eulRODPGxl88H9xR!zNVY*z@$0>HhY0>*7 zcV}m#N&m~@%j^~3)m1~=7y7kxI8+(^QZ;fZV}8hd=|hgO{}(4%q^>?Q;(3D%kOyjO z^UGfDbm|t}k4z~gEv*$wts*5pfql}KFOLX962d$+hS6-SbsjmdON#lI$G77&AG?Y#4OQ1T~ujcJi}}|9rif!ot(DxL%jXwrV2I=d#$X*v7HclpILGY)1V0O~Wh~ zRRl$r|317Z#w7Gb2mX9;=g!CQ&+CNcTzpmrO*{O{NOr?3 zu9KlX-<+m|-p5S_ZmKsND{wHlHDwpJshB#TyaNUBCRn1C|Z! z|IfXg+_7=vMuL^#>f|S&0woyZQ6saHj4$wLzq@$0>h_*kGEM@#Dv9RZoXqK7G2% z9}Gr=_->Hm6sPrm2`VwJiZzDYmrXw5DY*aBB8Hi9c`?w9^6(j8!JsH6W?LeSUWN4DXR84a;@>{KL;*(BKjalh%Ky zL+DG%v$O2&2P?|byEji4ci3(u=c^eJC+O{YQBQ7XHa@)=zh*=W{U)Su=r?3Mm70Da z@@zga89sa+*fOOt&~S2^u)l)?FO)e&*9ryT2XGQuzU9RFp7A^=&mJN=;#suB7RAuh z|IHOdok*R~Rd=Y(7(TcPtVbj6ybS~>fhoIeGm}~<8?v#S)+ehaixdr28i>L9%0D3- z!;XCS{=M$qiH3s*cf=esFff=rV}`nsi(+TnsnazS;WB@Q#UWG)EQAWZqZ{$y$&((k zl3My3_}f>h{1~soq6wIv+uip@z;`!j5C+c9^nJopk;s+o!oHD{v;LQeMD0$+Q63K- z1pvPbiv*Z?823!ZnTR?F*tYMeHGM7KQ8Lho^{nn=0$AwpuNjItQu8=}eALdIS%m|7 zliXgK%?uPTv$T9kweynfr~KTr_W>nrH(mr7a{j~}zvbCj$9}4u8Qn!c4FS3KO00~q zr2ziY+`KR+&_5}RRt7}svq9;rX%bIm}QPH`l z`~RN{5b%j4Bdba6#Vch-%{)oIhI@%o{LPjP)z#H>^%*^e!DA=9aPZeYyHrmj0c}tJ zhVN)IUc>XYK=!3irggo1TQLsn~t z{kMWZWvjXe5p@5{rwMQ{%M|eCKkSZ`Pj{t;4Z`=%SgI&sKGPc9{}V;2!O;Xhr0I!D zaAIQ69gj_M*33XG09RddQ`p*_?CZ}GV`ypaD=VpxMy-B6;QCoO6)DfAyrTNxPoRw_ zN_e$_bDV|2Fn6WNAe@+IJI*cAFY&sKEuQjCE z-8J+Kodsze99FI{0VlkAuRd~r|OoJd1Vs80Hr4q~UM?CKO% z?4rblYZQs+GT(z0KP&}jcikFn_&OWEK8E9wu4w}dQBgzGlrk8aU8q*b)#Y z`NA72Xg(6Yi49R_(UQo@7IKMfEERM*vfp*W8Gl~esQr71)Im1;Z2@2`pul5<_jajR zcTYJ6tkO$N7^<*Bi8PT1iG$3>oa-USn6>g1i;JE=A3JE!t&)&yT0T2vsZ0m!@}+^D zKcIPgzH#UIvuEovpFev17`hd$)#A&K+R5Gskk4kRgcszg-B)=^0fo;vE!?v%6UB6A zhi#-$AVECaEiSUa!k*B)DqrTNoUi}p?dKA}1F!ovYZ)0`srFs%;qgJg>WXXkf(h+4 zQqu9Awd~W}jA1zdTP(})%quOu@MaOvV5!=CpW12l+pLZ0ds7MN%M%X9CHC8GBdj8; zmQ@L6led*n82YX6XCNs(@_$ZEoo(JsF^8FV;ywz+dAnv$JtUl1mlV&Go>sP?XT&0C zxp~tt#Q%>fz};9yW&gIe=)rsct-pD>Y^`~Jt8+A(R@T-^4XI+HMZ}$=Zxyqa^z9;} zJC8z$M*UIQB0*!BWuT`Q`F@|#jEoWO1H{x*U1|SIqP5+FyavON4m?{`w&AAmzyF}M zdP<{#u0P^w9kWwb$`2YVr=n@#Sr1{!)hMs5tqA`sj za!zBZ=$SJ}cU9lD*@MUl7Wgq)aK-GUayw2CHz3dTm=x=xJhZMFCkwhX0S_NwbKLaM z?+NSjmkbZc*eTRP-}NCWuKJeID!%op@^=0PP;5%-!1>H73~i2SY1J*AH7i(q!sCYz z`;7Ehz``4X%iFp->~bBM6_j;hS?#UGSH4UuEpZJo@>G%-bVe%JTHecDGI%KXjEimo zBA{pl9Fhi)W+!O!!x0EJkvJKUVUV@VHw;cK%YvhA3_bz()lj!T+iel6vw(+cg!2az zee)5%C!ZpIAgj&zlMzud+xkktqT3pw6X%be)>XS|%8%PE*cJTvaZA970Fb7AD)Y#* zYX3f{ik1pW7$75U2_c}Psm{_=*O%|Wf(UzeXG{Y46OwW*(&qGELY?Fj;q5Ld`uMK~ zh{h#ReEZyt6*$=f@ri$YDkd~S_SCun8l0UV!8UiCFw`!s`1z$`KOtGlndkrnPF-Tc+AW7o?tqNaTTU^<9i&P#-KDW0dSU|M&qz!o&AB zPk?k($LaqBlM?20$kjs47zigX&2A$xeHop@&lOfPaA3E+nP{b@J$-|hS3ui0SJIA~ z9&OeS0W{POdA#Y_$~Rv%ONxsP5sR9Cxna>{%^_9HLiqHd9Y**Vb4{3t965~3 z-sqNdbI(K9V6E1sz`)+U4Pf-)OoXbdux4wT5oR3?!p`z1_PZ-%a2$(g?js?saI(LT zmGG6oazNMxRBD}{g6P?)U_xhVTt>zM4MncA#hv-qLWRJ~1QKB_c+er$fky-&20-bO znz&rx_?n7}7C3f5l(NdB>vl8k<`fvd@KhB!>O|P%fwObcThGz_+x`#6!YD~HE{RS{ z+W-{UYn)CUJt!i=54%^fC*oRWCTL%Tr-2f;qnhHP`D18kDF44Ai#ZmpGe2XZN}wJ@ zn2du<1dAAk=vK1R4;h}G*P$AWu16FRM{=kAMpY)@^cu=P0I>3#R7BsRm-k+?0Wrg_ z{1yej-a5H`e;Z{h460g`=0+V7>X})^7|t~4_rcHRuaD;o`g(#4#ohk9>0{_vI09W2 z6m~^KJYP~kGl+EQsaqd$r)M-{?9W)JAnMSqd*5$g2s?mXTy%o)x*CthntGY#i(AUK zUV3`%EdtKocvd8Z(QYuW7gkgj7xfR}dOZ1!bmDBRadYmrR-wZKq-?g4Uch!s+WKx5 zXnZ{P*bVEJv{4l4xm--aLuB6b-k$klqU~Z=$A%oQu-UrUK+JHFf09GfID?#i2XrCd zc!ZnZquLT|Mv#tSWR6=&gMjCkdBin*vl4O~pP@o4`h$HaS{5pC@V3WK5hiDcV#kORi;` zmk)FKnwlHLBQzVKmP!;>4;TQt>s=uCJxqv%F%KP|2GKod;KGzZ{O`aamf^KaOFV8I ztd94yw zf}dq7rIg6F))ZiL^37P5%aTPQ zuO0RnR7H&3H(>SP5aJe>i{*y*pFH^i{OA$h-;xz`yP^&seohrhoxNQRDLws^Gks&9 zFL0^J*}`(gP&;O8o+&R(!U$5BmvPYibKtlNOQRXeX@@7#<| zNaZ(g-u&#S#zddmMP@D=@{JZh6zo^uiR)pXDf7)!oAK_PdGluftupJh)c*GsyIBA( z@EbiQX+8uIYk2=&wND=ts+sf^|H)0ATesU*nVs@ILd;Xi5!S0+AP%!IhMVB%xJB_c zYQ3pbm5xn>#m-P~5>+K@j&!G&BK_oSKlmi36P%c+v#?j6f^k)`&^{h$S7C8SPJ&6~ zu19Uy@c4WMYNTf6o!`MP7~bU8bonkU6=KqfA7)`)`49rNhKBj?eQT_(rE?k!dD>D@ECt#X`$lH8+SotU z*9*ib1kw}?`O5pj@0m}r8p8Fbd3svfXEf;C>Qgl;QFe?_4Ihl|0|Ci=+O$KMfCvZg zNj^502vTj1jTKT{=S^Q)-j%Pw8kB&ea`7vSEw2BipuB}ZY0Apqn8!wB=HPw~a!HBM z)V|$F&pG%YiIAQE;(q30{f{>chW6$}YgCRknIO|_LoiA5*u)x0C;n{FA^)l_{g zzX0+Mg2Ck`Jr3wD4>Pg0eMI=djU&VHW&|ws$4l}cEi=jB@S6eX|83?(@fmh@-f*^rJT>s;*|Y>1UlkU9arZ3_cLb zNTO0GKLJm!39}dunjW=L>}pu!8*6jLx)ltjEJYT+e3N3LEpa01(4l8A&qB?nKASBq zkR&hj$gW@S+c4`OvoyN@_uNzmS#|ks2Ml-7CS{a5_U2bf)JVK4`rv$E?5SeK3X&)pNuJf$cZs6@HkOMd@R5B!A2#e*JNOiNd*+dmk-V&a zzdH?z%NrG?z9hakk7GRZx9pfOil+Pb8+p~8SN|$l^#5`n~rKDwy~Xq>+Aj@^C9gl_8y}i5&UPeO~G5$;{*N?^kNj2_=#y$ocwGo);hql-uNNy zi9%r4q3&{wf4-vw8tM8Vlp1Ubc4q`HXfGu`8W%!BvtG(|?z}p2hh&rqty^kZnzKnn z2YYL}o3D-kt!tO?$Yb$RJJ2Fz(Plxv7qsZ1s3>37nIv^)psAc-O~y|5mnn_!-wT`K zuH9J|CJ*=V@2oRg0j}M@;^O4BYln+o5$_k?Ii}l-8J`50Z|&Eg6rPOE5~g+;PFMD> zS|w0n#i@47<3+7Rg&AHV33+e zU51y_*r4Bj2y!ZIi_a65Q`N+UCzVKQ={a;ku8*=gR6ACnjdFjo>$CX>np4Afp9gOh z)TUs7zvglCKstG*^Sw303z*0S;uZ-2?}Rx`qpG-1G2}BeW#h)!%tx)7N@vVN45FAneBB z%XxfCCrZ1$)BAT|N^;+-LasfDS&-OCF(HETXao*mZJ!Yfr)5l`@3bw>G7Tsj8%{z70i3J?0!anZae;sJewGJwPi%HZR z%=0IRWbgY=kdZ%zzpJXOJmAhVRsYzdOPqOExy-fld}L3SGf;+cHt?@d#Fdp!B@X&^ z4WzACuO60VLHndXF^-{8gSP%?31-B2Q0&RPR1ckvRZ+kctoVBN;1iZ5yxj_u)294{ zU~Rc#{!et0RT4a-0b5F;&w%W`LiU8u9whg`=Z_;V4}2l{G^kEgg#^Ppf%scqI{!d2T9x;q3U^D zF6wOPM$DxvHFb6)Nt!ojPO6%eYn11F2fn>WxTtsDvu9+zXRL<$Y#t=?+UH~ta2)9$ z@I?)1)wX#DiM7lt!^|KDF^K9rE`Y_DSDzfl9l;?kOlnWj#af(KxJ1b

    Introduction