org.linqs.psl.database.atom

Class LazyAtomManager

java.lang.Object

org.linqs.psl.database.atom.AtomManager

org.linqs.psl.database.atom.PersistedAtomManager

org.linqs.psl.database.atom.LazyAtomManager

public class LazyAtomManager
extends PersistedAtomManager

A persisted atom manager that will keep track of atoms that it returns, but that don't actually exist (lazy atoms). If activateAtoms() is called, then all lazy atoms above the activation threshold (set by the ACTIVATION_THRESHOLD_KEY configuration option) will be instantiated as real atoms.

Nested Class Summary

Nested classes/interfaces inherited from class org.linqs.psl.database.atom.PersistedAtomManager

PersistedAtomManager.PersistedAccessException

Field Summary

Fields

Modifier and Type	Field and Description
static double	ACTIVATION_THRESHOLD_DEFAULT Default value for ACTIVATION_THRESHOLD_KEY property.
static String	ACTIVATION_THRESHOLD_KEY The minimum value an atom must take for it to be activated.
static String	CONFIG_PREFIX Prefix of property keys used by this class.

Fields inherited from class org.linqs.psl.database.atom.PersistedAtomManager

persistedCache, THROW_ACCESS_EXCEPTION_DEFAULT, THROW_ACCESS_EXCEPTION_KEY

Fields inherited from class org.linqs.psl.database.atom.AtomManager

db

Constructor Summary

Constructors

Constructor and Description
LazyAtomManager(Database db)

Method Summary

Modifier and Type	Method and Description
int	activateAtoms(List<Rule> rules, GroundRuleStore groundRuleStore) Activate any lazy atoms above the threshold.
int	activateAtoms(Set<RandomVariableAtom> atoms, List<Rule> rules, GroundRuleStore groundRuleStore) Activate a specific set of lazy atoms.
int	countActivatableAtoms() Compute the number of lazy atoms that can be activated at this moment.
GroundAtom	getAtom(Predicate predicate, Constant... arguments) Returns the GroundAtom for the given Predicate and GroundTerms.
Set<RandomVariableAtom>	getLazyAtoms()

Methods inherited from class org.linqs.psl.database.atom.PersistedAtomManager

addToPersistedCache, commitPersistedAtoms, getPersistedRVAtoms

Methods inherited from class org.linqs.psl.database.atom.AtomManager

executeGroundingQuery, executeQuery, getDatabase, isClosed

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

CONFIG_PREFIX

public static final String CONFIG_PREFIX

Prefix of property keys used by this class.

See Also:

Constant Field Values

ACTIVATION_THRESHOLD_KEY

public static final String ACTIVATION_THRESHOLD_KEY

The minimum value an atom must take for it to be activated. Must be a flot in (0,1].

See Also:

Constant Field Values

ACTIVATION_THRESHOLD_DEFAULT

public static final double ACTIVATION_THRESHOLD_DEFAULT

Default value for ACTIVATION_THRESHOLD_KEY property.

See Also:

Constant Field Values

Constructor Detail

LazyAtomManager

public LazyAtomManager(Database db)

Method Detail

getAtom

public GroundAtom getAtom(Predicate predicate,
                          Constant... arguments)

Description copied from class: AtomManager

Returns the GroundAtom for the given Predicate and GroundTerms. This method must call ReadableDatabase.getAtom(Predicate, Constant...) to actually retrieve the GroundAtom.

Overrides:

getAtom in class PersistedAtomManager

Parameters:

predicate - the Predicate of the Atom

arguments - the GroundTerms of the Atom

Returns:

the Atom

getLazyAtoms

public Set<RandomVariableAtom> getLazyAtoms()

countActivatableAtoms

public int countActivatableAtoms()

Compute the number of lazy atoms that can be activated at this moment.

activateAtoms

public int activateAtoms(List<Rule> rules,
                         GroundRuleStore groundRuleStore)

Activate any lazy atoms above the threshold.

Parameters:

rules - the potential rules to look for lazy atoms in.

Returns:

the number of lazy atoms instantiated.

activateAtoms

public int activateAtoms(Set<RandomVariableAtom> atoms,
                         List<Rule> rules,
                         GroundRuleStore groundRuleStore)

Activate a specific set of lazy atoms. Any passed in atom that is not part of this manager's lazy atom set will be ignored.

Returns:

the number of lazy atoms instantiated.