de.learnlib.oracle.equivalence.CExFirstOracle Maven / Gradle / Ivy
Show all versions of learnlib-equivalence-oracles Show documentation
/* Copyright (C) 2013-2020 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.ArrayList;
import java.util.Collection;
import java.util.Collections;
import java.util.List;
import de.learnlib.api.oracle.BlackBoxOracle;
import de.learnlib.api.oracle.BlackBoxOracle.DFABlackBoxOracle;
import de.learnlib.api.oracle.BlackBoxOracle.MealyBlackBoxOracle;
import de.learnlib.api.oracle.EquivalenceOracle.DFAEquivalenceOracle;
import de.learnlib.api.oracle.EquivalenceOracle.MealyEquivalenceOracle;
import de.learnlib.api.oracle.PropertyOracle;
import de.learnlib.api.oracle.PropertyOracle.DFAPropertyOracle;
import de.learnlib.api.oracle.PropertyOracle.MealyPropertyOracle;
import de.learnlib.api.query.DefaultQuery;
import de.learnlib.buildtool.refinement.annotation.GenerateRefinement;
import de.learnlib.buildtool.refinement.annotation.Generic;
import de.learnlib.buildtool.refinement.annotation.Interface;
import de.learnlib.buildtool.refinement.annotation.Map;
import net.automatalib.automata.concepts.Output;
import net.automatalib.automata.fsa.DFA;
import net.automatalib.automata.transducers.MealyMachine;
import net.automatalib.words.Word;
import org.checkerframework.checker.nullness.qual.Nullable;
/**
* The strategy of this black-box oracle is to first try out a property, to see if it can be disproved. If it can not be
* disproved it tries the same property to find a counter example to the hypothesis, before continuing with the next
* property.
*
* This implementation may be used when refining a hypothesis is inexpensive compared to disproving propertyOracles.
*
* @param
* the automaton type
* @param
* the input type
* @param
* the output type
*
* @author Jeroen Meijer
* @see DisproveFirstOracle
*/
@GenerateRefinement(name = "DFACExFirstOracle",
generics = "I",
parentGenerics = {@Generic(clazz = DFA.class, generics = {"?", "I"}),
@Generic("I"),
@Generic(clazz = Boolean.class)},
parameterMapping = @Map(from = PropertyOracle.class,
to = DFAPropertyOracle.class,
withGenerics = {"I", "?"}),
interfaces = {@Interface(clazz = DFABlackBoxOracle.class, generics = "I"),
@Interface(clazz = DFAEquivalenceOracle.class, generics = "I")})
@GenerateRefinement(name = "MealyCExFirstOracle",
generics = {"I", "O"},
parentGenerics = {@Generic(clazz = MealyMachine.class, generics = {"?", "I", "?", "O"}),
@Generic("I"),
@Generic(clazz = Word.class, generics = "O")},
parameterMapping = @Map(from = PropertyOracle.class,
to = MealyPropertyOracle.class,
withGenerics = {"I", "O", "?"}),
interfaces = {@Interface(clazz = MealyBlackBoxOracle.class, generics = {"I", "O"}),
@Interface(clazz = MealyEquivalenceOracle.class, generics = {"I", "O"})})
public class CExFirstOracle, I, D> implements BlackBoxOracle {
private final List> propertyOracles;
public CExFirstOracle() {
this(Collections.emptySet());
}
public CExFirstOracle(PropertyOracle propertyOracle) {
this(Collections.singleton(propertyOracle));
}
public CExFirstOracle(Collection> propertyOracles) {
this.propertyOracles = new ArrayList<>(propertyOracles);
}
@Override
public List> getPropertyOracles() {
return propertyOracles;
}
@Override
public @Nullable DefaultQuery findCounterExample(A hypothesis, Collection inputs) {
for (PropertyOracle propertyOracle : propertyOracles) {
final DefaultQuery result = propertyOracle.findCounterExample(hypothesis, inputs);
if (result != null) {
assert isCounterExample(hypothesis, result.getInput(), result.getOutput());
return result;
}
}
return null;
}
}