docs/notebooks/Word2Vec_FastText_Comparison.ipynb

{
 "cells": [
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "# Comparison of FastText and Word2Vec "
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Facebook Research open sourced a great project recently - [fastText](https://github.com/facebookresearch/fastText), a fast (no surprise) and effective method to learn word representations and perform text classification. I was curious about comparing these embeddings to other commonly used embeddings, so word2vec seemed like the obvious choice, especially considering fastText embeddings are an extension of word2vec. \n",
    "\n",
    "I've used gensim to train the word2vec models, and the analogical reasoning task (described in Section 4.1 of [[2]](https://arxiv.org/pdf/1301.3781v3.pdf)) for comparing the word2vec and fastText models. I've compared embeddings trained using the skipgram architecture."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "# Download data"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 1,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "[nltk_data] Downloading package brown to /home/jayant/nltk_data...\n",
      "[nltk_data]   Package brown is already up-to-date!\n",
      "--2016-08-23 03:29:12--  http://mattmahoney.net/dc/text8.zip\n",
      "Resolving mattmahoney.net (mattmahoney.net)... 98.139.135.129\n",
      "Connecting to mattmahoney.net (mattmahoney.net)|98.139.135.129|:80... connected.\n",
      "HTTP request sent, awaiting response... 416 Requested Range Not Satisfiable\n",
      "\n",
      "    The file is already fully retrieved; nothing to do.\n",
      "\n",
      "Archive:  text8.zip\n",
      "  inflating: text8                   \n",
      "--2016-08-23 03:29:15--  http://mattmahoney.net/dc/enwik9.zip\n",
      "Resolving mattmahoney.net (mattmahoney.net)... 98.139.135.129\n",
      "Connecting to mattmahoney.net (mattmahoney.net)|98.139.135.129|:80... connected.\n",
      "HTTP request sent, awaiting response... 416 Requested Range Not Satisfiable\n",
      "\n",
      "    The file is already fully retrieved; nothing to do.\n",
      "\n",
      "Archive:  enwik9.zip\n",
      "  inflating: enwik9                  \n"
     ]
    }
   ],
   "source": [
    "import nltk\n",
    "from smart_open import smart_open\n",
    "nltk.download('brown') \n",
    "# Only the brown corpus is needed in case you don't have it.\n",
    "\n",
    "# Generate brown corpus text file\n",
    "with smart_open('brown_corp.txt', 'w+') as f:\n",
    "    for word in nltk.corpus.brown.words():\n",
    "        f.write('{word} '.format(word=word))\n",
    "\n",
    "# Make sure you set FT_HOME to your fastText directory root\n",
    "FT_HOME = 'fastText/'\n",
    "# download the text8 corpus (a 100 MB sample of cleaned wikipedia text)\n",
    "import os.path\n",
    "if not os.path.isfile('text8'):\n",
    "    !wget -c http://mattmahoney.net/dc/text8.zip\n",
    "    !unzip text8.zip\n",
    "# download and preprocess the text9 corpus\n",
    "if not os.path.isfile('text9'):\n",
    "  !wget -c http://mattmahoney.net/dc/enwik9.zip\n",
    "  !unzip enwik9.zip\n",
    "  !perl {FT_HOME}wikifil.pl enwik9 > text9"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "# Train models"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "For training the models yourself, you'll need to have both [Gensim](https://github.com/RaRe-Technologies/gensim) and [FastText](https://github.com/facebookresearch/fastText) set up on your machine."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 2,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Training fasttext on brown_corp.txt corpus..\n",
      "Read 1M words\n",
      "Progress: 100.0%  words/sec/thread: 42250  lr: 0.000001  loss: 2.291523  eta: 0h0m \n",
      "Train time: 46.000000 sec\n",
      "CPU times: user 1.03 s, sys: 152 ms, total: 1.18 s\n",
      "Wall time: 54.3 s\n",
      "\n",
      "Training fasttext on brown_corp.txt corpus (without char n-grams)..\n",
      "Read 1M words\n",
      "Progress: 100.0%  words/sec/thread: 78714  lr: 0.000001  loss: 2.360077  eta: 0h0m \n",
      "Train time: 25.000000 sec\n",
      "CPU times: user 908 ms, sys: 124 ms, total: 1.03 s\n",
      "Wall time: 32.5 s\n",
      "\n",
      "Training word2vec on brown_corp.txt corpus..\n",
      "CPU times: user 41.4 s, sys: 0 ns, total: 41.4 s\n",
      "Wall time: 18 s\n",
      "\n",
      "Saved gensim model as brown_gs.vec\n"
     ]
    }
   ],
   "source": [
    "MODELS_DIR = 'models/'\n",
    "!mkdir -p {MODELS_DIR}\n",
    "\n",
    "lr = 0.05\n",
    "dim = 100\n",
    "ws = 5\n",
    "epoch = 5\n",
    "minCount = 5\n",
    "neg = 5\n",
    "loss = 'ns'\n",
    "t = 1e-4\n",
    "\n",
    "from gensim.models import Word2Vec, KeyedVectors\n",
    "from gensim.models.word2vec import Text8Corpus\n",
    "\n",
    "# Same values as used for fastText training above\n",
    "params = {\n",
    "    'alpha': lr,\n",
    "    'size': dim,\n",
    "    'window': ws,\n",
    "    'iter': epoch,\n",
    "    'min_count': minCount,\n",
    "    'sample': t,\n",
    "    'sg': 1,\n",
    "    'hs': 0,\n",
    "    'negative': neg\n",
    "}\n",
    "\n",
    "def train_models(corpus_file, output_name):\n",
    "    output_file = '{:s}_ft'.format(output_name)\n",
    "    if not os.path.isfile(os.path.join(MODELS_DIR, '{:s}.vec'.format(output_file))):\n",
    "        print('Training fasttext on {:s} corpus..'.format(corpus_file))\n",
    "        %time !{FT_HOME}fasttext skipgram -input {corpus_file} -output {MODELS_DIR+output_file}  -lr {lr} -dim {dim} -ws {ws} -epoch {epoch} -minCount {minCount} -neg {neg} -loss {loss} -t {t}\n",
    "    else:\n",
    "        print('\\nUsing existing model file {:s}.vec'.format(output_file))\n",
    "        \n",
    "    output_file = '{:s}_ft_no_ng'.format(output_name)\n",
    "    if not os.path.isfile(os.path.join(MODELS_DIR, '{:s}.vec'.format(output_file))):\n",
    "        print('\\nTraining fasttext on {:s} corpus (without char n-grams)..'.format(corpus_file))\n",
    "        %time !{FT_HOME}fasttext skipgram -input {corpus_file} -output {MODELS_DIR+output_file}  -lr {lr} -dim {dim} -ws {ws} -epoch {epoch} -minCount {minCount} -neg {neg} -loss {loss} -t {t} -maxn 0\n",
    "    else:\n",
    "        print('\\nUsing existing model file {:s}.vec'.format(output_file))\n",
    "        \n",
    "    output_file = '{:s}_gs'.format(output_name)\n",
    "    if not os.path.isfile(os.path.join(MODELS_DIR, '{:s}.vec'.format(output_file))):\n",
    "        print('\\nTraining word2vec on {:s} corpus..'.format(corpus_file))\n",
    "        \n",
    "        # Text8Corpus class for reading space-separated words file\n",
    "        %time gs_model = Word2Vec(Text8Corpus(corpus_file), **params); gs_model\n",
    "        # Direct local variable lookup doesn't work properly with magic statements (%time)\n",
    "        locals()['gs_model'].wv.save_word2vec_format(os.path.join(MODELS_DIR, '{:s}.vec'.format(output_file)))\n",
    "        print('\\nSaved gensim model as {:s}.vec'.format(output_file))\n",
    "    else:\n",
    "        print('\\nUsing existing model file {:s}.vec'.format(output_file))\n",
    "\n",
    "evaluation_data = {}\n",
    "train_models('brown_corp.txt', 'brown')"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 3,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Training fasttext on text8 corpus..\n",
      "Read 17M words\n",
      "Progress: 100.0%  words/sec/thread: 33709  lr: 0.000001  loss: 1.833047  eta: 0h0m \n",
      "Train time: 926.000000 sec\n",
      "CPU times: user 42.1 s, sys: 4.63 s, total: 46.8 s\n",
      "Wall time: 15min 42s\n",
      "\n",
      "Training fasttext on text8 corpus (without char n-grams)..\n",
      "Read 17M words\n",
      "Progress: 100.0%  words/sec/thread: 66780  lr: 0.000001  loss: 1.878257  eta: 0h0m \n",
      "Train time: 479.000000 sec\n",
      "CPU times: user 29.8 s, sys: 3.46 s, total: 33.3 s\n",
      "Wall time: 8min 16s\n",
      "\n",
      "Training word2vec on text8 corpus..\n",
      "CPU times: user 16min 16s, sys: 3.91 s, total: 16min 20s\n",
      "Wall time: 6min 42s\n",
      "\n",
      "Saved gensim model as text8_gs.vec\n"
     ]
    }
   ],
   "source": [
    "train_models(corpus_file='text8', output_name='text8')"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 4,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Training fasttext on text9 corpus..\n",
      "Read 124M words\n",
      "Progress: 100.0%  words/sec/thread: 34687  lr: 0.000001  loss: 1.617828  eta: 0h0m \n",
      "Train time: 6519.000000 sec\n",
      "CPU times: user 5min 38s, sys: 37.4 s, total: 6min 16s\n",
      "Wall time: 1h 49min 49s\n",
      "\n",
      "Training fasttext on text9 corpus (without char n-grams)..\n",
      "Read 124M words\n",
      "Progress: 100.0%  words/sec/thread: 67558  lr: 0.000001  loss: 1.645820  eta: 0h0m \n",
      "Train time: 3465.000000 sec\n",
      "CPU times: user 3min 32s, sys: 23.4 s, total: 3min 56s\n",
      "Wall time: 59min 10s\n",
      "\n",
      "Training word2vec on text9 corpus..\n",
      "CPU times: user 2h 6min 34s, sys: 36.6 s, total: 2h 7min 10s\n",
      "Wall time: 53min 38s\n",
      "\n",
      "Saved gensim model as text9_gs.vec\n"
     ]
    }
   ],
   "source": [
    "train_models(corpus_file='text9', output_name='text9')"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "# Comparisons"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 15,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "--2016-08-21 10:31:16--  https://raw.githubusercontent.com/tmikolov/word2vec/master/questions-words.txt\n",
      "Resolving raw.githubusercontent.com (raw.githubusercontent.com)... 151.101.100.133\n",
      "Connecting to raw.githubusercontent.com (raw.githubusercontent.com)|151.101.100.133|:443... connected.\n",
      "HTTP request sent, awaiting response... 200 OK\n",
      "Length: 603955 (590K) [text/plain]\n",
      "Saving to: ‘questions-words.txt’\n",
      "\n",
      "100%[======================================>] 6,03,955     554KB/s   in 1.1s   \n",
      "\n",
      "2016-08-21 10:31:17 (554 KB/s) - ‘questions-words.txt’ saved [603955/603955]\n",
      "\n"
     ]
    }
   ],
   "source": [
    "# download the file questions-words.txt to be used for comparing word embeddings\n",
    "!wget https://raw.githubusercontent.com/tmikolov/word2vec/master/questions-words.txt"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Once you have downloaded or trained the models and downloaded `questions-words.txt`, you're ready to run the comparison."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 14,
   "metadata": {},
   "outputs": [
    {
     "name": "stderr",
     "output_type": "stream",
     "text": [
      "2016-08-23 10:32:14,416 : INFO : loading projection weights from models/brown_gs.vec\n"
     ]
    },
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "\n",
      "Loading Gensim embeddings\n"
     ]
    },
    {
     "name": "stderr",
     "output_type": "stream",
     "text": [
      "2016-08-23 10:32:15,938 : INFO : loaded (15173, 100) matrix from models/brown_gs.vec\n",
      "2016-08-23 10:32:16,060 : INFO : precomputing L2-norms of word weight vectors\n"
     ]
    },
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Accuracy for Word2Vec:\n",
      "Evaluating...\n",
      "\n"
     ]
    },
    {
     "name": "stderr",
     "output_type": "stream",
     "text": [
      "2016-08-23 10:32:16,746 : INFO : family: 20.3% (37/182)\n",
      "2016-08-23 10:32:21,631 : INFO : gram1-adjective-to-adverb: 0.0% (0/702)\n",
      "2016-08-23 10:32:22,421 : INFO : gram2-opposite: 0.0% (0/132)\n",
      "2016-08-23 10:32:29,033 : INFO : gram3-comparative: 2.1% (22/1056)\n",
      "2016-08-23 10:32:29,698 : INFO : gram4-superlative: 0.0% (0/210)\n",
      "2016-08-23 10:32:33,248 : INFO : gram5-present-participle: 0.3% (2/650)\n",
      "2016-08-23 10:32:37,647 : INFO : gram7-past-tense: 0.9% (11/1260)\n",
      "2016-08-23 10:32:41,156 : INFO : gram8-plural: 5.4% (30/552)\n",
      "2016-08-23 10:32:42,238 : INFO : gram9-plural-verbs: 0.9% (3/342)\n",
      "2016-08-23 10:32:42,240 : INFO : total: 2.1% (105/5086)\n",
      "2016-08-23 10:32:42,247 : INFO : loading projection weights from models/brown_ft.vec\n"
     ]
    },
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "\n",
      "Semantic: 37/182, Accuracy: 20.33%\n",
      "Syntactic: 68/4904, Accuracy: 1.39%\n",
      "\n",
      "\n",
      "Loading FastText embeddings\n"
     ]
    },
    {
     "name": "stderr",
     "output_type": "stream",
     "text": [
      "2016-08-23 10:32:45,542 : INFO : loaded (15173, 100) matrix from models/brown_ft.vec\n",
      "2016-08-23 10:32:45,636 : INFO : precomputing L2-norms of word weight vectors\n"
     ]
    },
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Accuracy for FastText (with n-grams):\n",
      "Evaluating...\n",
      "\n"
     ]
    },
    {
     "name": "stderr",
     "output_type": "stream",
     "text": [
      "2016-08-23 10:32:46,240 : INFO : family: 15.4% (28/182)\n",
      "2016-08-23 10:32:50,291 : INFO : gram1-adjective-to-adverb: 73.4% (515/702)\n",
      "2016-08-23 10:32:50,752 : INFO : gram2-opposite: 81.1% (107/132)\n",
      "2016-08-23 10:32:56,089 : INFO : gram3-comparative: 58.7% (620/1056)\n",
      "2016-08-23 10:32:57,538 : INFO : gram4-superlative: 67.1% (141/210)\n",
      "2016-08-23 10:33:00,715 : INFO : gram5-present-participle: 65.8% (428/650)\n",
      "2016-08-23 10:33:06,537 : INFO : gram7-past-tense: 13.9% (175/1260)\n",
      "2016-08-23 10:33:10,094 : INFO : gram8-plural: 55.4% (306/552)\n",
      "2016-08-23 10:33:11,211 : INFO : gram9-plural-verbs: 74.0% (253/342)\n",
      "2016-08-23 10:33:11,212 : INFO : total: 50.6% (2573/5086)\n"
     ]
    },
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "\n",
      "Semantic: 28/182, Accuracy: 15.38%\n",
      "Syntactic: 2545/4904, Accuracy: 51.90%\n",
      "\n"
     ]
    }
   ],
   "source": [
    "import logging\n",
    "logging.basicConfig(format='%(asctime)s : %(levelname)s : %(message)s', level=logging.INFO)\n",
    "\n",
    "# Training times in seconds\n",
    "evaluation_data['brown'] = [(18, 54.3, 32.5)]\n",
    "evaluation_data['text8'] = [(402, 942, 496)]\n",
    "evaluation_data['text9'] = [(3218, 6589, 3550)]\n",
    "\n",
    "def print_accuracy(model, questions_file):\n",
    "    print('Evaluating...\\n')\n",
    "    acc = model.accuracy(questions_file)\n",
    "\n",
    "    sem_correct = sum((len(acc[i]['correct']) for i in range(5)))\n",
    "    sem_total = sum((len(acc[i]['correct']) + len(acc[i]['incorrect'])) for i in range(5))\n",
    "    sem_acc = 100*float(sem_correct)/sem_total\n",
    "    print('\\nSemantic: {:d}/{:d}, Accuracy: {:.2f}%'.format(sem_correct, sem_total, sem_acc))\n",
    "    \n",
    "    syn_correct = sum((len(acc[i]['correct']) for i in range(5, len(acc)-1)))\n",
    "    syn_total = sum((len(acc[i]['correct']) + len(acc[i]['incorrect'])) for i in range(5,len(acc)-1))\n",
    "    syn_acc = 100*float(syn_correct)/syn_total\n",
    "    print('Syntactic: {:d}/{:d}, Accuracy: {:.2f}%\\n'.format(syn_correct, syn_total, syn_acc))\n",
    "    return (sem_acc, syn_acc)\n",
    "\n",
    "word_analogies_file = 'questions-words.txt'\n",
    "accuracies = []\n",
    "print('\\nLoading Gensim embeddings')\n",
    "brown_gs = KeyedVectors.load_word2vec_format(MODELS_DIR + 'brown_gs.vec')\n",
    "print('Accuracy for Word2Vec:')\n",
    "accuracies.append(print_accuracy(brown_gs, word_analogies_file))\n",
    "\n",
    "print('\\nLoading FastText embeddings')\n",
    "brown_ft = KeyedVectors.load_word2vec_format(MODELS_DIR + 'brown_ft.vec')\n",
    "print('Accuracy for FastText (with n-grams):')\n",
    "accuracies.append(print_accuracy(brown_ft, word_analogies_file))"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "The `accuracy` takes an optional parameter `restrict_vocab`, which limits the vocabulary of model considered for fast approximate evaluation (default is 30000).\n",
    "\n",
    "Word2Vec embeddings seem to be slightly better than fastText embeddings at the semantic tasks, while the fastText embeddings do significantly better on the syntactic analogies. Makes sense, since fastText embeddings are trained for understanding morphological nuances, and most of the syntactic analogies are morphology based. \n",
    "\n",
    "Let me explain that better.\n",
    "\n",
    "According to the paper [[1]](https://arxiv.org/abs/1607.04606), embeddings for words are represented by the sum of their n-gram embeddings. This is meant to be useful for morphologically rich languages - so theoretically, the embedding for `apparently` would include information from both character n-grams `apparent` and `ly` (as well as other n-grams), and the n-grams would combine in a simple, linear manner. This is very similar to what most of our syntactic tasks look like.\n",
    "\n",
    "Example analogy:\n",
    "\n",
    "`amazing amazingly calm calmly`\n",
    "\n",
    "This analogy is marked correct if: \n",
    "\n",
    "`embedding(amazing)` - `embedding(amazingly)` = `embedding(calm)` - `embedding(calmly)`\n",
    "\n",
    "Both these subtractions would result in a very similar set of remaining ngrams.\n",
    "No surprise the fastText embeddings do extremely well on this.\n",
    "\n",
    "Let's do a small test to validate this hypothesis - fastText differs from word2vec only in that it uses char n-gram embeddings as well as the actual word embedding in the scoring function to calculate scores and then likelihoods for each word, given a context word. In case char n-gram embeddings are not present, this reduces (at least theoretically) to the original word2vec model. This can be implemented by setting 0 for the max length of char n-grams for fastText.\n"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 15,
   "metadata": {},
   "outputs": [
    {
     "name": "stderr",
     "output_type": "stream",
     "text": [
      "2016-08-23 10:33:57,845 : INFO : loading projection weights from models/brown_ft_no_ng.vec\n"
     ]
    },
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Loading FastText embeddings\n"
     ]
    },
    {
     "name": "stderr",
     "output_type": "stream",
     "text": [
      "2016-08-23 10:33:59,447 : INFO : loaded (15173, 100) matrix from models/brown_ft_no_ng.vec\n",
      "2016-08-23 10:33:59,538 : INFO : precomputing L2-norms of word weight vectors\n"
     ]
    },
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Accuracy for FastText (without n-grams):\n",
      "Evaluating...\n",
      "\n"
     ]
    },
    {
     "name": "stderr",
     "output_type": "stream",
     "text": [
      "2016-08-23 10:34:00,435 : INFO : family: 17.0% (31/182)\n",
      "2016-08-23 10:34:02,610 : INFO : gram1-adjective-to-adverb: 0.1% (1/702)\n",
      "2016-08-23 10:34:03,012 : INFO : gram2-opposite: 0.8% (1/132)\n",
      "2016-08-23 10:34:06,230 : INFO : gram3-comparative: 2.9% (31/1056)\n",
      "2016-08-23 10:34:06,876 : INFO : gram4-superlative: 0.5% (1/210)\n",
      "2016-08-23 10:34:09,941 : INFO : gram5-present-participle: 1.1% (7/650)\n",
      "2016-08-23 10:34:14,521 : INFO : gram7-past-tense: 0.7% (9/1260)\n",
      "2016-08-23 10:34:16,379 : INFO : gram8-plural: 5.3% (29/552)\n",
      "2016-08-23 10:34:17,978 : INFO : gram9-plural-verbs: 2.0% (7/342)\n",
      "2016-08-23 10:34:17,980 : INFO : total: 2.3% (117/5086)\n"
     ]
    },
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "\n",
      "Semantic: 31/182, Accuracy: 17.03%\n",
      "Syntactic: 86/4904, Accuracy: 1.75%\n",
      "\n"
     ]
    }
   ],
   "source": [
    "print('Loading FastText embeddings')\n",
    "brown_ft_no_ng = KeyedVectors.load_word2vec_format(MODELS_DIR + 'brown_ft_no_ng.vec')\n",
    "print('Accuracy for FastText (without n-grams):')\n",
    "accuracies.append(print_accuracy(brown_ft_no_ng, word_analogies_file))\n",
    "evaluation_data['brown'] += [[acc[0] for acc in accuracies], [acc[1] for acc in accuracies]]"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "A-ha! The results for FastText with no n-grams and Word2Vec look a lot more similar (as they should) - the differences could easily result from differences in implementation between fastText and Gensim, and randomization. Especially telling is that the semantic accuracy for FastText has improved slightly after removing n-grams, while the syntactic accuracy has taken a giant dive. Our hypothesis that the char n-grams result in better performance on syntactic analogies seems fair. It also seems possible that char n-grams hurt semantic accuracy a little. However, the brown corpus is too small to be able to draw any definite conclusions - the accuracies seem to vary significantly over different runs."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Let's try with a larger corpus now - text8 (collection of wiki articles). I'm also curious about the impact on semantic accuracy - for models trained on the brown corpus, the difference in the semantic accuracy and the accuracy values themselves are too small to be conclusive. Hopefully a larger corpus helps, and the text8 corpus likely has a lot more information about capitals, currencies, cities etc, which should be relevant to the semantic tasks."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 16,
   "metadata": {},
   "outputs": [
    {
     "name": "stderr",
     "output_type": "stream",
     "text": [
      "2016-08-23 10:34:18,050 : INFO : loading projection weights from models/text8_gs.vec\n"
     ]
    },
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Loading Gensim embeddings\n"
     ]
    },
    {
     "name": "stderr",
     "output_type": "stream",
     "text": [
      "2016-08-23 10:34:25,739 : INFO : loaded (71290, 100) matrix from models/text8_gs.vec\n",
      "2016-08-23 10:34:25,927 : INFO : precomputing L2-norms of word weight vectors\n"
     ]
    },
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Accuracy for word2vec:\n",
      "Evaluating...\n",
      "\n"
     ]
    },
    {
     "name": "stderr",
     "output_type": "stream",
     "text": [
      "2016-08-23 10:34:28,601 : INFO : capital-common-countries: 67.0% (339/506)\n",
      "2016-08-23 10:34:40,531 : INFO : capital-world: 45.3% (658/1452)\n",
      "2016-08-23 10:34:42,060 : INFO : currency: 20.9% (56/268)\n",
      "2016-08-23 10:34:53,593 : INFO : city-in-state: 23.2% (365/1571)\n",
      "2016-08-23 10:34:57,068 : INFO : family: 59.2% (181/306)\n",
      "2016-08-23 10:35:03,180 : INFO : gram1-adjective-to-adverb: 14.3% (108/756)\n",
      "2016-08-23 10:35:06,024 : INFO : gram2-opposite: 11.4% (35/306)\n",
      "2016-08-23 10:35:17,130 : INFO : gram3-comparative: 50.2% (633/1260)\n",
      "2016-08-23 10:35:21,890 : INFO : gram4-superlative: 30.8% (156/506)\n",
      "2016-08-23 10:35:29,381 : INFO : gram5-present-participle: 26.6% (264/992)\n",
      "2016-08-23 10:35:40,566 : INFO : gram6-nationality-adjective: 76.9% (1054/1371)\n",
      "2016-08-23 10:35:51,950 : INFO : gram7-past-tense: 29.2% (389/1332)\n",
      "2016-08-23 10:36:01,483 : INFO : gram8-plural: 52.0% (516/992)\n",
      "2016-08-23 10:36:07,185 : INFO : gram9-plural-verbs: 30.9% (201/650)\n",
      "2016-08-23 10:36:07,187 : INFO : total: 40.4% (4955/12268)\n",
      "2016-08-23 10:36:07,194 : INFO : loading projection weights from models/text8_ft.vec\n"
     ]
    },
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "\n",
      "Semantic: 1599/4103, Accuracy: 38.97%\n",
      "Syntactic: 3356/8165, Accuracy: 41.10%\n",
      "\n",
      "Loading FastText embeddings (with n-grams)\n"
     ]
    },
    {
     "name": "stderr",
     "output_type": "stream",
     "text": [
      "2016-08-23 10:36:15,551 : INFO : loaded (71290, 100) matrix from models/text8_ft.vec\n",
      "2016-08-23 10:36:15,761 : INFO : precomputing L2-norms of word weight vectors\n"
     ]
    },
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Accuracy for FastText (with n-grams):\n",
      "Evaluating...\n",
      "\n"
     ]
    },
    {
     "name": "stderr",
     "output_type": "stream",
     "text": [
      "2016-08-23 10:36:20,631 : INFO : capital-common-countries: 57.5% (291/506)\n",
      "2016-08-23 10:36:31,906 : INFO : capital-world: 44.6% (647/1452)\n",
      "2016-08-23 10:36:34,651 : INFO : currency: 17.2% (46/268)\n",
      "2016-08-23 10:36:49,641 : INFO : city-in-state: 18.0% (272/1511)\n",
      "2016-08-23 10:36:51,402 : INFO : family: 51.0% (156/306)\n",
      "2016-08-23 10:36:59,474 : INFO : gram1-adjective-to-adverb: 76.3% (577/756)\n",
      "2016-08-23 10:37:01,244 : INFO : gram2-opposite: 62.7% (192/306)\n",
      "2016-08-23 10:37:14,023 : INFO : gram3-comparative: 60.5% (762/1260)\n",
      "2016-08-23 10:37:18,805 : INFO : gram4-superlative: 55.3% (280/506)\n",
      "2016-08-23 10:37:28,822 : INFO : gram5-present-participle: 55.6% (552/992)\n",
      "2016-08-23 10:37:39,523 : INFO : gram6-nationality-adjective: 93.1% (1276/1371)\n",
      "2016-08-23 10:37:52,889 : INFO : gram7-past-tense: 38.0% (506/1332)\n",
      "2016-08-23 10:38:01,988 : INFO : gram8-plural: 87.8% (871/992)\n",
      "2016-08-23 10:38:07,999 : INFO : gram9-plural-verbs: 57.5% (374/650)\n",
      "2016-08-23 10:38:08,013 : INFO : total: 55.7% (6802/12208)\n",
      "2016-08-23 10:38:08,032 : INFO : loading projection weights from models/text8_ft_no_ng.vec\n"
     ]
    },
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "\n",
      "Semantic: 1412/4043, Accuracy: 34.92%\n",
      "Syntactic: 5390/8165, Accuracy: 66.01%\n",
      "\n",
      "Loading FastText embeddings\n"
     ]
    },
    {
     "name": "stderr",
     "output_type": "stream",
     "text": [
      "2016-08-23 10:38:16,212 : INFO : loaded (71290, 100) matrix from models/text8_ft_no_ng.vec\n",
      "2016-08-23 10:38:16,423 : INFO : precomputing L2-norms of word weight vectors\n"
     ]
    },
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Accuracy for FastText (without n-grams):\n",
      "Evaluating...\n",
      "\n"
     ]
    },
    {
     "name": "stderr",
     "output_type": "stream",
     "text": [
      "2016-08-23 10:38:19,529 : INFO : capital-common-countries: 71.7% (363/506)\n",
      "2016-08-23 10:38:31,840 : INFO : capital-world: 49.1% (713/1452)\n",
      "2016-08-23 10:38:33,427 : INFO : currency: 25.0% (67/268)\n",
      "2016-08-23 10:38:45,850 : INFO : city-in-state: 22.3% (337/1511)\n",
      "2016-08-23 10:38:47,491 : INFO : family: 56.5% (173/306)\n",
      "2016-08-23 10:38:55,203 : INFO : gram1-adjective-to-adverb: 19.0% (144/756)\n",
      "2016-08-23 10:38:56,777 : INFO : gram2-opposite: 13.7% (42/306)\n",
      "2016-08-23 10:39:07,522 : INFO : gram3-comparative: 45.1% (568/1260)\n",
      "2016-08-23 10:39:12,079 : INFO : gram4-superlative: 28.3% (143/506)\n",
      "2016-08-23 10:39:21,022 : INFO : gram5-present-participle: 22.3% (221/992)\n",
      "2016-08-23 10:39:32,463 : INFO : gram6-nationality-adjective: 78.6% (1078/1371)\n",
      "2016-08-23 10:39:45,108 : INFO : gram7-past-tense: 32.0% (426/1332)\n",
      "2016-08-23 10:39:52,383 : INFO : gram8-plural: 54.6% (542/992)\n",
      "2016-08-23 10:39:57,698 : INFO : gram9-plural-verbs: 23.2% (151/650)\n",
      "2016-08-23 10:39:57,707 : INFO : total: 40.7% (4968/12208)\n"
     ]
    },
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "\n",
      "Semantic: 1653/4043, Accuracy: 40.89%\n",
      "Syntactic: 3315/8165, Accuracy: 40.60%\n",
      "\n"
     ]
    }
   ],
   "source": [
    "accuracies = []\n",
    "print('Loading Gensim embeddings')\n",
    "text8_gs = KeyedVectors.load_word2vec_format(MODELS_DIR + 'text8_gs.vec')\n",
    "print('Accuracy for word2vec:')\n",
    "accuracies.append(print_accuracy(text8_gs, word_analogies_file))\n",
    "\n",
    "print('Loading FastText embeddings (with n-grams)')\n",
    "text8_ft = KeyedVectors.load_word2vec_format(MODELS_DIR + 'text8_ft.vec')\n",
    "print('Accuracy for FastText (with n-grams):')\n",
    "accuracies.append(print_accuracy(text8_ft, word_analogies_file))\n",
    "\n",
    "print('Loading FastText embeddings')\n",
    "text8_ft_no_ng = KeyedVectors.load_word2vec_format(MODELS_DIR + 'text8_ft_no_ng.vec')\n",
    "print('Accuracy for FastText (without n-grams):')\n",
    "accuracies.append(print_accuracy(text8_ft_no_ng, word_analogies_file))\n",
    "\n",
    "evaluation_data['text8'] += [[acc[0] for acc in accuracies], [acc[1] for acc in accuracies]]"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "With the text8 corpus, we observe a similar pattern. Semantic accuracy falls by a small but significant amount when n-grams are included in FastText, while FastText with n-grams performs far better on the syntactic analogies. FastText without n-grams are largely similar to Word2Vec.\n",
    "\n",
    "My hypothesis for semantic accuracy being lower for the FastText-with-ngrams model is that most of the words in the semantic analogies are standalone words and are unrelated to their morphemes (eg: father, mother, France, Paris), hence inclusion of the char n-grams into the scoring function actually makes the embeddings worse.\n",
    "\n",
    "This trend is observed in the original paper too where the performance of embeddings with n-grams is worse on semantic tasks than both word2vec cbow and skipgram models.\n",
    "\n",
    "Let's do a quick comparison on an even larger corpus - text9 "
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 17,
   "metadata": {},
   "outputs": [
    {
     "name": "stderr",
     "output_type": "stream",
     "text": [
      "2016-08-23 10:40:04,786 : INFO : loading projection weights from models/text9_gs.vec\n"
     ]
    },
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Loading Gensim embeddings\n"
     ]
    },
    {
     "name": "stderr",
     "output_type": "stream",
     "text": [
      "2016-08-23 10:40:30,884 : INFO : loaded (218316, 100) matrix from models/text9_gs.vec\n"
     ]
    },
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Accuracy for word2vec:\n",
      "Evaluating...\n",
      "\n"
     ]
    },
    {
     "name": "stderr",
     "output_type": "stream",
     "text": [
      "2016-08-23 10:40:31,775 : INFO : precomputing L2-norms of word weight vectors\n",
      "2016-08-23 10:40:34,765 : INFO : capital-common-countries: 84.2% (426/506)\n",
      "2016-08-23 10:40:48,132 : INFO : capital-world: 74.6% (1221/1636)\n",
      "2016-08-23 10:40:49,018 : INFO : currency: 21.9% (39/178)\n",
      "2016-08-23 10:41:06,134 : INFO : city-in-state: 41.8% (891/2133)\n",
      "2016-08-23 10:41:10,016 : INFO : family: 67.1% (255/380)\n",
      "2016-08-23 10:41:15,973 : INFO : gram1-adjective-to-adverb: 28.7% (233/812)\n",
      "2016-08-23 10:41:19,624 : INFO : gram2-opposite: 33.3% (114/342)\n",
      "2016-08-23 10:41:30,799 : INFO : gram3-comparative: 67.1% (846/1260)\n",
      "2016-08-23 10:41:35,522 : INFO : gram4-superlative: 51.8% (262/506)\n",
      "2016-08-23 10:41:42,860 : INFO : gram5-present-participle: 51.8% (482/930)\n",
      "2016-08-23 10:41:58,254 : INFO : gram6-nationality-adjective: 91.2% (1250/1371)\n",
      "2016-08-23 10:42:11,573 : INFO : gram7-past-tense: 49.3% (657/1332)\n",
      "2016-08-23 10:42:21,335 : INFO : gram8-plural: 75.2% (794/1056)\n",
      "2016-08-23 10:42:27,170 : INFO : gram9-plural-verbs: 47.4% (333/702)\n",
      "2016-08-23 10:42:27,172 : INFO : total: 59.4% (7803/13144)\n",
      "2016-08-23 10:42:27,179 : INFO : loading projection weights from models/text9_ft.vec\n"
     ]
    },
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "\n",
      "Semantic: 2832/4833, Accuracy: 58.60%\n",
      "Syntactic: 4971/8311, Accuracy: 59.81%\n",
      "\n",
      "Loading FastText embeddings (with n-grams)\n"
     ]
    },
    {
     "name": "stderr",
     "output_type": "stream",
     "text": [
      "2016-08-23 10:42:52,360 : INFO : loaded (218316, 100) matrix from models/text9_ft.vec\n"
     ]
    },
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Accuracy for FastText (with n-grams):\n",
      "Evaluating...\n",
      "\n"
     ]
    },
    {
     "name": "stderr",
     "output_type": "stream",
     "text": [
      "2016-08-23 10:42:53,500 : INFO : precomputing L2-norms of word weight vectors\n",
      "2016-08-23 10:42:58,763 : INFO : capital-common-countries: 84.6% (428/506)\n",
      "2016-08-23 10:43:14,010 : INFO : capital-world: 71.8% (1174/1636)\n",
      "2016-08-23 10:43:16,987 : INFO : currency: 22.5% (40/178)\n",
      "2016-08-23 10:43:38,323 : INFO : city-in-state: 33.0% (703/2133)\n",
      "2016-08-23 10:43:41,400 : INFO : family: 59.5% (226/380)\n",
      "2016-08-23 10:43:49,864 : INFO : gram1-adjective-to-adverb: 55.5% (451/812)\n",
      "2016-08-23 10:43:53,560 : INFO : gram2-opposite: 50.6% (173/342)\n",
      "2016-08-23 10:44:04,678 : INFO : gram3-comparative: 72.9% (919/1260)\n",
      "2016-08-23 10:44:09,314 : INFO : gram4-superlative: 58.1% (294/506)\n",
      "2016-08-23 10:44:16,302 : INFO : gram5-present-participle: 55.7% (518/930)\n",
      "2016-08-23 10:44:29,878 : INFO : gram6-nationality-adjective: 94.5% (1296/1371)\n",
      "2016-08-23 10:44:42,831 : INFO : gram7-past-tense: 48.0% (640/1332)\n",
      "2016-08-23 10:44:52,464 : INFO : gram8-plural: 83.5% (882/1056)\n",
      "2016-08-23 10:44:58,566 : INFO : gram9-plural-verbs: 55.7% (391/702)\n",
      "2016-08-23 10:44:58,576 : INFO : total: 61.9% (8135/13144)\n",
      "2016-08-23 10:44:58,589 : INFO : loading projection weights from models/text9_ft_no_ng.vec\n"
     ]
    },
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "\n",
      "Semantic: 2571/4833, Accuracy: 53.20%\n",
      "Syntactic: 5564/8311, Accuracy: 66.95%\n",
      "\n",
      "Loading FastText embeddings\n"
     ]
    },
    {
     "name": "stderr",
     "output_type": "stream",
     "text": [
      "2016-08-23 10:45:24,650 : INFO : loaded (218316, 100) matrix from models/text9_ft_no_ng.vec\n"
     ]
    },
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Accuracy for FastText (without n-grams):\n",
      "Evaluating...\n",
      "\n"
     ]
    },
    {
     "name": "stderr",
     "output_type": "stream",
     "text": [
      "2016-08-23 10:45:25,641 : INFO : precomputing L2-norms of word weight vectors\n",
      "2016-08-23 10:45:29,053 : INFO : capital-common-countries: 87.7% (444/506)\n",
      "2016-08-23 10:45:44,191 : INFO : capital-world: 77.3% (1264/1636)\n",
      "2016-08-23 10:45:45,169 : INFO : currency: 19.7% (35/178)\n",
      "2016-08-23 10:46:03,906 : INFO : city-in-state: 39.2% (836/2133)\n",
      "2016-08-23 10:46:08,098 : INFO : family: 62.9% (239/380)\n",
      "2016-08-23 10:46:14,351 : INFO : gram1-adjective-to-adverb: 30.7% (249/812)\n",
      "2016-08-23 10:46:18,093 : INFO : gram2-opposite: 32.7% (112/342)\n",
      "2016-08-23 10:46:28,567 : INFO : gram3-comparative: 70.2% (885/1260)\n",
      "2016-08-23 10:46:33,014 : INFO : gram4-superlative: 49.4% (250/506)\n",
      "2016-08-23 10:46:39,864 : INFO : gram5-present-participle: 48.1% (447/930)\n",
      "2016-08-23 10:46:52,864 : INFO : gram6-nationality-adjective: 93.1% (1277/1371)\n",
      "2016-08-23 10:47:03,413 : INFO : gram7-past-tense: 47.2% (629/1332)\n",
      "2016-08-23 10:47:15,591 : INFO : gram8-plural: 78.3% (827/1056)\n",
      "2016-08-23 10:47:21,488 : INFO : gram9-plural-verbs: 43.0% (302/702)\n",
      "2016-08-23 10:47:21,491 : INFO : total: 59.3% (7796/13144)\n"
     ]
    },
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "\n",
      "Semantic: 2818/4833, Accuracy: 58.31%\n",
      "Syntactic: 4978/8311, Accuracy: 59.90%\n",
      "\n"
     ]
    }
   ],
   "source": [
    "accuracies = []\n",
    "print('Loading Gensim embeddings')\n",
    "text9_gs = KeyedVectors.load_word2vec_format(MODELS_DIR + 'text9_gs.vec')\n",
    "print('Accuracy for word2vec:')\n",
    "accuracies.append(print_accuracy(text9_gs, word_analogies_file))\n",
    "\n",
    "print('Loading FastText embeddings (with n-grams)')\n",
    "text9_ft = KeyedVectors.load_word2vec_format(MODELS_DIR + 'text9_ft.vec')\n",
    "print('Accuracy for FastText (with n-grams):')\n",
    "accuracies.append(print_accuracy(text9_ft, word_analogies_file))\n",
    "\n",
    "print('Loading FastText embeddings')\n",
    "text9_ft_no_ng = KeyedVectors.load_word2vec_format(MODELS_DIR + 'text9_ft_no_ng.vec')\n",
    "print('Accuracy for FastText (without n-grams):')\n",
    "accuracies.append(print_accuracy(text9_ft_no_ng, word_analogies_file))\n",
    "\n",
    "evaluation_data['text9'] += [[acc[0] for acc in accuracies], [acc[1] for acc in accuracies]]"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 23,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "image/png": "iVBORw0KGgoAAAANSUhEUgAAAogAAANwCAYAAACs/5t6AAAABHNCSVQICAgIfAhkiAAAAAlwSFlz\nAAALEgAACxIB0t1+/AAAIABJREFUeJzs3Xl8FdX9//HXhx2BkAQwgEBAwQ1FqqVo1RJQ8Su2glJR\nqwIqUNHWn0ul1goEba34RdG6YFVEsCqKIoj6dUOD1dadvSoihE3ZJEhAZf38/phJvDdmucC9uTfJ\n+/l45JE5Z2bOfG7u5OaTM3POmLsjIiIiIlKkVrIDEBEREZHUogRRRERERKIoQRQRERGRKEoQRURE\nRCSKEkQRERERiaIEUURERESiKEEUkWrNzJabWa9kxyEiUpUoQRQRERGRKEoQRUQAM6ud7BhERFKF\nEkQRqQl+ZmaLzexrM5toZvXMrIeZrTKzEWb2FfAIgJkNNbPPzWyjmc0ws5Zhfa6Z/T1crmNmW83s\ntrDcwMy+M7OmZpZtZnvMbKCZrTCz9WZ2Y9JeuYjIPlCCKCI1wW+A04BDgMOAm8L6lkA60A4YFt6r\neCvwa6AVsBJ4Ktx2DtAjXO4GrI0o/xz41N2/iTjmiUAn4FRglJkdFv+XJSKSGEoQRaQmuMfdv3T3\nzcBfgQvC+t3AaHff6e7bCRLJie4+3913An8CTjCzdsB/gE5mlgH8ApgIHGRmB4TlORHHcyDX3Xe4\n+wJgPnBMJbxOEZG4UIIoIjXB6ojlFUDrcHlDmAgWaR2uB8DdtwFfAwe5+/fAh0AOQUKYB/wbOImg\nJzEyQQRYF7H8LdB4f1+EiEhlUYIoIjVB24jlbODLcNlLbPdluB4AM2sENAPWhFVvAb2ArsAHYfl0\ngkvOb8U9ahGRJFGCKCI1wZVmdpCZZRJcNp4a1luJ7Z4ALjGzLmZWn+B+xHfdfWW4fg4wEPivu+8i\n6EUcAix3968j2inZrohIlaIEUUSqOydI/F4FloZff41Y98OG7m8AI4HpBL2GHYDzIzb5N9CA8HKy\nu/8X+I4fX14u2TNZsiwiktLMXZ9bIiIiIvID9SCKiIiISBQliCIiIiISRQmiiIiIiERRgigiIiIi\nUeokO4B4MjONuBEREZEqw91TclqsapUgAmhUdtWRm5tLbm5ussMQqZDOValKdL5WHWYpmRsCusQs\nIiIiIiUoQRQRERGRKEoQJWlycnKSHYJITHSuSlWi81XioVo9ScXMvDq9HhEREam+zEyDVJKpffv2\nrFixItlhiOyV7Oxs8vPzkx2GiIjUQDWiBzHM0JMQkci+03krIlK9pXIPou5BFBEREZEoShBFRERE\nJIoSRBERERGJogSxhnr77bc54ogjkh2GiIiIpKAaO0jlzjG5FKxZnbBYMg5qw7Wjc2PefurUqdx1\n110sWrSIxo0b06FDBwYOHMjw4cMTFqOkNg1SERGp3lJ5kEqNmOamNAVrVnPjcV0S1v6tHy2Ieds7\n7riDcePGcf/999O7d28aNWrE/PnzGTduHEOGDKFu3boJi1NERESkJF1iTrItW7YwevRoJkyYwNln\nn02jRo0AOOaYY3jssceoW7cuO3bs4A9/+APZ2dm0atWKK664gu3btwMwZ84c2rZty5133klWVhYH\nHXQQjz76aHH7L730Ep07dyYtLa14u8j9inTo0IFx48ZxzDHH0KRJE4YOHcr69evp06cPaWlp9O7d\nm2+++abyfjAiIiKSNEoQk+w///kPO3bs4KyzzipzmxEjRrB06VIWLFjA0qVLWbNmDTfffHPx+rVr\n11JYWMiXX37Jww8/zJVXXlmczA0ZMoSHHnqILVu2sGjRInr16lW8n1l0r/b06dOZPXs2S5Ys4fnn\nn6dPnz7cdtttfP311+zevZu///3vcX71IiIikoqUICbZxo0bad68ObVq/fBWnHjiiWRkZNCoUSPe\neustHn74YcaPH0/Tpk1p1KgRN9xwA08++WTx9vXq1WPkyJHUrl2bM844g8aNG/PZZ58Vr1u8eDGF\nhYU0bdqUrl27lhnL73//e5o3b06rVq04+eST6d69O126dKFu3bqcffbZzJ07N3E/CBEREUkZShCT\nrFmzZmzcuJE9e/YU173zzjsUFBTQrFkz1q9fz7fffstxxx1HZmYmmZmZnHHGGXz99ddRbUQmmAcc\ncABbt24F4Nlnn+XFF18kOzubnj178u6775YZS1ZWVvFyw4YNf1QualNERESqNyWISXbCCSdQv359\nZs6c+aN17k6zZs044IADWLx4MZs2bWLTpk1s3rw55vsBjzvuOGbMmMGGDRvo27cvAwYMiPdLEBER\nkWpGCWKSNW3alFGjRnHFFVfw7LPPsm3bNtydefPm8e2331K7dm2GDh3K1VdfzYYNGwBYs2YNr776\naoVt79y5kyeeeIItW7ZQu3ZtmjRpQp06NXbguoiIiMRICWIKuP7667nzzju5/fbbycrKomXLlgwf\n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\nSJQamyBu/no1ucOPTlj7uRMWxrytmfHiiy/Ss2fPuBy7KMks8tBDD/HQQw8BMHLkSNasWcMjjzwS\nl2PFYsKECVXiWc27d++mdu3alXa83/zmNzzwwANKEEVEJOXoEnOKKO2Zu+7OueeeS6tWrcjMzKRX\nr158+umnxetfeOEFjjzySNLS0mjXrh133303W7Zs4ayzzmLlypU0adKEtLQ0Nm7cWOHx58yZQ/fu\n3cnIyKBbt268++67AKxbt46WLVuSl5cHwObNm2nXrh0zZsxg/PjxzJgxg9GjR5OWlsaFF15Yatsv\nv/xyVBJ03333cfrpp/O73/2O9PR0Dj300OL2AVauXEmfPn3IzMzkiCOO4PHHHy8z7sWLF9OwYUMm\nTpxImzZtaNmyJXfddVfx+q1bt3L++eeTkZHBMcccw6233soRR/zwCO8WLVowfvx4OnfuTLNmzYDg\ncY0dOnQgLS2NY445hpdffvlHsV9xxRWkp6dz+OGHM3fuXB544AHatGlD69ateeaZZ4q3nz59Oocf\nfjhpaWlkZ2czYcKE4nU5OTlRbYuIiKQKJYgp7le/+hVffPEFa9eu5aijjorqibv00kuZNGkSW7Zs\nYcGCBfTo0YO0tDRmzZpFu3btKCwsZMuWLTRv3rzcYyxbtoz+/ftz++23U1BQwOjRo+nbty+FhYVk\nZWXxwAMPMGjQIL755huGDx/OaaedRr9+/bjmmmvo168fY8aMYcuWLaUmcuvXr2fDhg0cdthhUfV5\neXmcfPLJFBQU8Nvf/pahQ4cWr+vfvz9HH30069evZ8qUKfz+97/n/fffLzP+HTt2sHDhQpYvX87M\nmTP54x//yKpVqwC44YYb2LJlC6tXr+b5559nypQpUb2rANOmTePNN99k3bp1ABx55JG8//77fPPN\nN1x77bWcd955bN68OSr2U045hU2bNtGnTx/OOeccli1bRn5+Pvfddx+XX345u3btAuCyyy5j6tSp\nbNmyhblz53LiiScWt3PooYeydetW8vPzy31/REREKpsSxBTRr18/MjMzyczM5JxzzgGCS88DBw7k\ngAMOoF69eowaNYqPPvqI7777DoB69eqxePFitm7dSnp6Ol27/ugJhTF59NFHOe+884p7+X75y1/S\nqVMnXn/99eLYTj31VE4++WTef/997r777pjb3rx5M7Vr16Z+/fpR9Z07d+a8884rfo3Lli3j22+/\n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\n69at+ec//0m/fv1K3WbHjh3ceOONTJs2jR07dnD22Wczfvx46tevz5w5c7jooou45pprGDt2LHXq\n1OGvf/0rgwcPBuCll17i+uuvZ9WqVTRt2pRr/j97dx6n13j/f/z1TiIhyySTYCzZkBBFKF8VRTO2\nKkVSKrRUxJJKtVp8S6rCoAt+WlQ1aksTVXsI2i9qmfjypYpEloaIiCxkk0QWW8jn98c5M+57Msud\nyczc90zez8djHnOu65xznc89c809n/s651znvPM4//zzK/ebNy+ZQWiHHXbgnHPO4c4772T27Nmc\ndNJJle08//zzDBgwgPvvv5/OnRt14nbL4BFEM7OWrZBHEBv1GkSr24svvshnn33GscceW+M2F154\nIbNmzWLKlCnMmjWLBQsWcMUVV1SuX7hwIatWreK9997jtttu45xzzuHDD5MHzZx55pnceuutrFy5\nkmnTpnHIIYdU7ld1nr3x48fz9NNPM3PmTB555BGOOuoorrrqKj744AO++OIL/vCHPzTwqzczM7NC\n5AQxz5YuXcqWW25Jq1Zf/ioOOOAAiouL6dChA8899xy33XYb1113HZ07d6ZDhw6MHDmSu+++u3L7\ntm3bMmrUKFq3bs2RRx5Jx44defPNNyvXTZ8+nVWrVtG5c+esaX+q+slPfsKWW27Jtttuy0EHHcR+\n++1H//792WyzzfjOd77DpEmTGu8HYWZmZgXDCWKedevWjaVLl7Ju3brKuhdeeIHly5fTrVs3Fi9e\nzEcffcQ+++xD165d6dq1K0ceeSQffPBBVhuZCWb79u1ZvXo1AA8++CB///vf6dWrFwcffDAvvfRS\njbGUlJRULm+xxRbrlSvaNDMzs5bNCWKe7b///rRr144JEyasty4i6NatG+3bt2f69OksW7aMZcuW\nsWLFispTyHXZZ599ePjhh1myZAmDBg1iyJAhDf0SzMzMrIVxgphnnTt35tJLL+VHP/oRDz74IGvW\nrCEimDx5Mh999BGtW7fmrLPO4mc/+xlLliwBYMGCBTz55JN1tr127Vr+9re/sXLlSlq3bk2nTp1o\n02aTvXHdzMzMcuQEsQD8/Oc/5/e//z3XXHMNJSUlbLPNNowYMYJrrrmGr3/961x11VX06dOHAQMG\n0KVLF775zW8yc+bMGtvLvPnkzjvvZIcddqBLly7ccsst3HXXXXXuU13ZzMzMNh2b7DQ3hTQPoll1\n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\n1Cbdtq2keyS9JelFST039vgrPphP2Yg9Gu1rQ5PP6ua7iwhOOOEEtt12W7p27cohhxzCG2+8Ubn+\nscce4ytf+QpFRUX07NmTG264gZUrV3Lssccyd+7cylHDpUuX1nn8iRMnst9++1FcXMy+++7LSy+9\nBMCiRYvYZpttKif5XLFiBT179uThhx/muuuu4+GHH+ayyy6jqKiIk08+udq2H3/88awk6KabbuKI\nI47gxz/+MV26dGHnnXfOmkR07ty5HHXUUXTt2pVdd92Vu+66q8a4p0+fzhZbbMHtt99O9+7d2Wab\nbbj++usr169evZqTTjqJ4uJi9txzT37zm9+w6667Vq7faqutuO6669htt93o1q0bAGVlZeywww4U\nFRWx55578vjjj68X+49+9CO6dOlCv379mDRpEjfffDPdu3dnu+2244EHHqjcfvz48fTr14+ioiJ6\n9erF6NGjK9eVlpZmtW1mZlYo8pIgStoO+Amwd0T0JxnJ/B5wNfC7iNgFWAGcke5yBsnkkH2B64Ha\nz2m2IMcccwxvv/02CxcuZPfdd88aiTv99NMZM2YMK1euZMqUKQwcOJCioiIeffRRevbsyapVq1i5\nciVbbrllrceYPXs2xx9/PNdccw3Lly/nsssuY9CgQaxatYqSkhJuvvlmhg4dyocffsiIESM4/PDD\nGTx4MOeddx6DBw/m8ssvZ+XKldUmcosXL2bJkiXssssuWfXl5eUcdNBBLF++nB/+8IecddZZleuO\nP/549thjDxYvXsy4ceP4yU9+wssvv1xj/J999hlTp07lnXfeYcKECVx00UXMmzcPgJEjR7Jy5Urm\nz5/PI488wrhx47JGVwHuv/9+nn32WRYtWgTAV77yFV5++WU+/PBDzj//fE488URWrFiRFfuhhx7K\nsmXLOOqoozjuuOOYPXs2c+bM4aabbuLss8/m888/B+CMM87gnnvuYeXKlUyaNIkDDjigsp2dd96Z\n1atX1zWjvpmZWZPL5zWIrYEO6SjhFsB7wMEkj5QBGAsMTpcHpWWAB4BDmzDOJjF48GC6du1K165d\nOe6444Dk1POpp55K+/btadu2LZdeeimvvvoqH3/8MQBt27Zl+vTprF69mi5durDXXnvV69h/+ctf\nOPHEEytH+Y4++mj69u3LU089VRnbYYcdxkEHHcTLL7/MDTfckHPbK1asoHXr1rRr1y6rfrfdduPE\n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\n1RHx+2rWKQqoc0g6FDgnIo7Ldyy24SQNAH4HDIyIzyV1BdpGxMI8xDIGeCwiHtyINv4FfEJy6mdc\ngwW3/nFaRcS6xmrfqteQ/XVj+puk3sCjEbHHhu6b0caRwC+BkohotA/UklpHxBeN1b41PY8gbtoq\n7/qWtJOk6ZL+KmkasI2kP0t6WdJUSZdkbPu/kvqnn0yXS/qtpMmSXpC0ZbrNlZLOzdj+t5L+JWlG\n+uaLpPaSHkg/pd8v6d+S+ucc/Ppx/C5t638kfU1SuaRZkr6Vbt863ealNN7TG+jnaHXbFlgaEZ8D\nRMSyin+2kvZOf1f/Tn93JWn9s5J+n9ZPl/Rfkh6U9KakKysalvRQus1USWdm1K+S9Kv0d/1/kraS\ntD9wLHBNOiq0g6Qxko5L99k37ceT037SoeoLkbQj0AG4BPh+Rn0rSf9P0pR0/3NqalPSUEk3Zuz7\nqKRvZMR9raRJwABJo9K/wymSbs7YZydJ/0zbfSV9LeMkHZOxzV8lHb1Rv7lNU7X9VdIhksZXbCTp\nMEkPpMu59rcz09/npPR9b/N0/60ljU/3n5S+T/4W2Cnd92olNy1MTbevtr9V43vA9cBcSftlxF5d\nv6ypD7+jJElG0j6Snk2XL0v73PPAuDS+59L++Er6GiqOd2Ha7iRJv5G0o6RXM9b3kfTKRv7erCFF\nhL820S/gMuD8dHkn4HNg74z1XdLvrYHngH5p+X+B/mn9OpL5miD5xH1hunwlcG7G9r9Nl48B/idd\nvgi4MV3uD6wF+tcQ66HA+Cp1VeM4JK1/BPg7yQegvYF/p/UjMuJrC7wGdM/372FT+CJJqCYBbwA3\nAd9I69sALwDd0vIQklE5gGcz+s25wAJg6/R3Nw8ortJPNwemZtSvA45Kl68GLk6XxwDHZcQ2BjgO\n2Ax4u+JvAOgItKrmtfwSuJjkA9ZsYMu0/mzgfr48M9OlhjZbA0OBP2S0+WjGz2QdcHzGui4Zy+OA\nb6fLLwHHZvTnzYFvAA+ldUXpsdd7Df6qX39N1/0no7/eldHHcu1vxRnLV5KcGYHkaRkV75kCOgG9\ngCkZ21eWSd7PsvpbNa9jc5IpUzYHzgRuSOtr6pfr9eH0+2yga7q8D/BMunwZyR23bTOOV7Hchy/f\ne48EngfaVWn3adL3fODXFT8LfxXGl0cQLdPbEfFaRvnk9BPea0A/4CvV7PNRRDyZLr8K9K6h7fEZ\n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\n5cIoV9QVSjwuu+yyyy5vXLliOccZKnK9f6NRbLIjiKOGn8nF+/RvtFh+8//bu/P4qqpz/+OfBxBU\nxjDFgUkFoWqRailYryXgTCviBFpbAQUEUa/DLVAUCGLr8KOlahVFlKkISkVB26soGqxehaoog1RA\nRARkkgABFBme3x97n3hOzLATODkn8H2/Xnllr3X2Xvs5yUryZK291/5gISPHjou075/+9CdGjRrF\nY489xgUXXED16tX5+OOPGTVqFE8//TRHHHFE0uKU9KURRBGRQ1sJI4jF3b8xCMhw96TdpFIpWQ1L\nNNu3b2f48OGMGTOGyy67jOrVqwNw+umnM3nyZI444gi+++47/ud//oemTZty7LHHctNNN7F7924A\n5s6dS+PGjfnzn/9MZmYmxx9/PBMmTMhv/5///CennnoqtWrVyt8v/riYE044gVGjRnH66adTs2ZN\n+vTpw8aNG+ncuTO1atXiggsuYNu2pN1NLyIiIqHw/o3zgBlx1Q8A55vZp+Fr9yczBiWIKfbuu+/y\n3Xff0aVLlyL3GThwICtWrGDhwoWsWLGCtWvXcs899+S/vn79evLy8li3bh3jxo1jwIAB+clc7969\nefLJJ9m+fTuLFy+mU6dO+ccVXGdvxowZzJkzh2XLljFr1iw6d+7M/fffz9dff82+fft4+OGHD/K7\nFxERkYLc/Rt3bxC7uTes2+Lu57l7S3c/v+BKLgebEsQU27x5M/Xr16dSpe+/FWeffTYZGRlUr16d\nt956i3HjxjF69Ghq165N9erVGTx4MFOnTs3fv2rVqgwdOpTKlStz8cUXU6NGDT799NP815YsWUJe\nXh61a9emTZs2RcZyyy23UL9+fY499ljOOecc2rVrR+vWrTniiCO47LLLWLBgQfK+ECIiIpI2lCCm\nWL169di8eTP79+/Pr3vnnXfIzc2lXr16bNy4kV27dnHmmWdSt25d6taty8UXX8zXX3+d0EZ8gnn0\n0UezY8cOAJ5//nn+8Y9/0LRpUzp27Mh7771XZCyZmZn520cdddQPyrE2RURE5NCmBDHFzjrrLKpV\nq8bMmTN/8Jq7U69ePY4++miWLFnCli1b2LJlC1u3bo18PeCZZ57Jiy++yKZNm7j00kvp1q3bwX4L\nIiIicohRgphitWvXZtiwYdx00008//zz7Ny5E3fno48+YteuXVSuXJk+ffpw2223sWnTJgDWrl3L\n7NmzS2x7z549PPPMM2zfvp3KlStTs2ZNqlQ55FY2EhERkYPssM0WMo5vxB8/WJjU9qP63e9+R6NG\njXjwwQfp0aMH1atX58QTT+TBBx/k5z//Oe3ateOee+6hffv2fP311xx//PH079+fCy64oND24m8+\nmTx5Mrfccgv79u2jZcuWTJkypcRjCiuLiIjI4eOwXQdRJN2p34qIHNpKetReKh22I4giIiKpNvq+\n4eRuXJPqMEqU0bARt/9+RKrDkHKkBFFERCRFcjeuYWi301IdRolGPrc41SFIOdNNKiIiIiKSQAmi\niIiIiCRQgigiIiIiCZQgioiIiEgCJYgiIiIikkAJooiIiIgkUIIoIiIiIgkO23UQk704aWkWFW3W\nrBkbN26kSpUquDtmxrJlyzjmmGNKfd45c+bQu3dvPv/8cwD69OnDtGnTMDN2796Nu3PkkUcC0LFj\nR2bOnFnqc8RcddVVtG3bloEDB5a5DREREUk/h22CmOzFSUuzqKiZ8Y9//IOOHTse8HljCWbMk08+\nyZNPPgnA0KFDWbt2LU8//fQBn0dEREQOXZpiThMFn7nr7lx11VUce+yx1K1bl06dOvGf//wn//WX\nX36ZU045hVq1atGkSRMeeughtm/fTpcuXVi9ejU1a9akVq1abN68ucRzz507l3bt2pGRkUHbtm15\n7733ANiwYQPHHHMMOTk5AGzdupUmTZrw4osvMnr0aF588UWGDx9OrVq1uPbaaw/eF0NERERSSgli\nGrvkkkv47LPPWL9+Paeddhq//e1v81+7/vrrGT9+PNu3b2fhwoV06NCBWrVq8dJLL9GkSRPy8vLY\nvn079evXL/YcK1eu5IorruDBBx8kNzeX4cOHc+mll5KXl0dmZiaPP/44PXr0YNu2bfTv35/zzz+f\nrl27cvvtt9O1a1dGjBjB9u3bmTJlSrK/HCIiIlJOlCCmia5du1K3bl3q1q3L5Zdfjplx3XXXcfTR\nR1O1alWGDRvGBx98wDfffANA1apVWbJkCTt27KBOnTq0adOmTOedMGEC3bt3p0OHDgD86le/okWL\nFrz++uv5cZ133nmcc845zJ8/n4ceeujgvGERERFJW0oQ08TMmTPZsmULW7ZsYcaMGezfv5+BAwdy\n0kknUadOHVq0aIGZ5U8Zv/DCC8ycOZMmTZrQqVMn5s+fX6bzfvHFF4wfPz4/Oc3IyODjjz9m3bp1\n+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\nJ510Es888wzHHHMMU6dOZd68edx7773s37+fhx9+mCuvvBKAGTNmMGTIENatW0dGRgaDBw+mf//+\nQLD8waBBg4r9vsihLdn/qB5MFf3CfxEpHV2DmOYuueQSPvvsM9avX89pp52WMBJ3/fXXM378eLZv\n387ChQvp0KEDtWrV4qWXXqJJkybk5eWxffv2EpPDlStXcsUVV/Dggw+Sm5vL8OHDufTSS8nLyyMz\nM5PHH3+cHj16sG3bNvr378/5559P165duf322+natSsjRoxg+/bthSaHGzduZNOmTbRs2TKhPicn\nh3POOYfc3FxuvPFG+vTpk//aFVdcwY9//GM2btzIpEmTuOWWW5g/f36R8X/33XcsWrSIzz//nJkz\nZzJo0CC+/PJLAAYPHsz27dtZs2YNs2bNYtKkSQmjqwDTp0/nzTffZMOGDQCccsopzJ8/n23btnHH\nHXfQvXt3tm79/lKPnJwczj33XLZs2ULnzp25/PLLWblyJatWreLRRx+lX79+7N27F4AbbriBadOm\nsX37dhYsWMDZZ5+d387JJ5/Mjh07SloPS0REpNwpQUwTXbt2pW7dutStW5fLL78cCKaer7vuOo4+\n+miqVq3KsGHD+OCDD/jmm28AqFq1KkuWLGHHjh3UqVOHNm3alOncEyZMoHv37vlTnb/61a9o0aIF\nr7/+en5s5513Hueccw7z58/noYceitz21q1bqVy5MtWqVUuoP/XUU+nevXv+e1y5ciW7du1i6dKl\nLF26lJEjR1KlShXatm3Lb37zG/72t78Ve56RI0dyxBFH0K5dO5o3b86iRcFox/Tp0xk2bBjVq1en\nadOm+aN38e68804aNmyYH2O3bt1o0KABZkaPHj1o2LAhCxYsyN//tNNO44orrqBSpUp069aN1atX\nM2LECKpUqcJll13Gjh07WL16NQBHHHEEixcvZufOndStW5fWrROnaatXr56QfIqIiKQDJYhpYubM\nmWzZsoUtW7YwY8YMAPbv38/AgQM56aSTqFOnDi1atMDM2Lx5MwAvvPACM2fOpEmTJnTq1KnYUbbi\nfPHFF4wfPz4/Qc3IyODjjz9m3bp1+fv06dOHxYsX07dvX2rUqBG57YyMDPbt28fu3bsT6uNvwDn6\n6KOBYDr4q6++IjMzk6pVq+a/3rRpU9auXcuuXbuoWbMmNWvWpFatWuTm5gJQrVo1atasmdDejh07\n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\n"
     },
     "output_type": "display_data",
     "metadata": {}
    }
   ],
   "source": [
    "%matplotlib inline\n",
    "import matplotlib.pyplot as plt\n",
    "\n",
    "def plot(ax, data, corpus_name='brown'):\n",
    "    width = 0.25\n",
    "    pos = [(i, i + width, i + 2*width) for i in range(len(data))]\n",
    "    colors = ['#EE3224', '#F78F1E', '#FFC222']\n",
    "    acc_ax = ax.twinx()\n",
    "    # Training time\n",
    "    ax.bar(pos[0],\n",
    "            data[0],\n",
    "            width,\n",
    "            alpha=0.5,\n",
    "            color=colors\n",
    "            )\n",
    "    # Semantic accuracy\n",
    "    acc_ax.bar(pos[1],\n",
    "            data[1],\n",
    "            width,\n",
    "            alpha=0.5,\n",
    "            color=colors\n",
    "            )\n",
    "\n",
    "    # Syntactic accuracy\n",
    "    acc_ax.bar(pos[2],\n",
    "            data[2],\n",
    "            width,\n",
    "            alpha=0.5,\n",
    "            color=colors\n",
    "            )\n",
    "\n",
    "    ax.set_ylabel('Training time (s)')\n",
    "    acc_ax.set_ylabel('Accuracy (%)')\n",
    "    ax.set_title(corpus_name)\n",
    "\n",
    "    acc_ax.set_xticks([p[0] + 1.5 * width for p in pos])\n",
    "    acc_ax.set_xticklabels(['Training Time', 'Semantic Accuracy', 'Syntactic Accuracy'])\n",
    "\n",
    "    # Proxy plots for adding legend correctly\n",
    "    proxies = [ax.bar([0], [0], width=0, color=c, alpha=0.5)[0] for c in colors]\n",
    "    models = ('Gensim', 'FastText', 'FastText (no-ngrams)')\n",
    "    ax.legend((proxies), models, loc='upper left')\n",
    "    \n",
    "    ax.set_xlim(pos[0][0]-width, pos[-1][0]+width*4)\n",
    "    ax.set_ylim([0, max(data[0])*1.1] )\n",
    "    acc_ax.set_ylim([0, max(data[1] + data[2])*1.1] )\n",
    "\n",
    "    plt.grid()\n",
    "\n",
    "# Plotting the bars\n",
    "fig = plt.figure(figsize=(10,15))\n",
    "for corpus, subplot in zip(sorted(evaluation_data.keys()), [311, 312, 313]):\n",
    "    ax = fig.add_subplot(subplot)\n",
    "    plot(ax, evaluation_data[corpus], corpus)\n",
    "\n",
    "plt.show()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "The results from text9 seem to confirm our hypotheses so far. Briefly summarising the main points -\n",
    "\n",
    "1. FastText models with n-grams do significantly better on syntactic tasks, because of the syntactic questions being related to morphology of the words\n",
    "2. Both Gensim word2vec and the fastText model with no n-grams do slightly better on the semantic tasks, presumably because words from the semantic questions are standalone words and unrelated to their char n-grams\n",
    "3. In general, the performance of the models seems to get closer with the increasing corpus size. However, this might possibly be due to the size of the model staying constant at 100, and a larger model size for large corpora might result in higher performance gains.\n",
    "4. The semantic accuracy for all models increases significantly with the increase in corpus size.\n",
    "5. However, the increase in syntactic accuracy from the increase in corpus size for the n-gram FastText model is lower (in both relative and absolute terms). This could possibly indicate that advantages gained by incorporating morphological information could be less significant in case of larger corpus sizes (the corpuses used in the original paper seem to indicate this too)\n",
    "6. Training times for gensim are slightly lower than the fastText no-ngram model, and significantly lower than the n-gram variant. This is quite impressive considering fastText is implemented in C++ and Gensim in Python (with calls to low-level BLAS routines for much of the heavy lifting). You could read [this post](http://rare-technologies.com/word2vec-in-python-part-two-optimizing/) for more details regarding word2vec optimisation in Gensim. Note that these times include importing any dependencies and serializing the models to disk, and not just the training times."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "# Conclusions"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "These preliminary results seem to indicate fastText embeddings are significantly better than word2vec at encoding syntactic information. This is expected, since most syntactic analogies are morphology based, and the char n-gram approach of fastText takes such information into account. The original word2vec model seems to perform better on semantic tasks, since words in semantic analogies are unrelated to their char n-grams, and the added information from irrelevant char n-grams worsens the embeddings. It'd be interesting to see how transferable these embeddings are for different kinds of tasks by comparing their performance in a downstream supervised task."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "# References"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "[1] [Enriching Word Vectors with Subword Information](https://arxiv.org/pdf/1607.04606v1.pdf)\n",
    "\n",
    "[2] [Efficient Estimation of Word Representations in Vector Space](https://arxiv.org/pdf/1301.3781v3.pdf)"
   ]
  }
 ],
 "metadata": {
  "kernelspec": {
   "display_name": "Python 3",
   "language": "python",
   "name": "python3"
  },
  "language_info": {
   "codemirror_mode": {
    "name": "ipython",
    "version": 3.0
   },
   "file_extension": ".py",
   "mimetype": "text/x-python",
   "name": "python",
   "nbconvert_exporter": "python",
   "pygments_lexer": "ipython3",
   "version": "3.4.3"
  }
 },
 "nbformat": 4,
 "nbformat_minor": 0
}