OfferSelector
- class negmas.gb.OfferSelector(*args, **kwargs)[source]
Bases:
OfferSelectorProtocol
,GBComponent
Can select the best offer in some sense from a list of offers based on an inverter
Attributes Summary
Methods Summary
__call__
(outcomes, state)Call self as a function.
after_join
(nmi)A call back called after joining a negotiation to confirm wwe joined.
after_proposing
(state, offer)Called after proposing
after_responding
(state, offer, response[, ...])Called before offering
before_proposing
(state)Called before proposing
before_responding
(state, offer[, source])Called before offering
can_join
(nmi, state, *[, preferences, ufun, ...])A call back called before joining a negotiation to confirm that we can join it.
on_leave
(state)A call back called after leaving a negotiation.
on_mechanism_error
(state)A call back called whenever an error happens in the mechanism.
on_negotiation_end
(state)A call back called at each negotiation end
on_negotiation_start
(state)A call back called at each negotiation start
on_partner_ended
(partner)Called when a partner ends the negotiation.
on_partner_joined
(partner)Called when a partner joins the negotiation.
on_partner_left
(partner)Called when a partner leaves the negotiation.
on_partner_proposal
(state, partner_id, offer)A callback called by the mechanism when a partner proposes something
on_partner_refused_to_propose
(state, partner_id)A callback called by the mechanism when a partner refuses to propose
on_partner_response
(state, partner_id, ...)A callback called by the mechanism when a partner responds to some offer
on_preferences_changed
(changes)Called to inform the component that the ufun has changed and the kinds of change that happened.
on_round_end
(state)A call back called at each negotiation round end
on_round_start
(state)A call back called at each negotiation round start
set_negotiator
(negotiator)Sets the negotiator of which this component is a part.
Attributes Documentation
- negotiator
Methods Documentation
- after_join(nmi)
A call back called after joining a negotiation to confirm wwe joined.
- Return type:
- after_proposing(state, offer)
Called after proposing
- after_responding(state, offer, response, source=None)
Called before offering
- before_proposing(state)
Called before proposing
- before_responding(state, offer, source=None)
Called before offering
- can_join(nmi, state, *, preferences=None, ufun=None, role='negotiator')
A call back called before joining a negotiation to confirm that we can join it.
- Return type:
- on_mechanism_error(state)
A call back called whenever an error happens in the mechanism. The error and its explanation are accessible in
state
- Return type:
- on_partner_ended(partner)
Called when a partner ends the negotiation.
Note that the negotiator owning this component may never receive this offer. This is only receivd if the mechanism is sending notifications on every offer.
- on_partner_joined(partner)
Called when a partner joins the negotiation.
This is only receivd if the mechanism is sending notifications.
- on_partner_left(partner)
Called when a partner leaves the negotiation.
This is only receivd if the mechanism is sending notifications.
- on_partner_proposal(state, partner_id, offer)
A callback called by the mechanism when a partner proposes something
- Parameters:
state (
GBState
) –MechanismState
giving the state of the negotiation when the offer was porposed.partner_id (
str
) – The ID of the agent who proposedoffer (
tuple
) – The proposal.
- Return type:
- Remarks:
Will only be called if
enable_callbacks
is set for the mechanism
- on_partner_refused_to_propose(state, partner_id)
A callback called by the mechanism when a partner refuses to propose
- Parameters:
state (
GBState
) –MechanismState
giving the state of the negotiation when the partner refused to offer.partner_id (
str
) – The ID of the agent who refused to propose
- Return type:
- Remarks:
Will only be called if
enable_callbacks
is set for the mechanism
- on_partner_response(state, partner_id, outcome, response)
A callback called by the mechanism when a partner responds to some offer
- Parameters:
state (
GBState
) –MechanismState
giving the state of the negotiation when the partner responded.partner_id (
str
) – The ID of the agent who respondedresponse (
ResponseType
) – The response
- Return type:
- Remarks:
Will only be called if
enable_callbacks
is set for the mechanism
- on_preferences_changed(changes)
Called to inform the component that the ufun has changed and the kinds of change that happened.