roll_dice_formula: Simulating rolling a dice, using a formula

In tidydice: Simulates Dice Rolls and Coin Flips

Simulating rolling a dice, using a formula

Description

Simulating rolling a dice, using a formula

Usage

roll_dice_formula(
  data = NULL,
  dice_formula = "1d6",
  times = 1,
  rounds = 1,
  seed = NULL,
  prob = NULL,
  success = c(6),
  agg = FALSE,
  label = NULL
)

Arguments

data	Data from a previous experiment
dice_formula	Dice formula (e.g. "1d6" = 1 dice with 6 sides)
times	How many times a dice is rolled (or how many dice are rolled at the same time)
rounds	Number of rounds
seed	Seed to produce reproducible results
prob	Vector of probabilities for each side of the dice
success	Which result is a success (default = 6)
agg	If TRUE, the result is aggregated (by experiment, rounds) (not implemented)
label	Custom text to distinguish an experiment, can be used for plotting etc.

Value

Result of experiment as a tibble

Examples

# roll one 6-sided dice
roll_dice_formula(dice_formula = "1d6")

# roll one 8-sided dice
roll_dice_formula(dice_formula = "1d8")

# roll two 6-sided dice
roll_dice_formula(dice_formula = "2d6")

# roll two 6-sided dice, explode dice on a 6
roll_dice_formula(dice_formula = "2d6e6")

# roll three 6-sided dice, keep highest 2 rolls
roll_dice_formula(dice_formula = "3d6kh2")

# roll three 6-sided dice, keep lowest 2 rolls
roll_dice_formula(dice_formula = "3d6kl2")

# roll four 6-sided dice, keep highest 3 rolls, but explode on a 6
roll_dice_formula(dice_formula = "4d6kh3e6")

# roll one 20-sided dice, and add 4
roll_dice_formula(dice_formula = "1d20+4")

# roll one 4-sided dice and one 6-sided dice, and sum the results
roll_dice_formula(dice_formula = "1d4+1d6")

tidydice documentation built on Feb. 16, 2023, 7:50 p.m.