The current prototype software classifies molecular descriptions extracted from the ChEBI ontology (http://www.ebi.ac.uk/chebi/) using the DLV deductive database system (http://www.dlvsystem.com/dlvsystem/index.php/Home). 

ORGANISATION OF THE FOLDER
---------------------------

-A folder "LoPStER/input/testbed" which contains the descriptions of 500 molecular entities in molfile format as extracted from ChEBI.
-A file "LoPStER/input/chemRules" which contains LP rules encoding 51 chemical classes.
-A folder "LoPStER/output" which contains an excel file with the superclasses of the abovementioned molecules after running LoPStER on 'apart' mode for module size 50.
-A folder "LoPStER/src" that contains the java code of the prototype
-A folder "LoPStER/bin" that contains the .class files of the .java files in the folder "src"
-A file "LoPStER/dlv" where the DLV engine should be placed
-A folder "LoPStER/libraries" where the cdk and poi .jar files can be placed.

HOW TO REPRODUCE THE EXPERIMENTS THROUGH ECLIPSE
------------------------------------------------

1.Create a java project by importing the folder "LoPStER/".
2.Add the cdk .jar files to the library of the said project:
	(i) Download the cdk and poi .jar files from http://sourceforge.net/projects/cdk/files/cdk/ and http://poi.apache.org/download.html.
	(ii) Save the files under "LoPStER/libraries".
	(iii) Right click on the name of the java project -> Properties -> Java Build Path -> Add external JARS... and select the two .jar files from "LoPStER/libraries".
2.Add the dlv file:
	(i) Download the DLV engine that suits your machine from http://www.dlvsystem.com/dlvsystem/index.php/DLV#Download.
	(ii) Place it under the folder "LoPStER/dlv".
	(iii)Either change the name of the DLV engine file to 'dlv' or change the name of the variable m_dlvEnginePath to the name of the DLV engine file. (for mac computers the .bin extension of the DLV engine file needs to be preserved)
	(iv)run the command 'chmod a+rx dlv_engine_file_name' to make the DLV engine file executable.
3.Right click on Tester.java -> Run Java application.
4.An excel file under the folder "LoPStER/output" is created with the subclass/superclass pairs.

For queries, please contact desmag@cs.ox.ac.uk.


