pho 0.5 → 0.6

data/doc/rdoc/classes/Pho/ResourceHash/SetAlgebra.html

@@ -92,8 +92,8 @@ Class providing set algebra methods over triple hashes
       <h3 class="section-bar">Methods</h3>
 
       <div class="name-list">
-      <a href="#M000079">minus</a>&nbsp;&nbsp;
-      <a href="#M000080">object_in_array?</a>&nbsp;&nbsp;
+      <a href="#M000082">minus</a>&nbsp;&nbsp;
+      <a href="#M000083">object_in_array?</a>&nbsp;&nbsp;
       </div>
     </div>
 
@@ -115,19 +115,20 @@ Class providing set algebra methods over triple hashes
     <div id="methods">
       <h3 class="section-bar">Public Class methods</h3>
 
-      <div id="method-M000079" class="method-detail">
-        <a name="M000079"></a>
+      <div id="method-M000082" class="method-detail">
+        <a name="M000082"></a>
 
         <div class="method-heading">
-          <a href="#M000079" class="method-signature">
+          <a href="#M000082" class="method-signature">
           <span class="method-name">minus</span><span class="method-args">(first, second)</span>
           </a>
         </div>
       
         <div class="method-description">
           <p>
-Accepts two triple hashes, expressed as RDF-in-JSON and returns a new Ruby
-data structure that constitutes the different between the two graphs
+Accepts two triple hashes, expressed as <a
+href="../RDF.html">RDF</a>-in-JSON and returns a new Ruby data structure
+that constitutes the different between the two graphs
 </p>
 <p>
 i.e. the return value will be a hash containing the triples that are in the
@@ -138,8 +139,8 @@ first graph but which are not present in the second.
  second:: the second graph.
 </pre>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000079-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000079-source">
+            onclick="toggleCode('M000082-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000082-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/pho/resource_hash.rb, line 20</span>
       <span class="ruby-keyword kw">def</span> <span class="ruby-constant">SetAlgebra</span>.<span class="ruby-identifier">minus</span>(<span class="ruby-identifier">first</span>, <span class="ruby-identifier">second</span>)
@@ -182,11 +183,11 @@ first graph but which are not present in the second.
         </div>
       </div>
 
-      <div id="method-M000080" class="method-detail">
-        <a name="M000080"></a>
+      <div id="method-M000083" class="method-detail">
+        <a name="M000083"></a>
 
         <div class="method-heading">
-          <a href="#M000080" class="method-signature">
+          <a href="#M000083" class="method-signature">
           <span class="method-name">object_in_array?</span><span class="method-args">(array, val)</span>
           </a>
         </div>
@@ -197,8 +198,8 @@ Is there an object in the specified array, that matches the provided
 description
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000080-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000080-source">
+            onclick="toggleCode('M000083-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000083-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/pho/resource_hash.rb, line 57</span>
       <span class="ruby-keyword kw">def</span> <span class="ruby-constant">SetAlgebra</span>.<span class="ruby-identifier">object_in_array?</span>(<span class="ruby-identifier">array</span>, <span class="ruby-identifier">val</span>)

data/doc/rdoc/classes/Pho/Snapshot.html

@@ -81,7 +81,7 @@
     <div id="description">
       <p>
 In the Talis Platform a &quot;snapshot&quot; is an <a
-href="Snapshot.html#M000159">backup</a> of the contents of a <a
+href="Snapshot.html#M000179">backup</a> of the contents of a <a
 href="Store.html">Store</a>
 </p>
 <p>
@@ -102,11 +102,11 @@ A snapshot can be generated (or scheduled) using the Store.snapshot method.
       <h3 class="section-bar">Methods</h3>
 
       <div class="name-list">
-      <a href="#M000159">backup</a>&nbsp;&nbsp;
-      <a href="#M000157">new</a>&nbsp;&nbsp;
-      <a href="#M000156">parse</a>&nbsp;&nbsp;
-      <a href="#M000155">read_from_store</a>&nbsp;&nbsp;
-      <a href="#M000158">read_md5</a>&nbsp;&nbsp;
+      <a href="#M000179">backup</a>&nbsp;&nbsp;
+      <a href="#M000177">new</a>&nbsp;&nbsp;
+      <a href="#M000176">parse</a>&nbsp;&nbsp;
+      <a href="#M000175">read_from_store</a>&nbsp;&nbsp;
+      <a href="#M000178">read_md5</a>&nbsp;&nbsp;
       </div>
     </div>
 
@@ -176,19 +176,19 @@ The URL from which the snapshot can be retrieved
     <div id="methods">
       <h3 class="section-bar">Public Class methods</h3>
 
-      <div id="method-M000157" class="method-detail">
-        <a name="M000157"></a>
+      <div id="method-M000177" class="method-detail">
+        <a name="M000177"></a>
 
         <div class="method-heading">
-          <a href="#M000157" class="method-signature">
+          <a href="#M000177" class="method-signature">
           <span class="method-name">new</span><span class="method-args">(url, md5_url, size, units, date)</span>
           </a>
         </div>
       
         <div class="method-description">
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000157-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000157-source">
+            onclick="toggleCode('M000177-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000177-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/pho/snapshot.rb, line 76</span>
     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">initialize</span>(<span class="ruby-identifier">url</span>, <span class="ruby-identifier">md5_url</span>, <span class="ruby-identifier">size</span>, <span class="ruby-identifier">units</span>, <span class="ruby-identifier">date</span>)
@@ -203,21 +203,21 @@ The URL from which the snapshot can be retrieved
         </div>
       </div>
 
-      <div id="method-M000156" class="method-detail">
-        <a name="M000156"></a>
+      <div id="method-M000176" class="method-detail">
+        <a name="M000176"></a>
 
         <div class="method-heading">
-          <a href="#M000156" class="method-signature">
+          <a href="#M000176" class="method-signature">
           <span class="method-name">parse</span><span class="method-args">(storeuri, content)</span>
           </a>
         </div>
       
         <div class="method-description">
           <p>
-Class method to <a href="Snapshot.html#M000156">parse</a> the RDF response
-from the API, e.g. as produced by the <a
-href="Store.html#M000150">Store.get_snapshots</a> method and create a <a
-href="Snapshot.html#M000157">new</a> <a href="Snapshot.html">Snapshot</a>
+Class method to <a href="Snapshot.html#M000176">parse</a> the <a
+href="RDF.html">RDF</a> response from the API, e.g. as produced by the <a
+href="Store.html#M000170">Store.get_snapshots</a> method and create a <a
+href="Snapshot.html#M000177">new</a> <a href="Snapshot.html">Snapshot</a>
 object. At the moment the Platform only supports single snapshot.
 </p>
 <p>
@@ -228,8 +228,8 @@ If the response was an error, then an exception will be thrown
  content:: response from the API
 </pre>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000156-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000156-source">
+            onclick="toggleCode('M000176-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000176-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/pho/snapshot.rb, line 52</span>
     <span class="ruby-keyword kw">def</span> <span class="ruby-constant">Snapshot</span>.<span class="ruby-identifier">parse</span>(<span class="ruby-identifier">storeuri</span>, <span class="ruby-identifier">content</span>)
@@ -260,11 +260,11 @@ If the response was an error, then an exception will be thrown
         </div>
       </div>
 
-      <div id="method-M000155" class="method-detail">
-        <a name="M000155"></a>
+      <div id="method-M000175" class="method-detail">
+        <a name="M000175"></a>
 
         <div class="method-heading">
-          <a href="#M000155" class="method-signature">
+          <a href="#M000175" class="method-signature">
           <span class="method-name">read_from_store</span><span class="method-args">(store)</span>
           </a>
         </div>
@@ -279,8 +279,8 @@ Read snapshot data from the given store
 </td></tr>
 </table>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000155-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000155-source">
+            onclick="toggleCode('M000175-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000175-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/pho/snapshot.rb, line 34</span>
     <span class="ruby-keyword kw">def</span> <span class="ruby-constant">Snapshot</span>.<span class="ruby-identifier">read_from_store</span>(<span class="ruby-identifier">store</span>)
@@ -300,11 +300,11 @@ Read snapshot data from the given store
 
       <h3 class="section-bar">Public Instance methods</h3>
 
-      <div id="method-M000159" class="method-detail">
-        <a name="M000159"></a>
+      <div id="method-M000179" class="method-detail">
+        <a name="M000179"></a>
 
         <div class="method-heading">
-          <a href="#M000159" class="method-signature">
+          <a href="#M000179" class="method-signature">
           <span class="method-name">backup</span><span class="method-args">(store, dir=Dir.tmpdir)</span>
           </a>
         </div>
@@ -317,7 +317,7 @@ published value. If they don&#8216;t match then a RuntimeError will be
 raised
 </p>
 <table>
-<tr><td valign="top">store:</td><td>the store to <a href="Snapshot.html#M000159">backup</a>
+<tr><td valign="top">store:</td><td>the store to <a href="Snapshot.html#M000179">backup</a>
 
 </td></tr>
 <tr><td valign="top">dir:</td><td>directory in which snapshot will be stored
@@ -325,8 +325,8 @@ raised
 </td></tr>
 </table>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000159-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000159-source">
+            onclick="toggleCode('M000179-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000179-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/pho/snapshot.rb, line 96</span>
     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">backup</span>(<span class="ruby-identifier">store</span>, <span class="ruby-identifier">dir</span>=<span class="ruby-constant">Dir</span>.<span class="ruby-identifier">tmpdir</span>)
@@ -356,11 +356,11 @@ raised
         </div>
       </div>
 
-      <div id="method-M000158" class="method-detail">
-        <a name="M000158"></a>
+      <div id="method-M000178" class="method-detail">
+        <a name="M000178"></a>
 
         <div class="method-heading">
-          <a href="#M000158" class="method-signature">
+          <a href="#M000178" class="method-signature">
           <span class="method-name">read_md5</span><span class="method-args">(client=HttpClient.new())</span>
           </a>
         </div>
@@ -370,8 +370,8 @@ raised
 Read the published MD5 value
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000158-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000158-source">
+            onclick="toggleCode('M000178-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000178-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/pho/snapshot.rb, line 86</span>
     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">read_md5</span>(<span class="ruby-identifier">client</span>=<span class="ruby-constant">HttpClient</span>.<span class="ruby-identifier">new</span>())

data/doc/rdoc/classes/Pho/Sparql.html

@@ -114,6 +114,56 @@ Class <a href="Sparql/SparqlHelper.html" class="link">Pho::Sparql::SparqlHelper<
           <td>=</td>
           <td class="context-item-value">&quot;application/sparql-results+json&quot;</td>
         </tr>
+        <tr class="top-aligned-row context-row">
+          <td class="context-item-name">SYMMETRIC_BOUNDED_DESCRIPTION</td>
+          <td>=</td>
+          <td class="context-item-value">&lt;&lt;-EOL     CONSTRUCT {?uri ?p ?o . ?s ?p2 ?uri .} WHERE { {?uri ?p ?o .} UNION {?s ?p2 ?uri .} }     EOL</td>
+          <td width="3em">&nbsp;</td>
+          <td class="context-item-desc">
+Includes all statements along both in-bound and out-bound arc paths
+
+<p>
+See <a
+href="http://n2.talis.com/wiki/Bounded_Descriptions_in_RDF">n2.talis.com/wiki/Bounded_Descriptions_in_RDF</a>
+</p>
+</td>
+        </tr>
+        <tr class="top-aligned-row context-row">
+          <td class="context-item-name">LABELLED_BOUNDED_DESCRIPTION</td>
+          <td>=</td>
+          <td class="context-item-value">&lt;&lt;-EOL     PREFIX rdfs: &lt;http://www.w3.org/2000/01/rdf-schema#&gt;      CONSTRUCT {        ?uri ?p ?o .         ?o rdfs:label ?label .         ?o rdfs:comment ?comment .         ?o &lt;http://www.w3.org/2004/02/skos/core#prefLabel&gt; ?plabel .         ?o rdfs:seeAlso ?seealso.     } WHERE {       ?uri ?p ?o .        OPTIONAL {          ?o rdfs:label ?label .       }        OPTIONAL {         ?o &lt;http://www.w3.org/2004/02/skos/core#prefLabel&gt; ?plabel .        }        OPTIONAL {         ?o rdfs:comment ?comment .        }        OPTIONAL {          ?o rdfs:seeAlso ?seealso.       }     }         EOL</td>
+          <td width="3em">&nbsp;</td>
+          <td class="context-item-desc">
+Similar to Concise Bounded Description but includes labels for referenced
+resources
+
+<p>
+See <a
+href="http://n2.talis.com/wiki/Bounded_Descriptions_in_RDF">n2.talis.com/wiki/Bounded_Descriptions_in_RDF</a>
+</p>
+</td>
+        </tr>
+        <tr class="top-aligned-row context-row">
+          <td class="context-item-name">SYMMETRIC_LABELLED_BOUNDED_DESCRIPTION</td>
+          <td>=</td>
+          <td class="context-item-value">&lt;&lt;-EOL     PREFIX rdfs: &lt;http://www.w3.org/2000/01/rdf-schema#&gt;      CONSTRUCT {       ?uri ?p ?o .        ?o rdfs:label ?label .        ?o rdfs:comment ?comment .        ?o rdfs:seeAlso ?seealso.        ?s ?p2 ?uri .        ?s rdfs:label ?label .        ?s rdfs:comment ?comment .        ?s rdfs:seeAlso ?seealso.     } WHERE {        { ?uri ?p ?o .          OPTIONAL {            ?o rdfs:label ?label .         }          OPTIONAL {           ?o rdfs:comment ?comment .         }          OPTIONAL {           ?o rdfs:seeAlso ?seealso.         }        }        UNION {         ?s ?p2 ?uri .          OPTIONAL {           ?s rdfs:label ?label .         }          OPTIONAL {           ?s rdfs:comment ?comment .         }          OPTIONAL {           ?s rdfs:seeAlso ?seealso.         }        }      }         EOL</td>
+          <td width="3em">&nbsp;</td>
+          <td class="context-item-desc">
+Derived from both the Symmetric and Labelled Bounded Descriptions. Includes
+all in-bound and out-bound arc paths, with labels for any referenced
+resources.
+
+<p>
+See <a
+href="http://n2.talis.com/wiki/Bounded_Descriptions_in_RDF">n2.talis.com/wiki/Bounded_Descriptions_in_RDF</a>
+</p>
+</td>
+        </tr>
+        <tr class="top-aligned-row context-row">
+          <td class="context-item-name">DESCRIPTIONS</td>
+          <td>=</td>
+          <td class="context-item-value">{       :cbd =&gt; &quot;DESCRIBE ?uri&quot;,       :scbd =&gt; SYMMETRIC_BOUNDED_DESCRIPTION,       :lcbd =&gt; LABELLED_BOUNDED_DESCRIPTION,       :slcbd =&gt; SYMMETRIC_LABELLED_BOUNDED_DESCRIPTION</td>
+        </tr>
         </table>
       </div>
     </div>

data/doc/rdoc/classes/Pho/Sparql/SparqlClient.html

@@ -94,13 +94,14 @@ A simple SPARQL client that handles the basic HTTP traffic
       <div class="name-list">
       <a href="#M000003">add_default_graph</a>&nbsp;&nbsp;
       <a href="#M000004">add_named_graph</a>&nbsp;&nbsp;
-      <a href="#M000009">ask</a>&nbsp;&nbsp;
-      <a href="#M000008">construct</a>&nbsp;&nbsp;
-      <a href="#M000006">describe</a>&nbsp;&nbsp;
-      <a href="#M000007">multi_describe</a>&nbsp;&nbsp;
+      <a href="#M000010">ask</a>&nbsp;&nbsp;
+      <a href="#M000009">construct</a>&nbsp;&nbsp;
+      <a href="#M000007">describe</a>&nbsp;&nbsp;
+      <a href="#M000006">describe_uri</a>&nbsp;&nbsp;
+      <a href="#M000008">multi_describe</a>&nbsp;&nbsp;
       <a href="#M000002">new</a>&nbsp;&nbsp;
       <a href="#M000005">query</a>&nbsp;&nbsp;
-      <a href="#M000010">select</a>&nbsp;&nbsp;
+      <a href="#M000011">select</a>&nbsp;&nbsp;
       </div>
     </div>
 
@@ -161,8 +162,9 @@ Content Negotiation
           <td class="context-item-name">supports_rdf_json</td>
           <td class="context-item-value">&nbsp;[RW]&nbsp;</td>
           <td class="context-item-desc">
-Configures whether the remote endpoint supports the RDF-in-JSON
-specification for serializing RDF graphs as JSON. Will default to false.
+Configures whether the remote endpoint supports the <a
+href="../RDF.html">RDF</a>-in-JSON specification for serializing <a
+href="../RDF.html">RDF</a> graphs as JSON. Will default to false.
 
 </td>
         </tr>
@@ -198,15 +200,19 @@ Will default to true.
           <p>
 Initialize a client for a specific endpoint
 </p>
-<pre>
- endpoint:: uri of the SPARQL endpoint
- client:: optionally, a reference to an existing HTTPClient object instance
-</pre>
+<table>
+<tr><td valign="top">endpoint:</td><td>uri of the SPARQL endpoint
+
+</td></tr>
+<tr><td valign="top">client:</td><td>optionally, a reference to an existing HTTPClient object instance
+
+</td></tr>
+</table>
           <p><a class="source-toggle" href="#"
             onclick="toggleCode('M000002-source');return false;">[Source]</a></p>
           <div class="method-source-code" id="M000002-source">
 <pre>
-<span class="ruby-comment cmt"># File lib/pho/sparql.rb, line 34</span>
+<span class="ruby-comment cmt"># File lib/pho/sparql.rb, line 121</span>
         <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">initialize</span>(<span class="ruby-identifier">endpoint</span>, <span class="ruby-identifier">client</span>=<span class="ruby-constant">HTTPClient</span>.<span class="ruby-identifier">new</span>() )
          <span class="ruby-ivar">@endpoint</span> = <span class="ruby-identifier">endpoint</span>
          <span class="ruby-ivar">@graphs</span> = <span class="ruby-keyword kw">nil</span>
@@ -241,7 +247,7 @@ protocol
             onclick="toggleCode('M000003-source');return false;">[Source]</a></p>
           <div class="method-source-code" id="M000003-source">
 <pre>
-<span class="ruby-comment cmt"># File lib/pho/sparql.rb, line 45</span>
+<span class="ruby-comment cmt"># File lib/pho/sparql.rb, line 132</span>
         <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">add_default_graph</span>(<span class="ruby-identifier">graph_uri</span>)
           <span class="ruby-keyword kw">if</span> <span class="ruby-ivar">@graphs</span> <span class="ruby-operator">==</span> <span class="ruby-keyword kw">nil</span>
              <span class="ruby-ivar">@graphs</span> = []
@@ -271,7 +277,7 @@ protocol
             onclick="toggleCode('M000004-source');return false;">[Source]</a></p>
           <div class="method-source-code" id="M000004-source">
 <pre>
-<span class="ruby-comment cmt"># File lib/pho/sparql.rb, line 53</span>
+<span class="ruby-comment cmt"># File lib/pho/sparql.rb, line 140</span>
         <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">add_named_graph</span>(<span class="ruby-identifier">graph_uri</span>)
           <span class="ruby-keyword kw">if</span> <span class="ruby-ivar">@named_graphs</span> <span class="ruby-operator">==</span> <span class="ruby-keyword kw">nil</span>
             <span class="ruby-ivar">@named_graphs</span> = []
@@ -283,11 +289,11 @@ protocol
         </div>
       </div>
 
-      <div id="method-M000009" class="method-detail">
-        <a name="M000009"></a>
+      <div id="method-M000010" class="method-detail">
+        <a name="M000010"></a>
 
         <div class="method-heading">
-          <a href="#M000009" class="method-signature">
+          <a href="#M000010" class="method-signature">
           <span class="method-name">ask</span><span class="method-args">(query, format=Pho::Sparql::SPARQL_RESULTS_XML)</span>
           </a>
         </div>
@@ -296,15 +302,19 @@ protocol
           <p>
 Perform a SPARQL ASK <a href="SparqlClient.html#M000005">query</a>.
 </p>
-<pre>
- query:: the SPARQL query
- format:: the preferred response format
-</pre>
+<table>
+<tr><td valign="top"><a href="SparqlClient.html#M000005">query</a>:</td><td>the SPARQL <a href="SparqlClient.html#M000005">query</a>
+
+</td></tr>
+<tr><td valign="top">format:</td><td>the preferred response format
+
+</td></tr>
+</table>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000009-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000009-source">
+            onclick="toggleCode('M000010-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000010-source">
 <pre>
-<span class="ruby-comment cmt"># File lib/pho/sparql.rb, line 130</span>
+<span class="ruby-comment cmt"># File lib/pho/sparql.rb, line 231</span>
         <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">ask</span>(<span class="ruby-identifier">query</span>, <span class="ruby-identifier">format</span>=<span class="ruby-constant">Pho</span><span class="ruby-operator">::</span><span class="ruby-constant">Sparql</span><span class="ruby-operator">::</span><span class="ruby-constant">SPARQL_RESULTS_XML</span>)
           <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">query</span>(<span class="ruby-identifier">query</span>, <span class="ruby-identifier">format</span>)
         <span class="ruby-keyword kw">end</span>
@@ -313,11 +323,11 @@ Perform a SPARQL ASK <a href="SparqlClient.html#M000005">query</a>.
         </div>
       </div>
 
-      <div id="method-M000008" class="method-detail">
-        <a name="M000008"></a>
+      <div id="method-M000009" class="method-detail">
+        <a name="M000009"></a>
 
         <div class="method-heading">
-          <a href="#M000008" class="method-signature">
+          <a href="#M000009" class="method-signature">
           <span class="method-name">construct</span><span class="method-args">(query, format=&quot;application/rdf+xml&quot;)</span>
           </a>
         </div>
@@ -326,15 +336,19 @@ Perform a SPARQL ASK <a href="SparqlClient.html#M000005">query</a>.
           <p>
 Perform a SPARQL CONSTRUCT <a href="SparqlClient.html#M000005">query</a>.
 </p>
-<pre>
- query:: the SPARQL query
- format:: the preferred response format
-</pre>
+<table>
+<tr><td valign="top"><a href="SparqlClient.html#M000005">query</a>:</td><td>the SPARQL <a href="SparqlClient.html#M000005">query</a>
+
+</td></tr>
+<tr><td valign="top">format:</td><td>the preferred response format
+
+</td></tr>
+</table>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000008-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000008-source">
+            onclick="toggleCode('M000009-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000009-source">
 <pre>
-<span class="ruby-comment cmt"># File lib/pho/sparql.rb, line 122</span>
+<span class="ruby-comment cmt"># File lib/pho/sparql.rb, line 223</span>
         <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">construct</span>(<span class="ruby-identifier">query</span>, <span class="ruby-identifier">format</span>=<span class="ruby-value str">&quot;application/rdf+xml&quot;</span>)
           <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">query</span>(<span class="ruby-identifier">query</span>, <span class="ruby-identifier">format</span>)
         <span class="ruby-keyword kw">end</span>
@@ -343,11 +357,11 @@ Perform a SPARQL CONSTRUCT <a href="SparqlClient.html#M000005">query</a>.
         </div>
       </div>
 
-      <div id="method-M000006" class="method-detail">
-        <a name="M000006"></a>
+      <div id="method-M000007" class="method-detail">
+        <a name="M000007"></a>
 
         <div class="method-heading">
-          <a href="#M000006" class="method-signature">
+          <a href="#M000007" class="method-signature">
           <span class="method-name">describe</span><span class="method-args">(query, format=&quot;application/rdf+xml&quot;)</span>
           </a>
         </div>
@@ -356,28 +370,75 @@ Perform a SPARQL CONSTRUCT <a href="SparqlClient.html#M000005">query</a>.
           <p>
 Perform a SPARQL DESCRIBE <a href="SparqlClient.html#M000005">query</a>.
 </p>
+<table>
+<tr><td valign="top"><a href="SparqlClient.html#M000005">query</a>:</td><td>the SPARQL <a href="SparqlClient.html#M000005">query</a>
+
+</td></tr>
+<tr><td valign="top">format:</td><td>the preferred response format
+
+</td></tr>
+</table>
+          <p><a class="source-toggle" href="#"
+            onclick="toggleCode('M000007-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000007-source">
 <pre>
- query:: the SPARQL query
- format:: the preferred response format
+<span class="ruby-comment cmt"># File lib/pho/sparql.rb, line 202</span>
+        <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">describe</span>(<span class="ruby-identifier">query</span>, <span class="ruby-identifier">format</span>=<span class="ruby-value str">&quot;application/rdf+xml&quot;</span>)
+          <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">query</span>(<span class="ruby-identifier">query</span>, <span class="ruby-identifier">format</span>)
+        <span class="ruby-keyword kw">end</span>
 </pre>
+          </div>
+        </div>
+      </div>
+
+      <div id="method-M000006" class="method-detail">
+        <a name="M000006"></a>
+
+        <div class="method-heading">
+          <a href="#M000006" class="method-signature">
+          <span class="method-name">describe_uri</span><span class="method-args">(uri, format=&quot;application/rdf+xml&quot;, type=:cbd)</span>
+          </a>
+        </div>
+      
+        <div class="method-description">
+          <p>
+Describe a uri, optionally specifying a form of bounded description
+</p>
+<table>
+<tr><td valign="top">uri:</td><td>the uri to <a href="SparqlClient.html#M000007">describe</a>
+
+</td></tr>
+<tr><td valign="top">format:</td><td>mimetype for results
+
+</td></tr>
+<tr><td valign="top">type:</td><td>symbol indicating type of description, i.e. +:cbd+, +:scbd+, +:lcbd+, or
++:slcbd+
+
+</td></tr>
+</table>
           <p><a class="source-toggle" href="#"
             onclick="toggleCode('M000006-source');return false;">[Source]</a></p>
           <div class="method-source-code" id="M000006-source">
 <pre>
-<span class="ruby-comment cmt"># File lib/pho/sparql.rb, line 101</span>
-        <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">describe</span>(<span class="ruby-identifier">query</span>, <span class="ruby-identifier">format</span>=<span class="ruby-value str">&quot;application/rdf+xml&quot;</span>)
-          <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">query</span>(<span class="ruby-identifier">query</span>, <span class="ruby-identifier">format</span>)
+<span class="ruby-comment cmt"># File lib/pho/sparql.rb, line 189</span>
+        <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">describe_uri</span>(<span class="ruby-identifier">uri</span>, <span class="ruby-identifier">format</span>=<span class="ruby-value str">&quot;application/rdf+xml&quot;</span>, <span class="ruby-identifier">type</span>=<span class="ruby-identifier">:cbd</span>)
+          <span class="ruby-identifier">template</span> = <span class="ruby-constant">Pho</span><span class="ruby-operator">::</span><span class="ruby-constant">Sparql</span><span class="ruby-operator">::</span><span class="ruby-constant">DESCRIPTIONS</span>[<span class="ruby-identifier">type</span>]
+          <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">template</span> <span class="ruby-operator">==</span> <span class="ruby-keyword kw">nil</span>
+            <span class="ruby-identifier">raise</span> <span class="ruby-value str">&quot;Unknown description type&quot;</span>
+          <span class="ruby-keyword kw">end</span>
+          <span class="ruby-identifier">query</span> = <span class="ruby-constant">Pho</span><span class="ruby-operator">::</span><span class="ruby-constant">Sparql</span><span class="ruby-operator">::</span><span class="ruby-constant">SparqlHelper</span>.<span class="ruby-identifier">apply_initial_bindings</span>(<span class="ruby-identifier">template</span>, {<span class="ruby-value str">&quot;uri&quot;</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-node">&quot;&lt;#{uri}&gt;&quot;</span>} )
+          <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">describe</span>(<span class="ruby-identifier">query</span>, <span class="ruby-identifier">format</span>)
         <span class="ruby-keyword kw">end</span>
 </pre>
           </div>
         </div>
       </div>
 
-      <div id="method-M000007" class="method-detail">
-        <a name="M000007"></a>
+      <div id="method-M000008" class="method-detail">
+        <a name="M000008"></a>
 
         <div class="method-heading">
-          <a href="#M000007" class="method-signature">
+          <a href="#M000008" class="method-signature">
           <span class="method-name">multi_describe</span><span class="method-args">(uris, format=&quot;application/rdf+xml&quot;)</span>
           </a>
         </div>
@@ -393,15 +454,20 @@ This will generate a <a href="SparqlClient.html#M000005">query</a> like:
 </p>
 <pre>
  DESCRIBE &lt;http://www.example.org&gt; &lt;http://www.example.com&gt; ...
-
- uris:: list of the uris to be described
- format:: the preferred response format. Default is RDF/XML
 </pre>
+<table>
+<tr><td valign="top">uris:</td><td>list of the uris to be described
+
+</td></tr>
+<tr><td valign="top">format:</td><td>the preferred response format. Default is <a href="../RDF.html">RDF</a>/XML
+
+</td></tr>
+</table>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000007-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000007-source">
+            onclick="toggleCode('M000008-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000008-source">
 <pre>
-<span class="ruby-comment cmt"># File lib/pho/sparql.rb, line 113</span>
+<span class="ruby-comment cmt"># File lib/pho/sparql.rb, line 214</span>
         <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">multi_describe</span>(<span class="ruby-identifier">uris</span>, <span class="ruby-identifier">format</span>=<span class="ruby-value str">&quot;application/rdf+xml&quot;</span>)
           <span class="ruby-identifier">query</span> = <span class="ruby-value str">&quot;DESCRIBE &quot;</span> <span class="ruby-operator">+</span> <span class="ruby-identifier">uris</span>.<span class="ruby-identifier">map</span> {<span class="ruby-operator">|</span><span class="ruby-identifier">u</span><span class="ruby-operator">|</span> <span class="ruby-node">&quot;&lt;#{u}&gt;&quot;</span> }.<span class="ruby-identifier">join</span>(<span class="ruby-value str">&quot; &quot;</span>)
           <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">query</span>(<span class="ruby-identifier">query</span>, <span class="ruby-identifier">format</span>)
@@ -424,17 +490,26 @@ This will generate a <a href="SparqlClient.html#M000005">query</a> like:
           <p>
 Perform a sparql <a href="SparqlClient.html#M000005">query</a>
 </p>
-<pre>
- sparql:: a valid SPARQL query
- format:: specific a request format. Usually a media-type, but may be a name for a type, if not using Conneg
- graphs:: an array of default graphs
- named_graphs:: an array of named graphs
-</pre>
+<table>
+<tr><td valign="top">sparql:</td><td>a valid SPARQL <a href="SparqlClient.html#M000005">query</a>
+
+</td></tr>
+<tr><td valign="top">format:</td><td>specific a request format. Usually a media-type, but may be a name for a
+type, if not using Conneg
+
+</td></tr>
+<tr><td valign="top">graphs:</td><td>an array of default graphs
+
+</td></tr>
+<tr><td valign="top">named_graphs:</td><td>an array of named graphs
+
+</td></tr>
+</table>
           <p><a class="source-toggle" href="#"
             onclick="toggleCode('M000005-source');return false;">[Source]</a></p>
           <div class="method-source-code" id="M000005-source">
 <pre>
-<span class="ruby-comment cmt"># File lib/pho/sparql.rb, line 66</span>
+<span class="ruby-comment cmt"># File lib/pho/sparql.rb, line 153</span>
         <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">query</span>(<span class="ruby-identifier">sparql</span>, <span class="ruby-identifier">format</span>=<span class="ruby-keyword kw">nil</span>, <span class="ruby-identifier">graphs</span>=<span class="ruby-keyword kw">nil</span>, <span class="ruby-identifier">named_graphs</span>=<span class="ruby-keyword kw">nil</span>)
           
           <span class="ruby-identifier">params</span> = {}
@@ -470,11 +545,11 @@ Perform a sparql <a href="SparqlClient.html#M000005">query</a>
         </div>
       </div>
 
-      <div id="method-M000010" class="method-detail">
-        <a name="M000010"></a>
+      <div id="method-M000011" class="method-detail">
+        <a name="M000011"></a>
 
         <div class="method-heading">
-          <a href="#M000010" class="method-signature">
+          <a href="#M000011" class="method-signature">
           <span class="method-name">select</span><span class="method-args">(query, format=Pho::Sparql::SPARQL_RESULTS_XML)</span>
           </a>
         </div>
@@ -483,15 +558,19 @@ Perform a sparql <a href="SparqlClient.html#M000005">query</a>
           <p>
 Perform a SPARQL SELECT <a href="SparqlClient.html#M000005">query</a>.
 </p>
-<pre>
- query:: the SPARQL query
- format:: the preferred response format
-</pre>
+<table>
+<tr><td valign="top"><a href="SparqlClient.html#M000005">query</a>:</td><td>the SPARQL <a href="SparqlClient.html#M000005">query</a>
+
+</td></tr>
+<tr><td valign="top">format:</td><td>the preferred response format
+
+</td></tr>
+</table>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000010-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000010-source">
+            onclick="toggleCode('M000011-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000011-source">
 <pre>
-<span class="ruby-comment cmt"># File lib/pho/sparql.rb, line 138</span>
+<span class="ruby-comment cmt"># File lib/pho/sparql.rb, line 239</span>
         <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">select</span>(<span class="ruby-identifier">query</span>, <span class="ruby-identifier">format</span>=<span class="ruby-constant">Pho</span><span class="ruby-operator">::</span><span class="ruby-constant">Sparql</span><span class="ruby-operator">::</span><span class="ruby-constant">SPARQL_RESULTS_XML</span>)
           <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">query</span>(<span class="ruby-identifier">query</span>, <span class="ruby-identifier">format</span>)
         <span class="ruby-keyword kw">end</span>