43c361239844584c42fa770855a5d10b18619347
[stockfish] / src / evaluate.h
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 #if !defined(EVALUATE_H_INCLUDED)
22 #define EVALUATE_H_INCLUDED
23
24 ////
25 //// Includes
26 ////
27
28 #include <iostream>
29
30 #include "material.h"
31 #include "pawns.h"
32
33
34 ////
35 //// Types
36 ////
37
38
39 /// The EvalInfo struct contains various information computed and collected
40 /// by the evaluation function. An EvalInfo object is passed as one of the
41 /// arguments to the evaluation function, and the search can make use of its
42 /// contents to make intelligent search decisions.
43 ///
44 /// At the moment, this is not utilized very much: The only part of the
45 /// EvalInfo object which is used by the search is futilityMargin.
46 class Position;
47
48 struct EvalInfo {
49
50   // Middle game and endgame evaluations
51   Score value;
52
53   // Pointers to material and pawn hash table entries
54   MaterialInfo* mi;
55   PawnInfo* pi;
56
57   // attackedBy[color][piece type] is a bitboard representing all squares
58   // attacked by a given color and piece type, attackedBy[color][0] contains
59   // all squares attacked by the given color.
60   Bitboard attackedBy[2][8];
61   Bitboard attacked_by(Color c) const { return attackedBy[c][0]; }
62   Bitboard attacked_by(Color c, PieceType pt) const { return attackedBy[c][pt]; }
63
64   // kingZone[color] is the zone around the enemy king which is considered
65   // by the king safety evaluation. This consists of the squares directly
66   // adjacent to the king, and the three (or two, for a king on an edge file)
67   // squares two ranks in front of the king. For instance, if black's king
68   // is on g8, kingZone[WHITE] is a bitboard containing the squares f8, h8,
69   // f7, g7, h7, f6, g6 and h6.
70   Bitboard kingZone[2];
71
72   // kingAttackersCount[color] is the number of pieces of the given color
73   // which attack a square in the kingZone of the enemy king.
74   int kingAttackersCount[2];
75
76   // kingAttackersWeight[color] is the sum of the "weight" of the pieces of the
77   // given color which attack a square in the kingZone of the enemy king. The
78   // weights of the individual piece types are given by the variables
79   // QueenAttackWeight, RookAttackWeight, BishopAttackWeight and
80   // KnightAttackWeight in evaluate.cpp
81   int kingAttackersWeight[2];
82
83   // kingAdjacentZoneAttacksCount[color] is the number of attacks to squares
84   // directly adjacent to the king of the given color. Pieces which attack
85   // more than one square are counted multiple times. For instance, if black's
86   // king is on g8 and there's a white knight on g5, this knight adds
87   // 2 to kingAdjacentZoneAttacksCount[BLACK].
88   int kingAdjacentZoneAttacksCount[2];
89
90   // mateThreat[color] is a move for the given side which gives a direct mate.
91   Move mateThreat[2];
92
93   // Middle game and endgame mobility scores.
94   Score mobility;
95
96   // Extra futility margin. This is added to the standard futility margin
97   // in the quiescence search.
98   Value futilityMargin;
99 };
100
101
102 ////
103 //// Prototypes
104 ////
105
106 extern Value evaluate(const Position& pos, EvalInfo& ei, int threadID);
107 extern void init_eval(int threads);
108 extern void quit_eval();
109 extern void read_weights(Color sideToMove);
110
111
112 #endif // !defined(EVALUATE_H_INCLUDED)