/*
Stockfish, a UCI chess playing engine derived from Glaurung 2.1
- Copyright (C) 2004-2008 Tord Romstad (Glaurung author)
- Copyright (C) 2008-2010 Marco Costalba, Joona Kiiski, Tord Romstad
+ Copyright (C) 2004-2021 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
along with this program. If not, see <http://www.gnu.org/licenses/>.
*/
-
-////
-//// Includes
-////
-
#include <cassert>
+#include <cmath>
#include <iostream>
#include <sstream>
#include <string>
#include "evaluate.h"
-#include "misc.h"
-#include "move.h"
#include "movegen.h"
#include "position.h"
-#include "san.h"
#include "search.h"
-#include "ucioption.h"
+#include "thread.h"
+#include "timeman.h"
+#include "tt.h"
+#include "uci.h"
+#include "syzygy/tbprobe.h"
using namespace std;
+namespace Stockfish {
+
+extern vector<string> setup_bench(const Position&, istream&);
namespace {
- // FEN string for the initial position
- const string StartPositionFEN = "rnbqkbnr/pppppppp/8/8/8/8/PPPPPPPP/RNBQKBNR w KQkq - 0 1";
+ // FEN string of the initial position, normal chess
+ const char* StartFEN = "rnbqkbnr/pppppppp/8/8/8/8/PPPPPPPP/RNBQKBNR w KQkq - 0 1";
- // UCIParser is a class for parsing UCI input. The class
- // is actually a string stream built on a given input string.
- typedef istringstream UCIParser;
- // Local functions
- void set_option(UCIParser& up);
- void set_position(Position& pos, UCIParser& up);
- bool go(Position& pos, UCIParser& up);
- void perft(Position& pos, UCIParser& up);
-}
+ // position() is called when engine receives the "position" UCI command.
+ // The function sets up the position described in the given FEN string ("fen")
+ // or the starting position ("startpos") and then makes the moves given in the
+ // following move list ("moves").
+
+ void position(Position& pos, istringstream& is, StateListPtr& states) {
+ Move m;
+ string token, fen;
+
+ is >> token;
+
+ if (token == "startpos")
+ {
+ fen = StartFEN;
+ is >> token; // Consume "moves" token if any
+ }
+ else if (token == "fen")
+ while (is >> token && token != "moves")
+ fen += token + " ";
+ else
+ return;
-/// execute_uci_command() takes a string as input, uses a UCIParser
-/// object to parse this text string as a UCI command, and calls
-/// the appropriate functions. In addition to the UCI commands,
-/// the function also supports a few debug commands.
+ states = StateListPtr(new std::deque<StateInfo>(1)); // Drop old and create a new one
+ pos.set(fen, Options["UCI_Chess960"], &states->back(), Threads.main());
-bool execute_uci_command(const string& cmd) {
+ // Parse move list (if any)
+ while (is >> token && (m = UCI::to_move(pos, token)) != MOVE_NONE)
+ {
+ states->emplace_back();
+ pos.do_move(m, states->back());
+ }
+ }
- static Position pos(StartPositionFEN, false, 0); // The root position
- UCIParser up(cmd);
- string token;
+ // trace_eval() prints the evaluation for the current position, consistent with the UCI
+ // options set so far.
- if (!(up >> token)) // operator>>() skips any whitespace
- return true;
+ void trace_eval(Position& pos) {
- if (token == "quit")
- return false;
+ StateListPtr states(new std::deque<StateInfo>(1));
+ Position p;
+ p.set(pos.fen(), Options["UCI_Chess960"], &states->back(), Threads.main());
- if (token == "go")
- return go(pos, up);
+ Eval::NNUE::verify();
- if (token == "uci")
- {
- cout << "id name " << engine_name()
- << "\nid author Tord Romstad, Marco Costalba, Joona Kiiski\n";
- print_uci_options();
- cout << "uciok" << endl;
+ sync_cout << "\n" << Eval::trace(p) << sync_endl;
}
- else if (token == "ucinewgame")
- pos.from_fen(StartPositionFEN, false);
- else if (token == "isready")
- cout << "readyok" << endl;
- else if (token == "position")
- set_position(pos, up);
+ // setoption() is called when engine receives the "setoption" UCI command. The
+ // function updates the UCI option ("name") to the given value ("value").
- else if (token == "setoption")
- set_option(up);
+ void setoption(istringstream& is) {
- // The remaining commands are for debugging purposes only
- else if (token == "d")
- pos.print();
+ string token, name, value;
- else if (token == "flip")
- {
- Position p(pos, pos.thread());
- pos.flipped_copy(p);
- }
- else if (token == "eval")
- {
- Value evalMargin;
- cout << "Incremental mg: " << mg_value(pos.value())
- << "\nIncremental eg: " << eg_value(pos.value())
- << "\nFull eval: " << evaluate(pos, evalMargin) << endl;
- }
- else if (token == "key")
- cout << "key: " << hex << pos.get_key()
- << "\nmaterial key: " << pos.get_material_key()
- << "\npawn key: " << pos.get_pawn_key() << endl;
+ is >> token; // Consume "name" token
- else if (token == "perft")
- perft(pos, up);
+ // Read option name (can contain spaces)
+ while (is >> token && token != "value")
+ name += (name.empty() ? "" : " ") + token;
- else
- cout << "Unknown command: " << cmd << endl;
+ // Read option value (can contain spaces)
+ while (is >> token)
+ value += (value.empty() ? "" : " ") + token;
- return true;
-}
+ if (Options.count(name))
+ Options[name] = value;
+ else
+ sync_cout << "No such option: " << name << sync_endl;
+ }
-////
-//// Local functions
-////
+ // go() is called when engine receives the "go" UCI command. The function sets
+ // the thinking time and other parameters from the input string, then starts
+ // the search.
-namespace {
+ void go(Position& pos, istringstream& is, StateListPtr& states) {
- // set_position() is called when Stockfish receives the "position" UCI
- // command. The input parameter is a UCIParser. It is assumed
- // that this parser has consumed the first token of the UCI command
- // ("position"), and is ready to read the second token ("startpos"
- // or "fen", if the input is well-formed).
+ Search::LimitsType limits;
+ string token;
+ bool ponderMode = false;
+
+ limits.startTime = now(); // As early as possible!
+
+ while (is >> token)
+ if (token == "searchmoves") // Needs to be the last command on the line
+ while (is >> token)
+ limits.searchmoves.push_back(UCI::to_move(pos, token));
+
+ else if (token == "wtime") is >> limits.time[WHITE];
+ else if (token == "btime") is >> limits.time[BLACK];
+ else if (token == "winc") is >> limits.inc[WHITE];
+ else if (token == "binc") is >> limits.inc[BLACK];
+ else if (token == "movestogo") is >> limits.movestogo;
+ else if (token == "depth") is >> limits.depth;
+ else if (token == "nodes") is >> limits.nodes;
+ else if (token == "movetime") is >> limits.movetime;
+ else if (token == "mate") is >> limits.mate;
+ else if (token == "perft") is >> limits.perft;
+ else if (token == "infinite") limits.infinite = 1;
+ else if (token == "ponder") ponderMode = true;
+
+ Threads.start_thinking(pos, states, limits, ponderMode);
+ }
- void set_position(Position& pos, UCIParser& up) {
+
+ // bench() is called when engine receives the "bench" command. Firstly
+ // a list of UCI commands is setup according to bench parameters, then
+ // it is run one by one printing a summary at the end.
+
+ void bench(Position& pos, istream& args, StateListPtr& states) {
string token;
+ uint64_t num, nodes = 0, cnt = 1;
- if (!(up >> token) || (token != "startpos" && token != "fen"))
- return;
+ vector<string> list = setup_bench(pos, args);
+ num = count_if(list.begin(), list.end(), [](string s) { return s.find("go ") == 0 || s.find("eval") == 0; });
- if (token == "startpos")
- {
- pos.from_fen(StartPositionFEN, false);
- if (!(up >> token))
- return;
- }
- else // fen
+ TimePoint elapsed = now();
+
+ for (const auto& cmd : list)
{
- string fen;
- while (up >> token && token != "moves")
+ istringstream is(cmd);
+ is >> skipws >> token;
+
+ if (token == "go" || token == "eval")
{
- fen += token;
- fen += ' ';
+ cerr << "\nPosition: " << cnt++ << '/' << num << " (" << pos.fen() << ")" << endl;
+ if (token == "go")
+ {
+ go(pos, is, states);
+ Threads.main()->wait_for_search_finished();
+ nodes += Threads.nodes_searched();
+ }
+ else
+ trace_eval(pos);
}
- pos.from_fen(fen, Options["UCI_Chess960"].value<bool>());
+ else if (token == "setoption") setoption(is);
+ else if (token == "position") position(pos, is, states);
+ else if (token == "ucinewgame") { Search::clear(); elapsed = now(); } // Search::clear() may take some while
}
- if (token != "moves")
- return;
+ elapsed = now() - elapsed + 1; // Ensure positivity to avoid a 'divide by zero'
- // Parse optional move list
- Move move;
- StateInfo st;
- while (up >> token)
- {
- move = move_from_uci(pos, token);
- pos.do_setup_move(move, st);
- }
- // Our StateInfo st is about going out of scope so copy
- // its content inside pos before it disappears.
- pos.detach();
+ dbg_print(); // Just before exiting
+
+ cerr << "\n==========================="
+ << "\nTotal time (ms) : " << elapsed
+ << "\nNodes searched : " << nodes
+ << "\nNodes/second : " << 1000 * nodes / elapsed << endl;
}
+ // The win rate model returns the probability (per mille) of winning given an eval
+ // and a game-ply. The model fits rather accurately the LTC fishtest statistics.
+ int win_rate_model(Value v, int ply) {
- // set_option() is called when Stockfish receives the "setoption" UCI
- // command. The input parameter is a UCIParser. It is assumed
- // that this parser has consumed the first token of the UCI command
- // ("setoption"), and is ready to read the second token ("name", if
- // the input is well-formed).
+ // The model captures only up to 240 plies, so limit input (and rescale)
+ double m = std::min(240, ply) / 64.0;
- void set_option(UCIParser& up) {
+ // Coefficients of a 3rd order polynomial fit based on fishtest data
+ // for two parameters needed to transform eval to the argument of a
+ // logistic function.
+ double as[] = {-8.24404295, 64.23892342, -95.73056462, 153.86478679};
+ double bs[] = {-3.37154371, 28.44489198, -56.67657741, 72.05858751};
+ double a = (((as[0] * m + as[1]) * m + as[2]) * m) + as[3];
+ double b = (((bs[0] * m + bs[1]) * m + bs[2]) * m) + bs[3];
- string token, name, value;
+ // Transform eval to centipawns with limited range
+ double x = std::clamp(double(100 * v) / PawnValueEg, -1000.0, 1000.0);
- if (!(up >> token) || token != "name") // operator>>() skips any whitespace
- return;
+ // Return win rate in per mille (rounded to nearest)
+ return int(0.5 + 1000 / (1 + std::exp((a - x) / b)));
+ }
- if (!(up >> name))
- return;
+} // namespace
+
+
+/// UCI::loop() waits for a command from stdin, parses it and calls the appropriate
+/// function. Also intercepts EOF from stdin to ensure gracefully exiting if the
+/// GUI dies unexpectedly. When called with some command line arguments, e.g. to
+/// run 'bench', once the command is executed the function returns immediately.
+/// In addition to the UCI ones, also some additional debug commands are supported.
+
+void UCI::loop(int argc, char* argv[]) {
+
+ Position pos;
+ string token, cmd;
+ StateListPtr states(new std::deque<StateInfo>(1));
+
+ pos.set(StartFEN, false, &states->back(), Threads.main());
+
+ for (int i = 1; i < argc; ++i)
+ cmd += std::string(argv[i]) + " ";
+
+ do {
+ if (argc == 1 && !getline(cin, cmd)) // Block here waiting for input or EOF
+ cmd = "quit";
+
+ istringstream is(cmd);
+
+ token.clear(); // Avoid a stale if getline() returns empty or blank line
+ is >> skipws >> token;
+
+ if ( token == "quit"
+ || token == "stop")
+ Threads.stop = true;
+
+ // The GUI sends 'ponderhit' to tell us the user has played the expected move.
+ // So 'ponderhit' will be sent if we were told to ponder on the same move the
+ // user has played. We should continue searching but switch from pondering to
+ // normal search.
+ else if (token == "ponderhit")
+ Threads.main()->ponder = false; // Switch to normal search
+
+ else if (token == "uci")
+ sync_cout << "id name " << engine_info(true)
+ << "\n" << Options
+ << "\nuciok" << sync_endl;
+
+ else if (token == "setoption") setoption(is);
+ else if (token == "go") go(pos, is, states);
+ else if (token == "position") position(pos, is, states);
+ else if (token == "ucinewgame") Search::clear();
+ else if (token == "isready") sync_cout << "readyok" << sync_endl;
+
+ // Additional custom non-UCI commands, mainly for debugging.
+ // Do not use these commands during a search!
+ else if (token == "flip") pos.flip();
+ else if (token == "bench") bench(pos, is, states);
+ else if (token == "d") sync_cout << pos << sync_endl;
+ else if (token == "eval") trace_eval(pos);
+ else if (token == "compiler") sync_cout << compiler_info() << sync_endl;
+ else if (token == "export_net") {
+ std::optional<std::string> filename;
+ std::string f;
+ if (is >> skipws >> f) {
+ filename = f;
+ }
+ Eval::NNUE::export_net(filename);
+ }
+ else if (!token.empty() && token[0] != '#')
+ sync_cout << "Unknown command: " << cmd << sync_endl;
+
+ } while (token != "quit" && argc == 1); // Command line args are one-shot
+}
- // Handle names with included spaces
- while (up >> token && token != "value")
- name += (" " + token);
- if (Options.find(name) == Options.end())
- {
- cout << "No such option: " << name << endl;
- return;
- }
+/// UCI::value() converts a Value to a string suitable for use with the UCI
+/// protocol specification:
+///
+/// cp <x> The score from the engine's point of view in centipawns.
+/// mate <y> Mate in y moves, not plies. If the engine is getting mated
+/// use negative values for y.
- // Is a button ?
- if (token != "value")
- {
- Options[name].set_value("true");
- return;
- }
+string UCI::value(Value v) {
- if (!(up >> value))
- return;
+ assert(-VALUE_INFINITE < v && v < VALUE_INFINITE);
- // Handle values with included spaces
- while (up >> token)
- value += (" " + token);
+ stringstream ss;
- Options[name].set_value(value);
- }
+ if (abs(v) < VALUE_MATE_IN_MAX_PLY)
+ ss << "cp " << v * 100 / PawnValueEg;
+ else
+ ss << "mate " << (v > 0 ? VALUE_MATE - v + 1 : -VALUE_MATE - v) / 2;
+ return ss.str();
+}
- // go() is called when Stockfish receives the "go" UCI command. The
- // input parameter is a UCIParser. It is assumed that this
- // parser has consumed the first token of the UCI command ("go"),
- // and is ready to read the second token. The function sets the
- // thinking time and other parameters from the input string, and
- // calls think() (defined in search.cpp) with the appropriate
- // parameters. Returns false if a quit command is received while
- // thinking, returns true otherwise.
- bool go(Position& pos, UCIParser& up) {
+/// UCI::wdl() report WDL statistics given an evaluation and a game ply, based on
+/// data gathered for fishtest LTC games.
- string token;
+string UCI::wdl(Value v, int ply) {
- int time[2] = {0, 0}, inc[2] = {0, 0};
- int movesToGo = 0, depth = 0, nodes = 0, moveTime = 0;
- bool infinite = false, ponder = false;
- Move searchMoves[MOVES_MAX];
+ stringstream ss;
- searchMoves[0] = MOVE_NONE;
+ int wdl_w = win_rate_model( v, ply);
+ int wdl_l = win_rate_model(-v, ply);
+ int wdl_d = 1000 - wdl_w - wdl_l;
+ ss << " wdl " << wdl_w << " " << wdl_d << " " << wdl_l;
- while (up >> token)
- {
- if (token == "infinite")
- infinite = true;
- else if (token == "ponder")
- ponder = true;
- else if (token == "wtime")
- up >> time[0];
- else if (token == "btime")
- up >> time[1];
- else if (token == "winc")
- up >> inc[0];
- else if (token == "binc")
- up >> inc[1];
- else if (token == "movestogo")
- up >> movesToGo;
- else if (token == "depth")
- up >> depth;
- else if (token == "nodes")
- up >> nodes;
- else if (token == "movetime")
- up >> moveTime;
- else if (token == "searchmoves")
- {
- int numOfMoves = 0;
- while (up >> token)
- searchMoves[numOfMoves++] = move_from_uci(pos, token);
+ return ss.str();
+}
- searchMoves[numOfMoves] = MOVE_NONE;
- }
- }
- assert(pos.is_ok());
+/// UCI::square() converts a Square to a string in algebraic notation (g1, a7, etc.)
- return think(pos, infinite, ponder, time, inc, movesToGo,
- depth, nodes, moveTime, searchMoves);
- }
+std::string UCI::square(Square s) {
+ return std::string{ char('a' + file_of(s)), char('1' + rank_of(s)) };
+}
- void perft(Position& pos, UCIParser& up) {
- int depth, tm;
- int64_t n;
+/// UCI::move() converts a Move to a string in coordinate notation (g1f3, a7a8q).
+/// The only special case is castling, where we print in the e1g1 notation in
+/// normal chess mode, and in e1h1 notation in chess960 mode. Internally all
+/// castling moves are always encoded as 'king captures rook'.
- if (!(up >> depth))
- return;
+string UCI::move(Move m, bool chess960) {
- tm = get_system_time();
+ Square from = from_sq(m);
+ Square to = to_sq(m);
- n = perft(pos, depth * ONE_PLY);
+ if (m == MOVE_NONE)
+ return "(none)";
- tm = get_system_time() - tm;
- std::cout << "\nNodes " << n
- << "\nTime (ms) " << tm
- << "\nNodes/second " << int(n / (tm / 1000.0)) << std::endl;
- }
+ if (m == MOVE_NULL)
+ return "0000";
+
+ if (type_of(m) == CASTLING && !chess960)
+ to = make_square(to > from ? FILE_G : FILE_C, rank_of(from));
+
+ string move = UCI::square(from) + UCI::square(to);
+
+ if (type_of(m) == PROMOTION)
+ move += " pnbrqk"[promotion_type(m)];
+
+ return move;
}
+
+
+/// UCI::to_move() converts a string representing a move in coordinate notation
+/// (g1f3, a7a8q) to the corresponding legal Move, if any.
+
+Move UCI::to_move(const Position& pos, string& str) {
+
+ if (str.length() == 5) // Junior could send promotion piece in uppercase
+ str[4] = char(tolower(str[4]));
+
+ for (const auto& m : MoveList<LEGAL>(pos))
+ if (str == UCI::move(m, pos.is_chess960()))
+ return m;
+
+ return MOVE_NONE;
+}
+
+} // namespace Stockfish