topologicpy 0.7.15__py3-none-any.whl → 0.7.18__py3-none-any.whl

topologicpy/Shell.py

@@ -331,6 +331,52 @@ class Shell():
         _ = cluster.Faces(None, faces)
         return Shell.ByFaces(faces, tolerance=tolerance)
 
+
+    @staticmethod
+    def ByThickenedWire(wire, offsetA: float = 1.0, offsetB: float = 1.0, tolerance: float = 0.0001):
+        """
+        Creates a shell by thickening the input wire. This method assumes the wire is manifold and planar.
+
+        Parameters
+        ----------
+        wire : topologic_core.Wire
+            The input wire to be thickened.
+        offsetA : float , optional
+            The desired offset to the exterior of the wire. The default is 1.0.
+        offsetB : float , optional
+            The desired offset to the interior of the wire. The default is 1.0.
+        tolerance : float , optional
+            The desired tolerance. The default is 0.0001.
+
+        Returns
+        -------
+        topologic_core.Cell
+            The created cell.
+
+        """
+        from topologicpy.Edge import Edge
+        from topologicpy.Wire import Wire
+        from topologicpy.Face import Face
+        from topologicpy.Topology import Topology
+
+        if not Topology.IsInstance(wire, "Wire"):
+            print("Shell.ByThickenedWire - Error: The input wire parameter is not a valid wire. Returning None.")
+            return None
+        
+        f = Face.ByThickenedWire(wire, offsetA=offsetA, offsetB=offsetB, tolerance=tolerance)
+        outside_wire = Wire.ByOffset(wire, offset=abs(offsetA)*-1, bisectors = False, tolerance=tolerance)
+        inside_wire = Wire.ByOffset(wire, offset=abs(offsetB), bisectors = False, tolerance=tolerance)
+        border = Topology.Merge(outside_wire, inside_wire)
+        outside_wire = Wire.ByOffset(wire, offset=abs(offsetA)*-1, bisectors = True, tolerance=tolerance)
+        inside_wire = Wire.ByOffset(wire, offset=abs(offsetB), bisectors = True, tolerance=tolerance)
+        grid = Topology.Merge(outside_wire, inside_wire)
+        bisectors = Topology.Difference(grid, border)
+        return_shell = Topology.Slice(f, bisectors)
+        if not Topology.IsInstance(return_shell, "Shell"):
+            print("Shell.ByThickenedWire - Error: The operation failed. Returning None.")
+            return None
+        return return_shell
+
     @staticmethod
     def ByWires(wires: list, triangulate: bool = True, tolerance: float = 0.0001, silent: bool = False):
         """
@@ -708,23 +754,23 @@ class Shell():
         Parameters
         ----------
         origin : topologic_core.Vertex , optional
-            The origin of the hyperbolic parabolid. If set to None, it will be placed at the (0, 0, 0) origin. The default is None.
+            The origin of the hyperbolic paraboloid. If set to None, it will be placed at the (0, 0, 0) origin. The default is None.
         llVertex : topologic_core.Vertex , optional
-            The lower left corner of the hyperbolic parabolid. If set to None, it will be set to (-0.5, -0.5, -0.5).
+            The lower left corner of the hyperbolic paraboloid. If set to None, it will be set to (-0.5, -0.5, -0.5).
         lrVertex : topologic_core.Vertex , optional
-            The lower right corner of the hyperbolic parabolid. If set to None, it will be set to (0.5, -0.5, 0.5).
+            The lower right corner of the hyperbolic paraboloid. If set to None, it will be set to (0.5, -0.5, 0.5).
         ulVertex : topologic_core.Vertex , optional
-            The upper left corner of the hyperbolic parabolid. If set to None, it will be set to (-0.5, 0.5, 0.5).
+            The upper left corner of the hyperbolic paraboloid. If set to None, it will be set to (-0.5, 0.5, 0.5).
         urVertex : topologic_core.Vertex , optional
-            The upper right corner of the hyperbolic parabolid. If set to None, it will be set to (0.5, 0.5, -0.5).
+            The upper right corner of the hyperbolic paraboloid. If set to None, it will be set to (0.5, 0.5, -0.5).
         uSides : int , optional
             The number of segments along the X axis. The default is 10.
         vSides : int , optional
             The number of segments along the Y axis. The default is 10.
         direction : list , optional
-            The vector representing the up direction of the hyperbolic parabolid. The default is [0, 0, 1].
+            The vector representing the up direction of the hyperbolic paraboloid. The default is [0, 0, 1].
         placement : str , optional
-            The description of the placement of the origin of the hyperbolic parabolid. This can be "center", "lowerleft", "bottom". It is case insensitive. The default is "center".
+            The description of the placement of the origin of the hyperbolic paraboloid. This can be "center", "lowerleft", "bottom". It is case insensitive. The default is "center".
         mantissa : int , optional
             The desired length of the mantissa. The default is 6.
         tolerance : float , optional
@@ -827,7 +873,7 @@ class Shell():
         Returns
         -------
         topologic_core.Shell
-            The created hyperboloic paraboloid.
+            The created hyperbolic paraboloid.
 
         """
         from topologicpy.Vertex import Vertex
@@ -1287,7 +1333,7 @@ class Shell():
             The desired angle in degrees of the roof. The default is 45.
         epsilon : float , optional
             The desired epsilon (another form of tolerance for distance from plane). The default is 0.01. (This is set to a larger number as it was found to work better)
-        manitssa : int , optional
+        mantissa : int , optional
             The desired length of the mantissa. The default is 6.
         tolerance : float , optional
             The desired tolerance. The default is 0.001. (This is set to a larger number as it was found to work better)
@@ -1495,7 +1541,7 @@ class Shell():
     @staticmethod
     def Simplify(shell, simplifyBoundary: bool = True, mantissa: int = 6, tolerance: float = 0.0001):
         """
-            Simplifies the input shell edges based on the Douglas Peucker algorthim. See https://en.wikipedia.org/wiki/Ramer%E2%80%93Douglas%E2%80%93Peucker_algorithm
+            Simplifies the input shell edges based on the Douglas Peucker algorithm. See https://en.wikipedia.org/wiki/Ramer%E2%80%93Douglas%E2%80%93Peucker_algorithm
             Part of this code was contributed by gaoxipeng. See https://github.com/wassimj/topologicpy/issues/35
 
         Parameters
@@ -1765,7 +1811,7 @@ class Shell():
                 for v in tempWire:
                     if len(temp_verts) == 0:
                         temp_verts.append(v)
-                    elif Vertex.Index(v, temp_verts) == None:
+                    elif Vertex.Index(v, temp_verts, tolerance=tolerance) == None:
                         temp_verts.append(v)
                 tempWire = temp_verts
                 temp_w = Wire.ByVertices(tempWire, close=True)

topologicpy/Topology.py

@@ -200,7 +200,7 @@ class Topology():
     @staticmethod
     def AddApertures(topology, apertures, exclusive=False, subTopologyType=None, tolerance=0.001):
         """
-        Adds the input list of apertures to the input topology or to its subtpologies based on the input subTopologyType.
+        Adds the input list of apertures to the input topology or to its subtopologies based on the input subTopologyType.
 
         Parameters
         ----------
@@ -350,7 +350,7 @@ class Topology():
     @staticmethod
     def AdjacentTopologies(topology, hostTopology, topologyType=None):
         """
-        Returns the topologies, as specified by the input topology type, adjacent to the input topology witin the input host topology.
+        Returns the topologies, as specified by the input topology type, adjacent to the input topology within the input host topology.
 
         Parameters
         ----------
@@ -1402,7 +1402,7 @@ class Topology():
         faces : list , optional
             The input list of faces in the form of [i, j, k, l, ...] where the items in the list are vertex indices. The face is assumed to be closed to the last vertex is connected to the first vertex automatically.
         color : list , optional
-            The desired color of the object in the form of [r, g, b, a] where the components are between 0 and 1 and represent red, blue, green, and alpha (transparency) repsectively. The default is [1.0, 1.0, 1.0, 1.0].
+            The desired color of the object in the form of [r, g, b, a] where the components are between 0 and 1 and represent red, blue, green, and alpha (transparency) respectively. The default is [1.0, 1.0, 1.0, 1.0].
         id : str , optional
             The desired ID of the object. If set to None, an automatic uuid4 will be assigned to the object. The default is None.
         name : str , optional
@@ -1410,7 +1410,7 @@ class Topology():
         lengthUnit : str , optional
             The length unit used for the object. The default is "METERS"
         outputMode : str , optional
-            The desired otuput mode of the object. This can be "wire", "shell", "cell", "cellcomplex", or "default". It is case insensitive. The default is "default".
+            The desired output mode of the object. This can be "wire", "shell", "cell", "cellcomplex", or "default". It is case insensitive. The default is "default".
         tolerance : float , optional
             The desired tolerance. The default is 0.0001.
 
@@ -1571,7 +1571,7 @@ class Topology():
         path : str
             The input file path.
         overwrite : bool , optional
-            If set to True the ouptut file will overwrite any pre-existing file. Otherwise, it won't. The default is False.
+            If set to True the output file will overwrite any pre-existing file. Otherwise, it won't. The default is False.
         version : str , optional
             The desired version number for the BIM file. The default is "1.0.0".
         guidKey : str , optional
@@ -1635,7 +1635,7 @@ class Topology():
         path : str
             The input file path.
         overwrite : bool , optional
-            If set to True the ouptut file will overwrite any pre-existing file. Otherwise, it won't. The default is False.
+            If set to True the output file will overwrite any pre-existing file. Otherwise, it won't. The default is False.
         version : str , optional
             The desired version number for the BIM file. The default is "1.0.0".
         guidKey : str , optional
@@ -1731,7 +1731,7 @@ class Topology():
         path : str
             The input file path.
         overwrite : bool , optional
-            If set to True the ouptut file will overwrite any pre-existing file. Otherwise, it won't. The default is False.
+            If set to True the output file will overwrite any pre-existing file. Otherwise, it won't. The default is False.
         version : str , optional
             The desired version number for the BIM file. The default is "1.0.0".
         guidKey : str , optional
@@ -2041,7 +2041,7 @@ class Topology():
         file : file object
             The input IFC file.
         transferDictionaries : bool , optional
-            If set to True, the dictionaries from the IFC file will be transfered to the topology. Otherwise, they won't. The default is False.
+            If set to True, the dictionaries from the IFC file will be transferred to the topology. Otherwise, they won't. The default is False.
         includeTypes : list , optional
             The list of IFC object types to include. It is case insensitive. If set to an empty list, all types are included. The default is [].
         excludeTypes : list , optional
@@ -2134,7 +2134,7 @@ class Topology():
         path : str
             The path to the IFC file.
         transferDictionaries : bool , optional
-            If set to True, the dictionaries from the IFC file will be transfered to the topology. Otherwise, they won't. The default is False.
+            If set to True, the dictionaries from the IFC file will be transferred to the topology. Otherwise, they won't. The default is False.
         includeTypes : list , optional
             The list of IFC object types to include. It is case insensitive. If set to an empty list, all types are included. The default is [].
         excludeTypes : list , optional
@@ -2708,7 +2708,7 @@ class Topology():
     @staticmethod
     def ByOBJString(string, transposeAxes = True, progressBar=False, tolerance=0.0001):
         """
-        Creates a topology from the input Waverfront OBJ string. This is a very experimental method and only works with simple planar solids. Materials and Colors are ignored.
+        Creates a topology from the input Wavefront OBJ string. This is a very experimental method and only works with simple planar solids. Materials and Colors are ignored.
 
         Parameters
         ----------
@@ -2783,7 +2783,7 @@ class Topology():
     @staticmethod
     def ByOBJFile(file, transposeAxes=True, progressBar=False, tolerance=0.0001):
         """
-        Imports the topology from a Weverfront OBJ file. This is a very experimental method and only works with simple planar solids. Materials and Colors are ignored.
+        Imports the topology from a Wevefront OBJ file. This is a very experimental method and only works with simple planar solids. Materials and Colors are ignored.
 
         Parameters
         ----------
@@ -2813,7 +2813,7 @@ class Topology():
     @staticmethod
     def ByOBJPath(path, transposeAxes=True, progressBar=False, tolerance=0.0001):
         """
-        Imports the topology from a Weverfront OBJ file path. This is a very experimental method and only works with simple planar solids. Materials and Colors are ignored.
+        Imports the topology from a Wevefront OBJ file path. This is a very experimental method and only works with simple planar solids. Materials and Colors are ignored.
 
         Parameters
         ----------
@@ -3236,7 +3236,7 @@ class Topology():
         _ = topology.Faces(None, faces)
         normals = []
         for aFace in faces:
-            normals.append(Face.NormalAtParameters(aFace, 0.5, 0.5, "XYZ", 3))
+            normals.append(Face.Normal(aFace, outputType="XYZ", mantissa=3))
         # build a matrix of similarity
         mat = buildSimilarityMatrix(normals, angTolerance)
         categories = categorizeIntoClusters(mat)
@@ -4799,17 +4799,6 @@ class Topology():
                 _ = topology.CellComplexes(None, topologies)
             return topologies
 
-        def triangulateFace(face):
-            faceTriangles = []
-            for i in range(0, 5, 1):
-                try:
-                    _ = topologic.FaceUtility.Triangulate(face, float(i)*0.1, faceTriangles)
-                    return faceTriangles
-                except:
-                    continue
-            faceTriangles.append(face)
-            return faceTriangles
-
         vertices = []
         edges = []
         faces = []
@@ -4858,14 +4847,10 @@ class Topology():
             ib = []
             _ = aFace.InternalBoundaries(ib)
             if(len(ib) > 0):
-                triFaces = triangulateFace(aFace)
+                triFaces = Face.Triangulate(aFace)
                 for aTriFace in triFaces:
-                    wire = aTriFace.ExternalBoundary()
+                    wire = Face.ExternalBoundary(aTriFace)
                     faceVertices = getSubTopologies(wire, topologic.Vertex)
-                    temp_face = Face.ByWire(wire)
-                    temp_dir = Face.Normal(temp_face)
-                    if Vector.IsAntiParallel(f_dir, temp_dir):
-                        faceVertices.reverse()
                     f = []
                     for aVertex in faceVertices:
                         try:
@@ -4876,13 +4861,8 @@ class Topology():
                         f.append(fVertexIndex)
                     faces.append(f)
             else:
-                wire =  aFace.ExternalBoundary()
-                #wire = topologic.WireUtility.RemoveCollinearEdges(wire, 0.1) #This is an angle Tolerance
+                wire =  Face.ExternalBoundary(aFace)
                 faceVertices = getSubTopologies(wire, topologic.Vertex)
-                temp_face = Face.ByWire(wire)
-                temp_dir = Face.Normal(temp_face)
-                if Vector.IsAntiParallel(f_dir, temp_dir):
-                    faceVertices.reverse()
                 f = []
                 for aVertex in faceVertices:
                     try:
@@ -5540,7 +5520,7 @@ class Topology():
                 #final_faces.append(Face.RemoveCollinearEdges(t))
                 final_faces.append(t)
             elif Topology.IsInstance(t, "Shell"):
-                    f = Face.ByShell(t)
+                    f = Face.ByShell(t, silent=True)
                     if Topology.IsInstance(f, "Face"):
                         final_faces.append(f)
                     else:

topologicpy/Vector.py

@@ -133,7 +133,7 @@ class Vector(list):
     def AzimuthAltitude(vector, mantissa: int = 6):
         """
         Returns a dictionary of azimuth and altitude angles in degrees for the input vector. North is assumed to be the positive Y axis [0, 1, 0]. Up is assumed to be the positive Z axis [0, 0, 1].
-        Azimuth is calculated in a counter-clockwise fashion from North where 0 is North, 90 is East, 180 is South, and 270 is West. Altitude is calculated in a counter-clockwise fashing where -90 is straight down (negative Z axis), 0 is in the XY plane, and 90 is straight up (positive Z axis).
+        Azimuth is calculated in a counter-clockwise fashion from North where 0 is North, 90 is East, 180 is South, and 270 is West. Altitude is calculated in a counter-clockwise fashion where -90 is straight down (negative Z axis), 0 is in the XY plane, and 90 is straight up (positive Z axis).
         If the altitude is -90 or 90, the azimuth is assumed to be 0.
 
         Parameters
@@ -196,7 +196,6 @@ class Vector(list):
         # Normalize input vectors
         vector1_norm = vector1 / np.linalg.norm(vector1)
         vector2_norm = vector2 / np.linalg.norm(vector2)
-        
         # Check if the angle between vectors is either 0 or 180 degrees
         dot_product = np.dot(vector1_norm, vector2_norm)
         if np.isclose(dot_product, 1.0) or np.isclose(dot_product, -1.0):
@@ -207,7 +206,6 @@ class Vector(list):
         else:
             # Compute bisecting vector
             bisecting_vector = (vector1_norm + vector2_norm) / np.linalg.norm(vector1_norm + vector2_norm)
-    
         return list(bisecting_vector)
     
     @staticmethod

topologicpy/Vertex.py

@@ -1057,10 +1057,8 @@ class Vertex():
         import inspect
 
         if not Topology.IsInstance(vertex, "Vertex"):
+            print("Called from:", inspect.stack()[1][3])
             if not silent:
-                stack = inspect.stack()
-                if len(stack) > 2:
-                    print(stack[2].function)
                 print("Vertex.IsInternal - Error: The input vertex parameter is not a valid vertex. Returning None.", vertex, topology)
             return None
         if not Topology.IsInstance(topology, "Topology"):
@@ -1074,7 +1072,7 @@ class Vertex():
             try:
                 parameter = Edge.ParameterAtVertex(topology, vertex)
             except:
-                parameter = 400 #aribtrary large number greater than 1
+                parameter = 400 #arbitrary large number greater than 1
             if parameter == None:
                 return False
             return 0 <= parameter <= 1