From ad31626088f42e280d3b8647edaa55092884cd82 Mon Sep 17 00:00:00 2001
From: driesva <Dries.VanAutreve@vlaanderen.be>
Date: Tue, 17 Feb 2026 20:56:54 +0100
Subject: [PATCH] perf: improve OdfTableRow cell count performance

* Issue was mentioned in #25
* Do not iterate over all cells which is slow for Excel generated spreadsheets which have 16384 columns by default.
* Rely on `number-columns-repeated` attribute to count the _real_ cells.
* ATTN: this gives a different result for merged cells over multiple rows compared to the previous implementation. However, this count seems more in line with the actual content XML.
---
 .../odfdom/doc/table/OdfTableRow.java         |  20 ++--
 .../odfdom/doc/table/TableCellCountTest.java  |  92 ++++++++++++++++++
 .../TestExcelSpreadsheetTableCellCount.ods    | Bin 0 -> 3083 bytes
 ...stLibreOfficeSpreadsheetTableCellCount.ods | Bin 0 -> 8463 bytes
 4 files changed, 103 insertions(+), 9 deletions(-)
 create mode 100644 odfdom/src/test/java/org/odftoolkit/odfdom/doc/table/TableCellCountTest.java
 create mode 100644 odfdom/src/test/resources/test-input/TestExcelSpreadsheetTableCellCount.ods
 create mode 100644 odfdom/src/test/resources/test-input/TestLibreOfficeSpreadsheetTableCellCount.ods

diff --git a/odfdom/src/main/java/org/odftoolkit/odfdom/doc/table/OdfTableRow.java b/odfdom/src/main/java/org/odftoolkit/odfdom/doc/table/OdfTableRow.java
index c2635583e..c186bf0a1 100644
--- a/odfdom/src/main/java/org/odftoolkit/odfdom/doc/table/OdfTableRow.java
+++ b/odfdom/src/main/java/org/odftoolkit/odfdom/doc/table/OdfTableRow.java
@@ -287,16 +287,18 @@ public OdfTableCell getCellByIndex(int index) {
    * @return the cell count
    */
   public int getCellCount() {
-    OdfTable table = getTable();
-    Set<OdfTableCell> realCells = new HashSet<>();
-    List<CellCoverInfo> coverList =
-        table.getCellCoverInfos(0, 0, table.getColumnCount() - 1, table.getRowCount() - 1);
-    int rowIndex = getRowIndex();
-    for (int i = 0; i < table.getColumnCount(); i++) {
-      OdfTableCell cell = table.getOwnerCellByPosition(coverList, i, rowIndex);
-      realCells.add(cell);
+    // count cells by skipping covered-table-cell and taking into account number-columns-repeated attribute
+    int cellCount = 0;
+    for (Node node : new DomNodeList(maRowElement.getChildNodes())) {
+      if (node instanceof TableTableCellElement tableCell) {
+        if (tableCell.getTableNumberColumnsRepeatedAttribute() == null) {
+          cellCount++;
+        } else {
+          cellCount += tableCell.getTableNumberColumnsRepeatedAttribute();
+        }
+      }
     }
-    return realCells.size();
+    return cellCount;
   }
 
   /**
diff --git a/odfdom/src/test/java/org/odftoolkit/odfdom/doc/table/TableCellCountTest.java b/odfdom/src/test/java/org/odftoolkit/odfdom/doc/table/TableCellCountTest.java
new file mode 100644
index 000000000..4ab6b9ad5
--- /dev/null
+++ b/odfdom/src/test/java/org/odftoolkit/odfdom/doc/table/TableCellCountTest.java
@@ -0,0 +1,92 @@
+package org.odftoolkit.odfdom.doc.table;
+
+import static org.junit.Assert.assertEquals;
+import static org.odftoolkit.odfdom.utils.ResourceUtilities.getAbsoluteInputPath;
+
+import junit.framework.AssertionFailedError;
+import org.junit.Test;
+import org.odftoolkit.odfdom.doc.OdfSpreadsheetDocument;
+
+public class TableCellCountTest {
+
+  // The number of columns that Excel always uses.
+  // For example Excel puts <table:table-cell table:number-columns-repeated="16384"/> if no cell values or covered cells
+  private static final int EXCEL_COLUMN_COUNT = 16384;
+
+  @Test
+  public void verifyCellCountForLibreOfficeGeneratedSpreadsheet() {
+    // Spreadsheet created by LibreOffice on Mac version 25.8.4.2 (AARCH64)
+    try (OdfSpreadsheetDocument spreadsheet = loadSpreadsheetDocument("TestLibreOfficeSpreadsheetTableCellCount.ods")) {
+      OdfTable sheet = spreadsheet.getSpreadsheetTables().get(0);
+      assertEquals(3, sheet.getColumnCount());
+
+      // 3 cells merged so 2 covered cells
+      assertEquals(3 - 2 /* covered cells */, sheet.getRowByIndex(0).getCellCount());
+
+      // 2 cells merged so 1 covered cell
+      assertEquals(3 - 1 /* covered cell */, sheet.getRowByIndex(1).getCellCount());
+
+      // no merged cells
+      assertEquals(3, sheet.getRowByIndex(2).getCellCount());
+
+      // 2 cells merged over 2 rows (simplified XML):
+      //        <table:table-row>
+      //          <table:table-cell table:number-columns-spanned="2" table:number-rows-spanned="2">
+      //            <text:p>1</text:p>
+      //          </table:table-cell>
+      //          <table:covered-table-cell/>
+      //          <table:table-cell>
+      //            <text:p>2</text:p>
+      //          </table:table-cell>
+      //        </table:table-row>
+      //        <table:table-row>
+      //          <table:covered-table-cell table:number-columns-repeated="2"/>
+      //          <table:table-cell>
+      //            <text:p>2</text:p>
+      //          </table:table-cell>
+      //        </table:table-row>
+      // so 1 covered cell in first row
+      assertEquals(3 - 1 /* covered cell */, sheet.getRowByIndex(3).getCellCount());
+      // ... and 2 covered cells in second row
+      assertEquals(3 - 2 /* covered cells */, sheet.getRowByIndex(4).getCellCount());
+    }
+  }
+
+  @Test
+  public void verifyCellCountForExcelGeneratedSpreadsheet() {
+    // Spreadsheet created by Microsoft® Excel for Mac Version 16.106 (26020821)
+    try (OdfSpreadsheetDocument spreadsheet = loadSpreadsheetDocument("TestExcelSpreadsheetTableCellCount.ods")) {
+      OdfTable sheet = spreadsheet.getSpreadsheetTables().get(0);
+      assertEquals(EXCEL_COLUMN_COUNT, sheet.getColumnCount());
+
+      // 3 cells merged so 2 covered cells
+      assertEquals(EXCEL_COLUMN_COUNT - 2 /* covered cells */, sheet.getRowByIndex(0).getCellCount());
+
+      // 2 cells merged so 1 covered cell
+      assertEquals(EXCEL_COLUMN_COUNT - 1 /* covered cell */, sheet.getRowByIndex(1).getCellCount());
+
+      // no merged cells
+      assertEquals(EXCEL_COLUMN_COUNT, sheet.getRowByIndex(2).getCellCount());
+
+      // 2 cells merged over 2 rows so 1 covered cell in first row
+      assertEquals(EXCEL_COLUMN_COUNT - 1 /* covered cell */, sheet.getRowByIndex(3).getCellCount());
+      // ... and 2 covered cells in second row
+      assertEquals(EXCEL_COLUMN_COUNT - 2 /* covered cells */, sheet.getRowByIndex(4).getCellCount());
+
+      // Excel always adds
+      //         <table:table-row table:number-rows-repeated="1048573" table:style-name="ro1">
+      //          <table:table-cell table:number-columns-repeated="16384"/>
+      //        </table:table-row>
+      assertEquals(EXCEL_COLUMN_COUNT, sheet.getRowByIndex(5).getCellCount());
+    }
+  }
+
+  private OdfSpreadsheetDocument loadSpreadsheetDocument(String filename) {
+    try {
+      return OdfSpreadsheetDocument.loadDocument(
+        getAbsoluteInputPath(filename));
+    } catch (Exception ex) {
+      throw new AssertionFailedError(ex.getMessage());
+    }
+  }
+}
diff --git a/odfdom/src/test/resources/test-input/TestExcelSpreadsheetTableCellCount.ods b/odfdom/src/test/resources/test-input/TestExcelSpreadsheetTableCellCount.ods
new file mode 100644
index 0000000000000000000000000000000000000000..8c4737fff2fb707959bf07b7131c54afbb324e8c
GIT binary patch
literal 3083
zcmZ`+2{=@38y?0oM3g04vKtM?GRZC#*~ernq+tv*ma)u)>{(LC7AccS*)n!T_AP6n
ze9C0cmVHYMAMsE9OaI^Z{qMQn>zwnRb3gBOp6kA!=RW4fKn7O8KZhtF+Cwc?o_6zN
zf@sqd>xm}Z^hP^+dwXC}js&b14(f+<miKbRWAXA{-e{b&7wU#58b^@Fd;6jto$(kn
znqW?g$qiuo89@|K^_0Or1_%I<XxseQ2~W7`fyT=RczU#1zx5qZ;2u+ctrPI!Rwhcr
z^XZuz>OBgwS6i6D70b`lB*nW;-%#*dU&TH7*XEx+vLBnPnKP)V)48E}^O=#d%xOyx
z-&Av5=iZBUPp|7V<(~!jGsOwuWiZjC0)1*7b#2voK;isb+mxr-tvSP*crurPGy%I#
zirmb)C{ylI%Uzv~l*(N$xT84RQ$xsYXvudF6c%{YE*Plfo?X0FUnPk0EW?v7QCLq=
znCz~fyD2>0RoNolJD{I;(N9Z-t(las<|8ExAt>ZQUn~b`;u6vY3x<oT8yb2?Wmx0L
z-SZTVSdG#Q=TwV2%S;}kSX`si{I+HBN?8X}Q}ZPqy28P7dix1JxQaWziwQaOOv2n*
ze-rXDjtwVK_NpZ+?~J7V+G;Q*n}438$B(V#J!RY=bHCZBTO2f9AQySPa|a)-eIT5(
ztK|QcH+5yT;(hx=)xjfvHcW4V9vUA`qAM|zmyR|-AE&Grqr}jy?;ns~y2vRDaIY9a
zM??Bl^C5NM^?ND-pF0-EkB%dChyw&8@Z3gQ$tP*!;zr1f?Iz;B|1gBJL5U5=9L5x+
z5RW7|_1RY6SVuZD!=%7i=bFx$aw}iXGs{nmMIIxr%nL)1Ihj)2fXP0K3(nq6U1Qgm
z|Cn6aBSOEl`>>wixs5wmapvh<SQup|*QsZGrxS|x)M;^DK=&#hF2$f6{5=+?Itho<
zJ(UwZ5!^mn#jW4zMB*DK_k_fPrc>Fc>(ATzT4y`Iy!ad%y9D25H|WUh66SIVr|6Nw
zKq{W8!BPAdm>_gsMu|l#F|4!1VB&<m5*-L0GmR^$vPn;m%YIdu<DJ~k+>L~sRJN3B
zUFL5IiQbO%sR!MWJD1@+7tU~#vGU&IO=LpFnvbzX!joAf@3Z+jrzpQK$}uNY-#dPc
z0NsnK`g-p*vSKxtj@0Daj0LV)HST&S68CxBIqqwfjcXT)oHwuWg})59QM+8j%*D|4
z9Vn?UJrm9o{K+(;kd%YZs=f_z(k({1=S20)S+p213)I!rI#kt=_psz+j9p6o`;`yQ
zLl5&!n_Be}--gnUxY$3e-cGT<b>pPw-DA7SzAYGKIWT3by?W?w+9Wx1vp@3ecs!kP
zU3yZfOD(gR&GQ!fffE-o5C3psqoPP5rZ&z;cG^7XvW5s;=Ui3W@)Zvh;xqP-004)F
zK*0aXHJR%>T!sMvC_4rK&|Uzbyl{jc`lji1=1L20T7|RW#Jmol`nL|S(I2Ko!w%fw
zz)|B7j;w-YIa$3537+<_2~ioPRMeUq;$<BMZy?l{wE3l%D0;tlFP&6M(j}V3dLqU~
zc_Ex8Dw(PtaXO)gX_`C`Q~?H@PG8l|VzLoR{q8R~RCO}4HrZod_eyI{8I9+2EEaaP
zbMsmlgt42t#gSp4{0rODoIVzrY7}k1D<D_sn6_y5wp~EEvA@QIW>tCqY*z!mv96zB
zFEF$#*1NlHEkCyJq>7cS7>BrNNNDJMiT0nGu2QuvT&xi4+;FLHO8(Q_dTFcn+o02F
z%hxGS1YlGLcF3*BLb6ODksMD`E;TD%%;R~k*N);la3Pv}jsjWe_FLeu(6e2Q{V0)a
zGRM&_Z&a-}oAN+Ogk1sWM+{e&%RWFHcW4=zaz*D}4au^7drV_`*Bl-i(g`1#iqT=l
zhP}ybHA1Ya%tncw6q+_&B9v8hIw?&7r9=*1@q?JsmW*P^xuRuWs;%Lh7=&eA<2PJe
z<wVsEqpiBPpq72K%QnZWqpqqumo1&YKDjFp+32F1+F|(Ali4NqZu<osSUT08`LWgA
z5|B|OeFjs16-MUldIslLU5*SgDwF_mKMR<8#KsR?iAyWz?7x<E(E$=Qa{+3OntUh&
zZ3^HGExi>g5roO@V6Dk<(w41GyoO4|!E~&bI&W;r2WwS?s+oka=W%TaiI>a(fWfZ<
zqE@}z3TzuJ49`W<iKVRs78$LgwgBy{H4RCR-J|qIZ37>T7{C(;7-5KSfcy19R+;Gg
zce~QFaO&Br?fUGTz$An}FSFtTI#Tj;#;5OgI22WCC|5pn*dI!?$dJ)@yef!iD62CC
z-TMO#>^yi7!B-~#?5ZBuaqKz1wvBks2w&-JI`UAm0s~8JcFrlbMJt(5G3%5Ku-Z;z
zqFS{0HEc)1+4#kd`ZHKn5nj{JjJE{*ce4j%m)%L8(gLju!U11f#BM7b>@mQ49!}Wz
zU8zA*8Q`-%jF~I1H&$zBA|Ut(cIhZ%SKl)dFg2Lj9V(oozmVmAFPEYq7H8Slub%4w
zS_qtBJ9%_~fH&6$luOT&UrV<0-tmupA(C-thOHD~31X%m^w1&rQi`xaW_*zv%-ve%
zA4-N(2c-8uJJ?L#n^jJze$*z)!oK0>wJUVje{QB)a0X8l+9ZAC=QIINfi{|sz6-e2
z8@0K%9xSE!&PhHAZYV8EqKv;){BVHNT}h|x6TuT7?bGKq-)<Eq*TcLQ_X_zZ4yoiI
zPmojr{OINvlR-7BuprO@l(@NaEeW#|wO}`2G_-RR9<>>C7>9de?>@9Sxjnhi*%?P&
zP0Melx92z*;}Zg=9a#6QbyJ#vu3l|B^=zeGJ9hh*ShU0T!)*M*=>D#v#Ju6y_(ZED
z-1Gnd5AAHKXQ?Y^Xr>SKbi`p@(D<LVr6@_)4XDVbM~xnD3DEI-0g)mt2S#iIS_ffF
zb}HhgU8CA&jwyZ!gQpsXylWvh!&K9Y%vAB@nXSHhOf<Kf$+v~A&b^U!GS3n7D0`L$
zhvY5C;Lza{SuoMK5!R1}ZLbEG&{8(HxHKXnmL;l(lbqO%b&pf=6W7M3Pio}GU${=R
zspKDhIim?n%BEOPbTXnMbO#4Fb=}n%lR^`;5U}fXJ^rPWD&iNl#bT=x1+Naqdju|C
z{}AC?PMOm=cR_OD(t&biR&%65(B5b<AC&f?e=V-As&B5rX-P_<rQ)Z*LK7T+RMz;*
zb+|~H6M}4=l3hcZWHZQ$kpKKdmdD=4J*Y7(7SO0LH8^ZUiWpfGEMg`$YcIXJ@<bpy
z0htM_ZG)L9(94;~Z8f%e5$C|KyKa`am&D&b9(L>X(&BcWLR}_zvzz!Z)5}DGb)hY%
z;c_3#sX;fF>iY@U@o<!b0v@1c@kug+acRRf=}%}-vxBcYVv1vpBR=VZyOqZ>=|e<#
zglMifERO-M1~*!Kr(C~OTU~dAA!AOB#UegW3wql2v)g#6cWG>rBZq)2wZj^E`O0)p
zU(@Ya(6tU0^)T&B2JqMBGz<?lWND;)|Be(kg=fadgFD?eu-i&PmLX1#GT*qxn-DHs
z%y4$2#79r=)2YXC3-erMA$iZg2$Nxk>4+44LgiD4e!6V;xODcD=9Vuf#9d*ixO&%~
zfd~_HLS=91u5c@h)x>|2PDd~I(`?cf0DrZ$KURN@f16x$;~%L1Z(M&NENPd&Z0zs2
z-#h3p9FW#m|Er(=4*XpxzkpUWviz-Veh=|G!G486ve4}OzvyOe%*gcP2_x+gq0#Z<
I&p&{F02_KrX8-^I

literal 0
HcmV?d00001

diff --git a/odfdom/src/test/resources/test-input/TestLibreOfficeSpreadsheetTableCellCount.ods b/odfdom/src/test/resources/test-input/TestLibreOfficeSpreadsheetTableCellCount.ods
new file mode 100644
index 0000000000000000000000000000000000000000..b194c237557d8fa646bda0b8bbcbb2bd375fb961
GIT binary patch
literal 8463
zcmeHMWmH_tvK}Bf1P?ADf#4pT5Zo;c?(R--3+@msxCRgI?ry=|-DPl_2j|?JlWXtS
z`}t~Cuidk|s&{o&OLcv+5>PKN0RT7vKq662-OrpOm<|8{JeQ|e01Fcf1AAv{108E?
za}zxsdlM^5dIw8=Ix8JJ6FWL9YXeJtE4|Ma2A1}8cGk8AI{J3T1_t)BfAk3l2lq#x
zPu=`QNKZ8j9ZM5K13P;<TYbZ!=pjoV22|f;Za;(JnUD0)(6$u)b*5>p@BNjb>CY0;
zmzu+)73IDc?4?bt7Yj2lhgT*Y>JapXl;^bpS@bB$`bCYacBwfV=<2fPIp=1osfiN_
zPfdNY)2QklEvY!P;{0gYkjzIaGAW!ALEJKpq-~SzHlj$~mEmykL}C0U7aMMP9K&ny
zhDvhw`{|L+S0p?ki=6rC<p?^}pPB-yNxpvh7zQud?`!WvP%kaf#T*Bc<7mq`T<g(p
z8u!WM);^&QADLMSM9SIJTxlvjQukSQi#2vR(sTJd-gUbCCPq7%=}2a;fy)`Z{YW<g
z#$79^bPzQEIGkm48@XM1Myw!GA}aw4S9xVT1`PoK_&@;wf12-?Oa8LmQw8;@2v}Jf
znizey{lgh{O!WWEJstW(z!(|;crG|k+(6^c7P^)?CgyhZ_P?rh)|N&=veF{R2zUrj
zEXZP_f}a2Y2v-0A5&-w~eE{%~JLl<PC@TpRdU_%vB4S`*5D*ZMl9JNW(z39y@bK^m
z2?<F`N&<mERaI3zJv}osGh16*H#aw5U*C|Bkm%^>q@<+G%*=v<g7Wh6#>U2uj*fwW
zfw8f%g@uKUjg9^NeGmxr`1ttLKNt)iXc{Vbs=-@}s@Oe!5aYQ(01}g*hVUX!Opp)g
zG<Uc-WSjXB(`$4~L{`_EQTPSs5|~zmd7!O}W{xNYq(C*0R3QJ##JH7#S^)yW^-?#j
zn)OaU?Yo3RnGA4wnBz{r%xEN)$My1Hwnab9nW(%`KP|nC>+|An=VPqiNNUqe1-9!Y
zSaCbAL*~t$D{>*KjM1DgHxT<W#NEgW?Qj|7L3HML8A5m~FL?K`dTUmp<Cz<O$&2;j
zD*vFSZrvU4E}zn6Kl$zDH&cVKgl><5y}r6hjg)-E2Ta7BEOwc3mNKm$2sPDZaqPU~
zh?fJ~_v=m%b%H4#hT#4u)ie)gLwN35%tM{u@7Z#95-bze8&xkGpjnY0mS-YJRmw;u
zD5!9JC~~hbC7s(=y3%78PHa|@0^I~%A+_YNran}*xKng|7`r~6r|p$#GMW)?{?dfV
z7;)Y4CbiUE@vdy98-J;|+`-T@SN`#p-EDJU^DMn1TthG2G4vf*&#i!9)P==09e2?K
zgL#NfVC69@){r&r)KPc+&UUlY+~?sNqj_3EPQ%NV+#c00X>8N0W_OAviQNNl9+B?s
z{~7?;*cn`P$5|mW8jmfNfP8>4@gv8XYI)|}j{Q6;C|ReR?k3!w^tS$NK`awoZSW9?
zm~a68F;b1<JQMcNjtA<fQz&?EXwx`VCL^nWX&|R~pvCdzvJf8EG9&s+-jok-G!O6`
z=cl+DjxNwho7oCR3L-eKmjX8DZc#@)>>83wO=sv?1>LpgZdhF^3_XvXh;JU^^{S21
zx;<!!OBIGaY+N2$D`a#%ks1=*(eGB#dTw*8z)LLw4#Z|kRvHH-?qyo$Y9;&i;TPRL
zIn4&{;IUtW`$L6;u76Aw-CuJ?_fOyb*7~IBZ)|^f_RrQ|<M`*+=ZW|4ojkq#XSRRX
z;OXU`#`q7d|E9?wJ^!WfZ<_ouivQR1PYe7X*t2Sa-nplIL?o<$=V>DYhzUsx7V~R+
z|L;ekoq@f*iKUSpos)(6p{knQ96P4Rvewtt&+j&))H>eU4;E!0N6vjLcgMJd0P6R>
z>0>;fJ}&#hlI;+O7c;vkrWt6k%Y~iR;C`XAT9G9Z8I0heLD52u74Fs0p5^AEf%9^%
z=NOUL)KfjE&$nLo!WaLx^`Z>2$R>odeO+BaqwO6gif@z>v>Z@@<CIUKN(~F*WT<Qp
zv^eQIV`|Vwk*0-hs0ur&%NU&LINHbcI=Aa=bJKvau3?tS*J%z%uY_HKRY^R1d~NU6
z#L>2jTF;CUqk9U>D?enCQ9arrd_Om-8aFw@IJweO&!I}+(^-tzYkTpP|NMIu|6E<#
zNN8TB9!%T|CR9EhJ9&DjMzK1&32~(^Ej|y#>sRD+NM}43=QPN-_iJnVR_FNX<0@3!
zvHi1m8mkfR=mhddZIF!?pHQ=Tvo?_CLe!7i83YNfLL{=u@IGd|N)ouKVGrZ0xh6mb
z_VO~`g3yd$(g(O^wBE#s_i|<A34=V@(-ZDP@0IXur7_CXrHI?$aVA+;<!7cIBztFs
z&%RjUd?+0^*FL0)Uc$I4ZPW8n#a2ZGd$nr$oxlc0J@#G#2+>|yW|4=+NjQK0n1gzE
z8M3p@(Uy`B_(8m$khPnifuvD(oXIzNxJ?5{?gXX0^TDtR9%GbNGN@rN^Zjed&9~K%
z4h$2Fwb=x7-ut4xbr7GB+c;`fdov&dqFcKWq4YWB!{-Y1E)&!+kjwFzq*Q3|pyO_8
zFG&K|klqG~Nve6Ie=EaN2w0BFh6BOHmtS)y87xYV4HsvyiHYLkTE#k_?XC%n-V#a$
zGW5iHmoa`#z!I)=OJsI$>`EtQq#%#Pxl8e_Rb<p&VN56?5o&MYbZZScb>&a;t>zEw
z)`4lE{Z7o3SuZ%uEHoqkV8|pDI){3I-StDV+1A5b;r0eXa=g{2=`{ieio0dV4oqOc
zP#PMk7(=JA37{$KHX|G(y5hXYn-Z3(qU(bodP!4TW^9+AS@L%$f_o|b_V8fP?Z+8G
zowfHLwV^|qic}@_FwJF+)e|0ob+%ubb*(ybSrzWuxmIVgB7g?vo+KysTcE^Yge6tk
zO`0;uIPdY}S;fTVH&d(i()xS$x*CETnCnFjo`s7wuN?Cir#p(ykrB?1#s?<(DZ~gg
zJd8q37+EH{4glxx7%fqcAen#8!9b{G4jV)p>jFMZWb(y_92GG~3wT_2hl;Lcs<8SJ
zi^|#{aXaCUo%O7!1fz!&Vj|lgOuz(3_)5~i`uI8X)9W6uHp5@j&fQW|6pmnwzb6lA
z)4d1F(%j8RYKL$^1npKiPjjq@R%9ja*GRl{sm<uWW)@AYz0l~@AS6GXh09Pfq0%f=
zW?quhZcjsjLIDXWIpKcg-j3N*L>&>f!oXoivQFJFjpS+U#o5q#g?*nl@8PLP^*)>+
z5_3Yc@<<d=PU{z;h-KMQ#GWphe<Ij+W0GP^`pr+3t^TG$d2guu(O||TmiIELBX53B
zIv{p5Y9XRo4P4$rpIwpqV4-@%x<4e{(4(Hl=%`X09U!B10{(edc0uH*c0oK%JCMk6
zdOV)$0((m5+M(!rEn6<qF_r1Q+<bs6?$CfWskS7b;qD%P(T$aK(E^=SR?=}Agw0xX
z`)xJ(LZs*`NS3n@#lItCvVTeks>~YP#B<AnJ2=lXpL$Hvb8(?&2A-PZg>~$GgJhV&
zyES8si_=DWZ+vkmlExM<OK!g1!n5rjMp@ei(cH&Te(H!XQQX%q##D|ReGa)!x_v^L
zueRpK4KUw$IRP?s?<n6Z#p@e$Y1ZEHc}3HynP;l$!c(_gI6k;4ar!NyFIXjQcJdMC
zIoc+X`ZD(%A?LmO6>a~g%gP@YAOm}y=iNC>Udk$&0kiQ+i6mF4l(AGhge;g!frmwW
z(mZ>KRF9W})~qBHez%1_Eh*yYH5+%Tj^UEe{q63ION4eq_YMyNlsEU!u{_~v*Yow0
z*^!^0PhYbsOp31b_ddeS-H2GX<7d~eS1A-MW@!zluy=Pbyb!>|QPUF_^)>t9i}9!j
z)q$mo73~z^QdozkF>XT}{?q1N9mkg?nrr57BV}<FQAUOGR`au>Vo0=-nJ)wQ0@;q_
z=XZF&Mfrs?axYr~^#&8zvz2cx-|IFej~v{bFCpw7Y@zRiLca9m&E#->rah}Gt0Y<I
zJ?Yuy<AYzk@x9e?fn!c(kZ$+NF%gvK7Y(PUuqC@uqa@=-awdRAlVFM)91E+i^)_9o
zb<(<U@K8EEjMT4*Su7y}FSf+>wUql62QHN=Ijv5m>tN!mxmk!KI@;MuMw1|}d3iKq
zogF=HcMJ_($!Iy0U3r77%eUA>11R5!!|}D-F6btY1@{64ao@-u2}VVVXO}JHn@XLU
z*S=u)Y)`@GvM>I+6v`!6y&^Gg##RhXo9<h^$WX1DldNk_!B^XRS_r)+!7Fi!^6cpt
zTfzRyr+by@U-zp2<mu;Yke$7=xxpVN@uHfU)qFkfW3$%lyqQvnXtG%wUDqI=R0|{g
zpY{UuGd)nknfjSA6p{AH=hG2Ni)7T6QRH^P)myHcuFj&t{hJr={wZ9dxTH6+_`{IX
zUz`PXV{(;_rs-Q;sIOe^8YH6LQg|oD3*I4ZE$H1t2yDTvCR-pNB;dSI-<=tE695R9
zNBba^BS)})_o~BMv^QYw|3MUiqjo~=*yCJw`p~h;z(r%|oAdZhrun-w!IIswZ7xf=
z4e=E>+$)d09xtflmu($f)HW^aDkXxonkDW+RX-T}V1NP5D<>-{@qmg2n#{Zv`P`Da
zeGD16p&W6ErFwIiYfEiuYOpZsq!t@7jc4<S<?9qvDHyrUhE+Omc2+#!z<iV<m?i8;
z(tL;&<ky`8@d36kDJfas?{*`Rz{)>-ZTzevDJX`clNk3tG18rA|8~z#f=hi|R;jOz
z)?fZXZZHgQ34*f@9n(%DaWOl(aEI=KGzv>MjuzWk?!8<rv095nTD!NbrXr_CXLKRo
zi32}b6t}MBA$3ka9=l`>%uC4NJs2@2h4{DpmYSTZ3Vo+B)q8xg;Ef-Zu4Li;E10gq
z3d(D}0XX86TLBfNf|YP9JHEDYx=H^2!o6@o!e@3{5(((98T(t1-+cc*#mtd-%Wy&_
zGZfL0M+_VMLJ}Cs{(j>M$rT=V$M1BF8+371(6~{vOO~T8sKN{`q0KQmnkr6)M=Lah
zB;Dy^Xg7DwFZ@p6aPDZb-|sGi);c^*5afr$$(E)eVqd>Ggz8ai3kD#xKaLqrWEGFg
z(m^+3Ze^+pVwJ*n>r81=qDFMy+Q9m<&gMSWIub`Ja|6jZ)A)vAQp`@JP7l3sxV92`
zG3A(xYseiC7$sYYl8{3t%@=@q8$zgh)8*J+-Z9>~+gQ3)-Z5{=21ehu(N;#bhoG&K
ze0z^R7)MdkP9~Q{oqJCZsLs!lka6ry00XV0hqJLu^j#Nj%ajCtXe8hIX5Xl$XbM9J
z;cO{0A151PAaBSxvr6A&*)dL6Qng)+*8zFJq2t6OcsHtQ+DU9NqxvT5yd;9^hDRkO
z$~0CUGuD}P8GjaCVUV3{`8#iX;NfUP*X#{?a$R^QLzz)q?RWLTX|b5R1p;5H2uv4H
z5{8Ti8>u<0uI-7S4pVQFs|tfoErQU{`6%(8{b5e0K-s->Lg0R^TA;GRB&%XUIci%f
zh9W>Em%?AL0#g0JYf|$76nLz_LscRKMT&dK#7hydMC<pF29}hG0zF||ExTDWuTjxN
z#2JZ9vwz(C(_44B+~615Fawgx3P1WSmj}CD%}3JTUBWZP_t%PH<hmMbkdJYHV|;X<
zbnNgV15hS-DaYuO5DWcqh!`OrUB|I4BXC(J8B*9dcdI{&CwhQ%Xiq`&q+S1sr@b2s
z5<q1F+rTjv$0B<y+(mu<369cpg26(+7+N)n%nSdBcLUCuU4T$N3n1e~e;Lr3T&~s6
zTsK|G=Ix001#=}R5It1aM;tdjbIq6YbFi}vCC33t;H(vBrKU7M#9otTB(066R#_uv
zWlB3Jof|y6R060nse>pBx)%JBA<6*yv>H_7L$PQxk4T$&+Nq2trQoIfq5tGXD+Mg}
zK64BkMUAhW^Uq^4-S`s-^hrx#C0=I8tpHN~8NMp4%XhqeuMFO{rL`M2gQod-c?U`<
zb}pNcJA0C8t_YK)RMy%Q&TsGhxjC{B8juWkbNRM1BBy;mewo*`9jrmx+-sAj+R%+5
z9ri^wNEg}8YAdVeA#UsOL@-8wU?=4!B%{u7DMUUx4VB=c3h#u}X?$T5!sFvUZytM-
zFpIpy_z?5@9Sc+~-Upn{1~PUc8pWb~X&{INSXeGRtx7A<a#U^&Q~B*&=YcGw{AYgC
z8<qDG;VPzR)C^81cm&c;pSCO}?<)rb3LOOZd&eby%sEX?cVqB#5Tk6~hxyxnc-60|
zYlp$k5u@cxT!LbpbF)+vk-X86crMpt#dj`c-gfD{u+S=`(Dx-~1K?USvksJ|3n0Y9
z-iTtwd1(^<Q~Btf&#a#pxrha6ieur&$7FT+%`z?boPbLuey7LARrj%_GEn8JX%TNA
zlsX|@eMlck(*acnBVi_yuj6go*?h1z$%oRx23<_T^espW_92MeZ(Yes8xV$GSq3Jy
zqP%vkR|iGjle}<2GG~jDcbK)oq{vDmO4Qrid?#?N{;twyNd?#lK0=4v2pujDwG8)=
znvLlCfK=uea&H@)UEm%OCqOMm$Q_08JIj=0=bLw$95?2Cq7z2#Hb=cd2R$!=$8T=n
zjxLH|eOB*w%kVf{P5m(<QpquLV@y#SMe|cp^S(r9!%vvN4iLiuEsXB^A**nZC)To|
zunI@|z9h2V$wY?nF1g0eWaS->4>Mby7KRK^Mmz#T{ZaILQjaK4FP#rh;Zz%TM%i#L
zA7Y!ivJ|_%aU+NvkA=C(fUrreM3P$*V24S6uAj!bVgxfD_}N;sp)^a#3`(89H2kT4
zYT5;!Dgm+J*sH7f97EM-mv;S_!Ba1bS2sS6RAWCt3DLoA3Rj25*W229m$=_c$OemP
zYk!ZVq>V-sj_AOnkzCUDqD@E*mFAUoa92h3ig=(@S*<yu@cw5OA|S2P5>|4+YXXb~
zg$U;QAm6M^__lZg?E~aJWjcY<dWE7H+LJBqi{cp5={+n;cwyWXiZhzk9m1b(J1;5x
z(fYl-^pHq<i`C^Ys^&9n_Ogz{H}Dx!TT#omk*_R+Y3yC&>)CRK*i0ENt}UuCMcGZ0
zSoGjupDBcHalYQxKF;!)b!$?Om(Ya>%1=+&U*Ae^Vz&&RD$bauwgc^>xEd_n;HJ(M
zo>wPHeY=;YBj2!o^o;Acjo!1a{y_wsW<A?-ha|&N_f;&|PR8p^W8#1Ra#V-%U_!#E
z+A1qu(_}DQsfHJ>*gq0Nv4CRPh}q}U_)LmZ6R``4OhZc(@VE$jORL&P*3PP=q=f$A
zG98yvmCx8fi@e-ffA=8W;sn*8NBJ|3gb4Ueu0?Y%uIb>i|5VkSa*tYJ!PhkSCA?u9
zs|RU^aI%Bwo3P-oZbMu*W6Knho7C}RS3NnhDA)76dtjSRn-m34u>3m*<dCq}lbN*i
zx~+%mlk~tz6k}bzl^Dq-!dBNCRRIRxEAKjN&DwdAlgTs^22IiK!!*KuYX|iz{Q{s>
z`y{#guy@F&b7^ECiKO{Nn(df-*JAQ=Ql3+idJA2;rpQ9^^k)d3OAuG*u?S}ixCXWc
z4D}q?O+U(f&4330+}Z!P5FYU<u+y`$w0{ODo}&0oWhtw5R@9~|B{-^|_#HFSaw1ht
z6td?r>WLcKC6(;uLD_;|zSG<-JBqqf$7LDHu?W#G1-dbV46hAE54OfRV%y*=(WvJA
zLmKWFyl52F^#d%fH$lYugdTGbrE+4Vx`DO9A(%`Oy0I$vY#;Xr1?ymZv<6+?`3;kH
zg)+!>e`5F=_9j+fYDT!kf|R&MH6l!9*21ZhHG+b6;H+4Ek<vXq4gB3QLYZA{E*&M&
z&KbF>u|;bXYIBgu7G3snMmafxwaK*1$<6J%M~xpI<Ejf^%Lm@3P7zUDw1hI6kc^5o
zE48W>!QBbTm2Z`EmaXd9(Wz*BE56VcqvTVhHFgnM{8uRLeyL`MrS9`Fv+IIk)91Ks
z4<jIXpOIjD6c<Yt$GmRMw@5n(k&TyL<W<_#Y}Uhkh}&QKL@9+n`Scj_6>{&XpfCXj
zw$5y3nu~xGqjSo{b2(zbuczY2)5Z$Eu0*$VwDS`213f;lJfHPls?oWfXnaA9{hU}-
zsi7fUp8_}t4F}HbTUDaBl&j^WIgfJ$MG8#<)AIe*P3Eh^HBV>H_zw!_vP>;~UB44e
z2<dI!8~^CknMcWss_UlWYcP<gj9#3_!-XHb8b6T7Wh0K5U)%7DYo_7OA!$>=t*=$9
ze8XkP<RRk8USYhVBg>S%hQAH^m?FhxpWWLmr3GPG;~B*k;b9{~nA4Nh*q1c{sg`9{
zR7b{(FNXep6tSl3=40WpwC0gnbEjLwo$<wT({{T+t=SUHB(kn?L*xqnm$x)9?XTku
zYx4ES>0l>o5Sx)b$G!VjB*;$=A=*F^INJMcGr-;f*88B%{(DXs#X=nh>m#II2&Nd6
z{&w|HKYKu*U)ZTXC*%1R-nS*gtG6dEXJbg3%7)~9Vb*rFvF-6Sd87HkQ~N(k5lYn2
zFphI+tH6YB(F=v}e;6LU!$y#JW%7zO?m;MOodVVZI-W#sR1@k>_|i+Bkg)z|SPz~i
z!jUETuHoWVPCwN%Vwi=Er%S5PRuD<)_D2D2jnfMoc2#V*(*Zo6WpZ^K5~><fgQ)YO
zB0B94Rs+Q#%UAMlKfK5}xB&Sy9s#~sW8qPIWWdE0^?3DiiJ{!fEf}~Z?6*QURs#7!
zi!C|g@BHMf4zOD6Q$nn4x`)tOk60Cq+2{~=V<nN4vCDKOZzKh~gY;b^uf3(>Swzd*
zYuioP(_y8ogV*JkkweY$K8X@B4@oIqn2v*|S_@3+!&fpHFX6u)y?}A3vMu@O4mF|q
zkX7N2w~+)@;Wgr`;IlHx@fGL$TX*^)h?ldR$Qtmw_B^@)k8?Wx`VgI(wu0oJ81Y{^
zSoiw#*{y1{X-ai%&<wyNOaR`_%wJR{FT2&u{JbqeCS<mFpJ9Ch^{$CviDF}n+76h3
zqFKJltHyLoXhLh1J$a_Ov~e*iy>1l?(khs3@F_8b)_TZ&dC)LtbmM82<~aNlCC<(>
z`}MZ%=EFeql_eoJ!_Er)m|Gaw$mR<Bd6TNr_P8*A0RSXEA*}yB6O8q=Nl6I-`Dn$Y
zh3Wr7N1wK<qUbiu4iY5)WB1^|eaxL4Lh^~q05MnZBM4>PPj4CE1SXpwL?<c}a>T<X
z@U=k?En%|<(!+`(f%@F62eBn8&@;Eg+RLTK4@wVh4)c@Ulq`4@eI|0TuA<Wx9kznI
zSh!Jn1d)<O=MbeJ3kNT;$DwaoW1rcWPloA?_g7hL^yuG3UgC1aieC!BNke4f^7o6E
zRGIJ%!)1**C@hNq?B>@PTfZ^<Xk@mZK9-@gR$QWnk<MHoy$wK?f2}+o?%#>V_2JTM
zL}DA0G%x%mASj4TF^8Fm>%q&d&xJCUe*F48PbzIaFrDpGJ0a#PHf<`h)wZv}+MR#{
zZ(b<b*BmmGnPo<u<UKy5Qz5Dsl(Eh^Z6}1bRMDibu7>$O$pn1jRC8*cJ`*>=>F%k;
zKRxcT@`QM{``cBrj`vTuewruS%Su2%Vgmj<#QkLa-{=?M{Y&asw%~Vs_8G+fn}AQ%
zznu02Y5$V^Z}{!slF?5Z{yUoc&)WVgp8L0S+mrNvLwA4a@JsvO^IiX}y%y|K=HoXM
z;$J0y&!0T!!~P}+<fn1}BRlr5QokS0&$*SqY5(Q#nU;T*`+dDUAKiab=MxhA+d=-X
jg1<Zbc{%+}CWQZGamh+R!#uOWKmBkZ0f1Ga=YRhL^+3DA

literal 0
HcmV?d00001