slovdep_citizenship.ipynb

{
 "cells": [
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "# Deportations 1938 - citizenship\n",
    "\n",
    "This notebook uses geospatial queries to generate citizenship statistic for the database of deportees from Slovakia in November 1938.\n",
    "\n",
    "It uses the database compiled from lists in Slovak archives; citizenship needs to be inferred from very diverse types of information, most importantly from the statement of domicile (domovské práva, Heimatsrecht).\n",
    "\n",
    "The notebook starts from a list of deportees which include Geonames links for the domicile (including state citizenship), extracts coordinates from Geonames and after loading border dataset(s), performs a spatial join to sort domiciles into state territory, and hence the attributed citizenship.\n",
    "\n",
    "The notebook is an upgrade of a series of steps in PostgreSQL described in an [earlier article](https://blog.ehri-project.eu/2019/12/12/spatial-queries-first-deportations-slovakia/) in the EHRI Document Blog."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Make sure all needed modules are installed."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 56,
   "metadata": {
    "scrolled": true
   },
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Requirement already satisfied: pandas in /home/michal/.local/lib/python3.8/site-packages (1.3.4)\n",
      "Requirement already satisfied: python-dateutil>=2.7.3 in /home/michal/.local/lib/python3.8/site-packages (from pandas) (2.8.1)\n",
      "Requirement already satisfied: numpy>=1.17.3; platform_machine != \"aarch64\" and platform_machine != \"arm64\" and python_version < \"3.10\" in /home/michal/.local/lib/python3.8/site-packages (from pandas) (1.21.3)\n",
      "Requirement already satisfied: pytz>=2017.3 in /usr/lib/python3/dist-packages (from pandas) (2019.3)\n",
      "Requirement already satisfied: six>=1.5 in /usr/lib/python3/dist-packages (from python-dateutil>=2.7.3->pandas) (1.14.0)\n",
      "Requirement already satisfied: geopandas in /home/michal/.local/lib/python3.8/site-packages (0.10.2)\n",
      "Requirement already satisfied: pyproj>=2.2.0 in /home/michal/.local/lib/python3.8/site-packages (from geopandas) (3.2.1)\n",
      "Requirement already satisfied: fiona>=1.8 in /home/michal/.local/lib/python3.8/site-packages (from geopandas) (1.8.13)\n",
      "Requirement already satisfied: shapely>=1.6 in /home/michal/.local/lib/python3.8/site-packages (from geopandas) (1.7.0)\n",
      "Requirement already satisfied: pandas>=0.25.0 in /home/michal/.local/lib/python3.8/site-packages (from geopandas) (1.3.4)\n",
      "Requirement already satisfied: certifi in /usr/lib/python3/dist-packages (from pyproj>=2.2.0->geopandas) (2019.11.28)\n",
      "Requirement already satisfied: cligj>=0.5 in /home/michal/.local/lib/python3.8/site-packages (from fiona>=1.8->geopandas) (0.5.0)\n",
      "Requirement already satisfied: six>=1.7 in /usr/lib/python3/dist-packages (from fiona>=1.8->geopandas) (1.14.0)\n",
      "Requirement already satisfied: attrs>=17 in /usr/lib/python3/dist-packages (from fiona>=1.8->geopandas) (19.3.0)\n",
      "Requirement already satisfied: munch in /home/michal/.local/lib/python3.8/site-packages (from fiona>=1.8->geopandas) (2.5.0)\n",
      "Requirement already satisfied: click-plugins>=1.0 in /home/michal/.local/lib/python3.8/site-packages (from fiona>=1.8->geopandas) (1.1.1)\n",
      "Requirement already satisfied: click<8,>=4.0 in /usr/lib/python3/dist-packages (from fiona>=1.8->geopandas) (7.0)\n",
      "Requirement already satisfied: python-dateutil>=2.7.3 in /home/michal/.local/lib/python3.8/site-packages (from pandas>=0.25.0->geopandas) (2.8.1)\n",
      "Requirement already satisfied: numpy>=1.17.3; platform_machine != \"aarch64\" and platform_machine != \"arm64\" and python_version < \"3.10\" in /home/michal/.local/lib/python3.8/site-packages (from pandas>=0.25.0->geopandas) (1.21.3)\n",
      "Requirement already satisfied: pytz>=2017.3 in /usr/lib/python3/dist-packages (from pandas>=0.25.0->geopandas) (2019.3)\n",
      "Requirement already satisfied: xmltodict in /home/michal/.local/lib/python3.8/site-packages (0.12.0)\n",
      "Requirement already satisfied: pyarango in /home/michal/.local/lib/python3.8/site-packages (2.0.1)\n",
      "Requirement already satisfied: requests>=2.7.0 in /home/michal/.local/lib/python3.8/site-packages (from pyarango) (2.26.0)\n",
      "Requirement already satisfied: future in /usr/lib/python3/dist-packages (from pyarango) (0.18.2)\n",
      "Requirement already satisfied: datetime in /home/michal/.local/lib/python3.8/site-packages (from pyarango) (4.3)\n",
      "Requirement already satisfied: urllib3<1.27,>=1.21.1 in /usr/lib/python3/dist-packages (from requests>=2.7.0->pyarango) (1.25.8)\n",
      "Requirement already satisfied: charset-normalizer~=2.0.0; python_version >= \"3\" in /home/michal/.local/lib/python3.8/site-packages (from requests>=2.7.0->pyarango) (2.0.7)\n",
      "Requirement already satisfied: idna<4,>=2.5; python_version >= \"3\" in /usr/lib/python3/dist-packages (from requests>=2.7.0->pyarango) (2.8)\n",
      "Requirement already satisfied: certifi>=2017.4.17 in /usr/lib/python3/dist-packages (from requests>=2.7.0->pyarango) (2019.11.28)\n",
      "Requirement already satisfied: zope.interface in /home/michal/.local/lib/python3.8/site-packages (from datetime->pyarango) (5.4.0)\n",
      "Requirement already satisfied: pytz in /usr/lib/python3/dist-packages (from datetime->pyarango) (2019.3)\n",
      "Requirement already satisfied: setuptools in /usr/lib/python3/dist-packages (from zope.interface->datetime->pyarango) (45.2.0)\n",
      "Collecting mapclassify\n",
      "  Downloading mapclassify-2.4.3-py3-none-any.whl (38 kB)\n",
      "Requirement already satisfied: networkx in /home/michal/.local/lib/python3.8/site-packages (from mapclassify) (2.6.3)\n",
      "Requirement already satisfied: pandas>=1.0 in /home/michal/.local/lib/python3.8/site-packages (from mapclassify) (1.3.4)\n",
      "Requirement already satisfied: numpy>=1.3 in /home/michal/.local/lib/python3.8/site-packages (from mapclassify) (1.21.3)\n",
      "Collecting scikit-learn\n",
      "  Downloading scikit_learn-1.0.2-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (26.7 MB)\n",
      "\u001b[K     |████████████████████████████████| 26.7 MB 7.5 MB/s eta 0:00:01\n",
      "\u001b[?25hCollecting scipy>=1.0\n",
      "  Downloading scipy-1.8.0-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (41.6 MB)\n",
      "\u001b[K     |████████████████████████████████| 41.6 MB 211 kB/s eta 0:00:01\n",
      "\u001b[?25hRequirement already satisfied: pytz>=2017.3 in /usr/lib/python3/dist-packages (from pandas>=1.0->mapclassify) (2019.3)\n",
      "Requirement already satisfied: python-dateutil>=2.7.3 in /home/michal/.local/lib/python3.8/site-packages (from pandas>=1.0->mapclassify) (2.8.1)\n",
      "Collecting joblib>=0.11\n",
      "  Downloading joblib-1.1.0-py2.py3-none-any.whl (306 kB)\n",
      "\u001b[K     |████████████████████████████████| 306 kB 56.4 MB/s eta 0:00:01\n",
      "\u001b[?25hCollecting threadpoolctl>=2.0.0\n",
      "  Downloading threadpoolctl-3.1.0-py3-none-any.whl (14 kB)\n",
      "Requirement already satisfied: six>=1.5 in /usr/lib/python3/dist-packages (from python-dateutil>=2.7.3->pandas>=1.0->mapclassify) (1.14.0)\n",
      "Installing collected packages: scipy, joblib, threadpoolctl, scikit-learn, mapclassify\n",
      "Successfully installed joblib-1.1.0 mapclassify-2.4.3 scikit-learn-1.0.2 scipy-1.8.0 threadpoolctl-3.1.0\n"
     ]
    }
   ],
   "source": [
    "!pip3 install pandas\n",
    "!pip3 install geopandas\n",
    "!pip3 install xmltodict\n",
    "!pip3 install pyarango\n",
    "# !pip3 install mapclassify"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Include all necessary libraries and tools. In particular, we rely on Geopandas packages to work with data and conduct spatial joins."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 83,
   "metadata": {},
   "outputs": [],
   "source": [
    "import pandas as pd\n",
    "import geopandas as gpd\n",
    "from urllib.request import urlopen\n",
    "import xmltodict\n",
    "import json\n",
    "from pyArango.connection import *\n",
    "import arangoconf # contains login credentials for Arangodb (adapt and rename arangoconf.py.default)\n",
    "import numpy as np\n",
    "import matplotlib.pyplot as plt\n",
    "plt.rcParams[\"figure.figsize\"] = (10,10)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "The research database codes places of domicile or information about citizenship as links to Geonames records."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 6,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/html": [
       "<div>\n",
       "<style scoped>\n",
       "    .dataframe tbody tr th:only-of-type {\n",
       "        vertical-align: middle;\n",
       "    }\n",
       "\n",
       "    .dataframe tbody tr th {\n",
       "        vertical-align: top;\n",
       "    }\n",
       "\n",
       "    .dataframe thead th {\n",
       "        text-align: right;\n",
       "    }\n",
       "</style>\n",
       "<table border=\"1\" class=\"dataframe\">\n",
       "  <thead>\n",
       "    <tr style=\"text-align: right;\">\n",
       "      <th></th>\n",
       "      <th>location</th>\n",
       "      <th>domicile_citizenship</th>\n",
       "      <th>domicile_geo</th>\n",
       "    </tr>\n",
       "  </thead>\n",
       "  <tbody>\n",
       "    <tr>\n",
       "      <th>0</th>\n",
       "      <td>Žilina</td>\n",
       "      <td>Opava</td>\n",
       "      <td>https://www.geonames.org/3068927/opava.html</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>1</th>\n",
       "      <td>Michalovce</td>\n",
       "      <td>Maďarsko</td>\n",
       "      <td>https://www.geonames.org/719819/hungary.html</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>2</th>\n",
       "      <td>Sabinov</td>\n",
       "      <td>polská</td>\n",
       "      <td>https://www.geonames.org/798544/republic-of-po...</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>3</th>\n",
       "      <td>Sabinov</td>\n",
       "      <td>polská</td>\n",
       "      <td>https://www.geonames.org/798544/republic-of-po...</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>4</th>\n",
       "      <td>Žilina</td>\n",
       "      <td>Opava</td>\n",
       "      <td>https://www.geonames.org/3068927/opava.html</td>\n",
       "    </tr>\n",
       "  </tbody>\n",
       "</table>\n",
       "</div>"
      ],
      "text/plain": [
       "     location domicile_citizenship  \\\n",
       "0      Žilina                Opava   \n",
       "1  Michalovce             Maďarsko   \n",
       "2     Sabinov               polská   \n",
       "3     Sabinov               polská   \n",
       "4      Žilina                Opava   \n",
       "\n",
       "                                        domicile_geo  \n",
       "0        https://www.geonames.org/3068927/opava.html  \n",
       "1       https://www.geonames.org/719819/hungary.html  \n",
       "2  https://www.geonames.org/798544/republic-of-po...  \n",
       "3  https://www.geonames.org/798544/republic-of-po...  \n",
       "4        https://www.geonames.org/3068927/opava.html  "
      ]
     },
     "execution_count": 6,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "# Read CSV with data\n",
    "geodf = pd.read_csv('slovdep/slovedep_domicile.csv')\n",
    "geodf.dropna(axis=0, how=\"any\", inplace=True)\n",
    "geodf.head()"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 13,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/html": [
       "<div>\n",
       "<style scoped>\n",
       "    .dataframe tbody tr th:only-of-type {\n",
       "        vertical-align: middle;\n",
       "    }\n",
       "\n",
       "    .dataframe tbody tr th {\n",
       "        vertical-align: top;\n",
       "    }\n",
       "\n",
       "    .dataframe thead th {\n",
       "        text-align: right;\n",
       "    }\n",
       "</style>\n",
       "<table border=\"1\" class=\"dataframe\">\n",
       "  <thead>\n",
       "    <tr style=\"text-align: right;\">\n",
       "      <th></th>\n",
       "      <th>0</th>\n",
       "    </tr>\n",
       "  </thead>\n",
       "  <tbody>\n",
       "    <tr>\n",
       "      <th>0</th>\n",
       "      <td>https://www.geonames.org/3068927/opava.html</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>1</th>\n",
       "      <td>https://www.geonames.org/719819/hungary.html</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>2</th>\n",
       "      <td>https://www.geonames.org/798544/republic-of-po...</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>3</th>\n",
       "      <td>https://www.geonames.org/776458/baligrod.html</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>4</th>\n",
       "      <td>https://www.geonames.org/723010/aggtelek.html</td>\n",
       "    </tr>\n",
       "  </tbody>\n",
       "</table>\n",
       "</div>"
      ],
      "text/plain": [
       "                                                   0\n",
       "0        https://www.geonames.org/3068927/opava.html\n",
       "1       https://www.geonames.org/719819/hungary.html\n",
       "2  https://www.geonames.org/798544/republic-of-po...\n",
       "3      https://www.geonames.org/776458/baligrod.html\n",
       "4      https://www.geonames.org/723010/aggtelek.html"
      ]
     },
     "execution_count": 13,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "# Get unique Geonames links (especially important in order to avoid Geonames traffic limits)\n",
    "gnames = geodf.domicile_geo.unique()\n",
    "gnamesdf = pd.DataFrame(gnames)\n",
    "gnamesdf.head()"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 17,
   "metadata": {},
   "outputs": [],
   "source": [
    "# Connect to Arango database to locally store Geonames data (create configured collection if it doesn't exist yet)\n",
    "conn = Connection(username=arangoconf.username, password=arangoconf.password)\n",
    "db = conn[arangoconf.arangodb]\n",
    "try:\n",
    "    coll = db[arangoconf.arangocoll]\n",
    "except:\n",
    "    coll = db.createCollection(name=arangoconf.arangocoll)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Extract coordinates (and other metadata) from Geonames and save them in a local database. I have used Arangodb and convert the Geonames RDF (XML) response to JSON to save it locally."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 18,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "https://www.geonames.org/3068927/opava.html\n",
      "https://www.geonames.org/719819/hungary.html\n",
      "https://www.geonames.org/798544/republic-of-poland.html\n",
      "https://www.geonames.org/776458/baligrod.html\n",
      "https://www.geonames.org/723010/aggtelek.html\n",
      "https://www.geonames.org/2917509/gribow.html\n",
      "https://www.geonames.org/723846/poprad.html\n",
      "https://www.geonames.org/8505031/czechoslovakia.html\n",
      "https://www.geonames.org/2761369/vienna.html\n",
      "https://www.geonames.org/3058472/nove-zamky.html\n",
      "https://www.geonames.org/724377/krompachy.html\n",
      "https://www.geonames.org/667227/sighetu-marmatiei.html\n",
      "https://www.geonames.org/3059448/kolarovo.html\n",
      "https://www.geonames.org/798549/romania.html\n",
      "https://www.geonames.org/3059101/levice.html\n",
      "https://www.geonames.org/2921044/federal-republic-of-germany.html\n",
      "https://www.geonames.org/723090/zborov.html\n",
      "https://www.geonames.org/707559/irshava.html\n",
      "https://www.geonames.org/706173/khudl-ovo.html\n",
      "https://www.geonames.org/2782113/republic-of-austria.html\n",
      "https://www.geonames.org/3057141/trencianske-teplice.html\n",
      "https://www.geonames.org/3043470/neu-pest.html\n",
      "https://www.geonames.org/690548/uzhgorod.html\n",
      "https://www.geonames.org/3059646/jelka.html\n",
      "https://www.geonames.org/772857/dukla.html\n",
      "https://www.geonames.org/723529/spisska-bela.html\n",
      "https://www.geonames.org/763992/niedzica.html\n",
      "https://www.geonames.org/757029/tarnogrod.html\n",
      "https://www.geonames.org/666475/somcuta-mare.html\n",
      "https://www.geonames.org/3060812/casta.html\n",
      "https://www.geonames.org/706165/khust.html\n",
      "https://www.geonames.org/724641/hrlica.html\n",
      "https://www.geonames.org/3056711/vrable.html\n",
      "https://www.geonames.org/725011/cecehov.html\n",
      "https://www.geonames.org/724255/lucivna.html\n",
      "https://www.geonames.org/3060219/galanta.html\n",
      "https://www.geonames.org/3077882/cesky-tesin.html\n",
      "https://www.geonames.org/682716/carasova.html\n",
      "https://www.geonames.org/763523/nowy-targ.html\n",
      "https://www.geonames.org/699982/nyzhni-vorota.html\n",
      "https://www.geonames.org/3081859/wisnicze.html\n",
      "https://www.geonames.org/725008/cejkov.html\n",
      "https://www.geonames.org/3059438/kolta.html\n",
      "https://www.geonames.org/3056937/velka-bytca.html\n",
      "https://www.geonames.org/3061017/bojna.html\n",
      "https://www.geonames.org/3060308/dunajska-streda.html\n",
      "https://www.geonames.org/755889/wieliczka.html\n",
      "https://www.geonames.org/725017/cana.html\n",
      "https://www.geonames.org/2762157/murau.html\n",
      "https://www.geonames.org/3058663/modra.html\n",
      "https://www.geonames.org/3058018/pribeta.html\n",
      "https://www.geonames.org/2017370/russian-federation.html\n",
      "https://www.geonames.org/693791/synevyr.html\n",
      "https://www.geonames.org/774116/ciezkowice.html\n",
      "https://www.geonames.org/3080866/zakopane.html\n",
      "https://www.geonames.org/3078773/breclav.html\n",
      "https://www.geonames.org/723879/plesivec.html\n",
      "https://www.geonames.org/3054643/budapest.html\n",
      "https://www.geonames.org/3077584/chrastava.html\n",
      "https://www.geonames.org/3056547/zeliezovce.html\n",
      "https://www.geonames.org/724247/luhyna.html\n",
      "https://www.geonames.org/724443/kosice.html\n",
      "https://www.geonames.org/682685/carei.html\n",
      "https://www.geonames.org/764276/mszana-dolna.html\n",
      "https://www.geonames.org/723365/tornala.html\n",
      "https://www.geonames.org/3101321/cieszyn.html\n",
      "https://www.geonames.org/724305/leles.html\n",
      "https://www.geonames.org/3059436/komarno.html\n",
      "https://www.geonames.org/3059972/horne-saliby.html\n",
      "https://www.geonames.org/724330/ladmovce.html\n",
      "https://www.geonames.org/706510/kernitsa.html\n",
      "https://www.geonames.org/716247/putnok.html\n",
      "https://www.geonames.org/3070593/miroslav.html\n",
      "https://www.geonames.org/3074459/jaromerice-nad-rokytnou.html\n",
      "https://www.geonames.org/3067770/postoloprty.html\n",
      "https://www.geonames.org/725168/bardejov.html\n",
      "https://www.geonames.org/686902/znyats-ovo.html\n",
      "https://www.geonames.org/700646/mukacheve.html\n",
      "https://www.geonames.org/724623/huncovce.html\n",
      "https://www.geonames.org/3050616/kaposvar.html\n",
      "https://www.geonames.org/723736/rimavska-sobota.html\n",
      "https://www.geonames.org/724248/lucky.html\n",
      "https://www.geonames.org/3060208/gbely.html\n",
      "https://www.geonames.org/3076127/frydek-mistek.html\n",
      "https://www.geonames.org/772467/frydman.html\n",
      "https://www.geonames.org/758464/sromowce-wyzne.html\n",
      "https://www.geonames.org/759591/sanok.html\n",
      "https://www.geonames.org/8243822/tsyhanivtsi.html\n",
      "https://www.geonames.org/2780190/eisenstadt.html\n",
      "https://www.geonames.org/723505/stara-lubovna.html\n",
      "https://www.geonames.org/3060972/bratislava.html\n",
      "https://www.geonames.org/723839/porac.html\n",
      "https://www.geonames.org/723314/upor.html\n",
      "https://www.geonames.org/3058986/lucenec.html\n",
      "https://www.geonames.org/712602/bilky.html\n",
      "https://www.geonames.org/6252001/united-states.html\n",
      "https://www.geonames.org/3046340/pilisvoeroesvar.html\n",
      "https://www.geonames.org/3056515/veca.html\n",
      "https://www.geonames.org/3058524/nitrianske-pravno.html\n",
      "https://www.geonames.org/723705/rudnany.html\n",
      "https://www.geonames.org/763534/nowy-sacz.html\n",
      "https://www.geonames.org/3081368/wroclaw.html\n",
      "https://www.geonames.org/714548/totkomlos.html\n",
      "https://www.geonames.org/3058210/pezinok.html\n",
      "https://www.geonames.org/776597/augustow.html\n",
      "https://www.geonames.org/665947/stramtura.html\n",
      "https://www.geonames.org/689106/volovets.html\n",
      "https://www.geonames.org/710719/chernivtsi.html\n",
      "https://www.geonames.org/709516/dubove.html\n",
      "https://www.geonames.org/664432/turt.html\n",
      "https://www.geonames.org/3057422/straza.html\n",
      "https://www.geonames.org/3056911/velka-mana.html\n",
      "https://www.geonames.org/724503/kezmarok.html\n",
      "https://www.geonames.org/711416/brody.html\n",
      "https://www.geonames.org/771317/gruszow-wielki.html\n",
      "https://www.geonames.org/3060654/cifer.html\n",
      "https://www.geonames.org/3057374/sucany.html\n",
      "https://www.geonames.org/785965/senta.html\n",
      "https://www.geonames.org/724504/kesovce.html\n",
      "https://www.geonames.org/3059375/kosecke-rovne.html\n",
      "https://www.geonames.org/724265/lubica.html\n",
      "https://www.geonames.org/3069382/novy-bohumin.html\n",
      "https://www.geonames.org/684179/borod.html\n",
      "https://www.geonames.org/724411/kralovsky-chlmec.html\n",
      "https://www.geonames.org/3060991/borsky-mikulas.html\n",
      "https://www.geonames.org/724715/hermanovce.html\n",
      "https://www.geonames.org/3064673/sumperk.html\n",
      "https://www.geonames.org/688749/vylok.html\n",
      "https://www.geonames.org/706483/kharkiv.html\n",
      "https://www.geonames.org/3062465/vrbice.html\n",
      "https://www.geonames.org/3058649/mojzesovo.html\n",
      "https://www.geonames.org/723819/presov.html\n",
      "https://www.geonames.org/3067953/pohorelice.html\n",
      "https://www.geonames.org/715126/szolnok.html\n",
      "https://www.geonames.org/709505/nyzhnya-apsha.html\n",
      "https://www.geonames.org/723521/spisske-bystre.html\n",
      "https://www.geonames.org/723775/rakusy.html\n",
      "https://www.geonames.org/707311/izky.html\n",
      "https://www.geonames.org/690800/uhry.html\n",
      "https://www.geonames.org/3058497/nova-bystrica.html\n",
      "https://www.geonames.org/3057772/sahy.html\n",
      "https://www.geonames.org/3056725/batorove-kosihy.html\n",
      "https://www.geonames.org/3059716/janova-lehota.html\n",
      "https://www.geonames.org/2950159/berlin.html\n",
      "https://www.geonames.org/724534/kamenna-poruba.html\n",
      "https://www.geonames.org/690863/tyushka.html\n",
      "https://www.geonames.org/701299/mizhhirya.html\n",
      "https://www.geonames.org/3059050/liptovsky-mikulas.html\n",
      "https://www.geonames.org/725063/brutovce.html\n",
      "https://www.geonames.org/3060035/horna-marikova.html\n",
      "https://www.geonames.org/725040/busovce.html\n",
      "https://www.geonames.org/3057124/trnava.html\n",
      "https://www.geonames.org/775714/bogucice.html\n",
      "https://www.geonames.org/693995/shklo.html\n",
      "https://www.geonames.org/773569/dabrowa-tarnowska.html\n",
      "https://www.geonames.org/3064995/straznice.html\n",
      "https://www.geonames.org/3057630/skalica.html\n",
      "https://www.geonames.org/723578/slovenska-ves.html\n",
      "https://www.geonames.org/3056492/zlatna-na-ostrove.html\n",
      "https://www.geonames.org/8243842/radvanka.html\n",
      "https://www.geonames.org/3071961/liberec.html\n",
      "https://www.geonames.org/723526/spisska-nova-ves.html\n",
      "https://www.geonames.org/724301/lendak.html\n",
      "https://www.geonames.org/3058184/plastovce.html\n",
      "https://www.geonames.org/690158/velyki-luchky.html\n",
      "https://www.geonames.org/724144/michalovce.html\n",
      "https://www.geonames.org/668974/remeti.html\n",
      "https://www.geonames.org/3060446/dolne-pribelce.html\n",
      "https://www.geonames.org/3057692/senec.html\n",
      "https://www.geonames.org/719280/kek.html\n",
      "https://www.geonames.org/765042/mecina.html\n",
      "https://www.geonames.org/3059107/lest.html\n",
      "https://www.geonames.org/3056873/velke-kozmalovce.html\n",
      "https://www.geonames.org/712423/berehove.html\n",
      "https://www.geonames.org/688746/vynohradiv.html\n"
     ]
    },
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "https://www.geonames.org/3079336/bilovec.html\n",
      "https://www.geonames.org/3061186/banska-bystrica.html\n",
      "https://www.geonames.org/720568/gelenes.html\n",
      "https://www.geonames.org/712023/bobovo.html\n",
      "https://www.geonames.org/723358/trebisov.html\n",
      "https://www.geonames.org/3057140/trencin.html\n",
      "https://www.geonames.org/691650/ternopil.html\n",
      "https://www.geonames.org/761168/przemysl.html\n",
      "https://www.geonames.org/687869/zakarpattia-oblast.html\n",
      "https://www.geonames.org/3057197/tisovec.html\n",
      "https://www.geonames.org/3073803/karlovy-vary.html\n",
      "https://www.geonames.org/3078610/brno.html\n",
      "https://www.geonames.org/3058579/namestovo.html\n",
      "https://www.geonames.org/3075050/hostka.html\n",
      "https://www.geonames.org/704778/koson.html\n",
      "https://www.geonames.org/3056940/velicna.html\n",
      "https://www.geonames.org/3067580/prerov.html\n",
      "https://www.geonames.org/770237/jata.html\n",
      "https://www.geonames.org/3063886/tuchyne.html\n",
      "https://www.geonames.org/3043293/vac.html\n",
      "https://www.geonames.org/692431/stremil-che.html\n",
      "https://www.geonames.org/766301/limanowa.html\n",
      "https://www.geonames.org/3101547/chrzanow.html\n",
      "https://www.geonames.org/3058531/nitra.html\n",
      "https://www.geonames.org/721246/edeleny.html\n",
      "https://www.geonames.org/2911298/hamburg.html\n",
      "https://www.geonames.org/717497/mucsony.html\n",
      "https://www.geonames.org/711887/bohorodchany.html\n",
      "https://www.geonames.org/281184/jerusalem.html\n",
      "https://www.geonames.org/3044685/szente.html\n",
      "https://www.geonames.org/700033/nyzhankovychy.html\n",
      "https://www.geonames.org/721239/eger.html\n",
      "https://www.geonames.org/756135/warsaw.html\n",
      "https://www.geonames.org/3058952/luzianky.html\n",
      "https://www.geonames.org/3049880/kiskunhalas.html\n",
      "https://www.geonames.org/765681/lutowiska.html\n",
      "https://www.geonames.org/721428/derecske.html\n",
      "https://www.geonames.org/715839/satoraljaujhely.html\n",
      "https://www.geonames.org/2781024/deutschkreutz.html\n",
      "https://www.geonames.org/758436/stanislawczyk.html\n",
      "https://www.geonames.org/723975/opina.html\n",
      "https://www.geonames.org/3056835/velky-grob.html\n",
      "https://www.geonames.org/3061059/blatne.html\n",
      "https://www.geonames.org/3058674/mocenok.html\n",
      "https://www.geonames.org/3060808/cataj.html\n",
      "https://www.geonames.org/3056847/velke-zlievce.html\n",
      "https://www.geonames.org/3060241/filakovske-klacany.html\n",
      "https://www.geonames.org/3061176/bardonovo.html\n",
      "https://www.geonames.org/724752/haligovce.html\n"
     ]
    }
   ],
   "source": [
    "#for index, row in geodf.iterrows(): # if running with iterrows, you need to access the fields via their names, such as row['Geonames']\n",
    "for row in gnamesdf.head(5000).itertuples():\n",
    "    print(row[1])\n",
    "        \n",
    "    # extract Geonames ID\n",
    "    if row[1].startswith('https://www.geonames.org/'):\n",
    "        gid = row[1].split('/')[3]\n",
    "        \n",
    "        # check if the Geonames record is already in Arangodb\n",
    "        try:\n",
    "            olddoc = coll[gid]\n",
    "        except:\n",
    "            rdfurl = 'https://sws.geonames.org/' + gid + '/about.rdf'\n",
    "            rdf = urlopen(rdfurl)\n",
    "            rdfjson = xmltodict.parse(rdf)\n",
    "\n",
    "            # insert full json to Arango\n",
    "            doc = coll.createDocument(rdfjson)\n",
    "            doc._key = gid\n",
    "            doc.save()"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 36,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "https://www.geonames.org/3068927/opava.html\n",
      "lat: 49.93866, lon: 17.90257\n",
      "https://www.geonames.org/719819/hungary.html\n",
      "lat: 47, lon: 20\n",
      "https://www.geonames.org/798544/republic-of-poland.html\n",
      "lat: 52, lon: 20\n",
      "https://www.geonames.org/776458/baligrod.html\n",
      "lat: 49.3309, lon: 22.28566\n",
      "https://www.geonames.org/723010/aggtelek.html\n",
      "lat: 48.46667, lon: 20.51667\n",
      "https://www.geonames.org/2917509/gribow.html\n",
      "lat: 53.94841, lon: 13.48932\n",
      "https://www.geonames.org/723846/poprad.html\n",
      "lat: 49.06144, lon: 20.29798\n",
      "https://www.geonames.org/8505031/czechoslovakia.html\n",
      "lat: 50.08292, lon: 14.46672\n",
      "https://www.geonames.org/2761369/vienna.html\n",
      "lat: 48.20849, lon: 16.37208\n",
      "https://www.geonames.org/3058472/nove-zamky.html\n",
      "lat: 47.98544, lon: 18.16195\n",
      "https://www.geonames.org/724377/krompachy.html\n",
      "lat: 48.91447, lon: 20.87514\n",
      "https://www.geonames.org/667227/sighetu-marmatiei.html\n",
      "lat: 47.93195, lon: 23.88603\n",
      "https://www.geonames.org/3059448/kolarovo.html\n",
      "lat: 47.92294, lon: 17.98467\n",
      "https://www.geonames.org/798549/romania.html\n",
      "lat: 46, lon: 25\n",
      "https://www.geonames.org/3059101/levice.html\n",
      "lat: 48.21563, lon: 18.60705\n",
      "https://www.geonames.org/2921044/federal-republic-of-germany.html\n",
      "lat: 51.5, lon: 10.5\n",
      "https://www.geonames.org/723090/zborov.html\n",
      "lat: 49.36871, lon: 21.308\n",
      "https://www.geonames.org/707559/irshava.html\n",
      "lat: 48.31227, lon: 23.04065\n",
      "https://www.geonames.org/706173/khudl-ovo.html\n",
      "lat: 48.58638, lon: 22.4782\n",
      "https://www.geonames.org/2782113/republic-of-austria.html\n",
      "lat: 47.33333, lon: 13.33333\n",
      "https://www.geonames.org/3057141/trencianske-teplice.html\n",
      "lat: 48.91063, lon: 18.16691\n",
      "https://www.geonames.org/3043470/neu-pest.html\n",
      "lat: 47.56863, lon: 19.08456\n",
      "https://www.geonames.org/690548/uzhgorod.html\n",
      "lat: 48.6242, lon: 22.2947\n",
      "https://www.geonames.org/3059646/jelka.html\n",
      "lat: 48.14545, lon: 17.51126\n",
      "https://www.geonames.org/772857/dukla.html\n",
      "lat: 49.55554, lon: 21.68317\n",
      "https://www.geonames.org/723529/spisska-bela.html\n",
      "lat: 49.18725, lon: 20.45948\n",
      "https://www.geonames.org/763992/niedzica.html\n",
      "lat: 49.41008, lon: 20.30273\n",
      "https://www.geonames.org/757029/tarnogrod.html\n",
      "lat: 50.3609, lon: 22.74174\n",
      "https://www.geonames.org/666475/somcuta-mare.html\n",
      "lat: 47.51667, lon: 23.46667\n",
      "https://www.geonames.org/3060812/casta.html\n",
      "lat: 48.3992, lon: 17.36349\n",
      "https://www.geonames.org/706165/khust.html\n",
      "lat: 48.17193, lon: 23.29791\n",
      "https://www.geonames.org/724641/hrlica.html\n",
      "lat: 48.62823, lon: 20.05101\n",
      "https://www.geonames.org/3056711/vrable.html\n",
      "lat: 48.24371, lon: 18.30846\n",
      "https://www.geonames.org/725011/cecehov.html\n",
      "lat: 48.72478, lon: 21.98987\n",
      "https://www.geonames.org/724255/lucivna.html\n",
      "lat: 49.05152, lon: 20.14242\n",
      "https://www.geonames.org/3060219/galanta.html\n",
      "lat: 48.19001, lon: 17.72747\n",
      "https://www.geonames.org/3077882/cesky-tesin.html\n",
      "lat: 49.74613, lon: 18.62613\n",
      "https://www.geonames.org/682716/carasova.html\n",
      "lat: 45.19861, lon: 21.87\n",
      "https://www.geonames.org/763523/nowy-targ.html\n",
      "lat: 49.47783, lon: 20.03228\n",
      "https://www.geonames.org/699982/nyzhni-vorota.html\n",
      "lat: 48.77103, lon: 23.09775\n",
      "https://www.geonames.org/3081859/wisnicze.html\n",
      "lat: 50.49476, lon: 18.56123\n",
      "https://www.geonames.org/725008/cejkov.html\n",
      "lat: 48.46633, lon: 21.76051\n",
      "https://www.geonames.org/3059438/kolta.html\n",
      "lat: 48.01742, lon: 18.41244\n",
      "https://www.geonames.org/3056937/velka-bytca.html\n",
      "lat: 49.21667, lon: 18.56667\n",
      "https://www.geonames.org/3061017/bojna.html\n",
      "lat: 48.5752, lon: 18.05512\n",
      "https://www.geonames.org/3060308/dunajska-streda.html\n",
      "lat: 47.99268, lon: 17.61211\n",
      "https://www.geonames.org/755889/wieliczka.html\n",
      "lat: 49.98738, lon: 20.06473\n",
      "https://www.geonames.org/725017/cana.html\n",
      "lat: 48.60994, lon: 21.32622\n",
      "https://www.geonames.org/2762157/murau.html\n",
      "lat: 47.11056, lon: 14.16944\n",
      "https://www.geonames.org/3058663/modra.html\n",
      "lat: 48.33397, lon: 17.30711\n",
      "https://www.geonames.org/3058018/pribeta.html\n",
      "lat: 47.89977, lon: 18.31505\n",
      "https://www.geonames.org/2017370/russian-federation.html\n",
      "lat: 60, lon: 100\n",
      "https://www.geonames.org/693791/synevyr.html\n",
      "lat: 48.49947, lon: 23.62179\n",
      "https://www.geonames.org/774116/ciezkowice.html\n",
      "lat: 49.78575, lon: 20.97324\n",
      "https://www.geonames.org/3080866/zakopane.html\n",
      "lat: 49.29899, lon: 19.94885\n",
      "https://www.geonames.org/3078773/breclav.html\n",
      "lat: 48.75897, lon: 16.88203\n",
      "https://www.geonames.org/723879/plesivec.html\n",
      "lat: 48.5458, lon: 20.40218\n",
      "https://www.geonames.org/3054643/budapest.html\n",
      "lat: 47.49835, lon: 19.04045\n",
      "https://www.geonames.org/3077584/chrastava.html\n",
      "lat: 50.81693, lon: 14.96884\n",
      "https://www.geonames.org/3056547/zeliezovce.html\n",
      "lat: 48.05075, lon: 18.65421\n",
      "https://www.geonames.org/724247/luhyna.html\n",
      "lat: 48.49057, lon: 21.63587\n",
      "https://www.geonames.org/724443/kosice.html\n",
      "lat: 48.71395, lon: 21.25808\n",
      "https://www.geonames.org/682685/carei.html\n",
      "lat: 47.68333, lon: 22.46667\n",
      "https://www.geonames.org/764276/mszana-dolna.html\n",
      "lat: 49.67432, lon: 20.07992\n",
      "https://www.geonames.org/723365/tornala.html\n",
      "lat: 48.41915, lon: 20.32566\n",
      "https://www.geonames.org/3101321/cieszyn.html\n",
      "lat: 49.75133, lon: 18.63213\n",
      "https://www.geonames.org/724305/leles.html\n",
      "lat: 48.46303, lon: 22.02898\n",
      "https://www.geonames.org/3059436/komarno.html\n",
      "lat: 47.76356, lon: 18.12263\n",
      "https://www.geonames.org/3059972/horne-saliby.html\n",
      "lat: 48.12311, lon: 17.7589\n",
      "https://www.geonames.org/724330/ladmovce.html\n",
      "lat: 48.41369, lon: 21.78052\n",
      "https://www.geonames.org/706510/kernitsa.html\n",
      "lat: 49.76667, lon: 23.71667\n",
      "https://www.geonames.org/716247/putnok.html\n",
      "lat: 48.3, lon: 20.43333\n",
      "https://www.geonames.org/3070593/miroslav.html\n",
      "lat: 48.94767, lon: 16.31252\n",
      "https://www.geonames.org/3074459/jaromerice-nad-rokytnou.html\n",
      "lat: 49.09408, lon: 15.89331\n",
      "https://www.geonames.org/3067770/postoloprty.html\n",
      "lat: 50.35979, lon: 13.70291\n",
      "https://www.geonames.org/725168/bardejov.html\n",
      "lat: 49.29175, lon: 21.27271\n",
      "https://www.geonames.org/686902/znyats-ovo.html\n",
      "lat: 48.48426, lon: 22.51467\n",
      "https://www.geonames.org/700646/mukacheve.html\n",
      "lat: 48.44248, lon: 22.718\n",
      "https://www.geonames.org/724623/huncovce.html\n",
      "lat: 49.11501, lon: 20.37672\n",
      "https://www.geonames.org/3050616/kaposvar.html\n",
      "lat: 46.36667, lon: 17.8\n",
      "https://www.geonames.org/723736/rimavska-sobota.html\n",
      "lat: 48.38284, lon: 20.02239\n",
      "https://www.geonames.org/724248/lucky.html\n",
      "lat: 48.76694, lon: 22.0389\n",
      "https://www.geonames.org/3060208/gbely.html\n",
      "lat: 48.718, lon: 17.11628\n",
      "https://www.geonames.org/3076127/frydek-mistek.html\n",
      "lat: 49.68333, lon: 18.35\n",
      "https://www.geonames.org/772467/frydman.html\n",
      "lat: 49.44927, lon: 20.22961\n",
      "https://www.geonames.org/758464/sromowce-wyzne.html\n",
      "lat: 49.40478, lon: 20.34062\n",
      "https://www.geonames.org/759591/sanok.html\n",
      "lat: 49.55573, lon: 22.2056\n",
      "https://www.geonames.org/8243822/tsyhanivtsi.html\n",
      "lat: 48.58667, lon: 22.38997\n",
      "https://www.geonames.org/2780190/eisenstadt.html\n",
      "lat: 47.84565, lon: 16.52327\n",
      "https://www.geonames.org/723505/stara-lubovna.html\n",
      "lat: 49.29859, lon: 20.6862\n",
      "https://www.geonames.org/3060972/bratislava.html\n",
      "lat: 48.14816, lon: 17.10674\n",
      "https://www.geonames.org/723839/porac.html\n",
      "lat: 48.88418, lon: 20.72387\n",
      "https://www.geonames.org/723314/upor.html\n",
      "lat: 48.57729, lon: 21.66865\n",
      "https://www.geonames.org/3058986/lucenec.html\n",
      "lat: 48.33249, lon: 19.66708\n",
      "https://www.geonames.org/712602/bilky.html\n",
      "lat: 48.32629, lon: 23.13811\n",
      "https://www.geonames.org/6252001/united-states.html\n",
      "lat: 39.76, lon: -98.5\n",
      "https://www.geonames.org/3046340/pilisvoeroesvar.html\n",
      "lat: 47.61386, lon: 18.90893\n",
      "https://www.geonames.org/3056515/veca.html\n",
      "lat: 48.16667, lon: 17.88333\n",
      "https://www.geonames.org/3058524/nitrianske-pravno.html\n",
      "lat: 48.86839, lon: 18.63364\n",
      "https://www.geonames.org/723705/rudnany.html\n",
      "lat: 48.8816, lon: 20.68015\n",
      "https://www.geonames.org/763534/nowy-sacz.html\n",
      "lat: 49.62177, lon: 20.69705\n",
      "https://www.geonames.org/3081368/wroclaw.html\n",
      "lat: 51.1, lon: 17.03333\n",
      "https://www.geonames.org/714548/totkomlos.html\n",
      "lat: 46.41667, lon: 20.73333\n",
      "https://www.geonames.org/3058210/pezinok.html\n",
      "lat: 48.28986, lon: 17.26664\n",
      "https://www.geonames.org/776597/augustow.html\n",
      "lat: 53.84321, lon: 22.97979\n",
      "https://www.geonames.org/665947/stramtura.html\n",
      "lat: 47.58082, lon: 25.68144\n",
      "https://www.geonames.org/689106/volovets.html\n",
      "lat: 48.7109, lon: 23.1851\n",
      "https://www.geonames.org/710719/chernivtsi.html\n",
      "lat: 48.29045, lon: 25.93241\n",
      "https://www.geonames.org/709516/dubove.html\n",
      "lat: 48.17473, lon: 23.88693\n",
      "https://www.geonames.org/664432/turt.html\n",
      "lat: 47.98333, lon: 23.21667\n",
      "https://www.geonames.org/3057422/straza.html\n",
      "lat: 49.22578, lon: 18.90782\n",
      "https://www.geonames.org/3056911/velka-mana.html\n",
      "lat: 48.15574, lon: 18.28909\n",
      "https://www.geonames.org/724503/kezmarok.html\n",
      "lat: 49.13571, lon: 20.43352\n",
      "https://www.geonames.org/711416/brody.html\n",
      "lat: 50.08791, lon: 25.15027\n",
      "https://www.geonames.org/771317/gruszow-wielki.html\n",
      "lat: 50.19163, lon: 21.03144\n",
      "https://www.geonames.org/3060654/cifer.html\n",
      "lat: 48.3175, lon: 17.48987\n",
      "https://www.geonames.org/3057374/sucany.html\n",
      "lat: 49.09988, lon: 18.99073\n",
      "https://www.geonames.org/785965/senta.html\n",
      "lat: 45.9275, lon: 20.07722\n",
      "https://www.geonames.org/724504/kesovce.html\n",
      "lat: 48.37523, lon: 20.35295\n",
      "https://www.geonames.org/3059375/kosecke-rovne.html\n",
      "lat: 48.96031, lon: 18.41115\n",
      "https://www.geonames.org/724265/lubica.html\n",
      "lat: 49.11667, lon: 20.45\n",
      "https://www.geonames.org/3069382/novy-bohumin.html\n",
      "lat: 49.91254, lon: 18.35792\n",
      "https://www.geonames.org/684179/borod.html\n",
      "lat: 46.98333, lon: 22.63333\n",
      "https://www.geonames.org/724411/kralovsky-chlmec.html\n",
      "lat: 48.42336, lon: 21.97944\n",
      "https://www.geonames.org/3060991/borsky-mikulas.html\n",
      "lat: 48.6309, lon: 17.21448\n",
      "https://www.geonames.org/724715/hermanovce.html\n",
      "lat: 49.04584, lon: 21.01629\n",
      "https://www.geonames.org/3064673/sumperk.html\n",
      "lat: 49.96528, lon: 16.97061\n",
      "https://www.geonames.org/688749/vylok.html\n",
      "lat: 48.11034, lon: 22.8389\n",
      "https://www.geonames.org/706483/kharkiv.html\n",
      "lat: 49.98081, lon: 36.25272\n",
      "https://www.geonames.org/3062465/vrbice.html\n",
      "lat: 49.88333, lon: 18.31667\n",
      "https://www.geonames.org/3058649/mojzesovo.html\n",
      "lat: 48.13333, lon: 18.23333\n",
      "https://www.geonames.org/723819/presov.html\n",
      "lat: 48.99839, lon: 21.23393\n",
      "https://www.geonames.org/3067953/pohorelice.html\n",
      "lat: 48.98119, lon: 16.52445\n",
      "https://www.geonames.org/715126/szolnok.html\n",
      "lat: 47.18333, lon: 20.2\n",
      "https://www.geonames.org/709505/nyzhnya-apsha.html\n",
      "lat: 48.00365, lon: 23.83286\n",
      "https://www.geonames.org/723521/spisske-bystre.html\n",
      "lat: 48.99113, lon: 20.24364\n",
      "https://www.geonames.org/723775/rakusy.html\n",
      "lat: 49.18844, lon: 20.38181\n",
      "https://www.geonames.org/707311/izky.html\n",
      "lat: 48.64992, lon: 23.36482\n",
      "https://www.geonames.org/690800/uhry.html\n",
      "lat: 49.72982, lon: 23.61574\n",
      "https://www.geonames.org/3058497/nova-bystrica.html\n",
      "lat: 49.34496, lon: 19.01446\n",
      "https://www.geonames.org/3057772/sahy.html\n",
      "lat: 48.07408, lon: 18.94946\n",
      "https://www.geonames.org/3056725/batorove-kosihy.html\n",
      "lat: 47.8294, lon: 18.42016\n",
      "https://www.geonames.org/3059716/janova-lehota.html\n",
      "lat: 48.65498, lon: 18.78375\n",
      "https://www.geonames.org/2950159/berlin.html\n",
      "lat: 52.52437, lon: 13.41053\n",
      "https://www.geonames.org/724534/kamenna-poruba.html\n",
      "lat: 48.84763, lon: 21.64909\n",
      "https://www.geonames.org/690863/tyushka.html\n",
      "lat: 48.56997, lon: 23.39103\n",
      "https://www.geonames.org/701299/mizhhirya.html\n",
      "lat: 48.52435, lon: 23.50091\n",
      "https://www.geonames.org/3059050/liptovsky-mikulas.html\n",
      "lat: 49.08061, lon: 19.62218\n",
      "https://www.geonames.org/725063/brutovce.html\n",
      "lat: 49.08585, lon: 20.77616\n",
      "https://www.geonames.org/3060035/horna-marikova.html\n",
      "lat: 49.24619, lon: 18.30917\n",
      "https://www.geonames.org/725040/busovce.html\n",
      "lat: 49.21781, lon: 20.48665\n",
      "https://www.geonames.org/3057124/trnava.html\n",
      "lat: 48.37741, lon: 17.58723\n",
      "https://www.geonames.org/775714/bogucice.html\n",
      "lat: 50.05813, lon: 20.49287\n",
      "https://www.geonames.org/693995/shklo.html\n",
      "lat: 49.95675, lon: 23.54408\n",
      "https://www.geonames.org/773569/dabrowa-tarnowska.html\n",
      "lat: 50.17462, lon: 20.98633\n",
      "https://www.geonames.org/3064995/straznice.html\n",
      "lat: 48.90102, lon: 17.3168\n",
      "https://www.geonames.org/3057630/skalica.html\n",
      "lat: 48.8449, lon: 17.22635\n",
      "https://www.geonames.org/723578/slovenska-ves.html\n",
      "lat: 49.22481, lon: 20.42511\n",
      "https://www.geonames.org/3056492/zlatna-na-ostrove.html\n",
      "lat: 47.76667, lon: 17.96667\n",
      "https://www.geonames.org/8243842/radvanka.html\n",
      "lat: 48.6151, lon: 22.33205\n",
      "https://www.geonames.org/3071961/liberec.html\n",
      "lat: 50.76711, lon: 15.05619\n",
      "https://www.geonames.org/723526/spisska-nova-ves.html\n",
      "lat: 48.94464, lon: 20.56153\n",
      "https://www.geonames.org/724301/lendak.html\n",
      "lat: 49.23441, lon: 20.35646\n",
      "https://www.geonames.org/3058184/plastovce.html\n",
      "lat: 48.15897, lon: 18.97848\n",
      "https://www.geonames.org/690158/velyki-luchky.html\n",
      "lat: 48.41822, lon: 22.56765\n",
      "https://www.geonames.org/724144/michalovce.html\n",
      "lat: 48.75434, lon: 21.9195\n",
      "https://www.geonames.org/668974/remeti.html\n",
      "lat: 46.85, lon: 22.66667\n",
      "https://www.geonames.org/3060446/dolne-pribelce.html\n",
      "lat: 48.19544, lon: 19.26116\n",
      "https://www.geonames.org/3057692/senec.html\n",
      "lat: 48.21951, lon: 17.40043\n",
      "https://www.geonames.org/719280/kek.html\n",
      "lat: 48.11667, lon: 21.88333\n",
      "https://www.geonames.org/765042/mecina.html\n",
      "lat: 49.67851, lon: 20.5549\n",
      "https://www.geonames.org/3059107/lest.html\n",
      "lat: 48.35, lon: 19.31667\n",
      "https://www.geonames.org/3056873/velke-kozmalovce.html\n",
      "lat: 48.27049, lon: 18.54145\n",
      "https://www.geonames.org/712423/berehove.html\n",
      "lat: 48.20514, lon: 22.64453\n",
      "https://www.geonames.org/688746/vynohradiv.html\n",
      "lat: 48.14126, lon: 23.03623\n",
      "https://www.geonames.org/3079336/bilovec.html\n",
      "lat: 49.75639, lon: 18.01581\n",
      "https://www.geonames.org/3061186/banska-bystrica.html\n",
      "lat: 48.73946, lon: 19.15349\n",
      "https://www.geonames.org/720568/gelenes.html\n",
      "lat: 48.2, lon: 22.45175\n",
      "https://www.geonames.org/712023/bobovo.html\n",
      "lat: 48.07166, lon: 22.89585\n",
      "https://www.geonames.org/723358/trebisov.html\n"
     ]
    },
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "lat: 48.62858, lon: 21.71954\n",
      "https://www.geonames.org/3057140/trencin.html\n",
      "lat: 48.89452, lon: 18.04436\n",
      "https://www.geonames.org/691650/ternopil.html\n",
      "lat: 49.55404, lon: 25.59067\n",
      "https://www.geonames.org/761168/przemysl.html\n",
      "lat: 49.78498, lon: 22.76728\n",
      "https://www.geonames.org/687869/zakarpattia-oblast.html\n",
      "lat: 48.62645, lon: 22.28871\n",
      "https://www.geonames.org/3057197/tisovec.html\n",
      "lat: 48.67738, lon: 19.94364\n",
      "https://www.geonames.org/3073803/karlovy-vary.html\n",
      "lat: 50.23271, lon: 12.87117\n",
      "https://www.geonames.org/3078610/brno.html\n",
      "lat: 49.19522, lon: 16.60796\n",
      "https://www.geonames.org/3058579/namestovo.html\n",
      "lat: 49.4079, lon: 19.48032\n",
      "https://www.geonames.org/3075050/hostka.html\n",
      "lat: 49.69619, lon: 12.59745\n",
      "https://www.geonames.org/704778/koson.html\n",
      "lat: 48.25482, lon: 22.45896\n",
      "https://www.geonames.org/3056940/velicna.html\n",
      "lat: 49.20704, lon: 19.24725\n",
      "https://www.geonames.org/3067580/prerov.html\n",
      "lat: 49.45511, lon: 17.4509\n",
      "https://www.geonames.org/770237/jata.html\n",
      "lat: 50.3927, lon: 22.07353\n",
      "https://www.geonames.org/3063886/tuchyne.html\n",
      "lat: 49.80324, lon: 14.50007\n",
      "https://www.geonames.org/3043293/vac.html\n",
      "lat: 47.77591, lon: 19.13612\n",
      "https://www.geonames.org/692431/stremil-che.html\n",
      "lat: 50.34071, lon: 25.04941\n",
      "https://www.geonames.org/766301/limanowa.html\n",
      "lat: 49.70594, lon: 20.42204\n",
      "https://www.geonames.org/3101547/chrzanow.html\n",
      "lat: 50.13546, lon: 19.40203\n",
      "https://www.geonames.org/3058531/nitra.html\n",
      "lat: 48.30763, lon: 18.08453\n",
      "https://www.geonames.org/721246/edeleny.html\n",
      "lat: 48.3, lon: 20.73333\n",
      "https://www.geonames.org/2911298/hamburg.html\n",
      "lat: 53.55073, lon: 9.99302\n",
      "https://www.geonames.org/717497/mucsony.html\n",
      "lat: 48.26667, lon: 20.68333\n",
      "https://www.geonames.org/711887/bohorodchany.html\n",
      "lat: 48.80812, lon: 24.53728\n",
      "https://www.geonames.org/281184/jerusalem.html\n",
      "lat: 31.76904, lon: 35.21633\n",
      "https://www.geonames.org/3044685/szente.html\n",
      "lat: 47.9664, lon: 19.28745\n",
      "https://www.geonames.org/700033/nyzhankovychy.html\n",
      "lat: 49.6797, lon: 22.8117\n",
      "https://www.geonames.org/721239/eger.html\n",
      "lat: 47.90265, lon: 20.37329\n",
      "https://www.geonames.org/756135/warsaw.html\n",
      "lat: 52.22977, lon: 21.01178\n",
      "https://www.geonames.org/3058952/luzianky.html\n",
      "lat: 48.34908, lon: 18.029\n",
      "https://www.geonames.org/3049880/kiskunhalas.html\n",
      "lat: 46.43402, lon: 19.48479\n",
      "https://www.geonames.org/765681/lutowiska.html\n",
      "lat: 49.25318, lon: 22.69252\n",
      "https://www.geonames.org/721428/derecske.html\n",
      "lat: 47.35, lon: 21.56667\n",
      "https://www.geonames.org/715839/satoraljaujhely.html\n",
      "lat: 48.39492, lon: 21.65871\n",
      "https://www.geonames.org/2781024/deutschkreutz.html\n",
      "lat: 47.6, lon: 16.63333\n",
      "https://www.geonames.org/758436/stanislawczyk.html\n",
      "lat: 49.72429, lon: 22.83382\n",
      "https://www.geonames.org/723975/opina.html\n",
      "lat: 48.85437, lon: 21.42701\n",
      "https://www.geonames.org/3056835/velky-grob.html\n",
      "lat: 48.24973, lon: 17.49613\n",
      "https://www.geonames.org/3061059/blatne.html\n",
      "lat: 48.2666, lon: 17.41919\n",
      "https://www.geonames.org/3058674/mocenok.html\n",
      "lat: 48.22774, lon: 17.93075\n",
      "https://www.geonames.org/3060808/cataj.html\n",
      "lat: 48.27049, lon: 17.47873\n",
      "https://www.geonames.org/3056847/velke-zlievce.html\n",
      "lat: 48.19974, lon: 19.45582\n",
      "https://www.geonames.org/3060241/filakovske-klacany.html\n",
      "lat: 48.29032, lon: 19.75301\n",
      "https://www.geonames.org/3061176/bardonovo.html\n",
      "lat: 48.10874, lon: 18.422\n",
      "https://www.geonames.org/724752/haligovce.html\n",
      "lat: 49.36348, lon: 20.44776\n"
     ]
    }
   ],
   "source": [
    "domiciles = []\n",
    "for row in gnamesdf.head(5000).itertuples():\n",
    "    print(row[1])\n",
    "        \n",
    "    # extract Geonames ID\n",
    "    if row[1].startswith('https://www.geonames.org/'):\n",
    "        gid = row[1].split('/')[3]\n",
    "        \n",
    "        # check if the Geonames record is already in Arangodb\n",
    "        try:\n",
    "            olddoc = coll[gid]\n",
    "        except:\n",
    "            print(\"Error: Geonames record not in local database.\")\n",
    "        \n",
    "        lat = olddoc[\"rdf:RDF\"][\"gn:Feature\"][\"wgs84_pos:lat\"]\n",
    "        lon = olddoc[\"rdf:RDF\"][\"gn:Feature\"][\"wgs84_pos:long\"]\n",
    "        print(\"lat: \" + lat + \", lon: \" + lon)\n",
    "        domiciles.append([row[1], lat, lon])\n",
    "\n",
    "dom = np.array(domiciles)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 40,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/html": [
       "<div>\n",
       "<style scoped>\n",
       "    .dataframe tbody tr th:only-of-type {\n",
       "        vertical-align: middle;\n",
       "    }\n",
       "\n",
       "    .dataframe tbody tr th {\n",
       "        vertical-align: top;\n",
       "    }\n",
       "\n",
       "    .dataframe thead th {\n",
       "        text-align: right;\n",
       "    }\n",
       "</style>\n",
       "<table border=\"1\" class=\"dataframe\">\n",
       "  <thead>\n",
       "    <tr style=\"text-align: right;\">\n",
       "      <th></th>\n",
       "      <th>domicile_geo</th>\n",
       "      <th>lat</th>\n",
       "      <th>lon</th>\n",
       "    </tr>\n",
       "  </thead>\n",
       "  <tbody>\n",
       "    <tr>\n",
       "      <th>0</th>\n",
       "      <td>https://www.geonames.org/3068927/opava.html</td>\n",
       "      <td>49.93866</td>\n",
       "      <td>17.90257</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>1</th>\n",
       "      <td>https://www.geonames.org/719819/hungary.html</td>\n",
       "      <td>47</td>\n",
       "      <td>20</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>2</th>\n",
       "      <td>https://www.geonames.org/798544/republic-of-po...</td>\n",
       "      <td>52</td>\n",
       "      <td>20</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>3</th>\n",
       "      <td>https://www.geonames.org/776458/baligrod.html</td>\n",
       "      <td>49.3309</td>\n",
       "      <td>22.28566</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>4</th>\n",
       "      <td>https://www.geonames.org/723010/aggtelek.html</td>\n",
       "      <td>48.46667</td>\n",
       "      <td>20.51667</td>\n",
       "    </tr>\n",
       "  </tbody>\n",
       "</table>\n",
       "</div>"
      ],
      "text/plain": [
       "                                        domicile_geo       lat       lon\n",
       "0        https://www.geonames.org/3068927/opava.html  49.93866  17.90257\n",
       "1       https://www.geonames.org/719819/hungary.html        47        20\n",
       "2  https://www.geonames.org/798544/republic-of-po...        52        20\n",
       "3      https://www.geonames.org/776458/baligrod.html   49.3309  22.28566\n",
       "4      https://www.geonames.org/723010/aggtelek.html  48.46667  20.51667"
      ]
     },
     "execution_count": 40,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "domdf = pd.DataFrame(dom, columns = ['domicile_geo','lat','lon'])\n",
    "domdf.head()"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 42,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/html": [
       "<div>\n",
       "<style scoped>\n",
       "    .dataframe tbody tr th:only-of-type {\n",
       "        vertical-align: middle;\n",
       "    }\n",
       "\n",
       "    .dataframe tbody tr th {\n",
       "        vertical-align: top;\n",
       "    }\n",
       "\n",
       "    .dataframe thead th {\n",
       "        text-align: right;\n",
       "    }\n",
       "</style>\n",
       "<table border=\"1\" class=\"dataframe\">\n",
       "  <thead>\n",
       "    <tr style=\"text-align: right;\">\n",
       "      <th></th>\n",
       "      <th>location</th>\n",
       "      <th>domicile_citizenship</th>\n",
       "      <th>domicile_geo</th>\n",
       "      <th>lat</th>\n",
       "      <th>lon</th>\n",
       "    </tr>\n",
       "  </thead>\n",
       "  <tbody>\n",
       "    <tr>\n",
       "      <th>0</th>\n",
       "      <td>Žilina</td>\n",
       "      <td>Opava</td>\n",
       "      <td>https://www.geonames.org/3068927/opava.html</td>\n",
       "      <td>49.93866</td>\n",
       "      <td>17.90257</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>1</th>\n",
       "      <td>Žilina</td>\n",
       "      <td>Opava</td>\n",
       "      <td>https://www.geonames.org/3068927/opava.html</td>\n",
       "      <td>49.93866</td>\n",
       "      <td>17.90257</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>2</th>\n",
       "      <td>Trenčín</td>\n",
       "      <td>Opava</td>\n",
       "      <td>https://www.geonames.org/3068927/opava.html</td>\n",
       "      <td>49.93866</td>\n",
       "      <td>17.90257</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>3</th>\n",
       "      <td>Žilina</td>\n",
       "      <td>Opava</td>\n",
       "      <td>https://www.geonames.org/3068927/opava.html</td>\n",
       "      <td>49.93866</td>\n",
       "      <td>17.90257</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>4</th>\n",
       "      <td>Trenčín</td>\n",
       "      <td>Opava</td>\n",
       "      <td>https://www.geonames.org/3068927/opava.html</td>\n",
       "      <td>49.93866</td>\n",
       "      <td>17.90257</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>...</th>\n",
       "      <td>...</td>\n",
       "      <td>...</td>\n",
       "      <td>...</td>\n",
       "      <td>...</td>\n",
       "      <td>...</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>2044</th>\n",
       "      <td>Čataj</td>\n",
       "      <td>Čataj</td>\n",
       "      <td>https://www.geonames.org/3060808/cataj.html</td>\n",
       "      <td>48.27049</td>\n",
       "      <td>17.47873</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>2045</th>\n",
       "      <td>Modrý Kameň</td>\n",
       "      <td>Veľ. Zlievce, okr. Modrý Kameň</td>\n",
       "      <td>https://www.geonames.org/3056847/velke-zlievce...</td>\n",
       "      <td>48.19974</td>\n",
       "      <td>19.45582</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>2046</th>\n",
       "      <td>Modrý Kameň</td>\n",
       "      <td>Filak. Klačany, okr. Lučenec</td>\n",
       "      <td>https://www.geonames.org/3060241/filakovske-kl...</td>\n",
       "      <td>48.29032</td>\n",
       "      <td>19.75301</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>2047</th>\n",
       "      <td>Modrý Kameň</td>\n",
       "      <td>Baračka, okr. Vráble</td>\n",
       "      <td>https://www.geonames.org/3061176/bardonovo.html</td>\n",
       "      <td>48.10874</td>\n",
       "      <td>18.422</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>2048</th>\n",
       "      <td>Vondrišiel</td>\n",
       "      <td>Haligovce, okr. Spišská Stará Ves</td>\n",
       "      <td>https://www.geonames.org/724752/haligovce.html</td>\n",
       "      <td>49.36348</td>\n",
       "      <td>20.44776</td>\n",
       "    </tr>\n",
       "  </tbody>\n",
       "</table>\n",
       "<p>2049 rows × 5 columns</p>\n",
       "</div>"
      ],
      "text/plain": [
       "         location               domicile_citizenship  \\\n",
       "0          Žilina                              Opava   \n",
       "1          Žilina                              Opava   \n",
       "2         Trenčín                              Opava   \n",
       "3          Žilina                              Opava   \n",
       "4         Trenčín                              Opava   \n",
       "...           ...                                ...   \n",
       "2044        Čataj                              Čataj   \n",
       "2045  Modrý Kameň     Veľ. Zlievce, okr. Modrý Kameň   \n",
       "2046  Modrý Kameň       Filak. Klačany, okr. Lučenec   \n",
       "2047  Modrý Kameň               Baračka, okr. Vráble   \n",
       "2048   Vondrišiel  Haligovce, okr. Spišská Stará Ves   \n",
       "\n",
       "                                           domicile_geo       lat       lon  \n",
       "0           https://www.geonames.org/3068927/opava.html  49.93866  17.90257  \n",
       "1           https://www.geonames.org/3068927/opava.html  49.93866  17.90257  \n",
       "2           https://www.geonames.org/3068927/opava.html  49.93866  17.90257  \n",
       "3           https://www.geonames.org/3068927/opava.html  49.93866  17.90257  \n",
       "4           https://www.geonames.org/3068927/opava.html  49.93866  17.90257  \n",
       "...                                                 ...       ...       ...  \n",
       "2044        https://www.geonames.org/3060808/cataj.html  48.27049  17.47873  \n",
       "2045  https://www.geonames.org/3056847/velke-zlievce...  48.19974  19.45582  \n",
       "2046  https://www.geonames.org/3060241/filakovske-kl...  48.29032  19.75301  \n",
       "2047    https://www.geonames.org/3061176/bardonovo.html  48.10874    18.422  \n",
       "2048     https://www.geonames.org/724752/haligovce.html  49.36348  20.44776  \n",
       "\n",
       "[2049 rows x 5 columns]"
      ]
     },
     "execution_count": 42,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "# Perform join with original table\n",
    "domicdf = pd.merge(geodf, domdf, on='domicile_geo')\n",
    "domicdf"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 85,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "<AxesSubplot:>"
      ]
     },
     "execution_count": 85,
     "metadata": {},
     "output_type": "execute_result"
    },
    {
     "data": {
      "image/png": "iVBORw0KGgoAAAANSUhEUgAAAlAAAABvCAYAAAAjUf4UAAAAOXRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjQuMywgaHR0cHM6Ly9tYXRwbG90bGliLm9yZy/MnkTPAAAACXBIWXMAAAsTAAALEwEAmpwYAAAOA0lEQVR4nO3df4wc5X3H8c/HZwMuTWpSuxac3Z6TEKdtLDBd4VZuUFRwnOAILiikuFHrNlFppCQKQiWcg6WiCOpLXGjSRiIlQOQKYkhbOBAmdYgc2qqq3exhiws/XBtwsC/GNiIuCTFgn7/9Y+fcvb3Zu5273Z293fdLsu7mmb3d57lnZ/2555l5xhEhAAAA1G5W3hUAAACYaQhQAAAAGRGgAAAAMiJAAQAAZESAAgAAyIgABQAAkNHsWh5ke56kuyS9T1JI+qSkPZIekNQjab+kj0fETyd6nvnz50dPT8+UKwsAANAsg4ODr0TEgrR9rmUdKNubJf1HRNxl+wxJvyTpi5JejYh+232SzomIGyd6nkKhEMViMXsLAABAx1vSt1XlqcWSXuxf07DXsz0YEYW0fZNO4dn+FUmXSLpbkiLirYg4JulKSZuTh22W1FuPygIAAFSqDE9SaUpsSd/WPKpT0zlQSyQdlfQt27ts32X7bEkLI+JQ8piXJS1sVCUBAEBnqzZfltf9VGoJULMlXSTpjohYLul1SX3lD4jSPGBqG2xfa7tou3j06NHp1hcAACB3tQSog5IORsTOZPufVQpUh22fK0nJ1yNpPxwRd0ZEISIKCxaknocFAAAwo0waoCLiZUkHbC9Nii6V9IykRyStS8rWSXq4ITUEAAAdzxnLG63WdaA+J+k+209JulDSX0vql7TK9l5JlyXbAAAAdfdi/5pxYanRV+FNpKZ1oCJit6S0y/gurWttAAAAqsgrLKVhJXIAAICMCFAAAAAZEaAAAAAyIkABAABkRIACAADIiAAFAACQEQEKAAAgIwIUAABARjUtpAkAGG/V7U9o75HXT2+f/2tn6/HrP1DX13jvTY/pjZH/v1f7WV3Wc7deXtfXAJAdI1AAkGJg17BW9m/Xkr6tWtm/XQO7hsfsrwxPkrT3yOtadfsTdatDZXiSpDdGQu+96bG6vQaAqWEECgAqDOwa1voHh3T8xIgkafjYca1/cEiS1Lu8W5LGhadR1cqnojI8TVYOoHkYgQKACpu27TkdnkYdPzGiTdv25FQjAK2GESgAqPCTY8czlU9HT9/W1PIuV953HkArYQQKACqcN2/upOWzZ6UHnGrlaaqFJ0kaierTdGd1Ea6AvBGgAKDCDauXau6crnHlw8eOnw49I6fSA0618nrhKjygNTCFBwAVRk8Uv+6B3an7e/q2qnveXA2nTOlVjl5tGBjSlp0HNBKhLltrVyzWLb3LMtVnf/+aTI8H0HiOCYaJ661QKESxWGza6wHAdEw0xfbVP7xwzJV6aRa+7Qwd/tlb06pDl63nNzLiBOTB9mBEFNL2MQIFAFN01pxZEwao6YYnqXQu1GiQW/mud+i+P/+91GDHKBXQXIxAAUAVE41AWVKrrcbUyBA1sGtYm7bt0U+OHdd58+bqhtVLT091Au2KESgAqLNWC0+NVMvCokCn4So8AKhipk2LVd5upl5YWBQYjxEoAJhAZYha0re1ZUefNm3b05ARoWYuLArMFIxAAUAG1RbZbAVpyyrUQy0LiwKdhgAFABlUW2SzVXzim/9V9+dMa/PcOV26YfXSur8WMFMwhQcAGYxOkW3atid1xCfvq/P+8/lX6/6c5W3mKjyghAAFABn1Lu+uukp5qD4LaLaa3uXdBCagDFN4AFBnr71RfXFNAO2BAAUAdTbR6uQA2gMBCgDaSDdXxgFNQYACgAaYN3eOuma5qa/JlXFA8xCgAGAKJlqlfO6cLt18xW/rtqsvaOqI0MarlnGiN9AkXIUHAFM0GqImutFu7/JurezfXpdFLud0WSdGqi+SQHgCmocABQDTNNkl/jesXjrmZrySNGeWdeJUthWjNn3sgqrLJwBoLqbwAKDBepd3a+NVy9Q9b66s0onem66+QG8/M9uK5owwAa3DEc1bM7dQKESxWGza6wFAq1tx6+M1L7o5OmXY07e16j4A9WN7MCIKafuYwgOAHO28adWY7Xev36qTKX/Xzi67oI+wBOSPKTwAaCH7Nq4ZE5akUnjat5HQBLQSRqAAoMUQloDWxwgUAABARgQoAACAjAhQAAAAGRGgAAAAMqo5QNnusr3L9qPJ9hLbO23vs/2A7TMaV00AAIDWkWUE6vOSni3b/rKkv42Id0v6qaRP1bNiAAAAraqmZQxsL5K0RtKtkq63bUl/IOmPkodslnSzpDsaUMeabBgY0padBzQSoS5ba1cs1i29y/KqDgAAaGO1jkB9VdIXJJ1Ktn9V0rGIOJlsH5SU202aNgwM6d4dL2kkuS3NSITu3fGSNgwM5VUlAADQxiYNULY/IulIRAxO5QVsX2u7aLt49OjRqTzFpLbsPJCpHAAAYDpqGYFaKekK2/sl3a/S1N3XJM2zPToFuEjScNoPR8SdEVGIiMKCBQvqUOXxRqrcELlaOQAAwHRMGqAiYn1ELIqIHknXSNoeEZ+Q9ANJH0setk7Sww2r5SS67EzlAAAA0zGddaBuVOmE8n0qnRN1d32qlN3aFYszlQMAAExHppsJR8QTkp5Ivn9B0sX1r1J2o1fbcRUeAABoBkcTzxMqFApRLBab9noAAABTZXswIgpp+7iVCwAAQEYEKAAAgIwIUAAAABkRoAAAADIiQAEAAGREgAIAAMiIAAUAAJARAQoAACAjAhQAAEBGBCgAAICMCFAAAAAZEaAAAAAymp13BQAArWnDwJC27DygkQh12Vq7YrFu6V2Wd7WAlkCAAgCMs2FgSPfueOn09kjE6W1CFMAUHgAgxZadBzKVA52GAAUAGGckIlM50GkIUACAcbrsTOVApyFAAQDGWbticaZyoNNwEjkAYJzRE8W5Cg9I52jifLbto5J+XOennS/plTo/50xC+2k/7e9ctJ/2d2r7m9X234iIBWk7mhqgGsF2MSIKedcjL7Sf9tN+2p93PfJC+zu3/a3Qds6BAgAAyIgABQAAkFE7BKg7865Azmh/Z6P9nY32d7ZObn/ubZ/x50ABAAA0WzuMQAEAADTVjApQtq+2/bTtU7YLFfvW295ne4/t1WXlH0rK9tnua36tG8P2A7Z3J//2296dlPfYPl627xs5V7UhbN9se7isnZeX7Ut9L7QT25tsP2f7KdsP2Z6XlHdK/7flcV2N7cW2f2D7meQz8PNJedXjoN0kn3NDSTuLSdk7bD9ue2/y9Zy869kItpeW9fFu26/Zvq6d+9/2PbaP2P5RWVlqf7vk75LPg6dsX9SUOs6kKTzbvynplKR/kPSXETF6EP2WpC2SLpZ0nqTvS3pP8mP/I2mVpIOSfihpbUQ80+SqN5Tt2yT9b0R8yXaPpEcj4n05V6uhbN8s6ecR8TcV5anvhYgYaXolG8j2ByVtj4iTtr8sSRFxYyf0v+0udcBxXc72uZLOjYgnbb9N0qCkXkkfV8px0I5s75dUiIhXysq+IunViOhPgvQ5EXFjXnVshuT9PyxphaQ/U5v2v+1LJP1c0j+Ofp5V6+8kOH5O0uUq/V6+FhErGl3HGTUCFRHPRsSelF1XSro/It6MiBcl7VPpP9CLJe2LiBci4i1J9yePbRu2rdKH6Ja869Iiqr0X2kpEfC8iTiabOyQtyrM+Tdb2x3WliDgUEU8m3/9M0rOSuvOtVUu4UtLm5PvNKoXKdneppOcjot6LUreUiPh3Sa9WFFfr7ytVCloRETskzUv+6GioGRWgJtAt6UDZ9sGkrFp5O3m/pMMRsbesbIntXbb/zfb786pYE3w2Ga69p2zovhP6vNInJX23bLvd+78T+/i0ZJRxuaSdSVHacdCOQtL3bA/avjYpWxgRh5LvX5a0MJ+qNdU1GvsHc6f0v1S9v3P5TGi5AGX7+7Z/lPKvrf/CTFPj72Ktxh5MhyT9ekQsl3S9pG/bfnsz610vk7T/DknvknShSm2+Lc+6NkIt/W/7JkknJd2XFLVN/2M8278s6V8kXRcRr6kDjoMyvx8RF0n6sKTPJFM8p0XpfJSZc07KFNg+Q9IVkv4pKeqk/h+jFfq75W4mHBGXTeHHhiWV3yJ8UVKmCcpb3mS/C9uzJV0l6XfKfuZNSW8m3w/afl6l88GKDaxqQ9T6XrD9TUmPJpsTvRdmlBr6/08lfUTSpcmHSVv1/wTapo+zsD1HpfB0X0Q8KEkRcbhsf/lx0HYiYjj5esT2QypN5R62fW5EHEqmbI7kWsnG+7CkJ0f7vZP6P1Gtv3P5TGi5EagpekTSNbbPtL1E0vmS/lulk0vPt70kSe7XJI9tF5dJei4iDo4W2F6QnGQo2+9U6XfxQk71a5iK+e2PShq9UqPae6Gt2P6QpC9IuiIiflFW3gn93+7H9TjJuY53S3o2Im4vK692HLQV22cnJ8/L9tmSPqhSWx+RtC552DpJD+dTw6YZM+PQKf1fplp/PyLpT5Kr8X5XpYuqDqU9QT213AjURGx/VNLfS1ogaavt3RGxOiKetv0dSc+oNJ3xmdGrrmx/VtI2SV2S7omIp3OqfiNUzoVL0iWSvmT7hEpXLH46IipPxGsHX7F9oUpDuPsl/YUkTfReaDNfl3SmpMdL/7dqR0R8Wh3Q/8mVh+18XKdZKemPJQ05WbJE0hclrU07DtrQQkkPJe/12ZK+HRH/avuHkr5j+1OSfqzSBTVtKQmOqzS2j1M/B9uB7S2SPiBpvu2Dkv5KUr/S+/sxla7A2yfpFypdndj4Os6kZQwAAABaQbtM4QEAADQNAQoAACAjAhQAAEBGBCgAAICMCFAAAAAZEaAAAAAyIkABAABkRIACAADI6P8AYr8Am9YJiYcAAAAASUVORK5CYII=\n",
      "text/plain": [
       "<Figure size 720x720 with 1 Axes>"
      ]
     },
     "metadata": {
      "needs_background": "light"
     },
     "output_type": "display_data"
    }
   ],
   "source": [
    "# Domiciles turned into Geopandas data frame\n",
    "domicgeodf = gpd.GeoDataFrame(\n",
    "    domicdf, geometry=gpd.points_from_xy(domicdf.lon, domicdf.lat))\n",
    "domicgeodf.plot()"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 84,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "<AxesSubplot:>"
      ]
     },
     "execution_count": 84,
     "metadata": {},
     "output_type": "execute_result"
    },
    {
     "data": {
      "image/png": "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\n",
      "text/plain": [
       "<Figure size 720x720 with 1 Axes>"
      ]
     },
     "metadata": {
      "needs_background": "light"
     },
     "output_type": "display_data"
    }
   ],
   "source": [
    "# Load border datasets to Geopandas\n",
    "b19380331 = gpd.read_file('/home/michal/michal.frankl@gmail.com/michal/GIS/borders19380331_corr.shp')\n",
    "#b19381130 = gpd.read_file('/home/michal/michal.frankl@gmail.com/michal/GIS/european_borders/November_30_1938.shp')\n",
    "b19381130 = gpd.read_file('/home/michal/michal.frankl@gmail.com/michal/GIS/borders19381130_corr.shp')\n",
    "b19381130.plot()"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 79,
   "metadata": {},
   "outputs": [],
   "source": [
    "# Projection has to be defined for the domicile table\n",
    "domicgeodf = domicgeodf.set_crs('EPSG:4326')"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 76,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/html": [
       "<div>\n",
       "<style scoped>\n",
       "    .dataframe tbody tr th:only-of-type {\n",
       "        vertical-align: middle;\n",
       "    }\n",
       "\n",
       "    .dataframe tbody tr th {\n",
       "        vertical-align: top;\n",
       "    }\n",
       "\n",
       "    .dataframe thead th {\n",
       "        text-align: right;\n",
       "    }\n",
       "</style>\n",
       "<table border=\"1\" class=\"dataframe\">\n",
       "  <thead>\n",
       "    <tr style=\"text-align: right;\">\n",
       "      <th></th>\n",
       "      <th>location</th>\n",
       "      <th>domicile_citizenship</th>\n",
       "      <th>domicile_geo</th>\n",
       "      <th>lat</th>\n",
       "      <th>lon</th>\n",
       "      <th>geometry</th>\n",
       "      <th>index_right</th>\n",
       "      <th>Name</th>\n",
       "      <th>Foreign_Po</th>\n",
       "      <th>Head_of_St</th>\n",
       "      <th>Govt_in_Ex</th>\n",
       "      <th>Shape_Leng</th>\n",
       "      <th>Shape_Area</th>\n",
       "    </tr>\n",
       "  </thead>\n",
       "  <tbody>\n",
       "    <tr>\n",
       "      <th>0</th>\n",
       "      <td>Žilina</td>\n",
       "      <td>Opava</td>\n",
       "      <td>https://www.geonames.org/3068927/opava.html</td>\n",
       "      <td>49.93866</td>\n",
       "      <td>17.90257</td>\n",
       "      <td>POINT (17.90257 49.93866)</td>\n",
       "      <td>36.0</td>\n",
       "      <td>Germany</td>\n",
       "      <td>&lt;Null&gt;</td>\n",
       "      <td>Adolf Hitler (F�hrer)</td>\n",
       "      <td>None</td>\n",
       "      <td>1.090608e+07</td>\n",
       "      <td>5.861791e+11</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>1</th>\n",
       "      <td>Žilina</td>\n",
       "      <td>Opava</td>\n",
       "      <td>https://www.geonames.org/3068927/opava.html</td>\n",
       "      <td>49.93866</td>\n",
       "      <td>17.90257</td>\n",
       "      <td>POINT (17.90257 49.93866)</td>\n",
       "      <td>36.0</td>\n",
       "      <td>Germany</td>\n",
       "      <td>&lt;Null&gt;</td>\n",
       "      <td>Adolf Hitler (F�hrer)</td>\n",
       "      <td>None</td>\n",
       "      <td>1.090608e+07</td>\n",
       "      <td>5.861791e+11</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>2</th>\n",
       "      <td>Trenčín</td>\n",
       "      <td>Opava</td>\n",
       "      <td>https://www.geonames.org/3068927/opava.html</td>\n",
       "      <td>49.93866</td>\n",
       "      <td>17.90257</td>\n",
       "      <td>POINT (17.90257 49.93866)</td>\n",
       "      <td>36.0</td>\n",
       "      <td>Germany</td>\n",
       "      <td>&lt;Null&gt;</td>\n",
       "      <td>Adolf Hitler (F�hrer)</td>\n",
       "      <td>None</td>\n",
       "      <td>1.090608e+07</td>\n",
       "      <td>5.861791e+11</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>3</th>\n",
       "      <td>Žilina</td>\n",
       "      <td>Opava</td>\n",
       "      <td>https://www.geonames.org/3068927/opava.html</td>\n",
       "      <td>49.93866</td>\n",
       "      <td>17.90257</td>\n",
       "      <td>POINT (17.90257 49.93866)</td>\n",
       "      <td>36.0</td>\n",
       "      <td>Germany</td>\n",
       "      <td>&lt;Null&gt;</td>\n",
       "      <td>Adolf Hitler (F�hrer)</td>\n",
       "      <td>None</td>\n",
       "      <td>1.090608e+07</td>\n",
       "      <td>5.861791e+11</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>4</th>\n",
       "      <td>Trenčín</td>\n",
       "      <td>Opava</td>\n",
       "      <td>https://www.geonames.org/3068927/opava.html</td>\n",
       "      <td>49.93866</td>\n",
       "      <td>17.90257</td>\n",
       "      <td>POINT (17.90257 49.93866)</td>\n",
       "      <td>36.0</td>\n",
       "      <td>Germany</td>\n",
       "      <td>&lt;Null&gt;</td>\n",
       "      <td>Adolf Hitler (F�hrer)</td>\n",
       "      <td>None</td>\n",
       "      <td>1.090608e+07</td>\n",
       "      <td>5.861791e+11</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>...</th>\n",
       "      <td>...</td>\n",
       "      <td>...</td>\n",
       "      <td>...</td>\n",
       "      <td>...</td>\n",
       "      <td>...</td>\n",
       "      <td>...</td>\n",
       "      <td>...</td>\n",
       "      <td>...</td>\n",
       "      <td>...</td>\n",
       "      <td>...</td>\n",
       "      <td>...</td>\n",
       "      <td>...</td>\n",
       "      <td>...</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>2044</th>\n",
       "      <td>Čataj</td>\n",
       "      <td>Čataj</td>\n",
       "      <td>https://www.geonames.org/3060808/cataj.html</td>\n",
       "      <td>48.27049</td>\n",
       "      <td>17.47873</td>\n",
       "      <td>POINT (17.47873 48.27049)</td>\n",
       "      <td>1.0</td>\n",
       "      <td>Czecho-Slovakia</td>\n",
       "      <td>None</td>\n",
       "      <td>Emil H�cha (President)</td>\n",
       "      <td>&lt;Null&gt;</td>\n",
       "      <td>3.970920e+06</td>\n",
       "      <td>9.770266e+10</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>2045</th>\n",
       "      <td>Modrý Kameň</td>\n",
       "      <td>Veľ. Zlievce, okr. Modrý Kameň</td>\n",
       "      <td>https://www.geonames.org/3056847/velke-zlievce...</td>\n",
       "      <td>48.19974</td>\n",
       "      <td>19.45582</td>\n",
       "      <td>POINT (19.45582 48.19974)</td>\n",
       "      <td>0.0</td>\n",
       "      <td>Hungary</td>\n",
       "      <td>&lt;Null&gt;</td>\n",
       "      <td>Mikl�s Horthy (Regent)</td>\n",
       "      <td>None</td>\n",
       "      <td>2.261526e+06</td>\n",
       "      <td>1.050275e+11</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>2046</th>\n",
       "      <td>Modrý Kameň</td>\n",
       "      <td>Filak. Klačany, okr. Lučenec</td>\n",
       "      <td>https://www.geonames.org/3060241/filakovske-kl...</td>\n",
       "      <td>48.29032</td>\n",
       "      <td>19.75301</td>\n",
       "      <td>POINT (19.75301 48.29032)</td>\n",
       "      <td>0.0</td>\n",
       "      <td>Hungary</td>\n",
       "      <td>&lt;Null&gt;</td>\n",
       "      <td>Mikl�s Horthy (Regent)</td>\n",
       "      <td>None</td>\n",
       "      <td>2.261526e+06</td>\n",
       "      <td>1.050275e+11</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>2047</th>\n",
       "      <td>Modrý Kameň</td>\n",
       "      <td>Baračka, okr. Vráble</td>\n",
       "      <td>https://www.geonames.org/3061176/bardonovo.html</td>\n",
       "      <td>48.10874</td>\n",
       "      <td>18.422</td>\n",
       "      <td>POINT (18.42200 48.10874)</td>\n",
       "      <td>0.0</td>\n",
       "      <td>Hungary</td>\n",
       "      <td>&lt;Null&gt;</td>\n",
       "      <td>Mikl�s Horthy (Regent)</td>\n",
       "      <td>None</td>\n",
       "      <td>2.261526e+06</td>\n",
       "      <td>1.050275e+11</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>2048</th>\n",
       "      <td>Vondrišiel</td>\n",
       "      <td>Haligovce, okr. Spišská Stará Ves</td>\n",
       "      <td>https://www.geonames.org/724752/haligovce.html</td>\n",
       "      <td>49.36348</td>\n",
       "      <td>20.44776</td>\n",
       "      <td>POINT (20.44776 49.36348)</td>\n",
       "      <td>1.0</td>\n",
       "      <td>Czecho-Slovakia</td>\n",
       "      <td>None</td>\n",
       "      <td>Emil H�cha (President)</td>\n",
       "      <td>&lt;Null&gt;</td>\n",
       "      <td>3.970920e+06</td>\n",
       "      <td>9.770266e+10</td>\n",
       "    </tr>\n",
       "  </tbody>\n",
       "</table>\n",
       "<p>2049 rows × 13 columns</p>\n",
       "</div>"
      ],
      "text/plain": [
       "         location               domicile_citizenship  \\\n",
       "0          Žilina                              Opava   \n",
       "1          Žilina                              Opava   \n",
       "2         Trenčín                              Opava   \n",
       "3          Žilina                              Opava   \n",
       "4         Trenčín                              Opava   \n",
       "...           ...                                ...   \n",
       "2044        Čataj                              Čataj   \n",
       "2045  Modrý Kameň     Veľ. Zlievce, okr. Modrý Kameň   \n",
       "2046  Modrý Kameň       Filak. Klačany, okr. Lučenec   \n",
       "2047  Modrý Kameň               Baračka, okr. Vráble   \n",
       "2048   Vondrišiel  Haligovce, okr. Spišská Stará Ves   \n",
       "\n",
       "                                           domicile_geo       lat       lon  \\\n",
       "0           https://www.geonames.org/3068927/opava.html  49.93866  17.90257   \n",
       "1           https://www.geonames.org/3068927/opava.html  49.93866  17.90257   \n",
       "2           https://www.geonames.org/3068927/opava.html  49.93866  17.90257   \n",
       "3           https://www.geonames.org/3068927/opava.html  49.93866  17.90257   \n",
       "4           https://www.geonames.org/3068927/opava.html  49.93866  17.90257   \n",
       "...                                                 ...       ...       ...   \n",
       "2044        https://www.geonames.org/3060808/cataj.html  48.27049  17.47873   \n",
       "2045  https://www.geonames.org/3056847/velke-zlievce...  48.19974  19.45582   \n",
       "2046  https://www.geonames.org/3060241/filakovske-kl...  48.29032  19.75301   \n",
       "2047    https://www.geonames.org/3061176/bardonovo.html  48.10874    18.422   \n",
       "2048     https://www.geonames.org/724752/haligovce.html  49.36348  20.44776   \n",
       "\n",
       "                       geometry  index_right             Name Foreign_Po  \\\n",
       "0     POINT (17.90257 49.93866)         36.0          Germany     <Null>   \n",
       "1     POINT (17.90257 49.93866)         36.0          Germany     <Null>   \n",
       "2     POINT (17.90257 49.93866)         36.0          Germany     <Null>   \n",
       "3     POINT (17.90257 49.93866)         36.0          Germany     <Null>   \n",
       "4     POINT (17.90257 49.93866)         36.0          Germany     <Null>   \n",
       "...                         ...          ...              ...        ...   \n",
       "2044  POINT (17.47873 48.27049)          1.0  Czecho-Slovakia       None   \n",
       "2045  POINT (19.45582 48.19974)          0.0          Hungary     <Null>   \n",
       "2046  POINT (19.75301 48.29032)          0.0          Hungary     <Null>   \n",
       "2047  POINT (18.42200 48.10874)          0.0          Hungary     <Null>   \n",
       "2048  POINT (20.44776 49.36348)          1.0  Czecho-Slovakia       None   \n",
       "\n",
       "                  Head_of_St Govt_in_Ex    Shape_Leng    Shape_Area  \n",
       "0      Adolf Hitler (F�hrer)       None  1.090608e+07  5.861791e+11  \n",
       "1      Adolf Hitler (F�hrer)       None  1.090608e+07  5.861791e+11  \n",
       "2      Adolf Hitler (F�hrer)       None  1.090608e+07  5.861791e+11  \n",
       "3      Adolf Hitler (F�hrer)       None  1.090608e+07  5.861791e+11  \n",
       "4      Adolf Hitler (F�hrer)       None  1.090608e+07  5.861791e+11  \n",
       "...                      ...        ...           ...           ...  \n",
       "2044  Emil H�cha (President)     <Null>  3.970920e+06  9.770266e+10  \n",
       "2045  Mikl�s Horthy (Regent)       None  2.261526e+06  1.050275e+11  \n",
       "2046  Mikl�s Horthy (Regent)       None  2.261526e+06  1.050275e+11  \n",
       "2047  Mikl�s Horthy (Regent)       None  2.261526e+06  1.050275e+11  \n",
       "2048  Emil H�cha (President)     <Null>  3.970920e+06  9.770266e+10  \n",
       "\n",
       "[2049 rows x 13 columns]"
      ]
     },
     "execution_count": 76,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "# Join domiciles with state borders (displays only a sample of resulting data frame)\n",
    "statesdom = domicgeodf.sjoin(b19381130, how=\"left\")\n",
    "statesdom"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Having joined the datasets spatially, we can group the records according to inter-war state borders."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 78,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "Name\n",
       "Czecho-Slovakia    353\n",
       "Germany            213\n",
       "Hungary            485\n",
       "Poland             862\n",
       "Romania            117\n",
       "Soviet Union         1\n",
       "Yugoslavia           5\n",
       "Name: domicile_citizenship, dtype: int64"
      ]
     },
     "execution_count": 78,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "statesdom.groupby(['Name'])['domicile_citizenship'].count()"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 100,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/html": [
       "<div>\n",
       "<style scoped>\n",
       "    .dataframe tbody tr th:only-of-type {\n",
       "        vertical-align: middle;\n",
       "    }\n",
       "\n",
       "    .dataframe tbody tr th {\n",
       "        vertical-align: top;\n",
       "    }\n",
       "\n",
       "    .dataframe thead th {\n",
       "        text-align: right;\n",
       "    }\n",
       "</style>\n",
       "<table border=\"1\" class=\"dataframe\">\n",
       "  <thead>\n",
       "    <tr style=\"text-align: right;\">\n",
       "      <th></th>\n",
       "      <th>location</th>\n",
       "      <th>domicile_citizenship</th>\n",
       "      <th>domicile_geo</th>\n",
       "      <th>lat</th>\n",
       "      <th>lon</th>\n",
       "      <th>geometry</th>\n",
       "      <th>Name_left</th>\n",
       "      <th>Foreign_Po_left</th>\n",
       "      <th>Head_of_St_left</th>\n",
       "      <th>Govt_in_Ex_left</th>\n",
       "      <th>Shape_Leng_left</th>\n",
       "      <th>Shape_Area_left</th>\n",
       "      <th>index_right</th>\n",
       "      <th>Name_right</th>\n",
       "      <th>Foreign_Po_right</th>\n",
       "      <th>Head_of_St_right</th>\n",
       "      <th>Govt_in_Ex_right</th>\n",
       "      <th>Shape_Leng_right</th>\n",
       "      <th>Shape_Area_right</th>\n",
       "    </tr>\n",
       "  </thead>\n",
       "  <tbody>\n",
       "    <tr>\n",
       "      <th>1158</th>\n",
       "      <td>Trenčín</td>\n",
       "      <td>Nové Zámky</td>\n",
       "      <td>https://www.geonames.org/3058472/nove-zamky.html</td>\n",
       "      <td>47.98544</td>\n",
       "      <td>18.16195</td>\n",
       "      <td>POINT (18.16195 47.98544)</td>\n",
       "      <td>Hungary</td>\n",
       "      <td>&lt;Null&gt;</td>\n",
       "      <td>Mikl�s Horthy (Regent)</td>\n",
       "      <td>None</td>\n",
       "      <td>2.261526e+06</td>\n",
       "      <td>1.050275e+11</td>\n",
       "      <td>32</td>\n",
       "      <td>Czechoslovakia</td>\n",
       "      <td>None</td>\n",
       "      <td>Edvard Bene� (President)</td>\n",
       "      <td>None</td>\n",
       "      <td>3.636117e+06</td>\n",
       "      <td>1.405859e+11</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>1159</th>\n",
       "      <td>Trenčín</td>\n",
       "      <td>Nové Zámky</td>\n",
       "      <td>https://www.geonames.org/3058472/nove-zamky.html</td>\n",
       "      <td>47.98544</td>\n",
       "      <td>18.16195</td>\n",
       "      <td>POINT (18.16195 47.98544)</td>\n",
       "      <td>Hungary</td>\n",
       "      <td>&lt;Null&gt;</td>\n",
       "      <td>Mikl�s Horthy (Regent)</td>\n",
       "      <td>None</td>\n",
       "      <td>2.261526e+06</td>\n",
       "      <td>1.050275e+11</td>\n",
       "      <td>32</td>\n",
       "      <td>Czechoslovakia</td>\n",
       "      <td>None</td>\n",
       "      <td>Edvard Bene� (President)</td>\n",
       "      <td>None</td>\n",
       "      <td>3.636117e+06</td>\n",
       "      <td>1.405859e+11</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>1160</th>\n",
       "      <td>Trenčín</td>\n",
       "      <td>Nové Zámky</td>\n",
       "      <td>https://www.geonames.org/3058472/nove-zamky.html</td>\n",
       "      <td>47.98544</td>\n",
       "      <td>18.16195</td>\n",
       "      <td>POINT (18.16195 47.98544)</td>\n",
       "      <td>Hungary</td>\n",
       "      <td>&lt;Null&gt;</td>\n",
       "      <td>Mikl�s Horthy (Regent)</td>\n",
       "      <td>None</td>\n",
       "      <td>2.261526e+06</td>\n",
       "      <td>1.050275e+11</td>\n",
       "      <td>32</td>\n",
       "      <td>Czechoslovakia</td>\n",
       "      <td>None</td>\n",
       "      <td>Edvard Bene� (President)</td>\n",
       "      <td>None</td>\n",
       "      <td>3.636117e+06</td>\n",
       "      <td>1.405859e+11</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>1161</th>\n",
       "      <td>Trenčín</td>\n",
       "      <td>Nové Zámky</td>\n",
       "      <td>https://www.geonames.org/3058472/nove-zamky.html</td>\n",
       "      <td>47.98544</td>\n",
       "      <td>18.16195</td>\n",
       "      <td>POINT (18.16195 47.98544)</td>\n",
       "      <td>Hungary</td>\n",
       "      <td>&lt;Null&gt;</td>\n",
       "      <td>Mikl�s Horthy (Regent)</td>\n",
       "      <td>None</td>\n",
       "      <td>2.261526e+06</td>\n",
       "      <td>1.050275e+11</td>\n",
       "      <td>32</td>\n",
       "      <td>Czechoslovakia</td>\n",
       "      <td>None</td>\n",
       "      <td>Edvard Bene� (President)</td>\n",
       "      <td>None</td>\n",
       "      <td>3.636117e+06</td>\n",
       "      <td>1.405859e+11</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>1162</th>\n",
       "      <td>Trenčín</td>\n",
       "      <td>Nové Zámky</td>\n",
       "      <td>https://www.geonames.org/3058472/nove-zamky.html</td>\n",
       "      <td>47.98544</td>\n",
       "      <td>18.16195</td>\n",
       "      <td>POINT (18.16195 47.98544)</td>\n",
       "      <td>Hungary</td>\n",
       "      <td>&lt;Null&gt;</td>\n",
       "      <td>Mikl�s Horthy (Regent)</td>\n",
       "      <td>None</td>\n",
       "      <td>2.261526e+06</td>\n",
       "      <td>1.050275e+11</td>\n",
       "      <td>32</td>\n",
       "      <td>Czechoslovakia</td>\n",
       "      <td>None</td>\n",
       "      <td>Edvard Bene� (President)</td>\n",
       "      <td>None</td>\n",
       "      <td>3.636117e+06</td>\n",
       "      <td>1.405859e+11</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>...</th>\n",
       "      <td>...</td>\n",
       "      <td>...</td>\n",
       "      <td>...</td>\n",
       "      <td>...</td>\n",
       "      <td>...</td>\n",
       "      <td>...</td>\n",
       "      <td>...</td>\n",
       "      <td>...</td>\n",
       "      <td>...</td>\n",
       "      <td>...</td>\n",
       "      <td>...</td>\n",
       "      <td>...</td>\n",
       "      <td>...</td>\n",
       "      <td>...</td>\n",
       "      <td>...</td>\n",
       "      <td>...</td>\n",
       "      <td>...</td>\n",
       "      <td>...</td>\n",
       "      <td>...</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>2041</th>\n",
       "      <td>Šarfia</td>\n",
       "      <td>Šarfia</td>\n",
       "      <td>https://www.geonames.org/3061059/blatne.html</td>\n",
       "      <td>48.2666</td>\n",
       "      <td>17.41919</td>\n",
       "      <td>POINT (17.41919 48.26660)</td>\n",
       "      <td>Hungary</td>\n",
       "      <td>&lt;Null&gt;</td>\n",
       "      <td>Mikl�s Horthy (Regent)</td>\n",
       "      <td>None</td>\n",
       "      <td>2.261526e+06</td>\n",
       "      <td>1.050275e+11</td>\n",
       "      <td>32</td>\n",
       "      <td>Czechoslovakia</td>\n",
       "      <td>None</td>\n",
       "      <td>Edvard Bene� (President)</td>\n",
       "      <td>None</td>\n",
       "      <td>3.636117e+06</td>\n",
       "      <td>1.405859e+11</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>2042</th>\n",
       "      <td>Šarfia</td>\n",
       "      <td>Šarfia</td>\n",
       "      <td>https://www.geonames.org/3061059/blatne.html</td>\n",
       "      <td>48.2666</td>\n",
       "      <td>17.41919</td>\n",
       "      <td>POINT (17.41919 48.26660)</td>\n",
       "      <td>Hungary</td>\n",
       "      <td>&lt;Null&gt;</td>\n",
       "      <td>Mikl�s Horthy (Regent)</td>\n",
       "      <td>None</td>\n",
       "      <td>2.261526e+06</td>\n",
       "      <td>1.050275e+11</td>\n",
       "      <td>32</td>\n",
       "      <td>Czechoslovakia</td>\n",
       "      <td>None</td>\n",
       "      <td>Edvard Bene� (President)</td>\n",
       "      <td>None</td>\n",
       "      <td>3.636117e+06</td>\n",
       "      <td>1.405859e+11</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>2045</th>\n",
       "      <td>Modrý Kameň</td>\n",
       "      <td>Veľ. Zlievce, okr. Modrý Kameň</td>\n",
       "      <td>https://www.geonames.org/3056847/velke-zlievce...</td>\n",
       "      <td>48.19974</td>\n",
       "      <td>19.45582</td>\n",
       "      <td>POINT (19.45582 48.19974)</td>\n",
       "      <td>Hungary</td>\n",
       "      <td>&lt;Null&gt;</td>\n",
       "      <td>Mikl�s Horthy (Regent)</td>\n",
       "      <td>None</td>\n",
       "      <td>2.261526e+06</td>\n",
       "      <td>1.050275e+11</td>\n",
       "      <td>32</td>\n",
       "      <td>Czechoslovakia</td>\n",
       "      <td>None</td>\n",
       "      <td>Edvard Bene� (President)</td>\n",
       "      <td>None</td>\n",
       "      <td>3.636117e+06</td>\n",
       "      <td>1.405859e+11</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>2046</th>\n",
       "      <td>Modrý Kameň</td>\n",
       "      <td>Filak. Klačany, okr. Lučenec</td>\n",
       "      <td>https://www.geonames.org/3060241/filakovske-kl...</td>\n",
       "      <td>48.29032</td>\n",
       "      <td>19.75301</td>\n",
       "      <td>POINT (19.75301 48.29032)</td>\n",
       "      <td>Hungary</td>\n",
       "      <td>&lt;Null&gt;</td>\n",
       "      <td>Mikl�s Horthy (Regent)</td>\n",
       "      <td>None</td>\n",
       "      <td>2.261526e+06</td>\n",
       "      <td>1.050275e+11</td>\n",
       "      <td>32</td>\n",
       "      <td>Czechoslovakia</td>\n",
       "      <td>None</td>\n",
       "      <td>Edvard Bene� (President)</td>\n",
       "      <td>None</td>\n",
       "      <td>3.636117e+06</td>\n",
       "      <td>1.405859e+11</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>2047</th>\n",
       "      <td>Modrý Kameň</td>\n",
       "      <td>Baračka, okr. Vráble</td>\n",
       "      <td>https://www.geonames.org/3061176/bardonovo.html</td>\n",
       "      <td>48.10874</td>\n",
       "      <td>18.422</td>\n",
       "      <td>POINT (18.42200 48.10874)</td>\n",
       "      <td>Hungary</td>\n",
       "      <td>&lt;Null&gt;</td>\n",
       "      <td>Mikl�s Horthy (Regent)</td>\n",
       "      <td>None</td>\n",
       "      <td>2.261526e+06</td>\n",
       "      <td>1.050275e+11</td>\n",
       "      <td>32</td>\n",
       "      <td>Czechoslovakia</td>\n",
       "      <td>None</td>\n",
       "      <td>Edvard Bene� (President)</td>\n",
       "      <td>None</td>\n",
       "      <td>3.636117e+06</td>\n",
       "      <td>1.405859e+11</td>\n",
       "    </tr>\n",
       "  </tbody>\n",
       "</table>\n",
       "<p>165 rows × 19 columns</p>\n",
       "</div>"
      ],
      "text/plain": [
       "         location            domicile_citizenship  \\\n",
       "1158      Trenčín                      Nové Zámky   \n",
       "1159      Trenčín                      Nové Zámky   \n",
       "1160      Trenčín                      Nové Zámky   \n",
       "1161      Trenčín                      Nové Zámky   \n",
       "1162      Trenčín                      Nové Zámky   \n",
       "...           ...                             ...   \n",
       "2041       Šarfia                          Šarfia   \n",
       "2042       Šarfia                          Šarfia   \n",
       "2045  Modrý Kameň  Veľ. Zlievce, okr. Modrý Kameň   \n",
       "2046  Modrý Kameň    Filak. Klačany, okr. Lučenec   \n",
       "2047  Modrý Kameň            Baračka, okr. Vráble   \n",
       "\n",
       "                                           domicile_geo       lat       lon  \\\n",
       "1158   https://www.geonames.org/3058472/nove-zamky.html  47.98544  18.16195   \n",
       "1159   https://www.geonames.org/3058472/nove-zamky.html  47.98544  18.16195   \n",
       "1160   https://www.geonames.org/3058472/nove-zamky.html  47.98544  18.16195   \n",
       "1161   https://www.geonames.org/3058472/nove-zamky.html  47.98544  18.16195   \n",
       "1162   https://www.geonames.org/3058472/nove-zamky.html  47.98544  18.16195   \n",
       "...                                                 ...       ...       ...   \n",
       "2041       https://www.geonames.org/3061059/blatne.html   48.2666  17.41919   \n",
       "2042       https://www.geonames.org/3061059/blatne.html   48.2666  17.41919   \n",
       "2045  https://www.geonames.org/3056847/velke-zlievce...  48.19974  19.45582   \n",
       "2046  https://www.geonames.org/3060241/filakovske-kl...  48.29032  19.75301   \n",
       "2047    https://www.geonames.org/3061176/bardonovo.html  48.10874    18.422   \n",
       "\n",
       "                       geometry Name_left Foreign_Po_left  \\\n",
       "1158  POINT (18.16195 47.98544)   Hungary          <Null>   \n",
       "1159  POINT (18.16195 47.98544)   Hungary          <Null>   \n",
       "1160  POINT (18.16195 47.98544)   Hungary          <Null>   \n",
       "1161  POINT (18.16195 47.98544)   Hungary          <Null>   \n",
       "1162  POINT (18.16195 47.98544)   Hungary          <Null>   \n",
       "...                         ...       ...             ...   \n",
       "2041  POINT (17.41919 48.26660)   Hungary          <Null>   \n",
       "2042  POINT (17.41919 48.26660)   Hungary          <Null>   \n",
       "2045  POINT (19.45582 48.19974)   Hungary          <Null>   \n",
       "2046  POINT (19.75301 48.29032)   Hungary          <Null>   \n",
       "2047  POINT (18.42200 48.10874)   Hungary          <Null>   \n",
       "\n",
       "             Head_of_St_left Govt_in_Ex_left  Shape_Leng_left  \\\n",
       "1158  Mikl�s Horthy (Regent)            None     2.261526e+06   \n",
       "1159  Mikl�s Horthy (Regent)            None     2.261526e+06   \n",
       "1160  Mikl�s Horthy (Regent)            None     2.261526e+06   \n",
       "1161  Mikl�s Horthy (Regent)            None     2.261526e+06   \n",
       "1162  Mikl�s Horthy (Regent)            None     2.261526e+06   \n",
       "...                      ...             ...              ...   \n",
       "2041  Mikl�s Horthy (Regent)            None     2.261526e+06   \n",
       "2042  Mikl�s Horthy (Regent)            None     2.261526e+06   \n",
       "2045  Mikl�s Horthy (Regent)            None     2.261526e+06   \n",
       "2046  Mikl�s Horthy (Regent)            None     2.261526e+06   \n",
       "2047  Mikl�s Horthy (Regent)            None     2.261526e+06   \n",
       "\n",
       "      Shape_Area_left  index_right      Name_right Foreign_Po_right  \\\n",
       "1158     1.050275e+11           32  Czechoslovakia             None   \n",
       "1159     1.050275e+11           32  Czechoslovakia             None   \n",
       "1160     1.050275e+11           32  Czechoslovakia             None   \n",
       "1161     1.050275e+11           32  Czechoslovakia             None   \n",
       "1162     1.050275e+11           32  Czechoslovakia             None   \n",
       "...               ...          ...             ...              ...   \n",
       "2041     1.050275e+11           32  Czechoslovakia             None   \n",
       "2042     1.050275e+11           32  Czechoslovakia             None   \n",
       "2045     1.050275e+11           32  Czechoslovakia             None   \n",
       "2046     1.050275e+11           32  Czechoslovakia             None   \n",
       "2047     1.050275e+11           32  Czechoslovakia             None   \n",
       "\n",
       "              Head_of_St_right Govt_in_Ex_right  Shape_Leng_right  \\\n",
       "1158  Edvard Bene� (President)             None      3.636117e+06   \n",
       "1159  Edvard Bene� (President)             None      3.636117e+06   \n",
       "1160  Edvard Bene� (President)             None      3.636117e+06   \n",
       "1161  Edvard Bene� (President)             None      3.636117e+06   \n",
       "1162  Edvard Bene� (President)             None      3.636117e+06   \n",
       "...                        ...              ...               ...   \n",
       "2041  Edvard Bene� (President)             None      3.636117e+06   \n",
       "2042  Edvard Bene� (President)             None      3.636117e+06   \n",
       "2045  Edvard Bene� (President)             None      3.636117e+06   \n",
       "2046  Edvard Bene� (President)             None      3.636117e+06   \n",
       "2047  Edvard Bene� (President)             None      3.636117e+06   \n",
       "\n",
       "      Shape_Area_right  \n",
       "1158      1.405859e+11  \n",
       "1159      1.405859e+11  \n",
       "1160      1.405859e+11  \n",
       "1161      1.405859e+11  \n",
       "1162      1.405859e+11  \n",
       "...                ...  \n",
       "2041      1.405859e+11  \n",
       "2042      1.405859e+11  \n",
       "2045      1.405859e+11  \n",
       "2046      1.405859e+11  \n",
       "2047      1.405859e+11  \n",
       "\n",
       "[165 rows x 19 columns]"
      ]
     },
     "execution_count": 100,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "# In addition, find out, how many \"Hungarians\" were domiciled in the areas annected by Hungary after the First Vienna Award.\n",
    "huncz = statesdom[statesdom.Name=='Hungary']\n",
    "huncz = huncz.drop(['index_right'], axis = 1)\n",
    "huncz = huncz[huncz.Name=='Hungary'].sjoin(b19380331, how=\"left\")\n",
    "huncz[huncz.Name_right=='Czechoslovakia']"
   ]
  }
 ],
 "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.9.1"
  }
 },
 "nbformat": 4,
 "nbformat_minor": 4
}