topologicpy 0.7.24__py3-none-any.whl → 0.7.27__py3-none-any.whl

topologicpy/Topology.py

@@ -24,6 +24,9 @@ import math
 from collections import namedtuple
 from multiprocessing import Process, Queue
 
+# This is for View3D as not to open new browser windows
+opened_urls = set()
+
 try:
     import numpy as np
     from numpy import arctan, pi, signbit
@@ -968,18 +971,42 @@ class Topology():
         results = []
         if Topology.IsInstance(topologyA, "CellComplex"):
            cellsA = Topology.Cells(topologyA)
+        elif Topology.IsInstance(topologyA, "Cluster"):
+            cellsA = Cluster.FreeTopologies(topologyA)
         else:
             cellsA = [topologyA]
-        for cellA in cellsA:
-            if Topology.IsInstance(topologyB, "CellComplex"):
+        if Topology.IsInstance(topologyB, "CellComplex"):
                 cellsB = Topology.Cells(topologyB)
+        elif Topology.IsInstance(topologyB, "Cluster"):
+            cellsB = Cluster.FreeTopologies(topologyB)
+        else:
+            cellsB = [topologyB]
+        cellsA_2 = []
+        cellsB_2 = []
+        for cellA in cellsA:
+            if Topology.IsInstance(cellA, "CellComplex"):
+                cellsA_2 += Topology.Cells(cellA)
+            elif Topology.IsInstance(cellA, "Shell"):
+                cellsA_2 += Topology.Faces(cellA)
+            else:
+                cellsA_2.append(cellA)
+            
+        for cellB in cellsB:
+            if Topology.IsInstance(cellB, "CellComplex"):
+                cellsB_2 += Topology.Cells(cellB)
+            elif Topology.IsInstance(cellB, "Shell"):
+                cellsB_2 += Topology.Faces(cellB)
             else:
-                cellsB = [topologyB]
-            for cellB in cellsB:
+                cellsB_2.append(cellB)
+        
+        for cellA in cellsA_2:
+            for cellB in cellsB_2:
                 cellC = cellA.Intersect(cellB)
                 results.append(cellC)
-        results = [x for x in results if results is not None]
-        if len(results) == 1:
+        results = [x for x in results if x is not None]
+        if len(results) == 0:
+            return None
+        elif len(results) == 1:
             return results[0]
         else:
             return Topology.SelfMerge(Topology.SelfMerge(Cluster.ByTopologies(results)))
@@ -2007,7 +2034,7 @@ class Topology():
         try:
             import ezdxf
         except:
-            print("Topology.ExportToDXF - Information: Installing required ezdxf library.")
+            print("Topology.ByDXFPath - Information: Installing required ezdxf library.")
             try:
                 os.system("pip install ezdxf")
             except:
@@ -4686,7 +4713,7 @@ class Topology():
         return json_string
     
     @staticmethod
-    def OBJString(topology, color, vertexIndex, transposeAxes: bool = True, mode: int = 0, meshSize: float = None, mantissa: int = 6, tolerance: float = 0.0001):
+    def _OBJString(topology, color, vertexIndex, transposeAxes: bool = True, mode: int = 0, meshSize: float = None, mantissa: int = 6, tolerance: float = 0.0001):
         """
         Returns the Wavefront string of the input topology. This is very experimental and outputs a simple solid topology.
 
@@ -4757,6 +4784,7 @@ class Topology():
             finalLines = finalLines + "\n" + lines[i]
         return finalLines, len(vertices)
     
+
     @staticmethod
     def ExportToOBJ(*topologies, path, nameKey="name", colorKey="color", opacityKey="opacity", defaultColor=[256,256,256], defaultOpacity=0.5, transposeAxes: bool = True, mode: int = 0, meshSize: float = None, overwrite: bool = False, mantissa: int = 6, tolerance: float = 0.0001):
         """
@@ -4809,7 +4837,6 @@ class Topology():
 
         """
         from topologicpy.Helper import Helper
-        from topologicpy.Dictionary import Dictionary
         from os.path import exists
 
         if isinstance(topologies, tuple):
@@ -4820,7 +4847,7 @@ class Topology():
             print("Topology.ExportToOBJ - Error: the input topologies parameter does not contain any valid topologies. Returning None.")
             return None
         if not isinstance(new_topologies, list):
-            print("Dictionary.ByMergedDictionaries - Error: The input dictionaries parameter is not a valid list. Returning None.")
+            print("Topology.ExportToOBJ - Error: The input topologies parameter is not a valid list. Returning None.")
             return None
 
         if not overwrite and exists(path):
@@ -4834,39 +4861,126 @@ class Topology():
         status = False
        
         mtl_path = path[:-4] + ".mtl"
-       
+
+        obj_string, mtl_string = Topology.OBJString(new_topologies,
+                                                    nameKey=nameKey,
+                                                    colorKey=colorKey,
+                                                    opacityKey=opacityKey,
+                                                    defaultColor=defaultColor,
+                                                    defaultOpacity=defaultOpacity,
+                                                    transposeAxes=transposeAxes,
+                                                    mode=mode,
+                                                    meshSize=meshSize,
+                                                    mantissa=mantissa,
+                                                    tolerance=tolerance)
         # Write out the material file
-        n = max(len(str(len(topologies))), 3)
         with open(mtl_path, "w") as mtl_file:
-            for i in range(len(new_topologies)):
-                d = Topology.Dictionary(new_topologies[i])
-                name = Dictionary.ValueAtKey(d, nameKey) or "Untitled_"+str(i).zfill(n)
-                color = Dictionary.ValueAtKey(d, colorKey) or defaultColor
-                color = [c/255 for c in color]
-                opacity = Dictionary.ValueAtKey(d, opacityKey) or defaultOpacity
-                mtl_file.write("newmtl color_" + str(i).zfill(n) + "\n")
-                mtl_file.write("Kd " + ' '.join(map(str, color)) + "\n")
-                mtl_file.write("d " + str(opacity) + "\n")
-                
+            mtl_file.write(mtl_string)
         # Write out the obj file
         with open(path, "w") as obj_file:
-            vertex_index = 1  # global vertex index counter
-            obj_file.writelines("# topologicpy "+Helper.Version()+"\n")
-            obj_file.writelines("mtllib " + mtl_path.split('/')[-1])  # reference the MTL file
-            for i in range(len(topologies)):
-                d = Topology.Dictionary(topologies[i])
-                name = Dictionary.ValueAtKey(d, nameKey) or "Untitled_"+str(i).zfill(n)
-                name = name.replace(" ", "_")
-                obj_file.writelines("\ng "+name+"\n")
-                result = Topology.OBJString(topologies[i], "color_" + str(i).zfill(n), vertex_index, transposeAxes=transposeAxes, mode=mode,
-                                meshSize=meshSize,
-                                mantissa=mantissa, tolerance=tolerance)
-                
-                obj_file.writelines(result[0])
-                vertex_index += result[1]
-            obj_file.close()
-            status = True
-        return status
+            obj_file.write(obj_string)
+        return True
+
+    @staticmethod
+    def OBJString(*topologies, nameKey="name", colorKey="color", opacityKey="opacity", defaultColor=[256,256,256], defaultOpacity=0.5, transposeAxes: bool = True, mode: int = 0, meshSize: float = None, mantissa: int = 6, tolerance: float = 0.0001):
+        """
+        Exports the input topology to a Wavefront OBJ file. This is very experimental and outputs a simple solid topology.
+
+        Parameters
+        ----------
+        topologies : list or comma separated topologies
+            The input list of topologies.
+        path : str
+            The input file path.
+        nameKey : str , optional
+            The topology dictionary key under which to find the name of the topology. The default is "name".
+        colorKey : str, optional
+            The topology dictionary key under which to find the color of the topology. The default is "color".
+        opacityKey : str , optional
+            The topology dictionary key under which to find the opacity of the topology. The default is "opacity".
+        defaultColor : list , optional
+            The default color to use if no color is stored in the topology dictionary. The default is [255,255, 255] (white).
+        defaultOpacity : float , optional
+            The default opacity to use of no opacity is stored in the topology dictionary. This must be between 0 and 1. The default is 1 (fully opaque).
+        transposeAxes : bool , optional
+            If set to True the Z and Y coordinates are transposed so that Y points "up"
+        mode : int , optional
+            The desired mode of meshing algorithm (for triangulation). Several options are available:
+            0: Classic
+            1: MeshAdapt
+            3: Initial Mesh Only
+            5: Delaunay
+            6: Frontal-Delaunay
+            7: BAMG
+            8: Fontal-Delaunay for Quads
+            9: Packing of Parallelograms
+            All options other than 0 (Classic) use the gmsh library. See https://gmsh.info/doc/texinfo/gmsh.html#Mesh-options
+            WARNING: The options that use gmsh can be very time consuming and can create very heavy geometry.
+        meshSize : float , optional
+            The desired size of the mesh when using the "mesh" option. If set to None, it will be
+            calculated automatically and set to 10% of the overall size of the face.
+        mantissa : int , optional
+            The desired length of the mantissa. The default is 6.
+        tolerance : float , optional
+            The desired tolerance. The default is 0.0001.
+        overwrite : bool , optional
+            If set to True the ouptut file will overwrite any pre-existing file. Otherwise, it won't. The default is False.
+
+        Returns
+        -------
+        list
+            Return the OBJ and MTL strings as a list.
+
+        """
+        from topologicpy.Helper import Helper
+        from topologicpy.Dictionary import Dictionary
+        import io
+
+        obj_file = io.StringIO()
+        mtl_file = io.StringIO()
+
+        if isinstance(topologies, tuple):
+            topologies = Helper.Flatten(list(topologies))
+        if isinstance(topologies, list):
+            new_topologies = [d for d in topologies if Topology.IsInstance(d, "Topology")]
+        if len(new_topologies) == 0:
+            print("Topology.OBJString - Error: the input topologies parameter does not contain any valid topologies. Returning None.")
+            return None
+        if not isinstance(new_topologies, list):
+            print("Topology.OBJString - Error: The input dictionaries parameter is not a valid list. Returning None.")
+            return None
+       
+        # Write out the material file
+        n = max(len(str(len(topologies))), 3)
+        for i in range(len(new_topologies)):
+            d = Topology.Dictionary(new_topologies[i])
+            name = Dictionary.ValueAtKey(d, nameKey) or "Untitled_"+str(i).zfill(n)
+            color = Dictionary.ValueAtKey(d, colorKey) or defaultColor
+            color = [c/255 for c in color]
+            opacity = Dictionary.ValueAtKey(d, opacityKey) or defaultOpacity
+            mtl_file.write("newmtl color_" + str(i).zfill(n) + "\n")
+            mtl_file.write("Kd " + ' '.join(map(str, color)) + "\n")
+            mtl_file.write("d " + str(opacity) + "\n")
+        
+        vertex_index = 1  # global vertex index counter
+        obj_file.writelines("# topologicpy "+Helper.Version()+"\n")
+        obj_file.writelines("mtllib example.mtl")
+        for i in range(len(topologies)):
+            d = Topology.Dictionary(topologies[i])
+            name = Dictionary.ValueAtKey(d, nameKey) or "Untitled_"+str(i).zfill(n)
+            name = name.replace(" ", "_")
+            obj_file.writelines("\ng "+name+"\n")
+            result = Topology._OBJString(topologies[i], "color_" + str(i).zfill(n), vertex_index, transposeAxes=transposeAxes, mode=mode,
+                            meshSize=meshSize,
+                            mantissa=mantissa, tolerance=tolerance)
+            
+            obj_file.writelines(result[0])
+            vertex_index += result[1]
+        obj_string = obj_file.getvalue()
+        mtl_string = mtl_file.getvalue()
+        obj_file.close()
+        mtl_file.close()
+        return obj_string, mtl_string
 
     @staticmethod
     def Filter(topologies, topologyType="any", searchType="any", key=None, value=None):
@@ -6409,7 +6523,7 @@ class Topology():
         return return_topology
 
     @staticmethod
-    def SetDictionary(topology, dictionary):
+    def SetDictionary(topology, dictionary, silent=False):
         """
         Sets the input topology's dictionary to the input dictionary
 
@@ -6419,6 +6533,8 @@ class Topology():
             The input topology.
         dictionary : topologic_core.Dictionary
             The input dictionary.
+        silent : bool , optional
+            If set to True, no error and warning messages are printed. Otherwise, they are. The default is False.
 
         Returns
         -------
@@ -6429,15 +6545,18 @@ class Topology():
         from topologicpy.Dictionary import Dictionary
 
         if not Topology.IsInstance(topology, "Topology") and not Topology.IsInstance(topology, "Graph"):
-            print("Topology.SetDictionary - Error: the input topology parameter is not a valid topology or graph. Returning None.")
+            if not silent:
+                print("Topology.SetDictionary - Error: the input topology parameter is not a valid topology or graph. Returning None.")
             return None
         if isinstance(dictionary, dict):
             dictionary = Dictionary.ByPythonDictionary(dictionary)
         if not Topology.IsInstance(dictionary, "Dictionary"):
-            print("Topology.SetDictionary - Warning: the input dictionary parameter is not a valid dictionary. Returning original input.")
+            if not silent:
+                print("Topology.SetDictionary - Warning: the input dictionary parameter is not a valid dictionary. Returning original input.")
             return topology
         if len(dictionary.Keys()) < 1:
-            print("Topology.SetDictionary - Warning: the input dictionary parameter is empty. Returning original input.")
+            if not silent:
+                print("Topology.SetDictionary - Warning: the input dictionary parameter is empty. Returning original input.")
             return topology
         _ = topology.SetDictionary(dictionary)
         return topology
@@ -8003,4 +8122,105 @@ class Topology():
         predefined_namespace_dns = uuid.UUID('6ba7b810-9dad-11d1-80b4-00c04fd430c8')
         namespace_uuid = uuid.uuid5(predefined_namespace_dns, namespace)
         brep_string = Topology.BREPString(topology)
-        return uuid.uuid5(namespace_uuid, brep_string)
+        return uuid.uuid5(namespace_uuid, brep_string)
+    
+    @staticmethod
+    def View3D(*topologies, uuid = None, nameKey="name", colorKey="color", opacityKey="opacity", defaultColor=[256,256,256], defaultOpacity=0.5, transposeAxes: bool = True, mode: int = 0, meshSize: float = None, overwrite: bool = False, mantissa: int = 6, tolerance: float = 0.0001):
+        """
+        Sends the input topologies to 3dviewer.net. The topologies must be 3D meshes.
+
+        Parameters
+        ----------
+        topologies : list or comma separated topologies
+            The input list of topologies.
+        uuid : UUID , optional
+            The UUID v5 to use to identify these topologies. The default is a UUID based on the topologies themselves.
+        nameKey : str , optional
+            The topology dictionary key under which to find the name of the topology. The default is "name".
+        colorKey : str, optional
+            The topology dictionary key under which to find the color of the topology. The default is "color".
+        opacityKey : str , optional
+            The topology dictionary key under which to find the opacity of the topology. The default is "opacity".
+        defaultColor : list , optional
+            The default color to use if no color is stored in the topology dictionary. The default is [255,255, 255] (white).
+        defaultOpacity : float , optional
+            The default opacity to use of no opacity is stored in the topology dictionary. This must be between 0 and 1. The default is 1 (fully opaque).
+        transposeAxes : bool , optional
+            If set to True the Z and Y coordinates are transposed so that Y points "up"
+        mode : int , optional
+            The desired mode of meshing algorithm (for triangulation). Several options are available:
+            0: Classic
+            1: MeshAdapt
+            3: Initial Mesh Only
+            5: Delaunay
+            6: Frontal-Delaunay
+            7: BAMG
+            8: Fontal-Delaunay for Quads
+            9: Packing of Parallelograms
+            All options other than 0 (Classic) use the gmsh library. See https://gmsh.info/doc/texinfo/gmsh.html#Mesh-options
+            WARNING: The options that use gmsh can be very time consuming and can create very heavy geometry.
+        meshSize : float , optional
+            The desired size of the mesh when using the "mesh" option. If set to None, it will be
+            calculated automatically and set to 10% of the overall size of the face.
+        mantissa : int , optional
+            The desired length of the mantissa. The default is 6.
+        tolerance : float , optional
+            The desired tolerance. The default is 0.0001.
+        overwrite : bool , optional
+            If set to True the ouptut file will overwrite any pre-existing file. Otherwise, it won't. The default is False.
+
+        Returns
+        -------
+        bool
+            True if the export operation is successful. False otherwise.
+
+        """
+        from topologicpy.Helper import Helper
+        from topologicpy.Cluster import Cluster
+        import requests
+        import webbrowser
+
+        if isinstance(topologies, tuple):
+            topologies = Helper.Flatten(list(topologies))
+        if isinstance(topologies, list):
+            new_topologies = [d for d in topologies if Topology.IsInstance(d, "Topology")]
+        if len(new_topologies) == 0:
+            print("Topology.View3D - Error: the input topologies parameter does not contain any valid topologies. Returning None.")
+            return None
+        if not isinstance(new_topologies, list):
+            print("Topology.View3D - Error: The input topologies parameter is not a valid list. Returning None.")
+            return None
+
+        if uuid == None:
+            cluster = Cluster.ByTopologies(new_topologies)
+            uuid = Topology.UUID(cluster)
+        obj_string, mtl_string = Topology.OBJString(new_topologies,
+                                                    nameKey=nameKey,
+                                                    colorKey=colorKey,
+                                                    opacityKey=opacityKey,
+                                                    defaultColor=defaultColor,
+                                                    defaultOpacity=defaultOpacity,
+                                                    transposeAxes=transposeAxes,
+                                                    mode=mode,
+                                                    meshSize=meshSize,
+                                                    mantissa=mantissa,
+                                                    tolerance=tolerance)
+        
+
+        file_contents = {}
+        file_contents['example.obj'] = obj_string
+        file_contents['example.mtl'] = mtl_string
+
+        try:
+            response = requests.post('https://3dviewer.deno.dev/upload/'+str(uuid), files=file_contents)
+            if response.status_code != 200:
+                print(f'Failed to upload file(s): {response.status_code} {response.reason}')
+            # Open the web page in the default web browser
+            # URL of the web page you want to open
+            url = "https://3dviewer.deno.dev/#channel="+str(uuid)
+            if not url in opened_urls:
+                opened_urls.add(url)
+                webbrowser.open(url)
+        except requests.exceptions.RequestException as e:
+            print(f'Error uploading file(s): {e}')
+        return True

topologicpy/Vector.py

@@ -77,6 +77,12 @@ class Vector(list):
             The angle in degrees between the two input vectors.
 
         """
+        if vectorA == None:
+            print("Vector.Angle - Error: The input vectorA is None. Returning None.")
+            return None
+        if vectorB == None:
+            print("Vector.Angle - Error: The input vectorB is None. Returning None.")
+            return None
         n_v1=la.norm(vectorA)
         n_v2=la.norm(vectorB)
         if n_v1 == 0 or n_v2 == 0:

topologicpy/Vertex.py

@@ -1008,7 +1008,7 @@ class Vertex():
         tolerance : float , optional
             The tolerance for computing if the input vertex is external to the input topology. The default is 0.0001.
         silent : bool , optional
-            If set to False, error and warning messages are printed. Otherwise, they are not. The default is False.
+            If set to True, no error and warning messages are printed. Otherwise, they are. The default is False.
 
         Returns
         -------
@@ -1042,7 +1042,7 @@ class Vertex():
         tolerance : float , optional
             The tolerance for computing if the input vertex is internal to the input topology. The default is 0.0001.
         silent : bool , optional
-            If set to False, error and warning messages are printed. Otherwise, they are not. The default is False.
+            If set to True, no error and warning messages are printed. Otherwise, they are. The default is False.
 
         Returns
         -------
@@ -1153,7 +1153,7 @@ class Vertex():
         tolerance : float , optional
             The tolerance for computing if the input vertex is peripheral to the input topology. The default is 0.0001.
         silent : bool , optional
-            If set to False, error and warning messages are printed. Otherwise, they are not. The default is False.
+            If set to True, no error and warning messages are printed. Otherwise, they are. The default is False.
 
         Returns
         -------