Contents     Functions              PDF Index

feutilb, fe_caseg

• Assemble
• AddNode
• CombineModel
• dTKT
• GeomRB
• GeomRBBeam1
• Match
• MpcFromMatch
• PlaceInDof
• TKT
• Write

Purpose

Gateway functions for advanced FEM utilities in SDT.

Description

This function is only used for internal SDT operation and actual implementation will vary over time. The following commands are documented to allow user calls and SDT source code understanding.

Assemble

 [K,mdl,Case]=fe_case(model,'assemble -matdes 2 1 -cell NoT');

NoT bypasses any assembly of the constrained subspace.

AddNode

This command provides optimized operation when compared to the feutil equivalent and finer control.

CombineModel

mo1=feutilb('combinemodel',mo1,mo2);

Integrated combining of two separate models. This call aims at creating an assembly from two separate mechanical components. This command properly handles potential NodeId, EltId, ProId, or MatId ovelaying by setting disjoint ID sets before assembly. Stack or Case entries with overlaying names are resolved, adding (1) to common names in the second model. Sets with identical names between both models are contatenated into a single set.

mo1 is taken as the reference to which mo2 will be added, the Node/Elt appending is performed by feutilAddTest.

Command option -noSetCat, forces the sets duplication with incremented names (adding (1)), instead of concatenation when sets with identical names are found.

dTKT

K = feutilb('dtkt',T,K) functional equivalent to diag(T'*k*T) but this call supports out of core and other optimized operations obtained through compiled functionalities. K may be a cell array of matrices, in which case one operates on each cell of the array.

GeomRB

Returns a geometric rigid body modes for a call of the form

def=feutilb('geomrb',node,RefXYZ,adof,m)

If a mass matrix consistent with adof is provided the total mass, position of the center of gravity and inertia matrix at CG is computed. You can use def=feutilb('geomrb cg',Up) to force computation of rigid body mass properties.

def=feutilb('geomrbMass',model) returns the rigid body modes and mass, center of gravity and inertia matrix information.

GeomRBBeam1

Returns standard p_beamproperties for a given model section.

il=feutilb('geomrbbeam1',mdl,RefXYZ)

RefXYZ is the coordinates of the reference point.

Match

Non conform mesh matching utilities. The objective is to return matching elements and local coordinates for a list of nodes.

Matching elements mean

• for volumes, that the physical node is within the element. If volumes may be negative, check orientation using feutil orient.
• for surfaces, that that the orthogonal projection of the node is within the element
• for lines that the orthogonal projection on the line is between the line extremities.

A typical node matching call would be

model=femesh('test hexa8');
match=struct('Node',[.1 .1 .1;.5 .5 .5;1 1 1]);
match=feutilb('match -info radius .9 tol 1e-8',model,match)

The search is limited to points that are not too far a way from matchable element centers. Defining a search radius manually can help prevent matching for elements that are too far away or on the contrary allow matching within elements that are very large so that interior points may be far from the center.

The default tolerance tol 1e-8 can be modified if it is found that the non-linear search for the positions within the reference volume are not sufficiently accurate.

The output structure contains the fields

MpcFromMatch

This command is used to build multiple point constraints from a match.
feutilb('MpcFromMatch',model,match).

The solution retained for surfaces is to first project the arbitrarily located connection point P on the element surface onto a point Q on the neutral fiber used where element nodes are located. Then Q1 or P1 shape functions and their derivatives are used to define a linear relation between the 6 degree of freedom of point Q and the 3 or 4 nodes of the facing surface. Motion at P is then deduced using a linearized rigid PQ link. One chooses to ignore rotations at the nodes since their use is very dependent on the shell element formulation.

---

Figure 9.2: Non conform mesh handling

---

The local element coordinates are defined by x_j^e,j=1:3 along the r coordinate line

y^e that is orthogonal to x^e and in the x^e, ∂ N_i/∂ sx_ij plane, and z^e that defines an orthonormal basis.

The local rotations at point Q are estimated from rotations at the corner nodes using

with u_ik the translation at element nodes and j=1:3, i=1:N_node, k=1:3. Displacement at Q is interpolated simply from shape functions, displacement at P is obtained by considering that the segment QP is rigid.

For volumes, displacement is interpolated using shape functions while rotations are obtained by averaging displacement gradients in orthogonal directions

You can check that the constraints generated do not constrain rigid body motion using fe_caseg('rbcheck',model) which builds the transformation associated to linear constraints and returns a list of DOFs where geometric rigid body modes do not coincide with the transformation.

PlaceInDof

def2 = feutilb('PlaceInDof',DOF,def) returns a structure with identical fields but with shapes ordered using the specified DOF. This is used to eliminate DOFs, add zeros for unused DOFs or simply reorder DOFs.

TKT

K = feutilb('tkt',T,K) functional equivalent to T'*k*T but this call supports out of core and other optimized operations obtained through compiled functionalities. K may be a cell array of matrices, in which case one operates on each cell of the array.

Write

feutilb('WriteFileName.m',model) writes a clean output of a model to a script. Without a file name, the script is shown in the command window.

feutilb('_writeil',model) writes properties. feutilb('_writepl',model) writes materials.