FEM Example Capacitance Two Balls/en

Introduction
This example is meant to show how to simulate the 6th example of Elmer GUI Tutorials, Electrostatic equation – Capacitance of two balls, using the new FEM Examples. It illustrates how to setup the example, study it's various parts, solve it using the Elmer Solver and visualize the results using Clip Filter.



Requirements

 * A compatible version of FreeCAD designated in the tutorial overview.
 * Use the to see the version of FreeCAD installed
 * No external software is needed for loading the example, viewing the mesh and geometry as well as for visualizing the results.
 * For solving the finite element analysis (FEA), the solver software Elmer must be installed on your computer. See this page for how to install Elmer.

Load FEM Workbench

 * Start FreeCAD, the Start Workbench should be loaded
 * Switch to [[Image:Workbench_FEM.svg|32px]] FEM workbench.

Load the example

 * Go to.
 * When the GUI opens, find and open "Electrostatics Capacitance Two Balls". You can easily find the example in or in . For opening the example, either double click on it or select it and click.



Understanding the Simulation Case
This case presents the solution of the capacitance of perfectly conducting balls in free space. A voltage difference between the balls results to electric charge being introduced to the system. The balls have also self-capacitance that comes from the voltage difference with the far field. Therefore a symmetric capacitance matrix with of size 2 × 2 needs to be solved. The capacitances may be computed from two different voltage configurations.

Understanding the Model

 * The model contains three spheres.
 * 1) The two smaller ones are the perfectly conducting balls.
 * 2) The bigger one is to simulate the surrounding air.
 * The two smaller spheres are fused together and then that fusion is is cut from the bigger sphere.



Analysis container and its objects
The objects used in this electrostatic analysis:
 * 1) [[Image:FEM_Analysis.svg|24px]] Analysis container
 * 2) [[Image:FEM_SolverElmer.svg|24px]] SolverElmer
 * 3) [[Image:FEM_EquationElectrostatic.svg|24px]] Electrostatic, the electrostatics equation
 * 4) [[Image:FEM_MaterialFluid.svg|24px]] FemMaterial, a fluid material to represent the surrounding air
 * 5) [[Image:FEM_ConstraintElectrostaticPotential.svg|24px]] ElectrostaticPotential, constraints (3 of them)
 * 6) [[Image:FEM_ConstantVacuumPermittivity.svg|24px]] ConstantVaccumPermittivity, optional
 * 7) [[Image:FEM_MeshGmshFromShape.svg|24px]] Mesh, a Gmsh mesh
 * 8) [[Image:FEM_MeshRegion.svg|24px]] MeshRegion, a mesh region for the smaller spheres



Running the FEA

 * In Tree view double click on the solver object [[Image:FEM_SolverElmer.svg|24px]].
 * Click on file in the same task panel. Watch the log window until it prints "write completed." You can ignore the warning about the vacuum permittivity that might appear.
 * Click on . Since this is a small analysis it should take a few seconds to run so wait till you see "ELMER SOLVER FINISHED AT" in the output.
 * Click on in the task panel after the run is finished.
 * Two new result objects should be created in the tree view, [[Image:FEM_PostPipelineFromResult.svg|24px]] SolverElmerResult and [[Image:TextDocument.svg|24px]] SolverElmerOutput.

If you get an error message on solver binary or similar when triggering the analysis, check the installation of Elmer.

Visualizing Results

 * Make sure the mesh is invisible. If not, select the [[Image:FEM_MeshGmshFromShape.svg|24px]] Mesh object and press to toggle the visibility.
 * Also make sure the Cut object is invisible.
 * Double click on the [[Image:FEM_PostPipelineFromResult.svg|24px]] SolverElmerResult object to ope its task dialog.
 * Change the "Field" to "potential" and press.
 * You will notice that the color of the sphere has changed to blue and that the gradient on the right is showing values from 0 to 1. It should look something like this:



Post Processing the Result

 * While we have successfully visualised the potential result, currently we are only seeing the zero potential in the air surrounding the two balls. To view the potential on the balls we need to apply a clip filter.
 * In the tree view select the [[Image:FEM_PostPipelineFromResult.svg|24px]] SolverElmerResult object and then from the tool bar click on the button.
 * This will open a dialog with the filter configurations. Click there on the button and choose [[Image:FEM_PostCreateFunctionPlane.svg|24px]] Plane. This adds a plane through the center of the sphere at which the result mesh is cut. To smooth the cut face, check the option Cut Cells. Eventually click.




 * In the tree view there is a new entry called Functions. It contains the created [[Image:FEM_PostCreateFunctionPlane.svg|24px]] Plane. Make it invisible using.
 * Double-click on the [[Image:FEM_PostFilterClipRegion.svg|24px]] Clip object in the tree view.
 * Change the "Field" to "potential" and press.
 * Toggle the visibility of the [[Image:FEM_PostPipelineFromResult.svg|24px]] SolverElmerResult object using and you should see something like this:



Now we can clearly see that potential distribution in and around the balls.

Note that when Apply Changes is on, you would have been able to select the "Field" in the clip dialog directly and not to reopen it after the plane was created.

Finding the Capacitance

 * Our actual focus is to find the capacitance which is contained in the [[Image:TextDocument.svg|24px]] SolverElmerOutput.
 * Double click on [[Image:TextDocument.svg|32px]] SolverElmerOutput to open it. Scroll down till you find:

StatElecSolve: Capacitance matrix computation performed (i,j,C_ij) StatElecSolve:  1  1    5.07016E+00 StatElecSolve:  1  2    1.69328E+00 StatElecSolve:  2  2    5.07201E+00


 * Here, our desired result is . This value is close to the  given in the Elmer GUI Tutorials. We can get an even closer value by making a finer Mesh Region but this activity is left for the user. Also, the user is advised to play with the Clip Filter to get a visual result similar to the first picture of this tutorial.