epitweetr tool

Tool

The R-based tool epitweetr allows users to automatically monitor trends of tweets by time, place and topic, with the aim of detecting public health threats early through signals, such as an unusual increase in the number of tweets. It was designed to support public health experts with the early detection of threats from infectious diseases but can be extended to all hazards and other fields of study by modifying the topics and keywords.

The epitweetr package includes an interactive web application (based on the R package Shiny) with five pages:
1. Dashboard, where a user can visualise and explore tweets, and download the associated outputs and data;
2. Alerts page, where you can view the current alerts and associated information;
3. Geotag evaluation page, where you can evaluate the geolocation algorithm in different tweet fields to manually choose the geolocation threshold;
4. Configuration page, where you can change settings and check the status of the underlying processes;
5. Troubleshooting page, with automatic checks and hints for using epitweetr with all its functionalities.

Download

Thumbnail
epitweetr tool - Source package - EN - [ZIP-1.07 MB]
epitweetr tool – User manual - EN - [PDF-142.15 KB]
epitweetr tool – Vignette - EN - [PDF-3.33 MB]

Installation

The software is available as an R package under European Union Public Licence v.1.2 EUPL © The European Union 2007, 2016.

R was chosen as the computing platform to make the tool as broadly available as possible, as it is free, open source, and runs on any modern operating system.

To use an R package, R must first be downloaded and installed on your computer. In addition, epitweetr requires other software for using all its functionalities. For detailed instructions for installing the R package, please read the user documentation.

Option 1: Download from the ECDC website

1. Download the package: epitweetr tool: Source package

2. Open R.

3. Open the Packages menu.

4. Select “Install package(s) from local zip files”.

5. Navigate to where you have saved the ECDC Zip.

6. Select filename and click Open.

The package must be downloaded to your computer before you can open it in R. DO NOT unpack the downloaded Zip file, it only needs to be saved on your computer.

To verify the integrity of the original zip file (version 0.1.24):

MD5 checksum

e1b81ffdbee5e141586b08e5031f7c57

SHA1 checksum

fd105630174ae831d6506a426cbedd260e33b243

Option 2: Download from CRAN

For R users, an R package was released on the CRAN repository:

Option 3: Download from GitHub

GitHub users can download directly from the ECDC GitHub page:

Disclaimer

ECDC accepts no responsibility or liability whatsoever (including but not limited to any direct or consequential loss or damage it might occur to you and/or any other third party) arising out of or in connection with the installation and/or usage of this software.

Suggested citation

epitweetr, R package, [software application] Version 0.1.24 Stockholm: European Centre for Disease Prevention and Control; 2020