From 76b4ab7a259508ae658a3aa8613cf93907c6fd72 Mon Sep 17 00:00:00 2001 From: Stefan Pfeifer Date: Thu, 9 Apr 2026 00:07:14 +0200 Subject: [PATCH 01/18] Update user manual for version 0.10 --- docs/examples/bows/longbow.bow | 199 ++++--- docs/examples/bows/longbow.bow.bak | 92 +++ docs/examples/bows/screenshot_example_1.bow | 549 ++++++++---------- .../bows/screenshot_example_1.bow.bak | 240 ++++++++ .../bows/screenshot_example_1.bow.bow.bak2 | 240 ++++++++ .../screenshot_example_olympic_recurve.bow | 203 +++++++ .../screenshot_example_rigid-fadeouts.bow | 207 +++++++ docs/user-manual/README.md | 2 +- docs/user-manual/book.toml | 3 +- docs/user-manual/source/SUMMARY.md | 11 +- .../source/appendix-tips-and-tricks.md | 6 +- .../source/files/mass-per-energy.ods | Bin 0 -> 29005 bytes docs/user-manual/source/images/dimensions.svg | 316 ---------- .../source/images/draw-definition.svg | 437 ++++++++++++++ .../source/images/icons/model-comments.png | Bin 0 -> 596 bytes .../source/images/icons/model-draw.png | Bin 0 -> 281 bytes .../source/images/icons/model-handle.png | Bin 0 -> 758 bytes .../source/images/icons/model-settings.png | Bin 0 -> 1394 bytes .../source/images/layer-rules-1.png | Bin 0 -> 36481 bytes .../source/images/layer-rules-2.png | Bin 0 -> 24111 bytes .../source/images/mass-limb-tip.png | Bin 0 -> 105337 bytes .../source/images/mass-string-center.png | Bin 0 -> 41343 bytes .../source/images/mass-string-end.png | Bin 0 -> 84949 bytes .../source/images/rigid-handle.svg | 327 +++++++++++ .../images/screenshots/editor/damping.png | Bin 2408 -> 0 bytes .../images/screenshots/editor/dimensions.png | Bin 5231 -> 0 bytes .../editor/handle-flexible-example-1.png | Bin 0 -> 12303 bytes .../editor/handle-flexible-example-2.png | Bin 0 -> 11788 bytes .../editor/handle-flexible-example-3.png | Bin 0 -> 21926 bytes .../editor/handle-rigid-example-1.png | Bin 0 -> 48859 bytes .../editor/handle-rigid-example-2.png | Bin 0 -> 15818 bytes .../images/screenshots/editor/masses.png | Bin 3303 -> 0 bytes .../images/screenshots/editor/profile-arc.png | Bin 3322 -> 0 bytes .../screenshots/editor/profile-line.png | Bin 3186 -> 0 bytes .../screenshots/editor/profile-spiral.png | Bin 5614 -> 0 bytes .../screenshots/editor/profile-spline.png | Bin 4963 -> 0 bytes .../images/screenshots/editor/settings.png | Bin 7839 -> 0 bytes .../images/screenshots/editor/string.png | Bin 3044 -> 0 bytes .../source/images/storage-factor.svg | 231 ++++++++ .../source/images/strain-normal.svg | 185 ++++++ .../source/images/strain-shear.svg | 185 ++++++ docs/user-manual/source/introduction.md | 30 +- .../source/model-editor-comments.md | 11 +- .../source/model-editor-damping.md | 46 +- .../source/model-editor-dimensions.md | 29 - docs/user-manual/source/model-editor-draw.md | 58 ++ .../user-manual/source/model-editor-handle.md | 60 ++ .../user-manual/source/model-editor-layers.md | 50 +- .../user-manual/source/model-editor-masses.md | 64 +- .../source/model-editor-materials.md | 81 ++- .../source/model-editor-profile.md | 39 +- .../source/model-editor-settings.md | 70 ++- .../user-manual/source/model-editor-string.md | 56 +- docs/user-manual/source/model-editor-width.md | 13 +- docs/user-manual/source/model-editor.md | 60 +- .../user-manual/source/result-viewer-arrow.md | 14 + .../source/result-viewer-characteristics.md | 88 ++- .../source/result-viewer-curvature.md | 6 +- docs/user-manual/source/result-viewer-draw.md | 11 + .../source/result-viewer-energy.md | 26 +- .../source/result-viewer-others.md | 63 +- .../user-manual/source/result-viewer-shape.md | 9 +- .../source/result-viewer-stress.md | 12 +- docs/user-manual/source/result-viewer.md | 20 +- docs/user-manual/source/scripts/julia.jl | 13 +- docs/user-manual/source/scripts/matlab.m | 13 +- docs/user-manual/source/scripts/python.py | 13 +- .../user-manual/source/solver-command-line.md | 34 +- .../user-manual/source/solver-file-formats.md | 49 +- docs/user-manual/source/solver-scripting.md | 26 +- docs/user-manual/source/solver.md | 5 +- gui/source/post/EnergyPlot.cpp | 12 +- gui/source/post/OutputWidget.cpp | 14 +- gui/source/pre/Language.hpp | 6 +- gui/source/pre/models/MainModel.cpp | 4 +- gui/source/pre/models/MaterialModel.cpp | 2 +- gui/source/pre/models/MaterialModel.hpp | 2 +- gui/source/pre/models/units/UnitSystem.cpp | 4 +- gui/source/pre/views/ArrowMassView.cpp | 4 +- gui/source/pre/views/HandleView.cpp | 9 +- gui/source/pre/views/MaterialView.cpp | 5 +- .../pre/views/limb2d/HeightPlotView.cpp | 2 +- gui/source/solver/BowModel.cpp | 2 +- gui/source/solver/BowModel.hpp | 4 +- rust/virtualbow/data/output/valid_results.res | Bin 3224 -> 0 bytes rust/virtualbow/src/errors.rs | 4 +- rust/virtualbow/src/input/model.rs | 14 +- rust/virtualbow/src/input/versions/latest.rs | 4 +- 88 files changed, 3455 insertions(+), 1139 deletions(-) create mode 100644 docs/examples/bows/longbow.bow.bak create mode 100644 docs/examples/bows/screenshot_example_1.bow.bak create mode 100644 docs/examples/bows/screenshot_example_1.bow.bow.bak2 create mode 100644 docs/examples/bows/screenshot_example_olympic_recurve.bow create mode 100644 docs/examples/bows/screenshot_example_rigid-fadeouts.bow create mode 100644 docs/user-manual/source/files/mass-per-energy.ods delete mode 100644 docs/user-manual/source/images/dimensions.svg create mode 100644 docs/user-manual/source/images/draw-definition.svg create mode 100644 docs/user-manual/source/images/icons/model-comments.png create mode 100644 docs/user-manual/source/images/icons/model-draw.png create mode 100644 docs/user-manual/source/images/icons/model-handle.png create mode 100644 docs/user-manual/source/images/icons/model-settings.png create mode 100644 docs/user-manual/source/images/layer-rules-1.png create mode 100644 docs/user-manual/source/images/layer-rules-2.png create mode 100644 docs/user-manual/source/images/mass-limb-tip.png create mode 100644 docs/user-manual/source/images/mass-string-center.png create mode 100644 docs/user-manual/source/images/mass-string-end.png create mode 100644 docs/user-manual/source/images/rigid-handle.svg delete mode 100644 docs/user-manual/source/images/screenshots/editor/damping.png delete mode 100644 docs/user-manual/source/images/screenshots/editor/dimensions.png create mode 100644 docs/user-manual/source/images/screenshots/editor/handle-flexible-example-1.png create mode 100644 docs/user-manual/source/images/screenshots/editor/handle-flexible-example-2.png create mode 100644 docs/user-manual/source/images/screenshots/editor/handle-flexible-example-3.png create mode 100644 docs/user-manual/source/images/screenshots/editor/handle-rigid-example-1.png create mode 100644 docs/user-manual/source/images/screenshots/editor/handle-rigid-example-2.png delete mode 100644 docs/user-manual/source/images/screenshots/editor/masses.png delete mode 100644 docs/user-manual/source/images/screenshots/editor/profile-arc.png delete mode 100644 docs/user-manual/source/images/screenshots/editor/profile-line.png delete mode 100644 docs/user-manual/source/images/screenshots/editor/profile-spiral.png delete mode 100644 docs/user-manual/source/images/screenshots/editor/profile-spline.png delete mode 100644 docs/user-manual/source/images/screenshots/editor/settings.png delete mode 100644 docs/user-manual/source/images/screenshots/editor/string.png create mode 100644 docs/user-manual/source/images/storage-factor.svg create mode 100644 docs/user-manual/source/images/strain-normal.svg create mode 100644 docs/user-manual/source/images/strain-shear.svg delete mode 100644 docs/user-manual/source/model-editor-dimensions.md create mode 100644 docs/user-manual/source/model-editor-draw.md create mode 100644 docs/user-manual/source/model-editor-handle.md create mode 100644 docs/user-manual/source/result-viewer-arrow.md create mode 100644 docs/user-manual/source/result-viewer-draw.md delete mode 100644 rust/virtualbow/data/output/valid_results.res diff --git a/docs/examples/bows/longbow.bow b/docs/examples/bows/longbow.bow index 3644ef61..f9c5985e 100644 --- a/docs/examples/bows/longbow.bow +++ b/docs/examples/bows/longbow.bow @@ -1,92 +1,125 @@ { - "comment": "", - "damping": { - "damping_ratio_limbs": 0.0, - "damping_ratio_string": 0.0 - }, - "dimensions": { - "brace_height": 0.15, - "draw_length": 0.7, - "handle_angle": 0.0, - "handle_length": 0.0, - "handle_setback": 0.0 - }, - "layers": [ - { - "E": 15000000000.0, - "height": [ - [ - 0.0, - 0.03175 - ], - [ - 0.05, - 0.03 - ], - [ - 0.058, - 0.025 - ], - [ - 0.08, - 0.02 - ], - [ - 1.0, - 0.0127 - ] - ], - "name": "unnamed", - "rho": 600.0 + "version": "0.10.0", + "comment": "", + "settings": { + "num_limb_elements": 40, + "num_limb_eval_points": 250, + "min_draw_resolution": 150, + "max_draw_resolution": 150, + "static_iteration_tolerance": 1e-6, + "arrow_clamp_force": 0.0, + "string_compression_factor": 1e-6, + "timespan_factor": 1.5, + "timeout_factor": 10.0, + "min_timestep": 1e-6, + "max_timestep": 0.0001, + "steps_per_period": 250, + "dynamic_iteration_tolerance": 1e-6 + }, + "handle": { + "type": "rigid", + "value": { + "length": 0.0, + "angle": 0.0, + "pivot": 0.0 + } + }, + "draw": { + "brace_height": 0.11825, + "draw_length": { + "type": "standard", + "value": 0.66825 + } + }, + "profile": { + "segments": [ + { + "type": "line", + "parameters": { + "length": 0.87 } - ], - "masses": { - "arrow": 0.08, - "limb_tip": 0.005, - "string_center": 0.005, - "string_tip": 0.005 - }, - "profile": [ - [ - 0.0, - 0.0 - ], - [ - 0.87, - 0.0 - ] - ], - "settings": { - "arrow_clamp_force": 0.0, - "n_draw_steps": 150, - "n_limb_elements": 40, - "n_string_elements": 45, - "sampling_rate": 10000.0, - "time_span_factor": 1.5, - "time_step_factor": 0.5 - }, - "string": { - "n_strands": 12, - "strand_density": 0.0005, - "strand_stiffness": 3500.0 + } + ] + }, + "section": { + "alignment": { + "type": "section_back" }, - "version": "0.8", "width": [ - [ + [ + 0.0, + 0.028575 + ], + [ + 0.258, + 0.028575 + ], + [ + 0.516, + 0.03175 + ], + [ + 1.0, + 0.015875 + ] + ], + "materials": [ + { + "name": "unnamed", + "color": "#b88e65", + "density": 600.0, + "youngs_modulus": 15000000000.0, + "shear_modulus": 6000000000.0, + "tensile_strength": 0.0, + "compressive_strength": 0.0, + "safety_margin": 0.0 + } + ], + "layers": [ + { + "name": "unnamed", + "material": "unnamed", + "height": [ + [ 0.0, - 0.028575 - ], - [ - 0.258, - 0.028575 - ], - [ - 0.516, 0.03175 - ], - [ + ], + [ + 0.05, + 0.03 + ], + [ + 0.058, + 0.025 + ], + [ + 0.08, + 0.02 + ], + [ 1.0, - 0.015875 + 0.0127 + ] ] + } ] -} + }, + "string": { + "strand_stiffness": 3500.0, + "strand_density": 0.0005, + "n_strands": 12 + }, + "masses": { + "arrow": { + "type": "mass", + "value": 0.08 + }, + "limb_tip": 0.005, + "string_center": 0.005, + "string_tip": 0.005 + }, + "damping": { + "damping_ratio_limbs": 0.0, + "damping_ratio_string": 0.0 + } +} \ No newline at end of file diff --git a/docs/examples/bows/longbow.bow.bak b/docs/examples/bows/longbow.bow.bak new file mode 100644 index 00000000..3644ef61 --- /dev/null +++ b/docs/examples/bows/longbow.bow.bak @@ -0,0 +1,92 @@ +{ + "comment": "", + "damping": { + "damping_ratio_limbs": 0.0, + "damping_ratio_string": 0.0 + }, + "dimensions": { + "brace_height": 0.15, + "draw_length": 0.7, + "handle_angle": 0.0, + "handle_length": 0.0, + "handle_setback": 0.0 + }, + "layers": [ + { + "E": 15000000000.0, + "height": [ + [ + 0.0, + 0.03175 + ], + [ + 0.05, + 0.03 + ], + [ + 0.058, + 0.025 + ], + [ + 0.08, + 0.02 + ], + [ + 1.0, + 0.0127 + ] + ], + "name": "unnamed", + "rho": 600.0 + } + ], + "masses": { + "arrow": 0.08, + "limb_tip": 0.005, + "string_center": 0.005, + "string_tip": 0.005 + }, + "profile": [ + [ + 0.0, + 0.0 + ], + [ + 0.87, + 0.0 + ] + ], + "settings": { + "arrow_clamp_force": 0.0, + "n_draw_steps": 150, + "n_limb_elements": 40, + "n_string_elements": 45, + "sampling_rate": 10000.0, + "time_span_factor": 1.5, + "time_step_factor": 0.5 + }, + "string": { + "n_strands": 12, + "strand_density": 0.0005, + "strand_stiffness": 3500.0 + }, + "version": "0.8", + "width": [ + [ + 0.0, + 0.028575 + ], + [ + 0.258, + 0.028575 + ], + [ + 0.516, + 0.03175 + ], + [ + 1.0, + 0.015875 + ] + ] +} diff --git a/docs/examples/bows/screenshot_example_1.bow b/docs/examples/bows/screenshot_example_1.bow index 8bc7fe64..9d74739e 100644 --- a/docs/examples/bows/screenshot_example_1.bow +++ b/docs/examples/bows/screenshot_example_1.bow @@ -1,303 +1,266 @@ { - "comment": "Glass data from Bearpaw:\nhttps://shop.bearpaw-products.com/WebshopB2C/Roll_Powerglass_Crystal_Clear/P-4349", - "damping": { - "damping_ratio_limbs": 0.0, - "damping_ratio_string": 0.0 - }, - "dimensions": { - "brace_height": 0.25, - "draw_length": 0.7, - "handle_angle": 0.0, - "handle_length": 0.0, - "handle_setback": 0.0 - }, - "layers": [ - { - "height": [ - [ - 0.0, - 0.001 - ], - [ - 1.0, - 0.001 - ] - ], - "material": 0, - "name": "Layer 1" - }, - { - "height": [ - [ - 0.0, - 0.036 - ], - [ - 0.01, - 0.036 - ], - [ - 0.2, - 0.007 - ], - [ - 0.25, - 0.0033 - ], - [ - 0.3, - 0.003 - ], - [ - 1.0, - 0.0029 - ] - ], - "material": 1, - "name": "Layer 2" - }, - { - "height": [ - [ - 0.0, - 0.001 - ], - [ - 1.0, - 0.001 - ] - ], - "material": 2, - "name": "Layer 3" + "version": "0.10.0", + "comment": "Glass data from Bearpaw:\nhttps://shop.bearpaw-products.com/WebshopB2C/Roll_Powerglass_Crystal_Clear/P-4349", + "settings": { + "num_limb_elements": 25, + "num_limb_eval_points": 250, + "min_draw_resolution": 150, + "max_draw_resolution": 150, + "static_iteration_tolerance": 1e-6, + "arrow_clamp_force": 0.0, + "string_compression_factor": 1e-6, + "timespan_factor": 1.5, + "timeout_factor": 10.0, + "min_timestep": 1e-6, + "max_timestep": 0.0001, + "steps_per_period": 250, + "dynamic_iteration_tolerance": 1e-6 + }, + "handle": { + "type": "rigid", + "value": { + "length": 0.0, + "angle": 0.0, + "pivot": 0.0 + } + }, + "draw": { + "brace_height": 0.212, + "draw_length": { + "type": "standard", + "value": 0.6619999999999999 + } + }, + "profile": { + "segments": [ + { + "type": "spiral", + "parameters": { + "length": 0.1, + "radius_start": -0.15384615384615385, + "radius_end": 0.0 } - ], - "masses": { - "arrow": 0.025, - "limb_tip": 0.0, - "string_center": 0.0, - "string_tip": 0.0 - }, - "materials": [ - { - "E": 41000000000.0, - "color": "#1f77b4", - "name": "Glass", - "rho": 1920.0 - }, - { - "E": 13000000000.0, - "color": "#ff7f0e", - "name": "Maple", - "rho": 705.0 - }, - { - "E": 41000000000.0, - "color": "#1f77b4", - "name": "Glass", - "rho": 1920.0 + }, + { + "type": "line", + "parameters": { + "length": 0.13999999999999999 } - ], - "profile": [ - { - "parameters": [ - [ - "length", - 0.1 - ], - [ - "r_start", - -0.15384615384615385 - ], - [ - "r_end", - 0.0 - ] - ], - "type": "spiral" - }, - { - "parameters": [ - [ - "length", - 0.13999999999999999 - ] - ], - "type": "line" - }, - { - "parameters": [ - [ - "length", - 0.06 - ], - [ - "r_start", - 0.0 - ], - [ - "r_end", - 1.0 - ] - ], - "type": "spiral" - }, - { - "parameters": [ - [ - "length", - 0.10000000000000003 - ], - [ - "radius", - 1.0 - ] - ], - "type": "arc" - }, - { - "parameters": [ - [ - "length", - 0.09999999999999998 - ], - [ - "r_start", - 1.0 - ], - [ - "r_end", - 0.3333333333333333 - ] - ], - "type": "spiral" - }, - { - "parameters": [ - [ - "length", - 0.09999999999999998 - ], - [ - "r_start", - 0.3333333333333333 - ], - [ - "r_end", - 0.25 - ] - ], - "type": "spiral" - }, - { - "parameters": [ - [ - "length", - 0.08000000000000007 - ], - [ - "r_start", - 0.25 - ], - [ - "r_end", - 0.125 - ] - ], - "type": "spiral" - }, - { - "parameters": [ - [ - "length", - 0.04499999999999993 - ], - [ - "r_start", - 0.125 - ], - [ - "r_end", - 0.1 - ] - ], - "type": "spiral" + }, + { + "type": "spiral", + "parameters": { + "length": 0.06, + "radius_start": 0.0, + "radius_end": 1.0 } - ], - "settings": { - "arrow_clamp_force": 0.0, - "n_draw_steps": 150, - "n_limb_elements": 25, - "n_string_elements": 30, - "sampling_rate": 10000.0, - "time_span_factor": 1.5, - "time_step_factor": 0.2 - }, - "string": { - "n_strands": 12, - "strand_density": 0.0005, - "strand_stiffness": 3500.0 + }, + { + "type": "arc", + "parameters": { + "length": 0.10000000000000003, + "radius": 1.0 + } + }, + { + "type": "spiral", + "parameters": { + "length": 0.09999999999999998, + "radius_start": 1.0, + "radius_end": 0.3333333333333333 + } + }, + { + "type": "spiral", + "parameters": { + "length": 0.09999999999999998, + "radius_start": 0.3333333333333333, + "radius_end": 0.25 + } + }, + { + "type": "spiral", + "parameters": { + "length": 0.08000000000000007, + "radius_start": 0.25, + "radius_end": 0.125 + } + }, + { + "type": "spiral", + "parameters": { + "length": 0.04499999999999993, + "radius_start": 0.125, + "radius_end": 0.1 + } + } + ] + }, + "section": { + "alignment": { + "type": "section_back" }, - "version": "0.9", "width": [ - [ + [ + 0.0, + 0.016 + ], + [ + 0.0965517, + 0.016 + ], + [ + 0.124138, + 0.018 + ], + [ + 0.151724, + 0.023 + ], + [ + 0.17931, + 0.0305 + ], + [ + 0.206897, + 0.037 + ], + [ + 0.234483, + 0.0395 + ], + [ + 0.275862, + 0.0408 + ], + [ + 0.344828, + 0.0412 + ], + [ + 0.689655, + 0.0372 + ], + [ + 0.758621, + 0.0355 + ], + [ + 0.827586, + 0.0318 + ], + [ + 0.896552, + 0.0264 + ], + [ + 0.965517, + 0.018 + ], + [ + 1.0, + 0.012 + ] + ], + "materials": [ + { + "name": "Glass", + "color": "#4b4b4b", + "density": 1920.0, + "youngs_modulus": 41000000000.0, + "shear_modulus": 16400000000.0, + "tensile_strength": 0.0, + "compressive_strength": 0.0, + "safety_margin": 0.0 + }, + { + "name": "Maple", + "color": "#ff7f0e", + "density": 705.0, + "youngs_modulus": 13000000000.0, + "shear_modulus": 5200000000.0, + "tensile_strength": 0.0, + "compressive_strength": 0.0, + "safety_margin": 0.0 + } + ], + "layers": [ + { + "name": "Layer 1", + "material": "Glass", + "height": [ + [ 0.0, - 0.016 - ], - [ - 0.0965517, - 0.016 - ], - [ - 0.124138, - 0.018 - ], - [ - 0.151724, - 0.023 - ], - [ - 0.17931, - 0.0305 - ], - [ - 0.206897, - 0.037 - ], - [ - 0.234483, - 0.0395 - ], - [ - 0.275862, - 0.0408 - ], - [ - 0.344828, - 0.0412 - ], - [ - 0.689655, - 0.0372 - ], - [ - 0.758621, - 0.0355 - ], - [ - 0.827586, - 0.0318 - ], - [ - 0.896552, - 0.0264 - ], - [ - 0.965517, - 0.018 - ], - [ + 0.001 + ], + [ 1.0, - 0.012 + 0.001 + ] ] + }, + { + "name": "Layer 2", + "material": "Maple", + "height": [ + [ + 0.0, + 0.036 + ], + [ + 0.01, + 0.036 + ], + [ + 0.2, + 0.007 + ], + [ + 0.25, + 0.0033 + ], + [ + 0.3, + 0.003 + ], + [ + 1.0, + 0.0029 + ] + ] + }, + { + "name": "Layer 3", + "material": "Glass", + "height": [ + [ + 0.0, + 0.001 + ], + [ + 1.0, + 0.001 + ] + ] + } ] -} + }, + "string": { + "strand_stiffness": 3500.0, + "strand_density": 0.0005, + "n_strands": 12 + }, + "masses": { + "arrow": { + "type": "mass", + "value": 0.025 + }, + "limb_tip": 0.0, + "string_center": 0.0, + "string_tip": 0.0 + }, + "damping": { + "damping_ratio_limbs": 0.0, + "damping_ratio_string": 0.0 + } +} \ No newline at end of file diff --git a/docs/examples/bows/screenshot_example_1.bow.bak b/docs/examples/bows/screenshot_example_1.bow.bak new file mode 100644 index 00000000..fa046b5f --- /dev/null +++ b/docs/examples/bows/screenshot_example_1.bow.bak @@ -0,0 +1,240 @@ +{ + "comment": "Glass data from Bearpaw:\nhttps://shop.bearpaw-products.com/WebshopB2C/Roll_Powerglass_Crystal_Clear/P-4349", + "damping": { + "damping_ratio_limbs": 0.0, + "damping_ratio_string": 0.0 + }, + "dimensions": { + "brace_height": 0.25, + "draw_length": 0.7, + "handle_angle": 0.0, + "handle_length": 0.0, + "handle_setback": 0.0 + }, + "layers": [ + { + "height": [ + [ + 0.0, + 0.001 + ], + [ + 1.0, + 0.001 + ] + ], + "material": 0, + "name": "Layer 1" + }, + { + "height": [ + [ + 0.0, + 0.036 + ], + [ + 0.01, + 0.036 + ], + [ + 0.2, + 0.007 + ], + [ + 0.25, + 0.0033 + ], + [ + 0.3, + 0.003 + ], + [ + 1.0, + 0.0029 + ] + ], + "material": 1, + "name": "Layer 2" + }, + { + "height": [ + [ + 0.0, + 0.001 + ], + [ + 1.0, + 0.001 + ] + ], + "material": 2, + "name": "Layer 3" + } + ], + "masses": { + "arrow": 0.025, + "limb_tip": 0.0, + "string_center": 0.0, + "string_tip": 0.0 + }, + "materials": [ + { + "E": 41000000000.0, + "color": "#1f77b4", + "name": "Glass", + "rho": 1920.0 + }, + { + "E": 13000000000.0, + "color": "#ff7f0e", + "name": "Maple", + "rho": 705.0 + }, + { + "E": 41000000000.0, + "color": "#1f77b4", + "name": "Glass", + "rho": 1920.0 + } + ], + "profile": [ + { + "parameters": { + "length": 0.1, + "r_start": -0.15384615384615385, + "r_end": 0.0 + }, + "type": "spiral" + }, + { + "parameters": { + "length": 0.13999999999999999 + }, + "type": "line" + }, + { + "parameters": { + "length": 0.06, + "r_start": 0.0, + "r_end": 1.0 + }, + "type": "spiral" + }, + { + "parameters": { + "length": 0.10000000000000003, + "radius": 1.0 + }, + "type": "arc" + }, + { + "parameters": { + "length": 0.09999999999999998, + "r_start": 1.0, + "r_end": 0.3333333333333333 + }, + "type": "spiral" + }, + { + "parameters": { + "length": 0.09999999999999998, + "r_start": 0.3333333333333333, + "r_end": 0.25 + }, + "type": "spiral" + }, + { + "parameters": { + "length": 0.08000000000000007, + "r_start": 0.25, + "r_end": 0.125 + }, + "type": "spiral" + }, + { + "parameters": { + "length": 0.04499999999999993, + "r_start": 0.125, + "r_end": 0.1 + }, + "type": "spiral" + } + ], + "settings": { + "arrow_clamp_force": 0.0, + "n_draw_steps": 150, + "n_limb_elements": 25, + "n_string_elements": 30, + "sampling_rate": 10000.0, + "time_span_factor": 1.5, + "time_step_factor": 0.2 + }, + "string": { + "n_strands": 12, + "strand_density": 0.0005, + "strand_stiffness": 3500.0 + }, + "version": "0.9", + "width": [ + [ + 0.0, + 0.016 + ], + [ + 0.0965517, + 0.016 + ], + [ + 0.124138, + 0.018 + ], + [ + 0.151724, + 0.023 + ], + [ + 0.17931, + 0.0305 + ], + [ + 0.206897, + 0.037 + ], + [ + 0.234483, + 0.0395 + ], + [ + 0.275862, + 0.0408 + ], + [ + 0.344828, + 0.0412 + ], + [ + 0.689655, + 0.0372 + ], + [ + 0.758621, + 0.0355 + ], + [ + 0.827586, + 0.0318 + ], + [ + 0.896552, + 0.0264 + ], + [ + 0.965517, + 0.018 + ], + [ + 1.0, + 0.012 + ] + ] +} diff --git a/docs/examples/bows/screenshot_example_1.bow.bow.bak2 b/docs/examples/bows/screenshot_example_1.bow.bow.bak2 new file mode 100644 index 00000000..fa046b5f --- /dev/null +++ b/docs/examples/bows/screenshot_example_1.bow.bow.bak2 @@ -0,0 +1,240 @@ +{ + "comment": "Glass data from Bearpaw:\nhttps://shop.bearpaw-products.com/WebshopB2C/Roll_Powerglass_Crystal_Clear/P-4349", + "damping": { + "damping_ratio_limbs": 0.0, + "damping_ratio_string": 0.0 + }, + "dimensions": { + "brace_height": 0.25, + "draw_length": 0.7, + "handle_angle": 0.0, + "handle_length": 0.0, + "handle_setback": 0.0 + }, + "layers": [ + { + "height": [ + [ + 0.0, + 0.001 + ], + [ + 1.0, + 0.001 + ] + ], + "material": 0, + "name": "Layer 1" + }, + { + "height": [ + [ + 0.0, + 0.036 + ], + [ + 0.01, + 0.036 + ], + [ + 0.2, + 0.007 + ], + [ + 0.25, + 0.0033 + ], + [ + 0.3, + 0.003 + ], + [ + 1.0, + 0.0029 + ] + ], + "material": 1, + "name": "Layer 2" + }, + { + "height": [ + [ + 0.0, + 0.001 + ], + [ + 1.0, + 0.001 + ] + ], + "material": 2, + "name": "Layer 3" + } + ], + "masses": { + "arrow": 0.025, + "limb_tip": 0.0, + "string_center": 0.0, + "string_tip": 0.0 + }, + "materials": [ + { + "E": 41000000000.0, + "color": "#1f77b4", + "name": "Glass", + "rho": 1920.0 + }, + { + "E": 13000000000.0, + "color": "#ff7f0e", + "name": "Maple", + "rho": 705.0 + }, + { + "E": 41000000000.0, + "color": "#1f77b4", + "name": "Glass", + "rho": 1920.0 + } + ], + "profile": [ + { + "parameters": { + "length": 0.1, + "r_start": -0.15384615384615385, + "r_end": 0.0 + }, + "type": "spiral" + }, + { + "parameters": { + "length": 0.13999999999999999 + }, + "type": "line" + }, + { + "parameters": { + "length": 0.06, + "r_start": 0.0, + "r_end": 1.0 + }, + "type": "spiral" + }, + { + "parameters": { + "length": 0.10000000000000003, + "radius": 1.0 + }, + "type": "arc" + }, + { + "parameters": { + "length": 0.09999999999999998, + "r_start": 1.0, + "r_end": 0.3333333333333333 + }, + "type": "spiral" + }, + { + "parameters": { + "length": 0.09999999999999998, + "r_start": 0.3333333333333333, + "r_end": 0.25 + }, + "type": "spiral" + }, + { + "parameters": { + "length": 0.08000000000000007, + "r_start": 0.25, + "r_end": 0.125 + }, + "type": "spiral" + }, + { + "parameters": { + "length": 0.04499999999999993, + "r_start": 0.125, + "r_end": 0.1 + }, + "type": "spiral" + } + ], + "settings": { + "arrow_clamp_force": 0.0, + "n_draw_steps": 150, + "n_limb_elements": 25, + "n_string_elements": 30, + "sampling_rate": 10000.0, + "time_span_factor": 1.5, + "time_step_factor": 0.2 + }, + "string": { + "n_strands": 12, + "strand_density": 0.0005, + "strand_stiffness": 3500.0 + }, + "version": "0.9", + "width": [ + [ + 0.0, + 0.016 + ], + [ + 0.0965517, + 0.016 + ], + [ + 0.124138, + 0.018 + ], + [ + 0.151724, + 0.023 + ], + [ + 0.17931, + 0.0305 + ], + [ + 0.206897, + 0.037 + ], + [ + 0.234483, + 0.0395 + ], + [ + 0.275862, + 0.0408 + ], + [ + 0.344828, + 0.0412 + ], + [ + 0.689655, + 0.0372 + ], + [ + 0.758621, + 0.0355 + ], + [ + 0.827586, + 0.0318 + ], + [ + 0.896552, + 0.0264 + ], + [ + 0.965517, + 0.018 + ], + [ + 1.0, + 0.012 + ] + ] +} diff --git a/docs/examples/bows/screenshot_example_olympic_recurve.bow b/docs/examples/bows/screenshot_example_olympic_recurve.bow new file mode 100644 index 00000000..3df3865f --- /dev/null +++ b/docs/examples/bows/screenshot_example_olympic_recurve.bow @@ -0,0 +1,203 @@ +{ + "version": "0.10.0", + "comment": "", + "settings": { + "num_limb_elements": 30, + "num_limb_eval_points": 250, + "min_draw_resolution": 100, + "max_draw_resolution": 100, + "static_iteration_tolerance": 1e-6, + "arrow_clamp_force": 0.5, + "string_compression_factor": 1e-6, + "timespan_factor": 1.5, + "timeout_factor": 10.0, + "min_timestep": 1e-6, + "max_timestep": 0.0001, + "steps_per_period": 250, + "dynamic_iteration_tolerance": 1e-6 + }, + "handle": { + "type": "rigid", + "value": { + "length": 0.45, + "angle": -0.3490658503988659, + "pivot": 0.0 + } + }, + "draw": { + "brace_height": 0.2, + "draw_length": { + "type": "standard", + "value": 0.7 + } + }, + "profile": { + "segments": [ + { + "type": "spiral", + "parameters": { + "length": 0.3, + "radius_start": 0.0, + "radius_end": 0.7000000000000001 + } + }, + { + "type": "spiral", + "parameters": { + "length": 0.225, + "radius_start": 0.7000000000000001, + "radius_end": 0.09 + } + } + ] + }, + "section": { + "alignment": { + "type": "section_back" + }, + "width": [ + [ + 0.0, + 0.039 + ], + [ + 0.6, + 0.034 + ], + [ + 1.0, + 0.014 + ] + ], + "materials": [ + { + "name": "Wood 1", + "color": "#d0b391", + "density": 675.0, + "youngs_modulus": 12000000000.0, + "shear_modulus": 6000000000.0, + "tensile_strength": 0.0, + "compressive_strength": 0.0, + "safety_margin": 0.0 + }, + { + "name": "Wood 2", + "color": "#947f67", + "density": 675.0, + "youngs_modulus": 12000000000.0, + "shear_modulus": 6000000000.0, + "tensile_strength": 0.0, + "compressive_strength": 0.0, + "safety_margin": 0.0 + }, + { + "name": "Glass", + "color": "#eeeeee", + "density": 675.0, + "youngs_modulus": 12000000000.0, + "shear_modulus": 6000000000.0, + "tensile_strength": 0.0, + "compressive_strength": 0.0, + "safety_margin": 0.0 + } + ], + "layers": [ + { + "name": "Backing", + "material": "Glass", + "height": [ + [ + 0.0, + 0.001 + ], + [ + 1.0, + 0.001 + ] + ] + }, + { + "name": "Core 1", + "material": "Wood 2", + "height": [ + [ + 0.0, + 0.001 + ], + [ + 1.0, + 0.001 + ] + ] + }, + { + "name": "Fadeout", + "material": "Wood 1", + "height": [ + [ + 0.0, + 0.007 + ], + [ + 0.02, + 0.007 + ], + [ + 0.18, + 0.0001 + ], + [ + 0.2, + 0.0 + ] + ] + }, + { + "name": "Core 2", + "material": "Wood 2", + "height": [ + [ + 0.0, + 0.001 + ], + [ + 1.0, + 0.001 + ] + ] + }, + { + "name": "Facing", + "material": "Glass", + "height": [ + [ + 0.0, + 0.001 + ], + [ + 1.0, + 0.001 + ] + ] + } + ] + }, + "string": { + "strand_stiffness": 3500.0, + "strand_density": 0.0005, + "n_strands": 12 + }, + "masses": { + "arrow": { + "type": "mass", + "value": 0.025 + }, + "limb_tip": 0.0, + "string_center": 0.0, + "string_tip": 0.0 + }, + "damping": { + "damping_ratio_limbs": 0.05, + "damping_ratio_string": 0.05 + } +} \ No newline at end of file diff --git a/docs/examples/bows/screenshot_example_rigid-fadeouts.bow b/docs/examples/bows/screenshot_example_rigid-fadeouts.bow new file mode 100644 index 00000000..2ff96884 --- /dev/null +++ b/docs/examples/bows/screenshot_example_rigid-fadeouts.bow @@ -0,0 +1,207 @@ +{ + "version": "0.10.0", + "comment": "", + "settings": { + "num_limb_elements": 30, + "num_limb_eval_points": 250, + "min_draw_resolution": 100, + "max_draw_resolution": 100, + "static_iteration_tolerance": 1e-6, + "arrow_clamp_force": 0.5, + "string_compression_factor": 1e-6, + "timespan_factor": 1.5, + "timeout_factor": 10.0, + "min_timestep": 1e-6, + "max_timestep": 0.0001, + "steps_per_period": 250, + "dynamic_iteration_tolerance": 1e-6 + }, + "handle": { + "type": "rigid", + "value": { + "length": 0.05, + "angle": 0.0, + "pivot": 0.0 + } + }, + "draw": { + "brace_height": 0.2, + "draw_length": { + "type": "standard", + "value": 0.7 + } + }, + "profile": { + "segments": [ + { + "type": "spiral", + "parameters": { + "length": 0.3, + "radius_start": 0.0, + "radius_end": 0.7000000000000001 + } + }, + { + "type": "spiral", + "parameters": { + "length": 0.225, + "radius_start": 0.7000000000000001, + "radius_end": 0.09 + } + } + ] + }, + "section": { + "alignment": { + "type": "section_back" + }, + "width": [ + [ + 0.0, + 0.02 + ], + [ + 0.01, + 0.02 + ], + [ + 0.1, + 0.034 + ], + [ + 0.6, + 0.034 + ], + [ + 1.0, + 0.014 + ] + ], + "materials": [ + { + "name": "Wood 1", + "color": "#563232", + "density": 675.0, + "youngs_modulus": 12000000000.0, + "shear_modulus": 6000000000.0, + "tensile_strength": 0.0, + "compressive_strength": 0.0, + "safety_margin": 0.0 + }, + { + "name": "Wood 2", + "color": "#ffc18c", + "density": 675.0, + "youngs_modulus": 12000000000.0, + "shear_modulus": 6000000000.0, + "tensile_strength": 0.0, + "compressive_strength": 0.0, + "safety_margin": 0.0 + }, + { + "name": "Glass", + "color": "#847a62", + "density": 675.0, + "youngs_modulus": 12000000000.0, + "shear_modulus": 6000000000.0, + "tensile_strength": 0.0, + "compressive_strength": 0.0, + "safety_margin": 0.0 + } + ], + "layers": [ + { + "name": "Backing", + "material": "Glass", + "height": [ + [ + 0.0, + 0.001 + ], + [ + 1.0, + 0.001 + ] + ] + }, + { + "name": "Core 1", + "material": "Wood 2", + "height": [ + [ + 0.0, + 0.001 + ], + [ + 1.0, + 0.001 + ] + ] + }, + { + "name": "Fadeout", + "material": "Wood 1", + "height": [ + [ + 0.0, + 0.015 + ], + [ + 0.1, + 0.004 + ], + [ + 0.25, + 0.0 + ] + ] + }, + { + "name": "Core 2", + "material": "Wood 2", + "height": [ + [ + 0.0, + 0.001 + ], + [ + 1.0, + 0.001 + ] + ] + }, + { + "name": "Facing", + "material": "Glass", + "height": [ + [ + 0.0, + 0.001 + ], + [ + 1.0, + 0.001 + ] + ] + } + ] + }, + "string": { + "strand_stiffness": 3500.0, + "strand_density": 0.0005, + "n_strands": 12 + }, + "masses": { + "arrow": { + "type": "mass", + "value": 0.025 + }, + "limb_tip": 0.0, + "string_center": 0.0, + "string_tip": 0.0 + }, + "damping": { + "damping_ratio_limbs": 0.05, + "damping_ratio_string": 0.05 + } +} \ No newline at end of file diff --git a/docs/user-manual/README.md b/docs/user-manual/README.md index 1e3a6ef1..82782f5d 100644 --- a/docs/user-manual/README.md +++ b/docs/user-manual/README.md @@ -1,6 +1,6 @@ # User Manual -The user manual is created with [mdBook](https://github.com/rust-lang/mdBook) version 0.4.21, a tool that creates documentation from markdown files. +The user manual is created with [mdBook](https://github.com/rust-lang/mdBook), a tool that creates documentation from markdown files. The following commands might be useful: - `mdbook serve` for serving the documentation locally and update it on changes diff --git a/docs/user-manual/book.toml b/docs/user-manual/book.toml index 91fb8c39..24930f62 100644 --- a/docs/user-manual/book.toml +++ b/docs/user-manual/book.toml @@ -1,9 +1,8 @@ [book] authors = ["Stefan Pfeifer"] language = "en" -multilingual = false src = "source" -title = "User Manual - VirtualBow v0.9.1" +title = "User Manual - VirtualBow v0.10.0" [output.html] mathjax-support = true diff --git a/docs/user-manual/source/SUMMARY.md b/docs/user-manual/source/SUMMARY.md index 256da745..0f41c622 100644 --- a/docs/user-manual/source/SUMMARY.md +++ b/docs/user-manual/source/SUMMARY.md @@ -5,7 +5,8 @@ - [Model Editor](model-editor.md) - [Comments](model-editor-comments.md) - [Settings](model-editor-settings.md) - - [Dimensions](model-editor-dimensions.md) + - [Handle](model-editor-handle.md) + - [Draw](model-editor-draw.md) - [Materials](model-editor-materials.md) - [Layers](model-editor-layers.md) - [Profile](model-editor-profile.md) @@ -17,6 +18,8 @@ - [Result Viewer](result-viewer.md) - [Characteristics](result-viewer-characteristics.md) - [Shape](result-viewer-shape.md) + - [Draw](result-viewer-draw.md) + - [Arrow](result-viewer-arrow.md) - [Stress](result-viewer-stress.md) - [Curvature](result-viewer-curvature.md) - [Energy](result-viewer-energy.md) @@ -28,7 +31,5 @@ - [Scripting](solver-scripting.md) - [Appendix](appendix.md) - - [A - Model Files](appendix-model-files.md) - - [B - Result Files](appendix-result-files.md) - - [C - Bending Test](appendix-bending-test.md) - - [D - Tips & Tricks](appendix-tips-and-tricks.md) \ No newline at end of file + - [A - Tips & Tricks](appendix-tips-and-tricks.md) + - [B - Bending Test](appendix-bending-test.md) diff --git a/docs/user-manual/source/appendix-tips-and-tricks.md b/docs/user-manual/source/appendix-tips-and-tricks.md index b9edb073..25074499 100644 --- a/docs/user-manual/source/appendix-tips-and-tricks.md +++ b/docs/user-manual/source/appendix-tips-and-tricks.md @@ -1,6 +1,6 @@ # Tips & Tricks -This section contains various notes about useful features of VirtualBow that didn't reall fit anywhere else in this manual. +This section collects various notes about useful VirtualBow features that didn't quite fit into any other part of the manual. ## Units @@ -18,7 +18,7 @@ There are also two pre-defined sets of defaults, one for SI units and one for US You can use those by clicking either of the buttons on the bottom left. It is worth noting that the units only affect how values are shown in the user interface. -The data in the model and result files is always stored in SI base units, so they can be exchanged with other users who might have different unit preferences. +The data in the model and result files is always stored in SI base units. ## Plots @@ -88,4 +88,4 @@ Copy and paste also works between VirtualBow and other applications, for example
Figure: Table context menu
-
\ No newline at end of file + diff --git a/docs/user-manual/source/files/mass-per-energy.ods b/docs/user-manual/source/files/mass-per-energy.ods new file mode 100644 index 0000000000000000000000000000000000000000..7a875e8b16d8e1003f52f76261ac8f48939c8826 GIT binary patch literal 29005 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 - - - - - - - - - image/svg+xml - - - - - - - - - - - - - - - - - - - - - - - - - Handle length - Handlesetback - Handleangle - Braceheight - - Draw length - - - - - - - - - - - - - - - - diff --git a/docs/user-manual/source/images/draw-definition.svg b/docs/user-manual/source/images/draw-definition.svg new file mode 100644 index 00000000..4e409920 --- /dev/null +++ b/docs/user-manual/source/images/draw-definition.svg @@ -0,0 +1,437 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + image/svg+xml + + + + + + + + + + + + + + + + + Brace height + Pivot point + True draw length + AMO draw length + + + + + + + + 1.75" + + + diff --git a/docs/user-manual/source/images/icons/model-comments.png b/docs/user-manual/source/images/icons/model-comments.png new file mode 100644 index 0000000000000000000000000000000000000000..2a27dfae28f051919eaefe4291ead46ab50a7e5a GIT binary patch literal 596 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 A0RR91 literal 0 HcmV?d00001 diff --git a/docs/user-manual/source/images/layer-rules-1.png b/docs/user-manual/source/images/layer-rules-1.png new file mode 100644 index 0000000000000000000000000000000000000000..7b40b1e108c965a63524258ffe248f4f313b2352 GIT binary patch literal 36481 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Ⓢ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 literal 0 HcmV?d00001 diff --git a/docs/user-manual/source/images/layer-rules-2.png b/docs/user-manual/source/images/layer-rules-2.png new file mode 100644 index 0000000000000000000000000000000000000000..803120c7e5a772ba738a2ab3967d3f08904a38da GIT binary patch literal 24111 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 Y-eL32dsu=U_$d%O8^?3yKU}-}Z`*zl5C8xG literal 0 HcmV?d00001 diff --git a/docs/user-manual/source/images/mass-limb-tip.png b/docs/user-manual/source/images/mass-limb-tip.png new file mode 100644 index 0000000000000000000000000000000000000000..bb62c8eb72556c98a7ec30e255038128eb717e19 GIT binary patch literal 105337 zcmZ^KQ+Ot8w{4s+X2*6qwrxAZ&j%{>0wylnB>tyY7{)_Xhf8P`?s@|%1 zVoZz~t|%{o0E+_)0s?{{B`K;50s_AJb^Q*2`Z|iJBdLOb5P?XE3aPs3oq0ohC8;fb zq^BGoM+adDUv^1eiiwI<=KZMaaDhD4Qa>Yk(6c+&RkE%OD3G)zZWQ#$HTKB;bhI(( zdG~!iu7EQ|oqWTSN*`Z;?Y#8fdd<4cIy9Fg2=F5!0sz4Nb+TJVp2ll-P2fO>yC>%T5b1i%xA2r?%WXWXy)U)CjFbwKo7Yhl7HD`hM!1@26E$JhD==hM-qy6{4_bLVXA)gl>8GOc< zZ+i7R`>xcR%)PaTWQ^a5s?f5KGtC!^s54U13>dQFXgm_KU*FRQmI9whFX?)JDxxiVsQh67rzyp)=z<`dmZsAT)vt`)>`H z4nY1|ApmhPp5O#6mY@5j%XLdjT~~WUFEdV%zbChm8^MA~w%t6A*&50+)v|;&G9?Dz z72bjr)Pa3oS+Qf&FIh@nN@5(a`rxhX1ldog_q}JbJO?xxCe(m<%}| zAEB3>7jO^>IJ)$(Vuk2)mQ?7lN)83dl_6N^KYd2!Wb>Sm&sS6im1wu~@;Y*undizj zG0FAEWe4wK$ibmwGqPrEJ$7<=A)h(_iyHg|`_d76d#nssWZTX<>)}Eff_F~jJ7YFh z*0`0Qg^IM|#KVJC>NL;11kz!UR7#lnZ}2oLtf1T|qHERn@nVPhFE3j4Mf-{(%aRNH zbWP{8m(}5pm>aX54G9XE|FROHJokULk+*edqO?F)<9F*dsqc*&@4Ifb_>D)Gal;A~ zR&+iDk1%&&4(gppeW84&SM)sfgs^7WTn--){`l=)^usbDATE(QJ&PFs7_EWo=ZFsf zZNY0ybf(m(;D51^C$ulkc&7}&k0o?oe49(bz_@6K7tMUajuac76y?DxqT1Wl%J!GV zV0m7rmu@;KiAG>hw9EhU)E|q3gJ*}qp-ctufDfOznO7V)C4*CyBAF>@ z`YRX=l#sk1o^B3HOq@rYQh@-mU_%i7Mp0QAH8>!MmXmkJn&Rg8Y+q%vyRv7Hzm{T> zIBo~#-x_MS{EwSiCI({Lw*DO8*|_Yy-T6k~YUEkECdKrC5gR0_pcQ9>KhT?nU`GIb zsg8ZlDCt%JxneDnwpxs3K3QZ~gup#~=|ok|g?1h$F45db<`5!xUwD|aG?c+q(P@%L zT!{W}iEdvJ6N$cF8Lkv;S{#g9(ER#NGXxn3dh_BP7Zpe)!k&}2K$;l+V*Mr?x@uju zS#;7^IKz0-7_JOYe3D~SxI2hQ5?zziIq4xSCq>*NAT3{$o6s;jT%+KE!1wTXv-~+Q zQX8F$`G-(mI&#)ZUb* z!&E(w<76wJAMbV$*wz97HXQeO@j^9GZM1MDG8_`vP^vz2RZ;DCg3lIQqa^r(jT$3v zIh^&t-_gm8(veEAVJ@7N#j8-IB&$N+^`5@k9F#oI254E@z9^CwqG_V!o?>dw~%C0)D+#mpuYy=2JN+(1_^w zmSv86&?0@J5g}cC?GH~bZ%@~@^4Z+ZhlFn0&uIVAtvoSOBGC>p!tO1Br*Aascir#J z+TDXt0&_cM;C+J_{Ue^ia=x=^TF#T@zB+Cfbrh24P}6NsW3Nxs}(MH zi5bt$d`jL>b2=)jY|)bTFkH5~vN!F(e>-f%jFwVu&^5xHS%4bF0asn)~TW2AT}^1reocvp0c=n zD--^yD?HpKPW*nNbZ28N4pVf^c%CNIA+S&0aNf0a-#9_S$k`dk=jT=@=-lJb%)ALz zfZ#gO_G3r&)oY+HLP+O`DOwF3sTYc{s)m{rPqS^w1TOn@cL5(dxZ#LprU>85-K*VQ z(RFG`sVhxnrqr-tj3va!LrX{X`_*o2^{<+mDR`mqzRmP}WG!J5RVzj;YA}5yT~!(J zb)M?hlZq8M`tGOqLLA2Q&i|{Sy-K0~1E_H|I&Jl@1;I=2M-FWXB=G>#$pm|Z=Qs1y z;Pd!C13`@6HO#9R)=2@wPMH(x4*mY?LEJ!G%SIKn09FfgB%Fl~{O6Ogk-TW-z`5v0 zre9Gm9`rBfxO2Q4LsJ)P`IqC~5-6R_YC_u_#K^GEHrF1!Es*a7*)U{lc}ocxRd<$F z-_4g6s~SyqJ-*Xz#=3aY$6->*MNu%XB$R2_@NZ3W`y8ZOw0TSW%t4PtLim#g^#;cB zyY=zdzP)dTybLA@_9BTT65xMl-McT)hPPWS(t4#$aZ`OZL++)SmfJCtjg)a-p|8CE9V)1$)*SK?-Yw?*Q{Dv12 zbfq|L{uAIPHsa@(x|t;@b=+n($@v)2w$bsJ*nW=Tf!KIw=zG7Qp&85nvJKtga!DZ1 zICtmH%Q((T6@Wj;7yP*|NN-jT4hms~HtzHmKE%-BJA!7`eAhPi1o{8sMgOh9FS&08 zs>Au5-%bheowS+d>K@-d-|g7_00u4F^G3Z`C5{9EeG?&c`X6?2tj~zSmrmG@;vt|x*E#k!B3e|bo*zjlVIoMTjq*?z^;m=;T zH4G}p($c7%GZg(1#eI&ycku`;BR?0^D)iT3k`ejXwh*}uom%lu>ZO@Ohw%C4A2-F; zcV6u)ffg+c8_*Q&JZv>Oca)b6xmMoU80B)YES~($1=sNx zW^w6 z0oQyImzu_)l1NS7-WPfpT-dl5uDG2?A2*$c{>F<8#cti1#cJ>?{3m%Zr~eA=IWTX0 z{~mT<{cb=@;cwrQ8UE9>J{iffq%M>K|x$4C>V zj@v+B6%Jl{)_-99>MJ&$;fIwEU1>1$?lOCd(DXzk+5JX zRzg=6<^u0vmk5dLS)(6sf%`drswnE&XE8@5ASOZH(UO4eYviYy$WSK4z9uXrIc_Ay z6|54&<62a5&PWU<(f3TQ@@4`-lnI>MrqV@$gLpMZnU5ezjD}T*eR&&wtF#-!SZ(#; zYug}5%XL?s9y9mzX6fMEy%$HfZzyaKx5{H=UhPZsKRZ5u(6fI(@Bhl?(wFeQ?Bqbk zh`{$G{VVp%lG4!kSmAS=>bOG8YWXNAAW_lP&9-+H657J&;XrzN$V`?wv9hA>Gf;la zfGJgu0KQf6Ukw)S?0B*M z&2-E==mbst{l}NQ$zDFt$LzOGc{Pp=m)9@%B60cBFhrY631~EhNTJu|zPTA=`0Qqz zQaYdjG^&1CR?9r;BkmBN#cXSGTv3cj!C7vC{f7$0s!k?89I0c-qV7x>)WzWPQDHXn zlKH98@^S+;&Z<}4Z5^UO!}0I=QeEb3MneF(7=964$H*|-N)8C*Z*JIa+wt&lbat~& zw&Mg!h1Br@TVBbVdi8L>F*V=vtz8dU@O~kD>F>gzNX#oX5kIq&Q2POQJZVNb zr~L{1=^nTh`xua|T*wZ`UC7QfG;Qdow(kc-c{+4I5>9R1uSV5jGGr^ni0sznmiV6c zIcOLhUcrjQG+^l^ZvL(#LW_*PjYACC`#2D3M0&#E+T6UGerTHM*^M+U@h_23PzRzz z{KfNk-E=SI0X#4_`pdSTRQ#%KtbS*n45jTygNWh&XLJ6FeDs1xN^~__ue78Uut!bs z;SDWVyYEiM)UGq&zG=4off7M!e3XX729W#;@xswUBrhgQfWwBFthZ32v7C7^7oF1K zHW>xXx>raMUJEi`h_LHOh@^1Xz)8+tZ9ZUHk^)g)6V`OdF?~*~ZZ0_eI{vbwU2-Lbl`=2R(g4V1?et z&@dp5z=#Jg9?fd8c$TQZ^j>Ghp7MtViy>dOlX7j8gl-ERbHHgcA*z>TOsTVF* zsJrYqWXX2<<964opM_bxO=}F#gdjlB>I=18tT-cj7(-#u27OkSx6}IMci*<7k2u&? zwcYlK%7XVswhj9)KknwfakPXykKjT0F9v*htVIX1&m~?x_xSCBI?3jA7&hC# zNGQNb{-atZSUWj(_8S;=QinC1v<$;Q2$cp&s;CU>?2}v|<7(|vC=-reYNg}M@f`GY z7(aelcVk*51)rq^coKw!rmZ(=I%-21iFIMpo4*-?z%@fnv$DB~RzPnJ$#xly*560> znrSOTpO8Ft^piL$vL>C>2{KR2`W15M2Ne6`jclg4$5kUV7!11XDlaHwQp@Xrb??K1wJ(@UTzlU9jU<4M-72T(-~c;H z{NyP>u7y^fpHDz8se_6V67gNy@i5zdplNBVzOikHA(!DFzhu+pyaO4__cqO*eA$9Lf`8`ZM$pu|0o@b+htXYIA8N!J`!#gLb*=Nyp!(?iKJDiD>OP5 z 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 <@y0OKQ1)x-0S9gz^1P`oc8JOWj6 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ⅈcB9Tm0NT|Q=`Y`0IVb<@ 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 ZMZhb49={7(LFa(qLzt?3Db&ROe*lei5c2>4 literal 0 HcmV?d00001 diff --git a/docs/user-manual/source/images/mass-string-center.png b/docs/user-manual/source/images/mass-string-center.png new file mode 100644 index 0000000000000000000000000000000000000000..82189a4ac90fc89e6ea8933a1aab7456fa4ef90b GIT binary patch literal 41343 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 h8s0FOm5q0250R_4IN_`+#Rb5*F68R(7Y8m~E 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 + + + + + + + + + image/svg+xml + + + + + + + + + + + + + + + + + + + + + + + + + + Length + Pivot + Angle + + + + + + + + Limb attachmentpoint + + Limb attachmentpoint + + Pivot point + + + + + + + + diff --git a/docs/user-manual/source/images/screenshots/editor/damping.png b/docs/user-manual/source/images/screenshots/editor/damping.png deleted file mode 100644 index 38ab0416a46df575a90fb3b391da0eae7ba5cf9e..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 2408 zcmeHJ`#0O!7LUg;9mTZ0hEhrA(Lt2aqDpS6`pPgPsYkrUt0*mrhJ+&NjA=X7R=BOI zx0Z+oL9-$Zk*ggdUcnRw-en|0 z_Y>n!Kp>E=>$ev?K_E44RTzD&uF3$e6>X|R4eyCK2V(RenO70bXcu=E5U7Eovm5r2 zitodH>yHP44krE)YCseu83g)R;d;TvI~gOHIDtAs1oNiFz|W@p%(G3{6}U`%7{fKv zt>6~5<(1t%*h(Kcia?b1SZfus zGEz!9nXnJ_9ccuTZB+DoS}AEk&6JvnI;lP~NM_-}Odj0{%ULDHL zG~SxXSF#Sdtax%tI*zaj7EugFm*MalIA=5!w|@R7kEDTZmP1=D(8G2Rs_NLMWsI6M z^0It=GDNA#(@73Nk}<0bt2gX_wG*LXy^m>HP8!H{7v~_@&HDM)*!u7*qP-VN|H*kc z8OQuPw9piOyK6lz-86D z`m_akdrog{^VRgkv4ar$d=+i?`a7y}*OU~buV>6rloFjNnU=n@sdu?DMBXCPcbw|xkG8Bc zzTV<_Y_!Jwl7mBgg;mh@^?7+eT?buscNM*#;bJOvUJ(dxkmq8H6+=UBt%Cf=VrEar ztYjg{jqrtq51ait&yqKH!e&Lv?ZIVjr7<~IC-=lCb>qD>yjrgG}#U&n=!%TsTi9=6ds)EZ~7xmUx| z_|C&xCy7?OC~J&{*jM`y??eM)^mvb0vy6ZzN|~!W*mPq!!PuC4yPBzBdjkA1+DW5= zZg!T`;XR};>w>!BZLDd#5&hQhspB@!3(6)$8biGh^6sFuy8Wy{c2wJTJTq7`mYVsH z48%d&sWJ%{Tu^rOh5A3B{{i=gOb*P}mM9f!r;GU_K}pq3K24t@)W$wj=AIXkwg+FM zD0Nn-5=rq|PVy8lGtjw}q>$eYl$6UNChY-A~A5vE;0F%@8lex+{yKrs-EEX%+S%$}K%q26A%Sr6L%=taDw zAQp{HXZWLUzf7$6r<|!HVn>}%yNo4T1y)bW!(>8vkU!j4-yMBOyD%hnW=%eD=uH5u zvKLU?v;wnAr&z4Xknw~l>5>SVzoYo_JWRe3KUr+Iq`JUbs(jhvBR*mMKz^N8Md}%R zy`x=7(M9ErX*0qT!WhBOOOT`oHBXDVBi7#0YGQL6DaZzyblGn)4(>S5TYU6^eve;% z1j5xxZw!WLbtjd3Ew|!z?n{P}C9Z_wPB}~d3woCRx4h1ds+qC-c`Au5^G8B)^v8DH zDP5sePW&E2fsmS@Wi~cUsZGa}`t7fCOGpXIj_6pKXc6MspB3V#Ij~98D$+a{p})L= zw}_rqjAjiw@)>#-lCohgv?KDQ7^-DRhA!hIi3xb(G>Mr@t!>YjO`L3crK`nuz-ya@} ze(c;1-maGLr#>&XmTkSOsr0$H4W94HyKNj<&93rtqmVI`MQcs?qcJ|Zm4!K? z9^CQR_(N-1rFb0Bl2>J%Y@IHSJw_w$l`G?FFZqwi-8;h!V)-^ z{jyw7(AvXj9X|e042Beqy`fj>=@px#yJiHFE9lN00atm8hfHd68k)ZN zdEeQkJ>^fU`M2Nv1^+eP|G$r@$j7#gUpM^0txiV1@~K(bobHm9YC8hCUPNACoD2Q& EUw$>jy-aqX9y}qAo@5rZm>MZBE&I14d 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 diff --git a/docs/user-manual/source/images/screenshots/editor/handle-flexible-example-1.png b/docs/user-manual/source/images/screenshots/editor/handle-flexible-example-1.png new file mode 100644 index 0000000000000000000000000000000000000000..5239857cf887933f2069d0082b049c9b1b4ef241 GIT binary patch literal 12303 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 y$w+Fi4L6;FRqZ$&^<#0#xzWL_F}L+XD6P<}7~ literal 0 HcmV?d00001 diff --git a/docs/user-manual/source/images/screenshots/editor/handle-flexible-example-2.png b/docs/user-manual/source/images/screenshots/editor/handle-flexible-example-2.png new file mode 100644 index 0000000000000000000000000000000000000000..1eeaf1b217b27300d720abe33ceacbd5917e4831 GIT binary patch literal 11788 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 U8TPmB1sH~OH4QbY?$}5C58m!3_W%F@ literal 0 HcmV?d00001 diff --git a/docs/user-manual/source/images/screenshots/editor/handle-flexible-example-3.png b/docs/user-manual/source/images/screenshots/editor/handle-flexible-example-3.png new file mode 100644 index 0000000000000000000000000000000000000000..643fd4df96b1e1225d23abc1cdd0be59c38d22e6 GIT binary patch literal 21926 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 literal 0 HcmV?d00001 diff --git a/docs/user-manual/source/images/screenshots/editor/handle-rigid-example-1.png b/docs/user-manual/source/images/screenshots/editor/handle-rigid-example-1.png new file mode 100644 index 0000000000000000000000000000000000000000..78f6f4431e8fbf92fc92eb68bcb16e2fa39730a6 GIT binary patch literal 48859 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 literal 0 HcmV?d00001 diff --git a/docs/user-manual/source/images/screenshots/editor/handle-rigid-example-2.png b/docs/user-manual/source/images/screenshots/editor/handle-rigid-example-2.png new file mode 100644 index 0000000000000000000000000000000000000000..efa2ee970b0c456ac337794296e95654eed412fe GIT binary patch literal 15818 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 diff --git a/docs/user-manual/source/images/screenshots/editor/profile-line.png b/docs/user-manual/source/images/screenshots/editor/profile-line.png deleted file mode 100644 index 8be1c3cd15fe0d6431e64359a37f814c62a16b79..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 3186 zcmeH~`8O2mAIC>2HRv{SsVn=$y^+3_ znMe$SAxmQmHHIu>%2w7vW*D=5r+dEV`#*foxj%f)bKcK+&ii~mpXc+u&UwbY44QMV%g!HWoP8R@x8oZp~#vX~@ z_ltu!3II41^CP6DZt9=`fc-L;U>Drcek;tu^r!JfZR>cx%xuo=n;1E!(GkB+!sd`- zTHiRjd%jxU&&T%7jod$_`#wDp!1Kg00W5LYZG&zq9O;Z<(XS)g*<2|)|e0YYkY6Y zD|U7_Da$-CDyqgTqA0_nMQnMXryb$wh{Ww6BRA+9Y*C1#$3)wjy!Erg`8;dqRf@)_ zn7yY-Q|c^Z?$uT za-30&_rK%777SEx;M4W zgMSt+#VG0DNRkgYa?=KSxM@Bz);Pi$`G`kzxdWX~Y zgy@<&(vTmj!6vr09!m)r?YRt&qYCr%z^s}fN;Kgz-Ec_}k2mEuiRk5_Pu_3{+Ue>^ zcwa<$m1AIqu#05{O?p6NmtzdB^2TuA1H(FYHKP*^fRB$!W|!@?=WG>WV7oqEH+W(Y zDn1EnOYv5ea;+DB>G$@Oh&s^5d?(AZaA@JZIV(fUD$d>4dN7$cm%BJZU!TE4-(kdq zVv_wVkvvtg`aqeL%qL=-&-Y>{DY2E~;|O;1_e|_s5NIPH1YTR))v^F4U7r`BFEW8=VcS&bE1hgJ zza$QW#OLGwdzuyA%pDIS(sD6zO|7H14*}8pT0}cb45IS;70y8*x@S}No&7}+XzdT) z!pq{jnYeG*?iEEnaP)Ls9mg82mdnye`?~lFHkVA8XfnDP>0Zd3%)^CGaNjlZ8F6#( zmg@sBX51pf%ubV7Uz*zd?YmSGETS0uWXpIJ*gKOX$ zfnx8cU%%040abMn6&k4s2T_IkqUzey1Fr)U(7YD4!vU-<13~?DHX~iQOu`TOy|G~cFQDf)cnd~k%%_e<4mvs z-WniyEB7llGat$ltQI%uLq&&!{w`F=Nd=%nyqJhvG*!!j4^T%zj5k}{y_co}ih2DX@H3x!1^VwYlO_v5v5sjr#@tEYWyGIMNdnkN zD(|KnobC^76viUbr)B+LLtY%G1q~Y?@rk>GAz*u1(-(NA{Iv^FVem8TDI01Ng@GKL zIbD6%fhrd9o%T6|wUi>xT#vjUYo%XdN==7E#`rZU-3xe6O2Jv*syyCma@!P6KQ{t9 z(3Q<~FFhMtn>nR@QhDFBH;*%l^u>%^bX9QRiwKL%JS$qDV4c$8j>xczN^EXm7M+{q z{d_JLnlqhBWp7mbG0Sv2G@TyW1@Y0#0|G94T_AJ$T>wz zq&$$IjRtH68nxzg2Yuk?k5#|obqg2Qr_U^#8e+SNo+wqh>2+Bw4=JnEv;VTEUt~E zrT5C1rktD{anHytaX6c}(Er!=mGl1prd)>%!+CbF7JD+y98Pyjcc8tz))!?l-Mf*m zHv3-7{}&0ycD`|tOF8@|2-UKn$Oq&W9tl79l=lASY*Wb6OnKcB~;@&Et; diff --git a/docs/user-manual/source/images/screenshots/editor/profile-spiral.png b/docs/user-manual/source/images/screenshots/editor/profile-spiral.png deleted file mode 100644 index 48f1f6e5354c2924dec7e8db6e2c4f1161e240cb..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 5614 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 BHO>G4 diff --git a/docs/user-manual/source/images/screenshots/editor/profile-spline.png b/docs/user-manual/source/images/screenshots/editor/profile-spline.png deleted file mode 100644 index f852e5dde9ee6bb375db5c6609384850c4970549..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 4963 zcmb7IcT`hZw+{}|gn%fb5C~F*ARxUX(xoV&_og5{5_$t>&`a_>E7|H|Gs{H~4~4HXj=005xTP*;Wm03_tZ zahZaQIHL;@StMRa;83+&fQo+5X+Y|rsI3S9RL7n>v^h(RDPig+Z~%bb^K_6**@JzF zKXx^g74>~BSFzRZ%xW23c(omeyoYBJ>Dj6tYF_e-JZC)^J*m!>kxIHo<(A7x#xE8g z1<EPPwAP>ZRERU_XSC|snzbK(VULp zrpi{7!okjF-2|BsIt|Sb+pW-D$^*{Z3qCg*2!KIQAo%XJFtgH{gSE_+P>UFwp(EUk zVHw0W89Sib?7HNhw$SwsS7CuKAHa2(@#89w6zUH)X4U7~o%i0Z!7Hyc8&1yQnCb~P zim8o-C4gZgg5U=wp+Aa|kJ!bPaT!(pz@A>MOR z?Ia1 z7`vfBar%L2@jPRu6gjcM>CL&vmi(vt2kOeegK?e@6WrKkm&bx`H3?pPB5 z^=2%!*1OcoAv%w)g`L#19J#Bli%I&QcW!J=#4@TCAZJ-c7A4WR><3YM9}}IcMUp%x zeb9E;aAqHiM;9B=FrgJ~HFqnoHblU1p?mVwTQcxLR+B$RT6S(%Q(SI5N%!%?DHp=Q zNeJ%Vu~@Sij*PMWtJY=FRDbiKnr}WllZY*Nu)hSEv3d4UZ1bl8T10;oIoYE<3^;&9 z=sXdzozrooLT|kxyURlWeMs=hk;DwZn%a&CX~^`^mmv>;5I1!gHbo2-{%UWzvUM&} zumxtOo>7Dl6cof}q47h4t%K!&7aSl!5d}GbuZ`qU1Pt(k{YPl6;hXh!)LuyvpvguR znn6lB1IU{s+)Nc?;|^0Q<%2*VP}hdl$I1GA$4LAW`5oD#2HFRf!4>2KiT*h!Xk(M& zbS4%j1H#d7)zi4{+lotasNgLAwhy~$9U*Uaf>7dSH?@FavyVj~?9t7QQpiw$f}G=A z&?4(aEUQXBuaS|F@aom<%)OIO+3%0DQdz;qB87~XOdkepEI7XQ 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 diff --git a/docs/user-manual/source/images/screenshots/editor/string.png b/docs/user-manual/source/images/screenshots/editor/string.png deleted file mode 100644 index 8ca92b31c484e3f5852cc0ba2c0a8f9d9b43488a..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 3044 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 diff --git a/docs/user-manual/source/images/storage-factor.svg b/docs/user-manual/source/images/storage-factor.svg new file mode 100644 index 00000000..5e46444d --- /dev/null +++ b/docs/user-manual/source/images/storage-factor.svg @@ -0,0 +1,231 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Draw length + Draw force + + + 100% + + >100% + <100% + + + + diff --git a/docs/user-manual/source/images/strain-normal.svg b/docs/user-manual/source/images/strain-normal.svg new file mode 100644 index 00000000..209e62d5 --- /dev/null +++ b/docs/user-manual/source/images/strain-normal.svg @@ -0,0 +1,185 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/docs/user-manual/source/images/strain-shear.svg b/docs/user-manual/source/images/strain-shear.svg new file mode 100644 index 00000000..03845a97 --- /dev/null +++ b/docs/user-manual/source/images/strain-shear.svg @@ -0,0 +1,185 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/docs/user-manual/source/introduction.md b/docs/user-manual/source/introduction.md index b57de005..53a47c9d 100644 --- a/docs/user-manual/source/introduction.md +++ b/docs/user-manual/source/introduction.md @@ -1,24 +1,20 @@ # Introduction -Welcome to the user manual for VirtualBow! +Welcome to the VirtualBow user manual! +This guide will show you how to use the VirtualBow software to design bows, simulate their performance, and interpret the results. +For support, feedback, or to download the latest version, please visit the project website: [https://www.virtualbow.org/](https://www.virtualbow.org/). -This manual will help you understand how to use this software for designing bows, simulating their performance and interpreting the results. -Like many other simulation tools, VirtualBow consists of three distinct components: A model editor, a solver and a result viewer. +Please keep in mind that VirtualBow is still under active development, and many of its simulation results have not yet been systematically validated. +Although users often report good agreement with real-world behavior, the results should not be taken at face value. +Generally, three main factors influence how closely the simulation can match an actual bow: -- The **model editor** is the most important part of the application from a user's perspective. -Here you can create, edit and save your designs, which will be stored as `.bow` files. +* **Physical simplifications:** Every simulation relies on assumptions that make complex real-world behavior mathematically manageable. VirtualBow tries to make reasonable assumptions, but no model can capture reality perfectly. If you're interested in the underlying theory, you may want to explore the *VirtualBow theory manual*. -- The **solver** does the actual work of running a simulation. -It takes a `.bow` file, performs the required calculations and saves the results as a `.res` file. +* **Software implementation:** Errors in the code can obviously affect accuracy. While much work has been put into verifying the simulation code by automated testing, bugs can never be completely ruled out. -- Finally, the **result viewer** is used to open and visualize the `.res` files produced by the solver. -Here you can view the simulation results and evaluate your designs. +* **Quality of input data:** A simulation is only as accurate as the data provided. +In practice, no bow can be built exactly as modeled in VirtualBow, even though the type of bow can make this task easier or harder. Natural variations in material properties and small deviations in geometry, for example, will accumulate and affect the outcome. -The layout of this manual follows this parition. -The coming chapters will therefore explain each of these components in more detail, starting with the model editor. -For support, feedback or to get the latest version of the software please visit the project's website at - -> [https://www.virtualbow.org/](https://www.virtualbow.org/) - -> **Note:** Please keep in mind that VirtualBow is still under development. -The simulation results are still largely unverified and should not be taken at face value yet, although many users already reported good agreement. \ No newline at end of file +Many of those points are being worked on to further improve the accuracy of VirtualBow. +And while simulations will never be perfect, they can still reveal a lot about how a bow design works, highlight weaknesses, and point you toward possible improvements. +Think of VirtualBow as a complementary tool to real world experimentation: it won't replace building and testing real bows, but it can make the process more informed and efficient. diff --git a/docs/user-manual/source/model-editor-comments.md b/docs/user-manual/source/model-editor-comments.md index 4d9ab11b..362f26cf 100644 --- a/docs/user-manual/source/model-editor-comments.md +++ b/docs/user-manual/source/model-editor-comments.md @@ -1,9 +1,10 @@ -# Comments +# Comments -The comments are the first item in the model tree and are only used for documentation. -Any notes about the bow, its paramters or the simulation results can be added here. +The Comments item at the top of the model tree is provided purely for documentation. +It does not affect the simulation in any way. +You can use this section to record notes about anything, including the bow design, its parameters, design decisions, or observations from simulations.
-
Figure: Comments
-
\ No newline at end of file +
Figure: Comment box
+ diff --git a/docs/user-manual/source/model-editor-damping.md b/docs/user-manual/source/model-editor-damping.md index c4d294a3..b720822a 100644 --- a/docs/user-manual/source/model-editor-damping.md +++ b/docs/user-manual/source/model-editor-damping.md @@ -1,35 +1,33 @@ # Damping -Damping allows to account for energy dissipation, for example due to internal friction/hysteresis of the materials. -It only has an effect in dynamic analysis. +Damping accounts for energy dissipation, such as losses caused by internal friction or hysteresis in the materials. +It affects only the dynamic analysis. -
- -
Figure: Damping properties
-
+A typical bow loses only a small part of its efficiency to energy dissipation. +Most of the loss comes from kinetic energy that remains in the bow after the arrow leaves the string. +For this reason, the damping parameters are not critical for modelling overall bow performance. +They do however make the behaviour of the bow after the shot more realistic, since without damping the bow’s motion would never decay. -Since modelling all the different forms of energy dissipation in a bow in an exact way would be too complex, the damping is reduced to two empirical values: +Because modelling every form of energy dissipation in a bow in an exact way would be way too complex, the damping is reduced to two empirical values: The damping ratio of the **Limbs** and the damping ratio of the **String**. +The [damping ratio](https://en.wikipedia.org/wiki/Damping) describes how quickly oscillations decay over time: -The damping ratio characterizes how quickly oscillations decay over time: +- A damping ratio of 0% represents an undamped system: no energy is lost, and the oscillation just keeps going with a constant amplitude. -- An oscillation with a damping ratio of 0% is undamped, it doesn't dissipate any energy and just keeps going with a constant amplitude. +- As the damping ratio increases, the oscillation decays more quickly, losing energy with each cycle. -- The higher the damping ratio the faster the amplitudes decay over time, losing energy with each oscillation. +- At 100%, the system is *critically damped*: oscillations no longer occur and the system returns to equilibrium without overshoot. -- Once the damping ratio reaches 100% there is no longer any oscillation (no overshoot), this is called critical damping. +See the table below for a visualization of these three cases. +The damping ratios of a bow’s limbs and string are largely empirical, and there is still limited practical experience with them. +Realistic values are probably in the range of **1 - 10%** though. +You can observe the damping behaviour of your bow's limb by clamping the handle firmly on a table or workbench and plucking the limb tip. +The longer it continues to oscillate, the lower the damping ratio. -See also the table below for a visualization of those three cases. +
-| Damping | Amplitude | -|---------|-------------------------------------------------------------| -| 0% | | -| 10% | | -| 100% | | - -> **Note:** The damping ratios of a bow's limbs and string are mostly empirical and there isn't yet much practical experience. -> Realistic values are probably in the range of 1 - 10% though. - -> **Note:** Due to numerical issues, high damping ratios (> 10%) might not work very well right now. - -> **Note:** In more technical terms, the limb's damping ratio applies to its first eigenmode in unbraced state and the string's damping ratio applies to its first eigenmode in longitudinal direction. \ No newline at end of file +| Damping ratio | Oscillation | +|---------------|-------------------------------------------------------------| +| 0% | | +| 10% | | +| 100% | | diff --git a/docs/user-manual/source/model-editor-dimensions.md b/docs/user-manual/source/model-editor-dimensions.md deleted file mode 100644 index cca51ca4..00000000 --- a/docs/user-manual/source/model-editor-dimensions.md +++ /dev/null @@ -1,29 +0,0 @@ -# Dimensions - -The dimensions define some overall lengths and angles of the bow, including an optional stiff middle section. - -
- -
Figure: Dimensions
-
- -**Draw** - -- **Brace height:** Distance between the deepest point of the handle and the string at rest - -- **Draw length:** Distance between the deepest point of the handle and the string at full draw - -**Handle** - -- **Length:** Optional length of a stiff middle section (grip/riser) between the limbs - -- **Setback:** Distance between the deepest point of the grip and the attachment point of the limbs to the middle section - -- **Angle:** Angle at which the limbs are attached to the middle section - -See the image below for a visual definition of the dimensions. - -
- -
Figure: Definition of the dimensions
-
\ No newline at end of file diff --git a/docs/user-manual/source/model-editor-draw.md b/docs/user-manual/source/model-editor-draw.md new file mode 100644 index 00000000..2d7a2613 --- /dev/null +++ b/docs/user-manual/source/model-editor-draw.md @@ -0,0 +1,58 @@ +# Draw + +Here, the brace height and draw length under which the bow operates are defined. +Both values reference the bow's pivot point, which is configured in the [Handle](model-editor-handle.md) section, so they only become meaningful once the handle has been properly set up. +See also the figure below for a visual definition of each parameter. + +**Brace height:** The brace height is measured as the distance between the bowstring and the handle's pivot point on the braced bow. +VirtualBow automatically determines the string length required to achieve the specified brace height. + +**Draw length:** The bow's draw length can be specified according to two conventions. +Choosing between them is purely a matter of preference and convenience and has no other effects. + +- **Standard:** Under the *Standard* convention, the draw length is defined as the distance between the handle's pivot point and the string at full draw - sometimes referred to as the *true* draw length. + +- **AMO:** The alternative is the *AMO* convention, defined by the *Archery Manufacturers Organization*, where the draw length is taken as the pivot-to-string distance plus 1.75 inches. +This definition is widely used by bow manufacturers. + + + +
+
+ +
Figure: Definition of the brace height and draw length in both conventions.
+
+ + diff --git a/docs/user-manual/source/model-editor-handle.md b/docs/user-manual/source/model-editor-handle.md new file mode 100644 index 00000000..df36d799 --- /dev/null +++ b/docs/user-manual/source/model-editor-handle.md @@ -0,0 +1,60 @@ +# Handle + +This category determines how the middle section of the bow is modeled. +There are two options to choose from: *Flexible* and *Rigid*. +Selecting *Flexible* means the middle section is fully modeled and simulated as part of the limb geometry you define later. +If your bow has a middle section that shouldn't or can't be modeled in VirtualBow, choose *Rigid* to specify the dimensions of a rigid section placed between the limbs. + +## Flexible + +A flexible handle is the simplest option - no additional parameters are required. +You model the handle as part of the limb geometry, and the simulation treats it just like the rest of the limb. +Of course, the options for modeling intricate handle geometries in VirtualBow are limited, since this is not its primary focus. + +
+ + + +
Figure: Some examples for bows with a handle modeled as Flexible. It doesn't matter whether the handle actually flexes significantly or not.
+
+ +The bow’s pivot point, which is later needed for defining brace height and draw length, is automatically placed on the belly side of the bow’s center. + +## Rigid + +Selecting *Rigid* allows you to specify a rigid middle section of the bow to which the limbs are attached. +This configuration is typical for takedown bows with a riser, but it can also be used for other middle‑section designs that you prefer not to model explicitly in VirtualBow. + +
+ + +
Figure: Some examples of bows with a handle modeled as Rigid.
+
+ +The following parameters are required for a rigid handle. +They determine the spacing and orientation of the two limbs as well as the placement of the pivot point. +See also the figure below for a visual definition of each parameter. + +**Length:** Specifies the length of the rigid middle section, measured as the distance between the limb attachment points. +The limbs are attached to the attachment points by their belly-side edges. + +**Angle:** Sets the angle at which the limbs attach to the rigid middle section. +Positive angles add reflex; negative angles add deflex. + +**Pivot:** Defines the position of the pivot point relative to the limb attachment points. +Positive values add reflex; negative values add deflex. +The pivot point is used as the reference for measuring brace height and draw length. + +
+ +
Figure: Definition of the rigid handle dimensions, shown here on a typical modern recurve‑bow riser. Note that the actual flexible limbs start at the attachment points, the portion fixed to the riser belongs to the middle section.
+
+ +
+ +> [!NOTE] +> When choosing the cutoff point between the limb and the rigid handle, make sure the actual limb geometry includes any fadeouts where the handle transitions into the limb. + +> [!NOTE] +> You may still choose *Rigid* for the additional settings even when the handle itself is modeled as part of the limb geometry. +> This is useful, for example, if you want to override the pivot point placement: simply define a zero‑length rigid handle and set the pivot point as needed. diff --git a/docs/user-manual/source/model-editor-layers.md b/docs/user-manual/source/model-editor-layers.md index 7463ed34..6ceb16f7 100644 --- a/docs/user-manual/source/model-editor-layers.md +++ b/docs/user-manual/source/model-editor-layers.md @@ -1,7 +1,7 @@ # Layers -Layers define the makeup of the bow in the thickness/height direction. -A bow can have multiple layers of different materials or only a single layer (self bows). +Layers define the makeup of the bow in the thickness direction. +A bow may consist of a single continuous layer, as in traditional self bows, or it may be built from multiple layers made from different materials.
@@ -9,21 +9,49 @@ A bow can have multiple layers of different materials or only a single layer (se
If the _Layers_ category in the model tree is selected, the buttons (, , , ) can be used to add, remove and reorder layers. +The order of layers in the list corresponds to their actual stacking order in the limb. Layers can be renamed by double-clicking and entering a new name. +## Layer properties +
Figure: Layer properties
-Each layer consists of a material and a height/thickness distribution. -The material can be selected from the drop-down list, which shows all materials that were previously added under [Materials](model-editor-materials.md). +**Material:** Each layer references a material and has a defined thickness distribution over its length. +The material can be selected from the drop-down list, which contains all materials previously added under [Materials](model-editor-materials.md). +Multiple layers may reference the same material. + +**Thickness:** The thickness distribution is specified by a table of relative length and thickness values. +Each row must contain a relative length along the limb (from 0% to 100%) and the corresponding layer thickness. +Layers don't have to span the full limb length; they may start or end within the limb to model features such as fadeouts or tip wedges. +Some [additional rules](#additional-rules) described below ensure that all layers together form a valid geometry. +The actual thickness profile is constructed as a smooth curve (a monotone cubic spline) passing through the provided values and is displayed in the _Graph_ panel. +The plot's context menu offers additional options, such as showing or hiding control points or adding an overlay image. + +## Additional rules + +A few rules must be observed when defining layer thickness to ensure that the limb geometry ends up being well‑defined. +VirtualBow handles these checks for you - either enforcing the rules automatically or showing an error message when something isn't allowed - so you don’t have to keep them all in mind yourself. + +### Disjoint layers + +

+ +Layers may have a thickness of zero at their start or end to model layers that fade out (b), fade in (c) or both (d). +However, they may not contain a zero-thickness point somewhere inbetween, as this would create multiple disjoint layer segments (e). + +Also, even though individual layers do not need to span the entire limb, the combined thickness of all layers must be positive along the full limb length. +In other words, the stack of layers must cover the entire limb without gaps. +

-The height distribution is defined by a table of relative length and height values. -Each table row must contain a relative length along the limb (from 0% to 100%) and the corresponding layer height. -Layer heights may be zero over portions of the length. -This is useful for modelling layers that don't cover the whole limb. -Common examples for this are fadeouts and tip wedges. +### Continuity -The actual height distribution is constructed as a smooth curve (monotone cubic spline) passing through the supplied values and is shown in the _Graph_ panel. -You can use the context menu for additional options on the plot, like showing/hiding control points or adding an overlay image. \ No newline at end of file +

+ +Layers that start or end within the limb must taper to zero thickness to avoid creating a visible discontinuity in the geometry (a). +However, this alone could still create a kink in adjacent layers, as shown in case (b). +To prevent this, a layer that fades in or out within the limb must have both zero thickness and zero slope at that point (c). +This requirement does not apply to layer endpoints that coincide with the limb's endpoints (d). +

diff --git a/docs/user-manual/source/model-editor-masses.md b/docs/user-manual/source/model-editor-masses.md index 304d20f4..78eec54d 100644 --- a/docs/user-manual/source/model-editor-masses.md +++ b/docs/user-manual/source/model-editor-masses.md @@ -1,20 +1,64 @@ # Masses -Here you can set the mass of the arrow as well as some other optional masses. +Here you can set the mass of the arrow as well as additional masses placed on the bow or the string. +Only the arrow mass is required, the others are optional and may be set to zero if not needed. + +**Arrow:** The mass of the arrow can be specified in one of three ways: + +- **Mass:** The absolute mass of the arrow in grams, grains or any other selected unit. + +- **Mass per force:** To compare bow/arrow setups of different draw weight, arrow mass is often expressed relative to the bow’s draw weight, typically in grains per pound (GPP). When you specify the arrow mass in this way, VirtualBow calculates the actual mass after the static simulation, once the bow’s draw force is known. + +- **Mass per energy:** The established method of defining arrow mass relative to draw force has one limitation: it does not account for the bow's power stroke. +As a result, it is not a good metric for comparing bows with different draw lengths or brace heights. +For example, a 10 gpp arrow on a bow with a 26" draw length is a very different setup from a 10 gpp arrow on a 30" draw length, because both produce the same arrow mass for a given draw force, even though the longer draw stores significantly more energy and would therefore require a heavier arrow. +To address this, VirtualBow offers an alternative definition based on the bow's stored energy, suggested to be measured in grains per Joule (GPJ). +When you specify the arrow mass in this way, VirtualBow calculates the actual mass after the static simulation, once the bow’s force-draw curve and stored energy are known. +A conversion table between GPP and GPJ is provided below to give you a sense of typical values. + +**String center:** Additional masses located near the center of the string, typically the center serving and any nocking point(s). +The image below shows a typical center serving with a single brass nocking point. + +
+ +
+ +**String end:** Additional masses located near the ends of the string, typically the serving on the ears of an endless-loop string or the doubled-up splice section on a flemish twist string. +See the image below for examples of both types. +
- -
Figure: Mass properties
+
-Only the mass of the arrow is actually required. -The other ones account for optional weights at various points of the bow and may be set to zero if not needed. -Masses in general only have an effect in dynamic analysis. -- **Arrow:** Mass of the arrow +**Limb tip:** There exists a wide variety of different limb tip designs, a few examples are shown below. +What they all share is that they add some mass to the end of the limb, which can be represented by this value. +The added mass typically consists of the small portion of the limb extending beyond the string attachment point, along with any reinforcing elements such as tip overlays or similar. -- **String center:** Additional masses at the string center (e.g. serving, nocking point) +
+ +
-- **String tip:** Additional masses at the ends of the string (e.g. serving) +
-- **Limb tip:** Additional masses at the limb tips (e.g. tip overlays, extending nocks) \ No newline at end of file +> [!NOTE] +> This table shows the equivalent GPJ (grains per joule) value for each combination of GPP (grains per pound) and power stroke, estimated based on the assumption of a linear force–draw curve. +> +> | GPP | 18" | 19" | 20" | 21" | 22" | 23" | 24" | +> |-----|------|------|------|------|------|------|------| +> | 1 | 1.0 | 0.9 | 0.9 | 0.8 | 0.8 | 0.8 | 0.7 | +> | 2 | 2.0 | 1.9 | 1.8 | 1.7 | 1.6 | 1.5 | 1.5 | +> | 3 | 3.0 | 2.8 | 2.7 | 2.5 | 2.4 | 2.3 | 2.2 | +> | 4 | 3.9 | 3.7 | 3.5 | 3.4 | 3.2 | 3.1 | 3.0 | +> | 5 | 4.9 | 4.7 | 4.4 | 4.2 | 4.0 | 3.8 | 3.7 | +> | 6 | 5.9 | 5.6 | 5.3 | 5.1 | 4.8 | 4.6 | 4.4 | +> | 7 | 6.9 | 6.5 | 6.2 | 5.9 | 5.6 | 5.4 | 5.2 | +> | 8 | 7.9 | 7.5 | 7.1 | 6.7 | 6.4 | 6.2 | 5.9 | +> | 9 | 8.9 | 8.4 | 8.0 | 7.6 | 7.2 | 6.9 | 6.6 | +> | 10 | 9.8 | 9.3 | 8.9 | 8.4 | 8.0 | 7.7 | 7.4 | +> | 11 | 10.8 | 10.2 | 9.7 | 9.3 | 8.9 | 8.5 | 8.1 | +> | 12 | 11.8 | 11.2 | 10.6 | 10.1 | 9.7 | 9.2 | 8.9 | +> | 13 | 12.8 | 12.1 | 11.5 | 11.0 | 10.5 | 10.0 | 9.6 | +> | 14 | 13.8 | 13.0 | 12.4 | 11.8 | 11.3 | 10.8 | 10.3 | +> | 15 | 14.8 | 14.0 | 13.3 | 12.6 | 12.1 | 11.5 | 11.1 | diff --git a/docs/user-manual/source/model-editor-materials.md b/docs/user-manual/source/model-editor-materials.md index 6bf01ada..cead226a 100644 --- a/docs/user-manual/source/model-editor-materials.md +++ b/docs/user-manual/source/model-editor-materials.md @@ -1,30 +1,75 @@ # Materials -This is a list of materials that can later be assigned to the layers of the bow. - -
- -
Figure: Materials in the model tree
-
- +This item contains a list of all materials in the bow. +The layers, which are defined later, each reference one such material and multiple layers can also share the same material. If the _Materials_ category in the model tree is selected, the buttons (, , , ) can be used to add, remove and reorder materials. Materials can be renamed by double-clicking and entering a new name.
- -
Figure: Material properties
+ + +
Figure: Material list in the model tree and material properties
-For each material, the following properties are needed: +Selecting a material from the list opens its associated material properties. +They are grouped into *General*, *Elastic*, and *Strength* properties. +The elastic material properties define how the material deforms under load, while the strength properties define the material's failure limits. + +## General + +**Color:** The material can be given any color desired to make it look a bit more realistic. +It doesn't have any other effect than graphics. + +**Density:** The density of a material is defined as its mass per unit volume and characterizes its specific weight. + +## Elastic + +

+ +Young's modulus: A material's Young's modulus, usually denoted \(E\), describes its stiffness against normal (tensile or compressive) loading. +It is defined as the quotient of normal stress to normal strain. +This assumes linear elasticity, meaning stress and strain are proportional. +Many common materials follow such a linear relationship up to a certain limit. +

+ +

+ +Shear modulus: The shear modulus, usually denoted \(G\), is similar to Young's modulus in that it characterizes the stiffness against deformation. +But unlike Young’s modulus, which relates to normal deformation, the shear modulus characterizes how the material responds to shear deformation. +VirtualBow does not make much use of the shear modulus yet, but it will form the basis for future features such as modeling the limbs’ torsional rigidity. If you do not know the exact value for your material, you can estimate it as roughly one‑third to one‑half of Young’s modulus. If the material’s Poisson ratio \(\nu\) is known instead, the shear modulus can be computed from Young’s modulus using the relation \(G = E/(2(1 + \nu))\). +

+ +## Strength + + +**Tensile strength:** The tensile strength defines the maximum normal stress a material can withstand while under tension. +Beyond this limit, the material will fail or permanently deform. +In VirtualBow, this value is used to assess whether any part of the limb experiences tensile stresses that exceed the material’s allowable limits. + +**Compressive strength:** The compressive strength specifies the maximum normal stress a material can sustain while being compressed. +Beyond this limit, the material will fail or permanently deform. +In VirtualBow, this value is used to assess whether any part of the limb experiences compressive stresses that exceed the material’s allowable limits. + +**Margin of safety:** The margin of safety (MoS) defines how conservatively the material’s strength limits are applied. +It reduces the allowable stresses so that the bow operates with some reserve towards the actual failure thresholds. +The margin of safety indicates by what percentage the allowable stress could increase before reaching the failure stress: -- **Color:** Color of the material (only used for display) +\\[\sigma_{\rm{faiure}} = \sigma_{\rm{allowed}}\times(100\\% + \rm{MoS})\\] -- **Rho:** Density (mass per unit volume) +A higher margin of safety leads to more conservative designs, reducing the risk of material failure but also potentially leaving some of the material's performance on the table. -- **E:** Elastic modulus (measure of stiffness) +> [!NOTE] +> For synthetic materials such as fiber-reinforced composites, the mechanical properties are often provided in a manufacturer's datasheet. +> Natural materials like wood are more challenging, as their properties can vary quite a bit. +> Average numbers can be found at [The Wood Database](http://www.wood-database.com) and other websites, which should provide a good baseline. +> As an alternative, you can determine some of the properties experimentally by a bending test. +> For details on that see [Appendix C](appendix-bending-test.md). -For synthetic materials like e.g. fiber-reinforced composites you can often find the mechanical properties in a datasheet provided by the manufacturer. -Natural materials like wood are more difficult, because their properties can vary quite a bit. -Average numbers can be found at [http://www.wood-database.com](http://www.wood-database.com) and other websites, which should be a good starting point. -The alternative is to determine the material properties by experiment with a bending test. -For more information on that see [Appendix C](appendix-bending-test.md). \ No newline at end of file +> [!NOTE] +> In this section, several concepts from the mechanics of materials - such as stresses and strains - have been introduced without much explanation. +> This doesn't mean that those topics are common knowledge, but covering them here thoroughly would be beyond the scope of this manual. +> If you want to dive in deeper, the list below provides some links to videos that explain these concepts in greater detail. +> - [An Introduction to Stress and Strain](https://www.youtube.com/watch?v=aQf6Q8t1FQE) +> - [Understanding Young's Modulus](https://www.youtube.com/watch?v=DLE-ieOVFjI) +> - [Understanding Poisson's Ratio](https://www.youtube.com/watch?v=tuOlM3P7ygA) +> - [Understanding Material Strength, Ductility and Toughness](https://www.youtube.com/watch?v=WSRqJdT2COE) diff --git a/docs/user-manual/source/model-editor-profile.md b/docs/user-manual/source/model-editor-profile.md index bd746b60..bf6a1a51 100644 --- a/docs/user-manual/source/model-editor-profile.md +++ b/docs/user-manual/source/model-editor-profile.md @@ -1,28 +1,27 @@ # Profile -The profile defines the shape of the (back of the) bow in unbraced state. +The profile defines the shape of the bow in its unbraced state. +It establishes the limb’s base curvature before any string tension is applied, and therefore determines the fundamental design of the bow - such as a straight longbow form, reflex/deflex, recurve, or any other variation.
Figure: Profile segments in the model tree
-If the _Profile_ category in the model tree is selected, the buttons (, , , ) can be used to add, remove and reorder segments of different types that make up the profile curve (e.g. lines, arcs and more). -The properties of each segment depend on its type and are explained below. -The resulting shape of the profile curve is shown in the _Graph_ panel. -You can use the context menu for additional options on the plot, like showing/hiding control points, curvature or adding an overlay image. +If the _Profile_ category in the model tree is selected, the buttons (, , , ) can be used to add, remove, and reorder the segments that make up the profile curve (such as lines, arcs, and other types). +The properties available for each segment depend on its type and are described below. +The resulting profile shape is displayed in the _Graph_ panel. +The plot's context menu provides additional options, such as showing or hiding control points, displaying curvature, or adding an overlay image.
Figure: Profile plot
-> **Note:** The profile curve always starts at (0, 0) and with a horizontal angle. Any offsets in the actual bow can be achieved with the parameters in [Dimensions](model-editor-dimensions.md). - ## Line Segments -The line segment is simply a straight line. -Its only editable property is the length of the line. +A line segment represents a straight section of the profile. +Its only adjustable property is its **length**.
@@ -31,10 +30,9 @@ Its only editable property is the length of the line. ## Arc Segments -The arc segment describes a circular arc with given length and radius. - -> **Note:** The radius can be positive or negative, which makes the arc curve into different directions. -It can also be zero, in this case the arc turns into a straight line. +An arc segmnent represents a circular arc defined by its **length** and **radius**. +The radius may be positive or negative, which determines the direction in which the arc curves. +A radius of zero will be interpreted as a straight line instead.
@@ -43,11 +41,10 @@ It can also be zero, in this case the arc turns into a straight line. ## Spiral Segments -The spiral segment describes an [Euler spiral](https://en.wikipedia.org/wiki/Euler_spiral), a curve that linearly transitions between two curvatures. -It is therefore well suited for making smooth transitions between lines and arcs or arcs of different radius. -It is defined by a starting radius, and end radius and a length. - -> **Note:** The start and end radius can be positive, negative or zero (similar to the arc segment). +A spiral segment represents an [Euler spiral](https://en.wikipedia.org/wiki/Euler_spiral), a curve whose curvature changes linearly along its length. +This makes it ideal for creating smooth transitions between straight lines and arcs, or between arcs of different radii. +It is defined by a **start radius**, an **end radius**, and a **length**. +Both the start and end radius may be positive, negative, or zero, allowing the spiral's endpoints to curve in either direction or transition seamlessly into straight sections.
@@ -56,10 +53,10 @@ It is defined by a starting radius, and end radius and a length. ## Spline Segments -The spline segment interpolates a table of `(x, y)` values with a cubic spline. -The values are measured relative to the starting point of the segment/the end point of the previous segment. +A spline segment interpolates a series of `(x, y)` points using a cubic spline curve. +The coordinates are specified relative to the segment's starting point (i.e. the end point of the previous segment, if present).
Figure: Spline segment properties
-
\ No newline at end of file +
diff --git a/docs/user-manual/source/model-editor-settings.md b/docs/user-manual/source/model-editor-settings.md index b5a5d91a..29bc596c 100644 --- a/docs/user-manual/source/model-editor-settings.md +++ b/docs/user-manual/source/model-editor-settings.md @@ -1,37 +1,61 @@ -# Settings +# Settings -The settings can be used for tweaking the simulation. -Usually the default values should be fine though, so if you're reading this manual for the first time you might want to skip this section. +The Settings allow you to fine-tune how the simulation is carried out. +In most cases, the default values provide a good balance and will work just fine, so if you are reading this manual for the first time, you may choose to skip this section and revisit it later if needed. -
- -
Figure: Settings
-
+Because the default settings are chosen as a reliable general choice, they prioritize accuracy and stability over raw simulation speed. +For certain tasks, however - such as running a large number of scripted simulations - it may be worthwile to adjust the settings for better performance. +Conversely, some bow designs may occasionally fail with default settings, in which case alternative settings can help the simulation complete successfully. -Since the default settings are meant to be a good general choice, they favor accuracy and reliability over simulation speed. -So for specific use cases it could make sense to find more efficient settings. -Think about running a large number of scripted simulations, for example. -On the other hand, even the default settings might sometimes fail with certain bow designs such that different settings have to be used. +The available options are divided into general settings that affect both simulation modes, as well as mode‑specific settings for the static and dynamic simulations. -The settings are divided into general settings that affect both simulation modes as well as specific settings for the static and dynamic simulations. +## General -**General** +**Limb elements:** Number of finite elements used to approximate the limb geometry. +Increasing this value improves accuracy at the cost of longer computation times. -- **Limb elements:** Number of finite elements that are used to approximate the limb. More elements increase the accuracy but also the computing time. +**Limb eval points:** Number of sampling points along the limb where stresses, strains and other quantities are evaluated. +Higher values produce result plots with a finer resolution. +The added computational cost of increasing this value is small, but beyond a certain point the increased resolution offers no practical advantage anymore. -- **String elements:** Number of finite elements that are used to approximate the string. This number can usually be reduced if the bow has no recurve. In the case of a static analysis with no recurve it can even be set to one without losing any accuracy. +## Statics -**Statics** +**Min. draw resolution:** Defines the minimum number of steps the static simulation takes as it progresses from brace height to full draw. +A higher value increases the resolution of the static results. +You can usually reduce this value to speed up the simulation, especially if you are primarily interested in the dynamic results. -- **Draw steps:** Number of steps that are performed by the static simulation from brace height to full draw. This determines the resolution of the static results. You can usually decrease this value to speed up the simulation, especially if you're only interested in the dynamic results. +**Max. draw resolution:** Defines the maximum number of steps the static simulation takes as it progresses from brace height to full draw. +This setting is currently unused, but future versions of VirtualBow might use it for adaptive step size control. -**Dynamics** +**Iteration tolerance:** Stopping tolerance for the static equilibrium iterations. This value is a tradeoff between accuracy and simulation time. +A tolerance that is too large may produce inaccurate results, while one that is too small wastes computation on unnecessary precision. +Both an overly low and an overly high tolerance can eventually lead to simulation failure. -- **Arrow clamp force:** The force that the arrow has to overcome in order to separate from the string. -This value is chosen fairly small by default and can improve the simulation results for very light arrows. +## Dynamics -- **Time span factor:** This factor controls the time period that is being simulated. A value of 1 corresponds to the time at which the arrow passes the brace height. The default value is larger than that in order to capture some of the things that tend to happen after the arrow left the bow (e.g. the maximum forces/stresses on limb and string). +**Arrow clamp force:** The force the arrow must overcome to separate from the string. +This value is set fairly low by default. +Increasing it can help resolve issues that may occur when simulating very light arrows. -- **Time step factor:** When simulating the dynamics of the bow, the program will repeatedly use the current state of the bow at time stem:[t] to calculate the next state at time stem:[t + \Delta t] where stem:[\Delta t] is some small timestep. We want this timestep to be as large as possible to keep the required number of steps low. But it still has to be small enough to get an accurate and stable solution. The program will try to estimate this optimal timestep, but to be on the safe side the estimation is multiplied with a factor between 0 and 1 that you can choose here. +**String compression factor:** Determines the compressive stiffness of the string as a fraction of its tensile stiffness. +An idealized string carries load only in tension, not in compression. +For numerical reasons, however, the compressive stiffness cannot be set to zero, which is why this small positive factor is required. -- **Sampling rate:** The sampling rate limits the time resolution of the dynamic results. This is done because the dynamic simulation usually produces much finer grained data than is actually useful. Not including all of that in the final output reduces the size of the result files and the simulation time. \ No newline at end of file +**Timespan factor:** This factor controls the duration of the simulated time interval. +A value of 100% corresponds to the moment when the arrow passes brace height. +The default value is higher to capture events that may occur after the arrow has left the bow, such as peak forces and stresses on the limbs and string. + +**Timeout factor:** Factor controlling the timeout of the dynamic simulation. +The simulation is aborted if arrow separation has not occurred by the time the simulated duration exceeds this factor multiplied by a reference time determined for the bow. + +**Min. timestep:** Lower bound for the time step of the dynamic simulation. The solver adjusts its step size automatically, but this setting ensures that the steps stay large enough to prevent the simulation from slowing to a crawl. + +**Max. timestep:** Upper bound for the time step of the dynamic simulation. The solver adjusts its step size automatically, but this setting ensures that the steps stay small enough to maintain sufficient detail in the results. + +**Steps per period:** Number of steps the dynamic solver tries to take per current characteristic time period of the system. +This serves as the target the solver uses when adjusting its time step. +Increasing it improves accuracy and stability, at the cost of additional computation time. + +**Iteration tolerance:** Stopping tolerance for the dynamic equilibrium iterations. This value is a tradeoff between accuracy and simulation time. +A tolerance that is too large may produce inaccurate results, while one that is too small wastes computation on unnecessary precision. +Both an overly low and an overly high tolerance can eventually lead to simulation failure. diff --git a/docs/user-manual/source/model-editor-string.md b/docs/user-manual/source/model-editor-string.md index 11da32dd..156fc687 100644 --- a/docs/user-manual/source/model-editor-string.md +++ b/docs/user-manual/source/model-editor-string.md @@ -1,35 +1,29 @@ # String -The string is defined by its material properties and the number of strands being used. -Its length is determined automatically from the brace height that was set under _Dimensions_. - -
- -
Figure: String properties
-
- +The string is defined by the material properties of a single strand and the number of strands it consists of. +Its final length is calculated automatically based on the brace height specified in the [Draw](model-editor-draw.md) settings. The following three properties are required: -- **Strand density:** Linear density of a single strand (mass per unit length) - -- **Strand stiffness:** Stiffness of a single strand (force per unit strain) - -- **Number of strands:** Total number of strands in the string - -> **Note:** Mass and stiffness of the string can be important for dynamic analysis. -The effect on the static results however is small, provided that the stiffness is high enough to prevent significant elongation. - -The linear density of a string material can be easily determined with an accurate scale (weight divided by length), the stiffness however is more difficult to obtain. -Manufacturers usually don't publish this number. -The table below shows the results of tensile tests for three common bow string materials. -They were done by the German Institutes for Textile and Fiber Research [^1] in July 2018. - -| Material | Density [kg/m] | Breaking strength [N] | Elongation at break [%] | Stiffness [N/100%] | -|:----------------|:---------------|:----------------------|:------------------------|:-------------------| -| Dacron B50 | 370e-6 | 180 | 8.5 | 2118 | -| Fastflight Plus | 176e-6 | 318 | 2.9 | 10966 | -| BCY 452X | 192e-6 | 309 | 2.5 | 12360 | - -**Table:** Material properties for common string materials. The stiffness values are a linear estimation from breaking strength and elongation. - -[^1]: [https://www.ditf.de/en/](https://www.ditf.de/en/) \ No newline at end of file +**Strand density:** The linear density of a single strand (mass per unit length). +This determines the overall weight of the string, which is an important factor in a bow's efficiency. +Additional masses on the string - such as servings or nocking points - can be accounted for separately in the [Masses](model-editor-masses.md) settings. + +**Strand stiffness:** The stiffness of a single strand (force per unit strain). +This value determines how much the string stretches elastically under load. + +**Number of strands:** The total number of strands in the string. +The string is treated as an endless loop string in which all strands run virtually parallel, allowing their properties to be added together. +Strings with an extreme amount of twist might break this assumption. + +> [!NOTE] +> The linear density of a string material can be measured easily using an accurate scale (weight divided by length). The stiffness, however, is more difficult to obtain. +> Manufacturers generally do not publish this value. +> The table below lists the results of tensile tests for three common bowstring materials, done by the *German Institutes for Textile and Fiber Research* in July 2018. +> +> | Material | Density [kg/m] | Breaking strength [N] | Elongation at break [%] | Stiffness [N/100%] | +> |:----------------|:---------------|:----------------------|:------------------------|:-------------------| +> | Dacron B50 | 370e-6 | 180 | 8.5 | 2118 | +> | Fastflight Plus | 176e-6 | 318 | 2.9 | 10966 | +> | BCY 452X | 192e-6 | 309 | 2.5 | 12360 | +> +> **Table:** Material properties for common string materials. The stiffness values are a linear estimation from breaking strength and elongation. diff --git a/docs/user-manual/source/model-editor-width.md b/docs/user-manual/source/model-editor-width.md index 28148f1b..e800e954 100644 --- a/docs/user-manual/source/model-editor-width.md +++ b/docs/user-manual/source/model-editor-width.md @@ -1,14 +1,13 @@ # Width -This defines the limb's width along its length. -The width is the same for all layers of the bow. +The width distribution along the limb defines its side‑to‑side shape, which is shared by all layers. +It is defined by a table of relative length and width values. +Each row specifies a position along the limb (from 0% to 100%) and the corresponding width of the limb at that point. +A smooth curve (a monotone cubic spline) is fitted through these values to create the final width distribution, which is displayed in the *Graph* panel. +The plot's context menu offers additional options, such as showing or hiding control points or adding an overlay image. +
Figure: Width properties
- -The width distribution is defined by a table of relative length and width values. -Each table row must contain a relative length along the limb (from 0% to 100%) and the corresponding width. -The actual width distribution is constructed as a smooth curve (monotone cubic spline) passing through the supplied values and is shown in the _Graph_ panel. -You can use the context menu for additional options on the plot, like showing/hiding control points or adding an overlay image. \ No newline at end of file diff --git a/docs/user-manual/source/model-editor.md b/docs/user-manual/source/model-editor.md index 970e5353..b30b4046 100644 --- a/docs/user-manual/source/model-editor.md +++ b/docs/user-manual/source/model-editor.md @@ -1,7 +1,9 @@ # Model Editor The model editor is the first thing you will see when opening VirtualBow. -Here you can design your bows, specify their physical properties and start simulations to investigate their performance. +It serves as the central workspace where you create and refine your bow designs. +Here you can specify shape and dimensions, adjust material properties, and configure all other parameters that affect the bow's behaviour. +Once the model is set up, you can launch simulations to evaluate the performance of your design.
@@ -10,46 +12,50 @@ Here you can design your bows, specify their physical properties and start simul ## Loading and saving files -Use the file menu and/or the toolbar buttons on the top to create, open and save bow models. -Bow models are stored as `.bow` files on disk, which contain all the physical parameters of the bow. -You could share those files with other users and they would be able to open and view your creations. +Use the file menu or the toolbar buttons at the top to create, open, and save bow models. +These models are stored on disk as `.bow` files, which contain all physical and geometric parameters of the design. +You can share these files with other users, who can then open them in VirtualBow to inspect or work with your models. -> **Note:** VirtualBow's goal is to keep compatibility with older `.bow` files as much as possible, so you should be able to open files that were created with older versions. -> Keep in mind though that saving will overwrite the file in the new format. +> [!NOTE] +> New versions of VirtualBow often introduce internal changes to the `.bow` file format. +> The software aims to remain compatible with older files whenever possible, so you can still open models created with earlier releases (currently down to version `0.7`). +> When you save such a file, VirtualBow automatically converts it to the current format and creates a backup with a `.bak` extension in case anything goes wrong. +> After opening an older `.bow` file, it’s a good idea to review the model to ensure that the conversion was successful. ## Editing the bow model -The main view of the editor is a 3D visualization of the bow's current geometry. -Use the mouse to rotate (left button), shift (middle button) and zoom (mouse wheel) the perspective. -More view options are available through the buttons on the bottom. -Besides this 3D view, the editor interface contains three additional panels: +The main area of the editor displays a 3D visualization of the bow’s current geometry. +You can rotate the view with the left mouse button, pan with the middle button, and zoom using the mouse wheel. +Additional view controls are available through the buttons at the bottom of the window. +Alongside the 3D view, the editor interface includes three panels: -- **Model**: The model tree on the top left shows how the bow model is organized, with various categories of physical properties. -If an item in the model tree is selected, its details are shown in the _Properties_ and/or the _Graph_ panels. -Some categories can be edited in the tree by adding, removing or renaming items, namely _Materials_, _Layers_ and _Profile_. +- **Model:** The model tree in the top-left corner shows how the bow model is organized, grouping its various physical and geometric properties. +Selecting an item in the tree displays its details in the _Properties_ and/or _Graph_ panels. Some categories - such as _Materials_, _Layers_, and _Profile_ - can be edited directly in the tree by adding, removing, or renaming items. -- **Properties**: The property editor shows the details of the currently selected item in the model tree. -Here you can view and edit the physical properties of the bow model. +- **Properties:** The property editor displays the properties of the currently selected item in the model tree. +Here you can inspect and modify the physical and geometric parameters of the bow model. -- **Graph**: The graph view will show any graphs/plots that are associated with the selected item in the model tree. +- **Graph:** The graph view will show any graphs/plots that are associated with the selected item in the model tree. The graphs reflect the current properties and change as the properties are being edited. -> **Note:** The physical units that are used throughout the model editor can be changed under _Options_ - _Units_. +- **Graph:** The graph panel displays any plots associated with the selected item in the model tree. +These graphs update automatically as you adjust the corresponding properties, providing immediate visual feedback. + +> [!NOTE] +> You can change the physical units used throughout the model editor under _Options_ → _Units_. ## Running Simulations -Simulations can be started with the _Simuate_ menu or by clicking one of the toolbar buttons. -Any changes to the bow are automatically saved and the VirtualBow solver is invoked on the model file. -There are two different simulation modes: +Simulations can be started from the _Simuate_ menu or by clicking one of the toolbar buttons. +Once a simulation has finished, the results open in a separate result-viewer window. +There are two simulation modes: - **Statics**: -The static simulation analyzes the bow as it is being drawn from brace height to full draw. -One of the results is the force/draw curve, for example. -This mode is called static since the bow is considered to be in static equilibrium at each stage of the draw. +The static simulation analyzes the bow as it is drawn from brace height to full draw. +One of the results is the force-draw curve, among other characteristics. +This mode is called _static_ because the bow is considered to be in static equilibrium at each stage of the draw. - **Dynamics**: The dynamic simulation analyzes the bow and arrow in motion as the string is released from full draw. -It adds things like arrow speed and degree of efficiency to the results. -Since it requires the initial state of the bow at full draw, the dynamic simulation will always be preceded by a static simulation as well. - -The simulation results are stored as a `.res` file next to the model file and automatically opened in the result viewer for analysis. \ No newline at end of file +It provides results such as arrow speed and efficiency. +Because it requires the initial state of the bow at full draw, every dynamic simulation is automatically preceded by a static simulation. diff --git a/docs/user-manual/source/result-viewer-arrow.md b/docs/user-manual/source/result-viewer-arrow.md new file mode 100644 index 00000000..22b0febf --- /dev/null +++ b/docs/user-manual/source/result-viewer-arrow.md @@ -0,0 +1,14 @@ +# Arrow + +This tab is available only for dynamic simulations. +It visualizes the motion of the arrow throughout the shot by plotting its position, velocity and acceleration over time. +Together, these three curves show how the bow transfers energy into the arrow and how the arrow's motion develops from release to separation. + +- **Position:** Shows how far the arrow has traveled from its starting point at each moment. + +- **Velocity:** Shows how quickly the arrow is moving at each moment. +The arrow's velocity typically rises until the arrow leaves the string, then remains constant. + +- **Acceleration:** Shows how strongly the bow is accelerating the arrow at each moment. +Typically decreases to zero at the time the arrow separates from the string. +A slight negative acceleration (deceleration) right before separation can occur due to the **arrow clamp force** defined in the [Settings](model-editor-settings.md#dynamics). diff --git a/docs/user-manual/source/result-viewer-characteristics.md b/docs/user-manual/source/result-viewer-characteristics.md index ed7b821e..d0e7011a 100644 --- a/docs/user-manual/source/result-viewer-characteristics.md +++ b/docs/user-manual/source/result-viewer-characteristics.md @@ -1,47 +1,91 @@ # Characteristics -Shows all results that can be expressed as a single value. -Some of them are specific to static or dynamic analysis, others are common in both. +This tab lists all results that can be expressed as single numerical values. +Some of these values apply only to static or only to dynamic analysis, while others are shared between both modes.
-
Figure: Screenshot of the static characteristics tab
-**Statics** +## Common -- **Final draw force:** The draw force of the bow at full draw +**Maximum stresses:** Shows the maximum tensile and compressive stress that occurred in each layer during the simulation. +The fields are color‑coded to indicate how these stresses compare to the material limits and the defined safety margin: -- **Drawing work:** Total work done by drawing the bow. This work is stored in the bow as potential elastic energy and later partially transfered to the arrow, depending on the bow's efficiency. It is equal to the area under the force-draw curve of the bow. +- **Green** indicates that the maximum stress is within the allowed range, based on the material’s tensile and compressive strength and the chosen margin of safety. -- **Energy storage factor:** This value indicates how good the shape of the draw curve is in terms of energy storage. It is defined as the energy stored by the bow in relation to the energy that would have been stored with a linear draw curve. The energy storage factor increases the "more convex" the shape of the draw curve is. +- **Orange** means the stress exceeds the safe range defined by the margin of safety, but is still below the material’s ultimate strength. -- **Factor < 1:** The draw curve stores less energy than a linear draw curve +- **Red** signals that the stress has surpassed even the ultimate strength of the material. -- **Factor = 1:** The draw curve stores as much energy as a linear draw curve +**Maximum strains:** Shows the maximum tensile and compressive strains that occurred in each layer during the simulation, using the same color‑coding scheme as the maximum stresses. Because stress and strain are directly linked, the maximum strains do not introduce any new information about potential material failure. -- **Factor > 1:** The draw curve stores more energy than a linear draw curve +**Maximum absolute forces:** This section reports the highest values reached during the simulation for selected forces in the bow. -- **Limb mass:** Total mass of a single bow limb, including the additional tip mass +- **Draw force:** Only shown in static analysis. The maximum draw force reached during the draw cycle (which may be different from the final force at full draw). -- **String mass:** Total mass of the bow string, including additional masses +- **Grip force:** The maximum push or pull force required to keep the bow's handle stationary during the simulation. -- **String length:** Length of the string, determined by the desired brace height +- **String force:** The maximum tensile force acting on the bowstring, shown as the total force or resolved by strand. -**Dynamics** +## Statics -- **Final arrow velocity:** Velocity of the arrow when departing from the bow +**Final draw force:** The force required to hold the bow at full draw. +This value is commonly referred to as the bow's draw weight. -- **Degree of efficiency:** The bow's degree of efficiency, i.e. how much of the energy input (drawing work) is converted into useful output (kinetic energy of the arrow) +**Drawing work:** The total mechanical energy put into the bow while drawing it. +This energy is stored in the limbs as elastic potential energy and later only partly passed on to the arrow, depending on the bow's efficiency. +It corresponds to the area under the bow’s force–draw curve. -- **Kinetic energy arrow:** Kinetic energy of the arrow on departure from the string +**Energy storage factor:** This value indicates how effective the bow's force-draw curve is at storing energy. +It is defined as the ratio between the actual energy stored in the bow and the energy that would be stored if the draw curve were perfectly linear. +A more convex curve has a higher storage factor because it accumulates more energy for the same final draw force. -- **Kinetic energy limbs:** Kinetic energy of the limbs on arrow departure +

+ +

    +
  • Factor < 100%: The bow stores less energy than a linear draw curve would allow. This is generally undesireable and might indicate stacking towards the end of the draw.
    • +
    +
  • Factor = 100%: The bow stores exactly as much energy as a linear draw curve would. Values in this range are common for longbows and similar designs.
    • +
    +
  • Factor > 100%: The bow stores more energy than a linear draw curve would. This gives it additional stored energy at the same final draw weight, potentially improving its performance. Well-designed recurve bows, for example, should be firmly in this category.
    • +
+

-- **Kinetic energy string:** Kinetic energy of the string on arrow departure -**Common** +**Limb mass:** The total mass of a single bow limb, calculated from its geometry and material properties. +Any additional masses at the limb tips are included in this value. -- **Minimum and maximum stresses:** Maximum stress by absolute value for each layer. Positive values indicate tension, negative values compression. +**String mass:** The total mass of the bowstring, calculated from its length and material properties. +Any additional masses are included in this value. + +**String length:** The length of the string as determined by the simulation in order to achieve the specified brace height. + +**Power stroke:** The power stroke is the distance from brace height to full draw. +It represents the portion of the draw over which the bow accelerates the arrow. + +## Dynamics + +**Arrow mass:** This is either the explicitly specified mass of the arrow, or the computed arrow mass according to the desired mass per force or mass per energy ratio. + +**Final arrow velocity:** Final velocity of the arrow when it leaves the bow. + +**Final arrow energy:** Final kinetic energy of the arrow when it leaves the bow. + +**Degree of efficiency:** Describes how effectively the bow converts input energy into useful output. +It is the ratio between the drawing work put into the bow and the final kinetic energy of the arrow. +Higher efficiency indicates that a greater portion of the stored energy is delivered to the arrow rather than lost to other effects. + +**Efficiency losses:** The degree of efficiency indicates what portion of the bow's input energy is transferred to the arrow. +This section shows how the remainder of that energy is distributed at the time the arrow leaves the string. +For each component, both the absolute energy loss and its contribution to reducing overall efficiency are listed. +The categories are **kinetic** and **elastic** energy remaining in the limb and string after the arrow left the string, as well as energy lost to **damping** up to that moment. + +> [!NOTE] +> The elastic energy of the limb often appears as a negative value. +> This does not mean the limb adds energy to the system. +> The reference point for the limb's elastic energy, at least for this calculation, is its equilibrium state at brace height. +> At the moment the arrow leaves the string, the limb is abruptly slowed by the tension in the string. +> Because the string is elastic, it allows the limb to overshoot its braced position slightly, reducing its elastic energy below the reference level and producing a negative value. +> The string’s elastic energy increases correspondingly and no physical laws are harmed in the process. -- **Maximum absolute forces:** Maximum forces by absolute value. Entries are the draw force, the string force and the grip support force, i.e. the force that would be required to hold the bow handle. diff --git a/docs/user-manual/source/result-viewer-curvature.md b/docs/user-manual/source/result-viewer-curvature.md index 7f50a665..a430e9ca 100644 --- a/docs/user-manual/source/result-viewer-curvature.md +++ b/docs/user-manual/source/result-viewer-curvature.md @@ -1,9 +1,9 @@ # Curvature -Shows the curvature of the limb along its length. -This is not the total curvature but rather the difference to the unbraced shape. +This tab shows the limb’s curvature along its length, measured relative to its initial unbraced shape. +It offers an additional way to assess the bow's tiller by highlighting which sections of the limb are bending more and which are bending less.
Figure: Screenshot of the curvature tab
-
\ No newline at end of file +
diff --git a/docs/user-manual/source/result-viewer-draw.md b/docs/user-manual/source/result-viewer-draw.md new file mode 100644 index 00000000..31760bd8 --- /dev/null +++ b/docs/user-manual/source/result-viewer-draw.md @@ -0,0 +1,11 @@ +# Draw + +This tab is available only for static simulations. +It displays the bow’s force–draw curve, showing how draw force changes with draw length. +Two options for this plot are available: + +**Show linear reference:** Adds a straight line as a reference for comparison. See also the energy storage factor in the [Characteristics tab](result-viewer-characteristics.md). + +**Show stiffness:** Adds a plot of the bow's stiffness over the draw length. +Stiffness in this case is the increase in draw force per increase in draw length, or in other words the slope of the force-draw curve. +High stiffness towards the end of the draw can indicate stacking. diff --git a/docs/user-manual/source/result-viewer-energy.md b/docs/user-manual/source/result-viewer-energy.md index fdabc5c2..2dec410d 100644 --- a/docs/user-manual/source/result-viewer-energy.md +++ b/docs/user-manual/source/result-viewer-energy.md @@ -1,26 +1,30 @@ # Energy -This plot shows how the energy stored in the bow develops during the simulation and how it is distributed between components (limbs, string arrow) and type of energy (potential/elastic or kinetic). +This plot shows how the energy stored in the bow evolves during the simulation and how it is distributed between components (limbs, string, arrow) and energy types (elastic/potential, kinetic, damping losses). +For **static** simulations, it displays how the elastic energy in the limbs and string builds up during the draw. +No kinetic energies or damping losses are shown, because they are zero in a static analysis. +For **dynamic** simulations, it shows how the initial elastic energy in the limbs is transferred to the arrow and other bow components, as well as how much unused energy remains in the bow after the arrow departs. -In the static case it shows how the elastic energy of the limbs and string develops during draw. -No kinetic energies are shown, because they are zero in static analysis. +In both modes, three display options can be selected independently: + +- **Stacked:** Stacks all energy curves to show how they add up. If the simulation was correct, their sum should be constant. + +- **Group by component:** Group energies by component (limbs, string, arrow, damping) + +- **Group by type:** Group the energies only by type (elastic, kinetic, damping) + +The reference for all elastic energies shown is the initial, unbraced state of the bow. +This means the energy required to brace the bow is included.
Figure: Screenshot of the energy tab for static results
-In the dynamic case it shows how the initial potential energy of the limbs is transferred to the arrow and other components of the bow and how much unused energy stays in the bow after the departure of the arrow. +
Figure: Screenshot of the energy tab for dynamic results
-In both cases there are three options for display that can be selected individually: - -- **Stacked:** Stack the energies on top of each other, so it can bee seen how they add up - -- **Group by component:** Group the energies only by component (limbs, string, arrow) - -- **Group by type:** Group the energies only by type (potential, kinetic) \ No newline at end of file diff --git a/docs/user-manual/source/result-viewer-others.md b/docs/user-manual/source/result-viewer-others.md index 0336b8bd..176539f4 100644 --- a/docs/user-manual/source/result-viewer-others.md +++ b/docs/user-manual/source/result-viewer-others.md @@ -1,38 +1,47 @@ # Other Plots -Here you can combine arbitrary simulation results and plot them together in order to visualize things that aren't shown on any of the default plots. -Examples are the draw curve of the bow (draw force over draw length) or the velocity of the arrow over time. +This tab lets you combine any results from the simulation and plot them against one another. +It allows you to explore the data freely and visualize relationships that aren’t covered by the default plots. +The available data series for static and dynamic analyses are listed below.
Figure: Screenshot of the other plots tab
-Data series available in static analysis: +## Static analysis -| Data Series | Description | -|:--------------------------|:----------------------------------------| -| Draw length | Length to which the bow is drawn | -| Draw force | Draw force of the bow | -| String force (total) | Tension force in the string | -| String force (strand) | String tension per strand | -| Grip force | Force that is required to hold the grip | -| Pot. energy limbs | Potential energy of the limbs | -| Pot. energy string | Potential energy of the string | +| Data Series | Description | +|:--------------------------|:-----------------------------------------------------------------------| +| Power stroke | Current distance between brace height and string | +| Draw length | Current draw length of the bow | +| Draw force | Current draw force of the bow | +| Draw stiffness | Stiffness of the draw, i.e. force increase per increase in draw length | +| String force (total) | Total tensile force in the string | +| String force (strand) | Tensile force per individual strand | +| String length | Current length of the string, including elastic stretch | +| String tip angle | Angle between the limb tip and the string | +| String center angle | Angle at the center of the string | +| Grip force | Force required to hold the grip | +| Elastic energy limbs | Elastic energy of the limbs | +| Elastic energy string | Elastic energy of the string | -Data series available in dynamic analysis: +## Dynamic analysis -| Data Series | Description | -|:--------------------------|:----------------------------------------| -| Time | Time since the release of the shot | -| Arrow position | Position of the arrow | -| Arrow velocity | Velocity of the arrow | -| Arrow acceleration | Acceleration of the arrow | -| String force (total) | Tension force in the string | -| String force (strand) | String tension per strand | -| Grip force | Force that is required to hold the grip | -| Pot. energy limbs | Potential energy of the limbs | -| Kin. energy limbs | Kinetic energy of the limbs | -| Pot. energy string | Potential energy of the string | -| Kin. energy string | Kinetic energy of the string | -| Kin. energy arrow | Kinetic energy of the arrow | \ No newline at end of file +| Data Series | Description | +|:--------------------------|:--------------------------------------------------------| +| Time | Time elapsed since release | +| Arrow position | Position of the arrow | +| Arrow velocity | Velocity of the arrow | +| Arrow acceleration | Acceleration of the arrow | +| String force (total) | Total tensile force in the string | +| String force (strand) | Tensile force per individual strand | +| String length | Current length of the string, including elastic stretch | +| String tip angle | Angle between the limb tip and the string | +| String center angle | Angle at the center of the string | +| Grip force | Force required to hold the grip | +| Elastic energy limbs | Elastic energy of the limbs | +| Kinetic energy limbs | Kinetic energy of the limbs | +| Elastic energy string | Elastic energy of the string | +| Kinetic energy string | Kinetic energy of the string | +| Kinetic energy arrow | Kinetic energy of the arrow | diff --git a/docs/user-manual/source/result-viewer-shape.md b/docs/user-manual/source/result-viewer-shape.md index 5ed9423c..bc0eb52e 100644 --- a/docs/user-manual/source/result-viewer-shape.md +++ b/docs/user-manual/source/result-viewer-shape.md @@ -1,10 +1,9 @@ # Shape -Shows the shape of the limb and string as well as the position of the arrow at different stages of either the draw (statics) or the shot (dynamics). -The little red circle symbolizes the back end of the arrow. -You can use the slider at the bottom to change the current state of the bow or to view all states as a continuous animation. +The shape view displays the geometry of the limbs and string, along with the arrow's position, at different stages of the draw (for statics) or throughout the show (for dynamics). +The small red circle marks the nock end of the arrow, and the blue cross marks the bow's pivot point. +You can use the slider at the bottom to move through the states or play them as a continuous animation.
-
Figure: Screenshot of the shape tab
-
\ No newline at end of file +
diff --git a/docs/user-manual/source/result-viewer-stress.md b/docs/user-manual/source/result-viewer-stress.md index 2826d448..9ac06f53 100644 --- a/docs/user-manual/source/result-viewer-stress.md +++ b/docs/user-manual/source/result-viewer-stress.md @@ -1,9 +1,13 @@ # Stress -Shows the stress distribution along the limb for each one of the layers, evaluated at the back and belly sides. -Positive values indicate tension, negative values compression. +This tab shows the distribution of bending stress for each layer along the length of the limb. +It helps identify regions of the limb that are overstressed and ones that are carrying less load than they could.
-
Figure: Screenshot of stress tab
-
\ No newline at end of file +
+ +The bending stresses (tension and/or compression) vary linearly across the thickness of each layer. +Due to this, the extremes always occur at the layer boundaries. +The plot therefore shows two stresses per layer: one at the back side and one at the belly side. +Positive values represent tension, and negative values represent compression. diff --git a/docs/user-manual/source/result-viewer.md b/docs/user-manual/source/result-viewer.md index 3226ad4a..a8d067e9 100644 --- a/docs/user-manual/source/result-viewer.md +++ b/docs/user-manual/source/result-viewer.md @@ -1,19 +1,19 @@ # Result Viewer -The result viewer is used to open and visualize simulation results that are stored in `.res` files. -It is launched automatically by the model editor when a simulation has finished, but it can also be used as a standalone application. +The result viewer opens automatically after a simulation and provides tools to explore the static and dynamic behaviour of the bow. +The buttons on the lower-right corner let you switch between static and dynamic results, if available. +All results are organized into tabs, which are described in the following sections.
-
Figure: Screenshot of the result viewer
-After loading a result file you can use the buttons on the bottom right corner of the window to switch between static and dynamic results, if available. -The results themselves are organized in different tabs, which will be explained in the next sections. +Beneath the tabs is a slider that controls the current state of the bow being displayed. -Below the tabs there is a slider where you can change the current state of the bow that is being viewed, either by draw length in the static case or by time in the dynamic case. -This value applies to all of the tabs. -Drag the slider to a specific position or use the play buttons to show the simulation results as a continuous animation. -The input field and the dropdown menu next to it allow you to jump directly to special points in the results, for example where certain forces or stresses reach their maximum. +- In **static** mode, the slider represents draw length -> **Note:** The physical units that are used throughout the result viewer can be changed under _Options_ - _Units_. +- In **dynamic** mode, it represents time + +This setting applies across all tabs, though only some of them make use of it. +You can drag the slider to inspect a specific bow state or use the playback controls to animate the simulation continuously. +The input field and dropdown menu next to the slider allow you to jump directly to key points in the results. diff --git a/docs/user-manual/source/scripts/julia.jl b/docs/user-manual/source/scripts/julia.jl index dd74437f..858a3b3a 100644 --- a/docs/user-manual/source/scripts/julia.jl +++ b/docs/user-manual/source/scripts/julia.jl @@ -15,19 +15,12 @@ JSON.print(stream, input, 2) close(stream) # Run a static simulation -run(`virtualbow-cli --static input.bow output.res`) +run(`virtualbow-cli static input.bow output.res`) # Load the result file stream = open("output.res", "r") output = unpack(stream) close(stream) -# Evaluate stresses -He_back = hcat(output["setup"]["limb_properties"]["layers"][1]["He_back"]... ) -Hk_back = hcat(output["setup"]["limb_properties"]["layers"][1]["Hk_back"]... ) - -epsilon = output["statics"]["states"]["epsilon"][end] -kappa = output["statics"]["states"]["kappa"][end] -sigma = He_back*epsilon + Hk_back*kappa - -println(max(sigma...)) +# Evaluate final draw force +println(output["statics"]["final_draw_force"]) diff --git a/docs/user-manual/source/scripts/matlab.m b/docs/user-manual/source/scripts/matlab.m index f5a59b7e..8ec90983 100644 --- a/docs/user-manual/source/scripts/matlab.m +++ b/docs/user-manual/source/scripts/matlab.m @@ -8,17 +8,10 @@ savejson('', input, 'input.bow'); % Run a static simulation -system('virtualbow-cli --static input.bow output.res'); +system('virtualbow-cli static input.bow output.res'); % Load the result file output = loadmsgpack('output.res'); -% Evaluate stresses -He_back = output.setup.limb_properties.layers{1}.He_back; -Hk_back = output.setup.limb_properties.layers{1}.Hk_back; - -epsilon = output.statics.states.epsilon(:,end); -kappa = output.statics.states.kappa(:,end); -sigma = He_back*epsilon + Hk_back*kappa; - -disp(max(sigma)); +% Evaluate final draw force +disp(output.statics.final_draw_force); diff --git a/docs/user-manual/source/scripts/python.py b/docs/user-manual/source/scripts/python.py index be4d680c..2d903fcb 100644 --- a/docs/user-manual/source/scripts/python.py +++ b/docs/user-manual/source/scripts/python.py @@ -14,18 +14,11 @@ json.dump(input, file, indent=2) # Run a static simulation -subprocess.call(["virtualbow-cli", "--static", "input.bow", "output.res"]) +subprocess.call(["virtualbow-cli", "static", "input.bow", "output.res"]) # Load the result file with open("output.res", "rb") as file: output = msgpack.unpack(file, raw=False) -# Evaluate stresses -He_back = np.array(output["setup"]["limb_properties"]["layers"][0]["He_back"]) -Hk_back = np.array(output["setup"]["limb_properties"]["layers"][0]["Hk_back"]) - -epsilon = np.array(output["statics"]["states"]["epsilon"][-1]) -kappa = np.array(output["statics"]["states"]["kappa"][-1]) -sigma = He_back.dot(epsilon) + Hk_back.dot(kappa) - -print(sigma.max()) +# Evaluate final draw force +print(output["statics"]["final_draw_force"]) diff --git a/docs/user-manual/source/solver-command-line.md b/docs/user-manual/source/solver-command-line.md index b12fae9f..8f4cee30 100644 --- a/docs/user-manual/source/solver-command-line.md +++ b/docs/user-manual/source/solver-command-line.md @@ -5,31 +5,31 @@ The VirtualBow executables are named ``` virtualbow-gui // Model editor virtualbow-cli // Solver -virtualbow-post // Result viewer ``` -The solver executable takes a `.bow` model file as its input, performs the simulation and saves the results as a `.res` file that can be opened by the result viewer. +The solver executable takes a `.bow` model file as its input, performs the simulation and saves the results as a `.res` file. The type of simulation (static or dynamic) as well as other options are set by the command line arguments. The detailed usage as shown by the `--help` option is: -Usage: virtualbow-cli [options] input output - ``` -Options: - -?, -h, --help Displays this help. - -v, --version Displays version information. - -s, --static Run a static simulation. - -d, --dynamic Run a dynamic simulation. - -p, --progress Print simulation progress. +Usage: virtualbow_cli [OPTIONS] Arguments: - input Model file (.bow) - output Result file (.res) + Mode of simulation [possible values: static, dynamic] + Input model file (*.bow) + Output result file (*.res) + +Options: + -p, --progress Print simulation progress + -v, --version Print version + -h, --help Print help ``` -NOTE: To use the command line interfaces on Windows you have to either specify the complete path to the respective executable or add the installation directory to your `PATH` environment variable. -There is an option to do this automatically during installation of VirtualBow. +> [!NOTE] +> To use the command line interface on Windows you have to either specify the complete path to the respective executable or add the installation directory to your `PATH` environment variable. +> There is an option to do this automatically during installation of VirtualBow. -NOTE: On MacOS, the VirtualBow executables are hidden inside the application bundle. -They can be accessed by their full path though, or their location can be temporarily added to the `PATH` environment variable with the command `export PATH = $PATH:/Applications/VirtualBow.app/Contents/MacOS`. -Put this line into your `.bash_profile` if you want it to be permanently added. \ No newline at end of file +> [!NOTE] +> On MacOS, the VirtualBow executables are hidden inside the application bundle. +> They can be accessed by their full path though, or their location can be temporarily added to the `PATH` environment variable with the command `export PATH = $PATH:/Applications/VirtualBow.app/Contents/MacOS`. +> Put this line into your `.bash_profile` if you want it to be permanently added. diff --git a/docs/user-manual/source/solver-file-formats.md b/docs/user-manual/source/solver-file-formats.md index 4b214af6..752f6865 100644 --- a/docs/user-manual/source/solver-file-formats.md +++ b/docs/user-manual/source/solver-file-formats.md @@ -1,23 +1,30 @@ # File Formats -## Input - -The input files of the solver are `.bow` model files as created by the model editor. -Those files use the text based JSON[^1] format. -JSON (JavaScript Object Notation) is a very common exchange format for hierarchical data in the form of objects, arrays, strings, numbers and more. -Since the format is text based, it is easy to inspect and modify with a text editor. - -A detailed specification of the model files can be found in [Appendix A](appendix-model-files.md). - -## Output - -The output files of the solver are `.res` result files that can be opened with the result viewer. -The result files use the binary MessagePack[^2] format. -MessagePack is very similar to JSON in the kind of data it can represent, but more space efficient due to being a binary format. -Unlike the input files, the output files cannot be inspected with a text editor. - -A detailed specification of the model files can be found in [Appendix B](appendix-result-files.md). - -[^1]: [https://www.json.org/](https://www.json.org/) - -[^2]: [https://msgpack.org/](https://msgpack.org/) \ No newline at end of file +## Model files + +The solver reads `.bow` model files as created by the VirtualBow model editor. +These files use the text-based [JSON](https://www.json.org/) format. +JSON (JavaScript Object Notation) is a widely used standard for hierarchical data composed of objects, arrays, strings, numbers, and more. +Because it is human-readable, `.bow` files can be easily inspected or modified with any text editor. + +## Result files + +The solver produces `.res` result files containing all static and/or dynamic simulation results. +These files use the binary [MessagePack](https://msgpack.org/) format. +MessagePack represents the same kinds of data as JSON but in a more compact binary form. +Unlike the input files, `.res` files cannot be viewed directly in a text editor, but *Visual Studio Code*, for example, with a Plugins such as `PackLens` or `Data File Viewer` can be used instead. + +## + +> [!NOTE] +> Earlier versions of this manual included detailed specifications of the internal structure of both input and output files. +> As the contents of these files have grown and evolved, maintaining those specifications has become impractical. +> Fortunately, their content is not too complicated. +> Most of it can be understood by experimenting and examining the resulting files. +> The field names often correspond to the names used in the VirtualBow GUI. +> If you have questions about the file formats or need guidance for advanced use cases, feel free to get in touch. + +> [!WARNING] +> The internal file structure used by VirtualBow changes frequently. +> VirtualBow maintains backward compatibility only for `.bow` model files, not for `.res` result files. +> If you integrate tools or workflows with these formats, you should expect having to update them to keep them working with newer versions of VirtualBow. diff --git a/docs/user-manual/source/solver-scripting.md b/docs/user-manual/source/solver-scripting.md index 26836567..38a48d5d 100644 --- a/docs/user-manual/source/solver-scripting.md +++ b/docs/user-manual/source/solver-scripting.md @@ -1,23 +1,21 @@ # Scripting -The main use of the solver as a standalone application is the ability to write programs that automatically launch simulations and analyze the results. -This is especially useful for performing design optimizations or exploring the influence of certain model parameters on the simulation results. +The primary reason to use the solver as a standalone application is to automate simulations and analyze the results programmatically. This is especially useful for tasks such as design optimization, parameter sweeps, or studying how specific model parameters influence the simulation outcome. -Scripts that interoperate with VirtualBow have to be able to call the solver via the command line interface as well as read and write the model and result files that constitute the input and output of the solver. -As a consequence of the file formats, any programming language that supports JSON and MessagePack can be used. -Both are fairly common formats and most languages have either built-in support or there are external libraries available. +Scripts that interact with VirtualBow must be able to launch the solver through its command‑line interface and read or write the model and result files that serve as its input and output. Because the solver uses JSON for input and MessagePack for output, any programming language with support for these formats can be used. Both are widely supported, either natively or through readily available libraries. -For getting started, the following sections show how to interface with VirtualBow for some programming languages commonly used in scientific computing. -Each of the examples performs the same series of basic tasks: +To help you get started, the following sections demonstrate how to interface with VirtualBow in several programming languages commonly used in scientific computing. Each example performs the same sequence of basic tasks: -1. Load, modify and save a model file -2. Run a static simulation with the model file -3. Load the result file and evaluate the maximum stress of the first layer at full draw +1. Load, modify, and save a model file + +2. Run a static simulation using that model + +3. Load the result file and print the final draw force ## Python -The python example below uses two external packages, [msgpack](https://pypi.org/project/msgpack/) for reading the result files and [numpy](https://pypi.org/project/numpy/) for evaluating the stresses. -They can be installed with `pip install msgpack numpy`. +The python example below uses the external [msgpack](https://pypi.org/project/msgpack/) package for reading the result files. +It can be installed with `pip install msgpack`. ```python {{#include scripts/python.py}} @@ -25,7 +23,7 @@ They can be installed with `pip install msgpack numpy`. ## Matlab -This Matlab example uses the [JSONLab](https://de.mathworks.com/matlabcentral/fileexchange/33381) library, which can read and write both JSON and MessagePack files. +The Matlab example uses the [JSONLab](https://de.mathworks.com/matlabcentral/fileexchange/33381) library, which can read and write both JSON and MessagePack files. ```matlab {{#include scripts/matlab.m}} @@ -38,4 +36,4 @@ They can be installed with `julia> import Pkg; Pkg.add("JSON"); Pkg.add("MsgPack ```julia {{#include scripts/julia.jl}} -``` \ No newline at end of file +``` diff --git a/docs/user-manual/source/solver.md b/docs/user-manual/source/solver.md index 2bdfeec0..1ca47815 100644 --- a/docs/user-manual/source/solver.md +++ b/docs/user-manual/source/solver.md @@ -1,4 +1,5 @@ # Solver -The solver is the part of VirtualBow that actually performs the required calculations. -It only has a command line interface and is invoked automatically by the model editor when a simulation is started, but can also be used on its own for advanced use cases. \ No newline at end of file +The solver is the component of VirtualBow that performs all the numerical calculations required for a simulation. +It is normally invoked automatically by the model editor whenever you start a static or dynamic analysis. +For advanced workflows, however, the solver can also be run independently, allowing you to batch‑process models or integrate VirtualBow with external scripts. diff --git a/gui/source/post/EnergyPlot.cpp b/gui/source/post/EnergyPlot.cpp index bde6641c..97c13a80 100755 --- a/gui/source/post/EnergyPlot.cpp +++ b/gui/source/post/EnergyPlot.cpp @@ -144,9 +144,9 @@ void EnergyPlot::updatePlot() { e_damp[i] = states.damping_energy_limbs[i] + states.damping_energy_string[i]; } - plot_energy(e_limbs, "Limbs\n(pot + kin)", QColor(0, 0, 255)); - plot_energy(e_string, "String\n(pot + kin)", QColor(128, 0, 128)); - plot_energy(states.kinetic_energy_arrow, "Arrow\n(pot + kin)", QColor(255, 0, 0)); + plot_energy(e_limbs, "Limbs\n(total)", QColor(0, 0, 255)); + plot_energy(e_string, "String\n(total)", QColor(128, 0, 128)); + plot_energy(states.kinetic_energy_arrow, "Arrow\n(total)", QColor(255, 0, 0)); plot_energy(e_damp, "Damping", QColor(128, 128, 128)); } else if(cb_type->isChecked()) { @@ -165,14 +165,14 @@ void EnergyPlot::updatePlot() { e_damp[i] = states.damping_energy_limbs[i] + states.damping_energy_string[i]; } - plot_energy(e_pot, "Potential", QColor(0, 0, 255)); + plot_energy(e_pot, "Elastic", QColor(0, 0, 255)); plot_energy(e_kin, "Kinetic", QColor(255, 0, 0)); plot_energy(e_damp, "Damping", QColor(128, 128, 128)); } else { - plot_energy(states.elastic_energy_limbs, "Limbs\n(potential)", QColor(0, 0, 255)); + plot_energy(states.elastic_energy_limbs, "Limbs\n(elastic)", QColor(0, 0, 255)); plot_energy(states.kinetic_energy_limbs, "Limbs\n(kinetic)", QColor(40, 40, 255)); - plot_energy(states.elastic_energy_string, "String\n(potential)", QColor(128, 0, 128)); + plot_energy(states.elastic_energy_string, "String\n(elastic)", QColor(128, 0, 128)); plot_energy(states.kinetic_energy_string, "String\n(kinetic)", QColor(128, 40, 128)); plot_energy(states.kinetic_energy_arrow, "Arrow\n(kinetic)", QColor(255, 0, 0)); plot_energy(states.damping_energy_limbs, "Limbs\n(damping)", QColor(128, 128, 128)); diff --git a/gui/source/post/OutputWidget.cpp b/gui/source/post/OutputWidget.cpp index 7717dbac..9721c53c 100644 --- a/gui/source/post/OutputWidget.cpp +++ b/gui/source/post/OutputWidget.cpp @@ -161,8 +161,8 @@ StaticOutputWidget::StaticOutputWidget(const BowResult& data) plot_combo->addData("String tip angle", data.statics->states.string_tip_angle, Quantities::angle); plot_combo->addData("String center angle", data.statics->states.string_center_angle, Quantities::angle); plot_combo->addData("Grip force", data.statics->states.grip_force, Quantities::force); - plot_combo->addData("Pot. energy limbs", data.statics->states.elastic_energy_limbs, Quantities::energy); - plot_combo->addData("Pot. energy string", data.statics->states.elastic_energy_string, Quantities::energy); + plot_combo->addData("Elastic energy limbs", data.statics->states.elastic_energy_limbs, Quantities::energy); + plot_combo->addData("Elastic energy string", data.statics->states.elastic_energy_string, Quantities::energy); plot_combo->setCombination(1, 2); tabs->addTab(scrollArea(numbers), "Characteristics"); @@ -309,11 +309,11 @@ DynamicOutputWidget::DynamicOutputWidget(const BowResult& data) plot_combo->addData("String tip angle", data.dynamics->states.string_tip_angle, Quantities::angle); plot_combo->addData("String center angle", data.dynamics->states.string_center_angle, Quantities::angle); plot_combo->addData("Grip force", data.dynamics->states.grip_force, Quantities::force); - plot_combo->addData("Pot. energy limbs", data.dynamics->states.elastic_energy_limbs, Quantities::energy); - plot_combo->addData("Kin. energy limbs", data.dynamics->states.kinetic_energy_limbs, Quantities::energy); - plot_combo->addData("Pot. energy string", data.dynamics->states.elastic_energy_string, Quantities::energy); - plot_combo->addData("Kin. energy string", data.dynamics->states.kinetic_energy_string, Quantities::energy); - plot_combo->addData("Kin. energy arrow", data.dynamics->states.kinetic_energy_arrow, Quantities::energy); + plot_combo->addData("Elastic energy limbs", data.dynamics->states.elastic_energy_limbs, Quantities::energy); + plot_combo->addData("Kinetic energy limbs", data.dynamics->states.kinetic_energy_limbs, Quantities::energy); + plot_combo->addData("Elastic energy string", data.dynamics->states.elastic_energy_string, Quantities::energy); + plot_combo->addData("Kinetic energy string", data.dynamics->states.kinetic_energy_string, Quantities::energy); + plot_combo->addData("Kinetic energy arrow", data.dynamics->states.kinetic_energy_arrow, Quantities::energy); plot_combo->setCombination(0, 1); tabs->addTab(scrollArea(numbers), "Characteristics"); diff --git a/gui/source/pre/Language.hpp b/gui/source/pre/Language.hpp index 9ae4c193..cd6ffe1c 100644 --- a/gui/source/pre/Language.hpp +++ b/gui/source/pre/Language.hpp @@ -8,7 +8,7 @@ namespace Tooltips { inline const QString EnergiesStacked = QStringLiteral("If selected, the energies are plotted as areas stacked on top of each other.\nOtherwise each energy is drawn as an individual line."); inline const QString EnergiesByPart = QStringLiteral("Group energies by the component they belong to (limbs, string, arrow)"); - inline const QString EnergiesByType = QStringLiteral("Group enegies by the type they belong to (potential, kinetic, damping)"); + inline const QString EnergiesByType = QStringLiteral("Group enegies by the type they belong to (elastic, kinetic, damping)"); inline const QString HandleTypeDefinition = QStringLiteral("Selects the type of handle for this bow"); inline const QString HandleTypeFlexible = QStringLiteral("The handle is flexible and modelled as part of the bow limbs"); @@ -58,7 +58,7 @@ namespace Tooltips { inline const QString SettingsArrowClampForce = QStringLiteral("Force that the arrow has to overcome before separating from the string"); inline const QString SettingsStringCompressionFactor = QStringLiteral("Factor for the compressive stiffness of the string relative to its tensile stiffness.\nShould be very low but can't be zero for numerical reasons."); inline const QString SettingsTimespanFactor = QStringLiteral("Factor for controlling the end time of the dynamic simulation.\nThe value 1.0 corresponds to the time until the arrow reaches brace height.\nValues larger than 1.0 extend the simulated time beyond that."); - inline const QString SettingsTimeoutFactor = QStringLiteral("Factor for controlling the timeout of the dynamic simulation.\nThe simulation is aborted when arrow separation didn't happen until the simulation time exceeds the timeout factor multiplied by a characteristic time of the bow."); + inline const QString SettingsTimeoutFactor = QStringLiteral("Factor for controlling the timeout of the dynamic simulation.\nThe simulation is aborted when arrow separation didn't happen until the simulation time exceeds the timeout factor multiplied by a reference time of the bow."); inline const QString SettingsMinTimestep = QStringLiteral("Lower bound for the time step of the dynamic simulation"); inline const QString SettingsMaxTimestep = QStringLiteral("Upper bound for the time step of the dynamic simulation"); inline const QString SettingsStepsPerPeriod = QStringLiteral("Number of steps the dynamic solver tries to take per current characteristic time period of the system"); @@ -70,7 +70,7 @@ namespace Tooltips { inline const QString MaterialShearModulus = QStringLiteral("Shear modulus of the material"); inline const QString MaterialTensileStrength = QStringLiteral("Tensile strength of the material"); inline const QString MaterialCompressiveStrength = QStringLiteral("Compressive strength of the material"); - inline const QString MaterialSafetyMargin = QStringLiteral("Safety margin for tensile and compressive strength"); + inline const QString MaterialMarginOfSafety = QStringLiteral("Safety margin for tensile and compressive strength"); inline const QString StringLinearStiffness = QStringLiteral("Linear stiffness of a single strand of the string material"); inline const QString StringLinearDensity = QStringLiteral("Linear density of a single strand of the string material"); diff --git a/gui/source/pre/models/MainModel.cpp b/gui/source/pre/models/MainModel.cpp index 47bcde99..8090d0d1 100644 --- a/gui/source/pre/models/MainModel.cpp +++ b/gui/source/pre/models/MainModel.cpp @@ -164,7 +164,7 @@ LayerModel* MainModel::getLayerModel(int index) { TableModel* MainModel::getLayerHeightModel(int index) { if(bow.has_value() && index >= 0 && index < bow->section.layers.size()) { - auto model = new TableModel(std::next(bow->section.layers.begin(), index)->height, "Position", "Height", Quantities::ratio, Quantities::length, true); + auto model = new TableModel(std::next(bow->section.layers.begin(), index)->height, "Length", "Thickness", Quantities::ratio, Quantities::length, true); connectSubModel(model); return model; } @@ -174,7 +174,7 @@ TableModel* MainModel::getLayerHeightModel(int index) { TableModel* MainModel::getWidthModel() { if(bow.has_value()) { - auto model = new TableModel(bow->section.width, "Position", "Width", Quantities::ratio, Quantities::length, true); + auto model = new TableModel(bow->section.width, "Length", "Width", Quantities::ratio, Quantities::length, true); connectSubModel(model); return model; } diff --git a/gui/source/pre/models/MaterialModel.cpp b/gui/source/pre/models/MaterialModel.cpp index 2a06b582..494e68ba 100644 --- a/gui/source/pre/models/MaterialModel.cpp +++ b/gui/source/pre/models/MaterialModel.cpp @@ -9,5 +9,5 @@ MaterialModel::MaterialModel(Material& material) { SHEAR_MODULUS = addDouble(material.shear_modulus); TENSILE_STRENGTH = addDouble(material.tensile_strength); COMPRESSIVE_STRENGTH = addDouble(material.compressive_strength); - SAFETY_MARGIN = addDouble(material.safety_margin); + MARGIN_OF_SAFETY = addDouble(material.margin_of_safety); } diff --git a/gui/source/pre/models/MaterialModel.hpp b/gui/source/pre/models/MaterialModel.hpp index 6d02112a..5eb1a2ae 100644 --- a/gui/source/pre/models/MaterialModel.hpp +++ b/gui/source/pre/models/MaterialModel.hpp @@ -12,7 +12,7 @@ class MaterialModel: public PropertyListModel { QPersistentModelIndex SHEAR_MODULUS; QPersistentModelIndex TENSILE_STRENGTH; QPersistentModelIndex COMPRESSIVE_STRENGTH; - QPersistentModelIndex SAFETY_MARGIN; + QPersistentModelIndex MARGIN_OF_SAFETY; MaterialModel(Material& material); }; diff --git a/gui/source/pre/models/units/UnitSystem.cpp b/gui/source/pre/models/units/UnitSystem.cpp index 7222d30f..da713fb6 100644 --- a/gui/source/pre/models/units/UnitSystem.cpp +++ b/gui/source/pre/models/units/UnitSystem.cpp @@ -24,8 +24,8 @@ const Unit Units::Grain_Per_PoundForce = Unit("gr/lbf", "Grain per pound-force", const Unit Units::Kilogram_Per_Joule = Unit("kg/J", "Kilogram per Joule", SI, 1.0); const Unit Units::Gram_Per_Joule = Unit("g/J", "Gram per Joule", SI, 1e-3); const Unit Units::Pound_Per_FootPound = Unit("lb/ft*lbf", "Pound per foot-pound", US, 0.453592/1.35582); -const Unit Units::Ounce_Per_FootPound = Unit("oz/ft*lbf", "Ounce per pound-force", US, 0.0283495/1.35582); -const Unit Units::Grain_Per_FootPound = Unit("gr/ft*lbf", "Grain per pound-force", US, 0.00006479891/1.35582); +const Unit Units::Ounce_Per_FootPound = Unit("oz/ft*lbf", "Ounce per foot-pound", US, 0.0283495/1.35582); +const Unit Units::Grain_Per_FootPound = Unit("gr/ft*lbf", "Grain per foot-pound", US, 0.00006479891/1.35582); const Unit Units::Newton = Unit("N", "Newton", SI, 1.0); const Unit Units::Newton_Per_Percent = Unit("N/%", "Newton per percent", SI, 1e2); diff --git a/gui/source/pre/views/ArrowMassView.cpp b/gui/source/pre/views/ArrowMassView.cpp index a1412118..f52d3e83 100644 --- a/gui/source/pre/views/ArrowMassView.cpp +++ b/gui/source/pre/views/ArrowMassView.cpp @@ -11,8 +11,8 @@ #include ArrowMassView::ArrowMassView(QAbstractItemModel* model, QPersistentModelIndex index) { - auto selectionBox = new QComboBox(); - selectionBox->addItems({"Mass", "Mass per Force", "Mass per Energy"}); + auto selectionBox = new QComboBox(); + selectionBox->addItems({"Mass", "Mass per force", "Mass per energy"}); selectionBox->setToolTip(Tooltips::ArrowMassDefinition); selectionBox->setItemData(0, Tooltips::ArrowMassAbsolute, Qt::ToolTipRole); selectionBox->setItemData(1, Tooltips::ArrowMassPerForce, Qt::ToolTipRole); diff --git a/gui/source/pre/views/HandleView.cpp b/gui/source/pre/views/HandleView.cpp index d11ae336..21ae88af 100644 --- a/gui/source/pre/views/HandleView.cpp +++ b/gui/source/pre/views/HandleView.cpp @@ -8,24 +8,21 @@ #include HandleView::HandleView(HandleModel* model) { - //addProperty("Brace height", new DoubleView(model, model->BRACE_HEIGHT, Quantities::length, DoubleRange::positive(1e-3), Tooltips::BraceHeight)); - //addProperty("Draw length", new DrawLengthView(model, model->DRAW_LENGTH)); - auto selectionBox = new QComboBox(); selectionBox->addItems({"Flexible", "Rigid"}); selectionBox->setToolTip(Tooltips::HandleTypeDefinition); selectionBox->setItemData(0, Tooltips::HandleTypeFlexible, Qt::ToolTipRole); selectionBox->setItemData(1, Tooltips::HandleTypeRigid, Qt::ToolTipRole); - auto lengthEdit = new DoubleSpinBox(Quantities::length, DoubleRange::positive(1e-3)); + auto lengthEdit = new DoubleSpinBox(Quantities::length, DoubleRange::nonNegative(1e-3)); lengthEdit->setToolTip(Tooltips::HandleLength); lengthEdit->setValue(0.0); - auto angleEdit = new DoubleSpinBox(Quantities::angle, DoubleRange::positive(1e-2)); + auto angleEdit = new DoubleSpinBox(Quantities::angle, DoubleRange::unrestricted(1e-2)); angleEdit->setToolTip(Tooltips::HandleAngle); angleEdit->setValue(0.0); - auto pivotEdit = new DoubleSpinBox(Quantities::length, DoubleRange::positive(1e-3)); + auto pivotEdit = new DoubleSpinBox(Quantities::length, DoubleRange::unrestricted(1e-3)); pivotEdit->setToolTip(Tooltips::HandlePivot); pivotEdit->setValue(0.0); diff --git a/gui/source/pre/views/MaterialView.cpp b/gui/source/pre/views/MaterialView.cpp index 20328e2d..c7649371 100644 --- a/gui/source/pre/views/MaterialView.cpp +++ b/gui/source/pre/views/MaterialView.cpp @@ -7,17 +7,18 @@ #include "pre/Language.hpp" MaterialView::MaterialView(MaterialModel* model) { + addHeading("General"); addProperty("Color", new ColorView(model, model->COLOR, Tooltips::MaterialColor)); addProperty("Density", new DoubleView(model, model->DENSITY, Quantities::density, DoubleRange::positive(1.0), Tooltips::MaterialDensity)); - addHeading("Stiffness"); + addHeading("Elasticity"); addProperty("Young's modulus", new DoubleView(model, model->YOUNGS_MODULUS, Quantities::elastic_modulus, DoubleRange::positive(0.1e9), Tooltips::MaterialYoungsModulus)); addProperty("Shear modulus", new DoubleView(model, model->SHEAR_MODULUS, Quantities::elastic_modulus, DoubleRange::positive(0.1e9), Tooltips::MaterialShearModulus)); addHeading("Strength"); addProperty("Tensile strength", new DoubleView(model, model->TENSILE_STRENGTH, Quantities::stress, DoubleRange::nonNegative(0.1e6), Tooltips::MaterialTensileStrength)); addProperty("Compressive strength", new DoubleView(model, model->COMPRESSIVE_STRENGTH, Quantities::stress, DoubleRange::nonNegative(0.1e6), Tooltips::MaterialCompressiveStrength)); - addProperty("Safety margin", new DoubleView(model, model->SAFETY_MARGIN, Quantities::ratio, DoubleRange::nonNegative(1e-2), Tooltips::MaterialSafetyMargin)); + addProperty("Margin of safety", new DoubleView(model, model->MARGIN_OF_SAFETY, Quantities::ratio, DoubleRange::nonNegative(1e-2), Tooltips::MaterialMarginOfSafety)); addStretch(); } diff --git a/gui/source/pre/views/limb2d/HeightPlotView.cpp b/gui/source/pre/views/limb2d/HeightPlotView.cpp index af076cf7..5a3c192f 100644 --- a/gui/source/pre/views/limb2d/HeightPlotView.cpp +++ b/gui/source/pre/views/limb2d/HeightPlotView.cpp @@ -51,7 +51,7 @@ void HeightPlotView::updatePlot() { } // Y axis always shows the width in length units - yAxis->setLabel("Height " + Quantities::length.getUnit().getLabel()); + yAxis->setLabel("Thickness " + Quantities::length.getUnit().getLabel()); graphLine->data()->clear(); graphPoints->data()->clear(); diff --git a/gui/source/solver/BowModel.cpp b/gui/source/solver/BowModel.cpp index b383b9fc..60c7c277 100644 --- a/gui/source/solver/BowModel.cpp +++ b/gui/source/solver/BowModel.cpp @@ -44,7 +44,7 @@ BowModel BowModel::example() { .shear_modulus = 6e9, .tensile_strength = 0.0, .compressive_strength = 0.0, - .safety_margin = 0.0 + .margin_of_safety = 0.0 } }, .layers = { diff --git a/gui/source/solver/BowModel.hpp b/gui/source/solver/BowModel.hpp index 23cb044a..a8ce17f3 100644 --- a/gui/source/solver/BowModel.hpp +++ b/gui/source/solver/BowModel.hpp @@ -210,7 +210,7 @@ struct Material { double shear_modulus; double tensile_strength; double compressive_strength; - double safety_margin; + double margin_of_safety; }; NLOHMANN_DEFINE_TYPE_NON_INTRUSIVE( @@ -222,7 +222,7 @@ NLOHMANN_DEFINE_TYPE_NON_INTRUSIVE( shear_modulus, tensile_strength, compressive_strength, - safety_margin + margin_of_safety ) struct Layer { diff --git a/rust/virtualbow/data/output/valid_results.res b/rust/virtualbow/data/output/valid_results.res deleted file mode 100644 index 4439e9c009afab58dddace00c1cdf794335758d3..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 3224 zcmeHJOK#gR5cN%ZgTOrz!AK*SutW+ZZP)vx1-c@dD-f%t~4t29xf>ccKa(eZCdNnO0k>`Scy3bgC{khD5r+Q`{RxHN9at17& zX;WT{1&@_^kW@2aHcqX~b0HK%4JWXqnK=Y85?o7>nSHd7OR5(V9AjIsrO>1hjO*VM z|0^@P#+b~m5G#;Gq2(L``iwH;DRGen^}(x^W=X<9seo)flG8KglTDAbR2!u+n@D{u z?E=)F$-8^aa<~gST`sngSWe=%h(%JO!LAv@T=4A7!1esa<{=N-Q^FZUal&4wmHGXj^lL)xRi8ILGdH!I$mPmO# zoY)~@oMxn{YpCY82C-eU5^^4}z0yL`6i7lNTm^lV(+|$4x;@zSdAwf&ZF0gwh-cW| z+BNaC5XMP!UM&P|{)y~-6gX`_-Tbgp7)huj8n}Ig%+Cu1-=jhz#iDIH9A*Epv&gyK zW4z`x$Ju^6&UXLEh9(G$akh6$bL_kZ<7}UVZW(9$t7m)VKCN0Gn_rzShJs4_Is9uJ I+3k`27nrb|W&i*H diff --git a/rust/virtualbow/src/errors.rs b/rust/virtualbow/src/errors.rs index 54ffb2d7..4ff5c193 100644 --- a/rust/virtualbow/src/errors.rs +++ b/rust/virtualbow/src/errors.rs @@ -51,7 +51,7 @@ pub enum ModelError { MaterialInvalidShearModulus(String, f64), MaterialInvalidTensileStrength(String, f64), MaterialInvalidCompressiveStrength(String, f64), - MaterialInvalidSafetyMargin(String, f64), + MaterialInvalidMarginOfSafety(String, f64), WidthControlPointsTooFew(usize), WidthControlPointsNotSorted(f64, f64), @@ -158,7 +158,7 @@ impl Display for ModelError { ModelError::MaterialInvalidShearModulus(name, value) => write!(f, "Material \"{name}\": Shear modulus must be a positive number but actual value is {value}.")?, ModelError::MaterialInvalidTensileStrength(name, value) => write!(f, "Material \"{name}\": Tensile strength must be a positive number but actual value is {value}.")?, ModelError::MaterialInvalidCompressiveStrength(name, value) => write!(f, "Material \"{name}\": Compressive strength must be a positive number but actual value is {value}.")?, - ModelError::MaterialInvalidSafetyMargin(name, value) => write!(f, "Material \"{name}\": Safety margin must be in the range [0, 1] but actual value is {value}.")?, + ModelError::MaterialInvalidMarginOfSafety(name, value) => write!(f, "Material \"{name}\": Margin of safety must be non-negative and finite but actual value is {value}.")?, ModelError::WidthControlPointsTooFew(value) => write!(f, "Width: At least 2 control points are required but actual number is {value}.")?, ModelError::WidthControlPointsNotSorted(a, b) => write!(f, "Width: Control points must be sorted by length but found actual values {a}, {b}.")?, diff --git a/rust/virtualbow/src/input/model.rs b/rust/virtualbow/src/input/model.rs index 8d1be9a9..636dbd76 100644 --- a/rust/virtualbow/src/input/model.rs +++ b/rust/virtualbow/src/input/model.rs @@ -52,7 +52,7 @@ impl BowModel { shear_modulus: 6e9, tensile_strength: 0.0, compressive_strength: 0.0, - safety_margin: 0.0, + margin_of_safety: 0.0, }], layers: vec![Layer { name: "Layer 1".into(), @@ -193,7 +193,7 @@ impl Material { shear_modulus: G, tensile_strength: 0.0, compressive_strength: 0.0, - safety_margin: 0.0 + margin_of_safety: 0.0 } } @@ -202,10 +202,10 @@ impl Material { (self.tensile_strength, self.compressive_strength) } - // Allowed stresses (tension, compression) according to the safety margin + // Allowed stresses (tension, compression) according to the margin of safety pub fn allowed_stresses(&self) -> (f64, f64) { let (tension, compression) = self.maximum_stresses(); - (tension*(1.0 - self.safety_margin), compression*(1.0 - self.safety_margin)) + (tension/(1.0 + self.margin_of_safety), compression/(1.0 + self.margin_of_safety)) } // Maximum strains (tension, compression) at which the material fails @@ -214,14 +214,14 @@ impl Material { (tension/self.youngs_modulus, compression/self.youngs_modulus) } - // Allowed strains (tension, compression) according to the safety margin + // Allowed strains (tension, compression) according to the margin of safety pub fn allowed_strains(&self) -> (f64, f64) { let (tension, compression) = self.allowed_stresses(); (tension/self.youngs_modulus, compression/self.youngs_modulus) } pub fn validate(&self) -> Result<(), ModelError> { - let Self { name, color, density, youngs_modulus, shear_modulus, tensile_strength, compressive_strength, safety_margin } = self; + let Self { name, color, density, youngs_modulus, shear_modulus, tensile_strength, compressive_strength, margin_of_safety: safety_margin } = self; name.validate_name().map_err(ModelError::MaterialInvalidName)?; color.validate_hex_color().map_err(|value| ModelError::MaterialInvalidColor(name.into(), value))?; @@ -232,7 +232,7 @@ impl Material { tensile_strength.validate_nonneg().map_err(|value| ModelError::MaterialInvalidTensileStrength(name.into(), value))?; // Allows values of zero for "unknown" compressive_strength.validate_nonneg().map_err(|value| ModelError::MaterialInvalidCompressiveStrength(name.into(), value))?; // Allows values of zero for "unknown" - safety_margin.validate_range_inclusive(0.0, 1.0).map_err(|value| ModelError::MaterialInvalidSafetyMargin(name.into(), value))?; + safety_margin.validate_nonneg().map_err(|value| ModelError::MaterialInvalidMarginOfSafety(name.into(), value))?; Ok(()) } diff --git a/rust/virtualbow/src/input/versions/latest.rs b/rust/virtualbow/src/input/versions/latest.rs index 79f1ae66..4c765f41 100644 --- a/rust/virtualbow/src/input/versions/latest.rs +++ b/rust/virtualbow/src/input/versions/latest.rs @@ -105,7 +105,7 @@ pub struct Material { pub shear_modulus: f64, pub tensile_strength: f64, pub compressive_strength: f64, - pub safety_margin: f64 + pub margin_of_safety: f64 } #[derive(Serialize, Deserialize, Debug, Clone, PartialEq)] @@ -229,7 +229,7 @@ impl From for BowModel { shear_modulus, tensile_strength: 0.0, // Field was newly introduced, value unknown. compressive_strength: 0.0, // Field was newly introduced, value unknown. - safety_margin: 0.0 // Field was newly introduced, value unknown. + margin_of_safety: 0.0 // Field was newly introduced, value unknown. } }).collect_vec(); From 602895e01fbc9acf41d962f1cccc793c6d6241fc Mon Sep 17 00:00:00 2001 From: Stefan Pfeifer Date: Wed, 15 Apr 2026 23:13:43 +0200 Subject: [PATCH 02/18] More changes to the user manual --- .../source/appendix-bending-test.md | 10 +- .../source/appendix-model-files.md | 94 -------------- .../source/appendix-result-files.md | 117 ------------------ .../source/appendix-tips-and-tricks.md | 16 ++- .../source/images/icons/model-damping.png | Bin 0 -> 749 bytes .../source/images/icons/model-layers.png | Bin 0 -> 1258 bytes .../source/images/icons/model-masses.png | Bin 0 -> 556 bytes .../source/images/icons/model-materials.png | Bin 0 -> 1327 bytes .../source/images/icons/model-profile.png | Bin 0 -> 464 bytes .../source/images/icons/model-string.png | Bin 0 -> 722 bytes .../source/images/icons/model-width.png | Bin 0 -> 566 bytes .../images/screenshots/viewer/arrow.png | Bin 0 -> 74359 bytes .../source/images/screenshots/viewer/draw.png | Bin 0 -> 90778 bytes .../source/model-editor-comments.md | 4 +- .../source/model-editor-damping.md | 15 ++- docs/user-manual/source/model-editor-draw.md | 4 +- .../user-manual/source/model-editor-handle.md | 24 +++- .../user-manual/source/model-editor-layers.md | 18 ++- .../user-manual/source/model-editor-masses.md | 21 ++-- .../source/model-editor-materials.md | 18 ++- .../source/model-editor-profile.md | 26 ++-- .../user-manual/source/model-editor-string.md | 2 +- docs/user-manual/source/model-editor-width.md | 6 +- docs/user-manual/source/model-editor.md | 4 +- .../user-manual/source/result-viewer-arrow.md | 12 +- .../source/result-viewer-characteristics.md | 8 +- .../source/result-viewer-curvature.md | 5 +- docs/user-manual/source/result-viewer-draw.md | 7 ++ .../source/result-viewer-energy.md | 29 +++-- .../source/result-viewer-others.md | 5 +- .../user-manual/source/result-viewer-shape.md | 4 +- .../source/result-viewer-stress.md | 4 +- docs/user-manual/source/result-viewer.md | 4 +- 33 files changed, 172 insertions(+), 285 deletions(-) delete mode 100644 docs/user-manual/source/appendix-model-files.md delete mode 100644 docs/user-manual/source/appendix-result-files.md create mode 100644 docs/user-manual/source/images/icons/model-damping.png create mode 100644 docs/user-manual/source/images/icons/model-layers.png create mode 100644 docs/user-manual/source/images/icons/model-masses.png create mode 100644 docs/user-manual/source/images/icons/model-materials.png create mode 100644 docs/user-manual/source/images/icons/model-profile.png create mode 100644 docs/user-manual/source/images/icons/model-string.png create mode 100644 docs/user-manual/source/images/icons/model-width.png create mode 100644 docs/user-manual/source/images/screenshots/viewer/arrow.png create mode 100644 docs/user-manual/source/images/screenshots/viewer/draw.png diff --git a/docs/user-manual/source/appendix-bending-test.md b/docs/user-manual/source/appendix-bending-test.md index dd10edb7..4763020d 100644 --- a/docs/user-manual/source/appendix-bending-test.md +++ b/docs/user-manual/source/appendix-bending-test.md @@ -19,7 +19,9 @@ Alternatively, an accurate bow/hanging scale might also work. ## Clamped Setup In this setup the sample is clamped on one end and the force is applied on the free end. @@ -30,10 +32,12 @@ The elastic modulus can be calculated as ## Three-point Setup
- + + +
In this setup the sample is placed between two rolling supports with distance \\(l\\) and the force is applied in the middle. The elastic modulus can be calculated as -\\[E = \frac{Fl^3}{48Is} = \frac{Fl^3}{4wh^3 s}\\] \ No newline at end of file +\\[E = \frac{Fl^3}{48Is} = \frac{Fl^3}{4wh^3 s}\\] diff --git a/docs/user-manual/source/appendix-model-files.md b/docs/user-manual/source/appendix-model-files.md deleted file mode 100644 index e51f6ae1..00000000 --- a/docs/user-manual/source/appendix-model-files.md +++ /dev/null @@ -1,94 +0,0 @@ -# Model Files - -> **Note:** The following specification is subject to change. -> Scripts that work directly with `.bow` files should therefore expect incompatibilities with new releases of VirtualBow. - -| Field | Type | Unit | Description -|:-----------------------------------------------------------------------------------|:-----------|:-----------|:-------------------------------------------| -| version | String | -- | VirtualBow version number | -| comment | String | -- | User comments | -| settings { | | | | -|      n_limb_elements | Integer | -- | Number of limb elements | -|      n_string_elements | Integer | -- | Number of string elements | -|      n_draw_steps | Integer | -- | Number of draw steps | -|      arrow_clamp_force | Double | -- | Arrow clamp force | -|      time_span_factor | Double | -- | Time span factor | -|      time_step_factor | Double | -- | Time step factor | -|      sampling_rate | Double | -- | Sampling rate | -| } | | | | -| dimensions { | | | | -|      brace_height | Double | m | Brace height | -|      draw_length | Double | m | Draw length | -|      handle_length | Double | m | Handle length | -|      handle_setback | Double | m | Handle setback | -|      handle_angle | Double | m | Handle angle | -| } | | | | -| materials [ | | | | -|      { | | | | -|           name | String | | Name | -|           color | String | | Color | -|           rho | Double | kg/m³ | Density | -|           E | Double | Pa | Elastic modulus | -|      } | | | | -|      { | | | | -|           ... | | | | -|      } | | | | -| ] | | | | -| layers [ | | | | -|      { | | | | -|           name | String | | Name | -|           material | Integer | | Material index | -|           height | Double[][] | -- , m | Table of relative length and height | -|      } | | | | -|      { | | | | -|           ... | | | | -|      } | | | | -| ] | | | | -| profile [ | | | | -|      { | | | | -|           type: "line" | String | | Line segment | -|           parameters { | | | | -|                length | Double | m | Length | -|           } | | | | -|      } | | | | -|      { | | | | -|           type: "arc" | String | | Arc segment | -|           parameters { | | | | -|                length | Double | m | Length | -|                radius | Double | m | Radius | -|           } | | | | -|      } | | | | -|      { | | | | -|           type: "spiral" | String | | Spiral segment | -|           parameters { | | | | -|                length | Double | m | Length | -|                r_start | Double | m | Start radius | -|                r_end | Double | m | End radius | -|           } | | | | -|      } | | | | -|      { | | | | -|           type: "spline" | String | | Spline segment | -|           parameters { | | | | -|                points | Double[][] | m , m | List of (x, y) points | -|           } | | | | -|      } | | | | -|      { | | | | -|           ... | | | | -|      } | | | | -| ] | | | | -| width | Double[][] | -- , m | Table of relative length and width | -| string { | | | | -|      strand_stiffness | Double | N | Stiffness of the string material | -|      strand_density | Double | kg/m | Density of the string material | -|      n_strands | Integer | -- | Number of strands | -| } | | | | -| masses { | | | | -|      arrow | Double | kg | Mass of the arrow | -|      string_center | Double | kg | Additional mass at string center | -|      string_tip | Double | kg | Additional mass at string tips | -|      limb_tip | Double | kg | Additional mass at limb tips | -| } | | | | -| damping { | | | | -|      damping_ratio_limbs | Double | -- | Damping ratio of the limbs | -|      damping_ratio_string | Double | -- | Damping ratio of the string | -| } | | | | diff --git a/docs/user-manual/source/appendix-result-files.md b/docs/user-manual/source/appendix-result-files.md deleted file mode 100644 index 86a45b5c..00000000 --- a/docs/user-manual/source/appendix-result-files.md +++ /dev/null @@ -1,117 +0,0 @@ -# Result Files - -> **Note:** The following specification is subject to change. -> Scripts that work directly with `.res` files should therefore expect incompatibilities with new releases of VirtualBow. - -> **Note:** For space efficiency reasons, the stress values for each layer aren't stored directly in the result files. -> Instead, each layer has two constant matrices \\(H_{e\mathrm{\ (back/belly)}}\\) that relate the longitudinal strains \\(\varepsilon\\) to the resulting stresses at the back or belly side of the layer as well as two matrices \\(H_{k\mathrm{\ (back/belly)}}\\) that do the same for the bending curvature \\(\kappa\\). -> The total stress is the sum of the stresses due to longitudinal strain and bending curvature and can be calculated as -> \\[\sigma_\mathrm{back} = H_{e,\mathrm{\ back}} \cdot \varepsilon + H_{k,\mathrm{\ back}} \cdot \kappa\\] -> \\[\sigma_\mathrm{belly} = H_{e,\mathrm{\ belly}} \cdot \varepsilon + H_{k,\mathrm{\ belly}} \cdot \kappa\\] -> where the dot (\\(\cdot\\)) represents a matrix-vector multiplication. -> The result is a vector of stresses corresponding to the nodes of the layer. - -**P:** Number of limb nodes - -**Q:** Number of string nodes - -**R:** Number of layer nodes - -| Field | Type | Unit | Description | -|:-------------------------------------------------------------------------------------------------------------|:-------------|:--------|:--------------------------------------------------------------| -| setup { | | | | -|      string_length | Double | m | Length of the string | -|      string_mass | Double | kg | Mass of the string, including additional masses | -|      limb_mass | Double | kg | Mass of the limb, including additional masses | -|      limb_properties { | | | | -|           length | Double[P] | m | Arc lengths of the limb nodes (unbraced) | -|           angle | Double[P] | rad | Rotation angles of the limb nodes (unbraced) | -|           x_pos | Double[P] | m | X coordinates of the limb nodes (unbraced) | -|           y_pos | Double[P] | m | Y coordinates of the limb nodes (unbraced) | -|           width | Double[P] | m | Cross section width | -|           height | Double[P] | m | Cross section height (all layers) | -|           rhoA | Double[P] | kg/m | Linear density of the sections | -|           Cee | Double[P] | N | Longitudinal stiffness of the sections | -|           Ckk | Double[P] | Nm² | Bending stiffness of the sections | -|           Cek | Double[P] | Nm | Coupling between bending and elongation | -|           layers [ | | | | -|                { | | | | -|                     length | Double[R] | m | Arc lengths of the layer nodes | -|                     He_back | Double[R][P] | N/m² | Stress evaluation matrix (back) | -|                     Hk_back | Double[R][P] | N/m | Stress evaluation matrix (back) | -|                     He_belly | Double[R][P] | N/m² | Stress evaluation matrix (belly) | -|                     Hk_belly | Double[R][P] | N/m | Stress evaluation matrix (belly) | -|                } | | | | -|                { | | | | -|                     ... | | | | -|                } | | | | -|           ] | | | | -|      } | | | | -| } | | | | -| statics { | | | | -|      final_draw_force | Double | N | Final draw force | -|      drawing_work | Double | J | Drawing work | -|      energy storage factor | Double | -- | Energy storage factor | -|      max_string_force_index | Integer | -- | Simulation state with maximum absolute string force | -|      max_grip_force_index | Integer | -- | Simulation state with maximum absolute grip force | -|      max_draw_force_index | Integer | -- | Simulation state with maximum absolute draw force | -|      min_stress_value | Double[] | Pa | Minimum stress for each layer | -|      min_stress_index | Integer[][] | -- | Simulation state and layer node for each minimum stress value | -|      max_stress_value | Double[] | Pa | Maximum stress for each layer | -|      max_stress_index | Integer[][] | -- | Simulation state and layer node for each maximum stress value | -|      states { | | | | -|           ... | | | Sequence of bow states (see table below) | -|      } | | | | -| } | | | | -| dynamics { | | | | -|      final_pos_arrow | Double | m | Position of the arrow at departure | -|      final_vel_arrow | Double | m/s | Velocity of the arrow at departure | -|      final_e_kin_arrow | Double | J | Kinetic energy of the arrow at departure | -|      final_e_pot_limbs | Double | J | Potential energy of the limbs at arrow departure | -|      final_e_kin_limbs | Double | J | Kinetic energy of the limbs at arrow departure | -|      final_e_pot_string | Double | J | Potential energy of the string at arrow departure | -|      final_e_kin_string | Double | J | Kinetic energy of the string at arrow departure | -|      efficiency | Double | -- | Degree of efficiency | -|      max_string_force_index | Integer | -- | Simulation state with maximum absolute string force | -|      max_grip_force_index | Integer | -- | Simulation state with maximum absolute grip force | -|      arrow_departure_index | Integer | -- | Simulation state at which the arrow departs with the string | -|      min_stress_value | Double[] | Pa | Minimum stress for each layer | -|      min_stress_index | Integer[][] | -- | Simulation state and layer node for each stress value | -|      max_stress_value | Double[] | Pa | Maximum stress for each layer | -|      max_stress_index | Integer[][] | -- | Simulation state and layer node for each stress value | -|      states { | | | | -|           ... | | | Sequence of bow states (see table below) | -|      } | | | | -| } | | | | - -**N:** Number of simulation steps - -**P:** Number of limb nodes - -**Q:** Number of string nodes - -| Field | Type | Unit | Description | -|:---------------------------------------|:-------------|:--------|:--------------------------------------| -| states { | | | | -|      time | Double[N] | s | Time | -|      draw_length | Double[N] | m | Draw length | -|      draw_force | Double[N] | N | Draw force | -|      string_force | Double[N] | N | String force (total) | -|      strand_force | Double[N] | N | String force (strand) | -|      grip_force | Double[N] | N | Grip force | -|      pos_arrow | Double[N] | m | Arrow position | -|      vel_arrow | Double[N] | m/s | Arrow velocity | -|      acc_arrow | Double[N] | m/s² | Arrow acceleration | -|      x_pos_limb | Double[N][P] | m | X coordinates of the limb nodes | -|      y_pos_limb | Double[N][P] | m | Y coordinates of the limb nodes | -|      angle_limb | Double[N][P] | rad | Rotation angles of the limb nodes | -|      epsilon | Double[N][P] | -- | Longitudinal strain at the limb nodes | -|      kappa | Double[N][P] | m | Bending curvature at the limb nodes | -|      x_pos_string | Double[N][Q] | m | X coordinates of the string nodes | -|      y_pos_string | Double[N][Q] | m | Y coordinates of the string nodes | -|      e_pot_limbs | Double[N] | J | Potential energy of the limbs | -|      e_kin_limbs | Double[N] | J | Kinetic energy of the limbs | -|      e_pot_string | Double[N] | J | Potential energy of the string | -|      e_kin_string | Double[N] | J | Kinetic energy of the string | -|      e_kin_arrow | Double[N] | J | Kinetic energy of the arrow | -| } | | | | \ No newline at end of file diff --git a/docs/user-manual/source/appendix-tips-and-tricks.md b/docs/user-manual/source/appendix-tips-and-tricks.md index 25074499..3b57cb18 100644 --- a/docs/user-manual/source/appendix-tips-and-tricks.md +++ b/docs/user-manual/source/appendix-tips-and-tricks.md @@ -8,7 +8,9 @@ Manually converting between units is tedious and error-prone. That's why all inputs and outputs in VirtualBow have a configurable unit that can be changed under *Options* - *Units*.
- + + +
Figure: Unit selection dialog
@@ -28,7 +30,9 @@ Any plot can be given a background image. After selecting *Background image...* in the plot's context menu, you can load an image and adjust its position and orientation.
- + + +
Figure: Background image dialog
@@ -58,7 +62,9 @@ The profile plot, for example, has options to show or hide nodes or visualize th Number input fields may seem simple, but there are a few details worth knowing to use them more effectively.
- + + +
Figure: Number input field
@@ -86,6 +92,8 @@ Content in tables can be copied, cut, pasted and deleted using either the contex Copy and paste also works between VirtualBow and other applications, for example spreadsheet software like Excel or LibreOffice Calc.
- + + +
Figure: Table context menu
diff --git a/docs/user-manual/source/images/icons/model-damping.png b/docs/user-manual/source/images/icons/model-damping.png new file mode 100644 index 0000000000000000000000000000000000000000..7cdf2dec1aa19872d71dddc0fc6a4a9c76fd9862 GIT binary patch literal 749 zcmV;wH6%3o*2zF*tMF+?H{gSe3f-Y|gpo-1|QFy#oXPI1)?6 z=;&y=v$J!uySsZwrBaz%D}Y%l78e)S0f&K0*=%;xngcw~TLA6?=|-b*cFh3*#+X~S z%&iqbqKlrMo|NM_RX`laaq{{6x9B{R$@CdxuBz&XTCH}mR4Ub01N`KmTrM|&86Z7B zKYt)P%jI$j5xE15h{*Ylj*jcUiKc*5D)kXiU>RVH>9u7kvh|^zof;k$d;vD}_xHEi=jyYrW+F~++wx2h1jnq_gJQ9`7}Z+=urUXa zPN%!9*b0E}`_F*)z#ibToj;BXwE}#yc}p&rOQ>ou@I45E=o6`kT(k8qpsuQUV$l?! zs_&K#Rw|X9BGL}LjobHqe*zc>Ua9KYLZR?Eu9a*CFvgTs6;<7zNF>s#3h=bqT?&Q5 z7%ub%T0&F^s90RK!l?+Gl}rEYu6J0i=d*S!fhD53buDZpB9-5S5-iU zK#y9Mejba(#vh4b!-frorfIw`A_rCV3A^2{H8s_;cW)5WH0kI#L1$-|&d$z?h)k;L z7k0b#QBTj+!6gYi9?vr(yd}cRs+yIZovpRCJEXZe$f{LOW+aY|j&bs2g!c9hotT&q z5lMocRJDEB*VlJ7gP^LaqAHb=_kdbJ3JMCep`l*t>%HXUX06S%eRId;6nOS-G)Wl^THc>(>(uHnDBn77W8!5_qv$mc@k&7inz`apT5sX?M2` zNG=SrtmJ(WAI(%1%SvKdsRcfg^DR=9w^eBXj1?CchMo-h) z+NQT}-xfec_+ErhdVBl3GDNPdtk|k5M@8gWRmJIaQdjpP!C-)bf>jy7BO{|kBAtZ8 z-!M5jiHM-e@2b|pD_4GursL8Tl&4a*gP_fTk(-;VrKP2E^X5&)$H%eT?QGs$MRW7q zn4UNh;mnz{%+Ah|ot@3Pb?X=y_*2KmMg>R#r&B2o_xJZ-mQ9;H5zt)#B_$;U0ztNK z-+^hG#N%LFK^Bg<&6$1kUbFd5dU}3PwkMaz#Z&nPJ%8OrHpc!>J|3#WFZJ$kg-{ zrfE`LUBkY8`!P+E_VzGcU8k6tnZe<3P+VNX(9obxO-(&;GNiI{<8f7*0SXHXwaFKd zopoNEPA3x+6GS>s(%#X|$jDu6HX8t`REm`=^YJzMsNc04m&-*w9;YjMig0@y!+#9} zD9~b8Wo^2g)kRN9adF9f-(4;j`(D~lpee|??(YbhkjSYL)vHeAsEnBvv$jM}qo=ZI(Z~2;EZ~T&W|D-A( zXJuuzWQe@@WaQ=L>F)Xl@iqE!yWJVU)6>&LzwM$W)S`FpJa{59L|$wjk7uoj9uSe& zRMp{dICN*7R|5VZrfDZ~DneU0lomCiO2{x$hc8`<{k$0KzrM@@!;k|a@`kGB8HS+% zmSu^EjH&8pmZhJ@VzIyf4dbCc{j##M!5kK`^ok+73SkNq(=; z0x+q{BXF;PCw~M`)ldXPSU2X!%GOr>q|*<>@UAiP26Ps*?8`AeLqzsc5DTqV;mBGW zwLNR?k}>S3;h@UF5CHQ`mG?jcC>o=ym!5kH z;Bospioy!;0hsQt?b!p7tG{lavUdI0fDQ*JsMp1hrXUxlDQxABJHUC&AI<63@()s{ zwwzltN3L+9vQ>t#+*!Jc+liu1X>d$23_Y4hB9{(Cew+xL!hQNfU>a((|Jr*0`@Hvh zKhJx6;D7z6C8boQe5jXFPJ5n5`IlhrrAxJ+6c&DIx^?T8-}LFz>F(~h5EK;ho)Dt# zNw0W0uqUpfqH?dzR$-{Ft`Snoky&_nIEN1x{TLV+wDhGf=<2#>u-Q(1mY27FR%7Gu z07OMav2x`~bUGbHMMYSxR?5q*OQe*cLWtIX43JX#+`irNetEeq-)vr^ZEbBu2!UR& z$7nR7)9FUMCX)%P)ym`Wfk@!R0S_K@&EC0lM@?nrS;g!1;^X7P!i5VlnM_1RMvn4d zzkVHnNs}f?P?}#@k(4r|sOZ3j)2GiUs;Z(W3OzkND2g%)-rU?wX=y1on+<<|f9B4e zeNqVV=krGiMGrZ{EaewNg`4Lv3v> z01**WS+F3jJ~MOap2o(;uGCi zLseDmb~^xtg@pjb$Il`m?*4gjK6@Nl8fo zBwM#`!|80o>-7>45WtERD_FjKITI&Ne5!%L!9hG84*>xIfTl}%oci$f&6_{^`ts#E zq0wjnaJ$_^MNLChRkE{laJ$_jkf~FrvT@@^hP}gTXlS6gxR{QP4zjYA4ua-84M0^@ zbwPD?wMa-v;MA#86ciL7rKGH^jFOTP+-^5HIXPG?7Lt>bX=rHR%$YMIl~h$#v0=jo z)~#EI-EJo~Hb&;==B^b&I23?8ckV<3q^GCj@9&RZuO~D#6e+zp91Z}?W;3d)Vl*15 zs;c7JwQCFv3{YBHN>fu40C90~-qh527Z)vhXMIpmkOPMPVEp*;?ZB&bb#-KBX5wjT=t1S}pDE?ez8a;p^+m_U+r`jvXJ1v17*)8ykz=ZpZ8Oq9_XK>1lli zgJHj3pSVj1;pQ0~DE244go)?ac@4UJY41)Kl?002ovPDHLkV1o6Of*Ak+ literal 0 HcmV?d00001 diff --git a/docs/user-manual/source/images/icons/model-profile.png b/docs/user-manual/source/images/icons/model-profile.png new file mode 100644 index 0000000000000000000000000000000000000000..1d967eb453010f6068e5140ec586511276e931f4 GIT binary patch literal 464 zcmV;>0WbcEP)&JX#UQ!weBEm~PDePC;rorx|NTGD`@9ek@b8hI29n8S*z>$0V{`!Msmb@% zs$54RkwPYu@tO{>EUPmVl4(_DRhbf@bT{0pjT{ma9t1B|rtT}+=T%5MGg%hBAHAzHFx+NOz^Fanx zbeg6T2<0000 literal 0 HcmV?d00001 diff --git a/docs/user-manual/source/images/icons/model-string.png b/docs/user-manual/source/images/icons/model-string.png new file mode 100644 index 0000000000000000000000000000000000000000..eb5a909bc3e7a2148bc71f657b0506cf765f0fa5 GIT binary patch literal 722 zcmV;@0xkWCP)Fx3U+#B-!1Ft9XgOsA53{JqezLdJ_@6h^PJm zUc8kCD^w6fp^MqRBue5%DqaK+Rw$GjZ8agu8xP&p5KY@n>%lp_H#6_^ogWYQ$3}xb zv~4@oZvV(CMWf90ITDFDj^nKEh=6IDhX8&A@WJ0+{sPcFDa-c(@W29wVI+xo0YKa* z_i(19EMN9TL{I@DzU#po0FOyo4gumYfH^PaqGcHq19gzk=Ogv{$`XJ$5l_y~S8n(* z+qOf^X5%>#Yyiv6X6rz;TKyiVgL-}WgjYR?XsSErI8Iv#bvZsh z2*UtY0dcBSk}n5=13e?Mtn?9PnkB+8GuDK_87T*c16@mAhl{5GV$4|6G@N$bva=mH z&^02ZC_{u8fNz?{CtbJVZWsQC8AfIzo6TA~4*sw0C$vA*f}p-pwEzGB07*qoM6N<$ Eg1LY@Z~y=R literal 0 HcmV?d00001 diff --git a/docs/user-manual/source/images/icons/model-width.png b/docs/user-manual/source/images/icons/model-width.png new file mode 100644 index 0000000000000000000000000000000000000000..152afb65308e310405e789af06ee40e95cb6b36e GIT binary patch literal 566 zcmV-60?GY}P)k+{=3pX8iwDDwPLOw7&GO{8g#kx8tMrK#4?R zMk0}bKkW5>ygN8J=>Khi0T~cXs7Zl+AeM*+1B=`3cJikI-_!KhLZMJthU}L2R+3Z# zR)IAjf2yxz#;#;FDX2A@&BJp8_V!v=Cl#!$tjraQ#k$rrRm&b$*RCZV0}!^BwF6v7PuD|3OLQiMtCF3a!<_cnHf(dt_&sb zE^0cCbCl)GRQ6g0kj z7{D*eJB8}N2bR5z7Vslp`|TfUEF&Hn3d&OySqZUsZpqtou5LtXvt0*!wgMZ%ukL)8 zvy*-0@it^cf++}{j3CNn!bIyP2P zNePc66df|4zKr<-Vb|g~d_qkv#cn;t_Cq;scbko+JA{}qf!zedd23=dTyXd4)2EB+ zsdguu<6L(0m&rTV7h9~?y#;#4S4VnQx?|Up62M@=q>Ij(a%|ZHU0d-$ly7!7H$wsg zF-1f~?xLeF?d?TOTZ=R_Oj~!xL`4}hzE~y~^-0#NbBT9 z9dBuNI~ZOa4(n|T*2j+JHzaot+-dHci+{85BK=O$Q>f@gecGsb*>JIu_{hkJ{XlxKAe+N97-~N9xc>F)4Ua7} zh@YMwlZq-WBt+-WVUhrmM>UDe@_5~l4Q$^>iTXpR4?XgOo zkoBXb*)*#-3^4%DjWs+k4Cuh-2iU5=Qj)5#Z|IrB=@7hv6*6F+mZS^Z`2KUdmqjP_ zQQ;ATG#N4_OJ~Z;qd9sY{j)YK;;-0dwDj~<%bwX&BWJrMh2>jr_?(C}Qs3=%(fS#r z+|0rS)~t=Ko16R6>V{MzRa@!J%E?C!Fid)jT*Iwrq4Ns?+QxK^utsHF6rP?Z`+9hn zJA8|qd{Fds4OrYAo7qa?EoDi*m>Nhqb(MUg0v$$WT^e1*OzivFOm#uvOOvJ;JuPE! zOn;{1-jHR*a<1_$^Ss0QVOWa@hqal>pI=2Z+@~N3>&poY@4D$+&S2qsG80;hTH(Ig zcMkGq(79$G84c&J#0=ZHYk^el4qxvvan%pr>v_j>!yo9rCpzde$$Gwjv6(BJs@9iQSQ{D?+7saH8F%N`^IT@(q=n}6lOwtQ7pXBN z!E8<1t21fimg6?+z^>x6E*1O9-7!BE?TEqgb~dI=P+XfhLY)&U4~1<7dkyyPXZa2l zI&Dt{%!^Z+w2B6Hi<-Q<*E!FEt zWTuuJ1iMJduIf>iUp$K6HGXv(?zGMR)l)yUCFG0OBA;))6SszocU)Q-%Hgzt*$WEK zhR!JR4?+*Sjx)UB(&sFCX_$aKu)MQW?-BdLyQ?=yWd$0on0}fxxogO}QeGV?xdl&Q z*(Hiq?*+$nn3v^%09NQW>q+XY9M|C|;{Ga4W&PO(8KHn|ig4rqMqnU1j9mp5wmp27 zt7vCyr=5ag^{`11`Q>quw?ed?L3W+zQe}kjRD#LP;7YXCjhRWP7?j8OX`KJf!NPRL z;{~D5RUYRirQ3_XL&9xi4I1{NXsjxGzwZ3#cME`fXPjNmf399BH0$LoIviN))IDw9 z;WFj*?Vst;#~dS7@S#|rWlmUt-*mFh?k=}Tu}pEqA0CY`3C$v4oA)?rYiBj_i`UY| zx5LQ0GfsKCXh&nE2uL2X6Hc9@rtVOMP1E|*>AynM+~J#bU^XGMqNGk;e4Q$SM60hzVu7Q==-9bd&w!VHpCdT_y*gw)o>z#RxFqhYq@>4e18J?^Od32GR z&m{?KmNMl}Cn|S+md)3T|5!6z(2gGGZO{bBQ}SF-{fH=vHMEXgfzE@g3H5{Mgm+tK z=9$WDYIh&Q=`~;h3*l5hfT@oHbeyCyPWJqCe7r~E=LT*j3RVq$7%fw_97stwPspW& zQS!M&E0bwqu4SD3X}cBJRSku{q`EU}51ZD}q9D3$zgn2t4BY*)ZoK*{nLSGohh3Ei zo{e(}(lAVe<>8hJ`;yAVvrV!`r|^aC#=K`0lUJ=po{C(aXWXeZ6?EpM`659XCMsQ@z?6H;lZtI8}D`Vw{Ja^GNbt-C6H|}7; z@ALbNSd&-UfI9e`p2~mwVbW@Shv{6?+K?)1@^eR21a8??$wSE92P<}+ao&E>St6^C zBj7u$r?ONWS3|hlqSh_r%=n=Nbmv)K)@+z}m+VSQj?NscKTNZt_!5%$_OxKEWRp`5 zBn^F(w|=%^s`-6wi7Q-l?mfk07X-WE;q}r<mhsgvRnIchouy1^0W z%yk$~_~j*Pk#|LE+-cZy4a*Yw&5j}^@>1gQLBdPK7#+AIJxJd09;!L1pY6?uc+Wth z-Qn@H&BDbePn5p$$EVC93^%l!wr$&3Y#xdDJmgItx)D#*y_fIW$yqBgyw@4-C9>(- zc-}5GfDC(u9kh$X|(zetp=99WTBP^c1MSOtgzOR*|mD#duof^#aeKIY1b9!Uk zsESDTpTkuO*URqu{SA@fZ`IYQUYN-kf>E4xx^(;d1Ue*MRYBGXuX)RwE=i*8c=dNk zoqZZqg{%nl=GsMX`VBXe-{q#2KbW(7YU4#V`XiCvm+6Yt&O1)FuGzHGbowc@ae6u; z5C6LHYYJaPk@^I@k_1sP(FV~x-eSGGMn&(uMZLx(5N_pUm4un-fJ@nYq6lYS3XOMf zbD>Zy$V)g{RT9z>l3Kt(XuNCCQPx%<@1qL!-ryIAYo4HV+JDr8-`CGod&97q8%F~` zq~^qqq>!YFT&A~TVN;2gY==zOc!8yK~1@!qKX=fvP@qR$BG^dh6iQtN)9#1X^K^Ct;=3b%HLLJ+jV(-J2`8 z1}wU~M_A~F)PRS?o!oO8(`2D6cqFury`~6#{XUIsgTy|ys4t6MJnczm96R{zutCku zzk{t_&v)ib1GI?4T6S6>dwDkPd1(vo;>~1XhKx0jnzrs)ca0Zt^F~z14MdY3z?yQP zGb3m>&6Wu~%%VMXr#@Lh^l;zAVX#}|W|`Fjx{#PR8Q2a!Y@3(X_J zLvzbChLHpskCCD|Q}qJdF0~ymcK427c~ zl0*n6=rrv9gTUZYK?}8S6|)zFE8fjc68vm z&FFnc=B#ifO*&Un*@|D(eH;j>zmXqo_w>VESV5R_1 z{dGMyzv13_#&7Hh$WKtWB=$-0$|hYE;U<~$Ze`&zlZTthFiA$f1h4Bi1(`fZKds8ZzPR$cXzkF%L_bWA|eSx!>71UxPWhe z?yG|Ju0OJG1n~7rG?|>%f3-}1e-{EclBLdD>Q8vA*SFvNp?!PHU|vEQXo#}3tc>4f zJ0W8^5_@H5C#hX>O8y-`KG8FJ58WP!<3X}! zzwAne4wdPeI$ZLV4_?hV=_yg&%^rcR2Le-NaHdzvR!RSWdrQP<>g(`jinjx@$gAe^ z;zF^0{|Xg^xy&(4vm<19ecVP4%u8@IG&DfDR7&t&+>+P%#$|S1@=Ol zd82CsD zN327_&FrCA_zSOITk@oPr$K76?4n26V>QgWSZ>b*1pj5MgviAbI=pt&;WKeea0iId^xTvIgbfw`^0aGPt~^poz#LG%%e> z&2w7|%l^3sjyld{HkG=I7Jq)9RTg~iC`(kONZ!7H@7;M*Pz?c@=qd?Uf3i#U4ol2K z*zb2^37JT7SgA0D%IDW579UH9kR3fcT6T5l&&Jch^GODM?s({A_(c5TMq+R8CZaC= z1EJ`lCOmj7jXh2J37UJ;kyCb6aKZ(nvcLu8y3x+f`*_cP;f86?;PFTPqo=c{)em+t zG!MJWYLbs$ep!p+qt{dKs-&z^b_>1!9$*Fa&eeYwcr5wF=S)#uTDMDBd0rCsfU#%G z7jywqKI|@>OkgXeXpC`Sw*N*bJyPQ2^?5p?(@4W zH;cRAF|BPIBdYCsb`P;f({?1pFk`eUo{U^LL133hyEd1pky5FyHUje(&m#;bzgnUo zeHUx8vr9y1Fsr`JwBx$_MWQ`flocVn-ZP_Pn(DkRS76dlaX0S_Ef4VxB%oq_cExul zU6Fp%rtD~id9?@QttD`Zeb@vdDn-; z8^Jz$GxaKoIe|_%@Mxuh;vToSdMl_Nu|c&hkf2n_`~kJdr{`prYPHf#gB^agwJ%y5 zvSC8E-!`oe+A;wFc5xnZ{-3Xbo3RO4ZZl~vwO2cTpL3S8@Ogl zy<|zdtc?_>*Tu31<5PX1`~XAZXO?)n@+@f}vaDb)P%Ndm`A!nN^OIN5S;2k0Ipm#b zpXc_L5($KZoiL|*zYwr;f=&qzg~TnU93CkPdvJ5>Ev=7W)gNyd<7HATWm>USK%8Nf zn7iM^!&D8f2OYN=17j-|`i(rdW)ptxKJhEM{CaAB)04rj0Yh(oHgR1R&8VNyk-an5 zEwCZ=2qLFdm6oU+wrI5w=ngxg^v}BNK(dA{J}#>963C>mvGVHARhxzquYPhKkW+{6 z!Kad(-jm_>r<&0#blYAv`db)xR=?zXa1&ZooMf(`eJ_kAEH1}dy7 zww#GpINL$7kS^uhcxd10eka^Ep{>2=NV8E8Vp%cc2s4QQ>$O=n@2VUzaaj?9J0naG zBYLJuxdabXqVZ1aJ84dQS6gO%GWw2lpemz{dmVQAUDESKM<*r){6lyzNSj|TA4imoj97v?%|a%ZRwczqV;P1W+A<+uz{jf|-#LCH7TEN-a>uis4_H>ti3&Q>yL zI_$edGF)j-RcIfqD^NDxy}x_41p&`Sx2-%^Kiv1Ov5WX?N~i|+ zzO4gJh6tt7&o1_ffkz#Ad;Qe5Ygb$=55UsGZS|I}hyDI6V~FnMAZF|-GzrJ8%p9mT z8C%_Qc!1)l!SYVKdOaV)B58#g1jWg47q!H&(<5vz(aX~`+if`;!XU8a|2#hAZ|1p_ zH!XlfGf&xWt7gSe8FfmCNnUKl6cp}@V0A)QsIEqx4WSGiF)622GVEs^cUx>rbix^= zr)`syk!+MU3wc^7uGe_BM$w5e-}Ou1=I5^3C1a%TwqCtA2n-#G<2)aCb+1y#5qUz6 zH@1=+X|hhZjF0qPZ6NL9D6!CyIz_*xP-)RXJchxJd`S zn%ybK#YneXU9G$M2H)PB=3em;aJgr=dnj>;>0|=-68f&eWvXg?hhO}n*zVl1bY@P{ zn$`)*#%-hQnZ}!NIl^UqdOuzD(}!jHyG>T^o)c~5DE)=Duc*mjr*HO3UVaI4UeydI z`(Am~@3Uj(6Xq5(DO&e%NO9C{BW$?ehAZ(|i|;|tl-k(!ki>k@!Rks&M)kQLv(abp zVXZDavoywWKDgIR`Pf&h=J18MJ0> zSz67A&zB*g$~b1woTmjm71l?8c-bzj%eiTCP3Y~Pw&3$ogMJ+5JLJr#=H*1k_;Qx_ z>+ChN$m1u9yC2OI+#9;xsbLzO_4~Ayvj%3HTi>^@*0}Y(Yy>nEe7|p`TbhoLeml9vCR&eR!$O9OXBRrzoMH7XtJbVuyfNg=Q-@d}O^@VWte{xaid?gu z6m5CdepPK|L}=FrUU!$8)jjr+q(Jtn6roqtAXY)^tMOgob_+&hR%s(=dGr>r+BAN% zD{sj-A7-ZL6TTj+CRqFlU3yUji@SCBbxT5acBJsSR;P$Ts7c;Umtcl|yICvI=W*~$ zZbZS2a38nwE#fBcb?~OdqgrD#^8cJ#5XtzgV)FszL#2j7@eMs+(X9!JO3@VpAk(pQ z_Y70D=+xQiKD4J$FF?oRuG9mPM>3l4_!>X(SCgFNVJ=Y-NoKcb5O}|*7mPrw^EJP& z{e0hhlg>DU=3c@42Mlf@W#LdPQeIc++?<0e_a|rc1#jOVr8de;)prlXoRRicLk}L_ z=xOn3=4d?NetickBHGECb-RH1qn}y>jLBowA{k3?| zdoN~QXB;C~E$&oT6yk?egSP(#l5ob9?FwcHA8ZI9^T2pZLmd;eKB0Tsf3KEGr}?yx zc~uaB=dwNIe(88ASGYld@SJyqc#Ldi(gHPhYV4|Gej`03l_w1Dkvnf(Bl+ph~#Ze)7SsIT^)nzSn>Jnzkbr^&e2MB@Qlcc_Mwj8&cH0KUKFn!2+0w{c)U6# zwD~#SZKIvu>tKc1OC=ApDy%xK5w~|3^IQHS$bFMz6CRPo!w0;|*6rM`!u`U+=|5u# zUMh%iZ9B6T9oIrKbbO5tbxa;7E_cFNU0)1yv9Udvtz-&E_0if&;NB%9$%hUs3E>MV zk|=1zA9T8p(bd)lbYPASx^K6Up9m-m_6{vDFPk@RO1;6x~@pMU6hI%M*E`ya?yzfT{56@#OaOG_o=q zd2+N`jd^bl+ocjH7e^dK>Uo*hgyy`@^F=G5H#RC|sJpN+Sak9ewZXi=dt%-C{0>{8gi(qrXep zStjelWKB)kq+MvERXf23`+xK>OA;)EKeE7rLLf}kS7~wA++p?1)~MC#LVV3)ycn8Fuo?t1`EghTWZO9`?S%Y{CKw@Jw}`75r?7fLW!Nr#lc5|#-{s>KDF#-yf$8^_ zI3Kl4!tQNs@cdLwO%-_NACP!2!aMC|Zt@H|K+%bt_Vpfh@7rQlkJNiOIG->+op~)k zXzeS5d^LQnWc!R8M{dXGp$9InYg&u{o)4|>oR7f#$oU=HthzV28^50U+xcpBS3-8P z#3Dy0dtyZoL6(XhRS_7?SGtpTQ2G-TvavluSIAywv)L$xalfBhS5RqwAtCZ*e0vn7 zfkoFSZ{!Hpy@=)vpp2z@jh~a|HjI>u-8E-!X4%S&f82b0L?(1F?0Q*eOOHhCnU5Z( zomr?|@bgp}SInT0#X)rs4{ao|g|muRqwUIWAkoo*9a2kfD7YSAn@`MM=erv1dwepM zat|Rcpbs^4+*X;z%SCGB3c}431xS7|d5_aWScJ03;-s^utfI2nO{L;Qwk+%0JG5)U$d+*v%O8T(TUtpPx+@C>Fnr z?%zJ_aCE>U6t%d)dY9V0tvcScboW@Ag-!Ej4z?p?99ltwzVnWylb+2#5*C_eYvL*<4eh^ z`n;-9^dm&bXF1l0*Abp4s$$c9cfO%!alPi(Zte9u!A->?kpa}8+BNNT4rZsOLQvH%9iUiPEp*IwPsy>TNl^?H%Iy1hk*Qi!oj{Ra7y%M`L}=}>@}Zj z*1D)sS;3f=V6cb<(d4mJYwpm3p^ud7g-fX~tWv9B1@hri*U^zlGxYjdjE6PZaJ@TA zXw!9wn(Rx{%pdm0E7OQAu|SbIejZoF%4gsu73b(!r7%6T$hl9-fKWZE{E z^l@w5>GzXVyEDTz4wvWIk*W28C$spmSG?*~IC|+5Y*v@b){4Rkn+OS>EFzmlF{Dmm z_Dm~&V(dtO2*n_en}Q@b>qMAl!`YFCRY*8CjgYs*bCPZu?%N+-bmKpH0>ny5qp_}u&=8Z>uR6pR$#47P**GB{ua>#{6W9#iJ zPi(uvSy`zOsG1fV-$xRFrtip>vUo-e_aOS)I>T|(+kZUG#|UZOma5u%p? zSJH>}_(7TH%rrGQ!|wH{q`h$+k$PDDDV)*X7G3O~fp6+oQS`kJr7R7N=CpWh*pFo~ z8aZR(f!<lLxm}2Yp`S@JfKaY++!umN4v*JPF`O>Dh=Vc)zr&8=K1wILK%&G z)6;=dwf1yJbac@c2hB|$XoX&9HoJCkjN`RNqu?)Bi(r+U#YG3E@g6mFx_W?lv?o{7o zkv$gNprM4g-pvc762mqA=^oBP`Mm*S__|DEn&18@dv+~TwR3%Fwt9WvF}>|-hRJy~ z^6rE2+Oh`TH}5UFD$yG#eLtp{-1I?c8lOTe&oFt@tt6)P{JjK(Tc);i6fTz4q{#U~ z#_7LIv`HOV4shC?IAl`vKXM@C3@O~)Cl_s+SlxyM==RC)t+BcH5~bcWiIa08-!_bX z`r^${e+&uKCF9s02k{>alM4Axc1`(ZUPjmYrCOE#b8!$s5+b2Bh96E~~v_;^#*FnDsYS z_w95&iHE{_%tzW~h4|t3cDa*Ak79Xi3L51fmqcVE<3@_yZ-bo6Za;zv>1RIUQ~3;j z?u%#5c7Szi7Od{3J&i{xo9_Ri2w@36WjWuH#?E$dUG(WU=ai3Q`fkwVg9q))0$pF8 z0~JKW8+%~0>X^fs^)C)gK;lmHLx5{=Tbw#klU1uw8QYb=hq4f7JWW0q@bkYxje4SySroajDk0Lob#)atS zO^sg%EpMSJ_)3>2sNxIPq^D1qAMLk>lInKfrUVGs9}R=2oDO`uF|jJ0k@NM zH-RLQNr~n$>ZGAH4|0rJZKHwFZ9wglKm_| z9SONJo**7b3dQRz99&%5XU|%ujo#(v#!ZH2{z>9o9givx;)wy)b0umxTRF|KLa->6 zU(LqlDFKbeWMN8~_=De@iNxXZy}op;D)5*iz4fwh$9;u=q-@^)BV+fj|MxYwGv-a}-?ril)g#3q60n}}b6HfgT6#huE&SeL9xJ=CpjSiWZB4eUnHTH+A zdAiv7>Qjvr>iI9Woy&~T$wl?cWARaNpS;o~Z|`jFj*KPE_*Xttg?8Gy*tMwPeRRUT zzWCWt-o!-OSt&_k5?kzR+vKie0uk{-Zr%PsLX0jPJ zqi9!HN=8r$%ax}HxpQPlN6-lhLRj=_i9DG&ISENgNlQyhmGCXMcX#z)7Tt2{?O=gM z(iA(I9V`#*&e6`EpHGMKpbOhBFMo5{DI>LIk^IcMrjQ~Ko1Ny9q+Xzn%I38GhE6f* zoh3U6NK*DE^G5?pCeCepf2r**2FCL0>gs-iBm<;2FXZjNpIA&+iAk}g+LDb*aB#7W zPLIoYt{8*|v8*Uo1o@2HqKkUuAqZ?suOCQyT2Ge-R99DzZW$XJCvaJ)cMg->qw?7VPV~_Kz&041!1)e?I`-&zYi_rO<_pn3xib!e*R(?n**IJ z9_!*EKD8JKS^4|7Q?MU4I`5&6bSd7Q*t--ysZ9VMufJs?!2xQZvnK)F5ve`1E(w2A zq%S=0xhEVI73Fp`!26inlIZrl(b3gRyKfZ(FjTNZ(Rpl{wjIj6`15r@1_m*qIOWz_ zQ?qnDBuTuO`1tVlo%_VUYP#JoudW=NooNLHk;k<_^x(C)_ztmSq#9>yc?mjZ>VMJVo?nJ4hTA!3QOHx_|ST~ zl%Ct{D7!UqN)ArWL}5>t#M%3gIsAcyzHymWipBn73&2KfMy>uTRJ@4_Q`VKCIQqX? zOJaosRMrB71gm6epErjPe~ncuwYj=Lr1GGb$#=9*g$ha8mpJ>KAHhcfg$b@C&`Z=`so(hXe(&IR&w6>;dY+2lU?czxY}hc0r2&g zN9=w(vsI%xs`Ns_!jFYLjyDqXfdkj9cVpMm(tCx3T1JN(~E+vpTETsa9~f_Lo%8TKxuuObgseoO0LkDkN< zRm|9hF+57B{$>wemN;;sBjmC)Wt}OvvAU@;lmDqc!0$j7TLxC^Adh5tMJn;vQvcT2 z%v2Cumt7{2va#OS-~2XLd&_TC@)Z_nK0dKjN2{IFHGhh{0n^n@+iU)*!E*;4Ld=K_ zitFuuG0nqKT3n^5@a2l0ulmr0q)U}uIurZ9EL1~Asgl$R+dNiI!9OM@YUj0h=mG;V z84dwKER~(w>b9=h?S(%#ffeHY!=|W=A9B-V6x*xX_l?ar(9WV`%y>?hTWL&f(Q%B3 zT!--m{@&VOW*@V!w=}{^^%sop8LG<;!}Q>6oxM~}!XwWih=B9E>d0jPAmrRhoMZ>HPx>|Nf3UDE#->?kWYbu;N`f!h!B2K zF-dZEY>+D|(M#5UJlpZ*YTh`uP9;&3n&pWllKGuvqQbAAZvhd}uJE%QPbRE-hX*_u zu6`rjxj zv$uHKaG|kv9^efH3K88>8`I1NdsVhhMQbL1|93w9)F2ghc+BOcSE}1G7SM4Mo}EoU zB!Xn3kq&oq(WEABoz_ESHwxvsk%E-zZHGe=Yw;T_l6!zc~E5=8+tYWBY zpZ88hrN`yt#|}*T@UV*0R(|fTux@^SBsAA}@TF?D(&|Qb+7Gonb(H%Q0x`1DbUA<3 zY&l}}_WH##;&j!>%6!OEW`43nZ)e#zBW+KhaV|xrR zE!FMEBnxZ)#PULuuAU9od;8?hu!!Mm2cEDe6d6h>gw?eq>Tac_+W}Mr()MdLfI?_q zSfJ9-&;aVgl#BZM`=4`h9p}$Z4>F;J{)VYCHCjvvN*;6=pqXYo7gyFu?BL6Hn6-(N z&?!kV2OyCB{e6u3k8B`+)@3e+H58zTi?OiUuf1JDz-9Yhb8jr81+=;(nuajv(SK@M z7GiZq>sfWpYJkvcd5i7A%R35m@5g@b^8nKNe!N!%5!Rj6`kVihYW}Nv;}c|x#Qy&8 zERft{{zW$L0*uvSUta)mq2HLB##oaQo3R3*@)kxeF7`%fw6DMG=kMs~2ml;Ic3UVP zD3DrZ=|6SJyYiTrRJ3`M;<5;V1>dZpD7njrP>$f>&iN83ERx;~4p!01qCjWV~_Vl3z?$8nv~u18QfxO3B?*!>1n(xG;c~EmVKc4$muU6evP) zn)mXQD&WHVaPozP+@0(@KELaAVg+W<-b|X_(t)-5M|6pz*iH}EY*Ae-Y5d% zcSlJ=Vzp~ardIv2Iv1$0n*hggBOz2)nWEYf6i-xonT!&*8z z_#F%^Z@pLmas`rrM@B~<3pl+1DneaXY?GyKE#kj1on=SgKmaZowkP!YbHETAmJr#& z*DwHug{MFcD6FLEN%@Wcxf|dt$tWm1XJH9%3&gkjs~(u02moVtEIxT-02GT>txuV@ zW*s9UvH=`CGx_~}dnG8fqdTy}Y~P#fa=V4p16UUf=n0jNZ2Z)8d5EJ|>*TPqE4f1S zpWF2Lt?vL|hkaONZQuY#JIiCO>GcJoUeG*ScWBZGePPh?0)QBJ%)i~ok7$@2&YSOA zTU*IXBmS#VWh(Qwv}Eu`B7m}8mip6q&+N&eG|{x{D`fn8vWE|szg9~!M6(3_!$MX# z@sK^I1>AT*B+C>igtbd;QUn5Ev+eCu@o0A#MAvd(0l|i)ZCz*J02dm)q28x+c#JD3 z3JGi<`N3<&?}w>XR8$_Z8KM+uSENfvP}0sQr3xhirYkxnMK4|Bjk!4;&=YF1)EbaI z=?sV|W|=uIFqf9n zYCM-1mH5qIs(>?tvgj2T@T5D2>%YDOCN^ixcrctoFo7RT2Y6ph2UAOJfmm2rZ&9UL zs%P6tSjcqsn>gcqLTI&XA& zc0fz1Q*Hk&MbNeJC%o$a;!#`A*C%Qic*nZz%naAL?)BL+IOo*I!?5pFQFQ zTz8OikIVHnAph9cVIgUo)o6$pIB!ai^=Bx?CMH_I zT7X_=ptW_>=JN7VMp03C557BF#R{-K=xA*K3Mfjaotao5E|T}Vq?+0>xcfJB3FTo_ zpTcAkiLT-;w@{se(XrrdPF4-^(Na6|vyE+Rcaqte0xi$^`VC2moS zd)Cz4{Na-)9`i$Ul{Pw*Zi}cQm;2%m2?-MgU0DDY6W-zhdRE(&y}T|rx+?Nl<;`jq zPvvPTnXPK_%~o^c!pe2IK&%07<@u|nabZb$H z^0g4J!?Wpi-D#orZO?uvemdD&nly+%I$hYmM!sqC5yB;#!Qqc@-5M#4tMGDX)gT#d z4<@t$L{t>imgaL2>~nRY_F4v>4YV@frxHo-qV&A~!E?7J5C{~Q52fm@@rZxE|BQp9 zbjn&CgpG%1ez?*Db%TXviP&-^7EfD~lGgtQH(wz*TNA{HYFUMHQZuHwGn6Xq@9)33 zv*X=@tpBet1!cd7KCRfSFRqNl2D?9rJ2Z}2$Cw9_$Yb-Qrltm{-e2;A0TEunOhf^; zuD+)DJrFswns}w8^xKoO!M2$tnP(YKM|X4Qr?&-+iEID~c(>tHUn=a0WVTXD@A&mK zat~euPt5?(4r%?+{{lB6!qMZk&Rd!##vS}=G@P8b0jN^PRXJTfJ&Wm5T2Uax!EH5B zzgR87LVIwKMEvTD*k2&s-n>w|pxE1UX|Wv(tJsnlh#LMKk1&Cj+u}Ah#!{8>#Sa$T z>gRE6Din7>^sN^f8+2_>_ZEDIkxR$p-hbBufE^r+pw$kyLG5;vtO7Jo*5q`6wa)(mU<>2bS4L9J3;n9(DQPa_& zU~qW2%kl2*CL~y_&d-b8%K)G7*OvK-Wp~fZ`9bSSQcG-)+4fFAqV@G}WlDl28PL18 z*%dH+a4c6X6yVI|wKbQEl9o@Hf{v5aD*pe(se^_UGhO8`wX3yiMnn(;iBEXSNv&I3 z5o~VuHh^WIO6!f#TJidOjR0u7I$eMd3htTq#=H!Nh6N>m`X8?1OB%qab0rP80|bmw z{gwIJO_?iv_-$-(?M<2-!}Dh}iG-~WOh3O$c-yXCqVrB-i3{(8eqd)XSSJfTv*<#+ zPSQrGVC0^ker%d*RdS~Y(_Qk736~%aWmM|kr_TsYQ8?(GZ>HYSJ~O(PX$eZ#RPHW>-$F$lSz&f``o%9fbVR)gm5Q(EiU^p11{W?-<~Pb**xnA1A3OuUV&>iJ%s z%tO(EH*6RR#rM@-o?e`&8}v}vglXeCot5_0+( z^YvHxRis*ie|;;F3urvgOv%zRH`Q~OpIN*7XA2mJ4i2vmXEfA!qR<}%+*AE}J9AkV zaQ$_rszK0|6)q?MWS71`R!n=As*A6p|8b{5AiP-EMdb^H)D_3VR(SLJR!iNV1Dkq} zXyBQQ->o2j`Zn9wF^FUdIpaRcI zJSzu^jV7={z15(<7yj242jdNVasd5j+4<$M$974V6F_oi&Ei*8P{&a9BK@5KJ+z;n zSS1qt@>`#;RM_MW*r6yRb2VbV{stLJhVp85al9yLdD)nj zmUi5eiHS+U$jFF+f#GniP}tGY(P^h*l7Wv;v%%wJ1jr=Jth;PY6pR9|Iw2+}&j%vT2yBmP(_@hlU>nT0h{9^332 zpYZdk>ABuL5!UwD7qgh=u;{|e`6+WT*_3&6!D?}6ngbe&(^~llwK&0r^@nl;X`%)| z3}@^ED%v}3?Oeda=vi1W@V+=c0G7JjbmOC@u5Jl!`rtOhLEqg!x&btR>6^+Mg8ldVZcT3Sh< z>1|>pOa25gYi9+dm`*BpW-9V(U3PMNd*yZ(nhdV5ujOQA4=x^|qM-b$*JauG^?fE! z)@H^umNyWe7s>-riR))&`D2dE)xly^l;(lFu#mL0G=0wKI_N^CZu3FNGX=-Mr1`m6CzZ!OzhYP0?E_-n6R<}{b{vBSY zMaGqDw-vEVQfBp`Rc;GHW-S-Z@coV%n%9K(%Q`bOv2Lrm{xqfDY&KbMP~EZ`S?LU~ z{m|V}ktkie8yfkwTvq-0dDg{Fc#QyRo_WlGk)dHqLc%>jY;99bQ7ARF-XBh8W@i4c zUt2Euv`paMd#}y0Gcw+X88cKI#;@xe8iahC6C~e|(a~l35>v)5mLqJV=ThCZt*Iy* zD$n6D+uBKcuGtOPSiRJ=5ZLkUJGh6S@GMzD(&9I=6iOK96dEvHbK8Kaba9wWfP$ZWHr`yU8;~{5z z`&^J93a!(U_?erV=R@OVOPmUnV>(}7;Aq~`@$&LovcNl7w;3lSb7+$rUqbw_m9UXf zd!bc#i50hXzIBmx!9@{NO<;lFgOczBdjBYn%g7)3GR-xc=Y{iSRqkQa($g8#eFI{E z`s4E2aX~Bz6bEfE4kau+99MF;>jAn|&Q?QM)GG?scDQa! zT9H<*jl0j74qRl5yj@Pdk+hXro?U#tL$c#iPmLSaF_qOCysz=_*P3mw#-yviUj%@u zlgE$$NxwVqT-lLPG@KSE=I0ihg~2F8cDM?mmSZkVzp z7|yUilb$7LurXh{kncFHNXut`55^*OT@4caNJQt+Iy(+d(KN%}9wQddZIz~dn}gaK zXZxVsy+=funN`-`e`)vKA%dHaRkMr>^sA2TE`?WO*40EsePFdiBO+4utDd_$tcPIw z_>!Y8=YwBp*%~Zy;BubV$_gUNembN?@Yq3IMgQ!QM#E&t8a`cQ02opxfzq+ULx&Xi z_X-l5MnAXv98!GnqQ!5>_+O5O#YoQBI0?)Q{r&3+#8W`*38zP?s#-vh<#+k{;d{hY z;*C?fFK!Zox9vCAVPQ#peJUN(S61R=HWx`57uS7?di}Obc4yZ6&divFnxVG^U6?O2 z6XZ$R0_i$T4oFpSclrH(D1C-*WyP=qu*Ys-y^2S}>{|5E5;kvd@0LwRf{nnx?>VG9R5e_h z-!WzF4<_fwQ0NP=8Oex3^(Q2D4cm*SzD?&cBF~`v$IvcZxWLTB)b{6Pv3%EMV{&e8 zoQk4`Mx?x)&zx-Fo5~!mTJ*#r-BIE*Nnpe;Q(ZGKp-u~h^^vTa=A>`xTWpH0M19a| z%0unOqoUIj1@wBymGb-xUmjqJg1!b2^iMGf2xz|dSb7N&G9GG^xovo85swGjfM z?V})6LKAoF+D{hPRJCgi!$mF3<}(yL?(5tYo{Ax;?u0~j-=v`6>sQfBwg@i2w#H5~BJc#N`1OsA${wzP?^jMdhvV z#^@1zZ;lw$bX6gh42_DCjySS${4eWnzLwS1)je4;lo$YLs=_nChK^2GprP8cLGopr zvPU5xq+eFe>X0N8@iA2?*}OTL4?CR{)d>Y+NTE#k_jdhXy;`2igqyQOPdvcipmui6 zGw@SZY_}b7!egX;N=*h%oxhZrq+vutK=3IQ04(Dg+MW>YzhQ zfxkLm;G1xd(X*4L({r(hk4Lk>W)&}Ms4(IO&BC|`ih3?y2@C7mm<@T8@iA%sbyTcS zMpZI_&1l{~NNtO0@%gC>iVI%0w%PO8SvH%6?rYcW^iCe^y#HHF(*6F*%0f&Z7X7Ty zI_x$Fyk3s{>?3W-dZC7D?a_PUn_hFK0~?lrvsh&GomI+praV^KB#;AK0QCfMaq(%O zS2~sCg%W`&v{``j{Gm>Zjftlx(r8?#&?=84nBS{xY|YE7+tqT=H^5y|GA9;sgw{H& z4i!5~(z4OK3P3ow8UzU?L0Q85^Akesrw^ehSc`8xbzpXxtRzO9wyR*Eh#l~a% z*|Yv!MtZ|6Mw#LVo?C!QDrk9H$^LDB5a7}j&8Gx8*Q%fs2x+e0x}`uwLh}%C8@mf# zS67$Y#+YA$W#4T=LP9g>^pCt{P<=r+4@S*t+t)Efa+m~O^juMpY=;SGj=QTpJp*j) z?DF8dCVEoOl)i_z$%v40M$uGL6P+F<45DZng;etOy&OW0-)2q zM3~(cKqsODxB$CU&q6&^@!^9g2nsu44h#Ibp52dG9C6=(YUL>dJvBVGFhJZCtwIP}%t4whj*U|%^nhT^rVQ=4>50|+v zt*@&B-xFy>2b5PANEzVwjFORpuDKNKIv)MEagT{Ewt{^_RC?|fL`g<=osseRVWNzX zzud1~W?CBNi7`$tJ>QPK)LGNFIdx|@QP^{)C4YKE7yIK%ooj66>0s4g8OA^7NB(^# zt7hSKR#w^1pFcCRus}qQ$@kc_=WAK#N#;i&hWolT%mr**?nOMc%i{O@MY<*Si6Agp z?bftG%nq}zWo?}alw=~3GhMy^y0uGH7hkf%tH=M#zLij_((dcs?3ROxvf|?7Sx~_# z%%ARQiL~lS59cCI=KJ@nVsQZVQ$FxS+McUjTe}P1S+8H80uwiD{cr~-v~4uqp6E9E zn226d%#WlCHb5DLN`$F=E!<;cV{m3Ie)cad**CqrCALtuEEg}{j^J0wTmXqn7Y#W@ zc`d%uHQijAB;zL_*bqg9q59_r)l27k^WsqNI!uil5eb2qGt>@ z2stjN!<5XB$8yuwINg5AY-Xt(B{&R1+GAQ&iKz5(zbQ`wG+3igr0GMU{!ORiud`yOJ|Q0@`AJ8sdRjUT?7xtCN+NXE8iz zK;q5(vzTq`AypbcaQ3oM+;|Lirgo{ycy)k4GS6AW`L=%>L*yC6ec-C1s#MOcG%EL2yg+ojo8wIX-2ym!-&k(Krt|)xS>47{hjo{`Hb*qR2_s(qYgwLf|w~P|= zqw)^uU_vighjGs*+UU;S`7L z5b2qNI1D?N+aNgb8eBY7H*h>N6h2iL0)h-#bV0t2E*{`zu0^=ATJMI%;UkF<<8rHo z8j@^u(`(Ionv<)*y=8~VljdQ6s8YtP2g;d11!QaVDQUiO6IF}Bd+)sx;r$(lmfhiU zcWUh^NRrY3>RHf=<+cOmW|zr8ZOTeOWN7>6!0P-@F{HW+pZpN+Dl?D z`}su2Wz5&uTbBS=^B2X`R5KYuLRTnvcaF^pmVs^E6Dt-^4-gq#g-*42zW--;2V-QeT?P(fXnqo)E zBjhd>7gs@BSqE|V4g%{BuuOe4@hI=+HL2#9BLqK_BB?C6n^Jv2mD&FINV2!KjLdFs zb-5$HK28DbfHA(Ygdmg`2pc3d=<3eXc&JCt>Au#<22Ps8MoOC6TNZ$9uKxOsD6Di0 zvGf<>em5O`62KV0LY3kaffWHDBXP}IbM=UoD$>;ks&zN7y=h%aIvaA%FJ42i6CEv_ZHbRCFc)VTo1>h-?*)qstr2MT?Za&4fko2gDJ~& z;2^(4Ag)xzk^DnQKxSo4pFc=)LUohJt<4umQLS4UCl%=Ecy0ACGIX(<4;Bq!B>`h>Lz5pt zYvIFxE_gBnqoS;a%eJHBn$Lv~O?dCczk69B1l8-fU`@_7RNA9Udctfi?#m^BCV&_I zqR-&t`UxOF`4iX8ERJ`_$pb)+HgXvCLDzOpgQDI=-JwmKjGI>oFf0Pk|K1HP0>7%u zlJ+t4x%31+#^d&qeSIo-l#22<7bPs}>iBjoXh~8XaQ#oJwYyh-=+mC(Fpl)vL(uCJuww$*ctQ2kq@IHkHYr0DBPiV2@YM|NpU zsR8!=N~3>U=8uWCEt#9s$^B1~=C>eWaZHL8WKJtgu^Yjf4A3*!soQK&0KJRkioXye z6U*J50q0xB!fyvjrBT1tQ8@gs1qNAf}hFozm z8b#JIKqX>;yi`}!Mt7MN?L%G-vUm^A&B<^qgg~gZ3(^Hr{3Iz&CisZv^BQC}TEo9t zTgcLOZpmc2A-FsnAD>~LWYN>#o}|e$`!Hp0Zh_Oh(>81Wl&AwBwx7T~#tG{{gJ=Np)OzoSD zls~GsvmDBVL*ybj>Ql zL#221(-G3^LPFY5@Gda>N-*kK6WGOWAs3_XP?*bj^WjW;VqtcwW;X-@4jVb0IUsfj zd?@p0Zks@f4$2iBP`nTdI(<=44HDkdg`OZUpIBJP0yv-pWjL6c^^Ss7BLTePwtcOS zYA+;M6<|}Yt}1+a-j$A{qE)N$5-mFy@%`#XvOSsI_|$K*9%butoHD<>(LW4A0ZMz_ z0E!Rx{4ww!A`v5U#?Q}>g`GX?vqh0*-$#Y``_m))dqsencD?_o4OiB-4pbAgX zvB^dvOilX}!uI{0pnS78sEMP5lI3oaS0yN>husr_ze|qYx})pOYGfq2zhi=3n+q1+ zQ`>5?Xb8&D2uMrm>0m9GC-s8pDjuqr$1&@Y}Gqd0`nL`Mnf|XCJhs^pRa&Ce zjd`ck5P@xI5s?lHGx4JH_GV(LV>aP;e#?(GSL=_SK3c^}`|CXa6N$Q1P*c&&!ooU` zmGpqzI^VGFEURvX77Uz@hXe$9 z1zWd4ajydvBD0ke$Xhx~y&G7Ie!SJRUi_9#@IKf5q@MJIy`-;i_X%%#RP@@jGG4(d=xPYOd(?}C7A`aPcL9SxUezMd_0-dRD(IdyxZZaMrt%B2`h z5{Z=t!nKH2Km>4Tkv)`blt91MOjrde7L!(;O&kF6MKtB zOI@mWRMbHJ6UIxQm`w(yJv?>?une-c+3Q~SksG*4XhhO_ESjG%`{P}H`>)J~gWq0n z7tV)7X_gL?J$|gH6^*L>TBA8@XIH=goP$g#zoQ<-Y4biIZF19-0HywMUSYS1Zfc49 zIj>`)rMC8YQEn)W#$%^)C%47^QbdY_zJWl{0rC2|T44!x7a8SRPL*7EPLno;{s^z8cJ2u zSIRC2^(7ihM$t`iJ3vVHp`P})X^+iqOZx(|l3`)pmSG_w&l_HzGpStA38c%? z7IDH9mZhedS1fLAs^@9JsbmijnqsrKas~6K+EawL*oflx-{cSiHU4o;C>&^~EeA@b zH6Fbjw^t{WFiPaINX*T3vKxU&q+MT+sexSGW>&bT*UGg7)fyV6E^TJEo0yQWR+v;> zDw5S<)?|9(bcXhqFEi|8V+F6ay@m#|Z>GOKaoQ?ET*l!qVi+l0{A0%T`YM#8728z8 zQ}*gO9lP|@91199XJlq-&j{M9sOp}HtI=F#iiC{)4ZYj^7P_K=NjY5agD zhf04@_}#na3x3Z!hn?AzhqE+0pFQI&v+8M{fB(n9%8h&kFfaYKSLjLg=C<^qL#yFH zCNf+SJ$cH~16l{yxUbi047LywX};RFTX#U)%)aHG#~(R7x7XuixKAcJ`gd{dAE&`p z(U_W<*_VxUL9qx64~v);3WrSg z-Me=k^X`k^tLfI)vxKy2#oeLbeRA2--Sbd*!4 zx0q6-(qVsHY~ZH-L@kA@+9g}&U&!`fCRH8Ihfw8vd+U|6y8Bz-G!{XRme&IW$!K)=G5%bP``W~hpC z0eu4RBN@UdAB%xrAfD?EhmRZ~KY#wZWPMXpSDEYbipc)5$jQ^E!{{L?27+q}Lx><} zh_*4Wg)b#TOa;|jH?Y)#L8mX=z6XfP#AE0^Knm!H(ozLwJ1z$}JA~bQ zCr_TN0Ey(DX;@%2z-`r={W%X0ON;(FdS?|X1HIZL1&|JN7y9QJN#1uDLpAZsL2|CXhK$#&eHPtLz+r_20V&gk;RsfRX0wZ2> z-uoT-!T%K1yc^MR6xio2yp4A{&~@KxYGy$UnKvYMxVa92C_qQ|37z_&fXsItavsTe z_wGD;t{36R9~v1Y4pkkV*#z|)IVEK>baS{~Oou~^NDhE9W9H;k25K*-Vt>z_TH*v} zEUKuzT~TOzE)Sk<^5@;VcR|cxUUmGC8L-Gu`o%zxVOVHr0%#(;1)f~Fc1@y3$2|ka z|03Ls=hk#GcOZpTUtjKw6POL09y8F62~$%W$(<{M^R~4;vY+X_JFDw9n^Cj^KjCxobVBcW=(~3*(9PGE6#OwmKuLvRR)h*^T&ND9UIi2>4tJphrhWP< zVFH}Fdj{37k%Btn985uz=LT(gLM@1RKMjNF1m+OPSZA~EUtb1HQT;5;GwQMeH3c00 z)#={XA|`?CtlC&*4wGhBqDXo(&`)YWi5K^*K~y>qF1>u?`zsB=;9hXQ141+(4%kzW zBp_D^1h2O1WEebGCLHdbUXm?b8cvv$yu6KVSOWt-S z9x-uh=Om02(5FI4(A@I_x;*pr9YsA!MRu}H0L;!)fvf^oDgwL0qMF$W-Ifp@KZ5qv z0wJN{-niiGmp*^ZJtL!z*33102{Pd%C^J6<(adsR@4E@>LA&iyUj{f2q{Lm>&ZwGTib^#Fv<0<(p5 zo-4s@rE|CaX?nlQs6&YB&NXU)h|cKi>ziuPlj#PQGihI9d7kN^u9H(CjCM}b1uixu z0g8{cEiLlEDXv&@xct=H8zCHsi9|_4Wv(4W2dO;6E@Gfk5vCsx^}wE)YJL23Y_pP%9{QnbfKjXW$6&4xGSoFf)9KUkuKNT+PPw>34Z#laFlbJ_`K8n}kx)owY zBojS$nu^}9Dh}#9sbytaBz|I`HF6>){b^gGwY9LnX9E_|w9F>}7U#LvXW~S9n)e#= z0b-;=Adl%Whl(;7k*P8ia3*Ydk+MyT0cgCU2`&`cm1rSx2nhtp_Ii00?6bn%C;zP= zG1#djcH&b~*qXuP-`FU?F()_c&(egsYlsTphyjO-=d zd3vl*h;uYraHUnu4Lnj8F!o_#VW}9540vTHQsR_k;9DYj?LHzqNDDTD_%#s9WoTNL ze4CGp3pns$P#9v>Dt<^#PL7nWTwP1(nSM)#ZAOF<4cTAGa8vw!O~)h*0&KF@y)&Vg zc@{!gH=MQEH#rJZoS#AHg~-UX!8EZ@+ggQdbzop2C>C9)+^;~$66iz;IDhLdqKWd} z?eXptx-p6YkBNwI5TOd<22EVS56@ksYW)PtCqyfhpU){9aa)|2k_{SD;^!_>^rx^_ zY~1xDp;ZKBAucaZHA^QJN6D^p14<2ukOc^WG!=|m90Vn5iPwcQmg)s>3?K+*nsp?_ zpsSFb1~Ien`Ln+Q*+8y&7jpouz#3)%>h(Smd)l*jOgK_QU~h-D~}ZMi7J|2Hg#T;1zJs63;Tl^+}!t@tYnv&MI~ zLK48sqZfv?k?+ts&kZ3aBzO4va`yL=Dh9(w) z`??F7L&V1bd~<~DMI@Y3a&juLEQ~VmK0t*}QW2hehKxAyeg2$TP*BTzXPho-as+@+ zK3gd4$cLuu*RQw2kuLzH3xZDD+S(8Yh|o32k1_n{b~wiLl28ak4l1DH0vJe-7_ajX zIvmR49SNQw{|h=vOxyvgzm)~=ea#WC?F??K{sfTF{{TeRgG5~@NlS;sdhfXcqPWh% zp##bitmc1FLv6WC9@Soz(Af=6ZccXWyc`qD;hOv%R6CTLRCHjx~0wSZ5AFLRdAEY=|{Z1 z=bCyJo&)w2I(YI)Xm~%sTo0(=?>$)qE77=ySgp_fQ=p(sO-;pa&zB(Zd1YR1k&eVyn1g-9B}3!Xmf+H z6`r}3BRf+({x4sajEYqtG-HMGtyo(E^o!1({QCje_X|LiuRSO9U%CB%f0uVepToC>_||IfGjYPL== zH)YE^ck%GSHJK8EA<3_GOf}HdIq&x#{O$vKY0~fvN#3u&Ks=z{hm{q_Qa=LD3njiU zYguK)jPiuk%cvpEfTQ-8@s`YgT(h=AO0wl~RX>F3i_1jNZl4x+OZg-iL=fc%+#!aasf24*3}wD$N!W|kXDW_MESPu44| zs3qlod{g9W#LUjD>S~8qR6-f72f^V%eE*TeKwM+>d+1C&DJwzXiB6v9ncv*xe-DV7htZA^z?F(R(D|{l%tht-)V1&_~#pMpURzRFZ&GvjHZYmjaRqXvB4rA?X~%#^jB=y z+If8f*>*K++%R{K$#!z%p;KSIZ|ET#5j;?soR%+DLqgX950~Tj+9(b*qV343>fTzM z8}D{ovkRLDe;~_yx2|P6c{D|jP=ZLaXg={Nn!5AygF9#LoP2#;S+BU@sQ5AUS^dXL zq$}&gq^El=eU9}C9sN*8)r7aI7!Wy#gZ~M*+sRX;q3;Ne5STKC^7%Y| zw?=yIz-S_?Q26$osv70utcT*;uat``ABq$CD|=+CA>SOcA54myh;-JCEj(0v^zIA) zbEYzb;x8dz$Rf|DW#60S=KQPy%_iaR^Cq>=zimX!hcQ>6D3mV*mph@=buwwRfdnzh zGbL7hT3u|k4g5(@=!lhnD%~k>PqNjG^Y>;`k)4c?KRb8IiTR__vo8X^EP{O+SNO%% zzRB7be-U`j!pq^CDGoKbqnz?(*VlyA0+x!bk3sQ_ z_7$=|F2yr3SIF8J?w*OcO4i17_p`!hnwg^nrsS_#9iWMp%cPlx@aWM_caJa6PEd(> zl?{9EdwPPf3xRsaNH1aloA+}ne%S02N+ji_gN3+K)YO2&E4F>ULO#dZ+Ey-MVI%*R z$3);1Gi(g4BLDT<42r?pSGwXfiPDRw&!)a;K4X83dOO`J?{Xe;N?*=3X9SP9z%%n& zk-G(!ZTdO2^-n<^Ma7Q*A0gv&N4O6pdZTALC4pZ`YP^&FC7kx)Y}*ewa-q1G`5z|4 zM@XRQmtO?#*>>iU?WoyS_i@3=NEPEr$GpT|m!id@f8H3Y8#{UY1TWq~|F_RJI_OD( z9`^f?8>gqi966-q_!3~k1KnKGSHK)qFtT|?_j z>if@}Nlckn@Si_}S6^t&c-rq~>{JRtalhRFO6q#DY4HR;g1405;sy z%Q1+uR$0C8C;J_!J1MBCy+fK)!oquE1#Muo6-c1sbvzco-5+Tgv$f>{(QWHY7-blX zw`#@G?WNF4mXSQNIo5}=sBu4WzNaz%)3otFF1Gp4U&w$p?%s`UJ2~^m#Q1xN+;8!B zw|#+4is>+WL~%n+Z*JK;DFzxls&a(zw0*k`}k?1=sqP+AP&!8WE43e0JgmvdkZ`ZT@)b^mjV9RP;Mo zG{$JF`1}I&UpL&iWKYZi@o>C8nnMz%`~r#b0Vt`NIKPV^k_o7AhWD@!ne9X5Om8QZ!q-S z`DA!ikQvm?@{a*UEvjj_9x6QQ@u%jyTGf(_R7_j2kVI(dRaIAkB}@djz_O!ZOK?YQ z3!@<4pi=+WwU-6m+h5Z>E#0$%C|N1r7yRWJSPufb?m=wA$EV`mr=su$iLyHPW7DLlMUrLjg&$AHOjD*8@7cvxCGeiO6?x>h z+aS@qR55oDO1qk@By}Xq+pEi?=Vui3X{*S3*qfOxx4N1O%_ys7s9i{Ze;EKx+OTWP zVd25agH|Q=eUb6eR($nCZ_@!9Pz?#wv)!}Xoekx_W-gT5$4jdOSSWt4^Z9laS?Y6{F8?J)J4<7!WRF+ zZ3^FE?KG5QQ}Qz}qLTCL`rgKel!e?cB9$k}QtkbkSk08A`g-TcuBRXZiyb5)j-0Rk z%K@6oWm1LvuTgegyn?pp3vo?o6H7Q;bwnsJ09WW8{e(Yyvy6L!BIzF|&I$iVdBunH=uDgtiBVlpCqa z!+~XPiL%YzG~mv7db=xQDj#iEYvftYgz^9`f)Wy7f;>)(2qks()R~zX#_}ZaM@!2B zpkyxx{sgXD2fm>%RH-?yml%S%@vH%QR#07fxbyuNj)ASVf}ElwhfbzV!xiIU!|Dc z?s({*#$nv>olNAWPTYw&?$>3m;Bub-gVCD2-gSX~m(#L0+o69ADnJ5Rp3%H^cY#$Z zMOaU0$^5+R@_+3SgePzl5cK;meYBsnY)Vz_pRjI0p~b7ziyohOEJYKl=KiA7$K~7F zt1yliSD{0dpe#e(dmKtfAT>c+!CK6=f%zajc8uFq1lY;q%#tapfD0T+!{hECvw_}0 zD4YCnwFG%5kQ}Bs|2hS%FQfqpD`&yc35kC~M=io+=Vwg|cUn=Bkl|34zXcZ)p2DdzS_g&L1Bt`);hgwqeBl znqB#x2`EyTMB;gRX3bBG>&L9-WdxnS^<@n-MQ%!~ksVOUy+j~+?~Za$9qTM(=6j~1 zicz&<+qhX|h~(^Z;Lf{X;DX1^1dh_psVH!+M0BC_!0pT+@@FV_u0mIyIS^9J z?Ck4g{BIa#6+Jx4DA=@me{A#7kiZ!Pyo;P(cj>}h9;4ZxNmcd3p&5g;C26S`vurC{ z$86jnH=O;@o7eB$Du48vm+2NbVrj>?-7mijiViQc$?m~t|3K^(_@N2cIZ*0$Bh7%O zt(TBK7l4kjVj1u}`jiVC#=TrxpIF*EBK%J-|2beh5fW%ZXY+87W_QdqK1u=|l*Ve^ z4vjB<&Zlh7`AKSDw&0tCieCS(* z#GPyi2PK(2vY=lb_u=0Y?0T z$@*|rl$RI3+P@{=I4GBttxd@bE!!IC^6Mn4gkoIf=066_0o%9PSak6 zjFkH|k~3FK$Vf>o^+$QH4>`x4yCMSR0HjwaU+?o_P#YjL8O)O`9`&R_(vjVb4VMh{ zys0N6l%{omxnfP-r^^G;Wv5&Wa78ENNmRdFn*Ag7>z$WU=R-f#vIWyHP9FK)EoF3! zjJSJ$hT+4|p!^ny;}zIL)0#k9;Cjjt&TDXR(3r^~^69o=UG(t_2icu@LkTOS^Hovi zCIf~x_1(dZSKCu{1xT2ZoMplNYPVp{omy@8ZBcF+6rq;zXqI_XfLXc1c1dKD3N z1Yi%siI`fIpu374SN!5*Be>_)c@ib0sVxWC^0mty2IxtolmR+5+ZgzCLsOBL;ol4k zdJP&N`i3nbC&JF8r6bMfh>RaOfSiW4f4U7EB_aZm>AZQN=V7ZeU~9p30QS<_f`=qR z3ofS*$0?H6uuxf2(~w(+aX&pP$YK2vD^WLAbHZB2(B8U@JNWN}w@{s3)(aR{^Qz~k z-5{sswCKJu1Wg!N5chMrE*XNh6=l!w>Bis)3xydbPn3(rF}gbxrb(s4+rK57;=5(n z-b&8^H*ybmTu$Z`*j1MKno}Z7;g007iH-HzGDFf>H?T1@)CHwOVDxSR81!t2G}~gd z<9X4JUr~fUqo@iu-Jr6h{Z_smebp8%iaZBn52yD;@+Hs*29D4#d$X{t3(F z+^Fg?TbNR(K*ePqs^d1zfRu5O594y0Qxlhvm<0)3+eF>beyC?81I?ejh`X7 zK~QIrW)92as!{4Uw5nBvQ`4o)b;J6j+dU?;2O+4zQ#tifA4u+Szov4^6DSf@`e)6$ zuhj@a8;iC(z5olVNfac^VJxaMNYMv$1xNwNY~@E=#rbM8FfY+rMc0pteNlN9Ep~Zh z*^v57q-E~AF8p-3UZ{%+c~0-z43nAPe)#lLH0nOWLq^B+G|+@MKnuXy4{)hzsX2RF z5z*0@qG2~_C;`z}6Gjsq@M%?=B^kUradWbL^&0OdBkbN(vgqf8Lw@`t@nX_v#B@Uv9K>wxvugI0pDT@ z)om#mnUyJPA8u%9fD^>4WSuUR9-6lbugEQ{8|eEe^Z@z*e z>&~vlzWvr>4c%;R1KaY{e9Hv}5&{{#?0qIHv!L(Z59JMJE;+r|EQRD4xbb-vX?iPiz-Rs?5iD~s|Gd4f|gd8G$ zJUdW|3WjF@eAGgnWIg--cc5FYF|`AoKZt}qGNU#)AvBZ>k!Z{emzN@JC31~OpB6OS z!FB#EhfoG5j!Zr{=mCQ@h_c!jmHre?Yl#c-C!v^bb@s!k^NeWXN|@N0ZL-baP=`Ec zbghs2`uQaghxz)gq8*E_zlU8IePU>s024hw!Z4>}Ey#=sm>*TQ&22X1I;nTJ9nnISs94)eG1MpYDc#4P4osWcN1vIfx(%7%#BwHUhF67OB)cWzz7LtVXs}CdS;wk>gm8Y05#%dwSpH9r4cj{kf z_z!-37Rrc7Kmp~`;{EVtR(twX7-ENXfBVsSrGW567RC#hWj7(ca|l5PcP2CoQ0l)) zBkTFCq7jeuvKZI?ooeH9;W0Gph5UQVU#6y46|yYwVipDXAuIl^Dh0l$(NYz>>e|*b zA5ZM>AKhIL+Sja9+a(@atFxlwuzBr&_LZPG2{2Gxf1^lJ!(_$f$TEUg@DXx0PWMbD@;K*+8Ww7SZE$kV_x6e zuUxx-lTUO{=Uj9y>)kW!9&O!AN%iA2X4(5e7I2!nk zjZ@WCLU^Cb1oFN*M{@ki+z8!vae$`MJ?>Y;!!0!iLS?-cIXx0?J>Bv>SeS2P0`e0W zNIT;{Vw2aG9~Jf@^g{C5d+dZ=>fD>no|2qCtD~H!ZJP@>7Zl>nPS3?!o13;dKy?g88}+%6wbV$Sy4NyVEyf0ea5@{5#;BX ziXL4_cd*dnFsTb+P|nnf7#-E)wi#}OO|F6tTbrIuXvALzdh*PL3z8}-6a=xcu`Vty zYN*@?!5w}vT3-%HCKNulK6W2lT& zWD*AbUt*fAg1H@_5mg*aH|1g6-N%_DLnd<$PM-0G$a;MdyYAf{E5cSi!}w z=LFY!4G0Vk4YQ&2chP&t4*A!!?g4#_FgSf8(u@7d6$bV0mp9gSOIo^$`zT9;@@kr= zN~@>z!_N^g!_L8RszkAP|Q45`WZ>cf6#MvM% z`xqNp-6sQt=LWl7JIztVEhl3sls#Nwksp+hcU;eVbY)US#t?1&YUfru2o++Xg^>J5 zKZqyDSMlQYM?HJPtWAPq(9Ol0RefcB>p0=&82<1Ds-UHdM+=VIb6f8Xd|D)41ne|@ z|9@Ida1GT^4?zB@e3*qouv{23%0Ktn-JHH?@9j3s#WPISfr3O5N`bk!b)n30`#kHN zySvBDD8EOdl{m1B7j-m z9c(*3OFO+=I=#d&k@QE;nNGnJIB}`#L4EN$7jeqr z1;Q4nqK57_{fK;)U)fuhdR8OxUKaY-taOG~no)c}Y$t&FXuiz%L4@IIsIVQs^A-*4 z7lRd=$}GJD*)l#8`z7u1Nu2nD(m!S#Q^aazFL#=2zgnu8WKHYU_^(|X>TkSoQ;z^7 z2rF}aZ=kf_4xV37NV=K3)J%Ss*n{mq z;M-I0XCmCCNkcyNEXJ@#ob?#QF3zdPXclohAO(ITWrD#iu3*x9-g|;iiAaq>DFhY& z&X}SK#(rd&+?Y>%s)Xb=SHMu^JR`n`GjM@7cHwN4U%-dAcb++&LN}M0(LJ$|U8ZEF z08jz*0-G|Lq5+5^53)FR>by_YnBHW47&6fsyx|+r(cOgT0Sd+;^}CN#US3Vgag)+D z3w0I_dP+^oZ!)wq6Yc6S^)tewCv=@v-gZE5#t|bHLxN86G{E29u2t5*4xR&yI=<2W zWvJ$@;I0zZw}gMfFy*h{mm1-p3%65^Vc}u1g{9&_^LJkU`CN2va*hIJDGZ+hZo@28{Z_C&3u7*S zkv0Bf8Q`5pkU9V?wS~mnx9TH3ui*s?F^IMV1Hv>W8(xeGZA#SpeE3^ zuK<7L;_hCWcQjbBZidN|v9`IE5zJ9_+1Pu~YpEGGS<3jqj3AE3k3T3dPB~4x?xT6b zvH!kwtEp&yv_I%Irz|Gms}&x)0s7|#(6tS^x(6#t(>aCL^T&Rh*LBWw@3MB7Q z!xf*90OZQXX#;QC&{a0ZzJGE+2!FJQm~mz5;mojN_@7aCuj@*_BL6kpdvmb8QBqbG zp0N=HO3!T2slk|`L$ys!Mjc7A(BS9y>C>mX<<1@+g1`$L1&@CAOUGyU<4&#lzxkr&smZqlp@Eaz&>ZSKdCH zaY~a0OA};q(NN9S`gmhXr7`*6x87_Dndu2CvkN}(KobufU@q4&U&<8l*m1+#V08(= zO~^!XBU6vtL9GVt$OcYiKVkt3^8+0=e(IaUY?+kp7omnmV^#Bm(+&x{k=4!Q0(~X+ z*NAu~ye;eJ&8`(&-CX7Gap1D4-!wHT3&Gr&P?4hhH&aJ9jCcTXc;DK3o*~QK#btEb z)pI|22T|f%3})+#LFwlX6l5wazz=yqs(Fm%FsUvl#TXAC45xh1H}TdOM&#qrJXR;agGv*bDSP4^W3kRarMC$5Ss#Wf z*BH$EvUNXwMI{@Ku7d3Ze{ZF=h(P#)AcWv}L5&v}G*zDT=M&bFE|QXmYc zSnQ#Y9Q56Jewrwx&DA`i=mv)Z~q^FcSqdEBIGzwnPip=Y62MtKdKWK5TxGPFH zG;8 zz5~{!O=#h3*Zg1@?jq#WiZI;O!fPKCdcp7B)q*hZGh8JBjS{S^sRbl@%x7%lwVJk?~idcvCe zwS+4var&=EWH5PxyJpg@5QHbpZ0b1h(g3l4I4Z+--`NXtcbQnh644%E1Vh3%?nOE-=r#epPHtX6pQp@P@YFNJgAX zBqyRDKTA&j4HV`85CzFuR3<>IV2jHTm*Ohglc+l6$4&QWI~Q-ctxs)MnH22K)`P~D z*|;JH@aX_`>j%vvXev7)5zFzF#~qaN{U20jH8{)4FR$8U$lD4C z@&9@*&LalE8FNko&|xqIj1YscaI91qGw4-c-DUNdlQaMR!YtES>iyN0&yQD$dJ7$? z2fTZmV@1|RYs)tl?tJ^?&-tUkm|J=mad2Y;U4-gda@7GQsvh(u@ z;-Dbz!_Ef4aO9uBhbxxY8##|?By=)2dUG~k6lwsYlGF~VFQh9Bj)m@oX~rp2S}o}2m-*vW zl{q4&O95n8)002?lRdX*Nm4LA$gFB-2C)SZz$i(=Q>nrh3ShAnQWY6s^y8qbMX+Mi zD&1)!nnA}uI~NpT5!|NdqWHZy%i=HVJ3mtZPhGFd%tss~-538q-ab5m>?SCn`wOia zPV)?Y0xNU{75?JSpO>y&`SKTBl(C=h z=r(Q!Mz1g5>>TJ^Gc)SM?%q|));ly=U*d_MJgjt1LJAwtBmtKvHRGI$c&f5!!5+Sm zOS)g&p0%ZzT%AF8_46p&s|%5%5^nzc9^p0LRDy0(5ZaP5hcLjr1{M_+3D~eaDqB{^ z^_80!K4D)D|>*%1=96Y&>#w_>Yu6o<~P_FU$T1-1~N0h>?>s6lMqY^uP?p zOZ4gzx7ni>{1AansCPZ1WLRufU6f}2e|w@7s!l8p^h{O^}nmk%xTwc*dLKeWIip=ahKd>3k&_mMAPqaePlDT zjVne#e)ZJVV%eMAL9aS&kOWZi{C}kfuks@diUy|J;)$-w$L#BV*{XfM0cRZKv|38i^O^Ot07$uUVl0DKgLMUZ#MP=`m&=9GJl&zFe z_DDSKls!vA_Rij+#P@!d>vfIyb^ZSN{PF8{yI!|mCC=x09_Mj99{2SS;Ixdvee+Ef zbjM{5Yo~|gOwrRHN>oguc%Z-I1HPZF`Kx;#0Uqv;e+`NB^jzPPXIKrtmKvTdHdy_} zWIgyBd;p7{%X4T_#wwt%QGHX?m|c9zIiz-bg!JC=(?Pp5CgWl%sXoH=tQ z&l-Pa0H-^Vo(@dUn?dNNk5A3aqMi7n^5=;Iiuv}5*V9IRm|hAiwF;X`9F!y8x3LW| z*rO#<9a6-G-xK)7-&^Ynkei`Esv5b>7m;^0jzEaR;0(-iXOzic2!yVG4VKR{oPiAs z;qWBpAX$f)ix8j{(hpOC&ETiIa1Kqu0lx(nLP_t;qLfb;S(n&@ddwe5YlPj|GuyS{ z&{FXtZ&n&jr~REREeE$<6UzSMKA*m-c(A&y))XW|_^45rW`~6!2DYcVC^|pK#vF=LN#$3t@ z16w#Y{NFYLa1b6~&iBDMaVaVChmRh;!_>Pw0Rbuz_Gz(-Q53NAR2$Uv_VrDEkYc9U zw(WG3%;T5Zxx(O8x={|;aakR(;;MdnvUxVUQIJvi@|Ws!3EorN@k_5z5{QWE}k)i zm~$X8at@xBTgZXZocLkF-^?auViG@;Q*2=D{Ozk6|Mk~*gTf3avzCUOKM(Qn=VaXA z@u)c)Wkz@MhsR`1@6sjB?}9g_)^6cDOfeSQ#un}J*9wiO)e?5nuhl4Ry~rpc<~kos zk1cZA&;8C)HPCj?`}g11)omei$>Fc^%FjQBNP@_d?i3A5)2kuN?*Ua}TmLvT^bAt8 zu$fZBS3?GCz)}H+rjF_Tg6}N!8`k^fOYgmUZZkT`2Ybf!_Zp?gN;r&J?3gt> z^PqHx`#3>jOA;nwHG6BA z<{KJ1Y}ALj3)&5dYKk&K9kqR@SY5(Se|*kLWh&ewY%u%!{L<&|yrXr2(^+`( zkOH&aufpZ;J#(*Q`-Qa9_Gt{Q(TCyB8P+6XItgM3iIEaWJv^CiG^(-f4Q|WyNOJ%x zMBn7(!*5KRi{X%&!;)#SQ{eVMebB~tODy|(hRFu4j+DqJ_FvW z_i)Eu0R!7S%Fd?IHZN*-XusCXA6kIK#xg%&SqGjuxi<49G1r{=wI%ipG5Qa@UT^z+ z^G5qdVwsH2FEFvJ72olplw-7?Tf*xmK!d+8-e$mC3;-vx2HhJ{4XfMdkt;@wM0jxvNOdxX)jV)Nj>9(vLA-Bj4wHra>rQ*hRdB@q~E$x|3hrb*J{NpzQc{mU?K~soQkPa2G zt+q`BqRKnc;JD?WY|p363SEWb)l4Eo!YY6_<;F~9>aK+t zt)cq-?;EO7-?P^E_?}Yhm$|6`=imgl4QSOCQGXA2AdLbq91R!10m(~{2rQ1Bg>ScxA3V&LhJ?b!Y{ViEVa zod(!)FE_NcaDSB{KvLhrv;V|y0m0JV#XkHn^RVyS{KW90fxv?Oc9t5iaNg0@!04YL zABh^v!BJJ?3P;4h9us`lk+rGvmwcyfHxm~CSb%|4P37$ouohJhjiV0h11J8%wC6EJ ze-tbJOn4FrWl0j%K@5INkIpPyo-onKdeCA`B5SN@y4v_+w=X%%`Y}dt6@x?fIJsK? zqac&j;^{|60B|B0y7@JS4juYFJ61y+kum-4HB{%e^q1rCQy83m#agMb3pI}r9C?ky z{DZa$Qn)iLqh19uSw2ONpD=z;{?(rS1L(A^3Po6=AM9so*uIJW15<*ep=`rgTmSl~ z?Q8-f0VBuE*!5giO1HCGq7-i+0bcWD*d+bPMQ%J{z*z6`@>4QUcxBx8zNm;BS|K>? z*HKVB2kXkp#-^tAgl5uevT>r0YIEM{T@yp%sXVD#{ltk=w_Lqb%4@q;=RWzcs31%h1)cx=+&Hoh!@5M|R8ujDVm{UexSf;nJ&TA}FIKC1yCCJ3GEu()VU?pf!oENE z+-2Bw*Y$S3yV7z!TH4!~aPZknL_vh&#`!&YB6;%UN~C&;VswMb0#itpT^Y^JokPMp zJBqzE*Ji7X^xe89rmL7B?c6eR@pF~B6!v0t&yqiP&p2MH+anr0w@>V-v*v?PKgImw z9meq~zyC*txum#QUHew?4xJ%YQhnq5iN{tN3?@*4SHNLF zUsw0#kGE~~pWI#45I1K?l_U4QZ0c7~073S^R2WFrxfIY_Jd+kz)!`LL_Lh3$YjO!ul8n7ams1HKC4z zJLJS-?!323ept9uxR-vg->Bo0k(%trP(>DgW$gcs1Wf<8{r^dpp}eZ1jL8(UiTs^VLm{@2YYDlzE%7shtW(7BqfrpczQAGdte zN>YhG=ezf3@Ft;MepvL$P4#box7#!v4?b1CC4Htkt51JY?0N_9dL7o}-ZZY^d#(LW zt=X{xa-){~7J#DZLp*i}8o2+*J|8UPU%6M_PLltw4qNJcUDdEUiBc*&O%jwFQ3;j) zV7XeGu!5=g=z+uw@z4HaUy^xs-Bwc?LEd3S|d#D)> z4p}~$)S?pI>KQC_f3DzndF_kO`fGvHIa%*JckB5TD}^o2vGb~`k^a2@QLh{IsrG!z zJ8!aR!xJLb=5M~c+imZPmT{k*o>_+|08LPG`um;v*BflqNBaU-8o9vkzLD8PxA~)~ zpjFsV$A$5v|vwurZk0w0h$$ zvu7udyR+mc`EUH!Jwk~m#*@+eSY?*lP$RGX7C`-EfLvItjo3wA3^$ngpCa^-1DTt*}mQ$qIe(*?X{no$qK-YptLcSOpgG{IC@ZL z`9b!05#I;0RD{w#K^ad5F>@)>krEp#%g)qXY8|$XzkZnu(ub8eR;dNNb9|Nes6P&r zdS${Na;}bAF18_3UGCzSn$M9=a0uO7y}(*-Lb4=dW)`qD3h~v$Ezxg~*&%kH+3Q%FZc&SQqK8Jp0q!<8I80To zC#41nTG>y)H77ev=rkKF6M1hu#_ z=tIS>2Vi;uM!a1Yio>`@tjP6g@~c zyfi!73Nes7Xs#6GH{)~Y;YQA5NsNPgg5HH1-Oyy12>LmKPes1VB>*R@RHbhwTcuEZGJI!G}>gz2NKy1KZcA}&*wZbf3Kn%m{4*Po!{he?BnGIk3ohe#_* zw8Y20`r*0zP|YetVRWJ1V8b+2Y!MScd5%D0CpO=+1&i*gQW=X%<;ZGu@?EIA3As+Z zCMmVih|`+KdUA5|w7h(@?a=4M2K6^4()#+(vAQ+2w6&QC5C8}fDB`+7D{%@|WaZYah3gQF4C+87OGLL+%K#WJIkMdkdK*|Vs%(p$uFbnPX;I z-gZM4Ww<_`K|L=D)Dl4CdN)*gXH)bgut5$9|74Vt@vG?Fs{5O7MO4Hf?KL@r#Gr0W z0tcxqc>Vk9p>)K0Y~HjwA3h}R0z4r8 z^#*q}(~zv=i3yqa2~83ne_RF4yau8{$)DkafO@KpRpP`LT-7%wK}C=679e)x>z8!S z2RjA&;7hj39UU91f&Fl@YFAzRhseme>=sm}k0C!kV)SXB?BIUuDu#dE+BDTPH5p)h ziNN%iMiYMI7t7h%@ncqTeEfm9iY=rASiB$y%Mc-_xio^|K&+Sun32WnYy6Az^s$eqvEp_&4A+!IJ-)P;4c7ai2&N-c=DzE z63=DWya<2~Sz8up2)W?}9=XKE(zS+YEq=_7#oz$~fx82?1=9FSc=c94@%4R+&)^7U zC@4KkMgY(0cog}7P7fdg1tT5}G4g@XTp)HtL+gpZB{Aq2UV#_t=|+i5PwselWLMV& za+6~z0Aa;?p+b-c9l)%u$_K1wTGY$MEC?!!wB%H=&axJ*>}1r6$c8oc$fO2 zX!$U8{>y#Kf8!Y_Q^l}+e$m`|8T7~5uD^-TdiiJ--|!q7vgKbVK2`ql)!d%JLd2=L z`WGz;4g{xL5JHriN2h?bb&ZV3A%x5k+T6f0?~AjaENBKO5qYJm8u6<5|@$~jnXO}NeHR^h#nbeOxXj+Tao5t z;>!4bU6$`=bBHfPMeM2E0LZpE_A_D@9mVmpXE!0HD-w1+L7TO`ogUmxl0d<**i1Y)Jg8uPA;0OEe%-cGFSFB#@F5NDr6=Q}<*$s#Nq zjCh`gYh$h10XTvbqh#o?*_Hy%u&SEDBo7r_aYui@2dV)07MNj%-z_M(&D`9a7>ENR zV|@V(&R?6-*z@x82)QVc5O~@}lDIs(-;W`xoM4;sU5;Yj87l|JU3koS49aP->q;mp zZr;6nH(;3^NM}C*a1>WW=mE~)ErX*8N0*h{Y)i_;wNNjzu(7%0qy2FhAQP?zRYX&! z#{MB$qB6g6x7DWtdy7w=9 z#0I~tX=Q|U?(~HVv`E$=63laO4mOT_-xGutNgHYkkG(e{%eDRx$N*X)Dp-F}sB14n zxkKb<7Fp#Z5pJEU>(Y=*k1U>6B~dT_@AZ!Tbt73;6Jy%`_fAgyekZj|!y4m3;AuuX@$x|h{C;E>e@@*8Ct(Ou-q_BP3!k$W8C*eA;`od72W?!PKDsg4_rFev{Ka%>Wp)Df=mB$Vt z{o9R=s&TTLI5rt5oq3+)#o@2SeRpzybh2<9Zj1j4%wkN*TIIX)oN^Isd0gO0HM&Rp zlJqI!(qjL9k2%QW!&mN8JX;UdbY~-l_V-c@}z#3=0Cn7J*3{& zqQ&(Xui1t;gz!|Iv2uY2ZZ^CQl)zdT2dwbRuVpD5F_Sy^EP zEyuopxol0JSLXqu-`UvNBkeGD^h)avvwX(SiRoFwH1u&XWL~uXsr&by(=MW2zF5^T zB|huKlBEUe${_MruO0?|UC45FRDH9-EayYhR}4xR-2ZEOF?JSO?l(bG$m*y=rWFKn zg(yL^lJY?y!~KRTu>x)@)YNuiA~s()!KzqLQsRN#9Op251L^;?Rw@a*+gFx8*eP;( zkU@~_h2)K@zR*{7k?S#1{lm{<35vIa9BwSDqvE}!{Z+W#m#aq%scdipc6`snuy2AKMiSt5VVix}x7haVA$J?7 zi%ElD0^@m#AeMDR2BjMGVRS<%V+0wz7Y-@MtvMfk{N&2lSIO5>pPU^X?|Edg==@=E zmpDb~e_U6lVKu}=s(H>r`HSBs-z4D=_F~imY6VleNTh{>qV}Ru^#g8Y5w4Lx<5rv=RzmmH6V96{#-pJ%*CWMJk8lI&TuinlXwQh+T|HRAk%uO}4>s(}#Hgxk@;QDxUXmWbdcAnlTj1nRlu9JSoqmhyZdagz zMFvtQ>VU$U8frJxW2uPU6}I{6mXRT_W$&41Adp7qX73t6`9-QW}q*^PwD0n7(LwNZ3OhawjWg4Y@R_B1W_J&>by?OR; ztKF-@K*_joTVbb#X2Y?4Cj5cC>m_~egfjGZl~z2V)4IX36h$rmza8tZyKKB++S?HG zLQfitQHJT!jhrg#TEA*wqDnX`0m*$?*=|nGp8*J;T5AOvsvdcZBFA@}}hH ze%i;y`I+>dN%}(zp!k09@n;DNndMVy`7DU9HiEf`7&q(e?3_3-2NkYY>MCn3Ra(c6 z_ zzT-|Ap&>9gf7#P(fAB0(kr2PS=>{r8;q`{8B544n?f&x3UiG$z+?<7a%ircWZrVa# z;{7%utgjfT_3Q-Obgtar6swdu#?);-FLw ztbcqr;y*q?dWe#A@5sh`ThR<)#`sjjNOMBsADH`rXhV5v<%pFqZvrG7Zl?|tiHq3d zuK(}*n)-pNP{4IoiwpBznMx_CO(uyF4_k{H=pnP@xA`^<5a!OO3$tzKWf=ec!zg9& zT4U~Z8LIVC)ZrTn2um3;NZngQt(=Q;myUdt%=pjQYRT%wpVd0u-L0-Vzi%bs!uVJj zBObOQ0RF5xN~>;AA-f z&sNK3eU$_F_}($>&f_aYfAaS96_)yrH(oqTK_B$wx!%7&j=|5Z@r$#rO9A-CD<1m$ zi-WrZP#*!|xw}gZ+M?{>ee~YYT79%#gcouT8aLptcc>U;kS#sbf({E=oomI!#BO_d zOd%wLR1Jj~0o5S$7#&X!#1}b6Tt#olCVLxA4(qL~4C*!+Jrg#lsla};HP|UqJk5#X z*}v>%P)7IH99xP+Gf76M>WB@C=q&vFP8#jbXb=OA%EZJ39h23!VYTY;qp}cvuV{qu z)JJr3-TCM}HS!pSm?w>3LH`)Wj$Pdw(W!SMB z`s1~ylJ${RR}iaI8^1kX^Qx`V@^RC(*UYqU?)&#t*Cm&4W9>EQ;HzLRR3I9>_3Jw^ zhS%Mx2K@;kQ^IyJ{_R^aTD9!f`DQ?NRPYw{AW&;B3(HLc90hK%vRX}u=o)bjL~7?c ziO%;tTD5A`I1pvB!vI5}B9;Yp0vW(XOw|K8{^E+urqRz4hOKxuFuilvje{g^v|jj|KYf=)caUI5IA z)`b4jto6%`Er?uc1%-addLttvbu*f;evS_sat7%So*v^3eQ;l8^8~oLQ_k|Kv#`Dw z+H-lqp?{C6dCrP+=f=BzlvVb!xz(R1`;T1}*kz}a$@&f?J#+z`>jchiSM?C(K_6zw z?>TTF{_O0P+Gi_(X|BQJCUWl~540X`YaLtn}tbCPH75QbvDGDFuAb~Ie> zGSI3snLD7O=GwQE*m^OoY0|de>$+wlgXof|#^p-4;s?9==(23BM;#sq8=0E^N%JrN zPP4qEsEB}(O3=b5I(4Ep$4w!1@xhqXhp37um`PiJCqoedD&hQvbZtcVd%!+^1GXR} zjnojm?*D5AG-jIC6tA(6xvM(Ny1IJab%{DPwZP0{@n@Kbu7sqz7GqEE+lg+A>3s}B zT?;dxIQmC5Nu=s2vd5gK>SNDFc}+E_r-wGDRqz3{PtUPFpt$Mp9hD_1UfcYs?nGCS z%~;#d*ao>U;m20)c@+l8^1T7nn=pDDF>4WIavnc{*X12bXA%;gI8+i(n|r_xCKt@B zhmp%<*rqno)AtJle{ov5awUYiG3eYux1<0kZ+M}MvJ3gX+^`!LzI%7~-aTtR>)))D zxbJ6;`0@aIezVbRYHep4vH4YEKPnwxn^ICA+i?B6Ut z5w53k=!SVP!ftWC#&ul_YkbcY-U~h98C7F)YA4U#a_^x8LS7-a~pdRgBt?c zKLEW(G6JUHus9%9!~qeAWZ35-ftK9gDc}uvMGDeokar3E=r9>T@_r0>jln*T;+Obw zdC;)4%-vOu*FK6#*ba-1fr2z`*Qh_oTQa@#cxRgNmMi1 zdMzzYa$seDR~=TZ#_t+qWiUSLF<2j#|Kt#LUS3CMXQ;Hzw*x&rz|yNPj%oLA2!GAn zKhe-yEGimmyei#vsO5RCEPekOrr+nFuVQp*h!8zMa^QFh09AvI7*OCfzld4HSOsAO zxJLLpLAb&TU?De_4MK|mY77ncZrs7!0n8^FyaE||o%;k*4?4mMqw7a=XSEylsE}b$ zhA!|EUb7akf`j95^mq36uPq>a0dGuqB6GQ*xj6(6pcZi>|A?v*y_D-7EObY?yd13y)pzeo)PKYcywz z`kS1&ANy|cYAK!hqjvsZGn{_9p_0QB$st51Nucw1>($VK;;_#do#irf4O6@DyrG)p z_s*j;#C#Y3R(=x;e#z>v>~FK{DXjRf7QUNe-ndivax<;R`54`wPW|56oGOK5`68D$ zYMqUtnjRSvHOnd!dbErdMS5<_HmvRi?2qQu&31XnZY6kXd;# zM3DZ|%M~bFsV%CVq|ewS8b9*2oIvHdU)iQQl4S8Ien2xj+Rk)*GIcs*g&;F^cJJ1H zZkL=iQkoT;^N$4UzH{n3a%P@Py;P!Hv%&4etx)5UZJ{TAuLh25@H)Yj*$a{SWx$76 z7DxmTi8uu1JCV2_mJwjwJ20Rr(7%KEI;Zb`rJLHhp;Fr6*55v;=)7H+Prgi@Gao&5 zrDfY1s@tv$?}V~n`ltT;nNHa83U|WY1e6dQ$x|R0)lZL&34bc})xVf=D%-AlH3%y^ zemkaXl_dVNiklb4mW1iOMn9F2RHt8^S60#NnZB_v`tQvHu%kiPPQb8|@M^86pg8i~ zaz6)HuKvPO^W5GRM&kj+{%&P4v1B8<4UB`%w@t=%=O#)x$BKX3m{{~zz_CM+h~ST~ z!7t$5N8#|r7S%@P)aRl?!?ah@2H=P~zBP9~Qt0S7(f?+IQRJlIUgz(xtl8s*Z9B@? z!?F#wAK>TzJh)k$Lj0fIL#&2^F|q!_n&rAoxPM=I*#d?GdY_*DbkCN`LiX>uBq1_RBB7K4H>99qhO4S_Q4~0adb!CvVFi zS9gDqiZGD%ylctCr7mdyasP^V?W;_GFkrKh ztVw^nS%N{4=Czf43)AY*Z_tIpmY~EPIkjqGsw(;1HFE*>49FvB$@z!IV zCWf~4P6ji_*~_m!pRi+L#N3eKm>GqL?32LOBz`mA?x=uW`_^UI+{j;8J(^X~6282s ztR84)nRH;HO9!HvB&f3KtqN!@FOd4t2H3CQviNI%pUwOgHRDRpei~#?H@Osid?X?_b{xg+$Q`< zwBM#MTJGUPU8W2Z?l?!gkt5yrpic8hI@IFK^C^kib|~1_{>NuIfgt@FwjBpiaH(kv zZRJ?Me2FKQKYp^XifsDj>MaVQCoo0nZjvjoy(SR3d{zC|-*R!lnL-5)2&Q^&oLd+x zF;#W42-$D#Xy zKp;%G7$&B>I0b_OvSXMCp#d2IVPP-kLEVfaZ4Tb+yFNZK=xm7U2&Woh9^y7>Jlt0u zRsmfZj5MpBnYZVmh}L`)xJNNMRz={24UMklA4Kiz)q8-9C_rQ(c&X;$jy!H|#PDz+JDP0gGrT ze*ZpmVan5ghq-y(0g~RkdkQz2^eP5!x4Q~d1-SmK7v0MqqJ5Nuqi<`HX){HB(M^<;&{G!vwX$+{sea<&U=!ah%gBj8xd>n9 zuy=(QDCF%V3~$)?tq^@5(8Zb~>jpj&ya*u6vppmrorf`625R!s{->@~1q<_2j<6>Q z0Xc^(97dNALT}P;RR8P*IrM2o*h{W_dChTa&BiWt!7FspYolHVp;5@v5Bs-~+W|Ti zyEjeOjo+=|`JBL`5qJ4AecnOVRnMPSQfZt!R~va(Z8z($&Cx21^jY`>s9>xZ&R; z@fg;GR{_i*3PS{ecY&j-ImWzY%PD*j5tsn5SPxAjL`&p{@iyCywaFnNZQ|QEL(sTi z%48CET3Q;^UTtk?puGxwH2fNsmDQP=FlJZYqOkh7&T&1}*QFcWI&{x}8u(OpU-H3) zmRB9+tSS;R#L4uRZC}eNq#iWEUGUKm3Vuq`VTMn4!5XW^)Z`N2arA&*Px%B%RY z4HMKZ77MgPOW>Zge*KN=u&S>gi=2PwGU<~yRGBJcRYW3v47axAah)n+%MZ}mipvyq z9_BRP!FTh-tuvPF9P5=6j>Or0j_1xWxIP!LT{p3cbF{@Vrs*!hErYSUX+2=3jE~xl za@oF@_6a7~DeaardFwSgSY##m%<`hcAV(UfvW(Z&=L_G5YSY*+ywZOo^OR>TlS^ZZ zU;S&2`wZ)KoL9VhrR=)W@`hDV9818nzin8=0sl%lVFxlQ2)>Ix?B4zRk%a0cR9k%U z(!C$vtt}m&HLA7=ZLSWx^CNIqU0bhJAJz$m|9r^VoTlnysY$ zlkB~5jqX-T!{YP%?euIDvt9>op`m#TM7o?Psy>hq?20O@w|qe2eYL14$iGU5QK8aG zUXe=)+NQ->w#io?ZLf<7>5{(`*~B&UtvTY<+SVt(>zoF*fHuRKLdruHkVCR~PzbRY zlnk=DMHN<5OjkJ$u+1%A6Lew7Timf%o;S{_r4{X1n*+JiEPsXppVqO z3$^TnR#<$0t(GwLjyk$=YN{sM?UDZ_FCkR9fse&du{Xb|%}O7r+S6NX8x&{Ns+i}c zwNIr;-akp7Ub#P3_MQ-tGJw&4hDh8XjxmV0Xc!r*_V|bvB1=b8$TsLKjZ`E9l)bwB zoNj5Ct7M4v>>l>i<>osNy?HC10$x3{FSK7?bGwJ}n^rc2hkw3K_3J$K)z5q#IF-Nj zBOeOpJ1|0WFOh&}2H>%#U{o2x*t&7|dlaylK2hK(j*_c*BYuD99 z;WWB1d2jnz&c(#3Z~UvnwsJi)ke%8_qh~g?IUw#KY5$w3f2^Xd#Lx{ALQW}#D{{tc^_}`k&tga?pX+2eJz^YQQF?fF*v6gcRi^?&H%v?z_Dqbs?Ukz>RrB@j zOHt!lw=TIaO|#_x7LT@9xd~i@5NSalY=!YyR(+M*wO!^7T3TBP&uQ-`7M7x^Z+GlQ zDoY;)8&Qa^UvFsAa)m-vBO{pG)#Yt^x=~QVr#&nblHJ7}-RHkO{mqK+-w?3Xnh@6D zTqbTfl15Uh71lH*`q- zN^+?HI2Qhh8JJbdRdDRG5WMi7=2a>7G3xLfI+5l#LB63Inwsc!#zxJ&L_0eTd9Ug- zy(@hE;t8?GmfCix53RyHLK|q28i$_0cp>X*Ag`~_LPQu5SvYWWLIyW4N|>q)8^}#Lw@BE%rKZr-FhEMWC;v^wDwUa}V#igyikQF{SJ`q@$d? zub&lc*}6uc^-|yO!c9ow6+H~s^9EGRVwD6ojR6rQi2gX+V+*+>JAw&b$I$z-;MOId zoR~av9lS^S_|*38$;R}od$-;X6Orre?>NDe_w&uTF?x)1d(M9?;~c;39`szHKGtA1 zsQlsbMiQY(CvpyNkZM?5ly;>fbX{eOQ(JFgFA4b8e6Lig_RxE)g68aJ(v$O6R=VwC z=Ub#@j;s#PIa%YoXLW|9*4H~b&zxiD{Y2|LDS2zn8?%D=48Nw^b2{+o&b%K0VLBSQRWqo>7B=mb zzb$sX^7GfnobNi{fleCFU!v?TJ~7r7eYR(aQlNcMec&DjU6AFpM1mOKm3=C&bCJ+aE__fj9 ztgN@8uRDxUb%g#IVW@>*TPh&y4McfH22nE`)LKBH#zEtKKw=WO2Omi0A!XBtn9~{e zpFzm#HtK95QxP!Eq3!pU-;uM4iZg>2&8CK-huGIrF&^P0+Atr-pAIfdt?|=M8Dm|| zZ(3TO$unMQtc~v|yJk{bFugc2#hG1Wx4v8{Wy?SIqV%LE5k$r2<0#^R)UQ|fp-e63>l#>!8GX9A_kgltf`^(r1 zR$rVoo659LYPw-u!z5^Kpr1#S6<2G?2J1PmjB6$_wK%+J@~tTPd9O{HHpkSJq0f<) zmoKiWdVuDr_o?}Z=c@rAfe-IPW3xE^5p)|yt2sdH=+oOJ37Jq9`9WX+IjNpG*<*wEx=A8#(WQzaB>}?9iG!*o!k;ah7z5}^a9UbP-QRX@*qu{3{u%N;*qrL(5ef)B;}r6J$&;bQ2J}UY+q&GZ-l3S-1LM0-N0W?x~Z*LJY zv*2f3vo#DfuLR|v9?X;&nr*M*(&+bj=W)-KT0tT0 zW{jOF4<_|FRPGdLL6PAWT=B~mQ>AGfwu_(t33R=5*R*VGUK^XGO-@fEFX9n!WkN#_ zvbqYMgsB=41}bO*Jd%>e_=sSQJ0T%zx|lUC57=Unbo=%yNTCVB8A&yG%MdgX>>8&8 zDGgY=LM%FH>mhBKx+ere4^4!QwKEG#gM0bo2wC zO^`$>h&Dv0=ZW(Q5Y7jAWvkZOL*g9t&dy$3bD89qE(JEfp+$ZgM~1W+UH#5f9vojUBvIAJ29->CU)QT z?1U?e3_cx%u$@L0Pb1C-7waxgr52;08{}(`SacMy)Ihfkx4|S!4JkW&3nQbPjg8IS zi)BN(FWMk8jw)@=)-8$e>gfwU>0PIGwgZG1j=`xwd*_8r$I6{ouRaVmDz3K>JaZz( zsJ^hfaAmD~e+{!zY@m|FehNbTQ%YxrS`b^!+}s=)1P4Brgbe`50RV)|-X|K%r85vm zHa8YF+agl13cNR~2OAE}52dEbonTKYeWcP@c5QS)U!iTP-)DOIre%WjbxMj;j!)Ul zX_d&bTK4tIt?8MZPWyXvs9s5^v==S0iO-`S!)6?fO=4c|p2Yi^Y07iM&nvC!TXUaz zRQG;g(3Fw)R->`e^JPz}wbpyfZXPOlZah#xKJ3T~R*{=@CC%A$Hx;BM>tmx!BejYS z${y1wI{3$tfg&-gD3lU1NN=2Vk9+;G1xM9XCFrJC$_Z%w#2A)9)AlKfG7^*jUC(SXR;exUV1Z|kNf(? zT95|&3@I30Tr9dDG?m zpDR>4H89Y}pPFMVlhx~dZog92^ytO@F@8+Yn0732afxzi4*W+)u3ia}MIQw#7M+&O zK^#M{fsw470?yNb)k@UpPudZyH1ws7Q{+e2&9g?a^WPU-PQ}P;<;_nwrLESe*WsY{ zDJ%*L=A&eql01IA^ITeVuncz2)1;n{`tmTRIwA-F;Nqx6KQdnAF)Nu9CF`+2Fzf~n z``MdHyegam^wpspn!`daIpdaXqnG-bMZ)?pWRTWG&y_7!iN`&x;P^US6vlu1KNdm03On*6U;KG*_ba2noUAyiQRxm#eveF2>osWW(#FWGIT4=vz6z_FQrh%1(139`&%iM)8Upb z3Q1({)8XNf)9WAC<3T0tbF6ZL*)`De>qEy%jd@re0>blU=+4877t=A(7gF_7qk-1d zMkB!A&E?IX?8H`UBJBV&j%w&0t1;$&wHtCGU?p6@3;O!Xhr-8o*`Z#7`t;x3_x;+O zN&9qib10PSH8F*TqlZCI*GmN3eTw;0$Cmu|`&-z7yYqN;b?WuSs?^;7K0^sIBKmFG zI_&M=2xbJ-fR=hC4wZR{P*Ipf;YTA`5m|h`lblHz^18ct&9$fbNTj|u2|s_x`SvfQ zT=v=Sy09XD$xQMbn#VO8pPhSAxQF+GJHd{JSYsmtxI`$9(2lJ{Okxp$5-)rNsA6r= z(ONP6ao2|5N6imf&<>N?4JAnEJn~&}ZFVcIjmwXXE=X#Lj0oo2eV~%o z?&PTm%Zux%1&WwWOI%t%)F}Thtg(wvw#FkI{S3S`&`JY(z60bH0N=AUr7Q-gf4{%_ z>`(gRGBP+yZ@X(b9~5Yq9&5_Y)*b$0!1U-*m8tfzpO=c~MUPeuhIy{TetYx7vm2xY zS(CC!O*+y_g7G2tul&bHMMViWVjxslMCKi2Z0NA9;LpaOn(^23`3o;sq+&Psm!1aI_x2U<;9;8vjY>8H-QiAkI*pZD+(_?Z5^}&)EC|AKTZo#6Z~>NFGIxCUw_GLO;;rMd;#rtothUFP8nr-F6>5SUtE&Tt*yB zk$$tYtzhMouVKQFw2l|=Oty*|D6#HZ6|X}*mQQ`L`1tIo;cR^6na0=a#pcMuuW!w= zbAPrg?F9y0AGTyUpl#wb|FuT4*W1)uX+JB`_0*HpV>zu`T3Uz{BS7E*InZ*2pk|nj zz1H`>xcCUnB7ks;P`x<7$wnA&h-L;=5uw^v5SzaZzncZV{0O{C`0c6!LeF1bt`Gc> zNXwc=G9=;Xf#VU+9kZfoh&&Z3Z-xk{NwEArf-i~lIv**T0*LFhGzY+{#0uw`sapuF z6x4ANHfdf1C?)0UqbB8_wYzzq9OTM;Bf0U)hm|N806^j8H#z1(Yo*l}tC_Kka{U`{ z{;CK1xqGNph$0(=50QopHB2%_l#>y~o+P}H5Cor=mL>p6G$H*0m&_o_LK#XV{}GxR z_Hc)r_>z@`!H}?{qRzV)+Kjn1N`zbPf@V`wbmwGW)x(Em8gBv(E9Co&8rmFQa127` zGx8v8_>jpJE@wws@TUvWE3j#^R?T#SBm}EK*jX>d!1&(e&D$eA3-v|WNS%N|u#t4T{Qd~aXcc*-NVxJ*dMkPcd<^-xdk-hDP-Oe)*n z!@k{J$CVBJ$mA5s#3f#{J|)b%Mun;CLyC72uS$iNta%#d(GaFUf*C=PJ5@xl1IEZ0 z^;;wC=`J*VGN!<*@)vp!5fVH^a_?K3M@Ll)+X^vrp6rczyFBU+Y{O`f!70!aBrK&c zJR5NO1ws!1{k1A25R8j06M9I?2Jx1R0*K{ettsKGV^JCCk*>SqIHEo`A(bZaz3dSI z;d9412;1|&Fw>GfiCA8aS3`aLap>Nr=DK~-h~7@Xoa!%Ui^@#6qln^9WbEy`P`Y9r zH8nd#sY^ru(nYC%b%yWX%*^bzySvu(7r3+Iyv{}Dq&!zVV8!>V0o{kg0-0FO?IEU zLq>o@N!q#FP$y!y)9WmB2kQeKWNiUryB#qr>+7diTjXONA^R|SdLeAPxJl)p{16Kp zvBJ;gJz=4yzS7omKjtZahMs9VmGS3-jP~G?c2^JkHtu)e^)u_!Icr#Lzd!3f(usE)|?f#C{amqL9)-$_q@DW|96nk8suJ;*BX6J$^y^s;v;x{8oB2Se3W8(^`owZu4ex zPs+Q={`B^Utg_Fjp8879lv??wR70{zbH$#T0_R;pWl5U9Lg+MU@2!pX=oZg zUN6z7|J`+Ng#X5Mo)S_A530BJ?QhR31Qh~-JM4Ib*VJeSSN`|dCaRypk;_OfpkcJ! z1SCVK1hM?dEI<$x`!M?;kORZM;y7atZlUrxCGl%Uf{2B^N3*$yS{f8qbA3A!;%CSR-GPX<6B zRpcHPZH?E4iBR$P#XoR#I395DusIWh&`L0H)MD$x!;_u(rpKt$jov;xF+NrEW-RH& zpVw}X8ba{4jSwwD2O0sH1!Uja^*{XCiP0J2;yuFF3xaUwI8W2WYiW!-cNZJdDJ(5w z#Ts;v%~HQ+EPKs_aK^TXt7cgoTOdO<#Gb zwR7>iinaFAOLi8Pt;E;Tx&1{1lw0lY{+2VTAn*G4e1C1i&d{UA$|Hc-5~|xB*H(w7 z2!GTk3WViz-YzX`4OnaNeKEGaeu}>yGAB00%rP;Xd3Iy`5B!Wj->wR&N>JIo+i*3! zyvkBe(tlzLv90lmH-0bl3%h29VE8eloSJR-c*51$$n7w~ccqq$>Dq?Po8!F|#l`oN zjTo{it^ld$rJwb2Q7mbc$fxA z_9glvWB?=^HymW3TKl7XLh*v{(1X9+1wyUVycGvB>TJmeD~}yZ%XO>?uZ<6CV&oKQ z{&@KDvc~Cm$1Vz*8a}a`@O;;S(}w3-(4ynG+L>RZaF>(qV8Q+E$*%b%x;SO7xn6pQ z9-1p3S3!-Nn)>T=C2qm`y>$69aU5E}GjcY=Olz^NlZ9t-=f&Y zc~Fa}neX35WFg8)`kre)@}-C%Fd?-m&C@L##9p!O$fb1zH-a$u4&Y#yK-kasLry4z z7zp$Qx-h*Fg(-qX$N*~>!Gbvl%L4I&!3U-bLL=aT#6PcD^GN``=zJtc4_*ddqg7Ds z6x^uIOu72Zc~mp#_VYhqs)HPT#5YIMj5p9JD?~fzElkQXxyx$aFgEAG(;gh-aLu;?@6%805RY7p>& z8(<Z`PE`hVvIVsb6U5eV}kv!F(0R+Mi2M z65}r5I^*CNc;2vg@7^csEiB5Z|Eu5qldL3KS|fChHKve@E!4KSq+7F#j+4DMUTge0 z)5Pe{DgxX@KZb{1f;`(9W?BYOhlhv;Qp5@*bn_TK$Qiw=1Jy4?Z@sQsFq^n7+(gik zc?6RHbR|UtHZbHDXGdx}NtyqCV3Q zsN*I1|78=Y*s%);H4)2*IT-Ueyok_M)J;SV5<;Vz*fbukUA2nV$TKuNoa#87oX{}g zP>Y3B3A7!~jnT!F=HuD0m2bKgF96^UynLzS?ZbrBRraU+B+q z37$(%m6MlPrAG6ay%{)|Eq_q~C{n*>#tXu!=qsZC-c$dOW{Uo5fG0W8WmeYKUsHYD!mdn>u>sW$2{hbzrv< zmhMHoS47)~?crnI^=qi<=NJCJ*1iOq%C>D=^)yE*)PoSoOer&wdCF{?i85;|W9CMR zC{r?SWXLv^F>{f5D48Xad6przY5(U%&-=XJ`~3gEzV)roTCKHXZ|>{9ui-q8^Ei%k z5o}Ws8xHOfBEmyIUU;1QuR+F#RxnIPMEpmYt+4B?U56Z?C*;BYuN6)}iRcB7-)FV% zGMd?<{j(JVb~nLF@P1$b(yyHp5GYh@Gh^@(Spt~lCm7}rI``+a!%z{{2h1o~JIFnQ zFa{(7uz@)zCKe0N>pXBjc-J`@vn;B`Vi*nBlpaeLmiq?=Tl`)^C|heJ5~hw)a6v2;25M^BG{0z*IVE)ZXTe*L@njQ1Dn zV%Ux%(C+au-=@oV@8R!L*$G$nbeEqNc6pc@cR%k^`YQTGI>r{j zG$8r#fWZUX&K7HTM)2iw=(!K#Tf4B>6hD=*mRqZDI)a~2C?MP)Xx5aD5Z3$)>O(+r zYl@KwOchM#{dfkT*je=)_ulH6{4C9l$})&SbB6ID(Ml`s`Ew_OzyjctG|8bgo1@6Ro zk8g@C9LO-(?>tqxw*0x652!lMS`e-7W*^B(;D3QV+ArJF@Fu3ko*cX_B#p{r68ApRYOu^sOcjK8kc(*3K`M=o2rV z`wQKLswW5$!32VrShRD08-|GCw z6zCWI-c*H!dneVV*Oo}Rj}8%z>Fc8+|kI?g-^s{{J| zJ?Od8VfvV20xSfOT@?t^ZMw3WK_FSz(2yex26bSvhfJn`_(b?*4xuwZ2`FrapxCM_ z>omliZ_X_YcTigYpj$rbqz{#)6FUC0K+fH zexbw_bj=Hgk#iU{`8jj$T+QSgX%cxQrR&hG_DR6Ij=y{XkSZ=OFHdp|D0Rp!3NY=< z0OceCl}B`AzKTkQo$}j=17(xRB}g%lfeMbe!2$yF54E+m_aV85Qb-CIC?L)k9Oa83 z9!2)5BRFuPWCd~%(0v~OWC)GW<`@_CKX&*xc8G4SEf0ZY&YU{hebn$C1ahb|5eRs9 zAy+pznQg*2M>^s1D^Y_jPp&lH-YW^LEBSiqc*Ah86Jm#|BNQ>u=NOwb3f3Wzw1Kwx4 zW$w&TT1xpi`La|uxFK#Fjby#x4(jBEhc zILt`NHVw>XJ8%^Qo4ei5|Bl})QXt7+^N7%$tu)*#2$nlMWlP5azNed=oi(R^<_{PC zk4;A9@T=oRc`(}|U@bsEcR5{(yeI>-uY-WhfUhY^7m8*IzFL7dBrHb5U}S=c90Z%9 z1wO$dO|on%K_3vK18-6$DQCmg5d_A8xLED}elsK%E6qCcY!# zF@-JIwSbuy;-4b)7A$W;wO$D8ix#2r_3$ph38SEMx(96kK8J=j?*3x0;FRR$8NmLa^0l--6_|MCgc3-|Ux4Gv`(%5E zxifzadAz_!5a|HnjzG`LhdUR5+MhtVXydJE)jmMHVVE6MBN|yC@5C03P{C4=0-sD& zDL^eT!04q=_)_q3bm6GC859`7N$J7Ur$=&fb2G`5lAgniZUZ_8RE|CZ5T%=MLkXp& zpx5Agw;$Lv;Ndlh~S{G6wW)yrB=tamUWTGSeB=Eoxo&ta~X=| zMT(k$Xh)_;$=ePM)RW3fZ182q#QrZYw(iHj z<1_d^f1=sH-X8eRw;R3!h9c^%h8*L>JPH~|-Qc=G+>iop6r#k9Meb;%-)#_pAQ5oD zV&E}lBfF!BmSEV}cHAY91e!ZK)rYu+EPzdj%O(IMmDr&oGuwb@1{oL~Hv9~-5)Whl zW`P*_1ymFi(%@YRYB-p5pvH_O=9iR+fQ`q_{sD~OWQf9m2Y^bj0Qw-~X3+3|0RJU; zT!39H4y=RP3T1fkM_QrnD0G2;#Svr=Y%s{Gp;U=jr@+%>h3X$8lx>lVV+GM04#r(b zzl==Ez|9aUU%YM$!x{uS7)#x<46rxhiJgafnF{dNz;ej~vUJqN6=|`A97o?cj;SDq zH~9V@l-OCN=#r4d3cx(5F6`j2K-o+Hu9iBG*TSSjgREHA%4(dlSqB;p!U8);MmCDD8T8DgrAcnV+fLBaA4Rbt z^od3_Nx~S)8o86gw{09vJD`Opq`LsrfVyYHAP$r_(lAPB-gTnCzaM%4!^b~?3x^T^ z7=%*ez)*xr1|vJWKU}D76jGjKscz3?`9~wr1FX53YhemFpWkO^TcGL+J;7j$e1JT# zA=-LprvlzGuzo9H&w!~Bk9-_2MZhaVoYr;<$tDTdAUqeOa(kd;<$;Dvv-n zufIi9nLAgGpq^T&!9x^PViyGdo%HthbG#hXFdBJ6Qf586>shVP!nO|njW4(%dLAg2 zj4nSzi^N|4Z%^0%+0FpJ`fI57@c-fWU$N!Kut02DlrfgK)Y7 zQv}>6OwKJrWEKvT>EkDlz^dj7%uf8ov;8|9GPRm+zXcQ;g5FFrsRjw4R`is*T_geA zjtNjC2cQhX{_CB?6ip zFg?P5r@R08DF4g-unc;9I858|Te`WkC#9D+JlAboRya1~g@BB!Y-2NN9?jAP>l(I6 z>#vU6KR+}o%rTnub1t=*_j>MrY*6%{^R2u0bviaHiz`olTn)FZuh05O^tjGSo$GIMw(n6+9w7TMEoL^)47$eI&LnN zPLn=cys?`ZL01(uZuPn`{9ym2#A;uDi%)rJq6&oer!H);_2yxXesmc(Z|o(>gc1Kk+KR{Pv7de^dZI_KWd7QWT>4>R{lnHc zw%B>sMPuSaoVUmm`)_1RG~#i7m0sBl#g2B5|EydZS-(vuQZF>no44g7mge)_08=wF zYK6TTC4MQmUNt{K_?G)Ri?aKOl=s$*U{Sfimvwp^??Qp?hRf-7Uml;=EqmrJ%eLuD zR3!ARSD)ZCCeRCus}&PXlQ(EC-6FB=^i&14zf7EcYpKwKePpaduMZ(7Ld)79XmiV@ zS1UgTDJWB8eriQk_~rw5F4)@}W8N$XET?u|{IRNV1ReAb=G*PFb8` z=IZE%EEN;47;nryfg5uOs!O1mY@9s5J?i1zkhdjo#dXeFjLfKB3#8Uczb)WZ++;@B zI>t!TSrghT+C70g(i<#K<}66De$e&-{f~iXd`t%pP;amnHsh*}Rs;Wduvj-&UMrUQ|7Z-!BA5%XlF0L9hH_+UgVNjIpB83mH8M}Iw zsrl=Edb$1+Sg3eEci*^UU0Twu7Aq`p0o!C{9JBOH^3yY#i_kLwo5RZfe(+tfV;2XF zr}$2YK+c8(u9niKSYvbNFfjIp&*9FTnEwOxhl(w;nj6Glv!cRy_OC;$a~R2E@)}b6 z7|uwL1V|jde^>O_AB>^A!so3EmvYs2h0AK4+eLZ9isJd>`1rcB{)zmJ_qqd8WR}jD zHOAjyeg2vEp@h67!!cg1GV$}|XOb>r)azGrF&K@NnCP;p4c8T6%YnrZmE;sf1rBH8 z&2;bBnUJ>EXAJO3ycL06oVj`tGmj6bNyLYRhcl-I?`yduV|_tsx&3<~MeocmF~YEX zK9@btEI@B`+R5ma0`J-Sw2X|yIo*QP>al^RE^86{inYI1Y{`bS=QrM@zTo*<&XKyi z0*AGB%#Di^lqp%6X8ZY4QEehyIN zRTAf%HJgHu)Q@OfSy!u48ys_Yo>FM`vmS~H#+wYDIm|SvQKy8vdZrMZJPIdOQ_H*j z>s75c5@maN(@Si^Sd68w^SR8bResXwvIucfd-6o%)gWEpy?cu4y|V9eEz9EXJ(%O# zD9NFjc#*Wr;m)0RotbV1jm9S4+Mz=~YSpERo`|#=lp*qkFzbglNk${Yml9qNlconXnq_6QJsgPotH*VMD^E_im9c;wVDqF0g z%9s9+H-tF2%wCYqY^m4swr~_$yqhN9)zH$U^^+%2y@eQ4@pgcf&VkOe(aZ zd5b6GE{opPc1=h~h`M|epQ0L#|2$Ca>k$Kglg`KPDZ1c6Q&VQTbotZ5d0kQ3_SQ4_ zaBNTD2|B72*UqdjL)U8!mkaPP8byc?%-@D>T(g8$2%J=hvzhn9wc>-PtSnV7Nba+3 z`4XU?Cn)P<*4Hv z)lceQruRmjH!IT0j`eMFi|PuI3TdCq5)q57Uo=1<(7^>1WN-m>eUx;Ph zN`=igll(d}yG$54SZaPnid`ZE1T-`*cie3_xGSDI_v;LWHTn=mnm?r@C-qtlchQiT zgpuWj(m>NKDTX^-u6$K|4XZYGs$)9ehW5ZaCG^~6_S`_9At5o8ynt>#%=G}Zrd`{w z<{2p*?<#)J^5!%T9GTd_dw8O6vp!?*Bq6MUNuOx!?!G#U-1-rRqRn0XHu*1XvRD?= zXMdtk$Cq|TYSwd71pxU%GHEcEO`M+{MOQvzs;H>A;6#RA!#M5%Wh@dR zRogeoV@-`DymhE3G zVGa%!&I@~mulCo|$z>47qp8<;R3)Abk&L3@_uTM!ysr|#__eJ3^ zLEXEw6!B>4+tTiYL!?>{F1@+&kg#S$E`~Y+gq*E9-xp~d{@tPIETjqwit_TTx3Bo^ zj5J=c5xUSk*W3pazY}1b+-x2FQhykHO} z+~~Hg&aFIuNfiP`hKY3$Uj6sXdl55J^DgNtwA7{9t(Ywz^G&93c1zn0H3 zG-_g#p^s!7C6>A;tv&tr`UGVRwc_mj{-Ndfxwwg>)DvvGYcsar&6<4pNp#+=R_dEy zeGJDux$s?Y^0x%9$IV*1>(7ZfL=^n$%NVJ;uQ-p>2#BHo;&ONPZ9z!>Liv5U84t%W z3#@QfhG?2BSAZlH4!!Kqn=Bs$mcPV~vg(P(%9H8xg~!vU2NH2x-IZ;66oJ2IS#q$mym;#BROhY- z?FCQHut}26Wcmn<_z}F?z01#P+Lvv7qjeU~QCEGcmm-#$tIhN}P54<1-qKGxt&?x` zYuA?Ep2C4-u13EG#tFk8a{7Yy$pvR)UhHPPbmNzZ`;Qti_o1SQ<-wyB;~C_yN10Aq zcbMoGJF_)Z&8KrY#%qsCq)+k(X?%Tgk6PTN2;DnUbZ*4uKIY5@b}#J z3NQ8wuK5&|85r9&sX8e0iD;A^^VDa&s5P72vF=Fbou5Y!l|IMEe5Up{5Hm>6-ET8e zD@AFlsHy1khNj$eR_%vR-*`)4y*YMBtdLa}m;bD_Y#CTN ztSUvZ7Pi%oWg8sq+NZ|`Fq83Pm!PV@AhPD#?B<=&U*Q}`hrM0h8Q*kM|NI13?CJAY zc&_GfFo;|g`cN)Bzh&li>un)bIiG~7tgp&QcV8|B`(!t|MH1oUDG32xR+xdPUVh@0 zZ$jTqn|oG6d3i*Rny;?afBK~A?Oh&0S8Cg-lWVbTp8K%w^0jyF-DKnMKUFtXG)?%} zwHJI(h~h2qi}Lfsd*{Bep{+Hp3cfTrBT9RKS1bNvRf&;-s$ zcw2#zALVO`X(3K`3SBI}C6e7d^ebt#PMlS%Al|+B?fQXbth=)KW|+5i9gkKZjbFp@ zQ%UE__Th8+6cqe?0yL@y&ZP^^Ltc5XS3A6Ku54VsEt^eJPF zXiNq+nF1*_>xRD&=^XBrkZVjAUT!^&`1<6s`bN(oV%%(aawrQ=U6-BuX@%utne^&= zT)hs;!fP{Ru~u#Bg{zd#IBiUT)9kdK!k0%6aJH=<<(!CKu2XS?JT|r#aSn_A#XJ(b zc4@e{{L02{Qhw)&75CY~N7l2b$eWrTD*565z$3-Vq06pJeBw%=r~6xe`X=_pLLSoJ z=TcaBS`ed$%IB)qb6___AI2q4ASe_G2}N8LPF%h?##TOZBa>(rUA{5R{7w4~BmOm^ z;^gt;jHiVXnRLijWmw&(Jx zlKP?#eU>-wN-^Kao@S#QnV)hRVGE7krv-ykFV$9r-(u7pi`}y6%ZszIFlTR@7|mzh z-&O6Xs3e{_EOmPgyGRoy=p3t3=%)Lsc>jj*s}x}}nv7nPk5*M_+>_tZ&dR-vaS%2N zF$7y7b!>Ukp*t5b-)6l!ezmi>JCC@W7W7t34Pu`BTrZkT-<$e?<`BsvOYTeTHL% zrdQ9$h+nmeB@oijHa`{*d4q}8iyVo`4ZEWlYi?cZy=FDZ_M*S z$7Y&<^8io4^0dc(=QT4@y-EX{_e-hm^-2Y>kpF00nLE7n-le_}6EDe>*zVnJcXh%i z_dYjA`6=>EzW8e4vafHR^>(n<`viUdUMoBKJ%>PD#wI0{qJJol4}*K}aE`WJE_BSo zmf+vvKHElNPWU6OZ9Jlb*c}~J$fhtM#7Cj~Da%+j2qPj;iutDd=Gr}5u#X6*Ke)YJ zA4L%|lwia@@2M&I(^vhSiwsyFYlGq{9EUUc`GLn`BBt?k(L2&85pi`_?#R^g{>_{$ zGs5bs6_g~p45u2aL7Q@MCwen9;huil`hZ6>hHZs}WLKGj^c5|ybn0b;bmB(^?c(Q} zROP;dzMJCPf0=|?Yw8!<+PI6VvYr@kE%oJa3lSS^?`Ww9U6HAF*Rz{Y}DN07^hdUQ5E*yEVoh*{v#W&mJvvYH+ zfD$3hX~OhW7e;Nhx5CHgZ8dFr2Oh#s8Clte8@z9`%+=m>LS={DB{N%kXU?l7_sqEb z9p%QU)N<%%V)QaGJu|;-TfkdOLsIfS)P9_So-bgblmD{W0)8kXBNM(#7o@ixx8qBH z_#bC2`9i^AYwADf<9;EPn&FLTe2QAu4`TpV!{hEyO7hvSK8WKM035f;Pp! XR7~*8c(F{Q%Tkb0kj_s@ltO(;_!0&N231D-ohl3roC^#LEbj{h z;2WjGat+{s>F-%06B-c=3^|OiPHox&0^7)j%f zZ!d;Qgg`A>x4K@=V_W`53pm)=Cbe43T4fr{c*uB>!B;E{@n&6FDSdmzGX1E_x>?v1{g{=4|^+ z*^Ric=vaMd{0QgK_e3$nXk1$ zLPpM2&Jk;9XfWhXfA&T~LgK?~JY)+{mKk^~Gbl7vtx!29>Upg9Y}lW+D3I*4nj%k2 zNkzryx`Tl(bgnGPN-}x6(O-toqHDN6U6#OVK#GozJ~25N9i#K7OKMO}P0hw)ql@iw zORDqM(46;<7Be0i3I97StylK;_KchV^?W+uMkf~+Do)M>U=l`ET5tOM`(1#!h>43| zNGJZeZose4x)uu$uP=^Diq{9q46UlF!g;N&9!&g4YH`ivdj}LTnR8OET`FHyv0xmX zT>C*nK^VvDaGoJ6P_{A+reI`zT3T9!TNm({3NX)R;<`UimtOwrc#1-Vey`}dUL`-> z8|TOt6F9DO>Vm!&cS74B;IlG)dIkn5nVM2>Z*H0{E-oHvECO==t9b!8vEd!3#aU5+ zL+r3)%zYM08k?KrGcuz1xVUif@skCj-ve@?M$B_L)um*R40TfaARQwz))|kqv*v+` z8MjDtx=x^Rm@aPZ?Ob;$qo8Cy)y7AyFBpI5r>m$D^@Z>cpmA}nk`sB-Ps@eGc$ zJgr*Nf_^Itmr!bST)^UVW2r`oowYL{z(EPsnKyYx@2y+dV;f2$Q1S8FBu5!zAy6z> zMsknD;LXj1<`scn!tOia+9K5rFLP3bc6YrASp=SP+1i2vNX67MI(&TH43YteiPpMm zNS*E5bf*QE@{_M^*{QAC6DQ-=>Sd~ld$mO4#b+hH=iM4(c`M$))Gh6=gQOPXFYuxpgB^`X=>w` zY+ANT3cswfh}&LED060ai<16U!@Wn89Z3)$9f*~Z67q4j(nvgi_*jDtY`K_aqpwq@ z0VP>^*II2?$uU=Te?kZ&8?2tMpIV^RX0nXR5kVHd5Zx|iSvO`;rFEVHXzTzigCEZd zbblmXVgJ;co6Gw5cc)unc`dJq^L=R9hcZGg zqPndqHZ_7vNqp_!B{HK3WjlP{Nc|PXu6a@w;QjjS-1ptuzpZCOlKby^t4jDWXrvxG z3$x0sv}zFC(k=|=$1--jjk{{LP1G+dD;>s-DOt0-(mI-YZKNw%#p5L@X7%>2)o+)6 zJ<$ej_3~Y1mR?5*SMj*>h=xuM zot?l&cBy1^mWb25bENy|=eYt-H!>U98oK6RkAX+(bc5=(@@ zyuX4G$2PMYTvwmVE!(}Fns+#ndj6LGmewOrGMA!M5kcB)qkpszy2CUQI|UX6mQ?^Z z({Y2muQ|rvaIlW7=w6v=DCm7XuJcfx(RGX$L2qVBuc>oXDPU4Bp47mL{DbjqyBS%5 zm^Nfc4&CVfGQju#o)^J8aW%AU%dug~JD!LFm+(w}m%N2pO6%@IbA%W|@WY=}R&*ISK9cpm*Nm zp#}M7*Ds2vK*iwP85UCRZVdhT)xOf{`-Z%r{J?&TA?5O|%@9&Jw&4ajoB7;(*VxX) znpoNGZI2pID$~*E%s~j3)|k^Ay#=SEX}@OKnbb0oi{cJGV8Bf2lN|9BxuJC6MDMo+ z%Q4`SpK3f?EY+)-?f)vPs)`j}RCQp`ka3TvDJ!HtJ6%G553|z7_Ys61@@q4-EuqfV z=x7A#Jhs|oJ`YX3P#dA3-M!jOi7}cf%jkBxJC7!>>cWtpi!!Ft&WCs#OG#}|U>|$~ zIEl?|mVEPvXNEK5sD|t+6(ede%ySRe%`v4Q*M+>_LAKc-<0`{|TO+`hNZYSr=m%qRdGUkn)dPimlI_Nlb5#=>BOsQ61KXM3a(stUs5(p zV$|I$;gN8iDj!p{Jh;9w$8ww(42||FZ%qKEPSGe^*-7SU$Ahhg+iDciSna@Wc^gf7dA5cY5pmnerC46@vvZ|(I@Wn0c=YyF1ild#MXZHwVi{2ez9)g zg!}$%(=LV;O)LbYU&%veah9Z(2VUvw3slb2dH?*pB?%B$`S&b7z)3X5Ak`pA%h8R# ztW)tW%lq-eq}Nu*qnkzl$}_Esmez@FQe3}Y_<}w_fpGZzhX9{HEviqb`b24Go&}_; z^I$8mU~s4t8Nc$mIXbJLf+Hgz0n-=%8yvPIS4DYisZp6^_iC-mn?5XyPpcekJvzkn z2EQJ+O*-<*O?NgNATx&}n)c4$J45BJzUfPHA%;$rS?S%-(K0_oD=fA0Rj!h$zWkY^ zfO=VqDA<;%_T2R1dXIblg8eoOibAAJmVF-CBT;TVy-DT;#$}}i9mrHo7KGLEs&Wfn zO%%pc-#|H!X+2 z1Th@2kcTerj#OMiMrz_ok4qtZ9_pECa-2^FNX*Yg^;QdecEAsM;M3~15$p@OVk{3+iHHY z-=I7FeRwC3Fo?{l@N>!5!z+P+TUh?4`BBZYinD&_N{>%9~P3O{dqA zFQcG%?O0Xs$ju*O+Hj;@JySlt&nQ4UVxu!>?!Lh6OF&LPLG0+ zhqd3s1fRXsgK*RaukWbG+W%VUW&cF0S7{K*U4Kly#uGYKWuA_shqs$l$BikN8G!sB~Z%Z{+osm1BVxiPG~fO13g2D9I5PdY2PBPf_Q9X;4iz*XR;u$lU&j0SpXrp7zSChUK`OqV9|9t#5 ziNoR={-AqUt*<}I?*Z>8i%={Q2Lk)Z4cw2{>8WQ+q8Y=`wNv9drkBN&U#hXCYD^Oa zP(wvNdw9_m3tVi>xS7kI7b+P|0eEVY^i8#vOTBs7kZhO|5}KsLu%{h+YS;^wfbLg( z$^E~=>6Nocq^9*ba^Ht34KDB(cy9xEag*OYsE(wwAYUo1|QJ{#I}D z!dzR%V}WrD(s2mu*?bbF@5Pz&&8U3;STFYD_e6#-$7rPQoauX!O(fUf*uQMQdy^$H zmhObi+-DNJVElS5e6Z~mD2h1RYLR+-jHEw;+DBI?kp96Dv&F@l8Na|;aITp5jP|Iv zLWXG1b7|XcE-`Q8Bg?_PC)!H%d{lgZMALgKMR*XocALEt6DhDn6Qx67+hx_@oA--sjp}(Sb_NfZ z?aJDms54Z6`a#|{<4feh#5&$BzQoG3OphC~u4NCnPaw)CL!5Op6>5&PZ!phn_pz)i zplSE@o!lIZFMF+1cXvD<`3IG6iiYEZDm^ddRVUaxQ}ttU!d5JEzd1mJltKU zOmRs4i8nUK8u@(GaM|7V{Mh zc)Jg@e_${w;>ooC)jZCVh>i=u!RXqGKaT(PPE5hp=8{v_W9Q+B*UH$!t z4h{|xxJ>4*^nVZ2m>kz-^V3h@vWba_LjBgJ@tno?3w3rTD{X$jU|*2{h~TNc+N_J< z3q>cRWn+s2!X&V|pfi4BQ`7pz%zQCI%b>c(n0KF3;mIm zjPG?VVs=grdP~bsJvv{SHmA5;ofxs`w@6D%zo3n0pfmZ}++$tq4B3=%Kb#NF%+$;B z1Ri%52(f%`zP`SGa(?c+x&mrRY3Gx$^9r6{Uv64lmWm-(5q*-{Cd-gJ8yy=P+lF{W zukqku$|eh2`Y0Scywl05=u3Q-47%m!;ThkZUlh6GgDRq;qUd+GsrY9+1%07S%|DlH>3$Z@>1W#j*AEBKOwb=yHvMMpoU zuA!c#zMj+!8_Frs1t=R&KGH+y~j&7ZVtkPiXRg`53oH~Gpv+X?eamb~mufWW)WOV&wf zv;m*rWLaq*b%B1f>8*OxPqMLyo=5iwAJ$+A@dXH!l`aZxlSQCIGjm`0hnUxpX6d_& zrcuwEM57TczbM33TQeC&iqRc%Qf2Ffmc2e7;oJOE;{wnXIIG_|ize5H&E3nEyB41AK#Q-%`2vg?+vVIIuU zCd2Kf6FhQrUhBkong%cNY-Eo`4;gAV)Ut@pjeccldd=>=vH*F|{fNed^`+x+q_ zt&P_daYaSbClrch0j(%*&M1L zI8I60gmnRxL;Y5`AYmMPu%&D0zuK8~-8(*o%$n`%c@3vp=xWA@0R4V(f__~zh{BI2 zZL$AT^V)OFJ|;t0O1sS)MgPs`p_1hvlTyQB!sz-&vA?!QMO&2D=yOT;yK;_(Q+^G> zhMAj#C7JE71SYeQ;Km?+^-XuWZlpC?=)-f7{7`K1&_{{4u{>9K*5unRbk~=aB+t;^ zYBLsTG-n94KRb%_0l`kyNqCxfg>qgtSNDv+KE`zp(;GWkCaa`5LCQK_N&MP|_uc)j z_q^if43a}3zoQB7QQZIrf6Kelny_vei>*-a@@C62(eXE1zj`=OxKCp%vu6b#yB+*x z7c87BQ(VHxMDA02w2wLNqtkScK4K9Pie5+Au~a&n(mg~(QcQ705h`7Rr|2jL5FPI{ zmwgXy+c=SzP}pFt2w*rw+*4M0QrVG?~8n&u_y^|g~_7W zvRrN!QA)18NUq9S>b%_O=kPc*!a8W7Uv{E5(Sap4>qACOd8XWkE)r`Sqch}`6mUT> znS4OqmzJ%H+C2UkymysKv36YX3et;(mKjAez9$jcxiWsUqPg?4T-Zg}>p7?Rkws6-DIy_a+5PJDj^DDi3Lz zaH*p3pN#+4gzT<^N#q1*@Y3B)+x*s{lS%bYTcm5tqd6^Xux$-}(v*Ah-`j0iAMb%OXMXwtRH*ws%WY#qNo5((~2J zG`K{cjOF{RoP*IO*kw2O2G5(-4VQZeCwIV7Hd3S#26lFbgh0jq5u&3zn3&dII2JW7 zd=t4$K3%v1^6s55Is2sGncVDX#%VTWBTYPmW2<|ZCuI+WzP9x}(z9sN*jgc5EYxtJ zQPb}PZbLT|BAyLdG)GJj_|n(6n_bm)Ekhf%r`YqOJu5gu@Ll7oYf}qf)?BP+zRsy! z+@d20ads$yMF}!qM4b`HIMH&WE-_B%^Z@(!$=q|qd;Wb&fK)cya<(jX7IiX%;N=H4rP>5#VLVwn*TlU#eA={m* z6{TI^1Yez<5E5=ETdj+ew0tKGSwqrc$2U;Z8rU`KkOPtJDtAu(rVbG^!}#diOltD+ z2mNg2$TtOW>tz%jM&HPll+wB;jXutiN=?iP-Rnu(GWQGQ8sw_)Aqe~V@MZ^%Yo;_dVJ6Hd}7Sx^i3S}II(2za^sb`fo)d-hc=cifA{X@ouVzj&lcgsM97o8>mCIbu1nWo8SvT%Ac4j z+~$q~t=tptpOqDU7}=jU@QuxnN?A&;{y4Y%Y<8ghB9vjmf<2e43hY}A>p#75$7@O+ z`P{&0NAtbY@;%ov8qwGyR`#UuBYS?#viz(MHi5=?W+WYGeHCrG-GVT_eXi-!lqUXG zPWokNcf09ie$7wTRit+ikO-3co+=XJ2#(DIx5@nVMw<5*zU~#Xo|&zy(~IId?zT3& zN$B$VLF$qTi*3q)4mSGP>^G1nt6-LhWXtHPjKtOU=w8F3%MH+_N|oM(urhDnXE4!+!B zT`U$?Zqg19!tT$kr}N!=)Thg0^TlmM4AIl;Q;HVbM}+7%VGd00Z#Z!L)=#6v#>`k^ zIe(O|JZjame6{aIp2IWu2BGKfcFb69#tnVS7BT+yg_WMKLTjrQ&ny-EW+h<@j?6tCP2ix=-xvQ(%3K`oAgxr;vTX#tgSC+p7W))K8lPTR(``V6&|HnSc z4&|`m4HWVB=UEsaUHK&jcZHyw=PpHvFEj={w6HD7cuucQ55o$&!?C)9<7z>7-uaa% zl-UA%dI{|lp@#A3$Ph{RE-LJK6Qq1LcoUS(KhTN%c9V>GmQ=L=nVlE4AV&K)V;rVc z-(7mz17cz)SJ$5LWt60Vl*eHPYj>~kGz#G>9Q&?GRKK|f_sK+2c|BkH)%|ECLs8#~ z+qZ}7dl59-^im*gM<|Q5=jwZdT6t*Q885$~$9=&*voU95(^uAOoKU5V{>`-P6Xo^{ zvdsZJ=H9I9ASEA7%G20b&$gwSmWyjj%8E3v5t?rp6#i{+Nw%^J{A~yGZP*K16XiJc zSP|I;bpAiG^1NtxJx_KLNizNDF?OU3J-xC#Tk+jMkA18}6V)?N$;x+_ZiFp<)r3s+ z(F4I$yK{AHwKnPnV`m(EVvJTrtE#zZiN=~WHwLp!-miPLFAF|_2&a!i^hz}1v}?F= zk0dInK-w)rr?A@B$J_f4B)h-P#QkT9eWqYt%!!HZ+7Y4K!-H0#1p(y3%WXk$-p2E1 zL}$>1JilXFoY7;6&a_M`yi-=28L7Zlrt-1yj3_~g>P&$LiI?lBeOnH7M?yRvhxar= zgj_GH?GE`_V2BNd=L;i#m)bVRdWPUo@wU_Hf7-HI*rdQhBcl| z3NW@_jJ9AxSj%juKAablou98gXgeEjhJ9o&^O4i8YdJqVNU#|@-dPLHjwS0v=PK}9 zV!8~(4j40OHIUQy-lMo{d0zPIT85ObHpwk6`Lcxtgmym$(&^qg(WYYzMO-Cvyzt}x z$nPdw=`!c6b1P|YtY!?)nB2_cArVF=OnT?b!6b9Dag2U?da8+M<_)_1ZWu@IdoNZ5 zadjb$Ss8#eOf6X&EtyAMY)H znQPIo2w3Z`PgXVDobgrVc@dgxa5jQ%W4pg-J^5`2!<ElL*MBKHd`_Yimn)f!s=l?ubr>%Iit zs?Suo+Nv~UhS5e#Kb2D3ED`(1J~%qbA|6kCz$aIrmDh4Gk^jok)2AJ_aE_o5(A+W- z(F=J|HTZGTPPZojt51y#<;U(8e@G_Nhl|mM8-ENUBIMBa+*^|xmaURGbjrJIDCy#Qu@C{Ap-{^%g2%xg2N_7lFoekBzx!izS0J39B1uAcWy8O0ao&an{<4PI-z+pZfTgt}O`xbX0VYUC#29Pr57 zbPvingCB@*V;<{(d~=v|%wXg3SNLJIe5eK(MWRciEVzbYPnr|(?Uf%*|u8tyfJ;mQ<8IS3(EB2 zeAgT5Xu{TS%HI8hwSU0^#YECpPWb)?JEBQPi))>s&&Qv5qSv`y2;t6Om=jl9~kWp0ZbsbH1^&k{{peOU^{HzAwbfWN# z{#T_izCLLu`g9XYg?R@|wc;oBqlxIg0H|rVNWqToB4+>Z$VF#LQQTcYusER^ zBrMdTh;HXn203emBNp=*#n`pOR+96Aoi@P1?byks`}HZk6T_FoA=N5LPUhKY8YT}% z<3Y?~x6)vyFLmB8#RG!%H`;P!!Z^T>muO|%`t$v4@pW#F-AfEvvsz3zLyAfy26y)g zaDot|6<1cT{ZW@FSo^k5aOSyh0xs@5R#wO&YK`Z6pm3&O&bI5*)`sLAxPhOy;VULT zO9bMP&hX>f?s>WR1-%htCzgs{6l-2?fkgr=0v7P;-KXsK*7F~$IQdihrn;UvwoD0; z!En${{^(j(2xw<#ptR^p0EMo8)2VlU`xd5Dq!XzF?@%I!B(j%@9HXGr7_{z?9!J0c zgsNX>wid-nf%wL=iZov&WZYxXciLWLplT!TV7c;3aJq>@RSkS(?@KKiIT;GBCGYn+ zblB6b3;5P0hsbVeiA)=CI5zT=#y;2fo6OT>yfWvzR0lCpur6;p;T6w7)uS0v!kuk? z{W9xDggg+#!QX7m^Zp4tvz9T(E2D8i2YQfHSe>~5{!i4AOgX`@j)K`8d`wq}h$ihm zT#@J!E_(xtlob`SX1E)>ezw9m-Pe(;A9$ng@?A3IM)a8D>`_h`gk@y;XiT z*G8u-2VLEbQ&pUi3}Ikp{%Z_oa^(Zl7Y{X>jjF8@TKxtq0Hnv8FpBgEha zZ&TwDiBKDaHIc{G`LRe|Ev+HDx6z8}=>2Otzei*9*LUfyQs2Y)F$e2{&pzO9NP24d z(__e=^p=%sxh3oriXRAjbDss`*u2{iOHXCnv*4D>qU5HH2oyk@ds%ALKi7CjZ^4ph zc&w9vQNf9Y^)+gEMQ6$9W#W(01(A`=x+HOxs-BDps@)_+)U_(}AG3mXuaMXGAf5^f zJoY8MVogZWN)&v2sKZl8*;Wfl-{ezqH16L-j!G$FVobnf)Hs1)48 zq#LPCp_3})PjUMlgmHf?>7L!@4NF(-W~tD&($9YD`Z`U$eQuS_BVA}K`&cSBQUn6E zQM)qPu%|>nG{650+7WT3U@5yja}7GYZ{HGn^yay}zX4@9xp86pIf^(HX+UP|B&Qm# zefjN3;#B(QY8{Cur{RBOqK-r-Cmr zjM|ICP`@y0=<))3OEvbn?1PjToi*_=cnn+mC364@@Z!oGs$ zY7!8oe~xr8%JOy~&PlyzI^`-Q)?-UW-zK4E>3tUaZJm?!SG+9k8z0K0KFa zH6^S@==FwQZTFfuK{^VwBtAQg_jXsPFctf8r3Aj#Q9V_y8q1N?M7ZPly6cy1 zzIg3Qywvi7;jyrc=Zk^4olcTuMcZiSxB*18f`IxfI_Qq3kR-*;3{+-rAW5faG!fN# z&hLa5nJ%)`jAG$ z!cBARA>vuG1j_8b{wTe_;vD4;nSL94v=3TVzb$u-_l0#DmrYWj1>4wX zc;rHr+>o_naI2%pmVwS%LQ$=9wDG)rgy6=3>T-IO*n!|pQn1RGgsKo z1BC=1uIba3*T`oYb6=AZCoePuw77pN3n~0=dqPA3084BWPqE5;=vID(SVF9cV_CGf z=yZadALmn^naK{X@#`4)p^5cFkE4b!f0d6Qvzd!#9F4b-P3MdyA8JWXV0q(LaFE7tV zpN^Im3k$33D~%kxzQ@5VCQzai6cp5|vn60)U}!n%LcY4WS>N971BpD^zT2UsL>I($ zajrT!aeN|?iohbEyy0iYjJuWe^yHn)S73N=kYuOb`5LAXel-dal}R zFqxGMsDKGRTy0R((bbp^Vs&+OmCsF2O(h;JH3MnBXB`FE{zGG#0@t_4?Q_i@tcgsT z+rzBwrn?hAO0}v!2O^@Yw)^{0vB^RoCFGYSgmK7IN`AaZnc1Y^6{5C`nn z^|dw8M&~W9N<+~;VX}ZbHi<~Q-rin#5fKqUrU0*UtMziZ8$gcu`1sm&wy9P3$p-#1 z@7}@b>+Aoto{HGn+41quq@?ti?29I1OO+?6AmXu?|MVQ*(b<{u&6_U(3D%;t+4Ge0 z{`Qg%m{>>0TYaBHE`ZR=F|Apyo9cTFSvx*fx;$EvQBZ(4TVA4bbxUvA7_d|>4 zX>0Ra%sAWG8VhvV_;CGJZ9Mk=Medgy6q};ZzU;x4_vrZjKrBDc$ z@6}0^-S_X`rDbJ}yMmAihTRWlI{}_8!-s0>tgI|vK0Xy-4Pr=z(wwrmY^IfKt=|Kk z73nszKi-|8!)TNww)x$z@9#&})NlX`f2EKd8MaBoxGnhcdv31PuW!#T_NGh#Qf~`n zh)M8zGv0Qt8vY|Llg2NA5(!X%KQubi00KrK6-=3{u{hg^6{!w*^bbKJdD(H?{y0`r z(KZx>ggskpgO7xSbiO|W8W_gLY~0tV&>sbiCXmb_H|dMYQOXu3xE#4$3CIRU5coqb z83N7@Uy)4A=MjQoImWMpM285qLrm%W)LOg6s0y!gNM7~1$M4g=u8ZqzNR__bT$$V5RE33QHezK7i zwm?7v7`V8-z#L$zby+CCCKsl}4__S2VY9MUL}fQL@S20N6buc?#Y0eX0D86H<)RCx z&2&_eT7mfiJ_g2HAZ(zKO@J|kY!0FjaYq3}Y&AeBhmu|+&t?VtL+324W-BS+U*fD@ z%ou=Y3<9_|wI$v;s{*R_0u3!6;6(!@>nvcuea*@m1AG^OpywOldEbE5aXnhRPP<+0 zMi+_7&L*2GexK{K(Pz6*_u3@0xmlpIvlE9=ojw+3f{NCbmawR(mhCySkH)_i`3|-#PQ>9MLfby#2NwF)9x_5r%zycy3cKvH=#$yU7gr*1A zHEJUOH=jmO@Gi~F$jImpy5KOwywD!-h`OM+y|(r#J)P+G^0)w)=S(RwD(VlFT*)Y6 zK8U**ew^TXv5^IeQSJ7K)2KOzMhPxp-hus^%4MUGZ^Hhx&9LbdD}65QTUuLpfo(np zM@`u{T`f9{BJ@}m!I!)>oE+O3h{)l0J-0rgU?IKUk6N1w#AF1OsAe!SU3xi{25^O*0;8L0kZlB?d9^liiDrjYS768@FDQEAYC;XW;b=Uq3%C>6S2Es%9aRD97y)g0?$| z955m|z!d_oEtub3opRdE<5XSc#IGxtt+0@%F**5}? z3E678bWZ5S?lM5Y*K+9=dHshCC1`k_c^3hXjQ1-~CSJ#$$8Ar2)STuooC9P#{)5K! zKPgTBx6WsYNILF2OxX!YK0l#Hph?$lUK__uS#$Bj{RJ5T&}cjP{}p`wJ)i$QSo?pw zzIFWBtI_{4YUwPqTJ2~wikZQ)UgD1oiTS_m#CdYN{|3F7Uf=ANUSqP{*nsg~ufX7~^bZy^^`6lTSezv8fmyd+3K+7nvAe4kdir9$j1H)2YZnB{DqF za`fQgZ(3C7%>cI0pEbBXX2!Fe8Ji}u=tmn!Mwg7O!*wS0>e<;LMPb~AaaVNDn0Jpr zX2Xv{qnS}jmST%=R*K5I!_K9@?2#T40Y0*N5b)z;Nm810> zMboUk`#iq3$+!oh2gLvXSdArvhkN`i@0Z%OpQDK=_z89O*5Z{`kK1#cx0*f50nt!&@?*^rm1 zJC+N%>KA*R+oO)>^wcz+*h(EoOTX%mm&jJHekAKta&aXB82fb51vK8|W;2#0l)hWX zVKKHDPM7t~|Nf@*Lrn+(&zF}Bk2n~&b-zoM9Yr+>M*O#={}FtjtU~a^eU3UqSX9tP z|JthP3)JB2Goxj}7f6k_U?I0Xoc22iGL=+J9sq}0PWy0oOl!w;x%M0g4b=oYb4bXLaknAO?2h?o8Hl-`F+%Wxz z>P^&zkl^4dkK^U2832?4l-OPxFf11k?`k&cj)dzHBB9$mF#jn}za-VbRkrgEdQ@1n$SJb(WD3AtCaKk&!J#Q}im>&}iPkOzT#3(6AWKoIx8 z*)90c?EZSi|Mqo(QnopOy*Mp@eZ0FqTe90gU)LN$*9_3aQl!RcW}V(~bcT2H z!ufBL@{ff%YEwx6rb6|K|MxU@fg*|J1e`et0U!VBM10|Vqt=>$2n@KkH|e7Z^eUeL zz|QV*q$?;S^h~SOo2%LV@Hvp~W%oTB<$1#Gm6dOvfah+hCi>TAL1bSRi_a%bYX^7! zbfHPalmVxR^${NR|871miFsih+N{#GeS2Ok$iHW8h102@pXRYa*ytDcY{)S(fAQkQ zDgX^Yu1nLyq6QNH6q~Pi2w?4MVlA{7bK|uC!yFZqHa503S?07yIh^k#3z+p@`(0?n zv>6oKd3SxXUva5KA!V=Fo3U>im0rV)RU!ckUX1wH9qhrvg^Pgl@hgp;$;QC~qLY(y z3$O15E-!D#fIuq4PjeX0 zAoy$eJh7Q8?;m?Sqg97etWkS0kjjIeuTT>mH`(4^W?5qle|6K9Y|vHwo^eyqQhj9b zbKmG7>Axy(d97ECUBqc;pwS|)4n={d(*iFqjcf;9_Q&4mfDZXwcDaB)eOS382^A;$f;9X@| zC4frgQ=i++bWz2=BB|Zv#C54&C0va#U=UGd&2#qccFOH;boiH5qp8@|*G?qDqphDmYNqxi}t1!V%4{Bz0)1UHntbj{zai7#z&|`2rMiZ z7%*&XKw7MBOTZln)-0gOLJ%b)`&B!IE?Pi9(C^3t~SLUE2 zit~_s&i`Ha?~Sdyk!-L!t+Q4GGK83N_^JIY^g8Z%wlmRt5L)9%fy40Jq`%9dJvF}M z-P_R&TPy5MxnU%#Sm4bfp(>ecY@I)cI|iTOBtYj*_DW8Un%|g3@Fl(+DN-l%w@gy^ zyP|+Y=t5>qQ7fLWg+0V&2EVM<`&iGUSHKzb7Eu82c=dOc+U8LFu)BWPY!DG=U}&cijBHQu$beJ z$4wQvowo)hP6>OR%z5V^w|EP{YgvD_SYA&I(g0$BTcS}mlEnk&c6LAf3_Tq6=LLoz zj`hZgawM}vGDbHojW0Q8B-6ZTDrAm`S##a*&T3P|H?o?Jn<2pXp98BoD;2CaG$`d& zp*{(>eb98-qu1ka2Ed6i7ZLKHId6RiaKfRs=jyZ9MPCn!Qe6nXA4NPj+*piGVmcLm zcmtttlljl3oT#TIhj;FS*_k5@8g-e)=lAIFD(~%?z%I+ad*jMAGAH1qe3Mu%dW;J za%UJr$Eq`}IJ(~ad!!NN6UC=@)6sB--Lcx%ZY&1GUO1264#E|NvS+{leON!7BND)i zz~?DYJe-4lyart#7v#Ntd@x7PC{k1Cw%AeDYMjWhrE%s09w%>h%w49+W$;K)LE;QW%;f19V6%FV}S^QB#A}uDP8rH zssIvFGY_3;^a~x#wb~*+_q72cB5P%U03ZKTfVLJ6leCtT2*BHI_DieD2G!i=irFET zD?Czhv81R#Ox1;KF7v)W24mHw-7B*GtWjD*Qc|_vUJrPUMqXJN1IWE6FsN-G+&<;P zX=y_MT$lDI&6(_12Oa$z6%G=hkp|Iaee}NgCV^bzx+g}22TFxKJv~`;aoh}Rw3uS_ z+Z&A@gUh70Y#2+nA0dDGgW!+C#ggWc%lE>I!A&0Mwqt%;ju! zTly4{bijM%=3=|>wD~xM%Z8kvFkc}sm18u&-`NT+6gE`cXI%evw(WLLZ?DsO50d#v zN+*yey4uN&g_&(~V*(PO+xM3%7RSr2zPE?=|PjC?!&95-!h#7iCb8p&ou$}wh z<+)p(6fhdq{~V1e6ag)0)sS8b1C992?aJN4cAkY4lUd@WFAzsNC;@txvBU#5Ymc|uHtB~gT zEsu%Aumfg$B()nTWAQqz!vRqW@Tv~q?-EV)j~Zp#Dy3R%A*e*|onR8Qeq1-$`unPA zB^y84cXKbA%8&QHwgkMu?@k7Q-8I1)B zjd$16I-?=|QzgwmN{P2*1L!U-CJU4b)`GdsZ<5DzrLZ?YdFxsOW7-@|PsXB={qp5Y z2apon1@hT2GkP8*z#E5~wKMuufW}_z&v3YG%Wscm?pK3Y^>cYCuEltNu3?076H|V- z4H|B%XPprF)r)7QWUKnn^UuM<)M1`;XR`kwyv7m}ht+@Ww$7eQu6T_2n{G=(>X6lf z#&A&&OSa86kk3v5DlRFoh-iS$%EXci?M#;~%w3Ay>`*ni?uz;P3Q|x2VVLmU0m5K8 z1_sVs^;UYUb~)4TSfaw|A8A1UfBTsR5a2Uu$544Xcve#U99TAckS2c;u*0dUQE=jT zLph@}PaHwh%+3_T^%i3vpTW*Hy3hfo3?Pjg1Jsx>F-|}R8#nvF&q-9YKUG5x=4&JS zNqt7PxOT!I0hZCZ{}|_gY;?pynbxyt!cIBX&IO0`=t$Pz15W%#U2yaUr22kSoX*${^XC37CX%^ogTGXCf5#Uxn?d2~)zO&W-r%?J;FHPFz@tP2v z#HwEJuKw)3Tti4&&c;djC6H4-#%n2n)8_I-!+6!0#DF+F5s@Zu$fGwHPRzYGXFsd{ zQ$ABfc|M>$89zfC>yp5YN1n7KREh5zvTr(gn|Lm6=9y0M9rIgwezahF?MoHW zlFjSg(MET|uIcU#y*RtIXa9Ye%4vxwJKqY|x;%AKb&RURuM|@vjfi@Fhdszju<;;& z*D~UP@Bc2|%DBe2q7TR%7#t=klsV8&PsgM5_+kZ+k_zjykh3>x&mF!+v~b&;7IeXELwpGNO=UVwfLBMc)%vn^l7<8@oPrYU|*y!9|Q%q57 zvUdz{c@o9nonmpKy;)P#t!z@}=%w6;N2`}7LT&0UCGkUJ$7SZQvWrjYGacvsoEX*7 z;@JJ!JR9j@OZiZGcg%&!uljLyLYYif_l10&9hrWeE0SA_m&6l9IpqD_#O2Tsl0T4JT)U^OEfFVYj|gA?rsA?740+UmW%a zn0s5as#){FArhtV#aL|+!!a>E&0qii_(k8gR+Mt-GW2i-ohsklB&~1;W`adOCcdbJ zLekCxFXP=dt|#Zuzp;JL*2NUkezKRflInGqN>t^m8%}J)@{MssRcHMASsNa3Suy=n z&L36vS?nGH(6=R-kg#$wDCjnRc);$l!&17>^FHa8^fOJZ&Sd*_77R1YFS$?OpJDa?_W9}=bAPz!jMq5|n=&e)S z?9mt}t!_4jfi9`e^p#CUy*^>5&MEbGYOuR*U22eIOhYrWY>?NDN{kV~eJ6=DQayoH z)ezeDiJOkTO4}N_WY21(NXNu&kCEK&-#$}1wM3{U`ux!dMgiM^!t7&JQdRn&J^fg$ zWFSYf%q2kt59{LK?zc_BSau_v0T)`Kbt0H_77pQf?HvoHzp47#c$Q=Z%WSGhNqUGt zW>}BRI4N{JudAQ6j+Sec@z4Eb3}dp_*G@5MR25jVn<#CxLh>pc#$(Z{{N#wZHr;P+ z@cDRqTk(&)#<=>5ROI;m$;IoknIQ-|&8!;E|M_X0h{)8ai=1+VhzaTX=*@4f7CjjF zLKxiUReReu)wt{y7cw+YWNPUSO?^4~f<-+@5BsjeoVey6a!s8_HGxj__8MwN^_?W_ zS9VXK*UYXn#&{HuAPV6SkIZF5VX(8o9ZfE}_M&(Gu6R})oJ)1csHg7Z*sLz!hL2`d zLQ&XW|7Y&kZ^^T}!ex3tiXD1m7_8|GB*ydG9>>Ignrk$=zez28iPH6CNJz6?hWmC_ zDc;e742(28D137`)Hh2Emii+-R>VA*Q+N4Jz1Ep{X750-Bgl{%(^)7UUB<$t%;0o2Mub;GSjNCCN~xOd5=sG+=suun|hrp;5ZWJcA5I~-cll8 zECN5aF>Lfh-MwiAdtq}Dh(0xSZb?on!dU`p0?Eppb+|H}S0%E9ihBwlQu*;x73cfMIM^dal6YF&0(x0rHCM$l*aNbFEfcUyRNAWCRrAH&1kTCe8aB zCL)5!Pfp>ypC2?jCLI@SQB1b^?XOQ4??oom6T=wB7OzRxnJBw~UR2Az8-ZlYO>6|` zj#-x(1yNWJQy$mZ(@x4|2nmbgx3Y5@reMiG|FchG<1{0hXtgHeQ(*Wp6S~j2yD3&^ zHRY3bJM=Q$$%pG4s8~`xb_R9-XT}hj>8}Ug$LRU7Mz4?@Q=k*LYx4KIi9#QoC>tG` zR$y^GS=ET)$|+1dE(TSP<;VO9X<}H?3Qu{5xkC9D-ygkOv=1p>^4<0OhVPAXW~Su} znrz7fh5jrnwhNG)qe;>C`nc=`I_rabsR-lZ@Tj~j6jEk~hb>+WtVeqTgovCTL*5>0=%I$)GZmAiZ)o(*&4;l zyPf;22mQ5UoyCjeI(KCG7gPzn9LsrvSGv-@CvP)u6gIEw<3t zD_Z!Fo68)LrEhXPj|z7n z84@>WshDAR8ajjMi}AgR49->;*fF}Yd576FSe-RkX*9%86ufJj9`=7nhv_ms_pcU` zI;kP1EkZva)KKu<3nFCGz$@RXk{c3Qdto|Ox{3o;<-sSmh+i9t#8HFjaq;oqauY#@ zjo2LBpr-%X?YpJh^n4UaD|Qp7h1OL!T4VSTLf3GHT(Q1=dm~SNw}j*=u6LF1p#El< z@`hd3ix+3n1CDa{ZAP6U_9b9dNh~b@3jxn>d|pFGXP|d8h)UFR$PLfW8%PaZgkGl# z?{L?T_z3Ln$bvPBO-W=DrA3_2bTxxwrq z2KvqUUFhb1bm&*JbTqF#igep^9;Wzv=l1d%92b|YdQO~UN_dtsW}g#@WH&vpnqflk z?6maMtaBte9;)0Ft7A|dmuR#SSR(@-n}b4IBi=8_xM!biQVKXc15(L3 zGBOzx6UO3}-sPFL1Tm-y2}nqsHuf>1OCFXyvesClZK1eR?%DN_L(y0(>r4LM3vArl zj8rPl?R~S=t&j4NKiKOP<#lFN&9(}^lc|pn1;=_f45SWsMK`+_t~Khlyhb7$J~_^T z8Ou&@w^jKz0?1P<>y6%XA4Z3FyZBhoeF0?mRa~6H;y`h0c{s1N9#A=*Kkw?hjGiLnGN}Yp$5hQc zdMfwj&%K+#a%aNpK>faS?hncr@eai(W5qnp zl@}MMzAw*b=$_de#NsxKOpS5hZeD9>fZmFLV*a3S@MiBCl|nLSQ+MqIaG~D3xs2Y6 z8~N{~UMlC@`+R0-I75>Yc5h?PhX)shA99tsZPEkV=n*iM&;&6wT{E0bUqMN!O(Md4 z8;9Fos78Mi_4V(VuxmMt2YA~F{K%=MC#RH>6*gKe`!S){c-O$7__R&w`ye@w6<1xj zpI=FZlQSHeq(_f1!0L4yn(UVH0*4vpYpN-)7V=;l#R$2E0HM#wl?|9X;I@-%Kdlha zHD`LW;7t8hna*nx(&Ypj*@LYKxPH$V$qh>AerAM~<8?td<3-pV(|S8x28x>8tPVY0 z#&Pq`GO^$uKOs-}Ju%{qi|u9?^B6V^82~FkJK7?+WC%t*?(3ZzKw&(=PN)r^|NdBw zKLwx7Bj6IACns+Lu9WLcVnm8^Vq@>sI4aMr$21bpUx|8oPPN9v&g4Y$*}g?p^l`Tv z2Kk*liA6AYne5T~iwAifGPE!MZ0Q%jX2+YBs-_vzTTnh^+%*omo$2A!>;4psW541Qg&AM}>nRp~T6uufVbi#&_ElhYLexj&thh-wS*(SS>7Asw6mJ zTvh{-FlXX~k!RkpapUW&9ohQvFzmW+SWf`cBuSXWTJGoTR9&~5kTwPr+q^Q{t_)3J z_SKxY;@VYA&Z=ux7RN;QLVje|uYw`XlW4)qVyUb3DA6u)8$LsRaou;!Bbv2~5i*52 zIOb=h@I7*Fj@>cU)Uk3ciGhYu8}J9U)xQoTJ2D=N$ORABTwR8EuNJ<@W}P2oC!@%j z>}H7(aB5tLXE;i5lkZ*v#RLkl7m$=D-X~Wl#{*c{R#sv<(UE~&v3Ea+MT1s~ZW_X* zcNUY&r7LFPm&a8x$)~M8>ITXFoxqp+Wb_9zWdsxQVJUb?f$usda9?D}URmcCYvPe5f&#$It?7JhrO z)oaE$Mj=v|JWa!|E7M?5AWyWV$Tr8FpUXVlgSI}N(TzqE%2)&AmyGeq7n~|{$A3Bt z?|nr!APuTV0@&`sFi2NmcN)^8;F8Z%T!R^9MlB-Az$f|UsHytLj~BCb#Y^Miw5z|j zI|toq^@?s?Z<$5mf?XC;lJd`?3~Or?H^MH-SaGY>t2vG*jLG;==hhR~#e)9klZrrM za$tl~3RZiT;hW<41khgS?!(!mH@WUH-BX`X=osO#Py9E70B##^q*Y^=Wu@7klr#(KQ zwX*|uXShr-(lx}|lb|keWOA52Nz4?53KqKs(6v0_bf*TjzQ|@bD^0m9isH=MS&3jK zMOJ87QKRyHmJ#;yeJ{BWl$-|`}=krqJ$@wb-`i0rb8{)Z8B!}RzT*G*^LK1tLZrXU~Oc6euU-2PN9j2x6V zl6qLD)BcR>Nii`Mw?p5^UEJEWw*S=eikjdR%33)!6)?Rd|MqMu3X!wxbJcGpfV@RO zI*shxzp2m?S6_?%$zMVzs+<(3OEE)A^D%uZ)Q9VT3X1?;xAy zAdIu(0rG;1PEfwGwI~P#CzFo)n7dar*cc2ICuCBQ5AL{(+Mu(;m(;T%UeX2d8U9LA z2Qd|w1V={wMh|wO8A9juAVJps7wy<8$+yC;0brk@Z5*y1NQKX&ej|XyY^>}a;HCIp*~E~&@8@31Q{6zF)Bs{i%V)foixje`SVn-7VfPt;REm}Y*k?Gx3Q4t zH8mX%5HbKj*%fb;sA1j!_#vS%`b-NltQOAu7s2Exe3C6RzAEgD{cO)wp8e7WCw>jN zKhO5I?7>q!-#3>}pYa9`8qzq|YpNOZ%la(x%H3{#eCu*-a^72oRs`qA4nEm)cs0a5 zV}dYtszq-4yDHPq7v0?2deH9ETZj*JuYSdRyk_YIG9Dl3E+h0WdwD_xy4Ozsz4J^} z^`KtCv-(p%|Mq-z9?ZvV5L;beEy!Gn{z0h$O>59t+g$G^AU*|kY(oRPq4b7ZAG5yI zMoaM|2}IY`iN_IoaDWc>QSr6*?%ZxPi$sPc7>}!XN$6>=JrN_v|6n=FBh$%hRPw&* zuU5yM#VgNPEM7z@i(>Bw;p?l=6Q-+wesql8HFtZ>u^WjS;E7tIE0!`_&mL}xd@ZV&)%K&=guvS+oNDe z*~kv4XGmx$)C)BFp4(S|1}C)Z8NsT{2ZbmIJ4S(;oM_Y(PQhjVW^5cBv@VC^&^&*sH_s2v=5qM11T_OtXUneM&AB}OB`{CNaYJTE zD`ffBC`F&kGhwDph*i0N#wvPi)No5|#5X+pf4Bh4^|WniVf>WtqqmC2gJebXOhbzc z-CZvTcFiZOO@t;Db6Q*=VwytsO|H6_Z-`s079;Q~)6~-I!(9hmCx&XJt6J@x;9lNDZ~qobpI6hV2LQ-FSf#zJ>>m!Bet zS${fc)pd4fSn73u%BV~>DT|h28K&-Zv$>JtKj2`iUi@|*Z^zpAcY=&M7w+F5DOn;} zS+0&K_v-s-1j93Nsc70pPEOP+%p}y=5og6EAJz@ac9WKGB+bwCd34(uQ9z5}-~^J6 zesW_}ltd`KypYnjFxTzL2qdR5-WgKX31GV=10n@>$g!5+2fPmViCA?ap(52^c7^cV zK65F$17;BH??(tAno1M~4%X|_S1g45oV%BPfhizi8pzwEe2k5!6`&SwujF^cp}+$S zThFtX`NR2hyQMSEcKu0;@e0*Xar4Toe|-O1&X2Uug3|o>@n-#ZI>mN|2t>%MS2i2_ zAPqumCA24XgJHnjIH-cRWi0S>=0ulFE=*=sbPV$H$B*;m{3T8|A*K+Y0?2fxeYx_) z)c2L_a=_)q-Q!!i?E&v>0E%KSAn&l`MiceH1J1)980a?xy1>_T4K^O@p=Rh5dkd|p z7W(q@bk-*YmsFXk-hANuy-2f|SenaDu+Y4ldlG2I31TQjEh*^4gbqth$K016o9+!b zQ_;~ywx?ZF|Dm%mCa}{x9p7SMOQXS1?{rMVY-Ow#tvo+^X{&M`I{1n-IKnoO=@w)ND*h$x7sqo;dY;<-tSW~#VP9z zi|_s2^ZuO1L8dJ_jYDPZhNoXpV5g=|<%hG30&^iLdO$zBD8h4NJDF29y`!yIK%~3* zBKtiI5F!?R-vuSZlpmGnvd&G`a43r)snfVha?B-VzB5ZsE0FzJldn9J2mm?`HT7}> zgHmE+;?i(Q_xwA~`zK@g4D`&02If-@sTk4TF zAZZ~^Tqr00i1&Xc?}6Y7m`w#s0dwJd&$)v=!r88}t^M7Nn@dAej4J@~Nd`9Cb0Ti2 z;pXpN`S*wFF~)@C%Y@io^IjLtDE!5vk&WduNV2gizX)WZ8u2`#+4~zyyiM7Sudlm} z$Mn}A`3ZlNls}u`GMjQq#bIf-ogMNNFa9%F+NmArd0xaJ;YwCr7{JCCbzgDYT;e6C zmXfRjlAO%*C_esR&yAl$uLuEqaaS1MbA01q*08tzGil9et!-}f6Hr)`D=WV-?+zGt zvm!KJzQ=8AC-BcZgo$#9N{j{Ap!0BZ@4b?rWa;2^4#e338}D8!25w@#hcjcFi~Yvo zDzW`F#k*GAw&LOk^6*X7SIVDbWNae>CuLawD$I3F56ZVO-@ZfHj?Z-=X=}Wnu(~fH z0|T30ZyWQgd1EfuQL(!fz-z?*dJWR_j!)+?%#$;&>>GZXG-Lg%7|^vk@Z9@qVX=qe zO*+Td6};pf}W|@pMt2kQH+hpgBv4ziLl&_w{#8f#RUU}q~k@?lzIGifn;&1 z8saq(rW|!mwZa5gm9yCz+F27-e-`-dwX20zmq2h4MCLVfg)`9pgJcVkYs*SB6}TNz zOeX+;kqxi>F=IAS?>l20k48vbiaBL7yX1AH9;R)wnfH+Of-fMrXn<)zdL)d!u zd{g5j7G0|x{enrAF%|5Ji$9`5iX93!+r3j5|=k}vjsIg+lkm#t$m(kdZO*a zJJYcjm(1xM#C0S@cg1tjbVr>yq1siYPYR|5dj-DlO>YluwFUkPrlKEQuK!p#^Y}3W z*-@*2)cSB-&+8JsB4#oneACr5AU=K=r=c0U7}dN&9Y(oao~Zsubg<2LoO@#=>$0H< zY8=nKm8!s)io>U$9P!UlS%=>{g%wR(*PZS6QUuc9fGqlPpquhjwNN_;aTL%qd%%|Z zCo$khy8TNwvke<8LFJ}Qp-_^w0VJOf_w~DW54KK_@uG*X-TJhkBLUP(J{qR%jB1T* z`LZqV;yr%OAH)FfB?Qt$b2~C)cS+zEW8x*h>o=|kX{wI}7unqgKAPAb2rDo&M`Nwe z-ptfmhB*f%p76s+`j(QVTOaN_&BAORX6^2C(p=Wse?H7*l3LTVtHN1;r^x?R<|pkn zI0FXQ*SiO8F5OvwTQAp2x3Vk#>vbb`CI}f-Pdm*&dQdkq8PVz`N?T2FladO5bLfoM z{;5-Es(>?getI%OUIn&&>B}g7k?+mQ>7Dx71v>t4xG4W+FR|85G!PJ;I73=B+X=h) z6;rq9QoIN*u$+mRZbkFt*j<6qFTD%UV~5J9t%ov(HU4|Ho5WhGmoM`@k{7iet0^Z` zH~*s-ZAfg6HCKp@V*hNRC4_i^{K!wsf})_+%Zlk`W4PK7BgyT~2LqSElIXx7HpyQ< z^@#=PWerv?n%B9`5m%rnFsIK>=nL(%h@eAvB;m}O#{p-)@yN7mz)5Q)C+TQykM~caQ`>Dhs zY(C#5zmE8D4`+Qistk&H8$uEK(T!n1$+=s&xF-n;EyUW`w?uQ;bZu+%f7(w8Bl{zr@wdV;GD$K0@;)i5 z%(~@n1*L%FlkX<>G@XFWmlh+dkepbvU5=J4Ki_hj0Ubw)W2Y#fyrM!EeD@dqj~xwK zYU15@t`f1H?JxKoOuO93bXZzwMl7^-8Kx`@@i!zfKU$u_#s;V!#4XuY=YpFie~+Pj z{j!;VJlBEssv)CBi-lFG-4#gFK0c9~;mnUoSPuAuudx#Vxotjnty5#l(fNqDN5>S4 zm>j=PR!88j%ie!D&=SldRj(lsFD0t~`=U-)cTuI5DL9ljn?J<8iNt=sh=Ck#6d2Qm!+(NT*ntoOd;EN5 zwJaX@?*xPcTK3Po`sM$xiy>^rmY5 zI$R%{8}Y??Urc=>&wAiB=IO*TDDgEq;Ng7UA3wU>dPy%Y#_YiTg3tx60Z>dKq;rI5vm6x<7PgzcK(jN zY$s{x`vT%a$?LXpqb|ti`zuWW;)~d=!dU%D%FH;5A6>sf=9dyt`D3dMmha--e=xc^Y%nPUa~C*S zl%5yfzB8DR&iiWH6rN*<-5iJOIQOL5pk%e_-GApbcrSSSs#-G93`6_vn3(UutsTFA zK370mo{(|h+jEKJ!38=O2noPc%$ju+#tf6ZKm1jawbQQ@wi|OurIYF7Hl%nECx+8*K>=NG^Fn&F)} zwxj;=zK>~JGxCI@&@liz7O`;w_ul-;zK5gSohVDH5HErPgO)Aep_=yQUV%F$Xu;t@ za}o6FjA%(eu!S*By3S!5vI2=oRAuGhIgGq>w!Ml#q8=AgU70BWU`P%1D;sSxi7w0p%b!0ad z9+%e!>CZqoDR=w!?UN@@DuEeIUbb4MR#;6p_;(!C3heiJVO}b-EV>W1CqlC2X4dg6#bfrz%wML(I*^a zkII>=?g5!cN%(@@obmSV;msPie?>BJo3rV!81P>+W1DwH`bR4#%Gra$yM5%MU>BDI zh?uLYEHvgtj-ow&ayxQz?!HygD5kQqa!biHT%AG0e3!kc40z2B-`gGoNDWeBioTDg zkPi0;SDlwh%%*M>P_J?WUBTa+5Npp`pf2!_z#g}Du$y#!+#yO5l_a0!4=x7~0+4M; z0b*bVqH}(M?uXrQ_Td9)H`x(D=TJ>Ygex5r`au8;8sJ*KwV%Evsi&VqG7c#j2L zaLdLQ%{;`{_qPf0Ur%V_`Bi6!-;JFsJly+I8ZmvYnnBE%WmKbVAjja^JsIezgMZ89Tdu?e#!wl?TxGZ|u`*-1iG8-tooKytu(>nXE zn)5r(zn(NhkLpV6VA3+^Ts@Z^J*f;Ql~6HKQsH2)Ejzw<-et>%8`#`6yFg>ATa9Q? zOzlgQR+KkJO>kRnpZ&e*8p_wMpj@n=5^#QMH`#2L7NP$%j49#nb&!kL&x7fUSi-G> z^mW#Msw+fLd`W5TIRj&e=tI%yn40m z&Ewv!Ef~B@oVmp2S^Upq9DZ*+cC9e`Y~}M0OqI3KKIXr(yI5Oym!d;cpmY7<0Fy$H zwE%nP6A=RSL~!Y(U$s+W`OmE*9GrnJuNO%N8IMl;L#mR9r6lPvnxi(+wzyT)Z#teg zFy8y0>F%;`W+WLkL13S%slKw%^L*;HYOml@GM(&lY`@`L8N?AI^0X+63Y zk9GxgN*Vi0S^$+6O}Lr;x2O%Nz0tztV7algZZIynrUkj*h8jxs0sEIhq?%!2|P(1FZ$V{h&>3FyHa~EgSFgyGgx-95I(&9ZWlwf4}yP zn==$&L#0l0goiEhF1$vHrE03GL`>=#_kbJ%PJ8G5s&DG(P=NUpT@Na{C>7oV&2Jf| zj@$O0&U0w~W^RSP?CqIOK&&8eT@8BJrRBM^!`Sf4+^W6tqY~915)54f1`m9fZ(!K* z(laYubMl57W#;k9+1u&21*4qghh_i!8Udn4Y}e0Gx}B8?dqOQHN1Ke0hms6Q{IUUW=}PVnbRT#^sv%X2j^{a$X#O2YvyFT?i71oGb@zA0ZW$B48OTsxyN)HAHWI zTuS8k7~@K3$ShA<`i*W|+nonD<}Ou;`1Wn5^$J2NGp_}FtsXOk)-t88eLlid#p>~t&s>t zQuwuXD>Xqiqo!=_y8?)-YJwU^BGIi6FV04CoB~{y^YF3oxDgp z%viio(4Sj+0ER^$TvqObC((RY>t^xc;@2`a=Z72fw_$TZZTQZtGc7~6WTVtg1O!q+ zmjopN!C+RK*}qnhCJhuRC+4BgLt$>&JHPW?SMui*lR!2O`qAA*&cK+;8z%iEFe_QA z(4ei0*wQ+v@nUov3xwU33Z5O|**!gXHPhU9PEIu3btv$q?Ns|K{| zmvOv@gMI)=8jDH-fW7x~~U}{^a(V z)Nf@ib-Z59S&1bk+zG_CmSb64+hDkus=})NOKlCvXgKrr-BG!?v&JonHhgdFjlqS( zo~681dyU}$!kTsYj^H+&s3I_oxeER_Sa=kd;Z8Y_6RyS|?)jB0ehL64;rjE6=^r!g zY;y$3pzzxrG7M^;nE;bBFp%6RmBgzA9V!&l41jU-QQ*OjYMAfM13F?-?ejA2P6fo; zxKTWFN!s+fnA$(+)=JX65u)nH45)ZuEa$!!=qk*3n$l~a^zf?`KtzPrjqwxAjd3pT zE^;E!PKaHZ+I70lgSGG!$9f7ZqowGB+_R8CQ6mC6=0y>AKG3R;!G(qZZ5~@53t$6| zNUJCAC4twNxMa(~W7W#)bF0k{qy^~-z)f~8?FL8Vy$D%ZPO0a0wKv<7miw&<$Z$qS z0eA*wtmzoK7s#vj!;c>%PX=E}V_sneSy@_I+UkY)CBVSJB_$AS645yZY&$_9O3TC3 z<)kUX#O1|Eyp(>rGFLI%U7)VJoA3G3F9GTYWSN-Xz2$q1Dwq(L&J&LA%q1vM1G7h3 zfk!@WE-O#{Z4nZt^bnU^-odX72I*vx?fBh~Cg&O&8h$Jd$72)HyBIpYQd~ri%anf- zX$?aUpj(%=Vj%6bdB{3bJdW}s0iwl&CK8}{T;RkEqTa!| zZU})R_f~IqwdyI#jbG@$f;Mo=*wm7i-h5U^rwuCrc@+WYF zg!tOoD{5?Lm}4_~3)G%X;8 zkURem7XTo{ukU`#J_E63&2qr7Tr4F_Q}gyGM4eO!AhFpToN`&|*7tK=>!@$=2N(u6 z+g@n(Xyxd5$wYE;GN*YLGo|aqIq)m0LGPtf*R}d+-t2zS{=`sz3^X(gDYhcRt-sKE zY4&AAy6X05PW@P0uYfI3cvl4APtZ-DpXL$wqc3W}yQ<=<(6E5=D)|6t(z( zp`kT?ykhPZGylh<)uT1oDf(0ZFH-OxfYxu8=zX%-OG?&jT6<4_9S~6V z-2~A6>YcYIYo8O31En=XuPkb?#JOZYPj{#p`hVN?LLz+Z(>RyQ#e{4o$*Iu>d(MsZ zkCw{4wem*_`oVJGG|m%0s;84p2_A0Xt^vv#pO(4o{;a#`4hgj0ifBTQwpFn&5NTGv zzk`du>+pa^D+xRj$la{gQx5Yz!Qk(A{t;m8k>JHxvO`-Fm?ork>QU!#2K|DxR>9_P z?L%?MJRsq;QnxIaKboBa9n|(JK-oE_p{|*h+L4@C=ukc7qd&Bb6(aV}X9Yz++SwJj zL&{KjLZJzV)u&EmcoG$ZE>FnFa4I1-@_X(TrHkGgU<6td$9m(dxTu!g)^H=YivN;k zcvHhrobd8DS&#qVtv44c9ODTN=ly_3QR{&+7K48U+~9Qe>rNvT=%n$ga$K&yId+!_ad1i*Q& z=h81UZKpTu$}pXo^gUHNFlJP`>SjCMf!ks!DwTlgOS#+E)~1yD`V0%*rjJ61*R6;{ zlyKffr$yCTWFUDbcPO^j$4B_0K2hA%9Oq%2|LimbYBJs~!jc@X)gcCl-~qyo%WfO< zXcIT||I{^G$KcXw%{(-FOmac{VZ%`MPgOVNNIk9&%Z|96^#opWJd<%Uu0or_+u1kcUq!+PQ82O`g z-lyJriNjYcU~4vbb&R!U22biVe8L+#G1o?juD$dS|J9%`%lBK*G6dDs^WcjNCb($Z=|&|(ph(W$Y&c}{=kIJzSi%?HaOBX` z`%Y8L;1IG$*yS|(q>m?zcS#tg`~jp1;@IFo)e^69;-&rM6Sj(z8XDlr7J1=&uZr_T zRdBsqe4B)wV$WM}#?66p6^p8_rUw3Sja8@UUf4P=%alb=&SQmG0rbcPn#yLhB?l}h z1l{X)ng-NiyQ-KY_4Bj?vY#TR%->Jm`S&sGmM@oXC(YI%`OaAlJ0)4^_T=2eG8V2z2QuWFNJa&F00L2NcQNJ#uABI`$ z<1@4YK`^b61lEY>C%IQ6mTj-l$&f$vt&T zY_#9{bGynK?`4X((oJk#*y=2+D=VW=`O(qSb2!c4-C3XW1J7$T-Ko*!Vn941-+4(7 z=9C!A8yg6i77|_iv1}^MYc+u0>*0D@7v9MEaain|Fp-L}+D+CIufA?wYnx8|Z;`?s zCUN9q)1H#n)ufo8!U5Ns~fpabwQus-_9{PN5_zE9(L{Xo14J%E!vwa{5b68M=hqh z+2VsuK=hsg0VkqLS&lw*k>J}E=qu406tq>$hx-x(0|OXaFrUfDEw3%q^!4!phm7T# zIA}{8|*^6lF)klzh%*T-Fr5gSIip|D5(IqU%hIk-MKhu*3?06 zy{A&||H5ZuAwiaOYvjZQURG5c{#)cn$D5x%ulGf-Mb{@h@h*DKi5Q@g2emiWwc7)^| zK9ZRUIi@|td&SEJkh8E`l`Na^-cE> zmMDR)INts0SJFTqU#LyFpyhu!@eq6gGVMk}YZdd(2c_=`PWG<%vMN{$pirXLA@7v% z2C32MweJc;I+BNwA&oE%V_-1BT*I++tBEan-%)h`eSvDe1$G3hu=~kk0*Fr*+Hiw_ zY2U{g+U{Xs7^P=ee{BI0aeW=$!R;m}o7yuBvHM@w3Z6;q3p>t95#@RMRk&2bOV}>A zR}~-i;c!3XI(ags3iaW^$lMv=OWe7`?(wkCHwL1SgDLlb%c1AiVu>-^1SGRqy2GFQ zOYaID-32G>022F8&Py#2f#bHiCeFO!Cr zFF7^)Grq9L^qwtoPR~@G>q>ojjEwsUlnFcQqqfF^6oN^Zlniv0VBwG%wLV4yU)AS2 znpv7(x2J@E`gA1<6$mEq1VluJ^*baiQ*iG=5a_vb!8+9Vp$CkZ8sdaYu80vxa;7fE z#19`JPpII(Ql;^~rk1G8n!(1!rFtMk`!RU0iBDPiUN47QP4TdM%+*jb!-0y5*?QNQ zwQ03;(_6M6Sd8Mj?IjfAc8j4wG$CLjE=S_nv10&|2(55umu*BD%xQm&T?%g@7*AUGKIf9n%7`T4*VjyV=h$olY<}M=8#IBEhPhw zIxf%9$J@lV;6tgS^ZV}s5f}nKv#Do`AxAKSA|;S)KTA=0!28-og}GRS@MPw)7;}Z}yC_Tj@p+Hu$VJ zq++5!M4g=%r9!&8QbweJ?(Bx8N!ty_ZXZ9f%|%7l2?%~IEw5<(W@l$QnD#xj8(yjw zw6_{6ZGg`Sw^}IjIWJORz`>AYW6F4=RCdddB_zxz9ovTmr~Oh;{k`{t>QH(Z$AjUD zh(~3sBJq7zedr$zx|oY>j=>;p#y4htE^{1T= zSwtltf z-F5d63*bl3;o)Y82jAY`hI)3UINvQyu>6e8>A;!kWUg)Ub z{hIL3FXfw}TH~f-Pc}bUaIkbqCPd{{r@(5rh4ShijP|Gm5?|)$})a*=E@dNGY`3o0L-vHZveUEiw z0LW{%e7e0xef^Fu zlP($NStSXi@xJgiRt3i~V7r0U_ zHWk`Q52{0$=E3@$NRmTVDT?mjg`rE0bcSt1ROm++J}n?6O+5(X(8t;R!fsp=myV7Q}Gl9aW*lZNCe zd-%9;b8XOi$DuQ@9sKo@b$SJUKeInYA;&3;%b|mUOGwV@54W|%0JaX-zO1)#YiMYA z9_~AXw%lss+bwT1D)kd1ZJU15#bIyx$skq-(Fjp|a>f!B1;LbB{Z(ys$LSbR{Axc@ zeQM*cG|QVB3~CY*AewvX%L+N**;%?PSA3x>hbUmYrS+7=9;$G35iHgXHs(|D1b|1(35f*p4i+B;WgpMYf>fcRO&y!~)9ZD;9EQy*&%5(Ee+` ze}AYYl|S6C#iA-HF8&G(A;26h!-6^B+YEVZ>cWLaG7t*tWB56tefbPN=pfi>G*!n- z6OTTRu6iRmuZw2{ym3h%`y_TA!ar7)&f`>-PJdNis}yq>Y*l!g<*Y#MeJEUArFxEm zRlzbb?M`*>&)S=2JWaQR2fF7eXcG4TNPyM312>waqcC}(aF`-Bsbb_Nutg~U)$XtwMxD4)WqjL=WJrBM4EAlw*1 zEN?7PFY4*4Q{Q{;2*a#vW8OCAR?u(D(h0x?qtY7;`6#Xg08WS)l^&V4Cutg4LTE})nr^|{YNCE*v!qRsOq=+f?p)~#Dr-d-T&f(yWCbU*m|`mW3* z$LAVUWBy__q1%~w&mHj7I&k~6xX*l+Wr{-h;cIAM$clX=B2kFu4LkbOOZ5|B{y4%+ z7(Zj$7!@|Q8I#(|SX=Iu`My(eab_efGwnHciL-B9gDbM3hf^rIrXm?@)0yC1TaBJL z_=L&F3WNaxXchbxa_@aUF0wsA2sdM`^mGrGx`qNm{tBv5zpT2tI=Jho89Kb%a&mNl zEb&i5ZMiBw)00|jovoxsv@GVI^|8*x1`DG3x@H{lW@N}Y72 zgyRg0RLTE9&|nHj{e<7*Yr->Z`1`?YUstGe#G6!Kd!Yla2>7 z%8q3oZXg~ga~nN8z}L}R7DCkqsA(wPjqFq4M!cB3|8t*wIB>Q?g(AAYfS2p$qAvLS zQ|YX&uF?ny>;!kyU%7JKX5>baLhN%{vI;{q>kC|L$&8JSAz`9#_X6tN%#I$~GX#Lt zvnfv=0L&K&idO(kJq@EH&cWu!fGfG+lckMLPD;R~UuZL25s{(qM!sP}sgu_geT9fp z)E-S#gz^i`(?40`5I=ERP}NWfqL}4MtCt3%_caaAm0jzB)BnfSS4UN~ zc3-O~DiQ(;(h`CqA=0gcfTYshA>AD&h%_i2A|Tz}(hbrL($dl(^{tKG_uk((#=S%T zaEx=#-p{jY&NZigTWy)0vFK*O3&x3l-L8LYh$br!jn!(h0OUr(Bt=wI)X|cjkB`*C zVqHXo8+txie%%^kV1SYy={$i6b^wrwrInS_w0)-G6c~TOQ0yEAA&XZ1d+Y*}LCnDg z-kPaP1S;*|?}lYIQV))4QqnQU|Vx z>0R$JzYjyy!=?!4@7ZLtUD@-~Lc))8b<&1#ZYCLw%yykl?@g8~#z?W+rEz7sB5AQ$ z?P&MO|N7Rp@aX7hB;j)cTkwsEh(B>Wz)k@b_TWheb^QF};x4!r$N){SXUJ=HY3XT8 z@SReq70RZ;OcM>lqw_B-2?=!g%QOr|7R%Q2oolEU44GYaO%W0SgrtohK&YXI`UVU9 zE57klp0b5LzG0^DF`98<_DMa)iPGj}{Ylz%ZYs#>i+XIp4Sw(}ldBCeG3(h#u_+}n68A3%q+ZhuD6&5bILV?4ea-N=8nT{%WULf}Z+H{b2maTNQ z0~`QI8km4*&q{;&N9?Qk7)}t90Y%%rcoSgs-GK#b00Rh03vz;!3wa`=CHiiCaYw-- zCGzEz_kW2WN)ByWvTvkEOABxm!I}Y-4ZHZ?q~Et)Mg^Ti5KYZDSiCkhv|Q^m5b*>-3EFPZ?HR!}eSIi^L}syJR$zMv zD$SE1qcX{}Sz2T^+5`WyRGWip5|$f}ZX-JAJZpCkxw^V?0Fs1MLEvQx%n7(M5}<@d z8o8x=Ly+4B2#|uADuq|j(d+B#zzawk;6-HY-5dRYo;V~V9k-u93-ennccb+pFdt%7Gi+-L2T2s(bKJm?wAYTZPhE8+*5UCHCj`t8W=ra-oo$lamR~H;_1*AWMT=;5-0h7cX5>c2(%e* z4xpDGk{_JmR7FOxQH|&vs}vefL3n_;0htF2GT{tB5T4l<8#+=*!ScET7LhaZ6eWhd z(AE`hZ;3~Ej}SE+j4zx)9v2GjjQ1@IKcyK;%a^o7;XesbsC!?1N=nB%Z@!^(<%*2k z=g)Wl;R4hJcg4si%PD{1K!!V4w9U#c-&U;%mj#Y46w%)xUcLA8n*;dnf7L@$7#<;y zbX!7HGLihD;-!<(7)l{7q;zh<-dz9r?B^H(bZpNO`T}P@+|-_eepzn(A*YRsK_XS?JXvYLlTqS{uxclZP+jinaj?&!x7D zIJ_>qR16IMFnRoXPzIsp8B~zsjEos8PO7B$_cGfjHe3$2!uU&Vf8ZR@E->GHIQ0{$ zX7sWT9M(xQG_gXcQ@^04M6hO8W1^rwDl`sV{Rpxdp6KVLrR@@(hVw$p9iHfCm(mcw znf(ijLDBU9#23Jz6P$w*`_CRr2>2QT|Nv7nXCH|%F+Wc)cn@_R>CHID8ckJ?Qu9i2V}+JjL)B;pcFLZQIvv`N(z zK!%trg01KIL?_=eY;@j8HI6F$7fu;4MuIuqdnKZpLft|1_fPdMB8Mz5?8xWC>i~X* zCilJNWHio8*V4X7$=#3$*BTb+Z192MMS)2&D$V-%{ddIT`C((Y{xJ7F18_bS7qbI< z1mNYmB@=Nbk;FEi0v_jmN11rTOXqfdCv+DBg;0@bOQYIVjdJ-%2fO@~!C4grOBi!c zIot^O_8-~JE45B~2u@Z3GUNZ?bOtM@);pRYICCM^()29a@{*I@X&{alE_~c?X>CX0 zs?5PIHU6E%|GL0XWx0cP0~%ODz`|pac>hrpCdrQ$vTq!W(0tbB&ifnAfIY+VR1&uu=^-`lxIgwxN8KDtoM z1pPUL8+U!M9-S0JK*-Z+Km#=dF=Jy|hzrT!ItEH!xA5@=!|)V>V?&z=-MYl&kZ-x|+*+EG2W4*&s#WSy$|m zEuDC*`<>WMJZot^wLcH7NiVNglLCY;nxK`8T{c0?DiPB|pGIvX;UoxD1s0RBAQ^~B z#@7z<>E~oMKfnt*fUYA(!td7IfISNWdpxx2OZzRc^BiXfAEn279c*%>uy7yXSB@*_tQpS0x*0%dgSVQL>Xr>UdD>B{lV{XWwbZ|S{h_S z0I-{|2@AnQauyaA^-r6TaeY*#+P6g9Icn4EG#Z!#k}oCT`qNdG(g-;#ai0c<$TR70 z>Tx*BskeO;>quUlBm*%5^Hs?xIqYPit3#!|n@!<93zX|_{~NTk-lUZS!GNr;?Gec6 zgg9>i*ad@6Uu0%NL?oW@#Loyedw@ea4Zd^EQ!bG(#G9G93jU`Mow3~30R2Q}q2OH^ zLMeg?Pu>&!YvG|kZ)Xy9o|LN;cb5Gkc~vTdtLDV}@Wq3wSMMlbyyO1)T1>_#4_I}D ztqIxW+Wz#V$bf)I>E84(XY-G4hjQ3Wbtv;)mk*eXi4fQo0OT_)D-n=9V>R<6OQW*& z*Hm4p^A0WG^GJk)quCh9N+TI5WNG;TrpL+f_~DG=Gcqy?4&a1F(8VPSkbYoc5NOT3 zA@KFB(rviV%?Knwx!GmvNv{f8+IQvAknI46&rUW&RV40*7-jbIqv^hui#QcKpaURduFvd4!2s>q=3y$Ey!rHqh4pop{Cm=-o4E72Zengd=_f%$kOWLaFW zM}`{q0N9R7z~#oR23Ul5bAOM>lgHy|3;ZROX8Bn8<;OY6Lj+4~w)}V3#bZZLY{chc zdBPSLH;*QJT)OIopkG$w2x|0`e@r9$RSt$EQn7Ef>jY9&6=MkX>-X|Z2FZW#g0I|X z(V+adUUeqf!;Pmga|a1sryY3HK??-S2gjKVMK}RGT^wC^_8vCcY`985oz1)lW;Lmd zV-Ohxlb`VVK#QLXb3Wj@-G#ywv7ke2X<@wM(d|eU%!mObH6+AE z=z+SIZ-anil=*mBH;_)BhSI&5eU3=U+@hhOfho`v;0`1C4+smOA71s)b=7xi^3&#a z+LkcM{6Mrg&;`;eG~dxpDAQSMPKDD&xCroMZ_iFzRHr61;4^xDykVCqa0$ZHXwi>( zgPKQVx<`(G#`T95GlRIH|Gn+P5Sk=y?4`h?7y77grfj{RUs+u~x~0-iz@+mwsMtdY zlCd&a=8?H=VrK+s{zV*QtX(y~l_j*dM7_!BY@26`Kx{rU?*~9Y} zL2h&``{{F8=$7Q`hf8JEnIk^inaJ0tJ`;2^Er?*2$4+)}kQa6Ke{<`tU*NxIa_9>b zys(}y?3E=fEDR(8i$H+kz-n9)w68E!C%@}R0jLDuRtu_77$WeLm_LlTa`kFWT^*(R zUbXXS^nk~Uv69?q4gIDi|FpJ<4nq!(o!gI5-ZV$Dr>_M9DF1G}?9$eJ&BuF|zYEId z7q3Ebyk3pIb0AUSz%vcV_KaeCph+hLl3e>KQCf97L%%CkcQhNGa??F@}fuGa?bfdc-O|GBY4 zdHeg02p0~)B_UUQgE2k^aSe#MWE$(A(oF=m@px z#&j*eyo%YyBQbWs;WMepfr{j1UWQZf3-Bk2*Lu9abic$2_w{Q4XZx|i*g~((z||FG zs#izSD2+~BVHxSd1z%0YThc(VKuBi@+>s6~pCGjC-hO^}=;(Z5cSYF@nQcl*Ndf$W z@&n3OK+XWJn}Vm}=;VYnw7Puyu6K_OUObn5eqcA7joh&JG-VFbc2yO>Y30%``ry49 zMz^Sl|3G`Vn_APz;Aw8E;7{fSYD9HdQ(Ilyz0|N5zHfI{2R)1gdE!u*b=w?l>SKb> zJ4~vYYn1K?v3B15$b8+0iE5rWQ!t_Y;51~B?T6ujUcKD2(Jedmc}Xg2Q`AV<|A z<9InTwV3DzYZX@v?a5g=lz3TS#wR_M2kq)Y{iQDcemkgMy9G%YH9o)GnJ#rzHe2R$ zz18Rod+8a)ML7&Wh&f}(A!LU%*fSLo9)!F14?|(DoEVM}b`};D`TnhTIO6wX4&&>qz8vyiz z#fJ&BT_{Ip+wZC4O)qMYoX|>TNxh}VocT>Qi1bX&Kj2(olE@*&u6#4>!zpCRq4@Lf ze=B}3Us zU+M6TriH^?5reJ4z@;1v2(B@(@`!+o6 z%;ZOwJ-@EkiGKC!QUP6%6++SbQ@k&PBgTIrVh*>uRzsxuwBa0rGV=E{`TKv3?BQnS z8WVe(=L2tyoQevp5aUGn@NeA`-CY?*pwCy`^Z~5=nJwL%BAlhasT46a$zh!5nMJeW z1%n96J5*4uF0rIQ*HUOY{26*jo{ha?cdx|^Wn=Mv?)68{gYB+~*4qE~8v)q!a{Q)k zbWF^Pp&W9=i2iWB+7Mnj9e4#nD8apc{SoXWBd+t%u(GjW!oUHsS%(w)0^l3U08saX z3yVo%GLa#-BzyHGNu7g{|C1|IKN&RM*1W0d!kX~VylIVwCnp?}a`zTH=FxE`5pb7e zQmzy8q!iis5z)LOhPWkgMHTRA;2KwV!X8kG{VE|SG*iQJ6C4Ry074K963Pt>@tV;dfTc|5%!8jgT~aKSHFx?_A3VeMC-TomafBhxwieObC&3816H$F{UIk3j!_FVnk z=Fgy|8RJ-c4tl?y2lzN&ieyX6(=#<*z4D~L zvl0kA!hh&H6L2xU13Zlwvg_$3lAGL8Xdfm4XB8dQtrVdKkf07P658 z4+YjCfuz<2wKb>Zk8^QuyAjxJXc!s&n?Ga6V~pRVozKx7!hE2rudH1M?LAMnc$i#n zeU~%_6Q2$0g$r6eRIFIw3l&!xsM~T>?n+Q*`wBJ~%*R0(;oj`~rvIjwFaJYsfz}C| zO$c(k*dD>}!3Sj&BGZheo~>HU0QLVDX#HGas#{WWtE^32=@qLgX*!f8fi2`}=%vkz ze#!SnGE({n@QOr6%o_5!oaM}tRPrvaO~?;Idin9lsQ)R+)^P=0kVmn3>U2-*Cr}$~ zkBeJV{eb@HKgk7Quk@^x!3^~(jOk(4BWll9E&*Tqsh}sCGsX5Ppr$Dns-&??9lDj zGH5W*Zi_a7L4L&h_gCBx=J4x0Nl&B58=_&^VEQyXUsaO2_YDD8?TK>vT<-Jrr+OVx zpVF(<@3<Quu~`8%+M4D~(Rvj#+_0 z^Hm}+@Uy}8l?|T%25BfAok*RRBf-?Lubg)1l&8Ze!11B%o7D+xRh18!A zdQ-t*HB=<5ouQBPS(F{`V6NLw`=^i!z z0H`f<@G>2yE1%e!2jz5Qart8N!0?o8O3@+y|6EV{CDF~1bxYM64DNU?5}UfUpi@Lc$*`x zt!?~rqxN0k88QAMnR^N<+A>4r8EG73oP;jUwx_a_{(bT%Cnqn~MA6XEXF){K6W<1X z*nss#4;8f0ar-%qqz|=uNazEk7^GN;C$GO8Pp}Vhr0iZ|x^kR2&NlNfN_$xW=8CPM z?@DdR?_2`sGF}%*A0vg#MS)udN26u(9ZSlkIH2-k(D_loKL`CkznQm$pV<(QI9Qph z`?Z69Z~ncnpkkYDP^0i&x$5fhKSHgC1Y~V9n~W@S80xVP&b#lQ2cv9(cfJ84dc+9b{?9OvGwY-3y)r>ZZ4l9f z(f(Xb-SBV(L}Mf)KrMi-scFA@?NIME>I~6?gd=o>VV1=A$uYHAyet7n;1OIlP0_I_=*RBQo&Bi#*b&P$C2KN8mfb7Y!QX9g+0}K#y6E5j$3;iwe3VeLgrJNW<- zZULuLw{dK5U(tW#1;>b=1K}z|uuwrtxoE`Fa9Q z99K6xkyOyCDYZ^L047M<_rDXEzoqVq>VBT3fntng`{FIvr-$FSWTZc^-B07D^C|aW zIe_J**Ku)iQ_EsZA{=iOC)_Ws2TzP0ZBbuNCh3C#=rof*i7d(+lnZ^S(z&@y92@=V z{bLatm3>w-MSxP@eJ(`8PKteA(*uJck5d^r+|v<>6O#Hs`b5|&aHl@H=d+9pmT|Y= ztA`0y?fCd{OLXFvV^pD1!`^4v?!>itjk;X?4!6NaCzc_%YR zX}94SeLvUw=?$5O9J4hHNt5}(zcy3lRet`O=qJEYv}Weoel|`CWCYT=%?Q%X08ZHL_ssXj?EIXH%X?aW#D zQmC7z&gB|~e7TXK7-%!vmAlZ!%M$%v#zD095i)@_19Z!IE3 zA(}iz!;n|4R#TTh51XS+)e3)x*?%L=aF}>}n9_hf!N#)3EZ zHBC;Q1}y_2jTqccU}#EMR%JVXrAhm>rzZPF+_&yTt-!%v@)v!Nevb{Y4nf0vo24#K zP6PfnyoA7lh_WzE55&bjpQ&1RnJmSLL$!#fG!WS;xkBEf<@rVy>tXUd@pQuUM*4hH zx!0s!vw)P!T37opAYPo-vkzQ(AI^Tpz2_tK16+vS-RLneGZr!1ETMLCGrIrD$LAVAz|^;I zf1_On+<}8Q`$*%W+pT&47IXA};7ttgVGa%PQ@_h`Fkl9gh?%CkEcKHI@?~_Gfx+BB5wsOOa!Mu`>X+F-P zPC7I^sDt0?n%?-3<6l)J{>n|PeNMH5S0pStgG(7CDhxX0$eVg)VJT@#TB+na+ci#H zn%7ZLv>fAA80*z>Rfos|*uPwbQ5(hs(x^iV1L5+UR5VnwUj+%uyzILkydze<-9QXa z7C=EL&YTmL&*#{ER|uXCVG*IC>rk-idUouRVg;(pq?k^dDVSj?cjf82_r1KEeotM7 zg)H%~9|QCt)=p=m`G*AlH@z6DPBS(#XYcX|B)^@WT@va|m3*-!OEktaZtE2qFA9$_ z3)xhMBy`pR#A-z%ifuJQ^Yky!ti*$P zcA)1%MM6Tnzsg3vzA8ZNb={3e1upSxQ_el&8X#^CsLGV&ER~6gz8oopa{tOT+2lv1 z!#~JCSN#&L!drlSuxCIFo&lxI?atYD!9OE;_f!Yj;f+O1cjF`6;?puoSdwwtYc8Kn z50-W?Qox740Os9s%h+UO78@LT=ki4HRV|#_Rhbx}#s2ZDz0TCx12@KFF*-i2(Z7Ab zri(P91GY7MiIUOC&q+yr&jP!fG#%l}4c?YlC`&(W3=LuDnO5$BJ@5Z{>dAwXVW$TA zho7P+-AE;5T!hRtj<@9{Itlj36m%PXwZV&~>*zNl7+6g+A@869-nSK`bXZqxf&_PO zxF`{BQ_eky_1e}?Y42@j-50temlON3R1^X?tzeqKq}vzt^K6<>`>@lT zw=GR7y@bS#2ul+S381^*ietvw- zqU{@f;@Hz};-H+1F3r5E4$FA1dn7mL(ZGuojkBui*Ibx!%0{ACk!o|Py(ET?`S5eI z%hxap&B;anPZU*-JBW>lsdGp(lkYBu`1vS%(pi6B0P`hW+_kl}t{qEz`yxl;v&_Os z9{>;hw)6p54fz`Gg*`+c#vT%18~*as2-u@`zvY0d7-*HN^T6h-^GOR0aP`;j_S!G_ zFX7QDVjB0q4xx#+Gg)r>zab>!{?yY8`~#;!;|YD$QO0fxKAqLJjm*W#!h=i^65$dA z4(STckX7}rP%oTf3Zm}1RR$0xn;ZFyURmaL!TY`aOgK7-5|nkJ=h`v0o0bhA{jrwC z-P&{rgjPLTrR!N5@`7i~dh)k((WCDE>nPPU){0c5e54hHJM_i@DQ3;C#Amx*Mf+~d zXlLgGd1!Nj_-w zFu023acQ9UF)p#vp#YupwfC?#Q+$55{UFsr3v3xxvvgXy>cF+{ z^}0j9ve#=#hg92ik8^igKGNeNlV%;Ww`-O{TtljB%2C4^Qi*AbShVt>X)MPyyIKsq z0`NLZQye6j3jyI>K0f1;4G^pHI7#6C;vxEfVwdh6H8HKnb(fB~HWkllknGZ09B<;q zI?)YR9PjPBUL;EYD*sY4cgA7i_xQ2m{??3 zTxM%RF^o$;W+{>`sM4Ii6Dk|hZPRVoqn%bA2peivdR>h+K;rNCcsJbTNtxZXuM%MA z^jVgM!ybKeUcSjsv*etnTM}Q9K2Uyul0+1sC+ z(Nr4JBQH*{kWFzXcRrr*sl~Xqj48=Oi9de+%ArBPpAso%d&)0a*Rr+i3tN_g^dRW4MQpG3FqC4I%gRupi4 zr%R#bSQX(v`s{fDMJ^rn&1J!@`6Ax$`&Hlt^HT-{t#ft3(_$POSr!xEC_?hza;|^k zK2_d<;ml4$_KaeOw1d+0rJ`quq_=U3x* z(wLOCdY2tijlxHNC}xm?NFhevMK1GrY-h4?V=_Wc#3-Y3vkP*cvu z<1 zO-xQ29EoN!@JQx*Un&ZK4WV?vBCy=01DnMpamb0ozPHYES_8Ysa);J-`71ZYS(AR* z&=X~nMC-{r0{Fy`t-0v!E31!_CO$o4`#SWeqT34LzT?gFB!GafV937<#HQ?Pkqe=DQ(e7wH?AX545AX3Hx6#RhsQX!vM1$2 zT#niQe&WPdx!p0Ik1CykY_%k8Rg1v9VS@LFp=!?6&WoB(=mRH(Ix$3l4;gpboh+fH zak&9|O`n5U)6)FQ{(&y1_sJjMG)BW$h`CQA4Sh%%-pxyKZm66#OYloUqphlncCCct zW;vx*{Sof&W9xs=Wfwlf;%I&6;YFma+gn*HP#*{lwNaT~no8p?SOCca)<`z9r@+8P z%rAz4W+q#0Q1ki{45S4F1TwD2^TEQ{^+%Q6JMZ^7U$=QN;Qp4pD}Pz8pCq{X(aCRd z4Ca&FQ4fE7M&;)uj1yIrZp4i4ldYeY-lj#e_VbXDk^Mc>dgyz>Yq@4W*#xLlDLg$S zJw}fDJWWrASwwcHCtTKfVcD6({fGnjj|o5kf_0-HdexCh1hjw#w4uNM1WmC^9IOJ$ zIG(oY0+*a6Y62Z5%J$b?7!+)Tre6Tph(S$e)F0?cUHppgqCel>KQNTPve?t$j>ZY= z;7L!Bh%)rqU&3Klz@Kt9E=T&`H`6Oj7GR+8N%^e=TFtEKmri`UpJn;!>iE`K>gA1q zixKd<^8j-|@7IqS*bCn3mF7=6_zg73?ot~=SV;+psyxDp!R(2k>}d#6A@yNpe3ELP zbVZY}^S8$GVnJyLI%>Z5ZZx8RqNrIT&0jNqO8RA>;2t``7pbI&!_Ov2xDuyP!}&;P z75az*3Wsb?t{zgKtyv<}Dc)BEm>nGTq32ag0DK$1X0Wg$oE=ha>^>fpGzum%me$r^ zV3Qsz>l349ERf(64}OC@RxfPz!;s!E^Lk;hj{o)39=)fyNF6eqX~y|$ECwPOF zx4p3H!kKc6KXI9lwOj?;ZN38`l0h?RsW=7U=xg{|D@x6``I*mZNz=yFYV-V}Llp{l z|8t*BlkPL;Qa&vCj5w5?;zbCw}baf$I!+;B$U*rdr=mXbOdYvDeL@~^s z3-6d0Aq@z*ugCx}_0D$_;CKL^#eKFA0bXH&3BmDjis|7AiQlw<^ez``V3sC)R?5`@aLIaQDEIOp zV6Ot+ICn^$RuP;Q2td>!S3_FrL80#o8k)|QLDTVG^bMQ0`G)s(WHUU$5_8En1LYeWeK9G~0pg&2 zP3VRl)>6!)K>1FV<_eZ#L%==R+YfPIS(w;<*T#NR&(c9rwP9`S)p-wHnb@XB@L&D!#7$QfM0A0I< zex#9j`LyzWx0Wl4T7HQ!BrsPuH^5(HBjXN__a?~>?Lg_}$vZt};&NXaAujmR-8%Ny zBs!@Ds;|yH|9J;i6p3(f6N<VPlK>%tW`bBq z;-C3M{5t}FdXC2Jyk5@gL!Q`D-o=t!O37rl4(L`l^pHA!`X_yWQ|kgbEG2|%n*|h( ziB}~<64NZRUT?j*|C17?VN4gyC*H#TL>(%JHBjj;85+{ZSLUpa##`&NE*p+>fyfRr zF4G?+KCYA=V)(lbbthp?Lq~$5ZIs^7ZsF8$Ju4xhqKpmml={NsH|6D*9k4W_DK34$ zLrZ$+953@b6fbq=hQkN(4V?zD?u(4^CE`~Ib+(Q-TxG;mF9b0&mu451O+;u18yaRF zx`DO@ry)VWI^S0rAAxPYu_#xJn4jC|-as$C!xVh|38~3RHg!`N@xt$^<(1#g`2DB~ z%<93{Plvf}P^*r5R9@fseX4r5Km9VwWr0Ftt^5WP&Rm^S_n(uKBe;fR900Z33U^YH zj~&)CfrN1ICe2r>#FZEgkI0+j3YP1eyf}BHh3dL7?hPkVaZFXS-Z4*&pxi`{72|#J zF!gHwQoByu5BeLX3W4Yi55pP6r(3*nAGnsV7UFE2zEK8y^(HdG;XDHqmuIhDDc~-w zD8pXbQXi9g5GW~$*5Wzye~beH%`xsCN?@h6y-K_JR344ISo@2JPxYb#1WxU%QBlvw z#kB(p@>lxxRm|tkO>?=NoPc7+je8gJ4U~KDlW=_tq8ylb*g4c(YJ~zwh$lv7hu_|+ zEaigmosTYY9N?ZH0TS{z6uTx$%@)FCbS@mytTlD?`i%&h^y-`7vs%yc!%t!g4tzqo z?4cMZSNhy)=ev9n=CE;D^hL(3ykbKvFjO})s4&8IbbJ&*3My|83^8xe6VinF$%3T( zTDiiieA>5ESuh)0Op8_(DBJVa1&4B~IcW*2{*`xLZ@0Ew_?Z*t(bu9&1wE$;ewG%~ z^z&uSZ;JSfx8EbD=>Eu|uM^p2gvmC<M*YaSzDtqruL`SW8&MhoL$(f?OdepDOAYtic+V9hpi*;hu&7u*H{9pY?HccgiybL0XCnr2L)^6Y$YbF~cqv!jCa-Z(rvS&ba0svmz?T)cPWd6XMPtV9y{?Xwd|w<*=Rj8j^DmkCQd9 z%<4g88be|6x0>DTMs?rG7q&&8#D(3|QPX{+H;dLd8R2?e=EeR$vSiK^vb-eWz716G z6=n{H&XHdnZ$j3rcy&?rTJ>V8Zr;#4mcTj0nXZ&3ev?N-4HDBI()HGV2Q5ovJ&4E@ zEYb<8T=ZdBB8*z9c`=f+rltnj(g(o|Y+~Z0F#d9vJq8fuHUz#VF^^*) z;P$;mW~zdpKBRB{+Wg$Gf>+{Hk_&-X>eO|_Rt!fHOkN$CK;KLkgwA2OK+*o z1IL{HKC35fp^s}`=h&qef=*n}k2(D^TKMtUxgtZuJ39>2p|Q>VZxlB=rzDdlV~if8 zorg;$8Ac=33g61UJO=jdrWY1Oma2~jK5^L@123X9`~amnZm3t zFw%+>neT~6-FSg0y?KZ3 z>cIq!!QY_7p}V_+ZEx>U9MutLNuBQMl%Q_W;Fff%L0PzQBza>h-qD7v8=*?ykRzUZBzTsm<6O zBy~H-CNaP(cAQ~H4CiI?OvIKv6v?vXR8US0?aN7I zWEX@v#~-Hu3<95Shw!`+MK6a<}F;CTX7IF`*?V(_#gz+&R9L5Ddg zdxOcwOydEs*=%^0WWbIR@*i&F3{4kF5-G0~M?lOSm)$Ge+|?s3j&U1mo8>|uGVa|y zbW@I$H1SlVW%NqzeMZ){mFq{wKQRGn7=~3=ut5nVZw}I@AF4n*fC(&{tNRK;GZ^-O zT3{98u4>T=bG288fy)T?4JYhfQEnT;_NhIL>X6fRM9DshJy&3-^YoBTx7G ztOv4m3M*}n^M};Zu`A9YoWT2Hi*wz)3etR(R8$~wbRFb-CBp77w9gwP3>O$s?Mk($ z_9t^Z*m=1ajN{uB0IQG9VOSa-K|E|emVPLX{{dH?xbk_%$29r3X$yo6^|!= zJ4uF7UwtWS@zND`Vyb!ec6SFH6?kkKW9DX_ZtOO2=1yO1!Xwdr;gw`NK5>&Bi)QUE z$7hiM&?Gb|?f!J1^ZZ>kl+> zl0@}N9*P-7AK92PbvzRxl@tqRyGp-MaFNLL*!4cl&zRJMWnH$fJPGiuaEjODPY;qU zV>#Lmv5S=L{R(e%IPVgzTn@FhLPidol>%iG=g$e6uOL{9R4*I?y8`Q8c}43gU*)43 zGee3+RUgo+7ds?Pg?k#$zQ>Mi54vSl5F{cJSZ;5ghLzS?)K#2YQ1{&VV2?uCQ}1h= zHSH;jH*C=#t$Tphp)?^!XH+H1l{qepr9wZ=~!U=04tfp|Gna z_N!FObd4>|Rp}ipO8l5g(oAk3PLig=?7OA*#zwWv%6ybF)K2Az7b{6lDd)x&F&=LX z+$N_OJ`4zZr`$Rh`!Y?+D3A{Jj26**UNzT!fn}9=<7#(C6ZX4($6E6(R)f? z9xe)YEOwO+6XDyLo zyr13OmJ>6N5Br;~>^nd5TY*gMSsJI#b8ua>YQ!ULizo21lwR>)x72jr-;tpdA@+>q z#G(8uLQ0|xk;I58|I)cAzKQyVaeNHLSw|=euHu60E-3n^d&{PMEc9rvX0?j7^n|LX z?r>djs&-(40}4N8k?1()S!uP9KWX`?tHJtOLwUOeU);M)yv-jYD0zx4QWmEZa;us* z*`<$v)A zGLz%5vGH7-hdBv-EGP3=$@%O`gMXeRgu`n8<4;z?jaJqTVsP|?5_0{1mKENAaqTOs zdaURT<9ShEqp{s#SFeNMLRW>?U6=E}9HQk!Wi?0VJP2p&FrMCCxw_CL*!?BPD9Db= zVQaqIVw%Hv7Y?UhOGX?k9r}bzm#r`kJ~6Au^zV) z6S&t`aox>-CtfYidT1=>2=|GV@;@IuhFjXZ)TBTq6%mfxCiQE%L{l>C#(HgCrf%`I zo3Gc#r&g3r7Q2rQu3taLSdDJp<-~4Xu+kBIRXI;7ifFRryr5@zmgsbF!kjb?=ASe9 zv7}XFKf#g>YplJ#2e-6jfda{vt35@?nCs*4^TrldVI3c-d>rq~sauI(7e9WbGtPe> zH+dLAEN@NqzN43d0v7U@S%Bi2F$l9GP_rsBs~I0Rass&rwB_&(w3``sbRw9evP6-1 z8aoH#Wf{(HH;Yj$-e9!u-1AzO(Zq3~VN;J3Eiig0q9Zg@)UB9khuykMD=uVo(PxB# zVp}6+F?d=+j|xKN>YLtpa3*dEX^Pa~biOfC9Nv;0oU_v1Emul{uHUs@(u#4lHdGZ$jG-y|EZsJF@OVv-h6 zTL}ni_uVz25Wyk+_r8BrYKbMm?BJ>Q#A5sPYhG{+w_H}&5`(r{lVDGX;Q_v^V$X8bSA0^9q zZ}mL9fA#~bZQu2D8>vyAgGkg;_|nAl{)Y$>?#~92>7`Q(mlu0#iYHZw&hIVaI`~EJ zw@zfL4z#G+Eek9USpIlP$oa)3E<9nyTdXxMeDlljHJ4kBUjx`T-gIF_kJ|euE{60# zbIxV4l<~x$gO}BY>IsYaq0Uo#25)IYGKxA%x_k}m%#?)T^ci4t88E1ae!pW4z*Js%|&txYoUe}9$Dh$o&Y;;B9bq~B0mrPsW* z=4EL{U@FMvohEnB#3OpPC38;RuoIe3)vlOvd`+c}6kmd=dC8yMb$`+l4v7QfguZtA zyLJ>HNADMoiEuY;45B=7; zOqCixqCgfT`dB^tPqOc7op=|6uXNnFlaDZ-0UP@N z1N!-`{WV?PLLSF+bzXw8JOkKcSY!fip_cnOtTn+j0l7UV6x73qbNDH8SHDVo-4WNC zmuL>Yvulhym<*>Dl%vm1?cT~T<;n_4aTwF3#vlB>WP9~%eftHdZvMORk3ueZrrq$? zL?$NiRF!nze3gx~o*BZ(x}>HHzq3Gn1TRYU$gGeI4^{T7(&409rE%r_vI(nw>nES$ zhhJ9VSpK}ey>7AUy>+}NldD5~gZk?0H8-6PfAU#tT)ukirqOu%Xg7-0Os=}>Pdu1);;GmO^gCv^wj6nUuENH# zS4$2BjrD$FLgSss5D+q`{Ruf4pUf2H-nX0Rt2mlz(|SW6XFk=pBx_|)Urqu>%RNb; zSPgYm&ga6F=B};{BF^rXiPg~ogN~}Ifq76NPYa^V75w*V){tr&Zix60$ZDYjv8x{D zC&pxo30)g}H;l8M_*1F@ZMgL%IIBkUv6}W!0T^5oA$0yuym;xHS+j=XdCH@RhrbpkYb~Q`_Sc;+0~KW_@;!K>CS^R>UY`y8>)$t;&Ai8ml(vxiO|e*NwT;@Qq3+4M z*${RimLE&K9A?!ZdSiFA`}y%eeQWvp>o7&S0aEFc*ved8awluY?JKo);7x*Y^S=iO zXOKdGa_FF6su7P^{9E)no(i6ngX+kSamuk2jQHKbv_bqMk)GYm;Ti zf`$WCOTX(A$REsWP7;xto9RXKSNH$Cg6YX+2h8?x_AXXJPSs-2HwHC`$KW&yyuBdG z4e9?KSZ~SrJ;7lfOXe9L{{@&r1i_4L$wMIt#q3>|EV1OLO}^9>>4uH}Z~@NJ z8WI1~y}KQmvc*F%qQNUt5#1Xf7gM}D-pgM+3eLqaB<64*bIz2zx4$W#qB%8IZ@js>WV8a-yKThAPK}{+PtA*iM%fq8BXD5AW zDq2<>p=hBPY`ZI5B=s9fO%bC;47^9qfh=y%ch`&krzY|moHeu52E3(KM_xr;YoCbW z)Md4jiY*BBV>QzH`*g7v9HI@!N0&?TPSMUOw;3i){q)q!4D7emr|4|D4laMkyDdTe>#popLlA`{fmu=f24UMX`nl;g_$O~^F3ErVf51ET^EXH zFz23rc>yKUO*fQ2Ki06_i2m_X&!w^PQ%B8V4gFHLB{rBHcf1b0=4iHOl1LvuAllKT zJNFcNyE2yjgU1RaTDOrT|B-auy&l@;4QN%o(S7Qn#Fghu5tzfG4Y}(?(L3i|LU(qV zn{`*v(DFi`-@K>8Y7HY8a={GAm*ozpCX@@_P-7%%<-dM=@!f;;wT$HDV3O`4Gnvwd z;4=dj(<{S_6aV+zozPLRyyl%;*S4+dULh#;f*R_n{XMZsS+~>!f*~MQl%$q0lk10rGYm@A7l%JTEnXi6OG|t|?$47W{ z3~s%Szs^-1@R0AaLFgLW^`NSKP0%4M= z+1%^q{R|8b6qL+CSGP=0uK?-o>HtXfTp5es3etK@-1oV*BHL&B<1`zXQw_&%kV+bM zsYrqagZ93q(a?9JGov~j6c{q*o>cCr4LO~EY5T7C+4{0Gj5x`3is=2{^U(ZxtTR5N z)nvdbgQdhLQt<*g#y3ree!2QZ(*)~_K1s%i5e;I!gm15*^=w&K$Wyq{eX9HVjf<7e z%KV!729`f%R@klodrHMi%r8$EJc|;RNac8Ujhhh(JsO0kIF%^QFykw+ID4`PLh>c3 zX~E$juQ138g1g=QL~%os4ie}|EA{Aeou5r`Ryyr0C_?#sHF+Rf$7yhGh;lVo;V^$_ z6?W(Y*%@I*ZrJ&#+}_HD{_o`E><^sS%Y$S&^Bt_d_j&wvef+0_>fZn;*|R67*}BW% z6D4wV#Fe_@Ed-UnD38;2GgnaBqx0dMxIDa>x=qqCuh}PZVw*g-g?oCnB`-rQZ4F)4 zKy^OpbbK7MX?Wpdn~?%gqpvt|9@CUXdMO>vp*IhT+^YP#okS1-btTCDsU4#*9Hb4B zd2yZf`mf?Q#D4X`l&HITCVzMpbO2$d`36-v>KwZTCWyBWY6_;w<$82v+|28-f1wK0 z)L%raO-1peI;Rw;77z_0dVZHuP-as0&-?>JoRx`Lj1PH&0qJ7qnlvgxpAdk^hQ`A1 zX#M2`OH9wl8_Ke`QpJaHy`K`@7Kf0qQ4Qm82$S6QN?qa~!41o6q;TeB#A$ghX)ZdH z&b&CBKF*Z<#Yp1ERdu$3s?%srsMCCu@TqA|Y^ zn52dWL+Ahif(RL;hHd1F!dDo{p^U13*A@n4g9+!Sam>ZuI%u1k{L0IlG)aUm{n6O@IeDka*&UazgYr_+7029Ucq7~c_^8hpW1~a1bqA@hA zRdsInM#@s8Qi3`3i&b47r=)J_6tq7@E~>}QK9lP~QXylfFTszgjixFNUYAA-hz@y` ztkW$V$gD$qw{}Ua$3X!(HqH!x+!;A~xL6ho5 zSt1MZcpzWXp%U2%=lAtN@M)7nCV%iw$p$iVL*-()^m#1?(5ntmH|LmD@gEfiq;Ehs zzw0|z_Zsio&x%rJ<@U1OXa^ z=^ae-rKkK;%C^QGoMhW}Kfgb*VJaXui$+(2qHCsj@<)tAh5@D$5lH~?)t#k?%wqM~`UC@q}?w#cEV2baZ5F zXmYZKkn^+)nV|O>+<^8k=dyNt8nX|~pr1HR#&CZxX9xFgN&JIDZUY#&7)rOx0(5$I zPorg_{$_Kl@a{f%lJ8Jq*Y4QDaK~x6xY+1H-YZ!a2q{P)47w%uo-!aP=m8A<89V`WW<$erj($4rD7yzt%o*qK%`oUvC8p!2fJ@C)MiXyGYGGT_6Q%lfK5P zdk7^pFjBpy&g_*o&aq6aBgiwr(VF9hl+>c?s+x&|TC>Dct!2lfPzI-9`@;ycxq zpC(_PHa?q-e(&(7{R=B0p%96u=QCwcex#sarW1G&cN(@|;5KAWrr~noQI1;KCK!fd ze?D);dL^Wq^&sh^fL0CWc=_X_?U$4^(suw8V83daBi@O-?l*2!P|IaUFZ#*c7jWfIL9lZaR@0Ko<(Y3;%z2`-^v7>aXncVJR76Uiw*`XT7t z+&;oy<~~=x)RWxNUqBNi1I5U{*52kBR6@@RP=xAl7&4u+XP^M9_b}m|ecNdF>>$}( zcI04E5TOS)a#0{p-ev{~J|VZPl(LJF&)XQ9e97;O-e$m68^6OmO zG#gXC%^p2^kWSGD320SZi{}?9GKRgBzyvAOfgHOD@y`9V=S6hS;;svyy;fsaC_9BUa$Z-G0p z3(9X_n`1m1g*g^F!YpQbhtasP22p#m!_uX2#QuzyFi%WO=(R_MAbJAilMd6rt|D+l zn81~a=i>w}*=eAolRHP9ot_Mt7T2IkfOh-vn04lTgsR^wnVia_1#;={L|j1d2*vjT zyQ=h^#cbWiV3K#(lwV$?7#@?RA8OBs&d*AG5p_TRzB>F|M z^T(;V_-mgX+>AU>tBIrTii`VBu9VuoqQAM>lWRLu4gjVmP~SqdZw7O<(}2_#A-D$A z-}$^7DC&KMmi|W|NkqdU`(0$Bd<~1N9hh)0ltS|yu=8UT4p^h-9#0b=zDRaFchU(n zDK@8?;5liYEiwVBF2!7PPHXFV&-u33d&Y~Vb63!S0dN2(k6I=xk(LkQ7=bY7?N+(m zPnj>7*0rm;`dSsr?pQK*E(hKK4J97#`G3m;%n8HyEj8~c(8;`>klrb+JYZ{Kr%L_|)4Pd^xweGAKx2cl#|hzjK6k}H{CB#R;xcfia#1>ii8u)BIz zC?Wp*`E9@tQbXSlaB#p0`XM&frbHyJ!kM*GRf3F?;?=J!4;8N)bQMP^-XgSq0Jg~pPh%^Y)?hl)q)=_t>pRa8I(0ukr1Cd&}s7~sWoIaULT zbAW{&*0{@fV-Pk+GLr-A^ISIQupL7me(=W4o4Oz)4N~xt@OtWv*0vsZkVsi#lDusV zpAO`n>LfLh1MTMNg06c~IKBOXHQ1C{3t=TCdpoG0N@HQnwEu1@zmzH!#2 z708Wga>T^lcbO^wzm*K>2N&A7wpbOr<*hA|eQ05OkkaE4{%|r)AfW}v{_gBin!4=F%(;j@n!Z&wW-fLw4xiVIz{MeX@}c@z z8nOIyPEdv=QMG)(CQ@QE8&#z7z-eJl@#qJ-zH@}srUDOz$3TIh9HLwZjJpki#N1Kb z7G#;qx!1D%vR~JEvwEDl%Es~h1VRE@jZzlG^Z?5e!a@gxSr>qpSQ>~eB*W?O`R!L< z0UV}1QFwAL_>L}8emp!n;?+wNcyI+El*~2ne?OOuy;FTg#OH9$aJ1012{Y4gcI}qU zB9XD^@Rx;i#Wkybt5}`Y>b#)~LNN7@yu0gq}(e z{;OyUjS_QG*rgz!(3!{%gOe^h=NVVv*aV7)+D9u#Cb_DySJGrmigOn24uAC5-@x>q zu1hjj>cv+@(9v?^9>2(p(q=~SGY-rIP0eK;QISZDF5v4(@-r#gXNXk?&7pJb;ytBx zMMdK0w-P&rN@=XQHIjT)kK<8TK+2m8^r>C0lfZbz8BLipyC4Iipi!J{&RV4`;G6ru zLkR1nS^8?t&j$H=rzNUh{8J?e45i}OSf#a8ezd_gk77_p=|VsF8b%44Iuy?BaY6{v_*8lH(78tzBg838~l-qt;bl4enQ}kS}5MFuh~f!iGRuiBtJ%J zRX8u>!3c$Bd2P1(^MY@j-P}QGQf=thAZSA_bb*>DVLcRxvv7!XN zUk>nWf2s@kGpy5QwyWD9k)L16z(B&;8;^f)JVp|?kTQwr(iDQVg!G6BE==B{xfYF^pxU|c+ZHf~X4pjVmA z>j{BD(>a0HHYG10+2kM^y&fAIn4M^*uezu&`d+;LxQOHbdrwsLs1L&EhLcz)cNHu# z0!A2+6ZJqQ@v~au;7t6^#`E)&W8=AculG@cA%<3E20=A7!thA zZm6z1?)B?}!!a9Jy1H63~ zqd1zYHZICCa9I z%AE<#0oG*(h$MP6Xy2Xeug!wMHp06NGgQ&Y`5frnPLqX+H<*#OJQo7hT8NlS%!53} z4gngzzxon)8RcXWOnxNNx=OoLoI-p=G&gItscX<5|6%f>u~%`_rkq{E9edUGO# zUEaq7N`@u7mE+sXnAW_8rmV0GzLVc8&zZGOkCXtOn(akG@-|anjzO-NCxl?uI!$#C zv=~6|^LM3_ji;B_(nt|Kx%*+#QvRGa4AV4+u)Mkb{{16w43^iI3Qdj5^9@h7rA?&z ze<$50F)b%*ih$11NUm|$!sFOs@RutST20}XmEWL5bOl07$IK7}42cTV6cLBJzTtpt z%Xj?(ID*e>N)g)@5j0{Ec;57QQg;&=vgJh<8%oFYf+{NbVSH;I2rM8`3PyO-m!LMn z5Q!fa(u7O%#aIatHlJ?)>1lB8=qBbBMqS8I5PANo|05AgEnxM3f{}74g>cA`5RA)V z*S4Wrk{~&^oc>;ybi0Fv)dFL^Z%wxon#hqm zxx=fc(oC{N&|CB;xh#3@q9Y9EBAv^;i7O{>{^tP(P?~@j6r?<`G~Hrd#U6O@XrFF4 z1Er;p&c&EsWf}Ljz(DQ+6BL%WmVrWh1b=_MD8XUHfYY9&j5Xh$@t?|~9sQhZb%Gbl z3-Q!87IJrL@}nlXQJoBvs(t6xLh~n|2g_{%G3S>DIP@S!p+*QeN_SVNYGZJipwtjP zks(_AbQl9_J2>o2CGAgVlx-!*>V9Qa=|7Ex-X)|HGNBm?q$ME*CIpJPn85t9I?Q5` zK*XCzD>d@KR;Bk{>xMEl6mE+wvh~Fd@ZbBqmsnZ(AGgLUaz-}pTn})SyU{KWq(_*i zdvYT;pRS38V`ct^l%h~;2>N0)a~M$CwLmJ6ex1#;A(X&%L&Eb)aHIP&M5vWjv!$g3 zw!7(^el{muFrNu=RZg=V0GD4Jtd#39#Yf|hD_g!fzHd%a^*FY{Ofp(<-orh+(X0WP zF+e(H5}lJ!a{%-M!MW<0obcVJ$`48LkCkc{mBlHjt1w~KbU3AU&UGY5N-vu~t2nI68n z9P&Ek{Lnpc)c?QR9~4^S!%dbCoLJ)XWDUs!0XzVQLaMG~#Pfe_DzQihZ0}i|RvOQh z-j--d@TKgA0#oy(1lgMX%AfUvNgp4q`!)t9L`^T`z7z5MhVhp}%e(voww$3Hn(|1S zCMVY+&uEI;-mM@2$Xd3xQIS&NE4i`s|8uR_;%nMYn08j8w0YUiuVcf!-dDy?$USdL zE5PzopypCbtS9Xq#7Rds(C(_nVUtW1l@A*-#OxE z2%5Q7LaF%$BU->H;{u?O5uiGxd?}V~zrMA>ZihJHZSi>O1_V!YHwH_)4`e6~eR(u{ z>9a>cWrVz+q-U!BOB_m2ts7b!Fp_KVR}G9SG$v0v6vgpn#?bpm4~v# zFZytT@QG|u=#x0<&(o_t4Sx%uTbyueC{bE3<~(YP_~BZ%S81dW#c_kpfJ1$7vLg}T z{EtqL2i%1+6aXohOeq!fpiq4Rvxe0jg*xj(@$D;jZt!$LHF%&j`)=w#6%o9_qXLPc z8yW=7KyS}mw2wEGJ;;vN_2`JZO(9w2M*P$8M@z`}#_(?c0v0Z40_1P_xLrxSd97A3gdYrEs_90)UhZd7l0TD?6cj;^I!K(% z9X6iSxU=Yb?^T*>M)Be2Ltl45dv(HW%`c3Bus!aEkPvKmRI5DK&0KQF`0(7^xj&vM z3~N6=*V?^<7)+9w>}loB&Q5RIdmV`PsT+*XRxRBZo%Ushn!3d#5)-td`Q(fd#AHhj zl~fFq(W-`YT*A8B-!5*KeiNq2@xrR==C-Fr^*inf%Q&Mr-KH$+&W>0XohwjaE2r?2 z@vFk!*$!q7YvRT-Imw}VWq)C@I6md*9uoFE4pT_xKyy4}&xvtNU~Gup8VgriZf<*`?VEJimD=4ZIUFW%ip~=# zK>$u^POj>hCgmYzQA%O5`xFeGuD7G< zkk!iu2K(pdrwT}R+mEIM+3l&ZA2HFv9i${r%LgZYg!iQFTyB~{@XVGuZZ0}Zq1?p? zX-5JAXQo`yinaWpjJjf+FJJanJVA;<5GuuF@QXUPNk>+@dEw@8G-2`kg)(96E=3F!$yxFf?@q>gm#0E zRIlod7d)`SH$%ehn$P6iSZ>V}6gcX(65$VDW_!*wWQ)r#_x-R;vZLq|25ha(oK?>Q z$*@K~bU_A;YnUHPqysJ=yX+&Vr4uDhXsSQ`K9*5xJ%x_j_Dt`fqypxhZYj~`Je{5R zd)Q6|J-}|psn~lu1uky61#KWGoyTcjk|9)AfxBpGt-zw!-OdG_i#}Z(8U)C}gT8(O z`i*xWWy`9YwP?4j(iCjialE08OHLVl^A0rV_LhGx^}h6ynw!jzOi{yhJ~>!eJn%4p zESG9j7OQ}q|3bLB_SuKPUx_3Ia~uuKYO4<^yLy*#jT)eX&xHGbSP9llg%9i1r_ zC!LJv_eLO(^+ODS4g?Dt6AsaSsWkEs%qx;BYSL(dwGl}B?UIDl$AC%8+N!G|EjNw+ za}dlpPVaojYGI>hS4o1w$mGd4I6M`kpr}zYS1W@Sg7gvhfyu{{^^h4wYp*(+vyiX=f9)Is>^0GdK>Py6%C8`6zkL@8L-CLuBph4W?hJq^W}bHMFQam;JEu zLR|mRk|YT%mGZv7XOB+NAFunIEYC?n(7xSx20-_K-V7wl+s|&eD#q=il~L(v^h^4) zW6>3Qmz=rAZer*&-h|q0-$^l6t8Ncydx ze>b7^FJyWG&xP^w;f=t543Nk#lbH*qlR#uz`{Cxx9fMz2R?2QfGON4HK;Fw~6~o1; z;8R+>8eXt-{B97LvMYA4#)p^)Rea1%JdgJ*|CfXn&;dOE_dwxtIH(U$l zlOy8!#l-{nMvn;L8q@{>*cs7Nixs4wz*q$%V3AgftE8A+{LcXCXiiphw7Un$^%u#y zHvr`Q&Oz3~3*Xt=CKgN#dMj}#Lo1wlp!!a+`*F%pzEUOT0sGZ^J`b0kRq`PBZTdLqibaQgKqLWV8S%Gu<+*Q z4=w`t15L|-hC34l;$#F&g%LLW8J8i)jp4|1Fq0b6aT()sSR1Q!-?ZD88|zw-Z@LAAOStg zVcbqejM-osNy7-fZd;oA5cg~HnxLcbx*be~lbw;zORCpmD+UmYr0eHM@_6d_Q4q@U zeVB0kgVon}FK}@aBS;hYe!!bcHu(kkmfmJ8ux5pE=T83Lm1X_SMm_a>*>pKXydLCE zV+Boov@0hYpmCJx_Z5uxhf{My{4mo3l5-@NAe}kR1l7HXxtp{UnJqs}9+!QvvmK3&^)S@Gx#I{suv`YmeQ3xA&|;buYI{Ana_ z@t?aA1Z4A_!~AmR522m{^Skep&HO{Nb+}B;4TL&g{w;YRP};b@Z!*7gNXIH+II1>T z?0K2>nAT3L1teUF?T`LkL(OeeDFybwt3Kvdq|8_CK7_#5t z8*Bi2F}>TDX~=19JXjo|)SypkxUDA{*$F-2ZpynHe}aX3n^U4@9uBuDvf+{r*nioH z=tK(UXoF;b;ctvQ5hCoE*o0(8<)VI*E~Q;acv0NniV>7=%alYD*~=9=l1)w<9y-**XJKHxdt z^ysDlmQh!?={YIMSgvIkj_rrvc+~c-``a5#Dzsrw)?g=muThje)ZZYQpEHoL1ZOUbl$v$t9GQ1^KoeormS3 zbI?8l*HDZ#+PS7sas;Mfh)<6mhRIVEOXN#wUMfh4*7plmpG3hlPMnIBCtRnk!}ZxT zj|gfHBL70VC(|!Kw8&H6|$F`2Mx31rK2kLz-IA9?6b7vO~IjwN0 zJTnxsO$1L&P<^xnlq9?^a6dk;%Ht#|yYb{tU5D9>#l}41EO%Yb(dr@b@Zj&yzex}Z zg#Nj+nnl9vF#~|3CVSw>kUg^v#ch+bG}s}es5?_Jj)h1w?N%Iy7(0*tWr@Gol#uk@ z*!P!j-pG?pixC)hJ{vIsPIO17hIKpHxF0b*%DHMZiv3xHr@8$yO3$pkSBJ;U@GP|B zU`Pg;5kl~aCKm@)1}#WOeazCfPr{Fc_t*JzTDQ+<4_8RMO+VegM^|b&KSA$ctjbkr zG~b+`^{lN>@Kj%4wT!N9ceIm1p*21_#oFQuK0f~K=iZmtHYUkwdpKMxT4#s zpXA<3{aJgBgJkH_ce~6Hmft-|C|vay>wa-^4RPpnTzAaNt`?gY;aM1Tf+En<1Cp(+ zi2jVT<2LzvLY^PC!ORqQs0;iWy@-1M42X*|2N`sjnD|cObop=5tMD5!t~C{=tx=j; z>j3}SJmrO77*V&va-=y@Z7~{c^bHpMpb?sNF)RNUh{tcCd2B$5t=H`d- zy8g}hY^o6)SSw_WE$LyXqlrY*#ESUK(wLU7S}uO)%ocC5A~kYWR>*!!MIqm4-8pCZ zrvE-{3AA(e!`wN>M;4}5AE^Yhz>C3k7vT{qax*1J2L^ul?(2DZmMhsm^lz4yslLoD zKi%))-KR-ZG0!MJcbERzocGydhG_d?vHY-gSMEDRl!!_Jkt4u=A&nz+{_^!M53zK1iIvGuWH{~U(axjenyQ^_pn@-P_>|uO;}bw zRKINN!_6es0(#+f)KLV5Y%p1b`ghc6E-H#b-hI1ZXLzrl>CEu}3&(-x(kpwmUdQLU zBOi@L-V8n;_k?|U!kcE}tBS8nc(H8vf>EB)09V+ssN~7*<%3+gsF$lxN?{dw$Ge&y>& zX9UM3-?VoYVx zuTR*vZ_Si6*jOGt#$*z1hLdtLxH@A&w#t1EIdXQnnE{!(nYU7a)tpuc-{yznrFYhu z*AfIxqR9;>1lo4CW)UWm-RdRX4o z%EpV=W-5rE>D=+f3wT2sB+q~yF#D+}U5V$|rQ|yjc}@ccIxiblO3+F$zwLQtBZoFl zkh8?gSA*1AcG1$YVb+skH?u2?aY{~%~B&B1%Bjk%d-@9 z;%+c*aU&l79pq*PCx)YblQ?qqBG?RWI<$f2W}-VMF$!tQ@tFoK8rWrgbMYOsL*z|7 zyDRr~UN%^|&RTs$c`#jy6O7LoFW|B}=}Uzt+sa!D&hEzQp2 zc|o$`U=GLyU%B!b#iObkLDA_jsp`*Tvl!u=PL+H=Sckq<@aE)kwFdV*pL6v@Sk>f) zep{2euO@L@4zokvN}HzR%Y(1OpA3-ma#4n9Rz!kH@`$F`nsY(xvDQVa*jb*!<=Z~) zf}*R(Dsc9**Qn8OIr;j&m}|HFiTz}MKPtYR>tpG5InjH2h~J zUZ11z25O2D_AIh#O6^z>bKF}IGjnIkVCB zw#_e#>rE}=Ed%!hnw7Hd4YF-7fY~NdwRu0Zw@6@t`gO|C5UW*mV};B+wg$b2g2LJk zJk&=Legn8vD=#;93mN#`Pxq+!8`Bci{CN(>(Fh46!oSlI-EzVMe~RyQ!`LoEESst5 z&$+ut@*T0fSr2}mAFCITn|_vfF#Bg&@^odTSI-i6dGa~AA(l*>1_{`?@YYW*PKGM*c8={oej2RhG+LEzU|)ylj-ZezS0%T&rNnPDYf%HSo}E z_pP1)WB=s<0+HFqhRO4j4e*@n@^wk zR&@MENhI85-IIjeZ=tTQkQp#e!7(g+QD{xOALSv>`|v=tGfhX97P_*4h0iYlzANe1 z-%1;z@adXA8C(;1KW99D?v z*=@g+0Ls1N!IZ6g(yt|UUieDp-Th?!utBZVPm@5}T5sEF{8G%7+sWau7Tz_ z`tUf6lCeuG1Mhs$Tu;p4Arg6BN8>IA3q!c0Zcdx1A|~qJmidi0-QAV0OJkkk)}j*}Yu#uH@0*NJQ$ z7|VQF1N>!Ow%F^&*rI`$oawNV`)eYbHxKIcUWO=(ihgCth_bl~bCr1JfQJ2a+t>H) z9Y&^!^Ho)8?8R6Mpw2m5E!Yky%6ikB0)bL4s`R+5$5fI%=9ZDTyR1;2iLRd-iP-MU z8+jf1p`#;Nd-rNw@aKEQ{TaO#n0C&CN${q^_dRCA;l=8Qy9_T4gRNLR{5A_AGo`r= zNrsO?*UF++M?4X!iAn%>|ES`i-jXu5+rA&zKjfHq>Z?@@cjC`4T9oN0KT(%5iP z1IBVMBGotS({p#L2+n_urD@&I;ddid#tIe6X2&vX67qUD-2o}XHG0BuvE~o8n|RL# ztp;S(0>WZ(!ThNO@b|~O%;Y#%&xLrDHgK#>wu}0;%cU*#S>*bmA{;|gLZ^i($KuE0 z(IcQek+e0(SyW%_3ds7xYxiBB zqtmAA@yme^C%(QzRJd0-FzdF*8AuV&PU4UWaB|4@?X2EFiuKvu2sEbjR$(yuyX`;H#N0Tg&l<~jF z)fQad%S5YKkq+qrUM6bCp>Yoia@7x(PaXCA#OcmyB79b=1{8u)pI z>tN5_0~ z2qg~>&+`g;2l}d?kuRj%y2%?yvx3T!q2?J@B_~(r|J%HZoa)RTCc9P zn?zTfJeGMV;3@FNSxzBlq8ATCaw4)lso%#JjOpr#N>6YqZWT|=pN8%W;3ni#+-|L) z^KkMHeD!z0C$90osc`0(U1%|wz<$FpODwit(=Tqw$@6QK)ZF4+;^5?PUG$fT#}Uag z^lf!DNx}v+1-Ft3T++IP!0$}-)AI2V6%0SyS?I_f1<^+_J-xZBCmR!0u>h32w7J_W z2Lv69)_%P&VL2e0TDtf0aE;s221aW=-(9|Wpjy@=Uw`AK7nL-KKC6q;QOG}zuB{0X zJ_|${od99fy*)`fxb3|8``6)LQn0M)Nlcr=lDdI$aOT&I4i3!7*Peixd7l#CZr7qz z`}Si!2F}5Q&_eE(W67~_$$^ZUlO<~kqdv9Y-odN+s@7|KrRe&vl7w7yLp*HkiqCOz z9{~pR%_Hy&$mUVd(k^+P=9VoGv9YrwimV3{F3fhzebY%kWOTWfZSiLmOuxEQe&>?I zVAJEr5q?3Vg-2;_z0{5igl*U3gM~Z?vdsuG8UHa`U7gXjH0@}KEaWlcqW~xS`b=j~ z)t?{nf~aCgS@Fa&5eN#{U zlDg2yB^7jmvsNoLo-|*)GxJpviiutLMg!)HkeP;>~ zY*$PPL0)u)Q=KVUZWKHL4!sezW zIy(ALnN8Z>%S;$zU;|AziY{HQSk_qj1I7lr1&#U`&It94o}Mq#1cysBn|pwq1tYPy z0#TH@MUmZC3X1Ts;TF^Q*_1tzh}Xeogk|*>0gH!?|2PV1k~GXX3M&T+zY5&py?LgU zGxLk)12eLZaNERwXkQlAaMLu~3;oK*K4ptClE?gJxjaP+E{S21oJXuR36Cv|jk!G2 z&`u7{>ZZw*L=km=)(7I?FZuM6Frukw3*tayw!Ja}r@OtbyWJ9ip-=q!^}!0dQn0}G zb&$^10pf9;>JRWm*goJoJ`oucx-eDk)Bb}CpAjXkQ$zboj9?5etFAsG3(f(pMCIlmWee`O>JeF3XwqSJ0KCbt=Bf| zN7Fj1G!%SZ?LjdwRz?%4_ejk&rl>Tmls_cwMZ}Q^LvhlPAXu>-*d7h;`sN)5WOm{K zHMMoG40m_3*i8_wb!s_9M`tLJtJ;g0KU&H4%A_x?P%lmtRLA@o;48Vr^3EZhdm?G# z{p4NqaZ|jzaYF7RY{RCCY%M3D**1|7ZI|G=Cd+DVe#)uN8JNMWP24#3Q}!iDxS!zo z!EqXU^_`c^k!(GK7=1J2JxW@ykGOmNeWY@eOKC;1p`j_2MC&hSFjZy8GNN${w4;S@x-Y#2ZTMK#0t3zbsIaihbw29m zY1S}Xv|jMBxonZFEsj^IkmtRxWa=xn*v;=tACzU7p)jG4&IrN9T)Lh-ma2K8lwjO( z*MX0G3tza{KnBB1N&V#?rmOioK^s~f<7#7D7+dv}&6k58VU1;$&EA>vc6rOc-alrQ zv79`g%&g#UFBDC~o-G{QKKG0*jJ<^?8&f$&p9ho|!AWKb*E|u6 zt*I$LDl@_)hCn&vHk}e{+LteH)6=2xZe}t*P;O^p&=F(TativU`1A~7#KOXDY_p&s zQDm%7YSqm#x7w<>dyq@fq#UAKfQEm1s^Ge4W9^VHTk1-7xigMOmvOz)wX3brrBE{o zn+)qjGuu-C6H3!LrUAvEBm%Ji1N9S+UcGef;|IiFVhwgrYm{q5B%g4t)(X zR@OGvE>1P>1{YNx+j<4tUfDc!*JBvhR1$4g$|SGH}oTe><*Ts_uTCP%H= zty{WUXt?Pk$DXxOGShc$yS-!*KNI$l>@;O7n9C)WzTe(Ih!0x|me^{qz;%P{k2&Gh zy~JEN{0#|1YH;i7wG_YW1i|oFP*6}DuT5h)qo82?+qZ8i_Blc#(K3}q938PW&1&_& z4|%+&tEN{7naym@dpA=d@4wMH#36LK`S8RFyTrr8#YxOYRcm3sZIqQ<^7!P1IE3Kh zTbhIo4*GbL^Z$MZUr>m)3^tNAwu9r%@3$SX+z|g5UMMyne+rU$Oy$Aeu@LzF{SnMi zY#@0H14*A?UNC@6(D~En&-KdMZVg?~j#>EuPyYAksaPug0y5!w84dGysx$$pOGa@R z$%nLs{-sZWKQ$EaRJq;C(h^Lb5c1CtyT1d}2&6r=({$y+e}4%nPlfEvEiSSLr~c)t1vwAnN;&nMn@=hOTEviy!ut*QJbjZ5A*X)e668*SHUu9UUDB zoE^@BGzIS6yUk!H)ZdUpB;b8>eqyONjgVCb2&vBAzkkmH?6=l7HrZ>ff@Sh>FQcA) zdlEc1H}}M?`e=a|Bz)fm2V;Stagn+5Sxb0pYpV|A2Zg4?I54o7pP%2kl4631)J-TC zrR3xcL8=28yaYi&pp$MVbr`eKs)2D*@TN6*BgMK+m_Rh$0II`X5U8raY!^t*)8+nd z=;Y<$VS!}B{bY?BO243k(?Q5*n_eUc1z{jn&Nu8LTd&vMEvodf)?K1gE^ zrOT)K+nxOBP6>nwM76}OSnjUt*RMYubWF9DeEO6P7G?l6+~=Na!^6YgEqZJbjOqq= zy{+Y*cKLuB-tOvfZVguWJ^7L%4dT`Ku>YniZpNgv+p#1dcBZ{nkxRCc?=|+}*WB{uH&aa3ahV=9!Ih z2?z=zL%}^ToPz4*^l46o(;B%uAF0h|F(F{km0&iG{1u4Y%Z?UeyH*k*Iq~uF*(-~T zB)9+?%=+Y6ibOCSwg|6Y!(rTRcey_R3Osj=CyPu7VE)7qPAn2pAv-N6e99pwuyv)# zxSy_2kdZO4va)i=dR4=n_I&QCCd0u67%cYzVG6Hnx02y)6~$EdOM zu`5tAcdL~*LiBw^M2je-c=*k3^jQklzJ^ zk>07p68-^tfwkKu+VFr|kO>0SHDa6Ls$OmtE@R{6<-NdR)N=(gsF6aWy0;fEt5my| zM*~oECwO~!Yp*e zW{;MDJ9zZyQIgayRNYLublIX=Vj1lgp`K$28t6MCCb_II!~Dc8+{HTe4wHtYhQ^o^ zF0=ig-|vLaQDLz9A5J?4d=BdvD%M$$7`)w<%V|%w-hfLr1?SEXLdvKP10s$$wQ$X| zDGkD16-`kSr-P>y#oRQ^56jfwJYUku`b|LSk`OK-6`+i|LN=J$69W`W{g3~ z*T;f^T*};ztJNXaIu;CFcx&RXUVX_k>ZP8A;cIb6$I`9i zm0V))Bvcr^!>Cya;h>gFw$)rSwr>A-rN3VcqC7jtOEDrjcc`K-s5X%B${8DfzZiD_ zwaKo|m6J)Vmvt;3VJ@;hU8|~mdSSr;o}}Lgh5 z;G!zAfIExx^B}xpVTL%$2>hqxSH3LbsnN~7dgo-EiH{xKfMCKD`gTre*CzRCehXUr+fLrr%W*^f8KA= z?1n_=RhrXJ5Yq|Ayw%+I)4vf*vl89^wnbwusQw#T)F-4zA*`dwkB)?5J2>yZKY5gN z3;%xBcL*Eb=D$c})z|+o%NFwc_M#0W@XNFWKA5Bw)YOgCi=EBQ_gGo;RNP2ON#VRE zfuq(Z=|A$uA`b#ZNLg7~2JPy~u`Xu#@c!d}KMYdea}Zh3@9fOY&xb@tD!&;8m;V#8 z<$xj&$QO}$IH-r}V^2_ZM6>&V(ZnGldJ4-gON7}o(N(X%4-`HIqC8gi_KkXMz&9ZV zV&O2o*X)MMk~isWil0gDEY4;J~gDexjR5T6UW>|gj{zorKF+dnLvKRYrMf^sxYjRo{g443;dNQ7LY5cdaB zADeOC!~ON~HVCep;eBO^C5P@JV&k+o{+{U^c}|l7hQeQAX=ya~@89ps(IkfL*U;27 z8Y!d&?*?Y!b8YP-`;7@1sBeI{!Yi;a7qT?ULP1O92RM!k;CaPr+)tUD*1=Q0C@_!# z=PUu9+Yvk1!kar9;fZEc0w_+=H-4=(h-*1b5c;S zZ>{&kRV_9pgfe56c1;2t{H@SMxU0Hwp1^QT&CGa0&sAhtM9i1 ztJGe|6gqc|Y#SdZH8eD2V`IAjW!PV)Tww_b?qYvWmVdGiK>M1N-W;rtXQ>t}go;H1 zKSlR98Dbn993K1CyC57hPz>}4c`zFe2eKCSM*>du5g6H{vy+Xog&31`g|tqpF73>h zjF7D~00BgH@YtBf@xg}2&ohI9VLlo;Ny+OH!DLmhglTAK+6~wt_>B}euL*XbdPc2~ zG>bYon%_s>cp2V5Z~Rhpbo7G<4}O53LP}R)qLEWv3I~d*ysIp=4ZNPTmKGT_0Y`u< zgWuEB6S2pH9B*zzN5*!!&o3>}{W!U4cYogiB6>YTLz~5T2c!=I@1-6R3m(@)meFD} z`T-L{0Y?^_#ZG;QBj5``^QcC3l!Sx?R)jg}e!>V3tq(a$1K&5q&^?U#y_1-YS$s0gF?F#|tv@E)f7)YS<>eW3so)Bw6#F@PYqH_>W*OrI&2_B4z zI6Lzlj5|zT4L*Qdng^Fm=p1DOnv00Bl8#_Vf`f{jLdf6d5{7VSc3G_|46LPm`3DZS3j_hE!n(9CTRR z|7-3mfZFQ1wP|@M!`2lkqKC9;PNXdu2-Si z3zsPF>lH;R2e`np%Ya%`OXkn7Bb`@MNjWC~z_Nf1iU7`g1Td44(NTbGlP-j014c4d zpqi}_p-TgxePUvwlSC~bxk+LfeS)h^HPs$oRrLWJHFGx~ePwx30FMLJCrvB& zuH0>3z!?FaaD9ke+vSzifBc}mmOJnQ0NoJ&|2-G}uem*qJ?$qz!m3xqGk^=^t0I7D z27rWY*+1R|=QRNxBC6tA3K|}k1F4zHX~K-t%uGxxJOi-`UIwfy=o=me9dnHF&e8bZ z>f83J#Php?>9NJ~DYaKt;M~v;?7Xn?B_Uygksg>CzMmMzH&@o}1qd8hk|AL^V$P3o zLzWx2pCr-KW7=jb5921L6y#V_EF;Vv(m8-}E$(UhJA`n?y zU+k%*g0M%ima9439xFb#C%9wmtwL2DHN%_EW%f%XXCCc6(VyG2owX=~e@1{5m}h98 ze3t^le&?Z~T&vjdBNR%toi8MgQ=(HXp)=`1-S~@>v%`Mnl)~RYo2akx)2u!)xN>uI zU%|^C_dhOlttuwgeak3^?pW8N6V)O}A0b~mkTk}LS^g#neKs?05zs!~`Hhv6+hqlX_GR@Wzgm%H+&}`l zY0sTc1~laU0GZC#0Z>1{JR%jxs`*&l$7A@EPFyy$kaA*v`11*$tt!-72K0C`9M3kQ zUy*h)hR7ZKV8N|do5W3T#Aa~*%@F7Q4%j=iN%oiWVW88EAfk2UwshU9$p{eI2hKvJ`JO#^;R_V>}WBq zll2}@)oKz+*7tVLRM^sgEapmh_g1`EMP;SQDVbNTog9D+JZ*HvBPGXv%ZYORBuHyK zSUzy1uf!Rw-R<@C{qyAHaP3{=fnohAQdXf)1h!Cr3d+!5wXOH-s`MfCb>k0AXzu?i;Fj&%NVH$KZmyNBV_rUNCs0gsW9UH@POYu`FYTnAfLFZt_9%Ekt-k3>&28#_4Z*Nuwq0gew- zN8|DKv&`j5qWlAoJ2Eid&h~*dRhW^4Q{&4dhRcSpn5^TE&wtwVynV1S_qhh!II>l~ zC1|A42dLLg_6n?(Q!}eTP&=LUmYXy6AUTIf?_#oR25?h@7(Mbq=5w6B44ONvEq_ zEmv!>WO!!wCJN6t5an%ZAG&9IYG&b96C71Xoc!l^L>P*BH;UuyKO-+cDK_``FZ?KOmImDh?h`8n733rgc%lt@d|T?ZR_>Y5X7lz)iM?w)p&r>&vjF)yd+ z35&Ha)6VP?*t5{^rF!S!M{V&|79u;9jP*LO4%rSvx;Q*>7OZ3jip}M6azm2Qd0CUX z(m@6eL&$k7N1Cg)mqxf_D|_N=y)O@`oCgm~PqK`4&qwo{T;5{+sk~tWK!MtJ;O}=G zIfWPF+=FE6?zk2hwUi-V-@Z3y%f6R+B>3jTteTivtmcZ$yY2IRg6;EjDI*B|I(??ABhihc^%wl$(=^Jm7KznVH5ZyMWY2v^T>2 zadGUIU(jOCdS`um*yUK2uj zp*yyiPmCEHijFjyy9OgNetzJ1wG7HU_#$z9&?x97dPXMJcD7wC5lMo7^VqaM9R)%B zLVc>NWSLSO&bEs0?HVzD>=-ra_h;)A?n-dXdyJ78; z`wcPqoA#0!U@ol8?Ay*GzB9iC1Aktl8<9F2j5t)kd zd~C9$bT`I|X@8ii zas#kq^63@m`~#}1ufJl^0Fa!>Z?6|5Ban)unF%^IK8uuM^IwSL==S0FBCE{45Sb!a z*bD^6y&4()94fdpa#ogF?#;wd9$y;w#@Sl z!`ko}j#(>L#unF0S_QR-avfT88xs(K<{X8c2ziB=P0`&V;ubzB1?c6IcDqiuw$YAk&U|v|U zY(E((U`yHU_wQT)&q@{Y^stRVT${1^=VeGK&oTxhBdJGa`Qn*za@fad=hC1gFXD;W zeXgyS)iZupA&G#O+7r$68c2<6yvioJ+W8K4exMKhA)>=TN1O?N3rmOwq>#_IHAo;m z3b6hniQFlK5AYp`nIg&<* z?(8P#3SPv&sbv;6TI8JdZ+}ShF0vj!+b```*yiPW`~f~#v@sbC_U~vE`{F2kLU}mX zw79E+dGs!_ks5zar;W{!cEC1V1g!8x@)uK)``Nc2kOD+eP~D`??%kF2HF>(Xy2Tov7=sw22<6NP{7#+oO+kp?NAktq4kX&(mXmYW z4S8=Pi^}D|a7oqUCFvt26>ellpwQnt!lsavPvC4YCArsPBAc`u0Ec2zrLRaELm-3& zFucPjO*z@ryA1vo1HTD3gj`bVObI3{w)MxEywqwzuSvXXmc|ipba;`jBJ6~;+ zgpR3|aWwDfjqy~x=7-|m8Y`|a4~p*>5l!r`ORdz#9B*n6pSU-*E|&%p&m`>k; zBFuv`e}z3LX^Dz3x(Em(Sdx<$9k{@rvNM?9yVoUvx7$51z_@i2UqC*O5Ffm6vQ7Xc zEyr=)m17p9st!7pEe5ssDnMwck} ztZ?RNGK#hX-<@_3m7*bJ`~`~BFR+^gA(-m$#WX64ruQXaZGbIdy9@f?G37+*F34d| z;Dt_1VO2Nplxg12H!MCj_rJLl=;pBSg`v1?hH;P4gp>M^*@@|X(Ku8AZ#^ds=5aN} z9>_CX_1VoT&}=f`et!kF4vhD3X9ma^$$h#6o&*nX@U-5=xQidm@(S z^9thqQAKruQn4{mVqrG9nxpA$wZ7+Gwq2fLT2Hn!QqcY&QyR*AjLOYQ5INk~p`n-9 zqf=i|HtQ;8N%Ya*?dprDE6(AL{n`^%dy7VwFU}G+t>RQeD$bYeFxsm!-2Gr>j+hsO zb5^A1kE}H;a&EhyzGtUeo!9FaAIsyjTo8hmqpHv%+*9qkv{AQmt%lH`=EflU7K z14&5!w|Ro$jO)O=sA@R^&A&cmxyc$6M*&j3A{1ET`p*%ZIoVDF253_Gi-S`n6&cw%8-RHk@DF$|&5{4C@ zp8@IykdO$FCl>{T`GEM-Q-D$(8hWoE$Y8z(&{yxIq)d2{fci^UCbH}_mnP!=ke1eP z2R;UCYay7vr}lNVTlHnHZ)A4R}G{0rk{2Ar|;QFv|MXwGX8pIx)$qy z&6=4^qKzIbh?gTc3I1H?TRfx>cyMCJ`ius?>?Dl zq(ZH_qL!<-h6d|tR5+i->AASP0^DSPz$)y50a4}W!oqsDXs=ow^|2_&dF8Cz`%r12 zlfm3S@5=_w?uGMax4>*~ew5UfEg1?qv!yf+H8vjjPVMfKW8Eu!!$DzT%?au{Nr4to-3}_uv$+wN*eI(AL)szTTuh_4g@X6coz! z&I&deP1&#Cp>>-S4&T*qh*nB(`Q3#$8L6DWJ@DFoME=g=tXK>JSEn~0a-CflS`arn zvf#WlfGj^G-SHQ7aOP|{Y)Fc_r1-UHK;3kk<m z2779OSs&^U20so}MBHSZBkAFsM3X^?FmT3Vf&J@bg{y7Qw7j~71yf;RAwZq*@o8Si zGXQC_E+a}RV>FEm4$Iyi7C)*VZK==h2|O|+J- zX@B(jbcuJ+Y5tkCQ^4J=q45V)mp9w=>5#KG+Jw$p<;Cl!?#nKPEKcm%LfiZ5neWJ& zUKEI*ja_)d9&2G9l9)d{A3bg2-O@hD6(kv1(dv*m#bYnN*-5^)!JA$#cJbVr(zEV+ z)#`wy@rQTCMe&CBqmTDSyPHnW(`iJIKLWu|OeQ3{_X82S_tdQ=xQejEcw_W@=}>7r zvu#W7ky#*S~)--&yfUUod(_ z)*(N$>14P0mD}Z@ZI@Fk)Iw)+$O~-9|sLttP%CAlgk<+#gTHZzl_cJM3uz_8FLw3xk7$ zS;q~c8C5w*pJ+F(^EWh|leK_l7Y7hCL9;cG{e!Jt+*hS1V$=cx+g3ucwc_5PuM-~B z4AKpLOIR6p95$`8#|$jdioB?+XIm*LwF~)H@F@*7L;B5mlfMRgHv^lUz>0d^5#auK zZ}aJG7+-<_I`!j@g39*(*vZ+xjlhgDy~!aA{lIXaL`;@p7onYW)b}8n!w=#%aBJfd z<=DYNWU`UNxlWGmx)`K0wKJpf{J^r}G2d5Z+%bBOOGx;}&L>`_E#E-L*%_f`Q=&o9 zQ<^<}BI-fP@B9@29- zxzl(E|8O*zKEx~W`4L#+S1dGTXCFoE`IIY!PaU!l=I)<~s7l#^ozWw2p(<9PrKp<6 ziuai_7PtaU&#lG^rsuIhguh^Lik>*8)tZQ2TuKKcU3W2yp8NTfPp#JJIiX%W=!2Rv z5X%6=xPwwa^*MSBGnZ9Nta&U#SG-s^3IFbXU}CIBEA1y%82s)o?z{8e z#qF`Y8+aEkEsYYc%#rrs$qj99?Cvnduzy~=LZRul90rg6n#e|rj^ zv9XWODNo(RgLs-!$q=unf+W8)=tdvc3q;?vITzcBV$&=>UJBv-3dZ(@+7o@NDN*8b zIPIrRI_NPvaOSm_C;!EWBCS2+gIqHH;HIBd!xDD3y4usX+_1?!?*v8 z_l2QN%?g)aYJGx*Zry$UToPU+PO%=@8D+l3Yre^P(2;gS+p?liVe_)qebrGFeoEgt zZ~3=|SrTRZdjp4h*?9elWmfB;2}5qaT6Es5+9=v$c4VZl;-{3eT+GNzC4Ii$d3Z&? zzGtJ+D1!Z-?#x@I*97nRDHD&+O(O3<`h#!n;$G!z%?Ff zv?KzrrX4Tz`mH7%8@r-cu3*>y>K9Y#`@<1GS^z-@CM~_@b zch1y)HhhshmTP>c7aLln5SJyq%{`GM{7l=45D-MiW%R!=je9uvn zDcJ^c;;Ze+XXnc?31v&J51EW5j!~1b*+ptOZS;d9%?dm&dtYuf6m~H3A90^hp!wr#@b%g_6`(;?_tM(Hg- zT+nXqtrxrT$~OM*ywDgGjaAzeuerl~1%r1#-@JLiw{a58KW7XZ)&@gcU$fL63!34=X-uTG+KO`_;blH;yec z2{9hCC$TK8;{MK3vVIpUuNX6ZOTp=dkS7%Vop4lhS5qfZlYo>oEq7-3hzM*)zy)EDX64r@C5!qjO_TO7Qj0A#Q-&$|JrKF@-xPIubruGIXl~>t&0E5b-UE_ zB+xiEi%Nb%8mG0{;Hd}3CKx3<1Xhq1N z-(s8821Ja#aqHN8&Unrti9^~1?3&7SlGQ2J0hwo$e3({qu@|Z4KUJJgq_v^dw7G8C z+<5f%*33>_N6q$oNy*Q^N)nB=$Q)o;t!j2_seVU~Re~=X_Es;ca}qutSI0ef{Xth0 zFyB;`029usdTVUkU4*sau}c)LI|_c!2V}MI*uJzHV z3seiFhV>#EpV=?n0Bn&>`w_ISknQq`|M^dcx)aWlY%iFkjhhlhn1@?w$AOj84kB9r zwk^793)lAr!N(=0QnXt9iM*L?8}spTdO;>yY)c_`ADb^7Jyz3la$E+F@5*GYj?X@z zaI4?n_#WS+DmW{_%$Xdsy%=bqpJy<0gZMvcyI;CXmr|%(ffM z>7IUEzd~37jU=gjb?Ojmlq{;p4`m8Y-4A8D-035*u4*vk9#wl(xd5e#!)9x#j*{_) zBcdmmzTPHsaJ@$XFMms5fA*nyMf8z+rfEy(F`J{!oBajJD~TVU7}beY0rKkx8^|^SGB7keJdU=M zNPx!FJuA^E&kCS=(pZj9-wzKJAdQPhYJ6?AKo5ayAT-CP_l4Sb#gp^8RFu$13ldc> z-*6+$8c81Pbo{DYxsSTbKzxE6pV*{4JOrhvfcs@oz3;34#*a+EwC%w6=Gd8G#c8C) ztIeEPs@cn50uA$;ZEfsh8oUPC(X}0Ju727lN5HS}46^m8o?HnBxP#aGKET$1!-0X! z`T7Ii%$;@`yxgKfzn5{ez3^khb>!8x4zyHHkkKXM$xXfF2K_eGJ?k#xM-(0*?P{4i z+AHq45yZent<^e7Uln*#`sEcBU0kUOZU8}E;9G^x%V{9pxf>H;qS2eJ^Rgn**dyPTBEm=YO&JSgmKypYn)~jzdmfSy@Y3 zIshQUi(Cyt+MfZB<^g%u3%9WO`dqcVtQ-j9*63#X=+%O-XtMWh9EY4+Wdr|y3g&13 zy{pUcTEqT}cfS6wz#DFY|K`hF4brZkfCp!P`cx9gD*-awom^Q#zks=iJOtPxk;J^? z%8Yn<)%jCO19*ykOSFpnEGhx2qt}-RP!4dsE{%_j%m7kaszI}Q(PobWLU_ov?9$H2$Y}VAiI+F#jq)SwiL$gB@VwEchu6w=gKespN;S!xdY~Rs!T*f+HtVy|_5afVv(DJH|Boag@%X9la#ea#Qh*5Ej`CE~J_B7IAc zmfoZMfL%nbSL%t9F4VM4Ifu-y^5)fDGQR8{`WG$tPGBUu3ww69H65&|3H=vT39aHY zFH_taVe946gHrlEJIXa`NPH+Z`^E(ckM=xc-IzZG;pkUz{)@(;$b?#5Lj7v(!yBfq zo&EkAt>zUQ&kK-$6V_H~dWyFvOaG(rPxs_T(9Gm)WmwgF!^KnPq&%6!(L*Z6Yq*51;Y534Otn-S z{D|kp+EEQ{W{^FjP}-v-QQO=9s1A?y*1~fk z+^g)NO1p&cg>?no#LA8y@1?o#KGMXT8fGK3dzYPx+NjcbN93`quNgN%*GHoF+41)9 z>NH&>NVh;L{Y-Zc;a`BrlF-^B1Y^SUqBROidA-+l=Wm^$NF+*|5AT-Fr?Bd4m8HVi zU65&&uT1yhyYV@(xCXFO2}~l2bMR9o{7-doN#i;qpKlDrS`RZ3@uMEayynf0YK zY!T06;->a+7w!_6*v0&DB)JVd&Az7&T_pK0bp>yO^2_Y+>oLMEvKHzb1E7G`}@<4 zHLWl1_SY6Z`5AuDRI7tgK7@aXdpp+ErQ!9tTAHJ!Au)Nr#Dq4%=AtIe>A_mIxP818 zLcqEq+xlltdX;TLW|uCl`I{V?w!&0~k9HV*~45`!^^@76>CQn^4M}gI5&e6(g)fAmvo;|(23PuoDGudeEpTB>9F+aHf zK16&N4HC-0C+Phlq0o_#Qawvm>fPz8-5dG(R^a#I@(7I-!5XK@Izp+1#~p z3C!tbnxJz5=qkJLy_R$2@4!%1P7ED(>Jae);`jO9&%X+FQ96X74n-hY+iK8^tVvWh ze2dsxUiPP9jUO^$~kJ(apf~23F%aJqwaxTl*od z^HamSZ40gdwjVmRr5{aKaC;X=?qBu^uh?b(M|i4#Yh_d!{bAzA`5*AupU>I7KbAf$ zK0w>Vn$8Q`AC*C#dAo_Lm)r>-$NG-qel_%;*x3ey9+NSqs|~*DHe&^Kq-NEwh!%h2 zk60^JfsG`jtXhB26-f`ROcA8!(eP4V1+tJ?7^PTN>9=jN3Rng)SS2uKQESKR;+OWm zsT60^!x#U|Fz-n`CDxIymt(}IL~MMxf&>3r)pVb9Xrx8IhBoXTArAfv+%g6MJOH_A zXw{oQ8lwE?`5Ol}r$Tb(57dBH+H}yKoiwH$z072U+K)oA*X1RmbIz^5_e|2~H(Te& zu5N1~SAOmGh`A1EL3`79FLT1vWhWNJB-V`SUk>GX$Fnu}YMhrs=b}}(Qf6l*ml{3t@jQ1=17ORnaK?4=*yl1X( z0eu*ercu@=W5WJcLtr&WS-9v!t3rY4V@*fh>&|KLR5?ve{!F?Qv0XV*Nm~TItC@nK zA5U$mihph>U=!>mTB{bJ?4eKhIqlWrR8qq_#BrMXv}toLvGAt4@3C&%*q};us2UOh z5i@!%A-1asi-+ozPNk^DAxSbo?t>Ex3{dn`7(uM+0!vGz1I}{+bUv&ETN3#BSMh*| zicRZkfN1miqla##4PnMb^$a2`YbEB)(tA-e!&?Tl@<$^ z8&=!hDq8O0wd}Kn7j%hI1xVtXU0wbfyRx;#DF-YzcM`N&(0W__soNzl1iUj7*YUCZ zeP7`l@{n8u$A2R#Nc+cO0DoNpDPTLh9kDvQ_FKv4r-uo;AAVkA;96i&3WHpqEhE{W ztB;T9zW_ln5W{%E&8-S7__~II!v6sUDZ=g&6Kexd4oJx?3=IvX>ML_A*Lev*>U+e* zoZ3w$k6*pMebv%2Kl4Y7?>(2Yp!l zBwGLUIlQ{Nz)FC@e?*7pF8S|I0v~yj{?#q<>hAwbdU&8eW;})ACXWG-okl|x2#~ud z2SH$5Q}E;P6HFV3UfrXQ<~Vt9{R{_2)=hPT>Ahp(m~M?-gEL_L=?l;Pwzg~(?vlV# Wl>nM - + + +
Figure: Comment box
diff --git a/docs/user-manual/source/model-editor-damping.md b/docs/user-manual/source/model-editor-damping.md index b720822a..631d0649 100644 --- a/docs/user-manual/source/model-editor-damping.md +++ b/docs/user-manual/source/model-editor-damping.md @@ -1,4 +1,4 @@ -# Damping +# Damping Damping accounts for energy dissipation, such as losses caused by internal friction or hysteresis in the materials. It affects only the dynamic analysis. @@ -26,8 +26,11 @@ The longer it continues to oscillate, the lower the damping ratio.
-| Damping ratio | Oscillation | -|---------------|-------------------------------------------------------------| -| 0% | | -| 10% | | -| 100% | | +| Damping ratio | Oscillation | +|---------------|-----------------------------------------------------------------------------------------------------------------| +| 0% | | +| 10% | | +| 100% | | + + + diff --git a/docs/user-manual/source/model-editor-draw.md b/docs/user-manual/source/model-editor-draw.md index 2d7a2613..1ee78e0c 100644 --- a/docs/user-manual/source/model-editor-draw.md +++ b/docs/user-manual/source/model-editor-draw.md @@ -19,7 +19,9 @@ This definition is widely used by bow manufacturers.
- + + +
Figure: Definition of the brace height and draw length in both conventions.
diff --git a/docs/user-manual/source/model-editor-handle.md b/docs/user-manual/source/model-editor-handle.md index df36d799..027f7770 100644 --- a/docs/user-manual/source/model-editor-handle.md +++ b/docs/user-manual/source/model-editor-handle.md @@ -12,9 +12,15 @@ You model the handle as part of the limb geometry, and the simulation treats it Of course, the options for modeling intricate handle geometries in VirtualBow are limited, since this is not its primary focus.
- - - + + + + + + + + +
Figure: Some examples for bows with a handle modeled as Flexible. It doesn't matter whether the handle actually flexes significantly or not.
@@ -26,8 +32,12 @@ Selecting *Rigid* allows you to specify a rigid middle section of the bow to whi This configuration is typical for takedown bows with a riser, but it can also be used for other middle‑section designs that you prefer not to model explicitly in VirtualBow.
- - + + + + + +
Figure: Some examples of bows with a handle modeled as Rigid.
@@ -46,7 +56,9 @@ Positive values add reflex; negative values add deflex. The pivot point is used as the reference for measuring brace height and draw length.
- + + +
Figure: Definition of the rigid handle dimensions, shown here on a typical modern recurve‑bow riser. Note that the actual flexible limbs start at the attachment points, the portion fixed to the riser belongs to the middle section.
diff --git a/docs/user-manual/source/model-editor-layers.md b/docs/user-manual/source/model-editor-layers.md index 6ceb16f7..fc352c80 100644 --- a/docs/user-manual/source/model-editor-layers.md +++ b/docs/user-manual/source/model-editor-layers.md @@ -1,10 +1,12 @@ -# Layers +# Layers Layers define the makeup of the bow in the thickness direction. A bow may consist of a single continuous layer, as in traditional self bows, or it may be built from multiple layers made from different materials.
- + + +
Figure: Layers in the model tree
@@ -15,7 +17,9 @@ Layers can be renamed by double-clicking and entering a new name. ## Layer properties
- + + +
Figure: Layer properties
@@ -38,7 +42,9 @@ VirtualBow handles these checks for you - either enforcing the rules automatical ### Disjoint layers

- + + + Layers may have a thickness of zero at their start or end to model layers that fade out (b), fade in (c) or both (d). However, they may not contain a zero-thickness point somewhere inbetween, as this would create multiple disjoint layer segments (e). @@ -49,7 +55,9 @@ In other words, the stack of layers must cover the entire limb without gaps. ### Continuity

- + + + Layers that start or end within the limb must taper to zero thickness to avoid creating a visible discontinuity in the geometry (a). However, this alone could still create a kink in adjacent layers, as shown in case (b). To prevent this, a layer that fades in or out within the limb must have both zero thickness and zero slope at that point (c). diff --git a/docs/user-manual/source/model-editor-masses.md b/docs/user-manual/source/model-editor-masses.md index 78eec54d..314f5d69 100644 --- a/docs/user-manual/source/model-editor-masses.md +++ b/docs/user-manual/source/model-editor-masses.md @@ -1,4 +1,4 @@ -# Masses +# Masses Here you can set the mass of the arrow as well as additional masses placed on the bow or the string. Only the arrow mass is required, the others are optional and may be set to zero if not needed. @@ -9,10 +9,11 @@ Only the arrow mass is required, the others are optional and may be set to zero - **Mass per force:** To compare bow/arrow setups of different draw weight, arrow mass is often expressed relative to the bow’s draw weight, typically in grains per pound (GPP). When you specify the arrow mass in this way, VirtualBow calculates the actual mass after the static simulation, once the bow’s draw force is known. -- **Mass per energy:** The established method of defining arrow mass relative to draw force has one limitation: it does not account for the bow's power stroke. -As a result, it is not a good metric for comparing bows with different draw lengths or brace heights. +- **Mass per energy:** The established method of defining arrow mass relative to draw force has one limitation: it does not account for the bow's power stroke or the shape of its force-draw curve. +As a result, it is not a good metric for comparing bows with different energy storage characteristics. For example, a 10 gpp arrow on a bow with a 26" draw length is a very different setup from a 10 gpp arrow on a 30" draw length, because both produce the same arrow mass for a given draw force, even though the longer draw stores significantly more energy and would therefore require a heavier arrow. -To address this, VirtualBow offers an alternative definition based on the bow's stored energy, suggested to be measured in grains per Joule (GPJ). +The same problem arises when comparing, for example, a longbow and a recurve bow since they store different amounts of energy even at the same draw force and power stroke. +To address these issues, VirtualBow offers an alternative definition of the arrow mass relative the bow's stored energy, suggested to be measured in grains per Joule (GPJ). When you specify the arrow mass in this way, VirtualBow calculates the actual mass after the static simulation, once the bow’s force-draw curve and stored energy are known. A conversion table between GPP and GPJ is provided below to give you a sense of typical values. @@ -20,7 +21,9 @@ A conversion table between GPP and GPJ is provided below to give you a sense of The image below shows a typical center serving with a single brass nocking point.

- + + +
**String end:** Additional masses located near the ends of the string, typically the serving on the ears of an endless-loop string or the doubled-up splice section on a flemish twist string. @@ -28,7 +31,9 @@ See the image below for examples of both types.
- + + +
@@ -37,7 +42,9 @@ What they all share is that they add some mass to the end of the limb, which can The added mass typically consists of the small portion of the limb extending beyond the string attachment point, along with any reinforcing elements such as tip overlays or similar.
- + + +

diff --git a/docs/user-manual/source/model-editor-materials.md b/docs/user-manual/source/model-editor-materials.md index cead226a..1c960e28 100644 --- a/docs/user-manual/source/model-editor-materials.md +++ b/docs/user-manual/source/model-editor-materials.md @@ -1,4 +1,4 @@ -# Materials +# Materials This item contains a list of all materials in the bow. The layers, which are defined later, each reference one such material and multiple layers can also share the same material. @@ -6,8 +6,12 @@ If the _Materials_ category in the model tree is selected, the buttons ( - - + + + + + +
Figure: Material list in the model tree and material properties
@@ -25,7 +29,9 @@ It doesn't have any other effect than graphics. ## Elastic

- + + + Young's modulus: A material's Young's modulus, usually denoted \(E\), describes its stiffness against normal (tensile or compressive) loading. It is defined as the quotient of normal stress to normal strain. This assumes linear elasticity, meaning stress and strain are proportional. @@ -33,7 +39,9 @@ Many common materials follow such a linear relationship up to a certain limit.

- + + + Shear modulus: The shear modulus, usually denoted \(G\), is similar to Young's modulus in that it characterizes the stiffness against deformation. But unlike Young’s modulus, which relates to normal deformation, the shear modulus characterizes how the material responds to shear deformation. VirtualBow does not make much use of the shear modulus yet, but it will form the basis for future features such as modeling the limbs’ torsional rigidity. If you do not know the exact value for your material, you can estimate it as roughly one‑third to one‑half of Young’s modulus. If the material’s Poisson ratio \(\nu\) is known instead, the shear modulus can be computed from Young’s modulus using the relation \(G = E/(2(1 + \nu))\). diff --git a/docs/user-manual/source/model-editor-profile.md b/docs/user-manual/source/model-editor-profile.md index bf6a1a51..5d93ba23 100644 --- a/docs/user-manual/source/model-editor-profile.md +++ b/docs/user-manual/source/model-editor-profile.md @@ -1,10 +1,12 @@ -# Profile +# Profile The profile defines the shape of the bow in its unbraced state. It establishes the limb’s base curvature before any string tension is applied, and therefore determines the fundamental design of the bow - such as a straight longbow form, reflex/deflex, recurve, or any other variation.

- + + +
Figure: Profile segments in the model tree
@@ -14,7 +16,9 @@ The resulting profile shape is displayed in the _Graph_ panel. The plot's context menu provides additional options, such as showing or hiding control points, displaying curvature, or adding an overlay image.
- + + +
Figure: Profile plot
@@ -24,7 +28,9 @@ A line segment represents a straight section of the profile. Its only adjustable property is its **length**.
- + + +
Figure: Line segment properties
@@ -35,7 +41,9 @@ The radius may be positive or negative, which determines the direction in which A radius of zero will be interpreted as a straight line instead.
- + + +
Figure: Arc segment properties
@@ -47,7 +55,9 @@ It is defined by a **start radius**, an **end radius**, and a **length**. Both the start and end radius may be positive, negative, or zero, allowing the spiral's endpoints to curve in either direction or transition seamlessly into straight sections.
- + + +
Figure: Spiral segment properties
@@ -57,6 +67,8 @@ A spline segment interpolates a series of `(x, y)` points using a cubic spline c The coordinates are specified relative to the segment's starting point (i.e. the end point of the previous segment, if present).
- + + +
Figure: Spline segment properties
diff --git a/docs/user-manual/source/model-editor-string.md b/docs/user-manual/source/model-editor-string.md index 156fc687..bf15bb45 100644 --- a/docs/user-manual/source/model-editor-string.md +++ b/docs/user-manual/source/model-editor-string.md @@ -1,4 +1,4 @@ -# String +# String The string is defined by the material properties of a single strand and the number of strands it consists of. Its final length is calculated automatically based on the brace height specified in the [Draw](model-editor-draw.md) settings. diff --git a/docs/user-manual/source/model-editor-width.md b/docs/user-manual/source/model-editor-width.md index e800e954..69e91fa6 100644 --- a/docs/user-manual/source/model-editor-width.md +++ b/docs/user-manual/source/model-editor-width.md @@ -1,4 +1,4 @@ -# Width +# Width The width distribution along the limb defines its side‑to‑side shape, which is shared by all layers. It is defined by a table of relative length and width values. @@ -8,6 +8,8 @@ The plot's context menu offers additional options, such as showing or hiding con
- + + +
Figure: Width properties
diff --git a/docs/user-manual/source/model-editor.md b/docs/user-manual/source/model-editor.md index b30b4046..cc967859 100644 --- a/docs/user-manual/source/model-editor.md +++ b/docs/user-manual/source/model-editor.md @@ -6,7 +6,9 @@ Here you can specify shape and dimensions, adjust material properties, and confi Once the model is set up, you can launch simulations to evaluate the performance of your design.
- + + +
Figure: Screenshot of the model editor
diff --git a/docs/user-manual/source/result-viewer-arrow.md b/docs/user-manual/source/result-viewer-arrow.md index 22b0febf..dd844da0 100644 --- a/docs/user-manual/source/result-viewer-arrow.md +++ b/docs/user-manual/source/result-viewer-arrow.md @@ -4,11 +4,17 @@ This tab is available only for dynamic simulations. It visualizes the motion of the arrow throughout the shot by plotting its position, velocity and acceleration over time. Together, these three curves show how the bow transfers energy into the arrow and how the arrow's motion develops from release to separation. -- **Position:** Shows how far the arrow has traveled from its starting point at each moment. +
+ + + +
-- **Velocity:** Shows how quickly the arrow is moving at each moment. +**Position:** Shows how far the arrow has traveled from its starting point at each moment. + +**Velocity:** Shows how quickly the arrow is moving at each moment. The arrow's velocity typically rises until the arrow leaves the string, then remains constant. -- **Acceleration:** Shows how strongly the bow is accelerating the arrow at each moment. +**Acceleration:** Shows how strongly the bow is accelerating the arrow at each moment. Typically decreases to zero at the time the arrow separates from the string. A slight negative acceleration (deceleration) right before separation can occur due to the **arrow clamp force** defined in the [Settings](model-editor-settings.md#dynamics). diff --git a/docs/user-manual/source/result-viewer-characteristics.md b/docs/user-manual/source/result-viewer-characteristics.md index d0e7011a..89fc94ad 100644 --- a/docs/user-manual/source/result-viewer-characteristics.md +++ b/docs/user-manual/source/result-viewer-characteristics.md @@ -4,7 +4,9 @@ This tab lists all results that can be expressed as single numerical values. Some of these values apply only to static or only to dynamic analysis, while others are shared between both modes.
- + + +
## Common @@ -42,7 +44,9 @@ It is defined as the ratio between the actual energy stored in the bow and the e A more convex curve has a higher storage factor because it accumulates more energy for the same final draw force.

- + + +

- + + +