VIEWS is an open-source project. All source code required to replicate our models and peek into the data infrastructure supporting it is available in a set of GitHub repositories. We also offer a number of tools to help users access data from our API and visualize output from the VIEWS models. Links to the full suite of public VIEWS repositories can be found below.
Research Infrastructure
Source code for VIEWS’ research infrastructures over time, including model repositories and model-specific data visualization tools.
API
Technical documentation of the VIEWS API.
Custom Solutions
Project or partner-specific repositories documenting bespoke solutions, and standard data analytics using VIEWS data.
Research Infrastructure & Model Pipeline
Key GitHub repositories and Python packages documenting VIEWS’ research infrastructures, from data architectures to model specifications and written documentation of our systems to date.
VIEWS_platform
A suite of GitHub repositories documenting the infrastructure and model specifications behind the next generation of VIEWS models.
Related forecasting model: Next generation (release TBD)
viewser
A client package for interacting with the ViEWS3 cloud ecosystem. This library provides functions, as well as a CLI entrypoint that handles authentication and API calls, making it easy to seamlessly retrieve data, explore models, and much more. See the viewser user documentation to learn more.
Related forecasting models: fatalities002, fatalities001
VIEWS3
A repository that holds the main docker-compose file used to deploy the VIEWS3 infrastructure. See the wiki for instructions on how to run it.
Related forecasting models: fatalities002, fatalities001
ingester3
Python package. Ingester3 is the Pandas extension-based system for ingesting data into the ViEWS3 system.
Related forecasting models: fatalities002, fatalities001
viewsforecasting
Documentation of the model currently in use (2023–).
Related forecasting model: fatalities002
Citation: Håvard Hegre, Forogh Akbari, Mihai Croicu, James Dale, Tim Gåsste, Remco Jansen, Peder Landsverk, Maxine Leis, Angelica Lindqvist-McGowan, Hannes Mueller, Malika Rakhmankulova, David Randahl, Christopher Rauh, Espen Geelmuyden Rød, Paola Vesco, 2022. ” Forecasting fatalities“. Report, Uppsala University, 2022-06-09.
FCDO_predicting_fatalities
Documentation of the first iteration of the fatalities model (2022-2023), developed in collaboration with UK FCDO.
Related forecasting model: fatalities001
Citation: Håvard Hegre, Forogh Akbari, Mihai Croicu, James Dale, Tim Gåsste, Remco Jansen, Peder Landsverk, Maxine Leis, Angelica Lindqvist-McGowan, Hannes Mueller, Malika Rakhmankulova, David Randahl, Christopher Rauh, Espen Geelmuyden Rød, Paola Vesco, 2022. ” Forecasting fatalities“. Report, Uppsala University, 2022-06-09.
VIEWS_competition
Code and data used in the clean-up and evaluation of the 2020 ViEWS prediction competition
Citation: Vesco, Paola, Håvard Hegre, Michael Colaresi, Remco Bastiaan Jansen, Adeline Lo, Gregor Reisch & Nils B Weidmann (2022). “United They Stand: Findings from an Escalation Prediction Competition.” International Interactions 48(4). doi: 10.1080/03050629.2022.2029856
OpenViEWS2
Source code to run the 2020-2021 prediction models under the ViEWS2 data infrastructure, coupled with a user guide to get started with ViEWS2. Please note that ViEWS2 is deprecated and thus no longer maintained.
Related forecasting model: ViEWS2020 (2020-2021)
Citation: Hegre, H., Bell, C., Colaresi, M., Croicu, M., Hoyles, F., Jansen, R., Leis, M. R., Lindqvist-McGowan, A., Randahl, D., Rød, E. G., & Vesco, P. (2021). ” ViEWS 2020: Revising and evaluating the ViEWS political Violence Early-Warning System“. Journal of Peace Research. doi:10.1177/0022343320962157
OpenViEWS
Documentation of the prediction models in use between 2018 and early 2020 under the ViEWS1 infrastructure. Please note that these models and its infrastructure are deprecated and thus no longer maintained.
Related forecasting model: ViEWS2018 (2018-2020)
Citation: Hegre, Håvard, Marie Allansson, Matthias Basedau, Michael Colaresi, Mihai Croicu, Hanne Fjelde, Frederick Hoyles, Lisa Hultman, Stina Högbladh, Remco Jansen, Naima Mouhleb, Sayyed Auwn Muhammad, Desirée Nilsson, Håvard Mokleiv Nygård, Gudlaug Olafsdottir, Kristina Petrova, David Randahl, Espen Geelmuyden Rød, Gerald Schneider, Nina von Uexkull, and Jonas Vestby. “ViEWS: a Political Violence Early-Warning System”. Journal of Peace Research, 56, no. 2 (March 2019): 155–74. doi:10.1177/0022343319823860.
API
GitHub code repository documenting VIEWS’ REST API
VIEWS_API
Documentation and user guide for the VIEWS API that allows retrieval of predictions and selected input data.
Related forecasting models: ViEWS2020, fatalities001, fatalities002
Custom Solutions
GitHub code repositories for specific projects, partnerships, or purposes.
VIEWS_Outreach
Custom scripts and data exploration tools
Related forecasting models: ViEWS2020, fatalities001, fatalities002
Mapper2
A VIEWS package that provides a set of tools to generate visualizations of the VIEWS data. Coupled with a set of Jupyter notebooks that illustrate different data mapping options.
Related forecasting models: ViEWS2020, fatalities001, fatalities002