Files
Stockfish/docs/stats.md
Tomasz Sobczyk dc00b6c188 Update docs
2021-05-19 13:52:18 +02:00

1.8 KiB

Stats

gather_statistics command allows gathering various statistics from a .bin or a .binpack file. The syntax is gather_statistics (GROUP)* input_file FILENAME. There can be many groups specified. Any statistic gatherer that belongs to at least one of the specified groups will be used.

Simplest usage: stockfish.exe gather_statistics all input_file a.binpack

Any name that doesn't designate an argument name or is not an argument will be interpreted as a group name.

Parameters

input_file - the path to the .bin or .binpack input file to read

max_count - the maximum number of positions to process. Default: no limit.

Groups

all - a special group designating all statistics gatherers available.

position_count - the total number of positions in the file.

king, king_square_count - the number of times a king was on each square. Output is layed out as a chessboard, with the 8th rank being the topmost. Separate values for white and black kings.

move, move_from_count - same as king_square_count but for from_sq(move)

move, move_to_count - same as king_square_count but for to_sq(move)

move, move_type - the number of moves with each type. Includes normal, captures, castling, promotions, enpassant. The groups are not disjoint.

move, moved_piece_type - the number of times a piece of each type was moved

piece_count - the histogram of the number of pieces on the board

ply_discontinuities - the number of times the ply jumped by a value different than 1 between two consecutive positions. Usually the number of games.

material_imbalance - the histogram of imbalances, with values computed using "simple eval", that is pawn=1, bishop=knight=3, rook=5, queen=9

results - the distribution of game results

endgames_6man - distribution of endgame configurations for <=6 pieces (including kings)