#include <recruitment.hpp>

Inheritance diagram for ai::default_recruitment::recruitment:

Classes
class	recruit_situation_change_observer

Public Member Functions
	recruitment (rca_context &context, const config &cfg)

virtual	~recruitment ()

virtual double	evaluate ()
	Evaluate the candidate action, resetting the internal state of the action. More...

virtual void	execute ()
	Execute the candidate action. More...

config	to_config () const
	serialize More...

Public Member Functions inherited from ai::candidate_action
	candidate_action (rca_context &context, const config &cfg)

virtual	~candidate_action ()
	Destructor. More...

bool	is_enabled () const
	Is this candidate action enabled ? More...

void	enable ()
	Enable the candidate action. More...

void	disable ()
	Disable the candidate action. More...

double	get_score () const
	Get the usual score of the candidate action without re-evaluation. More...

double	get_max_score () const
	Get the upper bound of the score of the candidate action without re-evaluation. More...

virtual std::string	get_name () const
	Get the name of the candidate action (useful for debug purposes) More...

const std::string &	get_type () const
	Get the type of the candidate action (useful for debug purposes) More...

virtual std::string	get_id () const

virtual std::string	get_engine () const

int	get_recursion_count () const
	Get the value of the recursion counter. More...

virtual void	set_to_be_removed ()

virtual bool	to_be_removed ()

Public Member Functions inherited from ai::rca_context_proxy
	rca_context_proxy ()

virtual	~rca_context_proxy ()

void	init_rca_context_proxy (rca_context &target)

rca_context &	get_rca_context ()
	Unwrap. More...

Public Member Functions inherited from ai::rca_context
	rca_context ()
	Constructor. More...

virtual	~rca_context ()
	Destructor. More...

bool	is_offense ()

void	set_offense ()

bool	is_defense ()

void	set_defense ()

void	clear_strategy ()

bool	has_strategy ()

Public Member Functions inherited from ai::default_ai_context
	default_ai_context ()
	Constructor. More...

virtual	~default_ai_context ()
	Destructor. More...

Public Member Functions inherited from ai::readwrite_context
	readwrite_context ()

virtual	~readwrite_context ()

Public Member Functions inherited from ai::readonly_context
	readonly_context ()

virtual	~readonly_context ()

Public Member Functions inherited from ai::side_context
virtual	~side_context ()
	empty destructor More...

	side_context ()
	empty constructor More...

Public Member Functions inherited from ai::ai_context_proxy
	ai_context_proxy ()

void	init_ai_context_proxy (ai_context &target)

virtual	~ai_context_proxy ()

ai_context &	get_ai_context ()
	Unwrap. More...

Public Member Functions inherited from ai::default_ai_context_proxy
int	count_free_hexes_in_castle (const map_location &loc, std::set< map_location > &checked_hexes)

	default_ai_context_proxy ()

virtual	~default_ai_context_proxy ()

virtual const std::vector < target > &	additional_targets () const

virtual void	add_target (const target &t) const

virtual void	clear_additional_targets () const

virtual default_ai_context &	get_default_ai_context ()

virtual std::vector< target >	find_targets (const move_map &enemy_dstsrc)

void	init_default_ai_context_proxy (default_ai_context &target)

virtual int	rate_terrain (const unit &u, const map_location &loc) const

virtual config	to_default_ai_context_config () const

Public Member Functions inherited from ai::readwrite_context_proxy
	readwrite_context_proxy ()

void	init_readwrite_context_proxy (readwrite_context &target)

virtual readwrite_context &	get_readwrite_context ()

virtual attack_result_ptr	execute_attack_action (const map_location &attacker_loc, const map_location &defender_loc, int attacker_weapon)

virtual move_result_ptr	execute_move_action (const map_location &from, const map_location &to, bool remove_movement=true, bool unreach_is_ok=false)

virtual recall_result_ptr	execute_recall_action (const std::string &id, const map_location &where=map_location::null_location(), const map_location &from=map_location::null_location())

virtual recruit_result_ptr	execute_recruit_action (const std::string &unit_name, const map_location &where=map_location::null_location(), const map_location &from=map_location::null_location())

virtual stopunit_result_ptr	execute_stopunit_action (const map_location &unit_location, bool remove_movement=true, bool remove_attacks=false)

virtual synced_command_result_ptr	execute_synced_command_action (const std::string &lua_code, const map_location &location=map_location::null_location())

virtual team &	current_team_w ()

virtual void	raise_gamestate_changed () const

virtual game_info &	get_info_w ()

virtual config	to_readwrite_context_config () const
	serialize this context to config More...

Public Member Functions inherited from ai::readonly_context_proxy
	readonly_context_proxy ()

virtual	~readonly_context_proxy ()

void	init_readonly_context_proxy (readonly_context &target)

virtual readonly_context &	get_readonly_context ()

virtual void	on_readonly_context_create ()

virtual const team &	current_team () const

virtual void	diagnostic (const std::string &msg)

virtual void	log_message (const std::string &msg)

virtual attack_result_ptr	check_attack_action (const map_location &attacker_loc, const map_location &defender_loc, int attacker_weapon)

virtual move_result_ptr	check_move_action (const map_location &from, const map_location &to, bool remove_movement=true, bool unreach_is_ok=false)

virtual recall_result_ptr	check_recall_action (const std::string &id, const map_location &where=map_location::null_location(), const map_location &from=map_location::null_location())

virtual recruit_result_ptr	check_recruit_action (const std::string &unit_name, const map_location &where=map_location::null_location(), const map_location &from=map_location::null_location())

virtual stopunit_result_ptr	check_stopunit_action (const map_location &unit_location, bool remove_movement=true, bool remove_attacks=false)

virtual synced_command_result_ptr	check_synced_command_action (const std::string &lua_code, const map_location &location=map_location::null_location())

virtual void	calculate_possible_moves (std::map< map_location, pathfind::paths > &possible_moves, move_map &srcdst, move_map &dstsrc, bool enemy, bool assume_full_movement=false, const terrain_filter *remove_destinations=nullptr) const

virtual void	calculate_moves (const unit_map &units, std::map< map_location, pathfind::paths > &possible_moves, move_map &srcdst, move_map &dstsrc, bool enemy, bool assume_full_movement=false, const terrain_filter *remove_destinations=nullptr, bool see_all=false) const

virtual const game_info &	get_info () const

virtual void	raise_user_interact () const

defensive_position const &	best_defensive_position (const map_location &unit, const move_map &dstsrc, const move_map &srcdst, const move_map &enemy_dstsrc) const

virtual std::map< map_location, defensive_position > &	defensive_position_cache () const

virtual const unit_advancements_aspect &	get_advancements () const

virtual double	get_aggression () const

virtual int	get_attack_depth () const

virtual const aspect_map &	get_aspects () const

virtual aspect_map &	get_aspects ()

virtual void	add_aspects (std::vector< aspect_ptr > &aspects)

virtual void	add_facet (const std::string &id, const config &cfg) const

virtual const attacks_vector &	get_attacks () const

virtual const variant &	get_attacks_as_variant () const

virtual const terrain_filter &	get_avoid () const

virtual double	get_caution () const

virtual const move_map &	get_dstsrc () const

virtual const move_map &	get_enemy_dstsrc () const

virtual const moves_map &	get_enemy_possible_moves () const

virtual const move_map &	get_enemy_srcdst () const

virtual engine_ptr	get_engine_by_cfg (const config &cfg)
	get engine by cfg, creating it if it is not created yet but known More...

virtual const std::vector < engine_ptr > &	get_engines () const

virtual std::vector< engine_ptr > &	get_engines ()

virtual std::string	get_grouping () const

virtual const std::vector < goal_ptr > &	get_goals () const

virtual std::vector< goal_ptr > &	get_goals ()

virtual double	get_leader_aggression () const

virtual config	get_leader_goal () const

virtual bool	get_leader_ignores_keep () const

virtual double	get_leader_value () const

virtual bool	get_passive_leader () const

virtual bool	get_passive_leader_shares_keep () const

virtual const moves_map &	get_possible_moves () const

virtual double	power_projection (const map_location &loc, const move_map &dstsrc) const
	Function which finds how much 'power' a side can attack a certain location with. More...

virtual const std::vector < unit_ptr > &	get_recall_list () const

virtual double	get_recruitment_diversity () const

virtual const config	get_recruitment_instructions () const

virtual const std::vector < std::string >	get_recruitment_more () const

virtual const std::vector < std::string >	get_recruitment_pattern () const

virtual int	get_recruitment_randomness () const

virtual const config	get_recruitment_save_gold () const

virtual const move_map &	get_srcdst () const

virtual double	get_scout_village_targeting () const

virtual bool	get_simple_targeting () const

virtual bool	get_support_villages () const

virtual double	get_village_value () const

virtual int	get_villages_per_scout () const

virtual bool	is_active (const std::string &time_of_day, const std::string &turns) const

virtual bool	is_dst_src_valid_lua () const

virtual bool	is_dst_src_enemy_valid_lua () const

virtual bool	is_src_dst_valid_lua () const

virtual bool	is_src_dst_enemy_valid_lua () const

virtual void	invalidate_defensive_position_cache () const

virtual void	invalidate_move_maps () const

virtual void	invalidate_keeps_cache () const

virtual const std::set < map_location > &	keeps () const

virtual bool	leader_can_reach_keep () const

virtual const map_location &	nearest_keep (const map_location &loc) const

virtual void	recalculate_move_maps () const

virtual void	recalculate_move_maps_enemy () const

virtual void	set_dst_src_valid_lua ()

virtual void	set_dst_src_enemy_valid_lua ()

virtual void	set_src_dst_valid_lua ()

virtual void	set_src_dst_enemy_valid_lua ()

virtual const map_location &	suitable_keep (const map_location &leader_location, const pathfind::paths &leader_paths)
	get most suitable keep for leader - nearest free that can be reached in 1 turn, if none - return nearest occupied that can be reached in 1 turn, if none - return nearest keep, if none - return null_location More...

virtual config	to_readonly_context_config () const
	serialize to config More...

virtual unit_stats_cache_t &	unit_stats_cache () const

Public Member Functions inherited from ai::side_context_proxy
	side_context_proxy ()

virtual	~side_context_proxy ()

void	init_side_context_proxy (side_context &target)

virtual side_number	get_side () const
	Get the side number. More...

virtual void	set_side (side_number side)
	Set the side number. More...

virtual side_context &	get_side_context ()
	unwrap More...

virtual config	to_side_context_config () const
	serialize this context to config More...

Public Member Functions inherited from ai::component
	component ()

virtual	~component ()

virtual component *	get_child (const path_element &child)

virtual std::vector< component * >	get_children (const std::string &type)

virtual std::vector< std::string >	get_children_types ()

virtual bool	change_child (const path_element &child, const config &cfg)

virtual bool	add_child (const path_element &child, const config &cfg)

virtual bool	delete_child (const path_element &child)

property_handler_map &	property_handlers ()

Private Types
enum	states { NORMAL, SAVE_GOLD, SPEND_ALL_GOLD, LEADER_IN_DANGER }

Private Member Functions
action_result_ptr	execute_recall (const std::string &id, data &leader_data)
	A helper function for execute(). More...

action_result_ptr	execute_recruit (const std::string &type, data &leader_data)
	A helper function for execute(). More...

const std::string *	get_appropriate_recall (const std::string &type, const data &leader_data) const
	A helper function for execute(). More...

data *	get_best_leader_from_ratio_scores (std::vector< data > &leader_data, const config *job) const
	A helper function for execute(). More...

const std::string	get_best_recruit_from_scores (const data &leader_data, const config *job)
	A helper function for execute(). More...

void	compare_cost_maps_and_update_important_hexes (const pathfind::full_cost_map &my_cost_map, const pathfind::full_cost_map &enemy_cost_map)
	For Map Analysis Computes from our cost map and the combined cost map of all enemies the important hexes. More...

double	get_average_defense (const std::string &unit_type) const
	For Map Analysis. More...

const pathfind::full_cost_map	get_cost_map_of_side (int side) const
	For Map Analysis. More...

void	show_important_hexes () const
	For Map Analysis. More...

void	update_average_lawful_bonus ()
	Calculates a average lawful bonus, so Combat Analysis will work better in caves and custom time of day cycles. More...

void	update_average_local_cost ()
	For Map Analysis. More...

void	update_important_hexes ()
	For Map Analysis. More...

double	compare_unit_types (const std::string &a, const std::string &b)
	For Combat Analysis. More...

void	do_combat_analysis (std::vector< data > *leader_data)
	Combat Analysis. More...

const double *	get_cached_combat_value (const std::string &a, const std::string &b, double a_defense, double b_defense)
	For Combat Analysis. More...

void	simulate_attack (const unit_type const attacker, const unit_type const defender, double attacker_defense, double defender_defense, double damage_to_attacker, double damage_to_defender) const
	For Combat Analysis. More...

config *	get_most_important_job ()
	For Configuration / Aspect "recruitment-instructions" We call a [recruit] tag a "job". More...

const std::string	get_random_pattern_type_if_exists (const data &leader_data, const config *job) const
	For Configuration / Aspect "recruitment-instructions" If the flag pattern is set, this method returns a random element of the type-attribute. More...

void	integrate_recruitment_pattern_in_recruitment_instructions ()
	For Configuration / Aspect "recruitment_pattern" Converts the (old) recruitment_pattern into a recruitment_instruction (job). More...

bool	leader_matches_job (const data &leader_data, const config *job) const
	For Configuration / Aspect "recruitment-instructions" Checks if a given leader is specified in the "leader_id" attribute. More...

bool	limit_ok (const std::string &recruit) const
	For Configuration / Aspect "recruitment-instructions" Checks if a recruit-type can be recruited according to the [limit]-tag. More...

bool	recruit_matches_job (const std::string &recruit, const config *job) const
	For Configuration / Aspect "recruitment-instructions" Checks if a given recruit-type is specified in the "type" attribute. More...

bool	recruit_matches_type (const std::string &recruit, const std::string &type) const
	For Configuration / Aspect "recruitment-instructions" Checks if a given recruit-type matches one atomic "type" attribute. More...

bool	recruit_matches_types (const std::string &recruit, const std::vector< std::string > &types) const
	For Configuration / Aspect "recruitment-instructions" Checks if a given recruit-type matches one of the given types. More...

bool	remove_job_if_no_blocker (config *job)
	For Configuration / Aspect "recruitment-instructions". More...

double	get_estimated_income (int turns) const
	For Aspect "recruitment_save_gold". More...

double	get_estimated_unit_gain () const
	For Aspect "recruitment_save_gold". More...

double	get_estimated_village_gain () const
	For Aspect "recruitment_save_gold". More...

double	get_unit_ratio () const
	For Aspect "recruitment_save_gold". More...

void	update_state ()
	For Aspect "recruitment_save_gold". More...

void	do_randomness (std::vector< data > *leader_data) const
	Will add a random value between 0 and "recruitment_randomness" to all recruits. More...

void	do_similarity_penalty (std::vector< data > *leader_data) const
	Will give a penalty to similar units. More...

int	get_cheapest_unit_cost_for_leader (const unit_map::const_iterator &leader)
	Called at the beginning and whenever the recruitment list changes. More...

void	handle_recruitment_more (std::vector< data > *leader_data) const
	For Aspect "recruitment_more". More...

bool	is_enemy_in_radius (const map_location &loc, int radius) const
	Helper function. More...

void	update_own_units_count ()

void	update_scouts_wanted ()
	This function will use the aspect villages_per_scout to decide how many scouts we want to recruit. More...

Private Attributes
std::set< map_location >	important_hexes_

terrain_count_map	important_terrain_

int	own_units_in_combat_counter_

std::map< map_location, double >	average_local_cost_

std::map< size_t, int >	cheapest_unit_costs_

cache_table	combat_cache_

states	state_

recruit_situation_change_observer	recruit_situation_change_observer_

int	average_lawful_bonus_

config	recruitment_instructions_

int	recruitment_instructions_turn_

count_map	own_units_count_

int	total_own_units_

int	scouts_wanted_

Additional Inherited Members
Public Types inherited from ai::readonly_context
typedef std::map< std::pair < map_location, const unit_type * >, std::pair < battle_context_unit_stats, battle_context_unit_stats > >	unit_stats_cache_t

Static Public Attributes inherited from ai::candidate_action
static const double	BAD_SCORE = 0

static const double	HIGH_SCORE = 10000000

Detailed Description

Definition at line 187 of file recruitment.hpp.

Member Enumeration Documentation

enum ai::default_recruitment::recruitment::states

private

Enumerator
NORMAL
SAVE_GOLD
SPEND_ALL_GOLD
LEADER_IN_DANGER

Definition at line 280 of file recruitment.hpp.

Constructor & Destructor Documentation

ai::default_recruitment::recruitment::recruitment	(	rca_context &	context,
		const config &	cfg
	)

Definition at line 108 of file recruitment.cpp.

References NORMAL, SAVE_GOLD, SPEND_ALL_GOLD, and state_.

virtual ai::default_recruitment::recruitment::~recruitment ( )

inlinevirtual

Definition at line 190 of file recruitment.hpp.

Member Function Documentation

void ai::default_recruitment::recruitment::compare_cost_maps_and_update_important_hexes	(	const pathfind::full_cost_map &	my_cost_map,
		const pathfind::full_cost_map &	enemy_cost_map
	)

private

For Map Analysis Computes from our cost map and the combined cost map of all enemies the important hexes.

Definition at line 601 of file recruitment.cpp.

References average_local_cost_, resources::gameboard, pathfind::full_cost_map::get_average_cost_at(), gamemap::h(), important_hexes_, game_board::map(), and gamemap::w().

Referenced by update_important_hexes().

double ai::default_recruitment::recruitment::compare_unit_types	(	const std::string &	a,
		const std::string &	b
	)

private

For Combat Analysis.

Calculates how good unit-type a is against unit type b. If the value is bigger then 0, a is better then b. If the value is 2.0 then unit-type a is twice as good as unit-type b. Since this function is called very often it uses a cache.

Definition at line 857 of file recruitment.cpp.

References gui2::cache, combat_cache_, unit_type::cost(), ERR_AI_RECRUITMENT, unit_type_data::find(), get_average_defense(), get_cached_combat_value(), unit_type::hitpoints(), simulate_attack(), and unit_types.

Referenced by do_combat_analysis().

void ai::default_recruitment::recruitment::do_combat_analysis ( std::vector< data > * leader_data )

private

Combat Analysis.

Main function. Compares all enemy units with all of our possible recruits and fills the scores.

Definition at line 922 of file recruitment.cpp.

References compare_unit_types(), ai::readonly_context_proxy::current_team(), unit_type_data::find(), ai::readonly_context_proxy::get_recruitment_diversity(), unit_type::hitpoints(), unit::hitpoints(), unit::incapacitated(), team::is_enemy(), team::recruits(), team::side(), unit::side(), resources::teams, unit::type_id(), unit_types, and resources::units.

Referenced by execute().

void ai::default_recruitment::recruitment::do_randomness ( std::vector< data > * leader_data ) const

private

Will add a random value between 0 and "recruitment_randomness" to all recruits.

Definition at line 1540 of file recruitment.cpp.

References ai::readonly_context_proxy::get_recruitment_randomness(), and ai::default_recruitment::data::scores.

Referenced by execute().

void ai::default_recruitment::recruitment::do_similarity_penalty ( std::vector< data > * leader_data ) const

private

Will give a penalty to similar units.

Similar units are units in one advancement tree. Example (Archer can advance to Ranger): before after Elvish Fighter: 50 50 Elvish Archer: 50 25 Elvish Ranger: 50 25

Definition at line 1560 of file recruitment.cpp.

References unit_type::advancement_tree(), unit_type_data::find(), ai::default_recruitment::data::scores, and unit_types.

Referenced by execute().

double ai::default_recruitment::recruitment::evaluate ( )

virtual

Evaluate the candidate action, resetting the internal state of the action.

Returns: the score

Return values

>0	if the action is good
<=0	if the action is not good

Implements ai::candidate_action.

Definition at line 145 of file recruitment.cpp.

References ai::candidate_action::BAD_SCORE, cheapest_unit_costs_, ai::readonly_context_proxy::current_team(), unit_map::find_leaders(), pathfind::find_vacant_castle(), resources::gameboard, get_cheapest_unit_cost_for_leader(), get_most_important_job(), ai::readonly_context_proxy::get_recruitment_instructions(), ai::candidate_action::get_score(), ai::side_context_proxy::get_side(), integrate_recruitment_pattern_in_recruitment_instructions(), LOG_AI_RECRUITMENT, map_location::null_location(), ai::default_recruitment::recruitment::recruit_situation_change_observer::recruit_list_changed(), recruit_situation_change_observer_, recruitment_instructions_, recruitment_instructions_turn_, ai::default_recruitment::recruitment::recruit_situation_change_observer::set_recruit_list_changed(), resources::tod_manager, tod_manager::turn(), and resources::units.

void ai::default_recruitment::recruitment::execute ( )

virtual

Execute the candidate action.

Find important hexes and calculate other static things.

Fill scores.

Do recruitment according to [recruit]-tags and scores. Note that the scores don't indicate the preferred mix to recruit but rather the preferred mix of all units. So already existing units are considered.

Implements ai::candidate_action.

Definition at line 192 of file recruitment.cpp.

action_result_ptr ai::default_recruitment::recruitment::execute_recall	(	const std::string &	id,
		data &	leader_data
	)

private

A helper function for execute().

Definition at line 437 of file recruitment.cpp.

References ai::readonly_context_proxy::check_recall_action(), ai::default_recruitment::data::leader, map_location::null_location(), and ai::default_recruitment::data::recruit_count.

Referenced by execute().

action_result_ptr ai::default_recruitment::recruitment::execute_recruit	(	const std::string &	type,
		data &	leader_data
	)

private

A helper function for execute().

Definition at line 451 of file recruitment.cpp.

References ai::readonly_context_proxy::check_recruit_action(), ai::default_recruitment::data::leader, LOG_AI_RECRUITMENT, map_location::null_location(), and ai::default_recruitment::data::recruit_count.

Referenced by execute().

const std::string * ai::default_recruitment::recruitment::get_appropriate_recall	(	const std::string &	type,
		const data &	leader_data
	)		const

private

A helper function for execute().

Checks if this unit type can be recalled. If yes, we calculate a estimated value in gold of the recall unit. If this value is less then the recall cost, we dismiss the unit. The unit with the highest value will be returned.

Definition at line 471 of file recruitment.cpp.

References unit_type::cost(), ai::readonly_context_proxy::current_team(), resources::filter_con, unit_type_data::find(), ai::default_recruitment::data::leader, LOG_AI_RECRUITMENT, map_location::null_location(), game_config::recall_cost, actions::recall_unit(), and unit_types.

Referenced by execute().

double ai::default_recruitment::recruitment::get_average_defense ( const std::string & u_type ) const

private

For Map Analysis.

Calculates for a given unit the average defense on the map. (According to important_hexes_ / important_terrain_)

Definition at line 653 of file recruitment.cpp.

References movetype::defense_modifier(), unit_type_data::find(), important_terrain_, unit_type::movement_type(), gui2::terrain, and unit_types.

Referenced by compare_unit_types().

data * ai::default_recruitment::recruitment::get_best_leader_from_ratio_scores	(	std::vector< data > &	leader_data,
		const config *	job
	)		const

private

A helper function for execute().

Decides according to the leaders ratio scores which leader should recruit.

Definition at line 519 of file recruitment.cpp.

References leader_matches_job(), ai::default_recruitment::data::ratio_score, and ai::default_recruitment::data::recruit_count.

Referenced by execute().

const std::string ai::default_recruitment::recruitment::get_best_recruit_from_scores	(	const data &	leader_data,
		const config *	job
	)

private

A helper function for execute().

Counts own units and then decides what unit should be recruited so that the unit distribution approaches the given scores.

Definition at line 557 of file recruitment.cpp.

References ai::default_recruitment::data::get_normalized_scores(), get_random_pattern_type_if_exists(), i, limit_ok(), LOG_AI_RECRUITMENT, own_units_count_, recruit_matches_job(), recruit_matches_type(), scouts_wanted_, and total_own_units_.

Referenced by execute().

const double * ai::default_recruitment::recruitment::get_cached_combat_value	(	const std::string &	a,
		const std::string &	b,
		double	a_defense,
		double	b_defense
	)

private

For Combat Analysis.

Returns the cached combat value for two unit types or nullptr if there is none or terrain defenses are not within range.

Definition at line 1028 of file recruitment.cpp.

References gui2::cache, and combat_cache_.

Referenced by compare_unit_types().

int ai::default_recruitment::recruitment::get_cheapest_unit_cost_for_leader ( const unit_map::const_iterator & leader )

private

Called at the beginning and whenever the recruitment list changes.

Definition at line 1598 of file recruitment.cpp.

References cheapest_unit_costs_, unit_type::cost(), ai::readonly_context_proxy::current_team(), unit_type_data::find(), lg::info(), LOG_AI_RECRUITMENT, game_config::recall_cost, team::recall_cost(), team::recruits(), and unit_types.

Referenced by evaluate(), and execute().

const pathfind::full_cost_map ai::default_recruitment::recruitment::get_cost_map_of_side ( int side ) const

private

For Map Analysis.

Creates cost maps for a side. Each hex is map to a) the summed movecost and b) how many units can reach this hex for all units of side.

Definition at line 679 of file recruitment.cpp.

References pathfind::full_cost_map::add_unit(), unit::can_recruit(), unit_type_data::find(), unit::incapacitated(), team::recruits(), unit::side(), unit::total_movement(), unit_types, and resources::units.

Referenced by update_important_hexes().

double ai::default_recruitment::recruitment::get_estimated_income ( int turns ) const

private

For Aspect "recruitment_save_gold".

Guess the income over the next turns. This doesn't need to be exact. In the end we are just interested if this value is positive or negative.

Definition at line 1414 of file recruitment.cpp.

References team::base_income(), resources::gameboard, get_estimated_unit_gain(), get_estimated_village_gain(), ai::side_context_proxy::get_side(), i, display_context::side_upkeep(), preferences::turns(), game_config::village_income, game_config::village_support, and team::villages().

Referenced by update_state().

double ai::default_recruitment::recruitment::get_estimated_unit_gain ( ) const

private

For Aspect "recruitment_save_gold".

Guess how many units we will gain / loose over the next turns per turn.

Definition at line 1435 of file recruitment.cpp.

References own_units_in_combat_counter_.

Referenced by get_estimated_income().

double ai::default_recruitment::recruitment::get_estimated_village_gain ( ) const

private

For Aspect "recruitment_save_gold".

Guess how many villages we will gain over the next turns per turn.

Definition at line 1443 of file recruitment.cpp.

References resources::gameboard, game_board::map(), resources::teams, and gamemap::villages().

Referenced by get_estimated_income().

config * ai::default_recruitment::recruitment::get_most_important_job ( )

private

For Configuration / Aspect "recruitment-instructions" We call a [recruit] tag a "job".

Definition at line 1168 of file recruitment.cpp.

References config::child_range(), schema_validation::number, own_units_count_, recruit_matches_job(), recruitment_instructions_, and update_own_units_count().

Referenced by evaluate(), and execute().

const std::string ai::default_recruitment::recruitment::get_random_pattern_type_if_exists	(	const data &	leader_data,
		const config *	job
	)		const

private

For Configuration / Aspect "recruitment-instructions" If the flag pattern is set, this method returns a random element of the type-attribute.

Definition at line 1209 of file recruitment.cpp.

References limit_ok(), LOG_AI_RECRUITMENT, recruit_matches_type(), ai::default_recruitment::data::recruits, and utils::split().

Referenced by get_best_recruit_from_scores().

double ai::default_recruitment::recruitment::get_unit_ratio ( ) const

private

For Aspect "recruitment_save_gold".

Returns our_total_unit_costs / enemy_total_unit_costs.

Definition at line 1458 of file recruitment.cpp.

References unit::can_recruit(), unit::cost(), ai::readonly_context_proxy::current_team(), unit::hitpoints(), unit::incapacitated(), team::is_enemy(), unit::max_hitpoints(), team::side(), unit::side(), resources::teams, unit::total_movement(), and resources::units.

Referenced by update_state().

void ai::default_recruitment::recruitment::handle_recruitment_more ( std::vector< data > * leader_data ) const

private

For Aspect "recruitment_more".

Definition at line 1638 of file recruitment.cpp.

References ai::readonly_context_proxy::get_recruitment_more(), recruit_matches_type(), and ai::default_recruitment::data::scores.

Referenced by execute().

void ai::default_recruitment::recruitment::integrate_recruitment_pattern_in_recruitment_instructions ( )

private

For Configuration / Aspect "recruitment_pattern" Converts the (old) recruitment_pattern into a recruitment_instruction (job).

Definition at line 1257 of file recruitment.cpp.

References config::add_child(), ai::readonly_context_proxy::get_recruitment_pattern(), and recruitment_instructions_.

Referenced by evaluate().

bool ai::default_recruitment::recruitment::is_enemy_in_radius	(	const map_location &	loc,
		int	radius
	)		const

private

Helper function.

Returns true if there is a enemy within the radius.

Definition at line 1660 of file recruitment.cpp.

References ai::readonly_context_proxy::current_team(), unit_map::end(), unit_map::find(), get_tiles_in_radius(), team::is_enemy(), and resources::units.

Referenced by update_important_hexes().

bool ai::default_recruitment::recruitment::leader_matches_job	(	const data &	leader_data,
		const config *	job
	)		const

private

For Configuration / Aspect "recruitment-instructions" Checks if a given leader is specified in the "leader_id" attribute.

Definition at line 1285 of file recruitment.cpp.

References gui2::event::find(), ai::default_recruitment::data::leader, limit_ok(), recruit_matches_job(), ai::default_recruitment::data::recruits, and utils::split().

Referenced by get_best_leader_from_ratio_scores().

bool ai::default_recruitment::recruitment::limit_ok ( const std::string & recruit ) const

private

For Configuration / Aspect "recruitment-instructions" Checks if a recruit-type can be recruited according to the [limit]-tag.

Definition at line 1312 of file recruitment.cpp.

References config::child_range(), ai::readonly_context_proxy::get_recruitment_instructions(), schema_validation::number, own_units_count_, recruit_matches_types(), and utils::split().

Referenced by get_best_recruit_from_scores(), get_random_pattern_type_if_exists(), and leader_matches_job().

bool ai::default_recruitment::recruitment::recruit_matches_job	(	const std::string &	recruit,
		const config *	job
	)		const

private

For Configuration / Aspect "recruitment-instructions" Checks if a given recruit-type is specified in the "type" attribute.

Definition at line 1343 of file recruitment.cpp.

References recruit_matches_types(), and utils::split().

Referenced by get_best_recruit_from_scores(), get_most_important_job(), and leader_matches_job().

bool ai::default_recruitment::recruitment::recruit_matches_type	(	const std::string &	recruit,
		const std::string &	type
	)		const

private

For Configuration / Aspect "recruitment-instructions" Checks if a given recruit-type matches one atomic "type" attribute.

Definition at line 1353 of file recruitment.cpp.

References unit_type_data::find(), unit_type::id(), unit_type::level(), unit_types, and unit_type::usage().

Referenced by execute(), get_best_recruit_from_scores(), get_random_pattern_type_if_exists(), handle_recruitment_more(), recruit_matches_types(), and update_scouts_wanted().

bool ai::default_recruitment::recruitment::recruit_matches_types	(	const std::string &	recruit,
		const std::vector< std::string > &	types
	)		const

private

For Configuration / Aspect "recruitment-instructions" Checks if a given recruit-type matches one of the given types.

Definition at line 1379 of file recruitment.cpp.

References recruit_matches_type().

Referenced by limit_ok(), and recruit_matches_job().

bool ai::default_recruitment::recruitment::remove_job_if_no_blocker ( config * job )

private

For Configuration / Aspect "recruitment-instructions".

Definition at line 1396 of file recruitment.cpp.

References config::clear(), and LOG_AI_RECRUITMENT.

Referenced by execute().

void ai::default_recruitment::recruitment::show_important_hexes ( ) const

private

For Map Analysis.

Shows the important hexes for debugging purposes on the map. Only if debug is activated.

Definition at line 718 of file recruitment.cpp.

References map_labels::clear_all(), game_config::debug, important_hexes_, display::labels(), map_location::NORTH, resources::screen, and map_labels::set_label().

Referenced by execute().

void ai::default_recruitment::recruitment::simulate_attack	(	const unit_type *const	attacker,
		const unit_type *const	defender,
		double	attacker_defense,
		double	defender_defense,
		double *	damage_to_attacker,
		double *	damage_to_defender
	)		const