<commit_before>#ifndef EVAL_H
#define EVAL_H

#include "board.h"
#include "defs.h"

/**
 * @brief Represents the evaluation of a chess board at a given position for a given color.
 */
class Eval {
public:

  /**
   * @brief Evaluate the given board for the given color.
   */
  Eval(const Board&, Color);

  /**
   * @brief Get a score representing the favourability of the position for the color with which
   * this Eval was constructed.
   *
   * @return A favourability score for the board and color.
   */
  int getScore();

private:
  /**
   * @name Piece material value constants.
   *
   * @{
   */
  static const int PAWN_VALUE = 100;
  static const int KNIGHT_VALUE = 320;
  static const int BISHOP_VALUE = 330;
  static const int ROOK_VALUE = 500;
  static const int QUEEN_VALUE = 900;
  /**@}*/

  /**
   * @brief Mobility weight factored into an evaluation score.
   */
  static const int MOBILITY_WEIGHT = 1;

  int _score;
  /**
   * @brief Evaluate the given board for the given color and update this Evaluation's state appropriately
   */
  void _doEval(const Board&, Color);

  /**
   * @brief Returns an estimate for the number of legal moves for the given color on the given board.
   *
   * @param board The board to estimate the number of moves for
   * @param color The color to estimate the number of moves for
   * @return An estimate for the number of moves for the given color on the given board.
   */
  int _calcMobility(const Board&, Color);
};<commit_msg>Improve consistency of documentation in eval.h<commit_after>#ifndef EVAL_H
#define EVAL_H

#include "board.h"
#include "defs.h"

/**
 * @brief Represents the evaluation of a chess board at a given position for a given color.
 */
class Eval {
public:

  /**
   * @brief Constructs a new Eval for the given board for the given color.
   */
  Eval(const Board&, Color);

  /**
   * @brief Gets a score representing the favourability of the position for the color with which
   * this Eval was constructed.
   *
   * The returned score is relative to the opposite player. For example, if
   * black's total score is 980 and white's score is 900, this method will
   * return 80 if black is the color to be evaluated and -80 if white is the
   * color to be evaluated.
   *
   * @return A favourability score for the board and color.
   */
  int getScore();

private:
  /**
   * @name Piece material value constants.
   *
   * @{
   */
  static const int PAWN_VALUE = 100;
  static const int KNIGHT_VALUE = 320;
  static const int BISHOP_VALUE = 330;
  static const int ROOK_VALUE = 500;
  static const int QUEEN_VALUE = 900;
  /**@}*/

  /**
   * @brief Mobility weight factored into an evaluation score.
   */
  static const int MOBILITY_WEIGHT = 1;

  int _score;
  /**
   * @brief Evaluates the given board for the given color and updates this evaluation's state appropriately.
   */
  void _doEval(const Board&, Color);

  /**
   * @brief Returns an estimate for the number of legal moves for the given color on the given board.
   *
   *
   * @param board The board to estimate the number of moves for
   * @param color The color to estimate the number of moves for
   * @return An estimate for the number of moves for the given color on the given board.
   */
  int _calcMobility(const Board&, Color);
};
{'fraction_non_alphanumeric': 0.08292831105710814, 'fraction_numerical': 0.01275820170109356, 'mean_word_length': 3.015853658536585, 'pattern_counts': {'":': 0, '<': 3, '<?xml version=': 0, '>': 3, 'https://': 0, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '700944', 'n_tokens_mistral': 1028, 'n_tokens_neox': 962, 'n_words': 442}