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, ignore_exceptions=False)[source]
Run a single negotiation with fully specified parameters
- Parameters:
s (
Scenario
) – TheScenario
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 (
tuple
[str
] |None
) – Names of partners. EitherNone
for defaults or a tuple of the same length aspartners
partner_params (
tuple
[dict
[str
,Any
]] |None
) – Parameters used to create the partners. EitherNone
for defaults or a tuple of the same length aspartners
rep (
int
) – The repetition number for this run of the negotiationpath (
Path
|None
) – A folder to save the logs into. If not given, no logs will be saved.mechanism_type (
type
[Mechanism
]) – the type of theMechanism
to use for this negotiationmechanism_params (
dict
[str
,Any
] |None
) – The parameters used to create theMechanism
orNone
for defaultsfull_names (
bool
) – Use full names for partner names (only used ifpartner_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 (
dict
[str
,Any
] |None
) – Parameters to pass to the plotting functionrun_id (
int
|str
|None
) – A unique ID for this run. If not given one is generated based on date and timestats (
ScenarioStats
|None
) – statistics of the scenario. If not given orpath
isNone
, statistics are not savedannotation (
dict
[str
,Any
] |None
) – Common information saved in the mechanism’s annotation (accessible by negotiators usingself.nmi.annotation
).None
for nothingprivate_infos (
tuple
[dict
[str
,Any
] |None
] |None
) – Private information saved in the negotiator’sprivate_info
attribute (accessible by negotiators asself.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