





![[BIG]](../icons/zoom18.gif)
![[Normal]](../icons/zoom14.gif)
![[small]](../icons/zoom10.gif)
Next: 2.7 A complete example
Up: 2.6 Implementation of module APNOP3
Prev: 2.6.1 Callinglibraries and files
Index
Contents
POIN : Definition of the characteristic points .
- POIN (A) : the keyword to activate
- IMPRE (I) : print parameter for execution
- NPOINT (I) : number of points to describe
- Loop from J=1 to NPOINT, the number of characteristic points
- NOP (I) : the point number
- NOREF (I) : its reference
- X (R) : the abscissa
- Y (R) : the ordinate
- Z (R) : the height
- end of loop J
Remarks:
- The points may be entered in any order (due to NOP).
- If the points do not lend itself to a manual capturing (due to their number or position), but
are easier to capture via a subroutine, we can use subroutine SPDPTS, which is called by module
APNOP3. This is done by:
INTR : Calls module SDREST to introduce a mesh residing on file into main
memory in order to modify it.
- INTR (A) : the keyword to activate
- IMPRE (I) : print parameter for execution
- NINOPO (I) : the level of the D.S. to introduce into m.m.
- NOM (A) : the name of the file containing the D.S.
Remark:
- To be usable by the geometric modification modules, the meshes introduced in this way must be of type
P1, i.e., the nodes are the vertices.
MA23 : Calls module MA2D3E to create a 3D mesh from the data of a 2D mesh of one of
the sections of the domain. The latter is thus topologically a cylinder defined by a stacking
constructed from the given section.
- MA23 (A) : the keyword to activate
- IMPRE (I) : print parameter for execution
- NINOPE (I) : the level of the I.D.S. serving as data
- NINOPS (I) : the level of the resulting O.D.S.
The data belonging to MA23XX, the preprocessor which corresponds to module MA2D3D,
then follows, to which we will return to later (chapter 3).
SU23 : Calls module TN2D3D to create a surface from the data of a
2D mesh.
- SU23 (A) : the keyword to activate
- IMPRE (I) : print parameter for execution
- NINOPE (I) : the level of the I.D.S. serving as data
- NINOPS (I) : the level of the resulting O.D.S.
- FONINT (I) : option to give the projection function defining the map from the 2D mesh to that
of the surface:
- 0 : the projection function F2D3D is given in the form of a subroutine (see chapter 4,
module TN2D3D);
- 1 : the function is input via a function parser, i.e. the data must be input in the following form
(see chapter 1, keyword COUR):
- 'X01(X,Y) = function of X and Y ;'
the expression must be between ' and terminated with a ;
- 'Y01(X,Y) = function of X and Y ;'
- 'Z01(X,Y) = function of X and Y ;'
- FIN(A) : indicates the end of data for this function
Remark:
- X01, Y01 and Z01 defines the coordinates (x,y and z) of the surface points from those
(X and Y) of the initial mesh points.
MANU : Calls the mesh generator CONOPO which corresponds to a manual description ,
i.e., from points (keyword POIN).
- MANU (A) : the keyword to activate
- IMPRE (I) : print parameter for execution
- LEVEL (I) : the level of the resulting D.S.
- NE (I) : the number of elements to create
- Loop from J=1 to NE, the number of elements
- end of loop J
Remarks:
- NUMSOM(*) is one of the points created with keyword POIN.
- The order of the vertices, edges and faces is the standard order of the D.S. NOPO.
OBJE : Calls the mesh generator CONOPO corresponding to the case of a single element.
- OBJE (A) : the keyword to activate
- IMPRE (I) : print parameter for execution
- LEVEL (I) : the level of the resulting D.S.
- NCGE (I) : the type of element: 1
point, 2
segment,
3
triangle,
4
quadrilateral, 5
tetrahedron,
6
pentahedron, 7
hexahedron;
- IREF (I) : reference option
- 0 : all references are set to 0
- 1 : the references are different:
- for the vertices: 1, 2, 3, 4, ..., n
- for the edges: n+1, ..., n+p
- for the faces: n+p+1, ...,
Remarks:
- The sub-domain number is set to 1.
- The keyword NUME can be used to modify the numbers.
- This module is used when doing simple tests rapidly.
TRAN : Calls module MODNOP to generate a mesh resulting from a translation of a
given mesh.
- TRAN (A) : the keyword to activate
- IMPRE (I) : print parameter for execution
- LEVEL1 (I) : level of the initial D.S.
- LEVEL2 (I) : level of the resulting D.S.
- NBNNF (I) : the number of reference numbers to change
- NBNNSD (I) : the number of sub-domain numbers to change
- Loop from J=1 to NBNNF (if NBNNF
0)
- NOLD(J) (I) : the reference number to change
- NNEW(J) (I) : the number to assign to items referenced by NOLD(J)
- end of loop J
- Loop from J=1 to NBNNSD (if NBNNSD
0)
- NOLD(J) (I) : the sub-domain number to change
- NNEW(J) (I) : the number to assign to items referenced by NOLD(J)
- end of loop J
- TRANX (R) : the x component of the translation
- TRANY (R) : the y component of the translation
- TRANZ (R) : the z component of the translation
ROTA : Calls module MODNOP to generate a mesh resulting from a rotation of
a given mesh.
- ROTA (A) : the keyword to activate
- IMPRE (I) : print parameter for execution
- LEVEL1 (I) : level of the initial D.S.
- LEVEL2 (I) : level of the resulting D.S.
- NBNNF (I) : the number of reference numbers to change
- NBNNSD (I) : the number of sub-domain numbers to change
- Loop from J=1 to NBNNF (if NBNNF
0)
- NOLD(J) (I) : the reference number to change
- NNEW(J) (I) : the number to assign to items referenced by NOLD(J)
- end of loop J
- Loop from J=1 to NBNNSD (if NBNNSD
0)
- NOLD(J) (I) : the sub-domain number to change
- NNEW(J) (I) : the number to assign to items referenced by NOLD(J)
- end of loop J
- VX (R) : the first component of the axis of rotation
- VY (R) : its second component
- VZ (R) : its third component
-
(R) : the rotation angle in degrees
- XC (R) : the abscissa of the center of rotation
- YC (R) : the ordinate
- ZC (R) : the height
SYMP : Calls module MODNOP to generate the mesh resulting from symmetry with
respect to a plane in a given mesh.
- SYMP (A) : the keyword to activate
- IMPRE (I) : print parameter for execution
- LEVEL1 (I) : level of the initial D.S.
- LEVEL2 (I) : level of the resulting D.S.
- NBNNF (I) : the number of reference numbers to change
- NBNNSD (I) : the number of sub-domain numbers to change
- Loop from J=1 to NBNNF (if NBNNF
0)
- NOLD(J) (I) : the reference number to change
- NNEW(J) (I) : the number to assign to items referenced by NOLD(J)
- end of loop J
- Loop from J=1 to NBNNSD (if NBNNSD
0)
- NOLD(J) (I) : the sub-domain number to change
- NNEW(J) (I) : the number to assign to items referenced by NOLD(J)
- end of loop J
- A (R) : the parameters defining the plane of symmetry given in the form
AX + BY + CZ + D = 0.
- B (R) : the second coefficient of the plane equation
- C (R) : the third coefficient
- D (R) : the fourth coefficient
Remark:
DILA : Calls module MODNOP to generate the mesh resulting from a dilation of
given mesh.
- DILA (A) : the keyword to activate
- IMPRE (I) : print parameter for execution
- LEVEL1 (I) : level of the initial D.S.
- LEVEL2 (I) : level of the resulting D.S.
- NBNNF (I) : the number of reference numbers to change
- NBNNSD (I) : the number of sub-domain numbers to change
- Loop from J=1 to NBNNF (if NBNNF
0)
- NOLD(J) (I) : the reference number to change
- NNEW(J) (I) : the number to assign to items referenced by NOLD(J)
- end of loop J
- Loop from J=1 to NBNNSD (if NBNNSD
0)
- NOLD(J) (I) : the sub-domain number to change
- NNEW(J) (I) : the number to assign to items referenced by NOLD(J)
- end of loop J
- DILX (R) : the dilation coefficient in the x direction
- DILY (R) : the dilation coefficient in the y direction
- DILZ (R) : the dilation coefficient in the z direction
- XINV (R) : the abscissa of a point which is invariant by this transformation
- YINV (R) : the ordinate
- ZINV (R) : the height
TETR : Calls module DTRI3D to split each element of the given mesh
into tetrahedra.
- TETR (A) : the keyword to activate
- IMPRE (I) : print parameter for execution
- LEVEL1 (I) : level of the initial D.S.
- LEVEL2 (I) : level of the resulting D.S.
RETR : Calls module RETRIN to split each element of a given mesh
into sub-elements of the same type.
- RETR (A) : the keyword to activate
- IMPRE (I) : print parameter for execution
- LEVEL1 (I) : level of the initial D.S.
- LEVEL2 (I) : level of the resulting D.S.
- N (I) : the splitting parameter
Remark:
- Each element is split into N³ elements of the same type (N in the case of a segment,
N² for triangles and quadrangles, or else N³).
NUME : Calls module MODNOP to modify attributes (reference or sub-domain numbers)
in a given mesh.
- NUME (A) : the keyword to activate
- IMPRE (I) : print parameter for execution
- LEVEL1 (I) : level of the initial D.S.
- LEVEL2 (I) : level of the resulting D.S.
- NBNNF (I) : the number of reference numbers to change
- NBNNSD (I) : the number of sub-domain numbers to change
- Loop from J=1 to NBNNF (if NBNNF
0)
- NOLD(J) (I) : the reference number to change
- NNEW(J) (I) : the number to assign to items referenced by NOLD(J)
- end of loop J
- Loop from J=1 to NBNNSD (if NBNNSD
0)
- NOLD(J) (I) : the sub-domain number to change
- NNEW(J) (I) : the number to assign to items referenced by NOLD(J)
- end of loop J
RECO : Calls module RECOLC to "glue together" two meshes to form a new mesh.
- RECO (A) : the keyword to activate
- IMPRE (I) : print parameter for execution
- LEVEL1 (I) : level of the first initial D.S.
- LEVEL2 (I) : level of the second initial D.S.
- LEVEL3 (I) : level of the resulting D.S.
- EPS (R) : the precision of the union (for example 0.01)
- IOPT (I) : the gluing option: 0 geometrical, 1 physical.
- NBNNF (I) : the number of reference numbers to change
- NBNNSD (I) : the number of sub-domain numbers to change
- Loop from J=1 to NBNNF (if NBNNF
0)
- NOLD(J) (I) : the reference number to change
- NNEW(J) (I) : the number to assign to items referenced by NOLD(J)
- end of loop J
- Loop from J=1 to NBNNSD (if NBNNSD
0)
- NOLD(J) (I) : the sub-domain number to change
- NNEW(J) (I) : the number to assign to items referenced by NOLD(J)
- end of loop J
Remarks:
- A geometrical "gluing together" consists of identifying the points by taking only their
positions into account.
- On the contrary, a physical "gluing together" consists of identifying the points by taking their
position and reference number
into account (two points are said identical if their positions and references are the same).
ADPO : Calls module ADPNOP to define the nodes
of a given mesh (as opposed to a mesh for which the nodes are identical to the vertices).
- ADPO (A) : the keyword to activate
- IMPRE (I) : print parameter for execution
- LEVEL1 (I) : level of the initial D.S.
- LEVEL2 (I) : level of the resulting D.S.
- N1 (I) : the number of nodes on the edges (endpoints excluded)
- ISET (I) : the number of internal nodes in each triangle or triangular face
- ISEQ (I) : the number of internal nodes in each quadrilateral or quadrilateral face
- ISETE (I) : the number of internal nodes in each tetrahedron
- ISEPE (I) : the number of internal nodes in each pentahedron
- ISEHE (I) : the number of internal nodes in each hexahedron
- NOESOM (I) :
1 : vertices are nodes
0 : if not
Remarks:
- It is no longer possible to activate the preceding keywords, consequently this keyword is called
once the entire geometry has been processed.
- Renumbering is desired after this operation.
EXTR : Calls module TRCOAC to construct a D.S. NOPO containing the faces possessing a given
reference number.
- EXTR (A) : the keyword to activate
- IMPRE (I) : print parameter for execution
- LEVEL1 (I) : level of the initial D.S.
- LEVEL2 (I) : level of the resulting D.S.
- NBNNF (I) : the number of face reference numbers to consider
- Loop from J=1 to NBNNF (if NBNNF
0)
- NREF(J) (I) : the face reference numbers to retain
- end of loop J
RENC : Calls module GIBBS to renumber the nodes of a mesh.
- RENC (A) : the keyword to activate
- IMPRE (I) : print parameter for execution
- LEVEL1 (I) : level of the initial D.S.
- LEVEL2 (I) : level of the resulting D.S.
Remark:
- This keyword usually comes just before saving the final mesh on file.
RENE : Calls module GIBBS to renumber the elements and the nodes of a mesh.
- RENE (A) : the keyword to activate
- IMPRE (I) : print parameter for execution
- LEVEL1 (I) : level of the initial D.S.
- LEVEL2 (I) : level of the resulting D.S.
Remark:
- This keyword usually comes just before saving the final mesh on file.
COUL : Calls module COULE1 to renumber the elements by coloring.
- COUL (A) : the keyword to activate
- IMPRE (I) : print parameter for execution
- LEVEL1 (I) : level of the initial D.S.
- LEVEL2 (I) : level of the resulting D.S.
- LVECT (I) : the maximum number of elements per color
- NLC (I) : the number of curved boundaries described
- NOMTAB (A) : the name of the array to be associated with the D.S.
- Loop from J=1 to NLC, the number of curved lines
- NREF(J) (I) the reference number of line J
- end of loop J
Remark:
- This keyword is used to regroup the elements of a mesh into disjoint sets. Consequently, it
enables us to perform a calculation, for example of element matrices, on super-calculators.
SAUV : Calls module SAUVER to store a mesh, residing in main memory, on file.
- SAUV (A) : the keyword to activate
- IMPRE (I) : print parameter for execution
- NINOPO (I) : level of the D.S. to be saved on file
- NTNOPO (I) : the number of arrays to associate to the D.S. (usually 0)
- NOM (A) : the file name
- Loop from J=1 to NTNOPO (if NTNOPO
0)
- NOMTAB (A) : the name of array J (4 characters)
- NTYP (I) : its type
- LONG (I) : the number of words
- Loop from K=1 to the number of variables
- VAL(K) (NTYP) : the variables of the array
- end of loop K
- COMMENT (A) : comment regarding the contents of array J
- end of loop J
Remark:
- This keyword may be activated at any time to save a partial or final mesh.
INTR : Calls module SDREST to introduce a mesh residing on file into main
memory.
- INTR (A) : the keyword to activate
- IMPRE (I) : print parameter for execution
- NINOPO (I) : the level of the D.S. after it is introduced into m.m.
- NOM (A) : the name of the file containing the D.S.
Remark:
- In order to be usable by the geometrical transformation modules, a mesh introduced in this way
must be of type P1, i.e., their nodes and vertices must coincide.
TUER : Calls module TUERSD to remove one or several mesh data structures (D.S.) from memory.
- TUER (A) : the keyword to activate
- IMPRE (I) : print parameter for execution
- NBRE (I) : the number of D.S. to "kill"
- Loop from J=1 to NBRE
- LEVEL(J) (I) : the level of D.S. J to delete from the arrays
- end of loop J
Remark:
- This keyword can be activated to economize on memory space.
IMPR : Call module IMNOPO to print the contents of a mesh data structure (D.S.).
- IMPR (A) : the keyword to activate
- IMPRE (I) : print parameter for execution
- NINOPO (I) : the level of the D.S. to print
DESS : Calls module TRNOPO to plot a mesh.
- DESS (A) : the keyword to activate
- ITERM1 (I) : the terminal number in the nomenclature of your
installation of the software package F3D
- ITERM2 (I) : set 0
- IOPT (I) : the mesh plotting option: 1 the edges, 2 the visible edges, 3 the invisible edges,
4 the shrunken mesh, 5 the same, visible, 6 the same, invisible, 7 all the elements, 8 the same, shrunken.
- LEVEL (I) : the level of the D.S. to plot
Remarks:
- The couple (ITERM1, ITERM2) defines the graphics device.
- The preprocessor TRNOXX is more frequently used to plot meshes.
- Consequently, by deleting this keyword from the APNOP3 facilities, we avoid loading the
graphics libraries at the time the meshes are conceived.
FIN : Request to terminate the job.
- FIN (A) : the keyword to activate
In addition, the following keywords are found in preprocessor APN3XX:
- LIRE
- : request to read another data file (of the same format).
- CONT
- : request to suppress the data coherence controls .
- MENU
- : request to obtain a list of the keywords in the menu .
Remarks
- " ? ", or anything : has the same effect as keyword MENU.
- In case of an error, keyword MENU is selected.






![[BIG]](../icons/zoom18.gif)
![[Normal]](../icons/zoom14.gif)
![[small]](../icons/zoom10.gif)
Next: 2.7 A complete example
Up: 2.6 Implementation of module APNOP3
Prev: 2.6.1 Callinglibraries and files
Index
Contents