run_negotiation
- negmas.tournaments.run_negotiation(s, partners, partner_names=None, partner_params=None, rep=0, path=None, mechanism_type=<class 'negmas.sao.mechanism.SAOMechanism'>, mechanism_params=None, full_names=True, verbosity=0, plot=False, plot_params=None, run_id=None, stats=None, annotation=None, private_infos=None, id_reveals_type=False, name_reveals_type=True, mask_scenario_name=True)[source]
Run a single negotiation with fully specified parameters
- Parameters:
s (
Scenario
) – The Scenario representing the negotiation (outcome space and preferences).partners (
tuple
[type
[Negotiator
]]) – The partners running the negotiation in order of addition to the mechanism.real_scenario_name – The real name of the scenario (used when saving logs).
partner_names (
Optional
[tuple
[str
]]) – Names of partners. Either None for defaults or a tuple of the same length as partnerspartner_params (
Optional
[tuple
[dict
[str
,Any
]]]) – Parameters used to create the partners. Either None for defaults or a tuple of the same length as partnersrep (
int
) – The repetition number for this run of the negotiationpath (
Optional
[Path
]) – A folder to save the logs into. If not given, no logs will be saved.mechanism_type (
type
[Mechanism
]) – the type of the Mechanism to use for this negotiationmechanism_params (
Optional
[dict
[str
,Any
]]) – The parameters used to create the Mechanism or None for defaultsfull_names (
bool
) – Use full names for partner names (only used if partner_names is None)verbosity (
int
) – Verbosity level as an integerplot – If true, save a plot of the negotiation (only if path is given)
plot_params (
Optional
[dict
[str
,Any
]]) – Parameters to pass to the plotting functionrun_id (
Union
[int
,str
,None
]) – A unique ID for this run. If not given one is generated based on date and timestats (
Optional
[ScenarioStats
]) – statistics of the scenario. If not given or path is None, statistics are not savedannotation (
Optional
[dict
[str
,Any
]]) – Common information saved in the mechanism’s annotation (accessible by negotiators using self.nmi.annotation). None for nothingprivate_infos (
Optional
[tuple
[Optional
[dict
[str
,Any
]]]]) – Private information saved in the negotiator’s private_info attribute (accessible by negotiators as self.private_info). None for nothingid_reveals_type (
bool
) – Each negotiator ID will reveal its type.name_reveals_type (
bool
) – Each negotiator name will reveal its type.
- Return type:
- Returns:
A dictionary of negotiation results that contains the final state of the negotiation alongside other information