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.

Table16.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.

Table16.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:

Table16.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.

Table16.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.

Table16.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