net.automatalib.incremental.mealy.dag

Class IncrementalMealyDAGBuilder<I,O>

java.lang.Object

net.automatalib.incremental.mealy.AbstractIncrementalMealyBuilder<I,O>

net.automatalib.incremental.mealy.dag.IncrementalMealyDAGBuilder<I,O>

Type Parameters:

I - input symbol class

O - output symbol class

All Implemented Interfaces:

IncrementalConstruction<MealyMachine<?,I,?,O>,I>, IncrementalMealyBuilder<I,O>

public class IncrementalMealyDAGBuilder<I,O>
extends AbstractIncrementalMealyBuilder<I,O>

Incrementally builds an (acyclic) Mealy machine, from a set of input and corresponding output words.

Author:

Malte Isberner

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
class	IncrementalMealyDAGBuilder.AutomatonView
class	IncrementalMealyDAGBuilder.GraphView

Nested classes/interfaces inherited from class net.automatalib.incremental.mealy.AbstractIncrementalMealyBuilder

AbstractIncrementalMealyBuilder.AbstractGraphView<I,O,N,E>, AbstractIncrementalMealyBuilder.AbstractTransitionSystemView<I,O,S,T>

Nested classes/interfaces inherited from interface net.automatalib.incremental.mealy.IncrementalMealyBuilder

IncrementalMealyBuilder.TransitionSystemView<I,O,S,T>

Field Summary

Fields inherited from class net.automatalib.incremental.mealy.AbstractIncrementalMealyBuilder

inputAlphabet

Constructor Summary

Constructors

Constructor and Description
IncrementalMealyDAGBuilder(Alphabet<I> inputAlphabet) Constructor.

Method Summary

Methods

Modifier and Type	Method and Description
IncrementalMealyDAGBuilder.GraphView	asGraph() Retrieves a graph view of the current state of the construction.
IncrementalMealyDAGBuilder.AutomatonView	asTransitionSystem() Retrieves a transition system view of the current state of the construction.
Word<I>	findSeparatingWord(MealyMachine<?,I,?,O> target, Collection<? extends I> inputs, boolean omitUndefined) Checks the current state of the construction against a given target model, and returns a word exposing a difference if there is one.
boolean	hasDefinitiveInformation(Word<? extends I> word) Checks whether this class has definitive information about a given word.
void	insert(Word<? extends I> word, Word<? extends O> outputWord) Incorporates a pair of input/output words into the stored information.
boolean	isComplete(Word<? extends I> word) Deprecated. since 2014-01-22. Use hasDefinitiveInformation(Word)
boolean	lookup(Word<? extends I> word, List<? super O> output) Retrieves the output word for the given input word.

Methods inherited from class net.automatalib.incremental.mealy.AbstractIncrementalMealyBuilder

getInputAlphabet, lookup

Methods inherited from class java.lang.Object

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

Constructor Detail

IncrementalMealyDAGBuilder

public IncrementalMealyDAGBuilder(Alphabet<I> inputAlphabet)

Constructor.

Parameters:

inputAlphabet - the input alphabet to use

Method Detail

isComplete

@Deprecated
public boolean isComplete(Word<? extends I> word)

Deprecated. since 2014-01-22. Use hasDefinitiveInformation(Word)

Checks whether there exists secured information about the output for the given word.

Parameters:

word - the input word

Returns:

a boolean indicating whether information about the output for the given input word exists.

hasDefinitiveInformation

public boolean hasDefinitiveInformation(Word<? extends I> word)

Description copied from interface: IncrementalConstruction

Checks whether this class has definitive information about a given word.

Specified by:

hasDefinitiveInformation in interface IncrementalConstruction<MealyMachine<?,I,?,O>,I>

Overrides:

hasDefinitiveInformation in class AbstractIncrementalMealyBuilder<I,O>

Parameters:

word - the word

Returns:

true if this class has definitive information about the word, false otherwise.

lookup

public boolean lookup(Word<? extends I> word,
             List<? super O> output)

Retrieves the output word for the given input word. If no definitive information for the input word exists, the output for the longest known prefix will be returned.

Parameters:

word - the input word

output - a WordBuilder for constructing the output word

Returns:

true if the information contained was complete (in this case, word.length() == output.size() will hold), false otherwise.

insert

public void insert(Word<? extends I> word,
          Word<? extends O> outputWord)

Incorporates a pair of input/output words into the stored information.

Parameters:

word - the input word

outputWord - the corresponding output word

Throws:

ConflictException - if this information conflicts with information already stored

asGraph

public IncrementalMealyDAGBuilder.GraphView asGraph()

Description copied from interface: IncrementalConstruction

Retrieves a graph view of the current state of the construction. The graph model should be backed by the construction, i.e., subsequent changes will be reflected in the graph model.

Returns:

a graph view on the current state of the construction

asTransitionSystem

public IncrementalMealyDAGBuilder.AutomatonView asTransitionSystem()

Description copied from interface: IncrementalConstruction

Retrieves a transition system view of the current state of the construction. The transition system model should be backed by the construction, i.e., subsequent changes will be reflected in the transition system.

Returns:

a transition system view on the current state of the construction

findSeparatingWord

public Word<I> findSeparatingWord(MealyMachine<?,I,?,O> target,
                         Collection<? extends I> inputs,
                         boolean omitUndefined)

Description copied from interface: IncrementalConstruction

Checks the current state of the construction against a given target model, and returns a word exposing a difference if there is one.

Parameters:

target - the target automaton model

inputs - the set of input symbols to consider

omitUndefined - if this is set to true, then undefined transitions in the target model will be interpreted as "unspecified/don't know" and omitted in the equivalence test. Otherwise, they will be interpreted in the usual manner (e.g., non-accepting sink in case of DFAs).

Returns:

a separating word, or null if no difference could be found.