Skip to contents

Get statistics for one or all venues. Includes scoring rates, wicket rates, and match conditions.

Usage

venue_stats(
  venue = NULL,
  match_type = NULL,
  min_matches = 5,
  source = c("local", "remote"),
  db_path = NULL
)

Arguments

venue

Character. Venue name (partial match supported). If NULL (default), returns stats for all venues.

match_type

Character. Filter by match type: "T20", "ODI", "Test", "IT20", "MDM", or NULL for all formats. Required for remote source.

min_matches

Integer. Minimum matches to include (default 5). Only applies when venue is NULL.

source

Character. "local" (default) uses local DuckDB. "remote" queries GitHub releases via fast download.

db_path

Character. Database path (only used when source = "local").

Value

Data frame with venue metrics:

  • venue, city, matches, avg_first_innings, avg_second_innings

  • run_rate, wickets_per_match, boundary_rate

Examples

if (FALSE) { # \dontrun{
# Get all venues' stats
all_venues <- venue_stats()

# Get T20 venue stats
t20_venues <- venue_stats(match_type = "T20")

# Get stats for a specific venue
mcg <- venue_stats("MCG")

# Get stats for venues in a city
mumbai_venues <- venue_stats("Mumbai")

# Get T20 venue stats from remote (no local install needed)
remote_venues <- venue_stats(match_type = "T20", source = "remote")
} # }