NAME
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
