Skip to content

shannonyu/smaph-erd

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

49 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

SMAPH system for query entity linking.

This package contains the code of the SMAPH system developed by Marco Cornolti, Massimiliano Ciaramita, Paolo Ferragina, Stefan Rued and Hinrich Shuetze.

The SMAPH system links queries to the entities it mentions, disambiguating mentions if needed. Entities are Wikipedia pages. This problem is known as "entity recognition and disambiguation in queries". For example, the query armstrong moon landing should point to Neil Armstrong and Moon Landing, while the query armstrong trumpet should point to Louis Armstrong and Trumpet.

This system won the Entity Recognition and Disambiguation Challenge (short-text track).

SMAPH is built on top of Bing. For this reason, you will need a key to access Bing's API.

The system is deployed as a web service but can also be queried directly from your code.

Deploy instructions

Standard (and suggested) way: deploy a web service.

  1. Install dependencies
    • git clone https://github.com/diegoceccarelli/hpc-utils
    • cd hpc-utils
    • mvn install -DskipTests
  2. Download the code
    • git clone http://github.com/marcocor/smaph-erd
    • cd smaph-erd
  3. Set the Bing API key
    • obtain a key of the Bing Search API here
    • cp smaph-config.xml.template smaph-config.xml
    • edit smaph-config.xml replacing BING_KEY with your Primary Account Key
  4. Run smaph:
    • mvn -Djetty.port=9090 jetty:run where 9090 is the TCP port your server will be listening to
  5. Use smaph! You can either:

Call SMAPH's Java methods

You can also access the SMAPH system directly by calling its Java methods. Take a look at the annotateGetFull method in RestService.java to see how it's done.

ERD-Challenge way

SMAPH also provides a standard interface as defined by the ERD Challenge 20014. Thid interface is accessible at:

http://localhost:9090/smaph/rest/shortTrack

Contacts

For any bug you encounter, you can open a bug report on github.

For any enquiry, send an email at x at di.unipi.it (replace x with 'cornolti')

Enjoy, The SMAPH team.

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published