Package org.tweetyproject.preferences.ranking

Class LevelingFunction<T>

java.lang.Object

java.util.AbstractMap<T,Integer>

java.util.HashMap<T,Integer>

org.tweetyproject.preferences.ranking.Functions<T>

org.tweetyproject.preferences.ranking.LevelingFunction<T>

Type Parameters:

T - the generic type used for this leveling function

All Implemented Interfaces:

Serializable, Cloneable, Map<T,Integer>

public class LevelingFunction<T>
extends Functions<T>

This class is meant to provide leveling functions to given preference orders and vice versa. TODO exception handling for invalid preference orders (total preorder)

Author:

Bastian Wolf

See Also:

• Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class java.util.AbstractMap

AbstractMap.SimpleEntry<K,V>, AbstractMap.SimpleImmutableEntry<K,V>

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

Map.Entry<K,V>

Constructor Summary

Constructors

Constructor	Description
LevelingFunction()	constructs a new, empty leveling function caller can use Map-method putAll to fill this empty leveling function
LevelingFunction(PreferenceOrder<T> po)	this constructor creates a leveling function using a given preference order

Method Summary

Modifier and Type	Method	Description
PreferenceOrder<T>	generatePreferenceOrder()	this method returns a preference order made out of this leveling function
Map<T,Integer>	getLevelingFunction()	returns this leveling function
RankingFunction<T>	getRankingFunction()	returns a new RankingFunction based on this LevelingFunction
void	strengthenElement(T element)	strengthens the given element in the leveling function
void	weakenElement(T element)	weakens the given element in the leveling function

Methods inherited from class org.tweetyproject.preferences.ranking.Functions

containsKey, containsValue, get, getElementsByValue, getPredecessors, getSuccessors, toString, values

Methods inherited from class java.util.HashMap

clear, clone, compute, computeIfAbsent, computeIfPresent, entrySet, forEach, getOrDefault, isEmpty, keySet, merge, newHashMap, put, putAll, putIfAbsent, remove, remove, replace, replace, replaceAll, size

Methods inherited from class java.util.AbstractMap

equals, hashCode

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface java.util.Map

equals, hashCode

Constructor Details

LevelingFunction

public LevelingFunction()

constructs a new, empty leveling function caller can use Map-method putAll to fill this empty leveling function

LevelingFunction

public LevelingFunction(PreferenceOrder<T> po)

this constructor creates a leveling function using a given preference order

Parameters:

po - the given preference order

Method Details

getLevelingFunction

public Map<T,Integer> getLevelingFunction()

returns this leveling function

Overrides:

getLevelingFunction in class Functions<T>

Returns:

this leveling function

getRankingFunction

public RankingFunction<T> getRankingFunction()

returns a new RankingFunction based on this LevelingFunction

Returns:

a new RankingFunction based on this LevelingFunction

generatePreferenceOrder

public PreferenceOrder<T> generatePreferenceOrder()

this method returns a preference order made out of this leveling function

Specified by:

generatePreferenceOrder in class Functions<T>

Returns:

a preference order out of a given leveling function

weakenElement

public void weakenElement(T element)

weakens the given element in the leveling function

Specified by:

weakenElement in class Functions<T>

Parameters:

element - the element being weakened

strengthenElement

public void strengthenElement(T element)

strengthens the given element in the leveling function

Specified by:

strengthenElement in class Functions<T>

Parameters:

element - the element being strengthened