Epetra_FEVector Class Reference

Epetra Finite-Element Vector. More...

#include <Epetra_FEVector.h>

Inheritance diagram for Epetra_FEVector:

Public Member Functions
	Epetra_FEVector (const Epetra_BlockMap &Map, int numVectors=1, bool ignoreNonLocalEntries=false)
	Constructor that requires a map specifying a non-overlapping data layout. More...
	Epetra_FEVector (Epetra_DataAccess CV, const Epetra_BlockMap &Map, double *A, int MyLDA, int NumVectors, bool ignoreNonLocalEntries=false)
	Set multi-vector values from two-dimensional array. More...
	Epetra_FEVector (Epetra_DataAccess CV, const Epetra_BlockMap &Map, double **ArrayOfPointers, int NumVectors, bool ignoreNonLocalEntries=false)
	Set multi-vector values from array of pointers. More...
	Epetra_FEVector (const Epetra_FEVector &source)
	Copy constructor. More...
virtual	~Epetra_FEVector ()
	Destructor. More...
int	SumIntoGlobalValues (int numIDs, const int *GIDs, const double *values, int vectorIndex=0)
	Accumulate values into the vector, adding them to any values that already exist for the specified indices. More...
int	SumIntoGlobalValues (int numIDs, const long long *GIDs, const double *values, int vectorIndex=0)
int	SumIntoGlobalValues (const Epetra_IntSerialDenseVector &GIDs, const Epetra_SerialDenseVector &values, int vectorIndex=0)
	Accumulate values into the vector, adding them to any values that already exist for the specified GIDs. More...
int	SumIntoGlobalValues (const Epetra_LongLongSerialDenseVector &GIDs, const Epetra_SerialDenseVector &values, int vectorIndex=0)
int	ReplaceGlobalValues (int numIDs, const int *GIDs, const double *values, int vectorIndex=0)
	Copy values into the vector overwriting any values that already exist for the specified indices. More...
int	ReplaceGlobalValues (int numIDs, const long long *GIDs, const double *values, int vectorIndex=0)
int	ReplaceGlobalValues (const Epetra_IntSerialDenseVector &GIDs, const Epetra_SerialDenseVector &values, int vectorIndex=0)
	Copy values into the vector, replacing any values that already exist for the specified GIDs. More...
int	ReplaceGlobalValues (const Epetra_LongLongSerialDenseVector &GIDs, const Epetra_SerialDenseVector &values, int vectorIndex=0)
int	SumIntoGlobalValues (int numIDs, const int *GIDs, const int *numValuesPerID, const double *values, int vectorIndex=0)
int	SumIntoGlobalValues (int numIDs, const long long *GIDs, const int *numValuesPerID, const double *values, int vectorIndex=0)
int	ReplaceGlobalValues (int numIDs, const int *GIDs, const int *numValuesPerID, const double *values, int vectorIndex=0)
int	ReplaceGlobalValues (int numIDs, const long long *GIDs, const int *numValuesPerID, const double *values, int vectorIndex=0)
int	GlobalAssemble (Epetra_CombineMode mode=Add, bool reuse_map_and_exporter=false)
	Gather any overlapping/shared data into the non-overlapping partitioning defined by the Map that was passed to this vector at construction time. More...
void	setIgnoreNonLocalEntries (bool flag)
	Set whether or not non-local data values should be ignored. More...
Epetra_FEVector &	operator= (const Epetra_FEVector &source)
Public Member Functions inherited from Epetra_MultiVector
int	ReplaceMap (const Epetra_BlockMap &map)
	Replace map, only if new map has same point-structure as current map. More...
int	Reduce ()
	Epetra_MultiVector (const Epetra_BlockMap &Map, int NumVectors, bool zeroOut=true)
	Basic Epetra_MultiVector constuctor. More...
	Epetra_MultiVector (const Epetra_MultiVector &Source)
	Epetra_MultiVector copy constructor. More...
	Epetra_MultiVector (Epetra_DataAccess CV, const Epetra_BlockMap &Map, double *A, int MyLDA, int NumVectors)
	Set multi-vector values from two-dimensional array. More...
	Epetra_MultiVector (Epetra_DataAccess CV, const Epetra_BlockMap &Map, double **ArrayOfPointers, int NumVectors)
	Set multi-vector values from array of pointers. More...
	Epetra_MultiVector (Epetra_DataAccess CV, const Epetra_MultiVector &Source, int *Indices, int NumVectors)
	Set multi-vector values from list of vectors in an existing Epetra_MultiVector. More...
	Epetra_MultiVector (Epetra_DataAccess CV, const Epetra_MultiVector &Source, int StartIndex, int NumVectors)
	Set multi-vector values from range of vectors in an existing Epetra_MultiVector. More...
virtual	~Epetra_MultiVector ()
	Epetra_MultiVector destructor. More...
int	ReplaceGlobalValue (int GlobalRow, int VectorIndex, double ScalarValue)
	Replace current value at the specified (GlobalRow, VectorIndex) location with ScalarValue. More...
int	ReplaceGlobalValue (long long GlobalRow, int VectorIndex, double ScalarValue)
int	ReplaceGlobalValue (int GlobalBlockRow, int BlockRowOffset, int VectorIndex, double ScalarValue)
	Replace current value at the specified (GlobalBlockRow, BlockRowOffset, VectorIndex) location with ScalarValue. More...
int	ReplaceGlobalValue (long long GlobalBlockRow, int BlockRowOffset, int VectorIndex, double ScalarValue)
int	SumIntoGlobalValue (int GlobalRow, int VectorIndex, double ScalarValue)
	Adds ScalarValue to existing value at the specified (GlobalRow, VectorIndex) location. More...
int	SumIntoGlobalValue (long long GlobalRow, int VectorIndex, double ScalarValue)
int	SumIntoGlobalValue (int GlobalBlockRow, int BlockRowOffset, int VectorIndex, double ScalarValue)
	Adds ScalarValue to existing value at the specified (GlobalBlockRow, BlockRowOffset, VectorIndex) location. More...
int	SumIntoGlobalValue (long long GlobalBlockRow, int BlockRowOffset, int VectorIndex, double ScalarValue)
int	ReplaceMyValue (int MyRow, int VectorIndex, double ScalarValue)
	Replace current value at the specified (MyRow, VectorIndex) location with ScalarValue. More...
int	ReplaceMyValue (int MyBlockRow, int BlockRowOffset, int VectorIndex, double ScalarValue)
	Replace current value at the specified (MyBlockRow, BlockRowOffset, VectorIndex) location with ScalarValue. More...
int	SumIntoMyValue (int MyRow, int VectorIndex, double ScalarValue)
	Adds ScalarValue to existing value at the specified (MyRow, VectorIndex) location. More...
int	SumIntoMyValue (int MyBlockRow, int BlockRowOffset, int VectorIndex, double ScalarValue)
	Adds ScalarValue to existing value at the specified (MyBlockRow, BlockRowOffset, VectorIndex) location. More...
int	PutScalar (double ScalarConstant)
	Initialize all values in a multi-vector with constant value. More...
int	Random ()
	Set multi-vector values to random numbers. More...
int	ExtractCopy (double *A, int MyLDA) const
	Put multi-vector values into user-provided two-dimensional array. More...
int	ExtractCopy (double **ArrayOfPointers) const
	Put multi-vector values into user-provided array of pointers. More...
int	ExtractView (double **A, int *MyLDA) const
	Set user-provided addresses of A and MyLDA. More...
int	ExtractView (double ***ArrayOfPointers) const
	Set user-provided addresses of ArrayOfPointers. More...
int	Dot (const Epetra_MultiVector &A, double *Result) const
	Computes dot product of each corresponding pair of vectors. More...
int	Abs (const Epetra_MultiVector &A)
	Puts element-wise absolute values of input Multi-vector in target. More...
int	Reciprocal (const Epetra_MultiVector &A)
	Puts element-wise reciprocal values of input Multi-vector in target. More...
int	Scale (double ScalarValue)
	Scale the current values of a multi-vector, this = ScalarValue*this. More...
int	Scale (double ScalarA, const Epetra_MultiVector &A)
	Replace multi-vector values with scaled values of A, this = ScalarA*A. More...
int	Update (double ScalarA, const Epetra_MultiVector &A, double ScalarThis)
	Update multi-vector values with scaled values of A, this = ScalarThis*this + ScalarA*A. More...
int	Update (double ScalarA, const Epetra_MultiVector &A, double ScalarB, const Epetra_MultiVector &B, double ScalarThis)
	Update multi-vector with scaled values of A and B, this = ScalarThis*this + ScalarA*A + ScalarB*B. More...
int	Norm1 (double *Result) const
	Compute 1-norm of each vector in multi-vector. More...
int	Norm2 (double *Result) const
	Compute 2-norm of each vector in multi-vector. More...
int	NormInf (double *Result) const
	Compute Inf-norm of each vector in multi-vector. More...
int	NormWeighted (const Epetra_MultiVector &Weights, double *Result) const
	Compute Weighted 2-norm (RMS Norm) of each vector in multi-vector. More...
int	MinValue (double *Result) const
	Compute minimum value of each vector in multi-vector. More...
int	MaxValue (double *Result) const
	Compute maximum value of each vector in multi-vector. More...
int	MeanValue (double *Result) const
	Compute mean (average) value of each vector in multi-vector. More...
int	Multiply (char TransA, char TransB, double ScalarAB, const Epetra_MultiVector &A, const Epetra_MultiVector &B, double ScalarThis)
	Matrix-Matrix multiplication, this = ScalarThis*this + ScalarAB*A*B. More...
int	Multiply (double ScalarAB, const Epetra_MultiVector &A, const Epetra_MultiVector &B, double ScalarThis)
	Multiply a Epetra_MultiVector with another, element-by-element. More...
int	ReciprocalMultiply (double ScalarAB, const Epetra_MultiVector &A, const Epetra_MultiVector &B, double ScalarThis)
	Multiply a Epetra_MultiVector by the reciprocal of another, element-by-element. More...
int	SetSeed (unsigned int Seed_in)
	Set seed for Random function. More...
unsigned int	Seed ()
	Get seed from Random function. More...
Epetra_MultiVector &	operator= (const Epetra_MultiVector &Source)
	= Operator. More...
double *&	operator[] (int i)
	Vector access function. More...
double *const &	operator[] (int i) const
	Vector access function. More...
Epetra_Vector *&	operator() (int i)
	Vector access function. More...
const Epetra_Vector *&	operator() (int i) const
	Vector access function. More...
int	NumVectors () const
	Returns the number of vectors in the multi-vector. More...
int	MyLength () const
	Returns the local vector length on the calling processor of vectors in the multi-vector. More...
int	GlobalLength () const
	Returns the global vector length of vectors in the multi-vector. More...
long long	GlobalLength64 () const
	Returns the 64-bit global vector length of vectors in the multi-vector. More...
int	Stride () const
	Returns the stride between vectors in the multi-vector (only meaningful if ConstantStride() is true). More...
bool	ConstantStride () const
	Returns true if this multi-vector has constant stride between vectors. More...
virtual void	Print (std::ostream &os) const
	Print method. More...
int	ResetView (double **ArrayOfPointers)
	Reset the view of an existing multivector to point to new user data. More...
double *	Values () const
	Get pointer to MultiVector values. More...
double **	Pointers () const
	Get pointer to individual vector pointers. More...
Public Member Functions inherited from Epetra_DistObject
	Epetra_DistObject (const Epetra_BlockMap &Map)
	Basic Epetra_DistObject constuctor. More...
	Epetra_DistObject (const Epetra_BlockMap &Map, const char *const Label)
	Epetra_DistObject (const Epetra_DistObject &Source)
	Epetra_DistObject copy constructor. More...
virtual	~Epetra_DistObject ()
	Epetra_DistObject destructor. More...
int	Import (const Epetra_SrcDistObject &A, const Epetra_Import &Importer, Epetra_CombineMode CombineMode, const Epetra_OffsetIndex *Indexor=0)
	Imports an Epetra_DistObject using the Epetra_Import object. More...
int	Import (const Epetra_SrcDistObject &A, const Epetra_Export &Exporter, Epetra_CombineMode CombineMode, const Epetra_OffsetIndex *Indexor=0)
	Imports an Epetra_DistObject using the Epetra_Export object. More...
int	Export (const Epetra_SrcDistObject &A, const Epetra_Import &Importer, Epetra_CombineMode CombineMode, const Epetra_OffsetIndex *Indexor=0)
	Exports an Epetra_DistObject using the Epetra_Import object. More...
int	Export (const Epetra_SrcDistObject &A, const Epetra_Export &Exporter, Epetra_CombineMode CombineMode, const Epetra_OffsetIndex *Indexor=0)
	Exports an Epetra_DistObject using the Epetra_Export object. More...
const Epetra_BlockMap &	Map () const
	Returns the address of the Epetra_BlockMap for this multi-vector. More...
const Epetra_Comm &	Comm () const
	Returns the address of the Epetra_Comm for this multi-vector. More...
bool	DistributedGlobal () const
	Returns true if this multi-vector is distributed global, i.e., not local replicated. More...
Public Member Functions inherited from Epetra_Object
	Epetra_Object (int TracebackModeIn=-1, bool set_label=true)
	Epetra_Object Constructor. More...
	Epetra_Object (const char *const Label, int TracebackModeIn=-1)
	Epetra_Object Constructor. More...
	Epetra_Object (const Epetra_Object &Object)
	Epetra_Object Copy Constructor. More...
virtual	~Epetra_Object ()
	Epetra_Object Destructor. More...
virtual void	SetLabel (const char *const Label)
	Epetra_Object Label definition using char *. More...
virtual const char *	Label () const
	Epetra_Object Label access funtion. More...
virtual int	ReportError (const std::string Message, int ErrorCode) const
	Error reporting method. More...
Public Member Functions inherited from Epetra_SrcDistObject
virtual	~Epetra_SrcDistObject ()
	Epetra_SrcDistObject destructor. More...
Public Member Functions inherited from Epetra_CompObject
Epetra_CompObject &	operator= (const Epetra_CompObject &src)
	Epetra_CompObject ()
	Basic Epetra_CompObject constuctor. More...
	Epetra_CompObject (const Epetra_CompObject &Source)
	Epetra_CompObject copy constructor. More...
virtual	~Epetra_CompObject ()
	Epetra_CompObject destructor. More...
void	SetFlopCounter (const Epetra_Flops &FlopCounter_in)
	Set the internal Epetra_Flops() pointer. More...
void	SetFlopCounter (const Epetra_CompObject &CompObject)
	Set the internal Epetra_Flops() pointer to the flop counter of another Epetra_CompObject. More...
void	UnsetFlopCounter ()
	Set the internal Epetra_Flops() pointer to 0 (no flops counted). More...
Epetra_Flops *	GetFlopCounter () const
	Get the pointer to the Epetra_Flops() object associated with this object, returns 0 if none. More...
void	ResetFlops () const
	Resets the number of floating point operations to zero for this multi-vector. More...
double	Flops () const
	Returns the number of floating point operations with this multi-vector. More...
void	UpdateFlops (int Flops_in) const
	Increment Flop count for this object. More...
void	UpdateFlops (long int Flops_in) const
	Increment Flop count for this object. More...
void	UpdateFlops (long long Flops_in) const
	Increment Flop count for this object. More...
void	UpdateFlops (double Flops_in) const
	Increment Flop count for this object. More...
void	UpdateFlops (float Flops_in) const
	Increment Flop count for this object. More...
Public Member Functions inherited from Epetra_BLAS
	Epetra_BLAS (void)
	Epetra_BLAS Constructor. More...
	Epetra_BLAS (const Epetra_BLAS &BLAS)
	Epetra_BLAS Copy Constructor. More...
virtual	~Epetra_BLAS (void)
	Epetra_BLAS Destructor. More...
float	ASUM (const int N, const float *X, const int INCX=1) const
	Epetra_BLAS one norm function (SASUM). More...
double	ASUM (const int N, const double *X, const int INCX=1) const
	Epetra_BLAS one norm function (DASUM). More...
float	DOT (const int N, const float *X, const float *Y, const int INCX=1, const int INCY=1) const
	Epetra_BLAS dot product function (SDOT). More...
double	DOT (const int N, const double *X, const double *Y, const int INCX=1, const int INCY=1) const
	Epetra_BLAS dot product function (DDOT). More...
float	NRM2 (const int N, const float *X, const int INCX=1) const
	Epetra_BLAS norm function (SNRM2). More...
double	NRM2 (const int N, const double *X, const int INCX=1) const
	Epetra_BLAS norm function (DNRM2). More...
void	SCAL (const int N, const float ALPHA, float *X, const int INCX=1) const
	Epetra_BLAS vector scale function (SSCAL) More...
void	SCAL (const int N, const double ALPHA, double *X, const int INCX=1) const
	Epetra_BLAS vector scale function (DSCAL) More...
void	COPY (const int N, const float *X, float *Y, const int INCX=1, const int INCY=1) const
	Epetra_BLAS vector copy function (SCOPY) More...
void	COPY (const int N, const double *X, double *Y, const int INCX=1, const int INCY=1) const
	Epetra_BLAS vector scale function (DCOPY) More...
int	IAMAX (const int N, const float *X, const int INCX=1) const
	Epetra_BLAS arg maximum of absolute value function (ISAMAX) More...
int	IAMAX (const int N, const double *X, const int INCX=1) const
	Epetra_BLAS arg maximum of absolute value function (IDAMAX) More...
void	AXPY (const int N, const float ALPHA, const float *X, float *Y, const int INCX=1, const int INCY=1) const
	Epetra_BLAS vector update function (SAXPY) More...
void	AXPY (const int N, const double ALPHA, const double *X, double *Y, const int INCX=1, const int INCY=1) const
	Epetra_BLAS vector update function (DAXPY) More...
void	GEMV (const char TRANS, const int M, const int N, const float ALPHA, const float *A, const int LDA, const float *X, const float BETA, float *Y, const int INCX=1, const int INCY=1) const
	Epetra_BLAS matrix-vector multiply function (SGEMV) More...
void	GEMV (const char TRANS, const int M, const int N, const double ALPHA, const double *A, const int LDA, const double *X, const double BETA, double *Y, const int INCX=1, const int INCY=1) const
	Epetra_BLAS matrix-vector multiply function (DGEMV) More...
void	GEMM (const char TRANSA, const char TRANSB, const int M, const int N, const int K, const float ALPHA, const float *A, const int LDA, const float *B, const int LDB, const float BETA, float *C, const int LDC) const
	Epetra_BLAS matrix-matrix multiply function (SGEMM) More...
void	GEMM (const char TRANSA, const char TRANSB, const int M, const int N, const int K, const double ALPHA, const double *A, const int LDA, const double *B, const int LDB, const double BETA, double *C, const int LDC) const
	Epetra_BLAS matrix-matrix multiply function (DGEMM) More...
void	SYMM (const char SIDE, const char UPLO, const int M, const int N, const float ALPHA, const float *A, const int LDA, const float *B, const int LDB, const float BETA, float *C, const int LDC) const
	Epetra_BLAS symmetric matrix-matrix multiply function (SSYMM) More...
void	SYMM (const char SIDE, const char UPLO, const int M, const int N, const double ALPHA, const double *A, const int LDA, const double *B, const int LDB, const double BETA, double *C, const int LDC) const
	Epetra_BLAS matrix-matrix multiply function (DSYMM) More...
void	TRMM (const char SIDE, const char UPLO, const char TRANSA, const char DIAG, const int M, const int N, const float ALPHA, const float *A, const int LDA, float *B, const int LDB) const
	Epetra_BLAS triangular matrix-matrix multiply function (STRMM) More...
void	TRMM (const char SIDE, const char UPLO, const char TRANSA, const char DIAG, const int M, const int N, const double ALPHA, const double *A, const int LDA, double *B, const int LDB) const
	Epetra_BLAS triangular matrix-matrix multiply function (DTRMM) More...
void	SYRK (const char UPLO, const char TRANS, const int N, const int K, const float ALPHA, const float *A, const int LDA, const float BETA, float *C, const int LDC) const
	Eperta_BLAS symetric rank k funtion (ssyrk) More...
void	SYRK (const char UPLO, const char TRANS, const int N, const int K, const double ALPHA, const double *A, const int LDA, const double BETA, double *C, const int LDC) const
	Eperta_BLAS symetric rank k funtion (dsyrk) More...

Protected Member Functions
template<typename int_type >
int	inputValues (int numIDs, const int_type *GIDs, const double *values, bool suminto, int vectorIndex)
template<typename int_type >
int	inputValues (int numIDs, const int_type *GIDs, const int *numValuesPerID, const double *values, bool suminto, int vectorIndex)
template<typename int_type >
int	inputNonlocalValue (int_type GID, double value, bool suminto, int vectorIndex)
template<typename int_type >
int	inputNonlocalValues (int_type GID, int numValues, const double *values, bool suminto, int vectorIndex)
template<typename int_type >
void	createNonlocalMapAndExporter ()
	Allocate the Map, Export object, and MultiVector for nonlocal data. More...
void	destroyNonlocalMapAndExporter ()
	Deallocate the Map, Export object, and MultiVector for nonlocal data. More...
template<typename int_type >
void	zeroNonlocalData ()
	Make all the nonlocal multivector entries zero. More...
void	destroyNonlocalData ()
	Deallocate storage for nonlocal data. More...
template<typename int_type >
std::vector< int_type > &	nonlocalIDs ()
template<>
std::vector< int > &	nonlocalIDs ()
template<>
std::vector< long long > &	nonlocalIDs ()
Protected Member Functions inherited from Epetra_MultiVector
void	Assign (const Epetra_MultiVector &rhs)
int	CheckInput ()
Protected Member Functions inherited from Epetra_DistObject
virtual int	DoTransfer (const Epetra_SrcDistObject &A, Epetra_CombineMode CombineMode, int NumSameIDs, int NumPermuteIDs, int NumRemoteIDs, int NumExportIDs, int *PermuteToLIDs, int *PermuteFromLIDs, int *RemoteLIDs, int *ExportLIDs, int &LenExports, char *&Exports, int &LenImports, char *&Imports, Epetra_Distributor &Distor, bool DoReverse, const Epetra_OffsetIndex *Indexor)
	Perform actual transfer (redistribution) of data across memory images, using Epetra_Distributor object. More...
Protected Member Functions inherited from Epetra_Object
std::string	toString (const int &x) const
std::string	toString (const long long &x) const
std::string	toString (const double &x) const

Protected Attributes
long long	myFirstID_
int	myNumIDs_
std::vector< int >	nonlocalIDs_int_
std::vector< long long >	nonlocalIDs_LL_
std::vector< int >	nonlocalElementSize_
std::vector< std::vector < double > >	nonlocalCoefs_
	Array of arrays (one per column) of nonlocal coefficients. More...
Epetra_BlockMap *	nonlocalMap_
	Map describing distribution of nonlocal data. More...
Epetra_Export *	exporter_
	Export object that sums nonlocal data into a nonoverlapping distribution. More...
Epetra_MultiVector *	nonlocalVector_
	Multivector that holds nonlocal data; source for the Export operation. More...
bool	ignoreNonLocalEntries_
Protected Attributes inherited from Epetra_MultiVector
double *	Values_
Protected Attributes inherited from Epetra_DistObject
Epetra_BlockMap	Map_
const Epetra_Comm *	Comm_
char *	Exports_
char *	Imports_
int	LenExports_
int	LenImports_
int *	Sizes_
Protected Attributes inherited from Epetra_CompObject
Epetra_Flops *	FlopCounter_

Private Member Functions
template<typename int_type >
int	GlobalAssemble (Epetra_CombineMode mode, bool reuse_map_and_exporter)

Additional Inherited Members
Static Public Member Functions inherited from Epetra_Object
static void	SetTracebackMode (int TracebackModeValue)
	Set the value of the Epetra_Object error traceback report mode. More...
static int	GetTracebackMode ()
	Get the value of the Epetra_Object error report mode. More...
static std::ostream &	GetTracebackStream ()
	Get the output stream for error reporting. More...
Static Public Attributes inherited from Epetra_Object
static int	TracebackMode

Detailed Description

Epetra Finite-Element Vector.

This class inherits Epetra_MultiVector and thus provides all Epetra_MultiVector functionality.

The added functionality provided by Epetra_FEVector is the ability to perform finite-element style vector assembly. It accepts sub-vector contributions, such as those that would come from element-load vectors, etc. These sub-vectors need not be owned by the local processor. In other words, the user can assemble overlapping data (e.g., corresponding to shared finite-element nodes). When the user is finished assembling their vector data, they then call the method Epetra_FEVector::GlobalAssemble() which gathers the overlapping data (all non-local data that was input on each processor) into the data-distribution specified by the map with which the Epetra_FEVector was constructed.

Definition at line 78 of file Epetra_FEVector.h.

Constructor & Destructor Documentation

Epetra_FEVector::Epetra_FEVector	(	const Epetra_BlockMap &	Map,
		int	numVectors = 1,
		bool	ignoreNonLocalEntries = false
	)

Constructor that requires a map specifying a non-overlapping data layout.

Parameters

Map	Map describing a non-overlapping distribution for the underlying Epetra_MultiVector into which this Epetra_FEVector will funnel data.
numVectors	Optional argument, default value is 1. (See the documentation for Epetra_MultiVector for the meaning of this argument.
ignoreNonLocalEntries	Optional argument, default value is false. Under certain special circumstances it is desirable to have non-local contributions ignored rather than saving them for the GlobalAssemble step.

Definition at line 58 of file Epetra_FEVector.cpp.

Epetra_FEVector::Epetra_FEVector	(	Epetra_DataAccess	CV,
		const Epetra_BlockMap &	Map,
		double *	A,
		int	MyLDA,
		int	NumVectors,
		bool	ignoreNonLocalEntries = false
	)

Set multi-vector values from two-dimensional array.

Parameters

In	Epetra_DataAccess - Enumerated type set to Copy or View.
In	Map - A Epetra_LocalMap, Epetra_Map or Epetra_BlockMap.
In	A - Pointer to an array of double precision numbers. The first vector starts at A. The second vector starts at A+MyLDA, the third at A+2*MyLDA, and so on.
In	MyLDA - The "Leading Dimension", or stride between vectors in memory.

Warning

This value refers to the stride on the calling processor. Thus it is a local quantity, not a global quantity.

Parameters

In	NumVectors - Number of vectors in multi-vector.

Returns

Integer error code, set to 0 if successful.

See Detailed Description section for further discussion.

Definition at line 83 of file Epetra_FEVector.cpp.

Epetra_FEVector::Epetra_FEVector	(	Epetra_DataAccess	CV,
		const Epetra_BlockMap &	Map,
		double **	ArrayOfPointers,
		int	NumVectors,
		bool	ignoreNonLocalEntries = false
	)

Set multi-vector values from array of pointers.

Parameters

In	Epetra_DataAccess - Enumerated type set to Copy or View.
In	Map - A Epetra_LocalMap, Epetra_Map or Epetra_BlockMap.
In	ArrayOfPointers - An array of pointers such that ArrayOfPointers[i] points to the memory location containing ith vector to be copied.
In	NumVectors - Number of vectors in multi-vector.

Returns

Integer error code, set to 0 if successful.

See Detailed Description section for further discussion.

Definition at line 108 of file Epetra_FEVector.cpp.

Epetra_FEVector::Epetra_FEVector

(

const Epetra_FEVector &

source

)

Copy constructor.

Definition at line 133 of file Epetra_FEVector.cpp.

Epetra_FEVector::~Epetra_FEVector ( )

virtual

Destructor.

Definition at line 154 of file Epetra_FEVector.cpp.

Member Function Documentation

int Epetra_FEVector::SumIntoGlobalValues	(	int	numIDs,
		const int *	GIDs,
		const double *	values,
		int	vectorIndex = 0
	)

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

Definition at line 164 of file Epetra_FEVector.cpp.

int Epetra_FEVector::SumIntoGlobalValues	(	int	numIDs,
		const long long *	GIDs,
		const double *	values,
		int	vectorIndex = 0
	)

Definition at line 172 of file Epetra_FEVector.cpp.

int Epetra_FEVector::SumIntoGlobalValues	(	const Epetra_IntSerialDenseVector &	GIDs,
		const Epetra_SerialDenseVector &	values,
		int	vectorIndex = 0
	)

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 181 of file Epetra_FEVector.cpp.

int Epetra_FEVector::SumIntoGlobalValues	(	const Epetra_LongLongSerialDenseVector &	GIDs,
		const Epetra_SerialDenseVector &	values,
		int	vectorIndex = 0
	)

Definition at line 194 of file Epetra_FEVector.cpp.

int Epetra_FEVector::ReplaceGlobalValues	(	int	numIDs,
		const int *	GIDs,
		const double *	values,
		int	vectorIndex = 0
	)

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

Definition at line 229 of file Epetra_FEVector.cpp.

int Epetra_FEVector::ReplaceGlobalValues	(	int	numIDs,
		const long long *	GIDs,
		const double *	values,
		int	vectorIndex = 0
	)

Definition at line 238 of file Epetra_FEVector.cpp.

int Epetra_FEVector::ReplaceGlobalValues	(	const Epetra_IntSerialDenseVector &	GIDs,
		const Epetra_SerialDenseVector &	values,
		int	vectorIndex = 0
	)

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 248 of file Epetra_FEVector.cpp.

int Epetra_FEVector::ReplaceGlobalValues	(	const Epetra_LongLongSerialDenseVector &	GIDs,
		const Epetra_SerialDenseVector &	values,
		int	vectorIndex = 0
	)

Definition at line 261 of file Epetra_FEVector.cpp.

int Epetra_FEVector::SumIntoGlobalValues	(	int	numIDs,
		const int *	GIDs,
		const int *	numValuesPerID,
		const double *	values,
		int	vectorIndex = 0
	)

Definition at line 208 of file Epetra_FEVector.cpp.

int Epetra_FEVector::SumIntoGlobalValues	(	int	numIDs,
		const long long *	GIDs,
		const int *	numValuesPerID,
		const double *	values,
		int	vectorIndex = 0
	)

Definition at line 218 of file Epetra_FEVector.cpp.

int Epetra_FEVector::ReplaceGlobalValues	(	int	numIDs,
		const int *	GIDs,
		const int *	numValuesPerID,
		const double *	values,
		int	vectorIndex = 0
	)

Definition at line 307 of file Epetra_FEVector.cpp.

int Epetra_FEVector::ReplaceGlobalValues	(	int	numIDs,
		const long long *	GIDs,
		const int *	numValuesPerID,
		const double *	values,
		int	vectorIndex = 0
	)

Definition at line 317 of file Epetra_FEVector.cpp.

int Epetra_FEVector::GlobalAssemble	(	Epetra_CombineMode	mode = Add,
		bool	reuse_map_and_exporter = false
	)

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.

Optimization for power-users: The optional parameter 'reuse_map_and_exporter' defaults to false. By default, a map that describes the non-local data is re-created at each call to GlobalAssemble, along with an exporter used to do the communication. This is expensive. If you know that the layout of your nonlocal data has not changed since your previous call to GlobalAssemble, you can set this flag to true and it will reuse the previously created map and exporter rather than creating new ones.

Definition at line 448 of file Epetra_FEVector.cpp.

void Epetra_FEVector::setIgnoreNonLocalEntries ( bool  flag )

inline

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

Definition at line 260 of file Epetra_FEVector.h.

Epetra_FEVector & Epetra_FEVector::operator=

(

const Epetra_FEVector &

source

)

Definition at line 535 of file Epetra_FEVector.cpp.

template<typename int_type >

int Epetra_FEVector::inputValues ( int  numIDs, const int_type *  GIDs, const double *  values, bool  suminto, int  vectorIndex  )

protected

Definition at line 275 of file Epetra_FEVector.cpp.

template<typename int_type >

int Epetra_FEVector::inputValues ( int  numIDs, const int_type *  GIDs, const int *  numValuesPerID, const double *  values, bool  suminto, int  vectorIndex  )

protected

Definition at line 328 of file Epetra_FEVector.cpp.

template<typename int_type >

int Epetra_FEVector::inputNonlocalValue ( int_type  GID, double  value, bool  suminto, int  vectorIndex  )

protected

Definition at line 368 of file Epetra_FEVector.cpp.

template<typename int_type >

int Epetra_FEVector::inputNonlocalValues ( int_type  GID, int  numValues, const double *  values, bool  suminto, int  vectorIndex  )

protected

Definition at line 376 of file Epetra_FEVector.cpp.

template<typename int_type >

void Epetra_FEVector::createNonlocalMapAndExporter ( )

protected

Allocate the Map, Export object, and MultiVector for nonlocal data.

Definition at line 511 of file Epetra_FEVector.cpp.

void Epetra_FEVector::destroyNonlocalMapAndExporter ( )

protected

Deallocate the Map, Export object, and MultiVector for nonlocal data.

Definition at line 527 of file Epetra_FEVector.cpp.

template<typename int_type >

void Epetra_FEVector::zeroNonlocalData ( )

protected

Make all the nonlocal multivector entries zero.

Definition at line 561 of file Epetra_FEVector.cpp.

void Epetra_FEVector::destroyNonlocalData ( )

protected

Deallocate storage for nonlocal data.

This does not include whatever destroyNonlocalMapAndExporter() deallocates.

Definition at line 577 of file Epetra_FEVector.cpp.

template<typename int_type >

std::vector<int_type>& Epetra_FEVector::nonlocalIDs ( )

protected

template<typename int_type >

int Epetra_FEVector::GlobalAssemble ( Epetra_CombineMode  mode, bool  reuse_map_and_exporter  )

private

template<>

std::vector<int>& Epetra_FEVector::nonlocalIDs ( )

inlineprotected

Definition at line 349 of file Epetra_FEVector.h.

template<>

std::vector<long long>& Epetra_FEVector::nonlocalIDs ( )

inlineprotected

Definition at line 356 of file Epetra_FEVector.h.

Member Data Documentation

long long Epetra_FEVector::myFirstID_

protected

Definition at line 305 of file Epetra_FEVector.h.

int Epetra_FEVector::myNumIDs_

protected

Definition at line 306 of file Epetra_FEVector.h.

std::vector<int> Epetra_FEVector::nonlocalIDs_int_

protected

Definition at line 309 of file Epetra_FEVector.h.

std::vector<long long> Epetra_FEVector::nonlocalIDs_LL_

protected

Definition at line 312 of file Epetra_FEVector.h.

std::vector<int> Epetra_FEVector::nonlocalElementSize_

protected

Definition at line 317 of file Epetra_FEVector.h.

std::vector<std::vector<double> > Epetra_FEVector::nonlocalCoefs_

protected

Array of arrays (one per column) of nonlocal coefficients.

Entry j in this array is an array of nonlocal coefficients for column j of the multivector. nonlocalCoefs_[j] in turn contains the data for all the nonlocal block entries. Entries within a block are stored in column-major order (Fortran style), in contiguous chunks of Map().MaxElementSize() entries.

In summary: for k = 0 to numNonlocalIDs_ - 1, nonlocalCoefs_[j][j*M + i] contains the entries of nonlocal block entry k, for i = 0 to nonlocalElementSize_[k] - 1.

Definition at line 330 of file Epetra_FEVector.h.

Epetra_BlockMap* Epetra_FEVector::nonlocalMap_

protected

Map describing distribution of nonlocal data.

Definition at line 333 of file Epetra_FEVector.h.

Epetra_Export* Epetra_FEVector::exporter_

protected

Export object that sums nonlocal data into a nonoverlapping distribution.

Definition at line 336 of file Epetra_FEVector.h.

Epetra_MultiVector* Epetra_FEVector::nonlocalVector_

protected

Multivector that holds nonlocal data; source for the Export operation.

Definition at line 339 of file Epetra_FEVector.h.

bool Epetra_FEVector::ignoreNonLocalEntries_

protected

Definition at line 341 of file Epetra_FEVector.h.

---

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

• Epetra_FEVector.h
• Epetra_FEVector.cpp