#include "base.h"
#include "board.h"
#include "game.h"
#include "search.h"
#include "util.h"
#include <stdbool.h>

Classes
struct	Book
	The opening book. More...

struct	GameStats
	Game statistics. More...

struct	Link
	a move (with its score) linking to another Position. More...

struct	Position
	A position stored in the book. More...

Macros
#define	FLAG_DONE 1

#define	FLAG_TODO 2

#define	FLAG_BESTPATH_BLACK 4

Typedefs
typedef struct Book	Book
	The opening book.

typedef struct GameStats	GameStats
	Game statistics.

typedef struct Link	Link
	a move (with its score) linking to another Position.

typedef struct Position	Position
	A position stored in the book.

Functions
void	book_init (Book *)
	Initialize the opening book.

void	book_free (Book *)
	Free resources used by the opening book.

void	book_preprocess (Book *)
	clean opening book.

void	book_stats_clean (Book *)

void	book_new (Book *, int, int)
	Create a new opening book.

void	book_load (Book , const char )
	Load the opening book.

void	book_save (Book , const char )
	Save an opening book.

void	book_import (Book , const char )
	Import an opening book.

void	book_export (Book , const char )
	Export an opening book.

void	book_merge (Book , const Book )
	Merge two opening books.

void	book_sort (Book *book)
	Sort a book.

void	book_negamax (Book *)
	Negamax a book.

void	book_prune (Book *)
	Prune a book.

void	book_deepen (Book *)
	Deepen a book.

void	book_correct_solved (Book *)
	Correct wrong solved score in the book.

void	book_link (Book *)
	Link a book.

void	book_fix (Book *)
	Fix a book.

void	book_fill (Book *book, const int)
	Fill a book.

void	book_deviate (Book , Board , const int, const int)
	Deviate a book.

void	book_enhance (Book , Board , const int, const int)
	Enhance a book.

void	book_subtree (Book , const Board )
	Prune a book.

void	book_play (Book *)
	Play.

void	book_info (Book *)
	display some book's informations.

void	book_show (Book , Board )
	Display a position from the book.

void	book_count_bestpath (Book , Board , Position *)
	count the number of best paths in book.

void	book_stop_count_bestpath (Book *)

Position *	book_show_for_api (Book , Board )
	Display a position from the book.

void	book_count_board_bestpath (Book , Board , Position *, const int, const int, const int)
	count the number of "broad" best paths in book.

void	book_stats (Book *book)
	print book statistics.

bool	book_get_moves (Book , const Board , MoveList *)
	Get a list of moves from the book.

int	book_get_moves_with_position (Book , const Board , MoveList , Position )
	Get a list of moves from the book.

bool	book_get_random_move (Book , const Board , Move *, const int)
	Get a move at random from the opening book.

void	book_get_game_stats (Book , const Board , GameStats *)
	Get game statistics from a position.

void	book_get_line (Book , const Board , const Move , Line )
	Get a variation from the book.

void	book_add_board (Book , const Board )
	Add a position.

void	book_add_game (Book , const Game )
	Add positions from a game.

void	book_add_base (Book , const Base )
	Add positions from a game database.

void	book_check_base (Book , const Base )
	Check positions from a game database.

void	book_extract_skeleton (Book , Base )
	Extract book draws to a game base.

void	book_extract_positions (Book *, const int, const int)
	print a set of position.

void	book_feed_hash (const Book , Board , Search *)
	feed hash table from the opening book.

Detailed Description

Header file for opening book management

Date: 1998 - 2017

Author: Richard Delorme

Version: 4.4

Macro Definition Documentation

◆ FLAG_BESTPATH_BLACK

#define FLAG_BESTPATH_BLACK 4

◆ FLAG_DONE

#define FLAG_DONE 1

◆ FLAG_TODO

#define FLAG_TODO 2

Typedef Documentation

◆ Book

typedef struct Book Book

The opening book.

struct Book

◆ GameStats

typedef struct GameStats GameStats

Game statistics.

struct GameStat

◆ Link

typedef struct Link Link

a move (with its score) linking to another Position.

struct Link

◆ Position

typedef struct Position Position

A position stored in the book.

struct Position

Function Documentation

◆ book_add_base()

void book_add_base	(	Book *	book,
		const Base *	base )

Add positions from a game database.

Parameters

book	opening book.
base	games to add.

◆ book_add_board()

void book_add_board	(	Book *	book,
		const Board *	board )

Add a position.

Parameters

book	opening book.
board	position to add.

◆ book_add_game()

void book_add_game	(	Book *	book,
		const Game *	game )

Add positions from a game.

Parameters

book	opening book.
game	game to add.

◆ book_check_base()

void book_check_base	(	Book *	book,
		const Base *	base )

Check positions from a game database.

Parameters

book	opening book.
base	games to add.

◆ book_correct_solved()

void book_correct_solved ( Book * book )

Correct wrong solved score in the book.

Correct erroneous solved positions. Edax may be unstable and introduce bugs from time to time...

Parameters

book	opening book.

◆ book_count_bestpath()

void book_count_bestpath	(	Book *	book,
		Board *	board,
		Position *	position )

count the number of best paths in book.

Parameters

book	Opening book.
board	Starting position.
position	the number of best paths(out parameter)

◆ book_count_board_bestpath()

void book_count_board_bestpath	(	Book *	book,
		Board *	board,
		Position *	position,
		const int	p_lower,
		const int	o_lower,
		const int	turn )

count the number of "broad" best paths in book.

Parameters

book	Opening book.
board	Starting position.
position	the number of best paths(out parameter)
p_lower	lower limit for player (BESTPATH_BEST:best moves only)
o_lower	lower limit for opponent (BESTPATH_BEST:best moves only)
turn	turn of the position

◆ book_deepen()

void book_deepen ( Book * book )

Deepen a book.

Research all non link best move.

Parameters

book	opening book.

◆ book_deviate()

void book_deviate	(	Book *	book,
		Board *	board,
		const int	relative_error,
		const int	absolute_error )

Deviate a book.

Parameters

book	opening book.
board	Position to start from.
relative_error	Error relative to the current position's score.
absolute_error	Error relative to the root position's score.

◆ book_enhance()

void book_enhance	(	Book *	book,
		Board *	board,
		const int	midgame_error,
		const int	endcut_error )

Enhance a book.

Parameters

book	opening book.
board	Position to start from.
midgame_error	Error in midgame search.
endcut_error	Error in endgame search.

◆ book_export()

void book_export	(	Book *	book,
		const char *	file )

Export an opening book.

Save the book in a portable text format.

Parameters

book	Opening book.
file	File name.

◆ book_extract_positions()

void book_extract_positions	(	Book *	book,
		const int	n_empties,
		const int	n_positions )

print a set of position.

Parameters

book	Opening book.
n_empties	Game stage.
n_positions	Number of positions to extract.

◆ book_extract_skeleton()

void book_extract_skeleton	(	Book *	book,
		Base *	base )

Extract book draws to a game base.

This function supposes that f5d6c4 & f5f6e6f4 are draws and the only draws, excluding the transpositions f5d6c3d3c4 & f5f6e6c6 & c4..., d3..., e6...

Parameters

book	Opening book.
base	game database.

◆ book_feed_hash()

void book_feed_hash	(	const Book *	book,
		Board *	board,
		Search *	search )

feed hash table from the opening book.

Parameters

book	Opening book.
board	Position to start from.
search	HashTables container.

◆ book_fill()

void book_fill	(	Book *	book,
		const int	depth )

Fill a book.

Parameters

book	opening book.
depth	Distance to fill between two positions.

◆ book_fix()

void book_fix ( Book * book )

Fix a book.

Parameters

book	opening book.

◆ book_free()

void book_free ( Book * book )

Free resources used by the opening book.

Parameters

book	Opening book.

◆ book_get_game_stats()

void book_get_game_stats	(	Book *	book,
		const Board *	board,
		GameStats *	stat )

Get game statistics from a position.

Parameters

book	Opening book.
board	Position to find a move from.
stat	Game statistics output.

◆ book_get_line()

void book_get_line	(	Book *	book,
		const Board *	board,
		const Move *	move,
		Line *	line )

Get a variation from the book.

Parameters

book	Opening book.
board	Position.
move	First move;
line	Bariation.

◆ book_get_moves()

bool book_get_moves	(	Book *	book,
		const Board *	board,
		MoveList *	movelist )

Get a list of moves from the book.

Parameters

book	Opening book.
board	Position to display.
movelist	List of moves.

◆ book_get_moves_with_position()

int book_get_moves_with_position	(	Book *	book,
		const Board *	board,
		MoveList *	movelist,
		Position *	position )

Get a list of moves from the book.

Parameters

book	Opening book.
board	Position to display.
movelist	List of moves.
position	position.

Returns: symetry. If -1, it means "no book".

◆ book_get_random_move()

bool book_get_random_move	(	Book *	book,
		const Board *	board,
		Move *	move,
		const int	randomness )

Get a move at random from the opening book.

Parameters

book	Opening book.
board	Position to find a move from.
move	Chosen move.
randomness	Randomness.

◆ book_import()

void book_import	(	Book *	book,
		const char *	file )

Import an opening book.

Read the opening book from a portable text format. After the book is imported, it is needed to relink & negamax it.

Parameters

book	Opening book.
file	File name.

◆ book_info()

void book_info ( Book * book )

display some book's informations.

Parameters

book	opening book.

◆ book_init()

void book_init ( Book * book )

Initialize the opening book.

Create an empty opening book.

Parameters

book	Opening book.

◆ book_link()

void book_link ( Book * book )

Link a book.

Parameters

book	opening book.

◆ book_load()

void book_load	(	Book *	book,
		const char *	file )

Load the opening book.

Parameters

book	Opening book.
file	File name.

◆ book_merge()

void book_merge	(	Book *	dest,
		const Book *	src )

Merge two opening books.

It is needed to relink & negamax the destination book after merging.

Parameters

dest	Destination opening book.
src	Source opening book.

◆ book_negamax()

void book_negamax ( Book * book )

Negamax a book.

Parameters

book	opening book.

◆ book_new()

void book_new	(	Book *	book,
		int	level,
		int	n_empties )

Create a new opening book.

Create an opening book with the initial position & a single non link move.

Parameters

book	Opening book.
level	search level to evaluate positions.
n_empties	number of empty positions up to which to evaluate positions.

◆ book_play()

void book_play ( Book * book )

Play.

Add positions to the opening book by adding links to position with no links.

Parameters

book	opening book.

◆ book_preprocess()

void book_preprocess ( Book * book )

clean opening book.

Parameters

book	Opening book.

◆ book_prune()

void book_prune ( Book * book )

Prune a book.

Remove positions Edax cannot reach.

Parameters

book	opening book.

◆ book_save()

void book_save	(	Book *	book,
		const char *	file )

Save an opening book.

Save the book in a fast binary format.

Parameters

book	Opening book.
file	File name.

◆ book_show()

void book_show	(	Book *	book,
		Board *	board )

Display a position from the book.

Parameters

book	opening book.
board	position to display.

◆ book_show_for_api()

Position * book_show_for_api	(	Book *	book,
		Board *	board )

Display a position from the book.

Parameters

book	opening book.
board	position to display.

◆ book_sort()

void book_sort ( Book * book )

Sort a book.

Parameters

book	opening book.

◆ book_stats()

void book_stats ( Book * book )

print book statistics.

Parameters

book	Opening book.

◆ book_stats_clean()

void book_stats_clean ( Book * book )

◆ book_stop_count_bestpath()

void book_stop_count_bestpath ( Book * book )

◆ book_subtree()

void book_subtree	(	Book *	book,
		const Board *	board )

Prune a book.

Remove positions Edax cannot reach.

Parameters

book	opening book.

Classes

Macros

Typedefs

Functions

Detailed Description

Macro Definition Documentation

◆ FLAG_BESTPATH_BLACK

◆ FLAG_DONE

◆ FLAG_TODO

Typedef Documentation

◆ Book

◆ GameStats

◆ Link

◆ Position

Function Documentation

◆ book_add_base()

◆ book_add_board()

◆ book_add_game()

◆ book_check_base()

◆ book_correct_solved()

◆ book_count_bestpath()

◆ book_count_board_bestpath()

◆ book_deepen()

◆ book_deviate()

◆ book_enhance()

◆ book_export()

◆ book_extract_positions()

◆ book_extract_skeleton()

◆ book_feed_hash()

◆ book_fill()

◆ book_fix()

◆ book_free()

◆ book_get_game_stats()

◆ book_get_line()

◆ book_get_moves()

◆ book_get_moves_with_position()

◆ book_get_random_move()

◆ book_import()

◆ book_info()

◆ book_init()

◆ book_link()

◆ book_load()

◆ book_merge()

◆ book_negamax()

◆ book_new()

◆ book_play()

◆ book_preprocess()

◆ book_prune()

◆ book_save()

◆ book_show()

◆ book_show_for_api()

◆ book_sort()

◆ book_stats()

◆ book_stats_clean()

◆ book_stop_count_bestpath()

◆ book_subtree()