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/10/2017 GoGui 1.4.9 GoGui Reference