include/dlvhex2/BaseModelGenerator.h

Go to the documentation of this file.

/* dlvhex -- Answer-Set Programming with external interfaces.
 * Copyright (C) 2005-2007 Roman Schindlauer
 * Copyright (C) 2006-2015 Thomas Krennwallner
 * Copyright (C) 2009-2016 Peter Schüller
 * Copyright (C) 2011-2016 Christoph Redl
 * Copyright (C) 2015-2016 Tobias Kaminski
 * Copyright (C) 2015-2016 Antonius Weinzierl
 *
 * This file is part of dlvhex.
 *
 * dlvhex is free software; you can redistribute it and/or modify it
 * under the terms of the GNU Lesser General Public License as
 * published by the Free Software Foundation; either version 2.1 of
 * the License, or (at your option) any later version.
 *
 * dlvhex is distributed in the hope that it will be useful, but
 * WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 * Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public
 * License along with dlvhex; if not, write to the Free Software
 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
 * 02110-1301 USA.
 */

#ifndef BASE_MODEL_GENERATOR_HPP_INCLUDED__09112010
#define BASE_MODEL_GENERATOR_HPP_INCLUDED__09112010

#include "dlvhex2/PlatformDefinitions.h"
#include "dlvhex2/fwd.h"
#include "dlvhex2/ModelGenerator.h"
#include "dlvhex2/Interpretation.h"
#include "dlvhex2/ASPSolverManager.h"
#include "dlvhex2/Atoms.h"
#include "dlvhex2/ID.h"
#include "dlvhex2/Registry.h"
#include "dlvhex2/Nogood.h"
#include "dlvhex2/GenuineSolver.h"
#include "dlvhex2/ComponentGraph.h"

#include <list>
#include "dlvhex2/CDNLSolver.h"

DLVHEX_NAMESPACE_BEGIN

class DLVHEX_EXPORT BaseModelGeneratorFactory:
public ModelGeneratorFactoryBase<Interpretation>
{
    // methods
    public:
        BaseModelGeneratorFactory() {}
        virtual ~BaseModelGeneratorFactory() {}

    protected:
        virtual ID convertRule(ProgramCtx& ctx, ID ruleid);
        virtual void convertRuleBody(ProgramCtx& ctx, const Tuple& body, Tuple& convbody);

        void addDomainPredicatesAndCreateDomainExplorationProgram(const ComponentGraph::ComponentInfo& ci, ProgramCtx& ctx, std::vector<ID>& idb, std::vector<ID>& deidb, std::vector<ID>& deidbInnerEatoms, const std::vector<ID>& outerEatoms);
};

class DLVHEX_EXPORT BaseModelGenerator:
public ModelGeneratorBase<Interpretation>
{
    friend class UnfoundedSetCheckerOld;
    friend class UnfoundedSetChecker;
    friend class EncodingBasedUnfoundedSetChecker;
    friend class AssumptionBasedUnfoundedSetChecker;
    // members
    public:
        BaseModelGenerator(InterpretationConstPtr input):
        ModelGeneratorBase<Interpretation>(input) {}
        virtual ~BaseModelGenerator() {}

    protected:
        //
        // ========== External Atom Evaluation Helpers ==========
        //

    public:
        struct ExternalAnswerTupleCallback
        {
            virtual ~ExternalAnswerTupleCallback();
            // boolean return values specifies whether to continue the process
            // (true = continue, false = abort)

            virtual bool eatom(const ExternalAtom& eatom) = 0;

            // encountering next input tuple
            virtual bool input(const Tuple& input) = 0;

            virtual bool output(const Tuple& output) = 0;
        };

        struct ExternalAnswerTupleMultiCallback:
    public ExternalAnswerTupleCallback
    {
        std::vector<ExternalAnswerTupleCallback*> callbacks;

        virtual ~ExternalAnswerTupleMultiCallback();
        virtual bool eatom(const ExternalAtom& eatom);
        virtual bool input(const Tuple& input);
        virtual bool output(const Tuple& output);
    };

    struct VerifyExternalAnswerAgainstPosNegGuessInterpretationCB:
    public ExternalAnswerTupleCallback
    {
        VerifyExternalAnswerAgainstPosNegGuessInterpretationCB(
            InterpretationPtr guess_pos,
            InterpretationPtr guess_neg);
        virtual ~VerifyExternalAnswerAgainstPosNegGuessInterpretationCB() {}
        // remembers eatom and prepares replacement.tuple[0]
        virtual bool eatom(const ExternalAtom& eatom);
        // remembers input
        virtual bool input(const Tuple& input);
        // creates replacement ogatom and activates respective bit in output interpretation
        virtual bool output(const Tuple& output);
        protected:
            RegistryPtr reg;
            InterpretationPtr guess_pos;
            InterpretationPtr guess_neg;
            ID pospred;
            ID negpred;
            OrdinaryAtom replacement;
    };

    struct VerifyExternalAtomCB:
    public ExternalAnswerTupleCallback
    {
        protected:
            const ExternalAtom& exatom;
            const ExternalAtomMask& eaMask;
            RegistryPtr reg;
            ID pospred;
            ID negpred;
            OrdinaryAtom replacement;
            InterpretationConstPtr guess;
            InterpretationPtr remainingguess;
            bool verified;
            ID falsified;

        public:
            bool onlyNegativeAuxiliaries();

            VerifyExternalAtomCB(InterpretationConstPtr guess, const ExternalAtom& exatom, const ExternalAtomMask& eaMask);
            virtual ~VerifyExternalAtomCB();
            // remembers eatom and prepares replacement.tuple[0]
            virtual bool eatom(const ExternalAtom& eatom);
            // remembers input
            virtual bool input(const Tuple& input);
            // creates replacement ogatom and activates respective bit in output interpretation
            virtual bool output(const Tuple& output);

            bool verify();

            ID getFalsifiedAtom();
    };

    struct IntegrateExternalAnswerIntoInterpretationCB:
    public ExternalAnswerTupleCallback
    {
        IntegrateExternalAnswerIntoInterpretationCB(
            InterpretationPtr outputi);
        virtual ~IntegrateExternalAnswerIntoInterpretationCB() {}
        // remembers eatom and prepares replacement.tuple[0]
        virtual bool eatom(const ExternalAtom& eatom);
        // remembers input
        virtual bool input(const Tuple& input);
        // creates replacement ogatom and activates respective bit in output interpretation
        virtual bool output(const Tuple& output);
        protected:
            RegistryPtr reg;
            InterpretationPtr outputi;
            OrdinaryAtom replacement;
    };

    protected:
        virtual bool evaluateExternalAtom(ProgramCtx& ctx,
            ID eatomID,
            InterpretationConstPtr inputi,
            ExternalAnswerTupleCallback& cb,
            NogoodContainerPtr nogoods = NogoodContainerPtr(),
            InterpretationConstPtr assigned = InterpretationConstPtr(),
            InterpretationConstPtr changed = InterpretationConstPtr(),
            bool* fromCache = 0) const;
        virtual bool evaluateExternalAtomQuery(
            PluginAtom::Query& query,
            ExternalAnswerTupleCallback& cb,
            NogoodContainerPtr nogoods,
            bool* fromCache = 0) const;

        virtual void learnSupportSetsForExternalAtom(ProgramCtx& ctx,
            ID eatomID,
            NogoodContainerPtr nogoods) const;

        virtual bool evaluateExternalAtoms(ProgramCtx& ctx,
            const std::vector<ID>& eatoms,
            InterpretationConstPtr inputi,
            ExternalAnswerTupleCallback& cb,
            NogoodContainerPtr nogoods = NogoodContainerPtr()) const;

        // helper methods used by evaluateExternalAtom

        virtual bool verifyEAtomAnswerTuple(RegistryPtr reg,
            const ExternalAtom& eatom, const Tuple& t) const;

        virtual InterpretationPtr projectEAtomInputInterpretation(RegistryPtr reg,
            const ExternalAtom& eatom, InterpretationConstPtr full) const;

        virtual void buildEAtomInputTuples(RegistryPtr reg,
            const ExternalAtom& eatom, InterpretationConstPtr i, InterpretationPtr inputs) const;

        InterpretationConstPtr computeExtensionOfDomainPredicates(const ComponentGraph::ComponentInfo& ci, ProgramCtx& ctx, InterpretationConstPtr edb, std::vector<ID>& deidb, std::vector<ID>& deidbInnerEatoms, bool enumerateNonmonotonic = true);
};

DLVHEX_NAMESPACE_END
#endif                           // BASE_MODEL_GENERATOR_HPP_INCLUDED__09112010

// vim:expandtab:ts=4:sw=4:
// mode: C++
// End: