#include <trilinos_epetra_vector.h>

Inheritance diagram for libMesh::EpetraVector< T >:

Public Member Functions
	EpetraVector (const Parallel::Communicator &comm, const ParallelType type=AUTOMATIC)
	EpetraVector (const Parallel::Communicator &comm, const numeric_index_type n, const ParallelType type=AUTOMATIC)
	EpetraVector (const Parallel::Communicator &comm, const numeric_index_type n, const numeric_index_type n_local, const ParallelType type=AUTOMATIC)
	EpetraVector (const Parallel::Communicator &comm, const numeric_index_type N, const numeric_index_type n_local, const std::vector< numeric_index_type > &ghost, const ParallelType type=AUTOMATIC)
	EpetraVector (Epetra_Vector &v, const Parallel::Communicator &comm LIBMESH_CAN_DEFAULT_TO_COMMWORLD)
	~EpetraVector ()
void	close ()
void	clear ()
void	zero ()
virtual UniquePtr < NumericVector< T > >	zero_clone () const
UniquePtr< NumericVector< T > >	clone () const
void	init (const numeric_index_type N, const numeric_index_type n_local, const bool fast=false, const ParallelType type=AUTOMATIC)
void	init (const numeric_index_type N, const bool fast=false, const ParallelType type=AUTOMATIC)
void	init (const numeric_index_type, const numeric_index_type, const std::vector< numeric_index_type > &, const bool=false, const ParallelType=AUTOMATIC)
virtual void	init (const NumericVector< T > &other, const bool fast=false)
NumericVector< T > &	operator= (const T s)
NumericVector< T > &	operator= (const NumericVector< T > &V)
EpetraVector< T > &	operator= (const EpetraVector< T > &V)
NumericVector< T > &	operator= (const std::vector< T > &v)
Real	min () const
Real	max () const
T	sum () const
Real	l1_norm () const
Real	l2_norm () const
Real	linfty_norm () const
numeric_index_type	size () const
numeric_index_type	local_size () const
numeric_index_type	first_local_index () const
numeric_index_type	last_local_index () const
T	operator() (const numeric_index_type i) const
NumericVector< T > &	operator+= (const NumericVector< T > &V)
NumericVector< T > &	operator-= (const NumericVector< T > &V)
virtual NumericVector< T > &	operator/= (NumericVector< T > &v)
virtual void	reciprocal ()
virtual void	conjugate ()
void	set (const numeric_index_type i, const T value)
void	add (const numeric_index_type i, const T value)
void	add (const T s)
void	add (const NumericVector< T > &V)
void	add (const T a, const NumericVector< T > &v)
void	add_vector (const T *v, const std::vector< numeric_index_type > &dof_indices)
void	add_vector (const NumericVector< T > &V, const SparseMatrix< T > &A)
void	add_vector_transpose (const NumericVector< T > &V, const SparseMatrix< T > &A_trans)
virtual void	insert (const T *v, const std::vector< numeric_index_type > &dof_indices)
void	scale (const T factor)
virtual void	abs ()
virtual T	dot (const NumericVector< T > &V) const
void	localize (std::vector< T > &v_local) const
void	localize (NumericVector< T > &v_local) const
void	localize (NumericVector< T > &v_local, const std::vector< numeric_index_type > &send_list) const
void	localize (const numeric_index_type first_local_idx, const numeric_index_type last_local_idx, const std::vector< numeric_index_type > &send_list)
void	localize_to_one (std::vector< T > &v_local, const processor_id_type proc_id=0) const
virtual void	pointwise_mult (const NumericVector< T > &vec1, const NumericVector< T > &vec2)
virtual void	create_subvector (NumericVector< T > &subvector, const std::vector< numeric_index_type > &rows) const
virtual void	swap (NumericVector< T > &v)
Epetra_Vector *	vec ()
virtual bool	initialized () const
ParallelType	type () const
ParallelType &	type ()
virtual bool	closed () const
virtual Real	subset_l1_norm (const std::set< numeric_index_type > &indices) const
virtual Real	subset_l2_norm (const std::set< numeric_index_type > &indices) const
virtual Real	subset_linfty_norm (const std::set< numeric_index_type > &indices) const
virtual T	el (const numeric_index_type i) const
virtual void	get (const std::vector< numeric_index_type > &index, T *values) const
void	get (const std::vector< numeric_index_type > &index, std::vector< T > &values) const
NumericVector< T > &	operator*= (const T a)
NumericVector< T > &	operator/= (const T a)
void	add_vector (const std::vector< T > &v, const std::vector< numeric_index_type > &dof_indices)
virtual void	add_vector (const NumericVector< T > &V, const std::vector< numeric_index_type > &dof_indices)
void	add_vector (const DenseVector< T > &V, const std::vector< numeric_index_type > &dof_indices)
void	add_vector (const NumericVector< T > &v, const ShellMatrix< T > &a)
void	insert (const std::vector< T > &v, const std::vector< numeric_index_type > &dof_indices)
virtual void	insert (const NumericVector< T > &V, const std::vector< numeric_index_type > &dof_indices)
void	insert (const DenseVector< T > &V, const std::vector< numeric_index_type > &dof_indices)
void	insert (const DenseSubVector< T > &V, const std::vector< numeric_index_type > &dof_indices)
virtual int	compare (const NumericVector< T > &other_vector, const Real threshold=TOLERANCE) const
virtual int	local_relative_compare (const NumericVector< T > &other_vector, const Real threshold=TOLERANCE) const
virtual int	global_relative_compare (const NumericVector< T > &other_vector, const Real threshold=TOLERANCE) const
virtual void	print (std::ostream &os=libMesh::out) const
template<>
void	print (std::ostream &os) const
virtual void	print_global (std::ostream &os=libMesh::out) const
template<>
void	print_global (std::ostream &os) const
virtual void	print_matlab (const std::string &="") const
const Parallel::Communicator &	comm () const
processor_id_type	n_processors () const
processor_id_type	processor_id () const
Static Public Member Functions
static UniquePtr < NumericVector< T > >	build (const Parallel::Communicator &comm, const SolverPackage solver_package=libMesh::default_solver_package())
static UniquePtr < NumericVector< T > >	build (const SolverPackage solver_package=libMesh::default_solver_package())
static std::string	get_info ()
static void	print_info (std::ostream &out=libMesh::out)
static unsigned int	n_objects ()
static void	enable_print_counter_info ()
static void	disable_print_counter_info ()
Protected Types
typedef std::map< std::string, std::pair< unsigned int, unsigned int > >	Counts
Protected Member Functions
void	increment_constructor_count (const std::string &name)
void	increment_destructor_count (const std::string &name)
Protected Attributes
bool	_is_closed
bool	_is_initialized
ParallelType	_type
const Parallel::Communicator &	_communicator
Static Protected Attributes
static Counts	_counts
static Threads::atomic < unsigned int >	_n_objects
static Threads::spin_mutex	_mutex
static bool	_enable_print_counter = true
Private Member Functions
int	SumIntoGlobalValues (int numIDs, const int GIDs, const double values)
int	SumIntoGlobalValues (const Epetra_IntSerialDenseVector &GIDs, const Epetra_SerialDenseVector &values)
int	ReplaceGlobalValues (int numIDs, const int GIDs, const double values)
int	ReplaceGlobalValues (const Epetra_IntSerialDenseVector &GIDs, const Epetra_SerialDenseVector &values)
int	SumIntoGlobalValues (int numIDs, const int GIDs, const int numValuesPerID, const double *values)
int	ReplaceGlobalValues (int numIDs, const int GIDs, const int numValuesPerID, const double *values)
int	GlobalAssemble (Epetra_CombineMode mode=Add)
void	setIgnoreNonLocalEntries (bool flag)
void	FEoperatorequals (const EpetraVector &source)
int	inputValues (int numIDs, const int GIDs, const double values, bool accumulate)
int	inputValues (int numIDs, const int GIDs, const int numValuesPerID, const double *values, bool accumulate)
int	inputNonlocalValue (int GID, double value, bool accumulate)
int	inputNonlocalValues (int GID, int numValues, const double *values, bool accumulate)
void	destroyNonlocalData ()
Private Attributes
Epetra_Vector *	_vec
Epetra_Map *	_map
bool	_destroy_vec_on_exit
int	myFirstID_
int	myNumIDs_
double *	myCoefs_
int *	nonlocalIDs_
int *	nonlocalElementSize_
int	numNonlocalIDs_
int	allocatedNonlocalLength_
double **	nonlocalCoefs_
unsigned char	last_edit
bool	ignoreNonLocalEntries_
Friends
std::ostream &	operator<< (std::ostream &os, const NumericVector< T > &v)

Detailed Description

template<typename T>
class libMesh::EpetraVector< T >

Epetra vector. Provides a nice interface to the Trilinos Epetra data structures for parallel vectors.

Author:: Derek R. Gaston, 2008

Definition at line 60 of file trilinos_epetra_vector.h.

Member Typedef Documentation

typedef std::map<std::string, std::pair<unsigned int, unsigned int> > libMesh::ReferenceCounter::Counts [protected, inherited]

Data structure to log the information. The log is identified by the class name.

Definition at line 113 of file reference_counter.h.

Constructor & Destructor Documentation

template<typename T >

libMesh::EpetraVector< T >::EpetraVector	(	const Parallel::Communicator &	comm,
		const ParallelType	type = `AUTOMATIC`
	)		`[inline, explicit]`

Dummy-Constructor. Dimension=0

Definition at line 600 of file trilinos_epetra_vector.h.

References libMesh::NumericVector< T >::_type, and libMesh::NumericVector< T >::type().

  : NumericVector<T>(comm, type),
    _destroy_vec_on_exit(true),
    myFirstID_(0),
    myNumIDs_(0),
    myCoefs_(NULL),
    nonlocalIDs_(NULL),
    nonlocalElementSize_(NULL),
    numNonlocalIDs_(0),
    allocatedNonlocalLength_(0),
    nonlocalCoefs_(NULL),
    last_edit(0),
    ignoreNonLocalEntries_(false)
{
  this->_type = type;
}

template<typename T >

libMesh::EpetraVector< T >::EpetraVector	(	const Parallel::Communicator &	comm,
		const numeric_index_type	n,
		const ParallelType	type = `AUTOMATIC`
	)		`[inline, explicit]`

Constructor. Set dimension to n and initialize all elements with zero.

Definition at line 622 of file trilinos_epetra_vector.h.

References libMesh::EpetraVector< T >::init().

  : NumericVector<T>(comm, type),
    _destroy_vec_on_exit(true),
    myFirstID_(0),
    myNumIDs_(0),
    myCoefs_(NULL),
    nonlocalIDs_(NULL),
    nonlocalElementSize_(NULL),
    numNonlocalIDs_(0),
    allocatedNonlocalLength_(0),
    nonlocalCoefs_(NULL),
    last_edit(0),
    ignoreNonLocalEntries_(false)

{
  this->init(n, n, false, type);
}

template<typename T >

libMesh::EpetraVector< T >::EpetraVector	(	const Parallel::Communicator &	comm,
		const numeric_index_type	n,
		const numeric_index_type	n_local,
		const ParallelType	type = `AUTOMATIC`
	)		`[inline]`

Constructor. Set local dimension to n_local, the global dimension to n, and initialize all elements with zero.

Definition at line 646 of file trilinos_epetra_vector.h.

References libMesh::EpetraVector< T >::init().

  : NumericVector<T>(comm, type),
    _destroy_vec_on_exit(true),
    myFirstID_(0),
    myNumIDs_(0),
    myCoefs_(NULL),
    nonlocalIDs_(NULL),
    nonlocalElementSize_(NULL),
    numNonlocalIDs_(0),
    allocatedNonlocalLength_(0),
    nonlocalCoefs_(NULL),
    last_edit(0),
    ignoreNonLocalEntries_(false)
{
  this->init(n, n_local, false, type);
}

template<typename T >

libMesh::EpetraVector< T >::EpetraVector	(	const Parallel::Communicator &	comm,
		const numeric_index_type	N,
		const numeric_index_type	n_local,
		const std::vector< numeric_index_type > &	ghost,
		const ParallelType	type = `AUTOMATIC`
	)		`[inline]`

Constructor. Set local dimension to n_local, the global dimension to n, but additionally reserve memory for the indices specified by the ghost argument.

Definition at line 711 of file trilinos_epetra_vector.h.

References libMesh::EpetraVector< T >::init().

  : NumericVector<T>(comm, AUTOMATIC),
    _destroy_vec_on_exit(true),
    myFirstID_(0),
    myNumIDs_(0),
    myCoefs_(NULL),
    nonlocalIDs_(NULL),
    nonlocalElementSize_(NULL),
    numNonlocalIDs_(0),
    allocatedNonlocalLength_(0),
    nonlocalCoefs_(NULL),
    last_edit(0),
    ignoreNonLocalEntries_(false)
{
  this->init(n, n_local, ghost, false, type);
}

template<typename T>

libMesh::EpetraVector< T >::EpetraVector	(	Epetra_Vector &	v,
		const Parallel::Communicator &comm	LIBMESH_CAN_DEFAULT_TO_COMMWORLD
	)

Constructor. Creates a EpetraVector assuming you already have a valid Epetra Vec object. In this case, v is NOT destroyed by the EpetraVector constructor when this object goes out of scope. This allows ownership of v to remain with the original creator, and to simply provide additional functionality with the EpetraVector.

template<typename T >

libMesh::EpetraVector< T >::~EpetraVector ( ) [inline]

Destructor, deallocates memory. Made virtual to allow for derived classes to behave properly.

Definition at line 747 of file trilinos_epetra_vector.h.

{
  this->clear ();
}

Member Function Documentation

template<typename T >

void libMesh::EpetraVector< T >::abs ( ) [virtual]

v = abs(v)... that is, each entry in v is replaced by its absolute value.

Implements libMesh::NumericVector< T >.

Definition at line 301 of file trilinos_epetra_vector.C.

{
  _vec->Abs(*_vec);
}

template<typename T >

void libMesh::EpetraVector< T >::add	(	const numeric_index_type	i,
		const T	value
	)		`[virtual]`

v(i) += value

Implements libMesh::NumericVector< T >.

Definition at line 194 of file trilinos_epetra_vector.C.

{
  int i = static_cast<int> (i_in);
  T value = value_in;

  libmesh_assert_less (i_in, this->size());

  SumIntoGlobalValues(1, &i, &value);

  this->_is_closed = false;
}

template<typename T >

void libMesh::EpetraVector< T >::add ( const T s ) [virtual]

$U(0-LIBMESH_DIM)+=s$ . Addition of s to all components. Note that s is a scalar and not a vector.

Implements libMesh::NumericVector< T >.

Definition at line 249 of file trilinos_epetra_vector.C.

{
  const unsigned int nl = _vec->MyLength();

  T * values = _vec->Values();

  for (unsigned int i=0; i<nl; i++)
    values[i]+=v_in;

  this->_is_closed = false;
}

template<typename T >

void libMesh::EpetraVector< T >::add ( const NumericVector< T > & V ) [virtual]

$ U+=V $ . Simple vector addition, equal to the operator +=.

Implements libMesh::NumericVector< T >.

Definition at line 263 of file trilinos_epetra_vector.C.

{
  this->add (1., v);
}

template<typename T >

void libMesh::EpetraVector< T >::add	(	const T	a,
		const NumericVector< T > &	v
	)		`[virtual]`

$ U+=a*V $ . Simple vector addition, equal to the operator +=.

Implements libMesh::NumericVector< T >.

Definition at line 270 of file trilinos_epetra_vector.C.

References libMesh::EpetraVector< T >::_vec, and libMesh::EpetraVector< T >::size().

{
  const EpetraVector<T>* v = cast_ptr<const EpetraVector<T>*>(&v_in);

  libmesh_assert_equal_to (this->size(), v->size());

  _vec->Update(a_in,*v->_vec, 1.);
}

template<typename T >

void libMesh::EpetraVector< T >::add_vector	(	const T *	v,
		const std::vector< numeric_index_type > &	dof_indices
	)		`[virtual]`

$ U+=v $ where v is a pointer and each dof_indices[i] specifies where to add value v[i]

Reimplemented from libMesh::NumericVector< T >.

Definition at line 209 of file trilinos_epetra_vector.C.

{
  libmesh_assert_equal_to (sizeof(numeric_index_type), sizeof(int));

  SumIntoGlobalValues (dof_indices.size(),
                       (int*) &dof_indices[0],
                       const_cast<T*>(v));
}

template<typename T >

void libMesh::EpetraVector< T >::add_vector	(	const NumericVector< T > &	V,
		const SparseMatrix< T > &	A
	)		`[virtual]`

$U+=A*V$ , add the product of a SparseMatrix A and a NumericVector V to this, where this=U.

Implements libMesh::NumericVector< T >.

Definition at line 223 of file trilinos_epetra_vector.C.

References libMesh::EpetraVector< T >::_vec, and libMesh::EpetraVector< T >::zero_clone().

{
  const EpetraVector<T>* V = cast_ptr<const EpetraVector<T>*>(&V_in);
  const EpetraMatrix<T>* A = cast_ptr<const EpetraMatrix<T>*>(&A_in);

  // FIXME - does Trilinos let us do this *without* memory allocation?
  UniquePtr<NumericVector<T> > temp = V->zero_clone();
  EpetraVector<T>* tempV = cast_ptr<EpetraVector<T>*>(temp.get());
  A->mat()->Multiply(false, *V->_vec, *tempV->_vec);
  *this += *temp;
}

template<typename T>

void libMesh::NumericVector< T >::add_vector	(	const std::vector< T > &	v,
		const std::vector< numeric_index_type > &	dof_indices
	)		`[inline, inherited]`

$ U+=v $ where v is a std::vector and each dof_indices[i] specifies where to add value v[i]

Definition at line 806 of file numeric_vector.h.

References libMesh::libmesh_assert().

{
  libmesh_assert(v.size() == dof_indices.size());
  if (!v.empty())
    this->add_vector(&v[0], dof_indices);
}

template<typename T>

void libMesh::NumericVector< T >::add_vector	(	const NumericVector< T > &	V,
		const std::vector< numeric_index_type > &	dof_indices
	)		`[virtual, inherited]`

$ U+=v $ where v is a NumericVector and each dof_indices[i] specifies where to add value v(i)

Definition at line 395 of file numeric_vector.C.

References libMesh::NumericVector< T >::size().

{
  int n = dof_indices.size();
  libmesh_assert_equal_to(v.size(), static_cast<unsigned>(n));
  for (int i=0; i<n; i++)
    this->add (dof_indices[i], v(i));
}

template<typename T>

void libMesh::NumericVector< T >::add_vector	(	const DenseVector< T > &	V,
		const std::vector< numeric_index_type > &	dof_indices
	)		`[inline, inherited]`

$ U+=v $ where v is a DenseVector and each dof_indices[i] specifies where to add value v(i)

Definition at line 818 of file numeric_vector.h.

References libMesh::DenseVector< T >::empty(), libMesh::libmesh_assert(), and libMesh::DenseVector< T >::size().

{
  libmesh_assert(v.size() == dof_indices.size());
  if (!v.empty())
    this->add_vector(&v(0), dof_indices);
}

template<typename T>

void libMesh::NumericVector< T >::add_vector	(	const NumericVector< T > &	v,
		const ShellMatrix< T > &	a
	)		`[inherited]`

$U+=A*V$ , add the product of a ShellMatrix A and a NumericVector V to this, where this=U.

Definition at line 407 of file numeric_vector.C.

References libMesh::ShellMatrix< T >::vector_mult_add().

{
  a.vector_mult_add(*this,v);
}

template<typename T >

void libMesh::EpetraVector< T >::add_vector_transpose	(	const NumericVector< T > &	V,
		const SparseMatrix< T > &	A_trans
	)		`[virtual]`

$U+=A*V$ , add the product of the transpose of a SparseMatrix A_trans and a NumericVector V to this, where this=U.

Implements libMesh::NumericVector< T >.

Definition at line 240 of file trilinos_epetra_vector.C.

{
  libmesh_not_implemented();
}

template<typename T >

UniquePtr< NumericVector< T > > libMesh::NumericVector< T >::build	(	const Parallel::Communicator &	comm,
		const SolverPackage	solver_package = `libMesh::default_solver_package()`
	)		`[static, inherited]`

Builds a NumericVector on the processors in communicator comm using the linear solver package specified by solver_package

Definition at line 46 of file numeric_vector.C.

References libMesh::AUTOMATIC, libMesh::EIGEN_SOLVERS, libMesh::LASPACK_SOLVERS, libMesh::PETSC_SOLVERS, and libMesh::TRILINOS_SOLVERS.

Referenced by libMesh::NumericVector< T >::build(), and libMesh::ExactErrorEstimator::estimate_error().

{
  // Build the appropriate vector
  switch (solver_package)
    {

#ifdef LIBMESH_HAVE_LASPACK
    case LASPACK_SOLVERS:
      return UniquePtr<NumericVector<T> >(new LaspackVector<T>(comm, AUTOMATIC));
#endif

#ifdef LIBMESH_HAVE_PETSC
    case PETSC_SOLVERS:
      return UniquePtr<NumericVector<T> >(new PetscVector<T>(comm, AUTOMATIC));
#endif

#ifdef LIBMESH_HAVE_TRILINOS
    case TRILINOS_SOLVERS:
      return UniquePtr<NumericVector<T> >(new EpetraVector<T>(comm, AUTOMATIC));
#endif

#ifdef LIBMESH_HAVE_EIGEN
    case EIGEN_SOLVERS:
      return UniquePtr<NumericVector<T> >(new EigenSparseVector<T>(comm, AUTOMATIC));
#endif

    default:
      return UniquePtr<NumericVector<T> >(new DistributedVector<T>(comm, AUTOMATIC));
    }

  libmesh_error_msg("We'll never get here!");
  return UniquePtr<NumericVector<T> >();
}

template<typename T >

UniquePtr< NumericVector< T > > libMesh::NumericVector< T >::build ( const SolverPackage solver_package = libMesh::default_solver_package() ) [static, inherited]

Builds a NumericVector on the processors in communicator CommWorld using the linear solver package specified by solver_package. Deprecated.

Definition at line 84 of file numeric_vector.C.

References libMesh::NumericVector< T >::build(), and libMesh::CommWorld.

{
  libmesh_deprecated();
  return NumericVector<T>::build(CommWorld, solver_package);
}

template<typename T >

void libMesh::EpetraVector< T >::clear ( ) [inline, virtual]

Returns:: the EpetraVector<T> to a pristine state.

Reimplemented from libMesh::NumericVector< T >.

Definition at line 860 of file trilinos_epetra_vector.h.

References libMesh::libMeshPrivateData::_is_initialized, and libMesh::initialized().

{
  if (this->initialized())
    {
      // We might just be an interface to a user-provided _vec
      if (this->_destroy_vec_on_exit)
        {
          delete _vec;
          _vec = NULL;
        }

      // But we currently always own our own _map
      delete _map;
      _map = NULL;
    }

  this->_is_closed = this->_is_initialized = false;
}

template<typename T >

UniquePtr< NumericVector< T > > libMesh::EpetraVector< T >::clone ( ) const [inline, virtual]

Creates a copy of this vector and returns it in an UniquePtr.

Implements libMesh::NumericVector< T >.

Definition at line 909 of file trilinos_epetra_vector.h.

References libMesh::AUTOMATIC.

{
  UniquePtr<NumericVector<T> > cloned_vector
    (new EpetraVector<T>(this->comm(), AUTOMATIC));

  cloned_vector->init(*this, true);

  *cloned_vector = *this;

  return cloned_vector;
}

template<typename T >

void libMesh::EpetraVector< T >::close ( ) [inline, virtual]

Call the assemble functions

Implements libMesh::NumericVector< T >.

Definition at line 836 of file trilinos_epetra_vector.h.

References libMesh::initialized(), libMesh::libmesh_assert(), and libMesh::Parallel::Communicator::max().

Referenced by libMesh::EpetraVector< T >::localize().

{
  libmesh_assert (this->initialized());

  // Are we adding or inserting?
  unsigned char global_last_edit = last_edit;
  this->comm().max(global_last_edit);
  libmesh_assert(!last_edit || last_edit == global_last_edit);

  if (global_last_edit == 1)
    this->GlobalAssemble(Insert);
  else if (global_last_edit == 2)
    this->GlobalAssemble(Add);
  else
    libmesh_assert(!global_last_edit);

  this->_is_closed = true;
  this->last_edit = 0;
}

template<typename T>

virtual bool libMesh::NumericVector< T >::closed ( ) const [inline, virtual, inherited]

Returns:: true if the vector is closed and ready for computation, false otherwise.

Definition at line 147 of file numeric_vector.h.

Referenced by libMesh::DofMap::enforce_adjoint_constraints_exactly(), libMesh::DofMap::enforce_constraints_exactly(), libMesh::DofMap::max_constraint_error(), libMesh::LaspackVector< T >::operator=(), libMesh::EigenSparseVector< T >::operator=(), and libMesh::PetscVector< T >::operator=().

{ return _is_closed; }

const Parallel::Communicator& libMesh::ParallelObject::comm ( ) const [inline, inherited]

Returns:: a reference to the Parallel::Communicator object used by this mesh.

Definition at line 86 of file parallel_object.h.

References libMesh::ParallelObject::_communicator.

  { return _communicator; }

template<typename T>

int libMesh::NumericVector< T >::compare	(	const NumericVector< T > &	other_vector,
		const Real	threshold = `TOLERANCE`
	)		const `[virtual, inherited]`

Returns:: -1 when this is equivalent to other_vector, up to the given threshold. When differences occur, the return value contains the first index i where the difference (a[i]-b[i]) exceeded the threshold. When no threshold is given, the libMesh TOLERANCE is used.

Definition at line 116 of file numeric_vector.C.

References std::abs(), libMesh::NumericVector< T >::first_local_index(), libMesh::NumericVector< T >::initialized(), libMesh::initialized(), libMesh::NumericVector< T >::last_local_index(), libMesh::libmesh_assert(), and std::max().

{
  libmesh_assert (this->initialized());
  libmesh_assert (other_vector.initialized());
  libmesh_assert_equal_to (this->first_local_index(), other_vector.first_local_index());
  libmesh_assert_equal_to (this->last_local_index(), other_vector.last_local_index());

  int first_different_i = std::numeric_limits<int>::max();
  numeric_index_type i = first_local_index();

  do
    {
      if ( std::abs( (*this)(i) - other_vector(i) ) > threshold )
        first_different_i = i;
      else
        i++;
    }
  while (first_different_i==std::numeric_limits<int>::max()
         && i<last_local_index());

  // Find the correct first differing index in parallel
  this->comm().min(first_different_i);

  if (first_different_i == std::numeric_limits<int>::max())
    return -1;

  return first_different_i;
}

template<typename T >

void libMesh::EpetraVector< T >::conjugate ( ) [virtual]

Replace each entry v_i = real(v_i) + imag(v_i) of this vector by its complex conjugate, real(v_i) - imag(v_i). Epetra is real-valued only, rendering this a no-op.

Implements libMesh::NumericVector< T >.

Definition at line 186 of file trilinos_epetra_vector.C.

{
  // EPetra is real, rendering this a no-op.
}

template<typename T >

void libMesh::EpetraVector< T >::create_subvector	(	NumericVector< T > &	subvector,
		const std::vector< numeric_index_type > &	rows
	)		const `[virtual]`

Creates a "subvector" from this vector using the rows indices of the "rows" array.

Reimplemented from libMesh::NumericVector< T >.

Definition at line 528 of file trilinos_epetra_vector.C.

{
  libmesh_not_implemented();
}

template<typename T >

void libMesh::EpetraVector< T >::destroyNonlocalData ( ) [private]

Definition at line 854 of file trilinos_epetra_vector.C.

{
  if (allocatedNonlocalLength_ > 0) {
    delete [] nonlocalIDs_;
    delete [] nonlocalElementSize_;
    nonlocalIDs_ = NULL;
    nonlocalElementSize_ = NULL;
    for(int i=0; i<numNonlocalIDs_; ++i) {
      delete [] nonlocalCoefs_[i];
    }
    delete [] nonlocalCoefs_;
    nonlocalCoefs_ = NULL;
    numNonlocalIDs_ = 0;
    allocatedNonlocalLength_ = 0;
  }
  return;
}

void libMesh::ReferenceCounter::disable_print_counter_info ( ) [static, inherited]

Definition at line 106 of file reference_counter.C.

References libMesh::ReferenceCounter::_enable_print_counter.

Referenced by libMesh::LibMeshInit::LibMeshInit().

{
  _enable_print_counter = false;
  return;
}

template<typename T >

T libMesh::EpetraVector< T >::dot ( const NumericVector< T > & V ) const [virtual]

Computes the dot product, p = U.V

Implements libMesh::NumericVector< T >.

Definition at line 308 of file trilinos_epetra_vector.C.

References libMesh::EpetraVector< T >::_vec.

{
  const EpetraVector<T>* V = cast_ptr<const EpetraVector<T>*>(&V_in);

  T result=0.0;

  _vec->Dot(*V->_vec, &result);

  return result;
}

template<typename T>

virtual T libMesh::NumericVector< T >::el ( const numeric_index_type i ) const [inline, virtual, inherited]

Returns:: the element U(i)

Definition at line 344 of file numeric_vector.h.

{ return (*this)(i); }

void libMesh::ReferenceCounter::enable_print_counter_info ( ) [static, inherited]

Methods to enable/disable the reference counter output from print_info()

Definition at line 100 of file reference_counter.C.

References libMesh::ReferenceCounter::_enable_print_counter.

{
  _enable_print_counter = true;
  return;
}

template<typename T >

void libMesh::EpetraVector< T >::FEoperatorequals ( const EpetraVector< T > & source ) [private]

Definition at line 827 of file trilinos_epetra_vector.C.

References libMesh::EpetraVector< T >::_vec, libMesh::EpetraVector< T >::allocatedNonlocalLength_, libMesh::EpetraVector< T >::nonlocalCoefs_, libMesh::EpetraVector< T >::nonlocalElementSize_, libMesh::EpetraVector< T >::nonlocalIDs_, and libMesh::EpetraVector< T >::numNonlocalIDs_.

{
  (*_vec) = *(source._vec);

  destroyNonlocalData();

  if (source.allocatedNonlocalLength_ > 0) {
    allocatedNonlocalLength_ = source.allocatedNonlocalLength_;
    numNonlocalIDs_ = source.numNonlocalIDs_;
    nonlocalIDs_ = new int[allocatedNonlocalLength_];
    nonlocalElementSize_ = new int[allocatedNonlocalLength_];
    nonlocalCoefs_ = new double*[allocatedNonlocalLength_];
    for(int i=0; i<numNonlocalIDs_; ++i) {
      int elemSize = source.nonlocalElementSize_[i];
      nonlocalCoefs_[i] = new double[elemSize];
      nonlocalIDs_[i] = source.nonlocalIDs_[i];
      nonlocalElementSize_[i] = elemSize;
      for(int j=0; j<elemSize; ++j) {
        nonlocalCoefs_[i][j] = source.nonlocalCoefs_[i][j];
      }
    }
  }
}

template<typename T >

numeric_index_type libMesh::EpetraVector< T >::first_local_index ( ) const [inline, virtual]

Returns:: the index of the first vector element actually stored on this processor

Implements libMesh::NumericVector< T >.

Definition at line 945 of file trilinos_epetra_vector.h.

References libMesh::initialized(), and libMesh::libmesh_assert().

{
  libmesh_assert (this->initialized());

  return _vec->Map().MinMyGID();
}

template<typename T>

void libMesh::NumericVector< T >::get	(	const std::vector< numeric_index_type > &	index,
		T *	values
	)		const `[inline, virtual, inherited]`

Access multiple components at once. values will *not* be reallocated; it should already have enough space. The default implementation calls operator() for each index, but some implementations may supply faster methods here.

Reimplemented in libMesh::PetscVector< T >.

Definition at line 779 of file numeric_vector.h.

Referenced by libMesh::DofMap::enforce_adjoint_constraints_exactly(), libMesh::DofMap::enforce_constraints_exactly(), libMesh::FEMContext::pre_fe_reinit(), and libMesh::System::project_vector().

{
  const std::size_t num = index.size();
  for(std::size_t i=0; i<num; i++)
    {
      values[i] = (*this)(index[i]);
    }
}

template<typename T>

void libMesh::NumericVector< T >::get	(	const std::vector< numeric_index_type > &	index,
		std::vector< T > &	values
	)		const `[inline, inherited]`

Access multiple components at once. values will be resized, if necessary, and filled. The default implementation calls operator() for each index, but some implementations may supply faster methods here.

Definition at line 792 of file numeric_vector.h.

{
  const std::size_t num = index.size();
  values.resize(num);
  if (!num)
    return;

  this->get(index, &values[0]);
}

std::string libMesh::ReferenceCounter::get_info ( ) [static, inherited]

Gets a string containing the reference information.

Definition at line 47 of file reference_counter.C.

References libMesh::ReferenceCounter::_counts, and libMesh::Quality::name().

Referenced by libMesh::ReferenceCounter::print_info().

{
#if defined(LIBMESH_ENABLE_REFERENCE_COUNTING) && defined(DEBUG)

  std::ostringstream oss;

  oss << '\n'
      << " ---------------------------------------------------------------------------- \n"
      << "| Reference count information                                                |\n"
      << " ---------------------------------------------------------------------------- \n";

  for (Counts::iterator it = _counts.begin();
       it != _counts.end(); ++it)
    {
      const std::string name(it->first);
      const unsigned int creations    = it->second.first;
      const unsigned int destructions = it->second.second;

      oss << "| " << name << " reference count information:\n"
          << "|  Creations:    " << creations    << '\n'
          << "|  Destructions: " << destructions << '\n';
    }

  oss << " ---------------------------------------------------------------------------- \n";

  return oss.str();

#else

  return "";

#endif
}

template<typename T>

int libMesh::NumericVector< T >::global_relative_compare	(	const NumericVector< T > &	other_vector,
		const Real	threshold = `TOLERANCE`
	)		const `[virtual, inherited]`

Returns:: -1 when this is equivalent to other_vector, up to the given local relative threshold. When differences occur, the return value contains the first index where the difference (a[i]-b[i])/max_j(a[j],b[j]) exceeded the threshold. When no threshold is given, the libMesh TOLERANCE is used.

Definition at line 181 of file numeric_vector.C.

References std::abs(), libMesh::NumericVector< T >::first_local_index(), libMesh::NumericVector< T >::initialized(), libMesh::initialized(), libMesh::NumericVector< T >::last_local_index(), libMesh::libmesh_assert(), libMesh::NumericVector< T >::linfty_norm(), std::max(), and libMesh::Real.

{
  libmesh_assert (this->initialized());
  libmesh_assert (other_vector.initialized());
  libmesh_assert_equal_to (this->first_local_index(), other_vector.first_local_index());
  libmesh_assert_equal_to (this->last_local_index(), other_vector.last_local_index());

  int first_different_i = std::numeric_limits<int>::max();
  numeric_index_type i = first_local_index();

  const Real my_norm = this->linfty_norm();
  const Real other_norm = other_vector.linfty_norm();
  const Real abs_threshold = std::max(my_norm, other_norm) * threshold;

  do
    {
      if ( std::abs( (*this)(i) - other_vector(i) ) > abs_threshold )
        first_different_i = i;
      else
        i++;
    }
  while (first_different_i==std::numeric_limits<int>::max()
         && i<last_local_index());

  // Find the correct first differing index in parallel
  this->comm().min(first_different_i);

  if (first_different_i == std::numeric_limits<int>::max())
    return -1;

  return first_different_i;
}

template<typename T >

int libMesh::EpetraVector< T >::GlobalAssemble ( Epetra_CombineMode mode = Add ) [private]

Gather any overlapping/shared data into the non-overlapping partitioning defined by the Map that was passed to this vector at construction time. Data imported from other processors is stored on the owning processor with a "sumInto" or accumulate operation. This is a collective method -- every processor must enter it before any will complete it.

Definition at line 782 of file trilinos_epetra_vector.C.

{
  //In this method we need to gather all the non-local (overlapping) data
  //that's been input on each processor, into the (probably) non-overlapping
  //distribution defined by the map that 'this' vector was constructed with.

  //We don't need to do anything if there's only one processor or if
  //ignoreNonLocalEntries_ is true.
  if (_vec->Map().Comm().NumProc() < 2 || ignoreNonLocalEntries_) {
    return(0);
  }



  //First build a map that describes the data in nonlocalIDs_/nonlocalCoefs_.
  //We'll use the arbitrary distribution constructor of Map.

  Epetra_BlockMap sourceMap(-1, numNonlocalIDs_,
                            nonlocalIDs_, nonlocalElementSize_,
                            _vec->Map().IndexBase(), _vec->Map().Comm());

  //Now build a vector to hold our nonlocalCoefs_, and to act as the source-
  //vector for our import operation.
  Epetra_MultiVector nonlocalVector(sourceMap, 1);

  int i,j;
  for(i=0; i<numNonlocalIDs_; ++i) {
    for(j=0; j<nonlocalElementSize_[i]; ++j) {
      nonlocalVector.ReplaceGlobalValue(nonlocalIDs_[i], j, 0,
                                        nonlocalCoefs_[i][j]);
    }
  }

  Epetra_Export exporter(sourceMap, _vec->Map());

  EPETRA_CHK_ERR( _vec->Export(nonlocalVector, exporter, mode) );

  destroyNonlocalData();

  return(0);
}

void libMesh::ReferenceCounter::increment_constructor_count ( const std::string & name ) [inline, protected, inherited]

Increments the construction counter. Should be called in the constructor of any derived class that will be reference counted.

Definition at line 163 of file reference_counter.h.

References libMesh::ReferenceCounter::_counts, libMesh::Quality::name(), and libMesh::Threads::spin_mtx.

Referenced by libMesh::ReferenceCountedObject< RBParametrized >::ReferenceCountedObject().

{
  Threads::spin_mutex::scoped_lock lock(Threads::spin_mtx);
  std::pair<unsigned int, unsigned int>& p = _counts[name];

  p.first++;
}

void libMesh::ReferenceCounter::increment_destructor_count ( const std::string & name ) [inline, protected, inherited]

Increments the destruction counter. Should be called in the destructor of any derived class that will be reference counted.

Definition at line 176 of file reference_counter.h.

References libMesh::ReferenceCounter::_counts, libMesh::Quality::name(), and libMesh::Threads::spin_mtx.

Referenced by libMesh::ReferenceCountedObject< RBParametrized >::~ReferenceCountedObject().

{
  Threads::spin_mutex::scoped_lock lock(Threads::spin_mtx);
  std::pair<unsigned int, unsigned int>& p = _counts[name];

  p.second++;
}

template<typename T >

void libMesh::EpetraVector< T >::init	(	const numeric_index_type	N,
		const numeric_index_type	n_local,
		const bool	fast = `false`,
		const ParallelType	type = `AUTOMATIC`
	)		`[inline, virtual]`

Change the dimension of the vector to N. The reserved memory for this vector remains unchanged if possible, to make things faster, but this may waste some memory, so take this in the back of your head. However, if N==0 all memory is freed, i.e. if you want to resize the vector and release the memory not needed, you have to first call init(0) and then init(N). This cited behaviour is analogous to that of the STL containers.

On fast==false, the vector is filled by zeros.

Implements libMesh::NumericVector< T >.

Definition at line 756 of file trilinos_epetra_vector.h.

References libMesh::libMeshPrivateData::_is_initialized, libMesh::AUTOMATIC, libMesh::GHOSTED, libMesh::libmesh_assert(), libMesh::PARALLEL, libMesh::SERIAL, and libMesh::zero.

Referenced by libMesh::EpetraVector< T >::EpetraVector(), and libMesh::EpetraVector< T >::localize().

{
  // We default to allocating n_local local storage
  numeric_index_type my_n_local = n_local;

  if (type == AUTOMATIC)
    {
      if (n == n_local)
        this->_type = SERIAL;
      else
        this->_type = PARALLEL;
    }
  else if (type == GHOSTED)
    {
      // We don't yet support GHOSTED Epetra vectors, so to get the
      // same functionality we need a SERIAL vector with local
      // storage allocated for every entry.
      this->_type = SERIAL;
      my_n_local = n;
    }
  else
    this->_type = type;

  libmesh_assert ((this->_type==SERIAL && n==my_n_local) ||
                  this->_type==PARALLEL);

  _map = new Epetra_Map(static_cast<int>(n),
                        my_n_local,
                        0,
                        Epetra_MpiComm (this->comm().get()));

  _vec = new Epetra_Vector(*_map);

  myFirstID_ = _vec->Map().MinMyGID();
  myNumIDs_ = _vec->Map().NumMyElements();

  //Currently we impose the restriction that NumVectors==1, so we won't
  //need the LDA argument when calling ExtractView. Hence the "dummy" arg.
  int dummy;
  _vec->ExtractView(&myCoefs_, &dummy);

  this->_is_initialized = true;
  this->_is_closed = true;
  this->last_edit = 0;

  if (fast == false)
    this->zero ();
}

template<typename T >

void libMesh::EpetraVector< T >::init	(	const numeric_index_type	N,
		const bool	fast = `false`,
		const ParallelType	type = `AUTOMATIC`
	)		`[inline, virtual]`

call init with n_local = N,

Implements libMesh::NumericVector< T >.

Definition at line 825 of file trilinos_epetra_vector.h.

References libMesh::TriangleWrapper::init().

{
  this->init(n,n,fast,type);
}

template<typename T >

void libMesh::EpetraVector< T >::init	(	const numeric_index_type	n,
		const numeric_index_type	n_local,
		const std::vector< numeric_index_type > &	,
		const bool	fast = `false`,
		const ParallelType	type = `AUTOMATIC`
	)		`[inline, virtual]`

Create a vector that holds the local indices plus those specified in the ghost argument.

Implements libMesh::NumericVector< T >.

Definition at line 811 of file trilinos_epetra_vector.h.

References libMesh::TriangleWrapper::init().

{
  // TODO: we shouldn't ignore the ghost sparsity pattern
  this->init(n, n_local, fast, type);
}

template<class T >

void libMesh::EpetraVector< T >::init	(	const NumericVector< T > &	other,
		const bool	fast = `false`
	)		`[virtual]`

Creates a vector that has the same dimension and storage type as other, including ghost dofs.

Implements libMesh::NumericVector< T >.

Definition at line 737 of file trilinos_epetra_vector.h.

References libMesh::TriangleWrapper::init(), libMesh::NumericVector< T >::local_size(), libMesh::NumericVector< T >::size(), and libMesh::NumericVector< T >::type().

{
  this->init(other.size(),other.local_size(),fast,other.type());
}

template<typename T>

virtual bool libMesh::NumericVector< T >::initialized ( ) const [inline, virtual, inherited]

Returns:: true if the vector has been initialized, false otherwise.

Definition at line 131 of file numeric_vector.h.

Referenced by libMesh::ImplicitSystem::assemble(), libMesh::NumericVector< T >::compare(), libMesh::PetscVector< T >::create_subvector(), libMesh::NumericVector< T >::global_relative_compare(), libMesh::PetscVector< T >::init(), and libMesh::NumericVector< T >::local_relative_compare().

{ return _is_initialized; }

template<typename T >

int libMesh::EpetraVector< T >::inputNonlocalValue	(	int	GID,
		double	value,
		bool	accumulate
	)		`[private]`

Definition at line 682 of file trilinos_epetra_vector.C.

{
  int insertPoint = -1;

  //find offset of GID in nonlocalIDs_
  int offset = Epetra_Util_binary_search(GID, nonlocalIDs_, numNonlocalIDs_,
                                         insertPoint);
  if (offset >= 0) {
    //if offset >= 0
    //  put value in nonlocalCoefs_[offset][0]

    if (accumulate) {
      nonlocalCoefs_[offset][0] += value;
    }
    else {
      nonlocalCoefs_[offset][0] = value;
    }
  }
  else {
    //else
    //  insert GID in nonlocalIDs_
    //  insert 1   in nonlocalElementSize_
    //  insert value in nonlocalCoefs_

    int tmp1 = numNonlocalIDs_;
    int tmp2 = allocatedNonlocalLength_;
    int tmp3 = allocatedNonlocalLength_;
    EPETRA_CHK_ERR( Epetra_Util_insert(GID, insertPoint, nonlocalIDs_,
                                       tmp1, tmp2) );
    --tmp1;
    EPETRA_CHK_ERR( Epetra_Util_insert(1, insertPoint, nonlocalElementSize_,
                                       tmp1, tmp3) );
    double* values = new double[1];
    values[0] = value;
    EPETRA_CHK_ERR( Epetra_Util_insert(values, insertPoint, nonlocalCoefs_,
                                       numNonlocalIDs_, allocatedNonlocalLength_) );
  }

  return(0);
}

template<typename T >

int libMesh::EpetraVector< T >::inputNonlocalValues	(	int	GID,
		int	numValues,
		const double *	values,
		bool	accumulate
	)		`[private]`

Definition at line 725 of file trilinos_epetra_vector.C.

References libMesh::err.

{
  int insertPoint = -1;

  //find offset of GID in nonlocalIDs_
  int offset = Epetra_Util_binary_search(GID, nonlocalIDs_, numNonlocalIDs_,
                                         insertPoint);
  if (offset >= 0) {
    //if offset >= 0
    //  put value in nonlocalCoefs_[offset][0]

    if (numValues != nonlocalElementSize_[offset]) {
      libMesh::err << "Epetra_FEVector ERROR: block-size for GID " << GID << " is "
                   << numValues<<" which doesn't match previously set block-size of "
                   << nonlocalElementSize_[offset] << std::endl;
      return(-1);
    }

    if (accumulate) {
      for(int j=0; j<numValues; ++j) {
        nonlocalCoefs_[offset][j] += values[j];
      }
    }
    else {
      for(int j=0; j<numValues; ++j) {
        nonlocalCoefs_[offset][j] = values[j];
      }
    }
  }
  else {
    //else
    //  insert GID in nonlocalIDs_
    //  insert numValues   in nonlocalElementSize_
    //  insert values in nonlocalCoefs_

    int tmp1 = numNonlocalIDs_;
    int tmp2 = allocatedNonlocalLength_;
    int tmp3 = allocatedNonlocalLength_;
    EPETRA_CHK_ERR( Epetra_Util_insert(GID, insertPoint, nonlocalIDs_,
                                       tmp1, tmp2) );
    --tmp1;
    EPETRA_CHK_ERR( Epetra_Util_insert(numValues, insertPoint, nonlocalElementSize_,
                                       tmp1, tmp3) );
    double* newvalues = new double[numValues];
    for(int j=0; j<numValues; ++j) {
      newvalues[j] = values[j];
    }
    EPETRA_CHK_ERR( Epetra_Util_insert(newvalues, insertPoint, nonlocalCoefs_,
                                       numNonlocalIDs_, allocatedNonlocalLength_) );
  }

  return(0);
}

template<typename T >

int libMesh::EpetraVector< T >::inputValues	(	int	numIDs,
		const int *	GIDs,
		const double *	values,
		bool	accumulate
	)		`[private]`

Definition at line 602 of file trilinos_epetra_vector.C.

References libMesh::libmesh_assert().

{
  if (accumulate) {
    libmesh_assert(last_edit == 0 || last_edit == 2);
    last_edit = 2;
  } else {
    libmesh_assert(last_edit == 0 || last_edit == 1);
    last_edit = 1;
  }

  //Important note!! This method assumes that there is only 1 point
  //associated with each element.

  for(int i=0; i<numIDs; ++i) {
    if (_vec->Map().MyGID(GIDs[i])) {
      if (accumulate) {
        _vec->SumIntoGlobalValue(GIDs[i], 0, 0, values[i]);
      }
      else {
        _vec->ReplaceGlobalValue(GIDs[i], 0, 0, values[i]);
      }
    }
    else {
      if (!ignoreNonLocalEntries_) {
        EPETRA_CHK_ERR( inputNonlocalValue(GIDs[i], values[i], accumulate) );
      }
    }
  }

  return(0);
}

template<typename T >

int libMesh::EpetraVector< T >::inputValues	(	int	numIDs,
		const int *	GIDs,
		const int *	numValuesPerID,
		const double *	values,
		bool	accumulate
	)		`[private]`

Definition at line 639 of file trilinos_epetra_vector.C.

References libMesh::libmesh_assert().

{
  if (accumulate) {
    libmesh_assert(last_edit == 0 || last_edit == 2);
    last_edit = 2;
  } else {
    libmesh_assert(last_edit == 0 || last_edit == 1);
    last_edit = 1;
  }

  int offset=0;
  for(int i=0; i<numIDs; ++i) {
    int numValues = numValuesPerID[i];
    if (_vec->Map().MyGID(GIDs[i])) {
      if (accumulate) {
        for(int j=0; j<numValues; ++j) {
          _vec->SumIntoGlobalValue(GIDs[i], j, 0, values[offset+j]);
        }
      }
      else {
        for(int j=0; j<numValues; ++j) {
          _vec->ReplaceGlobalValue(GIDs[i], j, 0, values[offset+j]);
        }
      }
    }
    else {
      if (!ignoreNonLocalEntries_) {
        EPETRA_CHK_ERR( inputNonlocalValues(GIDs[i], numValues,
                                            &(values[offset]), accumulate) );
      }
    }
    offset += numValues;
  }

  return(0);
}

template<typename T >

void libMesh::EpetraVector< T >::insert	(	const T *	v,
		const std::vector< numeric_index_type > &	dof_indices
	)		`[virtual]`

$ U=v $ where v is a T[] or T* and you want to specify WHERE to insert it

Reimplemented from libMesh::NumericVector< T >.

Definition at line 282 of file trilinos_epetra_vector.C.

{
  libmesh_assert_equal_to (sizeof(numeric_index_type), sizeof(int));

  ReplaceGlobalValues (dof_indices.size(),
                       (int*) &dof_indices[0],
                       const_cast<T*>(v));
}

template<typename T>

void libMesh::NumericVector< T >::insert	(	const std::vector< T > &	v,
		const std::vector< numeric_index_type > &	dof_indices
	)		`[inline, inherited]`

$ U=v $ where v is a std::vector<T> and you want to specify WHERE to insert it

Definition at line 830 of file numeric_vector.h.

References libMesh::libmesh_assert().

{
  libmesh_assert(v.size() == dof_indices.size());
  if (!v.empty())
    this->insert(&v[0], dof_indices);
}

template<typename T>

void libMesh::NumericVector< T >::insert	(	const NumericVector< T > &	V,
		const std::vector< numeric_index_type > &	dof_indices
	)		`[virtual, inherited]`

$U=V$ , where U and V are type NumericVector<T> and you want to specify WHERE to insert the NumericVector<T> V

Definition at line 104 of file numeric_vector.C.

References libMesh::NumericVector< T >::size().

{
  libmesh_assert_equal_to (V.size(), dof_indices.size());

  for (numeric_index_type i=0; i<dof_indices.size(); i++)
    this->set (dof_indices[i], V(i));
}

template<typename T>

void libMesh::NumericVector< T >::insert	(	const DenseVector< T > &	V,
		const std::vector< numeric_index_type > &	dof_indices
	)		`[inline, inherited]`

$ U=V $ where U and V are type DenseVector<T> and you want to specify WHERE to insert the DenseVector<T> V

Definition at line 842 of file numeric_vector.h.

References libMesh::DenseVector< T >::empty(), libMesh::libmesh_assert(), and libMesh::DenseVector< T >::size().

{
  libmesh_assert(v.size() == dof_indices.size());
  if (!v.empty())
    this->insert(&v(0), dof_indices);
}

template<typename T>

void libMesh::NumericVector< T >::insert	(	const DenseSubVector< T > &	V,
		const std::vector< numeric_index_type > &	dof_indices
	)		`[inline, inherited]`

$ U=V $ where V is a DenseSubVector<T> and you want to specify WHERE to insert it

Definition at line 854 of file numeric_vector.h.

References libMesh::DenseVectorBase< T >::empty(), libMesh::libmesh_assert(), and libMesh::DenseVectorBase< T >::size().

{
  libmesh_assert(v.size() == dof_indices.size());
  if (!v.empty())
    this->insert(&v(0), dof_indices);
}

template<typename T >

Real libMesh::EpetraVector< T >::l1_norm ( ) const [virtual]

Returns:: the -norm of the vector, i.e. the sum of the absolute values.

Implements libMesh::NumericVector< T >.

Definition at line 67 of file trilinos_epetra_vector.C.

References libMesh::closed(), libMesh::libmesh_assert(), and libMesh::Real.

{
  libmesh_assert(this->closed());

  Real value;

  _vec->Norm1(&value);

  return value;
}

template<typename T >

Real libMesh::EpetraVector< T >::l2_norm ( ) const [virtual]

Returns:: the -norm of the vector, i.e. the square root of the sum of the squares of the elements.

Implements libMesh::NumericVector< T >.

Definition at line 79 of file trilinos_epetra_vector.C.

References libMesh::closed(), libMesh::libmesh_assert(), and libMesh::Real.

{
  libmesh_assert(this->closed());

  Real value;

  _vec->Norm2(&value);

  return value;
}

template<typename T >

numeric_index_type libMesh::EpetraVector< T >::last_local_index ( ) const [inline, virtual]

Returns:: the index of the last vector element actually stored on this processor

Implements libMesh::NumericVector< T >.

Definition at line 956 of file trilinos_epetra_vector.h.

References libMesh::initialized(), and libMesh::libmesh_assert().

{
  libmesh_assert (this->initialized());

  return _vec->Map().MaxMyGID()+1;
}

template<typename T >

Real libMesh::EpetraVector< T >::linfty_norm ( ) const [virtual]

Returns:: the maximum absolute value of the elements of this vector, which is the $l_\infty$ -norm of a vector.

Implements libMesh::NumericVector< T >.

Definition at line 91 of file trilinos_epetra_vector.C.

References libMesh::closed(), libMesh::libmesh_assert(), and libMesh::Real.

{
  libmesh_assert(this->closed());

  Real value;

  _vec->NormInf(&value);

  return value;
}

template<typename T>

int libMesh::NumericVector< T >::local_relative_compare	(	const NumericVector< T > &	other_vector,
		const Real	threshold = `TOLERANCE`
	)		const `[virtual, inherited]`

Returns:: -1 when this is equivalent to other_vector, up to the given local relative threshold. When differences occur, the return value contains the first index where the difference (a[i]-b[i])/max(a[i],b[i]) exceeded the threshold. When no threshold is given, the libMesh TOLERANCE is used.

Definition at line 148 of file numeric_vector.C.

References std::abs(), libMesh::NumericVector< T >::first_local_index(), libMesh::NumericVector< T >::initialized(), libMesh::initialized(), libMesh::NumericVector< T >::last_local_index(), libMesh::libmesh_assert(), and std::max().

{
  libmesh_assert (this->initialized());
  libmesh_assert (other_vector.initialized());
  libmesh_assert_equal_to (this->first_local_index(), other_vector.first_local_index());
  libmesh_assert_equal_to (this->last_local_index(), other_vector.last_local_index());

  int first_different_i = std::numeric_limits<int>::max();
  numeric_index_type i = first_local_index();

  do
    {
      if ( std::abs( (*this)(i) - other_vector(i) ) > threshold *
           std::max(std::abs((*this)(i)), std::abs(other_vector(i))))
        first_different_i = i;
      else
        i++;
    }
  while (first_different_i==std::numeric_limits<int>::max()
         && i<last_local_index());

  // Find the correct first differing index in parallel
  this->comm().min(first_different_i);

  if (first_different_i == std::numeric_limits<int>::max())
    return -1;

  return first_different_i;
}

template<typename T >

numeric_index_type libMesh::EpetraVector< T >::local_size ( ) const [inline, virtual]

Returns:: the local size of the vector (index_stop-index_start)

Implements libMesh::NumericVector< T >.

Definition at line 936 of file trilinos_epetra_vector.h.

References libMesh::initialized(), and libMesh::libmesh_assert().

{
  libmesh_assert (this->initialized());

  return _vec->MyLength();
}

template<typename T >

void libMesh::EpetraVector< T >::localize ( std::vector< T > & v_local ) const [virtual]

Creates a copy of the global vector in the local vector v_local.

Implements libMesh::NumericVector< T >.

Definition at line 479 of file trilinos_epetra_vector.C.

References libMesh::libmesh_assert().

Referenced by libMesh::EpetraVector< T >::localize().

{
  // This function must be run on all processors at once
  parallel_object_only();

  const unsigned int n  = this->size();
  const unsigned int nl = this->local_size();

  libmesh_assert(this->_vec);

  v_local.clear();
  v_local.reserve(n);

  // build up my local part
  for (unsigned int i=0; i<nl; i++)
    v_local.push_back((*this->_vec)[i]);

  this->comm().allgather (v_local);
}

template<typename T >

void libMesh::EpetraVector< T >::localize ( NumericVector< T > & v_local ) const [virtual]

Same, but fills a NumericVector<T> instead of a std::vector.

Implements libMesh::NumericVector< T >.

Definition at line 407 of file trilinos_epetra_vector.C.

References libMesh::EpetraVector< T >::_vec.

{
  EpetraVector<T>* v_local = cast_ptr<EpetraVector<T>*>(&v_local_in);

  Epetra_Map rootMap = Epetra_Util::Create_Root_Map( *_map, -1);
  v_local->_vec->ReplaceMap(rootMap);

  Epetra_Import importer(v_local->_vec->Map(), *_map);
  v_local->_vec->Import(*_vec, importer, Insert);
}

template<typename T >

void libMesh::EpetraVector< T >::localize	(	NumericVector< T > &	v_local,
		const std::vector< numeric_index_type > &	send_list
	)		const `[virtual]`

Creates a local vector v_local containing only information relevant to this processor, as defined by the send_list.

Implements libMesh::NumericVector< T >.

Definition at line 421 of file trilinos_epetra_vector.C.

References libMesh::EpetraVector< T >::localize().

Referenced by libMesh::EpetraVector< T >::localize().

{
  // TODO: optimize to sync only the send list values
  this->localize(v_local_in);

  //   EpetraVector<T>* v_local =
  //   cast_ptr<EpetraVector<T>*>(&v_local_in);

  //   libmesh_assert(this->_map.get());
  //   libmesh_assert(v_local->_map.get());
  //   libmesh_assert_equal_to (v_local->local_size(), this->size());
  //   libmesh_assert_less_equal (send_list.size(), v_local->size());

  //   Epetra_Import importer (*v_local->_map, *this->_map);

  //   v_local->_vec->Import (*this->_vec, importer, Insert);
}

template<typename T >

void libMesh::EpetraVector< T >::localize	(	const numeric_index_type	first_local_idx,
		const numeric_index_type	last_local_idx,
		const std::vector< numeric_index_type > &	send_list
	)		`[virtual]`

Updates a local vector with selected values from neighboring processors, as defined by send_list.

Implements libMesh::NumericVector< T >.

Definition at line 442 of file trilinos_epetra_vector.C.

References libMesh::EpetraVector< T >::close(), libMesh::EpetraVector< T >::init(), libMesh::EpetraVector< T >::localize(), libMesh::PARALLEL, and libMesh::EpetraVector< T >::set().

{
  // Only good for serial vectors.
  libmesh_assert_equal_to (this->size(), this->local_size());
  libmesh_assert_greater (last_local_idx, first_local_idx);
  libmesh_assert_less_equal (send_list.size(), this->size());
  libmesh_assert_less (last_local_idx, this->size());

  const unsigned int my_size       = this->size();
  const unsigned int my_local_size = (last_local_idx - first_local_idx + 1);

  // Don't bother for serial cases
  if ((first_local_idx == 0) &&
      (my_local_size == my_size))
    return;

  // Build a parallel vector, initialize it with the local
  // parts of (*this)
  EpetraVector<T> parallel_vec(this->comm(), PARALLEL);

  parallel_vec.init (my_size, my_local_size, true, PARALLEL);

  // Copy part of *this into the parallel_vec
  for (numeric_index_type i=first_local_idx; i<=last_local_idx; i++)
    parallel_vec.set(i,this->el(i));

  // localize like normal
  parallel_vec.close();
  parallel_vec.localize (*this, send_list);
  this->close();
}

template<typename T >

void libMesh::EpetraVector< T >::localize_to_one	(	std::vector< T > &	v_local,
		const processor_id_type	proc_id = `0`
	)		const `[virtual]`

Creates a local copy of the global vector in v_local only on processor proc_id. By default the data is sent to processor 0. This method is useful for outputting data from one processor.

Implements libMesh::NumericVector< T >.

Definition at line 502 of file trilinos_epetra_vector.C.

References libMesh::libmesh_assert(), and libMesh::n_processors().

{
  // This function must be run on all processors at once
  parallel_object_only();

  const unsigned int n  = this->size();
  const unsigned int nl = this->local_size();

  libmesh_assert_less (pid, this->n_processors());
  libmesh_assert(this->_vec);

  v_local.clear();
  v_local.reserve(n);


  // build up my local part
  for (unsigned int i=0; i<nl; i++)
    v_local.push_back((*this->_vec)[i]);

  this->comm().gather (pid, v_local);
}

template<typename T >

Real libMesh::EpetraVector< T >::max ( ) const [inline, virtual]

Returns:: the maximum element in the vector. In case of complex numbers, this returns the maximum Real part.

Implements libMesh::NumericVector< T >.

Definition at line 994 of file trilinos_epetra_vector.h.

References libMesh::initialized(), and libMesh::libmesh_assert().

{
  libmesh_assert (this->initialized());

  T value;

  _vec->MaxValue(&value);

  return value;
}

template<typename T >

Real libMesh::EpetraVector< T >::min ( ) const [inline, virtual]

Returns:: the minimum element in the vector. In case of complex numbers, this returns the minimum Real part.

Implements libMesh::NumericVector< T >.

Definition at line 979 of file trilinos_epetra_vector.h.

References libMesh::initialized(), and libMesh::libmesh_assert().

{
  libmesh_assert (this->initialized());

  T value;

  _vec->MinValue(&value);

  return value;
}

static unsigned int libMesh::ReferenceCounter::n_objects ( ) [inline, static, inherited]

Prints the number of outstanding (created, but not yet destroyed) objects.

Definition at line 79 of file reference_counter.h.

References libMesh::ReferenceCounter::_n_objects.

Referenced by libMesh::LibMeshInit::~LibMeshInit().

  { return _n_objects; }

processor_id_type libMesh::ParallelObject::n_processors ( ) const [inline, inherited]

Returns:: the number of processors in the group.

Definition at line 92 of file parallel_object.h.

References libMesh::ParallelObject::_communicator, and libMesh::Parallel::Communicator::size().

  { return cast_int<processor_id_type>(_communicator.size()); }

template<typename T >

T libMesh::EpetraVector< T >::operator() ( const numeric_index_type i ) const [inline, virtual]

Access components, returns U(i).

Implements libMesh::NumericVector< T >.

Definition at line 966 of file trilinos_epetra_vector.h.

References libMesh::initialized(), and libMesh::libmesh_assert().

{
  libmesh_assert (this->initialized());
  libmesh_assert ( ((i >= this->first_local_index()) &&
                    (i <  this->last_local_index())) );

  return (*_vec)[i-this->first_local_index()];
}

template<typename T>

NumericVector<T>& libMesh::NumericVector< T >::operator*= ( const T a ) [inline, inherited]

Multiplication operator. Equivalent to U.scale(a)

Definition at line 378 of file numeric_vector.h.

{ this->scale(a); return *this; }

template<typename T >

NumericVector< T > & libMesh::EpetraVector< T >::operator+= ( const NumericVector< T > & V ) [virtual]

Addition operator. Fast equivalent to U.add(1, V).

Implements libMesh::NumericVector< T >.

Definition at line 104 of file trilinos_epetra_vector.C.

References libMesh::closed(), and libMesh::libmesh_assert().

{
  libmesh_assert(this->closed());

  this->add(1., v);

  return *this;
}

template<typename T >

NumericVector< T > & libMesh::EpetraVector< T >::operator-= ( const NumericVector< T > & V ) [virtual]

Subtraction operator. Fast equivalent to U.add(-1, V).

Implements libMesh::NumericVector< T >.

Definition at line 117 of file trilinos_epetra_vector.C.

References libMesh::closed(), and libMesh::libmesh_assert().

{
  libmesh_assert(this->closed());

  this->add(-1., v);

  return *this;
}

template<typename T >

NumericVector< T > & libMesh::EpetraVector< T >::operator/= ( NumericVector< T > & v ) [virtual]

Pointwise Division operator. ie divide every entry in this vector by the entry in v

Implements libMesh::NumericVector< T >.

Definition at line 129 of file trilinos_epetra_vector.C.

References libMesh::closed(), libMesh::libmesh_assert(), and libMesh::NumericVector< T >::size().

{
  libmesh_assert(this->closed());
  libmesh_assert_equal_to(size(), v.size());

  EpetraVector<T> & v_vec = cast_ref<EpetraVector<T>&>(v);

  _vec->ReciprocalMultiply(1.0, *v_vec._vec, *_vec, 0.0);
}

template<typename T>

NumericVector<T>& libMesh::NumericVector< T >::operator/= ( const T a ) [inline, inherited]

Division operator. Equivalent to U.scale(1./a)

Definition at line 384 of file numeric_vector.h.

{ this->scale(1./a); return *this; }

template<typename T >

NumericVector< T > & libMesh::EpetraVector< T >::operator= ( const T s ) [virtual]

Change the dimension to that of the vector V. The same applies as for the other init function.

The elements of V are not copied, i.e. this function is the same as calling init(V.size(),fast). $U(0-N) = s$ : fill all components.

Implements libMesh::NumericVector< T >.

Definition at line 333 of file trilinos_epetra_vector.C.

{
  _vec->PutScalar(s_in);

  return *this;
}

template<typename T >

NumericVector< T > & libMesh::EpetraVector< T >::operator= ( const NumericVector< T > & V ) [virtual]

$U = V$ : copy all components.

Implements libMesh::NumericVector< T >.

Definition at line 344 of file trilinos_epetra_vector.C.

{
  const EpetraVector<T>* v = cast_ptr<const EpetraVector<T>*>(&v_in);

  *this = *v;

  return *this;
}

template<typename T >

EpetraVector< T > & libMesh::EpetraVector< T >::operator= ( const EpetraVector< T > & V )

$U = V$ : copy all components.

Definition at line 357 of file trilinos_epetra_vector.C.

References libMesh::EpetraVector< T >::_vec.

{
  (*_vec) = *v._vec;

  // FIXME - what about our communications data?

  return *this;
}

template<typename T >

NumericVector< T > & libMesh::EpetraVector< T >::operator= ( const std::vector< T > & v ) [virtual]

$U = V$ : copy all components.

Case 1: The vector is the same size of The global vector. Only add the local components.

Case 2: The vector is the same size as our local piece. Insert directly to the local piece.

Implements libMesh::NumericVector< T >.

Definition at line 370 of file trilinos_epetra_vector.C.

{
  T * values = _vec->Values();

  if(this->size() == v.size())
    {
      const unsigned int nl=this->local_size();
      const unsigned int fli=this->first_local_index();

      for(unsigned int i=0;i<nl;i++)
        values[i]=v[fli+i];
    }

  else
    {
      libmesh_assert_equal_to (v.size(), this->local_size());

      const unsigned int nl=this->local_size();

      for(unsigned int i=0;i<nl;i++)
        values[i]=v[i];
    }

  return *this;
}

template<typename T >

void libMesh::EpetraVector< T >::pointwise_mult	(	const NumericVector< T > &	vec1,
		const NumericVector< T > &	vec2
	)		`[virtual]`

Computes the pointwise (i.e. component-wise) product of vec1 and vec2 and stores the result in *this.

Implements libMesh::NumericVector< T >.

Definition at line 321 of file trilinos_epetra_vector.C.

References libMesh::EpetraVector< T >::_vec.

{
  const EpetraVector<T>* V1 = cast_ptr<const EpetraVector<T>*>(&vec1);
  const EpetraVector<T>* V2 = cast_ptr<const EpetraVector<T>*>(&vec2);

  _vec->Multiply(1.0, *V1->_vec, *V2->_vec, 0.0);
}

template<typename T >

void libMesh::NumericVector< T >::print ( std::ostream & os = libMesh::out ) const [inline, virtual, inherited]

Prints the local contents of the vector, by default to libMesh::out

Definition at line 887 of file numeric_vector.h.

References libMesh::initialized(), and libMesh::libmesh_assert().

{
  libmesh_assert (this->initialized());
  os << "Size\tglobal =  " << this->size()
     << "\t\tlocal =  " << this->local_size() << std::endl;

  os << "#\tValue" << std::endl;
  for (numeric_index_type i=this->first_local_index(); i<this->last_local_index(); i++)
    os << i << "\t" << (*this)(i) << std::endl;
}

template<>

void libMesh::NumericVector< Complex >::print ( std::ostream & os ) const [inline, inherited]

Definition at line 869 of file numeric_vector.h.

References libMesh::initialized(), and libMesh::libmesh_assert().

{
  libmesh_assert (this->initialized());
  os << "Size\tglobal =  " << this->size()
     << "\t\tlocal =  " << this->local_size() << std::endl;

  // std::complex<>::operator<<() is defined, but use this form
  os << "#\tReal part\t\tImaginary part" << std::endl;
  for (numeric_index_type i=this->first_local_index(); i<this->last_local_index(); i++)
    os << i << "\t"
       << (*this)(i).real() << "\t\t"
       << (*this)(i).imag() << std::endl;
}

template<typename T >

void libMesh::NumericVector< T >::print_global ( std::ostream & os = libMesh::out ) const [inline, virtual, inherited]

Prints the global contents of the vector, by default to libMesh::out

Definition at line 924 of file numeric_vector.h.

References libMesh::initialized(), libMesh::libmesh_assert(), and libMesh::processor_id().

{
  libmesh_assert (this->initialized());

  std::vector<T> v(this->size());
  this->localize(v);

  // Right now we only want one copy of the output
  if (this->processor_id())
    return;

  os << "Size\tglobal =  " << this->size() << std::endl;
  os << "#\tValue" << std::endl;
  for (numeric_index_type i=0; i!=v.size(); i++)
    os << i << "\t" << v[i] << std::endl;
}

template<>

void libMesh::NumericVector< Complex >::print_global ( std::ostream & os ) const [inline, inherited]

Definition at line 902 of file numeric_vector.h.

References libMesh::initialized(), libMesh::libmesh_assert(), and libMesh::processor_id().

{
  libmesh_assert (this->initialized());

  std::vector<Complex> v(this->size());
  this->localize(v);

  // Right now we only want one copy of the output
  if (this->processor_id())
    return;

  os << "Size\tglobal =  " << this->size() << std::endl;
  os << "#\tReal part\t\tImaginary part" << std::endl;
  for (numeric_index_type i=0; i!=v.size(); i++)
    os << i << "\t"
       << v[i].real() << "\t\t"
       << v[i].imag() << std::endl;
}

void libMesh::ReferenceCounter::print_info ( std::ostream & out = libMesh::out ) [static, inherited]

Prints the reference information, by default to libMesh::out.

Definition at line 88 of file reference_counter.C.

References libMesh::ReferenceCounter::_enable_print_counter, and libMesh::ReferenceCounter::get_info().

Referenced by libMesh::LibMeshInit::~LibMeshInit().

{
  if( _enable_print_counter ) out_stream << ReferenceCounter::get_info();
}

template<typename T>

virtual void libMesh::NumericVector< T >::print_matlab ( const std::string & = "" ) const [inline, virtual, inherited]

Print the contents of the matrix in Matlab's sparse matrix format. Optionally prints the matrix to the file named name. If name is not specified it is dumped to the screen.

Reimplemented in libMesh::PetscVector< T >.

Definition at line 645 of file numeric_vector.h.

  {
    libmesh_not_implemented();
  }

processor_id_type libMesh::ParallelObject::processor_id ( ) const [inline, inherited]

Returns:: the rank of this processor in the group.

Definition at line 98 of file parallel_object.h.

References libMesh::ParallelObject::_communicator, and libMesh::Parallel::Communicator::rank().

  { return cast_int<processor_id_type>(_communicator.rank()); }

template<typename T >

void libMesh::EpetraVector< T >::reciprocal ( ) [virtual]

Replace each entry v_i of this vector by its reciprocal, 1/v_i.

Implements libMesh::NumericVector< T >.

Definition at line 158 of file trilinos_epetra_vector.C.

References std::abs(), and std::min().

{
  // The Epetra::reciprocal() function takes a constant reference to *another* vector,
  // and fills _vec with its reciprocal.  Does that mean we can't pass *_vec as the
  // argument?
  // _vec->reciprocal( *_vec );

  // Alternatively, compute the reciprocal by hand... see also the add(T) member that does this...
  const unsigned int nl = _vec->MyLength();

  T* values = _vec->Values();

  for (unsigned int i=0; i<nl; i++)
    {
      // Don't divide by zero (maybe only check this in debug mode?)
      if (std::abs(values[i]) < std::numeric_limits<T>::min())
        libmesh_error_msg("Error, divide by zero in DistributedVector<T>::reciprocal()!");

      values[i] = 1. / values[i];
    }

  // Leave the vector in a closed state...
  this->close();
}

template<typename T >

int libMesh::EpetraVector< T >::ReplaceGlobalValues	(	int	numIDs,
		const int *	GIDs,
		const double *	values
	)		`[private]`

Copy values into the vector overwriting any values that already exist for the specified indices.

Definition at line 573 of file trilinos_epetra_vector.C.

{
  return( inputValues( numIDs, GIDs, values, false) );
}

template<typename T >

int libMesh::EpetraVector< T >::ReplaceGlobalValues	(	const Epetra_IntSerialDenseVector &	GIDs,
		const Epetra_SerialDenseVector &	values
	)		`[private]`

Copy values into the vector, replacing any values that already exist for the specified GIDs.

Parameters:

GIDs	List of global ids. Must be the same length as the accompanying list of values.
values	List of coefficient values. Must be the same length as the accompanying list of GIDs.

Definition at line 581 of file trilinos_epetra_vector.C.

{
  if (GIDs.Length() != values.Length()) {
    return(-1);
  }

  return( inputValues( GIDs.Length(), GIDs.Values(), values.Values(), false) );
}

template<typename T >

int libMesh::EpetraVector< T >::ReplaceGlobalValues	(	int	numIDs,
		const int *	GIDs,
		const int *	numValuesPerID,
		const double *	values
	)		`[private]`

Definition at line 593 of file trilinos_epetra_vector.C.

{
  return( inputValues( numIDs, GIDs, numValuesPerID, values, false) );
}

template<typename T >

void libMesh::EpetraVector< T >::scale ( const T factor ) [virtual]

Scale each element of the vector by the given factor.

Implements libMesh::NumericVector< T >.

Definition at line 295 of file trilinos_epetra_vector.C.

{
  _vec->Scale(factor_in);
}

template<typename T >

void libMesh::EpetraVector< T >::set	(	const numeric_index_type	i,
		const T	value
	)		`[virtual]`

v(i) = value

Implements libMesh::NumericVector< T >.

Definition at line 143 of file trilinos_epetra_vector.C.

Referenced by libMesh::EpetraVector< T >::localize().

{
  int i = static_cast<int> (i_in);
  T value = value_in;

  libmesh_assert_less (i_in, this->size());

  ReplaceGlobalValues(1, &i, &value);

  this->_is_closed = false;
}

template<typename T>

void libMesh::EpetraVector< T >::setIgnoreNonLocalEntries ( bool flag ) [inline, private]

Set whether or not non-local data values should be ignored.

Definition at line 551 of file trilinos_epetra_vector.h.

References libMesh::EpetraVector< T >::ignoreNonLocalEntries_.

                                           {
    ignoreNonLocalEntries_ = flag;
  }

template<typename T >

numeric_index_type libMesh::EpetraVector< T >::size ( ) const [inline, virtual]

Returns:: dimension of the vector. This function was formerly called n(), but was renamed to get the EpetraVector<T> class closer to the C++ standard library's std::vector container.

Implements libMesh::NumericVector< T >.

Definition at line 925 of file trilinos_epetra_vector.h.

References libMesh::initialized(), and libMesh::libmesh_assert().

Referenced by libMesh::EpetraVector< T >::add().

{
  libmesh_assert (this->initialized());

  return _vec->GlobalLength();
}

template<class T >

Real libMesh::NumericVector< T >::subset_l1_norm ( const std::set< numeric_index_type > & indices ) const [virtual, inherited]

Returns:: the -norm of the vector, i.e. the sum of the absolute values for the specified entries in the vector.

Note that the indices must necessary live on this processor.

Definition at line 324 of file numeric_vector.C.

References std::abs(), and libMesh::Real.

Referenced by libMesh::System::discrete_var_norm().

{
  const NumericVector<T> & v = *this;

  std::set<numeric_index_type>::const_iterator it = indices.begin();
  const std::set<numeric_index_type>::const_iterator it_end = indices.end();

  Real norm = 0;

  for(; it!=it_end; ++it)
    norm += std::abs(v(*it));

  this->comm().sum(norm);

  return norm;
}

template<class T >

Real libMesh::NumericVector< T >::subset_l2_norm ( const std::set< numeric_index_type > & indices ) const [virtual, inherited]

Returns:: the -norm of the vector, i.e. the square root of the sum of the squares of the elements for the specified entries in the vector.

Note that the indices must necessary live on this processor.

Definition at line 342 of file numeric_vector.C.

References libMesh::TensorTools::norm_sq(), and libMesh::Real.

Referenced by libMesh::System::discrete_var_norm().

{
  const NumericVector<T> & v = *this;

  std::set<numeric_index_type>::const_iterator it = indices.begin();
  const std::set<numeric_index_type>::const_iterator it_end = indices.end();

  Real norm = 0;

  for(; it!=it_end; ++it)
    norm += TensorTools::norm_sq(v(*it));

  this->comm().sum(norm);

  return std::sqrt(norm);
}

template<class T >

Real libMesh::NumericVector< T >::subset_linfty_norm ( const std::set< numeric_index_type > & indices ) const [virtual, inherited]

Returns:: the maximum absolute value of the specified entries of this vector, which is the $l_\infty$ -norm of a vector.

Note that the indices must necessary live on this processor.

Definition at line 360 of file numeric_vector.C.

References std::abs(), and libMesh::Real.

Referenced by libMesh::System::discrete_var_norm().

{
  const NumericVector<T> & v = *this;

  std::set<numeric_index_type>::const_iterator it = indices.begin();
  const std::set<numeric_index_type>::const_iterator it_end = indices.end();

  Real norm = 0;

  for(; it!=it_end; ++it)
    {
      Real value = std::abs(v(*it));
      if(value > norm)
        norm = value;
    }

  this->comm().max(norm);

  return norm;
}

template<typename T >

T libMesh::EpetraVector< T >::sum ( ) const [virtual]

Returns:: the sum of values in a vector

Implements libMesh::NumericVector< T >.

Definition at line 48 of file trilinos_epetra_vector.C.

References libMesh::closed(), libMesh::libmesh_assert(), and libMesh::Parallel::sum().

{
  libmesh_assert(this->closed());

  const unsigned int nl = _vec->MyLength();

  T sum=0.0;

  T * values = _vec->Values();

  for (unsigned int i=0; i<nl; i++)
    sum += values[i];

  this->comm().sum(sum);

  return sum;
}

template<typename T >

int libMesh::EpetraVector< T >::SumIntoGlobalValues	(	int	numIDs,
		const int *	GIDs,
		const double *	values
	)		`[private]`

Accumulate values into the vector, adding them to any values that already exist for the specified indices.

Definition at line 544 of file trilinos_epetra_vector.C.

{
  return( inputValues( numIDs, GIDs, values, true) );
}

template<typename T >

int libMesh::EpetraVector< T >::SumIntoGlobalValues	(	const Epetra_IntSerialDenseVector &	GIDs,
		const Epetra_SerialDenseVector &	values
	)		`[private]`

Accumulate values into the vector, adding them to any values that already exist for the specified GIDs.

Parameters:

GIDs	List of global ids. Must be the same length as the accompanying list of values.
values	List of coefficient values. Must be the same length as the accompanying list of GIDs.

Definition at line 552 of file trilinos_epetra_vector.C.

{
  if (GIDs.Length() != values.Length()) {
    return(-1);
  }

  return( inputValues( GIDs.Length(), GIDs.Values(), values.Values(), true) );
}

template<typename T >

int libMesh::EpetraVector< T >::SumIntoGlobalValues	(	int	numIDs,
		const int *	GIDs,
		const int *	numValuesPerID,
		const double *	values
	)		`[private]`

Definition at line 564 of file trilinos_epetra_vector.C.

{
  return( inputValues( numIDs, GIDs, numValuesPerID, values, true) );
}

template<typename T >

void libMesh::EpetraVector< T >::swap ( NumericVector< T > & v ) [inline, virtual]

Swaps the raw Epetra vector context pointers.

Reimplemented from libMesh::NumericVector< T >.

Definition at line 1009 of file trilinos_epetra_vector.h.

{
  NumericVector<T>::swap(other);

  EpetraVector<T>& v = cast_ref<EpetraVector<T>&>(other);

  std::swap(_vec, v._vec);
  std::swap(_map, v._map);
  std::swap(_destroy_vec_on_exit, v._destroy_vec_on_exit);
  std::swap(myFirstID_, v.myFirstID_);
  std::swap(myNumIDs_, v.myNumIDs_);
  std::swap(myCoefs_, v.myCoefs_);
  std::swap(nonlocalIDs_, v.nonlocalIDs_);
  std::swap(nonlocalElementSize_, v.nonlocalElementSize_);
  std::swap(numNonlocalIDs_, v.numNonlocalIDs_);
  std::swap(allocatedNonlocalLength_, v.allocatedNonlocalLength_);
  std::swap(nonlocalCoefs_, v.nonlocalCoefs_);
  std::swap(last_edit, v.last_edit);
  std::swap(ignoreNonLocalEntries_, v.ignoreNonLocalEntries_);
}

template<typename T>

ParallelType libMesh::NumericVector< T >::type ( ) const [inline, inherited]

Returns:: the type (SERIAL, PARALLEL, GHOSTED) of the vector.

Definition at line 136 of file numeric_vector.h.

Referenced by libMesh::DofMap::enforce_adjoint_constraints_exactly(), libMesh::DofMap::enforce_constraints_exactly(), libMesh::EpetraVector< T >::EpetraVector(), libMesh::AdjointRefinementEstimator::estimate_error(), libMesh::MeshFunction::find_element(), libMesh::DistributedVector< T >::init(), libMesh::LaspackVector< T >::init(), libMesh::EigenSparseVector< T >::init(), libMesh::EpetraVector< T >::init(), libMesh::PetscVector< T >::localize(), libMesh::PetscVector< T >::operator=(), libMesh::System::project_vector(), and libMesh::System::read_serialized_vector().

{ return _type; }

template<typename T>

ParallelType& libMesh::NumericVector< T >::type ( ) [inline, inherited]

Returns:: the type (SERIAL, PARALLEL, GHOSTED) of the vector.

Definition at line 141 of file numeric_vector.h.

{ return _type; }

template<typename T>

Epetra_Vector* libMesh::EpetraVector< T >::vec ( ) [inline]

Returns the raw PETSc vector context pointer. Note this is generally not required in user-level code. Just don't do anything crazy like calling LibMeshVecDestroy()!

Definition at line 468 of file trilinos_epetra_vector.h.

References libMesh::EpetraVector< T >::_vec, and libMesh::libmesh_assert().

Referenced by libMesh::EpetraMatrix< T >::get_diagonal(), and libMesh::NoxNonlinearSolver< T >::solve().

{ libmesh_assert(_vec); return _vec; }

template<typename T >

void libMesh::EpetraVector< T >::zero ( ) [inline, virtual]

Set all entries to zero. Equivalent to v = 0, but more obvious and faster.

Implements libMesh::NumericVector< T >.

Definition at line 883 of file trilinos_epetra_vector.h.

References libMesh::closed(), libMesh::initialized(), and libMesh::libmesh_assert().

{
  libmesh_assert (this->initialized());
  libmesh_assert (this->closed());

  _vec->PutScalar(0.0);
}

template<typename T >

UniquePtr< NumericVector< T > > libMesh::EpetraVector< T >::zero_clone ( ) const [inline, virtual]

Creates a vector which has the same type, size and partitioning as this vector, but whose data is all zero. Returns it in an UniquePtr.

Implements libMesh::NumericVector< T >.

Definition at line 895 of file trilinos_epetra_vector.h.

References libMesh::AUTOMATIC.

Referenced by libMesh::EpetraVector< T >::add_vector().

{
  UniquePtr<NumericVector<T> > cloned_vector
    (new EpetraVector<T>(this->comm(), AUTOMATIC));

  cloned_vector->init(*this);

  return cloned_vector;
}

Friends And Related Function Documentation

template<typename T>

std::ostream& operator<<	(	std::ostream &	os,
		const NumericVector< T > &	v
	)		`[friend, inherited]`

Same as above but allows you to use stream syntax.

Definition at line 633 of file numeric_vector.h.

  {
    v.print_global(os);
    return os;
  }

Member Data Documentation

const Parallel::Communicator& libMesh::ParallelObject::_communicator [protected, inherited]

Definition at line 104 of file parallel_object.h.

Referenced by libMesh::EquationSystems::build_solution_vector(), libMesh::ParallelObject::comm(), libMesh::EquationSystems::get_solution(), libMesh::ParallelObject::n_processors(), libMesh::ParallelObject::operator=(), and libMesh::ParallelObject::processor_id().

ReferenceCounter::Counts libMesh::ReferenceCounter::_counts [static, protected, inherited]

Actually holds the data.

Definition at line 118 of file reference_counter.h.

Referenced by libMesh::ReferenceCounter::get_info(), libMesh::ReferenceCounter::increment_constructor_count(), and libMesh::ReferenceCounter::increment_destructor_count().

template<typename T>

bool libMesh::EpetraVector< T >::_destroy_vec_on_exit [private]

This boolean value should only be set to false for the constructor which takes a Epetra Vec object.

Definition at line 487 of file trilinos_epetra_vector.h.

Referenced by libMesh::EpetraVector< T >::swap().

bool libMesh::ReferenceCounter::_enable_print_counter = true [static, protected, inherited]

Flag to control whether reference count information is printed when print_info is called.

Definition at line 137 of file reference_counter.h.

Referenced by libMesh::ReferenceCounter::disable_print_counter_info(), libMesh::ReferenceCounter::enable_print_counter_info(), and libMesh::ReferenceCounter::print_info().

template<typename T>

bool libMesh::NumericVector< T >::_is_closed [protected, inherited]

Flag to see if the Numeric assemble routines have been called yet

Definition at line 675 of file numeric_vector.h.

Referenced by libMesh::NumericVector< Number >::closed(), libMesh::DistributedVector< T >::localize(), libMesh::DistributedVector< T >::operator=(), libMesh::EigenSparseVector< T >::swap(), and libMesh::NumericVector< T >::swap().

template<typename T>

bool libMesh::NumericVector< T >::_is_initialized [protected, inherited]

Flag to tell if init has been called yet

Definition at line 681 of file numeric_vector.h.

Referenced by libMesh::PetscVector< T >::create_subvector(), libMesh::NumericVector< Number >::initialized(), libMesh::DistributedVector< T >::localize(), libMesh::DistributedVector< T >::operator=(), libMesh::EigenSparseVector< T >::swap(), and libMesh::NumericVector< T >::swap().

template<typename T>

Epetra_Map* libMesh::EpetraVector< T >::_map [private]

Holds the distributed Map

Definition at line 481 of file trilinos_epetra_vector.h.

Referenced by libMesh::EpetraVector< T >::swap().

Threads::spin_mutex libMesh::ReferenceCounter::_mutex [static, protected, inherited]

Mutual exclusion object to enable thread-safe reference counting.

Definition at line 131 of file reference_counter.h.

Threads::atomic< unsigned int > libMesh::ReferenceCounter::_n_objects [static, protected, inherited]

The number of objects. Print the reference count information when the number returns to 0.

Definition at line 126 of file reference_counter.h.

Referenced by libMesh::ReferenceCounter::n_objects(), libMesh::ReferenceCounter::ReferenceCounter(), and libMesh::ReferenceCounter::~ReferenceCounter().

template<typename T>

ParallelType libMesh::NumericVector< T >::_type [protected, inherited]

Type of vector

Definition at line 686 of file numeric_vector.h.

Referenced by libMesh::DistributedVector< T >::DistributedVector(), libMesh::EigenSparseVector< T >::EigenSparseVector(), libMesh::EpetraVector< T >::EpetraVector(), libMesh::PetscVector< T >::init(), libMesh::LaspackVector< T >::LaspackVector(), libMesh::PetscVector< T >::operator=(), libMesh::PetscVector< T >::PetscVector(), libMesh::EigenSparseVector< T >::swap(), libMesh::NumericVector< T >::swap(), and libMesh::NumericVector< Number >::type().

template<typename T>

Epetra_Vector* libMesh::EpetraVector< T >::_vec [private]

Actual Epetra vector datatype to hold vector entries

Definition at line 476 of file trilinos_epetra_vector.h.

Referenced by libMesh::EpetraVector< T >::add(), libMesh::EpetraVector< T >::add_vector(), libMesh::EpetraVector< T >::dot(), libMesh::EpetraVector< T >::FEoperatorequals(), libMesh::EpetraVector< T >::localize(), libMesh::EpetraVector< T >::operator=(), libMesh::EpetraVector< T >::pointwise_mult(), libMesh::EpetraVector< T >::swap(), and libMesh::EpetraVector< T >::vec().

template<typename T>

int libMesh::EpetraVector< T >::allocatedNonlocalLength_ [private]

Definition at line 580 of file trilinos_epetra_vector.h.

Referenced by libMesh::EpetraVector< T >::FEoperatorequals(), and libMesh::EpetraVector< T >::swap().

template<typename T>

bool libMesh::EpetraVector< T >::ignoreNonLocalEntries_ [private]

Definition at line 590 of file trilinos_epetra_vector.h.

Referenced by libMesh::EpetraVector< T >::setIgnoreNonLocalEntries(), and libMesh::EpetraVector< T >::swap().

template<typename T>

unsigned char libMesh::EpetraVector< T >::last_edit [private]

Keep track of whether the last write operation on this vector was nothing (0) or a sum (1) or an add (2), so we can decide how to do the GlobalAssemble()

Definition at line 588 of file trilinos_epetra_vector.h.

Referenced by libMesh::EpetraVector< T >::swap().

template<typename T>

double* libMesh::EpetraVector< T >::myCoefs_ [private]

Definition at line 575 of file trilinos_epetra_vector.h.

Referenced by libMesh::EpetraVector< T >::swap().

template<typename T>

int libMesh::EpetraVector< T >::myFirstID_ [private]

Definition at line 573 of file trilinos_epetra_vector.h.

Referenced by libMesh::EpetraVector< T >::swap().

template<typename T>

int libMesh::EpetraVector< T >::myNumIDs_ [private]