acledR (version 1.0.1)

acled_update: Updating your ACLED dataset

Description

This function is meant to help you keep your dataset updated, by automatically checking for new and modified events, as well as deleted events (if deleted = TRUE). Note: The function makes new API calls to gather new and modified events.

Usage

acled_update(
  df,
  start_date = min(df$event_date),
  end_date = max(df$event_date),
  additional_countries = "current countries",
  regions = NULL,
  event_types = NULL,
  email = NULL,
  password = NULL,
  inter_numeric = FALSE,
  deleted = TRUE
)

Value

Tibble with updated ACLED data and a newer timestamp.

Arguments

df

The dataframe to update, it has to have the same structure as ACLED's dyadic dataframe (i.e. the result of acled_api())

start_date

The first date of events you want to update from.. These are the celling and floor of event_date, not of timestamp.

end_date

The last date of events you want to update from. These are the celling and floor of event_date, not of timestamp.

additional_countries

string. Additional additional_countries to update your dataset. It defaults to “current countries”, which includes all the additional_countries inside your dataset.

regions

string. The regions for which you would like events in your dataset updated.

event_types

string. The event types for which you would like events in your dataset updated.

email

character string. Email associated with your ACLED account registered at https://acleddata.com/.

password

character string. The password associated with your ACLED account. If NULL, you will be prompted to enter your password interactively.

inter_numeric

logical. If FALSE (default), interaction code columns (inter1, inter2, and interaction) returned as strings describing the actor types/interactions. If TRUE, the values are returned as numeric values. Must match the inter type (numeric or string) in the dataframe being updated.

deleted

logical. If TRUE (default), the function will also remove deleted events using acled_deletions_api().

See Also

Other API and Access: acled_api(), acled_auth(), acled_deletions_api()

Examples

if (FALSE) {
# Updating dataset to include newer data from Argentina


new_argen_dataset <- acled_update(acledR::acled_old_dummy,
 email = "[e-mail]", password = "password",
  additional_countries = "Argentina",
)
}