Features

Search tab

When you need to search for a particular node or filter out a set of nodes based on their data you can use the Search tab in the graph visualization.

• Search directly in data using the search box. The search looks into properties defined on the Settings tab in the Title and Snippets controls.
• Use the Advanced filter to filter out nodes using multiple filtering criteria. There is a logical OR between values selected in one property and a logical AND between properties. This is helpful for filtering out nodes from the graph visualization based on categories of data. Please note that only properties defined in Data Schema with dataRole set to "dimension" are available in the Advanced filter.
• Use the Select or Unselect buttons to quickly add or remove currently filtered out nodes from/to selected nodes.
  
• Select or unselect nodes in the graph visualization by clicking on the icon of the node snippet in the list or look into details of a node by clicking on the node snippet itself.
  

Shortest path

To find all shortest paths between two nodes in a graph simply select these two nodes and press the "Find the shortest path" button. All shortest paths are calculated and the user can choose which paths to add to the visualization. The paths are calculated using all data in the graph database.View the different paths using the tabs on the left. Usually, some of the paths are similar in the sense that they have the same type of entities along the path. These paths can be grouped together using the "Group similar paths" checkbox to easily select or unselect whole groups.Separate paths or groups can be selected or unselected. Selected paths are combined in the "Selected paths" tab. This is the resulting subgraph that will be added to the visualization. If all elements of the selected paths are already in the visualization then the layout of the existing elements is preserved, paths are selected and centered.

Style mapping

With Discrete Mapping you can set style values of any element in the graph visualization based on discrete mapping rules for each data value stored in a data property (either virtual or database property), e.g. "Rack" is blue, "Server" is green, etc.

• To create any Mapper (linear or discrete) open the Mapper Editor associated with any visual property (like background color or size of nodes, relationships' width or color, etc.), select which property's values should be used in mapping, and select mapped values.

With Linear Mapping you can set style properties like color or dimensions of nodes and relationships of the graph visualization continuously based on numeric data (metrics) stored in any data property (either virtual or database property)

• To create any Mapper (linear or discrete) open the Mapper Editor associated with any visual property (like background color or size of nodes, relationships' width or color, etc.), select which property's values should be used in the mapping (so-called data property) and select mapped values.
• Linear Mapping is defined with two reference points which are used to calculate style values for elements using linear interpolation. These points can be set manually or you can use the "Auto" threshold which will automatically use the maximum and minimum from current data in the graph visualization.
• When you set the thresholds manually (one of them or both) then every data value below the minimum is mapped to style value associated with the minimum threshold and every data value above the maximum is mapped to style value associated with a maximum threshold.
  

Export

Visualization can be exported as an image or a data file using the export menu. To export data in a format that can be opened in any spreadsheet editor like MS Excel, choose the CSV option from the Export menu.

Choose which properties should be exported and rearrange them to change the order of the columns in the exported CSV file. Choose the sorting property to change the order of the rows in the exported file.

Exporting relationships is very similar to exporting nodes. It has the option to add properties from the nodes connected with the exported relationship.

If a part of the graph is selected then only elements from this part are included in the exported data file.

There is also a special sorting algorithm called "Detect path" that will find the longest path in the exported graph and the rows in the file will be sorted according to the path. All other elements will be placed after the path rows.

Virtual properties

There are two types of properties you can use in graph visualization. The first are properties stored in Neo4j which we call Database properties. The other ones are Virtual properties which exist only in the scope of graph visualization and represent small JavaScript calculations used for searching for patterns or creating some sort of logic on top of data stored in the database.

• To create a Virtual property go to the Detail tab and click on "Add virtual property" > "Create new property". When you are on the detail of a node then you are creating a Virtual property for nodes and when you are on the detail of a relationship then you are creating a Virtual property for relationships.
• In the edit window create your JavaScript formula which returns some value. You can use the predefined templates for inspiration and test your formula with the "Test formula" button.
• Formulas defined in Virtual properties are calculated for every node in the graph visualization and the result is listed in the Detail tab.
• Virtual properties can be used in the Statistics tab for selecting or in Style mappers for styling the graph visualization.
  

Details tab

Details about the selected node or relationship can be viewed on the Detail tab in the graph visualization. When multiple elements are selected then details about the first element are displayed.

• On the top is the element's identification. If a node is selected then the node's title is also shown and the node's labels can be edited with the pencil icon.
• Next are the Virtual properties of the selected node. It's possible to create and edit locally defined virtual properties or hide/show any virtual property.
• Database properties: these are the properties stored in the graph database for the selected elements. Database properties can be edited or simply hidden from the tab (you can show them anytime with the Add database property menu).g, we can search for values from all of the indexed properties.
  
• Incoming nodes: here are listed all nodes from the selected node's neighborhood that have a relationship directed from the listed node to the selected node.
  
• Outgoing nodes: here are listed all nodes from the selected node's neighborhood that have a relationship directed from the selected node to the listed node.
  
• Incoming and outgoing nodes can be easily selected in the graph visualization with the circle icon.
  
• It's possible to directly show details of incoming or outgoing nodes (to traverse in the graph visualization) by clicking on the node's snippet.
  

Import data from a file

Quick import of graph elements from a CSV or Microsoft Excel file can be done on the Search page or directly in the visualization with the "Import file" button.

To import the file simply drag&drop it in the Import window. Select if you want to import nodes or relationships. Choose the Excel tab from which data will be imported (in case of a CSV file choose the column delimiter). Select if you want to use the names of properties from the file header. You can give your import an Import ID, this value will be stored on every imported element to allow easy lookup of the elements after the import is complete. Choose how the node labels will be created. Set the unique property, this will ensure that if there already are nodes with the same unique property in the database these nodes will be merged with the imported data instead of duplicating the nodes.

After a successful import, the next steps can be chosen, like creating a saved query for later lookup of the imported elements, visualizing the imported elements, or starting a new import with the same import ID.

Importing relationships is very similar to the additional step of matching the start and end node of the relationships using a unique identifier in your data.

Users and Groups

For managing users and groups in the system go either to the Users page or Groups page.

• To create a new user go to the Users page, click on the Create new user button, fill out mandatory fields, and click Create. You can also choose if the user is Enabled right after creating or if the should be disabled for now.
• User action buttons: with the management buttons you can enable or disable a user's access to the system, modify the user's name, change password, add or remove a user to or from a group or delete the user.
• To create a new group of users go to the Groups page, click on the Create group button, fill out mandatory fields, and click create. Here you can also set the group's application permissions which determines what can a member of this group does in the system. Please read more about the permissions in the documentation.
  
• Group action buttons: with the management buttons you can edit a group's name, description, or permissions, assign users to the group or delete the group.