EM FHPlaneHole/en

Description
The FHPlaneHole tool inserts a plane hole object, that represents a FastHenry uniform conductive plane hole.







Usage
The FHPlaneHole object can be based on the position of a Draft Point object, or you can select the 3D location of the FHPlaneHole.


 * 1) Press the  button, or press  then  keys.
 * 2) Click a point on the 3D view, or type coordinates and press the  button.

Alternatively, you can also:


 * 1) Select one or multiple [[Image:Draft_Point.svg|16px]] Draft Point object(s)
 * 2) Press the  button, or press  then  keys. As many FHPlaneHole objects will be created as the Draft Point objects, at the same coordinates of the Draft Points.

Remarks

 * [[Image:EM_FHPlaneHole.svg|16px]] FHPlaneHole objects have no meaning if they are not part of a [[Image:EM_FHPlane.svg|16px]] FHPlane. To adopt a FHPlaneHole within a FHPlane, use the [[Image:EM_FHPlaneAddRemoveNodeHole.svg|16px]] EM FHPlaneAddRemoveNodeHole command, or select the FHPlaneHole at FHPlane creation. To remove a FHPlaneHole from a FHPlane, you can use the EM FHPlaneAddRemoveNodeHole command.


 * FHPlaneHole objects represent FastHenry plane holes, and therefore follow the same rules of the uniform conductive plane holes. In particular, holes are created removing the internal plane nodes from the plane node array, before constructing the segment mesh. You can enable the view of the internal FHPlane nodes by turning the FHPlane property on. Three types of FHPlaneHoles exist, and can be selected by changing the  FHPlaneNode property.
 * 1) Point hole: Removes the single FHPlane internal node closer to the position of the FHPlaneHole. The Point FHPlaneHole is shown as a single vertex (small dot), to help to visualize its position; see the FastHenry Point FHPlaneHole picture above.
 * 2) Rect hole: Removes all the FHPlane internal nodes that are within as well as close to the area defined by the base point of the FHPlaneNode and the   and  properties. This means that not only the internal nodes strictly within the rectangular area defined by the FHPlaneHole are removed, but also the internal nodes outside the rectangle, but within half of the internal node - node distance. The Rect FHPlaneHole is shown as a 2D rectangle, to help to visualize its position and area; see the FastHenry Rect FHPlaneHole picture above.
 * 3) Circle hole: Removes all the FHPlane internal nodes that are within as well as close to the area defined by the base point of the FHPlaneNode and the   property. This means that not only the internal nodes strictly within the circular area defined by the FHPlaneHole are removed, but also the internal nodes outside the circle, but within half of the internal node - node distance. The Circle FHPlaneHole is shown as a 2D circle, to help to visualize its position and area; see the FastHenry Circle FHPlaneHole picture above. Note that if the FHPlane discretization as specified by the  and  FHPlane properties is coarse, the shape of the circular hole can not resemble a circle. This is normal, and it is how FastHenry handles circular holes, not a defect of the ElectroMagnetic Workbench for FastHenry.

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 X coordinate of the FHPlaneHole
 * : the Y coordinate of the FHPlaneHole
 * : the Z coordinate of the FHPlaneHole
 * : the Rectangular hole length (along x from FHPlaneHole base point)
 * : the Rectangular hole width (along y from FHPlaneHole base point)
 * : the Circular hole radius
 * : the type of FastHenry plane hole. Can be "Point", "Rect" or "Circle".

Scripting
FreeCAD Scripting Basics.

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


 * Creates a object.
 * is the Draft Point object whose position can be used as base for the FHPlaneHole. It has priority over, , . If no is given, ,, are used as coordinates.
 * x coordinate of the hole, in absolute coordinate system.
 * y coordinate of the hole, in absolute coordinate system.
 * z coordinate of the hole, in absolute coordinate system.
 * is the type of hole. Allowed values are: "Point", "Rect", "Circle"
 * is the length of the hole (along the x dimension), in case of rectangular "Rect" hole.
 * is the width of the hole (along the y dimension), in case of rectangular "Rect" hole.
 * is the radius of the hole, in case of circular "Circle" hole.
 * is the name of the object

The placement of the FHPlaneHole can be changed by modifying its property, or changing the ,, properties individually. Changing ,, modifies the node position in the relative coordinate system of the.

Additionally, the _FHPlaneHole class exposes these methods. The _FHPlaneHole class can be accessed through the FHPlaneHole object Proxy (e.g. fhhole.Proxy).


 * Get a containing the hole coordinates in the absolute reference system


 * Get a containing the hole coordinates relative to the FHPlaneHole Placement


 * Sets the hole position relative to the placement
 * is a FreeCAD.Vector containing the hole coordinates relative to the FHPlaneHole Placement
 * is a new FHPlaneHole placement. If, the placement is not changed


 * Sets the absolute hole position, considering the object placement, and in case forcing a new placement
 * is a FreeCAD.Vector containing the hole coordinates in the absolute reference system
 * is a new FHPlaneHole placement. If, the placement is not changed

Example: