SAONMI

class negmas.sao.SAONMI(id, n_outcomes, outcome_space, time_limit, step_time_limit, negotiator_time_limit, n_steps, dynamic_entry, max_n_agents, annotation=<factory>, end_on_no_response=True, publish_proposer=True, publish_n_acceptances=False)[source]

Bases: negmas.common.NegotiatorMechanismInterface

Attributes Summary

`agent_ids`	Gets the IDs of all agents owning all negotiators
`agent_names`	Gets the names of all agents owning all negotiators
`cartesian_outcome_space`	Returns the `outcome_space` as a `CartesianOutcomeSpace` or raises a `ValueError` if that was not possible.
`end_on_no_response`
`issues`	rtype `tuple`[`Issue`, `...`]
`n_negotiators`	Syntactic sugar for state.n_negotiators
`negotiator_ids`	Gets the IDs of all negotiators
`negotiator_names`	Gets the namess of all negotiators
`outcomes`	All outcomes for discrete outcome spaces or None for continuous outcome spaces.
`params`	Returns the parameters used to initialize the mechanism.
`participants`	rtype `list`[`NegotiatorInfo`]
`publish_n_acceptances`
`publish_proposer`
`requirements`	The protocol requirements
`state`	Access the current state of the mechanism.

Methods Summary

`asdict`()	Converts the object to a dict containing all fields
`discrete_outcome_space`([levels, max_cardinality])	Returns a stable discrete version of the given outcome-space
`discrete_outcomes`([max_cardinality])	A discrete set of outcomes that spans the outcome space
`keys`()
`random_outcomes`([n])	A set of random outcomes from the outcome-space of this negotiation
`values`()

Attributes Documentation

agent_ids

Gets the IDs of all agents owning all negotiators

Return type: list[str]

agent_names

Gets the names of all agents owning all negotiators

Return type: list[str]

cartesian_outcome_space

Returns the outcome_space as a CartesianOutcomeSpace or raises a ValueError if that was not possible.

Remarks:

Useful for negotiators that only work with CartesianOutcomeSpace s (i.e. GeniusNegotiator )

Return type: CartesianOutcomeSpace

end_on_no_response: bool = True

issues

Return type: tuple[Issue, ...]

n_negotiators

Syntactic sugar for state.n_negotiators

Return type: int

negotiator_ids

Gets the IDs of all negotiators

Return type: list[str]

negotiator_names

Gets the namess of all negotiators

Return type: list[str]

outcomes

All outcomes for discrete outcome spaces or None for continuous outcome spaces. See discrete_outcomes

Return type: Iterable[Outcome] | None

params: Returns the parameters used to initialize the mechanism.

participants

Return type: list[NegotiatorInfo]

publish_n_acceptances: bool = False

publish_proposer: bool = True

requirements

The protocol requirements

Return type

dict

Returns

A dict of str/Any pairs giving the requirements

state

Access the current state of the mechanism.

Remarks:

Whenever a method receives a AgentMechanismInterface object, it can always access the current state of the protocol by accessing this property.

Return type: MechanismState

Methods Documentation

asdict(): Converts the object to a dict containing all fields

discrete_outcome_space(levels=5, max_cardinality=100000)

Returns a stable discrete version of the given outcome-space

Return type: DiscreteOutcomeSpace

discrete_outcomes(max_cardinality=inf)

A discrete set of outcomes that spans the outcome space

Parameters: max_cardinality (int | float) – The maximum number of outcomes to return. If None, all outcomes will be returned for discrete outcome-spaces
Returns: list of n or less outcomes
Return type: list[Outcome]

keys()

random_outcomes(n=1)

A set of random outcomes from the outcome-space of this negotiation

Parameters: n (int) – number of outcomes requested
Returns: list of n or less outcomes
Return type: list[Outcome]

values()