parsed_fem_function.h

Go to the documentation of this file.

// The libMesh Finite Element Library.
// Copyright (C) 2002-2026 Benjamin S. Kirk, John W. Peterson, Roy H. Stogner
 
// 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
 
 
 
#ifndef LIBMESH_PARSED_FEM_FUNCTION_H
#define LIBMESH_PARSED_FEM_FUNCTION_H
 
#include "libmesh/libmesh_config.h"
 
// Local Includes
#include "libmesh/fem_function_base.h"
#include "libmesh/int_range.h"
#include "libmesh/point.h"
#include "libmesh/system.h"
 
#ifdef LIBMESH_HAVE_FPARSER
// FParser includes
#include "libmesh/fparser.hh"
#endif
 
// C++ includes
#include <cctype>
#include <iomanip>
#include <sstream>
#include <string>
#include <vector>
#include <memory>
 
namespace libMesh
{
 
template <typename Output=Number>
class ParsedFEMFunction : public FEMFunctionBase<Output>
{
public:
 
  explicit
  ParsedFEMFunction (const System & sys,
                     std::string expression,
                     const std::vector<std::string> * additional_vars=nullptr,
                     const std::vector<Output> * initial_vals=nullptr);
 
  ParsedFEMFunction & operator= (const ParsedFEMFunction &);
  ParsedFEMFunction & operator= (ParsedFEMFunction &&) = delete;
  ParsedFEMFunction (const ParsedFEMFunction &);
  ParsedFEMFunction (ParsedFEMFunction &&) = default;
  virtual ~ParsedFEMFunction () = default;
 
  void reparse (std::string expression);
 
  virtual void init_context (const FEMContext & c) override;
 
  virtual std::unique_ptr<FEMFunctionBase<Output>> clone () const override;
 
  virtual Output operator() (const FEMContext & c,
                             const Point & p,
                             const Real time = 0.) override;
 
  void operator() (const FEMContext & c,
                   const Point & p,
                   const Real time,
                   DenseVector<Output> & output) override;
 
  virtual Output component(const FEMContext & c,
                           unsigned int i,
                           const Point & p,
                           Real time=0.) override;
 
  const std::string & expression() { return _expression; }
 
  Output get_inline_value(std::string_view inline_var_name) const;
 
  void set_inline_value(std::string_view inline_var_name,
                        Output newval);
 
protected:
  // Helper function for reparsing minor changes to expression
  void partial_reparse (std::string expression);
 
  // Helper function for parsing out variable names
  std::size_t find_name (std::string_view varname,
                         std::string_view expr) const;
 
  // Helper function for evaluating function arguments
  void eval_args(const FEMContext & c,
                 const Point & p,
                 const Real time);
 
  // Evaluate the ith FunctionParser and check the result
#ifdef LIBMESH_HAVE_FPARSER
  inline Output eval(FunctionParserBase<Output> & parser,
                     std::string_view libmesh_dbg_var(function_name),
                     unsigned int libmesh_dbg_var(component_idx)) const;
#else // LIBMESH_HAVE_FPARSER
  inline Output eval(char & libmesh_dbg_var(parser),
                     std::string_view libmesh_dbg_var(function_name),
                     unsigned int libmesh_dbg_var(component_idx)) const;
#endif
 
private:
  const System & _sys;
  std::string _expression;
  std::vector<std::string> _subexpressions;
  unsigned int _n_vars,
    _n_requested_vars,
    _n_requested_grad_components,
    _n_requested_hess_components;
  bool _requested_normals;
#ifdef LIBMESH_HAVE_FPARSER
  std::vector<std::unique_ptr<FunctionParserBase<Output>>> parsers;
#else
  std::vector<char*> parsers;
#endif
  std::vector<Output> _spacetime;
 
  // Flags for which variables need to be computed
 
  // _need_var[v] is true iff value(v) is needed
  std::vector<bool> _need_var;
 
  // _need_var_grad[v*LIBMESH_DIM+i] is true iff grad(v,i) is needed
  std::vector<bool> _need_var_grad;
 
#ifdef LIBMESH_ENABLE_SECOND_DERIVATIVES
  // _need_var_hess[v*LIBMESH_DIM*LIBMESH_DIM+i*LIBMESH_DIM+j] is true
  // iff grad(v,i,j) is needed
  std::vector<bool> _need_var_hess;
#endif // LIBMESH_ENABLE_SECOND_DERIVATIVES
 
  // Variables/values that can be parsed and handled by the function parser
  std::string variables;
  std::vector<std::string> _additional_vars;
  std::vector<Output> _initial_vals;
};
 
 
/*----------------------- Inline functions ----------------------------------*/
 
template <typename Output>
inline
ParsedFEMFunction<Output>::ParsedFEMFunction (const System & sys,
                                              std::string expression,
                                              const std::vector<std::string> * additional_vars,
                                              const std::vector<Output> * initial_vals) :
  _sys(sys),
  _expression (), // overridden by parse()
  _n_vars(sys.n_vars()),
  _n_requested_vars(0),
  _n_requested_grad_components(0),
  _n_requested_hess_components(0),
  _requested_normals(false),
  _need_var(_n_vars, false),
  _need_var_grad(_n_vars*LIBMESH_DIM, false),
#ifdef LIBMESH_ENABLE_SECOND_DERIVATIVES
  _need_var_hess(_n_vars*LIBMESH_DIM*LIBMESH_DIM, false),
#endif // LIBMESH_ENABLE_SECOND_DERIVATIVES
  _additional_vars (additional_vars ? *additional_vars : std::vector<std::string>()),
  _initial_vals (initial_vals ? *initial_vals : std::vector<Output>())
{
  this->reparse(std::move(expression));
}
 
 
template <typename Output>
inline
ParsedFEMFunction<Output>::ParsedFEMFunction (const ParsedFEMFunction<Output> & other) :
  FEMFunctionBase<Output>(other),
  _sys(other._sys),
  _expression(other._expression),
  _subexpressions(other._subexpressions),
  _n_vars(other._n_vars),
  _n_requested_vars(other._n_requested_vars),
  _n_requested_grad_components(other._n_requested_grad_components),
  _n_requested_hess_components(other._n_requested_hess_components),
  _requested_normals(other._requested_normals),
  _spacetime(other._spacetime),
  _need_var(other._need_var),
  _need_var_grad(other._need_var_grad),
#ifdef LIBMESH_ENABLE_SECOND_DERIVATIVES
  _need_var_hess(other._need_var_hess),
#endif // LIBMESH_ENABLE_SECOND_DERIVATIVES
  variables(other.variables),
  _additional_vars(other._additional_vars),
  _initial_vals(other._initial_vals)
{
  this->reparse(_expression);
}
 
 
template <typename Output>
inline
ParsedFEMFunction<Output> &
ParsedFEMFunction<Output>::operator= (const ParsedFEMFunction<Output> & other)
{
  // We can only be assigned another ParsedFEMFunction defined on the same System
  libmesh_assert(&_sys == &other._sys);
 
  // Use copy-and-swap idiom
  ParsedFEMFunction<Output> tmp(other);
  std::swap(tmp, *this);
  return *this;
}
 
 
template <typename Output>
inline
void
ParsedFEMFunction<Output>::reparse (std::string expression)
{
  variables = "x";
#if LIBMESH_DIM > 1
  variables += ",y";
#endif
#if LIBMESH_DIM > 2
  variables += ",z";
#endif
  variables += ",t";
 
  for (unsigned int v=0; v != _n_vars; ++v)
    {
      const std::string & varname = _sys.variable_name(v);
      std::size_t varname_i = find_name(varname, expression);
 
      // If we didn't find our variable name then let's go to the
      // next.
      if (varname_i == std::string::npos)
        continue;
 
      _need_var[v] = true;
      variables += ',';
      variables += varname;
      _n_requested_vars++;
    }
 
  for (unsigned int v=0; v != _n_vars; ++v)
    {
      const std::string & varname = _sys.variable_name(v);
 
      for (unsigned int d=0; d != LIBMESH_DIM; ++d)
        {
          std::string gradname = std::string("grad_") +
            "xyz"[d] + '_' + varname;
          std::size_t gradname_i = find_name(gradname, expression);
 
          // If we didn't find that gradient component of our
          // variable name then let's go to the next.
          if (gradname_i == std::string::npos)
            continue;
 
          _need_var_grad[v*LIBMESH_DIM+d] = true;
          variables += ',';
          variables += gradname;
          _n_requested_grad_components++;
        }
    }
 
#ifdef LIBMESH_ENABLE_SECOND_DERIVATIVES
  for (unsigned int v=0; v != _n_vars; ++v)
    {
      const std::string & varname = _sys.variable_name(v);
 
      for (unsigned int d1=0; d1 != LIBMESH_DIM; ++d1)
        for (unsigned int d2=0; d2 != LIBMESH_DIM; ++d2)
          {
            std::string hessname = std::string("hess_") +
              "xyz"[d1] + "xyz"[d2] + '_' + varname;
            std::size_t hessname_i = find_name(hessname, expression);
 
            // If we didn't find that hessian component of our
            // variable name then let's go to the next.
            if (hessname_i == std::string::npos)
              continue;
 
            _need_var_hess[v*LIBMESH_DIM*LIBMESH_DIM+d1*LIBMESH_DIM+d2]
              = true;
            variables += ',';
            variables += hessname;
            _n_requested_hess_components++;
          }
    }
#endif // LIBMESH_ENABLE_SECOND_DERIVATIVES
 
  {
    std::size_t nx_i = find_name("n_x", expression);
    std::size_t ny_i = find_name("n_y", expression);
    std::size_t nz_i = find_name("n_z", expression);
 
    // If we found any requests for normal components then we'll
    // compute normals
    if (nx_i != std::string::npos ||
        ny_i != std::string::npos ||
        nz_i != std::string::npos)
      {
        _requested_normals = true;
        variables += ',';
        variables += "n_x";
        if (LIBMESH_DIM > 1)
          {
            variables += ',';
            variables += "n_y";
          }
        if (LIBMESH_DIM > 2)
          {
            variables += ',';
            variables += "n_z";
          }
      }
  }
 
  _spacetime.resize
    (LIBMESH_DIM + 1 + _n_requested_vars +
     _n_requested_grad_components + _n_requested_hess_components +
     (_requested_normals ? LIBMESH_DIM : 0) +
     _additional_vars.size());
 
  // If additional vars were passed, append them to the string
  // that we send to the function parser. Also add them to the
  // end of our spacetime vector
  unsigned int offset = LIBMESH_DIM + 1 + _n_requested_vars +
    _n_requested_grad_components + _n_requested_hess_components;
 
  for (auto i : index_range(_additional_vars))
    {
      variables += "," + _additional_vars[i];
      // Initialize extra variables to the vector passed in or zero
      // Note: The initial_vals vector can be shorter than the additional_vars vector
      _spacetime[offset + i] =
        (i < _initial_vals.size()) ? _initial_vals[i] : 0;
    }
 
  this->partial_reparse(std::move(expression));
}
 
template <typename Output>
inline
void
ParsedFEMFunction<Output>::init_context (const FEMContext & c)
{
  for (unsigned int v=0; v != _n_vars; ++v)
    {
      FEBase * elem_fe;
      c.get_element_fe(v, elem_fe);
      bool request_nothing = true;
      if (_n_requested_vars)
        {
          elem_fe->get_phi();
          request_nothing = false;
        }
      if (_n_requested_grad_components)
        {
          elem_fe->get_dphi();
          request_nothing = false;
        }
#ifdef LIBMESH_ENABLE_SECOND_DERIVATIVES
      if (_n_requested_hess_components)
        {
          elem_fe->get_d2phi();
          request_nothing = false;
        }
#endif // LIBMESH_ENABLE_SECOND_DERIVATIVES
      if (request_nothing)
        elem_fe->get_nothing();
    }
 
  if (_requested_normals)
    {
      FEBase * side_fe;
      c.get_side_fe(0, side_fe);
 
      side_fe->get_normals();
 
      // FIXME: this is a hack to support normals at quadrature
      // points; we don't support normals elsewhere.
      side_fe->get_xyz();
    }
}
 
template <typename Output>
inline
std::unique_ptr<FEMFunctionBase<Output>>
ParsedFEMFunction<Output>::clone () const
{
  return std::make_unique<ParsedFEMFunction>
    (_sys, _expression, &_additional_vars, &_initial_vals);
}
 
template <typename Output>
inline
Output
ParsedFEMFunction<Output>::operator() (const FEMContext & c,
                                       const Point & p,
                                       const Real time)
{
  eval_args(c, p, time);
 
  return eval(*parsers[0], "f", 0);
}
 
 
 
template <typename Output>
inline
void
ParsedFEMFunction<Output>::operator() (const FEMContext & c,
                                       const Point & p,
                                       const Real time,
                                       DenseVector<Output> & output)
{
  eval_args(c, p, time);
 
  unsigned int size = output.size();
 
  libmesh_assert_equal_to (size, parsers.size());
 
  for (unsigned int i=0; i != size; ++i)
    output(i) = eval(*parsers[i], "f", i);
}
 
 
template <typename Output>
inline
Output
ParsedFEMFunction<Output>::component (const FEMContext & c,
                                      unsigned int i,
                                      const Point & p,
                                      Real time)
{
  eval_args(c, p, time);
 
  libmesh_assert_less (i, parsers.size());
  return eval(*parsers[i], "f", i);
}
 
template <typename Output>
inline
Output
ParsedFEMFunction<Output>::get_inline_value(std::string_view inline_var_name) const
{
  libmesh_assert_greater (_subexpressions.size(), 0);
 
#ifndef NDEBUG
  bool found_var_name = false;
#endif
  Output old_var_value(0.);
 
  for (const std::string & subexpression : _subexpressions)
    {
      const std::size_t varname_i =
        find_name(inline_var_name, subexpression);
      if (varname_i == std::string::npos)
        continue;
 
      const std::size_t assignment_i =
        subexpression.find(":", varname_i+1);
 
      libmesh_assert_not_equal_to(assignment_i, std::string::npos);
 
      libmesh_assert_equal_to(subexpression[assignment_i+1], '=');
      for (std::size_t i = varname_i+1; i != assignment_i; ++i)
        libmesh_assert_equal_to(subexpression[i], ' ');
 
      std::size_t end_assignment_i =
        subexpression.find(";", assignment_i+1);
 
      libmesh_assert_not_equal_to(end_assignment_i, std::string::npos);
 
      std::string new_subexpression =
        subexpression.substr(0, end_assignment_i+1).
         append(inline_var_name);
 
#ifdef LIBMESH_HAVE_FPARSER
      // Parse and evaluate the new subexpression.
      // Add the same constants as we used originally.
      auto fp = std::make_unique<FunctionParserBase<Output>>();
      fp->AddConstant("NaN", std::numeric_limits<Real>::quiet_NaN());
      fp->AddConstant("pi", std::acos(Real(-1)));
      fp->AddConstant("e", std::exp(Real(1)));
      libmesh_error_msg_if
        (fp->Parse(new_subexpression, variables) != -1, // -1 for success
         "ERROR: FunctionParser is unable to parse modified expression: "
         << new_subexpression << '\n' << fp->ErrorMsg());
 
      Output new_var_value = this->eval(*fp, new_subexpression, 0);
#ifdef NDEBUG
      return new_var_value;
#else
      if (found_var_name)
        {
          libmesh_assert_equal_to(old_var_value, new_var_value);
        }
      else
        {
          old_var_value = new_var_value;
          found_var_name = true;
        }
#endif
 
#else
      libmesh_error_msg("ERROR: This functionality requires fparser!");
#endif
    }
 
  libmesh_assert(found_var_name);
  return old_var_value;
}
 
template <typename Output>
inline
void
ParsedFEMFunction<Output>::set_inline_value (std::string_view inline_var_name,
                                             Output newval)
{
  libmesh_assert_greater (_subexpressions.size(), 0);
 
#ifndef NDEBUG
  bool found_var_name = false;
#endif
  for (auto s : index_range(_subexpressions))
    {
      const std::string & subexpression = _subexpressions[s];
      const std::size_t varname_i =
        find_name(inline_var_name, subexpression);
      if (varname_i == std::string::npos)
        continue;
 
#ifndef NDEBUG
      found_var_name = true;
#endif
 
      const std::size_t assignment_i =
        subexpression.find(":", varname_i+1);
 
      libmesh_assert_not_equal_to(assignment_i, std::string::npos);
 
      libmesh_assert_equal_to(subexpression[assignment_i+1], '=');
      for (std::size_t i = varname_i+1; i != assignment_i; ++i)
        libmesh_assert_equal_to(subexpression[i], ' ');
 
      std::size_t end_assignment_i =
        subexpression.find(";", assignment_i+1);
 
      libmesh_assert_not_equal_to(end_assignment_i, std::string::npos);
 
      std::ostringstream new_subexpression;
      new_subexpression << subexpression.substr(0, assignment_i+2)
                        << std::setprecision(std::numeric_limits<Output>::digits10+2)
#ifdef LIBMESH_USE_COMPLEX_NUMBERS
                        << '(' << newval.real() << '+'
                        << newval.imag() << 'i' << ')'
#else
                        << newval
#endif
                        << subexpression.substr(end_assignment_i,
                                                std::string::npos);
      _subexpressions[s] = new_subexpression.str();
    }
 
  libmesh_assert(found_var_name);
 
  std::string new_expression;
 
  for (const auto & subexpression : _subexpressions)
    {
      new_expression += '{';
      new_expression += subexpression;
      new_expression += '}';
    }
 
  this->partial_reparse(new_expression);
}
 
 
template <typename Output>
inline
void
ParsedFEMFunction<Output>::partial_reparse (std::string expression)
{
  _expression = std::move(expression);
  _subexpressions.clear();
  parsers.clear();
 
  size_t nextstart = 0, end = 0;
 
  while (end != std::string::npos)
    {
      // If we're past the end of the string, we can't make any more
      // subparsers
      if (nextstart >= _expression.size())
        break;
 
      // If we're at the start of a brace delimited section, then we
      // parse just that section:
      if (_expression[nextstart] == '{')
        {
          nextstart++;
          end = _expression.find('}', nextstart);
        }
      // otherwise we parse the whole thing
      else
        end = std::string::npos;
 
      // We either want the whole end of the string (end == npos) or
      // a substring in the middle.
      _subexpressions.push_back
        (_expression.substr(nextstart, (end == std::string::npos) ?
                           std::string::npos : end - nextstart));
 
      // fparser can crash on empty expressions
      libmesh_error_msg_if(_subexpressions.back().empty(),
                           "ERROR: FunctionParser is unable to parse empty expression.\n");
 
 
#ifdef LIBMESH_HAVE_FPARSER
      // Parse (and optimize if possible) the subexpression.
      // Add some basic constants, to Real precision.
      auto fp = std::make_unique<FunctionParserBase<Output>>();
      fp->AddConstant("NaN", std::numeric_limits<Real>::quiet_NaN());
      fp->AddConstant("pi", std::acos(Real(-1)));
      fp->AddConstant("e", std::exp(Real(1)));
      libmesh_error_msg_if
        (fp->Parse(_subexpressions.back(), variables) != -1, // -1 for success
         "ERROR: FunctionParser is unable to parse expression: "
         << _subexpressions.back() << '\n' << fp->ErrorMsg());
      fp->Optimize();
      parsers.push_back(std::move(fp));
#else
      libmesh_error_msg("ERROR: This functionality requires fparser!");
#endif
 
      // If at end, use nextstart=maxSize.  Else start at next
      // character.
      nextstart = (end == std::string::npos) ?
        std::string::npos : end + 1;
    }
}
 
template <typename Output>
inline
std::size_t
ParsedFEMFunction<Output>::find_name (std::string_view varname,
                                      std::string_view expr) const
{
  const std::size_t namesize = varname.size();
  std::size_t varname_i = expr.find(varname);
 
  while ((varname_i != std::string::npos) &&
         (((varname_i > 0) &&
           (std::isalnum(expr[varname_i-1]) ||
            (expr[varname_i-1] == '_'))) ||
          ((varname_i+namesize < expr.size()) &&
           (std::isalnum(expr[varname_i+namesize]) ||
            (expr[varname_i+namesize] == '_')))))
    {
      varname_i = expr.find(varname, varname_i+1);
    }
 
  return varname_i;
}
 
 
 
// Helper function for evaluating function arguments
template <typename Output>
inline
void
ParsedFEMFunction<Output>::eval_args (const FEMContext & c,
                                      const Point & p,
                                      const Real time)
{
  _spacetime[0] = p(0);
#if LIBMESH_DIM > 1
  _spacetime[1] = p(1);
#endif
#if LIBMESH_DIM > 2
  _spacetime[2] = p(2);
#endif
  _spacetime[LIBMESH_DIM] = time;
 
  unsigned int request_index = 0;
  for (unsigned int v=0; v != _n_vars; ++v)
    {
      if (!_need_var[v])
        continue;
 
      c.point_value(v, p, _spacetime[LIBMESH_DIM+1+request_index]);
      request_index++;
    }
 
  if (_n_requested_grad_components)
    for (unsigned int v=0; v != _n_vars; ++v)
      {
        if (!_need_var_grad[v*LIBMESH_DIM]
#if LIBMESH_DIM > 1
            && !_need_var_grad[v*LIBMESH_DIM+1]
#if LIBMESH_DIM > 2
            && !_need_var_grad[v*LIBMESH_DIM+2]
#endif
#endif
            )
          continue;
 
        Gradient g;
        c.point_gradient(v, p, g);
 
        for (unsigned int d=0; d != LIBMESH_DIM; ++d)
          {
            if (!_need_var_grad[v*LIBMESH_DIM+d])
              continue;
 
            _spacetime[LIBMESH_DIM+1+request_index] = g(d);
            request_index++;
          }
      }
 
#ifdef LIBMESH_ENABLE_SECOND_DERIVATIVES
  if (_n_requested_hess_components)
    for (unsigned int v=0; v != _n_vars; ++v)
      {
        if (!_need_var_hess[v*LIBMESH_DIM*LIBMESH_DIM]
#if LIBMESH_DIM > 1
            && !_need_var_hess[v*LIBMESH_DIM*LIBMESH_DIM+1]
            && !_need_var_hess[v*LIBMESH_DIM*LIBMESH_DIM+2]
            && !_need_var_hess[v*LIBMESH_DIM*LIBMESH_DIM+3]
#if LIBMESH_DIM > 2
            && !_need_var_hess[v*LIBMESH_DIM*LIBMESH_DIM+4]
            && !_need_var_hess[v*LIBMESH_DIM*LIBMESH_DIM+5]
            && !_need_var_hess[v*LIBMESH_DIM*LIBMESH_DIM+6]
            && !_need_var_hess[v*LIBMESH_DIM*LIBMESH_DIM+7]
            && !_need_var_hess[v*LIBMESH_DIM*LIBMESH_DIM+8]
#endif
#endif
            )
          continue;
 
        Tensor h;
        c.point_hessian(v, p, h);
 
        for (unsigned int d1=0; d1 != LIBMESH_DIM; ++d1)
          for (unsigned int d2=0; d2 != LIBMESH_DIM; ++d2)
            {
              if (!_need_var_hess[v*LIBMESH_DIM*LIBMESH_DIM+d1*LIBMESH_DIM+d2])
                continue;
 
              _spacetime[LIBMESH_DIM+1+request_index] = h(d1,d2);
              request_index++;
            }
      }
#endif // LIBMESH_ENABLE_SECOND_DERIVATIVES
 
  if (_requested_normals)
    {
      FEBase * side_fe;
      c.get_side_fe(0, side_fe);
 
      const std::vector<Point> & normals = side_fe->get_normals();
 
      const std::vector<Point> & xyz = side_fe->get_xyz();
 
      libmesh_assert_equal_to(normals.size(), xyz.size());
 
      // We currently only support normals at quadrature points!
#ifndef NDEBUG
      bool at_quadrature_point = false;
#endif
      for (auto qp : index_range(normals))
        {
          if (p == xyz[qp])
            {
              const Point & n = normals[qp];
              for (unsigned int d=0; d != LIBMESH_DIM; ++d)
                {
                  _spacetime[LIBMESH_DIM+1+request_index] = n(d);
                  request_index++;
                }
#ifndef NDEBUG
              at_quadrature_point = true;
#endif
              break;
            }
        }
 
      libmesh_assert(at_quadrature_point);
    }
 
  // The remaining locations in _spacetime are currently set at construction
  // but could potentially be made dynamic
}
 
 
// Evaluate the ith FunctionParser and check the result
#ifdef LIBMESH_HAVE_FPARSER
template <typename Output>
inline
Output
ParsedFEMFunction<Output>::eval (FunctionParserBase<Output> & parser,
                                 std::string_view libmesh_dbg_var(function_name),
                                 unsigned int libmesh_dbg_var(component_idx)) const
{
#ifndef NDEBUG
  Output result = parser.Eval(_spacetime.data());
  int error_code = parser.EvalError();
  if (error_code)
    {
      libMesh::err << "ERROR: FunctionParser is unable to evaluate component "
                   << component_idx
                   << " for '"
                   << function_name;
 
      for (auto i : index_range(parsers))
        if (parsers[i].get() == &parser)
          libMesh::err << "' of expression '"
                       << _subexpressions[i];
 
      libMesh::err << "' with arguments:\n";
      for (const auto & st : _spacetime)
        libMesh::err << '\t' << st << '\n';
      libMesh::err << '\n';
 
      // Currently no API to report error messages, we'll do it manually
      std::string error_message = "Reason: ";
 
      switch (error_code)
        {
        case 1:
          error_message += "Division by zero";
          break;
        case 2:
          error_message += "Square Root error (negative value)";
          break;
        case 3:
          error_message += "Log error (negative value)";
          break;
        case 4:
          error_message += "Trigonometric error (asin or acos of illegal value)";
          break;
        case 5:
          error_message += "Maximum recursion level reached";
          break;
        default:
          error_message += "Unknown";
          break;
        }
      libmesh_error_msg(error_message);
    }
 
  return result;
#else
  return parser.Eval(_spacetime.data());
#endif
}
#else // LIBMESH_HAVE_FPARSER
template <typename Output>
inline
Output
ParsedFEMFunction<Output>::eval (char & /*parser*/,
                                 std::string_view /*function_name*/,
                                 unsigned int /*component_idx*/) const
{
  libmesh_error_msg("ERROR: This functionality requires fparser!");
  return Output(0);
}
#endif
 
 
} // namespace libMesh
 
#endif // LIBMESH_PARSED_FEM_FUNCTION_H