Linux likely() unlikely() for PostgreSQL
Hi Hackers
When I saw this document:https://en.wikipedia.org/wiki/Branch_predictor,
I thought of Linux likely() vs unlikely() and thus thought that there are
some code segments in src/backend/executor/execMain.c that can be optimized.
For example :
if (ExecutorStart_hook)
(*ExecutorStart_hook) (queryDesc, eflags);
else
standard_ExecutorStart(queryDesc, eflags);
}
void
ExecutorRun(QueryDesc *queryDesc,
ScanDirection direction, uint64 count,
bool execute_once)
{
if (ExecutorRun_hook)
(*ExecutorRun_hook) (queryDesc, direction, count, execute_once);
else
standard_ExecutorRun(queryDesc, direction, count, execute_once);
}
###
if (unlikely(ExecutorRun_hook)),
I hope to get guidance from community experts,Many thanks
Thanks
On Sun, 30 Jun 2024, 15:56 wenhui qiu, <qiuwenhuifx@gmail.com> wrote:
Hi Hackers
When I saw this document:https://en.wikipedia.org/wiki/Branch_predictor, I thought of Linux likely() vs unlikely() and thus thought that there are some code segments in src/backend/executor/execMain.c that can be optimized.
For example :
if (ExecutorStart_hook)
(*ExecutorStart_hook) (queryDesc, eflags);
else
standard_ExecutorStart(queryDesc, eflags);
}
void
ExecutorRun(QueryDesc *queryDesc,
ScanDirection direction, uint64 count,
bool execute_once)
{
if (ExecutorRun_hook)
(*ExecutorRun_hook) (queryDesc, direction, count, execute_once);
else
standard_ExecutorRun(queryDesc, direction, count, execute_once);
}
###
if (unlikely(ExecutorRun_hook)),I hope to get guidance from community experts,Many thanks
While hooks are generally not installed by default, I would advise
against marking the hooks as unlikely, as that would unfairly penalize
the performance of extensions that do utilise this hook (or hooks in
general when applied to all hooks).
If this code is hot enough, then CPU branch prediction will likely
correctly predict this branch correctly after a small amount of time
(as hook null-ness is generally approximately constant for the
duration of a backend lifetime); while if this code is cold, the
benefit is not worth the additional binary size overhead of the
out-of-lined code section.
Kind regards,
Matthias van de Meent
Neon (https://neon.tech/)
Matthias van de Meent <boekewurm+postgres@gmail.com> writes:
On Sun, 30 Jun 2024, 15:56 wenhui qiu, <qiuwenhuifx@gmail.com> wrote:
if (unlikely(ExecutorRun_hook)),
While hooks are generally not installed by default, I would advise
against marking the hooks as unlikely, as that would unfairly penalize
the performance of extensions that do utilise this hook (or hooks in
general when applied to all hooks).
In general, we have a policy of using likely/unlikely very sparingly,
and only in demonstrably hot code paths. This hook call certainly
doesn't qualify as hot.
Having said that ... something I've been wondering about is how to
teach the compiler that error paths are unlikely. Doing this
across-the-board wouldn't be "sparingly", but I think surely it'd
result in better code quality on average. This'd be easy enough
to do in Assert:
#define Assert(condition) \
do { \
- if (!(condition)) \
+ if (unlikely(!(condition))) \
ExceptionalCondition(#condition, __FILE__, __LINE__); \
} while (0)
but on the other hand we don't care that much about micro-optimization
of assert-enabled builds, so maybe that's not worth the trouble. The
real win would be if constructs like
if (trouble)
ereport(ERROR, ...);
could be interpreted as
if (unlikely(trouble))
ereport(ERROR, ...);
But I surely don't want to make thousands of such changes manually.
And it's possible that smart compilers already realize this, using
a heuristic that any path that ends in pg_unreachable() must be
unlikely. Is there a way to encourage compilers to believe that?
regards, tom lane
Hi Tom ,Matthias
Thank you for your explanation.Maybe future compilers will be able to
do intelligent prediction?
Thanks
Tom Lane <tgl@sss.pgh.pa.us> 于2024年6月30日周日 23:23写道:
Show quoted text
Matthias van de Meent <boekewurm+postgres@gmail.com> writes:
On Sun, 30 Jun 2024, 15:56 wenhui qiu, <qiuwenhuifx@gmail.com> wrote:
if (unlikely(ExecutorRun_hook)),
While hooks are generally not installed by default, I would advise
against marking the hooks as unlikely, as that would unfairly penalize
the performance of extensions that do utilise this hook (or hooks in
general when applied to all hooks).In general, we have a policy of using likely/unlikely very sparingly,
and only in demonstrably hot code paths. This hook call certainly
doesn't qualify as hot.Having said that ... something I've been wondering about is how to
teach the compiler that error paths are unlikely. Doing this
across-the-board wouldn't be "sparingly", but I think surely it'd
result in better code quality on average. This'd be easy enough
to do in Assert:#define Assert(condition) \ do { \ - if (!(condition)) \ + if (unlikely(!(condition))) \ ExceptionalCondition(#condition, __FILE__, __LINE__); \ } while (0)but on the other hand we don't care that much about micro-optimization
of assert-enabled builds, so maybe that's not worth the trouble. The
real win would be if constructs likeif (trouble)
ereport(ERROR, ...);could be interpreted as
if (unlikely(trouble))
ereport(ERROR, ...);But I surely don't want to make thousands of such changes manually.
And it's possible that smart compilers already realize this, using
a heuristic that any path that ends in pg_unreachable() must be
unlikely. Is there a way to encourage compilers to believe that?regards, tom lane
On Sun, Jun 30, 2024 at 11:23 AM Tom Lane <tgl@sss.pgh.pa.us> wrote:
The real win would be if constructs like
if (trouble)
ereport(ERROR, ...);could be interpreted as
if (unlikely(trouble))
ereport(ERROR, ...);But I surely don't want to make thousands of such changes manually.
And it's possible that smart compilers already realize this, using
a heuristic that any path that ends in pg_unreachable() must be
unlikely. Is there a way to encourage compilers to believe that?
Isn't that what commit 913ec71d68 did, by adding a call to
pg_attribute_cold to ereport?
--
Peter Geoghegan
On Mon, 1 Jul 2024 at 14:08, Peter Geoghegan <pg@bowt.ie> wrote:
On Sun, Jun 30, 2024 at 11:23 AM Tom Lane <tgl@sss.pgh.pa.us> wrote:
if (trouble)
ereport(ERROR, ...);could be interpreted as
if (unlikely(trouble))
ereport(ERROR, ...);But I surely don't want to make thousands of such changes manually.
And it's possible that smart compilers already realize this, using
a heuristic that any path that ends in pg_unreachable() must be
unlikely. Is there a way to encourage compilers to believe that?Isn't that what commit 913ec71d68 did, by adding a call to
pg_attribute_cold to report?
Yes.
David
Em dom., 30 de jun. de 2024 às 12:24, Tom Lane <tgl@sss.pgh.pa.us> escreveu:
Matthias van de Meent <boekewurm+postgres@gmail.com> writes:
On Sun, 30 Jun 2024, 15:56 wenhui qiu, <qiuwenhuifx@gmail.com> wrote:
if (unlikely(ExecutorRun_hook)),
While hooks are generally not installed by default, I would advise
against marking the hooks as unlikely, as that would unfairly penalize
the performance of extensions that do utilise this hook (or hooks in
general when applied to all hooks).In general, we have a policy of using likely/unlikely very sparingly,
and only in demonstrably hot code paths. This hook call certainly
doesn't qualify as hot.Having said that ... something I've been wondering about is how to
teach the compiler that error paths are unlikely. Doing this
across-the-board wouldn't be "sparingly", but I think surely it'd
result in better code quality on average. This'd be easy enough
to do in Assert:#define Assert(condition) \ do { \ - if (!(condition)) \ + if (unlikely(!(condition))) \ ExceptionalCondition(#condition, __FILE__, __LINE__); \ } while (0)but on the other hand we don't care that much about micro-optimization
of assert-enabled builds, so maybe that's not worth the trouble. The
real win would be if constructs likeif (trouble)
ereport(ERROR, ...);could be interpreted as
if (unlikely(trouble))
ereport(ERROR, ...);
Hi Tom.
Let's do it?
But we will need a 1 hour window to apply the patch.
I can generate it in 30 minutes.
The current size is 1.6MB.
All expressions for ERROR, FATAL and PANIC.
if (unlikely(expr))
ereport(ERROR, ...)
Any other expression was left out, such as:
if (expr)
{
ereport(ERROR, ...)
}
This attached version needs manual adjustment.
for cases of:
if (expr) /* comments */
If I apply it, I can adjust it.
best regards,
Ranier Vilela
Attachments:
convert_ereport_expr_to_unlikely_expr.zipapplication/x-zip-compressed; name=convert_ereport_expr_to_unlikely_expr.zipDownload
PK QC�X'��+� �w all.patch�\{s�����|�m���1&����98� S�x0�Mo{F#�������}�|��[//wn��t*#��o��~��h$��@��� <k�N�ci���*=k����>�'eCW�xe9�|�Z���f�P/�+u�j6���HT+�f�����`u_�����������q���� �2����������n�Jk�?���h��1�=������_ x������?�NmK�B����t_�}���`�6�to�n/.����W��:tl�^�Os���������b����K��P(J�3\S����������}�=�����eg��k������(?��������ra���b(���.��(�g�'��3��h�����3���)T_b
��������;]0�l��|N{=�� �VL��"��WG���N���dj�&s�b2�/1���Y����#������wl�r�f�P
3��^
��b]��� %~����p"����>���aQA�#��IA�^`9w�:H&C��I�BC<H��ht����C�hT��*;�F*;F�^���/�t�M�2��@�0��\f������+F��`�������F��Z(ni��K1��L�:�yh4�e�)=G��=����tI]�S��B����������b��'1u}��Rc��nH���Z3�<y�s��<ixR� 7�M1��Jn��A �-��)<���l��G�������_�vND{�$���E�d^#�����������n��:�����6h�^��j�u�;Vd
0 �)�}����q����z��}�����?�FB�o�n[�N�$���y����a���[�^I\��W�y��������RxF������c����t���Dha�����'��"vpF�w���I4���i�c����Hb"��]�<wB�������;V`�G
PX��$�
�����8h ?a���.C\�]����Y3��w���t�y�(�r�� ����F���%��#B�h��
�K�pQ4���u���DU(�&,Je���{�4�0�.�����,��[����+�F3*!R��y�Od;`M)�~��M�{�����
:��\nV�-+���:�����v�h7����~��c�L7���hX��X����\P���G���tp�4I5`e��t����S�F�Lw����d�|����1�@\R��0$>�S��jU?X������O�
;�����]J��U�7�8m��0��- sv���������M���HI R9�Q���Y}��v��/�5{O���Y�TlF�@Y!uc���
a������m���
��=c��Y%r�c��*(�n��
'I����s�?G�����$T����^����u��St���[���k�{9}�j�q�(P����i�@%�} _^��FG�UZ,D�9!�C��?�`nC�VAI�/�7��W����.�>H�HgW�s���@�
5�<�;Dm�p�YV���-d$MI ��5�����?gEw����[����)����K(f�� ��-�
��W�����98��<�����b��S���?���KL|,�����_4R����J:JT>��(|SW��[$�����~�<�����2����������m��Q\��9?i����!P���%�Ruy�~'��C�Q7�u����6���fB�E�D�<c���T�W����9�P~d�t��%��x`�|���k�@ ���y�D��j-3j�~�7��3���k�`�(c�r9��r��v9��$7���F�>��9��Q{��(�� G6 ����I�55�����*[��1��!PzL����\�/��/UYEK��^`�k5" =�H@G>h����0�pMV !$7,�m�S�;�K������t���1X�cm��V)��$.OY�����X���B�^��z2i�OGC`�LHB�@
}r��s�:S��/��������,�0�t%�H�<3�;B��>�ji�I@� �'N� O��7�,���HY[z:�
�1\��A�%�27���c����vM��4���)>���u�J?&�H�@Q�$�`�j�WheE=�A@�7k}�^����c�����>/�i��/��B��k�>|i=�n�<@�[��Ha!���A���`��J�I=#�d��6�v!�[�!��[�� �y����l��d����e�5#�68Go�Z��������wh�C�����<���*_BD�&HfB�t-�FA5����`j��cF���B7�G�- ������rmd�4�i�;����0T��dXg�{\b
#����K�?a5j�*)�|&Q�����Z_� +B$�����h�K��G�8]����>�=����W�x�Un��QP��@l�����I��#�� #���(F���\�_��%��b ���6YP_>�<0D&V��.�B����Fw�1xxqhm� e�xOQ�B��0.[�Ve�l)=%:����8>"t��Fw)��tp]vL�*�� �N�O~�<l\=z�C�]/�.(��P`�����a����@�Av
6�62R0��9��O�. }>�����O�c��>:���z2�QK���E��S.���������4�`��mu1�\D�s���p
��w��pmJ�-COU����_/K���;���"��}9�>y=�������0���y�4&�"�y��zn���Tv�������R^}��Q�QG�>��Mm�v���� �V���IMe&c��?����L���)D�p�w�O���!T��:Bu��-���!�B�D��= A.�Wd�7>7�+��t� ��6��#$��0���d���n�o�\yTL�0��z���C
~2����6�w�z�D���-(��
���!�����ZPb���!c�����U� l�q]���j��>`0W�@��<��
��%��v�=��t�����j_�� ��_v�R�xZ�/���r��g��E�,��bb�H9���=9���siOx��_������k��'���!���n����A����� '{�&��� x��������|���\v���pl�-��;�;
K\�?urEh���.�u�j nI��$1�"��-����
�y�$�����T��J�X>� �J����-�����*
��1���e��#����2/%�T��x��]D�D�q����z��������K1����xP�&B'��nT�e���7
��*�I��R��[F���H �+�#%R�`�
����C���g����{������"��E�4���I�P01v�����9]�����������S!`h
)M?Lh<���E`��k-�mz�T[��l�� �?�k�������;?/U����(K�"�Q�O����dL�|
��@?;���I�)6Aj'g��<��� ���q[�l�4�pO2Z�d�j"�����F�c����#��6���r��<g�2-�N$9��H)pk.v�q��4���)���g#�\��w���g�vf�jY���=Rem�B*Q��2S1y��R���/��"���S>���������K*�� �8|�i�u���?6��;Zo�EN���|������g�w�:4����>����!oJ�����j��X���O/j��F%�<�o/.�tg�R���E�I�@%��_7�q�(� "0e�{�������n���4W���`6��pf����f�����^�@��_�}��}�=��C��&VJ�$�S�T�����'>��r�h������x��5��)w��w���=���tHZp�9%���W��KV�iKT�#�� ���eS2l� ��j)�uS��Y���B�������Lj��&�q���dcs:��8�C�y#`�#y���5*���B]���%f�Z�"�Vh�'A���,��e��Q�@�]p�u�8��T\�K��{�9��v���Y����V�\���M����O���v�<������:!�xA���Au�/c`
S�_��U7x{�����d�c��<����Xh.pw�;�,O���D[U��w; �������;�E��[0]h�$������7KE����w?v;W�����{���s�z*=Z1���^X��'/�� �j��+ib `>D����-�e�7%�@o��}� ��|P�d �S?��pZ����������\��L�'�Z�b��O�i����0������9m���B52���3���Qs�����@FF�]��c�8*Uk :?������Y�E������py��6��_�[��$.6=X�L�������O�()c�������7��b_�������W����?'Cc����Mp_�63�$�`�����������hu�Q��������r����n'�fY����vV�l��_2��!�S`��vX9#�/�V����IHz��d�����7�^��7�*�Y����@�5���u�gd���I��F��$k��$�1��G:NA��@�x���6�G�� H���� ����V��<7���R7�W��R�Z����� ������������)���s��9�K�j��y`���`�����$a�Z����G��:K�+���P8(\��~�`�pK��z��n��@�_ �q9�^��?k����M5�@���*��Qa ceW��\��Z���n��2�k�g]\N���Z�5�F�Q.�������B?uI{s�����jZ���n�H�!��m�q���-�!�,�d�L�`��F�I�u��� C������;9vK�<�@�:9.��2,������\��Q�7����>�Gz
�8s�&����E��W�s��������V�a������V)��g�rdV�(Rd`���#UK=�����Y��b,�X�^i� ��*bt��<b4�8��������Mm�lj�lj����^xc?�a8��!����k���\���w�����3|
��8�
&R�$���Q�R��8�?p8H��V�3^C�#����jLsQ�q/�B�Hm#ln ��f����Z[�j�o�j�W�����qM��oq��\��6�{�6�KoU���Z���L���j������%�/����*/�:2���F����F��<�[���lZ�v�'I�$L�v �'r|�tm���r/4�phK�x��z�����F���OZ�����F�zt )���s���YI�8�j������E��[Tt��|a�����B��GAfm��wc�iZPO���|����"~� >��v�����{97��"�O������v������|�t��/�yP��6�;�V�6}��������I>_��hk"��){Sv�)�M 2��As��-�>����OY����������wk���TW��������
����}?'.�%dm)�2,�9������u��:w��D�j��3���rI
���i���+(i��k��J�?�����;�y�U���@�"�qXo�� 4���]�4�|�/9j�#Lk!�b�h��+���#����1�% ���/����~�S�?�]���Y�YYcI�p�I0��[��Bp�.n�Oq�aC��;N��I��T������IT� ������nw�\���w�����X�;�%P����qT���_j��C626�1a�5b�j�z�]Uz�i�i��m��8�a�>+��&G�*��X�3����p]�������B�9��lhO}�:C�Gz.������)G�#�����{�YIK
-�����R��z��j��]����&�9f��>�e.q�2(mt�
�� @���A7�z}�:���Z>�5�j���",_���`5��\tG��-Ls��������<�-e��a�6��j,����Y���_V�@1�����RSK����*��g���Qu��'(���&���W�L|>�E��G�F����h��e���VL�[����-�{o����$��|
X�����}L���,�67��!e���y��@C�� ����w���
�e��uv�������������~J��e����^ ��1���;my�6]#CE���
���@�����n���K�\�����_�j�w2K���������� �t4�Pz�����*������'P������@�X�|�\��F��^�~�W���O��� 00&�Uy�r�C�������l���aLX�����{>>@�#�`O�A�4��������t���Jx��d�����d��m�t��ysT��R�?���6���>&��l���������!�zK�%�Uv�%�sqJ�(Y��bCS���z"?������u�@o�����D@�T<�bz�(���c�u���y���������<��e
��
5�6���Q}�4*��zJ�c]\���S)��i����_�dV��)��\1
��,1��=a�������j���O(P�6%ICC
�������(�F�D%���K��������Ya�� ��P��]p��%B��7�.�����W���>w����b5����W8�aY&C��L49D�h��<��N���bI ���^$�����MJ��e��-]O�F6]a��7L�K^�y� ��uO�=���^ )�#��*j����b�� 0�]<f��L]*���%F[(�&PZW���l;y�br2^I�r��4�.������H��X<��
���:J�{,,K��m�\��\��X���H,w[M)�5���,���1X�qNXy��2�8�X��1�Xnr~W�>"���r��ky�k�e���) � � _/GQz�D9��?�������W-a����(�@��!�����\��%����3��F�8���}��2^�����\������|4�5+eH#��
�>4��[���W���/o��%�q8.�t��Li>��EE����% ��Ih��R�w,�q,��r�`�^{_�]��Dz�����vyr>9�/���W��o�#.T�40}�h�\'vl����k�� |���q�j�l&���A>�1�<bgp�����Ji��h��&8n���k���>�Y��'W1W�[2��@xNU��Z"��RE�53dxY���������S��3���1�k'��*aP�������<�*�� �k����a4�����R ����������x�Z�{;8�����-�����+���dT�p���qr�H\������v8��d��FXq�W��~�u58N|�����o�Xz�7��nI)@��bOr�6\��h;w�J�^�9���#����B��9�,dwH$�Y��r���*�H��7$_��������Y6D�H�
�}��Z�Z�Mv�k9��3�FF���:Ow��;��o����:~(����7�����&��o6��HU�OBt*I�{k7"��BWG�1�\f��<R�>��*���4;�F�^�NE]���������:Z��@"h �$X�@8>A��l������p*��^�`�,~`8;�i�����e����&��D����S�[�+X��� �RV`U���������_�9L?���iX
����`�v�[��{���Y���3���.��])����� �v
��r
N�]m�*���;�V JW�|�\y��m���:�a���.�4��� _=��~s��mZ�g�'���C������} ;�[�����r>�C4h�� �y*)���[���4j�j�3�tZ
�*X�y�$�?��5�)�r�T�7��l� <s��U{��������=rS �K����3�V2
��#�,��l��'�^\�K9�$NU��>f����,���
K91��Y�������|�pb7�?��cr0y(J|fD��(u.�^om�&0�F8
��M�db<�1�����s*����Ca����R����Q��
�E.7��D�=�X��?�s�r?\�8�g�4c��Fl�d�+�RR�����o.��}X/�Y;���^�O���~���"��� [Q��q9�����
�]cv���7!+���W�� ��\]�W5����;��;A��K<��h�rH\�� ��&*����[;F���{g��5d�����o/1��6r[P���>]�{����7N�6D�a�[������7��"�+���S^K
C4�i�>�VM�S���]�-��/�A��������#y�[T����b�6�D��0�#5 <\�_�W�wW�e�d��A/���n<%���Q^���`qW���Elh�����!]�r���"L��R�35O�),(�
�+���8���V��U�<X��� %1����J�r��H ���Hj�F���G�?��H�W��z������������WEC�nRXK��%�Q�n�9E^tg�` ��r���}�2�n��V[ut3�k��W}N'���@*u����7����m%.
��+���o�����f��}���p@�O.���)�����L�~�1��]�Yz=��������z���^�H�|�����xV����1�3�
��D��=�����Fi�qc��h�0�K����`�A�[cVe,O�BZ���F��qm��J4��X��5.G��
,A� �h�%�3����l����cn�
3�T$Qs�{<����,��YD���*�[{�lT9*"�.K������f�\�w��dCZ�f @�@F��R����&z����l%$�������/y�]H
c�X�e�h�vx�v�+��s�]�"������`��c����wp�=:KSS\y�)��p��r����0�\cZA�I����%�����������hd�s��)H�x��J;��A���oZS���b[�o�8+���o:�N����E:A���e����
���gX��6�z�Rz��d�b�A�A��
-E����)�����f�Gy��A�Y�kI�A4���nkK���BC��I��G����D�E�2�I<����u�-J�-�y8)��.�w�)����)4eA =L*�+��o��i�k���:���]�)(��!����RqTDQb&��'��w�5i�������!�m�y��-�z�48�<��X�0��>n-Y�3��`�^�)g�we}Q���aLw��tW*�H0������aJi�/�/��A�5D,��\,WX�Cg��\<E�N����e���x�F?��_����2��bx�x�;�+�,OL�A!��&xh7R��
�(mBX,����J�h��Y�XuQ�Z��i��.w��d� � p6�4���L&�<��8iE�y�u$Em
=#':!����@�%�����c:�
�1�b���a����W��N ��/g��&J��_�,Y��P�ZCM�X��j��V��lM���i�F��6����fEI��P,����='�O�
-@��D�
[���>����LL��x�F��P���C��8�?���>����#�q� �����f��l�k9{����U K7,O9��%�%��y�0����x�JmR[b\�w2�O�gO&�W� �x��/��'@�'�������-��8�m�yy�mf�s!�"23�
��������e������� >6�"��z��D� d�TJ6A�Biw�>#:&#���@���E��(Qgp��<��K�����m~������>}9�o�%�0�8��ZF�������V;�n�6m���:V�_++�%a��r���x���Ev:'����+"�����b#�4�W9��rK���|e�6�/��~�!����P�������/�.Rt���1Q�������]@��$����i���U��S�l�z���$��,"�"x$����� ����rI��~4�"���1%���������qW ��|��|�n� �������]�C������fH�4�
���CJe��u|L
�� ~[a�n�M8� ���-��)36���qOS�(3�b�Y�u���8�
��<�\0=��qy�w�������/�'��:q�
���:\���%�k��dp�u���������qmgEI�����5+�uRS��#���Vb��=VN���1�^�6�U����v�S/`���$�R.�.-�@�7�����KS}3����e�������i��jx�r�ng����^I���O&7cR���=f��gzQ����U�f����=���vm�Wo�F)��i�}��+�v�n�$��o�=�B ��y����)����|<�*��.��� n���e[&7���{�~�:�������m�'���h.�
�p'�M�k���z�zN��{�#.uD4����9A�-?�J*6�����a>���. R|e�` ��m�#� ����+�w@��a�A�#V��\R.����&�yX�)������<bt�6)=��P�Beq3�#��&��6q���Z1�iw9-'e�$�� ��KXv�p����m�\�m��c�q��&���u ����eJ����;-������v��5�F���a|96� Z�uN]Z�[����?���K�o
�R6�'*���� j�� $����������[�'zR~��n[>)cEX��tUF���ON������=��k������*m+�#1�k�T��a�E��5�j��mu��m����^�[r��A����h�0/��-�����oQ�L�j����yI��>�'+�PR#���K'�F�K�r"/4.���T����- � [���7l�l�����G�p���+U0�l������������<���`<<���h��/b
�:%��Vxh]��W �2���'���������g���"��� �����|���T�]���6�f[T���)��~�(�gS��_ M�b�I@^���������El�J�>�r5�������^�%��-����C
�G�b��"�
�@��'��������������2�KF��H-�Ht�6 a|e����������<qe�����oa>�7,��U1����t�d������E�o4�F{������t�o��4��$��A�bZ'"����en��0R@^��� � ��������@�2%c�k@w2 ��E��O ��O��s]��C�a�nc�s�.��qby�C����b�mFP�(<6I�T���� ����?��
���Dt��SZ���N
?����5{ ���.��2iT�^f����(bv=�I���;{�5$
��'2T���s�,E?���F�������P��d3m��)U'�L ��5m���lwz��m��}�������1��$�3*1��{f`���J���b�\U���Ps���s^��<3���X�.�'>����zW ���s�7�m#`�O4�&k���zH2@R�o�'����
S�y��3���P�2���/���r���r�W"���{����
~�hO�������5{ �{Q�Y���:��m��j�gZv�lw����xy{Q�9�U��t�W����|<�~-�e���s��~�aw�S�nT��� ���l�y��$�V��#��Cb�W����H��#�tt��bu�f���������l_X�L��1��o:[�����a_����L�����d�i��#��7��)=��W�g�W�gY�o���,�>���2v"G�9�������?h�c������2��������i�3{�����7����2��a��.�} �q\Wx��HpJ[
T,�^�\���p-���\��C���SHn�~�O��k��p�������}i������)H�����t�'�hi��&�4�{#T��)<'x7�+A�iFl�@��h:��G���x�1�g�������:��+yt������� �h�C��b*5C�c� ���f�-Z�j�n��F���M�/�D7��0B� G5�UT#�:7��:7�]��"�?��)/?U�R�a+��?^��^#�H����aQ���!������\���,&��-�3K���J�2���0��V��j5�~��Za�z���5��H)F��l�s+C1s�7W^���
���z��z�:n��B� �e�]�n�����5w>��� �p)����s\�����)�P.)F�g�a3����\���+������VE,�r����TGp���r=������r3s"|�������V��*Ya.����/&o^������x�vx6�9`T�Y�<ZD�9�������h�pr�o��B,hE���O�[��c�si(<y6f�^f���7t��Y���D~��>LT�m0����@������+�^�*@�{/����n�i)+��#M�*��i���}�
������"���u�����S��R�@��>�V�#�;���%��w�'�4u�������Y��W���:g�Q�k����Wb�Xw�
��Q�a�����05f8��^|Z�I�J�������\ �y ��mB���E�O�����p8*�������c/��$�6��t�?��8��r�:o|���W���P��zL:��c�����X�1��� ����>f{2��8a!x�� ���9Dr
��{�G���v�}�C e�$���b��������W��H+����_wn������&�/ov�h����Xb������9n"2�V(� =Yp�}�>|�8�,��8�A���(C�i�=Q�5����� �mt�bo��5ro��^��A���(�Ip�P]���������l��NK����X��_��\� �VL���/�f��NC-���P��p�"����P��=��E�kM�ft"7�
���$J�g�����S���(�9���M�>���.�����(���k���d�
���P�H]
�b1������o"�h/^��b�H5l=h��G���q���T6�z��Wd�@����pib�@�>FqA���"����u�������*t�� �;7LE�J����o��9]���R9��.���FW�������_[�[lsJl
�����e�q��e`��T��,��{T���[{5$�U�F���.��|a"!Az9sdUf�>�����]�a�V�pB��&�[����_\�6�;��/{��
3W���,M��pH�^1L��?E���9Y����/m�O:���1�!��r���2b���W�w��x�6�����#
����C�T�.�v�mY�������c�G�%�$�/��b�PX�L�64�d�W�"GK���8���ma�a���Gy�����Y�e�v;$��k�)�W/h@0{<>@
1���� �K�0�~���6
�I��t��������K�!��M��B
=y��}z���v�q���j�N�#=�8���^A���,�)���~��l������~ 4��������b���[�{�-��\��`�����T�Vxr�����#���f��V��M��VI�q��� ���T��S��}�z��WKC�����Q�#<�X f)R�����h�q1o��]�`��$��W�F%��?��eW����D[�{l�kU����8�j�C�3��'(s���[��Q��0�q�CE��g�����@�!��!j�^���V�V��3z�nA!������1��d�%�!���T����s� \�7�/q_x�=�z��u���n��5mcV���������sx]���:�@���R\�K�pZ�e7��#:[�s��N&Qu"�k9�(Eb���I�4�<7����_� mZ���ol��6�/g�*V3^
/4�S�b�X����>��A6��Tz�l;<�g���������Ab��ANZ�5�_$b)�)��Hv���p��vV �7�N�[�uFK}k�|[��h1Z�$E��AI�=���kG�@�`�2
^���5��1�����^�m�(m5_��,�6wdM����O@��m�x�6�����mPNo.���i����]*��`,������-H�y2:�&������n>������OL ��6I�!��M�9��}��V�fC�V��(HQ��:�9�"a��@]z R��J{ ��(��W�I����>��m8��nJ1#�+gr�/@����Vy����`�G�<|�L�����W0���sm�/ �=�5'U_�Q���D����%��M�[�c,�O�~J��� `m��K����gYA(�����������j���+FX�V�a������mDp��uF��� 8R�un�Q��"���,���kt��hT��������-��[�S�`�����ruN.71���8uqVD��U�8�����C��0�!��ch�=~6�4��!v�snND�~������N47�V������h�^O^���Erv�h�e���TT^���p)���@��a-�g|����4����c*$�����'Y�nl�NO�@q��\����d�����V^��@ek7�������;P�D�������f�����D���h����"K������'xJ�aE�> �����"�����/p#$��(JmF����#������uh��:��&�~;W�8v'<��zq���XMU+�I����u��8\G/�����8i���U!�;�3*|��_�(5���'�W~�
�Kx�l!p�ON(N+�d���r-�#���s���� �'�=E��q/�'���olP~����&<���g������p�m��uyCR6��hlkc���r��#�H�m������P=y-��}+%�7$��S�����^i�G���>����X���,6<�P�����.@��� ��<�"�����?>�Y�����U�P��t��1 fJ�'�O�����+�����9T�&�w���d;a��V�CD}\-���-C{���J�� p�i/�~�z����MHfp$�8�S>?���J��� �tvR2���B�t����mI�������v���&��w���lxu9^\M��J�Y�@/�W�������j����
v�B����!�������fg��w{�((X��;]���-6��Lg�|�&P���j��dP���sb 3-Z
|)����h���SlG8H��:�F6Zv@��Gv��.��q��F%��@ T4
Y�������H�lp�yy�[�H�/��/gN����Yy�QH�ZS�q���'��P��1G����jp<�h'+�����'�&F��.�<I'��\���G�����9Yv��������~|��r�@���!rm;�����H�����8t��
+)��1�Y��������}����������,�������CWHd��9������`��dp�@�8�k*]��_���o����^qJ��Q���Z�������rn"t�:��J�5J��NjqAJ�|��.���Wn��!\�R1���Dj.������D5�U���6�C��c�Pa���[b�@S�
�� nP3�-��(�`zS� �4�Z��V��8_���������X��S�������*���w?m���<��,�vp�A�@�
��V?1��������#�N�K��p����:u�^v��?�fC-X~!�[������sddw�Qo������J���q�8��o�T!�c�0�_������X|����}uy��/��uI��KYZv�#`����$N�M�g�Y�����2��{������KA0=Q��G)e�2�V.$�26��tZ���\y���b}��
�g��>W��{���Z��]�6la�Z�n�D�R�O����%�#=���z�����V����� �u�U���O�9��/f�(��*c�(�fB��X�5�"��2Cw��;y�����r���\!,X�hV�
[�@~��$'��^�w�{�F>,����{��'(d:I|���N���
���j���I�dl�6���?�|-� w�P���2�8���q�� }Uv�+����VK�Qp��m���\���56�Z9��}_D���9��KUN�/cN����)���C+
$���������->�ous���lh�8��@{ �]&���var���0������<ee�; !���;���@���f=�~^��!�>���_
2�`2V�D�oZ~7���C�[����4����q�����-�Bjbx����r������9������EYv�:���������zLt���)7'8�;-iV��x<��@?��U�{}:��1�'���������d��p����t�k|[��f���TQ�s�F�+�]�JM.g������z,���������+5[
�l��PB�F���1����J�1���,��y5� ��_LgxJC�J���M��,��0��W8�IBb����w�"�J�Ji�k���[����z�n��tZ��km�.���������9
���P,N���*qT�s��k��pQ�-��A��Wb�k�������/i�8�}%�M�okqG�<���O���p5M�`��m��� �Q{��U��N�321��@`�F�A��s&��J�]nB�K�@�������
����RE0i���.�,>�8^�����g��WW�sp[ �i���|�y����02B����a���%(��P���pA����(����#^�i��l�C���e��X�r����FY��ctw��D�Gw�����<-Sy&a��3�2�T_��g�����j�_�k�ki�WD��������7��~2>>��l�B��6��a��9S��� �WE42��S����o�z��1:R=������c\DY�=��O�M4��:�O�����u��L<�K�$ 9��S^���f��=Q�V
C��a�K"��7�Q�jC�e����X����{4����� ���~��7�P�['(]�x�L���2�;M�a%=L{
��6�~�Zm�:��6���2������x�����T��[s�Po��~I�������'�o��X�w�rAT4m�S�6��Z�Z����~��-��-�*3��`4�lzh*�����g�����r���'srP�im��\�
��� N� �E��T#�����kW�@�������������
��L�Y�Fdk�o�x#����}�l��d�Z���"��\���H#d�������,����T��v�>5|��a������b0�#�d���������O���t4-��(��i�UYI�iB'5����9g<��5,E���0�
Q���#��vAhqA��S�8�+7���m�l���)M�(_���_�'����*I�}7�8��[� �9&*9���qj�)8������Sq����/A ��`�P�>������4�C�at��ka1�"���|e��K�����I���0�t���,lD8�r�����B����T���
�M����)�"��B�L�k����
�{ ��a�����} �|w��[�J�����p/���Fps�1���P��5��_
�K,���j�����\ �4�-
��v<Cx ^��5�����������#x���uF��Z����Pofy ���E�NV������$;�����|������r|4�[��������x��1��$������_Pf��x�ir��%ro
cY���6��3�K�5o����]�3
�2��y���U.NF��,�
�jG�-��Z�� T����G�N��D�WK�3�y0�3���p~�-����P�)3��#]{��[��7<U,���Nr�
�����$���`2z3>L�n��1�4�m ��������b[�=�r >�D�����+J��B52� �������/=� OI�
��I�6cn��-�~y�$F�n�}9���� yD�N~�iF�n(=�zoV���s����"Z�J*R|2�n5�pf�MJ��,RJ��`��k�E��4�U�l����2�����
U��R�����J���I��i�&pY��'���0|$
�������%�t3�P��Z������r�ex,���B�X�NP��GV����l*9#�oA�S�@� U'��x����
��4�����p�5��z����-��� Z�}wX�U�����q�x�X>�$�5�rf��Ii9ayR��w�0��i}�Q�����~9�ja3;�f�U��s��2���/����.�N>!���
��Q�%�rX��>_| �����~�����#f������.��'c4�����
�I�t���:���F�j��{R�T���
����6�^�f��ns/t��J�Y���s�����B[��'�����^��FYo�"����h������v����[#uf��i+�iN�%vgF�6�$��3���Y$A���*��rn�%�2-���~�5�[�
����]�J�z�H�Z1u�4D^��R����KyV���C�^h��v6� �����N �\��O��s������>Z�����N{���~|vF��$b�4��u<�d�b������%�A���L3�<k�Z%�"/�@�4��u��D������3g����Ul����O^���TY����>Q��Q�X��x�rM�oLE��y3�nA�=���Q��"m����_+r/�~[ ���q���Uc�1�� ���gq���8W�\�'��W�S�l�_����x�])�������0���k�����V��j�z�V����(�+�e���b������@.=:����[�I�0��%���$
��/��T\�Wd��2������le 2=p����^�K��cb,[�X����~�^z�k���YW�<�OHR�|ZM0���N��h��IP�l�;r[�����S�p�N��`���!���Gx�H��Rx�ra���6X�Y�P����y�B��a��Et���"
�W."`C�$�f�
<�
�`=���t�B���oh��S�Nd��I7��6�|������B9;�����v���>��0J��c$+�����Rc]:W�:���s�B�6m���c�����������u���w2~�������(�L=P�c)Hy��dp��U�Grd`��a^�{
s�������
Y3F��=.
�I�J�s�p���Q7Z����j�Sk]������nM��n
,Y3E!� -WL��������R�#W�9����i9��x(V�x
���,�6t�-�����7|n��^��x��EeD�jb�PQC� �hWx8o�1�������{��4�.@��<qbb\z �K�R���2:0|��]cf�������_i�W'Y^_4E�-��^�*Z�tZ7�f�����/������O����Ca���+<���6T�����OaG R^q2NX� �~��j�����p�@����B'�,tb��H:��U�O�� ��(�����+� �-Q�0�.��c���������g��S���QI9�E�i�V��R�9[�huz
s�'n��B�
R�m�>Ib�����U� �Ro�7W���~>8��J�:��_Q�6�*��r��O&l��HUV m
TD$�����?�� J���5��%��
sL7c�?�WE���a�K��J��,�*�n-�S��4���B����D��h|~|E;'���h����EG�Z �������#����H��vx$���F�4,K���P������I �y����JX����/h�G��� iG��X����'�?#������� �y�s����2���U~���=�.����*�{M�~�_
LhLo��Kf���<�����L'���H�GF�]D��N�9���R`�Kx��}x������}����v��9.a�\y���aerG|[���HS��[G�qy�Wv�@:����W�FD
����&5>U|���g[��ly\���L=��&y��V[�y�5k��k���J��"����-�:����Y?������5��Gv�[,����PY��:Z�z|�!�xS,EqacUKG��0�=,8������{?�V��!Vbx`z'���W���k0}~�aH�V�u�X���P>���h��eo1J�����b�ei���8����^����~�|��%j��K�2p�K�Ebc4 �h�����������rr����7)�� F9�i]�����x�kw��i�(a@a_i}���S�3)��
q��t�MD���0�7|��
"������a������w��"V*��]����o�Z�~U;^bZ{7��c� �nh����@�Ac&*���Rp�����,��pwb6K��2����=�n���z|�R(�����TY����ce�����0��F�j�F�[ow��R�c�������fG�a.?H��R�B������|`M� cW;L�n����2���O�V?���P�����IEu��vC��@�LH���F;���l,4>����#�������~�f���R�x�oM�iQ���^
�:A�}�������qL:B*�����u
�a���eJ���d�!���������rd������������C�Ky�#��:��t��M�����W}
�JU�|����Qw K�����d�fXh�L<,?��;i���\
/���W|���h�il�e���7�\�i��(<�Kp�������A�+3c�{�z��{5�����oO�[t���p��;�_���O.7�V��Q�Fz���QG�\r�\�����/=��s�2���n.��\�2/=H<����Ja.V'�i�*P��h��4��F���B�����1� -.S�Ru�������%�k�2�t]"���u,�Z2�
�HR ��<�i�G0���QP�������EB#������&ihy�����C�c)u���2��&j�vs�6j���(E�
D������dnx��Af��y������>��Z�.@���I�MR�O��p��u�[��G
Fb���<��[�+3���O��x|��>y�br2^^%����g���?���r��X��.���v{��P[���|$)g�}%��
3�iz�7-���������)�5zy�W���?T����Vk�&�� =�`�=}s����hx�Bg����k�L_k��t���@+�P��C��f���
���+����������GV�K<�F�[���;�\���<(�K���OP>y��}_�� 4NH�DD�_Sr�����#��8����� ����r�%��p�ON�CR�
3�=��Ox{��.��3�4�gn_��>�h�������?�t���+�0������(���j��u,�e|����Bl��B����O���-"zXbE\�K^F<�-�/�&������[�Q�c�����!E?����F�o6���Q�LkFcZ�-�����E�G��zO��/��(�\��#+:�y6�1D�A��^
�s���A����t��o2r�4P�=f^�h��`Xy������^���A�HP-L�_Uk
c��Bt>���*, �F�Q����`�8�V��0�5'������#<�%og����C�%I�d�Zf��h���������V��@_�Y�1�}�=������X�ml�X;�f7+H*��|��Z�Q��Fht���m!%��h���[�5'�����&����5+�Zf+����>]���<���(a��P����X�V�jf}�o�z������� W���2��"W8S$���,%����������|x��e�1�w�\�l��8�z��h�y��g��;��,������b� 4�������|`����6��_�0�|Zyq<�_�9��}���!&�8�#NF�
�����`��llP~6K�^6����i��( '��tS����QX��?�.��]��|���j��WN�k�]=E�4����U
��i��}��������� �aU����?*N���_��J.��X<<���S��)-?C[�j�$
�T.�f������9|'�d�?�����@+Vx@a������<�KG���]�R����\l���xf�S�iy�m�wb�?)����b&9a�SD��Q��k�-���U�6�xh��y�R���5?�%�W��m��<n7��W$���BM��1�����7�f�hCh]WI��{}��@$���
v4���4�/+dh��H����f�F������2#��i���������o�q�j,iC��7��$���7�z�~�����n�4�-�8?QQ_�lh
��F]�uV#���?r����Q'l�%��o���l?�������|���~�1�����}�d�?������-POZ��K����|I7��l��'
��i663,?�,������@��RO\c��,����������PE�:�_��2�m�obY<@hr-�Q[hS�j���iU��i���[��Y�����B�Hl��3_�����:��[`�/�p�� ��G�ho��sc�D�V*h�'���i�+��j^X��[SU�9������0�+�y/����P ��+����/]��x2���^6��<^��6�s����3���\�]��� q8yMO���K5��aF%���g3a-���J=��i���Z���U��j�z���%*�g
1�0$���"��lb�������d:s`*�����D��Av0 =�p������0fjE&�_q��8|NR�Q��%E)�CI������a�K�y �O������weD&�Q�EH8<�(����w$w��� ��4�=�Tc�{����y���vQB<]�m��w�-��U�6����� ��(:���&2BS�5��|��Qk~�K?���jpi�q���PN�Z8L���nC+ �y�p@f%wjH:$Y��\nsw7��d���p�^f�mU��YD11E�b��w��~[9^>
����t��U1��E�i��B�!�C*#M��.j�� |GC7����$�]��Q�
�5%)��tg���1����L��3��`>����o�@:[P���������Q�I=65#[w��fI
3���c���j��v-������u� ��j�����������������+
+0O�������9�
�+UU��9��o:3#,�l�9��� ���t������U�('��#R���i;C��-:��j��<$�g�G��q�p�'B\%��M1�+2�B���"�q�k?2#�TNw��)T�������k��P��Ej9�+��X>NBI)�6����!zv��h�v��i������m�����u*��:I��aJ�����b�Y-}������t��!������n��lo����e��tY9
��������b[y��b�6�@�������{�`���_������W������3auC�Q�|5L��7�gpAMG�:)�G�d,��%�q��f1����u�\�����<�mf��������f����EN|�O�I����FL����f��&��%��?���X��}�Q�-���Nk�j�Q��z�V/��M�O���3��dS]UlJ�d����L��<��K!7l�!'�3�]}��vcx�
J�2s��aw��9��v�,�v#�Z���������E�]���B>���R��b���K=Q\�n�:�z���V��c���,�:I��O#�)RI�F�/p��9����_��G�gE�dpx��g��3m��V3*��N�3qH���{�RT�J���0���>i��o �hn`y��f��(���e��`FY?������1��B>Q!H�~mj"9T�V��n��i�`N��O�)�v�+�! ���������H���;�K����\����BP����
x�+H����u���D�����o�7`]�4�5< ��8 ��OI���m���
�3�*��\�'i��a\���������+^�W)�YD�����K�v|9��@�����&������9 W���#a�?��f�l/7���H,���W�gE�2?�xv
V.�N�t�� '��y������L�2�$Q�8���r���K�f�a\�����\?�<�q2�/�$�O���/��h�>H�w6��� ��j�S@t�<aiv�T(�b�65)�0����W3#e��JILR��8���$a_��Q�(�CYdr1�'`��i607����L"a@�VL�v/�%�>v�V�@���M|�A�m��rS�o� �Mkg������f`��
3T��BD�@y�~J�%e"�����Z�V�gDTy:}��.��;�;��1�������������,�z�{�%�)��N��((���RR0��!�bM9~����K�% g�R6O��|���RE ��G_X����vBo��'IU�B]�p#aN[-3L�{!
�1�y�E@�<f��r*���O��sq
�]���DY8P��c�5�>#���w|����:B���R���_�9��H�%k�/nPm���FL��0���3����~�v ~��V����0��o�m�$���c�}2���Yf"�C�j7�4:�*8�C����t�V]���v���z�V� �_N'�jN��#��tR���*d(Q������r�>
��� ����"%��,��J�1��{Q�A��%������I��R�^>�������[z��$&�N������Js1[��'�Z�Z�f.]��K����w��(v�V�]P!/�A>=��DK]��Mi ���^�]|O"��j=6S��8f�w=?�<��k ��BULY.Ac��lP�B;�\���Y\���/�mw�
FG��]�<t��{�*�H�(��{wq�9�/M���� �{
�|��q�g�f��s����@�tSy{L���"'2��qj<�6���������J��d+���m5���������-
��S\%�g@�����O�������wHA1�7�)���V���$���mV��x������1V&�r�}�{w���m��:����`x���0~T0�"7C/[����%|�@��tF������Q�o��p�5��Rn=�>��Qx���� �:�����f���z
Q������V{�N�oMc
�f���n���.��HA�I:|��T���86QH����Q���Rlf�l�&h-I��������F�X���d�ei?b
��c���M<S��b���Z��W��mN�������dY�M>'��d�}3��H�V���n �d��T���L!h��<��H����L��=�[����Rq-_4�O�'l��2��n�)��j����M�Zm
�����~�xJ�����T�$�2_������37�{�q]����%�Y��d�Y���^�v�����q�];�BC��=��D��4����WMNA,�F�4{N<�fozsq:x9D}�dt��<gG
�t�� �/V�s�p���5T9�rV��!-�W��}<�*+�{��"�`�V�&�N�<��t��a�)�O�@8�h:vM������#��)��:dn�K�0�Y��"?�"�]�}��o�`�9�V�A���rf��G>^����@{r����Z�@,�B������w�a����4
*K��K������s3��T$5�h�}o�����Xy���B#�T3�����:(�fU-����ON���\��,#���q �w�?�Q8~��1������a���&w��3�#f[�����b�[�n����Y���#�Of��9�7KU��xrQ�'���WX��'��=t!�@6|�:��v�b>]���^G�+�*x�u�]�<jP�m�qy���c6]F��h)���?U�� +/V�'���k�����D�&�/K�h��O@���5Y��R��s����D-���n>z��z�!h��J���
���+�%�`4P�e+)��wU@��y�#S^1M.X�T���'\�D/,��c������(p��=a���\7��] ��%OTA��q7�7/�
�����u�r���p�������U�_/�����_��\0����m����e�T� $oF1AV7�oe�&��\�%��X���|o����r�-��X���'W� v�� �L���gJ�4��<���8�BK�]�
M��ih� ���,��$.�Ey���(�����r����X�F�$'�����J`y��)�?�.��C�����'5,�B~�?���m��
���M�(�J�HZ:�&Y�+�K��x���^��&l�
5���#�+!��>O����������7��V_�F�p��OR���!!�WX]�0k��K�;��.���P����w�����g�����.�����������w_j�~����������k���lI��J����7L�uu���Z��i�Z|���8���_�w���7�Lm�|��K��zG�PN�\�
a$��e/
����������7.1+ &d�J��on��>�>,c++'�~�� ���Vs]>�/%��W��R��o��6����F�eF��cr�5(��1>��6�u����$�\���=Q�a�hL�is�T�
<��m���29���G��6>��������OD�rS��g���%�riG|���F��=x*�O����#Y������j���s�C���%���|���<��mUP�%lv�0_�,��(wfFM�9�Dq�l"Em'�,���0����
�.,p�i��a��wq���tt)��FP1�f�Ep�Q����P����g
�W��JDa����Q�C���>s��IMN�~[����i^���QF����) B�")/���Z����m�F��d.���rl��a%M�)������=�<rO���Q+����������I���F������U�L�Kr�w���cO����o3�(�X��K���@tP����XL�*����a��A�����p��'�����!����4��E!�I�q�PJ�g 9q�E��D^��LC ^��p]� ��������pB��b�wV�����2�ri�I���+����^�A�C�raet�Mc
yr��r7����A)�������a�[�+��T%��(�d98��wA&$�������\,bo2�a��<�������;t���@��y&�K�WTS��3�+��8|�y(�p;�q���Jx_��l��x�FzT��=D�$R��"�j�x#��0�U�\����4�/�cP�Y��,��N�����B������{_����lmz�����2�U3K������c�5�O\S������ ���?r��-:�W�5]9x�K��K���4b]X ���|.�c,Q���r��y�^��N����}���p��L=�5otK����� �?�/B\��g�E9�}����������mr�.���������x�8~��7}���Qsh� H<�������
�d�-q�V�N�)��J����X�4�fq'��k�E8M����:����+��PY����j�B7P���%���Db�� M���s�Pq��3�Q�)�Wxt
���������B�[gp����:UZ����,i����6bk���FX�!4��`"��J�'f�|�?`%�j)>���+SC%ln�)�>�p���u���bS�~��={DCt(}��N�x�T�b���~���;���'�Q�g������f:����6������#�_I)��iA���58�jm&����Y:
��crk3^��B�����b�aU���T���L@�Fx��2�0��$���u�, +��-��@��?4]�_��O�S3V�i�-�^���iw���"o��m��/�O��A����� ��3����^,���NA</��;��h�>}���|�B���N���FK������O�����l����WG� B1h���c}��l��xt5:��o����<x-��X�h���n���!�Xy#6���m{�aE}��!9���\�~qU�::�98*���X
��Z0��]!�^���x��C�������8��0�|5��m�����"}�%0 o���O��p��������8iF�����FK�M�<��;'w�%�3��(y1�v�������n{BT��;�(�'��p�s�L��?u�@�4dJN�����v�/
@�������~�Ny����Uo�;�j��5L� JlA����R��ZX"���+���5C���@���-�u�S�NY������6"K��lu��2����X��k�~0�2{��T�q1`L.h�Zb��I�=h?
����p�]G' 4��������?�FN�z%���y�I�Q�A��[cu�w�=��#
"a?���56�s����$�d�2��$]r3��q������y�u�|��;{�������a����j�������q��*� ��C�<?�N��Iip A���'� ��,u1_���>���z��u���a���={�W��w1oQ/9c�����bG��rd��s�@��c�6S8�x\t�9 �=x�
z�������~�i*#i<p�8M|�'�9|��')���4?���?�9�������I�f�JA���V�����jg������)�p6���r6������]mA�S����7h�L�� ��E@
qaJ�j4�6����y��z����a�G�m���
����v �OeN�!>��|�R�(���J�g��kE`��mr|~��#����.����4&*����J8�o�*�����*VR�]�um�����U�����,(����B�*�g5��KUu���Tum�SU"����
8�������8U���s�\���@9����.|.�����~Z�3���.���m)p��k��$h.�������N�Yk��j
��t�[P�!��$]�A��=����sD"��du9�x��r�Z��Dk�9+��2�H$���#���������Bw� ��,k����+O��@�!k�+��<���.^_�/�@���T�7�Uz�����Ka��aM��9G^A���a���@���LHB"��|�/�z9N����J ��f���f��m��|��6G���)tX�����OF_�U$����p�Q���O(��bry��O&{�O�����~�v��/���� �Gj$���`��K� �=����x�Y��������b���>��(���������V^�XZ���$��VPJ�R$��V�u���e�W�W�=W ���F���N�:����������I��\�X��*����
���/����#r���,��0� �TF
@���>)�V����<����+��5�}F��%}��]�U�<��p��i��Z{_:�����+<��u�o4��z ��w�1�Q�Q��Y!s_6���}4�[+�3o[�Q/ ��~4�u�����_�d*��F���
���)+���X�4 ��^�q����MW���� ��� �.�)����� 4A;O���gXI�����h�rp�(��sF������sC'`0������9��G�G�H"����|��,��� yC]H������=�h�<2��c�h������?�g�g�Fp�`����SO����nwk��;m{����F-�S'�'t�Na�N6L��
z��g���E8c���d�2�Kr~|��o���t ��~98�x������~��!��{q��v-?<�a{Ox7e������&�^\�+%c�*5�5�O�?(IU%D��.��M��0k��hv�V��mc5������c���c���
��/N��P���I�/=a��@�����lX���0�]���N�w����F���Jo�P�����I�a%cO���Q?����Q�3�a�l�Z�P8��gS�q���� rv;�Nw*�N�:dW��h����:�9� �3��s�x��������
�8&m��g�{���]�3q��k�U������Z$���� ��~�^z,Q����*�~�.�����KH>K���8�
fd�}1^h��@�V�"���Eo������$a�UE7��a,_��wZ���}bH���lt������`�V�&���}�x��|0���I������n:[�P�]p�a"��f3%0�[-�$��mh
������1���Pi7��3�5�# ��."�[,��1�����F&����pz@>����[�$7 Y&]��c1��&���������9��'Co'Y�6K��_�i�TQ.���*�?�Dxk�id|&BZ�.s
���IK��K5��z�L-S;�:\��K�������d��������������d#�nGO�x��JC�'n��r�L��\�F_X���+��f��iM��FQ�%�6�d!`(����{M (����%�=���_ur����(����\���S�_Ct�� ��0=������s}�%����^�4[,��D0/V�tl�<����sq����b�R�zv:%�0silU��� ��:���aT`�U��9������ml�C �w��h<~s���.�L�b%��;�j"2���� �St�� ��$]���������c��a�U�9��Q�����7������O9�cXJ����B8 ���m��K�Z 0p�<�\^g�L���9J�ce[��9�{�OD�-�2�M-��I1����2[�>e �����=����W���������UZ9�%"�g��iWE������pTj���x���YW� v�������VE�p���������W~������+WB��8v����Z�
h�4(F���;�����3#�lW) e�����v�[��E��O��7�U��
7�4 ���J�s��b��4��U��X�"~�o��hL���q�R�n��,�E[��=DYj)��8��*�N������pY
����t��W����r�e��F� 't�����i.4�c\��= ��M��H������
������@8#m���=A���@��@3��^�������:^�n&W��I@�l� �F�*3�e������OU�~*��3���%��j�0h��1Q \�Z��QX��6"I��<��T�Q�@A�]xUN�U�V�;���j���u��
a�eW��6q�8,1�z��B|�[�%%dj�x���aB$����}�2��/{Z�6rb�r���0����,e���i\��]�F�������$��E�eUf�����&>�BX�6s�@.x+��td��N=����:�����%�,-�2k6�d�i����iV��~���is�QA^��Vm��G
qO���8�f��=\�S�@dX>&�����������:�����������0��:�I�-G6�6��Zx�6�m�565�>
����Zp��(CAhm �\r��1!�J������w+C���K�)?i��Z�S����`�;��L�z�(3����x�j||��
��Wt.?8������<�����+mz� ����Ws��C���\P�9`���r��r�Z1m[�v���m�k���V����p��M #�ux�v��e �}����-��*�R-�����!�
�d����&
��� �~�A����u��|
'5��[����!�6�����.�t*9�2CE�Z=:)ai�C�
���v�(Te5��yu'r�5l���_���I���b&�U*�������
�h��Z�#�3r��4Lt�OE9�X�1G����^b�r)�7"��|]���Du��dp9a��Y�;��'~e��S^e����k���-�(��+�d[=i�n����@�.�G��}w� ���:���D���IG����-�D�"�����A���<��:����sv�zr�s�z%� ��p�,�s������Pb3A�����3����ex�Z
O'�T^��"owyB�
�8�k����V$����}�y�*�SO�G�f���%���NL�
M�5�Y���#�WE��v+s�e�i1dyZ6W:�L����L�V"�)�sA����G���i�B�������$)����
��E��r&��
m�����`/�US!�,�WU��mK�[����6,�0���o�����N���|}�Y�r���P3O?*��{����������g������|mn_�$���ORCNR�N�'���?�i���� A�&
�}�3ec���xz�f��r���b���������b$�{2�Ri3l=�<�J����g���&�#%Q�\�U��hh����tt������F���m9��>�'�n�i��2]�R�M���E�lmf'$�~�5�J�gg�N�7��f��-��d��t��>6��9�����h��f��T�����Y���j�y�nR��� ��i������u�P�`�Eag,N�\9���0�Q�'���^{{<F��=�o�>O���x��4�$����YX�r�bA4�^������#����y^c�g��@� ��� �Fj8�@N�J���<�������A���S�C���A:�^s�(��� �}>t��3����R�:,m�����e��W��F�TB�`���l��.6@t���|%���)];.�o���/�� *����M�-z�j��o�0s�t6��]�6I��PP���1�����|��D�2~qu���)$DLe� �����h���1��wl���bqx�G�5�17>�o��:;�?��+e�M�z�6'��m�1����a�P���Xh��{]F�Xn���������������������i��ZF���&�x�(!Kl�&��H�����\xs:�������_�s�!��<�&��ty���L|�12�j�x�\�Ln������d�>Oe���:��{��F�[%�g$.m�6L5��Y�4��j�{�j�a7�F�����e��� �`rn[rr[�r�M4��X��L���Qh��I!zj�|�����s��j3g�=� ���:���1���HB��~�8m��<���)zQ���:a��?m7���t�J���B�u|g��0.�Q��wX�{�Yo���8E���g�M��6�p�����}���h�K{��(�7���bg����1p ��rg�����
4�����ON@�PU]]]]����F��>��p��O���x28�(I�f�;����/VI�t����1�7�� 7�=�M���4�sF(��:m����0��J������f�,:@�������nk�~���R�� ��u�
����hr�^L�gY�'A5�>j/<0U_����J���M�3�:���M���1F�W����>�������puF[�%�\~���2��V������������#���m�H�0I����B^�v���A+G�������f��j�����F��5����<��P�������p���A������f��";�6"����+��p�^Q.
�)�
�H���`w�7���G��������Y�O75��$���J����[��{o�����\{�u�<��DP_@��]d,��`�W��#*�D:�:����U*��iZ��,�y��U���f4��
M
�����c�O��&������a hU���U+�K.�4C0&
v�B���@���
���4�������~T�U�I����bIp��B��.:�g�t��>��69�g�%D1��d��fh��4|;@<Y� )0v�������E+l mO�9�����T:�f��V�F��`Em��
U���:�P�+�eYC���iHK
��\�p��~�"@%����I�����9�|�QB������:���?�Uj����X��7���!�U�M�>����s�FY��Mi���QNu1���ya�Tn.���L0�pJf&�
�|��Pk�h�fX��{�R�:[���F6�&���#�0`�
Q�*�������7XbvF�d�����-g7:��9=
�^(nD�z������<�H�v�V&�����
�yw�i6�w����;E�wz��� D�RC���X�)H+\8�� �7][����Qg8�����U4��X��-���XKZ)�(rG�P�����G"�+%#���E%/�+{*�]��L�0J���
]�P����]�4i�(u�,GH�d��3|�������C3�����pO_i������3���������/��i���M�{u����r3��7p�8=�'�M7�H������e��J�^5��������';�8p�
i5�����^��LG���7�-}�-n�� ����bY�<r�<��%G�M$q~7^���tx�� *� {�+����������k�Km���d�6|�"�
�n�������LC�e$Y8a����)<