Repository files navigation

This module lets you request data fromSPARQLendpoints in the vein ofd3-csv and friends. It is generating a JSON structure from SPARQL query results, you can use that in any way you like in your code, with or without D3.

The access through a SPARQL endpoint allows a faster and more efficient data preparation (once you gotthe hang of SPARQL and the RDF data model). Ultimately it keeps visualizations up to date. Think of SPARQL endpoints as the most flexible API imaginable.

Define the SPARQL query and endpoint:

// Author of Q3011087 (D3.js)varmikeQuery=`SELECT ?developerName WHERE {  wd:Q3011087 wdt:P178 ?developer.  ?developer rdfs:label ?developerName.  FILTER(LANG(?developerName) = 'en')}`wikidataUrl='https://query.wikidata.org/bigdata/namespace/wdq/sparql'

To query the endpoint and get the result:

d3.sparql(wikidataUrl,mikeQuery).then((data)=>{console.log(data);// [{'developerName': 'Mike Bostock'}]})

Moreexamples are provided in therepository.

• Transformation ofXSD Datatypes (e.g.xsd:dateTime,xsd:boolean, ...) to native JavaScript types.
• Reformatting of the JSON Structure to a d3 style layout while using the provided variables names of the SPARQL Query.

• OnlySELECT queries are supported. (This provides a projection of the graph data onto a table structure used by d3.)
• Currently only supports endpoints which are able to respond withapplication/sparql-results+json.

Using NPM:npm install d3-sparql. You can also use a CDN, for instancehttps://www.jsdelivr.com.

SeeCHANGELOG for details about available versions.

This package adds asparql function to the globald3 object:d3.sparql(endpoint, query, options = {}).

# d3. sparql(endpoint,query[,options = {}])<>

options is an optional object that will get merged with the second argument offetch().

d3.sparql(endpoint,query).then((data)=>…);

The initial development of this library byZazuko was supported by theCity of Zürich.