NonlinearVariationalProblem.h

// Copyright (C) 2011 Anders Logg
//
// This file is part of DOLFIN.
//
// DOLFIN 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 3 of the License, or
// (at your option) any later version.
//
// DOLFIN 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 DOLFIN. If not, see <http://www.gnu.org/licenses/>.
//
// Modified by Corrado Maurini, 2013.

#ifndef __NONLINEAR_VARIATIONAL_PROBLEM_H
#define __NONLINEAR_VARIATIONAL_PROBLEM_H

#include <memory>
#include <vector>
#include <dolfin/common/Hierarchical.h>

namespace dolfin
{

  // Forward declarations
  class Form;
  class Function;
  class FunctionSpace;
  class DirichletBC;
  class GenericVector;


  class NonlinearVariationalProblem
    : public Hierarchical<NonlinearVariationalProblem>
  {
  public:

    NonlinearVariationalProblem(std::shared_ptr<const Form> F,
                                std::shared_ptr<Function> u,
                                std::vector<std::shared_ptr<const DirichletBC>> bcs,
                                std::shared_ptr<const Form> J=nullptr);

    void set_bounds(const Function& lb_func, const Function& ub_func);

    void set_bounds(std::shared_ptr<const GenericVector> lb,
                    std::shared_ptr<const GenericVector> ub);

    std::shared_ptr<const Form> residual_form() const;

    std::shared_ptr<const Form> jacobian_form() const;

    std::shared_ptr<Function> solution();

    std::shared_ptr<const Function> solution() const;

    std::vector<std::shared_ptr<const DirichletBC>> bcs() const;

    std::shared_ptr<const FunctionSpace> trial_space() const;

    std::shared_ptr<const FunctionSpace> test_space() const;

    std::shared_ptr<const GenericVector> lower_bound() const;

    std::shared_ptr<const GenericVector> upper_bound() const;

    bool has_jacobian() const;

    bool has_lower_bound() const;

    bool has_upper_bound() const;

  private:

    // Check forms
    void check_forms() const;

    // The residual form
    std::shared_ptr<const Form> _residual;

    // The Jacobian form (pointer may be null if not provided)
    std::shared_ptr<const Form> _jacobian;

    // The solution
    std::shared_ptr<Function> _u;

    // The boundary conditions
    std::vector<std::shared_ptr<const DirichletBC>> _bcs;

    // The lower and upper bounds (pointers may be null if not
    // provided)
    std::shared_ptr<const GenericVector> _lb;
    std::shared_ptr<const GenericVector> _ub;
  };

}

#endif