/usr/include/trilinos/fei_ProcEqns.hpp is in libtrilinos-dev 10.4.0.dfsg-1ubuntu2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 | #ifndef _ProcEqns_hpp_
#define _ProcEqns_hpp_
/*--------------------------------------------------------------------*/
/* Copyright 2005 Sandia Corporation. */
/* Under the terms of Contract DE-AC04-94AL85000, there is a */
/* non-exclusive license for use of this work by or on behalf */
/* of the U.S. Government. Export of this program may require */
/* a license from the United States Government. */
/*--------------------------------------------------------------------*/
/** Internal implementation class.
A class for keeping equation numbers grouped according to processor. This
is useful when a set of equations is to be exchanged among processors. This
class holds a table of equation numbers, and optionally a companion table with
the lengths of those equations, organized such that each row of the table
contains equations that are associated with a remote processor. (They are to be
sent to that proc, or they are to be received from that proc.) A list of those
processors is also maintained, of course.
Usage of this class is intended to consist of adding equations and associated
processors using the addEqn member, and then later retrieving the list of
processors and the associated table (list of lists) of equations, and their
lengths (if length data was supplied).
*/
class ProcEqns {
public:
/** Default constructor */
ProcEqns();
/** Destructor */
virtual ~ProcEqns();
/** Similar to a copy constructor, puts a copy of all data and state into
the new instance.
*/
ProcEqns* deepCopy();
/** Return the number of processors for which equations are held. */
size_t getNumProcs() {return(procs_.size());}
/** Return a list of processors. */
std::vector<int>& procsPtr() {return(procs_);}
/** Return a list containing the number of equations corresponding to each
processor. The length of this list should be 'getNumProcs()'.
*/
std::vector<int>& eqnsPerProcPtr() {return(eqnsPerProc_);}
/** Table of equation numbers. number-of-rows = 'getNumProcs()', length of
row i is eqnsPerProcPtr()[i].
*/
std::vector<std::vector<int>*>& procEqnNumbersPtr() {return(procEqnNumbers_);}
/** Table containing the lengths of the equations in 'procEqnNumbersPtr()'.
Returns NULL if no length data is present.
*/
std::vector<std::vector<int>*>& procEqnLengthsPtr() {return(procEqnLengths_);}
/** Add an equation-number and associated processor number to the internal
data structures. Equations may be added for multiple different procs.
*/
void addEqn(int eqnNumber, int proc);
/** Add an equation-number/equation-length pair, and associated processor
number, to the internal data structures. Equations may be added for
multiple different procs.
*/
void addEqn(int eqnNumber, int eqnLength, int proc);
/** Replace the 'procEqnLengthsPtr()' table with these lengths. There is a
large potential for user error here. The number of equation/length pairs
being provided here should equal the total number of equations already
identified to this object. The internal table of lengths will be
destroyed if it already exists, and replaced by this incoming data.
@param eqnNumbers Equations for which lengths are being provided. These
equations must already have been identified and associated with procs.
@param eqnLengths Equation lengths.
@param len The number of equations and lengths.
*/
void setProcEqnLengths(int* eqnNumbers, int* eqnLengths, int len);
private:
void deleteMemory();
void internalAddEqn(int eqnNumber, int eqnLength, int proc);
std::vector<int> procs_;
std::vector<int> eqnsPerProc_;
std::vector<std::vector<int>* > procEqnNumbers_;
std::vector<std::vector<int>* > procEqnLengths_;
};
#endif
|