topologicpy 0.8.42__py3-none-any.whl → 0.8.44__py3-none-any.whl

topologicpy/Color.py

@@ -19,6 +19,40 @@ import math
 
 class Color:
 
+    def AddHex(*colors):
+        """
+        Adds the input hexadecimal color codes channel-wise, clipping each channel to a max of 255.
+
+        Parameters
+        ----------
+        colors : *list or str
+            The input list of hexadecimal colors.
+
+        Returns
+        -------
+        str
+            The resulting hex color after addition (e.g., "#FF88FF").
+        """
+        import inspect
+        from topologicpy.Helper import Helper
+        
+        def add(hex1, hex2):
+            # Remove "#" if present
+            hex1 = hex1.lstrip('#')
+            hex2 = hex2.lstrip('#')
+
+            # Convert to RGB integers
+            r1, g1, b1 = int(hex1[0:2], 16), int(hex1[2:4], 16), int(hex1[4:6], 16)
+            r2, g2, b2 = int(hex2[0:2], 16), int(hex2[2:4], 16), int(hex2[4:6], 16)
+
+            # Add each channel, clip to 255
+            r = min(r1 + r2, 255)
+            g = min(g1 + g2, 255)
+            b = min(b1 + b2, 255)
+
+            # Return as hex string
+            return f"#{r:02X}{g:02X}{b:02X}"
+
     @staticmethod
     def AnyToHex(color):
         """
@@ -35,6 +69,8 @@ class Color:
             A hexadecimal color string in the format '#RRGGBB'.
         """
         return_hex = None
+        if isinstance(color, list) and all(isinstance(item, str) for item in color):
+            return Color.Average(color)
         if isinstance(color, list):
             if len(color) == 4: # Probably CMYK
                 if all(0 <= x <= 1 for x in color[:4]):
@@ -56,7 +92,7 @@ class Color:
         return return_hex.upper()
     
     @staticmethod
-    def AverageHex(*colors, silent: bool = False):
+    def Average(*colors, silent: bool = False):
         """
         Averages the input list of hex colors.
 

topologicpy/Dictionary.py

@@ -75,6 +75,7 @@ class Dictionary():
             The adjacency dictionary.
         """
         from topologicpy.Edge import Edge
+        from topologicpy.Face import Face
         from topologicpy.Dictionary import Dictionary
         from topologicpy.Topology import Topology
         from topologicpy.Graph import Graph
@@ -116,7 +117,7 @@ class Dictionary():
             if d == None:
                 d = Dictionary.ByKeyValue(labelKey, value)
             else:
-                d = Dictionary.SetValueAtKey(d, labelKey, value)
+                d = Dictionary.SetValueAtKey(d, labelKey, value, silent=silent)
             subtopology = Topology.SetDictionary(subtopology, d)
             labels.append(value)
         all_subtopologies = Helper.Sort(all_subtopologies, labels)
@@ -129,7 +130,7 @@ class Dictionary():
             adjacent_topologies = Topology.AdjacentTopologies(subtopology, hostTopology=topology, topologyType=subTopologyType)
             temp_list = []
             for adj_topology in adjacent_topologies:
-                adj_label = Dictionary.ValueAtKey(Topology.Dictionary(adj_topology), labelKey)
+                adj_label = Dictionary.ValueAtKey(Topology.Dictionary(adj_topology), labelKey, silent=silent)
                 adj_index = labels.index(adj_label)
                 if includeWeights == True:
                     if weightKey == None:
@@ -141,7 +142,7 @@ class Dictionary():
                     elif "area" in weightKey.lower():
                         shared_topologies = Topology.SharedTopologies(subtopology, adj_topology)
                         faces = shared_topologies.get("faces", [])
-                        weight = sum([Edge.Length(edge, mantissa=mantissa) for face in faces])
+                        weight = sum([Face.Area(face, mantissa=mantissa) for face in faces])
                     else:
                         shared_topologies = Topology.SharedTopologies(subtopology, adj_topology)
                         vertices = shared_topologies.get("vertices", [])
@@ -166,7 +167,7 @@ class Dictionary():
         return adjDict
     
     @staticmethod
-    def ByKeyValue(key, value):
+    def ByKeyValue(key, value, silent: bool = False):
         """
         Creates a Dictionary from the input key and the input value.
 
@@ -176,6 +177,8 @@ class Dictionary():
             The string representing the key of the value in the dictionary.
         value : int, float, str, or list
             A value corresponding to the input key. A value can be an integer, a float, a string, or a list.
+        silent : bool , optional
+            If set to True, error and warning messages are suppressed. The default is False.
 
         Returns
         -------
@@ -184,9 +187,10 @@ class Dictionary():
 
         """
         if not isinstance(key, str):
-            print("Dictionary.ByKeyValue - Error: The input key is not a valid string. Returning None.")
+            if not silent:
+                print("Dictionary.ByKeyValue - Error: The input key is not a valid string. Returning None.")
             return None
-        return Dictionary.ByKeysValues([key], [value])
+        return Dictionary.ByKeysValues([key], [value], silent=silent)
     
     
     @staticmethod
@@ -234,7 +238,7 @@ class Dictionary():
         return attr
     
     @staticmethod
-    def ByKeysValues(keys, values):
+    def ByKeysValues(keys, values, silent: bool = False):
         """
         Creates a Dictionary from the input list of keys and the input list of values.
 
@@ -244,6 +248,8 @@ class Dictionary():
             A list of strings representing the keys of the dictionary.
         values : list
             A list of values corresponding to the list of keys. Values can be integers, floats, strings, or lists
+        silent : bool , optional
+            If set to True, error and warning messages are suppressed. The default is False.
 
         Returns
         -------
@@ -253,13 +259,16 @@ class Dictionary():
         """
         
         if not isinstance(keys, list):
-            print("Dictionary.ByKeysValues - Error: The input keys parameter is not a valid list. Returning None.")
+            if not silent:
+                print("Dictionary.ByKeysValues - Error: The input keys parameter is not a valid list. Returning None.")
             return None
         if not isinstance(values, list):
-            print("Dictionary.ByKeysValues - Error: The input values parameter is not a valid list. Returning None.")
+            if not silent:
+                print("Dictionary.ByKeysValues - Error: The input values parameter is not a valid list. Returning None.")
             return None
         if len(keys) != len(values):
-            print("Dictionary.ByKeysValues - Error: The input keys and values parameters are not of equal length. Returning None.")
+            if not silent:
+                print("Dictionary.ByKeysValues - Error: The input keys and values parameters are not of equal length. Returning None.")
             return None
         stl_keys = []
         stl_values = []
@@ -440,7 +449,7 @@ class Dictionary():
     '''
 
     @staticmethod
-    def ByPythonDictionary(pythonDictionary):
+    def ByPythonDictionary(pythonDictionary, silent: bool = False):
         """
         Creates a dictionary equivalent to the input python dictionary.
 
@@ -448,6 +457,8 @@ class Dictionary():
         ----------
         pythonDictionary : dict
             The input python dictionary.
+        silent : bool , optional
+            If set to True, error and warning messages are suppressed. The default is False.
 
         Returns
         -------
@@ -456,7 +467,8 @@ class Dictionary():
 
         """
         if not isinstance(pythonDictionary, dict):
-            print("Dictionary.ByPythonDictionary - Error: The input dictionary parameter is not a valid python dictionary. Returning None.")
+            if not silent:
+                print("Dictionary.ByPythonDictionary - Error: The input dictionary parameter is not a valid python dictionary. Returning None.")
             return None
         keys = list(pythonDictionary.keys())
         values = []
@@ -480,7 +492,8 @@ class Dictionary():
             A copy of the input dictionary.
 
         """
-        if not isinstance(dictionary, topologic_core.Dictionary):
+        from topologicpy.Topology import Topology
+        if not Topology.IsInstance(dictionary, "dictionary"):
             if not silent:
                 print("Dictionary.Copy - Error: The input dictionary parameter is not a valid dictionary. Returning None.")
             return None
@@ -580,7 +593,7 @@ class Dictionary():
         return {"filteredDictionaries": filteredDictionaries, "otherDictionaries": otherDictionaries, "filteredIndices": filteredIndices, "otherIndices": otherIndices, "filteredElements": filteredElements, "otherElements": otherElements}
 
     @staticmethod
-    def Keys(dictionary):
+    def Keys(dictionary, silent: bool = False):
         """
         Returns the keys of the input dictionary.
 
@@ -588,6 +601,8 @@ class Dictionary():
         ----------
         dictionary : topologic_core.Dictionary or dict
             The input dictionary.
+        silent : bool , optional
+            If set to True, error and warning messages are suppressed. The default is False.
 
         Returns
         -------
@@ -596,8 +611,14 @@ class Dictionary():
 
         """
         from topologicpy.Topology import Topology
+        import inspect
+
         if not Topology.IsInstance(dictionary, "Dictionary") and not isinstance(dictionary, dict):
-            print("Dictionary.Keys - Error: The input dictionary parameter is not a valid topologic or python dictionary. Returning None.")
+            if not silent:
+                print("Dictionary.Keys - Error: The input dictionary parameter is not a valid topologic or python dictionary. Returning None.")
+                curframe = inspect.currentframe()
+                calframe = inspect.getouterframes(curframe, 2)
+                print('caller name:', calframe[1][3])
             return None
         if isinstance(dictionary, dict):
             return list(dictionary.keys())
@@ -627,7 +648,7 @@ class Dictionary():
         return returnList    
        
     @staticmethod
-    def PythonDictionary(dictionary):
+    def PythonDictionary(dictionary, silent: bool = False):
         """
         Returns the input dictionary as a python dictionary
 
@@ -635,6 +656,8 @@ class Dictionary():
         ----------
         dictionary : topologic_core.Dictionary
             The input dictionary.
+        silent : bool , optional
+            If set to True, error and warning messages are suppressed. The default is False.
 
         Returns
         -------
@@ -645,10 +668,12 @@ class Dictionary():
         from topologicpy.Topology import Topology
 
         if isinstance(dictionary, dict):
-            print("Dictionary.PythonDictionary - Warning: The input dictionary parameter is already a python dictionary. Returning that dictionary.")
+            if not silent:
+                print("Dictionary.PythonDictionary - Warning: The input dictionary parameter is already a python dictionary. Returning that dictionary.")
             return dictionary
         if not Topology.IsInstance(dictionary, "Dictionary"):
-            print("Dictionary.PythonDictionary - Error: The input dictionary parameter is not a valid topologic dictionary. Returning None.")
+            if not silent:
+                print("Dictionary.PythonDictionary - Error: The input dictionary parameter is not a valid topologic dictionary. Returning None.")
             return None
         keys = dictionary.Keys()
         pythonDict = {}
@@ -674,7 +699,7 @@ class Dictionary():
         return pythonDict
 
     @staticmethod
-    def RemoveKey(dictionary, key):
+    def RemoveKey(dictionary, key, silent: bool = False):
         """
         Removes the key (and its associated value) from the input dictionary.
 
@@ -684,6 +709,8 @@ class Dictionary():
             The input dictionary.
         key : string
             The input key.
+        silent : bool , optional
+            If set to True, error and warning messages are suppressed. The default is False.
 
         Returns
         -------
@@ -713,10 +740,12 @@ class Dictionary():
             return Dictionary.ByKeysValues(new_keys, new_values)
         
         if not Topology.IsInstance(dictionary, "Dictionary") and not isinstance(dictionary, dict):
-            print("Dictionary.RemoveKey - Error: The input dictionary parameter is not a valid topologic or python dictionary. Returning None.")
+            if not silent:
+                print("Dictionary.RemoveKey - Error: The input dictionary parameter is not a valid topologic or python dictionary. Returning None.")
             return None
         if not isinstance(key, str):
-            print("Dictionary.RemoveKey - Error: The input key parameter is not a valid string. Returning None.")
+            if not silent:
+                print("Dictionary.RemoveKey - Error: The input key parameter is not a valid string. Returning None.")
             return None
 
         if isinstance(dictionary, dict):
@@ -727,7 +756,7 @@ class Dictionary():
             return None
         
     @staticmethod
-    def SetValueAtKey(dictionary, key, value):
+    def SetValueAtKey(dictionary, key, value, silent: bool = False):
         """
         Creates a key/value pair in the input dictionary.
 
@@ -739,6 +768,8 @@ class Dictionary():
             The input key.
         value : int , float , string, or list
             The value associated with the key.
+        silent : bool , optional
+            If set to True, error and warning messages are suppressed. The default is False.
 
         Returns
         -------
@@ -768,10 +799,12 @@ class Dictionary():
             return d
         
         if not Topology.IsInstance(dictionary, "Dictionary") and not isinstance(dictionary, dict):
-            print("Dictionary.SetValueAtKey - Error: The input dictionary parameter is not a valid topologic or python dictionary. Returning None.")
+            if not silent:
+                print("Dictionary.SetValueAtKey - Error: The input dictionary parameter is not a valid topologic or python dictionary. Returning None.")
             return None
         if not isinstance(key, str):
-            print("Dictionary.SetValueAtKey - Error: The input key parameter is not a valid string. Returning None.")
+            if not silent:
+                print("Dictionary.SetValueAtKey - Error: The input key parameter is not a valid string. Returning None.")
             return None
         if value == None:
             value = "__NONE__"
@@ -783,7 +816,7 @@ class Dictionary():
             return None
     
     @staticmethod
-    def SetValuesAtKeys(dictionary, keys, values):
+    def SetValuesAtKeys(dictionary, keys, values, silent: bool = False):
         """
         Creates a key/value pair in the input dictionary.
 
@@ -793,6 +826,8 @@ class Dictionary():
             A list of strings representing the keys of the dictionary.
         values : list
             A list of values corresponding to the list of keys. Values can be integers, floats, strings, or lists
+        silent : bool , optional
+            If set to True, error and warning messages are suppressed. The default is False.
 
         Returns
         -------
@@ -802,17 +837,20 @@ class Dictionary():
         """
         
         if not isinstance(keys, list):
-            print("Dictionary.SetValuesAtKeys - Error: The input keys parameter is not a valid list. Returning None.")
+            if not silent:
+                print("Dictionary.SetValuesAtKeys - Error: The input keys parameter is not a valid list. Returning None.")
             return None
         if not isinstance(values, list):
-            print("Dictionary.SetValuesAtkeys - Error: The input values parameter is not a valid list. Returning None.")
+            if not silent:
+                print("Dictionary.SetValuesAtkeys - Error: The input values parameter is not a valid list. Returning None.")
             return None
         if len(keys) != len(values):
-            print("Dictionary.SetValuesAtKeys - Error: The input keys and values parameters are not of equal length. Returning None.")
+            if not silent:
+                print("Dictionary.SetValuesAtKeys - Error: The input keys and values parameters are not of equal length. Returning None.")
             return None
         
         for i, key in enumerate(keys):
-            dictionary = Dictionary.SetValueAtKey(dictionary, key, values[i])
+            dictionary = Dictionary.SetValueAtKey(dictionary, key, values[i], silent=silent)
         return dictionary
     
     @staticmethod
@@ -930,18 +968,9 @@ class Dictionary():
         elif isinstance(dictionary, dict):
             return dictionary.get(key, defaultValue)
         return defaultValue
-        
-        # if isinstance(dictionary, dict):
-        #     attr = dictionary[key]
-        # elif Topology.IsInstance(dictionary, "Dictionary"):
-        #     attr = dictionary.ValueAtKey(key)
-        # else:
-        #     return None
-        # return_value = Dictionary._ConvertAttribute(attr)
-        # return return_value
-        
+    
     @staticmethod
-    def Values(dictionary):
+    def Values(dictionary, silent: bool = False):
         """
         Returns the list of values in the input dictionary.
 
@@ -949,6 +978,8 @@ class Dictionary():
         ----------
         dictionary : topologic_core.Dictionary or dict
             The input dictionary.
+        silent : bool , optional
+            If set to True, error and warning messages are suppressed. The default is False.
 
         Returns
         -------
@@ -959,7 +990,8 @@ class Dictionary():
         from topologicpy.Topology import Topology
 
         if not Topology.IsInstance(dictionary, "Dictionary") and not isinstance(dictionary, dict):
-            print("Dictionary.Values - Error: The input dictionary parameter is not a valid topologic or python dictionary. Returning None.")
+            if not silent:
+                print("Dictionary.Values - Error: The input dictionary parameter is not a valid topologic or python dictionary. Returning None.")
             return None
         keys = None
         if isinstance(dictionary, dict):
@@ -981,5 +1013,48 @@ class Dictionary():
             returnList.append(attr)
         return returnList
     
+    @staticmethod
+    def ValuesAtKeys(dictionary, keys, defaultValue=None, silent: bool = False):
+        """
+        Returns the list of values of the input list of keys in the input dictionary.
+
+        Parameters
+        ----------
+        dictionary : topologic_core.Dictionary or dict
+            The input dictionary.
+        keys : list
+            The input list of keys.
+        defaultValue : any , optional
+            The default value to return if the key or value are not found. The default is None.
+        silent : bool , optional
+            If set to True, error and warning messages are suppressed. The default is False.
+
+        Returns
+        -------
+        list
+            The list of values found at the input list of keys in the input dictionary.
+
+        """
+        from topologicpy.Topology import Topology
+        
+        if not Topology.IsInstance(dictionary, "Dictionary") and not isinstance(dictionary, dict):
+            if not silent == True:
+                print("Dictionary.ValuesAtKeys - Error: The input dictionary parameter is not a valid topologic or python dictionary. Returning None.")
+            return None
+        if not isinstance(keys, list):
+            if not silent == True:
+                print("Dictionary.ValuesAtKeys - Error: The input keys parameter is not a valid list. Returning None.")
+            return None
+        
+        local_keys = [k for k in keys if isinstance(k, str)]
+        if len(local_keys) == 0:
+            if not silent == True:
+                print("Dictionary.ValuesAtKeys - Error: The input keys parameter does not contain valid key strings. Returning None.")
+            return None
+        if not len(local_keys) == len(keys):
+            if not silent == True:
+                print("Dictionary.ValuesAtKeys - Error: The input keys parameter contains invalid values. Returning None.")
+            return None
+        return [Dictionary.ValueAtKey(dictionary, key, defaultValue=defaultValue, silent=silent) for key in keys]
     
 

topologicpy/Topology.py

@@ -941,7 +941,68 @@ class Topology():
             return Cluster.ByTopologies(return_list)
         else:
             return None
+
+
+    @staticmethod
+    def Inherit(targets, sources, keys: list = None, exclusive: bool = True, tolerance: float = 0.0001, silent: bool = False):
+        """
+        Transfers dictionary information from topologiesB to topologiesA based on co-location of internal vertices.
+
+        Parameters
+        ----------
+        targets : list of topologic_core.Topology
+            The list of target topologies that will inherit the dictionaries.
+        sources : list of topologic_core. Topology
+            The list of source topologies from which to inherit dictionary information.
+        exclusive : bool , optional
+            If set to True, a target will inherit information only from the first eligible source. The default is True.
+        tolerance : float , optional
+            The desired tolerance. The default is 0.0001.
+        silent : bool , optional
+            If set to True, error and warning messages are suppressed. The default is False.
         
+        Returns
+        -------
+        list
+            The list of target topologies with the dictionary information inherited from the list of source topologies.
+
+        """
+        from topologicpy.Topology import Topology
+        from topologicpy.Vertex import Vertex
+        from topologicpy.Dictionary import Dictionary
+
+        topologies_a = [a for a in targets if Topology.IsInstance(a, "Topology")]
+        if len(topologies_a) == 0:
+            if not silent:
+                print("Topology.Inherit - Error: The list of targets does not contain any valid topologies. Returning None.")
+            return None
+        topologies_b = [b for b in sources if Topology.IsInstance(b, "Topology")]
+        if len(topologies_b) == 0:
+            if not silent:
+                print("Topology.Inherit - Error: The list of sources does not contain any valid topologies. Returning None.")
+            return None
+        for i, top_a in enumerate(topologies_a):
+            iv = Topology.InternalVertex(top_a, tolerance=tolerance, silent=silent)
+            d_a = Topology.Dictionary(top_a, silent=silent)
+            found = False
+            for j, top_b in enumerate(topologies_b):
+                if Vertex.IsInternal(iv, top_b, tolerance=tolerance, silent=silent):
+                    d_b = Topology.Dictionary(top_b)
+                    if isinstance(keys, list):
+                        values = Dictionary.ValuesAtKeys(d_b, keys, silent=silent)
+                        d_c = Dictionary.ByKeysValues(keys, values)
+                        d_a = Dictionary.ByMergedDictionaries(d_a, d_c, silent=silent)
+                    else:
+                        d_a = Dictionary.ByMergedDictionaries(d_a, d_b, silent=silent)
+                    top_a = Topology.SetDictionary(top_a, d_a, silent=silent)
+                    found = True
+                    if exclusive:
+                        break
+            if found == False:
+                if not silent:
+                    print("Topology.Inherit - Warning: Could not find a source for target number: "+str(i+1)+". Consider increasing the tolerance value.")
+        return targets
+
     @staticmethod
     def Intersect(topologyA, topologyB, tranDict=False, tolerance=0.0001):
         """
@@ -4144,7 +4205,7 @@ class Topology():
         return round(max_distance, mantissa)
     
     @staticmethod
-    def Dictionary(topology):
+    def Dictionary(topology, silent: bool = False):
         """
         Returns the dictionary of the input topology
 
@@ -4152,6 +4213,8 @@ class Topology():
         ----------
         topology : topologic_core.Topology
             The input topology.
+        silent : bool , optional
+            If set to True, error and warning messages are suppressed. The default is False.
 
         Returns
         -------
@@ -4160,12 +4223,13 @@ class Topology():
 
         """
         if not Topology.IsInstance(topology, "Topology") and not Topology.IsInstance(topology, "Graph"):
-            print("Topology.Dictionary - Error: the input topology parameter is not a valid topology. Returning None.")
+            if not silent:
+                print("Topology.Dictionary - Error: the input topology parameter is not a valid topology. Returning None.")
             return None
         return topology.GetDictionary()
     
     @staticmethod
-    def Dimensionality(topology):
+    def Dimensionality(topology, silent: bool = False):
         """
         Returns the dimensionality of the input topology
 
@@ -4173,6 +4237,8 @@ class Topology():
         ----------
         topology : topologic_core.Topology
             The input topology.
+        silent : bool , optional
+            If set to True, error and warning messages are suppressed. The default is False.
 
         Returns
         -------
@@ -4181,12 +4247,13 @@ class Topology():
 
         """
         if not Topology.IsInstance(topology, "Topology"):
-            print("Topology.Dimensionality - Error: the input topology parameter is not a valid topology. Returning None.")
+            if not silent:
+                print("Topology.Dimensionality - Error: the input topology parameter is not a valid topology. Returning None.")
             return None
         return topology.Dimensionality()
     
     @staticmethod
-    def Divide(topologyA, topologyB, transferDictionary=False, addNestingDepth=False):
+    def Divide(topologyA, topologyB, transferDictionary=False, addNestingDepth=False, silent: bool = False):
         """
         Divides the input topology by the input tool and places the results in the contents of the input topology.
 
@@ -4200,6 +4267,8 @@ class Topology():
             If set to True the dictionary of the input topology is transferred to the divided topologies.
         addNestingDepth : bool , optional
             If set to True the nesting depth of the division is added to the dictionaries of the divided topologies.
+        silent : bool , optional
+            If set to True, error and warning messages are suppressed. The default is False.
 
         Returns
         -------
@@ -4210,13 +4279,15 @@ class Topology():
         from topologicpy.Dictionary import Dictionary
 
         if not Topology.IsInstance(topologyA, "Topology"):
-            print("Topology.Divide - Error: the input topologyA parameter is not a valid topology. Returning None.")
+            if not silent:
+                print("Topology.Divide - Error: the input topologyA parameter is not a valid topology. Returning None.")
             return None
         if not Topology.IsInstance(topologyB, "Topology"):
-            print("Topology.Divide - Error: the input topologyB parameter is not a valid topology. Returning None.")
+            if not silent:
+                print("Topology.Divide - Error: the input topologyB parameter is not a valid topology. Returning None.")
             return None
         try:
-            _ = topologyA.Divide(topologyB, False) # Don't transfer dictionaries just yet
+            _ = topologyA.Divide(topologyB, False) # Don't transfer dictionaries just yet # Hook to Core
         except:
             raise Exception("TopologyDivide - Error: Divide operation failed.")
         nestingDepth = "1"
@@ -4251,7 +4322,7 @@ class Topology():
                 _ = Topology.SetDictionary(topologyA, parentDictionary)
                 values[keys.index("nesting_depth")] = nestingDepth+"_"+str(i+1)
                 d = Dictionary.ByKeysValues(keys, values)
-                _ = contents[i].SetDictionary(d)
+                _ = contents[i].SetDictionary(d) # Hook to Core
             if addNestingDepth and  not transferDictionary:
                 parentDictionary = Topology.Dictionary(topologyA)
                 if parentDictionary != None:
@@ -4275,7 +4346,7 @@ class Topology():
         return topologyA
     
     @staticmethod
-    def Explode(topology, origin=None, scale: float = 1.25, typeFilter: str = None, axes: str = "xyz", transferDictionaries: bool = False, mantissa: int = 6, tolerance: float = 0.0001):
+    def Explode(topology, origin=None, scale: float = 1.25, typeFilter: str = None, axes: str = "xyz", transferDictionaries: bool = False, mantissa: int = 6, tolerance: float = 0.0001, silent: bool = False):
         """
         Explodes the input topology. See https://en.wikipedia.org/wiki/Exploded-view_drawing.
 
@@ -4297,6 +4368,8 @@ class Topology():
             The desired length of the mantissa. The default is 6.
         tolerance : float , optional
             The desired tolerance. The default is 0.0001.
+        silent : bool , optional
+            If set to True, error and warning messages are suppressed. The default is False.
         
         Returns
         -------
@@ -4348,27 +4421,31 @@ class Topology():
             return typeFilter
         
         if not Topology.IsInstance(topology, "Topology"):
-            print("Topology.Explode - Error: the input topology parameter is not a valid topology. Returning None.")
+            if not silent:
+                print("Topology.Explode - Error: the input topology parameter is not a valid topology. Returning None.")
             return None
         if not Topology.IsInstance(origin, "Vertex"):
             origin = Topology.CenterOfMass(topology)
         if not typeFilter:
             typeFilter = getTypeFilter(topology)
         if not isinstance(typeFilter, str):
-            print("Topology.Explode - Error: the input typeFilter parameter is not a valid string. Returning None.")
+            if not silent:
+                print("Topology.Explode - Error: the input typeFilter parameter is not a valid string. Returning None.")
             return None
         if not isinstance(axes, str):
-            print("Topology.Explode - Error: the input axes parameter is not a valid string. Returning None.")
+            if not silent:
+                print("Topology.Explode - Error: the input axes parameter is not a valid string. Returning None.")
             return None
-        if Topology.IsInstance(topology, "Topology"):
-            # Hack to fix a weird bug that seems to be a problem with OCCT memory handling.
-            topology = Topology.ByJSONString(Topology.JSONString([topology]))[0]
+        # if Topology.IsInstance(topology, "Topology"):
+        #     # Hack to fix a weird bug that seems to be a problem with OCCT memory handling.
+        #     topology = Topology.ByJSONString(Topology.JSONString([topology]))[0]
         axes = axes.lower()
         x_flag = "x" in axes
         y_flag = "y" in axes
         z_flag = "z" in axes
         if not x_flag and not y_flag and not z_flag:
-            print("Topology.Explode - Error: the input axes parameter is not a valid string. Returning None.")
+            if not silent:
+                print("Topology.Explode - Error: the input axes parameter is not a valid string. Returning None.")
             return None
 
         topologies = []
@@ -4405,7 +4482,7 @@ class Topology():
             if transferDictionaries == True:
                 newTopology = Topology.SetDictionary(newTopology, Topology.Dictionary(aTopology))
             newTopologies.append(newTopology)
-        return Cluster.ByTopologies(newTopologies)
+        return Cluster.ByTopologies(newTopologies, silent=silent)
     
     @staticmethod
     def ExportToBIM(topologies, path : str, overwrite: bool = False, version: str = "1.0.0",

topologicpy/version.py

@@ -1 +1 @@
-__version__ = '0.8.42'
+__version__ = '0.8.44'

{topologicpy-0.8.42.dist-info → topologicpy-0.8.44.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: topologicpy
-Version: 0.8.42
+Version: 0.8.44
 Summary: An AI-Powered Spatial Modelling and Analysis Software Library for Architecture, Engineering, and Construction.
 Author-email: Wassim Jabi <wassim.jabi@gmail.com>
 License: AGPL v3 License

{topologicpy-0.8.42.dist-info → topologicpy-0.8.44.dist-info}/RECORD

@@ -5,10 +5,10 @@ topologicpy/CSG.py,sha256=uDkOSmc8m1V_k7T3UCerODhOSyYNO4FRDzoOqt0kEt8,15590
 topologicpy/Cell.py,sha256=M4Xv4gabSgtKYYA-Wh0lgYEbRNRVF9zr4DYejOXJc-4,176278
 topologicpy/CellComplex.py,sha256=c2B3mF1c3iwOfT-V0JWt9qNcFdd6DPR0aBOE2UnZTn4,61165
 topologicpy/Cluster.py,sha256=wvfMAx6aPrSAt5nQ4--KnqD4EK9MGjch6Dg985WF7JQ,58748
-topologicpy/Color.py,sha256=FcR0-__giyGQqvgiOrG8GkA65arHbiS33Si-QbUADPI,23362
+topologicpy/Color.py,sha256=OTtXo9htNuOqZaZZpfK5BoLsJFJssauk3jbHzIBnWx8,24518
 topologicpy/Context.py,sha256=G3CwMvN8Jw2rnQRwB-n4MaQq_wLS0vPimbXKwsdMJ80,3055
 topologicpy/DGL.py,sha256=HQXy9iDnrvWGDxaBfe5pRbweQ2zLBvAf6UdjfhKkQYI,139041
-topologicpy/Dictionary.py,sha256=2Sxm8twR1W4ksZho0YXQB_EltK2qbZWK4UHskP3jvFQ,40846
+topologicpy/Dictionary.py,sha256=sPskW5bopbDzLz6MGKm8lN_OeyeAgsqdLvwwNcG0J3g,44690
 topologicpy/Edge.py,sha256=dLoAPuRKbjVg_dzloTgjRnQyv_05U9nfrtLO3tqyuys,74167
 topologicpy/EnergyModel.py,sha256=Pyb28gDDwhzlQIH0xqAygqS0P3SJxWyyV7OWS_AAfRs,53856
 topologicpy/Face.py,sha256=pN1fssyDLYWf1vU0NOBRx69DaUL958wRSxT-7VBCuCg,203184
@@ -25,14 +25,14 @@ topologicpy/ShapeGrammar.py,sha256=UVb8VPwVKd6V3zDTNzpBecQPgYo1EjSsS10XJ8k5YcI,2
 topologicpy/Shell.py,sha256=fx0WTndC8blkvWe38nKsJsI_AmklOA0qsjU0gbZp4b4,90501
 topologicpy/Speckle.py,sha256=-eiTqJugd7pHiHpD3pDUcDO6CGhVyPV14HFRzaqEoaw,18187
 topologicpy/Sun.py,sha256=_VBBAUIDhvpkp72JBZlv7k9qx9jYubm3yM56UZ1Nc6c,36837
-topologicpy/Topology.py,sha256=FnDunqk4uq0iAqtOiQtjNArETXflx6cRBHMYv7NJqC8,467594
+topologicpy/Topology.py,sha256=-9hsN1PSvhH7qDo1HXjd545xteRZZY7-fxtxoBtU1Tw,471584
 topologicpy/Vector.py,sha256=X12eqskn28bdB7sLY1EZhq3noPYzPbNEgHPb4a959ss,42302
 topologicpy/Vertex.py,sha256=RlGQnxQSb_kAus3tJgXd-v-Ptubtt09PQPA9IMwfXmI,84835
 topologicpy/Wire.py,sha256=sJE8qwqYOomvN3snMWmj2P2-Sq25ul_OQ95YFz6DFUw,230553
 topologicpy/__init__.py,sha256=RMftibjgAnHB1vdL-muo71RwMS4972JCxHuRHOlU428,928
-topologicpy/version.py,sha256=zx8I7AqRXGv-YmSUcQeFeKLCO2nWXVogDC-GQVEnTsI,23
-topologicpy-0.8.42.dist-info/licenses/LICENSE,sha256=FK0vJ73LuE8PYJAn7LutsReWR47-Ooovw2dnRe5yV6Q,681
-topologicpy-0.8.42.dist-info/METADATA,sha256=YEn71WRNeRaM0zD1L8Uh4HSmaxe_JJPkC5lBpaawXcc,10535
-topologicpy-0.8.42.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-topologicpy-0.8.42.dist-info/top_level.txt,sha256=J30bDzW92Ob7hw3zA8V34Jlp-vvsfIkGzkr8sqvb4Uw,12
-topologicpy-0.8.42.dist-info/RECORD,,
+topologicpy/version.py,sha256=H1GigrgdekxMys9lmJxIRnIFrNk4zrmX7xz5PrqPdxE,23
+topologicpy-0.8.44.dist-info/licenses/LICENSE,sha256=FK0vJ73LuE8PYJAn7LutsReWR47-Ooovw2dnRe5yV6Q,681
+topologicpy-0.8.44.dist-info/METADATA,sha256=YU_ze05mFUZrce4XzGuVddWEEOzOM_oTPndhJHejKC0,10535
+topologicpy-0.8.44.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+topologicpy-0.8.44.dist-info/top_level.txt,sha256=J30bDzW92Ob7hw3zA8V34Jlp-vvsfIkGzkr8sqvb4Uw,12
+topologicpy-0.8.44.dist-info/RECORD,,