Reference
Contents
Index
Dices.CompactedComparison
Dices.CompositeRoll
Dices.Dice
Dices.DiceRoll
Dices.DropRoll
Dices.KeepRoll
Dices.Roll
Dices.Roll
Dices.drop
Dices.histogram
Dices.keep
Dices.prob
Dices.roll
Dices.roll
Dices.rolllist
Statistics.mean
Statistics.median
Statistics.std
Statistics.var
Dices.CompactedComparison
— TypeCompactedComparison(r, op, x)
Stores a comparison between a roll r and a value x. Use collect
to collect all the roll values that satisfy that comparison.
Dices.CompositeRoll
— TypeA CompositeRoll
is a roll where its parts are rolls. This structure is usually used only internally.
Dices.Dice
— TypeDice(sides)
Dice
is the basic structure of the package. It has sides
. The traditionall RPG dices are predefined: d4
, d6
, d8
, d10
, d12
, and d20
. There is also an additional useful "dice": coin
.
Dices.DiceRoll
— TypeA DiceRoll is an Roll made only of dices. A sum or product of several dices, for instance.
Dices.DropRoll
— TypeA DropRoll is a roll where some of the parts of the internal roll are ignored. See drop
for more information.
Dices.KeepRoll
— TypeA KeepRoll is a roll where some of the parts of the internal roll are ignored. See keep
for more information.
Dices.Roll
— TypeA Roll is an abstract type for operations with Dice.
Dices.Roll
— MethodRoll(d :: Dice)
Create a Roll from a single Dice. Usually used internally.
Dices.drop
— Methoddrop(r)
drop(r; kind=:lowest, n=1)
Drops the lowest part of a roll. Notice that for a DiceRoll
, this means dropping the lowest dice in a roll, but for composite dice, it can mean dropping a whole segment. For instance
drop(4d6)
will drop the lowest valued dice of the four 6-sided dices rolled. It is equivalent to
v = roll.([d6, d6, d6, d6])
sum(v) - minimum(v)
On the other hand,
drop((2d4 - 1) * (2d4 - 1))
will drop the lowest of the product, i.e., it is equivalent to
v = roll.([2d4 - 1, 2d4 - 1])
sum(v) - minimum(v)
keyword arguments
kind
: Either:lowest
or:highest
to remove either the lowest or highest roll or rolls.n
: The number of dices to be removed.
Dices.histogram
— Methodvalues, frequency = histogram(dice; normalize=false)
values, frequency = histogram(roll; normalize=false)
Computes the histogram of a dice or roll. This operation can be intensive because it computes the histogram of its internal parts recursively, so it can slow for complicated rolls.
Dices.keep
— Methodkeep(r)
keep(r; kind=:highest, n=1)
Keep only the highest part of a roll. Notice that for a DiceRoll
, this means keeping the largest dice in a roll, but for composite dice, it can mean keeping a whole segment. See the behaviour of drop
for more information.
keyword arguments
kind
: Either:lowest
or:highest
to keep either the lowest or highest roll or rolls.n
: The number of dices to be kept.
Dices.prob
— Methodprob(comparison)
Compute the probability of the given comparison, e.g., prod(2d4 > 3)
.
Dices.roll
— Methodroll(d :: Dice)
Roll the dice d
.
Dices.roll
— Methodroll(r :: Roll)
Roll r
.
Dices.rolllist
— Methodrolllist(d :: Dice; generator=false)
rolllist(r :: Roll; generator=false)
Show all possible rolllist of dice d
or roll r
. For DiceRoll
s this is a list of all dice results. For CompositeRoll
s and other Roll
s where its parts are made of Roll
s.
Statistics.mean
— Methodmean(r)
Compute the mean of a dice or roll.
Statistics.median
— Methodmedian(r)
Compute the median of a dice or roll.
Statistics.std
— Methodstd(r)
Compute the standard deviation of a dice or roll.
Statistics.var
— Methodvar(r)
Compute the variance of a dice or roll.