vector_space_vector.h

// ---------------------------------------------------------------------
//
// Copyright (C) 2015 - 2016 by the deal.II authors
//
// This file is part of the deal.II library.
//
// The deal.II library is free software; you can use it, 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.
// The full text of the license can be found in the file LICENSE at
// the top level of the deal.II distribution.
//
// ---------------------------------------------------------------------

#ifndef dealii__vector_space_vector_h
#define dealii__vector_space_vector_h

#include <deal.II/base/config.h>
#include <deal.II/base/numbers.h>
#include <deal.II/base/std_cxx11/shared_ptr.h>
#include <deal.II/lac/vector.h>


DEAL_II_NAMESPACE_OPEN

class IndexSet;
namespace LinearAlgebra
{
  class CommunicationPatternBase;
  template <typename Number> class ReadWriteVector;
}

namespace LinearAlgebra
{
  template <typename Number>
  class VectorSpaceVector
  {
  public:
    typedef Number                                            value_type;
    typedef types::global_dof_index                           size_type;
    typedef typename numbers::NumberTraits<Number>::real_type real_type;


    virtual VectorSpaceVector<Number> &operator*= (const Number factor) = 0;

    virtual VectorSpaceVector<Number> &operator/= (const Number factor) = 0;

    virtual VectorSpaceVector<Number> &operator+= (const VectorSpaceVector<Number> &V) = 0;

    virtual VectorSpaceVector<Number> &operator-= (const VectorSpaceVector<Number> &V) = 0;

    virtual void import(const ReadWriteVector<Number> &V,
                        VectorOperation::values operation,
                        std_cxx11::shared_ptr<const CommunicationPatternBase> communication_pattern =
                          std_cxx11::shared_ptr<const CommunicationPatternBase> ()) = 0;

    virtual Number operator* (const VectorSpaceVector<Number> &V) const = 0;

    virtual void add(const Number a) = 0;

    virtual void add(const Number a, const VectorSpaceVector<Number> &V) = 0;

    virtual void add(const Number a, const VectorSpaceVector<Number> &V,
                     const Number b, const VectorSpaceVector<Number> &W) = 0;

    virtual void sadd(const Number s, const Number a,
                      const VectorSpaceVector<Number> &V) = 0;

    virtual void scale(const VectorSpaceVector<Number> &scaling_factors) = 0;

    virtual void equ(const Number a, const VectorSpaceVector<Number> &V) = 0;

    virtual value_type mean_value() const = 0;

    virtual real_type l1_norm() const = 0;

    virtual real_type l2_norm() const = 0;

    virtual real_type linfty_norm() const = 0;

    virtual Number add_and_dot(const Number a,
                               const VectorSpaceVector<Number> &V,
                               const VectorSpaceVector<Number> &W) = 0;

    virtual void compress(VectorOperation::values) {}

    virtual size_type size() const = 0;

    virtual ::IndexSet locally_owned_elements() const = 0;

    virtual void print(std::ostream &out,
                       const unsigned int precision=3,
                       const bool scientific=true,
                       const bool across=true) const = 0;

    virtual std::size_t memory_consumption() const = 0;

    virtual ~VectorSpaceVector();
  };
#ifndef DOXYGEN
  // TODO we can get rid of this when we require C++11 by using '=default'
  // above
  template <typename Number>
  inline
  VectorSpaceVector<Number>::~VectorSpaceVector()
  {}
#endif // DOXYGEN
}

DEAL_II_NAMESPACE_CLOSE

#endif