0d4f02c4c9
- Conductive uniform plane support ('G' statement in FastHenry), including holes
- Support for Node equivalence ('-equiv' statement in FastHenry)
- FreeCAD save support for the models created in the workbench
- Updated copyright including Efficient Power Conversion Corp. Inc.
433 lines
21 KiB
Python
433 lines
21 KiB
Python
#***************************************************************************
|
|
#* *
|
|
#* Copyright (c) 2018 *
|
|
#* Efficient Power Conversion Corporation, Inc. http://epc-co.com *
|
|
#* *
|
|
#* Developed by FastFieldSolvers S.R.L. under contract by EPC *
|
|
#* http://www.fastfieldsolvers.com *
|
|
#* *
|
|
#* This program is free software; you can redistribute it and/or modify *
|
|
#* it under the terms of the GNU Lesser General Public License (LGPL) *
|
|
#* as published by the Free Software Foundation; either version 2 of *
|
|
#* the License, or (at your option) any later version. *
|
|
#* for detail see the LICENCE text file. *
|
|
#* *
|
|
#* This program is distributed in the hope that it will be useful, *
|
|
#* but WITHOUT ANY WARRANTY; without even the implied warranty of *
|
|
#* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the *
|
|
#* GNU Library General Public License for more details. *
|
|
#* *
|
|
#* You should have received a copy of the GNU Library General Public *
|
|
#* License along with this program; if not, write to the Free Software *
|
|
#* Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 *
|
|
#* USA *
|
|
#* *
|
|
#***************************************************************************
|
|
|
|
|
|
__title__="FreeCAD E.M. Workbench FastHenry Segment Class"
|
|
__author__ = "FastFieldSolvers S.R.L."
|
|
__url__ = "http://www.fastfieldsolvers.com"
|
|
|
|
# defines
|
|
#
|
|
EMFHSEGMENT_DEF_SEGWIDTH = 0.2
|
|
EMFHSEGMENT_DEF_SEGHEIGHT = 0.2
|
|
# tolerance in degrees when verifying if vectors are parallel
|
|
EMFHSEGMENT_PARTOL = 0.01
|
|
# tolerance in length
|
|
EMFHSEGMENT_LENTOL = 1e-12
|
|
|
|
import FreeCAD, FreeCADGui, Mesh, Part, MeshPart, Draft, DraftGeomUtils, os
|
|
import EM
|
|
from FreeCAD import Vector
|
|
|
|
if FreeCAD.GuiUp:
|
|
import FreeCADGui
|
|
from PySide import QtCore, QtGui
|
|
from DraftTools import translate
|
|
from PySide.QtCore import QT_TRANSLATE_NOOP
|
|
else:
|
|
# \cond
|
|
def translate(ctxt,txt, utf8_decode=False):
|
|
return txt
|
|
def QT_TRANSLATE_NOOP(ctxt,txt):
|
|
return txt
|
|
# \endcond
|
|
|
|
__dir__ = os.path.dirname(__file__)
|
|
iconPath = os.path.join( __dir__, 'Resources' )
|
|
|
|
def makeFHSegment(baseobj=None,nodeStart=None,nodeEnd=None,name='FHSegment'):
|
|
'''Creates a FastHenry segment ('E' statement in FastHenry)
|
|
|
|
'baseobj' is the line object on which the node is based.
|
|
If no 'baseobj' is given, the user must assign a base
|
|
object later on, to be able to use this object.
|
|
|
|
Example:
|
|
TBD
|
|
'''
|
|
obj = FreeCAD.ActiveDocument.addObject("Part::FeaturePython", name)
|
|
obj.Label = translate("EM", name)
|
|
# this adds the relevant properties to the object
|
|
#'obj' (e.g. 'Base' property) making it a _FHSegment
|
|
_FHSegment(obj)
|
|
# manage ViewProvider object
|
|
if FreeCAD.GuiUp:
|
|
_ViewProviderFHSegment(obj.ViewObject)
|
|
# set base ViewObject properties to user-selected values (if any)
|
|
# check if 'nodeStart' is a FHNode, and if so, assign it as segment start node
|
|
if nodeStart:
|
|
if Draft.getType(nodeStart) == "FHNode":
|
|
obj.NodeStart = nodeStart
|
|
# check if 'nodeEnd' is a FHNode, and if so, assign it as segment end node
|
|
if nodeEnd:
|
|
if Draft.getType(nodeEnd) == "FHNode":
|
|
obj.NodeEnd = nodeEnd
|
|
# check if 'baseobj' is a wire (only base object allowed), and only if not passed any node
|
|
if baseobj and not obj.NodeStart and not obj.NodeEnd:
|
|
if Draft.getType(baseobj) == "Wire":
|
|
if len(baseobj.Shape.Vertexes) == 2:
|
|
obj.Base = baseobj
|
|
obj.NodeStart = EM.makeFHNode(X=obj.Base.Start.x, Y=obj.Base.Start.y, Z=obj.Base.Start.z)
|
|
obj.NodeEnd = EM.makeFHNode(X=obj.Base.End.x, Y=obj.Base.End.y, Z=obj.Base.End.z)
|
|
else:
|
|
FreeCAD.Console.PrintWarning(translate("EM","FHSegments can only be based on Line objects (not multi-segment wires)"))
|
|
else:
|
|
FreeCAD.Console.PrintWarning(translate("EM","FHSegments can only be based on Line objects"))
|
|
# hide the base object
|
|
if obj.Base and FreeCAD.GuiUp:
|
|
obj.Base.ViewObject.hide()
|
|
# return the newly created Python object
|
|
return obj
|
|
|
|
class _FHSegment:
|
|
'''The EM FastHenry Segment object'''
|
|
def __init__(self, obj):
|
|
''' Add properties '''
|
|
obj.addProperty("App::PropertyLink", "Base", "EM", QT_TRANSLATE_NOOP("App::Property","The base object this component is built upon"))
|
|
obj.addProperty("App::PropertyLink","NodeStart","EM",QT_TRANSLATE_NOOP("App::Property","Starting FHNode"))
|
|
obj.addProperty("App::PropertyLink","NodeEnd","EM",QT_TRANSLATE_NOOP("App::Property","Ending FHNode"))
|
|
obj.addProperty("App::PropertyLength","Width","EM",QT_TRANSLATE_NOOP("App::Property","Segment width ('w' segment parameter)"))
|
|
obj.addProperty("App::PropertyLength","Height","EM",QT_TRANSLATE_NOOP("App::Property","Segment height ('h' segment parameter)"))
|
|
obj.addProperty("App::PropertyFloat","Sigma","EM",QT_TRANSLATE_NOOP("App::Property","Segment conductivity ('sigma' segment parameter)"))
|
|
obj.addProperty("App::PropertyVector","ww","EM",QT_TRANSLATE_NOOP("App::Property","Segment cross-section direction along width ('wx', 'wy', 'wz' segment parameter)"))
|
|
obj.addProperty("App::PropertyInteger","nhinc","EM",QT_TRANSLATE_NOOP("App::Property","Number of filaments in the height direction ('nhinc' segment parameter)"))
|
|
obj.addProperty("App::PropertyInteger","nwinc","EM",QT_TRANSLATE_NOOP("App::Property","Number of filaments in the width direction ('nwinc' segment parameter)"))
|
|
obj.addProperty("App::PropertyInteger","rh","EM",QT_TRANSLATE_NOOP("App::Property","Ratio of adjacent filaments in the height direction ('rh' segment parameter)"))
|
|
obj.addProperty("App::PropertyInteger","rw","EM",QT_TRANSLATE_NOOP("App::Property","Ratio of adjacent filaments in the width direction ('rw' segment parameter)"))
|
|
obj.Proxy = self
|
|
self.Type = "FHSegment"
|
|
# save the object in the class, to store or retrieve specific data from it
|
|
# from within the class
|
|
self.Object = obj
|
|
|
|
def execute(self, obj):
|
|
''' this method is mandatory. It is called on Document.recompute()
|
|
'''
|
|
if obj.NodeStart == None:
|
|
return
|
|
elif Draft.getType(obj.NodeStart) <> "FHNode":
|
|
FreeCAD.Console.PrintWarning(translate("EM","NodeStart is not a FHNode"))
|
|
return
|
|
if obj.NodeEnd == None:
|
|
return
|
|
elif Draft.getType(obj.NodeEnd) <> "FHNode":
|
|
FreeCAD.Console.PrintWarning(translate("EM","NodeEnd is not a FHNode"))
|
|
return
|
|
# check if we have a 'Base' object; if so, if segment end nodes
|
|
# were already defined, re-set them according to the 'Base' object;
|
|
# this means that the user cannot move freely the end nodes, if
|
|
# there is a base object
|
|
if obj.Base:
|
|
# if right type of base
|
|
if obj.Base.isDerivedFrom("Part::Feature"):
|
|
# check validity
|
|
if obj.Base.Shape.isNull():
|
|
return
|
|
if not obj.Base.Shape.isValid():
|
|
return
|
|
# ok, it's valid. Let's verify if this is a Wire.
|
|
if Draft.getType(obj.Base) == "Wire":
|
|
# set the FHSegment Placement to the same placement of the Base object
|
|
# (FHSegment will track the Base object, if present)
|
|
#obj.Placement = obj.Base.Placement
|
|
obj.Placement = FreeCAD.Placement()
|
|
if obj.NodeStart <> None:
|
|
abs_pos = obj.NodeStart.Proxy.getAbsCoord()
|
|
# 'obj.Base.Start' is an absolute position
|
|
# if 'NodeStart' is not in that position, move it
|
|
if (abs_pos-obj.Base.Start).Length > EMFHSEGMENT_LENTOL:
|
|
obj.NodeStart.Proxy.setAbsCoord(obj.Base.Start)
|
|
if obj.NodeEnd <> None:
|
|
abs_pos = obj.NodeEnd.Proxy.getAbsCoord()
|
|
# 'obj.Base.Start' is an absolute position
|
|
# if 'NodeStart' is not in that position, move it
|
|
if (abs_pos-obj.Base.End).Length > EMFHSEGMENT_LENTOL:
|
|
obj.NodeEnd.Proxy.setAbsCoord(obj.Base.End)
|
|
if obj.Width == None or obj.Width <= 0:
|
|
obj.Width = EMFHSEGMENT_DEF_SEGWIDTH
|
|
if obj.Height == None or obj.Height <= 0:
|
|
obj.Height = EMFHSEGMENT_DEF_SEGHEIGHT
|
|
# and finally, if everything is ok, make and assing the shape
|
|
self.assignShape(obj)
|
|
|
|
def assignShape(self, obj):
|
|
''' Compute and assign the shape to the object 'obj' '''
|
|
n1 = obj.NodeStart.Proxy.getAbsCoord()
|
|
n2 = obj.NodeEnd.Proxy.getAbsCoord()
|
|
shape = self.makeSegShape(n1,n2,obj.Width,obj.Height,obj.ww)
|
|
# shape may be None, e.g. if endpoints coincide. Do not assign in this case
|
|
if shape:
|
|
obj.Shape = shape
|
|
|
|
def makeSegShape(self,n1,n2,width,height,ww):
|
|
''' Compute a segment shape given:
|
|
|
|
'n1': start node position (Vector)
|
|
'n2': end node position (Vector)
|
|
'width': segment width
|
|
'height': segment height
|
|
'ww': cross-section direction (along width)
|
|
'''
|
|
# do not accept coincident nodes
|
|
if (n2-n1).Length < EMFHSEGMENT_LENTOL:
|
|
return None
|
|
# vector along length
|
|
wl = n2-n1;
|
|
# calculate the vector along the height
|
|
wh = (ww.cross(wl))
|
|
# if cross-section is not defined, by default the width vector
|
|
# is assumed to lie in x-y plane perpendicular to the length.
|
|
# If the length direction is parallel to the z-axis, then
|
|
# the width is assumed along the x-axis.
|
|
# The same is done if 'ww' has been defined parallel to 'wl'
|
|
if ww.Length < EMFHSEGMENT_LENTOL or wh.Length < EMFHSEGMENT_LENTOL:
|
|
# if length parallel to the z-axis
|
|
if wl.getAngle(Vector(0,0,1))*FreeCAD.Units.Radian < EMFHSEGMENT_PARTOL:
|
|
ww = Vector(1,0,0)
|
|
else:
|
|
ww = (wl.cross(Vector(0,0,1))).normalize()
|
|
# and re-calculate 'wh' since we changed 'ww'
|
|
wh = (ww.cross(wl))
|
|
# normalize the freshly calculated 'wh'
|
|
wh.normalize()
|
|
# copy ww as the multiply() method changes the vector on which is called
|
|
wwHalf = Vector(ww)
|
|
# must normalize. We don't want to touch 'ww', as this is user's defined
|
|
wwHalf.normalize()
|
|
wwHalf.multiply(width / 2)
|
|
# copy wh as the multiply() method changes the vector on which is called
|
|
whHalf = Vector(wh)
|
|
whHalf.multiply(height / 2)
|
|
# calculate the vertexes
|
|
v11 = n1 - wwHalf - whHalf
|
|
v12 = n1 + wwHalf - whHalf
|
|
v13 = n1 + wwHalf + whHalf
|
|
v14 = n1 - wwHalf + whHalf
|
|
v21 = n2 - wwHalf - whHalf
|
|
v22 = n2 + wwHalf - whHalf
|
|
v23 = n2 + wwHalf + whHalf
|
|
v24 = n2 - wwHalf + whHalf
|
|
# now make faces
|
|
# front
|
|
poly = Part.makePolygon( [v11,v12,v13,v14,v11])
|
|
face1 = Part.Face(poly)
|
|
# back
|
|
poly = Part.makePolygon( [v21,v24,v23,v22,v21])
|
|
face2 = Part.Face(poly)
|
|
# left
|
|
poly = Part.makePolygon( [v11,v14,v24,v21,v11])
|
|
face3 = Part.Face(poly)
|
|
# right
|
|
poly = Part.makePolygon( [v12,v22,v23,v13,v12])
|
|
face4 = Part.Face(poly)
|
|
# top
|
|
poly = Part.makePolygon( [v14,v13,v23,v24,v14])
|
|
face5 = Part.Face(poly)
|
|
# bottom
|
|
poly = Part.makePolygon( [v11,v21,v22,v12,v11])
|
|
face6 = Part.Face(poly)
|
|
# create a shell. Does not need to be solid.
|
|
segShell = Part.makeShell([face1,face2,face3,face4,face5,face6])
|
|
return segShell
|
|
|
|
def onChanged(self, obj, prop):
|
|
''' take action if an object property 'prop' changed
|
|
'''
|
|
#FreeCAD.Console.PrintWarning("\n_FHSegment onChanged(" + str(prop)+")\n") #debug
|
|
if not hasattr(self,"Object"):
|
|
# on restore, self.Object is not there anymore (JSON does not serialize complex objects
|
|
# members of the class, so __getstate__() and __setstate__() skip them);
|
|
# so we must "re-attach" (re-create) the 'self.Object'
|
|
self.Object = obj
|
|
|
|
def serialize(self,fid):
|
|
''' Serialize the object to the 'fid' file descriptor
|
|
'''
|
|
fid.write("E" + self.Object.Label + " N" + self.Object.NodeStart.Label + " N" + self.Object.NodeEnd.Label)
|
|
fid.write(" w=" + str(self.Object.Width.Value) + " h=" + str(self.Object.Height.Value))
|
|
if self.Object.Sigma > 0:
|
|
fid.write(" sigma=" + str(self.Object.Sigma))
|
|
if self.Object.ww.Length >= EMFHSEGMENT_LENTOL:
|
|
fid.write(" wx=" + str(self.Object.ww.x) + " wy=" + str(self.Object.ww.y) + " wz=" + str(self.Object.ww.z))
|
|
if self.Object.nhinc > 0:
|
|
fid.write(" nhinc=" + str(self.Object.nhinc))
|
|
if self.Object.nwinc > 0:
|
|
fid.write(" nwinc=" + str(self.Object.nwinc))
|
|
if self.Object.rh > 0:
|
|
fid.write(" rh=" + str(self.Object.rh))
|
|
if self.Object.rw > 0:
|
|
fid.write(" rw=" + str(self.Object.rw))
|
|
fid.write("\n")
|
|
|
|
def __getstate__(self):
|
|
return self.Type
|
|
|
|
def __setstate__(self,state):
|
|
if state:
|
|
self.Type = state
|
|
|
|
class _ViewProviderFHSegment:
|
|
def __init__(self, obj):
|
|
''' Set this object to the proxy object of the actual view provider '''
|
|
obj.Proxy = self
|
|
self.Object = obj.Object
|
|
|
|
def attach(self, obj):
|
|
''' Setup the scene sub-graph of the view provider, this method is mandatory '''
|
|
# on restore, self.Object is not there anymore (JSON does not serialize complex objects
|
|
# members of the class, so __getstate__() and __setstate__() skip them);
|
|
# so we must "re-attach" (re-create) the 'self.Object'
|
|
self.Object = obj.Object
|
|
return
|
|
|
|
def updateData(self, fp, prop):
|
|
''' Print the name of the property that has changed '''
|
|
#FreeCAD.Console.PrintMessage("ViewProvider updateData(), property: " + str(prop) + "\n")
|
|
''' If a property of the handled feature has changed we have the chance to handle this here '''
|
|
return
|
|
|
|
def getDefaultDisplayMode(self):
|
|
''' Return the name of the default display mode. It must be defined in getDisplayModes. '''
|
|
return "Flat Lines"
|
|
|
|
def onChanged(self, vp, prop):
|
|
''' Print the name of the property that has changed '''
|
|
#FreeCAD.Console.PrintMessage("ViewProvider onChanged(), property: " + str(prop) + "\n")
|
|
|
|
def claimChildren(self):
|
|
''' Used to place other objects as childrens in the tree'''
|
|
c = []
|
|
if hasattr(self,"Object"):
|
|
if hasattr(self.Object,"Base"):
|
|
c.append(self.Object.Base)
|
|
if hasattr(self.Object,"NodeStart"):
|
|
c.append(self.Object.NodeStart)
|
|
if hasattr(self.Object,"NodeEnd"):
|
|
c.append(self.Object.NodeEnd)
|
|
return c
|
|
|
|
def getIcon(self):
|
|
''' Return the icon in XMP format which will appear in the tree view. This method is optional
|
|
and if not defined a default icon is shown.
|
|
'''
|
|
return os.path.join(iconPath, 'segment_icon.svg')
|
|
|
|
def __getstate__(self):
|
|
return None
|
|
|
|
def __setstate__(self,state):
|
|
return None
|
|
|
|
class _CommandFHSegment:
|
|
''' The EM FastHenry Segment (FHSegment) command definition
|
|
'''
|
|
def GetResources(self):
|
|
return {'Pixmap' : os.path.join(iconPath, 'segment_icon.svg') ,
|
|
'MenuText': QT_TRANSLATE_NOOP("EM_FHSegment","FHSegment"),
|
|
'Accel': "E, S",
|
|
'ToolTip': QT_TRANSLATE_NOOP("EM_FHSegment","Creates a FastHenry Segment object from scratch, from a selected base object (wire), or from two FHNodes")}
|
|
|
|
def IsActive(self):
|
|
return not FreeCAD.ActiveDocument is None
|
|
|
|
def Activated(self):
|
|
# init properties (future)
|
|
#self.Length = None
|
|
# preferences
|
|
#p = FreeCAD.ParamGet("User parameter:BaseApp/Preferences/Mod/EM")
|
|
#self.Width = p.GetFloat("Width",200)
|
|
# get the selected object(s)
|
|
selection = FreeCADGui.Selection.getSelectionEx()
|
|
done = False
|
|
startNode = None
|
|
endNode = None
|
|
# if selection is not empty
|
|
for selobj in selection:
|
|
# automatic mode
|
|
if Draft.getType(selobj.Object) == "Wire":
|
|
FreeCAD.ActiveDocument.openTransaction(translate("EM","Create FHSegment"))
|
|
FreeCADGui.addModule("EM")
|
|
FreeCADGui.doCommand('obj=EM.makeFHSegment(FreeCAD.ActiveDocument.'+selobj.Object.Name+')')
|
|
# autogrouping, for later on
|
|
#FreeCADGui.addModule("Draft")
|
|
#FreeCADGui.doCommand("Draft.autogroup(obj)")
|
|
FreeCAD.ActiveDocument.commitTransaction()
|
|
FreeCAD.ActiveDocument.recompute()
|
|
done = True
|
|
if Draft.getType(selobj.Object) == "FHNode":
|
|
if startNode == None:
|
|
startNode = selobj.Object
|
|
elif endNode == None:
|
|
endNode = selobj.Object
|
|
else:
|
|
FreeCAD.Console.PrintWarning(translate("EM","More than two FHNodes selected when creating a FHSegment. Using only the first two."))
|
|
if startNode <> None and endNode <> None:
|
|
FreeCAD.ActiveDocument.openTransaction(translate("EM","Create FHSegment"))
|
|
FreeCADGui.addModule("EM")
|
|
FreeCADGui.doCommand('obj=EM.makeFHSegment(nodeStart=FreeCAD.ActiveDocument.'+startNode.Name+',nodeEnd=FreeCAD.ActiveDocument.'+endNode.Name+')')
|
|
# autogrouping, for later on
|
|
#FreeCADGui.addModule("Draft")
|
|
#FreeCADGui.doCommand("Draft.autogroup(obj)")
|
|
FreeCAD.ActiveDocument.commitTransaction()
|
|
FreeCAD.ActiveDocument.recompute()
|
|
done = True
|
|
# if no selection, or nothing good in the selected objects
|
|
if not done:
|
|
#FreeCAD.DraftWorkingPlane.setup()
|
|
# get two 3D point via Snapper, setting the callback functions
|
|
self.points = []
|
|
FreeCADGui.Snapper.getPoint(callback=self.getPoint)
|
|
|
|
def getPoint(self,point=None,obj=None):
|
|
"this function is called by the snapper when it has a 3D point"
|
|
if point == None:
|
|
return
|
|
self.points.append(point)
|
|
if len(self.points) == 1:
|
|
# get the second point
|
|
FreeCADGui.Snapper.getPoint(last=self.points[0],callback=self.getPoint)
|
|
elif len(self.points) >= 2:
|
|
#coord1 = FreeCAD.DraftWorkingPlane.getLocalCoords(self.points[0])
|
|
#coord2 = FreeCAD.DraftWorkingPlane.getLocalCoords(self.points[1])
|
|
coord1 = self.points[0]
|
|
coord2 = self.points[1]
|
|
FreeCAD.ActiveDocument.openTransaction(translate("EM","Create FHNode"))
|
|
FreeCADGui.addModule("EM")
|
|
FreeCADGui.doCommand('import Draft')
|
|
FreeCADGui.doCommand('from FreeCAD import Vector')
|
|
FreeCADGui.doCommand('node1 = EM.makeFHNode(X='+str(coord1.x)+',Y='+str(coord1.y)+',Z='+str(coord1.z)+')')
|
|
FreeCADGui.doCommand('node2 = EM.makeFHNode(X='+str(coord2.x)+',Y='+str(coord2.y)+',Z='+str(coord2.z)+')')
|
|
FreeCADGui.doCommand('obj=EM.makeFHSegment(nodeStart=node1,nodeEnd=node2)')
|
|
FreeCAD.ActiveDocument.commitTransaction()
|
|
FreeCAD.ActiveDocument.recompute()
|
|
# might improve in the future with continue command
|
|
#if self.continueCmd:
|
|
# self.Activated()
|
|
|
|
if FreeCAD.GuiUp:
|
|
FreeCADGui.addCommand('EM_FHSegment',_CommandFHSegment())
|
|
|