1GOGUI-STATISTICS(1)             GoGui Reference            GOGUI-STATISTICS(1)
2
3
4

NAME

6       gogui-statistics - Runs GTP commands on all positions of game
7       collections.
8

SYNOPSIS

10       gogui-statistics [-backward] [-begin commands] [-config file]
11                        [-commands commands] [-final commands] [-force]
12                        [-min n] [-max n] [-program program] [-quiet]
13                        [-random] [-setup n] [-size n] [-verbose] file.sgf...
14
15       gogui-statistics -help
16
17       gogui-statistics -version
18
19       gogui-statistics -analyze file [-config file] [-output file]
20                        [-precision n]
21

DESCRIPTION

23       gogui-statistics runs a a set of commands for a Go program supporting
24       the Go Text Protocol on each position of Go game collections. The
25       results are stored in the text file "gtpstatistics.dat" in table
26       format. If gogui-statistics is run with the option -analyze, a HTML
27       file is produced from the file statistics.dat. The HTML file contains
28       summary statistics for this file.
29
30       All GTP commands that return a single number can be used with
31       gogui-statistics. For the following standard and commonly used
32       commands, an automatic conversion of the result to a number is done:
33
34       cputime
35           The result is the difference to the last invocation of cputime.
36
37       estimate_score
38           The result is parsed for a score string as the first word (like GNU
39           Go's response) The score string is converted into a score number,
40           Black counting positive, White negative.
41
42       final_score
43           The result is parsed for a score string. The score string is
44           converted into a score number, Black counting positive, White
45           negative.
46
47       reg_genmove
48           The color of the move in the game is appended. The result is "1",
49           if the result is the same move as played in the game, "0"
50           otherwise.
51

OPTIONS

53       -analyze file
54           Analyze the result table file.dat. Creates a HTML report files. The
55           files will be placed in the same directory as file.dat and use file
56           as a filename prefix.
57
58       -backward
59           Iterate backward over positions, starting with end position as
60           number one.
61
62       -config file
63           Read command line options and arguments from the given file.
64
65       -commands commands
66           Comma separated list of GTP commands to run on each position
67           (before each move).
68
69       -final commands
70           Comma separated list of GTP commands to run only on final positions
71           (after the last move).
72
73       -force
74           Overwrite existing result table.
75
76       -help
77           Display help and exit.
78
79       -max
80           Only run commands on positions at less or equal this move number.
81
82       -min
83           Only run commands on positions at greater or equal this move
84           number.
85
86       -output file
87           Filename for result table. Default is statistics.dat. If option
88           -analyze is used, the output is a directory or directory and file
89           name prefix for the generated report files.
90
91       -precision n
92           Maximum number of fraction digits for floating point numbers in the
93           output file.
94
95       -program command
96           Command line for running Go program.
97
98       -quiet
99           Don't write information about progress to standard error stream.
100
101       -random
102           Only select one random position per game.
103
104       -setup
105           Allow setup stones in the root position.
106
107       -size n
108           Board size allowed for games (default 19).
109
110       -verbose
111           Print the GTP stream to the Go program to standard error.
112
113       -version
114           Print version and exit.
115

EXAMPLES

117   Run gogui-statistics
118           gogui-statistics -program "gnugo --mode gtp" \
119             -commands "reg_genmove,estimate_score,cputime" \
120             -final "final_score" \
121             regression/games/olympiad2004/19x19/*.sgf
122
123
124   Generate HTML Reports
125           gogui-statistics -analyze statistics.dat -output statistics/olympiad2004
126
127GoGui 1.4.9                       02/10/2017               GOGUI-STATISTICS(1)
Impressum