de.learnlib.oracle.equivalence.DisproveFirstOracle 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.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 to disprove all properties before finding a counter example to
* the given hypothesis.
*
* One may favor this implementation if refining a hypothesis is expensive compared to trying to disprove properties.
*
* @param
* the automaton type
* @param
* the input type
* @param
* the output type
*
* @author Jeroen Meijer
* @see CExFirstOracle
*/
@GenerateRefinement(name = "DFADisproveFirstOracle",
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"))
@GenerateRefinement(name = "MealyDisproveFirstOracle",
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"}))
public class DisproveFirstOracle, I, D> implements BlackBoxOracle {
private final List> propertyOracles;
public DisproveFirstOracle() {
this(Collections.emptyList());
}
public DisproveFirstOracle(PropertyOracle propertyOracle) {
this(Collections.singleton(propertyOracle));
}
public DisproveFirstOracle(Collection> propertyOracles) {
this.propertyOracles = new ArrayList<>(propertyOracles);
}
@Override
public List> getPropertyOracles() {
return propertyOracles;
}
@Override
public @Nullable DefaultQuery findCounterExample(A hypothesis, Collection inputs) {
for (PropertyOracle po : propertyOracles) {
if (!po.isDisproved()) {
po.disprove(hypothesis, inputs);
}
}
for (PropertyOracle po : propertyOracles) {
if (!po.isDisproved()) {
final DefaultQuery ce = po.doFindCounterExample(hypothesis, inputs);
if (ce != null) {
assert isCounterExample(hypothesis, ce.getInput(), ce.getOutput());
return ce;
}
}
}
return null;
}
}