/usr/include/trilinos/Thyra_EpetraLinearOpBase.hpp is in libtrilinos-dev 10.4.0.dfsg-1ubuntu2.
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 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 | // ***********************************************************************
//
// Thyra: Trilinos Solver Framework Core
// Copyright (2004) Sandia Corporation
//
// Under terms of Contract DE-AC04-94AL85000, there is a non-exclusive
// license for use of this work by or on behalf of the U.S. Government.
//
// 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
// Questions? Contact Michael A. Heroux (maherou@sandia.gov)
//
// ***********************************************************************
// @HEADER
#ifndef THYRA_EPETRA_LINEAR_OP_BASE_HPP
#define THYRA_EPETRA_LINEAR_OP_BASE_HPP
#include "Thyra_EpetraTypes.hpp"
#include "Teuchos_Describable.hpp"
class Epetra_Operator;
namespace Thyra {
/** \brief Abstract base class for all <tt>LinearOpBase</tt> objects that can
* return an <tt>Epetra_Operator</tt> view of themselves and details about how
* to apply the view.
*
* This interface defines a key interoperability interface that allows a
* general client to extract an <tt>Epetra_Operator</tt> view of a linear
* operator object. In some cases, <tt>*this</tt> linear operator can be
* modifed through the <tt>Epetra_Operator</tt> view and in some cases, it can
* not.
*
* ToDo: Finish documentatation!
*
* \ingroup Epetra_Thyra_Op_Vec_adapters_grp
*/
class EpetraLinearOpBase : virtual public Teuchos::Describable {
public:
/** \name Pure virtual functions that must be overridden in subclasses. */
//@{
/** \brief Return a smart pointer to a non-<tt>const</tt>
* <tt>Epetra_Operator</tt> view of this object and how the object is
* applied to implement <tt>*this</tt> linear operator.
*
* \param epetraOp [out] The non-<tt>const</tt> epetra operator view of
* <tt>*this</tt>.
*
* \param epetraOpTransp [out] Determines if the operator is applied as its
* transpose or its non-transpose. The Client should use this value and
* ignore the value in <tt>(*epetraOp)->UseTranspose()</tt> since it has
* been shown to be problematic and error prone.
*
* \param epetraOpApplyAs [out] Determines if the operator should be applied
* using <tt>(*epetraOp)->Apply(...)</tt> or using
* <tt>(*epetraOp)->ApplyInverse(...)</tt>.
*
* \param epetraOpAdjointSupport [out] Determines if the operator supports
* transposes or not.
*
* <b>Preconditions:</b></ul>
* <li><tt>epetraOp!=NULL</tt>
* <li><tt>epetraOpOpTransp!=NULL</tt>
* <li><tt>epetraOpApplyAs!=NULL</tt>
* <li><tt>epetraOpAdjointSupport!=NULL</tt>
* </ul>
*
* <b>Posconditions:</b></ul>
* <li><tt>epetraOp->get() != NULL</tt>
* </ul>
*
* The object accessed from <tt>*epetraOp</tt> is only guaranteed to be
* valid while the returned <tt>Teuchos::RCP</tt> object exits.
* This allows for some very specialized implementations where a
* <tt>Epetra_Operator</tt> view of <tt>*this</tt> can be acquired and
* released according to the lifetime of the returned
* <tt>Teuchos::RCP</tt> object.
*
* The <tt>Epetra_Operator</tt> object may be dynamic casted to more
* specialized interfaces and therefore modified. Then, when the last
* <tt>RCP</tt> object ancestor returned from this function goes
* away, then <tt>*this</tt> will be updated to relect the change.
*
* <b>Warning!</b> The client can not assume that the view in
* <tt>*(*epetraOp)</tt> will be valid past the lifetime of <tt>*this</tt>
* object which is providing the view! The client must take special care in
* the case!
*/
virtual void getNonconstEpetraOpView(
const Ptr<RCP<Epetra_Operator> > &epetraOp,
const Ptr<EOpTransp> &epetraOpTransp,
const Ptr<EApplyEpetraOpAs> &epetraOpApplyAs,
const Ptr<EAdjointEpetraOp> &epetraOpAdjointSupport
) = 0;
/** \brief Return a smart pointer to a <tt>const</tt>
* <tt>Epetra_Operator</tt> view of this object and how the object is
* applied to implement <tt>*this</tt> linear operator.
*
* \param epetraOp [out] The <tt>const</tt> epetra operator view of
* <tt>*this</tt>.
*
* \param epetraOpTransp [out] Determines if the operator is applied as its
* transpose or its non-transpose. The Client should use this value and
* ignore the value in <tt>(*epetraOp)->UseTranspose()</tt> since it has
* been shown to be problematic and error prone.
*
* \param epetraOpApplyAs [out] Determines if the operator should be applied
* using <tt>(*epetraOp)->Apply(...)</tt> or using
* <tt>(*epetraOp)->ApplyInverse(...)</tt>.
*
* \param epetraOpAdjointSupport [out] Determines if the operator supports
* transposes or not.
*
* <b>Preconditions:</b></ul>
* <li><tt>epetraOp!=NULL</tt>
* <li><tt>epetraOpOpTransp!=NULL</tt>
* <li><tt>epetraOpApplyAs!=NULL</tt>
* <li><tt>epetraOpAdjointSupport!=NULL</tt>
* </ul>
*
* <b>Posconditions:</b></ul>
* <li><tt>epetraOp->get() != NULL</tt>
* </ul>
*
* The object accessed from <tt>*return</tt> is only guaranteed to be valid
* while the returned <tt>Teuchos::RCP</tt> object exits. This allows for
* some very specialized implementations where a <tt>Epetra_Operator</tt>
* view of <tt>*this</tt> can be acquired and released according to the
* lifetime of the returned <tt>Teuchos::RCP</tt> object.
*
* Note that if the client tries to constant cast the returned object and
* modify it that this returned view is not guaranteed to update
* <tt>*this</tt>. If the goal is to modify <tt>*this</tt> then the client
* should call the non-<tt>const</tt> version of this function.
*
* <b>Warning!</b> The client can not assume that the view in
* <tt>*(*epetraOp)</tt> will be valid past the lifetime of <tt>*this</tt>
* object which is providing the view! The client must take special care in
* the case!
*/
virtual void getEpetraOpView(
const Ptr<RCP<const Epetra_Operator> > &epetraOp,
const Ptr<EOpTransp> &epetraOpTransp,
const Ptr<EApplyEpetraOpAs> &epetraOpApplyAs,
const Ptr<EAdjointEpetraOp> &epetraOpAdjointSupport
) const = 0;
//@}
}; // end class EpetraLinearOpBase
} // end namespace Thyra
#endif // THYRA_EPETRA_LINEAR_OP_BASE_HPP
|