[UCDP] One-sided Violence Dataset (v. 22.1)

“This document describes the One-sided Violence Dataset, a project within the Uppsala Conflict Data Program (UCDP) at the Department of Peace and Conflict Research, Uppsala University. The UCDP One-sided violence project has been developed with support from the Human Security Report Project, Simon Fraser University, in Vancouver, Canada.” (codebook, p. 3)

I/ Conflict variable
I/1/ Unit of conflict

Event (< 0 or 1 death)Conflict (< 25 deaths)War (< 100 deaths)Episode (< 500 deaths)
X
“One-sided violence is the use of armed force by the government of a state or by a formally organized group against civilians which results in at least 25 deaths.” (codebook, p. 3)

I/2/ Conflict domain

State-based conflictNon-state conflictOne-sided violenceTO BE DETERMINED
X
One-sided violence is the use of armed force by the government of a state or by a formally organized group against civilians which results in at least 25 deaths.” (codebook, p. 3)

II/ Time variable
II/1/ Unit of time

DayYear
X
year
The calendar year of observation. UCDP employs a threshold for inclusion of at least 25 deaths caused by one-sided violence for each actor in a calendar year.” (codebook, p. 5)

II/2/ Time domain

Time domain
1989 – 2021
“Like the UCDP One-Sided Violence Dataset, GED is global and covers the same period (1989-2021).” (codebook, p. 6)

III/ Space variable
III/1/ Unit of space

CoordinatesCountryRegionTO BE DETERMINED
X
“location
The countries where this episode of violence took place. Comma-separated if multiple.
WARNING: This variable SHOULD NEVER be used for any geographical or spatial analyses of conflict, as the distribution of violence as well as the relative magnitude of violence by country is not captured. In effect a country is listed here if even one dead in the given conflict has occurred in that country.
In fact, UCDP provides much better geographic coverage of conflict (including distribution of violence for each conflict and each country) in the UCDP Georeferenced Event Dataset (GED).” (codebook, p. 6)

III/2/ Space domain

GlobalMediterranean Sea and SahelTO BE DETERMINED
X
“Like the UCDP One-Sided Violence Dataset, GED is global and covers the same period (1989-2021).” (codebook, p. 6)

IV/ Data structure
IV/1/ Unit of observation

Unit of conflict (UC)UC-yearUC-actorCountry-year
Actor-yearDyad-yearOTHERTO BE DETERMINED
X
“This dataset is the result of an automatic filtering and aggregation of the UCDP Georeferenced Event Dataset from incident/event level to the actor-year level.” (codebook, p. 8)

(ucdp-onesided-221.xlsx, 18/05/2022)

IV/2/ Number of observations

Number of observation
1 128

(ucdp-onesided-221.xlsx, 18/05/2022)

V/ All variables

Conflict nameConflict typeIntensity
X
OutcomeTimeSpace
XX
ActorType of actorDyad
XXX
CoalitionDeathsNon-conflit variables
XX
conflict_id
A unique conflict identification code for each individual observation of one-sided violence in the dataset. Used only for merging purposes across the UCDP datasets.” (codebook, p. 5)
year
The calendar year of observation. UCDP employs a threshold for inclusion of at least 25 deaths caused by one-sided violence for each actor in a calendar year.” (codebook, p. 5)
location
The countries where this episode of violence took place. Comma-separated if multiple.
WARNING: This variable SHOULD NEVER be used for any geographical or spatial analyses of conflict, as the distribution of violence as well as the relative magnitude of violence by country is not captured. In effect a country is listed here if even one dead in the given conflict has occurred in that country.
In fact, UCDP provides much better geographic coverage of conflict (including distribution of violence for each conflict and each country) in the UCDP Georeferenced Event Dataset (GED).” (codebook, p. 6)
actor_name
The government of a state or the name used by a formally organized group perpetrating the violence. Comma separated if multiple.actor_name The government of a state or the name used by a formally organized group perpetrating the violence. Comma separated if multiple.” (codebook, p. 5)
is_government_actor
For some purposes, it may be necessary to disaggregate between government and non-governmental actors in the dataset. This variable records if the actor is the government of a state and is coded as 1 for government actors and 0 for non-governmental actors.” (codebook, p. 6)
dyad_id
A unique dyad identification code for each individual observation of one-sided violence in the dataset. Used only for merging purposes across the UCDP datasets.” (codebook, p. 5)
coalition_components
If multiple actors are perpetrating violence together as a joint (temporary) coalition, the components of the coalition (in the form of a string of actor IDs) are listed here.” (codebook, p. 5)
“best_fatality_estimate
The best fatality estimate for the given episode.” (codebook, p. 5)

VI/ Transparency
VI/1/ Sources

Intergovernmental organizationsGovernmental organizationsNon-governmental organizations
XX
Research organizationsPress mediaSocial media
X
Other databasesOTHERTO BE DETERMINED
XX
“This dataset is the result of an automatic filtering and aggregation of the UCDP Georeferenced Event Dataset from incident/event level to the actor-year level.
The original reporting underlying the dataset is collected from three sets of sources:
1. global newswire reporting
2. global monitoring and translation of local news performed by the BBC
3. secondary sources such as local media, NGO and IGO reports, field reports, books etc.” (codebook, p. 8)

VI/2/ Codebook

DateVersion
202222.1
“When appropriate, also cite this codebook: Pettersson, Therese (2022) UCDP One-sided Violence Codebook v 22.1 (https://ucdp.uu.se/downloads/).” (codebook, p. 1)

VII/ Update
VII/1/ Current version

DateVersion
202222.1
“This codebook corresponds to Version 22.1 of the UCDP One-sided Violence Dataset. […]
The version number is a combination of a year and a number. The year refers to when the dataset is updated with new observations. If there are changes in the data between yearly updates, or if there are substantial changes in the structure of the dataset, the number behind the year is incremented.” (codebook, p. 8)

VII/2/ Regularly updated ?

Real-timeMonthQuarterAnnually
X
YES, PERIOD TO BE DETERMINEDTO BE DETERMINED
“This codebook corresponds to Version 22.1 of the UCDP One-sided Violence Dataset. […]
The version number is a combination of a year and a number. The year refers to when the dataset is updated with new observations. If there are changes in the data between yearly updates, or if there are substantial changes in the structure of the dataset, the number behind the year is incremented.” (codebook, p. 8)

VIII/ Access
VIII/1/ Registration ?

YESNO
X

VIII/2/ Formats

.XLS/.XLSX.CSV.DTA (STATA).RDTA
XXXX
“The data is available in CSV (respecting the RFC 4180 specification), Excel (XLSX), Rdata (3.x version) and STATA (2010 format).” (p. 9)

VIII/3/ API ?

YESNOTO BE DETERMINED
X
“The data is available for machine-to-machine interaction through a public API. Documentation for how to use the API is available at http://ucdp.uu.se/apidocs.” (codebook, p. 9)