de.learnlib.algorithms.lstar

Class AbstractAutomatonLStar<A,I,D,S,T,SP,TP,AI extends net.automatalib.automata.MutableDeterministic<S,I,T,SP,TP> & net.automatalib.automata.GrowableAlphabetAutomaton<I>>

java.lang.Object

de.learnlib.algorithms.lstar.AbstractLStar<A,I,D>

de.learnlib.algorithms.lstar.AbstractAutomatonLStar<A,I,D,S,T,SP,TP,AI>

Type Parameters:

A - automaton type, must be a subclass of MutableDeterministic

I - input symbol type

D - output domain type

SP - state property type

TP - transition property type

All Implemented Interfaces:

GlobalSuffixFeature<I>, GlobalSuffixLearner<A,I,D>, ResumableLearner<AutomatonLStarState<I,D,AI,S>>, SupportsGrowingAlphabet<I>, LearningAlgorithm<A,I,D>, ObservationTableFeature<I,D>, OTLearner<A,I,D>

Direct Known Subclasses:

AbstractExtensibleAutomatonLStar

public abstract class AbstractAutomatonLStar<A,I,D,S,T,SP,TP,AI extends net.automatalib.automata.MutableDeterministic<S,I,T,SP,TP> & net.automatalib.automata.GrowableAlphabetAutomaton<I>>
extends AbstractLStar<A,I,D>
implements ResumableLearner<AutomatonLStarState<I,D,AI,S>>

Abstract base class for algorithms that produce (subclasses of) MutableDeterministic automata.

This class provides the L*-style hypothesis construction. Implementing classes solely have to specify how state and transition properties should be derived.

Author:

Malte Isberner

Nested Class Summary

Nested classes/interfaces inherited from interface de.learnlib.datastructure.observationtable.OTLearner

OTLearner.OTLearnerDFA<I>, OTLearner.OTLearnerMealy<I,O>

Nested classes/interfaces inherited from interface de.learnlib.api.algorithm.feature.GlobalSuffixLearner

GlobalSuffixLearner.GlobalSuffixLearnerDFA<I>, GlobalSuffixLearner.GlobalSuffixLearnerMealy<I,O>

Nested classes/interfaces inherited from interface de.learnlib.api.algorithm.LearningAlgorithm

LearningAlgorithm.DFALearner<I>, LearningAlgorithm.MealyLearner<I,O>

Field Summary

Fields

Modifier and Type	Field and Description
protected AI	internalHyp
protected List<de.learnlib.algorithms.lstar.AbstractAutomatonLStar.StateInfo<S,I>>	stateInfos

Fields inherited from class de.learnlib.algorithms.lstar.AbstractLStar

alphabet, oracle, table

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	AbstractAutomatonLStar(net.automatalib.words.Alphabet<I> alphabet, MembershipOracle<I,D> oracle, AI internalHyp) Constructor.

Method Summary

Modifier and Type	Method and Description
void	addAlphabetSymbol(I symbol)
protected S	createState(boolean initial, Row<I> row)
protected void	doRefineHypothesis(DefaultQuery<I,D> ceQuery)
protected abstract A	exposeInternalHypothesis()
A	getHypothesisModel() Returns the current hypothesis model.
protected void	refineHypothesisInternal(DefaultQuery<I,D> ceQuery)
void	resume(AutomatonLStarState<I,D,AI,S> state) Does not get the learner to continue learning.
protected void	setTransition(S from, I input, S to, Row<I> fromRow, int inputIdx)
void	startLearning() Starts the model inference process, creating an initial hypothesis in the provided model object.
protected abstract SP	stateProperty(ObservationTable<I,D> table, Row<I> stateRow) Derives a state property from the corresponding row.
AutomatonLStarState<I,D,AI,S>	suspend() Expose the serializable learner state object.
protected abstract TP	transitionProperty(ObservationTable<I,D> table, Row<I> stateRow, int inputIdx) Derives a transition property from the corresponding transition.
protected void	updateInternalHypothesis() Performs the L*-style hypothesis construction.

Methods inherited from class de.learnlib.algorithms.lstar.AbstractLStar

addGlobalSuffixes, analyzeInconsistency, completeConsistentTable, getGlobalSuffixes, getObservationTable, hypothesisOutput, incorporateCounterExample, initialPrefixes, initialSuffixes, refineHypothesis, selectClosingRows

Methods inherited from class java.lang.Object

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

Field Detail

internalHyp

protected AI extends net.automatalib.automata.MutableDeterministic<S,I,T,SP,TP> & net.automatalib.automata.GrowableAlphabetAutomaton<I> internalHyp

stateInfos

protected List<de.learnlib.algorithms.lstar.AbstractAutomatonLStar.StateInfo<S,I>> stateInfos

Constructor Detail

AbstractAutomatonLStar

protected AbstractAutomatonLStar(net.automatalib.words.Alphabet<I> alphabet,
                                 MembershipOracle<I,D> oracle,
                                 AI internalHyp)

Constructor.

Parameters:

alphabet - the learning alphabet

oracle - the learning oracle

Method Detail

getHypothesisModel

public A getHypothesisModel()

Description copied from interface: LearningAlgorithm

Returns the current hypothesis model.

N.B.: By the contract of this interface, the model returned by this method may not be modified (i.e., M generally should refer to an immutable interface), and its validity is retained only until the next invocation of LearningAlgorithm.refineHypothesis(DefaultQuery). If older hypotheses have to be maintained, a copy of the returned model must be made.

Please note that it should be illegal to invoke this method before an initial invocation of LearningAlgorithm.startLearning().

Specified by:

getHypothesisModel in interface LearningAlgorithm<A,I,D>

Returns:

the current hypothesis model.

exposeInternalHypothesis

protected abstract A exposeInternalHypothesis()

startLearning

public final void startLearning()

Description copied from interface: LearningAlgorithm

Starts the model inference process, creating an initial hypothesis in the provided model object. Please note that it should be illegal to invoke this method twice.

Specified by:

startLearning in interface LearningAlgorithm<A,I,D>

Overrides:

startLearning in class AbstractLStar<A,I,D>

updateInternalHypothesis

protected void updateInternalHypothesis()

Performs the L*-style hypothesis construction. For creating states and transitions, the stateProperty(ObservationTable, Row) and transitionProperty(ObservationTable, Row, int) methods are used to derive the respective properties.

stateProperty

protected abstract SP stateProperty(ObservationTable<I,D> table,
                                    Row<I> stateRow)

Derives a state property from the corresponding row.

Parameters:

table - the current observation table

stateRow - the row for which the state is created

Returns:

the state property of the corresponding state

createState

protected S createState(boolean initial,
                        Row<I> row)

setTransition

protected void setTransition(S from,
                             I input,
                             S to,
                             Row<I> fromRow,
                             int inputIdx)

transitionProperty

protected abstract TP transitionProperty(ObservationTable<I,D> table,
                                         Row<I> stateRow,
                                         int inputIdx)

Derives a transition property from the corresponding transition.

N.B.: Not the transition row is passed to this method, but the row for the outgoing state. The transition row can be retrieved using Row.getSuccessor(int).

Parameters:

stateRow - the row for the source state

inputIdx - the index of the input symbol to consider

Returns:

the transition property of the corresponding transition

doRefineHypothesis

protected final void doRefineHypothesis(DefaultQuery<I,D> ceQuery)

Overrides:

doRefineHypothesis in class AbstractLStar<A,I,D>

refineHypothesisInternal

protected void refineHypothesisInternal(DefaultQuery<I,D> ceQuery)

addAlphabetSymbol

public void addAlphabetSymbol(I symbol)

Specified by:

addAlphabetSymbol in interface SupportsGrowingAlphabet<I>

Overrides:

addAlphabetSymbol in class AbstractLStar<A,I,D>

suspend

public AutomatonLStarState<I,D,AI,S> suspend()

Description copied from interface: ResumableLearner

Expose the serializable learner state object.

Does not stop a running learning process. Since most data structures that are used during learning are mutable, use this method inside of a learning loop with care.

Specified by:

suspend in interface ResumableLearner<AutomatonLStarState<I,D,AI extends net.automatalib.automata.MutableDeterministic<S,I,T,SP,TP> & net.automatalib.automata.GrowableAlphabetAutomaton<I>,S>>

Returns:

The learner state.

resume

public void resume(AutomatonLStarState<I,D,AI,S> state)

Description copied from interface: ResumableLearner

Does not get the learner to continue learning. Instead, the learner updates its internal state according to the given state object.

Specified by:

resume in interface ResumableLearner<AutomatonLStarState<I,D,AI extends net.automatalib.automata.MutableDeterministic<S,I,T,SP,TP> & net.automatalib.automata.GrowableAlphabetAutomaton<I>,S>>

Parameters:

state - The learner state.