convertr tutorial


for v0.1


An R package for converting things to other things.

The package contains one function which converts numerical vectors from one unit to another. Data on conversion factors comes from the POSC Units of Measure Dictionary v2.2 and Wikipedia.

Installation

Stable version from CRAN

install.packages("convertr")

Development version from GitHub

if (!require("devtools")) install.packages("devtools")
devtools::install_github("ropenscilabs/convertr")

library("convertr")

Usage

convert(1:20, "kg", "g")
convert(1:20, "sq yd", "km2")

#This will produce an error:
convert(1:20, "kg", "km2)

Units are converted using a lookup table, based on the POSC dictionary. You can explore this table using the explore_units() function. This function launches a shiny app.

Figuring out which units can be converted to each other can be tricky, so convertr comes with an an shiny gadget to help you build valid convert() expressions. This can be accesed either by calliing convert_gadget() or through the addin menu. To access the addin make sure you are using a recent version of RStudio.

Gadget Animation

Citing

Gordon Shotwell (2016). convertr: Convert Between Units. R package version 0.1. https://github.com/ropenscilabs/convertr

License and bugs

Back to top