gogui-statistics man page

gogui-statistics — Runs GTP commands on all positions of game collections.

Synopsis

gogui-statistics [-backward] [-begin commands] [-config file] [-commands commands] [-final commands] [-force] [-min n] [-max n] [-program program] [-quiet] [-random] [-setup n] [-size n] [-verbose] file.sgf...

gogui-statistics -help

gogui-statistics -version

gogui-statistics -analyze file [-config file] [-output file] [-precision n]

Description

gogui-statistics runs a a set of commands for a Go program supporting the Go Text Protocol on each position of Go game collections. The results are stored in the text file "gtpstatistics.dat" in table format. If gogui-statistics is run with the option -analyze, a HTML file is produced from the file statistics.dat. The HTML file contains summary statistics for this file.

All GTP commands that return a single number can be used with gogui-statistics. For the following standard and commonly used commands, an automatic conversion of the result to a number is done:

cputime

The result is the difference to the last invocation of cputime.

estimate_score

The result is parsed for a score string as the first word (like GNU Go's response) The score string is converted into a score number, Black counting positive, White negative.

final_score

The result is parsed for a score string. The score string is converted into a score number, Black counting positive, White negative.

reg_genmove

The color of the move in the game is appended. The result is "1", if the result is the same move as played in the game, "0" otherwise.

Options

-analyze file
Analyze the result table file.dat. Creates a HTML report files. The files will be placed in the same directory as file.dat and use file as a filename prefix.
-backward
Iterate backward over positions, starting with end position as number one.
-config file
Read command line options and arguments from the given file.
-commands commands
Comma separated list of GTP commands to run on each position (before each move).
-final commands
Comma separated list of GTP commands to run only on final positions (after the last move).
-force
Overwrite existing result table.
-help
Display help and exit.
-max
Only run commands on positions at less or equal this move number.
-min
Only run commands on positions at greater or equal this move number.
-output file
Filename for result table. Default is statistics.dat. If option -analyze is used, the output is a directory or directory and file name prefix for the generated report files.
-precision n
Maximum number of fraction digits for floating point numbers in the output file.
-program command
Command line for running Go program.
-quiet
Don't write information about progress to standard error stream.
-random
Only select one random position per game.
-setup
Allow setup stones in the root position.
-size n
Board size allowed for games (default 19).
-verbose
Print the GTP stream to the Go program to standard error.
-version
Print version and exit.

Examples

Run gogui-statistics

gogui-statistics -program "gnugo --mode gtp" \
  -commands "reg_genmove,estimate_score,cputime" \
  -final "final_score" \
  regression/games/olympiad2004/19x19/*.sgf

Generate HTML Reports

gogui-statistics -analyze statistics.dat -output statistics/olympiad2004

Info

02/04/2016 GoGui 1.4.9 GoGui Reference