Graph File

Prov Viewer currently supports two formats for loading graphs: The tool's own XML schema and PROV-N schema.

XML

Prov Viewer reads and writes graphs using its own proprietary XML Schema (input.xsd). The XML schema is divided in 2 components: a list of vertices and a list of edges.

##Vertex list

• id: The unique identification name for the vertex

• type: The vertex type category (Activity, Agent, Entity)

• label: A human-readable name for the vertex. The label can also be used as subtype.

• date: Contains the temporal information (timestamp)

• attributes: The list of attributes of the vertex

Attributes

• name: The name of the attribute

• value: The vertex value for this attribute

• quantity: (Internal usage for collapses) The number of vertices that composes this summarized vertex

• min: (Internal usage for collapses) The minimal value for this attribute

• max: (Internal usage for collapses) The maximum value for this attribute

• originalValues: (Internal usage for collapses) The list of values from all vertices that composes this summarized vertex

##Edge list

• id: The unique identification name for the edge

• type: The type of the relationship

• label: A human-readable name for the edge

• value: The value of this relationship, if any. This field is used to define the edge color and thickness

• sourceID: The ID of the source vertex

• targetID: The ID of the target vertex

An example using the input schema is as follows:

<vertex>
	<id>ag01</id>
	<type>Agent</type>
	<label>Joao</label>
	<date>0</date>
	<attributes>
		<attribute>
			<name>Level</name>
			<value>1</value>
		</attribute>
		<attribute>
			<name>Job</name>
			<value>Senior</value>
		</attribute>
	</attributes>
</vertex>
<vertex>
	<id>ac01</id>
	<type>Activity</type>
	<label>Action</label>
	<date>1</date>
	<attributes>
		<attribute>
			<name>Role</name>
			<value>Manager</value>
		</attribute>
		<attribute>
			<name>Task</name>
			<value>Aid Programmers</value>
		</attribute>
	</attributes>
</vertex>
<edge>
	<id>e01</id>
	<type>Neutral</type>
	<label>wasAssociatedWith</label>
	<value>0</value>
	<sourceid>ac01</sourceid>
	<targetid>ag01</targetid>
</edge>

PROV-N

Please refer to the Provenance Notation (https://www.w3.org/TR/prov-n/) for more details of writing your graph using this format.