{
 "cells": [
  {
   "cell_type": "markdown",
   "id": "a4b8330d-9b91-436f-a771-80f16299a61e",
   "metadata": {},
   "source": [
    "# Use WFS streaming data to load a network\n",
    "\n",
    "In France, the GeoPlatform offers geographic data streams that provide access to various IGN databases, including the BD TOPO® road network. In tracklib library, the static method *requestFromIgnGeoportail* loads data, available free and open, from the service and directly stores it in the *Network* structure.\n",
    "<br/>\n",
    "<div class=\"alert alert-block alert-info\" style=\"padding:1em\">\n",
    "    \n",
    "```python\n",
    "  tkl.NetworkReader.requestFromIgnGeoportail(bbox:Bbox, tolerance=0.1, \n",
    "                                spatialIndex=True, proxy=None) -> Network\n",
    "```\n",
    "\n",
    "</div>\n",
    "\n"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "0e3cbd5c-42de-494a-a758-255adb95dee6",
   "metadata": {},
   "source": [
    "## As usual, let's start by defining our environment\n",
    "\n",
    "The first task is only useful for the online notebook and import the local tracklib code source. It's not necessary if tracklib is installed from PyPI."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 1,
   "id": "a017b509-be06-4139-beb6-506bda982706",
   "metadata": {},
   "outputs": [],
   "source": [
    "import os\n",
    "import sys\n",
    "\n",
    "# Import de tracklib\n",
    "module_path = os.path.abspath(os.path.join('../../../..'))\n",
    "if module_path not in sys.path:\n",
    "    sys.path.append(module_path)"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "fc58ad87-7dd8-4970-8a93-6eef92d7353b",
   "metadata": {},
   "source": [
    "The following two imports are necessary for the tutorial:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 2,
   "id": "624f5b44-bce3-47d6-bf52-e3edf7156481",
   "metadata": {
    "editable": true,
    "slideshow": {
     "slide_type": ""
    },
    "tags": []
   },
   "outputs": [],
   "source": [
    "import matplotlib.pyplot as plt\n",
    "\n",
    "# Import tracklib library\n",
    "import tracklib as tkl"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "880beb2e-68fb-4909-85a9-279c7794f584",
   "metadata": {},
   "source": [
    "## Parameter initialization"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "7ab8c082-d60d-459b-b80d-fdd87e5b15b0",
   "metadata": {},
   "source": [
    "### The bounding box\n",
    "\n",
    "The coordinates of the extent must be defined in the WGS84 coordinate system."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 3,
   "id": "bcc68d88-8118-402d-b9c5-82b697c13ddd",
   "metadata": {},
   "outputs": [],
   "source": [
    "xmin = 2.58183\n",
    "xmax = 2.58988\n",
    "ymin = 48.83999\n",
    "ymax = 48.84301\n",
    "\n",
    "bbox = tkl.Bbox(tkl.GeoCoords(xmin, ymin), tkl.GeoCoords(xmax, ymax))"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "b4a6e7b3-56a0-4587-a829-f659702c3f3c",
   "metadata": {},
   "source": [
    "### The tolerance threshold\n",
    "\n",
    "This parameter specifies the maximum distance accepted for merging two nodes (edge ends)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 4,
   "id": "77e5aa13-52c9-482b-b9f1-1aa689d0d1e6",
   "metadata": {},
   "outputs": [],
   "source": [
    "tolerance = 0.0001"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "07a569ec-73f5-4ea1-acd6-2ef0e3f6d64c",
   "metadata": {},
   "source": [
    "### Does the network need an index ?"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 5,
   "id": "4564d177-e30a-4f3a-94d9-e58e9c707f20",
   "metadata": {},
   "outputs": [],
   "source": [
    "spatialIndex = True"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "bd81963a-3da2-4603-a56b-7a490c6028b5",
   "metadata": {},
   "source": [
    "## Load a network"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 6,
   "id": "07d80393-6c54-48cd-99cc-7cbcf7cc0f8a",
   "metadata": {
    "editable": true,
    "slideshow": {
     "slide_type": ""
    },
    "tags": [
     "nbsphinx-thumbnail"
    ]
   },
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "PAGE 1/1\n"
     ]
    },
    {
     "name": "stderr",
     "output_type": "stream",
     "text": [
      "\u001b[38;2;0;255;0m100%\u001b[39m \u001b[38;2;0;255;0m(97 of 97)\u001b[39m |########################| Elapsed Time: 0:00:01 Time:  0:00:010000\n",
      "\u001b[38;2;255;0;0m  0%\u001b[39m \u001b[38;2;255;0;0m(0 of 97)\u001b[39m |                         | Elapsed Time: 0:00:00 ETA:  --:--:--"
     ]
    },
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Building [3423 x 5447] spatial index...\n"
     ]
    },
    {
     "name": "stderr",
     "output_type": "stream",
     "text": [
      "\u001b[38;2;0;255;0m100%\u001b[39m \u001b[38;2;0;255;0m(97 of 97)\u001b[39m |########################| Elapsed Time: 0:01:14 Time:  0:01:140004\n"
     ]
    },
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Number of edges= 97\n",
      "Number of nodes= 71\n"
     ]
    },
    {
     "data": {
      "text/plain": [
       "<matplotlib.legend.Legend at 0x76c49f54ec50>"
      ]
     },
     "execution_count": 6,
     "metadata": {},
     "output_type": "execute_result"
    },
    {
     "data": {
      "image/png": "iVBORw0KGgoAAAANSUhEUgAAAfYAAAHTCAYAAADVijo5AAAAOXRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjUuMSwgaHR0cHM6Ly9tYXRwbG90bGliLm9yZy/YYfK9AAAACXBIWXMAAAsTAAALEwEAmpwYAACDZUlEQVR4nO3dd3hUVf7H8ffJpJdJJj0hQAKEGpJAEoh0ESyI2FDZta9l1921oK6rv91VcJttV92iu666rm3trl1REVSUFiDSmyAtkN5IT87vjyRjKiSTmblTvq/nmSczd2753oHkM/fec89RWmuEEEII4Rl8jC5ACCGEEPYjwS6EEEJ4EAl2IYQQwoNIsAshhBAeRIJdCCGE8CAS7EIIIYQH6XOwK6VMSqmNSql3215nKqVWK6U2KaXWK6Um9bLcYqXUVqXUFqXUf5VSgV3ev10ppZVS0V2mD1FKVSulbrdlx4QQQghv5NuPeW8GtgPmttcPAEu11h8opea1vZ7VcQGl1CDgJmCs1rpWKfUKsAh4pu39wcBc4EAP23sY+KAvhUVHR+vk5OR+7IoQQgjh3vLy8oq11jFdp/cp2JVSScDZwO+BW9sma74P+XDgSC+L+wJBSqlGILjLfA8DdwBvddneecC3wPG+1JecnMz69ev7MqsQQgjhEZRS3/U0va9H7I/QGsBhHabdAnyklHqI1lP6U7oupLU+3Pb+AaAWWKa1XtZW0ALgsNY6XynVsdAQ4Je0HsnLaXghhBCiH056jV0pNR8o1FrndXnrBmCx1nowsBh4qodlLcC5QAqQCIQopS5TSgUDvwLu7mGTS4GHtdbVJ6nr+rZr++uLiopOthtCCCGEV1An6yteKfVH4HKgCQik9fT7G8A5QITWWqvWQ+4KrbW5y7IXAWdqra9pe30FkAs8DnwK1LTNmkTrKfpJwKvA4LbpEUALcLfW+m+91Zidna3lVLwQQghvopTK01pnd51+0lPxWuu7gLvaVjILuF1rfZlSajswE1gBzAZ297D4ASC37Qi9FjgNWK+13gzEdihuP5CttS4GpneYvgSoPlGoCyGEcLzGxkYOHTpEXV2d0aV4ncDAQJKSkvDz8+vT/P1pFd/VdcCjSilfoA64HkAplQg8qbWep7Veo5R6DdhA6xH/RuCJAWxTCCGEAQ4dOkRYWBjJycl0bBclHEtrTUlJCYcOHSIlJaVPy5z0VLw7kFPxQgjhWNu3b2f06NES6gbQWrNjxw7GjBnTaXpvp+Kl5zkhhBB9IqFujP5+7hLsQggh3M6SJUt46KGHbFr2mWee4ec//3mP74WGhg6kLJcgwS6EEEJ4EAl2IYQQbuH3v/89o0aNYs6cOezcudM6fdOmTeTm5pKens75559PWVkZALNmzbL2SlpcXEzHrscPHjzImWeeyahRo1i6dGmP23vwwQfJyckhPT2de+65p9v7zc3NXHXVVaSlpTF+/HgefvhhAPbu3cuZZ55JVlYW06dPZ8eOHQBcddVV3HTTTUyZMoVhw4bx2muvAVBQUMCMGTPIzMwkLS2NL774YkCfkwS7EEIIl5eXl8dLL73Exo0beeONN1i3bp31vSuuuIL777+fb775hvHjx/ca1B2tXbuWF154gU2bNvHqq69265Z82bJl7N69m7Vr17Jp0yby8vL4/PPPO82zadMmDh8+zJYtW9i8eTNXX301ANdffz1//etfycvL46GHHuKnP/2pdZmCggK+/PJL3n33Xe68804AXnzxRc444ww2bdpEfn4+mZmZtn5MwMBudxNCCOGlnnnmGfbv32+39SUnJ3PVVVf1+v4XX3zB+eefT3BwMAALFiwAoKKigvLycmbOnAnAlVdeyUUXXXTS7c2dO5eoqCgALrjgAr788kuys79vYL5s2TKWLVvGhAkTAKiurmb37t3MmDHDOs+wYcP49ttvufHGGzn77LM5/fTTqa6u5quvvupUQ319vfX5eeedh4+PD2PHjuXYsWMA5OTk8KMf/YjGxkbOO+88CXYhhBDOd6IQdpT+tg739fWlpaUFoFvHOl3X1fW11pq77rqLH//4x72u32KxkJ+fz0cffcTf//53XnnlFR555BEiIiLYtGlTj8sEBAR02gbAjBkz+Pzzz3nvvfe4/PLL+cUvfsEVV1zR5/3sSk7FCyGEcHkzZszgzTffpLa2lqqqKt555x0AwsPDsVgs1uvSzz33nPXoPTk5mby81mFO2q9nt/v4448pLS2ltraW//3vf0ydOrXT+2eccQZPP/001dWtw5YcPnyYwsLCTvMUFxfT0tLChRdeyG9/+1s2bNiA2WwmJSWFV199FWgN7/z8/BPu23fffUdsbCzXXXcd11xzDRs2bLDlI7KSI3YhhBAub+LEiVxyySVkZmYydOhQ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",
      "text/plain": [
       "<Figure size 576x576 with 1 Axes>"
      ]
     },
     "metadata": {
      "needs_background": "light"
     },
     "output_type": "display_data"
    }
   ],
   "source": [
    "network = tkl.NetworkReader.requestFromIgnGeoportail(bbox, tolerance=tolerance, spatialIndex=spatialIndex)\n",
    "\n",
    "plt.figure(figsize=(8, 8))\n",
    "network.plot('k-', '', 'g-', 'r-', 0.5, plt)\n",
    "print ('Number of edges=', len(network.EDGES))\n",
    "print ('Number of nodes=', len(network.NODES))\n",
    "plt.legend()"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "e05866f3-3015-42cd-8733-eea2aea57d37",
   "metadata": {},
   "source": [
    "## Proxy\n",
    "\n",
    "If you are behind a proxy, you need to specify the *proxy* parameter so that the function calling the WFS service from BDTOPO takes it into account. The connexion parameters is a dictionnary with two keys:\n",
    "```python\n",
    "\n",
    "myproxy = {\n",
    "'HTTP': 'proxy.ign.fr:3128',\n",
    "'HTTPS': 'proxy.ign.fr:3128'\n",
    "}\n",
    "\n",
    "tkl.NetworkReader.requestFromIgnGeoportail(...., proxy=myproxy)\n",
    "```\n",
    "<br/>\n"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 7,
   "id": "f7f8a74d-3080-42f8-81ed-f4e7de9ff57e",
   "metadata": {
    "editable": true,
    "slideshow": {
     "slide_type": ""
    },
    "tags": []
   },
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "PAGE 1/1\n"
     ]
    },
    {
     "name": "stderr",
     "output_type": "stream",
     "text": [
      "\u001b[38;2;0;255;0m100%\u001b[39m \u001b[38;2;0;255;0m(97 of 97)\u001b[39m |########################| Elapsed Time: 0:00:01 Time:  0:00:010000\n",
      "\u001b[38;2;255;0;0m  0%\u001b[39m \u001b[38;2;255;0;0m(0 of 97)\u001b[39m |                         | Elapsed Time: 0:00:00 ETA:  --:--:--"
     ]
    },
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Building [3423 x 5447] spatial index...\n"
     ]
    },
    {
     "name": "stderr",
     "output_type": "stream",
     "text": [
      "\u001b[38;2;0;255;0m100%\u001b[39m \u001b[38;2;0;255;0m(97 of 97)\u001b[39m |########################| Elapsed Time: 0:01:15 Time:  0:01:150004\n"
     ]
    },
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Number of edges= 97\n",
      "Number of nodes= 71\n"
     ]
    },
    {
     "data": {
      "image/png": "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",
      "text/plain": [
       "<Figure size 576x576 with 1 Axes>"
      ]
     },
     "metadata": {
      "needs_background": "light"
     },
     "output_type": "display_data"
    }
   ],
   "source": [
    "myproxy = {\n",
    "    'HTTP': 'proxy.ign.fr:3128',\n",
    "    'HTTPS': 'proxy.ign.fr:3128'\n",
    "}\n",
    "network = tkl.NetworkReader.requestFromIgnGeoportail(bbox, tolerance=tolerance, spatialIndex=spatialIndex, proxy=myproxy)\n",
    "\n",
    "plt.figure(figsize=(8, 8))\n",
    "network.plot('k-', '', 'g-', 'r-', 0.5, plt)\n",
    "print ('Number of edges=', len(network.EDGES))\n",
    "print ('Number of nodes=', len(network.NODES))"
   ]
  }
 ],
 "metadata": {
  "kernelspec": {
   "display_name": "Python 3 (ipykernel)",
   "language": "python",
   "name": "python3"
  },
  "language_info": {
   "codemirror_mode": {
    "name": "ipython",
    "version": 3
   },
   "file_extension": ".py",
   "mimetype": "text/x-python",
   "name": "python",
   "nbconvert_exporter": "python",
   "pygments_lexer": "ipython3",
   "version": "3.10.12"
  }
 },
 "nbformat": 4,
 "nbformat_minor": 5
}
