Using the Squiggle API

In fitzRoy: Easily Scrape and Process AFL Data

not_cran <- identical(Sys.getenv("NOT_CRAN"), "true")
online <- !is.null(curl::nslookup("r-project.org", error = FALSE))
eval_param <- not_cran & online

knitr::opts_chunk$set(
  eval = eval_param,
  message = FALSE,
  warning = FALSE,
  collapse = TRUE,
  comment = "#>"
)

library(fitzRoy)
library(dplyr)

Squiggle Data

You can access data from the Squiggle API directly with the fetch_squiggle_data. This allows direct access to the Squiggle API.

Note that we also provide some helper functions that map more closely to our fetch_ functions such as fetch_ladder_squiggle.

Queries

Full instructions for constructing queries can be found at Squiggle API. One of the following must be provided to the query argument.

• teams - Info about teams (e.g. Richmond, Geelong, West Coast)
• games - Info about games (e.g. Round 1, 2019 Richmond v Carlton)
• sources - Info about models (e.g. Matter of Stats, GRAFT, Swinburne)
• tips - Info about tips and predictions made by models
• standings - Info about team standings (i.e. the ladder)
• ladder - Info about predicted ladders generated by models
• virtual - Info about Virtually Season 2020
• pav - Info about Player Approximate Value from HPN Footy

Optional Arguments

Optional arguments can then be supplied based on the query.

For example, games takes the following optional arguments. year - Year round - Round game - Game ID complete - Percent of game complete

These can be supplied as named arguments after the query. For example, to return games from just 2020, we would use the following.

fetch_squiggle_data(query = "games", year = 2020)

fitzRoy:::squiggle_games %>% filter(year == 2020)

Examples

Teams

Fetch info about one or more AFL teams.

fetch_squiggle_data("teams")

fitzRoy:::squiggle_teams

Games

Fetch info about one or more games.

fetch_squiggle_data(query = "games", year = 2020)

fitzRoy:::squiggle_games %>% filter(year == 2020)

Sources

Fetch info about one or more computer models.

# You can get the sources
fetch_squiggle_data("sources")

fitzRoy:::squiggle_sources

Tips

Fetch info about one or more tips made by computer models.

# Get all tips
fetch_squiggle_data("tips")

fitzRoy:::squiggle_tips

We can just look at one particular round.

# Get` just tips from round 1, 2018
fetch_squiggle_data("tips", round = 1, year = 2018)

fitzRoy:::squiggle_tips %>% filter(year == 2018 & round == 1)

Standings

Fetch info about team standings at a point in time, i.e. the ladder.

fetch_squiggle_data("standings", year = 2020, round = 1)

fitzRoy:::squiggle_standings

Ladder

Fetch info about one or more projected ladders generated by computer models. For the actual ladder, see standings instead.

fetch_squiggle_data("ladder", year = 2019, round = 15, source = 1)

fitzRoy:::squiggle_ladder

PAV

Fetch info about players using HPN Footy's Player Approximate Value.

fetch_squiggle_data("pav",
  firstname = "Dustin",
  surname = "Martin",
  year = 2017
)

fitzRoy:::squiggle_pav

fitzRoy documentation built on Sept. 11, 2024, 6:52 p.m.