jm-calais 0.0.13

data/lib/calais/version.rb

@@ -0,0 +1,3 @@
+module Calais
+	VERSION = "0.0.13"
+end

data/lib/calais.rb

@@ -0,0 +1,59 @@
+require 'digest/sha1'
+require 'net/http'
+require 'uri'
+require 'cgi'
+require 'iconv' if RUBY_VERSION.to_f < 1.9
+require 'set'
+require 'date'
+
+require 'rubygems'
+require 'nokogiri'
+require 'json'
+
+if RUBY_VERSION.to_f < 1.9
+  $KCODE = "UTF8"
+  require 'jcode'
+end
+
+$:.unshift File.expand_path(File.dirname(__FILE__))
+
+require 'calais/client'
+require 'calais/response'
+require 'calais/error'
+
+module Calais
+  REST_ENDPOINT = "http://api.opencalais.com/enlighten/rest/"
+  BETA_REST_ENDPOINT = "http://beta.opencalais.com/enlighten/rest/"
+
+  AVAILABLE_CONTENT_TYPES = {
+    :xml => 'text/xml',
+    :html => 'text/html',
+    :htmlraw => 'text/htmlraw',
+    :raw => 'text/raw'
+  }
+
+  AVAILABLE_OUTPUT_FORMATS = {
+    :rdf => 'xml/rdf',
+    :simple => 'text/simple',
+    :microformats => 'text/microformats',
+    :json => 'application/json'
+  }
+
+  KNOWN_ENABLES = ['GenericRelations', 'SocialTags']
+  KNOWN_DISCARDS = ['er/Company', 'er/Geo', 'er/Product']
+
+  MAX_RETRIES = 5
+  HTTP_TIMEOUT = 60
+  MIN_CONTENT_SIZE = 1
+  MAX_CONTENT_SIZE = 100_000
+
+  class << self
+    def enlighten(*args, &block); Client.new(*args, &block).enlighten; end
+
+    def process_document(*args, &block)
+      client = Client.new(*args, &block)
+      client.output_format = :rdf
+      Response.new(client.enlighten)
+    end
+  end
+end

data/spec/calais/client_spec.rb

@@ -0,0 +1,79 @@
+require File.join(File.dirname(__FILE__), %w[.. helper])
+
+describe Calais::Client, :new do
+  it 'accepts arguments as a hash' do
+    client = nil
+
+    lambda { client = Calais::Client.new(:content => SAMPLE_DOCUMENT, :license_id => LICENSE_ID) }.should_not raise_error
+
+    client.license_id.should == LICENSE_ID
+    client.content.should == SAMPLE_DOCUMENT
+  end
+
+  it 'accepts arguments as a block' do
+    client = nil
+
+    lambda {
+      client = Calais::Client.new do |c|
+        c.content = SAMPLE_DOCUMENT
+        c.license_id = LICENSE_ID
+      end
+    }.should_not raise_error
+
+    client.license_id.should == LICENSE_ID
+    client.content.should == SAMPLE_DOCUMENT
+  end
+
+  it 'should not accept unknown attributes' do
+    lambda { Calais::Client.new(:monkey => 'monkey', :license_id => LICENSE_ID) }.should raise_error(NoMethodError)
+  end
+end
+
+describe Calais::Client, :params_xml do
+  it 'returns an xml encoded string' do
+    client = Calais::Client.new(:content => SAMPLE_DOCUMENT, :license_id => LICENSE_ID)
+    client.params_xml.should == %[<c:params xmlns:c=\"http://s.opencalais.com/1/pred/\" xmlns:rdf=\"http://www.w3.org/1999/02/22-rdf-syntax-ns#\">\n  <c:processingDirectives/>\n  <c:userDirectives/>\n</c:params>]
+
+    client.content_type = :xml
+    client.output_format = :json
+    client.reltag_base_url = 'http://opencalais.com'
+    client.calculate_relevance = true
+    client.metadata_enables = Calais::KNOWN_ENABLES
+    client.metadata_discards = Calais::KNOWN_DISCARDS
+    client.allow_distribution = true
+    client.allow_search = true
+    client.external_id = Digest::SHA1.hexdigest(client.content)
+    client.submitter = 'calais.rb'
+
+    client.params_xml.should == %[<c:params xmlns:c="http://s.opencalais.com/1/pred/" xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#">\n  <c:processingDirectives c:contentType="text/xml" c:outputFormat="application/json" c:reltagBaseURL="http://opencalais.com" c:enableMetadataType="GenericRelations,SocialTags" c:discardMetadata="er/Company;er/Geo;er/Product"/>\n  <c:userDirectives c:allowDistribution="true" c:allowSearch="true" c:externalID="1a008b91e7d21962e132bc1d6cb252532116a606" c:submitter="calais.rb"/>\n</c:params>]
+  end
+end
+
+describe Calais::Client, :enlighten do
+  before do
+    @client = Calais::Client.new do |c|
+      c.content = SAMPLE_DOCUMENT
+      c.license_id = LICENSE_ID
+      c.content_type = :xml
+      c.output_format = :json
+      c.calculate_relevance = true
+      c.metadata_enables = Calais::KNOWN_ENABLES
+      c.allow_distribution = true
+      c.allow_search = true
+    end
+  end
+
+  it 'provides access to the enlighten command on the generic rest endpoint' do
+    @client.should_receive(:do_request).with(anything).and_return(SAMPLE_RESPONSE)
+    @client.enlighten
+    @client.url.should == URI.parse(Calais::REST_ENDPOINT)
+  end
+
+  it 'provides access to the enlighten command on the beta rest endpoint' do
+    @client.use_beta = true
+
+    @client.should_receive(:do_request).with(anything).and_return(SAMPLE_RESPONSE)
+    @client.enlighten
+    @client.url.should == URI.parse(Calais::BETA_REST_ENDPOINT)
+  end
+end

data/spec/calais/response_spec.rb

@@ -0,0 +1,149 @@
+require File.join(File.dirname(__FILE__), %w[.. helper])
+
+describe Calais::Response, :new do
+  it 'accepts an rdf string to generate the response object' do
+    lambda { Calais::Response.new(SAMPLE_RESPONSE) }.should_not raise_error
+  end
+end
+
+describe Calais::Response, :new do
+  it "should return error message in runtime error" do
+    lambda {
+      @response = Calais::Response.new(RESPONSE_WITH_EXCEPTION)
+    }.should raise_error(Calais::Error, "My Error Message") 
+  end
+end
+
+describe Calais::Response, :new do
+  before :all do
+    @response = Calais::Response.new(SAMPLE_RESPONSE)
+  end
+
+  it 'should extract document information' do
+    @response.language.should == 'English'
+    @response.submission_date.should be_a_kind_of(DateTime)
+    @response.signature.should be_a_kind_of(String)
+    @response.submitter_code.should be_a_kind_of(String)
+    @response.request_id.should be_a_kind_of(String)
+    @response.doc_title.should == 'Record number of bicycles sold in Australia in 2006'
+    @response.doc_date.should be_a_kind_of(Date)
+  end
+
+  it 'should extract entities' do
+    entities = @response.entities
+    entities.map { |e| e.type }.sort.uniq.should == %w[City Continent Country IndustryTerm Organization Person Position ProvinceOrState]
+  end
+
+  it 'should extract relations' do
+    relations = @response.relations
+    relations.map { |e| e.type }.sort.uniq.should == %w[GenericRelations PersonAttributes PersonCareer Quotation]
+  end
+
+  describe 'geographies' do
+    it 'should be extracted' do
+      geographies = @response.geographies
+      geographies.map { |e| e.name }.sort.uniq.should == %w[Australia Hobart,Tasmania,Australia Tasmania,Australia]
+    end
+
+    it 'should have relevance' do
+      geographies = @response.geographies
+      geographies.map { |e| e.relevance }.sort.uniq.should be_true
+    end
+
+    it 'should have relevance value' do
+      geographies = @response.geographies
+      geographies.map { |e| e.relevance }.sort.uniq.should == [0.168, 0.718]
+    end
+  end
+
+  it 'should extract relevances' do
+    @response.instance_variable_get(:@relevances).should be_a_kind_of(Hash)
+  end
+
+  it 'should assign a floating-point relevance to each entity' do
+    @response.entities.each {|e| e.relevance.should be_a_kind_of(Float) }
+  end
+
+  it 'should find the correct document categories returned by OpenCalais' do
+    @response.categories.map {|c| c.name }.sort.should == %w[Business_Finance Technology_Internet]
+  end
+
+  it 'should find the correct document category scores returned by OpenCalais' do
+    @response.categories.map {|c| c.score.should be_a_kind_of(Float) }
+  end
+  
+  it "should not raise an error if no score is given by OpenCalais" do
+    lambda {Calais::Response.new(SAMPLE_RESPONSE_WITH_NO_SCORE)}.should_not raise_error
+  end
+  
+  it "should not raise an error if no score is given by OpenCalais" do
+    response = Calais::Response.new(SAMPLE_RESPONSE_WITH_NO_SCORE)
+    response.categories.map {|c| c.score }.should == [nil]
+  end
+  
+  it 'should find social tags' do
+    @response.socialtags.map {|c| c.name }.sort.should == ["Appropriate technology", "Bicycles", "Business_Finance", "Cycling", "Motorized bicycle", "Recreation", "Sustainability", "Sustainable transport", "Technology_Internet"]
+  end
+
+  it 'should have important scores associated with social tags' do
+    @response.socialtags.map {|c| c.importance.should be_a_kind_of(Integer) }
+  end
+  
+  
+  it 'should find instances for each entity' do
+    @response.entities.each {|e|
+      e.instances.size.should > 0
+    }
+  end
+
+
+  it 'should find instances for each relation' do
+    @response.relations.each {|r|
+      r.instances.size.should > 0
+    }
+  end
+
+  it 'should find the correct instances for each entity' do
+    ## This currently tests only for the "Australia" entity's
+    ## instances.  A more thorough test that tests for the instances
+    ## of each of the many entities in the sample doc is desirable in
+    ## the future.
+
+    australia = @response.entities.select {|e| e.attributes["name"] == "Australia" }.first
+    australia.instances.size.should == 3
+    instances = australia.instances.sort{|a,b| a.offset <=> b.offset }
+
+    instances[0].prefix.should == "number of bicycles sold in "
+    instances[0].exact.should == "Australia"
+    instances[0].suffix.should == " in 2006<\/title>\n<date>January 4,"
+    instances[0].offset.should == 67
+    instances[0].length.should == 9
+
+    instances[1].prefix.should == "4, 2007<\/date>\n<body>\nBicycle sales in "
+    instances[1].exact.should == "Australia"
+    instances[1].suffix.should == " have recorded record sales of 1,273,781 units"
+    instances[1].offset.should == 146
+    instances[1].length.should == 9
+
+    instances[2].prefix.should == " the traditional company car,\" he said.\n\n\"Some of "
+    instances[2].exact.should == "Australia"
+    instances[2].suffix.should == "'s biggest corporations now have bicycle fleets,"
+    instances[2].offset.should == 952
+    instances[2].length.should == 9
+  end
+
+  it 'should find the correct instances for each relation' do
+    ## This currently tests only for one relation's instances.  A more
+    ## thorough test that tests for the instances of each of the many other
+    ## relations in the sample doc is desirable in the future.
+
+    rel = @response.relations.select {|e| e.calais_hash.value == "8f3936d9-cf6b-37fc-ae0d-a145959ae3b5" }.first
+    rel.instances.size.should == 1
+
+    rel.instances.first.prefix.should == " manufacturers.\n\nThe Cycling Promotion Fund (CPF) "
+    rel.instances.first.exact.should == "spokesman Ian Christie said Australians were increasingly using bicycles as an alternative to cars."
+    rel.instances.first.suffix.should == " Sales rose nine percent in 2006 while the car"
+    rel.instances.first.offset.should == 425
+    rel.instances.first.length.should == 99
+  end
+end

data/spec/fixtures/bicycles_australia.response.json

@@ -0,0 +1,538 @@
+{
+   "doc":{
+      "info":{
+         "document":"<document>\n<id>57831</id>\n<title>Record number of bicycles sold in Australia in 2006</title>\n<date>January 4, 2007</date>\n<body>\nBicycle sales in Australia have recorded record sales of 1,273,781 units for 2006, exceeding car sales by 32 percent. It is the fifth year in a row that the bicycle industry has sold more than one million units, a figure yet to be realised by car manufacturers.\n\nThe Cycling Promotion Fund (CPF) spokesman Ian Christie said Australians were increasingly using bicycles as an alternative to cars. Sales rose nine percent in 2006 while the car market stalled. Mr Christie said people were looking to cut their fuel costs and improve their fitness.\n\nMr Christie, a native of Hobart, Tasmania said organisations were beginning to supply bicycles as a company vehicle. \"There is an emerging trend towards people using bikes as their official company-supplied vehicle in place of the traditional company car,\" he said.\n\n\"Some of Australia's biggest corporations now have bicycle fleets, and when you add in government organisations, we now know of at least 50 organisations which operate fleets of bikes.\"\n\n\"Although the company bicycle is a long way from taking over from the company car, it's an important trend when you consider that nearly half of all cars sold are to company fleets.\"\n\nThe CPF claims most commutes to work are less than 5 kilometres (3 miles) making bicycle travel a viable alternative.\n\n</body></document>",
+         "docTitle":"Record number of bicycles sold in Australia in 2006",
+         "docDate":"2007-01-04 00:00:00",
+         "allowDistribution":"true",
+         "allowSearch":"true",
+         "calaisRequestID":"ede182ab-a3fc-4e96-9838-5fa73bccdea6",
+         "docRDFaccessible":"true",
+         "id":"http://id.opencalais.com/FYP3OZuxbUDyQEO42uKnqw"
+      },
+      "meta":{
+         "submitterCode":"4a388fbc-9897-def9-9233-efddbfbca363",
+         "signature":"digestalg-1|HhYSdHZifSUYvKGZpRu2xeoWlFE=|MPNwpbXJkJipQDb1lqyd/+X+Jd02mmtoCsOdLyLLTVCz0hKKBgDlOA==",
+         "contentType":"text/xml",
+         "emVer":"UserVocabulariesIM",
+         "langIdVer":"DefaultLangId",
+         "language":"English",
+         "processingVer":"CalaisJob01",
+         "submissionDate":"2009-06-08 16:29:07.040",
+         "messages":[
+
+         ]
+      }
+   },
+   "http://d.opencalais.com/dochash-1/9359fafb-1158-3343-91e3-7f4ed89f3b01/cat/1":{
+      "_typeGroup":"topics",
+      "category":"http://d.opencalais.com/cat/Calais/BusinessFinance",
+      "classifierName":"Calais",
+      "categoryName":"Business_Finance",
+      "score":0.916
+   },
+   "http://d.opencalais.com/dochash-1/9359fafb-1158-3343-91e3-7f4ed89f3b01/cat/2":{
+      "_typeGroup":"topics",
+      "category":"http://d.opencalais.com/cat/Calais/TechnologyInternet",
+      "classifierName":"Calais",
+      "categoryName":"Technology_Internet",
+      "score":0.736
+   },
+   "http://d.opencalais.com/genericHasher-1/84a34c48-25ac-327f-a805-7b81fd570f7d":{
+      "_type":"Country",
+      "_typeGroup":"entities",
+      "name":"Australia",
+      "instances":[
+         {
+            "detection":"[number of bicycles sold in ]Australia[ in 2006</title>\n<date>January 4,]",
+            "prefix":"number of bicycles sold in ",
+            "exact":"Australia",
+            "suffix":" in 2006</title>\n<date>January 4,",
+            "offset":67,
+            "length":9
+         },
+         {
+            "detection":"[4, 2007</date>\n<body>\nBicycle sales in ]Australia[ have recorded record sales of 1,273,781 units]",
+            "prefix":"4, 2007</date>\n<body>\nBicycle sales in ",
+            "exact":"Australia",
+            "suffix":" have recorded record sales of 1,273,781 units",
+            "offset":146,
+            "length":9
+         },
+         {
+            "detection":"[ the traditional company car,\" he said.\n\n\"Some of ]Australia['s biggest corporations now have bicycle fleets,]",
+            "prefix":" the traditional company car,\" he said.\n\n\"Some of ",
+            "exact":"Australia",
+            "suffix":"'s biggest corporations now have bicycle fleets,",
+            "offset":952,
+            "length":9
+         }
+      ],
+      "relevance":0.718,
+      "resolutions":[
+         {
+            "name":"Australia",
+            "shortname":"Australia",
+            "latitude":"-32.3456225086",
+            "longitude":"141.434598022"
+         }
+      ]
+   },
+   "http://d.opencalais.com/genericHasher-1/9853f11e-5efa-3efc-90b9-0d0450f7d673":{
+      "_type":"Organization",
+      "_typeGroup":"entities",
+      "name":"Cycling Promotion Fund",
+      "organizationtype":"N/A",
+      "nationality":"N/A",
+      "instances":[
+         {
+            "detection":"[yet to be realised by car manufacturers.\n\nThe ]Cycling Promotion Fund[ (CPF) spokesman Ian Christie said Australians]",
+            "prefix":"yet to be realised by car manufacturers.\n\nThe ",
+            "exact":"Cycling Promotion Fund",
+            "suffix":" (CPF) spokesman Ian Christie said Australians",
+            "offset":396,
+            "length":22
+         },
+         {
+            "detection":"[car manufacturers.\n\nThe Cycling Promotion Fund (]CPF[) spokesman Ian Christie said Australians were]",
+            "prefix":"car manufacturers.\n\nThe Cycling Promotion Fund (",
+            "exact":"CPF",
+            "suffix":") spokesman Ian Christie said Australians were",
+            "offset":420,
+            "length":3
+         },
+         {
+            "detection":"[of all cars sold are to company fleets.\"\n\nThe ]CPF[ claims most commutes to work are less than 5]",
+            "prefix":"of all cars sold are to company fleets.\"\n\nThe ",
+            "exact":"CPF",
+            "suffix":" claims most commutes to work are less than 5",
+            "offset":1318,
+            "length":3
+         }
+      ],
+      "relevance":0.506,
+      "resolutions":[
+
+      ]
+   },
+   "http://d.opencalais.com/genericHasher-1/d0ca04b6-9cf5-3595-ad4b-7758a0b57997":{
+      "_type":"ProvinceOrState",
+      "_typeGroup":"entities",
+      "name":"Tasmania",
+      "instances":[
+         {
+            "detection":"[ their fitness.\n\nMr Christie, a native of Hobart, ]Tasmania[ said organisations were beginning to supply]",
+            "prefix":" their fitness.\n\nMr Christie, a native of Hobart, ",
+            "exact":"Tasmania",
+            "suffix":" said organisations were beginning to supply",
+            "offset":709,
+            "length":8
+         }
+      ],
+      "relevance":0.168,
+      "resolutions":[
+         {
+            "name":"Tasmania,Australia",
+            "shortname":"Tasmania",
+            "containedbycountry":"Australia",
+            "latitude":"-42",
+            "longitude":"147"
+         }
+      ]
+   },
+   "http://d.opencalais.com/genericHasher-1/4883e991-e7a0-3881-8e5a-b23ede61544e":{
+      "_type":"Quotation",
+      "_typeGroup":"relations",
+      "person":"http://d.opencalais.com/pershash-1/3bcf2655-ff2a-3a80-8de4-558b9626ad21",
+      "quote":"There is an emerging trend towards people using bikes as their official company-supplied vehicle in place of the traditional company car; Some of Australia's biggest corporations now have bicycle fleets, and when you add in government organisations, we now know of at least 50 organisations which operate fleets of bikes.",
+      "instances":[
+         {
+            "detection":"[to supply bicycles as a company vehicle. ]\"There is an emerging trend towards people using bikes as their official company-supplied vehicle in place of the traditional company car,\" he said.\n\n\"Some of Australia's biggest corporations now have bicycle fleets, and when you add in government organisations, we now know of at least 50 organisations which operate fleets of bikes.\"[\n\n\"Although the company bicycle is a long way]",
+            "prefix":"to supply bicycles as a company vehicle. ",
+            "exact":"\"There is an emerging trend towards people using bikes as their official company-supplied vehicle in place of the traditional company car,\" he said.\n\n\"Some of Australia's biggest corporations now have bicycle fleets, and when you add in government organisations, we now know of at least 50 organisations which operate fleets of bikes.\"",
+            "suffix":"\n\n\"Although the company bicycle is a long way",
+            "offset":793,
+            "length":335
+         }
+      ]
+   },
+   "http://d.opencalais.com/genericHasher-1/0c3d5340-106f-390e-92d3-a4aa18004fb8":{
+      "_type":"IndustryTerm",
+      "_typeGroup":"entities",
+      "name":"company car",
+      "instances":[
+         {
+            "detection":"[company-supplied vehicle in place of the ]traditional company car[,\" he said.\n\n\"Some of Australia's biggest]",
+            "prefix":"company-supplied vehicle in place of the ",
+            "exact":"traditional company car",
+            "suffix":",\" he said.\n\n\"Some of Australia's biggest",
+            "offset":907,
+            "length":23
+         },
+         {
+            "detection":"[bicycle is a long way from taking over from the ]company car[, it's an important trend when you consider that]",
+            "prefix":"bicycle is a long way from taking over from the ",
+            "exact":"company car",
+            "suffix":", it's an important trend when you consider that",
+            "offset":1200,
+            "length":11
+         }
+      ],
+      "relevance":0.186,
+      "resolutions":[
+
+      ]
+   },
+   "http://d.opencalais.com/pershash-1/3bcf2655-ff2a-3a80-8de4-558b9626ad21":{
+      "_type":"Person",
+      "_typeGroup":"entities",
+      "name":"Ian Christie",
+      "persontype":"political",
+      "nationality":"N/A",
+      "instances":[
+         {
+            "detection":"[Cycling Promotion Fund (CPF) spokesman ]Ian Christie[ said Australians were increasingly using]",
+            "prefix":"Cycling Promotion Fund (CPF) spokesman ",
+            "exact":"Ian Christie",
+            "suffix":" said Australians were increasingly using",
+            "offset":435,
+            "length":12
+         },
+         {
+            "detection":"[percent in 2006 while the car market stalled. ]Mr Christie[ said people were looking to cut their fuel costs]",
+            "prefix":"percent in 2006 while the car market stalled. ",
+            "exact":"Mr Christie",
+            "suffix":" said people were looking to cut their fuel costs",
+            "offset":587,
+            "length":11
+         },
+         {
+            "detection":"[ cut their fuel costs and improve their fitness.\n\n]Mr Christie[, a native of Hobart, Tasmania said organisations]",
+            "prefix":" cut their fuel costs and improve their fitness.\n\n",
+            "exact":"Mr Christie",
+            "suffix":", a native of Hobart, Tasmania said organisations",
+            "offset":676,
+            "length":11
+         },
+         {
+            "detection":"[in place of the traditional company car,\" ]he[ said.\n\n\"Some of Australia's biggest corporations]",
+            "prefix":"in place of the traditional company car,\" ",
+            "exact":"he",
+            "suffix":" said.\n\n\"Some of Australia's biggest corporations",
+            "offset":933,
+            "length":2
+         }
+      ],
+      "relevance":0.568,
+      "resolutions":[
+
+      ]
+   },
+   "http://d.opencalais.com/genericHasher-1/aad05e63-b79e-33cc-9c1a-385b47072694":{
+      "_type":"Quotation",
+      "_typeGroup":"relations",
+      "person":"http://d.opencalais.com/pershash-1/3bcf2655-ff2a-3a80-8de4-558b9626ad21",
+      "quote":"people were looking to cut their fuel costs and improve their fitness",
+      "instances":[
+         {
+            "detection":"[percent in 2006 while the car market stalled. ]Mr Christie said people were looking to cut their fuel costs and improve their fitness.[\n\nMr Christie, a native of Hobart, Tasmania said]",
+            "prefix":"percent in 2006 while the car market stalled. ",
+            "exact":"Mr Christie said people were looking to cut their fuel costs and improve their fitness.",
+            "suffix":"\n\nMr Christie, a native of Hobart, Tasmania said",
+            "offset":587,
+            "length":87
+         }
+      ]
+   },
+   "http://d.opencalais.com/genericHasher-1/17126376-4538-3f7d-b31d-bcb2c6472493":{
+      "_type":"Position",
+      "_typeGroup":"entities",
+      "name":"spokesman ",
+      "instances":[
+         {
+            "detection":"[ manufacturers.\n\nThe Cycling Promotion Fund (CPF) ]spokesman[ Ian Christie said Australians were increasingly]",
+            "prefix":" manufacturers.\n\nThe Cycling Promotion Fund (CPF) ",
+            "exact":"spokesman",
+            "suffix":" Ian Christie said Australians were increasingly",
+            "offset":425,
+            "length":9
+         }
+      ],
+      "relevance":0.275,
+      "resolutions":[
+
+      ]
+   },
+   "http://d.opencalais.com/genericHasher-1/79d73227-2f18-3014-8dc6-81a29851ea5d":{
+      "_type":"GenericRelations",
+      "_typeGroup":"relations",
+      "verb":"realize",
+      "relationsubject":"http://d.opencalais.com/genericHasher-1/ed0e83f9-87e8-3da6-ab46-cd6be116357c",
+      "relationobject":"a figure",
+      "instances":[
+         {
+            "detection":"[industry has sold more than one million units, ]a figure yet to be realised by car manufacturers[.\n\nThe Cycling Promotion Fund (CPF) spokesman Ian]",
+            "prefix":"industry has sold more than one million units, ",
+            "exact":"a figure yet to be realised by car manufacturers",
+            "suffix":".\n\nThe Cycling Promotion Fund (CPF) spokesman Ian",
+            "offset":341,
+            "length":48
+         }
+      ]
+   },
+   "http://d.opencalais.com/genericHasher-1/d2bc3216-c3e9-33ee-bb14-675cd80e00ce":{
+      "_type":"Quotation",
+      "_typeGroup":"relations",
+      "person":"http://d.opencalais.com/pershash-1/3bcf2655-ff2a-3a80-8de4-558b9626ad21",
+      "quote":"Although the company bicycle is a long way from taking over from the company car, it's an important trend when you consider that nearly half of all cars sold are to company fleets.",
+      "instances":[
+         {
+            "detection":"[organisations which operate fleets of bikes.\"\n\n]\"Although the company bicycle is a long way from taking over from the company car, it's an important trend when you consider that nearly half of all cars sold are to company fleets.\"[\n\nThe CPF claims most commutes to work are less]",
+            "prefix":"organisations which operate fleets of bikes.\"\n\n",
+            "exact":"\"Although the company bicycle is a long way from taking over from the company car, it's an important trend when you consider that nearly half of all cars sold are to company fleets.\"",
+            "suffix":"\n\nThe CPF claims most commutes to work are less",
+            "offset":1130,
+            "length":182
+         }
+      ]
+   },
+   "http://d.opencalais.com/genericHasher-1/8f3936d9-cf6b-37fc-ae0d-a145959ae3b5":{
+      "_type":"GenericRelations",
+      "_typeGroup":"relations",
+      "verb":"say",
+      "relationsubject":"http://d.opencalais.com/pershash-1/3bcf2655-ff2a-3a80-8de4-558b9626ad21",
+      "relationobject":"Australians were increasingly using bicycles as an alternative to cars",
+      "instances":[
+         {
+            "detection":"[ manufacturers.\n\nThe Cycling Promotion Fund (CPF) ]spokesman Ian Christie said Australians were increasingly using bicycles as an alternative to cars.[ Sales rose nine percent in 2006 while the car]",
+            "prefix":" manufacturers.\n\nThe Cycling Promotion Fund (CPF) ",
+            "exact":"spokesman Ian Christie said Australians were increasingly using bicycles as an alternative to cars.",
+            "suffix":" Sales rose nine percent in 2006 while the car",
+            "offset":425,
+            "length":99
+         }
+      ]
+   },
+   "http://d.opencalais.com/genericHasher-1/9fa3fb8a-f517-32c7-8a46-3c1506ea3a70":{
+      "_type":"City",
+      "_typeGroup":"entities",
+      "name":"Hobart",
+      "instances":[
+         {
+            "detection":"[ improve their fitness.\n\nMr Christie, a native of ]Hobart[, Tasmania said organisations were beginning to]",
+            "prefix":" improve their fitness.\n\nMr Christie, a native of ",
+            "exact":"Hobart",
+            "suffix":", Tasmania said organisations were beginning to",
+            "offset":701,
+            "length":6
+         }
+      ],
+      "relevance":0.168,
+      "resolutions":[
+         {
+            "name":"Hobart,Tasmania,Australia",
+            "shortname":"Hobart",
+            "containedbystate":"Tasmania",
+            "containedbycountry":"Australia",
+            "latitude":"-42.8806",
+            "longitude":"147.325"
+         }
+      ]
+   },
+   "http://d.opencalais.com/genericHasher-1/acc62eba-98d2-3481-9e2c-fb775f7e01f3":{
+      "_type":"GenericRelations",
+      "_typeGroup":"relations",
+      "verb":"say",
+      "relationsubject":"http://d.opencalais.com/genericHasher-1/d0ca04b6-9cf5-3595-ad4b-7758a0b57997",
+      "relationobject":"organisations were beginning to supply bicycles as a company vehicle",
+      "instances":[
+         {
+            "detection":"[ their fitness.\n\nMr Christie, a native of Hobart, ]Tasmania said organisations were beginning to supply bicycles as a company vehicle.[ \"There is an emerging trend towards people using]",
+            "prefix":" their fitness.\n\nMr Christie, a native of Hobart, ",
+            "exact":"Tasmania said organisations were beginning to supply bicycles as a company vehicle.",
+            "suffix":" \"There is an emerging trend towards people using",
+            "offset":709,
+            "length":83
+         }
+      ]
+   },
+   "http://d.opencalais.com/genericHasher-1/d12ca52d-e0ec-3458-839d-4b6a69d3db33":{
+      "_type":"PersonCareer",
+      "_typeGroup":"relations",
+      "person":"http://d.opencalais.com/pershash-1/3bcf2655-ff2a-3a80-8de4-558b9626ad21",
+      "position":"http://d.opencalais.com/genericHasher-1/17126376-4538-3f7d-b31d-bcb2c6472493",
+      "organization":"http://d.opencalais.com/genericHasher-1/9853f11e-5efa-3efc-90b9-0d0450f7d673",
+      "careertype":"professional",
+      "status":"current",
+      "instances":[
+         {
+            "detection":"[yet to be realised by car manufacturers.\n\nThe ]Cycling Promotion Fund (CPF) spokesman Ian Christie[ said Australians were increasingly using]",
+            "prefix":"yet to be realised by car manufacturers.\n\nThe ",
+            "exact":"Cycling Promotion Fund (CPF) spokesman Ian Christie",
+            "suffix":" said Australians were increasingly using",
+            "offset":396,
+            "length":51
+         }
+      ]
+   },
+   "http://d.opencalais.com/genericHasher-1/ed0e83f9-87e8-3da6-ab46-cd6be116357c":{
+      "_type":"IndustryTerm",
+      "_typeGroup":"entities",
+      "name":"car manufacturers",
+      "instances":[
+         {
+            "detection":"[million units, a figure yet to be realised by ]car manufacturers[.\n\nThe Cycling Promotion Fund (CPF) spokesman Ian]",
+            "prefix":"million units, a figure yet to be realised by ",
+            "exact":"car manufacturers",
+            "suffix":".\n\nThe Cycling Promotion Fund (CPF) spokesman Ian",
+            "offset":372,
+            "length":17
+         }
+      ],
+      "relevance":0.303,
+      "resolutions":[
+
+      ]
+   },
+   "http://d.opencalais.com/genericHasher-1/e05f3d33-1622-3172-836c-b48637a156d3":{
+      "_type":"Continent",
+      "_typeGroup":"entities",
+      "name":"Australia",
+      "instances":[
+         {
+            "detection":"[number of bicycles sold in ]Australia[ in 2006</title>\n<date>January 4,]",
+            "prefix":"number of bicycles sold in ",
+            "exact":"Australia",
+            "suffix":" in 2006</title>\n<date>January 4,",
+            "offset":67,
+            "length":9
+         }
+      ],
+      "relevance":0.328,
+      "resolutions":[
+
+      ]
+   },
+   "http://d.opencalais.com/genericHasher-1/0bb9cdb4-3cb7-342a-9901-6d1f12b32f6a":{
+      "_type":"IndustryTerm",
+      "_typeGroup":"entities",
+      "name":"car sales",
+      "instances":[
+         {
+            "detection":"[sales of 1,273,781 units for 2006, exceeding ]car sales[ by 32 percent. It is the fifth year in a row]",
+            "prefix":"sales of 1,273,781 units for 2006, exceeding ",
+            "exact":"car sales",
+            "suffix":" by 32 percent. It is the fifth year in a row",
+            "offset":222,
+            "length":9
+         }
+      ],
+      "relevance":0.322,
+      "resolutions":[
+
+      ]
+   },
+   "http://d.opencalais.com/genericHasher-1/3979e581-0823-3e84-9257-1ca36db4665e":{
+      "_type":"IndustryTerm",
+      "_typeGroup":"entities",
+      "name":"car market",
+      "instances":[
+         {
+            "detection":"[cars. Sales rose nine percent in 2006 while the ]car market[ stalled. Mr Christie said people were looking to]",
+            "prefix":"cars. Sales rose nine percent in 2006 while the ",
+            "exact":"car market",
+            "suffix":" stalled. Mr Christie said people were looking to",
+            "offset":567,
+            "length":10
+         }
+      ],
+      "relevance":0.254,
+      "resolutions":[
+
+      ]
+   },
+   "http://d.opencalais.com/genericHasher-1/c2ec763e-020f-3efa-91da-943e6eaae794":{
+      "_type":"Quotation",
+      "_typeGroup":"relations",
+      "person":"http://d.opencalais.com/pershash-1/3bcf2655-ff2a-3a80-8de4-558b9626ad21",
+      "quote":"organisations were beginning to supply bicycles as a company vehicle",
+      "instances":[
+         {
+            "detection":"[ cut their fuel costs and improve their fitness.\n\n]Mr Christie, a native of Hobart, Tasmania said organisations were beginning to supply bicycles as a company vehicle.[ \"There is an emerging trend towards people using]",
+            "prefix":" cut their fuel costs and improve their fitness.\n\n",
+            "exact":"Mr Christie, a native of Hobart, Tasmania said organisations were beginning to supply bicycles as a company vehicle.",
+            "suffix":" \"There is an emerging trend towards people using",
+            "offset":676,
+            "length":116
+         }
+      ]
+   },
+   "http://d.opencalais.com/genericHasher-1/c02271aa-0d63-3f49-89ba-9ebdd5cbd0ee":{
+      "_type":"PersonAttributes",
+      "_typeGroup":"relations",
+      "person":"http://d.opencalais.com/pershash-1/3bcf2655-ff2a-3a80-8de4-558b9626ad21",
+      "birthplace":"Hobart",
+      "birthplacetype":"City",
+      "gender":"M",
+      "instances":[
+         {
+            "detection":"[ cut their fuel costs and improve their fitness.\n\n]Mr Christie, a native of Hobart, Tasmania[ said organisations were beginning to supply]",
+            "prefix":" cut their fuel costs and improve their fitness.\n\n",
+            "exact":"Mr Christie, a native of Hobart, Tasmania",
+            "suffix":" said organisations were beginning to supply",
+            "offset":676,
+            "length":41
+         }
+      ]
+   },
+   "http://d.opencalais.com/genericHasher-1/d0dd2309-76eb-3679-a37f-edcfcb30513d":{
+      "_type":"Quotation",
+      "_typeGroup":"relations",
+      "person":"http://d.opencalais.com/pershash-1/3bcf2655-ff2a-3a80-8de4-558b9626ad21",
+      "persondescription":"spokesman, Cycling Promotion Fund",
+      "quote":"Australians were increasingly using bicycles as an alternative to cars",
+      "instances":[
+         {
+            "detection":"[ figure yet to be realised by car manufacturers.\n\n]The Cycling Promotion Fund (CPF) spokesman Ian Christie said Australians were increasingly using bicycles as an alternative to cars.[ Sales rose nine percent in 2006 while the car]",
+            "prefix":" figure yet to be realised by car manufacturers.\n\n",
+            "exact":"The Cycling Promotion Fund (CPF) spokesman Ian Christie said Australians were increasingly using bicycles as an alternative to cars.",
+            "suffix":" Sales rose nine percent in 2006 while the car",
+            "offset":392,
+            "length":132
+         }
+      ]
+   },
+   "http://d.opencalais.com/genericHasher-1/21431161-7b9f-34c0-9417-9f9b72ed8a70":{
+      "_type":"GenericRelations",
+      "_typeGroup":"relations",
+      "verb":"say",
+      "relationsubject":"http://d.opencalais.com/pershash-1/3bcf2655-ff2a-3a80-8de4-558b9626ad21",
+      "relationobject":"people were looking to cut their fuel costs and improve their fitness",
+      "instances":[
+         {
+            "detection":"[percent in 2006 while the car market stalled. ]Mr Christie said people were looking to cut their fuel costs and improve their fitness.[\n\nMr Christie, a native of Hobart, Tasmania said]",
+            "prefix":"percent in 2006 while the car market stalled. ",
+            "exact":"Mr Christie said people were looking to cut their fuel costs and improve their fitness.",
+            "suffix":"\n\nMr Christie, a native of Hobart, Tasmania said",
+            "offset":587,
+            "length":87
+         }
+      ]
+   },
+   "http://d.opencalais.com/genericHasher-1/03ebb542-58cd-346f-8cf5-c69cfef1d446":{
+      "_type":"GenericRelations",
+      "_typeGroup":"relations",
+      "verb":"stall",
+      "relationsubject":"http://d.opencalais.com/genericHasher-1/3979e581-0823-3e84-9257-1ca36db4665e",
+      "instances":[
+         {
+            "detection":"[to cars. Sales rose nine percent in 2006 while ]the car market stalled[. Mr Christie said people were looking to cut]",
+            "prefix":"to cars. Sales rose nine percent in 2006 while ",
+            "exact":"the car market stalled",
+            "suffix":". Mr Christie said people were looking to cut",
+            "offset":563,
+            "length":22
+         }
+      ]
+   }
+}