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 top center of the canvas, to save, load, duplicate, export, 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.

    • Files, for managing and editing imported and internal files used in the project.

    • 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.

    • Agent, to access Kineviz Agent features for AI-assisted graph modeling and exploration.

    • 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 near the bottom of the window, which displays the tools usable on the data currently present or selected on the canvas.

  • Live Status Bar at the bottom edge of the window, which shows current database connection and amount of data, current number of views, AI Agent status, and more.

  • 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.

  • Kineviz Help menu (question icon) at the bottom of the left panel menu above the Kineviz logo, to display information about the current Kineviz version.

  • Kineviz logo menu at the bottom of the left panel menu, to Logout, go to the Home page, open other Recent Projects (or create a new project), Toggle Theme between light and dark mode, show Shortcuts reference and other Kineviz information.

    01 04 04 KVLogoMenu
  • A Minimap near the bottom right, to provide a live thumbnail of the entire canvas and its graph data. Left-click + drag to easily re-focus the view on another part of the graph.

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

    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, many of which include tabbed sub-panels organized by function. Click an icon to display its panel.

Additional icons for Kineviz extensions (e.g. Grove or Text Editor) or Sandbox tutorials can also be displayed on the Panel menu.

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.

Files panel

Files opens a panel to manage Project Files, including those for Kineviz Agent, any imported files (CSV, JSON, Excel, .png, etc.), and the database (if any).

01 04 20a FilesPanelView

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

Agent panel

Agent opens a panel to engage with and manage the Kineviz Agent, a built-in AI assistant for working with graph data in a Kineviz project.

01 04 26a AgentPanelView

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 for quick access to information and navigation among your Kineviz projects.

01 04 04 KVLogoMenu
  • Home. Return to the Projects home page.

  • Recent Projects and Create Project. _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 Kineviz version and release information.

  • Admin. Open the Administrator panel (if configured).

  • Current logged in user ID.

  • Logout. Log out of Kineviz.

Project Status Bar

In an open project, the live Status Bar at the bottom of the window includes:

  • Name of the database currently connected to the project (e.g. KoreDB, Neo4j, etc.)

  • Number of node and relationship tables in the connected database.

  • Icon to open the no-code Query Bar menu to query the connected database.

  • Number of nodes and edges currently showing on the canvas.

  • Icon to open the Table panel to inspect properties of nodes and edges on the canvas.

  • Number of Agent chat threads currently running.

  • Icon to open the Views panel.

  • A Saved or Unsaved status flag for data currently on the canvas.

    01 04 33 ProjectStatusBar

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.