
<!-- README.md is generated from README.Rmd. Please edit that file -->

# acledR \| ACLED’s official R package <a href='https://dtacled.github.io/acledR/'><img src='man/figures/logo.png' align="right" height="139" /></a>

<!-- badges: start -->

[![R-CMD-check](https://github.com/dtacled/acledR/actions/workflows/R-CMD-check.yaml/badge.svg)](https://github.com/dtacled/acledR/actions/workflows/R-CMD-check.yaml)
[![codecov](https://codecov.io/gh/ACLED/acledR/graph/badge.svg?token=TDJodXhEvx)](https://app.codecov.io/gh/ACLED/acledR)
<!-- badges: end -->

acledR is the official R package from the [Armed Conflict Location and
Event Data Project (ACLED)](https://acleddata.com/), providing tools for
extracting and manipulating ACLED data. The acledR
[site](https://dtacled.github.io/acledR/) hosts more information on how
to use the package, including a general overview on the [Get
Started](https://dtacled.github.io/acledR/articles/get_started.html)
page.

To access ACLED data, please register an account at
[myACLED](https://acleddata.com/myacled). You can find detailed
instructions about the ACLED API
[here](https://acleddata.com/acled-api-documentation).

## Installation

``` r
# Install via cran
install.packages("acledR")

# Install development version from github
devtools::install_github("dtacled/acledR")
```
