2 Stockfish, a UCI chess playing engine derived from Glaurung 2.1
3 Copyright (C) 2004-2008 Tord Romstad (Glaurung author)
4 Copyright (C) 2008-2010 Marco Costalba, Joona Kiiski, Tord Romstad
6 Stockfish is free software: you can redistribute it and/or modify
7 it under the terms of the GNU General Public License as published by
8 the Free Software Foundation, either version 3 of the License, or
9 (at your option) any later version.
11 Stockfish is distributed in the hope that it will be useful,
12 but WITHOUT ANY WARRANTY; without even the implied warranty of
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 GNU General Public License for more details.
16 You should have received a copy of the GNU General Public License
17 along with this program. If not, see <http://www.gnu.org/licenses/>.
44 #include "ucioption.h"
50 //// Local definitions
56 enum NodeType { NonPV, PV };
58 // Set to true to force running with one thread.
59 // Used for debugging SMP code.
60 const bool FakeSplit = false;
62 // Fast lookup table of sliding pieces indexed by Piece
63 const bool Slidings[18] = { 0, 0, 0, 1, 1, 1, 0, 0, 0, 0, 0, 1, 1, 1 };
64 inline bool piece_is_slider(Piece p) { return Slidings[p]; }
66 // ThreadsManager class is used to handle all the threads related stuff in search,
67 // init, starting, parking and, the most important, launching a slave thread at a
68 // split point are what this class does. All the access to shared thread data is
69 // done through this class, so that we avoid using global variables instead.
71 class ThreadsManager {
72 /* As long as the single ThreadsManager object is defined as a global we don't
73 need to explicitly initialize to zero its data members because variables with
74 static storage duration are automatically set to zero before enter main()
80 int min_split_depth() const { return minimumSplitDepth; }
81 int active_threads() const { return activeThreads; }
82 void set_active_threads(int cnt) { activeThreads = cnt; }
84 void read_uci_options();
85 bool available_thread_exists(int master) const;
86 bool thread_is_available(int slave, int master) const;
87 bool thread_should_stop(int threadID) const;
88 void wake_sleeping_thread(int threadID);
89 void idle_loop(int threadID, SplitPoint* sp);
92 void split(Position& pos, SearchStack* ss, int ply, Value* alpha, const Value beta, Value* bestValue,
93 Depth depth, Move threatMove, bool mateThreat, int moveCount, MovePicker* mp, bool pvNode);
96 Depth minimumSplitDepth;
97 int maxThreadsPerSplitPoint;
98 bool useSleepingThreads;
100 volatile bool allThreadsShouldExit;
101 Thread threads[MAX_THREADS];
102 Lock mpLock, sleepLock[MAX_THREADS];
103 WaitCondition sleepCond[MAX_THREADS];
107 // RootMove struct is used for moves at the root at the tree. For each
108 // root move, we store a score, a node count, and a PV (really a refutation
109 // in the case of moves which fail low).
113 RootMove() : mp_score(0), nodes(0) {}
115 // RootMove::operator<() is the comparison function used when
116 // sorting the moves. A move m1 is considered to be better
117 // than a move m2 if it has a higher score, or if the moves
118 // have equal score but m1 has the higher beta cut-off count.
119 bool operator<(const RootMove& m) const {
121 return score != m.score ? score < m.score : mp_score <= m.mp_score;
128 Move pv[PLY_MAX_PLUS_2];
132 // The RootMoveList class is essentially an array of RootMove objects, with
133 // a handful of methods for accessing the data in the individual moves.
138 RootMoveList(Position& pos, Move searchMoves[]);
140 Move move(int moveNum) const { return moves[moveNum].move; }
141 Move move_pv(int moveNum, int i) const { return moves[moveNum].pv[i]; }
142 int move_count() const { return count; }
143 Value move_score(int moveNum) const { return moves[moveNum].score; }
144 int64_t move_nodes(int moveNum) const { return moves[moveNum].nodes; }
145 void add_move_nodes(int moveNum, int64_t nodes) { moves[moveNum].nodes += nodes; }
146 void set_move_score(int moveNum, Value score) { moves[moveNum].score = score; }
148 void set_move_pv(int moveNum, const Move pv[]);
149 void score_moves(const Position& pos);
151 void sort_multipv(int n);
154 RootMove moves[MOVES_MAX];
159 // When formatting a move for std::cout we must know if we are in Chess960
160 // or not. To keep using the handy operator<<() on the move the trick is to
161 // embed this flag in the stream itself. Function-like named enum set960 is
162 // used as a custom manipulator and the stream internal general-purpose array,
163 // accessed through ios_base::iword(), is used to pass the flag to the move's
164 // operator<<() that will use it to properly format castling moves.
167 std::ostream& operator<< (std::ostream& os, const set960& m) {
169 os.iword(0) = int(m);
178 // Maximum depth for razoring
179 const Depth RazorDepth = 4 * ONE_PLY;
181 // Dynamic razoring margin based on depth
182 inline Value razor_margin(Depth d) { return Value(0x200 + 0x10 * int(d)); }
184 // Maximum depth for use of dynamic threat detection when null move fails low
185 const Depth ThreatDepth = 5 * ONE_PLY;
187 // Step 9. Internal iterative deepening
189 // Minimum depth for use of internal iterative deepening
190 const Depth IIDDepth[2] = { 8 * ONE_PLY /* non-PV */, 5 * ONE_PLY /* PV */};
192 // At Non-PV nodes we do an internal iterative deepening search
193 // when the static evaluation is bigger then beta - IIDMargin.
194 const Value IIDMargin = Value(0x100);
196 // Step 11. Decide the new search depth
198 // Extensions. Configurable UCI options
199 // Array index 0 is used at non-PV nodes, index 1 at PV nodes.
200 Depth CheckExtension[2], SingleEvasionExtension[2], PawnPushTo7thExtension[2];
201 Depth PassedPawnExtension[2], PawnEndgameExtension[2], MateThreatExtension[2];
203 // Minimum depth for use of singular extension
204 const Depth SingularExtensionDepth[2] = { 8 * ONE_PLY /* non-PV */, 6 * ONE_PLY /* PV */};
206 // If the TT move is at least SingularExtensionMargin better then the
207 // remaining ones we will extend it.
208 const Value SingularExtensionMargin = Value(0x20);
210 // Step 12. Futility pruning
212 // Futility margin for quiescence search
213 const Value FutilityMarginQS = Value(0x80);
215 // Futility lookup tables (initialized at startup) and their getter functions
216 Value FutilityMarginsMatrix[16][64]; // [depth][moveNumber]
217 int FutilityMoveCountArray[32]; // [depth]
219 inline Value futility_margin(Depth d, int mn) { return d < 7 * ONE_PLY ? FutilityMarginsMatrix[Max(d, 1)][Min(mn, 63)] : 2 * VALUE_INFINITE; }
220 inline int futility_move_count(Depth d) { return d < 16 * ONE_PLY ? FutilityMoveCountArray[d] : 512; }
222 // Step 14. Reduced search
224 // Reduction lookup tables (initialized at startup) and their getter functions
225 int8_t ReductionMatrix[2][64][64]; // [pv][depth][moveNumber]
227 template <NodeType PV>
228 inline Depth reduction(Depth d, int mn) { return (Depth) ReductionMatrix[PV][Min(d / 2, 63)][Min(mn, 63)]; }
230 // Common adjustments
232 // Search depth at iteration 1
233 const Depth InitialDepth = ONE_PLY;
235 // Easy move margin. An easy move candidate must be at least this much
236 // better than the second best move.
237 const Value EasyMoveMargin = Value(0x200);
240 /// Namespace variables
248 // Scores and number of times the best move changed for each iteration
249 Value ValueByIteration[PLY_MAX_PLUS_2];
250 int BestMoveChangesByIteration[PLY_MAX_PLUS_2];
252 // Search window management
258 // Time managment variables
259 int SearchStartTime, MaxNodes, MaxDepth, ExactMaxTime;
260 bool UseTimeManagement, InfiniteSearch, PonderSearch, StopOnPonderhit;
261 bool FirstRootMove, AbortSearch, Quit, AspirationFailLow;
266 std::ofstream LogFile;
268 // Multi-threads manager object
269 ThreadsManager ThreadsMgr;
271 // Node counters, used only by thread[0] but try to keep in different cache
272 // lines (64 bytes each) from the heavy multi-thread read accessed variables.
274 int NodesBetweenPolls = 30000;
281 Value id_loop(Position& pos, Move searchMoves[]);
282 Value root_search(Position& pos, SearchStack* ss, Move* pv, RootMoveList& rml, Value* alphaPtr, Value* betaPtr);
284 template <NodeType PvNode, bool SpNode>
285 Value search(Position& pos, SearchStack* ss, Value alpha, Value beta, Depth depth, int ply);
287 template <NodeType PvNode>
288 Value qsearch(Position& pos, SearchStack* ss, Value alpha, Value beta, Depth depth, int ply);
290 template <NodeType PvNode>
291 inline Value search(Position& pos, SearchStack* ss, Value alpha, Value beta, Depth depth, int ply) {
293 return depth < ONE_PLY ? qsearch<PvNode>(pos, ss, alpha, beta, DEPTH_ZERO, ply)
294 : search<PvNode, false>(pos, ss, alpha, beta, depth, ply);
297 template <NodeType PvNode>
298 Depth extension(const Position& pos, Move m, bool captureOrPromotion, bool moveIsCheck, bool singleEvasion, bool mateThreat, bool* dangerous);
300 bool connected_moves(const Position& pos, Move m1, Move m2);
301 bool value_is_mate(Value value);
302 Value value_to_tt(Value v, int ply);
303 Value value_from_tt(Value v, int ply);
304 bool ok_to_use_TT(const TTEntry* tte, Depth depth, Value beta, int ply);
305 bool connected_threat(const Position& pos, Move m, Move threat);
306 Value refine_eval(const TTEntry* tte, Value defaultEval, int ply);
307 void update_history(const Position& pos, Move move, Depth depth, Move movesSearched[], int moveCount);
308 void update_killers(Move m, SearchStack* ss);
309 void update_gains(const Position& pos, Move move, Value before, Value after);
311 int current_search_time();
312 std::string value_to_uci(Value v);
313 int nps(const Position& pos);
314 void poll(const Position& pos);
316 void wait_for_stop_or_ponderhit();
317 void init_ss_array(SearchStack* ss, int size);
318 void print_pv_info(const Position& pos, Move pv[], Value alpha, Value beta, Value value);
319 void insert_pv_in_tt(const Position& pos, Move pv[]);
320 void extract_pv_from_tt(const Position& pos, Move bestMove, Move pv[]);
322 #if !defined(_MSC_VER)
323 void* init_thread(void* threadID);
325 DWORD WINAPI init_thread(LPVOID threadID);
335 /// init_threads(), exit_threads() and nodes_searched() are helpers to
336 /// give accessibility to some TM methods from outside of current file.
338 void init_threads() { ThreadsMgr.init_threads(); }
339 void exit_threads() { ThreadsMgr.exit_threads(); }
342 /// init_search() is called during startup. It initializes various lookup tables
346 int d; // depth (ONE_PLY == 2)
347 int hd; // half depth (ONE_PLY == 1)
350 // Init reductions array
351 for (hd = 1; hd < 64; hd++) for (mc = 1; mc < 64; mc++)
353 double pvRed = log(double(hd)) * log(double(mc)) / 3.0;
354 double nonPVRed = 0.33 + log(double(hd)) * log(double(mc)) / 2.25;
355 ReductionMatrix[PV][hd][mc] = (int8_t) ( pvRed >= 1.0 ? floor( pvRed * int(ONE_PLY)) : 0);
356 ReductionMatrix[NonPV][hd][mc] = (int8_t) (nonPVRed >= 1.0 ? floor(nonPVRed * int(ONE_PLY)) : 0);
359 // Init futility margins array
360 for (d = 1; d < 16; d++) for (mc = 0; mc < 64; mc++)
361 FutilityMarginsMatrix[d][mc] = Value(112 * int(log(double(d * d) / 2) / log(2.0) + 1.001) - 8 * mc + 45);
363 // Init futility move count array
364 for (d = 0; d < 32; d++)
365 FutilityMoveCountArray[d] = int(3.001 + 0.25 * pow(d, 2.0));
369 /// perft() is our utility to verify move generation is bug free. All the legal
370 /// moves up to given depth are generated and counted and the sum returned.
372 int perft(Position& pos, Depth depth)
374 MoveStack mlist[MOVES_MAX];
379 // Generate all legal moves
380 MoveStack* last = generate_moves(pos, mlist);
382 // If we are at the last ply we don't need to do and undo
383 // the moves, just to count them.
384 if (depth <= ONE_PLY)
385 return int(last - mlist);
387 // Loop through all legal moves
389 for (MoveStack* cur = mlist; cur != last; cur++)
392 pos.do_move(m, st, ci, pos.move_is_check(m, ci));
393 sum += perft(pos, depth - ONE_PLY);
400 /// think() is the external interface to Stockfish's search, and is called when
401 /// the program receives the UCI 'go' command. It initializes various
402 /// search-related global variables, and calls root_search(). It returns false
403 /// when a quit command is received during the search.
405 bool think(Position& pos, bool infinite, bool ponder, int time[], int increment[],
406 int movesToGo, int maxDepth, int maxNodes, int maxTime, Move searchMoves[]) {
408 // Initialize global search variables
409 StopOnPonderhit = AbortSearch = Quit = AspirationFailLow = false;
411 SearchStartTime = get_system_time();
412 ExactMaxTime = maxTime;
415 InfiniteSearch = infinite;
416 PonderSearch = ponder;
417 UseTimeManagement = !ExactMaxTime && !MaxDepth && !MaxNodes && !InfiniteSearch;
419 // Look for a book move, only during games, not tests
420 if (UseTimeManagement && Options["OwnBook"].value<bool>())
422 if (Options["Book File"].value<std::string>() != OpeningBook.file_name())
423 OpeningBook.open(Options["Book File"].value<std::string>());
425 Move bookMove = OpeningBook.get_move(pos, Options["Best Book Move"].value<bool>());
426 if (bookMove != MOVE_NONE)
429 wait_for_stop_or_ponderhit();
431 cout << "bestmove " << bookMove << endl;
436 // Read UCI option values
437 TT.set_size(Options["Hash"].value<int>());
438 if (Options["Clear Hash"].value<bool>())
440 Options["Clear Hash"].set_value("false");
444 CheckExtension[1] = Options["Check Extension (PV nodes)"].value<Depth>();
445 CheckExtension[0] = Options["Check Extension (non-PV nodes)"].value<Depth>();
446 SingleEvasionExtension[1] = Options["Single Evasion Extension (PV nodes)"].value<Depth>();
447 SingleEvasionExtension[0] = Options["Single Evasion Extension (non-PV nodes)"].value<Depth>();
448 PawnPushTo7thExtension[1] = Options["Pawn Push to 7th Extension (PV nodes)"].value<Depth>();
449 PawnPushTo7thExtension[0] = Options["Pawn Push to 7th Extension (non-PV nodes)"].value<Depth>();
450 PassedPawnExtension[1] = Options["Passed Pawn Extension (PV nodes)"].value<Depth>();
451 PassedPawnExtension[0] = Options["Passed Pawn Extension (non-PV nodes)"].value<Depth>();
452 PawnEndgameExtension[1] = Options["Pawn Endgame Extension (PV nodes)"].value<Depth>();
453 PawnEndgameExtension[0] = Options["Pawn Endgame Extension (non-PV nodes)"].value<Depth>();
454 MateThreatExtension[1] = Options["Mate Threat Extension (PV nodes)"].value<Depth>();
455 MateThreatExtension[0] = Options["Mate Threat Extension (non-PV nodes)"].value<Depth>();
456 MultiPV = Options["MultiPV"].value<int>();
457 UseLogFile = Options["Use Search Log"].value<bool>();
460 LogFile.open(Options["Search Log Filename"].value<std::string>().c_str(), std::ios::out | std::ios::app);
462 read_weights(pos.side_to_move());
464 // Set the number of active threads
465 ThreadsMgr.read_uci_options();
466 init_eval(ThreadsMgr.active_threads());
468 // Wake up needed threads
469 for (int i = 1; i < ThreadsMgr.active_threads(); i++)
470 ThreadsMgr.wake_sleeping_thread(i);
473 int myTime = time[pos.side_to_move()];
474 int myIncrement = increment[pos.side_to_move()];
475 if (UseTimeManagement)
476 TimeMgr.init(myTime, myIncrement, movesToGo, pos.startpos_ply_counter());
478 // Set best NodesBetweenPolls interval to avoid lagging under
479 // heavy time pressure.
481 NodesBetweenPolls = Min(MaxNodes, 30000);
482 else if (myTime && myTime < 1000)
483 NodesBetweenPolls = 1000;
484 else if (myTime && myTime < 5000)
485 NodesBetweenPolls = 5000;
487 NodesBetweenPolls = 30000;
489 // Write search information to log file
491 LogFile << "Searching: " << pos.to_fen() << endl
492 << "infinite: " << infinite
493 << " ponder: " << ponder
494 << " time: " << myTime
495 << " increment: " << myIncrement
496 << " moves to go: " << movesToGo << endl;
498 // We're ready to start thinking. Call the iterative deepening loop function
499 id_loop(pos, searchMoves);
504 // This makes all the threads to go to sleep
505 ThreadsMgr.set_active_threads(1);
513 // id_loop() is the main iterative deepening loop. It calls root_search
514 // repeatedly with increasing depth until the allocated thinking time has
515 // been consumed, the user stops the search, or the maximum search depth is
518 Value id_loop(Position& pos, Move searchMoves[]) {
520 SearchStack ss[PLY_MAX_PLUS_2];
521 Move pv[PLY_MAX_PLUS_2];
522 Move EasyMove = MOVE_NONE;
523 Value value, alpha = -VALUE_INFINITE, beta = VALUE_INFINITE;
525 // Moves to search are verified, copied, scored and sorted
526 RootMoveList rml(pos, searchMoves);
528 // Handle special case of searching on a mate/stale position
529 if (rml.move_count() == 0)
532 wait_for_stop_or_ponderhit();
534 return pos.is_check() ? -VALUE_MATE : VALUE_DRAW;
537 // Print RootMoveList startup scoring to the standard output,
538 // so to output information also for iteration 1.
539 cout << set960(pos.is_chess960()) // Is enough to set once at the beginning
540 << "info depth " << 1
541 << "\ninfo depth " << 1
542 << " score " << value_to_uci(rml.move_score(0))
543 << " time " << current_search_time()
544 << " nodes " << pos.nodes_searched()
545 << " nps " << nps(pos)
546 << " pv " << rml.move(0) << "\n";
551 init_ss_array(ss, PLY_MAX_PLUS_2);
552 pv[0] = pv[1] = MOVE_NONE;
553 ValueByIteration[1] = rml.move_score(0);
556 // Is one move significantly better than others after initial scoring ?
557 if ( rml.move_count() == 1
558 || rml.move_score(0) > rml.move_score(1) + EasyMoveMargin)
559 EasyMove = rml.move(0);
561 // Iterative deepening loop
562 while (Iteration < PLY_MAX)
564 // Initialize iteration
566 BestMoveChangesByIteration[Iteration] = 0;
568 cout << "info depth " << Iteration << endl;
570 // Calculate dynamic aspiration window based on previous iterations
571 if (MultiPV == 1 && Iteration >= 6 && abs(ValueByIteration[Iteration - 1]) < VALUE_KNOWN_WIN)
573 int prevDelta1 = ValueByIteration[Iteration - 1] - ValueByIteration[Iteration - 2];
574 int prevDelta2 = ValueByIteration[Iteration - 2] - ValueByIteration[Iteration - 3];
576 AspirationDelta = Max(abs(prevDelta1) + abs(prevDelta2) / 2, 16);
577 AspirationDelta = (AspirationDelta + 7) / 8 * 8; // Round to match grainSize
579 alpha = Max(ValueByIteration[Iteration - 1] - AspirationDelta, -VALUE_INFINITE);
580 beta = Min(ValueByIteration[Iteration - 1] + AspirationDelta, VALUE_INFINITE);
583 // Search to the current depth, rml is updated and sorted, alpha and beta could change
584 value = root_search(pos, ss, pv, rml, &alpha, &beta);
586 // Write PV to transposition table, in case the relevant entries have
587 // been overwritten during the search.
588 insert_pv_in_tt(pos, pv);
591 break; // Value cannot be trusted. Break out immediately!
593 //Save info about search result
594 ValueByIteration[Iteration] = value;
596 // Drop the easy move if differs from the new best move
597 if (pv[0] != EasyMove)
598 EasyMove = MOVE_NONE;
600 if (UseTimeManagement)
603 bool stopSearch = false;
605 // Stop search early if there is only a single legal move,
606 // we search up to Iteration 6 anyway to get a proper score.
607 if (Iteration >= 6 && rml.move_count() == 1)
610 // Stop search early when the last two iterations returned a mate score
612 && abs(ValueByIteration[Iteration]) >= abs(VALUE_MATE) - 100
613 && abs(ValueByIteration[Iteration-1]) >= abs(VALUE_MATE) - 100)
616 // Stop search early if one move seems to be much better than the others
619 && ( ( rml.move_nodes(0) > (pos.nodes_searched() * 85) / 100
620 && current_search_time() > TimeMgr.available_time() / 16)
621 ||( rml.move_nodes(0) > (pos.nodes_searched() * 98) / 100
622 && current_search_time() > TimeMgr.available_time() / 32)))
625 // Add some extra time if the best move has changed during the last two iterations
626 if (Iteration > 5 && Iteration <= 50)
627 TimeMgr.pv_instability(BestMoveChangesByIteration[Iteration],
628 BestMoveChangesByIteration[Iteration-1]);
630 // Stop search if most of MaxSearchTime is consumed at the end of the
631 // iteration. We probably don't have enough time to search the first
632 // move at the next iteration anyway.
633 if (current_search_time() > (TimeMgr.available_time() * 80) / 128)
639 StopOnPonderhit = true;
645 if (MaxDepth && Iteration >= MaxDepth)
649 // If we are pondering or in infinite search, we shouldn't print the
650 // best move before we are told to do so.
651 if (!AbortSearch && (PonderSearch || InfiniteSearch))
652 wait_for_stop_or_ponderhit();
654 // Print final search statistics
655 cout << "info nodes " << pos.nodes_searched()
656 << " nps " << nps(pos)
657 << " time " << current_search_time() << endl;
659 // Print the best move and the ponder move to the standard output
660 if (pv[0] == MOVE_NONE || MultiPV > 1)
666 assert(pv[0] != MOVE_NONE);
668 cout << "bestmove " << pv[0];
670 if (pv[1] != MOVE_NONE)
671 cout << " ponder " << pv[1];
678 dbg_print_mean(LogFile);
680 if (dbg_show_hit_rate)
681 dbg_print_hit_rate(LogFile);
683 LogFile << "\nNodes: " << pos.nodes_searched()
684 << "\nNodes/second: " << nps(pos)
685 << "\nBest move: " << move_to_san(pos, pv[0]);
688 pos.do_move(pv[0], st);
689 LogFile << "\nPonder move: "
690 << move_to_san(pos, pv[1]) // Works also with MOVE_NONE
693 return rml.move_score(0);
697 // root_search() is the function which searches the root node. It is
698 // similar to search_pv except that it uses a different move ordering
699 // scheme, prints some information to the standard output and handles
700 // the fail low/high loops.
702 Value root_search(Position& pos, SearchStack* ss, Move* pv, RootMoveList& rml, Value* alphaPtr, Value* betaPtr) {
708 Depth depth, ext, newDepth;
709 Value value, alpha, beta;
710 bool isCheck, moveIsCheck, captureOrPromotion, dangerous;
711 int researchCountFH, researchCountFL;
713 researchCountFH = researchCountFL = 0;
716 isCheck = pos.is_check();
717 depth = (Iteration - 2) * ONE_PLY + InitialDepth;
719 // Step 1. Initialize node (polling is omitted at root)
720 ss->currentMove = ss->bestMove = MOVE_NONE;
722 // Step 2. Check for aborted search (omitted at root)
723 // Step 3. Mate distance pruning (omitted at root)
724 // Step 4. Transposition table lookup (omitted at root)
726 // Step 5. Evaluate the position statically
727 // At root we do this only to get reference value for child nodes
728 ss->evalMargin = VALUE_NONE;
729 ss->eval = isCheck ? VALUE_NONE : evaluate(pos, ss->evalMargin);
731 // Step 6. Razoring (omitted at root)
732 // Step 7. Static null move pruning (omitted at root)
733 // Step 8. Null move search with verification search (omitted at root)
734 // Step 9. Internal iterative deepening (omitted at root)
736 // Step extra. Fail low loop
737 // We start with small aspiration window and in case of fail low, we research
738 // with bigger window until we are not failing low anymore.
741 // Sort the moves before to (re)search
742 rml.score_moves(pos);
745 // Step 10. Loop through all moves in the root move list
746 for (int i = 0; i < rml.move_count() && !AbortSearch; i++)
748 // This is used by time management
749 FirstRootMove = (i == 0);
751 // Save the current node count before the move is searched
752 nodes = pos.nodes_searched();
754 // Pick the next root move, and print the move and the move number to
755 // the standard output.
756 move = ss->currentMove = rml.move(i);
758 if (current_search_time() >= 1000)
759 cout << "info currmove " << move
760 << " currmovenumber " << i + 1 << endl;
762 moveIsCheck = pos.move_is_check(move);
763 captureOrPromotion = pos.move_is_capture_or_promotion(move);
765 // Step 11. Decide the new search depth
766 ext = extension<PV>(pos, move, captureOrPromotion, moveIsCheck, false, false, &dangerous);
767 newDepth = depth + ext;
769 // Step 12. Futility pruning (omitted at root)
771 // Step extra. Fail high loop
772 // If move fails high, we research with bigger window until we are not failing
774 value = - VALUE_INFINITE;
778 // Step 13. Make the move
779 pos.do_move(move, st, ci, moveIsCheck);
781 // Step extra. pv search
782 // We do pv search for first moves (i < MultiPV)
783 // and for fail high research (value > alpha)
784 if (i < MultiPV || value > alpha)
786 // Aspiration window is disabled in multi-pv case
788 alpha = -VALUE_INFINITE;
790 // Full depth PV search, done on first move or after a fail high
791 value = -search<PV>(pos, ss+1, -beta, -alpha, newDepth, 1);
795 // Step 14. Reduced search
796 // if the move fails high will be re-searched at full depth
797 bool doFullDepthSearch = true;
799 if ( depth >= 3 * ONE_PLY
801 && !captureOrPromotion
802 && !move_is_castle(move))
804 ss->reduction = reduction<PV>(depth, i - MultiPV + 2);
807 assert(newDepth-ss->reduction >= ONE_PLY);
809 // Reduced depth non-pv search using alpha as upperbound
810 value = -search<NonPV>(pos, ss+1, -(alpha+1), -alpha, newDepth-ss->reduction, 1);
811 doFullDepthSearch = (value > alpha);
814 // The move failed high, but if reduction is very big we could
815 // face a false positive, retry with a less aggressive reduction,
816 // if the move fails high again then go with full depth search.
817 if (doFullDepthSearch && ss->reduction > 2 * ONE_PLY)
819 assert(newDepth - ONE_PLY >= ONE_PLY);
821 ss->reduction = ONE_PLY;
822 value = -search<NonPV>(pos, ss+1, -(alpha+1), -alpha, newDepth-ss->reduction, 1);
823 doFullDepthSearch = (value > alpha);
825 ss->reduction = DEPTH_ZERO; // Restore original reduction
828 // Step 15. Full depth search
829 if (doFullDepthSearch)
831 // Full depth non-pv search using alpha as upperbound
832 value = -search<NonPV>(pos, ss+1, -(alpha+1), -alpha, newDepth, 1);
834 // If we are above alpha then research at same depth but as PV
835 // to get a correct score or eventually a fail high above beta.
837 value = -search<PV>(pos, ss+1, -beta, -alpha, newDepth, 1);
841 // Step 16. Undo move
844 // Can we exit fail high loop ?
845 if (AbortSearch || value < beta)
848 // We are failing high and going to do a research. It's important to update
849 // the score before research in case we run out of time while researching.
850 rml.set_move_score(i, value);
852 extract_pv_from_tt(pos, move, pv);
853 rml.set_move_pv(i, pv);
855 // Print information to the standard output
856 print_pv_info(pos, pv, alpha, beta, value);
858 // Prepare for a research after a fail high, each time with a wider window
859 *betaPtr = beta = Min(beta + AspirationDelta * (1 << researchCountFH), VALUE_INFINITE);
862 } // End of fail high loop
864 // Finished searching the move. If AbortSearch is true, the search
865 // was aborted because the user interrupted the search or because we
866 // ran out of time. In this case, the return value of the search cannot
867 // be trusted, and we break out of the loop without updating the best
872 // Remember searched nodes counts for this move
873 rml.add_move_nodes(i, pos.nodes_searched() - nodes);
875 assert(value >= -VALUE_INFINITE && value <= VALUE_INFINITE);
876 assert(value < beta);
878 // Step 17. Check for new best move
879 if (value <= alpha && i >= MultiPV)
880 rml.set_move_score(i, -VALUE_INFINITE);
883 // PV move or new best move!
886 rml.set_move_score(i, value);
888 extract_pv_from_tt(pos, move, pv);
889 rml.set_move_pv(i, pv);
893 // We record how often the best move has been changed in each
894 // iteration. This information is used for time managment: When
895 // the best move changes frequently, we allocate some more time.
897 BestMoveChangesByIteration[Iteration]++;
899 // Print information to the standard output
900 print_pv_info(pos, pv, alpha, beta, value);
902 // Raise alpha to setup proper non-pv search upper bound
909 for (int j = 0; j < Min(MultiPV, rml.move_count()); j++)
911 cout << "info multipv " << j + 1
912 << " score " << value_to_uci(rml.move_score(j))
913 << " depth " << (j <= i ? Iteration : Iteration - 1)
914 << " time " << current_search_time()
915 << " nodes " << pos.nodes_searched()
916 << " nps " << nps(pos)
919 for (int k = 0; rml.move_pv(j, k) != MOVE_NONE && k < PLY_MAX; k++)
920 cout << rml.move_pv(j, k) << " ";
924 alpha = rml.move_score(Min(i, MultiPV - 1));
926 } // PV move or new best move
928 assert(alpha >= *alphaPtr);
930 AspirationFailLow = (alpha == *alphaPtr);
932 if (AspirationFailLow && StopOnPonderhit)
933 StopOnPonderhit = false;
936 // Can we exit fail low loop ?
937 if (AbortSearch || !AspirationFailLow)
940 // Prepare for a research after a fail low, each time with a wider window
941 *alphaPtr = alpha = Max(alpha - AspirationDelta * (1 << researchCountFL), -VALUE_INFINITE);
946 // Sort the moves before to return
953 // search<>() is the main search function for both PV and non-PV nodes and for
954 // normal and SplitPoint nodes. When called just after a split point the search
955 // is simpler because we have already probed the hash table, done a null move
956 // search, and searched the first move before splitting, we don't have to repeat
957 // all this work again. We also don't need to store anything to the hash table
958 // here: This is taken care of after we return from the split point.
960 template <NodeType PvNode, bool SpNode>
961 Value search(Position& pos, SearchStack* ss, Value alpha, Value beta, Depth depth, int ply) {
963 assert(alpha >= -VALUE_INFINITE && alpha <= VALUE_INFINITE);
964 assert(beta > alpha && beta <= VALUE_INFINITE);
965 assert(PvNode || alpha == beta - 1);
966 assert(ply > 0 && ply < PLY_MAX);
967 assert(pos.thread() >= 0 && pos.thread() < ThreadsMgr.active_threads());
969 Move movesSearched[MOVES_MAX];
973 Move ttMove, move, excludedMove, threatMove;
976 Value bestValue, value, oldAlpha;
977 Value refinedValue, nullValue, futilityBase, futilityValueScaled; // Non-PV specific
978 bool isCheck, singleEvasion, singularExtensionNode, moveIsCheck, captureOrPromotion, dangerous;
979 bool mateThreat = false;
981 int threadID = pos.thread();
982 SplitPoint* sp = NULL;
983 refinedValue = bestValue = value = -VALUE_INFINITE;
985 isCheck = pos.is_check();
991 ttMove = excludedMove = MOVE_NONE;
992 threatMove = sp->threatMove;
993 mateThreat = sp->mateThreat;
994 goto split_point_start;
995 } else {} // Hack to fix icc's "statement is unreachable" warning
997 // Step 1. Initialize node and poll. Polling can abort search
998 ss->currentMove = ss->bestMove = threatMove = MOVE_NONE;
999 (ss+2)->killers[0] = (ss+2)->killers[1] = (ss+2)->mateKiller = MOVE_NONE;
1001 if (threadID == 0 && ++NodesSincePoll > NodesBetweenPolls)
1007 // Step 2. Check for aborted search and immediate draw
1008 if ( AbortSearch || ThreadsMgr.thread_should_stop(threadID)
1009 || pos.is_draw() || ply >= PLY_MAX - 1)
1012 // Step 3. Mate distance pruning
1013 alpha = Max(value_mated_in(ply), alpha);
1014 beta = Min(value_mate_in(ply+1), beta);
1018 // Step 4. Transposition table lookup
1020 // We don't want the score of a partial search to overwrite a previous full search
1021 // TT value, so we use a different position key in case of an excluded move exists.
1022 excludedMove = ss->excludedMove;
1023 posKey = excludedMove ? pos.get_exclusion_key() : pos.get_key();
1025 tte = TT.retrieve(posKey);
1026 ttMove = tte ? tte->move() : MOVE_NONE;
1028 // At PV nodes, we don't use the TT for pruning, but only for move ordering.
1029 // This is to avoid problems in the following areas:
1031 // * Repetition draw detection
1032 // * Fifty move rule detection
1033 // * Searching for a mate
1034 // * Printing of full PV line
1035 if (!PvNode && tte && ok_to_use_TT(tte, depth, beta, ply))
1038 ss->bestMove = ttMove; // Can be MOVE_NONE
1039 return value_from_tt(tte->value(), ply);
1042 // Step 5. Evaluate the position statically and
1043 // update gain statistics of parent move.
1045 ss->eval = ss->evalMargin = VALUE_NONE;
1048 assert(tte->static_value() != VALUE_NONE);
1050 ss->eval = tte->static_value();
1051 ss->evalMargin = tte->static_value_margin();
1052 refinedValue = refine_eval(tte, ss->eval, ply);
1056 refinedValue = ss->eval = evaluate(pos, ss->evalMargin);
1057 TT.store(posKey, VALUE_NONE, VALUE_TYPE_NONE, DEPTH_NONE, MOVE_NONE, ss->eval, ss->evalMargin);
1060 // Save gain for the parent non-capture move
1061 update_gains(pos, (ss-1)->currentMove, (ss-1)->eval, ss->eval);
1063 // Step 6. Razoring (is omitted in PV nodes)
1065 && depth < RazorDepth
1067 && refinedValue < beta - razor_margin(depth)
1068 && ttMove == MOVE_NONE
1069 && !value_is_mate(beta)
1070 && !pos.has_pawn_on_7th(pos.side_to_move()))
1072 Value rbeta = beta - razor_margin(depth);
1073 Value v = qsearch<NonPV>(pos, ss, rbeta-1, rbeta, DEPTH_ZERO, ply);
1075 // Logically we should return (v + razor_margin(depth)), but
1076 // surprisingly this did slightly weaker in tests.
1080 // Step 7. Static null move pruning (is omitted in PV nodes)
1081 // We're betting that the opponent doesn't have a move that will reduce
1082 // the score by more than futility_margin(depth) if we do a null move.
1084 && !ss->skipNullMove
1085 && depth < RazorDepth
1087 && refinedValue >= beta + futility_margin(depth, 0)
1088 && !value_is_mate(beta)
1089 && pos.non_pawn_material(pos.side_to_move()))
1090 return refinedValue - futility_margin(depth, 0);
1092 // Step 8. Null move search with verification search (is omitted in PV nodes)
1094 && !ss->skipNullMove
1097 && refinedValue >= beta
1098 && !value_is_mate(beta)
1099 && pos.non_pawn_material(pos.side_to_move()))
1101 ss->currentMove = MOVE_NULL;
1103 // Null move dynamic reduction based on depth
1104 int R = 3 + (depth >= 5 * ONE_PLY ? depth / 8 : 0);
1106 // Null move dynamic reduction based on value
1107 if (refinedValue - beta > PawnValueMidgame)
1110 pos.do_null_move(st);
1111 (ss+1)->skipNullMove = true;
1112 nullValue = -search<NonPV>(pos, ss+1, -beta, -alpha, depth-R*ONE_PLY, ply+1);
1113 (ss+1)->skipNullMove = false;
1114 pos.undo_null_move();
1116 if (nullValue >= beta)
1118 // Do not return unproven mate scores
1119 if (nullValue >= value_mate_in(PLY_MAX))
1122 if (depth < 6 * ONE_PLY)
1125 // Do verification search at high depths
1126 ss->skipNullMove = true;
1127 Value v = search<NonPV>(pos, ss, alpha, beta, depth-R*ONE_PLY, ply);
1128 ss->skipNullMove = false;
1135 // The null move failed low, which means that we may be faced with
1136 // some kind of threat. If the previous move was reduced, check if
1137 // the move that refuted the null move was somehow connected to the
1138 // move which was reduced. If a connection is found, return a fail
1139 // low score (which will cause the reduced move to fail high in the
1140 // parent node, which will trigger a re-search with full depth).
1141 if (nullValue == value_mated_in(ply + 2))
1144 threatMove = (ss+1)->bestMove;
1145 if ( depth < ThreatDepth
1146 && (ss-1)->reduction
1147 && connected_moves(pos, (ss-1)->currentMove, threatMove))
1152 // Step 9. Internal iterative deepening
1153 if ( depth >= IIDDepth[PvNode]
1154 && ttMove == MOVE_NONE
1155 && (PvNode || (!isCheck && ss->eval >= beta - IIDMargin)))
1157 Depth d = (PvNode ? depth - 2 * ONE_PLY : depth / 2);
1159 ss->skipNullMove = true;
1160 search<PvNode>(pos, ss, alpha, beta, d, ply);
1161 ss->skipNullMove = false;
1163 ttMove = ss->bestMove;
1164 tte = TT.retrieve(posKey);
1167 // Expensive mate threat detection (only for PV nodes)
1169 mateThreat = pos.has_mate_threat();
1171 split_point_start: // At split points actual search starts from here
1173 // Initialize a MovePicker object for the current position
1174 // FIXME currently MovePicker() c'tor is needless called also in SplitPoint
1175 MovePicker mpBase(pos, ttMove, depth, H, ss, (PvNode ? -VALUE_INFINITE : beta));
1176 MovePicker& mp = SpNode ? *sp->mp : mpBase;
1178 ss->bestMove = MOVE_NONE;
1179 singleEvasion = !SpNode && isCheck && mp.number_of_evasions() == 1;
1180 futilityBase = ss->eval + ss->evalMargin;
1181 singularExtensionNode = !SpNode
1182 && depth >= SingularExtensionDepth[PvNode]
1185 && !excludedMove // Do not allow recursive singular extension search
1186 && (tte->type() & VALUE_TYPE_LOWER)
1187 && tte->depth() >= depth - 3 * ONE_PLY;
1190 lock_grab(&(sp->lock));
1191 bestValue = sp->bestValue;
1194 // Step 10. Loop through moves
1195 // Loop through all legal moves until no moves remain or a beta cutoff occurs
1196 while ( bestValue < beta
1197 && (move = mp.get_next_move()) != MOVE_NONE
1198 && !ThreadsMgr.thread_should_stop(threadID))
1200 assert(move_is_ok(move));
1204 moveCount = ++sp->moveCount;
1205 lock_release(&(sp->lock));
1207 else if (move == excludedMove)
1210 movesSearched[moveCount++] = move;
1212 moveIsCheck = pos.move_is_check(move, ci);
1213 captureOrPromotion = pos.move_is_capture_or_promotion(move);
1215 // Step 11. Decide the new search depth
1216 ext = extension<PvNode>(pos, move, captureOrPromotion, moveIsCheck, singleEvasion, mateThreat, &dangerous);
1218 // Singular extension search. If all moves but one fail low on a search of (alpha-s, beta-s),
1219 // and just one fails high on (alpha, beta), then that move is singular and should be extended.
1220 // To verify this we do a reduced search on all the other moves but the ttMove, if result is
1221 // lower then ttValue minus a margin then we extend ttMove.
1222 if ( singularExtensionNode
1223 && move == tte->move()
1226 Value ttValue = value_from_tt(tte->value(), ply);
1228 if (abs(ttValue) < VALUE_KNOWN_WIN)
1230 Value b = ttValue - SingularExtensionMargin;
1231 ss->excludedMove = move;
1232 ss->skipNullMove = true;
1233 Value v = search<NonPV>(pos, ss, b - 1, b, depth / 2, ply);
1234 ss->skipNullMove = false;
1235 ss->excludedMove = MOVE_NONE;
1236 ss->bestMove = MOVE_NONE;
1242 // Update current move (this must be done after singular extension search)
1243 ss->currentMove = move;
1244 newDepth = depth - ONE_PLY + ext;
1246 // Step 12. Futility pruning (is omitted in PV nodes)
1248 && !captureOrPromotion
1252 && !move_is_castle(move))
1254 // Move count based pruning
1255 if ( moveCount >= futility_move_count(depth)
1256 && !(threatMove && connected_threat(pos, move, threatMove))
1257 && bestValue > value_mated_in(PLY_MAX)) // FIXME bestValue is racy
1260 lock_grab(&(sp->lock));
1265 // Value based pruning
1266 // We illogically ignore reduction condition depth >= 3*ONE_PLY for predicted depth,
1267 // but fixing this made program slightly weaker.
1268 Depth predictedDepth = newDepth - reduction<NonPV>(depth, moveCount);
1269 futilityValueScaled = futilityBase + futility_margin(predictedDepth, moveCount)
1270 + H.gain(pos.piece_on(move_from(move)), move_to(move));
1272 if (futilityValueScaled < beta)
1276 lock_grab(&(sp->lock));
1277 if (futilityValueScaled > sp->bestValue)
1278 sp->bestValue = bestValue = futilityValueScaled;
1280 else if (futilityValueScaled > bestValue)
1281 bestValue = futilityValueScaled;
1286 // Prune neg. see moves at low depths
1287 if ( predictedDepth < 2 * ONE_PLY
1288 && bestValue > value_mated_in(PLY_MAX)
1289 && pos.see_sign(move) < 0)
1292 lock_grab(&(sp->lock));
1298 // Step 13. Make the move
1299 pos.do_move(move, st, ci, moveIsCheck);
1301 // Step extra. pv search (only in PV nodes)
1302 // The first move in list is the expected PV
1303 if (!SpNode && PvNode && moveCount == 1)
1304 value = -search<PV>(pos, ss+1, -beta, -alpha, newDepth, ply+1);
1307 // Step 14. Reduced depth search
1308 // If the move fails high will be re-searched at full depth.
1309 bool doFullDepthSearch = true;
1311 if ( depth >= 3 * ONE_PLY
1312 && !captureOrPromotion
1314 && !move_is_castle(move)
1315 && !(ss->killers[0] == move || ss->killers[1] == move))
1317 ss->reduction = reduction<PvNode>(depth, moveCount);
1320 alpha = SpNode ? sp->alpha : alpha;
1321 Depth d = newDepth - ss->reduction;
1322 value = -search<NonPV>(pos, ss+1, -(alpha+1), -alpha, d, ply+1);
1324 doFullDepthSearch = (value > alpha);
1327 // The move failed high, but if reduction is very big we could
1328 // face a false positive, retry with a less aggressive reduction,
1329 // if the move fails high again then go with full depth search.
1330 if (doFullDepthSearch && ss->reduction > 2 * ONE_PLY)
1332 assert(newDepth - ONE_PLY >= ONE_PLY);
1334 ss->reduction = ONE_PLY;
1335 alpha = SpNode ? sp->alpha : alpha;
1336 value = -search<NonPV>(pos, ss+1, -(alpha+1), -alpha, newDepth-ss->reduction, ply+1);
1337 doFullDepthSearch = (value > alpha);
1339 ss->reduction = DEPTH_ZERO; // Restore original reduction
1342 // Step 15. Full depth search
1343 if (doFullDepthSearch)
1345 alpha = SpNode ? sp->alpha : alpha;
1346 value = -search<NonPV>(pos, ss+1, -(alpha+1), -alpha, newDepth, ply+1);
1348 // Step extra. pv search (only in PV nodes)
1349 // Search only for possible new PV nodes, if instead value >= beta then
1350 // parent node fails low with value <= alpha and tries another move.
1351 if (PvNode && value > alpha && value < beta)
1352 value = -search<PV>(pos, ss+1, -beta, -alpha, newDepth, ply+1);
1356 // Step 16. Undo move
1357 pos.undo_move(move);
1359 assert(value > -VALUE_INFINITE && value < VALUE_INFINITE);
1361 // Step 17. Check for new best move
1364 lock_grab(&(sp->lock));
1365 bestValue = sp->bestValue;
1369 if (value > bestValue && !(SpNode && ThreadsMgr.thread_should_stop(threadID)))
1374 sp->bestValue = value;
1378 if (SpNode && (!PvNode || value >= beta))
1379 sp->stopRequest = true;
1381 if (PvNode && value < beta) // We want always alpha < beta
1388 if (value == value_mate_in(ply + 1))
1389 ss->mateKiller = move;
1391 ss->bestMove = move;
1394 sp->parentSstack->bestMove = move;
1398 // Step 18. Check for split
1400 && depth >= ThreadsMgr.min_split_depth()
1401 && ThreadsMgr.active_threads() > 1
1403 && ThreadsMgr.available_thread_exists(threadID)
1405 && !ThreadsMgr.thread_should_stop(threadID)
1407 ThreadsMgr.split<FakeSplit>(pos, ss, ply, &alpha, beta, &bestValue, depth,
1408 threatMove, mateThreat, moveCount, &mp, PvNode);
1411 // Step 19. Check for mate and stalemate
1412 // All legal moves have been searched and if there are
1413 // no legal moves, it must be mate or stalemate.
1414 // If one move was excluded return fail low score.
1415 if (!SpNode && !moveCount)
1416 return excludedMove ? oldAlpha : isCheck ? value_mated_in(ply) : VALUE_DRAW;
1418 // Step 20. Update tables
1419 // If the search is not aborted, update the transposition table,
1420 // history counters, and killer moves.
1421 if (!SpNode && !AbortSearch && !ThreadsMgr.thread_should_stop(threadID))
1423 move = bestValue <= oldAlpha ? MOVE_NONE : ss->bestMove;
1424 vt = bestValue <= oldAlpha ? VALUE_TYPE_UPPER
1425 : bestValue >= beta ? VALUE_TYPE_LOWER : VALUE_TYPE_EXACT;
1427 TT.store(posKey, value_to_tt(bestValue, ply), vt, depth, move, ss->eval, ss->evalMargin);
1429 // Update killers and history only for non capture moves that fails high
1430 if ( bestValue >= beta
1431 && !pos.move_is_capture_or_promotion(move))
1433 update_history(pos, move, depth, movesSearched, moveCount);
1434 update_killers(move, ss);
1440 // Here we have the lock still grabbed
1441 sp->slaves[threadID] = 0;
1442 sp->nodes += pos.nodes_searched();
1443 lock_release(&(sp->lock));
1446 assert(bestValue > -VALUE_INFINITE && bestValue < VALUE_INFINITE);
1452 // qsearch() is the quiescence search function, which is called by the main
1453 // search function when the remaining depth is zero (or, to be more precise,
1454 // less than ONE_PLY).
1456 template <NodeType PvNode>
1457 Value qsearch(Position& pos, SearchStack* ss, Value alpha, Value beta, Depth depth, int ply) {
1459 assert(alpha >= -VALUE_INFINITE && alpha <= VALUE_INFINITE);
1460 assert(beta >= -VALUE_INFINITE && beta <= VALUE_INFINITE);
1461 assert(PvNode || alpha == beta - 1);
1463 assert(ply > 0 && ply < PLY_MAX);
1464 assert(pos.thread() >= 0 && pos.thread() < ThreadsMgr.active_threads());
1468 Value bestValue, value, evalMargin, futilityValue, futilityBase;
1469 bool isCheck, deepChecks, enoughMaterial, moveIsCheck, evasionPrunable;
1471 Value oldAlpha = alpha;
1473 ss->bestMove = ss->currentMove = MOVE_NONE;
1475 // Check for an instant draw or maximum ply reached
1476 if (pos.is_draw() || ply >= PLY_MAX - 1)
1479 // Transposition table lookup. At PV nodes, we don't use the TT for
1480 // pruning, but only for move ordering.
1481 tte = TT.retrieve(pos.get_key());
1482 ttMove = (tte ? tte->move() : MOVE_NONE);
1484 if (!PvNode && tte && ok_to_use_TT(tte, depth, beta, ply))
1486 ss->bestMove = ttMove; // Can be MOVE_NONE
1487 return value_from_tt(tte->value(), ply);
1490 isCheck = pos.is_check();
1492 // Evaluate the position statically
1495 bestValue = futilityBase = -VALUE_INFINITE;
1496 ss->eval = evalMargin = VALUE_NONE;
1497 deepChecks = enoughMaterial = false;
1503 assert(tte->static_value() != VALUE_NONE);
1505 evalMargin = tte->static_value_margin();
1506 ss->eval = bestValue = tte->static_value();
1509 ss->eval = bestValue = evaluate(pos, evalMargin);
1511 update_gains(pos, (ss-1)->currentMove, (ss-1)->eval, ss->eval);
1513 // Stand pat. Return immediately if static value is at least beta
1514 if (bestValue >= beta)
1517 TT.store(pos.get_key(), value_to_tt(bestValue, ply), VALUE_TYPE_LOWER, DEPTH_NONE, MOVE_NONE, ss->eval, evalMargin);
1522 if (PvNode && bestValue > alpha)
1525 // If we are near beta then try to get a cutoff pushing checks a bit further
1526 deepChecks = (depth == -ONE_PLY && bestValue >= beta - PawnValueMidgame / 8);
1528 // Futility pruning parameters, not needed when in check
1529 futilityBase = ss->eval + evalMargin + FutilityMarginQS;
1530 enoughMaterial = pos.non_pawn_material(pos.side_to_move()) > RookValueMidgame;
1533 // Initialize a MovePicker object for the current position, and prepare
1534 // to search the moves. Because the depth is <= 0 here, only captures,
1535 // queen promotions and checks (only if depth == 0 or depth == -ONE_PLY
1536 // and we are near beta) will be generated.
1537 MovePicker mp = MovePicker(pos, ttMove, deepChecks ? DEPTH_ZERO : depth, H);
1540 // Loop through the moves until no moves remain or a beta cutoff occurs
1541 while ( alpha < beta
1542 && (move = mp.get_next_move()) != MOVE_NONE)
1544 assert(move_is_ok(move));
1546 moveIsCheck = pos.move_is_check(move, ci);
1554 && !move_is_promotion(move)
1555 && !pos.move_is_passed_pawn_push(move))
1557 futilityValue = futilityBase
1558 + pos.endgame_value_of_piece_on(move_to(move))
1559 + (move_is_ep(move) ? PawnValueEndgame : VALUE_ZERO);
1561 if (futilityValue < alpha)
1563 if (futilityValue > bestValue)
1564 bestValue = futilityValue;
1569 // Detect non-capture evasions that are candidate to be pruned
1570 evasionPrunable = isCheck
1571 && bestValue > value_mated_in(PLY_MAX)
1572 && !pos.move_is_capture(move)
1573 && !pos.can_castle(pos.side_to_move());
1575 // Don't search moves with negative SEE values
1577 && (!isCheck || evasionPrunable)
1579 && !move_is_promotion(move)
1580 && pos.see_sign(move) < 0)
1583 // Update current move
1584 ss->currentMove = move;
1586 // Make and search the move
1587 pos.do_move(move, st, ci, moveIsCheck);
1588 value = -qsearch<PvNode>(pos, ss+1, -beta, -alpha, depth-ONE_PLY, ply+1);
1589 pos.undo_move(move);
1591 assert(value > -VALUE_INFINITE && value < VALUE_INFINITE);
1594 if (value > bestValue)
1600 ss->bestMove = move;
1605 // All legal moves have been searched. A special case: If we're in check
1606 // and no legal moves were found, it is checkmate.
1607 if (isCheck && bestValue == -VALUE_INFINITE)
1608 return value_mated_in(ply);
1610 // Update transposition table
1611 Depth d = (depth == DEPTH_ZERO ? DEPTH_ZERO : DEPTH_ZERO - ONE_PLY);
1612 ValueType vt = (bestValue <= oldAlpha ? VALUE_TYPE_UPPER : bestValue >= beta ? VALUE_TYPE_LOWER : VALUE_TYPE_EXACT);
1613 TT.store(pos.get_key(), value_to_tt(bestValue, ply), vt, d, ss->bestMove, ss->eval, evalMargin);
1615 assert(bestValue > -VALUE_INFINITE && bestValue < VALUE_INFINITE);
1621 // connected_moves() tests whether two moves are 'connected' in the sense
1622 // that the first move somehow made the second move possible (for instance
1623 // if the moving piece is the same in both moves). The first move is assumed
1624 // to be the move that was made to reach the current position, while the
1625 // second move is assumed to be a move from the current position.
1627 bool connected_moves(const Position& pos, Move m1, Move m2) {
1629 Square f1, t1, f2, t2;
1632 assert(move_is_ok(m1));
1633 assert(move_is_ok(m2));
1635 if (m2 == MOVE_NONE)
1638 // Case 1: The moving piece is the same in both moves
1644 // Case 2: The destination square for m2 was vacated by m1
1650 // Case 3: Moving through the vacated square
1651 if ( piece_is_slider(pos.piece_on(f2))
1652 && bit_is_set(squares_between(f2, t2), f1))
1655 // Case 4: The destination square for m2 is defended by the moving piece in m1
1656 p = pos.piece_on(t1);
1657 if (bit_is_set(pos.attacks_from(p, t1), t2))
1660 // Case 5: Discovered check, checking piece is the piece moved in m1
1661 if ( piece_is_slider(p)
1662 && bit_is_set(squares_between(t1, pos.king_square(pos.side_to_move())), f2)
1663 && !bit_is_set(squares_between(t1, pos.king_square(pos.side_to_move())), t2))
1665 // discovered_check_candidates() works also if the Position's side to
1666 // move is the opposite of the checking piece.
1667 Color them = opposite_color(pos.side_to_move());
1668 Bitboard dcCandidates = pos.discovered_check_candidates(them);
1670 if (bit_is_set(dcCandidates, f2))
1677 // value_is_mate() checks if the given value is a mate one eventually
1678 // compensated for the ply.
1680 bool value_is_mate(Value value) {
1682 assert(abs(value) <= VALUE_INFINITE);
1684 return value <= value_mated_in(PLY_MAX)
1685 || value >= value_mate_in(PLY_MAX);
1689 // value_to_tt() adjusts a mate score from "plies to mate from the root" to
1690 // "plies to mate from the current ply". Non-mate scores are unchanged.
1691 // The function is called before storing a value to the transposition table.
1693 Value value_to_tt(Value v, int ply) {
1695 if (v >= value_mate_in(PLY_MAX))
1698 if (v <= value_mated_in(PLY_MAX))
1705 // value_from_tt() is the inverse of value_to_tt(): It adjusts a mate score from
1706 // the transposition table to a mate score corrected for the current ply.
1708 Value value_from_tt(Value v, int ply) {
1710 if (v >= value_mate_in(PLY_MAX))
1713 if (v <= value_mated_in(PLY_MAX))
1720 // extension() decides whether a move should be searched with normal depth,
1721 // or with extended depth. Certain classes of moves (checking moves, in
1722 // particular) are searched with bigger depth than ordinary moves and in
1723 // any case are marked as 'dangerous'. Note that also if a move is not
1724 // extended, as example because the corresponding UCI option is set to zero,
1725 // the move is marked as 'dangerous' so, at least, we avoid to prune it.
1726 template <NodeType PvNode>
1727 Depth extension(const Position& pos, Move m, bool captureOrPromotion, bool moveIsCheck,
1728 bool singleEvasion, bool mateThreat, bool* dangerous) {
1730 assert(m != MOVE_NONE);
1732 Depth result = DEPTH_ZERO;
1733 *dangerous = moveIsCheck | singleEvasion | mateThreat;
1737 if (moveIsCheck && pos.see_sign(m) >= 0)
1738 result += CheckExtension[PvNode];
1741 result += SingleEvasionExtension[PvNode];
1744 result += MateThreatExtension[PvNode];
1747 if (pos.type_of_piece_on(move_from(m)) == PAWN)
1749 Color c = pos.side_to_move();
1750 if (relative_rank(c, move_to(m)) == RANK_7)
1752 result += PawnPushTo7thExtension[PvNode];
1755 if (pos.pawn_is_passed(c, move_to(m)))
1757 result += PassedPawnExtension[PvNode];
1762 if ( captureOrPromotion
1763 && pos.type_of_piece_on(move_to(m)) != PAWN
1764 && ( pos.non_pawn_material(WHITE) + pos.non_pawn_material(BLACK)
1765 - pos.midgame_value_of_piece_on(move_to(m)) == VALUE_ZERO)
1766 && !move_is_promotion(m)
1769 result += PawnEndgameExtension[PvNode];
1774 && captureOrPromotion
1775 && pos.type_of_piece_on(move_to(m)) != PAWN
1776 && pos.see_sign(m) >= 0)
1778 result += ONE_PLY / 2;
1782 return Min(result, ONE_PLY);
1786 // connected_threat() tests whether it is safe to forward prune a move or if
1787 // is somehow coonected to the threat move returned by null search.
1789 bool connected_threat(const Position& pos, Move m, Move threat) {
1791 assert(move_is_ok(m));
1792 assert(threat && move_is_ok(threat));
1793 assert(!pos.move_is_check(m));
1794 assert(!pos.move_is_capture_or_promotion(m));
1795 assert(!pos.move_is_passed_pawn_push(m));
1797 Square mfrom, mto, tfrom, tto;
1799 mfrom = move_from(m);
1801 tfrom = move_from(threat);
1802 tto = move_to(threat);
1804 // Case 1: Don't prune moves which move the threatened piece
1808 // Case 2: If the threatened piece has value less than or equal to the
1809 // value of the threatening piece, don't prune move which defend it.
1810 if ( pos.move_is_capture(threat)
1811 && ( pos.midgame_value_of_piece_on(tfrom) >= pos.midgame_value_of_piece_on(tto)
1812 || pos.type_of_piece_on(tfrom) == KING)
1813 && pos.move_attacks_square(m, tto))
1816 // Case 3: If the moving piece in the threatened move is a slider, don't
1817 // prune safe moves which block its ray.
1818 if ( piece_is_slider(pos.piece_on(tfrom))
1819 && bit_is_set(squares_between(tfrom, tto), mto)
1820 && pos.see_sign(m) >= 0)
1827 // ok_to_use_TT() returns true if a transposition table score
1828 // can be used at a given point in search.
1830 bool ok_to_use_TT(const TTEntry* tte, Depth depth, Value beta, int ply) {
1832 Value v = value_from_tt(tte->value(), ply);
1834 return ( tte->depth() >= depth
1835 || v >= Max(value_mate_in(PLY_MAX), beta)
1836 || v < Min(value_mated_in(PLY_MAX), beta))
1838 && ( ((tte->type() & VALUE_TYPE_LOWER) && v >= beta)
1839 || ((tte->type() & VALUE_TYPE_UPPER) && v < beta));
1843 // refine_eval() returns the transposition table score if
1844 // possible otherwise falls back on static position evaluation.
1846 Value refine_eval(const TTEntry* tte, Value defaultEval, int ply) {
1850 Value v = value_from_tt(tte->value(), ply);
1852 if ( ((tte->type() & VALUE_TYPE_LOWER) && v >= defaultEval)
1853 || ((tte->type() & VALUE_TYPE_UPPER) && v < defaultEval))
1860 // update_history() registers a good move that produced a beta-cutoff
1861 // in history and marks as failures all the other moves of that ply.
1863 void update_history(const Position& pos, Move move, Depth depth,
1864 Move movesSearched[], int moveCount) {
1867 H.success(pos.piece_on(move_from(move)), move_to(move), depth);
1869 for (int i = 0; i < moveCount - 1; i++)
1871 m = movesSearched[i];
1875 if (!pos.move_is_capture_or_promotion(m))
1876 H.failure(pos.piece_on(move_from(m)), move_to(m), depth);
1881 // update_killers() add a good move that produced a beta-cutoff
1882 // among the killer moves of that ply.
1884 void update_killers(Move m, SearchStack* ss) {
1886 if (m == ss->killers[0])
1889 ss->killers[1] = ss->killers[0];
1894 // update_gains() updates the gains table of a non-capture move given
1895 // the static position evaluation before and after the move.
1897 void update_gains(const Position& pos, Move m, Value before, Value after) {
1900 && before != VALUE_NONE
1901 && after != VALUE_NONE
1902 && pos.captured_piece_type() == PIECE_TYPE_NONE
1903 && !move_is_special(m))
1904 H.set_gain(pos.piece_on(move_to(m)), move_to(m), -(before + after));
1908 // current_search_time() returns the number of milliseconds which have passed
1909 // since the beginning of the current search.
1911 int current_search_time() {
1913 return get_system_time() - SearchStartTime;
1917 // value_to_uci() converts a value to a string suitable for use with the UCI protocol
1919 std::string value_to_uci(Value v) {
1921 std::stringstream s;
1923 if (abs(v) < VALUE_MATE - PLY_MAX * ONE_PLY)
1924 s << "cp " << int(v) * 100 / int(PawnValueMidgame); // Scale to pawn = 100
1926 s << "mate " << (v > 0 ? (VALUE_MATE - v + 1) / 2 : -(VALUE_MATE + v) / 2 );
1931 // nps() computes the current nodes/second count.
1933 int nps(const Position& pos) {
1935 int t = current_search_time();
1936 return (t > 0 ? int((pos.nodes_searched() * 1000) / t) : 0);
1940 // poll() performs two different functions: It polls for user input, and it
1941 // looks at the time consumed so far and decides if it's time to abort the
1944 void poll(const Position& pos) {
1946 static int lastInfoTime;
1947 int t = current_search_time();
1950 if (data_available())
1952 // We are line oriented, don't read single chars
1953 std::string command;
1955 if (!std::getline(std::cin, command))
1958 if (command == "quit")
1961 PonderSearch = false;
1965 else if (command == "stop")
1968 PonderSearch = false;
1970 else if (command == "ponderhit")
1974 // Print search information
1978 else if (lastInfoTime > t)
1979 // HACK: Must be a new search where we searched less than
1980 // NodesBetweenPolls nodes during the first second of search.
1983 else if (t - lastInfoTime >= 1000)
1990 if (dbg_show_hit_rate)
1991 dbg_print_hit_rate();
1993 cout << "info nodes " << pos.nodes_searched() << " nps " << nps(pos)
1994 << " time " << t << endl;
1997 // Should we stop the search?
2001 bool stillAtFirstMove = FirstRootMove
2002 && !AspirationFailLow
2003 && t > TimeMgr.available_time();
2005 bool noMoreTime = t > TimeMgr.maximum_time()
2006 || stillAtFirstMove;
2008 if ( (Iteration >= 3 && UseTimeManagement && noMoreTime)
2009 || (ExactMaxTime && t >= ExactMaxTime)
2010 || (Iteration >= 3 && MaxNodes && pos.nodes_searched() >= MaxNodes))
2015 // ponderhit() is called when the program is pondering (i.e. thinking while
2016 // it's the opponent's turn to move) in order to let the engine know that
2017 // it correctly predicted the opponent's move.
2021 int t = current_search_time();
2022 PonderSearch = false;
2024 bool stillAtFirstMove = FirstRootMove
2025 && !AspirationFailLow
2026 && t > TimeMgr.available_time();
2028 bool noMoreTime = t > TimeMgr.maximum_time()
2029 || stillAtFirstMove;
2031 if (Iteration >= 3 && UseTimeManagement && (noMoreTime || StopOnPonderhit))
2036 // init_ss_array() does a fast reset of the first entries of a SearchStack
2037 // array and of all the excludedMove and skipNullMove entries.
2039 void init_ss_array(SearchStack* ss, int size) {
2041 for (int i = 0; i < size; i++, ss++)
2043 ss->excludedMove = MOVE_NONE;
2044 ss->skipNullMove = false;
2045 ss->reduction = DEPTH_ZERO;
2049 ss->killers[0] = ss->killers[1] = ss->mateKiller = MOVE_NONE;
2054 // wait_for_stop_or_ponderhit() is called when the maximum depth is reached
2055 // while the program is pondering. The point is to work around a wrinkle in
2056 // the UCI protocol: When pondering, the engine is not allowed to give a
2057 // "bestmove" before the GUI sends it a "stop" or "ponderhit" command.
2058 // We simply wait here until one of these commands is sent, and return,
2059 // after which the bestmove and pondermove will be printed (in id_loop()).
2061 void wait_for_stop_or_ponderhit() {
2063 std::string command;
2067 if (!std::getline(std::cin, command))
2070 if (command == "quit")
2075 else if (command == "ponderhit" || command == "stop")
2081 // print_pv_info() prints to standard output and eventually to log file information on
2082 // the current PV line. It is called at each iteration or after a new pv is found.
2084 void print_pv_info(const Position& pos, Move pv[], Value alpha, Value beta, Value value) {
2086 cout << "info depth " << Iteration
2087 << " score " << value_to_uci(value)
2088 << (value >= beta ? " lowerbound" : value <= alpha ? " upperbound" : "")
2089 << " time " << current_search_time()
2090 << " nodes " << pos.nodes_searched()
2091 << " nps " << nps(pos)
2094 for (Move* m = pv; *m != MOVE_NONE; m++)
2101 ValueType t = value >= beta ? VALUE_TYPE_LOWER :
2102 value <= alpha ? VALUE_TYPE_UPPER : VALUE_TYPE_EXACT;
2104 LogFile << pretty_pv(pos, current_search_time(), Iteration, value, t, pv) << endl;
2109 // insert_pv_in_tt() is called at the end of a search iteration, and inserts
2110 // the PV back into the TT. This makes sure the old PV moves are searched
2111 // first, even if the old TT entries have been overwritten.
2113 void insert_pv_in_tt(const Position& pos, Move pv[]) {
2117 Position p(pos, pos.thread());
2118 Value v, m = VALUE_NONE;
2120 for (int i = 0; pv[i] != MOVE_NONE; i++)
2122 tte = TT.retrieve(p.get_key());
2123 if (!tte || tte->move() != pv[i])
2125 v = (p.is_check() ? VALUE_NONE : evaluate(p, m));
2126 TT.store(p.get_key(), VALUE_NONE, VALUE_TYPE_NONE, DEPTH_NONE, pv[i], v, m);
2128 p.do_move(pv[i], st);
2133 // extract_pv_from_tt() builds a PV by adding moves from the transposition table.
2134 // We consider also failing high nodes and not only VALUE_TYPE_EXACT nodes. This
2135 // allow to always have a ponder move even when we fail high at root and also a
2136 // long PV to print that is important for position analysis.
2138 void extract_pv_from_tt(const Position& pos, Move bestMove, Move pv[]) {
2142 Position p(pos, pos.thread());
2145 assert(bestMove != MOVE_NONE);
2148 p.do_move(pv[ply++], st);
2150 while ( (tte = TT.retrieve(p.get_key())) != NULL
2151 && tte->move() != MOVE_NONE
2152 && move_is_legal(p, tte->move())
2154 && (!p.is_draw() || ply < 2))
2156 pv[ply] = tte->move();
2157 p.do_move(pv[ply++], st);
2159 pv[ply] = MOVE_NONE;
2163 // init_thread() is the function which is called when a new thread is
2164 // launched. It simply calls the idle_loop() function with the supplied
2165 // threadID. There are two versions of this function; one for POSIX
2166 // threads and one for Windows threads.
2168 #if !defined(_MSC_VER)
2170 void* init_thread(void* threadID) {
2172 ThreadsMgr.idle_loop(*(int*)threadID, NULL);
2178 DWORD WINAPI init_thread(LPVOID threadID) {
2180 ThreadsMgr.idle_loop(*(int*)threadID, NULL);
2187 /// The ThreadsManager class
2190 // read_uci_options() updates number of active threads and other internal
2191 // parameters according to the UCI options values. It is called before
2192 // to start a new search.
2194 void ThreadsManager::read_uci_options() {
2196 maxThreadsPerSplitPoint = Options["Maximum Number of Threads per Split Point"].value<int>();
2197 minimumSplitDepth = Options["Minimum Split Depth"].value<int>() * ONE_PLY;
2198 useSleepingThreads = Options["Use Sleeping Threads"].value<bool>();
2199 activeThreads = Options["Threads"].value<int>();
2203 // idle_loop() is where the threads are parked when they have no work to do.
2204 // The parameter 'sp', if non-NULL, is a pointer to an active SplitPoint
2205 // object for which the current thread is the master.
2207 void ThreadsManager::idle_loop(int threadID, SplitPoint* sp) {
2209 assert(threadID >= 0 && threadID < MAX_THREADS);
2212 bool allFinished = false;
2216 // Slave threads can exit as soon as AllThreadsShouldExit raises,
2217 // master should exit as last one.
2218 if (allThreadsShouldExit)
2221 threads[threadID].state = THREAD_TERMINATED;
2225 // If we are not thinking, wait for a condition to be signaled
2226 // instead of wasting CPU time polling for work.
2227 while ( threadID >= activeThreads || threads[threadID].state == THREAD_INITIALIZING
2228 || (useSleepingThreads && threads[threadID].state == THREAD_AVAILABLE))
2230 assert(!sp || useSleepingThreads);
2231 assert(threadID != 0 || useSleepingThreads);
2233 if (threads[threadID].state == THREAD_INITIALIZING)
2234 threads[threadID].state = THREAD_AVAILABLE;
2236 // Grab the lock to avoid races with wake_sleeping_thread()
2237 lock_grab(&sleepLock[threadID]);
2239 // If we are master and all slaves have finished do not go to sleep
2240 for (i = 0; sp && i < activeThreads && !sp->slaves[i]; i++) {}
2241 allFinished = (i == activeThreads);
2243 if (allFinished || allThreadsShouldExit)
2245 lock_release(&sleepLock[threadID]);
2249 // Do sleep here after retesting sleep conditions
2250 if (threadID >= activeThreads || threads[threadID].state == THREAD_AVAILABLE)
2251 cond_wait(&sleepCond[threadID], &sleepLock[threadID]);
2253 lock_release(&sleepLock[threadID]);
2256 // If this thread has been assigned work, launch a search
2257 if (threads[threadID].state == THREAD_WORKISWAITING)
2259 assert(!allThreadsShouldExit);
2261 threads[threadID].state = THREAD_SEARCHING;
2263 // Here we call search() with SplitPoint template parameter set to true
2264 SplitPoint* tsp = threads[threadID].splitPoint;
2265 Position pos(*tsp->pos, threadID);
2266 SearchStack* ss = tsp->sstack[threadID] + 1;
2270 search<PV, true>(pos, ss, tsp->alpha, tsp->beta, tsp->depth, tsp->ply);
2272 search<NonPV, true>(pos, ss, tsp->alpha, tsp->beta, tsp->depth, tsp->ply);
2274 assert(threads[threadID].state == THREAD_SEARCHING);
2276 threads[threadID].state = THREAD_AVAILABLE;
2278 // Wake up master thread so to allow it to return from the idle loop in
2279 // case we are the last slave of the split point.
2280 if (useSleepingThreads && threadID != tsp->master && threads[tsp->master].state == THREAD_AVAILABLE)
2281 wake_sleeping_thread(tsp->master);
2284 // If this thread is the master of a split point and all slaves have
2285 // finished their work at this split point, return from the idle loop.
2286 for (i = 0; sp && i < activeThreads && !sp->slaves[i]; i++) {}
2287 allFinished = (i == activeThreads);
2291 // Because sp->slaves[] is reset under lock protection,
2292 // be sure sp->lock has been released before to return.
2293 lock_grab(&(sp->lock));
2294 lock_release(&(sp->lock));
2296 // In helpful master concept a master can help only a sub-tree, and
2297 // because here is all finished is not possible master is booked.
2298 assert(threads[threadID].state == THREAD_AVAILABLE);
2300 threads[threadID].state = THREAD_SEARCHING;
2307 // init_threads() is called during startup. It launches all helper threads,
2308 // and initializes the split point stack and the global locks and condition
2311 void ThreadsManager::init_threads() {
2313 int i, arg[MAX_THREADS];
2316 // Initialize global locks
2319 for (i = 0; i < MAX_THREADS; i++)
2321 lock_init(&sleepLock[i]);
2322 cond_init(&sleepCond[i]);
2325 // Initialize splitPoints[] locks
2326 for (i = 0; i < MAX_THREADS; i++)
2327 for (int j = 0; j < MAX_ACTIVE_SPLIT_POINTS; j++)
2328 lock_init(&(threads[i].splitPoints[j].lock));
2330 // Will be set just before program exits to properly end the threads
2331 allThreadsShouldExit = false;
2333 // Threads will be put all threads to sleep as soon as created
2336 // All threads except the main thread should be initialized to THREAD_INITIALIZING
2337 threads[0].state = THREAD_SEARCHING;
2338 for (i = 1; i < MAX_THREADS; i++)
2339 threads[i].state = THREAD_INITIALIZING;
2341 // Launch the helper threads
2342 for (i = 1; i < MAX_THREADS; i++)
2346 #if !defined(_MSC_VER)
2347 pthread_t pthread[1];
2348 ok = (pthread_create(pthread, NULL, init_thread, (void*)(&arg[i])) == 0);
2349 pthread_detach(pthread[0]);
2351 ok = (CreateThread(NULL, 0, init_thread, (LPVOID)(&arg[i]), 0, NULL) != NULL);
2355 cout << "Failed to create thread number " << i << endl;
2359 // Wait until the thread has finished launching and is gone to sleep
2360 while (threads[i].state == THREAD_INITIALIZING) {}
2365 // exit_threads() is called when the program exits. It makes all the
2366 // helper threads exit cleanly.
2368 void ThreadsManager::exit_threads() {
2370 allThreadsShouldExit = true; // Let the woken up threads to exit idle_loop()
2372 // Wake up all the threads and waits for termination
2373 for (int i = 1; i < MAX_THREADS; i++)
2375 wake_sleeping_thread(i);
2376 while (threads[i].state != THREAD_TERMINATED) {}
2379 // Now we can safely destroy the locks
2380 for (int i = 0; i < MAX_THREADS; i++)
2381 for (int j = 0; j < MAX_ACTIVE_SPLIT_POINTS; j++)
2382 lock_destroy(&(threads[i].splitPoints[j].lock));
2384 lock_destroy(&mpLock);
2386 // Now we can safely destroy the wait conditions
2387 for (int i = 0; i < MAX_THREADS; i++)
2389 lock_destroy(&sleepLock[i]);
2390 cond_destroy(&sleepCond[i]);
2395 // thread_should_stop() checks whether the thread should stop its search.
2396 // This can happen if a beta cutoff has occurred in the thread's currently
2397 // active split point, or in some ancestor of the current split point.
2399 bool ThreadsManager::thread_should_stop(int threadID) const {
2401 assert(threadID >= 0 && threadID < activeThreads);
2403 SplitPoint* sp = threads[threadID].splitPoint;
2405 for ( ; sp && !sp->stopRequest; sp = sp->parent) {}
2410 // thread_is_available() checks whether the thread with threadID "slave" is
2411 // available to help the thread with threadID "master" at a split point. An
2412 // obvious requirement is that "slave" must be idle. With more than two
2413 // threads, this is not by itself sufficient: If "slave" is the master of
2414 // some active split point, it is only available as a slave to the other
2415 // threads which are busy searching the split point at the top of "slave"'s
2416 // split point stack (the "helpful master concept" in YBWC terminology).
2418 bool ThreadsManager::thread_is_available(int slave, int master) const {
2420 assert(slave >= 0 && slave < activeThreads);
2421 assert(master >= 0 && master < activeThreads);
2422 assert(activeThreads > 1);
2424 if (threads[slave].state != THREAD_AVAILABLE || slave == master)
2427 // Make a local copy to be sure doesn't change under our feet
2428 int localActiveSplitPoints = threads[slave].activeSplitPoints;
2430 // No active split points means that the thread is available as
2431 // a slave for any other thread.
2432 if (localActiveSplitPoints == 0 || activeThreads == 2)
2435 // Apply the "helpful master" concept if possible. Use localActiveSplitPoints
2436 // that is known to be > 0, instead of threads[slave].activeSplitPoints that
2437 // could have been set to 0 by another thread leading to an out of bound access.
2438 if (threads[slave].splitPoints[localActiveSplitPoints - 1].slaves[master])
2445 // available_thread_exists() tries to find an idle thread which is available as
2446 // a slave for the thread with threadID "master".
2448 bool ThreadsManager::available_thread_exists(int master) const {
2450 assert(master >= 0 && master < activeThreads);
2451 assert(activeThreads > 1);
2453 for (int i = 0; i < activeThreads; i++)
2454 if (thread_is_available(i, master))
2461 // split() does the actual work of distributing the work at a node between
2462 // several available threads. If it does not succeed in splitting the
2463 // node (because no idle threads are available, or because we have no unused
2464 // split point objects), the function immediately returns. If splitting is
2465 // possible, a SplitPoint object is initialized with all the data that must be
2466 // copied to the helper threads and we tell our helper threads that they have
2467 // been assigned work. This will cause them to instantly leave their idle loops and
2468 // call search().When all threads have returned from search() then split() returns.
2470 template <bool Fake>
2471 void ThreadsManager::split(Position& pos, SearchStack* ss, int ply, Value* alpha,
2472 const Value beta, Value* bestValue, Depth depth, Move threatMove,
2473 bool mateThreat, int moveCount, MovePicker* mp, bool pvNode) {
2474 assert(pos.is_ok());
2475 assert(ply > 0 && ply < PLY_MAX);
2476 assert(*bestValue >= -VALUE_INFINITE);
2477 assert(*bestValue <= *alpha);
2478 assert(*alpha < beta);
2479 assert(beta <= VALUE_INFINITE);
2480 assert(depth > DEPTH_ZERO);
2481 assert(pos.thread() >= 0 && pos.thread() < activeThreads);
2482 assert(activeThreads > 1);
2484 int i, master = pos.thread();
2485 Thread& masterThread = threads[master];
2489 // If no other thread is available to help us, or if we have too many
2490 // active split points, don't split.
2491 if ( !available_thread_exists(master)
2492 || masterThread.activeSplitPoints >= MAX_ACTIVE_SPLIT_POINTS)
2494 lock_release(&mpLock);
2498 // Pick the next available split point object from the split point stack
2499 SplitPoint& splitPoint = masterThread.splitPoints[masterThread.activeSplitPoints++];
2501 // Initialize the split point object
2502 splitPoint.parent = masterThread.splitPoint;
2503 splitPoint.master = master;
2504 splitPoint.stopRequest = false;
2505 splitPoint.ply = ply;
2506 splitPoint.depth = depth;
2507 splitPoint.threatMove = threatMove;
2508 splitPoint.mateThreat = mateThreat;
2509 splitPoint.alpha = *alpha;
2510 splitPoint.beta = beta;
2511 splitPoint.pvNode = pvNode;
2512 splitPoint.bestValue = *bestValue;
2514 splitPoint.moveCount = moveCount;
2515 splitPoint.pos = &pos;
2516 splitPoint.nodes = 0;
2517 splitPoint.parentSstack = ss;
2518 for (i = 0; i < activeThreads; i++)
2519 splitPoint.slaves[i] = 0;
2521 masterThread.splitPoint = &splitPoint;
2523 // If we are here it means we are not available
2524 assert(masterThread.state != THREAD_AVAILABLE);
2526 int workersCnt = 1; // At least the master is included
2528 // Allocate available threads setting state to THREAD_BOOKED
2529 for (i = 0; !Fake && i < activeThreads && workersCnt < maxThreadsPerSplitPoint; i++)
2530 if (thread_is_available(i, master))
2532 threads[i].state = THREAD_BOOKED;
2533 threads[i].splitPoint = &splitPoint;
2534 splitPoint.slaves[i] = 1;
2538 assert(Fake || workersCnt > 1);
2540 // We can release the lock because slave threads are already booked and master is not available
2541 lock_release(&mpLock);
2543 // Tell the threads that they have work to do. This will make them leave
2544 // their idle loop. But before copy search stack tail for each thread.
2545 for (i = 0; i < activeThreads; i++)
2546 if (i == master || splitPoint.slaves[i])
2548 memcpy(splitPoint.sstack[i], ss - 1, 4 * sizeof(SearchStack));
2550 assert(i == master || threads[i].state == THREAD_BOOKED);
2552 threads[i].state = THREAD_WORKISWAITING; // This makes the slave to exit from idle_loop()
2554 if (useSleepingThreads && i != master)
2555 wake_sleeping_thread(i);
2558 // Everything is set up. The master thread enters the idle loop, from
2559 // which it will instantly launch a search, because its state is
2560 // THREAD_WORKISWAITING. We send the split point as a second parameter to the
2561 // idle loop, which means that the main thread will return from the idle
2562 // loop when all threads have finished their work at this split point.
2563 idle_loop(master, &splitPoint);
2565 // We have returned from the idle loop, which means that all threads are
2566 // finished. Update alpha and bestValue, and return.
2569 *alpha = splitPoint.alpha;
2570 *bestValue = splitPoint.bestValue;
2571 masterThread.activeSplitPoints--;
2572 masterThread.splitPoint = splitPoint.parent;
2573 pos.set_nodes_searched(pos.nodes_searched() + splitPoint.nodes);
2575 lock_release(&mpLock);
2579 // wake_sleeping_thread() wakes up the thread with the given threadID
2580 // when it is time to start a new search.
2582 void ThreadsManager::wake_sleeping_thread(int threadID) {
2584 lock_grab(&sleepLock[threadID]);
2585 cond_signal(&sleepCond[threadID]);
2586 lock_release(&sleepLock[threadID]);
2590 /// The RootMoveList class
2592 // RootMoveList c'tor
2594 RootMoveList::RootMoveList(Position& pos, Move searchMoves[]) {
2596 SearchStack ss[PLY_MAX_PLUS_2];
2597 MoveStack mlist[MOVES_MAX];
2599 bool includeAllMoves = (searchMoves[0] == MOVE_NONE);
2601 // Initialize search stack
2602 init_ss_array(ss, PLY_MAX_PLUS_2);
2603 ss[0].eval = ss[0].evalMargin = VALUE_NONE;
2606 // Generate all legal moves
2607 MoveStack* last = generate_moves(pos, mlist);
2609 // Add each move to the moves[] array
2610 for (MoveStack* cur = mlist; cur != last; cur++)
2612 bool includeMove = includeAllMoves;
2614 for (int k = 0; !includeMove && searchMoves[k] != MOVE_NONE; k++)
2615 includeMove = (searchMoves[k] == cur->move);
2620 // Find a quick score for the move
2621 moves[count].move = ss[0].currentMove = moves[count].pv[0] = cur->move;
2622 moves[count].pv[1] = MOVE_NONE;
2623 pos.do_move(cur->move, st);
2624 moves[count].score = -qsearch<PV>(pos, ss+1, -VALUE_INFINITE, VALUE_INFINITE, DEPTH_ZERO, 1);
2625 pos.undo_move(cur->move);
2631 // Score root moves using the standard way used in main search, the moves
2632 // are scored according to the order in which are returned by MovePicker.
2634 void RootMoveList::score_moves(const Position& pos)
2638 MovePicker mp = MovePicker(pos, MOVE_NONE, ONE_PLY, H);
2640 while ((move = mp.get_next_move()) != MOVE_NONE)
2641 for (int i = 0; i < count; i++)
2642 if (moves[i].move == move)
2644 moves[i].mp_score = score--;
2649 // RootMoveList simple methods definitions
2651 void RootMoveList::set_move_pv(int moveNum, const Move pv[]) {
2655 for (j = 0; pv[j] != MOVE_NONE; j++)
2656 moves[moveNum].pv[j] = pv[j];
2658 moves[moveNum].pv[j] = MOVE_NONE;
2662 // RootMoveList::sort() sorts the root move list at the beginning of a new
2665 void RootMoveList::sort() {
2667 sort_multipv(count - 1); // Sort all items
2671 // RootMoveList::sort_multipv() sorts the first few moves in the root move
2672 // list by their scores and depths. It is used to order the different PVs
2673 // correctly in MultiPV mode.
2675 void RootMoveList::sort_multipv(int n) {
2679 for (i = 1; i <= n; i++)
2681 RootMove rm = moves[i];
2682 for (j = i; j > 0 && moves[j - 1] < rm; j--)
2683 moves[j] = moves[j - 1];