Sacado_Fad_Expression.hpp

Go to the documentation of this file.

// $Id: Sacado_Fad_Expression.hpp,v 1.8 2007/02/22 22:09:33 dmgay Exp $ 
// $Source: /space/CVS/Trilinos/packages/sacado/src/Sacado_Fad_Expression.hpp,v $ 
// @HEADER
// ***********************************************************************
// 
//                           Sacado Package
//                 Copyright (2006) Sandia Corporation
// 
// Under the terms of Contract DE-AC04-94AL85000 with Sandia Corporation,
// the U.S. Government retains certain rights in this software.
// 
// 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.1 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; if not, write to the Free Software
// Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
// USA
// Questions? Contact David M. Gay (dmgay@sandia.gov) or Eric T. Phipps
// (etphipp@sandia.gov).
// 
// ***********************************************************************
//
// The forward-mode AD classes in Sacado are a derivative work of the
// expression template classes in the Fad package by Nicolas Di Cesare.  
// The following banner is included in the original Fad source code:
//
// ************ DO NOT REMOVE THIS BANNER ****************
//
//  Nicolas Di Cesare <Nicolas.Dicesare@ann.jussieu.fr>
//  http://www.ann.jussieu.fr/~dicesare
//
//            CEMRACS 98 : C++ courses, 
//         templates : new C++ techniques 
//            for scientific computing 
// 
//********************************************************
//
//  A short implementation ( not all operators and 
//  functions are overloaded ) of 1st order Automatic
//  Differentiation in forward mode (FAD) using
//  EXPRESSION TEMPLATES.
//
//********************************************************
// @HEADER

#ifndef SACADO_FAD_EXPRESSION_HPP
#define SACADO_FAD_EXPRESSION_HPP

#include "Sacado_Traits.hpp"

namespace Sacado {

  namespace Fad {


    template <typename ExprT> 
    class Expr {

    public:

      typedef typename ExprT::value_type value_type;

      explicit Expr(const ExprT& expr) : expr_(expr) {}

      int size() const {return expr_.size();}
      
      bool hasFastAccess() const { return expr_.hasFastAccess();}

      bool isPassive() const { return expr_.isPassive();}

      value_type val() const { return expr_.val();}

      value_type dx(int i) const { return expr_.dx(i);}

      value_type fastAccessDx(int i) const { return expr_.fastAccessDx(i);}
      
    protected:

      Expr() {}

      ExprT expr_;

    }; // class Expr


    template <typename ConstT> 
    class ConstExpr {

    public:

      typedef ConstT value_type;

      ConstExpr(const ConstT& constant) : constant_(constant) {}

      int size() const { return 0; }
      
      bool hasFastAccess() const { return true; }

      bool isPassive() const { return true; }

      value_type val() const { return constant_; }

      value_type dx(int i) const { return value_type(0); }
      
      value_type fastAccessDx(int i) const { return value_type(0); }

    protected:
      
      const ConstT& constant_;

    }; // class ConstExpr


    template <typename ExprT, template<typename> class Op> 
    class UnaryExpr {

    public:

      typedef typename ExprT::value_type value_type;
      typedef Op<ExprT> OpT;

      UnaryExpr(const ExprT& expr) : expr_(expr) {}

      int size() const { return expr_.size(); }
      
      bool hasFastAccess() const { return expr_.hasFastAccess(); }

      bool isPassive() const { return expr_.isPassive();}

      value_type val() const { return OpT::computeValue(expr_); }

      value_type dx(int i) const { return OpT::computeDx(i,expr_); }
      
      value_type fastAccessDx(int i) const { 
  return OpT::computeFastAccessDx(i,expr_); 
      }

    protected:
      
      const ExprT& expr_;

    }; // class UnaryExpr

    // The Sun compiler has difficulty with class partial specialization and
    // template templates, which the original BinaryExpr classes below use.
    // However the only significant difference between the specializations
    // of BinaryExpr for constant arguments is removing the reference
    // for the corresponding data member.  The type functions below allow
    // us to do this without specializing BinaryExpr.  We could also 
    // remove the template templates, but that drastically increases
    // compile times due to the increased length of template argument lists.
    template <typename T> struct ExprConstRef {
      typedef const T& type;
    };
    template <typename T> struct ExprConstRef< ConstExpr<T> > {
      typedef const ConstExpr<T> type;
    };


    template <typename ExprT1, typename ExprT2, 
        template<typename,typename> class Op> 
    class BinaryExpr {
    
    public:

      typedef typename ExprT1::value_type value_type_1;

      typedef typename ExprT2::value_type value_type_2;

      typedef typename Sacado::Promote<value_type_1,
               value_type_2>::type value_type;

      typedef Op<ExprT1,ExprT2> OpT;

      BinaryExpr(const ExprT1& expr1, const ExprT2& expr2) : 
  expr1_(expr1), expr2_(expr2) {}

      int size() const {
  int sz1 = expr1_.size(), sz2 = expr2_.size(); 
  return sz1 > sz2 ? sz1 : sz2;
      }
      
      bool hasFastAccess() const { 
  return expr1_.hasFastAccess() && expr2_.hasFastAccess();}

      bool isPassive() const { 
  return expr1_.isPassive() && expr2_.isPassive();}

      value_type val() const { 
  return OpT::computeValue(expr1_,expr2_); }

      value_type dx(int i) const { 
  return OpT::computeDx(i,expr1_,expr2_); }
      
      value_type fastAccessDx(int i) const { 
  return OpT::computeFastAccessDx(i,expr1_,expr2_); 
      }

    protected:
      
      typename ExprConstRef<ExprT1>::type expr1_;

      typename ExprConstRef<ExprT2>::type expr2_;

    }; // class BinaryExpr

  } // namespace Fad

} // namespace Sacado

#endif // SACADO_FAD_EXPRESSION_HPP

---