Author
Dorian Taylor
Version
0.1
Created
December 4, 2022
Updated
January 21, 2023
December 12, 2023
Namespace URI
https://vocab.methodandstructure.com/graph-tool#
Preferred Namespace Prefix
cgto

Ontologies like the IBIS vocabulary are intended to only convey their essential semantic content. There are nevertheless additional constructs, that do not belong in the core vocabulary, that need to be expressed in order to fully operationalize the information it describes as a piece of user-facing software. Such constructs include the users of the environment, and the graphical representation of the network itself, from colour palette to the relative (or absolute) geometry of the individual nodes.

so what ingredients do we know we need?

With respect to the graph itself, the goal of this vocabulary is to provide just the information that only needs to be computed when the graph's content is changed, so the computations can be cached and used as inputs to more than one view.

Classes

This diagram shows the classes and properties defined in this document using solid lines, and third-party classes and properties using dashed lines.

Space

A graph tool needs a shared logical space to lay out its universe of discourse.

Subclass of:
sioc:Space

Back to Top

View

A partially or fully computed geometric rendering of a (sub)graph, or the structured information needed to do so.

Back to Top

Error

An error is a type of cgto:View the tool can send the user when something is wrong. It is more suitable to send as a response body than http:Response, which would be problematically self-referential.

Subclass of:
cgto:View

Back to Top

Index

An index relates a cgto:Space to a set of cgto:Inventory resources, via a set of cgto:Summary resources.

Subclass of:
sioc:Container

Back to Top

Inventory

An inventory is a de facto grouping of resources according to some criterion.

Subclass of:
sioc:Container

Back to Top

Summary

A summary indexes the available cgto:Inventory resources.

Subclass of:
qb:DataSet

Back to Top

Properties

This diagram depicts the ontology from the point of view of its properties.

focus

The entity that takes primary focus in the space is what will be shown, e.g. on the front page of a Web app.

Domain:
cgto:Space
Sub-property of:
sioc:space_of

Back to Top

view

Relates the space to a view of said space.

Domain:
cgto:Space
Range:
cgto:View
Sub-property of:
sioc:space_of
Inverse of:
cgto:view-of

Back to Top

view-of

Relates a view back to its cgto:Space.

Domain:
cgto:View
Range:
cgto:Space
Sub-property of:
sioc:has_space
Inverse of:
cgto:view

Back to Top

index

Connects the cgto:Space to its cgto:Index of resources.

Domain:
cgto:Space
Range:
cgto:Index
Sub-property of:
sioc:space_of
xhv:index

Back to Top

summary

Connects the cgto:Space to its cgto:Index of resources.

Domain:
cgto:Index
Range:
cgto:Summary
Sub-property of:
sioc:parent_of

Back to Top

by-class

Specifies the index of inventories organized by rdfs:Class.

Domain:
cgto:Index
Range:
cgto:Summary
Sub-property of:
cgto:summary

Back to Top

by-property

Connects the cgto:Space to its cgto:Index of resources.

Domain:
cgto:Index
Range:
cgto:Summary
Sub-property of:
cgto:summary

Back to Top

Inventory Summaries

We use the Data Cube Ontology to summarize and enumerate the resource inventories.

Data Structure Definitions

Data sets are described by data structure definitions which specify different component properties.

Resources by Class

This structure describes a data set that tabulates subject resources of a certain rdf:type.

Components:
cgto:class
cgto:subjects
cgto:subject-count

Resources by Property

This structure describes a data set that tabulates both subject and object resources by property (predicate).

Components:
cgto:property
cgto:subjects
cgto:subject-count
cgto:objects
cgto:object-count

Dimension Properties

Dimension properties denote the axes along which the data set can be partitioned.

class

Specifies the owl:Class found in the rdf:type of the subjects.

Domain:
qb:Observation
Range:
rdfs:Class

Back to Top

property

Specifies the property (predicate) in the statements from which subject and object resources are enumerated.

Domain:
qb:Observation
Range:
rdf:Property

Back to Top

Measure Properties

Measure properties record the experimental data, which in this case amounts to counts of resources.

subject-count

Specifies the number of subject resources in the selection criterion.

Domain:
qb:Observation
Range:
xsd:nonNegativeInteger

Back to Top

object-count

Specifies the number of object resources in the selection criterion.

Domain:
qb:Observation
Range:
xsd:nonNegativeInteger

Back to Top

Attribute Properties

Attribute properties are used to qualify the data. In this case they are being appropriated to link to the actual inventories of resources.

subjects

Domain:
qb:Observation
Range:
cgto:Inventory

Back to Top

objects

Domain:
qb:Observation
Range:
cgto:Inventory

Back to Top