The Project Workspace

The project workspace is a virtual 3D or 2D canvas that includes the following default tools and features:

01 04 01 ProjectOverview
  • Combined Query/Search bar at the top left, to either:

    • Enter a no-code Query for data from a connected or internal graph database

    • Perform full-text Search of property values on indexed data in the database or the data on the project canvas.

  • View Menu, at the center of the top, to save, load, and share data views.

  • Legend, at the top right of the canvas, to display and select a list of nodes by Category, Tag, or a category Property name and value, and edges by Relationship or a relationship property (RelProperty) name and value.

  • Export menu, in the top right corner of the canvas, to export the current data view as a CSV or Excel archive, .graphxr file, .png screenshot, or SVG file.

    01 04 02 ExportMenu
  • Panel Menu along the left vertical edge of the project space, with icons to open panels that organize features for working with graph data, including:

    • Projects, to manage project Views, Category and Relationship details, and project Settings, Datastore, and Extension details.

    • Query, for entering and running Cypher/GQL, SQL, CSV (and CSV Mapping), JSON, and Gremlin queries.

    • Transform, to refocus and simplify the graph model.

    • Table, to work with tables of nodes or edges by Category or Relationship.

    • Filter, to filter data on the canvas by entity property values.

    • Algorithm, to use the library of graph-analytic algorithms available in GraphXR.

    • Map, to drop nodes with latitude and longitude property values on a world map.

    • Additional menu icons to access Grove notebook and Graph Composer extensions, as well as Sandboxes supporting customized workflows.

  • Contextual Toolbar along the bottom of the space, which displays the tools usable on the data currently present or selected on the canvas.

  • Configurable Right-click menu of the tools and operations usable on your current data selection. You can right-click anywhere on the canvas to perform many graph operations without going to the toolbar or opening a panel.

  • GUI Navigation controls, at the bottom right, to simulate 3D virtual reality (VR) navigation on the desktop canvas.

  • Kineviz logo menu at the bottom left of the browser window, to return to the Projects home page, access GraphXR information or the Admin panel, and quickly Toggle Theme between light and dark mode.

    01 04 04 KVLogoMenu
    Most GraphXR menus and tools are configurable through the project’s UI Configuration dialog. This lets you limit (or expand) access to graph modeling and analytics within a project.

Query/Search bar

When you first open a project, its canvas is empty. You will need to import data to the canvas.

You can load a saved data view, if any are available.

No-code graph Query

Click in the Query bar for the dropdown menu to build and run a no-code visual query on the connected graph database.

01 04 06 QueryBar
Once you have data on the canvas, you can optionally use no-code Expand with Relationships from the toolbar icon or right-click menu to query for additional nodes connected through the defined relationships you select.

The search bar at the top left also enables full-text search. You can either:

  • Search the indexed properties in a connected database, and import the results to the project, or

  • Search data already on the canvas.

    01 04 06a SearchCanvasDB
    Use Search Index Configuration to index the properties available for search.

    Search results are listed by category below the search bar. Click a single node or a group of nodes in the search results to either:

  • Import the data from the database, or

  • Select the nodes returned by a search of data already on the canvas.

    01 04 06b SearchDBGraph

View Menu

Use the View menu to load a saved view.

01 04 05 ViewsMenu
You can also drag and drop views exported as .graphxr or .graphxrsnapshots files.

Legend

The legend at the top right corner of the canvas provides selectable lists of nodes or edges by Category, Relationship, Tag, Property (i.e. properties defined on Categories), or RelProperty (i.e. properties defined on Relationships). Labels on nodes (Category, Tag, or Property) are displayed above labels on relationships.

01 04 07 LegendCatRel

Each list bubble includes:

  • Entity label (for a category, relationship, or tag) or property value (for a property)

  • Icon applied (to a category, property or tag, if any)

  • Number of currently selected nodes or edges with that label or value

  • Total number of nodes or edges with that label or value

Use the legend lists to:

  • Review the number of nodes of each category, tag, property (or edges of each relationship), and the number in the current selection.

  • Click a list item to select all its nodes (or edges).

    Use ctrl-left click to select multiple items, and the mouse wheel or scroll gesture to scroll a long list.
  • Click the brush icon next to a list item to style nodes and edges:

    • For a category, you can set Color, an Icon, and select properties to be used for one or more Captions, an Avatar url, and relative node Size (based on a property value).

      01 04 08 Style Category
    • For a relationship, you can set the Color, and select properties for Captions and Bind Width (relative width of the edge based on a property value).

      01 04 09 Style Relationship
    • For a listed property value or tag, you can set a Color and Icon.

Right-click Context Menu

A customizable floating context menu of the tools available for your current selection is available by right-clicking anywhere in the project space. Use it to navigate and edit the graph without using the toolbar or opening additional panels.

The default right-click menu includes often-used options at the top level: Information, Expand, Find Path, and Delete.

Select, Actions, and Layout submenus organize related options:

01 04 10 RCSelectActionsLayout
  • Select submenu: All Nodes, Add to Selection, Subtract from Selection, Invert, Deselect, Floating Nodes, Leaf Nodes, Neighbor Nodes, Child Nodes, Parent Nodes, Neighbor Edges, and Connected Nodes.

  • Actions submenu: Add Node, Add Edge, Merge Nodes, Change Category, Collect Nodes, Explode Nodes, Tag, Hide, Show Hidden, Pin, Release, Highlight Nodes, and Clear Highlights.

  • Layout submenu: Line, Grid, Cube, Circle, Sphere, Spiral, Tree, and Ring layouts, and options to Expand, Contract, and Rotate a layout operate on selected data, or all data if nothing is selected. Layouts are grayed out if unavailable for the data.

    By default, Quick Information, Disable/Enable Force Layout, Clear All, Screenshot, Link, and image_ tools appear only in the toolbar.

The following table lists functions available only in the right-click menu. The other functions in the menu are also available in the toolbar or a panel.

Right-Click Menu Only Function

Find Path

Similar to the function in the Algorithm>Path Finding tab, but finds a path between just two selected nodes.

Select > Add to Selection

Mouse over an unselected node, and add the node to already selected nodes.

Select > Subtract from Selection

Mouse over a selected node, and de-select the node.

Select > Floating Nodes

Select nodes with no connecting edges.

Select > Leaf Nodes

Select nodes with only one connecting edge.

Select > Neighbor Nodes

Select nodes one hop away from selected nodes. Choose again to select nodes another hop away. One hop at a time is found and the nodes selected, not just highlighted.

Select > Child Nodes_

Select nodes one forward hop away from selected nodes (as shown by the direction of the connected edge). Choose again to select nodes another hop away.

Select > Parent Nodes

Select nodes one reverse hop away from selected nodes (as shown by the direction of the connected edge). Choose again to select nodes another hop away.

Select > Neighbor Edges

Select nodes one edge away from selected nodes.

Select > Connected Nodes

Select nodes connected to selected edges.

Actions > Merge Nodes

Displays a dialog to merge any selection of nodes into one node.

Actions > Change Category

Displays a dialog to change the category of any selection of nodes to any other existing category or to a new category. Properties of the changed nodes not present in the target category are transferred.

Actions > Highlight Nodes

Adds a colored ring around a node to as a persistent highlight.

Actions > Clear Highlights

Clears the highlight ring on selected nodes.

Actions>Change Category and Actions>Merge cannot be undone with Ctrl+Z. Before using either option, save a data View, snapshot, or .graphxr file so that you can undo a mistaken change.

Contextual Toolbar

The contextual toolbar at the bottom edge of the project space displays icons for one-click tools used to navigate, select, and lay out data. Some tools are available only when you select more than one node or edge, or only when you select a single node, or a single node that has an associated url and weblink property.

01 04 11 ContextToolbarLabeled
As you make the browser window narrower, tool icons are responsively arranged in two (or more) rows.

No nodes present

Toolbar icons in a project with no data present are:

01 04 12 ContextNoData
  • Undo and Re-Do. Reverts (or restores) the most recent data import action.

  • Add Node. Displays a dialog to define and add a single node.

  • Quick Info. Toggles between turning on and off Quick Info rollovers for nodes and edges.

  • Disable/Enable Force Layout. Toggles between turning on and off a force directed physics layout.

  • 3D/2D toggles between a 2- and 3- dimensional rendering of data on the canvas.

One or more nodes present

Once you load or create at least one node, more toolbar icons appear.

01 04 13 ContextWithData
  • Select Visible Nodes. Selects all nodes currently visible in the canvas (those not hidden using Hide Selection or by de-selecting the Visible checkbox for a category or relationship in the Project panel).

  • Take Screenshot. Takes a .png screenshot of the canvas including the legend, but excluding an open panel, toolbar and GUI navigation controls.

  • Center To. Zooms in on the center of the graph data if no nodes are selected, or the center of a group of selected nodes, or a single selected node.

  • Fly Out. Zooms out to display all the graph data centered in the project space.

  • Collect Nodes. Collects nodes connected to selected nodes by only one edge, and places them in special collection nodes. The information panel for a collection lists the included nodes, and enables you to remove or add back nodes.

  • Explode Collections. Deletes selected collection nodes and restores the collected nodes to the canvas.

  • Quick Layout. Displays a menu to lay out selected data in basic Line, Grid, Cube, Circle, Sphere, Spiral, or Spring layouts, to create a hierarchical Tree or Ring layout around selected nodes, and to Expand or Contract the layout of selected nodes.

  • Add Node. Displays a dialog to define and add a single node.

  • Add Edge. Displays a dialog to add edges between selected nodes, either with an existing relationship or by creating a new one.

  • Clear. Removes all data from the canvas.

  • Pin or Release. Toggles between pinning nodes to a location in the space, or releasing nodes from being pinned. The badge on the icon shows how many nodes are currently pinned.

More than one node selected

When you select any group of nodes, additional tool icons appear that can be used on selected data:

01 04 14 ContextSelHidden
  • Information. Opens an information window for the most recently selected single node or edge. It displays information about the node’s Properties and Neighbors or a relationship’s Properties.

  • NOTE: An Information window shows information for just one node or edge at a time.

  • Tag. Opens the Create Tag dialog to tag any set of selected nodes.

  • Delete. Deletes selected nodes and edges.

  • Expand. Opens the Expand with relationships dialog to pull additional nodes from the database which are connected to the selected nodes. You can select any or all of the relationships that connect the nodes.

  • Trace Neighbor. Displays a slider above the toolbar to display nodes connected through a path with the number of steps you choose.

  • Inverse. Selects all nodes not currently selected. The badge at the upper right of the icon shows the number of currently selected nodes.

  • Un-Hide Selection. Appears after you select and hide nodes. Click to restore all hidden nodes and edges to the canvas and de-select them.

  • Hide Selection. Hides selected nodes and edges temporarily.

One node selected

When you select a single node, two additional tool icons appear:

01 04 15 ContextSingle
  • Image and WebLink These two icons appear if an image and/or url is attached to a node. Select a node and click Image to display a small image in the canvas close to its node, and click again to hide the image. Click WebLink to open a browser window to a linked image or webpage.

  • Information. Opens a floating information pane for a selected single node or edge, which includes:

    • Properties tab, which lists the properties of the node or edge. You can add properties and edit property values in this window.

    • Neighbors tab, which displays a count of nodes connected to the selected node through one edge, and a live graphic of the nodes and edges.

      01 04 16 ContextProps

Panel menu

The Panel menu on the left edge of the canvas provides access to panels with tabbed sub-panels organized by function. Click an icon to display its panel.

Project panel

Project opens sub-panels to manage the project’s data views, review graph entities, set overall display preferences, manage the datastore, and access extensions:

01 04 20 ProjectPanelView
  • View, to display data views saved to the server, to save, update, select, and annotate views, and to load a data view to the project space.

  • Category and Relationship, to review defined graph entities, pull specific types of nodes or edges from a connected database and set display options for entities and their properties.

  • Settings, to set display options for nodes and edges, set the project UI Configuration, and show or hide Snapshot and History dialogs, dialog, and .

  • Data Store, to Import data in accepted formats, Export data views, CSV or Excel archives, a .png or SVG screenshot, or all current data views, and save a template based on the current project that can be applied to other projects. It is also where you manage the project’s connected database, if any.

  • Extensions, to access standard or custom extensions which may be available.

  • Grove Links, to manage access to Grove notebook sandboxes available to the project.

Query panel

Query opens sub-panels to enter and save Cypher or GQL queries on a connected database, and to query SQL databases (MySQL, MSSQL, or PostgreSQL), CSV or JSON files, or use the Gremlin graph traversal language.

01 04 21 QueryPanelQuery

The SQL and CSV tabs include the GraphXR Mapping Editor to map data in a flat CSV file or SQL table to a graph model.

01 04 22 QueryPanelCSV

Transform panel

Transform opens sub-panels for operations to transform graph data directly in GraphXR.

01 04 23 TransformPanelShortcut

Transform sub-panels include:

  • f(x), to execute functions similar to formulas in Excel and SQL or functions in MapReduce frameworks. You can run formulas to add information from one column of data to another, or to modify data formats.

  • Extract, to define a new category (and its properties) and relationship from an existing category, and extract new nodes and edges based upon it.

  • Aggregate, to collect properties from a starting node’s neighboring edges and nodes, apply a calculation, and write the result to the starting node as a property. This makes it possible to simplify a graph, yet retain key information about its original complexity.

  • Merge, to combine two nodes with matching properties into a single node.

  • Link, to connect nodes with the same property values. This can be used to bring two different data sets together and also to draw explicit connections among nodes of the same type.

  • Shortcut, to connect two nodes that share a common neighbor with a new link.

  • Connector, to provide access to external applications for enhancing data.

Table panel

Table open live searchable tables of data by Category or Relationship. Selecting an item on a table highlights and centers it on the canvas. In an Enhanced Table you can rename categories and relationships on the fly, select, sort, edit, and reformat data, and then export data as a CSV or Excel archive.

01 04 24 TablePanelCat

Layout panel

Layout opens Force, Parametric, and Geometric sub-panels for applying detailed layouts to all or part of the data on the canvas.

01 04 25 LayoutPanelGeom

Filter panel

Filter opens a panel to filter and select data by multiple Node or Edge property values. You can filter on numerical property values including date-time and latitude/longitude, as well as categorical(text string) property values.

01 04 26 FilterPanel

Algorithm panel

Algorithm opens GraphXR’s Path Finding, Centrality, and Community Detection graph algorithm library. Centrality and Community Detection results are added to nodes as a property value.

01 04 27 AlgoPanelCentrality

Map panel

Map opens a panel to drop nodes with latitude and longitude coordinates on a world map. Map controls and settings are provided to search map locations, set map boundaries and orientation, and choose a map server (default choices are MapBox, Open Street Maps, and Google Maps).

01 04 28 MapPanel

Projects Home, Information, and Logout

The Kineviz logo at the bottom left of the browser window displays a menu to return to the Projects page, access GraphXR information or the Admin panel, and quickly Toggle between a light and dark mode theme.

01 04 04 KVLogoMenu
  • Logout. Log out of GraphXR.

  • Home. Return to the Projects home page. _Toggle_Theme. Toggle the theme between light and dark mode.

  • Shortcut. Display a quick reference card of desktop shortcut keys. See also Shortcut Keys Reference.

  • About. Review the GraphXR version and release information.

GUI Navigation Controls

The GUI navigation interface at the bottom right of the canvas provides simulated 3D Virtual Reality (VR) navigation controls for use on the desktop.

01 04 29 GUINavControls
  • Click and hold the upper arrows to Move Right, Move Left, Move Up, or Move Down. Click the central circle to Reset the view to the center point of the data (similar to the Center To toolbar icon).

  • Click and hold the middle joystick-like controls to Rotate Left or Rotate Right.

  • Click and hold the lower arrow controls to zoom In or Out.