FEM SolverCalculixCxxtools: Difference between revisions

From FreeCAD Documentation
No edit summary
(Marked this version for translation)
Line 5: Line 5:
==Description== <!--T:4-->
==Description== <!--T:4-->


<!--T:11-->
CalculiXccxTools enable to use [http://dhondt.de/ CalculiX] solver. You can use it to
CalculiXccxTools enable to use [http://dhondt.de/ CalculiX] solver. You can use it to
# set analysis parameters
# set analysis parameters
Line 12: Line 13:
==How to use== <!--T:5-->
==How to use== <!--T:5-->


<!--T:12-->
# {{KEY|[[Image:FEM_Solver.png|24px]] CalculiXccxTools}} object is created automatically with creation of {{KEY|[[Image:FEM_Analysis.png|24px]] [[FEM_Analysis|Analysis container]]}}. Otherwise use {{KEY|Solve}} → {{KEY|Solver CalculiX Standard}} , or press {{KEY|S}} then {{KEY|X}} keys
# {{KEY|[[Image:FEM_Solver.png|24px]] CalculiXccxTools}} object is created automatically with creation of {{KEY|[[Image:FEM_Analysis.png|24px]] [[FEM_Analysis|Analysis container]]}}. Otherwise use {{KEY|Solve}} → {{KEY|Solver CalculiX Standard}} , or press {{KEY|S}} then {{KEY|X}} keys
# Optionally set data properties of the {{KEY|[[Image:FEM_Solver.png|24px]] CalculiXccxTools}} object
# Optionally set data properties of the {{KEY|[[Image:FEM_Solver.png|24px]] CalculiXccxTools}} object
Line 21: Line 23:
==Options== <!--T:6-->
==Options== <!--T:6-->


<!--T:13-->
By using {{KEY|Edit .inp file}} you can display and edit CalculiX input file manually before running analysis. In this case it might be useful to use parameter "Split Input Writer = true".
By using {{KEY|Edit .inp file}} you can display and edit CalculiX input file manually before running analysis. In this case it might be useful to use parameter "Split Input Writer = true".


==Properties== <!--T:7-->
==Properties== <!--T:7-->


<!--T:14-->
Default values can be set in the menu {{KEY|Edit}} → {{KEY|Preferences}} → {{KEY|FEM}} → {{KEY|CalculiX}}
Default values can be set in the menu {{KEY|Edit}} → {{KEY|Preferences}} → {{KEY|FEM}} → {{KEY|CalculiX}}


<!--T:15-->
* {{PropertyData|Analysis Type}}:
* {{PropertyData|Analysis Type}}:
** static
** static
Line 32: Line 37:
** thermomech - for mechanical and thermal loads
** thermomech - for mechanical and thermal loads


<!--T:16-->
* {{PropertyData|Beam Shell Result Output 3D}}: note that CalculiX internally expands 1D and 2D elements into 3D elements to accomplish FE analysis
* {{PropertyData|Beam Shell Result Output 3D}}: note that CalculiX internally expands 1D and 2D elements into 3D elements to accomplish FE analysis
** false - results of 1D and 2D elements will be averaged to the nodes of original 1D or 2D mesh (i.e. purely bended beam will show 0 nodal stresses due to averaging)
** false - results of 1D and 2D elements will be averaged to the nodes of original 1D or 2D mesh (i.e. purely bended beam will show 0 nodal stresses due to averaging)
** true - resulting mesh will contain 1D and 2D elements expanded to 3D elements
** true - resulting mesh will contain 1D and 2D elements expanded to 3D elements


<!--T:17-->
* {{PropertyData|Eigenmode High Limit}}: Eigenvalues above this limit will not be calculated
* {{PropertyData|Eigenmode High Limit}}: Eigenvalues above this limit will not be calculated


<!--T:18-->
* {{PropertyData|Eigenmode Low Limit}}: Eigenvalues below this limit will not be calculated
* {{PropertyData|Eigenmode Low Limit}}: Eigenvalues below this limit will not be calculated


<!--T:19-->
* {{PropertyData|Eigenmodes Count}}: number of lowest eigenmodes to be calculated
* {{PropertyData|Eigenmodes Count}}: number of lowest eigenmodes to be calculated


<!--T:20-->
* {{PropertyData|Geometric Nonlinearity}}:
* {{PropertyData|Geometric Nonlinearity}}:
** linear - linear analysis will be performed if model does not contain nonlinear material
** linear - linear analysis will be performed if model does not contain nonlinear material
** nonlinear - nonlinear analysis will be performed
** nonlinear - nonlinear analysis will be performed


<!--T:21-->
* {{PropertyData|Iterations Control parameter Cutb}}: defines second line of advanced iteration parameters under *CONTROLS card, used when "Iterations Control Parameter Time Use" is true
* {{PropertyData|Iterations Control parameter Cutb}}: defines second line of advanced iteration parameters under *CONTROLS card, used when "Iterations Control Parameter Time Use" is true


<!--T:22-->
* {{PropertyData|Iterations Control Parameter Iter}}: defines first line of advanced iteration parameters under *CONTROLS card, used when "Iterations Control Parameter Time Use" is true
* {{PropertyData|Iterations Control Parameter Iter}}: defines first line of advanced iteration parameters under *CONTROLS card, used when "Iterations Control Parameter Time Use" is true


<!--T:23-->
* {{PropertyData|Iterations Control Parameter Time Use}}
* {{PropertyData|Iterations Control Parameter Time Use}}
** true - activates "Iterations Control Parameter Cutb" and "Iterations Control Parameter Iter"
** true - activates "Iterations Control Parameter Cutb" and "Iterations Control Parameter Iter"


<!--T:24-->
* {{PropertyData|Iterations Thermo Mech Maximum}}: maximum number of increments in thermomechanical analysis after which the job will be stopped.
* {{PropertyData|Iterations Thermo Mech Maximum}}: maximum number of increments in thermomechanical analysis after which the job will be stopped.


<!--T:25-->
* {{PropertyData|Iterations User Defined Incrementations}}:
* {{PropertyData|Iterations User Defined Incrementations}}:
** true - automatic incrementation control will be switched off by DIRECT parameter
** true - automatic incrementation control will be switched off by DIRECT parameter
** false - incrementation control will be automatic
** false - incrementation control will be automatic


<!--T:26-->
* {{PropertyData|Iterations User Defined Time Step Length}}:
* {{PropertyData|Iterations User Defined Time Step Length}}:
** true - activates "Time End" and "Time Initial Step" parameters
** true - activates "Time End" and "Time Initial Step" parameters


<!--T:27-->
* {{PropertyData|Material Nonlinearity}}:
* {{PropertyData|Material Nonlinearity}}:
** linear - only linear material properties will be included in the analysis
** linear - only linear material properties will be included in the analysis
** nonlinear - nonlinear material properties will be used from {{KEY|[[Image:FEM_MaterialMechanicalNonlinear.png|24px]] '''[[FEM_MaterialMechanicalNonlinear|Nonlinear mechanical material]]'''}} object
** nonlinear - nonlinear material properties will be used from {{KEY|[[Image:FEM_MaterialMechanicalNonlinear.png|24px]] '''[[FEM_MaterialMechanicalNonlinear|Nonlinear mechanical material]]'''}} object


<!--T:28-->
* {{PropertyData|Matrix Solver Type}}: type of the solver to solve equation system inside FE analysis. It may significantly affect calculation speed and memory demands. Suitability depends on your FE model and available hardware
* {{PropertyData|Matrix Solver Type}}: type of the solver to solve equation system inside FE analysis. It may significantly affect calculation speed and memory demands. Suitability depends on your FE model and available hardware
** default - automatically selects matrix solver depending on available solvers (probably it will be Spooles)
** default - automatically selects matrix solver depending on available solvers (probably it will be Spooles)
Line 72: Line 90:
** iterativecholesky - iterative solver with preconditioning with and with low memory demands, suitable if model contains mostly 3D elements
** iterativecholesky - iterative solver with preconditioning with and with low memory demands, suitable if model contains mostly 3D elements


<!--T:29-->
* {{PropertyData|Split Input Writer}}:
* {{PropertyData|Split Input Writer}}:
** false - write whole input into one *.inp file to be used by CalculiX solver
** false - write whole input into one *.inp file to be used by CalculiX solver
** true - split solver inputs into more *.inp files, that can clarify hand editing
** true - split solver inputs into more *.inp files, that can clarify hand editing


<!--T:30-->
* {{PropertyData|Thermo Mechanical Steady State}}:
* {{PropertyData|Thermo Mechanical Steady State}}:
** true - steady state thermo mechanical analysis
** true - steady state thermo mechanical analysis
** false - transient thermo mechanical analysis
** false - transient thermo mechanical analysis


<!--T:31-->
* {{PropertyData|Time End}}: time period of the step, used when parameter "Iterations User Defined Incrementations" or "Iterations User Defined Time Step Length" is true
* {{PropertyData|Time End}}: time period of the step, used when parameter "Iterations User Defined Incrementations" or "Iterations User Defined Time Step Length" is true


<!--T:32-->
* {{PropertyData|Time Initial Step}}: initial time increment of the step, used when parameter "Iterations User Defined Incrementations" or "Iterations User Defined Time Step Length" is true
* {{PropertyData|Time Initial Step}}: initial time increment of the step, used when parameter "Iterations User Defined Incrementations" or "Iterations User Defined Time Step Length" is true


<!--T:33-->
* {{PropertyData|Working Dir}}: path to the working directory which will be used for CalculiX analysis files.
* {{PropertyData|Working Dir}}: path to the working directory which will be used for CalculiX analysis files.


Line 90: Line 113:
==Notes== <!--T:9-->
==Notes== <!--T:9-->


<!--T:34-->
Original CalculiX documentation can be found at http://dhondt.de/ in the "ccx" paragraph.
Original CalculiX documentation can be found at http://dhondt.de/ in the "ccx" paragraph.



Revision as of 21:17, 1 April 2018

FEM Solver

Menu location
Solve → Solver CalculiX Standard
Workbenches
FEM
Default shortcut
None
Introduced in version
-
See also
FEM tutorial

Description

CalculiXccxTools enable to use CalculiX solver. You can use it to

  1. set analysis parameters
  2. select working directory
  3. run the CalculiX solver.

How to use

  1. CalculiXccxTools object is created automatically with creation of Analysis container. Otherwise use SolveSolver CalculiX Standard , or press S then X keys
  2. Optionally set data properties of the CalculiXccxTools object
  3. Double click on the CalculiXccxTools object
  4. Select type of the analysis
  5. Click Write .inp file
  6. Click Run CalculiX

Options

By using Edit .inp file you can display and edit CalculiX input file manually before running analysis. In this case it might be useful to use parameter "Split Input Writer = true".

Properties

Default values can be set in the menu EditPreferencesFEMCalculiX

  • DataAnalysis Type:
    • static
    • frequency
    • thermomech - for mechanical and thermal loads
  • DataBeam Shell Result Output 3D: note that CalculiX internally expands 1D and 2D elements into 3D elements to accomplish FE analysis
    • false - results of 1D and 2D elements will be averaged to the nodes of original 1D or 2D mesh (i.e. purely bended beam will show 0 nodal stresses due to averaging)
    • true - resulting mesh will contain 1D and 2D elements expanded to 3D elements
  • DataEigenmode High Limit: Eigenvalues above this limit will not be calculated
  • DataEigenmode Low Limit: Eigenvalues below this limit will not be calculated
  • DataEigenmodes Count: number of lowest eigenmodes to be calculated
  • DataGeometric Nonlinearity:
    • linear - linear analysis will be performed if model does not contain nonlinear material
    • nonlinear - nonlinear analysis will be performed
  • DataIterations Control parameter Cutb: defines second line of advanced iteration parameters under *CONTROLS card, used when "Iterations Control Parameter Time Use" is true
  • DataIterations Control Parameter Iter: defines first line of advanced iteration parameters under *CONTROLS card, used when "Iterations Control Parameter Time Use" is true
  • DataIterations Control Parameter Time Use
    • true - activates "Iterations Control Parameter Cutb" and "Iterations Control Parameter Iter"
  • DataIterations Thermo Mech Maximum: maximum number of increments in thermomechanical analysis after which the job will be stopped.
  • DataIterations User Defined Incrementations:
    • true - automatic incrementation control will be switched off by DIRECT parameter
    • false - incrementation control will be automatic
  • DataIterations User Defined Time Step Length:
    • true - activates "Time End" and "Time Initial Step" parameters
  • DataMaterial Nonlinearity:
    • linear - only linear material properties will be included in the analysis
    • nonlinear - nonlinear material properties will be used from Nonlinear mechanical material object
  • DataMatrix Solver Type: type of the solver to solve equation system inside FE analysis. It may significantly affect calculation speed and memory demands. Suitability depends on your FE model and available hardware
    • default - automatically selects matrix solver depending on available solvers (probably it will be Spooles)
    • spooles - direct solver with support of multiple CPUs. Number of CPUs need to be set in EditPreferencesFEMCalculiX → Solver defaults → Number of CPU's to use)
    • iterativescaling - iterative solver with least memory demands, suitable if model contains mostly 3D elements
    • iterativecholesky - iterative solver with preconditioning with and with low memory demands, suitable if model contains mostly 3D elements
  • DataSplit Input Writer:
    • false - write whole input into one *.inp file to be used by CalculiX solver
    • true - split solver inputs into more *.inp files, that can clarify hand editing
  • DataThermo Mechanical Steady State:
    • true - steady state thermo mechanical analysis
    • false - transient thermo mechanical analysis
  • DataTime End: time period of the step, used when parameter "Iterations User Defined Incrementations" or "Iterations User Defined Time Step Length" is true
  • DataTime Initial Step: initial time increment of the step, used when parameter "Iterations User Defined Incrementations" or "Iterations User Defined Time Step Length" is true
  • DataWorking Dir: path to the working directory which will be used for CalculiX analysis files.

Limitations

Notes

Original CalculiX documentation can be found at http://dhondt.de/ in the "ccx" paragraph.

Scripting