From bccbbe45614da7c88a577678104923ba964694dd Mon Sep 17 00:00:00 2001 From: Claire Duvallet Date: Thu, 23 Jul 2026 12:32:56 -0400 Subject: [PATCH 1/2] Draw connector lines below their points instead of on top Co-Authored-By: Claude Sonnet 5 --- demo.ipynb | 73 ++++++++++++++++++++++++++++++++++- images/linezorder_after.png | Bin 0 -> 30735 bytes images/linezorder_before.png | Bin 0 -> 30849 bytes src/textalloc/__init__.py | 36 ++++++++--------- 4 files changed, 88 insertions(+), 21 deletions(-) create mode 100644 images/linezorder_after.png create mode 100644 images/linezorder_before.png diff --git a/demo.ipynb b/demo.ipynb index 7c0e4e2..5da0e7a 100644 --- a/demo.ipynb +++ b/demo.ipynb @@ -79,6 +79,77 @@ "plt.show()" ] }, + { + "attachments": {}, + "cell_type": "markdown", + "metadata": {}, + "source": [ + "### Connector line below point:\n", + "\n", + "By default, the connector line's `zorder` is set below the scatter point's own zorder, so the point marker is drawn on top of and visually caps the line where it meets the point (instead of the line color showing through the marker). Pass `linezorder` explicitly to override this." + ] + }, + { + "cell_type": "code", + "execution_count": 43, + "metadata": {}, + "outputs": [ + { + "data": { + "image/png": "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Ntvsn5lZ6/Gzzz7Df/7znxQDwEmTJmHq1KnYtWsXnnnmmYgPALmIvZODP2L72E4REckcBYASMrfffrv3//ny5TM/W7VqhTJlyni3L126FJ988gmOHz9uegQfffRR5M6d2xvArVixwgSNUVxxHcCnn36K+fPn480338Tjjz/u7WmMiYlBnTp1MHDgQLNt69ateP755zF+/HhzTPEsu+YGmzeHugUiIu6nOYDiWCNHjkT79u1RrFgxNGnSxAR7tWrVwokTJ8zt7dq1wxdffIEXX3zRXN+5cye6d++Ohg0bmoCydevW3p7GDh06oHHjxub6mTNnzPXXX389SbAZyZhgwTIrbsAyNU5NVBERcQv1AIoj7du3D88++yyWL19ueu6oa9euqF27NsaOHWuGbDmsyyHcFi1a4NZbbzU9evz58MMPm/tzu93TWKJECe+++diKFSuic+fO2LJlS4h+Q2dJTIRrMPhjezkfUEREMkYBoDjSt99+i8TERLz11lvmumVZ5nLkyBEzX9DGnsGnnnrKDOMWKlQICxYsSHO/c+fOxbx587B+/fqA/w5ucmEE3RWyZHFXe0VEnEgfo+JIx44dM/P27r333iTbOSTs25tHNWvWREJCgukdZBCYlrfffht58uRBz549zXXOLaTnnnvODBk//fTTiEQMqqKj3TEMnCOHp70iIpJxCgDFkUqWLIm///4b9erVM/9P0fnz+HPjRjzWuzf69eyJcdOnY/LEiXjwoYfMzVlSiBKYaXzo0KEkpWK+/vprNG/e3MwdjGSVKgHr1sHxKlcOdQtERNxPAaA4EgMyBn5PPvkkpk+fjhzs9gHw008/maHhG264AecPHkTXGjVQF8CIceNQCUC//v3R+OabUbZsWW9v4MGDB729hrfcckuS49hzADmUfOONNyKS1asH/PKLs0vBcN4f2ykiIpmjLGBxpOjoaFPOhfP9GMxxjl+VKlWSlIF56733sIHlYNjbB6A3A7yGDdGlSxecO3cOBQsWNIkgd999t7m89tprof61HK12bWcHf8T2sZ0iIpI56gEUR6hWrRpmzZqFIkWKeLdVr17drNLBXr/9+/fj2muvNdm79tBupfLl8S2Aq332M3HECHy3caNJFmEh6S+//BKrV6/G3r17k+zbVrx4cXPc8uXLI9LVZVeqC7ilnSIiTpbFYmqlZHilibx58yIuLs4kFkiQHTwIJA/qDhzgEiJ6KTKAnwQVKwLbtzuzzh7jfsbpLFitJBARyYx4fX9rCFhE/gmw+vd39rPB9in4ExHJPM0BFBGvLl08ZVaciGVqOncOdStERMKDAkAR8eJMBpZIzJbNWU8K29Ojh6d9IiKSeQoARSSJoUOBAgWArA75dGA7Chb0tEtERPzDIR/xIuIU+fMD48ebOtuOwHZMmOBpl4iI+IcCQBG5SNu2nvl2oR4K5vE5L7F169C2Q0Qk3CgAFJEUjR7tWR4uVEFgVJRn2bdRo0JzfBGRcKYAUERSlDcvsGQJUKZM8INAHq90aWDxYk87RETEvxQAikiqWGd7xYrg9gTyOOz543FTWLxFRET8QAGgiKSJQdiyZUDHjhc+NAL0qWHvt1MnYOlSBX8iIoGkAFBELonDsFOmAPPne0qy+Ls3kPsrVAhYsACYPFnDviIigaYAUFyPy9YmIMr8lMBq0wbYuhXo3RuIifEsy5bRpdnsx3I/3N+WLcr2FREJliyW5cRl391Bi0kHF/9SN2wA1qwB1q4FVi1PQOzGRJxGjPc+0dEWKlXKgnr1gNq1gbp1gWrVtH5sIMTHA9OmASNGANu2ebZlzw4kJKT+GN/bK1TwrO3LcjNa4UNEgik+Ph558+ZFXFwc8kToB5ACwEzQH1DwAo2pU4GRIzMWaJQv7wk0WE8uQt/nAQ/MN270CcxXAZs3A2fOeG5jLx/XF2Zih29gXrWqAnMRCY14BYAKAPUH5FxHjwJDhgDjxnmCCcpIf7U9RMkghOvcckkxrSoReHytEhM99fwyOkwsIhII8QoANQdQnInJABwiHDMGOH3aE0xkdLKC/Vjuh/urWBFYuNDfLZbkGPSxJ1bBn4iI8ygJRBwlLs4zVMulyA4fBs6d8+/+ub9DhzzJDF27eo4nIiISaRQAimPs3w80agTMnOm5fv58YI5j73fGDM/xDhwIzHFEREScSgGgOCb4a9gQiI31f69fangcHq9BAwWBIiISWRQASshxGLZZM2DXruAFfzYej8dt2lTDwSIiEjkUAErI9e0b3J6/1HoC+/ULzfFFRESCTQGghBSXFmMx4VAFfzYen7UGmX0sIiKhx+oNrOeq5SoCIypA+xVJV52/Hj2ArFkDl/BxOdgOtodLkqlOoIhIiFZ5WuUZlWHpLlt0NFCpUtJi8lrlKXMUAErIsMjzkSPOCP6I7WDpGbZr1KhQt0ZEJLxdzipPDAbXrQN++QUYO9azTas8ZY6WgssEVRLPzHMHFC2a9AzPKWJigH37tGyciEi4rvIUr5VANAdQQoNnffYb32kYlHJeooiI+JdWeXIOJYFI0PFMj13+Tsb2aeKxiIh/aJUn5wm7APD06dOwLvOb++zZswFrj1yMk30538OpARbbtXUrsHFjqFsiIuJ+WuXJmcImAFy+fDmqVq2KXLlyIXfu3HjyySdxLo3aIr/++it69eqFwoULI0+ePLjmmmswZsyYoLY5UjHTyw3c0k6RSLRv3z78+eefqV4OHjyYqf3z+4P7Se175NixY9izZ0+a+0jPfcKdVnlyrqzh8kFw++23m8uJEyewdOlSTJs2DUM5IzQV06dPx4033ojY2FicPHkS77zzDh5//HGzXQKLaf7M9HIyto/tFBFnuu+++8xnOC+1atVCyZIlUadOHe+2HqzplAl//PGH2edvv/2WZPu3336Le+65B1dddRUqV66c4mPTc59IoFWenC0ssoCHDx+Ot956C/v370dUlKeyzSuvvIIRI0aYbdmyZUvXflq1amV6Dz/55JN03V9ZRBlTq5Ynnd8N7VQQKOJ8y5YtQ+PGjc0JfcWKFZPcdubMGXOSnz9ZeuihQ4fMdCGOAvnelz2H3LZu3TrUr1/fdCiUKVMG0dHRKFSoELp27Yp27dqZ3sGXXnrJ9PIll577RIIuXYCZM0Nb6J9f/x07AlOmJN0eryzg8OgBXLVqlXmj2sEf3XzzzTh8+DB27NiRrn3wg4BnfHyDS2CxwKcbbN4c6haISEYx6OrQoQPy5cuHa6+9FldffTUmTZrkvf27774zPXwbOCn5gm7dupnA7dSpU7jrrruS9DT2u7BW5JQpU3Dvvfcm+b5JLj33CXda5cn5wuKv88CBAyjPipA+ihQp4r2tQoUKl9zHqFGjsG3bNjN0nBqeHfLiewYhl4f9zU6s/ZcSvtRsr11rKlzxd0xMBPhdFe6/q0QODsEWLVrUjAJxnjfnibds2RJly5bFTTfdZAK7L7/8Eh07dsSPP/5oRn7mzp2Ln376yQSNK1euNHPD2QNYrly5UP86rqJVntwhLHoA6Xyy5SQS+Y1mCkVe+httzpw5eOaZZ0wSSI0aNdIcas6bN6/3wrNHuTwXXhZXBUbhgr/P+vWe4qu9e3uGuFn0mkvgXXGF5yevcztv5/14f/dPEpFIwyCOPXyDBw82w7979+41wVzz5s0xa9Ys7/1GjhxpTuo5ZNu3b1+8/fbbFw0hS3it8iRh1gNYvHhxc5bniz1/VKxYsTQfO2/ePDNMwPmCl5o0PGjQIDz11FNJegAVBF4eN42I8NzBTe1NjZZbkkizceNGc/LfokWLi27znQvIqhEffvghbr31VjRr1gy9eeYjmf684cljKOf9pYTtGT8eGDZMqzyFVQ9go0aNsGLFClMD0PbNN9+Y4I9nfcRUfs4J8U3pX7BgAdq3b4933303XW/8HDlymKEE34tcflDFRb3dgMsLuXlIlMMwnLbEJff4c/v2f25Laa1NX76383G+++F+RZyMiX8MAHfu3HlReZgJEyYkuS+n/eTMmRPr16+/qCNBLp9WeXKPsAgAOXGX2bs9e/Y0SR8c0mXXPnvs7CHgNWvWmDM//qRFixaZOSJDhgwxc0AYHPLCMjISWJUqueMZdnP1Bi23JJGsXr16ZlrQfGYipDFdaPbs2ab01/fff2/mkT/UqRPA+oEHDyLHhe8CezqRXJpWeXKXsAgAOR+P8z0YwLE38Pnnn8ewYcPMnA4bs7F4Pzsra+rUqYiJicEbb7xhUvzti535JYFTr5476gCynW6j5ZZEgOuuuw6PPPIIHn30UZP5u3XrVlObj8X/7UxgFmh++OGHzXcF6whOGzECy5cswXtMICxSBEWrVkWe3LlNYsju3btN2RhidQn2JPL7htUj7J7FBJ9u8/TcJxxplSeXYR1AyZi4uDhOjzc/Jf0++ojnic6/jBvnrld13z7LqlLFsrJlC87zw+PwePv3h/o3l0i3evVqq3jx4taOHTu8286fP2+NGTPGatSokVW2bFmrWbNm1oQJE6xz586Z27t162a1a9fO3M84cMCaDljXAdbuC3/ksydOtG688UarVKlSVocOHczdevToYY6V/LJp0ybvsdNzn3Dkps/2OH1/W2FRCDpUVEgyY5hZmkaytaPaWa0aXLXc0q5dwZ18zSKrZcoAK1aYThMR9+LQb/I/YiYT+hSKlrRxKj0TLZzc0cnRnZ49gddeizejgnFxcRE7nz8shoDFXRhUsWyjUxMs2C6WjqxaFa6g5ZZExAlWrXJ28EdsH9spCgAlRAFW//7OfurZPqcGqMlxqitXVwlV2QUel8e/sFCCiEQorfLkLuoBlJCtEckyK07EMjWdO8MVtNySiDiBG1d5inQKACUkOOWC8zA4h8xJ2B7WA3fDlBDf5ZacgO1ge1QnUCTyuKlaTrit8pRRDvnqkEg0dChQoICzApiCBT3tcgMttyQiTuGmVZPCZZWnzHLIV69EIq7IxIwxJ60XyUUCfFaKciynL7fE9olI5NAqT+6jAFBCqm1bz3y7UA8F8/icl9i6NVxByy2JiNNolSd3UQAoITd6tOeDI1RBIIcCuOzbqFFwBS23JCJOpFWe3EUBoIRc3rzAkiWegsLBDgJ5vNKlgcWLPe1wAy23JCJOVLu2O+oAsp2iAFAcggX4uZpEMHsCeRz2/LltFYs1a+AKbmmniPhH3brueCbd0s5AUw+gOAaDsGXLgI4dPdcDlR1s77dTJ2DpUncFf7R2rWc5Iydj+9hOEYkcWuXJXRQAiqNwGHbKFE+BY5Zk8XdvIPdXqBCwYAEwebJ7hn19abklEXEirfLkLgoAxZHatAG2bvUsLh4T4/lgyejSbPZjuR/ub8sW92T7pkTLLYkEDheISECU+SmXT6s8uYcCQHEs1uNjZu6+fZ5M4euu++e2Sw2B+t5evrzn8dwP9+eGOn+p0XJLIv57L61f76mnyRPDWk3zIQYnkRUWrkCC+RlTqhBq1fLczvvx/lpCLG1a5ck9sliW/pwzKj4+Hnnz5kVcXBzyuGHtMJfjX+rGjZ7kAs4v41Do5s3/rOvIXj6uL8zEDpYjYKYXJ/tWrZrx3kMnZrBdcQVc4+xZ589XlMjCIuWsozlyJLBtm2cb/0bTyl71vZ0nlP37e3q69LGfMi4HWaECcPiwMwr9c943p/5w9MfuAIjX97cCwMzQH5Cz1nVkPb9wCfTS+l2dsnTepfC14Mog4f6aiHuCEi6fyJ48njRSRro/7L9nnmxyPXMuHenmUYVA4Tzudu3gGJz37Tv1J14BoIaAxf34gcwz9EgINLTckkjGvvzZIzVmDHD6tCfwy+jYl/1Y7of7q1gRWLhQr0pyWuXJ+VzSlyAiNi23JJI+cXGeoVoGIxyO9Pfa2dzfoUOepLWuXT3Hk39olSdnUwAo4jJabknk0vbvBxo1AmbO9FwP1Fw0e78zZniOd+CAXh2bVnlyNgWAIi6j5ZZELh38NWzoKZnk716/1PA4PF6DBgoCfWmVJ+dSACjiMm5Zxsgt7ZTwwmHYZs2AXbuCF/zZeDwet2lTDQf70ipPzqQAUMRltNySSOr69g1uz19qPYH9+oXm+E6lVZ6cRwGgiMtouSWR1EuPTJsWuuDPxuOz1iCzjyUprfLkHCoEnQmqIyShLGZbtKinFIXTcMk9rrqiIrkSTG4oPiwXf44xYB8xImNFufl6syh3586X/3kTrzqA6gEUcSMttySSFIs8HznijOCP2A4Go2yXpP459thjniDZXpaPxbVrVUtANE4hCzwvJn9GR1tmWT7ebi/Lx6F2Pl4nmxmjHsBM0BmEhJJ6PEQ81CMeZg4eNJkjrNWdiChEIRFZWF+ncGG/HSJePYDqARRxKw4rjR/vrB6PCRM03CXBx/l29vJuTsNpGhzmlMvHxZ2yM/jTkxcQSgIRcTEttySRjsuyjRwJR2P7Mrr0nEigKAAUyQB+mHMishM+1LXckkSyDRs8CQROeC+mhO3auhXYuDHULRFJKirZdRFJ9uHNL5g1a4C1a4FVqzwTj32zb6OjPevzcok2rtLBAsis1cdyLcFcbokrEAS7+G22bEDp0sDixZ52iAQb35tuaSc/F0ScQgGgSCqTyjmviEM3lypPwGBw3Trgl1+AsWM928qX95Qn4EL0wchQs5db4goEwSqCy+CvcmVP8Mfji4QCT8wuVTok1Ng+trNHj1C3ROQfGgIWSZZZywr+rLHHn9u3/3Pbpb5gfG/n43z3w/0GmpZbkkjEXnknB3/E9rGdIk6iAFDkAlbtZ2HRMWM8vXoc/s3ovCL7sdwP91exIrBwYeCfai23JJGGPd5usHlzqFsgkpQCQIl4XDyeQ7XMqGXhVn8Pn3J/hw55lkDq2jU4i8RruSWJBPZJlhuwTI1TE1UkMikAlIi2fz/QqBEwc6bneqBq6tn7nTHDczzWNA1GncBRozzLsjFT+Lrrks5JSovv7ZzPyMdzP9yflrUSp0hMhGsw+HNTeyX8aSWQTFAlcfcHfw0bhiZztkwZT9JGMJMn+AXEUhTejOblCdi8IRFnkAMWsprllnJEZ0HlylmSZDRXrRq8jGaRy/2b5pq7bsD3ED9n9F5K/0ogSWglEL9TFrBEJA7DNmsW/OCPeDwelxm7y5YFr3wKv3hYhoIXk4148NjFyy3t9u9ySyKB/ptmGSY3DAPnyKHgT5zFJedOIv7Vt2/wyqWkhMfl8ZkhHGpabkncjDU43YAlk0ScRAGgRJz58z1rc4Yq+LPx+Kw1yOxjEckYTle41JzWUGP72E4RJ1EAKBGF9fg4/OmUeUNsB9sTjDqBIuGIc1XdUAeQ7RRxEod8DYoEx5AhwJEjgcv2vVxsB0vPsF0icvmYqOQGbmmnRA4FgBJRy7uNGxf6od/k2J7x4z3tE5HLw6QmlipyanYt28UC88yml3QqWNCT9et74TbxK2UBS8TgfDsWY3UiZjFyXuJjj4W6JSLuwgCL6247IaEqNWyfUwNUX3fddRdOnTqV6u0NGjTAkEwMV2zZsgVPPPEEPv/8c0QzffuCxMREzJ07FzNmzECBAgXw0UcfXVSN4MCBA/jwww/x888/I2/evGjRogXuu+8+ZHXKfB4XUh3ATFAdQHfVC+NybFyj14nV+PnlwF4MZgYH7YsiCLW2RIKBvedcd9uJ5WBiYjxF1PPkgeMtXrzYBGO0bNkyDBs2DJ9++ily5sxpthUtWhQ1a9bM8P5/+OEH1K9fH8ePH0euXLm828uWLYsaNWogISEB27dvN4Gir7/++ssEfO3bt0fVqlXx+++/49///jfuvfdejOFamxkQHx9vAsm4uDjkccOLEwDqAZSIsGEDsG0bHItB6datnkLNHNISkfTj93fPnp51t500xYNF35nk5Zb4ohmLo15w4sQJ87Np06bIly+fdzt772bPnm16CqtXr47HH38cuXPnNreNGDEC69evNz142fjLAxg7diyWL19ugsknn3zS29PI27nvZ599FitWrMBVV12FwYMHmwAwuYIFC2Lt2rVJeg2zZ8+Of/3rX3j//feRxQ3dqw6kvlOJCFz9wg3c0k4Rpxk6FChQwFkZ/py2xnaFiwEDBuCZZ54xvXj3338/1q1bh7p163qHjTt27IgvvvjCBHv0448/on///maotlChQuYx1KdPHzMU3LJlS3OdwV9aGPj5Bn+0YcMGlC9fXsFfJqgHUCIClz5jLS4nl4tg+9hOs0qHiFwWrlHNZKp27ZyT4T9hQvisnc1h2bfeegs7d+5EGa5lCeDuu+9G5cqVMWXKFDzyyCMoXLgwJk2ahHbt2pkgkYFe9+7dzXW68cYbvT2NvkPA6TV06FAzNP3rr7+iRIkSmM+irpJhCgAjGLvy2T2fllGjRuG6667L8DFefPFFFCtWzHw4+Nq1a5eZ0PvTTz+Zbvxbb701ye1nz57F9OnT8b///c/MC+FZ5iO9eiHm5MkMtWPV8nxISHB2tVgGp6tWhboVIu7Vti3QuTMwc2Zoh4I5+tmxI9C6NcIG5wdy2LVv376wLkyk5s+jR49i06ZN3vvddttt6N27t/nJ74533nnHb21o27YtatWqhdjYWLz55psYPXo0Xn/9db/tP9IoAIxgnMzLbngbz9auv/56POaTispJv5nBeRucZOtr4sSJeOWVV8yZ4VdffYXO/MROIduM80tuueUWM1eEZ55TJkzA8o0bEZOBdsSCgaOzA0DavDnULRBxt9GjgZ9/Dt1Sj1FRnuXpRo1CWOHnOJMmGAAmV7JkySTXmdRx/vx5k9hx5ZVX+vU7i5c2bdqgYsWKpmeRnQs8nlw+BYARrHTp0uZi40TeUqVKmTM32/79+82Z1i+//IIiRYqYrKvmzZub2w4ePIgePXqYgNF+DM8GH3roIXPZsWMHVq9ebR5rZ3WNGzcOrVu3xoMPPmjS91944YUU27Zo0SIzZ8TGIYPixYvjCwD3XObvyXPV0xkKG4OPZWp4cq05zSIZkzcvsGQJTyI50hDcIJA9f/xIXbzY045wcs011+DQoUOoU6dOks/m5NgbOHDgQFMuhr1zH3/8sXfunz+TNdge2rdvnwLADHLIdFlxot27d5uzLQaBnTp1Mr2D/PnBBx+Y2znfg3M6unbtat6ExLOxP//8E7fffrtJ2+eb1O5p5CV//vwmkLxU7abkHzB8XFRUFDx5aZcn0UXnOQz+LlRhEJEMYnWjFSs8PXEXklEDjsepXNlz3OTVlcIBe9v42d2vXz+c8SmoyqFhTuUhbmciCMu1vPzyyxg+fDgeffRR/PHHH97vDLK/L9JryZIl2OwzPMJpQcw4Zs1A9jJKxrjnm1GC7vnnnzc9b5yrZ2O2FoeK7Tl9PNP7+uuv0a1bN5PptXDhQvNhwLkirNfENzx7GX17FTNi5MiRJmhsmoHHRsE9ERVPkDmEFNRq+8m3iYQBBmHLlnkKRLMIPM85A7EEpL3fTp34ORV+PX82Jm0ww5cBHod8K1SoYOZys2PAFG4GMGjQIFPjj3PHiSf9HM3p0qULvv32W9NT16RJE3Nh8gi/X1gGhuVhOK+PJWDY4WB/X8ycOdOc/PN7hKNNHGHitKStW7eaYJTFo/05xBxpFABKqr755hvzxuN8C0725YVvbg4DsCq73ZM3depUVKtWzdyfRTn5weBP/ABhMPreqFEocc/lDgADHHSILmXh9Gnn14rKkSP9w7/8ELQnY6eExU2ZgJPmN1caRZ9PnjxpeoE51yY5HpfFWVkfLCPZfCLBwGBsyhSgfXuge3fPOuD+HBJmrx/PmZjtG04JH9S4cWN8+eWXSd7fHM1hTxyHefk9wDIs9mcM5/wxcOMcQbuwMod8ubrHmjVrzHcH5xCyN48lXBjo2eVfOER87Nixi9pgF6Dm98vKlStNBjI/dzgdiMGk6v9ljgJASXPSb4cOHVLsvbMLfxLP0HhhZXU7zd9feNbIUgOvvvoqHn700Qzvh0NB69bB8TiElF733HOPt2o/n/u9e/cmqYvFuZZvv/12htvC+Zs8U+dwC4ff6fTp02ZeD7PveObNEwHOCeLcTn8H/iL+0qaNp9A6VzFjqRh7xZCMrApkn6CxLB1LNrHOX7iUevHFnraUPvv5+VKlSpWLtrMzgNN+Uiri7LsfPp4Jfr7S+71x7bXXmov4hwJASRXn7/HL/1LDt5wTwjM1zvvgHEGe7dlFOzNzhvbdd9+ZtH8mirAAaWbUqwf88ovz6wCynenF5BrbtGnTzDALq/AnL5h6+PBhMzcneW/gb7/9Zu579dVXe7fxLJzzczhsz94/u6eRmdjs7WOvIF9rJvjwbJ6rBTAxiMNCzPgWcSoGaRyZZI1irrs9YsQ/qwNdqkao7+1cspFr+7J4gVtW+BBJiZJAJFUPP/wwJkyYYApv+vYK2kkgxHUiOU+D3fzc/vfffycJ1jiEfLkTfon1/zj0zKWBOK8ks2rXdnbwR2wf2+kvDNIaNWpkAnnWUeRwC18vG+drVqpUyayr6Tl+gjmD53PORB7+tHsa77zzTrz33ntm2IUrATD4Iw4PMeGHxxJxAwZtrHTFwgTr17MygWcZuVq1PL169jkrf/I6t/N23o/3Z3kZPl7Bn7ieJRkWFxfHAQTzMxxUr17d6tOnj/f6+fPnrQEDBljR0dHmtjp16ljFihWzRo8ebW7/448/rPz581vvvvuu9zHLly+3oqKirEWLFpnrixcvtq688kqrYcOGVsuWLc1j1q1bZ/7PC5+/atWqmf/77of7zZUrl/d+9mXq1KkZ+t1+/pmDPc6/rF+fsdeOzwufy1OnTpnrp0+ftsqWLWu98MILVkJCgtnG1yQmJsbavHmz93G333671ahRIysxMdEaOHCgVbx4cevw4cPmtu+++87s0368L76OmzZtsj7//HNznKFDh2as4SIOc/68ZZ096/kp4SsuzL6/M0JDwOLFRbU5l8/G4dvXXnvNZPpy0i57e5i5ZQ8xcliRNZ58FxBnAWcu/G2XeeFi3+xhYoYXewe5/5iYGG8Bat9C1L7FRLnfcynM1i5XrlyGXrFq1TxDN1xnPCPzfgKNvQ1sX9Wq/tnfvHnzzCRtFtnmUC+xJ5A9fgsWLDA/7aLcnGDNuZ5cGYaFuVla4VJY4oFD9CzvcNNNN6FXr17+abiIA96LHPIVCXcKACVJ8JYSzv3il3x6J+TecMMNF9X0Y0aZjXPILjWv0C427c8Pdc7bYUkIp2L7/FUnlVl6XE7PXoPTF7fbmMn9xhtvmMLcrNeVfEm+1NhlHzglgI9lssjGjRu9ySIiIuJsYfVpzblmnATPHozatWtfsthwRh8j7tSlC/DMM/9kADoJO1VTWBEvw1iHkb2t9gosqWHpBmbwMshnPUeWavDN8L4UzgVkiR4G/Qw6k2f3iYiIM4VNtMOq4JygPnToUDNhnZPeuVSZvx8j7sVJ25zMHayVAdKL7WE5CX9OKmfyB8vCrOCyBMkw2cPGSv3M8v3555/N0H5/dkNeYA/1+97f9/+2PXv2mJ927S8REXEBKwysX7/eypIli/XZZ5+Z6ydOnLCqVq1qde7c2a+PSU6TSN3nyBHLKlzYsrJmDX3CBy9sR5EinnZlRvIkELr77rtN0s6kSZOsH3/80frkk0+sFi1aWEuWLDG3r1mzxsqePbu1YMECc/3nn3+2rrjiCmvWrFnm+oEDB0xCz9ixY03iyN69e623337b6tu3r0koWbt2rTVx4kSTOHLPPfdk7hcQEQmiOCWBmNUdXO/ZZ581mYi+xowZY+XIkcM6efKk3x6TnP6A3GnevNAHfr6XC/FXJn+neVaFChWsM2fOeLcxs3fkyJFWkyZNrBo1alj333+/ycq2b2vbtq15H/gaNWqU1aBBA29mHAPLm2++2apUqZI1ePBg69y5cyagZPZwzZo1zT4YBKaUKSwi4lRxCgCtLHwi4HItW7Y0iQWzZ8/2bvvhhx9Qv359M7SV0rykjDyGWa++i2Bz9QVmrnIivIa/3DcfcOZM/y4LlZGh344dPUtViYhI8MTHx5s5zJH8/R0WcwD5AvqWL7GXn6GU1hfM6GM4X4p/MPbFt2yJuMvo0Z7l4UI1H5DJslz27cKa6SIiIkEVFgHgFVdcYZao8sUlqihHjhx+ewxXpGDgaF9YA03ciQtZLFkClCkT/CCQxytdGli82NMOERGRYAuLMjDM5E2+FJUdnLH4rb8ew8DQNzi0R8/ZlSzuwyTXr74C2rb1LBR//nzgj8kqQxUqsFCz5/j60xERCb74Cx++YTALLrIDwFatWqFTp07466+/ULx4cbNt1qxZqFmzJooWLWquHz161Kwve/PNN5uh3/Q85lJYM400FCzpxSBz82auaKLnTEQk1I4fP+5d2zzShEUSCJcMY2DHiJ51zLgiAZc1W7RokVmKzDfBY+XKlbjxxhvT9ZhLYRFd1kBj4Vwum+YvdnIJeyQjdXKqU+m1cS69Ns6l18aZIvl1sSzLBH/FihWL2AUgwqIHMFu2bPjmm2/w3nvvYfHixWZVDwZ6derU8d6H2+644w7vOqfpecyl8I+mRIkSCBS+ISPtTekWem2cS6+Nc+m1caZIfV3yRmjPX1j1AIYbpac7l14b59Jr41x6bZxJr0tki8x+TxEREZEIpgDQgZhp/OKLL6ZajkZCR6+Nc+m1cS69Ns6k1yWyaQhYREREJMKoB1BEREQkwigAFBEREYkwCgBFREREIkxY1AF0o9WrV5s6hFFRUWjXrh0qVaoUkMfI5WFx7zlz5pjC4FwRpn379ihYsGCaj9m1axe++uorHDp0CJUrVzavDetMin8dOXIEn3zyCfbt24cqVargrrvuSvfzvH79esycORMNGjQwr4/415YtWzBv3jycPXsWzZs3R7169S75GBbjnz9/PjZs2GCW3+R7TYlv/sfvjBUrVpiad/fcc88lV646c+YMPv/8c2zbtg05c+ZE48aNUbdu3QC0TEJNPYAh8O677+KWW24xy9Bt3rwZNWrUMMvQ+fsxcvnBX5s2bfD000/j5MmT+O9//4uqVavit99+S/UxQ4cORcuWLfHTTz+ZxwwcONAUE9f60P71+++/m9dixowZ5nl+9tlncfvtt5sg4lJY7Z/BxQcffICvv/7azy0TnjBVr14dv/zyC/bu3Ytbb70Vb775ZppPzMGDB02QyPcLg0YGKDfddJOeTD/r27cvHnjgARw7dgz/93//Z05QuSpWWidZfC2HDRtmXpft27ebFbNeeOEFvTbhiIWgJXj27NljXXHFFdaECRO825577jmrcOHC1pkzZ/z2GLl806dPN8/zrl27zPWEhATrhhtusNq3b5/qY1avXm3uZzt27JhVqFAh69VXX9VL4EcPPPCAeS3s55qvEV+rKVOmXPKxHTt2tAYNGmTVrl3b6tOnj14XPzp79qxVtGhR83lk4+dU9uzZrT///DPVx911111W9erVrZMnT3q3xcbG6rXxox9++IGLPFjff/+9dxs/y2rVqpXqY8aNG2feV3Fxcd5t77zzjhUTE5Pkc07Cg3oAg2zhwoVm3eD777/fu+2hhx4yZ8RLly7122Pk8s2ePduc7ZYuXdpc51B7ly5dzNBWYmJiio/h0AjvZ+Mwy7XXXmvW1hT/9czOnTsXnTp18j7XfI2aNGliXrO0TJw4EVu3bsXLL7+slyMAli9fjv379+PBBx/0buvQoYN5nRYsWJDiY/78808zxMjev5iYGO/2ihUr6jXyc88sh9Y5hOv7vcHRCvaop4RLonJxMN/PO/YE8nPN93NOwoMCwCDjvAouPn3llVd6t5UtW9asK8zb/PUYydhrU65cuSTbeP306dPpDug4F2rt2rVo2LChXgI/YcDAYd+UXpu0/v75WgwYMADTp09H9uzZ9XoEAJ9/npzypMfGoI6fV6m9NmvWrDFBBk+exo0bh1deeQUff/wxEhIS9Br5+bVJ6T1j35aSO++8E//617/QrFkz9O/f35x0ffrpp/jss8/02oQhBYBB9vfff1+06DYDuVy5cpnb/PUY8c9rYy8Wnp7nmfNs7r33XnPG3bFjR70EfmI/9ym9Nqm9LpzIzp4oBhcVKlTQaxEgfP55Ypo8GSet1yYuLs785OvDEQyeYL300kuoVauWma8pofs844kWg0MG47lz5zbfMZzX+euvv+plCUPq0w0yvqHsD0DfIa4TJ06Y2/z1GPHPa8Ogzr4tLUz6aNWqlen94NCLsoD9x37uU3ptUntdmCzC5B1eONRITKBauXKluf7qq69qSMtPrw2DCQ4Z+g4RpvXa2NvvuOMODB482PyfvU4c1Xj//fdNr62E5vPs7bffNkH5jh07TAYwsQe9e/fuJrmHPbsSPtQDGGQs3bJnzx4TvNl4xsWALrWyLhl5jGTsteF8MV+8zg/CtEonsNfitttuM2fNLLlgn2WLfxQvXtz0RqT02qT291+zZk0MGjQI+fLl814YlLPMCP/PYUvJPPv59x1SZEDIYDu114aZqHTDDTd4t/E9w55aBh7iH3z+kw/12u+h1OZbbtq0yWTb28Ef3XjjjWYeoKYbhaFQZ6FEmgMHDpiMqtGjR3u3PfHEE1axYsVMRh2dO3fOGjBggLVixYp0P0Yy79NPP7WioqKsLVu2mOunT5+2atSoYXXp0iVJpiJfm0OHDpnrx48ftxo2bGgyTI8cOaKXIUC6detmXgu+JsTXiK/Vxx9/7L3PnDlzrLfffjvVfSgL2P+YGVqiRAnzeWTj51R0dLS1b98+77bXXnvNmj9/vvd61apVTWa2jZ9xefLksUaMGBGAVkamdevWmSzgRYsWebe1a9fOql+/fpLnnZ9nW7duNddffPFFU13i6NGj3vt89NFHVtasWa2//voryL+BBJoCwBD48MMPzQckS1vccccdJrhbuHBhkg9VvnFHjRqV7sdI5p0/f966//77TVmLXr16mXIJ11xzTZJyFvwS42uzfft2c533z5Ili/XII4+YD1L7MmnSJL0kfsRSSNdee61Vs2ZN89pcddVV1r333mteMxtfgwoVKqS6DwWAgcEAg59HDC5YcoefU2PGjElyn9KlS1uPP/649/qaNWusAgUKmMewNE+pUqWsJk2aqKyVnzHIZmD90EMPWbfccot5zhkY+p7Q8vPsyy+/9Jaxqlatmnm9+Lrw841lYYYNG+bvpokDZOE/oe6FjESxsbFYsmSJmTfDgralSpXy3saX5PXXX0eLFi3MxOj0PEb8Z/Hixd6VQLhqhO98mZ07d5oC3I8++qgZSuT8mJQyhJltx4QQ8R8OLbIkj70SCFec8MXVWHbv3o1evXql+PjJkyebOUzJHyeZx/fAF198YYYKmzZt6h3mtY0ZMwbly5c3t9m4cg5LxXBqC+/POWbif1xBinNfmRDStm1bFCpUKEnh5w8//NCUGGPJGGJxdU5lYRFofvZx9RwlUoUnBYAiIiIiEUZJICIiIiIRRgGgiIiISIRRACgiIiISYRQAioiIiEQYBYAiIiIiEUYBoIiIiEiEUQAoIiIiEmEUAIqIiIhEGAWAIiIiIhFGAaCIiIhIhFEAKCIiIhJhFACKiIiIRBgFgCIiIiIRRgGgiIiISIRRACgiIiISYRQAioiIiEQYBYAiIiIiEUYBoIiIiEiEUQAoIiIiEmEUAIqIiIhEGAWAIiIiIhFGAaCIiIhIhFEAKCIiIhJhFACKiIiIRBgFgCIiIiIRRgGgiIiISIRRACgiIiISYRQAioiIiEQYBYAiIiIiEUYBoIiIiEiEUQAoIiIigsjy/8JBNVtWfqPCAAAAAElFTkSuQmCC", + "text/plain": [ + "
" + ] + }, + "metadata": {}, + "output_type": "display_data" + } + ], + "source": [ + "np.random.seed(1)\n", + "x, y = np.random.random((2,15))\n", + "fig, ax = plt.subplots()\n", + "scatter = ax.scatter(x, y, s=900, c='b')\n", + "text_list = [f'Text{i}' for i in range(len(x))]\n", + "ta.allocate(ax,x,y,\n", + " text_list,\n", + " scatter_plot=scatter,\n", + " linecolor='r',\n", + " linewidth=3)\n", + "plt.show()\n" + ] + }, + { + "cell_type": "code", + "execution_count": 44, + "metadata": {}, + "outputs": [ + { + "data": { + "image/png": "iVBORw0KGgoAAAANSUhEUgAAAoAAAAHgCAYAAAA10dzkAAAAOnRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjExLjEsIGh0dHBzOi8vbWF0cGxvdGxpYi5vcmcvctoD+AAAAAlwSFlzAAAPYQAAD2EBqD+naQAAd+1JREFUeJzt3Qd4FFXXB/BDE0ILLYAUQTpILyJN6Ui100FAUKk2fBEFVBTBgn5SBHzpVUVBmqCCvgqCgEjvoCjSUoAEpJP5nv8dZtkNSUg2s7tT/r/nWePO7sxcdpPdM/fec246TdM0ISIiIiLXSB/qBhARERFRcDEAJCIiInIZBoBERERELsMAkIiIiMhlGAASERERuQwDQCIiIiKXYQBIRERE5DIMAImIiIhchgEgERERkcswACQiIiJyGQaARERERC7DAJCIiIjIZRgAEhEREbkMA0AiIiIil2EASEREROQyDACJiIiIXIYBIBEREZHLMAAkIiIichkGgEREREQuwwCQiIiIyGUYABIRERG5DANAIiIiIpdhAEhERETkMgwAiYiIiFyGASARERGRyzAAJCIiInIZBoBERERELsMAkIiIiMhlGAASERERuQwDQCIiIiKXYQBIRERE5DIMAImIiIhchgEgERERkcswACQiIiJyGQaARERERC7DAJCIiIjIZRgAEhEREbkMA0AiIiIil2EASEREROQyDACJiIiIXIYBIBEREZHLMAAkIiIichkGgEREREQuwwCQiIiIyGUYABIRERG5DANAIiIiIpdhAEhERETkMgwAiYiIiFyGASARERGRyzAAJCIiInIZBoBERERELsMAkIiIiMhlGAASERERuQwDQCIiIiKXYQBIRERE5DIMAImIiIhcJmOoG2Bn8fHxcvz4ccmRI4ekS5cu1M0hIiKiFNA0Tc6dOyeFChWS9Ond2RfGADANEPwVLVrUvHeDiIiIgubo0aNSpEgRV77iDADTAD1/xi9Qzpw5zXpPKABWrRLp10/kzBn03Jp3XFw45skj8sknIi1amHdcIiIKnLi4ONWBY3yPu5HjAsDr16+r4dhgdOkaw74I/hgAWlNsrMiAASJz5+rBmpnBH+B4p0+LtG8v0q2byPjxIuHh5p6DiIgCI52Lp2+ld8pcvBUrVkibNm3kjjvukO7du6dovy1btkidOnXUPgUKFJDhw4ereQHkDKdOidSvL7JggX7f7ODPYBx3/nz9fJGRgTkPERGRWRwRAO7evVs++eQTeeaZZ6Rx48Yp2ic6OlqaN28uNWrUkFOnTsmXX34pEyZMkDFjxgS8vRSc4K9ePZG9e9ErHJxXHOfB+erWZRBIRETW5ogAsFKlSqoHsG3btpIhQ4YU7TNjxgw1XPzRRx9J7ty5pUGDBjJo0CD5v//7P9WjSPYe9m3aVOTIkeAFfwacD+dt0kRvBxERkRU5bg5gSq1fv17q1q0rmTJl8mxD7+HIkSPl0KFDUqZMmYCde/LkybJt27YkH8+SJYsKRNPi+eefl549e0qVKlV8th87dkwFv//884/q7cyVK1eSx/j6669l1apV0rFjR2nYsKHYBeb8BbPnL6mewIEDRWbPDk0biIiIHN8D6A8M+0ZERPhsy58/v+exxFy+fFllDnnf/HH33XdL1apV1a1s2bIyZcoUNffQ2IYezbSaOnWq/Pnnnz7bXnnlFRX0bt++XZ3z/PnzSe6/b98+1SM6ffp02bVrl9jFsmV6wkeogj8Dzj9njsjy5aFtB9nb0KFD1QVhcrekPq9Sqnbt2rdccGKKTN++faVEiRKSJ08eadWqlezfvz+N/xoishLXBoCJMYZ+k8oKGj16tISHh3tu/tYAbNGihTz77LPqhl46aNasmWfbU089JSdOnJAPPvhA9eSNGzdOTiPV1Kv3sn///nIGNU1uwIcz9v3jjz/ktddeU8EqehqxbciQIeo56Mk7fPiw2jc52BfPxfA4EmTsAi/HU0/p2b5WgHagPV5vE1GqvPXWW3L27FnPLXv27DJs2DCfbUhgSwv8vV+7ds1zHxejDz/8sPz++++ybNky2bt3r1SsWFEaNWoksZzXQOQYFvmqDL4777xTIhOka0ZFRamfBQsWTPJqHB+Axg31/wJh48aNqhdwz549ctddd8mGDRukfPnycgSTy0SkVq1asmnTJnn66afV/StXrkjnzp3VlwGu2CtUqKDmQho9jffcc496Hv4/Y8bbj/q/+OKLUr16dXnsscfETkaM0EuyWGUKJ9oRE6O3i8gf+Hv17u1LbNuiRYvUZwKmc+BvHReOmN8MmM6CHrw56I6+4X//+58KJNetW6d69nbs2OHT04ge/19++UVNEcHxEGC+++676gJ52rRpfCOJnEJzmBYtWmhdunRJ9LGrV696/n/s2LFazpw5tcuXL3u2DRs2TCtQoIB2/fr1FJ0rNjYWNWPUT3+dOXNGHWPhwoWebRUqVNA++OADn+fh39S9e3fP/f3792vZsmXTpk2bpg0ePFgrWrSoOpYBjy1evDjRc/7444/qnEePHr3lsUWLFmklS5bUzp075znO+PHjNavDW5AlC2r4WO8WFqa3jyit8ubNq40ePdpz/4svvtAiIiK0pUuXajExMdqGDRu0UqVKaWPGjPE8Z9KkSVqOHDm0P/74Qzt9+rRWpEgRbciQIeqxK1euaJUrV1bHvHjxorrhswWfD2vXrvU5d+HChbWHH36YbyI5QqwJ399255geQFzxYhgDwxe44f+Nq2D49ddfVcIHfkKPHj0kc+bMMmDAADl58qR8//33aqh18ODBIV0XEEO06Pn77bffVNswXNuvXz/V+4chGQOSVD7++GP1HMzfwRV+cgkdKYEeTZTSmTt3ruohsBN0cFy+LJZ06ZI+L5HIbK+//rq6oQICevruu+8+dR9zfA2YBoLh2y5dukjv3r1Vjx6GlgGfiZjy4t2rWKpUKTXkO2LECLXcJYaI0RuIBDJMTSEiZ3BMFnC2bNl85rF8/vnnan0/Y9gUH3IYFjXm9+HDEkHfc889pz7wcP/ll1+Wl156SUIJk68BH8B58+b1bK9cufItS9Ygaxn/5uLFi6vkjrRCQBkWFiYzZ85UN8CHP15LfPCPGjVKrAj9bOPGiaWhfX374vcw1C0hp0ASF+bn4aIV83yNi1/jYhhDtsbFLIZuMY0E1Qe2bt3qU/0gIeyzZMkSNf+4XLlyaorJo48+Kk888UTApr0QUfA5JgC8hG6W22S6eQeIgBIpmA9jJYUKFfLM12vdunWSz8OHfLdu3VQQiDk8b77+urz9wguex1V+cyonw+FDHsGwNwTNhQsXVvMKrWrHDpEDB8SyEKAigXLnTgTyoW4NOYUxwoEe+8Q+K7xHMjCygHnLCBBxkYnqA8nBXOKlS5eq/8c+uHBG7yK2E5EzOCYAdApkFqMoNYZoHnjgAc9QLDJ+Ub7FqMeH3jh8qCP4w1V995Yt5e3Roz3HQQGY+am8WkcvYsKeRPQu1K9fXw0fWdXmzWILaCcDQDILKhEUK1ZMXcQmmbAVHy/n//pLBnXqJIOffFJt6tali2zbscOzfjmGf5Mrfo/gD9UFNm/erHoFicgZHDMH0ElwRY8eTQy/ILu3ZcuWUrNmTYlBSumNLOG3335bFXRGLUOUkOnTp88tx8G8Hcz5McrA4Ioe84E+/PBDdR+Zf7iPjGI727IFc5nE0tA+tJPITJinh/l+n376qRoSxoXi4sWLb05liYmR7CVKyMY//5R3pk5VtyJhYWrusAFBJIaFvedMY17xmjVr1KgJhpk7dOigLkjbt2/PN5DIIdgDGGJZs2aVSZMmqbIrBpR+QcIHSjGgjAOGhevUqeO5YseHPOblPfjgg559UBtMJk/2OTbWRz5w5oyn9AtK3xjFplH+wYCl8JKbF4ihHyvbuFHk6tW0HyedxEte0YNsQ4zkFc2E6yS0D+0kMlOvXr1UrU6UaUGyGBLBkPCBFY0AdfzaJtgH9UFrPPigGjZGYIcC8U8++aT6LEJvHy40H3roIZWAhudg7nGnTp3knXfeCWmCHBGZKx1SgU0+pmtgJRAMw2BujRGchQxqGN5YycQDdQ4TrHbiRGFheqZtWuWTKIkS39cwQiIlWp9RmWYo43bxoimHIpdCUhYu6BJb89w76cNw9fhxyVS4sO8TIyPlSni4Cva8k0HQA3j16lVPvUHv+X9EThNnpe/vEGEPINkaLl/MCP6CAWVq0F5+n5K/ULoqKYn1ziWV7ZvYCj8IKhMGlgz+iJyL/flkawkSuy0NwZ+d2ktERM7FAJBsLQUr21kGev7s1F4iInIuBoBkawiqvKYsWRpG7zj8S0REVsAAkGyvfHmxBQvX0iYiIpdhAEi2V7u2PeoAop1ERERWwACQbK9GDXPqAAYS2od2kjWScfB+sAAWEbkZp6ST7dWqJbZgl3Y6BQI8rBONJfiwCgsKce/d61s2CPNHMYUAvbMI0PEeYbk+ztUkIqdjAEi2hy/sMmVEDh60Zq8Oggm0r1KlULfEHeLiRObMERk3TuTAgZtD8In1EiMY3LpVZNeumwvp4L0aNEikWzcRl9aHJSIX4BAw2R4CLHxhWxnax16lwDpzRmTgQJECBfSfuCAw3G6KgPfj2M/7ODguEZHTMAAkR0BvTTKLJIQUhhm7dg11K5xt+XKRsmVFJk3Se/XQE+xvb7CxL46D45UrJ7JihdktJiIKLQaA5AgYquvdG8tZiaWgPU89xaHEQImN1YP/tm1FYmKwnq25x8fxoqNF2rQR6d5dPx8RkRNwDqBDJrjvXyfyQ4LnFC0qElHBPRPcR44U+fxzPRCIjw91a7A2q0jevHq7yHynTok0baondkCg3nPjuPPn6/MF16wRyZ8/MOciIgoWBoAOmeAentgE98vumuCeO7fItGki7dqJJSBwmD5dbxeZC8FfvXoiR46Y3+uXFJwHwWbduiLr11szCOSFIRGlVDpNs2LepD3ExcVJeHi4xMbGSs4AR1OYiD5ihMjUqSKXL+vbvN+5fBIlUeL7jRQhkRItET7bjN4/zJfDkCl6p5wWoCC4XbAg9YFBSl/DlA79du4sMnt2qnel28AwbP36ejAWrOAv4XuL0jHr1omEh4vFLwyT/p32zox28oUhUai/v62KcwBtgBPcU2fCBP0LOlTzATNm1Jd9Gz8+NOd3ugEDQhf8efcEIkM41Jj5TET+YgBoYZzg7h/0ymCeVvHiwQ8Ccb5ixURWr7ZO75CTLFsmMndu6II/A86PHjdcnIUKLwyJKC0YAFp4jhOGuTCUGawJ7jhfZKQ4AuZnYZ5WMHsCcR70/Fl1fpjdobcLGdVIrrECtAPtCXadQF4YEpEZLPJRSolNcA/mMJf3BHcnBYGYp4W5eBCowME4bpcuImvXMvgLFMyBPX3aGhnegHYg4xztChZeGBKRWRgAWgyu7lHaIpjZjQacD+dt0sQ59c4wDItEDAwdoiSL2b2BOF6+fPpw3KxZHPYNZJIDEqBCPfSbENqDzHO0L9B4YUhEZmIAaDGc4B4YKOS7f79I374iYWF6NrS/9RCNfXEcHG/fPpHWrc1uMXnDfDsj+91qsGII5iUGEi8MichsDAAthBPcAwvlbpCZe/KknilcuvTNx1ASIznej6NkBvbHcXA8p5XRsRqUO0J5EytD+wJZUIsXhkRkNtYBtEgdIUwkx1qm/q5iYWYNO2NeG4Y20bvl1AAHX9g7d3qvphIla3b6voZFM0dK/nsifFZTqVTJuaupWNH27SJVq4ot2omVdgJxYehvcXOzPxeM9qBHncjO4lgHkCuBWIWVJ7g7tZ4dgjh8YeOGbE6JQuaI73OOHlXfmBRCCNDt0k6zA0DvzGcrfDYYmc9OvjAkcgsuBWcBVp/gPmoUVwewkpMnT8qwYcOSfc4jjzwirdMwMfHHH3+UH374Qd566y2f7fHx8fLNN9/I8uXLpVatWvKUipx9Xb9+XebOnSu//fab5MmTR7p27SqlvcfbUwm9s96rVlgR2od2JvJypAkvDIkoUBgAWoAdJrj36xfqlpAhLCxM7rvvPs/9RYsWqWDrnXfe8WwrXLhwml6w3bt3y8KFC30CwL/++ksaNWok5cuXl8OHD8v58+dvCQCxsmS7du1k37590rt3b9m1a5dUrVxZfl68WGpgDN0P+7HkWoCCvxjJK5oJU6ERnG7cKKbihSERBRIDwBCzywR3ZLty3ps1YN4pgivDoUOH5MCBAz7bYMWKFaoXL2PGjNKgQQNp4zVxa/jw4VK8eHGfAO7DDz9UvXcNGzaU+fPnq55G45gdO3aUmjVrqp7BYsWKyYMPPpho25YuXSorV65U7SlVqpTa1rNNG6nRsqXf/94fJHDSOh/O2549YipeGBJRIDELOMR27NAXbw9kBmFaoF0on4JkCbKP7t27y0svvST58uWTvHnzynPPPSf9vLpx69evL88++6ysx7IlIrJkyRJ55ZVXpHHjxur5d999t6enEbc777xTcuXKpYK/5CxbtkwNDRvBHzz66KPiBujFN+vv2C4Xhlb93CKi22MPYIi5eYI7BQaCuW+//Vb279+vgjajB69EiRLSv39/ueeee6RFixYyYMAANT8Pc/rQ0zdy5EjPMG2dOnVky5Ytt/Qq3g56I9Gz6O12QaNTIBi6du32JYVSc2FoVd4XhvxcILInBoAh5uYJ7hQYSNDIkiWL6tHDnDzcIHPmzLJt2zYVAMKYMWPUEHH16tXl3nvvlf/85z9pPvfFixclR44cPtuyZ88uboApEhlN+kTlhSERBRoDwBDDxHErB3+BmuBOgRMdHS358+dXc/a8IcjzTsRAQIih4B07dkiHDh0kvQmLJaMe5hnULvESFR8vtUVkzerVUtmP7qKiRUUuXQ5cEohZMmc2b54sLwyJKNAYAIbY3r1iC2ZPcKfAQQbwwYMHbzt8+/3338unn34qvXr1kqFDh0qrVq08w7Xp/IxkKlasKKtWrfLZtnvvXonNlElKoJq2H72BERVEtm4Vy6tQwbxj8cKQiAKNSSAhhJE5lFlx2wR3CqwuXbrInj17ZMaMGbcEfGfPnlX/HxMTIz169JBXX31Vpk6dqub8devWTdX5A9TvS9iTlxKYa4gSMKtXr1b3r1y5IlOmTJG2bdv6PRSMuNGMeXWBhPahnWbhhSERBRp7AEMIE8bdOMGdAgvB3IQJE1TW77Rp06RIkSKqrh96Br/66iv1nD59+kjRokVVORj09iFYxPAs5gUiKES9v0uXLkmzZs1UryACu6ZNm8ozzzyjSsXgeBhCRi8jgsX33ntPHbd27drqmA8//LB6PsrBXL16Vb788ku//z0YtZ48WSw/TcLPMoeOuDBkiSgi+2EAGMoXP6M7J7iTuR577LFbiiwj+Gvfvr2sXbtWLl++LCNGjJAKN8Yo0bOH4d7mzZurGoFQsGBBVb8PgR16AXEfGb3YH89HGRgjwMPj3oWos2XL5nNuZBN36tRJZREjOERpGSSl+AvrL9uBWe3khSERBUM6zUgRpJAsJh0WZs7VfjqJl7wSE5BVDgDf3xcvirNFRYnkT7AYcGSkSAQXAw4lfEKVKydy8KA1pyHg4qhMGX3Y1oyeMPwbTcjHUfJJlEQlWODazOLX+PdiyUj2AJIbv7/tjnMAQ6x8eXOOg0APH+reN7OCP7MnuBOlBoKLQYOs/ZqhfWYFQThOGjpMb7kIRMDnfbNq5jMRBRcDwBBz4wR3otTq1k0PNqwIwVrXruYekxeGRBRoDABDDFO37FAH0KwJ7paWN68+5Ot9wzYKOYzQoKpNhgxiKWgPCqSbPYLEC0MiCjRO6w8xJ05wNzKGkV8QzOEhlDY5d+5css9BRmuSNe4w8eo28/2OHTum5oskXO3CgIQJJDxgHV0y18iRIp9/jvdZ5Ea1mpDCrwuuD9Aus7kt85mIgo8BYIhhYQRMILf6BPdKlW59DO3FmqVYtgorF6B4LSbCeye1YHgMw1no0cCXBQJJ/JsDERh++OGHMm/ePM/9v/76S2WhegdrqI+XNWtWv8/xwAMPyODBg+XZZ5/12b5mzRp5/vnn5ciRI+r4KIPy0Ucfpelc5Ct3bpFp00TatbPGK4MgdPp0vV1mc+KFIRFZC4eAQ8yOE9zj4kQmTtQzM6tWRU05/YsZqzUkzGjGfWzH43geno/9sD+OY6ZRo0apAMy4oU7dm2++6bMNAdm1a9fk5MmTqp5dwqwwBI0JYRsyxU6cOKH2RU+jcTzYsGGDtGzZUp588knVA4jnoVxKYseitGnbVp9vF+qhYJwf8xJbtw7shaFVEyzQrrJlE78wJCKbQBkY8k9sbCz67NTPtMDuWbKgP816t7AwvX1w+rSmDRigtzVdOv3mzzGNfXEcHA/HDYTMmTNr48eP99y/fv26Nnz4cC1nzpxaRESEli1bNq1///7apUuX1ON//fWXlitXLm3cuHGefaZMmaJlz55dO3TokPbwww9rGTNm1PLkyaMVK1ZM3aBhw4Za8+bNA/OPoFucPatpFStqWoYMofmbyJhR0ypV0tsRSBMm+P83Fugb2jVxIn85yb5iTfr+tjMGgBb5BUIgFKovtKRuaA/aBcuWaVpEhPltxPHy59e05cu1gAeAb731llapUiXtjz/+UPdPnDihVa1aVRs2bJjnOZ999pmWJUsWbefOndq+ffu0rFmzajNmzPA8XrJkSW3SpEme++fPn9cyZMigAsVr165pJ0+eVIEmBdapU3gvgv83g/PhvDh/oNnlwpDIjmIZAGocArYITCTPk8e8ArBmTXAfPFgf6sLQGybfJxg1TTMcLzpapE0bke7dRWJjJSCwegXm5GGFjEyZMsnRo0fVOrVYN3fhwoWe53Xo0EGtoIGVLHBr3bq1WjM3KcePH1dDyTgeEkwqVaqkVsbo27evWoGDAgP1utev1+eXBms4GOdBPUycN2G98EBwW+YzEQUXk0AswooT3MeO1QMzY2H6QGVeGsedP1+fL7hmjflfsJiXd/r0aXnrrbfUerfeEmbsYh1dI1sYyR3JMTKKZ82aJT///LOUKFFC9u7dK/fff79KQMG8RAoM/I6sWycycKDInDn6RUsgfkeN43bpIjJunEh4uASNmzKfiSi4LNLfRFab4P744yJvvKEHf2b3+iUF58H56tbVS/CZKcONF3XatGk+SSG4IWDztmTJErl06ZJKCvn111+TPW6hQoUkffr00r17dxX8Qfny5VVP4qpVq8z9R9AtEIzNni2ybJkemJj9t4Pj5csnsnw5gvzgBn/eF4ZWCP4CnflMRMHFANBiJkwI7rBWQqjdh+y+3btFkOQarODPgPPhvE2amDscXLBgQbn77rtl0aJFiZzz5j8Smbv9+/eXsWPHyquvvio9e/aUKKwRfAMyi5EJbEBWMTJ+kSXs7ezZs0nWCiTzoad6/36Rvn319bXRMetvBq2xL46D4+3bF7hsX7tdGAYy85mIgizUEzHtLFCTSEM9wf3xx0OfkILzd+tmbhLIV199pbJ4hw4dqv3+++/aL7/8or3xxhtanz591ONI4qhfv77WunVrz/06depobdu29RwDmcDt2rXT9u/fr/35559q23ff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", + "text/plain": [ + "
" + ] + }, + "metadata": {}, + "output_type": "display_data" + } + ], + "source": [ + "np.random.seed(1)\n", + "x, y = np.random.random((2,15))\n", + "fig, ax = plt.subplots()\n", + "scatter = ax.scatter(x, y, s=900, c='b')\n", + "text_list = [f'Text{i}' for i in range(len(x))]\n", + "ta.allocate(ax,x,y,\n", + " text_list,\n", + " scatter_plot=scatter,\n", + " linecolor='r',\n", + " linewidth=3,\n", + " linezorder=5)\n", + "plt.show()\n" + ] + }, { "attachments": {}, "cell_type": "markdown", @@ -525,7 +596,7 @@ "name": "stderr", "output_type": "stream", "text": [ - "100%|██████████| 1949/1949 [00:01<00:00, 1541.75it/s]\n" + "100%|\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588| 1949/1949 [00:01<00:00, 1541.75it/s]\n" ] }, { diff --git a/images/linezorder_after.png b/images/linezorder_after.png new file mode 100644 index 0000000000000000000000000000000000000000..bc643e938a123d3e8b6a826141ff3ff719823628 GIT binary patch literal 30735 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 RoXv})d`n#+=Y~nZ{{uw_vFiW; literal 0 HcmV?d00001 diff --git a/images/linezorder_before.png b/images/linezorder_before.png new file mode 100644 index 0000000000000000000000000000000000000000..d492fb9207dbe512e90e1ece2af7aa05ca2308ba GIT binary patch literal 30849 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 literal 0 HcmV?d00001 diff --git a/src/textalloc/__init__.py b/src/textalloc/__init__.py index d9fe1d9..31a4795 100644 --- a/src/textalloc/__init__.py +++ b/src/textalloc/__init__.py @@ -70,6 +70,7 @@ def allocate( draw_all: bool = True, nbr_candidates: int = 200, linewidth: float = 1, + linezorder: float = None, textcolor: Union[str, List[str]] = "k", direction: Union[str, List[str]] = None, priority_strategy: Union[int, str, Callable[[float, float], float]] = None, @@ -114,6 +115,7 @@ def allocate( draw_all (bool, optional): Draws all texts after allocating as many as possible despit overlap. Defaults to True. nbr_candidates (int, optional): Sets the number of candidates used. Defaults to 200. linewidth (float, optional): width of line. Defaults to 1. + linezorder (float, optional): zorder of the lines between points and text-boxes. Defaults to None, which resolves to a value below the point's zorder so the point visually caps the line. textcolor (Union[str, List[str]], optional): color code of the text. Defaults to "k". direction (Union[str, List[str]], optional): set preferred directions of the boxes (south, north, east, west, northeast, northwest, southeast, southwest). Defaults to None. priority_strategy (Union[int, str, Callable[[float, float], float]], optional): Set priority strategy for greedy text allocation @@ -123,7 +125,7 @@ def allocate( auto_ha (bool, optional): If True, horizontally aligns text dependent on location relative to it's x and y coordinate. Defaults to True. xlims (Tuple[float, float], optional): x-axis limits of the plot. Defaults to ax.get_xlim(). ylims (Tuple[float, float], optional): y-axis limits of the plot. Defaults to ax.get_ylim(). - plot_kwargs (dict, optional): kwargs for the plt.plot of the lines if draw_lines is True. + plot_kwargs (dict, optional): kwargs for the plt.plot of the lines if draw_lines is True. Can override linewidth, color, and zorder. **kwargs (): kwargs for the plt.text() call. Returns: @@ -280,6 +282,12 @@ def allocate( scatter_plot_bbs = get_scatter_bbs(scatter_plot, ax) scatter_plot_bbs[:, 2] = scatter_plot_bbs[:, 0] + scatter_plot_bbs[:, 2] scatter_plot_bbs[:, 3] = scatter_plot_bbs[:, 1] + scatter_plot_bbs[:, 3] + if linezorder is None: + # Below matplotlib's default zorder for scatter/patch collections (1), so the + # point marker is drawn on top of and visually caps the line where it meets it. + linezorder = 0.9 + if scatter_plot is not None: + linezorder = min(linezorder, scatter_plot.get_zorder() - 0.1) # Process extracted textboxes if verbose: @@ -361,27 +369,15 @@ def allocate( line_objects.append(None) else: x_, y_, z_ = line + line_kwargs = dict( + linewidth=linewidth, c=linecolor[ind], zorder=linezorder + ) + if plot_kwargs is not None: + line_kwargs.update(plot_kwargs) if z_ is not None: - line_objects.append( - ax.plot( - x_, - y_, - z_, - linewidth=linewidth, - c=linecolor[ind], - **(plot_kwargs if plot_kwargs is not None else {}), - )[0] - ) + line_objects.append(ax.plot(x_, y_, z_, **line_kwargs)[0]) else: - line_objects.append( - ax.plot( - x_, - y_, - linewidth=linewidth, - c=linecolor[ind], - **(plot_kwargs if plot_kwargs is not None else {}), - )[0] - ) + line_objects.append(ax.plot(x_, y_, **line_kwargs)[0]) # Get texts result_text_xyz: List[Optional[Tuple[float, float]]] = [None] * len(text_list) From a5c469207d4f0e3113a6adcd8e91ff6644d888be Mon Sep 17 00:00:00 2001 From: Claire Duvallet Date: Fri, 24 Jul 2026 13:11:22 -0400 Subject: [PATCH 2/2] Simplify line zorder default, drop new param per maintainer feedback MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Fold the below-point zorder default directly into line_kwargs instead of exposing a separate linezorder parameter — plot_kwargs remains the one escape hatch for overriding it. Also reverts demo.ipynb and drops the added images per review feedback. --- demo.ipynb | 73 +---------------------------------- images/linezorder_after.png | Bin 30735 -> 0 bytes images/linezorder_before.png | Bin 30849 -> 0 bytes src/textalloc/__init__.py | 18 ++++----- 4 files changed, 9 insertions(+), 82 deletions(-) delete mode 100644 images/linezorder_after.png delete mode 100644 images/linezorder_before.png diff --git a/demo.ipynb b/demo.ipynb index 5da0e7a..7c0e4e2 100644 --- a/demo.ipynb +++ b/demo.ipynb @@ -79,77 +79,6 @@ "plt.show()" ] }, - { - "attachments": {}, - "cell_type": "markdown", - "metadata": {}, - "source": [ - "### Connector line below point:\n", - "\n", - "By default, the connector line's `zorder` is set below the scatter point's own zorder, so the point marker is drawn on top of and visually caps the line where it meets the point (instead of the line color showing through the marker). Pass `linezorder` explicitly to override this." - ] - }, - { - "cell_type": "code", - "execution_count": 43, - "metadata": {}, - "outputs": [ - { - "data": { - "image/png": "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Ntvsn5lZ6/Gzzz7Df/7znxQDwEmTJmHq1KnYtWsXnnnmmYgPALmIvZODP2L72E4REckcBYASMrfffrv3//ny5TM/W7VqhTJlyni3L126FJ988gmOHz9uegQfffRR5M6d2xvArVixwgSNUVxxHcCnn36K+fPn480338Tjjz/u7WmMiYlBnTp1MHDgQLNt69ateP755zF+/HhzTPEsu+YGmzeHugUiIu6nOYDiWCNHjkT79u1RrFgxNGnSxAR7tWrVwokTJ8zt7dq1wxdffIEXX3zRXN+5cye6d++Ohg0bmoCydevW3p7GDh06oHHjxub6mTNnzPXXX389SbAZyZhgwTIrbsAyNU5NVBERcQv1AIoj7du3D88++yyWL19ueu6oa9euqF27NsaOHWuGbDmsyyHcFi1a4NZbbzU9evz58MMPm/tzu93TWKJECe+++diKFSuic+fO2LJlS4h+Q2dJTIRrMPhjezkfUEREMkYBoDjSt99+i8TERLz11lvmumVZ5nLkyBEzX9DGnsGnnnrKDOMWKlQICxYsSHO/c+fOxbx587B+/fqA/w5ucmEE3RWyZHFXe0VEnEgfo+JIx44dM/P27r333iTbOSTs25tHNWvWREJCgukdZBCYlrfffht58uRBz549zXXOLaTnnnvODBk//fTTiEQMqqKj3TEMnCOHp70iIpJxCgDFkUqWLIm///4b9erVM/9P0fnz+HPjRjzWuzf69eyJcdOnY/LEiXjwoYfMzVlSiBKYaXzo0KEkpWK+/vprNG/e3MwdjGSVKgHr1sHxKlcOdQtERNxPAaA4EgMyBn5PPvkkpk+fjhzs9gHw008/maHhG264AecPHkTXGjVQF8CIceNQCUC//v3R+OabUbZsWW9v4MGDB729hrfcckuS49hzADmUfOONNyKS1asH/PKLs0vBcN4f2ykiIpmjLGBxpOjoaFPOhfP9GMxxjl+VKlWSlIF56733sIHlYNjbB6A3A7yGDdGlSxecO3cOBQsWNIkgd999t7m89tprof61HK12bWcHf8T2sZ0iIpI56gEUR6hWrRpmzZqFIkWKeLdVr17drNLBXr/9+/fj2muvNdm79tBupfLl8S2Aq332M3HECHy3caNJFmEh6S+//BKrV6/G3r17k+zbVrx4cXPc8uXLI9LVZVeqC7ilnSIiTpbFYmqlZHilibx58yIu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", - "text/plain": [ - "
" - ] - }, - "metadata": {}, - "output_type": "display_data" - } - ], - "source": [ - "np.random.seed(1)\n", - "x, y = np.random.random((2,15))\n", - "fig, ax = plt.subplots()\n", - "scatter = ax.scatter(x, y, s=900, c='b')\n", - "text_list = [f'Text{i}' for i in range(len(x))]\n", - "ta.allocate(ax,x,y,\n", - " text_list,\n", - " scatter_plot=scatter,\n", - " linecolor='r',\n", - " linewidth=3)\n", - "plt.show()\n" - ] - }, - { - "cell_type": "code", - "execution_count": 44, - "metadata": {}, - "outputs": [ - { - "data": { - "image/png": "iVBORw0KGgoAAAANSUhEUgAAAoAAAAHgCAYAAAA10dzkAAAAOnRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjExLjEsIGh0dHBzOi8vbWF0cGxvdGxpYi5vcmcvctoD+AAAAAlwSFlzAAAPYQAAD2EBqD+naQAAd+1JREFUeJzt3Qd4FFXXB/BDE0ILLYAUQTpILyJN6Ui100FAUKk2fBEFVBTBgn5SBHzpVUVBmqCCvgqCgEjvoCjSUoAEpJP5nv8dZtkNSUg2s7tT/r/nWePO7sxcdpPdM/fec246TdM0ISIiIiLXSB/qBhARERFRcDEAJCIiInIZBoBERERELsMAkIiIiMhlGAASERERuQwDQCIiIiKXYQBIRERE5DIMAImIiIhchgEgERERkcswACQiIiJyGQaARERERC7DAJCIiIjIZRgAEhEREbkMA0AiIiIil2EASEREROQyDACJiIiIXIYBIBEREZHLMAAkIiIichkGgEREREQuwwCQiIiIyGUYABIRERG5DANAIiIiIpdhAEhERETkMgwAiYiIiFyGASARERGRyzAAJCIiInIZBoBERERELsMAkIiIiMhlGAASERERuQwDQCIiIiKXYQBIRERE5DIMAImIiIhchgEgERERkcswACQiIiJyGQaARERERC7DAJCIiIjIZRgAEhEREbkMA0AiIiIil2EASEREROQyDACJiIiIXIYBIBEREZHLMAAkIiIichkGgEREREQuwwCQiIiIyGUYABIRERG5DANAIiIiIpdhAEhERETkMgwAiYiIiFyGASARERGRyzAAJCIiInIZBoBERERELsMAkIiIiMhlGAASERERuQwDQCIiIiKXYQBIRERE5DIMAImIiIhcJmOoG2Bn8fHxcvz4ccmRI4ekS5cu1M0hIiKiFNA0Tc6dOyeFChWS9Ond2RfGADANEPwVLVrUvHeDiIiIgubo0aNSpEgRV77iDADTAD1/xi9Qzpw5zXpPKABWrRLp10/kzBn03Jp3XFw45skj8sknIi1amHdcIiIKnLi4ONWBY3yPu5HjAsDr16+r4dhgdOkaw74I/hgAWlNsrMiAASJz5+rBmpnBH+B4p0+LtG8v0q2byPjxIuHh5p6DiIgCI52Lp2+ld8pcvBUrVkibNm3kjjvukO7du6dovy1btkidOnXUPgUKFJDhw4er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fv26Nnz4cC1nzpxaRESEli1bNq1///7apUuX1ON//fWXlitXLm3cuHGefaZMmaJlz55dO3TokPbwww9rGTNm1PLkyaMVK1ZM3aBhw4Za8+bNA/OPoFucPatpFStqWoYMofmbyJhR0ypV0tsRSBMm+P83Fugb2jVxIn85yb5iTfr+tjMGgBb5BUIgFKovtKRuaA/aBcuWaVpEhPltxPHy59e05cu1gAeAb731llapUiXtjz/+UPdPnDihVa1aVRs2bJjnOZ999pmWJUsWbefOndq+ffu0rFmzajNmzPA8XrJkSW3SpEme++fPn9cyZMigAsVr165pJ0+eVIEmBdapU3gvgv83g/PhvDh/oNnlwpDIjmIZAGocArYITCTPk8e8ArBmTXAfPFgf6sLQGybfJxg1TTMcLzpapE0bke7dRWJjJSCwegXm5GGFjEyZMsnRo0fVOrVYN3fhwoWe53Xo0EGtoIGVLHBr3bq1WjM3KcePH1dDyTgeEkwqVaqkVsbo27evWoGDAgP1utev1+eXBms4GOdBPUycN2G98EBwW+YzEQUXk0AswooT3MeO1QMzY2H6QGVeGsedP1+fL7hmjflfsJiXd/r0aXnrrbfUerfeEmbsYh1dI1sYyR3JMTKKZ82aJT///LOUKFFC9u7dK/fff79KQMG8RAoM/I6sWycycKDInDn6RUsgfkeN43bpIjJunEh4uASNmzKfiSi4LNLfRFab4P744yJvvKEHf2b3+iUF58H56tbVS/CZKcONF3XatGk+SSG4IWDztmTJErl06ZJKCvn111+TPW6hQoUkffr00r17dxX8Qfny5VVP4qpVq8z9R9AtEIzNni2ybJkemJj9t4Pj5csnsnw5gvzgBn/eF4ZWCP4CnflMRMHFANBiJkwI7rBWQqjdh+y+3btFkOQarODPgPPhvE2amDscXLBgQbn77rtl0aJFiZzz5j8Smbv9+/eXsWPHyquvvio9e/aUKKwRfAMyi5EJbEBWMTJ+kSXs7ezZs0nWCiTzoad6/36Rvn319bXRMetvBq2xL46D4+3bF7hsX7tdGAYy85mIgizUEzHtLFCTSEM9wf3xx0OfkILzd+tmbhLIV199pbJ4hw4dqv3+++/aL7/8or3xxhtanz591ONI4qhfv77WunVrz/06depobdu29RwDmcDt2rXT9u/fr/35559q23fffacyhWfOnKnt3r1bmzx5spYpUyZtwYIFafsHkF/w54gM1TJlbv4+ZcqU/O+b9+Nly+r7WynJwS2Zz0TBEsskEGYBW/UXCEFgMD/wcR58wM+eHdrAL+EN2cf+KlOmjDZr1iyfbT/99JMK4sqWLauCvTfffFOLi4tTj02bNk2rWLGidsorxfPw4cPqOIsXL1b39+7dqwJCbDPKwMDKlSu1Jk2aqOO2aNFC+/rrr/1vOJkiPl7Ttm/XtKlTNa1vX02rXv1mCSP8bhmliLAdj+N5eD72syI3ZD4TBUssA0AtHV6IYPc6OgXmiIWHh6vhPywPZjaMKgZrgjsycDGxG5X9rTThHPOvMATHOUdkllAtVWgGzI3F9Ihgzc01Mp9Xrw5O5jORU76/7YBzAC0s2BPcP/hA5PRpawR/gHYgGB0xItQtISdB0Jcpk/2CP+/M586d9fuBKhtlHBeZz2vXMvgjciIGgDYQjAnuWJZt6tTgJ33cDtqDLEizl40jsiunZz4TUXAwALQJDIGOHy9y8qSeKVy69M3H0JuRHO/Hsb4o9sdxcDxjaBXDzFatW4z1hOfODXUriKzFyZnPRBR4nANo0zkEmMe0c6fI5s0iW7aIbNwosmePHsThMXyYZ86sz9+pXVukRg19fh8Wb0/4JYHnlysncvCg/v9Wg/YicMW8JzsO2xEFGnrIcZH08cciBw7cvPC7ejXpfbwfR+mnQYP0cjMunQ5FLhPHOYAMAJ32C+TPBPft20WqVhXLQzsrVw51K4isy8wLQyIni7Pg93ewOWopOCz1tXPnTrUEF9ZkTYl//vlH/vjjD/ULgBUcUOjXCRPcUwNfFnaAdjIAJEr+7x9/I7hhvV4nZD4TUWA4Zg7glClTpEiRIvLiiy9K48aNpW7duiogTMqVK1fkiSeeUEHfsGHD1P9jpYgffvhB3AY9BakNGoMN7UM7ichdmc9EFBiOCAB3794t/fr1k+nTp8uWLVtUjx66dV966aUk95k1a5YsX75c9Rj+/PPPcvDgQWnWrJk8/fTT4jYYJkpurlBKpZN4ySdRPjdsMwPah3YSERFR2jkiAJwzZ47cdddd0rFjR3Ufa7BiPdfPPvtMLiGFNBEIEDH+X6xYMc+2KlWq3LKmqxsgucIMeSVGoiS/zw3bzIK5TERERJR2jpgDuG3bNqmaIIuhWrVqKvg7cOCAVE5k4ljPnj1VgNijRw95+OGH5cSJE/Lxxx/LRx99lOR5Ll++rG7ek0jtDnODkoiRLcd7IjsRERG5PAA8e/asFC5c2GdbXlRIFZEzZ84kug8SRTp06CDvv/++HD58WE6ePCmlSpWS++67L8nzjB49Wt58801xEkwMtwtjIrvV5ysSERFZnSMCwDvuuEMuXrzos+3ChQuexxKDnj4EdL///rsUL15csCTywIEDpWnTprJ///5Es4GHDh2qkky8ewCLFi0qdoasQLtAz5+d2kvmiI+Pl+PHjyf7HEz7wJQOf+HzAtM/7rzzzkQfj4mJkaxZs0oYKiUTETmAI+YAIoA7evToLeVdjMcS891336lsYePxdOnSqeHgv/76S/ahDH4iEBSiXIz3ze4QVGXJIraAmJzDv+6D4As988btnnvuUXN3vbeNx7I2abBo0SI1bSSh9evXS9myZdUcYwSYXbp0ueVik4jIjhwRAD744IPy66+/qmFcw1dffaXm/hlX9Li6X7VqlSfJo2DBgvLnn3/6HAdDwcZjblK+vNgCiteS+0RERKgLOuOGnvjcuXP7bEMpJzh//ry6JYQexIRzds+dOyfHjh1T83oxVQQ9jcbx8FyUkWrTpo26YZrJoUOHZMOGDfLCCy8E7d9ORBQojggA27dvL9WrV5fWrVvL3LlzZciQISoz+N133/U8Z+/evdKyZUv1EwYNGiS7du2Srl27qmBx3LhxahvuFyhQQNwEKwJYfV4d2od2EiVVCqpevXoqWCxUqJAqBI/eOwM+C9DDh6DPGPKtVauWjBw5UgV1r7/+uk9P49SpU2X+/PmqXujbb78tmTJlUr2AL7/8siohlViQSURkJ44IADNmzChr1qyRRx55RL788kuJiopStf3QM2jIlSuXtGjRQv0EBIwIANFDOG/ePNm6datKCJk5c6a4DZaDMqMOYCChfWgnUULovWvSpInK5kdght67Z555Rtq1ayfR0dHqOe+9955ky5ZNBgwYoO4///zznrnADRs2VBeA3j2NmOu7adMmFTR6z/tr0KCBqi6A+qFERHbmmCn12bNn9wwDJaZcuXJqCNhb6dKlVdDndlgL1A7s0k4KLvT2Yz5ut27dJDIyUiV0PfroozJmzBh1YYhsf8zfRY8eev1wwYiRAvQQIrEjKbiQzJcvn8824z4eIyKyM8cEgOQ/lEksU0bk4EG91IrVIPED7Uvh8s7kMuiNQxJYzZo1b3nMeznIihUryquvviojRoyQN954Q2rcpks5ffr0ci1BnaSrN7rKM2TIYFr7iYhCwRFDwJT2AGvQIGu/imgfM4ApMQjGsIqPd1KIcevbt6/neUj2wBQRDAWjZxBJH8nB2uLeiWVw6tQp9TNh3VEiIrthAEhKt256mRUrQpmarl1D3QqyKiRtYDUglHBKyBPkxcfL2889J5nOnpXtq1dL5O7dMuaddzzPwxBxwt6++++/X80NNuYRAqaRoIg8StEQEdkZA0BSUNKwd2/0pljrBUF7nnpKbx9RYjp16qSGd1GuZeXKlaqQ+5IlSzxF3eF/X30lb02ZIr/9/beUrFNH9p0+LRPefFN+++03z3xgDBd///33njIwTzzxhJQpU0bV/kPBePQeIpsYZWiQFUxEZGcMAMlj5EgskYe5T9Z4UdAOrOiHdhEZkPCBUi/evXc//vijyvp97bXX1E+UakFSWPny5eXff/9Vq/4k1KtXL1UyCvP6sJb4W2+9pcq81KlTR5WBwSpCq1evVmWhkEiCY4waNUoGDx7MN4OIbC+dhpQ58gt6CbA6AIpLO2FVEFi2TKRdO//2zSdREiX5fbZFSKRES4Tf7Vm+XKR1a793J9Ihaze/7++mREaiyjRfISIXinPg93dqWaSvh6yibVt9vl2oh4JxfsxLZPBHRERkPgaAdIsJE/Tl4UIVBGbMqC/7lsblXYmIiCgJDADpFuHhImvWiBQvHvwgEOcrVkxk9Wq9HURERGQ+BoCUKEyXwlKqwewJxHnQ84fzJpyuRUREROZhAEhJQhC2bp1I5843flkC9NtiHLdLF5G1axn8UeogjQ0LdDCdjYgo5bgUHCULw7CzZ4u0b4+yGVhaS+T6dXN7/VDqZfp0JnxQ8hDg7dghsnmzyJYtIhs3iuzdK3Lpkm/RcPRa164tgpXesH40ljpMxxeXiMgHA0BKkTZtRFBTd8QIkWnTbn7p+tPrYizphi9rFHlGnb/cuflGUOLi4kTmzBEZN07kwAF9G+ow31iW1wd+L7duFdm1S2TyZH0b1pH+T0+Rp/gCExF5cAiYUgxBGjJzsTwqMoVLl7752O0WRvB+HF/I2B/HwfEY/FFizpwRGThQpEAB/efBgzcfSyz48+b9OPYbOpSvMRGRN/YAUqqhZma/fiJ9+4rs3HlzSG7/OhHZ6fvcLJlFqt/jOyRXqdLNXkCipAqAmzXlAL3UrHZPROSLASD5DUEc5lfhhqFciULmiO9zjh5Vy4EQpUhsrMiAASJz5+rJQfHxgXvh+vcXeee/LDdERO7EIWAisoRTp0Tq1xdZsEC/H8jgD776Sj8fVoQjInIbBoBEZIngr149PavXzCzz5FyP189Xty6DQCJyHwaARBTyYd+mTUWOHAle8GfA+XDeJk30dhARuQUDQCIKKcz5C2bPX0I47549eiFyFpMmIrdgAEhEIbNsmZ7wEargz4D5hitWiBQpIjJxol57kIjIyRgAElHI6vwhezxQSwz64/hxvUfSqD2INhIROZGFPnqJyE2wqgzq/AU629cfWFFk0iSRcuX0nkEiIqdhAEhEQYch1qlTQz/0mxy0LTpaXwaxe3cmiRCRszAAJKKgw9q+ly9b/4U3eifnz2fNQCJyFgaARBRUyLQdN85eLzp6A1kzkIichAEgEQXVjh0iBw7Yr+QKawYSkZMwACSioNq82b4vuNETiAxhIiI7YwBIREG1ZYtIpkz2DgIxh3H58lC3hIjIfxnTsC8RUapt3Chy9WraX7h0Ei95JcZnW4zkFS0I17WoXYgahvv2ieTOHfDTERGZjj2AZJ68eUUiI31v2EbkBUOopvy6SYxESX6fW8KAMJDZwTExei1DIiI7Yg8geVy5ckXik6nKmz59ernjjjuS7xaJiEj2Fb106ZJkzpxZ0qVL59l2+fJl0RJkBGTMmFHdyFnwNqPIshNgKHjaNJFRo0Ry5gx1a4iIUoc9gORRp04dyZUrl7qFh4dLWFiY+mlsa9CgQZperZMnT6pj7t6922d72bJlJUeOHJ7z4DZ8+HC+Mw507Zo4CoJZrGVMRGQ3DADJY8uWLaqHDrdffvlFbdu4caNnG/7fkFhP4dWrV1Uvojf07GFfPB89fYDnYJv3cydNmuQ5D26jR4/mO+NATuzURU1Du5W0ISJiAGiya9euJXtLONSZWtj/eojWz0Jg9sILL0i+fPkkS5YsUqFCBfnyyy89j3/xxReq927Pnj2ebc8//7zcc889EhcXp3r6vHsaW7Zs6XP85IafyRkw8p8lizgG/pz37xfZuTPULSEiSh0GgCb3oCEwMm6YL5cpUyafbePHj0/TOd59912pXbu2z7a///5bBgwYIMWKFVNDrNWqVVPBmNl69Oihhm83bdokFy5ckA8++ECefPJJWb9+vXq8S5cu8sgjj0jnzp1Vb9/KlSvlk08+kblz56qA78iRIz49jWvWrPEJFPFaFS1aVAWZ586dM739ZA3ly4vj2Lm2IRG5EwNAE9WoUcOnt69fv35SpUoVn22DBg1K9hiJ9RKiZwy9fthu9JJ59yh+/PHHqpdt7dq1cvr0aenbt6906tRJBWBmOXTokHz++ecyefJkueuuu9R5mzZtKo8++qjMnj3bZyg3NjZWtaFnz54ybNgw1eOXHASNv/76qwoKP/vsM1m6dKl0797dtLaTteD6xc51ABPCvwW1DYmI7MSBM3KsDcOjL774ovz000+qt+6BBx5QAZwRVD344IMqQ/a7775TPzF0iiASQVLFihVVcgSCQPQmwqeffipjx471OcfTTz8ts2bNUsOzCYdZ/fX777+rnxj2TahZs2ae/8+ZM6fMmDFDGjVqJPfee68KAG/no48+8vx/vXr15P/+7/+kXbt2qsewePHiprSfrKNGDZHJk8UxUNPQa3osEZEtsAcwiE6cOKECvsaNG8upU6fk8OHDEhERIW3btlW9eQj40JuGYMsI6tCThqAKSRG9evWSUaNG+fQ0YltCCCQjIyPVsKuZUAYGPYzeyRq4LVu2zOd53377rRrOxdD0mTNnUn0e9GYCXh9ynlq1xHG8pr0SEdkCA8AgwvAoevH+85//qLInKLGC3q59+/bJb7/9pp5TqFAhmTp1qrz22mvyyiuvyKJFi2T+/Pmqdl5K4ZgIvjAEaxYEneh5XLVqVbLP+/nnn9XcwBUrVqhezd69e3seQ1AIt0ti2bp1q/pZpEgRU9pO1lK5skiZMnpCiFMgwZ2ZwERkJwwAgwjJDxj6RYFjBENIEkHvHgKiv/76y/M8DPd27NhRJXzgZvSIpcTixYtlyJAhnmDTLCVLllQBZf/+/WXJkiUSHR0tO3fuVEPS//3vf9Vzzp49K926dVND3BgWnjdvnkr0MB7PkyeP+vfiNUASCcrAfPPNNzJ48GDZsWOHxMTEqMDxueeekzZt2niyhslZEPjdZiqs7SD4c1qNQyJyNgaAQYSh2Q4dOiRaHgbbDQiOUHMPgaJ3SZXbQfIEAsdx48YlOjSc2uFe9DripwGBHIKzoUOHqoCwa9eukjVrVpX9C8jeLVCggLz11lvqfqlSpVRb8Pw//vhDDXEjK3jixImSP39+NT+xefPmUqJECRVclilTRvV8Inlm4cKFaWo/WVu3biKp6NS2RVDrxBqHRORgGvktNjYW6brqZ2L69++vValSxXP/tdde0+68807t33//Tfqg169rL3brptUpVUr75euvtTszZtSWLF7sefiDDz7QqlatestuS5cu1TJnzqxNnDiR7yjZwoABmpYhA/rO/Lvlk8hbNmJbYs9NJ9fVY943bPP33AlvWbKE+tUkIjO/v92APYBBhFp9GO5FiZa9e/eqIVPMmcNwJ0qnwMq5c2XsnDmy/tAhqfvww3L82jUZ0ru3ShoBZMX++eefasjYKAODci9PPPGEvPfeeyoD2OhVZGFlsrKRIzEtQF9COtA0SS/REuFzwzazJJIcT0RkaQwAAyhDhgxqGNdQsGBB2bBhgyr/cv/996uhzzfeeEMNeSIhBEHeyy+/fMtxMBeuT58+6v9RHqVVq1ZSs2ZNdRyUXEHSBwI+zL3zLjptVgkYokDInVtk2jTUubT364vcpgS12YmILC8dugFD3Qi7Qo0+BG7ovUNygymiokTy5/fdFhkpEhFhzvGJLDgfcMECZIenbr98EiVR4vu3EiGRqncv2KZOFXnqqaCflois9P1tM+wBJKKQmjBBXx4uQwb7vhFOrG1IRM7GAJCIQio8XATLQmPRF7sFgcj+RbWiSpVC3RIiotRhAEhEIYdZD+vX27MnEDUNnVTUmojcgQEgEVkmCFy3TqRzZ/1+MLKD0wpLcnftGupWEBGlng0+YonITcPBs2eLYHnpvHmt3RuItiHxw6Xzx4nI5hgAEpHltGkjsn+/SN++ImFh1htiRe8kAlTUMiQisiMGgERk2TqB48eLnDypZwoXKiSWgdqF06frbSQisiMGgERkaRhi7ddP5J9/RFq3Dn1vIIZ+UbsQbSEisisGgERkCwj85s0Tueee0M0NxMI+WPYNPZNERHbGAJCI7FkzMMifXgg6ixUTWb1abwcRkZ0xACQiW9YMLFMmuMEfev5w3oQrNRIR2REDQCKyHQRhy5cH/jxGLcIuXUTWrmXwR0TOkTHUDSAi8keg6++h1w+lXpDty4QPInIaBoAhpmkiO3aIbN4ssmWLyP51Ij8keE7RoiIRFURq1xapUUNfeL5y5dBnQxJZTVgWkXSXb/5tpZbxN4UVPlDkGXX+WOqFiJzIUQHgihUr5LfffpM8efLIE088IQULFrztPpGRkbJ48WKJioqSBx54QBo0aBCUtsbFicyZIzJunMiBA/q2TJlEwq/e+txLl0W2bhXZtUtk8mR9G+Y/YQ1SlKPgSgREut27ReasEvn4Y9+/q6uJ/F0ZvB83/q6wvBv/rojIyRwzB7Br167Su3dviYuLU4FghQoVZOfOncnu8+2330rp0qXV869fvy5vv/22vPPOOwFt55kzIgMHihQooP88ePDmY8l9SSV8HPt5HwfHJXK7HDn0moH79ols3y4ydapI794i1avrvXpGDx9+4j6243E8D8/fu1ffn8EfETldOk3zZ6DEWr777jtp0aKFbN++XSpXriz4J7Vs2VKuXr0qa1AzIomevzJlysigQYNkpNd6Tvv27ZNy5cql6LwINsPDwyU2NlZypuAbA5PWe/USOX1a5Pr1xJ+TT6IkSnzTDCMkUqIlIsnjcq4SuVJU1K1ZGZGRIhFJ/63g0+7aNb2eH6dQELlXXCq/v53IET2AixYtkmrVqqngD9KlSyc9evSQH3/8Uc4k0TU2Z84cFSC+8sorPttTGvylRmysPlTbtq1ITEzSwZ+/cLzoaH391O7d9fMR0a0Q9GHIl8EfEbmdI+YAHjhwQEqVKuWzDffRE3jo0CGphayJBDZt2iQ1atSQkydPysKFCyVDhgxSr149qVOnTpLnuXz5srp5X0HczqlTIk2b6kNLxhqigWAcd/58fb4gOj5Zr4yIiIgc2wP477//3tKFi65d47HEoNv3xIkTaqj49OnTcuTIEWnWrJkMGTIkyfOMHj1aHde4FUV67m2Cv3r19ODP7F6/pOA8OF/duvpoGBEREZEjewCzZ8+uAjpvZ8+e9TyW1D7oHUTvIRJBAFnA7du3l759+0pxrDWVwNChQ+XFF1/06QFMKghEc9Dzd+RI8II/A86H8zZpIrJuHZetIiIiIgf2AJYvX17279/vsw33MayLRI/EIEs4d+7cnuAPaqPQnogcPnw40X0yZ86sehq9b0kZMCC4PX9J9QQiQ5iIiIjIcQHg448/rkq+bNy4Ud2Pj4+XadOmSfPmzT1B2tGjR1XCB34CevrQa7gDVZhv+N///qeCRgSUabFsmcjcuaEL/gw4P2oNBmPJLCIiIrIPRwwBN2zYUPr16yetWrWSRx55RPbs2SN//vmn/PTTT57nHDt2TN599115+OGH1bBtxYoV5c0335RGjRqpABJzBZFN/P7770uhQoX8bguSjrGCANYQDVTCR2qgHWgP6qJxRQNyFKzTlnCiK7YREZE76gAa1q1b51kJpF27dpIrVy7PY8ePH5fZs2dL9+7dfQI81A78+eefJVu2bGoVEO8hYX/qCGHIddIk/3v//KkDeDuoE9i3r8j48X4fgsh0KNEUg7pIyShWrJhkQt0WP+HCLywsTH0mJHTx4kV1/gIFCqTpHERkP3GsA+isADDUv0CoCoOVOS5d8v+YgQgAISxM5ORJrnBA1vHJJ5/Ihx9+6Ln/999/qwuxvF69eCjyXqJEiTSNDtSvX1+t8mNA9j/qhGKEIF++fBIdHS2dOnWSyZMnq3m+ROR8cQwAnTEH0Cow386rTKClICjFvEQiq8C0DWTiG7e77rpLnnnmGZ9tCP6wTOM///zjU4MTzp8/r56Dgu7eUNIJa3ujxid6+dDTaBwPxxo4cKBaCQiBII6LecBLly5V0z+IiNyCAaBJ0I86bpxYGtrH/l6yE/QQ5s+fXxVzxzBuhw4dPKv7IJhr2rSpKs9kWLZsmcr8/+uvv2TUqFEquFuwYIE8+OCD6obAEPOD77//flUFAPB8zAnGdiIit2AAaBIkEx84YN0AC+1CpZydO0PdEqKUmT59unz88cdqbi9663BD8Pf888+rxzH9Yu7cueo533//verx69Wrl0ruqlmzpowfP16VdvLuaSxYsKC88MILavWfr7/+Wnbv3q2GfvET9T+JiNzCEVnAVrB5s9imnTeWTCayfO8fkraQxIHeOUxX7tq1q/Tv319mzpyp1vzG/D70AD755JNStmxZueeee5JdzQeQ9Y91wlEKCnMAkQgycuRIFTQSEbkFA0CTbNmiLzKfYDqSpaB9aCfKwhBZGWp57t27Vy3TiCFcb8jaReKVkeU/YsQI9ZxffvlF9fKlR+2jZHTs2FH1FqIyAALAgwcPqiHhK1euyPDhwwP67yIisgoOAZsENaitHPwB2nejVjaRpaF3D0XZMZzrnRRi3LxLPKGAOxI/UMpl5cqVyR73woULKuFjwIABKvgDlH7q0qWLzJs3L+D/LiIiq2AAaBIsu2YHe/aEugVEKQsA69SpI1999dUtj127ds3z/+ghxPAvhoEx5w9rdXsvC4myLt7Px33cjEQS7+NgTiERkVtwCNikBIu01P4LJlTSQHvTpQt1S4iSN2bMGGncuLH07t1bJXcgKETR9l9//VUWL16sntOnTx8pUqSIGgbOmDGj6gFEb96GDRtUjyDmBaKHENnAWbNmlbvvvlvNK0RdQAwlY9lHHBPJJOOsnsZPRGQi9gCawKuDwfIQ/NmpveQeWPXDGJYF9ABu2rRJzc179tln5eWXX1bFW7HON3zzzTdq2UcM3SL4gylTpqifxnPQM1iyZEmVPGKUgUFPIdYFR/Zv586dZfny5TJr1ix1DiIit+BKICZUEj97FhPS9aXg0ipQK4EY0POHZerYA0hERG4Vx5VAOARsBgRTWbKYMwwcI3lVwJdwm1mw0hWDPyIiInfjHECTlC8vsnVr2o+jSXrTevsSU6FCwA5NRERENsE5gCapXVuvs2dlaB/aSURERO7GHkCT1KghMnmyWL4OINpJRESJQ5Hw3377LdmXB2tTI4vcXzt37lTJTTUS+UBGohKSn8qVK6cSmIgChQGgSWrVEluwSzuJiELh8OHDKkPcsHnzZlWCyHupQGSrpyUAnDhxokRHR8uXX37p2YblDocNG6bKFmF5wjfeeENlqxMFCgNAk2B93TJlRA4e1EutWA0SP9C+SpVC3RIiIuuqV6+eKg1kaNOmjSoz9PXXX/s8D0Ha9u3b1ao0WIMaBcbh4sWLsmbNGqlWrZoULlzY8/x169ZJlixZJEeOHPL333+rLFTjPPfdd5+cOHFCWrVqJdOnT2fPHwUF5wCaGGANGiSWhvYxA5iIKG1GjRqlgjT00vXs2VMVHEdPIYSFham6kg8//LBcvbE+KALCRo0aqeAQz9u9e7enpxG3Y8eOSd26dVURcyOQJAo09gCaqFs3kcGDrbkqCMrUdO0a6lYQEdnbokWLZMKECbJt2zYpXry42jZ69GhVVBzLEKZPn14+/fRTqVy5sgwfPlwVMMfqM0OGDJEGDRqoG3oDEw4BEwUbA0AT5cwp0ru3yKRJerFlq8iQQeSpp/T2ERGR//773/+qJJB9+/bJ3r17RdM0tRzhoUOH1Dw+9Azmzp1b5syZI82aNVO9fxgKRm8hkZUwADTZyJEin3+O+SEi8fEScunTi+TNq7eLiIjSBkO3GTJkUL2A3lq3bi2Xsdj6DQ0bNlRz+pYuXSobN270LFdIZBX8jTRZ7txYh1SkXTuxBASh06fr7SIiorTJnj27mq+XMABMaP369bJy5Uq5++675f3335eFCxfypSdLYRJIALRtq8+3w9BrKOH8mJfYunVo20FE5BQY1sXcPWTxesOcPiU+Xs7/+acM6tRJhvTqJd/OnSsrV6yQmTNnep6bLVs2n95ColBgD2CA4OJw2zaRvXtDMx8Qow1Ynm78+OCfm4jIqVCbb8WKFap0y8CBAyVnzpwqs/enn36SrVgPNCZGspcoIaqU9JQp6jbhvfdk0KBBcv/990uJEiVUiRgEhLNnz5Y8efKoYyF7+Mcff1TnuHTpkppjiDIx+fPnl3vvvTfU/2xyIAaAARIejtR/kbp1RY4cCW4QiJ6/YsVEVq/W20FERP5B8IU5fwYkeGBO34wZM2Tt2rVqbh+e884776jHkQlcNsExevToIduPH5cFCxbIa6+9Jp06dZIzZ87IqlWrVE9i0aJFJW/evJ4C1AgI0aOI+1gthAEgBUI6DSlM5Bf84YaHh0tsbKy6CkxMZKRIkybB6wnE51SFCnrwlz9/4M9HREReoqJu/fDFF0FEBF8mm31/Ox3nAAYYPgfWrRPp3PnGCx6gV9w4bpcuImvXMvgjIiKipDEADAIMw86eLbJsmV6SxezkEBwvXz4RrCo0axaHfYmIiCh5DACDqE0bzA8R6dsXywXpy7L5uzSbsS+Og+Pt28dsXyIiIkoZBoBBhnp8yMw9eVLPFC5d+uZjmTIlv6/342XK6PvjODge6/wRERFRSjELOEQw57RfP733budOEawjvmWLyMaNInv2iKBEFNJz0MuHtcGR2FG7tkiNGiK1aolUquR/7yERERG5GwPAEEMQV7myfsN6vQYEf9eu6fX8GOgRERGRmRgAWhSCvtsNCRMRERH5g3MAiYiIiFyGASARERGRyzAAJCIiInIZBoBERERELsMAkIiIiMhlGAASERERuQzLwBAREfkJNVt37LhZzH//OpEfEjynaFGRiATF/FH7lTVeKZQYABIREaVSXJzInDki48aJHDigb0Pt1vCrtz730mWRrVtFdu0SmTz55nKegwaJdOumrwxFFGwcAiYiIkqhM2dEBg4UKVBA/3nw4M3HriYS/Hnzfhz7eR8HxyUKJgaAREREKbB8uUjZsiKTJolcuqQP/+LmD2NfHAfHK1dOZMUKvg0UPAwAiYiIkhEbqw/Vtm0rEhMjcv26uS8XjhcdLdKmjUj37vr5iAKNASAREVESTp0SqV9fZMEC/X58fGBeKuO48+fr54uM5FtCgcUAkIiIKIngr149kb17ze/1SwrOg/PVrcsgkAKLASAREVECGIZt2lTkyJHgBX8GnA/nbdKEw8EUOAwAiYiIEhgwILg9f0n1BCJDmCgQGAASERF5WbZMZO7c0AV/BpwftQaRfUxkNgaAREREN6Ae31NPiaS3yLcj2oH2sE4gmc0iv+JEREShN2KEyOnTgcv2TS20A6Vn0C4iM6XTNH/LWFJcXJyEh4dLbGys5ORaPuQQV65ckfhkvv3Sp08vd9xxR5rOcenSJcmcObOku7EYKj6GLl++nOhzM2XKJBkyZEjT+YhSurwbVuZAcWZ/5ZMoiZL8PtsiJFKiJSJNb0JYmMjJk1w2zixx/P5mDyAR+WrWrJnkypVL3XCBExYWpn4a26pVq5aml+z8+fPqmBs3bvRs27lzp+f4xg0XVXjeokWL+BZRUGC+XRLXISGHoBTzEonMwiFgIvLx008/qR463LZv3662rVmzxrNt9+7dnucm1lN49epV1YvoDT182BfPN3r68Bxsw8/KlSt7jm/chg4dKtmzZ5eWLVvyHaKAw1jYuHHWfqHRPo7ZkVkYABJRqiDAGzJkiBQoUEAN45YtW1bmenVNfPPNN5IjRw75/fffPduGDRsmpUqVkrNnz0rJkiV9ehobNGhwyzkQKM6cOVM6deqkgkCiQNuxQ+TAAesGWGjX/v3oLQ91S8gpGAASUar07dtXNmzYIGvXrlU9dZ988on069dPvv/+e/X4Qw89JD169JDOnTvLhQsX5Oeff5b33ntPZs2aJXny5JF//vnHp6fReyjYgGP9/fff0qdPH747FBSbN9vjhbZLO8n6GAASUYodP35cZsyYIRMnTpQSJUqonjr04HXp0kUFeIaPPvpIJXg8/fTT0rVrV3n++eelCZY1SKFp06ZJlSpVpFatWnx3KCi2bEHCkbVfbLQP7SQyQ0ZTjkJErrBt2zYV9CUWmNWpU8fz/1mzZpU5c+ao51WqVElGjRqV4nPExMTIkiVL5MMPPzSt3US3g47oq1et/TqhfYl0mBP5hQEgEaUahnHz5cuX7HO+/fZbVcLl2LFjEh0dLYUKFUrRsRE4ouwLehWJggXLrtnBnj2hbgE5BYeAiSjFUAIGdQCR6JGk+HjZ9v33MvGNN2TZ9OnSoFw56dG9u8oEBgSFcD2JdbYw/Nu+fXuVIEIUDPjVTEvtv2BCEr1VE1XIXtgDSEQpduedd0r//v3lpZdeUjX6GjVqJKdOnVK1+lArcNCgQfLv339L1ebN5Th26NZNWohI6fBw+b//+z954YUXVOYwjoPkkKpVq6qA0CgsvWnTJtm1a5dMnjyZ7woFzbVr9nmxEfyhvVafr0jW55geQAwx4csFE9KRhbg8Fatn4wsM+91///0BbSOR3aC3DwEbfhoQyL366qsycuRIVdKlY8eOal5gr1691ONvv/32Lcf54IMP5M0335Q9N8avJkyYILNnz1alZLzLwGD4FzUB69WrF5R/HxFktFFXCBbPsVN7ybocsRQcCsvWqFFDzUlCfTL0IKCI7GeffSaPP/54svvin//ggw+qIPDQoUNqlYKU4lIyRImIihLJ77sUlkRGikSkbSksokDCUmtmDAOnk3jJKzE+22Ikr2gm9bdkySJy8aIph3K1OC4F54wewHnz5snBgwdl8eLFatWAl19+WZWfeO211267L+qTYcJ57969g9JWIiKynvLlzTkOAj2s++t9Myv4gwoVTDsUuZwjAkAsU1W3bl3JnTu3Z1vbtm3lwIEDnqKziUEB2nHjxqm6ZkRE5F61a1t/Xh3ah3YSmcERASBWDEhYYsK4j8cSExsbq5aZwmRzzENK6VAzuo29b0REZH81atijDiDaSWSG9E5ZmxQT1b0hQ9F4LDEYIm7RooXqKUyp0aNHq0xH41a0aNE0tpyIiKzALovO2KWdZH2OCADz5s2rVg9ImBVsPJYQ1h/94osv1FqmNWvWVLf3339fLl68qP4fJS0Sg8QS9Bwat6NHjwboX0RERMFUubJImTJ6lq0VoV1ly4pUqhTqlpBTOCKZvHr16moeHzJ6sf6oMb8ve/bsUgZ/0Qmgt3BzghW1ERCiNAWGhIsVK5boebBfwp5GIiKyP3x1DBokMnCgWBbaZ9UAlezHET2ATz75pERGRsqUKVPU/aioKBXMdevWzVNgFqVh0LuHnwgSjZ4/43bXXXepWmf4/wiWqyAicp1u3XChL5aE8i9du4a6FeQkjggAS5UqpQrIvvLKK1K8eHEVzJUvX14N6xpQ32/Lli2pqvNHRETukTOnCCqCZcggloL2PPWU3j4isziiELT33D4Uc86TJ88tWcH//vuv7N27VwWG2bJlu2Vf9BqiZAzWOk0pFpIkSgQLQZONnTmjz7XDtPL4eCusxiOSL5/Ivn0iXpXOKI3iWAjaGXMADVmyZJGKFSsm+hiCPgzvJgXDvhz6JSJyNwRZ06aJtGsnloAgdPp0Bn9kPkcMARMREZkF1cEw3y7UQ8E4P+Yltm4d2naQMzEAJCIiSmDCBH15uFAFgRkz6su+jR8fmvOT8zEAJCIiSiA8HMuMihQvHvwgEOdDNbLVq/V2EAWCo+YAElHwIY1sxw4RlNbcskVk/zqRHxI8B4vmRFTQ1zHFUlZYzQCFd1nTjKwsf36R9etFmjQR2btX5Pr14AR/6PlD8IfzEwWKo7KAg41ZRORmWAp7zhyRceNEDhy4uVh9+NUoiRLfb64IiZRoiVCPG6szokY7CttijhPLW5CVxcbqBaLx+46s3EBkBxvH7d5d/5tiz19gxTELmEPARJT6Mhn4MixQQP958ODNx5JYejvRx7Gf93FwXCIrQjA2e7bIsmVYXtT8IWEcD6Veli8XmTWLwR8FB+cAElGK4QsKNdImTULdTX34198xBGNfHAfHK1dOZMUKvhlkXW3aiOzfL9K3r0hYmD6Fwd9pDMa+OA6Ohzp/zPalYGIASEQpGgLDUC3KY6BArtlzoXC86Gj9CxZDYDgfkVXrBCIz9+RJPVO4dOmbj2GKQ3K8H8cUCOyP4+B4LPJMwcY5gGnAOQTkBqdOiTRtmvJJ8Pkk6TmAKR0OQ/kNZGByEjxZHXqxd+68mQS1caPInj0ily/rj6GXD+sLV0iQBFWpEpOgQimOcwCZBUxEyQd/9eqJHDkSnAxIwHkQbNatq2dgMggkK0OAh4x23LBerwHB37Vrej0/ZruTFXEImIgShWFY9PwFM/gz4Hw4L8pvcDiY7AhBH4Z8GfyRVTEAJKJEDRgQvNpnyfUEIkOYiIjMxQCQiG6Bchdz54Yu+DPg/Ki9huxjIiIyDwNAIvKBenyYy4TCtFaAdqA9rBNIRGQei3zEE5FVjBghcvp0YFY78AfagdIzaBcREZmDASAR+SzvNnVq6Id+E0J7pk3T20dERGnHAJCIPDDfDvXLrAgrhmBeIhERpR0DQCLy1C3DIvRWhvb5u/QcERHdxACQiJQdO0QOHLBugIV2YR1WrLpARERpwwCQiBQsZWUHdmknEZGVZQx1A8i9nnnmGYlBemcS7rnnHnnzzTf9Pv7x48dl0KBB8umnn0qePHkSfc6IESNkz549Mnr0aCntvaq7C2EdU6xccPWqWBbah3Z6L7lFRESpxwCQQuahhx6SCxcuqP/fuXOnjBw5Uj755BOJiIhQ24yfaVns+6uvvpL/+7//SzQAnDlzpsyZM0eOHDkigwcPdn0AiEXsrRz8AdqHdhIRUdowAKSQadWqlef/c+XKpX62bNlSihcv7tm+du1a+eKLL+TcuXOqR/DZZ5+VHDlyeAK49evXq6AxI1ZcF5Evv/xSli1bJu+//74899xznp7GsLAwqVmzprzyyitq2/79++W1116TadOmqXOSvuyaHezZE+oWEBHZH+cAkmWNGzdO2rdvL4UKFZJGjRqpYK969epy/vx59Xi7du3km2++kddff13dP3z4sPTq1Uvq1aunAsrWrVt7eho7duwoDRo0UPcvX76s7r/77rs+waabIcECZVbsAGVqrJqoQkRkF+wBJEs6efKkvPzyy/LLL7+onjvo3r271KhRQyZPnqyGbDGsiyHc5s2bS+PGjVWPHn4+/fTT6vnYbvQ0FilSxHNs7FuuXDnp2rWr7Nu3L0T/Qmu5dk1sA8Ef2ov5gERE5B8GgGRJP/zwg1y7dk0++OADdV/TNHU7ffq0mi9oQM/giy++qIZx8+XLJ8uXL0/2uEuWLJGlS5fK9u3bA/5vsJMbI+i2kC6dvdpLRGRF/BglSzp79qyat/f444/7bMeQsHdvHlSrVk2uXr2qegcRBCZn7NixkjNnTundu7e6j7mF8Oqrr6oh45deekncCEFVlizmDAPHSF6JkMhbtpklc2a9vURE5D8GgGRJRYsWlX///Vdq166t/j9R8fFyfOdOGf7sszK0d2+ZO3euzJoxQ57s2VM9nC6RKAGZxtHR0T6lYr777jtp1qyZmjvoZuXLi2zdmvbjaJJeoiVtGdzJqVAhYIcmInINBoBkSQjIEPi98MILMm/ePMmMbh8R+f3339XQ8L333ivxUVFSqGpVOYgHpk6Vd0Tk7oEDpcEDD0iJEiU8vYFRUVGeXsOGDRv6nMeYA4ih5Pvuu0/crHZtkV27rF0KBvP+0E4iIkobZgGTJWXJkkWVc8F8PwRzmONXsWJFnzIwEydOvGU/9OJ169ZNrl+/Lnnz5lWJII8++qi6jRkzJgT/EvuoUcPawR+gfWgnERGlDXsAyRIqV64sCxculPz583u2ValSRa3SgV6/U6dOScmSJVX2rjG0W6ZMmURLx/ywc6dKFkEh6ZUrV8qmTZvkxIkTPsc2FC5cWJ03sWO5Ta1aYgt2aScRkZWl05BaSX6vNBEeHi6xsbEqsYCCLCpKJGFQFxmJJUT4VvgBnwTlyokcPGjNOnuI+xGno2A1k0CIKC3i+P3NIWAiuhlgDRpk7VcD7WPwR0SUdpwDSEQe3brpZVasCGVqunYNdSuIiJyBASAReWAmA0okZshgrRcF7XnqKb19RESUdgwAicjHyJEiefKIpLfIpwPakTev3i4iIjKHRT7iicgqcucWmTZN1dm2BLRj+nS9XUREZA4GgER0i7Zt9fl2oR4KxvkxL7F169C2g4jIaRgAElGiJkzQl4cLVRCYMaO+7Nv48aE5PxGRkzEAJKJEhYeLrFkjUrx48INAnK9YMZHVq/V2EBGRuRgAElGSUGd7/frg9gTiPOj5w3kTWbyFiIhMwACQiJKFIGzdOpHOnW98aAToU8M4bpcuImvXMvgjIgokBoBEdFsYhp09W2TZMr0ki9m9gThevnwiy5eLzJrFYV8iokBjAEhEKdamjcj+/SJ9+4qEhenLsvm7NJuxL46D4+3bx2xfIqJgYQBItqFpItu3i0ydqgcMjRvf+pyiRUWqV9cfx/PwfOxH5kE9PmTmnjypZwqXLn3zsUyZkt/X+/EyZfT9cRwcj3X+iIiCJ52m8evRX3FxcRIeHi6xsbGSk2tUBUxcnMicOSLjxokcOHAzkAi/GiVR4pslECGREi0R6vGrV28GGoMG6fXk+DaZD58gO3eKbN4ssmWLyMaNInv2iFy+rD+GXj6sL4zEjtq1RWrUEKlVS6RSJf97D4mI0iKO398MAPkLZF1nzoiMGKH35CGYAO/LlXySdADozQgyEIRgnVssKcbepsDDe3Xtml7Pj4EeEVlJHANADgGTNSEZoGxZkUmTRC5d0oMJf/uqjX1xHByvXDmRFSvMbjElhKAPPbEM/oiIrIdzAMlSYmP1oVosRRYTI3L9urnHx/Gio/Vkhu7d9fMRERG5DQNAsoxTp0Tq1xdZsEC/Hx8fmPMYx50/Xz9fZGRgzkNERGRVDADJMsFfvXoie/ea3+uXFJwH56tbl0EgERG5CwNACjkMwzZtKnLkSPCCPwPOh/M2acLhYCIicg8GgBRyAwYEt+cvqZ7AgQNDc34iIqJgYwBIIYWlxebODV3wZ8D5UWsQ2cdERBR6qN6Aeq6sVhwYGQN0XKIU1fl76imR9OkDl/CRGmgH2oMlyVgnkIgoOBDg7djhW0weozIo3WXIkkWkfHnfYvKVK7PMVFowAKSQQZHn06etEfwB2oHSM2gXliYjIqLgr/JkrOLkDcHg1q0iu3aJTJ6sb+MqT2nDIWAK2R8+VvgI9dBvQmjPtGl6+4iIKDCjP5hzXaCA/vPgwZuPJRb8efN+HPt5HwfHpZRjAEghgas+Y3k3q8GVJuYlEhGRubjKk3UwAKSQzPdAl7+VoX2ceExEZA6u8mQ9jgsAL126JFoqv7mvXLkSsPbQrTDZF/M9rBpgoV3794vs3BnqlhAR2R9XebImxwSAv/zyi1SqVEmyZ88uOXLkkBdeeEGuJzPB7I8//pA+ffpIRESE5MyZU+6++26ZNGlSUNvsVsj0sgO7tJPIjU6ePCn//PNPkreoqKg0HR/fHzhOUt8jZ8+elePHjyd7jJQ8x+m4ypN1pXfKB0GrVq3U7fz587J27VqZO3eujBw5Msl95s2bJ/fdd5/s3btXLly4IB9++KE899xzajsFFtL8kellZWgf2klE1vTEE0+oz3DcqlevLkWLFpWaNWt6tj2Fmk5pcPToUXXMP//802f7Dz/8II899pgULFhQKlSokOi+KXmOG3CVJ2tzRAA4Y8YMyZgxo4waNUqyZMki1apVk0GDBsnEiROTvHobPny4+oDIly+fpE+fXh555BFp0qSJLFmyJOjtdxvUeLpdpleooX1oJxFZEy70jd6+RYsWqW3/+9//PNuWLl2qtl2+fFnOJJIeGh0dfUsvIZ6LffETHQvePY14PsycOVM6deokY8aMSbJtKXmOG3CVJ2tzRAC4ceNGqVOnjgoCDQ888IDExMTIoUOHUnQMzBvEFR8CQgosFPi0gz17Qt0CIvIXhl87duwouXLlkpIlS8qdd96pAjPDjz/+qHr4dmBS8g09evSQdu3aycWLF1WngHdP48Aba0XOnj1bHn/8cZ/vm4RS8hyn4ypP1ueI387IyEgpg4qQXvLnz+95rGzZsrc9xvjx4+XAgQNq6DgpuCrEzRDHYnF+JVh4V3e3MrzVaG+6dOJo+DdeuyaC7yqn/1vJPTAEW6BAATl16pSa54154i1atJASJUrI/fffrwK7lStXSufOneW3336TL774Qo0A/f777ypo3LBhg5objp7GUqVKhfqfYytc5ckeHNEDCPEJlpO4hm80wRfa7b/RFi9eLIMHD1ZJIFWrVk3yeaNHj5bw8HDPDVePlDo33hZbBUZOgX/P9u16Ae6+fUWqVxcJC9OXwLvjDv0n7mM7Hsfz8HyrZmsTJQVBHHr4hg0bpuZ4nzhxQgVzzZo1k4ULF3qeN27cOHVR3717dxkwYICMHTtWypUrxxfWwas8kcN6AAsXLqyu8ryh5w8KFSqU7L6YJ4Jhgo8//vi2k4aHDh0qL774ok8PIIPA1LHTiAiuHezU3qRwuSVym507d6qL/+bNm9/yWG6vhb5RNeLTTz+Vxo0bS9OmTaUvrnzI0as8jRolkjNnqFtjDQ74ehOpX7++utJDDUAkgcD333+vgj9c9QGSQc6dO6dKxGTIkEFtW758ubRv314++uijFP3hZ86cWd0obUEV3iIzhoFjJK9ESOQt28yCt9rOQ6IYhsEVLz6ME6664s9yS4MHi/TuLYLkeq/vUCLLwWc8AsDDhw/f9jMb036yZcsm27dvVx0JGDYmZ6/y1K9fqFtiDY4YAsbEXQR2vXv3VkkfGNJF1z567Iwh4M2bN6srP/yEVatWqTkiI0aMUHNAMGEYN5SRocAqX96c42iSXqIlwueGbWaxc/UGLrdEbla7dm01LWgZMhGSmS6E7GGU/vr555+lbOnS8lznziLIDI6KkrDz5yWd13Qiuj2u8mQvjugBxHw8zPd46aWXVG9gnjx5VEkYzOkwIBsLzzOysubMmSNhYWHy3nvvqZuhVq1aqveQAqd2bZFdu6xdCgZ1ANFOO9bdwq89rnIxp8/sOTgYRkE1jDZtRLp1Q/IU/v7MPQdRWpUuXVqeeeYZefbZZ9VFPapEHDt2TBYsWKD+v1evXqpA89NPP62+K1BHcN64cXJXzZrIIFTHQD9g8ezZVWJI1qxZ1Q1VIlBdAlnC6DBA9QiUiFHPL1BAMt0ocJqS5zh5lSer8l7lqXjxULcm9NJpqV03jXzmACKojI2NVVlmlDIYkuzTxx7tTGMt2aDCNNimTfUyO8GYf4OZFOjNXbPG851JFBIY2UHZlp9++kmVfAF8tU2ZMkX18CHYQ/YvRnuefPJJVfu1Z8+ecvr0afn666/1kSL0/CX4RV4xY4a8PWWK2r9u3boqgMRIE0aQEvruu+88RZ9T8hwnstNn+xNP8PubAWAaMAD0DzJLk0m2tlQ7K1cWWy23dORIcCdfIwjElfT69QwCyeYSCQAFyYQREaFqke1gKj0SLaw+uoO5zGPGMAB0xBxAshcEVSjbaNUEC7QLpSMrVRJb4HJLROSkVZ7SSbzkkyifG7aZgas83cQAkEISYA0aZO0XHu2zaoCaEJdbIiInrfKUV2IkSvL73LDNLFzlSccAkEICCQRWraiDMjVdu4otcLklIrICO67y5HYMACkkkDODeRg3SjJaBtqDxA875PR4L7dkBWgH2oN2EZG72KlajtNWefKXRb46yI1QUDhPHmsFMHnz6u2yAy63RERWYadVk5yyylNaWeSrl9wIq0kgY8xK60VOn26PVS6svtwS2kdE7lvlyQ7svsqTWRgAUki1bavPtwv1UDDOj3mJrVuLLdhhuSUichezVnkKNAeXYkwVBoAUchMm6B8coQoCMRSADwSsamEHXG6JiKwIqydZfaETu67yFAgMACnksJQYVpNAQeFgB4E4X7FiIqtX22dJM2O5JatmsXkvt0RE7lGjhrWLQAPah3YSA0CyCBTgx2oSwewJxHnQ82e3VSw2bxZbsEs7icgctWrZ45W0SzsDjT2AZBkIwtatE+ncWb8fqOxg47hduoisXWuv4A+2bLHHMAvaSUTuwVWe7IUBIFkKhmFnz9YLHKMki9m9gThevnwiy5eLzJpln2Ffb1xuiYisiKs82QsDQLKkNm30eWRYXDwsTP9g8Tdt39gXx8Hx9u2zT7ZvYrjcEhFZFVd5sg8GgGRZqMeHzNyTJ/VM4dKlbz52uyFQ78fLlNH3x3FwPDvU+UsKl1siMu9vaft2vZ4mLgwbN771OUWLilSvrj+O5+H5Vk2+sgqu8mQf6TSNv87+iouLk/DwcImNjZWcdlg7zObwm4rMUiQXYH4ZhkKxqLexriN6+VDgE4kdSPNHphcm+1aq5Jyin8hgu+MOc46VT6LUIuveIiRSoiXCnBOIyJUr1p+vSO6CIuWoozlunJ5ND/gdDb+a9N8DHjeyW3FBOWiQ3tPFj/3EYTnIsmVFYmL8K/Rv9mcT5n1j6g9Gf4wOgDh+fzMATAv+AllrXUfU83NKoJfcv9Ws5JhAB4B4L7AyiNPfE7JPUILlE9GTZxRR9+7+SOnfg/H7jItNrGeOpSPtPKoQKJjH3a6ddT6bMO/be+pPHANADgGT/eEDGVfobgg0uNwSkX9f/uiRmjRJX6kGgZ+/Y1/GvjgOjleunMiKFXxXEuIqT9bHOYBENsPllohSJjZWH6pFMILhSLPXzsbxoqP1pLXu3fXz0U1c5cnaGAAS2QyXWyK6vVOnROrXF1mwQL/vz1y0lDCOO3++fr7ISL47Bq7yZG0MAIlshsstEd0++KtXTy+ZZHavX1JwHpyvbl0Ggd64ypN1MQAkshm7LGNkl3aSs2AYtmlTkSNHghf8GXA+nLdJEw4He+MqT9bEAJDIZrjcElHSBgwIbs9fUj2BAweG5vxWxVWerIcBIJHNcLkloqRLj8ydG7rgz4Dzo9Ygso/JF1d5sg4GgEQ2xOWWiG6t8/fUU+bVyUwrtAPtQbvIF1d5sgaL/KkQUWpwuSUiXyjyfPp04LJ9UwvtQOkZtIuS/hzr109focNYlg/FtStXuvW5WTLry/LhcWNZPgy1Y3+uyOIfLgWXBqwkTqFkh+WWiIK1vFuBAnpxZqutjBMWpq9DziAlFaKi9MwRb6ivE2HeMpVxXAmEPYBEdoUga9o0a/V4TJ/O4I+CD/PtjOXdrAZBKeYlElkNh4CJbIzLLZHbYVm2cePE0tA+f5eeIwoUBoBEfsCH+dWr1vhQ53JL5GY7dogcOGCNv8XEoF3794vs3BnqlhD5ypjgPhEl+PDGF8zmzSJbtohs3KhPPPaea5Qli74+L5ZowyodKICMWn0o1xLM5ZawAkGwi99myCBSrJjI6tV6O4iCDX+bdmknPheIrIIBIFESk8oxrwhDN+hdgEyZ9F6/hBAMbt0qsmuXyOTJ+rYyZUQGDdLLtQRj8rex3BJWIAhWEVwEfxUq6MFfwvnaRMGCC7Ok/jatAu1DO1EWhsgqOARMlCCzFhX8kVGInwcP3nzsdl8w3o9jP+/jBKMWGJdbIjdCr7yVgz9A+9BOIithAEh0A6r2o6zKpEl6rx6Gf/2dV2Tsi+PgeOXKiaxYEfiXmsstkdugx9sO9uwJdQuIfDEAJNfD4vEYqkVGLWrqmT18iuNFR+tLIHXvHpxF4rncErmBcZFlByhTY9VEFXInBoDkaqdOidSvL7JggX4/UDX1jOPOn6+fDzVNA43LLZHTXbsmtoHgz07tJedjEgi5OvirVy+4mbM4D4askLGLpI1gJE8Yyy317auXojAymvevE5GdiSy3dI9vRnOlSsHLaCZKjYw2+gbD35Cd2kvOx19HciUMwzZtGvyyKYDz4bzI2F23LnjlU/AFhDIUuKlsxChkjvg+5+hRtf4VkS3gdxplmMwYBo6RvGrpt4TbzJI5My+kyFo4BEyuNGBA8MqlJNcTiAxhIvIfanCaQZP0at1f7xu2mQUlk4ishAEguc6yZfranKEK/gw4P2oNIvuYiPyD6Qqos2dlaB/aSWQlDADJVVCPD8Of6S3ym492oD3BqBNI5ESYq2qHOoBoJ5GVWORrkCg4RowQOX06cNm+qYV2oPQM2kVEqYdEJTuwSzvJPRgAkquWd5s6NfRDvwmhPdOm6e0jotRBUhOWXrRqpjrahQLzyKanFMqbV6+V5X3DNjIVs4DJNTDfDsVYrQhZjJiXiHItRJS6AAvrbls5oQrts2qA6u2RRx6RixcvJvl43bp1ZUQahiv27dsnzz//vHz99deSBenbN1y7dk2WLFki8+fPlzx58sh///tfkQjfcgSRkZHy6aefyrZt2yQ8PFyaN28uTzzxhKS3ynweG0qnaaxN7q+4uDj1ixgbGys5UWyNLAu/5ViODWv0WvE3Hl8O6MVAZnDQviiiom4tRIgr7QQfvERWh95zrLttxVVBwsJETp7U63Fa3erVq1UwBuvWrZNRo0bJl19+KdmyZVPbChQoINWqVfP7+L/++qvUqVNHzp07J9mzZ/dsL1GihFStWlWuXr0qBw8eVIGit2PHjqmAr3379lKpUiX566+/5J133pHHH39cJmGtTT/E8fubPYDkDjt2iBw4IJaFoHT/fr1QM4a0iCjlEFz17q2vu22lKR4ZMuhJXnYI/qApiqPecP78efWzSZMmkitXLs929N4tWrRI9RRWqVJFnnvuOcmRI4d67OOPP5bt27erHrwM+MeLyOTJk+WXX35RweQLL7zg6WnE4zj2yy+/LOvXr5eCBQvKsGHDVACYUN68eWXLli0+vYaZMmWS//znP/LJJ59IOjt0r1oQ+07JFbD6hR3YpZ1EVjNypEiePNbK8Me0NbTLKYYMGSKDBw9WvXgdOnSQrVu3Sq1atTzDxp07d5ZvvvlGBXvw22+/yaBBg9RQbb58+dQ+0L9/fzUU3KJFC3UfwV9yEPh5B3+wY8cOKVOmDIO/NOAcQHIFLH2GWlxWLheB9qGdapUOIkr12tdIpmrXzjoZ/tOn6+1yAgzLfvDBB3L48GEpXry42vboo49KhQoVZPbs2fLMM89IRESEzJw5U9q1a6eCRAR6vXr1Uvfhvvvu8/Q0eg8Bp9TIkSPV0PQff/whRYoUkWUo6kp+YwDoYujKR/d8csaPHy+lS5f2+xyvv/66FCpUSH04eDty5Iia0Pv777+rbvzGjRv7PH7lyhWZN2+e/PTTT2peCK4yn+nTR8IuXPCrHVj3NjxAwR+WizJjxQAEpxs3mtIkIldq21aka1eRBQtCOxSM0c/OnUVatxbHwPxADLsOGDBAjNQB/Dxz5ozs3r3b87wHH3xQ+vbtq37iu+PDDz80rQ1t27aV6tWry969e+X999+XCRMmyLvvvmva8d2GAaCLYTIvuuENuFq75557pJ9XKiom/aYF5m0gScbbjBkz5K233lJXht9++610xSd2ItlmmF/SsGFDNVcEV55Lp02TH3bt8qsdP0jgYP1QLBtlhj17TDkMkWtNmCCybVvolnrMmFFfnm78eHEUfI4j6REBYEJFixb1uY+kjvj4eJXYkTVrVlO/s3Br06aNlCtXTvUsonMB56PUYwDoYsWKFVM3Ayby3nXXXerKzXDq1Cl1pbVr1y7Jnz+/yrpq1qyZeiwqKkqeeuopFTAa++BqsGfPnup26NAh2bRpk9rXyOqaOnWqtG7dWp588kmVvj98+PBE27Zq1So1Z8SAIYMqhQqJ06FMDS6uOaeZyD/h4SJr1uAiEiMNwQ0C0fOHj9TVq/V2OMndd98t0dHRUrNmTZ/P5oTQG/jKK6+ocjHonfv88889c//MTNZAe+DkyZMMAP1kkemyZEV///23utpCENilSxfVO4ifU6ZMUY9jvgfmdHTv3l39EQKuxv755x9p1aqVStvHH6nR04hb7ty5VSB5u9pNCT9gsF9GXFo7HIK/G1UYiMhPqG60fr3eE3cjGTXgcJ4KFfTzJqyu5ATobcNn98CBA+WyV0FVDA1jKg9gOxJBUK7lzTfflNGjR8uzzz4rR48e9XxngPF9kVJr1qyRPV7DI5gWhIxj1AxELyP5x/nfqOS31157TfW8Ya6eAdlaGCo25vThSu+7776THj16qEyvFStWqA8DzBVBvSb8waOX0btX0R/jxo1zRcFPXCAHLc41qu0n3EbkAAjC1q3TC0SjCDw+PgKxBKRx3C5d8DnlvJ4/A5I2kOGLAA9DvmXLllVzudExoAo3i8jQoUNVjT/MHQdc9GM0p1u3bvLDDz+onrpGjRqpG5JH8P2CMjAoD4N5fSgBgw4H4/tiwYIF6uIf3yMYbcIIE6Yl7d+/XwWjKB5t5hCz2zAApCR9//336g8P8y0w2Rc3/HFjGABV2Y2evDlz5kjlypXV81GUEx8MZsIHCILRifhQeewxv46BKSqXLgcuCcQsmTOnfPgXH4LJ1XFHcXIk4CT7zZVM0ecLFy6oXmDMtUkI50VxVtQH8yebjygYEIzNni3Svr1Ir176OuBmDgmj1w/XTMj2dVLCBzRo0EBWrlzp8/eN0Rz0xGGYF98DKMNifMZgzh8CN8wRNBZGwJAvVvfYvHmz+u7AHEL05qGECwI9o/wLhojPnj17SxuMAtT4ftmwYYPKQMbnTuHChVUwyfp/acMAkJKd9NuxY8dEe++Mwp+AKzTcUFndSPM3C64aUWrg7bfflqeffdbv40RUENm6VSwPQ0gp9dhjj3mq9uO1P3HihE9dLMy1HDt2rN9twfxNXKljuMUYfr906ZKa14PsO1x540IAc4Iwt9PswJ/ILG3a6IXWsYoZSsUYK4b4syqQcYGGsnQo2YQ6f04p9eINPW2Jffbj86VixYq3bEdnAKb9JFbE2fs42B8Jft5S+r1RsmRJdSNzMACkJGH+Hr78bzd8izkhuFLDvA/MEcTVnlG0My1XaD/++KNK+0eiCAqQpkXt2iJIILZ6HUC0M6WQXGOYO3euGmZBFf6EBVNjYmLU3JyEvYF//vmneu6dd97p2YarcMzPwbA9ev+MnkZkYqO3D72CeK+R4IOreawWgMQgDAsh45vIqhCkYRABNYqx7vbHH99cHeh2NUK9H8eSjVjbF8UL7LLCB1FinD+pivz29NNPy/Tp01XhTe9eQSMJBLBOJOZpoJsf2//991+fYA1DyKmd8Auo/4ehZywNhHklaVWjhrWDP0D70E6zIEirX7++CuRRRxHDLXi/DJivWb58ebWupn7+q+oKHq85Ennw0+hpfPjhh2XixIlq2AUrASD4AwwPIeEH5yKyAwRtqHSFwgTbt6Mygb6MXPXqeq+ecc2Kn7iP7Xgcz8PzUV4G+zP4I9vTyG+xsbEYQFA/naBKlSpa//79Pffj4+O1IUOGaFmyZFGP1axZUytUqJA2YcIE9fjRo0e13Llzax999JFnn19++UXLmDGjtmrVKnV/9erVWtasWbV69eppLVq0UPts3bpV/T9ueP0qV66s/t/7ODhu9uzZPc8zbnPmzPHr37ZtGwZ7rH/bvt2/9w6vC17LixcvqvuXLl3SSpQooQ0fPly7evWq2ob3JCwsTNuzZ49nv1atWmn169fXrl27pr3yyita4cKFtZiYGPXYjz/+qI5p7O8N7+Pu3bu1r7/+Wp1n5MiR/jWcyGLi4zXtyhX9JzlXrMO+v/3BIWDywKLamMtnwPDtmDFjVKYvJu2itweZW8YQI4YVUePJewFxFHDGwt9Gxi4W+0YPEzK80DuI44eFhXkKUHsXovYuJorjXk9ktnapUqX8escqV9aHbrDOuD/zfgINvQ1oX6VK5hxv6dKlapI2imxjqBfQE4gev+XLl6ufRlFuTLDGXE+sDIPC3CitcDso8YAhepR3uP/++6VPnz7mNJzIAn+LGPIlcjoGgOQTvCUGc7/wJZ/SCbn33nvvLTX9kFFmwByy280rNIpNm/mhjnk7KAlhVWifWXVSkaWH5fSMNTi9YbsBmdzvvfeeKsyNel0Jl+RLilH2AVMCsC+SRXbu3OmKWo1ERE7gqE9rzDXDJHj0YNSoUSNFdeP82YfsqVs3kcGDb2YAWgk6VRNZEc9vqMOI3lZjBZakoHQDMngR5KOeI0o1eGd43w7mAqJED4J+BJ0Js/uIiMiaHBPtoCo4JqiPHDlSTVjHpHcsVWb2PmRfmLSNydzBWhkgpdAelJMwc1I5kj9QFmY9liVIAMkeBlTqR5bvtm3b1ND+IHRD3mAM9Xs/3/v/DcePH1c/jdpfRERkA5oDbN++XUuXLp321Vdfqfvnz5/XKlWqpHXt2tXUfRLiJFL7OX1a0yIiNC19+tAnfOCGduTPr7crLRImgcCjjz6qknZmzpyp/fbbb9oXX3yhNW/eXFuzZo16fPPmzVqmTJm05cuXq/vbtm3T7rjjDm3hwoXqfmRkpEromTx5skocOXHihDZ27FhtwIABKqFky5Yt2owZM1TiyGOPPZa2fwARURDFMglEre5gey+//LLKRPQ2adIkLXPmzNqFCxdM2ych/gLZ09KloQ/8vG834q80/puWamXLltUuX77s2YbM3nHjxmmNGjXSqlatqnXo0EFlZRuPtW3bVv0deBs/frxWt25dT2YcAssHHnhAK1++vDZs2DDt+vXrKqBE9nC1atXUMRAEJpYpTERkVbEMALV0eCHE5lq0aKESCxYtWuTZ9uuvv0qdOnXU0FZi85L82QdZr96LYGP1BWSuYiI8h7/sNx9wwQJzl4XyZ+i3c2d9qSoiIgqeuLg4NYfZzd/fjpgDiDfQu3yJsfwMJLa+oL/7YL4UfmGMm3fZErKXCRNEUAklVPMBkSyLZd9urJlOREQUVI4IAO+44w61RJU3LFEFmTNnNm0frEiBwNG4oQYa2RMWslizRqR48eAHgThfsWIiq1fr7SAiIgo2R5SBQSZvwqWojOAMxW/N2geBoXdwaIyeoyuZ7AdJrt9+K9K2rb5QfHx84M+JKkNly6JQs35+/uoQEQVf3I0PXwfMgnN3ANiyZUvp0qWLHDt2TAoXLqy2LVy4UKpVqyYFChRQ98+cOaPWl33ggQfU0G9K9rkd1EwDDgVTSiHI3LMHK5rwNSMiCrVz58551jZ3G0ckgWDJMAR2iOhRxwwrEmBZs1WrVqmlyLwTPDZs2CD33Xdfiva5HRTRRQ00FM7FsmlmMZJL0CPp1smpVsX3xrr43lgX3xtrcvP7ommaCv4KFSrk2gUgHNEDmCFDBvn+++9l4sSJsnr1arWqBwK9mjVrep6DbQ899JBnndOU7HM7+KUpUqSIBAr+IN32R2kXfG+si++NdfG9sSa3vi/hLu35c1QPoNMwPd26+N5YF98b6+J7Y018X9zNnf2eRERERC7GANCCkGn8+uuvJ1mOhkKH74118b2xLr431sT3xd04BExERETkMuwBJCIiInIZBoBERERELsMAkIiIiMhlHFEH0I42bdqk6hBmzJhR2rVrJ+XLlw/IPpQ6KO69ePFiVRgcK8K0b99e8ubNm+w+R44ckW+//Vaio6OlQoUK6r1BnUky1+nTp+WLL76QkydPSsWKFeWRRx5J8eu8fft2WbBggdStW1e9P2Suffv2ydKlS+XKlSvSrFkzqV279m33QTH+ZcuWyY4dO9Tym/hbY+Kb+fCdsX79elXz7rHHHrvtylWXL1+Wr7/+Wg4cOCDZsmWTBg0aSK1atQLQMgo19gCGwEcffSQNGzZUy9Dt2bNHqlatqpahM3sfSn3w16ZNG3nppZfkwoUL8tlnn0mlSpXkzz//THKfkSNHSosWLeT3339X+7zyyiuqmDjXhzbXX3/9pd6L+fPnq9f55ZdfllatWqkg4nZQ7R/BxZQpU+S7774zuWWEC6YqVarIrl275MSJE9K4cWN5//33k31hoqKiVJCIvxcEjQhQ7r//fr6YJhswYIB06tRJzp49K//73//UBSpWxUruIgvv5ahRo9T7cvDgQbVi1vDhw/neOBEKQVPwHD9+XLvjjju06dOne7a9+uqrWkREhHb58mXT9qHUmzdvnnqdjxw5ou5fvXpVu/fee7X27dsnuc+mTZvU8wxnz57V8uXLp7399tt8C0zUqVMn9V4YrzXeI7xXs2fPvu2+nTt31oYOHarVqFFD69+/P98XE125ckUrUKCA+jwy4HMqU6ZM2j///JPkfo888ohWpUoV7cKFC55te/fu5Xtjol9//RWLPGg///yzZxs+y6pXr57kPlOnTlV/V7GxsZ5tH374oRYWFubzOUfOwB7AIFuxYoVaN7hDhw6ebT179lRXxGvXrjVtH0q9RYsWqavdYsWKqfsYau/WrZsa2rp27Vqi+2BoBM8zYJilZMmSam1NMq9ndsmSJdKlSxfPa433qFGjRuo9S86MGTNk//798uabb/LtCIBffvlFTp06JU8++aRnW8eOHdX7tHz58kT3+eeff9QQI3r/wsLCPNvLlSvH98jknlkMrWMI1/t7A6MV6FFPDJZExeJg3p936AnE55r35xw5AwPAIMO8Ciw+nTVrVs+2EiVKqHWF8ZhZ+5B/702pUqV8tuH+pUuXUhzQYS7Uli1bpF69enwLTIKAAcO+ib03yf3+470YMmSIzJs3TzJlysT3IwDw+uPiFBc9BgR1+LxK6r3ZvHmzCjJw8TR16lR566235PPPP5erV6/yPTL5vUnsb8Z4LDEPP/yw/Oc//5GmTZvKoEGD1EXXl19+KV999RXfGwdiABhk//777y2LbiOQy549u3rMrH3InPfGWCw8Ja8z5tk8/vjj6oq7c+fOfAtMYrz2ib03Sb0vmMiOnigEF2XLluV7ESB4/XFhmjAZJ7n3JjY2Vv3E+4MRDFxgvfHGG1K9enU1X5NC93mGCy0EhwjGc+TIob5jMK/zjz/+4NviQOzTDTL8QRkfgN5DXOfPn1ePmbUPmfPeIKgzHksOkj5atmypej8w9MIsYPMYr31i701S7wuSRZC8gxuGGgEJVBs2bFD33377bQ5pmfTeIJjAkKH3EGFy742x/aGHHpJhw4ap/0evE0Y1PvnkE9VrS6H5PBs7dqwKyg8dOqQygAE96L169VLJPejZJedgD2CQoXTL8ePHVfBmwBUXArqkyrr4sw/5995gvpg33McHYXKlE9Br8eCDD6qrZpRcMK6yyRyFCxdWvRGJvTdJ/f5Xq1ZNhg4dKrly5fLcEJSjzAj+H8OWlHbG6+89pIiAEMF2Uu8NMlHh3nvv9WzD3wx6ahF4kDnw+icc6jX+hpKab7l7926VbW8Ef3DfffepeYCcbuRAoc5CcZvIyEiVUTVhwgTPtueff14rVKiQyqiD69eva0OGDNHWr1+f4n0o7b788kstY8aM2r59+9T9S5cuaVWrVtW6devmk6mI9yY6OlrdP3funFavXj2VYXr69Gm+DQHSo0cP9V7gPQG8R3ivPv/8c89zFi9erI0dOzbJYzAL2HzIDC1SpIj6PDLgcypLlizayZMnPdvGjBmjLVu2zHO/UqVKKjPbgM+4nDlzah9//HEAWulOW7duVVnAq1at8mxr166dVqdOHZ/XHZ9n+/fvV/dff/11VV3izJkznuf897//1dKnT68dO3YsyP8CCjQGgCHw6aefqg9IlLZ46KGHVHC3YsUKnw9V/OGOHz8+xftQ2sXHx2sdOnRQZS369OmjyiXcfffdPuUs8CWG9+bgwYPqPp6fLl067ZlnnlEfpMZt5syZfEtMhFJIJUuW1KpVq6bem4IFC2qPP/64es8MeA/Kli2b5DEYAAYGAgx8HiG4QMkdfE5NmjTJ5znFihXTnnvuOc/9zZs3a3ny5FH7oDTPXXfdpTVq1IhlrUyGIBuBdc+ePbWGDRuq1xyBofcFLT7PVq5c6SljVblyZfV+4X3B5xvKwowaNcrsppEFpMN/Qt0L6UZ79+6VNWvWqHkzKGh71113eR7DW/Luu+9K8+bN1cTolOxD5lm9erVnJRCsGuE9X+bw4cOqAPezzz6rhhIxPyaxDGFk2yEhhMyDoUWU5DFWAsGKE96wGsvff/8tffr0SXT/WbNmqTlMCfejtMPfwDfffKOGCps0aeIZ5jVMmjRJypQpox4zYOUclIrB1BY8H3PMyHxYQQpzX5EQ0rZtW8mXL59P4edPP/1UlRhDyRhAcXVMZUERaHz2YfUcJlI5EwNAIiIiIpdhEggRERGRyzAAJCIiInIZBoBERERELsMAkIiIiMhlGAASERERuQwDQCIiIiKXYQBIRERE5DIMAImIiIhchgEgERERkcswACQiIiJyGQaARERERC7DAJCIiIjIZRgAEhEREbkMA0AiIiIil2EASEREROQyDACJiIiIXIYBIBEREZHLMAAkIiIichkGgEREREQuwwCQiIiIyGUYABIRERG5DANAIiIiIpdhAEhERETkMgwAiYiIiFyGASARERGRyzAAJCIiInIZBoBERERELsMAkIiIiMhlGAASERERuQwDQCIiIiKXYQBIREREJO7y/5zg8pTsLZ1PAAAAAElFTkSuQmCC", - "text/plain": [ - "
" - ] - }, - "metadata": {}, - "output_type": "display_data" - } - ], - "source": [ - "np.random.seed(1)\n", - "x, y = np.random.random((2,15))\n", - "fig, ax = plt.subplots()\n", - "scatter = ax.scatter(x, y, s=900, c='b')\n", - "text_list = [f'Text{i}' for i in range(len(x))]\n", - "ta.allocate(ax,x,y,\n", - " text_list,\n", - " scatter_plot=scatter,\n", - " linecolor='r',\n", - " linewidth=3,\n", - " linezorder=5)\n", - "plt.show()\n" - ] - }, { "attachments": {}, "cell_type": "markdown", @@ -596,7 +525,7 @@ "name": "stderr", "output_type": "stream", "text": [ - "100%|\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588| 1949/1949 [00:01<00:00, 1541.75it/s]\n" + "100%|██████████| 1949/1949 [00:01<00:00, 1541.75it/s]\n" ] }, { diff --git a/images/linezorder_after.png b/images/linezorder_after.png deleted file mode 100644 index bc643e938a123d3e8b6a826141ff3ff719823628..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 30735 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 RoXv})d`n#+=Y~nZ{{uw_vFiW; diff --git a/images/linezorder_before.png b/images/linezorder_before.png deleted file mode 100644 index d492fb9207dbe512e90e1ece2af7aa05ca2308ba..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 30849 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 diff --git a/src/textalloc/__init__.py b/src/textalloc/__init__.py index 31a4795..33473fc 100644 --- a/src/textalloc/__init__.py +++ b/src/textalloc/__init__.py @@ -70,7 +70,6 @@ def allocate( draw_all: bool = True, nbr_candidates: int = 200, linewidth: float = 1, - linezorder: float = None, textcolor: Union[str, List[str]] = "k", direction: Union[str, List[str]] = None, priority_strategy: Union[int, str, Callable[[float, float], float]] = None, @@ -115,7 +114,6 @@ def allocate( draw_all (bool, optional): Draws all texts after allocating as many as possible despit overlap. Defaults to True. nbr_candidates (int, optional): Sets the number of candidates used. Defaults to 200. linewidth (float, optional): width of line. Defaults to 1. - linezorder (float, optional): zorder of the lines between points and text-boxes. Defaults to None, which resolves to a value below the point's zorder so the point visually caps the line. textcolor (Union[str, List[str]], optional): color code of the text. Defaults to "k". direction (Union[str, List[str]], optional): set preferred directions of the boxes (south, north, east, west, northeast, northwest, southeast, southwest). Defaults to None. priority_strategy (Union[int, str, Callable[[float, float], float]], optional): Set priority strategy for greedy text allocation @@ -125,7 +123,7 @@ def allocate( auto_ha (bool, optional): If True, horizontally aligns text dependent on location relative to it's x and y coordinate. Defaults to True. xlims (Tuple[float, float], optional): x-axis limits of the plot. Defaults to ax.get_xlim(). ylims (Tuple[float, float], optional): y-axis limits of the plot. Defaults to ax.get_ylim(). - plot_kwargs (dict, optional): kwargs for the plt.plot of the lines if draw_lines is True. Can override linewidth, color, and zorder. + plot_kwargs (dict, optional): kwargs for the plt.plot of the lines if draw_lines is True. Can override linewidth, color, and zorder (lines default to a zorder just below the scatter point's, so the point is drawn on top of the line). **kwargs (): kwargs for the plt.text() call. Returns: @@ -282,12 +280,12 @@ def allocate( scatter_plot_bbs = get_scatter_bbs(scatter_plot, ax) scatter_plot_bbs[:, 2] = scatter_plot_bbs[:, 0] + scatter_plot_bbs[:, 2] scatter_plot_bbs[:, 3] = scatter_plot_bbs[:, 1] + scatter_plot_bbs[:, 3] - if linezorder is None: - # Below matplotlib's default zorder for scatter/patch collections (1), so the - # point marker is drawn on top of and visually caps the line where it meets it. - linezorder = 0.9 - if scatter_plot is not None: - linezorder = min(linezorder, scatter_plot.get_zorder() - 0.1) + # Default the line's zorder below matplotlib's default zorder for scatter/patch + # collections (1), so the point marker is drawn on top of and visually caps the + # line where it meets it. Override via plot_kwargs={"zorder": ...} if needed. + line_zorder = 0.9 + if scatter_plot is not None: + line_zorder = min(line_zorder, scatter_plot.get_zorder() - 0.1) # Process extracted textboxes if verbose: @@ -370,7 +368,7 @@ def allocate( else: x_, y_, z_ = line line_kwargs = dict( - linewidth=linewidth, c=linecolor[ind], zorder=linezorder + linewidth=linewidth, c=linecolor[ind], zorder=line_zorder ) if plot_kwargs is not None: line_kwargs.update(plot_kwargs)