cricketdata: International Cricket Data

Description

Data on international and other major cricket matches from ESPNCricinfo https://www.espncricinfo.com and Cricsheet https://cricsheet.org. This package provides some functions to download the data into tibbles ready for analysis.

Author(s)

Maintainer: Rob Hyndman Rob.Hyndman@monash.edu

Authors:

• Charles Gray C.Gray@latrobe.edu.au

• Sayani Gupta Sayani.Gupta@monash.edu

• Timothy Hyndman Timothy.Hyndman@gmail.com

• Hassan Rafique dazzalytics@protonmail.com

• Jacquie Tran jac@jacquietran.com

Other contributors:

• Puwasala Gamakumara Puwasala.Gamakumara@monash.edu [contributor]

• Alex Whan alexwhan@gmail.com [contributor]

See Also

Useful links:

• https://pkg.robjhyndman.com/cricketdata/

• https://github.com/robjhyndman/cricketdata

• Report bugs at https://github.com/robjhyndman/cricketdata/issues

Codes used for competitions on Cricsheet

Description

A dataset containing the names and codes used by cricsheet, as at 24 March 2025.

Usage

cricsheet_codes

Format

A data frame with 44 rows and 2 variables.

Source

https://cricsheet.org/downloads/#experimental

Fetch Data from Cricinfo

Description

Fetch data from ESPNCricinfo and return a tibble. All arguments are case-insensitive and partially matched.

Usage

fetch_cricinfo(
  matchtype = c("test", "odi", "t20"),
  sex = c("men", "women"),
  activity = c("batting", "bowling", "fielding"),
  type = c("career", "innings"),
  country = NULL
)

Arguments

Value

A tibble object, similar to a data.frame.

Author(s)

Rob J Hyndman, Timothy Hyndman, Charles Gray

Examples

## Not run: 
auswt20 <- fetch_cricinfo("T20", "Women", country = "Aust")
IndiaODIBowling <- fetch_cricinfo("ODI", "men", "bowling", country = "india")

## End(Not run)

Fetch ball-by-ball, match and player data from Cricsheet and return a tibble.

Description

Download csv data from Cricsheet https://cricsheet.org/downloads/. Data must be specified by three factors: (a) type of data: bbb (ball-by-ball), match or player. (b) gender; (c) competition specified as a Cricsheet code. See cricsheet_codes for the competitions and codes available.

Usage

fetch_cricsheet(
  type = c("bbb", "match", "player"),
  gender = c("female", "male"),
  competition = "tests"
)

Arguments

Value

A tibble object, similar to a data.frame.

Author(s)

Jacquie Tran, Hassan Rafique and Rob J Hyndman

Examples

## Not run: 
wbbl_bbb <- fetch_cricsheet(competition = "wbbl", type = "bbb")
wbbl_match <- fetch_cricsheet(competition = "wbbl", type = "match")
wbbl_player <- fetch_cricsheet(competition = "wbbl", type = "player")

## End(Not run)

Fetch Player Data

Description

Fetch individual player data from all matches played. The function will scrape the data from ESPNCricinfo and return a tibble with one line per innings for all games a player has played. To identify a player, use their Cricinfo player ID. The simplest way to find this is to look up their Cricinfo Profile page. The number at the end of the URL is the ID. For example, Meg Lanning's profile page is http://www.espncricinfo.com/australia/content/player/329336.html, so her ID is 329336.

Usage

fetch_player_data(
  playerid,
  matchtype = c("test", "odi", "t20"),
  activity = c("batting", "bowling", "fielding")
)

Arguments

Value

A tibble containing data on the selected player, with one row for every innings of every match in which they have played.

Author(s)

Rob J Hyndman and Sayani Gupta

See Also

find_player_id() to find a player ID by searching on their name, and fetch_player_meta() to download meta data for players.

Examples

## Not run: 
# Download data on some players
EllysePerry <- fetch_player_data(275487, "T20", "batting")
RahulDravid <- fetch_player_data(28114, "ODI", "fielding")
LasithMalinga <- fetch_player_data(49758, "Test", "bowling")

# Create a plot for Ellyse Perry's T20 scores
library(dplyr)
library(ggplot2)
EllysePerry |>
  filter(!is.na(Runs)) |>
  ggplot(aes(x = Start_Date, y = Runs, col = Dismissal, na.rm = TRUE)) +
  geom_point() +
  ggtitle("Ellyse Perry's T20 Scores")

## End(Not run)

Fetch Player Meta Data

Description

Fetch player meta data from ESPNCricinfo and return a tibble with one line per player. To identify the players, use their Cricinfo player IDs. The simplest way to find this is to look up their Cricinfo Profile page. The number at the end of the URL is the ID. For example, Meg Lanning's profile page is https://www.espncricinfo.com/cricketers/meg-lanning-329336, so her ID is 329336.

Usage

fetch_player_meta(playerid)

Arguments

Value

A tibble containing meta data on the selected players, with one row for each player.

Author(s)

Hassan Rafique and Rob J Hyndman

See Also

It is usually simpler to just use the saved data set player_meta which contains the meta data for all players on ESPNCricinfo as at 24 March 2025. To find a player ID, use find_player_id(). Use fetch_player_data() to download playing statistics for a player.

Examples

## Not run: 
# Download meta data on Meg Lanning and Ellyse Perry
aus_women <- fetch_player_meta(c(329336, 275487))

## End(Not run)

Find a player id from cricinfo.com

Description

Find a player id from cricinfo.com

Usage

find_player_id(searchstring)

Arguments

Value

A table of matching players, their ids, and teams they played for.

Author(s)

Rob J Hyndman

See Also

fetch_player_data() to download playing statistics for a player, and fetch_player_meta() to download meta data on players.

Examples

## Not run: 
(perry <- find_player_id("Perry"))
EllysePerry <- fetch_player_data(perry[2, "ID"], "test")

## End(Not run)

Meta data on players listed at ESPNCricinfo

Description

A dataset containing the names and other attributes of players who appear on both cricsheet and ESPNCricinfo, as at 24 March 2025.

Usage

player_meta

Format

A data frame with 16101 rows and 11 variables.

Source

https://www.espncricinfo.com

Update player_meta

Description

The player_meta data set contains the names and other attributes of players who appear on both cricsheet and ESPNCricinfo as at 24 March 2025. This function returns an updated version of the data set based on information currently available online.

Usage

update_player_meta(start_again = FALSE)

Arguments

Value

A tibble containing meta data on cricket players.

Author(s)

Hassan Rafique and Rob J Hyndman

See Also

player_meta, fetch_player_meta().

Examples

## Not run: 
# Update data to current
new_player_meta <- update_player_meta()

## End(Not run)