diff --git a/site/content/3.13/graphs/Graph_visualizer/_index.md b/site/content/3.13/graphs/Graph_visualizer/_index.md new file mode 100644 index 0000000000..d1049e391b --- /dev/null +++ b/site/content/3.13/graphs/Graph_visualizer/_index.md @@ -0,0 +1,156 @@ +--- +title: Graph Visualizer +menuTitle: Graph Visualizer +weight: 85 +description: >- + Visualize and interact with your ArangoDB graphs in an intuitive and interactive interface. +--- + +The **Graph Visualizer** provides an interactive interface to explore graph connections +in your ArangoDB database. It allows users to navigate edges, inspect vertices, +and visually understand the data structure. + +{{< info >}} +💡 **Note:** Graph creation is **not** performed within the Graph Visualizer. Graphs must be created in the **Graphs** section of the application. Once a graph is created there, it will automatically appear in the Graph Visualizer, ready for exploration and visualization. +{{< /info >}} + +## 1.Graph Creation + +While the Graph Visualizer is primarily designed for exploring graph data, you can also create and modify nodes and edges directly from the canvas. + +### A. Add New Nodes + + Right-click anywhere on the canvas to open the context menu and select **Create Node**. A dropdown appears listing available document collections. Select a collection (vertex type), enter a unique identifier, and create the node. It is then added to the visualization. + +##### 1. Open the Graph Interface +Launch the **Graphs** tab on the left sidebar and select the graph where the new node is to be created. +##### 2. Navigate to the Node Section +Right click on the graph area +##### 3. Add a New Node +Locate the **Create Node** option and click on it. A form or dialog box should appear select the **Collection** name. +##### 4. Enter Node Details +Provide: +- **ID**: Option to selct A unique identifier or user can add manually. +##### 5. Save the Node +Click the save button. The node should appear in the graph visualization. + +![Create Node](../../../images/Graph-visualizer-CreateNode.PNG) + +### B. Add New Edges + Right-click on the canvas and select **"Create Edge"**. Choose the edge collection from the dropdown, provide a name for the edge, and correctly set the `_from` and `_to` fields by selecting source and target nodes. The edge will be created and visualized between the two nodes. + +##### 1. Open the Graph Interface +Launch the **Graphs** tab on the left sidebar and select the graph where the new edge is to be created. +##### 2. Navigate to the Edge Section +Right click on the graph area +##### 3. Add a New Edge +Locate the **Create Edge** option and click on it. A form or dialog box should appear select the **Collection** name. +##### 4. Enter Edge Details +Provide: +- **ID**: Option to selct A unique identifier or user can add manually. +- **_from**: Option to selct the collection name manually from the drop down. +- **_to**: Option to selct the collection name manually from the drop down. +##### 5. Save the Edge +Click the save button. The edge should appear in the graph visualization. +![Create Edge](../../../images/Graph-visualizer-CreateEdge.png) + +### C. Delete Nodes or Edges + + Select a node or edge and right-click to access the **"Delete"** option. This action removes the selected element from both the graph and the database. + +- **Select Node and Right-click** +![Delete Node](../../../images/Graph-visualizer-DeleteNode.PNG) +- **Select Edge and Right-click** +![Delete Edge](../../../images/Graph-visualizer-DeleteEdge.PNG) + +### D. View Node Properties +If You Select a node or edge a Pop-In will appear and select **View-Node** to display the properties of selected Node. + +- **Select Node to display the Properties** +![Create Edge](../../../images/Graph-visualizer-Propertiesofnode.png) + +## 2.Graph Visualization + +The core function of the Graph Visualizer is to provide an intuitive canvas for exploring graph structures. + +### A. List All Graphs + View and select any graph from the list of connected graphs, including **General Graphs**, **Smart Graphs**, **Satellite Graphs**, **Enterprise Graphs**, and **Knowledge Graphs**. +![Graphs List](../../../images/Graph_VisualizerList_All_Graphs.png) + +### B. Select and Load a Graph + Upon selecting a graph, its nodes and edges are visualized. The visualization includes a summary of the vertex and edge collections involved, providing a clear view of the data model and relationships. +![Loaded Graph](../../../images/Graph_visuaizer_Load_Graph.png) +### C. Dynamic Graph Rendering + In addition to static graphs, you can dynamically render graphs using the **New Query** or **Saved Queries** options. This allows visualizing results from custom AQL queries on demand. +{{< tip >}} +💡 On CLick search bar (Explore) user can able to run the query and see the result on Canvas.And also user can able to save the query for future use. +{{< /tip >}} +## 3.Search & Filter Data + +The top-left section of the Graph Visualizer includes powerful search and query tools for interactive exploration. + +### Search +Click on Search Icon to get Pop-Up then User have to select one of the type of vertex from the provided dropdown and by entering the property name or field name user can able to fetch the data. + +#### 1. Search Icon +Click on search Icon to get Pop-Up +#### 2. Select Vertex Type +Select One of the type of vertes from the provided dropdown +#### 3. Search Response +Enter the DataValue or fields to get the required Data +![Search](../../../images/Graph_Visualizer_Search_Response.png) + +### Saved Queries +Lists all previously saved AQL queries.Each entry supports **Run**, **Copy**, and +**Delete** actions for ease of reuse. +- **Click on Search Icon and Select Saved Queries** +![Saved Queries](../../../images/Graph_Visualizer_savedquery.png) +### New Query +Write and execute custom AQL queries within the visualizer.Results are rendered +directly onto the graph canvas.You can save queries with a **custom name and description**, +making them available under **Saved Queries**. + +- **Click on Search Icon and Select New Query** +![](../../../images/Graph_Visualizer_new_Query.png) + +- **Response of the NewQuery** +![](../../../images/Graph_Visualizer_NewQuery_response.png) + + +## 4.Visual Customization + +Click the **navigation icon** at the bottom-right of the canvas to reveal styling and customization tools. + +### Styling Options +Modify the **color** and **opacity** of selected nodes or edges for emphasis or categorization. +![](../../../images/Graph_Visualizer_Styling_Options.png) + +### Edge-Specific Options +- Adjust **line thickness** to represent weight or importance. +- Set **arrowhead styles** for source and target, choosing from different shapes. +These options are especially helpful when working with dense or complex graphs, making key elements stand out. +![](../../../images/Graph_Visualizer_Edge-Specific_Options.PNG) + +## 5.Layouts and Navigation Tools + +Graph layout and navigation tools help users manage large and complex graphs effectively. + +- **Mini-map:** + View a compact overview of the graph and navigate quickly. +![](../../../images/Graph_Visualizer_minimap.PNG) + +- **Zoom Controls:** + Use the buttons to zoom in/out, or manually set a specific zoom percentage. + +- **Fit to Screen:** + Automatically resize and center the graph to fit the visible canvas. + +- **Re-run Layout:** + Rearrange nodes and edges to apply a fresh layout for improved clarity. + +- **Layout Algorithms:** + Switch between layout styles such as: +![](../../../images/Graph_Visualizer_Layout_Algorithms.PNG) + +These features allow better spatial understanding of node clusters, hierarchies, +and relationship flows. diff --git a/site/content/3.13/graphs/graph-visualizer/_index.md b/site/content/3.13/graphs/graph-visualizer/_index.md new file mode 100644 index 0000000000..92993e0018 --- /dev/null +++ b/site/content/3.13/graphs/graph-visualizer/_index.md @@ -0,0 +1,150 @@ +--- +title: Graph Visualizer +menuTitle: Graph Visualizer +weight: 85 +description: >- + Graph Visualizer allows you to visualize the graphs present in the database. +--- + +A **Graph** in ArangoDB is a powerful data structure that models relationships between entities. The **Graph Visualizer** provides an interactive interface to explore these connections, enabling users to traverse edges, inspect vertices, and intuitively understand the underlying data structure. + +> 💡 **Note:** Graph creation is **not** performed within the Graph Visualizer. Graphs must be created in the **Graphs** section of the application. Once a graph is created there, it will automatically appear in the Graph Visualizer, ready for exploration and visualization. + +## 1.Data Augmentation + +While the Graph Visualizer is primarily designed for exploring graph data, you can also create and modify nodes and edges directly from the canvas. + +**A.Add New Nodes (Vertices):** + Right-click anywhere on the canvas and select **"Create Node"**. A dropdown will appear showing all related document collections. Select the desired collection (vertex type), provide a unique identifier or name, and create the node. The node will then appear in the visualization. + +- **Step-1 : Right Click On Graph Area** +{{< image src="../../images/1a-Create_Node.png" >}} + +- **Step-2 : Select Create Node** +{{< image src="../../images/1b-Create_Node.png" >}} + +- **Step-3 : Select the desired Node Type and click on Create** +{{< image src="../../images/1c-Create_Node.png" >}} + +**B.Add New Edges (Relationships):** + Right-click on the canvas and select **"Create Edge"**. Choose the edge collection from the dropdown, provide a name for the edge, and correctly set the `_from` and `_to` fields by selecting source and target nodes. The edge will be created and visualized between the two nodes. + +- **Step-1 : Right Click On Graph Area** +{{< image src="../../images/2a-Create_Edge.png" >}} + +- **Step-2 : Select Create Edge** +{{< image src="../../images/2b-Create_Edge.png" >}} + +- **Step-3 : Select the desired Edge from drop down and enter valid details in '_from' and '_to' and click Create** +{{< image src="../../images/2c-Create_Edge.png" >}} + +**C.Delete Nodes or Edges:** + Select a node or edge and right-click to access the **"Delete"** option. This action removes the selected element from both the graph and the database. + +- **Select Node and Right click** +{{< image src="../../images/3a-Delete_Node.png" >}} + +- **Select Edge and Right click** +{{< image src="../../images/3b-Delete_Edge.png" >}} + +**D.Properties of Nodes or Edges:** + If You Select a node or edge a Pop-In will appear and display the properties of selected Node or Edge. + +- **Select Edge to display the Properties** +{{< image src="../../images/4a-Properties-of-Edge.png" >}} + +- **Select Node to display the Properties** +{{< image src="../../images/4-Properties-of-Node.png" >}} + +## 2.Graph Visualization + +The core function of the Graph Visualizer is to provide an intuitive canvas for exploring graph structures. + +- **List All Graphs:** + View and select any graph from the list of connected graphs, including **General Graphs**, **Smart Graphs**, **Satellite Graphs**, **Enterprise Graphs**, and **Knowledge Graphs**. +{{< image src="../../images/1_List All Graphs.png" >}} + +- **Select and Load a Graph:** + Upon selecting a graph, its nodes and edges are visualized. The visualization includes a summary of the vertex and edge collections involved, providing a clear view of the data model and relationships. +{{< image src="../../images/2_Load_Graph.png" >}} + +- **Dynamic Graph Rendering:** + In addition to static graphs, you can dynamically render graphs using the **New Query** or **Saved Queries** options. This allows visualizing results from custom AQL queries on demand. + - **Dynamic Graph By using New-Query** +{{< image src="../../images/3a_DynamicGraphby_NewQuery.png" >}} + - **Dynamic Graph By using Saved-Query** +{{< image src="../../images/DynamicGraph_By_Saved_Query.png" >}} + +## 3.Search & Filter Data + +The top-left section of the Graph Visualizer includes powerful search and query tools for interactive exploration. + +##### 🔍 Search +User have to select one of the type of vertex from the provided dropdown and by entering the property name or field name user can able to fetch the data. + +- **Step-1 : Click on Search Icon to get Pop-Up** +{{< image src="../../images/1a_search.png" >}} +- **Step-2 : Select Vertex Type from DropDown** +{{< image src="../../images/1b_search.png" >}} +- **Step-3 : Enter the DataValue or fields toget the required Data** +{{< image src="../../images/1c_Search Response.png" >}} + +##### 💾 Saved Queries +Lists all previously saved AQL queries.Each entry supports **Run**, **Copy**, and +**Delete** actions for ease of reuse. +- **Click on Search Icon and Select Saved Queries** +{{< image src="../../images/2a_savedquery.png" >}} + +##### ✏️ New Query +Write and execute custom AQL queries within the visualizer.Results are rendered +directly onto the graph canvas.You can save queries with a **custom name and description**, +making them available under **Saved Queries**. +- **Click on Search Icon and Select New Query** +{{< image src="../../images/3a_new_Query.png" >}} +- **Response of the NewQuery** +{{< image src="../../images/3b_NewQuery_response.png" >}} + +## 4.Visual Customization + +Click the **navigation icon** at the bottom-right of the canvas to reveal styling and customization tools. + +##### 🏷️ Display Fields +Choose which attributes or fields from the document to display as node or edge labels. +- **Select Node to Display Fields** +{{< image src="../../images/4-Properties-of-Node.png" >}} + +##### 🎨 Styling Options +Modify the **color** and **opacity** of selected nodes or edges for emphasis or categorization. +{{< image src="../../images/2_Styling Options.png" >}} + +##### 🔗 Edge-Specific Options +- Adjust **line thickness** to represent weight or importance. +- Set **arrowhead styles** for source and target, choosing from different shapes. +These options are especially helpful when working with dense or complex graphs, making key elements stand out. +{{< image src="../../images/3_Edge-Specific Options.png" >}} + +## 5.Layouts and Navigation Tools + +Graph layout and navigation tools help users manage large and complex graphs effectively. + +- **Mini-map:** + View a compact overview of the graph and navigate quickly. +{{< image src="../../images/1_minimap.png" >}} + +- **Zoom Controls:** + Use the buttons to zoom in/out, or manually set a specific zoom percentage. + +- **Fit to Screen:** + Automatically resize and center the graph to fit the visible canvas. + +- **Re-run Layout:** + Rearrange nodes and edges to apply a fresh layout for improved clarity. + +- **Layout Algorithms:** + Switch between layout styles such as: +{{< image src="../../images/5_Layout Algorithms.png" >}} + +These features allow better spatial understanding of node clusters, hierarchies, +and relationship flows. + +--- \ No newline at end of file diff --git a/site/content/images/DynamicGraph_By_Saved_Query.PNG b/site/content/images/DynamicGraph_By_Saved_Query.PNG new file mode 100644 index 0000000000..7a3b83d72f Binary files /dev/null and b/site/content/images/DynamicGraph_By_Saved_Query.PNG differ diff --git a/site/content/images/Example-graph.png b/site/content/images/Example-graph.png new file mode 100644 index 0000000000..a24a9405f9 Binary files /dev/null and b/site/content/images/Example-graph.png differ diff --git a/site/content/images/Graph-visualizer-CreateEdge.png b/site/content/images/Graph-visualizer-CreateEdge.png new file mode 100644 index 0000000000..649b24d7eb Binary files /dev/null and b/site/content/images/Graph-visualizer-CreateEdge.png differ diff --git a/site/content/images/Graph-visualizer-CreateNode.PNG b/site/content/images/Graph-visualizer-CreateNode.PNG new file mode 100644 index 0000000000..1c546e2699 Binary files /dev/null and b/site/content/images/Graph-visualizer-CreateNode.PNG differ diff --git a/site/content/images/Graph-visualizer-DeleteEdge.PNG b/site/content/images/Graph-visualizer-DeleteEdge.PNG new file mode 100644 index 0000000000..8815650d6b Binary files /dev/null and b/site/content/images/Graph-visualizer-DeleteEdge.PNG differ diff --git a/site/content/images/Graph-visualizer-DeleteNode.PNG b/site/content/images/Graph-visualizer-DeleteNode.PNG new file mode 100644 index 0000000000..6bc5716e06 Binary files /dev/null and b/site/content/images/Graph-visualizer-DeleteNode.PNG differ diff --git a/site/content/images/Graph-visualizer-Propertiesofnode.png b/site/content/images/Graph-visualizer-Propertiesofnode.png new file mode 100644 index 0000000000..8c318aa990 Binary files /dev/null and b/site/content/images/Graph-visualizer-Propertiesofnode.png differ diff --git a/site/content/images/Graph_VisualizerList_All_Graphs.png b/site/content/images/Graph_VisualizerList_All_Graphs.png new file mode 100644 index 0000000000..bb97f81237 Binary files /dev/null and b/site/content/images/Graph_VisualizerList_All_Graphs.png differ diff --git a/site/content/images/Graph_Visualizer_Edge-Specific_Options.PNG b/site/content/images/Graph_Visualizer_Edge-Specific_Options.PNG new file mode 100644 index 0000000000..6932c49719 Binary files /dev/null and b/site/content/images/Graph_Visualizer_Edge-Specific_Options.PNG differ diff --git a/site/content/images/Graph_Visualizer_Edge-Specific_Options.png b/site/content/images/Graph_Visualizer_Edge-Specific_Options.png new file mode 100644 index 0000000000..00a4885965 Binary files /dev/null and b/site/content/images/Graph_Visualizer_Edge-Specific_Options.png differ diff --git a/site/content/images/Graph_Visualizer_Layout_Algorithms.PNG b/site/content/images/Graph_Visualizer_Layout_Algorithms.PNG new file mode 100644 index 0000000000..3015c5e165 Binary files /dev/null and b/site/content/images/Graph_Visualizer_Layout_Algorithms.PNG differ diff --git a/site/content/images/Graph_Visualizer_NewQuery_response.png b/site/content/images/Graph_Visualizer_NewQuery_response.png new file mode 100644 index 0000000000..bbf89fe744 Binary files /dev/null and b/site/content/images/Graph_Visualizer_NewQuery_response.png differ diff --git a/site/content/images/Graph_Visualizer_Re-run Layout_Icon.PNG b/site/content/images/Graph_Visualizer_Re-run Layout_Icon.PNG new file mode 100644 index 0000000000..65865d7e06 Binary files /dev/null and b/site/content/images/Graph_Visualizer_Re-run Layout_Icon.PNG differ diff --git a/site/content/images/Graph_Visualizer_Search_Response.png b/site/content/images/Graph_Visualizer_Search_Response.png new file mode 100644 index 0000000000..c3d4c425f3 Binary files /dev/null and b/site/content/images/Graph_Visualizer_Search_Response.png differ diff --git a/site/content/images/Graph_Visualizer_Styling_Options.png b/site/content/images/Graph_Visualizer_Styling_Options.png new file mode 100644 index 0000000000..a52125c3f6 Binary files /dev/null and b/site/content/images/Graph_Visualizer_Styling_Options.png differ diff --git a/site/content/images/Graph_Visualizer_minimap.PNG b/site/content/images/Graph_Visualizer_minimap.PNG new file mode 100644 index 0000000000..ccaf667dce Binary files /dev/null and b/site/content/images/Graph_Visualizer_minimap.PNG differ diff --git a/site/content/images/Graph_Visualizer_new_Query.png b/site/content/images/Graph_Visualizer_new_Query.png new file mode 100644 index 0000000000..3775db81f3 Binary files /dev/null and b/site/content/images/Graph_Visualizer_new_Query.png differ diff --git a/site/content/images/Graph_Visualizer_savedquery.png b/site/content/images/Graph_Visualizer_savedquery.png new file mode 100644 index 0000000000..781847fe56 Binary files /dev/null and b/site/content/images/Graph_Visualizer_savedquery.png differ diff --git a/site/content/images/Graph_visuaizer_Load_Graph.png b/site/content/images/Graph_visuaizer_Load_Graph.png new file mode 100644 index 0000000000..153c8a26e4 Binary files /dev/null and b/site/content/images/Graph_visuaizer_Load_Graph.png differ diff --git a/site/content/images/new-query.png b/site/content/images/new-query.png new file mode 100644 index 0000000000..4928117c38 Binary files /dev/null and b/site/content/images/new-query.png differ diff --git a/site/content/images/new-query_saving.PNG b/site/content/images/new-query_saving.PNG new file mode 100644 index 0000000000..d65b32a783 Binary files /dev/null and b/site/content/images/new-query_saving.PNG differ diff --git a/site/content/images/savedquery.PNG b/site/content/images/savedquery.PNG new file mode 100644 index 0000000000..641b263b05 Binary files /dev/null and b/site/content/images/savedquery.PNG differ diff --git a/site/content/images/search.png b/site/content/images/search.png new file mode 100644 index 0000000000..b48013ab59 Binary files /dev/null and b/site/content/images/search.png differ