de.learnlib.oracle.equivalence.CompleteExplorationEQOracle Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of learnlib-equivalence-oracles Show documentation
Show all versions of learnlib-equivalence-oracles Show documentation
A collection of equivalence oracles
/* Copyright (C) 2013-2018 TU Dortmund
* This file is part of LearnLib, http://www.learnlib.de/.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package de.learnlib.oracle.equivalence;
import java.util.Collection;
import java.util.stream.Stream;
import com.google.common.collect.Streams;
import de.learnlib.api.oracle.MembershipOracle;
import net.automatalib.automata.concepts.Output;
import net.automatalib.automata.fsa.DFA;
import net.automatalib.automata.transout.MealyMachine;
import net.automatalib.commons.util.collections.CollectionsUtil;
import net.automatalib.words.Word;
/**
* Implements an equivalence check by complete exploration up to a given depth, i.e., by testing all possible sequences
* of a certain length within a specified range.
*
* @param
* input symbol type
* @param
* output domain type
*
* @author Malte Isberner
*/
public class CompleteExplorationEQOracle extends AbstractTestWordEQOracle, I, D> {
private final int minDepth;
private final int maxDepth;
/**
* Constructor.
*
* @param sulOracle
* interface to the system under learning
* @param maxDepth
* maximum exploration depth
*/
public CompleteExplorationEQOracle(MembershipOracle sulOracle, int maxDepth) {
this(sulOracle, 1, maxDepth);
}
/**
* Constructor.
*
* @param sulOracle
* interface to the system under learning
* @param minDepth
* minimum exploration depth
* @param maxDepth
* maximum exploration depth
*/
public CompleteExplorationEQOracle(MembershipOracle sulOracle, int minDepth, int maxDepth) {
this(sulOracle, minDepth, maxDepth, 1);
}
/**
* Constructor.
*
* @param sulOracle
* interface to the system under learning
* @param minDepth
* minimum exploration depth
* @param maxDepth
* maximum exploration depth
* @param batchSize
* size of the batches sent to the membership oracle
*/
public CompleteExplorationEQOracle(MembershipOracle sulOracle, int minDepth, int maxDepth, int batchSize) {
super(sulOracle, batchSize);
this.minDepth = Math.min(minDepth, maxDepth);
this.maxDepth = Math.max(minDepth, maxDepth);
}
@Override
protected Stream> generateTestWords(Output hypothesis,
Collection inputs) {
return Streams.stream(CollectionsUtil.allTuples(inputs, minDepth, maxDepth)).map(Word::fromList);
}
public static class DFACompleteExplorationEQOracle
extends AbstractTestWordEQOracle, I, Boolean>
implements DFAEquivalenceOracle {
private final CompleteExplorationEQOracle delegate;
public DFACompleteExplorationEQOracle(MembershipOracle mqOracle,
int maxDepth) {
super(mqOracle);
this.delegate = new CompleteExplorationEQOracle<>(mqOracle, maxDepth);
}
public DFACompleteExplorationEQOracle(MembershipOracle mqOracle,
int minDepth,
int maxDepth) {
super(mqOracle);
this.delegate = new CompleteExplorationEQOracle<>(mqOracle, minDepth, maxDepth);
}
public DFACompleteExplorationEQOracle(MembershipOracle mqOracle,
int minDepth,
int maxDepth,
int batchSize) {
super(mqOracle, batchSize);
this.delegate = new CompleteExplorationEQOracle<>(mqOracle, minDepth, maxDepth, batchSize);
}
@Override
protected Stream> generateTestWords(DFA hypothesis,
Collection inputs) {
return delegate.generateTestWords(hypothesis, inputs);
}
}
public static class MealyCompleteExplorationEQOracle
extends AbstractTestWordEQOracle, I, Word>
implements MealyEquivalenceOracle {
private final CompleteExplorationEQOracle> delegate;
public MealyCompleteExplorationEQOracle(MembershipOracle> mqOracle,
int maxDepth) {
super(mqOracle);
this.delegate = new CompleteExplorationEQOracle<>(mqOracle, maxDepth);
}
public MealyCompleteExplorationEQOracle(MembershipOracle> mqOracle,
int minDepth,
int maxDepth) {
super(mqOracle);
this.delegate = new CompleteExplorationEQOracle<>(mqOracle,
minDepth, maxDepth);
}
public MealyCompleteExplorationEQOracle(MembershipOracle> mqOracle,
int minDepth,
int maxDepth,
int batchSize) {
super(mqOracle, batchSize);
this.delegate = new CompleteExplorationEQOracle<>(mqOracle, minDepth, maxDepth, batchSize);
}
@Override
protected Stream> generateTestWords(MealyMachine hypothesis,
Collection inputs) {
return delegate.generateTestWords(hypothesis, inputs);
}
}
}