[UCDP] Candidate Events Dataset (UCDP Candidate) (v. 22.01.22.06)

“The UCDP Candidate data includes the same variables as the UCDP GED dataset, the main difference being that UCDP Candidate has a monthly release cycle and UCDP GED is released annually. Not all events in UCDP Candidate will make it into the final UCDP GED and new events will be added. The UCDP Candidate is a dataset containing events that have a high probability of being included in the final annual version of UCDP GED.” (codebook, p. 2)

I/ Conflict variable
I/1/ Unit of conflict

Event (< 0 or 1 death)Conflict (< 25 deaths)War (< 100 deaths)Episode (< 500 deaths)
X
“The basic unit of analysis for the UCDP-Candidate dataset is the “event”, i.e. an individual incident (phenomenon) of lethal violence occurring at a given time and place.
An event is defined the as: ‘An incident where armed force was used by an organised actor against another organized actor, or against civilians, resulting in at least 1 direct death at a specific location and a specific date’.” (codebook, p. 2)

I/2/ Conflict domain

State-based conflictNon-state conflictOne-sided violenceTO BE DETERMINED
XXX
“The UCDP Candidate include data on the three core UCDP types of organized violence.
For definitions related to the three types State-based violence, Non-state violence and One-sided violence, please consult Appendix X” (codebook, p. 3)

II/ Time variable
II/1/ Unit of time

DayYear
X
“The maximum (best) temporal resolution of the dataset is the day.” (codebook, p. 4)

II/2/ Time domain

Time domain
18/11/2021 – 04/07/2022

(gedevent_v22_01_22_06.xlsx, 16/08/2022)

III/ Space variable
III/1/ Unit of space

CoordinatesCountryRegionTO BE DETERMINED
X
latitude
Latitude (in decimal degrees).
longitude
Longitude (in decimal degrees).” (codebook, p. 7)

III/2/ Space domain

GlobalMediterranean Sea and SahelTO BE DETERMINED
X
“UCDP Candidate is also released as a global version each Quarter.” (codebook, p. 3)

IV/ Data structure
IV/1/ Unit of observation

Unit of conflict (UC)UC-yearUC-actorCountry-year
X
Actor-yearDyad-yearOTHERTO BE DETERMINED
“The basic unit of analysis for the UCDP-Candidate dataset is the “event”, i.e. an individual incident (phenomenon) of lethal violence occurring at a given time and place.” (codebook, p. 2)

(gedevent_v22_01_22_06.xlsx, 16/08/2022)

“id
A unique numeric id identifying each event.” (codebook, p. 5)

IV/2/ Number of observations

Number of observation
7 991

(gedevent_v22_01_22_06.xlsx, 16/08/2022)

V/ All variables

Conflict nameConflict typeIntensity
XX
OutcomeTimeSpace
XX
ActorType of actorDyad
XX
CoalitionDeathsNon-conflit variables
X

“The UCDP Candidate data includes the same variables as the UCDP GED dataset, the main difference being that UCDP Candidate has a monthly release cycle and UCDP GED is released annually.” (codebook, p. 2)

“conflict_new_id
A unique conflict identification code for each individual conflict in the dataset.
[…]
conflict_name
Name of the UCDP conflict to which the event belongs. For non-state conflicts and one-sided violence this is the same as the dyad name.” ([UCDP] Georeferenced Event Dataset (GED) (v. 22.1), codebook, p. 7)
type_of_violence
Type of UCDP conflict:
1: state-based conflict
2: non-state conflict
3: one-sided violence” ([UCDP] Georeferenced Event Dataset (GED) (v. 22.1), codebook, p. 6)
date_start
The earliest possible date when the event has taken place. […]
date_end
The last possible date when the event has taken place.” ([UCDP] Georeferenced Event Dataset (GED) (v. 22.1), codebook, p. 10)
latitude
Latitude (in decimal degrees) [….]
longitude
Longitude (in decimal degrees)” ([UCDP] Georeferenced Event Dataset (GED) (v. 22.1), codebook, p. 9)
side_a_new_id
A unique ID of side A. […]
side_a
The name of Side A in the dyad. In state-based conflicts always a government. In one-sided violence always the perpetrating party.” ([UCDP] Georeferenced Event Dataset (GED) (v. 22.1), codebook, p. 7)
dyad_new_id
A unique conflict identification code for each individual dyad in the dataset. […]
dyad_name
Name of the conflict dyad creating the event.
A dyad is the pair of two actors engaged in violence (in the case of one-sided violence, the perpetrator of violence and civilians).” ([UCDP] Georeferenced Event Dataset (GED) (v. 22.1), codebook, p. 7)
deaths_a
The best estimate of deaths sustained by side a.” ([UCDP] Georeferenced Event Dataset (GED) (v. 22.1), codebook, p. 11)

VI/ Transparency
VI/1/ Sources

Intergovernmental organizationsGovernmental organizationsNon-governmental organizations
XXX
Research organizationsPress mediaSocial media
XX
Other databasesOTHERTO BE DETERMINED
“Algeria, Tunisia, Morocco, Western Sahara
Factiva: Agence France Presse, All Africa, Associated Press Newswires, BBC Monitoring Middle East, BBC Monitoring Africa, BBC Monitoring Media, Reuters
Extra Sources: Africa Confidential, Africa Research Bulletin, Amnesty International, Crisis Watch, Human Rights Watch, International Crisis Group
Extra Sources area specific: Terrorism Monitor, UN Mission report to Western Sahara, Algeria Ministry of National Defense‘ website, Tunisia Coverage AnStrat” (codebook, p. 11)

VI/2/ Codebook

DateVersion
20221.2
“Version 1.2
[…]
This version authored by Stina Högbladh (2022)” (codebook, p. 1)

VII/ Update
VII/1/ Current version

DateVersion
06/202222.01.22.06
“UCDP Candidate is also released as a global version each Quarter. The first covering the first 3 months, the second the first 6 months, the third the first 9 months and the fourth the full year. The first quarterly version was: 20.01.20.06 the latest 22.01.22.03.” (codebook, p. 3)

VII/2/ Regularly updated ?

Real-timeMonthQuarterAnnually
X
YES, PERIOD TO BE DETERMINEDTO BE DETERMINED
“UCDP Candidate is also released as a global version each Quarter. The first covering the first 3 months, the second the first 6 months, the third the first 9 months and the fourth the full year. The first quarterly version was: 20.01.20.06 the latest 22.01.22.03.” (codebook, p. 3)

VIII/ Access
VIII/1/ Registration ?

YESNO
X

VIII/2/ Formats

.XLS/.XLSX.CSV.DTA (STATA).RDTA
XX

(https://ucdp.uu.se/downloads/index.html#candidate, 14/10/2023)

VIII/3/ API ?

YESNOTO BE DETERMINED
X
“UCDP Candidate data is only available as a web-service through a RESTful API under the DaaS paradigm. Descriptions on how to use the UCDP API are available at http://ucdp.uu.se/apidocs/” (codebook, p. 22)