Prev Next atomic_get_started.cpp

@(@\newcommand{\W}[1]{ \; #1 \; } \newcommand{\R}[1]{ {\rm #1} } \newcommand{\B}[1]{ {\bf #1} } \newcommand{\D}[2]{ \frac{\partial #1}{\partial #2} } \newcommand{\DD}[3]{ \frac{\partial^2 #1}{\partial #2 \partial #3} } \newcommand{\Dpow}[2]{ \frac{\partial^{#1}}{\partial {#2}^{#1}} } \newcommand{\dpow}[2]{ \frac{ {\rm d}^{#1}}{{\rm d}\, {#2}^{#1}} }@)@
Getting Started with Atomic Operations: Example and Test

Purpose
This example demonstrates the minimal amount of information necessary for a atomic_base operation.

Start Class Definition
# include <cppad/cppad.hpp>
namespace {          // isolate items below to this file
using CppAD::vector; // abbreviate as vector
class atomic_get_started : public CppAD::atomic_base<double> {

Constructor
public:
     // constructor (could use const char* for name)
     atomic_get_started(const std::string& name) :
     // this example does not use any sparsity patterns
     CppAD::atomic_base<double>(name)
     { }
private:

forward
     // forward mode routine called by CppAD
     virtual bool forward(
          size_t                    p ,
          size_t                    q ,
          const vector<bool>&      vx ,
                vector<bool>&      vy ,
          const vector<double>&    tx ,
                vector<double>&    ty
     )
     {
# ifndef NDEBUG
          size_t n = tx.size() / (q + 1);
          size_t m = ty.size() / (q + 1);
# endif
          assert( n == 1 );
          assert( m == 1 );

          // return flag
          bool ok = q == 0;
          if( ! ok )
               return ok;

          // check for defining variable information
          // This case must always be implemented
          if( vx.size() > 0 )
               vy[0] = vx[0];

          // Order zero forward mode.
          // This case must always be implemented
          // y^0 = f( x^0 ) = 1 / x^0
          double f = 1. / tx[0];
          if( p <= 0 )
               ty[0] = f;
          return ok;
     }

End Class Definition

}; // End of atomic_get_started class
}  // End empty namespace

Use Atomic Function
bool get_started(void)
{     bool ok = true;
     using CppAD::AD;
     using CppAD::NearEqual;
     double eps = 10. * CppAD::numeric_limits<double>::epsilon();

Constructor

     // Create the atomic get_started object
     atomic_get_started afun("atomic_get_started");

Recording
     // Create the function f(x)
     //
     // domain space vector
     size_t n  = 1;
     double  x0 = 0.5;
     vector< AD<double> > ax(n);
     ax[0]     = x0;

     // declare independent variables and start tape recording
     CppAD::Independent(ax);

     // range space vector
     size_t m = 1;
     vector< AD<double> > ay(m);

     // call user function and store get_started(x) in au[0]
     vector< AD<double> > au(m);
     afun(ax, au);        // u = 1 / x

     // now use AD division to invert to invert the operation
     ay[0] = 1.0 / au[0]; // y = 1 / u = x

     // create f: x -> y and stop tape recording
     CppAD::ADFun<double> f;
     f.Dependent (ax, ay);  // f(x) = x

forward
     // check function value
     double check = x0;
     ok &= NearEqual( Value(ay[0]) , check,  eps, eps);

     // check zero order forward mode
     size_t q;
     vector<double> x_q(n), y_q(m);
     q      = 0;
     x_q[0] = x0;
     y_q    = f.Forward(q, x_q);
     ok &= NearEqual(y_q[0] , check,  eps, eps);

     return ok;
}

Input File: example/atomic/get_started.cpp