Awesome
MUStARD: Multimodal Sarcasm Detection Dataset
This repository contains the dataset and code for our ACL 2019 paper:
Towards Multimodal Sarcasm Detection (An Obviously Perfect Paper)
We release the MUStARD dataset, a multimodal video corpus for research in automated sarcasm discovery. The dataset is compiled from popular TV shows including Friends, The Golden Girls, The Big Bang Theory, and Sarcasmaholics Anonymous. MUStARD consists of audiovisual utterances annotated with sarcasm labels. Each utterance is accompanied by its context, providing additional information on the scenario where it occurs.
Example Instance
<p style="text-align: center">Example sarcastic utterance from the dataset along with its context and transcript.</p>Raw Videos
We provide the raw video clips, including both the utterances and their respective context
Data Format
The annotations and transcripts of the audiovisual clips are available at data/sarcasm_data.json
.
Each instance in the JSON file is allotted one identifier (e.g., "1_60"), which is a dictionary of the following items:
Key | Value |
---|---|
utterance | The text of the target utterance to classify. |
speaker | Speaker of the target utterance. |
context | List of utterances (in chronological order) preceding the target utterance. |
context_speakers | Respective speakers of the context utterances. |
sarcasm | Binary label for sarcasm tag. |
Example format in JSON:
{
"1_60": {
"utterance": "It's just a privilege to watch your mind at work.",
"speaker": "SHELDON",
"context": [
"I never would have identified the fingerprints of string theory in the aftermath of the Big Bang.",
"My apologies. What's your plan?"
],
"context_speakers": [
"LEONARD",
"SHELDON"
],
"sarcasm": true
}
}
Citation
Please cite the following paper if you find this dataset useful in your research:
@inproceedings{mustard,
title = "Towards Multimodal Sarcasm Detection (An \_Obviously\_ Perfect Paper)",
author = "Castro, Santiago and
Hazarika, Devamanyu and
P{\'e}rez-Rosas, Ver{\'o}nica and
Zimmermann, Roger and
Mihalcea, Rada and
Poria, Soujanya",
booktitle = "Proceedings of the 57th Annual Meeting of the Association for Computational Linguistics (Volume 1: Long Papers)",
month = "7",
year = "2019",
address = "Florence, Italy",
publisher = "Association for Computational Linguistics",
}
Run the code
-
Set up the environment with Conda:
conda env create conda activate mustard python -c "import nltk; nltk.download('punkt')"
-
Download Common Crawl pretrained GloVe word vectors of size 300d, 840B tokens somewhere.
-
Download the pre-extracted visual features to the
data/
folder (sodata/features/
contains the folderscontext_final/
andutterances_final/
with the features) or extract the visual features yourself. -
Download the pre-extracted BERT features and place the two files directly under the folder
data/
(so they aredata/bert-output.jsonl
anddata/bert-output-context.jsonl
), or extract the BERT features in another environment with Python 2 and TensorFlow 1.11.0 following "Using BERT to extract fixed feature vectors (like ELMo)" from BERT's repo and running:# Download BERT-base uncased in some dir: wget https://storage.googleapis.com/bert_models/2018_10_18/uncased_L-12_H-768_A-12.zip # Then put the location in this var: BERT_BASE_DIR=... python extract_features.py \ --input_file=data/bert-input.txt \ --output_file=data/bert-output.jsonl \ --vocab_file=${BERT_BASE_DIR}/vocab.txt \ --bert_config_file=${BERT_BASE_DIR}/bert_config.json \ --init_checkpoint=${BERT_BASE_DIR}/bert_model.ckpt \ --layers=-1,-2,-3,-4 \ --max_seq_length=128 \ --batch_size=8
-
Check the options in
python train_svm.py -h
to select a run configuration (or modifyconfig.py
) and then run it:python train_svm.py # Add the flags you want.
-
Evaluation: We evaluate using a weighted F-score metric in a 5-fold cross-validation scheme. The fold indices are available at
data/split_incides.p
. Refer to our baseline scripts for more details.