Virtuoso Open-Source Wiki
Virtuoso Open-Source, OpenLink Data Spaces, and OpenLink Ajax Toolkit
Advanced Search
Help?
Location: / Dashboard / Main / VirtFacetBrowserInstallConfig

Virtuoso Faceted Browser Installation and configuration

Prerequisites

Requires Virtuoso 6.0 TP1 or higher for use.

Pre Installation

If you have an existing Virtuoso 6.x installation, and your Quad Store has more than 10,000 triples, please run these commands using the Virtuoso isql program before installing the Faceted Browser VAD.

Note: This step may take sometime depending on how many triples are already in your Quad Store.

VAD Package Installation

  1. Download the Virtuoso Faceted Browser VAD package, and install it using the Install Packages section of the System Admin -> Packages tab of the Conductor.



  2. Grant select privileges on the RDF_QUAD table to the SPARQL user:

    GRANT SELECT ON DB.DBA.RDF_QUAD TO "SPARQL";

  3. An updated Virtuoso RDF Mappers VAD may be required. Download the RDF Mappers VAD package, and install it as you did the Virtuoso Faceted Browser VAD, above.



  4. The HTML interface of the Faceted Browser Engine is exposed at: http://<cname>/fct, where "cname" is the <hostname>:<port-number> your Virtuoso instance is running on.



  5. The Faceted Browser Engine exposes a REST API at the endpoint: http://<cname>/fct/service.

Post Installation

  1. Build Full Text Indexes by running the following commands using the Virtuoso isql program:

    RDF_OBJ_FT_RULE_ADD (null, null, 'All'); VT_INC_INDEX_DB_DBA_RDF_OBJ ();

  2. Run the following procedure using the Virtuoso isql program to periodically populate label lookup tables and activate the Label text box of the URI Lookup(by Label) tab:

    urilbl_ac_init_db()

  3. Run the following procedure using the Virtuoso isql program to calculate the IRI ranks. Note: This should be re-run periodically as the data grows to re-rank the IRIs.

    s_rank()

  4. Sponge some data to load some RDF triples in the quad store. This can easily be done by loading the following URL in a Web browser, as it will use the built-in Virtuoso description.vsp page to provides a hypertext description of RDF Linked Data. You may substitute any live Web page URL for "http://news.cnet.com/" but it is best if you select one known to have plenty of data.

    http://<cname>/about/html/http://news.cnet.com/





  5. Use the Faceted Browser Search and Find User Interface to search for information on "CNET"



  6. Results of the following form should be returned for the data sponged.



  7. Click Types link shown at the right vertical Navigation
  8. Results of the classes/properties should be returned:



  9. To exclude a type, un-tick the checkbox associated with the type:



  10. Click the Type URI link
  11. Results of excluding the Type(s) should be shown:



  12. The Faceted Browser Web service endpoint can also be queried to obtain the same results.
  13. In the Label text box of the URI Lookup (by Label) tab, enter the name of an rdfs label to be Described:



  14. Select a URI from the list of available Labels to obtain a description of the URI:



  15. In the URI text box of the URI Lookup tab enter the name URI to be Described:



  16. Select a URI from the list of available Labels to obtain a description of the URI:



  17. If data is loaded into the quad store via DML functions (TTLP, RDF_LOAD_RDFXML, etc.), the following procedure needs to be run from isql to rebuild the free text indexes each time:

    VT_INC_INDEX_DB_DBA_RDF_OBJ ()

Usage Statistics

  1. Use the Faceted Browser Search and Find User Interface to search for information on "Michael Jackson":



  2. Results of the following form should be returned for the data sponged.



  3. Click the "Types" link under "Navigation"
  4. Results about "Michael Jackson" as Type/Label/Count list should be returned.
  5. Click a type link, for ex.:

    dbpedia-owl:Artist





  6. Should be shown type results and:

    Displaying types of e1 where: e1 has any property whose value contains "Michael Jackson". e1 is a dbpedia-owl:Artist . Drop





  7. Click the "Show values" link under "Navigation"
  8. Results should be shown for "Michael Jackson" as values and text summaries associated with pattern:

    Displaying values and text summaries associated with pattern e1 where: e1 has any property whose value contains "Michael Jackson". e1 is a dbpedia-owl:Artist . Drop

  9. Click the link:

    dbpedia:Michael_Jackson





  10. Results about "Michael Jackson" as property/value list should be returned:



  11. Click the "Usage Statistics" link under "Actions" shown right of the list.
  12. Results of usage statistics for "Michael Jackson" grouped in 4 tabs should be shown:
    1. Referenced by Graphs: shows how many times the URI is found as subject in the relevant graph(s):

      sparql select ?g count (*) where { graph ?g { <URI> ?p ?o } } group by ?g order by desc 2 limit 20;





    2. Source Graphs: shows how many times the URI is found as object in the relevant graph(s):

      sparql select ?g count (*) where { graph ?g { ?s ?p <URI> } } group by ?g order by desc 2 limit 20;





    3. Direct co-references: shows results as subject and calculated rank, based on running transitive closure over owl:sameAs of the URI in subject or object:

      sparql select ?syn ( sql:rnk_scale (<LONG::IRI_RANK> (?syn))) where { { select ?s ?syn where { {?syn owl:sameAs ?s } union {?s owl:sameAs ?syn} } } option (transitive, t_distinct, t_min (0), T_in (?s), t_out (?syn)) . filter (!isliteral (?syn) && ?s = <URI> ) } order by desc 2 limit 20;





    4. Indirect co-references: shows expanded results for objects concur with the URI by IFP:

      sparql select distinct ?syn ?p ?o (sql:rnk_scale (<LONG::IRI_RANK> (?syn))) where { <URI> ?p ?o . filter (0 != (<LONG::bif:rdf_is_sub> ("b3sifp", ?p, lod:ifp_like, 3))) . ?syn ?p ?o . } order by desc 4 limit 20;





Tutorials

Related

Powered By Virtuoso