GNU rollout program

Usage

sagnubg [flags] [cmd-file] [output-file]

Process `cmd-file' and write results to `output-file'. `cmd-file' and `output-file' default to stdin and stdout respectively.

Command Line Flags

flag	full name	description
`-w`	--weights-dir=`FILE`	Explicitly specify name of NN's files. Default is to use the environment variable `GNUBGWEIGHTS` if it exists, otherwise use `gnubg.weights' in the same directory as the executable.
	--moves2p-limit=`N`	Maximum number of moves to keep after 0-ply pruning. Default is 20.
	--rollout-limit=`N`	Maximum number of moves to rollout. Default is 5.
	--rollout-games=`N`	Number of games per rollout. Default is 1296.
	--cube-away=`N`	Use (N,N) away for cube decisions. Default is 7.
	--include-ply0=1/0	Force inclusion of top 0-ply move. Default is 1.
	--eval-plies=`N`	Ply used in evaluation (`e' command).
	--n-osr=`N`	Number of games for OSR evaluation (`O' command).
	--no-shortcuts	Disable usage of small net pruning.
	--resume	Resume an interrupted run. Both `cmd-file' and `output-file' must be given.
`-v`	--verbose	Print status report to stderr during run.
`-h`	--help

Command File Format

Command file is a simple ASCII file. Each command occupies one line, where the first character specifies command type.

# ...

Comment. Echoed to output.

s SETTINGS

Change run settings in the middle.

s nRollOutGames 12960

r N

Set randomizer seed to N for next `m' or `o' command. Echoed to output.

m position dice₀ dice₁

Rollout top 2-ply moves. Output is

m position dice₀ dice₁ move₁ eqt move₂ dif₂ move₃ dif₃ ...

eqt is the (money) equity of the best move, and dif_i if the equity difference of move_i from best.

c position

Perform Cube-full Rollout of position with centered cube and 2 cube follwong a Double/Take. Output is

c position P_nd P_dt action

P_nd and P_dt are match win%, in the range 0 to 100. action is one of `TG',`D/T',`D/D' or `ND'.

o position

Rollout position. Output is

o position p₀ p₁ p₂ p₃ p₄

Where the p_i's are the GNUbg net evaluation probabilities.

e position

Evaluate position using the net.

Output is,

e position p₀ p₁ p₂ p₃ p₄

O position

Evaluate race position using the OSR method.

Output is,

O position p₀ p₁ p₂ p₃ p₄

b position dice₀ dice₁

Find evaluation best move.

Output is,

b position dice₀ dice₁ move p₀ p₁ p₂ p₃ p₄

move is the position after the move, p_i are the position evaluation.

Note that output has the same format as the input, i.e. can serve as input for another run.

The positions are encoded as 20 character in the range of `A' to `F'. Each letter stands for 4 bits (A == 0x0, F == 0xf), and concatenated they form the 80 bit GNUbg position ID.