Package org.tweetyproject.logics.fol.syntax

Class ExistsQuantifiedFormula

java.lang.Object

org.tweetyproject.logics.commons.syntax.RelationalFormula

org.tweetyproject.logics.fol.syntax.FolFormula

org.tweetyproject.logics.fol.syntax.ExistsQuantifiedFormula

All Implemented Interfaces:

Formula, ClassicalFormula, ComplexLogicalFormula, Conjunctable, Disjunctable, Invertable, LogicStructure, ProbabilityAware, QuantifiedFormula, SimpleLogicalFormula

public class ExistsQuantifiedFormula
extends FolFormula

Exists-quantified first-order logic formula. Delegates to QuantifiedFormulaSupport for shared functionalities with other quantified formulas.

Author:

Matthias Thimm, Anna Gessler

Constructor Summary

Constructors

Constructor	Description
ExistsQuantifiedFormula(RelationalFormula folFormula, Set<Variable> variables)	Creates a new quantified folFormula with the given folFormula and variables.
ExistsQuantifiedFormula(RelationalFormula folFormula, Variable variable)	Creates a new quantified folFormula with the given folFormula and variable.
ExistsQuantifiedFormula(ExistsQuantifiedFormula other)	Formula to be constructed

Method Summary

Modifier and Type	Method	Description
ExistsQuantifiedFormula	clone()	Creates a deep copy of this formula
FolFormula	collapseAssociativeFormulas()	This method collapses all associative operations appearing in this term, e.g.
boolean	containsQuantifier()	Checks whether this formula contains any quantification.
boolean	equals(Object obj)
Set<FolAtom>	getAtoms()	Processes the set of all atoms which appear in this formula
FolFormula	getFormula()	returns formula
Set<Functor>	getFunctors()
Set<? extends Predicate>	getPredicates()	Processes the set of all predicates which appear in this formula
Set<FolFormula>	getQuantifiedFormulas()	Return quantified formulas
Set<Variable>	getQuantifierVariables()	returns all variables
Set<Term<?>>	getTerms()
<C extends Term<?>> Set<C>	getTerms(Class<C> cls)	Processes the set containing all terms of type C.
Set<Variable>	getUnboundVariables()
boolean	isClosed()	Checks whether this formula is closed, i.e.
boolean	isClosed(Set<Variable> boundVariables)	Checks whether this formula is closed, i.e.
boolean	isDnf()	Checks whether this formula is in disjunctive normal form.
boolean	isLiteral()
boolean	isWellBound()	Checks whether this formula is well-bound, i.e.
boolean	isWellBound(Set<Variable> boundVariables)	Checks whether this formula is well-bound, i.e.
void	setFormula(FolFormula formula)	set formula
void	setQuantifierVariables(Set<Variable> variables)	sets variables
ExistsQuantifiedFormula	substitute(Term<?> v, Term<?> t)	Substitutes all occurrences of term "v" in this formula by term "t" and returns the new formula.
FolFormula	toNnf()	Makes the negation normal form of this formula.
String	toString()

Methods inherited from class org.tweetyproject.logics.fol.syntax.FolFormula

combineWithAnd, combineWithOr, complement, getSignature, getUniformProbability, toDnf

Methods inherited from class org.tweetyproject.logics.commons.syntax.RelationalFormula

allGroundInstances, allSubstitutions, containsTermsOfType, exchange, getPredicateCls, getSatisfactionRatio, isGround, isWellFormed, substitute

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.tweetyproject.logics.commons.syntax.interfaces.SimpleLogicalFormula

hashCode

Constructor Details

ExistsQuantifiedFormula

public ExistsQuantifiedFormula(RelationalFormula folFormula,
 Set<Variable> variables)

Creates a new quantified folFormula with the given folFormula and variables.

Parameters:

folFormula - the folFormula this quantified folFormula ranges over.

variables - the variables of this quantified folFormula.

ExistsQuantifiedFormula

public ExistsQuantifiedFormula(RelationalFormula folFormula,
 Variable variable)

Creates a new quantified folFormula with the given folFormula and variable.

Parameters:

folFormula - the folFormula this quantified folFormula ranges over.

variable - the variable of this quantified folFormula.

ExistsQuantifiedFormula

public ExistsQuantifiedFormula(ExistsQuantifiedFormula other)

Formula to be constructed

Parameters:

other - formula to be constructed

Method Details

getQuantifiedFormulas

public Set<FolFormula> getQuantifiedFormulas()

Return quantified formulas

Returns:

formulas

equals

public boolean equals(Object obj)

Specified by:

equals in interface SimpleLogicalFormula

Overrides:

equals in class Object

toNnf

public FolFormula toNnf()

Description copied from class: FolFormula

Makes the negation normal form of this formula.

Specified by:

toNnf in class FolFormula

Returns:

the NNF of this formula

collapseAssociativeFormulas

public FolFormula collapseAssociativeFormulas()

Description copied from class: FolFormula

This method collapses all associative operations appearing in this term, e.g. every a||(b||c) becomes a||b||c.

Specified by:

collapseAssociativeFormulas in class FolFormula

Returns:

the collapsed formula.

substitute

public ExistsQuantifiedFormula substitute(Term<?> v,
 Term<?> t)
                                   throws IllegalArgumentException

Description copied from class: RelationalFormula

Substitutes all occurrences of term "v" in this formula by term "t" and returns the new formula. NOTE: if "v" is a variable and bound to a quantifier then "v" is not substituted in that quantifiers inner formula.

Specified by:

substitute in interface ComplexLogicalFormula

Specified by:

substitute in class FolFormula

Parameters:

v - the term to be substituted.

t - the term to substitute.

Returns:

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

Throws:

IllegalArgumentException - if "v" and "t" are of different sorts (NOTE: this exception is only thrown when "v" actually appears in this formula).

toString

public String toString()

Specified by:

toString in class RelationalFormula

clone

public ExistsQuantifiedFormula 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 FolFormula

Returns:

the cloned formula

getFormula

public FolFormula getFormula()

returns formula

Specified by:

getFormula in interface QuantifiedFormula

Overrides:

getFormula in class RelationalFormula

Returns:

the relational formula

getQuantifierVariables

public Set<Variable> getQuantifierVariables()

returns all variables

Specified by:

getQuantifierVariables in interface QuantifiedFormula

Overrides:

getQuantifierVariables in class FolFormula

Returns:

a set containing all quantified variables

setFormula

public void setFormula(FolFormula formula)

set formula

Parameters:

formula - formulas to be set

setQuantifierVariables

public void setQuantifierVariables(Set<Variable> variables)

sets variables

Parameters:

variables - variables to be set

getAtoms

public Set<FolAtom> 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 RelationalFormula

Returns:

all atoms that appear in this formula.

getFunctors

public Set<Functor> getFunctors()

Specified by:

getFunctors in class RelationalFormula

Returns:

all functors that appear in this formula.

isDnf

public boolean isDnf()

Description copied from class: FolFormula

Checks whether this formula is in disjunctive normal form.

Specified by:

isDnf in class FolFormula

Returns:

"true" iff this formula is in disjunctive normal form.

getPredicates

public Set<? extends Predicate> getPredicates()

Description copied from interface: SimpleLogicalFormula

Processes the set of all predicates which appear in this formula

Returns:

all predicates that appear in this formula

isLiteral

public boolean isLiteral()

Returns:

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

getUnboundVariables

public Set<Variable> getUnboundVariables()

Returns:

a set of of unbound variables

containsQuantifier

public boolean containsQuantifier()

Description copied from interface: QuantifiedFormula

Checks whether this formula contains any quantification.

Returns:

"true" if this formula contains a quantification.

isWellBound

public boolean isWellBound()

Description copied from interface: QuantifiedFormula

Checks whether this formula is well-bound, i.e. whether no variable bound by a quantifier is again bound by another quantifier within the first quantifier's range.

Returns:

"true" if this formula is well-bound, "false" otherwise.

isWellBound

public boolean isWellBound(Set<Variable> boundVariables)

Description copied from interface: QuantifiedFormula

Checks whether this formula is well-bound, i.e. whether no variable bound by a quantifier is again bound by another quantifier within the first quantifier range. Every variable in "boundVariables" is assumed to be bound already.

Parameters:

boundVariables - the variables assumed to be bound.

Returns:

"true" if this formula is well-bound, "false" otherwise.

isClosed

public boolean isClosed()

Description copied from interface: QuantifiedFormula

Checks whether this formula is closed, i.e. whether every variables occurring in the formula is bound by a quantifier.

Returns:

"true" if this formula is closed, "false" otherwise.

isClosed

public boolean isClosed(Set<Variable> boundVariables)

Description copied from interface: QuantifiedFormula

Checks whether this formula is closed, i.e. whether every variables occurring in the formula is bound by a quantifier. Every variable in "boundVariables" is already assumed to be bound.

Parameters:

boundVariables - the variables assumed to be bound.

Returns:

"true" if this formula is closed wrt. "boundVariables", "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