Skip to content
R package about shootings reported in Fogo Cruzado app, in Rio de Janeiro and Recife
R
Branch: master
Clone or download
lgelape Update README.md
Update loading package
Latest commit 0b5c187 Jun 26, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
R Upload v. 0.1.0 Jun 26, 2019
man Upload v. 0.1.0 Jun 26, 2019
DESCRIPTION Upload v. 0.1.0 Jun 26, 2019
Introducao_crossfire.md Rename Introducao_crossfire to Introducao_crossfire.md Jun 26, 2019
Introduction_crossfire.md Update Introduction_crossfire.md Jun 26, 2019
NAMESPACE Upload v. 0.1.0 Jun 26, 2019
README.md Update README.md Jun 26, 2019
crossfire.Rproj Upload v. 0.1.0 Jun 26, 2019

README.md

crossfire

crossfire is a package created to give easier access to the datasets of the project Fogo Cruzado, which is a digital collaboration platform to register gun shootings in the metropolitan areas of Rio de Janeiro and Recife.

The package facilitates data extraction from the project open-data API, developed by Volt Data Lab.

Installing and loading the package

Currently, the crossfire package can be installed directly from its GitHub repository:

if (!require("devtools")) install.packages("devtools")
devtools::install_github("voltdatalab/crossfire")

library(crossfire)

Functions

crossfire has 3 functions: fogocruzado_signin, get_fogocruzado and get_cities.

  • fogocruzado_signin is used to give access to Fogo Cruzado's API. To access Fogo Cruzado's API, users should be registered and insert their e-mail and password for authentication. Thus, the function registers these information on the current R session, so that it can be used to obtain the Bearer token to extract data using the API.

  • get_fogocruzado extracts slices or the whole dataset of shootings registered by Fogo Cruzado. The function returns a data frame, in which each line corresponds to a shooting registered and its information. It can also filter the data according to some parameters, city/state - city and state -, initial and final date - initial_date and final_date -, the presence of security forces - security_agent -, and the information source - source.

# Extract data for all registered shootings
fogocruzado_all <- get_fogocruzado()

# Extract data for shootings in the cities of Rio de Janeiro and Recife in 2018
fogocruzado_rj_recife <- get_fogocruzado(city = c("Rio de Janeiro", "Recife"),
                                         initial_date = "2018-01-01", final_date = "2018-12-31")

# Extract data from occurents reported by the police and in which security agents were present
fogocruzado_security <- get_fogocruzado(security_agent = 1, source = 2)
  • get_cities() returns a data.frame with information about all cities from the Rio de Janeiro and Recife metropolitan areas covered by the Fogo Cruzado initiative.

More information

For more information on how the package works and for a complete list of functions, see the vignettes (in English and Portuguese).

Authors

Lucas Gelape, for Volt Data Lab.

Contributors

Sérgio Spagnuolo and Denisson Silva.

You can’t perform that action at this time.