#include <deal.II/lac/trilinos_vector.h>

Inheritance diagram for TrilinosWrappers::Vector:

Public Types
typedef ::types::global_dof_index	size_type

Public Types inherited from TrilinosWrappers::VectorBase
typedef TrilinosScalar	value_type

Public Member Functions
	Vector () DEAL_II_DEPRECATED

	Vector (const size_type n) DEAL_II_DEPRECATED

	Vector (const Epetra_Map &partitioning) DEAL_II_DEPRECATED

	Vector (const IndexSet &partitioning, const MPI_Comm &communicator=MPI_COMM_WORLD) DEAL_II_DEPRECATED

	Vector (const VectorBase &V) DEAL_II_DEPRECATED

template<typename Number >
	Vector (const ::Vector< Number > &v) DEAL_II_DEPRECATED

void	reinit (const size_type n, const bool omit_zeroing_entries=false)

void	reinit (const Epetra_Map &input_map, const bool omit_zeroing_entries=false)

void	reinit (const IndexSet &input_map, const MPI_Comm &communicator=MPI_COMM_WORLD, const bool omit_zeroing_entries=false)

void	reinit (const VectorBase &V, const bool omit_zeroing_entries=false, const bool allow_different_maps=false)

Vector &	operator= (const TrilinosScalar s)

Vector &	operator= (const MPI::Vector &v)

template<typename Number >
Vector &	operator= (const ::Vector< Number > &v)

Vector &	operator= (const Vector &v)

void	update_ghost_values () const

Public Member Functions inherited from TrilinosWrappers::VectorBase
	DeclException0 (ExcDifferentParallelPartitioning)

	DeclException1 (ExcTrilinosError, int,<< "An error with error number "<< arg1<< " occurred while calling a Trilinos function")

	DeclException4 (ExcAccessToNonLocalElement, size_type, size_type, size_type, size_type,<< "You tried to access element "<< arg1<< " of a distributed vector, but this element is not stored "<< "on the current processor. Note: There are "<< arg2<< " elements stored "<< "on the current processor from within the range "<< arg3<< " through "<< arg4<< " but Trilinos vectors need not store contiguous "<< "ranges on each processor, and not every element in "<< "this range may in fact be stored locally.")

	VectorBase ()

	VectorBase (const VectorBase &v)

virtual	~VectorBase ()

void	clear ()

void	reinit (const VectorBase &v, const bool omit_zeroing_entries=false)

void	compress (::VectorOperation::values operation)

bool	is_compressed () const DEAL_II_DEPRECATED

VectorBase &	operator= (const TrilinosScalar s)

VectorBase &	operator= (const VectorBase &v)

template<typename Number >
VectorBase &	operator= (const ::Vector< Number > &v)

bool	operator== (const VectorBase &v) const

bool	operator!= (const VectorBase &v) const

size_type	size () const

size_type	local_size () const

std::pair< size_type, size_type >	local_range () const

bool	in_local_range (const size_type index) const

IndexSet	locally_owned_elements () const

bool	has_ghost_elements () const

TrilinosScalar	operator* (const VectorBase &vec) const

real_type	norm_sqr () const

TrilinosScalar	mean_value () const

TrilinosScalar	minimal_value () const DEAL_II_DEPRECATED

TrilinosScalar	min () const

TrilinosScalar	max () const

real_type	l1_norm () const

real_type	l2_norm () const

real_type	lp_norm (const TrilinosScalar p) const

real_type	linfty_norm () const

TrilinosScalar	add_and_dot (const TrilinosScalar a, const VectorBase &V, const VectorBase &W)

bool	all_zero () const

bool	is_non_negative () const

reference	operator() (const size_type index)

TrilinosScalar	operator() (const size_type index) const

reference	operator[] (const size_type index)

TrilinosScalar	operator[] (const size_type index) const

void	extract_subvector_to (const std::vector< size_type > &indices, std::vector< TrilinosScalar > &values) const

template<typename ForwardIterator , typename OutputIterator >
void	extract_subvector_to (ForwardIterator indices_begin, const ForwardIterator indices_end, OutputIterator values_begin) const

TrilinosScalar	el (const size_type index) const DEAL_II_DEPRECATED

iterator	begin ()

const_iterator	begin () const

iterator	end ()

const_iterator	end () const

void	set (const std::vector< size_type > &indices, const std::vector< TrilinosScalar > &values)

void	set (const std::vector< size_type > &indices, const ::Vector< TrilinosScalar > &values)

void	set (const size_type n_elements, const size_type indices, const TrilinosScalar values)

void	add (const std::vector< size_type > &indices, const std::vector< TrilinosScalar > &values)

void	add (const std::vector< size_type > &indices, const ::Vector< TrilinosScalar > &values)

void	add (const size_type n_elements, const size_type indices, const TrilinosScalar values)

VectorBase &	operator*= (const TrilinosScalar factor)

VectorBase &	operator/= (const TrilinosScalar factor)

VectorBase &	operator+= (const VectorBase &V)

VectorBase &	operator-= (const VectorBase &V)

void	add (const TrilinosScalar s)

void	add (const VectorBase &V, const bool allow_different_maps=false)

void	add (const TrilinosScalar a, const VectorBase &V)

void	add (const TrilinosScalar a, const VectorBase &V, const TrilinosScalar b, const VectorBase &W)

void	sadd (const TrilinosScalar s, const VectorBase &V)

void	sadd (const TrilinosScalar s, const TrilinosScalar a, const VectorBase &V)

void	sadd (const TrilinosScalar s, const TrilinosScalar a, const VectorBase &V, const TrilinosScalar b, const VectorBase &W) DEAL_II_DEPRECATED

void	sadd (const TrilinosScalar s, const TrilinosScalar a, const VectorBase &V, const TrilinosScalar b, const VectorBase &W, const TrilinosScalar c, const VectorBase &X) DEAL_II_DEPRECATED

void	scale (const VectorBase &scaling_factors)

void	equ (const TrilinosScalar a, const VectorBase &V)

void	equ (const TrilinosScalar a, const VectorBase &V, const TrilinosScalar b, const VectorBase &W) DEAL_II_DEPRECATED

void	ratio (const VectorBase &a, const VectorBase &b) DEAL_II_DEPRECATED

const Epetra_MultiVector &	trilinos_vector () const

Epetra_FEVector &	trilinos_vector ()

const Epetra_Map &	vector_partitioner () const

void	print (const char *format=0) const DEAL_II_DEPRECATED

void	print (std::ostream &out, const unsigned int precision=3, const bool scientific=true, const bool across=true) const

void	swap (VectorBase &v)

std::size_t	memory_consumption () const

const MPI_Comm &	get_mpi_communicator () const

Public Member Functions inherited from Subscriptor
	Subscriptor ()

	Subscriptor (const Subscriptor &)

virtual	~Subscriptor ()

Subscriptor &	operator= (const Subscriptor &)

void	subscribe (const char *identifier=0) const

void	unsubscribe (const char *identifier=0) const

unsigned int	n_subscriptions () const

void	list_subscribers () const

	DeclException3 (ExcInUse, int, char *, std::string &,<< "Object of class "<< arg2<< " is still used by "<< arg1<< " other objects."<< "\"<< "(Additional information: "<< arg3<< ")\"<< "See the entry in the Frequently Asked Questions of "<< "deal.II (linked to from http://www.dealii.org/) for "<< "a lot more information on what this error means and "<< "how to fix programs in which it happens.")

	DeclException2 (ExcNoSubscriber, char , char ,<< "No subscriber with identifier <"<< arg2<< "> subscribes to this object of class "<< arg1<< ". Consequently, it cannot be unsubscribed.")

template<class Archive >
void	serialize (Archive &ar, const unsigned int version)

Static Public Attributes
static const bool	supports_distributed_data = false

Related Functions
(Note that these are not member functions.)
void	swap (Vector &u, Vector &v)

Related Functions inherited from TrilinosWrappers::VectorBase
void	swap (VectorBase &u, VectorBase &v)

Detailed Description

This class is a specialization of a Trilinos vector to a localized version. The purpose of this class is to provide a copy interface from the possibly parallel Vector class to a local vector on each processor, in order to be able to access all elements in the vector or to apply certain deal.II functions.

This class is deprecated, use TrilinosWrappers::MPI::Vector instead.

Author: Martin Kronbichler, 2008

Definition at line 729 of file trilinos_vector.h.

Member Typedef Documentation

§ size_type

typedef ::types::global_dof_index TrilinosWrappers::Vector::size_type

Declare type for container size.

Definition at line 735 of file trilinos_vector.h.

Constructor & Destructor Documentation

§ Vector() [1/6]

Vector< Number >::Vector ( )

Default constructor that generates an empty (zero size) vector. The function reinit() will have to give the vector the correct size.

Definition at line 497 of file trilinos_vector.cc.

§ Vector() [2/6]

Vector< Number >::Vector ( const size_type n )

explicit

This constructor takes as input the number of elements in the vector.

Definition at line 506 of file trilinos_vector.cc.

§ Vector() [3/6]

Vector< Number >::Vector ( const Epetra_Map & partitioning )

explicit

This constructor takes as input the number of elements in the vector. If the map is not localized, i.e., if there are some elements that are not present on all processes, only the global size of the map will be taken and a localized map will be generated internally. In other words, which element of the partitioning argument are set is in fact ignored, the only thing that matters is the size of the index space described by this argument.

Definition at line 515 of file trilinos_vector.cc.

§ Vector() [4/6]

Vector< Number >::Vector	(	const IndexSet &	partitioning,
		const MPI_Comm &	communicator = `MPI_COMM_WORLD`
	)

explicit

This constructor takes as input the number of elements in the vector. If the index set is not localized, i.e., if there are some elements that are not present on all processes, only the global size of the index set will be taken and a localized version will be generated internally. In other words, which element of the partitioning argument are set is in fact ignored, the only thing that matters is the size of the index space described by this argument.

Definition at line 526 of file trilinos_vector.cc.

§ Vector() [5/6]

Vector< Number >::Vector ( const VectorBase & V )

explicit

This constructor takes a (possibly parallel) Trilinos Vector and generates a localized version of the whole content on each processor.

Definition at line 543 of file trilinos_vector.cc.

§ Vector() [6/6]

template<typename Number >

TrilinosWrappers::Vector::Vector ( const ::Vector< Number > & v )

explicit

Copy-constructor from deal.II vectors. Sets the dimension to that of the given vector, and copies all elements.

Member Function Documentation

§ reinit() [1/4]

void Vector< Number >::reinit	(	const size_type	n,
		const bool	omit_zeroing_entries = `false`
	)

Reinit function that resizes the vector to the size specified by n.

Definition at line 564 of file trilinos_vector.cc.

§ reinit() [2/4]

void Vector< Number >::reinit	(	const Epetra_Map &	input_map,
		const bool	omit_zeroing_entries = `false`
	)

Initialization with an Epetra_Map. Similar to the call in the other class MPI::Vector, with the difference that now a copy on all processes is generated. This initialization function is appropriate when the data in the localized vector should be imported from a distributed vector that has been initialized with the same communicator. The variable omit_zeroing_entries determines whether the vector should be filled with zero or left untouched.

Which element of the input_map argument are set is in fact ignored, the only thing that matters is the size of the index space described by this argument.

Definition at line 590 of file trilinos_vector.cc.

§ reinit() [3/4]

void Vector< Number >::reinit	(	const IndexSet &	input_map,
		const MPI_Comm &	communicator = `MPI_COMM_WORLD`,
		const bool	omit_zeroing_entries = `false`
	)

Initialization with an IndexSet. Similar to the call in the other class MPI::Vector, with the difference that now a copy on all processes is generated. This initialization function is appropriate in case the data in the localized vector should be imported from a distributed vector that has been initialized with the same communicator. The variable omit_zeroing_entries determines whether the vector should be filled with zero (false) or left untouched (true).

Which element of the input_map argument are set is in fact ignored, the only thing that matters is the size of the index space described by this argument.

Definition at line 617 of file trilinos_vector.cc.

§ reinit() [4/4]

void Vector< Number >::reinit	(	const VectorBase &	V,
		const bool	omit_zeroing_entries = `false`,
		const bool	allow_different_maps = `false`
	)

Reinit function. Takes the information of a Vector and copies everything to the calling vector, now also allowing different maps.

Definition at line 651 of file trilinos_vector.cc.

§ operator=() [1/4]

Vector& TrilinosWrappers::Vector::operator= ( const TrilinosScalar s )

Set all components of the vector to the given number s. Simply pass this down to the base class, but we still need to declare this function to make the example given in the discussion about making the constructor explicit work.

§ operator=() [2/4]

Vector & Vector< Number >::operator= ( const MPI::Vector & v )

Sets the left hand argument to the (parallel) Trilinos Vector. Equivalent to the reinit function.

Definition at line 719 of file trilinos_vector.cc.

§ operator=() [3/4]

template<typename Number >

Vector& TrilinosWrappers::Vector::operator= ( const ::Vector< Number > & v )

Sets the left hand argument to the deal.II vector.

§ operator=() [4/4]

Vector & Vector< Number >::operator= ( const Vector & v )

Copy operator. Copies both the dimension and the content in the right hand argument.

Definition at line 736 of file trilinos_vector.cc.

§ update_ghost_values()

void TrilinosWrappers::Vector::update_ghost_values ( ) const

This function does nothing but is there for compatibility with the PETScWrappers::Vector class.

For the PETSc vector wrapper class, this function updates the ghost values of the PETSc vector. This is necessary after any modification before reading ghost values.

However, for the implementation of this class, it is immaterial and thus an empty function.

Friends And Related Function Documentation

§ swap()

void swap	(	Vector &	u,
		Vector &	v
	)

Author: Martin Kronbichler, Wolfgang Bangerth, 2008

Definition at line 899 of file trilinos_vector.h.

Member Data Documentation

§ supports_distributed_data

const bool TrilinosWrappers::Vector::supports_distributed_data = false

static

A variable that indicates whether this vector supports distributed data storage. If true, then this vector also needs an appropriate compress() function that allows communicating recent set or add operations to individual elements to be communicated to other processors.

For the current class, the variable equals false, since it does not support parallel data storage. If you do need parallel data storage, use TrilinosWrappers::MPI::Vector.

Definition at line 747 of file trilinos_vector.h.

The documentation for this class was generated from the following files:

deal.II/lac/trilinos_vector.h
/build/deal.ii-pdtiAo/deal.ii-8.4.2/source/lac/trilinos_vector.cc

Public Types

Public Member Functions

Static Public Attributes

Related Functions

Detailed Description

Member Typedef Documentation

§ size_type

Constructor & Destructor Documentation

§ Vector() [1/6]

§ Vector() [2/6]

§ Vector() [3/6]

§ Vector() [4/6]

§ Vector() [5/6]

§ Vector() [6/6]

Member Function Documentation

§ reinit() [1/4]

§ reinit() [2/4]

§ reinit() [3/4]

§ reinit() [4/4]

§ operator=() [1/4]

§ operator=() [2/4]

§ operator=() [3/4]

§ operator=() [4/4]

§ update_ghost_values()

Friends And Related Function Documentation

§ swap()

Member Data Documentation

§ supports_distributed_data