Metric.h 4.32 KB
Newer Older
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38
///////////////////////////////////////////////////////////////////////////////
//
// File: Metric.h
//
// For more information, please see: http://www.nektar.info
//
// The MIT License
//
// Copyright (c) 2006 Division of Applied Mathematics, Brown University (USA),
// Department of Aeronautics, Imperial College London (UK), and Scientific
// Computing and Imaging Institute, University of Utah (USA).
//
// License for the specific language governing rights and limitations under
// Permission is hereby granted, free of charge, to any person obtaining a
// copy of this software and associated documentation files (the "Software"),
// to deal in the Software without restriction, including without limitation
// the rights to use, copy, modify, merge, publish, distribute, sublicense,
// and/or sell copies of the Software, and to permit persons to whom the
// Software is furnished to do so, subject to the following conditions:
//
// The above copyright notice and this permission notice shall be included
// in all copies or substantial portions of the Software.
//
// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
// OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
// THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
// DEALINGS IN THE SOFTWARE.
//
// Description: Definition of the metric base class.
//
///////////////////////////////////////////////////////////////////////////////

#ifndef NEKTAR_TESTS_METRIC_H
#define NEKTAR_TESTS_METRIC_H

39
#include <tinyxml.h>
40
#include <string>
41
#include <map>
42
#include <boost/filesystem.hpp>
43
#include <exception>
44

45 46 47 48 49 50 51
struct TesterException : public std::runtime_error
{
    TesterException(const std::string &msg) : std::runtime_error(msg) {}
};

#define ASSERTL0(condition, msg) \
    if (!(condition)) { throw TesterException(msg); }
52

53 54 55
namespace fs = boost::filesystem;

std::string PortablePath(const boost::filesystem::path& path);
56 57

namespace Nektar
58
{
59 60 61 62 63 64 65 66 67 68 69 70 71

    /**
     * @brief Check to see whether the given string @p s is empty (or null).
     */
    inline bool EmptyString(const char *s)
    {
        if (!s)
        {
            return true;
        }
        return std::string(s) == "";
    }

72 73 74
    class Metric
    {
    public:
75
        Metric(TiXmlElement *metric, bool generate);
76
        
77
        /// Perform the test, given the standard output and error streams
78 79 80
        bool Test     (std::istream& pStdout, std::istream& pStderr);
        /// Perform the test, given the standard output and error streams
        void Generate (std::istream& pStdout, std::istream& pStderr);
81 82 83 84 85 86 87 88 89 90
        /// Return metric type
        std::string GetType()
        {
            return m_type;
        }
        /// Return metric ID
        int GetID()
        {
            return m_id;
        }
91 92
        
    protected:
93
        /// Stores the ID of this metric.
94
        int m_id;
95 96
        /// Stores the type of this metric (uppercase).
        std::string m_type;
97
        /// Determines whether to generate this metric or not.
98
        bool m_generate;
99
        /// Pointer to XML structure containing metric definition.
100
        TiXmlElement *m_metric;
101
        
102 103 104 105
        virtual bool v_Test     (std::istream& pStdout, 
                                 std::istream& pStderr) = 0;
        virtual void v_Generate (std::istream& pStdout, 
                                 std::istream& pSrderr) = 0;
106 107 108
    };

    /// A shared pointer to an EquationSystem object
109
    typedef std::shared_ptr<Metric> MetricSharedPtr;
110

111 112
    /// Datatype of the NekFactory used to instantiate classes derived from the
    /// Advection class.
113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131
    struct MetricFactory
    {
        typedef MetricSharedPtr (*CreatorFunction)(TiXmlElement *, bool);

        std::string RegisterCreatorFunction(std::string key, CreatorFunction func)
        {
            m_map[key] = func;
            return key;
        }

        MetricSharedPtr CreateInstance(
            std::string key, TiXmlElement *elmt, bool generate)
        {
            return m_map[key](elmt, generate);
        }

    private:
        std::map<std::string, CreatorFunction> m_map;
    };
132

133
    MetricFactory& GetMetricFactory();
134
}
135

136

137
#endif