EM FHPlane: Difference between revisions

From FreeCAD Documentation
(→‎Remarks:: Adding short explanation of FastHenry uniform conductive planes)
No edit summary
 
(14 intermediate revisions by 6 users not shown)
Line 1: Line 1:
<languages/>
<translate>

<!--T:26-->
{{Docnav
|[[EM_FHPath|FHPath]]
|[[EM_FHPlaneHole|FHPlaneHole]]
|[[EM_Workbench|EM]]
|IconL=EM_FHPath.svg
|IconR=EM_FHPlaneHole.svg
|IconC=EMWorkbench.svg
}}

<!--T:1-->
{{GuiCommand
{{GuiCommand
|Name=EM FHPlane
|Name=EM FHPlane
|MenuLocation=EM → FHPlane
|MenuLocation=EM → FHPlane
|Workbenches=[[EM Workbench|EM]]
|Workbenches=[[EM Workbench|EM]]
|Shortcut=E P
|Shortcut={{KEY|E}} {{KEY|P}}
|Version=0.17
|SeeAlso=[[EM_FHNode|EM FHNode]], [[EM_FHPlaneHole|EM FHPlaneHole]], [[EM_FHPlaneAddRemoveNodeHole|EM FHPlaneAddRemoveNodeHole]]
|SeeAlso=[[EM_FHNode|EM FHNode]], [[EM_FHPlaneHole|EM FHPlaneHole]], [[EM_FHPlaneAddRemoveNodeHole|EM FHPlaneAddRemoveNodeHole]]
|Version=0.17 (Add-on)
}}
}}


==Description==
==Description== <!--T:2-->


<!--T:3-->
The FHPlane tool inserts a FastHenry uniform conductive plane object.
The FHPlane tool inserts a FastHenry uniform conductive plane object.


</translate>
[[Image:EM_FHPlane_Example.png]]
[[Image:EM_FHPlane_Example.png]]
<translate>


<!--T:4-->
{{Caption|FastHenry FHPlane}}
{{Caption|FastHenry FHPlane}}


==Usage== <!--T:5-->
==How to use==


<!--T:6-->
The FHPlane object must be based on another object, that can be either a [[Draft_Rectangle|Draft Rectangle]] or a [[Part_Box|Part Box]] object. In case you based your FHPlane on a [[Part_Box|Part Box]] object, the Thickness parameter will be inherited from the Box Height value.
The FHPlane object must be based on another object, that can be either a [[Draft_Rectangle|Draft Rectangle]] or a [[Part_Box|Part Box]] object. In case you based your FHPlane on a [[Part_Box|Part Box]] object, the Thickness parameter will be inherited from the Box Height value.


<!--T:7-->
# Create and select a [[Draft_Rectangle|Draft Rectangle]] or a [[Part_Box|Part Box]] object
# Create and select a [[Image:Draft_Rectangle.svg|16px]] [[Draft_Rectangle|Draft Rectangle]] or a [[Image:Part_Box.svg|16px]] [[Part_Box|Part Box]] object
# Press the {{Button|[[Image:EM_FHPlane.svg|16px]] [[EM_FHPlane|EM FHPlane]]}} button, or press {{KEY|E}} then {{KEY|P}} keys.
# Press the {{Button|[[Image:EM_FHPlane.svg|16px]] [[EM_FHPlane|EM FHPlane]]}} button, or press {{KEY|E}} then {{KEY|P}} keys.


<!--T:8-->
In addition, you can also select together with the base object (the [[Draft_Rectangle|Draft Rectangle]] or the [[Part_Box|Part Box]]) also one or more [[EM_FHNode|EM FHNode]] and / or one or more [[EM_FHPlaneHole|EM FHPlaneHole]] objects, that will be adopted by the FHPlane:
In addition, you can also select together with the base object (the [[Draft_Rectangle|Draft Rectangle]] or the [[Part_Box|Part Box]]) also one or more [[EM_FHNode|EM FHNode]] and / or one or more [[EM_FHPlaneHole|EM FHPlaneHole]] objects, that will be adopted by the FHPlane:


<!--T:9-->
# Create a [[Draft_Rectangle|Draft Rectangle]] or a [[Part_Box|Part Box]] object
# Create a [[Draft_Rectangle|Draft Rectangle]] or a [[Part_Box|Part Box]] object
# Create one or more [[EM_FHNode|EM FHNode]] objects
# Create one or more [[Image:EM_FHNode.svg|16px]] [[EM_FHNode|EM FHNode]] objects
# Create one or more [[EM_FHPlaneHole|EM FHPlaneHole]] objects
# Create one or more [[Image:EM_FHPlaneHole.svg|16px]] [[EM_FHPlaneHole|EM FHPlaneHole]] objects
# 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|CTRL}} key pressed while selecting).
# 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_view|tree view]] or in the [[3D_view|3D view]], and to perform a multiple selection just keep the {{KEY|CTRL}} key pressed while selecting).
# Press the {{Button|[[Image:EM_FHPlane.svg|16px]] [[EM_FHPlane|EM FHPlane]]}} button, or press {{KEY|E}} then {{KEY|P}} keys.
# Press the {{Button|[[Image:EM_FHPlane.svg|16px]] [[EM_FHPlane|EM FHPlane]]}} button, or press {{KEY|E}} then {{KEY|P}} keys.


===Remarks:===
===Remarks:=== <!--T:10-->


<!--T:11-->
A FastHenry uniform conductive plane object is formed by laying down a gird of nodes (hereafter called 'internal nodes') and connecting the nodes with a 2D mesh of segments in the (relative) X and Y directions. Holes are formed in the plane by removing some internal nodes, and hence also the segments that connects to those nodes.
A FastHenry uniform conductive plane object is formed by laying down a gird of nodes (hereafter called 'internal nodes') and connecting the nodes with a 2D mesh of segments in the (relative) X and Y directions. Holes are formed in the plane by removing some internal nodes, and hence also the segments that connects to those nodes.
For more details on FastHenry uniform conductive planes, you should review the [https://www.fastfieldsolvers.com/documentation.htm FastHenry user's guide].
For more details on FastHenry uniform conductive planes, you should review the [https://www.fastfieldsolvers.com/documentation.htm FastHenry user's guide].


<!--T:12-->
* 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 {{KEY|Space}}. The origin of the FHPlane is the origin of the base object.
* 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 {{KEY|Space}}. The origin of the FHPlane is the origin of the base object.


<!--T:13-->
* 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 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.


<!--T:14-->
* 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.
* 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.


<!--T:15-->
* If you want to remove the FHNodes or the FHPlaneHoles from the FHPlane later on, you can use the [[EM_FHPlaneAddRemoveNodeHole|EM FHPlaneAddRemoveNodeHole]] command.
* If you want to remove the FHNodes or the FHPlaneHoles from the FHPlane later on, you can use the [[EM_FHPlaneAddRemoveNodeHole|EM FHPlaneAddRemoveNodeHole]] command.


==Properties==
==Properties== <!--T:16-->


<!--T:17-->
* {{PropertyData|Base}}: The base object this component is built upon (a [[Draft_Rectangle|Draft Rectangle]] or a [[Part_Box|Part Box]])
* {{PropertyData|Base}}: The base object this component is built upon (a [[Draft_Rectangle|Draft Rectangle]] or a [[Part_Box|Part Box]])
* {{PropertyData|Thickness}}: the FHPlane thickness ('thick' plane parameter in FastHenry). If the FHPlane is based on a [[Part_Box|Part Box]], this value is inherited from the Part Box Height parameter
* {{PropertyData|Thickness}}: the FHPlane thickness ('thick' plane parameter in FastHenry). If the FHPlane is based on a [[Part_Box|Part Box]], this value is inherited from the Part Box Height parameter
Line 60: Line 88:
* {{PropertyData|ShowNodes}}: show the internal node grid supporting the plane (i.e. internal nodes)
* {{PropertyData|ShowNodes}}: show the internal node grid supporting the plane (i.e. internal nodes)


==Scripting==
==Scripting== <!--T:18-->


<!--T:19-->
{{Emphasis|See also:}} [[FreeCAD Scripting Basics]].
{{Emphasis|See also:}} [[FreeCAD_Scripting_Basics|FreeCAD Scripting Basics]].


<!--T:20-->
The FHPlane object can be used in [[macros]] and from the [[Python]] console by using the following function:
The FHPlane object can be used in [[Macros|macros]] and from the [[Python|Python]] console by using the following function:


</translate>
{{Code|code=
{{Code|code=
plane = makeFHPlane(baseobj=None, thickness=None, seg1=None, seg2=None, nodes=[], holes=[], name='FHPlane')
plane = makeFHPlane(baseobj=None, thickness=None, seg1=None, seg2=None, nodes=[], holes=[], name='FHPlane')
}}
}}
<translate>


<!--T:21-->
* Creates a {{incode|FHPlane}} object.
* Creates a {{incode|FHPlane}} object.
* {{incode|baseobj}} is the Draft Rectangle object or Part Box object that can be used as base for the FHPlane. If no {{incode|baseobj}} is given, the user must assign a base object later on, to be able to use this object.
* {{incode|baseobj}} is the Draft Rectangle object or Part Box object that can be used as base for the FHPlane. If no {{incode|baseobj}} is given, the user must assign a base object later on, to be able to use this object.
Line 79: Line 112:
* {{incode|name}} is the name of the object
* {{incode|name}} is the name of the object


<!--T:22-->
Example:
Example:


</translate>
{{Code|code=
{{Code|code=
import FreeCAD, Draft, EM
import FreeCAD, Draft, EM
Line 94: Line 129:
hole = EM.makeFHPlaneHole(X=6.0,Y=3.5,Z=0.0)
hole = EM.makeFHPlaneHole(X=6.0,Y=3.5,Z=0.0)


fhplane = makeFHPlane(rect, thickness=1.0, seg1=15, seg2=15, nodes=[fhnode1, fhnode2], holes=[hole])
fhplane = EM.makeFHPlane(rect, thickness=1.0, seg1=15, seg2=15, nodes=[fhnode1, fhnode2], holes=[hole])
}}
<translate>


<!--T:27-->
{{Docnav
|[[EM_FHPath|FHPath]]
|[[EM_FHPlaneHole|FHPlaneHole]]
|[[EM_Workbench|EM]]
|IconL=EM_FHPath.svg
|IconR=EM_FHPlaneHole.svg
|IconC=EMWorkbench.svg
}}
}}


</translate>
{{clear}}
{{EM Tools navi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}

Latest revision as of 12:20, 20 November 2021

Other languages:

EM FHPlane

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

Description

The FHPlane tool inserts a FastHenry uniform conductive plane object.

FastHenry FHPlane

Usage

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 EM FHPlane button, or press E then P 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 view or in the 3D view, and to perform a multiple selection just keep the CTRL key pressed while selecting).
  5. Press the EM FHPlane button, or press E then P keys.

Remarks:

A FastHenry uniform conductive plane object is formed by laying down a gird of nodes (hereafter called 'internal nodes') and connecting the nodes with a 2D mesh of segments in the (relative) X and Y directions. Holes are formed in the plane by removing some internal nodes, and hence also the segments that connects to those nodes. For more details on FastHenry uniform conductive planes, you should review the FastHenry user's guide.

  • 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 Space. 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.

Properties

  • DataBase: The base object this component is built upon (a Draft Rectangle or a Part Box)
  • DataThickness: the FHPlane thickness ('thick' plane parameter in FastHenry). If the FHPlane is based on a Part Box, this value is inherited from the Part Box Height parameter
  • Dataseg1: the Number of segments along the length direction ('seg1' plane parameter in FastHenry)
  • Dataseg2: the Number of segments along the width direction ('seg2' plane parameter in FastHenry)
  • Datanhinc: the Number of filaments the plane thickness ('nhinc' plane parameter in FastHenry)
  • Datarh: the ratio of adjacent filaments along the thickness ('rh' plane parameter in FastHenry)
  • DataSigma: the FHPlane conductivity ('sigma' plane parameter in FastHenry)
  • Datasegwid1: the Width of segments along the plane length direction ('segwid1' plane parameter in FastHenry)
  • Datasegwid2: the Width of segments along the plane width direction ('segwid2' plane parameter in FastHenry)
  • DataNodes: the list of FHNode objects for connections to the plane
  • DataHoles: the list of FHPlaneHoles in the plane
  • DataFineMesh: specifies if this the plane fine mesh is shown (i.e. composing segments)
  • DataShowNodes: show the internal node grid supporting the plane (i.e. internal nodes)

Scripting

See also: FreeCAD Scripting Basics.

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

plane = makeFHPlane(baseobj=None, thickness=None, seg1=None, seg2=None, nodes=[], holes=[], name='FHPlane')
  • Creates a FHPlane object.
  • baseobj is the Draft Rectangle object or Part Box object that can be used as base for the FHPlane. If no baseobj is given, the user must assign a base object later on, to be able to use this object.
  • thickness is the plane thickness. If the baseobj is a Part Box, this parameter is ignored, and the Part Box height is used instead. Defaults to EMFHPLANE_DEF_THICKNESS.
  • seg1 is an integer defining the number of segments along the x dimension of the plane ('seg1' parameter in FastHenry)
  • seg2 is an integer defining the number of segments along the y dimension of the plane ('seg2' parameter in FastHenry)
  • nodes is an array of FHNode objects, specifying the nodes that will be adopted by the plane.
  • holes is an array of FHPlaneHole objects, specifying the holes that will be adopted by the plane.
  • name is the name of the object

Example:

import FreeCAD, Draft, EM

pl = FreeCAD.Placement()
pl.Rotation.Q = (0.0,0.0,0.0,1.0)
pl.Base = FreeCAD.Vector(1.0,1.0,0.0)
rec = Draft.makeRectangle(length=10.0,height=5.0,placement=pl,face=True,support=None)

fhnode1 = EM.makeFHNode(X=1.0,Y=3.5,Z=0)
fhnode2 = EM.makeFHNode(X=8.0,Y=3.5,Z=0)

hole = EM.makeFHPlaneHole(X=6.0,Y=3.5,Z=0.0)

fhplane = EM.makeFHPlane(rect, thickness=1.0, seg1=15, seg2=15, nodes=[fhnode1, fhnode2], holes=[hole])