gogui-statistics

gogui-statistics
Prev	Appendix A. Reference	Next

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

Prev	Up	Next
gogui-server	Home	gogui-terminal