Text_classification_of_newspaper_clippings_notebook.ipynb

{
 "cells": [
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "# Text classification for topic-specific newspaper collections"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "\n",
    "Created by Sarah Oberbichler [![ORCID](https://info.orcid.org/wp-content/uploads/2019/11/orcid_16x16.png)](https://orcid.org/0000-0002-1031-2759)\n",
    "\n",    
    "Text classification is the process of categorizing text into pre-defined groups. By using Natural Language Processing (NLP), text classifiers can automatically analyze text and then assign a set of given categories based on the research question. This automated classification of text into predefined categories is an important method for managing and processing a large number of newspaper clippings. This also applies to subcorpora for a specific research topic (e.g. migration). The aim of this notebook is to train a model using your previously manually created training/test corpus and to use this model to get an overview of the category distribution throughout your collection (see figure below). Another goal is to export your categorized data for further analysis. This makes it possible to examine, for example, the advertisement about a specific topic.\n",
    "\n",
    "This notebook was used with a collection for the case study on emigration (1850-1950) and shows how a model can be trained to classify topic-specific collections. For the training/testing corpus, a collection with the keywords \"Auswander*\", \"Ausgewanderte\", \"Emigrant*\", \"Emigrierte\", \"Emigration\", \"Kolonist*\", and \"Ansiedler*\" (all different German words for emigrants or emigration) have been created. In addition, information on the pre-defined gropus (news, ads, culture...) were added using numbers between one and ten. \n",
    "\n",
    "For classification, topic modelling (LDA) was chosen because it showed the best performance in classification (after experiments with word embeddings or LDA and word embeddings combined). LDA provides a way to group documents by topic and perform similarity searches and improve precision. Thanks to sklearn, it is relatively easy to test different classifiers for a given topic classification task. Logistic regression was chosen as binary classifier. \n",
    "\n",
    "*Following graph demonstrates the distribution of the pre-defined categories in newspaper clippings of seleceted Austrian Newspapers (sample of 1631 newspaper clippings) on the topic of emigration.* \n",
    "\n",
    "![Collection on the topic of Emigration](images/cat.PNG)\n",
    "\n",
    "\n",
    "Read more about <a href=\"https://monkeylearn.com/blog/introduction-to-topic-modeling/\" target=\"_blank\">Topic Modeling</a> and <a href=\"https://towardsdatascience.com/logistic-regression-model-tuning-with-scikit-learn-part-1-425142e01af5\" target=\"_blank\">Logistic Regression Model Tuning</a>.\n",
    "\n",
    "Acknowledgments:\n",
    "\n",
    "This work has been inspired by a notebook on <a href=\"https://www.kaggle.com/vukglisovic/classification-combining-lda-and-word2vec\" target=\"_blank\">LDA and word embeddings</a> and several other soursces that provided help on how to buid models. This work was supported by the European Union's Horizon 2020 research and innovation programme under grant 770299 (NewsEye)."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Step by step...\n",
    "* [Prepare a small manually annotated collection](#1-bullet)\n",
    "* [Install packages in command line](#2-bullet)\n",
    "* [Import packages](#3-bullet)\n",
    "* [Import your manually annotated newspaper collection](#4-bullet)\n",
    "* [Clean and tokenize the text (pre-processing)](#5-bullet)\n",
    "* [Have a look at your data](#6-bullet)\n",
    "* [Use your dataset to create a training corpus and test corpus](#7-bullet)\n",
    "* [Create topic models using your training corpus](#8-bullet)\n",
    "* [Have a look at your topics](#9-bullet)\n",
    "* [Create the feature vector ](#10-bullet)\n",
    "* [Have a look at the top words for each category](#11-bullet)\n",
    "* [Classification and hyperparameter tuning](#12-bullet)\n",
    "* [Using the test corpus](#13-bullet)\n",
    "* [Logistic Regression](#14-bullet)\n",
    "* [Now it is time to make the classifications](#15-bullet)\n",
    "* [Calculate the score for each category as well as the overall score](#16-bullet)\n",
    "* [If your overall score is higher than 80 percent, you can start to use your whole collection](#17-bullet)\n",
    "* [Clean (pre-process) your whole collection](#18-bullet)\n",
    "* [Now it is time to make the classifications for the whole collection](#19-bullet)\n",
    "* [Create a dataframe with the results](#20-bullet)\n",
    "* [If you are satisfied with the results, you can save them in the form of your original file](#21-bullet)\n",
    "* [Visualize your results](#22-bullet)\n"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Prepare a small manually annotated collection <a class=\"anchor\" id=\"1-bullet\"></a>\n",
    "\n",
    "This program uses annotations for evaluation and classification. Therefore, a manually annotated collection of  80 to 100 articles per category is needed to work with this program. To create this collection, the numbers 0 to 7 have been assignet to the articles, each number representing one newspaper category (ads, news, culture_literature_stories_letters, appeals_donations_information, crime, finance, statistic). When you create your own collection, make sure you create a representative collection of the whole search result. If you use a long time period, make sure all timer periods are represented in your small collection. \n",
    "The newspaper articles with the annotations should be saved as CSV."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Install packages in command line <a class=\"anchor\" id=\"2-bullet\"></a>\n",
    " \n",
    "If you need help on how to pip install, have a look at this tutorial: https://packaging.python.org/tutorials/installing-packages/\n",
    "\n",
    "pip install gensim\n",
    "\n",
    "pip install PyLDAvis\n",
    "\n",
    "pip install spacy\n",
    "\n",
    "python -m spacy download de_core_web_sm\n",
    "\n",
    "pip install pandas\n",
    "\n",
    "pip install regex\n",
    "\n",
    "pip install nltk\n",
    "\n",
    "pip install matplotlib\n",
    "\n",
    "pip install numpy\n",
    "\n",
    "pip install seaborn\n",
    "\n",
    "pip install sklearn"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Import packages <a class=\"anchor\" id=\"3-bullet\"></a>\n",
    "\n",
    "Before you can get started, you have to install and import some packages.\n",
    "\n",
    "#### Make sure you use the version 1.9.0 with smart_open: python -m pip install --upgrade smart_open==1.9.0\n"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 1,
   "metadata": {},
   "outputs": [],
   "source": [
    "# more common imports\n",
    "import pandas as pd\n",
    "import numpy as np\n",
    "from collections import Counter\n",
    "import re\n",
    "import sys\n",
    "import time\n",
    "\n",
    "# preprocessing imports\n",
    "from sklearn.preprocessing import LabelEncoder\n",
    "from nltk.corpus import stopwords\n",
    "from nltk.stem.porter import PorterStemmer\n",
    "from gensim.utils import lemmatize, simple_preprocess\n",
    "import spacy\n",
    "\n",
    "# model imports\n",
    "from gensim.models.ldamulticore import LdaMulticore\n",
    "from sklearn.ensemble import RandomForestClassifier, AdaBoostClassifier\n",
    "from sklearn.linear_model import LogisticRegression\n",
    "\n",
    "# LDA\n",
    "import nltk\n",
    "import gensim\n",
    "from gensim.corpora import Dictionary\n",
    "import gensim, spacy, logging, warnings\n",
    "import gensim.corpora as corpora\n",
    "from gensim.models import CoherenceModel\n",
    "from nltk.corpus import stopwords\n",
    "from gensim.models import LdaModel\n",
    "from gensim import models, corpora, similarities\n",
    "\n",
    "# hyperparameter training imports\n",
    "from sklearn.model_selection import GridSearchCV\n",
    "\n",
    "# visualization imports\n",
    "from IPython.display import display\n",
    "import seaborn as sns\n",
    "import matplotlib.pyplot as plt\n",
    "import matplotlib.image as mpimg\n",
    "import base64\n",
    "import io\n",
    "%matplotlib inline\n",
    "\n",
    "\n",
    "# Frequency\n",
    "from nltk import FreqDist\n"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 2,
   "metadata": {},
   "outputs": [],
   "source": [
    "pd.set_option('mode.chained_assignment', None)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Import your manually annotated newspaper collection <a class=\"anchor\" id=\"4-bullet\"></a>\n",
    "And have a look at your data"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 3,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "(673, 7)\n"
     ]
    },
    {
     "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>id</th>\n",
       "      <th>language</th>\n",
       "      <th>date</th>\n",
       "      <th>newspaper_id</th>\n",
       "      <th>iiif_url</th>\n",
       "      <th>relevancy</th>\n",
       "      <th>text</th>\n",
       "    </tr>\n",
       "  </thead>\n",
       "  <tbody>\n",
       "    <tr>\n",
       "      <td>0</td>\n",
       "      <td>arbeiter_zeitung_aze19131209_article_127</td>\n",
       "      <td>de</td>\n",
       "      <td>1913-12-09T00:00:00Z</td>\n",
       "      <td>arbeiter_zeitung</td>\n",
       "      <td>https://platform.newseye.eu/iiif/arbeiter_zeit...</td>\n",
       "      <td>4</td>\n",
       "      <td>* Betrug an Auswanderern. Am 5. d. abends wurd...</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <td>1</td>\n",
       "      <td>illustrierte_kronen_zeitung_krz19390921_articl...</td>\n",
       "      <td>de</td>\n",
       "      <td>1939-09-21T00:00:00Z</td>\n",
       "      <td>illustrierte_kronen_zeitung</td>\n",
       "      <td>https://platform.newseye.eu/iiif/illustrierte_...</td>\n",
       "      <td>4</td>\n",
       "      <td>Donnerstag, 21. September 1939\\n Das Ergebnis ...</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <td>2</td>\n",
       "      <td>arbeiter_zeitung_aze19121018_article_191</td>\n",
       "      <td>de</td>\n",
       "      <td>1912-10-18T00:00:00Z</td>\n",
       "      <td>arbeiter_zeitung</td>\n",
       "      <td>https://platform.newseye.eu/iiif/arbeiter_zeit...</td>\n",
       "      <td>4</td>\n",
       "      <td>Die maßlosen Schurkereien der Grenzpolizeibehö...</td>\n",
       "    </tr>\n",
       "  </tbody>\n",
       "</table>\n",
       "</div>"
      ],
      "text/plain": [
       "                                                  id language  \\\n",
       "0           arbeiter_zeitung_aze19131209_article_127       de   \n",
       "1  illustrierte_kronen_zeitung_krz19390921_articl...       de   \n",
       "2           arbeiter_zeitung_aze19121018_article_191       de   \n",
       "\n",
       "                   date                 newspaper_id  \\\n",
       "0  1913-12-09T00:00:00Z             arbeiter_zeitung   \n",
       "1  1939-09-21T00:00:00Z  illustrierte_kronen_zeitung   \n",
       "2  1912-10-18T00:00:00Z             arbeiter_zeitung   \n",
       "\n",
       "                                            iiif_url  relevancy  \\\n",
       "0  https://platform.newseye.eu/iiif/arbeiter_zeit...          4   \n",
       "1  https://platform.newseye.eu/iiif/illustrierte_...          4   \n",
       "2  https://platform.newseye.eu/iiif/arbeiter_zeit...          4   \n",
       "\n",
       "                                                text  \n",
       "0  * Betrug an Auswanderern. Am 5. d. abends wurd...  \n",
       "1  Donnerstag, 21. September 1939\\n Das Ergebnis ...  \n",
       "2  Die maßlosen Schurkereien der Grenzpolizeibehö...  "
      ]
     },
     "execution_count": 3,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "df = pd.read_csv('export_classification_emigration_new_06_07_2020_23_15.csv')\n",
    "\n",
    "print(df.shape)\n",
    "df.head(3)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### Check the distribution of your annotated categories. \n",
    "Each category is assignet to a number: \n",
    "\n",
    "0 = Advertisements\n",
    " \n",
    "1 = News\n",
    "\n",
    "2 = Culture, Literature, Stories, and Letters\n",
    "\n",
    "3 = Appeals, Donations, and (help) informations\n",
    "\n",
    "4 = Crime\n",
    "\n",
    "6 = Finance\n",
    "\n",
    "7 = Statistic\n",
    "\n",
    "These categories where specifically chosen for a collection on emigration between 1850 and 1950. For this corpus, about 80 articles for each categorie were sufficient to train a model that delivers good results. However, it is important that the corpus is representative for this specific topic. "
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 4,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "<matplotlib.axes._subplots.AxesSubplot at 0x25527474b88>"
      ]
     },
     "execution_count": 4,
     "metadata": {},
     "output_type": "execute_result"
    },
    {
     "data": {
      "image/png": "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\n",
      "text/plain": [
       "<Figure size 432x288 with 1 Axes>"
      ]
     },
     "metadata": {
      "needs_background": "light"
     },
     "output_type": "display_data"
    }
   ],
   "source": [
    "df.relevancy.value_counts().plot(kind='bar')"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Clean and tokenize the text (pre-processing) <a class=\"anchor\" id=\"5-bullet\"></a>\n",
    "\n",
    "Before you can start with the training fo the topic models, you have to clean the text of your newspaper articles. The follwing functions remove punctuations, lower case the text, remove stop words and lemmatize the text. \n",
    "\n",
    "#### Stop words: \n",
    "You can change the language used for the stop words. You can also add your own stop words or other words you would like to ignore. It helps to ignore your search keywords. "
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 5,
   "metadata": {},
   "outputs": [],
   "source": [
    "# Functions to clean, tokenize, and lemmatize the data\n",
    "def initial_clean(text):\n",
    "    text = re.sub(r'[^\\w\\s]','',text)\n",
    "    text = text.lower() \n",
    "    text = nltk.word_tokenize(text)\n",
    "    return text\n",
    "\n",
    "stop_words = stopwords.words('german')#change the language here\n",
    "# add your onw stop words\n",
    "stop_words.extend(['auswanderer', 'auswanderung', 'auswanderern'])\n",
    "def remove_stop_words(text):\n",
    "    return [word for word in text if word not in stop_words]\n",
    "\n",
    "stemmer = PorterStemmer()\n",
    "def stem_words(text):\n",
    "    try:\n",
    "        text = [stemmer.stem(word) for word in text]\n",
    "        text = [word for word in text if len(word) > 1] \n",
    "    except IndexError: \n",
    "        pass\n",
    "    return text\n",
    "\n",
    "def apply_all(text):\n",
    "    return stem_words(remove_stop_words(initial_clean(text)))"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 6,
   "metadata": {},
   "outputs": [],
   "source": [
    "df['tokenized'] = df['text'].apply(apply_all) "
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Have a look at your data <a class=\"anchor\" id=\"6-bullet\"></a>\n",
    "\n",
    "Check out, if everything went alright so far. Have a look at the number of words and their frequency distribution."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 7,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "'The number of unique words is 17324'"
      ]
     },
     "execution_count": 7,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "# first get a list of all words\n",
    "all_words = [word for item in list(df['tokenized']) for word in item]\n",
    "# use nltk fdist to get a frequency distribution of all words\n",
    "fdist = FreqDist(all_words)\n",
    "f\"The number of unique words is {len(fdist)}\""
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 8,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "length of list: 673\n",
      "average document length: 73.64041604754829\n",
      "minimum document length: 4\n",
      "maximum document length: 602\n"
     ]
    }
   ],
   "source": [
    "# document length\n",
    "df['doc_len'] = df['tokenized'].apply(lambda x: len(x))\n",
    "doc_lengths = list(df['doc_len'])\n",
    "df.drop(labels='doc_len', axis=1, inplace=True)\n",
    "\n",
    "print(f\"length of list: {len(doc_lengths)}\")\n",
    "print(f\"average document length: {np.average(doc_lengths)}\")\n",
    "print(f\"minimum document length: {min(doc_lengths)}\")\n",
    "print(f\"maximum document length: {max(doc_lengths)}\")"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "\n",
    "## Use your dataset to create a training corpus and test corpus <a class=\"anchor\" id=\"7-bullet\"></a>\n",
    "\n",
    "Before we use our model on a bigger, unseen collection, we use our manual annotated dataset to train the models and classify the newspaper clippings. This helps to control the output (the annotations show if the automated classification has worked corretly) and to adapt the code in order to get the best results for your own collection. \n",
    "\n",
    "You can change the size of training and testing corpus by changing the number in following line: msk = np.random.rand(len(df)) < 0.899\n"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 9,
   "metadata": {},
   "outputs": [],
   "source": [
    "# create a mask of binary values\n",
    "msk = np.random.rand(len(df)) < 0.899"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 10,
   "metadata": {},
   "outputs": [],
   "source": [
    "train_df = df[msk]\n",
    "train_df.reset_index(drop=True,inplace=True)\n",
    "\n",
    "test_df = df[~msk]\n",
    "test_df.reset_index(drop=True,inplace=True)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 11,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "673 595 78\n"
     ]
    }
   ],
   "source": [
    "print(len(df),len(train_df),len(test_df))"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### Make sure, all categories have the same size\n",
    "Therefore we shorten the training corpus to the number of the smallest category in the corpus. This is important so that the results are not distorted by over- or under-representation of a category. "
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 12,
   "metadata": {},
   "outputs": [],
   "source": [
    "val = train_df.relevancy.value_counts().min()\n",
    "train_df = train_df.groupby('relevancy').head(val)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 13,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "<matplotlib.axes._subplots.AxesSubplot at 0x2552a1a0188>"
      ]
     },
     "execution_count": 13,
     "metadata": {},
     "output_type": "execute_result"
    },
    {
     "data": {
      "image/png": "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\n",
      "text/plain": [
       "<Figure size 432x288 with 1 Axes>"
      ]
     },
     "metadata": {
      "needs_background": "light"
     },
     "output_type": "display_data"
    }
   ],
   "source": [
    "train_df.relevancy.value_counts().plot(kind='bar')"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### Have a look at the training corpus\n",
    "Make sure there are enough articles of each category represented in the training corpus. The training corpus will be used to mesure the score of the classfication results by using the manual assigned information. "
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 14,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "<matplotlib.axes._subplots.AxesSubplot at 0x2552b202448>"
      ]
     },
     "execution_count": 14,
     "metadata": {},
     "output_type": "execute_result"
    },
    {
     "data": {
      "image/png": "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\n",
      "text/plain": [
       "<Figure size 432x288 with 1 Axes>"
      ]
     },
     "metadata": {
      "needs_background": "light"
     },
     "output_type": "display_data"
    }
   ],
   "source": [
    "test_df.relevancy.value_counts().plot(kind='bar')"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Create topic models using your training corpus <a class=\"anchor\" id=\"8-bullet\"></a>\n",
    "\n",
    "The function \"train_lda\" trains the lda model. You can change the parameters like number of topics or chunksize, but also the change of the alpha and eta parameters can change the results a lot. For the text classification, a high number of topics is best suited. Of course, this can change from research question to research question, and it makes sense to train your models with a changing number of topics to find out which amount works best for your collection.\n",
    "\n",
    "The program is doing also several passes of the data since this is a small dataset, so we want the distributions to stabilize. \n",
    "\n",
    "It is also important to note that changing the parameters may lead to better results for some categories but worse results for others. If an overall good result is important, the parameters should be adjusted accordingly. On the other hand, if a good result is important for certain categories, you can simply ignore the result of those you do not need. The score is calculated after the model has been trained and the collection classified. To find out, which parameters work the best for your corpus, you simply have to try out a view times and see what happens when you change the parameters. Every collection is different.   \n"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 15,
   "metadata": {},
   "outputs": [],
   "source": [
    "dictionary = corpora.Dictionary(train_df['tokenized'])"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 16,
   "metadata": {},
   "outputs": [],
   "source": [
    "#Make a BOW for every document (Bag of words)\n",
    "def document_to_bow(df):\n",
    "    train_df['bow'] = list(map(lambda doc: dictionary.doc2bow(doc), train_df['tokenized']))\n",
    "    \n",
    "document_to_bow(train_df)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 17,
   "metadata": {},
   "outputs": [],
   "source": [
    "corpus = train_df.bow"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 18,
   "metadata": {},
   "outputs": [],
   "source": [
    "def train_lda(data):\n",
    "    num_topics = 500\n",
    "    chunksize = 8000\n",
    "    t1 = time.time()\n",
    "    lda = LdaModel(corpus=corpus, num_topics=num_topics, id2word=dictionary,\n",
    "                    chunksize=chunksize, minimum_probability=0.0, passes=50, iterations=500, per_word_topics=True)\n",
    "    return dictionary,corpus,lda"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "#### The training of the topic models takes a few minutes. But it is worh the waiting time"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 19,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Wall time: 4min 28s\n"
     ]
    }
   ],
   "source": [
    "%%time\n",
    "dictionary,corpus,lda = train_lda(train_df)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Have a look at your topics <a class=\"anchor\" id=\"9-bullet\"></a>\n",
    "Inspect the outcome of your topics. You can see all your topics in changing the topicid to the number of topic you want to see. You can also adapt the number of tokens (topn) by changing the number. "
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 20,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "[('deutschösterreich', 7.2748444e-05),\n",
       " ('erschöpft', 7.2748444e-05),\n",
       " ('fensterscheiben', 7.2748444e-05),\n",
       " ('figaro', 7.2748444e-05),\n",
       " ('endlo', 7.2748444e-05),\n",
       " ('ergiebig', 7.2748444e-05),\n",
       " ('bahnhofsinspektor', 7.2748444e-05),\n",
       " ('denk', 7.2748444e-05),\n",
       " ('centim', 7.2748444e-05),\n",
       " ('bücken', 7.2748444e-05),\n",
       " ('börsenkur', 7.2748444e-05),\n",
       " ('butterschiebungen', 7.2748444e-05),\n",
       " ('butter', 7.2748444e-05),\n",
       " ('brote', 7.2748444e-05),\n",
       " ('bourdoi', 7.2748444e-05),\n",
       " ('bossischen', 7.2748444e-05),\n",
       " ('beliebt', 7.2748444e-05),\n",
       " ('dito', 7.2748444e-05),\n",
       " ('ausplünderung', 7.2748444e-05),\n",
       " ('endlos', 7.2748444e-05)]"
      ]
     },
     "execution_count": 20,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "lda.show_topic(topicid=0, topn=20)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Now it is time to create the feature vector <a class=\"anchor\" id=\"10-bullet\"></a>\n",
    "Freature vectore is an n-dimensional vector of numerical features that represent some object. Many algorithms in machine learning require a numerical representation of objects, since such representations facilitate processing and statistical analysis."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 21,
   "metadata": {},
   "outputs": [],
   "source": [
    "def document_to_lda_features(lda, document):\n",
    "    \"\"\" Transforms a bag of words document to features.\n",
    "    It returns the proportion of how much each topic was\n",
    "    present in the document.\n",
    "    \"\"\"\n",
    "    topic_importances = lda.get_document_topics(document, minimum_probability=0)\n",
    "    topic_importances = np.array(topic_importances)\n",
    "    return topic_importances[:,1]\n",
    "\n",
    "train_df['lda_features'] = list(map(lambda doc:\n",
    "                                      document_to_lda_features(lda, doc),\n",
    "                                      train_df.bow))"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 22,
   "metadata": {},
   "outputs": [],
   "source": [
    "ads_topic_distribution = train_df.loc[train_df.relevancy == 0, 'lda_features'].mean()\n",
    "news_topic_distribution = train_df.loc[train_df.relevancy == 1, 'lda_features'].mean()\n",
    "culture_topic_distribution = train_df.loc[train_df.relevancy == 2, 'lda_features'].mean()\n",
    "appeals_topic_distribution = train_df.loc[train_df.relevancy == 3, 'lda_features'].mean()\n",
    "crime_topic_distribution = train_df.loc[train_df.relevancy == 4, 'lda_features'].mean()\n",
    "finances_topic_distribution = train_df.loc[train_df.relevancy == 6, 'lda_features'].mean()\n",
    "statistic_topic_distribution = train_df.loc[train_df.relevancy == 7, 'lda_features'].mean()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Have a look at the top words for each category <a class=\"anchor\" id=\"11-bullet\"></a>"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 23,
   "metadata": {},
   "outputs": [],
   "source": [
    "def get_topic_top_words(lda_model, topic_id, nr_top_words=5):\n",
    "    \"\"\" Returns the top words for topic_id from lda_model.\n",
    "    \"\"\"\n",
    "    id_tuples = lda_model.get_topic_terms(topic_id, topn=nr_top_words)\n",
    "    word_ids = np.array(id_tuples)[:,0]\n",
    "    words = map(lambda id_: lda_model.id2word[id_], word_ids)\n",
    "    return words"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 24,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Looking up top words from top topics from ads.\n",
      "For topic 47, the top words are: wegen, verkaufen, bez, billig, 17.\n",
      "For topic 91, the top words are: wien, bezirk, auskunft, auskunftsstel, 16.\n",
      "For topic 244, the top words are: jahr, englisch, spanisch, verlust, mann.\n",
      "For topic 412, the top words are: sucht, konstantinopel, de, nachdem, stell.\n",
      "For topic 460, the top words are: uhr, rumänischen, freien, neuen, press.\n",
      "\n",
      "Looking up top words from top topics from news.\n",
      "For topic 87, the top words are: gesellschaft, venezuela, errichtet, fl, anfragen.\n",
      "For topic 266, the top words are: wien, jahr, ottendorf, jedoch, oswald.\n",
      "For topic 454, the top words are: liverpool, folg, cholera, queenstown, hafen.\n",
      "For topic 473, the top words are: fahrt, gesuch, ueberfahrt, dampfer, versenkt.\n",
      "For topic 487, the top words are: eriwan, armenisch, abgeschoben, berichtet, grenz.\n",
      "\n",
      "Looking up top words from top topics from culture.\n",
      "For topic 120, the top words are: tirol, heimat, zillertal, brieftasch, papier.\n",
      "For topic 169, the top words are: vater, jung, mensch, friedl, schreyvogl.\n",
      "For topic 365, the top words are: waldmeist, behörden, ort, such, arbeit.\n",
      "For topic 407, the top words are: muß, art, zeit, usw, 30.\n",
      "For topic 463, the top words are: geb, abbild, bd, worden, paris.\n",
      "\n",
      "Looking up top words from top topics from appeals.\n",
      "For topic 91, the top words are: wien, bezirk, auskunft, auskunftsstel, 16.\n",
      "For topic 107, the top words are: krieg, aufruf, teil, umstand, infolg.\n",
      "For topic 201, the top words are: erteilt, inner, unterricht, staatsamt, auskunftsstel.\n",
      "For topic 345, the top words are: gibt, markt, hoher, auskunft, ueber.\n",
      "For topic 460, the top words are: uhr, rumänischen, freien, neuen, press.\n",
      "\n",
      "Looking up top words from top topics from crime.\n",
      "For topic 83, the top words are: april, wurd, passieren, erhebungen, erhielt.\n",
      "For topic 152, the top words are: wegen, angehalten, jung, aberm, landesgericht.\n",
      "For topic 293, the top words are: verhaftet, telegramm, verdacht, krakau, wurd.\n",
      "For topic 355, the top words are: wurden, gestern, agenten, 38, samstag.\n",
      "For topic 495, the top words are: wurd, untersuchung, pool, agram, baron.\n",
      "\n",
      "Looking up top words from top topics from finances.\n",
      "For topic 73, the top words are: österreich, wurd, stellung, personen, ausstellung.\n",
      "For topic 175, the top words are: golddiskontbank, grundstück, saal, erwerb, deutschen.\n",
      "For topic 327, the top words are: bewilligung, auswandererguthaben, inhab, guthaben, bewilligt.\n",
      "For topic 366, the top words are: juden, auswandererguthaben, guthaben, jüdischer, devisenrechtlich.\n",
      "For topic 369, the top words are: wertpapier, ausländischen, telegraphiert, devisen, deutschland.\n",
      "\n",
      "Looking up top words from top topics from statistic.\n",
      "For topic 124, the top words are: jahr, staaten, vereinigten, personen, amerika.\n",
      "For topic 255, the top words are: oesterreich, arbeit, ersten, zahl, mehr.\n",
      "For topic 265, the top words are: jahr, 1937, 1936, ausgewanderten, türkei.\n",
      "For topic 299, the top words are: personen, 25, außereuropäischen, oesterreich, insgesamt.\n",
      "For topic 406, the top words are: staaten, vereinigten, jahr, prozent, oesterreichungarn.\n",
      "\n"
     ]
    }
   ],
   "source": [
    "for relevancy, distribution in zip(['ads', 'news', 'culture', 'appeals', 'crime', 'finances', 'statistic'], [ads_topic_distribution, news_topic_distribution, culture_topic_distribution, appeals_topic_distribution, crime_topic_distribution, finances_topic_distribution, statistic_topic_distribution]):\n",
    "    print(\"Looking up top words from top topics from {}.\".format(relevancy))\n",
    "    for x in sorted(np.argsort(distribution)[-5:]):\n",
    "        top_words = get_topic_top_words(lda, x)\n",
    "        print(\"For topic {}, the top words are: {}.\".format(x, \", \".join(top_words)))\n",
    "    print(\"\")"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Classification and hyperparameter tuning <a class=\"anchor\" id=\"12-bullet\"></a>\n",
    "After transforming the documents into features, it is important to apply a few supervised classifiers to be able to predict what text belongs to which category."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 25,
   "metadata": {},
   "outputs": [],
   "source": [
    "def get_cross_validated_model(model, param_grid, X, y, nr_folds=6):\n",
    "    \"\"\" Trains a model by doing a grid search combined with cross validation.\n",
    "    args:\n",
    "        model: your model\n",
    "        param_grid: dict of parameter values for the grid search\n",
    "    returns:\n",
    "        Model trained on entire dataset with hyperparameters chosen from best results in the grid search.\n",
    "    \"\"\"\n",
    "    # train the model (since the evaluation is based on the logloss, we'll use neg_log_loss here)\n",
    "    grid_cv = GridSearchCV(model, param_grid=param_grid, scoring='neg_log_loss', cv=nr_folds, n_jobs=-1, verbose=True)\n",
    "    best_model = grid_cv.fit(X, y)\n",
    "    # show top models with parameter values\n",
    "    result_df = pd.DataFrame(best_model.cv_results_)\n",
    "    show_columns = ['mean_test_score', 'rank_test_score']\n",
    "    for col in result_df.columns:\n",
    "        if col.startswith('param_'):\n",
    "            show_columns.append(col)\n",
    "    display(result_df[show_columns].sort_values(by='rank_test_score').head())\n",
    "    return best_model"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 26,
   "metadata": {},
   "outputs": [],
   "source": [
    "# we first have to transform every entry\n",
    "X_train_lda = np.array(list(map(np.array, train_df.lda_features)))\n",
    "\n"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Using the test corpus  <a class=\"anchor\" id=\"13-bullet\"></a>\n",
    "First, have a look at your test corpus"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 27,
   "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>id</th>\n",
       "      <th>language</th>\n",
       "      <th>date</th>\n",
       "      <th>newspaper_id</th>\n",
       "      <th>iiif_url</th>\n",
       "      <th>relevancy</th>\n",
       "      <th>text</th>\n",
       "      <th>tokenized</th>\n",
       "    </tr>\n",
       "  </thead>\n",
       "  <tbody>\n",
       "    <tr>\n",
       "      <td>0</td>\n",
       "      <td>illustrierte_kronen_zeitung_krz19390921_articl...</td>\n",
       "      <td>de</td>\n",
       "      <td>1939-09-21T00:00:00Z</td>\n",
       "      <td>illustrierte_kronen_zeitung</td>\n",
       "      <td>https://platform.newseye.eu/iiif/illustrierte_...</td>\n",
       "      <td>4</td>\n",
       "      <td>Donnerstag, 21. September 1939\\n Das Ergebnis ...</td>\n",
       "      <td>[donnerstag, 21, septemb, 1939, ergebni, verei...</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <td>1</td>\n",
       "      <td>illustrierte_kronen_zeitung_krz19391010_articl...</td>\n",
       "      <td>de</td>\n",
       "      <td>1939-10-10T00:00:00Z</td>\n",
       "      <td>illustrierte_kronen_zeitung</td>\n",
       "      <td>https://platform.newseye.eu/iiif/illustrierte_...</td>\n",
       "      <td>4</td>\n",
       "      <td>Auf Grund der Ergebnisse des Beweisverfahrens ...</td>\n",
       "      <td>[grund, ergebniss, beweisverfahren, wurd, bezü...</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <td>2</td>\n",
       "      <td>arbeiter_zeitung_aze19140403_article_97</td>\n",
       "      <td>de</td>\n",
       "      <td>1914-04-03T00:00:00Z</td>\n",
       "      <td>arbeiter_zeitung</td>\n",
       "      <td>https://platform.newseye.eu/iiif/arbeiter_zeit...</td>\n",
       "      <td>4</td>\n",
       "      <td>Bestochene Gendarmen im Dienste der Auswanderu...</td>\n",
       "      <td>[bestochen, gendarmen, dienst, auswanderungsag...</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <td>3</td>\n",
       "      <td>arbeiter_zeitung_aze19130608_article_298</td>\n",
       "      <td>de</td>\n",
       "      <td>1913-06-08T00:00:00Z</td>\n",
       "      <td>arbeiter_zeitung</td>\n",
       "      <td>https://platform.newseye.eu/iiif/arbeiter_zeit...</td>\n",
       "      <td>4</td>\n",
       "      <td>(Auswanderer bestohlen.) Am 30. Jänner erschie...</td>\n",
       "      <td>[bestohlen, 30, jänner, erschien, hiesigen, ze...</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <td>4</td>\n",
       "      <td>arbeiter_zeitung_aze19131121_article_63</td>\n",
       "      <td>de</td>\n",
       "      <td>1913-11-21T00:00:00Z</td>\n",
       "      <td>arbeiter_zeitung</td>\n",
       "      <td>https://platform.newseye.eu/iiif/arbeiter_zeit...</td>\n",
       "      <td>7</td>\n",
       "      <td>Danach wurde die Verhandlung wieder sachlich. ...</td>\n",
       "      <td>[danach, wurd, verhandlung, sachlich, zuerst, ...</td>\n",
       "    </tr>\n",
       "  </tbody>\n",
       "</table>\n",
       "</div>"
      ],
      "text/plain": [
       "                                                  id language  \\\n",
       "0  illustrierte_kronen_zeitung_krz19390921_articl...       de   \n",
       "1  illustrierte_kronen_zeitung_krz19391010_articl...       de   \n",
       "2            arbeiter_zeitung_aze19140403_article_97       de   \n",
       "3           arbeiter_zeitung_aze19130608_article_298       de   \n",
       "4            arbeiter_zeitung_aze19131121_article_63       de   \n",
       "\n",
       "                   date                 newspaper_id  \\\n",
       "0  1939-09-21T00:00:00Z  illustrierte_kronen_zeitung   \n",
       "1  1939-10-10T00:00:00Z  illustrierte_kronen_zeitung   \n",
       "2  1914-04-03T00:00:00Z             arbeiter_zeitung   \n",
       "3  1913-06-08T00:00:00Z             arbeiter_zeitung   \n",
       "4  1913-11-21T00:00:00Z             arbeiter_zeitung   \n",
       "\n",
       "                                            iiif_url  relevancy  \\\n",
       "0  https://platform.newseye.eu/iiif/illustrierte_...          4   \n",
       "1  https://platform.newseye.eu/iiif/illustrierte_...          4   \n",
       "2  https://platform.newseye.eu/iiif/arbeiter_zeit...          4   \n",
       "3  https://platform.newseye.eu/iiif/arbeiter_zeit...          4   \n",
       "4  https://platform.newseye.eu/iiif/arbeiter_zeit...          7   \n",
       "\n",
       "                                                text  \\\n",
       "0  Donnerstag, 21. September 1939\\n Das Ergebnis ...   \n",
       "1  Auf Grund der Ergebnisse des Beweisverfahrens ...   \n",
       "2  Bestochene Gendarmen im Dienste der Auswanderu...   \n",
       "3  (Auswanderer bestohlen.) Am 30. Jänner erschie...   \n",
       "4  Danach wurde die Verhandlung wieder sachlich. ...   \n",
       "\n",
       "                                           tokenized  \n",
       "0  [donnerstag, 21, septemb, 1939, ergebni, verei...  \n",
       "1  [grund, ergebniss, beweisverfahren, wurd, bezü...  \n",
       "2  [bestochen, gendarmen, dienst, auswanderungsag...  \n",
       "3  [bestohlen, 30, jänner, erschien, hiesigen, ze...  \n",
       "4  [danach, wurd, verhandlung, sachlich, zuerst, ...  "
      ]
     },
     "execution_count": 27,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "test_df.head()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "#### Pre-process your test corpus using the same function than for the train corpus"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 28,
   "metadata": {},
   "outputs": [],
   "source": [
    "test_df['tokenized'] = test_df['text'].apply(apply_all) "
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "#### Make a bag of words for every document"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 29,
   "metadata": {},
   "outputs": [],
   "source": [
    "def document_to_bow(df):\n",
    "    df['bow'] = list(map(lambda doc: dictionary.doc2bow(doc), test_df['tokenized']))\n",
    "    \n",
    "document_to_bow(test_df)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "#### Get feature vectores for your test corpus"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 30,
   "metadata": {},
   "outputs": [],
   "source": [
    "test_df['lda_features'] = list(map(lambda doc:\n",
    "                                     document_to_lda_features(lda, doc),\n",
    "                                     test_df.bow))"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 31,
   "metadata": {},
   "outputs": [],
   "source": [
    "X_test_lda = np.array(list(map(np.array, test_df.lda_features)))"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 32,
   "metadata": {},
   "outputs": [],
   "source": [
    "# store all models in a dictionary\n",
    "models = dict()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Logistic Regression <a class=\"anchor\" id=\"14-bullet\"></a>\n",
    "Logistic Regression is a Machine Learning classification algorithm that is used to predict the probability of a categorical dependent variable. In logistic regression, the dependent variable is a binary variable that contains data coded as 1 (yes, success, etc.) or 0 (no, failure, etc.). In other words, the logistic regression model predicts P(Y=1) as a function of X."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 33,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Fitting 6 folds for each of 2 candidates, totalling 12 fits\n"
     ]
    },
    {
     "name": "stderr",
     "output_type": "stream",
     "text": [
      "[Parallel(n_jobs=-1)]: Using backend LokyBackend with 8 concurrent workers.\n",
      "[Parallel(n_jobs=-1)]: Done  10 out of  12 | elapsed:    3.8s remaining:    0.7s\n",
      "[Parallel(n_jobs=-1)]: Done  12 out of  12 | elapsed:    3.9s finished\n"
     ]
    },
    {
     "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>mean_test_score</th>\n",
       "      <th>rank_test_score</th>\n",
       "      <th>param_penalty</th>\n",
       "    </tr>\n",
       "  </thead>\n",
       "  <tbody>\n",
       "    <tr>\n",
       "      <td>1</td>\n",
       "      <td>-1.739082</td>\n",
       "      <td>1</td>\n",
       "      <td>l2</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <td>0</td>\n",
       "      <td>NaN</td>\n",
       "      <td>2</td>\n",
       "      <td>l1</td>\n",
       "    </tr>\n",
       "  </tbody>\n",
       "</table>\n",
       "</div>"
      ],
      "text/plain": [
       "   mean_test_score  rank_test_score param_penalty\n",
       "1        -1.739082                1            l2\n",
       "0              NaN                2            l1"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "\n",
    "lr = LogisticRegression()\n",
    "\n",
    "param_grid = {'penalty': ['l1', 'l2']}\n",
    "\n",
    "best_lr_lda = get_cross_validated_model(lr, param_grid, X_train_lda, train_df.relevancy)\n",
    "\n",
    "models['best_lr_lda'] = best_lr_lda"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Now it is time to make the classifications  <a class=\"anchor\" id=\"15-bullet\"></a>\n",
    "First we get a data frame with the result for each category. The category with the highest number is the category to which the article is assigned. \n"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 34,
   "metadata": {},
   "outputs": [],
   "source": [
    "submission_predictions = best_lr_lda.predict_proba(X_test_lda)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 35,
   "metadata": {},
   "outputs": [],
   "source": [
    "result= np.append(test_df.relevancy.values.reshape(-1,1), submission_predictions, axis=1)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 36,
   "metadata": {},
   "outputs": [],
   "source": [
    "submission_df = pd.DataFrame(data=result, columns=['relevancy', 'ads', 'news', 'culture', 'appeals', 'crime', 'finance', 'statistic'])"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "#### Have a look if everything worked correctly\n",
    "The first article contains the manual annotation (4.0), which means this article belongs to the category of crime. As you can see, the highest number for this row is in the column of crime. So this article has been classified correctly. "
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 37,
   "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>relevancy</th>\n",
       "      <th>ads</th>\n",
       "      <th>news</th>\n",
       "      <th>culture</th>\n",
       "      <th>appeals</th>\n",
       "      <th>crime</th>\n",
       "      <th>finance</th>\n",
       "      <th>statistic</th>\n",
       "    </tr>\n",
       "  </thead>\n",
       "  <tbody>\n",
       "    <tr>\n",
       "      <td>0</td>\n",
       "      <td>4.0</td>\n",
       "      <td>0.128170</td>\n",
       "      <td>0.151379</td>\n",
       "      <td>0.141994</td>\n",
       "      <td>0.123772</td>\n",
       "      <td>0.163076</td>\n",
       "      <td>0.145021</td>\n",
       "      <td>0.146587</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <td>1</td>\n",
       "      <td>4.0</td>\n",
       "      <td>0.135305</td>\n",
       "      <td>0.136371</td>\n",
       "      <td>0.133846</td>\n",
       "      <td>0.106168</td>\n",
       "      <td>0.210156</td>\n",
       "      <td>0.134451</td>\n",
       "      <td>0.143702</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <td>2</td>\n",
       "      <td>4.0</td>\n",
       "      <td>0.109508</td>\n",
       "      <td>0.118256</td>\n",
       "      <td>0.121030</td>\n",
       "      <td>0.090535</td>\n",
       "      <td>0.337691</td>\n",
       "      <td>0.112739</td>\n",
       "      <td>0.110241</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <td>3</td>\n",
       "      <td>4.0</td>\n",
       "      <td>0.137094</td>\n",
       "      <td>0.140410</td>\n",
       "      <td>0.139888</td>\n",
       "      <td>0.108211</td>\n",
       "      <td>0.218468</td>\n",
       "      <td>0.132532</td>\n",
       "      <td>0.123397</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <td>4</td>\n",
       "      <td>7.0</td>\n",
       "      <td>0.127070</td>\n",
       "      <td>0.143800</td>\n",
       "      <td>0.155163</td>\n",
       "      <td>0.103319</td>\n",
       "      <td>0.127259</td>\n",
       "      <td>0.151929</td>\n",
       "      <td>0.191461</td>\n",
       "    </tr>\n",
       "  </tbody>\n",
       "</table>\n",
       "</div>"
      ],
      "text/plain": [
       "   relevancy       ads      news   culture   appeals     crime   finance  \\\n",
       "0        4.0  0.128170  0.151379  0.141994  0.123772  0.163076  0.145021   \n",
       "1        4.0  0.135305  0.136371  0.133846  0.106168  0.210156  0.134451   \n",
       "2        4.0  0.109508  0.118256  0.121030  0.090535  0.337691  0.112739   \n",
       "3        4.0  0.137094  0.140410  0.139888  0.108211  0.218468  0.132532   \n",
       "4        7.0  0.127070  0.143800  0.155163  0.103319  0.127259  0.151929   \n",
       "\n",
       "   statistic  \n",
       "0   0.146587  \n",
       "1   0.143702  \n",
       "2   0.110241  \n",
       "3   0.123397  \n",
       "4   0.191461  "
      ]
     },
     "execution_count": 37,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "submission_df.head(5)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Calculate the score for each category as well as the overall score  <a class=\"anchor\" id=\"16-bullet\"></a>\n",
    "Repeat the calculation (topic models need sometimes several rounds) or adapt the code until you get a higher score than 80 percent. If you get a higher score than 80 percent, you can continue with your whole dataset."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 38,
   "metadata": {},
   "outputs": [],
   "source": [
    "max_num = submission_df.loc[:, submission_df.columns != 'relevancy'].max(axis=1)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 39,
   "metadata": {
    "scrolled": false
   },
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Your score for ads is: 1.0\n",
      "Your score for news is: 0.6\n",
      "Your score for culture is: 0.7777777777777778\n",
      "Your score for appeals is: 0.9230769230769231\n",
      "Your score for crime is: 0.8125\n",
      "Your score for finances is: 0.8181818181818182\n",
      "Your score for statistic is: 0.8571428571428571\n",
      "Your overall score is 0.8269541965970537\n"
     ]
    }
   ],
   "source": [
    "\n",
    "df_ads = submission_df[['ads', 'relevancy']][submission_df['ads'].isin(max_num)]\n",
    "\n",
    "ads_list = []\n",
    "for key, value in df_ads.items(): \n",
    "    for rel in value: \n",
    "        if len(str(rel)) < 4:\n",
    "            ads_list.append(rel)\n",
    "\n",
    "ads_right = []\n",
    "ads_wrong =[]\n",
    "for num in ads_list: \n",
    "    if num == 0.0: \n",
    "        ads_right.append(num)\n",
    "    else: \n",
    "        ads_wrong.append(num)\n",
    "all_ = len(ads_right) + len(ads_wrong)\n",
    "ads_score = len(ads_right) / all_\n",
    "print(f\"Your score for ads is: {ads_score}\")\n",
    "\n",
    "df_news = submission_df[['news', 'relevancy']][submission_df['news'].isin(max_num)]\n",
    "\n",
    "\n",
    "news_list = []\n",
    "for key, value in df_news.items(): \n",
    "    for rel in value: \n",
    "        if len(str(rel)) < 4:\n",
    "            news_list.append(rel)\n",
    "\n",
    "news_right = []\n",
    "news_wrong =[]\n",
    "for num in news_list: \n",
    "    if num == 1.0: \n",
    "        news_right.append(num)\n",
    "    else: \n",
    "        news_wrong.append(num)\n",
    "all_ = len(news_right) + len(news_wrong)\n",
    "news_score = len(news_right) / all_\n",
    "print(f\"Your score for news is: {news_score}\")\n",
    "\n",
    "    \n",
    "df_culture = submission_df[['culture', 'relevancy']][submission_df['culture'].isin(max_num)]\n",
    "\n",
    "culture_list = []\n",
    "for key, value in df_culture.items(): \n",
    "    for rel in value: \n",
    "        if len(str(rel)) < 4:\n",
    "            culture_list.append(rel)\n",
    "\n",
    "culture_right = []\n",
    "culture_wrong =[]\n",
    "for num in culture_list: \n",
    "    if num == 2.0: \n",
    "        culture_right.append(num)\n",
    "    else: \n",
    "        culture_wrong.append(num)\n",
    "all_ = len(culture_right) + len(culture_wrong)\n",
    "culture_score = len(culture_right) / all_\n",
    "print(f\"Your score for culture is: {culture_score}\")\n",
    "\n",
    "df_appeals = submission_df[['appeals', 'relevancy']][submission_df['appeals'].isin(max_num)]\n",
    "\n",
    "appeals_list = []\n",
    "for key, value in df_appeals.items(): \n",
    "    for rel in value: \n",
    "        if len(str(rel)) < 4:\n",
    "            appeals_list.append(rel)\n",
    "\n",
    "appeals_right = []\n",
    "appeals_wrong =[]\n",
    "for num in appeals_list: \n",
    "    if num == 3.0: \n",
    "        appeals_right.append(num)\n",
    "    else: \n",
    "        appeals_wrong.append(num)\n",
    "all_ = len(appeals_right) + len(appeals_wrong)\n",
    "appeals_score = len(appeals_right) / all_\n",
    "print(f\"Your score for appeals is: {appeals_score}\")\n",
    "\n",
    "df_crime = submission_df[['crime', 'relevancy']][submission_df['crime'].isin(max_num)]\n",
    "\n",
    "crime_list = []\n",
    "for key, value in df_crime.items(): \n",
    "    for rel in value: \n",
    "        if len(str(rel)) < 4:\n",
    "            crime_list.append(rel)\n",
    "\n",
    "crime_right = []\n",
    "crime_wrong =[]\n",
    "for num in crime_list: \n",
    "    if num == 4.0: \n",
    "        crime_right.append(num)\n",
    "    else: \n",
    "        crime_wrong.append(num)\n",
    "all_ = len(crime_right) + len(crime_wrong)\n",
    "crime_score = len(crime_right) / all_\n",
    "print(f\"Your score for crime is: {crime_score}\")\n",
    "\n",
    "\n",
    "df_finances = submission_df[['finance', 'relevancy']][submission_df['finance'].isin(max_num)]\n",
    "\n",
    "finances_list = []\n",
    "for key, value in df_finances.items(): \n",
    "    for rel in value: \n",
    "        if len(str(rel)) < 4:\n",
    "            finances_list.append(rel)\n",
    "\n",
    "finances_right = []\n",
    "finances_wrong =[]\n",
    "for num in finances_list: \n",
    "    if num == 6.0: \n",
    "        finances_right.append(num)\n",
    "    else: \n",
    "        finances_wrong.append(num)\n",
    "all_ = len(finances_right) + len(finances_wrong)\n",
    "finance_score = len(finances_right) / all_\n",
    "print(f\"Your score for finances is: {finance_score}\")\n",
    "   \n",
    "df_statistic = submission_df[['statistic', 'relevancy']][submission_df['statistic'].isin(max_num)]\n",
    "\n",
    "statistic_list = []\n",
    "for key, value in df_statistic.items(): \n",
    "    for rel in value: \n",
    "        if len(str(rel)) < 4:\n",
    "            statistic_list.append(rel)\n",
    "\n",
    "statistic_right = []\n",
    "statistic_wrong =[]\n",
    "for num in statistic_list: \n",
    "    if num == 7.0: \n",
    "        statistic_right.append(num)\n",
    "    else: \n",
    "        statistic_wrong.append(num)\n",
    "all_ = len(statistic_right) + len(statistic_wrong)\n",
    "statistic_score = len(statistic_right) / all_\n",
    "print(f\"Your score for statistic is: {statistic_score}\")\n",
    "overall_score = (ads_score + news_score + culture_score + appeals_score + crime_score + finance_score + statistic_score) / 7\n",
    "\n",
    "print(f\"Your overall score is {overall_score}\")"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "# If your overall score is higher than 80 percent, you can start to use your whole collection  <a class=\"anchor\" id=\"17-bullet\"></a>\n",
    "\n",
    "Start with importing your whole collection. Import the same collection twice for the futher processing. \n",
    "\n",
    "Note: If you are mainly interested in one of the catecories, it makes sense to choose a model with a high score for that category. If you want a good overview of the distribution of the categories, a overall good score is more important. "
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 40,
   "metadata": {},
   "outputs": [],
   "source": [
    "df_all = pd.read_csv('export_auswanderer_06_07_2020_22_38.csv', usecols = ['id','language','date','newspaper_id','iiif_url','text'])\n",
    "df_all_2 = pd.read_csv('export_auswanderer_06_07_2020_22_38.csv', usecols = ['id','language','date','newspaper_id','iiif_url','text'])\n"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### Have a look at your data"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 41,
   "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>id</th>\n",
       "      <th>language</th>\n",
       "      <th>date</th>\n",
       "      <th>newspaper_id</th>\n",
       "      <th>iiif_url</th>\n",
       "      <th>text</th>\n",
       "    </tr>\n",
       "  </thead>\n",
       "  <tbody>\n",
       "    <tr>\n",
       "      <td>0</td>\n",
       "      <td>illustrierte_kronen_zeitung_krz19390708_articl...</td>\n",
       "      <td>de</td>\n",
       "      <td>1939-07-08T00:00:00Z</td>\n",
       "      <td>illustrierte_kronen_zeitung</td>\n",
       "      <td>https://platform.newseye.eu/iiif/illustrierte_...</td>\n",
       "      <td>schafft.\\nIn dieser Vereinigung werden die Ju...</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <td>1</td>\n",
       "      <td>illustrierte_kronen_zeitung_krz19390708_articl...</td>\n",
       "      <td>de</td>\n",
       "      <td>1939-07-08T00:00:00Z</td>\n",
       "      <td>illustrierte_kronen_zeitung</td>\n",
       "      <td>https://platform.newseye.eu/iiif/illustrierte_...</td>\n",
       "      <td>Die Reichsvereinigung ist verpflichtet, für di...</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <td>2</td>\n",
       "      <td>illustrierte_kronen_zeitung_krz19131101_articl...</td>\n",
       "      <td>de</td>\n",
       "      <td>1913-11-01T00:00:00Z</td>\n",
       "      <td>illustrierte_kronen_zeitung</td>\n",
       "      <td>https://platform.newseye.eu/iiif/illustrierte_...</td>\n",
       "      <td>(Angehaltene Auswanderer.) In Prag wurden\\nges...</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <td>3</td>\n",
       "      <td>illustrierte_kronen_zeitung_krz19331108_articl...</td>\n",
       "      <td>de</td>\n",
       "      <td>1933-11-08T00:00:00Z</td>\n",
       "      <td>illustrierte_kronen_zeitung</td>\n",
       "      <td>https://platform.newseye.eu/iiif/illustrierte_...</td>\n",
       "      <td>gestern eine Festsitzung statt. Direktor\\nSchw...</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <td>4</td>\n",
       "      <td>arbeiter_zeitung_aze19131231_article_196</td>\n",
       "      <td>de</td>\n",
       "      <td>1913-12-31T00:00:00Z</td>\n",
       "      <td>arbeiter_zeitung</td>\n",
       "      <td>https://platform.newseye.eu/iiif/arbeiter_zeit...</td>\n",
       "      <td>Der Portier eines Leopoldstädter Hotels gab al...</td>\n",
       "    </tr>\n",
       "  </tbody>\n",
       "</table>\n",
       "</div>"
      ],
      "text/plain": [
       "                                                  id language  \\\n",
       "0  illustrierte_kronen_zeitung_krz19390708_articl...       de   \n",
       "1  illustrierte_kronen_zeitung_krz19390708_articl...       de   \n",
       "2  illustrierte_kronen_zeitung_krz19131101_articl...       de   \n",
       "3  illustrierte_kronen_zeitung_krz19331108_articl...       de   \n",
       "4           arbeiter_zeitung_aze19131231_article_196       de   \n",
       "\n",
       "                   date                 newspaper_id  \\\n",
       "0  1939-07-08T00:00:00Z  illustrierte_kronen_zeitung   \n",
       "1  1939-07-08T00:00:00Z  illustrierte_kronen_zeitung   \n",
       "2  1913-11-01T00:00:00Z  illustrierte_kronen_zeitung   \n",
       "3  1933-11-08T00:00:00Z  illustrierte_kronen_zeitung   \n",
       "4  1913-12-31T00:00:00Z             arbeiter_zeitung   \n",
       "\n",
       "                                            iiif_url  \\\n",
       "0  https://platform.newseye.eu/iiif/illustrierte_...   \n",
       "1  https://platform.newseye.eu/iiif/illustrierte_...   \n",
       "2  https://platform.newseye.eu/iiif/illustrierte_...   \n",
       "3  https://platform.newseye.eu/iiif/illustrierte_...   \n",
       "4  https://platform.newseye.eu/iiif/arbeiter_zeit...   \n",
       "\n",
       "                                                text  \n",
       "0   schafft.\\nIn dieser Vereinigung werden die Ju...  \n",
       "1  Die Reichsvereinigung ist verpflichtet, für di...  \n",
       "2  (Angehaltene Auswanderer.) In Prag wurden\\nges...  \n",
       "3  gestern eine Festsitzung statt. Direktor\\nSchw...  \n",
       "4  Der Portier eines Leopoldstädter Hotels gab al...  "
      ]
     },
     "execution_count": 41,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "df_all.head()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Clean (pre-process) your whole collection <a class=\"anchor\" id=\"18-bullet\"></a>\n",
    "\n",
    "You repeat the same steps you did with your training and test corpus"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 42,
   "metadata": {},
   "outputs": [],
   "source": [
    "df_all['tokenized'] = df_all['text'].apply(apply_all) "
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "#### Again, have a look at your data"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 43,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "'The number of unique words is 22702'"
      ]
     },
     "execution_count": 43,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "# first get a list of all words\n",
    "all_words = [word for item in list(df_all['tokenized']) for word in item]\n",
    "# use nltk fdist to get a frequency distribution of all words\n",
    "fdist = FreqDist(all_words)\n",
    "f\"The number of unique words is {len(fdist)}\""
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 44,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "length of list: 1894\n",
      "average document length: 41.554382259767685\n",
      "minimum document length: 0\n",
      "maximum document length: 430\n"
     ]
    }
   ],
   "source": [
    "#document length\n",
    "df_all['doc_len'] = df_all['tokenized'].apply(lambda x: len(x))\n",
    "doc_lengths = list(df_all['doc_len'])\n",
    "df_all.drop(labels='doc_len', axis=1, inplace=True)\n",
    "\n",
    "\n",
    "print(f\"length of list: {len(doc_lengths)}\")\n",
    "print(f\"average document length: {np.average(doc_lengths)}\")\n",
    "print(f\"minimum document length: {min(doc_lengths)}\")\n",
    "print(f\"maximum document length: {max(doc_lengths)}\")"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "#### Remove articles that are smaller than 5 tokens"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 45,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "After cleaning and excluding short aticles, the dataframe now has: 1631 articles\n",
      "After cleaning and excluding short aticles, the dataframe now has: 1631 articles\n"
     ]
    }
   ],
   "source": [
    "df_all = df_all[df_all['tokenized'].map(len) >= 5]\n",
    "df_all = df_all[df_all['tokenized'].map(type) == list]\n",
    "df_all.reset_index(drop=True,inplace=True)\n",
    "print(\"After cleaning and excluding short aticles, the dataframe now has:\", len(df_all), \"articles\")\n",
    "\n",
    "df_all_2 = df_all[df_all['tokenized'].map(len) >= 5]\n",
    "df_all_2 = df_all[df_all['tokenized'].map(type) == list]\n",
    "df_all_2.reset_index(drop=True,inplace=True)\n",
    "print(\"After cleaning and excluding short aticles, the dataframe now has:\", len(df_all), \"articles\")"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "#### Make a BOW (bag of words) for every document and get feature vectores for your whole collection"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 46,
   "metadata": {},
   "outputs": [],
   "source": [
    "def document_to_bow(df):\n",
    "    df['bow'] = list(map(lambda doc: dictionary.doc2bow(doc), df_all['tokenized']))\n",
    "    \n",
    "document_to_bow(df_all)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 47,
   "metadata": {},
   "outputs": [],
   "source": [
    "df_all['lda_features'] = list(map(lambda doc:\n",
    "                                     document_to_lda_features(lda, doc),\n",
    "                                     df_all.bow))"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 48,
   "metadata": {},
   "outputs": [],
   "source": [
    "X_all_lda = np.array(list(map(np.array, df_all.lda_features)))"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Now it is time to make the classifications for the whole collection <a class=\"anchor\" id=\"19-bullet\"></a>"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 49,
   "metadata": {},
   "outputs": [],
   "source": [
    "submission_predictions = best_lr_lda.predict_proba(X_all_lda)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "To be able to create two different outputs, one with the results per category to check the result [57] and one with the results in the form of your original file [61], two different types of results are created. "
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 50,
   "metadata": {},
   "outputs": [],
   "source": [
    "result= np.append(df_all.text.values.reshape(-1,1), submission_predictions, axis=1)\n"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 51,
   "metadata": {},
   "outputs": [],
   "source": [
    "result_2= np.append(df_all_2, submission_predictions, axis=1)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 52,
   "metadata": {},
   "outputs": [],
   "source": [
    "submission_df_all = pd.DataFrame(data=result, columns=['text', 'ads', 'news', 'culture', 'appeals', 'crime', 'finance', 'statistic'])\n",
    "submission_df_all_2 = pd.DataFrame(data=result_2, columns=['id','language','date','newspaper_id','iiif_url','text', 'token', 'ads', 'news', 'culture', 'appeals', 'crime', 'finance', 'statistic'])"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 53,
   "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>text</th>\n",
       "      <th>ads</th>\n",
       "      <th>news</th>\n",
       "      <th>culture</th>\n",
       "      <th>appeals</th>\n",
       "      <th>crime</th>\n",
       "      <th>finance</th>\n",
       "      <th>statistic</th>\n",
       "    </tr>\n",
       "  </thead>\n",
       "  <tbody>\n",
       "    <tr>\n",
       "      <td>0</td>\n",
       "      <td>schafft.\\nIn dieser Vereinigung werden die Ju...</td>\n",
       "      <td>0.127635</td>\n",
       "      <td>0.195056</td>\n",
       "      <td>0.133611</td>\n",
       "      <td>0.0988736</td>\n",
       "      <td>0.12577</td>\n",
       "      <td>0.182054</td>\n",
       "      <td>0.137</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <td>1</td>\n",
       "      <td>Die Reichsvereinigung ist verpflichtet, für di...</td>\n",
       "      <td>0.12317</td>\n",
       "      <td>0.206848</td>\n",
       "      <td>0.132327</td>\n",
       "      <td>0.115848</td>\n",
       "      <td>0.127157</td>\n",
       "      <td>0.170397</td>\n",
       "      <td>0.124253</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <td>2</td>\n",
       "      <td>(Angehaltene Auswanderer.) In Prag wurden\\nges...</td>\n",
       "      <td>0.128026</td>\n",
       "      <td>0.127883</td>\n",
       "      <td>0.110097</td>\n",
       "      <td>0.102477</td>\n",
       "      <td>0.289</td>\n",
       "      <td>0.11354</td>\n",
       "      <td>0.128977</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <td>3</td>\n",
       "      <td>gestern eine Festsitzung statt. Direktor\\nSchw...</td>\n",
       "      <td>0.133976</td>\n",
       "      <td>0.163399</td>\n",
       "      <td>0.131451</td>\n",
       "      <td>0.117312</td>\n",
       "      <td>0.188189</td>\n",
       "      <td>0.140498</td>\n",
       "      <td>0.125174</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <td>4</td>\n",
       "      <td>Der Portier eines Leopoldstädter Hotels gab al...</td>\n",
       "      <td>0.144175</td>\n",
       "      <td>0.136877</td>\n",
       "      <td>0.122825</td>\n",
       "      <td>0.107205</td>\n",
       "      <td>0.155244</td>\n",
       "      <td>0.204618</td>\n",
       "      <td>0.129055</td>\n",
       "    </tr>\n",
       "  </tbody>\n",
       "</table>\n",
       "</div>"
      ],
      "text/plain": [
       "                                                text       ads      news  \\\n",
       "0   schafft.\\nIn dieser Vereinigung werden die Ju...  0.127635  0.195056   \n",
       "1  Die Reichsvereinigung ist verpflichtet, für di...   0.12317  0.206848   \n",
       "2  (Angehaltene Auswanderer.) In Prag wurden\\nges...  0.128026  0.127883   \n",
       "3  gestern eine Festsitzung statt. Direktor\\nSchw...  0.133976  0.163399   \n",
       "4  Der Portier eines Leopoldstädter Hotels gab al...  0.144175  0.136877   \n",
       "\n",
       "    culture    appeals     crime   finance statistic  \n",
       "0  0.133611  0.0988736   0.12577  0.182054     0.137  \n",
       "1  0.132327   0.115848  0.127157  0.170397  0.124253  \n",
       "2  0.110097   0.102477     0.289   0.11354  0.128977  \n",
       "3  0.131451   0.117312  0.188189  0.140498  0.125174  \n",
       "4  0.122825   0.107205  0.155244  0.204618  0.129055  "
      ]
     },
     "execution_count": 53,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "submission_df_all.head(5)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Create a dataframe with the results <a class=\"anchor\" id=\"20-bullet\"></a>"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 58,
   "metadata": {},
   "outputs": [],
   "source": [
    "max_num = submission_df_all.loc[:, submission_df_all.columns != 'text'].max(axis=1)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 59,
   "metadata": {},
   "outputs": [],
   "source": [
    "ads = submission_df_all[['text']][submission_df_all['ads'].isin(max_num)]\n",
    "news = submission_df_all[['text']][submission_df_all['news'].isin(max_num)]\n",
    "culture = submission_df_all[['text']][submission_df_all['culture'].isin(max_num)]\n",
    "appeals = submission_df_all[['text']][submission_df_all['appeals'].isin(max_num)]\n",
    "crime = submission_df_all[['text']][submission_df_all['crime'].isin(max_num)]\n",
    "finance = submission_df_all[['text']][submission_df_all['finance'].isin(max_num)]\n",
    "statistic = submission_df_all[['text']][submission_df_all['statistic'].isin(max_num)]"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 60,
   "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>Ads</th>\n",
       "      <th>News</th>\n",
       "      <th>Culture_Literatur</th>\n",
       "      <th>Appeals_Donations</th>\n",
       "      <th>Crime</th>\n",
       "      <th>Finance</th>\n",
       "      <th>Statistic</th>\n",
       "    </tr>\n",
       "  </thead>\n",
       "  <tbody>\n",
       "    <tr>\n",
       "      <td>15</td>\n",
       "      <td>furse für Französisch,\\nItalienisch, Ungarisch...</td>\n",
       "      <td>Imperialisten nicht. Die meisten industriellen...</td>\n",
       "      <td>Wir waren wieder die letzten, die den Zug\\nver...</td>\n",
       "      <td>I, Neuet indent% stration des Blattes „Der Aus...</td>\n",
       "      <td>* Kleine Nachrichten. Der 31jährige Comptoiris...</td>\n",
       "      <td>Die beiden Schiffe, die die Auswanderer\\nnach ...</td>\n",
       "      <td>Es wandern mehr Frauen aus.\\n Gegenüber den Vo...</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <td>16</td>\n",
       "      <td>Auswanderer einer raschen, exergischen Regelun...</td>\n",
       "      <td>Tripolitanien als Auswanderungsland ist Humbug...</td>\n",
       "      <td>Dem Auswanderungsamt muß auch eine staatliche ...</td>\n",
       "      <td>Saal: 4 Uhr: „Im Firnenglanz des Ober=Engadin“...</td>\n",
       "      <td>(Der Raubmordversuch an einem Auswanderer.) Un...</td>\n",
       "      <td>scheinsalscher\\nDer jüdische Kaufmann Karl Fah...</td>\n",
       "      <td>Danach wurde die Verhandlung wieder sachlich. ...</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <td>17</td>\n",
       "      <td>&amp; Auswanderer 9\\nWege aller Art\\nTaramt schan ...</td>\n",
       "      <td>Der erste Redner ist Delegirter Graf Dzieduszy...</td>\n",
       "      <td>(Für Auswanderer.) Heute 7 Uhr abends\\nspricht...</td>\n",
       "      <td>Die Alhambra in Granada.\\nAbends ½8 Uhr:\\nAusw...</td>\n",
       "      <td>Auf Grund der Ergebnisse des Beweisverfahrens ...</td>\n",
       "      <td>Arbeiter dieses kapitalistische Denkmal errich...</td>\n",
       "      <td>Während im ganzen Jahre 1912 über Triest nur 1...</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <td>18</td>\n",
       "      <td>Für Auswanderer\\nprima Existenz. Verkaufe\\nlei...</td>\n",
       "      <td>Die jüdische Politik kenne keine Grenzen\\nfür ...</td>\n",
       "      <td>In Ecuador ist für Auswanderer nichts\\nzu hole...</td>\n",
       "      <td>Urania.\\nSonntag, 26., 3 Uhr: Großer\\nVortrags...</td>\n",
       "      <td>schwiegen\\nWie eine Auswanderung finanziert we...</td>\n",
       "      <td>sch, Ungarisch, Tschechif\\npanischer und portu...</td>\n",
       "      <td>Die Mitteilungen des Handelsministers wurden d...</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <td>19</td>\n",
       "      <td>umarbeiten, mode\\nnisieren, auch für\\nAuswande...</td>\n",
       "      <td>d) für Reichsangehörige und Angehörige\\ndes Pr...</td>\n",
       "      <td>Der Jakob schüttelte den Kopf.\\n„Besuch' mich ...</td>\n",
       "      <td>Achtung Auswanderer!\\nKostenlose Ueberfahrt un...</td>\n",
       "      <td>Die Angeklagte reiste nach der Auswanderung ih...</td>\n",
       "      <td>Die „Abtreibungsklinik“ des Artisten\\nSchädlin...</td>\n",
       "      <td>monen zur Auswanderung veranlaßten, aber die U...</td>\n",
       "    </tr>\n",
       "  </tbody>\n",
       "</table>\n",
       "</div>"
      ],
      "text/plain": [
       "                                                  Ads  \\\n",
       "15  furse für Französisch,\\nItalienisch, Ungarisch...   \n",
       "16  Auswanderer einer raschen, exergischen Regelun...   \n",
       "17  & Auswanderer 9\\nWege aller Art\\nTaramt schan ...   \n",
       "18  Für Auswanderer\\nprima Existenz. Verkaufe\\nlei...   \n",
       "19  umarbeiten, mode\\nnisieren, auch für\\nAuswande...   \n",
       "\n",
       "                                                 News  \\\n",
       "15  Imperialisten nicht. Die meisten industriellen...   \n",
       "16  Tripolitanien als Auswanderungsland ist Humbug...   \n",
       "17  Der erste Redner ist Delegirter Graf Dzieduszy...   \n",
       "18  Die jüdische Politik kenne keine Grenzen\\nfür ...   \n",
       "19  d) für Reichsangehörige und Angehörige\\ndes Pr...   \n",
       "\n",
       "                                    Culture_Literatur  \\\n",
       "15  Wir waren wieder die letzten, die den Zug\\nver...   \n",
       "16  Dem Auswanderungsamt muß auch eine staatliche ...   \n",
       "17  (Für Auswanderer.) Heute 7 Uhr abends\\nspricht...   \n",
       "18  In Ecuador ist für Auswanderer nichts\\nzu hole...   \n",
       "19  Der Jakob schüttelte den Kopf.\\n„Besuch' mich ...   \n",
       "\n",
       "                                    Appeals_Donations  \\\n",
       "15  I, Neuet indent% stration des Blattes „Der Aus...   \n",
       "16  Saal: 4 Uhr: „Im Firnenglanz des Ober=Engadin“...   \n",
       "17  Die Alhambra in Granada.\\nAbends ½8 Uhr:\\nAusw...   \n",
       "18  Urania.\\nSonntag, 26., 3 Uhr: Großer\\nVortrags...   \n",
       "19  Achtung Auswanderer!\\nKostenlose Ueberfahrt un...   \n",
       "\n",
       "                                                Crime  \\\n",
       "15  * Kleine Nachrichten. Der 31jährige Comptoiris...   \n",
       "16  (Der Raubmordversuch an einem Auswanderer.) Un...   \n",
       "17  Auf Grund der Ergebnisse des Beweisverfahrens ...   \n",
       "18  schwiegen\\nWie eine Auswanderung finanziert we...   \n",
       "19  Die Angeklagte reiste nach der Auswanderung ih...   \n",
       "\n",
       "                                              Finance  \\\n",
       "15  Die beiden Schiffe, die die Auswanderer\\nnach ...   \n",
       "16  scheinsalscher\\nDer jüdische Kaufmann Karl Fah...   \n",
       "17  Arbeiter dieses kapitalistische Denkmal errich...   \n",
       "18  sch, Ungarisch, Tschechif\\npanischer und portu...   \n",
       "19  Die „Abtreibungsklinik“ des Artisten\\nSchädlin...   \n",
       "\n",
       "                                            Statistic  \n",
       "15  Es wandern mehr Frauen aus.\\n Gegenüber den Vo...  \n",
       "16  Danach wurde die Verhandlung wieder sachlich. ...  \n",
       "17  Während im ganzen Jahre 1912 über Triest nur 1...  \n",
       "18  Die Mitteilungen des Handelsministers wurden d...  \n",
       "19  monen zur Auswanderung veranlaßten, aber die U...  "
      ]
     },
     "execution_count": 60,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "#transform your lists into a dataframe\n",
    "\n",
    "df_ads = pd.DataFrame(np.column_stack([ads]), \n",
    "                               columns=['Ads'])\n",
    "\n",
    "\n",
    "df_news = pd.DataFrame(np.column_stack([news]), \n",
    "                               columns=['News'])\n",
    "\n",
    "df_culture = pd.DataFrame(np.column_stack([culture]), \n",
    "                               columns=['Culture_Literature'])\n",
    "\n",
    "df_appeals = pd.DataFrame(np.column_stack([appeals]), \n",
    "                               columns=['Appeals_Donations'])\n",
    "\n",
    "df_crime = pd.DataFrame(np.column_stack([crime]), \n",
    "                               columns=['Crime'])\n",
    "\n",
    "\n",
    "\n",
    "df_finance = pd.DataFrame(np.column_stack([finance]), \n",
    "                               columns=['Finance'])\n",
    "\n",
    "df_statistic = pd.DataFrame(np.column_stack([statistic]), \n",
    "                               columns=['Statistic'])\n",
    "\n",
    "df_results = pd.concat([df_ads, df_news, df_culture, df_appeals, df_crime, df_finance, df_statistic], ignore_index=True, axis=1)\n",
    "df_results.columns=['Ads','News', 'Culture_Literatur', 'Appeals_Donations', 'Crime', 'Finance', 'Statistic']\n",
    "df_results[15:20]"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### Now export your dataframe in order to check the results"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 61,
   "metadata": {},
   "outputs": [],
   "source": [
    "df_results.to_excel(\"results_emigration.xlsx\") "
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### Get the dates for your classified articles\n",
    "You will need them later for the visualization"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 62,
   "metadata": {},
   "outputs": [],
   "source": [
    "# Extract the dates for the visualization for every category\n",
    "date_ads = []\n",
    "ads = submission_df_all_2[['id','language','date','newspaper_id','iiif_url','text']][submission_df_all['ads'].isin(max_num)]\n",
    "date = submission_df_all_2['date'][submission_df_all['ads'].isin(max_num)]\n",
    "for key in date: \n",
    "    date_ads.append(key[:4])\n",
    "# Transform the dates from strings to integers\n",
    "for i in range(0, len(date_ads)): \n",
    "    date_ads[i] = int(date_ads[i]) \n",
    "news = submission_df_all_2[['id','language','date','newspaper_id','iiif_url','text']][submission_df_all['news'].isin(max_num)]\n",
    "date_news = []\n",
    "date = submission_df_all_2['date'][submission_df_all['news'].isin(max_num)]\n",
    "for key in date: \n",
    "    date_news.append(key[:4])\n",
    "for i in range(0, len(date_news)): \n",
    "    date_news[i] = int(date_news[i])\n",
    "culture = submission_df_all_2[['id','language','date','newspaper_id','iiif_url','text']][submission_df_all['culture'].isin(max_num)]\n",
    "date_culture = []\n",
    "date = submission_df_all_2['date'][submission_df_all['culture'].isin(max_num)]\n",
    "for key in date: \n",
    "    date_culture.append(key[:4])\n",
    "for i in range(0, len(date_culture)): \n",
    "    date_culture[i] = int(date_culture[i])\n",
    "appeals = submission_df_all_2[['id','language','date','newspaper_id','iiif_url','text']][submission_df_all['appeals'].isin(max_num)]\n",
    "date_appeals = []\n",
    "date = submission_df_all_2['date'][submission_df_all['appeals'].isin(max_num)]\n",
    "for key in date: \n",
    "    date_appeals.append(key[:4])\n",
    "for i in range(0, len(date_appeals)): \n",
    "    date_appeals[i] = int(date_appeals[i])\n",
    "crime = submission_df_all_2[['id','language','date','newspaper_id','iiif_url','text']][submission_df_all['crime'].isin(max_num)]\n",
    "date_crime = []\n",
    "date = submission_df_all_2['date'][submission_df_all['crime'].isin(max_num)]\n",
    "for key in date: \n",
    "    date_crime.append(key[:4])\n",
    "for i in range(0, len(date_crime)): \n",
    "    date_crime[i] = int(date_crime[i])\n",
    "finance = submission_df_all_2[['id','language','date','newspaper_id','iiif_url','text']][submission_df_all['finance'].isin(max_num)]\n",
    "date_finance = []\n",
    "date = submission_df_all_2['date'][submission_df_all['finance'].isin(max_num)]\n",
    "for key in date: \n",
    "    date_finance.append(key[:4])\n",
    "for i in range(0, len(date_finance)): \n",
    "    date_finance[i] = int(date_finance[i])\n",
    "statistic = submission_df_all_2[['id','language','date','newspaper_id','iiif_url','text']][submission_df_all['statistic'].isin(max_num)]\n",
    "date_statistic = []\n",
    "date = submission_df_all_2['date'][submission_df_all['statistic'].isin(max_num)]\n",
    "for key in date: \n",
    "    date_statistic.append(key[:4])\n",
    "for i in range(0, len(date_statistic)): \n",
    "    date_statistic[i] = int(date_statistic[i])"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## If you are satisfied with the results, you can save them in the form of your original file <a class=\"anchor\" id=\"21-bullet\"></a>\n",
    "\n",
    "Otherwise, try to repeat the process"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 63,
   "metadata": {},
   "outputs": [],
   "source": [
    "#transform your lists into a dataframe\n",
    "\n",
    "df_ads = pd.DataFrame(np.column_stack([ads]), \n",
    "                               columns=['id','language','date','newspaper_id','iiif_url','text'])\n",
    "\n",
    "\n",
    "df_news = pd.DataFrame(np.column_stack([news]), \n",
    "                               columns=['id','language','date','newspaper_id','iiif_url','text'])\n",
    "\n",
    "df_culture = pd.DataFrame(np.column_stack([culture]), \n",
    "                               columns=['id','language','date','newspaper_id','iiif_url','text'])\n",
    "\n",
    "df_appeals = pd.DataFrame(np.column_stack([appeals]), \n",
    "                               columns=['id','language','date','newspaper_id','iiif_url','text'])\n",
    "\n",
    "df_crime = pd.DataFrame(np.column_stack([crime]), \n",
    "                               columns=['id','language','date','newspaper_id','iiif_url','text'])\n",
    "\n",
    "df_finance = pd.DataFrame(np.column_stack([finance]), \n",
    "                               columns=['id','language','date','newspaper_id','iiif_url','text'])\n",
    "\n",
    "df_statistic = pd.DataFrame(np.column_stack([statistic]), \n",
    "                               columns=['id','language','date','newspaper_id','iiif_url','text'])\n"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### Have a look at your data\n",
    "you can create this for every category"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 64,
   "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>id</th>\n",
       "      <th>language</th>\n",
       "      <th>date</th>\n",
       "      <th>newspaper_id</th>\n",
       "      <th>iiif_url</th>\n",
       "      <th>text</th>\n",
       "    </tr>\n",
       "  </thead>\n",
       "  <tbody>\n",
       "    <tr>\n",
       "      <td>0</td>\n",
       "      <td>illustrierte_kronen_zeitung_krz19390708_articl...</td>\n",
       "      <td>de</td>\n",
       "      <td>1939-07-08T00:00:00Z</td>\n",
       "      <td>illustrierte_kronen_zeitung</td>\n",
       "      <td>https://platform.newseye.eu/iiif/illustrierte_...</td>\n",
       "      <td>schafft.\\nIn dieser Vereinigung werden die Ju...</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <td>1</td>\n",
       "      <td>illustrierte_kronen_zeitung_krz19390708_articl...</td>\n",
       "      <td>de</td>\n",
       "      <td>1939-07-08T00:00:00Z</td>\n",
       "      <td>illustrierte_kronen_zeitung</td>\n",
       "      <td>https://platform.newseye.eu/iiif/illustrierte_...</td>\n",
       "      <td>Die Reichsvereinigung ist verpflichtet, für di...</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <td>2</td>\n",
       "      <td>arbeiter_zeitung_aze19140628_article_125</td>\n",
       "      <td>de</td>\n",
       "      <td>1914-06-28T00:00:00Z</td>\n",
       "      <td>arbeiter_zeitung</td>\n",
       "      <td>https://platform.newseye.eu/iiif/arbeiter_zeit...</td>\n",
       "      <td>Der griechisch=türkische Konflikt.\\nDie Antwor...</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <td>3</td>\n",
       "      <td>arbeiter_zeitung_aze19140628_article_126</td>\n",
       "      <td>de</td>\n",
       "      <td>1914-06-28T00:00:00Z</td>\n",
       "      <td>arbeiter_zeitung</td>\n",
       "      <td>https://platform.newseye.eu/iiif/arbeiter_zeit...</td>\n",
       "      <td>In hiesigen diplomatischen Kreisen glaubt man ...</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <td>4</td>\n",
       "      <td>arbeiter_zeitung_aze19140626_article_138</td>\n",
       "      <td>de</td>\n",
       "      <td>1914-06-26T00:00:00Z</td>\n",
       "      <td>arbeiter_zeitung</td>\n",
       "      <td>https://platform.newseye.eu/iiif/arbeiter_zeit...</td>\n",
       "      <td>Dieser Aufruf ist ja sehr heiter. Er gibt aber...</td>\n",
       "    </tr>\n",
       "    <tr>\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",
       "      <td>422</td>\n",
       "      <td>neue_freie_presse_nfp18650524_article_558</td>\n",
       "      <td>de</td>\n",
       "      <td>1865-05-24T00:00:00Z</td>\n",
       "      <td>neue_freie_presse</td>\n",
       "      <td>https://platform.newseye.eu/iiif/neue_freie_pr...</td>\n",
       "      <td>Wegen Mexicos, welches übrigens alles Andere i...</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <td>423</td>\n",
       "      <td>neue_freie_presse_nfp18650924_article_114</td>\n",
       "      <td>de</td>\n",
       "      <td>1865-09-24T00:00:00Z</td>\n",
       "      <td>neue_freie_presse</td>\n",
       "      <td>https://platform.newseye.eu/iiif/neue_freie_pr...</td>\n",
       "      <td>Der Hunger und die Auswanderung haben das Ihri...</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <td>424</td>\n",
       "      <td>neue_freie_presse_nfp18651007_article_105</td>\n",
       "      <td>de</td>\n",
       "      <td>1865-10-07T00:00:00Z</td>\n",
       "      <td>neue_freie_presse</td>\n",
       "      <td>https://platform.newseye.eu/iiif/neue_freie_pr...</td>\n",
       "      <td>Fiume, 4. October. [Orig.=Corr.] (Zichy's Bros...</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <td>425</td>\n",
       "      <td>neue_freie_presse_nfp19111221_article_5882</td>\n",
       "      <td>de</td>\n",
       "      <td>1911-12-21T00:00:00Z</td>\n",
       "      <td>neue_freie_presse</td>\n",
       "      <td>https://platform.newseye.eu/iiif/neue_freie_pr...</td>\n",
       "      <td>Dr. Ktein nder das Baupfgndracht. Interpenlatl...</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <td>426</td>\n",
       "      <td>neue_freie_presse_nfp19110302_article_418</td>\n",
       "      <td>de</td>\n",
       "      <td>1911-03-02T00:00:00Z</td>\n",
       "      <td>neue_freie_presse</td>\n",
       "      <td>https://platform.newseye.eu/iiif/neue_freie_pr...</td>\n",
       "      <td>Delegjerter Sourup fortfahrend, verlangt vom M...</td>\n",
       "    </tr>\n",
       "  </tbody>\n",
       "</table>\n",
       "<p>427 rows × 6 columns</p>\n",
       "</div>"
      ],
      "text/plain": [
       "                                                    id language  \\\n",
       "0    illustrierte_kronen_zeitung_krz19390708_articl...       de   \n",
       "1    illustrierte_kronen_zeitung_krz19390708_articl...       de   \n",
       "2             arbeiter_zeitung_aze19140628_article_125       de   \n",
       "3             arbeiter_zeitung_aze19140628_article_126       de   \n",
       "4             arbeiter_zeitung_aze19140626_article_138       de   \n",
       "..                                                 ...      ...   \n",
       "422          neue_freie_presse_nfp18650524_article_558       de   \n",
       "423          neue_freie_presse_nfp18650924_article_114       de   \n",
       "424          neue_freie_presse_nfp18651007_article_105       de   \n",
       "425         neue_freie_presse_nfp19111221_article_5882       de   \n",
       "426          neue_freie_presse_nfp19110302_article_418       de   \n",
       "\n",
       "                     date                 newspaper_id  \\\n",
       "0    1939-07-08T00:00:00Z  illustrierte_kronen_zeitung   \n",
       "1    1939-07-08T00:00:00Z  illustrierte_kronen_zeitung   \n",
       "2    1914-06-28T00:00:00Z             arbeiter_zeitung   \n",
       "3    1914-06-28T00:00:00Z             arbeiter_zeitung   \n",
       "4    1914-06-26T00:00:00Z             arbeiter_zeitung   \n",
       "..                    ...                          ...   \n",
       "422  1865-05-24T00:00:00Z            neue_freie_presse   \n",
       "423  1865-09-24T00:00:00Z            neue_freie_presse   \n",
       "424  1865-10-07T00:00:00Z            neue_freie_presse   \n",
       "425  1911-12-21T00:00:00Z            neue_freie_presse   \n",
       "426  1911-03-02T00:00:00Z            neue_freie_presse   \n",
       "\n",
       "                                              iiif_url  \\\n",
       "0    https://platform.newseye.eu/iiif/illustrierte_...   \n",
       "1    https://platform.newseye.eu/iiif/illustrierte_...   \n",
       "2    https://platform.newseye.eu/iiif/arbeiter_zeit...   \n",
       "3    https://platform.newseye.eu/iiif/arbeiter_zeit...   \n",
       "4    https://platform.newseye.eu/iiif/arbeiter_zeit...   \n",
       "..                                                 ...   \n",
       "422  https://platform.newseye.eu/iiif/neue_freie_pr...   \n",
       "423  https://platform.newseye.eu/iiif/neue_freie_pr...   \n",
       "424  https://platform.newseye.eu/iiif/neue_freie_pr...   \n",
       "425  https://platform.newseye.eu/iiif/neue_freie_pr...   \n",
       "426  https://platform.newseye.eu/iiif/neue_freie_pr...   \n",
       "\n",
       "                                                  text  \n",
       "0     schafft.\\nIn dieser Vereinigung werden die Ju...  \n",
       "1    Die Reichsvereinigung ist verpflichtet, für di...  \n",
       "2    Der griechisch=türkische Konflikt.\\nDie Antwor...  \n",
       "3    In hiesigen diplomatischen Kreisen glaubt man ...  \n",
       "4    Dieser Aufruf ist ja sehr heiter. Er gibt aber...  \n",
       "..                                                 ...  \n",
       "422  Wegen Mexicos, welches übrigens alles Andere i...  \n",
       "423  Der Hunger und die Auswanderung haben das Ihri...  \n",
       "424  Fiume, 4. October. [Orig.=Corr.] (Zichy's Bros...  \n",
       "425  Dr. Ktein nder das Baupfgndracht. Interpenlatl...  \n",
       "426  Delegjerter Sourup fortfahrend, verlangt vom M...  \n",
       "\n",
       "[427 rows x 6 columns]"
      ]
     },
     "execution_count": 64,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "df_news"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### Export your categorised collections"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 65,
   "metadata": {},
   "outputs": [],
   "source": [
    "df_news.to_csv('collection_news.csv')"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Visualize your results <a class=\"anchor\" id=\"21-bullet\"></a>\n",
    "First, we are going to create a pie chart showing the distribution of every category"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 66,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "image/png": "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\n",
      "text/plain": [
       "<Figure size 1368x504 with 1 Axes>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "import matplotlib.pyplot as plt\n",
    "plt.figure(figsize=(19, 7))\n",
    "# Data to plot\n",
    "labels = 'Advertisement', 'News', 'Culture_Literature_Stories_Letters', 'Appeals_Donations_Information', 'Crime', 'Finance', 'Statistic'\n",
    "sizes = [len(ads), len(news), len(culture), len(appeals), len(crime), len(finance), len(statistic)]\n",
    "colors = ['gold', 'yellowgreen', 'lightcoral', 'lightskyblue', 'blueviolet', 'darkturquoise', 'sandybrown', 'pink']\n",
    "explode = (0, 0, 0, 0, 0, 0, 0)  # explode 1st slice\n",
    "\n",
    "# Plot\n",
    "plt.pie(sizes, explode=explode, labels=labels, colors=colors,\n",
    "autopct='%1.1f%%', shadow=True, startangle=14)\n",
    "\n",
    "plt.axis('equal')\n",
    "plt.show()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Finally, we are creating histograms to find out which category was very popular at what time"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 63,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "image/png": "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\n",
      "text/plain": [
       "<Figure size 2160x360 with 2 Axes>"
      ]
     },
     "metadata": {
      "needs_background": "light"
     },
     "output_type": "display_data"
    },
    {
     "data": {
      "image/png": "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\n",
      "text/plain": [
       "<Figure size 2160x360 with 2 Axes>"
      ]
     },
     "metadata": {
      "needs_background": "light"
     },
     "output_type": "display_data"
    },
    {
     "data": {
      "image/png": "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\n",
      "text/plain": [
       "<Figure size 2160x360 with 2 Axes>"
      ]
     },
     "metadata": {
      "needs_background": "light"
     },
     "output_type": "display_data"
    },
    {
     "data": {
      "image/png": "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\n",
      "text/plain": [
       "<Figure size 2160x360 with 1 Axes>"
      ]
     },
     "metadata": {
      "needs_background": "light"
     },
     "output_type": "display_data"
    }
   ],
   "source": [
    "import matplotlib.axes as ax\n",
    "plt.figure(figsize=(30, 5))\n",
    "\n",
    "plt.subplot(121)\n",
    "plt.hist(date_ads, color = 'gold', orientation=\"vertical\")\n",
    "plt.xlabel('Advertisements', size= 'x-large')\n",
    "plt.subplot(122)\n",
    "plt.hist(date_news, color = 'yellowgreen')\n",
    "plt.xlabel('News', size= 'x-large')\n",
    "plt.show()\n",
    "plt.figure(figsize=(30, 5))\n",
    "plt.subplot(121)\n",
    "plt.hist(date_culture, color = 'lightskyblue')\n",
    "plt.xlabel('Culture_Literature_Storie_Letters', size= 'x-large')\n",
    "plt.subplot(122)\n",
    "plt.hist(date_appeals, color = 'lightcoral')\n",
    "plt.xlabel('Appeals_Donations_Information', size= 'x-large')\n",
    "plt.show()\n",
    "plt.figure(figsize=(30, 5))\n",
    "plt.subplot(121)\n",
    "plt.hist(date_crime, color = 'sandybrown')\n",
    "plt.xlabel('Crime', size= 'x-large')\n",
    "plt.subplot(122)\n",
    "plt.hist(date_finance, color = 'pink')\n",
    "plt.xlabel('Finance', size= 'x-large')\n",
    "plt.figure(figsize=(30, 5))\n",
    "plt.hist(date_statistic, color = 'darkturquoise')\n",
    "plt.xlabel('Statistic', size= 'x-large')\n",
    "plt.show()\n",
    "\n"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {},
   "outputs": [],
   "source": []
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {},
   "outputs": [],
   "source": []
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {},
   "outputs": [],
   "source": []
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {},
   "outputs": [],
   "source": []
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {},
   "outputs": [],
   "source": []
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {},
   "outputs": [],
   "source": []
  }
 ],
 "metadata": {
  "kernelspec": {
   "display_name": "Python 3",
   "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.7.4"
  }
 },
 "nbformat": 4,
 "nbformat_minor": 4
}