[UCDP] Battle-Related Deaths Dataset (v. 22.1) (Conflict version)

“There are two versions of the UCDP Battle-related Deaths Dataset (BRD), depending on the unit of analysis (resolution) employed. As such, there is:
1. a dyadic version, where each individual conflict dyad (pair of two fighting actors) has its own individual entry in each year the conflict dyad was active;
Thus, each entry contains a single pair of opposing sides (one side A and one side B) in a given year.
Multiple dyads may form a single conflict, as a conflict is defined by its incompatibilities.
2. a conflict version, where each individual conflict has its individual entry.
Thus, each entry contains one side A (the contested party) and one or more contesters in a given year (each entry being one contested incompatibility).
As such, for each row in the BRD Conflict version, there are one or more rows in the BRD Dyadic version.
If you are not certain which version of the dataset to choose, it is safer to use the dyadic version; the conflict version is an automatic aggregation of the dyadic version that automatically aggregates and drops information.” (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
“The Uppsala Conflict Data Program (UCDP) defines an armed conflict as a contested incompatibility that concerns government and/or territory over which the use of armed force between two parties, of which at least one is the government of a state, has resulted in at least 25 battle-related deaths in one calendar year.” (codebook, p. 4)

I/2/ Conflict domain

State-based conflictNon-state conflictOne-sided violenceTO BE DETERMINED
XX
“type_of_conflict
One of the following four types of conflict over which the dyad is fought:
1 = extrasystemic (between a state and a non-state group outside its own territory, where the government side is fighting to retain control of a territory outside the state system).
2 = interstate (both sides are states in the Gleditsch and Ward membership system).
3 = intrastate (side A is always a government; side B is always one or more rebel groups; there is no involvement of foreign governments with troops, i.e. there is no side_a_2nd or side_b_2nd coded).
4 = internationalized intrastate (side A is always a government; side B is always one or more rebel
groups; there is involvement of foreign governments with troops, i.e. there is at least ONE side_a_2nd or side_b_2nd coded).” (codebook, p. 10)

II/ Time variable
II/1/ Unit of time

DayYear
X
year
The year of observation (1989-2021).” (codebook, p. 9)

II/2/ Time domain

Time domain
1989 – 2021
“Like UCDP BRD, GED is global and covers the same period (1989-2021).” (codebook, p. 11)

III/ Space variable
III/1/ Unit of space

CoordinatesCountryRegionTO BE DETERMINED
X
“battle_location
The name of the country/countries in which battle- related deaths have been recorded in this conflict-year: battle_location is a string variable, where the different countries are separated by a comma (‘,’).
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, pp. 10-11)

III/2/ Space domain

GlobalMediterranean Sea and SahelTO BE DETERMINED
X
“Like UCDP BRD, GED is global and covers the same period (1989-2021).” (codebook, p. 11)

IV/ Data structure
IV/1/ Unit of observation

Unit of conflict (UC)UC-yearUC-actorCountry-year
X
Actor-yearDyad-yearOTHERTO BE DETERMINED
“2. a conflict version, where each individual conflict has its individual entry.
Thus, each entry contains one side A (the contested party) and one or more contesters in a given year (each entry being one contested incompatibility).” (codebook, p. 3)

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

IV/2/ Number of observations

Number of observation
1 403

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

V/ All variables

Conflict nameConflict typeIntensity
XX
OutcomeTimeSpace
XX
ActorType of actorDyad
XX
CoalitionDeathsNon-conflit variables
XX
conflict_id
The unique identifier of the conflict, as given in the UCDP/PRIO Armed Conflict Dataset version 22.1 and the UCDP Dyadic Dataset version 22.1″ (codebook, p. 9)
type_of_conflict
One of the following four types of conflict over which the dyad is fought:
1 = extrasystemic (between a state and a non-state group outside its own territory, where the government side is fighting to retain control of a territory outside the state system).
2 = interstate (both sides are states in the Gleditsch and Ward membership system).
3 = intrastate (side A is always a government; side B is always one or more rebel groups; there is no involvement of foreign governments with troops, i.e. there is no side_a_2nd or side_b_2nd coded).
4 = internationalized intrastate (side A is always a government; side B is always one or more rebel
groups; there is involvement of foreign governments with troops, i.e. there is at least ONE side_a_2nd or side_b_2nd coded).” (codebook, p. 10)
year
The year of observation (1989-2021).” (codebook, p. 9)
“battle_location
The name of the country/countries in which battle- related deaths have been recorded in this conflict-year: battle_location is a string variable, where the different countries are separated by a comma (‘,’).
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, pp. 10-11)
side_a
The name of the country/countries of Side A in a conflict. Always the government side in intrastate conflicts, as given in the UCDP/PRIO Armed Conflict Dataset. Comma separated if multiple.” (codebook, p. 9)
dyad_id
A string variable listing all the dyads active in the current conflict-year separated by commas (‘,’).” (codebook, p. 9)
“side_a_2nd
side_a_2nd lists all states that enter a conflict with troops to actively support side A in the dyad.
A secondary warring party on side A shares the position in the incompatibility with Side A in the conflict.
Side_a_2nd does not need to meet the 25 battle-related deaths criterion to be included in the dataset; an active troop participation is enough.” (codebook, p. 9)
“bd_best
The UCDP Best estimate for battle-related deaths in the conflict in the given year.” (codebook, p. 10)

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:
1. an automatic filtering and aggregation of the UCDP Georeferenced Event Dataset from incident/event level to the conflict/dyad-year level.
2. an automatic join of that aggregation with dyad and conflict-year data (such as secondary warring party support or conflict typology) from the UCDP/PRIO Armed Conflict Dataset and the UCDP Dyadic Dataset.
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. 13)

VI/2/ Codebook

DateVersion
202222.1
“When appropriate, also cite this codebook: Pettersson, Therese (2022) UCDP Battle-related Deaths Dataset 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 Battle-related Deaths Dataset. For every new release, substantial changes will be documented in a separate document. This should be helpful to researchers trying to replicate a particular study. We recommend that whenever this dataset is used, the version number should be cited.
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. 13)

VII/2/ Regularly updated ?

Real-timeMonthQuarterAnnually
X
YES, PERIOD TO BE DETERMINEDTO BE DETERMINED
“This codebook corresponds to Version 22.1 of the UCDP Battle-related Deaths Dataset. For every new release, substantial changes will be documented in a separate document. This should be helpful to researchers trying to replicate a particular study. We recommend that whenever this dataset is used, the version number should be cited.
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. 13)

VIII/ Access
VIII/1/ Registration ?

YESNO
X

VIII/2/ Formats

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

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. 14)