kececilayout 0.4.6__py3-none-any.whl → 0.4.8__py3-none-any.whl

kececilayout/__init__.py

@@ -10,7 +10,7 @@ import inspect
 import warnings
 
 # Paket sürüm numarası
-__version__ = "0.4.6"
+__version__ = "0.4.8"
 
 # =============================================================================
 # OTOMATİK İÇE AKTARMA VE __all__ OLUŞTURMA
@@ -40,6 +40,8 @@ from .kececi_layout import (  # Veya fonksiyonların bulunduğu asıl modül
     kececi_layout_graphillion,
     kececi_layout_rx,
     kececi_layout_rustworkx,
+    kececi_layout_gt,
+    kececi_layout_graph_tool,
     kececi_layout_pure,
     load_element_data_and_spectral_lines,
     wavelength_to_rgb,
@@ -78,6 +80,8 @@ __all__ = [
     'kececi_layout_graphillion',
     'kececi_layout_rx',
     'kececi_layout_rustworkx',
+    'kececi_layout_gt',
+    'kececi_layout_graph_tool',
     'kececi_layout_pure',
     'load_element_data_and_spectral_lines',
     'wavelength_to_rgb',
@@ -135,12 +139,3 @@ def old_function_placeholder():
 # Eğer bu eski fonksiyonu da dışa aktarmak istiyorsanız, __all__ listesine ekleyin
 # __all__.append('old_function_placeholder')
 
-
-
-
-
-
-
-
-
-

kececilayout/_version.py

@@ -1,9 +1,11 @@
 # _version.py
 
-__version__ = "0.4.6"
+__version__ = "0.4.8"
 __license__ = "MIT"
 __description__ = "A deterministic node placement algorithm used in graph visualization. In this layout, nodes are arranged sequentially along a defined primary axis. Each subsequent node is then alternately offset along a secondary, perpendicular axis, typically moving to one side of the primary axis and then the other. Often, the magnitude of this secondary offset increases as nodes progress along the primary axis, creating a characteristic zig-zag or serpentine pattern."
 __author__ = "Mehmet Keçeci"
 __url__ = "https://github.com/WhiteSymmetry/kececilayout"
 __docs__ = "https://github.com/WhiteSymmetry/kececilayout"  # Opsiyonel: Dokümantasyon linki
 __dependencies__ = ["python>=3.10"]  # Diğer bağımlılıkları da ekleyebilirsiniz
+
+

kececilayout/kececi_layout.py

@@ -16,6 +16,7 @@ from mpl_toolkits.mplot3d import Axes3D
 import networkit as nk
 import networkx as nx
 import numpy as np # rustworkx
+import platform # graph_tool için
 import random
 import rustworkx as rx
 import warnings
@@ -48,6 +49,14 @@ try:
     import graphillion as gg
 except ImportError:
     gg = None
+# graph-tool sadece Linux'ta import edilsin
+if platform.system() == "Linux":
+    try:
+        import graph_tool.all as gt
+    except ImportError:
+        gt = None
+else:
+    gt = None
 
 
 def find_max_node_id(edges):
@@ -89,9 +98,8 @@ def kececi_layout(graph, primary_spacing=1.0, secondary_spacing=1.0,
                   expanding=True):
     """
     Calculates 2D sequential-zigzag coordinates for the nodes of a graph.
-
     This function is compatible with graphs from NetworkX, Rustworkx, igraph,
-    Networkit, and Graphillion.
+    Networkit, Graphillion, and graph-tool.
 
     Args:
         graph: A graph object from a supported library.
@@ -105,26 +113,41 @@ def kececi_layout(graph, primary_spacing=1.0, secondary_spacing=1.0,
     Returns:
         dict: A dictionary of positions formatted as {node_id: (x, y)}.
     """
-    # Bu blok, farklı kütüphanelerden düğüm listelerini doğru şekilde alır.
-    nx_graph = to_networkx(graph) # Emin olmak için en başta dönüştür
-    try:
-        nodes = sorted(list(nx_graph.nodes()))
-    except TypeError:
-        nodes = list(nx_graph.nodes())
+    nodes = None
+
+    # graph-tool desteği
+    if gt and isinstance(graph, gt.Graph):
+        nodes = sorted([int(v) for v in graph.get_vertices()])
+    elif gg and isinstance(graph, gg.GraphSet):
+        edges = graph.universe()
+        max_node_id = max(set(itertools.chain.from_iterable(edges))) if edges else 0
+        nodes = list(range(1, max_node_id + 1)) if max_node_id > 0 else []
+    elif ig and isinstance(graph, ig.Graph):
+        nodes = sorted([v.index for v in graph.vs])
+    elif nk and isinstance(graph, nk.graph.Graph):
+        nodes = sorted(list(graph.iterNodes()))
+    elif rx and isinstance(graph, (rx.PyGraph, rx.PyDiGraph)):
+        nodes = sorted(graph.node_indices())
+    elif isinstance(graph, nx.Graph):
+        try:
+            nodes = sorted(list(graph.nodes()))
+        except TypeError:
+            nodes = list(graph.nodes())
+    else:
+        supported = ["NetworkX", "Rustworkx", "igraph", "Networkit", "Graphillion"]
+        if gt:
+            supported.append("graph-tool")
+        raise TypeError(f"Unsupported graph type: {type(graph)}. Supported: {', '.join(supported)}")
 
     pos = {}
-    
-    # --- DOĞRULANMIŞ KONTROL BLOĞU ---
     is_vertical = primary_direction in ['top_down', 'bottom_up']
     is_horizontal = primary_direction in ['left-to-right', 'right-to-left']
-
     if not (is_vertical or is_horizontal):
         raise ValueError(f"Invalid primary_direction: '{primary_direction}'")
     if is_vertical and secondary_start not in ['right', 'left']:
         raise ValueError(f"Invalid secondary_start for vertical direction: '{secondary_start}'")
     if is_horizontal and secondary_start not in ['up', 'down']:
         raise ValueError(f"Invalid secondary_start for horizontal direction: '{secondary_start}'")
-    # --- BİTİŞ ---
 
     for i, node_id in enumerate(nodes):
         primary_coord, secondary_axis = 0.0, ''
@@ -134,16 +157,14 @@ def kececi_layout(graph, primary_spacing=1.0, secondary_spacing=1.0,
             primary_coord, secondary_axis = i * primary_spacing, 'x'
         elif primary_direction == 'left-to-right':
             primary_coord, secondary_axis = i * primary_spacing, 'y'
-        else:
+        else:  # 'right-to-left'
             primary_coord, secondary_axis = i * -primary_spacing, 'y'
-
         secondary_offset = 0.0
         if i > 0:
             start_multiplier = 1.0 if secondary_start in ['right', 'up'] else -1.0
             magnitude = math.ceil(i / 2.0) if expanding else 1.0
             side = 1 if i % 2 != 0 else -1
             secondary_offset = start_multiplier * magnitude * side * secondary_spacing
-
         x, y = ((secondary_offset, primary_coord) if secondary_axis == 'x' else
                 (primary_coord, secondary_offset))
         pos[node_id] = (x, y)
@@ -157,18 +178,17 @@ def kececi_layout(graph, primary_spacing=1.0, secondary_spacing=1.0,
 
 def kececi_layout_v4(graph, primary_spacing=1.0, secondary_spacing=1.0,
                   primary_direction='top_down', secondary_start='right',
-                  expanding=True): # v4 davranışını kontrol etmek için parametre eklendi
+                  expanding=True):
     """
     Calculates 2D sequential-zigzag coordinates for the nodes of a graph.
-
     This function is compatible with graphs from NetworkX, Rustworkx, igraph,
-    Networkit, and Graphillion.
+    Networkit, Graphillion, and graph-tool.
 
     Args:
         graph: A graph object from a supported library.
         primary_spacing (float): The distance between nodes along the primary axis.
         secondary_spacing (float): The base unit for the zigzag offset.
-        primary_direction (str): 'top_down', 'bottom_up', 'left_to_right', 'right_to_left'.
+        primary_direction (str): 'top_down', 'bottom_up', 'left-to-right', 'right-to-left'.
         secondary_start (str): Initial direction for the zigzag ('up', 'down', 'left', 'right').
         expanding (bool): If True (default), the zigzag offset grows, creating the
                           triangle-like 'v4' style. If False, the offset is constant,
@@ -177,12 +197,12 @@ def kececi_layout_v4(graph, primary_spacing=1.0, secondary_spacing=1.0,
     Returns:
         dict: A dictionary of positions formatted as {node_id: (x, y)}.
     """
-    # ==========================================================
-    # Sizin orijinal, çoklu kütüphane uyumluluk bloğunuz burada korunuyor.
-    # Bu, kodun sağlamlığını garanti eder.
-    # ==========================================================
     nodes = None
-    if gg and isinstance(graph, gg.GraphSet):
+
+    # graph-tool desteği
+    if gt and isinstance(graph, gt.Graph):
+        nodes = sorted([int(v) for v in graph.get_vertices()])
+    elif gg and isinstance(graph, gg.GraphSet):
         edges = graph.universe()
         max_node_id = max(set(itertools.chain.from_iterable(edges))) if edges else 0
         nodes = list(range(1, max_node_id + 1)) if max_node_id > 0 else []
@@ -199,13 +219,13 @@ def kececi_layout_v4(graph, primary_spacing=1.0, secondary_spacing=1.0,
             nodes = list(graph.nodes())
     else:
         supported = ["NetworkX", "Rustworkx", "igraph", "Networkit", "Graphillion"]
+        if gt:
+            supported.append("graph-tool")
         raise TypeError(f"Unsupported graph type: {type(graph)}. Supported: {', '.join(supported)}")
-    # ==========================================================
 
     pos = {}
     is_vertical = primary_direction in ['top_down', 'bottom_up']
     is_horizontal = primary_direction in ['left-to-right', 'right-to-left']
-
     if not (is_vertical or is_horizontal):
         raise ValueError(f"Invalid primary_direction: {primary_direction}")
     if is_vertical and secondary_start not in ['right', 'left']:
@@ -221,24 +241,17 @@ def kececi_layout_v4(graph, primary_spacing=1.0, secondary_spacing=1.0,
             primary_coord, secondary_axis = i * primary_spacing, 'x'
         elif primary_direction == 'left-to-right':
             primary_coord, secondary_axis = i * primary_spacing, 'y'
-        else:  # 'right_to_left'
+        else:  # 'right-to-left'
             primary_coord, secondary_axis = i * -primary_spacing, 'y'
-
         secondary_offset = 0.0
         if i > 0:
             start_multiplier = 1.0 if secondary_start in ['right', 'up'] else -1.0
-            
-            # --- YENİ ESNEK MANTIK BURADA ---
-            # `expanding` True ise 'v4' stili gibi genişler, değilse sabit kalır.
             magnitude = math.ceil(i / 2.0) if expanding else 1.0
-            
             side = 1 if i % 2 != 0 else -1
             secondary_offset = start_multiplier * magnitude * side * secondary_spacing
-
         x, y = ((secondary_offset, primary_coord) if secondary_axis == 'x' else
                 (primary_coord, secondary_offset))
         pos[node_id] = (x, y)
-
     return pos
 
 def kececi_layout_nx(graph, primary_spacing=1.0, secondary_spacing=1.0,
@@ -877,6 +890,98 @@ def kececi_layout_rustworkx(graph: "rx.PyGraph", primary_spacing=1.0, secondary_
         
     return pos
 
+def kececi_layout_gt(graph: "gt.Graph", primary_spacing=1.0, secondary_spacing=1.0,
+                             primary_direction='top_down', secondary_start='right',
+                             expanding=True):
+    """
+    Expanding Kececi Layout: Progresses along the primary axis, with an offset
+    on the secondary axis.
+    Kececi layout for a graph-tool graph object.
+    Args:
+        graph (graph_tool.Graph): A graph-tool graph object.
+        primary_spacing (float): The spacing between nodes on the primary axis.
+        secondary_spacing (float): The offset spacing on the secondary axis.
+        primary_direction (str): 'top_down', 'bottom_up', 'left-to-right', 'right-to-left'.
+        secondary_start (str): Initial direction for the offset ('right', 'left', 'up', 'down').
+    Returns:
+        dict: A dictionary of positions keyed by node index.
+    """
+    nodes = sorted([int(v) for v in graph.vertices()])
+    pos = {}
+    is_vertical = primary_direction in ['top_down', 'bottom_up']
+    is_horizontal = primary_direction in ['left-to-right', 'right-to-left']
+    if not (is_vertical or is_horizontal):
+        raise ValueError(f"Invalid primary_direction: {primary_direction}")
+    if is_vertical and secondary_start not in ['right', 'left']:
+        raise ValueError(f"Invalid secondary_start for vertical direction: {secondary_start}")
+    if is_horizontal and secondary_start not in ['up', 'down']:
+        raise ValueError(f"Invalid secondary_start for horizontal direction: {secondary_start}")
+
+    for i, node_id in enumerate(nodes):
+        if primary_direction == 'top_down':
+            primary_coord, secondary_axis = i * -primary_spacing, 'x'
+        elif primary_direction == 'bottom_up':
+            primary_coord, secondary_axis = i * primary_spacing, 'x'
+        elif primary_direction == 'left-to-right':
+            primary_coord, secondary_axis = i * primary_spacing, 'y'
+        else:
+            primary_coord, secondary_axis = i * -primary_spacing, 'y'
+        secondary_offset = 0.0
+        if i > 0:
+            start_multiplier = 1.0 if secondary_start in ['right', 'up'] else -1.0
+            magnitude = math.ceil(i / 2.0) if expanding else 1.0
+            side = 1 if i % 2 != 0 else -1
+            secondary_offset = start_multiplier * magnitude * side * secondary_spacing
+        x, y = (secondary_offset, primary_coord) if secondary_axis == 'x' else (primary_coord, secondary_offset)
+        pos[node_id] = (x, y)
+    return pos
+
+def kececi_layout_graph_tool(graph: "gt.Graph", primary_spacing=1.0, secondary_spacing=1.0,
+                             primary_direction='top_down', secondary_start='right',
+                             expanding=True):
+    """
+    Expanding Kececi Layout: Progresses along the primary axis, with an offset
+    on the secondary axis.
+    Kececi layout for a graph-tool graph object.
+    Args:
+        graph (graph_tool.Graph): A graph-tool graph object.
+        primary_spacing (float): The spacing between nodes on the primary axis.
+        secondary_spacing (float): The offset spacing on the secondary axis.
+        primary_direction (str): 'top_down', 'bottom_up', 'left-to-right', 'right-to-left'.
+        secondary_start (str): Initial direction for the offset ('right', 'left', 'up', 'down').
+    Returns:
+        dict: A dictionary of positions keyed by node index.
+    """
+    nodes = sorted([int(v) for v in graph.vertices()])
+    pos = {}
+    is_vertical = primary_direction in ['top_down', 'bottom_up']
+    is_horizontal = primary_direction in ['left-to-right', 'right-to-left']
+    if not (is_vertical or is_horizontal):
+        raise ValueError(f"Invalid primary_direction: {primary_direction}")
+    if is_vertical and secondary_start not in ['right', 'left']:
+        raise ValueError(f"Invalid secondary_start for vertical direction: {secondary_start}")
+    if is_horizontal and secondary_start not in ['up', 'down']:
+        raise ValueError(f"Invalid secondary_start for horizontal direction: {secondary_start}")
+
+    for i, node_id in enumerate(nodes):
+        if primary_direction == 'top_down':
+            primary_coord, secondary_axis = i * -primary_spacing, 'x'
+        elif primary_direction == 'bottom_up':
+            primary_coord, secondary_axis = i * primary_spacing, 'x'
+        elif primary_direction == 'left-to-right':
+            primary_coord, secondary_axis = i * primary_spacing, 'y'
+        else:
+            primary_coord, secondary_axis = i * -primary_spacing, 'y'
+        secondary_offset = 0.0
+        if i > 0:
+            start_multiplier = 1.0 if secondary_start in ['right', 'up'] else -1.0
+            magnitude = math.ceil(i / 2.0) if expanding else 1.0
+            side = 1 if i % 2 != 0 else -1
+            secondary_offset = start_multiplier * magnitude * side * secondary_spacing
+        x, y = (secondary_offset, primary_coord) if secondary_axis == 'x' else (primary_coord, secondary_offset)
+        pos[node_id] = (x, y)
+    return pos
+
 def kececi_layout_pure(nodes, primary_spacing=1.0, secondary_spacing=1.0,
                          primary_direction='top_down', secondary_start='right',
                          expanding=True):
@@ -1113,7 +1218,7 @@ def to_networkx(graph):
         return graph.copy()
     
     nx_graph = nx.Graph()
-    
+    """
     # PyZX graph support
     try:
         import pyzx as zx
@@ -1122,11 +1227,43 @@ def to_networkx(graph):
             for v in graph.vertices():
                 nx_graph.add_node(v)
             for edge in graph.edges():
-                if len(edge) == 2:
+                if len(edge) == 2: # TypeError: object of type 'Edge' has no len()
                     nx_graph.add_edge(edge[0], edge[1])
             return nx_graph
     except ImportError:
         pass
+    """
+
+    # PyZX graph support
+    try:
+        import pyzx as zx
+        if hasattr(graph, 'vertices') and hasattr(graph, 'edges'):
+            for v in graph.vertices():
+                nx_graph.add_node(v)
+            for edge in graph.edges():
+                # PyZX kenarları için doğru erişim
+                u, v = edge.u, edge.v  # PyZX kenarları için uygun erişim
+                nx_graph.add_edge(u, v)
+            return nx_graph
+    except ImportError:
+        pass
+    except AttributeError:
+        pass  # PyZX kenarları için uygun erişim yoksa, bu bloğu atla
+
+    # graph-tool desteği
+    if gt and isinstance(graph, gt.Graph):
+        # Düğümleri ekle
+        for v in graph.vertices():
+            node_id = int(v)
+            nx_graph.add_node(node_id)
+
+        # Kenarları ekle
+        for e in graph.edges():
+            source = int(e.source())
+            target = int(e.target())
+            nx_graph.add_edge(source, target)
+
+        return nx_graph
     
     # Diğer graph kütüphaneleri...
     if rx and isinstance(graph, (rx.PyGraph, rx.PyDiGraph)):
@@ -1392,7 +1529,7 @@ def draw_kececi(graph, style='curved', ax=None, **kwargs):
     Draws a graph using the Keçeci Layout with a specified style.
 
     This function automatically handles graphs from different libraries
-    (NetworkX, Rustworkx, igraph, etc.).
+    (Networkx, Networkit, Rustworkx, igraph, Graphillion, graph-tool,etc.).
 
     Args:
         graph: The graph object to be drawn.
@@ -1432,18 +1569,29 @@ if __name__ == '__main__':
     print("Testing kececilayout.py module...")
     G_test = nx.gnp_random_graph(12, 0.3, seed=42)
 
+    # graph-tool grafi oluşturma ve test etme
+    if gt:
+        g = gt.Graph()
+        g.add_vertex(12)
+        for u, v in G_test.edges():
+            g.add_edge(g.vertex(u), g.vertex(v))
+        fig_gt = plt.figure(figsize=(10, 8))
+        draw_kececi(g, ax=fig_gt.add_subplot(111), style='curved')
+        plt.title("Keçeci Layout: graph-tool Graph")
+        plt.show()
+
     # Compare expanding=False (parallel) vs. expanding=True ('v4' style)
     fig_v4 = plt.figure(figsize=(16, 7))
     fig_v4.suptitle("Effect of the `expanding` Parameter", fontsize=20)
     ax_v4_1 = fig_v4.add_subplot(1, 2, 1)
     draw_kececi(G_test, ax=ax_v4_1, style='curved',
-                primary_direction='left_to_right', secondary_start='up',
+                primary_direction='left-to-right', secondary_start='up',
                 expanding=False)
     ax_v4_1.set_title("Parallel Style (expanding=False)", fontsize=16)
 
     ax_v4_2 = fig_v4.add_subplot(1, 2, 2)
     draw_kececi(G_test, ax=ax_v4_2, style='curved',
-                primary_direction='left_to_right', secondary_start='up',
+                primary_direction='left-to-right', secondary_start='up',
                 expanding=True)
     ax_v4_2.set_title("Expanding 'v4' Style (expanding=True)", fontsize=16)
     plt.show()
@@ -1452,11 +1600,9 @@ if __name__ == '__main__':
     fig_styles = plt.figure(figsize=(18, 12))
     fig_styles.suptitle("Advanced Drawing Styles Test", fontsize=20)
     draw_kececi(G_test, style='curved', ax=fig_styles.add_subplot(2, 2, 1),
-                primary_direction='left_to_right', secondary_start='up', expanding=True)
+                primary_direction='left-to-right', secondary_start='up', expanding=True)
     draw_kececi(G_test, style='transparent', ax=fig_styles.add_subplot(2, 2, 2),
                 primary_direction='top_down', secondary_start='left', expanding=True, node_color='purple')
     draw_kececi(G_test, style='3d', ax=fig_styles.add_subplot(2, 2, (3, 4), projection='3d'))
     plt.tight_layout(rect=[0, 0, 1, 0.96])
     plt.show()
-
-

{kececilayout-0.4.6.dist-info → kececilayout-0.4.8.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: kececilayout
-Version: 0.4.6
+Version: 0.4.8
 Summary: Çeşitli graf kütüphaneleri için sıralı-zigzag yerleşimleri sağlayan bir Python paketi.
 Home-page: https://github.com/WhiteSymmetry/kececilayout
 Author: Mehmet Keçeci
@@ -53,6 +53,7 @@ Requires-Dist: python-louvain; extra == "test"
 Requires-Dist: rustworkx; extra == "test"
 Requires-Dist: networkit; extra == "test"
 Requires-Dist: graphillion; extra == "test"
+Requires-Dist: graph-tool; extra == "test"
 Dynamic: author
 Dynamic: home-page
 Dynamic: license-file
@@ -228,7 +229,7 @@ try:
     import kececilayout as kl
 except ImportError:
     print("Error: 'kececi_layout.py' not found or could not be imported.")
-    print("Please ensure the file containing kececi_layout_v4 is accessible.")
+    print("Please ensure the file containing kececi_layout is accessible.")
     exit()
 
 # --- General Layout Parameters ---
@@ -252,7 +253,7 @@ try:
     # Calculate layout
     print("Calculating Keçeci Layout...")
     # Call the layout function from the imported module
-    pos_rx = kl.kececi_layout_v4(G_rx, **LAYOUT_PARAMS)
+    pos_rx = kl.kececi_layout(G_rx, **LAYOUT_PARAMS)
     # print("Rustworkx positions:", pos_rx) # Debug print if needed
 
     # Plot using Matplotlib directly (Rustworkx doesn't have a built-in draw)
@@ -322,7 +323,7 @@ try:
     import kececilayout as kl
 except ImportError:
     print("Error: 'kececi_layout.py' not found or could not be imported.")
-    print("Please ensure the file containing kececi_layout_v4 is accessible.")
+    print("Please ensure the file containing kececi_layout is accessible.")
     exit()
 
 # --- General Layout Parameters ---
@@ -355,7 +356,7 @@ try:
     # Calculate layout
     print("Calculating Keçeci Layout...")
     # Call the layout function from the imported module
-    pos_nk = kl.kececi_layout_v4(G_nk, **LAYOUT_PARAMS)
+    pos_nk = kl.kececi_layout(G_nk, **LAYOUT_PARAMS)
     # print("Networkit positions:", pos_nk) # Debug print if needed
 
     # Plot using Matplotlib directly (Networkit doesn't have a simple built-in draw)
@@ -409,6 +410,8 @@ print("\n--- Networkit Example Finished ---")
 
 ![Networkit Example](https://github.com/WhiteSymmetry/kececilayout/blob/main/examples/nk-1.png?raw=true)
 
+---
+
 #### Example with Graphillion
 
 ```python
@@ -425,7 +428,7 @@ try:
     import kececilayout as kl
 except ImportError:
     print("Error: 'kececi_layout.py' not found or could not be imported.")
-    print("Please ensure the file containing kececi_layout_v4 is accessible.")
+    print("Please ensure the file containing kececi_layout is accessible.")
     exit()
 
 # --- General Layout Parameters ---
@@ -459,7 +462,7 @@ try:
     print("Calculating Keçeci Layout...")
     # Call the layout function; it should handle the Graphillion GraphSet object
     # and likely use 1-based indexing based on the universe.
-    pos_gg = kl.kececi_layout_v4(gs, **LAYOUT_PARAMS)
+    pos_gg = kl.kececi_layout(gs, **LAYOUT_PARAMS)
     # print("Graphillion positions:", pos_gg) # Debug print if needed
 
     # Plot using Matplotlib directly (Graphillion has no plotting)
@@ -517,6 +520,90 @@ print("\n--- Graphillion Example Finished ---")
 
 ---
 
+#### Example with graph-tool
+
+```python
+import matplotlib.pyplot as plt
+from matplotlib.collections import LineCollection
+import graph_tool.all as gt
+import kececilayout as kl
+
+# --- General Layout Parameters ---
+LAYOUT_PARAMS = {
+    'primary_spacing': 1.0,
+    'secondary_spacing': 0.6,
+    'primary_direction': 'top_down',
+    'secondary_start': 'right'
+}
+
+N_NODES = 10  # Number of nodes in the example graph
+
+try:
+    print("\n--- graph-tool Example ---")
+
+    # Create a graph-tool Graph
+    g = gt.Graph(directed=False)
+
+    # Add nodes
+    nodes = [g.add_vertex() for _ in range(N_NODES)]
+
+    # Add edges (1-2, 2-3, ..., (N_NODES-1)-N_NODES)
+    for i in range(N_NODES - 1):
+        g.add_edge(nodes[i], nodes[i + 1])
+
+    # Calculate layout using kececilayout_v4
+    print("Calculating Keçeci Layout...")
+    pos_gt = kl.kececi_layout(g, **LAYOUT_PARAMS)
+
+    # Plot using Matplotlib
+    print("Plotting graph using Matplotlib...")
+    plt.figure(figsize=(6, 8))
+    ax = plt.gca()
+
+    # Extract node positions
+    node_indices_gt = list(range(N_NODES))
+    x_coords_gt = [pos_gt[i][0] for i in node_indices_gt]
+    y_coords_gt = [pos_gt[i][1] for i in node_indices_gt]
+
+    # Draw nodes
+    ax.scatter(x_coords_gt, y_coords_gt, s=700, c='gold', zorder=2, label='Nodes')
+
+    # Draw labels
+    for i in node_indices_gt:
+        ax.text(pos_gt[i][0], pos_gt[i][1], str(i + 1), ha='center', va='center', fontsize=10, zorder=3)
+
+    # Draw edges
+    edge_lines_gt = []
+    for edge in g.edges():
+        source = int(edge.source())
+        target = int(edge.target())
+        edge_lines_gt.append([pos_gt[source], pos_gt[target]])
+
+    if edge_lines_gt:
+        lc_gt = LineCollection(edge_lines_gt, colors='gray', linewidths=1.0, zorder=1, label='Edges')
+        ax.add_collection(lc_gt)
+
+    plt.title(f"graph-tool ({N_NODES} Nodes) with Keçeci Layout (Matplotlib)")
+    plt.xlabel("X Coordinate")
+    plt.ylabel("Y Coordinate")
+    plt.axis('equal')
+    plt.grid(False)
+    plt.show()
+
+except ImportError:
+    print("graph-tool is not installed. Skipping this example.")
+except Exception as e:
+    print(f"An error occurred in the graph-tool example: {e}")
+    import traceback
+    traceback.print_exc()
+
+print("\n--- graph-tool Example Finished ---")
+```
+
+![graph-tool Example](https://github.com/WhiteSymmetry/kececilayout/blob/main/examples/gt-1.png?raw=true)
+
+---
+
 ### Supported Backends
 
 - **NetworkX**
@@ -524,8 +611,9 @@ print("\n--- Graphillion Example Finished ---")
 - **Rustworkx**
 - **Networkit**
 - **Graphillion**
+- **graph-tool**
 
-*Note: All backends are supported via unified `kececi_layout_v4` function.*
+*Note: All backends are supported via unified `kececi_layout` function.*
 
 ---
 
@@ -641,7 +729,7 @@ try:
     import kececilayout as kl
 except ImportError:
     print("Error: 'kececi_layout.py' not found or could not be imported.")
-    print("Please ensure the file containing kececi_layout_v4 is accessible.")
+    print("Please ensure the file containing kececi_layout is accessible.")
     exit()
 
 # --- General Layout Parameters ---
@@ -665,7 +753,7 @@ try:
     # Calculate layout
     print("Calculating Keçeci Layout...")
     # Call the layout function from the imported module
-    pos_ig = kl.kececi_layout_v4(G_ig, **LAYOUT_PARAMS)
+    pos_ig = kl.kececi_layout(G_ig, **LAYOUT_PARAMS)
     # print("igraph positions (dict):", pos_ig) # Debug print if needed
 
     # Convert positions dict to list ordered by vertex index for ig.plot
@@ -732,7 +820,7 @@ try:
     import kececilayout as kl
 except ImportError:
     print("Error: 'kececi_layout.py' not found or could not be imported.")
-    print("Please ensure the file containing kececi_layout_v4 is accessible.")
+    print("Please ensure the file containing kececi_layout is accessible.")
     exit()
 
 # --- General Layout Parameters ---
@@ -756,7 +844,7 @@ try:
     # Calculate layout
     print("Calculating Keçeci Layout...")
     # Call the layout function from the imported module
-    pos_rx = kl.kececi_layout_v4(G_rx, **LAYOUT_PARAMS)
+    pos_rx = kl.kececi_layout(G_rx, **LAYOUT_PARAMS)
     # print("Rustworkx positions:", pos_rx) # Debug print if needed
 
     # Plot using Matplotlib directly (Rustworkx doesn't have a built-in draw)
@@ -826,7 +914,7 @@ try:
     import kececilayout as kl
 except ImportError:
     print("Error: 'kececi_layout.py' not found or could not be imported.")
-    print("Please ensure the file containing kececi_layout_v4 is accessible.")
+    print("Please ensure the file containing kececi_layout is accessible.")
     exit()
 
 # --- General Layout Parameters ---
@@ -859,7 +947,7 @@ try:
     # Calculate layout
     print("Calculating Keçeci Layout...")
     # Call the layout function from the imported module
-    pos_nk = kl.kececi_layout_v4(G_nk, **LAYOUT_PARAMS)
+    pos_nk = kl.kececi_layout(G_nk, **LAYOUT_PARAMS)
     # print("Networkit positions:", pos_nk) # Debug print if needed
 
     # Plot using Matplotlib directly (Networkit doesn't have a simple built-in draw)
@@ -929,7 +1017,7 @@ try:
     import kececilayout as kl
 except ImportError:
     print("Error: 'kececi_layout.py' not found or could not be imported.")
-    print("Please ensure the file containing kececi_layout_v4 is accessible.")
+    print("Please ensure the file containing kececi_layout is accessible.")
     exit()
 
 # --- General Layout Parameters ---
@@ -963,7 +1051,7 @@ try:
     print("Calculating Keçeci Layout...")
     # Call the layout function; it should handle the Graphillion GraphSet object
     # and likely use 1-based indexing based on the universe.
-    pos_gg = kl.kececi_layout_v4(gs, **LAYOUT_PARAMS)
+    pos_gg = kl.kececi_layout(gs, **LAYOUT_PARAMS)
     # print("Graphillion positions:", pos_gg) # Debug print if needed
 
     # Plot using Matplotlib directly (Graphillion has no plotting)
@@ -1028,8 +1116,9 @@ print("\n--- Graphillion Example Finished ---")
 - **Rustworkx**
 - **Networkit**
 - **Graphillion**
+- **graph-tool**
 
-*Not: Tüm kütüphaneler `kececi_layout_v4` fonksiyonu ile desteklenir.*
+*Not: Tüm kütüphaneler `kececi_layout` fonksiyonu ile desteklenir.*
 
 ---
 
@@ -1231,8 +1320,8 @@ import random
 G = nx.path_graph(10)
 
 # Calculate layout positions using the generic function
-# (Assuming kl.kececi_layout_v4 is the main/generic function)
-pos = kl.kececi_layout_v4(G,
+# (Assuming kl.kececi_layout is the main/generic function)
+pos = kl.kececi_layout(G,
                            primary_spacing=1.0,
                            secondary_spacing=0.5,
                            primary_direction='top_down',
@@ -1257,7 +1346,7 @@ try:
     import kececilayout as kl
 except ImportError:
     print("Error: 'kececi_layout.py' not found or could not be imported.")
-    print("Please ensure the file containing kececi_layout_v4 is accessible.")
+    print("Please ensure the file containing kececi_layout is accessible.")
     exit()
 
 # --- General Layout Parameters ---
@@ -1281,7 +1370,7 @@ try:
     # Calculate layout
     print("Calculating Keçeci Layout...")
     # Call the layout function from the imported module
-    pos_nx = kl.kececi_layout_v4(G_nx, **LAYOUT_PARAMS)
+    pos_nx = kl.kececi_layout(G_nx, **LAYOUT_PARAMS)
     # print("NetworkX positions:", pos_nx) # Debug print if needed
 
     # Plot
@@ -1320,7 +1409,7 @@ print("\n--- NetworkX Example Finished ---")
 import igraph as ig
 import matplotlib.pyplot as plt
 # Assuming a specific function for igraph exists or the generic one handles it
-from kececilayout import kececi_layout_v4_igraph # Adjust import if needed
+from kececilayout import kececi_layout_igraph # Adjust import if needed
 import random
 
 # Create a graph
@@ -1329,7 +1418,7 @@ for i in range(G.vcount()):
      G.vs[i]["name"] = f"N{i}"
 
 # Calculate layout positions (returns a list of coords)
-pos_list = kececi_layout_v4_igraph(G,
+pos_list = kececi_layout_igraph(G,
                                     primary_spacing=1.5,
                                     secondary_spacing=1.0,
                                     primary_direction='left-to-right',
@@ -1362,7 +1451,7 @@ try:
     import kececilayout as kl
 except ImportError:
     print("Error: 'kececi_layout.py' not found or could not be imported.")
-    print("Please ensure the file containing kececi_layout_v4 is accessible.")
+    print("Please ensure the file containing kececi_layout is accessible.")
     exit()
 
 # --- General Layout Parameters ---
@@ -1386,7 +1475,7 @@ try:
     # Calculate layout
     print("Calculating Keçeci Layout...")
     # Call the layout function from the imported module
-    pos_ig = kl.kececi_layout_v4(G_ig, **LAYOUT_PARAMS)
+    pos_ig = kl.kececi_layout(G_ig, **LAYOUT_PARAMS)
     # print("igraph positions (dict):", pos_ig) # Debug print if needed
 
     # Convert positions dict to list ordered by vertex index for ig.plot
@@ -1455,7 +1544,7 @@ try:
     import kececilayout as kl
 except ImportError:
     print("Error: 'kececi_layout.py' not found or could not be imported.")
-    print("Please ensure the file containing kececi_layout_v4 is accessible.")
+    print("Please ensure the file containing kececi_layout is accessible.")
     exit()
 
 # --- General Layout Parameters ---
@@ -1479,7 +1568,7 @@ try:
     # Calculate layout
     print("Calculating Keçeci Layout...")
     # Call the layout function from the imported module
-    pos_rx = kl.kececi_layout_v4(G_rx, **LAYOUT_PARAMS)
+    pos_rx = kl.kececi_layout(G_rx, **LAYOUT_PARAMS)
     # print("Rustworkx positions:", pos_rx) # Debug print if needed
 
     # Plot using Matplotlib directly (Rustworkx doesn't have a built-in draw)
@@ -1551,7 +1640,7 @@ try:
     import kececilayout as kl
 except ImportError:
     print("Error: 'kececi_layout.py' not found or could not be imported.")
-    print("Please ensure the file containing kececi_layout_v4 is accessible.")
+    print("Please ensure the file containing kececi_layout is accessible.")
     exit()
 
 # --- General Layout Parameters ---
@@ -1584,7 +1673,7 @@ try:
     # Calculate layout
     print("Calculating Keçeci Layout...")
     # Call the layout function from the imported module
-    pos_nk = kl.kececi_layout_v4(G_nk, **LAYOUT_PARAMS)
+    pos_nk = kl.kececi_layout(G_nk, **LAYOUT_PARAMS)
     # print("Networkit positions:", pos_nk) # Debug print if needed
 
     # Plot using Matplotlib directly (Networkit doesn't have a simple built-in draw)
@@ -1656,7 +1745,7 @@ try:
     import kececilayout as kl
 except ImportError:
     print("Error: 'kececi_layout.py' not found or could not be imported.")
-    print("Please ensure the file containing kececi_layout_v4 is accessible.")
+    print("Please ensure the file containing kececi_layout is accessible.")
     exit()
 
 # --- General Layout Parameters ---
@@ -1690,7 +1779,7 @@ try:
     print("Calculating Keçeci Layout...")
     # Call the layout function; it should handle the Graphillion GraphSet object
     # and likely use 1-based indexing based on the universe.
-    pos_gg = kl.kececi_layout_v4(gs, **LAYOUT_PARAMS)
+    pos_gg = kl.kececi_layout(gs, **LAYOUT_PARAMS)
     # print("Graphillion positions:", pos_gg) # Debug print if needed
 
     # Plot using Matplotlib directly (Graphillion has no plotting)
@@ -1772,8 +1861,8 @@ This project is licensed under the MIT License. See the `LICENSE` file for detai
 
 *   **Rozetler (Badges):** Başlangıçta PyPI ve Lisans rozetleri ekledim (yorum satırı içinde). Eğer projeniz PyPI'da yayınlandıysa veya bir CI/CD süreci varsa, ilgili rozetleri eklemek iyi bir pratiktir.
 *   **LICENSE Dosyası:** `LICENSE` bölümünde bir `LICENSE` dosyasına referans verdim. Projenizin kök dizininde MIT lisans metnini içeren bir `LICENSE` dosyası oluşturduğunuzdan emin olun.
-*   **İçe Aktarma Yolları:** Örneklerde `import kececilayout as kl` veya `from kececilayout import kececi_layout_v4_igraph` gibi varsayımsal içe aktarma yolları kullandım. Kendi paket yapınıza göre bunları ayarlamanız gerekebilir.
-*   **Fonksiyon Adları:** Örneklerde `kececi_layout_v4` ve `kececi_layout_v4_igraph` gibi fonksiyon adlarını kullandım. Gerçek fonksiyon adlarınız farklıysa bunları güncelleyin.
+*   **İçe Aktarma Yolları:** Örneklerde `import kececilayout as kl` veya `from kececilayout import kececi_layout_igraph` gibi varsayımsal içe aktarma yolları kullandım. Kendi paket yapınıza göre bunları ayarlamanız gerekebilir.
+*   **Fonksiyon Adları:** Örneklerde `kececi_layout` ve `kececi_layout_igraph` gibi fonksiyon adlarını kullandım. Gerçek fonksiyon adlarınız farklıysa bunları güncelleyin.
 *   **Görselleştirme:** Örneklere `matplotlib.pyplot` kullanarak temel görselleştirme adımlarını ekledim, bu da kullanıcıların sonucu nasıl görebileceğini gösterir. Eksen oranlarını eşitlemek (`axis('equal')` veya `set_aspect('equal')`) layout'un doğru görünmesi için önemlidir.
 ```
 
@@ -1810,6 +1899,8 @@ If this library was useful to you in your research, please cite us. Following th
 
 ```
 
+Keçeci, M. (2025). From Chaos to Clarity: The Keçeci Layout for Order-Dependent Systems. https://doi.org/10.5281/zenodo.17665770
+
 Keçeci, M. (2025). Deterministic Visualization of Distribution Power Grids: Integration of Power Grid Model and Keçeci Layout. Open Science Articles (OSAs), Zenodo. https://doi.org/10.5281/zenodo.16934620
 
 Keçeci, M. (2025). Graf Teorisi Eğitiminde Yeni Bir Araç: Z3 ve Keçeci Dizilimi ile Hamilton Probleminin İnteraktif Keşfi. Open Science Articles (OSAs), Zenodo. https://doi.org/10.5281/zenodo.16883657
@@ -1849,6 +1940,7 @@ Keçeci, M. (2025, May 1). Kececilayout. Open Science Articles (OSAs), Zenodo. h
 ### Chicago
 
 ```
+Keçeci, Mehmet. From Chaos to Clarity: The Keçeci Layout for Order-Dependent Systems, November 20, 2025. https://doi.org/10.5281/zenodo.17665770.
 
 Keçeci, Mehmet. The Keçeci Layout: A Deterministic Visualisation Framework for the Structural Analysis of Ordered Systems in Chemistry and Environmental Science. Open Science Articles (OSAs), Zenodo, 2025. https://doi.org/10.5281/zenodo.16696713
 
@@ -1860,3 +1952,9 @@ Keçeci, Mehmet. "Kececilayout". Open Science Articles (OSAs), Zenodo, 2025. htt
 
 Keçeci, Mehmet. "Keçeci Layout". Open Science Articles (OSAs), Zenodo, 2025. https://doi.org/10.5281/zenodo.15314328.
 ```
+
+
+
+
+
+

kececilayout-0.4.8.dist-info/RECORD

@@ -0,0 +1,8 @@
+kececilayout/__init__.py,sha256=VM2hhmuLnYzUOdqnfUfcCMcVAhqKoVoXGZt2Ap8h28s,4326
+kececilayout/_version.py,sha256=54IUq7pRz3f5rBBN6EesT1JcujcF098oxzUoIsv0ndM,817
+kececilayout/kececi_layout.py,sha256=J0Clc_5Fx6m-pgYDnH-1oJOCrkCaNWjhsbmYQfdjiDo,73849
+kececilayout-0.4.8.dist-info/licenses/LICENSE,sha256=NJZsJEbQuKzxn1mWPWCbRx8jRUqGS22thl8wwuRQJ9c,1071
+kececilayout-0.4.8.dist-info/METADATA,sha256=t80Ur9d2diwL_JnGggU6FRWcNlHX6vD3th-n5iIXP-4,75894
+kececilayout-0.4.8.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+kececilayout-0.4.8.dist-info/top_level.txt,sha256=OBzN_wm4q-iwSkeACF4E8ET_LFLJKBTldSH3D1jG2hA,13
+kececilayout-0.4.8.dist-info/RECORD,,

kececilayout-0.4.6.dist-info/RECORD

@@ -1,8 +0,0 @@
-kececilayout/__init__.py,sha256=12AicnQi8b_Jmt4hOX2Mq64tuTAHGjv0dg2zcGKg4_s,4232
-kececilayout/_version.py,sha256=qazsUuV6VwMVMYALTU44NoxJ7cG56PeQa1wjflwKaBk,813
-kececilayout/kececi_layout.py,sha256=mUVoZJr0w7fSlZyY03diD4kA0KOdO6qAfWP9nKIKnhM,66598
-kececilayout-0.4.6.dist-info/licenses/LICENSE,sha256=NJZsJEbQuKzxn1mWPWCbRx8jRUqGS22thl8wwuRQJ9c,1071
-kececilayout-0.4.6.dist-info/METADATA,sha256=Fi31dZrwdXKwrh7byGQgrgee_gRIc854HAFWuMeBpm4,73243
-kececilayout-0.4.6.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-kececilayout-0.4.6.dist-info/top_level.txt,sha256=OBzN_wm4q-iwSkeACF4E8ET_LFLJKBTldSH3D1jG2hA,13
-kececilayout-0.4.6.dist-info/RECORD,,