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

run_negotiation(s, partners[, ...])

Run a single negotiation with fully specified parameters

cartesian_tournament(competitors, scenarios)

A simplified version of Cartesian tournaments not using the internal machinay of NegMAS tournaments

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, ...)

SimpleTournamentResults(scores, details, ...)

Class Inheritance Diagram

digraph inheritanceb7696d640a { 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)"]; "SimpleTournamentResults" [URL="../api/negmas.tournaments.SimpleTournamentResults.html#negmas.tournaments.SimpleTournamentResults",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"]; "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"]; }