Tool tree
gradeNot graded
load_ontologyAction
Load an ontology into the visible WebVOWL graph from an HTTP(S) ontology document IRI, VOWL JSON URL, or supplied ontology text.
View tool JSON
{
"name": "load_ontology",
"kind": "act",
"impl": "imperative",
"description": "Load an ontology into the visible WebVOWL graph from an HTTP(S) ontology document IRI, VOWL JSON URL, or supplied ontology text.",
"inputSchema": {
"type": "object",
"properties": {
"reuseCachedOntology": {
"type": "boolean",
"description": "Reuse a cached remote ontology and visualization if available. False or omission retrieves the original again, like Reload source."
},
"source": {
"description": "Where the ontology comes from.",
"oneOf": [
{
"type": "object",
"description": "An ontology document to fetch and parse.",
"properties": {
"kind": {
"const": "ontology-document-iri"
},
"documentIri": {
"type": "string",
"description": "HTTP(S) IRI of the ontology document to load.",
"maxLength": 2048,
"minLength": 1
}
},
"required": [
"kind",
"documentIri"
],
"additionalProperties": false
},
{
"type": "object",
"description": "An already converted VOWL JSON document to fetch.",
"properties": {
"kind": {
"const": "vowl-json-url"
},
"url": {
"type": "string",
"description": "HTTP(S) URL of the VOWL JSON document to load.",
"maxLength": 2048,
"minLength": 1
}
},
"required": [
"kind",
"url"
],
"additionalProperties": false
},
{
"type": "object",
"description": "Ontology text supplied directly, with its syntax named.",
"properties": {
"kind": {
"const": "ontology-text"
},
"text": {
"type": "string",
"description": "The ontology document text to parse.",
"maxLength": 1048576,
"minLength": 1
},
"format": {
"type": "string",
"description": "Syntax of the supplied text.",
"enum": [
"functional",
"manchester",
"owlxml",
"dl",
"krss1",
"krss2",
"rdfxml",
"turtle",
"trig",
"ntriples",
"nquads",
"jsonld"
]
},
"displayName": {
"type": "string",
"minLength": 1,
"maxLength": 256,
"description": "Optional local document name for provenance."
}
},
"required": [
"kind",
"text",
"format"
],
"additionalProperties": false
},
{
"type": "object",
"description": "A local VOWL JSON document supplied as text, like a selected JSON file.",
"properties": {
"kind": {
"const": "vowl-json-text"
},
"text": {
"type": "string",
"minLength": 1,
"maxLength": 1048576
},
"displayName": {
"type": "string",
"minLength": 1,
"maxLength": 256,
"description": "Optional local document name for provenance."
}
},
"required": [
"kind",
"text"
],
"additionalProperties": false
}
]
}
},
"required": [
"source"
],
"additionalProperties": false
},
"page": "/webvowl/"
}get_ontology_summaryAnswer
Summarize the loaded ontology, imports, namespaces, languages, diagnostics, and active visible view without reading SVG markup.
View tool JSON
{
"name": "get_ontology_summary",
"kind": "answer",
"impl": "imperative",
"description": "Summarize the loaded ontology, imports, namespaces, languages, diagnostics, and active visible view without reading SVG markup.",
"inputSchema": {
"type": "object",
"properties": {
"section": {
"type": "string",
"enum": [
"ontologyHeader",
"source",
"visibleGraphCounts",
"namespaces",
"imports",
"availableLabelLanguages",
"selectedLanguage",
"filters",
"warnings"
],
"description": "Optional section to retrieve as complete JSON fragments. Concatenate fragments before parsing."
},
"continuation": {
"type": "string",
"minLength": 1,
"maxLength": 128,
"description": "Same-section token; expires on content, revision or language changes, reload or eviction after eight records. Restart without it."
}
},
"required": [],
"additionalProperties": false
},
"page": "/webvowl/"
}find_ontology_elementsAnswer
Find bounded ontology elements by label or IRI and return stable references plus optional one-hop structural facts.
View tool JSON
{
"name": "find_ontology_elements",
"kind": "answer",
"impl": "imperative",
"description": "Find bounded ontology elements by label or IRI and return stable references plus optional one-hop structural facts.",
"inputSchema": {
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "Label or IRI text to search for.",
"minLength": 1,
"maxLength": 256
},
"kinds": {
"type": "array",
"description": "Restrict results to these element kinds.",
"items": {
"type": "string",
"enum": [
"class",
"datatype",
"individual",
"property"
]
},
"uniqueItems": true,
"maxItems": 4
},
"limit": {
"type": "integer",
"description": "Greatest number of matches to return.",
"minimum": 1,
"maximum": 25,
"default": 10
},
"includeNeighborhood": {
"type": "boolean",
"description": "Include one-hop structural facts for each match.",
"default": true
},
"continuation": {
"type": "string",
"description": "Continue a search with its returned token and unchanged inputs. Tokens expire after eight later pages; edits require restarting.",
"minLength": 1,
"maxLength": 128
}
},
"required": [
"query"
],
"additionalProperties": false
},
"page": "/webvowl/"
}reveal_ontology_neighborhoodAction
Temporarily reveal the complete admitted depth-two neighbourhood of exact semantic references. Refuses atomically above 25 references, 500 nodes, 1000 edges, 2000 labels or 10000 inspected adjacency entries. Canonical export and Share retain the ordinary view.
View tool JSON
{
"name": "reveal_ontology_neighborhood",
"kind": "act",
"impl": "imperative",
"description": "Temporarily reveal the complete admitted depth-two neighbourhood of exact semantic references. Refuses atomically above 25 references, 500 nodes, 1000 edges, 2000 labels or 10000 inspected adjacency entries. Canonical export and Share retain the ordinary view.",
"inputSchema": {
"type": "object",
"properties": {
"ontologyElementReferences": {
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"description": "An element addressed by its IRI.",
"properties": {
"kind": {
"type": "string",
"description": "Which kind of element this reference names.",
"enum": [
"class",
"datatype",
"individual",
"property"
]
},
"iri": {
"type": "string",
"description": "IRI of the element.",
"maxLength": 2048,
"minLength": 1
},
"roleKind": {
"type": "string",
"enum": [
"class",
"rdf-class",
"datatype",
"individual",
"object-property",
"data-property",
"annotation-property",
"rdf-property"
],
"description": "Exact semantic role when one IRI has multiple roles."
}
},
"required": [
"kind",
"iri"
],
"additionalProperties": false
},
{
"type": "object",
"description": "An anonymous element, valid only for the load generation given.",
"properties": {
"kind": {
"type": "string",
"description": "Which kind of element this reference names.",
"enum": [
"class",
"datatype",
"individual",
"property"
]
},
"loadGeneration": {
"type": "integer",
"description": "The load this anonymous identifier belongs to.",
"minimum": 1
},
"localId": {
"type": "string",
"description": "Identifier of the anonymous element within that load.",
"maxLength": 256,
"minLength": 1
},
"roleKind": {
"type": "string",
"enum": [
"class",
"rdf-class",
"datatype",
"individual",
"object-property",
"data-property",
"annotation-property",
"rdf-property"
],
"description": "Exact semantic role of the anonymous element."
}
},
"required": [
"kind",
"loadGeneration",
"localId"
],
"additionalProperties": false
}
]
},
"minItems": 1,
"maxItems": 25
}
},
"required": [
"ontologyElementReferences"
],
"additionalProperties": false
},
"page": "/webvowl/"
}clear_ontology_neighborhoodAction
Restore the ordinary visibility, positions, pins and camera after a temporary neighbourhood reveal.
View tool JSON
{
"name": "clear_ontology_neighborhood",
"kind": "act",
"impl": "imperative",
"description": "Restore the ordinary visibility, positions, pins and camera after a temporary neighbourhood reveal.",
"inputSchema": {
"type": "object",
"properties": {},
"required": [],
"additionalProperties": false
},
"page": "/webvowl/"
}set_visualization_viewAction
Apply supported language, filters, focus, layout, and viewport changes to the visible WebVOWL graph.
View tool JSON
{
"name": "set_visualization_view",
"kind": "act",
"impl": "imperative",
"description": "Apply supported language, filters, focus, layout, and viewport changes to the visible WebVOWL graph.",
"inputSchema": {
"type": "object",
"properties": {
"language": {
"type": "string",
"description": "Preferred label language tag.",
"minLength": 1,
"maxLength": 35
},
"nodesShown": {
"oneOf": [
{
"type": "object",
"properties": {
"mode": {
"enum": [
"auto",
"all"
]
}
},
"required": [
"mode"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"mode": {
"const": "exact"
},
"requestedCount": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"mode",
"requestedCount"
],
"additionalProperties": false
}
],
"description": "Select an exact number of drawable node occurrences, all eligible nodes, or the automatic target of 50. Read nodeCountStatus for committed counts."
},
"filters": {
"type": "object",
"description": "Which element groups the graph shows.",
"properties": {
"datatypes": {
"description": "Show or hide datatype nodes.",
"enum": [
"show",
"hide"
]
},
"objectProperties": {
"description": "Show or hide object properties.",
"enum": [
"show",
"hide"
]
},
"subclasses": {
"description": "Show or hide subclass relations.",
"enum": [
"show",
"hide"
]
},
"disjointness": {
"description": "Show or hide disjointness relations.",
"enum": [
"show",
"hide"
]
},
"setOperators": {
"description": "Show or hide set operator nodes.",
"enum": [
"show",
"hide"
]
}
},
"required": [],
"additionalProperties": false
},
"focus": {
"type": "array",
"description": "Entities to highlight; use viewport to move the view.",
"items": {
"oneOf": [
{
"type": "object",
"description": "An element addressed by its IRI.",
"properties": {
"kind": {
"type": "string",
"description": "Which kind of element this reference names.",
"enum": [
"class",
"datatype",
"individual",
"property"
]
},
"iri": {
"type": "string",
"description": "IRI of the element.",
"maxLength": 2048,
"minLength": 1
},
"roleKind": {
"type": "string",
"enum": [
"class",
"rdf-class",
"datatype",
"individual",
"object-property",
"data-property",
"annotation-property",
"rdf-property"
],
"description": "Exact semantic role when one IRI has multiple roles."
}
},
"required": [
"kind",
"iri"
],
"additionalProperties": false
},
{
"type": "object",
"description": "An anonymous element, valid only for the load generation given.",
"properties": {
"kind": {
"type": "string",
"description": "Which kind of element this reference names.",
"enum": [
"class",
"datatype",
"individual",
"property"
]
},
"loadGeneration": {
"type": "integer",
"description": "The load this anonymous identifier belongs to.",
"minimum": 1
},
"localId": {
"type": "string",
"description": "Identifier of the anonymous element within that load.",
"maxLength": 256,
"minLength": 1
},
"roleKind": {
"type": "string",
"enum": [
"class",
"rdf-class",
"datatype",
"individual",
"object-property",
"data-property",
"annotation-property",
"rdf-property"
],
"description": "Exact semantic role of the anonymous element."
}
},
"required": [
"kind",
"loadGeneration",
"localId"
],
"additionalProperties": false
}
]
},
"maxItems": 25
},
"layout": {
"type": "string",
"description": "Pause to retain the arrangement or resume automatic motion. Omit to leave the running/paused state unchanged.",
"enum": [
"pause",
"resume"
]
},
"viewport": {
"type": "string",
"description": "Zoom and center the visible graph, or locate the next focus. Omit to leave zoom and pan unchanged.",
"enum": [
"zoom-and-center",
"focus-next"
]
},
"zoomScale": {
"type": "number",
"description": "Magnification to apply, within the supported range.",
"minimum": 0.01,
"maximum": 4
},
"translation": {
"type": "object",
"description": "Absolute pan offset in viewport pixels. Changes neither magnification nor node arrangement. Applied before a viewport framing action.",
"properties": {
"xPx": {
"type": "number",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"yPx": {
"type": "number",
"minimum": -9007199254740991,
"maximum": 9007199254740991
}
},
"required": [
"xPx",
"yPx"
],
"additionalProperties": false
}
},
"required": [],
"additionalProperties": false
},
"page": "/webvowl/"
}export_visualizationAction
Create a browser-local SVG, VOWL JSON, Turtle or LaTeX artifact. SVG and LaTeX wait for layout settlement; JSON saves the current document and view, and Turtle uses the existing exporter without waiting for motion to end.
View tool JSON
{
"name": "export_visualization",
"kind": "act",
"impl": "imperative",
"description": "Create a browser-local SVG, VOWL JSON, Turtle or LaTeX artifact. SVG and LaTeX wait for layout settlement; JSON saves the current document and view, and Turtle uses the existing exporter without waiting for motion to end.",
"inputSchema": {
"type": "object",
"properties": {
"format": {
"type": "string",
"enum": [
"svg",
"vowl-json",
"turtle",
"latex"
],
"default": "svg",
"description": "Artifact format, matching the Export menu."
},
"filename": {
"type": "string",
"description": "Name for the exported file, using the selected format suffix.",
"minLength": 1,
"maxLength": 128
},
"settleTimeoutMs": {
"type": "integer",
"description": "How long to wait for the layout to settle.",
"minimum": 1000,
"maximum": 30000,
"default": 12000
},
"onTimeout": {
"type": "string",
"description": "Fail if the layout has not settled, or export anyway.",
"enum": [
"fail",
"best-effort"
],
"default": "fail"
}
},
"required": [],
"additionalProperties": false
},
"page": "/webvowl/"
}get_visualization_stateAnswer
Read the current visualization choices, actual layout status, zoom, pan, selection, and load state.
View tool JSON
{
"name": "get_visualization_state",
"kind": "answer",
"impl": "imperative",
"description": "Read the current visualization choices, actual layout status, zoom, pan, selection, and load state.",
"inputSchema": {
"type": "object",
"properties": {},
"required": [],
"additionalProperties": false
},
"page": "/webvowl/"
}get_visualization_arrangementAnswer
Read a page of drawn occurrences, their positions in graph pixels, pin state and movement capabilities. References expire on ontology replacement.
View tool JSON
{
"name": "get_visualization_arrangement",
"kind": "answer",
"impl": "imperative",
"description": "Read a page of drawn occurrences, their positions in graph pixels, pin state and movement capabilities. References expire on ontology replacement.",
"inputSchema": {
"type": "object",
"properties": {
"offset": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991,
"default": 0
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"default": 25
},
"ontologyElementReference": {
"oneOf": [
{
"type": "object",
"description": "An element addressed by its IRI.",
"properties": {
"kind": {
"type": "string",
"description": "Which kind of element this reference names.",
"enum": [
"class",
"datatype",
"individual",
"property"
]
},
"iri": {
"type": "string",
"description": "IRI of the element.",
"maxLength": 2048,
"minLength": 1
},
"roleKind": {
"type": "string",
"enum": [
"class",
"rdf-class",
"datatype",
"individual",
"object-property",
"data-property",
"annotation-property",
"rdf-property"
],
"description": "Exact semantic role when one IRI has multiple roles."
}
},
"required": [
"kind",
"iri"
],
"additionalProperties": false
},
{
"type": "object",
"description": "An anonymous element, valid only for the load generation given.",
"properties": {
"kind": {
"type": "string",
"description": "Which kind of element this reference names.",
"enum": [
"class",
"datatype",
"individual",
"property"
]
},
"loadGeneration": {
"type": "integer",
"description": "The load this anonymous identifier belongs to.",
"minimum": 1
},
"localId": {
"type": "string",
"description": "Identifier of the anonymous element within that load.",
"maxLength": 256,
"minLength": 1
},
"roleKind": {
"type": "string",
"enum": [
"class",
"rdf-class",
"datatype",
"individual",
"object-property",
"data-property",
"annotation-property",
"rdf-property"
],
"description": "Exact semantic role of the anonymous element."
}
},
"required": [
"kind",
"loadGeneration",
"localId"
],
"additionalProperties": false
}
]
}
},
"required": [],
"additionalProperties": false
},
"page": "/webvowl/"
}set_visualization_arrangementAction
Move, pin or unpin specific drawn occurrences without editing ontology facts. Coordinates use graph pixels; automatic motion retains its current state.
View tool JSON
{
"name": "set_visualization_arrangement",
"kind": "act",
"impl": "imperative",
"description": "Move, pin or unpin specific drawn occurrences without editing ontology facts. Coordinates use graph pixels; automatic motion retains its current state.",
"inputSchema": {
"type": "object",
"properties": {
"changes": {
"type": "array",
"minItems": 1,
"maxItems": 100,
"items": {
"type": "object",
"properties": {
"reference": {
"type": "object",
"properties": {
"loadGeneration": {
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"occurrenceId": {
"type": "string",
"minLength": 1,
"maxLength": 128,
"description": "Opaque drawing identity returned by get_visualization_arrangement."
}
},
"required": [
"loadGeneration",
"occurrenceId"
],
"additionalProperties": false
},
"xPx": {
"type": "number",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"yPx": {
"type": "number",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"isPinned": {
"type": "boolean"
}
},
"required": [
"reference"
],
"additionalProperties": false,
"anyOf": [
{
"required": [
"xPx",
"yPx"
]
},
{
"required": [
"isPinned"
]
}
],
"dependentRequired": {
"xPx": [
"yPx"
],
"yPx": [
"xPx"
]
}
}
}
},
"required": [
"changes"
],
"additionalProperties": false
},
"page": "/webvowl/"
}select_visualization_elementAction
Select a drawn occurrence and show its details as a human click does, or clear selection with a null reference. This does not edit ontology facts.
View tool JSON
{
"name": "select_visualization_element",
"kind": "act",
"impl": "imperative",
"description": "Select a drawn occurrence and show its details as a human click does, or clear selection with a null reference. This does not edit ontology facts.",
"inputSchema": {
"type": "object",
"properties": {
"reference": {
"oneOf": [
{
"type": "object",
"properties": {
"loadGeneration": {
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"occurrenceId": {
"type": "string",
"minLength": 1,
"maxLength": 128,
"description": "Opaque drawing identity returned by get_visualization_arrangement."
}
},
"required": [
"loadGeneration",
"occurrenceId"
],
"additionalProperties": false
},
{
"type": "null"
}
]
}
},
"required": [
"reference"
],
"additionalProperties": false
},
"page": "/webvowl/"
}reset_visualizationAction
Restore visualization defaults, clear focus and selection, and resume layout. Retain the loaded ontology and label language.
View tool JSON
{
"name": "reset_visualization",
"kind": "act",
"impl": "imperative",
"description": "Restore visualization defaults, clear focus and selection, and resume layout. Retain the loaded ontology and label language.",
"inputSchema": {
"type": "object",
"properties": {},
"required": [],
"additionalProperties": false
},
"page": "/webvowl/"
}set_visualization_modesAction
Set the same display modes and maximum label width offered in the Modes and Options menus.
View tool JSON
{
"name": "set_visualization_modes",
"kind": "act",
"impl": "imperative",
"description": "Set the same display modes and maximum label width offered in the Modes and Options menus.",
"inputSchema": {
"type": "object",
"properties": {
"colorExternals": {
"type": "boolean"
},
"compactNotation": {
"type": "boolean"
},
"nodeScaling": {
"type": "boolean"
},
"dynamicLabelWidth": {
"type": "boolean"
},
"pickAndPin": {
"type": "boolean"
},
"maxLabelWidthPx": {
"type": "integer",
"minimum": 20,
"maximum": 600,
"multipleOf": 10
},
"colorExternalsMode": {
"type": "string",
"enum": [
"same",
"gradient"
]
}
},
"required": [],
"additionalProperties": false,
"minProperties": 1
},
"page": "/webvowl/"
}set_layout_distancesAction
Set class and datatype layout distances in pixels, as with the human distance sliders.
View tool JSON
{
"name": "set_layout_distances",
"kind": "act",
"impl": "imperative",
"description": "Set class and datatype layout distances in pixels, as with the human distance sliders.",
"inputSchema": {
"type": "object",
"properties": {
"classDistancePx": {
"type": "integer",
"minimum": 10,
"maximum": 600,
"multipleOf": 10
},
"datatypeDistancePx": {
"type": "integer",
"minimum": 10,
"maximum": 600,
"multipleOf": 10
}
},
"required": [],
"additionalProperties": false,
"minProperties": 1
},
"page": "/webvowl/"
}get_ontology_element_detailsAnswer
Read the selection sidebar description. Large descriptions return exact JSON pages; continue with nextOffset and continuation. Edits require restarting.
View tool JSON
{
"name": "get_ontology_element_details",
"kind": "answer",
"impl": "imperative",
"description": "Read the selection sidebar description. Large descriptions return exact JSON pages; continue with nextOffset and continuation. Edits require restarting.",
"inputSchema": {
"type": "object",
"properties": {
"reference": {
"oneOf": [
{
"type": "object",
"description": "An element addressed by its IRI.",
"properties": {
"kind": {
"type": "string",
"description": "Which kind of element this reference names.",
"enum": [
"class",
"datatype",
"individual",
"property"
]
},
"iri": {
"type": "string",
"description": "IRI of the element.",
"maxLength": 2048,
"minLength": 1
},
"roleKind": {
"type": "string",
"enum": [
"class",
"rdf-class",
"datatype",
"individual",
"object-property",
"data-property",
"annotation-property",
"rdf-property"
],
"description": "Exact semantic role when one IRI has multiple roles."
}
},
"required": [
"kind",
"iri"
],
"additionalProperties": false
},
{
"type": "object",
"description": "An anonymous element, valid only for the load generation given.",
"properties": {
"kind": {
"type": "string",
"description": "Which kind of element this reference names.",
"enum": [
"class",
"datatype",
"individual",
"property"
]
},
"loadGeneration": {
"type": "integer",
"description": "The load this anonymous identifier belongs to.",
"minimum": 1
},
"localId": {
"type": "string",
"description": "Identifier of the anonymous element within that load.",
"maxLength": 256,
"minLength": 1
},
"roleKind": {
"type": "string",
"enum": [
"class",
"rdf-class",
"datatype",
"individual",
"object-property",
"data-property",
"annotation-property",
"rdf-property"
],
"description": "Exact semantic role of the anonymous element."
}
},
"required": [
"kind",
"loadGeneration",
"localId"
],
"additionalProperties": false
}
]
},
"offset": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991,
"description": "JSON offset from nextOffset. For nonzero offsets, supply continuation, loadGeneration and language from the previous page."
},
"loadGeneration": {
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991,
"description": "Generation returned with the first page; prevents mixing different ontologies."
},
"language": {
"type": [
"string",
"null"
],
"minLength": 1,
"maxLength": 35,
"description": "Language returned with the first page; prevents mixing translated descriptions."
},
"continuation": {
"type": "string",
"minLength": 1,
"maxLength": 128,
"description": "Token bound to the element, revision, language and next offset. Expires after eight newer pages or reload; restart without it."
}
},
"required": [
"reference"
],
"additionalProperties": false,
"dependentRequired": {
"offset": [
"loadGeneration",
"language"
],
"continuation": [
"offset",
"loadGeneration",
"language"
]
}
},
"page": "/webvowl/"
}get_visualization_share_linkAnswer
Read a share URL for the accepted remote ontology and current view, as in the Export menu. Local documents require JSON export. Continue long URLs using the returned continuation.
View tool JSON
{
"name": "get_visualization_share_link",
"kind": "answer",
"impl": "imperative",
"description": "Read a share URL for the accepted remote ontology and current view, as in the Export menu. Local documents require JSON export. Continue long URLs using the returned continuation.",
"inputSchema": {
"type": "object",
"properties": {
"continuation": {
"type": "object",
"properties": {
"pageToken": {
"type": "string",
"minLength": 1,
"maxLength": 128,
"description": "Opaque reference to one of the four most recently captured share URLs."
},
"offset": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"pageToken",
"offset"
],
"additionalProperties": false
}
},
"required": [],
"additionalProperties": false
},
"page": "/webvowl/"
}