This is a solver that reads in the problem, creates the agents, runs the problem and then collects the statistics . More...

Inheritance diagram for frodo2.algorithms.localSearch.dsa.DSAsolver< V extends Addable< V >, U extends Addable >:

[legend]

Public Member Functions
	DSAsolver ()
	Constructor.
	DSAsolver (boolean useTCP)
	Constructor.
	DSAsolver (Class< V > domClass, Class< U > utilClass)
	Constructor.
	DSAsolver (Class< V > domClass, Class< U > utilClass, boolean useTCP)
	Constructor.
	DSAsolver (String agentDesc)
	Constructor.
	DSAsolver (String agentDesc, boolean useTCP)
	Constructor.
	DSAsolver (String agentDescFile, Class< V > domClass, Class< U > utilClass)
	Constructor.
	DSAsolver (String agentDescFile, Class< V > domClass, Class< U > utilClass, boolean useTCP)
	Constructor.
	DSAsolver (Document agentDesc)
	Constructor.
	DSAsolver (Document agentDesc, boolean useTCP)
	Constructor.
	DSAsolver (String variant, String conflictCost, double p, boolean sync, int maxRounds) throws JDOMException, IOException
	Constructor.
	DSAsolver (boolean measureTime, boolean useTCP, boolean measureMsgs, Class< ? extends XCSPparser< V, U > > parserClass, Class< V > domClass, Class< U > utilClass, String variant, String conflictCost, double p, boolean sync, int maxRounds)
	Constructor.
void	setConvergence (boolean convergence)
	Sets the convergence parameter to the desired value.
ArrayList< StatsReporter >	getSolGatherers ()
SolutionWithConvergence< V, U >	buildSolution ()
void	clear ()
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.

Protected Member Functions
void	parseParams (String[] params)
String	getParamsHeader ()
String	getParamsToLine ()
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	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.
	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
DSA< V, U >	dsaModule
	The DSA module.
SolutionCollector< V, U >	solCollector
	The SolutionCollector 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.

Private Member Functions
Element	getElement (Element modules)
	Looks up the Element for the DSA module in the agent configuration file.

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.

Detailed Description

This is a solver that reads in the problem, creates the agents, runs the problem and then collects the statistics .

Author: Brammert Ottens, Thomas Leaute

Parameters

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

Constructor & Destructor Documentation

◆ DSAsolver() [1/12]

frodo2.algorithms.localSearch.dsa.DSAsolver< V extends Addable< V >, U extends Addable >.DSAsolver ( )

Constructor.

◆ DSAsolver() [2/12]

frodo2.algorithms.localSearch.dsa.DSAsolver< V extends Addable< V >, U extends Addable >.DSAsolver ( boolean useTCP )

Constructor.

Parameters

useTCP Whether to use TCP pipes or shared memory pipes

Warning: Using TCP pipes automatically disables simulated time.

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

◆ DSAsolver() [3/12]

frodo2.algorithms.localSearch.dsa.DSAsolver< V extends Addable< V >, U extends Addable< U > >.DSAsolver	(	Class< V >	domClass,
		Class< U >	utilClass )

Constructor.

Parameters

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

References frodo2.algorithms.AbstractSolver< DCOPProblemInterface< V, U >, V, U, S >.setDomClass(), and frodo2.algorithms.AbstractSolver< DCOPProblemInterface< V, U >, V, U, S >.setUtilClass().

Here is the call graph for this function:

◆ DSAsolver() [4/12]

frodo2.algorithms.localSearch.dsa.DSAsolver< V extends Addable< V >, U extends Addable< U > >.DSAsolver	(	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 or shared memory pipes

Warning: Using TCP pipes automatically disables simulated time.

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

Here is the call graph for this function:

◆ DSAsolver() [5/12]

frodo2.algorithms.localSearch.dsa.DSAsolver< V extends Addable< V >, U extends Addable >.DSAsolver ( String agentDesc )

Constructor.

Parameters

agentDesc path to the agent description file

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

◆ DSAsolver() [6/12]

frodo2.algorithms.localSearch.dsa.DSAsolver< V extends Addable< V >, U extends Addable< U > >.DSAsolver	(	String	agentDesc,
		boolean	useTCP )

Constructor.

Parameters

agentDesc	path to the agent description file
useTCP	Whether to use TCP pipes or shared memory pipes

Warning: Using TCP pipes automatically disables simulated time.

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

◆ DSAsolver() [7/12]

frodo2.algorithms.localSearch.dsa.DSAsolver< V extends Addable< V >, U extends Addable< U > >.DSAsolver	(	String	agentDescFile,
		Class< V >	domClass,
		Class< U >	utilClass )

Constructor.

Parameters

agentDescFile	description of the agent to be used
domClass	the class to be used for variable values
utilClass	the class to be used for utility values

References frodo2.algorithms.AbstractSolver< DCOPProblemInterface< V, U >, V, U, S >.setDomClass(), and frodo2.algorithms.AbstractSolver< DCOPProblemInterface< V, U >, V, U, S >.setUtilClass().

Here is the call graph for this function:

◆ DSAsolver() [8/12]

frodo2.algorithms.localSearch.dsa.DSAsolver< V extends Addable< V >, U extends Addable< U > >.DSAsolver	(	String	agentDescFile,
		Class< V >	domClass,
		Class< U >	utilClass,
		boolean	useTCP )

Constructor.

Parameters

agentDescFile	description of the agent to be used
domClass	the class to be used for variable values
utilClass	the class to be used for utility values
useTCP	Whether to use TCP pipes or shared memory pipes

Warning: Using TCP pipes automatically disables simulated time.

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

Here is the call graph for this function:

◆ DSAsolver() [9/12]

frodo2.algorithms.localSearch.dsa.DSAsolver< V extends Addable< V >, U extends Addable >.DSAsolver ( Document agentDesc )

Constructor.

Parameters

agentDesc description of the agent to be used

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

◆ DSAsolver() [10/12]

frodo2.algorithms.localSearch.dsa.DSAsolver< V extends Addable< V >, U extends Addable< U > >.DSAsolver	(	Document	agentDesc,
		boolean	useTCP )

Constructor.

Parameters

agentDesc	description of the agent to be used
useTCP	Whether to use TCP pipes or shared memory pipes

Warning: Using TCP pipes automatically disables simulated time.

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

◆ DSAsolver() [11/12]

frodo2.algorithms.localSearch.dsa.DSAsolver< V extends Addable< V >, U extends Addable< U > >.DSAsolver	(	String	variant,
		String	conflictCost,
		double	p,
		boolean	sync,
		int	maxRounds ) throws JDOMException, IOException

Constructor.

Parameters

variant	"A", "B", "C", "D" or "E"
conflictCost	the cost of a conflict
p	the probability of change
sync	whether to run synchronously
maxRounds	the maximum number of rounds

Exceptions

IOException	if the agent configuration file cannot be opened
JDOMException	if a parsing error occurred

References parseParams().

Here is the call graph for this function:

◆ DSAsolver() [12/12]

frodo2.algorithms.localSearch.dsa.DSAsolver< V extends Addable< V >, U extends Addable< U > >.DSAsolver	(	boolean	measureTime,
		boolean	useTCP,
		boolean	measureMsgs,
		Class< ? extends XCSPparser< V, U > >	parserClass,
		Class< V >	domClass,
		Class< U >	utilClass,
		String	variant,
		String	conflictCost,
		double	p,
		boolean	sync,
		int	maxRounds )

Constructor.

Parameters

measureTime	whether to measure simulated time
useTCP	whether to use TCP pipes instead of shared memory (if true, disables the simulated time metric)
measureMsgs	whether to measure messages
parserClass	The class of the parser to be used
domClass	the class of variable values
utilClass	the class of utility values
variant	"A", "B", "C", "D" or "E"
conflictCost	the cost of a conflict
p	the probability of change
sync	whether to run synchronously
maxRounds	the maximum number of rounds