Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
R
demo
man
tests
.gitignore
DESCRIPTION
NAMESPACE
NEWS
README.md
index.html

README.md

formhub.R =========

formhub.R is a library for making reading data form formhub.org into R easier. Fork me on GitHub

Examples

For most of the examples, I use the ggplot2 library, which is an amazing data visualization library worth every minute of your time spent learning it.

Installing formhub.R

The package for formhub.R in R is simply called formhub. For now, it cannot be installed from CRAN, but using Hadley Wickam's excellent devtools package, you can install it directly from github. To install (or upgrade), run the following commands from your R terminal:

install.packages('devtools') 
library(devtools)
install_github("formhub.R", username="SEL-Columbia")
library(formhub)

And voila! The formhub package is installed in your R system! You can check by running:

help(formhubDownload)

Features

At the moment, it has the following features:

  • One command download of formhub.org data -- both public and private
  • (Automatic) casting of data to the right type, based on the type of the input field in XLSform
    • select one fields are converted to factors
    • integer/decimal converted to numerics
    • date fields (including today), and datetime fields (including start and end) are converted to lubridate instants [timezone information is discarded at the moment]
    • TRUE / FALSE fields created out of select multiple options are converted into booleans
  • removeColumns convenience function that removes columns based on matching the title with a regular expression
  • 'extra-schema' over-ride.

For planned features, go to the issues page.