- Download and install Java 8. You can get that from http://www.java.com Be careful – due to some changes in Java, SeSAm currently only works with Java 8.
- Download SeSAm.zip and unpack it into a suitable folder. Do not just open it, but explicitly unpack the zip-file. Be aware that no cloud installation works – that means you need to unzip this file really on your hard drive.
- Start SeSAm by clicking on the SeSAm.jar file in the SeSAm folder. In most cases, this works. If not you need to use the command line editor and navigate into the SeSAm folder and type “java -jar SeSAm.jar”.
(if you have other java installations and do not want to mess with those, then do a separate Java installation and create a batch file that contains a line that looks like “C:/Progra~1/Java/jre1.8.0_291/bin/java -jar SeSAm.jar” telling where to find the right java installation). If you expect to run simulations with larger agent numbers, add “-Xmx2048M” to your instruction to give SeSAm more working memory.
If SeSAm opens and you see a window entitled “Model Library” with a number of entries, then installation was successful.
SeSAm has a plugin mechanism that allows to extend its functionality. Everything that has to do with 2D space is a build-in plugin. A second build-in plugin allows to use genetic algorithms for parameter optimization. While the first is on per default, the evolution plugin needs to be explicitly added using the feature of the class that you want to equip with capabilities to evolve their parameters. There is a number of useful plugins available. Download the zip file, unpack it (result is a .jar file), move it into the “plugins” folder (in your SeSAm folder, where you also find the SeSAm.jar file). Restart SeSAm and the functionality is available to use: Either in form of additional primitives, additional menu entries in the “Plugins” menu, additional data types, etc.
This plugin gives you the File data type and primitives to write and read lines from a text file. This gives you full flexibility to work with loading data from files or importing data from files – more flexibility that the import and export csv-plugins or the build-in data export functionality via the “analysis” functions.
This plugin provides additional primitives to handle 2d shapes. There is quite some functionality available in the build-in 2d spatial plugin. The 2D Geometry plugin gives you even more from calculating the center of gravity of a polygon to calculating a Delauney Triangulation from a set of positions.
more plugins to follow – if you search for functionality which is not here, contact Franziska, maybe we have a plugin already…