uct_genmove(): Print perceived score when passing
[pachi.git] / uct / uct.c
blob09e4ad125905c262409217b3013afc5ad16b6876
1 #include <assert.h>
2 #include <math.h>
3 #include <pthread.h>
4 #include <signal.h>
5 #include <stdio.h>
6 #include <stdlib.h>
7 #include <string.h>
8 #include <time.h>
10 #define DEBUG
12 #include "debug.h"
13 #include "board.h"
14 #include "gtp.h"
15 #include "move.h"
16 #include "mq.h"
17 #include "playout.h"
18 #include "playout/elo.h"
19 #include "playout/moggy.h"
20 #include "playout/light.h"
21 #include "random.h"
22 #include "tactics.h"
23 #include "timeinfo.h"
24 #include "distributed/distributed.h"
25 #include "uct/dynkomi.h"
26 #include "uct/internal.h"
27 #include "uct/prior.h"
28 #include "uct/tree.h"
29 #include "uct/uct.h"
30 #include "uct/walk.h"
32 struct uct_policy *policy_ucb1_init(struct uct *u, char *arg);
33 struct uct_policy *policy_ucb1amaf_init(struct uct *u, char *arg);
34 static void uct_pondering_stop(struct uct *u);
35 static void uct_pondering_start(struct uct *u, struct board *b0, struct tree *t, enum stone color);
36 static char *uct_getstats(struct uct *u, struct board *b, coord_t *c);
38 /* Default number of simulations to perform per move.
39 * Note that this is now in total over all threads! (Unless TM_ROOT.) */
40 #define MC_GAMES 80000
41 #define MC_GAMELEN MAX_GAMELEN
42 static const struct time_info default_ti = {
43 .period = TT_MOVE,
44 .dim = TD_GAMES,
45 .len = { .games = MC_GAMES },
48 /* How big proportion of ownermap counts must be of one color to consider
49 * the point sure. */
50 #define GJ_THRES 0.8
51 /* How many games to consider at minimum before judging groups. */
52 #define GJ_MINGAMES 500
54 /* How often to inspect the tree from the main thread to check for playout
55 * stop, progress reports, etc. (in seconds) */
56 #define TREE_BUSYWAIT_INTERVAL 0.1 /* 100ms */
58 /* Once per how many simulations (per thread) to show a progress report line. */
59 #define TREE_SIMPROGRESS_INTERVAL 10000
61 /* How often to send stats updates for the distributed engine (in seconds). */
62 #define STATS_SEND_INTERVAL 0.5
64 /* When terminating uct_search() early, the safety margin to add to the
65 * remaining playout number estimate when deciding whether the result can
66 * still change. */
67 #define PLAYOUT_DELTA_SAFEMARGIN 1000
70 static void
71 setup_state(struct uct *u, struct board *b, enum stone color)
73 u->t = tree_init(b, color, u->fast_alloc ? u->max_tree_size : 0, u->local_tree_aging);
74 if (u->force_seed)
75 fast_srandom(u->force_seed);
76 if (UDEBUGL(0))
77 fprintf(stderr, "Fresh board with random seed %lu\n", fast_getseed());
78 //board_print(b, stderr);
79 if (!u->no_book && b->moves == 0) {
80 assert(color == S_BLACK);
81 tree_load(u->t, b);
85 static void
86 reset_state(struct uct *u)
88 assert(u->t);
89 tree_done(u->t); u->t = NULL;
92 static void
93 setup_dynkomi(struct uct *u, struct board *b, enum stone to_play)
95 if (u->t->use_extra_komi && u->dynkomi->permove)
96 u->t->extra_komi = u->dynkomi->permove(u->dynkomi, b, u->t);
99 static void
100 prepare_move(struct engine *e, struct board *b, enum stone color)
102 struct uct *u = e->data;
104 if (u->t) {
105 /* Verify that we have sane state. */
106 assert(b->es == u);
107 assert(u->t && b->moves);
108 if (color != stone_other(u->t->root_color)) {
109 fprintf(stderr, "Fatal: Non-alternating play detected %d %d\n",
110 color, u->t->root_color);
111 exit(1);
114 } else {
115 /* We need fresh state. */
116 b->es = u;
117 setup_state(u, b, color);
120 u->ownermap.playouts = 0;
121 memset(u->ownermap.map, 0, board_size2(b) * sizeof(u->ownermap.map[0]));
124 static void
125 dead_group_list(struct uct *u, struct board *b, struct move_queue *mq)
127 struct group_judgement gj;
128 gj.thres = GJ_THRES;
129 gj.gs = alloca(board_size2(b) * sizeof(gj.gs[0]));
130 board_ownermap_judge_group(b, &u->ownermap, &gj);
131 groups_of_status(b, &gj, GS_DEAD, mq);
134 bool
135 uct_pass_is_safe(struct uct *u, struct board *b, enum stone color, bool pass_all_alive)
137 if (u->ownermap.playouts < GJ_MINGAMES)
138 return false;
140 struct move_queue mq = { .moves = 0 };
141 if (!pass_all_alive)
142 dead_group_list(u, b, &mq);
143 return pass_is_safe(b, color, &mq);
146 /* This function is called only when running as slave in the distributed version. */
147 static enum parse_code
148 uct_notify(struct engine *e, struct board *b, int id, char *cmd, char *args, char **reply)
150 struct uct *u = e->data;
152 static bool board_resized = false;
153 board_resized |= is_gamestart(cmd);
155 /* Force resending the whole command history if we are out of sync
156 * but do it only once, not if already getting the history. */
157 if ((move_number(id) != b->moves || !board_resized)
158 && !reply_disabled(id) && !is_reset(cmd)) {
159 if (UDEBUGL(0))
160 fprintf(stderr, "Out of sync, id %d, move %d\n", id, b->moves);
161 static char buf[128];
162 snprintf(buf, sizeof(buf), "out of sync, move %d expected", b->moves);
163 *reply = buf;
164 return P_DONE_ERROR;
166 u->gtp_id = id;
167 return reply_disabled(id) ? P_NOREPLY : P_OK;
170 static char *
171 uct_printhook_ownermap(struct board *board, coord_t c, char *s, char *end)
173 struct uct *u = board->es;
174 assert(u);
175 const char chr[] = ":XO,"; // dame, black, white, unclear
176 const char chm[] = ":xo,";
177 char ch = chr[board_ownermap_judge_point(&u->ownermap, c, GJ_THRES)];
178 if (ch == ',') { // less precise estimate then?
179 ch = chm[board_ownermap_judge_point(&u->ownermap, c, 0.67)];
181 s += snprintf(s, end - s, "%c ", ch);
182 return s;
185 static char *
186 uct_notify_play(struct engine *e, struct board *b, struct move *m)
188 struct uct *u = e->data;
189 if (!u->t) {
190 /* No state, create one - this is probably game beginning
191 * and we need to load the opening book right now. */
192 prepare_move(e, b, m->color);
193 assert(u->t);
196 /* Stop pondering, required by tree_promote_at() */
197 uct_pondering_stop(u);
199 if (is_resign(m->coord)) {
200 /* Reset state. */
201 reset_state(u);
202 return NULL;
205 /* Promote node of the appropriate move to the tree root. */
206 assert(u->t->root);
207 if (!tree_promote_at(u->t, b, m->coord)) {
208 if (UDEBUGL(0))
209 fprintf(stderr, "Warning: Cannot promote move node! Several play commands in row?\n");
210 reset_state(u);
211 return NULL;
214 /* If we are a slave in a distributed engine, start pondering once
215 * we know which move we actually played. See uct_genmove() about
216 * the check for pass. */
217 if (u->pondering_opt && u->slave && m->color == u->my_color && !is_pass(m->coord))
218 uct_pondering_start(u, b, u->t, stone_other(m->color));
220 return NULL;
223 static char *
224 uct_chat(struct engine *e, struct board *b, char *cmd)
226 struct uct *u = e->data;
227 static char reply[1024];
229 cmd += strspn(cmd, " \n\t");
230 if (!strncasecmp(cmd, "winrate", 7)) {
231 if (!u->t)
232 return "no game context (yet?)";
233 enum stone color = u->t->root_color;
234 struct tree_node *n = u->t->root;
235 snprintf(reply, 1024, "In %d playouts at %d threads, %s %s can win with %.2f%% probability",
236 n->u.playouts, u->threads, stone2str(color), coord2sstr(n->coord, b),
237 tree_node_get_value(u->t, -1, n->u.value) * 100);
238 if (u->t->use_extra_komi && abs(u->t->extra_komi) >= 0.5) {
239 sprintf(reply + strlen(reply), ", while self-imposing extra komi %.1f",
240 u->t->extra_komi);
242 strcat(reply, ".");
243 return reply;
245 return NULL;
248 static void
249 uct_dead_group_list(struct engine *e, struct board *b, struct move_queue *mq)
251 struct uct *u = e->data;
253 /* This means the game is probably over, no use pondering on. */
254 uct_pondering_stop(u);
256 if (u->pass_all_alive)
257 return; // no dead groups
259 bool mock_state = false;
261 if (!u->t) {
262 /* No state, but we cannot just back out - we might
263 * have passed earlier, only assuming some stones are
264 * dead, and then re-connected, only to lose counting
265 * when all stones are assumed alive. */
266 /* Mock up some state and seed the ownermap by few
267 * simulations. */
268 prepare_move(e, b, S_BLACK); assert(u->t);
269 for (int i = 0; i < GJ_MINGAMES; i++)
270 uct_playout(u, b, S_BLACK, u->t);
271 mock_state = true;
274 dead_group_list(u, b, mq);
276 if (mock_state) {
277 /* Clean up the mock state in case we will receive
278 * a genmove; we could get a non-alternating-move
279 * error from prepare_move() in that case otherwise. */
280 reset_state(u);
284 static void
285 playout_policy_done(struct playout_policy *p)
287 if (p->done) p->done(p);
288 if (p->data) free(p->data);
289 free(p);
292 static void
293 uct_done(struct engine *e)
295 /* This is called on engine reset, especially when clear_board
296 * is received and new game should begin. */
297 struct uct *u = e->data;
298 uct_pondering_stop(u);
299 if (u->t) reset_state(u);
300 free(u->ownermap.map);
302 free(u->policy);
303 free(u->random_policy);
304 playout_policy_done(u->playout);
305 uct_prior_done(u->prior);
309 /* Pachi threading structure (if uct_playouts_parallel() is used):
311 * main thread
312 * | main(), GTP communication, ...
313 * | starts and stops the search managed by thread_manager
315 * thread_manager
316 * | spawns and collects worker threads
318 * worker0
319 * worker1
320 * ...
321 * workerK
322 * uct_playouts() loop, doing descend-playout until uct_halt
324 * Another way to look at it is by functions (lines denote thread boundaries):
326 * | uct_genmove()
327 * | uct_search() (uct_search_start() .. uct_search_stop())
328 * | -----------------------
329 * | spawn_thread_manager()
330 * | -----------------------
331 * | spawn_worker()
332 * V uct_playouts() */
334 /* Set in thread manager in case the workers should stop. */
335 volatile sig_atomic_t uct_halt = 0;
336 /* ID of the running worker thread. */
337 __thread int thread_id = -1;
338 /* ID of the thread manager. */
339 static pthread_t thread_manager;
340 static bool thread_manager_running;
342 static pthread_mutex_t finish_mutex = PTHREAD_MUTEX_INITIALIZER;
343 static pthread_cond_t finish_cond = PTHREAD_COND_INITIALIZER;
344 static volatile int finish_thread;
345 static pthread_mutex_t finish_serializer = PTHREAD_MUTEX_INITIALIZER;
347 struct spawn_ctx {
348 int tid;
349 struct uct *u;
350 struct board *b;
351 enum stone color;
352 struct tree *t;
353 unsigned long seed;
354 int games;
357 static void *
358 spawn_worker(void *ctx_)
360 struct spawn_ctx *ctx = ctx_;
361 /* Setup */
362 fast_srandom(ctx->seed);
363 thread_id = ctx->tid;
364 /* Run */
365 ctx->games = uct_playouts(ctx->u, ctx->b, ctx->color, ctx->t);
366 /* Finish */
367 pthread_mutex_lock(&finish_serializer);
368 pthread_mutex_lock(&finish_mutex);
369 finish_thread = ctx->tid;
370 pthread_cond_signal(&finish_cond);
371 pthread_mutex_unlock(&finish_mutex);
372 return ctx;
375 /* Thread manager, controlling worker threads. It must be called with
376 * finish_mutex lock held, but it will unlock it itself before exiting;
377 * this is necessary to be completely deadlock-free. */
378 /* The finish_cond can be signalled for it to stop; in that case,
379 * the caller should set finish_thread = -1. */
380 /* After it is started, it will update mctx->t to point at some tree
381 * used for the actual search (matters only for TM_ROOT), on return
382 * it will set mctx->games to the number of performed simulations. */
383 static void *
384 spawn_thread_manager(void *ctx_)
386 /* In thread_manager, we use only some of the ctx fields. */
387 struct spawn_ctx *mctx = ctx_;
388 struct uct *u = mctx->u;
389 struct tree *t = mctx->t;
390 bool shared_tree = u->parallel_tree;
391 fast_srandom(mctx->seed);
393 int played_games = 0;
394 pthread_t threads[u->threads];
395 int joined = 0;
397 uct_halt = 0;
399 /* Garbage collect the tree by preference when pondering. */
400 if (u->pondering && t->nodes && t->nodes_size > t->max_tree_size/2) {
401 unsigned long temp_size = (MIN_FREE_MEM_PERCENT * t->max_tree_size) / 100;
402 t->root = tree_garbage_collect(t, temp_size, t->root);
405 /* Spawn threads... */
406 for (int ti = 0; ti < u->threads; ti++) {
407 struct spawn_ctx *ctx = malloc(sizeof(*ctx));
408 ctx->u = u; ctx->b = mctx->b; ctx->color = mctx->color;
409 mctx->t = ctx->t = shared_tree ? t : tree_copy(t);
410 ctx->tid = ti; ctx->seed = fast_random(65536) + ti;
411 pthread_create(&threads[ti], NULL, spawn_worker, ctx);
412 if (UDEBUGL(3))
413 fprintf(stderr, "Spawned worker %d\n", ti);
416 /* ...and collect them back: */
417 while (joined < u->threads) {
418 /* Wait for some thread to finish... */
419 pthread_cond_wait(&finish_cond, &finish_mutex);
420 if (finish_thread < 0) {
421 /* Stop-by-caller. Tell the workers to wrap up. */
422 uct_halt = 1;
423 continue;
425 /* ...and gather its remnants. */
426 struct spawn_ctx *ctx;
427 pthread_join(threads[finish_thread], (void **) &ctx);
428 played_games += ctx->games;
429 joined++;
430 if (!shared_tree) {
431 if (ctx->t == mctx->t) mctx->t = t;
432 tree_merge(t, ctx->t);
433 tree_done(ctx->t);
435 free(ctx);
436 if (UDEBUGL(3))
437 fprintf(stderr, "Joined worker %d\n", finish_thread);
438 pthread_mutex_unlock(&finish_serializer);
441 pthread_mutex_unlock(&finish_mutex);
443 if (!shared_tree)
444 tree_normalize(mctx->t, u->threads);
446 mctx->games = played_games;
447 return mctx;
450 static struct spawn_ctx *
451 uct_search_start(struct uct *u, struct board *b, enum stone color, struct tree *t)
453 assert(u->threads > 0);
454 assert(!thread_manager_running);
456 struct spawn_ctx ctx = { .u = u, .b = b, .color = color, .t = t, .seed = fast_random(65536) };
457 static struct spawn_ctx mctx; mctx = ctx;
458 pthread_mutex_lock(&finish_mutex);
459 pthread_create(&thread_manager, NULL, spawn_thread_manager, &mctx);
460 thread_manager_running = true;
461 return &mctx;
464 static struct spawn_ctx *
465 uct_search_stop(void)
467 assert(thread_manager_running);
469 /* Signal thread manager to stop the workers. */
470 pthread_mutex_lock(&finish_mutex);
471 finish_thread = -1;
472 pthread_cond_signal(&finish_cond);
473 pthread_mutex_unlock(&finish_mutex);
475 /* Collect the thread manager. */
476 struct spawn_ctx *pctx;
477 thread_manager_running = false;
478 pthread_join(thread_manager, (void **) &pctx);
479 return pctx;
483 /* Determine whether we should terminate the search early. */
484 static bool
485 uct_search_stop_early(struct uct *u, struct tree *t, struct board *b,
486 struct time_info *ti, struct time_stop *stop,
487 struct tree_node *best, struct tree_node *best2,
488 int base_playouts, int i)
490 /* Always use at least half the desired time. It is silly
491 * to lose a won game because we played a bad move in 0.1s. */
492 double elapsed = 0;
493 if (ti->dim == TD_WALLTIME) {
494 elapsed = time_now() - ti->len.t.timer_start;
495 if (elapsed < 0.5 * stop->desired.time) return false;
498 /* Early break in won situation. */
499 if (best->u.playouts >= 2000 && tree_node_get_value(t, 1, best->u.value) >= u->loss_threshold)
500 return true;
501 /* Earlier break in super-won situation. */
502 if (best->u.playouts >= 500 && tree_node_get_value(t, 1, best->u.value) >= 0.95)
503 return true;
505 /* Break early if we estimate the second-best move cannot
506 * catch up in assigned time anymore. We use all our time
507 * if we are in byoyomi with single stone remaining in our
508 * period, however - it's better to pre-ponder. */
509 bool time_indulgent = (!ti->len.t.main_time && ti->len.t.byoyomi_stones == 1);
510 if (best2 && ti->dim == TD_WALLTIME && !time_indulgent) {
511 double remaining = stop->worst.time - elapsed;
512 double pps = ((double)i - base_playouts) / elapsed;
513 double estplayouts = remaining * pps + PLAYOUT_DELTA_SAFEMARGIN;
514 if (best->u.playouts > best2->u.playouts + estplayouts) {
515 if (UDEBUGL(2))
516 fprintf(stderr, "Early stop, result cannot change: "
517 "best %d, best2 %d, estimated %f simulations to go\n",
518 best->u.playouts, best2->u.playouts, estplayouts);
519 return true;
523 return false;
526 /* Determine whether we should terminate the search later than expected. */
527 static bool
528 uct_search_keep_looking(struct uct *u, struct tree *t, struct board *b,
529 struct time_info *ti, struct time_stop *stop,
530 struct tree_node *best, struct tree_node *best2,
531 struct tree_node *bestr, struct tree_node *winner, int i)
533 if (!best) {
534 if (UDEBUGL(2))
535 fprintf(stderr, "Did not find best move, still trying...\n");
536 return true;
539 /* Do not waste time if we are winning. Spend up to worst time if
540 * we are unsure, but only desired time if we are sure of winning. */
541 float beta = 2 * (tree_node_get_value(t, 1, best->u.value) - 0.5);
542 if (ti->dim == TD_WALLTIME && beta > 0) {
543 double good_enough = stop->desired.time * beta + stop->worst.time * (1 - beta);
544 double elapsed = time_now() - ti->len.t.timer_start;
545 if (elapsed > good_enough) return false;
548 if (u->best2_ratio > 0) {
549 /* Check best/best2 simulations ratio. If the
550 * two best moves give very similar results,
551 * keep simulating. */
552 if (best2 && best2->u.playouts
553 && (double)best->u.playouts / best2->u.playouts < u->best2_ratio) {
554 if (UDEBUGL(2))
555 fprintf(stderr, "Best2 ratio %f < threshold %f\n",
556 (double)best->u.playouts / best2->u.playouts,
557 u->best2_ratio);
558 return true;
562 if (u->bestr_ratio > 0) {
563 /* Check best, best_best value difference. If the best move
564 * and its best child do not give similar enough results,
565 * keep simulating. */
566 if (bestr && bestr->u.playouts
567 && fabs((double)best->u.value - bestr->u.value) > u->bestr_ratio) {
568 if (UDEBUGL(2))
569 fprintf(stderr, "Bestr delta %f > threshold %f\n",
570 fabs((double)best->u.value - bestr->u.value),
571 u->bestr_ratio);
572 return true;
576 if (winner && winner != best) {
577 /* Keep simulating if best explored
578 * does not have also highest value. */
579 if (UDEBUGL(2))
580 fprintf(stderr, "[%d] best %3s [%d] %f != winner %3s [%d] %f\n", i,
581 coord2sstr(best->coord, t->board),
582 best->u.playouts, tree_node_get_value(t, 1, best->u.value),
583 coord2sstr(winner->coord, t->board),
584 winner->u.playouts, tree_node_get_value(t, 1, winner->u.value));
585 return true;
588 /* No reason to keep simulating, bye. */
589 return false;
592 /* Run time-limited MCTS search on foreground. */
593 static int
594 uct_search(struct uct *u, struct board *b, struct time_info *ti, enum stone color, struct tree *t)
596 int base_playouts = u->t->root->u.playouts;
597 if (UDEBUGL(2) && base_playouts > 0)
598 fprintf(stderr, "<pre-simulated %d games skipped>\n", base_playouts);
600 /* Set up time conditions. */
601 if (ti->period == TT_NULL) *ti = default_ti;
602 struct time_stop stop;
603 time_stop_conditions(ti, b, u->fuseki_end, u->yose_start, &stop);
605 /* Number of last dynkomi adjustment. */
606 int last_dynkomi = t->root->u.playouts;
607 /* Number of last game with progress print. */
608 int last_print = t->root->u.playouts;
609 /* Number of simulations to wait before next print. */
610 int print_interval = TREE_SIMPROGRESS_INTERVAL * (u->thread_model == TM_ROOT ? 1 : u->threads);
611 /* Printed notification about full memory? */
612 bool print_fullmem = false;
613 /* Absolute time of last distributed stats update. */
614 double last_stats_sent = time_now();
615 /* Interval between distributed stats updates. */
616 double stats_interval = STATS_SEND_INTERVAL;
618 struct spawn_ctx *ctx = uct_search_start(u, b, color, t);
620 /* The search tree is ctx->t. This is normally == t, but in case of
621 * TM_ROOT, it is one of the trees belonging to the independent
622 * workers. It is important to reference ctx->t directly since the
623 * thread manager will swap the tree pointer asynchronously. */
624 /* XXX: This means TM_ROOT support is suboptimal since single stalled
625 * thread can stall the others in case of limiting the search by game
626 * count. However, TM_ROOT just does not deserve any more extra code
627 * right now. */
629 struct tree_node *best = NULL;
630 struct tree_node *best2 = NULL; // Second-best move.
631 struct tree_node *bestr = NULL; // best's best child.
632 struct tree_node *winner = NULL;
634 double busywait_interval = TREE_BUSYWAIT_INTERVAL;
636 /* Now, just periodically poll the search tree. */
637 while (1) {
638 time_sleep(busywait_interval);
639 /* busywait_interval should never be less than desired time, or the
640 * time control is broken. But if it happens to be less, we still search
641 * at least 100ms otherwise the move is completely random. */
643 int i = ctx->t->root->u.playouts;
645 /* Adjust dynkomi? */
646 if (ctx->t->use_extra_komi && u->dynkomi->permove
647 && u->dynkomi_interval
648 && i > last_dynkomi + u->dynkomi_interval) {
649 last_dynkomi += u->dynkomi_interval;
650 float old_dynkomi = ctx->t->extra_komi;
651 ctx->t->extra_komi = u->dynkomi->permove(u->dynkomi, b, ctx->t);
652 if (UDEBUGL(3) && old_dynkomi != ctx->t->extra_komi)
653 fprintf(stderr, "dynkomi adjusted (%f -> %f)\n", old_dynkomi, ctx->t->extra_komi);
656 /* Print progress? */
657 if (i - last_print > print_interval) {
658 last_print += print_interval; // keep the numbers tidy
659 uct_progress_status(u, ctx->t, color, last_print);
661 if (!print_fullmem && ctx->t->nodes_size > u->max_tree_size) {
662 if (UDEBUGL(2))
663 fprintf(stderr, "memory limit hit (%lu > %lu)\n", ctx->t->nodes_size, u->max_tree_size);
664 print_fullmem = true;
667 /* Never consider stopping if we played too few simulations.
668 * Maybe we risk losing on time when playing in super-extreme
669 * time pressure but the tree is going to be just too messed
670 * up otherwise - we might even play invalid suicides or pass
671 * when we mustn't. */
672 if (i < GJ_MINGAMES)
673 continue;
675 best = u->policy->choose(u->policy, ctx->t->root, b, color, resign);
676 if (best) best2 = u->policy->choose(u->policy, ctx->t->root, b, color, best->coord);
678 /* Possibly stop search early if it's no use to try on. */
679 if (best && uct_search_stop_early(u, ctx->t, b, ti, &stop, best, best2, base_playouts, i))
680 break;
682 /* Check against time settings. */
683 bool desired_done = false;
684 double now = time_now();
685 if (ti->dim == TD_WALLTIME) {
686 double elapsed = now - ti->len.t.timer_start;
687 if (elapsed > stop.worst.time) break;
688 desired_done = elapsed > stop.desired.time;
689 if (stats_interval < 0.1 * stop.desired.time)
690 stats_interval = 0.1 * stop.desired.time;
692 } else { assert(ti->dim == TD_GAMES);
693 if (i > stop.worst.playouts) break;
694 desired_done = i > stop.desired.playouts;
697 /* We want to stop simulating, but are willing to keep trying
698 * if we aren't completely sure about the winner yet. */
699 if (desired_done) {
700 if (u->policy->winner && u->policy->evaluate) {
701 struct uct_descent descent = { .node = ctx->t->root };
702 u->policy->winner(u->policy, ctx->t, &descent);
703 winner = descent.node;
705 if (best)
706 bestr = u->policy->choose(u->policy, best, b, stone_other(color), resign);
707 if (!uct_search_keep_looking(u, ctx->t, b, ti, &stop, best, best2, bestr, winner, i))
708 break;
711 /* TODO: Early break if best->variance goes under threshold and we already
712 * have enough playouts (possibly thanks to book or to pondering)? */
714 /* Send new stats for the distributed engine.
715 * End with #\n (not \n\n) to indicate a temporary result. */
716 if (u->slave && now - last_stats_sent > stats_interval) {
717 printf("=%d %s\n#\n", u->gtp_id, uct_getstats(u, b, NULL));
718 fflush(stdout);
719 last_stats_sent = now;
723 ctx = uct_search_stop();
725 if (UDEBUGL(2)) {
726 fprintf(stderr, "(avg score %f/%d value %f/%d)\n",
727 u->dynkomi->score.value, u->dynkomi->score.playouts,
728 u->dynkomi->value.value, u->dynkomi->value.playouts);
729 tree_dump(t, u->dumpthres);
731 if (UDEBUGL(0))
732 uct_progress_status(u, t, color, ctx->games);
734 return ctx->games;
738 /* Start pondering background with @color to play. */
739 static void
740 uct_pondering_start(struct uct *u, struct board *b0, struct tree *t, enum stone color)
742 if (UDEBUGL(1))
743 fprintf(stderr, "Starting to ponder with color %s\n", stone2str(stone_other(color)));
744 u->pondering = true;
746 /* We need a local board copy to ponder upon. */
747 struct board *b = malloc(sizeof(*b)); board_copy(b, b0);
749 /* *b0 did not have the genmove'd move played yet. */
750 struct move m = { t->root->coord, t->root_color };
751 int res = board_play(b, &m);
752 assert(res >= 0);
753 setup_dynkomi(u, b, stone_other(m.color));
755 /* Start MCTS manager thread "headless". */
756 uct_search_start(u, b, color, t);
759 /* uct_search_stop() frontend for the pondering (non-genmove) mode. */
760 static void
761 uct_pondering_stop(struct uct *u)
763 u->pondering = false;
764 if (!thread_manager_running)
765 return;
767 /* Stop the thread manager. */
768 struct spawn_ctx *ctx = uct_search_stop();
769 if (UDEBUGL(1)) {
770 fprintf(stderr, "(pondering) ");
771 uct_progress_status(u, ctx->t, ctx->color, ctx->games);
773 free(ctx->b);
777 static coord_t *
778 uct_genmove(struct engine *e, struct board *b, struct time_info *ti, enum stone color, bool pass_all_alive)
780 double start_time = time_now();
781 struct uct *u = e->data;
783 if (b->superko_violation) {
784 fprintf(stderr, "!!! WARNING: SUPERKO VIOLATION OCCURED BEFORE THIS MOVE\n");
785 fprintf(stderr, "Maybe you play with situational instead of positional superko?\n");
786 fprintf(stderr, "I'm going to ignore the violation, but note that I may miss\n");
787 fprintf(stderr, "some moves valid under this ruleset because of this.\n");
788 b->superko_violation = false;
791 /* Seed the tree. */
792 uct_pondering_stop(u);
793 prepare_move(e, b, color);
794 assert(u->t);
795 u->my_color = color;
797 /* How to decide whether to use dynkomi in this game? Since we use
798 * pondering, it's not simple "who-to-play" matter. Decide based on
799 * the last genmove issued. */
800 u->t->use_extra_komi = !!(u->dynkomi_mask & color);
801 setup_dynkomi(u, b, color);
803 if (b->rules == RULES_JAPANESE)
804 u->territory_scoring = true;
806 /* Make pessimistic assumption about komi for Japanese rules to
807 * avoid losing by 0.5 when winning by 0.5 with Chinese rules.
808 * The rules usually give the same winner if the integer part of komi
809 * is odd so we adjust the komi only if it is even (for a board of
810 * odd size). We are not trying to get an exact evaluation for rare
811 * cases of seki. For details see http://home.snafu.de/jasiek/parity.html */
812 if (u->territory_scoring && (((int)floor(b->komi) + board_size(b)) & 1)) {
813 b->komi += (color == S_BLACK ? 1.0 : -1.0);
814 if (UDEBUGL(0))
815 fprintf(stderr, "Setting komi to %.1f assuming Japanese rules\n",
816 b->komi);
819 int base_playouts = u->t->root->u.playouts;
820 /* Perform the Monte Carlo Tree Search! */
821 int played_games = uct_search(u, b, ti, color, u->t);
823 /* Choose the best move from the tree. */
824 struct tree_node *best = u->policy->choose(u->policy, u->t->root, b, color, resign);
825 if (!best) {
826 if (!u->slave) reset_state(u);
827 return coord_copy(pass);
829 if (UDEBUGL(1))
830 fprintf(stderr, "*** WINNER is %s (%d,%d) with score %1.4f (%d/%d:%d/%d games), extra komi %f\n",
831 coord2sstr(best->coord, b), coord_x(best->coord, b), coord_y(best->coord, b),
832 tree_node_get_value(u->t, 1, best->u.value), best->u.playouts,
833 u->t->root->u.playouts, u->t->root->u.playouts - base_playouts, played_games,
834 u->t->extra_komi);
836 /* Do not resign if we're so short of time that evaluation of best
837 * move is completely unreliable, we might be winning actually.
838 * In this case best is almost random but still better than resign.
839 * Also do not resign if we are getting bad results while actually
840 * giving away extra komi points (dynkomi). */
841 if (tree_node_get_value(u->t, 1, best->u.value) < u->resign_ratio
842 && !is_pass(best->coord) && best->u.playouts > GJ_MINGAMES
843 && u->t->extra_komi <= 1 /* XXX we assume dynamic komi == we are black */) {
844 if (!u->slave) reset_state(u);
845 return coord_copy(resign);
848 /* If the opponent just passed and we win counting, always
849 * pass as well. */
850 if (b->moves > 1 && is_pass(b->last_move.coord)) {
851 /* Make sure enough playouts are simulated. */
852 while (u->ownermap.playouts < GJ_MINGAMES)
853 uct_playout(u, b, color, u->t);
854 if (uct_pass_is_safe(u, b, color, u->pass_all_alive || pass_all_alive)) {
855 if (UDEBUGL(0))
856 fprintf(stderr, "<Will rather pass, looks safe enough; score %f>\n",
857 board_official_score(b, NULL) / 2);
858 best->coord = pass;
862 /* If we are a slave in the distributed engine, we'll soon get
863 * a "play" command later telling us which move was chosen,
864 * and pondering now will not gain much. */
865 if (!u->slave) {
866 tree_promote_node(u->t, &best);
868 /* After a pass, pondering is harmful for two reasons:
869 * (i) We might keep pondering even when the game is over.
870 * Of course this is the case for opponent resign as well.
871 * (ii) More importantly, the ownermap will get skewed since
872 * the UCT will start cutting off any playouts. */
873 if (u->pondering_opt && !is_pass(best->coord)) {
874 uct_pondering_start(u, b, u->t, stone_other(color));
877 if (UDEBUGL(2)) {
878 double time = time_now() - start_time + 0.000001; /* avoid divide by zero */
879 fprintf(stderr, "genmove in %0.2fs (%d games/s, %d games/s/thread)\n",
880 time, (int)(played_games/time), (int)(played_games/time/u->threads));
882 return coord_copy(best->coord);
885 /* Get stats updates for the distributed engine. Return a buffer
886 * with one line "total_playouts threads" then a list of lines
887 * "coord playouts value". The last line must not end with \n.
888 * If c is not null, add this move with root->playouts weight.
889 * This function is called only by the main thread, but may be
890 * called while the tree is updated by the worker threads.
891 * Keep this code in sync with select_best_move(). */
892 static char *
893 uct_getstats(struct uct *u, struct board *b, coord_t *c)
895 static char reply[10240];
896 char *r = reply;
897 char *end = reply + sizeof(reply);
898 struct tree_node *root = u->t->root;
899 r += snprintf(r, end - r, "%d %d", root->u.playouts, u->threads);
900 int min_playouts = root->u.playouts / 100;
902 // Give a large weight to pass or resign, but still allow other moves.
903 if (c)
904 r += snprintf(r, end - r, "\n%s %d %.1f", coord2sstr(*c, b), root->u.playouts,
905 (float)is_pass(*c));
907 /* We rely on the fact that root->children is set only
908 * after all children are created. */
909 for (struct tree_node *ni = root->children; ni; ni = ni->sibling) {
910 if (ni->u.playouts <= min_playouts
911 || ni->hints & TREE_HINT_INVALID
912 || is_pass(ni->coord))
913 continue;
914 char *coord = coord2sstr(ni->coord, b);
915 // We return the values as stored in the tree, so from black's view.
916 r += snprintf(r, end - r, "\n%s %d %.7f", coord, ni->u.playouts, ni->u.value);
918 return reply;
921 static char *
922 uct_genmoves(struct engine *e, struct board *b, struct time_info *ti, enum stone color, bool pass_all_alive)
924 struct uct *u = e->data;
925 assert(u->slave);
927 coord_t *c = uct_genmove(e, b, ti, color, pass_all_alive);
929 char *reply = uct_getstats(u, b, is_pass(*c) || is_resign(*c) ? c : NULL);
930 coord_done(c);
931 return reply;
935 bool
936 uct_genbook(struct engine *e, struct board *b, struct time_info *ti, enum stone color)
938 struct uct *u = e->data;
939 if (!u->t) prepare_move(e, b, color);
940 assert(u->t);
942 if (ti->dim == TD_GAMES) {
943 /* Don't count in games that already went into the book. */
944 ti->len.games += u->t->root->u.playouts;
946 uct_search(u, b, ti, color, u->t);
948 assert(ti->dim == TD_GAMES);
949 tree_save(u->t, b, ti->len.games / 100);
951 return true;
954 void
955 uct_dumpbook(struct engine *e, struct board *b, enum stone color)
957 struct uct *u = e->data;
958 struct tree *t = tree_init(b, color, u->fast_alloc ? u->max_tree_size : 0, u->local_tree_aging);
959 tree_load(t, b);
960 tree_dump(t, 0);
961 tree_done(t);
965 struct uct *
966 uct_state_init(char *arg, struct board *b)
968 struct uct *u = calloc(1, sizeof(struct uct));
969 bool using_elo = false;
971 u->debug_level = debug_level;
972 u->gamelen = MC_GAMELEN;
973 u->mercymin = 0;
974 u->expand_p = 2;
975 u->dumpthres = 1000;
976 u->playout_amaf = true;
977 u->playout_amaf_nakade = false;
978 u->amaf_prior = false;
979 u->max_tree_size = 3072ULL * 1048576;
981 u->dynkomi_mask = S_BLACK;
983 u->threads = 1;
984 u->thread_model = TM_TREEVL;
985 u->parallel_tree = true;
986 u->virtual_loss = true;
988 u->fuseki_end = 20; // max time at 361*20% = 72 moves (our 36th move, still 99 to play)
989 u->yose_start = 40; // (100-40-25)*361/100/2 = 63 moves still to play by us then
990 u->bestr_ratio = 0.02;
991 // 2.5 is clearly too much, but seems to compensate well for overly stern time allocations.
992 // TODO: Further tuning and experiments with better time allocation schemes.
993 u->best2_ratio = 2.5;
995 u->val_scale = 0.04; u->val_points = 40;
997 u->tenuki_d = 4;
998 u->local_tree_aging = 2;
1000 if (arg) {
1001 char *optspec, *next = arg;
1002 while (*next) {
1003 optspec = next;
1004 next += strcspn(next, ",");
1005 if (*next) { *next++ = 0; } else { *next = 0; }
1007 char *optname = optspec;
1008 char *optval = strchr(optspec, '=');
1009 if (optval) *optval++ = 0;
1011 if (!strcasecmp(optname, "debug")) {
1012 if (optval)
1013 u->debug_level = atoi(optval);
1014 else
1015 u->debug_level++;
1016 } else if (!strcasecmp(optname, "mercy") && optval) {
1017 /* Minimal difference of black/white captures
1018 * to stop playout - "Mercy Rule". Speeds up
1019 * hopeless playouts at the expense of some
1020 * accuracy. */
1021 u->mercymin = atoi(optval);
1022 } else if (!strcasecmp(optname, "gamelen") && optval) {
1023 u->gamelen = atoi(optval);
1024 } else if (!strcasecmp(optname, "expand_p") && optval) {
1025 u->expand_p = atoi(optval);
1026 } else if (!strcasecmp(optname, "dumpthres") && optval) {
1027 u->dumpthres = atoi(optval);
1028 } else if (!strcasecmp(optname, "best2_ratio") && optval) {
1029 /* If set, prolong simulating while
1030 * first_best/second_best playouts ratio
1031 * is less than best2_ratio. */
1032 u->best2_ratio = atof(optval);
1033 } else if (!strcasecmp(optname, "bestr_ratio") && optval) {
1034 /* If set, prolong simulating while
1035 * best,best_best_child values delta
1036 * is more than bestr_ratio. */
1037 u->bestr_ratio = atof(optval);
1038 } else if (!strcasecmp(optname, "playout_amaf")) {
1039 /* Whether to include random playout moves in
1040 * AMAF as well. (Otherwise, only tree moves
1041 * are included in AMAF. Of course makes sense
1042 * only in connection with an AMAF policy.) */
1043 /* with-without: 55.5% (+-4.1) */
1044 if (optval && *optval == '0')
1045 u->playout_amaf = false;
1046 else
1047 u->playout_amaf = true;
1048 } else if (!strcasecmp(optname, "playout_amaf_nakade")) {
1049 /* Whether to include nakade moves from playouts
1050 * in the AMAF statistics; this tends to nullify
1051 * the playout_amaf effect by adding too much
1052 * noise. */
1053 if (optval && *optval == '0')
1054 u->playout_amaf_nakade = false;
1055 else
1056 u->playout_amaf_nakade = true;
1057 } else if (!strcasecmp(optname, "playout_amaf_cutoff") && optval) {
1058 /* Keep only first N% of playout stage AMAF
1059 * information. */
1060 u->playout_amaf_cutoff = atoi(optval);
1061 } else if ((!strcasecmp(optname, "policy") || !strcasecmp(optname, "random_policy")) && optval) {
1062 char *policyarg = strchr(optval, ':');
1063 struct uct_policy **p = !strcasecmp(optname, "policy") ? &u->policy : &u->random_policy;
1064 if (policyarg)
1065 *policyarg++ = 0;
1066 if (!strcasecmp(optval, "ucb1")) {
1067 *p = policy_ucb1_init(u, policyarg);
1068 } else if (!strcasecmp(optval, "ucb1amaf")) {
1069 *p = policy_ucb1amaf_init(u, policyarg);
1070 } else {
1071 fprintf(stderr, "UCT: Invalid tree policy %s\n", optval);
1072 exit(1);
1074 } else if (!strcasecmp(optname, "playout") && optval) {
1075 char *playoutarg = strchr(optval, ':');
1076 if (playoutarg)
1077 *playoutarg++ = 0;
1078 if (!strcasecmp(optval, "moggy")) {
1079 u->playout = playout_moggy_init(playoutarg, b);
1080 } else if (!strcasecmp(optval, "light")) {
1081 u->playout = playout_light_init(playoutarg, b);
1082 } else if (!strcasecmp(optval, "elo")) {
1083 u->playout = playout_elo_init(playoutarg, b);
1084 using_elo = true;
1085 } else {
1086 fprintf(stderr, "UCT: Invalid playout policy %s\n", optval);
1087 exit(1);
1089 } else if (!strcasecmp(optname, "prior") && optval) {
1090 u->prior = uct_prior_init(optval, b);
1091 } else if (!strcasecmp(optname, "amaf_prior") && optval) {
1092 u->amaf_prior = atoi(optval);
1093 } else if (!strcasecmp(optname, "threads") && optval) {
1094 /* By default, Pachi will run with only single
1095 * tree search thread! */
1096 u->threads = atoi(optval);
1097 } else if (!strcasecmp(optname, "thread_model") && optval) {
1098 if (!strcasecmp(optval, "root")) {
1099 /* Root parallelization - each thread
1100 * does independent search, trees are
1101 * merged at the end. */
1102 u->thread_model = TM_ROOT;
1103 u->parallel_tree = false;
1104 u->virtual_loss = false;
1105 } else if (!strcasecmp(optval, "tree")) {
1106 /* Tree parallelization - all threads
1107 * grind on the same tree. */
1108 u->thread_model = TM_TREE;
1109 u->parallel_tree = true;
1110 u->virtual_loss = false;
1111 } else if (!strcasecmp(optval, "treevl")) {
1112 /* Tree parallelization, but also
1113 * with virtual losses - this discou-
1114 * rages most threads choosing the
1115 * same tree branches to read. */
1116 u->thread_model = TM_TREEVL;
1117 u->parallel_tree = true;
1118 u->virtual_loss = true;
1119 } else {
1120 fprintf(stderr, "UCT: Invalid thread model %s\n", optval);
1121 exit(1);
1123 } else if (!strcasecmp(optname, "pondering")) {
1124 /* Keep searching even during opponent's turn. */
1125 u->pondering_opt = !optval || atoi(optval);
1126 } else if (!strcasecmp(optname, "fuseki_end") && optval) {
1127 /* At the very beginning it's not worth thinking
1128 * too long because the playout evaluations are
1129 * very noisy. So gradually increase the thinking
1130 * time up to maximum when fuseki_end percent
1131 * of the board has been played.
1132 * This only applies if we are not in byoyomi. */
1133 u->fuseki_end = atoi(optval);
1134 } else if (!strcasecmp(optname, "yose_start") && optval) {
1135 /* When yose_start percent of the board has been
1136 * played, or if we are in byoyomi, stop spending
1137 * more time and spread the remaining time
1138 * uniformly.
1139 * Between fuseki_end and yose_start, we spend
1140 * a constant proportion of the remaining time
1141 * on each move. (yose_start should actually
1142 * be much earlier than when real yose start,
1143 * but "yose" is a good short name to convey
1144 * the idea.) */
1145 u->yose_start = atoi(optval);
1146 } else if (!strcasecmp(optname, "force_seed") && optval) {
1147 u->force_seed = atoi(optval);
1148 } else if (!strcasecmp(optname, "no_book")) {
1149 u->no_book = true;
1150 } else if (!strcasecmp(optname, "dynkomi") && optval) {
1151 /* Dynamic komi approach; there are multiple
1152 * ways to adjust komi dynamically throughout
1153 * play. We currently support two: */
1154 char *dynkomiarg = strchr(optval, ':');
1155 if (dynkomiarg)
1156 *dynkomiarg++ = 0;
1157 if (!strcasecmp(optval, "none")) {
1158 u->dynkomi = uct_dynkomi_init_none(u, dynkomiarg, b);
1159 } else if (!strcasecmp(optval, "linear")) {
1160 u->dynkomi = uct_dynkomi_init_linear(u, dynkomiarg, b);
1161 } else if (!strcasecmp(optval, "adaptive")) {
1162 u->dynkomi = uct_dynkomi_init_adaptive(u, dynkomiarg, b);
1163 } else {
1164 fprintf(stderr, "UCT: Invalid dynkomi mode %s\n", optval);
1165 exit(1);
1167 } else if (!strcasecmp(optname, "dynkomi_mask") && optval) {
1168 /* Bitmask of colors the player must be
1169 * for dynkomi be applied; you may want
1170 * to use dynkomi_mask=3 to allow dynkomi
1171 * even in games where Pachi is white. */
1172 u->dynkomi_mask = atoi(optval);
1173 } else if (!strcasecmp(optname, "dynkomi_interval") && optval) {
1174 /* If non-zero, re-adjust dynamic komi
1175 * throughout a single genmove reading,
1176 * roughly every N simulations. */
1177 /* XXX: Does not work with tree
1178 * parallelization. */
1179 u->dynkomi_interval = atoi(optval);
1180 } else if (!strcasecmp(optname, "val_scale") && optval) {
1181 /* How much of the game result value should be
1182 * influenced by win size. Zero means it isn't. */
1183 u->val_scale = atof(optval);
1184 } else if (!strcasecmp(optname, "val_points") && optval) {
1185 /* Maximum size of win to be scaled into game
1186 * result value. Zero means boardsize^2. */
1187 u->val_points = atoi(optval) * 2; // result values are doubled
1188 } else if (!strcasecmp(optname, "val_extra")) {
1189 /* If false, the score coefficient will be simply
1190 * added to the value, instead of scaling the result
1191 * coefficient because of it. */
1192 u->val_extra = !optval || atoi(optval);
1193 } else if (!strcasecmp(optname, "local_tree") && optval) {
1194 /* Whether to bias exploration by local tree values
1195 * (must be supported by the used policy).
1196 * 0: Don't.
1197 * 1: Do, value = result.
1198 * Try to temper the result:
1199 * 2: Do, value = 0.5+(result-expected)/2.
1200 * 3: Do, value = 0.5+bzz((result-expected)^2).
1201 * 4: Do, value = 0.5+sqrt(result-expected)/2. */
1202 u->local_tree = atoi(optval);
1203 } else if (!strcasecmp(optname, "tenuki_d") && optval) {
1204 /* Tenuki distance at which to break the local tree. */
1205 u->tenuki_d = atoi(optval);
1206 if (u->tenuki_d > TREE_NODE_D_MAX + 1) {
1207 fprintf(stderr, "uct: tenuki_d must not be larger than TREE_NODE_D_MAX+1 %d\n", TREE_NODE_D_MAX + 1);
1208 exit(1);
1210 } else if (!strcasecmp(optname, "local_tree_aging") && optval) {
1211 /* How much to reduce local tree values between moves. */
1212 u->local_tree_aging = atof(optval);
1213 } else if (!strcasecmp(optname, "local_tree_allseq")) {
1214 /* By default, only complete sequences are stored
1215 * in the local tree. If this is on, also
1216 * subsequences starting at each move are stored. */
1217 u->local_tree_allseq = !optval || atoi(optval);
1218 } else if (!strcasecmp(optname, "local_tree_playout")) {
1219 /* Whether to adjust ELO playout probability
1220 * distributions according to matched localtree
1221 * information. */
1222 u->local_tree_playout = !optval || atoi(optval);
1223 } else if (!strcasecmp(optname, "local_tree_pseqroot")) {
1224 /* By default, when we have no sequence move
1225 * to suggest in-playout, we give up. If this
1226 * is on, we make probability distribution from
1227 * sequences first moves instead. */
1228 u->local_tree_pseqroot = !optval || atoi(optval);
1229 } else if (!strcasecmp(optname, "pass_all_alive")) {
1230 /* Whether to consider all stones alive at the game
1231 * end instead of marking dead groupd. */
1232 u->pass_all_alive = !optval || atoi(optval);
1233 } else if (!strcasecmp(optname, "territory_scoring")) {
1234 /* Use territory scoring (default is area scoring).
1235 * An explicit kgs-rules command overrides this. */
1236 u->territory_scoring = !optval || atoi(optval);
1237 } else if (!strcasecmp(optname, "random_policy_chance") && optval) {
1238 /* If specified (N), with probability 1/N, random_policy policy
1239 * descend is used instead of main policy descend; useful
1240 * if specified policy (e.g. UCB1AMAF) can make unduly biased
1241 * choices sometimes, you can fall back to e.g.
1242 * random_policy=UCB1. */
1243 u->random_policy_chance = atoi(optval);
1244 } else if (!strcasecmp(optname, "max_tree_size") && optval) {
1245 /* Maximum amount of memory [MiB] consumed by the move tree.
1246 * For fast_alloc it includes the temp tree used for pruning.
1247 * Default is 3072 (3 GiB). Note that if you use TM_ROOT,
1248 * this limits size of only one of the trees, not all of them
1249 * together. */
1250 u->max_tree_size = atol(optval) * 1048576;
1251 } else if (!strcasecmp(optname, "fast_alloc")) {
1252 u->fast_alloc = !optval || atoi(optval);
1253 } else if (!strcasecmp(optname, "slave")) {
1254 /* Act as slave for the distributed engine. */
1255 u->slave = !optval || atoi(optval);
1256 } else if (!strcasecmp(optname, "banner") && optval) {
1257 /* Additional banner string. This must come as the
1258 * last engine parameter. */
1259 if (*next) *--next = ',';
1260 u->banner = strdup(optval);
1261 break;
1262 } else {
1263 fprintf(stderr, "uct: Invalid engine argument %s or missing value\n", optname);
1264 exit(1);
1269 u->resign_ratio = 0.2; /* Resign when most games are lost. */
1270 u->loss_threshold = 0.85; /* Stop reading if after at least 2000 playouts this is best value. */
1271 if (!u->policy)
1272 u->policy = policy_ucb1amaf_init(u, NULL);
1274 if (!!u->random_policy_chance ^ !!u->random_policy) {
1275 fprintf(stderr, "uct: Only one of random_policy and random_policy_chance is set\n");
1276 exit(1);
1279 if (!u->local_tree) {
1280 /* No ltree aging. */
1281 u->local_tree_aging = 1.0f;
1283 if (!using_elo)
1284 u->local_tree_playout = false;
1286 if (u->fast_alloc && !u->parallel_tree) {
1287 fprintf(stderr, "fast_alloc not supported with root parallelization.\n");
1288 exit(1);
1290 if (u->fast_alloc)
1291 u->max_tree_size = (100ULL * u->max_tree_size) / (100 + MIN_FREE_MEM_PERCENT);
1293 if (!u->prior)
1294 u->prior = uct_prior_init(NULL, b);
1296 if (!u->playout)
1297 u->playout = playout_moggy_init(NULL, b);
1298 u->playout->debug_level = u->debug_level;
1300 u->ownermap.map = malloc(board_size2(b) * sizeof(u->ownermap.map[0]));
1302 if (!u->dynkomi)
1303 u->dynkomi = uct_dynkomi_init_linear(u, NULL, b);
1305 /* Some things remain uninitialized for now - the opening book
1306 * is not loaded and the tree not set up. */
1307 /* This will be initialized in setup_state() at the first move
1308 * received/requested. This is because right now we are not aware
1309 * about any komi or handicap setup and such. */
1311 return u;
1314 struct engine *
1315 engine_uct_init(char *arg, struct board *b)
1317 struct uct *u = uct_state_init(arg, b);
1318 struct engine *e = calloc(1, sizeof(struct engine));
1319 e->name = "UCT Engine";
1320 e->printhook = uct_printhook_ownermap;
1321 e->notify_play = uct_notify_play;
1322 e->chat = uct_chat;
1323 e->genmove = uct_genmove;
1324 e->genmoves = uct_genmoves;
1325 e->dead_group_list = uct_dead_group_list;
1326 e->done = uct_done;
1327 e->data = u;
1328 if (u->slave)
1329 e->notify = uct_notify;
1331 const char banner[] = "I'm playing UCT. When I'm losing, I will resign, "
1332 "if I think I win, I play until you pass. "
1333 "Anyone can send me 'winrate' in private chat to get my assessment of the position.";
1334 if (!u->banner) u->banner = "";
1335 e->comment = malloc(sizeof(banner) + strlen(u->banner) + 1);
1336 sprintf(e->comment, "%s %s", banner, u->banner);
1338 return e;