scalar_ode.h

Go to the documentation of this file.

//-----------------------------------------------------------------------bl-
//--------------------------------------------------------------------------
//
// GRINS - General Reacting Incompressible Navier-Stokes
//
// Copyright (C) 2014-2017 Paul T. Bauman, Roy H. Stogner
// Copyright (C) 2010-2013 The PECOS Development Team
//
// This library is free software; you can redistribute it and/or
// modify it under the terms of the Version 2.1 GNU Lesser General
// Public License as published by the Free Software Foundation.
//
// 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. 51 Franklin Street, Fifth Floor,
// Boston, MA  02110-1301  USA
//
//-----------------------------------------------------------------------el-


#ifndef GRINS_SCALAR_ODE_H
#define GRINS_SCALAR_ODE_H

// GRINS
#include "grins_config.h"
#include "grins/assembly_context.h"
#include "grins/cached_values.h"
#include "grins/inc_navier_stokes_base.h"


// libMesh
#include "libmesh/fem_system.h"
#include "libmesh/getpot.h"

// C++
#include <string>

namespace GRINS
{

  /*
    This physics class allows ODEs specified in ParsedFEMFunction
    config file arguments to be solved.
  */
  class ScalarODE : public Physics
  {
  public:

    ScalarODE( const std::string& physics_name, const GetPot& input );

    ~ScalarODE(){};

    virtual void set_time_evolving_vars( libMesh::FEMSystem * system );

    virtual void init_context( AssemblyContext & context );

    // residual and jacobian calculations

    // User-specified ODE(s)
    virtual void nonlocal_time_derivative ( bool compute_jacobian,
                                            AssemblyContext & context );

    // User-specified constraint equation
    virtual void nonlocal_constraint ( bool compute_jacobian,
                                       AssemblyContext & context );

    // User-specified (or default "s'") mass term
    virtual void nonlocal_mass_residual ( bool compute_jacobian,
                                          AssemblyContext & context );

    VariableIndex scalar_ode_var() const
    { return _var.var(); }

  private:

    // ParsedFEMFunctions evaluating the mass, time derivative, and
    // constraint components of an ODE.
    libMesh::UniquePtr<libMesh::FEMFunctionBase<libMesh::Number> >
    time_deriv_function,
      constraint_function,
      mass_residual_function;

    // Perturbation to use for finite differencing of functions
    libMesh::Number _epsilon;

    const GetPot & _input;

    ScalarVariable& _var;

    ScalarODE();

    void read_input_options( const GetPot& input );
  };

} // end namespace block

#endif // GRINS_SCALAR_ODE_H