From August 2020 onwards, the new TorchText API from TorchText >=0.7 should be used. This requires PyTorch >=1.6. The implementations below will not be updated in order to provide legacy support. Instead, new tutorials that make use the new API are being written. These are located in the experimental folder and are currently in progress. They require TorchText 0.8 >= which, as of September 2020, must be built from the master branch of TorchText.

If you have any feedback in regards to them, please submit and issue with the word "experimental" somewhere in the title.

This repo contains tutorials covering how to do sentiment analysis using PyTorch 1.3 and TorchText 0.4 using Python 3.7.

The first 2 tutorials will cover getting started with the de facto approach to sentiment analysis: recurrent neural networks (RNNs). The third notebook covers the FastText model and the final covers a convolutional neural network (CNN) model.

There are also 2 bonus "appendix" notebooks. The first covers loading your own datasets with TorchText, while the second contains a brief look at the pre-trained word embeddings provided by TorchText.

If you find any mistakes or disagree with any of the explanations, please do not hesitate to submit an issue. I welcome any feedback, positive or negative!

To install PyTorch, see installation instructions on the PyTorch website.

To install TorchText:

pip install torchtext

We'll also make use of spaCy to tokenize our data. To install spaCy, follow the instructions here making sure to install the English models with:

python -m spacy download en

For tutorial 6, we'll use the transformers library, which can be installed via:

pip install transformers

These tutorials were created using version 1.2 of the transformers library.

• 1 - Simple Sentiment Analysis

  This tutorial covers the workflow of a PyTorch with TorchText project. We'll learn how to: load data, create train/test/validation splits, build a vocabulary, create data iterators, define a model and implement the train/evaluate/test loop. The model will be simple and achieve poor performance, but this will be improved in the subsequent tutorials.

• 2 - Upgraded Sentiment Analysis

  Now we have the basic workflow covered, this tutorial will focus on improving our results. We'll cover: using packed padded sequences, loading and using pre-trained word embeddings, different optimizers, different RNN architectures, bi-directional RNNs, multi-layer (aka deep) RNNs and regularization.

• 3 - Faster Sentiment Analysis

  After we've covered all the fancy upgrades to RNNs, we'll look at a different approach that does not use RNNs. More specifically, we'll implement the model from Bag of Tricks for Efficient Text Classification. This simple model achieves comparable performance as the Upgraded Sentiment Analysis, but trains much faster.

• 4 - Convolutional Sentiment Analysis

  Next, we'll cover convolutional neural networks (CNNs) for sentiment analysis. This model will be an implementation of Convolutional Neural Networks for Sentence Classification.

• 5 - Multi-class Sentiment Analysis

  Then we'll cover the case where we have more than 2 classes, as is common in NLP. We'll be using the CNN model from the previous notebook and a new dataset which has 6 classes.

• 6 - Transformers for Sentiment Analysis

  Finally, we'll show how to use the transformers library to load a pre-trained transformer model, specifically the BERT model from this paper, and use it to provide the embeddings for text. These embeddings can be fed into any model to predict sentiment, however we use a gated recurrent unit (GRU).

• A - Using TorchText with your Own Datasets

  The tutorials use TorchText's built in datasets. This first appendix notebook covers how to load your own datasets using TorchText.

• B - A Closer Look at Word Embeddings

  This appendix notebook covers a brief look at exploring the pre-trained word embeddings provided by TorchText by using them to look at similar words as well as implementing a basic spelling error corrector based entirely on word embeddings.

• C - Loading, Saving and Freezing Embeddings

  In this notebook we cover: how to load custom word embeddings, how to freeze and unfreeze word embeddings whilst training our models and how to save our learned embeddings so they can be used in another model.

Here are some things I looked at while making these tutorials. Some of it may be out of date.

• https://anie.me/On-Torchtext/
• https://mlexplained.com/2018/02/08/a-comprehensive-tutorial-to-torchtext/
• https://github.com/spro/practical-pytorch
• https://gist.github.com/Tushar-N/dfca335e370a2bc3bc79876e6270099e
• https://gist.github.com/HarshTrivedi/f4e7293e941b17d19058f6fb90ab0fec
• https://github.com/keras-team/keras/blob/master/examples/imdb_fasttext.py
• https://github.com/Shawn1993/cnn-text-classification-pytorch