EM FHPlaneHole

Other languages:
FHPlane
FHPlaneAddRemoveNodeHole
EM

EM FHPlaneHole

Menu location
EM → FHPlaneHole
Workbenches
EM
Default shortcut
E H
Introduced in version
0.17
See also
EM FHPlane, EM FHNode, EM FHPlaneAddRemoveNodeHole

Description

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

FastHenry Point FHPlaneHole

FastHenry Rectangle FHPlaneHole

FastHenry Circle FHPlaneHole

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 EM FHPlaneHole button, or press E then H keys.
  2. Click a point on the 3D view, or type coordinates and press the add point button.

Alternatively, you can also:

  1. Select one or multiple Draft Point object(s)
  2. Press the EM FHPlaneHole button, or press E then H keys. As many FHPlaneHole objects will be created as the Draft Point objects, at the same coordinates of the Draft Points.

Remarks

  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 DataLength and DataWidth 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 DataRadius 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 Dataseg1 and Dataseg1 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

Properties

Scripting

See also: FreeCAD Scripting Basics.

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

hole = makeFHPlaneHole(baseobj=None, X=0.0, Y=0.0, Z=0.0, holetype=None, length=None, width=None, radius=None, name='FHPlaneHole')

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

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

pos = getAbsCoord()

pos = getRelCoord()

pos = setRelCoord(rel_coord, placement=None)

pos = setAbsCoord(abs_coord, placement=None)

Example: 

import FreeCAD, EM

fhhole = EM.makeFHPlaneHole(X=1.0,Y=1.0,Z=0.0,holetype="Rect",length=1.0,width=2.0)


FHPlane
FHPlaneAddRemoveNodeHole
EM
Electromagnetics
User documentation