Skip to content

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

Draft
wants to merge 5 commits into
base: main
Choose a base branch
from
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
156 changes: 156 additions & 0 deletions site/content/3.13/graphs/Graph_visualizer/_index.md
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.

![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.
150 changes: 150 additions & 0 deletions site/content/3.13/graphs/graph-visualizer/_index.md
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.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

  • Missing article
  • Too vague, need a good value proposition here
  • Shouldn't end with a period as per the Readme

---

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.
Copy link
Contributor

Choose a reason for hiding this comment

The 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.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This should use an Admonition, see Readme


## 1.Data Augmentation
Copy link
Contributor

Choose a reason for hiding this comment

The 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):**
Copy link
Contributor

Choose a reason for hiding this comment

The 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.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.


- **Step-1 : Right Click On Graph Area**
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

  • Use markup for ordered list
  • Should be right-click (hyphen)
  • Is the idea for this to be like a headline? Otherwise, I don't understand the title case

{{< image src="../../images/1a-Create_Node.png" >}}
Copy link
Contributor

Choose a reason for hiding this comment

The 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
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

  • Please don't skip headline levels. Pages should have a sound structure.
  • I'm not sure about the use of emoji

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.

---
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Why a horizontal ruler here?

Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added site/content/images/Example-graph.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added site/content/images/Graph_Visualizer_minimap.PNG
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added site/content/images/new-query.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added site/content/images/new-query_saving.PNG
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added site/content/images/savedquery.PNG
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added site/content/images/search.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.