README.md

When a Disaster Happens, We Are Ready: Location Mention Recognition from Crisis Tweets

The Location Mention Recognition (LMR) in social media posts during disasters has been studied under the assumption of "the abundance of training data" at the disaster onset. In our work, we adopted the more realistic assumption that no (i.e., zero-shot setting) or as little as a few hundred examples (i.e., few-shot setting) from the just-occurred event is available for training. Several factors were examined on their influence on a BERT-based LMR model perofrmance including the entity types, the data domain, the disaster domain, the language, and the geo-proximity of disaster events. More details in the cited publications below.

This repository provides the steps to reproduce the experiments that we reported in our publication.

The datasets

We adopted three types of datasets in our work: (1) General-purpose NER dataset, (2) Twitter NER dataset, and (3) Crisis-related multilingual Twitter LOC dataset. We show various statistics of all the datasets in the cited publication below.

1. General-purpose NER dataset: A well-known candidate for this category is the CoNLL-2003 NER dataset [1].
2. Twitter NER dataset: We use the Broad Twitter Corpus (BTC) as our Twitter NER dataset [2].
3. Crisis-related Twitter LMR dataset: We use seven datasets in this category;

• The floods dataset consists of 4,500 tweets from Chennai floods 2015, Louisiana floods 2016, and Houston floods 2016 [3]. The tweets in these datasets are tagged using several location-related tags. In this work, we only use inLOC and outLOC, which indicate if the location is within or outside the disaster-affected areas respectively. We further filter out all hashtags used to collect the datasets, thus limiting their effect towards biasing the model's training process.
• The multilingual datasets in this category are adopted from [4]. This source contains 6,386 multilingual tweets in English, Italian, and Turkish languages from four disasters, namely Hurricane Sandy 2012, Christchurch earthquake 2012, Milan blackout 2013, and Turkey earthquake 2013. Hurricane Sandy and Christchurch earthquake are English language datasets, Milan blackout is in Italian language, and Turkey earthquake is in Turkish language.

[1]. Tjong Kim Sang, E. F., & De Meulder, F. (2003). Introduction to the CoNLL-2003 shared task: Language-independent named entity recognition. In Proceedings of the Seventh Conference on Natural Language Learning at HLT-NAACL (pp. 142–147).

[2]. Derczynski, L., Bontcheva, K., & Roberts, I. (2016). Broad Twitter corpus: A diverse named entity recognition resource. In Proceedings of the 26th International Conference on Computational Linguistics: Technical Papers (pp. 1169–1179).

[3]. Al-Olimat, H. S., Thirunarayan, K., Shalin, V., & Sheth, A. (2018). Location name extraction from targeted text streams using gazetteer-based statistical language models. In Proceedings of the 27th International Conference on Computational Linguistics (pp. 1986–1997).

[4]. Middleton, S. E., Middleton, L., & Modafferi, S. (2014). Real-time crisis mapping of natural disasters using social media. IEEE Intelligent Systems, 29, 9–17.

For reproducibility, you need to follow these steps:

1. Download the datasets from the repository: Unfortunately, the crisis-related Twitter LMR datasets are licensed and have to be requested from the corresponding authors [3-4].
2. Preprocess the datasets: You need to convert the datasets into BILOU format and partition the datasets. Both CoNLL-2003 and BTC datasets are preprocessed and ready for download in this repository. Unfortunately, the preparation steps involve manual curation conducted on our side before running the LMR model, in addition to filtering out all hashtags used to collect the datasets, thus limiting their effect towards biasing the learnable models during training. Thus, to make the results reproducible, once you confirm that you acquired the crisis-related Twitter LMR datasets (check contact information below), we can share with you the preprocessed and partitioned data that we have.

The LMR model:

We employed the NER BERT-based model from HuggingFace library. To run this model, follow the steps in this forked version.

You can download the best zero-shot models (evaluated using F₁ score) that are trained under the Combined.joint setup for each disaster. The models' naming format is lmr-bert-<dataset>-e<#epochs>-b<#training_batches>-lr<learning_rate>.gz.

• The dataset is the 2-char code of the affected area by the target disaster: ch, ho, lo, ny, and nz refer to Chennai floods 2015, Houston floods 2016, Louisiana floods 2016, Hurricane Sandy 2012, and Christchurch earthquake 2012 disaster events.
• The #epochs, #training_batches, and learning_rate are the best hyperparameters for each model with the default seed = 42.

Target Event	#epochs	#training_batches	learning_rate	Download
Chennai floods 2015	2	16	5e-5	lmr-bert-ch-e2-b16-lr5e-5
Houston floods 2016	3	16	5e-5	lmr-bert-ho-e3-b16-lr5e-5
Louisiana floods 2016	4	32	5e-5	lmr-bert-lo-e4-b32-lr5e-5
Hurricane Sandy 2012	3	16	5e-5	lmr-bert-ny-e3-b16-lr5e-5
Christchurch earthquake 2012	4	16	5e-5	lmr-bert-nz-e4-b16-lr5e-5

Publications

@article{suwaileh2022tlLMR4disaster,
    title={When a Disaster Happens, We Are Ready: Location Mention Recognition from Crisis Tweets},
    author={Suwaileh, Reem and Elsayed, Tamer and Imran, Muhammad and Sajjad, Hassan},
    journal={International Journal of Disaster Risk Reduction},
    year={2022}
}

@inproceedings{suwaileh2020tlLMR4disaster,
  title={Are We Ready for this Disaster? Towards Location Mention Recognition from Crisis Tweets},
  author={Suwaileh, Reem and Imran, Muhammad and Elsayed, Tamer and Sajjad, Hassan},
  booktitle={Proceedings of the 28th International Conference on Computational Linguistics},
  pages={6252--6263},
  year={2020}
}

Contact

Please send an email to [email protected] if you have any questions or suggestions.