Skip to content

Raw connectome data access

jamesra edited this page Jun 4, 2013 · 3 revisions

The Viking server provides read-only anonymous HTTP access to connectome databases via WCF Data Services. Responses to queries are returned as either OData or JSON. The format of the response data is determined by the MIME type specified in the "accepts" field of the request.

The service URI for RC1 queries is http://connectomes.utah.edu/Services/RC1/ConnectomeData.svc/. This link produces a list of the tables found in a Viking database. For detailed use, such as constructing queries, see the links above. For demonstration purposes we can request structure 476 by appending "Structures(476L)" to the service URI:

https://connectomes.utah.edu/Services/RC1/ConnectomeData.svc/Structures(476L)

An abbreviated summary of the response is below. In database terms the <links> refer to relationships between tables in the database and the <properties> refer to the values recorded for that row of the structures table. To find all of the child structures we would append /Structures(476L)/Children to the service URI.

<entry>  
  <id>https://connectomes.utah.edu/Services/RC1/ConnectomeData.svc/Structures(476L)</id>  
  <title type="text"></title>  
  <updated>2013-06-04T04:29:12Z</updated>  
  <link title="Structure" href="Structures(476L)" />  
  <link type="application/atom+xml;type=feed" title="Locations" href="Structures(476L)/Locations" />  
  <link type="application/atom+xml;type=feed" title="Children" href="Structures(476L)/Children" />  
  <link type="application/atom+xml;type=entry" title="Parent" href="Structures(476L)/Parent" />  
  <link type="application/atom+xml;type=entry" title="Type" href="Structures(476L)/Type" />  
  <link type="application/atom+xml;type=feed" title="SourceOfLinks" href="Structures(476L)/SourceOfLinks" />  
  <link type="application/atom+xml;type=feed" title="TargetOfLinks" href="Structures(476L)/TargetOfLinks" />  
  <content type="application/xml">  
    <m:properties>
      <d:ID m:type="Edm.Int64">476</d:ID>  
      <d:TypeID m:type="Edm.Int64">1</d:TypeID>  
      <d:Notes>Aii AC</d:Notes>  
      <d:Verified m:type="Edm.Boolean">true</d:Verified>  
      <d:Tags>;</d:Tags>  
      <d:Confidence m:type="Edm.Double">1</d:Confidence>  
      <d:Version m:type="Edm.Binary">AAAAAACLl0c=</d:Version>  
      <d:ParentID m:type="Edm.Int64" m:null="true" />  
      <d:Created m:type="Edm.DateTime">2009-08-05T00:51:15.34</d:Created>  
      <d:Label>GAC Aii</d:Label>  
      <d:Username xml:space="preserve">                </d:Username>  
      <d:LastModified m:type="Edm.DateTime">2011-10-13T21:16:35.64</d:LastModified>  
    </m:properties>  
  </content>  
</entry>  

Note: Because most browsers do not render the OData you will most likely be prompted to save a document or your browser will display a nearly empty page. To see the actual data returned right-click the resulting page and search for an option to view the page source. This will reveal the response.

Clone this wiki locally