negmas.tournaments Package

Tournament generation and management.

Functions

run_world(world_params[, dry_run, ...])	Runs a world and returns stats.
process_world_run(run_id, results, ...)	Generates a data-frame with the results of this world run
create_tournament(competitors, ...[, ...])	Creates a tournament
run_tournament(tournament_path[, ...])	Runs a tournament
evaluate_tournament(tournament_path[, ...])	Evaluates the results of a tournament
combine_tournaments(sources, dest[, verbose])	Combines contents of several tournament runs in the destination path allowing for continuation of the tournament
combine_tournament_results(sources[, dest, ...])	Combines results of several tournament runs in the destination path.
combine_tournament_stats(sources[, dest, ...])	Combines statistical results of several tournament runs in the destination path.
tournament(competitors, config_generator, ...)	Runs a tournament
create_neg_tournament(competitors, scenarios)	Creates a tournament
create_cartesian_tournament(competitors, ...)	Creates a Cartesian tournament (every competitor against every other competitor)
neg_tournament(competitors, scenarios[, ...])	Runs a tournament
random_discrete_scenarios(issues, partners)	Generates an infinite sequence of random discrete scenarios
scenarios_from_list(scenarios)	Creates an appropriate NegScenario generator from a list/tuple of scenarios
cartesian_tournament(competitors, scenarios)	Runs a Cartesian tournament between competitors optionally rotating preferences.

Classes

WorldGenerator(*args, **kwargs)	A callback-protocol specifying the signature of a world generator function that can be passed to tournament
WorldRunResults(world_names, log_file_names)	Results of a world run
TournamentResults(scores, total_scores, ...)

Class Inheritance Diagram

digraph inheritanceec1da1ff3b { bgcolor=transparent; fontsize=11; randkir=TB; rankdir=LR; size=""; "Generic" [URL="https://docs.python.org/3/library/typing.html#typing.Generic",fillcolor=white,fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=11,height=0.25,shape=box,style="setlinewidth(0.5),filled",target="_top",tooltip="Abstract base class for generic types."]; "Protocol" [fillcolor=white,fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=11,height=0.25,shape=box,style="setlinewidth(0.5),filled",tooltip="Base class for protocol classes."]; "Generic" -> "Protocol" [arrowsize=0.5,style="setlinewidth(0.5)"]; "TournamentResults" [URL="../api/negmas.tournaments.TournamentResults.html#negmas.tournaments.TournamentResults",fillcolor=white,fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=11,height=0.25,shape=box,style="setlinewidth(0.5),filled",target="_top",tooltip="TournamentResults(scores: 'pd.DataFrame', total_scores: 'pd.DataFrame', winners: 'list[str]', winners_scores: 'np.ndarray', ttest: 'pd.DataFrame | None' = None, kstest: 'pd.DataFrame | None' = None, stats: 'pd.DataFrame | None' = None, agg_stats: 'pd.DataFrame | None' = None, score_stats: 'pd.DataFrame | None' = None, path: 'str | None' = None, world_stats: 'pd.DataFrame | None' = None, type_stats: 'pd.DataFrame | None' = None, agent_stats: 'pd.DataFrame | None' = None, params: 'dict[str, Any] | None' = None, extra_scores: 'dict[str, pd.DataFrame] | None' = None)"]; "WorldGenerator" [URL="../api/negmas.tournaments.WorldGenerator.html#negmas.tournaments.WorldGenerator",fillcolor=white,fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=11,height=0.25,shape=box,style="setlinewidth(0.5),filled",target="_top",tooltip="A callback-protocol specifying the signature of a world generator function that can be passed to `tournament`"]; "Protocol" -> "WorldGenerator" [arrowsize=0.5,style="setlinewidth(0.5)"]; "WorldRunResults" [URL="../api/negmas.tournaments.WorldRunResults.html#negmas.tournaments.WorldRunResults",fillcolor=white,fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=11,height=0.25,shape=box,style="setlinewidth(0.5),filled",target="_top",tooltip="Results of a world run"]; }