Struct AnalysisRequest 

pub struct AnalysisRequest {

    pub id: String,
    pub rules: Rules,
    pub komi: Option<f64>,
    pub white_handicap_bonus: Option<Bonus>,
    pub board_x_size: u8,
    pub board_y_size: u8,
    pub initial_stones: Option<Vec<(Player, String)>>,
    pub initial_player: Option<Player>,
    pub moves: Vec<(Player, String)>,
    pub analyze_turns: Option<Vec<usize>>,
    pub max_visits: Option<u32>,
    pub root_policy_temperature: Option<f64>,
    pub root_fpu_reduction_max: Option<f64>,
    pub analysis_pv_len: Option<usize>,
    pub include_ownership: bool,
    pub include_ownership_stdev: bool,
    pub include_moves_ownership: bool,
    pub include_moves_ownership_stdev: bool,
    pub include_policy: bool,
    pub include_pv_visits: bool,
    pub include_no_result_value: bool,
    pub avoid_moves: Option<Vec<RestrictedMoves>>,
    pub allow_moves: Option<Vec<RestrictedMoves>>,
    pub override_settings: Option<Config>,
    pub report_during_search_every: Option<f64>,
    pub priority: Option<i32>,
    pub priorities: Option<Vec<i32>>,
}

A game record to be analyzed, along with analysis settings.

Fields

id: String

The request ID.

rules: Rules

The ruleset for this game.

komi: Option<f64>

The komi for this game.

white_handicap_bonus: Option<Bonus>

Bonus points white receives in handicap games.

board_x_size: u8

The board width.

board_y_size: u8

The board height.

initial_stones: Option<Vec<(Player, String)>>

The stones on the board before the first move.

initial_player: Option<Player>

The player to move in the initial position.

moves: Vec<(Player, String)>

The moves played in the game. Move locations can be in GTP format ("A1", "pass", etc.) or explicit coordinates ("(0,0)").

analyze_turns: Option<Vec<usize>>

The positions to analyze, where 0 is the position before the first move. If not provided, only the final position will be analyzed. The engine will return a separate response for each position.

max_visits: Option<u32>

The maximum number of visits to use.

root_policy_temperature: Option<f64>

Root policy temperature.

root_fpu_reduction_max: Option<f64>

Root FPU reduction max.

analysis_pv_len: Option<usize>

The maximum length of the principal variation to return, not including the first move.

include_ownership: bool

Whether to return the ownership prediction.

include_ownership_stdev: bool

Whether to return the standard deviation of the ownership prediction.

include_moves_ownership: bool

Whether to return the ownership prediction for each move.

include_moves_ownership_stdev: bool

Whether to return the standard deviation of the ownership prediction for each move.

include_policy: bool

Whether to return the neural network policy output.

include_pv_visits: bool

Whether to return the number of visits for each position in the principal variation.

include_no_result_value: bool

Whether to return the predicted probability that the game will have a void result.

avoid_moves: Option<Vec<RestrictedMoves>>

Moves which are forbidden.

allow_moves: Option<Vec<RestrictedMoves>>

Moves which are allowed. If specified, all other moves are forbidden.

override_settings: Option<Config>

Config overrides for this request.

report_during_search_every: Option<f64>

Report partial analysis results every this many seconds.

priority: Option<i32>

The priority of this request.

priorities: Option<Vec<i32>>

The priorities of each position to analyze.

Implementations

impl AnalysisRequest

pub fn new( id: String, rules: Rules, board_x_size: u8, board_y_size: u8, moves: Vec<(Player, String)>, ) -> Self

Creates a new analysis request with the minimum required parameters.

pub fn with_komi(self, komi: f64) -> Self

Sets komi.

pub fn with_white_handicap_bonus(self, bonus: Bonus) -> Self

Sets white’s handicap bonus.

pub fn with_initial_stones(self, initial_stones: Vec<(Player, String)>) -> Self

Sets the initial position before the first move.

pub fn with_initial_player(self, initial_player: Player) -> Self

Sets the player to move in the initial position.

pub fn with_analyze_turns(self, analyze_turns: Vec<usize>) -> Self

Analyzes the specified positions. The position before the first move is turn 0.

pub fn with_max_visits(self, max_visits: u32) -> Self

Sets the maximum number of visits to use.

pub fn with_root_policy_temperature(self, root_policy_temperature: f64) -> Self

Sets the root policy temperature.

pub fn with_root_fpu_reduction_max(self, root_fpu_reduction_max: f64) -> Self

Sets the root FPU reduction max.

pub fn with_analysis_pv_len(self, analysis_pv_len: usize) -> Self

Sets the maximum length of the principal variation to return, not including the first move.

pub fn with_ownership(self) -> Self

Includes the ownership prediction.

pub fn with_ownership_stdev(self) -> Self

Includes the standard deviation of the ownership prediction.

pub fn with_moves_ownership(self) -> Self

Includes the ownership prediction for each move.

pub fn with_moves_ownership_stdev(self) -> Self

Includes the standard deviation of the ownership prediction for each move.

pub fn with_policy(self) -> Self

Includes the neural network policy output.

pub fn with_pv_visits(self) -> Self

Includes the number of visits for each position in the principal variation.

pub fn with_no_result_value(self) -> Self

Includes the predicted probability that the game will have a void result.

pub fn with_avoid_moves(self, avoid_moves: Vec<RestrictedMoves>) -> Self

Sets moves which are forbidden.

pub fn with_allow_moves(self, allow_moves: Vec<RestrictedMoves>) -> Self

Sets moves which are allowed.

pub fn with_override_settings(self, config: Config) -> Self

Overrides config settings for this request.

pub fn with_report_during_search_every(self, seconds: f64) -> Self

Gets partial analysis results every this many seconds.

pub fn with_priority(self, priority: i32) -> Self

Sets the priority of this request.

pub fn with_priorities(self, priorities: Vec<i32>) -> Self

Sets the priorities of each position to analyze.

Trait Implementations

impl Clone for AnalysisRequest

fn clone(&self) -> AnalysisRequest

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for AnalysisRequest

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Serialize for AnalysisRequest

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.