{ "cells": [ { "cell_type": "markdown", "metadata": {}, "source": [ "# Hands-On Lab: Language Understanding with Recurrent Networks\n", "\n", "This hands-on lab shows how to implement a recurrent network to process text,\n", "for the [Air Travel Information Services](https://catalog.ldc.upenn.edu/LDC95S26) \n", "(ATIS) task of slot tagging (tag individual words to their respective classes, \n", "where the classes are provided as labels in the training data set).\n", "We will start with a straight-forward embedding of the words followed by a recurrent LSTM.\n", "This will then be extended to include neighboring words and run bidirectionally.\n", "Lastly, we will turn this system into an intent classifier. \n", "\n", "The techniques you will practice are:\n", "* model description by composing layer blocks, a convenient way to compose \n", " networks/models without requiring the need to write formulas,\n", "* creating your own layer block\n", "* variables with different sequence lengths in the same network\n", "* training the network\n", "\n", "We assume that you are familiar with basics of deep learning, and these specific concepts:\n", "* recurrent networks ([Wikipedia page](https://en.wikipedia.org/wiki/Recurrent_neural_network))\n", "* text embedding ([Wikipedia page](https://en.wikipedia.org/wiki/Word_embedding))\n", "\n", "### Prerequisites\n", "\n", "We assume that you have already [installed CNTK](https://github.com/Microsoft/CNTK/wiki/Setup-CNTK-on-your-machine).\n", "This tutorial requires CNTK V2. We strongly recommend to run this tutorial on a machine with\n", "a capable CUDA-compatible GPU. Deep learning without GPUs is not fun." ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "#### Downloading the data\n", "\n", "In this tutorial we are going to use a (lightly preprocessed) version of the ATIS dataset. You can download the data automatically by running the cells below or by executing the manual instructions.\n", "\n", "#### Fallback manual instructions\n", "Download the ATIS [training](https://github.com/Microsoft/CNTK/blob/v2.0.beta9.0/Tutorials/SLUHandsOn/atis.train.ctf) \n", "and [test](https://github.com/Microsoft/CNTK/blob/v2.0.beta9.0/Tutorials/SLUHandsOn/atis.test.ctf) \n", "files and put them at the same folder as this notebook. If you want to see how the model is \n", "predicting on new sentences you will also need the vocabulary files for \n", "[queries](https://github.com/Microsoft/CNTK/blob/v2.0.beta9.0/Examples/LanguageUnderstanding/ATIS/BrainScript/query.wl) and\n", "[slots](https://github.com/Microsoft/CNTK/blob/v2.0.beta9.0/Examples/LanguageUnderstanding/ATIS/BrainScript/slots.wl)" ] }, { "cell_type": "code", "execution_count": null, "metadata": { "collapsed": false }, "outputs": [], "source": [ "from __future__ import print_function\n", "import requests\n", "import os\n", "\n", "def download(url, filename):\n", " \"\"\" utility function to download a file \"\"\"\n", " response = requests.get(url, stream=True)\n", " with open(filename, \"wb\") as handle:\n", " for data in response.iter_content():\n", " handle.write(data)\n", "\n", "locations = ['Tutorials/SLUHandsOn', 'Examples/LanguageUnderstanding/ATIS/BrainScript']\n", "\n", "data = {\n", " 'train': { 'file': 'atis.train.ctf', 'location': 0 },\n", " 'test': { 'file': 'atis.test.ctf', 'location': 0 },\n", " 'query': { 'file': 'query.wl', 'location': 1 },\n", " 'slots': { 'file': 'slots.wl', 'location': 1 }\n", "}\n", "\n", "for item in data.values():\n", " location = locations[item['location']]\n", " path = os.path.join('..', location, item['file'])\n", " if os.path.exists(path):\n", " print(\"Reusing locally cached:\", item['file'])\n", " # Update path\n", " item['file'] = path\n", " elif os.path.exists(item['file']):\n", " print(\"Reusing locally cached:\", item['file'])\n", " else:\n", " print(\"Starting download:\", item['file'])\n", " url = \"https://github.com/Microsoft/CNTK/blob/v2.0.beta9.0/%s/%s?raw=true\"%(location, item['file'])\n", " download(url, item['file'])\n", " print(\"Download completed\")\n" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "#### Importing CNTK and other useful libraries\n", "\n", "CNTK's Python module contains several submodules like `io`, `learner`, and `layers`. We also use NumPy in some cases since the results returned by CNTK work like NumPy arrays." ] }, { "cell_type": "code", "execution_count": null, "metadata": { "collapsed": true }, "outputs": [], "source": [ "import math\n", "import numpy as np\n", "from cntk.blocks import default_options, LSTM, Placeholder, Input # building blocks\n", "from cntk.layers import Embedding, Recurrence, Dense, BatchNormalization # layers\n", "from cntk.models import Sequential # higher level things\n", "from cntk.utils import ProgressPrinter, log_number_of_parameters\n", "from cntk.io import MinibatchSource, CTFDeserializer\n", "from cntk.io import StreamDef, StreamDefs, INFINITELY_REPEAT, FULL_DATA_SWEEP\n", "from cntk import *\n", "from cntk.learner import adam_sgd, learning_rate_schedule\n", "# Select the right target device when this notebook is being tested:\n", "if 'TEST_DEVICE' in os.environ:\n", " import cntk\n", " if os.environ['TEST_DEVICE'] == 'cpu':\n", " cntk.device.set_default_device(cntk.device.cpu())\n", " else:\n", " cntk.device.set_default_device(cntk.device.gpu(0))\n" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "## Task and Model Structure\n", "\n", "The task we want to approach in this tutorial is slot tagging.\n", "We use the [ATIS corpus](https://catalog.ldc.upenn.edu/LDC95S26).\n", "ATIS contains human-computer queries from the domain of Air Travel Information Services,\n", "and our task will be to annotate (tag) each word of a query whether it belongs to a\n", "specific item of information (slot), and which one.\n", "\n", "The data in your working folder has already been converted into the \"CNTK Text Format.\"\n", "Let's look at an example from the test-set file `atis.test.ctf`:\n", "\n", " 19 |S0 178:1 |# BOS |S1 14:1 |# flight |S2 128:1 |# O\n", " 19 |S0 770:1 |# show |S2 128:1 |# O\n", " 19 |S0 429:1 |# flights |S2 128:1 |# O\n", " 19 |S0 444:1 |# from |S2 128:1 |# O\n", " 19 |S0 272:1 |# burbank |S2 48:1 |# B-fromloc.city_name\n", " 19 |S0 851:1 |# to |S2 128:1 |# O\n", " 19 |S0 789:1 |# st. |S2 78:1 |# B-toloc.city_name\n", " 19 |S0 564:1 |# louis |S2 125:1 |# I-toloc.city_name\n", " 19 |S0 654:1 |# on |S2 128:1 |# O\n", " 19 |S0 601:1 |# monday |S2 26:1 |# B-depart_date.day_name\n", " 19 |S0 179:1 |# EOS |S2 128:1 |# O\n", "\n", "This file has 7 columns:\n", "\n", "* a sequence id (19). There are 11 entries with this sequence id. This means that sequence 19 consists\n", "of 11 tokens;\n", "* column `S0`, which contains numeric word indices;\n", "* a comment column denoted by `#`, to allow a human reader to know what the numeric word index stands for;\n", "Comment columns are ignored by the system. `BOS` and `EOS` are special words\n", "to denote beginning and end of sentence, respectively;\n", "* column `S1` is an intent label, which we will only use in the last part of the tutorial;\n", "* another comment column that shows the human-readable label of the numeric intent index;\n", "* column `S2` is the slot label, represented as a numeric index; and\n", "* another comment column that shows the human-readable label of the numeric label index.\n", "\n", "The task of the neural network is to look at the query (column `S0`) and predict the\n", "slot label (column `S2`).\n", "As you can see, each word in the input gets assigned either an empty label `O`\n", "or a slot label that begins with `B-` for the first word, and with `I-` for any\n", "additional consecutive word that belongs to the same slot.\n", "\n", "The model we will use is a recurrent model consisting of an embedding layer,\n", "a recurrent LSTM cell, and a dense layer to compute the posterior probabilities:\n", "\n", "\n", " slot label \"O\" \"O\" \"O\" \"O\" \"B-fromloc.city_name\"\n", " ^ ^ ^ ^ ^\n", " | | | | |\n", " +-------+ +-------+ +-------+ +-------+ +-------+\n", " | Dense | | Dense | | Dense | | Dense | | Dense | ...\n", " +-------+ +-------+ +-------+ +-------+ +-------+\n", " ^ ^ ^ ^ ^\n", " | | | | |\n", " +------+ +------+ +------+ +------+ +------+ \n", " 0 -->| LSTM |-->| LSTM |-->| LSTM |-->| LSTM |-->| LSTM |-->...\n", " +------+ +------+ +------+ +------+ +------+ \n", " ^ ^ ^ ^ ^\n", " | | | | |\n", " +-------+ +-------+ +-------+ +-------+ +-------+\n", " | Embed | | Embed | | Embed | | Embed | | Embed | ...\n", " +-------+ +-------+ +-------+ +-------+ +-------+\n", " ^ ^ ^ ^ ^\n", " | | | | |\n", " w ------>+--------->+--------->+--------->+--------->+------... \n", " BOS \"show\" \"flights\" \"from\" \"burbank\"\n", "\n", "Or, as a CNTK network description. Please have a quick look and match it with the description above:\n", "(descriptions of these functions can be found at: [the layers reference](http://cntk.ai/pythondocs/layerref.html))\n" ] }, { "cell_type": "code", "execution_count": null, "metadata": { "collapsed": false }, "outputs": [], "source": [ "# number of words in vocab, slot labels, and intent labels\n", "vocab_size = 943 ; num_labels = 129 ; num_intents = 26 \n", "\n", "# model dimensions\n", "input_dim = vocab_size\n", "label_dim = num_labels\n", "emb_dim = 150\n", "hidden_dim = 300\n", "\n", "def create_model():\n", " with default_options(initial_state=0.1):\n", " return Sequential([\n", " Embedding(emb_dim),\n", " Recurrence(LSTM(hidden_dim), go_backwards=False),\n", " Dense(num_labels)\n", " ])" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "Now we are ready to create a model and inspect it.\n" ] }, { "cell_type": "code", "execution_count": null, "metadata": { "collapsed": false }, "outputs": [], "source": [ "# peek\n", "model = create_model()\n", "print(len(model.layers))\n", "print(model.layers[0].E.shape)\n", "print(model.layers[2].b.value)" ] }, { "cell_type": "markdown", "metadata": { "collapsed": false }, "source": [ "As you can see the attributes of the model are fully accessible from Python. The model has 3 layers. The first layer is an embedding and you can access its parameter `E` (where the embeddings are stored) like any other attribute of a Python object. Its shape contains a `-1` which indicates that this parameter is not fully specified yet. When we decide what data we will run through this network (very shortly) the shape will be the size of the input vocabulary. We also print the bias term in the last layer. Bias terms are by default initialized to 0 (but there's also a way to change that).\n" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "## CNTK Configuration\n", "\n", "To train and test a model in CNTK, we need to create a model and specify how to read data and perform training and testing. \n", "\n", "In order to train we need to specify:\n", "\n", "* how to read the data \n", "* the model function, its inputs, and outputs\n", "* hyper-parameters for the learner such as the learning rate\n", "\n", "[comment]: <> (For testing ...)\n", "\n", "### A Brief Look at Data and Data Reading\n", "\n", "We already looked at the data.\n", "But how do you generate this format?\n", "For reading text, this tutorial uses the `CNTKTextFormatReader`. It expects the input data to be\n", "in a specific format, as described [here](https://github.com/Microsoft/CNTK/wiki/CNTKTextFormat-Reader).\n", "\n", "For this tutorial, we created the corpora by two steps:\n", "* convert the raw data into a plain text file that contains of TAB-separated columns of space-separated text. For example:\n", "\n", " ```\n", " BOS show flights from burbank to st. louis on monday EOS (TAB) flight (TAB) O O O O B-fromloc.city_name O B-toloc.city_name I-toloc.city_name O B-depart_date.day_name O\n", " ```\n", "\n", " This is meant to be compatible with the output of the `paste` command.\n", "* convert it to CNTK Text Format (CTF) with the following command:\n", "\n", " ```\n", " python [CNTK root]/Scripts/txt2ctf.py --map query.wl intent.wl slots.wl --annotated True --input atis.test.txt --output atis.test.ctf\n", " ```\n", " where the three `.wl` files give the vocabulary as plain text files, one word per line.\n", "\n", "In these CTF files, our columns are labeled `S0`, `S1`, and `S2`.\n", "These are connected to the actual network inputs by the corresponding lines in the reader definition:" ] }, { "cell_type": "code", "execution_count": null, "metadata": { "collapsed": true }, "outputs": [], "source": [ "def create_reader(path, is_training):\n", " return MinibatchSource(CTFDeserializer(path, StreamDefs(\n", " query = StreamDef(field='S0', shape=vocab_size, is_sparse=True),\n", " intent_unused = StreamDef(field='S1', shape=num_intents, is_sparse=True), \n", " slot_labels = StreamDef(field='S2', shape=num_labels, is_sparse=True)\n", " )), randomize=is_training, epoch_size = INFINITELY_REPEAT if is_training else FULL_DATA_SWEEP)" ] }, { "cell_type": "code", "execution_count": null, "metadata": { "collapsed": false }, "outputs": [], "source": [ "# peek\n", "reader = create_reader(data['train']['file'], is_training=True)\n", "reader.streams.keys()" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "### Trainer\n", "\n", "We also must define the training criterion (loss function), and also an error metric to track. Below we make extensive use of `Placeholders`. Remember that the code we have been writing is not actually executing any heavy computation it is just specifying the function we want to compute on data during training/testing. And in the same way that it is convenient to have names for arguments when you write a regular function in a programming language, it is convenient to have Placeholders that refer to arguments (or local computations that need to be reused). Eventually, some other code will replace these placeholders with other known quantities in the same way that in a programming language the function will be called with concrete values bound to its arguments. " ] }, { "cell_type": "code", "execution_count": null, "metadata": { "collapsed": true }, "outputs": [], "source": [ "def create_criterion_function(model):\n", " labels = Placeholder(name='labels')\n", " ce = cross_entropy_with_softmax(model, labels)\n", " errs = classification_error (model, labels)\n", " return combine ([ce, errs]) # (features, labels) -> (loss, metric)" ] }, { "cell_type": "code", "execution_count": null, "metadata": { "collapsed": false }, "outputs": [], "source": [ "def train(reader, model, max_epochs=16):\n", " # criterion: (model args, labels) -> (loss, metric)\n", " # here (query, slot_labels) -> (ce, errs)\n", " criterion = create_criterion_function(model)\n", "\n", " criterion.replace_placeholders({criterion.placeholders[0]: Input(vocab_size),\n", " criterion.placeholders[1]: Input(num_labels)})\n", "\n", " # training config\n", " epoch_size = 18000 # 18000 samples is half the dataset size \n", " minibatch_size = 70\n", " \n", " # LR schedule over epochs \n", " # In CNTK, an epoch is how often we get out of the minibatch loop to\n", " # do other stuff (e.g. checkpointing, adjust learning rate, etc.)\n", " # (we don't run this many epochs, but if we did, these are good values)\n", " lr_per_sample = [0.003]*4+[0.0015]*24+[0.0003]\n", " lr_per_minibatch = [x * minibatch_size for x in lr_per_sample]\n", " lr_schedule = learning_rate_schedule(lr_per_minibatch, UnitType.minibatch, epoch_size)\n", " \n", " # Momentum\n", " momentum_as_time_constant = momentum_as_time_constant_schedule(700)\n", " \n", " # We use a variant of the Adam optimizer which is known to work well on this dataset\n", " # Feel free to try other optimizers from \n", " # https://www.cntk.ai/pythondocs/cntk.learner.html#module-cntk.learner\n", " learner = adam_sgd(criterion.parameters,\n", " lr=lr_schedule, momentum=momentum_as_time_constant,\n", " low_memory=True,\n", " gradient_clipping_threshold_per_sample=15, gradient_clipping_with_truncation=True)\n", "\n", " # trainer\n", " trainer = Trainer(model, criterion.outputs[0], criterion.outputs[1], learner)\n", "\n", " # process minibatches and perform model training\n", " log_number_of_parameters(model)\n", " progress_printer = ProgressPrinter(tag='Training')\n", " #progress_printer = ProgressPrinter(freq=100, first=10, tag='Training') # more detailed logging\n", "\n", " t = 0\n", " for epoch in range(max_epochs): # loop over epochs\n", " epoch_end = (epoch+1) * epoch_size\n", " while t < epoch_end: # loop over minibatches on the epoch\n", " data = reader.next_minibatch(minibatch_size, input_map={ # fetch minibatch\n", " criterion.arguments[0]: reader.streams.query,\n", " criterion.arguments[1]: reader.streams.slot_labels\n", " })\n", " trainer.train_minibatch(data) # update model with it\n", " t += data[criterion.arguments[1]].num_samples # samples so far\n", " progress_printer.update_with_trainer(trainer, with_metric=True) # log progress\n", " loss, metric, actual_samples = progress_printer.epoch_summary(with_metric=True)\n", "\n", " return loss, metric" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "### Running it\n", "\n", "You can find the complete recipe below." ] }, { "cell_type": "code", "execution_count": null, "metadata": { "collapsed": false, "scrolled": false }, "outputs": [], "source": [ "def do_train():\n", " global model\n", " model = create_model()\n", " reader = create_reader(data['train']['file'], is_training=True)\n", " train(reader, model)\n", "do_train()" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "This shows how learning proceeds over epochs (passes through the data).\n", "For example, after four epochs, the loss, which is the cross-entropy criterion, has reached 0.22 as measured on the ~18000 samples of this epoch,\n", "and that the error rate is 5.0% on those same 18000 training samples.\n", "\n", "The epoch size is the number of samples--counted as *word tokens*, not sentences--to\n", "process between model checkpoints.\n", "\n", "Once the training has completed (a little less than 2 minutes on a Titan-X or a Surface Book),\n", "you will see an output like this\n", "```\n", "Finished Epoch [16]: [Training] loss = 0.058111 * 18014, metric = 1.3% * 18014\n", "```\n", "which is the loss (cross entropy) and the metric (classification error) averaged over the final epoch.\n", "\n", "On a CPU-only machine, it can be 4 or more times slower. You can try setting\n", "```python\n", "emb_dim = 50 \n", "hidden_dim = 100\n", "```\n", "to reduce the time it takes to run on a CPU, but the model will not fit as well as when the \n", "hidden and embedding dimension are larger. " ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "### Evaluating the model\n", "\n", "Like the train() function, we also define a function to measure accuracy on a test set by computing the error over multiple minibatches of test data. For evaluating on a small sample read from a file, you can set a minibatch size reflecting the sample size and run the test_minibatch on that instance of data. To see how to evaluate a single sequence, we provide an instance later in the tutorial. " ] }, { "cell_type": "code", "execution_count": null, "metadata": { "collapsed": false }, "outputs": [], "source": [ "def evaluate(reader, model):\n", " criterion = create_criterion_function(model)\n", " criterion.replace_placeholders({criterion.placeholders[0]: Input(num_labels)})\n", "\n", " # process minibatches and perform evaluation\n", " lr_schedule = learning_rate_schedule(1, UnitType.minibatch)\n", " momentum_as_time_constant = momentum_as_time_constant_schedule(0)\n", " dummy_learner = adam_sgd(criterion.parameters, \n", " lr=lr_schedule, momentum=momentum_as_time_constant, low_memory=True)\n", " evaluator = Trainer(model, criterion.outputs[0], criterion.outputs[1], dummy_learner)\n", " progress_printer = ProgressPrinter(tag='Evaluation')\n", "\n", " while True:\n", " minibatch_size = 500\n", " data = reader.next_minibatch(minibatch_size, input_map={ # fetch minibatch\n", " criterion.arguments[0]: reader.streams.query,\n", " criterion.arguments[1]: reader.streams.slot_labels\n", " })\n", " if not data: # until we hit the end\n", " break\n", " metric = evaluator.test_minibatch(data)\n", " progress_printer.update(0, data[criterion.arguments[1]].num_samples, metric) # log progress\n", " loss, metric, actual_samples = progress_printer.epoch_summary(with_metric=True)\n", "\n", " return loss, metric" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "Now we can measure the model accuracy by going through all the examples in the test set and using the ``test_minibatch`` method of the trainer created inside the evaluate function defined above. At the moment (when this tutorial was written) the Trainer constructor requires a learner (even if it is only used to perform ``test_minibatch``) so we have to specify a dummy learner. In the future it will be allowed to construct a Trainer without specifying a learner as long as the trainer only calls ``test_minibatch``" ] }, { "cell_type": "code", "execution_count": null, "metadata": { "collapsed": false }, "outputs": [], "source": [ "def do_test():\n", " reader = create_reader(data['test']['file'], is_training=False)\n", " evaluate(reader, model)\n", "do_test()\n", "model.layers[2].b.value" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "The following block of code illustrates how to evaluate a single sequence. Additionally we show how one can pass in the information using NumPy arrays." ] }, { "cell_type": "code", "execution_count": null, "metadata": { "collapsed": false }, "outputs": [], "source": [ "# load dictionaries\n", "query_wl = [line.rstrip('\\n') for line in open(data['query']['file'])]\n", "slots_wl = [line.rstrip('\\n') for line in open(data['slots']['file'])]\n", "query_dict = {query_wl[i]:i for i in range(len(query_wl))}\n", "slots_dict = {slots_wl[i]:i for i in range(len(slots_wl))}\n", "\n", "# let's run a sequence through\n", "seq = 'BOS flights from new york to seattle EOS'\n", "w = [query_dict[w] for w in seq.split()] # convert to word indices\n", "print(w)\n", "onehot = np.zeros([len(w),len(query_dict)], np.float32)\n", "for t in range(len(w)):\n", " onehot[t,w[t]] = 1\n", "pred = model.eval({model.arguments[0]:[onehot]})\n", "print(pred.shape)\n", "best = np.argmax(pred,axis=2)\n", "print(best[0])\n", "list(zip(seq.split(),[slots_wl[s] for s in best[0]]))" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "## Modifying the Model\n", "\n", "In the following, you will be given tasks to practice modifying CNTK configurations.\n", "The solutions are given at the end of this document... but please try without!\n", "\n", "### A Word About [`Sequential()`](https://www.cntk.ai/pythondocs/layerref.html#sequential)\n", "\n", "Before jumping to the tasks, let's have a look again at the model we just ran.\n", "The model is described in what we call *function-composition style*.\n", "```python\n", " Sequential([\n", " Embedding(emb_dim),\n", " Recurrence(LSTM(hidden_dim), go_backwards=False),\n", " Dense(num_labels)\n", " ])\n", "```\n", "You may be familiar with the \"sequential\" notation from other neural-network toolkits.\n", "If not, [`Sequential()`](https://www.cntk.ai/pythondocs/layerref.html#sequential) is a powerful operation that,\n", "in a nutshell, allows to compactly express a very common situation in neural networks\n", "where an input is processed by propagating it through a progression of layers.\n", "`Sequential()` takes an list of functions as its argument,\n", "and returns a *new* function that invokes these functions in order,\n", "each time passing the output of one to the next.\n", "For example,\n", "```python\n", "\tFGH = Sequential ([F,G,H])\n", " y = FGH (x)\n", "```\n", "means the same as\n", "```\n", " y = H(G(F(x))) \n", "```\n", "This is known as [\"function composition\"](https://en.wikipedia.org/wiki/Function_composition),\n", "and is especially convenient for expressing neural networks, which often have this form:\n", "\n", " +-------+ +-------+ +-------+\n", " x -->| F |-->| G |-->| H |--> y\n", " +-------+ +-------+ +-------+\n", "\n", "Coming back to our model at hand, the `Sequential` expression simply\n", "says that our model has this form:\n", "\n", " +-----------+ +----------------+ +------------+\n", " x -->| Embedding |-->| Recurrent LSTM |-->| DenseLayer |--> y\n", " +-----------+ +----------------+ +------------+" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "### Task 1: Add Batch Normalization\n", "\n", "We now want to add new layers to the model, specifically batch normalization.\n", "\n", "Batch normalization is a popular technique for speeding up convergence.\n", "It is often used for image-processing setups, for example our other [hands-on lab on image\n", "recognition](./Hands-On-Labs-Image-Recognition).\n", "But could it work for recurrent models, too?\n", "\n", "> Note: training with Batch Normalization is currently only supported on GPU.\n", "\n", "So your task will be to insert batch-normalization layers before and after the recurrent LSTM layer.\n", "If you have completed the [hands-on labs on image processing](https://github.com/Microsoft/CNTK/blob/v2.0.beta9.0/Tutorials/CNTK_201B_CIFAR-10_ImageHandsOn.ipynb),\n", "you may remember that the [batch-normalization layer](https://www.cntk.ai/pythondocs/layerref.html#batchnormalization-layernormalization-stabilizer) has this form:\n", "```\n", " BatchNormalization()\n", "```\n", "So please go ahead and modify the configuration and see what happens.\n", "\n", "If everything went right, you will notice improved convergence speed (`loss` and `metric`)\n", "compared to the previous configuration." ] }, { "cell_type": "code", "execution_count": null, "metadata": { "collapsed": false }, "outputs": [], "source": [ "# Your task: Add batch normalization\n", "def create_model():\n", " with default_options(initial_state=0.1):\n", " return Sequential([\n", " Embedding(emb_dim),\n", " Recurrence(LSTM(hidden_dim), go_backwards=False),\n", " Dense(num_labels)\n", " ])\n", "\n", "# Enable these when done:\n", "#do_train()\n", "#do_test()" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "### Task 2: Add a Lookahead \n", "\n", "Our recurrent model suffers from a structural deficit:\n", "Since the recurrence runs from left to right, the decision for a slot label\n", "has no information about upcoming words. The model is a bit lopsided.\n", "Your task will be to modify the model such that\n", "the input to the recurrence consists not only of the current word, but also of the next one\n", "(lookahead).\n", "\n", "Your solution should be in function-composition style.\n", "Hence, you will need to write a Python function that does the following:\n", "\n", "* takes no input arguments\n", "* creates a placeholder (sequence) variable\n", "* computes the \"next value\" in this sequence using the `future_value()` operation and\n", "* concatenates the current and the next value into a vector of twice the embedding dimension using `splice()`\n", "\n", "and then insert this function into `Sequential()`'s list right after the embedding layer." ] }, { "cell_type": "code", "execution_count": null, "metadata": { "collapsed": false }, "outputs": [], "source": [ "# Your task: Add lookahead\n", "def create_model():\n", " with default_options(initial_state=0.1):\n", " return Sequential([\n", " Embedding(emb_dim),\n", " Recurrence(LSTM(hidden_dim), go_backwards=False),\n", " Dense(num_labels)\n", " ])\n", " \n", "# Enable these when done:\n", "#do_train()\n", "#do_test()" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "### Task 3: Bidirectional Recurrent Model\n", "\n", "Aha, knowledge of future words help. So instead of a one-word lookahead,\n", "why not look ahead until all the way to the end of the sentence, through a backward recurrence?\n", "Let us create a bidirectional model!\n", "\n", "Your task is to implement a new layer that\n", "performs both a forward and a backward recursion over the data, and\n", "concatenates the output vectors.\n", "\n", "Note, however, that this differs from the previous task in that\n", "the bidirectional layer contains learnable model parameters.\n", "In function-composition style,\n", "the pattern to implement a layer with model parameters is to write a *factory function*\n", "that creates a *function object*.\n", "\n", "A function object, also known as [*functor*](https://en.wikipedia.org/wiki/Function_object), is an object that is both a function and an object.\n", "Which means nothing else that it contains data yet still can be invoked as if it was a function.\n", "\n", "For example, `Dense(outDim)` is a factory function that returns a function object that contains\n", "a weight matrix `W`, a bias `b`, and another function to compute \n", "`input @ W + b.` (This is using \n", "[Python 3.5 notation for matrix multiplication](https://docs.python.org/3/whatsnew/3.5.html#whatsnew-pep-465).\n", "In Numpy syntax it is `input.dot(W) + b`).\n", "E.g. saying `Dense(1024)` will create this function object, which can then be used\n", "like any other function, also immediately: `Dense(1024)(x)`. \n", "\n", "Let's look at an example for further clarity: Let us implement a new layer that combines\n", "a linear layer with a subsequent batch normalization. \n", "To allow function composition, the layer needs to be realized as a factory function,\n", "which could look like this:\n", "\n", "```python\n", "def DenseLayerWithBN(dim):\n", " F = Dense(dim)\n", " G = BatchNormalization()\n", " x = Placeholder()\n", " apply_x = G(F(x))\n", " return apply_x\n", "```\n", "\n", "Invoking this factory function will create `F`, `G`, `x`, and `apply_x`. In this example, `F` and `G` are function objects themselves, and `apply_x` is the function to be applied to the data.\n", "Thus, e.g. calling `DenseLayerWithBN(1024)` will\n", "create an object containing a linear-layer function object called `F`, a batch-normalization function object `G`,\n", "and `apply_x` which is the function that implements the actual operation of this layer\n", "using `F` and `G`. It will then return `apply_x`. To the outside, `apply_x` looks and behaves\n", "like a function. Under the hood, however, `apply_x` retains access to its specific instances of `F` and `G`.\n", "\n", "Now back to our task at hand. You will now need to create a factory function,\n", "very much like the example above.\n", "You shall create a factory function\n", "that creates two recurrent layer instances (one forward, one backward), and then defines an `apply_x` function\n", "which applies both layer instances to the same `x` and concatenate the two results.\n", "\n", "Alright, give it a try! To know how to realize a backward recursion in CNTK,\n", "please take a hint from how the forward recursion is done.\n", "Please also do the following:\n", "* remove the one-word lookahead you added in the previous task, which we aim to replace; and\n", "* make sure each LSTM is using `hidden_dim//2` outputs to keep the total number of model parameters limited." ] }, { "cell_type": "code", "execution_count": null, "metadata": { "collapsed": false }, "outputs": [], "source": [ "# Your task: Add bidirectional recurrence\n", "def create_model():\n", " with default_options(initial_state=0.1): \n", " return Sequential([\n", " Embedding(emb_dim),\n", " Recurrence(LSTM(hidden_dim), go_backwards=False),\n", " Dense(num_labels)\n", " ])\n", "\n", "# Enable these when done:\n", "#do_train()\n", "#do_test()" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "Works like a charm! This model achieves 2.1%, a tiny bit better than the lookahead model above.\n", "The bidirectional model has 40% less parameters than the lookahead one. However, if you go back and look closely\n", "you may find that the lookahead one trained about 30% faster.\n", "This is because the lookahead model has both less horizontal dependencies (one instead of two\n", "recurrences) and larger matrix products, and can thus achieve higher parallelism." ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "### Solution 1: Adding Batch Normalization" ] }, { "cell_type": "code", "execution_count": null, "metadata": { "collapsed": false }, "outputs": [], "source": [ "def create_model():\n", " with default_options(initial_state=0.1):\n", " return Sequential([\n", " Embedding(emb_dim),\n", " BatchNormalization(),\n", " Recurrence(LSTM(hidden_dim), go_backwards=False),\n", " BatchNormalization(),\n", " Dense(num_labels)\n", " ])\n", "\n", "do_train()\n", "do_test()" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "### Solution 2: Add a Lookahead" ] }, { "cell_type": "code", "execution_count": null, "metadata": { "collapsed": false }, "outputs": [], "source": [ "def OneWordLookahead():\n", " x = Placeholder()\n", " apply_x = splice ([x, future_value(x)])\n", " return apply_x\n", "\n", "def create_model():\n", " with default_options(initial_state=0.1):\n", " return Sequential([\n", " Embedding(emb_dim),\n", " OneWordLookahead(),\n", " Recurrence(LSTM(hidden_dim), go_backwards=False),\n", " Dense(num_labels) \n", " ])\n", "\n", "do_train()\n", "do_test()" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "### Solution 3: Bidirectional Recurrent Model" ] }, { "cell_type": "code", "execution_count": null, "metadata": { "collapsed": false }, "outputs": [], "source": [ "def BiRecurrence(fwd, bwd):\n", " F = Recurrence(fwd)\n", " G = Recurrence(bwd, go_backwards=True)\n", " x = Placeholder()\n", " apply_x = splice ([F(x), G(x)])\n", " return apply_x \n", "\n", "def create_model():\n", " with default_options(initial_state=0.1):\n", " return Sequential([\n", " Embedding(emb_dim),\n", " BiRecurrence(LSTM(hidden_dim//2), LSTM(hidden_dim//2)),\n", " Dense(num_labels)\n", " ])\n", "\n", "do_train()\n", "do_test()" ] }, { "cell_type": "code", "execution_count": null, "metadata": { "collapsed": true }, "outputs": [], "source": [] } ], "metadata": { "anaconda-cloud": {}, "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.4.3" } }, "nbformat": 4, "nbformat_minor": 1 }