Top

16.10.8. Cartridge Architecture

What is a Cartridge?

See full description here

Extractor Cartridges

An Extractor Cartridge processes a Resource of a given format, extracting RDF according to rules appropriate to that format. External data does not come into play; only the content of the Resource fed to the Sponger.

Supported Standard Non-RDF Data Formats

These Cartridges handle open formats - typically community-developed, openly-documented, and freely-licensed data structures.

Table 16.12. 

Cartridge Sample URI Resource Description Linked Data Graph
AB Meta example HTML Representation Data Explorer View
Atom example HTML Representation Data Explorer View
CSV example HTML Representation Data Explorer View
DC example HTML Representation Data Explorer View
eRDF example HTML Representation Data Explorer View
hAudio example HTML Representation Data Explorer View
hCalendar example HTML Representation Data Explorer View
hCard example HTML Representation Data Explorer View
hListing example HTML Representation Data Explorer View
hNews example HTML Representation Data Explorer View
hProduct example HTML Representation Data Explorer View
HR-XML example HTML Representation Data Explorer View
hRecipe example HTML Representation Data Explorer View
hResume example HTML Representation Data Explorer View
hReview example HTML Representation Data Explorer View
HTTP in RDF example HTML Representation Data Explorer View
iCalendar example HTML Representation Data Explorer View
Microsoft Word 2003 XML Document example HTML Representation Data Explorer View
Microsoft XML Spreadsheet 2003 example HTML Representation Data Explorer View
Microsoft Documents example HTML Representation Data Explorer View
OData example HTML Representation Data Explorer View
OO document example HTML Representation Data Explorer View
OPML example HTML Representation Data Explorer View
PPTX example HTML Representation Data Explorer View
RDFa example HTML Representation Data Explorer View
RSS example HTML Representation Data Explorer View
Slidy example HTML Representation Data Explorer View
vCalendar example HTML Representation Data Explorer View
vCard example HTML Representation Data Explorer View
WebDAV Metadata example HTML Representation Data Explorer View
XBRL example HTML Representation Data Explorer View
XFN Profile example HTML Representation Data Explorer View
XFN Profile2 example HTML Representation Data Explorer View
xHTML example HTML Representation Data Explorer View
XHTML example HTML Representation Data Explorer View

Supported Vendor-specific Non-RDF Data Formats

These Cartridges handle closed formats - typically proprietary; sometimes undocumented; possibly licensed to no-one except the format originator. Sometimes data may not be parsed as desired or expected, as many of these Cartridges have required reverse-engineering of the data format in question.

Table 16.13. 

Cartridge Needs Sample URI Resource Description Linked Data Graph
Amazon API Key example HTML Representation Data Explorer View
BestBuy API Key example HTML Representation Data Explorer View
Bing none example HTML Representation Data Explorer View
Bugzillas none example HTML Representation Data Explorer View
CNET API Key example HTML Representation Data Explorer View
CrunchBase none example HTML Representation Data Explorer View
Delicious none example HTML Representation Data Explorer View
Digg none example HTML Representation Data Explorer View
Discogs php plugin, DBpedia Extractor example HTML Representation Data Explorer View
Disqus API Key, API Account example HTML Representation Data Explorer View
DOI hslookup plugin; relevant html-, pdf-, xml-, etc., -mappers enabled example HTML Representation Data Explorer View
Dublin Core none example HTML Representation Data Explorer View
eBay account, API Key example HTML Representation Data Explorer View
Evri none example HTML Representation Data Explorer View
Facebook API key and secret, OAuth token See details example HTML Representation Data Explorer View
Flickr API Key example HTML Representation Data Explorer View
Freebase none example HTML Representation Data Explorer View
Geonames none example HTML Representation Data Explorer View
geoURL none example HTML Representation Data Explorer View
Get Satisfaction none example HTML Representation Data Explorer View
Google+ API key See details example HTML Representation Data Explorer View
Google Base none example HTML Representation Data Explorer View
Google Book none example HTML Representation Data Explorer View
Google Document none example HTML Representation Data Explorer View
Google Social Graph none example HTML Representation Data Explorer View
Google Spreadsheet none example HTML Representation Data Explorer View
Hoovers none example HTML Representation Data Explorer View
ISBN API Key example HTML Representation Data Explorer View
LastFM API Key example HTML Representation Data Explorer View
LibraryThing API Key example HTML Representation Data Explorer View
LinkedIn API key and secret, OAuth token See details example HTML Representation Data Explorer View
LSID none example HTML Representation Data Explorer View
Meetup API Key example HTML Representation Data Explorer View
MusicBrainz none example HTML Representation Data Explorer View
Ning Metadata none example HTML Representation Data Explorer View
OAI none example HTML Representation Data Explorer View
Open Social none example HTML Representation Data Explorer View
OpenLibrary none example HTML Representation Data Explorer View
OpenStreetMap none example HTML Representation Data Explorer View
oReilly none example HTML Representation Data Explorer View
Picasa none example HTML Representation Data Explorer View
Radio Pop none example HTML Representation Data Explorer View
relLicense none example HTML Representation Data Explorer View
Revyu none example HTML Representation Data Explorer View
Rhapsody none example HTML Representation Data Explorer View
SalesForce.com API Key,user login example HTML Representation Data Explorer View
SlideShare API Key, SharedSecret example HTML Representation Data Explorer View
SlideSix none example HTML Representation Data Explorer View
SVG none example HTML Representation Data Explorer View
Tesco none example HTML Representation Data Explorer View
Tumblr none example HTML Representation Data Explorer View
TWFY (theyworkforyou) API Key example HTML Representation Data Explorer View
Twitter API key and secret, OAuth token See details example HTML Representation Data Explorer View
Ustream none example HTML Representation Data Explorer View
Web Resource CC (Licenses) none example HTML Representation Data Explorer View
Wikipedia none example HTML Representation Data Explorer View
xFolk none example HTML Representation Data Explorer View
Yahoo! Finance none example HTML Representation Data Explorer View
Yahoo! SearchMonkey none example HTML Representation Data Explorer View
Yahoo! Traffic Data none example HTML Representation Data Explorer View
Yahoo! Weather none example HTML Representation Data Explorer View
Yelp none example HTML Representation Data Explorer View
Youtube none example HTML Representation Data Explorer View
Zillow none example HTML Representation Data Explorer View

Meta Cartridges

A Meta Cartridge submits a Resource to a third-party Web Service for processing. Returned RDF supplements the RDF generated by Extractor and other Meta Cartridges. Locally generated RDF may also be submitted to the third-party services, instead-of or in-addition-to the original Resource itself.

Default Sponger behavior is for all installed Meta Cartridges to be brought to bear on all submitted Resources:

Table 16.14. 

Cartridge Needs Sample URI Resource Description Linked Data Graph Notes
Alchemy API Key example HTML Representation Data Explorer View  
Amazon Search for products API Key, secret example HTML Representation Data Explorer View  
BBC Links   example HTML Representation Data Explorer View  
BestBuy Search for products API Key example HTML Representation Data Explorer View  
Bing API Key example HTML Representation Data Explorer View  
Bit.ly   example HTML Representation Data Explorer View  
CNET Search for products API Key example HTML Representation Data Explorer View  
Collecta   example HTML Representation Data Explorer View Check rdfs:seeAlso links found for microsoft.
Crunchbase   example HTML Representation Data Explorer View  
Dapper Search   example HTML Representation Data Explorer View  
DBpedia Meta   example HTML Representation Data Explorer View  
Delicious Meta User Login example HTML Representation Data Explorer View  
Digg.com   example HTML Representation Data Explorer View Check rdfs:seeAlso the links from Digg.com .
Discogs API Key, php plugin, DBpedia Extractor example HTML Representation Data Explorer View  
Document Links   example HTML Representation Data Explorer View  
eBay Search for products account, API Key example HTML Representation Data Explorer View  
Evri Meta   example HTML Representation Data Explorer View  
Facebook API Key, secret, persistent-session-id. See details example HTML Representation Data Explorer View  
Flickr Search for photos API Key example HTML Representation Data Explorer View  
FOAF-Search   example HTML Representation Data Explorer View Check rdfs:seeAlso at: link1 , link2 , link3
Foursquare   example HTML Representation Data Explorer View  
Freebase NYTC API Key example HTML Representation Data Explorer View  
Freebase NYTCF API Key example HTML Representation Data Explorer View  
FriendFeed   example HTML Representation Data Explorer View  
Geonames Meta   example HTML Representation Data Explorer View  
Geopoints   example HTML Representation Data Explorer View  
Gowalla   example HTML Representation Data Explorer View  
Get Glue Meta User Login example HTML Representation Data Explorer View  
Get Glue   example HTML Representation Data Explorer View  
Google Buzz   example HTML Representation Data Explorer View  
Google Book   example HTML Representation Data Explorer View Check rdfs:seeAlso links like this one
Google Plus   example HTML Representation Data Explorer View  
Google Places   example HTML Representation Data Explorer View  
Google Search   example HTML Representation Data Explorer View  
Google Social Graph   example HTML Representation Data Explorer View  
Guardian API Key example HTML Representation Data Explorer View  
Hoovers API Key example HTML Representation Data Explorer View  
Jigsaw (company)   example HTML Representation Data Explorer View Check the c:location link
Jigsaw (person)   example HTML Representation Data Explorer View Check several Jigsaw search seeAlso link .
Journalisted   example HTML Representation Data Explorer View  
Last.FM API Key example HTML Representation Data Explorer View  
LinkedIn API Key and Session Key; See details example HTML Representation Data Explorer View  
Local Search   example HTML Representation Data Explorer View  
LOD   example HTML Representation Data Explorer View  
MIME Type   example HTML Representation Data Explorer View  
New York Times API Key example HTML Representation Data Explorer View  
NPR Meta API Key example HTML Representation Data Explorer View Check rdfs:seeAlso links like: link1 ; link2 ; link3 .
NYT: The Article Search   example HTML Representation Data Explorer View Check the rdfs:seeAlso: link .
NYT: The TimesTags   example HTML Representation Data Explorer View  
OpenCalais any html page example HTML Representation Data Explorer View  
Oreilly Search for products   example HTML Representation Data Explorer View  
Primal   example HTML Representation Data Explorer View Check the set of sioc:topic and scot:hasScot.
ProgrammableWeb   example HTML Representation Data Explorer View  
Provenance   example HTML Representation Data Explorer View  
Punkt   example HTML Representation Data Explorer View  
RapLeaf   example HTML Representation Data Explorer View  
SameAs.org   example HTML Representation Data Explorer View  
Sindice   example HTML Representation Data Explorer View  
SimpleGeo   example HTML Representation Data Explorer View  
Technorati API Key example HTML Representation Data Explorer View  
Tesco Product Search User Login, DeveloperKey, ApplicationKey example HTML Representation Data Explorer View Check set of Tesco rdfs:seeAlso links like this one .
Topsy   example HTML Representation Data Explorer View Check the rdfs:seeAlso from topsy.com.
TrueKnowledge   example HTML Representation Data Explorer View Check set of rdfs:seeAlso links like: link1 ; link2 ; link3 .
Tweetme   example HTML Representation Data Explorer View Check the rdfs:seeAlso link.
Twitter Meta User Login example HTML Representation Data Explorer View  
uClassify   example HTML Representation Data Explorer View  
Uclassify   example HTML Representation Data Explorer View Check diff langs uc:class: link
UMBEL min-score, max-results example HTML Representation Data Explorer View  
USA Today Best-Selling Books   example HTML Representation Data Explorer View  
Ustream   example HTML Representation Data Explorer View Check rdfs:seeAlso links like: this one .
Virtuoso Faceted Web Service   example HTML Representation Data Explorer View  
voID Statistics   example HTML Representation Data Explorer View  
whoisi?   example HTML Representation Data Explorer View  
World Bank API Key example HTML Representation Data Explorer View  
WorldCat Basic Search   example HTML Representation Data Explorer View Check seeAlso links like this one .
xISBN API Key example HTML Representation Data Explorer View Check set of owl:sameAs links: link1 ; link2 .
XRD   example HTML Representation Data Explorer View  
Yahoo BOSS API Key example HTML Representation Data Explorer View  
Yahoo Geocode API Key example HTML Representation Data Explorer View  
Yelp Search for business API Key example HTML Representation Data Explorer View  
Zemanta API Key, min-score, max-results example HTML Representation Data Explorer View  
Zillow API Key example HTML Representation Data Explorer View  

Meta Cartridge Usage via REST Request

Description.vsp underlies the /about/html/ page, and accepts the parameters described below.

Table 16.15. 

Parameter Value Description Example
@Lookup@ The type of lookup
  No Value When value is not given (i.e., @Lookup@= ), all will work as if the parameter were not present. %BR% The "Lookup" name is chosen to distinguish between parameters belonging to the URL being processed, and parameters for the Sponger. Refresh the graph with all current cartridges, either type
  0 NLP meta only Execute only NLP meta extraction
  -2 Keywords-based only Execute only keywords-based meta extraction
  x,y... A list of meta cartridges to be executed, by their unique IDs. The ID column can be found in Conductor -> Linked Data -> Sponger -> Meta Cartridges Execute only CNET (ID=19) and NYT: The TimesTags (ID=22) meta cartridges
refresh=0,1,2 etc.   Usage : for cache invalidation. When used 1 or larger number (n), adds get:refresh "N" (explicit refresh interval in seconds) as a directive to Sponger. A refresh of zero ("0") seconds will make a new graph on the next lookup with the '@Lookup@ ' parameter value. Refresh the graph with all current cartridges
refresh=clean   Usage : for overwriting. The 'clean' usage explicitly clears the graph i.e. will cause the Sponger to drop cache even if it is marked to be in the fly. Thus, if network resource fetched cache by some reason is left in some inconsistent state like shutdown during the fetching, then 'clean' is required as it doesn't check cache state. Note : must be used with caution as other threads may be doing Network Resource Fetch at same time.  

Meta Cartridges Parametrized Examples

All examples in the table below start from the same Resource, http://www.news.com, and submit it to the Sponger for processing with the single listed Meta Cartridge.

It can be informative to start by seeing what the results would be with no Meta Cartridges at all .

If you have a lot of time to spare, you may want to see what the results would be with all Meta Cartridges combined . As may be obvious, this must wait for each of the above services to respond, so it may take quite some time to return.

Table 16.16. 

Cartridge URL Pattern Example
Alchemy @Lookup@=8&refresh=0 cURL example
Amazon Search for products @Lookup@=13&refresh=0 cURL example
BBC @Lookup@=1665&refresh=0 cURL example
BestBuy Search for products @Lookup@=14&refresh=0 cURL example
Bing @Lookup@=11&refresh=0 cURL example
Bit.ly @Lookup@=915&refresh=0 cURL example
CNET @Lookup@=19&refresh=0 cURL example
Crunchbase @Lookup@=839&refresh=0 cURL example
Dapper @Lookup@=243&refresh=0 cURL example
DBpedia @Lookup@=26&refresh=0 cURL example
Delicious Meta @Lookup@=23&refresh=0 cURL example
Discogs @Lookup@=840&refresh=0 cURL example
Document Links @Lookup@=34&refresh=0 cURL example
eBay @Lookup@=18&refresh=0 cURL example
Evri Meta @Lookup@=3966&refresh=0 cURL example
Flickr Search for photos @Lookup@=16&refresh=0 cURL example
Freebase NYTC @Lookup@=5&refresh=0 cURL example
Freebase NYTCF @Lookup@=4&refresh=0 cURL example
Geonames Meta @Lookup@=24&refresh=0 cURL example
Geopoints @Lookup@=3731&refresh=0 cURL example
Get Glue Meta @Lookup@=25&refresh=0 cURL example
Google Search @Lookup@=1382&refresh=0 cURL example
Google Social Graph @Lookup@=30&refresh=0 cURL example
Guardian @Lookup@=28&refresh=0 cURL example
Hoovers @Lookup@=2&refresh=0 cURL example
Journalisted @Lookup@=3174&refresh=0 cURL example
Local Search @Lookup@=15&refresh=0 cURL example
LOD @Lookup@=21&refresh=0 cURL example
MIME Type @Lookup@=1029&refresh=0 cURL example
New York Times @Lookup@=22&refresh=0 cURL example
NPR Meta @Lookup@=29&refresh=0 cURL example
NYT: The Article Search @Lookup@=9&refresh=0 cURL example
NYT: The TimesTags @Lookup@=22&refresh=0 cURL example
OpenCalais @Lookup@=1&refresh=0 cURL example
Oreilly Search for products @Lookup@=17&refresh=0 cURL example
RapLeaf @Lookup@=2745&refresh=0 cURL example
SameAs.org @Lookup@=3257&refresh=0 cURL example
Sindice @Lookup@=12&refresh=0 cURL example
Technorati @Lookup@=27&refresh=0 cURL example
Tesco @Lookup@=31&refresh=0 cURL example
TrueKnowledge @Lookup@=3967&refresh=0 cURL example
Twitter @Lookup@=4020&refresh=0 cURL example
uClassify @Lookup@=3086&refresh=0 cURL example
UMBEL @Lookup@=6&refresh=0 cURL example
Ustream @Lookup@=3902&refresh=0 cURL example
Virtuoso Faceted Web Service @Lookup@=21&refresh=0 cURL example
voID Statistics @Lookup@=35&refresh=0 cURL example
whoisi? @Lookup@=3052&refresh=0 cURL example
World Bank @Lookup@=3&refresh=0 cURL example
XRD @Lookup@=3650&refresh=0 cURL example
Yahoo BOSS @Lookup@=10&refresh=0 cURL example
Yahoo Geocode @Lookup@=2855&refresh=0 cURL example
Yelp Search for business @Lookup@=20&refresh=0 cURL example
Zemanta @Lookup@=7&refresh=0 cURL example
Zillow @Lookup@=32&refresh=0 cURL example