Skip to contents

Data collection using computer-assisted personal interviewing or CAPI tools is now the standard approach for conducting surveys and studies. A wide range of CAPI systems are currently being used. The ability to interface with these systems helps in the overall data process. This package provides interface functions to CAPI systems based on the Open Data Kit or ODK technology.

Motivation and development history

The ODK ecosystem

What does the package do?

Currently, okapi provides functions to interface with two ODK-based systems: ONA and KoboToolbox via their respective APIs. The current set of functions perform the following tasks:

  1. Authenticate with the respective servers using either an account password or an API token;

  2. List resources in the server available to interface with; and,

  3. Get data or resources from the server to R.

Installation

okapi is not yet available on CRAN.

You can install okapi from the RapidSurveys R Universe with:

install.packages(
  "okapi", 
  repos = c(
    'https://rapidsurveys.r-universe.dev', 
    'https://cloud.r-project.org'
  )
)

Usage

Citation

If you use okapi in your work, please cite using the suggested citation provided by a call to the citation function as follows:

citation("okapi")
#> To cite okapi in publications use:
#> 
#>   Ernest Guevarra (2023). okapi: Open Data Kit (ODK)-based
#>   Computer-assisted Personal Interview (CAPI) Tools R package
#>   version 0.1.0.9000 URL https://rapidsurveys.io/okapi/
#> 
#> A BibTeX entry for LaTeX users is
#> 
#>   @Manual{,
#>     title = {okapi: Open Data Kit (ODK)-based Computer-assisted Personal Interview (CAPI) Tools},
#>     author = {{Ernest Guevarra}},
#>     year = {2023},
#>     note = {R package version 0.1.0.9000},
#>     url = {https://rapidsurveys.io/okapi/},
#>   }

Community guidelines

Feedback, bug reports and feature requests are welcome; file issues or seek support here. If you would like to contribute to the package, please see our contributing guidelines.

This project is released with a Contributor Code of Conduct. By participating in this project you agree to abide by its terms.