README.md

In bldavies/stravadata: Strava activity data

stravadata

stravadata is an R package providing convenient access to my Strava activity data. The package contains the following data frames.

• activities: aggregate activity features.
• streams: disaggregate activity streams.
• best_efforts: activity best efforts.

I obtain these data via the Strava API using the process described here.

Usage

See my blog post for examples.

Installation

The public version of this package does not include any data. Users need to add their own. The steps for doing so are as follows.

1. Clone or fork the repo.
2. Log in to Strava and create an API application on the API settings page. (I put "localhost" in the "Authorization Callback Domain" field.)
3. Create credentials.yaml in the repo's top-level directory, and include the API application's client ID and secret as follows: yaml client_id: xxxxx secret: xxxxx
4. Run make data in a Terminal window at the repo's top-level directory. (This may take some time for users with many Strava activities or a slow internet connection.)

After creating the data, run make package in the same Terminal window or devtools::install() in a fresh stravadata.Rproj instance to install the package.

Dependencies

Run

install.packages(c('tidyverse', 'vroom'))

at the R console to install the packages necessary for adding data.

License

MIT

bldavies/stravadata documentation built on Oct. 12, 2024, 11:36 a.m.