-
Notifications
You must be signed in to change notification settings - Fork 8
DOC-752 | Graph Visualizer UI #701
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
base: main
Are you sure you want to change the base?
Changes from all commits
071d371
d5ae31f
1610dfd
651244c
4c85325
File filter
Filter by extension
Conversations
Jump to
Diff view
Diff view
There are no files selected for viewing
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -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. | ||
|
||
 | ||
|
||
### 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. | ||
 | ||
|
||
### 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** | ||
 | ||
- **Select Edge and Right-click** | ||
 | ||
|
||
### 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** | ||
 | ||
|
||
## 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**. | ||
 | ||
|
||
### 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. | ||
 | ||
### 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 | ||
 | ||
|
||
### 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** | ||
 | ||
### 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** | ||
 | ||
|
||
- **Response of the NewQuery** | ||
 | ||
|
||
|
||
## 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. | ||
 | ||
|
||
### 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. | ||
 | ||
|
||
## 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. | ||
 | ||
|
||
- **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: | ||
 | ||
|
||
These features allow better spatial understanding of node clusters, hierarchies, | ||
and relationship flows. |
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -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. | ||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. I'm not sure if we need to explain the concept of a graph in this context |
||
|
||
> 💡 **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. | ||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. This should use an Admonition, see Readme |
||
|
||
## 1.Data Augmentation | ||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. I would generally avoid enumerations in headlines, and especially here where the content has no specific order (time/priority) |
||
|
||
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):** | ||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. To structure the content, you should use (un)ordered lists if the child content is rather short or sub-headings if it's larger. Enumerations need to be created with markup not free-text. |
||
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. | ||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more.
|
||
|
||
- **Step-1 : Right Click On Graph Area** | ||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more.
|
||
{{< image src="../../images/1a-Create_Node.png" >}} | ||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Please use standard Markdown if you want to include images. This Shortcode is only for exceptional cases where custom styling needs to be specified or if the image should have a caption. |
||
|
||
- **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 | ||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more.
|
||
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. | ||
|
||
--- | ||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Why a horizontal ruler here? |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.