Vega FEM Library (v1.1) User's Manual - University of Southern ...

void ComputeForceAndStiffnessMatrix(double * vertexDisplacements,
double * internalForces, SparseMatrix * stiffnessMatrix, int warp=1)
Computes the internal forces and stiffness matrix given a vector vertexDisplacements of the displacements
for the vertices of the tetrahedral mesh. If either internalForces or stiffnessMatrix is NULL, the
function does not calculate or return the corresponding information. The warp parameter controls whether
the simulation “warps” stiffnesses and therefore supports large deformations. When warping is enabled
(warp=1 or warp=2), the implementation supports large deformations. The default is warp=1, in which
case the simulation uses the approximate tangent stiffness matrix as described in [MG04]. For warp=2,
the class computes the exact tangent stiffness matrix; our implementation is described in [Bar12]. Such
an exact matrix has better simulation properties; however, it requires approximately 1.5x the computation
time of the approximate matrix. If warping is disabled (warp=0), one obtains the standard linear FEM
simulation [Sha90]. Such simulation runs faster than the warped simulations because it timesteps the linear
equation Mü + D ˙u + Ku = f. It is only accurate under small displacements.
2.4 elasticForceModel
Provides implementation of the ForceModel base class for the deformable models supported by Vega. This
makes it possible to use these deformable models with the integrators in Vega (integrator library).
class CorotationalLinearFEMForceModel : public ForceModel Exposes the internal force- and
stiffness matrix-calculating functionality of the CorotationalLinearFEM material using the common interface
of ForceModel.
CorotationalLinearFEMForceModel(CorotationalLinearFEM *
corotationalLinearFEM, int warp=1)
Sets the CorotationalLinearFEM object for force and stiffness calculations. The parameter warp has
the same meaning as in the CorotationalLinearFEM class.
void SetWarp(int warp)
Sets the warp parameter. This makes it possible to change the warp parameter at runtime.
class MassSpringSystemForceModel : public ForceModel Exposes the internal force- and stiffness
matrix-calculating functionality of the mass-spring material using the common interface of ForceModel.
MassSpringSystemForceModel(MassSpringSystem * massSpringSystem)
Sets the MassSpringSystem object used for force and stiffness calculations.
class StVKForceModel : public ForceModel Exposes the internal force- and stiffness matrix-calculating
functionality of the StVK material using the common interface of ForceModel.
StVKForceModel(StVKInternalForces * stVKInternalForces,
StVKStiffnessMatrix * stVKStiffnessMatrix = NULL)
Sets the StVK objects used for internal forces and stiffness calculations. If no StVKStiffnessMatrix is
provided, one is constructed based upon stVKInternalForces.
class IsotropicHyperelasticFEMForceModel : public ForceModel Exposes the internal force- and
stiffness matrix-calculating functionality of the invertible FEM materials using the common interface of
ForceModel.
IsotropicHyperelasticFEMForceModel(
IsotropicHyperelasticFEM * isotropicHyperelasticFEM)
Sets the invertible-elements object used for internal forces and stiffness matrix calculations.
10