*** tuPInJADE README *** ============================================================================================================================== 1. Contents of this directory This directory (tuPInJADE) contains the classes belonging to the "tuPInJADE" package, as well as their source files, that allow to integrate tuProlog agents into JADE. ============================================================================================================================== 2. Requirements for using the tuPInJADE package NOTE: A recent version of Java should be installed in your computer Before using the package, you need to: 1) download JADE from http://jade.tilab.com (open source), and install it. 2) download tuProlog from http://lia.deis.unibo.it/research/tuprolog/ (free for non-commercial use), and install it. 3) update the classpath so that the packages offered by JADE and tuProlog can be imported by the tuPInJADE package. For example, if you have extracted all the JADE .jar files to the directory C:\Programs\jade\lib, you should add the following paths to your classpath variable: C:\Programs\jade\lib\jade.jar; C:\Programs\jade\lib\jadeTools.jar; C:\Programs\jade\lib\iiop.jar; C:\Programs\jade\lib\base64.jar In a similar way, if you have extracted all the tuProlog .jar files to the directory C:\Programs\tuprolog-1.3.0\bin, you should add the following paths to your classpath variable: C:\Programs\tuprolog-1.3.0\lib\2p.jar; C:\Programs\tuprolog-1.3.0\lib\tuprolog.jar; C:\Programs\tuprolog-1.3.0\lib\tuprologx.jar -- Since the other two packages that constitute DCaseLP, namely jessInJADE and UMLInJADE, make use of the ErrorMsg class provided by the tuPInJADE package, it is necessary to add the path of the tuPInJADE package to the classpath variable. If, for example, you have extracted the tuPInJADE directory in C:\Documents and Settings\myname\Documents\DCaseLP then you should add C:\Documents and Settings\myname\Documents\DCaseLP to your classpath. -- Finally, make sure that the current directory (".") belongs to your classpath. NOTE that tuPInJADE cannot work if JADE and tuProlog have not been correctly installed, and if the classpath has not been changed accordingly. Once you have installed both JADE and tuProlog, you can start using the tuPInJADE package. The detailed description of this package and of the functioning of its classes can be found in Ivana Gungui's master Thesis, written in English (apart from the initial pages), that can be downloaded from http://www.disi.unige.it/person/MascardiV/Download/Gungui.pdf.gz. ============================================================================================================================== 3. How to use the tuPInJADE package -- Once you have installed both JADE and tuPInJADE, you can start using the tuPInJADE package. -- Follow the tutorial that can be found in the DCaseLP\tuPInJADE\Tutorial directory to learn how to define tuProlog agents and to integrate them into JADE. -- Read the manual that can be found in the DCaseLP\tuPInJADE\Manual directory to understand how the package works. ============================================================================================================================== 4. Credits The tuPInJADE package has been developed by Ivana Gungui