cd815c2af266e679294ff81ba0f5806f7b548d4a
[stockfish] / src / search.cpp
1 /*
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-2014 Marco Costalba, Joona Kiiski, Tord Romstad
5
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.
10
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.
15
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/>.
18 */
19
20 #include <algorithm>
21 #include <cassert>
22 #include <cfloat>
23 #include <cmath>
24 #include <cstring>
25 #include <iostream>
26 #include <sstream>
27
28 #include "book.h"
29 #include "evaluate.h"
30 #include "movegen.h"
31 #include "movepick.h"
32 #include "notation.h"
33 #include "search.h"
34 #include "timeman.h"
35 #include "thread.h"
36 #include "tt.h"
37 #include "ucioption.h"
38
39 namespace Search {
40
41   volatile SignalsType Signals;
42   LimitsType Limits;
43   std::vector<RootMove> RootMoves;
44   Position RootPos;
45   Color RootColor;
46   Time::point SearchTime;
47   StateStackPtr SetupStates;
48 }
49
50 using std::string;
51 using Eval::evaluate;
52 using namespace Search;
53
54 namespace {
55
56   // Set to true to force running with one thread. Used for debugging
57   const bool FakeSplit = false;
58
59   // Different node types, used as template parameter
60   enum NodeType { Root, PV, NonPV, SplitPointRoot, SplitPointPV, SplitPointNonPV };
61
62   // Dynamic razoring margin based on depth
63   inline Value razor_margin(Depth d) { return Value(512 + 16 * d); }
64
65   // Futility lookup tables (initialized at startup) and their access functions
66   int FutilityMoveCounts[2][32]; // [improving][depth]
67
68   inline Value futility_margin(Depth d) {
69     return Value(100 * d);
70   }
71
72   // Reduction lookup tables (initialized at startup) and their access function
73   int8_t Reductions[2][2][64][64]; // [pv][improving][depth][moveNumber]
74
75   template <bool PvNode> inline Depth reduction(bool i, Depth d, int mn) {
76
77     return (Depth) Reductions[PvNode][i][std::min(int(d) / ONE_PLY, 63)][std::min(mn, 63)];
78   }
79
80   size_t MultiPV, PVIdx;
81   TimeManager TimeMgr;
82   double BestMoveChanges;
83   Value DrawValue[COLOR_NB];
84   HistoryStats History;
85   GainsStats Gains;
86   MovesStats Countermoves, Followupmoves;
87
88   template <NodeType NT>
89   Value search(Position& pos, Stack* ss, Value alpha, Value beta, Depth depth, bool cutNode);
90
91   template <NodeType NT, bool InCheck>
92   Value qsearch(Position& pos, Stack* ss, Value alpha, Value beta, Depth depth);
93
94   void id_loop(Position& pos);
95   Value value_to_tt(Value v, int ply);
96   Value value_from_tt(Value v, int ply);
97   void update_stats(Position& pos, Stack* ss, Move move, Depth depth, Move* quiets, int quietsCnt);
98   string uci_pv(const Position& pos, int depth, Value alpha, Value beta);
99
100   struct Skill {
101     Skill(int l) : level(l), best(MOVE_NONE) {}
102    ~Skill() {
103       if (enabled()) // Swap best PV line with the sub-optimal one
104           std::swap(RootMoves[0], *std::find(RootMoves.begin(),
105                     RootMoves.end(), best ? best : pick_move()));
106     }
107
108     bool enabled() const { return level < 20; }
109     bool time_to_pick(int depth) const { return depth == 1 + level; }
110     Move pick_move();
111
112     int level;
113     Move best;
114   };
115
116 } // namespace
117
118
119 /// Search::init() is called during startup to initialize various lookup tables
120
121 void Search::init() {
122
123   int d;  // depth (ONE_PLY == 2)
124   int hd; // half depth (ONE_PLY == 1)
125   int mc; // moveCount
126
127   // Init reductions array
128   for (hd = 1; hd < 64; ++hd) for (mc = 1; mc < 64; ++mc)
129   {
130       double    pvRed = 0.00 + log(double(hd)) * log(double(mc)) / 3.00;
131       double nonPVRed = 0.33 + log(double(hd)) * log(double(mc)) / 2.25;
132       Reductions[1][1][hd][mc] = int8_t(   pvRed >= 1.0 ?    pvRed * int(ONE_PLY) : 0);
133       Reductions[0][1][hd][mc] = int8_t(nonPVRed >= 1.0 ? nonPVRed * int(ONE_PLY) : 0);
134
135       Reductions[1][0][hd][mc] = Reductions[1][1][hd][mc];
136       Reductions[0][0][hd][mc] = Reductions[0][1][hd][mc];
137
138       if (Reductions[0][0][hd][mc] > 2 * ONE_PLY)
139           Reductions[0][0][hd][mc] += ONE_PLY;
140
141       else if (Reductions[0][0][hd][mc] > 1 * ONE_PLY)
142           Reductions[0][0][hd][mc] += ONE_PLY / 2;
143   }
144
145   // Init futility move count array
146   for (d = 0; d < 32; ++d)
147   {
148       FutilityMoveCounts[0][d] = int(2.4 + 0.222 * pow(d + 0.00, 1.8));
149       FutilityMoveCounts[1][d] = int(3.0 + 0.300 * pow(d + 0.98, 1.8));
150   }
151 }
152
153
154 /// Search::perft() is our utility to verify move generation. All the leaf nodes
155 /// up to the given depth are generated and counted and the sum returned.
156
157 static uint64_t perft(Position& pos, Depth depth) {
158
159   StateInfo st;
160   uint64_t cnt = 0;
161   CheckInfo ci(pos);
162   const bool leaf = depth == 2 * ONE_PLY;
163
164   for (MoveList<LEGAL> it(pos); *it; ++it)
165   {
166       pos.do_move(*it, st, ci, pos.gives_check(*it, ci));
167       cnt += leaf ? MoveList<LEGAL>(pos).size() : ::perft(pos, depth - ONE_PLY);
168       pos.undo_move(*it);
169   }
170   return cnt;
171 }
172
173 uint64_t Search::perft(Position& pos, Depth depth) {
174   return depth > ONE_PLY ? ::perft(pos, depth) : MoveList<LEGAL>(pos).size();
175 }
176
177 /// Search::think() is the external interface to Stockfish's search, and is
178 /// called by the main thread when the program receives the UCI 'go' command. It
179 /// searches from RootPos and at the end prints the "bestmove" to output.
180
181 void Search::think() {
182
183   static PolyglotBook book; // Defined static to initialize the PRNG only once
184
185   RootColor = RootPos.side_to_move();
186   TimeMgr.init(Limits, RootPos.game_ply(), RootColor);
187
188   int cf = Options["Contempt Factor"] * PawnValueEg / 100; // From centipawns
189   DrawValue[ RootColor] = VALUE_DRAW - Value(cf);
190   DrawValue[~RootColor] = VALUE_DRAW + Value(cf);
191
192   if (RootMoves.empty())
193   {
194       RootMoves.push_back(MOVE_NONE);
195       sync_cout << "info depth 0 score "
196                 << score_to_uci(RootPos.checkers() ? -VALUE_MATE : VALUE_DRAW)
197                 << sync_endl;
198
199       goto finalize;
200   }
201
202   if (Options["OwnBook"] && !Limits.infinite && !Limits.mate)
203   {
204       Move bookMove = book.probe(RootPos, Options["Book File"], Options["Best Book Move"]);
205
206       if (bookMove && std::count(RootMoves.begin(), RootMoves.end(), bookMove))
207       {
208           std::swap(RootMoves[0], *std::find(RootMoves.begin(), RootMoves.end(), bookMove));
209           goto finalize;
210       }
211   }
212
213   if (Options["Write Search Log"])
214   {
215       Log log(Options["Search Log Filename"]);
216       log << "\nSearching: "  << RootPos.fen()
217           << "\ninfinite: "   << Limits.infinite
218           << " ponder: "      << Limits.ponder
219           << " time: "        << Limits.time[RootColor]
220           << " increment: "   << Limits.inc[RootColor]
221           << " moves to go: " << Limits.movestogo
222           << "\n" << std::endl;
223   }
224
225   // Reset the threads, still sleeping: will wake up at split time
226   for (size_t i = 0; i < Threads.size(); ++i)
227       Threads[i]->maxPly = 0;
228
229   Threads.sleepWhileIdle = Options["Idle Threads Sleep"];
230   Threads.timer->run = true;
231   Threads.timer->notify_one(); // Wake up the recurring timer
232
233   id_loop(RootPos); // Let's start searching !
234
235   Threads.timer->run = false; // Stop the timer
236   Threads.sleepWhileIdle = true; // Send idle threads to sleep
237
238   if (Options["Write Search Log"])
239   {
240       Time::point elapsed = Time::now() - SearchTime + 1;
241
242       Log log(Options["Search Log Filename"]);
243       log << "Nodes: "          << RootPos.nodes_searched()
244           << "\nNodes/second: " << RootPos.nodes_searched() * 1000 / elapsed
245           << "\nBest move: "    << move_to_san(RootPos, RootMoves[0].pv[0]);
246
247       StateInfo st;
248       RootPos.do_move(RootMoves[0].pv[0], st);
249       log << "\nPonder move: " << move_to_san(RootPos, RootMoves[0].pv[1]) << std::endl;
250       RootPos.undo_move(RootMoves[0].pv[0]);
251   }
252
253 finalize:
254
255   // When search is stopped this info is not printed
256   sync_cout << "info nodes " << RootPos.nodes_searched()
257             << " time " << Time::now() - SearchTime + 1 << sync_endl;
258
259   // When we reach the maximum depth, we can arrive here without a raise of
260   // Signals.stop. However, if we are pondering or in an infinite search,
261   // the UCI protocol states that we shouldn't print the best move before the
262   // GUI sends a "stop" or "ponderhit" command. We therefore simply wait here
263   // until the GUI sends one of those commands (which also raises Signals.stop).
264   if (!Signals.stop && (Limits.ponder || Limits.infinite))
265   {
266       Signals.stopOnPonderhit = true;
267       RootPos.this_thread()->wait_for(Signals.stop);
268   }
269
270   // Best move could be MOVE_NONE when searching on a stalemate position
271   sync_cout << "bestmove " << move_to_uci(RootMoves[0].pv[0], RootPos.is_chess960())
272             << " ponder "  << move_to_uci(RootMoves[0].pv[1], RootPos.is_chess960())
273             << sync_endl;
274 }
275
276
277 namespace {
278
279   // id_loop() is the main iterative deepening loop. It calls search() repeatedly
280   // with increasing depth until the allocated thinking time has been consumed,
281   // user stops the search, or the maximum search depth is reached.
282
283   void id_loop(Position& pos) {
284
285     Stack stack[MAX_PLY_PLUS_6], *ss = stack+2; // To allow referencing (ss-2)
286     int depth;
287     Value bestValue, alpha, beta, delta;
288
289     std::memset(ss-2, 0, 5 * sizeof(Stack));
290     (ss-1)->currentMove = MOVE_NULL; // Hack to skip update gains
291
292     depth = 0;
293     BestMoveChanges = 0;
294     bestValue = delta = alpha = -VALUE_INFINITE;
295     beta = VALUE_INFINITE;
296
297     TT.new_search();
298     History.clear();
299     Gains.clear();
300     Countermoves.clear();
301     Followupmoves.clear();
302
303     MultiPV = Options["MultiPV"];
304     Skill skill(Options["Skill Level"]);
305
306     // Do we have to play with skill handicap? In this case enable MultiPV search
307     // that we will use behind the scenes to retrieve a set of possible moves.
308     if (skill.enabled() && MultiPV < 4)
309         MultiPV = 4;
310
311     MultiPV = std::min(MultiPV, RootMoves.size());
312
313     // Iterative deepening loop until requested to stop or target depth reached
314     while (++depth <= MAX_PLY && !Signals.stop && (!Limits.depth || depth <= Limits.depth))
315     {
316         // Age out PV variability metric
317         BestMoveChanges *= 0.5;
318
319         // Save the last iteration's scores before first PV line is searched and
320         // all the move scores except the (new) PV are set to -VALUE_INFINITE.
321         for (size_t i = 0; i < RootMoves.size(); ++i)
322             RootMoves[i].prevScore = RootMoves[i].score;
323
324         // MultiPV loop. We perform a full root search for each PV line
325         for (PVIdx = 0; PVIdx < MultiPV && !Signals.stop; ++PVIdx)
326         {
327             // Reset aspiration window starting size
328             if (depth >= 5)
329             {
330                 delta = Value(16);
331                 alpha = std::max(RootMoves[PVIdx].prevScore - delta,-VALUE_INFINITE);
332                 beta  = std::min(RootMoves[PVIdx].prevScore + delta, VALUE_INFINITE);
333             }
334
335             // Start with a small aspiration window and, in the case of a fail
336             // high/low, re-search with a bigger window until we're not failing
337             // high/low anymore.
338             while (true)
339             {
340                 bestValue = search<Root>(pos, ss, alpha, beta, depth * ONE_PLY, false);
341
342                 // Bring the best move to the front. It is critical that sorting
343                 // is done with a stable algorithm because all the values but the
344                 // first and eventually the new best one are set to -VALUE_INFINITE
345                 // and we want to keep the same order for all the moves except the
346                 // new PV that goes to the front. Note that in case of MultiPV
347                 // search the already searched PV lines are preserved.
348                 std::stable_sort(RootMoves.begin() + PVIdx, RootMoves.end());
349
350                 // Write PV back to transposition table in case the relevant
351                 // entries have been overwritten during the search.
352                 for (size_t i = 0; i <= PVIdx; ++i)
353                     RootMoves[i].insert_pv_in_tt(pos);
354
355                 // If search has been stopped break immediately. Sorting and
356                 // writing PV back to TT is safe because RootMoves is still
357                 // valid, although it refers to previous iteration.
358                 if (Signals.stop)
359                     break;
360
361                 // When failing high/low give some update (without cluttering
362                 // the UI) before a re-search.
363                 if (  (bestValue <= alpha || bestValue >= beta)
364                     && Time::now() - SearchTime > 3000)
365                     sync_cout << uci_pv(pos, depth, alpha, beta) << sync_endl;
366
367                 // In case of failing low/high increase aspiration window and
368                 // re-search, otherwise exit the loop.
369                 if (bestValue <= alpha)
370                 {
371                     alpha = std::max(bestValue - delta, -VALUE_INFINITE);
372
373                     Signals.failedLowAtRoot = true;
374                     Signals.stopOnPonderhit = false;
375                 }
376                 else if (bestValue >= beta)
377                     beta = std::min(bestValue + delta, VALUE_INFINITE);
378
379                 else
380                     break;
381
382                 delta += delta / 2;
383
384                 assert(alpha >= -VALUE_INFINITE && beta <= VALUE_INFINITE);
385             }
386
387             // Sort the PV lines searched so far and update the GUI
388             std::stable_sort(RootMoves.begin(), RootMoves.begin() + PVIdx + 1);
389
390             if (PVIdx + 1 == MultiPV || Time::now() - SearchTime > 3000)
391                 sync_cout << uci_pv(pos, depth, alpha, beta) << sync_endl;
392         }
393
394         // If skill levels are enabled and time is up, pick a sub-optimal best move
395         if (skill.enabled() && skill.time_to_pick(depth))
396             skill.pick_move();
397
398         if (Options["Write Search Log"])
399         {
400             RootMove& rm = RootMoves[0];
401             if (skill.best != MOVE_NONE)
402                 rm = *std::find(RootMoves.begin(), RootMoves.end(), skill.best);
403
404             Log log(Options["Search Log Filename"]);
405             log << pretty_pv(pos, depth, rm.score, Time::now() - SearchTime, &rm.pv[0])
406                 << std::endl;
407         }
408
409         // Have we found a "mate in x"?
410         if (   Limits.mate
411             && bestValue >= VALUE_MATE_IN_MAX_PLY
412             && VALUE_MATE - bestValue <= 2 * Limits.mate)
413             Signals.stop = true;
414
415         // Do we have time for the next iteration? Can we stop searching now?
416         if (Limits.use_time_management() && !Signals.stop && !Signals.stopOnPonderhit)
417         {
418             // Take some extra time if the best move has changed
419             if (depth > 4 && depth < 50 &&  MultiPV == 1)
420                 TimeMgr.pv_instability(BestMoveChanges);
421
422             // Stop the search if only one legal move is available or all
423             // of the available time has been used.
424             if (   RootMoves.size() == 1
425                 || Time::now() - SearchTime > TimeMgr.available_time())
426             {
427                 // If we are allowed to ponder do not stop the search now but
428                 // keep pondering until the GUI sends "ponderhit" or "stop".
429                 if (Limits.ponder)
430                     Signals.stopOnPonderhit = true;
431                 else
432                     Signals.stop = true;
433             }
434         }
435     }
436   }
437
438
439   // search<>() is the main search function for both PV and non-PV nodes and for
440   // normal and SplitPoint nodes. When called just after a split point the search
441   // is simpler because we have already probed the hash table, done a null move
442   // search, and searched the first move before splitting, so we don't have to
443   // repeat all this work again. We also don't need to store anything to the hash
444   // table here: This is taken care of after we return from the split point.
445
446   template <NodeType NT>
447   Value search(Position& pos, Stack* ss, Value alpha, Value beta, Depth depth, bool cutNode) {
448
449     const bool PvNode   = (NT == PV || NT == Root || NT == SplitPointPV || NT == SplitPointRoot);
450     const bool SpNode   = (NT == SplitPointPV || NT == SplitPointNonPV || NT == SplitPointRoot);
451     const bool RootNode = (NT == Root || NT == SplitPointRoot);
452
453     assert(-VALUE_INFINITE <= alpha && alpha < beta && beta <= VALUE_INFINITE);
454     assert(PvNode || (alpha == beta - 1));
455     assert(depth > DEPTH_ZERO);
456
457     Move quietsSearched[64];
458     StateInfo st;
459     const TTEntry *tte;
460     SplitPoint* splitPoint;
461     Key posKey;
462     Move ttMove, move, excludedMove, bestMove;
463     Depth ext, newDepth, predictedDepth;
464     Value bestValue, value, ttValue, eval, nullValue, futilityValue;
465     bool inCheck, givesCheck, pvMove, singularExtensionNode, improving;
466     bool captureOrPromotion, dangerous, doFullDepthSearch;
467     int moveCount, quietCount;
468
469     // Step 1. Initialize node
470     Thread* thisThread = pos.this_thread();
471     inCheck = pos.checkers();
472
473     if (SpNode)
474     {
475         splitPoint = ss->splitPoint;
476         bestMove   = splitPoint->bestMove;
477         bestValue  = splitPoint->bestValue;
478         tte = NULL;
479         ttMove = excludedMove = MOVE_NONE;
480         ttValue = VALUE_NONE;
481
482         assert(splitPoint->bestValue > -VALUE_INFINITE && splitPoint->moveCount > 0);
483
484         goto moves_loop;
485     }
486
487     moveCount = quietCount = 0;
488     bestValue = -VALUE_INFINITE;
489     ss->currentMove = ss->ttMove = (ss+1)->excludedMove = bestMove = MOVE_NONE;
490     ss->ply = (ss-1)->ply + 1;
491     (ss+1)->skipNullMove = false; (ss+1)->reduction = DEPTH_ZERO;
492     (ss+2)->killers[0] = (ss+2)->killers[1] = MOVE_NONE;
493
494     // Used to send selDepth info to GUI
495     if (PvNode && thisThread->maxPly < ss->ply)
496         thisThread->maxPly = ss->ply;
497
498     if (!RootNode)
499     {
500         // Step 2. Check for aborted search and immediate draw
501         if (Signals.stop || pos.is_draw() || ss->ply > MAX_PLY)
502             return ss->ply > MAX_PLY && !inCheck ? evaluate(pos) : DrawValue[pos.side_to_move()];
503
504         // Step 3. Mate distance pruning. Even if we mate at the next move our score
505         // would be at best mate_in(ss->ply+1), but if alpha is already bigger because
506         // a shorter mate was found upward in the tree then there is no need to search
507         // because we will never beat the current alpha. Same logic but with reversed
508         // signs applies also in the opposite condition of being mated instead of giving
509         // mate. In this case return a fail-high score.
510         alpha = std::max(mated_in(ss->ply), alpha);
511         beta = std::min(mate_in(ss->ply+1), beta);
512         if (alpha >= beta)
513             return alpha;
514     }
515
516     // Step 4. Transposition table lookup
517     // We don't want the score of a partial search to overwrite a previous full search
518     // TT value, so we use a different position key in case of an excluded move.
519     excludedMove = ss->excludedMove;
520     posKey = excludedMove ? pos.exclusion_key() : pos.key();
521     tte = TT.probe(posKey);
522     ss->ttMove = ttMove = RootNode ? RootMoves[PVIdx].pv[0] : tte ? tte->move() : MOVE_NONE;
523     ttValue = tte ? value_from_tt(tte->value(), ss->ply) : VALUE_NONE;
524
525     // At PV nodes we check for exact scores, whilst at non-PV nodes we check for
526     // a fail high/low. The biggest advantage to probing at PV nodes is to have a
527     // smooth experience in analysis mode. We don't probe at Root nodes otherwise
528     // we should also update RootMoveList to avoid bogus output.
529     if (   !RootNode
530         && tte
531         && tte->depth() >= depth
532         && ttValue != VALUE_NONE // Only in case of TT access race
533         && (           PvNode ?  tte->bound() == BOUND_EXACT
534             : ttValue >= beta ? (tte->bound() &  BOUND_LOWER)
535                               : (tte->bound() &  BOUND_UPPER)))
536     {
537         ss->currentMove = ttMove; // Can be MOVE_NONE
538
539         // If ttMove is quiet, update killers, history, counter move and followup move on TT hit
540         if (ttValue >= beta && ttMove && !pos.capture_or_promotion(ttMove) && !inCheck)
541             update_stats(pos, ss, ttMove, depth, NULL, 0);
542
543         return ttValue;
544     }
545
546     // Step 5. Evaluate the position statically and update parent's gain statistics
547     if (inCheck)
548     {
549         ss->staticEval = eval = VALUE_NONE;
550         goto moves_loop;
551     }
552
553     else if (tte)
554     {
555         // Never assume anything on values stored in TT
556         if ((ss->staticEval = eval = tte->eval_value()) == VALUE_NONE)
557             eval = ss->staticEval = evaluate(pos);
558
559         // Can ttValue be used as a better position evaluation?
560         if (ttValue != VALUE_NONE)
561             if (tte->bound() & (ttValue > eval ? BOUND_LOWER : BOUND_UPPER))
562                 eval = ttValue;
563     }
564     else
565     {
566         eval = ss->staticEval = evaluate(pos);
567         TT.store(posKey, VALUE_NONE, BOUND_NONE, DEPTH_NONE, MOVE_NONE, ss->staticEval);
568     }
569
570     if (   !pos.captured_piece_type()
571         &&  ss->staticEval != VALUE_NONE
572         && (ss-1)->staticEval != VALUE_NONE
573         && (move = (ss-1)->currentMove) != MOVE_NULL
574         &&  type_of(move) == NORMAL)
575     {
576         Square to = to_sq(move);
577         Gains.update(pos.piece_on(to), to, -(ss-1)->staticEval - ss->staticEval);
578     }
579
580     // Step 6. Razoring (skipped when in check)
581     if (   !PvNode
582         &&  depth < 4 * ONE_PLY
583         &&  eval + razor_margin(depth) <= alpha
584         &&  ttMove == MOVE_NONE
585         &&  abs(beta) < VALUE_MATE_IN_MAX_PLY
586         && !pos.pawn_on_7th(pos.side_to_move()))
587     {
588         Value ralpha = alpha - razor_margin(depth);
589         Value v = qsearch<NonPV, false>(pos, ss, ralpha, ralpha+1, DEPTH_ZERO);
590         if (v <= ralpha)
591             return v;
592     }
593
594     // Step 7. Futility pruning: child node (skipped when in check)
595     if (   !PvNode
596         && !ss->skipNullMove
597         &&  depth < 7 * ONE_PLY
598         &&  eval - futility_margin(depth) >= beta
599         &&  abs(beta) < VALUE_MATE_IN_MAX_PLY
600         &&  abs(eval) < VALUE_KNOWN_WIN
601         &&  pos.non_pawn_material(pos.side_to_move()))
602         return eval - futility_margin(depth);
603
604     // Step 8. Null move search with verification search (is omitted in PV nodes)
605     if (   !PvNode
606         && !ss->skipNullMove
607         &&  depth >= 2 * ONE_PLY
608         &&  eval >= beta
609         &&  abs(beta) < VALUE_MATE_IN_MAX_PLY
610         &&  pos.non_pawn_material(pos.side_to_move()))
611     {
612         ss->currentMove = MOVE_NULL;
613
614         assert(eval - beta >= 0);
615
616         // Null move dynamic reduction based on depth and value
617         Depth R =  3 * ONE_PLY
618                  + depth / 4
619                  + int(eval - beta) / PawnValueMg * ONE_PLY;
620
621         pos.do_null_move(st);
622         (ss+1)->skipNullMove = true;
623         nullValue = depth-R < ONE_PLY ? -qsearch<NonPV, false>(pos, ss+1, -beta, -beta+1, DEPTH_ZERO)
624                                       : - search<NonPV>(pos, ss+1, -beta, -beta+1, depth-R, !cutNode);
625         (ss+1)->skipNullMove = false;
626         pos.undo_null_move();
627
628         if (nullValue >= beta)
629         {
630             // Do not return unproven mate scores
631             if (nullValue >= VALUE_MATE_IN_MAX_PLY)
632                 nullValue = beta;
633
634             if (depth < 12 * ONE_PLY)
635                 return nullValue;
636
637             // Do verification search at high depths
638             ss->skipNullMove = true;
639             Value v = depth-R < ONE_PLY ? qsearch<NonPV, false>(pos, ss, beta-1, beta, DEPTH_ZERO)
640                                         :  search<NonPV>(pos, ss, beta-1, beta, depth-R, false);
641             ss->skipNullMove = false;
642
643             if (v >= beta)
644                 return nullValue;
645         }
646     }
647
648     // Step 9. ProbCut (skipped when in check)
649     // If we have a very good capture (i.e. SEE > seeValues[captured_piece_type])
650     // and a reduced search returns a value much above beta, we can (almost) safely
651     // prune the previous move.
652     if (   !PvNode
653         &&  depth >= 5 * ONE_PLY
654         && !ss->skipNullMove
655         &&  abs(beta) < VALUE_MATE_IN_MAX_PLY)
656     {
657         Value rbeta = std::min(beta + 200, VALUE_INFINITE);
658         Depth rdepth = depth - 4 * ONE_PLY;
659
660         assert(rdepth >= ONE_PLY);
661         assert((ss-1)->currentMove != MOVE_NONE);
662         assert((ss-1)->currentMove != MOVE_NULL);
663
664         MovePicker mp(pos, ttMove, History, pos.captured_piece_type());
665         CheckInfo ci(pos);
666
667         while ((move = mp.next_move<false>()) != MOVE_NONE)
668             if (pos.legal(move, ci.pinned))
669             {
670                 ss->currentMove = move;
671                 pos.do_move(move, st, ci, pos.gives_check(move, ci));
672                 value = -search<NonPV>(pos, ss+1, -rbeta, -rbeta+1, rdepth, !cutNode);
673                 pos.undo_move(move);
674                 if (value >= rbeta)
675                     return value;
676             }
677     }
678
679     // Step 10. Internal iterative deepening (skipped when in check)
680     if (    depth >= (PvNode ? 5 * ONE_PLY : 8 * ONE_PLY)
681         && !ttMove
682         && (PvNode || ss->staticEval + 256 >= beta))
683     {
684         Depth d = depth - 2 * ONE_PLY - (PvNode ? DEPTH_ZERO : depth / 4);
685
686         ss->skipNullMove = true;
687         search<PvNode ? PV : NonPV>(pos, ss, alpha, beta, d, true);
688         ss->skipNullMove = false;
689
690         tte = TT.probe(posKey);
691         ttMove = tte ? tte->move() : MOVE_NONE;
692     }
693
694 moves_loop: // When in check and at SpNode search starts from here
695
696     Square prevMoveSq = to_sq((ss-1)->currentMove);
697     Move countermoves[] = { Countermoves[pos.piece_on(prevMoveSq)][prevMoveSq].first,
698                             Countermoves[pos.piece_on(prevMoveSq)][prevMoveSq].second };
699
700     Square prevOwnMoveSq = to_sq((ss-2)->currentMove);
701     Move followupmoves[] = { Followupmoves[pos.piece_on(prevOwnMoveSq)][prevOwnMoveSq].first,
702                              Followupmoves[pos.piece_on(prevOwnMoveSq)][prevOwnMoveSq].second };
703
704     MovePicker mp(pos, ttMove, depth, History, countermoves, followupmoves, ss);
705     CheckInfo ci(pos);
706     value = bestValue; // Workaround a bogus 'uninitialized' warning under gcc
707     improving =   ss->staticEval >= (ss-2)->staticEval
708                || ss->staticEval == VALUE_NONE
709                ||(ss-2)->staticEval == VALUE_NONE;
710
711     singularExtensionNode =   !RootNode
712                            && !SpNode
713                            &&  depth >= 8 * ONE_PLY
714                            &&  ttMove != MOVE_NONE
715                            && !excludedMove // Recursive singular search is not allowed
716                            && (tte->bound() & BOUND_LOWER)
717                            &&  tte->depth() >= depth - 3 * ONE_PLY;
718
719     // Step 11. Loop through moves
720     // Loop through all pseudo-legal moves until no moves remain or a beta cutoff occurs
721     while ((move = mp.next_move<SpNode>()) != MOVE_NONE)
722     {
723       assert(is_ok(move));
724
725       if (move == excludedMove)
726           continue;
727
728       // At root obey the "searchmoves" option and skip moves not listed in Root
729       // Move List. As a consequence any illegal move is also skipped. In MultiPV
730       // mode we also skip PV moves which have been already searched.
731       if (RootNode && !std::count(RootMoves.begin() + PVIdx, RootMoves.end(), move))
732           continue;
733
734       if (SpNode)
735       {
736           // Shared counter cannot be decremented later if the move turns out to be illegal
737           if (!pos.legal(move, ci.pinned))
738               continue;
739
740           moveCount = ++splitPoint->moveCount;
741           splitPoint->mutex.unlock();
742       }
743       else
744           ++moveCount;
745
746       if (RootNode)
747       {
748           Signals.firstRootMove = (moveCount == 1);
749
750           if (thisThread == Threads.main() && Time::now() - SearchTime > 3000)
751               sync_cout << "info depth " << depth / ONE_PLY
752                         << " currmove " << move_to_uci(move, pos.is_chess960())
753                         << " currmovenumber " << moveCount + PVIdx << sync_endl;
754       }
755
756       ext = DEPTH_ZERO;
757       captureOrPromotion = pos.capture_or_promotion(move);
758
759       givesCheck =  type_of(move) == NORMAL && !ci.dcCandidates
760                   ? ci.checkSq[type_of(pos.piece_on(from_sq(move)))] & to_sq(move)
761                   : pos.gives_check(move, ci);
762
763       dangerous =   givesCheck
764                  || type_of(move) != NORMAL
765                  || pos.advanced_pawn_push(move);
766
767       // Step 12. Extend checks
768       if (givesCheck && pos.see_sign(move) >= VALUE_ZERO)
769           ext = ONE_PLY;
770
771       // Singular extension search. If all moves but one fail low on a search of
772       // (alpha-s, beta-s), and just one fails high on (alpha, beta), then that move
773       // is singular and should be extended. To verify this we do a reduced search
774       // on all the other moves but the ttMove and if the result is lower than
775       // ttValue minus a margin then we extend the ttMove.
776       if (    singularExtensionNode
777           &&  move == ttMove
778           && !ext
779           &&  pos.legal(move, ci.pinned)
780           &&  abs(ttValue) < VALUE_KNOWN_WIN)
781       {
782           assert(ttValue != VALUE_NONE);
783
784           Value rBeta = ttValue - int(depth);
785           ss->excludedMove = move;
786           ss->skipNullMove = true;
787           value = search<NonPV>(pos, ss, rBeta - 1, rBeta, depth / 2, cutNode);
788           ss->skipNullMove = false;
789           ss->excludedMove = MOVE_NONE;
790
791           if (value < rBeta)
792               ext = ONE_PLY;
793       }
794
795       // Update the current move (this must be done after singular extension search)
796       newDepth = depth - ONE_PLY + ext;
797
798       // Step 13. Pruning at shallow depth (exclude PV nodes)
799       if (   !PvNode
800           && !captureOrPromotion
801           && !inCheck
802           && !dangerous
803        /* &&  move != ttMove Already implicit in the next condition */
804           &&  bestValue > VALUE_MATED_IN_MAX_PLY)
805       {
806           // Move count based pruning
807           if (   depth < 16 * ONE_PLY
808               && moveCount >= FutilityMoveCounts[improving][depth] )
809           {
810               if (SpNode)
811                   splitPoint->mutex.lock();
812
813               continue;
814           }
815
816           predictedDepth = newDepth - reduction<PvNode>(improving, depth, moveCount);
817
818           // Futility pruning: parent node
819           if (predictedDepth < 7 * ONE_PLY)
820           {
821               futilityValue = ss->staticEval + futility_margin(predictedDepth)
822                             + 128 + Gains[pos.moved_piece(move)][to_sq(move)];
823
824               if (futilityValue <= alpha)
825               {
826                   bestValue = std::max(bestValue, futilityValue);
827
828                   if (SpNode)
829                   {
830                       splitPoint->mutex.lock();
831                       if (bestValue > splitPoint->bestValue)
832                           splitPoint->bestValue = bestValue;
833                   }
834                   continue;
835               }
836           }
837
838           // Prune moves with negative SEE at low depths
839           if (predictedDepth < 4 * ONE_PLY && pos.see_sign(move) < VALUE_ZERO)
840           {
841               if (SpNode)
842                   splitPoint->mutex.lock();
843
844               continue;
845           }
846       }
847
848       // Check for legality just before making the move
849       if (!RootNode && !SpNode && !pos.legal(move, ci.pinned))
850       {
851           moveCount--;
852           continue;
853       }
854
855       pvMove = PvNode && moveCount == 1;
856       ss->currentMove = move;
857       if (!SpNode && !captureOrPromotion && quietCount < 64)
858           quietsSearched[quietCount++] = move;
859
860       // Step 14. Make the move
861       pos.do_move(move, st, ci, givesCheck);
862
863       // Step 15. Reduced depth search (LMR). If the move fails high it will be
864       // re-searched at full depth.
865       if (    depth >= 3 * ONE_PLY
866           && !pvMove
867           && !captureOrPromotion
868           &&  move != ttMove
869           &&  move != ss->killers[0]
870           &&  move != ss->killers[1])
871       {
872           ss->reduction = reduction<PvNode>(improving, depth, moveCount);
873
874           if (!PvNode && cutNode)
875               ss->reduction += ONE_PLY;
876
877           else if (History[pos.piece_on(to_sq(move))][to_sq(move)] < 0)
878               ss->reduction += ONE_PLY / 2;
879
880           if (move == countermoves[0] || move == countermoves[1])
881               ss->reduction = std::max(DEPTH_ZERO, ss->reduction - ONE_PLY);
882
883           Depth d = std::max(newDepth - ss->reduction, ONE_PLY);
884           if (SpNode)
885               alpha = splitPoint->alpha;
886
887           value = -search<NonPV>(pos, ss+1, -(alpha+1), -alpha, d, true);
888
889           // Research at intermediate depth if reduction is very high
890           if (value > alpha && ss->reduction >= 4 * ONE_PLY)
891           {
892               Depth d2 = std::max(newDepth - 2 * ONE_PLY, ONE_PLY);
893               value = -search<NonPV>(pos, ss+1, -(alpha+1), -alpha, d2, true);
894           }
895
896           doFullDepthSearch = (value > alpha && ss->reduction != DEPTH_ZERO);
897           ss->reduction = DEPTH_ZERO;
898       }
899       else
900           doFullDepthSearch = !pvMove;
901
902       // Step 16. Full depth search, when LMR is skipped or fails high
903       if (doFullDepthSearch)
904       {
905           if (SpNode)
906               alpha = splitPoint->alpha;
907
908           value = newDepth < ONE_PLY ?
909                           givesCheck ? -qsearch<NonPV,  true>(pos, ss+1, -(alpha+1), -alpha, DEPTH_ZERO)
910                                      : -qsearch<NonPV, false>(pos, ss+1, -(alpha+1), -alpha, DEPTH_ZERO)
911                                      : - search<NonPV>(pos, ss+1, -(alpha+1), -alpha, newDepth, !cutNode);
912       }
913
914       // For PV nodes only, do a full PV search on the first move or after a fail
915       // high (in the latter case search only if value < beta), otherwise let the
916       // parent node fail low with value <= alpha and to try another move.
917       if (PvNode && (pvMove || (value > alpha && (RootNode || value < beta))))
918           value = newDepth < ONE_PLY ?
919                           givesCheck ? -qsearch<PV,  true>(pos, ss+1, -beta, -alpha, DEPTH_ZERO)
920                                      : -qsearch<PV, false>(pos, ss+1, -beta, -alpha, DEPTH_ZERO)
921                                      : - search<PV>(pos, ss+1, -beta, -alpha, newDepth, false);
922       // Step 17. Undo move
923       pos.undo_move(move);
924
925       assert(value > -VALUE_INFINITE && value < VALUE_INFINITE);
926
927       // Step 18. Check for new best move
928       if (SpNode)
929       {
930           splitPoint->mutex.lock();
931           bestValue = splitPoint->bestValue;
932           alpha = splitPoint->alpha;
933       }
934
935       // Finished searching the move. If a stop or a cutoff occurred, the return
936       // value of the search cannot be trusted, and we return immediately without
937       // updating best move, PV and TT.
938       if (Signals.stop || thisThread->cutoff_occurred())
939           return VALUE_ZERO;
940
941       if (RootNode)
942       {
943           RootMove& rm = *std::find(RootMoves.begin(), RootMoves.end(), move);
944
945           // PV move or new best move ?
946           if (pvMove || value > alpha)
947           {
948               rm.score = value;
949               rm.extract_pv_from_tt(pos);
950
951               // We record how often the best move has been changed in each
952               // iteration. This information is used for time management: When
953               // the best move changes frequently, we allocate some more time.
954               if (!pvMove)
955                   ++BestMoveChanges;
956           }
957           else
958               // All other moves but the PV are set to the lowest value: this is
959               // not a problem when sorting because the sort is stable and the
960               // move position in the list is preserved - just the PV is pushed up.
961               rm.score = -VALUE_INFINITE;
962       }
963
964       if (value > bestValue)
965       {
966           bestValue = SpNode ? splitPoint->bestValue = value : value;
967
968           if (value > alpha)
969           {
970               bestMove = SpNode ? splitPoint->bestMove = move : move;
971
972               if (PvNode && value < beta) // Update alpha! Always alpha < beta
973                   alpha = SpNode ? splitPoint->alpha = value : value;
974               else
975               {
976                   assert(value >= beta); // Fail high
977
978                   if (SpNode)
979                       splitPoint->cutoff = true;
980
981                   break;
982               }
983           }
984       }
985
986       // Step 19. Check for splitting the search
987       if (   !SpNode
988           &&  depth >= Threads.minimumSplitDepth
989           &&  Threads.available_slave(thisThread)
990           &&  thisThread->splitPointsSize < MAX_SPLITPOINTS_PER_THREAD)
991       {
992           assert(bestValue > -VALUE_INFINITE && bestValue < beta);
993
994           thisThread->split<FakeSplit>(pos, ss, alpha, beta, &bestValue, &bestMove,
995                                        depth, moveCount, &mp, NT, cutNode);
996
997           if (Signals.stop || thisThread->cutoff_occurred())
998               return VALUE_ZERO;
999
1000           if (bestValue >= beta)
1001               break;
1002       }
1003     }
1004
1005     if (SpNode)
1006         return bestValue;
1007
1008     // Following condition would detect a stop or a cutoff set only after move
1009     // loop has been completed. But in this case bestValue is valid because we
1010     // have fully searched our subtree, and we can anyhow save the result in TT.
1011     /*
1012        if (Signals.stop || thisThread->cutoff_occurred())
1013         return VALUE_DRAW;
1014     */
1015
1016     // Step 20. Check for mate and stalemate
1017     // All legal moves have been searched and if there are no legal moves, it
1018     // must be mate or stalemate. If we are in a singular extension search then
1019     // return a fail low score.
1020     if (!moveCount)
1021         return  excludedMove ? alpha
1022               : inCheck ? mated_in(ss->ply) : DrawValue[pos.side_to_move()];
1023
1024     TT.store(posKey, value_to_tt(bestValue, ss->ply),
1025              bestValue >= beta  ? BOUND_LOWER :
1026              PvNode && bestMove ? BOUND_EXACT : BOUND_UPPER,
1027              depth, bestMove, ss->staticEval);
1028
1029     // Quiet best move: update killers, history, countermoves and followupmoves
1030     if (bestValue >= beta && !pos.capture_or_promotion(bestMove) && !inCheck)
1031         update_stats(pos, ss, bestMove, depth, quietsSearched, quietCount - 1);
1032
1033     assert(bestValue > -VALUE_INFINITE && bestValue < VALUE_INFINITE);
1034
1035     return bestValue;
1036   }
1037
1038
1039   // qsearch() is the quiescence search function, which is called by the main
1040   // search function when the remaining depth is zero (or, to be more precise,
1041   // less than ONE_PLY).
1042
1043   template <NodeType NT, bool InCheck>
1044   Value qsearch(Position& pos, Stack* ss, Value alpha, Value beta, Depth depth) {
1045
1046     const bool PvNode = (NT == PV);
1047
1048     assert(NT == PV || NT == NonPV);
1049     assert(InCheck == !!pos.checkers());
1050     assert(alpha >= -VALUE_INFINITE && alpha < beta && beta <= VALUE_INFINITE);
1051     assert(PvNode || (alpha == beta - 1));
1052     assert(depth <= DEPTH_ZERO);
1053
1054     StateInfo st;
1055     const TTEntry* tte;
1056     Key posKey;
1057     Move ttMove, move, bestMove;
1058     Value bestValue, value, ttValue, futilityValue, futilityBase, oldAlpha;
1059     bool givesCheck, evasionPrunable;
1060     Depth ttDepth;
1061
1062     // To flag BOUND_EXACT a node with eval above alpha and no available moves
1063     if (PvNode)
1064         oldAlpha = alpha;
1065
1066     ss->currentMove = bestMove = MOVE_NONE;
1067     ss->ply = (ss-1)->ply + 1;
1068
1069     // Check for an instant draw or if the maximum ply has been reached
1070     if (pos.is_draw() || ss->ply > MAX_PLY)
1071         return ss->ply > MAX_PLY && !InCheck ? evaluate(pos) : DrawValue[pos.side_to_move()];
1072
1073     // Decide whether or not to include checks: this fixes also the type of
1074     // TT entry depth that we are going to use. Note that in qsearch we use
1075     // only two types of depth in TT: DEPTH_QS_CHECKS or DEPTH_QS_NO_CHECKS.
1076     ttDepth = InCheck || depth >= DEPTH_QS_CHECKS ? DEPTH_QS_CHECKS
1077                                                   : DEPTH_QS_NO_CHECKS;
1078
1079     // Transposition table lookup
1080     posKey = pos.key();
1081     tte = TT.probe(posKey);
1082     ttMove = tte ? tte->move() : MOVE_NONE;
1083     ttValue = tte ? value_from_tt(tte->value(),ss->ply) : VALUE_NONE;
1084
1085     if (   tte
1086         && tte->depth() >= ttDepth
1087         && ttValue != VALUE_NONE // Only in case of TT access race
1088         && (           PvNode ?  tte->bound() == BOUND_EXACT
1089             : ttValue >= beta ? (tte->bound() &  BOUND_LOWER)
1090                               : (tte->bound() &  BOUND_UPPER)))
1091     {
1092         ss->currentMove = ttMove; // Can be MOVE_NONE
1093         return ttValue;
1094     }
1095
1096     // Evaluate the position statically
1097     if (InCheck)
1098     {
1099         ss->staticEval = VALUE_NONE;
1100         bestValue = futilityBase = -VALUE_INFINITE;
1101     }
1102     else
1103     {
1104         if (tte)
1105         {
1106             // Never assume anything on values stored in TT
1107             if ((ss->staticEval = bestValue = tte->eval_value()) == VALUE_NONE)
1108                 ss->staticEval = bestValue = evaluate(pos);
1109
1110             // Can ttValue be used as a better position evaluation?
1111             if (ttValue != VALUE_NONE)
1112                 if (tte->bound() & (ttValue > bestValue ? BOUND_LOWER : BOUND_UPPER))
1113                     bestValue = ttValue;
1114         }
1115         else
1116             ss->staticEval = bestValue = evaluate(pos);
1117
1118         // Stand pat. Return immediately if static value is at least beta
1119         if (bestValue >= beta)
1120         {
1121             if (!tte)
1122                 TT.store(pos.key(), value_to_tt(bestValue, ss->ply), BOUND_LOWER,
1123                          DEPTH_NONE, MOVE_NONE, ss->staticEval);
1124
1125             return bestValue;
1126         }
1127
1128         if (PvNode && bestValue > alpha)
1129             alpha = bestValue;
1130
1131         futilityBase = bestValue + 128;
1132     }
1133
1134     // Initialize a MovePicker object for the current position, and prepare
1135     // to search the moves. Because the depth is <= 0 here, only captures,
1136     // queen promotions and checks (only if depth >= DEPTH_QS_CHECKS) will
1137     // be generated.
1138     MovePicker mp(pos, ttMove, depth, History, to_sq((ss-1)->currentMove));
1139     CheckInfo ci(pos);
1140
1141     // Loop through the moves until no moves remain or a beta cutoff occurs
1142     while ((move = mp.next_move<false>()) != MOVE_NONE)
1143     {
1144       assert(is_ok(move));
1145
1146       givesCheck =  type_of(move) == NORMAL && !ci.dcCandidates
1147                   ? ci.checkSq[type_of(pos.piece_on(from_sq(move)))] & to_sq(move)
1148                   : pos.gives_check(move, ci);
1149
1150       // Futility pruning
1151       if (   !PvNode
1152           && !InCheck
1153           && !givesCheck
1154           &&  move != ttMove
1155           &&  futilityBase > -VALUE_KNOWN_WIN
1156           && !pos.advanced_pawn_push(move))
1157       {
1158           assert(type_of(move) != ENPASSANT); // Due to !pos.advanced_pawn_push
1159
1160           futilityValue = futilityBase + PieceValue[EG][pos.piece_on(to_sq(move))];
1161
1162           if (futilityValue < beta)
1163           {
1164               bestValue = std::max(bestValue, futilityValue);
1165               continue;
1166           }
1167
1168           if (futilityBase < beta && pos.see(move) <= VALUE_ZERO)
1169           {
1170               bestValue = std::max(bestValue, futilityBase);
1171               continue;
1172           }
1173       }
1174
1175       // Detect non-capture evasions that are candidates to be pruned
1176       evasionPrunable =    InCheck
1177                        &&  bestValue > VALUE_MATED_IN_MAX_PLY
1178                        && !pos.capture(move)
1179                        && !pos.can_castle(pos.side_to_move());
1180
1181       // Don't search moves with negative SEE values
1182       if (   !PvNode
1183           && (!InCheck || evasionPrunable)
1184           &&  move != ttMove
1185           &&  type_of(move) != PROMOTION
1186           &&  pos.see_sign(move) < VALUE_ZERO)
1187           continue;
1188
1189       // Check for legality just before making the move
1190       if (!pos.legal(move, ci.pinned))
1191           continue;
1192
1193       ss->currentMove = move;
1194
1195       // Make and search the move
1196       pos.do_move(move, st, ci, givesCheck);
1197       value = givesCheck ? -qsearch<NT,  true>(pos, ss+1, -beta, -alpha, depth - ONE_PLY)
1198                          : -qsearch<NT, false>(pos, ss+1, -beta, -alpha, depth - ONE_PLY);
1199       pos.undo_move(move);
1200
1201       assert(value > -VALUE_INFINITE && value < VALUE_INFINITE);
1202
1203       // Check for new best move
1204       if (value > bestValue)
1205       {
1206           bestValue = value;
1207
1208           if (value > alpha)
1209           {
1210               if (PvNode && value < beta) // Update alpha here! Always alpha < beta
1211               {
1212                   alpha = value;
1213                   bestMove = move;
1214               }
1215               else // Fail high
1216               {
1217                   TT.store(posKey, value_to_tt(value, ss->ply), BOUND_LOWER,
1218                            ttDepth, move, ss->staticEval);
1219
1220                   return value;
1221               }
1222           }
1223        }
1224     }
1225
1226     // All legal moves have been searched. A special case: If we're in check
1227     // and no legal moves were found, it is checkmate.
1228     if (InCheck && bestValue == -VALUE_INFINITE)
1229         return mated_in(ss->ply); // Plies to mate from the root
1230
1231     TT.store(posKey, value_to_tt(bestValue, ss->ply),
1232              PvNode && bestValue > oldAlpha ? BOUND_EXACT : BOUND_UPPER,
1233              ttDepth, bestMove, ss->staticEval);
1234
1235     assert(bestValue > -VALUE_INFINITE && bestValue < VALUE_INFINITE);
1236
1237     return bestValue;
1238   }
1239
1240
1241   // value_to_tt() adjusts a mate score from "plies to mate from the root" to
1242   // "plies to mate from the current position". Non-mate scores are unchanged.
1243   // The function is called before storing a value in the transposition table.
1244
1245   Value value_to_tt(Value v, int ply) {
1246
1247     assert(v != VALUE_NONE);
1248
1249     return  v >= VALUE_MATE_IN_MAX_PLY  ? v + ply
1250           : v <= VALUE_MATED_IN_MAX_PLY ? v - ply : v;
1251   }
1252
1253
1254   // value_from_tt() is the inverse of value_to_tt(): It adjusts a mate score
1255   // from the transposition table (which refers to the plies to mate/be mated
1256   // from current position) to "plies to mate/be mated from the root".
1257
1258   Value value_from_tt(Value v, int ply) {
1259
1260     return  v == VALUE_NONE             ? VALUE_NONE
1261           : v >= VALUE_MATE_IN_MAX_PLY  ? v - ply
1262           : v <= VALUE_MATED_IN_MAX_PLY ? v + ply : v;
1263   }
1264
1265
1266   // update_stats() updates killers, history, countermoves and followupmoves stats after a fail-high
1267   // of a quiet move.
1268
1269   void update_stats(Position& pos, Stack* ss, Move move, Depth depth, Move* quiets, int quietsCnt) {
1270
1271     if (ss->killers[0] != move)
1272     {
1273         ss->killers[1] = ss->killers[0];
1274         ss->killers[0] = move;
1275     }
1276
1277     // Increase history value of the cut-off move and decrease all the other
1278     // played quiet moves.
1279     Value bonus = Value(int(depth) * int(depth));
1280     History.update(pos.moved_piece(move), to_sq(move), bonus);
1281     for (int i = 0; i < quietsCnt; ++i)
1282     {
1283         Move m = quiets[i];
1284         History.update(pos.moved_piece(m), to_sq(m), -bonus);
1285     }
1286
1287     if (is_ok((ss-1)->currentMove))
1288     {
1289         Square prevMoveSq = to_sq((ss-1)->currentMove);
1290         Countermoves.update(pos.piece_on(prevMoveSq), prevMoveSq, move);
1291     }
1292
1293     if (is_ok((ss-2)->currentMove) && (ss-1)->currentMove == (ss-1)->ttMove)
1294     {
1295         Square prevOwnMoveSq = to_sq((ss-2)->currentMove);
1296         Followupmoves.update(pos.piece_on(prevOwnMoveSq), prevOwnMoveSq, move);
1297     }
1298   }
1299
1300
1301   // When playing with a strength handicap, choose best move among the MultiPV
1302   // set using a statistical rule dependent on 'level'. Idea by Heinz van Saanen.
1303
1304   Move Skill::pick_move() {
1305
1306     static RKISS rk;
1307
1308     // PRNG sequence should be not deterministic
1309     for (int i = Time::now() % 50; i > 0; --i)
1310         rk.rand<unsigned>();
1311
1312     // RootMoves are already sorted by score in descending order
1313     int variance = std::min(RootMoves[0].score - RootMoves[MultiPV - 1].score, PawnValueMg);
1314     int weakness = 120 - 2 * level;
1315     int max_s = -VALUE_INFINITE;
1316     best = MOVE_NONE;
1317
1318     // Choose best move. For each move score we add two terms both dependent on
1319     // weakness. One deterministic and bigger for weaker moves, and one random,
1320     // then we choose the move with the resulting highest score.
1321     for (size_t i = 0; i < MultiPV; ++i)
1322     {
1323         int s = RootMoves[i].score;
1324
1325         // Don't allow crazy blunders even at very low skills
1326         if (i > 0 && RootMoves[i-1].score > s + 2 * PawnValueMg)
1327             break;
1328
1329         // This is our magic formula
1330         s += (  weakness * int(RootMoves[0].score - s)
1331               + variance * (rk.rand<unsigned>() % weakness)) / 128;
1332
1333         if (s > max_s)
1334         {
1335             max_s = s;
1336             best = RootMoves[i].pv[0];
1337         }
1338     }
1339     return best;
1340   }
1341
1342
1343   // uci_pv() formats PV information according to the UCI protocol. UCI
1344   // requires that all (if any) unsearched PV lines are sent using a previous
1345   // search score.
1346
1347   string uci_pv(const Position& pos, int depth, Value alpha, Value beta) {
1348
1349     std::stringstream ss;
1350     Time::point elapsed = Time::now() - SearchTime + 1;
1351     size_t uciPVSize = std::min((size_t)Options["MultiPV"], RootMoves.size());
1352     int selDepth = 0;
1353
1354     for (size_t i = 0; i < Threads.size(); ++i)
1355         if (Threads[i]->maxPly > selDepth)
1356             selDepth = Threads[i]->maxPly;
1357
1358     for (size_t i = 0; i < uciPVSize; ++i)
1359     {
1360         bool updated = (i <= PVIdx);
1361
1362         if (depth == 1 && !updated)
1363             continue;
1364
1365         int d   = updated ? depth : depth - 1;
1366         Value v = updated ? RootMoves[i].score : RootMoves[i].prevScore;
1367
1368         if (ss.rdbuf()->in_avail()) // Not at first line
1369             ss << "\n";
1370
1371         ss << "info depth " << d
1372            << " seldepth "  << selDepth
1373            << " score "     << (i == PVIdx ? score_to_uci(v, alpha, beta) : score_to_uci(v))
1374            << " nodes "     << pos.nodes_searched()
1375            << " nps "       << pos.nodes_searched() * 1000 / elapsed
1376            << " time "      << elapsed
1377            << " multipv "   << i + 1
1378            << " pv";
1379
1380         for (size_t j = 0; RootMoves[i].pv[j] != MOVE_NONE; ++j)
1381             ss << " " << move_to_uci(RootMoves[i].pv[j], pos.is_chess960());
1382     }
1383
1384     return ss.str();
1385   }
1386
1387 } // namespace
1388
1389
1390 /// RootMove::extract_pv_from_tt() builds a PV by adding moves from the TT table.
1391 /// We also consider both failing high nodes and BOUND_EXACT nodes here to
1392 /// ensure that we have a ponder move even when we fail high at root. This
1393 /// results in a long PV to print that is important for position analysis.
1394
1395 void RootMove::extract_pv_from_tt(Position& pos) {
1396
1397   StateInfo state[MAX_PLY_PLUS_6], *st = state;
1398   const TTEntry* tte;
1399   int ply = 0;
1400   Move m = pv[0];
1401
1402   pv.clear();
1403
1404   do {
1405       pv.push_back(m);
1406
1407       assert(MoveList<LEGAL>(pos).contains(pv[ply]));
1408
1409       pos.do_move(pv[ply++], *st++);
1410       tte = TT.probe(pos.key());
1411
1412   } while (   tte
1413            && pos.pseudo_legal(m = tte->move()) // Local copy, TT could change
1414            && pos.legal(m, pos.pinned_pieces(pos.side_to_move()))
1415            && ply < MAX_PLY
1416            && (!pos.is_draw() || ply < 2));
1417
1418   pv.push_back(MOVE_NONE); // Must be zero-terminating
1419
1420   while (ply) pos.undo_move(pv[--ply]);
1421 }
1422
1423
1424 /// RootMove::insert_pv_in_tt() is called at the end of a search iteration, and
1425 /// inserts the PV back into the TT. This makes sure the old PV moves are searched
1426 /// first, even if the old TT entries have been overwritten.
1427
1428 void RootMove::insert_pv_in_tt(Position& pos) {
1429
1430   StateInfo state[MAX_PLY_PLUS_6], *st = state;
1431   const TTEntry* tte;
1432   int ply = 0;
1433
1434   do {
1435       tte = TT.probe(pos.key());
1436
1437       if (!tte || tte->move() != pv[ply]) // Don't overwrite correct entries
1438           TT.store(pos.key(), VALUE_NONE, BOUND_NONE, DEPTH_NONE, pv[ply], VALUE_NONE);
1439
1440       assert(MoveList<LEGAL>(pos).contains(pv[ply]));
1441
1442       pos.do_move(pv[ply++], *st++);
1443
1444   } while (pv[ply] != MOVE_NONE);
1445
1446   while (ply) pos.undo_move(pv[--ply]);
1447 }
1448
1449
1450 /// Thread::idle_loop() is where the thread is parked when it has no work to do
1451
1452 void Thread::idle_loop() {
1453
1454   // Pointer 'this_sp' is not null only if we are called from split(), and not
1455   // at the thread creation. This means we are the split point's master.
1456   SplitPoint* this_sp = splitPointsSize ? activeSplitPoint : NULL;
1457
1458   assert(!this_sp || (this_sp->masterThread == this && searching));
1459
1460   while (true)
1461   {
1462       // If we are not searching, wait for a condition to be signaled instead of
1463       // wasting CPU time polling for work.
1464       while ((!searching && Threads.sleepWhileIdle) || exit)
1465       {
1466           if (exit)
1467           {
1468               assert(!this_sp);
1469               return;
1470           }
1471
1472           // Grab the lock to avoid races with Thread::notify_one()
1473           mutex.lock();
1474
1475           // If we are master and all slaves have finished then exit idle_loop
1476           if (this_sp && this_sp->slavesMask.none())
1477           {
1478               mutex.unlock();
1479               break;
1480           }
1481
1482           // Do sleep after retesting sleep conditions under lock protection. In
1483           // particular we need to avoid a deadlock in case a master thread has,
1484           // in the meanwhile, allocated us and sent the notify_one() call before
1485           // we had the chance to grab the lock.
1486           if (!searching && !exit)
1487               sleepCondition.wait(mutex);
1488
1489           mutex.unlock();
1490       }
1491
1492       // If this thread has been assigned work, launch a search
1493       if (searching)
1494       {
1495           assert(!exit);
1496
1497           Threads.mutex.lock();
1498
1499           assert(searching);
1500           assert(activeSplitPoint);
1501           SplitPoint* sp = activeSplitPoint;
1502
1503           Threads.mutex.unlock();
1504
1505           Stack stack[MAX_PLY_PLUS_6], *ss = stack+2; // To allow referencing (ss-2)
1506           Position pos(*sp->pos, this);
1507
1508           std::memcpy(ss-2, sp->ss-2, 5 * sizeof(Stack));
1509           ss->splitPoint = sp;
1510
1511           sp->mutex.lock();
1512
1513           assert(activePosition == NULL);
1514
1515           activePosition = &pos;
1516
1517           switch (sp->nodeType) {
1518           case Root:
1519               search<SplitPointRoot>(pos, ss, sp->alpha, sp->beta, sp->depth, sp->cutNode);
1520               break;
1521           case PV:
1522               search<SplitPointPV>(pos, ss, sp->alpha, sp->beta, sp->depth, sp->cutNode);
1523               break;
1524           case NonPV:
1525               search<SplitPointNonPV>(pos, ss, sp->alpha, sp->beta, sp->depth, sp->cutNode);
1526               break;
1527           default:
1528               assert(false);
1529           }
1530
1531           assert(searching);
1532
1533           searching = false;
1534           activePosition = NULL;
1535           sp->slavesMask.reset(idx);
1536           sp->nodes += pos.nodes_searched();
1537
1538           // Wake up the master thread so to allow it to return from the idle
1539           // loop in case we are the last slave of the split point.
1540           if (    Threads.sleepWhileIdle
1541               &&  this != sp->masterThread
1542               &&  sp->slavesMask.none())
1543           {
1544               assert(!sp->masterThread->searching);
1545               sp->masterThread->notify_one();
1546           }
1547
1548           // After releasing the lock we can't access any SplitPoint related data
1549           // in a safe way because it could have been released under our feet by
1550           // the sp master. Also accessing other Thread objects is unsafe because
1551           // if we are exiting there is a chance that they are already freed.
1552           sp->mutex.unlock();
1553       }
1554
1555       // If this thread is the master of a split point and all slaves have finished
1556       // their work at this split point, return from the idle loop.
1557       if (this_sp && this_sp->slavesMask.none())
1558       {
1559           this_sp->mutex.lock();
1560           bool finished = this_sp->slavesMask.none(); // Retest under lock protection
1561           this_sp->mutex.unlock();
1562           if (finished)
1563               return;
1564       }
1565   }
1566 }
1567
1568
1569 /// check_time() is called by the timer thread when the timer triggers. It is
1570 /// used to print debug info and, more importantly, to detect when we are out of
1571 /// available time and thus stop the search.
1572
1573 void check_time() {
1574
1575   static Time::point lastInfoTime = Time::now();
1576   int64_t nodes = 0; // Workaround silly 'uninitialized' gcc warning
1577
1578   if (Time::now() - lastInfoTime >= 1000)
1579   {
1580       lastInfoTime = Time::now();
1581       dbg_print();
1582   }
1583
1584   if (Limits.ponder)
1585       return;
1586
1587   if (Limits.nodes)
1588   {
1589       Threads.mutex.lock();
1590
1591       nodes = RootPos.nodes_searched();
1592
1593       // Loop across all split points and sum accumulated SplitPoint nodes plus
1594       // all the currently active positions nodes.
1595       for (size_t i = 0; i < Threads.size(); ++i)
1596           for (int j = 0; j < Threads[i]->splitPointsSize; ++j)
1597           {
1598               SplitPoint& sp = Threads[i]->splitPoints[j];
1599
1600               sp.mutex.lock();
1601
1602               nodes += sp.nodes;
1603
1604               for (size_t idx = 0; idx < Threads.size(); ++idx)
1605                   if (sp.slavesMask.test(idx) && Threads[idx]->activePosition)
1606                       nodes += Threads[idx]->activePosition->nodes_searched();
1607
1608               sp.mutex.unlock();
1609           }
1610
1611       Threads.mutex.unlock();
1612   }
1613
1614   Time::point elapsed = Time::now() - SearchTime;
1615   bool stillAtFirstMove =    Signals.firstRootMove
1616                          && !Signals.failedLowAtRoot
1617                          &&  elapsed > TimeMgr.available_time() * 75 / 100;
1618
1619   bool noMoreTime =   elapsed > TimeMgr.maximum_time() - 2 * TimerThread::Resolution
1620                    || stillAtFirstMove;
1621
1622   if (   (Limits.use_time_management() && noMoreTime)
1623       || (Limits.movetime && elapsed >= Limits.movetime)
1624       || (Limits.nodes && nodes >= Limits.nodes))
1625       Signals.stop = true;
1626 }