Subgraphs

Containers are collections of subgraphs. Each subgraph represents a match of the query against the database.

All objects and links included in the container are represented by ITEM elements, all of which are included in a single SUBG-ITEMS element. Each ITEM element identifies the subgraph to which that database entity belongs. If an object appears in multiple subgraphs, or if it appears more than once in a single subgraph, it will also appear in multiple ITEM elements.

<SUBG-ITEMS>

Attributes  None.

Children 

ITEM zero or more Each ITEM element identifies the enclosing subgraph and specifies a member entity (object or link).

Content Model 

(ITEM*)

Example  See ITEM.

<SUBG-ATTRIBUTES>

Attributes  None.

Children 

SUBG-ATTRIBUTE zero or more Each SUBG-ATTRIBUTE element describes an attribute on subgraphs in the parent container and lists the values for specific subgraphs.

Content Model 

(SUBG-ATTRIBUTE*)

Example  See SUBG-ATTRIBUTE.

<SUBG-ATTRIBUTE>

Attributes 

NAME required The name of the subgraph attribute
DATA-TYPE required The data type of the attribute. See DataTypeEnum for a list of valid Proximity data types.

Children 

ATTR-VALUE zero or more The data file includes one ATTR-VALUE element for each instance of this attribute in the parent container, that is, one for each subgraph that has a value for this attribute. Each ATTR-VALUE specifies a single, possibly multi-dimensional, value. The file includes multiple ATTR-VALUE elements when an subgraph has multiple values for a specified attribute.

Content Model 

(ATTR-VALUE*)

Example 

<SUBG-ATTRIBUTES>
   <SUBG-ATTRIBUTE NAME="sample-membership" DATA-TYPE="INT">
      <ATTR-VALUE ITEM-ID="1">
         <COL-VALUE>0</COL-VALUE>
      </ATTR-VALUE>
      <ATTR-VALUE ITEM-ID="2">
         <COL-VALUE>1</COL-VALUE>
      </ATTR-VALUE>
   </SUBG-ATTRIBUTE>
   <SUBG-ATTRIBUTE NAME="originating-query" DATA-TYPE="STR">
      <ATTR-VALUE ITEM-ID="1">
         <COL-VALUE>research-clusters1</COL-VALUE>
      </ATTR-VALUE>
      <ATTR-VALUE ITEM-ID="2">
         <COL-VALUE>research-clusters1</COL-VALUE>
      </ATTR-VALUE>
   </SUBG-ATTRIBUTE>
</SUBG-ATTRIBUTES>

<ITEM>

Attributes 

SUBG-ID required The ID of the subgraph to which this object or link belongs. Objects and links can belong to multiple subgraphs and thus appear in multiple ITEM elements.
ITEM-ID required The ID of the object or link
ITEM-TYPE required Specifies whether the referenced entity is an object (O) or link (L)
NAME required The name of this item within the subgraph. Subgraphs are usually created as the result of running queries. Proximity queries assign labels to their vertices and edges (corresponding to the objects and links in the database); these labels are included in the resulting subgraphs.

Children  None.

Content Model 

EMPTY

Example 

<SUBG-ITEMS>
   <ITEM SUBG-ID="1" ITEM-ID="2" ITEM-TYPE="O" NAME="core_page"/>
   <ITEM SUBG-ID="1" ITEM-ID="7" ITEM-TYPE="O" NAME="linked_page"/>
   <ITEM SUBG-ID="1" ITEM-ID="4" ITEM-TYPE="L" NAME="linked_to"/>
   <ITEM SUBG-ID="2" ITEM-ID="9" ITEM-TYPE="O" NAME="core_page"/>
   <ITEM SUBG-ID="2" ITEM-ID="2" ITEM-TYPE="O" NAME="linked_page"/>
   <ITEM SUBG-ID="2" ITEM-ID="6" ITEM-TYPE="L" NAME="linked_to"/>
</SUBG-ITEMS>