Rescale UCI scores to PawnValueEg
[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 * int(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 * int(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 ? floor(   pvRed * int(ONE_PLY)) : 0);
133       Reductions[0][1][hd][mc] = (int8_t) (nonPVRed >= 1.0 ? floor(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 + Value(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                             + Value(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 Signals.stop is true, the search
936       // was aborted because the user interrupted the search or because we
937       // ran out of time. In this case, the return value of the search cannot
938       // be trusted, and we don't update the best move and/or PV.
939       if (Signals.stop || thisThread->cutoff_occurred())
940           return value; // To avoid returning VALUE_INFINITE
941
942       if (RootNode)
943       {
944           RootMove& rm = *std::find(RootMoves.begin(), RootMoves.end(), move);
945
946           // PV move or new best move ?
947           if (pvMove || value > alpha)
948           {
949               rm.score = value;
950               rm.extract_pv_from_tt(pos);
951
952               // We record how often the best move has been changed in each
953               // iteration. This information is used for time management: When
954               // the best move changes frequently, we allocate some more time.
955               if (!pvMove)
956                   ++BestMoveChanges;
957           }
958           else
959               // All other moves but the PV are set to the lowest value: this is
960               // not a problem when sorting because the sort is stable and the
961               // move position in the list is preserved - just the PV is pushed up.
962               rm.score = -VALUE_INFINITE;
963       }
964
965       if (value > bestValue)
966       {
967           bestValue = SpNode ? splitPoint->bestValue = value : value;
968
969           if (value > alpha)
970           {
971               bestMove = SpNode ? splitPoint->bestMove = move : move;
972
973               if (PvNode && value < beta) // Update alpha! Always alpha < beta
974                   alpha = SpNode ? splitPoint->alpha = value : value;
975               else
976               {
977                   assert(value >= beta); // Fail high
978
979                   if (SpNode)
980                       splitPoint->cutoff = true;
981
982                   break;
983               }
984           }
985       }
986
987       // Step 19. Check for splitting the search
988       if (   !SpNode
989           &&  depth >= Threads.minimumSplitDepth
990           &&  Threads.available_slave(thisThread)
991           &&  thisThread->splitPointsSize < MAX_SPLITPOINTS_PER_THREAD)
992       {
993           assert(bestValue < beta);
994
995           thisThread->split<FakeSplit>(pos, ss, alpha, beta, &bestValue, &bestMove,
996                                        depth, moveCount, &mp, NT, cutNode);
997           if (bestValue >= beta)
998               break;
999       }
1000     }
1001
1002     if (SpNode)
1003         return bestValue;
1004
1005     // Step 20. Check for mate and stalemate
1006     // All legal moves have been searched and if there are no legal moves, it
1007     // must be mate or stalemate. Note that we can have a false positive in
1008     // case of Signals.stop or thread.cutoff_occurred() are set, but this is
1009     // harmless because return value is discarded anyhow in the parent nodes.
1010     // If we are in a singular extension search then return a fail low score.
1011     // A split node has at least one move - the one tried before to be split.
1012     if (!moveCount)
1013         return  excludedMove ? alpha
1014               : inCheck ? mated_in(ss->ply) : DrawValue[pos.side_to_move()];
1015
1016     // If we have pruned all the moves without searching return a fail-low score
1017     if (bestValue == -VALUE_INFINITE)
1018         bestValue = alpha;
1019
1020     TT.store(posKey, value_to_tt(bestValue, ss->ply),
1021              bestValue >= beta  ? BOUND_LOWER :
1022              PvNode && bestMove ? BOUND_EXACT : BOUND_UPPER,
1023              depth, bestMove, ss->staticEval);
1024
1025     // Quiet best move: update killers, history, countermoves and followupmoves
1026     if (bestValue >= beta && !pos.capture_or_promotion(bestMove) && !inCheck)
1027         update_stats(pos, ss, bestMove, depth, quietsSearched, quietCount - 1);
1028
1029     assert(bestValue > -VALUE_INFINITE && bestValue < VALUE_INFINITE);
1030
1031     return bestValue;
1032   }
1033
1034
1035   // qsearch() is the quiescence search function, which is called by the main
1036   // search function when the remaining depth is zero (or, to be more precise,
1037   // less than ONE_PLY).
1038
1039   template <NodeType NT, bool InCheck>
1040   Value qsearch(Position& pos, Stack* ss, Value alpha, Value beta, Depth depth) {
1041
1042     const bool PvNode = (NT == PV);
1043
1044     assert(NT == PV || NT == NonPV);
1045     assert(InCheck == !!pos.checkers());
1046     assert(alpha >= -VALUE_INFINITE && alpha < beta && beta <= VALUE_INFINITE);
1047     assert(PvNode || (alpha == beta - 1));
1048     assert(depth <= DEPTH_ZERO);
1049
1050     StateInfo st;
1051     const TTEntry* tte;
1052     Key posKey;
1053     Move ttMove, move, bestMove;
1054     Value bestValue, value, ttValue, futilityValue, futilityBase, oldAlpha;
1055     bool givesCheck, evasionPrunable;
1056     Depth ttDepth;
1057
1058     // To flag BOUND_EXACT a node with eval above alpha and no available moves
1059     if (PvNode)
1060         oldAlpha = alpha;
1061
1062     ss->currentMove = bestMove = MOVE_NONE;
1063     ss->ply = (ss-1)->ply + 1;
1064
1065     // Check for an instant draw or if the maximum ply has been reached
1066     if (pos.is_draw() || ss->ply > MAX_PLY)
1067         return ss->ply > MAX_PLY && !InCheck ? evaluate(pos) : DrawValue[pos.side_to_move()];
1068
1069     // Decide whether or not to include checks: this fixes also the type of
1070     // TT entry depth that we are going to use. Note that in qsearch we use
1071     // only two types of depth in TT: DEPTH_QS_CHECKS or DEPTH_QS_NO_CHECKS.
1072     ttDepth = InCheck || depth >= DEPTH_QS_CHECKS ? DEPTH_QS_CHECKS
1073                                                   : DEPTH_QS_NO_CHECKS;
1074
1075     // Transposition table lookup
1076     posKey = pos.key();
1077     tte = TT.probe(posKey);
1078     ttMove = tte ? tte->move() : MOVE_NONE;
1079     ttValue = tte ? value_from_tt(tte->value(),ss->ply) : VALUE_NONE;
1080
1081     if (   tte
1082         && tte->depth() >= ttDepth
1083         && ttValue != VALUE_NONE // Only in case of TT access race
1084         && (           PvNode ?  tte->bound() == BOUND_EXACT
1085             : ttValue >= beta ? (tte->bound() &  BOUND_LOWER)
1086                               : (tte->bound() &  BOUND_UPPER)))
1087     {
1088         ss->currentMove = ttMove; // Can be MOVE_NONE
1089         return ttValue;
1090     }
1091
1092     // Evaluate the position statically
1093     if (InCheck)
1094     {
1095         ss->staticEval = VALUE_NONE;
1096         bestValue = futilityBase = -VALUE_INFINITE;
1097     }
1098     else
1099     {
1100         if (tte)
1101         {
1102             // Never assume anything on values stored in TT
1103             if ((ss->staticEval = bestValue = tte->eval_value()) == VALUE_NONE)
1104                 ss->staticEval = bestValue = evaluate(pos);
1105
1106             // Can ttValue be used as a better position evaluation?
1107             if (ttValue != VALUE_NONE)
1108                 if (tte->bound() & (ttValue > bestValue ? BOUND_LOWER : BOUND_UPPER))
1109                     bestValue = ttValue;
1110         }
1111         else
1112             ss->staticEval = bestValue = evaluate(pos);
1113
1114         // Stand pat. Return immediately if static value is at least beta
1115         if (bestValue >= beta)
1116         {
1117             if (!tte)
1118                 TT.store(pos.key(), value_to_tt(bestValue, ss->ply), BOUND_LOWER,
1119                          DEPTH_NONE, MOVE_NONE, ss->staticEval);
1120
1121             return bestValue;
1122         }
1123
1124         if (PvNode && bestValue > alpha)
1125             alpha = bestValue;
1126
1127         futilityBase = bestValue + Value(128);
1128     }
1129
1130     // Initialize a MovePicker object for the current position, and prepare
1131     // to search the moves. Because the depth is <= 0 here, only captures,
1132     // queen promotions and checks (only if depth >= DEPTH_QS_CHECKS) will
1133     // be generated.
1134     MovePicker mp(pos, ttMove, depth, History, to_sq((ss-1)->currentMove));
1135     CheckInfo ci(pos);
1136
1137     // Loop through the moves until no moves remain or a beta cutoff occurs
1138     while ((move = mp.next_move<false>()) != MOVE_NONE)
1139     {
1140       assert(is_ok(move));
1141
1142       givesCheck =  type_of(move) == NORMAL && !ci.dcCandidates
1143                   ? ci.checkSq[type_of(pos.piece_on(from_sq(move)))] & to_sq(move)
1144                   : pos.gives_check(move, ci);
1145
1146       // Futility pruning
1147       if (   !PvNode
1148           && !InCheck
1149           && !givesCheck
1150           &&  move != ttMove
1151           &&  futilityBase > -VALUE_KNOWN_WIN
1152           && !pos.advanced_pawn_push(move))
1153       {
1154           assert(type_of(move) != ENPASSANT); // Due to !pos.advanced_pawn_push
1155
1156           futilityValue = futilityBase + PieceValue[EG][pos.piece_on(to_sq(move))];
1157
1158           if (futilityValue < beta)
1159           {
1160               bestValue = std::max(bestValue, futilityValue);
1161               continue;
1162           }
1163
1164           if (futilityBase < beta && pos.see(move) <= VALUE_ZERO)
1165           {
1166               bestValue = std::max(bestValue, futilityBase);
1167               continue;
1168           }
1169       }
1170
1171       // Detect non-capture evasions that are candidates to be pruned
1172       evasionPrunable =    InCheck
1173                        &&  bestValue > VALUE_MATED_IN_MAX_PLY
1174                        && !pos.capture(move)
1175                        && !pos.can_castle(pos.side_to_move());
1176
1177       // Don't search moves with negative SEE values
1178       if (   !PvNode
1179           && (!InCheck || evasionPrunable)
1180           &&  move != ttMove
1181           &&  type_of(move) != PROMOTION
1182           &&  pos.see_sign(move) < VALUE_ZERO)
1183           continue;
1184
1185       // Check for legality just before making the move
1186       if (!pos.legal(move, ci.pinned))
1187           continue;
1188
1189       ss->currentMove = move;
1190
1191       // Make and search the move
1192       pos.do_move(move, st, ci, givesCheck);
1193       value = givesCheck ? -qsearch<NT,  true>(pos, ss+1, -beta, -alpha, depth - ONE_PLY)
1194                          : -qsearch<NT, false>(pos, ss+1, -beta, -alpha, depth - ONE_PLY);
1195       pos.undo_move(move);
1196
1197       assert(value > -VALUE_INFINITE && value < VALUE_INFINITE);
1198
1199       // Check for new best move
1200       if (value > bestValue)
1201       {
1202           bestValue = value;
1203
1204           if (value > alpha)
1205           {
1206               if (PvNode && value < beta) // Update alpha here! Always alpha < beta
1207               {
1208                   alpha = value;
1209                   bestMove = move;
1210               }
1211               else // Fail high
1212               {
1213                   TT.store(posKey, value_to_tt(value, ss->ply), BOUND_LOWER,
1214                            ttDepth, move, ss->staticEval);
1215
1216                   return value;
1217               }
1218           }
1219        }
1220     }
1221
1222     // All legal moves have been searched. A special case: If we're in check
1223     // and no legal moves were found, it is checkmate.
1224     if (InCheck && bestValue == -VALUE_INFINITE)
1225         return mated_in(ss->ply); // Plies to mate from the root
1226
1227     TT.store(posKey, value_to_tt(bestValue, ss->ply),
1228              PvNode && bestValue > oldAlpha ? BOUND_EXACT : BOUND_UPPER,
1229              ttDepth, bestMove, ss->staticEval);
1230
1231     assert(bestValue > -VALUE_INFINITE && bestValue < VALUE_INFINITE);
1232
1233     return bestValue;
1234   }
1235
1236
1237   // value_to_tt() adjusts a mate score from "plies to mate from the root" to
1238   // "plies to mate from the current position". Non-mate scores are unchanged.
1239   // The function is called before storing a value in the transposition table.
1240
1241   Value value_to_tt(Value v, int ply) {
1242
1243     assert(v != VALUE_NONE);
1244
1245     return  v >= VALUE_MATE_IN_MAX_PLY  ? v + ply
1246           : v <= VALUE_MATED_IN_MAX_PLY ? v - ply : v;
1247   }
1248
1249
1250   // value_from_tt() is the inverse of value_to_tt(): It adjusts a mate score
1251   // from the transposition table (which refers to the plies to mate/be mated
1252   // from current position) to "plies to mate/be mated from the root".
1253
1254   Value value_from_tt(Value v, int ply) {
1255
1256     return  v == VALUE_NONE             ? VALUE_NONE
1257           : v >= VALUE_MATE_IN_MAX_PLY  ? v - ply
1258           : v <= VALUE_MATED_IN_MAX_PLY ? v + ply : v;
1259   }
1260
1261
1262   // update_stats() updates killers, history, countermoves and followupmoves stats after a fail-high
1263   // of a quiet move.
1264
1265   void update_stats(Position& pos, Stack* ss, Move move, Depth depth, Move* quiets, int quietsCnt) {
1266
1267     if (ss->killers[0] != move)
1268     {
1269         ss->killers[1] = ss->killers[0];
1270         ss->killers[0] = move;
1271     }
1272
1273     // Increase history value of the cut-off move and decrease all the other
1274     // played quiet moves.
1275     Value bonus = Value(int(depth) * int(depth));
1276     History.update(pos.moved_piece(move), to_sq(move), bonus);
1277     for (int i = 0; i < quietsCnt; ++i)
1278     {
1279         Move m = quiets[i];
1280         History.update(pos.moved_piece(m), to_sq(m), -bonus);
1281     }
1282
1283     if (is_ok((ss-1)->currentMove))
1284     {
1285         Square prevMoveSq = to_sq((ss-1)->currentMove);
1286         Countermoves.update(pos.piece_on(prevMoveSq), prevMoveSq, move);
1287     }
1288
1289     if (is_ok((ss-2)->currentMove) && (ss-1)->currentMove == (ss-1)->ttMove)
1290     {
1291         Square prevOwnMoveSq = to_sq((ss-2)->currentMove);
1292         Followupmoves.update(pos.piece_on(prevOwnMoveSq), prevOwnMoveSq, move);
1293     }
1294   }
1295
1296
1297   // When playing with a strength handicap, choose best move among the MultiPV
1298   // set using a statistical rule dependent on 'level'. Idea by Heinz van Saanen.
1299
1300   Move Skill::pick_move() {
1301
1302     static RKISS rk;
1303
1304     // PRNG sequence should be not deterministic
1305     for (int i = Time::now() % 50; i > 0; --i)
1306         rk.rand<unsigned>();
1307
1308     // RootMoves are already sorted by score in descending order
1309     int variance = std::min(RootMoves[0].score - RootMoves[MultiPV - 1].score, PawnValueMg);
1310     int weakness = 120 - 2 * level;
1311     int max_s = -VALUE_INFINITE;
1312     best = MOVE_NONE;
1313
1314     // Choose best move. For each move score we add two terms both dependent on
1315     // weakness. One deterministic and bigger for weaker moves, and one random,
1316     // then we choose the move with the resulting highest score.
1317     for (size_t i = 0; i < MultiPV; ++i)
1318     {
1319         int s = RootMoves[i].score;
1320
1321         // Don't allow crazy blunders even at very low skills
1322         if (i > 0 && RootMoves[i-1].score > s + 2 * PawnValueMg)
1323             break;
1324
1325         // This is our magic formula
1326         s += (  weakness * int(RootMoves[0].score - s)
1327               + variance * (rk.rand<unsigned>() % weakness)) / 128;
1328
1329         if (s > max_s)
1330         {
1331             max_s = s;
1332             best = RootMoves[i].pv[0];
1333         }
1334     }
1335     return best;
1336   }
1337
1338
1339   // uci_pv() formats PV information according to the UCI protocol. UCI
1340   // requires that all (if any) unsearched PV lines are sent using a previous
1341   // search score.
1342
1343   string uci_pv(const Position& pos, int depth, Value alpha, Value beta) {
1344
1345     std::stringstream ss;
1346     Time::point elapsed = Time::now() - SearchTime + 1;
1347     size_t uciPVSize = std::min((size_t)Options["MultiPV"], RootMoves.size());
1348     int selDepth = 0;
1349
1350     for (size_t i = 0; i < Threads.size(); ++i)
1351         if (Threads[i]->maxPly > selDepth)
1352             selDepth = Threads[i]->maxPly;
1353
1354     for (size_t i = 0; i < uciPVSize; ++i)
1355     {
1356         bool updated = (i <= PVIdx);
1357
1358         if (depth == 1 && !updated)
1359             continue;
1360
1361         int d   = updated ? depth : depth - 1;
1362         Value v = updated ? RootMoves[i].score : RootMoves[i].prevScore;
1363
1364         if (ss.rdbuf()->in_avail()) // Not at first line
1365             ss << "\n";
1366
1367         ss << "info depth " << d
1368            << " seldepth "  << selDepth
1369            << " score "     << (i == PVIdx ? score_to_uci(v, alpha, beta) : score_to_uci(v))
1370            << " nodes "     << pos.nodes_searched()
1371            << " nps "       << pos.nodes_searched() * 1000 / elapsed
1372            << " time "      << elapsed
1373            << " multipv "   << i + 1
1374            << " pv";
1375
1376         for (size_t j = 0; RootMoves[i].pv[j] != MOVE_NONE; ++j)
1377             ss << " " << move_to_uci(RootMoves[i].pv[j], pos.is_chess960());
1378     }
1379
1380     return ss.str();
1381   }
1382
1383 } // namespace
1384
1385
1386 /// RootMove::extract_pv_from_tt() builds a PV by adding moves from the TT table.
1387 /// We also consider both failing high nodes and BOUND_EXACT nodes here to
1388 /// ensure that we have a ponder move even when we fail high at root. This
1389 /// results in a long PV to print that is important for position analysis.
1390
1391 void RootMove::extract_pv_from_tt(Position& pos) {
1392
1393   StateInfo state[MAX_PLY_PLUS_6], *st = state;
1394   const TTEntry* tte;
1395   int ply = 0;
1396   Move m = pv[0];
1397
1398   pv.clear();
1399
1400   do {
1401       pv.push_back(m);
1402
1403       assert(MoveList<LEGAL>(pos).contains(pv[ply]));
1404
1405       pos.do_move(pv[ply++], *st++);
1406       tte = TT.probe(pos.key());
1407
1408   } while (   tte
1409            && pos.pseudo_legal(m = tte->move()) // Local copy, TT could change
1410            && pos.legal(m, pos.pinned_pieces(pos.side_to_move()))
1411            && ply < MAX_PLY
1412            && (!pos.is_draw() || ply < 2));
1413
1414   pv.push_back(MOVE_NONE); // Must be zero-terminating
1415
1416   while (ply) pos.undo_move(pv[--ply]);
1417 }
1418
1419
1420 /// RootMove::insert_pv_in_tt() is called at the end of a search iteration, and
1421 /// inserts the PV back into the TT. This makes sure the old PV moves are searched
1422 /// first, even if the old TT entries have been overwritten.
1423
1424 void RootMove::insert_pv_in_tt(Position& pos) {
1425
1426   StateInfo state[MAX_PLY_PLUS_6], *st = state;
1427   const TTEntry* tte;
1428   int ply = 0;
1429
1430   do {
1431       tte = TT.probe(pos.key());
1432
1433       if (!tte || tte->move() != pv[ply]) // Don't overwrite correct entries
1434           TT.store(pos.key(), VALUE_NONE, BOUND_NONE, DEPTH_NONE, pv[ply], VALUE_NONE);
1435
1436       assert(MoveList<LEGAL>(pos).contains(pv[ply]));
1437
1438       pos.do_move(pv[ply++], *st++);
1439
1440   } while (pv[ply] != MOVE_NONE);
1441
1442   while (ply) pos.undo_move(pv[--ply]);
1443 }
1444
1445
1446 /// Thread::idle_loop() is where the thread is parked when it has no work to do
1447
1448 void Thread::idle_loop() {
1449
1450   // Pointer 'this_sp' is not null only if we are called from split(), and not
1451   // at the thread creation. This means we are the split point's master.
1452   SplitPoint* this_sp = splitPointsSize ? activeSplitPoint : NULL;
1453
1454   assert(!this_sp || (this_sp->masterThread == this && searching));
1455
1456   while (true)
1457   {
1458       // If we are not searching, wait for a condition to be signaled instead of
1459       // wasting CPU time polling for work.
1460       while ((!searching && Threads.sleepWhileIdle) || exit)
1461       {
1462           if (exit)
1463           {
1464               assert(!this_sp);
1465               return;
1466           }
1467
1468           // Grab the lock to avoid races with Thread::notify_one()
1469           mutex.lock();
1470
1471           // If we are master and all slaves have finished then exit idle_loop
1472           if (this_sp && this_sp->slavesMask.none())
1473           {
1474               mutex.unlock();
1475               break;
1476           }
1477
1478           // Do sleep after retesting sleep conditions under lock protection. In
1479           // particular we need to avoid a deadlock in case a master thread has,
1480           // in the meanwhile, allocated us and sent the notify_one() call before
1481           // we had the chance to grab the lock.
1482           if (!searching && !exit)
1483               sleepCondition.wait(mutex);
1484
1485           mutex.unlock();
1486       }
1487
1488       // If this thread has been assigned work, launch a search
1489       if (searching)
1490       {
1491           assert(!exit);
1492
1493           Threads.mutex.lock();
1494
1495           assert(searching);
1496           assert(activeSplitPoint);
1497           SplitPoint* sp = activeSplitPoint;
1498
1499           Threads.mutex.unlock();
1500
1501           Stack stack[MAX_PLY_PLUS_6], *ss = stack+2; // To allow referencing (ss-2)
1502           Position pos(*sp->pos, this);
1503
1504           std::memcpy(ss-2, sp->ss-2, 5 * sizeof(Stack));
1505           ss->splitPoint = sp;
1506
1507           sp->mutex.lock();
1508
1509           assert(activePosition == NULL);
1510
1511           activePosition = &pos;
1512
1513           switch (sp->nodeType) {
1514           case Root:
1515               search<SplitPointRoot>(pos, ss, sp->alpha, sp->beta, sp->depth, sp->cutNode);
1516               break;
1517           case PV:
1518               search<SplitPointPV>(pos, ss, sp->alpha, sp->beta, sp->depth, sp->cutNode);
1519               break;
1520           case NonPV:
1521               search<SplitPointNonPV>(pos, ss, sp->alpha, sp->beta, sp->depth, sp->cutNode);
1522               break;
1523           default:
1524               assert(false);
1525           }
1526
1527           assert(searching);
1528
1529           searching = false;
1530           activePosition = NULL;
1531           sp->slavesMask.reset(idx);
1532           sp->nodes += pos.nodes_searched();
1533
1534           // Wake up the master thread so to allow it to return from the idle
1535           // loop in case we are the last slave of the split point.
1536           if (    Threads.sleepWhileIdle
1537               &&  this != sp->masterThread
1538               &&  sp->slavesMask.none())
1539           {
1540               assert(!sp->masterThread->searching);
1541               sp->masterThread->notify_one();
1542           }
1543
1544           // After releasing the lock we can't access any SplitPoint related data
1545           // in a safe way because it could have been released under our feet by
1546           // the sp master. Also accessing other Thread objects is unsafe because
1547           // if we are exiting there is a chance that they are already freed.
1548           sp->mutex.unlock();
1549       }
1550
1551       // If this thread is the master of a split point and all slaves have finished
1552       // their work at this split point, return from the idle loop.
1553       if (this_sp && this_sp->slavesMask.none())
1554       {
1555           this_sp->mutex.lock();
1556           bool finished = this_sp->slavesMask.none(); // Retest under lock protection
1557           this_sp->mutex.unlock();
1558           if (finished)
1559               return;
1560       }
1561   }
1562 }
1563
1564
1565 /// check_time() is called by the timer thread when the timer triggers. It is
1566 /// used to print debug info and, more importantly, to detect when we are out of
1567 /// available time and thus stop the search.
1568
1569 void check_time() {
1570
1571   static Time::point lastInfoTime = Time::now();
1572   int64_t nodes = 0; // Workaround silly 'uninitialized' gcc warning
1573
1574   if (Time::now() - lastInfoTime >= 1000)
1575   {
1576       lastInfoTime = Time::now();
1577       dbg_print();
1578   }
1579
1580   if (Limits.ponder)
1581       return;
1582
1583   if (Limits.nodes)
1584   {
1585       Threads.mutex.lock();
1586
1587       nodes = RootPos.nodes_searched();
1588
1589       // Loop across all split points and sum accumulated SplitPoint nodes plus
1590       // all the currently active positions nodes.
1591       for (size_t i = 0; i < Threads.size(); ++i)
1592           for (int j = 0; j < Threads[i]->splitPointsSize; ++j)
1593           {
1594               SplitPoint& sp = Threads[i]->splitPoints[j];
1595
1596               sp.mutex.lock();
1597
1598               nodes += sp.nodes;
1599
1600               for (size_t idx = 0; idx < Threads.size(); ++idx)
1601                   if (sp.slavesMask.test(idx) && Threads[idx]->activePosition)
1602                       nodes += Threads[idx]->activePosition->nodes_searched();
1603
1604               sp.mutex.unlock();
1605           }
1606
1607       Threads.mutex.unlock();
1608   }
1609
1610   Time::point elapsed = Time::now() - SearchTime;
1611   bool stillAtFirstMove =    Signals.firstRootMove
1612                          && !Signals.failedLowAtRoot
1613                          &&  elapsed > TimeMgr.available_time() * 75 / 100;
1614
1615   bool noMoreTime =   elapsed > TimeMgr.maximum_time() - 2 * TimerThread::Resolution
1616                    || stillAtFirstMove;
1617
1618   if (   (Limits.use_time_management() && noMoreTime)
1619       || (Limits.movetime && elapsed >= Limits.movetime)
1620       || (Limits.nodes && nodes >= Limits.nodes))
1621       Signals.stop = true;
1622 }