Use state instead of flags to track threads
[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-2009 Marco Costalba
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
21 ////
22 //// Includes
23 ////
24
25 #include <cassert>
26 #include <cmath>
27 #include <cstring>
28 #include <fstream>
29 #include <iostream>
30 #include <sstream>
31
32 #include "book.h"
33 #include "evaluate.h"
34 #include "history.h"
35 #include "misc.h"
36 #include "movegen.h"
37 #include "movepick.h"
38 #include "lock.h"
39 #include "san.h"
40 #include "search.h"
41 #include "thread.h"
42 #include "tt.h"
43 #include "ucioption.h"
44
45 using std::cout;
46 using std::endl;
47
48 ////
49 //// Local definitions
50 ////
51
52 namespace {
53
54   /// Types
55
56
57   // ThreadsManager class is used to handle all the threads related stuff in search,
58   // init, starting, parking and, the most important, launching a slave thread at a
59   // split point are what this class does. All the access to shared thread data is
60   // done through this class, so that we avoid using global variables instead.
61
62   class ThreadsManager {
63     /* As long as the single ThreadsManager object is defined as a global we don't
64        need to explicitly initialize to zero its data members because variables with
65        static storage duration are automatically set to zero before enter main()
66     */
67   public:
68     void init_threads();
69     void exit_threads();
70
71     int active_threads() const { return ActiveThreads; }
72     void set_active_threads(int newActiveThreads) { ActiveThreads = newActiveThreads; }
73     void set_stop_request(int threadID) { threads[threadID].stopRequest = true; }
74     void incrementNodeCounter(int threadID) { threads[threadID].nodes++; }
75     void incrementBetaCounter(Color us, Depth d, int threadID) { threads[threadID].betaCutOffs[us] += unsigned(d); }
76     void print_current_line(SearchStack ss[], int ply, int threadID);
77
78     void resetNodeCounters();
79     void resetBetaCounters();
80     int64_t nodes_searched() const;
81     void get_beta_counters(Color us, int64_t& our, int64_t& their) const;
82     bool available_thread_exists(int master) const;
83     bool thread_is_available(int slave, int master) const;
84     bool thread_should_stop(int threadID) const;
85     void wake_sleeping_threads();
86     void put_threads_to_sleep();
87     void idle_loop(int threadID, SplitPoint* waitSp);
88     bool split(const Position& pos, SearchStack* ss, int ply, Value* alpha, Value* beta, Value* bestValue,
89                const Value futilityValue, Depth depth, int* moves, MovePicker* mp, int master, bool pvNode);
90
91   private:
92     friend void poll();
93
94     int ActiveThreads;
95     volatile bool AllThreadsShouldExit, AllThreadsShouldSleep;
96     Thread threads[MAX_THREADS];
97     SplitPoint SplitPointStack[MAX_THREADS][ACTIVE_SPLIT_POINTS_MAX];
98
99     Lock MPLock, IOLock;
100
101 #if !defined(_MSC_VER)
102     pthread_cond_t WaitCond;
103     pthread_mutex_t WaitLock;
104 #else
105     HANDLE SitIdleEvent[MAX_THREADS];
106 #endif
107
108   };
109
110
111   // RootMove struct is used for moves at the root at the tree. For each
112   // root move, we store a score, a node count, and a PV (really a refutation
113   // in the case of moves which fail low).
114
115   struct RootMove {
116
117     RootMove() { nodes = cumulativeNodes = ourBeta = theirBeta = 0ULL; }
118
119     // RootMove::operator<() is the comparison function used when
120     // sorting the moves. A move m1 is considered to be better
121     // than a move m2 if it has a higher score, or if the moves
122     // have equal score but m1 has the higher node count.
123     bool operator<(const RootMove& m) const {
124
125         return score != m.score ? score < m.score : theirBeta <= m.theirBeta;
126     }
127
128     Move move;
129     Value score;
130     int64_t nodes, cumulativeNodes, ourBeta, theirBeta;
131     Move pv[PLY_MAX_PLUS_2];
132   };
133
134
135   // The RootMoveList class is essentially an array of RootMove objects, with
136   // a handful of methods for accessing the data in the individual moves.
137
138   class RootMoveList {
139
140   public:
141     RootMoveList(Position& pos, Move searchMoves[]);
142
143     int move_count() const { return count; }
144     Move get_move(int moveNum) const { return moves[moveNum].move; }
145     Value get_move_score(int moveNum) const { return moves[moveNum].score; }
146     void set_move_score(int moveNum, Value score) { moves[moveNum].score = score; }
147     Move get_move_pv(int moveNum, int i) const { return moves[moveNum].pv[i]; }
148     int64_t get_move_cumulative_nodes(int moveNum) const { return moves[moveNum].cumulativeNodes; }
149
150     void set_move_nodes(int moveNum, int64_t nodes);
151     void set_beta_counters(int moveNum, int64_t our, int64_t their);
152     void set_move_pv(int moveNum, const Move pv[]);
153     void sort();
154     void sort_multipv(int n);
155
156   private:
157     static const int MaxRootMoves = 500;
158     RootMove moves[MaxRootMoves];
159     int count;
160   };
161
162
163   /// Constants
164
165   // Search depth at iteration 1
166   const Depth InitialDepth = OnePly;
167
168   // Use internal iterative deepening?
169   const bool UseIIDAtPVNodes = true;
170   const bool UseIIDAtNonPVNodes = true;
171
172   // Internal iterative deepening margin. At Non-PV moves, when
173   // UseIIDAtNonPVNodes is true, we do an internal iterative deepening
174   // search when the static evaluation is at most IIDMargin below beta.
175   const Value IIDMargin = Value(0x100);
176
177   // Easy move margin. An easy move candidate must be at least this much
178   // better than the second best move.
179   const Value EasyMoveMargin = Value(0x200);
180
181   // Null move margin. A null move search will not be done if the static
182   // evaluation of the position is more than NullMoveMargin below beta.
183   const Value NullMoveMargin = Value(0x200);
184
185   // If the TT move is at least SingleReplyMargin better then the
186   // remaining ones we will extend it.
187   const Value SingleReplyMargin = Value(0x20);
188
189   // Depth limit for razoring
190   const Depth RazorDepth = 4 * OnePly;
191
192   /// Lookup tables initialized at startup
193
194   // Reduction lookup tables and their getter functions
195   int8_t    PVReductionMatrix[64][64]; // [depth][moveNumber]
196   int8_t NonPVReductionMatrix[64][64]; // [depth][moveNumber]
197
198   inline Depth    pv_reduction(Depth d, int mn) { return (Depth)    PVReductionMatrix[Min(d / 2, 63)][Min(mn, 63)]; }
199   inline Depth nonpv_reduction(Depth d, int mn) { return (Depth) NonPVReductionMatrix[Min(d / 2, 63)][Min(mn, 63)]; }
200
201   // Futility lookup tables and their getter functions
202   const Value FutilityMarginQS = Value(0x80);
203   int32_t FutilityMarginsMatrix[14][64]; // [depth][moveNumber]
204   int FutilityMoveCountArray[32]; // [depth]
205
206   inline Value futility_margin(Depth d, int mn) { return Value(d < 7*OnePly ? FutilityMarginsMatrix[Max(d, 0)][Min(mn, 63)] : 2 * VALUE_INFINITE); }
207   inline int futility_move_count(Depth d) { return d < 16*OnePly ? FutilityMoveCountArray[d] : 512; }
208
209   /// Variables initialized by UCI options
210
211   // Depth limit for use of dynamic threat detection
212   Depth ThreatDepth;
213
214   // Last seconds noise filtering (LSN)
215   const bool UseLSNFiltering = true;
216   const int LSNTime = 4000; // In milliseconds
217   const Value LSNValue = value_from_centipawns(200);
218   bool loseOnTime = false;
219
220   // Extensions. Array index 0 is used at non-PV nodes, index 1 at PV nodes.
221   Depth CheckExtension[2], SingleEvasionExtension[2], PawnPushTo7thExtension[2];
222   Depth PassedPawnExtension[2], PawnEndgameExtension[2], MateThreatExtension[2];
223
224   // Iteration counters
225   int Iteration;
226
227   // Scores and number of times the best move changed for each iteration
228   Value ValueByIteration[PLY_MAX_PLUS_2];
229   int BestMoveChangesByIteration[PLY_MAX_PLUS_2];
230
231   // Search window management
232   int AspirationDelta;
233
234   // MultiPV mode
235   int MultiPV;
236
237   // Time managment variables
238   int RootMoveNumber;
239   int SearchStartTime;
240   int MaxNodes, MaxDepth;
241   int MaxSearchTime, AbsoluteMaxSearchTime, ExtraSearchTime, ExactMaxTime;
242   bool UseTimeManagement, InfiniteSearch, PonderSearch, StopOnPonderhit;
243   bool AbortSearch, Quit;
244   bool AspirationFailLow;
245
246   // Show current line?
247   bool ShowCurrentLine;
248
249   // Log file
250   bool UseLogFile;
251   std::ofstream LogFile;
252
253   // MP related variables
254   Depth MinimumSplitDepth;
255   int MaxThreadsPerSplitPoint;
256   ThreadsManager TM;
257
258   // Node counters, used only by thread[0] but try to keep in different
259   // cache lines (64 bytes each) from the heavy SMP read accessed variables.
260   int NodesSincePoll;
261   int NodesBetweenPolls = 30000;
262
263   // History table
264   History H;
265
266   /// Functions
267
268   Value id_loop(const Position& pos, Move searchMoves[]);
269   Value root_search(Position& pos, SearchStack ss[], RootMoveList& rml, Value& oldAlpha, Value& beta);
270   Value search_pv(Position& pos, SearchStack ss[], Value alpha, Value beta, Depth depth, int ply, int threadID);
271   Value search(Position& pos, SearchStack ss[], Value beta, Depth depth, int ply, bool allowNullmove, int threadID, Move excludedMove = MOVE_NONE);
272   Value qsearch(Position& pos, SearchStack ss[], Value alpha, Value beta, Depth depth, int ply, int threadID);
273   void sp_search(SplitPoint* sp, int threadID);
274   void sp_search_pv(SplitPoint* sp, int threadID);
275   void init_node(SearchStack ss[], int ply, int threadID);
276   void update_pv(SearchStack ss[], int ply);
277   void sp_update_pv(SearchStack* pss, SearchStack ss[], int ply);
278   bool connected_moves(const Position& pos, Move m1, Move m2);
279   bool value_is_mate(Value value);
280   bool move_is_killer(Move m, const SearchStack& ss);
281   Depth extension(const Position&, Move, bool, bool, bool, bool, bool, bool*);
282   bool ok_to_do_nullmove(const Position& pos);
283   bool ok_to_prune(const Position& pos, Move m, Move threat);
284   bool ok_to_use_TT(const TTEntry* tte, Depth depth, Value beta, int ply);
285   Value refine_eval(const TTEntry* tte, Value defaultEval, int ply);
286   void update_history(const Position& pos, Move move, Depth depth, Move movesSearched[], int moveCount);
287   void update_killers(Move m, SearchStack& ss);
288   void update_gains(const Position& pos, Move move, Value before, Value after);
289
290   int current_search_time();
291   int nps();
292   void poll();
293   void ponderhit();
294   void wait_for_stop_or_ponderhit();
295   void init_ss_array(SearchStack ss[]);
296
297 #if !defined(_MSC_VER)
298   void *init_thread(void *threadID);
299 #else
300   DWORD WINAPI init_thread(LPVOID threadID);
301 #endif
302
303 }
304
305
306 ////
307 //// Functions
308 ////
309
310 /// init_threads(), exit_threads() and nodes_searched() are helpers to
311 /// give accessibility to some TM methods from outside of current file.
312
313 void init_threads() { TM.init_threads(); }
314 void exit_threads() { TM.exit_threads(); }
315 int64_t nodes_searched() { return TM.nodes_searched(); }
316
317
318 /// perft() is our utility to verify move generation is bug free. All the legal
319 /// moves up to given depth are generated and counted and the sum returned.
320
321 int perft(Position& pos, Depth depth)
322 {
323     Move move;
324     int sum = 0;
325     MovePicker mp = MovePicker(pos, MOVE_NONE, depth, H);
326
327     // If we are at the last ply we don't need to do and undo
328     // the moves, just to count them.
329     if (depth <= OnePly) // Replace with '<' to test also qsearch
330     {
331         while (mp.get_next_move()) sum++;
332         return sum;
333     }
334
335     // Loop through all legal moves
336     CheckInfo ci(pos);
337     while ((move = mp.get_next_move()) != MOVE_NONE)
338     {
339         StateInfo st;
340         pos.do_move(move, st, ci, pos.move_is_check(move, ci));
341         sum += perft(pos, depth - OnePly);
342         pos.undo_move(move);
343     }
344     return sum;
345 }
346
347
348 /// think() is the external interface to Stockfish's search, and is called when
349 /// the program receives the UCI 'go' command. It initializes various
350 /// search-related global variables, and calls root_search(). It returns false
351 /// when a quit command is received during the search.
352
353 bool think(const Position& pos, bool infinite, bool ponder, int side_to_move,
354            int time[], int increment[], int movesToGo, int maxDepth,
355            int maxNodes, int maxTime, Move searchMoves[]) {
356
357   // Initialize global search variables
358   StopOnPonderhit = AbortSearch = Quit = false;
359   AspirationFailLow = false;
360   NodesSincePoll = 0;
361   SearchStartTime = get_system_time();
362   ExactMaxTime = maxTime;
363   MaxDepth = maxDepth;
364   MaxNodes = maxNodes;
365   InfiniteSearch = infinite;
366   PonderSearch = ponder;
367   UseTimeManagement = !ExactMaxTime && !MaxDepth && !MaxNodes && !InfiniteSearch;
368
369   // Look for a book move, only during games, not tests
370   if (UseTimeManagement && get_option_value_bool("OwnBook"))
371   {
372       Move bookMove;
373       if (get_option_value_string("Book File") != OpeningBook.file_name())
374           OpeningBook.open(get_option_value_string("Book File"));
375
376       bookMove = OpeningBook.get_move(pos);
377       if (bookMove != MOVE_NONE)
378       {
379           if (PonderSearch)
380               wait_for_stop_or_ponderhit();
381
382           cout << "bestmove " << bookMove << endl;
383           return true;
384       }
385   }
386
387   TM.resetNodeCounters();
388
389   if (button_was_pressed("New Game"))
390       loseOnTime = false; // Reset at the beginning of a new game
391
392   // Read UCI option values
393   TT.set_size(get_option_value_int("Hash"));
394   if (button_was_pressed("Clear Hash"))
395       TT.clear();
396
397   bool PonderingEnabled = get_option_value_bool("Ponder");
398   MultiPV = get_option_value_int("MultiPV");
399
400   CheckExtension[1] = Depth(get_option_value_int("Check Extension (PV nodes)"));
401   CheckExtension[0] = Depth(get_option_value_int("Check Extension (non-PV nodes)"));
402
403   SingleEvasionExtension[1] = Depth(get_option_value_int("Single Evasion Extension (PV nodes)"));
404   SingleEvasionExtension[0] = Depth(get_option_value_int("Single Evasion Extension (non-PV nodes)"));
405
406   PawnPushTo7thExtension[1] = Depth(get_option_value_int("Pawn Push to 7th Extension (PV nodes)"));
407   PawnPushTo7thExtension[0] = Depth(get_option_value_int("Pawn Push to 7th Extension (non-PV nodes)"));
408
409   PassedPawnExtension[1] = Depth(get_option_value_int("Passed Pawn Extension (PV nodes)"));
410   PassedPawnExtension[0] = Depth(get_option_value_int("Passed Pawn Extension (non-PV nodes)"));
411
412   PawnEndgameExtension[1] = Depth(get_option_value_int("Pawn Endgame Extension (PV nodes)"));
413   PawnEndgameExtension[0] = Depth(get_option_value_int("Pawn Endgame Extension (non-PV nodes)"));
414
415   MateThreatExtension[1] = Depth(get_option_value_int("Mate Threat Extension (PV nodes)"));
416   MateThreatExtension[0] = Depth(get_option_value_int("Mate Threat Extension (non-PV nodes)"));
417
418   ThreatDepth   = get_option_value_int("Threat Depth") * OnePly;
419
420   Chess960 = get_option_value_bool("UCI_Chess960");
421   ShowCurrentLine = get_option_value_bool("UCI_ShowCurrLine");
422   UseLogFile = get_option_value_bool("Use Search Log");
423   if (UseLogFile)
424       LogFile.open(get_option_value_string("Search Log Filename").c_str(), std::ios::out | std::ios::app);
425
426   MinimumSplitDepth = get_option_value_int("Minimum Split Depth") * OnePly;
427   MaxThreadsPerSplitPoint = get_option_value_int("Maximum Number of Threads per Split Point");
428
429   read_weights(pos.side_to_move());
430
431   // Set the number of active threads
432   int newActiveThreads = get_option_value_int("Threads");
433   if (newActiveThreads != TM.active_threads())
434   {
435       TM.set_active_threads(newActiveThreads);
436       init_eval(TM.active_threads());
437       // HACK: init_eval() destroys the static castleRightsMask[] array in the
438       // Position class. The below line repairs the damage.
439       Position p(pos.to_fen());
440       assert(pos.is_ok());
441   }
442
443   // Wake up sleeping threads
444   TM.wake_sleeping_threads();
445
446   for (int i = 1; i < TM.active_threads(); i++)
447       assert(TM.thread_is_available(i, 0));
448
449   // Set thinking time
450   int myTime = time[side_to_move];
451   int myIncrement = increment[side_to_move];
452   if (UseTimeManagement)
453   {
454       if (!movesToGo) // Sudden death time control
455       {
456           if (myIncrement)
457           {
458               MaxSearchTime = myTime / 30 + myIncrement;
459               AbsoluteMaxSearchTime = Max(myTime / 4, myIncrement - 100);
460           }
461           else // Blitz game without increment
462           {
463               MaxSearchTime = myTime / 30;
464               AbsoluteMaxSearchTime = myTime / 8;
465           }
466       }
467       else // (x moves) / (y minutes)
468       {
469           if (movesToGo == 1)
470           {
471               MaxSearchTime = myTime / 2;
472               AbsoluteMaxSearchTime = (myTime > 3000)? (myTime - 500) : ((myTime * 3) / 4);
473           }
474           else
475           {
476               MaxSearchTime = myTime / Min(movesToGo, 20);
477               AbsoluteMaxSearchTime = Min((4 * myTime) / movesToGo, myTime / 3);
478           }
479       }
480
481       if (PonderingEnabled)
482       {
483           MaxSearchTime += MaxSearchTime / 4;
484           MaxSearchTime = Min(MaxSearchTime, AbsoluteMaxSearchTime);
485       }
486   }
487
488   // Set best NodesBetweenPolls interval
489   if (MaxNodes)
490       NodesBetweenPolls = Min(MaxNodes, 30000);
491   else if (myTime && myTime < 1000)
492       NodesBetweenPolls = 1000;
493   else if (myTime && myTime < 5000)
494       NodesBetweenPolls = 5000;
495   else
496       NodesBetweenPolls = 30000;
497
498   // Write information to search log file
499   if (UseLogFile)
500       LogFile << "Searching: " << pos.to_fen() << endl
501               << "infinite: "  << infinite
502               << " ponder: "   << ponder
503               << " time: "     << myTime
504               << " increment: " << myIncrement
505               << " moves to go: " << movesToGo << endl;
506
507   // LSN filtering. Used only for developing purpose. Disabled by default.
508   if (   UseLSNFiltering
509       && loseOnTime)
510   {
511       // Step 2. If after last move we decided to lose on time, do it now!
512        while (SearchStartTime + myTime + 1000 > get_system_time())
513            /* wait here */;
514   }
515
516   // We're ready to start thinking. Call the iterative deepening loop function
517   Value v = id_loop(pos, searchMoves);
518
519   if (UseLSNFiltering)
520   {
521       // Step 1. If this is sudden death game and our position is hopeless,
522       // decide to lose on time.
523       if (   !loseOnTime // If we already lost on time, go to step 3.
524           && myTime < LSNTime
525           && myIncrement == 0
526           && movesToGo == 0
527           && v < -LSNValue)
528       {
529           loseOnTime = true;
530       }
531       else if (loseOnTime)
532       {
533           // Step 3. Now after stepping over the time limit, reset flag for next match.
534           loseOnTime = false;
535       }
536   }
537
538   if (UseLogFile)
539       LogFile.close();
540
541   TM.put_threads_to_sleep();
542
543   return !Quit;
544 }
545
546
547 /// init_search() is called during startup. It initializes various lookup tables
548
549 void init_search() {
550
551   // Init our reduction lookup tables
552   for (int i = 1; i < 64; i++) // i == depth (OnePly = 1)
553       for (int j = 1; j < 64; j++) // j == moveNumber
554       {
555           double    pvRed = 0.5 + log(double(i)) * log(double(j)) / 6.0;
556           double nonPVRed = 0.5 + log(double(i)) * log(double(j)) / 3.0;
557           PVReductionMatrix[i][j]    = (int8_t) (   pvRed >= 1.0 ? floor(   pvRed * int(OnePly)) : 0);
558           NonPVReductionMatrix[i][j] = (int8_t) (nonPVRed >= 1.0 ? floor(nonPVRed * int(OnePly)) : 0);
559       }
560
561   // Init futility margins array
562   for (int i = 0; i < 14; i++) // i == depth (OnePly = 2)
563       for (int j = 0; j < 64; j++) // j == moveNumber
564       {
565           FutilityMarginsMatrix[i][j] = (i < 2 ? 0 : 112 * bitScanReverse32(i * i / 2)) - 8 * j; // FIXME: test using log instead of BSR
566       }
567
568   // Init futility move count array
569   for (int i = 0; i < 32; i++) // i == depth (OnePly = 2)
570       FutilityMoveCountArray[i] = 3 + (1 << (3 * i / 8));
571 }
572
573
574 // SearchStack::init() initializes a search stack. Used at the beginning of a
575 // new search from the root.
576 void SearchStack::init(int ply) {
577
578   pv[ply] = pv[ply + 1] = MOVE_NONE;
579   currentMove = threatMove = MOVE_NONE;
580   reduction = Depth(0);
581   eval = VALUE_NONE;
582 }
583
584 void SearchStack::initKillers() {
585
586   mateKiller = MOVE_NONE;
587   for (int i = 0; i < KILLER_MAX; i++)
588       killers[i] = MOVE_NONE;
589 }
590
591 namespace {
592
593   // id_loop() is the main iterative deepening loop. It calls root_search
594   // repeatedly with increasing depth until the allocated thinking time has
595   // been consumed, the user stops the search, or the maximum search depth is
596   // reached.
597
598   Value id_loop(const Position& pos, Move searchMoves[]) {
599
600     Position p(pos);
601     SearchStack ss[PLY_MAX_PLUS_2];
602
603     // searchMoves are verified, copied, scored and sorted
604     RootMoveList rml(p, searchMoves);
605
606     // Handle special case of searching on a mate/stale position
607     if (rml.move_count() == 0)
608     {
609         if (PonderSearch)
610             wait_for_stop_or_ponderhit();
611
612         return pos.is_check()? -VALUE_MATE : VALUE_DRAW;
613     }
614
615     // Print RootMoveList c'tor startup scoring to the standard output,
616     // so that we print information also for iteration 1.
617     cout << "info depth " << 1 << "\ninfo depth " << 1
618          << " score " << value_to_string(rml.get_move_score(0))
619          << " time " << current_search_time()
620          << " nodes " << TM.nodes_searched()
621          << " nps " << nps()
622          << " pv " << rml.get_move(0) << "\n";
623
624     // Initialize
625     TT.new_search();
626     H.clear();
627     init_ss_array(ss);
628     ValueByIteration[1] = rml.get_move_score(0);
629     Iteration = 1;
630
631     // Is one move significantly better than others after initial scoring ?
632     Move EasyMove = MOVE_NONE;
633     if (   rml.move_count() == 1
634         || rml.get_move_score(0) > rml.get_move_score(1) + EasyMoveMargin)
635         EasyMove = rml.get_move(0);
636
637     // Iterative deepening loop
638     while (Iteration < PLY_MAX)
639     {
640         // Initialize iteration
641         rml.sort();
642         Iteration++;
643         BestMoveChangesByIteration[Iteration] = 0;
644         if (Iteration <= 5)
645             ExtraSearchTime = 0;
646
647         cout << "info depth " << Iteration << endl;
648
649         // Calculate dynamic search window based on previous iterations
650         Value alpha, beta;
651
652         if (MultiPV == 1 && Iteration >= 6 && abs(ValueByIteration[Iteration - 1]) < VALUE_KNOWN_WIN)
653         {
654             int prevDelta1 = ValueByIteration[Iteration - 1] - ValueByIteration[Iteration - 2];
655             int prevDelta2 = ValueByIteration[Iteration - 2] - ValueByIteration[Iteration - 3];
656
657             AspirationDelta = Max(abs(prevDelta1) + abs(prevDelta2) / 2, 16);
658             AspirationDelta = (AspirationDelta + 7) / 8 * 8; // Round to match grainSize
659
660             alpha = Max(ValueByIteration[Iteration - 1] - AspirationDelta, -VALUE_INFINITE);
661             beta  = Min(ValueByIteration[Iteration - 1] + AspirationDelta,  VALUE_INFINITE);
662         }
663         else
664         {
665             alpha = - VALUE_INFINITE;
666             beta  =   VALUE_INFINITE;
667         }
668
669         // Search to the current depth
670         Value value = root_search(p, ss, rml, alpha, beta);
671
672         // Write PV to transposition table, in case the relevant entries have
673         // been overwritten during the search.
674         TT.insert_pv(p, ss[0].pv);
675
676         if (AbortSearch)
677             break; // Value cannot be trusted. Break out immediately!
678
679         //Save info about search result
680         ValueByIteration[Iteration] = value;
681
682         // Drop the easy move if it differs from the new best move
683         if (ss[0].pv[0] != EasyMove)
684             EasyMove = MOVE_NONE;
685
686         if (UseTimeManagement)
687         {
688             // Time to stop?
689             bool stopSearch = false;
690
691             // Stop search early if there is only a single legal move,
692             // we search up to Iteration 6 anyway to get a proper score.
693             if (Iteration >= 6 && rml.move_count() == 1)
694                 stopSearch = true;
695
696             // Stop search early when the last two iterations returned a mate score
697             if (  Iteration >= 6
698                 && abs(ValueByIteration[Iteration]) >= abs(VALUE_MATE) - 100
699                 && abs(ValueByIteration[Iteration-1]) >= abs(VALUE_MATE) - 100)
700                 stopSearch = true;
701
702             // Stop search early if one move seems to be much better than the rest
703             int64_t nodes = TM.nodes_searched();
704             if (   Iteration >= 8
705                 && EasyMove == ss[0].pv[0]
706                 && (  (   rml.get_move_cumulative_nodes(0) > (nodes * 85) / 100
707                        && current_search_time() > MaxSearchTime / 16)
708                     ||(   rml.get_move_cumulative_nodes(0) > (nodes * 98) / 100
709                        && current_search_time() > MaxSearchTime / 32)))
710                 stopSearch = true;
711
712             // Add some extra time if the best move has changed during the last two iterations
713             if (Iteration > 5 && Iteration <= 50)
714                 ExtraSearchTime = BestMoveChangesByIteration[Iteration]   * (MaxSearchTime / 2)
715                                 + BestMoveChangesByIteration[Iteration-1] * (MaxSearchTime / 3);
716
717             // Stop search if most of MaxSearchTime is consumed at the end of the
718             // iteration. We probably don't have enough time to search the first
719             // move at the next iteration anyway.
720             if (current_search_time() > ((MaxSearchTime + ExtraSearchTime) * 80) / 128)
721                 stopSearch = true;
722
723             if (stopSearch)
724             {
725                 if (!PonderSearch)
726                     break;
727                 else
728                     StopOnPonderhit = true;
729             }
730         }
731
732         if (MaxDepth && Iteration >= MaxDepth)
733             break;
734     }
735
736     rml.sort();
737
738     // If we are pondering or in infinite search, we shouldn't print the
739     // best move before we are told to do so.
740     if (!AbortSearch && (PonderSearch || InfiniteSearch))
741         wait_for_stop_or_ponderhit();
742     else
743         // Print final search statistics
744         cout << "info nodes " << TM.nodes_searched()
745              << " nps " << nps()
746              << " time " << current_search_time()
747              << " hashfull " << TT.full() << endl;
748
749     // Print the best move and the ponder move to the standard output
750     if (ss[0].pv[0] == MOVE_NONE)
751     {
752         ss[0].pv[0] = rml.get_move(0);
753         ss[0].pv[1] = MOVE_NONE;
754     }
755     cout << "bestmove " << ss[0].pv[0];
756     if (ss[0].pv[1] != MOVE_NONE)
757         cout << " ponder " << ss[0].pv[1];
758
759     cout << endl;
760
761     if (UseLogFile)
762     {
763         if (dbg_show_mean)
764             dbg_print_mean(LogFile);
765
766         if (dbg_show_hit_rate)
767             dbg_print_hit_rate(LogFile);
768
769         LogFile << "\nNodes: " << TM.nodes_searched()
770                 << "\nNodes/second: " << nps()
771                 << "\nBest move: " << move_to_san(p, ss[0].pv[0]);
772
773         StateInfo st;
774         p.do_move(ss[0].pv[0], st);
775         LogFile << "\nPonder move: " << move_to_san(p, ss[0].pv[1]) << endl;
776     }
777     return rml.get_move_score(0);
778   }
779
780
781   // root_search() is the function which searches the root node. It is
782   // similar to search_pv except that it uses a different move ordering
783   // scheme and prints some information to the standard output.
784
785   Value root_search(Position& pos, SearchStack ss[], RootMoveList& rml, Value& oldAlpha, Value& beta) {
786
787     int64_t nodes;
788     Move move;
789     StateInfo st;
790     Depth depth, ext, newDepth;
791     Value value;
792     CheckInfo ci(pos);
793     int researchCount = 0;
794     bool moveIsCheck, captureOrPromotion, dangerous;
795     Value alpha = oldAlpha;
796     bool isCheck = pos.is_check();
797
798     // Evaluate the position statically
799     EvalInfo ei;
800     ss[0].eval = !isCheck ? evaluate(pos, ei, 0) : VALUE_NONE;
801
802     while (1) // Fail low loop
803     {
804
805         // Loop through all the moves in the root move list
806         for (int i = 0; i <  rml.move_count() && !AbortSearch; i++)
807         {
808             if (alpha >= beta)
809             {
810                 // We failed high, invalidate and skip next moves, leave node-counters
811                 // and beta-counters as they are and quickly return, we will try to do
812                 // a research at the next iteration with a bigger aspiration window.
813                 rml.set_move_score(i, -VALUE_INFINITE);
814                 continue;
815             }
816
817             RootMoveNumber = i + 1;
818
819             // Save the current node count before the move is searched
820             nodes = TM.nodes_searched();
821
822             // Reset beta cut-off counters
823             TM.resetBetaCounters();
824
825             // Pick the next root move, and print the move and the move number to
826             // the standard output.
827             move = ss[0].currentMove = rml.get_move(i);
828
829             if (current_search_time() >= 1000)
830                 cout << "info currmove " << move
831                      << " currmovenumber " << RootMoveNumber << endl;
832
833             // Decide search depth for this move
834             moveIsCheck = pos.move_is_check(move);
835             captureOrPromotion = pos.move_is_capture_or_promotion(move);
836             depth = (Iteration - 2) * OnePly + InitialDepth;
837             ext = extension(pos, move, true, captureOrPromotion, moveIsCheck, false, false, &dangerous);
838             newDepth = depth + ext;
839
840             value = - VALUE_INFINITE;
841
842             while (1) // Fail high loop
843             {
844
845                 // Make the move, and search it
846                 pos.do_move(move, st, ci, moveIsCheck);
847
848                 if (i < MultiPV || value > alpha)
849                 {
850                     // Aspiration window is disabled in multi-pv case
851                     if (MultiPV > 1)
852                         alpha = -VALUE_INFINITE;
853
854                     value = -search_pv(pos, ss, -beta, -alpha, newDepth, 1, 0);
855                 }
856                 else
857                 {
858                     // Try to reduce non-pv search depth by one ply if move seems not problematic,
859                     // if the move fails high will be re-searched at full depth.
860                     bool doFullDepthSearch = true;
861
862                     if (   depth >= 3*OnePly // FIXME was newDepth
863                         && !dangerous
864                         && !captureOrPromotion
865                         && !move_is_castle(move))
866                     {
867                         ss[0].reduction = pv_reduction(depth, RootMoveNumber - MultiPV + 1);
868                         if (ss[0].reduction)
869                         {
870                             value = -search(pos, ss, -alpha, newDepth-ss[0].reduction, 1, true, 0);
871                             doFullDepthSearch = (value > alpha);
872                         }
873                     }
874
875                     if (doFullDepthSearch)
876                     {
877                         ss[0].reduction = Depth(0);
878                         value = -search(pos, ss, -alpha, newDepth, 1, true, 0);
879
880                         if (value > alpha)
881                             value = -search_pv(pos, ss, -beta, -alpha, newDepth, 1, 0);
882                     }
883                 }
884
885                 pos.undo_move(move);
886
887                 // Can we exit fail high loop ?
888                 if (AbortSearch || value < beta)
889                     break;
890
891                 // We are failing high and going to do a research. It's important to update score
892                 // before research in case we run out of time while researching.
893                 rml.set_move_score(i, value);
894                 update_pv(ss, 0);
895                 TT.extract_pv(pos, ss[0].pv, PLY_MAX);
896                 rml.set_move_pv(i, ss[0].pv);
897
898                 // Print search information to the standard output
899                 cout << "info depth " << Iteration
900                      << " score " << value_to_string(value)
901                      << ((value >= beta) ? " lowerbound" :
902                         ((value <= alpha)? " upperbound" : ""))
903                      << " time "  << current_search_time()
904                      << " nodes " << TM.nodes_searched()
905                      << " nps "   << nps()
906                      << " pv ";
907
908                 for (int j = 0; ss[0].pv[j] != MOVE_NONE && j < PLY_MAX; j++)
909                     cout << ss[0].pv[j] << " ";
910
911                 cout << endl;
912
913                 if (UseLogFile)
914                 {
915                     ValueType type =  (value >= beta  ? VALUE_TYPE_LOWER
916                                     : (value <= alpha ? VALUE_TYPE_UPPER : VALUE_TYPE_EXACT));
917
918                     LogFile << pretty_pv(pos, current_search_time(), Iteration,
919                                          TM.nodes_searched(), value, type, ss[0].pv) << endl;
920                 }
921
922                 // Prepare for a research after a fail high, each time with a wider window
923                 researchCount++;
924                 beta = Min(beta + AspirationDelta * (1 << researchCount), VALUE_INFINITE);
925
926             } // End of fail high loop
927
928             // Finished searching the move. If AbortSearch is true, the search
929             // was aborted because the user interrupted the search or because we
930             // ran out of time. In this case, the return value of the search cannot
931             // be trusted, and we break out of the loop without updating the best
932             // move and/or PV.
933             if (AbortSearch)
934                 break;
935
936             // Remember beta-cutoff and searched nodes counts for this move. The
937             // info is used to sort the root moves at the next iteration.
938             int64_t our, their;
939             TM.get_beta_counters(pos.side_to_move(), our, their);
940             rml.set_beta_counters(i, our, their);
941             rml.set_move_nodes(i, TM.nodes_searched() - nodes);
942
943             assert(value >= -VALUE_INFINITE && value <= VALUE_INFINITE);
944
945             if (value <= alpha && i >= MultiPV)
946                 rml.set_move_score(i, -VALUE_INFINITE);
947             else
948             {
949                 // PV move or new best move!
950
951                 // Update PV
952                 rml.set_move_score(i, value);
953                 update_pv(ss, 0);
954                 TT.extract_pv(pos, ss[0].pv, PLY_MAX);
955                 rml.set_move_pv(i, ss[0].pv);
956
957                 if (MultiPV == 1)
958                 {
959                     // We record how often the best move has been changed in each
960                     // iteration. This information is used for time managment: When
961                     // the best move changes frequently, we allocate some more time.
962                     if (i > 0)
963                         BestMoveChangesByIteration[Iteration]++;
964
965                     // Print search information to the standard output
966                     cout << "info depth " << Iteration
967                          << " score " << value_to_string(value)
968                          << ((value >= beta) ? " lowerbound" :
969                             ((value <= alpha)? " upperbound" : ""))
970                          << " time "  << current_search_time()
971                          << " nodes " << TM.nodes_searched()
972                          << " nps "   << nps()
973                          << " pv ";
974
975                     for (int j = 0; ss[0].pv[j] != MOVE_NONE && j < PLY_MAX; j++)
976                         cout << ss[0].pv[j] << " ";
977
978                     cout << endl;
979
980                     if (UseLogFile)
981                     {
982                         ValueType type =  (value >= beta  ? VALUE_TYPE_LOWER
983                                         : (value <= alpha ? VALUE_TYPE_UPPER : VALUE_TYPE_EXACT));
984
985                         LogFile << pretty_pv(pos, current_search_time(), Iteration,
986                                              TM.nodes_searched(), value, type, ss[0].pv) << endl;
987                     }
988                     if (value > alpha)
989                         alpha = value;
990                 }
991                 else // MultiPV > 1
992                 {
993                     rml.sort_multipv(i);
994                     for (int j = 0; j < Min(MultiPV, rml.move_count()); j++)
995                     {
996                         cout << "info multipv " << j + 1
997                              << " score " << value_to_string(rml.get_move_score(j))
998                              << " depth " << ((j <= i)? Iteration : Iteration - 1)
999                              << " time " << current_search_time()
1000                              << " nodes " << TM.nodes_searched()
1001                              << " nps " << nps()
1002                              << " pv ";
1003
1004                         for (int k = 0; rml.get_move_pv(j, k) != MOVE_NONE && k < PLY_MAX; k++)
1005                             cout << rml.get_move_pv(j, k) << " ";
1006
1007                         cout << endl;
1008                     }
1009                     alpha = rml.get_move_score(Min(i, MultiPV-1));
1010                 }
1011             } // PV move or new best move
1012
1013             assert(alpha >= oldAlpha);
1014
1015             AspirationFailLow = (alpha == oldAlpha);
1016
1017             if (AspirationFailLow && StopOnPonderhit)
1018                 StopOnPonderhit = false;
1019         }
1020
1021         // Can we exit fail low loop ?
1022         if (AbortSearch || alpha > oldAlpha)
1023             break;
1024
1025         // Prepare for a research after a fail low, each time with a wider window
1026         researchCount++;
1027         alpha = Max(alpha - AspirationDelta * (1 << researchCount), -VALUE_INFINITE);
1028         oldAlpha = alpha;
1029
1030     } // Fail low loop
1031
1032     return alpha;
1033   }
1034
1035
1036   // search_pv() is the main search function for PV nodes.
1037
1038   Value search_pv(Position& pos, SearchStack ss[], Value alpha, Value beta,
1039                   Depth depth, int ply, int threadID) {
1040
1041     assert(alpha >= -VALUE_INFINITE && alpha <= VALUE_INFINITE);
1042     assert(beta > alpha && beta <= VALUE_INFINITE);
1043     assert(ply >= 0 && ply < PLY_MAX);
1044     assert(threadID >= 0 && threadID < TM.active_threads());
1045
1046     Move movesSearched[256];
1047     StateInfo st;
1048     const TTEntry* tte;
1049     Move ttMove, move;
1050     Depth ext, newDepth;
1051     Value oldAlpha, value;
1052     bool isCheck, mateThreat, singleEvasion, moveIsCheck, captureOrPromotion, dangerous;
1053     int moveCount = 0;
1054     Value bestValue = value = -VALUE_INFINITE;
1055
1056     if (depth < OnePly)
1057         return qsearch(pos, ss, alpha, beta, Depth(0), ply, threadID);
1058
1059     // Initialize, and make an early exit in case of an aborted search,
1060     // an instant draw, maximum ply reached, etc.
1061     init_node(ss, ply, threadID);
1062
1063     // After init_node() that calls poll()
1064     if (AbortSearch || TM.thread_should_stop(threadID))
1065         return Value(0);
1066
1067     if (pos.is_draw() || ply >= PLY_MAX - 1)
1068         return VALUE_DRAW;
1069
1070     // Mate distance pruning
1071     oldAlpha = alpha;
1072     alpha = Max(value_mated_in(ply), alpha);
1073     beta = Min(value_mate_in(ply+1), beta);
1074     if (alpha >= beta)
1075         return alpha;
1076
1077     // Transposition table lookup. At PV nodes, we don't use the TT for
1078     // pruning, but only for move ordering. This is to avoid problems in
1079     // the following areas:
1080     //
1081     // * Repetition draw detection
1082     // * Fifty move rule detection
1083     // * Searching for a mate
1084     // * Printing of full PV line
1085     //
1086     tte = TT.retrieve(pos.get_key());
1087     ttMove = (tte ? tte->move() : MOVE_NONE);
1088
1089     // Go with internal iterative deepening if we don't have a TT move
1090     if (   UseIIDAtPVNodes
1091         && depth >= 5*OnePly
1092         && ttMove == MOVE_NONE)
1093     {
1094         search_pv(pos, ss, alpha, beta, depth-2*OnePly, ply, threadID);
1095         ttMove = ss[ply].pv[ply];
1096         tte = TT.retrieve(pos.get_key());
1097     }
1098
1099     isCheck = pos.is_check();
1100     if (!isCheck)
1101     {
1102         // Update gain statistics of the previous move that lead
1103         // us in this position.
1104         EvalInfo ei;
1105         ss[ply].eval = evaluate(pos, ei, threadID);
1106         update_gains(pos, ss[ply - 1].currentMove, ss[ply - 1].eval, ss[ply].eval);
1107     }
1108
1109     // Initialize a MovePicker object for the current position, and prepare
1110     // to search all moves
1111     mateThreat = pos.has_mate_threat(opposite_color(pos.side_to_move()));
1112     CheckInfo ci(pos);
1113     MovePicker mp = MovePicker(pos, ttMove, depth, H, &ss[ply]);
1114
1115     // Loop through all legal moves until no moves remain or a beta cutoff
1116     // occurs.
1117     while (   alpha < beta
1118            && (move = mp.get_next_move()) != MOVE_NONE
1119            && !TM.thread_should_stop(threadID))
1120     {
1121       assert(move_is_ok(move));
1122
1123       singleEvasion = (isCheck && mp.number_of_evasions() == 1);
1124       moveIsCheck = pos.move_is_check(move, ci);
1125       captureOrPromotion = pos.move_is_capture_or_promotion(move);
1126
1127       // Decide the new search depth
1128       ext = extension(pos, move, true, captureOrPromotion, moveIsCheck, singleEvasion, mateThreat, &dangerous);
1129
1130       // Singular extension search. We extend the TT move if its value is much better than
1131       // its siblings. To verify this we do a reduced search on all the other moves but the
1132       // ttMove, if result is lower then ttValue minus a margin then we extend ttMove.
1133       if (   depth >= 6 * OnePly
1134           && tte
1135           && move == tte->move()
1136           && ext < OnePly
1137           && is_lower_bound(tte->type())
1138           && tte->depth() >= depth - 3 * OnePly)
1139       {
1140           Value ttValue = value_from_tt(tte->value(), ply);
1141
1142           if (abs(ttValue) < VALUE_KNOWN_WIN)
1143           {
1144               Value excValue = search(pos, ss, ttValue - SingleReplyMargin, depth / 2, ply, false, threadID, move);
1145
1146               if (excValue < ttValue - SingleReplyMargin)
1147                   ext = OnePly;
1148           }
1149       }
1150
1151       newDepth = depth - OnePly + ext;
1152
1153       // Update current move
1154       movesSearched[moveCount++] = ss[ply].currentMove = move;
1155
1156       // Make and search the move
1157       pos.do_move(move, st, ci, moveIsCheck);
1158
1159       if (moveCount == 1) // The first move in list is the PV
1160           value = -search_pv(pos, ss, -beta, -alpha, newDepth, ply+1, threadID);
1161       else
1162       {
1163         // Try to reduce non-pv search depth by one ply if move seems not problematic,
1164         // if the move fails high will be re-searched at full depth.
1165         bool doFullDepthSearch = true;
1166
1167         if (    depth >= 3*OnePly
1168             && !dangerous
1169             && !captureOrPromotion
1170             && !move_is_castle(move)
1171             && !move_is_killer(move, ss[ply]))
1172         {
1173             ss[ply].reduction = pv_reduction(depth, moveCount);
1174             if (ss[ply].reduction)
1175             {
1176                 value = -search(pos, ss, -alpha, newDepth-ss[ply].reduction, ply+1, true, threadID);
1177                 doFullDepthSearch = (value > alpha);
1178             }
1179         }
1180
1181         if (doFullDepthSearch) // Go with full depth non-pv search
1182         {
1183             ss[ply].reduction = Depth(0);
1184             value = -search(pos, ss, -alpha, newDepth, ply+1, true, threadID);
1185             if (value > alpha && value < beta)
1186                 value = -search_pv(pos, ss, -beta, -alpha, newDepth, ply+1, threadID);
1187         }
1188       }
1189       pos.undo_move(move);
1190
1191       assert(value > -VALUE_INFINITE && value < VALUE_INFINITE);
1192
1193       // New best move?
1194       if (value > bestValue)
1195       {
1196           bestValue = value;
1197           if (value > alpha)
1198           {
1199               alpha = value;
1200               update_pv(ss, ply);
1201               if (value == value_mate_in(ply + 1))
1202                   ss[ply].mateKiller = move;
1203           }
1204       }
1205
1206       // Split?
1207       if (   TM.active_threads() > 1
1208           && bestValue < beta
1209           && depth >= MinimumSplitDepth
1210           && Iteration <= 99
1211           && TM.available_thread_exists(threadID)
1212           && !AbortSearch
1213           && !TM.thread_should_stop(threadID)
1214           && TM.split(pos, ss, ply, &alpha, &beta, &bestValue, VALUE_NONE,
1215                       depth, &moveCount, &mp, threadID, true))
1216           break;
1217     }
1218
1219     // All legal moves have been searched.  A special case: If there were
1220     // no legal moves, it must be mate or stalemate.
1221     if (moveCount == 0)
1222         return (isCheck ? value_mated_in(ply) : VALUE_DRAW);
1223
1224     // If the search is not aborted, update the transposition table,
1225     // history counters, and killer moves.
1226     if (AbortSearch || TM.thread_should_stop(threadID))
1227         return bestValue;
1228
1229     if (bestValue <= oldAlpha)
1230         TT.store(pos.get_key(), value_to_tt(bestValue, ply), VALUE_TYPE_UPPER, depth, MOVE_NONE);
1231
1232     else if (bestValue >= beta)
1233     {
1234         TM.incrementBetaCounter(pos.side_to_move(), depth, threadID);
1235         move = ss[ply].pv[ply];
1236         if (!pos.move_is_capture_or_promotion(move))
1237         {
1238             update_history(pos, move, depth, movesSearched, moveCount);
1239             update_killers(move, ss[ply]);
1240         }
1241         TT.store(pos.get_key(), value_to_tt(bestValue, ply), VALUE_TYPE_LOWER, depth, move);
1242     }
1243     else
1244         TT.store(pos.get_key(), value_to_tt(bestValue, ply), VALUE_TYPE_EXACT, depth, ss[ply].pv[ply]);
1245
1246     return bestValue;
1247   }
1248
1249
1250   // search() is the search function for zero-width nodes.
1251
1252   Value search(Position& pos, SearchStack ss[], Value beta, Depth depth,
1253                int ply, bool allowNullmove, int threadID, Move excludedMove) {
1254
1255     assert(beta >= -VALUE_INFINITE && beta <= VALUE_INFINITE);
1256     assert(ply >= 0 && ply < PLY_MAX);
1257     assert(threadID >= 0 && threadID < TM.active_threads());
1258
1259     Move movesSearched[256];
1260     EvalInfo ei;
1261     StateInfo st;
1262     const TTEntry* tte;
1263     Move ttMove, move;
1264     Depth ext, newDepth;
1265     Value bestValue, staticValue, nullValue, value, futilityValue, futilityValueScaled;
1266     bool isCheck, singleEvasion, moveIsCheck, captureOrPromotion, dangerous;
1267     bool mateThreat = false;
1268     int moveCount = 0;
1269     futilityValue = staticValue = bestValue = value = -VALUE_INFINITE;
1270
1271     if (depth < OnePly)
1272         return qsearch(pos, ss, beta-1, beta, Depth(0), ply, threadID);
1273
1274     // Initialize, and make an early exit in case of an aborted search,
1275     // an instant draw, maximum ply reached, etc.
1276     init_node(ss, ply, threadID);
1277
1278     // After init_node() that calls poll()
1279     if (AbortSearch || TM.thread_should_stop(threadID))
1280         return Value(0);
1281
1282     if (pos.is_draw() || ply >= PLY_MAX - 1)
1283         return VALUE_DRAW;
1284
1285     // Mate distance pruning
1286     if (value_mated_in(ply) >= beta)
1287         return beta;
1288
1289     if (value_mate_in(ply + 1) < beta)
1290         return beta - 1;
1291
1292     // We don't want the score of a partial search to overwrite a previous full search
1293     // TT value, so we use a different position key in case of an excluded move exsists.
1294     Key posKey = excludedMove ? pos.get_exclusion_key() : pos.get_key();
1295
1296     // Transposition table lookup
1297     tte = TT.retrieve(posKey);
1298     ttMove = (tte ? tte->move() : MOVE_NONE);
1299
1300     if (tte && ok_to_use_TT(tte, depth, beta, ply))
1301     {
1302         ss[ply].currentMove = ttMove; // Can be MOVE_NONE
1303         return value_from_tt(tte->value(), ply);
1304     }
1305
1306     isCheck = pos.is_check();
1307
1308     // Evaluate the position statically
1309     if (!isCheck)
1310     {
1311         if (tte && (tte->type() & VALUE_TYPE_EVAL))
1312             staticValue = value_from_tt(tte->value(), ply);
1313         else
1314             staticValue = evaluate(pos, ei, threadID);
1315
1316         ss[ply].eval = staticValue;
1317         futilityValue = staticValue + futility_margin(depth, 0); //FIXME: Remove me, only for split
1318         staticValue = refine_eval(tte, staticValue, ply); // Enhance accuracy with TT value if possible
1319         update_gains(pos, ss[ply - 1].currentMove, ss[ply - 1].eval, ss[ply].eval);
1320     }
1321
1322     // Static null move pruning. We're betting that the opponent doesn't have
1323     // a move that will reduce the score by more than FutilityMargins[int(depth)]
1324     // if we do a null move.
1325     if (  !isCheck
1326         && allowNullmove
1327         && depth < RazorDepth
1328         && staticValue - futility_margin(depth, 0) >= beta)
1329         return staticValue - futility_margin(depth, 0);
1330
1331     // Null move search
1332     if (    allowNullmove
1333         &&  depth > OnePly
1334         && !isCheck
1335         && !value_is_mate(beta)
1336         &&  ok_to_do_nullmove(pos)
1337         &&  staticValue >= beta - (depth >= 4 * OnePly ? NullMoveMargin : 0))
1338     {
1339         ss[ply].currentMove = MOVE_NULL;
1340
1341         pos.do_null_move(st);
1342
1343         // Null move dynamic reduction based on depth
1344         int R = 3 + (depth >= 5 * OnePly ? depth / 8 : 0);
1345
1346         // Null move dynamic reduction based on value
1347         if (staticValue - beta > PawnValueMidgame)
1348             R++;
1349
1350         nullValue = -search(pos, ss, -(beta-1), depth-R*OnePly, ply+1, false, threadID);
1351
1352         pos.undo_null_move();
1353
1354         if (nullValue >= beta)
1355         {
1356             if (depth < 6 * OnePly)
1357                 return beta;
1358
1359             // Do zugzwang verification search
1360             Value v = search(pos, ss, beta, depth-5*OnePly, ply, false, threadID);
1361             if (v >= beta)
1362                 return beta;
1363         } else {
1364             // The null move failed low, which means that we may be faced with
1365             // some kind of threat. If the previous move was reduced, check if
1366             // the move that refuted the null move was somehow connected to the
1367             // move which was reduced. If a connection is found, return a fail
1368             // low score (which will cause the reduced move to fail high in the
1369             // parent node, which will trigger a re-search with full depth).
1370             if (nullValue == value_mated_in(ply + 2))
1371                 mateThreat = true;
1372
1373             ss[ply].threatMove = ss[ply + 1].currentMove;
1374             if (   depth < ThreatDepth
1375                 && ss[ply - 1].reduction
1376                 && connected_moves(pos, ss[ply - 1].currentMove, ss[ply].threatMove))
1377                 return beta - 1;
1378         }
1379     }
1380     // Null move search not allowed, try razoring
1381     else if (   !value_is_mate(beta)
1382              && !isCheck
1383              && depth < RazorDepth
1384              && staticValue < beta - (NullMoveMargin + 16 * depth)
1385              && ss[ply - 1].currentMove != MOVE_NULL
1386              && ttMove == MOVE_NONE
1387              && !pos.has_pawn_on_7th(pos.side_to_move()))
1388     {
1389         Value rbeta = beta - (NullMoveMargin + 16 * depth);
1390         Value v = qsearch(pos, ss, rbeta-1, rbeta, Depth(0), ply, threadID);
1391         if (v < rbeta)
1392           return v;
1393     }
1394
1395     // Go with internal iterative deepening if we don't have a TT move
1396     if (UseIIDAtNonPVNodes && ttMove == MOVE_NONE && depth >= 8*OnePly &&
1397         !isCheck && ss[ply].eval >= beta - IIDMargin)
1398     {
1399         search(pos, ss, beta, Min(depth/2, depth-2*OnePly), ply, false, threadID);
1400         ttMove = ss[ply].pv[ply];
1401         tte = TT.retrieve(posKey);
1402     }
1403
1404     // Initialize a MovePicker object for the current position, and prepare
1405     // to search all moves.
1406     MovePicker mp = MovePicker(pos, ttMove, depth, H, &ss[ply]);
1407     CheckInfo ci(pos);
1408
1409     // Loop through all legal moves until no moves remain or a beta cutoff occurs
1410     while (   bestValue < beta
1411            && (move = mp.get_next_move()) != MOVE_NONE
1412            && !TM.thread_should_stop(threadID))
1413     {
1414       assert(move_is_ok(move));
1415
1416       if (move == excludedMove)
1417           continue;
1418
1419       moveIsCheck = pos.move_is_check(move, ci);
1420       singleEvasion = (isCheck && mp.number_of_evasions() == 1);
1421       captureOrPromotion = pos.move_is_capture_or_promotion(move);
1422
1423       // Decide the new search depth
1424       ext = extension(pos, move, false, captureOrPromotion, moveIsCheck, singleEvasion, mateThreat, &dangerous);
1425
1426       // Singular extension search. We extend the TT move if its value is much better than
1427       // its siblings. To verify this we do a reduced search on all the other moves but the
1428       // ttMove, if result is lower then ttValue minus a margin then we extend ttMove.
1429       if (   depth >= 8 * OnePly
1430           && tte
1431           && move == tte->move()
1432           && !excludedMove // Do not allow recursive single-reply search
1433           && ext < OnePly
1434           && is_lower_bound(tte->type())
1435           && tte->depth() >= depth - 3 * OnePly)
1436       {
1437           Value ttValue = value_from_tt(tte->value(), ply);
1438
1439           if (abs(ttValue) < VALUE_KNOWN_WIN)
1440           {
1441               Value excValue = search(pos, ss, ttValue - SingleReplyMargin, depth / 2, ply, false, threadID, move);
1442
1443               if (excValue < ttValue - SingleReplyMargin)
1444                   ext = OnePly;
1445           }
1446       }
1447
1448       newDepth = depth - OnePly + ext;
1449
1450       // Update current move
1451       movesSearched[moveCount++] = ss[ply].currentMove = move;
1452
1453       // Futility pruning
1454       if (   !isCheck
1455           && !dangerous
1456           && !captureOrPromotion
1457           && !move_is_castle(move)
1458           &&  move != ttMove)
1459       {
1460           // Move count based pruning
1461           if (   moveCount >= futility_move_count(depth)
1462               && ok_to_prune(pos, move, ss[ply].threatMove)
1463               && bestValue > value_mated_in(PLY_MAX))
1464               continue;
1465
1466           // Value based pruning
1467           Depth predictedDepth = newDepth - nonpv_reduction(depth, moveCount); //FIXME: We are ignoring condition: depth >= 3*OnePly, BUG??
1468           futilityValueScaled =  ss[ply].eval + futility_margin(predictedDepth, moveCount)
1469                                + H.gain(pos.piece_on(move_from(move)), move_to(move)) + 45;
1470
1471           if (futilityValueScaled < beta)
1472           {
1473               if (futilityValueScaled > bestValue)
1474                   bestValue = futilityValueScaled;
1475               continue;
1476           }
1477       }
1478
1479       // Make and search the move
1480       pos.do_move(move, st, ci, moveIsCheck);
1481
1482       // Try to reduce non-pv search depth by one ply if move seems not problematic,
1483       // if the move fails high will be re-searched at full depth.
1484       bool doFullDepthSearch = true;
1485
1486       if (    depth >= 3*OnePly
1487           && !dangerous
1488           && !captureOrPromotion
1489           && !move_is_castle(move)
1490           && !move_is_killer(move, ss[ply]))
1491       {
1492           ss[ply].reduction = nonpv_reduction(depth, moveCount);
1493           if (ss[ply].reduction)
1494           {
1495               value = -search(pos, ss, -(beta-1), newDepth-ss[ply].reduction, ply+1, true, threadID);
1496               doFullDepthSearch = (value >= beta);
1497           }
1498       }
1499
1500       if (doFullDepthSearch) // Go with full depth non-pv search
1501       {
1502           ss[ply].reduction = Depth(0);
1503           value = -search(pos, ss, -(beta-1), newDepth, ply+1, true, threadID);
1504       }
1505       pos.undo_move(move);
1506
1507       assert(value > -VALUE_INFINITE && value < VALUE_INFINITE);
1508
1509       // New best move?
1510       if (value > bestValue)
1511       {
1512           bestValue = value;
1513           if (value >= beta)
1514               update_pv(ss, ply);
1515
1516           if (value == value_mate_in(ply + 1))
1517               ss[ply].mateKiller = move;
1518       }
1519
1520       // Split?
1521       if (   TM.active_threads() > 1
1522           && bestValue < beta
1523           && depth >= MinimumSplitDepth
1524           && Iteration <= 99
1525           && TM.available_thread_exists(threadID)
1526           && !AbortSearch
1527           && !TM.thread_should_stop(threadID)
1528           && TM.split(pos, ss, ply, &beta, &beta, &bestValue, futilityValue, //FIXME: SMP & futilityValue
1529                       depth, &moveCount, &mp, threadID, false))
1530           break;
1531     }
1532
1533     // All legal moves have been searched. A special case: If there were
1534     // no legal moves, it must be mate or stalemate.
1535     if (!moveCount)
1536         return excludedMove ? beta - 1 : (pos.is_check() ? value_mated_in(ply) : VALUE_DRAW);
1537
1538     // If the search is not aborted, update the transposition table,
1539     // history counters, and killer moves.
1540     if (AbortSearch || TM.thread_should_stop(threadID))
1541         return bestValue;
1542
1543     if (bestValue < beta)
1544         TT.store(posKey, value_to_tt(bestValue, ply), VALUE_TYPE_UPPER, depth, MOVE_NONE);
1545     else
1546     {
1547         TM.incrementBetaCounter(pos.side_to_move(), depth, threadID);
1548         move = ss[ply].pv[ply];
1549         TT.store(posKey, value_to_tt(bestValue, ply), VALUE_TYPE_LOWER, depth, move);
1550         if (!pos.move_is_capture_or_promotion(move))
1551         {
1552             update_history(pos, move, depth, movesSearched, moveCount);
1553             update_killers(move, ss[ply]);
1554         }
1555
1556     }
1557
1558     assert(bestValue > -VALUE_INFINITE && bestValue < VALUE_INFINITE);
1559
1560     return bestValue;
1561   }
1562
1563
1564   // qsearch() is the quiescence search function, which is called by the main
1565   // search function when the remaining depth is zero (or, to be more precise,
1566   // less than OnePly).
1567
1568   Value qsearch(Position& pos, SearchStack ss[], Value alpha, Value beta,
1569                 Depth depth, int ply, int threadID) {
1570
1571     assert(alpha >= -VALUE_INFINITE && alpha <= VALUE_INFINITE);
1572     assert(beta >= -VALUE_INFINITE && beta <= VALUE_INFINITE);
1573     assert(depth <= 0);
1574     assert(ply >= 0 && ply < PLY_MAX);
1575     assert(threadID >= 0 && threadID < TM.active_threads());
1576
1577     EvalInfo ei;
1578     StateInfo st;
1579     Move ttMove, move;
1580     Value staticValue, bestValue, value, futilityBase, futilityValue;
1581     bool isCheck, enoughMaterial, moveIsCheck, evasionPrunable;
1582     const TTEntry* tte = NULL;
1583     int moveCount = 0;
1584     bool pvNode = (beta - alpha != 1);
1585     Value oldAlpha = alpha;
1586
1587     // Initialize, and make an early exit in case of an aborted search,
1588     // an instant draw, maximum ply reached, etc.
1589     init_node(ss, ply, threadID);
1590
1591     // After init_node() that calls poll()
1592     if (AbortSearch || TM.thread_should_stop(threadID))
1593         return Value(0);
1594
1595     if (pos.is_draw() || ply >= PLY_MAX - 1)
1596         return VALUE_DRAW;
1597
1598     // Transposition table lookup. At PV nodes, we don't use the TT for
1599     // pruning, but only for move ordering.
1600     tte = TT.retrieve(pos.get_key());
1601     ttMove = (tte ? tte->move() : MOVE_NONE);
1602
1603     if (!pvNode && tte && ok_to_use_TT(tte, depth, beta, ply))
1604     {
1605         assert(tte->type() != VALUE_TYPE_EVAL);
1606
1607         ss[ply].currentMove = ttMove; // Can be MOVE_NONE
1608         return value_from_tt(tte->value(), ply);
1609     }
1610
1611     isCheck = pos.is_check();
1612
1613     // Evaluate the position statically
1614     if (isCheck)
1615         staticValue = -VALUE_INFINITE;
1616     else if (tte && (tte->type() & VALUE_TYPE_EVAL))
1617         staticValue = value_from_tt(tte->value(), ply);
1618     else
1619         staticValue = evaluate(pos, ei, threadID);
1620
1621     if (!isCheck)
1622     {
1623         ss[ply].eval = staticValue;
1624         update_gains(pos, ss[ply - 1].currentMove, ss[ply - 1].eval, ss[ply].eval);
1625     }
1626
1627     // Initialize "stand pat score", and return it immediately if it is
1628     // at least beta.
1629     bestValue = staticValue;
1630
1631     if (bestValue >= beta)
1632     {
1633         // Store the score to avoid a future costly evaluation() call
1634         if (!isCheck && !tte && ei.futilityMargin[pos.side_to_move()] == 0)
1635             TT.store(pos.get_key(), value_to_tt(bestValue, ply), VALUE_TYPE_EV_LO, Depth(-127*OnePly), MOVE_NONE);
1636
1637         return bestValue;
1638     }
1639
1640     if (bestValue > alpha)
1641         alpha = bestValue;
1642
1643     // If we are near beta then try to get a cutoff pushing checks a bit further
1644     bool deepChecks = depth == -OnePly && staticValue >= beta - PawnValueMidgame / 8;
1645
1646     // Initialize a MovePicker object for the current position, and prepare
1647     // to search the moves. Because the depth is <= 0 here, only captures,
1648     // queen promotions and checks (only if depth == 0 or depth == -OnePly
1649     // and we are near beta) will be generated.
1650     MovePicker mp = MovePicker(pos, ttMove, deepChecks ? Depth(0) : depth, H);
1651     CheckInfo ci(pos);
1652     enoughMaterial = pos.non_pawn_material(pos.side_to_move()) > RookValueMidgame;
1653     futilityBase = staticValue + FutilityMarginQS + ei.futilityMargin[pos.side_to_move()];
1654
1655     // Loop through the moves until no moves remain or a beta cutoff
1656     // occurs.
1657     while (   alpha < beta
1658            && (move = mp.get_next_move()) != MOVE_NONE)
1659     {
1660       assert(move_is_ok(move));
1661
1662       moveIsCheck = pos.move_is_check(move, ci);
1663
1664       // Update current move
1665       moveCount++;
1666       ss[ply].currentMove = move;
1667
1668       // Futility pruning
1669       if (   enoughMaterial
1670           && !isCheck
1671           && !pvNode
1672           && !moveIsCheck
1673           &&  move != ttMove
1674           && !move_is_promotion(move)
1675           && !pos.move_is_passed_pawn_push(move))
1676       {
1677           futilityValue =  futilityBase
1678                          + pos.endgame_value_of_piece_on(move_to(move))
1679                          + (move_is_ep(move) ? PawnValueEndgame : Value(0));
1680
1681           if (futilityValue < alpha)
1682           {
1683               if (futilityValue > bestValue)
1684                   bestValue = futilityValue;
1685               continue;
1686           }
1687       }
1688
1689       // Detect blocking evasions that are candidate to be pruned
1690       evasionPrunable =   isCheck
1691                        && bestValue != -VALUE_INFINITE
1692                        && !pos.move_is_capture(move)
1693                        && pos.type_of_piece_on(move_from(move)) != KING
1694                        && !pos.can_castle(pos.side_to_move());
1695
1696       // Don't search moves with negative SEE values
1697       if (   (!isCheck || evasionPrunable)
1698           && !pvNode
1699           &&  move != ttMove
1700           && !move_is_promotion(move)
1701           &&  pos.see_sign(move) < 0)
1702           continue;
1703
1704       // Make and search the move
1705       pos.do_move(move, st, ci, moveIsCheck);
1706       value = -qsearch(pos, ss, -beta, -alpha, depth-OnePly, ply+1, threadID);
1707       pos.undo_move(move);
1708
1709       assert(value > -VALUE_INFINITE && value < VALUE_INFINITE);
1710
1711       // New best move?
1712       if (value > bestValue)
1713       {
1714           bestValue = value;
1715           if (value > alpha)
1716           {
1717               alpha = value;
1718               update_pv(ss, ply);
1719           }
1720        }
1721     }
1722
1723     // All legal moves have been searched. A special case: If we're in check
1724     // and no legal moves were found, it is checkmate.
1725     if (!moveCount && pos.is_check()) // Mate!
1726         return value_mated_in(ply);
1727
1728     // Update transposition table
1729     Depth d = (depth == Depth(0) ? Depth(0) : Depth(-1));
1730     if (bestValue <= oldAlpha)
1731     {
1732         // If bestValue isn't changed it means it is still the static evaluation
1733         // of the node, so keep this info to avoid a future evaluation() call.
1734         ValueType type = (bestValue == staticValue && !ei.futilityMargin[pos.side_to_move()] ? VALUE_TYPE_EV_UP : VALUE_TYPE_UPPER);
1735         TT.store(pos.get_key(), value_to_tt(bestValue, ply), type, d, MOVE_NONE);
1736     }
1737     else if (bestValue >= beta)
1738     {
1739         move = ss[ply].pv[ply];
1740         TT.store(pos.get_key(), value_to_tt(bestValue, ply), VALUE_TYPE_LOWER, d, move);
1741
1742         // Update killers only for good checking moves
1743         if (!pos.move_is_capture_or_promotion(move))
1744             update_killers(move, ss[ply]);
1745     }
1746     else
1747         TT.store(pos.get_key(), value_to_tt(bestValue, ply), VALUE_TYPE_EXACT, d, ss[ply].pv[ply]);
1748
1749     assert(bestValue > -VALUE_INFINITE && bestValue < VALUE_INFINITE);
1750
1751     return bestValue;
1752   }
1753
1754
1755   // sp_search() is used to search from a split point.  This function is called
1756   // by each thread working at the split point.  It is similar to the normal
1757   // search() function, but simpler.  Because we have already probed the hash
1758   // table, done a null move search, and searched the first move before
1759   // splitting, we don't have to repeat all this work in sp_search().  We
1760   // also don't need to store anything to the hash table here:  This is taken
1761   // care of after we return from the split point.
1762
1763   void sp_search(SplitPoint* sp, int threadID) {
1764
1765     assert(threadID >= 0 && threadID < TM.active_threads());
1766     assert(TM.active_threads() > 1);
1767
1768     Position pos(*sp->pos);
1769     CheckInfo ci(pos);
1770     SearchStack* ss = sp->sstack[threadID];
1771     Value value = -VALUE_INFINITE;
1772     Move move;
1773     int moveCount;
1774     bool isCheck = pos.is_check();
1775     bool useFutilityPruning =     sp->depth < 7 * OnePly //FIXME: sync with search
1776                               && !isCheck;
1777
1778     while (    lock_grab_bool(&(sp->lock))
1779            &&  sp->bestValue < sp->beta
1780            && !TM.thread_should_stop(threadID)
1781            && (move = sp->mp->get_next_move()) != MOVE_NONE)
1782     {
1783       moveCount = ++sp->moves;
1784       lock_release(&(sp->lock));
1785
1786       assert(move_is_ok(move));
1787
1788       bool moveIsCheck = pos.move_is_check(move, ci);
1789       bool captureOrPromotion = pos.move_is_capture_or_promotion(move);
1790
1791       ss[sp->ply].currentMove = move;
1792
1793       // Decide the new search depth
1794       bool dangerous;
1795       Depth ext = extension(pos, move, false, captureOrPromotion, moveIsCheck, false, false, &dangerous);
1796       Depth newDepth = sp->depth - OnePly + ext;
1797
1798       // Prune?
1799       if (    useFutilityPruning
1800           && !dangerous
1801           && !captureOrPromotion)
1802       {
1803           // Move count based pruning
1804           if (   moveCount >= futility_move_count(sp->depth)
1805               && ok_to_prune(pos, move, ss[sp->ply].threatMove)
1806               && sp->bestValue > value_mated_in(PLY_MAX))
1807               continue;
1808
1809           // Value based pruning
1810           Value futilityValueScaled = sp->futilityValue - moveCount * 8; //FIXME: sync with search
1811
1812           if (futilityValueScaled < sp->beta)
1813           {
1814               if (futilityValueScaled > sp->bestValue) // Less then 1% of cases
1815               {
1816                   lock_grab(&(sp->lock));
1817                   if (futilityValueScaled > sp->bestValue)
1818                       sp->bestValue = futilityValueScaled;
1819                   lock_release(&(sp->lock));
1820               }
1821               continue;
1822           }
1823       }
1824
1825       // Make and search the move.
1826       StateInfo st;
1827       pos.do_move(move, st, ci, moveIsCheck);
1828
1829       // Try to reduce non-pv search depth by one ply if move seems not problematic,
1830       // if the move fails high will be re-searched at full depth.
1831       bool doFullDepthSearch = true;
1832
1833       if (   !dangerous
1834           && !captureOrPromotion
1835           && !move_is_castle(move)
1836           && !move_is_killer(move, ss[sp->ply]))
1837       {
1838           ss[sp->ply].reduction = nonpv_reduction(sp->depth, moveCount);
1839           if (ss[sp->ply].reduction)
1840           {
1841               value = -search(pos, ss, -(sp->beta-1), newDepth-ss[sp->ply].reduction, sp->ply+1, true, threadID);
1842               doFullDepthSearch = (value >= sp->beta);
1843           }
1844       }
1845
1846       if (doFullDepthSearch) // Go with full depth non-pv search
1847       {
1848           ss[sp->ply].reduction = Depth(0);
1849           value = -search(pos, ss, -(sp->beta - 1), newDepth, sp->ply+1, true, threadID);
1850       }
1851       pos.undo_move(move);
1852
1853       assert(value > -VALUE_INFINITE && value < VALUE_INFINITE);
1854
1855       if (TM.thread_should_stop(threadID))
1856       {
1857           lock_grab(&(sp->lock));
1858           break;
1859       }
1860
1861       // New best move?
1862       if (value > sp->bestValue) // Less then 2% of cases
1863       {
1864           lock_grab(&(sp->lock));
1865           if (value > sp->bestValue && !TM.thread_should_stop(threadID))
1866           {
1867               sp->bestValue = value;
1868               if (sp->bestValue >= sp->beta)
1869               {
1870                   sp_update_pv(sp->parentSstack, ss, sp->ply);
1871                   for (int i = 0; i < TM.active_threads(); i++)
1872                       if (i != threadID && (i == sp->master || sp->slaves[i]))
1873                           TM.set_stop_request(i);
1874
1875                   sp->finished = true;
1876               }
1877           }
1878           lock_release(&(sp->lock));
1879       }
1880     }
1881
1882     /* Here we have the lock still grabbed */
1883
1884     // If this is the master thread and we have been asked to stop because of
1885     // a beta cutoff higher up in the tree, stop all slave threads. Note that
1886     // thread_should_stop(threadID) does not imply that 'stop' flag is set, so
1887     // do this explicitly now, under lock protection.
1888     if (sp->master == threadID && TM.thread_should_stop(threadID))
1889         for (int i = 0; i < TM.active_threads(); i++)
1890             if (sp->slaves[i] || i == threadID)
1891                 TM.set_stop_request(i);
1892
1893     sp->cpus--;
1894     sp->slaves[threadID] = 0;
1895
1896     lock_release(&(sp->lock));
1897   }
1898
1899
1900   // sp_search_pv() is used to search from a PV split point.  This function
1901   // is called by each thread working at the split point.  It is similar to
1902   // the normal search_pv() function, but simpler.  Because we have already
1903   // probed the hash table and searched the first move before splitting, we
1904   // don't have to repeat all this work in sp_search_pv().  We also don't
1905   // need to store anything to the hash table here: This is taken care of
1906   // after we return from the split point.
1907
1908   void sp_search_pv(SplitPoint* sp, int threadID) {
1909
1910     assert(threadID >= 0 && threadID < TM.active_threads());
1911     assert(TM.active_threads() > 1);
1912
1913     Position pos(*sp->pos);
1914     CheckInfo ci(pos);
1915     SearchStack* ss = sp->sstack[threadID];
1916     Value value = -VALUE_INFINITE;
1917     int moveCount;
1918     Move move;
1919
1920     while (    lock_grab_bool(&(sp->lock))
1921            &&  sp->alpha < sp->beta
1922            && !TM.thread_should_stop(threadID)
1923            && (move = sp->mp->get_next_move()) != MOVE_NONE)
1924     {
1925       moveCount = ++sp->moves;
1926       lock_release(&(sp->lock));
1927
1928       assert(move_is_ok(move));
1929
1930       bool moveIsCheck = pos.move_is_check(move, ci);
1931       bool captureOrPromotion = pos.move_is_capture_or_promotion(move);
1932
1933       ss[sp->ply].currentMove = move;
1934
1935       // Decide the new search depth
1936       bool dangerous;
1937       Depth ext = extension(pos, move, true, captureOrPromotion, moveIsCheck, false, false, &dangerous);
1938       Depth newDepth = sp->depth - OnePly + ext;
1939
1940       // Make and search the move.
1941       StateInfo st;
1942       pos.do_move(move, st, ci, moveIsCheck);
1943
1944       // Try to reduce non-pv search depth by one ply if move seems not problematic,
1945       // if the move fails high will be re-searched at full depth.
1946       bool doFullDepthSearch = true;
1947
1948       if (   !dangerous
1949           && !captureOrPromotion
1950           && !move_is_castle(move)
1951           && !move_is_killer(move, ss[sp->ply]))
1952       {
1953           ss[sp->ply].reduction = pv_reduction(sp->depth, moveCount);
1954           if (ss[sp->ply].reduction)
1955           {
1956               Value localAlpha = sp->alpha;
1957               value = -search(pos, ss, -localAlpha, newDepth-ss[sp->ply].reduction, sp->ply+1, true, threadID);
1958               doFullDepthSearch = (value > localAlpha);
1959           }
1960       }
1961
1962       if (doFullDepthSearch) // Go with full depth non-pv search
1963       {
1964           Value localAlpha = sp->alpha;
1965           ss[sp->ply].reduction = Depth(0);
1966           value = -search(pos, ss, -localAlpha, newDepth, sp->ply+1, true, threadID);
1967
1968           if (value > localAlpha && value < sp->beta)
1969           {
1970               // If another thread has failed high then sp->alpha has been increased
1971               // to be higher or equal then beta, if so, avoid to start a PV search.
1972               localAlpha = sp->alpha;
1973               if (localAlpha < sp->beta)
1974                   value = -search_pv(pos, ss, -sp->beta, -localAlpha, newDepth, sp->ply+1, threadID);
1975               else
1976                   assert(TM.thread_should_stop(threadID));
1977         }
1978       }
1979       pos.undo_move(move);
1980
1981       assert(value > -VALUE_INFINITE && value < VALUE_INFINITE);
1982
1983       if (TM.thread_should_stop(threadID))
1984       {
1985           lock_grab(&(sp->lock));
1986           break;
1987       }
1988
1989       // New best move?
1990       if (value > sp->bestValue) // Less then 2% of cases
1991       {
1992           lock_grab(&(sp->lock));
1993           if (value > sp->bestValue && !TM.thread_should_stop(threadID))
1994           {
1995               sp->bestValue = value;
1996               if (value > sp->alpha)
1997               {
1998                   // Ask threads to stop before to modify sp->alpha
1999                   if (value >= sp->beta)
2000                   {
2001                       for (int i = 0; i < TM.active_threads(); i++)
2002                           if (i != threadID && (i == sp->master || sp->slaves[i]))
2003                               TM.set_stop_request(i);
2004
2005                       sp->finished = true;
2006                   }
2007
2008                   sp->alpha = value;
2009
2010                   sp_update_pv(sp->parentSstack, ss, sp->ply);
2011                   if (value == value_mate_in(sp->ply + 1))
2012                       ss[sp->ply].mateKiller = move;
2013               }
2014           }
2015           lock_release(&(sp->lock));
2016       }
2017     }
2018
2019     /* Here we have the lock still grabbed */
2020
2021     // If this is the master thread and we have been asked to stop because of
2022     // a beta cutoff higher up in the tree, stop all slave threads. Note that
2023     // thread_should_stop(threadID) does not imply that 'stop' flag is set, so
2024     // do this explicitly now, under lock protection.
2025     if (sp->master == threadID && TM.thread_should_stop(threadID))
2026         for (int i = 0; i < TM.active_threads(); i++)
2027             if (sp->slaves[i] || i == threadID)
2028                 TM.set_stop_request(i);
2029
2030     sp->cpus--;
2031     sp->slaves[threadID] = 0;
2032
2033     lock_release(&(sp->lock));
2034   }
2035
2036
2037   // init_node() is called at the beginning of all the search functions
2038   // (search(), search_pv(), qsearch(), and so on) and initializes the
2039   // search stack object corresponding to the current node. Once every
2040   // NodesBetweenPolls nodes, init_node() also calls poll(), which polls
2041   // for user input and checks whether it is time to stop the search.
2042
2043   void init_node(SearchStack ss[], int ply, int threadID) {
2044
2045     assert(ply >= 0 && ply < PLY_MAX);
2046     assert(threadID >= 0 && threadID < TM.active_threads());
2047
2048     TM.incrementNodeCounter(threadID);
2049
2050     if (threadID == 0)
2051     {
2052         NodesSincePoll++;
2053         if (NodesSincePoll >= NodesBetweenPolls)
2054         {
2055             poll();
2056             NodesSincePoll = 0;
2057         }
2058     }
2059     ss[ply].init(ply);
2060     ss[ply + 2].initKillers();
2061     TM.print_current_line(ss, ply, threadID);
2062   }
2063
2064
2065   // update_pv() is called whenever a search returns a value > alpha.
2066   // It updates the PV in the SearchStack object corresponding to the
2067   // current node.
2068
2069   void update_pv(SearchStack ss[], int ply) {
2070
2071     assert(ply >= 0 && ply < PLY_MAX);
2072
2073     int p;
2074
2075     ss[ply].pv[ply] = ss[ply].currentMove;
2076
2077     for (p = ply + 1; ss[ply + 1].pv[p] != MOVE_NONE; p++)
2078         ss[ply].pv[p] = ss[ply + 1].pv[p];
2079
2080     ss[ply].pv[p] = MOVE_NONE;
2081   }
2082
2083
2084   // sp_update_pv() is a variant of update_pv for use at split points. The
2085   // difference between the two functions is that sp_update_pv also updates
2086   // the PV at the parent node.
2087
2088   void sp_update_pv(SearchStack* pss, SearchStack ss[], int ply) {
2089
2090     assert(ply >= 0 && ply < PLY_MAX);
2091
2092     int p;
2093
2094     ss[ply].pv[ply] = pss[ply].pv[ply] = ss[ply].currentMove;
2095
2096     for (p = ply + 1; ss[ply + 1].pv[p] != MOVE_NONE; p++)
2097         ss[ply].pv[p] = pss[ply].pv[p] = ss[ply + 1].pv[p];
2098
2099     ss[ply].pv[p] = pss[ply].pv[p] = MOVE_NONE;
2100   }
2101
2102
2103   // connected_moves() tests whether two moves are 'connected' in the sense
2104   // that the first move somehow made the second move possible (for instance
2105   // if the moving piece is the same in both moves). The first move is assumed
2106   // to be the move that was made to reach the current position, while the
2107   // second move is assumed to be a move from the current position.
2108
2109   bool connected_moves(const Position& pos, Move m1, Move m2) {
2110
2111     Square f1, t1, f2, t2;
2112     Piece p;
2113
2114     assert(move_is_ok(m1));
2115     assert(move_is_ok(m2));
2116
2117     if (m2 == MOVE_NONE)
2118         return false;
2119
2120     // Case 1: The moving piece is the same in both moves
2121     f2 = move_from(m2);
2122     t1 = move_to(m1);
2123     if (f2 == t1)
2124         return true;
2125
2126     // Case 2: The destination square for m2 was vacated by m1
2127     t2 = move_to(m2);
2128     f1 = move_from(m1);
2129     if (t2 == f1)
2130         return true;
2131
2132     // Case 3: Moving through the vacated square
2133     if (   piece_is_slider(pos.piece_on(f2))
2134         && bit_is_set(squares_between(f2, t2), f1))
2135       return true;
2136
2137     // Case 4: The destination square for m2 is defended by the moving piece in m1
2138     p = pos.piece_on(t1);
2139     if (bit_is_set(pos.attacks_from(p, t1), t2))
2140         return true;
2141
2142     // Case 5: Discovered check, checking piece is the piece moved in m1
2143     if (    piece_is_slider(p)
2144         &&  bit_is_set(squares_between(t1, pos.king_square(pos.side_to_move())), f2)
2145         && !bit_is_set(squares_between(t1, pos.king_square(pos.side_to_move())), t2))
2146     {
2147         // discovered_check_candidates() works also if the Position's side to
2148         // move is the opposite of the checking piece.
2149         Color them = opposite_color(pos.side_to_move());
2150         Bitboard dcCandidates = pos.discovered_check_candidates(them);
2151
2152         if (bit_is_set(dcCandidates, f2))
2153             return true;
2154     }
2155     return false;
2156   }
2157
2158
2159   // value_is_mate() checks if the given value is a mate one
2160   // eventually compensated for the ply.
2161
2162   bool value_is_mate(Value value) {
2163
2164     assert(abs(value) <= VALUE_INFINITE);
2165
2166     return   value <= value_mated_in(PLY_MAX)
2167           || value >= value_mate_in(PLY_MAX);
2168   }
2169
2170
2171   // move_is_killer() checks if the given move is among the
2172   // killer moves of that ply.
2173
2174   bool move_is_killer(Move m, const SearchStack& ss) {
2175
2176       const Move* k = ss.killers;
2177       for (int i = 0; i < KILLER_MAX; i++, k++)
2178           if (*k == m)
2179               return true;
2180
2181       return false;
2182   }
2183
2184
2185   // extension() decides whether a move should be searched with normal depth,
2186   // or with extended depth. Certain classes of moves (checking moves, in
2187   // particular) are searched with bigger depth than ordinary moves and in
2188   // any case are marked as 'dangerous'. Note that also if a move is not
2189   // extended, as example because the corresponding UCI option is set to zero,
2190   // the move is marked as 'dangerous' so, at least, we avoid to prune it.
2191
2192   Depth extension(const Position& pos, Move m, bool pvNode, bool captureOrPromotion,
2193                   bool moveIsCheck, bool singleEvasion, bool mateThreat, bool* dangerous) {
2194
2195     assert(m != MOVE_NONE);
2196
2197     Depth result = Depth(0);
2198     *dangerous = moveIsCheck | singleEvasion | mateThreat;
2199
2200     if (*dangerous)
2201     {
2202         if (moveIsCheck)
2203             result += CheckExtension[pvNode];
2204
2205         if (singleEvasion)
2206             result += SingleEvasionExtension[pvNode];
2207
2208         if (mateThreat)
2209             result += MateThreatExtension[pvNode];
2210     }
2211
2212     if (pos.type_of_piece_on(move_from(m)) == PAWN)
2213     {
2214         Color c = pos.side_to_move();
2215         if (relative_rank(c, move_to(m)) == RANK_7)
2216         {
2217             result += PawnPushTo7thExtension[pvNode];
2218             *dangerous = true;
2219         }
2220         if (pos.pawn_is_passed(c, move_to(m)))
2221         {
2222             result += PassedPawnExtension[pvNode];
2223             *dangerous = true;
2224         }
2225     }
2226
2227     if (   captureOrPromotion
2228         && pos.type_of_piece_on(move_to(m)) != PAWN
2229         && (  pos.non_pawn_material(WHITE) + pos.non_pawn_material(BLACK)
2230             - pos.midgame_value_of_piece_on(move_to(m)) == Value(0))
2231         && !move_is_promotion(m)
2232         && !move_is_ep(m))
2233     {
2234         result += PawnEndgameExtension[pvNode];
2235         *dangerous = true;
2236     }
2237
2238     if (   pvNode
2239         && captureOrPromotion
2240         && pos.type_of_piece_on(move_to(m)) != PAWN
2241         && pos.see_sign(m) >= 0)
2242     {
2243         result += OnePly/2;
2244         *dangerous = true;
2245     }
2246
2247     return Min(result, OnePly);
2248   }
2249
2250
2251   // ok_to_do_nullmove() looks at the current position and decides whether
2252   // doing a 'null move' should be allowed. In order to avoid zugzwang
2253   // problems, null moves are not allowed when the side to move has very
2254   // little material left. Currently, the test is a bit too simple: Null
2255   // moves are avoided only when the side to move has only pawns left.
2256   // It's probably a good idea to avoid null moves in at least some more
2257   // complicated endgames, e.g. KQ vs KR.  FIXME
2258
2259   bool ok_to_do_nullmove(const Position& pos) {
2260
2261     return pos.non_pawn_material(pos.side_to_move()) != Value(0);
2262   }
2263
2264
2265   // ok_to_prune() tests whether it is safe to forward prune a move. Only
2266   // non-tactical moves late in the move list close to the leaves are
2267   // candidates for pruning.
2268
2269   bool ok_to_prune(const Position& pos, Move m, Move threat) {
2270
2271     assert(move_is_ok(m));
2272     assert(threat == MOVE_NONE || move_is_ok(threat));
2273     assert(!pos.move_is_check(m));
2274     assert(!pos.move_is_capture_or_promotion(m));
2275     assert(!pos.move_is_passed_pawn_push(m));
2276
2277     Square mfrom, mto, tfrom, tto;
2278
2279     // Prune if there isn't any threat move
2280     if (threat == MOVE_NONE)
2281         return true;
2282
2283     mfrom = move_from(m);
2284     mto = move_to(m);
2285     tfrom = move_from(threat);
2286     tto = move_to(threat);
2287
2288     // Case 1: Don't prune moves which move the threatened piece
2289     if (mfrom == tto)
2290         return false;
2291
2292     // Case 2: If the threatened piece has value less than or equal to the
2293     // value of the threatening piece, don't prune move which defend it.
2294     if (   pos.move_is_capture(threat)
2295         && (   pos.midgame_value_of_piece_on(tfrom) >= pos.midgame_value_of_piece_on(tto)
2296             || pos.type_of_piece_on(tfrom) == KING)
2297         && pos.move_attacks_square(m, tto))
2298         return false;
2299
2300     // Case 3: If the moving piece in the threatened move is a slider, don't
2301     // prune safe moves which block its ray.
2302     if (   piece_is_slider(pos.piece_on(tfrom))
2303         && bit_is_set(squares_between(tfrom, tto), mto)
2304         && pos.see_sign(m) >= 0)
2305         return false;
2306
2307     return true;
2308   }
2309
2310
2311   // ok_to_use_TT() returns true if a transposition table score
2312   // can be used at a given point in search.
2313
2314   bool ok_to_use_TT(const TTEntry* tte, Depth depth, Value beta, int ply) {
2315
2316     Value v = value_from_tt(tte->value(), ply);
2317
2318     return   (   tte->depth() >= depth
2319               || v >= Max(value_mate_in(PLY_MAX), beta)
2320               || v < Min(value_mated_in(PLY_MAX), beta))
2321
2322           && (   (is_lower_bound(tte->type()) && v >= beta)
2323               || (is_upper_bound(tte->type()) && v < beta));
2324   }
2325
2326
2327   // refine_eval() returns the transposition table score if
2328   // possible otherwise falls back on static position evaluation.
2329
2330   Value refine_eval(const TTEntry* tte, Value defaultEval, int ply) {
2331
2332       if (!tte)
2333           return defaultEval;
2334
2335       Value v = value_from_tt(tte->value(), ply);
2336
2337       if (   (is_lower_bound(tte->type()) && v >= defaultEval)
2338           || (is_upper_bound(tte->type()) && v < defaultEval))
2339           return v;
2340
2341       return defaultEval;
2342   }
2343
2344
2345   // update_history() registers a good move that produced a beta-cutoff
2346   // in history and marks as failures all the other moves of that ply.
2347
2348   void update_history(const Position& pos, Move move, Depth depth,
2349                       Move movesSearched[], int moveCount) {
2350
2351     Move m;
2352
2353     H.success(pos.piece_on(move_from(move)), move_to(move), depth);
2354
2355     for (int i = 0; i < moveCount - 1; i++)
2356     {
2357         m = movesSearched[i];
2358
2359         assert(m != move);
2360
2361         if (!pos.move_is_capture_or_promotion(m))
2362             H.failure(pos.piece_on(move_from(m)), move_to(m), depth);
2363     }
2364   }
2365
2366
2367   // update_killers() add a good move that produced a beta-cutoff
2368   // among the killer moves of that ply.
2369
2370   void update_killers(Move m, SearchStack& ss) {
2371
2372     if (m == ss.killers[0])
2373         return;
2374
2375     for (int i = KILLER_MAX - 1; i > 0; i--)
2376         ss.killers[i] = ss.killers[i - 1];
2377
2378     ss.killers[0] = m;
2379   }
2380
2381
2382   // update_gains() updates the gains table of a non-capture move given
2383   // the static position evaluation before and after the move.
2384
2385   void update_gains(const Position& pos, Move m, Value before, Value after) {
2386
2387     if (   m != MOVE_NULL
2388         && before != VALUE_NONE
2389         && after != VALUE_NONE
2390         && pos.captured_piece() == NO_PIECE_TYPE
2391         && !move_is_castle(m)
2392         && !move_is_promotion(m))
2393         H.set_gain(pos.piece_on(move_to(m)), move_to(m), -(before + after));
2394   }
2395
2396
2397   // current_search_time() returns the number of milliseconds which have passed
2398   // since the beginning of the current search.
2399
2400   int current_search_time() {
2401
2402     return get_system_time() - SearchStartTime;
2403   }
2404
2405
2406   // nps() computes the current nodes/second count.
2407
2408   int nps() {
2409
2410     int t = current_search_time();
2411     return (t > 0 ? int((TM.nodes_searched() * 1000) / t) : 0);
2412   }
2413
2414
2415   // poll() performs two different functions: It polls for user input, and it
2416   // looks at the time consumed so far and decides if it's time to abort the
2417   // search.
2418
2419   void poll() {
2420
2421     static int lastInfoTime;
2422     int t = current_search_time();
2423
2424     //  Poll for input
2425     if (Bioskey())
2426     {
2427         // We are line oriented, don't read single chars
2428         std::string command;
2429
2430         if (!std::getline(std::cin, command))
2431             command = "quit";
2432
2433         if (command == "quit")
2434         {
2435             AbortSearch = true;
2436             PonderSearch = false;
2437             Quit = true;
2438             return;
2439         }
2440         else if (command == "stop")
2441         {
2442             AbortSearch = true;
2443             PonderSearch = false;
2444         }
2445         else if (command == "ponderhit")
2446             ponderhit();
2447     }
2448
2449     // Print search information
2450     if (t < 1000)
2451         lastInfoTime = 0;
2452
2453     else if (lastInfoTime > t)
2454         // HACK: Must be a new search where we searched less than
2455         // NodesBetweenPolls nodes during the first second of search.
2456         lastInfoTime = 0;
2457
2458     else if (t - lastInfoTime >= 1000)
2459     {
2460         lastInfoTime = t;
2461         lock_grab(&TM.IOLock);
2462
2463         if (dbg_show_mean)
2464             dbg_print_mean();
2465
2466         if (dbg_show_hit_rate)
2467             dbg_print_hit_rate();
2468
2469         cout << "info nodes " << TM.nodes_searched() << " nps " << nps()
2470              << " time " << t << " hashfull " << TT.full() << endl;
2471
2472         lock_release(&TM.IOLock);
2473
2474         if (ShowCurrentLine)
2475             TM.threads[0].printCurrentLineRequest = true;
2476     }
2477
2478     // Should we stop the search?
2479     if (PonderSearch)
2480         return;
2481
2482     bool stillAtFirstMove =    RootMoveNumber == 1
2483                            && !AspirationFailLow
2484                            &&  t > MaxSearchTime + ExtraSearchTime;
2485
2486     bool noMoreTime =   t > AbsoluteMaxSearchTime
2487                      || stillAtFirstMove;
2488
2489     if (   (Iteration >= 3 && UseTimeManagement && noMoreTime)
2490         || (ExactMaxTime && t >= ExactMaxTime)
2491         || (Iteration >= 3 && MaxNodes && TM.nodes_searched() >= MaxNodes))
2492         AbortSearch = true;
2493   }
2494
2495
2496   // ponderhit() is called when the program is pondering (i.e. thinking while
2497   // it's the opponent's turn to move) in order to let the engine know that
2498   // it correctly predicted the opponent's move.
2499
2500   void ponderhit() {
2501
2502     int t = current_search_time();
2503     PonderSearch = false;
2504
2505     bool stillAtFirstMove =    RootMoveNumber == 1
2506                            && !AspirationFailLow
2507                            &&  t > MaxSearchTime + ExtraSearchTime;
2508
2509     bool noMoreTime =   t > AbsoluteMaxSearchTime
2510                      || stillAtFirstMove;
2511
2512     if (Iteration >= 3 && UseTimeManagement && (noMoreTime || StopOnPonderhit))
2513         AbortSearch = true;
2514   }
2515
2516
2517   // init_ss_array() does a fast reset of the first entries of a SearchStack array
2518
2519   void init_ss_array(SearchStack ss[]) {
2520
2521     for (int i = 0; i < 3; i++)
2522     {
2523         ss[i].init(i);
2524         ss[i].initKillers();
2525     }
2526   }
2527
2528
2529   // wait_for_stop_or_ponderhit() is called when the maximum depth is reached
2530   // while the program is pondering. The point is to work around a wrinkle in
2531   // the UCI protocol: When pondering, the engine is not allowed to give a
2532   // "bestmove" before the GUI sends it a "stop" or "ponderhit" command.
2533   // We simply wait here until one of these commands is sent, and return,
2534   // after which the bestmove and pondermove will be printed (in id_loop()).
2535
2536   void wait_for_stop_or_ponderhit() {
2537
2538     std::string command;
2539
2540     while (true)
2541     {
2542         if (!std::getline(std::cin, command))
2543             command = "quit";
2544
2545         if (command == "quit")
2546         {
2547             Quit = true;
2548             break;
2549         }
2550         else if (command == "ponderhit" || command == "stop")
2551             break;
2552     }
2553   }
2554
2555
2556   // init_thread() is the function which is called when a new thread is
2557   // launched. It simply calls the idle_loop() function with the supplied
2558   // threadID. There are two versions of this function; one for POSIX
2559   // threads and one for Windows threads.
2560
2561 #if !defined(_MSC_VER)
2562
2563   void* init_thread(void *threadID) {
2564
2565     TM.idle_loop(*(int*)threadID, NULL);
2566     return NULL;
2567   }
2568
2569 #else
2570
2571   DWORD WINAPI init_thread(LPVOID threadID) {
2572
2573     TM.idle_loop(*(int*)threadID, NULL);
2574     return NULL;
2575   }
2576
2577 #endif
2578
2579
2580   /// The ThreadsManager class
2581
2582   // resetNodeCounters(), resetBetaCounters(), searched_nodes() and
2583   // get_beta_counters() are getters/setters for the per thread
2584   // counters used to sort the moves at root.
2585
2586   void ThreadsManager::resetNodeCounters() {
2587
2588     for (int i = 0; i < MAX_THREADS; i++)
2589         threads[i].nodes = 0ULL;
2590   }
2591
2592   void ThreadsManager::resetBetaCounters() {
2593
2594     for (int i = 0; i < MAX_THREADS; i++)
2595         threads[i].betaCutOffs[WHITE] = threads[i].betaCutOffs[BLACK] = 0ULL;
2596   }
2597
2598   int64_t ThreadsManager::nodes_searched() const {
2599
2600     int64_t result = 0ULL;
2601     for (int i = 0; i < ActiveThreads; i++)
2602         result += threads[i].nodes;
2603
2604     return result;
2605   }
2606
2607   void ThreadsManager::get_beta_counters(Color us, int64_t& our, int64_t& their) const {
2608
2609     our = their = 0UL;
2610     for (int i = 0; i < MAX_THREADS; i++)
2611     {
2612         our += threads[i].betaCutOffs[us];
2613         their += threads[i].betaCutOffs[opposite_color(us)];
2614     }
2615   }
2616
2617
2618   // idle_loop() is where the threads are parked when they have no work to do.
2619   // The parameter "waitSp", if non-NULL, is a pointer to an active SplitPoint
2620   // object for which the current thread is the master.
2621
2622   void ThreadsManager::idle_loop(int threadID, SplitPoint* waitSp) {
2623
2624     assert(threadID >= 0 && threadID < MAX_THREADS);
2625
2626     while (true)
2627     {
2628         // Slave threads can exit as soon as AllThreadsShouldExit raises,
2629         // master should exit as last one.
2630         if (AllThreadsShouldExit && !waitSp)
2631         {
2632             threads[threadID].state = THREAD_TERMINATED;
2633             return;
2634         }
2635
2636         // If we are not thinking, wait for a condition to be signaled
2637         // instead of wasting CPU time polling for work.
2638         while (    threadID != 0
2639                && !AllThreadsShouldExit
2640                && (AllThreadsShouldSleep || threadID >= ActiveThreads))
2641         {
2642             threads[threadID].state = THREAD_SLEEPING;
2643
2644 #if !defined(_MSC_VER)
2645             pthread_mutex_lock(&WaitLock);
2646             pthread_cond_wait(&WaitCond, &WaitLock);
2647             pthread_mutex_unlock(&WaitLock);
2648 #else
2649             WaitForSingleObject(SitIdleEvent[threadID], INFINITE);
2650 #endif
2651             // State is already changed by wake_sleeping_threads()
2652             assert(threads[threadID].state == THREAD_AVAILABLE || threadID >= ActiveThreads);
2653         }
2654
2655         // If this thread has been assigned work, launch a search
2656         if (threads[threadID].state == THREAD_WORKISWAITING)
2657         {
2658             threads[threadID].state = THREAD_SEARCHING;
2659
2660             if (threads[threadID].splitPoint->pvNode)
2661                 sp_search_pv(threads[threadID].splitPoint, threadID);
2662             else
2663                 sp_search(threads[threadID].splitPoint, threadID);
2664
2665             assert(threads[threadID].state == THREAD_SEARCHING);
2666
2667             // If this is a slave thread reset to available, instead
2668             // if it is a master thread and all slaves have finished
2669             // then leave as is to avoid booking by another master,
2670             // we will leave idle loop shortly anyhow.
2671             if (   !AllThreadsShouldExit
2672                 && (!waitSp || waitSp->cpus > 0))
2673                 threads[threadID].state = THREAD_AVAILABLE;
2674         }
2675
2676         // If this thread is the master of a split point and all threads have
2677         // finished their work at this split point, return from the idle loop.
2678         if (waitSp != NULL && waitSp->cpus == 0)
2679         {
2680             assert(   threads[threadID].state == THREAD_AVAILABLE
2681                    || threads[threadID].state == THREAD_SEARCHING);
2682
2683             threads[threadID].state = THREAD_SEARCHING;
2684             return;
2685         }
2686     }
2687   }
2688
2689
2690   // init_threads() is called during startup. It launches all helper threads,
2691   // and initializes the split point stack and the global locks and condition
2692   // objects.
2693
2694   void ThreadsManager::init_threads() {
2695
2696     volatile int i;
2697     bool ok;
2698
2699 #if !defined(_MSC_VER)
2700     pthread_t pthread[1];
2701 #endif
2702
2703     // Initialize global locks
2704     lock_init(&MPLock, NULL);
2705     lock_init(&IOLock, NULL);
2706
2707     // Initialize SplitPointStack locks
2708     for (int i = 0; i < MAX_THREADS; i++)
2709         for (int j = 0; j < ACTIVE_SPLIT_POINTS_MAX; j++)
2710         {
2711             SplitPointStack[i][j].parent = NULL;
2712             lock_init(&(SplitPointStack[i][j].lock), NULL);
2713         }
2714
2715 #if !defined(_MSC_VER)
2716     pthread_mutex_init(&WaitLock, NULL);
2717     pthread_cond_init(&WaitCond, NULL);
2718 #else
2719     for (i = 0; i < MAX_THREADS; i++)
2720         SitIdleEvent[i] = CreateEvent(0, FALSE, FALSE, 0);
2721 #endif
2722
2723     // Will be set just before program exits to properly end the threads
2724     AllThreadsShouldExit = false;
2725
2726     // Threads will be put to sleep as soon as created
2727     AllThreadsShouldSleep = true;
2728
2729     // All threads except the main thread should be initialized to THREAD_AVAILABLE
2730     ActiveThreads = 1;
2731     threads[0].state = THREAD_SEARCHING;
2732     for (i = 1; i < MAX_THREADS; i++)
2733         threads[i].state = THREAD_AVAILABLE;
2734
2735     // Launch the helper threads
2736     for (i = 1; i < MAX_THREADS; i++)
2737     {
2738
2739 #if !defined(_MSC_VER)
2740         ok = (pthread_create(pthread, NULL, init_thread, (void*)(&i)) == 0);
2741 #else
2742         DWORD iID[1];
2743         ok = (CreateThread(NULL, 0, init_thread, (LPVOID)(&i), 0, iID) != NULL);
2744 #endif
2745
2746         if (!ok)
2747         {
2748             cout << "Failed to create thread number " << i << endl;
2749             Application::exit_with_failure();
2750         }
2751
2752         // Wait until the thread has finished launching and is gone to sleep
2753         while (threads[i].state != THREAD_SLEEPING);
2754     }
2755   }
2756
2757
2758   // exit_threads() is called when the program exits. It makes all the
2759   // helper threads exit cleanly.
2760
2761   void ThreadsManager::exit_threads() {
2762
2763     ActiveThreads = MAX_THREADS;  // HACK
2764     AllThreadsShouldSleep = true;  // HACK
2765     wake_sleeping_threads();
2766
2767     // This makes the threads to exit idle_loop()
2768     AllThreadsShouldExit = true;
2769
2770     // Wait for thread termination
2771     for (int i = 1; i < MAX_THREADS; i++)
2772         while (threads[i].state != THREAD_TERMINATED)
2773             threads[i].stopRequest = true;
2774
2775     // Now we can safely destroy the locks
2776     for (int i = 0; i < MAX_THREADS; i++)
2777         for (int j = 0; j < ACTIVE_SPLIT_POINTS_MAX; j++)
2778             lock_destroy(&(SplitPointStack[i][j].lock));
2779   }
2780
2781
2782   // thread_should_stop() checks whether the thread with a given threadID has
2783   // been asked to stop, directly or indirectly. This can happen if a beta
2784   // cutoff has occurred in the thread's currently active split point, or in
2785   // some ancestor of the current split point.
2786
2787   bool ThreadsManager::thread_should_stop(int threadID) const {
2788
2789     assert(threadID >= 0 && threadID < ActiveThreads);
2790
2791     SplitPoint* sp;
2792
2793     if (threads[threadID].stopRequest)
2794         return true;
2795
2796     if (ActiveThreads <= 2)
2797         return false;
2798
2799     for (sp = threads[threadID].splitPoint; sp != NULL; sp = sp->parent)
2800         if (sp->finished)
2801             return true;
2802
2803     return false;
2804   }
2805
2806
2807   // thread_is_available() checks whether the thread with threadID "slave" is
2808   // available to help the thread with threadID "master" at a split point. An
2809   // obvious requirement is that "slave" must be idle. With more than two
2810   // threads, this is not by itself sufficient:  If "slave" is the master of
2811   // some active split point, it is only available as a slave to the other
2812   // threads which are busy searching the split point at the top of "slave"'s
2813   // split point stack (the "helpful master concept" in YBWC terminology).
2814
2815   bool ThreadsManager::thread_is_available(int slave, int master) const {
2816
2817     assert(slave >= 0 && slave < ActiveThreads);
2818     assert(master >= 0 && master < ActiveThreads);
2819     assert(ActiveThreads > 1);
2820
2821     if (threads[slave].state != THREAD_AVAILABLE || slave == master)
2822         return false;
2823
2824     // Make a local copy to be sure doesn't change under our feet
2825     int localActiveSplitPoints = threads[slave].activeSplitPoints;
2826
2827     if (localActiveSplitPoints == 0)
2828         // No active split points means that the thread is available as
2829         // a slave for any other thread.
2830         return true;
2831
2832     if (ActiveThreads == 2)
2833         return true;
2834
2835     // Apply the "helpful master" concept if possible. Use localActiveSplitPoints
2836     // that is known to be > 0, instead of threads[slave].activeSplitPoints that
2837     // could have been set to 0 by another thread leading to an out of bound access.
2838     if (SplitPointStack[slave][localActiveSplitPoints - 1].slaves[master])
2839         return true;
2840
2841     return false;
2842   }
2843
2844
2845   // available_thread_exists() tries to find an idle thread which is available as
2846   // a slave for the thread with threadID "master".
2847
2848   bool ThreadsManager::available_thread_exists(int master) const {
2849
2850     assert(master >= 0 && master < ActiveThreads);
2851     assert(ActiveThreads > 1);
2852
2853     for (int i = 0; i < ActiveThreads; i++)
2854         if (thread_is_available(i, master))
2855             return true;
2856
2857     return false;
2858   }
2859
2860
2861   // split() does the actual work of distributing the work at a node between
2862   // several threads at PV nodes. If it does not succeed in splitting the
2863   // node (because no idle threads are available, or because we have no unused
2864   // split point objects), the function immediately returns false. If
2865   // splitting is possible, a SplitPoint object is initialized with all the
2866   // data that must be copied to the helper threads (the current position and
2867   // search stack, alpha, beta, the search depth, etc.), and we tell our
2868   // helper threads that they have been assigned work. This will cause them
2869   // to instantly leave their idle loops and call sp_search_pv(). When all
2870   // threads have returned from sp_search_pv (or, equivalently, when
2871   // splitPoint->cpus becomes 0), split() returns true.
2872
2873   bool ThreadsManager::split(const Position& p, SearchStack* sstck, int ply,
2874              Value* alpha, Value* beta, Value* bestValue, const Value futilityValue,
2875              Depth depth, int* moves, MovePicker* mp, int master, bool pvNode) {
2876
2877     assert(p.is_ok());
2878     assert(sstck != NULL);
2879     assert(ply >= 0 && ply < PLY_MAX);
2880     assert(*bestValue >= -VALUE_INFINITE && *bestValue <= *alpha);
2881     assert(!pvNode || *alpha < *beta);
2882     assert(*beta <= VALUE_INFINITE);
2883     assert(depth > Depth(0));
2884     assert(master >= 0 && master < ActiveThreads);
2885     assert(ActiveThreads > 1);
2886
2887     SplitPoint* splitPoint;
2888
2889     lock_grab(&MPLock);
2890
2891     // If no other thread is available to help us, or if we have too many
2892     // active split points, don't split.
2893     if (   !available_thread_exists(master)
2894         || threads[master].activeSplitPoints >= ACTIVE_SPLIT_POINTS_MAX)
2895     {
2896         lock_release(&MPLock);
2897         return false;
2898     }
2899
2900     // Pick the next available split point object from the split point stack
2901     splitPoint = SplitPointStack[master] + threads[master].activeSplitPoints;
2902     threads[master].activeSplitPoints++;
2903
2904     // Initialize the split point object
2905     splitPoint->parent = threads[master].splitPoint;
2906     splitPoint->finished = false;
2907     splitPoint->ply = ply;
2908     splitPoint->depth = depth;
2909     splitPoint->alpha = pvNode ? *alpha : (*beta - 1);
2910     splitPoint->beta = *beta;
2911     splitPoint->pvNode = pvNode;
2912     splitPoint->bestValue = *bestValue;
2913     splitPoint->futilityValue = futilityValue;
2914     splitPoint->master = master;
2915     splitPoint->mp = mp;
2916     splitPoint->moves = *moves;
2917     splitPoint->cpus = 1;
2918     splitPoint->pos = &p;
2919     splitPoint->parentSstack = sstck;
2920     for (int i = 0; i < ActiveThreads; i++)
2921         splitPoint->slaves[i] = 0;
2922
2923     threads[master].splitPoint = splitPoint;
2924
2925     // If we are here it means we are not available
2926     assert(threads[master].state != THREAD_AVAILABLE);
2927
2928     // Allocate available threads setting state to THREAD_BOOKED
2929     for (int i = 0; i < ActiveThreads && splitPoint->cpus < MaxThreadsPerSplitPoint; i++)
2930         if (thread_is_available(i, master))
2931         {
2932             threads[i].state = THREAD_BOOKED;
2933             threads[i].stopRequest = false;
2934             threads[i].splitPoint = splitPoint;
2935             splitPoint->slaves[i] = 1;
2936             splitPoint->cpus++;
2937         }
2938
2939     assert(splitPoint->cpus > 1);
2940
2941     // We can release the lock because slave threads are already booked and master is not available
2942     lock_release(&MPLock);
2943
2944     // Tell the threads that they have work to do. This will make them leave
2945     // their idle loop. But before copy search stack tail for each thread.
2946     for (int i = 0; i < ActiveThreads; i++)
2947         if (i == master || splitPoint->slaves[i])
2948         {
2949             memcpy(splitPoint->sstack[i] + ply - 1, sstck + ply - 1, 4 * sizeof(SearchStack));
2950
2951             assert(i == master || threads[i].state == THREAD_BOOKED);
2952
2953             threads[i].state = THREAD_WORKISWAITING; // This makes the slave to exit from idle_loop()
2954         }
2955
2956     // Everything is set up. The master thread enters the idle loop, from
2957     // which it will instantly launch a search, because its state is
2958     // THREAD_WORKISWAITING.  We send the split point as a second parameter to the
2959     // idle loop, which means that the main thread will return from the idle
2960     // loop when all threads have finished their work at this split point
2961     // (i.e. when splitPoint->cpus == 0).
2962     idle_loop(master, splitPoint);
2963
2964     // We have returned from the idle loop, which means that all threads are
2965     // finished. Update alpha, beta and bestValue, and return.
2966     lock_grab(&MPLock);
2967
2968     if (pvNode)
2969         *alpha = splitPoint->alpha;
2970
2971     *beta = splitPoint->beta;
2972     *bestValue = splitPoint->bestValue;
2973     threads[master].stopRequest = false;
2974     threads[master].activeSplitPoints--;
2975     threads[master].splitPoint = splitPoint->parent;
2976
2977     lock_release(&MPLock);
2978     return true;
2979   }
2980
2981
2982   // wake_sleeping_threads() wakes up all sleeping threads when it is time
2983   // to start a new search from the root.
2984
2985   void ThreadsManager::wake_sleeping_threads() {
2986
2987     assert(AllThreadsShouldSleep);
2988     assert(ActiveThreads > 0);
2989
2990     AllThreadsShouldSleep = false;
2991
2992     if (ActiveThreads == 1)
2993         return;
2994
2995     for (int i = 1; i < ActiveThreads; i++)
2996     {
2997         assert(threads[i].state == THREAD_SLEEPING);
2998
2999         threads[i].state = THREAD_AVAILABLE;
3000     }
3001
3002 #if !defined(_MSC_VER)
3003     pthread_mutex_lock(&WaitLock);
3004     pthread_cond_broadcast(&WaitCond);
3005     pthread_mutex_unlock(&WaitLock);
3006 #else
3007     for (int i = 1; i < MAX_THREADS; i++)
3008         SetEvent(SitIdleEvent[i]);
3009 #endif
3010
3011   }
3012
3013
3014   // put_threads_to_sleep() makes all the threads go to sleep just before
3015   // to leave think(), at the end of the search. Threads should have already
3016   // finished the job and should be idle.
3017
3018   void ThreadsManager::put_threads_to_sleep() {
3019
3020     assert(!AllThreadsShouldSleep);
3021
3022     // This makes the threads to go to sleep
3023     AllThreadsShouldSleep = true;
3024
3025     // Wait for the threads to be all sleeping and reset flags
3026     // to a known state.
3027     for (int i = 1; i < ActiveThreads; i++)
3028     {
3029         while (threads[i].state != THREAD_SLEEPING);
3030
3031         // These two flags can be in a random state
3032         threads[i].stopRequest = threads[i].printCurrentLineRequest = false;
3033     }
3034   }
3035
3036   // print_current_line() prints _once_ the current line of search for a
3037   // given thread and then setup the print request for the next thread.
3038   // Called when the UCI option UCI_ShowCurrLine is 'true'.
3039
3040   void ThreadsManager::print_current_line(SearchStack ss[], int ply, int threadID) {
3041
3042     assert(ply >= 0 && ply < PLY_MAX);
3043     assert(threadID >= 0 && threadID < ActiveThreads);
3044
3045     if (!threads[threadID].printCurrentLineRequest)
3046         return;
3047
3048     // One shot only
3049     threads[threadID].printCurrentLineRequest = false;
3050
3051     if (threads[threadID].state == THREAD_SEARCHING)
3052     {
3053         lock_grab(&IOLock);
3054         cout << "info currline " << (threadID + 1);
3055         for (int p = 0; p < ply; p++)
3056             cout << " " << ss[p].currentMove;
3057
3058         cout << endl;
3059         lock_release(&IOLock);
3060     }
3061
3062     // Setup print request for the next thread ID
3063     if (threadID + 1 < ActiveThreads)
3064         threads[threadID + 1].printCurrentLineRequest = true;
3065   }
3066
3067
3068   /// The RootMoveList class
3069
3070   // RootMoveList c'tor
3071
3072   RootMoveList::RootMoveList(Position& pos, Move searchMoves[]) : count(0) {
3073
3074     SearchStack ss[PLY_MAX_PLUS_2];
3075     MoveStack mlist[MaxRootMoves];
3076     StateInfo st;
3077     bool includeAllMoves = (searchMoves[0] == MOVE_NONE);
3078
3079     // Generate all legal moves
3080     MoveStack* last = generate_moves(pos, mlist);
3081
3082     // Add each move to the moves[] array
3083     for (MoveStack* cur = mlist; cur != last; cur++)
3084     {
3085         bool includeMove = includeAllMoves;
3086
3087         for (int k = 0; !includeMove && searchMoves[k] != MOVE_NONE; k++)
3088             includeMove = (searchMoves[k] == cur->move);
3089
3090         if (!includeMove)
3091             continue;
3092
3093         // Find a quick score for the move
3094         init_ss_array(ss);
3095         pos.do_move(cur->move, st);
3096         moves[count].move = cur->move;
3097         moves[count].score = -qsearch(pos, ss, -VALUE_INFINITE, VALUE_INFINITE, Depth(0), 1, 0);
3098         moves[count].pv[0] = cur->move;
3099         moves[count].pv[1] = MOVE_NONE;
3100         pos.undo_move(cur->move);
3101         count++;
3102     }
3103     sort();
3104   }
3105
3106
3107   // RootMoveList simple methods definitions
3108
3109   void RootMoveList::set_move_nodes(int moveNum, int64_t nodes) {
3110
3111     moves[moveNum].nodes = nodes;
3112     moves[moveNum].cumulativeNodes += nodes;
3113   }
3114
3115   void RootMoveList::set_beta_counters(int moveNum, int64_t our, int64_t their) {
3116
3117     moves[moveNum].ourBeta = our;
3118     moves[moveNum].theirBeta = their;
3119   }
3120
3121   void RootMoveList::set_move_pv(int moveNum, const Move pv[]) {
3122
3123     int j;
3124
3125     for (j = 0; pv[j] != MOVE_NONE; j++)
3126         moves[moveNum].pv[j] = pv[j];
3127
3128     moves[moveNum].pv[j] = MOVE_NONE;
3129   }
3130
3131
3132   // RootMoveList::sort() sorts the root move list at the beginning of a new
3133   // iteration.
3134
3135   void RootMoveList::sort() {
3136
3137     sort_multipv(count - 1); // Sort all items
3138   }
3139
3140
3141   // RootMoveList::sort_multipv() sorts the first few moves in the root move
3142   // list by their scores and depths. It is used to order the different PVs
3143   // correctly in MultiPV mode.
3144
3145   void RootMoveList::sort_multipv(int n) {
3146
3147     int i,j;
3148
3149     for (i = 1; i <= n; i++)
3150     {
3151         RootMove rm = moves[i];
3152         for (j = i; j > 0 && moves[j - 1] < rm; j--)
3153             moves[j] = moves[j - 1];
3154
3155         moves[j] = rm;
3156     }
3157   }
3158
3159 } // namspace