From e6b2873a84c4e2ea6e1213c77b096fcf4cbf8aec Mon Sep 17 00:00:00 2001 From: Marcus Young Date: Sun, 31 Mar 2019 19:59:46 +0100 Subject: [PATCH] Readme update --- DESCRIPTION | 6 +++--- README.Rmd | 21 ++++++++++++++++++--- README.md | 21 +++++++++++++++++++-- 3 files changed, 40 insertions(+), 8 deletions(-) diff --git a/DESCRIPTION b/DESCRIPTION index 49d8642..baaa11b 100644 --- a/DESCRIPTION +++ b/DESCRIPTION @@ -1,11 +1,11 @@ Package: otpr -Title: An R Wrapper for the OpenTripPlanner REST API +Title: An R Wrapper for the 'OpenTripPlanner' REST API Version: 0.1.0 Authors@R: c( person("Marcus", "Young", email = "M.A.Young@soton.ac.uk", role = c("aut", "cre")) ) -Description: An R wrapper for the OpenTripPlanner (OTP) - REST API. Queries are submitted to the relevant OTP API resource, the response +Description: A wrapper for the 'OpenTripPlanner' + REST API. Queries are submitted to the relevant 'OpenTripPlanner' API resource, the response is parsed and useful R objects are returned. License: MIT + file LICENSE Encoding: UTF-8 diff --git a/README.Rmd b/README.Rmd index fd59482..03fd47b 100644 --- a/README.Rmd +++ b/README.Rmd @@ -15,7 +15,13 @@ knitr::opts_chunk$set( # otpr + + +[![CRAN status](https://www.r-pkg.org/badges/version/otpr)](https://cran.r-project.org/package=otpr) [![Build Status](https://travis-ci.org/marcusyoung/otpr.svg?branch=master)](https://travis-ci.org/marcusyoung/otpr) +[![lifecycle](https://img.shields.io/badge/lifecycle-maturing-blue.svg)](https://www.tidyverse.org/lifecycle/#maturing) + + ## Overview @@ -28,8 +34,11 @@ This package will be useful to researchers and transport planners who want to us ## Installation -```{r, eval = FALSE} -# To install the development version from GitHub: +``` r +# Install from CRAN +install.packages("otpr") + +# Or the development version from GitHub: # install.packages("devtools") devtools::install_github("marcusyoung/otpr") ``` @@ -80,7 +89,7 @@ otp_get_distance( ### Time between two points -The get the trip duration in minutes between an origin and destination use `otp_get_times()`. +To get the trip duration in minutes between an origin and destination use `otp_get_times()`. You can specify the required mode: TRANSIT (all available transit modes), BUS, RAIL, CAR, BICYCLE, and WALK are valid. All the public transit modes automatically allow WALK. There is also the option to combine TRANSIT with BICYCLE. @@ -162,3 +171,9 @@ of using **otpr** functions, and helps you get the most from the package, for ex an origin-destination matrix. For more guidance on how **otpr**, in conjunction with OTP, can be used to generate data for input into models, read [An automated framework to derive model variables from open transport data using R, PostgreSQL and OpenTripPlanner](https://eprints.soton.ac.uk/389728/). + +## Getting help + +* Please [report any issues or bugs](https://github.com/marcusyoung/otpr/issues). +* Get citation information for **otpr** using: `citation(package = 'otpr')`. + diff --git a/README.md b/README.md index 7e38d96..fa7d947 100644 --- a/README.md +++ b/README.md @@ -3,8 +3,15 @@ # otpr + + +[![CRAN +status](https://www.r-pkg.org/badges/version/otpr)](https://cran.r-project.org/package=otpr) [![Build Status](https://travis-ci.org/marcusyoung/otpr.svg?branch=master)](https://travis-ci.org/marcusyoung/otpr) +[![lifecycle](https://img.shields.io/badge/lifecycle-maturing-blue.svg)](https://www.tidyverse.org/lifecycle/#maturing) + + ## Overview @@ -21,7 +28,10 @@ derive variables for use in transportation models. ## Installation ``` r -# To install the development version from GitHub: +# Install from CRAN +install.packages("otpr") + +# Or the development version from GitHub: # install.packages("devtools") devtools::install_github("marcusyoung/otpr") ``` @@ -99,7 +109,7 @@ otp_get_times( #> [1] "OK" #> #> $duration -#> [1] 4084 +#> [1] 5563 # By default the date and time of travel is taken as the current system date and @@ -192,3 +202,10 @@ For more guidance on how **otpr**, in conjunction with OTP, can be used to generate data for input into models, read [An automated framework to derive model variables from open transport data using R, PostgreSQL and OpenTripPlanner](https://eprints.soton.ac.uk/389728/). + +## Getting help + + - Please [report any issues or + bugs](https://github.com/marcusyoung/otpr/issues). + - Get citation information for **otpr** using: `citation(package = + 'otpr')`.