FemFactory (Artisynth API documentation)

java.lang.Object
- artisynth.core.femmodels.FemFactory

public class FemFactory
extends java.lang.Object

Nested Class Summary

Nested Classes
Modifier and Type Class and Description

static class FemFactory.FemElementType

static class FemFactory.FemShapingType

Nested Classes
Modifier and Type	Class and Description
`static class`	`FemFactory.FemElementType`
`static class`	`FemFactory.FemShapingType`

Constructor Summary

Constructors
Constructor and Description

FemFactory()

Constructors
Constructor and Description
`FemFactory()`

Method Summary

All Methods Static Methods Concrete Methods
Modifier and Type	Method and Description
`static void`	`addFem(FemModel3d fem0, FemModel3d fem1)` Adds a copy of the nodes, elements, markers and attachments from `fem1` to `fem0`.
`static void`	`addFem(FemModel3d fem0, FemModel3d fem1, double nodeMergeDist)` Adds a copy of the nodes, elements, markers and attachments from `fem1` to `fem0`.
`static FemModel3d`	`createCylinder(FemModel3d model, double l, double r, int nt, int nl, int nr)` Creates a cylinder made of mostly hex elements, with wedges in the centre column.
`static FemModel3d`	`createEllipsoid(FemModel3d model, double rl, double rs1, double rs2, int nt, int nl, int ns)` Creates an ellipsoidal model using a combination of hex, wedge, and tet elements.
`static FemModel3d`	`createExtrusion(FemModel3d model, FemFactory.FemElementType type, int n, double d, double zOffset, PolygonalMesh surface)` Creates a shell-based FEM model by extruding a surface mesh along the normal direction of its faces.
`static FemModel3d`	`createExtrusion(FemModel3d model, int n, double d, double zOffset, PolygonalMesh surface)` Creates a shell-based FEM model by extruding a surface mesh along the normal direction of its faces.
`static void`	`createFromElementList(FemModel3d out, java.util.Collection<FemElement3d> elemList)` Creates a new model by duplicating nodes and elements
`static FemModel3d`	`createFromMesh(FemModel3d model, PolygonalMesh surface, double quality)` Creates a tetrahedral FEM model from a triangular surface mesh.
`static FemModel3d`	`createFromMeshAndPoints(FemModel3d model, PolygonalMesh surface, double quality, Point3d[] pnts)` Constrained Delaunay, including the supplied list of points if they fall inside the surface
`static FemModel3d`	`createGrid(FemModel3d model, FemFactory.FemElementType type, double widthX, double widthY, double widthZ, int numX, int numY, int numZ)` Creates a regular grid, composed of elements of the type specified by `type`, centered on the origin, with specified widths and grid resolutions along each axis.
`static FemModel3d`	`createHexExtrusion(FemModel3d model, int n, double d, double zOffset, PolygonalMesh surface)` Creates a shell-based FEM model made of hex elements by extruding a surface mesh along the normal direction of its faces.
`static FemModel3d`	`createHexGrid(FemModel3d model, double widthX, double widthY, double widthZ, int numX, int numY, int numZ)` Creates a regular grid composed of hex elements.
`static FemModel3d`	`createHexTorus(FemModel3d model, double R, double rin, double rout, int nt, int nl, int nr)` Creates a hollow torus made of hex elements.
`static FemModel3d`	`createHexTube(FemModel3d model, double l, double rin, double rout, int nt, int nl, int nr)` Creates a tube made of hex elements.
`static FemModel3d`	`createHexWedgeCylinder(FemModel3d model, double l, double r, int nt, int nl, int nr)` Creates a cylinder made of mostly hex elements, with wedges in the centre column.
`static FemModel3d`	`createHexWedgeExtrusion(FemModel3d model, int n, double d, double zOffset, PolygonalMesh surface, FemModel3d surfaceFem)` Creates a shell-based FEM model by extruding a surface mesh along the normal direction of its faces.
`static FemModel3d`	`createIcosahedralSphere(FemModel3d model, double r, int ndivisions, double quality)` Creates a tet-based spherical model based on a icosahedron.
`static FemModel3d`	`createPartialCylinder(FemModel3d model, double l, double r, double theta, int nl, int nr, int ntheta)` Creates a partial cylinder made of mostly hex elements, with wedges in the centre column
`static FemModel3d`	`createPartialHexTube(FemModel3d model, double l, double rin, double rout, double theta, int nl, int nr, int ntheta)` Creates a partial tube made of hex elements.
`static FemModel3d`	`createPartialHexWedgeCylinder(FemModel3d model, double l, double r, double theta, int nl, int nr, int ntheta)`
`static FemModel3d`	`createPartialTetTube(FemModel3d model, double l, double rin, double rout, double theta, int nl, int nr, int ntheta)` Creates a partial tube made of tet elements.
`static FemModel3d`	`createPartialTube(FemModel3d model, FemFactory.FemElementType type, double l, double rin, double rout, double theta, int nl, int nr, int ntheta)` Creates a partial tube made of either tet or hex elements, as specified by `type`.
`static FemModel3d`	`createPyramidGrid(FemModel3d model, double widthX, double widthY, double widthZ, int numX, int numY, int numZ)` Creates a regular grid composed of pyramid elements.
`static FemModel3d`	`createQuadhexExtrusion(FemModel3d model, int n, double d, double zOffset, PolygonalMesh surface)` Creates a shell-based FEM model made of quadratic hex elements by extruding a surface mesh along the normal direction of its faces.
`static FemModel3d`	`createQuadhexGrid(FemModel3d model, double widthX, double widthY, double widthZ, int numX, int numY, int numZ)` Creates a regular grid composed of quadratic hex elements.
`static FemModel3d`	`createQuadhexTorus(FemModel3d model, double R, double rin, double rout, int nt, int nl, int nr)` Creates a hollow torus made of quadratic hex elements.
`static FemModel3d`	`createQuadhexTube(FemModel3d model, double l, double rin, double rout, int nt, int nl, int nr)` Creates a tube made of quadratic hex elements.
`static FemModel3d`	`createQuadpyramidGrid(FemModel3d model, double widthX, double widthY, double widthZ, int numX, int numY, int numZ)` Creates a regular grid composed of quadratic pyramid elements.
`static FemModel3d`	`createQuadraticModel(FemModel3d quadMod, FemModel3d linMod)` Takes a FemModel3d containing linear elements, and creates a quadratic model whose elements are the corresponding quadratic elements, with new nodes inserted along the edges as required.
`static FemModel3d`	`createQuadtetExtrusion(FemModel3d model, int n, double d, double zOffset, PolygonalMesh surface)` Creates a shell-based FEM model made of quadratic tet elements by extruding a surface mesh along the normal direction of its faces.
`static FemModel3d`	`createQuadtetGrid(FemModel3d model, double widthX, double widthY, double widthZ, int numX, int numY, int numZ)` Creates a regular grid composed of quadratic tet elements.
`static FemModel3d`	`createQuadtetTorus(FemModel3d model, double R, double rin, double rout, int nt, int nl, int nr)` Creates a hollow torus made of quadratic tet elements.
`static FemModel3d`	`createQuadtetTube(FemModel3d model, double l, double rin, double rout, int nt, int nl, int nr)` Creates a tube made of quadratic tet elements.
`static FemModel3d`	`createQuadwedgeExtrusion(FemModel3d model, int n, double d, double zOffset, PolygonalMesh surface)` Creates a shell-based FEM model made of quadratic wedge elements by extruding a surface mesh along the normal direction of its faces.
`static FemModel3d`	`createQuadwedgeGrid(FemModel3d model, double widthX, double widthY, double widthZ, int numX, int numY, int numZ)` Creates a regular grid composed of quadratic wedge elements.
`static FemModel3d`	`createSphere(FemModel3d model, double r, int nt, int nl, int ns)` Convenience method to create a symmetric hex/wedge dominant sphere using `createEllipsoid(artisynth.core.femmodels.FemModel3d, double, double, double, int, int, int)`.
`static FemModel3d`	`createTetExtrusion(FemModel3d model, int n, double d, double zOffset, PolygonalMesh surface)` Creates a shell-based FEM model made of tet elements by extruding a surface mesh along the normal direction of its faces.
`static FemModel3d`	`createTetGrid(FemModel3d model, double widthX, double widthY, double widthZ, int numX, int numY, int numZ)` Creates a regular grid composed of tet elements.
`static FemModel3d`	`createTetTorus(FemModel3d model, double R, double rin, double rout, int nt, int nl, int nr)` Creates a hollow torus made of tet elements.
`static FemModel3d`	`createTetTube(FemModel3d model, double l, double rin, double rout, int nt, int nl, int nr)` Creates a tube made of tet elements.
`static FemModel3d`	`createTorus(FemModel3d model, FemFactory.FemElementType type, double R, double rin, double rout, int nt, int nl, int nr)` Creates a hollow torus made of either tet, hex, quadTet, or quadHex elements, as specified by `type`.
`static FemModel3d`	`createTube(FemModel3d model, FemFactory.FemElementType type, double l, double rin, double rout, int nt, int nl, int nr)` Creates a tube made of either tet, hex, quadTet, or quadHex elements, as specified by `type`.
`static FemModel3d`	`createWedgeExtrusion(FemModel3d model, int n, double d, double zOffset, PolygonalMesh surface)` Creates a shell-based FEM model made of wedge elements by extruding a surface mesh along the normal direction of its faces.
`static FemModel3d`	`createWedgeGrid(FemModel3d model, double widthX, double widthY, double widthZ, int numX, int numY, int numZ)` Creates a regular grid composed of wedge elements.
`static FemModel3d`	`mergeCollapsedNodes(FemModel3d model, FemModel3d orig, double epsilon)`
`static FemModel3d`	`refineFem(FemModel3d model, FemModel3d input, double quality)` Creates a refined version of a an existing tetrahedral FEM model using tetgen.
`static FemModel3d`	`refineFem(FemModel3d model, FemModel3d input, double quality, Point3d[] pnts)` Creates a refined version of a an existing tetrahedral FEM model using tetgen and a list of supplemental node locations.
`static void`	`setPlanarNodesFixed(FemModel fem, Point3d center, Vector3d normal, boolean fixed)`
`static FemModel3d`	`subdivideFem(FemModel3d femr, FemModel3d fem0)` Creates a subdvided FEM model by subdividing all the elements of an existing model into eight sub-elements, adding additional nodes as required.
`static FemModel3d`	`subdivideFem(FemModel3d femr, FemModel3d fem0, boolean addMarkers)`

Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - FemFactory
```
public FemFactory()
```
- Method Detail
  - createTetGrid
```
public static FemModel3d createTetGrid(FemModel3d model,
                                       double widthX,
                                       double widthY,
                                       double widthZ,
                                       int numX,
                                       int numY,
                                       int numZ)
```
    Creates a regular grid composed of tet elements. Identical to createGrid(FemModel3d,FemElementType,double,double,double,int,int,int) with the element type set to FemFactory.FemElementType.Tet.
  - createPyramidGrid
```
public static FemModel3d createPyramidGrid(FemModel3d model,
                                           double widthX,
                                           double widthY,
                                           double widthZ,
                                           int numX,
                                           int numY,
                                           int numZ)
```
    Creates a regular grid composed of pyramid elements. Identical to createGrid(FemModel3d,FemElementType,double,double,double,int,int,int) with the element type set to FemFactory.FemElementType.Pyramid.
  - createHexGrid
```
public static FemModel3d createHexGrid(FemModel3d model,
                                       double widthX,
                                       double widthY,
                                       double widthZ,
                                       int numX,
                                       int numY,
                                       int numZ)
```
    Creates a regular grid composed of hex elements. Identical to createGrid(FemModel3d,FemElementType,double,double,double,int,int,int) with the element type set to FemFactory.FemElementType.Hex.
  - createWedgeGrid
```
public static FemModel3d createWedgeGrid(FemModel3d model,
                                         double widthX,
                                         double widthY,
                                         double widthZ,
                                         int numX,
                                         int numY,
                                         int numZ)
```
    Creates a regular grid composed of wedge elements. Identical to createGrid(FemModel3d,FemElementType,double,double,double,int,int,int) with the element type set to FemFactory.FemElementType.Wedge.
  - mergeCollapsedNodes
```
public static FemModel3d mergeCollapsedNodes(FemModel3d model,
                                             FemModel3d orig,
                                             double epsilon)
```
  - createIcosahedralSphere
```
public static FemModel3d createIcosahedralSphere(FemModel3d model,
                                                 double r,
                                                 int ndivisions,
                                                 double quality)
```
    Creates a tet-based spherical model based on a icosahedron. The method works by creating an icosahedral surface mesh and then using tetgen.
    
    Parameters:
    
    model - empty FEM model to which elements are added; if null then a new model is allocated
    
    r - radius
    
    ndivisions - number of divisions used in creating the surface mesh. Typical values are 1 or 2.
    
    quality - quality parameter passed to tetgen. See createFromMesh(artisynth.core.femmodels.FemModel3d, maspack.geometry.PolygonalMesh, double) for a full description.
    
    Returns:
    
    the FEM model (which will be model if model is not null).
  - createSphere
```
public static FemModel3d createSphere(FemModel3d model,
                                      double r,
                                      int nt,
                                      int nl,
                                      int ns)
```
    Convenience method to create a symmetric hex/wedge dominant sphere using createEllipsoid(artisynth.core.femmodels.FemModel3d, double, double, double, int, int, int).
    
    Parameters:
    
    model - empty FEM model to which elements are added; if null then a new model is allocated
    
    r - radius
    
    nt - number of nodes in each ring parallel to the equator
    
    nl - number of nodes in each quarter ring perpendicular to the equator (including end nodes)
    
    ns - number of nodes in each radial line extending out from the polar axis (including end nodes)
    
    Returns:
    
    the FEM model (which will be model if model is not null).
  - createEllipsoid
```
public static FemModel3d createEllipsoid(FemModel3d model,
                                         double rl,
                                         double rs1,
                                         double rs2,
                                         int nt,
                                         int nl,
                                         int ns)
```
    Creates an ellipsoidal model using a combination of hex, wedge, and tet elements. The model is created symmetrically about a central polar axis, using wedge elements at the core. rl should be the longest radius, and corresponds to the polar axis.
    
    Parameters:
    
    model - empty FEM model to which elements are added; if null then a new model is allocated
    
    rl - longest radius (also the polar radius)
    
    rs1 - first radius perpendicular to the polar axis
    
    rs2 - second radius perpendicular to the polar axis
    
    nt - number of nodes in each ring parallel to the equator
    
    nl - number of nodes in each quarter ring perpendicular to the equator (including end nodes)
    
    ns - number of nodes in each radial line extending out from the polar axis (including end nodes)
    
    Returns:
    
    the FEM model (which will be model if model is not null).
  - createCylinder
```
public static FemModel3d createCylinder(FemModel3d model,
                                        double l,
                                        double r,
                                        int nt,
                                        int nl,
                                        int nr)
```
    Creates a cylinder made of mostly hex elements, with wedges in the centre column.
    
    Parameters:
    
    model - model to which the elements should be added, or null if the model is to be created from scratch.
    
    l - length along the z axis
    
    r - radius in the x-y plane
    
    nt - element resolution around the center axis
    
    nl - element resolution along the length
    
    nr - element resolution along the radius
    
    Returns:
    
    created FEM model
  - createHexWedgeCylinder
```
public static FemModel3d createHexWedgeCylinder(FemModel3d model,
                                                double l,
                                                double r,
                                                int nt,
                                                int nl,
                                                int nr)
```
    Creates a cylinder made of mostly hex elements, with wedges in the centre column. Identical to createCylinder(FemModel3d,double,double,int,int,int).
  - createPartialCylinder
```
public static FemModel3d createPartialCylinder(FemModel3d model,
                                               double l,
                                               double r,
                                               double theta,
                                               int nl,
                                               int nr,
                                               int ntheta)
```
    Creates a partial cylinder made of mostly hex elements, with wedges in the centre column
    
    Parameters:
    
    model - model to which the elements should be added, or null if the model is to be created from scratch.
    
    l - length along the z axis
    
    r - radius in the x-y plane
    
    theta - size of the slice, in radians
    
    nl - element resolution along the length
    
    nr - element resolution along the radius
    
    ntheta - element resolution around the slice
    
    Returns:
    
    created FEM model
  - createPartialHexWedgeCylinder
```
public static FemModel3d createPartialHexWedgeCylinder(FemModel3d model,
                                                       double l,
                                                       double r,
                                                       double theta,
                                                       int nl,
                                                       int nr,
                                                       int ntheta)
```
  - createHexTube
```
public static FemModel3d createHexTube(FemModel3d model,
                                       double l,
                                       double rin,
                                       double rout,
                                       int nt,
                                       int nl,
                                       int nr)
```
    Creates a tube made of hex elements. Identical to createTube(FemModel3d,FemElementType,double,double,double,int,int,int) with the element type set to FemFactory.FemElementType.Hex.
  - createTetTube
```
public static FemModel3d createTetTube(FemModel3d model,
                                       double l,
                                       double rin,
                                       double rout,
                                       int nt,
                                       int nl,
                                       int nr)
```
    Creates a tube made of tet elements. Identical to createTube(FemModel3d,FemElementType,double,double,double,int,int,int) with the element type set to FemFactory.FemElementType.Tet.
  - createPartialHexTube
```
public static FemModel3d createPartialHexTube(FemModel3d model,
                                              double l,
                                              double rin,
                                              double rout,
                                              double theta,
                                              int nl,
                                              int nr,
                                              int ntheta)
```
    Creates a partial tube made of hex elements. Identical to createPartialTube(FemModel3d,FemElementType,double,double,double,double,int,int,int) with the element type set to FemFactory.FemElementType.Hex.
  - createPartialTetTube
```
public static FemModel3d createPartialTetTube(FemModel3d model,
                                              double l,
                                              double rin,
                                              double rout,
                                              double theta,
                                              int nl,
                                              int nr,
                                              int ntheta)
```
    Creates a partial tube made of tet elements. Identical to createPartialTube(FemModel3d,FemElementType,double,double,double,double,int,int,int) with the element type set to FemFactory.FemElementType.Tet.
  - createHexTorus
```
public static FemModel3d createHexTorus(FemModel3d model,
                                        double R,
                                        double rin,
                                        double rout,
                                        int nt,
                                        int nl,
                                        int nr)
```
    Creates a hollow torus made of hex elements. Identical to createTorus(FemModel3d,FemElementType,double,double,double,int,int,int) with the element type set to FemFactory.FemElementType.Hex.
  - createTetTorus
```
public static FemModel3d createTetTorus(FemModel3d model,
                                        double R,
                                        double rin,
                                        double rout,
                                        int nt,
                                        int nl,
                                        int nr)
```
    Creates a hollow torus made of tet elements. Identical to createTorus(FemModel3d,FemElementType,double,double,double,int,int,int) with the element type set to FemFactory.FemElementType.Tet.
  - createQuadraticModel
```
public static FemModel3d createQuadraticModel(FemModel3d quadMod,
                                              FemModel3d linMod)
```
    Takes a FemModel3d containing linear elements, and creates a quadratic model whose elements are the corresponding quadratic elements, with new nodes inserted along the edges as required. The new quadratic model will have straight edges in the rest position.
    
    Parameters:
    
    linMod - A FemModel3d previously inialized with only linear elements.
  - createQuadtetGrid
```
public static FemModel3d createQuadtetGrid(FemModel3d model,
                                           double widthX,
                                           double widthY,
                                           double widthZ,
                                           int numX,
                                           int numY,
                                           int numZ)
```
    Creates a regular grid composed of quadratic tet elements. Identical to createGrid(FemModel3d,FemElementType,double,double,double,int,int,int) with the element type set to FemFactory.FemElementType.QuadTet.
  - createQuadtetTube
```
public static FemModel3d createQuadtetTube(FemModel3d model,
                                           double l,
                                           double rin,
                                           double rout,
                                           int nt,
                                           int nl,
                                           int nr)
```
    Creates a tube made of quadratic tet elements. Identical to createTube(FemModel3d,FemElementType,double,double,double,int,int,int) with the element type set to FemFactory.FemElementType.QuadTet.
  - createQuadtetTorus
```
public static FemModel3d createQuadtetTorus(FemModel3d model,
                                            double R,
                                            double rin,
                                            double rout,
                                            int nt,
                                            int nl,
                                            int nr)
```
    Creates a hollow torus made of quadratic tet elements. Identical to createTorus(FemModel3d,FemElementType,double,double,double,int,int,int) with the element type set to FemFactory.FemElementType.QuadTet.
  - createQuadtetExtrusion
```
public static FemModel3d createQuadtetExtrusion(FemModel3d model,
                                                int n,
                                                double d,
                                                double zOffset,
                                                PolygonalMesh surface)
```
    Creates a shell-based FEM model made of quadratic tet elements by extruding a surface mesh along the normal direction of its faces. Identical to createExtrusion(FemModel3d,FemElementType,int,double,double,PolygonalMesh) with the element type set to FemFactory.FemElementType.QuadTet.
  - createQuadhexGrid
```
public static FemModel3d createQuadhexGrid(FemModel3d model,
                                           double widthX,
                                           double widthY,
                                           double widthZ,
                                           int numX,
                                           int numY,
                                           int numZ)
```
    Creates a regular grid composed of quadratic hex elements. Identical to createGrid(FemModel3d,FemElementType,double,double,double,int,int,int) with the element type set to FemFactory.FemElementType.QuadHex.
  - createQuadwedgeGrid
```
public static FemModel3d createQuadwedgeGrid(FemModel3d model,
                                             double widthX,
                                             double widthY,
                                             double widthZ,
                                             int numX,
                                             int numY,
                                             int numZ)
```
    Creates a regular grid composed of quadratic wedge elements. Identical to createGrid(FemModel3d,FemElementType,double,double,double,int,int,int) with the element type set to FemFactory.FemElementType.QuadWedge.
  - createQuadpyramidGrid
```
public static FemModel3d createQuadpyramidGrid(FemModel3d model,
                                               double widthX,
                                               double widthY,
                                               double widthZ,
                                               int numX,
                                               int numY,
                                               int numZ)
```
    Creates a regular grid composed of quadratic pyramid elements. Identical to createGrid(FemModel3d,FemElementType,double,double,double,int,int,int) with the element type set to FemFactory.FemElementType.QuadPyramid.
  - createQuadhexTube
```
public static FemModel3d createQuadhexTube(FemModel3d model,
                                           double l,
                                           double rin,
                                           double rout,
                                           int nt,
                                           int nl,
                                           int nr)
```
    Creates a tube made of quadratic hex elements. Identical to createTube(FemModel3d,FemElementType,double,double,double,int,int,int) with the element type set to FemFactory.FemElementType.QuadHex.
  - createQuadhexTorus
```
public static FemModel3d createQuadhexTorus(FemModel3d model,
                                            double R,
                                            double rin,
                                            double rout,
                                            int nt,
                                            int nl,
                                            int nr)
```
    Creates a hollow torus made of quadratic hex elements. Identical to createTorus(FemModel3d,FemElementType,double,double,double,int,int,int) with the element type set to FemFactory.FemElementType.QuadHex.
  - createQuadhexExtrusion
```
public static FemModel3d createQuadhexExtrusion(FemModel3d model,
                                                int n,
                                                double d,
                                                double zOffset,
                                                PolygonalMesh surface)
```
    Creates a shell-based FEM model made of quadratic hex elements by extruding a surface mesh along the normal direction of its faces. The surface mesh must be composed of quads. Identical to createExtrusion(FemModel3d,FemElementType,int,double,double,PolygonalMesh) with the element type set to FemFactory.FemElementType.QuadHex.
  - createQuadwedgeExtrusion
```
public static FemModel3d createQuadwedgeExtrusion(FemModel3d model,
                                                  int n,
                                                  double d,
                                                  double zOffset,
                                                  PolygonalMesh surface)
```
    Creates a shell-based FEM model made of quadratic wedge elements by extruding a surface mesh along the normal direction of its faces. The surface mesh must be composed of triangles. Identical to createExtrusion(FemModel3d,FemElementType,int,double,double,PolygonalMesh) with the element type set to FemFactory.FemElementType.Wedge.
  - createHexExtrusion
```
public static FemModel3d createHexExtrusion(FemModel3d model,
                                            int n,
                                            double d,
                                            double zOffset,
                                            PolygonalMesh surface)
```
    Creates a shell-based FEM model made of hex elements by extruding a surface mesh along the normal direction of its faces. The surface mesh must be composed of quads. Identical to createExtrusion(FemModel3d,FemElementType,int,double,double,PolygonalMesh) with the element type set to FemFactory.FemElementType.Hex.
  - createWedgeExtrusion
```
public static FemModel3d createWedgeExtrusion(FemModel3d model,
                                              int n,
                                              double d,
                                              double zOffset,
                                              PolygonalMesh surface)
```
    Creates a shell-based FEM model made of wedge elements by extruding a surface mesh along the normal direction of its faces. The surface mesh must be composed of triangles. Identical to createExtrusion(FemModel3d,FemElementType,int,double,double,PolygonalMesh) with the element type set to FemFactory.FemElementType.Wedge.
  - createHexWedgeExtrusion
```
public static FemModel3d createHexWedgeExtrusion(FemModel3d model,
                                                 int n,
                                                 double d,
                                                 double zOffset,
                                                 PolygonalMesh surface,
                                                 FemModel3d surfaceFem)
```
    Creates a shell-based FEM model by extruding a surface mesh along the normal direction of its faces. The element types used depend on the underlying faces: triangular faces generate wedge elements, while quad faces generate hex elements. If the mesh is the surface mesh of an underlying FemModel, then each triangle is examined to see if it is associated with an underlying hex element, and if it is, then a hex element is extruded from both the surface triangles connected to that element. The shell can have multiple layers; the number of layers is n.
    
    Parameters:
    
    model - model to which the elements should be added, or null if the model is to be created from scratch. Note that model must be different from surfaceFem
    
    n - number of layers
    
    d - layer thickness
    
    zOffset - offset from the surface
    
    surface - surface mesh to extrude
    
    surfaceFem - FEM associated with the surface mesh, or null if there is no associated FEM.
    
    Returns:
    
    extruded FEM model, which will be model if that argument is not null.
  - createExtrusion
```
public static FemModel3d createExtrusion(FemModel3d model,
                                         int n,
                                         double d,
                                         double zOffset,
                                         PolygonalMesh surface)
```
    Creates a shell-based FEM model by extruding a surface mesh along the normal direction of its faces. The element types used depend on the underlying faces: triangular faces generate wedge elements, while quad faces generate hex elements. The shell can have multiple layers; the number of layers is n.
    
    Parameters:
    
    model - model to which the elements should be added, or null if the model is to be created from scratch.
    
    n - number of layers
    
    d - layer thickness
    
    zOffset - offset from the surface
    
    surface - surface mesh to extrude
    
    Returns:
    
    extruded FEM model, which will be model if that argument is not null
    
    Throws:
    
    java.lang.IllegalArgumentException - if the specified element type is not supported, or if the surface faces are not triangles or quads.
  - createTetExtrusion
```
public static FemModel3d createTetExtrusion(FemModel3d model,
                                            int n,
                                            double d,
                                            double zOffset,
                                            PolygonalMesh surface)
```
    Creates a shell-based FEM model made of tet elements by extruding a surface mesh along the normal direction of its faces. Identical to createExtrusion(FemModel3d,FemElementType,int,double,double,PolygonalMesh) with the element type set to FemFactory.FemElementType.Tet.
  - createGrid
```
public static FemModel3d createGrid(FemModel3d model,
                                    FemFactory.FemElementType type,
                                    double widthX,
                                    double widthY,
                                    double widthZ,
                                    int numX,
                                    int numY,
                                    int numZ)
```
    Creates a regular grid, composed of elements of the type specified by type, centered on the origin, with specified widths and grid resolutions along each axis.
    
    Parameters:
    
    model - model to which the hex elements be added, or null if the model is to be created from scratch.
    
    type - desired element type
    
    widthX - x axis model width
    
    widthY - y axis model width
    
    widthZ - z axis model width
    
    numX - element resolution along the x axis
    
    numY - element resolution along the y axis
    
    numZ - element resolution along the z axis
    
    Returns:
    
    created FEM model
    
    Throws:
    
    java.lang.IllegalArgumentException - if the specified element type is not supported
  - createTube
```
public static FemModel3d createTube(FemModel3d model,
                                    FemFactory.FemElementType type,
                                    double l,
                                    double rin,
                                    double rout,
                                    int nt,
                                    int nl,
                                    int nr)
```
    Creates a tube made of either tet, hex, quadTet, or quadHex elements, as specified by type. Note that the element resolution nt around the central axis will be rounded up to an even number for tet or quadTet models.
    
    Parameters:
    
    model - model to which the elements should be added, or null if the model is to be created from scratch.
    
    type - desired element type
    
    l - length along the z axis
    
    rin - inner radius
    
    rout - outer radius
    
    nt - element resolution around the central axis (will be rounded up to an even number for tet or quadTet models)
    
    nl - element resolution along the length
    
    nr - element resolution along the thickness
    
    Returns:
    
    created FEM model
    
    Throws:
    
    java.lang.IllegalArgumentException - if the specified element type is not supported
  - createPartialTube
```
public static FemModel3d createPartialTube(FemModel3d model,
                                           FemFactory.FemElementType type,
                                           double l,
                                           double rin,
                                           double rout,
                                           double theta,
                                           int nl,
                                           int nr,
                                           int ntheta)
```
    Creates a partial tube made of either tet or hex elements, as specified by type.
    
    Parameters:
    
    model - model to which the elements should be added, or null if the model is to be created from scratch.
    
    type - desired element type
    
    l - length along the z axis
    
    rin - inner radius
    
    rout - outer radius
    
    theta - size of the partial tube slice, in radians
    
    nl - element resolution along the length
    
    nr - element resolution along the thickness
    
    ntheta - element resolution along the slice
    
    Returns:
    
    created FEM model
    
    Throws:
    
    java.lang.IllegalArgumentException - if the specified element type is not supported
  - createTorus
```
public static FemModel3d createTorus(FemModel3d model,
                                     FemFactory.FemElementType type,
                                     double R,
                                     double rin,
                                     double rout,
                                     int nt,
                                     int nl,
                                     int nr)
```
    Creates a hollow torus made of either tet, hex, quadTet, or quadHex elements, as specified by type. The result is essentially a tube, with inner and outer radii given by rin and rout, bent around the major radius R and connected. For tet or quadTet models, the element resolutions nt and nl will be rounded up to an even number.
    
    Parameters:
    
    model - model to which the elements should be added, or null if the model is to be created from scratch.
    
    type - desired element type
    
    R - major radius
    
    rin - inner part of the minor radius
    
    rout - outer part of the minor radius
    
    nt - element resolution around the major radius (will be rounded up to an even number for tet or quadTet models)
    
    nl - element resolution around the minor radius (will be rounded up to an even number for tet or quadTet models)
    
    nr - element resolution along the inner thickness
    
    Returns:
    
    created FEM model
    
    Throws:
    
    java.lang.IllegalArgumentException - if the specified element type is not supported
  - createExtrusion
```
public static FemModel3d createExtrusion(FemModel3d model,
                                         FemFactory.FemElementType type,
                                         int n,
                                         double d,
                                         double zOffset,
                                         PolygonalMesh surface)
```
    Creates a shell-based FEM model by extruding a surface mesh along the normal direction of its faces. The model is composed of either tet, hex, quadTet or quadHex elements, as specified by type. The shell can have multiple layers; the number of layers is n.
    
    Parameters:
    
    model - model to which the elements should be added, or null if the model is to be created from scratch.
    
    type - desired element type
    
    n - number of layers
    
    d - layer thickness
    
    zOffset - offset from the surface
    
    surface - surface mesh to extrude
    
    Returns:
    
    extruded FEM model, which will be model if that argument is not null
    
    Throws:
    
    java.lang.IllegalArgumentException - if the specified element type is not supported, or if the surface faces are incompatible with the element type.
  - createFromMesh
```
public static FemModel3d createFromMesh(FemModel3d model,
                                        PolygonalMesh surface,
                                        double quality)
```
    Creates a tetrahedral FEM model from a triangular surface mesh. The tetrahedra will be added to either an existing model (supplied through the argument model), or a newly created FemModel3d (if model is null).
    The tessellation is done using tetgen, which is called through a JNI interface. The tessellation quality is controlled using the quality variable, described below.
    
    Parameters:
    
    model - model to which the tetrahedra should be added, or null if the model is to be created from scratch.
    
    surface - triangular surface mesh used to define the tessellation.
    
    quality - If 0, then only the mesh nodes will be used to form the tessellation. However, this may result in highly degenerate tetrahedra. Otherwise, if > 0, tetgen will add additional nodes to ensure that the minimum edge-radius ratio does not exceed quality. A good default value for quality is 2. If set too small (such as less then 1), then tetgen may not terminate.
    
    Returns:
    
    the FEM model
  - createFromMeshAndPoints
```
public static FemModel3d createFromMeshAndPoints(FemModel3d model,
                                                 PolygonalMesh surface,
                                                 double quality,
                                                 Point3d[] pnts)
```
    Constrained Delaunay, including the supplied list of points if they fall inside the surface
  - refineFem
```
public static FemModel3d refineFem(FemModel3d model,
                                   FemModel3d input,
                                   double quality,
                                   Point3d[] pnts)
```
    Creates a refined version of a an existing tetrahedral FEM model using tetgen and a list of supplemental node locations.
    
    Parameters:
    
    model - model in which the refined model be built, or null if the model is to be created from scratch.
    
    input - original FEM model which is to be refined
    
    quality - quality factor used by tetgen to refine the model
    
    pnts - locations of the supplemental node
    
    Returns:
    
    refined FEM model
  - refineFem
```
public static FemModel3d refineFem(FemModel3d model,
                                   FemModel3d input,
                                   double quality)
```
    Creates a refined version of a an existing tetrahedral FEM model using tetgen.
    
    Parameters:
    
    model - model in which the refined model be built, or null if the model is to be created from scratch.
    
    input - original FEM model which is to be refined
    
    quality - quality factor used by tetgen to refine the model
    
    Returns:
    
    refined FEM model
  - addFem
```
public static void addFem(FemModel3d fem0,
                          FemModel3d fem1)
```
    Adds a copy of the nodes, elements, markers and attachments from fem1 to fem0. Nodes in fem1 are merged with nodes in fem0 that are within TOL distance of each other, where TOL is 1e-8 times the maximum radius of fem0 and fem1. For precise control of node merging, use addFem(FemModel3d,FemModel3d,double).
    
    Parameters:
    
    fem0 - FEM model to which components should be added
    
    fem1 - FEM model providing components
  - addFem
```
public static void addFem(FemModel3d fem0,
                          FemModel3d fem1,
                          double nodeMergeDist)
```
    Adds a copy of the nodes, elements, markers and attachments from fem1 to fem0.
    
    Parameters:
    
    fem0 - FEM model to which components should be added
    
    fem1 - FEM model providing components
    
    nodeMergeDist - If >= 0, causes nearby nodes of fem1 and fem0 to be merged: any node of fem1 that is within nodeMergeDist of a node in fem0 is replaced by the nearest node in fem0.
  - subdivideFem
```
public static FemModel3d subdivideFem(FemModel3d femr,
                                      FemModel3d fem0)
```
    Creates a subdvided FEM model by subdividing all the elements of an existing model into eight sub-elements, adding additional nodes as required. The existing model is not modified. At present, this is supported only for models composed of tetrahedra, hexahedra, and wedges. Markers in the original mesh are copied, but attachments (T-junction connections) are not. Likewise, if the original FEM is a FemMuscleModel, the muscle group information is not copied either.
    
    Parameters:
    
    femr - model in which refined FEM is to be constructed, or null if the model is to be created from scratch.
    
    fem0 - existing FEM model to be refined.
  - subdivideFem
```
public static FemModel3d subdivideFem(FemModel3d femr,
                                      FemModel3d fem0,
                                      boolean addMarkers)
```
  - createFromElementList
```
public static void createFromElementList(FemModel3d out,
                                         java.util.Collection<FemElement3d> elemList)
```
    Creates a new model by duplicating nodes and elements
    
    Parameters:
    
    out - model to fill
    
    elemList - elements to build model from
  - setPlanarNodesFixed
```
public static void setPlanarNodesFixed(FemModel fem,
                                       Point3d center,
                                       Vector3d normal,
                                       boolean fixed)
```

Class FemFactory

Nested Class Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

FemFactory

Method Detail

createTetGrid

createPyramidGrid

createHexGrid

createWedgeGrid

mergeCollapsedNodes

createIcosahedralSphere

createSphere

createEllipsoid

createCylinder

createHexWedgeCylinder

createPartialCylinder

createPartialHexWedgeCylinder

createHexTube

createTetTube

createPartialHexTube

createPartialTetTube

createHexTorus

createTetTorus

createQuadraticModel

createQuadtetGrid

createQuadtetTube

createQuadtetTorus

createQuadtetExtrusion

createQuadhexGrid

createQuadwedgeGrid

createQuadpyramidGrid

createQuadhexTube

createQuadhexTorus

createQuadhexExtrusion

createQuadwedgeExtrusion

createHexExtrusion

createWedgeExtrusion

createHexWedgeExtrusion

createExtrusion

createTetExtrusion

createGrid

createTube

createPartialTube

createTorus

createExtrusion

createFromMesh

createFromMeshAndPoints

refineFem

refineFem

addFem

addFem

subdivideFem

subdivideFem

createFromElementList

setPlanarNodesFixed