Package org.tweetyproject.arg.rankings.semantics

Class NumericalArgumentRanking

java.lang.Object

org.tweetyproject.commons.AbstractInterpretation<T,Argument>

org.tweetyproject.arg.dung.semantics.AbstractArgumentationInterpretation<DungTheory>

org.tweetyproject.arg.rankings.semantics.ArgumentRanking

org.tweetyproject.arg.rankings.semantics.NumericalArgumentRanking

All Implemented Interfaces:

Comparator<Argument>, Map<Argument,Double>, Interpretation<DungTheory,Argument>

public class NumericalArgumentRanking
extends ArgumentRanking
implements Map<Argument,Double>

This class provides an acceptability interpretation of arguments by assigning them real values. Often larger values indicate more acceptability, but some semantics use other ways of ranking the values.

Author:

Matthias Thimm, Anna Gessler

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static enum	NumericalArgumentRanking.SortingType	Possible sorting types for the numerical values.

Nested classes/interfaces inherited from interface java.util.Map

Map.Entry<K extends Object,V extends Object>

Field Summary

Fields

Modifier and Type	Field	Description
static double	PRECISION	Precision for comparing values.
NumericalArgumentRanking.SortingType	sortingType	The method used for ordering the numerical values according to acceptability.

Constructor Summary

Constructors

Constructor	Description
NumericalArgumentRanking()	Creates a new empty numerical argument ranking.
NumericalArgumentRanking(Collection<Argument> args, double initialvalue)	Creates a new argument ranking with the given set of arguments and the given initial ranking value.

Method Summary

Modifier and Type	Method	Description
void	clear()
boolean	containsIncomparableArguments()
boolean	containsKey(Object arg0)
boolean	containsValue(Object arg0)
Set<Map.Entry<Argument,Double>>	entrySet()
Double	get(Object arg0)
Extension	getArgumentsOfStatus(ArgumentStatus status)	Returns all arguments that have the given status in this interpretation.
NumericalArgumentRanking.SortingType	getSortingType()
boolean	isEmpty()
boolean	isIncomparable(Argument a, Argument b)	Returns "true" iff a and b are incomparable (i.e.
boolean	isStrictlyLessOrEquallyAcceptableThan(Argument a, Argument b)	Returns "true" iff a is strictly less acceptable than b or a is equally acceptable as b or a and b are not comparable, i.e.
Set<Argument>	keySet()
Double	put(Argument arg0, Double arg1)
void	putAll(Map<? extends Argument,? extends Double> arg0)
Double	remove(Object arg0)
void	setSortingType(NumericalArgumentRanking.SortingType sortingType)	Set the sorting type for ranking values.
int	size()
String	toString()
Collection<Double>	values()

Methods inherited from class org.tweetyproject.arg.rankings.semantics.ArgumentRanking

compare, getMaximallyAcceptedArguments, getMinimallyAcceptedArguments, isEquallyAcceptableThan, isEquivalent, isStrictlyLessAcceptableThan, isStrictlyMoreAcceptableThan, isStrictlyMoreOrEquallyAcceptableThan

Methods inherited from class org.tweetyproject.arg.dung.semantics.AbstractArgumentationInterpretation

satisfies, satisfies

Methods inherited from class org.tweetyproject.commons.AbstractInterpretation

satisfies

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface java.util.Comparator

equals, reversed, thenComparing, thenComparing, thenComparing, thenComparingDouble, thenComparingInt, thenComparingLong

Methods inherited from interface java.util.Map

compute, computeIfAbsent, computeIfPresent, equals, forEach, getOrDefault, hashCode, merge, putIfAbsent, remove, replace, replace, replaceAll

Field Details

PRECISION

public static double PRECISION

Precision for comparing values.

sortingType

public NumericalArgumentRanking.SortingType sortingType

The method used for ordering the numerical values according to acceptability.

Constructor Details

NumericalArgumentRanking

public NumericalArgumentRanking()

Creates a new empty numerical argument ranking.

NumericalArgumentRanking

public NumericalArgumentRanking(Collection<Argument> args,
 double initialvalue)

Creates a new argument ranking with the given set of arguments and the given initial ranking value.

Parameters:

args - some set of arguments

initialvalue - an initial value that will be assigned to all arguments

Method Details

isStrictlyLessOrEquallyAcceptableThan

public boolean isStrictlyLessOrEquallyAcceptableThan(Argument a,
 Argument b)

Description copied from class: ArgumentRanking

Returns "true" iff a is strictly less acceptable than b or a is equally acceptable as b or a and b are not comparable, i.e. a >= b (or a ~ b) (least arguments are maximally acceptable arguments)

Specified by:

isStrictlyLessOrEquallyAcceptableThan in class ArgumentRanking

Parameters:

a - some argument

b - some argument

Returns:

"true" iff a is strictly less acceptable than b or a is equally acceptable as b

getArgumentsOfStatus

public Extension getArgumentsOfStatus(ArgumentStatus status)

Description copied from class: AbstractArgumentationInterpretation

Returns all arguments that have the given status in this interpretation.

Specified by:

getArgumentsOfStatus in class AbstractArgumentationInterpretation<DungTheory>

Parameters:

status - the status of the arguments to be returned.

Returns:

the set of arguments with the given status.

toString

public String toString()

Specified by:

toString in class AbstractArgumentationInterpretation<DungTheory>

clear

public void clear()

Specified by:

clear in interface Map<Argument,Double>

containsKey

public boolean containsKey(Object arg0)

Specified by:

containsKey in interface Map<Argument,Double>

containsValue

public boolean containsValue(Object arg0)

Specified by:

containsValue in interface Map<Argument,Double>

entrySet

public Set<Map.Entry<Argument,Double>> entrySet()

Specified by:

entrySet in interface Map<Argument,Double>

get

public Double get(Object arg0)

Specified by:

get in interface Map<Argument,Double>

isEmpty

public boolean isEmpty()

Specified by:

isEmpty in interface Map<Argument,Double>

keySet

public Set<Argument> keySet()

Specified by:

keySet in interface Map<Argument,Double>

put

public Double put(Argument arg0,
 Double arg1)

Specified by:

put in interface Map<Argument,Double>

putAll

public void putAll(Map<? extends Argument,? extends Double> arg0)

Specified by:

putAll in interface Map<Argument,Double>

remove

public Double remove(Object arg0)

Specified by:

remove in interface Map<Argument,Double>

size

public int size()

Specified by:

size in interface Map<Argument,Double>

values

public Collection<Double> values()

Specified by:

values in interface Map<Argument,Double>

getSortingType

public NumericalArgumentRanking.SortingType getSortingType()

Returns:

the sorting type that is used for ranking values (descending, ascending or sorted lexicographically)

setSortingType

public void setSortingType(NumericalArgumentRanking.SortingType sortingType)

Set the sorting type for ranking values. For example, the "ascending" type means that smaller values signify a higher ranking than bigger values.

Parameters:

sortingType - see sortingType for a description of the available sorting methods

isIncomparable

public boolean isIncomparable(Argument a,
 Argument b)

Description copied from class: ArgumentRanking

Returns "true" iff a and b are incomparable (i.e. this ranking is a partial ranking).

Specified by:

isIncomparable in class ArgumentRanking

Parameters:

a - Argument

b - Argument

Returns:

"true" iff a and b are incomparable

containsIncomparableArguments

public boolean containsIncomparableArguments()

Specified by:

containsIncomparableArguments in class ArgumentRanking

Returns:

true if this ranking contains incomparable arguments, false otherwise