Data and Knowledge Group

― Knowledge Representation and Reasoning

SemFacet

OVERVIEW

SemFacet is a semantic facet based search system.

INSTRUCTIONS

See the instructions on how to install, configure and use SemFacet.

DOWNLOADS

Below you can find SemFacet 1.0 archive, which contains SemFacet.war file.



By downloading the SemFacet 1.0 you agree with the following academic licence. If the provided package doesn't work on your machine, you need to compile RDFox yourself following the instruction on https://github.com/yujiaoz/PAGOdA and replace JRDFox.jar in the downloaded war file. If you want to run the project from Eclipse, you could compile the project yourself, for which instructions can also be found at https://github.com/semfacet/core .

SYSTEM DEPENDENCIES

The requirements for SemFacet is a running Apache Tomcat server and Java SE Development Kit 8. In order to start Tomcat you should locate startup.sh file in bin directory. You can execute startup.sh using command line as follows:

./startup.sh

If you intend to load more than 50 MB of data you have to extend the memory allocated by Tomcat server. To do that you should find catalina.sh file in bin directory and add the following line:

JAVA_OPTS=" -Xmx3072M -XX:MaxPermSize=1024M"

Search for "JAVA_OPTS" in catalina.sh file in order to find the appropriate place, which will be specified in comments.

SYSTEM SETUP

To setup the SemFacet system you should place semFacet.war file in Tomcat webapps directory. Then, the Tomcat will extract the semFacet.war file and semFacet directory will be created and all files will be loaded there. The system will be initialized with a predefined data, which contains information about historical events. The SemFacet system can be accesed through the following url:

http://localhost:8080/semFacet/

To test if the system is working please load the afore mentioned URL in a web browser and enter search keyword in the search bar, or just hit enter without entering any keyword(in this case the system will retrieve all answers). Now you should see facets and snippets(results) displayed on the screen:

CONFIGURING AND LOADING CUSTOM DATA

In order to load and configure your own data you should press the settings button which is located next to the search button or go to the following url: http://localhost:8080/semFacet/manager.html . Now you should see the system manager displayed on the screen:

The system manager displays the current settings of the system. It is possible to change them using Update settings menu item. New data can be loaded using Load data menu item.

STOPPING THE SERVER

In order to stop Tomcat server you should locate shutdown.sh file in bin directory. You can execute shutdown.sh using command line as follows:

./shutdown.sh

EXAMPLE DATASETS

WOULD YOU LIKE TO CONTRIBUTE TO THE PROJECT?

If you would like to contribute to the project you can download the code from the github: https://github.com/semfacet/core

If you have any further questions please do not hesitate to contact any members of SemFacet.

DID YOU FIND ANY BUGS?

If you have noticed any issues while using SemFacet please report them here: https://github.com/semfacet/core/issues

Researchers

Bernardo Cuenca Grau, Ernesto Jimenez-Ruiz, Evgeny Kharlamov, Sarunas Marciuska, Dmitriy Zheleznyakov

Links

SemFacet demo prototype

SemFacet 1.0 demo video for WWW 2014 (youtube)


Key Publications

Bernardo Cuenca Grau, Evgeny Kharlamov, Sarunas Marciuska, Dmitriy Zheleznyakov, Marcelo Arenas and Ernesto Jimenez-Ruiz. SemFacet: Semantic Faceted Search over Yago, WWW 2014 Demo. [.pdf]

Marcelo Arenas, Bernardo Cuenca Grau, Evgeny Kharlamov, Sarunas Marciuska, Dmitriy Zheleznyakov. Faceted search over RDF-based knowledge graphs. J. Web Sem. 37-38: 55-74 (2016).