DiceUtil

java.lang.Object
- DiceUtil

public class DiceUtil
extends java.lang.Object

Field Summary

Fields
Modifier and Type	Field and Description
`static int[][]`	`choose` Result of choose function indexed by n, k.
`static int`	`MAX_DICE` Maximum number of dice modeled
`static int`	`MAX_RANK` Maximum die rank
`static int`	`MIN_RANK` Minimum die rank
`static int`	`NUM_RANKS` Number of die ranks.

Constructor Summary

Constructors
Constructor and Description

DiceUtil()

Constructors
Constructor and Description
`DiceUtil()`

Method Summary

All Methods Static Methods Concrete Methods
Modifier and Type	Method and Description
`static int`	`choose(int n, int k)` Combinatorial choose function
`static int`	`getNumSortedRolls(int numDice)` Return the number of unique sorted rolls given the number of dice.
`static void`	`intToRankCounts(int rollId, int numDice, int[] rankCounts)` Convert an integer roll ID number to the corresponding dice rank counts representation
`static void`	`intToRoll(int i, int[] roll)` Convert an integer roll ID to the corresponding roll (sorted ascending)
`static void`	`main(java.lang.String[] args)` A test of conversion from roll number to rank counts to roll back to rank counts and back to roll number to check consistency of conversions for all possible rolls where dice order does not matter.
`static int`	`rankCountsToInt(int[] rankCounts)` Given the rank counts, return the unique integer ID representing that roll from an enumeration of all possible rolls.
`static int`	`rankCountsToInt(int numDice, int[] rankCounts)` Given the number of dice and the rank counts, return a unique integer roll ID from an enumeration of all possible rolls
`static void`	`rankCountsToRoll(int[] rankCounts, int[] roll)` Convert a rank count representation of a roll to a sorted roll representation.
`static int`	`rollToInt(int[] roll)` Return roll ID number associated with given ascending sorted roll array.
`static void`	`rollToRankCounts(int[] roll, int[] rankCounts)` Convert an unsorted roll representation to a rank count representation.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - MIN_RANK
```
public static final int MIN_RANK
```
    Minimum die rank
    
    See Also:
    
    Constant Field Values
  - MAX_RANK
```
public static final int MAX_RANK
```
    Maximum die rank
    
    See Also:
    
    Constant Field Values
  - NUM_RANKS
```
public static final int NUM_RANKS
```
    Number of die ranks. Ranks are assumed to be [MIN_RANK, MAX_RANK].
    
    See Also:
    
    Constant Field Values
  - MAX_DICE
```
public static final int MAX_DICE
```
    Maximum number of dice modeled
    
    See Also:
    
    Constant Field Values
  - choose
```
public static final int[][] choose
```
    Result of choose function indexed by n, k.
- Constructor Detail
  - DiceUtil
```
public DiceUtil()
```
- Method Detail
  - choose
```
public static int choose(int n,
                         int k)
```
    Combinatorial choose function
    
    Parameters:
    
    n - number of items
    
    k - number of items chosen without replacement
    
    Returns:
    
    the total number of ways k items may be chosen from n items without replacement
  - intToRankCounts
```
public static void intToRankCounts(int rollId,
                                   int numDice,
                                   int[] rankCounts)
```
    Convert an integer roll ID number to the corresponding dice rank counts representation
    
    Parameters:
    
    rollId - ID number of dice roll
    
    numDice - number of dice rolled
    
    rankCounts - mutable "return" parameter where rankCount[i] contains the number of dice rolled of rank i + MIN_RANK. Supplied as a parameter to allow an arbitrary array to be reused for this purpose.
  - rankCountsToInt
```
public static int rankCountsToInt(int numDice,
                                  int[] rankCounts)
```
    Given the number of dice and the rank counts, return a unique integer roll ID from an enumeration of all possible rolls
    
    Parameters:
    
    numDice - number of dice
    
    rankCounts - rankCounts[i] gives the number of dice rolled with rank (i + 1)
    
    Returns:
    
    a unique integer ID representing that roll from an enumeration of all possible rolls
  - rankCountsToInt
```
public static int rankCountsToInt(int[] rankCounts)
```
    Given the rank counts, return the unique integer ID representing that roll from an enumeration of all possible rolls. Note: If the number of dice is already known, it is more efficient to call rankCountsToInt(int numDice, int[] rankCounts).
    
    Parameters:
    
    rankCounts - rankCounts[i] gives the number of dice rolled with rank (i + 1)
    
    Returns:
    
    a unique integer ID representing that roll from an enumeration of all possible rolls
  - rankCountsToRoll
```
public static void rankCountsToRoll(int[] rankCounts,
                                    int[] roll)
```
    Convert a rank count representation of a roll to a sorted roll representation.
    
    Parameters:
    
    rankCounts - input representation of a roll as rank counts
    
    roll - mutable "return" array parameter to contain corresponding sorted roll
  - rollToRankCounts
```
public static void rollToRankCounts(int[] roll,
                                    int[] rankCounts)
```
    Convert an unsorted roll representation to a rank count representation.
    
    Parameters:
    
    roll - input unsorted roll representation
    
    rankCounts - mutable output array to contain the corresponding rank count representation
  - intToRoll
```
public static void intToRoll(int i,
                             int[] roll)
```
    Convert an integer roll ID to the corresponding roll (sorted ascending)
    
    Parameters:
    
    i - roll ID
    
    roll - mutable "return" parameter where roll contains the ascending sorted roll for the given roll ID. Supplied as a parameter to allow an arbitrary array to be reused for this purpose.
  - rollToInt
```
public static int rollToInt(int[] roll)
```
    Return roll ID number associated with given ascending sorted roll array.
    
    Parameters:
    
    roll - array containing the ascending sorted roll.
    
    Returns:
    
    associated roll ID.
  - getNumSortedRolls
```
public static int getNumSortedRolls(int numDice)
```
    Return the number of unique sorted rolls given the number of dice.
    
    Parameters:
    
    numDice - the number of dice rolled
    
    Returns:
    
    the number of unique sorted rolls given the number of dice
  - main
```
public static void main(java.lang.String[] args)
```
    A test of conversion from roll number to rank counts to roll back to rank counts and back to roll number to check consistency of conversions for all possible rolls where dice order does not matter.
    
    Parameters:
    
    args - (unused)

Class DiceUtil

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

MIN_RANK

MAX_RANK

NUM_RANKS

MAX_DICE

choose

Constructor Detail

DiceUtil

Method Detail

choose

intToRankCounts

rankCountsToInt

rankCountsToInt

rankCountsToRoll

rollToRankCounts

intToRoll

rollToInt

getNumSortedRolls

main