Package org.tweetyproject.lp.asp.syntax

Class ChoiceHead

java.lang.Object

org.tweetyproject.lp.asp.syntax.ASPElement

org.tweetyproject.lp.asp.syntax.ASPHead

org.tweetyproject.lp.asp.syntax.ChoiceHead

All Implemented Interfaces:

Formula, ComplexLogicalFormula, LogicStructure, SimpleLogicalFormula

public class ChoiceHead
extends ASPHead

This class is a variant of the basic ASP rule head. It allows the usage of choice atoms as heads. Choice atoms consist of choice elements and a binary operator and term. ChoiceElement

Author:

Anna Gessler

Constructor Summary

Constructors

Constructor	Description
ChoiceHead(List<ChoiceElement> elements)
ChoiceHead(List<ChoiceElement> elements, ASPOperator.BinaryOperator rightOp, Term<?> rightTerm)
ChoiceHead(List<ChoiceElement> elements, ASPOperator.BinaryOperator leftOp, Term<?> leftTerm, ASPOperator.BinaryOperator rightOp, Term<?> rightTerm)
ChoiceHead(ChoiceElement e)
ChoiceHead(ChoiceElement e, ASPOperator.BinaryOperator rightOp, Term<?> rightTerm)

Method Summary

Modifier and Type	Method	Description
ChoiceHead	clone()	Creates a deep copy of this formula
boolean	equals(Object obj)
Set<ASPAtom>	getAtoms()	Processes the set of all atoms which appear in this formula
List<ChoiceElement>	getElements()	Return the choice elements of this choice atom
Term<?>	getLeftGuard()	Return the left guard (comparison term)
ASPOperator.BinaryOperator	getLeftOperator()	Return the left comparison operator.
SortedSet<ASPLiteral>	getLiterals()	Returns all literals in this element in form of a SortedSet.
Set<Predicate>	getPredicates()	Processes the set of all predicates which appear in this formula
Term<?>	getRightGuard()	Return the right guard (comparison term)
ASPOperator.BinaryOperator	getRightOperator()	Return the right comparison operator.
FolSignature	getSignature()	Returns the signature of the language of this formula.
Set<Term<?>>	getTerms()
<C extends Term<?>> Set<C>	getTerms(Class<C> cls)	Processes the set containing all terms of type C.
int	hashCode()
boolean	isEmpty()	Return true if the head is empty, false otherwise
boolean	isLiteral()
String	printToClingo()	Returns a representation of this ASP element in clingo (potassco) syntax.
String	printToDLV()	Returns a representation of this ASP element in DLV syntax.
void	setElements(List<ChoiceElement> elements)	Set the choice elements of this choice atom.
void	setLeftGuard(Term<?> leftTerm)	Set the left guard (comparison term)
void	setLeftOperator(ASPOperator.BinaryOperator leftOp)	Set the left comparison operator.
void	setRightGuard(Term<?> rightTerm)	Set the right guard (comparison term)
void	setRightOperator(ASPOperator.BinaryOperator rightOp)	Set the right comparison operator.
ASPElement	substitute(Term<?> t, Term<?> v)	Substitutes all occurrences of term "v" in this formula by term "t" and returns the new formula.
String	toString()

Methods inherited from class org.tweetyproject.lp.asp.syntax.ASPElement

containsTermsOfType, exchange, getPredicateCls, isGround, isWellFormed, substitute

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Constructor Details

ChoiceHead

public ChoiceHead(List<ChoiceElement> elements,
 ASPOperator.BinaryOperator leftOp,
 Term<?> leftTerm,
 ASPOperator.BinaryOperator rightOp,
 Term<?> rightTerm)

Parameters:

elements - list of ChoiceElements

leftOp - a BinaryOperator

leftTerm - left Term

rightOp - a BinaryOperator

rightTerm - right Term

ChoiceHead

public ChoiceHead(List<ChoiceElement> elements,
 ASPOperator.BinaryOperator rightOp,
 Term<?> rightTerm)

Parameters:

elements - list of ChoiceElements

rightOp - a BinaryOperator

rightTerm - right Term

ChoiceHead

public ChoiceHead(ChoiceElement e)

Parameters:

e - list of ChoiceElements

ChoiceHead

public ChoiceHead(List<ChoiceElement> elements)

Parameters:

elements - list of ChoiceElements

ChoiceHead

public ChoiceHead(ChoiceElement e,
 ASPOperator.BinaryOperator rightOp,
 Term<?> rightTerm)

Parameters:

e - a ChoiceElement

rightOp - a BinaryOperator

rightTerm - a term

Method Details

isLiteral

public boolean isLiteral()

Returns:

true if the formula represents a literal in the language or false otherwise

getTerms

public Set<Term<?>> getTerms()

Returns:

a set containing all terms of this logical structure

getTerms

public <C extends Term<?>> Set<C> getTerms(Class<C> cls)

Description copied from interface: LogicStructure

Processes the set containing all terms of type C. This method uses the equals method of the given Class and therefore does not add terms which are sub classes of type C to the set.

Type Parameters:

C - the type of terms

Parameters:

cls - The Class structure containing type information about the searched term

Returns:

A set containing all terms of type C of this logical structure

getPredicates

public Set<Predicate> getPredicates()

Description copied from interface: SimpleLogicalFormula

Processes the set of all predicates which appear in this formula

Specified by:

getPredicates in interface SimpleLogicalFormula

Specified by:

getPredicates in class ASPElement

Returns:

all predicates that appear in this formula

substitute

public ASPElement substitute(Term<?> t,
 Term<?> v)

Description copied from interface: ComplexLogicalFormula

Substitutes all occurrences of term "v" in this formula by term "t" and returns the new formula.

Specified by:

substitute in interface ComplexLogicalFormula

Specified by:

substitute in class ASPElement

Parameters:

t - the term to be substituted.

v - the term to substitute.

Returns:

a formula where every occurrence of "v" is replaced by "t".

getSignature

public FolSignature getSignature()

Description copied from interface: Formula

Returns the signature of the language of this formula.

Specified by:

getSignature in interface Formula

Specified by:

getSignature in class ASPElement

Returns:

the signature of the language of this formula.

getAtoms

public Set<ASPAtom> getAtoms()

Description copied from interface: SimpleLogicalFormula

Processes the set of all atoms which appear in this formula

Specified by:

getAtoms in interface SimpleLogicalFormula

Specified by:

getAtoms in class ASPElement

Returns:

The set of all atoms

clone

public ChoiceHead clone()

Description copied from interface: SimpleLogicalFormula

Creates a deep copy of this formula

Specified by:

clone in interface ComplexLogicalFormula

Specified by:

clone in interface SimpleLogicalFormula

Specified by:

clone in class ASPElement

Returns:

the cloned formula

isEmpty

public boolean isEmpty()

Description copied from class: ASPHead

Return true if the head is empty, false otherwise

Specified by:

isEmpty in class ASPHead

Returns:

true if the head is empty, false otherwise

getLiterals

public SortedSet<ASPLiteral> getLiterals()

Description copied from class: ASPHead

Returns all literals in this element in form of a SortedSet. Literals are atoms or strict negations of atoms.

Specified by:

getLiterals in class ASPHead

Returns:

all the literals used in the rule element

getElements

public List<ChoiceElement> getElements()

Return the choice elements of this choice atom

Returns:

the choice elements of this choice atom

setElements

public void setElements(List<ChoiceElement> elements)

Set the choice elements of this choice atom.

Parameters:

elements - the elements

getLeftOperator

public ASPOperator.BinaryOperator getLeftOperator()

Return the left comparison operator.

Returns:

the left comparison operator.

setLeftOperator

public void setLeftOperator(ASPOperator.BinaryOperator leftOp)

Set the left comparison operator.

Parameters:

leftOp - left operator

getRightOperator

public ASPOperator.BinaryOperator getRightOperator()

Return the right comparison operator.

Returns:

the right comparison operator.

setRightOperator

public void setRightOperator(ASPOperator.BinaryOperator rightOp)

Set the right comparison operator.

Parameters:

rightOp - Operation

getLeftGuard

public Term<?> getLeftGuard()

Return the left guard (comparison term)

Returns:

the left guard (comparison term)

setLeftGuard

public void setLeftGuard(Term<?> leftTerm)

Set the left guard (comparison term)

Parameters:

leftTerm - left term

getRightGuard

public Term<?> getRightGuard()

Return the right guard (comparison term)

Returns:

the right guard (comparison term)

setRightGuard

public void setRightGuard(Term<?> rightTerm)

Set the right guard (comparison term)

Parameters:

rightTerm - the right term

toString

public String toString()

Overrides:

toString in class Object

printToClingo

public String printToClingo()

Description copied from class: ASPElement

Returns a representation of this ASP element in clingo (potassco) syntax. See https://potassco.org/ for more information.

Overrides:

printToClingo in class ASPElement

Returns:

String representation in clingo syntax

printToDLV

public String printToDLV()

Description copied from class: ASPElement

Returns a representation of this ASP element in DLV syntax. See http://www.dlvsystem.com/html/DLV_User_Manual.html for more information.

Overrides:

printToDLV in class ASPElement

Returns:

String representation in DLV syntax

hashCode

public int hashCode()

Specified by:

hashCode in interface SimpleLogicalFormula

Overrides:

hashCode in class Object

equals

public boolean equals(Object obj)

Specified by:

equals in interface SimpleLogicalFormula

Overrides:

equals in class Object