Class: ZPTQueryBuilder

ZPTQueryBuilder()

SPARQL query builder for ZPT navigation operations

Constructor

new ZPTQueryBuilder()

Source:

Classes

ZPTQueryBuilder

Methods

createNavigationView(config) → {string}

Create navigation view with complete state configuration

.

Create navigation view with complete state configuration

Parameters:
Name Type Description
config Object

Navigation configuration

Properties
Name Type Description
viewURI string

URI for the navigation view
sessionURI string

URI of parent session
query string

Natural language query
zoomLevel string

ZPT zoom level URI
panDomains Array

Array of pan domain URIs
tiltProjection string

ZPT tilt projection URI
selectedCorpuscles Array

Array of selected corpuscle URIs
temporalConstraint Object

Temporal filtering
Source:
Returns:

SPARQL INSERT query

Type
string

getCorpusGraphForZoom(zoomLevelURI) → {string}

Helper: Get appropriate corpus graph for zoom level

.

Helper: Get appropriate corpus graph for zoom level

Parameters:
Name Type Description
zoomLevelURI string

ZPT zoom level URI
Source:
Returns:

Graph URI for corpus data

Type
string

getPanDomainFilter(panDomains) → {string}

Helper: Generate pan domain filter

.

Helper: Generate pan domain filter

Parameters:
Name Type Description
panDomains Array

Array of pan domain URIs
Source:
Returns:

SPARQL filter clause

Type
string

getPrefixes() → {string}

Generate standard SPARQL prefixes for ZPT queries

.

Generate standard SPARQL prefixes for ZPT queries

Source:
Returns:

SPARQL prefix declarations

Type
string

getTemporalFilter(temporalConstraint) → {string}

Helper: Generate temporal filter

.

Helper: Generate temporal filter

Parameters:
Name Type Description
temporalConstraint Object

Temporal constraints
Source:
Returns:

SPARQL filter clause

Type
string

getTiltProjectionFilter(tiltProjectionURI) → {string}

Helper: Generate tilt projection filter

.

Helper: Generate tilt projection filter

Parameters:
Name Type Description
tiltProjectionURI string

ZPT tilt projection URI
Source:
Returns:

SPARQL filter clause

Type
string

getZoomLevelFilter(zoomLevelURI) → {string}

Helper: Generate zoom level filter

.

Helper: Generate zoom level filter

Parameters:
Name Type Description
zoomLevelURI string

ZPT zoom level URI
Source:
Returns:

SPARQL filter clause

Type
string

queryCrossZoomNavigation(corpuscleURI) → {string}

Query for cross-zoom navigation patterns

.

Query for cross-zoom navigation patterns

Parameters:
Name Type Description
corpuscleURI string

Corpuscle to analyze
Source:
Returns:

SPARQL SELECT query

Type
string

queryNavigationAnalytics(params) → {string}

Query for navigation analytics and patterns

.

Query for navigation analytics and patterns

Parameters:
Name Type Description
params Object

Analytics parameters
Source:
Returns:

SPARQL SELECT query

Type
string

queryNavigationHistory(params) → {string}

Query navigation history and provenance

.

Query navigation history and provenance

Parameters:
Name Type Description
params Object

Query parameters

Properties
Name Type Description
sessionURI string

Session to analyze
agentURI string

Agent to track
Source:
Returns:

SPARQL SELECT query

Type
string

queryNavigationViews(filters) → {string}

Query navigation views by parameters

.

Query navigation views by parameters

Parameters:
Name Type Description
filters Object

Filter parameters

Properties
Name Type Description
zoomLevel string

Filter by zoom level
sessionURI string

Filter by session
startTime Date

Filter by start time
endTime Date

Filter by end time
Source:
Returns:

SPARQL SELECT query

Type
string

selectCorpusclesByNavigation(params) → {string}

Query for corpuscles based on ZPT navigation parameters

.

Query for corpuscles based on ZPT navigation parameters

Parameters:
Name Type Description
params Object

Query parameters

Properties
Name Type Description
zoomLevel string

ZPT zoom level URI
panDomains Array

Pan domain filters
tiltProjection string

Tilt projection method
temporalConstraint Object

Temporal filtering
limit number

Result limit
Source:
Returns:

SPARQL SELECT query

Type
string

updateOptimizationScores(scores) → {string}

Update optimization scores for corpuscles

.

Update optimization scores for corpuscles

Parameters:
Name Type Description
scores Array

Array of score objects
Source:
Returns:

SPARQL UPDATE query

Type
string