AbstractLinAlgPack_VectorMutableDense.cpp

// @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

#include <typeinfo>
#include <stdexcept>

#include "AbstractLinAlgPack_VectorMutableDense.hpp"
#include "AbstractLinAlgPack_VectorDenseEncap.hpp"
#include "AbstractLinAlgPack_GenPermMatrixSliceOp.hpp"
#include "AbstractLinAlgPack_apply_op_helper.hpp"
#include "ReleaseResource_ref_count_ptr.hpp"
#include "Teuchos_Workspace.hpp"
#include "Teuchos_TestForException.hpp"

#ifdef TEUCHOS_DEBUG
#define CLASS_MEMBER_PTRS \
const VectorMutableDense   *_this = this; \
const DVectorSlice                *_v; \
const release_resource_ptr_t     *_v_release; \
const VectorSpaceSerial          *_space;
#else
#define CLASS_MEMBER_PTRS
#endif

namespace AbstractLinAlgPack {

VectorMutableDense::VectorMutableDense(
  const size_type                   dim
  )
  :space_(dim)
{
  CLASS_MEMBER_PTRS
  this->initialize(dim);
}

VectorMutableDense::VectorMutableDense(
  DVectorSlice                        v
  ,const release_resource_ptr_t&     v_release
  )
  :space_(v.dim())
{
  CLASS_MEMBER_PTRS
  this->initialize(v,v_release);
}

void VectorMutableDense::initialize(
  const size_type                   dim
  )
{
  CLASS_MEMBER_PTRS
  namespace rcp = MemMngPack;
  namespace rmp = MemMngPack;
  typedef Teuchos::RCP<DVector> vec_ptr_t;
  vec_ptr_t vec_ptr = Teuchos::rcp(new DVector(dim));
  this->initialize(
    (*vec_ptr)()
    ,Teuchos::rcp(
      new rmp::ReleaseResource_ref_count_ptr<DVector>(
        vec_ptr
        )
      )
    );
}

void VectorMutableDense::initialize(
  DVectorSlice                       v
  ,const release_resource_ptr_t&     v_release
  )
{
  CLASS_MEMBER_PTRS
  v_.bind(v);
  v_release_ = v_release;
  space_.initialize(v.dim());
  this->has_changed();
}

// Overridden from Vector

const VectorSpace& VectorMutableDense::space() const
{
  CLASS_MEMBER_PTRS
  return space_;
}

void VectorMutableDense::apply_op(
  const RTOpPack::RTOp& op
  ,const size_t num_vecs,      const Vector*  vecs[]
  ,const size_t num_targ_vecs, VectorMutable* targ_vecs[]
  ,RTOpPack::ReductTarget *reduct_obj
  ,const index_type first_ele_in, const index_type sub_dim_in, const index_type global_offset_in
  ) const
{
  CLASS_MEMBER_PTRS
#ifdef TEUCHOS_DEBUG
  AbstractLinAlgPack::apply_op_validate_input(
    "VectorMutableDense::apply_op(...)"
    ,op,num_vecs,vecs,num_targ_vecs,targ_vecs,reduct_obj,first_ele_in,sub_dim_in,global_offset_in
    );
#endif
  this->apply_op_serial(
    op,num_vecs,vecs,num_targ_vecs,targ_vecs,reduct_obj
    ,first_ele_in,sub_dim_in,global_offset_in
    );
}

index_type VectorMutableDense::dim() const
{
  return v_.dim();
}

value_type VectorMutableDense::get_ele(index_type i) const
{
  return v_(i);
}

void VectorMutableDense::get_sub_vector(
  const Range1D& rng_in, RTOpPack::SubVector* sub_vec
  ) const
{
  CLASS_MEMBER_PTRS
  const size_type  this_dim = v_.dim();
  const Range1D    rng = RangePack::full_range(rng_in,1,this_dim);
  TEST_FOR_EXCEPTION(
    rng.ubound() > this_dim, std::out_of_range
    ,"VectorMutableDense::get_sub_vector(...) : Error, "
    "rng = ["<<rng.lbound()<<","<<rng.ubound()<<"] "
    "is not in the range [1,this->dim()] = [1," << this_dim << "]!" );
  // Just return the dense view regardless of spare_or_dense argument
  sub_vec->initialize(
    rng.lbound()-1                             // global_offset
    ,rng.size()                                // sub_dim
    ,v_.raw_ptr()+v_.stride()*(rng.lbound()-1) // values
    ,v_.stride()
    );
}

void VectorMutableDense::free_sub_vector( RTOpPack::SubVector* sub_vec ) const
{
  sub_vec->set_uninitialized(); // No memory to deallocate!
}

// Overridden from VectorMutable

VectorMutable&
VectorMutableDense::operator=(value_type alpha)
{
  CLASS_MEMBER_PTRS
  v_ = alpha;
  this->has_changed();
  return *this;
}

VectorMutable&
VectorMutableDense::operator=(const Vector& v)
{
  CLASS_MEMBER_PTRS
  if( const VectorMutableDense *vp = dynamic_cast<const VectorMutableDense*>(&v) )
    v_ = vp->v_;
  else
    return VectorMutable::operator=(v); // Try the default implementation?
  this->has_changed();
  return *this;
}

VectorMutable&
VectorMutableDense::operator=(const VectorMutable& v)
{
  CLASS_MEMBER_PTRS
  if( const VectorMutableDense *vp = dynamic_cast<const VectorMutableDense*>(&v) )
    v_ = vp->v_;
  else
    return VectorMutable::operator=(v); // Try the default implementation?
  this->has_changed();
  return *this;
}

void VectorMutableDense::set_ele( index_type i, value_type val )
{
  CLASS_MEMBER_PTRS
  v_(i) = val;
  this->has_changed();
}

VectorMutableDense::vec_mut_ptr_t
VectorMutableDense::sub_view( const Range1D& rng_in )
{
  CLASS_MEMBER_PTRS
  namespace rcp = MemMngPack;
  const size_type this_dim = this->dim();
  const Range1D rng = RangePack::full_range( rng_in, 1, this_dim );
#ifdef TEUCHOS_DEBUG
  TEST_FOR_EXCEPTION(
    rng.ubound() > this_dim, std::out_of_range
    ,"VectorMutableDense::sub_view(...) : Error, "
    "rng = ["<<rng.lbound()<<","<<rng.ubound()<<"] "
    "is not in the range [1,this->dim()] = [1," << this_dim << "]!" );
#endif
  if( rng == Range1D(1,this_dim) )
    return Teuchos::rcp( this, false );
  this->has_changed(); // This will result in a change in the vector
  return Teuchos::rcp( new VectorMutableDense( v_(rng), Teuchos::null ) ); 
}

void VectorMutableDense::get_sub_vector(
  const Range1D& rng_in, RTOpPack::MutableSubVector* sub_vec )
{
  CLASS_MEMBER_PTRS
  const size_type  this_dim = v_.dim();
  const Range1D    rng = RangePack::full_range(rng_in,1,this_dim);
#ifdef TEUCHOS_DEBUG
  TEST_FOR_EXCEPTION(
    rng.ubound() > this_dim, std::out_of_range
    ,"VectorMutableDense::get_sub_vector(...) : Error, "
    "rng = ["<<rng.lbound()<<","<<rng.ubound()<<"] "
    "is not in the range [1,this->dim()] = [1," << this_dim << "]!" );
#endif
  sub_vec->initialize(
    rng.lbound()-1                             // global_offset
    ,rng.size()                                // sub_dim
    ,v_.raw_ptr()+v_.stride()*(rng.lbound()-1) // values
    ,v_.stride()
    );
}

void VectorMutableDense::commit_sub_vector( RTOpPack::MutableSubVector* sub_vec )
{
  CLASS_MEMBER_PTRS
  sub_vec->set_uninitialized(); // No memory to deallocate!
  this->has_changed();          // Be aware of any final changes!
}

void VectorMutableDense::set_sub_vector( const RTOpPack::SparseSubVector& sub_vec )
{
  CLASS_MEMBER_PTRS
  VectorMutable::set_sub_vector(sub_vec); // ToDo: Provide specialized implementation?
}

void VectorMutableDense::Vp_StMtV(
  value_type                       alpha
  ,const GenPermMatrixSlice        &P
  ,BLAS_Cpp::Transp                P_trans
  ,const Vector              &x
  ,value_type                      beta
  )
{
  CLASS_MEMBER_PTRS
  VectorDenseEncap  x_de(x);
  AbstractLinAlgPack::Vp_StMtV( &v_, alpha, P, P_trans, x_de(), beta );
}

} // end namespace AbstractLinAlgPack