How to Use xSub

xSub / is a repository of micro-level, subnational event data on armed conflict and political violence around the world.

Through the online interface, users may select:

  1. a country and data source, in either order.

  2. a unit of analysis

    • space: country / province / district / grid / electoral constituency

    • time: year / month / week

The website then generates a compressed archive with:

  1. dataset

    • file format: comma-separated values delimited text file (.csv)

    • data structure: cross-sectional time-series

    • number of observations: N × T, where N is the number of spatial units (e.g. districts, grid cells), and T is the number of time units (e.g. months, weeks)

    • variables included: unit IDs, violence event counts (broken down by actors and tactics), covariates (local demographics, geography, ethnicity, weather)

  2. map and time plot of violence

    • file format: portable network graphics (.png)

    • map: number of violent events per spatial units (darker shade = more violence)

    • time plot: number of violent events per time unit (higher bars = more violence)

  3. codebook

    • file format: portable document format (.pdf)

    • contents: information on variable names, data structure

  4. actor dictionary

    • file format: portable document format (.pdf)

    • contents: information on which specific actors are classified as “government,” “rebel,” and other categories in the file

For more advanced options (e.g. batch downloading and merging multiple data files), please see the xSub R package.