topologicpy 0.6.2__py3-none-any.whl → 0.6.3__py3-none-any.whl

topologicpy/Graph.py

@@ -7330,7 +7330,7 @@ class Graph:
         return shortestPaths
 
     @staticmethod
-    def Show(graph, vertexColor="black", vertexSize=6, vertexLabelKey=None, vertexGroupKey=None, vertexGroups=[], showVertices=True, showVertexLegend=False, edgeColor="black", edgeWidth=1, edgeLabelKey=None, edgeGroupKey=None, edgeGroups=[], showEdges=True, showEdgeLegend=False, colorScale='viridis', renderer="notebook",
+    def Show(graph, vertexColor="black", vertexSize=6, vertexLabelKey=None, vertexGroupKey=None, vertexGroups=[], showVertices=True, showVertexLegend=False, edgeColor="black", edgeWidth=1, edgeLabelKey=None, edgeGroupKey=None, edgeGroups=[], showEdges=True, showEdgeLegend=False, colorScale='viridis', renderer=None,
              width=950, height=500, xAxis=False, yAxis=False, zAxis=False, axisSize=1, backgroundColor='rgba(0,0,0,0)', marginLeft=0, marginRight=0, marginTop=20, marginBottom=0,
              camera=[-1.25, -1.25, 1.25], center=[0, 0, 0], up=[0, 0, 1], projection="perspective", tolerance=0.0001):
         """
@@ -7381,7 +7381,7 @@ class Graph:
         colorScale : str , optional
             The desired type of plotly color scales to use (e.g. "Viridis", "Plasma"). The default is "Viridis". For a full list of names, see https://plotly.com/python/builtin-colorscales/.
         renderer : str , optional
-            The desired type of renderer. The default is 'notebook'.
+            The desired renderer. See Plotly.Renderers(). If set to None, the code will attempt to discover the most suitable renderer. The default is None.
         width : int , optional
             The width in pixels of the figure. The default value is 950.
         height : int , optional

topologicpy/Plotly.py

@@ -1923,7 +1923,7 @@ class Plotly:
         return figure
 
     @staticmethod
-    def Show(figure, camera=[-1.25, -1.25, 1.25], center=[0, 0, 0], up=[0, 0, 1], renderer="notebook", projection="perspective"):
+    def Show(figure, camera=[-1.25, -1.25, 1.25], center=[0, 0, 0], up=[0, 0, 1], renderer=None, projection="perspective"):
         """
         Shows the input figure.
 
@@ -1938,7 +1938,7 @@ class Plotly:
         up : list , optional
             The desired up vector. The default is [0, 0, 1].
         renderer : str , optional
-            The desired rendered. See Plotly.Renderers(). The default is "notebook".
+            The desired renderer. See Plotly.Renderers(). If set to None, the code will attempt to discover the most suitable renderer. The default is None.
         projection : str, optional
             The desired type of projection. The options are "orthographic" or "perspective". It is case insensitive. The default is "perspective"
 
@@ -1954,6 +1954,8 @@ class Plotly:
         if not isinstance(figure, plotly.graph_objs._figure.Figure):
             print("Plotly.Show - Error: The input is not a figure. Returning None.")
             return None
+        if renderer == None:
+            renderer = Plotly.Renderer()
         if not renderer.lower() in Plotly.Renderers():
             print("Plotly.Show - Error: The input renderer is not in the approved list of renderers. Returning None.")
             return None
@@ -1965,6 +1967,36 @@ class Plotly:
             figure.show(renderer=renderer)
         return None
 
+    @staticmethod
+    def Renderer():
+        """
+        Return the renderer most suitable for the environment in which the script is running.
+
+        Parameters
+        ----------
+
+        Returns
+        -------
+        str
+            The most suitable renderer type for the environment in which the script is running.
+            Currently, this is limited to:
+            - "vscode" if running in Visual Studio Code
+            - "colab" if running in Google Colab
+            - "iframe" if running in jupyter notebook or jupyterlab
+            - "browser" if running in anything else
+        """
+        import sys
+        import os
+        
+        if 'VSCODE_PID' in os.environ:
+            return 'vscode'
+        elif "google.colab" in sys.modules:
+            return "colab"
+        elif "ipykernel" in sys.modules:
+            return "iframe" #works for jupyter notebook and jupyterlab
+        else:
+            return "browser"
+
     @staticmethod
     def Renderers():
         """

topologicpy/Topology.py

@@ -5929,7 +5929,7 @@ class Topology():
         projection : str , optional
             The desired type of projection. The options are "orthographic" or "perspective". It is case insensitive. The default is "perspective"
         renderer : str , optional
-            The desired renderer. See Plotly.Renderers(). The default is "notebook".
+            The desired renderer. See Plotly.Renderers(). If set to None, the code will attempt to discover the most suitable renderer. The default is None.
         intensityKey : str , optional
             If not None, the dictionary of each vertex is searched for the value associated with the intensity key. This value is then used to color-code the vertex based on the colorScale. The default is None.
         intensities : list , optional

topologicpy/version.py

@@ -1 +1 @@
-__version__ = '0.6.2'
+__version__ = '0.6.3'

{topologicpy-0.6.2.dist-info → topologicpy-0.6.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: topologicpy
-Version: 0.6.2
+Version: 0.6.3
 Summary: An Advanced Spatial Modelling and Analysis Software Library for Architecture, Engineering, and Construction.
 Author-email: Wassim Jabi <wassim.jabi@gmail.com>
 License: GNU AFFERO GENERAL PUBLIC LICENSE

{topologicpy-0.6.2.dist-info → topologicpy-0.6.3.dist-info}/RECORD

@@ -9,25 +9,25 @@ topologicpy/Dictionary.py,sha256=R7Hb9-LTEgRyaRjxRn8NwBS1Hhkpcqe2QmHmKBxpr54,262
 topologicpy/Edge.py,sha256=TEWb-zxZx57Fdzvdf92Y72MXi380NAvRCb8HS4YPtRU,49110
 topologicpy/EnergyModel.py,sha256=z83MPP641Sy8uTwH5lvfc0K90-d6BBCOnCebEMO152k,52759
 topologicpy/Face.py,sha256=QcuICkzSuj4HDYQKH1jQl3X721pFIB1xd8S58x9HwNU,88676
-topologicpy/Graph.py,sha256=1i7qv_-AHLHpNFuX4Avv7rLgA1frQMariygv4_aL1Dw,365039
+topologicpy/Graph.py,sha256=0DaK1ampqyvY8W2PZyqU14DahEZkJXtWGddHZ7PDyng,365121
 topologicpy/Grid.py,sha256=8ARLeBUnEMQEwB2Xale928rZWeUBKYgerkmbvoSgnrs,17054
 topologicpy/Helper.py,sha256=07V9IFu5ilMpvAdZVhIbdBOjBJSRTtJ0BfR1IoRaRXU,17743
 topologicpy/Honeybee.py,sha256=rw9l4M6ZeeywlK6SAH66bi1vjXC2AwACUk4o8GF7-T8,19913
 topologicpy/Matrix.py,sha256=ynP4jEMZZC78tZ5Re8dVf3CheEOGnVVFn83_Zl7kUj8,8086
 topologicpy/Neo4j.py,sha256=VZYkA53gWKpR8LUHzzrOJoaak4Fud3gz4ZaDih1PqNc,18835
-topologicpy/Plotly.py,sha256=DZbkrmjOr2c7uFHoWk6Uj2r54jCN_VDxzVMUcZagU18,94980
+topologicpy/Plotly.py,sha256=SD7UUsmF_8aoZTJr4pWkzbOqs-QnZiNJwK513bVZr3c,96060
 topologicpy/Polyskel.py,sha256=MYHKFOQBlUNqoUhAdOcKRIHpSk0dWWVrZgXK34NkvFM,15936
 topologicpy/Shell.py,sha256=rnlnMRxY-KxJPpzr4oXy9m1I1QRQj1qhY8UXBgH8Pu8,74563
 topologicpy/Speckle.py,sha256=rUS6PCaxIjEF5_fUruxvMH47FMKg-ohcoU0qAUb-yNM,14267
 topologicpy/Sun.py,sha256=jUokWlwlRaPFa3wC2-flIpE9gBae0YYSP73N_41VsNQ,36723
-topologicpy/Topology.py,sha256=dE0LbZwPGQyzZYYZqN1W2FwszPEDTXIIXpkOFgRD2kw,304932
+topologicpy/Topology.py,sha256=Kq2ith3UpiKGGAkLMieMUzj7R5MeJkjIFmvM05Bi9TM,305004
 topologicpy/Vector.py,sha256=apFuFOmi0WC3QWJ6O5LfLUyVvGOYWTTCTm26g3dKQrQ,29589
 topologicpy/Vertex.py,sha256=fHp2BarCGWiuJeMarDuLfSKGEqSFOulh7bd22siVl5A,64925
 topologicpy/Wire.py,sha256=sBYVsIj9QxEXOvNtjDqFaO2N2r1ZlairTn_HSW9rOiQ,128857
 topologicpy/__init__.py,sha256=D7ky87CAQMiS2KE6YLvcTLkTgA2PY7rASe6Z23pjp9k,872
-topologicpy/version.py,sha256=gMDttCkJF3h8Jr3eq_8NuJj26-9xyjg-YjR2bSNcGxM,22
-topologicpy-0.6.2.dist-info/LICENSE,sha256=TfPDBt3ar0uv_f9cqCDMZ5rIzW3CY8anRRd4PkL6ejs,34522
-topologicpy-0.6.2.dist-info/METADATA,sha256=OqDWsF7OV8X8rORRAY9ieKqPVhtHTImgj-MyXbyIy7M,46950
-topologicpy-0.6.2.dist-info/WHEEL,sha256=GJ7t_kWBFywbagK5eo9IoUwLW6oyOeTKmQ-9iHFVNxQ,92
-topologicpy-0.6.2.dist-info/top_level.txt,sha256=J30bDzW92Ob7hw3zA8V34Jlp-vvsfIkGzkr8sqvb4Uw,12
-topologicpy-0.6.2.dist-info/RECORD,,
+topologicpy/version.py,sha256=0ICX8PeSmWoiPyIEViMxRYkvCjQE1KvQPJp9o52KRjw,22
+topologicpy-0.6.3.dist-info/LICENSE,sha256=TfPDBt3ar0uv_f9cqCDMZ5rIzW3CY8anRRd4PkL6ejs,34522
+topologicpy-0.6.3.dist-info/METADATA,sha256=M0vA662BFgcuvTG5D29My1Q5MFjfC1eDRRm-zHCahGk,46950
+topologicpy-0.6.3.dist-info/WHEEL,sha256=GJ7t_kWBFywbagK5eo9IoUwLW6oyOeTKmQ-9iHFVNxQ,92
+topologicpy-0.6.3.dist-info/top_level.txt,sha256=J30bDzW92Ob7hw3zA8V34Jlp-vvsfIkGzkr8sqvb4Uw,12
+topologicpy-0.6.3.dist-info/RECORD,,