FEM EquationElasticity: Difference between revisions

From FreeCAD Documentation
(Marked this version for translation)
Line 26: Line 26:
This equation describes the mechanical properties of rigid bodies.
This equation describes the mechanical properties of rigid bodies.


<!--T:10-->
For info about the math of the equation, see the [http://www.elmerfem.org/blog/documentation/ Elmer models manual], section ''Linear Elasticity''.
For info about the math of the equation, see the [http://www.elmerfem.org/blog/documentation/ Elmer models manual], section ''Linear Elasticity''.


==Usage==
==Usage== <!--T:11-->


<!--T:12-->
# After adding an Elmer solver as described [[FEM_SolverElmer#Equations|here]], select it in the [[Tree_view|tree view]].
# After adding an Elmer solver as described [[FEM_SolverElmer#Equations|here]], select it in the [[Tree_view|tree view]].
# Now either use the toolbar button [[Image:FEM_EquationElasticity.svg|24px]] or the menu {{MenuCommand|Solve → Elasticity equation}}.
# Now either use the toolbar button [[Image:FEM_EquationElasticity.svg|24px]] or the menu {{MenuCommand|Solve → Elasticity equation}}.
# Change the [[#Solver_Settings|equation's solver settings]] or the [[FEM_SolverElmer_SolverSettings|general solver settings]] if necessary.
# Change the [[#Solver_Settings|equation's solver settings]] or the [[FEM_SolverElmer_SolverSettings|general solver settings]] if necessary.


==Solver Settings==
==Solver Settings== <!--T:13-->


<!--T:14-->
For the general solver settings, see the [[FEM_SolverElmer_SolverSettings|Elmer solver settings]].
For the general solver settings, see the [[FEM_SolverElmer_SolverSettings|Elmer solver settings]].


<!--T:15-->
The elasticity equation provides these special settings:
The elasticity equation provides these special settings:
* {{PropertyData|Calculate Pangle}}: If the principal angles should be calculated.
* {{PropertyData|Calculate Pangle}}: If the principal angles should be calculated.
Line 55: Line 59:
* {{PropertyData|Variable}}: The variable for the elasticity equation. Only change this if {{PropertyData|Incompressible}} is set to ''true'' in accordance to the Elmer manual.
* {{PropertyData|Variable}}: The variable for the elasticity equation. Only change this if {{PropertyData|Incompressible}} is set to ''true'' in accordance to the Elmer manual.


<!--T:16-->
Eigenvalues:
Eigenvalues:
* {{PropertyData|Eigen Analysis}}: If an eigen analysis should be performed (calculation of eigenmodes and eigenfrequencies).
* {{PropertyData|Eigen Analysis}}: If an eigen analysis should be performed (calculation of eigenmodes and eigenfrequencies).
Line 64: Line 69:
* {{PropertyData|Eigen System Values}}: The number of the highest eigenmode that should be calculated.
* {{PropertyData|Eigen System Values}}: The number of the highest eigenmode that should be calculated.


<!--T:17-->
Equation:
Equation:
* {{PropertyData|Plane Stress}}: Computes solution according to the plane stress situation. Applies only for 2D geometry.
* {{PropertyData|Plane Stress}}: Computes solution according to the plane stress situation. Applies only for 2D geometry.


==Constraint Information==
==Constraint Information== <!--T:18-->


<!--T:19-->
The elasticity equation takes the following constraints into account if they are set:
The elasticity equation takes the following constraints into account if they are set:


<!--T:20-->
* [[Image:FEM_ConstraintFixed.svg|32px]] [[FEM_ConstraintFixed|Constraint fixed]]
* [[Image:FEM_ConstraintFixed.svg|32px]] [[FEM_ConstraintFixed|Constraint fixed]]
* [[Image:FEM_ConstraintDisplacement.svg|32px]] [[FEM_ConstraintDisplacement|Constraint displacement]]
* [[Image:FEM_ConstraintDisplacement.svg|32px]] [[FEM_ConstraintDisplacement|Constraint displacement]]
Line 78: Line 86:
* [[Image:FEM_ConstraintInitialTemperature.svg|32px]] [[FEM_ConstraintInitialTemperature|Constraint initial temperature]]
* [[Image:FEM_ConstraintInitialTemperature.svg|32px]] [[FEM_ConstraintInitialTemperature|Constraint initial temperature]]


===Note===
===Note=== <!--T:21-->


<!--T:22-->
For all above constraints it is important that they act on a face. Constraints set to lines or vertices are not recognized by the Elmer solver.
For all above constraints it is important that they act on a face. Constraints set to lines or vertices are not recognized by the Elmer solver.


==Eigenmode Analysis==
==Eigenmode Analysis== <!--T:23-->


<!--T:24-->
To perform an eigenmode analysis (calculation if the eigenmodes and eigenfrequencies), you need to
To perform an eigenmode analysis (calculation if the eigenmodes and eigenfrequencies), you need to
# Set {{PropertyData|Eigen Analysis}}: to ''true''
# Set {{PropertyData|Eigen Analysis}}: to ''true''
Line 91: Line 101:
# Run the solver.
# Run the solver.


<!--T:25-->
'''Note''': If you use more than one CPU core for the solver ({{Version|1.0}}), you cannot use ''Umfpack'', the only direct method for parallel solving is ''MUMPS''.</br>Also note that iterative solving is not recommended for eigenmode analysis. Therefore either only use one CPU core or install the ''MUMPS'' module to Elmer.
'''Note''': If you use more than one CPU core for the solver ({{Version|1.0}}), you cannot use ''Umfpack'', the only direct method for parallel solving is ''MUMPS''.</br>Also note that iterative solving is not recommended for eigenmode analysis. Therefore either only use one CPU core or install the ''MUMPS'' module to Elmer.


==Buckling Analysis==
==Buckling Analysis== <!--T:26-->


<!--T:27-->
To perform a buckling analysis, you need to do the same as for an [[FEM_EquationElasticity#Eigenmode_Analysis|Eigenmode Analysis]], and additionally:
To perform a buckling analysis, you need to do the same as for an [[FEM_EquationElasticity#Eigenmode_Analysis|Eigenmode Analysis]], and additionally:
* Set {{PropertyData|Stability Analysis}}: to ''true''
* Set {{PropertyData|Stability Analysis}}: to ''true''


==Results==
==Results== <!--T:28-->


<!--T:29-->
The available results depend on the [[#Solver_Settings|solver settings]]. If none of them was set to ''true'', only the displacement is calculated. Otherwise also the corresponding results will be available. If {{PropertyData|Eigen Analysis}} was set to ''true'' all results will be available for every calculated eigenmode.
The available results depend on the [[#Solver_Settings|solver settings]]. If none of them was set to ''true'', only the displacement is calculated. Otherwise also the corresponding results will be available. If {{PropertyData|Eigen Analysis}} was set to ''true'' all results will be available for every calculated eigenmode.


<!--T:30-->
If {{PropertyData|Eigen Analysis}} was set to ''true'', the eigenfrequencies are output at the end of the solver log in the solver dialog and also in the document '''SolverElmerOutput''' that will be created in the tree view after the solver has finished.
If {{PropertyData|Eigen Analysis}} was set to ''true'', the eigenfrequencies are output at the end of the solver log in the solver dialog and also in the document '''SolverElmerOutput''' that will be created in the tree view after the solver has finished.


<!--T:31-->
'''Note:''' The eigenmode displacement <math>\vec{d}</math> vector has an arbitrary value since the result is
'''Note:''' The eigenmode displacement <math>\vec{d}</math> vector has an arbitrary value since the result is


<!--T:32-->
<math>\quad
<math>\quad
\vec{d} = c\cdot\vec{u}
\vec{d} = c\cdot\vec{u}
</math>
</math>


<!--T:33-->
whereas <math>\vec{u}</math> is the eigenvector and <math>c</math> is a complex number.
whereas <math>\vec{u}</math> is the eigenvector and <math>c</math> is a complex number.



Revision as of 19:04, 5 October 2022

FEM EquationElasticity

Menu location
Solve → Elasticity equation
Workbenches
FEM
Default shortcut
None
Introduced in version
0.19
See also
FEM tutorial

Description

This equation describes the mechanical properties of rigid bodies.

For info about the math of the equation, see the Elmer models manual, section Linear Elasticity.

Usage

  1. After adding an Elmer solver as described here, select it in the tree view.
  2. Now either use the toolbar button or the menu Solve → Elasticity equation.
  3. Change the equation's solver settings or the general solver settings if necessary.

Solver Settings

For the general solver settings, see the Elmer solver settings.

The elasticity equation provides these special settings:

  • DataCalculate Pangle: If the principal angles should be calculated.
  • DataCalculate Principal: If all stresses should be calculated.
  • DataCalculate Strains: If strains will be calculated. This will also calculate the stresses, even if DataCalculate Principal or DataCalculate Stresses is false.
  • DataCalculate Stresses: If stresses should be calculated. Compared to DataCalculate Principal the Tresca and the pincipal stress will not be calculated.
  • DataConstant Bulk System: See the Elmer manual for more info.
  • DataDisplace Mesh: If mesh can be deformed. This is by default true and must be set to false for eigenfrequency analyses.
  • DataFix Displacement: If displacements or forces are set. thereby DataModel Lumping is automatically used.
  • DataGeometric Stiffness: Considers the geometric stiffness of the body.
  • DataIncompressible: Computation of incompressible material in connection with viscoelastic Maxwell material and a custom DataVariable.
  • DataMaxwell Material: Compute the viscoelastic material model.
  • DataModel Lumping: Uses model lumping.
  • DataModel Lumping Filename: File to save the results from the model lumping.
  • DataStability Analysis: If true DataEigen Analysis becomes a stability analysis (buckling analysis). Otherwise a modal analysis is performed.
  • DataUpdate Transient System: See the Elmer manual for more info.
  • DataVariable: The variable for the elasticity equation. Only change this if DataIncompressible is set to true in accordance to the Elmer manual.

Eigenvalues:

  • DataEigen Analysis: If an eigen analysis should be performed (calculation of eigenmodes and eigenfrequencies).
  • DataEigen System Complex: Should be true if the eigen system is complex. it must be false for a damped eigen value analyses.
  • DataEigen System Compute Residuals: Computes residuals of the eigen value system.
  • DataEigen System Damped: Set a damped eigen analysis. Can only be used if DataLinear Solver Type is Iterative.
  • DataEigen System Select: Selection of which eigenvalues are computed. Note that the selection of Largest* cause an infinite run for recent Elmer (as of August 2022).
  • DataEigen System Tolerance: Convergence tolerance for iterative eigensystem solve. The default is 100 times the DataLinear Tolerance.
  • DataEigen System Values: The number of the highest eigenmode that should be calculated.

Equation:

  • DataPlane Stress: Computes solution according to the plane stress situation. Applies only for 2D geometry.

Constraint Information

The elasticity equation takes the following constraints into account if they are set:

Note

For all above constraints it is important that they act on a face. Constraints set to lines or vertices are not recognized by the Elmer solver.

Eigenmode Analysis

To perform an eigenmode analysis (calculation if the eigenmodes and eigenfrequencies), you need to

  1. Set DataEigen Analysis: to true
  2. Set DataDisplace Mesh: to false
  3. Set DataEigen System Values: to the highest number of eigenmodes you are interested in. The smaller this number the shorter the solver runtime since higher modes can be omitted from computation.
  4. Add a constraint fixed and set at least one face of the body as fixed.
  5. Run the solver.

Note: If you use more than one CPU core for the solver (introduced in version 1.0), you cannot use Umfpack, the only direct method for parallel solving is MUMPS.
Also note that iterative solving is not recommended for eigenmode analysis. Therefore either only use one CPU core or install the MUMPS module to Elmer.

Buckling Analysis

To perform a buckling analysis, you need to do the same as for an Eigenmode Analysis, and additionally:

  • Set DataStability Analysis: to true

Results

The available results depend on the solver settings. If none of them was set to true, only the displacement is calculated. Otherwise also the corresponding results will be available. If DataEigen Analysis was set to true all results will be available for every calculated eigenmode.

If DataEigen Analysis was set to true, the eigenfrequencies are output at the end of the solver log in the solver dialog and also in the document SolverElmerOutput that will be created in the tree view after the solver has finished.

Note: The eigenmode displacement vector has an arbitrary value since the result is

whereas is the eigenvector and is a complex number.