Stockfish/docs/stats.md

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

output_file - optional path to the output file to write the results too. Results are always written on the console, so if this is specified the results will be written in both places.

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)