Type: Package
Title: Top Chef Data
Version: 0.2.0
Author: Levitz Carly E ORCID iD [cre, aut, cph]
Maintainer: Levitz Carly E <celevitz@gmail.com>
Description: Several datasets which describe the chef contestants in Top Chef, the challenges that they compete in, and the results of those challenges. This data is useful for practicing data wrangling, graphing, and analyzing how each season of Top Chef played out.
URL: https://github.com/celevitz/topChef
BugReports: https://github.com/celevitz/topChef/issues
Depends: R (≥ 4.2.0)
Imports: tidyr (≥ 1.3.0), dplyr (≥ 1.1.0)
License: MIT + file LICENSE
Encoding: UTF-8
LazyData: true
RoxygenNote: 7.3.1
Suggests: knitr, rmarkdown, testthat (≥ 3.0.0), magrittr (≥ 2.0.0), ggplot2 (≥ 3.4.0)
Config/testthat/edition: 3
VignetteBuilder: knitr
Language: en-US
NeedsCompilation: no
Packaged: 2024-06-21 01:22:21 UTC; carlylevitz
Repository: CRAN
Date/Publication: 2024-06-21 05:20:02 UTC

topChef: Top Chef Data

Description

Several datasets which describe the chef contestants in Top Chef, the challenges that they compete in, and the results of those challenges. This data is useful for practicing data wrangling, graphing, and analyzing how each season of Top Chef played out.

Author(s)

Maintainer: Levitz Carly E celevitz@gmail.com (ORCID) [copyright holder]

See Also

Useful links:

challengedescriptions

Description

A dataset containing information about each challenge that the Chefs compete in

Usage

data(challengedescriptions)

Format

This data frame contains the following columns:

season

Name of season

seasonNumber

Season number

series

Top Chef US (listed as US); Top Chef US Masters (listed as US Masters); Top Chef Canada (listed as Canada)

episode

Episode number

challengeType

Challenge type: qualifying challenge, elimination, quickfire, sudden death quickfire, quickfire elimination, battle of the sous chefs

outcomeType

Is the challenge run as a team or as an individual?

challengeDescription

Description of the challenge

shopTime

If they go shopping, how long do they have? Unit is minutes

shopBudget

If they go shopping, what is their budget? Unit is dollars unless otherwise specified.

prepTime

If they have prep time, how long do they have? Unit is minutes

cookTime

How long they have to cook (in minutes)

productPlacement

List of products promoted in the challenge, other than the usual series-wide product placement. Will be blank if none were mentioned

advantage

If an advantage is offered to the winner of the challenge, it will be listed here: e.g., Immunity, choosing a protein in the elimination challenge, choosing your team in the elimination challenge. Will be blank if none were mentioned.

lastChanceKitchenWinnerEnters

If someone comes in from Last Chance Kitchen at this challenge, their name will be listed here. Will be blank for all other challenges.

restaurantWarWinner

Role played by the winner of restaurant wars: Executive Chef, Front of House, the full team, Line Cook, Roles Rotated, or No one won. Will only have values for Restaurant War episodes.

restaurantWarEliminated

Role played by the Chef eliminated after restaurant wars: Executive Chef, Front of House, the full team, Line Cook, Roles Rotated. Will only have values for Restaurant War episodes.

didJudgesVisitWinningTeamFirst

Categorical variable of which team was shown serving the judges first. Will only have values for Restaurant Wars episodes.

Source

https://en.wikipedia.org/wiki/Top_Chef

Examples

library(dplyr)
library(tidyr)
challengedescriptions %>%
   group_by(series,season,outcomeType) %>%
   summarise(n=n()) %>%
   pivot_wider(names_from=outcomeType,values_from=n)

challengewins

Description

A dataset containing win and loss data for each chef in each episode

Usage

data(challengewins)

Format

This data frame contains the following columns:

season

Name of season

seasonNumber

Season number

series

Top Chef US (listed as US); Top Chef US Masters (listed as US Masters); Top Chef Canada (listed as Canada)

episode

Episode number

inCompetition

True / false for whether the Chef was still in the competition at the time of the challenge

immune

True / false for whether that Chef was immune from being eliminated for challenge

chef

Name of chef

challengeType

Challenge type: qualifying challenge, elimination, quickfire, sudden death quickfire, quickfire elimination, battle of the sous chefs

outcome

Result for each Chef in the competition for that challenge

rating

Numeric rating provided to chefs in Top Chef US Masters Seasons 1 and 2. Will be blank for all other seasons.

Source

https://en.wikipedia.org/wiki/Top_Chef

Examples

library(dplyr)
library(tidyr)
challengewins %>%
  group_by(outcome) %>%
  summarise(n=n())

chefdetails

Description

A dataset containing information on each Chef for each season. As of now, it has data for all Top Chef US seasons, Top Chef Masters (US), and one season of Top Chef Canada.

Usage

data(chefdetails)

Format

This data frame contains the following columns:

name

Chef name (full name)

chef

Shorter version of the chef's name

hometown

Chef's hometown, if known

city

City in which the Chef lived at the time of show

state

State in which the Chef lived at the time of the show

age

Age of Chef at the time of the show

season

Name of season

seasonNumber

Season number

series

Top Chef US (listed as US); Top Chef US Masters (listed as US Masters); Top Chef Canada (listed as Canada)

placement

Final result of the Chef.

personOfColor

Flag for whether the Chef is a person of color. Will be blank if they are not

occupation

Occupation of Chef at time of show, if known

occupation_category

Categorization of occupation

gender

Gender of Chef

Source

https://en.wikipedia.org/wiki/Top_Chef

Examples

library(dplyr)
library(tidyr)
chefdetails %>%
  filter(season == "World All Stars")

episodeinfo

Description

A dataset containing information about each episode

Usage

data(episodeinfo)

Format

This data frame contains the following columns:

season

Name of season

seasonNumber

Season number

series

Top Chef US (listed as US); Top Chef US Masters (listed as US Masters); Top Chef Canada (listed as Canada)

overallEpisodeNumber

Running number of episode within the series

episode

Episode number

episodeName

Name of episode

airDate

Date the episode originally aired

nCompetitors

Number of Chefs still in the competition

Source

https://en.wikipedia.org/wiki/Top_Chef

Examples

library(dplyr)
library(tidyr)
episodeinfo %>% filter(season=="World All Stars")

judges

Description

A dataset containing information about who were the guest judges for each challenge

Usage

data(judges)

Format

This data frame contains the following columns:

season

Name of season

seasonNumber

Season number

series

Top Chef US (listed as US); Top Chef US Masters (listed as US Masters); Top Chef Canada (listed as Canada)

episode

Episode number

challengeType

Challenge type: qualifying challenge, elimination, quickfire, sudden death quickfire, quickfire elimination, battle of the sous chefs

outcomeType

Is the challenge run as a team or as an individual?

guestJudge

Name of guest judge

gender

Gender of Chef

personOfColor

Flag for whether the Chef is a person of color. Will be blank if they are not

competedOnTC

Will have a value of Yes if they competed on a season of Top Chef

otherShows

Information about other shows that this individual has appeared on

Source

https://en.wikipedia.org/wiki/Top_Chef

Examples

library(dplyr)
library(tidyr)
judges %>%
  filter(guestJudge == "Eric Ripert") %>%
  group_by(challengeType) %>%
  summarise(n=n())

rewards

Description

A dataset containing information about rewards and prizes won by challenge

Usage

data(rewards)

Format

This data frame contains the following columns:

season

Name of season

seasonNumber

Season number

series

Top Chef US (listed as US); Top Chef US Masters (listed as US Masters); Top Chef Canada (listed as Canada)

episode

Episode number

challengeType

Challenge type: qualifying challenge, elimination, quickfire, sudden death quickfire, quickfire elimination, battle of the sous chefs

outcomeType

Is the challenge run as a team or as an individual?

rewardType

Variable describing whether the reward is money or a prize

reward

Description of the full reward

chef

Name of chef

Source

https://en.wikipedia.org/wiki/Top_Chef

Examples

library(dplyr)
library(tidyr)
rewards %>%
  filter(rewardType == "Money") %>%
  mutate(reward=as.numeric(reward)) %>%
  group_by(season) %>%
  summarise(total=sum(reward))

Calculate One Season's Chef's Weighted Scores (Index)

Description

Calculates the Index score for each person within a season of Top Chef.

Usage

weightedindex(
  seriesname,
  seasonnumberofchoice,
  numberofelimchalls,
  numberofquickfires
)

Arguments

seriesname

Values can be: US, US Masters, Canada

seasonnumberofchoice

Integer of the season number within the series

numberofelimchalls

Number of elimination challenges you want to include in the index. Must be greater than 0

numberofquickfires

Number of quickfire challenges you want to include in the index. Must be greater than 0.

Details

The result of elimination challenges and quickfire challenges are weighted. Scoring: Elimination win = +7 points. Elimination high = +3 points. Elimination low = -3 points. Eliminated = -7 points. Quickfire win = +4 points. Quickfire high = +2 points. Quickfire low = -2 points. Combines Sudden Death Quickfires with Eliminations Excludes Qualifying Challenges Holding constant the number of elimination challenges and quickfire challenges will allow comparison across seasons if you want

Value

Tibble of index score for each contestant in that season and their placement