TTLocVis

A Twitter Topic Location Visualization Python package

Summary

The package TTLocVis provides a broad range of methods to generate, clean, analyze and visualize the content of Twitter data. TTLocVis enables the user to work with geo-spatial Twitter data and to generate topic distributions from LDA Topic Models for geo-coded Tweets. As such, TTLocVis is an innovative tool to work with geo-coded text on a high geo-spatial resolution to analyse the public discourse on various topics in space and time. The package has the potential to be used for a broad range of applications for scientific research to gain insights into public discourse.

How to cite

#Installation

Attention: Event though TTLocVis should run on Python 3.7 and 3.8, it was not fully tested under these conditions. We do recommend to install a new (conda) environment with Python 3.6.

The package can be installed via pip:

python pip install TTLocVis

####Windows

After successful installation, the user must download the basemap package and install it manually via pip:

python -m pip install [path-to-the-downloaded-file/your-basemap-wheel]

Note: Do not copy the name of your basemap wheel from the above mentioned website into your python console! Write it out manually! The cpXX in the filenames refer to the python version you will use. An example for Python 3.6. would be the file basemap-1.2.1-cp36-cp36m-win_amd64.whl Remember, TTLocVis is developed to run only on Python 3.6, 3.7 and 3.8.

####Linux and iOS

Download basemap package version 1.2.1 and install it accordingly.

Documentation and Usage

You can find the current TTLocVis master branch documentation at our documentation website.

Community guidelines

Contributions to TTLocVis are welcome.

• Just file an Issue to ask questions, report bugs, or request new features.
• Pull requests via GitHub are also welcome.

Potential contributions include ways to further improve the quality of the LDA topics in handling the noisy Twitter data and an improvement of the loc_vis method in a way that it becomes independent form the basemap module.

Authors

• Gillian Kant
• Christoph Weißer
• Benjamin Säfken

License

TTLocVis is published under the GNU GPLv3 license.