$usepop/pop/packages/newkit/sim/AREADME.txt http://www.cs.bham.ac.uk/research/projects/poplog/newkit/sim/AREADME.txt This replaces the README file, whose old contents are below. Since Poplog was reorganised for version 15.6, around 2005, this package, which used to be installed separately in a $local directory has become part of the standard Poplog distribution, and is included in $usepop/pop/packages/newkit/ in the sim/ directory. If you use it, I would be very grateful if you could send comments and suggestions, or at least a note that you have it, to A.Sloman@cs.bham.ac.uk If the package is used for research or development, please acknowledge use of the Birmingham University SimAgent toolkit. It used to be called SIM_AGENT. ======================================================================= If these programs are revised/extended the changes will be included in http://www.cs.bham.ac.uk/research/projects/poplog/sim/help/sim_agent_news http://www.cs.bham.ac.uk/research/projects/poplog/prb/help/prb_news The simulation package sim_agent normally resides in $usepop/pop/packages/sim which is actually a link to $usepop/pop/packages/newkit/sim CONTENTS -- PRECONDITIONS -- CONTENTS OF THIS PACKAGE -- LOADING THE SIM_AGENT LIBRARY -- What to read -- PRECONDITIONS To use the SIM_AGENT toolkit you need to be fairly fluent in Pop-11. This is not a toy system for absolute beginners, though it could be used to build one. For more on Pop-11 see http://www.cs.bham.ac.uk/research/projects/poplog/primer/ The Pop-11 Primer, avaiable in html or PDF http://www.cs.bham.ac.uk/research/projects/poplog/freepoplog.html http://www.cs.bham.ac.uk/research/projects/poplog/poplog.info.html http://www.poplog.cs.reading.ac.uk/poplog http://en.wikipedia.org/wiki/Poplog http://en.wikipedia.org/wiki/Pop-11 http://en.wikipedia.org/wiki/POP-2 And the teaching materials mentioned here: http://www.cs.bham.ac.uk/research/projects/poplog/freepoplog.html#teaching The SimAgent toolkit makes use of 1. Objectclass The package uses the objectclass library, located at $usepop/pop/lib/objectclass/ Which includes source code, example libraries, teaching, help, and reference documentation. with the main startup file in $usepop/pop/lib/objectclass/objectclass.p 2. Poprulebase The SimAGent package also uses the poprulebase library. This is normally resident in $usepop/pop/packages/prb/ which is actually a link to $usepop/pop/packages/newkit/prb/ which contains source code, example programs, and teaching, and help files. -- CONTENTS OF THIS PACKAGE sim/README This file sim/auto/ Directory containing autoloadable files sim/demo/ Directory containin demonstrations. Expected to grow sim/demo/rib The robot in a box demo prepared by Riccardo Poli and Aaron Sloman to illustrate a subsumption architecture sim/doc/ Printable postscript papers sim/help/ Directory containing help files especially sim/help/sim_agent_news sim/install_sim Shell script to install links to local libraries and build indexes sim/lib/ Directory containing files to be loaded via "lib" or "uses" sim/mksim Shell script to build a saved image with the library precompiled. sim/mktarfile Shell script to build tar file sim/ref/ Directory for REF files, when available. sim/simlib.p Pop-11 program to set up extensions to the Poplog search lists for autoloadable, library, and documentation files. Loading this does not load the full package: it merely makes the directories browsable. sim/teach/ Directory containing teach files sim/test/ Directory containing test files. Can probably be removed. -- LOADING THE SIM_AGENT LIBRARY Because you cannot use SimAgent without poprulebase, you need two commands: uses prblib uses simlib or give a single command that achieves both: uses newkit Otherwise try load $usepop/pop/packages/newkit/newkit.p The above commands should compile prblib.p and simlib.p, which extend the search lists for HELP, TEACH, SHOWLIB, LIB, USES, etc. Then do lib sim_agent This will load the main sim_agent procedures. Some of the autoloadable extensions included in sim/auto/ may not be loaded by this, to save initial compilation time. If objectclass and poprulebase had not previously been compiled the libraries will be compiled by that command. The script $usepop/pop/packages/sim/mksim can create a saved image including SimAgent, poprulebase, etc., to save compilation time. This used to be more useful in the days when computers were much slower. -- What to read After compiling simlib.p try TEACH SIM_AGENT HELP SIM_AGENT TEACH SIM_DEMO Also TEACH RULEBASE TEACH POPRULEBASE HELP POPRULEBASE =================================================================== Old contents of $poplocal/local/sim/README README file for the SIM_AGENT package Aaron Sloman - Dec 18 1994 Last: updated 11 Jan 1998 Aaron Sloman, ( http://www.cs.bham.ac.uk/~axs/ ) School of Computer Science, The University of Birmingham, B15 2TT, UK EMAIL A.Sloman@cs.bham.ac.uk Phone: +44-121-414-4775 (Sec 3711) Fax: +44-121-414-4281 This package is freely available to anyone who has a version of Poplog which supports the current sim_agent facilities (i.e. Poplog version 15.0 or later). If you obtain it, and especially if you use it, I would be very grateful if you could send comments and suggestions, or at least a note that you have it, to A.Sloman@cs.bham.ac.uk If the package is used for research or development, please acknowledge use of the Birmingham University SIM_AGENT toolkit. ======================================================================= The rest of the old file has been merged into the new instructions, above. Aaron Sloman 4 Jul 2009