tensor_function_parser.h

Go to the documentation of this file.

// ------------------------------------------------------------------------
//
// SPDX-License-Identifier: LGPL-2.1-or-later
// Copyright (C) 2019 - 2024 by the deal.II authors
//
// This file is part of the deal.II library.
//
// Part of the source code is dual licensed under Apache-2.0 WITH
// LLVM-exception OR LGPL-2.1-or-later. Detailed license information
// governing the source code and code contributions can be found in
// LICENSE.md and CONTRIBUTING.md at the top level directory of deal.II.
//
// ------------------------------------------------------------------------
 
#ifndef dealii_tensor_function_parser_h
#define dealii_tensor_function_parser_h
 
 
#include <deal.II/base/config.h>
 
#include <deal.II/base/exceptions.h>
#include <deal.II/base/function_parser.h>
#include <deal.II/base/mu_parser_internal.h>
#include <deal.II/base/point.h>
#include <deal.II/base/tensor.h>
#include <deal.II/base/tensor_function.h>
 
#include <map>
#include <vector>
 
DEAL_II_NAMESPACE_OPEN
 
// Forward declaration
#ifndef DOXYGEN
template <typename>
class Vector;
#endif
 
template <int rank, int dim, typename Number = double>
class TensorFunctionParser
  : public TensorFunction<rank, dim, Number>,
    protected internal::FunctionParser::ParserImplementation<dim, Number>
{
public:
  TensorFunctionParser(const double initial_time = 0.0);
 
  TensorFunctionParser(
    const std::string &expression,
    const std::string &constants      = "",
    const std::string &variable_names = default_variable_names() + ",t");
 
  TensorFunctionParser(const TensorFunctionParser &) = delete;
 
  TensorFunctionParser(TensorFunctionParser &&) = delete;
 
  TensorFunctionParser &
  operator=(const TensorFunctionParser &) = delete;
 
  TensorFunctionParser &
  operator=(TensorFunctionParser &&) = delete;
 
  using ConstMap = std::map<std::string, double>;
 
 
  virtual void
  initialize(const std::string              &vars,
             const std::vector<std::string> &expressions,
             const ConstMap                 &constants,
             const bool                      time_dependent = false) override;
 
  void
  initialize(const std::string &vars,
             const std::string &expression,
             const ConstMap    &constants,
             const bool         time_dependent = false);
 
  static std::string
  default_variable_names();
 
  virtual Tensor<rank, dim, Number>
  value(const Point<dim> &p) const override;
 
  virtual void
  value_list(const std::vector<Point<dim>>          &p,
             std::vector<Tensor<rank, dim, Number>> &values) const override;
 
  const std::vector<std::string> &
  get_expressions() const;
 
  DeclException2(ExcParseError,
                 int,
                 std::string,
                 << "Parsing Error at Column " << arg1
                 << ". The parser said: " << arg2);
 
  DeclException2(ExcInvalidExpressionSize,
                 int,
                 int,
                 << "The number of components (" << arg1
                 << ") is not equal to the number of expressions (" << arg2
                 << ").");
 
private:
  unsigned int n_components;
};
 
 
template <int rank, int dim, typename Number>
std::string
TensorFunctionParser<rank, dim, Number>::default_variable_names()
{
  switch (dim)
    {
      case 1:
        return "x";
      case 2:
        return "x,y";
      case 3:
        return "x,y,z";
      default:
        DEAL_II_NOT_IMPLEMENTED();
    }
  return "";
}
 
 
 
DEAL_II_NAMESPACE_CLOSE
 
#endif