/usr/include/dolfin/la/GenericLinearOperator.h is in libdolfin-dev 1.4.0+dfsg-4.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 | // Copyright (C) 2012 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/>.
//
// First added: 2012-08-20
// Last changed: 2012-12-12
#ifndef __GENERIC_LINEAR_OPERATOR_H
#define __GENERIC_LINEAR_OPERATOR_H
#include "LinearAlgebraObject.h"
namespace dolfin
{
// Forward declarations
class GenericVector;
class GenericLinearAlgebraFactory;
/// This class defines a common interface for linear operators,
/// including actual matrices (class _GenericMatrix_) and linear
/// operators only defined in terms of their action on vectors.
///
/// This class is used internally by DOLFIN to define a class
/// hierarchy of backend independent linear operators and solvers.
/// Users should not interface to this class directly but instead
/// use the _LinearOperator_ class.
class GenericLinearOperator : public virtual LinearAlgebraObject
{
public:
// Destructor
virtual ~GenericLinearOperator() {}
/// Return size of given dimension
virtual std::size_t size(std::size_t dim) const = 0;
/// Compute matrix-vector product y = Ax
virtual void mult(const GenericVector& x, GenericVector& y) const = 0;
/// Return informal string representation (pretty-print)
virtual std::string str(bool verbose) const = 0;
protected:
friend class LinearOperator;
// Initialize linear operator to match parallel layout of vectors
// x and y for product y = Ax. Needs to be implemented by backend.
virtual void init_layout(const GenericVector& x,
const GenericVector& y,
GenericLinearOperator* wrapper)
{
dolfin_error("GenericLinearOperator.h",
"initialize backend implementation of linear operator",
"Missing init_layout() function for backend");
}
};
}
#endif
|