A DCOP solver using Param-DPOP. More...

Inheritance diagram for frodo2.algorithms.dpop.param.ParamDPOPsolver< V extends Addable< V >, U extends Addable >:

[legend]

Classes
class	ParamSolution
	An optimal solution to the problem. More...

Public Member Functions
	ParamDPOPsolver ()
	Default constructor.
	ParamDPOPsolver (boolean useTCP)
	Constructor.
	ParamDPOPsolver (String agentDescription)
	Constructor.
	ParamDPOPsolver (Class< V > domClass, Class< U > utilClass)
	Constructor.
	ParamDPOPsolver (Class< V > domClass, Class< U > utilClass, boolean useTCP)
	Constructor.
ParamSolution< V, U >	solveParam (Document problem)
	Solves the input problem.
ParamSolution< V, U >	solveParam (DCOPProblemInterface< V, U > problem)
	Solves the input problem.
ArrayList< StatsReporter >	getSolGatherers ()
UtilitySolutionSpace< V, U >	getExpectedOptUtil (Document problem)
	Solves the problem and returns the expectation over the random variables of the optimal utility.
void	clear ()
Public Member Functions inherited from frodo2.algorithms.dpop.DPOPsolver< V extends Addable< V >, U extends Addable< U > >
	DPOPsolver ()
	Default constructor.
	DPOPsolver (boolean useTCP)
	Constructor.
	DPOPsolver (String agentDescription)
	Constructor.
	DPOPsolver (String agentDescription, boolean useTCP)
	Constructor.
	DPOPsolver (Class< V > domClass, Class< U > utilClass)
	Constructor.
	DPOPsolver (Class< V > domClass, Class< U > utilClass, boolean useTCP)
	Constructor.
	DPOPsolver (Document agentDesc)
	Constructor.
	DPOPsolver (Document agentDesc, boolean useTCP)
	Constructor.
	DPOPsolver (Document agentDesc, Class< V > domClass, Class< U > utilClass)
	Constructor.
	DPOPsolver (Document agentDesc, Class< V > domClass, Class< U > utilClass, boolean useTCP)
	Constructor.
	DPOPsolver (Document agentDesc, Class< ? extends XCSPparser< V, U > > parserClass)
	Constructor.
	DPOPsolver (Document agentDesc, Class< ? extends XCSPparser< V, U > > parserClass, boolean useTCP)
	Constructor.
	DPOPsolver (String agentDescFile, Class< V > domClass, Class< U > utilClass)
	Constructor.
	DPOPsolver (String agentDescFile, Class< V > domClass, Class< U > utilClass, boolean useTCP)
	Constructor.
Solution< V, U >	buildSolution ()
HashMap< String, DFSview< V, U > >	getDFS ()
Public Member Functions inherited from frodo2.algorithms.AbstractDCOPsolver< V extends Addable< V >, U extends Addable< U >, S extends Solution< V, U >
	AbstractDCOPsolver (String agentDesc, boolean measureTime, boolean useTCP, boolean measureMsgs, Class<? extends XCSPparser< V, U > > parserClass, Class< V > domClass, Class< U > valuationClass)
	Constructor.
S	solve (Document problem, int nbrElectionRounds, boolean measureMsgs, Long timeout, boolean cleanAfterwards)
S	solve (DCOPProblemInterface< V, U > problem, int nbrElectionRounds, boolean measureMsgs, Long timeout, boolean cleanAfterwards)
S	solve (Document problem)
S	solve (DCOPProblemInterface< V, U > problem)
S	solve (Document problem, Long timeout)
S	solve (DCOPProblemInterface< V, U > problem, Long timeout)
S	solve (Document problem, boolean cleanAfterwards)
S	solve (DCOPProblemInterface< V, U > problem, boolean cleanAfterwards)
S	solve (Document problem, int nbrElectionRounds)
S	solve (DCOPProblemInterface< V, U > problem, int nbrElectionRounds)
S	solve (Document problem, int nbrElectionRounds, boolean measureMsgs)
S	solve (DCOPProblemInterface< V, U > problem, int nbrElectionRounds, boolean measureMsgs)
S	solve (Document problem, int nbrElectionRounds, boolean measureMsgs, Long timeout)
S	solve (DCOPProblemInterface< V, U > problem, int nbrElectionRounds, boolean measureMsgs, Long timeout)
S	solve (Document problem, int nbrElectionRounds, Long timeout)
S	solve (DCOPProblemInterface< V, U > problem, int nbrElectionRounds, Long timeout)
S	solve (Document problem, boolean cleanAfterwards, Long timeout)
S	solve (DCOPProblemInterface< V, U > problem, boolean cleanAfterwards, Long timeout) throws OutOfMemoryError
Public Member Functions inherited from frodo2.algorithms.AbstractSolver< DCOPProblemInterface< V, U >, V, U, S >
void	setProblem (P problem)
	Sets the problem.
void	setFactory (AgentFactory< V, U > factory)
	Sets the agent factory.
void	setDomClass (Class< V > domClass)
	Sets the class for variable values.
void	setUtilClass (Class< U > utilClass)
	Sets the class for utility values.
Document	getAgentDesc ()
abstract List<? extends StatsReporter >	getSolGatherers ()
abstract S	buildSolution ()
S	solve (Document problem)
	Solves the input problem.
String	plotStats (Solution< V, U > sol)
	Puts the statistics in a format that can easily be processed after the experiments.
String	plotDummyStats (boolean maximize)
	Used when the solver was not able to solve the problem.

Private Attributes
ParamUTIL< V, U >	utilModule
	The UTIL propagation module.
ParamVALUE< V >	valueModule
	The VALUE propagation module.

Additional Inherited Members
Static Public Member Functions inherited from frodo2.algorithms.AbstractDCOPsolver< V extends Addable< V >, U extends Addable< U >, S extends Solution< V, U >
static void	main (String[] args) throws Exception
	Solves a problem and writes statistics to a file.
Protected Member Functions inherited from frodo2.algorithms.AbstractDCOPsolver< V extends Addable< V >, U extends Addable< U >, S extends Solution< V, U >
String	getFileHeader (Document problemFile)
	Returns the header for the output CSV file.
String	getParamsHeader ()
String	getParamsToLine ()
String	getProbStats (Document problemFile, String probFilename)
	Parses the statistics about the problem instance.
String	getTimeoutLine (String algoName, Document problemFile, String probFilename)
	Returns a timeout line for the output CSV file.
	AbstractDCOPsolver ()
	Dummy constructor.
	AbstractDCOPsolver (String agentDescFile)
	Constructor from an agent configuration file.
	AbstractDCOPsolver (String agentDescFile, boolean useTCP)
	Constructor from an agent configuration file.
	AbstractDCOPsolver (String agentDescFile, boolean useTCP, int shift)
	Constructor from an agent configuration file.
	AbstractDCOPsolver (Document agentDesc)
	Constructor.
void	parseParams (String[] params)
	Parses solver parameters.
	AbstractDCOPsolver (Document agentDesc, boolean useTCP)
	Constructor.
	AbstractDCOPsolver (Document agentDesc, Class< ? extends XCSPparser< V, U > > parserClass)
	Constructor.
	AbstractDCOPsolver (Document agentDesc, Class< ? extends XCSPparser< V, U > > parserClass, boolean useTCP)
	Constructor.
void	setNbrElectionRounds (int nbrElectionRounds)
	Sets the number of rounds of VariableElection.
void	setProblemRescalerShift (int shift)
	Sets the shift parameter of the ProblemRescaler module (if used).
void	overrideMsgTypes ()
	Overrides message types if necessary.
Protected Member Functions inherited from frodo2.algorithms.AbstractSolver< DCOPProblemInterface< V, U >, V, U, S >
	AbstractSolver ()
	Dummy constructor.
void	clear ()
	Clears the parser.
Protected Attributes inherited from frodo2.algorithms.dpop.DPOPsolver< V extends Addable< V >, U extends Addable< U > >
SolutionCollector< V, U >	solCollector
	The solution collector.
UTILpropagation< V, U >	utilModule
	The UTIL propagation module.
DFSgeneration< V, U >	dfsModule
	The DFSgeneration module.
Protected Attributes inherited from frodo2.algorithms.AbstractSolver< DCOPProblemInterface< V, U >, V, U, S >
Document	agentDesc
	Description of the agent to be used.
AgentFactory< V, U >	factory
	The agent factory.
Class< ? extends XCSPparser< V, U > >	parserClass
	The class of the parser to be used.
List<? extends StatsReporter >	solGatherers
	The list of modules that record statistics about problem solving.
P	problem
	The problem.
final boolean	useTCP
	Whether to use TCP pipes or shared memory pipes.

Detailed Description

A DCOP solver using Param-DPOP.

Author: Thomas Leaute

Parameters

<V>	type used for variable values
<U>	type used for utility values

Constructor & Destructor Documentation

◆ ParamDPOPsolver() [1/5]

frodo2.algorithms.dpop.param.ParamDPOPsolver< V extends Addable< V >, U extends Addable >.ParamDPOPsolver ( )

Default constructor.

Referenced by ParamDPOPsolver().

◆ ParamDPOPsolver() [2/5]

frodo2.algorithms.dpop.param.ParamDPOPsolver< V extends Addable< V >, U extends Addable >.ParamDPOPsolver ( boolean useTCP )

Constructor.

Parameters

useTCP whether to use TCP pipes

Warning: Using TCP pipes automatically disables simulated time.

References ParamDPOPsolver(), and frodo2.algorithms.AbstractSolver< DCOPProblemInterface< V, U >, V, U, S >.useTCP.

Here is the call graph for this function:

◆ ParamDPOPsolver() [3/5]

frodo2.algorithms.dpop.param.ParamDPOPsolver< V extends Addable< V >, U extends Addable >.ParamDPOPsolver ( String agentDescription )

Constructor.

Parameters

agentDescription Description of the Param-DPOP agent

◆ ParamDPOPsolver() [4/5]

frodo2.algorithms.dpop.param.ParamDPOPsolver< V extends Addable< V >, U extends Addable< U > >.ParamDPOPsolver	(	Class< V >	domClass,
		Class< U >	utilClass )

Constructor.

Parameters

domClass	the class to use for variable values
utilClass	the class to use for utilities

◆ ParamDPOPsolver() [5/5]

frodo2.algorithms.dpop.param.ParamDPOPsolver< V extends Addable< V >, U extends Addable< U > >.ParamDPOPsolver	(	Class< V >	domClass,
		Class< U >	utilClass,
		boolean	useTCP )

Constructor.

Parameters

domClass	the class to use for variable values
utilClass	the class to use for utilities
useTCP	whether to use TCP pipes

Warning: Using TCP pipes automatically disables simulated time.

References frodo2.algorithms.AbstractSolver< DCOPProblemInterface< V, U >, V, U, S >.useTCP.

Member Function Documentation

◆ clear()

void frodo2.algorithms.dpop.param.ParamDPOPsolver< V extends Addable< V >, U extends Addable >.clear ( )

See also: DPOPsolver.clear()

Reimplemented from frodo2.algorithms.dpop.DPOPsolver< V extends Addable< V >, U extends Addable >.

◆ getExpectedOptUtil()

UtilitySolutionSpace< V, U > frodo2.algorithms.dpop.param.ParamDPOPsolver< V extends Addable< V >, U extends Addable >.getExpectedOptUtil ( Document problem )

Solves the problem and returns the expectation over the random variables of the optimal utility.

Parameters

problem the problem

Returns: the expected optimal utility

Warning: This method will only work if the class used for utilities is AddableReal.

References frodo2.algorithms.AbstractSolver< DCOPProblemInterface< V, U >, V, U, S >.agentDesc, frodo2.solutionSpaces.UtilitySolutionSpace< V extends Addable< V >, U extends Addable >.expectation(), frodo2.algorithms.XCSPparser< V extends Addable< V >, U extends Addable >.getProbabilitySpaces(), frodo2.algorithms.AbstractSolver< DCOPProblemInterface< V, U >, V, U, S >.problem, and solveParam().

Referenced by frodo2.algorithms.dpop.stochastic.test.E_DPOPagentTest< V extends Addable< V > >.checkOutput().

Here is the call graph for this function:

◆ getSolGatherers()

ArrayList< StatsReporter > frodo2.algorithms.dpop.param.ParamDPOPsolver< V extends Addable< V >, U extends Addable >.getSolGatherers ( )

See also: DPOPsolver.getSolGatherers()

Reimplemented from frodo2.algorithms.dpop.DPOPsolver< V extends Addable< V >, U extends Addable >.

References frodo2.algorithms.dpop.DPOPsolver< V extends Addable< V >, U extends Addable >.dfsModule, frodo2.algorithms.AbstractSolver< DCOPProblemInterface< V, U >, V, U, S >.problem, frodo2.algorithms.AbstractSolver< DCOPProblemInterface< V, U >, V, U, S >.solGatherers, utilModule, and valueModule.

Referenced by solveParam().

◆ solveParam() [1/2]

ParamSolution< V, U > frodo2.algorithms.dpop.param.ParamDPOPsolver< V extends Addable< V >, U extends Addable >.solveParam ( DCOPProblemInterface< V, U > problem )