ConformerGenerator.hpp

Go to the documentation of this file.

/* 
 * ConformerGenerator.hpp 
 *
 * This file is part of the Chemical Data Processing Toolkit
 *
 * Copyright (C) 2003 Thomas Seidel <thomas.seidel@univie.ac.at>
 *
 * This library 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 of the License, or (at your option) any later version.
 *
 * This library 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 this library; see the file COPYING. If not, write to
 * the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
 * Boston, MA 02111-1307, USA.
 */
 
#ifndef CDPL_CONFGEN_CONFORMERGENERATOR_HPP
#define CDPL_CONFGEN_CONFORMERGENERATOR_HPP
 
#include <memory>
 
#include <boost/iterator/indirect_iterator.hpp>
 
#include "CDPL/ConfGen/APIPrefix.hpp"
#include "CDPL/ConfGen/ConformerDataArray.hpp"
#include "CDPL/ConfGen/CallbackFunction.hpp"
#include "CDPL/ConfGen/LogMessageCallbackFunction.hpp"
#include "CDPL/ConfGen/ConformerGeneratorSettings.hpp"
#include "CDPL/ConfGen/FragmentLibrary.hpp"
#include "CDPL/ConfGen/TorsionLibrary.hpp"
 
 
namespace CDPL
{
 
    namespace Chem
    {
 
        class MolecularGraph;
    }
 
    namespace ConfGen
    {
 
        class ConformerGeneratorImpl;
 
        class CDPL_CONFGEN_API ConformerGenerator
        {
 
          public:
            typedef boost::indirect_iterator<ConformerDataArray::const_iterator, const ConformerData> ConstConformerIterator;
            typedef boost::indirect_iterator<ConformerDataArray::const_iterator, ConformerData>       ConformerIterator;
 
            ConformerGenerator();
 
            ~ConformerGenerator();
 
            const ConformerGeneratorSettings& getSettings() const;
 
            ConformerGeneratorSettings& getSettings();
 
            void clearFragmentLibraries();
 
            void addFragmentLibrary(const FragmentLibrary::SharedPointer& lib);
 
            void clearTorsionLibraries();
 
            void addTorsionLibrary(const TorsionLibrary::SharedPointer& lib);
 
            void setAbortCallback(const CallbackFunction& func);
 
            const CallbackFunction& getAbortCallback() const;
 
            void setTimeoutCallback(const CallbackFunction& func);
 
            const CallbackFunction& getTimeoutCallback() const;
 
            void setLogMessageCallback(const LogMessageCallbackFunction& func);
 
            const LogMessageCallbackFunction& getLogMessageCallback() const;
 
            unsigned int generate(const Chem::MolecularGraph& molgraph);
 
            /*
             * \since 1.1
             */
            unsigned int generate(const Chem::MolecularGraph& molgraph, const Chem::MolecularGraph& fixed_substr);
 
            /*
             * \since 1.1
             */
            unsigned int generate(const Chem::MolecularGraph& molgraph, const Chem::MolecularGraph& fixed_substr,
                                  const Math::Vector3DArray& fixed_substr_coords);
 
            void setConformers(Chem::MolecularGraph& molgraph) const;
 
            std::size_t getNumConformers() const;
 
            const ConformerData& getConformer(std::size_t idx) const;
 
            ConformerData& getConformer(std::size_t idx);
 
            ConstConformerIterator getConformersBegin() const;
 
            ConstConformerIterator getConformersEnd() const;
 
            ConformerIterator getConformersBegin();
 
            ConformerIterator getConformersEnd();
 
            ConstConformerIterator begin() const;
 
            ConstConformerIterator end() const;
 
            ConformerIterator begin();
 
            ConformerIterator end();
 
          private:
            ConformerGenerator(const ConformerGenerator&);
 
            ConformerGenerator& operator=(const ConformerGenerator&);
 
            typedef std::unique_ptr<ConformerGeneratorImpl> ImplementationPointer;
 
            ImplementationPointer impl;
        };
    } // namespace ConfGen
} // namespace CDPL
 
#endif // CDPL_CONFGEN_CONFORMERGENERATOR_HPP