getEventProb {dice} | R Documentation |
For a specified dice-rolling process, getEventProb
calculates the probability of an event (i.e., a non-empty set of outcomes) that is specified by passing a list
object in to eventList
.
getEventProb(nrolls, ndicePerRoll, nsidesPerDie, eventList, orderMatters = FALSE)
nrolls |
A single positive integer representing the number of dice rolls to make |
ndicePerRoll |
A single positive integer representing the number of dice to use in each dice roll |
nsidesPerDie |
A single positive integer representing the number of sides on each die (getEventProb 's dice-rolling process involves only one type of die per call) |
eventList |
A list object, each element of which is a vector that constrains a single dice roll in the dice-rolling process (see Details below) |
orderMatters |
A logical flag indicating whether the order of the elements of eventList should constrain the event space; if TRUE, eventList must specify constraints for every dice roll–i.e., it must contain exactly nrolls elements (some of which may be "empty" constraints listing all possible outcomes of a dice roll, i.e., a vector from ndicePerRoll to (ndicePerRoll * nsidesPerDie) ) |
The crux of this function is eventList
, which sets the conditions that acceptable dice-rolls must meet. E.g., to get the probability of rolling at least one 6 when rolling four six-sided dice, eventList
would be list(6)
and orderMatters
would be FALSE; to get the probability of rolling a 6, followed by a 5, followed by either a 1, 2, or 3 when rolling three six-sided dice, eventList
would be list(6,5,1:3)
and orderMatters
would be TRUE.
A single number representing the probability of an event that meets the constraints of the specified dice-rolling process
Dylan Arena
## Probability of rolling at least one 6 when rolling four six-sided dice getEventProb(nrolls = 4, ndicePerRoll = 1, nsidesPerDie = 6, eventList = list(6)) ## Probability of rolling a 6, followed by a 5, followed by either a 1, 2, ## or 3 when rolling three six-sided dice getEventProb(nrolls = 3, ndicePerRoll = 1, nsidesPerDie = 6, eventList = list(6, 5, 1:3), orderMatters = TRUE) ## Probability of rolling no 10's when rolling two ten-sided dice getEventProb(nrolls = 2, ndicePerRoll = 1, nsidesPerDie = 10, eventList = list(1:9,1:9))