Package: conforce
ReadmeConForce is a Python package and Abaqus plug-in for the computation of configurational (material) forces.
The computation is automatically generated and compiled from symbolic calculations into C code.
A C binding allows access to the C functions from Python.
This makes ConForce fast enough to compute an entire finite element model
with several thousand elements within a few seconds.ConForce features:the computation of the following quantities for common 2D and 3D elements:static configurational forcesstatic configurational stressesfirst Piola-Kirchhoff stressesdeformation gradientstwo formulations for the configurational stresses and forces:motion based formulation (Eshebly's formulation)displacement based formulationmaterial models:non-linear elasticity in the large strain frameworksmall-strain plasticitymaterial orientations: The stresses and displacements are automatically rotated to the global coordinate system.Supported Operating Systems:Windows (64-bit)CentOS (64-bit)other Linux distributions might workConForce is available as:Python 3 packageAbaqus plug-inPython 3 PackageThe Python package requires Python 3 and contains:methods to compute configurational forces, stresses, ...methods for the symbolic computation and code generationInstallationPyPiWe recommend to install the latest stable version from PyPi.pipinstallconforceRemote RepositoryThe (unstable) development version of ConForce can be installed
from our remote repository.Download and unzip theConForce repository.Open a shell in the unzipped folder where thesetup.pyfile is located.Install ConForce by typing the following commands into the shellpipinstall"."In order to run examples or build the documentation,
additional packages are required.
The following options are available.Install requirements for the examples:pipinstall".[examples]"Install requirements to build the documentationpipinstall".[doc]"Install all requirementspipinstall".[examples, doc]"To uninstall the package, type:pipuninstallconforceIf git is available, the package can be installed directly from the remote repository bypipinstall"conforce[examples, doc] @ git+https://github.com/mrettl/conforce"The extrasexamplesanddocare optional.UsageConfigurational forces are computed using thecf_cmodule.
The energy densitye, the undeformed positionsX,
the displacementU, and the symmetric Cauchy stress tensorSare passed to thecompute_CFfunction along with the element type and the computation method.fromconforceimportcf_ccf_c.compute_CF(e_at_int_points=[[10.]],X_at_nodes=[[[0.,0.],[1.,0.],[1.,1.],[0.,1.],]],U_at_nodes=[[[0.0,0.0],[0.1,0.0],[0.1,0.0],[0.0,0.0],]],S_at_int_points=[[[[100.,0.0],[0.0,0.0]]]],element_type="CPE4R",method="dbf")This yields the configurational forces at the element nodes for a single CPE4R element
and the displacement based formulation ("dbf"):array([[[ 0., -5.],
        [ 0., -5.],
        [ 0.,  5.],
        [-0.,  5.]]])Abaqus plug-inThe Abaqus plug-in contains:methods to compute configurational forces, stresses, ...Abaqus specific code to read and write to *.odb filesa GUI for the Abaqus plug-inSupported Abaqus versions:>= Abaqus 2017InstallationOpenhttps://github.com/mrettl/conforce/releasesand download the latest zip file calledconforce_plugin_{version}.zip.
The zip file has the following structure:conforce_plugin_{version}.zipconforceconforce_abq_plugin.py...There are several possibilities in which folder the plug-in files can be stored.
Decide for one of the following validplugin-folders:plugin_central_dir: This folder is defined in the environment fileabaqus_v6.env.
For many installations this folder is located inC:\\SIMULIA\\CAE\\plugins\\{year}.
Plug-ins stored in this folder are accessible for all users.current_dir\abaqus_plugins: This is the folder in which Abaqus is started.
Plug-ins are only accessible if Abaqus is stared again in the same folder.Next, unzip the downloaded files and put them in theplugin-folderyou selected:
The folder tree should look like:plugin-folderconforceconforce_abq_plugin.py...Start Abaqus and navigate in the toolbar toPlug-ins -> Conf. Force.
The GUI of the plug-in should open.
If no toolbar entry calledConf. Forceexists, check if the plug-in is stored in the right folder
for the Abaqus version you are using.UsageOpen an *.odb file in Abaqus.
Navigate in the toolbar toPlug-ins -> Conf. Force.
The plug-in gui opens:Click Apply to compute the requested field outputs.Report Bugs, Ask questionsUse thegithub issue trackerto report
bugs and troubles or to ask questions.
If you like our tool, please leave a star on our Github repository.