A GraphXR project represents a 3-dimensional, functionally infinite space that includes the full capability to navigate, edit, and visualize graph data. When you first open a project, its space is empty. You can:

  • Import data by drag and drop, data mapping, or query.

  • Inspect, select, filter, add and delete, and edit data.

  • Create, refine, or extend a graph data model directly in GraphXR.

  • Run widely used graph algorithms such as Path Finding and Centrality.

  • Visualize data in the 3D space using:

    • Parametric layouts (2D or 3D scatter plots), Tree layouts, and Geometric Line, Circle, Grid, Cube, and Spiral layouts.

    • Filters on date, time, and other numerical properties.

    • Geospatial maps, for nodes with latitude and longitude properties.

  • Save and share graph data to data Views, Snapshots, GXRF or CSV archives, or to a connected Neo4j database. You can also save and export a data mapping as a JSON file.

On the desktop, a set of menus and controls provide the tools you’ll need to work with graph data:

  • A Main Menu along the left vertical edge of the project space, to open panels for importing, transforming, and displaying data.

  • A Legend, along the top right side of the space, to select nodes by category, tag, or property, and edges by relationship.

  • A context Toolbar, along the bottom of the space, to display the tools available to use on the data currently present and/or selected in the graph space.

  • A set of GUI Navigation controls, at the bottom right, to enable 3D navigation within the graph space. GraphXR can also be used with WebX-connected virtual reality (VR); these controls let you emulate the VR experience to some degree on the desktop.

Main menu

The Main menu on the left edge of the graph space provides access to menu panels. Most panels are further divided into tabs. Simply click its icon to display the panel.

Mouse over an icon to display its label, or click the Main menu icon at the top left to show or hide the icon labels.

The Main menu panels are:

  • Project panel, to review graph entities, set preferences, import and export data, and access extensions.

    Tabs include:

    • Category and Relationship tabs, to enable you to pull specific nodes or edges from the database and set preferences for their display in the graph space.

    • Settings tab, to control the display of edges and the size of nodes, to show or hide the Snapshot dialog, Pin icon, and node information, and to select default or custom icon sheets for nodes.

    • Data tab, to import data in standard formats such as CSV and GXRF, save data as a CSV archive, GXRF, or Neo4j database, and to save GXRF data views to the server.

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

  • Query panel, to enter and save Cypher queries on a Neo4j database, and to run queries on a SQL database, CSV file, or a JSON or Gremlin environment. The SQL and CSV tabs include the Mapping Editor to create mappings that transform data in a flat CSV file or SQL table into a specified graph pattern.

  • Transform panel, to transform graph data directly in GraphXR.

    This powerful suite of data operators includes:

    • f(x), to execute functions similar to formulas in Excel and SQL, and functions in MapReduce frameworks. This provides mathematical formulas to transform one column of data to another.

    • Extract, to extract properties from existing nodes into new nodes and relationships, creating a new category and relationship in the process.

    • Aggregate, to collect properties from a starting node's neighboring edges and nodes, apply a calculation, and write the result back to the starting node as a property.

    • 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. You can use this to simplify the graph.

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

  • Table panel, to view data by Category or Relationship in a searchable tabular format. Enhanced Tables let you select, sort, edit, reformat, and then export the edited table.

  • Layout panel, to modify and apply Force, Parametric,Geometric, and Tree layouts to all or part of your data.

  • Filter panel, to hide data by Node or Edge properties using multiple composable filters.

  • Algorithm panel, to run Path Finding, Centrality, and Community Detection graph algorithms and add the result to nodes or edges as a property value.

  • Map panel, to work with geospatial data on a world map. Nodes with latitude and longitude coordinates are automatically dropped onto the map.

Additional functions are provided at bottom left of the project space:

  • Logout, to log out of GraphXR.

  • Home, to return to the Projects page.

  • Shortcut Key, to display the keyboard and mouse shortcuts available for efficient navigation and data selection on the desktop. For details, see Shortcut Keys Reference.

  • About, for GraphXR version information.

Legend

A legend at the top right corner of the project space lets you review and select data by Category, Relationship, Tag, or Property.

Selecting Category, Tag, or Property displays a list of categories, tags, or properties present in the data, and the number of currently selected and total nodes of each. Likewise, selecting Relationship displays a list of the relationships in the data, and the number of currently selected and total edges for each. You can:

  • Monitor how many nodes or relationships of each category, tag, property, or relationship are currently selected. Adding or subtracting from a selection immediately updates the numbers.

  • Click a list item to select all the nodes for a category, tag, or property, or all the edges for a relationship.

  • Click the colored line or dot next to a list item to select a different color for a relationship, tag, or property, or a different icon style for a category.

For details on selecting colors and icons, see Selecting Colors and Labels.

Context Toolbar

The context toolbar at the bottom edge of the graph space displays icons for actions available for the data currently present and/or selected in the graph space.

Before you load any data, the context menu items are:

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

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

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

Once you load or create a node, more tool icons appear. Some are available only when you select more than one node or edge, and some only when you select a single node or a node that has an associated url and weblink property.

After you bring data into a project, the context menu items are:

  • Delete. Deletes selected nodes and edges.

  • Select Visible Nodes. Selects all nodes currently visible in the graph space (i.e. those not hidden using Hide Selection or by de-selecting the Visible checkbox for a category or relationship in the Project panel).

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

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

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

  • Leaf Trimming. Temporarily collapse nodes with only one connected edge into a super node and super edge, which can then be deleted or restored.

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

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

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

When you select any set of nodes, you see additional icons:

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

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

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

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

  • Hide Selection. Hides selected nodes and edges.

  • Un-Hide Selection. Displays after you select and hide nodes. It restores hidden nodes and edges to the graph space and de-selects them.

When you select a single node, you see these additional icons:

  • 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 graph space 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 an information window for a single selected node or relationship which shows detailed information about a node's Properties and Neighbors or a relationship’s Properties. If desired, you can add properties and their values in this window.

Right-click to display a floating context menu of the tools available for your current selection.

GUI Navigation Controls

The GUI navigation panel at the bottom right of the graph space provides simulated Virtual Reality (VR) controls for use on the desktop.

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

Keyboard and mouse shortcuts are also available for navigation controls. Click the Shortcut Key icon at the lower left edge of the project space to display a reference panel.