/[escript]/trunk/finley/src/Mesh.h
ViewVC logotype

Contents of /trunk/finley/src/Mesh.h

Parent Directory Parent Directory | Revision Log Revision Log


Revision 751 - (show annotations)
Mon Jun 26 01:46:34 2006 UTC (13 years, 2 months ago) by bcumming
File MIME type: text/plain
File size: 6485 byte(s)
Changes relating to the MPI version of escript
The standard OpenMP version of escript is unchanged

- updated data types (Finley_Mesh, Finley_NodeFile, etc) to store meshes
  over multiple MPI processes.
- added CommBuffer code in Paso for communication of Data associated
  with distributed meshes
- updates in Finley and Escript to support distributed data and operations
  on distributed data (such as interpolation).
- construction of RHS in MPI, so that simple explicit schemes (such as
  /docs/examples/wave.py without IO and the Locator) can run in MPI.
- updated mesh generation for first order line, rectangle and brick
  meshes and second order line meshes in MPI.        
- small changes to trunk/SConstruct and trunk/scons/ess_options.py to
  build the MPI version, these changes are turned off by default.

1 /*
2 ************************************************************
3 * Copyright 2006 by ACcESS MNRF *
4 * *
5 * http://www.access.edu.au *
6 * Primary Business: Queensland, Australia *
7 * Licensed under the Open Software License version 3.0 *
8 * http://www.opensource.org/licenses/osl-3.0.php *
9 * *
10 ************************************************************
11 */
12 /* Version: $Id$ */
13
14
15 #ifndef INC_FINLEY_MESH
16 #define INC_FINLEY_MESH
17
18 /**************************************************************/
19
20 /* Finley: Mesh */
21
22 /* A mesh is built from nodes and elements which are describing the
23 domain, the surface and point sources. (the latter are needed to
24 establish links with other codes, in particular to particle
25 codes). The nodes are stored a Finley_NodeFile and elements in a
26 Finley_ElementFile. A Finley_NodeFile and three Finley_ElementFile
27 containing the elements describing the domain, surface and point
28 sources respectively. Notice that the surface elements do not
29 necessaryly cover the entire surface of the domain. */
30
31 /* The element type is fixed by the reference element, see
32 ReferenceElement.h. The numbering of the nodes starts with 0. */
33
34 /* Important: it is assumed that every node is appearing in at least
35 one element or surface element and that any node used in an
36 element, surface element or as a point is specified in the
37 Finley_Node, see also Finley_resolveNodeIds. */
38
39 /* In some cases it is useful to refer to a mesh entirly built from
40 order 1 (=linear) elements. The linear version of the mesh can be
41 accessed by referning to the first few nodes of each element
42 (thanks to the way the nodes are ordered). As the numbering of
43 these nodes is not continuous a relabeling vectors are introduced
44 in the Finley_NodeFile. This feature is not fully implemented
45 yet. */
46
47 /* allnodes and elements are tagged. the tag allows to group nodes and
48 elements. A typical application is to mark surface elements on a
49 certain portion of the domain with the same tag. All these surface
50 elements can then assigned the same value eg. for the pressure. */
51
52 /* Thespacial dimension is determined by the type of elements
53 used. The spacial dimension should be accessed by the function
54 Finley_Mesh_getDim. Notice that the element type also determines
55 the type of surface elements to be used. */
56
57 /**************************************************************/
58
59 #include "Finley.h"
60 #include "NodeFile.h"
61 #include "ElementFile.h"
62 #include "paso/SystemMatrixPattern.h"
63 #include "escript/DataC.h"
64
65 #ifdef PASO_MPI
66 #include "paso/Paso_MPI.h"
67 #endif
68
69 /**************************************************************/
70
71 /* this struct holds a mesh: */
72
73 struct Finley_Mesh {
74 char* Name; /* the name of the mesh */
75 index_t order; /* integration order */
76 dim_t reference_counter; /* counts the number of references to the mesh; */
77 Finley_NodeFile* Nodes; /* the table of the nodes */
78 Finley_ElementFile* Elements; /* the table of the elements */
79 Finley_ElementFile* FaceElements; /* the table of the face elements */
80 Finley_ElementFile* ContactElements; /* the table of the contact elements */
81 Finley_ElementFile* Points; /* the table of points (treated as elements of dimension 0) */
82
83 /* pointer to the sparse matrix pattern */
84
85 Paso_SystemMatrixPattern *FullFullPattern;
86 Paso_SystemMatrixPattern *FullReducedPattern;
87 Paso_SystemMatrixPattern *ReducedFullPattern;
88 Paso_SystemMatrixPattern *ReducedReducedPattern;
89 #ifdef PASO_MPI
90 Paso_MPIInfo *MPIInfo;
91 #endif
92 };
93
94 typedef struct Finley_Mesh Finley_Mesh;
95
96 /* these structures are used for matching surfaces elements: */
97
98 struct Finley_Mesh_findMatchingFaces_center{
99 index_t refId;
100 double x[MAX_numDim];
101 };
102 typedef struct Finley_Mesh_findMatchingFaces_center Finley_Mesh_findMatchingFaces_center;
103
104 /**************************************************************/
105
106 /* interfaces: */
107 #ifndef PASO_MPI
108 Finley_Mesh* Finley_Mesh_alloc(char* name,dim_t numDim, index_t order);
109 #else
110 Finley_Mesh* Finley_Mesh_alloc(char* name,dim_t numDim, index_t order, Paso_MPIInfo *mpi_info);
111 void Finley_Mesh_markOrderedNodesLocation(index_t* mask,index_t offset,Finley_Mesh* in,bool_t useLinear);
112 void Finley_Mesh_markOrderedDegreesOfFreedomLocation(index_t* mask,index_t offset,Finley_Mesh* in,bool_t useLinear);
113 #endif
114 /*Finley_Mesh* Finley_Mesh_alloc(char*,int,int);*/
115 Finley_Mesh* Finley_Mesh_reference(Finley_Mesh*);
116 void Finley_Mesh_dealloc(Finley_Mesh*);
117 dim_t Finley_Mesh_getDim(Finley_Mesh*);
118 dim_t Finley_Mesh_getNumNodes(Finley_Mesh*);
119 dim_t Finley_Mesh_getNumDegreesOfFreedom(Finley_Mesh*);
120 dim_t Finley_Mesh_getReducedNumDegreesOfFreedom(Finley_Mesh*);
121 Paso_SystemMatrixPattern* Finley_getPattern(Finley_Mesh *mesh,bool_t reduce_row_order, bool_t reduce_col_order);
122 Paso_SystemMatrixPattern* Finley_makePattern(Finley_Mesh *mesh,bool_t reduce_row_order, bool_t reduce_col_order);
123 void Finley_Mesh_write(Finley_Mesh*,char*);
124 Finley_Mesh* Finley_Mesh_read(char*,index_t);
125 void Finley_Mesh_setCoordinates(Finley_Mesh*,escriptDataC*);
126
127 void Finley_Mesh_prepare(Finley_Mesh* in);
128 void Finley_Mesh_prepareNodes(Finley_Mesh* in);
129 void Finley_Mesh_improveColoring(Finley_Mesh* in);
130 void Finley_Mesh_optimizeElementDistribution(Finley_Mesh* in);
131 void Finley_Mesh_resolveNodeIds(Finley_Mesh*);
132 Finley_Mesh* Finley_Mesh_merge(dim_t, Finley_Mesh**);
133
134 void Finley_Mesh_relableElementNodes(int*,int,Finley_Mesh*);
135 void Finley_Mesh_markNodes(int*,int,Finley_Mesh*,int);
136
137 void Finley_Mesh_glueFaces(Finley_Mesh* self,double safety_factor,double tolerance);
138 void Finley_Mesh_joinFaces(Finley_Mesh* self,double safety_factor,double tolerance);
139
140 int Finley_Mesh_findMatchingFaces_compar(const void*,const void*);
141 void Finley_Mesh_findMatchingFaces(Finley_NodeFile*,Finley_ElementFile *,double,double, int*, int*,int*,int*);
142 void Finley_Mesh_print(Finley_Mesh *in);
143 void Finley_Mesh_saveDX(const char * filename_p, Finley_Mesh *mesh_p, const dim_t num_data,char* *names_p,escriptDataC* *data_pp);
144 void Finley_Mesh_saveVTK(const char * filename_p, Finley_Mesh *mesh_p, const dim_t num_data,char* *names_p,escriptDataC* *data_pp);
145
146
147 #endif /* #ifndef INC_FINLEY_MESH */
148

Properties

Name Value
svn:eol-style native
svn:keywords Author Date Id Revision

  ViewVC Help
Powered by ViewVC 1.1.26