create/src/Mod/Fem/femtest/test_information.md

FEM Unit Test Information

With these files one can find information on how to run unit tests for FEM

Specifically

• How to run a specific test class or a test method see file: src/Mod/Test/__init__
• related forum thread

let some test document stay open

• run test method from inside FreeCAD
• in tearDown method do not close the document
• temporary comment out FreeCAD.closeDocument(self.doc_name) and add pass

unit test command to copy

• To run a specific FEM unit test to copy for fast tests :-)
• They can be found in the test_commands_to_copy.md file
• create them by:

from femtest.app.support_utils import get_fem_test_defs
get_fem_test_defs()

Examples from within FreeCAD

Create test command file in temp directory

import Test, femtest.app.test_object
Test.runTestsFromClass(femtest.app.test_object.TestObjectCreate)

All FEM tests

import Test, TestFemApp
Test.runTestsFromModule(TestFemApp)

import Test, TestFemGui
Test.runTestsFromModule(TestFemGui)

module

import Test, femtest.app.test_common
Test.runTestsFromModule(femtest.app.test_common)

class

import Test, femtest.app.test_common
Test.runTestsFromClass(femtest.app.test_common.TestFemCommon)

import Test, femtest.app.test_solver_calculix
Test.runTestsFromClass(femtest.app.test_solver_calculix.TestSolverCalculix)

method

import unittest
thetest = "femtest.app.test_common.TestFemCommon.test_pyimport_all_FEM_modules"
alltest = unittest.TestLoader().loadTestsFromName(thetest)
unittest.TextTestRunner().run(alltest)

examples from shell in build dir:

all FreeCAD tests

./bin/FreeCADCmd --run-test 0
./bin/FreeCAD --run-test 0

all FEM tests

./bin/FreeCADCmd --run-test "TestFemApp"
./bin/FreeCAD --run-test "TestFemApp"

import Fem and FemGui

./bin/FreeCADCmd --run-test "femtest.app.test_femimport"
./bin/FreeCAD --run-test "femtest.app.test_femimport"

module

./bin/FreeCAD --run-test "femtest.app.test_femimport"

class

./bin/FreeCAD --run-test "femtest.app.test_common.TestFemCommon"

method

./bin/FreeCAD --run-test "femtest.app.test_common.TestFemCommon.test_pyimport_all_FEM_modules"

Gui

./bin/FreeCAD --run-test "femtest.gui.test_open.TestObjectOpen"

Open files

From FEM test suite source code

• be careful when updating these files, they contain the original results!
• TODO update files, because some of them have non-existing FEM object classes

doc = FreeCAD.open(FreeCAD.ConfigGet("AppHomePath") + 'Mod/Fem/femtest/data/ccx/cube.FCStd')
doc = FreeCAD.open(FreeCAD.ConfigGet("AppHomePath") + 'Mod/Fem/femtest/data/ccx/cube_frequency.FCStd')
doc = FreeCAD.open(FreeCAD.ConfigGet("AppHomePath") + 'Mod/Fem/femtest/data/ccx/cube_static.FCStd')
doc = FreeCAD.open(FreeCAD.ConfigGet("AppHomePath") + 'Mod/Fem/femtest/data/ccx/Flow1D_thermomech.FCStd')
doc = FreeCAD.open(FreeCAD.ConfigGet("AppHomePath") + 'Mod/Fem/femtest/data/ccx/multimat.FCStd')
doc = FreeCAD.open(FreeCAD.ConfigGet("AppHomePath") + 'Mod/Fem/femtest/data/ccx/spine_thermomech.FCStd')

Generated from test suite

import femtest.utilstest as ut
ut.all_test_files()

doc = ut.cube_frequency()
doc = ut.cube_static()
doc = ut.Flow1D_thermomech()
doc = ut.multimat()
doc = ut.spine_thermomech()

Load std FEM example files

app_home = FreeCAD.ConfigGet("AppHomePath")
doc = FreeCAD.open(app_home + "data/examples/FemCalculixCantilever2D.FCStd")
doc = FreeCAD.open(app_home + "data/examples/FemCalculixCantilever3D.FCStd")
doc = FreeCAD.open(app_home + "data/examples/FemCalculixCantilever3D_newSolver.FCStd")
doc = FreeCAD.open(app_home + "data/examples/Fem.FCStd")
doc = FreeCAD.open(app_home + "data/examples/Fem2.FCStd")

Load all documents files

app_home = FreeCAD.ConfigGet("AppHomePath")
doc = FreeCAD.open(FreeCAD.ConfigGet("AppHomePath") + 'Mod/Fem/femtest/data/open/all_objects_de9b3fb438.FCStd')