]> git.sesse.net Git - stockfish/blob - src/search.cpp
Update various comments
[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-2015 Marco Costalba, Joona Kiiski, Tord Romstad
5   Copyright (C) 2015-2018 Marco Costalba, Joona Kiiski, Gary Linscott, Tord Romstad
6
7   Stockfish is free software: you can redistribute it and/or modify
8   it under the terms of the GNU General Public License as published by
9   the Free Software Foundation, either version 3 of the License, or
10   (at your option) any later version.
11
12   Stockfish is distributed in the hope that it will be useful,
13   but WITHOUT ANY WARRANTY; without even the implied warranty of
14   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
15   GNU General Public License for more details.
16
17   You should have received a copy of the GNU General Public License
18   along with this program.  If not, see <http://www.gnu.org/licenses/>.
19 */
20
21 #include <algorithm>
22 #include <cassert>
23 #include <cmath>
24 #include <cstring>   // For std::memset
25 #include <iostream>
26 #include <sstream>
27
28 #include "evaluate.h"
29 #include "misc.h"
30 #include "movegen.h"
31 #include "movepick.h"
32 #include "position.h"
33 #include "search.h"
34 #include "thread.h"
35 #include "timeman.h"
36 #include "tt.h"
37 #include "uci.h"
38 #include "syzygy/tbprobe.h"
39
40 namespace Search {
41
42   LimitsType Limits;
43 }
44
45 namespace Tablebases {
46
47   int Cardinality;
48   bool RootInTB;
49   bool UseRule50;
50   Depth ProbeDepth;
51 }
52
53 namespace TB = Tablebases;
54
55 using std::string;
56 using Eval::evaluate;
57 using namespace Search;
58
59 namespace {
60
61   // Different node types, used as a template parameter
62   enum NodeType { NonPV, PV };
63
64   // Sizes and phases of the skip-blocks, used for distributing search depths across the threads
65   constexpr int SkipSize[]  = { 1, 1, 2, 2, 2, 2, 3, 3, 3, 3, 3, 3, 4, 4, 4, 4, 4, 4, 4, 4 };
66   constexpr int SkipPhase[] = { 0, 1, 0, 1, 2, 3, 0, 1, 2, 3, 4, 5, 0, 1, 2, 3, 4, 5, 6, 7 };
67
68   // Razor and futility margins
69   constexpr int RazorMargin[] = {0, 590, 604};
70   Value futility_margin(Depth d, bool improving) {
71     return Value((175 - 50 * improving) * d / ONE_PLY);
72   }
73
74   // Margin for pruning capturing moves: almost linear in depth
75   constexpr int CapturePruneMargin[] = { 0,
76                                          1 * PawnValueEg * 1055 / 1000,
77                                          2 * PawnValueEg * 1042 / 1000,
78                                          3 * PawnValueEg * 963  / 1000,
79                                          4 * PawnValueEg * 1038 / 1000,
80                                          5 * PawnValueEg * 950  / 1000,
81                                          6 * PawnValueEg * 930  / 1000
82                                        };
83
84   // Futility and reductions lookup tables, initialized at startup
85   int FutilityMoveCounts[2][16]; // [improving][depth]
86   int Reductions[2][2][64][64];  // [pv][improving][depth][moveNumber]
87
88   template <bool PvNode> Depth reduction(bool i, Depth d, int mn) {
89     return Reductions[PvNode][i][std::min(d / ONE_PLY, 63)][std::min(mn, 63)] * ONE_PLY;
90   }
91
92   // History and stats update bonus, based on depth
93   int stat_bonus(Depth depth) {
94     int d = depth / ONE_PLY;
95     return d > 17 ? 0 : 32 * d * d + 64 * d - 64;
96   }
97
98   // Skill structure is used to implement strength limit
99   struct Skill {
100     explicit Skill(int l) : level(l) {}
101     bool enabled() const { return level < 20; }
102     bool time_to_pick(Depth depth) const { return depth / ONE_PLY == 1 + level; }
103     Move pick_best(size_t multiPV);
104
105     int level;
106     Move best = MOVE_NONE;
107   };
108
109   template <NodeType NT>
110   Value search(Position& pos, Stack* ss, Value alpha, Value beta, Depth depth, bool cutNode, bool skipEarlyPruning);
111
112   template <NodeType NT>
113   Value qsearch(Position& pos, Stack* ss, Value alpha, Value beta, Depth depth = DEPTH_ZERO);
114
115   Value value_to_tt(Value v, int ply);
116   Value value_from_tt(Value v, int ply);
117   void update_pv(Move* pv, Move move, Move* childPv);
118   void update_continuation_histories(Stack* ss, Piece pc, Square to, int bonus);
119   void update_quiet_stats(const Position& pos, Stack* ss, Move move, Move* quiets, int quietsCnt, int bonus);
120   void update_capture_stats(const Position& pos, Move move, Move* captures, int captureCnt, int bonus);
121
122   inline bool gives_check(const Position& pos, Move move) {
123     Color us = pos.side_to_move();
124     return  type_of(move) == NORMAL && !(pos.blockers_for_king(~us) & pos.pieces(us))
125           ? pos.check_squares(type_of(pos.moved_piece(move))) & to_sq(move)
126           : pos.gives_check(move);
127   }
128
129   // perft() is our utility to verify move generation. All the leaf nodes up
130   // to the given depth are generated and counted, and the sum is returned.
131   template<bool Root>
132   uint64_t perft(Position& pos, Depth depth) {
133
134     StateInfo st;
135     uint64_t cnt, nodes = 0;
136     const bool leaf = (depth == 2 * ONE_PLY);
137
138     for (const auto& m : MoveList<LEGAL>(pos))
139     {
140         if (Root && depth <= ONE_PLY)
141             cnt = 1, nodes++;
142         else
143         {
144             pos.do_move(m, st);
145             cnt = leaf ? MoveList<LEGAL>(pos).size() : perft<false>(pos, depth - ONE_PLY);
146             nodes += cnt;
147             pos.undo_move(m);
148         }
149         if (Root)
150             sync_cout << UCI::move(m, pos.is_chess960()) << ": " << cnt << sync_endl;
151     }
152     return nodes;
153   }
154
155 } // namespace
156
157
158 /// Search::init() is called at startup to initialize various lookup tables
159
160 void Search::init() {
161
162   for (int imp = 0; imp <= 1; ++imp)
163       for (int d = 1; d < 64; ++d)
164           for (int mc = 1; mc < 64; ++mc)
165           {
166               double r = log(d) * log(mc) / 1.95;
167
168               Reductions[NonPV][imp][d][mc] = int(std::round(r));
169               Reductions[PV][imp][d][mc] = std::max(Reductions[NonPV][imp][d][mc] - 1, 0);
170
171               // Increase reduction for non-PV nodes when eval is not improving
172               if (!imp && r > 1.0)
173                 Reductions[NonPV][imp][d][mc]++;
174           }
175
176   for (int d = 0; d < 16; ++d)
177   {
178       FutilityMoveCounts[0][d] = int(2.4 + 0.74 * pow(d, 1.78));
179       FutilityMoveCounts[1][d] = int(5.0 + 1.00 * pow(d, 2.00));
180   }
181 }
182
183
184 /// Search::clear() resets search state to its initial value
185
186 void Search::clear() {
187
188   Threads.main()->wait_for_search_finished();
189
190   Time.availableNodes = 0;
191   TT.clear();
192   Threads.clear();
193 }
194
195
196 /// MainThread::search() is called by the main thread when the program receives
197 /// the UCI 'go' command. It searches from the root position and outputs the "bestmove".
198
199 void MainThread::search() {
200
201   if (Limits.perft)
202   {
203       nodes = perft<true>(rootPos, Limits.perft * ONE_PLY);
204       sync_cout << "\nNodes searched: " << nodes << "\n" << sync_endl;
205       return;
206   }
207
208   Color us = rootPos.side_to_move();
209   Time.init(Limits, us, rootPos.game_ply());
210   TT.new_search();
211
212   if (rootMoves.empty())
213   {
214       rootMoves.emplace_back(MOVE_NONE);
215       sync_cout << "info depth 0 score "
216                 << UCI::value(rootPos.checkers() ? -VALUE_MATE : VALUE_DRAW)
217                 << sync_endl;
218   }
219   else
220   {
221       for (Thread* th : Threads)
222           if (th != this)
223               th->start_searching();
224
225       Thread::search(); // Let's start searching!
226   }
227
228   // When we reach the maximum depth, we can arrive here without a raise of
229   // Threads.stop. However, if we are pondering or in an infinite search,
230   // the UCI protocol states that we shouldn't print the best move before the
231   // GUI sends a "stop" or "ponderhit" command. We therefore simply wait here
232   // until the GUI sends one of those commands (which also raises Threads.stop).
233   Threads.stopOnPonderhit = true;
234
235   while (!Threads.stop && (Threads.ponder || Limits.infinite))
236   {} // Busy wait for a stop or a ponder reset
237
238   // Stop the threads if not already stopped (also raise the stop if
239   // "ponderhit" just reset Threads.ponder).
240   Threads.stop = true;
241
242   // Wait until all threads have finished
243   for (Thread* th : Threads)
244       if (th != this)
245           th->wait_for_search_finished();
246
247   // When playing in 'nodes as time' mode, subtract the searched nodes from
248   // the available ones before exiting.
249   if (Limits.npmsec)
250       Time.availableNodes += Limits.inc[us] - Threads.nodes_searched();
251
252   // Check if there are threads with a better score than main thread
253   Thread* bestThread = this;
254   if (    Options["MultiPV"] == 1
255       && !Limits.depth
256       && !Skill(Options["Skill Level"]).enabled()
257       &&  rootMoves[0].pv[0] != MOVE_NONE)
258   {
259       for (Thread* th : Threads)
260       {
261           Depth depthDiff = th->completedDepth - bestThread->completedDepth;
262           Value scoreDiff = th->rootMoves[0].score - bestThread->rootMoves[0].score;
263
264           // Select the thread with the best score, always if it is a mate
265           if (    scoreDiff > 0
266               && (depthDiff >= 0 || th->rootMoves[0].score >= VALUE_MATE_IN_MAX_PLY))
267               bestThread = th;
268       }
269   }
270
271   previousScore = bestThread->rootMoves[0].score;
272
273   // Send again PV info if we have a new best thread
274   if (bestThread != this)
275       sync_cout << UCI::pv(bestThread->rootPos, bestThread->completedDepth, -VALUE_INFINITE, VALUE_INFINITE) << sync_endl;
276
277   sync_cout << "bestmove " << UCI::move(bestThread->rootMoves[0].pv[0], rootPos.is_chess960());
278
279   if (bestThread->rootMoves[0].pv.size() > 1 || bestThread->rootMoves[0].extract_ponder_from_tt(rootPos))
280       std::cout << " ponder " << UCI::move(bestThread->rootMoves[0].pv[1], rootPos.is_chess960());
281
282   std::cout << sync_endl;
283 }
284
285
286 /// Thread::search() is the main iterative deepening loop. It calls search()
287 /// repeatedly with increasing depth until the allocated thinking time has been
288 /// consumed, the user stops the search, or the maximum search depth is reached.
289
290 void Thread::search() {
291
292   Stack stack[MAX_PLY+7], *ss = stack+4; // To reference from (ss-4) to (ss+2)
293   Value bestValue, alpha, beta, delta;
294   Move  lastBestMove = MOVE_NONE;
295   Depth lastBestMoveDepth = DEPTH_ZERO;
296   MainThread* mainThread = (this == Threads.main() ? Threads.main() : nullptr);
297   double timeReduction = 1.0;
298   Color us = rootPos.side_to_move();
299
300   std::memset(ss-4, 0, 7 * sizeof(Stack));
301   for (int i = 4; i > 0; i--)
302      (ss-i)->contHistory = this->contHistory[NO_PIECE][0].get(); // Use as sentinel
303
304   bestValue = delta = alpha = -VALUE_INFINITE;
305   beta = VALUE_INFINITE;
306
307   if (mainThread)
308       mainThread->bestMoveChanges = 0, mainThread->failedLow = false;
309
310   size_t multiPV = Options["MultiPV"];
311   Skill skill(Options["Skill Level"]);
312
313   // When playing with strength handicap enable MultiPV search that we will
314   // use behind the scenes to retrieve a set of possible moves.
315   if (skill.enabled())
316       multiPV = std::max(multiPV, (size_t)4);
317
318   multiPV = std::min(multiPV, rootMoves.size());
319
320   int ct = int(Options["Contempt"]) * PawnValueEg / 100; // From centipawns
321
322   // In analysis mode, adjust contempt in accordance with user preference
323   if (Limits.infinite || Options["UCI_AnalyseMode"])
324       ct =  Options["Analysis Contempt"] == "Off"  ? 0
325           : Options["Analysis Contempt"] == "Both" ? ct
326           : Options["Analysis Contempt"] == "White" && us == BLACK ? -ct
327           : Options["Analysis Contempt"] == "Black" && us == WHITE ? -ct
328           : ct;
329
330   // In evaluate.cpp the evaluation is from the white point of view
331   contempt = (us == WHITE ?  make_score(ct, ct / 2)
332                           : -make_score(ct, ct / 2));
333
334   // Iterative deepening loop until requested to stop or the target depth is reached
335   while (   (rootDepth += ONE_PLY) < DEPTH_MAX
336          && !Threads.stop
337          && !(Limits.depth && mainThread && rootDepth / ONE_PLY > Limits.depth))
338   {
339       // Distribute search depths across the helper threads
340       if (idx > 0)
341       {
342           int i = (idx - 1) % 20;
343           if (((rootDepth / ONE_PLY + rootPos.game_ply() + SkipPhase[i]) / SkipSize[i]) % 2)
344               continue;  // Retry with an incremented rootDepth
345       }
346
347       // Age out PV variability metric
348       if (mainThread)
349           mainThread->bestMoveChanges *= 0.517, mainThread->failedLow = false;
350
351       // Save the last iteration's scores before first PV line is searched and
352       // all the move scores except the (new) PV are set to -VALUE_INFINITE.
353       for (RootMove& rm : rootMoves)
354           rm.previousScore = rm.score;
355
356       size_t PVFirst = 0;
357       PVLast = 0;
358
359       // MultiPV loop. We perform a full root search for each PV line
360       for (PVIdx = 0; PVIdx < multiPV && !Threads.stop; ++PVIdx)
361       {
362           if (PVIdx == PVLast)
363           {
364               PVFirst = PVLast;
365               for (PVLast++; PVLast < rootMoves.size(); PVLast++)
366                   if (rootMoves[PVLast].TBRank != rootMoves[PVFirst].TBRank)
367                       break;
368           }
369
370           // Reset UCI info selDepth for each depth and each PV line
371           selDepth = 0;
372
373           // Reset aspiration window starting size
374           if (rootDepth >= 5 * ONE_PLY)
375           {
376               Value previousScore = rootMoves[PVIdx].previousScore;
377               delta = Value(18);
378               alpha = std::max(previousScore - delta,-VALUE_INFINITE);
379               beta  = std::min(previousScore + delta, VALUE_INFINITE);
380
381               // Adjust contempt based on root move's previousScore (dynamic contempt)
382               int dct = ct + 88 * previousScore / (abs(previousScore) + 200);
383
384               contempt = (us == WHITE ?  make_score(dct, dct / 2)
385                                       : -make_score(dct, dct / 2));
386           }
387
388           // Start with a small aspiration window and, in the case of a fail
389           // high/low, re-search with a bigger window until we don't fail
390           // high/low anymore.
391           while (true)
392           {
393               bestValue = ::search<PV>(rootPos, ss, alpha, beta, rootDepth, false, false);
394
395               // Bring the best move to the front. It is critical that sorting
396               // is done with a stable algorithm because all the values but the
397               // first and eventually the new best one are set to -VALUE_INFINITE
398               // and we want to keep the same order for all the moves except the
399               // new PV that goes to the front. Note that in case of MultiPV
400               // search the already searched PV lines are preserved.
401               std::stable_sort(rootMoves.begin() + PVIdx, rootMoves.begin() + PVLast);
402
403               // If search has been stopped, we break immediately. Sorting is
404               // safe because RootMoves is still valid, although it refers to
405               // the previous iteration.
406               if (Threads.stop)
407                   break;
408
409               // When failing high/low give some update (without cluttering
410               // the UI) before a re-search.
411               if (   mainThread
412                   && multiPV == 1
413                   && (bestValue <= alpha || bestValue >= beta)
414                   && Time.elapsed() > 3000)
415                   sync_cout << UCI::pv(rootPos, rootDepth, alpha, beta) << sync_endl;
416
417               // In case of failing low/high increase aspiration window and
418               // re-search, otherwise exit the loop.
419               if (bestValue <= alpha)
420               {
421                   beta = (alpha + beta) / 2;
422                   alpha = std::max(bestValue - delta, -VALUE_INFINITE);
423
424                   if (mainThread)
425                   {
426                       mainThread->failedLow = true;
427                       Threads.stopOnPonderhit = false;
428                   }
429               }
430               else if (bestValue >= beta)
431                   beta = std::min(bestValue + delta, VALUE_INFINITE);
432               else
433                   break;
434
435               delta += delta / 4 + 5;
436
437               assert(alpha >= -VALUE_INFINITE && beta <= VALUE_INFINITE);
438           }
439
440           // Sort the PV lines searched so far and update the GUI
441           std::stable_sort(rootMoves.begin() + PVFirst, rootMoves.begin() + PVIdx + 1);
442
443           if (    mainThread
444               && (Threads.stop || PVIdx + 1 == multiPV || Time.elapsed() > 3000))
445               sync_cout << UCI::pv(rootPos, rootDepth, alpha, beta) << sync_endl;
446       }
447
448       if (!Threads.stop)
449           completedDepth = rootDepth;
450
451       if (rootMoves[0].pv[0] != lastBestMove) {
452          lastBestMove = rootMoves[0].pv[0];
453          lastBestMoveDepth = rootDepth;
454       }
455
456       // Have we found a "mate in x"?
457       if (   Limits.mate
458           && bestValue >= VALUE_MATE_IN_MAX_PLY
459           && VALUE_MATE - bestValue <= 2 * Limits.mate)
460           Threads.stop = true;
461
462       if (!mainThread)
463           continue;
464
465       // If skill level is enabled and time is up, pick a sub-optimal best move
466       if (skill.enabled() && skill.time_to_pick(rootDepth))
467           skill.pick_best(multiPV);
468
469       // Do we have time for the next iteration? Can we stop searching now?
470       if (    Limits.use_time_management()
471           && !Threads.stop
472           && !Threads.stopOnPonderhit)
473           {
474               const int F[] = { mainThread->failedLow,
475                                 bestValue - mainThread->previousScore };
476
477               int improvingFactor = std::max(246, std::min(832, 306 + 119 * F[0] - 6 * F[1]));
478
479               // If the bestMove is stable over several iterations, reduce time accordingly
480               timeReduction = 1.0;
481               for (int i : {3, 4, 5})
482                   if (lastBestMoveDepth * i < completedDepth)
483                      timeReduction *= 1.25;
484
485               // Use part of the gained time from a previous stable move for the current move
486               double bestMoveInstability = 1.0 + mainThread->bestMoveChanges;
487               bestMoveInstability *= std::pow(mainThread->previousTimeReduction, 0.528) / timeReduction;
488
489               // Stop the search if we have only one legal move, or if available time elapsed
490               if (   rootMoves.size() == 1
491                   || Time.elapsed() > Time.optimum() * bestMoveInstability * improvingFactor / 581)
492               {
493                   // If we are allowed to ponder do not stop the search now but
494                   // keep pondering until the GUI sends "ponderhit" or "stop".
495                   if (Threads.ponder)
496                       Threads.stopOnPonderhit = true;
497                   else
498                       Threads.stop = true;
499               }
500           }
501   }
502
503   if (!mainThread)
504       return;
505
506   mainThread->previousTimeReduction = timeReduction;
507
508   // If skill level is enabled, swap best PV line with the sub-optimal one
509   if (skill.enabled())
510       std::swap(rootMoves[0], *std::find(rootMoves.begin(), rootMoves.end(),
511                 skill.best ? skill.best : skill.pick_best(multiPV)));
512 }
513
514
515 namespace {
516
517   // search<>() is the main search function for both PV and non-PV nodes
518
519   template <NodeType NT>
520   Value search(Position& pos, Stack* ss, Value alpha, Value beta, Depth depth, bool cutNode, bool skipEarlyPruning) {
521
522     // Use quiescence search when needed
523     if (depth < ONE_PLY)
524         return qsearch<NT>(pos, ss, alpha, beta);
525
526     constexpr bool PvNode = NT == PV;
527     const bool rootNode = PvNode && ss->ply == 0;
528
529     assert(-VALUE_INFINITE <= alpha && alpha < beta && beta <= VALUE_INFINITE);
530     assert(PvNode || (alpha == beta - 1));
531     assert(DEPTH_ZERO < depth && depth < DEPTH_MAX);
532     assert(!(PvNode && cutNode));
533     assert(depth / ONE_PLY * ONE_PLY == depth);
534
535     Move pv[MAX_PLY+1], capturesSearched[32], quietsSearched[64];
536     StateInfo st;
537     TTEntry* tte;
538     Key posKey;
539     Move ttMove, move, excludedMove, bestMove;
540     Depth extension, newDepth;
541     Value bestValue, value, ttValue, eval, maxValue;
542     bool ttHit, inCheck, givesCheck, improving;
543     bool captureOrPromotion, doFullDepthSearch, moveCountPruning, skipQuiets, ttCapture, pvExact;
544     Piece movedPiece;
545     int moveCount, captureCount, quietCount;
546
547     // Step 1. Initialize node
548     Thread* thisThread = pos.this_thread();
549     inCheck = pos.checkers();
550     moveCount = captureCount = quietCount = ss->moveCount = 0;
551     bestValue = -VALUE_INFINITE;
552     maxValue = VALUE_INFINITE;
553
554     // Check for the available remaining time
555     if (thisThread == Threads.main())
556         static_cast<MainThread*>(thisThread)->check_time();
557
558     // Used to send selDepth info to GUI (selDepth counts from 1, ply from 0)
559     if (PvNode && thisThread->selDepth < ss->ply + 1)
560         thisThread->selDepth = ss->ply + 1;
561
562     if (!rootNode)
563     {
564         // Step 2. Check for aborted search and immediate draw
565         if (   Threads.stop.load(std::memory_order_relaxed)
566             || pos.is_draw(ss->ply)
567             || ss->ply >= MAX_PLY)
568             return (ss->ply >= MAX_PLY && !inCheck) ? evaluate(pos) : VALUE_DRAW;
569
570         // Step 3. Mate distance pruning. Even if we mate at the next move our score
571         // would be at best mate_in(ss->ply+1), but if alpha is already bigger because
572         // a shorter mate was found upward in the tree then there is no need to search
573         // because we will never beat the current alpha. Same logic but with reversed
574         // signs applies also in the opposite condition of being mated instead of giving
575         // mate. In this case return a fail-high score.
576         alpha = std::max(mated_in(ss->ply), alpha);
577         beta = std::min(mate_in(ss->ply+1), beta);
578         if (alpha >= beta)
579             return alpha;
580     }
581
582     assert(0 <= ss->ply && ss->ply < MAX_PLY);
583
584     (ss+1)->ply = ss->ply + 1;
585     ss->currentMove = (ss+1)->excludedMove = bestMove = MOVE_NONE;
586     ss->contHistory = thisThread->contHistory[NO_PIECE][0].get();
587     (ss+2)->killers[0] = (ss+2)->killers[1] = MOVE_NONE;
588     Square prevSq = to_sq((ss-1)->currentMove);
589
590     // Initialize statScore to zero for the grandchildren of the current position.
591     // So statScore is shared between all grandchildren and only the first grandchild
592     // starts with statScore = 0. Later grandchildren start with the last calculated
593     // statScore of the previous grandchild. This influences the reduction rules in
594     // LMR which are based on the statScore of parent position.
595     (ss+2)->statScore = 0;
596
597     // Step 4. Transposition table lookup. We don't want the score of a partial
598     // search to overwrite a previous full search TT value, so we use a different
599     // position key in case of an excluded move.
600     excludedMove = ss->excludedMove;
601     posKey = pos.key() ^ Key(excludedMove << 16); // Isn't a very good hash
602     tte = TT.probe(posKey, ttHit);
603     ttValue = ttHit ? value_from_tt(tte->value(), ss->ply) : VALUE_NONE;
604     ttMove =  rootNode ? thisThread->rootMoves[thisThread->PVIdx].pv[0]
605             : ttHit    ? tte->move() : MOVE_NONE;
606
607     // At non-PV nodes we check for an early TT cutoff
608     if (  !PvNode
609         && ttHit
610         && tte->depth() >= depth
611         && ttValue != VALUE_NONE // Possible in case of TT access race
612         && (ttValue >= beta ? (tte->bound() & BOUND_LOWER)
613                             : (tte->bound() & BOUND_UPPER)))
614     {
615         // If ttMove is quiet, update move sorting heuristics on TT hit
616         if (ttMove)
617         {
618             if (ttValue >= beta)
619             {
620                 if (!pos.capture_or_promotion(ttMove))
621                     update_quiet_stats(pos, ss, ttMove, nullptr, 0, stat_bonus(depth));
622
623                 // Extra penalty for a quiet TT move in previous ply when it gets refuted
624                 if ((ss-1)->moveCount == 1 && !pos.captured_piece())
625                     update_continuation_histories(ss-1, pos.piece_on(prevSq), prevSq, -stat_bonus(depth + ONE_PLY));
626             }
627             // Penalty for a quiet ttMove that fails low
628             else if (!pos.capture_or_promotion(ttMove))
629             {
630                 int penalty = -stat_bonus(depth);
631                 thisThread->mainHistory[pos.side_to_move()][from_to(ttMove)] << penalty;
632                 update_continuation_histories(ss, pos.moved_piece(ttMove), to_sq(ttMove), penalty);
633             }
634         }
635         return ttValue;
636     }
637
638     // Step 5. Tablebases probe
639     if (!rootNode && TB::Cardinality)
640     {
641         int piecesCount = pos.count<ALL_PIECES>();
642
643         if (    piecesCount <= TB::Cardinality
644             && (piecesCount <  TB::Cardinality || depth >= TB::ProbeDepth)
645             &&  pos.rule50_count() == 0
646             && !pos.can_castle(ANY_CASTLING))
647         {
648             TB::ProbeState err;
649             TB::WDLScore wdl = Tablebases::probe_wdl(pos, &err);
650
651             if (err != TB::ProbeState::FAIL)
652             {
653                 thisThread->tbHits.fetch_add(1, std::memory_order_relaxed);
654
655                 int drawScore = TB::UseRule50 ? 1 : 0;
656
657                 value =  wdl < -drawScore ? -VALUE_MATE + MAX_PLY + ss->ply + 1
658                        : wdl >  drawScore ?  VALUE_MATE - MAX_PLY - ss->ply - 1
659                                           :  VALUE_DRAW + 2 * wdl * drawScore;
660
661                 Bound b =  wdl < -drawScore ? BOUND_UPPER
662                          : wdl >  drawScore ? BOUND_LOWER : BOUND_EXACT;
663
664                 if (    b == BOUND_EXACT
665                     || (b == BOUND_LOWER ? value >= beta : value <= alpha))
666                 {
667                     tte->save(posKey, value_to_tt(value, ss->ply), b,
668                               std::min(DEPTH_MAX - ONE_PLY, depth + 6 * ONE_PLY),
669                               MOVE_NONE, VALUE_NONE, TT.generation());
670
671                     return value;
672                 }
673
674                 if (PvNode)
675                 {
676                     if (b == BOUND_LOWER)
677                         bestValue = value, alpha = std::max(alpha, bestValue);
678                     else
679                         maxValue = value;
680                 }
681             }
682         }
683     }
684
685     // Step 6. Evaluate the position statically
686     if (inCheck)
687     {
688         ss->staticEval = eval = VALUE_NONE;
689         improving = false;
690         goto moves_loop;
691     }
692     else if (ttHit)
693     {
694         // Never assume anything on values stored in TT
695         if ((ss->staticEval = eval = tte->eval()) == VALUE_NONE)
696             eval = ss->staticEval = evaluate(pos);
697
698         // Can ttValue be used as a better position evaluation?
699         if (    ttValue != VALUE_NONE
700             && (tte->bound() & (ttValue > eval ? BOUND_LOWER : BOUND_UPPER)))
701             eval = ttValue;
702     }
703     else
704     {
705         ss->staticEval = eval =
706         (ss-1)->currentMove != MOVE_NULL ? evaluate(pos)
707                                          : -(ss-1)->staticEval + 2 * Eval::Tempo;
708
709         tte->save(posKey, VALUE_NONE, BOUND_NONE, DEPTH_NONE, MOVE_NONE,
710                   ss->staticEval, TT.generation());
711     }
712
713     improving =   ss->staticEval >= (ss-2)->staticEval
714                ||(ss-2)->staticEval == VALUE_NONE;
715
716     if (skipEarlyPruning || !pos.non_pawn_material(pos.side_to_move()))
717         goto moves_loop;
718
719     // Step 7. Razoring (skipped when in check, ~2 Elo)
720     if (  !PvNode
721         && depth < 3 * ONE_PLY
722         && eval <= alpha - RazorMargin[depth / ONE_PLY])
723     {
724         Value ralpha = alpha - (depth >= 2 * ONE_PLY) * RazorMargin[depth / ONE_PLY];
725         Value v = qsearch<NonPV>(pos, ss, ralpha, ralpha+1);
726         if (depth < 2 * ONE_PLY || v <= ralpha)
727             return v;
728     }
729
730     // Step 8. Futility pruning: child node (skipped when in check, ~30 Elo)
731     if (   !rootNode
732         &&  depth < 7 * ONE_PLY
733         &&  eval - futility_margin(depth, improving) >= beta
734         &&  eval < VALUE_KNOWN_WIN) // Do not return unproven wins
735         return eval;
736
737     // Step 9. Null move search with verification search (~40 Elo)
738     if (   !PvNode
739         &&  eval >= beta
740         &&  ss->staticEval >= beta - 36 * depth / ONE_PLY + 225
741         && (ss->ply >= thisThread->nmp_ply || ss->ply % 2 != thisThread->nmp_odd))
742     {
743         assert(eval - beta >= 0);
744
745         // Null move dynamic reduction based on depth and value
746         Depth R = ((823 + 67 * depth / ONE_PLY) / 256 + std::min((eval - beta) / PawnValueMg, 3)) * ONE_PLY;
747
748         ss->currentMove = MOVE_NULL;
749         ss->contHistory = thisThread->contHistory[NO_PIECE][0].get();
750
751         pos.do_null_move(st);
752
753         Value nullValue = -search<NonPV>(pos, ss+1, -beta, -beta+1, depth-R, !cutNode, true);
754
755         pos.undo_null_move();
756
757         if (nullValue >= beta)
758         {
759             // Do not return unproven mate scores
760             if (nullValue >= VALUE_MATE_IN_MAX_PLY)
761                 nullValue = beta;
762
763             if (abs(beta) < VALUE_KNOWN_WIN && (depth < 12 * ONE_PLY || thisThread->nmp_ply))
764                 return nullValue;
765
766             // Do verification search at high depths. Disable null move pruning
767             // for side to move for the first part of the remaining search tree.
768             thisThread->nmp_ply = ss->ply + 3 * (depth-R) / 4;
769             thisThread->nmp_odd = ss->ply % 2;
770
771             Value v = search<NonPV>(pos, ss, beta-1, beta, depth-R, false, true);
772
773             thisThread->nmp_odd = thisThread->nmp_ply = 0;
774
775             if (v >= beta)
776                 return nullValue;
777         }
778     }
779
780     // Step 10. ProbCut (skipped when in check, ~10 Elo)
781     // If we have a good enough capture and a reduced search returns a value
782     // much above beta, we can (almost) safely prune the previous move.
783     if (   !PvNode
784         &&  depth >= 5 * ONE_PLY
785         &&  abs(beta) < VALUE_MATE_IN_MAX_PLY)
786     {
787         assert(is_ok((ss-1)->currentMove));
788
789         Value rbeta = std::min(beta + 216 - 48 * improving, VALUE_INFINITE);
790         MovePicker mp(pos, ttMove, rbeta - ss->staticEval, &thisThread->captureHistory);
791         int probCutCount = 0;
792
793         while (  (move = mp.next_move()) != MOVE_NONE
794                && probCutCount < 3)
795             if (pos.legal(move))
796             {
797                 probCutCount++;
798
799                 ss->currentMove = move;
800                 ss->contHistory = thisThread->contHistory[pos.moved_piece(move)][to_sq(move)].get();
801
802                 assert(depth >= 5 * ONE_PLY);
803
804                 pos.do_move(move, st);
805
806                 // Perform a preliminary qsearch to verify that the move holds
807                 value = -qsearch<NonPV>(pos, ss+1, -rbeta, -rbeta+1);
808
809                 // If the qsearch held perform the regular search
810                 if (value >= rbeta)
811                     value = -search<NonPV>(pos, ss+1, -rbeta, -rbeta+1, depth - 4 * ONE_PLY, !cutNode, false);
812
813                 pos.undo_move(move);
814
815                 if (value >= rbeta)
816                     return value;
817             }
818     }
819
820     // Step 11. Internal iterative deepening (skipped when in check, ~2 Elo)
821     if (    depth >= 6 * ONE_PLY
822         && !ttMove
823         && (PvNode || ss->staticEval + 128 >= beta))
824     {
825         Depth d = 3 * depth / 4 - 2 * ONE_PLY;
826         search<NT>(pos, ss, alpha, beta, d, cutNode, true);
827
828         tte = TT.probe(posKey, ttHit);
829         ttValue = ttHit ? value_from_tt(tte->value(), ss->ply) : VALUE_NONE;
830         ttMove = ttHit ? tte->move() : MOVE_NONE;
831     }
832
833 moves_loop: // When in check, search starts from here
834
835     const PieceToHistory* contHist[] = { (ss-1)->contHistory, (ss-2)->contHistory, nullptr, (ss-4)->contHistory };
836     Move countermove = thisThread->counterMoves[pos.piece_on(prevSq)][prevSq];
837
838     MovePicker mp(pos, ttMove, depth, &thisThread->mainHistory,
839                                       &thisThread->captureHistory,
840                                       contHist,
841                                       countermove,
842                                       ss->killers);
843     value = bestValue; // Workaround a bogus 'uninitialized' warning under gcc
844
845     skipQuiets = false;
846     ttCapture = false;
847     pvExact = PvNode && ttHit && tte->bound() == BOUND_EXACT;
848
849     // Step 12. Loop through all pseudo-legal moves until no moves remain
850     // or a beta cutoff occurs.
851     while ((move = mp.next_move(skipQuiets)) != MOVE_NONE)
852     {
853       assert(is_ok(move));
854
855       if (move == excludedMove)
856           continue;
857
858       // At root obey the "searchmoves" option and skip moves not listed in Root
859       // Move List. As a consequence any illegal move is also skipped. In MultiPV
860       // mode we also skip PV moves which have been already searched and those
861       // of lower "TB rank" if we are in a TB root position.
862       if (rootNode && !std::count(thisThread->rootMoves.begin() + thisThread->PVIdx,
863                                   thisThread->rootMoves.begin() + thisThread->PVLast, move))
864           continue;
865
866       ss->moveCount = ++moveCount;
867
868       if (rootNode && thisThread == Threads.main() && Time.elapsed() > 3000)
869           sync_cout << "info depth " << depth / ONE_PLY
870                     << " currmove " << UCI::move(move, pos.is_chess960())
871                     << " currmovenumber " << moveCount + thisThread->PVIdx << sync_endl;
872       if (PvNode)
873           (ss+1)->pv = nullptr;
874
875       extension = DEPTH_ZERO;
876       captureOrPromotion = pos.capture_or_promotion(move);
877       movedPiece = pos.moved_piece(move);
878       givesCheck = gives_check(pos, move);
879
880       moveCountPruning =   depth < 16 * ONE_PLY
881                         && moveCount >= FutilityMoveCounts[improving][depth / ONE_PLY];
882
883       // Step 13. Extensions (~70 Elo)
884
885       // Singular extension search (~60 Elo). If all moves but one fail low on a
886       // search of (alpha-s, beta-s), and just one fails high on (alpha, beta),
887       // then that move is singular and should be extended. To verify this we do
888       // a reduced search on on all the other moves but the ttMove and if the
889       // result is lower than ttValue minus a margin then we will extend the ttMove.
890       if (    depth >= 8 * ONE_PLY
891           &&  move == ttMove
892           && !rootNode
893           && !excludedMove // Recursive singular search is not allowed
894           &&  ttValue != VALUE_NONE
895           && (tte->bound() & BOUND_LOWER)
896           &&  tte->depth() >= depth - 3 * ONE_PLY
897           &&  pos.legal(move))
898       {
899           Value rBeta = std::max(ttValue - 2 * depth / ONE_PLY, -VALUE_MATE);
900           ss->excludedMove = move;
901           value = search<NonPV>(pos, ss, rBeta - 1, rBeta, depth / 2, cutNode, true);
902           ss->excludedMove = MOVE_NONE;
903
904           if (value < rBeta)
905               extension = ONE_PLY;
906       }
907       else if (    givesCheck // Check extension (~2 Elo)
908                && !moveCountPruning
909                &&  pos.see_ge(move))
910           extension = ONE_PLY;
911
912       // Calculate new depth for this move
913       newDepth = depth - ONE_PLY + extension;
914
915       // Step 14. Pruning at shallow depth (~170 Elo)
916       if (  !rootNode
917           && pos.non_pawn_material(pos.side_to_move())
918           && bestValue > VALUE_MATED_IN_MAX_PLY)
919       {
920           if (   !captureOrPromotion
921               && !givesCheck
922               && (!pos.advanced_pawn_push(move) || pos.non_pawn_material() >= Value(5000)))
923           {
924               // Move count based pruning (~30 Elo)
925               if (moveCountPruning)
926               {
927                   skipQuiets = true;
928                   continue;
929               }
930
931               // Reduced depth of the next LMR search
932               int lmrDepth = std::max(newDepth - reduction<PvNode>(improving, depth, moveCount), DEPTH_ZERO) / ONE_PLY;
933
934               // Countermoves based pruning (~20 Elo)
935               if (   lmrDepth < 3
936                   && (*contHist[0])[movedPiece][to_sq(move)] < CounterMovePruneThreshold
937                   && (*contHist[1])[movedPiece][to_sq(move)] < CounterMovePruneThreshold)
938                   continue;
939
940               // Futility pruning: parent node (~2 Elo)
941               if (   lmrDepth < 7
942                   && !inCheck
943                   && ss->staticEval + 256 + 200 * lmrDepth <= alpha)
944                   continue;
945
946               // Prune moves with negative SEE (~10 Elo)
947               if (   lmrDepth < 8
948                   && !pos.see_ge(move, Value(-35 * lmrDepth * lmrDepth)))
949                   continue;
950           }
951           else if (    depth < 7 * ONE_PLY // (~20 Elo)
952                    && !extension
953                    && !pos.see_ge(move, -Value(CapturePruneMargin[depth / ONE_PLY])))
954                   continue;
955       }
956
957       // Speculative prefetch as early as possible
958       prefetch(TT.first_entry(pos.key_after(move)));
959
960       // Check for legality just before making the move
961       if (!rootNode && !pos.legal(move))
962       {
963           ss->moveCount = --moveCount;
964           continue;
965       }
966
967       if (move == ttMove && captureOrPromotion)
968           ttCapture = true;
969
970       // Update the current move (this must be done after singular extension search)
971       ss->currentMove = move;
972       ss->contHistory = thisThread->contHistory[movedPiece][to_sq(move)].get();
973
974       // Step 15. Make the move
975       pos.do_move(move, st, givesCheck);
976
977       // Step 16. Reduced depth search (LMR). If the move fails high it will be
978       // re-searched at full depth.
979       if (    depth >= 3 * ONE_PLY
980           &&  moveCount > 1
981           && (!captureOrPromotion || moveCountPruning))
982       {
983           Depth r = reduction<PvNode>(improving, depth, moveCount);
984
985           if (captureOrPromotion) // (~5 Elo)
986               r -= r ? ONE_PLY : DEPTH_ZERO;
987           else
988           {
989               // Decrease reduction if opponent's move count is high (~5 Elo)
990               if ((ss-1)->moveCount > 15)
991                   r -= ONE_PLY;
992
993               // Decrease reduction for exact PV nodes (~0 Elo)
994               if (pvExact)
995                   r -= ONE_PLY;
996
997               // Increase reduction if ttMove is a capture (~0 Elo)
998               if (ttCapture)
999                   r += ONE_PLY;
1000
1001               // Increase reduction for cut nodes (~5 Elo)
1002               if (cutNode)
1003                   r += 2 * ONE_PLY;
1004
1005               // Decrease reduction for moves that escape a capture. Filter out
1006               // castling moves, because they are coded as "king captures rook" and
1007               // hence break make_move(). (~5 Elo)
1008               else if (    type_of(move) == NORMAL
1009                        && !pos.see_ge(make_move(to_sq(move), from_sq(move))))
1010                   r -= 2 * ONE_PLY;
1011
1012               ss->statScore =  thisThread->mainHistory[~pos.side_to_move()][from_to(move)]
1013                              + (*contHist[0])[movedPiece][to_sq(move)]
1014                              + (*contHist[1])[movedPiece][to_sq(move)]
1015                              + (*contHist[3])[movedPiece][to_sq(move)]
1016                              - 4000;
1017
1018               // Decrease/increase reduction by comparing opponent's stat score (~10 Elo)
1019               if (ss->statScore >= 0 && (ss-1)->statScore < 0)
1020                   r -= ONE_PLY;
1021
1022               else if ((ss-1)->statScore >= 0 && ss->statScore < 0)
1023                   r += ONE_PLY;
1024
1025               // Decrease/increase reduction for moves with a good/bad history (~30 Elo)
1026               r = std::max(DEPTH_ZERO, (r / ONE_PLY - ss->statScore / 20000) * ONE_PLY);
1027           }
1028
1029           Depth d = std::max(newDepth - r, ONE_PLY);
1030
1031           value = -search<NonPV>(pos, ss+1, -(alpha+1), -alpha, d, true, false);
1032
1033           doFullDepthSearch = (value > alpha && d != newDepth);
1034       }
1035       else
1036           doFullDepthSearch = !PvNode || moveCount > 1;
1037
1038       // Step 17. Full depth search when LMR is skipped or fails high
1039       if (doFullDepthSearch)
1040           value = -search<NonPV>(pos, ss+1, -(alpha+1), -alpha, newDepth, !cutNode, false);
1041
1042       // For PV nodes only, do a full PV search on the first move or after a fail
1043       // high (in the latter case search only if value < beta), otherwise let the
1044       // parent node fail low with value <= alpha and try another move.
1045       if (PvNode && (moveCount == 1 || (value > alpha && (rootNode || value < beta))))
1046       {
1047           (ss+1)->pv = pv;
1048           (ss+1)->pv[0] = MOVE_NONE;
1049
1050           value = -search<PV>(pos, ss+1, -beta, -alpha, newDepth, false, false);
1051       }
1052
1053       // Step 18. Undo move
1054       pos.undo_move(move);
1055
1056       assert(value > -VALUE_INFINITE && value < VALUE_INFINITE);
1057
1058       // Step 19. Check for a new best move
1059       // Finished searching the move. If a stop occurred, the return value of
1060       // the search cannot be trusted, and we return immediately without
1061       // updating best move, PV and TT.
1062       if (Threads.stop.load(std::memory_order_relaxed))
1063           return VALUE_ZERO;
1064
1065       if (rootNode)
1066       {
1067           RootMove& rm = *std::find(thisThread->rootMoves.begin(),
1068                                     thisThread->rootMoves.end(), move);
1069
1070           // PV move or new best move?
1071           if (moveCount == 1 || value > alpha)
1072           {
1073               rm.score = value;
1074               rm.selDepth = thisThread->selDepth;
1075               rm.pv.resize(1);
1076
1077               assert((ss+1)->pv);
1078
1079               for (Move* m = (ss+1)->pv; *m != MOVE_NONE; ++m)
1080                   rm.pv.push_back(*m);
1081
1082               // We record how often the best move has been changed in each
1083               // iteration. This information is used for time management: When
1084               // the best move changes frequently, we allocate some more time.
1085               if (moveCount > 1 && thisThread == Threads.main())
1086                   ++static_cast<MainThread*>(thisThread)->bestMoveChanges;
1087           }
1088           else
1089               // All other moves but the PV are set to the lowest value: this
1090               // is not a problem when sorting because the sort is stable and the
1091               // move position in the list is preserved - just the PV is pushed up.
1092               rm.score = -VALUE_INFINITE;
1093       }
1094
1095       if (value > bestValue)
1096       {
1097           bestValue = value;
1098
1099           if (value > alpha)
1100           {
1101               bestMove = move;
1102
1103               if (PvNode && !rootNode) // Update pv even in fail-high case
1104                   update_pv(ss->pv, move, (ss+1)->pv);
1105
1106               if (PvNode && value < beta) // Update alpha! Always alpha < beta
1107                   alpha = value;
1108               else
1109               {
1110                   assert(value >= beta); // Fail high
1111                   ss->statScore = std::max(ss->statScore, 0);
1112                   break;
1113               }
1114           }
1115       }
1116
1117       if (move != bestMove)
1118       {
1119           if (captureOrPromotion && captureCount < 32)
1120               capturesSearched[captureCount++] = move;
1121
1122           else if (!captureOrPromotion && quietCount < 64)
1123               quietsSearched[quietCount++] = move;
1124       }
1125     }
1126
1127     // The following condition would detect a stop only after move loop has been
1128     // completed. But in this case bestValue is valid because we have fully
1129     // searched our subtree, and we can anyhow save the result in TT.
1130     /*
1131        if (Threads.stop)
1132         return VALUE_DRAW;
1133     */
1134
1135     // Step 20. Check for mate and stalemate
1136     // All legal moves have been searched and if there are no legal moves, it
1137     // must be a mate or a stalemate. If we are in a singular extension search then
1138     // return a fail low score.
1139
1140     assert(moveCount || !inCheck || excludedMove || !MoveList<LEGAL>(pos).size());
1141
1142     if (!moveCount)
1143         bestValue = excludedMove ? alpha
1144                    :     inCheck ? mated_in(ss->ply) : VALUE_DRAW;
1145     else if (bestMove)
1146     {
1147         // Quiet best move: update move sorting heuristics
1148         if (!pos.capture_or_promotion(bestMove))
1149             update_quiet_stats(pos, ss, bestMove, quietsSearched, quietCount, stat_bonus(depth));
1150         else
1151             update_capture_stats(pos, bestMove, capturesSearched, captureCount, stat_bonus(depth));
1152
1153         // Extra penalty for a quiet TT move in previous ply when it gets refuted
1154         if ((ss-1)->moveCount == 1 && !pos.captured_piece())
1155             update_continuation_histories(ss-1, pos.piece_on(prevSq), prevSq, -stat_bonus(depth + ONE_PLY));
1156     }
1157     // Bonus for prior countermove that caused the fail low
1158     else if (    depth >= 3 * ONE_PLY
1159              && !pos.captured_piece()
1160              && is_ok((ss-1)->currentMove))
1161         update_continuation_histories(ss-1, pos.piece_on(prevSq), prevSq, stat_bonus(depth));
1162
1163     if (PvNode)
1164         bestValue = std::min(bestValue, maxValue);
1165
1166     if (!excludedMove)
1167         tte->save(posKey, value_to_tt(bestValue, ss->ply),
1168                   bestValue >= beta ? BOUND_LOWER :
1169                   PvNode && bestMove ? BOUND_EXACT : BOUND_UPPER,
1170                   depth, bestMove, ss->staticEval, TT.generation());
1171
1172     assert(bestValue > -VALUE_INFINITE && bestValue < VALUE_INFINITE);
1173
1174     return bestValue;
1175   }
1176
1177
1178   // qsearch() is the quiescence search function, which is called by the main
1179   // search function with depth zero, or recursively with depth less than ONE_PLY.
1180   template <NodeType NT>
1181   Value qsearch(Position& pos, Stack* ss, Value alpha, Value beta, Depth depth) {
1182
1183     constexpr bool PvNode = NT == PV;
1184
1185     assert(alpha >= -VALUE_INFINITE && alpha < beta && beta <= VALUE_INFINITE);
1186     assert(PvNode || (alpha == beta - 1));
1187     assert(depth <= DEPTH_ZERO);
1188     assert(depth / ONE_PLY * ONE_PLY == depth);
1189
1190     Move pv[MAX_PLY+1];
1191     StateInfo st;
1192     TTEntry* tte;
1193     Key posKey;
1194     Move ttMove, move, bestMove;
1195     Depth ttDepth;
1196     Value bestValue, value, ttValue, futilityValue, futilityBase, oldAlpha;
1197     bool ttHit, inCheck, givesCheck, evasionPrunable;
1198     int moveCount;
1199
1200     if (PvNode)
1201     {
1202         oldAlpha = alpha; // To flag BOUND_EXACT when eval above alpha and no available moves
1203         (ss+1)->pv = pv;
1204         ss->pv[0] = MOVE_NONE;
1205     }
1206
1207     (ss+1)->ply = ss->ply + 1;
1208     ss->currentMove = bestMove = MOVE_NONE;
1209     inCheck = pos.checkers();
1210     moveCount = 0;
1211
1212     // Check for an immediate draw or maximum ply reached
1213     if (   pos.is_draw(ss->ply)
1214         || ss->ply >= MAX_PLY)
1215         return (ss->ply >= MAX_PLY && !inCheck) ? evaluate(pos) : VALUE_DRAW;
1216
1217     assert(0 <= ss->ply && ss->ply < MAX_PLY);
1218
1219     // Decide whether or not to include checks: this fixes also the type of
1220     // TT entry depth that we are going to use. Note that in qsearch we use
1221     // only two types of depth in TT: DEPTH_QS_CHECKS or DEPTH_QS_NO_CHECKS.
1222     ttDepth = inCheck || depth >= DEPTH_QS_CHECKS ? DEPTH_QS_CHECKS
1223                                                   : DEPTH_QS_NO_CHECKS;
1224     // Transposition table lookup
1225     posKey = pos.key();
1226     tte = TT.probe(posKey, ttHit);
1227     ttValue = ttHit ? value_from_tt(tte->value(), ss->ply) : VALUE_NONE;
1228     ttMove = ttHit ? tte->move() : MOVE_NONE;
1229
1230     if (  !PvNode
1231         && ttHit
1232         && tte->depth() >= ttDepth
1233         && ttValue != VALUE_NONE // Only in case of TT access race
1234         && (ttValue >= beta ? (tte->bound() &  BOUND_LOWER)
1235                             : (tte->bound() &  BOUND_UPPER)))
1236         return ttValue;
1237
1238     // Evaluate the position statically
1239     if (inCheck)
1240     {
1241         ss->staticEval = VALUE_NONE;
1242         bestValue = futilityBase = -VALUE_INFINITE;
1243     }
1244     else
1245     {
1246         if (ttHit)
1247         {
1248             // Never assume anything on values stored in TT
1249             if ((ss->staticEval = bestValue = tte->eval()) == VALUE_NONE)
1250                 ss->staticEval = bestValue = evaluate(pos);
1251
1252             // Can ttValue be used as a better position evaluation?
1253             if (   ttValue != VALUE_NONE
1254                 && (tte->bound() & (ttValue > bestValue ? BOUND_LOWER : BOUND_UPPER)))
1255                 bestValue = ttValue;
1256         }
1257         else
1258             ss->staticEval = bestValue =
1259             (ss-1)->currentMove != MOVE_NULL ? evaluate(pos)
1260                                              : -(ss-1)->staticEval + 2 * Eval::Tempo;
1261
1262         // Stand pat. Return immediately if static value is at least beta
1263         if (bestValue >= beta)
1264         {
1265             if (!ttHit)
1266                 tte->save(posKey, value_to_tt(bestValue, ss->ply), BOUND_LOWER,
1267                           DEPTH_NONE, MOVE_NONE, ss->staticEval, TT.generation());
1268
1269             return bestValue;
1270         }
1271
1272         if (PvNode && bestValue > alpha)
1273             alpha = bestValue;
1274
1275         futilityBase = bestValue + 128;
1276     }
1277
1278     // Initialize a MovePicker object for the current position, and prepare
1279     // to search the moves. Because the depth is <= 0 here, only captures,
1280     // queen promotions and checks (only if depth >= DEPTH_QS_CHECKS) will
1281     // be generated.
1282     MovePicker mp(pos, ttMove, depth, &pos.this_thread()->mainHistory,
1283                                       &pos.this_thread()->captureHistory,
1284                                       to_sq((ss-1)->currentMove));
1285
1286     // Loop through the moves until no moves remain or a beta cutoff occurs
1287     while ((move = mp.next_move()) != MOVE_NONE)
1288     {
1289       assert(is_ok(move));
1290
1291       givesCheck = gives_check(pos, move);
1292
1293       moveCount++;
1294
1295       // Futility pruning
1296       if (   !inCheck
1297           && !givesCheck
1298           &&  futilityBase > -VALUE_KNOWN_WIN
1299           && !pos.advanced_pawn_push(move))
1300       {
1301           assert(type_of(move) != ENPASSANT); // Due to !pos.advanced_pawn_push
1302
1303           futilityValue = futilityBase + PieceValue[EG][pos.piece_on(to_sq(move))];
1304
1305           if (futilityValue <= alpha)
1306           {
1307               bestValue = std::max(bestValue, futilityValue);
1308               continue;
1309           }
1310
1311           if (futilityBase <= alpha && !pos.see_ge(move, VALUE_ZERO + 1))
1312           {
1313               bestValue = std::max(bestValue, futilityBase);
1314               continue;
1315           }
1316       }
1317
1318       // Detect non-capture evasions that are candidates to be pruned
1319       evasionPrunable =    inCheck
1320                        &&  (depth != DEPTH_ZERO || moveCount > 2)
1321                        &&  bestValue > VALUE_MATED_IN_MAX_PLY
1322                        && !pos.capture(move);
1323
1324       // Don't search moves with negative SEE values
1325       if (  (!inCheck || evasionPrunable)
1326           && !pos.see_ge(move))
1327           continue;
1328
1329       // Speculative prefetch as early as possible
1330       prefetch(TT.first_entry(pos.key_after(move)));
1331
1332       // Check for legality just before making the move
1333       if (!pos.legal(move))
1334       {
1335           moveCount--;
1336           continue;
1337       }
1338
1339       ss->currentMove = move;
1340
1341       // Make and search the move
1342       pos.do_move(move, st, givesCheck);
1343       value = -qsearch<NT>(pos, ss+1, -beta, -alpha, depth - ONE_PLY);
1344       pos.undo_move(move);
1345
1346       assert(value > -VALUE_INFINITE && value < VALUE_INFINITE);
1347
1348       // Check for a new best move
1349       if (value > bestValue)
1350       {
1351           bestValue = value;
1352
1353           if (value > alpha)
1354           {
1355               if (PvNode) // Update pv even in fail-high case
1356                   update_pv(ss->pv, move, (ss+1)->pv);
1357
1358               if (PvNode && value < beta) // Update alpha here!
1359               {
1360                   alpha = value;
1361                   bestMove = move;
1362               }
1363               else // Fail high
1364               {
1365                   tte->save(posKey, value_to_tt(value, ss->ply), BOUND_LOWER,
1366                             ttDepth, move, ss->staticEval, TT.generation());
1367
1368                   return value;
1369               }
1370           }
1371        }
1372     }
1373
1374     // All legal moves have been searched. A special case: If we're in check
1375     // and no legal moves were found, it is checkmate.
1376     if (inCheck && bestValue == -VALUE_INFINITE)
1377         return mated_in(ss->ply); // Plies to mate from the root
1378
1379     tte->save(posKey, value_to_tt(bestValue, ss->ply),
1380               PvNode && bestValue > oldAlpha ? BOUND_EXACT : BOUND_UPPER,
1381               ttDepth, bestMove, ss->staticEval, TT.generation());
1382
1383     assert(bestValue > -VALUE_INFINITE && bestValue < VALUE_INFINITE);
1384
1385     return bestValue;
1386   }
1387
1388
1389   // value_to_tt() adjusts a mate score from "plies to mate from the root" to
1390   // "plies to mate from the current position". Non-mate scores are unchanged.
1391   // The function is called before storing a value in the transposition table.
1392
1393   Value value_to_tt(Value v, int ply) {
1394
1395     assert(v != VALUE_NONE);
1396
1397     return  v >= VALUE_MATE_IN_MAX_PLY  ? v + ply
1398           : v <= VALUE_MATED_IN_MAX_PLY ? v - ply : v;
1399   }
1400
1401
1402   // value_from_tt() is the inverse of value_to_tt(): It adjusts a mate score
1403   // from the transposition table (which refers to the plies to mate/be mated
1404   // from current position) to "plies to mate/be mated from the root".
1405
1406   Value value_from_tt(Value v, int ply) {
1407
1408     return  v == VALUE_NONE             ? VALUE_NONE
1409           : v >= VALUE_MATE_IN_MAX_PLY  ? v - ply
1410           : v <= VALUE_MATED_IN_MAX_PLY ? v + ply : v;
1411   }
1412
1413
1414   // update_pv() adds current move and appends child pv[]
1415
1416   void update_pv(Move* pv, Move move, Move* childPv) {
1417
1418     for (*pv++ = move; childPv && *childPv != MOVE_NONE; )
1419         *pv++ = *childPv++;
1420     *pv = MOVE_NONE;
1421   }
1422
1423
1424   // update_continuation_histories() updates histories of the move pairs formed
1425   // by moves at ply -1, -2, and -4 with current move.
1426
1427   void update_continuation_histories(Stack* ss, Piece pc, Square to, int bonus) {
1428
1429     for (int i : {1, 2, 4})
1430         if (is_ok((ss-i)->currentMove))
1431             (*(ss-i)->contHistory)[pc][to] << bonus;
1432   }
1433
1434
1435   // update_capture_stats() updates move sorting heuristics when a new capture best move is found
1436
1437   void update_capture_stats(const Position& pos, Move move,
1438                             Move* captures, int captureCnt, int bonus) {
1439
1440       CapturePieceToHistory& captureHistory =  pos.this_thread()->captureHistory;
1441       Piece moved_piece = pos.moved_piece(move);
1442       PieceType captured = type_of(pos.piece_on(to_sq(move)));
1443       captureHistory[moved_piece][to_sq(move)][captured] << bonus;
1444
1445       // Decrease all the other played capture moves
1446       for (int i = 0; i < captureCnt; ++i)
1447       {
1448           moved_piece = pos.moved_piece(captures[i]);
1449           captured = type_of(pos.piece_on(to_sq(captures[i])));
1450           captureHistory[moved_piece][to_sq(captures[i])][captured] << -bonus;
1451       }
1452   }
1453
1454
1455   // update_quiet_stats() updates move sorting heuristics when a new quiet best move is found
1456
1457   void update_quiet_stats(const Position& pos, Stack* ss, Move move,
1458                           Move* quiets, int quietsCnt, int bonus) {
1459
1460     if (ss->killers[0] != move)
1461     {
1462         ss->killers[1] = ss->killers[0];
1463         ss->killers[0] = move;
1464     }
1465
1466     Color us = pos.side_to_move();
1467     Thread* thisThread = pos.this_thread();
1468     thisThread->mainHistory[us][from_to(move)] << bonus;
1469     update_continuation_histories(ss, pos.moved_piece(move), to_sq(move), bonus);
1470
1471     if (is_ok((ss-1)->currentMove))
1472     {
1473         Square prevSq = to_sq((ss-1)->currentMove);
1474         thisThread->counterMoves[pos.piece_on(prevSq)][prevSq] = move;
1475     }
1476
1477     // Decrease all the other played quiet moves
1478     for (int i = 0; i < quietsCnt; ++i)
1479     {
1480         thisThread->mainHistory[us][from_to(quiets[i])] << -bonus;
1481         update_continuation_histories(ss, pos.moved_piece(quiets[i]), to_sq(quiets[i]), -bonus);
1482     }
1483   }
1484
1485   // When playing with strength handicap, choose best move among a set of RootMoves
1486   // using a statistical rule dependent on 'level'. Idea by Heinz van Saanen.
1487
1488   Move Skill::pick_best(size_t multiPV) {
1489
1490     const RootMoves& rootMoves = Threads.main()->rootMoves;
1491     static PRNG rng(now()); // PRNG sequence should be non-deterministic
1492
1493     // RootMoves are already sorted by score in descending order
1494     Value topScore = rootMoves[0].score;
1495     int delta = std::min(topScore - rootMoves[multiPV - 1].score, PawnValueMg);
1496     int weakness = 120 - 2 * level;
1497     int maxScore = -VALUE_INFINITE;
1498
1499     // Choose best move. For each move score we add two terms, both dependent on
1500     // weakness. One is deterministic and bigger for weaker levels, and one is
1501     // random. Then we choose the move with the resulting highest score.
1502     for (size_t i = 0; i < multiPV; ++i)
1503     {
1504         // This is our magic formula
1505         int push = (  weakness * int(topScore - rootMoves[i].score)
1506                     + delta * (rng.rand<unsigned>() % weakness)) / 128;
1507
1508         if (rootMoves[i].score + push >= maxScore)
1509         {
1510             maxScore = rootMoves[i].score + push;
1511             best = rootMoves[i].pv[0];
1512         }
1513     }
1514
1515     return best;
1516   }
1517
1518 } // namespace
1519
1520 /// MainThread::check_time() is used to print debug info and, more importantly,
1521 /// to detect when we are out of available time and thus stop the search.
1522
1523 void MainThread::check_time() {
1524
1525   if (--callsCnt > 0)
1526       return;
1527
1528   // When using nodes, ensure checking rate is not lower than 0.1% of nodes
1529   callsCnt = Limits.nodes ? std::min(1024, int(Limits.nodes / 1024)) : 1024;
1530
1531   static TimePoint lastInfoTime = now();
1532
1533   TimePoint elapsed = Time.elapsed();
1534   TimePoint tick = Limits.startTime + elapsed;
1535
1536   if (tick - lastInfoTime >= 1000)
1537   {
1538       lastInfoTime = tick;
1539       dbg_print();
1540   }
1541
1542   // We should not stop pondering until told so by the GUI
1543   if (Threads.ponder)
1544       return;
1545
1546   if (   (Limits.use_time_management() && elapsed > Time.maximum() - 10)
1547       || (Limits.movetime && elapsed >= Limits.movetime)
1548       || (Limits.nodes && Threads.nodes_searched() >= (uint64_t)Limits.nodes))
1549       Threads.stop = true;
1550 }
1551
1552
1553 /// UCI::pv() formats PV information according to the UCI protocol. UCI requires
1554 /// that all (if any) unsearched PV lines are sent using a previous search score.
1555
1556 string UCI::pv(const Position& pos, Depth depth, Value alpha, Value beta) {
1557
1558   std::stringstream ss;
1559   TimePoint elapsed = Time.elapsed() + 1;
1560   const RootMoves& rootMoves = pos.this_thread()->rootMoves;
1561   size_t PVIdx = pos.this_thread()->PVIdx;
1562   size_t multiPV = std::min((size_t)Options["MultiPV"], rootMoves.size());
1563   uint64_t nodesSearched = Threads.nodes_searched();
1564   uint64_t tbHits = Threads.tb_hits() + (TB::RootInTB ? rootMoves.size() : 0);
1565
1566   for (size_t i = 0; i < multiPV; ++i)
1567   {
1568       bool updated = (i <= PVIdx && rootMoves[i].score != -VALUE_INFINITE);
1569
1570       if (depth == ONE_PLY && !updated)
1571           continue;
1572
1573       Depth d = updated ? depth : depth - ONE_PLY;
1574       Value v = updated ? rootMoves[i].score : rootMoves[i].previousScore;
1575
1576       bool tb = TB::RootInTB && abs(v) < VALUE_MATE - MAX_PLY;
1577       v = tb ? rootMoves[i].TBScore : v;
1578
1579       if (ss.rdbuf()->in_avail()) // Not at first line
1580           ss << "\n";
1581
1582       ss << "info"
1583          << " depth "    << d / ONE_PLY
1584          << " seldepth " << rootMoves[i].selDepth
1585          << " multipv "  << i + 1
1586          << " score "    << UCI::value(v);
1587
1588       if (!tb && i == PVIdx)
1589           ss << (v >= beta ? " lowerbound" : v <= alpha ? " upperbound" : "");
1590
1591       ss << " nodes "    << nodesSearched
1592          << " nps "      << nodesSearched * 1000 / elapsed;
1593
1594       if (elapsed > 1000) // Earlier makes little sense
1595           ss << " hashfull " << TT.hashfull();
1596
1597       ss << " tbhits "   << tbHits
1598          << " time "     << elapsed
1599          << " pv";
1600
1601       for (Move m : rootMoves[i].pv)
1602           ss << " " << UCI::move(m, pos.is_chess960());
1603   }
1604
1605   return ss.str();
1606 }
1607
1608
1609 /// RootMove::extract_ponder_from_tt() is called in case we have no ponder move
1610 /// before exiting the search, for instance, in case we stop the search during a
1611 /// fail high at root. We try hard to have a ponder move to return to the GUI,
1612 /// otherwise in case of 'ponder on' we have nothing to think on.
1613
1614 bool RootMove::extract_ponder_from_tt(Position& pos) {
1615
1616     StateInfo st;
1617     bool ttHit;
1618
1619     assert(pv.size() == 1);
1620
1621     if (!pv[0])
1622         return false;
1623
1624     pos.do_move(pv[0], st);
1625     TTEntry* tte = TT.probe(pos.key(), ttHit);
1626
1627     if (ttHit)
1628     {
1629         Move m = tte->move(); // Local copy to be SMP safe
1630         if (MoveList<LEGAL>(pos).contains(m))
1631             pv.push_back(m);
1632     }
1633
1634     pos.undo_move(pv[0]);
1635     return pv.size() > 1;
1636 }
1637
1638 void Tablebases::rank_root_moves(Position& pos, Search::RootMoves& rootMoves) {
1639
1640     RootInTB = false;
1641     UseRule50 = bool(Options["Syzygy50MoveRule"]);
1642     ProbeDepth = int(Options["SyzygyProbeDepth"]) * ONE_PLY;
1643     Cardinality = int(Options["SyzygyProbeLimit"]);
1644     bool dtz_available = true;
1645
1646     // Tables with fewer pieces than SyzygyProbeLimit are searched with
1647     // ProbeDepth == DEPTH_ZERO
1648     if (Cardinality > MaxCardinality)
1649     {
1650         Cardinality = MaxCardinality;
1651         ProbeDepth = DEPTH_ZERO;
1652     }
1653
1654     if (Cardinality >= popcount(pos.pieces()) && !pos.can_castle(ANY_CASTLING))
1655     {
1656         // Rank moves using DTZ tables
1657         RootInTB = root_probe(pos, rootMoves);
1658
1659         if (!RootInTB)
1660         {
1661             // DTZ tables are missing; try to rank moves using WDL tables
1662             dtz_available = false;
1663             RootInTB = root_probe_wdl(pos, rootMoves);
1664         }
1665     }
1666
1667     if (RootInTB)
1668     {
1669         // Sort moves according to TB rank
1670         std::sort(rootMoves.begin(), rootMoves.end(),
1671                   [](const RootMove &a, const RootMove &b) { return a.TBRank > b.TBRank; } );
1672
1673         // Probe during search only if DTZ is not available and we are winning
1674         if (dtz_available || rootMoves[0].TBScore <= VALUE_DRAW)
1675             Cardinality = 0;
1676     }
1677     else
1678     {
1679         // Assign the same rank to all moves
1680         for (auto& m : rootMoves)
1681             m.TBRank = 0;
1682     }
1683 }