/* Stockfish, a UCI chess playing engine derived from Glaurung 2.1 Copyright (C) 2004-2026 The Stockfish developers (see AUTHORS file) Stockfish is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. Stockfish is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program. If not, see . */ #include "movepick.h" #include #include #include #include "bitboard.h" #include "misc.h" #include "position.h" namespace Stockfish { namespace { enum Stages { // generate main search moves MAIN_TT, CAPTURE_INIT, GOOD_CAPTURE, QUIET_INIT, GOOD_QUIET, BAD_CAPTURE, BAD_QUIET, // generate evasion moves EVASION_TT, EVASION_INIT, EVASION, // generate probcut moves PROBCUT_TT, PROBCUT_INIT, PROBCUT, // generate qsearch moves QSEARCH_TT, QCAPTURE_INIT, QCAPTURE }; // Sort moves in descending order up to and including a given limit. // The order of moves smaller than the limit is left unspecified. void partial_insertion_sort(ExtMove* begin, ExtMove* end, int limit) { for (ExtMove *sortedEnd = begin, *p = begin + 1; p < end; ++p) if (p->value >= limit) { ExtMove tmp = *p, *q; *p = *++sortedEnd; for (q = sortedEnd; q != begin && *(q - 1) < tmp; --q) *q = *(q - 1); *q = tmp; } } } // namespace // Constructors of the MovePicker class. As arguments, we pass information // to decide which class of moves to emit, to help sorting the (presumably) // good moves first, and how important move ordering is at the current node. // MovePicker constructor for the main search and for the quiescence search MovePicker::MovePicker(const Position& p, Move ttm, Depth d, const ButterflyHistory* mh, const LowPlyHistory* lph, const CapturePieceToHistory* cph, const PieceToHistory** ch, const SharedHistories* sh, int pl) : pos(p), mainHistory(mh), lowPlyHistory(lph), captureHistory(cph), continuationHistory(ch), sharedHistory(sh), ttMove(ttm), depth(d), ply(pl) { if (pos.checkers()) stage = EVASION_TT + !(ttm && pos.pseudo_legal(ttm)); else stage = (depth > 0 ? MAIN_TT : QSEARCH_TT) + !(ttm && pos.pseudo_legal(ttm)); } // MovePicker constructor for ProbCut: we generate captures with Static Exchange // Evaluation (SEE) greater than or equal to the given threshold. MovePicker::MovePicker(const Position& p, Move ttm, int th, const CapturePieceToHistory* cph) : pos(p), captureHistory(cph), ttMove(ttm), threshold(th) { assert(!pos.checkers()); stage = PROBCUT_TT + !(ttm && pos.capture_stage(ttm) && pos.pseudo_legal(ttm)); } // Assigns a numerical value to each move in a list, used for sorting. // Captures are ordered by Most Valuable Victim (MVV), preferring captures // with a good history. Quiets moves are ordered using the history tables. template ExtMove* MovePicker::score(MoveList& ml) { static_assert(Type == CAPTURES || Type == QUIETS || Type == EVASIONS, "Wrong type"); Color us = pos.side_to_move(); [[maybe_unused]] Bitboard threatByLesser[KING + 1]; if constexpr (Type == QUIETS) { threatByLesser[PAWN] = 0; threatByLesser[KNIGHT] = threatByLesser[BISHOP] = pos.attacks_by(~us); threatByLesser[ROOK] = pos.attacks_by(~us) | pos.attacks_by(~us) | threatByLesser[KNIGHT]; threatByLesser[QUEEN] = pos.attacks_by(~us) | threatByLesser[ROOK]; threatByLesser[KING] = 0; } ExtMove* it = cur; for (auto move : ml) { ExtMove& m = *it++; m = move; const Square from = m.from_sq(); const Square to = m.to_sq(); const Piece pc = pos.moved_piece(m); const PieceType pt = type_of(pc); const Piece capturedPiece = pos.piece_on(to); if constexpr (Type == CAPTURES) m.value = (*captureHistory)[pc][to][type_of(capturedPiece)] + 7 * int(PieceValue[capturedPiece]); else if constexpr (Type == QUIETS) { // histories m.value = 2 * (*mainHistory)[us][m.raw()]; m.value += 2 * sharedHistory->pawn_entry(pos)[pc][to]; m.value += (*continuationHistory[0])[pc][to]; m.value += (*continuationHistory[1])[pc][to]; m.value += (*continuationHistory[2])[pc][to]; m.value += (*continuationHistory[3])[pc][to]; m.value += (*continuationHistory[5])[pc][to]; // bonus for checks m.value += (bool(pos.check_squares(pt) & to) && pos.see_ge(m, -75)) * 16384; // penalty for moving to a square threatened by a lesser piece // or bonus for escaping an attack by a lesser piece. int v = 20 * (bool(threatByLesser[pt] & from) - bool(threatByLesser[pt] & to)); m.value += PieceValue[pt] * v; if (ply < LOW_PLY_HISTORY_SIZE) m.value += 8 * (*lowPlyHistory)[ply][m.raw()] / (1 + ply); } else // Type == EVASIONS { if (pos.capture_stage(m)) m.value = PieceValue[capturedPiece] + (1 << 28); else m.value = (*mainHistory)[us][m.raw()] + (*continuationHistory[0])[pc][to]; } } return it; } // Returns the next move satisfying a predicate function. // This never returns the TT move, as it was emitted before. template Move MovePicker::select(Pred filter) { for (; cur < endCur; ++cur) if (*cur != ttMove && filter()) return *cur++; return Move::none(); } // This is the most important method of the MovePicker class. We emit one // new pseudo-legal move on every call until there are no more moves left, // picking the move with the highest score from a list of generated moves. Move MovePicker::next_move() { constexpr int goodQuietThreshold = -14000; top: switch (stage) { case MAIN_TT : case EVASION_TT : case QSEARCH_TT : case PROBCUT_TT : ++stage; return ttMove; case CAPTURE_INIT : case PROBCUT_INIT : case QCAPTURE_INIT : { MoveList ml(pos); cur = endBadCaptures = moves; endCur = endCaptures = score(ml); partial_insertion_sort(cur, endCur, std::numeric_limits::min()); ++stage; goto top; } case GOOD_CAPTURE : if (select([&]() { if (pos.see_ge(*cur, -cur->value / 18)) return true; std::swap(*endBadCaptures++, *cur); return false; })) return *(cur - 1); ++stage; [[fallthrough]]; case QUIET_INIT : if (!skipQuiets) { MoveList ml(pos); endCur = endGenerated = score(ml); partial_insertion_sort(cur, endCur, -3560 * depth); } ++stage; [[fallthrough]]; case GOOD_QUIET : if (!skipQuiets && select([&]() { return cur->value > goodQuietThreshold; })) return *(cur - 1); // Prepare the pointers to loop over the bad captures cur = moves; endCur = endBadCaptures; ++stage; [[fallthrough]]; case BAD_CAPTURE : if (select([]() { return true; })) return *(cur - 1); // Prepare the pointers to loop over quiets again cur = endCaptures; endCur = endGenerated; ++stage; [[fallthrough]]; case BAD_QUIET : if (!skipQuiets) return select([&]() { return cur->value <= goodQuietThreshold; }); return Move::none(); case EVASION_INIT : { MoveList ml(pos); cur = moves; endCur = endGenerated = score(ml); partial_insertion_sort(cur, endCur, std::numeric_limits::min()); ++stage; [[fallthrough]]; } case EVASION : case QCAPTURE : return select([]() { return true; }); case PROBCUT : return select([&]() { return pos.see_ge(*cur, threshold); }); } assert(false); return Move::none(); // Silence warning } void MovePicker::skip_quiet_moves() { skipQuiets = true; } } // namespace Stockfish