/usr/include/trilinos/AbstractLinAlgPack_VectorSpaceSubSpace.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 | // @HEADER
// ***********************************************************************
//
// Moocho: Multi-functional Object-Oriented arCHitecture for Optimization
// Copyright (2003) 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 Roscoe A. Bartlett (rabartl@sandia.gov)
//
// ***********************************************************************
// @HEADER
#ifndef VECTOR_SPACE_SUB_SPACE_H
#define VECTOR_SPACE_SUB_SPACE_H
#include "AbstractLinAlgPack_VectorSpace.hpp"
namespace AbstractLinAlgPack {
/** \brief Concrete subclass for a default sub-space of a vector.
*
* There is not much to this subclass. It basically implements all
* of its methods based on the external VectorSpace interface to
* implement is_compatible() and sub_space() and and relys
* on a default subclass VectorMutableSubView to implement
* create_member().
*
* The default constructor, copy constructor and assignment operator
* functions are allowed and have the correct behavior.
*/
class VectorSpaceSubSpace : public virtual VectorSpace {
public:
/** \brief Constructs to uninitialized.
*
* Postconditions: see \c set_uninitialized().
*/
VectorSpaceSubSpace();
/** \brief Calls <tt>this->initialize()</tt>.
*/
VectorSpaceSubSpace( const space_ptr_t& full_space, const Range1D& rng );
/** \brief Initialize.
*
* Constructs a sub-space of the vector space this = space.sub_space(rng).
*
* Preconditions:<ul>
* <li> <tt>full_space.get() != NULL</tt> (throw <tt>std::invalid_argument</tt>).
* <li> [rng.full_range() == false</tt>] <tt>rng.lbound() <= full_space->dim()</tt> (throw <tt>std::out_of_range</tt>).
* </ul>
*
* Postconditions:<ul>
* <li> [&& rng.full_range() == true</tt>] <tt>this->dim() == full_space->dim()</tt>
* <li> [&& rng.full_range() == false</tt>] <tt>this->dim() == rng.size()</tt>
* </ul>
*
* @param full_space [in] The original full vector space (must be <tt>full_space.get() != NULL</tt>).
* @param rng [in] The range of element that <tt>this</tt> vector sub-space will represent.
*/
void initialize( const space_ptr_t& full_space, const Range1D& rng );
/** \brief Set uninitilized.
*
* Postconditions:<ul>
* <li> <tt>this->dim() == 0</tt>
* <li> <tt>this->create_member().get() == NULL</tt>
* </ul>
*/
void set_uninitialized();
/** \brief . */
const space_ptr_t& full_space() const;
/** \brief . */
const Range1D& rng() const;
/// Validate rng
void validate_range( const Range1D& rng ) const;
/** @name Overridden from VectorSpace */
//@{
/** \brief . */
bool is_compatible(const VectorSpace& ) const;
/** \brief . */
bool is_in_core() const;
/** \brief . */
index_type dim() const;
/** \brief . */
vec_mut_ptr_t create_member() const;
/** \brief . */
space_ptr_t clone() const;
/** \brief . */
space_ptr_t sub_space(const Range1D& rng) const;
//@}
private:
space_ptr_t full_space_; ///< If space_.get() == NULL, then uninitalized (dim == 0)
Range1D rng_; ///< The range of elements from this space to represent!
}; // end class VectorSpaceSubSpace
// //////////////////////////////
// Inline members
inline
VectorSpaceSubSpace::VectorSpaceSubSpace()
: rng_(Range1D::Invalid)
{}
inline
const VectorSpace::space_ptr_t& VectorSpaceSubSpace::full_space() const
{
return full_space_;
}
inline
const Range1D& VectorSpaceSubSpace::rng() const
{
return rng_;
}
#ifndef TEUCHOS_DEBUG
inline
void VectorSpaceSubSpace::validate_range(const Range1D&) const
{}
#endif
} // end namespace AbstractLinAlgPack
#endif // VECTOR_SPACE_SUB_SPACE_H
|