EM FHPlane

Description
The FHPlane tool inserts a FastHenry uniform conductive plane object.



How to use
The FHPlane object must be based on another object, that can be either a Draft Rectangle or a Part Box object. In case you based your FHPlane on a Part Box object, the Thickness parameter will be inherited from the Box Height value.


 * 1) Create and select a Draft Rectangle or a Part Box object
 * 2) Press the  button, or press  then  keys.

In addition, you can also select together with the base object (the Draft Rectangle or the Part Box) also one or more EM FHNode and / or one or more EM FHPlaneHole objects, that will be adopted by the FHPlane:


 * 1) Create a Draft Rectangle or a Part Box object
 * 2) Create one or more EM FHNode objects
 * 3) Create one or more EM FHPlaneHole objects
 * 4) Select the base object, the FHNode objects and the FHPlaneHole objects (for this multiple selection, you can point and click the objects in the tree or in the 3D view, and to perform a multiple selection just keep the  key pressed while selecting).
 * 5) Press the  button, or press  then  keys.

Remarks:

 * As the FHPlane object is based on a Draft Rectangle or Part Box object, you can NOT freely move the FHPlane. The FHPlane will always be constrained to the base object. To change the position of the FHPlane, apply the change to the underlying base object (the base object is hidden by default, you can show it again by selecting the object in the tree and pressing . The origin of the FHPlane is the origin of the base object.


 * When the FHNode objects are adopted by the FHPlane, their (X, Y, Z) coordinates will be made relative to the FHPlane origin (so while the FHNode will retain the same position in space, the relative coordinates (X, Y, Z) of the FHNode will be modified to be relative to the FHPlane origin). Also, once adopted, the Z coordinate of the FHNode will be reset to zero (as the coordinates are relative to the FHPlane, the Z coordinate is the height of the object from the plane). For this reason, the node will be visible only from the bottom of the FHPlane, or changing the transparency of the FHPlane to see the FHNodes through, or hiding the FHPlane altogether. Moreover, to show that the FHNode now belongs to the FHPlane, the color of the FHNode is changed.


 * When the FHPlaneHole objects are adopted by the FHPlane, their (X, Y, Z) coordinates will be made relative to the FHPlane origin (so while the FHPlaneHole will retain the same position in space, the relative coordinates (X, Y, Z) of the FHPlaneHole will be modified to be relative to the FHPlane origin). Also, once adopted, the Z coordinate of the FHPlaneHole will be reset to zero (as the coordinates are relative to the FHPlane, the Z coordinate is the height of the object from the plane). For this reason, the node will be visible only from the bottom of the FHPlane, or changing the transparency of the FHPlane to see the FHNodes through, or hiding the FHPlane altogether. Moreover, to show that the FHNode now belongs to the FHPlane, the color of the FHNode is changed.

Options

 * To enter coordinates manually, simply enter the numbers, then press between each X, Y and Z component. You can press the  button when you have the desired values to insert the point.
 * Press or the  button to abort the current command.

Properties

 * : The base object this component is built upon (a Draft Line)
 * : the starting FHNode
 * : the ending FHNode
 * : the FHSegment width ('w' segment parameter in FastHenry)
 * : the FHSegment height ('h' segment parameter in FastHenry)
 * : the FHSegment conductivity ('sigma' segment parameter in FastHenry)
 * : the FHSegment cross-section direction along the width ('wx', 'wy', 'wz' segment parameter in FastHenry)
 * : the Number of filaments in the height direction ('nhinc' segment parameter in FastHenry)
 * : the Number of filaments in the width direction ('nwinc' segment parameter in FastHenry)
 * : the ratio of adjacent filaments in the height direction ('rh' segment parameter in FastHenry)
 * : the ratio of adjacent filaments in the width direction ('rw' segment parameter in FastHenry)

Scripting
FreeCAD Scripting Basics.

The FHNode object can be used in macros and from the Python console by using the following function:


 * Creates a object.
 * is the Draft Line object that can be used as base for the FHSegment. If and  are specified, they have priority over the, and  is ignored.
 * is the segment starting node FHNode object.
 * is the segment ending node FHNode object.
 * is the segment width. Defaults to.
 * is the segment height. Defaults to.
 * is the name of the object

Example: