Skip to main content
Skip table of contents

Using Collections

GraphXR’s Collect Nodes / Explode Collections toolbar icons create special collection nodes that contain nodes of a given category that all have the same relationship to another node. This provides a way to simplify a graph quickly and to work with subsets of related data.

When you select data and either click the Collect Nodes icon or right-click and select Actions>Collect Nodes:

  • Temporary collection categories are created based on the selected nodes and their relationships.

    • Collection categories are named Collection_ plus the name of the category of nodes included (for example Collection_Character, Collection_Death, etc.).

    • The new collection categories appear in the Category legend. In the legend, the number of collection nodes of each type is listed, along with the number currently selected.

      Automatic properties are created for each collection category and shown in the Projects>Category tab and its Table. These are:

      • collection. A boolean set to true.

      • count. The number of nodes in the collection.

      • label. The label on each collection node, which includes its category label and the count (e.g. Image (43)).

      • of. The category label of the nodes in the collection (e.g. Photos, Character, etc.).

  • Individual collection nodes are indicated by four circles (or the icon set for the category, if any). displayed inside a node.

    • Each collection node contains the nodes of a category and relationship that are either unconnected or all connected to another node by a single relationship type.

    • The edges between the collection and its connected node(s) are collapsed into one. The relationship names (if any) remain the same, but the direction is reversed.

    • The collection node’s information window shows the category and the number of nodes in the collection, and displays a list of the individual nodes in the collection.

    • Properties set as captions in the original node category appear in the information window. If no captions have been set, the node ID displays.
      At any time you can change the properties displayed in a collection’s information panel. Go to Projects>Category, then click the collected category and the Caption checkbox for each property you want displayed.

To create collections:

  1. Select nodes of interest using any method.
    For clarity we’ll use a simple graph of Photo nodes connected by a single relationship to Location nodes. We’ve distributed the data according to photo ratings, but now we want to collect photos by location. So we’ll select all the Photo nodes.

  2. Right-click and choose Actions>Collect Nodes, or click the Collect Nodes icon in the toolbar.
    - Nodes of a single category connected by zero or one edge to another node are collected into separate collection nodes, and disappear from the graph.
    - The new collection category (Collection_Photos) appears in the Category legend.

To inspect and edit a collection:

  1. Click to select a collection node and display its information panel (right click and select Information, or click the Information icon in the toolbar). A list of the nodes in the collection is displayed.

  2. You can now:
    - Click the minus (- ) icon in the information panel to remove a node from a collection. The removed node and its edge appears outside the collection. You can de-select the collection node and click Collect Nodes again to add the removed node back to the collection if desired.
    - Select additional data (for example, after adding new data to the graph) and click Collect Nodes to add eligible nodes to your collections.

To explode a collection:

  1. Select one or more collection nodes using any method, or deselect all data to explode all collections.

  2. Right-click and choose Actions>Explode Nodes, or click the Explode Collections toolbar icon.
    All nodes in the selected collections are returned to the graph and those collection nodes are deleted. Note that the nodes are returned to the distributed positions they were in before being collected.
    A collection category is removed if all its collection nodes have been exploded.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.