
“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 | ∅ | ∅ | ∅ |
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 conflict | Non-state conflict | One-sided violence | TO BE DETERMINED |
---|---|---|---|
X | X | X | ∅ |
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
Day | Year |
---|---|
X | ∅ |
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
Coordinates | Country | Region | TO BE DETERMINED |
---|---|---|---|
X | ∅ | ∅ | ∅ |
Latitude (in decimal degrees).
longitude
Longitude (in decimal degrees).” (codebook, p. 7)
III/2/ Space domain
Global | Mediterranean Sea and Sahel | TO BE DETERMINED |
---|---|---|
X | ∅ | ∅ |
IV/ Data structure
IV/1/ Unit of observation
Unit of conflict (UC) | UC-year | UC-actor | Country-year |
---|---|---|---|
X | ∅ | ∅ | ∅ |
Actor-year | Dyad-year | OTHER | TO BE DETERMINED |
---|---|---|---|
∅ | ∅ | ∅ | ∅ |

(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 name | Conflict type | Intensity |
---|---|---|
X | X | ∅ |
Outcome | Time | Space |
---|---|---|
∅ | X | X |
Actor | Type of actor | Dyad |
---|---|---|
X | ∅ | X |
Coalition | Deaths | Non-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 organizations | Governmental organizations | Non-governmental organizations |
---|---|---|
X | X | X |
Research organizations | Press media | Social media |
---|---|---|
X | X | ∅ |
Other databases | OTHER | TO BE DETERMINED |
---|---|---|
∅ | ∅ | ∅ |
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
Date | Version |
---|---|
2022 | 1.2 |
[…]
This version authored by Stina Högbladh (2022)” (codebook, p. 1)
VII/ Update
VII/1/ Current version
Date | Version |
---|---|
06/2022 | 22.01.22.06 |

VII/2/ Regularly updated ?
Real-time | Month | Quarter | Annually |
---|---|---|---|
∅ | ∅ | X | ∅ |
YES, PERIOD TO BE DETERMINED | TO BE DETERMINED |
---|---|
∅ | ∅ |
VIII/ Access
VIII/1/ Registration ?
YES | NO |
---|---|
∅ | X |
VIII/2/ Formats
.XLS/.XLSX | .CSV | .DTA (STATA) | .RDTA |
---|---|---|---|
X | X | ∅ | ∅ |

(https://ucdp.uu.se/downloads/index.html#candidate, 14/10/2023)
VIII/3/ API ?
YES | NO | TO BE DETERMINED |
---|---|---|
X | ∅ | ∅ |